Skip to content

docs(searches): add multi-start gradient searches to the modeling searches guide #277

Description

@Jammy2211

Overview

Propagate the multi-start gradient MAP searches (PyAutoFit#1369, shipped: af.MultiStartAdam / MultiStartADABelief / MultiStartLion) to this workspace's scripts/guides/modeling/searches.py guide, alongside the existing LBFGS section.

Plan

  • Add a MultiStartAdam section to scripts/guides/modeling/searches.py after the LBFGS section: a af.MultiStartAdam(...) config block + prose. The guide is a configuration reference (it constructs search objects, does not run fits), so this mirrors how LBFGS is shown.
  • Frame it against the caveat the guide already states (optimizers struggle on these complex parameter spaces): multi-start Adam is the optimizer that works, because its wide population of parallel starts escapes the local maxima that trap single-start LBFGS (benchmark-proven on the HST MGE lens likelihood). Note it needs use_jax=True; MultiStartADABelief/MultiStartLion are drop-in alternatives; it returns a MAP point estimate (Nautilus stays default for errors).
  • Update the __Contents__ list and regenerate the paired notebooks/guides/modeling/searches.ipynb.

Phase 3 of the multi-start gradient search promotion. --auto, effective level safe (docs cap).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions