tensoreflusso:: Sessione cliente
#include <client_session.h>
Un oggetto ClientSession
consente al chiamante di guidare la valutazione del grafico TensorFlow costruito con l'API C++.
Riepilogo
Esempio:
Scope root = Scope::NewRootScope(); auto a = Placeholder(root, DT_INT32); auto c = Add(root, a, {41}); ClientSession session(root); std::vectoroutputs; Status s = session.Run({ {a, {1} } }, {c}, &outputs); if (!s.ok()) { ... }
Costruttori e distruttori | |
---|---|
ClientSession (const Scope & scope, const string & target) Crea una nuova sessione per valutare il grafico contenuto in scope connettendosi al runtime TensorFlow specificato da target . | |
ClientSession (const Scope & scope) Come sopra, ma utilizza la stringa vuota ("") come specifica di destinazione. | |
ClientSession (const Scope & scope, const SessionOptions & session_options) Crea una nuova sessione, configurandola con session_options . | |
~ClientSession () |
Tipi pubblici | |
---|---|
CallableHandle | typedefint64 Un handle per un sottografo, creato con ClientSession::MakeCallable() . |
FeedType | typedefstd::unordered_map< Output , Input::Initializer , OutputHash > Un tipo di dati per rappresentare i feed per una chiamata Esegui. |
Funzioni pubbliche | |
---|---|
MakeCallable (const CallableOptions & callable_options, CallableHandle *out_handle) | Status Crea un handle per richiamare il sottografo definito da callable_options . |
ReleaseCallable ( CallableHandle handle) | Status Rilascia le risorse associate handle specificato in questa sessione. |
Run (const std::vector< Output > & fetch_outputs, std::vector< Tensor > *outputs) const | Status Valuta i tensori in fetch_outputs . |
Run (const FeedType & inputs, const std::vector< Output > & fetch_outputs, std::vector< Tensor > *outputs) const | Status Come sopra, ma utilizza la mappatura negli inputs come feed. |
Run (const FeedType & inputs, const std::vector< Output > & fetch_outputs, const std::vector< Operation > & run_outputs, std::vector< Tensor > *outputs) const | Status Come sopra. Inoltre esegue le operazioni in run_outputs . |
Run (const RunOptions & run_options, const FeedType & inputs, const std::vector< Output > & fetch_outputs, const std::vector< Operation > & run_outputs, std::vector< Tensor > *outputs, RunMetadata *run_metadata) const | Status Utilizza run_options per attivare la profilazione delle prestazioni. |
Run (const RunOptions & run_options, const FeedType & inputs, const std::vector< Output > & fetch_outputs, const std::vector< Operation > & run_outputs, std::vector< Tensor > *outputs, RunMetadata *run_metadata, const thread::ThreadPoolOptions & threadpool_options) const | Status Come sopra. |
RunCallable ( CallableHandle handle, const std::vector< Tensor > & feed_tensors, std::vector< Tensor > *fetch_tensors, RunMetadata *run_metadata) | Status Richiama il sottografo denominato da handle con le opzioni e i tensori di input specificati. |
RunCallable ( CallableHandle handle, const std::vector< Tensor > & feed_tensors, std::vector< Tensor > *fetch_tensors, RunMetadata *run_metadata, const thread::ThreadPoolOptions & options) | Status Richiama il sottografo denominato da handle con le opzioni e i tensori di input specificati. |
Tipi pubblici
CallableHandle
int64 CallableHandle
Un handle per un sottografo, creato con ClientSession::MakeCallable()
.
FeedType
std::unordered_map< Output, Input::Initializer, OutputHash > FeedType
Un tipo di dati per rappresentare i feed per una chiamata Esegui.
Questa è una mappa di oggetti Output
restituiti dai costruttori op al valore con cui alimentarli. Vedi Input::Initializer
per i dettagli su cosa può essere utilizzato come valori di feed.
Funzioni pubbliche
Sessione cliente
ClientSession( const Scope & scope, const string & target )
Crea una nuova sessione per valutare il grafico contenuto in scope
connettendosi al runtime TensorFlow specificato da target
.
Sessione cliente
ClientSession( const Scope & scope )
Come sopra, ma utilizza la stringa vuota ("") come specifica di destinazione.
Sessione cliente
ClientSession( const Scope & scope, const SessionOptions & session_options )
Crea una nuova sessione, configurandola con session_options
.
MakeCallable
Status MakeCallable( const CallableOptions & callable_options, CallableHandle *out_handle )
Crea un handle
per richiamare il sottografo definito da callable_options
.
NOTA: questa API è ancora sperimentale e potrebbe cambiare.
ReleaseCallable
Status ReleaseCallable( CallableHandle handle )
Rilascia le risorse associate handle
specificato in questa sessione.
NOTA: questa API è ancora sperimentale e potrebbe cambiare.
Correre
Status Run( const std::vector< Output > & fetch_outputs, std::vector< Tensor > *outputs ) const
Valuta i tensori in fetch_outputs
.
I valori vengono restituiti come oggetti Tensor
negli outputs
. Il numero e l'ordine degli outputs
corrisponderanno fetch_outputs
.
Correre
Status Run( const FeedType & inputs, const std::vector< Output > & fetch_outputs, std::vector< Tensor > *outputs ) const
Come sopra, ma utilizza la mappatura negli inputs
come feed.
Correre
Status Run( const FeedType & inputs, const std::vector< Output > & fetch_outputs, const std::vector< Operation > & run_outputs, std::vector< Tensor > *outputs ) const
Come sopra. Inoltre esegue le operazioni in run_outputs
.
Correre
Status Run( const RunOptions & run_options, const FeedType & inputs, const std::vector< Output > & fetch_outputs, const std::vector< Operation > & run_outputs, std::vector< Tensor > *outputs, RunMetadata *run_metadata ) const
Utilizza run_options
per attivare la profilazione delle prestazioni.
run_metadata
, se non null, viene compilato con i risultati della profilazione.
Correre
Status Run( const RunOptions & run_options, const FeedType & inputs, const std::vector< Output > & fetch_outputs, const std::vector< Operation > & run_outputs, std::vector< Tensor > *outputs, RunMetadata *run_metadata, const thread::ThreadPoolOptions & threadpool_options ) const
Come sopra.
Consente inoltre all'utente di fornire un'implementazione personalizzata del pool di thread tramite ThreadPoolOptions.
RunCallable
Status RunCallable( CallableHandle handle, const std::vector< Tensor > & feed_tensors, std::vector< Tensor > *fetch_tensors, RunMetadata *run_metadata )
Richiama il sottografo denominato da handle
con le opzioni e i tensori di input specificati.
L'ordine dei tensori in feed_tensors
deve corrispondere all'ordine dei nomi in CallableOptions::feed()
e l'ordine dei tensori in fetch_tensors
corrisponderà all'ordine dei nomi in CallableOptions::fetch()
quando è stato creato questo sottografo. NOTA: questa API è ancora sperimentale e potrebbe cambiare.
RunCallable
Status RunCallable( CallableHandle handle, const std::vector< Tensor > & feed_tensors, std::vector< Tensor > *fetch_tensors, RunMetadata *run_metadata, const thread::ThreadPoolOptions & options )
Richiama il sottografo denominato da handle
con le opzioni e i tensori di input specificati.
L'ordine dei tensori in feed_tensors
deve corrispondere all'ordine dei nomi in CallableOptions::feed()
e l'ordine dei tensori in fetch_tensors
corrisponderà all'ordine dei nomi in CallableOptions::fetch()
quando è stato creato questo sottografo. NOTA: questa API è ancora sperimentale e potrebbe cambiare.
~Sessione cliente
~ClientSession()