Skip to content

Commit

Permalink
Deploying to gh-pages from @ 31d0b2c 🚀
Browse files Browse the repository at this point in the history
  • Loading branch information
olantwin committed Jul 11, 2024
1 parent d5a888b commit 9b551e4
Show file tree
Hide file tree
Showing 7 changed files with 110 additions and 105 deletions.
55 changes: 30 additions & 25 deletions md_README.html
Original file line number Diff line number Diff line change
Expand Up @@ -93,11 +93,19 @@
</ul>
</li>
<li><a href="#build-instructions">Build instructions</a><ul>
<li><a href="#introduction-to-alibuild">Introduction to <code>aliBuild</code></a></li>
<li><a href="#on-lxplus-or-systems-with-cvmfs">On lxplus or systems with CVMFS</a></li>
<li><a href="#on-systems-without-access-to-cvmfs">On systems without access to CVMFS</a></li>
</ul>
</li>
<li><a href="#run-instructions">Run Instructions</a></li>
<li><a href="#run-instructions">Run instructions</a><ul>
<li><a href="#use-cases-covered-by-run_simsndpy">Use cases covered by <code>run_simSND.py</code></a></li>
<li><a href="#digitization-of-mc-data">Digitization of MC data</a></li>
<li><a href="#converting-raw-data-to-sndsw-format">Converting raw data to sndsw format</a></li>
<li><a href="#example-scripts-for-accessing-the-raw-data-and-making-histograms">Example scripts for accessing the raw data and making histograms</a></li>
<li><a href="#simple-2d-event-display-with-scifi-tracking">simple 2d event display with Scifi tracking</a></li>
</ul>
</li>
<li><a href="#development">Development</a><ul>
<li><a href="#how-to-keep-branches-up-to-date">How to keep branches up to date</a></li>
<li><a href="#how-to-contribute-code">How to contribute code</a></li>
Expand All @@ -123,8 +131,8 @@ <h2><a class="anchor" id="autotoc_md23"></a>
<h1><a class="anchor" id="autotoc_md24"></a>
Build instructions</h1>
<p>The <code>aliBuild</code> family of tools developed by ALICE is used to set up <code>sndsw</code> and its dependencies.</p>
<h3><a class="anchor" id="autotoc_md25"></a>
Introduction to &lt;tt&gt;aliBuild&lt;/tt&gt;</h3>
<h2><a class="anchor" id="autotoc_md25"></a>
Introduction to &lt;tt&gt;aliBuild&lt;/tt&gt;</h2>
<p>The basic commands are the same regardless of whether CVMFS is used:</p>
<dl>
<dt><code>aliBuild build &lt;package-name&gt; -c snddist</code> </dt>
Expand All @@ -151,8 +159,6 @@ <h2><a class="anchor" id="autotoc_md26"></a>
<p>However, this won't work if you are using HTCondor. In such case you can do:</p>
<div class="fragment"><div class="line">eval $(alienv load sndsw/latest --no-refresh)</div>
</div><!-- fragment --><p>If you modify <code>sndsw</code>, simply repeat step 4 from <code>sndsw</code>'s parent directory.</p>
<p>Note for Ubuntu 20.04: currently there is a version (March 2022) of CVMFS built with Ubuntu 20.04. However, standard ubuntu 20.04 still have python2 has default, while we moved to python3. So, it is needed to do </p><div class="fragment"><div class="line">sudo apt-get install python-is-python3</div>
</div><!-- fragment --><p>Then, the above procedure works </p>
<h2><a class="anchor" id="autotoc_md27"></a>
On systems without access to CVMFS</h2>
<p>Commands are similar to the previous case, but without access to CVMFS you need to build the required packages from source.</p>
Expand All @@ -164,46 +170,45 @@ <h2><a class="anchor" id="autotoc_md27"></a>
<li>Load the environment ```bash alienv enter sndsw/latest ```</li>
</ol>
<h1><a class="anchor" id="autotoc_md28"></a>
Run Instructions</h1>
<p>updated 11 October 2021 for the use with raw data</p>
Run instructions</h1>
<p>Set up the bulk of the environment from CVMFS.</p>
<div class="fragment"><div class="line">source /cvmfs/sndlhc.cern.ch/latest/setUp.sh </div>
<div class="fragment"><div class="line">source /cvmfs/sndlhc.cern.ch/SNDLHC-2024/June25/setUp.sh</div>
</div><!-- fragment --><p>Load your local sndsw environment.</p>
<div class="fragment"><div class="line">alienv enter (--shellrc) sndsw/latest </div>
<div class="fragment"><div class="line">alienv enter (--shellrc) sndsw/latest</div>
</div><!-- fragment --><div class="fragment"><div class="line">python $SNDSW_ROOT/shipLHC/run_simSND.py --Ntuple -n 100 -f /eos/experiment/sndlhc/MonteCarlo/FLUKA/muons_up/version1/unit30_Nm.root --eMin 1.0</div>
<div class="line">&gt;&gt; Macro finished succesfully. </div>
<div class="line">&gt;&gt; Macro finished succesfully.</div>
</div><!-- fragment --> <blockquote class="doxtable">
<blockquote class="doxtable">
<p>Output files are sndLHC.Ntuple-TGeant4.root (events) and geofile_full.Ntuple-TGeant4.root (setup) </p>
</blockquote>
</blockquote>
<p>Run the event display:</p>
<div class="fragment"><div class="line">python -i $SNDSW_ROOT/macro/eventDisplay.py -f sndLHC.Ntuple-TGeant4.root -g geofile_full.Ntuple-TGeant4.root </div>
<div class="line">// use SHiP Event Display GUI </div>
<div class="line">Use quit() or Ctrl-D (i.e. EOF) to exit </div>
<div class="fragment"><div class="line">python -i $SNDSW_ROOT/macro/eventDisplay.py -f sndLHC.Ntuple-TGeant4.root -g geofile_full.Ntuple-TGeant4.root</div>
<div class="line">// use SHiP Event Display GUI</div>
<div class="line">Use quit() or Ctrl-D (i.e. EOF) to exit</div>
</div><!-- fragment --><p> a) Use the GUI to display events: SHiP actions / next event</p>
<p>b) Hoovering over trajectory will display additional information :</p>
<p>c) At python prompt: <a class="el" href="namespacedecorators.html#a3c7af73e472ea77e011ed0d4520bbbab">sTree.MCTrack.Dump()</a> will display info about all MC particles</p>
<p>b) Hovering over trajectory will display additional information :</p>
<p>c) At python prompt: <code><a class="el" href="namespacedecorators.html#a3c7af73e472ea77e011ed0d4520bbbab">sTree.MCTrack.Dump()</a></code> will display info about all MC particles</p>
<h2><a class="anchor" id="autotoc_md29"></a>
Use cases covered by &lt;tt&gt;run_simSND.py&lt;/tt&gt;:</h2>
Use cases covered by &lt;tt&gt;run_simSND.py&lt;/tt&gt;</h2>
<ol type="1">
<li>Transport muons, output of FLUKA simulation, to TI18 and the detector. Positive and negative muons, up and down crossing angles, exist. Possible options are setting minimum energy for transporting particles, transport only muons, increase EM cross sections of muons.</li>
</ol>
<div class="fragment"><div class="line">python $SNDSW_ROOT/shipLHC/run_simSND.py --Ntuple -n nEvents -f /eos/experiment/sndlhc/MonteCarlo/FLUKA/muons_up/version1/unit30_Nm.root --eMin ecut</div>
</div><!-- fragment --><ol type="1">
<li>Muon deep inelastic scattering events, produced with pythia6, and then positioned in T18 and transported by Geant4: <div class="fragment"><div class="line">python $SNDSW_ROOT/shipLHC/run_simSND.py -F --MuDIS -n nEvents -f /eos/experiment/sndlhc/MonteCarlo/Pythia6/MuonDIS/muonDis_1001.root --eMin ecut</div>
<li>Muon deep inelastic scattering events, produced with pythia6, and then positioned in TI18 and transported by Geant4: <div class="fragment"><div class="line">python $SNDSW_ROOT/shipLHC/run_simSND.py -F --MuDIS -n nEvents -f /eos/experiment/sndlhc/MonteCarlo/Pythia6/MuonDIS/muonDis_1001.root --eMin ecut</div>
</div><!-- fragment --></li>
<li>WORK ONGOING: Neutrino events, produced by GENIE, <a class="el" href="makeSNDGenieEvents_8py.html">sndsw/macro/makeSNDGenieEvents.py</a>, and then positioned in T18 and transported by Geant4: <div class="fragment"><div class="line">python $SNDSW_ROOT/shipLHC/run_simSND.py --Genie -n nEvents -f ...</div>
<li>Neutrino events, produced by GENIE and then positioned in TI18 and transported by Geant4: <div class="fragment"><div class="line">python $SNDSW_ROOT/shipLHC/run_simSND.py --Genie -n nEvents -f ...</div>
</div><!-- fragment --></li>
</ol>
<h2><a class="anchor" id="autotoc_md30"></a>
Digitization of MC data:</h2>
Digitization of MC data</h2>
<ol type="1">
<li>Convert MC points to detector hits. Input required, data from simulation together with the geometry file created when running simulation. New objects created are <code>Digi_ScifiHits</code> together with <code>Cluster_Scifi</code> and <code>Digi_MuFilterHit</code>, and in parallel objects to make the link to the original MC points, <code>Digi_MuFilterHits2MCPoints</code> and <code>Digi_ScifiHits2MCPoints</code>.</li>
</ol>
<div class="fragment"><div class="line">python $SNDSW_ROOT/shipLHC/run_digiSND.py -f sndLHC.Ntuple-TGeant4.root -g geofile_full.Ntuple-TGeant4.root</div>
</div><!-- fragment --><h2><a class="anchor" id="autotoc_md31"></a>
Converting raw data to sndsw format:</h2>
Converting raw data to sndsw format</h2>
<ol type="1">
<li>Runs the calibration procedure and creates <code>Digi_ScifiHits</code> and <code>Digi_MuFilterHit</code> with signal and time information from SiPM channels.</li>
</ol>
Expand All @@ -213,17 +218,17 @@ <h2><a class="anchor" id="autotoc_md30"></a>
</ol>
<div class="fragment"><div class="line">python $SNDSW_ROOT/shipLHC/rawData/convertRawData_convertRawData_muTestbeam.py -p /eos/experiment/sndlhc/testbeam/MuFilter/TB_data_commissioning/ -n 5000000 -r 91</div>
</div><!-- fragment --> <h2><a class="anchor" id="autotoc_md32"></a>
Example scripts for accessing the raw data and making histograms:</h2>
Example scripts for accessing the raw data and making histograms</h2>
<ol type="1">
<li>For scifi data: <div class="fragment"><div class="line">python $SNDSW_ROOT/shipLHC/rawData/scifiHitMaps.py -p /eos/experiment/sndlhc/testbeam/scifi/sndsw/ -r 1 -g geofile_full.Ntuple-TGeant4.root </div>
<li>For scifi data: <div class="fragment"><div class="line">python $SNDSW_ROOT/shipLHC/rawData/scifiHitMaps.py -p /eos/experiment/sndlhc/testbeam/scifi/sndsw/ -r 1 -g geofile_full.Ntuple-TGeant4.root</div>
</div><!-- fragment --></li>
<li>For MuFi data: <div class="fragment"><div class="line">python $SNDSW_ROOT/shipLHC/rawData/mufiHitMaps.py -p /eos/experiment/sndlhc/testbeam/MuFilter/TB_data_commissioning/sndsw/ -r 90 -g geofile_full.Ntuple-TGeant4.root </div>
<li>For MuFi data: <div class="fragment"><div class="line">python $SNDSW_ROOT/shipLHC/rawData/mufiHitMaps.py -p /eos/experiment/sndlhc/testbeam/MuFilter/TB_data_commissioning/sndsw/ -r 90 -g geofile_full.Ntuple-TGeant4.root</div>
</div><!-- fragment --> Two methods implemented, hitMaps(Nev = -1) and <a class="el" href="namespacemufiHitMaps.html#aaf61f493002a3f19a5e9384eac1c257e">eventTime()</a>.</li>
</ol>
<h2><a class="anchor" id="autotoc_md33"></a>
simple 2d event display with Scifi tracking:</h2>
simple 2d event display with Scifi tracking</h2>
<ol type="1">
<li>Use method loopEvents(start=0,save=False,goodEvents=False,withTrack=False) <div class="fragment"><div class="line">python $SNDSW_ROOT/shipLHC/scripts/scifiHitMaps.py -p /eos/experiment/sndlhc/testbeam/scifi/sndsw/ -r 1 -g geofile_full.Ntuple-TGeant4.root </div>
<li>Use method loopEvents(start=0,save=False,goodEvents=False,withTrack=False) <div class="fragment"><div class="line">python $SNDSW_ROOT/shipLHC/scripts/scifiHitMaps.py -p /eos/experiment/sndlhc/testbeam/scifi/sndsw/ -r 1 -g geofile_full.Ntuple-TGeant4.root</div>
</div><!-- fragment --></li>
</ol>
<h1><a class="anchor" id="autotoc_md34"></a>
Expand Down
1 change: 0 additions & 1 deletion namespaces_dup.js
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,6 @@ var namespaces_dup =
[ "How to generate test database", "md_conditionsDatabase_tests_test_mongodb_README.html#autotoc_md17", null ],
[ "How to execute PyTest", "md_conditionsDatabase_tests_test_mongodb_README.html#autotoc_md18", null ],
[ "How to see test coverage", "md_conditionsDatabase_tests_test_mongodb_README.html#autotoc_md19", null ],
[ "Introduction to <tt>aliBuild</tt>", "md_README.html#autotoc_md25", null ],
[ "addTrack", "namespace2dEventDisplay.html#ab6b45944390fff2b18238394c71d7f4e", null ],
[ "bunchXtype", "namespace2dEventDisplay.html#aca4f4496412086aeb86fa83f9592b87d", null ],
[ "checkOtherTriggers", "namespace2dEventDisplay.html#a32e01f83d697927d64ab3adaeff93f51", null ],
Expand Down
13 changes: 7 additions & 6 deletions navtreedata.js
Original file line number Diff line number Diff line change
Expand Up @@ -54,15 +54,16 @@ var NAVTREE =
[ "Branches", "md_README.html#autotoc_md23", null ]
] ],
[ "Build instructions", "md_README.html#autotoc_md24", [
[ "Introduction to <tt>aliBuild</tt>", "md_README.html#autotoc_md25", null ],
[ "On lxplus or systems with CVMFS", "md_README.html#autotoc_md26", null ],
[ "On systems without access to CVMFS", "md_README.html#autotoc_md27", null ]
] ],
[ "Run Instructions", "md_README.html#autotoc_md28", [
[ "Use cases covered by <tt>run_simSND.py</tt>:", "md_README.html#autotoc_md29", null ],
[ "Digitization of MC data:", "md_README.html#autotoc_md30", null ],
[ "Converting raw data to sndsw format:", "md_README.html#autotoc_md31", null ],
[ "Example scripts for accessing the raw data and making histograms:", "md_README.html#autotoc_md32", null ],
[ "simple 2d event display with Scifi tracking:", "md_README.html#autotoc_md33", null ]
[ "Run instructions", "md_README.html#autotoc_md28", [
[ "Use cases covered by <tt>run_simSND.py</tt>", "md_README.html#autotoc_md29", null ],
[ "Digitization of MC data", "md_README.html#autotoc_md30", null ],
[ "Converting raw data to sndsw format", "md_README.html#autotoc_md31", null ],
[ "Example scripts for accessing the raw data and making histograms", "md_README.html#autotoc_md32", null ],
[ "simple 2d event display with Scifi tracking", "md_README.html#autotoc_md33", null ]
] ],
[ "Development", "md_README.html#autotoc_md34", [
[ "How to keep branches up to date", "md_README.html#autotoc_md35", null ],
Expand Down
2 changes: 1 addition & 1 deletion navtreeindex50.js
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
var NAVTREEINDEX50 =
{
"group__genfit.html":[10,0],
"group__genfit.html#ga43fd55aa78bd891ebbd6a450f5eecce4":[10,0,0],
"group__genfit.html#ga43fd55aa78bd891ebbd6a450f5eecce4":[10,0,1],
"group__genfit.html#ga43fd55aa78bd891ebbd6a450f5eecce4":[13,0,5,0,0,9,2],
"group__genfit.html#ga43fd55aa78bd891ebbd6a450f5eecce4":[13,0,5,7,0,2,2],
"group__genfit.html#ga43fd55aa78bd891ebbd6a450f5eecce4":[10,0,0],
"group__utilities.html":[10,4],
"hcalAnalysisSimple_8cxx.html":[13,0,7,2],
"hcalAnalysisSimple_8cxx_source.html":[13,0,7,2],
Expand Down
6 changes: 3 additions & 3 deletions navtreeindex52.js
Original file line number Diff line number Diff line change
Expand Up @@ -138,9 +138,9 @@ var NAVTREEINDEX52 =
"md_README.html#autotoc_md22":[9,0,0],
"md_README.html#autotoc_md23":[9,0,1],
"md_README.html#autotoc_md24":[9,1],
"md_README.html#autotoc_md25":[3],
"md_README.html#autotoc_md26":[9,1,0],
"md_README.html#autotoc_md27":[9,1,1],
"md_README.html#autotoc_md25":[9,1,0],
"md_README.html#autotoc_md26":[9,1,1],
"md_README.html#autotoc_md27":[9,1,2],
"md_README.html#autotoc_md28":[9,2],
"md_README.html#autotoc_md29":[9,2,0],
"md_README.html#autotoc_md30":[9,2,1],
Expand Down
Loading

0 comments on commit 9b551e4

Please sign in to comment.