Datasets

class gammapy.datasets.Datasets(datasets=None)

Bases: collections.abc.MutableSequence

Dataset collection.

Parameters

datasetsDataset or list of Dataset

Datasets

Attributes Summary

contributes_to_stat	Stat contributions
energy_axes_are_aligned	Whether all contained datasets have aligned energy axis
energy_ranges	Get global energy range of datasets.
gti	GTI table
is_all_same_energy_shape	Whether all contained datasets have the same data shape
is_all_same_shape	Whether all contained datasets have the same data shape
is_all_same_type	Whether all contained datasets are of the same type
meta_table	Meta table
models	Unique models (Models).
names
parameters	Unique parameters (Parameters).

Methods Summary

append(value)	S.append(value) – append value to the end of the sequence
clear()
copy()	A deep copy.
count(value)
extend(values)	S.extend(iterable) – extend sequence by appending elements from the iterable
index(value, [start, [stop]])	Raises ValueError if the value is not present.
info_table([cumulative])	Get info table for datasets.
insert(idx, dataset)	S.insert(index, value) – insert value before index
pop([index])	Raise IndexError if list is empty or index is out of range.
read(filename[, filename_models, lazy, cache])	De-serialize datasets from YAML and FITS files.
remove(value)	S.remove(value) – remove first occurrence of value.
reverse()	S.reverse() – reverse IN PLACE
select_time(time_min, time_max[, atol])	Select datasets in a given time interval.
slice_by_energy(energy_min, energy_max)	Select and slice datasets in energy range
stack_reduce([name, nan_to_num])	Reduce the Datasets to a unique Dataset by stacking them together.
stat_sum()	Compute joint likelihood
to_spectrum_datasets(region)	Extract spectrum datasets for the given region.
write(filename[, filename_models, …])	Serialize datasets to YAML and FITS files.

Attributes Documentation

contributes_to_stat

Stat contributions

Returns

contributionsarray

Array indicating which dataset contributes to the likelihood.

energy_axes_are_aligned

Whether all contained datasets have aligned energy axis

energy_ranges

Get global energy range of datasets.

The energy range is derived as the minimum / maximum of the energy ranges of all datasets.

Returns

energy_min, energy_maxQuantity

Energy range.

gti

GTI table

is_all_same_energy_shape

Whether all contained datasets have the same data shape

is_all_same_shape

Whether all contained datasets have the same data shape

is_all_same_type

Whether all contained datasets are of the same type

meta_table

Meta table

models

Unique models (Models).

Duplicate model objects have been removed. The order of the unique models remains.

names

parameters

Unique parameters (Parameters).

Duplicate parameter objects have been removed. The order of the unique parameters remains.

Methods Documentation

append(value)

S.append(value) – append value to the end of the sequence

clear() → None -- remove all items from S

copy()

A deep copy.

count(value) → integer -- return number of occurrences of value

extend(values)

S.extend(iterable) – extend sequence by appending elements from the iterable

index(value[, start[, stop]]) → integer -- return first index of value.

Raises ValueError if the value is not present.

Supporting start and stop arguments is optional, but recommended.

info_table(cumulative=False)

Get info table for datasets.

Parameters

cumulativebool

Cumulate info across all observations

Returns

info_tableTable

Info table.

insert(idx, dataset)

S.insert(index, value) – insert value before index

pop([index]) → item -- remove and return item at index (default last).

Raise IndexError if list is empty or index is out of range.

classmethod read(filename, filename_models=None, lazy=True, cache=True)

De-serialize datasets from YAML and FITS files.

Parameters

filenamestr or Path

File path or name of datasets yaml file

filename_modelsstr or Path

File path or name of models fyaml ile

lazybool

Whether to lazy load data into memory

cachebool

Whether to cache the data after loading.

Returns

datasetgammapy.datasets.Datasets

Datasets

remove(value)

S.remove(value) – remove first occurrence of value. Raise ValueError if the value is not present.

reverse()

S.reverse() – reverse IN PLACE

select_time(time_min, time_max, atol='1e-6 s')

Select datasets in a given time interval.

Parameters

time_min, time_maxTime

Time interval

atolQuantity

Tolerance value for time comparison with different scale. Default 1e-6 sec.

Returns

datasetsDatasets

Datasets in the given time interval.

slice_by_energy(energy_min, energy_max)

Select and slice datasets in energy range

The method keeps the current dataset names. Datasets, that do not contribute to the selected energy range are dismissed.

Parameters

energy_min, energy_maxQuantity

Energy bounds to compute the flux point for.

Returns

datasetsDatasets

Datasets

stack_reduce(name=None, nan_to_num=True)

Reduce the Datasets to a unique Dataset by stacking them together.

This works only if all Dataset are of the same type and if a proper in-place stack method exists for the Dataset type.

Parameters

namestr

Name of the stacked dataset.

nan_to_num: bool

Non-finite values are replaced by zero if True (default).

Returns

datasetDataset

the stacked dataset

stat_sum()

Compute joint likelihood

to_spectrum_datasets(region)

Extract spectrum datasets for the given region.

Parameters

regionSkyRegion

Region definition.

Returns

datasetsDatasets

List of SpectrumDataset

write(filename, filename_models=None, overwrite=False, write_covariance=True)

Serialize datasets to YAML and FITS files.

Parameters

filenamestr or Path

File path or name of datasets yaml file

filename_modelsstr or Path

File path or name of models yaml file

overwritebool

overwrite datasets FITS files

write_covariancebool

save covariance or not