HLT1 track reconstruction

Member functions of the RecoConf.legacy_rec_hlt1_tracking module are documented. The functions allow a flexible and comprehensive configuration of the HLT1 track reconstruction.

The central function of this module, which provides access to all types of tracks reconstructd in HLT1 is make_legacy_rec_hlt1_tracks. In addition an accessor to fitted forward tracks is provided by make_legacy_rec_hlt1_fitted_tracks.

Of special interest are the following higher level functions, to which the user can bind to for switching to a different reconstruction sequence:

Members of RecoConf.legacy_rec_hlt1_tracking

all_legacy_rec_hlt1_forward_track_types(input_tracks, make_forward_tracks=<FunctionWrapper at 0x7f319fae58e0 for function>)[source]

Helper function to get all types of HLT1 forward tracks.

Parameters
Returns

A dict mapping Pr, v1, v2 and v2Zip HLT1 forward tracks to 'Pr', 'v1', 'v2' and 'v2Zip' respectively.

all_upstream_track_types(velo_tracks, make_velo_ut_tracks=<FunctionWrapper at 0x7f319fae5580 for function>)[source]

Helper function to get all types of upstream tracks.

Parameters
Returns

A dict mapping Pr, v1 and v2 upstream tracks to 'Pr', 'v1' and 'v2' respectively.

all_velo_track_types(make_velo_tracks=<FunctionWrapper at 0x7f319fab2d60 for function>)[source]

Helper function to get all types of velo tracks.

Parameters

make_velo_tracks (DataHandle) – velo tracking algorithm, defaults to make_VeloClusterTrackingSIMD_tracks.

Returns

A dict mapping forward-, backward-going, v1 and v2 velo tracks to 'Pr', 'Pr::backward', 'v1' and 'v2' respectively.

filter_velo_tracks(make_velo_tracks=<FunctionWrapper at 0x7f319fab2d60 for function>, fwdTracksFunctor=('::Functors::AcceptAll{}', 'ALL'), bwdTracksFunctor=('::Functors::AcceptAll{}', 'ALL'))[source]

Helper function to filter the Velo tracks

Parameters

  • make_velo_tracks (DataHandle) – velo tracking algorithm, defaults to make_VeloClusterTrackingSIMD_tracks.

  • fwdTracksFunctor – Functor to filter the forward Velo tracks

  • bwdTracksFunctor – Functor to filter the backward Velo tracks

Returns

A dict mapping forward- and backward-going tracks to 'Pr' and 'Pr::backward', respectively.

make_FTRawBankDecoder_clusters(make_raw=<FunctionWrapper at 0x7f319fe15340 for function>)[source]

Decodes the FT raw bank into FTLiteClusters. DecodingVersion set by default_ft_decoding_version.

Parameters

make_raw (DataHandle) – RawEventLocation for VeloClusterTrackingSIMD, defaults to default_raw_banks.

Returns

FTRawBankDecoder’s OutputLocation.

Return type

DataHandle

make_PatPV3DFuture_pvs(velo_tracks, location, use_beam_spot_cut=True, velo_open=False, use_3D_seeding=False)[source]

Makes primary vertices from velo tracks using PatPV3DFuture.

Parameters

velo_tracks (dict) – velo tracks, needs 'v2' tracks, e.g. from all_velo_track_types

Returns

PatPV3DFuture’s OutputVerticesName

Return type

DataHandle

Note

PatPV3DFuture’s defaults have been overridden in this maker with BeamSpotRCut=0.6, UseBeamSpotRCut=True, minClusterMult=4.

make_PrStorePrUTHits_empty_hits()[source]

Creates an empty container of UT hits, used for the no UT scenario.

Returns

PrStorePrUTHitsEmptyProducer’ Output.

Return type

DataHandle

make_PrStorePrUTHits_hits(make_raw=<FunctionWrapper at 0x7f319fe15340 for function>, isCluster=True, positionMethod='GeoWeighting')[source]

Decodes UT hits from raw data, fills an SOA container.

Parameters

  • make_raw (DataHandle) – RawEventLocation for VeloClusterTrackingSIMD, defaults to default_raw_event.

  • isCluster (bool) – True to enable clustering, defaults to True.

  • positionMethod (str) – available options “MaxAdc”, “AdcWeighting”, “GeoWeighting”, defaults to “GeoWeighting”

Returns

PrStorePrUTHits’ UTHitsLocation.

Return type

DataHandle

make_PrVeloUT_tracks(velo_tracks, make_ut_hits=<FunctionWrapper at 0x7f319fae5280 for function>)[source]

Makes upstream tracks from velo tracks and UT hits.

Parameters
Returns

PrVeloUT’s OutputTracksName.

Return type

DataHandle

make_RetinaCluster_raw_bank(detector=None, make_raw=<FunctionWrapper at 0x7f319fe15340 for function>)[source]

Makes velo clusters with VPRetinaClusterCreator.

Parameters

make_raw (DataHandle) – RawEventLocation for VPRetinaClusterCreator, defaults to default_raw_vent.

Returns:

make_RetinaClusters(detector=None, make_raw=<FunctionWrapper at 0x7f319fe15340 for function>)[source]

Decodes RetinaClusters with VPRetinaClusterDecoder.

Parameters

make_raw (DataHandle) – RawBankLocation for VPRetinaClusterCreator, defaults to default_raw_banks.

Returns

vector<LHCb::VPLightCluster>

make_SPmixed_raw_banks(detector=None, make_raw=<FunctionWrapper at 0x7f319fe15340 for function>)[source]

Mix SP.

Parameters

make_raw (DataHandle) – RawBanks for VPRetinaSPmixer, defaults to default_raw_banks.

Returns:

make_SciFiTrackForwardingStoreHit_hits(make_ft_clusters=<function make_FTRawBankDecoder_clusters>)[source]

Transforms FTLiteClusters into the input format needed by the SciFiTrackForwarding.

Parameters

make_ft_clusters (DataHandle) – maker of FT clusters, defaults to make_FTRawBankDecoder_clusters.

Returns

SciFiTrackForwardingStoreHit’s Output.

Return type

DataHandle

make_SciFiTrackForwarding_tracks(input_tracks, make_ft_hits=<FunctionWrapper at 0x7f319fae5700 for function>)[source]

Makes forward tracks with SciFiTrackForwarding (long tracks from upstream seeds).

Parameters
Returns

SciFiTrackForwarding’s Output.

Return type

DataHandle

make_TrackBeamLineVertexFinderSoA_pvs(velo_tracks, location, minz=None)[source]

Makes primary vertices from velo tracks using TrackBeamLineVertexFinderSoA.

Parameters

velo_tracks (dict) – velo tracks, needs 'Pr' and 'Pr::backward' tracks, e.g. from all_velo_track_types.

Returns

TrackBeamLineVertexFinderSoA’s OutputVertices.

Return type

DataHandle

make_VPClus_location_and_offsets()[source]

Makes velo clusters with VPClus

Returns

A dict mapping VPClus’ ClusterLocation and ClusterOffsets DataHandles to 'Location' and 'Offsets' respectively.

make_VeloClusterTrackingSIMD(algorithm=None, make_raw=<FunctionWrapper at 0x7f319fe15340 for function>, masked_sensors=[], MaxScatterSeeding=0.1, MaxScatterForwarding=0.1, MaxScatter3hits=0.02, SkipForward=1)[source]

Simple helper to make sure both, make_VeloClusterTrackingSIMD_tracks and make_VeloClusterTrackingSIMD_hits, access the identically configured version of VeloClusterTrackingSIMD

Args: make_raw (DataHandle): RawEventLocation for VeloClusterTrackingSIMD, defaults to default_raw_banks; algorithm: The Velo tracking algorithm to run; masked_sensors: List of unique sensor IDs that will not be considered in the pattern reco’s tracks, but are included in the clusters returned.

Returns: The Velo tracking algorithm.

make_VeloClusterTrackingSIMD_hits(make_tracks=<FunctionWrapper at 0x7f319faba100 for function>)[source]

Makes velo hits with VeloClusterTrackingSIMD

Parameters

make_tracks (DatHandle) – The function that returns the Velo tracking algorithm.

Returns

VeloClusterTrackingSIMD’s HitsLocation.

Return type

DataHandle

make_VeloClusterTrackingSIMD_tracks(make_tracks=<FunctionWrapper at 0x7f319faba100 for function>)[source]

Makes velo tracks with VeloClusterTrackingSIMD.

Args: make_tracks (DataHandle): The function that returns the Velo tracking algorithm.

Returns

A dict mapping forward- and backward-going velo tracks to 'Pr' and 'Pr::backward' respectively.

make_VeloKalman_fitted_tracks(tracks, make_hits=<FunctionWrapper at 0x7f319fabad00 for function>, make_unique_id_generator=<function make_unique_id_generator>)[source]

Fits tracks with VeloKalman.

Parameters

  • tracks (dict of dicts) – input tracks to VeloKalman. It will consume ["Velo"]["Pr"] and ["Forward"]["Pr"] tracks.

  • make_hits (DataHandle) – maker of velo hits, defaults to make_VeloClusterTrackingSIMD_hits.

  • make_unique_id_generator (DataHandle) – maker of the ID generator object, defaults to make_unique_id_generator.

Returns

A dict mapping Pr, v1, v2, v1Sel, v2Sel, v2Zip and v2ZipSel fitted forward tracks to 'Pr', 'v1', 'v2', 'v1Sel', 'v2Sel', 'v2Zip' and 'v2ZipSel' respectively.

make_all_pvs()[source]

Makes PVs from HLT1 inputs, i.e. from all_velo_track_types using the PV maker passed to make_reco_pvs

Returns

dictionary of v1 and v3 PVs

make_fitted_forward_tracks_with_pv_relations(tracks, make_pvs=<function make_pvs>)[source]

Zips fitted forward tracks with their best PV.

Parameters

  • tracks (dict) – fitted forward tracks as input to MakeZip__PrFittedForwardTracks__BestVertexRelations, needs ["Pr"] tracks, e.g. from make_VeloKalman_fitted_tracks.

  • make_pvs (DataHandle) – maker of PVs, defaults to make_pvs.

Returns

A dict mapping tracks zipped with PV relations to 'PrFittedForwardWithPVs'.

make_legacy_rec_hlt1_fitted_tracks(tracks, make_forward_fitted_tracks=<FunctionWrapper at 0x7f319fae5a00 for function>)[source]

Helper function to bind to for passing forward fitted tracks.

Parameters

  • tracks (dict of dicts) – input tracks to the track fitter, i.e. to make_forward_fitted_tracks, e.g. from make_legacy_rec_hlt1_tracks.

  • make_forward_fitted_tracks (DataHandle) – track fitter, defaults to make_VeloKalman_fitted_tracks.

Returns

A dict of fitted tracks. The content depends on the input maker

make_legacy_rec_hlt1_tracks()[source]

Function to get all types of tracks reconstructed in HLT1

Returns

A dict mapping all types of velo, upstream and HLT1 forward tracks to 'Velo', 'Upstream' and 'Forward' respectively.

make_pvs()[source]

Makes PVs from HLT1 inputs, i.e. from all_velo_track_types using the PV maker passed to make_reco_pvs

Returns

primary vertices

Return type

DataHandle

make_reco_pvs(velo_tracks, location, make_pvs_from_velo_tracks=<FunctionWrapper at 0x7f319fb1ae20 for function>)[source]

Makes PVs from velo tracks given a PV algorithm.

Parameters
Returns

Output of make_pvs_from_velo_tracks

Return type

DataHandle