Revision as of 22:14, 17 July 2014

general info

SoLID detector simulation is based on Geant4 based simulation framework GEMC http://gemc.jlab.org

"solid_gemc" under SoLID repository https://jlabsvn.jlab.org/svnroot/solid/solid_gemc2 has files for SoLID detector configuration, field, scripts etc.

You need both GEMC and solid_gemc to do SoLID detector simulation, refer to the installation section

quick start

setup

All env variables required are setup by source a file "set_solid"

make sure you meet the requirement here

The example below demonstrates how to setup in various cases.

on ifarm with official installation of framework and SoLID repository (demonstration)

The fastest way to see what the simulation look like. You don't need to install any thing, but you can't modify anything either.

login into ifarm with your account
source /home/zwzhao/solid/solid_svn/solid/set_solid
folow "run" to run it

on ifarm with official installation of framework and your SoLID repository (recommended)

You don't need to install the framework, you can modify simulation configuration. This is the best way to run simulation on ifarm and farm nodes. This is recommend way to compare result and produce results.

cd your_choice_of_solid_repo_path
svn co https://jlabsvn.jlab.org/svnroot/solid
cd solid
edit file set_solid by following the instruction within, you only need to change SoLID_GEMC
source set_solid
cd $SoLID_GEMC/field
wget http://hallaweb.jlab.org/12GeV/SoLID/download/field/gemc2/solenoid_CLEOv8.dat
wget http://hallaweb.jlab.org/12GeV/SoLID/download/field/gemc2/solenoid_ptarget.dat
folow "run" to run it

on any machine with your installation of framework and your SoLID repository (expert)

This gives you maximum freedom to use any version of framework and ability to work on your local machine, And allow you to modify anything. This is the way to run on your local machine.

install the framework by following installation instruction
cd your_choice_of_solid_repo_path
svn co https://jlabsvn.jlab.org/svnroot/solid
cd solid
edit file set_solid by following the instruction within
source set_solid
cd $SoLID_GEMC/field
wget http://hallaweb.jlab.org/12GeV/SoLID/download/field/gemc2/solenoid_CLEOv8.dat
wget http://hallaweb.jlab.org/12GeV/SoLID/download/field/gemc2/solenoid_ptarget.dat
folow "run" to run it

run

Once you complete the setup procedure, do the following to run

cd $SoLID_GEMC/script
solid_gemc solid_PVDIS.gcard or  solid_gemc solid_PVDIS_simple.gcard
solid_gemc solid_SIDIS_He3.gcard or  solid_gemc solid_SIDIS_He3_simple.gcard
solid_gemc solid_SIDIS_NH3.gcard or  solid_gemc solid_SIDIS_NH3_simple.gcard

how to run

run "gemc -help" to see running option

read the tutorials on the main GEMC website here

another tutorialGEMC tuturial on 2014/03/06

Use examples in study section to see how to create geometry, store hit and analysis results

geometry

source set_solid
cd $SoLID_GEMC/geometry
read fle "changelog"
edit perl file to modify geometry, then run commad below to generate new geometry txt files
./solid_PVDIS_simple.pl config_solid_PVDIS_simple.dat
./solid_PVDIS.pl config_solid_PVDIS.dat
./solid_SIDIS_He3_simple.pl config_solid_SIDIS_He3_simple.dat
./solid_SIDIS_He3.pl config_solid_SIDIS_He3.dat

field map

http://hallaweb.jlab.org/12GeV/SoLID/download/field/gemc2/solenoid_CLEOv8.dat
http://hallaweb.jlab.org/12GeV/SoLID/download/field/gemc2/solenoid_ptarget.dat

output

Direct output are txt or evio

use text output to debug

convert evio to xml by

evio2xml output.evio

covert evio to root by

evio2root -INPUTF=output.evio