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 () |
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 | |
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() explictly
Ops tf = Ops.create(EagerSession.getDefault());
Retours
- session impatiente par défaut
Voir aussi
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
- un
OperationBuilder
pour créer une opération lorsquebuild()
est invoqué. Sibuild()
n'est pas invoqué, certaines ressources peuvent fuir.
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...
}