Skip to content

Commit 7158be8

Browse files
authored
Merge pull request #652 from PyAutoLabs/claude/pyautolens-doc-reorganization-w6a1l5
docs: add the multi_galaxy rung to the New User Guide regime routing
2 parents 08bcee2 + d3e5141 commit 7158be8

1 file changed

Lines changed: 20 additions & 8 deletions

File tree

docs/overview/overview_2_new_user_guide.md

Lines changed: 20 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ The [**PyAutoLens AI Assistant**](https://github.com/PyAutoLabs/autolens_assista
88

99
## Human-Readable Guide
1010

11-
**PyAutoLens** can analyse strong lens systems across a range of physical scales (e.g. galaxy, group, and cluster) and for
11+
**PyAutoLens** can analyse strong lens systems across a range of physical scales (e.g. galaxy, multi-galaxy, group, and cluster) and for
1212
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.
1313

1414
The autolens_workspace contains a suite of example Jupyter Notebooks, organised by lens scale and dataset type.
@@ -19,14 +19,25 @@ This guide begins with two simple questions to help you find the most appropriat
1919

2020
What size and scale of strong lens system are you expecting to work with?
2121

22-
There are three scales to choose from:
22+
There are four scales to choose from, which form a ladder: every group and cluster is a multi-galaxy system,
23+
but not vice versa. What changes as you climb is first the mass model, then the entire analysis strategy:
2324

2425
- **Galaxy Scale**: Made up of a single lens galaxy lensing a single source galaxy, the simplest strong lens you can get!
25-
If you're interested in galaxy scale lenses, go to the question below called "What Data Type?".
26-
- **Group Scale**: Strong Lens Groups contains 2-10 lens galaxies, normally with one main large galaxy responsible for the majority of lensing.
27-
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.
28-
- **Cluster Scale**: Strong Lens Galaxy clusters often contained 20-50, or more, lens galaxies, lensing 10, or more, sources galaxies.
29-
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.
26+
If you're interested in galaxy scale lenses, go to the question below called "What Dataset Type?".
27+
- **Multi Galaxy**: Two or more galaxies of comparable mass all contribute significantly to the lensing, with no
28+
dominant shared dark-matter halo (systems with one belong on the group or cluster rungs below) — each co-dominant
29+
deflector gets its own free light and mass model, and the source is a single
30+
extended galaxy fitted at pixel level exactly as at galaxy scale. If this is your system, go to the
31+
[multi_galaxy/start_here.ipynb](https://github.com/PyAutoLabs/autolens_workspace/blob/main/notebooks/multi_galaxy/start_here.ipynb) notebook.
32+
- **Group Scale**: Strong lens groups contain 2-10 lens galaxies and typically lens just one source galaxy. A dominant
33+
group-scale dark-matter halo may enter the model as an explicit choice, with fainter members organised into tiers
34+
(scaling relations, tidally truncated profiles). The source modelling is unchanged — one extended source fitted at
35+
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.
36+
- **Cluster Scale**: Strong lens galaxy clusters often contain 20-50, or more, lens galaxies, lensing 10, or more, source
37+
galaxies across a wide range of redshifts. The mass framework is the same as a group's, but the **analysis changes**:
38+
the default workflow fits point-source multiple-image positions (multi-plane, per-source redshifts) rather than
39+
reconstructing extended sources, and the lens galaxies' light is not modeled. If you are interested in clusters, go
40+
to the [cluster/start_here.ipynb](https://github.com/PyAutoLabs/autolens_workspace/blob/main/notebooks/cluster/start_here.ipynb) notebook.
3041

3142
## What Dataset Type?
3243

@@ -51,8 +62,9 @@ so you can check its the right software for you before going through the install
5162
> - [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).
5263
> - [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).
5364
> - [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).
65+
> - [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.
5466
> - [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.
55-
> - [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.
67+
> - [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.
5668
5769
## Still Unsure?
5870

0 commit comments

Comments
 (0)