Scope

Escopo da classe final pública

Gerencia grupos de propriedades relacionadas ao criar operações do Tensorflow, como um prefixo de nome comum.

Um Scope é um contêiner para propriedades comuns aplicadas ao TensorFlow Ops. O código de usuário normal inicializa um Scope e o fornece às classes de construção de Operação. Por exemplo:

Scope scope = new Scope(graph);
 Constant c = Constant.create(scope, 42);
 

Uma classe de construção de operação adquire um escopo e o usa para definir propriedades nas operações subjacentes do Tensorflow. Por exemplo:

// An operator class that adds a constant.
 public class Constant {
   public static Constant create(Scope scope, ...) {
      scope.graph().opBuilder(
        "Const", scope.makeOpName("Const"))
        .setAttr(...)
        .build()
      ...
   }
 }
 

Hierarquia de escopo:

Um Scope fornece vários métodos with() que criam um novo escopo. O novo escopo normalmente tem uma propriedade alterada enquanto outras propriedades são herdadas do escopo pai.

Um exemplo usando Constant implementado como antes:

Scope root = new Scope(graph);

 // The linear subscope will generate names like linear/...
 Scope linear = Scope.withSubScope("linear");

 // This op name will be "linear/W"
 Constant.create(linear.withName("W"), ...);

 // This op will be "linear/Const", using the default
 // name provided by Constant
 Constant.create(linear, ...);

 // This op will be "linear/Const_1", using the default
 // name provided by Constant and making it unique within
 // this scope
 Constant.create(linear, ...);
 

Objetos de escopo não são thread-safe.

Construtores públicos

Escopo (ambiente ExecutionEnvironment )
Crie um novo escopo de nível superior.

Métodos públicos

OperationBuilder
applyControlDependencies (construtor OperationBuilder )
Adiciona cada Operando em controlDependencies como uma entrada de controle para o construtor fornecido.
Ambiente de Execução
env ()
Retorna o ambiente de execução usado por este escopo.
Fragmento
makeOpName (String defaultName)
Crie um nome exclusivo para um operador, usando um padrão fornecido, se necessário.
Alcance
withControlDependencies (controles Iterable< Operando <?>>)
Retorna um novo escopo onde as operações adicionadas terão as dependências de controle fornecidas.
Alcance
withName (String opName)
Retorne um novo escopo que usa o nome fornecido para uma operação.
Alcance
withSubScope (String childScopeName)
Retorna um novo escopo em que as operações adicionadas terão o prefixo de nome fornecido.

Métodos Herdados

Construtores públicos

Escopo público (ambiente ExecutionEnvironment )

Crie um novo escopo de nível superior.

Parâmetros
env O ambiente de execução usado pelo escopo.

Métodos públicos

public OperationBuilder applyControlDependencies (construtor OperationBuilder )

Adiciona cada Operando em controlDependencies como uma entrada de controle para o construtor fornecido.

Parâmetros
construtor OperationBuilder para adicionar entradas de controle a

public ExecutionEnvironment env ()

Retorna o ambiente de execução usado por este escopo.

public String makeOpName (String defaultName)

Crie um nome exclusivo para um operador, usando um padrão fornecido, se necessário.

Isso normalmente é chamado apenas por classes de construção de operadores.

Esse método gera um nome exclusivo, apropriado para o escopo do nome controlado por essa instância. O código de construção do operador típico pode se parecer com

scope.env().opBuilder("Const", scope.makeOpName("Const"))...
 

Observação: se você fornecer uma classe de construção de operador composto (ou seja, uma classe que cria um conjunto de operações relacionadas chamando o código de construção de outro operador), o nome fornecido atuará como um subescopo para todos os operadores subjacentes.

Parâmetros
nome padrão nome para o operador subjacente.
Devoluções
  • nome exclusivo para o operador.
Lança
Exceção de argumento ilegal se o nome padrão for inválido.

Public Scope withControlDependencies (controles Iterable< Operando <?>>)

Retorna um novo escopo onde as operações adicionadas terão as dependências de controle fornecidas.

As operações criadas com este escopo terão uma vantagem de controle de cada um dos controles fornecidos. Todas as outras propriedades são herdadas do escopo atual.

Parâmetros
controles dependências de controle para operações criadas com o escopo retornado
Devoluções
  • um novo escopo com as dependências de controle fornecidas

Public Scope withName (String opName)

Retorne um novo escopo que usa o nome fornecido para uma operação.

As operações criadas neste escopo terão um nome no formato name/opName[_suffix] . Isso permite que você nomeie um operador específico de forma mais significativa.

Os nomes devem corresponder à expressão regular [A-Za-z0-9.][A-Za-z0-9_.\-]*

Parâmetros
opName nome de um operador no escopo retornado
Devoluções
  • um novo Escopo que usa opName para operações.
Lança
Exceção de argumento ilegal se o nome for inválido

Public Scope withSubScope (String childScopeName)

Retorna um novo escopo em que as operações adicionadas terão o prefixo de nome fornecido.

As operações criadas com este escopo terão name/childScopeName/ como prefixo. O nome real será exclusivo no escopo retornado. Todas as outras propriedades são herdadas do escopo atual.

O nome do escopo filho deve corresponder à expressão regular [A-Za-z0-9.][A-Za-z0-9_.\-]*

Parâmetros
childScopeName nome para o novo escopo filho
Devoluções
  • um novo subescopo
Lança
Exceção de argumento ilegal se o nome for inválido