Plugins/DD4hep/DD4hepMaterialHelpers.hpp

0001 // This file is part of the Acts project.
0002 //
0003 // Copyright (C) 2019 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 http://mozilla.org/MPL/2.0/.
0008
0009 #pragma once
0010
0011 #include "Acts/Material/ProtoSurfaceMaterial.hpp"
0012 #include "Acts/Utilities/BinningData.hpp"
0013 #include "Acts/Utilities/BinningType.hpp"
0014 #include "Acts/Utilities/Logger.hpp"
0015
0016 #include <memory>
0017 #include <string>
0018 #include <utility>
0019 #include <vector>
0020
0021 #include <DD4hep/DetElement.h>
0022 #include <DD4hep/DetFactoryHelper.h>
0023 #include <DDRec/DetectorData.h>
0024
0025 namespace Acts {
0026
0027 class Layer;
0028
0029 /// Helper method to translate DD4hep material to Acts::ISurfaceMaterial
0030 ///
0031 /// This is used to assign proto material to Cylinder Layers
0032 ///
0033 /// @param detElement the DD4hep detector element for which this material is
0034 ///                   assigned
0035 /// @param cylinderLayer is the target layer
0036 /// @param logger a @c Logger for output
0037 void addCylinderLayerProtoMaterial(dd4hep::DetElement detElement,
0038                                    Layer& cylinderLayer,
0039                                    const Logger& logger = getDummyLogger());
0040
0041 /// Helper method to translate DD4hep material to Acts::ISurfaceMaterial
0042 ///
0043 /// Thisis used to assign proto material to Disc Layers
0044 ///
0045 /// @param detElement the DD4hep detector element for which this material is
0046 /// assigned
0047 /// @param discLayer is the target layer
0048 /// @param logger a @c Logger for output
0049 void addDiscLayerProtoMaterial(dd4hep::DetElement detElement, Layer& discLayer,
0050                                const Logger& logger = getDummyLogger());
0051
0052 /// Helper method to be called for Cylinder and Disc Proto material
0053 ///
0054 /// For both, cylinder and disc, the closed binning value is "binPhi"
0055 ///
0056 /// @param params An instance of @c DD4hep::VariantParameters
0057 /// @param layer the Layer to assign the proto material
0058 /// @param binning the Binning prescription for the ActsExtension
0059 /// @param logger a @c Logger for output
0060 void addLayerProtoMaterial(
0061     const dd4hep::rec::VariantParameters& params, Layer& layer,
0062     const std::vector<std::pair<const std::string, Acts::BinningOption> >&
0063         binning,
0064     const Logger& logger = getDummyLogger());
0065
0066 /// Helper method to create proto material - to be called from the
0067 /// addProto(...) methods
0068 ///
0069 /// @param params An instance of @c DD4hep::VariantParameters
0070 /// @param valueTag the xml tag for to ActsExtension to be parsed
0071 /// @param binning the Binning prescription for the ActsExtension
0072 /// @param logger a @c Logger for output
0073 std::shared_ptr<Acts::ProtoSurfaceMaterial> createProtoMaterial(
0074     const dd4hep::rec::VariantParameters& params, const std::string& valueTag,
0075     const std::vector<std::pair<const std::string, Acts::BinningOption> >&
0076         binning,
0077     const Logger& logger = getDummyLogger());
0078
0079 }  // namespace Acts