SPD Calibration Algorithms

Standalone calibration

The standalone calibration is performed on each of the LDCs assigned to the SPD (presently there are 8 LDCs). The table below shows the directory and file structure - in black - where the DA is running for one of these LDCs. In violet are some DAQ database IDs, in green the FXS IDs, in blue the run types are given for those scans that may produce output files inside the directory, and with red text it is indicated if the files in a directory should be kept persistently over different scans. Below the tables some descriptions of the files are given.

 

./configFiles/standal_params.txt - spd_standal_params
./configFiles/perm_noisy.txt - spd_perm_noisy

./configFiles/IdsToFXS/FXSids_run_XXXX.txt - | DAQ_MIN_TH_SCAN DAQ_MEAN_TH_SCAN | DAQ_UNIFORMITY_SCAN | DAQ_NOISY_PIX_SCAN | DAQ_PIX_DELAY_SCAN | DAQ_FO_UNIF_SCAN
./configFiles/ScanDCSConfigToFXS/ - | DAQ_MIN_TH_SCAN DAQ_MEAN_TH_SCAN | DAQ_UNIFORMITY_SCAN | DAQ_NOISY_PIX_SCAN | DAQ_PIX_DELAY_SCAN | DAQ_FO_UNIF_SCAN
./configFiles/ScanNoisy/SPD_Noisy_X.root - | DAQ_NOISY_PIX_SCAN |
./configFiles/ScanNoisyToFXS/SPD_Noisy_X.root - | DAQ_NOISY_PIX_SCAN |

./configFiles/ScanReference/SPDcal_run_XXXX_eq_X.root - | DAQ_MIN_TH_SCAN | DAQ_MEAN_TH_SCAN | DAQ_UNIFORMITY_SCAN | DAQ_NOISY_PIX_SCAN | DAQ_PIX_DELAY_SCAN | DAQ_FO_UNIF_SCAN |

 

Physics run calibration

The physics run calibration is performed on one of the monitoring machines on the DAQ network. The table below shows the directory and file structure - in black - where the DA is running. In violet are some DAQ database IDs, in green the FXS IDs, in blue the run types are given for those scans that may produce output files inside the directory (in this case always PHYSICS of course), and with red text it is indicated if the files in a directory should be kept persistently over different runs. Below the tables some descriptions of the files are given.

./configFiles/    
  physics_params.txt spd_physics_params  
./calibResults/  
  IdsToFXS/ | PHYSICS |  
    FXSids_run_4192.txt SPD_id_list
  Dead/
| PHYSICS |
PERSISTENT DIR  
  SPD_Dead_0.root    
  SPD_Dead_1.root    
  SPD_Dead_2.root    
  SPD_Dead_3.root    
  SPD_Dead_4.root    
  . .    
  SPD_Dead_19.root    
  DeadToFXS/
| PHYSICS |
  dead_phys.tar SPD_phys_dead  
  SPD_Dead_0.root    
  SPD_Dead_1.root    
  SPD_Dead_2.root    
  SPD_Dead_3.root    
  SPD_Dead_4.root    
  . .    
  SPD_Dead_19.root    
  DeadReference/
| PHYSICS |
  ref_phys_dead.tar SPD_ref_phys_dead  
  SPDphys_dead_run_4100_4192_eq_0.root    
  SPDphys_dead_run_4100_4192_eq_1.root    
  SPDphys_dead_run_4100_4192_eq_2.root    
  SPDphys_dead_run_4100_4192_eq_3.root    
  SPDphys_dead_run_4100_4192_eq_4.root    
  . .    
  SPDphys_dead_run_4100_4192_eq_19.root    
  DeadReferenceTmp/
| PHYSICS |
PERSISTENT DIR  
  SPDphys_dead_run_0_0_eq_0.root    
  SPDphys_dead_run_0_0_eq_1.root    
  SPDphys_dead_run_0_0_eq_2.root    
  SPDphys_dead_run_0_0_eq_3.root    
  SPDphys_dead_run_0_0_eq_4.root    
  . .    
  SPDphys_dead_run_0_0_eq_19.root    
  NoisyToFXS/
| PHYSICS |
  noisy_phys.tar SPD_phys_noisy  
  SPD_Noisy_0.root    
  SPD_Noisy_1.root    
  SPD_Noisy_2.root    
  SPD_Noisy_3.root    
  SPD_Noisy_4.root    
  . .    
  SPD_Noisy_19.root    
  NoisyReference/
| PHYSICS |
  ref_phys.tar SPD_ref_phys  
  SPDphys_run_4192_eq_0.root    
  SPDphys_run_4192_eq_1.root    
  SPDphys_run_4192_eq_2.root    
  SPDphys_run_4192_eq_3.root    
  SPDphys_run_4192_eq_4.root    
  . .    
  SPDphys_run_4192_eq_19.root

 

File descriptions (alphabetically)

FILE NAME

DESCRIPTION

dcsConfig.tar This is a tar file that will be copied to FXS. It contains all the "dcsConfig_run_X_eq_X.txt" files inside the directory "./calibResults/ScanDCSConfigToFXS/". They carry settings for the DCS configuration database.
dead_phys.tar This is a tar file that will be copied to FXS. It contains all the "SPD_Dead_X.root" files inside the directory "./calibResults/DeadToFXS/". They carry the dead pixels for updating of the OCDB.
FXSids_runXXXX.txt This is an ascii file that will be copied to FXS. It contains all the ids of the files that are copied to the FXS (except its own and the id for files going to DCS). Its purpose is to spot errors during preprocessing.
noisy_phys.tar This is a tar file that will be copied to FXS. It contains all the "SPD_Noisy_X.root" files inside the directory "./calibResults/NoisyToFXS/". They carry the noisy pixels for updating of the OCDB.
noisy_scan.tar This is a tar file that will be copied to FXS. It contains all the "SPD_Noisy_X.root" files inside the directory "./calibResults/ScanNoisyToFXS/". They carry the noisy pixels for updating of the OCDB.
perm_noisy.txt When the DA is started (at the end of the calibration run), this configuration file is fetched from the DAQ database. It contains a list of noisy pixels, that you always want to put noisy, no matter what. This could for instance be useful whenever the noisy pixel scan for some reason cannot find a noisy pixel. The pixels are put in the text file with values of eq,hs,chip,col,row - separated by space or tab.
physics_params.txt When the DA is started, this configuration file is fetched from the DAQ database. It contains tuning parameters for the AliITSOnlineSPDphysAnalyzer class.
ref_phys.tar This is a tar file that will be copied to FXS. It contains all the "SPDphys_run_X_eq_X.root" files inside the directory "./calibResults/NoisyReference/".
ref_phys_dead.tar This is a tar file that will be copied to FXS. It contains all the "SPDphys_dead_run_X_X_eq_X.root" files inside the directory "./calibResults/DeadReference/".
SPD_Dead_X.root File that holds the list of dead pixels for equipment X. It is kept in a TObject derived class called AliITSOnlineCalibrationSPD. Reading/writing from/to this type of file is easiest done via the class AliITSOnlineCalibrationSPDhandler.
SPD_Noisy_X.root File that holds the list of noisy pixels for equipment X. It is kept in a TObject derived class called AliITSOnlineCalibrationSPD. Reading/writing from/to this type of file is easiest done via the class AliITSOnlineCalibrationSPDhandler.
SPDcal_run_XXXX_eq_Y.root This is a so-called reference data file for equipment Y. It will be copied offline without further processing. 
SPDphys_dead_run_0_0_eq_Y.root Temporary reference file for equipment Y. When one run does not give enough statistics for a complete dead search, this file must be kept over several runs.
SPDphys_dead_run_XXXX_ZZZZ_eq_Y.root This is a so-called reference data file for equipment Y. It is produced when the dead search has been completed, i.e. when enough statistics (runs) have been collected. The file is copied offline without further processing. 
SPDphys_run_XXXX_eq_Y.root This is a so-called reference data file for equipment Y. It is produced for every run. 
standal_params.txt When the DA is started (at the end of the calibration run), this configuration file is fetched from the DAQ database. It contains tuning parameters for the AliITSOnlineSPDscanAnalyzer class.