Moose::LibtorchArtificialNeuralNetTrainer< SamplerType > Class Template Reference

Templated class which is responsible for training LibtorchArtificialNeuralNets. More...

#include <LibtorchArtificialNeuralNetTrainer.h>

Inheritance diagram for Moose::LibtorchArtificialNeuralNetTrainer< SamplerType >:

Public Member Functions
	LibtorchArtificialNeuralNetTrainer (LibtorchArtificialNeuralNet &nn, const Parallel::Communicator &comm)
	Construct using the neural network and a parallel communicator.
virtual void	train (LibtorchDataset &dataset, const LibtorchTrainingOptions &options)
	Train the neural network using a given (serialized) data and options for the training process.
const Parallel::Communicator &	comm () const
processor_id_type	n_processors () const
processor_id_type	processor_id () const

Static Public Member Functions
static unsigned int	computeBatchSize (const unsigned int num_samples, const unsigned int num_batches)
	Computes the number of samples used for each batch.
static unsigned int	computeLocalBatchSize (const unsigned int batch_size, const unsigned int num_ranks)
	Computes the number of local samples.
static std::unique_ptr< torch::optim::Optimizer >	createOptimizer (const LibtorchArtificialNeuralNet &nn, const LibtorchTrainingOptions &options)
	Setup the optimizer based on the provided options.

Protected Attributes
LibtorchArtificialNeuralNet &	_nn
	Reference to the neural network which is trained.
const Parallel::Communicator &	_communicator

Detailed Description

template<typename SamplerType = torch::data::samplers::DistributedSequentialSampler>
class Moose::LibtorchArtificialNeuralNetTrainer< SamplerType >

Templated class which is responsible for training LibtorchArtificialNeuralNets.

The specialty of this class is that it can be used with random/sequential samplers in serial or parallel. The default sampling approach is sequential.

Definition at line 60 of file LibtorchArtificialNeuralNetTrainer.h.

Constructor & Destructor Documentation

LibtorchArtificialNeuralNetTrainer()

template<typename SamplerType >

Moose::LibtorchArtificialNeuralNetTrainer< SamplerType >::LibtorchArtificialNeuralNetTrainer	(	LibtorchArtificialNeuralNet &	nn,
		const Parallel::Communicator &	comm
	)

Construct using the neural network and a parallel communicator.

Parameters

nn	The neural network which needs to be trained
comm	Reference to the parallel communicator

Definition at line 18 of file LibtorchArtificialNeuralNetTrainer.C.

  : libMesh::ParallelObject(comm), _nn(nn)
{
}

Member Function Documentation

computeBatchSize()

template<typename SamplerType >

unsigned int Moose::LibtorchArtificialNeuralNetTrainer< SamplerType >::computeBatchSize ( const unsigned int  num_samples, const unsigned int  num_batches  )

static

Computes the number of samples used for each batch.

Parameters

num_samples	The total number of samples used for the training
num_batches	The total number of batches we want to select. This is just a target number, based on load-balancing considerations, the code can deviate from this by 1

Returns

The number of samples in the batches

Definition at line 26 of file LibtorchArtificialNeuralNetTrainer.C.

{
  // If we have more requested batches than the number of samples, we automatically decrease
  // the number of batches and put one sample in each
  if (num_samples < num_batches)
    return 1;
  // If the samples can be divided between the batches equally, we do that
  else if (num_samples % num_batches == 0)
    return num_samples / num_batches;
  // In all other cases, we compute the batch sizes with the specified number of batches
  // and we check if we could divide the data more evenly if we put one less sample in each
  // batch and potentially create a new batch.
  else
  {
    const unsigned int sample_per_batch_1 = num_samples / num_batches;
    const unsigned int remainder_1 = num_samples % num_batches;
    const unsigned int sample_per_batch_2 = sample_per_batch_1 - 1;
    const unsigned int remainder_2 =
        num_samples - (num_samples / sample_per_batch_2) * sample_per_batch_2;
 
    const Real rel_remainder1 = Real(remainder_1) / Real(sample_per_batch_1);
    const Real rel_remainder2 = Real(remainder_2) / Real(sample_per_batch_2);
 
    return rel_remainder2 > rel_remainder1 ? sample_per_batch_2 : sample_per_batch_1;
  }
}

computeLocalBatchSize()

template<typename SamplerType >

unsigned int Moose::LibtorchArtificialNeuralNetTrainer< SamplerType >::computeLocalBatchSize ( const unsigned int  batch_size, const unsigned int  num_ranks  )

static

Computes the number of local samples.

This practically splits the already computed batches between MPI ranks. At the moment, this is a very simple logic but will change in the future when custom dataloaders are added.

Parameters

batch_size	The batch size which needs to be split
num_ranks	The number of ranks associated with this batch

Returns

The number of samples in a batch which will be used locally to train the neural nets

Definition at line 56 of file LibtorchArtificialNeuralNetTrainer.C.

{
  // If we have more processors than the number of samples in this batch, we error out. We
  // do not support idle processors at the moment (at least not this way).
  if (batch_size < num_ranks)
    mooseError("The number of used processors is greater than the number of samples in the batch!");
  else if (batch_size % num_ranks == 0)
    return batch_size / num_ranks;
  else
    return batch_size / num_ranks + 1;
}

createOptimizer()

template<typename SamplerType >

std::unique_ptr< torch::optim::Optimizer > Moose::LibtorchArtificialNeuralNetTrainer< SamplerType >::createOptimizer ( const LibtorchArtificialNeuralNet &  nn, const LibtorchTrainingOptions &  options  )

static

Setup the optimizer based on the provided options.

Parameters

nn	The neural network whose parameters need to be optimized
options	The options for the training process

Definition at line 71 of file LibtorchArtificialNeuralNetTrainer.C.

{
  std::unique_ptr<torch::optim::Optimizer> optimizer;
  switch (options.optimizer_type)
  {
    case 0:
      optimizer = std::make_unique<torch::optim::Adam>(
          nn.parameters(), torch::optim::AdamOptions(options.learning_rate));
      break;
    case 1:
      optimizer = std::make_unique<torch::optim::Adagrad>(nn.parameters(), options.learning_rate);
      break;
    case 2:
      optimizer = std::make_unique<torch::optim::RMSprop>(nn.parameters(), options.learning_rate);
      break;
    case 3:
      optimizer = std::make_unique<torch::optim::SGD>(nn.parameters(), options.learning_rate);
      break;
  }
  return optimizer;
}

train()

template<typename SamplerType >

void Moose::LibtorchArtificialNeuralNetTrainer< SamplerType >::train ( LibtorchDataset &  dataset, const LibtorchTrainingOptions &  options  )

virtual

Train the neural network using a given (serialized) data and options for the training process.

Parameters

dataset	The dataset containing the known input-output pairs for the training
options	Options for the optimizer/training process

Definition at line 96 of file LibtorchArtificialNeuralNetTrainer.C.

{
  // This is used to measure the training time. Would not like to inherit from
  // PerfGraphInterface. Other objects can time this process from the outside.
  const auto t_begin = MPI_Wtime();
 
  /*
   * It might happen that we limit the number of processors that can be used for the training
   * through the options argument. In this case every additional rank beyond the maximum will behave
   * as rank 0. This is necessary to avoid cases when the (number of MPI processes)*(num_batches)
   * exceeds the number of samples.
   */
  int num_ranks = std::min(n_processors(), options.parallel_processes);
  // The real rank of the current process
  int real_rank = processor_id();
  // The capped rank (or used rank) of the current process.
  int used_rank = real_rank < num_ranks ? real_rank : 0;
 
  const auto num_samples = dataset.size().value();
 
  if (num_ranks * options.num_batches > num_samples)
    mooseError("The number of used processors* number of requestedf batches " +
               std::to_string(num_ranks * options.num_batches) +
               " is greater than the number of samples used for the training!");
 
  // Compute the number of samples in each batch
  const unsigned int sample_per_batch = computeBatchSize(num_samples, options.num_batches);
 
  // Compute the number of samples for this process
  const unsigned int sample_per_proc = computeLocalBatchSize(sample_per_batch, num_ranks);
 
  // Transform the dataset se that the loader has an easier time
  auto transformed_data_set = dataset.map(torch::data::transforms::Stack<>());
 
  // Create a sampler, this is mainly here to enable random sampling. The default is sequential
  SamplerType sampler(num_samples, num_ranks, used_rank, options.allow_duplicates);
 
  // Generate a dataloader which will build our batches for training
  auto data_loader =
      torch::data::make_data_loader(std::move(transformed_data_set), sampler, sample_per_proc);
 
  // Setup the optimizer
  std::unique_ptr<torch::optim::Optimizer> optimizer = createOptimizer(_nn, options);
 
  Real rel_loss = 1.0;
  Real initial_loss = 1.0;
  Real epoch_loss = 0.0;
 
  // Begin training loop
  unsigned int epoch = 1;
  while (epoch <= options.num_epochs && rel_loss > options.rel_loss_tol)
  {
    epoch_loss = 0.0;
 
    for (auto & batch : *data_loader)
    {
      // Reset gradients
      optimizer->zero_grad();
 
      // Compute prediction
      torch::Tensor prediction = _nn.forward(batch.data);
 
      // Compute loss values using a MSE ( mean squared error)
      torch::Tensor loss = torch::mse_loss(prediction, batch.target);
 
      // Propagate error back
      loss.backward();
 
      // If we are on a process whose rank is below the allowed limit, we actually collect the loss
      if (real_rank == used_rank)
        epoch_loss += loss.item<double>();
 
      // To enable the parallel training, we compute the gradients of the neural net parameters
      // using backpropagation at each process and then average the gradients across processes.
      // For this we sum the data on every processor and then divide it by the active processor
      // numbers. Note: We need to zero out the gradients for inactive processors (which are beyond
      // the predefined limit)
      for (auto & param : _nn.named_parameters())
      {
        if (real_rank != used_rank)
          param.value().grad().data() = param.value().grad().data() * 0.0;
 
        MPI_Allreduce(MPI_IN_PLACE,
                      param.value().grad().data_ptr(),
                      param.value().grad().numel(),
                      MPI_DOUBLE,
                      MPI_SUM,
                      _communicator.get());
 
        param.value().grad().data() = param.value().grad().data() / num_ranks;
      }
 
      // Use new gradients to update the parameters
      optimizer->step();
    }
 
    // We also reduce the loss value to make sure every process runs the same number of epochs and
    // does not exit the loop due to hitting the realtive error condition
    _communicator.sum(epoch_loss);
 
    epoch_loss = epoch_loss / options.num_batches / num_ranks;
 
    if (epoch == 1)
      initial_loss = epoch_loss;
 
    rel_loss = epoch_loss / initial_loss;
 
    // Print training information if requested
    if (options.print_loss)
      if (epoch % options.print_epoch_loss == 0 || epoch == 1)
        Moose::out << "Epoch: " << epoch << " | Loss: " << COLOR_GREEN << epoch_loss
                   << COLOR_DEFAULT << " | Rel. loss: " << COLOR_GREEN << rel_loss << COLOR_DEFAULT
                   << std::endl;
 
    epoch += 1;
  }
  // This is used to measure the training time. Would not like to inherit from
  // PerfGraphInterface. Other objects can time this process from the outside.
  auto t_end = MPI_Wtime();
 
  if (options.print_loss && used_rank == 0)
    Moose::out << "Neural net training time: " << COLOR_GREEN << (t_end - t_begin) << COLOR_DEFAULT
               << " s" << std::endl;
}

Member Data Documentation

_nn

template<typename SamplerType = torch::data::samplers::DistributedSequentialSampler>

LibtorchArtificialNeuralNet& Moose::LibtorchArtificialNeuralNetTrainer< SamplerType >::_nn

protected

Reference to the neural network which is trained.

Definition at line 108 of file LibtorchArtificialNeuralNetTrainer.h.

---

The documentation for this class was generated from the following files:

• include/libtorch/utils/LibtorchArtificialNeuralNetTrainer.h
• src/libtorch/utils/LibtorchArtificialNeuralNetTrainer.C