Skip to contents

Get GWOSC parameters for one or more GW events

get_gwosc_param.Rd

This function queries the GWOSC API v2 to fetch, for each requested event, the latest-event-version GPS time and the preferred (default) physical parameters. It returns either all allowed parameters or a user-specified subset of parameter columns.

Usage

get_gwosc_param(name, param = "all")

Arguments

name

Character vector. One or more event names (e.g., c("GW150914","GW151012")).

param

Character. Either "all" (default) for all parameters, or a character vector of column names from list_gwosc_param() to select. The output preserves the order of param.

Value

A data.frame whose rows correspond to the requested events (in the same order as name) and whose columns are either all allowed parameters or the requested subset. Row names are set to event names.

Details

The function automatically:

  • Selects the latest event version per event name.

  • Extracts GPS time from event-version details or, if missing, from the preferred pipeline parameters (e.g., geocent_time).

  • Uses only preferred (default) parameter values provided by GWOSC.

  • Returns absolute values for lower/upper errors.

See also

list_gwosc_param

Examples

if (FALSE) { # \dontrun{
# All parameters for multiple events
get_gwosc_param(c("GW150914", "GW151012"), "all")

# A subset of parameters (order preserved)
get_gwosc_param("GW150914", c("luminosity_distance", "GPS"))

# Single parameter for multiple events
get_gwosc_param(c("GW150914", "GW151012"), "chirp_mass_source")
} # }