This is an old revision of the document!
Submitting tags
Reconstruction tags
Full detector simulations are created using the concept of tags, which are small (<3MB) files that include necessary information to convert truth-level files to final reconstructed events. All tags can be found in this page. In many cases we call them “reconstruction” tags, but, generally, include both Geant4 simulation and reconstruction steps.
The reconstruction tag is associated with a file with the name “rfull[XXX].tgz”, where [XXX] is a number (fast simulations have the files “rfast[XXX].tgz”).
The goal of the tag files:
- archive the detector geometry
- create a web page for HepSim with the detector description
- archive calibration files etc.
- define the used software
- define the tag name to be used for downloading events
- define the workflow of the simulation-reconstruction steps
- create the necessary files for event visualization using Jas4pp
Reconstruction tags have unique names. There can be several reconstruction tags corresponding to a single detector, since simulation and reconstruction can be done using different software. They are small files that are sourced by reconstruction software on grid or HPC. A file “rfull[XXX].tgz” has everything you need to create LCIO/ROOT files with reconstructed events. Such files include the detector geometry, configuration scripts, setup files etc. In most cases, the directory inside rfull[XXX].tgz has this structure (for a detector called “sifcch7”):
A_RUN # main script to process events (free form) TEST # script for testing (optional) source.sh # setup script (optional) ..... # other required files if needed sifcch7 # the directory with detector geometry (always required!) - compact.xml # main detector geometry file (always required, but can be a dummy!) - other.xml ... # some other XML files with detector (optional) - sifcch7.heprep # some converted files, if needed - sifcch7.lcdd # optional file for event displays - sifcch7.pandora # optional file for Pandora - sifcch7.json # optional geometry file - sifcch7.root # optional geometry file (use to make 3D display) - sifcch7.html # HTML description (required) - view1.png # main image to view the detector (440x480 px, Y-Z) - view2.png # 2nd image to view the detector (440x480 px, X-Y) - some config files
To see what is inside, download “rful009.tgz” from http://atlaswww.hep.anl.gov/hepsim/taginfo.php?id=rfull009.
In addition to the detector geometry, the tag files include all settings needed for successful creation of events. Generally, the form of this file is free, as long as it includes sufficient information to create reconstructed events. In many cases, the tag file has several scripts : A_RUN (to make a complete reconstruction chain) and TEST (to test on a few events). The software to run these scripts should be fully specified, and it is up to the author to make sure that one can use such files to run over events on a dedicated computing resource.
You should create the reconstruction tag if:
- detector geometry has changed. In this case, use a different detector name inside rfullXXX.tgz
- detector geometry is the same, but configuration files and setup scripts have changed.
HepSim provides a mechanism to upload rfull[XXX].tgz. After upload, HepSim extracts the detector from rfull[XXX].tgz and builds an information detector page. Then you will see two entries:
As mentioned before, we leave the authors with the liberty to design rfull[XXX].tgz files. The only strict requirement is that they should have the directory with the detector, its PNG image and the HTML description, since this populates the information page with the detector in HepSim. The simulation and reconstruction scripts can include all the required workflow to work together with the installed software (git, makefiles, wget commands etc).
After a tag file is uploaded, HepSim performs the following operations with this file:
- Moves the file to the standard location, so it can be used as a source on computing nodes
- Extracts the detector, and makes a zip file for download
- Builds a web page with the detector information (uses included HTML, view1.png, compact.xml and other available files)
- For the SiD derived software, prepares a zip file with detector description for Jas4pp to view the detector inside the Wired4 display
— Sergei Chekanov 2017/08/12 21:58