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 | ||
liệt kê | EagerSession.ResourceCleanupChiến lược | Kiểm soát cách dọn sạch tài nguyên TensorFlow khi không còn cần thiết. |
Phương pháp công khai
khoảng trống đồng bộ | đó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. |
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ừ |
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. |
OperationBuilder | |
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 khai
đóng đồng bộ công khai void ()
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 `try-with-resources`.
Cách sử dụng ví dụ:
try (EagerSession session = EagerSession.create()) {
Ops tf = Ops.create(session);
// build execute operations eagerly...
}
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 EagerSession.Options.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
Xem thêm
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
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 khiOperationBuilder.build()
được gọi. NếuOperationBuilder.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...
}