fetch_filtered_events_json

gwosc.api.fetch_filtered_events_json(select, host='https://gwosc.org')

“Return the JSON metadata for the events constrained by select

Parameters:
  • select (list-like) – a list of range constrains for the events. All ranges should have inclusive ends (<= and >= operators).

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

Returns:

data – the JSON data retrieved from GWOSC and returnend by requests.Response.json()

Return type:

dict or list

Example

>>> fetch_filtered_events_json(
...     select=[
...         "mass-1-source <= 5",
...         "mass-2-source =< 10",
...         "10 <= luminosity-distance <= 100",
...     ]
... )