NOTE: Clicking the 'Get neighbors' checkbox will result in an additional neighbors query for each item in the search results, and the neighbors are thus shown in the results table. However, this causes the overall query to take longer, which is why it is un-checked by default.

Event queries

By event attributes

Relational and range queries can be made on event attributes.
  • instruments = "H1,L1,V1" & far < 1e-7
  • singleinspiral.mchirp >= 0.5 & singleinspiral.eff_distance in 0.0,55
  • (si.channel = "DMT-STRAIN" | si.channel = "DMT-PAIN") & si.snr < 5
  • mb.snr in 1,3 & mb.central_freq > 1000
Attributes in the common event object (eg gpstime, far, instruments) do not need qualifiers. Attributes specific to inspiral or burst events, for example, require qualification. Abbreviations are available: si for singleinspiral, ci for coincinspiral and mb for multiburst.

By GPS time

Specify an exact GPS time, or a range. Integers will be assumed to be GPS times, making the gpstime: keyword optional.
  • 899999000 .. 999999999
  • gpstime: 899999000.0 .. 999999999.9

By creation time

Creation time may be indicated by an exact time or a range. Date/times are in the format 2009-10-20 13:00:00 (must be UTC). If the time is omitted, it is assumed to be 00:00:00. Dates may also consist of certain variants of English-like phrases. The created: keyword is (generally) optional.
  • created: 2009-10-08 .. 2009-12-04 16:00:00
  • yesterday..now
  • created: 1 week ago .. now

By graceid

GraceIds can be specified either individually, or as a range. The gid: keyword is optional.
  • gid: G2011
  • G2011 .. G3000
  • G2011 G2032 G2033

By group, pipeline, and search

The group:, pipeline:, and search: keywords are optional. Names are case-insensitive. Note that events in the Test group will not be shown unless explicitly requested.
  • CBC Burst
  • group: Test pipeline: cwb
  • Burst cwb

By label

You may request only events with a particular label or set of labels. The label: keyword is optional. Label names can be combined with binary AND: '&' or ','; or binary OR: '|'. For N labels, there must be exactly N-1 binary operators. (Parentheses are not allowed.) Additionally, any of the labels in a query string can be negated with '~' or '-'.
  • label: INJ
  • EM_READY & ADVOK
  • H1OK | L1OK & ~INJ & ~DQV
Labels in current use are: INJ, DQV, EM_READY, PE_READY, H1NO, H1OK, H1OPS, L1NO, L1OK, L1OPS, V1NO, V1OK, V1OPS, ADVREQ, ADVOK, ADVNO, EM_COINC, EM_SENT

By submitter

To specify events from a given submitter, indicate the name of the submitter in double quotes. The submitter: is optional. While LIGO user names are predictable, most events are submitted through robot accounts and are not as predictable. This is probably a defect that ought to be remedied.
  • "waveburst"
  • "gstlalcbc" "gracedb.processor"
  • submitter: "joss.whedon@ligo.org" submitter: "gracedb.processor"

By superevent status

Use the in_superevent: to specify events which are/are not part of any superevent. Use the superevent: keyword to specify events which are part of a specific superevent. Use the is_preferred_event: keyword to specify events which are/are not preferred events for any superevent.
  • in_superevent: True
  • in_superevent: False
  • superevent: S180525c
  • is_preferred_event: True
  • is_preferred_event: False

Superevent queries

By id

The keywords id: or superevent_id: are optional.
  • id: S180525a
  • superevent_id: S170817b
  • GW180428C

By category

Specify a superevent category (Production, Test, MDC). Only production superevents are returned by default. The keyword category: is optional.
  • Test
  • category: MDC

By GPS time

Same as for event queries, with keywords gpstime: or t_0:.

By other time attributes

Queries based on the t_start and t_end attributes are also available.
  • t_start: 899999000
  • t_end: 899999000.0 .. 900000000.0

By preferred event graceids

Specify a graceid or range of graceids with keyword preferred_event: to get all superevents with corresponding preferred events.
  • preferred_event: G123456
  • preferred_event: G123456 .. G123500

By event graceids

Specify a graceid or range of graceids with keyword event: to get all superevents which contain the corresponding event(s).
  • event: G123456
  • event: G123456 .. G123500

By GW status

Query for superevents which are confirmed as GWs or not with the is_gw: keyword.
  • is_gw: True
  • is_gw: False

By creation time

Same as for events.

By submitter

Same as for events.

By label

Same as for events.

By public status

Use the is_public: or is_exposed: keywords:
  • is_public: True
  • is_exposed: True
Or, just add either "public" or "internal" to your query.

By preferred event FAR

  • far < 1e-5
  • FAR >= 0.01
  • far in 1e-7, 2.5e-6