DataStoreObservation

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

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')

Run checks.

This is a generator that yields a list of dicts.

load(hdu_type=None, hdu_class=None)

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)

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()

Quick-look plots in a few panels.

select_time(time_interval)

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