ligo-gracedb is a Python package which provides tools for accessing the API of the Gravitational-wave Candidate Event Database (GraceDB). It is compatible with Python 2.7, 3.5, 3.6, and 3.7.

ligo-gracedb provides functionality which allows users to do the following:

  • Create, update, and retrieve information about events and superevents
  • Create and retrieve log entries
  • Upload and download files
  • Apply and remove labels to/from events and superevents
  • And more!