텐서플로우:: 범위

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()은 작업 유형의 기본값인 접미사를 변경합니다.

이름 예시:

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 생성자가 새 범위나 해당 하위 범위를 사용할 때 작업이 추가되는 새 Graph 개체를 만듭니다. 새 범위에는 하위 범위에서 호출되는 Op 생성자 함수에 의해 오류를 나타내는 데 사용되는 Status 개체도 있습니다. Op 생성자 함수는 op 구성을 진행하기 전에 ok() 메서드를 호출하여 범위의 상태를 확인해야 합니다.

스레드 안전성:

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