From 04277cec1af23511fa9dba13cd8d0ccf7fe85756 Mon Sep 17 00:00:00 2001 From: salman Date: Sun, 1 Nov 2026 09:57:06 +0100 Subject: [PATCH] Document LEM parameter plotting in the app with vertical 4:3 panels --- docs/source/parameters-plots.rst | 44 ++++++++++++++++++++------------ 1 file changed, 28 insertions(+), 16 deletions(-) diff --git a/docs/source/parameters-plots.rst b/docs/source/parameters-plots.rst index 6ad75e6..3b177db 100644 --- a/docs/source/parameters-plots.rst +++ b/docs/source/parameters-plots.rst @@ -215,28 +215,40 @@ list for other panels. Worked example: energy scan at two temperatures ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This step-by-step example reproduces the figure below using LEM 2025 data. +This step-by-step example shows how to fit LEM 2025 runs and plot the +resulting parameters in the muSRFlow parameter-plot window. **Step by step** -1. **Select runs.** Load LEM runs for 2025: **data set 1** = runs **1014–1027** (3.8 K) and **data set 2** = runs **1033–1045** (10 K), all with B ≈ 100 G. -2. **Fit (single histograms).** For each run perform an independent **single hist** fit to a **Gaussian Cosine** model, with the same fit range, packing and LEM detector grouping. Couple the frequency to the field so that **Bfield** is reported by ``msr2data``. -3. **Export parameters.** Produce a parameter ``*.dat`` file for data set 1 and one for data set 2 via ``msr2data`` / the parameter export workflow. Each row gives implantation **energy**, **Bfield** (or **B**), **Sgm** (Gaussian relaxation rate σ), **Asy** (initial asymmetry A₀) and their uncertainties. -4. **Plot together.** Open the **Parameter plots** window and overlay the two files. Put **field/Bfield**, **sigma/Sgm** and **initial asymmetry/Asy** on three separate panels (or use the ``tf-scan`` template). Display data set 1 in **blue** and data set 2 in **red** on the same panels with implantation **energy** (keV) on the X axis. +1. **Select runs.** In **Runs and fitting**, load LEM 2025: **data set 1** + = runs **1014–1027** (3.8 K, superconducting Nb/Al₂O₃) and **data set 2** + = runs **1033–1045** (10 K, normal state), all with B ≈ 100 G. +2. **Fit (single histograms).** For each run run an independent **single + hist** fit using the **Gaussian Cosine** model. Use the same fit range, + packing and LEM detector grouping (:doc:`runs-fitting`). Couple the + frequency to the field so **Bfield** is reported by ``msr2data``. +3. **Open parameter plots.** Click **Parameter plots** to open the + parameter-plot window. Load/add the two exported parameter files (one per + data set). Use **Select parameters** (or the parameter list) to choose + **Bfield** (field), **Sgm** (Gaussian relaxation rate σ) and **Asy** + (initial asymmetry A₀) for plotting. Assign each parameter to its own panel. +4. **Lay out vertically with 4:3 aspect.** Arrange the three panels in a + vertical stack. Keep each panel at **4:3** aspect ratio (use the panel + layout/resize controls) so the traces remain readable. Overlay data set 1 + (blue) and data set 2 (red) on the same panels, with implantation + **energy** (keV) on the X axis. -.. figure:: images/lem2025-energy-scan.png - :alt: Fitted magnetic field, Gaussian relaxation rate and initial asymmetry versus implantation energy for 85 nm Nb/Al2O3 at 3.8 K (blue) and 10 K (red). +.. figure:: images/lem2025-energy-scan-app.png + :alt: muSRFlow parameter-plot window showing field, Gaussian sigma and initial asymmetry versus implantation energy for LEM 2025 runs 1014-1027 (blue, 3.8 K) and 1033-1045 (red, 10 K) in three vertical 4:3 panels. :width: 100% - Real Gaussian-cosine fits of a LEM 2025 energy scan on 85 nm Nb/Al₂O₃ at - B ≈ 100 G. Data set 1 (runs 1014–1027, 3.8 K, blue) is superconducting and - its field is screened below the applied value; data set 2 (runs 1033–1045, - 10 K, red) is in the normal state with a flat field. **B**, **σ**, and - **A₀** share one panel each, with the two scans overlaid in the same - blue/red pairing the parameter-plot window gives to two overlaid - ``*.dat`` files. This is a fit result, not a screenshot of the application. - The exact fits, run files, and reproduction scripts are in - ``docs/examples/lem2025-energy-scan``. + Parameter plots in the muSRFlow application for a LEM 2025 energy scan + (85 nm Nb/Al₂O₃, B ≈ 100 G). Data set 1 (runs 1014–1027, 3.8 K, blue) + and data set 2 (runs 1033–1045, 10 K, red) are overlaid on the same + panels for **Bfield**, **Sgm** (σ) and **Asy** (A₀) versus implantation + energy (keV). The three panels are stacked vertically with 4:3 aspect + ratio. This is a screenshot of the application; the reproduction details + and exported parameter files are in ``docs/examples/lem2025-energy-scan``. Editing trace styles ~~~~~~~~~~~~~~~~~~~~