tensorflow:: תְחוּם

אובייקט Scope מייצג קבוצה של TensorFlow פעולות קשורות שיש להם את אותם מאפיינים כמו קידומת שם נפוץ.

תַקצִיר

אובייקט Scope הוא מיכל למאפייני TensorFlow Op. בנאי אופ מקבלים אובייקט Scope כארגומנט ראשון חובה והאופ שנבנה רוכש את המאפיינים באובייקט.

דוגמה פשוטה:

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 לקידומת של שמות עבור ops שנוצרו בתוך ה-scope, ו- 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 . זה יוצר כמה משאבים המשותפים לכל הטווחים הצאצאים שיורשים מהיקף זה, באופן ישיר או טרנזיטיבי. לדוגמה, היקף חדש יוצר אובייקט Graph חדש שאליו מתווספות פעולות כאשר ה-scope החדש או הילדים שלו נמצאים בשימוש על ידי בנאי Op. ל-scope החדש יש גם אובייקט Status אשר ישמש לציון שגיאות על-ידי פונקציות Op-constructor הנקראות בכל טווח ילד. פונקציות ה-Op-constructor צריכות לבדוק את מצב ה-scope על ידי קריאה למתודה ok() לפני המשך בניית ה-op.

בטיחות חוטים:

אובייקט Scope אינו בטוח לחוט. שרשורים אינם יכולים לקרוא בו-זמנית לפונקציות בונה אופ על אותו אובייקט 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()