DL1DataCheckContainer

class lstchain.datachecks.containers.DL1DataCheckContainer(prefix=None, **fields)

Bases: Container

Container to store the subrun-wise outcome of the DL1 data check

Attributes:
subrun_indexField(default=-1)

Subrun index

elapsed_timeField(default=-1.0 s, unit=s)

Subrun time duration (from Dragon)

num_eventsField(default=-1)

Total number of events

num_cleaned_eventsField(default=-1)

Number of events surviving cleaning

trigger_typeField(default=-1)

Number of events per trigger type

ucts_trigger_typeField(default=-1)

Number of events per ucts trigger type

num_ucts_jumpsField(default=-1)

Number of observed (and corrected) UCTS jumps

mean_alt_telField(default=nan rad, unit=rad)

Mean telescope altitude

mean_az_telField(default=nan rad, unit=rad)

Mean telescope azimuth

tel_raField(default=nan deg, unit=deg)

Telescope pointing RA

tel_decField(default=nan deg, unit=deg)

Telescope pointing declination

sampled_event_idsField(default=None)

sampled event ids

ucts_timeField(default=None, unit=s)

ucts time

tib_timeField(default=None, unit=s)

tib_time

dragon_timeField(default=None, unit=s)

dragon_time

hist_delta_tField(default=None)

Histogram of time difference between consecutive events

hist_npixelsField(default=None)

Histogram of number of pixels in image

hist_nislandsField(default=None)

Histogram of number of islands in image

hist_intensityField(default=None)

Histogram of image intensity

hist_dist0Field(default=None)

Histogram of cog-camera center distance

hist_dist0_intensity_gt_200Field(default=None)

Histogram of cog-camera center distance

hist_widthField(default=None)

Histogram image width vs. intensity

hist_lengthField(default=None)

Histogram image length vs. intensity

hist_skewnessField(default=None)

Histogram of image skewness

hist_pixelchargespectrumField(default=None)

Histogram of pixel charges

hist_psiField(default=None)

Histogram of image axis orientation

hist_interceptField(default=None)

Histogram of fitted pulse time for charge c.o.g.

hist_tgrad_vs_lengthField(default=None)

Histogram of time gradient vs. length

hist_tgrad_vs_length_intensity_gt_200Field(default=None)

Histogram of time gradient vs. length, intensity>200pe

cog_within_pixelField(default=None)

Number of image cogs within pixel

cog_within_pixel_intensity_gt_200Field(default=None)

Number of image within pixel, intensity>200pe

num_nearby_starsField(default=-1)

Number of nearby bright stars

charge_meanField(default=-1)

Mean of pixel charge

charge_stddevField(default=-1)

Standard deviation of pixel charge

time_meanField(default=-1)

Mean of pulse time

time_stddevField(default=-1)

Standard deviaton of pulse time

time_mean_above_030_peField(default=-1)

Mean of pulse time, >30 p.e. pulses

time_stddev_above_030_peField(default=-1)

Standard deviaton of pulse time, >30 p.e. pulses

relative_time_meanField(default=-1)

Mean of pulse time relative to average of rest of pixels

relative_time_stddevField(default=-1)

Standard deviaton of pulse time relative to average of rest of pixels

num_pulses_above_0010_peField(default=None)

Number of >10 p.e. pulses

num_pulses_above_0030_peField(default=None)

Number of >30 p.e. pulses

num_pulses_above_0100_peField(default=None)

Number of >100 p.e. pulses

num_pulses_above_0300_peField(default=None)

Number of >300 p.e. pulses

num_pulses_above_1000_peField(default=None)

Number of >1000 p.e. pulses

metadict

dict of attached metadata

prefixstr

Prefix attached to column names when saved to a table or file

Attributes Summary

charge_mean

charge_stddev

cog_within_pixel

cog_within_pixel_intensity_gt_200

default_prefix

dragon_time

elapsed_time

fields

hist_delta_t

hist_dist0

hist_dist0_intensity_gt_200

hist_intensity

hist_intercept

hist_length

hist_nislands

hist_npixels

hist_pixelchargespectrum

hist_psi

hist_skewness

hist_tgrad_vs_length

hist_tgrad_vs_length_intensity_gt_200

hist_width

mean_alt_tel

mean_az_tel

meta

num_cleaned_events

num_events

num_nearby_stars

num_pulses_above_0010_pe

num_pulses_above_0030_pe

num_pulses_above_0100_pe

num_pulses_above_0300_pe

num_pulses_above_1000_pe

num_ucts_jumps

prefix

relative_time_mean

relative_time_stddev

sampled_event_ids

subrun_index

tel_dec

tel_ra

tib_time

time_mean

time_mean_above_030_pe

time_stddev

time_stddev_above_030_pe

trigger_type

ucts_time

ucts_trigger_type

Methods Summary

fill_event_wise_info(subrun_index, table, ...)

Fills the container fields that depend on event-wise DL1 info

fill_pixel_wise_info(table, mask, ...[, ...])

Fills the quantities that are calculated pixel-wise

Attributes Documentation

charge_mean
charge_stddev
cog_within_pixel
cog_within_pixel_intensity_gt_200
default_prefix = 'dl1datacheck'
dragon_time
elapsed_time
fields = {'charge_mean': Field(default=-1), 'charge_stddev': Field(default=-1), 'cog_within_pixel': Field(default=None), 'cog_within_pixel_intensity_gt_200': Field(default=None), 'dragon_time': Field(default=None, unit=s), 'elapsed_time': Field(default=-1.0 s, unit=s), 'hist_delta_t': Field(default=None), 'hist_dist0': Field(default=None), 'hist_dist0_intensity_gt_200': Field(default=None), 'hist_intensity': Field(default=None), 'hist_intercept': Field(default=None), 'hist_length': Field(default=None), 'hist_nislands': Field(default=None), 'hist_npixels': Field(default=None), 'hist_pixelchargespectrum': Field(default=None), 'hist_psi': Field(default=None), 'hist_skewness': Field(default=None), 'hist_tgrad_vs_length': Field(default=None), 'hist_tgrad_vs_length_intensity_gt_200': Field(default=None), 'hist_width': Field(default=None), 'mean_alt_tel': Field(default=nan rad, unit=rad), 'mean_az_tel': Field(default=nan rad, unit=rad), 'num_cleaned_events': Field(default=-1), 'num_events': Field(default=-1), 'num_nearby_stars': Field(default=-1), 'num_pulses_above_0010_pe': Field(default=None), 'num_pulses_above_0030_pe': Field(default=None), 'num_pulses_above_0100_pe': Field(default=None), 'num_pulses_above_0300_pe': Field(default=None), 'num_pulses_above_1000_pe': Field(default=None), 'num_ucts_jumps': Field(default=-1), 'relative_time_mean': Field(default=-1), 'relative_time_stddev': Field(default=-1), 'sampled_event_ids': Field(default=None), 'subrun_index': Field(default=-1), 'tel_dec': Field(default=nan deg, unit=deg), 'tel_ra': Field(default=nan deg, unit=deg), 'tib_time': Field(default=None, unit=s), 'time_mean': Field(default=-1), 'time_mean_above_030_pe': Field(default=-1), 'time_stddev': Field(default=-1), 'time_stddev_above_030_pe': Field(default=-1), 'trigger_type': Field(default=-1), 'ucts_time': Field(default=None, unit=s), 'ucts_trigger_type': Field(default=-1)}
hist_delta_t
hist_dist0
hist_dist0_intensity_gt_200
hist_intensity
hist_intercept
hist_length
hist_nislands
hist_npixels
hist_pixelchargespectrum
hist_psi
hist_skewness
hist_tgrad_vs_length
hist_tgrad_vs_length_intensity_gt_200
hist_width
mean_alt_tel
mean_az_tel
meta
num_cleaned_events
num_events
num_nearby_stars
num_pulses_above_0010_pe
num_pulses_above_0030_pe
num_pulses_above_0100_pe
num_pulses_above_0300_pe
num_pulses_above_1000_pe
num_ucts_jumps
prefix
relative_time_mean
relative_time_stddev
sampled_event_ids
subrun_index
tel_dec
tel_ra
tib_time
time_mean
time_mean_above_030_pe
time_stddev
time_stddev_above_030_pe
trigger_type
ucts_time
ucts_trigger_type

Methods Documentation

fill_event_wise_info(subrun_index, table, mask, geom, histogram_binnings)

Fills the container fields that depend on event-wise DL1 info

Parameters:
subrun_index
table: DL1 parameters, event-wise astropy table, “parameters” from
DL1 files
mask: defines which events in table should be considered
geom: camera geometry (in standard frame, *not* engineering one)
histogram_binnings: container of type DL1DataCheckHinstogramBins which
defines the binning of the various histograms
Returns:
None
fill_pixel_wise_info(table, mask, histogram_binnings, focal_length, geom, event_type='')

Fills the quantities that are calculated pixel-wise

Parameters:
table: DL1 parameters, event-wise astropy table “image” from DL1 files
mask: indicates rows that have to be used for filling this container
histogram_binnings: container of type DL1DataCheckHistogramBins, with

definition of the binnings of all the histograms

focal_length: quantity; telescope focal length
geom: camera geometry, ctapipe.instrument.camera.geometry.CameraGeometry
event_type: ‘pedestals’ ‘flatfield’ or ‘cosmics’
Returns:
None