tuning_playbook README

The project's README from github.com/google-research/tuning_playbook. As one markdown file: README.md.

Deep Learning Tuning Playbook

This is not an officially supported Google product.

Varun Godbole†, George E. Dahl†, Justin Gilmer†, Christopher J. Shallue‡, Zachary Nado†

† Google Research, Brain Team

‡ Harvard University

Table of Contents

Who is this document for?

This document is for engineers and researchers (both individuals and teams) interested in maximizing the performance of deep learning models. We assume basic knowledge of machine learning and deep learning concepts.

Our emphasis is on the process of hyperparameter tuning. We touch on other aspects of deep learning training, such as pipeline implementation and optimization, but our treatment of those aspects is not intended to be complete.

We assume the machine learning problem is a supervised learning problem or something that looks a lot like one (e.g. self-supervised). That said, some of the prescriptions in this document may also apply to other types of problems.

Why a tuning playbook?

Currently, there is an astonishing amount of toil and guesswork involved in actually getting deep neural networks to work well in practice. Even worse, the actual recipes people use to get good results with deep learning are rarely documented. Papers gloss over the process that led to their final results in order to present a cleaner story, and machine learning engineers working on commercial problems rarely have time to take a step back and generalize their process. Textbooks tend to eschew practical guidance and prioritize fundamental principles, even if their authors have the necessary experience in applied work to provide useful advice. When preparing to create this document, we couldn't find any comprehensive attempt to actually explain how to get good results with deep learning. Instead, we found snippets of advice in blog posts and on social media, tricks peeking out of the appendix of research papers, occasional case studies about one particular project or pipeline, and a lot of confusion. There is a vast gulf between the results achieved by deep learning experts and less skilled practitioners using superficially similar methods. At the same time, these very experts readily admit some of what they do might not be well-justified. As deep learning matures and has a larger impact on the world, the community needs more resources covering useful recipes, including all the practical details that can be so critical for obtaining good results.

We are a team of five researchers and engineers who have worked in deep learning for many years, some of us since as early as 2006. We have applied deep learning to problems in everything from speech recognition to astronomy, and learned a lot along the way. This document grew out of our own experience training neural networks, teaching new machine learning engineers, and advising our colleagues on the practice of deep learning. Although it has been gratifying to see deep learning go from a machine learning approach practiced by a handful of academic labs to a technology powering products used by billions of people, deep learning is still in its infancy as an engineering discipline and we hope this document encourages others to help systematize the field's experimental protocols.

This document came about as we tried to crystalize our own approach to deep learning and thus it represents the opinions of the authors at the time of writing, not any sort of objective truth. Our own struggles with hyperparameter tuning made it a particular focus of our guidance, but we also cover other important issues we have encountered in our work (or seen go wrong). Our intention is for this work to be a living document that grows and evolves as our beliefs change. For example, the material on debugging and mitigating training failures would not have been possible for us to write two years ago since it is based on recent results and ongoing investigations. Inevitably, some of our advice will need to be updated to account for new results and improved workflows. We do not know the optimal deep learning recipe, but until the community starts writing down and debating different procedures, we cannot hope to find it. To that end, we would encourage readers who find issues with our advice to produce alternative recommendations, along with convincing evidence, so we can update the playbook. We would also love to see alternative guides and playbooks that might have different recommendations so we can work towards best practices as a community. Finally, any sections marked with a 🤖 emoji are places we would like to do more research. Only after trying to write this playbook did it become completely clear how many interesting and neglected research questions can be found in the deep learning practitioner's workflow.

Guide for starting a new project

Many of the decisions we make over the course of tuning can be made once at the beginning of a project and only occasionally revisited when circumstances change.

Our guidance below makes the following assumptions:

Choosing the model architecture

Summary: When starting a new project, try to reuse a model that already works.

Choosing the optimizer

Summary: Start with the most popular optimizer for the type of problem at hand.

Choosing the batch size

Summary: The batch size governs the training speed and shouldn't be used to directly tune the validation set performance. Often, the ideal batch size will be the largest batch size supported by the available hardware.

Determining the feasible batch sizes and estimating training throughput

[Click to expand]
  • For a given model and optimizer, there will typically be a range of batch sizes supported by the available hardware. The limiting factor is usually accelerator memory.
  • Unfortunately, it can be difficult to calculate which batch sizes will fit in memory without running, or at least compiling, the full training program.
  • The easiest solution is usually to run training jobs at different batch sizes (e.g. increasing powers of 2) for a small number of steps until one of the jobs exceeds the available memory.
  • For each batch size, we should train for long enough to get a reliable estimate of the training throughput

training throughput = (# examples processed per second)

or, equivalently, the time per step.

time per step = (batch size) / (training throughput)

  • When the accelerators aren't yet saturated, if the batch size doubles, the training throughput should also double (or at least nearly double). Equivalently, the time per step should be constant (or at least nearly constant) as the batch size increases.
  • If this is not the case then the training pipeline has a bottleneck such as I/O or synchronization between compute nodes. This may be worth diagnosing and correcting before proceeding.
  • If the training throughput increases only up to some maximum batch size, then we should only consider batch sizes up to that maximum batch size, even if a larger batch size is supported by the hardware.
    • All benefits of using a larger batch size assume the training throughput increases. If it doesn't, fix the bottleneck or use the smaller batch size.
    • Gradient accumulation simulates a larger batch size than the hardware can support and therefore does not provide any throughput benefits. It should generally be avoided in applied work.
  • These steps may need to be repeated every time the model or optimizer is changed (e.g. a different model architecture may allow a larger batch size to fit in memory).

Choosing the batch size to minimize training time

[Click to expand]

Training time = (time per step) x (total number of steps)

  • We can often consider the time per step to be approximately constant for all feasible batch sizes. This is true when there is no overhead from parallel computations and all training bottlenecks have been diagnosed and corrected (see the previous section for how to identify training bottlenecks). In practice, there is usually at least some overhead from increasing the batch size.
  • As the batch size increases, the total number of steps needed to reach a fixed performance goal typically decreases (provided all relevant hyperparameters are re-tuned when the batch size is changed; Shallue et al. 2018).
    • E.g. Doubling the batch size might halve the total number of steps required. This is called perfect scaling.
    • Perfect scaling holds for all batch sizes up to a critical batch size, beyond which one achieves diminishing returns.
    • Eventually, increasing the batch size no longer reduces the number of training steps (but never increases it).
  • Therefore, the batch size that minimizes training time is usually the largest batch size that still provides a reduction in the number of training steps required.
    • This batch size depends on the dataset, model, and optimizer, and it is an open problem how to calculate it other than finding it experimentally for every new problem. 🤖
    • When comparing batch sizes, beware the distinction between an example budget/epoch budget (running all experiments while fixing the number of training example presentations) and a step budget (running all experiments with the number of training steps fixed).
      • Comparing batch sizes with an epoch budget only probes the perfect scaling regime, even when larger batch sizes might still provide a meaningful speedup by reducing the number of training steps required.
    • Often, the largest batch size supported by the available hardware will be smaller than the critical batch size. Therefore, a good rule of thumb (without running any experiments) is to use the largest batch size possible.
  • There is no point in using a larger batch size if it ends up increasing the training time.

Choosing the batch size to minimize resource consumption

[Click to expand]
  • There are two types of resource costs associated with increasing the batch size:
    1. Upfront costs, e.g. purchasing new hardware or rewriting the training pipeline to implement multi-GPU / multi-TPU training.
    2. Usage costs, e.g. billing against the team's resource budgets, billing from a cloud provider, electricity / maintenance costs.
  • If there are significant upfront costs to increasing the batch size, it might be better to defer increasing the batch size until the project has matured and it is easier to assess the cost-benefit tradeoff. Implementing multi-host parallel training programs can introduce bugs and subtle issues so it is probably better to start off with a simpler pipeline anyway. (On the other hand, a large speedup in training time might be very beneficial early in the process when a lot of tuning experiments are needed).
  • We refer to the total usage cost (which may include multiple different kinds of costs) as the "resource consumption". We can break down the resource consumption into the following components:

Resource consumption = (resource consumption per step) x (total number of steps)

  • Increasing the batch size usually allows us to reduce the total number of steps. Whether the resource consumption increases or decreases will depend on how the consumption per step changes.
    • Increasing the batch size might decrease the resource consumption. For example, if each step with the larger batch size can be run on the same hardware as the smaller batch size (with only a small increase in time per step), then any increase in the resource consumption per step might be outweighed by the decrease in the number of steps.
    • Increasing the batch size might not change the resource consumption. For example, if doubling the batch size halves the number of steps required and doubles the number of GPUs used, the total consumption (in terms of GPU-hours) will not change.
    • Increasing the batch size might increase the reso

tuning_playbook (google-research/tuning_playbook)

optimization
Searching Database…

What is this?A free, in-depth guide from five Google Research Brain Team researchers (plus a Harvard co-author) on systematically maximizing the performance of deep learning models — the 'Deep Learning Tuning Playbook'.
Is it software I install, or a document I read?A document, not software — the guide is the repository itself: one long read with sections from starting a new project through experiment tracking and FAQs. There is nothing to install or run.
If I'm starting a new project, where does it tell me to begin?Reuse a proven, well-established architecture first — ideally reproduce a paper close to your problem — pick the most popular optimizer for your problem type, and make sure training and evaluation are easy to run before tuning.
Does it cover the full training workflow end to end?No — its emphasis is hyperparameter tuning. It touches pipeline implementation, input pipeline optimization and experiment tracking, but states that its treatment of those aspects is not intended to be complete.
Who is it written for, and what background do I need?Engineers and researchers, individuals or teams, who already know basic machine learning and deep learning concepts. It assumes a supervised-style problem, though some advice applies to other problem types too.
How does it suggest approaching the tuning itself?As a series of careful experiments: an incremental tuning strategy where each round of experiments has one chosen goal, exploration is balanced against exploitation, and a change is adopted only when the evidence is conclusive.
What is its core advice on batch size?Treat it as a training-speed knob, not a validation-performance one: with learning rate and regularization well tuned, any batch size can reach the same final result, so aim for the largest one your hardware supports while throughput keeps scaling.
Which optimizers does it recommend starting with?Well-established ones popular for your problem type — the authors like SGD with momentum (the Nesterov variant), Adam and NAdam. They caution that more hyperparameters mean more tuning effort, and all 4 of Adam's can matter.
Why did the authors write this playbook?Practical tuning recipes are rarely documented — papers gloss over the messy process, and there is a vast gulf between expert and novice results even with similar methods. They wrote down their own approach as a living document and invite the community to challenge it with evidence.
Size
1.8 MB
Stars
30.4K
Updated
CommitJun 13
Age
3y
Commits · 90 Days