the sources were copied from the branch kbunkow/from-CMSSW_11_1_3_KB_v3
and modified:
-	changing the include path of the CSCConstants.h,
-	adding some missing root includes
-	XMLConfigReader::readLUTs - fill distPhiShift in the LUTs; calculating
totalInWidth (previously the values were hardcoded);  added flag
useMeanDistPhi1 (set to false); added parameter buildEmptyPatterns in
the readPatterns
-	ProcessorBase::configure - initializing distPhiShift from LUT
-	L1TMuonOverlapPhase1ParamsESProducer::readPatternsXML  -  added
reading selDistPhiShift to the LUTs
-	OMTFConfiguration::configure - added setup for the fwVersion() == 8

combination of 4 commits:
1) GoldenPatternVec = std::vector<std::unique_ptr<GoldenPatternType> >

OMTFReconstruction::beginRun modified to adapted to the GoldenPatternVec
and other changes

added calss EmulationObserverBase
PatternOptimizerBase::observeProcesorEmulation and findSimMuon moved
there

DataROOTDumper2 inherits from EmulationObserverBase, removing
omtfGpResultsPdfSum and omtfGpResultsFiredLayers from OmtfEvent,
removing gpResultsToPt

removing DataROOTDumper

EventCapture - goldenPatterns is pointer now

removed OMTFSorterWithThreshold

removed PatternsPtAssignment

ProcessorBase<GoldenPatternType>::setGPs removed, code moved to
constructor
2) added L1T_OmtfP1_ prefix in the include guards in header files

3) using ESWatcher<L1TMuonOverlapParamsRcd> in the OMTFReconstruction

to prevent the patterns re-creation every run start (if the patterns are
created from the EventSetup, and not directly from the xml)

4) L1TMuonOverlapPhase1TrackProducer inherits from  edm::one::EDProducer

with edm::one::WatchRuns customization

a combination of 10 commits:

1) updating runMuonOvelpap*.py and some .gitignore

commiting
L1Trigger/L1TMuon/data/omtf_config/Patterns_0x00012_oldSample_3_30Files_grouped1_classProb17_recalib2.xml

2) replacing edm::LogImportant with LogVerbatim in a few places

3) fixes from scram build code-checks

4) changes from scram build code-format

5) changes from scram build code-format

6) a small fix

7) added OMTFConfiguration::printConfig()

8) changing simOmtfPhase1Digis to simOmtfDigis in the .py files

In the
L1Trigger/L1TMuonOverlapPhase1/python/simOmtfPhase1Digis_cfi.py
changing the EDProducer("L1TMuonOverlapPhase1TrackProducer" name from
simOmtfPhase1Digis to simOmtfDigis - this will allow avoid changing this
name in many .py files in different places in the CMSSW.
Consequently, this name is changed in all .py files in the
L1Trigger/L1TMuonOverlapPhase1/test

9) setting dumpResultToXML = cms.bool(False)

commenting out ghostBusterType

10) renaming simOmtfPhase1Digis_cfi.py to simOmtfDigis_cfi.py

in L1Trigger/L1TMuonOverlapPhase1/python/simOmtfDigis_cfi.py:
- removing ghostBusterType
- removing bxMin and bxMin, so that the default value 0-0 is used

updating all run*.py files in the L1Trigger/L1TMuonOverlapPhase1/test
- simOmtfPhase1Digis_cfi > simOmtfDigis_cfi
- setting bxMin = 0 and bxMax = 0

In
DQM/L1TMonitor/python/L1TStage2Emulator_cff.py
and
L1Trigger/L1TMuon/python/simDigis_cff.py
changing:
L1Trigger.L1TMuonOverlap.simOmtfDigis_cfi to
L1Trigger.L1TMuonOverlapPhase1.simOmtfDigis_cfi

addionally in L1TStage2Emulator_cff.py setting
bxMin = cms.int32(-3),
bxMax = cms.int32(4)
for valOmtfDigis (i.e. simOmtfDigis)

deleting L1Trigger/L1TMuon/data/omtf_config

deleting some files from L1Trigger/L1TMuonOverlapPhase1/test/expert/omtf
old py files, or some that are using the L1MuonAnalyzerOmtf from the
usercode

removing test/runMuonOverlapWriteToXml.py

In AngleConverterBase.cc and OmtfAngleConverter.cc getGlobalEtaDt and getGlobalEtaDt: removing not needed usage of unique_ptr with DTTrigGeom and DTChamber. Making bounds const

OMTFinputMaker.cc  CscDigiToStubsConverterOmtf::acceptDigi: moving declaration of the aMin and aMax

OMTFReconstruction.cc:  adding protection against building OMTFProcessor  with omtfParams = nullptr

in OmtfAngleConverter.h adding
using AngleConverterBase::getGlobalEta
to avoid  Clang Warnings "hides overloaded virtual functions"

adding missing const to AngleConverterBase::getGlobalEta

removing
L1Trigger/L1TMuonOverlapPhase1/interface/Tools/PatternOptimizer.h

removing gpProbabilityStat from
L1Trigger/L1TMuonOverlapPhase1/interface/Omtf/GoldenPatternWithStat.h

rebased to the CMSSW_12_1_X_2021-09-20-2300

removing commented old pieces of code, cleaning up codes in many places

LogTrace("l1tOmtfEventPrint") is used instead of cout in commented debug
code

removing not needed use of unique_ptr in Omtf/OmtfAngleConverter.cc and
AngleConverterBase.cc

constructor of OMTFinputMaker: argument angleConverter is now unique_ptr
- to make sure OMTFinputMaker take the ownership of the angleConverter

removed GpResultsToPt.h and GpResultsToPt.cc

adding test/runMuonOverlap_run2_data.py,  runMuonOverlap_run3_data.py,
runMuonOverlap_run3_mc.py

in the L1Trigger/L1TMuonOverlapPhase1/python/simOmtfDigis_cfi.py: adding
bxMin and bxMx as cms.int32 (with defoult values i.e. 0)

in the DQM/L1TMonitor/python/L1TStage2Emulator_cff.py
not using cms.int32 for simOmtfDigis.bxMin and bxMax, but ordinary
numbers