Files
muSRFlow/docs/source/t0-background.rst
salman 398e282cfc Document multi-group asymmetry fits, parameter NaN guards, and binaries preference
Extend the user manual (preferences, runs-fitting, t0/background), the
MSR-to-GUI synchronization notes, and the changelog with:
- slash-separated forward/backward groups generating one RUN block per group;
- multi-group t0/background and data-range read-back with fail-closed checks;
- the non-finite parameter guard (NaN value keeps the last good value, NaN
  step becomes 1% of the value, NaN/inf bounds are dropped);
- the musrfit binaries directory preference for non-standard tool locations.
2026-09-22 15:35:41 +02:00

28 lines
1.3 KiB
ReStructuredText

t0 / background
===============
The **t0 / bg** tab hosts expert controls used when detector timing or
background behaviour must differ from the normal defaults.
Leave these controls unchanged for standard fits. When you do adjust them,
they are written into the generated MSR like any other setting and take
effect on the next Fit or Plot.
The tab loads its controls from the current MSR document, so editing an
existing document and returning to this tab keeps showing the values that
document actually uses.
Multi-group asymmetry fits
~~~~~~~~~~~~~~~~~~~~~~~~~~
For a multi-group asymmetry fit (``1,2/3,4`` in the **Histograms** field,
see :doc:`runs-fitting`) the groups share the single row of their one
physical run, and a field holds one value per group in group order. When
importing such an MSR, values that agree across the groups collapse into the
tab's common fields and distinct values stay per group (for example
``t0 forward 101 103`` for two groups). A file whose groups disagree in an
inconsistent way - some groups with a ``t0`` and others without, mixed
background modes (a group cannot have both a background range and a fixed
background), or a good-bin data range present for only some groups - is
rejected without modifying the previously stored values, since a guessing
read-back would shift every later group's token.