DataStore

class gammapy.data.DataStore(hdu_table=None, obs_table=None)

Bases: object

IACT data store.

The data selection and access happens using an observation and an HDU index file as described at IACT data storage.

See cta_1dc_introduction.html for usage examples.

Parameters:

hdu_table : HDUIndexTable

HDU index table

obs_table : ObservationTable

Observation index table

Examples

Here’s an example how to create a DataStore to access H.E.S.S. data:

>>> from gammapy.data import DataStore
>>> data_store = DataStore.from_dir('$GAMMAPY_DATA/hess-dl3-dr1')
>>> data_store.info()

Attributes Summary

DEFAULT_HDU_TABLE	Default HDU table filename.
DEFAULT_OBS_TABLE	Default observation table filename.

Methods Summary

check([checks])	Check index tables and data files.
copy_obs(obs_id, outdir[, hdu_class, …])	Create a new DataStore containing a subset of observations.
from_config(config)	Create from a config dict.
from_dir(base_dir[, hdu_table_filename, …])	Create from a directory.
from_file(filename[, hdu_hdu, hdu_obs])	Create from a FITS file.
get_observations(obs_id[, skip_missing])	Generate a Observations.
info([show])	Print some info.
obs(obs_id)	Access a given DataStoreObservation.

Attributes Documentation

DEFAULT_HDU_TABLE = 'hdu-index.fits.gz'

Default HDU table filename.

DEFAULT_OBS_TABLE = 'obs-index.fits.gz'

Default observation table filename.

Methods Documentation

check(checks='all')

Check index tables and data files.

This is a generator that yields a list of dicts.

copy_obs(obs_id, outdir, hdu_class=None, verbose=False, overwrite=False)

Create a new DataStore containing a subset of observations.

Parameters:

obs_id : array-like, ObservationTable

List of observations to copy

outdir : str, Path

Directory for the new store

hdu_class : list of str

see gammapy.data.HDUIndexTable.VALID_HDU_CLASS

verbose : bool

Print copied files

overwrite : bool

Overwrite

classmethod from_config(config)

Create from a config dict.

classmethod from_dir(base_dir, hdu_table_filename=None, obs_table_filename=None)

Create from a directory.

Parameters:

base_dir : str, Path

Base directory of the data files.

hdu_table_filename : str, Path

Filename of the HDU index file. May be specified either relative to base_dir or as an absolute path. If None, the default filename will be looked for.

obs_table_filename : str, Path

Filename of the observation index file. May be specified either relative to base_dir or as an absolute path. If None, the default filename will be looked for.

classmethod from_file(filename, hdu_hdu='HDU_INDEX', hdu_obs='OBS_INDEX')

Create from a FITS file.

The FITS file must contain both index files.

Parameters:

filename : str, Path

FITS filename

hdu_hdu : str or int

FITS HDU name or number for the HDU index table

hdu_obs : str or int

FITS HDU name or number for the observation index table

get_observations(obs_id, skip_missing=False)

Generate a Observations.

Parameters:

obs_id : list

Observation IDs.

skip_missing : bool, optional

Skip missing observations, default: False

Returns:

observations : Observations

Container holding a list of DataStoreObservation

info(show=True)

Print some info.

obs(obs_id)

Access a given DataStoreObservation.

Parameters:

obs_id : int

Observation ID.

Returns:

observation : DataStoreObservation

Observation container