Understand Trainer

Role of Trainer

Tensorpack follows the "define-and-run" paradigm. A training has two steps:

  1. Define: Build graph for the model. Users can call whatever tensorflow functions to setup the graph. Users may or may not use tensorpack InputSource, ModelDesc or other utilities to build the graph. The goal of this step is to define "what to run" in later training steps, and it can happen either inside or outside tensorpack trainer.

  2. Run: Train the model (the Trainer.train() method):

    1. Setup callbacks/monitors.

    2. Finalize graph, initialize session.

    3. Run the training loop.

Assumptions of Base Trainer

  • Q: What types of training can you do with tensorpack?

  • A: Anything that runs in a loop.

In research we do training of various kind. Tensorpack trainers avoid making assumptions on what type of training you want to do (e.g., it doesn't have to be batched, SGD-like, or have X(inputs) and y(outputs)). The only assumption is that your training follows this pattern:

for epoch_num in range(starting_epoch, max_epoch):
    for local_step in range(steps_per_epoch):
  1. Training is running some iterations. Tensorpack base trainer implements the logic of running the iteration. Users or derived trainers should implement what the iteration is.

  2. Trainer assumes the existence of "epoch", i.e. that the iterations run in double for-loops. But steps_per_epoch can be any number you set and it only affects the schedule of callbacks. In other words, an "epoch" in tensorpack is the default period to run callbacks (validation, summary, checkpoint, etc.).

How Existing (Single-Cost) Trainers Work

Most neural network training tasks are single-cost optimization. Tensorpack provides some trainer implementations for such tasks. These trainers will take care of step 1 (define the graph), with the following arguments:

  1. Some InputDesc, the metadata about the input.

  2. An InputSource, where the input come from. See Input Pipeline.

  3. A function which takes input tensors and returns the cost.

  4. A function which returns an optimizer.

These are documented in SingleCostTrainer.setup_graph. In practice you'll not use this method directly, but use high-level interface instead.

Write a Trainer

The existing trainers should be enough for single-tower single-cost optimization tasks. If you just want to do some extra work during training, first consider writing it as a callback, or write an issue to see if there is a better solution than creating new trainers. If your task is fundamentally different from single-cost optimization, you will need to write a trainer.

You can do customize training by either using or inheriting the base Trainer class. You will need to define two things for a new Trainer:

  1. Define the graph. Add any tensors and ops you like, either before creating the trainer or inside Trainer.__init__.

  2. What is the iteration. There are 2 ways to define the iteration:

    1. Set Trainer.train_op. This op will be run by default.

    2. Subclass Trainer and override the run_step() method. This way you can do something more than running an op.

There are several different GAN trainers for reference.