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.
fixed_pointing_info	Fixed pointing info for this observation (FixedPointingInfo).
gti	Load gammapy.data.GTI object and apply the filter.
muoneff	Observation muon efficiency.
obs_info	Observation information (dict).
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(self[, checks])	Run checks.
load(self[, hdu_type, hdu_class])	Load data file as appropriate object.
location(self[, hdu_type, hdu_class])	HDU location object.
peek(self[, figsize])	Quick-look plots in a few panels.
select_time(self, 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.

fixed_pointing_info

Fixed pointing info for this observation (FixedPointingInfo).

gti

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

muoneff

Observation muon efficiency.

obs_info

Observation information (dict).

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://ui.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(self, checks='all')

Run checks.

This is a generator that yields a list of dicts.

load(self, 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(self, 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(self, figsize=(12, 10))

Quick-look plots in a few panels.

select_time(self, 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