How the geometry is defined

Each geometry is a subdirectory of hps-detectors/detectors, and must contain the following:

• compact.xml: defines the geometry in terms of detector modules, each of which corresponds to classes in GeomConverter - used by GeomConverter and LCSim
• detector.properties: other (non-geometry) detector parameters
• SamplingFractions: sampling fractions for each calorimeter
• LCDD file for the geometry: generated from the compact.xml - used by SLIC

Adding a new detector

• make a subdirectory of hps-detectors/detectors; name of the subdirectory is the name of the detector
• add name of the detector to detectors/taglist.txt
• copy from another detector: compact.xml, detector.properties, SamplingFractions
• in compact.xml: change name and comment in <info> block
• in detector.properties: change name, change ConditionsReader if necessary (TestRunConditionsReader for 2012 test run, HpsConditionsReader for 2014 run) - both of these lines are required
• use GeomConverter to make LCDD file: see below

Using GeomConverter to make detector descriptions

Detector conversion can be done using hps-detectors/Makefile, but you need to set the environment variable GEOMCONVERTER to point to the GeomConverter jar:

export GEOMCONVERTER=/nfs/slac/g/hps/meeg/GeomConverter/target/GeomConverter-2.5-SNAPSHOT-bin.jar

Run "make" in hps-detectors to get a full list of options, but usually you'll use this to convert a single detector (can ask for heprep, lcdd, gdml, vrml, etc.):

make DETECTOR=HPS-Proposal2014-v2 lcdd

Viewing LCDD

The LCDD file can be viewed directly using SLIC:

slic -g mygeom.lcdd

This puts you in an interactive Geant4 session; here is a suggested series of commands (from How do I visualize with OpenGL):

/vis/scene/create
/vis/scene/add/volume
/vis/open OGLSX
/vis/scene/refresh

Viewing GDML

ROOT can view GDML, but not tessellated volumes: How do I visualize with ROOT

Viewing HepRep

WIRED can view HepRep files and can be run as a JAS3 plugin.