EagerSession

public final class EagerSession

Un ambiente per eseguire con entusiasmo le operazioni TensorFlow.

L'esecuzione desiderosa è un ambiente di programmazione imperativo che valuta le operazioni immediatamente, senza creare grafici. Le operazioni restituiscono valori concreti invece di costruire un grafo computazionale da eseguire in seguito, come con Graph Session s.

Ciò semplifica lo sviluppo con TensorFlow e il debug dei modelli, poiché si comporta più come una libreria di programmazione standard.

Le istanze di un EagerSession sono thread-safe.

Classi annidate

enum EagerSession.DevicePlacementPolicy Controlla come agire quando proviamo a eseguire un'operazione su un dato dispositivo ma alcuni tensori di input non sono su quel dispositivo.
classe EagerSession.Options
enum EagerSession.ResourceCleanupStrategy Controlla il modo in cui le risorse TensorFlow vengono pulite quando non sono più necessarie.

Metodi pubblici

vuoto sincronizzato
EagerSession statico
creare ()
Restituisce un EagerSession configurato con le opzioni predefinite.
EagerSession statico
getDefault ()
Restituisce la sessione eager predefinita

Una volta inizializzata, la sessione eager predefinita rimane attiva per l'intera vita dell'applicazione, a differenza delle sessioni ottenute da create() o build() che dovrebbero essere chiuse dopo il loro utilizzo.

EagerSession statico
initDefault (opzioni EagerSession.Options )
Inizializza la sessione eager predefinita, che rimane attiva per la durata dell'applicazione.
OperationBuilder
opBuilder (tipo stringa, nome stringa)
Restituisce un builder per creare una nuova Operation .
EagerSession.Options statico
opzioni ()
Restituisce un oggetto che configura e costruisce un EagerSession con opzioni personalizzate.

Metodi ereditati

Metodi pubblici

pubblico sincronizzato void close ()

public static EagerSession create ()

Restituisce un EagerSession configurato con le opzioni predefinite.

ATTENZIONE: Le istanze di EagerSession restituite da questo metodo devono essere liberate esplicitamente invocando close() quando non sono più necessarie. Ciò potrebbe essere ottenuto utilizzando la tecnica "try-with-resources".

Esempio di utilizzo:

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

public static EagerSession getDefault ()

Restituisce la sessione eager predefinita

Una volta inizializzata, la sessione eager predefinita rimane attiva per l'intera vita dell'applicazione, a differenza delle sessioni ottenute da create() o build() che dovrebbero essere chiuse dopo il loro utilizzo.

Il set predefinito di EagerSession.Options viene utilizzato per inizializzare la sessione alla prima chiamata. Per sovrascrivere questo comportamento, è possibile invocare initDefault(Options) con un diverso insieme di opzioni prima di questa prima chiamata.

Esempio di utilizzo:

// 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());
 

ritorna
  • sessione entusiasta predefinita

public static EagerSession initDefault (opzioni EagerSession.Options )

Inizializza la sessione eager predefinita, che rimane attiva per la durata dell'applicazione.

Questo metodo viene invocato implicitamente alla prima chiamata a getDefault() , ma può anche essere invocato esplicitamente per sovrascrivere le opzioni predefinite.

Si noti che chiamare questo metodo più di una volta genererà IllegalArgumentException poiché la sessione predefinita non può essere modificata una volta creata. Pertanto, è importante inizializzarlo esplicitamente prima che getDefault() venga invocato per la prima volta da qualsiasi thread.

Utilizzo di esempio:

// 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
 

Parametri
opzioni opzioni da utilizzare per creare la sessione predefinita
ritorna
  • sessione entusiasta predefinita
Lancia
IllegalStateException se la sessione predefinita è già inizializzata
Guarda anche

public OperationBuilder opBuilder (tipo String, nome String)

Restituisce un builder per creare una nuova Operation .

Parametri
genere dell'operazione (ovvero, identifica il calcolo da eseguire)
nome per fare riferimento all'operazione creata in questo ambito di ambiente.
ritorna

public static EagerSession.Options opzioni ()

Restituisce un oggetto che configura e costruisce un EagerSession con opzioni personalizzate.

ATTENZIONE: Le istanze di EagerSession restituite da questo metodo devono essere liberate esplicitamente invocando close() quando non sono più necessarie. Ciò potrebbe essere ottenuto utilizzando la tecnica "try-with-resources".

Esempio di utilizzo:

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