TRF++ test programs (package trftest)
27nov00 1200
Code version 0.63
An introduction to TRF++ may be found at
http://www-d0.fnal.gov/~dladams/trf.
Links to code
The description below includes links to the code contained in this
package. This
version
of the code may not be the most recent.
Description
TRF++ package trftest provides main programs for track fitting and
finding. They are intended to demonstrate the use of and test the
performance of the core TRF++ packages (trfutil, trfbase, trflayer,
trffit and trffind) and the extension trfcyl.
The main programs in this package include:
- fitcyl - Fits a track passing
through a series of cylinders.
- findcyl - Finds tracks passing
through a series of cylinders.
The physical components include:
Their dependencies are illustrated in the
physical dependency diagram.
The class diagram [does not exist]
shows the classes and their relationships.
This package depends on the following external packages:
The following sections describe the main programs and the classes defined
in the components. Unless otherwise, noted each class is defined in the
component of the same name.
The descriptions here are brief.
See the header files for details.
The components are only intended for use within this package. Those that
prove to be of more general use will be moved to another package.
fitcyl
The main program fitcyl builds a geometry approximating the D0
scintillating fiber tracking system. Monte Carlo tracks are generated
and used to gnerated simulated hits in each of 16 tracking layers.
The tracks and hits are then used to build fitted tracks. The
Mont Carlo and fitted tracks are used to fill an NTuple.
The program is run with the command
where ntrack is the total number of tracks to process and nprint is the
number for which to display debugging information.
findcyl
This main program is similar to the former except that it loops over
events with multiple Monte Carlo tracks.
Tracks are found starting with simulated hits (instead of
simply fitting as in fitcyl).
The program is run with the command
fitcyl nevent ntrack nprint
where nevent is the total number of events, ntrack is the number of tracks
per event and nprint is the number of events for which to print debugging
information. If nevent is negative, then the program will go into a
debugging mode after generating -nevent events. Enter the number of
a processed event and it will be reprocessed with the same random numbers.
Monte Carlo track maker
Class MCTrackMaker produces simulated tracks. It provides a method to
return a new track and a method to register its random number generators.
Presently the track surface and distributions for the track parameters
are defined in the source.
Detector
Class D0Detector builds a detector using the subdetector defined in
trf_cft.
Detector simulator
Class D0DetectorSimulator builds a detector simulator using the
subdetector simulator defined in trf_cft.
The package includes some paw macros and a HIGZ
windows files higz_windows.dat suitable for use with the ntuple
created by CylTrackNtuple.
The macros include:
- pawlogon.kumac: Execute this before any of the others. It reads
the histogram file from the current directory.
- res.kumac: Plots the resolution (reco-MC) distribution for the five track
parameters.
- sig.kumac: Plots the significance (resolution/error) distribution
for each of the track parameters.
- chsq.kumac: Plots the chi-square and hit count distributions.
- post.kumac: Copies the current plot to postscript file paw.ps and
prints the file using command pp.
Questions or comments to dladams@fnal.gov.