Skip to content

docs: describe higher_is_better as descriptive metadata - #600

Open
ChrisW09 wants to merge 2 commits into
mainfrom
docs/higher-is-better
Open

ChrisW09 wants to merge 2 commits into
mainfrom
docs/higher-is-better

Conversation

@ChrisW09

@ChrisW09 ChrisW09 commented Oct 21, 2026 •

Copy link
Copy Markdown
Collaborator

Fixes #599

Problem

The DeepTabMetric docstring said higher_is_better sets the HPO optimisation direction and drives early stopping and checkpoint decisions, and called CRPS higher-is-better. The deeptab.metrics package docstring said "the training loop and HPO use this". No code reads the attribute: optimize_hparams() minimises val_loss, early stopping and checkpointing follow monitor/mode, and CRPS.higher_is_better is False.

Change

Docstrings only:

  • deeptab/metrics/base.py and deeptab/metrics/__init__.py describe higher_is_better as descriptive metadata for reading the score, as docs/api/metrics/index.rst already does.
  • The deeptab.metrics overview no longer says the framework reads all three metric attributes automatically; it calls them metadata attributes, which matches the corrected higher_is_better bullet.
  • CRPS moves to the lower-is-better examples.

Checks

  • just test: 3236 passed, 46 skipped, 28 xfailed; coverage 91.29%
  • just docs: build succeeded (warnings treated as errors)
  • just check: all hooks passed (ruff, prettier, pyright)

The DeepTabMetric and deeptab.metrics docstrings said HPO and early
stopping use higher_is_better to pick the optimisation direction, and
listed CRPS as higher-is-better. Nothing reads the attribute: HPO
minimises val_loss and early stopping follows monitor/mode, and CRPS is
lower-is-better. Match the metrics API page.

Fixes #599
The intro said the framework reads all three attributes automatically,
which contradicts the corrected higher_is_better bullet below it.

Refs #599

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.

[DOCS] DeepTabMetric.higher_is_better is described as driving HPO and early stopping, but nothing reads it

1 participant