TRF++

TRF++: An Object-Oriented Track finder for HEP

Welcome to the TRF++ home page (http://www-d0.fnal.gov/~dladams/trf).

14jul00 1100

Overview

TRF++ is a software system for fitting and finding tracks in a particle physics detector. The design is object-oriented with considerable emphasis on reusability and extensibility. Program developers add detector-specific classes to describe their geometry, detector signals and algorithms.

The major goal is to find tracks, i.e. take a collection of detector signals and reconstruct the tracks which left these signals. Other input includes a description of the detector geometry and a map detailing the roads along which to search for tracks. The key feature of TRF++ is this map which allows very detailed control of the track-finding process.

Here are some relevant documents:

problem statement
A description of the track-finding algorithm may be found in D0 note 2958-2
CHEP98 presentation:

The use of TRF++ for track finding in D0 is described on another page. The interface would likely be similar for any experiment.

Deliverables

(The links in the section are old but have not been updated for historical reasons)

The delivered software consists of code and documentation. The latter tells how to use the software and describes the model underlying the implementation. These deliverables are described on a separate page. Presently the code is maintained in the D0 code repository. Here is a description of the D0 release and build procedure.

Current model

The relationships between some of the more important classes are described in the logical model.

The code is organized into packages with acyclic dependencies. These are illustrated in the package physical dependency diagram

The description of the TRF++ software follows the physical design: there is a separate page for each package:

Core packages
- trfcut - cut recorder
- trfutil - utilities
- trfobj - generic object base class
- trfbase - base tracking classes
- trflayer - geometry
- trffit - track fitting
- trffind - track finding
Extensions for different geometries
- trfcyl - cylinders
- trfdca - DCA (distance of closest approach)
- trfzp - planes perpendicular to z
- trfxyp - planes parallel to z
- trfcylplane - connect trfcyl and trfplane
Testing
- trf_cft - simple description of the D0 fiber tracker
- trf_proptest - main program for verifying propagators
- trftest - main programs
- trfoi - open inventor visualization (obselete)

Here are some packages used by TRF++:

ptr - pointer classes
spacegeom - Space points and vectors
objstream - object stream

Here are the release notes.

Some ancient TRF++ history may be found at here.

Here is a list of TRF++ development projects. It needs updating.

Results

Here are the results from some sudies carried out to evaluate the performance of TRF++.

More recent results may be found in the results section of the D0 global tracking software documentation.

Mailing list

If you are a member of D0, ask to join the D0 global tracking list. This takes the place of the old D0 TRF++ and trfplane mailing lists. The address to send mail to that list is d0_global_tracking@fnal.gov . Do not send requests to subscribe or unsubscribe to that address. More information may be found on the D0 global tracking page .

Source code

The most recent version of TRF++ is available to D0 members through CVS. Others may find sources here . This area may be updated on request.

News

Object streaming is now supported in in TRF++ so that complete paths may be read in from ascii files.

A tool for verifying propagators is ready for release.

Please send questions or comments to dladams@fnal.gov.