CWInPy documentation#
CWInPy is a Python package designed to perform searches for, and inference on, continuous quasi-monochromatic gravitational-wave signals. In particular, signals that might be emitted by non-axisymmetric and rapidly rotating neutron stars, such as pulsars. CWInPy stands for “Continuous (gravitational) Wave Inference in Python”.
The package provides tools for processing raw gravitational-wave strain time-series data based on
the phase evolution of a given source (using a Tempo-style parameter file); a class to store and
display this data is available. Following data processing, the package provides tools for inferring
the unknown gravitational-wave parameters describing the source and its orientation. An integrated
pipeline combining both these stages (cwinpy_knope
) is also provided. These tools are all
available through command line executables and through a Python API. The pipelines can generate
HTCondor DAGs to run analyses
over long observing runs for multiple detectors and multiple sources on a computer cluster or via
the Open Science Grid. The pipelines can be used on both open data (as hosted by the
Gravitational-wave Open Science Center) and proprietary
data from the LIGO and Virgo detectors.
In addition to these main functions, CWInPy enables users to:
simulate processed signals from individual sources or populations of sources;
perform hierarchical inference on the underlying ellipticity/mass quadrupole distribution for multiple sources.
Quick links#
To help get started some useful links are:
Contributing#
CWInPy is open source and anyone is welcome to contribute. The development repository of CWInPy is publicly available at git.ligo.org/cwinpy/cwinpy and is mirrored on Github. Issues, discussions or pull requests can be opened in that Github repository, or can be emailed directly to contact+cwinpy-cwinpy-3315-issue-@support.ligo.org.
Code of conduct#
Contributors to CWInPy and users of any of the discussion forums are expected to treat each other with respect and abide by the guidelines of the Python Community Code of Conduct.
Citing CWInPy#
If you use CWInPy for research that leads to a publication, I would be grateful if you cited the CWInPy paper in the Journal of Open Source Software:
Pitkin, M., (2022). CWInPy: A Python package for inference with continuous gravitational-wave signals from pulsars. Journal of Open Source Software, 7(77), 4568, https://doi.org/10.21105/joss.04568
@article{cwinpy,
title = "{CWInPy: A Python package for inference with continuous gravitational-wave signals from pulsars}",
author = {{Pitkin}, M.},
journal = {Journal of Open Source Software},
volume = 7,
number = 77,
pages = 4568,
year = 2022,
doi = {10.21105/joss.04568},
url = {https://doi.org/10.21105/joss.04568},
}
TY - JOUR
T1 - CWInPy: A Python package for inference with continuous gravitational-wave signals from pulsars
AU - Pitkin, Matthew
JO - Journal of Open Source Software
VL - 7
IS - 77
SP - 4568
PY - 2022
DA - 2022/09/29/
DO - 10.21105/joss.04568
UR - https://doi.org/10.21105/joss.04568
ER -
%0 Journal Article
%T CWInPy: A Python package for inference with continuous gravitational-wave signals from pulsars
%A Pitkin, Matthew
%J Journal of Open Source Software
%V 7
%N 77
%P 4568
%D 2022
%R 10.21105/joss.04568
RT Journal
T1 CWInPy: A Python package for inference with continuous gravitational-wave signals from pulsars
A1 Pitkin, Matthew
JF Journal of Open Source Software
VO 7
SP 4568
YR 2022
DO DOI: 10.21105/joss.04568