find_datasets¶

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

Find datasets available on the given GW open science host

Parameters:¶

detector=None¶

prefix of GW detector

type=None¶

type of datasets to restrict, one of 'run', 'event', or 'catalog'

segment=None¶

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=None¶

regular expression string against which to match datasets

host='https://gwosc.org'¶

the URL of the GWOSC host to query, defaults to https://gwosc.org

session=None¶

the session to use for HTTP requests

pagesize=None¶

the number of results per page.

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']