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.0.tar.gz (68.8 kB view details)

Uploaded Source

Built Distribution

GWSkyNet-2.5.0-py3-none-any.whl (69.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: gwskynet-2.5.0.tar.gz
  • Upload date:
  • Size: 68.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.7

File hashes

Hashes for gwskynet-2.5.0.tar.gz
Algorithm Hash digest
SHA256 538b3238ff3dfbb6a502aaf4d33a579a8ffa58769ee7e40fc93c75a369ae2158
MD5 454a34943dbc88061c8dc9fdfe4653e8
BLAKE2b-256 6496af94f71d62ca41d54ba427b36012a2bbc8c507f67aedc5981ce0d59d2547

See more details on using hashes here.

File details

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

File metadata

  • Download URL: GWSkyNet-2.5.0-py3-none-any.whl
  • Upload date:
  • Size: 69.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.7

File hashes

Hashes for GWSkyNet-2.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f8456f46a0fbd6311a58e2895b85c562887320f235e3abb36e47021b812e8910
MD5 fd832964edb6601463392c522fb819c7
BLAKE2b-256 30c6d390b151a75f71892a93d96c9d6850afe6e19ccde82e9310fbd761fc723a

See more details on using hashes here.

Supported by

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