Camera Readout

The CameraReadout stores information regarding the waveform readout from the Cherenkov camera, such as sampling rate and information on the reference pulse shape.

There are several ways to obtain a CameraReadout:

• Through the SubarrayDescription of an EventSource or TableLoader

• Through reading a SubarrayDescription from an input file using SubarrayDescription.from_hdf or SubarrayDescription.read

• use the CameraReadout constructor, where one has to specify all necessary information

• load it from a pre-written file, which can be in any format supported by astropy.table.Table, as long as that format allows for header-keywords as well as table entries.

CameraReadout is used by the ImageExtractor in the ctapipe.image module to ensure the images are scaled to the correct units.

Input/Output

You can write out a CameraReadout by using the CameraReadout.to_table() method to turn it into a Table, and then call its write() function. Reading it back in can be done with CameraReadout.from_table().

readout = CameraReadout(...)  # constructed elsewhere

readout.to_table().write('mycam.fits.gz') # FITS output
readout.to_table().write('mycam.h5', path='/cameras/mycam') # hdf5 output
readout.to_table().write('mycam.ecsv', format='ascii.ecsv') # text table

# later read back in:

readout = CameraReadout.from_table('mycam.ecsv', format='ascii.ecsv')
readout = CameraReadout.from_table('mycam.fits.gz')
readout = CameraReadout.from_table('mycam.h5', path='/cameras/mycam')

Reference/API

ctapipe.instrument.camera.readout Module

Utilities for reading or working with Camera geometry files

Classes

CameraReadout(name, sampling_rate, ...[, ...])

Stores properties related to the readout of a Cherenkov Camera.