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
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:
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
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
A. Suter and B. M. Wojek, Phys. Procedia 30, 69 (2012) — musrfit, whose asymmetry fit (fit type 2) defines \(\beta\).
musrfit user manual, “Asymmetry Fit (fit type 2)” (<https://lmu.pages.psi.ch/musrfit-docu/user-manual.html>).
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.