Difference between revisions of "Calibrations"

From GlueXWiki
Jump to: navigation, search
 
(16 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This is just a start.
 
  
Detector calibrations are stored using the [[Calibration_Database]] aka CCDB.
+
'''Calibration database'''
  
Coordinated launches of the monitoring & calibration plugins are organized during and after each run period.   
+
Detector calibrations are stored using the [[Calibration Database]], CCDB.
New calibration values are calculated and added to the database and another set of jobs is launched.
+
It has a command line interface, a python API and a [https://halldweb.jlab.org/cgi-bin/ccdb/objects visual browser].
This process is repeated until the calibrations are satisfactory.
+
 
At that point the data are declared ready for REST production.  
+
The tables are described here: [[Calibration_Constants]] (from 2014 but it's a start)
 +
 
 +
 
 +
'''The calibration process'''
 +
 
 +
Coordinated launches of batch jobs running hd_root with the monitoring & calibration plugins are organized during and after each run period.
 +
 +
[https://halldweb.jlab.org/data_monitoring/Plot_Browser.html?RunPeriod=RunPeriod-2021-11&Version=mon_ver01&Plot=CDC_occupancy Plot Browser] is often used to examine the resulting histograms (the root files are on the cache disk directory for the run period).
 +
 
 +
The people responsible for each subdetector's calibrations calculate a new set of  
 +
calibration values and add them to the database.  
 +
This process is repeated until the calibrations are satisfactory and the data are declared ready for REST production.  
  
 
[https://halldweb.jlab.org/wiki/index.php/Calibration-Monitoring The original calibration & monitoring page]
 
[https://halldweb.jlab.org/wiki/index.php/Calibration-Monitoring The original calibration & monitoring page]
 +
[https://halldweb.jlab.org/wiki/index.php/Calibration_Dashboard Calibration dashboard for runs before fall 2018]
  
  
 +
'''Calibration software'''
  
 
Calibration software maintained by the detector groups can be found in [https://github.com/JeffersonLab/halld_recon halld_recon] with varying levels of documentation stored with the plugins.   
 
Calibration software maintained by the detector groups can be found in [https://github.com/JeffersonLab/halld_recon halld_recon] with varying levels of documentation stored with the plugins.   
 
   
 
   
* [https://halldweb.jlab.org/DocDB/0048/004800/004/CDC_calibrations.pdf CDC calibrations]
+
* BCAL calibrations
 +
* [https://halldweb.jlab.org/DocDB/0048/004800/004/CDC_calibrations.pdf CDC calibrations] - [https://github.com/JeffersonLab/halld_recon/tree/master/src/plugins/Calibration/CDC_amp CDC_amp], [https://github.com/JeffersonLab/halld_recon/tree/master/src/plugins/monitoring/CDC_dedx CDC_dedx], [https://github.com/JeffersonLab/halld_recon/tree/master/src/plugins/Calibration/CDC_TimeToDistance CDC_TimeToDistance], [https://github.com/JeffersonLab/hd_utilities/tree/master/CDC_scripts scripts]
 +
* FCAL calibrations
 +
* FDC calibrations - timing from alignment procedure (add plugin)
 +
* PS calibrations - [https://github.com/JeffersonLab/halld_recon/tree/master/src/plugins/Calibration/PSC_TW PSC_TW], [https://github.com/JeffersonLab/halld_recon/tree/master/src/plugins/Calibration/PS_timing PS_timing]
 +
* ST calibrations - [https://github.com/JeffersonLab/halld_recon/tree/master/src/plugins/Calibration/ST_Propagation_Time ST_Propagation_Time]
 +
* TAGH calibrations - [https://github.com/JeffersonLab/halld_recon/tree/master/src/plugins/Calibration/TAGH_timewalk TAGH_timewalk]
 +
* TAGM calibrations - [https://github.com/JeffersonLab/halld_recon/tree/master/src/plugins/Calibration/TAGM_TW TAGM_TW]
 +
* [[TOF Calibration]] - [https://github.com/JeffersonLab/halld_recon/tree/master/src/plugins/Calibration/TOF_calib TOF_calib], [https://github.com/JeffersonLab/hd_utilities/tree/master/TOF_calib scripts]
 +
* TPOL calibrations
 +
* Overall timing calibrations - [https://github.com/JeffersonLab/halld_recon/tree/master/src/plugins/Calibration/HLDetectorTiming HLDetectorTiming]
 +
 
 +
'''Existing wiki pages that could be updated or repurposed'''
 +
 
 +
*[[Calibration]] holds links to calibration instructions for BCAL and TOF. If I had thought of searching for calibration (singular) earlier, I would have repurposed that page instead of creating this one.
 +
*[[Calibration_Procedures]]
 +
*[[Calibration_Status]]
 +
*[[Calibration_Constants,_Tagged_Versions]]
 +
*[[Calibration_Challenge]] this has a nice list of which plugin is used for which ccdb table

Latest revision as of 16:10, 17 March 2022

Calibration database

Detector calibrations are stored using the Calibration Database, CCDB. It has a command line interface, a python API and a visual browser.

The tables are described here: Calibration_Constants (from 2014 but it's a start)


The calibration process

Coordinated launches of batch jobs running hd_root with the monitoring & calibration plugins are organized during and after each run period.

Plot Browser is often used to examine the resulting histograms (the root files are on the cache disk directory for the run period).

The people responsible for each subdetector's calibrations calculate a new set of calibration values and add them to the database. This process is repeated until the calibrations are satisfactory and the data are declared ready for REST production.

The original calibration & monitoring page Calibration dashboard for runs before fall 2018


Calibration software

Calibration software maintained by the detector groups can be found in halld_recon with varying levels of documentation stored with the plugins.

Existing wiki pages that could be updated or repurposed