From 5c939825d58c15a596a9ea6be28240a31bba9ba2 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 25 Jul 2026 21:23:19 +0000 Subject: [PATCH] docs: align overview_3 group section with the four-rung regime ladder MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The Groups section still defined 'two or more lens galaxies' as group scale — now the multi_galaxy rung's definition — contradicting the updated New User Guide. The section now introduces the multi-galaxy/group/cluster ladder and frames the image as the group-scale case. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_012Eacj9naBWSKrevsqnVJWR --- docs/overview/overview_3_features.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/overview/overview_3_features.md b/docs/overview/overview_3_features.md index ed901dbca..46922f862 100644 --- a/docs/overview/overview_3_features.md +++ b/docs/overview/overview_3_features.md @@ -126,10 +126,15 @@ The following paper gives a detailed overview of MGEs and their applications in Checkout `autolens_workspace/notebooks/features/multi_gaussian_expansion.ipynb` to learn how to use an MGE. -## Groups - -The strong lenses we've discussed so far have just a single lens galaxy responsible for the lensing. Group-scale -strong lenses are systems where there two or more lens galaxies deflecting one or more background sources: +## Multi-Galaxy Lenses, Groups and Clusters + +The strong lenses we've discussed so far have just a single lens galaxy responsible for the lensing. Above that +scale, **PyAutoLens** organises lenses into a ladder of three regimes (see the New User Guide for the full +routing): *multi-galaxy* lenses have two or more co-dominant lens galaxies and no shared dark-matter halo +(`autolens_workspace/*/multi_galaxy`); *group-scale* lenses add a group dark-matter halo as an explicit modelling +choice, with fainter members on scaling relations; and *cluster-scale* lenses keep the group's mass framework but +switch the analysis to point-source multiple-image positions of many sources. The image below shows a group-scale +system, where multiple lens galaxies deflect one or more background sources: ```{image} https://raw.githubusercontent.com/PyAutoLabs/PyAutoLens/main/docs/overview/images/overview_3/group.png :alt: Alternative text