Dataset Open Access

Modulation Module for HelMod-4

Boschini, M.J.; Della Torre, S.; Gervasi, M.; La Vacca, G.; Rancoita, P.G.

Citation Style Language JSON Export

  "DOI": "10.15161/", 
  "abstract": "<p>The SDE integration with HelMod results in a quite expensive effort from the computational point of view since,&nbsp;to minimize the uncertainties, a huge amount of events should be integrated from Earth to the heliosphere boundary.&nbsp;Monte Carlo integration allows us to evaluate the normalized probability function (G) that a particle observed at Earth with rigidity R0 entered into the heliosphere with rigidity R. The convolution of the normalized probability function with the very local interstellar spectra result in the modulation of differential intensity for the time and solar distance where G was evaluated. In the present dataset, we provide the numerical output of&nbsp;HelMod-4 model ( in the form of&nbsp;normalized probability histograms. The python script attached is able to convert GALPROP output (or plain text LIS file) to modulated spectrum for periods of selected experiments.</p>\n\n<p>This dataset was used as part of the publications in the references.</p>\n\n<p>For any information about the HelMod-4 Model, please refer to the official <a href=\"\">website</a>.</p>\n\n<p><strong>How to install and configure&nbsp;</strong></p>\n\n<p>Install python (&gt;3.0) packages</p>\n\n<ul>\n\t<li><a href=\"\">astropy</a></li>\n\t<li><a href=\"\">scypy</a> &gt;=0.17.0</li>\n\t<li><a href=\"\">numpy</a> &gt;=1.10</li>\n\t<li><a href=\"\">matplotlib</a></li>\n</ul>\n\n<p>Download the&nbsp;Python OfflineModule and the HelModArchive. The archive is provided in tgz format, thus it needs to be first unpacked with the command <code>tar -xvzf &lt;ArchiveName&gt;.tgz</code>.&nbsp;</p>\n\n<p>The archive&nbsp;structure:</p>\n\n<p>The HelModArchives.tgz contains several directories each one with the name of a space or balloon mission. Each folder should be considered as an&nbsp;HelMod Archive containing the following files:</p>\n\n<ul>\n\t<li><em>ExpList.list </em>: List of nuclei and isotopes simulated (to not modify)</li>\n\t<li><em>ExpList_Plot.list</em>:&nbsp;List of nuclei available in the archive, reference and plots properties (do not modify first and second columns, the others can be updated to modify the output plots)</li>\n\t<li><em>ParameterSimulated.list</em>: list of folders in the form RawPar_HelMod4_XX,&nbsp; (<em>at least one line should start with &#39;+&#39;, if not, please add it to first line</em>)</li>\n\t<li><em>ParameterSimulated_DB.list</em>:&nbsp;list of folders in the form RawPar_HelMod4_XX, with description</li>\n\t<li><em>Version.txt </em>: Version notes</li>\n\t<li><em>DataTXT</em> : experimental energy and rigidity binning used for simulations</li>\n\t<li><em>RawPar_HelMod4_00</em> : HelMod simulations outputs</li>\n</ul>\n\n<p><strong>How to use the module</strong>:</p>\n\n<p>The usage of the module requires three elements:</p>\n\n<ul>\n\t<li>An Helmod Archive unpacked in some known folder. E.g. let&#39;s &lt;ArcPath&gt;=/home/test/Archive1</li>\n\t<li>A <a href=\"\">LIS</a> from galprop fits file OR plain text file format (hereafter called <code>&lt;LIS_FILE&gt;</code>).&nbsp;</li>\n\t<li>The label of the ion/dataset (hereafter called <code>&lt;ExpNameKey&gt;</code>) that are intended to be modulated.</li>\n</ul>\n\n<p>The list of available&nbsp;<code>&lt;ExpNameKey&gt;</code>&nbsp; in each archive may be found in the file&nbsp;ExpList_Plot.list&nbsp;or using the command-line&nbsp;</p>\n\n<pre><code class=\"language-bash\">python3 -a &lt;ArcPath&gt; -l</code></pre>\n\n<p>The basic command to get the modulated spectrum is:</p>\n\n<pre><code class=\"language-bash\">python3 -a &lt;ArcPath&gt; --LIS &lt;LIS_FILE&gt; --SimName &lt;ExpNameKey&gt;</code></pre>\n\n<p>other available options:</p>\n\n<ul>\n\t<li><code><em>-h</em>&nbsp;</code>help description</li>\n\t<li><em><code>-t</code></em>&nbsp;use this option to specify that &lt;LIS_FILE&gt; is a two-column plain text file (see below).</li>\n\t<li><code><em>-p &lt;PAR_SET_NAME&gt;</em>&nbsp;&nbsp;</code>Choose a different set of parameters. The list of available parameter set names is available in the file <em>ParameterSimulated_DB.list .</em></li>\n\t<li><em><code>--MakePlot</code>Create</em> a Plot in png format.</li>\n\t<li><code><em>--SumAllIsotpes</em>&nbsp;</code>(can be used with GALPROP LIS inputs) evaluate the modulated spectra as the sum of the modulated isotopes spectra (note that without this option only the LIS of the isotope specified in &lt;ExpNameKey&gt;&nbsp;is considered by the script).&nbsp;</li>\n\t<li><code><em>--PrintLIS</em>&nbsp; </code>Create a file with the&nbsp;LIS in the format of a two-column plain text file.</li>\n\t<li><code><em>--SimUnit &lt;Tkin/Rigi&gt;</em>&nbsp;</code>force the Output Unit of the module: use <em>Tkin</em> to select&nbsp;Kinetic Energy per Nucleon [GeV/n], use&nbsp;<em>Rigi</em>&nbsp;to select Rigidity [GV].&nbsp;If not specified,&nbsp;the output is chosen accordingly to the original format of the experimental dataset.</li>\n\t<li><em><code>-</code></em><code><em>o &lt;FILE_NAME&gt;</em>&nbsp;</code>Use a custom name for the output file.</li>\n</ul>\n\n<p><strong>LIS in text format</strong></p>\n\n<p>Users can provide a txt file for LIS with the following characteristics:</p>\n\n<ul>\n\t<li>The file must be a text file.</li>\n\t<li>The file must contain two columns only:\n\t<ol>\n\t\t<li>one for kinetic energy per nucleon [GeV]</li>\n\t\t<li>the second for the LIS flux [ (m<sup>2</sup>&nbsp;s sr GeV)<sup>-1</sup>].</li>\n\t</ol>\n\t</li>\n\t<li>The file may contain&nbsp;comments. Line starting with &#39;#&#39; character will be ignored.</li>\n</ul>", 
  "author": [
      "family": "Boschini, M.J."
      "family": "Della Torre, S."
      "family": "Gervasi, M."
      "family": "La Vacca, G."
      "family": "Rancoita, P.G."
  "id": "75359", 
  "issued": {
    "date-parts": [
  "language": "eng", 
  "title": "Modulation Module for HelMod-4", 
  "type": "dataset", 
  "version": "4.3"
All versions This version
Views 113110
Downloads 1414
Data volume 10.5 GB10.5 GB
Unique views 9694
Unique downloads 99


Cite as