Metadata-Version: 2.4
Name: gwcosmo
Version: 3.2.1
Summary: A package to estimate cosmological parameters using gravitational-wave observations
Author-email: Rachel Gray <rachel.gray@ligo.org>
Project-URL: Homepage, https://git.ligo.org/lscsoft/gwcosmo
Project-URL: Documentation, https://lscsoft.docs.ligo.org/gwcosmo/
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: astropy
Requires-Dist: bilby
Requires-Dist: h5py
Requires-Dist: healpy==1.17.3
Requires-Dist: lalsuite
Requires-Dist: ligo-gracedb
Requires-Dist: ligo-segments
Requires-Dist: ligo.skymap<=1.0.7
Requires-Dist: lscsoft-glue
Requires-Dist: matplotlib>=2.0
Requires-Dist: multiprocess
Requires-Dist: numba>=0.60
Requires-Dist: numpy>=2.0.0
Requires-Dist: pandas
Requires-Dist: pesummary
Requires-Dist: progressbar
Requires-Dist: scipy==1.13.1
Requires-Dist: seaborn
Requires-Dist: selfeeg>=0.2.1
Requires-Dist: torch>=2.0
Requires-Dist: tqdm
Requires-Dist: nessai==0.14.0
Dynamic: license-file

# 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/](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".

```bibtex
@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

```bibtex
@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"
}

```

