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

Méthodes publiques

vide
checkInput (entrée opérationnelle )
Vérifie que input est valide pour être utilisée comme entrée dans cet environnement d'exécution.
vide
fermer ()
Session impatiente statique
créer ()
Renvoie une EagerSession configurée avec les options par défaut.
ExecutionEnvironment.Types
type d'environnement ()
Obtenez le type de cet environnement (à partir de l'énumération `Environnements`.
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.
booléen
isOpEnabled (chaîne opType)
Renvoie vrai si l'opération donnée est valide dans cet environnement d'exécution.
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

public void checkInput (entrée Op )

Vérifie que input est valide pour être utilisée comme entrée dans cet environnement d'exécution. Lève IllegalArgumentException sinon.

Paramètres
saisir L'opération à vérifier

public vide fermer ()

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 ExecutionEnvironment.Types environnementType ()

Obtenez le type de cet environnement (à partir de l'énumération `Environnements`.

Retours
  • Une valeur « Environnements » indiquant le type d'environnement d'exécution.

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 booléen isOpEnabled (String opType)

Renvoie vrai si l'opération donnée est valide dans cet environnement d'exécution.

Paramètres
TypeOp L'opération à vérifier.
Retours
  • Si l'opération donnée est valide dans cet environnement d'exécution.

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...
 
 }