The clas12Tags are a series of clas12 specific tags of the GEMC source code and geometry, installed in /group/clas12/gemc.
For Q/A on CLAS12 simulations you can use the CLAS12 Discourse.
Current PRODUCTION version: 4.3.1, compatible with COATJAVA 6.3.1 and above. CLAS12 Software Environment version: 2.0
This points GEMC_DATA_DIR (geometry location) to /group/clas12/gemc/4.3.1
To load production tag 4.3.1:
source /group/clas12/packages/setup.csh
module load clas12/2.0
To run GEMC you can select one of the gcards in /group/clas12/gemc/gcards. For example:
gemc /group/clas12/gemc/gcards/rga-fall2018.gcard -N=nevents -USE_GUI=0
You can find here a collaction of gcards and YAML file for various CLAS12 experiments. The Run Configurations are also detailed on this page:
Check the off-site farms status, and submits simulations jobs.
CLAS12 Simulation Submission Portal.
You can scale magnetic fields using the SCALE_FIELD option. To do that copy the gcard somewhere first, then modify it. The gcard can work from any location. Example on how to run at 80% torus field (inbending) and 60% solenoid field:
<option name="SCALE_FIELD" value="TorusSymmetric, -0.8"/>
<option name="SCALE_FIELD" value="clas12-newSolenoid, 0.6"/>
By default the target cell is filled with liquid hydrogen by specifying the "lh2" target variation. To use liquid deuterium instead use the variation "lD2" instead.
To use an empty target instead, use the SWITCH_MATERIALTO option.
<option name="SWITCH_MATERIALTO" value="G4_lH2, G4_Galactic"/>
You can remove/comment out the <detector> tag in the gcard to remove a whole system.
To remove individual elements, use the existance tag in the gcard. For example, to remove the forward micromegas:
<detector name="FMT">
<existence exist="no" />
</detector>
GEMC is distributed using docker.
The GEMC detector api is located on the git repository.
The CLAS12 systems are kept in the detector git repository.
The CLAS12 geometry services are kept in the java geant4 factory git repository.
The clas12tags can be installed on top of an existing jlab installation. For 4.3.1 it's JLAB_VERSION 2.3:
- clone https://github.com/gemc/clas12Tags
- cd to the tag you want to use
- type
<scons -j4 OPT=1>
This will compile a gemc executable in that directory. Remember to use the full path to that executable when running gemc, otherwise the OS will pick up the default from the $GEMC env variable.
-
4.3.1:
- FTOF Time resolution updated based on data
- Option SAVE_SELECTED, RERUN_SELECTED to save RNG state for certain particles, detector
- Option SAVE_ALL_ANCESTORS to save complete particles hierarchy in output (evio2root also updated)
- gcards for rg-a different run-periods
- gcards for rg-b different run-periods
- ec, pcal digitization removed obsolete constants
- moved ftof shield in the correct position
- Option written in JSON format
- rga_fall2018 variations for: FTOF, EC, PCAL, CTOF geometry services
- default variation for DC geometry service
- ltcc variarions for different run periods
- added Geometry variation as a gcard option: DIGITIZATION_VARIATION, to be used by digitization routines.
- target position added to BMT, CTOF digitization position shift, read from CCDB using DIGITIZATION_VARIATION
- beam background merging is extended to all detectors
- FTOF and CTOF resolutions matched to data
-
4.3.2:
- FILTER_HADRONS option to write out events that have hit from specific hadrons in them
- Rich sector 4 passive materials
- FMT "bonus" variation with 3 layers
- RTPC for the Bonus experiment 🔜
- Target for the Bonus experiment 🔜
- Background merging memory check 🔜
- Hipo 4 output 🔜
- arbitrary number of sequential rotations in the detector definition 🔜
- BMT digitization with global coordinates instead of locals 🔜
- TOFs resolutions pars from CCDB 🔜
- Move LUND vertex based on gcard entry 🔜
- Time propagation in DC digitization 🔜
- Rich sector 4 digitization 🔜
- 3D Cylindrical map field 🔜
- Detector time signal shift to match data 🔜
-
4.4.0:
- geant4 10.5 support
-
4.3.0: COATJAVA: 5.7.4, JLAB_VERSION: 2.3:
- Updated DC geometry using latest survey (May 18 Entry in DB)
- Fixed bug that prevented material name from being displayed in the GUI
- 3d cartesian field map support
- new geant4 version: 10.4.p02
- 51 micron tungsten shield (for bst) surrounding the target
- calorimeters: reading ecal effective velocity from CCDB
- change htcc time offset table to use the same used in reconstruction
- Tony Forest: Added polarized target geometry/material and cad volume.
-
4a.2.4: COATJAVA: 5b.6.1, JLAB_VERSION: 2.2:
- Use new torus field map
- FMT shift by 8mm
- use run number 11 as default in the gcard
- FMT background hits
- production cut set for individual volumes in the options
- new geant4 version
- env variable "GEMC_DATA_DIR" as a base path in the gcard (gcard is now portable to other systems)
- bst tungsten and heat shield
- LTCC Nose CAD model
- magnetic field map displacements and rotations with command line options
- FAST MC mode 10, 20 output fixed
- new solenoid field map used by default (scaled by -1)
-
4a.2.3 (compatible with COATJAVA 5b.3.3): Same as 4a.2.2 with in addition:
- ctof, ftof banks: 1 ADC output / pmt instead of ADCL/ADCR for a single paddle)
- CTOF, FTOF Paddle to PMT digitization for FADC
- background merging algorithm framework
- background merging algorithm implementation in digitization: DC, BST and MM.
- Correct field geant4-caching
- Solenoid integration method: G4ClassicalRK4 to fix some geant4 navigation issues in the field. Slower but more reliable (should have less crashes)
- SYNRAD option to activate synchrotone radiation in vacuum (SYNRAD=1) or any material (SYNRAD=2)
- dc gas material changed to 90% Ar, 10% G4_CARBON_DIOXIDE.
- RF shift from target center: added option RFSTART: Radio-frequency time model. Available values 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
-
4a.2.2: Same as 4a.2.1 with in addition:
- target from CAD
- htcc wc invisible
- no transparency in MM
- threshold mechanism
- rotate LUND bank to flat
- final beamline configuration
- LTCC sector 4 removed
- LTCC sector 1 removed
- DC: Removed unused lines and calculation of smeared doca
- generator user information are now in two dedicate banks: user header (TAG 11), and user particle infos (TAG 22)
- MM overlaps with target fixed
- New numbering scheme for CTOF, CND
-
4a.2.1: Same as 4a.2.0 with in addition:
- fixes to CAD modeling of both the beamline and the torus
- forward carriage volume fixed to accomodate beamline and shielding
- fixed CND / CTOF overlaps
- updated latest micromegas geometry
- MM: Adjust transverse diffusion and ionization potential
- updated latest BST
- 3 + 3 configuration BST + MM
- new vacuum pipe
- new shield downsttream of the torus
- LTCC box hierarchy fixed
- LTCC frame is CAD + copies
- corrected mini-stagger values for DC
- Added TDC calibration constants to ec,pcal hitprocess
- FADC mode 1 (still tuning it to make it exactly like Serguei DAQ)
- reading tdc_conv for ctof from database
- fixed an issue with the header bank where the LUND info index was not correct
-
4a.2.0: Same as 4a.1.0 with in addition:
- use JLAB_VERSION 2.1, with new mlibrary
- Micromegas: updated geometry and digitization
- DC: realistic time to distance function, reading constants from CCDB
- DC: ministagger for DC region 3: "even closer" layers 1,3,5: +300um, SL 2,4,6: -300um
- LTCC: Reading CCDB SPE calibration constants
- LTCC: Smearing ADC based on calibration constants
- CTOF javacad instead of cad (should be indentical)
- Fixed smeared infor in generated summary for FASTMC mode
- improved/fixed CND digitization routine
- updated RF timing (mlibrary)
- BST+MM: using 3+3 configurations (no FMT)
-
4a.1.0: Same as 4a.0.2 with in addition:
- fixed a bug that affect output file size
- fixed bug that affected multiple cad imports
- added micromegas geometry and hit processes
- RF output correct frequency in the clas12 gcard
- updated FT geometry and hit process
- updated ftof geometry
- added reading of FTOF reading of tdc conversion constants from the database
- check if strip_id is not empty in bmt_ and fmt_strip.cc, otherwise fill it.
-
4a.0.2: Same as 4a.0.1 with in addition:
- full (box, mirrors, pmts shields and WC) LTCC geometry
- LTCC hit process routine.
-
4a.0.1: Same as 4a.0.0 with in addition:
- FTOF geometry fix
-
4a.0.0: KPP configuration:
- Fixes in source and hit process for FTOF
- added EC gains.
- Java geometry uses now coatjava 3.
- Database fixed for DC geometry.
- Linear time-to-distance for DC.
- CTOF in the KPP position configuration in the new kpp.gcard.
-
3a.1.0: same as 3a.0.2 with in addition:
- DC time-to-distance implementation.
-
3a.0.2: same as 3a.0.1 with in addition:
- CND fix.
-
3a.0.1: same as 3a.0.0 with in addition:
- ctof has status working.
-
3a.0.0: git commit d3a5dc1, Dec 2 2016. Includes:
- FTOF and CTOF paddle delays from CCDB
- CTOF center off-set.
The default configuration for the first experiment is with "FTOn" (Figure 1, Left): complete forward tagger is fully operational. The other available configuration is "FTOff" (Figure 1, Right): the Forward Tagger tracker is replaced with shielding, and the tungsten cone is moved upstream.
The simulations in preparation of the first experiment should use the default version FTOn. FTOff will be used only by experts for special studies in preparation for the engineering run.
Figure 1. Left: FT On configuration: Full, OperationalForward Tagger. Right: FT Off configuration: FT Tracker replaced by shielding, Tungsten Cone moved upstream, FT if turned off.
To change configuration from FTOn to FTOff, replace the keywords and variations from:
<detector name="ft" factory="TEXT" variation="FTOn"/>
<detector name="beamline" factory="TEXT" variation="FTOn"/>
<detector name="cadBeamline/" factory="CAD"/>
to:
<detector name="ft" factory="TEXT" variation="FTOff"/>
<detector name="beamline" factory="TEXT" variation="FTOff"/>
<detector name="cadBeamlineFTOFF/" factory="CAD"/>
You can specific a different tag in the environment command line:
source /group/clas12/gemc/environment.csh <tag>
-
create new tag dir
-
cp experiments and gcard form old tag to keep track of new changes
-
make links from ../gcards
-
change environment.csh to point to the new tag
-
copy $GEMC to source and clean up. From the tag:
- cd $GEMC
- scons -c
- cd -
- cp -r $GEMC source ; cd source ; rm -rf .git* ; rm .sconsign.dblite
- find ./ -type f -name .DS_Store -exec rm -f {} ;
- rm -rf api ; cp -r /opt/projects/gemc/api . ; cd api ; rm -rf .git*
-
change gemc.cc tag to new tag