SYNTOLOGY HomeExplorerAtlasCodeMethodologyAboutDevelopersFeedPricing
Paper · 2402.16788 · 2024

Why Transformers Need Adam: A Hessian Perspective

arXiv · PDF · Open in the Atlas

Code that ran

4 of 4 samples (functions and classes) lifted from this paper's linked repositories executed on a synthesized input in Syntology's jail (0 of them constructed an object rather than computing a result; 1 honoured the contract we drafted, 0 violated it and 0 have no contract verdict; 3 failures of our instrument; 0 no recorded run), measured 2026-11-22; repository links from the Papers with Code archive attributed under CC BY-SA, no affiliation; bodies inline only under a permissive licence as GitHub detects it. Not a reproduction of the paper's results.

"Ran" means the function executed on a synthesized input and returned a value. It is not a reproduction of the paper's results. This record, dated, as JSON: /api/ran/2402.16788.json · badge: /api/ran/2402.16788.svg

Each repository's role is a label: a classifier's output recorded on the link, or, where no role is recorded, what the Papers with Code archive marked. The line under it names its basis. Neither says who wrote the code.

RepositoryRoleRan
zyushun/hessian-spectrum canonical (classifier label)
classifier basis: census
4 ran · 0 no recorded run
FunctionStatusWhere it lives
accuracy Ran
ran; the contract check could not run (RAISES, DEP_MISSING or TIMEOUT)
zyushun/hessian-spectrum/vision_models/helper.py
pointer only (licence: NONE) · get_code("d950bea4c9753cd4")
How it ran

The body of this sample is withheld: GitHub detected no licence in this paper's repository, zyushun/hessian-spectrum when it was checked. The setup block that called it is withheld with it, because it is written against that body. source_path and origin say where the code lives, to read under the repository's own terms. A run is recorded.

data_loader Ran
ran; our contract draft was wrong, not the code
zyushun/hessian-spectrum/vision_models/data_loader.py
pointer only (licence: NONE) · get_code("fafefcd33288b3e3")
How it ran

The body of this sample is withheld: GitHub detected no licence in this paper's repository, zyushun/hessian-spectrum when it was checked. The setup block that called it is withheld with it, because it is written against that body. source_path and origin say where the code lives, to read under the repository's own terms. A run is recorded.

get_lr Ran
ran, honoured the contract we drafted
zyushun/hessian-spectrum/language_models/train_gpt2.py
pointer only (licence: NONE) · get_code("aaad22245780ab53")
How it ran

The body of this sample is withheld: GitHub detected no licence in this paper's repository, zyushun/hessian-spectrum when it was checked. The setup block that called it is withheld with it, because it is written against that body. source_path and origin say where the code lives, to read under the repository's own terms. A run is recorded.

plot_overlap Ran
ran; our contract draft was wrong, not the code
zyushun/hessian-spectrum/language_models/logger.py
pointer only (licence: NONE) · get_code("50afa2863ffd9fde")
How it ran

The body of this sample is withheld: GitHub detected no licence in this paper's repository, zyushun/hessian-spectrum when it was checked. The setup block that called it is withheld with it, because it is written against that body. source_path and origin say where the code lives, to read under the repository's own terms. A run is recorded.

Also present in other papers' code

Of 4 samples lifted from this paper's linked repositories, 4 carry a function identity and 0 do not. Of the 4 distinct functions with an identity, 2 are also present in other papers whose code we hold (2 with at least one paper dated earlier, 1 the same month, 2 later) and 2 are only here among the 52,977 papers whose code Syntology holds (as of 2026-09-26).

Only here means: among the 52,977 papers whose code Syntology holds (51,887 with lifted samples, 1,090 through their assemblies only), as of 2026-09-26, no other paper's lifted samples or current assembly bricks contain an identical function body after normalisation.

FunctionAlso present inEarliest-datedOthers named
plot_overlap 31 other papers
24 dated earlier, 2 the same month, 4 later, 1 same year, order not determinable
1612.06321 (2016-12)
Large-Scale Image Retrieval with Attentive Deep Local Features
1805.07925 (2018-05)
Batch-Instance Normalization for Adaptively Style-Invariant Neural Networks
1806.04606 (2018-06)
Knowledge Distillation by On-the-Fly Native Ensemble
and 28 more not named here
get_lr 5 other papers
2 dated earlier, 3 later
1910.00643 (2019-10)
SlowMo: Improving Communication-Efficient Distributed SGD with Slow Momentum
2305.14342 (2023-05)
Sophia: A Scalable Stochastic Second-order Optimizer for Language Model Pre-training
2404.08634 (2024-04)
When Attention Collapses: How Degenerate Layers in LLMs Enable Smaller, Stronger Models
and 2 more not named here

Presence, not direction: an identical function body in two papers' repositories does not say who wrote it, which came from which, or that either paper's method rests on it. Matching is exact after normalisation, so a renamed or edited function is not matched. Dates are when papers appeared, not when code was written. Only .py files the harvester lifted are covered; notebooks are not read. A new-style arXiv id YYMM.NNNN dates a paper to the month 20YY-MM; otherwise Paper.year dates it to the year; otherwise it is undated. Dates are when the paper appeared, not when the code was written. Read 2026-11-22.

Repositories linked to this paper

Some links come from the archived Papers with Code dataset (CC BY-SA 4.0): attribution and licence.

Abstract

SGD performs worse than Adam by a significant margin on Transformers, but the reason remains unclear. In this work, we provide an explanation through the lens of Hessian: (i) Transformers are "heterogeneous": the Hessian spectrum across parameter blocks vary dramatically, a phenomenon we call "block heterogeneity"; (ii) Heterogeneity hampers SGD: SGD performs worse than Adam on problems with block heterogeneity. To validate (i) and (ii), we check various Transformers, CNNs, MLPs, and quadratic problems, and find that SGD can perform on par with Adam on problems without block heterogeneity, but performs worse than Adam when the heterogeneity exists. Our initial theoretical analysis indicates that SGD performs worse because it applies one single learning rate to all blocks, which cannot handle the heterogeneity among blocks. This limitation could be ameliorated if we use coordinate-wise learning rates, as designed in Adam.

For agents

The same record, over MCP at https://syntology.ai/mcp:

get_harvested_code_for_paper("2402.16788")
get_code_for_paper("2402.16788")
have("2402.16788")

The run record, dated, one paper per request, free:

curl https://syntology.ai/api/ran/2402.16788.json

A badge for a README (the split and the date, never a ratio):

[![Syntology run record](https://syntology.ai/api/ran/2402.16788.svg)](https://syntology.ai/paper/2402.16788)

Connect an agent — have() is free.