Add real pre-fit UI screenshots, workflow diagrams, accessible captions, and image maintenance instructions. Correct run-count examples and rebuild the tracked HTML and PDF manuals. Deploy the complete generated HTML manual with readable permissions. Check for missing documentation before modifying installed files and cover deployment, updates, and missing-doc failures with regression tests.
349 lines
26 KiB
HTML
349 lines
26 KiB
HTML
|
|
|
|
<!DOCTYPE html>
|
|
<html class="writer-html5" lang="en" data-content_root="./">
|
|
<head>
|
|
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
<title>Runs and fitting — muSRFlow User Manual</title>
|
|
<link rel="stylesheet" type="text/css" href="_static/pygments.css?v=b86133f3" />
|
|
<link rel="stylesheet" type="text/css" href="_static/css/theme.css?v=d11f710b" />
|
|
|
|
|
|
<script src="_static/jquery.js?v=5d32c60e"></script>
|
|
<script src="_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
|
|
<script src="_static/documentation_options.js?v=8085e645"></script>
|
|
<script src="_static/doctools.js?v=9bcbadda"></script>
|
|
<script src="_static/sphinx_highlight.js?v=dc90522c"></script>
|
|
<script src="_static/js/theme.js"></script>
|
|
<link rel="index" title="Index" href="genindex.html" />
|
|
<link rel="search" title="Search" href="search.html" />
|
|
<link rel="next" title="Parameters and parameter plots" href="parameters-plots.html" />
|
|
<link rel="prev" title="Linux installation" href="install-linux.html" />
|
|
</head>
|
|
|
|
<body class="wy-body-for-nav">
|
|
<div class="wy-grid-for-nav">
|
|
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
|
|
<div class="wy-side-scroll">
|
|
<div class="wy-side-nav-search" >
|
|
|
|
|
|
|
|
<a href="index.html" class="icon icon-home">
|
|
muSRFlow
|
|
</a>
|
|
<div role="search">
|
|
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
|
|
<input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
|
|
<input type="hidden" name="check_keywords" value="yes" />
|
|
<input type="hidden" name="area" value="default" />
|
|
</form>
|
|
</div>
|
|
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
|
|
<p class="caption" role="heading"><span class="caption-text">Contents</span></p>
|
|
<ul class="current">
|
|
<li class="toctree-l1"><a class="reference internal" href="overview.html">Overview</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="getting-started.html">Getting started</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="install-windows.html">Windows installation</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="install-linux.html">Linux installation</a></li>
|
|
<li class="toctree-l1 current"><a class="current reference internal" href="#">Runs and fitting</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="#run-selection">Run selection</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="#fit-range">Fit range</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="#fit-model">Fit model</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="#fit-options">Fit options</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="#series-fit-actions">Series fit actions</a><ul>
|
|
<li class="toctree-l3"><a class="reference internal" href="#per-run-statistics">Per-run statistics</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l2"><a class="reference internal" href="#view-settings">View settings</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="#fit-and-plot">Fit and Plot</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="parameters-plots.html">Parameters and parameter plots</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="constraints.html">Constraints</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="t0-background.html">t0 / background</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="msr-editor.html">MSR editor</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="results-diagnostics.html">Results and diagnostics</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="configuration-sharing.html">Configuration sharing</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="preferences.html">Preferences</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="platforms.html">Web and desktop editions</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="keyboard-shortcuts.html">Keyboard shortcuts</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="glossary.html">Glossary</a></li>
|
|
</ul>
|
|
|
|
</div>
|
|
</div>
|
|
</nav>
|
|
|
|
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
|
|
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
|
|
<a href="index.html">muSRFlow</a>
|
|
</nav>
|
|
|
|
<div class="wy-nav-content">
|
|
<div class="rst-content">
|
|
<div role="navigation" aria-label="Page navigation">
|
|
<ul class="wy-breadcrumbs">
|
|
<li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
|
|
<li class="breadcrumb-item active">Runs and fitting</li>
|
|
<li class="wy-breadcrumbs-aside">
|
|
<a href="_sources/runs-fitting.rst.txt" rel="nofollow"> View page source</a>
|
|
</li>
|
|
</ul>
|
|
<hr/>
|
|
</div>
|
|
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
<div itemprop="articleBody">
|
|
|
|
<section id="runs-and-fitting">
|
|
<h1>Runs and fitting<a class="headerlink" href="#runs-and-fitting" title="Link to this heading"></a></h1>
|
|
<p>The <strong>Runs</strong> tab holds everything that selects and describes the data: the
|
|
run list, the fit range, the fit model, the fit options, and the view
|
|
settings used for Plot, FFT, and RRF.</p>
|
|
<section id="run-selection">
|
|
<h2>Run selection<a class="headerlink" href="#run-selection" title="Link to this heading"></a></h2>
|
|
<dl>
|
|
<dt>Run(s)</dt><dd><p>One or more runs, separated by commas. A dash selects a contiguous
|
|
range and a colon-with-step <code class="docutils literal notranslate"><span class="pre">from:to:step</span></code> produces a regular
|
|
sequence, for example <code class="docutils literal notranslate"><span class="pre">520:540:2</span></code>.</p>
|
|
<p>Each comma- or range-separated data set is fit independently and merged
|
|
into one fit document, so <code class="docutils literal notranslate"><span class="pre">514,</span> <span class="pre">516,</span> <span class="pre">520-525</span></code> prepares eight data sets.</p>
|
|
<p>A <code class="docutils literal notranslate"><span class="pre">+</span></code> between runs adds the run to the previous data set via the MSR
|
|
<code class="docutils literal notranslate"><span class="pre">ADDRUN</span></code> directive rather than starting a new data set. <code class="docutils literal notranslate"><span class="pre">514+515</span></code> is
|
|
a single data set composed of two runs.</p>
|
|
<p>Examples:</p>
|
|
<ul class="simple">
|
|
<li><p><code class="docutils literal notranslate"><span class="pre">514</span></code> – one run.</p></li>
|
|
<li><p><code class="docutils literal notranslate"><span class="pre">514,</span> <span class="pre">520-525</span></code> – seven data sets: 514 and each of 520..525.</p></li>
|
|
<li><p><code class="docutils literal notranslate"><span class="pre">514+515,</span> <span class="pre">520:540:2</span></code> – one ADDRUN data set and a stepped range.</p></li>
|
|
</ul>
|
|
</dd>
|
|
<dt>Year</dt><dd><p>The data-taking year. The year range starts at 1998 and cannot exceed the
|
|
current year.</p>
|
|
</dd>
|
|
<dt>Instrument</dt><dd><p>The spectrometer. The exact choice (for example LTF, FLAME, LEM, GPS,
|
|
GPD, Dolly, VMS, HAL) depends on the data tree your installation exposes.</p>
|
|
</dd>
|
|
</dl>
|
|
<p>The path shown in the resolution warning below the row confirms that the
|
|
chosen runs resolve to real data files; a successful resolution is silent.</p>
|
|
</section>
|
|
<section id="fit-range">
|
|
<h2>Fit range<a class="headerlink" href="#fit-range" title="Link to this heading"></a></h2>
|
|
<ul class="simple">
|
|
<li><p><strong>From / To</strong> – the time window in microseconds that is actually fit
|
|
(default <code class="docutils literal notranslate"><span class="pre">0</span></code> to <code class="docutils literal notranslate"><span class="pre">8</span></code>).</p></li>
|
|
<li><p><strong>Packing</strong> – the time-binning factor used for the fit (default <code class="docutils literal notranslate"><span class="pre">100</span></code>).</p></li>
|
|
</ul>
|
|
</section>
|
|
<section id="fit-model">
|
|
<h2>Fit model<a class="headerlink" href="#fit-model" title="Link to this heading"></a></h2>
|
|
<dl>
|
|
<dt>Type</dt><dd><p>The fit type. <strong>Asymmetry</strong> is the normal choice for a summed forward
|
|
plus backward count rate. <strong>Single hist</strong> fits a single histogram. The
|
|
legacy <strong>Asymmetry (Legacy)</strong> variant is kept for old MSR files that used
|
|
the classic syntax but is not offered for new documents.</p>
|
|
</dd>
|
|
<dt>Histograms</dt><dd><p>The detector histograms, or a packed detector name, that make up the
|
|
asymmetry signal.</p>
|
|
<p>An <strong>Asymmetry</strong> fit normally takes one forward,backward pair (for
|
|
example <code class="docutils literal notranslate"><span class="pre">21</span> <span class="pre">25</span></code>). Several <em>groups</em> of one physical run can be fit at
|
|
the same time by entering slash-separated forward,backward pairs, for
|
|
example <code class="docutils literal notranslate"><span class="pre">1,2/3,4</span></code> for two groups (detectors 1 and 2 form the first
|
|
group, 3 and 4 the second). Each group becomes its own RUN block with its
|
|
own <code class="docutils literal notranslate"><span class="pre">alpha</span></code> and phase, and the groups scale a shared free amplitude by
|
|
individual ratios (the first group keeps the fixed identity factor). The
|
|
parameter table carries a per-group <code class="docutils literal notranslate"><span class="pre">Alpha</span></code>, <code class="docutils literal notranslate"><span class="pre">Phi</span></code>, and ratio; the
|
|
physical model parameters stay shared. Multi-component models and per-run
|
|
pairs of a multi-run (global) fit are not eligible for the multi-group
|
|
route.</p>
|
|
</dd>
|
|
<dt>Components</dt><dd><p>The theory model is a sum of components. The first component is labelled
|
|
<strong>Model</strong> and is required; further components are added with <code class="docutils literal notranslate"><span class="pre">+</span></code> and
|
|
can be removed with the <code class="docutils literal notranslate"><span class="pre">x</span></code> on their row. Each component has its own
|
|
parameter set, shown in the <strong>Parameters</strong> tab.</p>
|
|
<p>The component list is grouped by physics:</p>
|
|
<ul class="simple">
|
|
<li><p><strong>Relaxation</strong> – <code class="docutils literal notranslate"><span class="pre">Asymmetry</span></code>, <code class="docutils literal notranslate"><span class="pre">Exponential</span></code>, <code class="docutils literal notranslate"><span class="pre">Gaussian</span></code>,
|
|
<code class="docutils literal notranslate"><span class="pre">Stretch</span></code>.</p></li>
|
|
<li><p><strong>Static KT</strong> – <code class="docutils literal notranslate"><span class="pre">SLKT</span></code>, <code class="docutils literal notranslate"><span class="pre">SGKT</span></code>, <code class="docutils literal notranslate"><span class="pre">LGKT</span></code>, <code class="docutils literal notranslate"><span class="pre">STRKT</span></code>, <code class="docutils literal notranslate"><span class="pre">GBGZF</span></code>.</p></li>
|
|
<li><p><strong>Oscillating</strong> – <code class="docutils literal notranslate"><span class="pre">ExponentialCos</span></code>, <code class="docutils literal notranslate"><span class="pre">GaussianCos</span></code>, <code class="docutils literal notranslate"><span class="pre">StretchCos</span></code>,
|
|
<code class="docutils literal notranslate"><span class="pre">AbragamCos</span></code>, <code class="docutils literal notranslate"><span class="pre">GBGCos</span></code>, <code class="docutils literal notranslate"><span class="pre">ExponentialBessel</span></code>, <code class="docutils literal notranslate"><span class="pre">GaussianBessel</span></code>.</p></li>
|
|
<li><p><strong>KT x relaxation</strong> – combined Kubo-Toyabe and relaxation functions,
|
|
e.g. <code class="docutils literal notranslate"><span class="pre">LLFExp</span></code>, <code class="docutils literal notranslate"><span class="pre">GLFExp</span></code>, <code class="docutils literal notranslate"><span class="pre">LGKTExp</span></code>, <code class="docutils literal notranslate"><span class="pre">GBGExp</span></code>, <code class="docutils literal notranslate"><span class="pre">STRKTExp</span></code> and
|
|
their spin-flip variants <code class="docutils literal notranslate"><span class="pre">LLFSExp</span></code>, <code class="docutils literal notranslate"><span class="pre">GLFSExp</span></code>, <code class="docutils literal notranslate"><span class="pre">LGKTSExp</span></code>,
|
|
<code class="docutils literal notranslate"><span class="pre">GBGSExp</span></code>, <code class="docutils literal notranslate"><span class="pre">STRKTSExp</span></code>.</p></li>
|
|
<li><p><strong>Dynamic KT</strong> – <code class="docutils literal notranslate"><span class="pre">LDKTLF</span></code>, <code class="docutils literal notranslate"><span class="pre">GDKTLF</span></code>.</p></li>
|
|
</ul>
|
|
<p>Changing a component rebuilds the parameter table and the constraint
|
|
preview so their contents follow the new model.</p>
|
|
</dd>
|
|
</dl>
|
|
</section>
|
|
<section id="fit-options">
|
|
<h2>Fit options<a class="headerlink" href="#fit-options" title="Link to this heading"></a></h2>
|
|
<ul class="simple">
|
|
<li><p><strong>Minimizer</strong> – Minuit2 strategy variant used by the fit: <code class="docutils literal notranslate"><span class="pre">MINIMIZE</span></code>
|
|
(default), <code class="docutils literal notranslate"><span class="pre">MIGRAD</span></code>, or <code class="docutils literal notranslate"><span class="pre">SIMPLEX</span></code>.</p></li>
|
|
<li><p><strong>Errors</strong> – the error calculation run after the minimisation:
|
|
<code class="docutils literal notranslate"><span class="pre">HESSE</span></code> (default), <code class="docutils literal notranslate"><span class="pre">MINOS</span></code>, <code class="docutils literal notranslate"><span class="pre">HESSE</span> <span class="pre">+</span> <span class="pre">MINOS</span></code>, or <code class="docutils literal notranslate"><span class="pre">None</span></code>.</p></li>
|
|
<li><p><strong>Strategy</strong> – Minuit2 strategy <code class="docutils literal notranslate"><span class="pre">0</span></code>, <code class="docutils literal notranslate"><span class="pre">1</span></code>, <code class="docutils literal notranslate"><span class="pre">2</span></code>, or <strong>Default</strong>
|
|
(leave unspecified).</p></li>
|
|
<li><p><strong>Objective</strong> – <code class="docutils literal notranslate"><span class="pre">χ²</span></code> (default) or <strong>Max likelihood</strong>.</p></li>
|
|
<li><p><strong>Save</strong> – write the detailed Minuit2 output including covariance
|
|
information (on by default).</p></li>
|
|
</ul>
|
|
</section>
|
|
<section id="series-fit-actions">
|
|
<h2>Series fit actions<a class="headerlink" href="#series-fit-actions" title="Link to this heading"></a></h2>
|
|
<p>When two or more independent data sets are fit together <strong>without shared
|
|
parameters</strong>, the fit follows the independent-series route and the <strong>Fit
|
|
options</strong> row gains a per-run action chip for every data set. This is how a
|
|
multi-run series is (re)fitted efficiently without re-fitting runs that have
|
|
not changed.</p>
|
|
<p>Clicking a chip cycles through three actions:</p>
|
|
<ul class="simple">
|
|
<li><p><strong>reuse</strong> – keep the existing fit result for that run.</p></li>
|
|
<li><p><strong>refit</strong> – rebuild the MSR from the live GUI parameters and fit again.</p></li>
|
|
<li><p><strong>skip</strong> – leave the run untouched.</p></li>
|
|
</ul>
|
|
<p>The <strong>All</strong> dropdown applies one action to every chip at once (<strong>Reuse all /
|
|
Refit all / Skip all</strong>), which is the convenient way to set a uniform policy
|
|
and then override single runs by clicking their chip.</p>
|
|
<p>A series where every run is skipped reports <strong>Nothing to fit</strong>. Sharing any
|
|
parameter (the <strong>Shared</strong> column in the parameter table) disables this route
|
|
and the chips disappear; see <a class="reference internal" href="parameters-plots.html"><span class="doc">Parameters and parameter plots</span></a>. The parameter plot is
|
|
unaffected and still works.</p>
|
|
<section id="per-run-statistics">
|
|
<h3>Per-run statistics<a class="headerlink" href="#per-run-statistics" title="Link to this heading"></a></h3>
|
|
<p>For an independent-series fit the status-bar statistic button summarises the
|
|
series – either <strong>Series did not converge</strong> (some runs failed to converge) or
|
|
a worst/best aggregate such as <code class="docutils literal notranslate"><span class="pre">χ²/NDF</span> <span class="pre">worst</span> <span class="pre">1.24</span> <span class="pre">/</span> <span class="pre">best</span> <span class="pre">1.01</span> <span class="pre">·</span> <span class="pre">5</span> <span class="pre">runs</span></code>.
|
|
Clicking the button opens a per-run statistics table that lists every data set
|
|
in run order with:</p>
|
|
<ul class="simple">
|
|
<li><p>the run identifier;</p></li>
|
|
<li><p>the action that produced it (<strong>reuse</strong>, <strong>refit</strong>, or <strong>skip</strong>);</p></li>
|
|
<li><p>the run’s statistic text (χ²/NDF or max likelihood/NDF, or
|
|
<code class="docutils literal notranslate"><span class="pre">Fit</span> <span class="pre">did</span> <span class="pre">not</span> <span class="pre">converge</span></code>);</p></li>
|
|
<li><p>the converged state;</p></li>
|
|
<li><p>the fitted file the value came from.</p></li>
|
|
</ul>
|
|
<p>Reused or skipped runs show the values read from the MSRs already used for
|
|
plotting. Rows are highlighted for contrast: runs whose value is more than
|
|
twice the series median stand out as outliers (the spread a worst/best summary
|
|
might hide), failed runs are marked as not converged, and reused/skipped rows
|
|
that still carry the on-disk value are visually distinct from freshly fitted
|
|
ones.</p>
|
|
</section>
|
|
</section>
|
|
<section id="view-settings">
|
|
<h2>View settings<a class="headerlink" href="#view-settings" title="Link to this heading"></a></h2>
|
|
<p><strong>Plot</strong>, <strong>FFT</strong>, and <strong>RRF</strong> are one-row disclosure buttons; each expands
|
|
its settings inline, and only one group is open at a time. The dots next to
|
|
the buttons mark a group whose settings differ from the defaults.</p>
|
|
<dl class="simple">
|
|
<dt>Plot</dt><dd><ul class="simple">
|
|
<li><p><strong>Time range</strong> – independent start and end of the displayed time
|
|
axis; leaving a field empty selects automatic limits.</p></li>
|
|
<li><p><strong>Y range</strong> – independent displayed Y limits; empty means automatic.</p></li>
|
|
<li><p><strong>View packing</strong> – histogram packaging for the view; empty means
|
|
automatic.</p></li>
|
|
<li><p><strong>Log X / Log Y</strong> – switch the respective displayed axis to a
|
|
logarithmic scale.</p></li>
|
|
<li><p><strong>Lifetime correction</strong> – apply the lifetime correction to the
|
|
displayed spectra (on by default).</p></li>
|
|
</ul>
|
|
</dd>
|
|
<dt>FFT</dt><dd><p>The Fourier-transform display settings:</p>
|
|
<ul class="simple">
|
|
<li><p><strong>Type</strong> – <code class="docutils literal notranslate"><span class="pre">Power</span></code>, <code class="docutils literal notranslate"><span class="pre">Real</span></code>, <code class="docutils literal notranslate"><span class="pre">Imaginary</span></code>, <code class="docutils literal notranslate"><span class="pre">Real</span> <span class="pre">&</span> <span class="pre">imaginary</span></code>,
|
|
or <code class="docutils literal notranslate"><span class="pre">Phase</span></code>.</p></li>
|
|
<li><p><strong>Apodization</strong> – <code class="docutils literal notranslate"><span class="pre">Strong</span></code>, <code class="docutils literal notranslate"><span class="pre">Medium</span></code>, <code class="docutils literal notranslate"><span class="pre">Weak</span></code>, or <code class="docutils literal notranslate"><span class="pre">None</span></code>.</p></li>
|
|
<li><p><strong>Phase</strong> – the phase value or a musrfit phase expression, for
|
|
example <code class="docutils literal notranslate"><span class="pre">8.5</span></code>, <code class="docutils literal notranslate"><span class="pre">par7</span></code>, <code class="docutils literal notranslate"><span class="pre">par(7,5,16)</span></code>, <code class="docutils literal notranslate"><span class="pre">parR(...)</span></code>.</p></li>
|
|
<li><p><strong>DC correct</strong> – remove the time-domain DC offset before the
|
|
transform.</p></li>
|
|
<li><p><strong>Range</strong> – the frequency window used for the transform; empty means
|
|
automatic.</p></li>
|
|
<li><p><strong>Units</strong> – <code class="docutils literal notranslate"><span class="pre">MHz</span></code>, <code class="docutils literal notranslate"><span class="pre">Gauss</span></code> (default), <code class="docutils literal notranslate"><span class="pre">Tesla</span></code>, or <code class="docutils literal notranslate"><span class="pre">Mc/s</span></code>.</p></li>
|
|
<li><p><strong>Power</strong> – the <code class="docutils literal notranslate"><span class="pre">power</span></code> record for the FFT (default <code class="docutils literal notranslate"><span class="pre">12</span></code>).</p></li>
|
|
<li><p><strong>Phase correction</strong> – automatic phase correction <code class="docutils literal notranslate"><span class="pre">Off</span></code>, over the
|
|
<strong>FFT range</strong>, or over a <strong>Custom range</strong> you type below.</p></li>
|
|
</ul>
|
|
</dd>
|
|
<dt>RRF</dt><dd><p>Rotating-reference-frame display settings. They are strictly opt-in:
|
|
opening the settings does not change the generated plot block.</p>
|
|
<ul class="simple">
|
|
<li><p><strong>Enable</strong> – add rotating-reference-frame directives to the PLOT
|
|
block.</p></li>
|
|
<li><p><strong>Frequency</strong> – the reference frequency, with units <code class="docutils literal notranslate"><span class="pre">MHz</span></code>, <code class="docutils literal notranslate"><span class="pre">kHz</span></code>,
|
|
<code class="docutils literal notranslate"><span class="pre">Mc/s</span></code>, <code class="docutils literal notranslate"><span class="pre">Gauss</span></code> (default variety shown as Gauss), or <code class="docutils literal notranslate"><span class="pre">Tesla</span></code>.</p></li>
|
|
<li><p><strong>Packing</strong> – the packing for the RRF view (required when enabled).</p></li>
|
|
<li><p><strong>Phase</strong> – optional phase in degrees, or a parameter reference such
|
|
as <code class="docutils literal notranslate"><span class="pre">par4</span></code>.</p></li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</section>
|
|
<section id="fit-and-plot">
|
|
<h2>Fit and Plot<a class="headerlink" href="#fit-and-plot" title="Link to this heading"></a></h2>
|
|
<p>The two toolbar actions work on the current window state:</p>
|
|
<ul class="simple">
|
|
<li><p><strong>Fit</strong> – validate the run selection, prepare the MSR document from the
|
|
GUI, and run <code class="docutils literal notranslate"><span class="pre">musrfit</span></code>. The fitted values flow back into the parameter
|
|
table and the results.</p></li>
|
|
<li><p><strong>Plot</strong> – validate the run selection, prepare the same MSR document, and
|
|
run <code class="docutils literal notranslate"><span class="pre">musrview</span></code> to display the spectra. On the web the resulting ROOT
|
|
canvas is drawn inside the page window with JSROOT; on the desktop
|
|
<code class="docutils literal notranslate"><span class="pre">musrview</span></code> opens its own native window.</p></li>
|
|
</ul>
|
|
<p>While either action runs, the status bar shows progress and the Results tab
|
|
accumulates the command log. Plot-compatible values are cached so a plot does
|
|
not lose the numerical fit quality already returned by a previous fit.</p>
|
|
<p>On the desktop, a local <strong>Fit</strong> uses every available CPU core by default. Set
|
|
<strong>musrfit threads</strong> in <a class="reference internal" href="preferences.html"><span class="doc">Preferences</span></a> to cap the OpenMP thread count
|
|
(<code class="docutils literal notranslate"><span class="pre">musrfit</span> <span class="pre">-u</span></code>) when a machine is shared or a fit would otherwise saturate
|
|
the login node; leaving it blank keeps the all-cores behaviour. The web
|
|
edition always fits on the server and ignores the setting.</p>
|
|
<p>If the MSR editor owns the document (a hand-edited MSR is authoritative), the
|
|
editor block is used for Fit and Plot as-is and GUI changes do not silently
|
|
replace it – see <a class="reference internal" href="msr-editor.html"><span class="doc">MSR editor</span></a>.</p>
|
|
</section>
|
|
</section>
|
|
|
|
|
|
</div>
|
|
</div>
|
|
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
|
|
<a href="install-linux.html" class="btn btn-neutral float-left" title="Linux installation" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
|
|
<a href="parameters-plots.html" class="btn btn-neutral float-right" title="Parameters and parameter plots" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
|
|
</div>
|
|
|
|
<hr/>
|
|
|
|
<div role="contentinfo">
|
|
<p>© Copyright 2026 Zaher Salman.</p>
|
|
</div>
|
|
|
|
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
|
|
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
|
|
provided by <a href="https://readthedocs.org">Read the Docs</a>.
|
|
|
|
|
|
</footer>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
</div>
|
|
<script>
|
|
jQuery(function () {
|
|
SphinxRtdTheme.Navigation.enable(true);
|
|
});
|
|
</script>
|
|
|
|
</body>
|
|
</html> |