Index: /snovis/head/doc/snovis.html
===================================================================
--- /snovis/head/doc/snovis.html	(revision 7)
+++ /snovis/head/doc/snovis.html	(revision 7)
@@ -0,0 +1,2656 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="fr-fr">
+<head>
+
+
+
+
+
+  
+  
+  
+  
+  
+  <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type">
+
+
+
+
+
+  
+  
+  
+  
+  
+  
+  
+  
+  
+  
+  <title>MEMPHYS Software</title>
+  <meta content="J-E Campagne " name="author">
+</head>
+
+<body>
+
+
+
+
+
+<h1 style="text-align: center; color: rgb(0, 0, 153);"><a class="mozTocH1" name="mozTocId909942"></a>Install and run MEMPHYS software&nbsp;</h1>
+
+
+
+
+
+<h1 style="text-align: center; color: rgb(0, 0, 153);">and the associate toolkits</h1>
+
+
+
+
+
+<hr style="width: 100%; height: 2px;">
+<h2 style="color: rgb(51, 102, 255);"><a class="mozTocH2" name="mozTocId102030"></a><span style="color: rgb(51, 51, 255);">Table of Contents</span></h2>
+
+
+
+
+
+<ul id="mozToc">
+
+
+
+
+<!--mozToc h2 2 h3 3 h4 4 h5 5 h6 6--><li><a href="#mozTocId102030">Table of Contents</a>
+    
+    
+    
+    
+    <ul>
+
+
+
+
+      <li><a href="#mozTocId791206">What the user have to know?</a></li>
+
+
+
+
+      <li><a href="#mozTocId474404">Installation of the Plug-ins and the MEMPHYS package&nbsp;</a>
+        
+        
+        
+        
+        <ul>
+
+
+
+
+          <li><a href="#mozTocId129835">The OpenScientist toolkit</a></li>
+
+
+
+
+          <li><a href="#mozTocId109209">The MEMPHYS package</a></li>
+
+
+
+
+        
+        
+        
+        
+        </ul>
+
+
+
+
+      </li>
+
+
+
+
+      <li><a href="#mozTocId3450">Simple runs</a>
+        
+        
+        
+        
+        <ul>
+
+
+
+
+          <li><a href="#mozTocId327975">Interactive session</a></li>
+
+
+
+
+          <li><a href="#mozTocId967005">Batch mode</a></li>
+
+
+
+
+        
+        
+        
+        
+        </ul>
+
+
+
+
+      </li>
+
+
+
+
+    
+    
+    
+    
+    </ul>
+
+
+
+
+  </li>
+
+
+
+
+</ul>
+
+
+
+
+
+<h2 style="color: rgb(51, 51, 255);"><a class="mozTocH2" name="mozTocId791206"></a>What the user have to know?</h2>
+
+
+
+
+
+The user is supposed to know how to practice more or less: <br>
+
+
+
+
+
+<ul>
+
+
+
+
+
+  <li>the Linux OS or the MacOSX <span style="color: rgb(255, 0, 0);">(Ceci est un changement de JEC et de GB)</span>, <span style="color: rgb(51, 204, 0);">(Nouveau changement</span></li>
+
+
+
+
+
+  <li>the <a href="http://www.cmtsite.org/">CMT</a> code management tool,</li>
+
+
+
+
+
+  <li>the <a href="http://svnbook.red-bean.com/en/1.0/index.html">SVN</a> the code version repository management tool (this is an alternative to the more usual CVS tool),</li>
+
+
+
+
+
+  <li>the <a href="http://www.cs.uregina.ca/Dept/manuals/Manuals/7Language/7_18C++/c++.htm">C++</a> language,</li>
+
+
+
+
+
+  <li>the <a href="http://geant4.web.cern.ch/geant4/">Geant 4</a> simulation tool,&nbsp;</li>
+
+
+
+
+
+  <li>the&nbsp;<a href="http://openscientist.lal.in2p3.fr/">OpenScientist</a> toolkit especially have a look at the <a href="http://aida.freehep.org">AIDA</a>
+abstract interface for the tuple creation and, also some practice of
+the OpenScientist visualisation to run the MEMPHYS_session executable</li>
+
+
+
+
+
+  <li>the <a href="http://root.cern.ch/">ROOT</a> toolkit if one wants to make analysis/ploting using this package.</li>
+
+
+
+
+
+</ul>
+
+
+
+
+
+<h2 style="color: rgb(51, 51, 255);"><a class="mozTocH2" name="mozTocId474404"></a>Installation of the Plug-ins and the MEMPHYS package&nbsp;</h2>
+
+
+
+
+
+<div style="text-align: justify;">It is supposed that the SVN, CMT (at
+least version v1r18), ROOT (at least version 4) tools are available
+under the plateform used hereafter. For definitiveness it is
+explicitely shown the commands to be executed under the UNIX/csh shell.
+Usually the toolkits are also providing UNIX/sh shell command file. The
+Mac XXX will be documented later. </div>
+
+
+
+
+
+<h3><a class="mozTocH3" name="mozTocId129835"></a>The OpenScientist toolkit</h3>
+
+
+
+
+
+If the user is running under Linux SL3 with the compiler gcc- 3.2.3, the&nbsp;&nbsp;<a href="http://openscientist.lal.in2p3.fr/">OpenScientist</a> v16r0 toolkit binariies may directly downlaoded <a href="http://openscientist.lal.in2p3.fr/download/v16r0/">here</a>. The <a href="http://proj-clhep.web.cern.ch/proj-clhep/">CLHEP</a> 2.0.3.1 and&nbsp;<a href="http://geant4.web.cern.ch/geant4/">Geant 4</a>
+8.2 version are part of the toolkit and includes all the include files,
+the libraries and the binnaries necessary for the development of the
+MEMPHYS code or similar codes.<br>
+
+
+
+
+
+<br>
+
+
+
+
+
+<a name="OpenScientistInstall"></a>So, the user proceeds as followed (UNIX):<br>
+
+
+
+
+
+<ol>
+
+
+
+
+
+  <li>download the zip file</li>
+
+
+
+
+
+  <li>unzip on a <span style="font-style: italic;">kits</span> area (see the <a href="#CMTIandKits">Kits &amp; CMT hierarchy</a>) that may be different of his/her <span style="font-style: italic;">work</span> area</li>
+
+
+
+
+
+  <li>cd OpenScientist/v16r0</li>
+
+
+
+
+
+  <li>chmod &nbsp;a+x install</li>
+
+
+
+
+
+  <li>./install</li>
+
+
+
+
+
+</ol>
+
+
+
+
+
+To use the toolkit in stand alone mode or to see if the installation
+was fine, first of all setup the environment by sourcing:
+&nbsp;&nbsp;&nbsp; <br>
+
+
+
+
+
+&nbsp;csh&gt; source &lt;path&gt;/OpenScientist/v16r0/aida-setup.csh<br>
+
+
+
+
+
+(&nbsp; sh&gt; . &lt;path&gt;/OpenScientist/v16r0/aida-setup.sh )<br>
+
+
+
+
+
+&nbsp;Then, for instance one may experience the&nbsp; ploting capability :
+<ul>
+
+
+
+
+
+  <li>UNIX&gt;&nbsp; aida-config</li>
+
+
+
+
+
+  <li>UNIX&gt; onxlab</li>
+
+
+
+
+
+</ul>
+
+
+
+
+
+The user may see the famous gaussian distribution and the associate fit....<br>
+
+
+
+
+
+<div style="text-align: center;"><img style="width: 858px; height: 734px;" alt="Image" src="Images/onxlab.jpg">
+
+
+
+
+</div>
+
+
+
+
+
+<br>
+
+
+
+
+
+Also, the user may play with&nbsp;Geant4 interactively and show the
+event display. Have a look at the novice examples or a simpler example
+as followed: <br>
+
+
+
+
+
+<ul>
+
+
+
+
+
+  <li>&nbsp;UNIX&gt; G4Simple_session</li>
+
+
+
+
+
+  <li>In the Geant 4 menu, starts with "Init" and then "Run", some tracks will appear when the number of events are validated</li>
+
+
+
+
+
+  <li>To show the geometry: follow the "Physical Volumes" in the "Tree
+actions" and clik on the different directories and leaves. One may see
+the following figure:</li>
+
+
+
+
+
+</ul>
+
+
+
+
+
+<div style="text-align: center;"><img style="width: 858px; height: 734px;" alt="Image" src="Images/G4Simple.jpg">
+
+
+
+
+</div>
+
+
+
+
+
+<h3><a class="mozTocH3" name="mozTocId109209"></a>The MEMPHYS package</h3>
+
+
+
+
+
+To install the MEMPHYS package, one may adopt a directory hierarchy as followed (UNIX):<br>
+
+
+
+
+
+<ul>
+
+
+
+
+
+  <li>define at the&nbsp;login phase the <a name="CMTPROJECTPATH"></a>CMTPROJECTPATH environment variable:&nbsp;</li>
+
+
+
+
+
+</ul>
+
+
+
+
+
+<table style="width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td style="background-color: rgb(204, 204, 204);">setenv CMTPROJECTPATH "&lt;common-area-path&gt;/kits:&lt;personal-area&gt;"</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+<ul>
+
+
+
+
+
+  <li><a name="CMTIandKits"></a>create if not already done the <span style="color: rgb(255, 0, 0);">&lt;common-area-path&gt;/kits</span> area for the OpenScientist toolkit as described <a href="#OpenScientistInstall">above</a>, but also the ROOT toolkit, CMT tool ...</li>
+
+
+
+
+
+  <li>create the <span style="color: rgb(255, 0, 0);">&lt;common-area-path&gt;/CMTI/ <span style="color: rgb(0, 0, 0);">area</span></span>:&nbsp;
+    <ul>
+
+
+
+
+
+    <li>create a <span style="color: rgb(255, 0, 0);"><a name="cmtproject.cmt-1"></a>/cmt/project.cmt</span> file with the simple ligne</li>
+
+
+
+
+
+  
+  
+  
+  
+  
+    </ul>
+  </li>
+
+
+
+
+
+  
+  
+  
+  
+  
+
+
+
+
+</ul>
+
+
+
+
+
+<table style="background-color: rgb(192, 192, 192); width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td>project CMTI</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+<ul>
+
+
+
+
+
+  
+  
+  
+  
+  
+  <ul>
+
+
+
+
+
+    <li><a name="to_install_the_OpenScientist-CMT_"></a>to install the OpenScientist-CMT&nbsp; Interfaces for OpenScientist toolkit and the ROOT toolkit</li>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </ul>
+
+
+
+
+
+  
+  
+  
+  
+  
+  <ul>
+
+
+
+
+
+    
+    
+    
+    
+    
+    <ul>
+
+
+
+
+
+      <li>download the Interfaces here (<span style="color: rgb(255, 0, 0); font-weight: bold;">TBD</span>)&nbsp;</li>
+
+
+
+
+
+    
+    
+    
+    
+    
+    </ul>
+
+
+
+
+
+    
+    
+    
+    
+    
+    <ul>
+
+
+
+
+
+      <li>edit the <span style="color: rgb(255, 0, 0);">OpenScientist/v16r0/cmt/requirement</span> file and change the OSC_home macro according to the local implementation as example</li>
+
+
+
+
+
+    
+    
+    
+    
+    
+    </ul>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </ul>
+
+
+
+
+
+</ul>
+
+
+
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td style="background-color: rgb(192, 192, 192);">#macro OSC_home "/usr/local/OpenScientist/v16r0"<br>
+
+
+
+
+
+macro OSC_home "/home/campagne/kits/OpenScientist/v16r0/"</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+<ul>
+
+
+
+
+
+  
+  
+  
+  
+  
+  <ul>
+
+
+
+
+
+    
+    
+    
+    
+    
+    <ul>
+
+
+
+
+
+      <li>edit in the same spirit, edit the <span style="color: rgb(255, 0, 0);">ROOT/&lt;version&gt;/cmt/requiement</span> file to change the ROOT_native_version and the ROOT_home macros, as for instance</li>
+
+
+
+
+
+    
+    
+    
+    
+    
+    </ul>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </ul>
+
+
+
+
+
+</ul>
+
+
+
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td style="background-color: rgb(192, 192, 192);">#macro ROOT_native_version "v5-13-04b"<br>
+
+
+
+
+
+macro ROOT_native_version "4.03.02"<br>
+
+
+
+
+
+      <br>
+
+
+
+
+
+macro ROOT_home "/home/campagne/kits/root-${ROOT_native_version}" </td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+<ul>
+
+
+
+
+
+  <li>create a <span style="color: rgb(255, 0, 0);">&lt;personal-area&gt;/OSArea</span> area :
+    <ul>
+
+
+
+
+
+    <li>create a <a name="cmtproject.cmt-2"></a><span style="color: rgb(255, 0, 0);">/cmt/project.cmt</span> file with the simple code making the bridge between the MEMPHYS-like package and the common kits used to develop and use them:</li>
+
+
+
+
+
+  
+  
+  
+  
+  
+    </ul>
+  </li>
+
+
+
+
+
+  
+  
+  
+  
+  
+
+
+
+
+</ul>
+
+
+
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td style="background-color: rgb(192, 192, 192);">project OSArea<br>
+
+
+
+
+
+      <br>
+
+
+
+
+
+use OpenScientist v16r0<br>
+
+
+
+
+
+use CMTI</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+<ul>
+
+
+
+
+
+  
+  
+  
+  
+  
+  <ul>
+
+
+
+
+
+    <li>download the MEMPHYS package using&nbsp;
+      <ul>
+
+
+
+
+
+      <li>either a tarball at the following link: <span style="font-weight: bold; color: rgb(255, 0, 0);">TBD if possible</span></li>
+
+
+
+
+
+      <li>either the SVN software:
+          <ul>
+
+
+
+
+
+        <li>define the environment variable:</li>
+
+
+
+
+
+      
+      
+      
+      
+      
+          </ul>
+        </li>
+
+
+
+
+
+      
+      
+      
+      
+      
+
+
+
+
+    
+    
+    
+    
+    
+      </ul>
+    </li>
+
+
+
+
+
+    
+    
+    
+    
+    
+
+
+
+
+  
+  
+  
+  
+  
+  </ul>
+
+
+
+
+
+</ul>
+
+
+
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td style="background-color: rgb(192, 192, 192);">setenv SVNURL "https://svn.lal.in2p3.fr/Opera/Glob"</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+<ul>
+
+
+
+
+
+  
+  
+  
+  
+  
+  <ul>
+
+
+
+
+
+    
+    
+    
+    
+    
+    <ul>
+
+
+
+
+
+      
+      
+      
+      
+      
+      <ul>
+
+
+
+
+
+        <li>&nbsp;Check Out the HEAD version of the MEMPHYS package if
+you want to be a developer (ie. make later some "svn commit"
+order):&nbsp;</li>
+
+
+
+
+
+      
+      
+      
+      
+      
+      </ul>
+
+
+
+
+
+    
+    
+    
+    
+    
+    </ul>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </ul>
+
+
+
+
+
+</ul>
+
+
+
+
+
+<table style="width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td style="background-color: rgb(204, 204, 204);">svn co ${SVNURL}/MEMPHYS/HEAD MEMPHYS/&lt;new-version&gt;</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+<br>
+
+
+
+
+
+<div style="text-align: justify;">Look at the repository SVNURL with
+your Web browser and see in the MEMPHYS/tags directory the latest
+tagged version to choose the new-version tag. In general new-version is
+composed with a &lt;major&gt; and a &lt;minor&gt; number (eg.
+v&lt;major&gt;r&lt;minor&gt;) and the usage is that &lt;major&gt;
+indicates non backward compatibility (notice that it might be that
+&lt;minor&gt; release are non backward compatible). 
+
+
+
+
+</div>
+
+
+
+
+
+<ul>
+
+
+
+
+
+  
+  
+  
+  
+  
+  <ul>
+
+
+
+
+
+    
+    
+    
+    
+    
+    <ul>
+
+
+
+
+
+      
+      
+      
+      
+      
+      <ul>
+
+
+
+
+
+        <li>execute the CMT setup:</li>
+
+
+
+
+
+      
+      
+      
+      
+      
+      </ul>
+
+
+
+
+
+    
+    
+    
+    
+    
+    </ul>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </ul>
+
+
+
+
+
+</ul>
+
+
+
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td style="background-color: rgb(204, 204, 204);">source &lt;common-area-path&gt;/kits/CMT/&lt;version&gt;/mgr/setup.csh</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+<ul>
+
+
+
+
+
+  
+  
+  
+  
+  
+  <ul>
+
+
+
+
+
+    
+    
+    
+    
+    
+    <ul>
+
+
+
+
+
+      
+      
+      
+      
+      
+      <ul>
+
+
+
+
+
+        <li>&nbsp;Then, one needs to reconfigure the MEMPHYS environment using the CMT ad hoc command</li>
+
+
+
+
+
+      
+      
+      
+      
+      
+      </ul>
+
+
+
+
+
+    
+    
+    
+    
+    
+    </ul>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </ul>
+
+
+
+
+
+</ul>
+
+
+
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td style="background-color: rgb(204, 204, 204);">UNIX&gt; cd MEMPHYS/&lt;version&gt;/cmt<br>
+
+
+
+
+
+UNIX&gt; cmt config<br>
+
+
+
+
+
+UNIX&gt; source setup.csh</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+<br>
+
+
+
+
+
+At this stage one may wander if the environment is correct and if CMT
+will find all the packages to proceed to a successful compilation and
+linkage. One can use the following cross-checks:<br>
+
+
+
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td style="background-color: rgb(204, 204, 204);">UNIX&gt; cd MEMPHYS/&lt;version&gt;/cmt&gt;<br>
+
+
+
+
+
+UNIX&gt; cmt show path<br>
+
+
+
+
+
+# Add path /home/campagne/projets/OSArea from initialization<br>
+
+
+
+
+
+# Add path /home/campagne/kits/OpenScientist/v16r0 from ProjectPath<br>
+
+
+
+
+
+# Add path /home/campagne/CMTI from ProjectPath<br>
+
+
+
+
+
+# Add path /home/campagne/CMTI from ProjectPath</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+Here it is shown that the <a href="#CMTPROJECTPATH">CMTPROJECTPATH</a> is well defined and that the different <a href="#cmtproject.cmt-1">project.cmt files</a> are correctly configurated. Then uses,<br>
+
+
+
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td style="background-color: rgb(204, 204, 204);">UNIX&gt; cmt show uses<br>
+
+
+
+
+
+# use OpenScientist v16r0 Interfaces<br>
+
+
+
+
+
+# use ROOT v1r* Interfaces (native_version=4.03.02)<br>
+
+
+
+
+
+#<br>
+
+
+
+
+
+# Selection :<br>
+
+
+
+
+
+use CMT v1r18p20051108 (/home/campagne/kits)<br>
+
+
+
+
+
+use ROOT v1r51000p0 Interfaces (/home/campagne/CMTI/)<br>
+
+
+
+
+
+use OpenScientist v16r0 Interfaces (/home/campagne/CMTI/)</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+to see if the<a href="#to_install_the_OpenScientist-CMT_"> OpenScientist and ROOT Interface packages</a> are found (this does not mean yet that the Interfaces are correctly tuned...)<br>
+
+
+
+
+
+<ul>
+
+
+
+
+
+  
+  
+  
+  
+  
+  <ul>
+
+
+
+
+
+    
+    
+    
+    
+    
+    <ul>
+
+
+
+
+
+      
+      
+      
+      
+      
+      <ul>
+
+
+
+
+
+        <li>If the above cross-checks are successfuly passed, then one can proceed to the compilation and the link: &nbsp;</li>
+
+
+
+
+
+      
+      
+      
+      
+      
+      </ul>
+
+
+
+
+
+    
+    
+    
+    
+    
+    </ul>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </ul>
+
+
+
+
+
+</ul>
+
+
+
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td style="background-color: rgb(204, 204, 204);">UNIX&gt; cd MEMPHYS/&lt;verson&gt;/cmt<br>
+
+
+
+
+
+UNIX&gt; gmake</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+<br>
+
+
+
+
+
+If the all the process of compilationand link is ok, then one should see the following lines:<br>
+
+
+
+
+
+<br>
+
+
+
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td style="background-color: rgb(204, 204, 204);">[...]<br>
+
+
+
+
+
+------&gt; MEMPHYS_session ok<br>
+
+
+
+
+
+------&gt; (constituents.make) MEMPHYS_session done<br>
+
+
+
+
+
+&nbsp;all ok.</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+<br>
+
+
+
+
+
+At the stage, one has build sucessfully MEMPHYS_session (the
+interactive version mostly for visualisation) and the MEMPHYS_batch
+(the batch version mostly for tuple production on large statistics).<br>
+
+
+
+
+
+<h2 style="color: rgb(51, 51, 255);"><a class="mozTocH2" name="mozTocId3450"></a>Simple runs</h2>
+
+
+
+
+
+Usually the user starts an UNIX session and want to run MEMPHYS. The two things to do are:<br>
+
+
+
+
+
+<br>
+
+
+
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td style="background-color: rgb(204, 204, 204);">1) be sure to define the <a href="#CMTPROJECTPATH">CMTPROJECTPATH</a> variable (at login or by sourcing a meta-setup)<br>
+
+
+
+
+
+2) execute the MEMPHYS setup (no more necessary to run "cmt config"):<br>
+
+
+
+
+
+UNIX&gt; cd &lt;personal-area&gt;/OSArea/MEMPHYS/&lt;versioin&gt;/cmt<br>
+
+
+
+
+
+UNIX&gt; source setup.csh</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+<br>
+
+
+
+
+
+The directory hierarchy of the MEMPHYS package is the following:<br>
+
+
+
+
+
+<br>
+
+
+
+
+
+<table style="text-align: left; background-color: rgb(255, 255, 102); width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td>source</td>
+
+
+
+
+
+      <td>source Core directory</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td>application</td>
+
+
+
+
+
+      <td>source files where the <span style="font-style: italic;">main</span> steering routine is defined</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td>MEMPHYS</td>
+
+
+
+
+
+      <td>include files of the Core</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td>cmt</td>
+
+
+
+
+
+      <td>directory where the CMT management files are located (requirements, setup/cleanup)</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td>data</td>
+
+
+
+
+
+      <td>event file directory. NUANCE style is used to code the primary vertex particles</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td>run</td>
+
+
+
+
+
+      <td>executable are run from this directory, the inputEventfile
+symbolic link to an existing event file should be set before run. There
+are also a collection of ROOT macros to decode the output event
+sturcture stored into the tuple.</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td>scripts</td>
+
+
+
+
+
+      <td>Geant4 and OpenScientist scripts</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+<br>
+
+
+
+
+
+<h3><a class="mozTocH3" name="mozTocId327975"></a>Interactive session</h3>
+
+
+
+
+
+In an interactive session the tuple generation is desable and one starts as followed:<br>
+
+
+
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td style="background-color: rgb(192, 192, 192);">UNIX&gt; cd $MEMPHYSROOT/run<br>
+
+
+
+
+
+UNIX&gt; ../$CMTCONFIG/MEMPHYS_session.exe</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+&nbsp;<br>
+
+
+
+
+
+After more or less 15'' the geometry is loaded, and 15'' more is needed to see the OnX screen session. Then in the <span style="font-style: italic;">Geant </span>menu, one should validate the number of event to process via the <span style="font-style: italic;">Run</span>
+sub-menu. The first event is processed and the track of the optical
+volume are dispayed. By clicking on the eye then it is possible to
+rotate the event, zoom and so on. One may see the following screen:<br>
+
+
+
+
+
+<img style="width: 858px; height: 734px;" alt="image" src="Images/numuEvent.jpg"> <br>
+
+
+<br>
+
+
+One can visualize the "Hits" using the MEMPHYS menu, although it is
+then useful to use the zoom by using CTRL-Shift + drag the mouse in the
+("Hand mode" see right icons).<br>
+
+
+<br>
+
+
+<img style="width: 858px; height: 734px;" alt="Image" src="Images/numuEventHit.jpg"><br>
+
+
+
+
+
+<br>
+
+
+
+
+
+Using "Arrow Mode" (right icons) the user enter in picking mode to get
+some ascii information on the object (or collection of objects selected
+by CTRL-Shift + drag mouse).<br>
+
+
+
+
+
+<h3><a class="mozTocH3" name="mozTocId967005"></a>Batch mode</h3>
+
+
+
+
+
+In the batch mode, the user produces an event tuple (<span style="font-style: italic; color: rgb(255, 0, 0);">run/MEMPHYS.root</span>)
+created via the AIDA abstract interfaces implementation by
+OpenScientist. The I/O is performed in ROOT-I/O repackaged format that
+can be analysed<br>
+
+
+
+
+
+<ul>
+
+
+
+
+
+  <li>&nbsp;either using &nbsp;compilated AIDA code (<span style="font-style: italic; color: rgb(255, 0, 0);">MEMPHYS_analysis_aida_ROOT.exe</span>, <span style="font-style: italic; color: rgb(255, 0, 0);">MEMPHYS_analysis_ROOT.exe</span>) generated by compiling as:&nbsp;</li>
+
+
+
+
+
+</ul>
+
+
+
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td style="background-color: rgb(204, 204, 204);">UNIX&gt; you are in the <span style="font-style: italic;">run</span> directory<br>
+
+
+
+
+
+UNIX&gt; (cd ../cmt ; gmake ROOT)</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+&nbsp;&nbsp; <br>
+
+
+
+
+
+&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp; The difference between the two applications are XXX &nbsp;&nbsp;&nbsp; <br>
+
+
+
+
+
+<ul>
+
+
+
+
+
+  <li>either using interactive OnX session ()</li>
+
+
+
+
+
+</ul>
+
+
+
+
+
+<ul>
+
+
+
+
+
+  <li>or&nbsp;using the ROOT toolkit using the <span style="font-style: italic; color: rgb(255, 0, 0);">MEMPHYS_xxx.C</span> macros</li>
+
+
+
+
+
+</ul>
+
+
+
+
+
+The structure of the tuple for the moment is the following:<br>
+
+
+
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
+
+
+
+
+
+  <tbody>
+
+
+
+
+
+    <tr>
+
+
+
+
+
+      <td style="background-color: rgb(102, 255, 153);">&nbsp; std::string column = "int eventId, inputEvtId, interMode, vtxVol, "; <br>
+
+
+
+
+
+&nbsp; column += "ITuple vtxPos = { double x, y, z }, ";<br>
+
+
+
+
+
+&nbsp; column += "int nPart, leptonIndex, protonIndex, ";<br>
+
+
+
+
+
+&nbsp; column += "ITuple track = { int pId, parent, float timeStart, ";<br>
+
+
+
+
+
+&nbsp; column
++=&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+"ITuple direction = { double dx, dy, dz }, ";<br>
+
+
+
+
+
+&nbsp; column
++=&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+"double mass, pTot, ETot, ";<br>
+
+
+
+
+
+&nbsp; column
++=&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+"ITuple momentum&nbsp; = { double px, py, pz }, ";<br>
+
+
+
+
+
+&nbsp; column
++=&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+"ITuple startPos&nbsp; = { double&nbsp; x,&nbsp; y,&nbsp; z }, ";<br>
+
+
+
+
+
+&nbsp; column
++=&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+"ITuple stopPos&nbsp;&nbsp; = { double&nbsp; x,&nbsp; y,&nbsp; z }, ";<br>
+
+
+
+
+
+&nbsp; column
++=&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+"int startVol, stopVol ";<br>
+
+
+
+
+
+&nbsp; column +=&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; "}, ";<br>
+
+
+
+
+
+&nbsp; column += "int nHits, ITuple hit = { int tubeId, int totalPE, ITuple pe = { float time} }, ";<br>
+
+
+
+
+
+&nbsp; column += "int nDigits, double sumPE, ";<br>
+
+
+
+
+
+&nbsp; column += "ITuple digit = { int tubeId, double pe, time }";</td>
+
+
+
+
+
+    </tr>
+
+
+
+
+
+  
+  
+  
+  
+  
+  </tbody>
+</table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</body>
+</html>
