Skip to content

docs: Add Grouping example#648

Merged
ValerianRey merged 6 commits intoSimplexLab:mainfrom
rkhosrowshahi:docs/add-grouping-example
Apr 16, 2026
Merged

docs: Add Grouping example#648
ValerianRey merged 6 commits intoSimplexLab:mainfrom
rkhosrowshahi:docs/add-grouping-example

Conversation

@rkhosrowshahi
Copy link
Copy Markdown
Contributor

@rkhosrowshahi rkhosrowshahi commented Apr 15, 2026

Restores the Grouping documentation example: whole model, encoder–decoder, per-layer, and per-matrix GradVac grouping strategies with doctest snippets.
Updates CHANGELOG.md under Unreleased.

Re-add the GradVac grouping documentation (whole model, encoder-decoder,
per-layer, per-tensor) with doctest snippets, link it from the examples
index, and cross-link from GradVac. Changelog: note the new example under
Unreleased.
@ValerianRey ValerianRey changed the title docs: restore Grouping example for GradVac per-parameter-group aggregation docs: Add Grouping example Apr 15, 2026
* Add link to the paper
* Simplify some formulations
* Rename strategies whole model => together; encoder-decoder => per network; all layers => per layer; all matrices => per tensor
* Place a bit less emphasis on GradVac: rename gradvac to aggregator when possible
* Create losses in separate lines in the code examples
* Remove a few redundant sentences from a note
…he names used in GradVac's paper and in LibMTL
@ValerianRey ValerianRey added the cc: docs Conventional commit type for changes to the documentation. label Apr 15, 2026
@ValerianRey
Copy link
Copy Markdown
Contributor

Thanks you very much @rkhosrowshahi , that's really nice

I took the liberty to make a few changes: in particular, making this example less focused about GradVac and MTL, to make it more clear that it applies to every aggregator and to non-MTL cases.

IMO we can merge this + release v0.10.0.

Copy link
Copy Markdown
Contributor

@PierreQuinton PierreQuinton left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks a lot for the PR.

@ValerianRey ValerianRey merged commit bdff933 into SimplexLab:main Apr 16, 2026
16 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cc: docs Conventional commit type for changes to the documentation.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants