Back to home page

EIC code displayed by LXR

 
 

    


Warning, /EDM4eic/edm4eic.yaml is written in an unsupported language. File is not indexed.

0001 # SPDX-License-Identifier: LGPL-3.0-or-later
0002 # Copyright (C) 2023 Sylvester Joosten, Whitney Armstrong, Wouter Deconinck, Christopher Dilks
0003 # Some datatypes based on EDM4hep. EDM4hep license applies to those sections.
0004 ---
0005 ## Schema versioning
0006 ## This is required to be an integer, and defined as 100*major+minor.
0007 ## Patch level changes are required to be schema invariant.
0008 ##
0009 ## If there are schema version changes that can be evolved, see the podio documentation
0010 ## for an example: https://github.com/hegner/podio/blob/master/tests/schema_evolution.yaml
0011 ##
0012 schema_version: 600
0013 
0014 options :
0015   # should getters / setters be prefixed with get / set?
0016   getSyntax: True
0017   # should POD members be exposed with getters/setters in classes that have them as members?
0018   exposePODMembers: False
0019   includeSubfolder: True
0020 
0021 ## Some guidance:
0022 ##  - Ensure data products usable without library dependencies (favor PODness where
0023 ##    possible).
0024 ##  - Move towards EDM4hep compatibility (to allow a transition to mainly use EDM4hep).
0025 ##        - migrate away from custom indices in favor of podio relations
0026 ##  - Use float most of the time except for 4-vectors where ppm precision is important.
0027 ##  - Data alignment: 
0028 ##        - data should be aligned with a 64-bit structure where possible.
0029 ##        - when using 32 bit values, use them in pairs (or after all 64-bit variables are defined). 
0030 ##        - same goes for 16-bit values (keep them aligned with the largest following component)
0031 ##  - Explicitly specify the integer length (use the typedefs from <cstdint>, 
0032 ##    such as int32_t etc)
0033 
0034 components:
0035 
0036   edm4eic::CovDiag3f:
0037     Members:
0038       - float xx
0039       - float yy
0040       - float zz
0041     ExtraCode:
0042       declaration: "
0043         CovDiag3f() : xx{0}, yy{0}, zz{0} {}\n
0044         CovDiag3f(double x, double y, double z)\n
0045           : xx{static_cast<float>(x)}, yy{static_cast<float>(y)}, zz{static_cast<float>(z)} {}\n
0046         float operator()(unsigned i, unsigned j) const {return (i == j) ? *(&xx + i) : 0.;}\n
0047         "
0048 
0049   edm4eic::Cov2f:
0050     Members:
0051       - float xx
0052       - float yy
0053       - float xy
0054     ExtraCode:
0055       declaration: "
0056         Cov2f() : xx{0}, yy{0}, xy{0} {}\n
0057         Cov2f(double vx, double vy, double vxy = 0)\n
0058           : xx{static_cast<float>(vx)}, yy{static_cast<float>(vy)}, xy{static_cast<float>(vxy)} {}\n
0059         float operator()(unsigned i, unsigned j) const {\n
0060           // diagonal\n
0061           if (i == j) {\n
0062             return *(&xx + i);\n
0063           }\n
0064           // off-diagonal\n
0065           // we have as options (0, 1), and (1, 0)\n
0066           // note that, starting from xy, we find the correct element at (i+j+1)/2)\n
0067           return *(&xy + (i + j + 1) / 2);\n
0068         }\n
0069       "
0070 
0071   edm4eic::Cov3f:
0072     Members:
0073       - float xx
0074       - float yy
0075       - float zz
0076       - float xy
0077       - float xz
0078       - float yz
0079     ExtraCode:
0080       declaration: "
0081         Cov3f() : xx{0}, yy{0}, zz{0}, xy{0}, xz{0}, yz{0} {}\n
0082         Cov3f(double vx, double vy, double vz, double vxy = 0, double vxz = 0, double vyz = 0)\n
0083           : xx{static_cast<float>(vx)}, yy{static_cast<float>(vy)}, zz{static_cast<float>(vz)},\n
0084             xy{static_cast<float>(vxy)}, xz{static_cast<float>(vxz)}, yz{static_cast<float>(vyz)} {}\n
0085         float operator()(unsigned i, unsigned j) const {\n
0086           // diagonal\n
0087           if (i == j) {\n
0088             return *(&xx + i);\n
0089           }\n
0090           // off-diagonal\n
0091           // we have as options (0, 1), (0, 2) and (1, 2) (and mirrored)\n
0092           // note that, starting from xy, we find the correct element at (i+j-1)\n
0093           return *(&xy + i + j - 1);\n
0094         }\n
0095       "
0096 
0097   edm4eic::Cov4f:
0098     Members:
0099       - float xx 
0100       - float yy
0101       - float zz
0102       - float tt
0103       - float xy
0104       - float xz
0105       - float xt
0106       - float yz
0107       - float yt
0108       - float zt
0109     ExtraCode:
0110       declaration: "
0111         Cov4f() : xx{0}, yy{0}, zz{0}, tt{0}, xy{0}, xz{0}, xt{0}, yz{0}, yt{0}, zt{0} {}\n
0112         Cov4f(double vx, double vy, double vz, double vt,\n
0113               double vxy = 0, double vxz = 0, double vxt = 0,\n
0114               double vyz = 0, double vyt = 0, double vzt = 0)\n
0115           : xx{static_cast<float>(vx)}, yy{static_cast<float>(vy)}, zz{static_cast<float>(vz)}, tt{static_cast<float>(vt)},\n
0116             xy{static_cast<float>(vxy)}, xz{static_cast<float>(vxz)}, xt{static_cast<float>(vxt)},\n
0117             yz{static_cast<float>(vyz)}, yt{static_cast<float>(vyt)}, zt{static_cast<float>(vzt)} {}\n
0118         float operator()(unsigned i, unsigned j) const {\n
0119           // diagonal\n
0120           if (i == j) {\n
0121             return *(&xx + i);\n
0122           // off-diagonal, can probably be done with less if statements \n
0123           } else {\n
0124             if (i > j) { \n
0125               std::swap(i,j); \n
0126             } \n
0127             if (i == 0) { \n
0128               return *(&xy + j - 1); \n
0129             } else if (i == 1) { \n
0130               return *(&yz + j - 2); \n
0131             } else { \n
0132               return zt; \n
0133             } \n
0134           } \n
0135         }\n
0136       "
0137 
0138   edm4eic::Cov6f:
0139     Members:
0140       - std::array<float, 21> covariance  // 6d triangular packed covariance matrix
0141     ExtraCode:
0142       declaration: "
0143         Cov6f() : covariance{} {}\n
0144         Cov6f(std::array<float, 21> vcov) : covariance{vcov}{}\n
0145         float operator()(unsigned i, unsigned j) const {\n
0146           if(i > j) {\n
0147             std::swap(i, j);\n
0148             }\n
0149           return covariance[i + 1 + (j + 1) * (j) / 2 - 1];\n
0150         }\n
0151         float& operator()(unsigned i, unsigned j) {\n
0152           if(i > j) {\n
0153             std::swap(i, j);\n
0154             }\n
0155           return covariance[i + 1 + (j + 1) * (j) / 2 - 1];\n
0156         }\n
0157       "
0158 
0159   ## A point along a track
0160   edm4eic::TrackPoint:
0161     Members:
0162       - uint64_t          surface         // Surface track was propagated to (possibly multiple per detector)
0163       - uint32_t          system          // Detector system track was propagated to
0164       - edm4hep::Vector3f position        // Position of the trajectory point [mm]
0165       - edm4eic::Cov3f    positionError   // Error on the position
0166       - edm4hep::Vector3f momentum        // 3-momentum at the point [GeV]
0167       - edm4eic::Cov3f    momentumError   // Error on the 3-momentum
0168       - float             time            // Time at this point [ns]
0169       - float             timeError       // Error on the time at this point
0170       - float             theta           // polar direction of the track at the surface [rad]
0171       - float             phi             // azimuthal direction of the track at the surface [rad]
0172       - edm4eic::Cov2f    directionError  // Error on the polar and azimuthal angles
0173       - float             pathlength      // Pathlength from the origin to this point
0174       - float             pathlengthError // Error on the pathlength
0175 
0176   ## PID hypothesis from Cherenkov detectors
0177   edm4eic::CherenkovParticleIDHypothesis:
0178     Members:
0179       - int32_t           PDG             // PDG code
0180       - float             npe             // Overall photoelectron count
0181       - float             weight          // Weight of this hypothesis, such as likelihood, moment, etc.
0182  
0183 datatypes:
0184 
0185   ## ==========================================================================
0186   ## Particle info
0187   ## ==========================================================================
0188 
0189   edm4eic::ReconstructedParticle:
0190     Description: "EIC Reconstructed Particle"
0191     Author: "W. Armstrong, S. Joosten, F. Gaede"
0192     Members:
0193       - int32_t           type              // type of reconstructed particle. Check/set collection parameters ReconstructedParticleTypeNames and ReconstructedParticleTypeValues.
0194       - float             energy            // [GeV] energy of the reconstructed particle. Four momentum state is not kept consistent internally.
0195       - edm4hep::Vector3f momentum          // [GeV] particle momentum. Four momentum state is not kept consistent internally.
0196       - edm4hep::Vector3f referencePoint    // [mm] reference, i.e. where the particle has been measured
0197       - float             charge            // charge of the reconstructed particle.
0198       - float             mass              // [GeV] mass of the reconstructed particle, set independently from four vector. Four momentum state is not kept consistent internally.
0199       - float             goodnessOfPID     // overall goodness of the PID on a scale of [0;1]
0200       - edm4eic::Cov4f    covMatrix         // covariance matrix of the reconstructed particle 4vector (10 parameters).
0201       ##@TODO: deviation from EDM4hep: store explicit PDG ID here. Needs to be discussed how we
0202       ##       move forward as this could easiliy become unwieldy without this information here.
0203       ##       The only acceptable alternative would be to store reconstructed identified 
0204       ##       particles in separate collections for the different particle types (which would
0205       ##       require some algorithmic changes but might work. Doing both might even make
0206       ##       sense. Needs some discussion, note that PID is more emphasized in NP than
0207       ##       HEP).
0208       - int32_t           PDG               // PDG code for this particle
0209       ## @TODO: Do we need timing info? Or do we rely on the start vertex time?
0210     OneToOneRelations:
0211       - edm4eic::Vertex      startVertex    // Start vertex associated to this particle
0212       - edm4hep::ParticleID  particleIDUsed // particle ID used for the kinematics of this particle
0213     OneToManyRelations:
0214       - edm4eic::Cluster     clusters       // Clusters used for this particle
0215       - edm4eic::Track       tracks         // Tracks used for this particle
0216       - edm4eic::ReconstructedParticle particles // Reconstructed particles that have been combined to this particle
0217       - edm4hep::ParticleID  particleIDs    // All associated particle IDs for this particle (not sorted by likelihood)
0218     ExtraCode:
0219       declaration: "
0220         bool isCompound() const {return particles_size() > 0;}\n
0221         "
0222 
0223   ## ==========================================================================
0224   ## Calorimetry
0225   ## ==========================================================================
0226   edm4eic::RawCalorimeterHit:
0227     Description: "Raw (digitized) calorimeter hit"
0228     Author: "W. Armstrong, S. Joosten"
0229     Members:
0230       - uint64_t           cellID            // The detector specific (geometrical) cell id.
0231       - uint64_t           amplitude         // The magnitude of the hit in ADC counts.
0232         ## @TODO: should we also add integral and time-over-threshold (ToT) here? Or should
0233         ##        those all be different raw sensor types? Amplitude is
0234         ##        really not what most calorimetry sensors will give us AFAIK...
0235       - uint64_t           timeStamp         // Timing in TDC
0236 
0237   edm4eic::CalorimeterHit:
0238     Description: "Calorimeter hit"
0239     Author: "W. Armstrong, S. Joosten"
0240     Members:
0241       - uint64_t          cellID            // The detector specific (geometrical) cell id.
0242       - float             energy            // The energy for this hit in [GeV].
0243       - float             energyError       // Error on energy [GeV].
0244       - float             time              // The time of the hit in [ns].
0245       - float             timeError         // Error on the time
0246       - edm4hep::Vector3f position          // The global position of the hit in world coordinates [mm].
0247       - edm4hep::Vector3f dimension         // The dimension information of the cell [mm].
0248       - int32_t           sector            // Sector that this hit occurred in
0249       - int32_t           layer             // Layer that the hit occurred in
0250       - edm4hep::Vector3f local             // The local coordinates of the hit in the detector segment [mm]. 
0251 
0252   ## ==========================================================================
0253   ## Clustering
0254   ## ==========================================================================
0255   
0256   edm4eic::ProtoCluster:
0257     Description: "Collection of hits identified by the clustering algorithm to belong together"
0258     Author: "S. Joosten"
0259     OneToManyRelations:
0260       - edm4eic::CalorimeterHit hits        // Hits associated with this cluster
0261     VectorMembers:
0262       - float             weights           // Weight for each of the hits, mirrors hits array
0263 
0264   edm4eic::Cluster:
0265     Description: "EIC hit cluster, reworked to more closely resemble EDM4hep"
0266     Author: "W. Armstrong, S. Joosten, C.Peng"
0267     Members:
0268       # main variables
0269       - int32_t           type              // Flag-word that defines the type of the cluster
0270       - float             energy            // Reconstructed energy of the cluster [GeV].
0271       - float             energyError       // Error on the cluster energy [GeV]
0272       - float             time              // [ns]
0273       - float             timeError         // Error on the cluster time
0274       - uint32_t          nhits             // Number of hits in the cluster.
0275       - edm4hep::Vector3f position          // Global position of the cluster [mm].
0276       - edm4eic::Cov3f    positionError     // Covariance matrix of the position (6 Parameters).
0277       - float             intrinsicTheta    // Intrinsic cluster propagation direction polar angle [rad]
0278       - float             intrinsicPhi      // Intrinsic cluster propagation direction azimuthal angle [rad]
0279       - edm4eic::Cov2f    intrinsicDirectionError // Error on the intrinsic cluster propagation direction
0280     VectorMembers:
0281       - float             shapeParameters   // Should be set in metadata, for now it's a list of -- radius [mm], dispersion [mm], 2 entries for theta-phi widths [rad], 3 entries for x-y-z widths [mm].
0282       - float             hitContributions  // Energy contributions of the hits. Runs parallel to ::hits()
0283       - float             subdetectorEnergies // Energies observed in each subdetector used for this cluster.
0284     OneToManyRelations:
0285       - edm4eic::Cluster        clusters    // Clusters that have been combined to form this cluster
0286       - edm4eic::CalorimeterHit hits        // Hits that have been combined to form this cluster
0287       - edm4hep::ParticleID     particleIDs // Particle IDs sorted by likelihood
0288 
0289   ## ==========================================================================
0290   ## RICH/Cherenkov and PID
0291   ## ==========================================================================
0292 
0293   edm4eic::PMTHit:
0294     Description: "EIC PMT hit"
0295     Author: "S. Joosten, C. Peng"
0296     Members:
0297       - uint64_t          cellID            // The detector specific (geometrical) cell id.
0298       - float             npe               // Estimated number of photo-electrons [#]
0299       # @TODO do we need an uncertainty on NPE?
0300       - float             time              // Time [ns]
0301       - float             timeError         // Error on the time [ns]
0302       - edm4hep::Vector3f position          // PMT hit position [mm]
0303       - edm4hep::Vector3f dimension         // The dimension information of the pixel [mm].
0304       - int32_t           sector            // The sector this hit occurred in
0305       - edm4hep::Vector3f local             // The local position of the hit in detector coordinates (relative to the sector) [mm]
0306 
0307   edm4eic::CherenkovParticleID:
0308     Description: "Cherenkov detector PID"
0309     Author: "A. Kiselev, C. Chatterjee, C. Dilks"
0310     Members:
0311       - float             npe               // Overall photoelectron count
0312       - float             refractiveIndex   // Average refractive index at the Cherenkov photons' vertices
0313       - float             photonEnergy      // Average energy for these Cherenkov photons [GeV]
0314     VectorMembers:
0315       - edm4eic::CherenkovParticleIDHypothesis hypotheses         // Evaluated PDG hypotheses
0316       - edm4hep::Vector2f                      thetaPhiPhotons    // estimated (theta,phi) for each Cherenkov photon
0317     OneToOneRelations:
0318       - edm4eic::TrackSegment                  chargedParticle    // reconstructed charged particle
0319     OneToManyRelations:
0320       - edm4eic::MCRecoTrackerHitAssociation   rawHitAssociations // raw sensor hits, associated with MC hits
0321 
0322   edm4eic::RingImage:
0323     ##@TODO: Juggler support; not used in EICrecon
0324     Description: "EIC Ring Image Cluster"
0325     Author: "S. Joosten, C. Peng"
0326     Members:
0327       - float             npe               // Number of photo-electrons [#]
0328       - edm4hep::Vector3f position          // Global position of the cluster [mm]
0329       - edm4hep::Vector3f positionError     // Error on the position
0330       - float             theta             // Opening angle of the ring [rad, 0->pi]
0331       - float             thetaError        // Error on the opening angle
0332       - float             radius            // Radius of the best fit ring [mm]
0333       - float             radiusError       // Estimated error from the fit [mm]
0334 
0335   ## ==========================================================================
0336   ## Tracking
0337   ## ==========================================================================
0338   
0339   edm4eic::RawTrackerHit:
0340     Description: "Raw (digitized) tracker hit"
0341     Author: "W. Armstrong, S. Joosten"
0342     Members:
0343       - uint64_t          cellID            // The detector specific (geometrical) cell id.
0344       - int32_t           charge            // ADC value
0345       ## @TODO: is charge appropriate here? Needs revisiting.
0346       - int32_t           timeStamp         // TDC value.
0347 
0348   edm4eic::TrackerHit:
0349     Description: "Tracker hit (reconstructed from Raw)"
0350     Author: "W. Armstrong, S. Joosten"
0351     Members:
0352       - uint64_t          cellID            // The detector specific (geometrical) cell id.
0353       - edm4hep::Vector3f position          // Hit (cell) position [mm]
0354       - edm4eic::CovDiag3f positionError    // Covariance Matrix
0355       - float             time              // Hit time [ns]
0356       - float             timeError         // Error on the time
0357       - float             edep              // Energy deposit in this hit [GeV]
0358       - float             edepError         // Error on the energy deposit [GeV]
0359 
0360   edm4eic::Measurement2D:
0361     Description: "2D measurement (on an arbitrary surface)"
0362     Author: "W. Deconinck"
0363     Members:
0364       - uint64_t          surface           // Surface for bound coordinates (geometryID)
0365       - edm4hep::Vector2f loc               // 2D location on surface
0366       - float             time              // Measurement time
0367       - edm4eic::Cov3f    covariance        // Covariance on location and time
0368     VectorMembers:
0369       - float             weights           // Weight for each of the hits, mirrors hits array
0370     OneToManyRelations:
0371       - edm4eic::TrackerHit hits            // Hits in this measurement (single or clustered)
0372 
0373   edm4eic::TrackSeed:
0374     Description: "Seed info from the realistic seed finder"
0375     Author: "S. Li, B. Schmookler, J. Osborn"
0376     Members:
0377       - edm4hep::Vector3f         perigee   // Vector for the perigee (line surface)
0378     OneToManyRelations:
0379       - edm4eic::TrackerHit       hits      // Tracker hits triplet for seeding
0380     OneToOneRelations:
0381       - edm4eic::TrackParameters  params    // Initial track parameters
0382       
0383   edm4eic::Trajectory:
0384     Description: "Raw trajectory from the tracking algorithm. What is called hit here is 2d measurement indeed."
0385     Author: "S. Joosten, S. Li"
0386     Members:
0387       - uint32_t          type              // 0 (does not have good track fit), 1 (has good track fit)
0388       - uint32_t          nStates           // Number of tracking steps
0389       - uint32_t          nMeasurements     // Number of hits used 
0390       - uint32_t          nOutliers         // Number of hits not considered 
0391       - uint32_t          nHoles            // Number of missing hits
0392       - uint32_t          nSharedHits       // Number of shared hits with other trajectories
0393     VectorMembers:
0394       - float             measurementChi2   // Chi2 for each of the measurements
0395       - float             outlierChi2       // Chi2 for each of the outliers
0396     OneToManyRelations:
0397       - edm4eic::TrackParameters trackParameters            // Associated track parameters, if any
0398       - edm4eic::Measurement2D measurements_deprecated      // Measurements that were used for this track. Will move this to the edm4eic::Track
0399       - edm4eic::Measurement2D outliers_deprecated          // Measurements that were not used for this track. Will move this to the edm4eic::Track
0400     OneToOneRelations:
0401       - edm4eic::TrackSeed      seed      // Corresponding track seed
0402 
0403   edm4eic::TrackParameters:
0404     Description: "ACTS Bound Track parameters"
0405     Author: "W. Armstrong, S. Joosten, J. Osborn"
0406     Members:
0407       - int32_t              type              // Type of track parameters (-1/seed, 0/head, ...)
0408       - uint64_t             surface           // Surface for bound parameters (geometryID)
0409       - edm4hep::Vector2f    loc               // 2D location on surface
0410       - float                theta             // Track polar angle [rad]
0411       - float                phi               // Track azimuthal angle [rad]
0412       - float                qOverP            // [e/GeV]
0413       - float                time              // Track time [ns] 
0414       - int32_t              pdg               // pdg pid for these parameters
0415       - edm4eic::Cov6f       covariance        // Full covariance in basis [l0,l1,theta,phi,q/p,t]
0416 
0417 
0418   edm4eic::Track:
0419     Description: "Track information at the vertex"
0420     Author: "S. Joosten, J. Osborn"
0421     Members:
0422       - int32_t            type                           // Flag that defines the type of track
0423       - edm4hep::Vector3f  position                       // Track 3-position at the vertex 
0424       - edm4hep::Vector3f  momentum                       // Track 3-momentum at the vertex [GeV]
0425       - edm4eic::Cov6f     positionMomentumCovariance     // Covariance matrix in basis [x,y,z,px,py,pz]
0426       - float              time                           // Track time at the vertex [ns]
0427       - float              timeError                      // Error on the track vertex time
0428       - float              charge                         // Particle charge
0429       - float              chi2                           // Total chi2
0430       - uint32_t           ndf                            // Number of degrees of freedom
0431       - int32_t            pdg                            // PDG particle ID hypothesis
0432     OneToOneRelations:
0433       - edm4eic::Trajectory                     trajectory      // Trajectory of this track
0434     OneToManyRelations:
0435       - edm4eic::Measurement2D measurements      // Measurements that were used for this track
0436       - edm4eic::Track      tracks            // Tracks (segments) that have been combined to create this track
0437 
0438   edm4eic::TrackSegment:
0439     Description: "A track segment defined by one or more points along a track."
0440     Author: "S. Joosten"
0441     Members:
0442       - float             length            // Pathlength from the first to the last point
0443       - float             lengthError       // Error on the segment length
0444     OneToOneRelations:
0445       - edm4eic::Track    track             // Track used for this projection
0446     VectorMembers:
0447       - edm4eic::TrackPoint points          // Points where the track parameters were evaluated
0448 
0449   ## ==========================================================================
0450   ## Vertexing
0451   ## ==========================================================================
0452 
0453   edm4eic::Vertex:
0454     Description: "EIC vertex"
0455     Author: "J. Osborn"
0456     Members:
0457       - int32_t             type          // Type flag, to identify what type of vertex it is (e.g. primary, secondary, generated, etc.)
0458       - float               chi2          // Chi-squared of the vertex fit
0459       - int                 ndf           // NDF of the vertex fit
0460       - edm4hep::Vector4f   position      // position [mm] + time t0 [ns] of the vertex. Time is 4th component in vector
0461       ## this is named "covMatrix" in EDM4hep, renamed for consistency with the rest of edm4eic
0462       - edm4eic::Cov4f      positionError // Covariance matrix of the position+time. Time is 4th component, similarly to 4vector 
0463     OneToManyRelations:
0464       - edm4eic::ReconstructedParticle associatedParticles // particles associated to this vertex.
0465 
0466   ## ==========================================================================
0467   ## Kinematic reconstruction
0468   ## ==========================================================================
0469 
0470   edm4eic::InclusiveKinematics:
0471     Description: "Kinematic variables for DIS events"
0472     Author: "S. Joosten, W. Deconinck"
0473     Members:
0474       - float             x                 // Bjorken x (Q2/2P.q)
0475       - float             Q2                // Four-momentum transfer squared [GeV^2]
0476       - float             W                 // Invariant mass of final state [GeV]
0477       - float             y                 // Inelasticity (P.q/P.k)
0478       - float             nu                // Energy transfer P.q/M [GeV]
0479     OneToOneRelations:
0480       - edm4eic::ReconstructedParticle scat // Associated scattered electron (if identified)
0481       ## @TODO: Spin state?
0482       ## - phi_S?
0483 
0484   edm4eic::HadronicFinalState:
0485     Description: "Summed quantities of the hadronic final state"
0486     Author: "T. Kutz"
0487     Members:
0488       - float             sigma             // Longitudinal energy-momentum balance (aka E - pz)
0489       - float             pT                // Transverse momentum
0490       - float             gamma             // Hadronic angle
0491     OneToManyRelations:
0492       - edm4eic::ReconstructedParticle hadrons // Reconstructed hadrons used in calculation
0493 
0494   ## ==========================================================================
0495   ## Data-Montecarlo relations
0496   ## ==========================================================================
0497 
0498   edm4eic::MCRecoParticleAssociation:
0499     Description: "Used to keep track of the correspondence between MC and reconstructed particles"
0500     Author: "S. Joosten"
0501     Members:
0502       - uint32_t          simID             // Index of corresponding MCParticle (position in MCParticles array)
0503       - uint32_t          recID             // Index of corresponding ReconstructedParticle (position in ReconstructedParticles array)
0504       - float             weight            // weight of this association
0505     OneToOneRelations :
0506       - edm4eic::ReconstructedParticle rec  // reference to the reconstructed particle
0507       - edm4hep::MCParticle sim             // reference to the Monte-Carlo particle
0508 
0509   edm4eic::MCRecoClusterParticleAssociation:
0510     Description: "Association between a Cluster and a MCParticle"
0511     Author : "S. Joosten"
0512     Members:
0513       - uint32_t          simID             // Index of corresponding MCParticle (position in MCParticles array)
0514       - uint32_t          recID             // Index of corresponding Cluster (position in Clusters array)
0515       - float             weight            // weight of this association
0516     OneToOneRelations:
0517       - edm4eic::Cluster  rec               // reference to the cluster
0518       - edm4hep::MCParticle sim             // reference to the Monte-Carlo particle
0519 
0520   edm4eic::MCRecoTrackParticleAssociation:
0521     Description: "Association between a Track and a MCParticle"
0522     Author : "S. Joosten"
0523     Members:
0524       - uint32_t          simID             // Index of corresponding MCParticle (position in MCParticles array)
0525       - uint32_t          recID             // Index of corresponding Track (position in Tracks array)
0526       - float             weight            // weight of this association
0527     OneToOneRelations:
0528       - edm4eic::Track    rec               // reference to the track
0529       - edm4hep::MCParticle sim             // reference to the Monte-Carlo particle
0530 
0531   edm4eic::MCRecoVertexParticleAssociation:
0532     Description: "Association between a Vertex and a MCParticle"
0533     Author : "S. Joosten"
0534     Members:
0535       - uint32_t          simID             // Index of corresponding MCParticle (position in MCParticles array)
0536       - uint32_t          recID             // Index of corresponding Vertex (position in Vertices array)
0537       - float             weight            // weight of this association
0538     OneToOneRelations:
0539       - edm4eic::Vertex     rec             // reference to the vertex
0540       - edm4hep::MCParticle sim             // reference to the Monte-Carlo particle
0541 
0542   edm4eic::MCRecoTrackerHitAssociation:
0543     Description: "Association between a RawTrackerHit and a SimTrackerHit"
0544     Author: "C. Dilks, W. Deconinck"
0545     Members:
0546       - float                 weight        // weight of this association
0547     OneToOneRelations:
0548      - edm4eic::RawTrackerHit rawHit        // reference to the digitized hit
0549      - edm4hep::SimTrackerHit simHit       // reference to the simulated hit