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.
`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 (`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`(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)	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 (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://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')[source]¶

Run checks.

This is a generator that yields a list of dicts.

load(self, 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(self, 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(self)[source]¶: Quick-look plots in a few panels.

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