Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
hepsim:dev_full [2017/08/29 03:28] hepsim17 [Reconstruction tags] |
hepsim:dev_full [2017/09/21 19:18] (current) hepsim17 |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | {{indexmenu_n> | + | {{indexmenu_n> |
[[: | [[: | ||
- | ====== Creating full simulations ====== | ||
+ | ===== Creating LCIO files ===== | ||
- | ===== Reconstruction tags ===== | + | In many cases, HepSim detector simulations were done using ILCSOFT-derived software, such as those used for ILC, CLIC, etc. experiments. |
- | + | To perform Geant4 | |
- | Full detector | + | |
- | small (<3MB) files that include necessary information | + | |
- | can be found in [[http:// | + | |
- | In many cases we call them " | + | |
- | + | ||
- | The reconstruction tag is associated | + | |
- | (fast simulations | + | |
- | + | ||
- | 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 " | + | |
- | has everything you need to create simulations and reconstruction files. Such files include the detector geometry, | + | |
<code bash> | <code bash> | ||
- | A_RUN # main script to process events (free form) | + | wget http:// |
- | TEST # script for testing (optional) | + | tar -zvxf promc_convert.tgz |
- | source.sh # setup script (optional) | + | cd promc_convert |
- | ..... # other required files if needed | + | ./promc2lcio.sh input.promc output.slcio # |
- | sifcch7 | + | ./ |
- | | + | |
- | - sifcch7.heprep | + | |
- | - sifcch7.lcdd # optional file for event displays | + | |
- | - sifcch7.pandora # optional file for Pandora | + | |
- | - sifcch7.json # optional geometry file | + | |
- | - sifcch7.root # | + | |
- | - 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 " | ||
- | In addition to the detector geometry, the tag files include all settings needed for successful creation of events. | + | You can convert all files in a directory with ProMC files as: |
- | 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 | + | |
- | <note important> | ||
- | when the tag files are sourced by reconstruction software on each node on HPC or grid, | ||
- | which are assumed to contain the needed software used in combination with rfullXXX.tgz files. | ||
- | </ | ||
- | |||
- | 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: | ||
- | |||
- | * [[http:// | ||
- | * [[http:// | ||
- | |||
- | 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, | ||
- | The simulation and reconstruction scripts can include all the required | ||
- | workflow to work together with the installed software (git, makefiles, wget commands etc). | ||
- | |||
- | <note tip> | ||
- | A tag file should have a directory with the detector name, and the " | ||
- | Please add compact.xml even if it is a dummy file not used for detector description.</ | ||
- | |||
- | 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 | ||
- | |||
- | |||
- | |||
- | ===== Detector simulation with FPadSim ===== | ||
- | |||
- | |||
- | To create full simulations, | ||
- | [[hepsim: | ||
- | |||
- | Many samples posted in HepSim are created with ths package is called " | ||
- | The contributed authors of this package since 2015 are: | ||
- | |||
- | * D.Blyth (HEP/ANL) | ||
- | * J.MacCormick (SLAC) | ||
- | * W.Armstrong | ||
- | * S.Chekanov (HEP/ANL) | ||
- | * A.Kotwal (Duke) | ||
- | * J.Strube (PNNL) | ||
- | * J.Marshall (U.Cambridge) | ||
- | |||
- | |||
- | The package includes packages from ilcsoft, such as SLIC, PandoraPFA, and LCSIM | ||
- | The simulation and reconstruction proceeds as: SLIC-> | ||
- | This digram shows the entire chain: | ||
- | |||
- | {{: | ||
- | |||
- | |||
- | The input for SLIC are LCIO files with truth-level information (" | ||
- | are created from ProMC files using the converter promc2lcio (included inside | ||
- | the ProMC packages, in the directory " | ||
- | This concept originates from the SiD detector(T.Johnson, | ||
- | and later was re-purposed to be used for generic feature detectors, including | ||
- | proton pp colliders (S.Chekanov, | ||
- | of the reconstruction is PandoraPFA (J.Marshall, | ||
- | |||
- | |||
- | |||
- | To create LCIO files with full simulations and reconstruction, | ||
- | |||
- | * ProMC file from HepSim | ||
- | * Simulation and Reconstruction package called " | ||
- | * Tag file which includes detector and the simulation and reconstruction sequence. | ||
- | |||
- | The fpadsim package is located [[http:// | ||
- | The tag files are also located [[http:// | ||
- | After untaring the file fpadsim.tgz, | ||
- | There is a simple script " | ||
- | |||
- | |||
- | |||
- | ====== Changes in compact.xml ====== | ||
- | |||
- | |||
- | If you want to make changes in the detector design, edit " | ||
<code bash> | <code bash> | ||
- | JAVA_OPTS=" | + | ./batchconverter stdhep [DIR with ProMC files] |
- | GCONVERTER=lcsim/detector-framework/ | + | ./ |
- | GEOM=" | + | |
- | java $JAVA_OPTS -jar $GCONVERTER -o lcdd compact.xml $GEOM.lcdd | + | |
- | slic -g ${GEOM}.lcdd | + | |
- | echo " | + | |
- | java $JAVA_OPTS -jar $GCONVERTER -o heprep compact.xml $GEOM.heprep | + | |
- | echo " | + | |
- | java $JAVA_OPTS -jar $GCONVERTER -o pandora compact.xml $GEOM.pandora | + | |
- | java $JAVA_OPTS -jar $GCONVERTER -o html compact.xml ${GEOM}.html | + | |
</ | </ | ||
- | where " | ||
- | <code cpp> | ||
- | TGeoManager:: | ||
- | gGeoManager-> | ||
- | gGeoManager-> | ||
- | gGeoManager-> | ||
- | gGeoManager-> | ||
- | gGeoManager-> | ||
- | </ | ||
- | If you see that some volumes overlap, come back to " | ||
- | ====== Pandora PFA ====== | ||
- | All information required by Pandora algorithm is stored in the file with the extension " | ||
- | In particular, it reads: | ||
- | * mipEnergy | + | Files in the LCIO or STDHEP formats can be used as input for DD4HEP or SLIC simulation packages. |
- | * mipSigma | + | |
- | * mipCut | + | |
- | * timeCut | + | |
- | The sampling fractions are taken from the detector | + | Many samples of HepSim were created with a dedicated FPadSim package. See [[hepsim:dev_fpadsim|FPadSim section]]. |
- | Here files look as this: | + | |
- | + | ||
- | < | + | |
- | BeamCal.properties* | + | |
- | EcalBarrel.properties* | + | |
- | EcalEndcap.properties* | + | |
- | HcalBarrel.properties* | + | |
- | HcalEndcap.properties* | + | |
- | LumiCal.properties* | + | |
- | MuonBarrel.properties* | + | |
- | MuonEndcap.properties* | + | |
- | README* | + | |
- | </ | + | |
- | + | ||
- | + | ||
- | Look at the file: | + | |
- | < | + | |
- | lcsim/ | + | |
- | </ | + | |
--- // | --- // |