CalibrationHDF5Writer

class lstchain.tools.lstchain_create_calibration_file.CalibrationHDF5Writer(**kwargs: Any)

Bases: Tool

Tool that generates a HDF5 file with camera calibration coefficients. This is just an example on how the monitoring containers can be filled using the calibration Components in calib/camera. This example is based on an input file with pedestal and flat-field events

For getting help run: python calc_camera_calibration.py –help

Attributes Summary

aliases
calibration_product	CalibrationCalculator to use.
classes
description
events_to_skip	Number of first events to skip due to bad DRS4 pedestal correction
flags
mc_max_pedestal_adc	Maximum high-gain camera median charge per pixel (ADC) for pedestal MC events
mc_min_flatfield_adc	Minimum high-gain camera median charge per pixel (ADC) for flatfield MC events
name
one_event	Stop after first calibration event
output_file	Name of the output file

Methods Summary

finish()	Finish up.
setup()	Set up the tool.
start()	Calibration coefficient calculator

Attributes Documentation

aliases: StrDict = {'events_to_skip': 'CalibrationHDF5Writer.events_to_skip', ('i', 'input_file'): 'EventSource.input_url', ('m', 'max_events'): 'EventSource.max_events', ('o', 'output_file'): 'CalibrationHDF5Writer.output_file', ('p', 'pedestal_file'): 'LSTEventSource.LSTR0Corrections.drs4_pedestal_path', ('r', 'run_summary_file'): 'LSTEventSource.EventTimeCalculator.run_summary_path', ('s', 'systematics_file'): 'LSTCalibrationCalculator.systematic_correction_path', ('t', 'time_calibration_file'): 'LSTEventSource.LSTR0Corrections.drs4_time_calibration_path'}

calibration_product

CalibrationCalculator to use.

classes: ClassesType = [<class 'ctapipe.io.eventsource.EventSource'>, <class 'lstchain.calib.camera.calibration_calculator.CalibrationCalculator'>, <class 'lstchain.calib.camera.calibration_calculator.CalibrationCalculator'>, <class 'ctapipe.calib.camera.flatfield.FlatFieldCalculator'>, <class 'ctapipe.calib.camera.flatfield.FlasherFlatFieldCalculator'>, <class 'lstchain.calib.camera.flatfield.FlasherFlatFieldCalculator'>, <class 'ctapipe.calib.camera.pedestals.PedestalCalculator'>, <class 'ctapipe.calib.camera.pedestals.PedestalIntegrator'>, <class 'lstchain.calib.camera.pedestals.PedestalIntegrator'>, <class 'ctapipe.calib.camera.flatfield.FlatFieldCalculator'>, <class 'ctapipe.calib.camera.flatfield.FlasherFlatFieldCalculator'>, <class 'lstchain.calib.camera.flatfield.FlasherFlatFieldCalculator'>, <class 'ctapipe.calib.camera.flatfield.FlasherFlatFieldCalculator'>, <class 'lstchain.calib.camera.flatfield.FlasherFlatFieldCalculator'>, <class 'ctapipe.calib.camera.pedestals.PedestalCalculator'>, <class 'ctapipe.calib.camera.pedestals.PedestalIntegrator'>, <class 'lstchain.calib.camera.pedestals.PedestalIntegrator'>, <class 'ctapipe.calib.camera.pedestals.PedestalIntegrator'>, <class 'lstchain.calib.camera.pedestals.PedestalIntegrator'>, <class 'lstchain.calib.camera.calibration_calculator.LSTCalibrationCalculator'>, <class 'ctapipe.calib.camera.flatfield.FlatFieldCalculator'>, <class 'ctapipe.calib.camera.flatfield.FlasherFlatFieldCalculator'>, <class 'lstchain.calib.camera.flatfield.FlasherFlatFieldCalculator'>, <class 'ctapipe.calib.camera.pedestals.PedestalCalculator'>, <class 'ctapipe.calib.camera.pedestals.PedestalIntegrator'>, <class 'lstchain.calib.camera.pedestals.PedestalIntegrator'>, <class 'ctapipe.calib.camera.flatfield.FlatFieldCalculator'>, <class 'ctapipe.calib.camera.flatfield.FlasherFlatFieldCalculator'>, <class 'lstchain.calib.camera.flatfield.FlasherFlatFieldCalculator'>, <class 'ctapipe.calib.camera.flatfield.FlasherFlatFieldCalculator'>, <class 'lstchain.calib.camera.flatfield.FlasherFlatFieldCalculator'>, <class 'ctapipe.calib.camera.pedestals.PedestalCalculator'>, <class 'ctapipe.calib.camera.pedestals.PedestalIntegrator'>, <class 'lstchain.calib.camera.pedestals.PedestalIntegrator'>, <class 'ctapipe.calib.camera.pedestals.PedestalIntegrator'>, <class 'lstchain.calib.camera.pedestals.PedestalIntegrator'>, <class 'ctapipe.io.eventsource.EventSource'>, <class 'ctapipe.io.hdf5eventsource.HDF5EventSource'>, <class 'ctapipe.io.simteleventsource.SimTelEventSource'>, <class 'ctapipe_io_lst.LSTEventSource'>, <class 'ctapipe_io_lst.pointing.PointingSource'>, <class 'ctapipe_io_lst.event_time.EventTimeCalculator'>, <class 'ctapipe_io_lst.calibration.LSTR0Corrections'>]

description: str | Unicode[str, str | bytes] = 'Generate a HDF5 file with camera calibration coefficients'

events_to_skip

Number of first events to skip due to bad DRS4 pedestal correction

flags: StrDict = {'flatfield-heuristic': ({'LSTEventSource': {'use_flatfield_heuristic': True}}, 'Use flatfield heuristic'), 'no-flatfield-heuristic': ({'LSTEventSource': {'use_flatfield_heuristic': False}}, 'Do not use flatfield heuristic')}

mc_max_pedestal_adc

Maximum high-gain camera median charge per pixel (ADC) for pedestal MC events

mc_min_flatfield_adc

Minimum high-gain camera median charge per pixel (ADC) for flatfield MC events

name: str | Unicode[str, str | bytes] = 'CalibrationHDF5Writer'

one_event

Stop after first calibration event

output_file

Name of the output file

Methods Documentation

finish()

Finish up.

This is called automatically after Tool.start when Tool.run is called.

setup()

Set up the tool.

This method runs after the configuration and command line options have been parsed.

Here the tool should construct all Components, open files, etc.

start()

Calibration coefficient calculator