Add ALCARECO skims (KS, Lambda, D*, J/psi, Upsilon, Z) and persist resonance candidates

[davidwalter2]

Summary

Adds ALCARECO skims for the muon-momentum-scale calibration covering V0
(KS, Lambda), three-body (D*) and dimuon (J/psi, Upsilon, Z) channels, and
persists a reco::VertexCompositeCandidateCollection per stream so
downstream consumers can iterate the candidates and follow daughter
TrackRefs into the cloned ALCAReco track collection without going back
to generalTracks:

• TkAlKsToPiPi — V0 (KS → π⁺π⁻)
• TkAlLambdaToProtonPi — V0 (Λ → pπ⁻)
• TkAlDstToD0Pi — D*⁺ → D⁰(K⁻π⁺) πs⁺ (three-track topology with a soft-pion tag)
• TkAlJpsiMuMu, TkAlUpsilonMuMu, TkAlZMuMu — dimuon resonances (V0-pattern: candidate is built upstream by TwoBodyDecayCandidateProducer)

Each skim stores the daughter tracks (cloned, with hits + clusters) and
publishes a *Resonances candidate collection with daughter TrackRefs
into the cloned tracks. Selection cuts (mass window, charge, V0 Lxy /
cosθXY) are applied at the candidate-builder level.

What's in this PR

Six commits on top of 6e29f933a55:

1. 0960cf87c4f — Infrastructure for TkAlDstToD0Pi (Elisabetta Manca): three-body decay selector module + ALCARECO cff + validation analyzer
2. 37b68d22f1f — Removes the validation analyzer (kept the selector)
3. 3149b4a77a1 — Removes HLT preselection so the ALCARECO is usable across triggers
4. 1d2bf1a7599 — Adds TkAlKsToPiPi + TkAlLambdaToProtonPi V0 skims via AlignmentTracksFromV0Selector
5. c932a392d9d — Replaces AlignmentTracksFromV0Selector with V0DaughterTrackProducer (extracts daughter tracks from a private ALCARECOTkAlV0Candidates collection — a clone of generalV0Candidates with a lower track-pT cut, leaving the standard reco V0 collection untouched). Adds optional per-track dE/dx ValueMap projection (strip / pixel / joint Harmonic-2) for downstream particle-ID.
6. df64a66c5fb — Persists the resonance-candidate collection for every stream and adds dimuon streams (J/psi, Upsilon, Z) on the V0 pattern.

Commit 6 details

• TwoBodyDecayCandidateProducer: builds a VertexCompositeCandidateCollection from opposite-sign track pairs in a configurable mass window, with optional muon-ID prefilter via muonSrc. Replaces the in-AlignmentTrackSelector pair finding for the dimuon streams; daughters use V0Producer's positive-charge-first convention.
• AlignmentTrackSelectorWithIndexMapModule: drop-in replacement for AlignmentTrackSelectorModule that, alongside the standard cloned Track + TrackExtra + RecHit + Cluster outputs, emits an edm::ValueMap<unsigned int> (instance label originalIndex) of source-collection indices computed by pointer arithmetic on the selector chain's Track* output. No kinematic fingerprinting. Required because helper::TrackCollectionStoreManager::processTrack rewrites the cloned tracks' TrackExtraRefs to a fresh sequential key, destroying the link to generalTracks.
• VertexCompositeCandidateRemapper: rewrites each candidate's daughter TrackRefs to point at the cloned ALCAReco track collection via the originalIndex ValueMap chain (selH idx → intermediateTracks idx → intermediateTracks.extra().key() = generalTracks idx). Recurses into nested composites (e.g. for B → J/psi K).
• Bug fix in DeDxValueMapProjector: previously used selectedTrack.extra().key() as the source-track index, but after TrackCollectionStoreManager's clone-and-store that key is just the position in the new collection (0,1,2,…). The persisted dE/dx values for V0 / D* daughters were therefore values of unrelated generalTracks[j] entries. Switched to the same originalIndex chain.
• All six streams' cffs rewired to publish a *Resonances VertexCompositeCandidateCollection alongside the cloned-track output; the corresponding _Output_cff.py files keep the new products.
• Adds recoskim_Run2016G_SingleMuon_AllResonances.py covering all streams in a single test job; removes the older partial test configs (Dst, KsLambda, KsLambdaDst).

New plugins

• Alignment/CommonAlignmentProducer/plugins/V0DaughterTrackProducer.cc — KS / Λ daughter extraction
• Alignment/CommonAlignmentProducer/src/AlignmentThreeBodyDecayTrackSelector.cc — D* daughter selection (used by the existing AlignmentTrackSelectorModule)
• Alignment/CommonAlignmentProducer/plugins/DeDxValueMapProjector.cc — per-track dE/dx ValueMap projector (now ref-based via originalIndex)
• Alignment/CommonAlignmentProducer/plugins/TwoBodyDecayCandidateProducer.cc — dimuon candidate builder
• Alignment/CommonAlignmentProducer/plugins/AlignmentTrackSelectorWithIndexMapModule.cc — selector + originalIndex ValueMap
• Alignment/CommonAlignmentProducer/plugins/VertexCompositeCandidateRemapper.cc — candidate daughter-ref remapper

New cff/cfi

• ALCARECOTkAlV0Candidates_cff.py (private V0Producer clone)
• ALCARECOTkAl{KsToPiPi,LambdaToProtonPi,DstToD0Pi,JpsiMuMu,UpsilonMuMu,ZMuMu}_cff.py + each _Output_cff.py
• alcaDedxJointEstimator_cfi.py
• AlignmentTrackSelectorWithIndexMap_cfi.py

Plus updates to BuildFile.xml, AlCaRecoOutput_cff.py, AlCaRecoStreams_cff.py, and AlignmentTrackSelector_cfi.py.

Test plan

• Build with scram b -j16 in CMSSW_10_6_17_patch1
• Run on 1 RAW file (1000 events SingleMuon Run2016G + 1 file Charmonium); verify all six streams produce expected outputs and edmDumpEventContent shows the new *_*Resonances_*_* candidate branches
• Verify candidate daughter TrackRefs resolve into the cloned ALCAReco track collection (100% id-match on the first candidate of every event across all streams)
• Verify dE/dx values are physical (mean ~2.8 MeV/cm, sd ~1, broad value uniqueness — confirms the originalIndex-chain bug fix)
• Larger production: 100 RAW Charmonium files (run 279654, ~50k events × 10 parallel jobs × 16 threads) — ~30 min wallclock
• Stage-2 CVH 9-variant scan (KS, Λ, J/psi × no-vtx/vtx/vtx+pointing) on the 100-file ALCAReco — 9/9 success, J/psi mass peaks at 3.093 ± 0.068 GeV

🤖 Generated with Claude Code