Instrument (instrument)#

Introduction#

The instrument module contains classes and methods for describing the instrumental layout and configuration.

This module is under heavy restructuring and should not be considered ready for general use, except for the CameraGeometry object, which provides pixel positions, etc.

Hierarchy of InstrumentDescription Classes#

  • SubarrayDescription (describes full subarray)

    • TelescopeDescription (describes a single telescope)

      • OpticsDescription (describes the optical support structure and mirror)

      • CameraDescription (describes the camera)

        • CameraGeometry (describes the geometrical aspects of the camera, e.g. only that which is needed by reconstruction methods)

        • CameraReadout (describes the aspects related to the waveform readout e.g. sampling rate and reference pulse shape.geometrical aspects of the camera, e.g.

        • [to come: classes to hold more detailed hardware-level info about a camera]

Reference/API#

ctapipe.instrument Package#

Functions#

get_atmosphere_profile_functions([...])

guess_telescope(n_pixels, focal_length[, ...])

From n_pixels of the camera and the focal_length, guess which telescope we are dealing with.

Classes#

CameraDescription(name, geometry, readout)

Describes a Cherenkov camera and its associated CameraGeometry and CameraReadout

CameraGeometry(name, pix_id, pix_x, pix_y, ...)

CameraGeometry is a class that stores information about a Cherenkov Camera that is useful for imaging algorithms and displays.

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

Stores properties related to the readout of a Cherenkov Camera.

OpticsDescription(name, size_type, ...)

Describes the optics of a Cherenkov Telescope mirror

PixelShape(value)

Supported Pixel Shapes Enum

SubarrayDescription(name, tel_positions, ...)

Collects the TelescopeDescription of all telescopes along with their positions on the ground.

TelescopeDescription(name, optics, camera)

Describes a Cherenkov Telescope and its associated OpticsDescription and CameraDescription

UnknownTelescopeID

Raised when an unknown telescope id is encountered

FocalLengthKind(value)

Enumeration for the different kinds of focal lengths.

ReflectorShape(value)

Enumeration of the different reflector shapes

SizeType(value)

Enumeration of different telescope sizes (LST, MST, SST)

SoftwareTrigger(**kwargs)

A stereo trigger that can remove telescope events from subarray events.

FromNameWarning

Warning raised when using from_name

PSFModel(**kwargs)

Base component to describe image distortion due to the optics of the different cameras.

ComaPSFModel(**kwargs)

PSF model describing pure coma aberrations PSF effect.