find_datasets

gwosc.datasets.find_datasets(detector=None, type=None, segment=None, match=None, catalog=None, version=None, host='https://gwosc.org')

Find datasets available on the given GW open science host

Parameters:

  • detector (str, optional) – prefix of GW detector

  • type (str, optional) – type of datasets to restrict, one of 'run', 'event', or 'catalog'

  • segment (2-tuple of int, None, optional) – a GPS [start, stop) interval to restrict matches to; datasets will match if they overlap at any point; this is not used to filter catalogs

  • match (str, optional) – regular expression string against which to match datasets

  • host (str, optional) – the URL of the GWOSC host to query, defaults to https://gwosc.org

Returns:

datasets – the names of all matched datasets, possibly empty

Return type:

list of str

Examples

(Correct as of 2018-03-14)

>>> from gwosc.datasets import find_datasets
>>> find_datasets()
['GW150914', 'GW151226', 'GW170104', 'GW170608', 'GW170814', 'GW170817',
 'LVT151012', 'O1', 'S5', 'S6']
>>> find_datasets(detector='V1')
['GW170814', 'GW170817']
>>> find_datasets(type='event')
['GW150914', 'GW151226', 'GW170104', 'GW170608', 'GW170814', 'GW170817',
 'LVT151012']