Sample Code

This section provides Python sample code for receiving and interacting with GCN Notices. GCN Notices are available over several different protocols and in several different formats. LIGO/Virgo strongly recommends using the VOEvent Transport Protocol (VTP) to receive notices in VOEvent XML format because it is anonymous, configuration-free, and easy to parse.

This tutorial will walk you through writing a Python script to receive and process the example LIGO/Virgo GCN notices that are sent every hour. The tutorial is broken into the following subsections:

• Prerequisites
• Receiving GCNs
• Working with Sky Maps
• Multi-Order Sky Maps (For Advanced Users)
• Basic Observability Calculations
• Distance and 3D Sky Maps
• Additional Tools