README CPPsim

Jan.  9, 2014 David Lawrence
Jan. 23, 2015 Updated DL
Apr.  3, 2015 Updated DL

To build this, create a build directory parallel to this one
and run the "run_cmake" script from there followed by "make"


> cd ../
> mkdir CPPsim-build
> cd CPPsim-build
> ../CPPsim/run_cmake
> make

WARNING: If you run the "run_cmake" script inside the CPPsim directory
it will leave a file named "CMakeCache.txt" there. This will interfere
with generating the Makefile and CMakeFiles in the build directory. Make
sure the file CPPsim/CMakeCache.txt does not exist before running 
"run_cmake"!

WARNING: The sim-recon environment variables (e.g. HALLD_HOME) at the
time "run_cmake" is run are apparently captured and written into
the generated make files. This means if you change them, you will need
to regenerate them. Since cmake is apparently not smart enough to
detect this type of change, you must remove the generated makefiles
before re-running "run_cmake".


To make the GDML file from a HDDS geometry:

> cd $HDDS_HOME/$BMS_OSNAME/src
> root -l hddsroot.C
root [1] gGeoManager->Export("main_HDDS.gdml")



To run CPPsim:

1. go to a working directory and make a link to
   the CPPsim exectuable in the CPPsim-build
   directory

2. copy the main_HDDS.gdml file into the working directory

3. Copy a control.in file into the working directory

4. run CPPsim:

    > ./CPPsim