Features#

Explore the modelling tools you can add to your analysis. Each introduction explains the scientific use cases and links to worked examples.

For your first dataset and starting notebook, use the New User Guide.

Conceptual illustrations, not measured data or guaranteed reconstructions.

Reconstruct the source#

Pixelizations illustration

Pixelizations

Reconstruct the background galaxy on a mesh to study spiral arms, star-forming clumps and irregular structure. Pixelization is a key tool for source science: measuring intrinsic flux, size and magnification alongside the lens mass.

Start with pixelization.

Shapelets illustration

Shapelets

Study source morphology or flexible foreground light with a sum of spatial basis functions. Shapelets capture structure beyond a simple smooth profile while retaining a compact description of the basis geometry. Inspect the combined light and residuals as you increase flexibility.

Explore shapelets.

Model foreground light and neighbours#

Multi Gaussian Expansion (MGE) illustration

Multi Gaussian Expansion (MGE)

Model foreground lens light that overlaps the arcs using a sum of Gaussians. It can also describe a flexible smooth source. An MGE captures changes in shape with radius while solving component brightnesses together. Source examples include flux and magnification measurements.

Explore multi gaussian expansion (mge).

Linear Light Profiles illustration

Linear Light Profiles

Fit models with many light components using fewer sampled parameters. Component brightnesses are solved together at each likelihood evaluation, leaving the search to explore geometry and lens mass. Useful for lens light, source light and MGE models; solved brightnesses change with the model.

Explore linear light profiles.

Extra Galaxies illustration

Extra Galaxies

Account for neighbours whose light blends with the arcs or whose gravity changes the lensing. Choose a light model, mass model or both for each companion. Masking its emission does not remove its gravitational effect.

Explore extra galaxies.

No Lens Light illustration

No Lens Light

Fit the lens mass and source when foreground light is negligible or has already been subtracted. The lens still deflects light. For subtracted images, check how residuals and subtraction uncertainty affect the result.

Explore no lens light.

Operated Light Profiles illustration

Operated Light Profiles

Separate compact emission from extended galaxy light using a component that already includes the imaging PSF response. The surrounding galaxy still receives its appropriate instrumental response. Interferometer examples instead transform the compact sky emission into visibilities.

Explore operated light profiles.

Sky Background illustration

Sky Background

Fit an uncertain sky level alongside faint lens light and arcs. This helps distinguish galaxy outskirts from residual background, while keeping sky photon noise in the noise model. The example fits a constant level.

Explore sky background.

Advanced: ellipse fitting. Measure foreground-light shape with the ellipse introduction, then follow the maintained PyAutoGalaxy examples.

Measure lens mass#

Mass models illustration

Mass Models

Test how the assumed mass distribution affects the inferred lens and source. Choose total-mass profiles or separate stellar and dark components, and use multipoles to explore departures from elliptical symmetry. Angular structure can otherwise resemble a substructure signal.

Explore mass models.

Stellar + Dark Matter illustration

Stellar + Dark Matter

Measure how stars and dark matter contribute to a lens galaxy’s mass. Combine a stellar component tied to observed light with a separate halo to infer mass-to-light ratios and aperture masses. Lensing measures their combined gravity, so the split depends on the model and priors.

Explore stellar + dark matter.

Scaling Relations illustration

Scaling Relations

Include a population of companion galaxies without fitting every mass independently. Tie mass normalizations to measured luminosities through a shared relation, while giving influential companions more freedom. The tied masses depend on that population assumption.

Explore scaling relations.

Multi-Galaxy Lenses, Groups and Clusters illustration

Multi-Galaxy Lenses, Groups and Clusters

Model systems with several deflectors: multi-galaxy lenses have co-dominant galaxies; groups can include a shared halo; clusters use multiple-image positions from many sources. Choose the scale and observables that match your data.

Explore multi-galaxy lenses, groups and clusters.

Double Source-Plane Lenses illustration

Double Source-Plane Lenses

Use two background galaxies at different redshifts to probe lens mass and reconstruct both sources. Their geometry can also constrain cosmological distance ratios. Multi-plane modelling includes the nearer source’s deflection of the farther one; the introductory fit keeps cosmology fixed.

Explore double source-plane lenses.

Weak Lensing illustration

Weak Lensing

Constrain mass across a wider field using the coherent shape distortions of background galaxies. Fit shear catalogues alone or combine them with central strong-lensing constraints, preserving each dataset’s uncertainties and source-redshift information.

Explore weak lensing.

Probe dark matter and build analyses#

Dark Matter Subhalos illustration

Dark Matter Subhalos

Search for unseen halos through their perturbations to lensed arcs. Compare fits with and without a halo to identify candidates and infer their properties. Check candidates against lens-model flexibility and systematics, then use sensitivity mapping to interpret both detections and non-detections.

Explore dark matter subhalos.

Continue to subhalo detection for the search workflow.

Line-of-Sight Halos illustration

Line-of-Sight Halos

Simulate the combined effect of a halo population between observer and source. Multi-plane ray tracing includes halos in front of and behind the main lens, providing mock images for dark matter studies and tests of lens-redshift assumptions. These examples generate simulations, not population-inference results.

Explore line-of-sight halos.

Sensitivity Mapping illustration

Sensitivity Mapping

Measure which halos your data and modelling procedure could detect. Inject a halo into simulated data, fit with and without it, and repeat across positions or masses. This calibrates non-detections as well as detections; the introductory example uses four positions at one injected mass.

Explore sensitivity mapping.

Potential Correction illustration

Potential Correction

Investigate arc residuals by reconstructing small corrections to a smooth lensing potential alongside the source. This gravitational-imaging approach locates candidate mass structure without first choosing a halo profile. A reconstructed feature still needs physical modelling and systematic checks.

Explore potential correction.

Automated pipelines slam illustration

Automated Pipelines / SLaM

Build complex lens models through a sequence of simpler fits. The Source, Light and Mass pipelines use earlier results to initialize later searches, progressively refining the source, foreground light and mass model.

Explore automated pipelines / slam.

Graphical models illustration

Graphical Models

Study populations of lenses by fitting datasets with shared parameters. Hierarchical models infer a population distribution while retaining an individual model for each lens—for example, a distribution of mass slopes or a common Hubble constant.

Explore graphical models.

Extend the analysis across observations#

Point Sources illustration

Point Sources

Add flux and time-delay constraints to a point-source lens model, or deblend compact images from foreground light before measuring them.

Point-source examples.

Interferometry illustration

Interferometry

Extend radio and submillimetre modelling with flexible source light, pixelized reconstructions and source-science measurements while fitting the visibilities.

Interferometer features.

Data Cubes illustration

Data Cubes

Map a lensed source across a spectral line by reconstructing each channel with a shared lens model. Each channel keeps its own brightness, sampling and noise. These examples reconstruct emission; a dynamical interpretation needs an additional model.

Explore data cubes.

Multi-Wavelength illustration

Multi-Wavelength

Compare stellar, dust and line emission across observations while fitting a shared lens model. Keep each dataset’s brightness distribution, instrumental response and noise distinct; link only the parameters your scientific model shares.

Explore multi-wavelength.

All workspace links

Choose your dataset to browse every feature introduction.

Group · 13 introductions
Imaging · 17 introductions
Interferometer · 12 introductions
Multi dataset · 8 introductions
Multi galaxy · 13 introductions
Point source · 4 introductions
Weak · 1 introductions