GEMC options

Accounts for detector thresholds
This flag can be used by the digitization routines to account for hardware status

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

Number of events to be displayed with the DAWN driver (also activate the DAWN driver).

Accounts for detector inefficiency
This flag can be used by the digitization routines to account for hardware status

Timestamp to be used in digitization routines

Common variation to be used in the digitization routines

Set an energy cut in MeV below which no particle will be tracked further. -1. turns this off.

Initial Event Number.

Executes commands in macro file.

Specify the position of the QT display window. Default is at 50, 50 

Accounts for hardware status
This flag can be used by the digitization routines to account for hardware status

Use High Resolution Graphics

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

Max X Position in millimeters. Beyond this the track will be killed

Max Y Position in millimeters. Beyond this the track will be killed

Max Z Position in millimeters. Beyond this the track will be killed

Sets the GUI Style. Available options: 
      - QCleanlooksStyle 
      - QMacStyle 
      - QPlastiqueStyle 
      - QWindowsStyle 
      - QMotifStyle

Random Engine Initialization. The argument (seed) can be an integer or the string TIME.

Set to one if you want to save mirror hits in the output. Default is 0.

Set to one if you want the optical photons to produce hits. Default is 0.

Set to one if you want to save zero energy hits in the output. Default is 0.

Rerun saved events  arg is list of run #[, directory]

Radio-frequency signal. This are a minium of 2 parameters for one given RF signal:
      1. radioFrequency period T (ns). The frequency in GHz is 1/T 
      2. radioInterval (in number of bunches): distance between RF signals, or pre-scale factor.
     Any additional parameter (in ns) will add an RF signal with that time distance from the original.
     Example1:  4.008 (0.2495 GHz) RF signal, 1 output, output frequency is 50 bunches: 
      -RFSETUP="4.008, 50" 
     Example2: two (0.5 GHz) and 2 RF signals, separated by 30 ns and both output frequency is 80 bunches: 
      -RFSETUP="2.004, 80, 30" 
     By default the RFSETUP is set to 'clas12': the above constants are to be read from the CCDB database, using as run: RUNNO and as variation the one specified in the option DIGITIZATION_VARIATION.

Radio-frequency time model. Available options are:
      "eventVertex, 0, 0, 0" (default): the RF time is the event start time + the light time-distance of the first particle from the point (0,0,0)
      "eventTime".....................: the RF time is identical to the event start time

Run Number. Controls the geometry and calibration parameters. Default is 1

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.

Set to 1 to save all ancestors of hits. High Memory Usage. Default is 0.

Set to 1 to save mother vertex and pid infos in output. High Memory Usage. Default is 0.
                       2: saves in LUND format any particle that generate hits
                       3: same as 2 but if a track’s mother also produced hits, only the mother is saved so the hits are not double counted

 GUI switch
      0.  Don't use the graphical interface
      1.  OGLSQt (OGL, OGLS, OGLSQt)
      2.  OGLIQt (OGLI, OGLIQt) 

gemc card file.

Specify the size of the QT display window. Default '600x600' 

List of activated fields

Displace Magnetic Field map from the lab origin.
      Usage:
      -DISPLACE_FIELDMAP="fieldname, dx*unit, dy*unit, dz*unit"
      Example: -DISPLACE_FIELDMAP="srr-solenoid, 3.5*mm, 0*mm, 0*mm"

List of activated fields

Magnetic Field Maps Location. 

Mapped field minimum step, integration method, interpolation

      Usage:
      -FIELD_PROPERTIES="fieldname, minStep, integralAlgorithm, (interpolationMethod)"

      Example: -FIELD_PROPERTIES="srr-solenoid, 1*mm, G4ClassicalRK4, linear"

      Available Integration Methods:
       - G4CashKarpRKF45: Fift Order Range Kutta, for very smooth fields
       - G4ClassicalRK4: Fourth Order Range Kutta. Robust for every field.
       - G4SimpleHeum: Third order stepper.
       - G4SimpleRunge: Simplified (second order) Range Kutta (faster).
       - G4ImplicitEuler: Second order stepper, for faster varying fields.
       - G4ExplicitEuler: First order stepper, for rough fields.
       - G4HelixImplicitEuler: Second order, specialized for helix-like trajectories.
       - G4HelixExplicitEuler: First order, specialized for helix-like trajectories.
       - G4HelixSimpleRunge: Second order Range Kutta, specialized for helix-like trajectories.
       - G4NystromRK4: provides accuracy near that of G4ClassicalRK4 with a significantly reduced cost in field evaluation.

       Available Interpolation Methods:
       - none: closest grid point.
       - linear: linear interpolation.

       Note: specifying interpolation method is optional. "linear" is the default.

Sets Geant4 Magnetic Field Cache Size (in mm) 

Magnetic Field of the Hall. 

Sets Maximum Acceptable Step in Magnetic Field (in mm).

Sets Magnetic Field of a volume to zero. "all" means no magnetic field at all. 

Physics List Verbosity

Rotate Magnetic Field map.
      Usage:
      -ROTATE_FIELDMAP="fieldname, alpha*unit, beta*unit, gamma*unit"
      Example: -ROTATE_FIELDMAP="srr-solenoid, 0*deg, 0*deg, 2*deg"

Scales Magnetic Field by a factor.
      Usage:
      -SCALE_FIELD="fieldname, scalefactor"
      Example: -SCALE_FIELD="srr-solenoid, 0.5"

Selects Detector System and Factory type. 
      Example:
        -DF="CTOF, MYSQL"  selects the MYSQL factory for the detector CTOF

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.

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.
      An optional string "KE" can be appended to this option to specify Kinetic energy instead of momentum.

 Randomizes the vertexes using, in order: X, Y shifts, DX DY sigmas, elippse phi orientation
     By default the randomization is relative to the LUND vertex values. 
     If the sixth argument "reset" is given, the vertexes are relative to (VX, VY) = (0, 0) 
      example 1: -BEAM_SPOT="2*cm, 3*cm, 0.2*cm, 0.1*cm, 22*deg" 
       This randomizes the vertexes around the original LUND values, but shifted by (VX, VY) = (2, 3)cm 
       A gaussian with sigmas (SX, SY) = (0.2, 0.1)cm are used, rotated 22 degrees around z.
      example 2: -BEAM_SPOT="2*cm, 3*cm, 0.2*cm, 0.1*cm, 22*deg, reset" 
       This randomizes the vertexes around (VX, VY) = (2, 3)cm 
       A gaussian with sigmas (SX, SY) = (0.2, 0.1)cm are used, rotated 22 degrees around z.

Primary Particle Vertex. Example: -BEAM_V="(0, 0, -20)cm". 

Target (x,y,z) location and radius of area of interest

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 

Starting Event Number

Generator Input. Current availables file formats:
      LUND. 
      example: -INPUT_GEN_FILE="LUND, input.dat" or -INPUT_GEN_FILE="StdHEP, darkphoton.stdhep" 

Primary particle is an ion. Sets Z, A and Charge of the primary particle. Setting the charge is optional. 
      Example 1: -ION_P="6 12" sets the Z to 6, A to 12. Charge will be Z. 
      Example 2: -ION_P="6 12 -4" sets the Z to 6, A to 12, and charge to -4. 
      Notice: BEAM_P still sets the particle momentum, and its type must be GenericIon

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. 
      If the word flat is added to the option, theta is flat instead of cos(theta). 

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. 
      If the word flat is added to the option, theta is flat instead of cos(theta). 

ASCII file to merge background hits
      example: -MERGE_BGHITS="background.dat" 

LUND Input file to merge background events
      example: -MERGE_LUND_BG="background.dat" 

Number of events to be simulated.

Max Number of Generated Particles to save in the Output.

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.

Calculate propogation time of detached vertex events and fire them at this later time. 
         0: Off (default)
         1: On

 Randomizes the z vertexes using, in order: Z shift, DZ sigma
     By default the randomization is relative to the LUND vertex values. 
     If the third argument "reset" is given, the vertexes are relative to VZ=0 
      example 1: -RANDOMIZE_LUND_VZ="-3*cm, 5*cm" 
       This randomizes the z vertex by plus-minus 5cm around the original LUND values and shift it by -3cm 
      example 1: -RANDOMIZE_LUND_VZ="-3*cm, 5*cm, reset" 
       This randomizes the z vertex by 5cm around vz = 0 and shift it by -3cm 

Randomizes the x, y generated partice vertexes within an ellipse defined by the x, y radii, around their values.
     If the third argument "reset" is given, the vertexes are relative to (VX, VY) = (0, 0) 
      example 1: -RASTER_VERTEX="2*cm, 3*cm" 
       This randomizes the vertexes around the original LUND values. 
      example 2: -RASTER_VERTEX="2*cm, 3*cm, reset" 
       This randomizes the vertexes around (VX, VY) = (0, 0). 

Shift Generator File tracks vertices.
      example: -SHIFT_LUND_VERTEX="(0, 0, -3)cm" 

Skip N events

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. 
      If the word flat is added as last argument to the option, theta is flat instead of cos(theta). 
      An optional argument "KE" can be appended to this option to specify Kinetic energy instead of momentum.

Spread Primary Particle Radius, Z position. Example: -SPREAD_V="(0.1, 10)cm". 

Steer the beam, and translate the vertex, of an StdHep file by the amount specified in Beam_P, Beam_V, Spread_V 

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. 

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.

Spread Luminosity Particle 2 Radius, Z position. Example: -SPREAD_V="(0.1, 10)cm". 

Luminosity Particle 2 Vertex. Example: -LUMI2_V="(0, 0, -20)cm". 

Luminosity Particle Parameters: number of Particles/Event, Time Window, Time Between Bunches, Primary Beam Particle Time (optional)
            Example: -LUMI_EVENT="10000, 120*ns, 2*ns, 45*ns" simulate 10K particles per event distributed over 120 ns, at 2ns intervals, with beam particle time set to last bunch before 45 ns. 

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.

Spread Luminosity Particle Radius, Z position. Example: -SPREAD_V="(0.1, 10)cm". 

Luminosity Particle Vertex. Example: -LUMI_V="(0, 0, -20)cm". 

Changes a volume material. Usage: -CHANGEVOLUMEMATERIALTO="volume, new material" 

Default material for missing material field.

Composition of the Experimental Hall. 
            Air normal simulation
            Air_Opt Simulation with Optical Physics
            Vacuum (default)

Switches a material for another. Usage: -SWITCH_MATERIALTO="old, new" 

Selects mysql Database.

Selects mysql server host name.

Select mysql server port.

mysql password

Select mysql user name

Activates step-by-step output for system(s). Example: -ALLRAWS="DC, TOF"

Activates electronic noise routines for system(s). Example: -ELECTRONICNOISE="dc, ftof"

If set to 1, do not write events if there are no hadrons. Otherwise if 
nonzero write only events having a hadron with matching ID. For example
 -FILTER_HADRONS=2212 for protons

If set to non-0, do not write events if there are no high mom hit. Otherwise if 
nonzero write only events having a hit with mom > FILTER_HIGHMOM. For example
 -FILTER_HIGHMOM=1 for mom > 1MeV

If set to 1, do not write output if there are no hits in the detectors

If set to 1, filters out variables with no valuable info in the output.

De-activates integrated digitized output for system(s). Example: -INTEGRATEDDGT="DC, TOF"

To acticate the true info for all sensitive detectors:  -INTEGRATEDRAW="*"

Type of output, output filename. Supported output: evio, txt. Example: -OUTPUT="evio, out.ev"

Save events with selected hit types
  arg is list of id, pid, low limit, high limit, variable[, directory]
  e.g. 7xx10000, 11, 0.0*MeV, 2000*MeV, trackE, /.

Activates voltage (t) output for system(s). Example: -SIGNALVT="DC, TOF"

Skips hits that are rejected by digitization. Default: yes (1)

Sampling time of electronics (typically FADC)

Voltage versus time resolution, in ns

Force muon radiative decay

  Physics List. The list is modular. 

     For example, 'STD' would only activate the standard electromagnetic processes, while
     'QGSC_BERT + STD + HP + Optical' would also activate high precision hadronic and optical physics.

     For a complete list, see http://geant4.cern.ch/support/physicsLists/referencePL/referencePL.shtml'

     Available modules:

      Hadronic: 
      The FTF model is based on the FRITIOF description of string excitation and fragmentation.
      - FTFP_BERT
      - FTFP_BERT_HP
      - FTFP_BERT_TRV
      - FTF_BIC

      QGSP is the basic physics list applying the quark gluon string model for high  energy interactions of protons, neutrons, pions, and Kaons and nuclei.
      - QGSC_BERT
      - QGSP_BERT_HP
      - QGSP_BIC
      - QGSP_BIC_HP
      - QGSP_FTFP_BERT

      Electromagnetic: 
      - STD
      - EMV: Designed for HEP productions. Production thresholds are enabled on secondary particles for all EM processes.
      - EMX: Designed for HEP productions. Alternative G4Generator2BS angular generator is used for the bremsstrahlung process.
      - EMY: Higher accuracy of electrons, hadrons and ion tracking without magnetic field
      - EMZ: Higher accuracy of electrons, hadrons and ion tracking. Use the most accurate standard and low-energy models.
      - LIV: Higher accuracy of electrons, hadrons and ion tracking without magnetic field. Livermore model on top of emstandard_opt4.
      - PEN: Higher accuracy of electrons, hadrons and ion tracking without magnetic field. Penelope model on top of emstandard_opt4.

 Adds Synchrotron Radiation     Possible values:
     0: no Synchrotron Radiation (default)
     1: vacuum Synchrotron Radiation 
     2: material Synchrotron Radiation 

Activate FASTMC Mode. Possible values: 

       0: No FASTMC (default).
       1: Disable secondaries, disable hit processes.
       2: Disable all physics but transportation, disable hit process.
       10: Disable secondaries, hit processes are enabled.
       20: Disable all physics but transportation, hit processes are enabled.

(x,y,z) semi-dimensions of the experimental Hall.

Production cut for root, in mm

Production cut for volumes (separated by commas), in mm
      Example: "outerMount, taggerInnerShield, 50" will set the production cut for the volumes outerMount and taggerInnerShield to 5cm

Removes a volumes sensitivity. Usage: -REMOVESENSITIVITY=volumename1, volumename2, ... 

Controls Bank Log Output.

Catch volumes matching the given string.

Controls Event Log Output.

Controls Electro-Magnetic Fields Log Output:
  0: no log  1: field definitions log  2: max field details

Controls Physical Volumes Construction Log Output.

Controls Geant4 Track Verbosity.

Controls Geant4 Generator Verbosity.

Controls Geometry Construction Log Output.

Controls GUI Construction Log Output.

Controls Hits Log Output. 

Controls General Log Verbosity.

Controls Geant4 Material Verbosity.

Controls Mirrors Verbosity.

Controls Parameters Verbosity.

Controls Physics List Log Output.

-PRINT_EVENT=N: Print Event Number every N events.