feat: Add support for passing clusters to calibrator

[gagnonlg]

Currently, the measurement calibrators in TrackFittingAlgorithm do not have access to cluster-level information. One widely-used pattern in the real world is to apply different calibrations depending on the cluster dimensions for instance, so this information is useful. This PR adds an optional input to the TrackFittingAlgorithm which is handed down through the MeasurementCalibrator interface. The reference to the cluster collection is boxed in a std::optional<std::reference_wrapper> to simplify the interface.

Ping @benjaminhuth for comments

[benjaminhuth]

Just a comment: For me there is not real semantical advantage of an std::optional<std::reference_wrapper<const T>> to a const T*.

I think I would actually go for const T* in such a case, because it is less verbose. But of course this is only my opinion, feel free to ignore it :)

[codecov]

Codecov Report

Merging #2078 (d8d4372) into main (37bc755) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main    #2078   +/-   ##
=======================================
  Coverage   49.31%   49.31%           
=======================================
  Files         427      427           
  Lines       24828    24828           
  Branches    11444    11444           
=======================================
  Hits        12245    12245           
  Misses       4514     4514           
  Partials     8069     8069           

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[github-actions]

📊 Physics performance monitoring for d8d4372

Full report
Seeding: seeded, truth estimated, orthogonal
CKF: seeded, truth smeared, truth estimated, orthogonal
IVF: seeded, truth smeared, truth estimated, orthogonal
Ambiguity resolution: seeded, orthogonal
Truth tracking
Truth tracking (GSF)

Vertexing

Vertexing vs. mu

IVF seeded

IVF truth_smeared

IVF truth_estimated

IVF orthogonal

Seeding

Seeding seeded

Seeding truth_estimated

Seeding orthogonal

CKF

CKF seeded

CKF truth_smeared

CKF truth_estimated

CKF orthogonal

Ambiguity resolution

seeded

Truth tracking (Kalman Filter)

Truth tracking

Truth tracking (GSF)

Truth tracking

[gagnonlg]

@benjaminhuth I think you're right -- I actually considered it but of course I couldn't miss an opportunity to over-engineer the thing! I'll update the PR.

EDIT: now done, thanks.