Aviso: esta API está obsoleta e será removida em uma versão futura do TensorFlow depois que a substituição estiver estável.

EagerSession

classe final pública EagerSession

Um ambiente para executar operações do TensorFlow avidamente.

A execução ansiosa é um ambiente de programação imperativo que avalia as operações imediatamente, sem construir gráficos. As operações retornam valores concretos em vez de construir um gráfico computacional para ser executado posteriormente, como acontece com Graph se Session s.

Isso facilita o desenvolvimento com o TensorFlow e os modelos de depuração, pois ele se comporta mais como uma biblioteca de programação padrão.

As instâncias de uma EagerSession são thread-safe.

Classes aninhadas

enumerar EagerSession.DevicePlacementPolicy Controla como agir quando tentamos executar uma operação em um determinado dispositivo, mas alguns tensores de entrada não estão nesse dispositivo.
classe Opções de Sessão Ansiosa
enumerar EagerSession.ResourceCleanupStrategy Controla como os recursos do TensorFlow são limpos quando não são mais necessários.

Métodos públicos

vazio sincronizado
fechar ()
static EagerSession
criar ()
Retorna uma EagerSession configurada com opções padrão.
static EagerSession
getDefault ()
Retorna a sessão ansiosa padrão

Uma vez inicializada, a sessão ansiosa padrão permanece ativa por toda a vida útil do aplicativo, ao contrário das sessões obtidas de create() ou EagerSession.Options.build() que devem ser fechadas após o uso.

static EagerSession
initDefault (opções EagerSession.Options )
Inicializa a sessão antecipada padrão, que permanece ativa durante o tempo de vida do aplicativo.
OperationBuilder
opBuilder (tipo de string, nome de string)
Retorna um construtor para criar uma nova Operation .
static EagerSession.Options
opções ()
Retorna um objeto que configura e cria uma EagerSession com opções personalizadas.

Métodos Herdados

Métodos públicos

público sincronizado void close ()

public static EagerSession create ()

Retorna uma EagerSession configurada com opções padrão.

AVISO: As instâncias de EagerSession retornadas por esse método devem ser liberadas explicitamente invocando close() quando não forem mais necessárias. Isso pode ser conseguido usando a técnica `try-with-resources`.

Exemplo de uso:

try (EagerSession session = EagerSession.create()) {
   Ops tf = Ops.create(session);
   // build execute operations eagerly...
 }
 

public static EagerSession getDefault ()

Retorna a sessão ansiosa padrão

Uma vez inicializada, a sessão ansiosa padrão permanece ativa por toda a vida útil do aplicativo, ao contrário das sessões obtidas de create() ou EagerSession.Options.build() que devem ser fechadas após o uso.

O conjunto padrão de EagerSession.Options é usado para inicializar a sessão na primeira chamada. Para substituir esse comportamento, é possível invocar initDefault(Options) com um conjunto diferente de opções antes dessa primeira chamada.

Exemplo de uso:

// Starting to build eager operations using default session, by calling
 // EagerSession.getDefault() implicitly
 Ops tf = Ops.create();

 // Starting to build eager operations using default session, by calling
 // EagerSession.getDefault() explicitly
 Ops tf = Ops.create(EagerSession.getDefault());
 

Devoluções
  • sessão ansiosa padrão

public static EagerSession initDefault (opções EagerSession.Options )

Inicializa a sessão antecipada padrão, que permanece ativa durante o tempo de vida do aplicativo.

Esse método é invocado implicitamente na primeira chamada para getDefault() , mas também pode ser invocado explicitamente para substituir as opções padrão.

Observe que chamar esse método mais de uma vez lançará um IllegalArgumentException , pois a sessão padrão não pode ser modificada depois de criada. Portanto, é importante inicializá-lo explicitamente antes que getDefault() seja invocado pela primeira vez de qualquer thread.

Exemplo de uso:

// Initializing default session to override default options is valid but
 // is optional
 EagerSession.initDefault(EagerSession.options().async(true));

 // Starting to build eager operations using default session, by calling
 // EagerSession.getDefault() implicitly
 Ops tf = Ops.create();

 // Initializing default session more than once or after using it is not
 // permitted and throws an exception
 EagerSession.initDefault(EagerSession.options().async(true));  // throws
 

Parâmetros
opções opções para usar para construir a sessão padrão
Devoluções
  • sessão ansiosa padrão
Lança
IllegalStateException se a sessão padrão já estiver inicializada
Veja também

public OperationBuilder opBuilder (tipo de string, nome de string)

Retorna um construtor para criar uma nova Operation .

Parâmetros
modelo da Operação (ou seja, identifica o cálculo a ser realizado)
nome para se referir à Operação criada neste escopo de ambiente.
Devoluções

opções public static EagerSession.Options ()

Retorna um objeto que configura e cria uma EagerSession com opções personalizadas.

AVISO: As instâncias de EagerSession retornadas por esse método devem ser liberadas explicitamente invocando close() quando não forem mais necessárias. Isso pode ser conseguido usando a técnica `try-with-resources`.

Exemplo de uso:

try (EagerSession session = EagerSession.options().async(true).build()) {
   Ops tf = Ops.create(session);
   // build execute operations eagerly and asynchronously...
 }