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 () |
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 | |
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 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() explictly
Ops tf = Ops.create(EagerSession.getDefault());
Devoluções
- sessão ansiosa padrão
Veja também
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
tipo | 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
- um
OperationBuilder
para criar uma operação quandobuild()
é invocado. Sebuild()
não for invocado, alguns recursos poderão vazar.
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...
}