Creating a New Detector Description

Creating a New Detector Description

1. Create a new compact detector description XML file by copying and modifying an existing one or author a new compact description.
2. Decide on a unique name for this detector which will be denoted as DETECTOR_NAME in these instructions.
3. Create a directory called DETECTOR_NAME.
4. Copy the compact file to DETECTOR_NAME.
5. In the new compact file, change the name field to DETECTOR_NAME.

   <info name="DETECTOR_TAG"/>

   It is very important to change this tag. Otherwise, the detector conditions system will not recognize your new detector model.
6. Create a new file detector.properties in the DETECTOR_NAME directory which contains the following line.

   DETECTOR_NAME: file:///path/to/DETECTOR_NAME

7. Make all the changes required to this compact description. Once you have a working compact description, it is advisable to permanently freeze this description and not make any more changes. If you want to change it later on, the best approach is to redo these instructions and create a new compact description and unique name.
8. Regenerate the LCDD file for your detector so events can be simulated. See Converting to LCDD or HepRep using GeomConverter for instructions.
9. Generate LCIO events with this LCDD file using slic. See SLIC FAQ for instructions.
10. Setup an alias to the new detector so JAS/lcsim can find it. (see above)

Now the events should be usable by lcsim within JAS3. You will need to shutdown JAS3 and restart for new detector descriptions to be loaded.