Um ambiente para executar operações do TensorFlow com entusiasmo.
A execução rápida é 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 com Graph
Session
s.
Isso facilita o desenvolvimento com TensorFlow e 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
enum | 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. | |
aula | EagerSession.Options |
Métodos Públicos
vazio | checkInput (entrada Op ) Verifica se a input é válida para usar como uma entrada neste ambiente de execução. |
vazio | fechar () |
EagerSession estática | criar () Retorna uma EagerSession configurada com opções padrão. |
ExecutionEnvironment.Types | environmentType () Obtenha o tipo deste ambiente (da enumeração `Environments`. |
EagerSession estática | getDefault () |
EagerSession estática | initDefault (opções EagerSession.Options ) Inicializa a sessão inicial padrão, que permanece ativa durante o tempo de vida do aplicativo. |
boleano | isOpEnabled (String opType) Retorna verdadeiro se a operação fornecida for válida neste ambiente de execução. |
OperationBuilder | |
static EagerSession.Options | opções () Retorna um objeto que configura e constrói uma EagerSession com opções personalizadas. |
Métodos herdados
Métodos Públicos
public void checkInput (entrada Op )
Verifica se a input
é válida para usar como uma entrada neste ambiente de execução. Lança IllegalArgumentException
se não.
Parâmetros
entrada | A op para verificar |
---|
public void close ()
public static EagerSession create ()
Retorna uma EagerSession
configurada com opções padrão.
AVISO: as instâncias de EagerSession
retornadas por este 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 ExecutionEnvironment.Types environmentType ()
Obtenha o tipo deste ambiente (da enumeração `Environments`.
Devoluções
- Um valor `Environments` indicando o tipo de ambiente de execução.
public static EagerSession getDefault ()
Retorna a sessão inicial 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 em create()
ou build()
que devem ser fechadas após seu uso.
O conjunto padrão de EagerSession.Options
é usado para inicializar a sessão na primeira chamada. Para substituir este comportamento, é possível invocar initDefault(Options)
com um conjunto diferente de opções antes desta 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
Veja também
public static EagerSession initDefault (opções EagerSession.Options )
Inicializa a sessão inicial padrão, que permanece ativa durante o tempo de vida do aplicativo.
Este 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á uma IllegalArgumentException
pois a sessão padrão não pode ser modificada depois de criada. Portanto, é importante inicializá-lo explicitamente antes que getDefault()
seja chamado 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á foi inicializada |
---|
Veja também
public boolean isOpEnabled (String opType)
Retorna verdadeiro se a operação fornecida for válida neste ambiente de execução.
Parâmetros
opType | A op para verificar. |
---|
Devoluções
- Se a operação fornecida é válida neste ambiente de execução.
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 executado) |
---|---|
nome | para referir-se à Operação criada neste âmbito de ambiente. |
Devoluções
- um
OperationBuilder
para criar uma operação quandobuild()
é invocado. Sebuild()
não for invocado, alguns recursos podem vazar.
public static EagerSession.Options options ()
Retorna um objeto que configura e constrói uma EagerSession
com opções personalizadas.
AVISO: as instâncias de EagerSession
retornadas por este 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...
}