tensorflow::ClientSession

#include <client_session.h>

Đối tượng ClientSession cho phép người gọi điều khiển quá trình đánh giá đồ thị TensorFlow được xây dựng bằng API C++.

Bản tóm tắt

Ví dụ:

Scope root = Scope::NewRootScope();
auto a = Placeholder(root, DT_INT32);
auto c = Add(root, a, {41});

ClientSession session(root);
std::vector outputs;

Status s = session.Run({ {a, {1}} }, {c}, &outputs);
if (!s.ok()) { ... }

Hàm khởi tạo và hàm hủy

ClientSession (const Scope & scope, const string & target)
Tạo một phiên mới để đánh giá đồ thị có trong scope bằng cách kết nối với môi trường chạy TensorFlow được chỉ định bởi target .
ClientSession (const Scope & scope)
Tương tự như trên, nhưng sử dụng chuỗi rỗng ("") làm thông số mục tiêu.
ClientSession (const Scope & scope, const SessionOptions & session_options)
Tạo một phiên mới, cấu hình nó bằng session_options .
~ClientSession ()

Các loại hình công khai

CallableHandle typedef
int64
Một con trỏ đến đồ thị con, được tạo bằng ClientSession::MakeCallable() .
FeedType typedef
std::unordered_map< Output , Input::Initializer , OutputHash >
Một kiểu dữ liệu dùng để biểu diễn các dữ liệu đầu vào cho lệnh Run.

Chức năng công cộng

MakeCallable (const CallableOptions & callable_options, CallableHandle *out_handle)
Tạo một handle để gọi đồ thị con được định nghĩa bởi callable_options .
ReleaseCallable ( CallableHandle handle)
Giải phóng các tài nguyên được liên kết với handle đã cho trong phiên này.
Run (const std::vector< Output > & fetch_outputs, std::vector< Tensor > *outputs) const
Đánh giá các tensor trong fetch_outputs .
Run (const FeedType & inputs, const std::vector< Output > & fetch_outputs, std::vector< Tensor > *outputs) const
Tương tự như trên, nhưng sử dụng ánh xạ trong inputs cấp dữ liệu.
Run (const FeedType & inputs, const std::vector< Output > & fetch_outputs, const std::vector< Operation > & run_outputs, std::vector< Tensor > *outputs) const
Tương tự như trên. Ngoài ra, chương trình còn chạy các thao tác trong run_outputs .
Run (const RunOptions & run_options, const FeedType & inputs, const std::vector< Output > & fetch_outputs, const std::vector< Operation > & run_outputs, std::vector< Tensor > *outputs, RunMetadata *run_metadata) const
Sử dụng run_options để bật tính năng phân tích hiệu năng.
RunCallable ( CallableHandle handle, const std::vector< Tensor > & feed_tensors, std::vector< Tensor > *fetch_tensors, RunMetadata *run_metadata)
Gọi đồ thị con có tên được chỉ định bởi handle với các tùy chọn và tensor đầu vào đã cho.
RunCallable ( CallableHandle handle, const std::vector< Tensor > & feed_tensors, std::vector< Tensor > *fetch_tensors, RunMetadata *run_metadata, const thread::ThreadPoolOptions & options)
Gọi đồ thị con có tên được chỉ định bởi handle với các tùy chọn và tensor đầu vào đã cho.

Các loại hình công khai

CallableHandle 

int64 CallableHandle

Một con trỏ đến đồ thị con, được tạo bằng ClientSession::MakeCallable() .

Loại nguồn cấp 

std::unordered_map< Output, Input::Initializer, OutputHash > FeedType

Một kiểu dữ liệu dùng để biểu diễn các dữ liệu đầu vào cho lệnh Run.

Đây là bản đồ ánh xạ các đối tượng Output được trả về bởi các hàm tạo op với giá trị dùng để cung cấp cho chúng. Xem Input::Initializer để biết chi tiết về những giá trị có thể được sử dụng làm giá trị cung cấp.

Chức năng công cộng

Phiên khách hàng 

 ClientSession(
  const Scope & scope,
  const string & target
)

Tạo một phiên mới để đánh giá đồ thị có trong scope bằng cách kết nối với môi trường chạy TensorFlow được chỉ định bởi target .

Phiên khách hàng 

 ClientSession(
  const Scope & scope
)

Tương tự như trên, nhưng sử dụng chuỗi rỗng ("") làm thông số mục tiêu.

Phiên khách hàng 

 ClientSession(
  const Scope & scope,
  const SessionOptions & session_options
)

Tạo một phiên mới, cấu hình nó bằng session_options .

MakeCallable 

Status MakeCallable(
  const CallableOptions & callable_options,
  CallableHandle *out_handle
)

Tạo một handle để gọi đồ thị con được định nghĩa bởi callable_options .

LƯU Ý: API này vẫn đang trong giai đoạn thử nghiệm và có thể thay đổi.

ReleaseCallable 

Status ReleaseCallable(
  CallableHandle handle
)

Giải phóng các tài nguyên được liên kết với handle đã cho trong phiên này.

LƯU Ý: API này vẫn đang trong giai đoạn thử nghiệm và có thể thay đổi.

Chạy 

Status Run(
  const std::vector< Output > & fetch_outputs,
  std::vector< Tensor > *outputs
) const

Đánh giá các tensor trong fetch_outputs .

Các giá trị được trả về dưới dạng đối tượng Tensor trong outputs . Số lượng và thứ tự của outputs sẽ khớp với fetch_outputs .

Chạy 

Status Run(
  const FeedType & inputs,
  const std::vector< Output > & fetch_outputs,
  std::vector< Tensor > *outputs
) const

Tương tự như trên, nhưng sử dụng ánh xạ trong inputs cấp dữ liệu.

Chạy 

Status Run(
  const FeedType & inputs,
  const std::vector< Output > & fetch_outputs,
  const std::vector< Operation > & run_outputs,
  std::vector< Tensor > *outputs
) const

Tương tự như trên. Ngoài ra, chương trình còn chạy các thao tác trong run_outputs .

Chạy 

Status Run(
  const RunOptions & run_options,
  const FeedType & inputs,
  const std::vector< Output > & fetch_outputs,
  const std::vector< Operation > & run_outputs,
  std::vector< Tensor > *outputs,
  RunMetadata *run_metadata
) const

Sử dụng run_options để bật tính năng phân tích hiệu năng.

Nếu run_metadata không phải là null, nó sẽ được điền bằng kết quả phân tích hiệu năng.

RunCallable 

Status RunCallable(
  CallableHandle handle,
  const std::vector< Tensor > & feed_tensors,
  std::vector< Tensor > *fetch_tensors,
  RunMetadata *run_metadata
)

Gọi đồ thị con có tên được chỉ định bởi handle với các tùy chọn và tensor đầu vào đã cho.

Thứ tự các tensor trong feed_tensors phải khớp với thứ tự tên trong CallableOptions::feed() và thứ tự các tensor trong fetch_tensors sẽ khớp với thứ tự tên trong CallableOptions::fetch() khi đồ thị con này được tạo. LƯU Ý: API này vẫn đang trong giai đoạn thử nghiệm và có thể thay đổi.

RunCallable 

Status RunCallable(
  CallableHandle handle,
  const std::vector< Tensor > & feed_tensors,
  std::vector< Tensor > *fetch_tensors,
  RunMetadata *run_metadata,
  const thread::ThreadPoolOptions & options
)

Gọi đồ thị con có tên được chỉ định bởi handle với các tùy chọn và tensor đầu vào đã cho.

Thứ tự các tensor trong feed_tensors phải khớp với thứ tự tên trong CallableOptions::feed() và thứ tự các tensor trong fetch_tensors sẽ khớp với thứ tự tên trong CallableOptions::fetch() khi đồ thị con này được tạo. LƯU Ý: API này vẫn đang trong giai đoạn thử nghiệm và có thể thay đổi.

~Phiên Client 

 ~ClientSession()