musrfit/doc/html/user/MUSR/MusrGui.html

345 lines
27 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en_US">
<!-- Mirrored from intranet.psi.ch/MUSR/MusrGui?cover=print by HTTrack Website Copier/3.x [XR&CO'2010], Mon, 01 Aug 2011 13:15:37 GMT -->
<!-- Added by HTTrack --><meta http-equiv="content-type" content="text/html;charset=iso-8859-1"><!-- /Added by HTTrack -->
<head>
<link rel="stylesheet" href="../pub/System/HeadlinesPlugin/style.css" type="text/css" media="all" />
<title> MUSR :: MusrGui</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> <meta name="robots" content="noindex" /> <link rel="alternate" type="application/rss+xml" title="RSS Feed" href="WebRsshtml.html" />
<meta name="scripturl" content="https://intranet.psi.ch/wiki/bin" />
<meta name="scriptsuffix" content="" />
<meta name="WEBTOPIC" content="MusrGui" />
<meta name="WEB" content="MUSR" />
<meta name="SCRIPTURLPATH" content="/wiki/bin" />
<meta name="SCRIPTSUFFIX" content="" />
<meta name="TEXT_JUMP" content="Jump" />
<meta name="TEXT_SEARCH" content="Search" />
<meta name="TEXT_NUM_TOPICS" content="Number of topics:" />
<meta name="TEXT_MODIFY_SEARCH" content="Modify search" />
<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/MusrGui?t=1312204524" type="application/x-wiki" title="edit MusrGui" />
<meta name="description" content="MusrGui" />
<base /><!--[if IE]></base><![endif]-->
<style type="text/css" media="all">
@import url('../pub/System/SkinTemplates/base.css');
</style>
<style type="text/css" media="all">
@import url('../pub/System/PatternSkinTheme2009/layout.css');
@import url('../pub/System/PatternSkinTheme2009/style.css');
@import url('../pub/System/PatternSkinTheme2009/colors.css');
</style>
<style type="text/css" media="all">
@import url('../pub/System/PatternSkinTheme2009/column_left.css');
@import url('../pub/System/PatternSkinTheme2009/variant_twiki.css');
</style><style type="text/css" media="all">
/* Styles that are set using variables */
.patternBookView .foswikiTopRow,
.patternWebIndicator a img,
.patternWebIndicator a:hover img {
background-color:#D0D0D0;
}
#patternTopBarContents { background-image:url(../pub/System/PatternSkin/header5.gif); background-repeat:repeat-x;}
#patternTopBarContents { background-color:#ffffff;}
.patternBookView {
border-color:#D0D0D0;
}
.patternPreviewPage #patternMain {
/* uncomment to set the preview image */
/*background-image:url("/pub/System/PreviewBackground/preview2bg.gif");*/
}
</style>
<style type="text/css" media="all">
@import url("../pub/System/PsiSkin/psicolors.css");
@import url("../pub/System/PsiSkin/psistyle.css");
.foswikiTopic {overflow: hidden;}
</style>
<style type="text/css" media="all">
@import url("../pub/System/PatternSkin/print.css");
.foswikiAttachments, #patternInfo, #patternBottomBar {display: none;}
.patternContent {overflow: visible}
</style>
<!--[if IE]><style type="text/css" media="screen">
pre {
height:1%;
overflow-x:auto;
}
.foswikiAttachments,
.foswikiForm,
.foswikiHelp,
.foswikiPreviewArea,
.patternPreviewPage .foswikiForm,
.patternSigLine,
.patternToolBar,
.patternTop,
.patternTopicAction,
#patternSideBarContents .patternLeftBarPersonal,
#patternSideBarContents h2,
#patternSideBarContents li,
#patternTopBarButtons ul {
height:1%;
}
#patternSideBarContents .patternLeftBarPersonal {
width:100%;
}
.foswikiFormStep {
height:100%;
}
#foswikiLogin,
.patternShadow {
border:10px solid #fff;
margin-top:10px;
margin-bottom:10px;
border:2px solid #ccc;
}
</style><![endif]-->
<!--[if gt IE 8 ]><style type="text/css" media="screen">
#foswikiLogin,
.patternShadow {
border:10px solid #fff;
margin-top:10px;
margin-bottom:10px;
box-shadow: 0 0 10px #ccc;
}
</style><![endif]-->
<script src="https://intranet.psi.ch/pub/System/ChecklistPlugin/itemstatechange.js" language="javascript" type="text/javascript"></script><script src="https://intranet.psi.ch/pub/System/TimeTablePlugin/timetabletooltips.js" language="javascript" type="text/javascript"></script></head>
<body class="patternViewPage patternPrintPage" id="BodyTop">
<a name="PageTop"></a><div class="foswikiPage"><div id="patternScreen">
<div id="patternPageShadow">
<div id="patternPage">
<div id="patternOuter">
<div id="patternFloatWrap">
<div id="patternMain">
<div id="patternMainContents">
<div class="patternContent"><div class="foswikiTopic">
<h1><a name="A_61_61musrgui_47_musredit_61_61"></a> <code><b>musrgui / musredit</b></code> </h1>
<p></p>
<a name="foswikiTOC"></a><div class="foswikiToc"> <ul>
<li> <a href="MusrGui.html#A_61_61musrgui_47_musredit_61_61"> musrgui / musredit </a>
</li> <li> <a href="MusrGui.html#A_1_Introduction"> 1 Introduction </a>
</li> <li> <a href="MusrGui.html#A_2_Available_Executables_44_Configuration_Files_and_their_Basic_Usage"> 2 Available Executables, Configuration Files and their Basic Usage </a> <ul>
<li> <a href="MusrGui.html#A_2.1_musrgui_47_musredit"> 2.1 musrgui / musredit </a>
</li> <li> <a href="MusrGui.html#A_2.2_musrgui_startup.xml_47_musredit_startup.xml"> 2.2 musrgui_startup.xml / musredit_startup.xml </a>
</li></ul>
</li> <li> <a href="MusrGui.html#A_3_61_61musrfit_61_61_Features"> 3 musrfit Features </a>
</li> <li> <a href="MusrGui.html#A_4_Editor_Features"> 4 Editor Features </a>
</li> <li> <a href="MusrGui.html#A_5_Bugtracking"> 5 Bugtracking </a>
</li></ul>
</div>
<p></p>
<h1><a name="A_1_Introduction"></a> 1 Introduction </h1>
<code>musrgui</code> and <code>musredit</code> are editors which also provide a graphical user interface to the programs contained in the <code><a href="MusrFit.html">musrfit</a></code> suite and are intended to help the user handle <code>musrfit</code> msr files. They are implemented in <code>C++</code> and use the <a href="http://qt.nokia.com/" target="_top">Qt</a> framework. Principally, <code>musrgui</code> and <code>musredit</code> are doing the same, but are based on different Qt versions. <code>musrgui</code> is based on Qt 3.x and will only be maintained on bug-fixing level since the Qt 3.x licensing is less straight forward than the Qt 4.x one. <code>musredit</code> is based on Qt 4.6 (or above) and this is the program which will be developed further.<br>
On this documentation page only the features related to <code>musrfit</code> are described&mdash;the basic editor functions which should be self-explanatory are not.
<strong><font color="#ff0000">Before going on using <code>musrgui</code> / <code>musredit</code> it is strongly recommended to read the <a href="MusrFit.html">manual</a> of <code>musrfit</code> first!</font></strong>
<p></p>
<h1><a name="A_2_Available_Executables_44_Configuration_Files_and_their_Basic_Usage"></a> 2 Available Executables, Configuration Files and their Basic Usage </h1>
<a name="MusrEdit"></a>
<h2><a name="A_2.1_musrgui_47_musredit"></a> 2.1 musrgui / musredit </h2>
<code>musrgui</code> / <code>musredit</code> are the editor executables. If called from within a shell they accept a few optional parameters: <dl>
<dt> &lt;msr_files&gt; </dt><dd> file names of the msr files that should be opened in separate editor tabs on startup of <code>musrgui</code> / <code>musredit</code>.
</dd> <dt> --help </dt><dd> displays a small help notice in the shell explaining the basic usage of the program
</dd> <dt> --version </dt><dd> prints the version number of <code>musrgui</code> / <code>musredit</code>
</dd></dl>
<p></p>
If called without any parameters an empty editor window opens.
<p></p>
<a name="MusreditStartupXml"></a>
<h2><a name="A_2.2_musrgui_startup.xml_47_musredit_startup.xml"></a> 2.2 musrgui_startup.xml / musredit_startup.xml </h2>
<code><b>musrgui_startup.xml</b></code> / <code><b>musredit_startup.xml</b></code> are configuration files located at the <code>musrgui</code> / <code>musredit</code> binary path. 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 XML tags are allowed to define settings and might proof useful for all users of <code>musrgui</code> / <code>musredit</code>: <dl>
<dt> &lt;general&gt;&lt;/general&gt; </dt><dd> set the default paths to executables and files in this environment <dl>
<dt> &lt;exec_path&gt;PATH_TO_EXEC&lt;/exec_path&gt; </dt><dd> set the path <strong>PATH_TO_EXEC</strong> where the executables <code>musrfit</code>, <code>musrview</code>, <code>musrt0</code>, etc. can be found (inside the &lt;general&gt; environment)
</dd> <dt> &lt;default_save_path&gt;SAV_PATH&lt;/default_save_path&gt; </dt><dd> specify the path <strong>SAV_PATH</strong> where <code>musrgui</code> / <code>musredit</code> point by default when opening and saving msr files (inside the &lt;general&gt; environment)
</dd> <dt> &lt;msr_default_file_path&gt;MSR_DEF_PATH&lt;/msr_default_file_path&gt; </dt><dd> set the path <strong>MSR_DEF_PATH</strong> where the <a href="#MusrfitFeatures" class="foswikiCurrentTopicLink">default msr files provided by</a> <code>musrgui</code> are stored (inside the &lt;general&gt; environment)
</dd> <dt> &lt;title_from_data_file&gt;y/n&lt;/title_from_data_file&gt; </dt><dd> specify if <code>musrfit</code> should be called with the <a href="MusrFit.html#MusrFit">-t option</a> by default (inside the &lt;general&gt; environment)
</dd> <dt> &lt;enable_musrt0&gt;y/n&lt;/enable_musrt0&gt; </dt><dd> specify if <code><a href="MusrFit.html#MusrT0">musrt0</a></code> can be called from within <code>musrgui</code> / <code>musredit</code> (inside the &lt;general&gt; environment)
</dd></dl>
</dd> <dt> &lt;font_settings&gt;&lt;/font_settings&gt; </dt><dd> set the default font in this environment <dl>
<dt> &lt;font_name&gt;FONT&lt;/font_name&gt; </dt><dd> specify the name of the font <strong>FONT</strong> to be used by default in <code>musrgui</code> / <code>musredit</code> (inside the &lt;font_settings&gt; environment)
</dd> <dt> &lt;font_size&gt;N&lt;/font_size&gt; </dt><dd> specify the size <strong>N</strong> of the font to be used by default in <code>musrgui</code> / <code>musredit</code> (inside the &lt;font_settings&gt; environment)
</dd></dl>
</dd> <dt> &lt;msr_file_defaults&gt;&lt;/msr_file_defaults&gt; </dt><dd> put the default settings for newly created msr files in this environment <dl>
<dt> &lt;beamline&gt;BL&lt;/beamline&gt; </dt><dd> set the name of the muon beamline <strong>BL</strong> here (inside a &lt;msr_file_defaults&gt;-environment)
</dd> <dt> &lt;institute&gt;INST&lt;/institute&gt; </dt><dd> set the name of the facility <strong>INST</strong> where the beamline <strong>BL</strong> is located. Valid settings are <strong>PSI</strong>, <strong>RAL</strong>, <strong>JPARC</strong>, and <strong>TRIUMF</strong> (inside a &lt;msr_file_defaults&gt; environment)
</dd> <dt> &lt;file_format&gt;FF&lt;/file_format&gt; </dt><dd> specify the default data file format <strong>FF</strong> here. Valid formats are <strong>NEXUS</strong>, <strong>ROOT-NPP</strong>, <strong>ROOT-PPC</strong>, <strong>PSI-BIN</strong>, <strong>PSI-MDU</strong>, <strong>MDU-ASCII</strong>, <strong>WKM</strong>, <strong>MUD</strong>, <strong>ASCII</strong>, and <strong>DB</strong> (inside a &lt;msr_file_defaults&gt; environment)
</dd> <dt> &lt;lifetime_correction&gt;y/n&lt;/lifetime_correction&gt; </dt><dd> choose if by default the <strong>lifetimecorrection</strong> <a href="MusrFit.html#LifeTimeCorrection">option</a> should be set (inside a &lt;msr_file_defaults&gt; environment)
</dd></dl>
</dd> <dt> &lt;msr2data_defaults&gt;&lt;/msr2data_defaults&gt; </dt><dd> define the default <a href="Msr2Data.html#OptionalParameters">options</a> for calling <code><a href="Msr2Data.html">msr2data</a></code> in this environment; the options set here are ticked by default in the <a href="Msr2Data.html#MusrGuiInterface">graphical interface</a> of <code>musrgui</code> / <code>musredit</code>. <dl>
<dt> &lt;chain_fit&gt;y/n&lt;/chain_fit&gt; </dt><dd> (un)set the chain fit (<strong>!</strong>) option (inside a &lt;msr2data_defaults&gt; environment)
</dd> <dt> &lt;write_data_header&gt;y/n&lt;/write_data_header&gt; </dt><dd> (un)set the <strong>noheader</strong> option (inside a &lt;msr2data_defaults&gt; environment)
</dd> <dt> &lt;ignore_data_header_info&gt;y/n&lt;/ignore_data_header_info&gt; </dt><dd> (un)set the <strong>nosummary</strong> option (inside a &lt;msr2data_defaults&gt; environment)
</dd> <dt> &lt;keep_minuit2_output&gt;y/n&lt;/keep_minuit2_output&gt; </dt><dd> (un)set the <strong>-k</strong> option (inside a &lt;msr2data_defaults&gt; environment)
</dd> <dt> &lt;write_column_data&gt;y/n&lt;/write_column_data&gt; </dt><dd> (un)set the <strong>data</strong> option (inside a &lt;msr2data_defaults&gt; environment)
</dd> <dt> &lt;create_msr_file_only&gt;y/n&lt;/create_msr_file_only&gt; </dt><dd> (un)set the <strong>msr</strong> option in case a template run is specified (inside a &lt;msr2data_defaults&gt; environment)
</dd> <dt> &lt;fit_only&gt;y/n&lt;/fit_only&gt; </dt><dd> (un)set the <strong>fit</strong> option in case no template run is specified (inside a &lt;msr2data_defaults&gt; environment)
</dd> <dt> &lt;global&gt;y/n&lt;/global&gt; </dt><dd> (un)set the <strong>global</strong> option (inside a &lt;msr2data_defaults&gt; environment)
</dd> <dt> &lt;global_plus&gt;y/n&lt;/global_plus&gt; </dt><dd> (un)set the <strong>global+</strong> option (inside a &lt;msr2data_defaults&gt; environment)
</dd> <dt> &lt;recreate_data_file&gt;y/n&lt;/recreate_data_file&gt; </dt><dd> (un)set the <code>musrgui</code> / <code>musredit</code> option for recreating the output file (inside a &lt;msr2data_defaults&gt; environment)
</dd> <dt> &lt;open_file_after_fitting&gt;y/n&lt;/open_file_after_fitting&gt; </dt><dd> (un)set the <code>musrgui</code> / <code>musredit</code> option for opening msr files after fitting (inside a &lt;msr2data_defaults&gt; environment)
</dd></dl>
</dd></dl>
<p></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>musrgui</code> / <code>musredit</code>: <dl>
<dt> &lt;help_section&gt;&lt;/help_section&gt; </dt><dd> define various help messages in this environment <dl>
<dt> &lt;help_main&gt;HELP TEXT&lt;/help_main&gt; </dt><dd> set the main help message <strong>HELP TEXT</strong> here (inside a &lt;help_section&gt; environment)
</dd></dl>
</dd> <dt> &lt;func_pixmap_path&gt;PIX_PATH&lt;/func_pixmap_path&gt; </dt><dd> set the path <strong>PIX_PATH</strong> to <img alt="LaTeX_logo.png" src="../pub/MUSR/MusrGui/LaTeX_logo.png" /> pixmaps visualizing the various supported theory functions
</dd> <dt> &lt;theory_functions&gt;&lt;/theory_functions&gt; </dt><dd> define the functions for a msr file's THEORY block <a href="MusrFit.html#TheoryTable">according to the correct syntax</a> in this environment <dl>
<dt> &lt;func&gt;&lt;/func&gt; </dt><dd> specify a function here (inside a &lt;theory_functions&gt; environment) <dl>
<dt> &lt;name&gt;NAME&lt;/name&gt; </dt><dd> the <strong>NAME</strong> of the function in the msr file (inside a &lt;func&gt; environment)
</dd> <dt> &lt;comment&gt;COMMENT&lt;/comment&gt; </dt><dd> description of the used parameters (inside a &lt;func&gt; environment)
</dd> <dt> &lt;label&gt;LABEL&lt;/label&gt; </dt><dd> <strong>LABEL</strong> of the function in the <code>musrgui</code> / <code>musredit</code> menu (inside a &lt;func&gt; environment)
</dd> <dt> &lt;pixmap&gt;PIXMAP&lt;/pixmap&gt; </dt><dd> <img alt="LaTeX_logo.png" src="../pub/MUSR/MusrGui/LaTeX_logo.png" /> picture used to describe the function and stored in the <strong>PIX_PATH</strong> (inside a &lt;func&gt; environment)
</dd> <dt> &lt;params&gt;N&lt;/params&gt; </dt><dd> number of parameters <strong>N</strong> used by the function (inside a &lt;func&gt; environment)
</dd></dl>
</dd></dl>
</dd></dl>
<p></p>
An example of the <code><b>musrgui_startup.xml</b></code> looks like:
<pre class="html">
&#60;?xml version&#61;&#34;1.0&#34; encoding&#61;&#34;UTF-8&#34;?&#62;
&#60;musrgui&#95;startup xmlns&#61;&#34;https://intranet.psi.ch/MUSR/MusrGui&#34;&#62;
&#60;general&#62;
&#60;exec&#95;path&#62;/usr/local/bin&#60;/exec&#95;path&#62;
&#60;default&#95;save&#95;path&#62;./&#60;/default&#95;save&#95;path&#62;
&#60;msr&#95;default&#95;file&#95;path&#62;/home/user/analysis/musrfit/src/musrgui&#60;/msr&#95;default&#95;file&#95;path&#62;
&#60;/general&#62;
&#60;font&#95;settings&#62;
&#60;font&#95;name&#62;Courier New&#60;/font&#95;name&#62;
&#60;font&#95;size&#62;10&#60;/font&#95;size&#62;
&#60;/font&#95;settings&#62;
&#60;msr&#95;file&#95;defaults&#62;
&#60;beamline&#62;mue4&#60;/beamline&#62;
&#60;institute&#62;psi&#60;/institute&#62;
&#60;file&#95;format&#62;root-npp&#60;/file&#95;format&#62;
&#60;lifetime&#95;correction&#62;y&#60;/lifetime&#95;correction&#62;
&#60;/msr&#95;file&#95;defaults&#62;
&#60;msr2data&#95;defaults&#62;
&#60;chain&#95;fit&#62;y&#60;/chain&#95;fit&#62;
&#60;write&#95;data&#95;header&#62;y&#60;/write&#95;data&#95;header&#62;
&#60;ignore&#95;data&#95;header&#95;info&#62;n&#60;/ignore&#95;data&#95;header&#95;info&#62;
&#60;keep&#95;minuit2&#95;output&#62;n&#60;/keep&#95;minuit2&#95;output&#62;
&#60;write&#95;column&#95;data&#62;n&#60;/write&#95;column&#95;data&#62;
&#60;recreate&#95;data&#95;file&#62;n&#60;/recreate&#95;data&#95;file&#62;
&#60;open&#95;file&#95;after&#95;fitting&#62;y&#60;/open&#95;file&#95;after&#95;fitting&#62;
&#60;create&#95;msr&#95;file&#95;only&#62;n&#60;/create&#95;msr&#95;file&#95;only&#62;
&#60;fit&#95;only&#62;n&#60;/fit&#95;only&#62;
&#60;global&#62;n&#60;/global&#62;
&#60;global&#95;plus&#62;n&#60;/global&#95;plus&#62;
&#60;/msr2data&#95;defaults&#62;
&#60;help&#95;section&#62;
&#60;help&#95;main&#62;
For a detailed description of the aim and structure of a msr file see http://lmu.web.psi.ch/facilities/software/musrfit/user/MUSR/MusrFit.html
&#60;/help&#95;main&#62;
&#60;/help&#95;section&#62;
&#60;func&#95;pixmap&#95;path&#62;/home/user/analysis/musrfit/src/musrgui/latex&#95;images&#60;/func&#95;pixmap&#95;path&#62;
&#60;theory&#95;functions&#62;
&#60;func&#62;
&#60;name&#62;asymmetry&#60;/name&#62;
&#60;comment&#62;&#60;/comment&#62;
&#60;label&#62;Asymmetry&#60;/label&#62;
&#60;pixmap&#62;asymmetry.png&#60;/pixmap&#62;
&#60;params&#62;1&#60;/params&#62;
&#60;/func&#62;
&#60;func&#62;
&#60;name&#62;simplExpo&#60;/name&#62;
&#60;comment&#62;(rate)&#60;/comment&#62;
&#60;label&#62;simple Exp&#60;/label&#62;
&#60;pixmap&#62;simpleExp.png&#60;/pixmap&#62;
&#60;params&#62;1&#60;/params&#62;
&#60;/func&#62;
&#60;func&#62;
&#60;name&#62;simplGss&#60;/name&#62;
&#60;comment&#62;(rate)&#60;/comment&#62;
&#60;label&#62;simple Gauss&#60;/label&#62;
&#60;pixmap&#62;simpleGauss.png&#60;/pixmap&#62;
&#60;params&#62;1&#60;/params&#62;
&#60;/func&#62;
&#60;/theory&#95;function&#62;
&#60;/musrgui&#95;startup&#62;
</pre>
<p></p>
<a name="MusrfitFeatures"></a>
<h1><a name="A_3_61_61musrfit_61_61_Features"></a> 3 <code><b>musrfit</b></code> Features </h1>
The features of <code>musrfit</code> which can be accessed by the graphical front ends <code>musrgui</code> / <code>musredit</code> are described in the following. All functions can either be called by choosing them from the MusrFit menu, by clicking the respective button in the MusrFit bar, or by using a keyboard shortcut.
<p></p> <dl>
<dt> <img alt="musrasym.png" src="../pub/MUSR/MusrGui/musrasym.png" /> Asymmetry Default (Alt+a) </dt><dd> Generate a full msr file suitable for the <a href="MusrFit.html#FitTypes">fit type</a> <strong>2</strong> of <code>musrfit</code> from defaults. Calling this function opens a window where the relative path and file name to a data file as well as the file format that should be used have to be specified. For instance if the data file <code><b>/path-to-datadir/2007/lem07_his_8472.root</b></code> should be used and <code><b>/path-to-datadir</b></code> is on the path where <code>musrfit</code> <a href="MusrFit.html#PathToDataFiles">looks for data files</a> then the file name would be <code><b>2007/lem07_his_8472</b></code> and the file format either <strong>ROOT-NPP</strong> or <strong>ROOT-PPC</strong>.
</dd></dl>
<p></p> <dl>
<dt> <img alt="musrsinglehisto.png" src="../pub/MUSR/MusrGui/musrsinglehisto.png" /> Single-Histogram Default (Alt+h) </dt><dd> Generate a full msr file suitable for the <a href="MusrFit.html#FitTypes">fit type</a> <strong>0</strong> of <code>musrfit</code> from defaults. Calling this function opens a window where the relative path and file name to a data file as well as the file format that should be used have to be specified. For instance if the data file <code><b>/path-to-datadir/d2007/deltat_pta_gps_8472.bin</b></code> should be used and <code><b>/path-to-datadir</b></code> is on the path where <code>musrfit</code> <a href="MusrFit.html#PathToDataFiles">looks for data files</a> then the file name would be <code><b>d2007/deltat_pta_gps_8472</b></code> and the file format <strong>PSI-BIN</strong>.
</dd></dl>
<p></p> <dl>
<dt> <img alt="musrcalcchisq.png" src="../pub/MUSR/MusrGui/musrcalcchisq.png" /> Calculate Chisq (Alt+c) </dt><dd> <pre class="bash">musrfit &#60;msr&#95;file&#62; --chisq-only</pre> is called for the <strong>&lt;msr_file&gt;</strong> selected in the editor. For further information refer to the <a href="MusrFit.html#MusrFit">manual</a> of <code>musrfit</code>.
</dd></dl>
<p></p> <dl>
<dt> <img alt="musrfit.png" src="../pub/MUSR/MusrGui/musrfit.png" /> Fit (Alt+f) </dt><dd> <pre class="bash">musrfit &#60;msr&#95;file&#62; &#91;optional parameters]</pre> is called for the <strong>&lt;msr_file&gt;</strong> selected in the editor. The optional parameters may be chosen under <a href="#MusrPrefs" class="foswikiCurrentTopicLink">Preferences</a>. For further information refer to the <a href="MusrFit.html#MusrFit">manual</a> of <code>musrfit</code>.
</dd></dl>
<p></p> <dl>
<dt> <img alt="musrswap.png" src="../pub/MUSR/MusrGui/musrswap.png" /> Swap Msr &#8596; Mlog (Alt+s) </dt><dd> Swap the msr and mlog files. E.g., for a file called <code><b>8472_zf.msr</b></code>, this is copied to <code><b>8472_zf.mlog</b></code> and vice versa.
</dd></dl>
<p></p> <dl>
<dt> <img alt="musrmsr2data.png" src="../pub/MUSR/MusrGui/musrmsr2data.png" /> Msr2data (Alt+m) </dt><dd> Opens a graphical interface to the <code>msr2data</code> program described in detail in its own <a href="Msr2Data.html#MusrGuiInterface">manual</a>.
</dd></dl>
<p></p> <dl>
<dt> <img alt="musrview.png" src="../pub/MUSR/MusrGui/musrview.png" /> View (Alt+v) </dt><dd> <pre class="bash">musrview &#60;msr&#95;file&#62;</pre> is called for the <strong>&lt;msr_file&gt;</strong> selected in the editor. For further information refer to the <a href="MusrFit.html#MusrView">manual</a> of <code>musrfit</code>.
</dd></dl>
<p></p> <dl>
<dt> <img alt="musrt0.png" src="../pub/MUSR/MusrGui/musrt0.png" /> T0 (Alt+t) </dt><dd> <pre class="bash">musrt0 &#60;msr&#95;file&#62;</pre> is called for the <strong>&lt;msr_file&gt;</strong> selected in the editor. For further information refer to the <a href="MusrFit.html#MusrT0">manual</a> of <code>musrfit</code>.
</dd></dl>
<p></p>
<a name="MusrPrefs"></a> <dl>
<dt> <img alt="musrprefs.png" src="../pub/MUSR/MusrGui/musrprefs.png" /> Preferences (Alt+p) </dt><dd> Opens a window in which the optional parameters that should be passed to <code>musrfit</code> can be chosen. These options are <code><b>--keep-mn2-output</b></code>, <code><b>--dump ascii</b></code>, <code><b>--dump root</b></code>, and <code><b>--title-from-data-file</b></code>. For further information refer to the <a href="MusrFit.html#MusrFit">manual</a> of <code>musrfit</code>. Additionally, the access to <code>musrt0</code> can be enabled temporarily.
</dd></dl>
<p></p>
<a name="EditorFeatures"></a>
<h1><a name="A_4_Editor_Features"></a> 4 Editor Features </h1>
Besides the functions described above and which are mostly interfacing <code>musrfit/msr2data</code> the editors of <code>musrgui</code> / <code>musredit</code> offer various functions for manipulating especially <code>musrfit</code> msr files:
<img src="../pub/MUSR/MusrGui/musrgui-editor-v0.png" alt="musrgui editor features" width='415' height='566' align="right" /> <ul>
<li> Upon right-clicking an open msr file a menu as shown to the right is displayed which offers the addition of any valid msr file block or theory function. In case a simple theory function is chosen, the function will be inserted into the THEORY block using the <a href="MusrFit.html#TheoryTable">correct syntax</a>. If one chooses to add a whole block to the file a dialog opens in which the necessary information for each block as described in the <a href="MusrFit.html#DescriptionOfTheMsrFileFormat">manual</a> of <code>musrfit</code> can be supplied. <font color="#0000ff">This feature is available only in <code>musrgui</code>. In <code>musredit</code> the respective functions can be accessed through the <em>Edit</em> menu.</font>
</li> <li> In order to comment or uncomment lines in a msr file select the according lines and apply <strong>Edit &rarr; (Un)Comment</strong> or use the keyboard shortcut <strong>Ctrl+(Shift)+m</strong>.
</li></ul>
<p></p>
<a name="BugTracking"></a>
<h1><a name="A_5_Bugtracking"></a> 5 Bugtracking </h1>
<p></p>
For reporting bugs or requesting new features and improvements please use the <a href="https://tracker.intranet.psi.ch/jira/browse/MUSR" target="_top">PSI Tracker</a> or send an e-mail to A. Suter.
<p></p>
-- <a href="http://www.fsf.org/register_form?referrer=8369" target="_top">BMW</a> &amp; <a href="http://lmu.web.psi.ch/lem/group.html" target="_top">AS</a></div><!-- /foswikiTopic-->
<p></p>
</div><!-- /patternContent-->
<hr />
This topic: MUSR<span class='foswikiSeparator'>&nbsp;&gt;&nbsp;</span><a href="WebHome.html" class="foswikiCurrentWebHomeLink">WebHome</a> &gt; <a href="MusrFit.html">MusrFit</a><span class='foswikiSeparator'>&nbsp;&gt;&nbsp;</span>MusrGui <br />
Topic revision: r18 - 20 Jul 2011 - 12:22:56 - <a href="https://intranet.psi.ch/Main/BastianWojek">BastianWojek</a>
</div>
</div>
</div>
<div class="clear">&nbsp;</div>
</div><div id="patternBottomBar"><div id="patternBottomBarContents"><div id="patternWebBottomBar">Ideas, requests, problems regarding <a href="https://intranet.psi.ch/Main/WebHome">PSI Wiki</a>? <a href="mailto:psi.intranet@psi.ch?subject=Foswiki%20Feedback%20on%20MUSR.MusrGui">Send feedback</a></div></div></div>
</div>
</div>
</div>
</div></div><!-- /endWrap -->
<p></p>
<p></p>
<p></p>
<p></p>
</body>
<!-- Mirrored from intranet.psi.ch/MUSR/MusrGui?cover=print by HTTrack Website Copier/3.x [XR&CO'2010], Mon, 01 Aug 2011 13:15:38 GMT -->
<!-- Added by HTTrack --><meta http-equiv="content-type" content="text/html;charset=iso-8859-1"><!-- /Added by HTTrack -->
</html>
<p></p>
<p></p>
<p></p>
<p></p>
<p></p>