Skip to main content

Welcome to gwcosmo

Gwcosmo: a package to estimate cosmological parameters using gravitational-wave observations.

Installation

The recommended method for installing gwcosmo is using pip. We recommend setting up a virtual environment first. Once you have done this and activated your virtual environment, simply run

pip install gwcosmo

Note that gwcosmo requires Python version 3.8 or higher.

Documentation

Gwcosmo's documentation is available at https://lscsoft.docs.ligo.org/gwcosmo/.

Citing gwcosmo

If you use gwcosmo in a scientific publication, please cite the following publications, and include the following statement in your manuscript: "This work makes use of gwcosmo which is available at https://git.ligo.org/lscsoft/gwcosmo".

@article{Gray:2023wgj,
    author = "Gray, Rachel and Beirnaert, Freija and Karathanasis, Christos and Revenu, Beno{\^\i}t and Turski, Cezary and Chen, Anson and Baker, Tessa and Vallejo, Sergio and Enea Romano, Antonio and Ghosh, Tathagata and Ghosh, Archisman and Leyde, Konstantin and Mastrogiovanni, Simone and More, Surhud",
    title = "{Joint cosmological and gravitational-wave population inference using dark sirens and galaxy catalogues}",
    eprint = "2308.02281",
    archivePrefix = "arXiv",
    primaryClass = "astro-ph.CO",
    doi = "10.1088/1475-7516/2023/12/023",
    journal = "JCAP",
    volume = "12",
    pages = "023",
    year = "2023"
}

@article{Gray:2021sew,
    author = "Gray, Rachel and Messenger, Chris and Veitch, John",
    title = "{A pixelated approach to galaxy catalogue incompleteness: improving the dark siren measurement of the Hubble constant}",
    eprint = "2111.04629",
    archivePrefix = "arXiv",
    primaryClass = "astro-ph.CO",
    doi = "10.1093/mnras/stac366",
    journal = "Mon. Not. Roy. Astron. Soc.",
    volume = "512",
    number = "1",
    pages = "1127--1140",
    year = "2022"
}

@article{Gray:2019ksv,
    author = "Gray, Rachel and Hernandez, Ignacio Maga{\~n}a and Qi, Hong and Sur, Ankan and Brady, Patrick R. and Chen, Hsin-Yu and Farr, Will M. and Fishbach, Maya and Gair, Jonathan R. and Ghosh, Archisman and Holz, Daniel E. and Mastrogiovanni, Simone and Messenger, Christopher and Steer, Dani{\`e}le A. and Veitch, John",
    title = "{Cosmological inference using gravitational wave standard sirens: A mock data analysis}",
    eprint = "1908.06050",
    archivePrefix = "arXiv",
    primaryClass = "gr-qc",
    reportNumber = "LIGO-P1900017",
    doi = "10.1103/PhysRevD.101.122001",
    journal = "Phys. Rev. D",
    volume = "101",
    number = "12",
    pages = "122001",
    year = "2020"
}

If you make use of the pipeline with a GPU, please additionally cite

@article{Papadopoulos:2026puy,
    author = "Papadopoulos, Alexander and Chapman-Bird, Christian E. A. and Gray, Rachel and Messenger, Christopher and Bertheas, Tom",
    title = "{Scalable dark siren cosmology with gwcosmo: GPU acceleration, validation, and systematics}",
    eprint = "2605.23538",
    archivePrefix = "arXiv",
    primaryClass = "astro-ph.CO",
    doi = "10.1103/53c5-mtk5",
    journal = "Phys. Rev. D",
    volume = "114",
    number = "6",
    pages = "063528",
    year = "2026"
}

Metadata

Release files for gwcosmo 3.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gwcosmo 3.2.0
File Size Uploaded Provenance Actions
gwcosmo-3.2.0.tar.gz 14.0 MB Without provenance Details for gwcosmo-3.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for gwcosmo 3.2.0
File Interpreter ABI Platform Actions
gwcosmo-3.2.0-py3-none-any.whl Python 3 none any Details for gwcosmo-3.2.0-py3-none-any.whl

Total release size: 18.7 MB

Release files / gwcosmo-3.2.0.tar.gz

Download URL gwcosmo-3.2.0.tar.gz
Size 14.0 MB
Tags Source
SHA-256 checksum
How to use checksums
174373841e895c9b558011f46b4b4a6930dabaf4ebcf303f291e31fc1cc68192
BLAKE2b-256 checksum
How to use checksums
cd48a97b74aedac01f337474942cbefc7f613cdf0c4e0eb8959cfa10e4ff9e2f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.12

Release files / gwcosmo-3.2.0-py3-none-any.whl

Download URL gwcosmo-3.2.0-py3-none-any.whl
Size 4.7 MB
Tags Python 3
SHA-256 checksum
How to use checksums
0635421868032022cb8f32393dc44dbd966d8b9e0224cf1af2f41c3795099f6e
BLAKE2b-256 checksum
How to use checksums
76e41a47b9854611af43cc65d9a29368081d2d37d0eb30340b7de5837d275554
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.12

Security for gwcosmo 3.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page