تحذير: تم إهمال واجهة برمجة التطبيقات هذه وستتم إزالتها في إصدار مستقبلي من TensorFlow بعد استقرار الاستبدال .

Session.Runner

الجلسة العامة النهائية من الفصل

قم بتشغيل Operation وتقييم Tensors .

يدير العداء أجزاء الرسم البياني اللازمة لتنفيذ كل Operation مطلوبة لتقييم Tensors المطلوب جلبها. يسمح استدعاء feed(String, int, Tensor) للمتصلين بتجاوز قيمة Tensors في الرسم البياني عن طريق استبدال Tensors المتوفرة بمخرجات العمليات المقدمة feed(String, int, Tensor) .

المقاولون العامون

الطرق العامة

الجلسة. العداء
addTarget (عملية سلسلة)
قم بإجراء run() لتنفيذ operation ، ولكن لا تعيد أي Tensors تقييمه.
الجلسة. العداء
addTarget ( معامل <؟> معامل)
اجعل run() ينفذ operand ، لكن لا تعيد أي Tensors تقييمه.
الجلسة. العداء
addTarget ( عملية التشغيل)
قم بإجراء run() لتنفيذ operation ، لكن لا تقم بإرجاع أي Tensors تقييمها.
الجلسة. العداء
feed ( المعامل <؟> المعامل ، Tensor <؟> t)
استخدم t بدلاً من Tensor المشار إليه بتنفيذ العملية المشار إليها بواسطة operand .
الجلسة. العداء
تغذية (عملية سلسلة ، Tensor <؟> t)
تجنب تقييم operation واستبدل t بالقيمة التي تنتجها.
الجلسة. العداء
تغذية (سلسلة العمليات ، مؤشر int ، موتر <؟> t)
تجنب تقييم ناتج index operation باستبدال t بالقيمة التي تنتجها.
الجلسة. العداء
إحضار (عملية سلسلة)
قم بإجراء run() لإرجاع ناتج operation .
الجلسة. العداء
إحضار (عملية سلسلة ، فهرس int)
اجعل run() تُرجع ناتج index operation .
الجلسة. العداء
جلب ( معامل <؟> معامل)
يجعل run() يعيد Tensor المشار إليه بإخراج operand .
الجلسة. العداء
جلب ( إخراج <؟> إخراج)
يجعل run() يعيد Tensor المشار إليه بواسطة output .
قائمة < موتر <؟ >>
تشغيل ()
نفِّذ أجزاء الرسم البياني اللازمة لحساب جميع عمليات الجلب المطلوبة.
الجلسة
runAndFetchMetadata ()
نفذ أجزاء الرسم البياني لحساب عمليات الجلب المطلوبة وإرجاع البيانات الوصفية حول التشغيل.
الجلسة. العداء
setOptions (خيارات بايت [])
(الطريقة التجريبية): اضبط الخيارات (عادةً لتصحيح الأخطاء) لهذا التشغيل.

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

المقاولون العامون

الجمهور عداء ()

الطرق العامة

الجمهور Session.Runner addTarget (عملية سلسلة)

قم بإجراء run() لتنفيذ operation ، ولكن لا تعيد أي Tensors تقييمه.

الجمهور Session.Runner addTarget ( المعامل <> المعامل)

اجعل run() ينفذ operand ، لكن لا تعيد أي Tensors تقييمه.

الجمهور Session.Runner addTarget ( عملية التشغيل)

قم بإجراء run() لتنفيذ operation ، لكن لا تقم بإرجاع أي Tensors تقييمها.

رميات
غير الشرعيين استثناء حجة إذا لم تكن العملية عملية GraphOperation

جلسة عامة. تغذية العداء ( المعامل <؟> المعامل ، Tensor <؟> t)

استخدم t بدلاً من Tensor المشار إليه بتنفيذ العملية المشار إليها بواسطة operand .

جلسة عامة. تغذية العداء (سلسلة ، Tensor <؟> t)

تجنب تقييم operation واستبدل t بالقيمة التي تنتجها.

المعلمات
عملية هو إما اسم سلسلة العملية ، وفي هذه الحالة تكون هذه الطريقة اختصارًا feed(operation, 0) ، أو سلسلة من نموذج العملية_اسم: الإخراج_الفهرس ، وفي هذه الحالة تعمل هذه الطريقة مثل feed(operation_name, output_index) . تُستخدم هذه الأسماء المفصولة بنقطتين بشكل شائع في رسائل المخزن المؤقت لبروتوكول SignatureDef المضمنة في metaGraphDef() .

جلسة عامة. تغذية العداء (سلسلة العمليات ، مؤشر int ، Tensor <؟> t)

تجنب تقييم ناتج index operation باستبدال t بالقيمة التي تنتجها.

العمليات في Graph يمكن أن يكون نواتج متعددة، index يحدد أي واحد t ويجري تقديم ل.

جلسة عامة. جلب العداء (عملية سلسلة)

قم بإجراء run() لإرجاع ناتج operation .

المعلمات
عملية هو إما اسم سلسلة العملية ، وفي هذه الحالة تكون هذه الطريقة اختصارًا fetch(operation, 0) ، أو سلسلة من نموذج العملية_اسم: إخراج_فهرس ، وفي هذه الحالة تعمل هذه الطريقة مثل fetch(operation_name, output_index) . تُستخدم هذه الأسماء المفصولة بنقطتين بشكل شائع في رسائل المخزن المؤقت لبروتوكول SignatureDef المضمنة في metaGraphDef() .

جلسة عامة. جلب العداء (سلسلة ، فهرس int)

اجعل run() تُرجع ناتج index operation .

يمكن أن يكون للعمليات في Graph مخرجات متعددة ، ويحدد index أي منها يجب إرجاعه.

جلسة عامة. جلب العداء ( المعامل <؟> المعامل)

يجعل run() يعيد Tensor المشار إليه بإخراج operand .

جلسة عامة. جلب العداء ( الإخراج <؟> الإخراج)

يجعل run() يعيد Tensor المشار إليه بواسطة output .

القائمة العامة < Tensor <؟ >> run ()

نفِّذ أجزاء الرسم البياني اللازمة لحساب جميع عمليات الجلب المطلوبة.

تحذير: يفترض المتصل ملكية جميع Tensors إرجاعها ، أي يجب على المتصل استدعاء close() على جميع عناصر القائمة التي تم إرجاعها لتحرير الموارد.

TODO (ashankar): أعد النظر في نوع الإرجاع هنا. شيئين على وجه الخصوص: (أ) تسهيل عملية التنظيف على المتصل (ربما إرجاع شيء مثل AutoCloseableList في SessionTest.java) ، و (ب) تقييم ما إذا كانت القيمة المعادة يجب أن تكون قائمة ، أو ربما Map<Output, Tensor> ؟

TODO (andrewmyers): سيكون من الجيد أيضًا أن يسهّل كل ما يتم إرجاعه هنا استخراج موترات الإخراج بطريقة آمنة من النوع.

الجمهور Session.Run runAndFetchMetadata ()

نفذ أجزاء الرسم البياني لحساب عمليات الجلب المطلوبة وإرجاع البيانات الوصفية حول التشغيل.

هذا تمامًا مثل run() ، ولكن بالإضافة إلى Tensors المطلوب ، يقوم أيضًا بإرجاع البيانات الوصفية حول تنفيذ الرسم البياني في شكل مخزن مؤقت لبروتوكول RunMetadata المتسلسل.

public Session.Runner setOptions (بايت [] خيارات)

(الطريقة التجريبية): اضبط الخيارات (عادةً لتصحيح الأخطاء) لهذا التشغيل.

يتم تقديم الخيارات كمخزن مؤقت لبروتوكول RunOptions متسلسل.

تعد حزمة org.tensorflow خالية من أي تبعيات للمخزن المؤقت للبروتوكول لكي تظل صديقة للأنظمة المقيدة بالموارد (حيث قد يكون شيء مثل nanoproto أكثر ملاءمة). تكلفة ذلك هو الافتقار إلى نوع الأمان في وظيفة واجهة برمجة التطبيقات هذه. هذا الاختيار قيد المراجعة ويمكن استبدال هذه الوظيفة بمكافئات أكثر أمانًا من النوع في أي وقت.