جریان تنسور:: دامنه

یک شی Scope مجموعه ای از عملیات TensorFlow مرتبط را نشان می دهد که دارای ویژگی های یکسانی مانند پیشوند نام مشترک هستند.

خلاصه

یک شی Scope محفظه ای برای ویژگی های 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()) { ... }

سلسله مراتب محدوده :

کلاس Scope توابع مختلف With<> را ارائه می کند که یک محدوده جدید ایجاد می کند. دامنه جدید معمولاً دارای یک ویژگی تغییر می کند در حالی که سایر ویژگی ها از دامنه والد به ارث می رسد. متد NewSubScope(name) name به پیشوند نام‌های عملیات ایجاد شده در محدوده اضافه می‌کند، و WithOpName() پسوند را تغییر می‌دهد که در غیر این صورت به طور پیش‌فرض به نوع op مربوط می‌شود.

نمونه های نام:

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 ایجاد می شود. این باعث ایجاد منابعی می شود که توسط تمام حوزه های کودک که از این محدوده به ارث می برند، به طور مستقیم یا گذرا به اشتراک گذاشته می شوند. به عنوان مثال، یک scope جدید یک شی Graph جدید ایجاد می کند که زمانی که scope جدید یا فرزندان آن توسط سازنده Op استفاده می شود، عملیات به آن اضافه می شود. دامنه جدید همچنین دارای یک آبجکت Status است که برای نشان دادن خطاها توسط توابع سازنده Op که در هر محدوده فرزند فراخوانی می شوند استفاده می شود. توابع Op-constructor باید وضعیت محدوده را با فراخوانی متد ok() قبل از ادامه ساختن op بررسی کنند.

ایمنی نخ:

یک شی Scope از نظر رشته ایمن نیست. Thread ها نمی توانند همزمان توابع 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()