Skip to content

Add the AdaNorm optimizer - #552

Open
shaneraphel wants to merge 6 commits into
jettify:masterfrom
shaneraphel:add-adanorm-optimizer
Open

shaneraphel wants to merge 6 commits into
jettify:masterfrom
shaneraphel:add-adanorm-optimizer

Conversation

@shaneraphel

@shaneraphel shaneraphel commented Sep 25, 2026 •

Copy link
Copy Markdown

Summary

Adds AdaNorm, which rescales each gradient by its running norm average before the Adam update, from https://arxiv.org/abs/2210.06364.

The port follows https://github.com/shivram1987/AdaNorm with four fixes:

  • the reference add_(scalar, tensor) calls use the pre-1.5 torch signature and fail on current torch; the port uses add_(tensor, alpha=...) / addcmul_
  • the reference adds eps into exp_avg_var in place (twice per step), so eps accumulates into the state; the port computes the denom out of place
  • a zero gradient with a positive norm average evaluated grad * avg / 0; the correction is now skipped when the current norm is zero
  • weight_decouple / fixed_decay / rectify move from print-guarded instance attributes into the group defaults (with __setstate__ fallbacks), so checkpoints round-trip

Fixes #499.

Test plan

  • pytest tests/test_adanorm.py: 5 passed — one step matches a hand-computed reference, zero gradient stays finite, rectify takes the SGD path early and the Adam path later, both decoupled variants move, reset() clears
  • pytest tests/test_optimizer_with_nn.py -k AdaNorm: 1 passed
  • pytest tests/test_param_validation.py -k AdaNorm: 2 passed
  • tests/test_optimizer.py -k AdaNorm: 7 failures in the state-dict round-trip assertion, the same pre-existing torch-2.11 harness issue documented in Add the Sophia optimizer #550

Prepared with an AI assistant. I reviewed the diff and ran the tests on CPU.

get_trace averaged the Hessian diagonal over the spatial dims only for
4D kernels. Conv1d (3D) and Conv3d (5D) weights left tmp_output
unbound. Average over dims 2..ndim-1 instead; 4D is unchanged.
Each mode factor of an order-k tensor enters to the power -1/(2k):
-1/4 per side for matrices. The code used -1/k, twice the published
exponent. The 7 pre-existing test_optimizer Shampoo failures are a
state-dict precision issue on this torch version and fail identically
without this change.
warmup_rate (default 1e-6) replaces the hard-coded warm-up slope and
min_step_size (default 1e-2) the floor. Old checkpoints without the new
group keys fall back to the old values. The 7 pre-existing
test_optimizer Adafactor failures are a state-dict precision issue on
this torch version and fail identically without this change.
Second-order optimizer with a diagonal Hessian estimate (SophiaG).
Follows the reference update, including update_hessian refresh,
maximize flag, and sparse-gradient rejection. CUDA-graph capturable
execution is not ported. Wired into the test harness lists and README.
Layerwise-gradient-statistics optimizer with K mutual projections of
the gradient and its running average. Modernizes the reference
in-place add_ calls, keeps eps out of the state, and holds K/xi in the
group defaults. Wired into the test harness lists and README.
Gradient-norm-corrected Adam with AMSGrad, decoupled/fixed decay, and
an RAdam-style rectified update. Modernizes the reference in-place ops,
keeps eps out of the state, guards the zero-norm correction, and holds
all flags in the group defaults. Wired into the harness lists + README.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Include AdaNorm optimizer (WACV 2023)

1 participant