This is a PyTorch re-implementation of the CurveBall algorithm, presented in:
João F. Henriques, Sebastien Ehrhardt, Samuel Albanie, Andrea Vedaldi, "Small Steps and Giant Leaps: Minimal Newton Solvers for Deep Learning", ICCV 2019 (arXiv)
It follows closely the original Matlab code, although it does not implement all the experiments in that paper.
Unfortunately, the PyTorch operations used for forward-mode automatic differentiation (FMAD) are somewhat slow (refer to this issue).
For this reason, it is not as fast as the original Matlab implementation or this TensorFlow port.
You can find an experimental version in the interleave branch that achieves much higher speed despite this problem (by interleaving the CurveBall steps with SGD). Other suggested fixes are very welcome.
Although it may work with older versions, this has mainly been tested with:
- PyTorch 1.3
- Python 3.7
Plots are produced with OverBoard (optional).
The curveball.py file contains the full code of the optimizer and that's all you need for it to work. Everything else is just example code.
The optimizer does not need any hyper-parameters:
from curveball import CurveBall
net = ... # your network goes here
optimizer = CurveBall(net.parameters()
Inside the training loop, CurveBall needs to know what loss you're using (or losses, as a sum). Provide them as a closure (function), for example (given some labels):
loss_fn = lambda pred: F.cross_entropy(pred, labels)
Similarly, provide a closure for the forward operation of the model (given a model net and input images):
model_fn = lambda: net(images)
Now the optimizer step is just:
(loss, predictions) = optimizer.step(model_fn, loss_fn)
Note that, unlike gradient-based optimizers like SGD, there's no need to run the model forward, call backward(), zero-gradients, or any other operations -- the optimizer's step will do all those things (by calling the closures you defined), and update the network's parameters. You can define more complex loss functions or models by using full functions (def f(): ...) instead of lambda functions.
See examples/cifar.py or examples/mnist.py.