Creating a New Detector Description
- Create a new compact detector description XML file by copying and modifying an existing one or authoring a new file. .
- The full
- Checkout the LCDetectors project for the complete set of public compact detector descriptions.files is contained in the LCDetectors cvs project.
No Format cvs -d :pserver:anonymous@cvs.freehep.org:/cvs/lcd co LCDetectors
- Download a detector zip file and extract its compact file.
Download them individually fromNo Format wget
http://www.lcsim.org/detectors/sid01.zip; unzip sid01.zip -C compact.xml
- Decide on a unique name for this detector which will be denoted as DETECTOR_NAME in these instructions. . This name should NOT conflict with any of the names listed in http://www.lcsim.org/detectors/taglist.txt.
- Any
- From here forward, any time you see DETECTOR_NAME in these instructions, replace it with the actual name of your detector.
- Create a directory called DETECTOR_NAME.
- Copy the compact.xml file to the directory.
- In the new compact file, change the name field to your new detector name.
It is very important to change this tagvalue to your new, unique detector name. Otherwise, the detector conditions system will not recognize your new detector model.No Format <info name="DETECTOR_NAME"/>
- Create a new file called detector.properties in the detector's directory, which should contain the following line.
No Format name: DETECTOR_NAME
- 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.
- Regenerate the LCDD file for your detector so events can be simulated.
See Converting to LCDD or HepRep using GeomConverter for instructions.No Format GeomConverter/bin/GeomConverter -o lcdd compact.xml DETECTOR_NAME.lcdd
- Generate LCIO events with this LCDD file using slic. See SLIC FAQ for instructions.
- Setup an alias to the new detector so JAS/lcsim can find it by adding this line to the ~/.lcsim/alias.properties file.
No Format DETECTOR_NAME: file:///path/to/DETECTOR_NAME
- Finally, load a test LCIO file into JAS3. You will need to restart JAS3 for new detectors to be recognized.