Alcance

public final class Scope

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 seguros para thread.

Construtores Públicos

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

Métodos Públicos

OperationBuilder
applyControlDependencies (construtor OperationBuilder )
Inclui cada Operando em controlDependencies como uma entrada de controle para o construtor fornecido.
ExecutionEnvironment
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 (Iterable < Operando <? >> controles)
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 op.
Alcance
withSubScope (String childScopeName)
Retorna um novo escopo onde 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 )

Inclui 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.

Este método gera um nome exclusivo, apropriado para o escopo do nome controlado por esta instância. O código de construção do operador típico pode ser semelhante a 

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

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

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

pública Âmbito withControlDependencies (Iterable < Operando <? >> controles)

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 borda de controle de cada um dos controles fornecidos. Todas as outras propriedades são herdadas do escopo atual.

Parâmetros
controles controlar dependências 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 op.

As operações criadas neste escopo terão um nome no formato name/opName[_suffix] . Isso permite nomear 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 Scope que usa opName para operações.
Lança
Exceção de argumento ilegal se o nome é inválido

public Scope withSubScope (String childScopeName)

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

As operações criadas com este escopo terão 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 é inválido