Geometry Differential Framework v0.1

STAR Baseline Analysis of the Simulation Environment

Produces a set of material differential plots for the STAR geometry.  The code is setup to run in two stages:
  1. starbase.py produces root files containing histogram and TGeo geometry.  It is a wrapper function which provides a unix command line interface to the starbase.C macro.
  2. differential.py produces PDF files containing differential plots of the requested volume and the volumes contained within it.
 
Usage: 
$ cvs co StarVMC/StarBASE
$ ln -s StarVMC/StarBASE/macros/{starbase.py,starbase.C,differential.py} .

$ starbase.py --geom=y2009
$ starbase.py --geom=y2009a

$ setenv PYTHONPATH $ROOTSYS/lib
$ setenv PYTHONPATH $PYTHONPATH:StarVMC/StarBASE/macros
$ differential.py --base=y2009 --geom=y2009a --volume=CAVE

$ ls *.pdf *.root
differential-y2009-vs-y2009a-CAVE.pdf  y2009a.root  y2009.root

$ acroread differential-y2009-vs-y2009a-CAVE.pdf

 
Attached are comparisons between several different versions of the STAR geometry.  One should note the following behaviors and/or limitations of the code:
  1. At present, starbase.py generates the geometries automatically from the AgSTAR geometry tags defined in $STAR_LIB/geometry.so.  The next version of the code will allow private code to be processed.
  2. To save processing time, the azimuthal angle is limited to -15 < phi < 15 degrees.  This is the default range setup in the code.  It can be changed by running starbase.py with the "--phimin=MIN --phimax=MAX" options.
  3. The default eta range is -6 < eta < +6.  The options "--etamin=MIN --etamax=MAX" will similiarly change the default eta range.
  4. Some simple assumptions were made to simplify the production of the plots for the PDF files.  Specifically, I assume that every volume defined in the 'base' geometry will also be present in the comparison or 'geom' geometry.   If you add a new volume to a geometry, do not use your geometry as the baseline.