EagerSession

الطبقة النهائية العامة EagerSession

بيئة لتنفيذ عمليات TensorFlow بفارغ الصبر.

يعد التنفيذ الحريص بيئة برمجة حتمية تقوم بتقييم العمليات على الفور، دون إنشاء رسوم بيانية. تقوم العمليات بإرجاع قيم محددة بدلاً من إنشاء رسم بياني حسابي ليتم تشغيله لاحقًا، كما هو الحال مع Graph و Session s.

وهذا يجعل من السهل التطوير باستخدام TensorFlow ونماذج تصحيح الأخطاء، حيث أنها تتصرف مثل مكتبة برمجة قياسية.

تعتبر مثيلات EagerSession آمنة لمؤشر الترابط.

فئات متداخلة

التعداد EagerSession.DevicePlacementPolicy يتحكم في كيفية التصرف عندما نحاول تشغيل عملية على جهاز معين ولكن بعض موترات الإدخال غير موجودة على هذا الجهاز.
فصل EagerSession.Options

الأساليب العامة

فارغ
checkInput (إدخال المرجع )
التحقق من صلاحية input لاستخدامه كمدخل في بيئة التنفيذ هذه.
فارغ
جلسة إيجر ثابتة
يخلق ()
إرجاع EagerSession التي تم تكوينها بالخيارات الافتراضية.
بيئة التنفيذ. أنواع
نوع البيئة ()
احصل على نوع هذه البيئة (من تعداد "البيئات".
جلسة إيجر ثابتة
الحصول على الافتراضي ()
إرجاع جلسة حريصة الافتراضية

بمجرد التهيئة، تظل الجلسة النشطة الافتراضية نشطة طوال عمر التطبيق، على عكس الجلسات التي يتم الحصول عليها من create() أو build() والتي يجب إغلاقها بعد استخدامها.

جلسة إيجر ثابتة
initDefault (خيارات EagerSession.Options )
تهيئة الجلسة المتلهفة الافتراضية، والتي تظل نشطة طوال عمر التطبيق.
منطقية
isOpEnabled (نوع السلسلة)
يُرجع صحيحًا إذا كانت العملية المحددة صالحة في بيئة التنفيذ هذه.
OperationBuilder
opBuilder (نوع السلسلة، اسم السلسلة)
إرجاع منشئ لإنشاء Operation جديدة.
ثابت EagerSession.Options
خيارات ()
إرجاع كائن يقوم بتكوين EagerSession وإنشائه بخيارات مخصصة.

الطرق الموروثة

الأساليب العامة

checkInput العام الفارغ (إدخال Op )

التحقق من صلاحية input لاستخدامه كمدخل في بيئة التنفيذ هذه. يرمي IllegalArgumentException إذا لم يكن كذلك.

حدود
مدخل المرجع للتحقق

إغلاق الفراغ العام ()

إنشاء EagerSession العام الثابت ()

إرجاع EagerSession التي تم تكوينها بالخيارات الافتراضية.

تحذير: يجب تحرير مثيلات EagerSession التي يتم إرجاعها بهذه الطريقة بشكل صريح عن طريق استدعاء close() عندما لا تكون هناك حاجة إليها. يمكن تحقيق ذلك باستخدام تقنية "التجربة باستخدام الموارد".

مثال على الاستخدام:

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

ExecutionEnvironment العامة.أنواع البيئةنوع ()

احصل على نوع هذه البيئة (من تعداد "البيئات".

المرتجعات
  • قيمة `البيئات` تشير إلى نوع بيئة التنفيذ.

getDefault () EagerSession الثابت العام

إرجاع جلسة حريصة الافتراضية

بمجرد التهيئة، تظل الجلسة النشطة الافتراضية نشطة طوال عمر التطبيق، على عكس الجلسات التي يتم الحصول عليها من 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());
 

المرتجعات
  • جلسة حريصة الافتراضية

IagerSession الثابت العام 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 إذا تمت تهيئة الجلسة الافتراضية بالفعل
انظر أيضا

المنطقية العامة isOpEnabled (سلسلة opType)

يُرجع صحيحًا إذا كانت العملية المحددة صالحة في بيئة التنفيذ هذه.

حدود
opType المرجع للتحقق.
المرتجعات
  • ما إذا كانت العملية المحددة صالحة في بيئة التنفيذ هذه.

OperationBuilder العامة opBuilder (نوع السلسلة، اسم السلسلة)

إرجاع منشئ لإنشاء 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...
 
 }