Warning, /L1TriggerConfig/Utilities/test/README.md is written in an unsupported language. File is not indexed.
0001 ## Dumping XML configuration from the Online DB to local files
0002
0003 The whole trigger system's online configuration is aggregated by two top-level keys: *Trigger System Configuration*
0004 (TSC) key and *Run Settings* (RS) key. These keys are prepared by the Level-1 Detector On Call (L1 DOC) shifter and
0005 utilized every time when a new data taking is started. You can check the XML configuration for the specific TSC
0006 and RS keys using the [L1 Configuration Editor](https://l1ce.cms) (assuming you are within .cms network or use a
0007 tunnel) or alternatively, using following python scripts:
0008 [ugtDump.py](https://github.com/kkotov/cmssw/blob/o2oUtilities92X/L1TriggerConfig/Utilities/test/ugtDump.py),
0009 [ugmtDump.py](https://github.com/kkotov/cmssw/blob/o2oUtilities92X/L1TriggerConfig/Utilities/test/ugmtDump.py),
0010 [caloDump.py](https://github.com/kkotov/cmssw/blob/o2oUtilities92X/L1TriggerConfig/Utilities/test/caloDump.py),
0011 [emtfDump.py](https://github.com/kkotov/cmssw/blob/o2oUtilities92X/L1TriggerConfig/Utilities/test/emtfDump.py),
0012 [omtfDump.py](https://github.com/kkotov/cmssw/blob/o2oUtilities92X/L1TriggerConfig/Utilities/test/omtfDump.py),
0013 [bmtfDump.py](https://github.com/kkotov/cmssw/blob/o2oUtilities92X/L1TriggerConfig/Utilities/test/bmtfDump.py).
0014 These scripts can be ran from my afs public area on lxplus as well as within the private .cms network from
0015 ~l1emulator/o2o/. For example:
0016
0017 lxplus> python ~kkotov/public/bmtfDump.py l1\_trg\_cosmics2017/v75 l1\_trg\_rs\_cosmics2017/v57
0018
0019 dumps the Barrel Muon Track-Finder trigger configuration for TSC\_KEY=l1\_trg\_cosmics2017/v75 and
0020 RS\_KEY=l1\_trg\_rs\_cosmics2017/v57 into several local XML files. For arguments you can use both: top-level
0021 TSC and RS keys (as in the example above) and system-specific TSC and RS keys
0022 (it could have been bmtf\_cosmics\_2017/v4 bmtf\_rs\_base\_2017/v1 in the example above).
0023
0024 The L1T O2O framework manages a set of XML parsers (referred to as [Online Producers](https://github.com/cms-sw/cmssw/tree/master/L1TriggerConfig/L1TConfigProducers/src))
0025 that can be run individually as, for example, shown in [runOneByOne.sh](https://github.com/cms-sw/cmssw/blob/master/L1TriggerConfig/Utilities/test/runOneByOne.sh)
0026 script as well as in one go using the framework. In the first case you can run the script from lxplus or .cms:
0027
0028 lxplus> ~kkotov/python/runOneByOne.sh l1\_trg\_cosmics2017/v75 l1\_trg\_rs\_cosmics2017/v57
0029
0030 ssh cms-conddb-1.cms '/data/O2O/L1T/runOneByOne.sh l1\_trg\_cosmics2017/v75 l1\_trg\_rs\_cosmics2017/v57'
0031
0032 The result of running the script is a comprehensive printout the last two lines of which will summarize if
0033 any problems were encountered parsing the configuration XMLs. In addition, an l1config.db sqlite file will
0034 contain all of the successfully produced payloads ready to be used with the L1 trigger emulators in CMSSW.
0035
0036 ## Dumping conditions from the Offline (Conditions) DB
0037
0038 Another set of scripts allows you to print fields of the payloads in Cond DB (production and development), local
0039 sqlite file, or static configuration python in the release (if applies). Diffing the results is a key use case.
0040 These CMSSW scripts are:
0041 [viewMenu.py](https://github.com/kkotov/cmssw/blob/o2oUtilities92X/L1TriggerConfig/Utilities/test/viewMenu.py),
0042 [viewCaloParams.py](https://github.com/kkotov/cmssw/blob/o2oUtilities92X/L1TriggerConfig/Utilities/test/viewCaloParams.py),
0043 [viewOverPar.py](https://github.com/kkotov/cmssw/blob/o2oUtilities92X/L1TriggerConfig/Utilities/test/viewOverPar.py),
0044 [viewECpar.py](https://github.com/kkotov/cmssw/blob/o2oUtilities92X/L1TriggerConfig/Utilities/test/viewECpar.py),
0045 [viewL1TGlobalPrescalesVetos.py](https://github.com/kkotov/cmssw/blob/o2oUtilities92X/L1TriggerConfig/Utilities/test/viewL1TGlobalPrescalesVetos.py),
0046 [viewTKE.py](https://github.com/kkotov/cmssw/blob/o2oUtilities92X/L1TriggerConfig/Utilities/test/viewTKE.py),
0047 [viewTKLE.py](https://github.com/kkotov/cmssw/blob/o2oUtilities92X/L1TriggerConfig/Utilities/test/viewTKLE.py)
0048
0049 You can run them from lxplus (but not from .cms):
0050
0051 lxplus> cmsRun viewCaloParams.py db=prod run=1000000
0052
0053 ## For experts: uploading prototype payloads in Cond DB
0054
0055 The following set of script allows to update the prototype (starting point that L1T O2O take and updates with parameters
0056 extracted from the online XMLs):
0057 [uploadBmtfParams.py](https://github.com/kkotov/cmssw/blob/o2oUtilities92X/L1TriggerConfig/Utilities/test/uploadBmtfParams.py),
0058 [uploadEmtfParams.py](https://github.com/kkotov/cmssw/blob/o2oUtilities92X/L1TriggerConfig/Utilities/test/uploadEmtfParams.py),
0059 [uploadCaloParams.py](https://github.com/kkotov/cmssw/blob/o2oUtilities92X/L1TriggerConfig/Utilities/test/uploadCaloParams.py),
0060 [uploadGmtParams.py](https://github.com/kkotov/cmssw/blob/o2oUtilities92X/L1TriggerConfig/Utilities/test/uploadGmtParams.py)
0061
0062 ## For experts: standalone XML parsers
0063
0064 The read*.cc standalones (compilation instructions inside) are able to read the online xml config files. Although I do
0065 not commit to support them up to the date.
