hit_analysis

All functions acting on the hits of one DUT are listed here

Methods

testbeam_analysis.hit_analysis.generate_pixel_mask(input_hits_file, n_pixel, pixel_mask_name='NoisyPixelMask', output_mask_file=None, pixel_size=None, threshold=10.0, filter_size=3, dut_name=None, plot=True, chunk_size=1000000)[source]

Generating pixel mask from the hit table.

Parameters:
  • input_hits_file (string) – File name of the hit table.
  • n_pixel (tuple) – Tuple of the total number of pixels (column/row).
  • pixel_mask_name (string) – Name of the node containing the mask inside the output file.
  • output_mask_file (string) – File name of the output mask file.
  • pixel_size (tuple) – Tuple of the pixel size (column/row). If None, assuming square pixels.
  • threshold (float) – The threshold for pixel masking. The threshold is given in units of sigma of the pixel noise (background subtracted). The lower the value the more pixels are masked.
  • filter_size (scalar or tuple) – Adjust the median filter size by giving the number of columns and rows. The higher the value the more the background is smoothed and more pixels are masked.
  • dut_name (string) – Name of the DUT. If None, file name of the hit table will be printed.
  • plot (bool) – If True, create additional output plots.
  • chunk_size (int) – Chunk size of the data when reading from file.
testbeam_analysis.hit_analysis.cluster_hits(input_hits_file, output_cluster_file=None, input_disabled_pixel_mask_file=None, input_noisy_pixel_mask_file=None, min_hit_charge=0, max_hit_charge=None, column_cluster_distance=1, row_cluster_distance=1, frame_cluster_distance=1, dut_name=None, plot=True, chunk_size=1000000)[source]

Clusters the hits in the data file containing the hit table.

Parameters:
  • input_hits_file (string) – Filename of the input hits file.
  • output_cluster_file (string) – Filename of the output cluster file. If None, the filename will be derived from the input hits file.
  • input_disabled_pixel_mask_file (string) – Filename of the input disabled mask file.
  • input_noisy_pixel_mask_file (string) – Filename of the input disabled mask file.
  • min_hit_charge (uint) – Minimum hit charge. Minimum possible hit charge must be given in order to correcly calculate the cluster coordinates.
  • max_hit_charge (uint) – Maximum hit charge. Hits wit charge above the limit will be ignored.
  • column_cluster_distance (uint) – Maximum column distance between hist so that they are assigned to the same cluster. Value of 0 effectively disables the clusterizer in column direction.
  • row_cluster_distance (uint) – Maximum row distance between hist so that they are assigned to the same cluster. Value of 0 effectively disables the clusterizer in row direction.
  • frame_cluster_distance (uint) – Sometimes an event has additional timing information (e.g. bunch crossing ID, frame ID). Value of 0 effectively disables the clusterization in time.
  • dut_name (string) – Name of the DUT. If None, filename of the output cluster file will be used.
  • plot (bool) – If True, create additional output plots.
  • chunk_size (int) – Chunk size of the data when reading from file.