970 lines
58 KiB
HTML
970 lines
58 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
|
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
|
|
<meta name="generator" content="Doxygen 1.13.2"/>
|
|
<meta name="viewport" content="width=device-width, initial-scale=1"/>
|
|
<title>musredit: PMsr2DataDialog Class Reference</title>
|
|
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="jquery.js"></script>
|
|
<script type="text/javascript" src="dynsections.js"></script>
|
|
<script type="text/javascript" src="clipboard.js"></script>
|
|
<link href="navtree.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="resize.js"></script>
|
|
<script type="text/javascript" src="cookie.js"></script>
|
|
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="search/searchdata.js"></script>
|
|
<script type="text/javascript" src="search/search.js"></script>
|
|
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
|
</head>
|
|
<body>
|
|
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
|
<div id="titlearea">
|
|
<table cellspacing="0" cellpadding="0">
|
|
<tbody>
|
|
<tr id="projectrow">
|
|
<td id="projectalign">
|
|
<div id="projectname">musredit<span id="projectnumber"> 1.0.0</span>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<!-- end header part -->
|
|
<!-- Generated by Doxygen 1.13.2 -->
|
|
<script type="text/javascript">
|
|
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
|
|
var searchBox = new SearchBox("searchBox", "search/",'.html');
|
|
/* @license-end */
|
|
</script>
|
|
<script type="text/javascript">
|
|
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
|
|
$(function() { codefold.init(0); });
|
|
/* @license-end */
|
|
</script>
|
|
<script type="text/javascript" src="menudata.js"></script>
|
|
<script type="text/javascript" src="menu.js"></script>
|
|
<script type="text/javascript">
|
|
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
|
|
$(function() {
|
|
initMenu('',true,false,'search.php','Search',false);
|
|
$(function() { init_search(); });
|
|
});
|
|
/* @license-end */
|
|
</script>
|
|
<div id="main-nav"></div>
|
|
<script type="text/javascript">
|
|
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
|
|
$(function(){ initResizable(false); });
|
|
/* @license-end */
|
|
</script>
|
|
<!-- window showing the filter options -->
|
|
<div id="MSearchSelectWindow"
|
|
onmouseover="return searchBox.OnSearchSelectShow()"
|
|
onmouseout="return searchBox.OnSearchSelectHide()"
|
|
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
|
</div>
|
|
|
|
<!-- iframe showing the search results (closed by default) -->
|
|
<div id="MSearchResultsWindow">
|
|
<div id="MSearchResults">
|
|
<div class="SRPage">
|
|
<div id="SRIndex">
|
|
<div id="SRResults"></div>
|
|
<div class="SRStatus" id="Loading">Loading...</div>
|
|
<div class="SRStatus" id="Searching">Searching...</div>
|
|
<div class="SRStatus" id="NoMatches">No Matches</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
</div><!-- top -->
|
|
<div id="doc-content">
|
|
<div class="header">
|
|
<div class="summary">
|
|
<a href="#pub-slots">Public Slots</a> |
|
|
<a href="#pub-methods">Public Member Functions</a> |
|
|
<a href="#pri-slots">Private Slots</a> |
|
|
<a href="#pri-attribs">Private Attributes</a> |
|
|
<a href="classPMsr2DataDialog-members.html">List of all members</a> </div>
|
|
<div class="headertitle"><div class="title">PMsr2DataDialog Class Reference</div></div>
|
|
</div><!--header-->
|
|
<div class="contents">
|
|
|
|
<p>Dialog for configuring msr2data batch processing parameters.
|
|
<a href="#details">More...</a></p>
|
|
|
|
<p><code>#include <<a class="el" href="PMsr2DataDialog_8h_source.html">PMsr2DataDialog.h</a>></code></p>
|
|
<div class="dynheader">
|
|
Inheritance diagram for PMsr2DataDialog:</div>
|
|
<div class="dyncontent">
|
|
<div class="center"><img src="classPMsr2DataDialog__inherit__graph.png" border="0" usemap="#aPMsr2DataDialog_inherit__map" alt="Inheritance graph"/></div>
|
|
<map name="aPMsr2DataDialog_inherit__map" id="aPMsr2DataDialog_inherit__map">
|
|
<area shape="rect" title="Dialog for configuring msr2data batch processing parameters." alt="" coords="43,81,168,109"/>
|
|
<area shape="rect" title=" " alt="" coords="5,5,76,33"/>
|
|
<area shape="poly" title=" " alt="" coords="64,43,96,79,92,82,60,46"/>
|
|
<area shape="rect" title=" " alt="" coords="100,5,243,33"/>
|
|
<area shape="poly" title=" " alt="" coords="152,46,119,82,115,79,148,43"/>
|
|
</map>
|
|
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
|
|
<div class="dynheader">
|
|
Collaboration diagram for PMsr2DataDialog:</div>
|
|
<div class="dyncontent">
|
|
<div class="center"><img src="classPMsr2DataDialog__coll__graph.png" border="0" usemap="#aPMsr2DataDialog_coll__map" alt="Collaboration graph"/></div>
|
|
<map name="aPMsr2DataDialog_coll__map" id="aPMsr2DataDialog_coll__map">
|
|
<area shape="rect" title="Dialog for configuring msr2data batch processing parameters." alt="" coords="108,98,234,126"/>
|
|
<area shape="rect" title=" " alt="" coords="5,5,76,33"/>
|
|
<area shape="poly" title=" " alt="" coords="73,40,154,95,151,100,70,44"/>
|
|
<area shape="rect" title=" " alt="" coords="100,5,243,33"/>
|
|
<area shape="poly" title=" " alt="" coords="174,48,174,98,168,98,168,48"/>
|
|
<area shape="rect" href="structPMsr2DataParam.html" title="Parameter structure for msr2data tool integration." alt="" coords="267,5,392,33"/>
|
|
<area shape="poly" title=" " alt="" coords="295,43,196,100,193,95,292,39"/>
|
|
</map>
|
|
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
|
|
<table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="pub-slots" name="pub-slots"></a>
|
|
Public Slots</h2></td></tr>
|
|
<tr class="memitem:adea6f6510f7c1ae8085d5ab4826e79d6" id="r_adea6f6510f7c1ae8085d5ab4826e79d6"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="#adea6f6510f7c1ae8085d5ab4826e79d6">runListEntered</a> (const QString &)</td></tr>
|
|
<tr class="memdesc:adea6f6510f7c1ae8085d5ab4826e79d6"><td class="mdescLeft"> </td><td class="mdescRight">Handles run list text field activation. <br /></td></tr>
|
|
<tr class="separator:adea6f6510f7c1ae8085d5ab4826e79d6"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a0383e9e8f2ef4dc804936f26009b3dd8" id="r_a0383e9e8f2ef4dc804936f26009b3dd8"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="#a0383e9e8f2ef4dc804936f26009b3dd8">runListFileNameEntered</a> (const QString &)</td></tr>
|
|
<tr class="memdesc:a0383e9e8f2ef4dc804936f26009b3dd8"><td class="mdescLeft"> </td><td class="mdescRight">Handles run list file name text field activation. <br /></td></tr>
|
|
<tr class="separator:a0383e9e8f2ef4dc804936f26009b3dd8"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a5b995ea405cf474127ddea895f30322f" id="r_a5b995ea405cf474127ddea895f30322f"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="#a5b995ea405cf474127ddea895f30322f">templateRunEntered</a> (const QString &)</td></tr>
|
|
<tr class="memdesc:a5b995ea405cf474127ddea895f30322f"><td class="mdescLeft"> </td><td class="mdescRight">Handles template run number text field activation. <br /></td></tr>
|
|
<tr class="separator:a5b995ea405cf474127ddea895f30322f"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a83dc711c4beb4feca3022685c2e4291d" id="r_a83dc711c4beb4feca3022685c2e4291d"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="#a83dc711c4beb4feca3022685c2e4291d">createMsrFileOnlyChanged</a> (int)</td></tr>
|
|
<tr class="memdesc:a83dc711c4beb4feca3022685c2e4291d"><td class="mdescLeft"> </td><td class="mdescRight">Handles "Create msr-File only" checkbox state changes. <br /></td></tr>
|
|
<tr class="separator:a83dc711c4beb4feca3022685c2e4291d"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a2eb5c9ab5967b77f15e8a23e35e0aad7" id="r_a2eb5c9ab5967b77f15e8a23e35e0aad7"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="#a2eb5c9ab5967b77f15e8a23e35e0aad7">fitOnlyChanged</a> (int)</td></tr>
|
|
<tr class="memdesc:a2eb5c9ab5967b77f15e8a23e35e0aad7"><td class="mdescLeft"> </td><td class="mdescRight">Handles "Fit Only" checkbox state changes. <br /></td></tr>
|
|
<tr class="separator:a2eb5c9ab5967b77f15e8a23e35e0aad7"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:aa020e93e07cd0f76daff60a145a0f098" id="r_aa020e93e07cd0f76daff60a145a0f098"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="#aa020e93e07cd0f76daff60a145a0f098">helpContent</a> ()</td></tr>
|
|
<tr class="memdesc:aa020e93e07cd0f76daff60a145a0f098"><td class="mdescLeft"> </td><td class="mdescRight">Opens online help for msr2data. <br /></td></tr>
|
|
<tr class="separator:aa020e93e07cd0f76daff60a145a0f098"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="pub-methods" name="pub-methods"></a>
|
|
Public Member Functions</h2></td></tr>
|
|
<tr class="memitem:a331e2a59fe899016db06223bf2262b00" id="r_a331e2a59fe899016db06223bf2262b00"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#a331e2a59fe899016db06223bf2262b00">PMsr2DataDialog</a> (<a class="el" href="structPMsr2DataParam.html">PMsr2DataParam</a> *msr2DataParam, const QString helpUrl)</td></tr>
|
|
<tr class="memdesc:a331e2a59fe899016db06223bf2262b00"><td class="mdescLeft"> </td><td class="mdescRight">Constructs the msr2data configuration dialog. <br /></td></tr>
|
|
<tr class="separator:a331e2a59fe899016db06223bf2262b00"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a49d5e6caa1913be03be54c2a37cc7148" id="r_a49d5e6caa1913be03be54c2a37cc7148"><td class="memItemLeft" align="right" valign="top">virtual int </td><td class="memItemRight" valign="bottom"><a class="el" href="#a49d5e6caa1913be03be54c2a37cc7148">getRunTag</a> ()</td></tr>
|
|
<tr class="memdesc:a49d5e6caa1913be03be54c2a37cc7148"><td class="mdescLeft"> </td><td class="mdescRight">Returns the run input method tag. <br /></td></tr>
|
|
<tr class="separator:a49d5e6caa1913be03be54c2a37cc7148"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a5a9288ee38ed01aa805729871d343810" id="r_a5a9288ee38ed01aa805729871d343810"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="structPMsr2DataParam.html">PMsr2DataParam</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="#a5a9288ee38ed01aa805729871d343810">getMsr2DataParam</a> ()</td></tr>
|
|
<tr class="memdesc:a5a9288ee38ed01aa805729871d343810"><td class="mdescLeft"> </td><td class="mdescRight">Retrieves all msr2data parameters from the dialog. <br /></td></tr>
|
|
<tr class="separator:a5a9288ee38ed01aa805729871d343810"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="pri-slots" name="pri-slots"></a>
|
|
Private Slots</h2></td></tr>
|
|
<tr class="memitem:add376da108b625c54cd9ff5bc570941f" id="r_add376da108b625c54cd9ff5bc570941f"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="#add376da108b625c54cd9ff5bc570941f">globalOptionSet</a> (bool checked)</td></tr>
|
|
<tr class="memdesc:add376da108b625c54cd9ff5bc570941f"><td class="mdescLeft"> </td><td class="mdescRight">Enforces mutual exclusivity between global and global+ options. <br /></td></tr>
|
|
<tr class="separator:add376da108b625c54cd9ff5bc570941f"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a3ef29831eee8104aabcb6a457bbb27bb" id="r_a3ef29831eee8104aabcb6a457bbb27bb"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="#a3ef29831eee8104aabcb6a457bbb27bb">globalPlusOptionSet</a> (bool checked)</td></tr>
|
|
<tr class="memdesc:a3ef29831eee8104aabcb6a457bbb27bb"><td class="mdescLeft"> </td><td class="mdescRight">Enforces mutual exclusivity between global+ and global options. <br /></td></tr>
|
|
<tr class="separator:a3ef29831eee8104aabcb6a457bbb27bb"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="pri-attribs" name="pri-attribs"></a>
|
|
Private Attributes</h2></td></tr>
|
|
<tr class="memitem:a69c0c714d167571710d9d222e04dcb49" id="r_a69c0c714d167571710d9d222e04dcb49"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#a69c0c714d167571710d9d222e04dcb49">fRunTag</a></td></tr>
|
|
<tr class="memdesc:a69c0c714d167571710d9d222e04dcb49"><td class="mdescLeft"> </td><td class="mdescRight">Run input method: -1=invalid, 0=direct list, 1=file name. <br /></td></tr>
|
|
<tr class="separator:a69c0c714d167571710d9d222e04dcb49"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a1d4e616868a2151b86555358a1e38e5b" id="r_a1d4e616868a2151b86555358a1e38e5b"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structPMsr2DataParam.html">PMsr2DataParam</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="#a1d4e616868a2151b86555358a1e38e5b">fMsr2DataParam</a></td></tr>
|
|
<tr class="memdesc:a1d4e616868a2151b86555358a1e38e5b"><td class="mdescLeft"> </td><td class="mdescRight">Pointer to parameter structure for msr2data configuration. <br /></td></tr>
|
|
<tr class="separator:a1d4e616868a2151b86555358a1e38e5b"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ad1a9f830b1a1049f1b31c9d7e219ab91" id="r_ad1a9f830b1a1049f1b31c9d7e219ab91"><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><a class="el" href="#ad1a9f830b1a1049f1b31c9d7e219ab91">fHelpUrl</a></td></tr>
|
|
<tr class="memdesc:ad1a9f830b1a1049f1b31c9d7e219ab91"><td class="mdescLeft"> </td><td class="mdescRight">URL to online msr2data documentation. <br /></td></tr>
|
|
<tr class="separator:ad1a9f830b1a1049f1b31c9d7e219ab91"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table>
|
|
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
|
|
<div class="textblock"><p>Dialog for configuring msr2data batch processing parameters. </p>
|
|
<p>This dialog collects all necessary input parameters for B.M. Wojek's msr2data program, which automates the fitting of multiple µSR data runs. The tool uses a template msr file to generate individual fit files for each run and optionally extracts fit results to database or column files.</p>
|
|
<dl class="section user"><dt>Run Selection:</dt><dd>Users can specify runs to process in two ways:<ul>
|
|
<li>Direct run list: Comma-separated run numbers (e.g., "123,125-130,145")</li>
|
|
<li>Run list file: Path to a file containing run numbers</li>
|
|
</ul>
|
|
</dd></dl>
|
|
<dl class="section user"><dt>Template System:</dt><dd>A template run number defines an existing msr file used as a pattern for creating msr files for all runs in the list. The template's RUN blocks are updated with new run numbers while preserving the fit structure.</dd></dl>
|
|
<dl class="section user"><dt>Processing Modes:</dt><dd><ul>
|
|
<li>Create msr files only: Generate msr files without fitting</li>
|
|
<li>Fit only: Fit existing msr files (no template needed)</li>
|
|
<li>Full processing: Create msr files and fit them</li>
|
|
</ul>
|
|
</dd></dl>
|
|
<dl class="section user"><dt>Global Fitting:</dt><dd><ul>
|
|
<li>global: Fit with shared parameters across runs (standard global fit)</li>
|
|
<li>global+: Enhanced global fitting with additional constraints</li>
|
|
</ul>
|
|
</dd></dl>
|
|
<dl class="section user"><dt>Output Options:</dt><dd><ul>
|
|
<li>Database file: Append fit results to a structured database</li>
|
|
<li>Column file: Write results in columnar format</li>
|
|
<li>YAML output: Export fit results in YAML format</li>
|
|
<li>Per-run chi-square: Include individual run chi-square values</li>
|
|
</ul>
|
|
</dd></dl>
|
|
<dl class="section note"><dt>Note</dt><dd>The dialog enforces mutual exclusivity between conflicting options (e.g., create-only vs. fit-only, global vs. global+).</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="structPMsr2DataParam.html" title="Parameter structure for msr2data tool integration.">PMsr2DataParam</a> Structure holding all msr2data parameters </dd>
|
|
<dd>
|
|
musredit For the <a class="el" href="main_8cpp.html#a3c04138a5bfe5d72780bb7e82a18e627" title="Main entry point for the musredit application.">main</a> editor application </dd></dl>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="PMsr2DataDialog_8h_source.html#l00097">97</a> of file <a class="el" href="PMsr2DataDialog_8h_source.html">PMsr2DataDialog.h</a>.</p>
|
|
</div><h2 class="groupheader">Constructor & Destructor Documentation</h2>
|
|
<a id="a331e2a59fe899016db06223bf2262b00" name="a331e2a59fe899016db06223bf2262b00"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a331e2a59fe899016db06223bf2262b00">◆ </a></span>PMsr2DataDialog()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">PMsr2DataDialog::PMsr2DataDialog </td>
|
|
<td>(</td>
|
|
<td class="paramtype"><a class="el" href="structPMsr2DataParam.html">PMsr2DataParam</a> *</td> <td class="paramname"><span class="paramname"><em>msr2DataParam</em></span>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const QString</td> <td class="paramname"><span class="paramname"><em>helpUrl</em></span> )</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Constructs the msr2data configuration dialog. </p>
|
|
<p>Constructor - Initializes the msr2data configuration dialog.</p>
|
|
<p>Initializes the dialog with existing msr2data parameters and sets up all UI controls including text fields, checkboxes, and validators. The dialog is configured as modal and establishes signal-slot connections for option interdependencies.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">msr2DataParam</td><td>Pointer to the parameter structure containing previously saved msr2data settings. The dialog will populate fields with these values and update them when the user accepts the dialog. </td></tr>
|
|
<tr><td class="paramname">helpUrl</td><td>URL string pointing to online msr2data documentation. If empty, the help button will show a placeholder message.</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#a5a9288ee38ed01aa805729871d343810" title="Retrieves all msr2data parameters from the dialog.">getMsr2DataParam()</a> Retrieves updated parameters after dialog acceptance </dd>
|
|
<dd>
|
|
<a class="el" href="structPMsr2DataParam.html" title="Parameter structure for msr2data tool integration.">PMsr2DataParam</a> Data structure definition</dd></dl>
|
|
<p>Sets up the complete user interface for msr2data parameter configuration. The initialization process includes:</p>
|
|
<ol type="1">
|
|
<li><b>UI Setup</b>: Loads the dialog layout from Qt Designer UI file</li>
|
|
<li><b>Modal Configuration</b>: Sets the dialog as modal to ensure completion</li>
|
|
<li><b>Field Population</b>: Fills all text fields from saved parameters</li>
|
|
<li><b>Validation</b>: Installs integer validator on template run number field</li>
|
|
<li><b>Checkbox States</b>: Restores all checkbox states from saved configuration</li>
|
|
<li><b>Signal Connections</b>: Establishes slots for option interdependencies</li>
|
|
</ol>
|
|
<p>The dialog handles a comprehensive set of msr2data parameters:</p>
|
|
<p><b>Run Input:</b></p><ul>
|
|
<li>Direct run list (comma-separated, ranges allowed)</li>
|
|
<li>Run list file path</li>
|
|
<li>Template run number for msr file generation</li>
|
|
<li>msr file extension (e.g., ".msr")</li>
|
|
</ul>
|
|
<p><b>Output Configuration:</b></p><ul>
|
|
<li>Database output file name</li>
|
|
<li>Parameter list for output</li>
|
|
<li>Write/recreate database file options</li>
|
|
<li>Column data and YAML output formats</li>
|
|
</ul>
|
|
<p><b>Processing Options:</b></p><ul>
|
|
<li>Create msr files only (no fitting)</li>
|
|
<li>Fit only (use existing msr files)</li>
|
|
<li>Chain fitting (sequential parameter passing)</li>
|
|
<li>Global/Global+ fitting modes (mutually exclusive)</li>
|
|
</ul>
|
|
<p><b>Advanced Options:</b></p><ul>
|
|
<li>Estimate N0 from data</li>
|
|
<li>Keep MINUIT2 output files</li>
|
|
<li>Per-run block chi-square values</li>
|
|
<li>Title from data file</li>
|
|
<li>Ignore data header information</li>
|
|
<li>Open files after fitting</li>
|
|
</ul>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">msr2DataParam</td><td>Pointer to <a class="el" href="structPMsr2DataParam.html" title="Parameter structure for msr2data tool integration.">PMsr2DataParam</a> structure containing previously saved msr2data settings. Must not be nullptr. The dialog will populate UI controls from this structure and update it when accepted. </td></tr>
|
|
<tr><td class="paramname">helpUrl</td><td>URL string for online msr2data documentation. If empty, the help button will display a placeholder message.</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section note"><dt>Note</dt><dd>The template run number field only accepts integer input via QIntValidator. </dd>
|
|
<dd>
|
|
The OK button is set as the default button for convenient dialog acceptance. </dd>
|
|
<dd>
|
|
Signal connections enforce mutual exclusivity between global and global+.</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#a5a9288ee38ed01aa805729871d343810" title="Retrieves all msr2data parameters from the dialog.">getMsr2DataParam()</a> Retrieves updated parameters after dialog acceptance </dd>
|
|
<dd>
|
|
<a class="el" href="#add376da108b625c54cd9ff5bc570941f" title="Enforces mutual exclusivity between global and global+ options.">globalOptionSet()</a> Handles global checkbox interactions </dd>
|
|
<dd>
|
|
<a class="el" href="#a3ef29831eee8104aabcb6a457bbb27bb" title="Enforces mutual exclusivity between global+ and global options.">globalPlusOptionSet()</a> Handles global+ checkbox interactions </dd></dl>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="PMsr2DataDialog_8cpp_source.html#l00114">114</a> of file <a class="el" href="PMsr2DataDialog_8cpp_source.html">PMsr2DataDialog.cpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<h2 class="groupheader">Member Function Documentation</h2>
|
|
<a id="a83dc711c4beb4feca3022685c2e4291d" name="a83dc711c4beb4feca3022685c2e4291d"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a83dc711c4beb4feca3022685c2e4291d">◆ </a></span>createMsrFileOnlyChanged</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void PMsr2DataDialog::createMsrFileOnlyChanged </td>
|
|
<td>(</td>
|
|
<td class="paramtype">int</td> <td class="paramname"><span class="paramname"><em>buttonState</em></span></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel slot">slot</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Handles "Create msr-File only" checkbox state changes. </p>
|
|
<p>Slot: Handles "Create msr-File only" checkbox changes.</p>
|
|
<p>Called when the create-only checkbox is toggled. If checked, automatically unchecks "Fit Only" since these modes are mutually exclusive.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">buttonState</td><td>Qt checkbox state (Qt::Checked or Qt::Unchecked).</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#a2eb5c9ab5967b77f15e8a23e35e0aad7" title="Handles "Fit Only" checkbox state changes.">fitOnlyChanged()</a> For the complementary option</dd></dl>
|
|
<p>Called when the user toggles the create-msr-file-only checkbox. This mode generates msr files from the template without performing fits, which is useful for reviewing generated files before batch fitting.</p>
|
|
<p>Since creating files only and fitting only are mutually exclusive operations, checking this option automatically unchecks "Fit Only".</p>
|
|
<p>Workflow for create-only mode:</p><ol type="1">
|
|
<li>Specify run list (direct or file)</li>
|
|
<li>Provide template run number</li>
|
|
<li>Check "Create msr-File only"</li>
|
|
<li>Execute to generate msr files</li>
|
|
<li>Review generated files</li>
|
|
<li>Optionally run again with "Fit Only" to perform fits</li>
|
|
</ol>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">buttonState</td><td>Qt checkbox state (Qt::Checked or Qt::Unchecked).</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#a2eb5c9ab5967b77f15e8a23e35e0aad7" title="Handles "Fit Only" checkbox state changes.">fitOnlyChanged()</a> Complementary method for the fit-only option </dd></dl>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="PMsr2DataDialog_8cpp_source.html#l00386">386</a> of file <a class="el" href="PMsr2DataDialog_8cpp_source.html">PMsr2DataDialog.cpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a2eb5c9ab5967b77f15e8a23e35e0aad7" name="a2eb5c9ab5967b77f15e8a23e35e0aad7"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a2eb5c9ab5967b77f15e8a23e35e0aad7">◆ </a></span>fitOnlyChanged</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void PMsr2DataDialog::fitOnlyChanged </td>
|
|
<td>(</td>
|
|
<td class="paramtype">int</td> <td class="paramname"><span class="paramname"><em>buttonState</em></span></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel slot">slot</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Handles "Fit Only" checkbox state changes. </p>
|
|
<p>Slot: Handles "Fit Only" checkbox changes.</p>
|
|
<p>Called when the fit-only checkbox is toggled. If checked, automatically unchecks "Create msr-File only" and clears the template run number since fitting existing files doesn't require a template.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">buttonState</td><td>Qt checkbox state (Qt::Checked or Qt::Unchecked).</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#a83dc711c4beb4feca3022685c2e4291d" title="Handles "Create msr-File only" checkbox state changes.">createMsrFileOnlyChanged()</a> For the complementary option</dd></dl>
|
|
<p>Called when the user toggles the fit-only checkbox. This mode fits existing msr files without generating new ones, which is useful for refitting after manual msr file modifications or after initial create-only generation.</p>
|
|
<p>When fit-only mode is enabled:</p><ul>
|
|
<li>"Create msr-File only" is automatically unchecked (mutually exclusive)</li>
|
|
<li>Template run number field is cleared (no template needed)</li>
|
|
</ul>
|
|
<p>Fit-only mode workflow:</p><ol type="1">
|
|
<li>Specify run list (direct or file)</li>
|
|
<li>Ensure msr files exist for all runs</li>
|
|
<li>Check "Fit Only"</li>
|
|
<li>Execute to fit existing msr files</li>
|
|
</ol>
|
|
<p>This is particularly useful for:</p><ul>
|
|
<li>Refitting after parameter adjustments</li>
|
|
<li>Fitting manually created msr files</li>
|
|
<li>Two-stage workflow (create, review, then fit)</li>
|
|
</ul>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">buttonState</td><td>Qt checkbox state (Qt::Checked or Qt::Unchecked).</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#a83dc711c4beb4feca3022685c2e4291d" title="Handles "Create msr-File only" checkbox state changes.">createMsrFileOnlyChanged()</a> Complementary method for the create-only option </dd>
|
|
<dd>
|
|
<a class="el" href="#a5b995ea405cf474127ddea895f30322f" title="Handles template run number text field activation.">templateRunEntered()</a> Clears fit-only when template is provided </dd></dl>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="PMsr2DataDialog_8cpp_source.html#l00421">421</a> of file <a class="el" href="PMsr2DataDialog_8cpp_source.html">PMsr2DataDialog.cpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a5a9288ee38ed01aa805729871d343810" name="a5a9288ee38ed01aa805729871d343810"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a5a9288ee38ed01aa805729871d343810">◆ </a></span>getMsr2DataParam()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="structPMsr2DataParam.html">PMsr2DataParam</a> * PMsr2DataDialog::getMsr2DataParam </td>
|
|
<td>(</td>
|
|
<td class="paramname"><span class="paramname"><em></em></span></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel virtual">virtual</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Retrieves all msr2data parameters from the dialog. </p>
|
|
<p>Retrieves all msr2data parameters from dialog UI controls.</p>
|
|
<p>Collects values from all UI controls and updates the internal <a class="el" href="structPMsr2DataParam.html" title="Parameter structure for msr2data tool integration.">PMsr2DataParam</a> structure. This includes:</p><ul>
|
|
<li>Run list specifications (direct list or file)</li>
|
|
<li>Template run number</li>
|
|
<li>msr file extension</li>
|
|
<li>Output file names and parameter list</li>
|
|
<li>All checkbox options (header writing, estimation, fitting modes, etc.)</li>
|
|
</ul>
|
|
<p>This method is typically called after the dialog is accepted to obtain the complete configuration for launching msr2data.</p>
|
|
<dl class="section return"><dt>Returns</dt><dd>PMsr2DataParam* Pointer to the updated parameter structure. The caller owns this structure and must manage its lifetime.</dd></dl>
|
|
<dl class="section note"><dt>Note</dt><dd>The returned pointer is the same as the one passed to the constructor, just with updated values.</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="structPMsr2DataParam.html" title="Parameter structure for msr2data tool integration.">PMsr2DataParam</a> For the complete parameter structure definition</dd></dl>
|
|
<p>Collects values from all text fields and checkboxes in the dialog and updates the internal <a class="el" href="structPMsr2DataParam.html" title="Parameter structure for msr2data tool integration.">PMsr2DataParam</a> structure. This method provides a complete snapshot of the user's msr2data configuration.</p>
|
|
<p>The collected parameters include:</p>
|
|
<p><b>Run Specification:</b></p><ul>
|
|
<li>runList: Direct run list string (e.g., "123,125-130,145")</li>
|
|
<li>runListFileName: Path to file containing run numbers</li>
|
|
<li>msrFileExtension: File extension for msr files (e.g., ".msr")</li>
|
|
<li>templateRunNo: Template run number for msr file generation (-1 if empty)</li>
|
|
</ul>
|
|
<p><b>Output Configuration:</b></p><ul>
|
|
<li>dbOutputFileName: Database file path for fit results</li>
|
|
<li>paramList: Comma-separated list of parameters to extract</li>
|
|
<li>writeDbHeader: Write header line to database file</li>
|
|
<li>writeColumnData: Output results in column format</li>
|
|
<li>yamlOut: Generate YAML format output</li>
|
|
<li>perRunBlockChisq: Include per-run chi-square values</li>
|
|
</ul>
|
|
<p><b>Processing Control:</b></p><ul>
|
|
<li>createMsrFileOnly: Generate msr files without fitting</li>
|
|
<li>fitOnly: Fit existing msr files (no template needed)</li>
|
|
<li>chainFit: Pass parameters sequentially between runs</li>
|
|
<li>global: Standard global fitting mode</li>
|
|
<li>globalPlus: Enhanced global fitting mode</li>
|
|
</ul>
|
|
<p><b>Advanced Options:</b></p><ul>
|
|
<li>estimateN0: Estimate initial asymmetry from data</li>
|
|
<li>keepMinuit2Output: Preserve MINUIT2 output files</li>
|
|
<li>recreateDbFile: Overwrite existing database file</li>
|
|
<li>ignoreDataHeaderInfo: Skip data file header parsing</li>
|
|
<li>titleFromDataFile: Extract title from data file</li>
|
|
<li>openFilesAfterFitting: Open result files in default applications</li>
|
|
</ul>
|
|
<dl class="section return"><dt>Returns</dt><dd>PMsr2DataParam* Pointer to the updated parameter structure. This is the same pointer passed to the constructor, with all fields updated from the dialog UI. The caller retains ownership.</dd></dl>
|
|
<dl class="section note"><dt>Note</dt><dd>This method is typically called after the dialog is accepted via OK button. </dd>
|
|
<dd>
|
|
Empty template run number field is converted to -1 to indicate no template. </dd>
|
|
<dd>
|
|
The method performs no validation; all values are accepted as entered.</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#a331e2a59fe899016db06223bf2262b00" title="Constructs the msr2data configuration dialog.">PMsr2DataDialog::PMsr2DataDialog()</a> Where the parameter structure is initialized </dd>
|
|
<dd>
|
|
<a class="el" href="structPMsr2DataParam.html" title="Parameter structure for msr2data tool integration.">PMsr2DataParam</a> Structure definition with all field descriptions </dd></dl>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="PMsr2DataDialog_8cpp_source.html#l00222">222</a> of file <a class="el" href="PMsr2DataDialog_8cpp_source.html">PMsr2DataDialog.cpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a49d5e6caa1913be03be54c2a37cc7148" name="a49d5e6caa1913be03be54c2a37cc7148"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a49d5e6caa1913be03be54c2a37cc7148">◆ </a></span>getRunTag()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">virtual int PMsr2DataDialog::getRunTag </td>
|
|
<td>(</td>
|
|
<td class="paramname"><span class="paramname"><em></em></span></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel inline">inline</span><span class="mlabel virtual">virtual</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Returns the run input method tag. </p>
|
|
<p>Indicates which method was used to specify the run list:</p><ul>
|
|
<li>-1: Invalid or no input provided</li>
|
|
<li>0: Direct run list entered in the text field</li>
|
|
<li>1: Run list file name provided</li>
|
|
</ul>
|
|
<p>This tag helps the caller determine how to interpret the run information when processing the dialog results.</p>
|
|
<dl class="section return"><dt>Returns</dt><dd>int representing the run input method (see details).</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#adea6f6510f7c1ae8085d5ab4826e79d6" title="Handles run list text field activation.">runListEntered()</a> Sets tag to 0 </dd>
|
|
<dd>
|
|
<a class="el" href="#a0383e9e8f2ef4dc804936f26009b3dd8" title="Handles run list file name text field activation.">runListFileNameEntered()</a> Sets tag to 1 </dd></dl>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="PMsr2DataDialog_8h_source.html#l00138">138</a> of file <a class="el" href="PMsr2DataDialog_8h_source.html">PMsr2DataDialog.h</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="add376da108b625c54cd9ff5bc570941f" name="add376da108b625c54cd9ff5bc570941f"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#add376da108b625c54cd9ff5bc570941f">◆ </a></span>globalOptionSet</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void PMsr2DataDialog::globalOptionSet </td>
|
|
<td>(</td>
|
|
<td class="paramtype">bool</td> <td class="paramname"><span class="paramname"><em>checked</em></span></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel private">private</span><span class="mlabel slot">slot</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Enforces mutual exclusivity between global and global+ options. </p>
|
|
<p>Private slot: Enforces global/global+ mutual exclusivity (global side).</p>
|
|
<p>Called when the "global" checkbox is toggled. If global is checked, automatically unchecks global+ since these fitting modes cannot be used simultaneously.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">checked</td><td>true if the global checkbox is now checked.</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#a3ef29831eee8104aabcb6a457bbb27bb" title="Enforces mutual exclusivity between global+ and global options.">globalPlusOptionSet()</a> For the complementary option</dd></dl>
|
|
<p>Called when the "global" checkbox state changes. Global and global+ are mutually exclusive fitting modes that cannot be used simultaneously:</p>
|
|
<ul>
|
|
<li><b>global</b>: Standard global fitting where parameters marked as "global" in the msr file are shared across all runs in the fit. All runs are fitted simultaneously with shared parameters constrained to have identical values.</li>
|
|
<li><b>global+</b>: Enhanced global fitting mode with additional features for complex multi-run scenarios (see msr2data documentation for details).</li>
|
|
</ul>
|
|
<p>When global is checked, this method automatically unchecks global+ to prevent conflicting mode selection.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">checked</td><td>true if the global checkbox is now checked, false otherwise.</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section note"><dt>Note</dt><dd>This slot is connected to the global checkbox clicked signal in the constructor.</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#a3ef29831eee8104aabcb6a457bbb27bb" title="Enforces mutual exclusivity between global+ and global options.">globalPlusOptionSet()</a> Complementary method handling global+ checkbox </dd></dl>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="PMsr2DataDialog_8cpp_source.html#l00498">498</a> of file <a class="el" href="PMsr2DataDialog_8cpp_source.html">PMsr2DataDialog.cpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a3ef29831eee8104aabcb6a457bbb27bb" name="a3ef29831eee8104aabcb6a457bbb27bb"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a3ef29831eee8104aabcb6a457bbb27bb">◆ </a></span>globalPlusOptionSet</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void PMsr2DataDialog::globalPlusOptionSet </td>
|
|
<td>(</td>
|
|
<td class="paramtype">bool</td> <td class="paramname"><span class="paramname"><em>checked</em></span></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel private">private</span><span class="mlabel slot">slot</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Enforces mutual exclusivity between global+ and global options. </p>
|
|
<p>Private slot: Enforces global/global+ mutual exclusivity (global+ side).</p>
|
|
<p>Called when the "global+" checkbox is toggled. If global+ is checked, automatically unchecks global since these fitting modes cannot be used simultaneously.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">checked</td><td>true if the global+ checkbox is now checked.</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#add376da108b625c54cd9ff5bc570941f" title="Enforces mutual exclusivity between global and global+ options.">globalOptionSet()</a> For the complementary option</dd></dl>
|
|
<p>Called when the "global+" checkbox state changes. Global and global+ are mutually exclusive fitting modes that cannot be used simultaneously:</p>
|
|
<ul>
|
|
<li><b>global</b>: Standard global fitting where parameters marked as "global" in the msr file are shared across all runs in the fit.</li>
|
|
<li><b>global+</b>: Enhanced global fitting mode with extended capabilities for handling more complex global fitting scenarios with additional constraints and parameter relationships.</li>
|
|
</ul>
|
|
<p>When global+ is checked, this method automatically unchecks global to prevent conflicting mode selection.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">checked</td><td>true if the global+ checkbox is now checked, false otherwise.</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section note"><dt>Note</dt><dd>This slot is connected to the global+ checkbox clicked signal in the constructor.</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#add376da108b625c54cd9ff5bc570941f" title="Enforces mutual exclusivity between global and global+ options.">globalOptionSet()</a> Complementary method handling global checkbox </dd></dl>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="PMsr2DataDialog_8cpp_source.html#l00530">530</a> of file <a class="el" href="PMsr2DataDialog_8cpp_source.html">PMsr2DataDialog.cpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="aa020e93e07cd0f76daff60a145a0f098" name="aa020e93e07cd0f76daff60a145a0f098"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#aa020e93e07cd0f76daff60a145a0f098">◆ </a></span>helpContent</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void PMsr2DataDialog::helpContent </td>
|
|
<td>(</td>
|
|
<td class="paramname"><span class="paramname"><em></em></span></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel slot">slot</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Opens online help for msr2data. </p>
|
|
<p>Opens online help documentation for msr2data.</p>
|
|
<p>Attempts to open the msr2data documentation in the default web browser. The documentation covers command-line options, template system usage, global fitting, and output formats.</p>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#a331e2a59fe899016db06223bf2262b00" title="Constructs the msr2data configuration dialog.">PMsr2DataDialog::PMsr2DataDialog()</a> Where helpUrl is initialized</dd></dl>
|
|
<p>Attempts to open the msr2data help URL in the user's default web browser using QDesktopServices::openUrl(). The documentation typically covers:</p>
|
|
<ul>
|
|
<li>Command-line syntax and options</li>
|
|
<li>Template system usage and requirements</li>
|
|
<li>Run list formats and specifications</li>
|
|
<li>Global and global+ fitting modes</li>
|
|
<li>Output file formats (database, column, YAML)</li>
|
|
<li>Parameter extraction and mapping</li>
|
|
<li>Chain fitting for sequential parameter passing</li>
|
|
<li>Batch processing best practices</li>
|
|
<li>Troubleshooting common issues</li>
|
|
</ul>
|
|
<p>Error handling:</p><ul>
|
|
<li>If fHelpUrl is empty: displays an information dialog with a placeholder message indicating future help availability</li>
|
|
<li>If the browser fails to open: displays a critical error dialog with the URL formatted as a clickable hyperlink for manual access</li>
|
|
</ul>
|
|
<p>The URL is parsed in TolerantMode to handle various URL formats flexibly.</p>
|
|
<dl class="section note"><dt>Note</dt><dd>This slot is connected to the help button click signal in the UI. </dd>
|
|
<dd>
|
|
The dialog remains open after help is displayed, allowing users to reference documentation while configuring parameters.</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#a331e2a59fe899016db06223bf2262b00" title="Constructs the msr2data configuration dialog.">PMsr2DataDialog::PMsr2DataDialog()</a> Where <a class="el" href="#ad1a9f830b1a1049f1b31c9d7e219ab91" title="URL to online msr2data documentation.">fHelpUrl</a> is initialized </dd>
|
|
<dd>
|
|
QDesktopServices::openUrl() For the browser opening mechanism </dd></dl>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="PMsr2DataDialog_8cpp_source.html#l00461">461</a> of file <a class="el" href="PMsr2DataDialog_8cpp_source.html">PMsr2DataDialog.cpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="adea6f6510f7c1ae8085d5ab4826e79d6" name="adea6f6510f7c1ae8085d5ab4826e79d6"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#adea6f6510f7c1ae8085d5ab4826e79d6">◆ </a></span>runListEntered</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void PMsr2DataDialog::runListEntered </td>
|
|
<td>(</td>
|
|
<td class="paramtype">const QString &</td> <td class="paramname"><span class="paramname"><em>str</em></span></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel slot">slot</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Handles run list text field activation. </p>
|
|
<p>Slot: Handles direct run list entry.</p>
|
|
<p>Called when the user enters text in the direct run list field. Clears the run list file name field to ensure only one input method is active, and sets the run tag to indicate direct list entry.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">str</td><td>The run list string (e.g., "123,125-130,145").</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#a0383e9e8f2ef4dc804936f26009b3dd8" title="Handles run list file name text field activation.">runListFileNameEntered()</a> For the alternative input method </dd>
|
|
<dd>
|
|
<a class="el" href="#a49d5e6caa1913be03be54c2a37cc7148" title="Returns the run input method tag.">getRunTag()</a> Returns the set run tag value</dd></dl>
|
|
<p>Called when the user enters text in the direct run list field. Ensures that only one run input method is active by clearing the run list file name field if it contains text. Sets the run tag to 0 to indicate direct list input mode.</p>
|
|
<p>The run list accepts various formats:</p><ul>
|
|
<li>Single runs: "123"</li>
|
|
<li>Multiple runs: "123,125,130"</li>
|
|
<li>Ranges: "123-130"</li>
|
|
<li>Combined: "123,125-130,145"</li>
|
|
</ul>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">str</td><td>The run list string entered by the user. Empty strings are ignored.</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section note"><dt>Note</dt><dd>This method enforces mutual exclusivity with <a class="el" href="#a0383e9e8f2ef4dc804936f26009b3dd8" title="Handles run list file name text field activation.">runListFileNameEntered()</a>. </dd>
|
|
<dd>
|
|
The run tag value can be retrieved via <a class="el" href="#a49d5e6caa1913be03be54c2a37cc7148" title="Returns the run input method tag.">getRunTag()</a> after dialog acceptance.</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#a0383e9e8f2ef4dc804936f26009b3dd8" title="Handles run list file name text field activation.">runListFileNameEntered()</a> Alternative run input method </dd>
|
|
<dd>
|
|
<a class="el" href="#a49d5e6caa1913be03be54c2a37cc7148" title="Returns the run input method tag.">getRunTag()</a> Returns the active input method indicator </dd></dl>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="PMsr2DataDialog_8cpp_source.html#l00276">276</a> of file <a class="el" href="PMsr2DataDialog_8cpp_source.html">PMsr2DataDialog.cpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a0383e9e8f2ef4dc804936f26009b3dd8" name="a0383e9e8f2ef4dc804936f26009b3dd8"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a0383e9e8f2ef4dc804936f26009b3dd8">◆ </a></span>runListFileNameEntered</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void PMsr2DataDialog::runListFileNameEntered </td>
|
|
<td>(</td>
|
|
<td class="paramtype">const QString &</td> <td class="paramname"><span class="paramname"><em>str</em></span></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel slot">slot</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Handles run list file name text field activation. </p>
|
|
<p>Slot: Handles run list file name entry.</p>
|
|
<p>Called when the user enters a file name containing run numbers. Clears the direct run list field to ensure only one input method is active, and sets the run tag to indicate file-based input.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">str</td><td>Path to the run list file.</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#adea6f6510f7c1ae8085d5ab4826e79d6" title="Handles run list text field activation.">runListEntered()</a> For the alternative input method </dd>
|
|
<dd>
|
|
<a class="el" href="#a49d5e6caa1913be03be54c2a37cc7148" title="Returns the run input method tag.">getRunTag()</a> Returns the set run tag value</dd></dl>
|
|
<p>Called when the user enters a file path in the run list file name field. Ensures that only one run input method is active by clearing the direct run list field if it contains text. Sets the run tag to 1 to indicate file-based input mode.</p>
|
|
<p>The run list file should contain run numbers in simple format:</p><ul>
|
|
<li>One run per line</li>
|
|
<li>Ranges allowed (e.g., "123-130")</li>
|
|
<li>Comments starting with '#'</li>
|
|
<li>Blank lines ignored</li>
|
|
</ul>
|
|
<p>Example run list file: </p><div class="fragment"><div class="line"><span class="preprocessor"># Temperature series</span></div>
|
|
<div class="line">123</div>
|
|
<div class="line">125-130</div>
|
|
<div class="line">145</div>
|
|
</div><!-- fragment --><dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">str</td><td>The file path entered by the user. Empty strings are ignored.</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section note"><dt>Note</dt><dd>This method enforces mutual exclusivity with <a class="el" href="#adea6f6510f7c1ae8085d5ab4826e79d6" title="Handles run list text field activation.">runListEntered()</a>. </dd>
|
|
<dd>
|
|
The file path is not validated by this method; validation occurs during msr2data execution. </dd>
|
|
<dd>
|
|
The run tag value can be retrieved via <a class="el" href="#a49d5e6caa1913be03be54c2a37cc7148" title="Returns the run input method tag.">getRunTag()</a> after dialog acceptance.</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#adea6f6510f7c1ae8085d5ab4826e79d6" title="Handles run list text field activation.">runListEntered()</a> Alternative run input method </dd>
|
|
<dd>
|
|
<a class="el" href="#a49d5e6caa1913be03be54c2a37cc7148" title="Returns the run input method tag.">getRunTag()</a> Returns the active input method indicator </dd></dl>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="PMsr2DataDialog_8cpp_source.html#l00320">320</a> of file <a class="el" href="PMsr2DataDialog_8cpp_source.html">PMsr2DataDialog.cpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a5b995ea405cf474127ddea895f30322f" name="a5b995ea405cf474127ddea895f30322f"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a5b995ea405cf474127ddea895f30322f">◆ </a></span>templateRunEntered</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void PMsr2DataDialog::templateRunEntered </td>
|
|
<td>(</td>
|
|
<td class="paramtype">const QString &</td> <td class="paramname"><span class="paramname"><em>str</em></span></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel slot">slot</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Handles template run number text field activation. </p>
|
|
<p>Slot: Handles template run number entry.</p>
|
|
<p>Called when the user enters a template run number. Automatically disables the "Fit Only" checkbox since a template implies msr file creation.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">str</td><td>The template run number string.</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section note"><dt>Note</dt><dd>Template run numbers must be valid integers representing existing msr files.</dd></dl>
|
|
<p>Called when the user enters a template run number. The template run specifies an existing msr file that will be used as a pattern for generating msr files for all runs in the run list.</p>
|
|
<p>Since providing a template implies the intent to create new msr files, this method automatically unchecks the "Fit Only" checkbox to ensure consistency. The fit-only mode assumes existing msr files and doesn't use templates.</p>
|
|
<p>The template run number must correspond to an existing, valid msr file. The template's structure (FITPARAMETER, THEORY, RUN blocks) will be preserved, with RUN block numbers updated for each processed run.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">str</td><td>The template run number string. Must be a valid integer. Non-empty values automatically disable fit-only mode.</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section note"><dt>Note</dt><dd>The integer validator ensures only numeric input is accepted. </dd>
|
|
<dd>
|
|
Empty string is allowed to clear the template (for fit-only mode).</dd></dl>
|
|
<dl class="section see"><dt>See also</dt><dd><a class="el" href="#a2eb5c9ab5967b77f15e8a23e35e0aad7" title="Handles "Fit Only" checkbox state changes.">fitOnlyChanged()</a> Complementary method that clears template when fit-only mode is enabled </dd></dl>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="PMsr2DataDialog_8cpp_source.html#l00356">356</a> of file <a class="el" href="PMsr2DataDialog_8cpp_source.html">PMsr2DataDialog.cpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<h2 class="groupheader">Member Data Documentation</h2>
|
|
<a id="ad1a9f830b1a1049f1b31c9d7e219ab91" name="ad1a9f830b1a1049f1b31c9d7e219ab91"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#ad1a9f830b1a1049f1b31c9d7e219ab91">◆ </a></span>fHelpUrl</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">QString PMsr2DataDialog::fHelpUrl</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel private">private</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>URL to online msr2data documentation. </p>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="PMsr2DataDialog_8h_source.html#l00272">272</a> of file <a class="el" href="PMsr2DataDialog_8h_source.html">PMsr2DataDialog.h</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a1d4e616868a2151b86555358a1e38e5b" name="a1d4e616868a2151b86555358a1e38e5b"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a1d4e616868a2151b86555358a1e38e5b">◆ </a></span>fMsr2DataParam</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="structPMsr2DataParam.html">PMsr2DataParam</a>* PMsr2DataDialog::fMsr2DataParam</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel private">private</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Pointer to parameter structure for msr2data configuration. </p>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="PMsr2DataDialog_8h_source.html#l00271">271</a> of file <a class="el" href="PMsr2DataDialog_8h_source.html">PMsr2DataDialog.h</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a69c0c714d167571710d9d222e04dcb49" name="a69c0c714d167571710d9d222e04dcb49"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a69c0c714d167571710d9d222e04dcb49">◆ </a></span>fRunTag</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">int PMsr2DataDialog::fRunTag</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel private">private</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Run input method: -1=invalid, 0=direct list, 1=file name. </p>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="PMsr2DataDialog_8h_source.html#l00270">270</a> of file <a class="el" href="PMsr2DataDialog_8h_source.html">PMsr2DataDialog.h</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<hr/>The documentation for this class was generated from the following files:<ul>
|
|
<li>/workspace/LMU/musrfit/src/musredit_qt6/musredit/<a class="el" href="PMsr2DataDialog_8h_source.html">PMsr2DataDialog.h</a></li>
|
|
<li>/workspace/LMU/musrfit/src/musredit_qt6/musredit/<a class="el" href="PMsr2DataDialog_8cpp_source.html">PMsr2DataDialog.cpp</a></li>
|
|
</ul>
|
|
</div><!-- contents -->
|
|
<!-- start footer part -->
|
|
<hr class="footer"/><address class="footer"><small>
|
|
Generated by <a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.13.2
|
|
</small></address>
|
|
</div><!-- doc-content -->
|
|
</body>
|
|
</html>
|