تينسورفلو :: نِطَاق

يمثل كائن Scope مجموعة من عمليات TensorFlow ذات الصلة والتي لها نفس الخصائص مثل بادئة الاسم الشائع.

ملخص

كائن النطاق عبارة عن حاوية لخصائص TensorFlow Op. تحصل مُنشِئات Op على كائن Scope كوسيطة أولية إلزامية وتكتسب op المُنشأة الخصائص الموجودة في الكائن.

مثال بسيط:

using namespace ops;
Scope root = Scope::NewRootScope();
auto c1 = Const(root, { {1, 1} });
auto m = MatMul(root, c1, { {41}, {1} });
GraphDef gdef;
Status s = root.ToGraphDef(&gdef);
if (!s.ok()) { ... }

التسلسل الهرمي للنطاق :

توفر فئة النطاق وظائف بـ <> متنوعة تنشئ نطاقًا جديدًا. النطاق الجديد عادة به خاصية واحدة تم تغييرها بينما يتم توريث الخصائص الأخرى من النطاق الرئيسي. تقوم طريقة NewSubScope (الاسم) بإلحاق name ببادئة أسماء العمليات التي تم إنشاؤها داخل النطاق ، ويقوم WithOpName () بتغيير اللاحقة التي يتم تعيينها افتراضيًا على نوع المرجع.

أمثلة على الأسماء:

Scope root = Scope::NewRootScope();
Scope linear = root.NewSubScope("linear");
// W will be named "linear/W"
auto W = Variable(linear.WithOpName("W"),
                  {2, 2}, DT_FLOAT);
// b will be named "linear/b_3"
int idx = 3;
auto b = Variable(linear.WithOpName("b_", idx),
                  {2}, DT_FLOAT);
auto x = Const(linear, {...});  // name: "linear/Const"
auto m = MatMul(linear, x, W);  // name: "linear/MatMul"
auto r = BiasAdd(linear, m, b); // name: "linear/BiasAdd"

عمر النطاق :

يتم إنشاء نطاق جديد عن طريق استدعاء Scope :: NewRootScope . يؤدي هذا إلى إنشاء بعض الموارد التي يتم مشاركتها بواسطة جميع النطاقات الفرعية التي ترث من هذا النطاق ، بشكل مباشر أو مؤقت. على سبيل المثال ، يقوم النطاق الجديد بإنشاء كائن رسم بياني جديد تتم إضافة العمليات إليه عند استخدام النطاق الجديد أو توابعه بواسطة مُنشئ Op. يحتوي النطاق الجديد أيضًا على كائن الحالة الذي سيتم استخدامه للإشارة إلى الأخطاء بواسطة وظائف Op-constructor التي يتم استدعاؤها في أي نطاق فرعي. يجب أن تتحقق وظائف Op-constructor من حالة النطاق عن طريق استدعاء طريقة ok () قبل متابعة إنشاء المرجع.

سلامة الخيط:

كائن Scope ليس مؤشر ترابط آمن. لا يمكن للخيوط استدعاء وظائف op-constructor في نفس الوقت على نفس كائن Scope .

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

Scope ClearColocation() const 

Scope ColocateWith(
  const Operation & op
) const 

Scope ColocateWith(
  const Output & out
) const 

Scope ExitOnError() const 

CompositeOpScopes GetCompositeOpScopes(
  const string & composite_op_name
) const 

string GetUniqueNameForOp(
  const string & default_name
) const 

Scope NewSubScope(
  const string & child_scope_name
) const 

 Scope(
  const Scope & other
)

Status ToGraphDef(
  GraphDef *gdef
) const 

void UpdateStatus(
  const Status & s
) const 

Scope WithAssignedDevice(
  const string & assigned_device
) const 

Scope WithControlDependencies(
  const gtl::ArraySlice< Operation > & control_deps
) const 

Scope WithControlDependencies(
  const Output & control_dep
) const 

Scope WithDevice(
  const string & device
) const 

Scope WithKernelLabel(
  const string & kernel_label
) const 

Scope WithNoControlDependencies() const 

Scope WithOpName(
  Ty... fragments
) const 

Scope WithXlaCluster(
  const string & xla_cluster
) const 

const std::vector< Operation > & control_deps() const 

Graph * graph() const 

std::shared_ptr< Graph > graph_as_shared_ptr() const 

bool ok() const 

Scope & operator=(
  const Scope & other
)

Status status() const 

 ~Scope()

Scope NewRootScope()