docs: point-source solved-variant guides (phase 4 of #657)

.script_sizes.json

@@ -1,17 +1,17 @@
 {
   "scripts/cluster/__init__.py": 0,
-  "scripts/cluster/csv_api.py": 18602,
+  "scripts/cluster/csv_api.py": 18648,
   "scripts/cluster/lenstool/__init__.py": 0,
-  "scripts/cluster/lenstool/data.py": 15172,
-  "scripts/cluster/lenstool/modeling.py": 21932,
-  "scripts/cluster/lenstool/parameterization_mapping.py": 24021,
-  "scripts/cluster/likelihood_function.py": 37956,
-  "scripts/cluster/mass_parameterizations.py": 34990,
-  "scripts/cluster/mass_parameterizations_pyautolens.py": 20824,
-  "scripts/cluster/modeling.py": 32864,
-  "scripts/cluster/plot.py": 4443,
+  "scripts/cluster/lenstool/data.py": 15103,
+  "scripts/cluster/lenstool/modeling.py": 22297,
+  "scripts/cluster/lenstool/parameterization_mapping.py": 23956,
+  "scripts/cluster/likelihood_function.py": 39137,
+  "scripts/cluster/mass_parameterizations.py": 35001,
+  "scripts/cluster/mass_parameterizations_pyautolens.py": 17701,
+  "scripts/cluster/modeling.py": 32813,
+  "scripts/cluster/plot.py": 7381,
   "scripts/cluster/simulator.py": 33421,
-  "scripts/cluster/start_here.py": 23785,
+  "scripts/cluster/start_here.py": 24027,
   "scripts/group/__init__.py": 0,
   "scripts/group/data_preparation/__init__.py": 0,
   "scripts/group/data_preparation/start_here.py": 19804,
@@ -86,28 +86,28 @@
   "scripts/group/simulator.py": 13175,
   "scripts/group/slam.py": 36772,
   "scripts/group/source_science.py": 12692,
-  "scripts/group/start_here.py": 23475,
+  "scripts/group/start_here.py": 22849,
   "scripts/guides/__init__.py": 0,
   "scripts/guides/advanced/__init__.py": 0,
   "scripts/guides/advanced/add_a_profile.py": 28656,
   "scripts/guides/advanced/custom_analysis.py": 25045,
-  "scripts/guides/advanced/multi_plane.py": 34456,
+  "scripts/guides/advanced/multi_plane.py": 23386,
   "scripts/guides/advanced/over_sampling.py": 23958,
   "scripts/guides/advanced/over_sampling_chaining.py": 10482,
   "scripts/guides/coolest_interop.py": 5640,
-  "scripts/guides/data_structures.py": 18294,
-  "scripts/guides/galaxies.py": 10636,
+  "scripts/guides/data_structures.py": 15004,
+  "scripts/guides/galaxies.py": 8231,
   "scripts/guides/hpc/__init__.py": 0,
   "scripts/guides/hpc/example_cpu_and_gpu.py": 14065,
-  "scripts/guides/lens_calc.py": 25664,
+  "scripts/guides/lens_calc.py": 18780,
   "scripts/guides/modeling/__init__.py": 0,
   "scripts/guides/modeling/advanced/__init__.py": 0,
   "scripts/guides/modeling/advanced/expectation_propagation.py": 14753,
   "scripts/guides/modeling/advanced/graphical.py": 11406,
   "scripts/guides/modeling/advanced/hierarchical.py": 13049,
   "scripts/guides/modeling/bug_fix.py": 5769,
   "scripts/guides/modeling/chaining.py": 18024,
-  "scripts/guides/modeling/cookbook.py": 14384,
+  "scripts/guides/modeling/cookbook.py": 14400,
   "scripts/guides/modeling/customize.py": 11887,
   "scripts/guides/modeling/searches.py": 20117,
   "scripts/guides/modeling/slam_start_here.py": 22642,
@@ -116,18 +116,18 @@
   "scripts/guides/plot/searches.py": 23865,
   "scripts/guides/plot/start_here.py": 10152,
   "scripts/guides/plot/visuals.py": 7782,
-  "scripts/guides/point_source_pairing.py": 10038,
+  "scripts/guides/point_source_pairing.py": 17021,
   "scripts/guides/profiles/__init__.py": 0,
   "scripts/guides/profiles/light.py": 27532,
   "scripts/guides/profiles/light_and_mass_profiles.py": 27758,
   "scripts/guides/profiles/mass.py": 26195,
   "scripts/guides/results/__init__.py": 0,
   "scripts/guides/results/_quick_fit.py": 5639,
   "scripts/guides/results/aggregator/__init__.py": 0,
-  "scripts/guides/results/aggregator/data_fitting.py": 7674,
+  "scripts/guides/results/aggregator/data_fitting.py": 7682,
   "scripts/guides/results/aggregator/galaxies_fits.py": 9258,
   "scripts/guides/results/aggregator/interferometer.py": 2355,
-  "scripts/guides/results/aggregator/models.py": 10146,
+  "scripts/guides/results/aggregator/models.py": 10154,
   "scripts/guides/results/aggregator/queries.py": 5694,
   "scripts/guides/results/aggregator/samples.py": 22417,
   "scripts/guides/results/aggregator/samples_via_aggregator.py": 22018,
@@ -139,12 +139,12 @@
   "scripts/guides/results/workflow/csv_make.py": 11839,
   "scripts/guides/results/workflow/fits_make.py": 13021,
   "scripts/guides/results/workflow/png_make.py": 11639,
-  "scripts/guides/tracer.py": 23319,
+  "scripts/guides/tracer.py": 20777,
   "scripts/guides/units/__init__.py": 0,
   "scripts/guides/units/cosmology.py": 11036,
   "scripts/guides/units/flux.py": 13965,
   "scripts/guides/units/mass_to_light_ratio_units.py": 5251,
-  "scripts/guides/using_jax.py": 9936,
+  "scripts/guides/using_jax.py": 22319,
   "scripts/imaging/__init__.py": 0,
   "scripts/imaging/data_preparation/__init__.py": 0,
   "scripts/imaging/data_preparation/examples/__init__.py": 0,
@@ -243,13 +243,13 @@
   "scripts/imaging/features/scaling_relation/likelihood_function.py": 12298,
   "scripts/imaging/features/scaling_relation/modeling.py": 17450,
   "scripts/imaging/features/scaling_relation/simulator.py": 11212,
-  "scripts/imaging/features/scaling_relation/slam.py": 31120,
+  "scripts/imaging/features/scaling_relation/slam.py": 32254,
   "scripts/imaging/features/simulator_manual_signal_to_noise_ratio.py": 7624,
-  "scripts/imaging/fit.py": 16848,
+  "scripts/imaging/fit.py": 16863,
   "scripts/imaging/likelihood_function.py": 21241,
   "scripts/imaging/modeling.py": 33768,
-  "scripts/imaging/plot.py": 6596,
-  "scripts/imaging/simulator.py": 19684,
+  "scripts/imaging/plot.py": 8544,
+  "scripts/imaging/simulator.py": 19656,
   "scripts/imaging/simulator_sample.py": 8120,
   "scripts/imaging/source_science.py": 10283,
   "scripts/imaging/start_here.py": 25845,
@@ -276,9 +276,9 @@
   "scripts/interferometer/features/datacube/delaunay.py": 9601,
   "scripts/interferometer/features/datacube/likelihood_function.py": 29864,
   "scripts/interferometer/features/datacube/modeling.py": 13043,
-  "scripts/interferometer/features/datacube/modeling_parametric.py": 9663,
+  "scripts/interferometer/features/datacube/modeling_parametric.py": 9679,
   "scripts/interferometer/features/datacube/simulator.py": 16873,
-  "scripts/interferometer/features/datacube/start_here.py": 15401,
+  "scripts/interferometer/features/datacube/start_here.py": 15409,
   "scripts/interferometer/features/extra_galaxies/__init__.py": 0,
   "scripts/interferometer/features/extra_galaxies/modeling.py": 13067,
   "scripts/interferometer/features/extra_galaxies/simulator.py": 7881,
@@ -310,55 +310,73 @@
   "scripts/interferometer/fit.py": 13211,
   "scripts/interferometer/likelihood_function.py": 20288,
   "scripts/interferometer/modeling.py": 28829,
-  "scripts/interferometer/plot.py": 6401,
-  "scripts/interferometer/simulator.py": 14522,
+  "scripts/interferometer/plot.py": 8568,
+  "scripts/interferometer/simulator.py": 14494,
   "scripts/interferometer/source_science.py": 11051,
   "scripts/interferometer/start_here.py": 23464,
   "scripts/multi_dataset/__init__.py": 0,
   "scripts/multi_dataset/features/__init__.py": 0,
   "scripts/multi_dataset/features/dataset_offsets/__init__.py": 0,
-  "scripts/multi_dataset/features/dataset_offsets/modeling.py": 11027,
-  "scripts/multi_dataset/features/dataset_offsets/simulator.py": 9222,
+  "scripts/multi_dataset/features/dataset_offsets/modeling.py": 11059,
+  "scripts/multi_dataset/features/dataset_offsets/simulator.py": 9238,
   "scripts/multi_dataset/features/imaging_and_interferometer/__init__.py": 0,
-  "scripts/multi_dataset/features/imaging_and_interferometer/modeling.py": 10259,
-  "scripts/multi_dataset/features/imaging_and_interferometer/simulator.py": 6659,
+  "scripts/multi_dataset/features/imaging_and_interferometer/modeling.py": 10291,
+  "scripts/multi_dataset/features/imaging_and_interferometer/simulator.py": 6683,
   "scripts/multi_dataset/features/imaging_and_point_source/__init__.py": 0,
-  "scripts/multi_dataset/features/imaging_and_point_source/modeling.py": 12218,
+  "scripts/multi_dataset/features/imaging_and_point_source/modeling.py": 12242,
   "scripts/multi_dataset/features/one_by_one/__init__.py": 0,
-  "scripts/multi_dataset/features/one_by_one/modeling.py": 10959,
+  "scripts/multi_dataset/features/one_by_one/modeling.py": 11007,
   "scripts/multi_dataset/features/pixelization/__init__.py": 0,
-  "scripts/multi_dataset/features/pixelization/modeling.py": 8423,
-  "scripts/multi_dataset/features/pixelization/simulator.py": 7287,
+  "scripts/multi_dataset/features/pixelization/modeling.py": 8447,
+  "scripts/multi_dataset/features/pixelization/simulator.py": 7303,
   "scripts/multi_dataset/features/same_wavelength/__init__.py": 0,
-  "scripts/multi_dataset/features/same_wavelength/modeling.py": 9785,
-  "scripts/multi_dataset/features/same_wavelength/simulator.py": 6388,
+  "scripts/multi_dataset/features/same_wavelength/modeling.py": 9809,
+  "scripts/multi_dataset/features/same_wavelength/simulator.py": 6390,
   "scripts/multi_dataset/features/slam/__init__.py": 0,
-  "scripts/multi_dataset/features/slam/independent.py": 25407,
-  "scripts/multi_dataset/features/slam/simultaneous.py": 23950,
+  "scripts/multi_dataset/features/slam/independent.py": 25463,
+  "scripts/multi_dataset/features/slam/simultaneous.py": 23982,
   "scripts/multi_dataset/features/wavelength_dependence/__init__.py": 0,
-  "scripts/multi_dataset/features/wavelength_dependence/modeling.py": 10825,
-  "scripts/multi_dataset/features/wavelength_dependence/simulator.py": 9037,
-  "scripts/multi_dataset/modeling.py": 17322,
-  "scripts/multi_dataset/plot.py": 7315,
-  "scripts/multi_dataset/simulator.py": 9479,
-  "scripts/multi_dataset/start_here.py": 19867,
+  "scripts/multi_dataset/features/wavelength_dependence/modeling.py": 10881,
+  "scripts/multi_dataset/features/wavelength_dependence/simulator.py": 9061,
+  "scripts/multi_dataset/modeling.py": 17346,
+  "scripts/multi_dataset/plot.py": 7347,
+  "scripts/multi_dataset/simulator.py": 9503,
+  "scripts/multi_dataset/start_here.py": 19875,
   "scripts/multi_galaxy/__init__.py": 0,
   "scripts/multi_galaxy/features/__init__.py": 0,
   "scripts/multi_galaxy/features/extra_galaxies/__init__.py": 0,
   "scripts/multi_galaxy/features/extra_galaxies/modeling.py": 15650,
   "scripts/multi_galaxy/features/extra_galaxies/simulator.py": 10059,
+  "scripts/multi_galaxy/features/extra_galaxies/slam.py": 22490,
+  "scripts/multi_galaxy/features/linear_light_profiles/__init__.py": 0,
+  "scripts/multi_galaxy/features/linear_light_profiles/fit.py": 11477,
+  "scripts/multi_galaxy/features/linear_light_profiles/likelihood_function.py": 13947,
+  "scripts/multi_galaxy/features/linear_light_profiles/modeling.py": 14887,
+  "scripts/multi_galaxy/features/linear_light_profiles/slam.py": 19308,
+  "scripts/multi_galaxy/features/multi_gaussian_expansion/__init__.py": 0,
+  "scripts/multi_galaxy/features/multi_gaussian_expansion/fit.py": 10772,
+  "scripts/multi_galaxy/features/multi_gaussian_expansion/likelihood_function.py": 12672,
+  "scripts/multi_galaxy/features/multi_gaussian_expansion/modeling.py": 14885,
+  "scripts/multi_galaxy/features/multi_gaussian_expansion/simulator.py": 10154,
+  "scripts/multi_galaxy/features/multi_gaussian_expansion/slam.py": 17869,
+  "scripts/multi_galaxy/features/multi_gaussian_expansion/source_science.py": 9833,
+  "scripts/multi_galaxy/features/no_lens_light/__init__.py": 0,
+  "scripts/multi_galaxy/features/no_lens_light/modeling.py": 15086,
+  "scripts/multi_galaxy/features/no_lens_light/simulator.py": 12776,
+  "scripts/multi_galaxy/features/no_lens_light/slam.py": 17293,
   "scripts/multi_galaxy/features/scaling_relation/__init__.py": 0,
-  "scripts/multi_galaxy/features/scaling_relation/fit.py": 10065,
-  "scripts/multi_galaxy/features/scaling_relation/likelihood_function.py": 9523,
-  "scripts/multi_galaxy/features/scaling_relation/modeling.py": 12918,
-  "scripts/multi_galaxy/features/scaling_relation/simulator.py": 9705,
-  "scripts/multi_galaxy/features/scaling_relation/slam.py": 32383,
+  "scripts/multi_galaxy/features/scaling_relation/fit.py": 10209,
+  "scripts/multi_galaxy/features/scaling_relation/likelihood_function.py": 9769,
+  "scripts/multi_galaxy/features/scaling_relation/modeling.py": 13509,
+  "scripts/multi_galaxy/features/scaling_relation/simulator.py": 9887,
+  "scripts/multi_galaxy/features/scaling_relation/slam.py": 35494,
   "scripts/multi_galaxy/fit.py": 26174,
   "scripts/multi_galaxy/likelihood_function.py": 28830,
-  "scripts/multi_galaxy/modeling.py": 46981,
+  "scripts/multi_galaxy/modeling.py": 47036,
   "scripts/multi_galaxy/plot.py": 7858,
   "scripts/multi_galaxy/simulator.py": 19058,
   "scripts/multi_galaxy/simulator_sample.py": 12601,
+  "scripts/multi_galaxy/slam.py": 26113,
   "scripts/multi_galaxy/source_science.py": 16739,
   "scripts/multi_galaxy/start_here.py": 30033,
   "scripts/point_source/__init__.py": 0,
@@ -369,33 +387,33 @@
   "scripts/point_source/features/extra_galaxies/__init__.py": 0,
   "scripts/point_source/features/extra_galaxies/modeling.py": 19537,
   "scripts/point_source/features/extra_galaxies/simulator.py": 14376,
-  "scripts/point_source/features/fluxes.py": 7398,
+  "scripts/point_source/features/fluxes.py": 8825,
   "scripts/point_source/features/multiple_sources/__init__.py": 0,
-  "scripts/point_source/features/multiple_sources/modeling.py": 13008,
-  "scripts/point_source/features/multiple_sources/simulator.py": 10262,
+  "scripts/point_source/features/multiple_sources/modeling.py": 13048,
+  "scripts/point_source/features/multiple_sources/simulator.py": 10270,
   "scripts/point_source/features/scaling_relation/__init__.py": 0,
-  "scripts/point_source/features/scaling_relation/fit.py": 8974,
-  "scripts/point_source/features/scaling_relation/likelihood_function.py": 8916,
+  "scripts/point_source/features/scaling_relation/fit.py": 9530,
+  "scripts/point_source/features/scaling_relation/likelihood_function.py": 8936,
   "scripts/point_source/features/scaling_relation/modeling.py": 13488,
   "scripts/point_source/features/scaling_relation/simulator.py": 11704,
-  "scripts/point_source/features/time_delays.py": 8936,
-  "scripts/point_source/fit.py": 28476,
-  "scripts/point_source/modeling.py": 24900,
-  "scripts/point_source/plot.py": 4530,
+  "scripts/point_source/features/time_delays.py": 10230,
+  "scripts/point_source/fit.py": 31250,
+  "scripts/point_source/modeling.py": 25219,
+  "scripts/point_source/plot.py": 4918,
   "scripts/point_source/simulator.py": 22113,
   "scripts/point_source/simulator_sample.py": 10427,
-  "scripts/point_source/start_here.py": 27156,
+  "scripts/point_source/start_here.py": 27172,
   "scripts/weak/__init__.py": 0,
   "scripts/weak/features/__init__.py": 0,
   "scripts/weak/features/strong_lensing/__init__.py": 0,
   "scripts/weak/features/strong_lensing/a2744.py": 11339,
   "scripts/weak/features/strong_lensing/fit.py": 5204,
-  "scripts/weak/features/strong_lensing/modeling.py": 8256,
+  "scripts/weak/features/strong_lensing/modeling.py": 8272,
   "scripts/weak/features/strong_lensing/simulator.py": 6461,
   "scripts/weak/fit.py": 7595,
   "scripts/weak/likelihood_function.py": 10693,
   "scripts/weak/modeling.py": 12975,
-  "scripts/weak/plot.py": 4741,
+  "scripts/weak/plot.py": 5749,
   "scripts/weak/real_data/__init__.py": 0,
   "scripts/weak/real_data/a2744.py": 11906,
   "scripts/weak/simulator.py": 8318,

llms-full.txt

@@ -410,7 +410,7 @@ AUTO-GENERATED by PyAutoHands — do not edit by hand; regenerate with generate.
 - [Modeling: Time Delays](scripts/point_source/features/time_delays.py): A measurable quantity of a point source is its time delay—the time it takes for light to travel from the source to the observer for each multiple image of the point source (e.g., the quasar images). This is often expressed as the relative time delay between each image and the image with the shortest time delay, which is often referred to as the "reference image."
   - Contents: Model, Dataset, Point Solver, Search, Analysis, Run Times, Result, Cosmology
 - [Guide: Point Sources](scripts/point_source/fit.py): --------------------
-  - Contents: Lensed Point Source, Point Source, Point Solver, Number of Solutions, Solving the Lens Equation, Triangle Tracing, Dataset, Name Pairing, Fitting, Chi Squared, Fluxes, Flux Point Dataset, Flux Fitting, Time Delays, Time Delay Fitting, New User Wrap Up, Shape Solver
+  - Contents: Lensed Point Source, Point Source, Point Solver, Number of Solutions, Solving the Lens Equation, Triangle Tracing, Dataset, Name Pairing, Fitting, Chi Squared, Solved Source Centre, Fluxes, Flux Point Dataset, Flux Fitting, Time Delays, Time Delay Fitting, New User Wrap Up, Shape Solver
 - [Modeling: Start Here](scripts/point_source/modeling.py): This script is the starting point for lens modeling of point-source lens datasets, for example the multiple image positions of a lensed quasar.
   - Contents: Not Using Light Profiles, Model, Dataset, Point Solver, Model Composition, Name Pairing, Coordinates, Search, Unique Identifier, Live Visual Update, Chi Squared, Analysis, JAX, VRAM Use, Run Times, Output Folder Layout, Result, Results, Modeling Customization
 - [Plots: Point Source](scripts/point_source/plot.py): This example shows how to plot a `PointDataset` and a `FitPointDataset` fit.

notebooks/cluster/lenstool/modeling.ipynb

@@ -37,6 +37,9 @@
     "    ``arcs.dat``                        ``point_datasets.csv`` \u2192 ``al.PointDataset`` list\n",
     "    sigposArcsec                        ``positions_noise`` column (same chi-squared)\n",
     "    source-plane optimization           ``al.FitPositionsSource`` (this script)\n",
+    "                                        (``al.FitPositionsSourceSolved`` solves the source centre\n",
+    "                                        analytically; its ``weighting = \"magnification\"`` option\n",
+    "                                        matches Lenstool's scalar \u00b5\u00b2 convention \u2014 see guides)\n",
     "    image-plane optimization            ``al.FitPositionsImagePair*`` (heavier; see guides)\n",
     "    ``best.par``                        the max-likelihood instance of the PyAutoLens fit\n",
     "\n",