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 02:40] hepsim17 [Reconstruction tags] |
hepsim:dev_full [2017/09/21 19:18] 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 | + | |
- | + | ||
- | | + | |
- | They are small files that are sourced by reconstruction software on grid or HPC. A file " | + | |
- | has everything you need to create full simulations. 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, etc. | + | |
</ | </ | ||
- | 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 such 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 rfullXXX.tgz. After upload, HepSim extracts the | ||
- | detector from rfullXXX.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 rfullXXX.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> | ||
- | One important requirement for a tag file: it should have one directory with the detector name, and " | ||
- | (even if it is a dummy file) | ||
- | |||
- | |||
- | ===== 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/ | + | |
- | </ | + | |
--- // | --- // |