| 1 | $Id: README,v 1.16 2009/05/13 08:32:36 gbarrand Exp $ |
|---|
| 2 | ------------------------------------------------------------------- |
|---|
| 3 | |
|---|
| 4 | ========================================================= |
|---|
| 5 | Geant4 - an Object-Oriented Toolkit for Simulation in HEP |
|---|
| 6 | ========================================================= |
|---|
| 7 | |
|---|
| 8 | AnaEx01 |
|---|
| 9 | ------- |
|---|
| 10 | |
|---|
| 11 | This example shows the usage of histogram and tuple manipulations using |
|---|
| 12 | an AIDA compliant system. In this example, all analysis manipulations |
|---|
| 13 | (attaching an AIDA implementation, histo booking, filling, saving |
|---|
| 14 | histos in a file, etc...) are concentrated in one class : |
|---|
| 15 | AnaEx01AnalysisManager. |
|---|
| 16 | |
|---|
| 17 | To include the analysis code, the environment variable |
|---|
| 18 | G4ANALYSIS_USE |
|---|
| 19 | must be defined before doing "make". If not, at run time, no |
|---|
| 20 | histograms and file will be created. |
|---|
| 21 | |
|---|
| 22 | For example, a typical session from a UNIX csh flavoured shell is : |
|---|
| 23 | csh> source <aida tool>/aida-setup.csh |
|---|
| 24 | csh> setenv G4ANALYSIS_USE 1 |
|---|
| 25 | csh> make |
|---|
| 26 | csh> ${G4BIN}/${G4SYSTEM}/AnaEx01 |
|---|
| 27 | After execution, a file AnaEx01.aida should have been created. |
|---|
| 28 | Someone can change the default file format by changing the |
|---|
| 29 | value of the std::string variable format in the AnaEx01AnalysisManager |
|---|
| 30 | constructor : |
|---|
| 31 | // File format : |
|---|
| 32 | std::string format("xml"); |
|---|
| 33 | //std::string format("hbook"); |
|---|
| 34 | //std::string format("root"); |
|---|
| 35 | |
|---|
| 36 | Working with the OpenScientist packages : |
|---|
| 37 | --------------------------------------- |
|---|
| 38 | To create the analysis file, you can install the light "osc_batch" |
|---|
| 39 | binary kit (See http://OpenScientist.lal.in2p3.fr ). For example |
|---|
| 40 | from a UNIX sh flavoured shell : |
|---|
| 41 | sh> cd /usr/local |
|---|
| 42 | sh> <arrange to be su> |
|---|
| 43 | sh> <get an osc_batch binary kit> |
|---|
| 44 | sh> unzip -q osc_batch<platform>.zip |
|---|
| 45 | sh> cd osc_batch/<version> |
|---|
| 46 | sh> ./install |
|---|
| 47 | |
|---|
| 48 | Then you build the example with : |
|---|
| 49 | <create another terminal> |
|---|
| 50 | csh> source /usr/local/osc_batch/<version>/aida-setup.csh |
|---|
| 51 | csh> <source setup Geant4> |
|---|
| 52 | csh> setenv G4ANALYSIS_USE 1 |
|---|
| 53 | csh> cd <G4_install_path>/examples/extended/analysis/AnaEx01 |
|---|
| 54 | csh> make |
|---|
| 55 | csh> ${G4BIN}/${G4SYSTEM}/AnaEx01 |
|---|
| 56 | |
|---|
| 57 | Depending of the file format, you can visualize the produced |
|---|
| 58 | file with various interactive tools (CERN/PAW, CERN/ROOT, jas). |
|---|
| 59 | But if installing also an OpenScientist osc_vis binary kit, |
|---|
| 60 | you shall be able to visualize all formats by using |
|---|
| 61 | the osc-plot program. To install an osc_vis kit : |
|---|
| 62 | sh> cd /usr/local |
|---|
| 63 | sh> <arrange to be su> |
|---|
| 64 | sh> <get an osc_vis binary kit> |
|---|
| 65 | sh> unzip -q osc_vis<platform>.zip |
|---|
| 66 | sh> cd osc_vis/<version> |
|---|
| 67 | sh> ./install |
|---|
| 68 | Then to browse the AnaEx01.<format> file (for exa from an UNIX sh shell) : |
|---|
| 69 | <create another terminal> |
|---|
| 70 | sh> . /usr/local/osc_vis/<version>/setup.sh |
|---|
| 71 | sh> <setenv DISPLAY if needed> |
|---|
| 72 | sh> osc-plot AnaEx01.[aida,root,hbook] |
|---|
| 73 | |
|---|
| 74 | The OpenScientist URL is : |
|---|
| 75 | http://OpenScientist.lal.in2p3.fr. |
|---|
| 76 | |
|---|
| 77 | Note that OpenScientist is installed on CERN/lxplus under : |
|---|
| 78 | /afs/cern.ch/sw/contrib/[osc_batch,osc_vis]. |
|---|
| 79 | |
|---|
| 80 | |
|---|
