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 dado, 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 () |
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 | |
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
Ver también
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 cuandobuild()
se invoca. Sibuild()
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...
}