EagerSession

cours final public EagerSession

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

L'exécution hâtive 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 graphique informatique à exécuter plus tard, comme avec Graph s et Session s.

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.
classe DésireuxSession.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 ()
Session impatiente statique
créer ()
Renvoie une EagerSession configurée avec les options par défaut.
Session impatiente statique
getDefault ()
Renvoie la session impatiente par défaut

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

Session impatiente 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.
OpérationBuilder
opBuilder (type de chaîne, nom de chaîne)
Renvoie un générateur pour créer une nouvelle Operation .
statique EagerSession.Options
options ()
Renvoie un objet qui configure et crée une EagerSession avec des options personnalisées.

Méthodes héritées

Méthodes publiques

fermeture publique synchronisée du vide ()

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 « essayer avec des ressources ».

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 impatiente par défaut reste active pendant toute la vie de l'application, contrairement aux sessions obtenues depuis create() ou 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'appeler initDefault(Options) avec un ensemble d'options différent 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());
 

Retours
  • session impatiente par défaut

public statique 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 implicitement invoquée 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
choix options à utiliser pour créer une session par défaut
Retours
  • session impatiente par défaut
Jetés
IllegalStateException si la session par défaut est déjà initialisée
Voir aussi

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

Renvoie 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.
Retours

Options publiques statiques EagerSession.Options ()

Renvoie un objet qui configure et crée 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 « essayer avec des ressources ».

Exemple d'utilisation :

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