ai.djl.nn

Class ParallelBlock

java.lang.Object

ai.djl.nn.AbstractBlock

ai.djl.nn.ParallelBlock

All Implemented Interfaces:

Block

public class ParallelBlock
extends AbstractBlock

ParallelBlock is a Block whose children form a parallel branch in the network and are combined to produce a single output.

ParallelBlock has no direct parameters.

Field Summary

Fields inherited from class ai.djl.nn.AbstractBlock

inputNames, inputShapes

Constructor Summary

Constructors

Constructor and Description
ParallelBlock(java.util.function.Function<java.util.List<NDList>,NDList> function) Creates a parallel block whose branches are combined to form a single output by the given function.
ParallelBlock(java.util.function.Function<java.util.List<NDList>,NDList> function, java.util.List<Block> blocks) Creates a parallel block whose branches are formed by each block in the list of blocks, and are combined to form a single output by the given function.

Method Summary

Modifier and Type	Method and Description
ParallelBlock	add(Block block) Adds the given Block to the block, which is one parallel branch.
ParallelBlock	add(java.util.function.Function<NDList,NDList> f) Adds a LambdaBlock, that applies the given function, to the list of parallel branches.
ParallelBlock	addAll(Block... blocks) Adds an array of blocks, each of which is a parallel branch.
ParallelBlock	addAll(java.util.Collection<Block> blocks) Adds a Collection of blocks, each of which is a parallel branch.
NDList	forward(ParameterStore parameterStore, NDList inputs, boolean training, ai.djl.util.PairList<java.lang.String,java.lang.Object> params) Applies the operating function of the block once.
BlockList	getChildren() Returns a list of all the children of the block.
java.util.List<Parameter>	getDirectParameters() Returns a list of all the direct parameters of the block.
Shape[]	getOutputShapes(NDManager manager, Shape[] inputShapes) Returns the expected output shapes of the block for the specified input shapes.
Shape	getParameterShape(java.lang.String name, Shape[] inputShapes) Returns the shape of the specified direct parameter of this block given the shapes of the input to the block.
Shape[]	initialize(NDManager manager, DataType dataType, Shape... inputShapes) Initializes the parameters of the block.
void	loadParameters(NDManager manager, java.io.DataInputStream is) Loads the parameters from the given input stream.
void	saveParameters(java.io.DataOutputStream os) Writes the parameters of the block to the given outputStream.
java.lang.String	toString()

Methods inherited from class ai.djl.nn.AbstractBlock

beforeInitialize, cast, clear, describeInput, getParameters, isInitialized, readInputShapes, saveInputShapes, setInitializer, setInitializer

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface ai.djl.nn.Block

forward, validateLayout

Constructor Detail

ParallelBlock

public ParallelBlock(java.util.function.Function<java.util.List<NDList>,NDList> function)

Creates a parallel block whose branches are combined to form a single output by the given function.

Parameters:

function - the function to define how the parallel branches are combined to form a single output

ParallelBlock

public ParallelBlock(java.util.function.Function<java.util.List<NDList>,NDList> function,
                     java.util.List<Block> blocks)

Creates a parallel block whose branches are formed by each block in the list of blocks, and are combined to form a single output by the given function.

Parameters:

function - the function to define how the parallel branches are combined

blocks - the blocks that form each of the parallel branches

Method Detail

addAll

public final ParallelBlock addAll(Block... blocks)

Adds an array of blocks, each of which is a parallel branch.

Parameters:

blocks - the array of blocks to add

Returns:

this block

addAll

public final ParallelBlock addAll(java.util.Collection<Block> blocks)

Adds a Collection of blocks, each of which is a parallel branch.

Parameters:

blocks - the Collection of blocks to add

Returns:

this block

add

public final ParallelBlock add(Block block)

Adds the given Block to the block, which is one parallel branch.

Parameters:

block - the block to be added as a parallel branch

Returns:

this block

add

public final ParallelBlock add(java.util.function.Function<NDList,NDList> f)

Adds a LambdaBlock, that applies the given function, to the list of parallel branches.

Parameters:

f - the function that forms the LambdaBlock

Returns:

this block

forward

public NDList forward(ParameterStore parameterStore,
                      NDList inputs,
                      boolean training,
                      ai.djl.util.PairList<java.lang.String,java.lang.Object> params)

Applies the operating function of the block once. This method should be called only on blocks that are initialized.

Parameters:

parameterStore - the parameter store

inputs - the input NDList

training - true for a training forward pass

params - optional parameters

Returns:

the output of the forward pass

initialize

public Shape[] initialize(NDManager manager,
                          DataType dataType,
                          Shape... inputShapes)

Initializes the parameters of the block. This method must be called before calling `forward`.

Parameters:

manager - the NDManager to initialize the parameters

dataType - the datatype of the parameters

inputShapes - the shapes of the inputs to the block

Returns:

the shapes of the outputs of the block

getOutputShapes

public Shape[] getOutputShapes(NDManager manager,
                               Shape[] inputShapes)

Returns the expected output shapes of the block for the specified input shapes.

Parameters:

manager - an NDManager

inputShapes - the shapes of the inputs

Returns:

the expected output shapes of the block

getDirectParameters

public java.util.List<Parameter> getDirectParameters()

Returns a list of all the direct parameters of the block.

Returns:

the list of Parameter

getParameterShape

public Shape getParameterShape(java.lang.String name,
                               Shape[] inputShapes)

Returns the shape of the specified direct parameter of this block given the shapes of the input to the block.

Parameters:

name - the name of the parameter

inputShapes - the shapes of the input to the block

Returns:

the shape of the parameter specified

getChildren

public BlockList getChildren()

Returns a list of all the children of the block.

Returns:

the list of child blocks

saveParameters

public void saveParameters(java.io.DataOutputStream os)
                    throws java.io.IOException

Writes the parameters of the block to the given outputStream.

Parameters:

os - the outputstream to save the parameters to

Throws:

java.io.IOException - if an I/O error occurs

loadParameters

public void loadParameters(NDManager manager,
                           java.io.DataInputStream is)
                    throws java.io.IOException,
                           MalformedModelException

Loads the parameters from the given input stream.

Parameters:

manager - an NDManager to create the parameter arrays

is - the inputstream that stream the parameter values

Throws:

java.io.IOException - if an I/O error occurs

MalformedModelException - if the model file is corrupted or unsupported

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object