Brahms FFREAD cards

At the time of writing the following FFREADS cards have been implemented. Contributions for more cards are welcome.

• turnon Accepts an array of 12 Integer values corresponding to the different subdetectors. A value of $0$ switches the detector off, $>0$ on. The following table shows the available switches and the order in which they have been defined. The mnemonic given is the name of the logical variable used in the Brahms code to control the subdetector.

  1	VTX	=1 Pixel detector, =2 CCD detector
  		for CCD: add 10 to get detector for 1cm beampipe;
  		add 20 to get detector for 2 cm beampipe
  		There is currently no APS version for a 1 cm beampipe.
  2	ITC	Intermediate Tracker
  3	FTD	Forward Tracking Detector
  4	SIT	Silicon intermediate Tracker
  5	TPC	TPC
  6	BCAL	Barrel calorimeter
  7	ECAP	Endcap calorimeter
  8	Coil	The Coil
  9	Yoke	instrumented Iron
  10	Lumi	Luminosity calorimeter inside the mask
  11	Mask	The Tungsten Mask
  12	Bpipe	=1: normal beampipe; =2: extended beampipe to $\pm 100$m
  13	Pre	The preshower Detector
  14	Quad	beamline elements (quadrupoles etc)
  15	Hall	The walls (concrete) of the Hall and Tunnel

• brpmin Minimum momentum to be tracked inside the detector volume, default = 100 MeV.
• ibrpid Array to define which particles are to be tracked in sensitive detector volumes. Order is that of Geant.
• kinfile Steers the input of 4-vectors into Brahms.
  

  =1	Read 4-vectors from file ``kinfile'' via routine lcread
  =2	use internal routine USKINE for user supplied interface to generator,
  	simple track generators or similar.

  
  
• calopt Controls the level of detail for the calorimeter simulation. Its meaning is the same as the variable ICALOPT which is described later in the writeup in the calorimeter section.
• hcgap Controls the size of an extra gap between the HCAL and the coil. Default value is 0. This variable allows for calorimeter studies to determine the effect of reducing the depth of the calorimeter inside the coil.