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.1

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.1
File Size Uploaded Provenance Actions
gwcosmo-3.2.1.tar.gz 14.0 MB Without provenance Details for gwcosmo-3.2.1.tar.gz

Built distribution (wheel)

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

Total release size: 18.7 MB

Release files / gwcosmo-3.2.1.tar.gz

Download URL gwcosmo-3.2.1.tar.gz
Size 14.0 MB
Tags Source
SHA-256 checksum
How to use checksums
4cd4097c22363c340ba33a88beb523152e2b7209521d391b9f2741038c06f20a
BLAKE2b-256 checksum
How to use checksums
ade664df37dfb9614d96299cc2f21942cee7f16ae36f748564036d4c2eadbf3a
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.1-py3-none-any.whl

Download URL gwcosmo-3.2.1-py3-none-any.whl
Size 4.7 MB
Tags Python 3
SHA-256 checksum
How to use checksums
21ec54bd3829d2705baa183b8233f58c2d2b9a5bb18a5b0ef98b59b5fd337d9b
BLAKE2b-256 checksum
How to use checksums
f80bde0d6115be20e3960978f645fa4ebda519f0407454d9fad7f8c8be83c0f7
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.1

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