Avertissement: cette API est obsolète et sera supprimée dans une future version de TensorFlow une fois le remplacement stable.

EagerSession

classe finale publique EagerSession

Un environnement pour exécuter avec impatience les opérations TensorFlow.

L'exécution rapide est un environnement de programmation impératif qui évalue les opérations immédiatement, sans créer de graphiques. Les opérations renvoient des valeurs concrètes au lieu de construire un graphe de calcul à exécuter plus tard, comme avec les Graph et les Session .

Cela facilite le développement avec TensorFlow et les modèles de débogage, car il se comporte davantage comme une bibliothèque de programmation standard.

Les instances d'une EagerSession sont thread-safe.

Classes imbriquées

énumération EagerSession.DevicePlacementPolicy Contrôle comment agir lorsque nous essayons d'exécuter une opération sur un appareil donné mais que certains tenseurs d'entrée ne sont pas sur cet appareil.
classer EagerSession.Options
énumération EagerSession.ResourceCleanupStrategy Contrôle la manière dont les ressources TensorFlow sont nettoyées lorsqu'elles ne sont plus nécessaires.

Méthodes publiques

vide synchronisé
fermer ()
EagerSession statique
créer ()
Renvoie une EagerSession configurée avec les options par défaut.
EagerSession statique
getDefault ()
Renvoie la session impatiente par défaut

Une fois initialisée, la session avide par défaut reste active pendant toute la durée de vie de l'application, contrairement aux sessions obtenues à partir de create() ou EagerSession.Options.build() qui doivent être fermées après leur utilisation.

EagerSession statique
initDefault (options EagerSession.Options )
Initialise la session impatiente par défaut, qui reste active pendant toute la durée de vie de l'application.
OperationBuilder
opBuilder (type de chaîne, nom de chaîne)
Retourne un générateur pour créer une nouvelle Operation .
statique EagerSession.Options
choix ()
Retourne un objet qui configure et construit une EagerSession avec des options personnalisées.

Méthodes héritées

Méthodes publiques

fermeture de vide synchronisée publique ()

public statique EagerSession créer ()

Renvoie une EagerSession configurée avec les options par défaut.

AVERTISSEMENT : les instances de EagerSession renvoyées par cette méthode doivent être explicitement libérées en appelant close() lorsqu'elles ne sont plus nécessaires. Cela pourrait être réalisé en utilisant la technique `try-with-resources`.

Exemple d'utilisation :

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

public statique EagerSession getDefault ()

Renvoie la session impatiente par défaut

Une fois initialisée, la session avide par défaut reste active pendant toute la durée de vie de l'application, contrairement aux sessions obtenues à partir de create() ou EagerSession.Options.build() qui doivent être fermées après leur utilisation.

L'ensemble par défaut de EagerSession.Options est utilisé pour initialiser la session lors du premier appel. Pour remplacer ce comportement, il est possible d'invoquer initDefault(Options) avec un ensemble différent d'options avant ce premier appel.

Exemple d'utilisation :

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

Retour
  • session impatiente par défaut

public static EagerSession initDefault (options EagerSession.Options )

Initialise la session impatiente par défaut, qui reste active pendant toute la durée de vie de l'application.

Cette méthode est invoquée implicitement lors du premier appel à getDefault() , mais peut également être invoquée explicitement pour remplacer les options par défaut.

Notez qu'appeler cette méthode plus d'une fois lèvera une IllegalArgumentException car la session par défaut ne peut pas être modifiée une fois qu'elle a été créée. Par conséquent, il est important de l'initialiser explicitement avant que getDefault() ne soit invoqué pour la première fois depuis n'importe quel thread.

Exemple d'utilisation :

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

Paramètres
options options à utiliser pour créer une session par défaut
Retour
  • session impatiente par défaut
Lance
IllegalStateException si la session par défaut est déjà initialisée
Voir également

public OperationBuilder opBuilder (type de chaîne, nom de chaîne)

Retourne un générateur pour créer une nouvelle Operation .

Paramètres
taper de l'opération (c'est-à-dire, identifie le calcul à effectuer)
Nom pour faire référence à l'opération créée dans cette portée d'environnement.
Retour

public statique EagerSession.Options options ()

Retourne un objet qui configure et construit une EagerSession avec des options personnalisées.

AVERTISSEMENT : les instances de EagerSession renvoyées par cette méthode doivent être explicitement libérées en appelant close() lorsqu'elles ne sont plus nécessaires. Cela pourrait être réalisé en utilisant la technique `try-with-resources`.

Exemple d'utilisation :

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