Skip to main content

GWSkyNet : a machine learning algorithm used for estimating the probabiliy that a gravitational wave candidate is of astrophysical origin

Project description

GWSkyNet

GWSkyNet, developed by Cabero et al 2020, is a machine learning classifier capable of distinguishing between astrophysical events and instrumental artifacts. Designed to facilitate potential EM follow-up observations, the classifier can be operated in low-latency and provide information complementary to what has previously been released in an Open Public Alert(OPA) seconds after an alert is published. A unique feature of the classifier is that it needs only the publicly available information from the OPA system. The classifier can also be expanded easily to intake other information such as the SNRs of a GW candidate in each detector in the network.

GWSkyNet is now being developed as a low-latency annotation pipeline for the fourth observing run of the LIGO Scientific and Virgo Collaboration (O4).

For more detail, please refer to the following document

Getting started

The current version of GWSkyNet uses the following libaries:

  • numpy 1.23.2
  • astropy 5.1.1
  • reproject 0.8
  • ligo.skymap 1.0.2
  • tensorflow 2.9.1
  • scipy 1.8.0

Using GWSkyNet is easy.

To apply GWSkyNet to a graviational wave candidate to determine the origin of the gravitational wave candidate (glitch or astrophysical) , all is needed is a FITS file corresponding to the gravitational wave alert. Such a FITS file may be downloaded from GraceDB

In the following example, we will use the FITS files corresponding to the Open Public Alert S190421ar.

To apply GWSkyNet to S190421ar, perform the following:

import GWSkyNet.GWSkyNet as G
model       = G.load_GWSkyNet_model()
data        = G.prepare_data('S190421ar.fits')
class_score = G.predict(model, data)
FAR, FNR    = G.get_rates(class_score[0])

Running the above code will output a class score equal to 0.995. A class_score closer to 1 indicates the origin is more likely to be astrophysical. FAR and FNR stand for False Alarm Rate and False Negative Rate respectively.

Architecture

GWSkyNet architecture. The first two branches are convolutional neural networks with residual connections for image data. The shape of the input data is indicated in parenthesis, with N the number of examples in the training set. The numbers in the SeparableConv2D (SepConv) and MaxPool layers indicate the kernel size in pixels and the number of filters (when applicable). The number in the Dense layers indicates the number of units.

Performance

False Positive Rate (FPR) and False Negative Rate (FNR) as functions of the Real-Noise (RN) score threshold. At a score threshold RN>=0.5, GWSkyNet yields 5.3% FNR and 3.8% FPR. Lowering the threshold to RN>=0.1 reduces the FNR to 2.4%, with FPR increased to 9.3%. The intersection is at RN=0.39, with FPR=FNR=4.5%.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gwskynet-2.5.2.tar.gz (68.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

GWSkyNet-2.5.2-py3-none-any.whl (68.8 kB view details)

Uploaded Python 3

File details

Details for the file gwskynet-2.5.2.tar.gz.

File metadata

  • Download URL: gwskynet-2.5.2.tar.gz
  • Upload date:
  • Size: 68.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.13

File hashes

Hashes for gwskynet-2.5.2.tar.gz
Algorithm Hash digest
SHA256 920192d1db70b11ebff8fe22a30932d7b6e50ecf5538796e63e595961959eb05
MD5 79afc7a4c9bf1f4bf8a8c698e1328a5c
BLAKE2b-256 b365ea098e28c4eb66a08d143e98c2cd77da552efe400827921b17e5b0c8a0f6

See more details on using hashes here.

File details

Details for the file GWSkyNet-2.5.2-py3-none-any.whl.

File metadata

  • Download URL: GWSkyNet-2.5.2-py3-none-any.whl
  • Upload date:
  • Size: 68.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.13

File hashes

Hashes for GWSkyNet-2.5.2-py3-none-any.whl
Algorithm Hash digest
SHA256 f65f07672a8752164e004430a5bc2a27d1a49e7e3bea09a1c88ea7cd3d9c1c14
MD5 8dfe45f05081c508047e22f734050c77
BLAKE2b-256 4f59c13fd212cc3f0a9a054f0c1c128fc93d62f2d135b67a440cbd62e17dc792

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page