Warning, /CondTools/SiStrip/README.md is written in an unsupported language. File is not indexed.
0001 ## CondTools/SiStrip
0002
0003 - _SiStripApvGainReader_: reads APV gains from input sqlite. Dumps TTree with following infos: detectorID, APV number, gain
0004 Infos are also dumped in txt file, in format : DetId APV1 APV2 APV3 APV4 (APV5) (APV6)
0005 - To run:
0006 - `cmsRun test/SiStripApvGainReader_cfg.py inputFiles=sqlite_input tag=my_tag runN=run_in_IOV`
0007 - `readSiStripApvGain.py inputFiles=sqlite_input tag=my_tag runN=run_in_IOV`
0008
0009 - _SiStripChannelGainFromDBMiscalibrator_: reads APV gains (either G1 or G2) from DB and applies hierarchically a scale factor and/or gaussian smearing for each APV gain, down to the individual layer or disk level
0010 - To run:
0011 - `cmsRun test/SiStripChannelGainFromDBMiscalibrator_cfg.py globalTag=<inputGT> runNumber=<inputIOV>`
0012
0013 - _SiStripNoisesFromDBMiscalibrator_: reads Noise from DB and applies hierarchically a scale factor and/or gaussian smearing for each APV gain, down to the individual layer or disk level
0014 - To run:
0015 - `cmsRun test/SiStripNoiseFromDBMiscalibrator_cfg.py globalTag=<inputGT> runNumber=<inputIOV>`
0016
0017 - _SiStripApvGainFromFileBuilder_:
0018 The SiStripApvGainFromFileBuilder class is an analyzer that reads an ASCII file
0019 containing the APV gain scan at tickmarks and creates the corresponding payload
0020 in the offline Database. For each APV the tickmark file is expected to have one
0021 line with the following data:
0022
0023 | offline detector id | online APV id | value of the gain scan |
0024 | ------------------- | ------------- | ---------------------- |
0025
0026 An example of tickmark file can be found in the data directory of this packages.
0027 The payload for the offline database requires to convert the online APV ids into
0028 the offline ones. For this conversion the detector cabling `SiStripDetCabling`
0029 and the reader of the ideal geometry `SiStripDetInfoFileReader` are used. The
0030 former provides the APV connectivity into the FEDs and into the detector modules;
0031 the latter lists the full set of detector modules even those not actually cabled
0032 in the detector. The code loops over all the possible detector modules, finds
0033 the connected ones and associates the gain scan to the corresponding APV in the
0034 module. The uncabled modules, the channels missing in the scan, the channels in
0035 the scan appearing as uncabled and the channels off (giving a zero tickmark gain)
0036 or bad (giving a negative tickmark gain) are treated in a special way. According
0037 on the job configuration either a dummy gain value or a zero gain value is put in
0038 the offline database for these channels. At the end of the job, it is possible to
0039 dump the summary of the database insertion into ASCII files for both the regular
0040 channels and the special channel. The code can also produces ASCII files with the
0041 gain scan for the APVs to be given in input to a the tracker map.
0042
0043 A special attention must be reserved to the online to offline conversion of the
0044 APV ids. The detector modules can have 3 APV pairs or 2 APV pair and the logic of
0045 the conversion is different according to the module type. The conversion logic is
0046 listed in the table below:
0047
0048 ##### Modules with 6 APVs
0049
0050 | online APV id | offline APV id |
0051 | -------------- | -------------- |
0052 | 0 | 0 |
0053 | 1 | 1 |
0054 | 2 | 2 |
0055 | 3 | 3 |
0056 | 4 | 4 |
0057 | 5 | 5 |
0058
0059 ##### Modules with 4 APVs
0060
0061 | online APV id | offline APV id |
0062 | ------------- | -------------- |
0063 | 0 | 0 |
0064 | 1 | 1 |
0065 | 4 | 2 |
0066 | 5 | 3 |
0067
0068 This logic has been implemented inside the SiStripApvGainFromFileBuilder class,
0069 it cannot be deducted from the SiStrip cabling description code.
0070
0071 ##### Job Configuration
0072 The job to read the ASCII tickmark file and deploy the payload into the offline
0073 database is configured with the `SiStripApvGainFromASCIIFile_cfg.py` fragment put
0074 in the test directory. The `SiStripGainApvFromFileBuilder` analyzer is configured
0075 with the following options:
0076
0077 | Options | Function | Default |
0078 | ------- | -------- | ------- |
0079 | `tickFile` | Path to the tickmark scan | `CondTools/SiStrip/data/tickheight.txt` |
0080 | `gainThreshold` | Lower limit for good scan value | 0. |
0081 | `dummyAPVGain` | Dummy value for the APV gain | 690./640. |
0082 | `putDummyIntoUncabled` | Switch to put dummy gain for uncabled channels | False |
0083 | `putDummyIntoUnscanned` | Switch to put dummy gain for unscanned channels | False |
0084 | `putDummyIntoOffChannels` | Switch to put dummy gain for OFF channels | False |
0085 | `putDummyIntoBadChannels` | Switch to put dummy gain for BAD channels | False |
0086 | `outputMaps` | Switch to output the ASCII text for the tracker map | False |
0087 | `outputSummary` | Switch to output the summary text file | False |
