OperationBuilder

public interface OperationBuilder

Known Indirect Subclasses GraphOperationBuilder GraphOperationBuilder An OperationBuilder for adding GraphOperations to a Graph.

A builder for Operations.

For example, the following uses the builder to create an operation that produces the constant "3" as its output:

// env is an ExecutionEnvironment, such as a Graph instance.
 try (Tensor c1 = Tensor.create(3.0f)) {
   env.opBuilder("Const", "MyConst")
       .setAttr("dtype", c1.dataType())
       .setAttr("value", c1)
       .build();
 
 }

Public Methods

abstract OperationBuilder	addControlInput(Operation control) Ensure that the operation does not execute before the control operation does.
abstract OperationBuilder	addInput(Output<?> input) Add the output of another operation as the next input of the operation being built.
abstract OperationBuilder	addInputList(Output[]<?> inputs) Add the outputs of another operation as the next inputs of the operation being built.
abstract Operation	build() Build the Operation.
abstract OperationBuilder	setAttr(String name, Tensor<?> value) Set the tensor value of an attribute of the operation being built.
abstract OperationBuilder	setAttr(String name, Tensor[]<?> value) Set the tensor values of an attribute of the operation being built.
abstract OperationBuilder	setAttr(String name, String[] value) Set the string values of an attribute of the operation being built.
abstract OperationBuilder	setAttr(String name, boolean[] value) Set the boolean values of an attribute of the operation being built.
abstract OperationBuilder	setAttr(String name, DataType[] value) Set the type values of an attribute of the operation being built.
abstract OperationBuilder	setAttr(String name, String value) Set the string value of an attribute of the operation being built.
abstract OperationBuilder	setAttr(String name, float[] value) Set the float values of an attribute of the operation being built.
abstract OperationBuilder	setAttr(String name, long value) Set the long value of an attribute of the operation being built.
abstract OperationBuilder	setAttr(String name, long[] value) Set the long values of an attribute of the operation being built.
abstract OperationBuilder	setAttr(String name, boolean value) Set the boolean value of an attribute of the operation being built.
abstract OperationBuilder	setAttr(String name, Shape[] value) Set the shape values of an attribute of the operation being built.
abstract OperationBuilder	setAttr(String name, float value) Set the float value of an attribute of the operation being built.
abstract OperationBuilder	setAttr(String name, DataType value) Set the type value of an attribute of the operation being built.
abstract OperationBuilder	setAttr(String name, byte[] value) Set the byte values of an attribute of the operation being built.
abstract OperationBuilder	setAttr(String name, Shape value) Set the shape value of an attribute of the operation being built.
abstract OperationBuilder	setDevice(String device) Set the device requested for computing the operation being built.

Public Methods

public abstract OperationBuilder addControlInput (Operation control)

Ensure that the operation does not execute before the control operation does.

A control input is an Operation that must be executed before running the operation currently being built.

For example, an Assert operation may be added as a control input for this operation. The Assert now behaves as a pre-condition that will always verify itself before running the operation.

Parameters

control	operation that must be executed before running this operation.

Returns

• the OperationBuilder instance for chaining.

public abstract OperationBuilder addInput (Output<?> input)

Add the output of another operation as the next input of the operation being built.

Parameters

input	Output supposed to be the input of the operation being built.

Returns

• the OperationBuilder instance for chaining.

public abstract OperationBuilder addInputList (Output[]<?> inputs)

Add the outputs of another operation as the next inputs of the operation being built.

Parameters

inputs	list of Output supposed to be the inputs of the operation being built.

Returns

• the OperationBuilder instance for chaining.

public abstract Operation build ()

Build the Operation.

The following action will also be performed depending on the current execution environment.

• In eager mode, the result of the operation will be computed immediately.
• In graph mode, the operation will be added as a node to the graph to be executed later, when running a Session.

The OperationBuilder is not usable after build() returns.

public abstract OperationBuilder setAttr (String name, Tensor<?> value)

Set the tensor value of an attribute of the operation being built.

Parameters

name	attribute name
value	attribute value

Returns

• the OperationBuilder instance for chaining.

public abstract OperationBuilder setAttr (String name, Tensor[]<?> value)

Set the tensor values of an attribute of the operation being built.

Parameters

name	attribute name
value	attribute values

Returns

• the OperationBuilder instance for chaining.

public abstract OperationBuilder setAttr (String name, String[] value)

Set the string values of an attribute of the operation being built.

Parameters

name	attribute name
value	attribute values

Returns

• the OperationBuilder instance for chaining.

public abstract OperationBuilder setAttr (String name, boolean[] value)

Set the boolean values of an attribute of the operation being built.

Parameters

name	attribute name
value	attribute values

Returns

• the OperationBuilder instance for chaining.

public abstract OperationBuilder setAttr (String name, DataType[] value)

Set the type values of an attribute of the operation being built.

Parameters

name	attribute name
value	attribute values

Returns

• the OperationBuilder instance for chaining.

public abstract OperationBuilder setAttr (String name, String value)

Set the string value of an attribute of the operation being built.

Parameters

name	attribute name
value	attribute value

Returns

• the OperationBuilder instance for chaining.

public abstract OperationBuilder setAttr (String name, float[] value)

Set the float values of an attribute of the operation being built.

Parameters

name	attribute name
value	attribute values

Returns

• the OperationBuilder instance for chaining.

public abstract OperationBuilder setAttr (String name, long value)

Set the long value of an attribute of the operation being built.

Parameters

name	attribute name
value	attribute value

Returns

• the OperationBuilder instance for chaining.

public abstract OperationBuilder setAttr (String name, long[] value)

Set the long values of an attribute of the operation being built.

Parameters

name	attribute name
value	attribute values

Returns

• the OperationBuilder instance for chaining.

public abstract OperationBuilder setAttr (String name, boolean value)

Set the boolean value of an attribute of the operation being built.

Parameters

name	attribute name
value	attribute value

Returns

• the OperationBuilder instance for chaining.

public abstract OperationBuilder setAttr (String name, Shape[] value)

Set the shape values of an attribute of the operation being built.

Parameters

name	attribute name
value	attribute values

Returns

• the OperationBuilder instance for chaining.

public abstract OperationBuilder setAttr (String name, float value)

Set the float value of an attribute of the operation being built.

Parameters

name	attribute name
value	attribute value

Returns

• the OperationBuilder instance for chaining.

public abstract OperationBuilder setAttr (String name, DataType value)

Set the type value of an attribute of the operation being built.

Parameters

name	attribute name
value	attribute value

Returns

• the OperationBuilder instance for chaining.

public abstract OperationBuilder setAttr (String name, byte[] value)

Set the byte values of an attribute of the operation being built.

Parameters

name	attribute name
value	attribute values

Returns

• the OperationBuilder instance for chaining.

public abstract OperationBuilder setAttr (String name, Shape value)

Set the shape value of an attribute of the operation being built.

Parameters

name	attribute name
value	attribute value

Returns

• the OperationBuilder instance for chaining.

public abstract OperationBuilder setDevice (String device)

Set the device requested for computing the operation being built.

Parameters

device	the requested device, as a string

Returns

• the OperationBuilder instance for chaining.