MagneticFieldFilter

Line Code
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113
// -*- C++ -*-
//
// Package:    Alignment/CommonAlignment
// Class:      MagneticFieldFilter
//
/**\class MagneticFieldFilter MagneticFieldFilter.cc Alignment/CommonAlignment/plugins/MagneticFieldFilter.cc

 Description: Plugin to filter events based on the magnetic field value

 Implementation:
     Takes the magnet current from the RunInfoRcd and translates it into a
     magnetic field value using the parameterization given here:

     https://hypernews.cern.ch/HyperNews/CMS/get/magnetic-field/63/1/1/1.html

     Agrees within an accuracy of ~20 mT with results of:
     https://cmswbm.web.cern.ch/cmswbm/cmsdb/servlet/RunSummary

*/
//
// Original Author:  Gregor Mittag
//         Created:  Wed, 25 Nov 2015 12:59:02 GMT
//
//

// user include files
#include "FWCore/Framework/interface/Frameworkfwd.h"
#include "FWCore/Framework/interface/MakerMacros.h"
#include "FWCore/Framework/interface/EventSetup.h"
#include "FWCore/Framework/interface/stream/EDFilter.h"
#include "FWCore/ParameterSet/interface/ParameterSet.h"
#include "CondFormats/RunInfo/interface/RunInfo.h"
#include "CondFormats/DataRecord/interface/RunSummaryRcd.h"

//
// class declaration
//

class MagneticFieldFilter : public edm::stream::EDFilter<> {
public:
  explicit MagneticFieldFilter(const edm::ParameterSet&);
  ~MagneticFieldFilter() override = default;

  static void fillDescriptions(edm::ConfigurationDescriptions&);

private:
  bool filter(edm::Event&, const edm::EventSetup&) override;
  void beginRun(const edm::Run&, const edm::EventSetup&) override;

  /// convert Ampere (A) to Tesla (T)
  float currentToField(const float& current) const;

  // ----------member data ---------------------------

  // esConsumes
  const edm::ESGetToken<RunInfo, RunInfoRcd> runInfoToken_;

  /// see: https://hypernews.cern.ch/HyperNews/CMS/get/magnetic-field/63/1/1/1.html
  static constexpr float linearCoeffCurrentToField_ = 2.084287e-04;
  /// see: https://hypernews.cern.ch/HyperNews/CMS/get/magnetic-field/63/1/1/1.html
  static constexpr float constantTermCurrentToField_ = 1.704418e-02;

  const int magneticField_;      /// magnetic field that is filtered
  int magneticFieldCurrentRun_;  /// magnetic field estimate of the current run
};

//
// static data member definitions
//
constexpr float MagneticFieldFilter::linearCoeffCurrentToField_;
constexpr float MagneticFieldFilter::constantTermCurrentToField_;

//
// constructor
//
MagneticFieldFilter::MagneticFieldFilter(const edm::ParameterSet& iConfig)
    : runInfoToken_(esConsumes<edm::Transition::BeginRun>()),
      magneticField_(iConfig.getUntrackedParameter<int>("magneticField")),
      magneticFieldCurrentRun_(-10000) {}

//
// member functions
//

// ------------ method called on each new Event  ------------
bool MagneticFieldFilter::filter(edm::Event&, const edm::EventSetup&) {
  return magneticField_ == magneticFieldCurrentRun_;
}

// ------------ method called when starting to processes a run  ------------

void MagneticFieldFilter::beginRun(const edm::Run&, const edm::EventSetup& iSetup) {
  const auto& summary = &iSetup.getData(runInfoToken_);
  // convert from Tesla to kGauss (multiply with 10) and
  // round off to whole kGauss (add 0.5 and cast to int) as is done in
  // 'MagneticField::computeNominalValue()':
  magneticFieldCurrentRun_ = static_cast<int>(currentToField(summary->m_avg_current) * 10.0 + 0.5);
}

float MagneticFieldFilter::currentToField(const float& current) const {
  return linearCoeffCurrentToField_ * current + constantTermCurrentToField_;
}

// ------------ method fills 'descriptions' with the allowed parameters for the module  ------------
void MagneticFieldFilter::fillDescriptions(edm::ConfigurationDescriptions& descriptions) {
  edm::ParameterSetDescription desc;
  desc.setComment("Filters events with a magnetic field of 'magneticField'.");
  desc.addUntracked<int>("magneticField", 38)->setComment("In units of kGauss (= 0.1 Tesla).");
  descriptions.add("magneticFieldFilter", desc);
}

//define this as a plug-in
DEFINE_FWK_MODULE(MagneticFieldFilter);