DataStoreObservation

class gammapy.data.DataStoreObservation(obs_id, data_store, obs_filter=None)[source]

Bases: object

IACT data store observation.

Parameters:
obs_id : int

Observation ID

data_store : DataStore

Data store

obs_filter : ObservationFilter, optional

Filter for the observation

Attributes Summary

aeff Load effective area object.
bkg Load background object.
edisp Load energy dispersion object.
events Load gammapy.data.EventList object and apply the filter.
gti Load gammapy.data.GTI object and apply the filter.
muoneff Observation muon efficiency.
obs_info Observation information (OrderedDict).
observation_dead_time_fraction Dead-time fraction (float).
observation_live_time_duration Live-time duration in seconds (Quantity).
observation_time_duration Observation time duration in seconds (Quantity).
observatory_earth_location Observatory location (EarthLocation).
pointing_altaz Pointing ALT / AZ sky coordinates (SkyCoord).
pointing_radec Pointing RA / DEC sky coordinates (SkyCoord).
pointing_zen Pointing zenith angle sky (Quantity).
psf Load point spread function object.
target_radec Target RA / DEC sky coordinates (SkyCoord).
tstart Observation start time (Time).
tstop Observation stop time (Time).

Methods Summary

check([checks]) Run checks.
load([hdu_type, hdu_class]) Load data file as appropriate object.
location([hdu_type, hdu_class]) HDU location object.
peek() Quick-look plots in a few panels.
select_time(time_interval) Select a time interval of the observation.

Attributes Documentation

aeff

Load effective area object.

bkg

Load background object.

edisp

Load energy dispersion object.

events

Load gammapy.data.EventList object and apply the filter.

gti

Load gammapy.data.GTI object and apply the filter.

muoneff

Observation muon efficiency.

obs_info

Observation information (OrderedDict).

observation_dead_time_fraction

Dead-time fraction (float).

Defined as dead-time over observation time.

Dead-time is defined as the time during the observation where the detector didn’t record events: https://en.wikipedia.org/wiki/Dead_time https://adsabs.harvard.edu/abs/2004APh….22..285F

The dead-time fraction is used in the live-time computation, which in turn is used in the exposure and flux computation.

observation_live_time_duration

Live-time duration in seconds (Quantity).

The dead-time-corrected observation time.

Computed as t_live = t_observation * (1 - f_dead) where f_dead is the dead-time fraction.

observation_time_duration

Observation time duration in seconds (Quantity).

The wall time, including dead-time.

observatory_earth_location

Observatory location (EarthLocation).

pointing_altaz

Pointing ALT / AZ sky coordinates (SkyCoord).

pointing_radec

Pointing RA / DEC sky coordinates (SkyCoord).

pointing_zen

Pointing zenith angle sky (Quantity).

psf

Load point spread function object.

target_radec

Target RA / DEC sky coordinates (SkyCoord).

tstart

Observation start time (Time).

tstop

Observation stop time (Time).

Methods Documentation

check(checks='all')[source]

Run checks.

This is a generator that yields a list of dicts.

load(hdu_type=None, hdu_class=None)[source]

Load data file as appropriate object.

Parameters:
hdu_type : str

HDU type (see VALID_HDU_TYPE)

hdu_class : str

HDU class (see VALID_HDU_CLASS)

Returns:
object : object

Object depends on type, e.g. for events it’s a EventList.

location(hdu_type=None, hdu_class=None)[source]

HDU location object.

Parameters:
hdu_type : str

HDU type (see VALID_HDU_TYPE)

hdu_class : str

HDU class (see VALID_HDU_CLASS)

Returns:
location : HDULocation

HDU location

peek()[source]

Quick-look plots in a few panels.

select_time(time_interval)[source]

Select a time interval of the observation.

Parameters:
time_interval : astropy.time.Time

Start and stop time of the selected time interval. For now we only support a single time interval.

Returns:
new_obs : DataStoreObservation

A new observation instance of the specified time interval