EagerSession

EagerSession public final class

Un entorno para ejecutar operaciones de TensorFlow con entusiasmo.

La ejecución ávida es un entorno de programación imperativo que evalúa las operaciones de inmediato, sin crear gráficos. Operaciones devuelven valores concretos en lugar de construir una gráfica computacional para ejecutar más tarde, al igual que con Graph s y Session s.

Esto facilita el desarrollo con TensorFlow y los modelos de depuración, ya que se comporta más como una biblioteca de programación estándar.

Las instancias de un EagerSession son thread-safe.

Clases anidadas

enumeración EagerSession.DevicePlacementPolicy Controla cómo actuar cuando intentamos ejecutar una operación en un dispositivo determinado, pero algunos tensores de entrada no están en ese dispositivo.
clase EagerSession.Options
enumeración EagerSession.ResourceCleanupStrategy Controla cómo se limpian los recursos de TensorFlow cuando ya no se necesitan.

Métodos públicos

vacío sincronizado
Cerrar ()
estática EagerSession
crear ()
Devuelve un EagerSession configurado con las opciones predeterminadas.
estática EagerSession
getDefault ()
Devuelve la sesión ansiosa predeterminada

Una vez inicializado, la sesión ansiosos por defecto permanece activo durante toda la vida de la aplicación, a diferencia de las sesiones obtenidos de create() o build() que debe ser cerrado después de su uso.

estática EagerSession
InitDefault ( EagerSession.Options opciones)
Inicializa la sesión ansiosa predeterminada, que permanece activa durante la vida útil de la aplicación.
OperationBuilder
opBuilder (tipo String, String name)
Devuelve un creador para crear una nueva Operation .
estáticas EagerSession.Options
Opciones ()
Devuelve un objeto que configura y construye una EagerSession con opciones de personalización.

Métodos heredados

Métodos públicos

pública sincronizado void close ()

public static EagerSession crear ()

Devuelve un EagerSession configurado con las opciones predeterminadas.

ADVERTENCIA: Los casos de EagerSession devueltos por este método deben ser liberados de forma explícita mediante la invocación de close() cuando ya no se necesitan. Esto podría lograrse utilizando la técnica `try-with-resources`.

Ejemplo de uso:

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

public static EagerSession getDefault ()

Devuelve la sesión ansiosa predeterminada

Una vez inicializado, la sesión ansiosos por defecto permanece activo durante toda la vida de la aplicación, a diferencia de las sesiones obtenidos de create() o build() que debe ser cerrado después de su uso.

El conjunto predeterminado de EagerSession.Options se utiliza para inicializar la sesión en la primera llamada. Para anular este comportamiento, es posible invocar initDefault(Options) con un conjunto diferente de opciones antes de esta primera llamada.

Ejemplo de uso:

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

Devoluciones
  • sesión ansiosa por defecto

public static EagerSession InitDefault ( EagerSession.Options opciones)

Inicializa la sesión ansiosa predeterminada, que permanece activa durante la vida útil de la aplicación.

Este método se invoca de forma implícita en la primera llamada a getDefault() , pero también se puede invocar de forma explícita a las opciones por defecto de anulación.

Tenga en cuenta que llamar a este método más de una vez arrojará una IllegalArgumentException como la sesión predeterminada no se puede modificar una vez que se ha creado. Por lo tanto, es importante para inicializar explícitamente antes getDefault() se invoca por primera vez desde cualquier hilo.

Ejemplo de uso:

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

Parámetros
opciones opciones que se utilizarán para crear una sesión predeterminada
Devoluciones
  • sesión ansiosa por defecto
Lanza
IllegalStateException si la sesión predeterminada ya está inicializada
Ver también

pública OperationBuilder opBuilder (tipo String, String name)

Devuelve un creador para crear una nueva Operation .

Parámetros
escribe de la Operación (es decir, identifica el cálculo a realizar)
nombre para hacer referencia a la Operación creada en este ámbito de entorno.
Devoluciones
  • un OperationBuilder para crear una operación cuando build() se invoca. Si build() no se invoca, a continuación, algunos recursos pueden tener fugas.

estáticas pública EagerSession.Options opciones ()

Devuelve un objeto que configura y construye una EagerSession con opciones de personalización.

ADVERTENCIA: Los casos de EagerSession devueltos por este método deben ser liberados de forma explícita mediante la invocación de close() cuando ya no se necesitan. Esto podría lograrse utilizando la técnica `try-with-resources`.

Ejemplo de uso:

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