جلسة العميل في TensorFlow

#include <client_session.h>

يتيح كائن ClientSession للمتصل التحكم في تقييم الرسم البياني TensorFlow الذي تم إنشاؤه باستخدام واجهة برمجة تطبيقات C++.

ملخص

مثال:

Scope root = Scope::NewRootScope();
auto a = Placeholder(root, DT_INT32);
auto c = Add(root, a, {41});

ClientSession session(root);
std::vector outputs;

Status s = session.Run({ {a, {1} } }, {c}, &outputs);
if (!s.ok()) { ... }  

البناة والمدمرون
ClientSession (const Scope & scope, const string & target) أنشئ جلسة جديدة لتقييم الرسم البياني الموجود في scope عن طريق الاتصال بوقت تشغيل TensorFlow المحدد بواسطة target .
ClientSession (const Scope & scope) كما هو الحال أعلاه، ولكن استخدم السلسلة الفارغة ("") كمواصفات الهدف.
ClientSession (const Scope & scope, const SessionOptions & session_options) أنشئ جلسة جديدة، وقم بتهيئتها باستخدام session_options .
~ClientSession ()

الأنواع العامة
CallableHandle	تعريف النوع int64 مقبض لرسم بياني فرعي، تم إنشاؤه باستخدام ClientSession::MakeCallable() .
FeedType	تعريف النوع std::unordered_map< Output , Input::Initializer , OutputHash > نوع بيانات لتمثيل التغذية إلى استدعاء التشغيل.

الوظائف العامة
MakeCallable (const CallableOptions & callable_options, CallableHandle *out_handle)	Status يقوم بإنشاء handle لاستدعاء الرسم البياني الفرعي المحدد بواسطة callable_options .
ReleaseCallable ( CallableHandle handle)	Status يقوم بتحرير الموارد المرتبطة handle المحدد في هذه الجلسة.
Run (const std::vector< Output > & fetch_outputs, std::vector< Tensor > *outputs) const	Status قم بتقييم الموترات في fetch_outputs .
Run (const FeedType & inputs, const std::vector< Output > & fetch_outputs, std::vector< Tensor > *outputs) const	Status كما هو موضح أعلاه، ولكن استخدم التعيين في inputs كمغذيات.
Run (const FeedType & inputs, const std::vector< Output > & fetch_outputs, const std::vector< Operation > & run_outputs, std::vector< Tensor > *outputs) const	Status كما هو مذكور أعلاه. بالإضافة إلى ذلك، يتم تشغيل العمليات في run_outputs .
Run (const RunOptions & run_options, const FeedType & inputs, const std::vector< Output > & fetch_outputs, const std::vector< Operation > & run_outputs, std::vector< Tensor > *outputs, RunMetadata *run_metadata) const	Status استخدم run_options لتفعيل خاصية تحليل الأداء.
Run (const RunOptions & run_options, const FeedType & inputs, const std::vector< Output > & fetch_outputs, const std::vector< Operation > & run_outputs, std::vector< Tensor > *outputs, RunMetadata *run_metadata, const thread::ThreadPoolOptions & threadpool_options) const	Status كما هو مذكور أعلاه.
RunCallable ( CallableHandle handle, const std::vector< Tensor > & feed_tensors, std::vector< Tensor > *fetch_tensors, RunMetadata *run_metadata)	Status يستدعي الرسم البياني الفرعي المسمى بواسطة handle مع الخيارات المحددة وموترات الإدخال.
RunCallable ( CallableHandle handle, const std::vector< Tensor > & feed_tensors, std::vector< Tensor > *fetch_tensors, RunMetadata *run_metadata, const thread::ThreadPoolOptions & options)	Status يستدعي الرسم البياني الفرعي المسمى بواسطة handle مع الخيارات المحددة وموترات الإدخال.

الأنواع العامة

CallableDandle

int64 CallableHandle

مقبض لرسم بياني فرعي، تم إنشاؤه باستخدام ClientSession::MakeCallable() .

نوع التغذية

std::unordered_map< Output, Input::Initializer, OutputHash > FeedType

نوع بيانات لتمثيل التغذية إلى استدعاء التشغيل.

هذه خريطة لكائنات Output التي تُرجعها دوال الإنشاء (op-constructors) إلى القيم التي تُغذى بها. راجع Input::Initializer للاطلاع على تفاصيل ما يمكن استخدامه كقيم تغذية.

الوظائف العامة

جلسة العميل

 ClientSession(
  const Scope & scope,
  const string & target
)

أنشئ جلسة جديدة لتقييم الرسم البياني الموجود في scope عن طريق الاتصال بوقت تشغيل TensorFlow المحدد بواسطة target .

جلسة العميل

 ClientSession(
  const Scope & scope
)

كما هو الحال أعلاه، ولكن استخدم السلسلة الفارغة ("") كمواصفات الهدف.

جلسة العميل

 ClientSession(
  const Scope & scope,
  const SessionOptions & session_options
)

أنشئ جلسة جديدة، وقم بتهيئتها باستخدام session_options .

قابل للاتصال

Status MakeCallable(
  const CallableOptions & callable_options,
  CallableHandle *out_handle
)

يقوم بإنشاء handle لاستدعاء الرسم البياني الفرعي المحدد بواسطة callable_options .

ملاحظة: لا تزال واجهة برمجة التطبيقات هذه تجريبية وقد تتغير.

ReleaseCallable

Status ReleaseCallable(
  CallableHandle handle
)

يقوم بتحرير الموارد المرتبطة handle المحدد في هذه الجلسة.

ملاحظة: لا تزال واجهة برمجة التطبيقات هذه تجريبية وقد تتغير.

يجري

Status Run(
  const std::vector< Output > & fetch_outputs,
  std::vector< Tensor > *outputs
) const 

قم بتقييم الموترات في fetch_outputs .

تُعاد القيم ككائنات Tensor في outputs . يتطابق عدد outputs وترتيبها مع fetch_outputs .

يجري

Status Run(
  const FeedType & inputs,
  const std::vector< Output > & fetch_outputs,
  std::vector< Tensor > *outputs
) const 

كما هو موضح أعلاه، ولكن استخدم التعيين في inputs كمغذيات.

يجري

Status Run(
  const FeedType & inputs,
  const std::vector< Output > & fetch_outputs,
  const std::vector< Operation > & run_outputs,
  std::vector< Tensor > *outputs
) const 

كما هو مذكور أعلاه. بالإضافة إلى ذلك، يتم تشغيل العمليات في run_outputs .

يجري

Status Run(
  const RunOptions & run_options,
  const FeedType & inputs,
  const std::vector< Output > & fetch_outputs,
  const std::vector< Operation > & run_outputs,
  std::vector< Tensor > *outputs,
  RunMetadata *run_metadata
) const 

استخدم run_options لتفعيل خاصية تحليل الأداء.

يتم ملء run_metadata ، إذا لم يكن فارغًا، بنتائج التحليل.

يجري

Status Run(
  const RunOptions & run_options,
  const FeedType & inputs,
  const std::vector< Output > & fetch_outputs,
  const std::vector< Operation > & run_outputs,
  std::vector< Tensor > *outputs,
  RunMetadata *run_metadata,
  const thread::ThreadPoolOptions & threadpool_options
) const 

كما هو مذكور أعلاه.

كما يسمح للمستخدم بتوفير تطبيق مخصص لمجموعة الخيوط عبر ThreadPoolOptions.

RunCallable

Status RunCallable(
  CallableHandle handle,
  const std::vector< Tensor > & feed_tensors,
  std::vector< Tensor > *fetch_tensors,
  RunMetadata *run_metadata
)

يستدعي الرسم البياني الفرعي المسمى بواسطة handle مع الخيارات المحددة وموترات الإدخال.

يجب أن يتطابق ترتيب الموترات في feed_tensors مع ترتيب الأسماء في CallableOptions::feed() ، وسيتطابق ترتيب الموترات في fetch_tensors مع ترتيب الأسماء في CallableOptions::fetch() عند إنشاء هذا الرسم البياني الفرعي. ملاحظة: لا تزال واجهة برمجة التطبيقات هذه تجريبية وقد تخضع للتغيير.

RunCallable

Status RunCallable(
  CallableHandle handle,
  const std::vector< Tensor > & feed_tensors,
  std::vector< Tensor > *fetch_tensors,
  RunMetadata *run_metadata,
  const thread::ThreadPoolOptions & options
)

يستدعي الرسم البياني الفرعي المسمى بواسطة handle مع الخيارات المحددة وموترات الإدخال.

يجب أن يتطابق ترتيب الموترات في feed_tensors مع ترتيب الأسماء في CallableOptions::feed() ، وسيتطابق ترتيب الموترات في fetch_tensors مع ترتيب الأسماء في CallableOptions::fetch() عند إنشاء هذا الرسم البياني الفرعي. ملاحظة: لا تزال واجهة برمجة التطبيقات هذه تجريبية وقد تخضع للتغيير.

جلسة العميل

 ~ClientSession()