EagerSession

lớp học cuối cùng công khai EagerSession

Một môi trường để thực hiện các hoạt động TensorFlow một cách háo hức.

Thực thi háo hức là môi trường lập trình bắt buộc giúp đánh giá các hoạt động ngay lập tức mà không cần xây dựng biểu đồ. Các thao tác trả về các giá trị cụ thể thay vì xây dựng biểu đồ tính toán để chạy sau, như với Graph s và Session s.

Điều này giúp dễ dàng phát triển với các mô hình gỡ lỗi và TensorFlow vì nó hoạt động giống một thư viện lập trình tiêu chuẩn hơn.

Các phiên bản của EagerSession đều an toàn theo luồng.

Các lớp lồng nhau

liệt kê EagerSession.DevicePlacementPolicy Kiểm soát cách hành động khi chúng ta cố gắng chạy một thao tác trên một thiết bị nhất định nhưng một số tensor đầu vào không có trên thiết bị đó.
lớp học EagerSession.Options

Phương pháp công cộng

trống rỗng
checkInput (Đầu vào Op )
Kiểm tra xem input có hợp lệ để sử dụng làm đầu vào trong môi trường thực thi này hay không.
trống rỗng
đóng ()
phiên háo hức tĩnh
tạo nên ()
Trả về EagerSession được định cấu hình với các tùy chọn mặc định.
Thực thiEnvironment.Types
loại môi trường ()
Lấy loại môi trường này (từ bảng liệt kê `Environments`.
phiên háo hức tĩnh
getDefault ()
Trả về phiên háo hức mặc định

Sau khi được khởi tạo, phiên háo hức mặc định vẫn hoạt động trong suốt vòng đời của ứng dụng, trái ngược với các phiên thu được từ create() hoặc build() sẽ bị đóng sau khi sử dụng.

phiên háo hức tĩnh
initDefault (tùy chọn EagerSession.Options )
Khởi tạo phiên háo hức mặc định, phiên này vẫn hoạt động trong suốt vòng đời của ứng dụng.
boolean
isOpEnabled (Loại chuỗi op)
Trả về true nếu thao tác đã cho hợp lệ trong môi trường thực thi này.
OperationBuilder
opBuilder (Loại chuỗi, Tên chuỗi)
Trả về một trình xây dựng để tạo một Operation mới.
EagerSession.Options tĩnh
tùy chọn ()
Trả về một đối tượng định cấu hình và xây dựng EagerSession với các tùy chọn tùy chỉnh.

Phương pháp kế thừa

Phương pháp công cộng

public void checkInput (Đầu vào Op )

Kiểm tra xem input có hợp lệ để sử dụng làm đầu vào trong môi trường thực thi này hay không. Ném IllegalArgumentException nếu không.

Thông số
đầu vào Lựa chọn để kiểm tra

đóng khoảng trống công khai ()

công khai tĩnh EagerSession tạo ()

Trả về EagerSession được định cấu hình với các tùy chọn mặc định.

CẢNH BÁO: Các phiên bản của EagerSession được phương thức này trả về phải được giải phóng rõ ràng bằng cách gọi close() khi chúng không còn cần thiết nữa. Điều này có thể đạt được bằng cách sử dụng kỹ thuật `thử với tài nguyên`.

Cách sử dụng ví dụ:

try (EagerSession session = EagerSession.create()) {
   Ops tf = Ops.create(session);
   // build execute operations eagerly...
 
 }

public ExecutionEnvironment.Types môi trườngType ()

Lấy loại môi trường này (từ bảng liệt kê `Environments`.

Trả lại
  • Giá trị `Môi trường` cho biết loại môi trường thực thi.

tĩnh công khai EagerSession getDefault ()

Trả về phiên háo hức mặc định

Sau khi được khởi tạo, phiên háo hức mặc định vẫn hoạt động trong suốt vòng đời của ứng dụng, trái ngược với các phiên thu được từ create() hoặc build() sẽ bị đóng sau khi sử dụng.

Bộ EagerSession.Options mặc định được sử dụng để khởi tạo phiên trong cuộc gọi đầu tiên. Để ghi đè hành vi này, có thể gọi initDefault(Options) bằng một bộ tùy chọn khác trước lệnh gọi đầu tiên này.

Cách sử dụng ví dụ:

// Starting to build eager operations using default session, by calling
 // EagerSession.getDefault() implicitly
 Ops tf = Ops.create();

 // Starting to build eager operations using default session, by calling
 // EagerSession.getDefault() explicitly
 Ops tf = Ops.create(EagerSession.getDefault());
 

Trả lại
  • phiên háo hức mặc định

public static EagerSession initDefault (tùy chọn EagerSession.Options )

Khởi tạo phiên háo hức mặc định, phiên này vẫn hoạt động trong suốt vòng đời của ứng dụng.

Phương thức này được gọi ngầm trong lệnh gọi getDefault() đầu tiên, nhưng cũng có thể được gọi một cách rõ ràng để ghi đè các tùy chọn mặc định.

Lưu ý rằng việc gọi phương thức này nhiều lần sẽ tạo ra IllegalArgumentException vì phiên mặc định không thể sửa đổi sau khi nó được tạo. Do đó, điều quan trọng là phải khởi tạo nó một cách rõ ràng trước khi getDefault() được gọi lần đầu tiên từ bất kỳ luồng nào.

Cách sử dụng ví dụ:

// Initializing default session to override default options is valid but
 // is optional
 EagerSession.initDefault(EagerSession.options().async(true));

 // Starting to build eager operations using default session, by calling
 // EagerSession.getDefault() implicitly
 Ops tf = Ops.create();

 // Initializing default session more than once or after using it is not
 // permitted and throws an exception
 EagerSession.initDefault(EagerSession.options().async(true));  // throws
 

Thông số
tùy chọn các tùy chọn sử dụng để xây dựng phiên mặc định
Trả lại
  • phiên háo hức mặc định
Ném
Trạng thái bất hợp phápNgoại lệ nếu phiên mặc định đã được khởi tạo
Xem thêm

boolean công khai isOpEnabled (String opType)

Trả về true nếu thao tác đã cho hợp lệ trong môi trường thực thi này.

Thông số
loại tùy chọn Các op để kiểm tra.
Trả lại
  • Liệu thao tác đã cho có hợp lệ trong môi trường thực thi này hay không.

public OperationBuilder opBuilder (Loại chuỗi, Tên chuỗi)

Trả về một trình xây dựng để tạo một Operation mới.

Thông số
kiểu của Hoạt động (nghĩa là xác định tính toán sẽ được thực hiện)
tên để chỉ Hoạt động được tạo trong phạm vi môi trường này.
Trả lại
  • một OperationBuilder để tạo một Operation khi build() được gọi. Nếu build() không được gọi thì một số tài nguyên có thể bị rò rỉ.

Tùy chọn EagerSession.Options tĩnh công khai ()

Trả về một đối tượng định cấu hình và xây dựng EagerSession với các tùy chọn tùy chỉnh.

CẢNH BÁO: Các phiên bản của EagerSession được phương thức này trả về phải được giải phóng rõ ràng bằng cách gọi close() khi chúng không còn cần thiết nữa. Điều này có thể đạt được bằng cách sử dụng kỹ thuật `try-with-resources`.

Cách sử dụng ví dụ:

try (EagerSession session = EagerSession.options().async(true).build()) {
   Ops tf = Ops.create(session);
   // build execute operations eagerly and asynchronously...
 
 }