tensorflow Namespace Reference

Classes
class	NoThreadPool
class	TBBThreadPool

Typedefs
typedef std::pair< std::string, Tensor >	NamedTensor
typedef std::vector< NamedTensor >	NamedTensorList

Functions
bool	closeSession (Session *&session)
Session *	createSession (GraphDef *graphDef, int nThreads=1)
Session *	createSession (GraphDef *graphDef, SessionOptions &sessionOptions)
Session *	createSession (int nThreads=1)
Session *	createSession (MetaGraphDef *metaGraphDef, const std::string &exportDir, int nThreads=1)
Session *	createSession (MetaGraphDef *metaGraphDef, const std::string &exportDir, SessionOptions &sessionOptions)
Session *	createSession (SessionOptions &sessionOptions)
GraphDef *	loadGraphDef (const std::string &pbFile)
MetaGraphDef *	loadMetaGraph (const std::string &exportDir, const std::string &tag, SessionOptions &sessionOptions)
MetaGraphDef *	loadMetaGraph (const std::string &exportDir, const std::string &tag=kSavedModelTagServe, int nThreads=1)
MetaGraphDef *	loadMetaGraphDef (const std::string &exportDir, const std::string &tag, SessionOptions &sessionOptions)
MetaGraphDef *	loadMetaGraphDef (const std::string &exportDir, const std::string &tag=kSavedModelTagServe, int nThreads=1)
void	run (Session *session, const NamedTensorList &inputs, const std::vector< std::string > &outputNames, std::vector< Tensor > *outputs, const std::string &threadPoolName="no_threads")
void	run (Session *session, const NamedTensorList &inputs, const std::vector< std::string > &outputNames, std::vector< Tensor > *outputs, const thread::ThreadPoolOptions &threadPoolOptions)
void	run (Session *session, const NamedTensorList &inputs, const std::vector< std::string > &outputNames, std::vector< Tensor > *outputs, thread::ThreadPoolInterface *threadPool)
void	run (Session *session, const std::vector< std::string > &outputNames, std::vector< Tensor > *outputs, const std::string &threadPoolName="no_threads")
void	setLogging (const std::string &level="3")
void	setThreading (SessionOptions &sessionOptions, int nThreads, const std::string &singleThreadPool)
void	setThreading (SessionOptions &sessionOptions, int nThreads=1)

Typedef Documentation

NamedTensor

typedef std::pair<std::string, Tensor> tensorflow::NamedTensor

Definition at line 29 of file TensorFlow.h.

NamedTensorList

typedef std::vector<NamedTensor> tensorflow::NamedTensorList

Definition at line 30 of file TensorFlow.h.

Function Documentation

closeSession()

bool tensorflow::closeSession

(

Session *&

session

)

Definition at line 196 of file TensorFlow.cc.

                                       {
    if (session == nullptr) {
      return true;
    }
 
    // close and delete the session
    Status status = session->Close();
    delete session;
 
    // reset the pointer
    session = nullptr;
 
    return status.ok();
  }

References btagGenBb_cfi::Status, and mps_update::status.

Referenced by DTOccupancyTestML::dqmEndLuminosityBlock(), deep_tau::DeepTauCache::~DeepTauCache(), and DeepVertexTFJetTagsProducer::~DeepVertexTFJetTagsProducer().

createSession() [1/6]

Session * tensorflow::createSession	(	GraphDef *	graphDef,
		int	nThreads = 1
	)

Definition at line 188 of file TensorFlow.cc.

                                                           {
    // create session options and set thread options
    SessionOptions sessionOptions;
    setThreading(sessionOptions, nThreads);
 
    return createSession(graphDef, sessionOptions);
  }

References createSession(), runTheMatrix::nThreads, and setThreading().

createSession() [2/6]

Session * tensorflow::createSession	(	GraphDef *	graphDef,
		SessionOptions &	sessionOptions
	)

Definition at line 162 of file TensorFlow.cc.

                                                                             {
    // check for valid pointer
    if (graphDef == nullptr) {
      throw cms::Exception("InvalidGraphDef") << "error while creating session: graphDef is nullptr";
    }
 
    // check that the graph has nodes
    if (graphDef->node_size() <= 0) {
      throw cms::Exception("InvalidGraphDef") << "error while creating session: graphDef has no nodes";
    }
 
    // create a new, empty session
    Session* session = createSession(sessionOptions);
 
    // add the graph def
    Status status;
    status = session->Create(*graphDef);
 
    // check for success
    if (!status.ok()) {
      throw cms::Exception("InvalidSession") << "error while attaching graphDef to session: " << status.ToString();
    }
 
    return session;
  }

References createSession(), Exception, btagGenBb_cfi::Status, and mps_update::status.

createSession() [3/6]

Session * tensorflow::createSession

(

int

nThreads = 1

)

Definition at line 99 of file TensorFlow.cc.

                                       {
    // create session options and set thread options
    SessionOptions sessionOptions;
    setThreading(sessionOptions, nThreads);
 
    return createSession(sessionOptions);
  }

References createSession(), runTheMatrix::nThreads, and setThreading().

createSession() [4/6]

Session * tensorflow::createSession	(	MetaGraphDef *	metaGraphDef,
		const std::string &	exportDir,
		int	nThreads = 1
	)

Definition at line 154 of file TensorFlow.cc.

                                                                                               {
    // create session options and set thread options
    SessionOptions sessionOptions;
    setThreading(sessionOptions, nThreads);
 
    return createSession(metaGraphDef, exportDir, sessionOptions);
  }

References createSession(), runTheMatrix::nThreads, and setThreading().

createSession() [5/6]

Session * tensorflow::createSession	(	MetaGraphDef *	metaGraphDef,
		const std::string &	exportDir,
		SessionOptions &	sessionOptions
	)

Definition at line 107 of file TensorFlow.cc.

                                                                                                                 {
    // check for valid pointer
    if (metaGraphDef == nullptr) {
      throw cms::Exception("InvalidMetaGraphDef") << "error while creating session: metaGraphDef is nullptr";
    }
 
    // check that the graph has nodes
    if (metaGraphDef->graph_def().node_size() <= 0) {
      throw cms::Exception("InvalidMetaGraphDef") << "error while creating session: graphDef has no nodes";
    }
 
    Session* session = createSession(sessionOptions);
 
    // add the graph def from the meta graph
    Status status;
    status = session->Create(metaGraphDef->graph_def());
    if (!status.ok()) {
      throw cms::Exception("InvalidMetaGraphDef")
          << "error while attaching metaGraphDef to session: " << status.ToString();
    }
 
    // restore variables using the variable and index files in the export directory
    // first, find names and paths
    std::string varFileTensorName = metaGraphDef->saver_def().filename_tensor_name();
    std::string restoreOpName = metaGraphDef->saver_def().restore_op_name();
    std::string varDir = io::JoinPath(exportDir, kSavedModelVariablesDirectory);
    std::string indexFile = io::JoinPath(varDir, MetaFilename(kSavedModelVariablesFilename));
    std::string varFile = io::JoinPath(varDir, kSavedModelVariablesFilename);
 
    // when the index file is missing, there's nothing to do
    if (!Env::Default()->FileExists(indexFile).ok()) {
      return session;
    }
 
    // create a tensor to store the variable file
    Tensor varFileTensor(DT_STRING, TensorShape({}));
    varFileTensor.scalar<std::string>()() = varFile;
 
    // run the restore op
    status = session->Run({{varFileTensorName, varFileTensor}}, {}, {restoreOpName}, nullptr);
    if (!status.ok()) {
      throw cms::Exception("InvalidSession") << "error while restoring variables in session: " << status.ToString();
    }
 
    return session;
  }

References createSession(), Default, Exception, convertSQLiteXML::ok, btagGenBb_cfi::Status, mps_update::status, and AlCaHLTBitMon_QueryRunRegistry::string.

createSession() [6/6]

Session * tensorflow::createSession

(

SessionOptions &

sessionOptions

)

Definition at line 85 of file TensorFlow.cc.

                                                         {
    // objects to create the session
    Status status;
 
    // create a new, empty session
    Session* session = nullptr;
    status = NewSession(sessionOptions, &session);
    if (!status.ok()) {
      throw cms::Exception("InvalidSession") << "error while creating session: " << status.ToString();
    }
 
    return session;
  }

References Exception, btagGenBb_cfi::Status, and mps_update::status.

Referenced by BaseMVAValueMapProducer< pat::Jet >::BaseMVAValueMapProducer(), createSession(), deep_tau::DeepTauCache::DeepTauCache(), DeepVertexTFJetTagsProducer::DeepVertexTFJetTagsProducer(), DTOccupancyTestML::dqmEndLuminosityBlock(), ticl::PatternRecognitionbyCA::PatternRecognitionbyCA(), and TrackstersMergeProducer::TrackstersMergeProducer().

loadGraphDef()

GraphDef * tensorflow::loadGraphDef

(

const std::string &

pbFile

)

Definition at line 68 of file TensorFlow.cc.

                                                  {
    // objects to load the graph
    Status status;
 
    // load it
    GraphDef* graphDef = new GraphDef();
    status = ReadBinaryProto(Env::Default(), pbFile, graphDef);
 
    // check for success
    if (!status.ok()) {
      throw cms::Exception("InvalidGraphDef")
          << "error while loading graphDef from '" << pbFile << "': " << status.ToString();
    }
 
    return graphDef;
  }

References Default, Exception, btagGenBb_cfi::Status, and mps_update::status.

Referenced by BaseMVAValueMapProducer< pat::Jet >::BaseMVAValueMapProducer(), deep_tau::DeepTauCache::DeepTauCache(), DTOccupancyTestML::dqmEndLuminosityBlock(), DeepMETProducer::initializeGlobalCache(), TrackstersMergeProducer::initializeGlobalCache(), TrackstersProducer::initializeGlobalCache(), and DeepVertexTFJetTagsProducer::initializeGlobalCache().

loadMetaGraph() [1/2]

MetaGraphDef * tensorflow::loadMetaGraph	(	const std::string &	exportDir,
		const std::string &	tag,
		SessionOptions &	sessionOptions
	)

Definition at line 46 of file TensorFlow.cc.

                                                                                                                {
    edm::LogInfo("PhysicsTools/TensorFlow")
        << "tensorflow::loadMetaGraph() is deprecated, use tensorflow::loadMetaGraphDef() instead";
 
    return loadMetaGraphDef(exportDir, tag, sessionOptions);
  }

References loadMetaGraphDef(), and GlobalPosition_Frontier_DevDB_cff::tag.

loadMetaGraph() [2/2]

MetaGraphDef * tensorflow::loadMetaGraph	(	const std::string &	exportDir,
		const std::string &	tag = kSavedModelTagServe,
		int	nThreads = 1
	)

Definition at line 61 of file TensorFlow.cc.

                                                                                              {
    edm::LogInfo("PhysicsTools/TensorFlow")
        << "tensorflow::loadMetaGraph() is deprecated, use tensorflow::loadMetaGraphDef() instead";
 
    return loadMetaGraphDef(exportDir, tag, nThreads);
  }

References loadMetaGraphDef(), runTheMatrix::nThreads, and GlobalPosition_Frontier_DevDB_cff::tag.

loadMetaGraphDef() [1/2]

MetaGraphDef * tensorflow::loadMetaGraphDef	(	const std::string &	exportDir,
		const std::string &	tag,
		SessionOptions &	sessionOptions
	)

Definition at line 29 of file TensorFlow.cc.

                                                                                                                   {
    // objects to load the graph
    Status status;
    RunOptions runOptions;
    SavedModelBundle bundle;
 
    // load the model
    status = LoadSavedModel(sessionOptions, runOptions, exportDir, {tag}, &bundle);
    if (!status.ok()) {
      throw cms::Exception("InvalidMetaGraphDef")
          << "error while loading metaGraphDef from '" << exportDir << "': " << status.ToString();
    }
 
    // return a copy of the graph
    return new MetaGraphDef(bundle.meta_graph_def);
  }

References Exception, btagGenBb_cfi::Status, mps_update::status, and GlobalPosition_Frontier_DevDB_cff::tag.

Referenced by loadMetaGraph(), and loadMetaGraphDef().

loadMetaGraphDef() [2/2]

MetaGraphDef * tensorflow::loadMetaGraphDef	(	const std::string &	exportDir,
		const std::string &	tag = kSavedModelTagServe,
		int	nThreads = 1
	)

Definition at line 53 of file TensorFlow.cc.

                                                                                                 {
    // create session options and set thread options
    SessionOptions sessionOptions;
    setThreading(sessionOptions, nThreads);
 
    return loadMetaGraphDef(exportDir, tag, sessionOptions);
  }

References loadMetaGraphDef(), runTheMatrix::nThreads, setThreading(), and GlobalPosition_Frontier_DevDB_cff::tag.

run() [1/4]

void tensorflow::run	(	Session *	session,
		const NamedTensorList &	inputs,
		const std::vector< std::string > &	outputNames,
		std::vector< Tensor > *	outputs,
		const std::string &	threadPoolName = "no_threads"
	)

Definition at line 244 of file TensorFlow.cc.

                                            {
    // lookup the thread pool and forward the call accordingly
    if (threadPoolName == "no_threads") {
      run(session, inputs, outputNames, outputs, &NoThreadPool::instance());
    } else if (threadPoolName == "tbb") {
      // the TBBTreadPool singleton should be already initialized before with a number of threads
      run(session, inputs, outputNames, outputs, &TBBThreadPool::instance());
    } else if (threadPoolName == "tensorflow") {
      run(session, inputs, outputNames, outputs, nullptr);
    } else {
      throw cms::Exception("UnknownThreadPool")
          << "thread pool implementation'" << threadPoolName << "' unknown, use 'no_threads', 'tbb', or 'tensorflow'";
    }
  }

References Exception, PixelMapPlotter::inputs, tensorflow::NoThreadPool::instance(), tensorflow::TBBThreadPool::instance(), jets_cff::outputNames, PatBasicFWLiteJetAnalyzer_Selector_cfg::outputs, and run().

run() [2/4]

void tensorflow::run	(	Session *	session,
		const NamedTensorList &	inputs,
		const std::vector< std::string > &	outputNames,
		std::vector< Tensor > *	outputs,
		const thread::ThreadPoolOptions &	threadPoolOptions
	)

Definition at line 211 of file TensorFlow.cc.

                                                             {
    if (session == nullptr) {
      throw cms::Exception("InvalidSession") << "cannot run empty session";
    }
 
    // create empty run options
    RunOptions runOptions;
 
    // run and check the status
    Status status = session->Run(runOptions, inputs, outputNames, {}, outputs, nullptr, threadPoolOptions);
    if (!status.ok()) {
      throw cms::Exception("InvalidRun") << "error while running session: " << status.ToString();
    }
  }

References Exception, PixelMapPlotter::inputs, jets_cff::outputNames, PatBasicFWLiteJetAnalyzer_Selector_cfg::outputs, btagGenBb_cfi::Status, and mps_update::status.

Referenced by ticl::PatternRecognitionbyCA::energyRegressionAndID(), TrackstersMergeProducer::energyRegressionAndID(), DeepTauId::getPartialPredictions(), DPFIsolation::getPredictions(), DeepTauId::getPredictionsV1(), DeepTauId::getPredictionsV2(), DeepMETProducer::produce(), DeepVertexTFJetTagsProducer::produce(), BaseMVAValueMapProducer< pat::Jet >::produce(), run(), and DTOccupancyTestML::runOccupancyTest().

run() [3/4]

void tensorflow::run	(	Session *	session,
		const NamedTensorList &	inputs,
		const std::vector< std::string > &	outputNames,
		std::vector< Tensor > *	outputs,
		thread::ThreadPoolInterface *	threadPool
	)

Definition at line 230 of file TensorFlow.cc.

                                                  {
    // create thread pool options
    thread::ThreadPoolOptions threadPoolOptions;
    threadPoolOptions.inter_op_threadpool = threadPool;
    threadPoolOptions.intra_op_threadpool = threadPool;
 
    // run
    run(session, inputs, outputNames, outputs, threadPoolOptions);
  }

References PixelMapPlotter::inputs, jets_cff::outputNames, PatBasicFWLiteJetAnalyzer_Selector_cfg::outputs, and run().

run() [4/4]

void tensorflow::run	(	Session *	session,
		const std::vector< std::string > &	outputNames,
		std::vector< Tensor > *	outputs,
		const std::string &	threadPoolName = "no_threads"
	)

Definition at line 263 of file TensorFlow.cc.

                                            {
    run(session, {}, outputNames, outputs, threadPoolName);
  }

References jets_cff::outputNames, PatBasicFWLiteJetAnalyzer_Selector_cfg::outputs, and run().

setLogging()

void tensorflow::setLogging

(

const std::string &

level = "3"

)

Definition at line 15 of file TensorFlow.cc.

{ setenv("TF_CPP_MIN_LOG_LEVEL", level.c_str(), 0); }

References personalPlayback::level.

Referenced by BaseMVAValueMapProducer< pat::Jet >::BaseMVAValueMapProducer(), DTOccupancyTestML::dqmEndLuminosityBlock(), and DeepVertexTFJetTagsProducer::initializeGlobalCache().

setThreading() [1/2]

void tensorflow::setThreading	(	SessionOptions &	sessionOptions,
		int	nThreads,
		const std::string &	singleThreadPool
	)

Definition at line 23 of file TensorFlow.cc.

                                                                                                     {
    edm::LogInfo("PhysicsTools/TensorFlow") << "setting the thread pool via tensorflow::setThreading() is deprecated";
 
    setThreading(sessionOptions, nThreads);
  }

References runTheMatrix::nThreads, and setThreading().

setThreading() [2/2]

void tensorflow::setThreading	(	SessionOptions &	sessionOptions,
		int	nThreads = 1
	)

Definition at line 17 of file TensorFlow.cc.

                                                                  {
    // set number of threads used for intra and inter operation communication
    sessionOptions.config.set_intra_op_parallelism_threads(nThreads);
    sessionOptions.config.set_inter_op_parallelism_threads(nThreads);
  }

References runTheMatrix::nThreads.

Referenced by createSession(), deep_tau::DeepTauCache::DeepTauCache(), loadMetaGraphDef(), and setThreading().