Warning, /detector_benchmarks/benchmarks/irt/README.md is written in an unsupported language. File is not indexed.
0001 # RICH IRT benchmark
0002
0003 Benchmark of the RICH Indirect Ray Tracing (IRT) reconstruction.
0004
0005 Single particles (`pi-`, `kaon-`, `proton`) are shot into the acceptance of one
0006 of the RICH detectors, reconstructed with `eicrecon`, and the resulting IRT
0007 collections are analyzed:
0008
0009 * `{RICH}Tracks` — track momentum and pseudorapidity at the RICH,
0010 * `{RICH}IrtRadiatorInfo` — per-radiator Cherenkov angle, number of
0011 photoelectrons and number of hits, and the Cherenkov angle versus momentum,
0012 * `{RICH}IrtParticles` vs. `MCParticles` — PID confusion matrix.
0013
0014 ## Layout
0015
0016 | Path | Description |
0017 | --- | --- |
0018 | `src/`, `include/` | C++ analysis program (`irt_analysis`), built with CMake |
0019 | `scripts/plot_irt.py` | Produces the PNG plots from the histogram files |
0020 | `Snakefile` | Simulation, reconstruction, analysis and plotting rules |
0021 | `config.yml` | GitLab CI jobs |
0022
0023 ## Running
0024
0025 ```console
0026 snakemake --cores 1 results/epic_craterlake/irt/DRICH
0027 ```
0028
0029 The phase space (polar angle and momentum range), the particle species and the
0030 number of events are configured at the top of the `Snakefile` in
0031 `IRT_SETTINGS`, `IRT_PARTICLES` and `IRT_N_EVENTS`.
0032
0033 The analysis program can also be run standalone:
0034
0035 ```console
0036 irt_analysis <DRICH|PFRICH> <rec.edm4eic.root> <hists.root>
0037 ```
0038
0039 ## Status
0040
0041 This is the first iteration of the benchmark. The names of the IRT collections
0042 produced by `eicrecon` have not been verified against a released version yet,
0043 and the pfRICH chain is not exercised in CI, so the CI jobs are marked
0044 `allow_failure: true`.
