Trainer (Deep Java Library 0.3.0 API specification)

All Superinterfaces:

java.lang.AutoCloseable
```
public interface Trainer
extends java.lang.AutoCloseable
```
The Trainer interface provides a session for model training.
Trainer provides an easy, and manageable interface for training. Trainer is not thread-safe.
See the tutorials on:

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`void`	`close()`
`void`	`endEpoch()` Runs the end epoch actions.
`NDList`	`forward(NDList input)` Applies the forward function of the model once on the given input `NDList`.
`java.util.List<Device>`	`getDevices()` Returns the devices used for training.
`<T extends Evaluator> T`	`getEvaluator(java.lang.Class<T> clazz)` Gets the `Evaluator` that is an instance of the given `Class`.
`java.util.List<Evaluator>`	`getEvaluators()` Gets all `Evaluator`s.
`Loss`	`getLoss()` Gets the training `Loss` function of the trainer.
`NDManager`	`getManager()` Gets the `NDManager` from the model.
`Metrics`	`getMetrics()` Returns the Metrics param used for benchmarking.
`Model`	`getModel()` Returns the model used to create this trainer.
`void`	`initialize(Shape... shapes)` Initializes the `Model` that the `Trainer` is going to train.
`default java.lang.Iterable<Batch>`	`iterateDataset(Dataset dataset)` Fetches an iterator that can iterate through the given `Dataset`.
`GradientCollector`	`newGradientCollector()` Returns a new instance of `GradientCollector`.
`void`	`setMetrics(Metrics metrics)` Attaches a Metrics param to use for benchmarking.
`void`	`step()` Updates all of the parameters of the model once.
`void`	`trainBatch(Batch batch)` Trains the model with one iteration of the given `Batch` of data.
`void`	`validateBatch(Batch batch)` Validates the given batch of data.

- Method Detail
  - initialize
```
void initialize(Shape... shapes)
```
    Initializes the Model that the Trainer is going to train.
    
    Parameters:
    
    shapes - an array of Shape of the inputs
  - iterateDataset
```
default java.lang.Iterable<Batch> iterateDataset(Dataset dataset)
```
    Fetches an iterator that can iterate through the given Dataset.
    
    Parameters:
    
    dataset - the dataset to iterate through
    
    Returns:
    
    an Iterable of Batch that contains batches of data from the dataset
  - newGradientCollector
```
GradientCollector newGradientCollector()
```
    Returns a new instance of GradientCollector.
    
    Returns:
    
    a new instance of GradientCollector
  - trainBatch
```
void trainBatch(Batch batch)
```
    Trains the model with one iteration of the given Batch of data.
    
    Parameters:
    
    batch - a Batch that contains data, and its respective labels
    
    Throws:
    
    java.lang.IllegalArgumentException - if the batch engine does not match the trainer engine
  - forward
```
NDList forward(NDList input)
```
    Applies the forward function of the model once on the given input NDList.
    
    Parameters:
    
    input - the input NDList
    
    Returns:
    
    the output of the forward function
  - validateBatch
```
void validateBatch(Batch batch)
```
    Validates the given batch of data.
    During validation, the evaluators and losses are computed, but gradients aren't computed, and parameters aren't updated.
    
    Parameters:
    
    batch - a Batch of data
    
    Throws:
    
    java.lang.IllegalArgumentException - if the batch engine does not match the trainer engine
  - step
```
void step()
```
    Updates all of the parameters of the model once.
  - getMetrics
```
Metrics getMetrics()
```
    Returns the Metrics param used for benchmarking.
    
    Returns:
    
    the the Metrics param used for benchmarking
  - setMetrics
```
void setMetrics(Metrics metrics)
```
    Attaches a Metrics param to use for benchmarking.
    
    Parameters:
    
    metrics - the Metrics class
  - getDevices
```
java.util.List<Device> getDevices()
```
    Returns the devices used for training.
    
    Returns:
    
    the devices used for training
  - endEpoch
```
void endEpoch()
```
    Runs the end epoch actions.
  - getLoss
```
Loss getLoss()
```
    Gets the training Loss function of the trainer.
    
    Returns:
    
    the Loss function
  - getModel
```
Model getModel()
```
    Returns the model used to create this trainer.
    
    Returns:
    
    the model associated with this trainer
  - getEvaluators
```
java.util.List<Evaluator> getEvaluators()
```
    Gets all Evaluators.
    
    Returns:
    
    the evaluators used during training
  - getEvaluator
```
<T extends Evaluator> T getEvaluator(java.lang.Class<T> clazz)
```
    Gets the Evaluator that is an instance of the given Class.
    
    Type Parameters:
    
    T - the type of the training evaluator
    
    Parameters:
    
    clazz - the Class of the Evaluator sought
    
    Returns:
    
    the requested evaluator
  - getManager
```
NDManager getManager()
```
    Gets the NDManager from the model.
    
    Returns:
    
    the NDManager
  - close
```
void close()
```
    Specified by:
    
    close in interface java.lang.AutoCloseable

Interface Trainer

Method Summary

Method Detail

initialize

iterateDataset

newGradientCollector

trainBatch

forward

validateBatch

step

getMetrics

setMetrics

getDevices

endEpoch

getLoss

getModel

getEvaluators

getEvaluator

getManager

close