Validation data format

General notes

Validation data is saved as flat arrays ("columns") in a ROOT tree. This section describes the content of each column.

Scalars are saved as vectors of repeated values.

Predicted quantities are produced only if the validate_model option is set to True in config_model_parameters.yml.
They depend on what z-side and which output dimensions from z, r, rphi were set by the user for predictions in the YAML configuration file.

New data format (IDC)

Indices

meanId: mean event index in a pair
randomId: random events index in a pair
eventId: global event number = random id + 1000 * mean id

Input quantities

Quantities specified per each voxel (point in 3D map)

z: z, r: r, phi: phi positions (cm)
meanSC: mean space-charge density (C / cm^3 / epsilon0)
flucSC: space-charge density fluctuations = mean - random (C / cm^3 / epsilon0)
derRefMeanSC: numerical derivative of space-charge density (C / cm^3 / epsilon0)
meanCorr{Z,R,RPhi}: mean distortion corrections in z / r / rphi direction (cm)
flucCorr{Z,R,RPhi}: corrections for distortion fluctuations in z / r / rphi direction (cm)
derRefMeanCorr{Z,R,RPhi}: numerical derivative of mean distortion corrections w.r.t space-charge density

Scalars

deltaSC: relative space-charge density fluctuations = sum(fluctuation) / sum(mean)
mean0DIDC: mean 0D integrated digital currents (IDCs), 1 value per TPC side
fluc0DIDC: 0D IDCs fluctuations = random - mean
ck_real, ck_imag: Real and imaginary Fourier coefficients of 1D IDC fluctuations Fourier transform for frequency k

Predicted quantities

flucCorr{Z,R,RPhi}Pred: predicted corrections for space-charge distortion fluctuations in z / r / rphi direction (cm)

Not added yet

3D IDC variables, as they are not present in the input data

Old data format (pre-IDC, input data before February 2021)

Indices

meanId: mean event index in a pair
randomId: random events index in a pair
eventId: global event number = random id + 1000 * mean id

Input quantities

Quantities specified per each voxel (point in 3D map)

meanSC: mean space-charge density (fC / cm^3)
flucSC: space-charge density fluctuations = mean - random (fC / cm^3)
z: z, r: r, phi: phi positions (cm)
derRefMeanSC: numerical derivative of space-charge density (fC / cm^3)
meanDist{Z,R,RPhi}: mean space-charge density z / r / rphi distribution (fC / cm^3)
flucDist{Z,R,RPhi}: space-charge density fluctuations in z / r / rphi direction = mean - random (fC / cm^3)