Skip to content

Commit 4ad741c

Browse files
authored
Update 02-eicrecon.md
1 parent 164a463 commit 4ad741c

File tree

1 file changed

+16
-16
lines changed

1 file changed

+16
-16
lines changed

_episodes/02-eicrecon.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -14,16 +14,13 @@ keypoints:
1414

1515

1616
## Reconstruction workflow
17-
The ePIC reconsutrction framework `EICrecon` is maintained [on github](https://github.com/eic/eicrecon/). It process simulated hits from various detectors to reconstruct trajectory, PID, etc, and eventually reconstruct the simulated particle and physics observables at the vertex.
17+
The ePIC reconsutrction framework `EICrecon` is maintained [on github](https://github.com/eic/eicrecon/). It process simulated hits from various detectors to reconstruct trajectory, PID, etc, and eventually reconstruct the simulated particle and physics observables at the vertex. In this section, we will use __track reconstruction__ as an example. Please refer to the Lehigh reconstruction workfest [presentations](https://indico.bnl.gov/event/20727/sessions/7433/#20240725) for reconstruction workflow of other systems.
1818

1919
Each reconstruction step involves 3 components:
2020
- the algorithm,
2121
- the JOmniFactory where algorithm and data type are declared.
2222
- the factory generator to excute the algorithm.
2323

24-
> in this section, we will use __track reconstruction__ as an example. Please refer to the Lehigh reconstruction workfest [presentations](https://indico.bnl.gov/event/20727/sessions/7433/#20240725) for reconstruction workflow of other systems.
25-
26-
2724
### __Digitization__
2825
All simualted detector hits are digitized to reflect certain detector specs e.g. spatial and time resolution, and energy threshold. For example, the `VertexBarrelHits` from simulation are digitized through the `SiliconTrackerDigi` factory in `EICrecon/src/detectors/BVTX/BVTX.cc`:
2926
```console
@@ -43,6 +40,8 @@ Each reconstruction step involves 3 components:
4340
app
4441
));
4542
```
43+
44+
4645
The actual algorithm locates at `EICrecon/src/algorithms/digi/SiliconTrackerDigi.cc`, with its input and output specified in `SiliconTrackerDigi_factory.h`:
4746

4847
```console
@@ -62,7 +61,8 @@ Each reconstruction step involves 3 components:
6261
ParameterRef<double> m_timeResolution {this, "timeResolution", config().timeResolution};
6362
...
6463
```
65-
By comparing the two blocks of code above, we can see that the digitized hits, `SiBarrelVertexRawHits`, are stored in the data type `RawTrackerHit` that is defined in the [edm4eic data model](https://github.com/eic/EDM4eic/blob/main/edm4eic.yaml):
64+
65+
By comparing the two blocks of code above, we can see that the digitized hits, `SiBarrelVertexRawHits`, are stored in the data type `RawTrackerHit` that is defined in the [edm4eic data model](https://github.com/eic/EDM4eic/blob/main/edm4eic.yaml):
6666
```console
6767
edm4eic::RawTrackerHit:
6868
Description: "Raw (digitized) tracker hit"
@@ -73,7 +73,7 @@ Each reconstruction step involves 3 components:
7373
- int32_t timeStamp
7474
```
7575

76-
In addition, the one-to-one relation between the sim hit and its digitized hit is stored as an `MCRecoTrackerHitAssociation` object:
76+
In addition, the one-to-one relation between the sim hit and its digitized hit is stored as an `MCRecoTrackerHitAssociation` object:
7777
```console
7878
edm4eic::MCRecoTrackerHitAssociation:
7979
Description: "Association between a RawTrackerHit and a SimTrackerHit"
@@ -104,12 +104,12 @@ By default, we use the Combinatorial Kalman Filter from the ACTS library to hand
104104
{: .challenge}
105105

106106
### __Reconstruction output__
107-
> - `events` tree:
108-
> - `MCParticles` and detector sim hits are copied from simulation output to recon output
109-
> - outputs from each step of recon algorithms must be either `edm4hep` or `edm4eic` object if you want to save them in recon output
110-
> - the default list of saved objects in recon output is defined in `EICrecon/src/services/io/podio/JEventProcessorPODIO.cc`. It can be configured in command line.
111-
> - `podio_metadata` tree:
112-
> - `events___idTable` provides a lookup table between output collection name and IDs.
107+
- `events` tree:
108+
- `MCParticles` and detector sim hits are copied from simulation output to recon output
109+
- outputs from each step of recon algorithms must be either `edm4hep` or `edm4eic` object if you want to save them in recon output
110+
- the default list of saved objects in recon output is defined in `EICrecon/src/services/io/podio/JEventProcessorPODIO.cc`. It can be configured in command line.
111+
- `podio_metadata` tree:
112+
- `events___idTable` provides a lookup table between output collection name and IDs.
113113

114114

115115
> Exercise 2.3:
@@ -124,7 +124,7 @@ By default, we use the Combinatorial Kalman Filter from the ACTS library to hand
124124
{: .challenge}
125125
{% include links.md %}
126126

127-
## Future reading
128-
> - Generate your own simulation and reconstruction rootfiles [tutorial](https://eic.github.io/tutorial-simulations-using-ddsim-and-geant4/)
129-
> - Contribute to reconstruction algorithsm [tutorial](https://eic.github.io/tutorial-reconstruction-algorithms/)
130-
> - Develop analysis benchmarks [tutorial](https://eic.github.io/tutorial-developing-benchmarks/)
127+
## What's next
128+
- Generate your own simulation and reconstruction rootfiles [tutorial](https://eic.github.io/tutorial-simulations-using-ddsim-and-geant4/)
129+
- Contribute to reconstruction algorithsm [tutorial](https://eic.github.io/tutorial-reconstruction-algorithms/)
130+
- Develop analysis benchmarks [tutorial](https://eic.github.io/tutorial-developing-benchmarks/)

0 commit comments

Comments
 (0)