- Notifications
You must be signed in to change notification settings - Fork14
Mirror of Official GWOSC Client project
License
gwpy/gwosc
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
Thegwosc package provides an interface to querying the open datareleases hosted onhttps://gwosc.org from the GEO, LIGO,and Virgo gravitational-wave observatories.
To install:
conda install -c conda-forge gwoscor
pip install gwoscTo search for available datasets (correct as of March 14 2018):
>>>fromgwoscimportdatasets>>>datasets.find_datasets()['GW150914','GW151226','GW170104','GW170608','GW170814','GW170817','LVT151012','O1','S5','S6']>>>datasets.find_datasets(detector='V1')['GW170814','GW170817']>>>datasets.find_datasets(type='run')['O1','S5','S6']
To query for the GPS time of an event dataset (or vice-versa):
>>>datasets.event_gps('GW170817')1187008882.43>>>datasets.event_at_gps(1187008882)'GW170817'
Similar queries are available for observing run datasets:
>>>datasets.run_segment('O1')(1126051217,1137254417)>>>datasets.run_at_gps(1135136350)# event_gps('GW151226')'O1'
You can search for remote data URLS based on the event name:
>>>fromgwosc.locateimportget_event_urls>>>get_event_urls('GW150914')['https://gwosc.org/eventapi/json/GWTC-1-confident/GW150914/v3/H-H1_GWOSC_4KHZ_R1-1126259447-32.hdf5','https://gwosc.org/eventapi/json/GWTC-1-confident/GW150914/v3/H-H1_GWOSC_4KHZ_R1-1126257415-4096.hdf5','https://gwosc.org/eventapi/json/GWTC-1-confident/GW150914/v3/L-L1_GWOSC_4KHZ_R1-1126259447-32.hdf5','https://gwosc.org/eventapi/json/GWTC-1-confident/GW150914/v3/L-L1_GWOSC_4KHZ_R1-1126257415-4096.hdf5']
You can down-select the URLs using keyword arguments:
>>>get_event_urls('GW150914',detector='L1',duration=32)['https://gwosc.org/eventapi/json/GWTC-1-confident/GW150914/v3/L-L1_GWOSC_4KHZ_R1-1126259447-32.hdf5']
You can search for remote data URLs based on the GPS time interval asfollows:
>>>fromgwosc.locateimportget_urls>>>get_urls('L1',968650000,968660000)['https://gwosc.org/archive/data/S6/967835648/L-L1_LOSC_4_V1-968646656-4096.hdf5','https://gwosc.org/archive/data/S6/967835648/L-L1_LOSC_4_V1-968650752-4096.hdf5','https://gwosc.org/archive/data/S6/967835648/L-L1_LOSC_4_V1-968654848-4096.hdf5','https://gwosc.org/archive/data/S6/967835648/L-L1_LOSC_4_V1-968658944-4096.hdf5']
This arguments for this function are as follows
detector: the prefix of the relevant gravitational-waveinterferometer, either'H1'for LIGO-Hanford, or'L1'for LIGOLivingston,start: the GPS start time of the interval of interestend: the GPS end time of the interval of interest
By default, this method will return the paths to HDF5 files for the 4kHz sample-rate data, these can be specified as keyword arguments. Forfull information, run
>>>help(get_urls)
You can also search for Timeline segments, based on a flag name, and aGPS time interval as follows:
>>>fromgwosc.timelineimportget_segments>>>get_segments('H1_DATA',1126051217,1126151217)[(1126073529,1126114861), (1126121462,1126123267), (1126123553,1126126832), (1126139205,1126139266), (1126149058,1126151217)]
The output is alist of(start, end) 2-tuples which each represent asemi-open time interval.
For documentation on what flags are available, for example for the O1science run, seethe O1 data release page(Data Quality).
About
Mirror of Official GWOSC Client project