Main Page | Class Hierarchy | Class List | File List | Class Members

GEAR (v00-03)

gear_banner.png

Overview

Gear is a geometry description toolkit for ILC reconstruction software. It is easy to use and lightweight. Gear defines an abstract interface for the description of an ILC detector as needed for the development of particle flow algorithms. This description is somewhat different from the geometry description needed for the detailed simulation of the detector response, though of course related. For the simualtion one needs very detailed knowledge of the material distribution in space whereas for the reconstruction mostly a higher level description of the subdetector's charcteristics is needed. Depending on the particular reconstruction algorithm a hand full of parameters might suffice to describe a full subdetector, e.g. the main calorimeters - certainly a lot less than waht is needed for the computation of the detailed detector response with geant4. The aim of Gear is now to provide the interface this recosntruction view of the detector geometry.

A first implementation uses XML files for the definition of the subdetector's geometry parameters. Currently under development is an implementation for the abstract interface to generic material properties in space, like the material's density at a given point or the integrated B-field along a (straight) path between two points.

Code Structure

At the core of the geometry description in gear is the class gear::GearMgr. An instance of that class provides the user with available implementations of the various sub-interfaces, e.g. an instance of gear::TPCParameters. All subdetector interfaces inherit from gear::GearParameters - this allows to store arbitrary named parameters of simple types and vectors of such types within any subdetector parameter interface. Also generic named parameter sections can be used through this interface, e.g in case a particular subdetector type has not yet been implemented in gear.

In the current implementation XML-files are used to provide the subdetector parameters to Gear. The user code however only applies the abstract interface and is thus independent from the XML-file implementation.

Gear is written in C++. However the abstract interface classes are written using the AID tool. which allows to also create Java interface files from the same source.

Installation

A tar-ball of released versions of Gear can be downloaded at http://www-zeuthen.desy.de/lc-cgi-bin/cvsweb.cgi/gear/?cvsroot=gear .

Before the build process a few environment varibles have to be set in particular the path to the Java run time. You can modify the env.sh script then source it:

. env.sh

To build issue the following commands:
ant aid.generate
ant cpp
ant cpp.doc

Example code

The file ./src/cpp/test/testgear.cc serves as a simple test and example program. Also the print-methods in ./src/cpp/gearimpl/src/Util.cc are a good starting point for learning how to access the information in Gear.

Here is an example XML-file with a detector description in gear.

Merging XML files

Existing XML files with detector geometry definitions can be extended by a new tool that merges two XML files:
./bin/mergeXML
This is particullarly useful if the detector description has been automatically created, e.g. by MokkaGear but is lacking some (user) specific information.

Release Notes

Gear is under development and there are frequent releases. Please check the ./release.notes


If you have any questions or proposals for new features please contact the author:

frank.gaede@desy.de


Generated on Tue Sep 5 11:36:29 2006 for Gear by doxygen 1.3.5