Files
muSRFlow/docs/source/images
..
2026-11-03 17:28:00 +01:00

Documentation illustrations
===========================

The PNG screenshots show the actual browser interface from muSRFlow 1.0.0
(source commit 12ecbf4), captured locally with Chrome. They are not mockups.
Only the app panel is captured, excluding browser chrome and unused space.
No fit was performed and no run data was downloaded.

To refresh the screenshots:
1. Open the local web interface in a clean browser profile.
2. Use a 1960 x 700 CSS-pixel viewport (capture scale: 1.5).
3. Enter run 514, year 2025, instrument LEM. Keep the default exponential
   cosine model and initial parameters; do not press Fit or Plot.
4. Capture the appShell panel in Runs and Parameters.
5. In MSR Editor, choose GUI -> MSR, then select MSR Editor again and capture
   the panel with the generated, unfitted document visible.
6. Check the captions, especially the initial-value versus fitted-value wording.

fit-workflow.svg and execution-locations.svg are editable, hand-authored
workflow diagrams. The PNG copies support the PDF manual; HTML uses SVG.
After changing an SVG, refresh its PNG with librsvg:

  rsvg-convert -w 1560 -o fit-workflow.png fit-workflow.svg
  rsvg-convert -w 1560 -o execution-locations.png execution-locations.svg

Build checks (from the repository root):

  make -C docs html SPHINXOPTS="-W --keep-going"
  make -C docs latexpdf SPHINXOPTS="-W --keep-going"

Keep the diagrams illustrative: do not invent fitted curves or numerical
results. Add real spectrum screenshots only with a verified fit and enough
context to identify the data, model, and whether the plot is before or after fit.

Real-fit result figures
-----------------------

lem2025-singlehist-*.png document the verified single-histogram refits of
LEM 2025 runs 1014-1027 and 1033-1045 on 2026-11-02.
The runs/parameters/editor images are actual browser captures after importing
fits/1014_his.msr. The comparison is the actual application parameter renderer
with dataset1.dat and dataset2.dat, HESSE error bars and blue/red overlays.
Its saved state is plot-state.json in the new example directory.
The spectrum image is direct musrview --png output from 1014_his.msr.

See docs/examples/lem2025-singlehist-energy-scan/README.md and the manual's
LEM single-histogram example chapter for inputs, commands and limitations.
All 27 fits completed; chi2/NDF ranges from 0.933 to 2.003. The raw data are
not distributed. No reference fits in /tmp/lemfit were modified.

The older lem2025-energy-scan images and example directory describe the
original asymmetry fits and must not be labelled single-histogram results.