Gcard settings for daughter and procID
Gcard settings
Using the command:
gemc -help-all > gcard_options.txt
We find the command options for gemc:
Usage: -Option=<option>
Options:
> Option ACTIVEFIELDS: List of activated fields
> Option ALIGN_ZAXIS: Align z axis to a custom direction. Options:
- "beamp" aligns z axis to the beam directions specified by BEAM_P.
- "custom, theta*unit, phi*unit" aligns z axis to a custom direction, changes BEAM_P reference frame.
> Option ALLRAWS: Activates step-by-step output for system(s). Example: -ALLRAWS="DC, TOF"
> Option BANK_VERBOSITY: Controls Bank Log Output.
> Option BEAM_P: Beam particle, momentum, angles (in respect of z-axis).
Example: -BEAM_P="e-, 6*GeV, 15*deg, 20*deg" sets 6 GeV electrons 15 degrees in theta, 20 degrees in phi.
Use -BEAM_P="show_all" to print the list of G4 supported particles.
> Option BEAM_V: Primary Particle Vertex. Example: -BEAM_V="(0, 0, -20)cm".
> Option CATCH: Catch volumes matching the given string.
> Option CHECK_OVERLAPS: Checks Overlapping Volumes:
1. Check Overlaps at Construction Time
2. Check Overlaps based on standard lines grid setup
3. Check Overlaps by shooting lines according to a cylindrical pattern
> Option COSMICAREA: Target (x,y,z) location and radius of area of interest
> Option COSMICRAYS: Cosmic Generator. The model has a (cos(theta), p) probability function:
a^(b*cos(theta))/(c*p^2).
The COSMICRAYS option sets the parameters and the momentum range in the last two numbers.
By default the parameters are:
a = 55.6:
b = 1.04:
c = 64:
One can use the defaults or set the pars with the options:
example 1: -COSMICRAYS="default, 1, 10" will use the default parameterization, and momentum range [1-10] GeV
example 2: -COSMICRAYS="55, 2, 66, 3, 4" will set the parameterization, and momentum range [3-4] GeV
> Option DATABASE: Selects mysql Database.
> Option DAWN_N: Number of events to be displayed with the DAWN driver (also activate the DAWN driver).
> Option DBHOST: Selects mysql server host name.
> Option DBPORT: Select mysql server port.
> Option DBPSWD: mysql password
> Option DBUSER: Select mysql user name
> Option DC_MSTAG_R2: Mini Stagger for Region 2. Each layer will alternate +- |this value|
> Option DC_MSTAG_R3: Mini Stagger for Region 3. Each layer will alternate +- |this value|
> Option DEFAULT_MATERIAL: Default material for missing material field.
> Option DF: Selects Detector System and Factory type.
Example:
-DF="CTOF, MYSQL" selects the MYSQL factory for the detector CTOF
> Option ENERGY_CUT: Set an energy cut in MeV below which no particle will be tracked further. -1. turns this off.
> Option EVN: Initial Event Number.
> Option EXEC_MACRO: Executes commands in macro file.
> Option FIELD_DIR: Magnetic Field Maps Location.
> Option FIELD_VERBOSITY: Controls Electro-Magnetic Fields Log Output:
0: no log 1: field definitions log 2: max field details
> Option G4P_VERBOSITY: Controls Physical Volumes Construction Log Output.
> Option G4TRACK_VERBOSITY: Controls Geant4 Track Verbosity.
> Option GEN_VERBOSITY: Controls Geant4 Generator Verbosity.
> Option GEO_VERBOSITY: Controls Geometry Construction Log Output.
> Option GUIPOS: Specify the position of the QT display window. Default is at 50, 50
> Option GUI_VERBOSITY: Controls GUI Construction Log Output.
> Option HALL_DIMENSIONS: (x,y,z) semi-dimensions of the experimental Hall.
> Option HALL_FIELD: Magnetic Field of the Hall.
> Option HALL_MATERIAL: Composition of the Experimental Hall.
Air normal simulation
Air_Opt Simulation with Optical Physics
Vacuum (default)
> Option HIGH_RES: Use High Resolution Graphics
> Option HIT_PROCESS_LIST: Registers Hit Process Routines. Can register multiple experiments, separated by space, e.v. "clas12 aprime"
clas12. CLAS12 hit process routines (default)
aprime. aprime hit process routines
gluex. GlueX hit process routines
> Option HIT_VERBOSITY: Controls Hits Log Output.
> Option INPUT_GEN_FILE: Generator Input. Current availables file formats:
LUND.
example: -INPUT_GEN_FILE="LUND, input.dat" or -INPUT_GEN_FILE="StdHEP, darkphoton.stdhep"
> Option INTEGRATEDDGT: De-activates integrated digitized output for system(s). Example: -INTEGRATEDDGT="DC, TOF"
> Option INTEGRATEDRAW: Activates integrated geant4 raw output for system(s). Example: -INTEGRATEDRAW="DC, TOF"
> Option LOG_VERBOSITY: Controls General Log Verbosity.
> Option LUMI2_EVENT: Luminosity Particle 2 Parameters: number of Particles/Event, Time Between Bunches. The Time Window is specified with the LUMI_EVENT flag
Example: -LUMI2_EVENT="10000, 2*ns" simulate 10K particles per event at 2ns intervals.
> Option LUMI2_P: Luminosity Particle 2, momentum, angles (in respect of z-axis).
Example: -LUMI2_P="proton, 1*GeV, 25*deg, 2*deg" sets 1 GeV protons, 25 degrees in theta, 2 degrees in phi.
Use -LUMI2_P="show_all" to print the list of G4 supported particles.
> Option LUMI2_SPREAD_P: Spread Luminosity Particle 2 energy and angles (in respect of z-axis).
Example: -LUMI2_SPREAD_P="0*GeV, 10*deg, 20*deg" spreads 10 degrees in theta, 20 degrees in phi.
> Option LUMI2_SPREAD_V: Spread Luminosity Particle 2 Radius, Z position. Example: -SPREAD_V="(0.1, 10)cm".
> Option LUMI2_V: Luminosity Particle 2 Vertex. Example: -LUMI2_V="(0, 0, -20)cm".
> Option LUMI_EVENT: Luminosity Particle Parameters: number of Particles/Event, Time Window, Time Between Bunches
Example: -LUMI_EVENT="10000, 120*ns, 2*ns" simulate 10K particles per event distributed over 120 ns, at 2ns intervals.
> Option LUMI_P: Luminosity Particle, momentum, angles (in respect of z-axis).
Example: -LUMI_P="proton, 1*GeV, 25*deg, 2*deg" sets 1 GeV protons, 25 degrees in theta, 2 degrees in phi.
Use -LUMI_P="show_all" to print the list of G4 supported particles.
> Option LUMI_SPREAD_P: Spread Luminosity Particle energy and angles (in respect of z-axis).
Example: -LUMI_SPREAD_P="0*GeV, 10*deg, 20*deg" spreads 10 degrees in theta, 20 degrees in phi.
> Option LUMI_SPREAD_V: Spread Luminosity Particle Radius, Z position. Example: -SPREAD_V="(0.1, 10)cm".
> Option LUMI_V: Luminosity Particle Vertex. Example: -LUMI_V="(0, 0, -20)cm".
> Option MATERIAL_VERBOSITY: Controls Geant4 Material Verbosity.
> Option MAX_FIELD_STEP: Sets Maximum Acceptable Step in Magnetic Field (in mm).
> Option MAX_X_POS: Max X Position in millimeters. Beyond this the track will be killed
> Option MAX_Y_POS: Max Y Position in millimeters. Beyond this the track will be killed
> Option MAX_Z_POS: Max Z Position in millimeters. Beyond this the track will be killed
> Option MIRROR_VERBOSITY: Controls Mirrors Verbosity.
> Option N: Number of events to be simulated.
> Option NGENP: Max Number of Generated Particles to save in the Output.
> Option NO_FIELD: Sets Magnetic Field of a volume to zero. "all" means no magnetic field at all.
> Option OUTPUT: Type of output, output filename. Supported output: evio, txt. Example: -OUTPUT="evio, out.ev"
> Option PARAMETER_VERBOSITY: Controls Parameters Verbosity.
> Option PHYSICS: Physics List. The lists are modular and can be added together.
For example, a choice could be 'QGSC_BERT + STD + HP + Optical'
Possible Choices:
Hadronic:
- CHIPS
- FTFP_BERT
- FTFP_BERT_TRV
- FTF_BIC
- LHEP
- QGSC_BERT
- QGSP
- QGSP_BERT
- QGSP_BERT_CHIPS
- QGSP_BERT_HP
- QGSP_BIC
- QGSP_BIC_HP
- QGSP_FTFP_BERT
- QGS_BIC
- QGSP_INCLXX
Electromagnetic:
- STD
- EMV
- EMX
- EMY
- EMZ
- LIV
- PEN
> Option PHYS_VERBOSITY: Physics List Verbosity
> Option PHY_VERBOSITY: Controls Physics List Log Output.
> Option POLAR: Primary Particle polarization percentage and angles (in respect of z-axis).
Example: -POLAR="90, 90*deg, 270*deg" sets 90% polarization 90 degrees in theta, 270 degrees in phi.
Use -POLAR="show_all" to print the list of G4 supported particles.
> Option PRINT_EVENT: -PRINT_EVENT=N: Print Event Number every N events.
> Option PRODUCTIONCUT: Production cut for root, in mm
> Option QTSTYLE: Sets the GUI Style. Available options:
- QCleanlooksStyle
- QMacStyle
- QPlastiqueStyle
- QWindowsStyle
- QMotifStyle
> Option RANDOM: Random Engine Initialization. The argument (seed) can be an integer or the string TIME.
> Option RECORD_MIRRORS: Set to one if you want to save mirror hits in the output. Default is 0.
> Option RECORD_PASSBY: Set to one if you want to save zero energy hits in the output. Default is 0.
> Option RUNNO: Run Number. Controls the geometry and calibration parameters. Default is 1
> Option RUN_WEIGHTS: Simulate events based on run based conditions table (text file)
The text file must have two columns, run# and weight.
For example:
11 0.1
12 0.7
13 0.2
Will simulate 10% of events with run number 11 conditions, 70% run 12 and 20% run 13.
> Option SAVE_ALL_MOTHERS: Set to 1 to save mother vertex and pid infos in output. High Memory Usage. Default is 0.
> Option SCALE_FIELD: Scales Magnetic Field by a factor.
Usage:
-SCALE_FIELD="fieldname, scalefactor"
Example: -SCALE_FIELD="srr-solenoid, 0.5"
> Option SIGNALVT: Activates voltage (t) output for system(s). Example: -SIGNALVT="DC, TOF"
> Option SPREAD_P: Spread Primary Particle energy and angles (in respect of z-axis).
Example: -SPREAD_P="0*GeV, 10*deg, 20*deg" spreads 10 degrees in theta, 20 degrees in phi.
> Option SPREAD_V: Spread Primary Particle Radius, Z position. Example: -SPREAD_V="(0.1, 10)cm".
> Option STEER_BEAM: Steer the beam, and translate the vertex, of an StdHep file by the amount specified in Beam_P, Beam_V, Spread_V
> Option TSAMPLING: Sampling time of electronics (typically FADC)
> Option USE_GUI: GUI switch
0. Don't use the graphical interface
1. Qt GUI Interface.
2. OpenGL Stored mode (can't interact with picture; sliders works well)
3. OpenGL Immediate mode (can't interact with picture; sliders works well; slower than Stored mode)
4. QT OpenGL Stored mode (can interact with picture; sliders works but picture needs to be updated by clicking on it)
> Option VTRESOLUTION: Voltage versus time resolution, in ns
> Option gcard: gemc card file.
> Option geometry: Specify the size of the QT display window. Default '600x600'
Gcard file
We can construct an eg12.gcard with:
<gcard>
<!-- minumal detectors for HB tracking -->
<detector name="../../clas12/fc/forwardCarriage" factory="TEXT" variation="original"/>
<detector name="../../clas12/dc/dc" factory="TEXT" variation="ccdb"/>
<detector name="../../clas12/ftof/ftof" factory="TEXT" variation="java"/>
<option name="SCALE_FIELD" value="clas12-torus-big, -1"/>
<!--option name="OUTPUT" value="txt, Molr.txt"/-->
<option name="OUTPUT" value="evio, Molr.evio"/>
<!--option name="ALLRAWS" value="DC"/-->
<!--option name="INTEGRATEDDGT" value="DC"/-->
<option name="INTEGRATEDRAW" value="dc"/>
<!--option name="PHYSICS" value="FTFP_BERT + STD + Optical"/-->
<option name="PHYSICS" value="STD"/>
<!--option name="BANK_VERBOSITY" value="1"/-->
<option name="HIT_VERBOSITY" value="3"/>
<!--option name="LOG_VERBOSITY" value="1"/-->
<option name="G4TRACK_VERBOSITY" value="2"/>
<!--option name="G4P_VERBOSITY" value="1"/-->
<option name="GEN_VERBOSITY" value="3"/>
<option name="SAVE_ALL_MOTHERS" value="2"/>
<!-- Solenoid apparatus and field -->
<!--detector name="../../clas12/magnets/solenoid" factory="TEXT" variation="original"/-->
<!--option name="HALL_FIELD" value="clas12-solenoid"/-->
<!-- other CLAS detectors -->
<detector name="../../clas12/ec/ec" factory="TEXT" variation="original"/>
<detector name="../../clas12/ctof/ctof" factory="TEXT" variation="original"/>
<detector name="../../clas12/htcc/htcc" factory="TEXT" variation="original"/>
<detector name="../../clas12/pcal/pcal" factory="TEXT" variation="javageom"/>
<!--detector name="../../clas12/micromegas/micromegas" factory="TEXT" variation="original"/-->
<!-- Beamline material -->
<!--detector name="../../clas12/beamline/beamline" factory="TEXT" variation="ft"/-->
</gcard>
True Information Bank
| Variable Name | ID Number | Description |
|---|---|---|
| pid | 1 | ID of the FP [4] |
| mpid | 2 | ID of the mother of the FP |
| tid | 3 | Track ID of the FP |
| mtid | 4 | Track ID of the mother of the FP (if enabled) |
| otid | 5 | Track ID of the ancestor that generated the FP (if enabled) |
| trackE | 6 | Total energy of the FP |
| totEdep | 7 | Total energy deposited (in MeV) |
| avg_x | 8 | Average X position in the global reference system (in mm) |
| avg_y | 9 | Average Y position in the global reference system |
| avg_z | 10 | Average Z position in the global reference system |
| avg_lx | 11 | Average X position in the local reference system |
| avg_ly | 12 | Average Y position in the local reference system |
| avg_lz | 13 | Average Z position in the local reference system |
| px | 14 | x component of momentum of the FP (in MeV) |
| py | 15 | y component of momentum of the FP |
| pz | 16 | z component of momentum of the FP |
| vx | 17 | x component of the FP’s point of origin (in mm) |
| vy | 18 | y component of the FP’s point of origin |
| vz | 19 | z component of the FP’s point of origin |
| mvx | 20 | x component of the FP mother’s point of origin (if enabled) |
| mvy | 21 | y component of the FP mother’s point of origin |
| mvz | 22 | z component of the FP mother’s point of origin |
| avg_t | 23 | Average time |
| nsteps | 24 | Number of geant4 steps |
| procID | 25 | Process that created the FP. See section below. |
| hitn | 99 | Hit ID |