source: snovis/head/doc/snovis.html @ 7

Last change on this file since 7 was 7, checked in by barrand, 17 years ago
File size: 23.5 KB
RevLine 
[7]1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html lang="fr-fr">
3<head>
4
5
6
7
8
9 
10 
11 
12 
13 
14  <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type">
15
16
17
18
19
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30  <title>MEMPHYS Software</title>
31  <meta content="J-E Campagne " name="author">
32</head>
33
34<body>
35
36
37
38
39
40<h1 style="text-align: center; color: rgb(0, 0, 153);"><a class="mozTocH1" name="mozTocId909942"></a>Install and run MEMPHYS software&nbsp;</h1>
41
42
43
44
45
46<h1 style="text-align: center; color: rgb(0, 0, 153);">and the associate toolkits</h1>
47
48
49
50
51
52<hr style="width: 100%; height: 2px;">
53<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>
54
55
56
57
58
59<ul id="mozToc">
60
61
62
63
64<!--mozToc h2 2 h3 3 h4 4 h5 5 h6 6--><li><a href="#mozTocId102030">Table of Contents</a>
65   
66   
67   
68   
69    <ul>
70
71
72
73
74      <li><a href="#mozTocId791206">What the user have to know?</a></li>
75
76
77
78
79      <li><a href="#mozTocId474404">Installation of the Plug-ins and the MEMPHYS package&nbsp;</a>
80       
81       
82       
83       
84        <ul>
85
86
87
88
89          <li><a href="#mozTocId129835">The OpenScientist toolkit</a></li>
90
91
92
93
94          <li><a href="#mozTocId109209">The MEMPHYS package</a></li>
95
96
97
98
99       
100       
101       
102       
103        </ul>
104
105
106
107
108      </li>
109
110
111
112
113      <li><a href="#mozTocId3450">Simple runs</a>
114       
115       
116       
117       
118        <ul>
119
120
121
122
123          <li><a href="#mozTocId327975">Interactive session</a></li>
124
125
126
127
128          <li><a href="#mozTocId967005">Batch mode</a></li>
129
130
131
132
133       
134       
135       
136       
137        </ul>
138
139
140
141
142      </li>
143
144
145
146
147   
148   
149   
150   
151    </ul>
152
153
154
155
156  </li>
157
158
159
160
161</ul>
162
163
164
165
166
167<h2 style="color: rgb(51, 51, 255);"><a class="mozTocH2" name="mozTocId791206"></a>What the user have to know?</h2>
168
169
170
171
172
173The user is supposed to know how to practice more or less: <br>
174
175
176
177
178
179<ul>
180
181
182
183
184
185  <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>
186
187
188
189
190
191  <li>the <a href="http://www.cmtsite.org/">CMT</a> code management tool,</li>
192
193
194
195
196
197  <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>
198
199
200
201
202
203  <li>the <a href="http://www.cs.uregina.ca/Dept/manuals/Manuals/7Language/7_18C++/c++.htm">C++</a> language,</li>
204
205
206
207
208
209  <li>the <a href="http://geant4.web.cern.ch/geant4/">Geant 4</a> simulation tool,&nbsp;</li>
210
211
212
213
214
215  <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>
216abstract interface for the tuple creation and, also some practice of
217the OpenScientist visualisation to run the MEMPHYS_session executable</li>
218
219
220
221
222
223  <li>the <a href="http://root.cern.ch/">ROOT</a> toolkit if one wants to make analysis/ploting using this package.</li>
224
225
226
227
228
229</ul>
230
231
232
233
234
235<h2 style="color: rgb(51, 51, 255);"><a class="mozTocH2" name="mozTocId474404"></a>Installation of the Plug-ins and the MEMPHYS package&nbsp;</h2>
236
237
238
239
240
241<div style="text-align: justify;">It is supposed that the SVN, CMT (at
242least version v1r18), ROOT (at least version 4) tools are available
243under the plateform used hereafter. For definitiveness it is
244explicitely shown the commands to be executed under the UNIX/csh shell.
245Usually the toolkits are also providing UNIX/sh shell command file. The
246Mac XXX will be documented later. </div>
247
248
249
250
251
252<h3><a class="mozTocH3" name="mozTocId129835"></a>The OpenScientist toolkit</h3>
253
254
255
256
257
258If 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>
2598.2 version are part of the toolkit and includes all the include files,
260the libraries and the binnaries necessary for the development of the
261MEMPHYS code or similar codes.<br>
262
263
264
265
266
267<br>
268
269
270
271
272
273<a name="OpenScientistInstall"></a>So, the user proceeds as followed (UNIX):<br>
274
275
276
277
278
279<ol>
280
281
282
283
284
285  <li>download the zip file</li>
286
287
288
289
290
291  <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>
292
293
294
295
296
297  <li>cd OpenScientist/v16r0</li>
298
299
300
301
302
303  <li>chmod &nbsp;a+x install</li>
304
305
306
307
308
309  <li>./install</li>
310
311
312
313
314
315</ol>
316
317
318
319
320
321To use the toolkit in stand alone mode or to see if the installation
322was fine, first of all setup the environment by sourcing:
323&nbsp;&nbsp;&nbsp; <br>
324
325
326
327
328
329&nbsp;csh&gt; source &lt;path&gt;/OpenScientist/v16r0/aida-setup.csh<br>
330
331
332
333
334
335(&nbsp; sh&gt; . &lt;path&gt;/OpenScientist/v16r0/aida-setup.sh )<br>
336
337
338
339
340
341&nbsp;Then, for instance one may experience the&nbsp; ploting capability :
342<ul>
343
344
345
346
347
348  <li>UNIX&gt;&nbsp; aida-config</li>
349
350
351
352
353
354  <li>UNIX&gt; onxlab</li>
355
356
357
358
359
360</ul>
361
362
363
364
365
366The user may see the famous gaussian distribution and the associate fit....<br>
367
368
369
370
371
372<div style="text-align: center;"><img style="width: 858px; height: 734px;" alt="Image" src="Images/onxlab.jpg">
373
374
375
376
377</div>
378
379
380
381
382
383<br>
384
385
386
387
388
389Also, the user may play with&nbsp;Geant4 interactively and show the
390event display. Have a look at the novice examples or a simpler example
391as followed: <br>
392
393
394
395
396
397<ul>
398
399
400
401
402
403  <li>&nbsp;UNIX&gt; G4Simple_session</li>
404
405
406
407
408
409  <li>In the Geant 4 menu, starts with "Init" and then "Run", some tracks will appear when the number of events are validated</li>
410
411
412
413
414
415  <li>To show the geometry: follow the "Physical Volumes" in the "Tree
416actions" and clik on the different directories and leaves. One may see
417the following figure:</li>
418
419
420
421
422
423</ul>
424
425
426
427
428
429<div style="text-align: center;"><img style="width: 858px; height: 734px;" alt="Image" src="Images/G4Simple.jpg">
430
431
432
433
434</div>
435
436
437
438
439
440<h3><a class="mozTocH3" name="mozTocId109209"></a>The MEMPHYS package</h3>
441
442
443
444
445
446To install the MEMPHYS package, one may adopt a directory hierarchy as followed (UNIX):<br>
447
448
449
450
451
452<ul>
453
454
455
456
457
458  <li>define at the&nbsp;login phase the <a name="CMTPROJECTPATH"></a>CMTPROJECTPATH environment variable:&nbsp;</li>
459
460
461
462
463
464</ul>
465
466
467
468
469
470<table style="width: 100%;" border="1" cellpadding="2" cellspacing="2">
471
472
473
474
475
476
477  <tbody>
478
479
480
481
482
483    <tr>
484
485
486
487
488
489      <td style="background-color: rgb(204, 204, 204);">setenv CMTPROJECTPATH "&lt;common-area-path&gt;/kits:&lt;personal-area&gt;"</td>
490
491
492
493
494
495    </tr>
496
497
498
499
500
501
502 
503 
504 
505 
506 
507  </tbody>
508</table>
509
510
511
512
513
514<ul>
515
516
517
518
519
520  <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>
521
522
523
524
525
526  <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;
527    <ul>
528
529
530
531
532
533    <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>
534
535
536
537
538
539 
540 
541 
542 
543 
544    </ul>
545  </li>
546
547
548
549
550
551 
552 
553 
554 
555 
556
557
558
559
560</ul>
561
562
563
564
565
566<table style="background-color: rgb(192, 192, 192); width: 100%;" border="1" cellpadding="2" cellspacing="2">
567
568
569
570
571
572
573  <tbody>
574
575
576
577
578
579    <tr>
580
581
582
583
584
585      <td>project CMTI</td>
586
587
588
589
590
591    </tr>
592
593
594
595
596
597
598 
599 
600 
601 
602 
603  </tbody>
604</table>
605
606
607
608
609
610<ul>
611
612
613
614
615
616 
617 
618 
619 
620 
621  <ul>
622
623
624
625
626
627    <li><a name="to_install_the_OpenScientist-CMT_"></a>to install the OpenScientist-CMT&nbsp; Interfaces for OpenScientist toolkit and the ROOT toolkit</li>
628
629
630
631
632
633 
634 
635 
636 
637 
638  </ul>
639
640
641
642
643
644 
645 
646 
647 
648 
649  <ul>
650
651
652
653
654
655   
656   
657   
658   
659   
660    <ul>
661
662
663
664
665
666      <li>download the Interfaces here (<span style="color: rgb(255, 0, 0); font-weight: bold;">TBD</span>)&nbsp;</li>
667
668
669
670
671
672   
673   
674   
675   
676   
677    </ul>
678
679
680
681
682
683   
684   
685   
686   
687   
688    <ul>
689
690
691
692
693
694      <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>
695
696
697
698
699
700   
701   
702   
703   
704   
705    </ul>
706
707
708
709
710
711 
712 
713 
714 
715 
716  </ul>
717
718
719
720
721
722</ul>
723
724
725
726
727
728<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
729
730
731
732
733
734  <tbody>
735
736
737
738
739
740    <tr>
741
742
743
744
745
746      <td style="background-color: rgb(192, 192, 192);">#macro OSC_home "/usr/local/OpenScientist/v16r0"<br>
747
748
749
750
751
752macro OSC_home "/home/campagne/kits/OpenScientist/v16r0/"</td>
753
754
755
756
757
758    </tr>
759
760
761
762
763
764 
765 
766 
767 
768 
769  </tbody>
770</table>
771
772
773
774
775
776<ul>
777
778
779
780
781
782 
783 
784 
785 
786 
787  <ul>
788
789
790
791
792
793   
794   
795   
796   
797   
798    <ul>
799
800
801
802
803
804      <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>
805
806
807
808
809
810   
811   
812   
813   
814   
815    </ul>
816
817
818
819
820
821 
822 
823 
824 
825 
826  </ul>
827
828
829
830
831
832</ul>
833
834
835
836
837
838<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
839
840
841
842
843
844  <tbody>
845
846
847
848
849
850    <tr>
851
852
853
854
855
856      <td style="background-color: rgb(192, 192, 192);">#macro ROOT_native_version "v5-13-04b"<br>
857
858
859
860
861
862macro ROOT_native_version "4.03.02"<br>
863
864
865
866
867
868      <br>
869
870
871
872
873
874macro ROOT_home "/home/campagne/kits/root-${ROOT_native_version}" </td>
875
876
877
878
879
880    </tr>
881
882
883
884
885
886 
887 
888 
889 
890 
891  </tbody>
892</table>
893
894
895
896
897
898<ul>
899
900
901
902
903
904  <li>create a <span style="color: rgb(255, 0, 0);">&lt;personal-area&gt;/OSArea</span> area :
905    <ul>
906
907
908
909
910
911    <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>
912
913
914
915
916
917 
918 
919 
920 
921 
922    </ul>
923  </li>
924
925
926
927
928
929 
930 
931 
932 
933 
934
935
936
937
938</ul>
939
940
941
942
943
944<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
945
946
947
948
949
950  <tbody>
951
952
953
954
955
956    <tr>
957
958
959
960
961
962      <td style="background-color: rgb(192, 192, 192);">project OSArea<br>
963
964
965
966
967
968      <br>
969
970
971
972
973
974use OpenScientist v16r0<br>
975
976
977
978
979
980use CMTI</td>
981
982
983
984
985
986    </tr>
987
988
989
990
991
992 
993 
994 
995 
996 
997  </tbody>
998</table>
999
1000
1001
1002
1003
1004<ul>
1005
1006
1007
1008
1009
1010 
1011 
1012 
1013 
1014 
1015  <ul>
1016
1017
1018
1019
1020
1021    <li>download the MEMPHYS package using&nbsp;
1022      <ul>
1023
1024
1025
1026
1027
1028      <li>either a tarball at the following link: <span style="font-weight: bold; color: rgb(255, 0, 0);">TBD if possible</span></li>
1029
1030
1031
1032
1033
1034      <li>either the SVN software:
1035          <ul>
1036
1037
1038
1039
1040
1041        <li>define the environment variable:</li>
1042
1043
1044
1045
1046
1047     
1048     
1049     
1050     
1051     
1052          </ul>
1053        </li>
1054
1055
1056
1057
1058
1059     
1060     
1061     
1062     
1063     
1064
1065
1066
1067
1068   
1069   
1070   
1071   
1072   
1073      </ul>
1074    </li>
1075
1076
1077
1078
1079
1080   
1081   
1082   
1083   
1084   
1085
1086
1087
1088
1089 
1090 
1091 
1092 
1093 
1094  </ul>
1095
1096
1097
1098
1099
1100</ul>
1101
1102
1103
1104
1105
1106<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
1107
1108
1109
1110
1111
1112  <tbody>
1113
1114
1115
1116
1117
1118    <tr>
1119
1120
1121
1122
1123
1124      <td style="background-color: rgb(192, 192, 192);">setenv SVNURL "https://svn.lal.in2p3.fr/Opera/Glob"</td>
1125
1126
1127
1128
1129
1130    </tr>
1131
1132
1133
1134
1135
1136 
1137 
1138 
1139 
1140 
1141  </tbody>
1142</table>
1143
1144
1145
1146
1147
1148<ul>
1149
1150
1151
1152
1153
1154 
1155 
1156 
1157 
1158 
1159  <ul>
1160
1161
1162
1163
1164
1165   
1166   
1167   
1168   
1169   
1170    <ul>
1171
1172
1173
1174
1175
1176     
1177     
1178     
1179     
1180     
1181      <ul>
1182
1183
1184
1185
1186
1187        <li>&nbsp;Check Out the HEAD version of the MEMPHYS package if
1188you want to be a developer (ie. make later some "svn commit"
1189order):&nbsp;</li>
1190
1191
1192
1193
1194
1195     
1196     
1197     
1198     
1199     
1200      </ul>
1201
1202
1203
1204
1205
1206   
1207   
1208   
1209   
1210   
1211    </ul>
1212
1213
1214
1215
1216
1217 
1218 
1219 
1220 
1221 
1222  </ul>
1223
1224
1225
1226
1227
1228</ul>
1229
1230
1231
1232
1233
1234<table style="width: 100%;" border="1" cellpadding="2" cellspacing="2">
1235
1236
1237
1238
1239
1240
1241  <tbody>
1242
1243
1244
1245
1246
1247    <tr>
1248
1249
1250
1251
1252
1253      <td style="background-color: rgb(204, 204, 204);">svn co ${SVNURL}/MEMPHYS/HEAD MEMPHYS/&lt;new-version&gt;</td>
1254
1255
1256
1257
1258
1259    </tr>
1260
1261
1262
1263
1264
1265
1266 
1267 
1268 
1269 
1270 
1271  </tbody>
1272</table>
1273
1274
1275
1276
1277
1278<br>
1279
1280
1281
1282
1283
1284<div style="text-align: justify;">Look at the repository SVNURL with
1285your Web browser and see in the MEMPHYS/tags directory the latest
1286tagged version to choose the new-version tag. In general new-version is
1287composed with a &lt;major&gt; and a &lt;minor&gt; number (eg.
1288v&lt;major&gt;r&lt;minor&gt;) and the usage is that &lt;major&gt;
1289indicates non backward compatibility (notice that it might be that
1290&lt;minor&gt; release are non backward compatible).
1291
1292
1293
1294
1295</div>
1296
1297
1298
1299
1300
1301<ul>
1302
1303
1304
1305
1306
1307 
1308 
1309 
1310 
1311 
1312  <ul>
1313
1314
1315
1316
1317
1318   
1319   
1320   
1321   
1322   
1323    <ul>
1324
1325
1326
1327
1328
1329     
1330     
1331     
1332     
1333     
1334      <ul>
1335
1336
1337
1338
1339
1340        <li>execute the CMT setup:</li>
1341
1342
1343
1344
1345
1346     
1347     
1348     
1349     
1350     
1351      </ul>
1352
1353
1354
1355
1356
1357   
1358   
1359   
1360   
1361   
1362    </ul>
1363
1364
1365
1366
1367
1368 
1369 
1370 
1371 
1372 
1373  </ul>
1374
1375
1376
1377
1378
1379</ul>
1380
1381
1382
1383
1384
1385<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
1386
1387
1388
1389
1390
1391  <tbody>
1392
1393
1394
1395
1396
1397    <tr>
1398
1399
1400
1401
1402
1403      <td style="background-color: rgb(204, 204, 204);">source &lt;common-area-path&gt;/kits/CMT/&lt;version&gt;/mgr/setup.csh</td>
1404
1405
1406
1407
1408
1409    </tr>
1410
1411
1412
1413
1414
1415 
1416 
1417 
1418 
1419 
1420  </tbody>
1421</table>
1422
1423
1424
1425
1426
1427<ul>
1428
1429
1430
1431
1432
1433 
1434 
1435 
1436 
1437 
1438  <ul>
1439
1440
1441
1442
1443
1444   
1445   
1446   
1447   
1448   
1449    <ul>
1450
1451
1452
1453
1454
1455     
1456     
1457     
1458     
1459     
1460      <ul>
1461
1462
1463
1464
1465
1466        <li>&nbsp;Then, one needs to reconfigure the MEMPHYS environment using the CMT ad hoc command</li>
1467
1468
1469
1470
1471
1472     
1473     
1474     
1475     
1476     
1477      </ul>
1478
1479
1480
1481
1482
1483   
1484   
1485   
1486   
1487   
1488    </ul>
1489
1490
1491
1492
1493
1494 
1495 
1496 
1497 
1498 
1499  </ul>
1500
1501
1502
1503
1504
1505</ul>
1506
1507
1508
1509
1510
1511<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
1512
1513
1514
1515
1516
1517  <tbody>
1518
1519
1520
1521
1522
1523    <tr>
1524
1525
1526
1527
1528
1529      <td style="background-color: rgb(204, 204, 204);">UNIX&gt; cd MEMPHYS/&lt;version&gt;/cmt<br>
1530
1531
1532
1533
1534
1535UNIX&gt; cmt config<br>
1536
1537
1538
1539
1540
1541UNIX&gt; source setup.csh</td>
1542
1543
1544
1545
1546
1547    </tr>
1548
1549
1550
1551
1552
1553 
1554 
1555 
1556 
1557 
1558  </tbody>
1559</table>
1560
1561
1562
1563
1564
1565<br>
1566
1567
1568
1569
1570
1571At this stage one may wander if the environment is correct and if CMT
1572will find all the packages to proceed to a successful compilation and
1573linkage. One can use the following cross-checks:<br>
1574
1575
1576
1577
1578
1579<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
1580
1581
1582
1583
1584
1585  <tbody>
1586
1587
1588
1589
1590
1591    <tr>
1592
1593
1594
1595
1596
1597      <td style="background-color: rgb(204, 204, 204);">UNIX&gt; cd MEMPHYS/&lt;version&gt;/cmt&gt;<br>
1598
1599
1600
1601
1602
1603UNIX&gt; cmt show path<br>
1604
1605
1606
1607
1608
1609# Add path /home/campagne/projets/OSArea from initialization<br>
1610
1611
1612
1613
1614
1615# Add path /home/campagne/kits/OpenScientist/v16r0 from ProjectPath<br>
1616
1617
1618
1619
1620
1621# Add path /home/campagne/CMTI from ProjectPath<br>
1622
1623
1624
1625
1626
1627# Add path /home/campagne/CMTI from ProjectPath</td>
1628
1629
1630
1631
1632
1633    </tr>
1634
1635
1636
1637
1638
1639 
1640 
1641 
1642 
1643 
1644  </tbody>
1645</table>
1646
1647
1648
1649
1650
1651Here 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>
1652
1653
1654
1655
1656
1657<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
1658
1659
1660
1661
1662
1663  <tbody>
1664
1665
1666
1667
1668
1669    <tr>
1670
1671
1672
1673
1674
1675      <td style="background-color: rgb(204, 204, 204);">UNIX&gt; cmt show uses<br>
1676
1677
1678
1679
1680
1681# use OpenScientist v16r0 Interfaces<br>
1682
1683
1684
1685
1686
1687# use ROOT v1r* Interfaces (native_version=4.03.02)<br>
1688
1689
1690
1691
1692
1693#<br>
1694
1695
1696
1697
1698
1699# Selection :<br>
1700
1701
1702
1703
1704
1705use CMT v1r18p20051108 (/home/campagne/kits)<br>
1706
1707
1708
1709
1710
1711use ROOT v1r51000p0 Interfaces (/home/campagne/CMTI/)<br>
1712
1713
1714
1715
1716
1717use OpenScientist v16r0 Interfaces (/home/campagne/CMTI/)</td>
1718
1719
1720
1721
1722
1723    </tr>
1724
1725
1726
1727
1728
1729 
1730 
1731 
1732 
1733 
1734  </tbody>
1735</table>
1736
1737
1738
1739
1740
1741to 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>
1742
1743
1744
1745
1746
1747<ul>
1748
1749
1750
1751
1752
1753 
1754 
1755 
1756 
1757 
1758  <ul>
1759
1760
1761
1762
1763
1764   
1765   
1766   
1767   
1768   
1769    <ul>
1770
1771
1772
1773
1774
1775     
1776     
1777     
1778     
1779     
1780      <ul>
1781
1782
1783
1784
1785
1786        <li>If the above cross-checks are successfuly passed, then one can proceed to the compilation and the link: &nbsp;</li>
1787
1788
1789
1790
1791
1792     
1793     
1794     
1795     
1796     
1797      </ul>
1798
1799
1800
1801
1802
1803   
1804   
1805   
1806   
1807   
1808    </ul>
1809
1810
1811
1812
1813
1814 
1815 
1816 
1817 
1818 
1819  </ul>
1820
1821
1822
1823
1824
1825</ul>
1826
1827
1828
1829
1830
1831<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
1832
1833
1834
1835
1836
1837  <tbody>
1838
1839
1840
1841
1842
1843    <tr>
1844
1845
1846
1847
1848
1849      <td style="background-color: rgb(204, 204, 204);">UNIX&gt; cd MEMPHYS/&lt;verson&gt;/cmt<br>
1850
1851
1852
1853
1854
1855UNIX&gt; gmake</td>
1856
1857
1858
1859
1860
1861    </tr>
1862
1863
1864
1865
1866
1867 
1868 
1869 
1870 
1871 
1872  </tbody>
1873</table>
1874
1875
1876
1877
1878
1879<br>
1880
1881
1882
1883
1884
1885If the all the process of compilationand link is ok, then one should see the following lines:<br>
1886
1887
1888
1889
1890
1891<br>
1892
1893
1894
1895
1896
1897<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
1898
1899
1900
1901
1902
1903  <tbody>
1904
1905
1906
1907
1908
1909    <tr>
1910
1911
1912
1913
1914
1915      <td style="background-color: rgb(204, 204, 204);">[...]<br>
1916
1917
1918
1919
1920
1921------&gt; MEMPHYS_session ok<br>
1922
1923
1924
1925
1926
1927------&gt; (constituents.make) MEMPHYS_session done<br>
1928
1929
1930
1931
1932
1933&nbsp;all ok.</td>
1934
1935
1936
1937
1938
1939    </tr>
1940
1941
1942
1943
1944
1945 
1946 
1947 
1948 
1949 
1950  </tbody>
1951</table>
1952
1953
1954
1955
1956
1957<br>
1958
1959
1960
1961
1962
1963At the stage, one has build sucessfully MEMPHYS_session (the
1964interactive version mostly for visualisation) and the MEMPHYS_batch
1965(the batch version mostly for tuple production on large statistics).<br>
1966
1967
1968
1969
1970
1971<h2 style="color: rgb(51, 51, 255);"><a class="mozTocH2" name="mozTocId3450"></a>Simple runs</h2>
1972
1973
1974
1975
1976
1977Usually the user starts an UNIX session and want to run MEMPHYS. The two things to do are:<br>
1978
1979
1980
1981
1982
1983<br>
1984
1985
1986
1987
1988
1989<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
1990
1991
1992
1993
1994
1995  <tbody>
1996
1997
1998
1999
2000
2001    <tr>
2002
2003
2004
2005
2006
2007      <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>
2008
2009
2010
2011
2012
20132) execute the MEMPHYS setup (no more necessary to run "cmt config"):<br>
2014
2015
2016
2017
2018
2019UNIX&gt; cd &lt;personal-area&gt;/OSArea/MEMPHYS/&lt;versioin&gt;/cmt<br>
2020
2021
2022
2023
2024
2025UNIX&gt; source setup.csh</td>
2026
2027
2028
2029
2030
2031    </tr>
2032
2033
2034
2035
2036
2037 
2038 
2039 
2040 
2041 
2042  </tbody>
2043</table>
2044
2045
2046
2047
2048
2049<br>
2050
2051
2052
2053
2054
2055The directory hierarchy of the MEMPHYS package is the following:<br>
2056
2057
2058
2059
2060
2061<br>
2062
2063
2064
2065
2066
2067<table style="text-align: left; background-color: rgb(255, 255, 102); width: 100%;" border="1" cellpadding="2" cellspacing="2">
2068
2069
2070
2071
2072
2073  <tbody>
2074
2075
2076
2077
2078
2079    <tr>
2080
2081
2082
2083
2084
2085      <td>source</td>
2086
2087
2088
2089
2090
2091      <td>source Core directory</td>
2092
2093
2094
2095
2096
2097    </tr>
2098
2099
2100
2101
2102
2103    <tr>
2104
2105
2106
2107
2108
2109      <td>application</td>
2110
2111
2112
2113
2114
2115      <td>source files where the <span style="font-style: italic;">main</span> steering routine is defined</td>
2116
2117
2118
2119
2120
2121    </tr>
2122
2123
2124
2125
2126
2127    <tr>
2128
2129
2130
2131
2132
2133      <td>MEMPHYS</td>
2134
2135
2136
2137
2138
2139      <td>include files of the Core</td>
2140
2141
2142
2143
2144
2145    </tr>
2146
2147
2148
2149
2150
2151    <tr>
2152
2153
2154
2155
2156
2157      <td>cmt</td>
2158
2159
2160
2161
2162
2163      <td>directory where the CMT management files are located (requirements, setup/cleanup)</td>
2164
2165
2166
2167
2168
2169    </tr>
2170
2171
2172
2173
2174
2175    <tr>
2176
2177
2178
2179
2180
2181      <td>data</td>
2182
2183
2184
2185
2186
2187      <td>event file directory. NUANCE style is used to code the primary vertex particles</td>
2188
2189
2190
2191
2192
2193    </tr>
2194
2195
2196
2197
2198
2199    <tr>
2200
2201
2202
2203
2204
2205      <td>run</td>
2206
2207
2208
2209
2210
2211      <td>executable are run from this directory, the inputEventfile
2212symbolic link to an existing event file should be set before run. There
2213are also a collection of ROOT macros to decode the output event
2214sturcture stored into the tuple.</td>
2215
2216
2217
2218
2219
2220    </tr>
2221
2222
2223
2224
2225
2226    <tr>
2227
2228
2229
2230
2231
2232      <td>scripts</td>
2233
2234
2235
2236
2237
2238      <td>Geant4 and OpenScientist scripts</td>
2239
2240
2241
2242
2243
2244    </tr>
2245
2246
2247
2248
2249
2250 
2251 
2252 
2253 
2254 
2255  </tbody>
2256</table>
2257
2258
2259
2260
2261
2262<br>
2263
2264
2265
2266
2267
2268<h3><a class="mozTocH3" name="mozTocId327975"></a>Interactive session</h3>
2269
2270
2271
2272
2273
2274In an interactive session the tuple generation is desable and one starts as followed:<br>
2275
2276
2277
2278
2279
2280<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
2281
2282
2283
2284
2285
2286  <tbody>
2287
2288
2289
2290
2291
2292    <tr>
2293
2294
2295
2296
2297
2298      <td style="background-color: rgb(192, 192, 192);">UNIX&gt; cd $MEMPHYSROOT/run<br>
2299
2300
2301
2302
2303
2304UNIX&gt; ../$CMTCONFIG/MEMPHYS_session.exe</td>
2305
2306
2307
2308
2309
2310    </tr>
2311
2312
2313
2314
2315
2316 
2317 
2318 
2319 
2320 
2321  </tbody>
2322</table>
2323
2324
2325
2326
2327
2328&nbsp;<br>
2329
2330
2331
2332
2333
2334After 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>
2335sub-menu. The first event is processed and the track of the optical
2336volume are dispayed. By clicking on the eye then it is possible to
2337rotate the event, zoom and so on. One may see the following screen:<br>
2338
2339
2340
2341
2342
2343<img style="width: 858px; height: 734px;" alt="image" src="Images/numuEvent.jpg"> <br>
2344
2345
2346<br>
2347
2348
2349One can visualize the "Hits" using the MEMPHYS menu, although it is
2350then useful to use the zoom by using CTRL-Shift + drag the mouse in the
2351("Hand mode" see right icons).<br>
2352
2353
2354<br>
2355
2356
2357<img style="width: 858px; height: 734px;" alt="Image" src="Images/numuEventHit.jpg"><br>
2358
2359
2360
2361
2362
2363<br>
2364
2365
2366
2367
2368
2369Using "Arrow Mode" (right icons) the user enter in picking mode to get
2370some ascii information on the object (or collection of objects selected
2371by CTRL-Shift + drag mouse).<br>
2372
2373
2374
2375
2376
2377<h3><a class="mozTocH3" name="mozTocId967005"></a>Batch mode</h3>
2378
2379
2380
2381
2382
2383In the batch mode, the user produces an event tuple (<span style="font-style: italic; color: rgb(255, 0, 0);">run/MEMPHYS.root</span>)
2384created via the AIDA abstract interfaces implementation by
2385OpenScientist. The I/O is performed in ROOT-I/O repackaged format that
2386can be analysed<br>
2387
2388
2389
2390
2391
2392<ul>
2393
2394
2395
2396
2397
2398  <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>
2399
2400
2401
2402
2403
2404</ul>
2405
2406
2407
2408
2409
2410<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
2411
2412
2413
2414
2415
2416  <tbody>
2417
2418
2419
2420
2421
2422    <tr>
2423
2424
2425
2426
2427
2428      <td style="background-color: rgb(204, 204, 204);">UNIX&gt; you are in the <span style="font-style: italic;">run</span> directory<br>
2429
2430
2431
2432
2433
2434UNIX&gt; (cd ../cmt ; gmake ROOT)</td>
2435
2436
2437
2438
2439
2440    </tr>
2441
2442
2443
2444
2445
2446 
2447 
2448 
2449 
2450 
2451  </tbody>
2452</table>
2453
2454
2455
2456
2457
2458&nbsp;&nbsp; <br>
2459
2460
2461
2462
2463
2464&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp; The difference between the two applications are XXX &nbsp;&nbsp;&nbsp; <br>
2465
2466
2467
2468
2469
2470<ul>
2471
2472
2473
2474
2475
2476  <li>either using interactive OnX session ()</li>
2477
2478
2479
2480
2481
2482</ul>
2483
2484
2485
2486
2487
2488<ul>
2489
2490
2491
2492
2493
2494  <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>
2495
2496
2497
2498
2499
2500</ul>
2501
2502
2503
2504
2505
2506The structure of the tuple for the moment is the following:<br>
2507
2508
2509
2510
2511
2512<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
2513
2514
2515
2516
2517
2518  <tbody>
2519
2520
2521
2522
2523
2524    <tr>
2525
2526
2527
2528
2529
2530      <td style="background-color: rgb(102, 255, 153);">&nbsp; std::string column = "int eventId, inputEvtId, interMode, vtxVol, "; <br>
2531
2532
2533
2534
2535
2536&nbsp; column += "ITuple vtxPos = { double x, y, z }, ";<br>
2537
2538
2539
2540
2541
2542&nbsp; column += "int nPart, leptonIndex, protonIndex, ";<br>
2543
2544
2545
2546
2547
2548&nbsp; column += "ITuple track = { int pId, parent, float timeStart, ";<br>
2549
2550
2551
2552
2553
2554&nbsp; column
2555+=&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
2556"ITuple direction = { double dx, dy, dz }, ";<br>
2557
2558
2559
2560
2561
2562&nbsp; column
2563+=&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
2564"double mass, pTot, ETot, ";<br>
2565
2566
2567
2568
2569
2570&nbsp; column
2571+=&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
2572"ITuple momentum&nbsp; = { double px, py, pz }, ";<br>
2573
2574
2575
2576
2577
2578&nbsp; column
2579+=&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
2580"ITuple startPos&nbsp; = { double&nbsp; x,&nbsp; y,&nbsp; z }, ";<br>
2581
2582
2583
2584
2585
2586&nbsp; column
2587+=&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
2588"ITuple stopPos&nbsp;&nbsp; = { double&nbsp; x,&nbsp; y,&nbsp; z }, ";<br>
2589
2590
2591
2592
2593
2594&nbsp; column
2595+=&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
2596"int startVol, stopVol ";<br>
2597
2598
2599
2600
2601
2602&nbsp; column +=&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; "}, ";<br>
2603
2604
2605
2606
2607
2608&nbsp; column += "int nHits, ITuple hit = { int tubeId, int totalPE, ITuple pe = { float time} }, ";<br>
2609
2610
2611
2612
2613
2614&nbsp; column += "int nDigits, double sumPE, ";<br>
2615
2616
2617
2618
2619
2620&nbsp; column += "ITuple digit = { int tubeId, double pe, time }";</td>
2621
2622
2623
2624
2625
2626    </tr>
2627
2628
2629
2630
2631
2632 
2633 
2634 
2635 
2636 
2637  </tbody>
2638</table>
2639
2640
2641
2642
2643
2644
2645
2646
2647
2648
2649
2650
2651
2652
2653
2654
2655</body>
2656</html>
Note: See TracBrowser for help on using the repository browser.