From c08686304005321eb0d2fa1bd1b9bc3aa7d1dec3 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 25 Jul 2026 19:25:22 +0000 Subject: [PATCH 1/2] docs: add the multi_galaxy rung to the New User Guide regime routing The What Scale Lens? section now presents the four-rung ladder (galaxy -> multi_galaxy -> group -> cluster) with the analysis-split routing: extended source pixel-level fits through group scale, point-source multiple-image positions (no lens light, multi-plane) at cluster scale. Adds the multi_galaxy start_here links (GitHub + Colab). Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_012Eacj9naBWSKrevsqnVJWR --- docs/overview/overview_2_new_user_guide.md | 21 ++++++++++++++++----- 1 file changed, 16 insertions(+), 5 deletions(-) diff --git a/docs/overview/overview_2_new_user_guide.md b/docs/overview/overview_2_new_user_guide.md index 4b47f1bcf..aae604ffb 100644 --- a/docs/overview/overview_2_new_user_guide.md +++ b/docs/overview/overview_2_new_user_guide.md @@ -19,14 +19,24 @@ This guide begins with two simple questions to help you find the most appropriat What size and scale of strong lens system are you expecting to work with? -There are three scales to choose from: +There are four scales to choose from, which form a ladder: every group and cluster is a multi-galaxy system, +but not vice versa. What changes as you climb is first the mass model, then the entire analysis strategy: - **Galaxy Scale**: Made up of a single lens galaxy lensing a single source galaxy, the simplest strong lens you can get! If you're interested in galaxy scale lenses, go to the question below called "What Data Type?". -- **Group Scale**: Strong Lens Groups contains 2-10 lens galaxies, normally with one main large galaxy responsible for the majority of lensing. - They also typically lens just one source galaxy. If you are interested in groups, go to the [group/start_here.ipynb](https://github.com/PyAutoLabs/autolens_workspace/blob/main/notebooks/group/start_here.ipynb) notebook. -- **Cluster Scale**: Strong Lens Galaxy clusters often contained 20-50, or more, lens galaxies, lensing 10, or more, sources galaxies. - If you are interested in clusters, go to the [cluster/start_here.ipynb](https://github.com/PyAutoLabs/autolens_workspace/blob/main/notebooks/cluster/start_here.ipynb) notebook. +- **Multi Galaxy**: Two or more galaxies of comparable mass all contribute significantly to the lensing, with no shared + dark-matter halo — each co-dominant deflector gets its own free light and mass model, and the source is a single + extended galaxy fitted at pixel level exactly as at galaxy scale. If this is your system, go to the + [multi_galaxy/start_here.ipynb](https://github.com/PyAutoLabs/autolens_workspace/blob/main/notebooks/multi_galaxy/start_here.ipynb) notebook. +- **Group Scale**: Strong lens groups contain 2-10 lens galaxies and typically lens just one source galaxy. A dominant + group-scale dark-matter halo may enter the model as an explicit choice, with fainter members organised into tiers + (scaling relations, tidally truncated profiles). The source modelling is unchanged — one extended source fitted at + pixel level. If you are interested in groups, go to the [group/start_here.ipynb](https://github.com/PyAutoLabs/autolens_workspace/blob/main/notebooks/group/start_here.ipynb) notebook. +- **Cluster Scale**: Strong lens galaxy clusters often contain 20-50, or more, lens galaxies, lensing 10, or more, source + galaxies across a wide range of redshifts. The mass framework is the same as a group's, but the **analysis changes**: + the default workflow fits point-source multiple-image positions (multi-plane, per-source redshifts) rather than + reconstructing extended sources, and the lens galaxies' light is not modeled. If you are interested in clusters, go + to the [cluster/start_here.ipynb](https://github.com/PyAutoLabs/autolens_workspace/blob/main/notebooks/cluster/start_here.ipynb) notebook. ## What Dataset Type? @@ -51,6 +61,7 @@ so you can check its the right software for you before going through the install > - [imaging/start_here.ipynb](https://colab.research.google.com/github/PyAutoLabs/autolens_workspace/blob/2026.7.25.2/notebooks/imaging/start_here.ipynb): Galaxy scale strong lenses observed with CCD imaging (e.g. Hubble, James Webb). > - [interferometer/start_here.ipynb](https://colab.research.google.com/github/PyAutoLabs/autolens_workspace/blob/2026.7.25.2/notebooks/interferometer/start_here.ipynb): Galaxy scale strong lenses observed with interferometer data (e.g. ALMA). > - [point_source/start_here.ipynb](https://colab.research.google.com/github/PyAutoLabs/autolens_workspace/blob/2026.7.25.2/notebooks/point_source/start_here.ipynb): Galaxy scale strong lenses with a lensed point source (e.g. lensed quasars). +> - [multi_galaxy/start_here.ipynb](https://colab.research.google.com/github/PyAutoLabs/autolens_workspace/blob/2026.7.25.2/notebooks/multi_galaxy/start_here.ipynb): Multi-galaxy strong lenses with 2+ co-dominant lens galaxies and no host halo. > - [group/start_here.ipynb](https://colab.research.google.com/github/PyAutoLabs/autolens_workspace/blob/2026.7.25.2/notebooks/group/start_here.ipynb): Group scale strong lenses where there are 2-10 lens galaxies. > - [cluster/start_here.ipynb](https://colab.research.google.com/github/PyAutoLabs/autolens_workspace/blob/2026.7.25.2/notebooks/cluster/start_here.ipynb): Cluster scale strong lenses with 2+ lenses and 5+ source galaxies. From d3e5141f1be1908c4736429e795b9c4baafb72f7 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 25 Jul 2026 20:55:59 +0000 Subject: [PATCH 2/2] =?UTF-8?q?docs:=20review=20fixes=20=E2=80=94=20four-s?= =?UTF-8?q?cale=20intro,=20halo-modelled=20phrasing,=20dataset-type=20head?= =?UTF-8?q?ing,=20cluster=20blurb?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_012Eacj9naBWSKrevsqnVJWR --- docs/overview/overview_2_new_user_guide.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/overview/overview_2_new_user_guide.md b/docs/overview/overview_2_new_user_guide.md index aae604ffb..13c500a2e 100644 --- a/docs/overview/overview_2_new_user_guide.md +++ b/docs/overview/overview_2_new_user_guide.md @@ -8,7 +8,7 @@ The [**PyAutoLens AI Assistant**](https://github.com/PyAutoLabs/autolens_assista ## Human-Readable Guide -**PyAutoLens** can analyse strong lens systems across a range of physical scales (e.g. galaxy, group, and cluster) and for +**PyAutoLens** can analyse strong lens systems across a range of physical scales (e.g. galaxy, multi-galaxy, group, and cluster) and for different types of data (e.g. imaging, interferometer, and point-source observations). Depending on the scientific questions you are interested in, the analysis you perform may differ significantly. The autolens_workspace contains a suite of example Jupyter Notebooks, organised by lens scale and dataset type. @@ -23,9 +23,10 @@ There are four scales to choose from, which form a ladder: every group and clust but not vice versa. What changes as you climb is first the mass model, then the entire analysis strategy: - **Galaxy Scale**: Made up of a single lens galaxy lensing a single source galaxy, the simplest strong lens you can get! - If you're interested in galaxy scale lenses, go to the question below called "What Data Type?". -- **Multi Galaxy**: Two or more galaxies of comparable mass all contribute significantly to the lensing, with no shared - dark-matter halo — each co-dominant deflector gets its own free light and mass model, and the source is a single + If you're interested in galaxy scale lenses, go to the question below called "What Dataset Type?". +- **Multi Galaxy**: Two or more galaxies of comparable mass all contribute significantly to the lensing, with no + dominant shared dark-matter halo (systems with one belong on the group or cluster rungs below) — each co-dominant + deflector gets its own free light and mass model, and the source is a single extended galaxy fitted at pixel level exactly as at galaxy scale. If this is your system, go to the [multi_galaxy/start_here.ipynb](https://github.com/PyAutoLabs/autolens_workspace/blob/main/notebooks/multi_galaxy/start_here.ipynb) notebook. - **Group Scale**: Strong lens groups contain 2-10 lens galaxies and typically lens just one source galaxy. A dominant @@ -63,7 +64,7 @@ so you can check its the right software for you before going through the install > - [point_source/start_here.ipynb](https://colab.research.google.com/github/PyAutoLabs/autolens_workspace/blob/2026.7.25.2/notebooks/point_source/start_here.ipynb): Galaxy scale strong lenses with a lensed point source (e.g. lensed quasars). > - [multi_galaxy/start_here.ipynb](https://colab.research.google.com/github/PyAutoLabs/autolens_workspace/blob/2026.7.25.2/notebooks/multi_galaxy/start_here.ipynb): Multi-galaxy strong lenses with 2+ co-dominant lens galaxies and no host halo. > - [group/start_here.ipynb](https://colab.research.google.com/github/PyAutoLabs/autolens_workspace/blob/2026.7.25.2/notebooks/group/start_here.ipynb): Group scale strong lenses where there are 2-10 lens galaxies. -> - [cluster/start_here.ipynb](https://colab.research.google.com/github/PyAutoLabs/autolens_workspace/blob/2026.7.25.2/notebooks/cluster/start_here.ipynb): Cluster scale strong lenses with 2+ lenses and 5+ source galaxies. +> - [cluster/start_here.ipynb](https://colab.research.google.com/github/PyAutoLabs/autolens_workspace/blob/2026.7.25.2/notebooks/cluster/start_here.ipynb): Cluster scale strong lenses with 20+ lens galaxies and 10+ source galaxies. ## Still Unsure?