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 () |
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 | |
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
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
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 khibuild()
được gọi. Nếubuild()
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...
}