Calibration tags » History » Version 32

« Previous - Version 32/49 (diff) - Next » - Current version
Matthew Tamsett, 04/14/2016 10:12 AM
Add stub v9 section

Calibration tags

Official location of backup calibration CSV files in the case of database failures


Self-explanatory directory structure.

Details on how to create a calibration UPS product are given in this wiki page: calibration-tagging. Input files for calibration can be monitored here for artdaq files and here for pc-list files.

Latest versions

FarDet NearDet NDOS
Data v9 v9 Legacy
MC v9 v9 Legacy

(Setting a newer tag falls back to an older version where necessary)

The results of latest attenuation fits are displayed for each channel on this webpage

Legacy (pre Validity Database)

  • Attenuation constants for NDOS data and MC, ND and FD MC
  • Absolute calibration hardcoded into Calibrator
  • MC calibrations are for untuned MC
  • No corrections for threshold effects applied
  • Exact datasets used lost in the mists of time


  • Attenuation and absolute calibration constants for FD data and MC
  • No drift constants
  • MC calibrations are for untuned MC
  • Data calibration are for diblocks 1 and 2, from runs 11496-11555 (cold, high gain), using Kanika's good runs list
  • Threshold effect corrections included, but taken from untuned MC
  • Confusion around updated PE/ADC conversions leads to 20% shift in absolute scale



  • MC constants unchanged from v2
  • New attenuation and absolute calibration constants for FD data
  • Attenuation using corrections determined from v2 tuned MC
  • Constants for the first 4 diblocks based on data from run 13153 (Feb 15 2014) - 14029 (March 18 2014)


Same as v3, but with "averaged" data attenuation constants included, for use in diblocks that are not yet calibrated.


FD data

Data from runs 14592 (start of 10Hz triggering) to 15585 (last run before P1 has diblocks missing from the middle)

The processed attenprof files: S14-06-09_FD_data_attenprofs_for_v4

Absolute calibration and averaged constants carried over from previous versions


Absolute energy scale determined "by hand" using reco/true of simulated cosmic ray hits because the production group are in a hurry.


ND data

Data from runs 10408 (full cooled detector) to 10493 (most recent processed at time of calibration)

The processed attenprof files: S14-10-15_ND_data_attenprofs_for_v5


The processed attenprof files: S14-09-29_ND_mc_attenprofs_for_v5


Same as v5 except that ND data absolute constants are set to be those for (v5) ND MC. This should resolve the 9% shift between data and MC that's observed in the Near Detector. The underlying problem is the selection of a lot of showering events in the ND data (docdb 12435). This is only a temporary patch until that is fixed.


ND data

Update to attenuation calibration only to fit cell-by-cell in the main body of the detector and to keep averages only for the muon catcher.

Data from runs 10408 (full cooled detector) to 10602 (most recent processed at time of calibration)


New cosmic muon selection for pchit files to improve the selection of cosmic muons dramatically.
New attenuation formula representing a small correction of the original.
New fit strategy for the muon catcher where fits are forced to converge using lowess.
FD MEU values found using Gaussian method before and mean now.

ND data

ND mc

FD data

FD mc


Identical to v7 except the ND data absolute energy scale has been adjusted. Data hits will now be 3.7% higher in energy.

See docdb 13355 for the source of this number (+3.7%=1/0.964). Other calibration cross-checks show values scattered around a similar shift (docdb 13373 for an overview).

This is the calibration version used for the First Analysis.


These are the calibrations produced prior to the second analysis or prod2. These calibrations are the first since a major re-tune of the simulated light levels in the detector. As a result the final calibrated energy for a given ADC signal has gone up by around 40%. Details can be found in docdb-14727 and references therein.

For the first time this calibration includes validity periods. That is to say two FD calibrations are provided, one for low gain (100) data/MC and a second for high gain (150) data/MC. As a result new naming conventions were brought in to differentiate between periods, as was new calibrator logic. This logic is explained on this page: calibration-tagging. The CSV files that match these calibrations are in the UPS product v08.02 (note this is not the same thing as a calibration tag - although the two are often tightly coupled). In the process of creating this product two earlier versions were made:

  • v08.00 - has the wrong FD data calibrations in and should not be used. * v08.01 - has a bug in the whitespace for the absolute calibration and should not be used.

When the dust has settled and we have a validated product these bad products will be removed.

This is the calibration used for the reco-preview files for prod 2.


These are the second analysis calibration files. They have all of the major changes included in v8. The difference with respect to v8 is that a simulation bug related to split tracks has been fixed. A comprehensive reference for this calibration will be provided in the forthcoming calibration tech note.

Mini production datasets used are as following

ND data


FD data (low gain)

FD data (high gain)

FD MC (low gain)

FD MC (high gain)