คำเตือน: API นี้เลิกใช้งานแล้วและจะถูกลบออกใน TensorFlow เวอร์ชันในอนาคตหลังจาก การแทนที่ เสถียรแล้ว

EagerSession

ประชาชน EagerSession ชั้นสุดท้าย

สภาพแวดล้อมสำหรับดำเนินการ TensorFlow อย่างกระตือรือร้น

การดำเนินการอย่างกระตือรือร้นเป็นสภาพแวดล้อมการเขียนโปรแกรมที่จำเป็นซึ่งประเมินการดำเนินการทันที โดยไม่ต้องสร้างกราฟ การดำเนินงานค่าตอบแทนคอนกรีตแทนการสร้างกราฟการคำนวณเพื่อให้ทำงานได้ในภายหลังเช่นเดียวกับ Graph และ Session s

ทำให้ง่ายต่อการพัฒนาด้วย TensorFlow และโมเดลการดีบัก เนื่องจากมีลักษณะการทำงานเหมือนไลบรารีการเขียนโปรแกรมมาตรฐานมากกว่า

อินสแตนซ์ของ EagerSession เป็นด้ายปลอดภัย

คลาสที่ซ้อนกัน

enum EagerSession.DevicePlacementPolicy ควบคุมวิธีการดำเนินการเมื่อเราพยายามเรียกใช้การทำงานบนอุปกรณ์ที่กำหนด แต่เทนเซอร์อินพุตบางตัวไม่ได้อยู่บนอุปกรณ์นั้น
ระดับ EagerSession.Options
enum EagerSession.ResourceCleanupStrategy ควบคุมวิธีการล้างทรัพยากร TensorFlow เมื่อไม่ต้องการใช้อีกต่อไป

วิธีการสาธารณะ

ซิงโครไนซ์เป็นโมฆะ
คง EagerSession
สร้าง ()
ส่งกลับ EagerSession กำหนดค่าด้วยตัวเลือกเริ่มต้น
คง EagerSession
getDefault ()
ส่งกลับเซสชันกระตือรือร้นเริ่มต้น

เมื่อเริ่มต้นเซสชั่นเริ่มต้นความกระตือรือร้นที่ยังคงใช้งานสำหรับชีวิตทั้งชีวิตของการประยุกต์ใช้เมื่อเทียบกับการประชุมที่ได้รับจาก create() หรือ build() ซึ่งควรจะปิดหลังจากการใช้งานของพวกเขา

คง EagerSession
initdefault ( EagerSession.Options ตัวเลือก)
เริ่มต้นเซสชั่นที่ต้องการโดยดีฟอลต์ ซึ่งจะยังคงใช้งานได้ตลอดอายุของแอปพลิเคชัน
OperationBuilder
opBuilder (ประเภทสตริงชื่อ String)
ผลตอบแทนที่ได้สร้างเพื่อสร้างใหม่ Operation
คง EagerSession.Options
ตัวเลือก ()
ส่งคืนวัตถุที่กำหนดค่าและสร้าง EagerSession กับตัวเลือกที่กำหนดเอง

วิธีการสืบทอด

วิธีการสาธารณะ

ตรงกันสาธารณะเป็นโมฆะปิด ()

สาธารณะคง EagerSession สร้าง ()

ส่งกลับ EagerSession กำหนดค่าด้วยตัวเลือกเริ่มต้น

คำเตือน: กรณีของ EagerSession กลับโดยวิธีการนี้จะต้องได้รับการปลดปล่อยอย่างชัดเจนโดยเรียก close() เมื่อพวกเขามีความจำเป็นอีกต่อไป ซึ่งสามารถทำได้โดยใช้เทคนิค "ลองใช้กับทรัพยากร"

ตัวอย่างการใช้งาน:

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

สาธารณะคง EagerSession getDefault ()

ส่งกลับเซสชันกระตือรือร้นเริ่มต้น

เมื่อเริ่มต้นเซสชั่นเริ่มต้นความกระตือรือร้นที่ยังคงใช้งานสำหรับชีวิตทั้งชีวิตของการประยุกต์ใช้เมื่อเทียบกับการประชุมที่ได้รับจาก create() หรือ build() ซึ่งควรจะปิดหลังจากการใช้งานของพวกเขา

ชุดเริ่มต้นของ EagerSession.Options ถูกนำมาใช้ในการเริ่มต้นเซสชั่นบนสายแรก เมื่อต้องการแทนที่พฤติกรรมนี้ก็เป็นไปได้ที่จะเรียก initDefault(Options) กับชุดที่แตกต่างกันของตัวเลือกก่อนที่จะสายแรกนี้

ตัวอย่างการใช้งาน:

// 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());
 

คืนสินค้า
  • เซสชันกระตือรือร้นเริ่มต้น
ดูสิ่งนี้ด้วย

สาธารณะคง EagerSession initdefault ( EagerSession.Options ตัวเลือก)

เริ่มต้นเซสชั่นที่ต้องการโดยดีฟอลต์ ซึ่งจะยังคงใช้งานได้ตลอดอายุของแอปพลิเคชัน

วิธีการนี้จะเรียกโดยปริยายในสายแรกที่ getDefault() แต่ยังสามารถเรียกอย่างชัดเจนที่จะแทนที่ตัวเลือกเริ่มต้น

โปรดทราบว่าเรียกวิธีนี้มากกว่าหนึ่งครั้งจะโยน IllegalArgumentException เป็นเซสชั่นเริ่มต้นไม่สามารถแก้ไขได้เมื่อได้รับการสร้างขึ้น ดังนั้นจึงเป็นสิ่งสำคัญที่จะเริ่มต้นอย่างชัดเจนก่อนที่จะ getDefault() ถูกเรียกเป็นครั้งแรกจากหัวข้อใด ๆ

ตัวอย่างการใช้งาน:

// 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
 

พารามิเตอร์
ตัวเลือก ตัวเลือกที่จะใช้เพื่อสร้างเซสชันเริ่มต้น
คืนสินค้า
  • เซสชันกระตือรือร้นเริ่มต้น
ขว้าง
IllegalStateException หากเริ่มต้นเซสชันเริ่มต้นแล้ว
ดูสิ่งนี้ด้วย

ประชาชน OperationBuilder opBuilder (ประเภทสตริงชื่อ String)

ผลตอบแทนที่ได้สร้างเพื่อสร้างใหม่ Operation

พารามิเตอร์
พิมพ์ ของการดำเนินการ (กล่าวคือ ระบุการคำนวณที่จะดำเนินการ)
ชื่อ เพื่ออ้างถึงการดำเนินการที่สร้างขึ้นในขอบเขตสภาพแวดล้อมนี้
คืนสินค้า
  • OperationBuilder เพื่อสร้างการดำเนินงานเมื่อ build() ถูกเรียก หาก build() ไม่ได้เรียกแล้วทรัพยากรบางอย่างอาจรั่ว

สาธารณะคง EagerSession.Options ตัวเลือก ()

ส่งคืนวัตถุที่กำหนดค่าและสร้าง EagerSession กับตัวเลือกที่กำหนดเอง

คำเตือน: กรณีของ EagerSession กลับโดยวิธีการนี้จะต้องได้รับการปลดปล่อยอย่างชัดเจนโดยเรียก close() เมื่อพวกเขามีความจำเป็นอีกต่อไป ซึ่งสามารถทำได้โดยใช้เทคนิค "ลองใช้กับทรัพยากร"

ตัวอย่างการใช้งาน:

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