Labels in GraceDB

Labels are applied to events and superevents in GraceDB to indicate the state of that object. Some labels signify that an action is requested, while others signify that a follow-up process has completed and/or what the result of a follow-up process was. Here is a table showing the currently available labels and their meanings.

Label name

Label description

2022_LENSING_MDC

Event is part of the O4 Lensing MDC.

ADVNO

EM advocate says event is not okay.

ADVOK

EM advocate says event is okay.

ADVREQ

EM advocate signoff requested.

COMBINEDSKYMAP_READY

Combined skymap is available.

cWB_r

cWB-AllSky search performed by the cWB-XP

cWB_s

cWB-AllSky search performed by the cWB-2G.subthr

DQOK

Data quality information is available and does not veto the event.

DQR_REQUEST

Superevent ready for DQR check.

DQV

Data quality veto.

EARLY_WARNING

Event is from an early-warning low-latency pipeline.

EMBRIGHT_READY

EM Bright information is available.

EM_COINC

Signifies that a coincidence was found between gravitational-wave candidates and External triggers.

EM_READY

Indicates data products associated with a Superevent’s preferred event are complete

EM_SENT

Has been sent to MOU partners.

EM_Selected

GraceID automatically chosen as the most promising candidate out of a set of entries thought to correspond to the same physical event.

EM_SelectedConfident

The event has all annotations necessary for an alert and passes the significant alert threshold.

EM_Superseded

GraceID automatically passed over because another entry was thought to be more promising and to correspond to the same physical event.

EM_Throttled

GraceID is ignored by automatic processing because the corresponding pipeline submitted too many events too quickly.

EXT_SKYMAP_READY

External skymap is available

GCN_PRELIM_SENT

A preliminary GCN has been sent.

GRB_OFFLINE

Indicates that offline triggered GRB searches found something coincident with this event.

GRB_ONLINE

Indicates that online triggered GRB searches found something coincident with this event.

H1NO

H1 operator says event is not okay.

H1OK

H1 operator says event is okay.

H1OPS

H1 operator signoff requested.

HIGH_PROFILE

Superevent satisfies the condition to convene the full Level 2 RRT ASAP.

HWINJNO

There were problems with the hardware injection.

HWINJOK

A hardware injection was successfully performed.

HWINJREQ

A hardware injection is scheduled.

INJ

Injection occured near this time.

L1NO

L1 operator says event is not okay.

L1OPS

L1 operator signoff requested.

LENSED_CANDIDATE

Candidate event was uploaded as part of a lensed search.

LLAMA_COMPLETE

LLAMA has completed annotating the superevent.

LOW_SIGNIF_LOCKED

The GraceID associated with this event has all annotations required for an alert, passes the low-significance public alert threshold, and will only be automatically updated when preliminary alerts are sent.

LOW_SIGNIF_PRELIM_SENT

A low-significance preliminary GCN has been sent.

LUMIN_GO

Trigger satisfies basic automated checks and should be vetted by humans. Replaced by ADVREQ

LUMIN_NO

LUMIN No

NOT_GRB

Event is likely not an astrophysical gamma ray burst

PASTRO_READY

p_astro is available.

PE_READY

Parameter estimation results are available

RAVEN_ALERT

A RAVEN coincidence event is publishable

SIGNIF_LOCKED

The GraceID associated with this event has all annotations required for an alert, passes the significant public alert threshold, and will only be automatically updated when preliminary alerts are sent.

SKYMAP_READY

Skymap is available.

SOG_READY

A coincidence should trigger a speed of gravity measurement.

SNR_OPTIMIZED

Indicates that the event was SNR-optimized as followup to another uploaded event.

SUBSOLAR_MASS

Event is from a subsolar mass low-latency pipeline.

SWIFT_GO

Send notification to SWIFT telescope.

SWIFT_NO

Do not send notification to SWIFT telescope.

V1NO

V1 operator says event is not okay.

V1OK

V1 operator says event is okay.

V1OPS

V1 operator signoff requested.

Protected labels

A few labels are “protected”; i.e., they are only applied by GraceDB itself as part of another process. These labels cannot be applied manually by users and any requests to do so will be rejected by the server.

At present, the following labels are protected as a part of the signoff infrastructure and are only applied by GraceDB after an operator or advocate signoff:

  • H1OK, L1OK, V1OK, ADVOK

  • H1NO, L1NO, V1NO, ADVNO