DL1ParametersContainer

class lstchain.io.lstcontainers.DL1ParametersContainer(prefix=None, **fields)

Bases: Container

TODO: maybe fields could be inherited from ctapipe containers definition

For now I have not found an elegant way to do so

Attributes:
intensityField(default=nan)

Total intensity (size)

log_intensityField(default=nan)

log of total intensity (size)

xField(default=nan m, unit=m)

Centroid x coordinate

yField(default=nan m, unit=m)

Centroid y coordinate

rField(default=nan m, unit=m)

Radial coordinate of centroid

phiField(default=nan, unit=rad)

Polar coordinate of centroid

lengthField(default=nan deg, unit=deg)

RMS spread along the major-axis

length_uncertaintyField(default=nan deg, unit=deg)

Uncertainty of length

widthField(default=nan deg, unit=deg)

RMS spread along the minor-axis

width_uncertaintyField(default=nan deg, unit=deg)

Uncertainty of width

psiField(default=nan, unit=rad)

Rotation angle of ellipse

skewnessField(default=nan)

Measure of the asymmetry

kurtosisField(default=nan)

Measure of the tailedness

disp_normField(default=None, unit=m)

disp_norm [m]

disp_dxField(default=None, unit=m)

disp_dx [m]

disp_dyField(default=None, unit=m)

disp_dy [m]

disp_angleField(default=None, unit=rad)

disp_angle [rad]

disp_signField(default=None)

disp_sign

disp_missField(default=None, unit=m)

disp_miss [m]

src_xField(default=None, unit=m)

Source x coordinate in camera frame

src_yField(default=None, unit=m)

Source y coordinate in camera frame

time_gradientField(default=nan)

Time gradient in the camera

interceptField(default=nan)

Intercept

leakage_intensity_width_1Field(default=nan, dtype=float32)

Fraction of intensity in outermost pixels

leakage_intensity_width_2Field(default=nan, dtype=float32)

Fraction of intensity in two outermost rings of pixels

leakage_pixels_width_1Field(default=nan)

Fraction of signal pixels that are border pixels

leakage_pixels_width_2Field(default=nan)

Fraction of signal pixels that are in the two outermost rings of pixels

n_pixelsField(default=-1)

Number of pixels after cleaning

concentration_cogField(default=nan)

Fraction of intensity inside one pixel diameter of the cog

concentration_coreField(default=nan)

Fraction of intensity inside hillas ellipse

concentration_pixelField(default=nan)

Fraction of intensity in brightest pixel

n_islandsField(default=-1)

Number of Islands

alt_telField(default=None, unit=rad)

Telescope altitude pointing

az_telField(default=None, unit=rad)

Telescope azimuth pointing

sin_az_telField(default=None)

Sin of telescope azimuth pointing, used for RF

obs_idField(default=-1)

Observation ID

event_idField(default=-1)

Event ID

calibration_idField(default=-1)

ID of the employed calibration event

dragon_timeField(default=None)

Dragon time event trigger

ucts_timeField(default=None)

UCTS time event trigger

tib_timeField(default=None)

TIB time event trigger

ucts_jumpField(default=False)

UCTS info jumped (corrected)

mc_energyField(default=None, unit=TeV)

Simulated Energy

log_mc_energyField(default=None)

log of simulated energy/TeV

mc_altField(default=None, unit=rad)

Simulated altitude

mc_azField(default=None, unit=rad)

Simulated azimuth

mc_core_xField(default=None, unit=m)

Simulated impact point x position

mc_core_yField(default=None, unit=m)

Simulated impact point y position

mc_h_first_intField(default=None, unit=m)

Simulated first interaction height

mc_typeField(default=-9999)

MC shower primary ID 0 (gamma), 1(e-),2(mu-), 100*A+Z for nucleons and nuclei,negative for antimatter.

mc_az_telField(default=None, unit=rad)

Telescope MC azimuth pointing

mc_alt_telField(default=None, unit=rad)

Telescope MC altitude pointing

mc_x_maxField(default=None, unit=g / cm2)

MC Xmax value

mc_core_distanceField(default=None, unit=m)

Distance from the impact point to the telescope

hadronessField(default=None)

Hadroness

wlField(default=nan)

width/length

tel_idField(default=None)

Telescope Id

tel_pos_xField(default=None)

Telescope x position in the ground

tel_pos_yField(default=None)

Telescope y position in the ground

tel_pos_zField(default=None)

Telescope z position in the ground

trigger_typeField(default=None)

Trigger type

ucts_trigger_typeField(default=None)

UCTS trigger type

trigger_timeField(default=None)

Trigger time

event_typeField(default=None)

Event type

metadict

dict of attached metadata

prefixstr

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

Attributes Summary

alt_tel

az_tel

calibration_id

concentration_cog

concentration_core

concentration_pixel

default_prefix

disp_angle

disp_dx

disp_dy

disp_miss

disp_norm

disp_sign

dragon_time

event_id

event_type

fields

hadroness

intensity

intercept

kurtosis

leakage_intensity_width_1

leakage_intensity_width_2

leakage_pixels_width_1

leakage_pixels_width_2

length

length_uncertainty

log_intensity

log_mc_energy

mc_alt

mc_alt_tel

mc_az

mc_az_tel

mc_core_distance

mc_core_x

mc_core_y

mc_energy

mc_h_first_int

mc_type

mc_x_max

meta

n_islands

n_pixels

obs_id

phi

prefix

psi

r

sin_az_tel

skewness

src_x

src_y

tel_id

tel_pos_x

tel_pos_y

tel_pos_z

tib_time

time_gradient

trigger_time

trigger_type

ucts_jump

ucts_time

ucts_trigger_type

width

width_uncertainty

wl

x

y

Methods Summary

fill_event_info(event)

fill_hillas(hillas)

fill Hillas parameters

fill_mc(event, tel_pos)

fill from mc

get_features(features_names)

set_concentration(geom, image, hillas_parameters)

set_disp(source_pos, hillas)

set_leakage(geom, image, clean)

set_n_islands(geom, clean)

set_source_camera_position(event, telescope)

set_telescope_info(subarray, telescope_id)

set_timing_features(geom, image, peak_time, ...)

Attributes Documentation

alt_tel
az_tel
calibration_id
concentration_cog
concentration_core
concentration_pixel
default_prefix = 'dl1parameters'
disp_angle
disp_dx
disp_dy
disp_miss
disp_norm
disp_sign
dragon_time
event_id
event_type
fields = {'alt_tel': Field(default=None, unit=rad), 'az_tel': Field(default=None, unit=rad), 'calibration_id': Field(default=-1), 'concentration_cog': Field(default=nan), 'concentration_core': Field(default=nan), 'concentration_pixel': Field(default=nan), 'disp_angle': Field(default=None, unit=rad), 'disp_dx': Field(default=None, unit=m), 'disp_dy': Field(default=None, unit=m), 'disp_miss': Field(default=None, unit=m), 'disp_norm': Field(default=None, unit=m), 'disp_sign': Field(default=None), 'dragon_time': Field(default=None), 'event_id': Field(default=-1), 'event_type': Field(default=None), 'hadroness': Field(default=None), 'intensity': Field(default=nan), 'intercept': Field(default=nan), 'kurtosis': Field(default=nan), 'leakage_intensity_width_1': Field(default=nan, dtype=float32), 'leakage_intensity_width_2': Field(default=nan, dtype=float32), 'leakage_pixels_width_1': Field(default=nan), 'leakage_pixels_width_2': Field(default=nan), 'length': Field(default=nan deg, unit=deg), 'length_uncertainty': Field(default=nan deg, unit=deg), 'log_intensity': Field(default=nan), 'log_mc_energy': Field(default=None), 'mc_alt': Field(default=None, unit=rad), 'mc_alt_tel': Field(default=None, unit=rad), 'mc_az': Field(default=None, unit=rad), 'mc_az_tel': Field(default=None, unit=rad), 'mc_core_distance': Field(default=None, unit=m), 'mc_core_x': Field(default=None, unit=m), 'mc_core_y': Field(default=None, unit=m), 'mc_energy': Field(default=None, unit=TeV), 'mc_h_first_int': Field(default=None, unit=m), 'mc_type': Field(default=-9999), 'mc_x_max': Field(default=None, unit=g / cm2), 'n_islands': Field(default=-1), 'n_pixels': Field(default=-1), 'obs_id': Field(default=-1), 'phi': Field(default=nan, unit=rad), 'psi': Field(default=nan, unit=rad), 'r': Field(default=nan m, unit=m), 'sin_az_tel': Field(default=None), 'skewness': Field(default=nan), 'src_x': Field(default=None, unit=m), 'src_y': Field(default=None, unit=m), 'tel_id': Field(default=None), 'tel_pos_x': Field(default=None), 'tel_pos_y': Field(default=None), 'tel_pos_z': Field(default=None), 'tib_time': Field(default=None), 'time_gradient': Field(default=nan), 'trigger_time': Field(default=None), 'trigger_type': Field(default=None), 'ucts_jump': Field(default=False), 'ucts_time': Field(default=None), 'ucts_trigger_type': Field(default=None), 'width': Field(default=nan deg, unit=deg), 'width_uncertainty': Field(default=nan deg, unit=deg), 'wl': Field(default=nan), 'x': Field(default=nan m, unit=m), 'y': Field(default=nan m, unit=m)}
hadroness
intensity
intercept
kurtosis
leakage_intensity_width_1
leakage_intensity_width_2
leakage_pixels_width_1
leakage_pixels_width_2
length
length_uncertainty
log_intensity
log_mc_energy
mc_alt
mc_alt_tel
mc_az
mc_az_tel
mc_core_distance
mc_core_x
mc_core_y
mc_energy
mc_h_first_int
mc_type
mc_x_max
meta
n_islands
n_pixels
obs_id
phi
prefix
psi
r
sin_az_tel
skewness
src_x
src_y
tel_id
tel_pos_x
tel_pos_y
tel_pos_z
tib_time
time_gradient
trigger_time
trigger_type
ucts_jump
ucts_time
ucts_trigger_type
width
width_uncertainty
wl
x
y

Methods Documentation

fill_event_info(event)
fill_hillas(hillas)

fill Hillas parameters

hillas: HillasParametersContainer # TODO : parameters should not be simply copied but inherited (e.g. conserving unit definition)

fill_mc(event, tel_pos)

fill from mc

get_features(features_names)
set_concentration(geom, image, hillas_parameters)
set_disp(source_pos, hillas)
set_leakage(geom, image, clean)
set_n_islands(geom, clean)
set_source_camera_position(event, telescope)
set_telescope_info(subarray, telescope_id)
set_timing_features(geom, image, peak_time, hillas)