Tensorflow :: Umfang

Ein Scope Objekt repräsentiert eine Reihe verwandter TensorFlow-Operationen, die dieselben Eigenschaften haben, z. B. ein gemeinsames Namenspräfix.

Zusammenfassung

Ein Scope- Objekt ist ein Container für TensorFlow Op-Eigenschaften. Op-Konstruktoren erhalten ein Scope- Objekt als obligatorisches erstes Argument, und das konstruierte op erhält die Eigenschaften im Objekt.

Ein einfaches Beispiel:

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()) { ... }

Umfangshierarchie :

Die Scope- Klasse bietet verschiedene With <> -Funktionen, mit denen ein neuer Bereich erstellt wird. Im neuen Bereich wird normalerweise eine Eigenschaft geändert, während andere Eigenschaften vom übergeordneten Bereich geerbt werden. Die NewSubScope (name) -Methode hängt den name an das Präfix der Namen für im Bereich erstellte Operationen an , und WithOpName () ändert das Suffix, das ansonsten standardmäßig den Typ der Operation verwendet .

Namensbeispiele:

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"

Lebensdauer des Anwendungsbereichs :

Ein neuer Bereich wird durch Aufrufen von Scope :: NewRootScope erstellt . Dadurch werden einige Ressourcen erstellt, die von allen untergeordneten Bereichen, die direkt oder transitiv von diesem Bereich erben, gemeinsam genutzt werden. Beispielsweise erstellt ein neuer Bereich ein neues Diagrammobjekt, dem Operationen hinzugefügt werden, wenn der neue Bereich oder seine untergeordneten Elemente von einem Op-Konstruktor verwendet werden. Der neue Bereich verfügt auch über ein Status- Objekt, mit dem Fehler von Op-Konstruktor-Funktionen angezeigt werden, die für einen untergeordneten Bereich aufgerufen werden. Die Op-Konstruktor-Funktionen müssen den Status des Bereichs überprüfen, indem sie die ok () -Methode aufrufen, bevor sie mit der Erstellung des Op fortfahren.

Gewindesicherheit:

Ein Scope Objekt ist NICHT threadsicher. Threads können nicht gleichzeitig Op-Konstruktor-Funktionen für dasselbe Scope Objekt aufrufen.

Öffentliche Funktionen

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()