Acts/TrackFitting/GsfMixtureReduction.hpp

0001 // This file is part of the ACTS project.
0002 //
0003 // Copyright (C) 2016 CERN for the benefit of the ACTS project
0004 //
0005 // This Source Code Form is subject to the terms of the Mozilla Public
0006 // License, v. 2.0. If a copy of the MPL was not distributed with this
0007 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
0008
0009 #pragma once
0010
0011 #include "Acts/Surfaces/Surface.hpp"
0012 #include "Acts/TrackFitting/GsfComponent.hpp"
0013
0014 namespace Acts {
0015
0016 /// Very simple mixture reduction method: Just removes the components with the
0017 /// smallest weight until the required number of components is reached
0018 /// @param cmpCache the component collection
0019 /// @param maxCmpsAfterMerge the number of components we want to reach
0020 /// @param surface the surface type on which the components are (unused here)
0021 /// @ingroup track_fitting
0022 void reduceMixtureLargestWeights(std::vector<GsfComponent> &cmpCache,
0023                                  std::size_t maxCmpsAfterMerge,
0024                                  const Surface &surface);
0025
0026 /// Greedy component reduction algorithm. Reduces the components with the
0027 /// minimal symmetric KL-distance (applied only to the q/p-dimension) until the
0028 /// required number of components is reached.
0029 /// @param cmpCache the component collection
0030 /// @param maxCmpsAfterMerge the number of components we want to reach
0031 /// @param surface the surface type on which the components are
0032 /// @ingroup track_fitting
0033 void reduceMixtureWithKLDistance(std::vector<GsfComponent> &cmpCache,
0034                                  std::size_t maxCmpsAfterMerge,
0035                                  const Surface &surface);
0036
0037 /// Naive implementation of component reduction with KL-distance. Recomputes all
0038 /// distances in every iteration without any caching or optimization. This
0039 /// serves as a baseline for testing and benchmarking the optimized version.
0040 /// @param cmpCache the component collection
0041 /// @param maxCmpsAfterMerge the number of components we want to reach
0042 /// @param surface the surface type on which the components are
0043 void reduceMixtureWithKLDistanceNaive(std::vector<GsfComponent> &cmpCache,
0044                                       std::size_t maxCmpsAfterMerge,
0045                                       const Surface &surface);
0046
0047 }  // namespace Acts