updated of docu
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
<!DOCTYPE html><html lang="en">
|
||||
|
||||
<!-- Mirrored from intranet.psi.ch/MUSR/MusrFit?cover=print by HTTrack Website Copier/3.x [XR&CO'2010], Fri, 22 Jan 2016 15:12:23 GMT -->
|
||||
<!-- Mirrored from intranet.psi.ch/MUSR/MusrFit?cover=print by HTTrack Website Copier/3.x [XR&CO'2010], Tue, 26 Apr 2016 06:39:07 GMT -->
|
||||
<!-- Added by HTTrack --><meta http-equiv="content-type" content="text/html;charset=utf-8"><!-- /Added by HTTrack -->
|
||||
<head>
|
||||
<link rel="stylesheet" href="../pub/System/HeadlinesPlugin/style.css" type="text/css" media="all" />
|
||||
@@ -14,12 +14,13 @@
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
|
||||
<link rel="icon" href="../pub/Main/WebPreferences/favicon.ico" type="image/x-icon" />
|
||||
<link rel="shortcut icon" href="../pub/Main/WebPreferences/favicon.ico" type="image/x-icon" />
|
||||
<link rel="alternate" href="https://intranet.psi.ch/wiki/bin/edit/MUSR/MusrFit?t=1453475522" type="application/x-wiki" title="edit MusrFit" />
|
||||
<link rel="alternate" href="https://intranet.psi.ch/wiki/bin/edit/MUSR/MusrFit?t=1461652731" type="application/x-wiki" title="edit MusrFit" />
|
||||
<meta name="TEXT_NUM_TOPICS" content="Number of topics:" />
|
||||
<meta name="TEXT_MODIFY_SEARCH" content="Modify search" />
|
||||
<meta name="robots" content="noindex" /><link rel="alternate" type="application/rss+xml" title="RSS Feed" href="WebRsshtml.html" />
|
||||
<base /><!--[if IE]></base><![endif]--><link class='head JQUERYPLUGIN::COMMENT' rel='stylesheet' href='../pub/System/CommentPlugin/commentf5b6.css?version=3.0' type='text/css' media='all' /><!--JQUERYPLUGIN::COMMENT-->
|
||||
<link class='head CLASSIFICATIONPLUGIN::CSS' rel="stylesheet" href="../pub/System/ClassificationPlugin/styles.css" media="all" /><!--CLASSIFICATIONPLUGIN::CSS-->
|
||||
<base /><!--[if IE]></base><![endif]--><link class='head FOOTNOTEPLUGIN_LINKCSS' rel="stylesheet" href="../pub/System/FootNotePlugin/styles.css" type="text/css" media="all" /><!--FOOTNOTEPLUGIN_LINKCSS-->
|
||||
<link class='head JQUERYPLUGIN::COMMENT' rel='stylesheet' href='../pub/System/CommentPlugin/commentf5b6.css?version=3.0' type='text/css' media='all' /><!--JQUERYPLUGIN::COMMENT-->
|
||||
<link class='head IMAGEPLUGIN' rel="stylesheet" href="../pub/System/ImagePlugin/style.css" type="text/css" media="all" /><!--IMAGEPLUGIN-->
|
||||
<link class='head SMILIESPLUGIN' rel='stylesheet' href='../pub/System/SmiliesPlugin/smilies.css' type='text/css' media='all' /><!--SMILIESPLUGIN-->
|
||||
<style class='head TABLEPLUGIN_default' type="text/css" media="all">
|
||||
body .foswikiTable {border-width:1px}
|
||||
@@ -35,8 +36,7 @@ body .foswikiTable tr.foswikiTableRowdataBg0 td.foswikiSortedCol {background-col
|
||||
body .foswikiTable tr.foswikiTableRowdataBg1 td {background-color:#f7f7f6}
|
||||
body .foswikiTable tr.foswikiTableRowdataBg1 td.foswikiSortedCol {background-color:#f0f0ee}
|
||||
</style><!--TABLEPLUGIN_default-->
|
||||
<link class='head FOOTNOTEPLUGIN_LINKCSS' rel="stylesheet" href="../pub/System/FootNotePlugin/styles.css" type="text/css" media="all" /><!--FOOTNOTEPLUGIN_LINKCSS-->
|
||||
<link class='head IMAGEPLUGIN' rel="stylesheet" href="../pub/System/ImagePlugin/style.css" type="text/css" media="all" /><!--IMAGEPLUGIN--><link rel='stylesheet' href='../pub/System/SkinTemplates/base.css' media='all' type='text/css' />
|
||||
<link class='head CLASSIFICATIONPLUGIN::CSS' rel="stylesheet" href="../pub/System/ClassificationPlugin/styles.css" media="all" /><!--CLASSIFICATIONPLUGIN::CSS--><link rel='stylesheet' href='../pub/System/SkinTemplates/base.css' media='all' type='text/css' />
|
||||
<style type="text/css" media="all">
|
||||
@import url('../pub/System/PatternSkinTheme/layout.css');
|
||||
@import url('../pub/System/PatternSkinTheme2009/style.css');
|
||||
@@ -117,17 +117,17 @@ body .foswikiTable tr.foswikiTableRowdataBg1 td.foswikiSortedCol {background-col
|
||||
<!--<![endif]-->
|
||||
<!--JQUERYPLUGIN-->
|
||||
<!--JQUERYPLUGIN::MIGRATE-->
|
||||
<!--JQUERYPLUGIN::LIVEQUERY-->
|
||||
<!--JQUERYPLUGIN::FOSWIKI-->
|
||||
<!--JQUERYPLUGIN::METADATA-->
|
||||
|
||||
<!--JQUERYPLUGIN::CHILI-->
|
||||
<!--JQUERYPLUGIN::LIVEQUERY-->
|
||||
<!--JavascriptFiles/foswikiString-->
|
||||
<!--JavascriptFiles/foswikiPref-->
|
||||
<!--JavascriptFiles/foswikiForm-->
|
||||
<!--PatternSkin/pattern-->
|
||||
<!--JQUERYPLUGIN::FOSWIKI::PREFERENCES-->
|
||||
<!--JQUERYPLUGIN::COMMENT--><link class='head FOOTNOTEPLUGIN_LINKCSS' rel="stylesheet" href="../pub/System/FootNotePlugin/styles.css" type="text/css" media="all" /><!--FOOTNOTEPLUGIN_LINKCSS-->
|
||||
<!--JQUERYPLUGIN::METADATA-->
|
||||
|
||||
<!--JQUERYPLUGIN::CHILI-->
|
||||
<!--JQUERYPLUGIN::COMMENT-->
|
||||
<!--JQUERYPLUGIN::FOSWIKI::PREFERENCES--><link class='head FOOTNOTEPLUGIN_LINKCSS' rel="stylesheet" href="../pub/System/FootNotePlugin/styles.css" type="text/css" media="all" /><!--FOOTNOTEPLUGIN_LINKCSS-->
|
||||
</head>
|
||||
<body class="foswikiNoJs patternViewPage patternPrintPage">
|
||||
<span id="PageTop"></span><div class="foswikiPage"><div id="patternScreen">
|
||||
@@ -209,7 +209,7 @@ If called from within a shell it accepts several parameters: <dl>
|
||||
<p></p>
|
||||
If called with a msr input file, e.g.
|
||||
<pre class="bash">musrfit 8472.msr</pre>
|
||||
the fit described in the input file will be executed and the results will be written to a mlog output file—in the example <code><b>8472.mlog</b></code>. When the fitting has terminated the msr file and the mlog file are swapped, so that the resultant parameter values can be found in the msr file and the mlog file contains a copy of the input file. The format of the mlog file is the same as that of the msr file. For a detailed description of the msr file format refer to <a href="#DescriptionOfTheMsrFileFormat" class="foswikiCurrentTopicLink">the corresponding section</a>.
|
||||
the fit described in the input file will be executed and the results will be written to a mlog output file—in the example <code><b>8472.mlog</b></code>. When the fitting has terminated the msr file and the mlog file are swapped, so that the resultant parameter values can be found in the msr file and the mlog file contains a copy of the input file. The format of the mlog file is the same as that of the msr file. For a detailed description of the msr file format refer to <a class="foswikiCurrentTopicLink" href="#DescriptionOfTheMsrFileFormat">the corresponding section</a>.
|
||||
<p></p>
|
||||
<span id="MusrView"></span>
|
||||
<h2 id="A_2.2_musrview"> 2.2 musrview </h2>
|
||||
@@ -310,7 +310,7 @@ Additionally, some functions can be accessed using key-shortcuts: <dl>
|
||||
The interactive mode of <code>musrt0</code> is started if the program is called with a sole msr-file argument, e.g.
|
||||
<pre class="bash">musrt0 8472.msr</pre>
|
||||
Then a <code>ROOT</code> canvas depicting the histogram of the data set mentioned first in the <a class="foswikiCurrentTopicLink" href="#TheRunBlock">RUN block</a> is drawn in different colors:<br />
|
||||
<img class='imagePlain imagePlain_center ' src='../pub/MUSR/MusrFit/igp_30b1bd03f016c26e55e7a3979538e223_musrt0.png' alt='musrt0' title='musrt0.png' width='626' height='424' style='' /><br />
|
||||
<img class='imagePlain imagePlain_center ' src='../pub/MUSR/MusrFit/igp_a66e7f65af64996b805ac54a0eba1f8c_musrt0.png' alt='musrt0' title='musrt0.png' width='626' height='424' style='' /><br />
|
||||
The colors of the data points represent the choice of the time windows of <strong><span class='foswikiBlueFG'>data (blue)</span></strong> and <strong><span class='foswikiRedFG'>background (red)</span></strong>, as well as <strong><span class='foswikiGreenFG'>t0 (green line)</span></strong>. In order to change these ranges the mouse cross-hair is moved to a channel of choice and one of the following keys is pressed: <dl>
|
||||
<dt> q </dt><dd> close the currently open histogram and opens the next (see also below)
|
||||
</dd> <dt> Q </dt><dd> quit <code>musrt0</code> without writing into the msr file
|
||||
@@ -332,8 +332,8 @@ Closing a window by clicking the <strong>X</strong> button is equivalent to pres
|
||||
<h2 id="A_2.5_musrfit_startup.xml"> 2.5 musrfit_startup.xml </h2>
|
||||
<code><b>musrfit_startup.xml</b></code> is a configuration file located at the <code>musrfit</code> binary path. In this file the following XML tags are allowed to define settings: <dl>
|
||||
<dt> <data_path>PATH_TO_DATA</data_path> </dt><dd> add the new path <strong>PATH_TO_DATA</strong> where <code>musrfit</code> and <code>musrview</code> will search for data files
|
||||
</dd> <dt> <write_per_run_block_chisq><b>y/n</b></write_per_run_block_chisq> </dt><dd> if enabled χ<sup>2</sup> for each RUN block will be written to the <a class="foswikiCurrentTopicLink" href="#TheStatisticBlock">STATISTIC block</a> of the resulting <code>msr</code> file. Additionally, in case a χ<sup>2</sup> <a href="#SingleHistogramFit" class="foswikiCurrentTopicLink">single-histogram fit</a> is done, also <a href="http://en.wikipedia.org/wiki/Pearson's_chi-square_test">Pearson's χ<sup>2</sup></a> will be added.
|
||||
</dd> <dt> <fourier_settings></fourier_settings> </dt><dd> set the default parameters for the Fourier transform in <code>musrview</code>. For further details refer to <a href="#TheFourierBlock" class="foswikiCurrentTopicLink">the description of the msr file</a>. <dl>
|
||||
</dd> <dt> <write_per_run_block_chisq><b>y/n</b></write_per_run_block_chisq> </dt><dd> if enabled χ<sup>2</sup> for each RUN block will be written to the <a class="foswikiCurrentTopicLink" href="#TheStatisticBlock">STATISTIC block</a> of the resulting <code>msr</code> file. Additionally, in case a χ<sup>2</sup> <a class="foswikiCurrentTopicLink" href="#SingleHistogramFit">single-histogram fit</a> is done, also <a href="http://en.wikipedia.org/wiki/Pearson's_chi-square_test">Pearson's χ<sup>2</sup></a> will be added.
|
||||
</dd> <dt> <fourier_settings></fourier_settings> </dt><dd> set the default parameters for the Fourier transform in <code>musrview</code>. For further details refer to <a class="foswikiCurrentTopicLink" href="#TheFourierBlock">the description of the msr file</a>. <dl>
|
||||
<dt> <units>UNITS</units> </dt><dd> specify the units of the frequency or field-domain. Valid units are <strong>Gauss</strong>, <strong>MHz</strong> and <strong>Mc/s</strong> (inside a <fourier_settings> environment)
|
||||
</dd> <dt> <fourier_power><i>n</i></fourier_power> </dt><dd> specify the number of points 2<sup><b><i>n</i></b></sup> (<b><i>n</i></b> < 21) to be used for the Fourier transform (inside a <fourier_settings> environment)
|
||||
</dd> <dt> <apodization>APOD</apodization> </dt><dd> set the default apodization method. Valid apodizations are <strong>none</strong>, <strong>weak</strong>, <strong>medium</strong> and <strong>strong</strong> (inside a <fourier_settings> environment)
|
||||
@@ -470,7 +470,7 @@ are various possible parameter definitions which are listed here:
|
||||
2. <no> <name> <value> <step> <lower_boundary> <upper_boundary>
|
||||
3. <no> <name> <value> <step> <pos_error> <lower_boundary> <upper_boundary>
|
||||
</pre>
|
||||
where <strong><no></strong> is the parameter number, <strong><name></strong> is the parameter name <a name="FootNote1text"></a><span class="FootNoteTextLink" title=" a standard string without whitespace "><a href="#FootNote1note" class="foswikiCurrentTopicLink">(1)</a></span>, <strong><value></strong> is the initial guess of the parameter, <strong><step></strong> the inital step width, <strong><lower/upper_boundary></strong> is the lower/upper boundary for the parameter <a name="FootNote2text"></a><span class="FootNoteTextLink" title=" According to the =MINUIT= manual this should be avoided whenever possible! "><a class="foswikiCurrentTopicLink" href="#FootNote2note">(2)</a></span>.
|
||||
where <strong><no></strong> is the parameter number, <strong><name></strong> is the parameter name <a name="FootNote1text"></a><span class="FootNoteTextLink" title=" a standard string without whitespace "><a class="foswikiCurrentTopicLink" href="#FootNote1note">(1)</a></span>, <strong><value></strong> is the initial guess of the parameter, <strong><step></strong> the inital step width, <strong><lower/upper_boundary></strong> is the lower/upper boundary for the parameter <a name="FootNote2text"></a><span class="FootNoteTextLink" title=" According to the =MINUIT= manual this should be avoided whenever possible! "><a class="foswikiCurrentTopicLink" href="#FootNote2note">(2)</a></span>.
|
||||
<p></p>
|
||||
In the output file, <strong><value></strong> will be the <code>MINUIT</code> fit value, <strong><step></strong> will contain the error estimate (or the negative error estimate if <code>MINOS</code> was successfully used), <strong><pos_error></strong> will have the value <strong>none</strong> if <code>MINOS</code> has not been used, otherwise it will show the positive error estimate.
|
||||
<p></p>
|
||||
@@ -507,9 +507,9 @@ There is also the possibility to constrain the parameters to semi-defined interv
|
||||
<p></p>
|
||||
Notes
|
||||
<p></p>
|
||||
<a name="FootNote1note"></a><span class="FootNoteLabel"><a href="MusrFit.html#FootNote1text" class="foswikiCurrentWebHomeLink"> <strong>1</strong> </a></span>: <span class="FootNote"> a standard string without whitespace </span>
|
||||
<a name="FootNote1note"></a><span class="FootNoteLabel"><a href="#FootNote1text"><b>1</b></a></span>: <span class="FootNote"> a standard string without whitespace </span>
|
||||
<p></p>
|
||||
<a name="FootNote2note"></a><span class="FootNoteLabel"><a class="foswikiCurrentWebHomeLink" href="MusrFit.html#FootNote2text"> <strong>2</strong> </a></span>: <span class="FootNote"> According to the <code>MINUIT</code> manual this should be avoided whenever possible! </span>
|
||||
<a name="FootNote2note"></a><span class="FootNoteLabel"><a href="#FootNote2text"><b>2</b></a></span>: <span class="FootNote"> According to the <code>MINUIT</code> manual this should be avoided whenever possible! </span>
|
||||
<p></p>
|
||||
<p></p>
|
||||
<p></p>
|
||||
@@ -523,11 +523,11 @@ The THEORY block is used to define the fit function. There is a set of predefine
|
||||
<table border="1" class="foswikiTable" rules="none">
|
||||
<thead>
|
||||
<tr class="foswikiTableOdd foswikiTableRowdataBgSorted0 foswikiTableRowdataBg0">
|
||||
<th class="foswikiTableCol0 foswikiFirstCol"> <a title="Sort by this column" rel="nofollow" href="https://intranet.psi.ch/MUSR/MusrFit?cover=print;sortcol=0;table=1;up=0#sorted_table">name</a> </th>
|
||||
<th class="foswikiTableCol1"> <a title="Sort by this column" rel="nofollow" href="https://intranet.psi.ch/MUSR/MusrFit?cover=print;sortcol=1;table=1;up=0#sorted_table">abbreviation</a> </th>
|
||||
<th class="foswikiTableCol2"> <a title="Sort by this column" rel="nofollow" href="https://intranet.psi.ch/MUSR/MusrFit?cover=print;sortcol=2;table=1;up=0#sorted_table">parameters</a> </th>
|
||||
<th class="foswikiTableCol3"> <a title="Sort by this column" rel="nofollow" href="https://intranet.psi.ch/MUSR/MusrFit?cover=print;sortcol=3;table=1;up=0#sorted_table">mathematical expression</a> </th>
|
||||
<th rowspan="6" class="foswikiTableCol4 foswikiLastCol"> <a href="https://intranet.psi.ch/MUSR/MusrFit?cover=print;sortcol=4;table=1;up=0#sorted_table" title="Sort by this column" rel="nofollow">reference</a> </th>
|
||||
<th class="foswikiTableCol0 foswikiFirstCol"> <a href="https://intranet.psi.ch/MUSR/MusrFit?cover=print;sortcol=0;table=1;up=0#sorted_table" rel="nofollow" title="Sort by this column">name</a> </th>
|
||||
<th class="foswikiTableCol1"> <a href="https://intranet.psi.ch/MUSR/MusrFit?cover=print;sortcol=1;table=1;up=0#sorted_table" rel="nofollow" title="Sort by this column">abbreviation</a> </th>
|
||||
<th class="foswikiTableCol2"> <a href="https://intranet.psi.ch/MUSR/MusrFit?cover=print;sortcol=2;table=1;up=0#sorted_table" rel="nofollow" title="Sort by this column">parameters</a> </th>
|
||||
<th class="foswikiTableCol3"> <a href="https://intranet.psi.ch/MUSR/MusrFit?cover=print;sortcol=3;table=1;up=0#sorted_table" rel="nofollow" title="Sort by this column">mathematical expression</a> </th>
|
||||
<th class="foswikiTableCol4 foswikiLastCol" rowspan="6"> <a href="https://intranet.psi.ch/MUSR/MusrFit?cover=print;sortcol=4;table=1;up=0#sorted_table" rel="nofollow" title="Sort by this column">reference</a> </th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
@@ -580,14 +580,14 @@ The THEORY block is used to define the fit function. There is a set of predefine
|
||||
<td class="foswikiTableCol1"> dgktlf </td>
|
||||
<td class="foswikiTableCol2"> <img alt="\nu\,(\mathrm{MHz})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_7188605a647615e4fb92cc89274b22a0.png" />, <img alt="\sigma\,(\mu\text{s}^{-1})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_6b6bbc4add4da0bde8220c54594658f3.png" />, <img alt="\Gamma\,(\mathrm{MHz})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_f87b1352f663a35bf263bc7e9a214ca3.png" /> </td>
|
||||
<td class="foswikiTableCol3"> <img alt="\frac{1}{2\pi \imath}\int_{\gamma-\imath\infty}^{\gamma+\imath\infty} \frac{f_{\mathrm{G}}(s+\Gamma)}{1-\Gamma f_{\mathrm{G}}(s+\Gamma)} \exp(s t) \mathrm{d}s,\mathrm{where}\,f_{\mathrm{G}}(s)\equiv \int_0^{\infty}G_{\mathrm{G,LF}}(t)\exp(-s t) \mathrm{d}t" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_cb688f85a062f09bfaff5cf9144860a9.png" /> </td>
|
||||
<td class="foswikiTableCol4 foswikiLastCol"> <a name="FootNote4text"></a><span class="FootNoteTextLink" title=" R. S. Hayano _et al._, [[http://link.aps.org/doi/10.1103/PhysRevB.20.850][Phys. Rev. B *20* (1979) 850]]; P. Dalmas de R&eacute;otier and A. Yaouanc, [[http://dx.doi.org/10.1088/0953-8984/4/18/020][J. Phys.: Condens. Matter *4* (1992) 4533]]; A. Keren, [[http://link.aps.org/doi/10.1103/PhysRevB.50.10039][Phys. Rev. B *50* (1994) 10039]] "><a href="#FootNote4note" class="foswikiCurrentTopicLink">(5)</a></span> </td>
|
||||
<td class="foswikiTableCol4 foswikiLastCol"> <a name="FootNote4text"></a><span class="FootNoteTextLink" title=" R. S. Hayano _et al._, [[http://link.aps.org/doi/10.1103/PhysRevB.20.850][Phys. Rev. B *20* (1979) 850]]; P. Dalmas de R&eacute;otier and A. Yaouanc, [[http://dx.doi.org/10.1088/0953-8984/4/18/020][J. Phys.: Condens. Matter *4* (1992) 4533]]; A. Keren, [[http://link.aps.org/doi/10.1103/PhysRevB.50.10039][Phys. Rev. B *50* (1994) 10039]] "><a class="foswikiCurrentTopicLink" href="#FootNote4note">(5)</a></span> </td>
|
||||
</tr>
|
||||
<tr class="foswikiTableEven foswikiTableRowdataBgSorted0 foswikiTableRowdataBg0">
|
||||
<td class="foswikiTableCol0 foswikiFirstCol"> statExpKT </td>
|
||||
<td class="foswikiTableCol1"> sekt </td>
|
||||
<td class="foswikiTableCol2"> <img alt="\lambda\,(\mu\text{s}^{-1})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_020e973cf5b1293c76cb3ecef5a269f8.png" /> </td>
|
||||
<td class="foswikiTableCol3"> <img alt="\frac{1}{3} + \frac{2}{3} \left[1-\lambda t\right] \exp\left(-\lambda t\right)" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_6466a97e4b7c510909bffce51d31c4b9.png" /> </td>
|
||||
<td class="foswikiTableCol4 foswikiLastCol"> <a name="FootNote5text"></a><span class="FootNoteTextLink" title=" Y. J. Uemura _et al._, [[http://link.aps.org/doi/10.1103/PhysRevB.31.546][Phys. Rev. B *31* (1985) 546]] "><a href="#FootNote5note" class="foswikiCurrentTopicLink">(6)</a></span> </td>
|
||||
<td class="foswikiTableCol4 foswikiLastCol"> <a name="FootNote5text"></a><span class="FootNoteTextLink" title=" Y. J. Uemura _et al._, [[http://link.aps.org/doi/10.1103/PhysRevB.31.546][Phys. Rev. B *31* (1985) 546]] "><a class="foswikiCurrentTopicLink" href="#FootNote5note">(6)</a></span> </td>
|
||||
</tr>
|
||||
<tr class="foswikiTableOdd foswikiTableRowdataBgSorted1 foswikiTableRowdataBg1">
|
||||
<td class="foswikiTableCol0 foswikiFirstCol"> statExpKTLF </td>
|
||||
@@ -615,7 +615,7 @@ The THEORY block is used to define the fit function. There is a set of predefine
|
||||
<td class="foswikiTableCol1"> skt </td>
|
||||
<td class="foswikiTableCol2"> <img alt="\sigma\,(\mu\text{s}^{-1})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_6b6bbc4add4da0bde8220c54594658f3.png" />, <img alt="\beta\,(1)" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_aad467dd15ac57481f24ada5fbe5d85f.png" /> </td>
|
||||
<td class="foswikiTableCol3"> <img alt="\frac{1}{3}+\frac{2}{3}\left[1-(\sigma t)^\beta\right] \exp\left[-(\sigma t)^\beta / \beta \right]" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_63b1658426cdac24a0730149c3b5ea80.png" /> </td>
|
||||
<td class="foswikiTableCol4 foswikiLastCol"> <a name="FootNote8text"></a><span class="FootNoteTextLink" title=" M.R. Crook and R. Cywinski, [[http://dx.doi.org/10.1088/0953-8984/9/5/018][J. Phys.: Condens. Matter *9* (1997) 1149]] "><a href="#FootNote8note" class="foswikiCurrentTopicLink">(9)</a></span> </td>
|
||||
<td class="foswikiTableCol4 foswikiLastCol"> <a name="FootNote8text"></a><span class="FootNoteTextLink" title=" M.R. Crook and R. Cywinski, [[http://dx.doi.org/10.1088/0953-8984/9/5/018][J. Phys.: Condens. Matter *9* (1997) 1149]] "><a class="foswikiCurrentTopicLink" href="#FootNote8note">(9)</a></span> </td>
|
||||
</tr>
|
||||
<tr class="foswikiTableOdd foswikiTableRowdataBgSorted1 foswikiTableRowdataBg1">
|
||||
<td class="foswikiTableCol0 foswikiFirstCol"> spinGlass </td>
|
||||
@@ -629,7 +629,7 @@ The THEORY block is used to define the fit function. There is a set of predefine
|
||||
<td class="foswikiTableCol1"> rahf </td>
|
||||
<td class="foswikiTableCol2"> <img alt="\nu\,(\mathrm{MHz})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_7188605a647615e4fb92cc89274b22a0.png" />, <img alt="\lambda\,(\mu\text{s}^{-1})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_020e973cf5b1293c76cb3ecef5a269f8.png" /> </td>
|
||||
<td class="foswikiTableCol3"> <img alt="\frac{1}{6}\left(1-\frac{\nu t}{2}\right)\exp\left(-\frac{\nu t}{2}\right)+\frac{1}{3}\left(1-\frac{\nu t}{4}\right)\exp\left(-\frac{\nu t + 2.44949\lambda t}{4}\right)" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_f91ff8255a7b8a99c5eefcb2c29f9262.png" /> </td>
|
||||
<td class="foswikiTableCol4 foswikiLastCol"> <a name="FootNote9text"></a><span class="FootNoteTextLink" title=" R. E. Turner and D. R. Harshman, [[http://link.aps.org/doi/10.1103/PhysRevB.34.4467][Phys. Rev. B *34* (1986) 4467]] "><a href="#FootNote9note" class="foswikiCurrentTopicLink">(9)</a></span> </td>
|
||||
<td class="foswikiTableCol4 foswikiLastCol"> <a name="FootNote9text"></a><span class="FootNoteTextLink" title=" R. E. Turner and D. R. Harshman, [[http://link.aps.org/doi/10.1103/PhysRevB.34.4467][Phys. Rev. B *34* (1986) 4467]] "><a class="foswikiCurrentTopicLink" href="#FootNote9note">(9)</a></span> </td>
|
||||
</tr>
|
||||
<tr class="foswikiTableOdd foswikiTableRowdataBgSorted1 foswikiTableRowdataBg1">
|
||||
<td class="foswikiTableCol0 foswikiFirstCol"> TFieldCos </td>
|
||||
@@ -678,7 +678,7 @@ The THEORY block is used to define the fit function. There is a set of predefine
|
||||
<td class="foswikiTableCol1"> snkzf </td>
|
||||
<td class="foswikiTableCol2"> <img alt="\Delta_0\,(\mu\text{s}^{-1})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_30b87ca180341a9f8f9a15c1082f7f29.png" />, <img alt="R_b = \Delta_{\mathrm{GbG}}/\Delta_0 \,(\text{1})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_5563541e58443a8d18e5bd40d2746e9a.png" /> </td>
|
||||
<td class="foswikiTableCol3"> <img alt="\frac{1}{3}+\frac{2}{3}\left(\frac{1}{1+R_b^2\Delta_0^2 t^2}\right)^{3/2} \left(1-\frac{\Delta_0^2 t^2}{1+R_b^2\Delta_0^2 t^2}\right)\,\exp\left[-\frac{\Delta_0^2 t^2}{2(1+R_b^2\Delta_0^2 t^2)}\right]" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_d5edc50e5c0ce856d632a5a682e0347f.png" /> </td>
|
||||
<td class="foswikiTableCol4 foswikiLastCol"> <a name="FootNote10text"></a><span class="FootNoteTextLink" title=" D.R. Noakes and G.M. Kalvius, [[http://link.aps.org/doi/10.1103/PhysRevB.56.2352][Phys. Rev. B *56* (1997) 2352]]; A. Yaouanc and P. Dalmas de R&eacute;otier "Muon Spin Rotation, Relaxation, and Resonance" Oxford Scientific Publication; simplifying the original formulae by eliminating <latex>\Delta_{\rm eff}</latex> via the identity <latex>\Delta_{\rm eff}^2 = (1+R_b^2) \Delta_0</latex> "><a href="#FootNote10note" class="foswikiCurrentTopicLink">(10)</a></span> </td>
|
||||
<td class="foswikiTableCol4 foswikiLastCol"> <a name="FootNote10text"></a><span class="FootNoteTextLink" title=" D.R. Noakes and G.M. Kalvius, [[http://link.aps.org/doi/10.1103/PhysRevB.56.2352][Phys. Rev. B *56* (1997) 2352]]; A. Yaouanc and P. Dalmas de R&eacute;otier "Muon Spin Rotation, Relaxation, and Resonance" Oxford Scientific Publication; simplifying the original formulae by eliminating <latex>\Delta_{\rm eff}</latex> via the identity <latex>\Delta_{\rm eff}^2 = (1+R_b^2) \Delta_0</latex> "><a class="foswikiCurrentTopicLink" href="#FootNote10note">(10)</a></span> </td>
|
||||
</tr>
|
||||
<tr class="foswikiTableEven foswikiTableRowdataBgSorted0 foswikiTableRowdataBg0">
|
||||
<td class="foswikiTableCol0 foswikiFirstCol"> staticNKTF </td>
|
||||
@@ -692,16 +692,23 @@ The THEORY block is used to define the fit function. There is a set of predefine
|
||||
<td class="foswikiTableCol1"> dnkzf </td>
|
||||
<td class="foswikiTableCol2"> <img alt="\Delta_0\,(\mu\text{s}^{-1})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_30b87ca180341a9f8f9a15c1082f7f29.png" />, <img alt="R_b = \Delta_{\mathrm{GbG}}/\Delta_0\,(\text{1})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_b7d61ac387fd12b956816be1c6c9a577.png" />, <img alt="\nu_c\,(\text{MHz})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_c4bdea6bbc03bcca6d713519e7bab071.png" /> </td>
|
||||
<td class="foswikiTableCol3"> <img alt="\sqrt{\frac{1}{1+4 R_b^2\Delta_0^2 \Theta(t)}}\,\exp\left[-\frac{2 \Delta_0^2 \Theta(t)}{1+4 R_b^2\Delta_0^2 \Theta(t)}\right]\quad,\, \Theta(t) = \frac{\exp(-\nu_c t) - 1 - \nu_c t}{\nu_c^2}" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_af36b27f661f5b8a569f5672d18f8844.png" /> </td>
|
||||
<td class="foswikiTableCol4"> see note 10 </td>
|
||||
<td class="foswikiTableCol4 foswikiLastCol"> see note 10 </td>
|
||||
</tr>
|
||||
<tr class="foswikiTableEven foswikiTableRowdataBgSorted0 foswikiTableRowdataBg0">
|
||||
<td class="foswikiTableCol0 foswikiFirstCol"> dynamicNKTF </td>
|
||||
<td class="foswikiTableCol1"> dnktf </td>
|
||||
<td class="foswikiTableCol2"> <img alt="\varphi\,(^{\circ})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_61136f20673ad20f955c43e43b8cec9d.png" />, <img alt="\nu\,(\mathrm{MHz})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_7188605a647615e4fb92cc89274b22a0.png" />, <img alt="\Delta_0\,(\mu\text{s}^{-1})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_30b87ca180341a9f8f9a15c1082f7f29.png" />, <img alt="R_b = \Delta_{\mathrm{GbG}}/\Delta_0\,(\text{1})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_b7d61ac387fd12b956816be1c6c9a577.png" />, <img alt="\nu_c\,(\text{MHz})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_c4bdea6bbc03bcca6d713519e7bab071.png" /> </td>
|
||||
<td class="foswikiTableCol3"> <img alt="\sqrt{\frac{1}{1+2 R_b^2\Delta_0^2 \Theta(t)}}\,\exp\left[-\frac{\Delta_0^2 \Theta(t)}{1+2 R_b^2\Delta_0^2 \Theta(t)}\right]\, \cos(\nu t + \varphi) \quad,\, \Theta(t) = \frac{\exp(-\nu_c t) - 1 - \nu_c t}{\nu_c^2}" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_c7fe4fcfd08f7d4ca8638228bb83b4f9.png" /> </td>
|
||||
<td class="foswikiTableCol4 foswikiLastCol"> see note 10 </td>
|
||||
<td class="foswikiTableCol3"> <img alt="\sqrt{\frac{1}{1+2 R_b^2\Delta_0^2 \Theta(t)}}\,\exp\left[-\frac{\Delta_0^2 \Theta(t)}{1+2 R_b^2\Delta_0^2 \Theta(t)}\right]\, \cos(2\pi \nu t + \varphi) \quad,\, \Theta(t) = \frac{\exp(-\nu_c t) - 1 - \nu_c t}{\nu_c^2}" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_466fcb53c3da4f84fb2d12e03eef9439.png" /> </td>
|
||||
<td class="foswikiTableCol4"> see note 10 </td>
|
||||
</tr>
|
||||
<tr class="foswikiTableOdd foswikiTableRowdataBgSorted1 foswikiTableRowdataBg1">
|
||||
<td class="foswikiTableCol0 foswikiFirstCol"> muMinusExpTF </td>
|
||||
<td class="foswikiTableCol1"> mmsetf </td>
|
||||
<td class="foswikiTableCol2"> <img alt="N_0\,(1)" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_fcadee367bc447abe1119778b6fa1a14.png" />, <img alt="\tau\,(\mu s)" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_545dca52882440763fc3ac973a36852a.png" />, <img alt="A\,(1)" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_facd1d42ae8b62aa1043316d525d3af4.png" />, <img alt="\lambda\,(\mu s^{-1})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_319772b46bc6861fbe24a28e59530ade.png" />, <img alt="\varphi\,(^{\circ})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_61136f20673ad20f955c43e43b8cec9d.png" />, <img alt="\nu\,(\mathrm{MHz})" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_7188605a647615e4fb92cc89274b22a0.png" /> </td>
|
||||
<td class="foswikiTableCol3"> <img alt="N_0 \exp(-t/\tau) \left[ 1 + A \exp(-\lambda t) \cos(2\pi \nu t + \varphi) \right]" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_57316547e3b34dd9d537b722e4a0e176.png" /> </td>
|
||||
<td class="foswikiTableCol4 foswikiLastCol"> <a name="FootNote11text"></a><span class="FootNoteTextLink" title=" This function is explicit for <latex>\mu^-</latex>! Do not try to use it for <latex>\mu^+</latex>. "><a class="foswikiCurrentTopicLink" href="#FootNote11note">(11)</a></span> </td>
|
||||
</tr>
|
||||
<tr class="foswikiTableEven foswikiTableRowdataBgSorted0 foswikiTableRowdataBg0">
|
||||
<td class="foswikiTableCol0 foswikiFirstCol foswikiLast"> polynom </td>
|
||||
<td class="foswikiTableCol1 foswikiLast"> p </td>
|
||||
<td class="foswikiTableCol2 foswikiLast"> <img alt="t_0\,([t])" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_20651e8230c7eb66c452bb1f01dc4633.png" />, <img alt="a_0\,(1),\,a_1\,(1),\,\dots,\,a_{n}\,(1)" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_03095d51eca2bcb1dda113e995238fc0.png" /> </td>
|
||||
@@ -711,7 +718,7 @@ The THEORY block is used to define the fit function. There is a set of predefine
|
||||
</tbody></table>
|
||||
<p></p>
|
||||
<p></p>
|
||||
Every theory function has to be written on a single line. It starts with the theory function name or its abbreviation followed by the parameters. Consecutive lines of theory functions will be multiplied. If theory functions need to be added, a line with a <strong>+</strong> has to separate them. The parameters are given as the numbers assigned to them in the <a href="#TheFitparameterBlock" class="foswikiCurrentTopicLink">FITPARAMETER block</a>. The order of the parameters is given in the <a class="foswikiCurrentTopicLink" href="#TheoryTable">table above</a>. As an example
|
||||
Every theory function has to be written on a single line. It starts with the theory function name or its abbreviation followed by the parameters. Consecutive lines of theory functions will be multiplied. If theory functions need to be added, a line with a <strong>+</strong> has to separate them. The parameters are given as the numbers assigned to them in the <a class="foswikiCurrentTopicLink" href="#TheFitparameterBlock">FITPARAMETER block</a>. The order of the parameters is given in the <a class="foswikiCurrentTopicLink" href="#TheoryTable">table above</a>. As an example
|
||||
<pre>
|
||||
simplExpo 4
|
||||
</pre>
|
||||
@@ -731,19 +738,21 @@ which means <i>A</i>(<i>t</i>) = <i>p</i><sub>2</sub> e<sup>-<i>p</i><sub>3</sub
|
||||
<p></p>
|
||||
Notes
|
||||
<p></p>
|
||||
<a name="FootNote3note"></a><span class="FootNoteLabel"><a href="MusrFit.html#FootNote3text" class="foswikiCurrentWebHomeLink"> <strong>4</strong> </a></span>: <span class="FootNote"> R. S. Hayano <em>et al.</em>, <a href="http://link.aps.org/doi/10.1103/PhysRevB.20.850">Phys. Rev. B <strong>20</strong> (1979) 850</a> </span>
|
||||
<a name="FootNote3note"></a><span class="FootNoteLabel"><a href="#FootNote3text"><b>4</b></a></span>: <span class="FootNote"> R. S. Hayano <em>et al.</em>, <a href="http://link.aps.org/doi/10.1103/PhysRevB.20.850">Phys. Rev. B <strong>20</strong> (1979) 850</a> </span>
|
||||
<p></p>
|
||||
<a name="FootNote4note"></a><span class="FootNoteLabel"><a href="MusrFit.html#FootNote4text" class="foswikiCurrentWebHomeLink"> <strong>5</strong> </a></span>: <span class="FootNote"> R. S. Hayano <em>et al.</em>, <a href="http://link.aps.org/doi/10.1103/PhysRevB.20.850">Phys. Rev. B <strong>20</strong> (1979) 850</a>; P. Dalmas de Réotier and A. Yaouanc, <a href="http://dx.doi.org/10.1088/0953-8984/4/18/020">J. Phys.: Condens. Matter <strong>4</strong> (1992) 4533</a>; A. Keren, <a href="http://link.aps.org/doi/10.1103/PhysRevB.50.10039">Phys. Rev. B <strong>50</strong> (1994) 10039</a> </span>
|
||||
<a name="FootNote4note"></a><span class="FootNoteLabel"><a href="#FootNote4text"><b>5</b></a></span>: <span class="FootNote"> R. S. Hayano <em>et al.</em>, <a href="http://link.aps.org/doi/10.1103/PhysRevB.20.850">Phys. Rev. B <strong>20</strong> (1979) 850</a>; P. Dalmas de Réotier and A. Yaouanc, <a href="http://dx.doi.org/10.1088/0953-8984/4/18/020">J. Phys.: Condens. Matter <strong>4</strong> (1992) 4533</a>; A. Keren, <a href="http://link.aps.org/doi/10.1103/PhysRevB.50.10039">Phys. Rev. B <strong>50</strong> (1994) 10039</a> </span>
|
||||
<p></p>
|
||||
<a name="FootNote5note"></a><span class="FootNoteLabel"><a class="foswikiCurrentWebHomeLink" href="MusrFit.html#FootNote5text"> <strong>6</strong> </a></span>,<a name="FootNote6note"></a><span class="FootNoteLabel"><a class="foswikiCurrentWebHomeLink" href="MusrFit.html#FootNote6text"> <strong>7</strong> </a></span>: <span class="FootNote"> Y. J. Uemura <em>et al.</em>, <a href="http://link.aps.org/doi/10.1103/PhysRevB.31.546">Phys. Rev. B <strong>31</strong> (1985) 546</a> </span>
|
||||
<a name="FootNote5note"></a><span class="FootNoteLabel"><a href="#FootNote5text"><b>6</b></a></span>,<a name="FootNote6note"></a><span class="FootNoteLabel"><a href="#FootNote6text"><b>7</b></a></span>: <span class="FootNote"> Y. J. Uemura <em>et al.</em>, <a href="http://link.aps.org/doi/10.1103/PhysRevB.31.546">Phys. Rev. B <strong>31</strong> (1985) 546</a> </span>
|
||||
<p></p>
|
||||
<a name="FootNote7note"></a><span class="FootNoteLabel"><a class="foswikiCurrentWebHomeLink" href="MusrFit.html#FootNote7text"> <strong>8</strong> </a></span>: <span class="FootNote"> R. S. Hayano <em>et al.</em>, <a href="http://link.aps.org/doi/10.1103/PhysRevB.20.850">Phys. Rev. B <strong>20</strong> (1979) 850</a>; P. Dalmas de Réotier and A. Yaouanc, <a href="http://dx.doi.org/10.1088/0953-8984/4/18/020">J. Phys.: Condens. Matter <strong>4</strong> (1992) 4533</a> </span>
|
||||
<a name="FootNote7note"></a><span class="FootNoteLabel"><a href="#FootNote7text"><b>8</b></a></span>: <span class="FootNote"> R. S. Hayano <em>et al.</em>, <a href="http://link.aps.org/doi/10.1103/PhysRevB.20.850">Phys. Rev. B <strong>20</strong> (1979) 850</a>; P. Dalmas de Réotier and A. Yaouanc, <a href="http://dx.doi.org/10.1088/0953-8984/4/18/020">J. Phys.: Condens. Matter <strong>4</strong> (1992) 4533</a> </span>
|
||||
<p></p>
|
||||
<a name="FootNote8note"></a><span class="FootNoteLabel"><a href="MusrFit.html#FootNote8text" class="foswikiCurrentWebHomeLink"> <strong>9</strong> </a></span>: <span class="FootNote"> M.R. Crook and R. Cywinski, <a href="http://dx.doi.org/10.1088/0953-8984/9/5/018">J. Phys.: Condens. Matter <strong>9</strong> (1997) 1149</a> </span>
|
||||
<a name="FootNote8note"></a><span class="FootNoteLabel"><a href="#FootNote8text"><b>9</b></a></span>: <span class="FootNote"> M.R. Crook and R. Cywinski, <a href="http://dx.doi.org/10.1088/0953-8984/9/5/018">J. Phys.: Condens. Matter <strong>9</strong> (1997) 1149</a> </span>
|
||||
<p></p>
|
||||
<a name="FootNote9note"></a><span class="FootNoteLabel"><a href="MusrFit.html#FootNote9text" class="foswikiCurrentWebHomeLink"> <strong>9</strong> </a></span>: <span class="FootNote"> R. E. Turner and D. R. Harshman, <a href="http://link.aps.org/doi/10.1103/PhysRevB.34.4467">Phys. Rev. B <strong>34</strong> (1986) 4467</a> </span>
|
||||
<a name="FootNote9note"></a><span class="FootNoteLabel"><a href="#FootNote9text"><b>9</b></a></span>: <span class="FootNote"> R. E. Turner and D. R. Harshman, <a href="http://link.aps.org/doi/10.1103/PhysRevB.34.4467">Phys. Rev. B <strong>34</strong> (1986) 4467</a> </span>
|
||||
<p></p>
|
||||
<a name="FootNote10note"></a><span class="FootNoteLabel"><a href="MusrFit.html#FootNote10text" class="foswikiCurrentWebHomeLink"> <strong>10</strong> </a></span>: <span class="FootNote"> D.R. Noakes and G.M. Kalvius, <a href="http://link.aps.org/doi/10.1103/PhysRevB.56.2352">Phys. Rev. B <strong>56</strong> (1997) 2352</a>; A. Yaouanc and P. Dalmas de Réotier "Muon Spin Rotation, Relaxation, and Resonance" Oxford Scientific Publication; simplifying the original formulae by eliminating <img alt="\Delta_{\rm eff}" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_663c0beda820045042826686eaeefb6a.png" /> via the identity <img alt="\Delta_{\rm eff}^2 = (1+R_b^2) \Delta_0" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_81abadaf16877e78e8bb9317a16cd704.png" /> </span>
|
||||
<a name="FootNote10note"></a><span class="FootNoteLabel"><a href="#FootNote10text"><b>10</b></a></span>: <span class="FootNote"> D.R. Noakes and G.M. Kalvius, <a href="http://link.aps.org/doi/10.1103/PhysRevB.56.2352">Phys. Rev. B <strong>56</strong> (1997) 2352</a>; A. Yaouanc and P. Dalmas de Réotier "Muon Spin Rotation, Relaxation, and Resonance" Oxford Scientific Publication; simplifying the original formulae by eliminating <img alt="\Delta_{\rm eff}" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_663c0beda820045042826686eaeefb6a.png" /> via the identity <img alt="\Delta_{\rm eff}^2 = (1+R_b^2) \Delta_0" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_81abadaf16877e78e8bb9317a16cd704.png" /> </span>
|
||||
<p></p>
|
||||
<a name="FootNote11note"></a><span class="FootNoteLabel"><a href="#FootNote11text"><b>11</b></a></span>: <span class="FootNote"> This function is explicit for <img alt="\mu^-" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_d65298a2553c29f00e58481f3465086a.png" />! Do not try to use it for <img alt="\mu^+" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_8eb55dc360ede9ff12fa65dc47046bc0.png" />. </span>
|
||||
<p></p>
|
||||
<p></p>
|
||||
<p></p>
|
||||
@@ -751,7 +760,7 @@ Notes
|
||||
<p></p>
|
||||
<span id="MaPs"></span>
|
||||
<h3 id="A_4.3.1_Maps"> 4.3.1 Maps </h3>
|
||||
In case different runs are fitted simultaneously, it is very often necessary that for a given theory function, some parameters are run-dependent. An example could be a temperature scan, where the parameters (asymmetry, depolarization rates, etc.) will depend on the temperature. In order to handle such situations, a mapping of parameters in the THEORY block is possible. That means, instead of a parameter number, the mapping of the parameter is given. The definition of the mapping block is part of the <a href="#TheRunBlock" class="foswikiCurrentTopicLink">RUN block</a> and will be described there. For example
|
||||
In case different runs are fitted simultaneously, it is very often necessary that for a given theory function, some parameters are run-dependent. An example could be a temperature scan, where the parameters (asymmetry, depolarization rates, etc.) will depend on the temperature. In order to handle such situations, a mapping of parameters in the THEORY block is possible. That means, instead of a parameter number, the mapping of the parameter is given. The definition of the mapping block is part of the <a class="foswikiCurrentTopicLink" href="#TheRunBlock">RUN block</a> and will be described there. For example
|
||||
<pre>
|
||||
THEORY
|
||||
asymmetry 2
|
||||
@@ -783,7 +792,7 @@ A THEORY block including a user function may then look like
|
||||
<p></p>
|
||||
<span id="TheFunctionsBlock"></span>
|
||||
<h2 id="A_4.4_The_FUNCTIONS_Block"> 4.4 The FUNCTIONS Block </h2>
|
||||
<code>musrfit</code> utilizes a <a href="http://boost-spirit.com/home/">powerful parser</a>. Therefore, it is possible to define even rather complicated functional relations between the fit parameters and use these in the THEORY block (and <a href="#NormFun" class="foswikiCurrentTopicLink">in one exceptional case</a> also in the RUN-block). Supported is the use of basic arithmetics: <dl>
|
||||
<code>musrfit</code> utilizes a <a href="http://boost-spirit.com/home/">powerful parser</a>. Therefore, it is possible to define even rather complicated functional relations between the fit parameters and use these in the THEORY block (and <a class="foswikiCurrentTopicLink" href="#NormFun">in one exceptional case</a> also in the RUN-block). Supported is the use of basic arithmetics: <dl>
|
||||
<dt> + </dt><dd> Addition
|
||||
</dd> <dt> - </dt><dd> Subtraction
|
||||
</dd> <dt> * </dt><dd> Multiplication
|
||||
@@ -798,9 +807,9 @@ Furthermore, some constants are predefined and might also be used: <ul>
|
||||
</li> <li> <strong>pi</strong> = π = 3.14159265358979323846
|
||||
</li></ul>
|
||||
<p></p>
|
||||
The fit parameters are accessed either directly through <code><b>parα</b></code>, where α is the number of the parameter in the FITPARAMETER block, e.g. <code><b>par5</b></code> or through a mapping with <code><b>mapδ</b></code>, where δ specifies the mapping number in the RUN block as explained <a href="#TheRunBlock" class="foswikiCurrentTopicLink">below</a>.
|
||||
The fit parameters are accessed either directly through <code><b>parα</b></code>, where α is the number of the parameter in the FITPARAMETER block, e.g. <code><b>par5</b></code> or through a mapping with <code><b>mapδ</b></code>, where δ specifies the mapping number in the RUN block as explained <a class="foswikiCurrentTopicLink" href="#TheRunBlock">below</a>.
|
||||
<p></p>
|
||||
The defined functions are denoted as <code><b>funα</b></code>, where α is the function number, i.e. <code><b>fun1</b></code>, <code><b>fun2</b></code>, etc. and have to be placed separately on one line each. Afterwards they might be used in the <a href="#TheTheoryBlock" class="foswikiCurrentTopicLink">THEORY block</a>.
|
||||
The defined functions are denoted as <code><b>funα</b></code>, where α is the function number, i.e. <code><b>fun1</b></code>, <code><b>fun2</b></code>, etc. and have to be placed separately on one line each. Afterwards they might be used in the <a class="foswikiCurrentTopicLink" href="#TheTheoryBlock">THEORY block</a>.
|
||||
<p></p>
|
||||
It follows an example to illustrate the usage of functions in the THEORY block. The total asymmetry of a signal consisting of two parts should be a fit parameter. The fraction of each of the parts will then be expressed as a function of the total asymmetry.
|
||||
<p></p>
|
||||
@@ -829,7 +838,7 @@ It follows an example to illustrate the usage of functions in the THEORY block.
|
||||
|
||||
</pre>
|
||||
<p></p>
|
||||
In the case that functions have to be fitted which cannot be defined in the FUNCTIONS block, the functions can be implemented externally and made usable through the <a href="#UserFunctions" class="foswikiCurrentTopicLink">userFunc mechanism</a>.
|
||||
In the case that functions have to be fitted which cannot be defined in the FUNCTIONS block, the functions can be implemented externally and made usable through the <a class="foswikiCurrentTopicLink" href="#UserFunctions">userFunc mechanism</a>.
|
||||
<p></p>
|
||||
<span id="TheGlobalBlock"></span>
|
||||
<h2 id="A_4.5_The_GLOBAL_Block"> 4.5 The GLOBAL Block </h2>
|
||||
@@ -940,8 +949,8 @@ The RUN block is used to collect the data needed for a particular run to be fitt
|
||||
<table border="1" class="foswikiTable" rules="none">
|
||||
<thead>
|
||||
<tr class="foswikiTableOdd foswikiTableRowdataBgSorted0 foswikiTableRowdataBg0">
|
||||
<th class="foswikiTableCol0 foswikiFirstCol"> <a rel="nofollow" title="Sort by this column" href="https://intranet.psi.ch/MUSR/MusrFit?cover=print;sortcol=0;table=2;up=0#sorted_table">RUN-block tag</a> </th>
|
||||
<th class="foswikiTableCol1 foswikiLastCol"> <a href="https://intranet.psi.ch/MUSR/MusrFit?cover=print;sortcol=1;table=2;up=0#sorted_table" title="Sort by this column" rel="nofollow">comment</a> </th>
|
||||
<th class="foswikiTableCol0 foswikiFirstCol"> <a href="https://intranet.psi.ch/MUSR/MusrFit?cover=print;sortcol=0;table=2;up=0#sorted_table" rel="nofollow" title="Sort by this column">RUN-block tag</a> </th>
|
||||
<th class="foswikiTableCol1 foswikiLastCol"> <a href="https://intranet.psi.ch/MUSR/MusrFit?cover=print;sortcol=1;table=2;up=0#sorted_table" rel="nofollow" title="Sort by this column">comment</a> </th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
@@ -1008,7 +1017,7 @@ etc.
|
||||
<span id="FitTypes"></span> <dl>
|
||||
<dt> fittype (required if not already defined in the GLOBAL block) </dt><dd> This tag is used to indicate which type of fit is wished. The supported fit types are: <dl>
|
||||
<dt> 0 </dt><dd> Single Histogram Fit
|
||||
</dd> <dt> 1 </dt><dd> Single Histogram RRF Fit (only for online analysis<a name="FootNote11text"></a><span class="FootNoteTextLink" title="for a more detailed discussion about the shortcomings of RRF fits see the RRF memo found under &lt;musrfit&gt;/doc/memo/rrf"><a class="foswikiCurrentTopicLink" href="#FootNote11note">(l)</a></span> )
|
||||
</dd> <dt> 1 </dt><dd> Single Histogram RRF Fit (only for online analysis<a name="FootNote12text"></a><span class="FootNoteTextLink" title="for a more detailed discussion about the shortcomings of RRF fits see the RRF memo found under &lt;musrfit&gt;/doc/memo/rrf"><a class="foswikiCurrentTopicLink" href="#FootNote12note">(l)</a></span> )
|
||||
</dd> <dt> 2 </dt><dd> Asymmetry Fit
|
||||
</dd> <dt> 3 </dt><dd> Asymmetry RRF Fit (only for online analysis. See comment added for Single Histogram RRF Fit)
|
||||
</dd> <dt> 4 </dt><dd> MuMinus Fit. This is a single histogram fit especially for negative muon μSR
|
||||
@@ -1027,7 +1036,7 @@ alpha 1
|
||||
</dd></dl>
|
||||
<p></p>
|
||||
<span id="NormFun"></span> <dl>
|
||||
<dt> norm (fit type 0) </dt><dd> Number of the fit parameter that represents the normalization constant <i>N</i><sub>0</sub> of the histogram; the value of this parameter is given either per nanosecond or per bin (see <a href="#ScaleNzero" class="foswikiCurrentTopicLink">below</a>). It is possible to substitute the parameter number by a function here (<u>and only here in a RUN block</u>), for instance to relate <i>N</i><sub>0</sub>s of different histograms through an α parameter. Example for a norm defined by fit parameter number 12:<pre>
|
||||
<dt> norm (fit type 0) </dt><dd> Number of the fit parameter that represents the normalization constant <i>N</i><sub>0</sub> of the histogram; the value of this parameter is given either per nanosecond or per bin (see <a class="foswikiCurrentTopicLink" href="#ScaleNzero">below</a>). It is possible to substitute the parameter number by a function here (<u>and only here in a RUN block</u>), for instance to relate <i>N</i><sub>0</sub>s of different histograms through an α parameter. Example for a norm defined by fit parameter number 12:<pre>
|
||||
norm 12
|
||||
</pre> Example for a norm defined in function number 3:<pre>
|
||||
norm fun3
|
||||
@@ -1040,7 +1049,7 @@ norm fun3
|
||||
<dt> lifetime (fit type 0) </dt><dd> Fit parameter representing the lifetime of the muon. If it is not specified the value τ<sub>μ</sub>=2.197019 μs is used in the calculations.
|
||||
</dd></dl>
|
||||
<p></p> <dl>
|
||||
<dt> lifetimecorrection (fit type 0) <img class='smily' src='../pub/Main/SmiliesPluginPSI_/eek.gif' alt='eek!' title='eek!' /> <strong>obsolete</strong> <img class='smily' src='../pub/Main/SmiliesPluginPSI_/eek.gif' alt='eek!' title='eek!' /> </dt><dd> Does not accept any arguments. If present, the output in <code>musrview</code> is corrected for the exponential decay of the muon. This item is <strong>obsolete</strong> in the RUN block and will be transferred to the <a href="#ThePlotBlock" class="foswikiCurrentTopicLink">PLOT block</a>, which allows switching between histogram view and asymmetry view much quicker.
|
||||
<dt> lifetimecorrection (fit type 0) <img class='smily' src='../pub/Main/SmiliesPluginPSI_/eek.gif' alt='eek!' title='eek!' /> <strong>obsolete</strong> <img class='smily' src='../pub/Main/SmiliesPluginPSI_/eek.gif' alt='eek!' title='eek!' /> </dt><dd> Does not accept any arguments. If present, the output in <code>musrview</code> is corrected for the exponential decay of the muon. This item is <strong>obsolete</strong> in the RUN block and will be transferred to the <a class="foswikiCurrentTopicLink" href="#ThePlotBlock">PLOT block</a>, which allows switching between histogram view and asymmetry view much quicker.
|
||||
</dd></dl>
|
||||
<p></p> <dl>
|
||||
<dt> map </dt><dd> On this line the mapping of run-dependent parameters is done. Parameter numbers given here may be accessed through <code><b>map1</b></code>, <code><b>map2</b></code>, etc. in the THEORY and FUNCTIONS blocks (see also <a class="foswikiCurrentTopicLink" href="#MaPs">here</a>). The first ten maps are always present and have the value 0 if not used; however, the total number of maps is not restricted!
|
||||
@@ -1067,7 +1076,7 @@ norm fun3
|
||||
</pre>
|
||||
</dd></dl>
|
||||
<p></p> <dl>
|
||||
<dt> backgr.fix (fit types 0, 1, 2) </dt><dd> A fixed constant background in counts per nanosecond or per bin (see <a href="#ScaleNzero" class="foswikiCurrentTopicLink">below</a>) may be given at this point. The background is specified for all histograms in the order <i>B</i><sub>f</sub> <i>B</i><sub>b</sub> [<i>B</i><sub>r</sub> <i>B</i><sub>l</sub>]. If this keyword is present, any information on a <strong>background</strong> line is ignored.
|
||||
<dt> backgr.fix (fit types 0, 1, 2) </dt><dd> A fixed constant background in counts per nanosecond or per bin (see <a class="foswikiCurrentTopicLink" href="#ScaleNzero">below</a>) may be given at this point. The background is specified for all histograms in the order <i>B</i><sub>f</sub> <i>B</i><sub>b</sub> [<i>B</i><sub>r</sub> <i>B</i><sub>l</sub>]. If this keyword is present, any information on a <strong>background</strong> line is ignored.
|
||||
</dd></dl>
|
||||
<p></p> <dl>
|
||||
<dt> background (fit type 0, 1) </dt><dd> The numbers of the first and the last channel of an interval from which the constant background should be calculated are specified here. In case histograms are being grouped, the specified channels are interpreted with respect to the first histogram. Example:<pre>
|
||||
@@ -1105,7 +1114,7 @@ data 207 7994 167 8009
|
||||
</dd></dl>
|
||||
<p></p>
|
||||
<span id="AddTimeZero"></span> <dl>
|
||||
<dt> addt0 (fit type 0, 1, 4) </dt><dd> The number of the time-zero channel of the histogram. If grouping of histograms is present (see <a href="#ForwardHisto" class="foswikiCurrentTopicLink">forward</a>) the same syntax as for <a href="#TimeZero" class="foswikiCurrentTopicLink">t0</a> applies. If one addt0 is given, the total number of addt0's needs to be equal to the total number of ADDRUN's!
|
||||
<dt> addt0 (fit type 0, 1, 4) </dt><dd> The number of the time-zero channel of the histogram. If grouping of histograms is present (see <a class="foswikiCurrentTopicLink" href="#ForwardHisto">forward</a>) the same syntax as for <a class="foswikiCurrentTopicLink" href="#TimeZero">t0</a> applies. If one addt0 is given, the total number of addt0's needs to be equal to the total number of ADDRUN's!
|
||||
</dd></dl>
|
||||
<p></p> <dl>
|
||||
<dt> addt0 (fit types 2) </dt><dd> The numbers of time-zero channels of the histograms in the order <i>t</i><sub>0,f</sub> <i>t</i><sub>0,b</sub> [<i>t</i><sub>0,r</sub> <i>t</i><sub>0,l</sub>]. If grouping of histograms is present (see <a class="foswikiCurrentTopicLink" href="#ForwardHisto">forward</a>) the same syntax as for <a class="foswikiCurrentTopicLink" href="#TimeZero">t0</a> applies. If one addt0 is given, the total number of addt0's needs to be equal to the total number of ADDRUN's!
|
||||
@@ -1114,7 +1123,7 @@ data 207 7994 167 8009
|
||||
<dt> xy-data (fit type 8) </dt><dd> Specification of the data from an ASCII or DB file which should be used as <i>x</i> and <i>y</i> data (in this order). For a simple ASCII file the column numbers are used, in the case of a DB file one can either specify the variable numbers or the name of the variables as given in the DB header.
|
||||
</dd></dl>
|
||||
<p></p> <dl>
|
||||
<dt> fit </dt><dd> The range of data that should be considered when the fitting is done. For the μSR fit types <strong>0</strong>, <strong>2</strong>, and <strong>4</strong> here the starting and end times are given in microseconds. For the non-μSR fit type <strong>8</strong> the starting and end points of the fitting range are given in the units of the <i>x</i> data.<br><span class='foswikiRedFG'>In case the fit range specified here is larger than the <a href="#DataRange" class="foswikiCurrentTopicLink">data range</a> (in any direction), eventually the <a class="foswikiCurrentTopicLink" href="#DataRange">data range</a> will be used as fit range.</span> An example for a μSR fit:<pre>
|
||||
<dt> fit </dt><dd> The range of data that should be considered when the fitting is done. For the μSR fit types <strong>0</strong>, <strong>2</strong>, and <strong>4</strong> here the starting and end times are given in microseconds. For the non-μSR fit type <strong>8</strong> the starting and end points of the fitting range are given in the units of the <i>x</i> data.<br><span class='foswikiRedFG'>In case the fit range specified here is larger than the <a class="foswikiCurrentTopicLink" href="#DataRange">data range</a> (in any direction), eventually the <a class="foswikiCurrentTopicLink" href="#DataRange">data range</a> will be used as fit range.</span> An example for a μSR fit:<pre>
|
||||
fit 0.2 8.5
|
||||
</pre>Which means that the fitting window will span from 0.2 to 8.5 microseconds.<br> Another possibility for the μSR fits is to give the fit range in bins, rather than time. The syntax is then: <pre>fit fgb+<n0> lgb-<n1>,</pre> where <strong>fgb</strong> and <strong>lgb</strong> are label tags which refer to the 'first good bin' and the 'last good bin' defined either in the <code><b>data</b></code> tag of the run block, data file, are estimated based on T0. <n0> and <n1> are offsets (given in bins) allowing to change the fit window compared to the data window. An example: <pre>fit fgb+150 lgb-1332</pre>
|
||||
</dd></dl>
|
||||
@@ -1162,7 +1171,7 @@ Sometimes it is necessary to guide <code>MINUIT2</code> to the global optimum. F
|
||||
<p></p>
|
||||
It is important to understand that before <strong>MINOS</strong> is called, all the fixed parameters need to be released and another minimizer command (<strong>MINIMIZE</strong>, <strong>MIGRAD</strong>, or <strong>SIMPLEX</strong>) needs to be in place, otherwise <code>musrfit</code> will assume that the still fixed parameters have to be handled as constant parameters, i.e. setting the <step> value of the parameter to zero.
|
||||
<p></p>
|
||||
For even more complex fitting the additional command <strong>FIT_RANGE RESET | <i>t</i><sub>start</sub> <i>t</i><sub>end</sub> | <i>t</i><sub>s1</sub> <i>t</i><sub>e1</sub> <i>t</i><sub>s2</sub> <i>t</i><sub>e2</sub> ... <i>t</i><sub>s<i>n</i></sub> <i>t</i><sub>e<i>n</i></sub></strong> is provided. It allows to change the fit range during different iterations. The command <strong>FIT_RANGE <i>t</i><sub>start</sub> <i>t</i><sub>end</sub></strong> changes the current fit range for <code>all</code> the runs present in the msr file. <strong>FIT_RANGE RESET</strong> will restore to the original fit ranges as provided in the <a href="#TheRunBlock" class="foswikiCurrentTopicLink">RUN block</a>. If for each run of the msr file an individual fit range should be used, the third option applies. Here <strong><i>n</i></strong> has to correspond to the number of runs in the RUN block.
|
||||
For even more complex fitting the additional command <strong>FIT_RANGE RESET | <i>t</i><sub>start</sub> <i>t</i><sub>end</sub> | <i>t</i><sub>s1</sub> <i>t</i><sub>e1</sub> <i>t</i><sub>s2</sub> <i>t</i><sub>e2</sub> ... <i>t</i><sub>s<i>n</i></sub> <i>t</i><sub>e<i>n</i></sub></strong> is provided. It allows to change the fit range during different iterations. The command <strong>FIT_RANGE <i>t</i><sub>start</sub> <i>t</i><sub>end</sub></strong> changes the current fit range for <code>all</code> the runs present in the msr file. <strong>FIT_RANGE RESET</strong> will restore to the original fit ranges as provided in the <a class="foswikiCurrentTopicLink" href="#TheRunBlock">RUN block</a>. If for each run of the msr file an individual fit range should be used, the third option applies. Here <strong><i>n</i></strong> has to correspond to the number of runs in the RUN block.
|
||||
<p></p>
|
||||
As for the run block, there is a 2nd flavor how the <strong>FIT_RANGE</strong> can be changed, namely giving the fit range in bins, i.e. <strong>FIT_RANGE RESET | fgb+<n0> lgb-<n1> | fgb+<n00> lgb-<n01> fgb+<n10> lgb-<n11> ... fgb+<nN0> lgb-<nN1></strong> where <strong>N</strong> is the number of available run blocks. The idea is inline with the above syntax and the syntax describe for the fit range (<strong>fit</strong>) of the <a class="foswikiCurrentTopicLink" href="#TheRunBlock">RUN block</a>.
|
||||
<p></p>
|
||||
@@ -1201,7 +1210,7 @@ Here the <code>MINOS</code> command will print out lot of additional information
|
||||
<p></p>
|
||||
<span id="TheFourierBlock"></span>
|
||||
<h2 id="A_4.8_The_FOURIER_Block"> 4.8 The FOURIER Block </h2>
|
||||
The Fourier transform is done and the results are plotted within <code>musrview</code> —as input data the actual data shown in <code>musrview</code> is used. In the FOURIER block of the msr file all necessary parameters for calculating and presenting the Fourier transform of the data specified in the <a href="#ThePlotBlock" class="foswikiCurrentTopicLink">PLOT block</a> is given. If the FOURIER block is not present in the msr file, either the parameters set in the <a class="foswikiCurrentTopicLink" href="#MusrfitStartupXml">XML startup file</a> or the system defaults are taken when the Fourier transform is performed. The block starts with the FOURIER keyword and may contain the following entries on the successive lines: <dl>
|
||||
The Fourier transform is done and the results are plotted within <code>musrview</code> —as input data the actual data shown in <code>musrview</code> is used. In the FOURIER block of the msr file all necessary parameters for calculating and presenting the Fourier transform of the data specified in the <a class="foswikiCurrentTopicLink" href="#ThePlotBlock">PLOT block</a> is given. If the FOURIER block is not present in the msr file, either the parameters set in the <a class="foswikiCurrentTopicLink" href="#MusrfitStartupXml">XML startup file</a> or the system defaults are taken when the Fourier transform is performed. The block starts with the FOURIER keyword and may contain the following entries on the successive lines: <dl>
|
||||
<dt> units </dt><dd> Here is specified in which domain the Fourier-transformed data is presented. One may choose between the fields (<strong>Gauss</strong>) or (<strong>Tesla</strong>), the frequency (<strong>MHz</strong>), and the angular-frequency domain (<strong>Mc/s</strong>).
|
||||
</dd> <dt> fourier_power </dt><dd> It is possible (but not necessary) to set the number of data points used for the Fourier transform here. As argument the exponent <i>n</i><21 of a power of 2 is accepted. The number of data points is then 2<sup><i>n</i></sup>. <strong>Attention:</strong> If the number of points given here is bigger than the actual number of available data points, the input data vector is filled with zeros until the number of requested points is reached (zero padding)!
|
||||
</dd> <dt> dc-corrected </dt><dd> a flag to remove a potential DC-offset of the signal. Allowed entries are <code>dc-corrected true | 1 | false | 0</code>.
|
||||
@@ -1238,7 +1247,7 @@ Altogether, a possible FOURIER block might look like that:
|
||||
<p></p>
|
||||
Notes
|
||||
<p></p>
|
||||
<a name="FootNote11note"></a><span class="FootNoteLabel"><a href="MusrFit.html#FootNote11text" class="foswikiCurrentWebHomeLink"> <strong>l</strong> </a></span>: <span class="FootNote">for a more detailed discussion about the shortcomings of RRF fits see the RRF memo found under <musrfit>/doc/memo/rrf</span>
|
||||
<a name="FootNote12note"></a><span class="FootNoteLabel"><a href="#FootNote12text"><b>l</b></a></span>: <span class="FootNote">for a more detailed discussion about the shortcomings of RRF fits see the RRF memo found under <musrfit>/doc/memo/rrf</span>
|
||||
<p></p>
|
||||
<p></p>
|
||||
<p></p>
|
||||
@@ -1246,7 +1255,7 @@ Notes
|
||||
<p></p>
|
||||
<span id="ThePlotBlock"></span>
|
||||
<h2 id="A_4.9_The_PLOT_Block"> 4.9 The PLOT Block </h2>
|
||||
The PLOT block is intended to collect all the information needed for the graphical presentation of the data and fits using <code>musrview</code>. The PLOT keyword at the beginning of the block is followed by a number which indicates the plot type. The plot types match the <a href="#FitTypes" class="foswikiCurrentTopicLink">fit types</a>. Additionally, it is possible to provide information using the following keywords: <dl>
|
||||
The PLOT block is intended to collect all the information needed for the graphical presentation of the data and fits using <code>musrview</code>. The PLOT keyword at the beginning of the block is followed by a number which indicates the plot type. The plot types match the <a class="foswikiCurrentTopicLink" href="#FitTypes">fit types</a>. Additionally, it is possible to provide information using the following keywords: <dl>
|
||||
<dt> lifetimecorrection </dt><dd> Does not accept any arguments. If present, the output in <code>musrview</code> is corrected for the exponential decay of the muon. Only relevant for (type 0).
|
||||
</dd> <dt> runs </dt><dd> The numbers of the runs to be plotted have to be put here. The runs are numbered according to their appearance in the RUN block.
|
||||
</dd> <dt> range </dt><dd> Here it is possible to define the plotting range explicitly. Depending on the plot type the following settings are allowed where the times are given in microseconds and the <i>N</i> in counts (type 0, 4) or in counts/nsec (type 0): <dl>
|
||||
@@ -1286,7 +1295,7 @@ The PLOT block is intended to collect all the information needed for the graphic
|
||||
<span id="TheStatisticBlock"></span>
|
||||
<h2 id="A_4.10_The_STATISTIC_Block"> 4.10 The STATISTIC Block </h2>
|
||||
The STATISTIC block is the last block of a msr file. It contains some information on the fit: the date and time as well as the absolute and normalized values of χ<sup>2</sup> and the number of degrees of freedom in the fit.<br>
|
||||
If enabled in the <a class="foswikiCurrentTopicLink" href="#MusrfitStartupXml">XML file</a> for χ<sup>2</sup>-<a href="#SingleHistogramFit" class="foswikiCurrentTopicLink">single-histogram fits</a> also <a href="http://en.wikipedia.org/wiki/Pearson's_chi-square_test">Pearson's χ<sup>2</sup></a> will be written to the STATISTIC block.<br>
|
||||
If enabled in the <a class="foswikiCurrentTopicLink" href="#MusrfitStartupXml">XML file</a> for χ<sup>2</sup>-<a class="foswikiCurrentTopicLink" href="#SingleHistogramFit">single-histogram fits</a> also <a href="http://en.wikipedia.org/wiki/Pearson's_chi-square_test">Pearson's χ<sup>2</sup></a> will be written to the STATISTIC block.<br>
|
||||
These information only have a meaning if the fitting procedure has been executed at least once and the fit has converged!
|
||||
<p></p>
|
||||
<span id="TheFitTypes"></span>
|
||||
@@ -1359,7 +1368,7 @@ and plotted together with the function given in the THEORY block.
|
||||
<p></p>
|
||||
<span id="AsymmetryRrfFit"></span>
|
||||
<h2 id="A_5.4_Asymmetry_RRF_Fit"> 5.4 Asymmetry RRF Fit </h2>
|
||||
In a first step, the unbinned asymmetry is formed as described for the asymmetry fit. Afterwards the RRF transformation is carried out, i.e. point 4. and 5. as sketched in the single histogramm RRF fit. The same reservations as for the single histogram RRF fit apply: <strong>if you not urgently need it: do not use it! There are better ways to deal with the analysis of high frequency data!</strong>
|
||||
For asymmetry RRF Fit (fit type <strong>3</strong>) two histograms are needed. In a first step, the unbinned asymmetry is formed as described for the asymmetry fit. Afterwards the RRF transformation is carried out, i.e. point 4. and 5. as sketched in the single histogramm RRF fit. The same reservations as for the single histogram RRF fit apply: <strong>if you not urgently need it: do not use it! There are better ways to deal with the analysis of high frequency data!</strong>
|
||||
<p></p>
|
||||
<span id="MuMinusFit"></span>
|
||||
<h2 id="A_5.5_Negative_Muon_SR_Fit"> 5.5 Negative Muon μSR Fit </h2>
|
||||
@@ -1374,7 +1383,7 @@ where <img alt="i" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_c46
|
||||
</dd> <dt> <img alt="N_{\rm bkg}(t)" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_5e07a020de661906573e8fed8eff32bf.png" /> </dt><dd> <img alt="N_{\rm bkg}(t)= N_{\rm bkg,0} + \sum_k N_{\rm bkg,k} \cos(k \omega_{\rm cyclotron} t)" class="mmpImage" src="../pub/MUSR/MusrFit/_MathModePlugin_53e41adf70ef506cc7668f8593a1b501.png" /> the background
|
||||
</dd></dl>
|
||||
<p></p>
|
||||
Since MuMinus is quite generic, the full functional depends has to be written in the <a href="#TheTheoryBlock" class="foswikiCurrentTopicLink">THEORY Block</a>.
|
||||
Since MuMinus is quite generic, the full functional depends has to be written in the <a class="foswikiCurrentTopicLink" href="#TheTheoryBlock">THEORY Block</a>.
|
||||
<p></p>
|
||||
<span id="NonMusrFit"></span>
|
||||
<h2 id="A_5.6_Non_45SR_Fit"> 5.6 Non-μSR Fit </h2>
|
||||
@@ -1501,11 +1510,11 @@ make -f Makefile.TMyLibrary install
|
||||
</pre>
|
||||
In case of a custom installation some paths in the Makefile might have to be changed. For further information about the <code>ROOT</code> dictionary mechanism please refer to the <a href="http://root.cern.ch/drupal/content/interacting-shared-libraries-rootcint">documentation</a>.
|
||||
<p></p>
|
||||
After installing the shared library the defined user function might be used in <code>musrfit</code> as described <a href="#UserFunctions" class="foswikiCurrentTopicLink">above</a>.
|
||||
After installing the shared library the defined user function might be used in <code>musrfit</code> as described <a class="foswikiCurrentTopicLink" href="#UserFunctions">above</a>.
|
||||
<p></p>
|
||||
Good luck! <img class='smily' src='../pub/Main/SmiliesPluginPSI_/wink.gif' alt='wink' title='wink' />
|
||||
<p></p>
|
||||
Finally, please be aware of the <a href="#UserFunctionRemark" class="foswikiCurrentTopicLink">remark</a> at the end of this section.
|
||||
Finally, please be aware of the <a class="foswikiCurrentTopicLink" href="#UserFunctionRemark">remark</a> at the end of this section.
|
||||
<p></p>
|
||||
<span id="UserFcnWithGlobal"></span>
|
||||
<h2 id="A_6.2_User_Function_with_global_user_45function_45object_access"> 6.2 User Function with global user-function-object access </h2>
|
||||
@@ -1517,7 +1526,7 @@ are independent entities. This means if the msr file contains <em>n</em> run blo
|
||||
If the user function is performing CPU-demanding calculations this is rather inefficient.
|
||||
<p></p>
|
||||
<span id="GlobalUserFunctionFigure"></span>
|
||||
<img class='imagePlain imagePlain_none ' src='../pub/MUSR/MusrFit/igp_9eac78831993c6c274146a8f75bc15fe_Theory-Tree-with-UserFcn.png' alt='theory tree with user function and global user function objects' title='Theory-Tree-with-UserFcn.png' width='800' height='566' style='' />
|
||||
<img class='imagePlain imagePlain_none ' src='../pub/MUSR/MusrFit/igp_96bafe0a153bdf59fbc40ada0300f686_Theory-Tree-with-UserFcn.png' alt='theory tree with user function and global user function objects' title='Theory-Tree-with-UserFcn.png' width='800' height='566' style='' />
|
||||
<p></p>
|
||||
Therefore, it is possible to associate to each user function (<code>uFx</code>) a global user-function object (<code>g_uFx</code>). The idea is the following: If <code>uFx</code> needs to
|
||||
perform very time-consuming calculations (e.g. calculate an Abrikosov vortex lattice or the nonlocal response of a superconductor in the Meissner state) this can be
|
||||
@@ -1593,7 +1602,7 @@ private:
|
||||
};
|
||||
</pre>
|
||||
<p></p>
|
||||
Compared to the <a href="#UserFcnWithoutGlobal" class="foswikiCurrentTopicLink">user function <strong>without</strong> global objects</a>, here the <code>NeedGlobalPart()</code> method returns <code>true</code> meaning that a global user-function object will be needed. Furthermore, the methods <code>SetGlobalPart(vector<void*> &globalPart, UInt_t idx)</code> and <code>GlobalPartIsValid()</code> now need to be implemented.
|
||||
Compared to the <a class="foswikiCurrentTopicLink" href="#UserFcnWithoutGlobal">user function <strong>without</strong> global objects</a>, here the <code>NeedGlobalPart()</code> method returns <code>true</code> meaning that a global user-function object will be needed. Furthermore, the methods <code>SetGlobalPart(vector<void*> &globalPart, UInt_t idx)</code> and <code>GlobalPartIsValid()</code> now need to be implemented.
|
||||
The method <code>SetGlobalPart(vector<void*> &globalPart, UInt_t idx)</code> is used to link the <code>fGlobalUserFcn</code> to the global user object. This routine will look like:
|
||||
<p></p>
|
||||
<pre class="cplusplus">
|
||||
@@ -1650,7 +1659,7 @@ This way the efficiency of the user function can be increased by almost a factor
|
||||
<p></p>
|
||||
<hr />
|
||||
<span id="UserFunctionRemark"></span>
|
||||
<span class='foswikiRedFG'><b>Important remark:</b></span> If <code>musrfit</code> <a href="MusrFitSetup.html#MusrFitInstallation">has been built</a> with parallelization support (default for <code>GCC</code> ≥ 4.2) it should be taken care of the thread safety of the user-function <strong>operator()</strong>. During the function optimization of <code>musrfit</code> the <strong>operator()</strong> is called once for any given set of parameters in order to allow the safe execution of any calculation. Within the <a href="#SingleHistogramFit" class="foswikiCurrentTopicLink">single-histogram</a> and <a class="foswikiCurrentTopicLink" href="#AsymmetryFit">asymmetry</a> fits the calculation of χ<sup>2</sup> or the log-likelihood is parallelized and the <strong>operator()</strong> is expected to evaluate to reasonable values for a fixed set of parameters (but changing <i>t</i>) beginning with the second function call.
|
||||
<span class='foswikiRedFG'><b>Important remark:</b></span> If <code>musrfit</code> <a href="MusrFitSetup.html#MusrFitInstallation">has been built</a> with parallelization support (default for <code>GCC</code> ≥ 4.2) it should be taken care of the thread safety of the user-function <strong>operator()</strong>. During the function optimization of <code>musrfit</code> the <strong>operator()</strong> is called once for any given set of parameters in order to allow the safe execution of any calculation. Within the <a class="foswikiCurrentTopicLink" href="#SingleHistogramFit">single-histogram</a> and <a class="foswikiCurrentTopicLink" href="#AsymmetryFit">asymmetry</a> fits the calculation of χ<sup>2</sup> or the log-likelihood is parallelized and the <strong>operator()</strong> is expected to evaluate to reasonable values for a fixed set of parameters (but changing <i>t</i>) beginning with the second function call.
|
||||
In case this cannot be ensured, the parallelization can be disabled by <strong>--disable-omp</strong> on the <a href="MusrFitSetup.html#MusrFitInstallation">configure level</a> of the program installation.
|
||||
<hr />
|
||||
<p></p>
|
||||
@@ -1669,11 +1678,11 @@ For reporting bugs or requesting new features and improvements please use the <a
|
||||
<p></p>
|
||||
</div>
|
||||
<div class="patternInfo">This topic: MUSR<span class='foswikiSeparator'> > </span><a class="foswikiCurrentWebHomeLink" href="WebHome.html">WebHome</a><span class='foswikiSeparator'> > </span>MusrFit <br />
|
||||
Topic revision: <span class='patternRevInfo'>22 Jan 2016, <a href="https://intranet.psi.ch/Main/AndreasSuter">AndreasSuter</a></span></div>
|
||||
Topic revision: <span class='patternRevInfo'>26 Apr 2016, <a href="https://intranet.psi.ch/Main/AndreasSuter">AndreasSuter</a></span></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div><div id="patternBottomBar"><div id="patternBottomBarContents"><div id="patternWebBottomBar"><span class="foswikiRight"> <a href="http://foswiki.org/"><img src="../pub/System/ProjectLogos/foswiki-badge.png" alt="This site is powered by Foswiki" title="This site is powered by Foswiki" /></a></span>Copyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors. <br /> Ideas, requests, problems regarding PSI Wiki? <a href='mailto:andre.lichtsteiner@psi.ch?subject=PSI Wiki %20Feedback%20on%20MUSR.MusrFit'>Send feedback</a></div></div></div>
|
||||
</div><div id="patternBottomBar"><div id="patternBottomBarContents"><div id="patternWebBottomBar"><span class="foswikiRight"> <a href="http://foswiki.org/"><img src="../pub/System/ProjectLogos/foswiki-badge.png" alt="This site is powered by Foswiki" title="This site is powered by Foswiki" /></a></span>Copyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors. <br /> Ideas, requests, problems regarding PSI Wiki? <a href='mailto:thomas.buecklers@psi.ch?subject=PSI Wiki %20Feedback%20on%20MUSR.MusrFit'>Send feedback</a></div></div></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
@@ -1687,6 +1696,6 @@ Topic revision: <span class='patternRevInfo'>22 Jan 2016, <a href="https://intr
|
||||
|
||||
</body>
|
||||
|
||||
<!-- Mirrored from intranet.psi.ch/MUSR/MusrFit?cover=print by HTTrack Website Copier/3.x [XR&CO'2010], Fri, 22 Jan 2016 15:12:46 GMT -->
|
||||
<!-- Mirrored from intranet.psi.ch/MUSR/MusrFit?cover=print by HTTrack Website Copier/3.x [XR&CO'2010], Tue, 26 Apr 2016 06:39:30 GMT -->
|
||||
<!-- Added by HTTrack --><meta http-equiv="content-type" content="text/html;charset=utf-8"><!-- /Added by HTTrack -->
|
||||
</html>
|
||||
Reference in New Issue
Block a user