Code maintenance by CVS

The CMSIM versions 110 and greater are maintained by CVS (Concurrent Versions System) which is unix based system built on top of RCS (Revision Control System). The CVS formatted files of CMSIM code are kept in repository located in $CMS_PATH/cmsim/repository. A 'checked-out' copy of the sources is kept in $SRC directory (obviously this will change as the version numbers change). Normally CVS is used by the code librarians who maintain the code in the repository and the users deal only with the sources in $SRC and with the corresponding compiled libraries in $CMS_LIBS without the necessity to use CVS at all.

How CVS based CMSIM is used is explained below in section 1.2.6. More CVS information is found from cmsdoc page http://cmsdoc.cern.ch/cmsim/utils/utils.html.

The sources are in the form of *.F files and they are preprocessed with cpp before actual compilation. The preprocessing mainly involves inserting *.inc (commons etc) files and processing conditional code.

The CMSIM code in the repository is composed of the following modules:

• -- general CMs SImulation steering which includes:
  high level steering routines for event simulation
  high level steering for event reconstruction
  steering for kinematics
  steering for (full tracking) simulation
  steering for (re)digitization pass
  dummy user routines or examples, etc...
• -- DETector Constants -- geometry related routines:
  general utilities for geometry, rotation matrices, materials, tracking medias
  geometry model for individual sub-detectors, tracker, ECAL, ...
  General FF cards interpretation, handling of GEOM and SETS cards, etc...
• -- User `hook' routines, mostly dummies by default
• -- TITLe constant data file(s) in TZ-format (``TT'')
• -- Zebra banks interface package
• -- KINEmatics generation (``KI'')
  Interface with physics generators, Pythia, Isajet, ...
  Routines to create column-wise ntuples in HEPEVT format
• -- routines for CMS scanning
• -- general UTILities:
  Kinematics utility routines, simple generators and interfaces
  General utility routines for simulation and reconstruction
  Utility routines common to simulation and reconstruction of simulated data
  Magnetic field routines
  Routines for random access events i/o
  input/output file handling package (IODB)
  Utilities for preparation of abs and rad lengths plots, etc...
• -- routines for digitization and hit reconstruction in the central TRAcKer (``TR'')
• -- ditto in the Electromagnetic CALorimeters (``EC'')
• -- ditto in the Hadron CALorimeters and Tail-catcher (``HC'')
• -- ditto in the Very forward CALorimeter (``VC'')
• -- ditto for fast shower simulation
• -- ditto in the MUON system (``MU'', ``DTBX'', ``CSC'', ``RPC'')
• -- ditto for Muon RPC trigger
• -- ditto for Muon Trigger Track Finding
  
• -- TRIGger utilities (``JT'')
  Production of simulated trigger information
  Reconstruction of trigger results starting from raw data.
• -- steering and utilities for RECOnstruction (``RE''):
  High level steering routines for event reconstruction
  Fanout and auxiliary routines for event reconstruction
  Utility routines for reconstruction
  User entry points in reconstruction, etc... the Geometry Verification (overlap).

 
• Building libraries from CVS maintained sources
• CMZ (CMSIM versions < 110)