Session

public final class Session

Driver for Graph execution.

A Session instance encapsulates the environment in which Operations in a Graph are executed to compute Tensors. For example:

// Let's say graph is an instance of the Graph class
 // for the computation y = 3 * x

 try (Session s = new Session(graph)) {
   try (Tensor x = Tensor.create(2.0f);
       Tensor y = s.runner().feed("x", x).fetch("y").run().get(0)) {
       System.out.println(y.floatValue());  // Will print 6.0f
   }
   try (Tensor x = Tensor.create(1.1f);
       Tensor y = s.runner().feed("x", x).fetch("y").run().get(0)) {
       System.out.println(y.floatValue());  // Will print 3.3f
   }
 }
 

WARNING:A Session owns resources that must be explicitly freed by invoking close().

Instances of a Session are thread-safe.

Nested Classes

class	Session.Run		Output tensors and metadata obtained when executing a session.
class	Session.Runner		Run Operations and evaluate Tensors.

Public Constructors

	Session(Graph g) Construct a new session with the associated Graph.
	Session(Graph g, byte[] config) Construct a new session with the associated Graph and configuration options.

Public Methods

void	close() Release resources associated with the Session.
Session.Runner	runner() Create a Runner to execute graph operations and evaluate Tensors.

Inherited Methods

From class java.lang.Object

boolean	equals(Object arg0)
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

From interface java.lang.AutoCloseable

abstract void

close()

Public Constructors

public Session (Graph g)

Construct a new session with the associated Graph.

Parameters

g

public Session (Graph g, byte[] config)

Construct a new session with the associated Graph and configuration options.

Parameters

g	The Graph the created Session will operate on.
config	Configuration parameters for the session specified as a serialized ConfigProto protocol buffer.

Throws

IllegalArgumentException	if the config is not a valid serialization of the ConfigProto protocol buffer.

Public Methods

public void close ()

Release resources associated with the Session.

Blocks until there are no active executions (run() calls). A Session is not usable after close returns.

public Session.Runner runner ()

Create a Runner to execute graph operations and evaluate Tensors.