Beta calibration

For scripts, CalibrationOptions(method="tf_calibration_fit", fit_beta=True, count_packing=4) sums four native bins per fitted observation and retains the joint alpha/beta covariance. Calibration packing is independent of science reduction; see Explicit workflow and CLI calibration for precedence, time selection, and a complete example.

Joint TF beta calibration accepts the same fixed supplied double-pulse response as alpha-only TF calibration. Time response defaults to Off; choose Fixed double pulse and supply Pulse separation in µs. Beta scales only the backward polarisation, independently of pulse strength and the stretched shape exponent. All nuisances share one covariance, conditional on the fixed source settings. The count-centre approximation and causal source contract are described in Alpha calibration. The compatibility API estimate_beta_detailed(..., method="count_fit", pulse_separation_us=...) delegates to that TF operation; the independent single-histogram protocol does not consume this setting.

The corrected asymmetry

\[A(t) = \frac{F(t) - \alpha B(t)}{\beta F(t) + \alpha B(t)}\]

carries a second detector-balance constant, \(\beta = A_{0,b}/A_{0,f}\), alongside \(\alpha\) — musrfit’s asymmetry-fit (fit type 2) correction pair. Where \(\alpha\) balances the two groups’ count rates (efficiency and solid angle), \(\beta\) balances their asymmetry amplitudes: a detector pair can see the same number of counts (\(\alpha = 1\)) yet report different oscillation amplitudes because of geometric or absorption effects that scale the observable polarisation without touching the count total. See Conventions and implementation notes for the full convention and its \(\alpha\) companion, Alpha calibration.

\(\beta = 1\) is the standard formula and the default; a project that never measures \(\beta\) behaves exactly as before.

Why beta needs a fit, not a count ratio

Beta describes the relative polarisation magnitudes in the two detector groups. Integrated counts alone cannot generally separate it from alpha and the physical polarisation. The implemented calibration fits a resolved weak-TF signal on the same sample and mounting, recovering the two amplitudes. It requires precession and reports failure when that signal cannot be resolved. This is a limitation of this fit, not a statement that beta cannot affect LF/ZF observations: for fixed F, B, and alpha, the corrected asymmetry above generally changes with beta even without precession. Other models require their own identifiability assessment.

In the grouping dialog select TF calibration fit and check Calibrate β in the shared calibration section. Estimate calibration updates both draft spinboxes and the preview, showing the selected envelope and conditional errors. The method beside beta stays until its value is edited, then reads manual. Apply commits the pair through one captured calibration record. Leave the checkbox unchecked for beta fixed at one. Quick methods disable and uncheck it; vector layouts retain one alpha per projection and beta fixed at one. A manual beta can still be entered in the beta card. Loading saved values never fits them.

For TF calibration with beta fixed at one, the spinbox label reads fixed, including after reopening it. A fitted beta of one retains its calibration method; changing the coefficient by hand changes the label to manual.

The API also retains the explicit single-histogram ratio cross-check described below; the GUI uses the shared TF operation with automatic envelope selection.

Count fit

Count fit (recommended) (method id count_fit) fits the forward and backward count histograms simultaneously, with a single \(\beta\) scaling only the backward polarisation term:

\[\begin{split}N_f(t) &= N_0\sqrt{\alpha}\, e^{-t/\tau_\mu}\left[1 + A P(t)\right] + b_f \\ N_b(t) &= \frac{N_0}{\sqrt{\alpha}}\, e^{-t/\tau_\mu}\left[1 - \beta A P(t)\right] + b_b\end{split}\]

with \(P(t)\) a damped-cosine precession. \(N_0\), \(\alpha\), \(\beta\), the amplitude, and the precession frequency/damping/phase are shared free parameters; each side keeps its own background. The joint fit reports \(\beta\), \(\alpha\), and their fitted correlation under the shared model. This retains their fitted dependence; it does not establish universal precision or model adequacy relative to independent histogram fits.

Raw counts use a shared Poisson likelihood. Applied File/manual deadtime correction selects weighted count fitting with retained measured or supplied independent variances, through the same model and solver. A skipped optional File correction retains raw Poisson observations and its warning/provenance. Backgrounds remain automatic model terms; grouping background subtraction is not applied to these observations. See Alpha calibration for selection, supported observations, and conditional-error limits.

The scriptable fit_tf_calibration() operation owns this joint fit. Its TFCalibrationRequest(fit_beta=False) fixes beta at one in the same physical model for alpha-only calibration; fit_beta=True frees it. The convenience estimate_beta_detailed(method="count_fit") delegates to that operation while retaining its historical result fields and method key.

Asymmetry also checks that free-beta calibration has a resolved amplitude and frequency: each must reach the existing three-standard-error significance gate (the amplitude helper retains its small nonzero fallback when an error is absent). For fitted frequency, a missing frequency error makes calibration unavailable. An explicitly fixed finite positive frequency is instead an independently supplied model assumption: only its fitted-frequency significance test is omitted, while the amplitude and reliable-beta-error checks remain. The estimator never fixes frequency automatically. A missing reliable beta error makes calibration unavailable, with a diagnostic. These are safeguards for this weak-TF protocol, not universal identifiability tests or thresholds attributed to musrfit/WiMDA. They do not apply automatically to alpha-only calibration with beta fixed.

Single-histogram ratio

Single-histogram ratio (method id single_histogram) instead fits the forward and backward histograms independently — each its own \(N_0\), background, amplitude, frequency, damping and phase, with no physics shared between them — and forms

\[\hat\beta = \frac{\hat A_{0,b}}{\hat A_{0,f}}, \qquad \sigma_\beta = \hat\beta \sqrt{\left(\frac{\sigma_{A_f}}{\hat A_{0,f}}\right)^2 + \left(\frac{\sigma_{A_b}}{\hat A_{0,b}}\right)^2}\]

by ratio (the fitted \(\hat\alpha = \hat N_{0,f}/\hat N_{0,b}\) is reported the same way). This is first-order propagation of fitted amplitude errors under the independent-bank assumption. The result reports no \(\alpha\)–\(\beta\) correlation (None in BetaEstimate); this does not assert that the two derived ratios are independent. It provides a model cross-check whose precision and bias depend on the fitted assumptions.

Applying the joint result

Alpha and beta refer to the same count fit and shared covariance. Apply uses both coefficients from that record. A fixed-beta calibration applies beta one, even when a manual or historical nonunity beta is present. The result displays fixed, fitted, and unavailable-error states distinctly; missing covariance does not by itself make an otherwise usable alpha-only fit fail.

Reduced-curve errors remain conditional on the applied alpha/beta, even when the calibration record carries errors and covariance. Shared correction terms in marginal point errors do not make an ordinary fit a correlated likelihood; see Calibration conditioning and Errors.

Instrument guidance

\(\beta\) is broadly an instrument-dependent property of a detector pair — a fact about the geometry and absorption of that pair, not about the sample — so, unlike \(\alpha\), it does not need to be remeasured for every sample mounting. Typical values sit close to but below 1: around 0.8–0.9 on PSI’s FLAME, and just under 1 on GPS. A fitted \(\hat\beta\) outside \([0.5, 1.5]\) is flagged as suspicious in the result row — worth checking the fit before applying it, since typical instruments sit comfortably inside that range.

Uncertainties

The joint protocol reports symmetric curvature standard errors; the single-histogram ratios use first-order propagation of fitted errors. The joint operation explicitly evaluates HESSE after minimisation; the independent single-histogram cross-check retains its optimiser covariance. For the count fit, \(\sigma_\beta\) and \(\sigma_\alpha\) come directly from the joint fit’s covariance, together with their correlation; for the single-histogram ratio, they are propagated from the two independent fits’ amplitude (and \(N_0\)) errors by the standard ratio-error formula above, and no correlation is available. As with \(\alpha\), the provenance recorded on the profile — method, source run, and error — lets a re-opened project show exactly how its \(\beta\) was obtained, and the estimate goes stale (the same staleness convention as \(\alpha\)) when the deadtime or background corrections change after it was measured, since \(\beta\) was fitted on the counts those corrections produced.

The full joint parameter/covariance owner includes both backgrounds and every other nuisance. Errors and alpha–beta correlation derive from that matrix; unavailable/unreliable covariance supplies no coefficient error. The legacy reduced_chi2 field for count_fit contains the selected objective divided by joint degrees of freedom, counting shared free parameters once: Poisson deviance for raw data or weighted chi-square after applied deadtime correction. Neither is used to rescale parameter errors; Poisson deviance is not an exact chi-square test. Estimate plus or minus one standard error has an approximately 68.27 % normal reference, without an exact coverage guarantee. Optional MINOS signed offsets are separate profile intervals at a unit-objective change, with validity and availability distinct from HESSE. Neither incorporates envelope selection, uncertain fixed response, or full deadtime-process uncertainty. Weak contrast, boundaries, and misspecification require particular care; a successful minimum alone establishes none of these inference properties. See Alpha calibration for supported observations, fixed-beta error state, cancellation, and conditional-error limits.

Compared with other programs

musrfit’s Single Histograms tutorial describes simultaneous histogram calibration, including shared alpha/beta parameters. Its examples also illustrate Gaussian damping and separate detector phases; those choices are distinct from this exponential/common-phase model. Matched global histogram likelihood controls in musrfit 1.12.1 (708f777b, ROOT 6.40.04) agree in fixed/free-beta point estimates within 0.0001 absolute alpha/beta. Here alpha is \(N_F/N_B\), reciprocal to the compared native parameter, while beta is the same backward/forward amplitude ratio. The native type-2 asymmetry chi-square route has a different objective.

The installed native likelihood route reports errors approximately \(1/\sqrt{2}\) of the independently checked conventional Poisson standard errors. Asymmetry does not copy that scale; see Asymmetry in the μSR software landscape for the one-normalisation control and its limits. WiMDA quick Diamagnetic is a different point objective. Native WiMDA paired-count model-fit errors are not verified by these checks. Mantid AlphaCalc is the separate ratio comparator.

The separate script operation select_tf_calibration() compares four common-phase envelopes with beta fixed or free. Its dimensionless stretch exponent is distinct from detector beta; candidate errors retain all fitted nuisance correlations and are conditional on that envelope. See Alpha calibration for summed-cost ranking, constraints, candidate failures, and reference component comparisons. The historical count_fit adapter keeps its exponential model.

References

Stored joint calibration

When a shared TF result is applied through the core grouping-profile API, beta and alpha refer to the same frozen fit and nuisance covariance. Fixed beta has no fitted error or correlation. Replacing beta with a manual policy removes its active joint link while keeping the captured fit in profile history. Captured TF source context retains the consumed bank membership and authored channel exclusions independently of subsequent grouping edits. Stored independent scalar alpha and beta records do not imply a joint measurement, even when their source runs match. See Project files.

Workflow application

asymmetry alpha --calibration-method tf_calibration_fit --fit-beta and reduce --alpha-from RUN with those options use the same joint TF solver. Without --fit-beta the request fixes beta at one, without a fitted error or alpha/beta correlation. Applying the captured record replaces both coefficient policies, including fixed beta one, and retains their common full covariance and conditional error meaning in the workflow workdir. See Scripting and AI-agent workflow for source-period and envelope options. Reduced-signal errors retain the existing conditional counting convention.