684 lines
61 KiB
HTML
684 lines
61 KiB
HTML
|
||
|
||
<!DOCTYPE html>
|
||
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
|
||
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
|
||
<head>
|
||
<meta charset="utf-8">
|
||
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
|
||
<title>musredit: the GUI Based Interface to musrfit — musrfit 1.9.1 documentation</title>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
|
||
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
|
||
<link rel="index" title="Index" href="genindex.html" />
|
||
<link rel="search" title="Search" href="search.html" />
|
||
<link rel="next" title="mupp - μSR Parameter Plotter" href="mupp.html" />
|
||
<link rel="prev" title="Setting up musrfit / DKS: High Speed Fitting with GPU’s" href="setup-dks.html" />
|
||
|
||
|
||
<script src="_static/js/modernizr.min.js"></script>
|
||
|
||
</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"> musrfit
|
||
|
||
|
||
|
||
</a>
|
||
|
||
|
||
|
||
|
||
<div class="version">
|
||
1.9
|
||
</div>
|
||
|
||
|
||
|
||
|
||
<div role="search">
|
||
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
|
||
<input type="text" name="q" placeholder="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="main navigation">
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<ul class="current">
|
||
<li class="toctree-l1"><a class="reference internal" href="cite.html">How to Cite <code class="docutils literal notranslate"><span class="pre">musrfit</span></code>?</a></li>
|
||
<li class="toctree-l1"><a class="reference internal" href="tutorial.html">Tutorial for <code class="docutils literal notranslate"><span class="pre">musrfit</span></code></a></li>
|
||
<li class="toctree-l1"><a class="reference internal" href="user-manual.html">User manual</a></li>
|
||
<li class="toctree-l1"><a class="reference internal" href="user-libs.html">Documentation of user libs (user functions)</a></li>
|
||
<li class="toctree-l1"><a class="reference internal" href="setup-standard.html">Setting up <code class="docutils literal notranslate"><span class="pre">musrfit</span></code> on Different Platforms</a></li>
|
||
<li class="toctree-l1"><a class="reference internal" href="setup-dks.html">Setting up <code class="docutils literal notranslate"><span class="pre">musrfit</span></code> / <code class="docutils literal notranslate"><span class="pre">DKS</span></code>: High Speed Fitting with GPU’s</a></li>
|
||
<li class="toctree-l1 current"><a class="current reference internal" href="#"><code class="docutils literal notranslate"><span class="pre">musredit</span></code>: the GUI Based Interface to <code class="docutils literal notranslate"><span class="pre">musrfit</span></code></a><ul>
|
||
<li class="toctree-l2"><a class="reference internal" href="#introduction">Introduction</a></li>
|
||
<li class="toctree-l2"><a class="reference internal" href="#available-executable-configuration-files-and-their-basic-usage">Available Executable, Configuration Files and their Basic Usage</a><ul>
|
||
<li class="toctree-l3"><a class="reference internal" href="#musredit-musrgui">musredit (musrgui)</a></li>
|
||
<li class="toctree-l3"><a class="reference internal" href="#musredit-startup-xml">musredit_startup.xml</a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toctree-l2"><a class="reference internal" href="#musredit-features">musredit Features</a></li>
|
||
<li class="toctree-l2"><a class="reference internal" href="#id1">musrWiz</a><ul>
|
||
<li class="toctree-l3"><a class="reference internal" href="#musrwiz-introduction">musrWiz-Introduction</a></li>
|
||
<li class="toctree-l3"><a class="reference internal" href="#musrwiz-theory">musrWiz - Theory</a></li>
|
||
<li class="toctree-l3"><a class="reference internal" href="#musrwiz-functions">musrWiz - Functions</a></li>
|
||
<li class="toctree-l3"><a class="reference internal" href="#musrwiz-maps">musrWiz - Maps</a></li>
|
||
<li class="toctree-l3"><a class="reference internal" href="#musrwiz-fit-parameters">musrWiz - Fit Parameters</a></li>
|
||
<li class="toctree-l3"><a class="reference internal" href="#musrwiz-fit-info">musrWiz - Fit Info</a></li>
|
||
<li class="toctree-l3"><a class="reference internal" href="#musrwiz-create">musrWiz - Create</a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toctree-l2"><a class="reference internal" href="#musrstep">musrStep</a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toctree-l1"><a class="reference internal" href="mupp.html">mupp - μSR Parameter Plotter</a></li>
|
||
<li class="toctree-l1"><a class="reference internal" href="msr2data.html">msr2data - A Program for Automatically Processing Multiple <code class="docutils literal notranslate"><span class="pre">musrfit</span></code> msr Files</a></li>
|
||
<li class="toctree-l1"><a class="reference internal" href="any2many.html">any2many - a Universal μSR-file-format converter</a></li>
|
||
<li class="toctree-l1"><a class="reference internal" href="file-formats.html">Short description and references to the supported file-formats</a></li>
|
||
<li class="toctree-l1"><a class="reference internal" href="musr-root.html">MusrRoot - an Extensible Open File Format for μSR</a></li>
|
||
<li class="toctree-l1"><a class="reference internal" href="acknowledgement.html">Acknowledgements</a></li>
|
||
<li class="toctree-l1"><a class="reference internal" href="bugtracking.html">Bugtracking</a></li>
|
||
</ul>
|
||
|
||
|
||
|
||
</div>
|
||
</div>
|
||
</nav>
|
||
|
||
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
|
||
|
||
|
||
<nav class="wy-nav-top" aria-label="top navigation">
|
||
|
||
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
|
||
<a href="index.html">musrfit</a>
|
||
|
||
</nav>
|
||
|
||
|
||
<div class="wy-nav-content">
|
||
|
||
<div class="rst-content">
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<div role="navigation" aria-label="breadcrumbs navigation">
|
||
|
||
<ul class="wy-breadcrumbs">
|
||
|
||
<li><a href="index.html">Docs</a> »</li>
|
||
|
||
<li><code class="docutils literal notranslate"><span class="pre">musredit</span></code>: the GUI Based Interface to <code class="docutils literal notranslate"><span class="pre">musrfit</span></code></li>
|
||
|
||
|
||
<li class="wy-breadcrumbs-aside">
|
||
|
||
|
||
<a href="_sources/musredit.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">
|
||
|
||
<div class="section" id="musredit-the-gui-based-interface-to-musrfit">
|
||
<span id="musredit-sec"></span><span id="index-0"></span><h1><code class="docutils literal notranslate"><span class="pre">musredit</span></code>: the GUI Based Interface to <code class="docutils literal notranslate"><span class="pre">musrfit</span></code><a class="headerlink" href="#musredit-the-gui-based-interface-to-musrfit" title="Permalink to this headline">¶</a></h1>
|
||
<div class="section" id="introduction">
|
||
<h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h2>
|
||
<p><code class="docutils literal notranslate"><span class="pre">musredit</span></code> is an editor which also provide a graphical user interface to the programs contained in the <code class="docutils literal notranslate"><span class="pre">musrfit</span></code> suite and are intended
|
||
to help the user handle <code class="docutils literal notranslate"><span class="pre">musrfit</span></code> msr files. It is implemented in <code class="docutils literal notranslate"><span class="pre">C++</span></code> and use the <a class="reference external" href="https://qt.io">Qt</a> framework. <code class="docutils literal notranslate"><span class="pre">musredit</span></code> is based on Qt 4.6, Qt 5.6 (or above), or Qt6.x.
|
||
The Qt 5.6 and Qt 6.x version of <code class="docutils literal notranslate"><span class="pre">musredit</span></code> will be actively developed, whereas the Qt 4.x version will only get bug fixing and eventually will be dropped.
|
||
On this documentation page only the features related to <code class="docutils literal notranslate"><span class="pre">musrfit</span></code> are described — the basic editor functions which should be self-explanatory are <em>not</em>.
|
||
<code class="docutils literal notranslate"><span class="pre">musrgui</span></code> is an outdated early version of <code class="docutils literal notranslate"><span class="pre">musredit</span></code> and will not described anymore. If still in use, the user is urged to switch to <code class="docutils literal notranslate"><span class="pre">musredit</span></code>.</p>
|
||
<div class="admonition note">
|
||
<p class="first admonition-title">Note</p>
|
||
<p class="last">Before going on using <code class="docutils literal notranslate"><span class="pre">musredit</span></code> it is strongly recommended to read the <a class="reference internal" href="user-manual.html#user-manual"><span class="std std-ref">manual of musrfit</span></a> first!</p>
|
||
</div>
|
||
</div>
|
||
<div class="section" id="available-executable-configuration-files-and-their-basic-usage">
|
||
<h2>Available Executable, Configuration Files and their Basic Usage<a class="headerlink" href="#available-executable-configuration-files-and-their-basic-usage" title="Permalink to this headline">¶</a></h2>
|
||
<div class="section" id="musredit-musrgui">
|
||
<h3>musredit (musrgui)<a class="headerlink" href="#musredit-musrgui" title="Permalink to this headline">¶</a></h3>
|
||
<p><code class="docutils literal notranslate"><span class="pre">musredit</span></code> (<code class="docutils literal notranslate"><span class="pre">musrgui</span></code>) is the editor executable. If called from within a shell it accepts a few optional parameters:</p>
|
||
<dl class="docutils">
|
||
<dt><strong><msr-files></strong></dt>
|
||
<dd>File names of the msr files that should be opened in separate editor tabs on startup of <code class="docutils literal notranslate"><span class="pre">musredit</span></code>.</dd>
|
||
<dt><strong>- -help</strong></dt>
|
||
<dd>Displays a small help notice in the shell explaining the basic usage of the program.</dd>
|
||
<dt><strong>- -version</strong></dt>
|
||
<dd>Prints the version number of <code class="docutils literal notranslate"><span class="pre">musredit</span></code>.</dd>
|
||
</dl>
|
||
<p>If called without any parameters an empty editor window opens.</p>
|
||
</div>
|
||
<div class="section" id="musredit-startup-xml">
|
||
<span id="index-1"></span><h3>musredit_startup.xml<a class="headerlink" href="#musredit-startup-xml" title="Permalink to this headline">¶</a></h3>
|
||
<p><code class="docutils literal notranslate"><span class="pre">musredit_startup.xml</span></code> is the configuration file located under <code class="docutils literal notranslate"><span class="pre">$HOME\.musrfit\musredit</span></code>. It is also possible to have another version
|
||
of this file in the working directory which then will be used!</p>
|
||
<p>In this file the following <code class="docutils literal notranslate"><span class="pre">XML</span></code> tags are allowed to define settings and might proof useful for all users of <code class="docutils literal notranslate"><span class="pre">musredit</span></code>:</p>
|
||
<dl class="docutils">
|
||
<dt><strong><general></general></strong></dt>
|
||
<dd><p class="first">set the default paths to executable and files in this environment</p>
|
||
<dl class="last docutils">
|
||
<dt><strong><exec_path>PATH_TO_EXEC</exec_path></strong></dt>
|
||
<dd>set the path <code class="docutils literal notranslate"><span class="pre">PATH_TO_EXEC</span></code> where the executable <code class="docutils literal notranslate"><span class="pre">musrfit</span></code>, <code class="docutils literal notranslate"><span class="pre">musrview</span></code>, <code class="docutils literal notranslate"><span class="pre">musrt0</span></code>, etc. can be found (inside the <code class="docutils literal notranslate"><span class="pre"><general></span></code> environment)</dd>
|
||
<dt><strong><default_save_path>SAVE_PATH</default_save_path></strong></dt>
|
||
<dd>specify the path <code class="docutils literal notranslate"><span class="pre">SAVE_PATH</span></code> where <code class="docutils literal notranslate"><span class="pre">musredit</span></code> point by default when opening and saving msr files (inside the <code class="docutils literal notranslate"><span class="pre"><general></span></code> environment). Default is the current directory.</dd>
|
||
<dt><strong><msr_default_file_path>MSR_DEF_PATH</msr_default_file_path></strong></dt>
|
||
<dd>set the path <code class="docutils literal notranslate"><span class="pre">MSR_DEF_PATH</span></code> where the default msr files provided by <code class="docutils literal notranslate"><span class="pre">musredit</span></code> are stored (inside the <code class="docutils literal notranslate"><span class="pre"><general></span></code> environment)</dd>
|
||
<dt><strong><timeout>3600</timeout></strong></dt>
|
||
<dd>timeout in seconds after which <a class="reference internal" href="user-manual.html#musrview"><span class="std std-ref">musrview</span></a> canvas will automatically quit. A value of 0 or
|
||
a negative number will keep the <code class="docutils literal notranslate"><span class="pre">musrview</span></code> canvas open without self-determination.</dd>
|
||
<dt><strong><keep_minuit2_output>y/n</keep_minuit2_output></strong></dt>
|
||
<dd>flag indicating if the <code class="docutils literal notranslate"><span class="pre">MINUIT2</span></code> output shall be kept per msr-file (‘y’) or only for the current msr-file (‘n’).</dd>
|
||
<dt><strong><dump_ascii>y/n</dump_ascii></strong></dt>
|
||
<dd>flag indicating if <code class="docutils literal notranslate"><span class="pre">musrfit</span></code> shall dump fit data into ascii format. See help of <a class="reference internal" href="user-manual.html#musrfit"><span class="std std-ref">musrfit</span></a>.</dd>
|
||
<dt><strong><dump_root>y/n</dump_root></strong></dt>
|
||
<dd>flag indicating if <code class="docutils literal notranslate"><span class="pre">musrfit</span></code> shall dump fit data into root format. See help of <a class="reference internal" href="user-manual.html#musrfit"><span class="std std-ref">musrfit</span></a>.</dd>
|
||
<dt><strong><title_from_data_file>y/n</title_from_data_file></strong></dt>
|
||
<dd>specify if <code class="docutils literal notranslate"><span class="pre">musrfit</span></code> should be called with the <code class="docutils literal notranslate"><span class="pre">-t</span></code> option by default (inside the <code class="docutils literal notranslate"><span class="pre"><general></span></code> environment)</dd>
|
||
<dt><strong><chisq_pre_run_block>y/n</chisq_pre_run_block></strong></dt>
|
||
<dd>flag indicating if per-run chisq shall be written into the msr-output-file.</dd>
|
||
<dt><strong><estimate_n0>y/n</estimate_n0></strong></dt>
|
||
<dd>flag indicating if for a single histogram fit <span class="math notranslate nohighlight">\(N_0\)</span> shall be estimated before the fit procedure starts.</dd>
|
||
<dt><strong><musrview_show_fourier>y/n</musrview_show_fourier></strong></dt>
|
||
<dd>flag indicating if <code class="docutils literal notranslate"><span class="pre">musrview</span></code> will directly present the Fourier transform rather than the time domain data.</dd>
|
||
<dt><strong><musrview_show_avg>y/n</musrview_show_avg></strong></dt>
|
||
<dd>flag indicating if <code class="docutils literal notranslate"><span class="pre">musrview</span></code> will directly present averaged data, typically used for Fourier power spectra.</dd>
|
||
<dt><strong><enable_musrt0>y/n</enable_musrt0></strong></dt>
|
||
<dd>specify if <a class="reference internal" href="user-manual.html#musrt0"><span class="std std-ref">musrt0</span></a> can be called from within <code class="docutils literal notranslate"><span class="pre">musredit</span></code> (inside the <code class="docutils literal notranslate"><span class="pre"><general></span></code> environment)</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt><strong><font_settings></font_settings></strong></dt>
|
||
<dd><p class="first">set the default font in this environment</p>
|
||
<dl class="last docutils">
|
||
<dt><strong><font_name>FONT</font_name></strong></dt>
|
||
<dd>specify the name of the font <code class="docutils literal notranslate"><span class="pre">FONT</span></code> to be used by default in <code class="docutils literal notranslate"><span class="pre">musredit</span></code> (inside the <code class="docutils literal notranslate"><span class="pre"><font_settings></span></code> environment)</dd>
|
||
<dt><strong><font_size>N</font_size></strong></dt>
|
||
<dd>specify the size <code class="docutils literal notranslate"><span class="pre">N</span></code> of the font to be used by default in <code class="docutils literal notranslate"><span class="pre">musredit</span></code> (inside the <code class="docutils literal notranslate"><span class="pre"><font_settings></span></code> environment)</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt><strong><msr_file_defaults></msr_file_defaults></strong></dt>
|
||
<dd><p class="first">put the default settings for newly created msr files in this environment</p>
|
||
<dl class="last docutils">
|
||
<dt><strong><beamline>BL</beamline></strong></dt>
|
||
<dd>set the name of the muon beamline <code class="docutils literal notranslate"><span class="pre">BL</span></code> here (inside a <code class="docutils literal notranslate"><span class="pre"><msr_file_defaults></span></code> environment)</dd>
|
||
<dt><strong><institute>INST</institute></strong></dt>
|
||
<dd>set the name of the facility <code class="docutils literal notranslate"><span class="pre">INST</span></code> where the beamline <code class="docutils literal notranslate"><span class="pre">BL</span></code> is located. Valid settings are <code class="docutils literal notranslate"><span class="pre">PSI</span></code>, <code class="docutils literal notranslate"><span class="pre">RAL</span></code>, <code class="docutils literal notranslate"><span class="pre">JPARC</span></code>, and <code class="docutils literal notranslate"><span class="pre">TRIUMF</span></code> (inside a <code class="docutils literal notranslate"><span class="pre"><msr_file_defaults></span></code> environment)</dd>
|
||
<dt><strong><file_format>FF</file_format></strong></dt>
|
||
<dd>specify the default data file format <code class="docutils literal notranslate"><span class="pre">FF</span></code> here. Valid formats are <code class="docutils literal notranslate"><span class="pre">NEXUS</span></code>, <code class="docutils literal notranslate"><span class="pre">MUSR-ROOT</span></code>, <code class="docutils literal notranslate"><span class="pre">ROOT-NPP</span></code>, <code class="docutils literal notranslate"><span class="pre">ROOT-PPC</span></code>, <code class="docutils literal notranslate"><span class="pre">PSI-BIN</span></code>, <code class="docutils literal notranslate"><span class="pre">PSI-MDU</span></code>, <code class="docutils literal notranslate"><span class="pre">MDU-ASCII</span></code>, <code class="docutils literal notranslate"><span class="pre">WKM</span></code>, <code class="docutils literal notranslate"><span class="pre">MUD</span></code>, <code class="docutils literal notranslate"><span class="pre">ASCII</span></code>, and <code class="docutils literal notranslate"><span class="pre">DB</span></code> (inside a <code class="docutils literal notranslate"><span class="pre"><msr_file_defaults></span></code> environment)</dd>
|
||
<dt><strong><lifetime_correction>y/n</lifetime_correction></strong></dt>
|
||
<dd>choose if by default the <code class="docutils literal notranslate"><span class="pre">lifetimecorrection</span></code> option should be set (inside a <code class="docutils literal notranslate"><span class="pre"><msr_file_defaults></span></code> environment)</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt><strong><msr2data_defaults></msr2data_defaults></strong></dt>
|
||
<dd><p class="first">define the default options for calling <a class="reference internal" href="msr2data.html#msr2data"><span class="std std-ref">msr2data</span></a> in this environment; the options set here are ticked by default in the graphical interface of <code class="docutils literal notranslate"><span class="pre">musredit</span></code>.</p>
|
||
<dl class="last docutils">
|
||
<dt><strong><chain_fit>y/n</chain_fit></strong></dt>
|
||
<dd>(un)set the chain fit (!) option (inside a <code class="docutils literal notranslate"><span class="pre"><msr2data_defaults></span></code> environment)</dd>
|
||
<dt><strong><write_data_header>y/n</write_data_header></strong></dt>
|
||
<dd>(un)set the noheader option (inside a <code class="docutils literal notranslate"><span class="pre"><msr2data_defaults></span></code> environment)</dd>
|
||
<dt><strong><ignore_data_header_info>y/n</ignore_data_header_info></strong></dt>
|
||
<dd>(un)set the nosummary option (inside a <code class="docutils literal notranslate"><span class="pre"><msr2data_defaults></span></code> environment)</dd>
|
||
<dt><strong><keep_minuit2_output>y/n</keep_minuit2_output></strong></dt>
|
||
<dd>(un)set the <code class="docutils literal notranslate"><span class="pre">-k</span></code> option (inside a <code class="docutils literal notranslate"><span class="pre"><msr2data_defaults></span></code> environment)</dd>
|
||
<dt><strong><write_column_data>y/n</write_column_data></strong></dt>
|
||
<dd>(un)set the <code class="docutils literal notranslate"><span class="pre">data</span></code> option (inside a <code class="docutils literal notranslate"><span class="pre"><msr2data_defaults></span></code> environment)</dd>
|
||
<dt><strong><create_msr_file_only>y/n</create_msr_file_only></strong></dt>
|
||
<dd>(un)set the <code class="docutils literal notranslate"><span class="pre">msr</span></code> option in case a template run is specified (inside a <code class="docutils literal notranslate"><span class="pre"><msr2data_defaults></span></code> environment)</dd>
|
||
<dt><strong><fit_only>y/n</fit_only></strong></dt>
|
||
<dd>(un)set the <code class="docutils literal notranslate"><span class="pre">fit</span></code> option in case no template run is specified (inside a <code class="docutils literal notranslate"><span class="pre"><msr2data_defaults></span></code> environment)</dd>
|
||
<dt><strong><global>y/n</global></strong></dt>
|
||
<dd>(un)set the <code class="docutils literal notranslate"><span class="pre">global</span></code> option (inside a <code class="docutils literal notranslate"><span class="pre"><msr2data_defaults></span></code> environment)</dd>
|
||
<dt><strong><global_plus>y/n</global_plus></strong></dt>
|
||
<dd>(un)set the <code class="docutils literal notranslate"><span class="pre">global+</span></code> option (inside a <code class="docutils literal notranslate"><span class="pre"><msr2data_defaults></span></code> environment)</dd>
|
||
<dt><strong><recreate_data_file>y/n</recreate_data_file></strong></dt>
|
||
<dd>(un)set the <code class="docutils literal notranslate"><span class="pre">musredit</span></code> option for recreating the output file (inside a <code class="docutils literal notranslate"><span class="pre"><msr2data_defaults></span></code> environment)</dd>
|
||
<dt><strong><open_file_after_fitting>y/n</open_file_after_fitting></strong></dt>
|
||
<dd>(un)set the <code class="docutils literal notranslate"><span class="pre">musredit</span></code> option for opening msr files after fitting (inside a <code class="docutils literal notranslate"><span class="pre"><msr2data_defaults></span></code> environment)</dd>
|
||
</dl>
|
||
</dd>
|
||
</dl>
|
||
<p>Additionally, there are some settings defined in this XML file which should be only changed by experienced users who like to add new features to <code class="docutils literal notranslate"><span class="pre">musredit</span></code>:</p>
|
||
<dl class="docutils">
|
||
<dt><strong><help_section></help_section></strong></dt>
|
||
<dd><p class="first">define various help messages in this environment</p>
|
||
<dl class="last docutils">
|
||
<dt><strong><musr_web_X>LINK</musr_web_X></strong></dt>
|
||
<dd>define the <code class="docutils literal notranslate"><span class="pre">LINK</span></code> to the help page <code class="docutils literal notranslate"><span class="pre">musr_web_X</span></code>, where <code class="docutils literal notranslate"><span class="pre">X</span></code> is <code class="docutils literal notranslate"><span class="pre">main</span></code>, <code class="docutils literal notranslate"><span class="pre">title</span></code>, <code class="docutils literal notranslate"><span class="pre">parameters</span></code>, <code class="docutils literal notranslate"><span class="pre">theory</span></code>, <code class="docutils literal notranslate"><span class="pre">functions</span></code>, <code class="docutils literal notranslate"><span class="pre">run</span></code>,
|
||
<code class="docutils literal notranslate"><span class="pre">command</span></code>, <code class="docutils literal notranslate"><span class="pre">fourier</span></code>, <code class="docutils literal notranslate"><span class="pre">plot</span></code>, <code class="docutils literal notranslate"><span class="pre">statistics</span></code>, <code class="docutils literal notranslate"><span class="pre">msr2data</span></code>, or <code class="docutils literal notranslate"><span class="pre">musrFT</span></code> (inside a <code class="docutils literal notranslate"><span class="pre"><help_section></span></code> environment)</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt><strong><func_pixmap_path>PIX_PATH</func_pixmap_path></strong></dt>
|
||
<dd>set the path <code class="docutils literal notranslate"><span class="pre">PIX_PATH</span></code> to LaTeX pixmaps visualizing the various supported theory functions</dd>
|
||
<dt><strong><theory_functions></theory_functions></strong></dt>
|
||
<dd><p class="first">define the functions for a msr file’s <a class="reference internal" href="user-manual.html#msr-theory-block"><span class="std std-ref">THEORY block</span></a> according to the correct syntax in this environment</p>
|
||
<dl class="last docutils">
|
||
<dt><strong><func></func></strong></dt>
|
||
<dd><p class="first">specify a function here (inside a <code class="docutils literal notranslate"><span class="pre"><theory_functions></span></code> environment)</p>
|
||
<dl class="last docutils">
|
||
<dt><strong><name>NAME</name></strong></dt>
|
||
<dd>the <code class="docutils literal notranslate"><span class="pre">NAME</span></code> of the function in the msr file (inside a <code class="docutils literal notranslate"><span class="pre"><func></span></code> environment)</dd>
|
||
<dt><strong><comment>COMMENT</comment></strong></dt>
|
||
<dd>description of the used parameters (inside a <code class="docutils literal notranslate"><span class="pre"><func></span></code> environment)</dd>
|
||
<dt><strong><label>LABEL</label></strong></dt>
|
||
<dd><code class="docutils literal notranslate"><span class="pre">LABEL</span></code> of the function in the <code class="docutils literal notranslate"><span class="pre">musredit</span></code> menu (inside a <code class="docutils literal notranslate"><span class="pre"><func></span></code> environment)</dd>
|
||
<dt><strong><pixmap>PIXMAP</pixmap></strong></dt>
|
||
<dd>LaTeX picture used to describe the function and stored in the <code class="docutils literal notranslate"><span class="pre">PIX_PATH</span></code> (inside a <code class="docutils literal notranslate"><span class="pre"><func></span></code> environment)</dd>
|
||
<dt><strong><params>N</params></strong></dt>
|
||
<dd>number of parameters <code class="docutils literal notranslate"><span class="pre">N</span></code> used by the function (inside a <code class="docutils literal notranslate"><span class="pre"><func></span></code> environment)</dd>
|
||
</dl>
|
||
</dd>
|
||
</dl>
|
||
</dd>
|
||
</dl>
|
||
<p>An example of the <code class="docutils literal notranslate"><span class="pre">musredit_startup.xml</span></code> looks like:</p>
|
||
<div class="highlight-xml notranslate"><div class="highlight"><pre><span></span><span class="cp"><?xml version="1.0" encoding="UTF-8"?></span>
|
||
<span class="nt"><musredit_startup</span> <span class="na">xmlns=</span><span class="s">"http://lmu.web.psi.ch/musrfit/user/MUSR/MusrGui.html"</span><span class="nt">></span>
|
||
<span class="nt"><comment></span>
|
||
This is handling default setting parameters for the musredit.
|
||
<span class="nt"></comment></span>
|
||
<span class="nt"><general></span>
|
||
<span class="nt"><exec_path></span>/usr/local/root/bin<span class="nt"></exec_path></span>
|
||
<span class="nt"><default_save_path></span>./<span class="nt"></default_save_path></span>
|
||
<span class="nt"><msr_default_file_path></span>/usr/local/root/share/doc/musrfit/templates<span class="nt"></msr_default_file_path></span>
|
||
<span class="nt"><timeout></span>3600<span class="nt"></timeout></span>
|
||
<span class="nt"><keep_minuit2_output></span>n<span class="nt"></keep_minuit2_output></span>
|
||
<span class="nt"><dump_ascii></span>n<span class="nt"></dump_ascii></span>
|
||
<span class="nt"><dump_root></span>n<span class="nt"></dump_root></span>
|
||
<span class="nt"><title_from_data_file></span>y<span class="nt"></title_from_data_file></span>
|
||
<span class="nt"><chisq_per_run_block></span>n<span class="nt"></chisq_per_run_block></span>
|
||
<span class="nt"><estimate_n0></span>y<span class="nt"></estimate_n0></span>
|
||
<span class="nt"><musrview_show_fourier></span>n<span class="nt"></musrview_show_fourier></span>
|
||
<span class="nt"><musrview_show_avg></span>n<span class="nt"></musrview_show_avg></span>
|
||
<span class="nt"><enable_musrt0></span>y<span class="nt"></enable_musrt0></span>
|
||
<span class="nt"></general></span>
|
||
<span class="nt"><recent_files></span>
|
||
<span class="nt"><path_file_name></span>/usr/local/root/share/doc/musrfit/examples/test-histo-PSI-BIN.msr<span class="nt"></path_file_name></span>
|
||
<span class="nt"></recent_files></span>
|
||
<span class="nt"><help_section></span>
|
||
<span class="nt"><musr_web_main></span>file:///usr/local/root/share/doc/musrfit/html/user/MUSR/MusrFit.html<span class="nt"></musr_web_main></span>
|
||
<span class="nt"><musr_web_title></span>file:///usr/local/root/share/doc/musrfit/html/user/MUSR/MusrFit.html#TheTitle<span class="nt"></musr_web_title></span>
|
||
<span class="nt"><musr_web_parameters></span>file:///usr/local/root/share/doc/musrfit/html/user/MUSR/MusrFit.html#TheFitparameterBlock<span class="nt"></musr_web_parameters></span>
|
||
<span class="nt"><musr_web_theory></span>file:///usr/local/root/share/doc/musrfit/html/user/MUSR/MusrFit.html#TheTheoryBlock<span class="nt"></musr_web_theory></span>
|
||
<span class="nt"><musr_web_functions></span>file:///usr/local/root/share/doc/musrfit/html/user/MUSR/MusrFit.html#TheFunctionsBlock<span class="nt"></musr_web_functions></span>
|
||
<span class="nt"><musr_web_run></span>file:///usr/local/root/share/doc/musrfit/html/user/MUSR/MusrFit.html#TheRunBlock<span class="nt"></musr_web_run></span>
|
||
<span class="nt"><musr_web_command></span>file:///usr/local/root/share/doc/musrfit/html/user/MUSR/MusrFit.html#TheCommandsBlock<span class="nt"></musr_web_command></span>
|
||
<span class="nt"><musr_web_fourier></span>file:///usr/local/root/share/doc/musrfit/html/user/MUSR/MusrFit.html#TheFourierBlock<span class="nt"></musr_web_fourier></span>
|
||
<span class="nt"><musr_web_plot></span>file:///usr/local/root/share/doc/musrfit/html/user/MUSR/MusrFit.html#ThePlotBlock<span class="nt"></musr_web_plot></span>
|
||
<span class="nt"><musr_web_statistic></span>file:///usr/local/root/share/doc/musrfit/html/user/MUSR/MusrFit.html#TheStatisticBlock<span class="nt"></musr_web_statistic></span>
|
||
<span class="nt"><musr_web_msr2data></span>file:///usr/local/root/share/doc/musrfit/html/user/MUSR/Msr2Data.html<span class="nt"></musr_web_msr2data></span>
|
||
<span class="nt"><musr_web_musrFT></span>file:///usr/local/root/share/doc/musrfit/html/user/MUSR/MusrFit.html#A_2.3_musrFT<span class="nt"></musr_web_musrFT></span>
|
||
<span class="nt"></help_section></span>
|
||
<span class="nt"><font_settings></span>
|
||
<span class="nt"><font_name></span>Monospace<span class="nt"></font_name></span>
|
||
<span class="nt"><font_size></span>12<span class="nt"></font_size></span>
|
||
<span class="nt"></font_settings></span>
|
||
<span class="nt"><msr_file_defaults></span>
|
||
<span class="nt"><beamline></span>mue4<span class="nt"></beamline></span>
|
||
<span class="nt"><institute></span>psi<span class="nt"></institute></span>
|
||
<span class="nt"><file_format></span>musr-root<span class="nt"></file_format></span>
|
||
<span class="nt"><lifetime_correction></span>y<span class="nt"></lifetime_correction></span>
|
||
<span class="nt"></msr_file_defaults></span>
|
||
<span class="nt"><msr2data_defaults></span>
|
||
<span class="nt"><chain_fit></span>y<span class="nt"></chain_fit></span>
|
||
<span class="nt"><write_data_header></span>y<span class="nt"></write_data_header></span>
|
||
<span class="nt"><ignore_data_header_info></span>n<span class="nt"></ignore_data_header_info></span>
|
||
<span class="nt"><keep_minuit2_output></span>n<span class="nt"></keep_minuit2_output></span>
|
||
<span class="nt"><write_column_data></span>n<span class="nt"></write_column_data></span>
|
||
<span class="nt"><recreate_data_file></span>n<span class="nt"></recreate_data_file></span>
|
||
<span class="nt"><open_file_after_fitting></span>y<span class="nt"></open_file_after_fitting></span>
|
||
<span class="nt"><create_msr_file_only></span>n<span class="nt"></create_msr_file_only></span>
|
||
<span class="nt"><fit_only></span>n<span class="nt"></fit_only></span>
|
||
<span class="nt"><global></span>n<span class="nt"></global></span>
|
||
<span class="nt"><global_plus></span>n<span class="nt"></global_plus></span>
|
||
<span class="nt"></msr2data_defaults></span>
|
||
<span class="nt"><func_pixmap_path></span>/usr/local/root/share/doc/musrfit/latex_images<span class="nt"></func_pixmap_path></span>
|
||
<span class="nt"><theory_functions></span>
|
||
<span class="nt"><func></span>
|
||
<span class="nt"><name></span>asymmetry<span class="nt"></name></span>
|
||
<span class="nt"><comment></comment></span>
|
||
<span class="nt"><label></span>Asymmetry<span class="nt"></label></span>
|
||
<span class="nt"><pixmap></span>asymmetry.png<span class="nt"></pixmap></span>
|
||
<span class="nt"><params></span>1<span class="nt"></params></span>
|
||
<span class="nt"></func></span>
|
||
<span class="nt"><func></span>
|
||
<span class="nt"><name></span>statGssKT<span class="nt"></name></span>
|
||
<span class="nt"><comment></span>(rate)<span class="nt"></comment></span>
|
||
<span class="nt"><label></span>static Gauss KT<span class="nt"></label></span>
|
||
<span class="nt"><pixmap></span>statGssKT.png<span class="nt"></pixmap></span>
|
||
<span class="nt"><params></span>1<span class="nt"></params></span>
|
||
<span class="nt"></func></span>
|
||
<span class="nt"></theory_functions></span>
|
||
<span class="nt"></musredit_startup></span>
|
||
</pre></div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="section" id="musredit-features">
|
||
<span id="index-2"></span><h2>musredit Features<a class="headerlink" href="#musredit-features" title="Permalink to this headline">¶</a></h2>
|
||
<p>The features of <code class="docutils literal notranslate"><span class="pre">musrfit</span></code> which can be accessed by the graphical front ends <code class="docutils literal notranslate"><span class="pre">musredit</span></code> will be described in the following. All functions
|
||
can either be called by choosing them from the <em>MusrFit menu</em>, by clicking the respective button in the <em>MusrFit bar</em>, or by using a <em>keyboard shortcut</em>.</p>
|
||
<p><strong>musrWiz</strong></p>
|
||
<blockquote>
|
||
<div><img alt="_images/musrWiz.svg" src="_images/musrWiz.svg" /><p><code class="docutils literal notranslate"><span class="pre">musrWiz</span></code> is a helper programs which allows to create a msr-file from scratch without too much a priori knowledge. For details see <a class="reference internal" href="#musrwiz"><span class="std std-ref">musrWiz</span></a>.</p>
|
||
</div></blockquote>
|
||
<p id="musrwiz"><span id="index-3"></span><strong>Calculate Chisq</strong></p>
|
||
<blockquote>
|
||
<div><img alt="_images/musrchisq.svg" src="_images/musrchisq.svg" /><p>Calls <code class="docutils literal notranslate"><span class="pre">musrfit</span></code> with the option <code class="docutils literal notranslate"><span class="pre">-c</span></code>, <em>i.e.</em> calculates the <span class="math notranslate nohighlight">\(\chi^2\)</span> or log max-likelihood for the active msr file tab. Shortcut-key: <code class="docutils literal notranslate"><span class="pre">Alt+C</span></code>.
|
||
The equivalent call on the command line would be</p>
|
||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ musrfit -c <msr-file>
|
||
</pre></div>
|
||
</div>
|
||
</div></blockquote>
|
||
<p><strong>Fit</strong></p>
|
||
<blockquote>
|
||
<div><img alt="_images/musrfit.svg" src="_images/musrfit.svg" /><p>Calls <code class="docutils literal notranslate"><span class="pre">musrfit</span></code> for fitting of the active msr file in the currently active tab. Shortcut-key: <code class="docutils literal notranslate"><span class="pre">Alt+F</span></code>.
|
||
The equivalent call on the command line could look like</p>
|
||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ musrfit <msr-file> <span class="o">[</span>optional parameters<span class="o">]</span>
|
||
</pre></div>
|
||
</div>
|
||
<p>The optional parameters may be chosen under <a class="reference internal" href="#musredit-prefs"><span class="std std-ref">Preferences</span></a>. For further information refer to the manual of <a class="reference internal" href="user-manual.html#user-manual"><span class="std std-ref">musrfit</span></a>.</p>
|
||
</div></blockquote>
|
||
<p><strong>Swap Msr <-> Mlog</strong></p>
|
||
<blockquote>
|
||
<div><img alt="_images/musrswap.svg" src="_images/musrswap.svg" /><p>Swap the msr and mlog files. <em>E.g.</em>, for a file called <code class="docutils literal notranslate"><span class="pre">8472_zf.msr</span></code>, this is copied to <code class="docutils literal notranslate"><span class="pre">8472_zf.mlog</span></code> and vice versa. Shortcut-key: <code class="docutils literal notranslate"><span class="pre">Alt+S</span></code>.</p>
|
||
</div></blockquote>
|
||
<p><strong>Set Steps</strong></p>
|
||
<blockquote>
|
||
<div><img alt="_images/musrStep.svg" src="_images/musrStep.svg" /><p><code class="docutils literal notranslate"><span class="pre">musrStep</span></code> allows to adjust the step size, <em>i.e.</em> the initial steps for the fitter. Shortcut-key: <code class="docutils literal notranslate"><span class="pre">Alt+P</span></code>.</p>
|
||
</div></blockquote>
|
||
<p><strong>Msr2Data</strong></p>
|
||
<blockquote>
|
||
<div><img alt="_images/msr2data.svg" src="_images/msr2data.svg" /><p>Opens a graphical interface to the <code class="docutils literal notranslate"><span class="pre">msr2data</span></code> program described in detail in its <a class="reference internal" href="msr2data.html#msr2data"><span class="std std-ref">own manual</span></a>. Shortcut-key: <code class="docutils literal notranslate"><span class="pre">Alt+2</span></code>.</p>
|
||
</div></blockquote>
|
||
<p><strong>mupp</strong></p>
|
||
<blockquote>
|
||
<div><img alt="_images/mupp.svg" src="_images/mupp.svg" /><p>Application which allows to plot <code class="docutils literal notranslate"><span class="pre">*.db</span></code> and <code class="docutils literal notranslate"><span class="pre">*.dat</span></code> parameter files. Shortcut-key: <code class="docutils literal notranslate"><span class="pre">Alt+U</span></code>.
|
||
For a detailed description see the <a class="reference internal" href="mupp.html#mupp"><span class="std std-ref">mupp docu</span></a>.</p>
|
||
</div></blockquote>
|
||
<p><strong>View</strong></p>
|
||
<blockquote>
|
||
<div><img alt="_images/musrview.svg" src="_images/musrview.svg" /><p>Calls <code class="docutils literal notranslate"><span class="pre">musrview</span></code> from the active tab of <code class="docutils literal notranslate"><span class="pre">musredit</span></code>. For more details see the <a class="reference internal" href="user-manual.html#musrview"><span class="std std-ref">musrview</span></a> docu. Shortcut-key: <code class="docutils literal notranslate"><span class="pre">Alt+V</span></code>.
|
||
The equivalent call on the command line could look like</p>
|
||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ musrview <msr-file> <span class="o">[</span>optional parameters<span class="o">]</span>
|
||
</pre></div>
|
||
</div>
|
||
</div></blockquote>
|
||
<p><strong>T0</strong></p>
|
||
<blockquote>
|
||
<div><img alt="_images/musrt0-icon.svg" src="_images/musrt0-icon.svg" /><p>Calls <code class="docutils literal notranslate"><span class="pre">musrt0</span></code> which allows to set the <code class="docutils literal notranslate"><span class="pre">T0</span></code> values for all the runs. For more details see the <a class="reference internal" href="user-manual.html#musrt0"><span class="std std-ref">musrt0</span></a> docu.
|
||
The equivalent call on the command line could look like</p>
|
||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ musrt0 <msr-file> <span class="o">[</span>optional parameters<span class="o">]</span>
|
||
</pre></div>
|
||
</div>
|
||
</div></blockquote>
|
||
<p><strong>Raw Fourier</strong></p>
|
||
<blockquote>
|
||
<div><img alt="_images/musrFT.svg" src="_images/musrFT.svg" /><p>Calls <code class="docutils literal notranslate"><span class="pre">musrFT</span></code> which allows to perform a Fourier transform of the raw data. For more details see the <a class="reference internal" href="user-manual.html#musrft"><span class="std std-ref">musrFT</span></a> docu.
|
||
The equivalent call on the command line could look like</p>
|
||
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ musrFT <msr-file> <span class="o">[</span>optional parameters<span class="o">]</span>
|
||
</pre></div>
|
||
</div>
|
||
</div></blockquote>
|
||
<p id="musredit-prefs"><strong>Preferences</strong></p>
|
||
<blockquote>
|
||
<div><img alt="_images/musrprefs.svg" src="_images/musrprefs.svg" /><p>Opens a window in which the optional parameters that should be passed to musrfit can be chosen.
|
||
For further information refer to the manual of <a class="reference internal" href="user-manual.html#musrfit"><span class="std std-ref">musrfit</span></a>.</p>
|
||
</div></blockquote>
|
||
<p><strong>Dump Header</strong></p>
|
||
<blockquote>
|
||
<div><img alt="_images/musrdump.svg" src="_images/musrdump.svg" /><p>Opens a file dialog which allows to select a μSR data file. When this file can be read, the run header info is dumped into a dialog window.
|
||
Essentially this calls <code class="docutils literal notranslate"><span class="pre">dump_header</span></code> internally.</p>
|
||
</div></blockquote>
|
||
</div>
|
||
<div class="section" id="id1">
|
||
<h2>musrWiz<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
|
||
<p><code class="docutils literal notranslate"><span class="pre">musrWiz</span></code> is a helper program which allows to easily create the necessary msr-file needed as an input for <code class="docutils literal notranslate"><span class="pre">musrfit</span></code>.
|
||
<code class="docutils literal notranslate"><span class="pre">musrWiz</span></code> is still in it’s early stage; not all options are already implemented and here and there you will likely find some bugs.
|
||
From <code class="docutils literal notranslate"><span class="pre">musredit</span></code> it can be accessed via the MusrFit menu or the wand</p>
|
||
<img alt="_images/musredit-musrWiz.svg" src="_images/musredit-musrWiz.svg" /><p>The <code class="docutils literal notranslate"><span class="pre">musrWiz</span></code> GUI is organized in a couple of different dialogues which some information needs to be provided by the user.
|
||
In the following these different dialogues will be discussed briefly.</p>
|
||
<div class="section" id="musrwiz-introduction">
|
||
<span id="index-4"></span><h3>musrWiz-Introduction<a class="headerlink" href="#musrwiz-introduction" title="Permalink to this headline">¶</a></h3>
|
||
<p>The introduction dialogue</p>
|
||
<img alt="_images/musrWiz-Intro.svg" src="_images/musrWiz-Intro.svg" /><ol class="arabic simple">
|
||
<li>an explicit msr-file name can be provided here. More often the msr-file name is generated out of the run number.</li>
|
||
<li>year of the run data.</li>
|
||
<li>run number. If no explicit msr-file is provided, the run number together with fit type and type of measurement will be used to generate the msr-file name.</li>
|
||
<li>from the pull down menu the institute (for which a necessary <code class="docutils literal notranslate"><span class="pre">xml</span></code>-file is provided) has to be choosen.</li>
|
||
<li>from the pull down menu the the instrument can be chosen.</li>
|
||
<li>the fit type has to be chosen. Possible fit types are: <code class="docutils literal notranslate"><span class="pre">Single</span> <span class="pre">Histo</span></code> / <code class="docutils literal notranslate"><span class="pre">Single</span> <span class="pre">Histo</span> <span class="pre">RRF</span></code> / <code class="docutils literal notranslate"><span class="pre">Asymmetry</span></code> / <code class="docutils literal notranslate"><span class="pre">Asymmetry</span> <span class="pre">RRF</span></code> / <code class="docutils literal notranslate"><span class="pre">Mu</span> <span class="pre">Minus</span></code> / <code class="docutils literal notranslate"><span class="pre">None</span> <span class="pre">muSR</span></code></li>
|
||
<li>type of measurement is essentially needed for the grouping of the detectors. Possible are: <code class="docutils literal notranslate"><span class="pre">ZF</span></code> for zero field measurements / <code class="docutils literal notranslate"><span class="pre">TF</span></code> for transverse field measurements / <code class="docutils literal notranslate"><span class="pre">LF</span></code> for longitudinal field measurements.
|
||
Depending on the choice and instrument some additional question might be asked, <em>e.g.</em> which magnet has been used.</li>
|
||
<li><code class="docutils literal notranslate"><span class="pre">T0</span></code>’s: this last menu defines from where to get the t0’s. The options are: <code class="docutils literal notranslate"><span class="pre">from</span> <span class="pre">data</span> <span class="pre">file</span></code>, <em>i.e.</em> the t0 are assumed to be correctly set
|
||
in the provided data file <code class="docutils literal notranslate"><span class="pre">call</span> <span class="pre">musrT0</span></code>, <em>i.e.</em> after the msr-file is generated, <code class="docutils literal notranslate"><span class="pre">musrt0</span></code> will be called which allows the user to find the
|
||
proper t0 from the prompt peak <code class="docutils literal notranslate"><span class="pre">enter</span> <span class="pre">here</span></code> will provide a pop-up menu where the t0 parameter can be given explicitly.</li>
|
||
</ol>
|
||
<p>If all this information have been provided <code class="docutils literal notranslate"><span class="pre">Next></span></code> will lead you the the theory dialogue.</p>
|
||
</div>
|
||
<div class="section" id="musrwiz-theory">
|
||
<span id="index-5"></span><h3>musrWiz - Theory<a class="headerlink" href="#musrwiz-theory" title="Permalink to this headline">¶</a></h3>
|
||
<p>The theory dialogue is used to define the fitting function. There are two ways of using it:</p>
|
||
<ol class="arabic simple">
|
||
<li>choose a template theory function. This option has the advantage that the next steps will be very easy because
|
||
within the template almost everything is already pre-defined. The disadvantage is that you are not free in setting
|
||
up your theory function as you would like to have.</li>
|
||
<li>freely write your theory function. The advantage here is that you can customize your theory function at your needs.
|
||
This will come at the cost that you also will need to define <code class="docutils literal notranslate"><span class="pre">maps</span></code>, <code class="docutils literal notranslate"><span class="pre">functions</span></code>, etc. yourself. The good thing
|
||
though is that at the very end you can save this as a template for future re-use.</li>
|
||
</ol>
|
||
<p>First the template path will be described. The theory dialogue looks like this</p>
|
||
<img alt="_images/musrWiz-Theory.svg" src="_images/musrWiz-Theory.svg" /><ol class="arabic simple">
|
||
<li>This is a text edit field were you can enter the theory fit function as you would like to have it. In the example
|
||
given the theory reads <span class="math notranslate nohighlight">\(p1 \exp(-p2\, t) \cos(2 \pi\, f1 + m1)\)</span>, where <code class="docutils literal notranslate"><span class="pre">pX</span></code> stands for parameter, <code class="docutils literal notranslate"><span class="pre">fX</span></code> for function,
|
||
<code class="docutils literal notranslate"><span class="pre">mX</span></code> for map, and <code class="docutils literal notranslate"><span class="pre">X</span></code> for the corresponding number.</li>
|
||
<li>The <code class="docutils literal notranslate"><span class="pre">Clear</span> <span class="pre">All</span></code> button will clear whatever you entered in the text field above.</li>
|
||
<li>This pull-down menu allows to select a theory function which will be added to the text field above by pressing
|
||
the <code class="docutils literal notranslate"><span class="pre">Add</span></code> button. Pre defined theory function starting with a <code class="docutils literal notranslate"><span class="pre">T</span></code> are templates rather than only theory function strings.</li>
|
||
<li>The <code class="docutils literal notranslate"><span class="pre">Add</span></code> button is used to add the chosen theory function / template from the pull-down menu to its left.</li>
|
||
<li>The <code class="docutils literal notranslate"><span class="pre">Check</span></code> button is used to make a syntactical check of whatever is written in the text edit field.</li>
|
||
</ol>
|
||
</div>
|
||
<div class="section" id="musrwiz-functions">
|
||
<span id="index-6"></span><h3>musrWiz - Functions<a class="headerlink" href="#musrwiz-functions" title="Permalink to this headline">¶</a></h3>
|
||
<p>In the Functions dialogue all the necessary functions can be entered. A function operates <em>only</em> on fitting parameters.
|
||
This is different to the theory function which operates on the fitting parameters and the time. The dialogue looks like this</p>
|
||
<img alt="_images/musrWiz-Functions.svg" src="_images/musrWiz-Functions.svg" /><ol class="arabic simple">
|
||
<li>a text edit field in which the various needed functions can be entered. In case a template theory is used, the appropriate function should be shown here and <em>no</em> editing will be needed here.</li>
|
||
<li>pressing <code class="docutils literal notranslate"><span class="pre">Show</span> <span class="pre">Theory</span></code> button will pop-up a little window showing the previously entered theory function. This is handy when defining its own theory, <em>i.e.</em> not working with a template.</li>
|
||
</ol>
|
||
<img alt="_images/musrWiz-Functions-and-Theory.svg" src="_images/musrWiz-Functions-and-Theory.svg" /></div>
|
||
<div class="section" id="musrwiz-maps">
|
||
<span id="index-7"></span><h3>musrWiz - Maps<a class="headerlink" href="#musrwiz-maps" title="Permalink to this headline">¶</a></h3>
|
||
<img alt="_images/musrWiz-Maps.svg" src="_images/musrWiz-Maps.svg" /><p>The map dialogue will list the maps previously used in the theory and functions blocks/dialogues before. Again, if a template is used, nothing needs to be entered here.</p>
|
||
<ol class="arabic simple">
|
||
<li>The <code class="docutils literal notranslate"><span class="pre">Show</span> <span class="pre">Theory</span></code> button allows to show the currently defined theory and the functions.</li>
|
||
</ol>
|
||
</div>
|
||
<div class="section" id="musrwiz-fit-parameters">
|
||
<span id="index-8"></span><h3>musrWiz - Fit Parameters<a class="headerlink" href="#musrwiz-fit-parameters" title="Permalink to this headline">¶</a></h3>
|
||
<img alt="_images/musrWiz-FitParam.svg" src="_images/musrWiz-FitParam.svg" /><p>In the fit parameter dialogue all parameter names can be defined. Furthermore the starting values for the parameters, the step
|
||
(initial step size for the parameter fit), and any boundaries can be defined here.</p>
|
||
<ol class="arabic simple">
|
||
<li>The <code class="docutils literal notranslate"><span class="pre">Show</span> <span class="pre">Theory</span></code> button allows to show the currently defined theory and the functions.</li>
|
||
</ol>
|
||
</div>
|
||
<div class="section" id="musrwiz-fit-info">
|
||
<span id="index-9"></span><h3>musrWiz - Fit Info<a class="headerlink" href="#musrwiz-fit-info" title="Permalink to this headline">¶</a></h3>
|
||
<p>Collects all the <code class="docutils literal notranslate"><span class="pre">musrfit</span></code> and <code class="docutils literal notranslate"><span class="pre">MINUIT2</span></code> specific fit commands.</p>
|
||
<img alt="_images/musrWiz-FitInfo.svg" src="_images/musrWiz-FitInfo.svg" /><ol class="arabic simple">
|
||
<li>allows to define the time fit range (start time, end time).</li>
|
||
<li>packing defines how many bins of the original data shall be combined (added, also called re-binning).</li>
|
||
<li>in this text field to fitting commands are given (see the <code class="docutils literal notranslate"><span class="pre">MINUIT</span></code> and <a class="reference internal" href="user-manual.html#msr-commands-block"><span class="std std-ref">musrfit</span></a> manual for details).</li>
|
||
</ol>
|
||
</div>
|
||
<div class="section" id="musrwiz-create">
|
||
<span id="index-10"></span><h3>musrWiz - Create<a class="headerlink" href="#musrwiz-create" title="Permalink to this headline">¶</a></h3>
|
||
<p>Collects the last necessary information before creating the msr-file.</p>
|
||
<img alt="_images/musrWiz-Create.svg" src="_images/musrWiz-Create.svg" /><ol class="arabic simple">
|
||
<li>shows the path where the msr-file will be saved. If you would like to save it somewhere else press the <code class="docutils literal notranslate"><span class="pre">Save</span> <span class="pre">As</span> <span class="pre">(msr-file</span> <span class="pre">path)</span></code> button.</li>
|
||
<li>pressing this button will allow you to find the path where to save the msr-file.</li>
|
||
<li>pressing this button will save to current configuration as a template for future re-use.</li>
|
||
</ol>
|
||
</div>
|
||
</div>
|
||
<div class="section" id="musrstep">
|
||
<span id="index-11"></span><h2>musrStep<a class="headerlink" href="#musrstep" title="Permalink to this headline">¶</a></h2>
|
||
<p><code class="docutils literal notranslate"><span class="pre">musrStep</span></code> is a little helper program which allows to reset the initial step size. This sometimes comes very handy if working on an instrument
|
||
with many detectors after a fit slightly went wrong leaving you with a far too small initial step size for further iterations. To edit all the steps
|
||
individually is tedious and error prone. Here <code class="docutils literal notranslate"><span class="pre">musrStep</span></code> can help.</p>
|
||
<img alt="_images/musrStep-GUI.svg" src="_images/musrStep-GUI.svg" /><p>When invoking <code class="docutils literal notranslate"><span class="pre">musrStep</span></code> the above dialogue will popup</p>
|
||
<ol class="arabic simple">
|
||
<li>shows the relevant parts of the FITPARAMETER block. The only editable column is step.</li>
|
||
<li><code class="docutils literal notranslate"><span class="pre">Check</span> <span class="pre">Specific</span></code> will popup a dialogue where a template string can be entered, <em>e.g.</em> <code class="docutils literal notranslate"><span class="pre">Asym</span></code>. As a result all fit parameters containing the template string will be selected.</li>
|
||
<li><code class="docutils literal notranslate"><span class="pre">Check</span> <span class="pre">All</span></code> will select all fit parameters.</li>
|
||
<li><code class="docutils literal notranslate"><span class="pre">Uncheck</span> <span class="pre">All</span></code> will unselect all fit parameters.</li>
|
||
<li><code class="docutils literal notranslate"><span class="pre">Modify</span> <span class="pre">Automatic</span></code> will change all the step values automatically. It basically sets all the step sizes to 1% of
|
||
the corresponding fit parameter value, except the phases where the step will be set to a value of 5 degrees.</li>
|
||
<li><code class="docutils literal notranslate"><span class="pre">Modify</span> <span class="pre">Selected</span></code> will start the dialogue shown beneath. Follow the description there.</li>
|
||
<li><code class="docutils literal notranslate"><span class="pre">Save&Quit</span></code> will save the current step values, close the dialogue and reload the modified msr-file.</li>
|
||
<li><code class="docutils literal notranslate"><span class="pre">Cancel</span></code> will cancel the <code class="docutils literal notranslate"><span class="pre">musrStep</span></code> dialogue without modifying anything.</li>
|
||
</ol>
|
||
<img alt="_images/musrStep-Modify-Selected.svg" src="_images/musrStep-Modify-Selected.svg" /><p>When clicking on <code class="docutils literal notranslate"><span class="pre">Modify</span> <span class="pre">Selected</span></code> the above dialogue will be presented. It allows to manipulate all selected fit parameter step values according to the following rules</p>
|
||
<ol class="arabic simple">
|
||
<li><code class="docutils literal notranslate"><span class="pre">Scale</span> <span class="pre">by</span> <span class="pre">Factor</span></code> will scale the step value by the factor given in the field (2). If the <code class="docutils literal notranslate"><span class="pre">Absolute</span> <span class="pre">Value</span></code> check box is selected, rather than scaling the factor value will be used to modify the step value.</li>
|
||
<li>scaling factor or absolute value to modify the step values of the selected fit parameters.</li>
|
||
<li>checking the <code class="docutils literal notranslate"><span class="pre">Absolute</span> <span class="pre">Value</span></code> check box will change the meaning from <em>Scale by Factor</em> to <em>Copy Factor Value</em>.</li>
|
||
<li><code class="docutils literal notranslate"><span class="pre">Scale</span> <span class="pre">Automatically</span></code> will modify the step values of the selected fit parameters according to the rules described before.</li>
|
||
<li><code class="docutils literal notranslate"><span class="pre">Cancel</span></code> will cancel the dialogue.</li>
|
||
</ol>
|
||
</div>
|
||
</div>
|
||
|
||
|
||
</div>
|
||
|
||
</div>
|
||
<footer>
|
||
|
||
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
||
|
||
<a href="mupp.html" class="btn btn-neutral float-right" title="mupp - μSR Parameter Plotter" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
|
||
|
||
|
||
<a href="setup-dks.html" class="btn btn-neutral" title="Setting up musrfit / DKS: High Speed Fitting with GPU’s" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
|
||
|
||
</div>
|
||
|
||
|
||
<hr/>
|
||
|
||
<div role="contentinfo">
|
||
<p>
|
||
© Copyright 2023, Andreas Suter.
|
||
Last updated on Aug 17, 2023.
|
||
|
||
</p>
|
||
</div>
|
||
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
|
||
|
||
</footer>
|
||
|
||
</div>
|
||
</div>
|
||
|
||
</section>
|
||
|
||
</div>
|
||
|
||
|
||
|
||
|
||
|
||
<script type="text/javascript">
|
||
var DOCUMENTATION_OPTIONS = {
|
||
URL_ROOT:'./',
|
||
VERSION:'1.9.1',
|
||
LANGUAGE:'None',
|
||
COLLAPSE_INDEX:false,
|
||
FILE_SUFFIX:'.html',
|
||
HAS_SOURCE: true,
|
||
SOURCELINK_SUFFIX: '.txt'
|
||
};
|
||
</script>
|
||
<script type="text/javascript" src="_static/jquery.js"></script>
|
||
<script type="text/javascript" src="_static/underscore.js"></script>
|
||
<script type="text/javascript" src="_static/doctools.js"></script>
|
||
<script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
|
||
|
||
|
||
|
||
|
||
|
||
<script type="text/javascript" src="_static/js/theme.js"></script>
|
||
|
||
|
||
<script type="text/javascript">
|
||
jQuery(function () {
|
||
SphinxRtdTheme.Navigation.enable(true);
|
||
});
|
||
</script>
|
||
|
||
</body>
|
||
</html> |