Skip to content

Analysis scripts

Blaise edited this page Jun 4, 2026 · 8 revisions

Pflib has a wide variety of data analysis and plotting Python scripts, located in the ana/ directory. These scripts serve to interpret the data gathered via pftool DAQ functions. This page contains the documentation for some of them.

Glossary

  • RMSD - root-mean-square deviation, equivalent to standard deviation. In the scripts often referred to as RMS;

Mean pedestal evaluation

The pedestal/averagesplot.py script allows the user to determine the mean pedestal values across link 0 (channels 0-35) and link 1 (channels 36-71). The code also calculates the RMSD across samples of each channel and across each link. For example, if the pedestals were taken with a 100 samples per channel, the channel-wise RMSD would be the stddev of the 100 samples. The link-wise RMSD would be the stddev of the mean pedestal values of each link.

Both the mean pedestal values and the channel-wise RMSD can be plotted for each link, as seen in examples below:

pedestal1 pedestal2

To engage with the different functions of the script, the user needs to provide an initial run setting. These can be found by running python3 averagesplot.py -h. The current settings are:

  • -pd - Path to directory for saved figures;
  • -lc - Mark the first pedestal file as pre-lowering and second as post-lowering;
  • -rms - Calculate and save the RMS of the mean pedestals for each link - provide a file path.

An example that engages all the settings would be: python3 averagesplot.py [pedestals.csv] [pedestals_lowered.csv] -pd [/plot_directory/] -lc -rms [link-wise-RMSD-results.csv].

Mean peak-ADC evaluation

Outlier identification algorithm

Clone this wiki locally