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

3-dimensional functions

• meanSC: mean space-charge density (fC / cm^3)
• flucSC: space-charge density fluctuations = mean - random (fC / cm^3)

1-dimensional functions

• z: z, r: r, phi: phi positions (cm)
• derRefMeanSC: numerical derivative of space-charge density (fC / cm^3)
• mean1DIDC: mean 1D integrated digital currents (IDCs), 1 value per ms of the ion drift time; currently assumed the time of 200 ms --> 200 1D IDC values
• fluc1DIDC: 1D IDCs fluctuations = mean - random
• 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)
• meanCorr{Z,R,RPhi}: mean distortion correction in z / r / rphi direction (cm)
• flucCorr{Z,R,RPhi}: fluctuations of distortion correction in z / r / rphi direction (cm)
• derRefMeanCorr{Z,R,RPhi}: numerical derivative of distortion corrections

Scalars

• deltaSC: relative space-charge density fluctuations = sum(fluctuation) / sum(mean)
• delta1DIDC: relative 1D IDCs fluctuations = sum(fluctuation) / sum(mean)
• mean0DIDC: mean 0D integrated digital currents (IDCs), 1 value per TPC side
• fluc0DIDC: 0D IDCs fluctuations = mean - random

Predicted quantities

• flucDist{Z,R,RPhi}Pred: predicted 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

3-dimensional functions

• meanSC: mean space-charge density (fC / cm^3)
• flucSC: space-charge density fluctuations = mean - random (fC / cm^3)

1-dimensional functions

• 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)

Scalars

• deltaSC: relative space-charge density fluctuations = sum(fluctuation) / sum(mean)

Predicted quantities

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