Card cages

Module for analyzing card-cage information. The information is currently split between CardCageControl and CardCageInfo because of the two types of packets. This awkward implementation is likely to change in the future.

class gripspy.housekeeping.cc.CardCageControl(telemetry_file=None, save_file=None)[source]

Class for analyzing card-cage information from the housekeeping packet

Parameters:
  • telemetry_file (str (or list)) – The name of the telemetry file to analyze. If None is specified, a save file must be specified.
  • save_file (str) – The name of a save file from a telemetry file that was previously parsed.

Notes

This implementation extracts only a subset of the information, and the API is subject to change.

append(other)[source]

Append the information in another CardCageControl instance

attributes_all = ['systime', 'count_watchpup_reset', 'daq_running', 'last_cmdtype', 'mode_abort_ramp', 'mode_coincidence', 'mode_sample_last_edge', 'mode_veto_guard_ring_hv_hard', 'mode_veto_guard_ring_lv_hard', 'mode_veto_mult_trig_hard', 'mode_veto_shield_hard', 'mult_trig_threshold', 'window_coincidence', 'window_full_ramp', 'window_mult_trig_collect', 'window_mult_trig_veto', 'window_reset_adc', 'window_sample_hv', 'window_sample_lv', 'window_start_adc', 'window_trigger_wait', 'period_counters', 'period_housekeeping', 'time_since_last_reset']
attributes_convert = ['period_counters', 'period_housekeeping', 'time_since_last_reset']
attributes_simple = ['systime', 'count_watchpup_reset', 'daq_running', 'last_cmdtype', 'mode_abort_ramp', 'mode_coincidence', 'mode_sample_last_edge', 'mode_veto_guard_ring_hv_hard', 'mode_veto_guard_ring_lv_hard', 'mode_veto_mult_trig_hard', 'mode_veto_shield_hard', 'mult_trig_threshold', 'window_coincidence', 'window_full_ramp', 'window_mult_trig_collect', 'window_mult_trig_veto', 'window_reset_adc', 'window_sample_hv', 'window_sample_lv', 'window_start_adc', 'window_trigger_wait']
save(save_file=None, use_current_directory=False)[source]

Save the parsed data for future reloading. The data is stored in gzip-compressed binary pickle format.

Parameters:
  • save_file (str) – The name of the save file to create. If none is provided, the default is the name of the telemetry file with the extension ”.cccontrol.pgz” appended if a single telemetry file is the source.
  • use_current_directory (bool) – If True, remove any directory specification from save_file

Notes

Save files may not be compatible between Python 2 and 3

class gripspy.housekeeping.cc.CardCageInfo(telemetry_file=None, save_file=None)[source]

Class for analyzing card-cage information from the counters packet

Parameters:
  • telemetry_file (str (or list)) – The name of the telemetry file to analyze. If None is specified, a save file must be specified.
  • save_file (str) – The name of a save file from a telemetry file that was previously parsed.

Notes

This implementation extracts all of the information, but the API is subject to change.

append(other)[source]

Append the information in another CardCageInfo instance

attributes_all = ['systime', 'elapsed_time', 'busy_time', 'busy_count', 'veto_mult_trig_hard', 'veto_mult_trig_soft', 'busy_time_interface', 'busy_count_interface', 'busy_time_system', 'busy_count_system', 'guard_ring_lv_time', 'guard_ring_lv_count', 'guard_ring_hv_time', 'guard_ring_hv_count', 'shield_time', 'shield_count', 'reboot_count', 'event_count', 'veto_shield_soft', 'veto_guard_ring_lv_soft', 'veto_guard_ring_hv_soft', 'veto_shield_hard', 'veto_guard_ring_lv_hard', 'veto_guard_ring_hv_hard', 'dropped_event_count', 'busy_fraction']
attributes_simple = ['systime', 'elapsed_time', 'busy_time', 'busy_count', 'veto_mult_trig_hard', 'veto_mult_trig_soft', 'busy_time_interface', 'busy_count_interface', 'busy_time_system', 'busy_count_system', 'guard_ring_lv_time', 'guard_ring_lv_count', 'guard_ring_hv_time', 'guard_ring_hv_count', 'shield_time', 'shield_count', 'reboot_count', 'event_count', 'veto_shield_soft', 'veto_guard_ring_lv_soft', 'veto_guard_ring_hv_soft', 'veto_shield_hard', 'veto_guard_ring_lv_hard', 'veto_guard_ring_hv_hard', 'dropped_event_count']
save(save_file=None, use_current_directory=False)[source]

Save the parsed data for future reloading. The data is stored in gzip-compressed binary pickle format.

Parameters:
  • save_file (str) – The name of the save file to create. If none is provided, the default is the name of the telemetry file with the extension ”.ccinfo.pgz” appended if a single telemetry file is the source.
  • use_current_directory (bool) – If True, remove any directory specification from save_file

Notes

Save files may not be compatible between Python 2 and 3