gw-eccentricity


Namegw-eccentricity JSON
Version 1.0.4 PyPI version JSON
download
home_pagehttps://github.com/vijayvarma392/gw_eccentricity
SummaryDefining eccentricity for gravitational wave astronomy.
upload_time2023-10-23 04:41:19
maintainer
docs_urlNone
authorMd Arif Shaikh, Vijay Varma, Harald Pfeiffer
requires_python
license
keywords black-holes gravitational-waves
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <h1> <img src="https://raw.githubusercontent.com/vijayvarma392/gw_eccentricity/main/data/hreal.png"></h1>

<h3 align="center"> Defining eccentricity for gravitational wave astronomy </h4>

<div align="center">

[![github](https://img.shields.io/badge/GitHub-gw_eccentricity-blue.svg)](https://github.com/vijayvarma392/gw_eccentricity)
[![PyPI version](https://badge.fury.io/py/gw_eccentricity.svg?kill_cache=1)](https://pypi.org/project/gw_eccentricity)
[![Conda (channel only)](https://img.shields.io/conda/vn/conda-forge/gw_eccentricity)](https://anaconda.org/conda-forge/gw_eccentricity)
[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/vijayvarma392/gw_eccentricity/blob/main/LICENSE)
[![Build Status](https://github.com/vijayvarma392/gw_eccentricity/actions/workflows/test.yml/badge.svg?kill_cache=1)](https://github.com/vijayvarma392/gw_eccentricity/actions/workflows/test.yml)
[![Documentation Status](https://readthedocs.org/projects/gw-eccentricity/badge/?version=latest)](https://gw-eccentricity.readthedocs.io/en/latest/?badge=latest)

</div>

# About

**gw_eccentricity** provides methods to measure eccentricity and mean anomaly
from gravitational waveforms.

These methods are described in the following paper: <br/>
- [1] Md Arif Shaikh, Vijay Varma, Harald Pfeiffer, Antoni Ramos-Buades and Maarten van de Meent,
"Defining eccentricity for gravitational wave astronomy", (2023). [arXiv:2302.11257](https://arxiv.org/abs/2302.11257)

Please see [Credits](#credits) below for citing this work.
This package lives on [GitHub](https://github.com/vijayvarma392/gw_eccentricity), is compatible with
`python3`, and is tested every week. You can see the current build status of
the main branch at the top of this page.


# Installation

## PyPI
**gw_eccentricity** is available through [PyPI](https://pypi.org/project/gw_eccentricity/):

```shell
pip install gw_eccentricity
```

## Conda
**gw_eccentricity** can be installed using `conda` also:
```shell
conda install -c conda-forge gw_eccentricity
```

## From source

```shell
git clone git@github.com:vijayvarma392/gw_eccentricity.git
cd gw_eccentricity
python setup.py install
```

If you do not have root permissions, replace the last step with
`python setup.py install --user`

## Dependencies

All of these can be installed through pip or conda.
* [numpy](https://docs.scipy.org/doc/numpy/user/install.html)
* [scipy](https://www.scipy.org/install.html)
* [h5py](http://docs.h5py.org/en/latest/build.html)
* [lalsuite](https://pypi.org/project/lalsuite)

# Usage
See the example notebook [here](https://github.com/vijayvarma392/gw_eccentricity/blob/main/examples/gw_eccentricity_demo.ipynb) for a demo.

# Making contributions
See this
[README](https://github.com/vijayvarma392/gw_eccentricity/blob/main/README_developers.md)
for instructions on how to make contributions to this package.

Please report bugs by raising an issue on our
[GitHub](https://github.com/vijayvarma392/gw_eccentricity) repository.

# Credits
The main contributors to this code are [Md Arif Shaikh](https://md-arif-shaikh.github.io/), [Vijay
Varma](https://vijayvarma.com), and [Harald Pfeiffer](https://www.aei.mpg.de/person/54205/2784). You can find the full list of contributors
[here](https://github.com/vijayvarma392/gw_eccentricity/graphs/contributors).

If you find this package useful in your work, please cite reference [1] and
this package. You can use the following bibtex keys:
```BibTeX
@article{Shaikh:2023ypz,
    author = "Shaikh, Md Arif and Varma, Vijay and Pfeiffer, Harald P. and Ramos-Buades, Antoni and van de Meent, Maarten",
    title = "{Defining eccentricity for gravitational wave astronomy}",
    eprint = "2302.11257",
    archivePrefix = "arXiv",
    primaryClass = "gr-qc",
    month = "2",
    year = "2023",
    Note = "{\href{https://pypi.org/project/gw_eccentricity}{pypi.org/project/gw\_eccentricity}}",
}
```

---
Image at the top shows an eccentric gravitational wave signal (SXS:BBH:2558) from [arXiv:2209.03390](https://arxiv.org/abs/2209.03390).

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/vijayvarma392/gw_eccentricity",
    "name": "gw-eccentricity",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "black-holes gravitational-waves",
    "author": "Md Arif Shaikh, Vijay Varma, Harald Pfeiffer",
    "author_email": "arifshaikh.astro@gmail.com, vijay.varma392@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/8c/f3/8a0f248376dc6fa247c1103577175339d0fb4d051207cb8cde22d6852d1a/gw_eccentricity-1.0.4.tar.gz",
    "platform": null,
    "description": "<h1> <img src=\"https://raw.githubusercontent.com/vijayvarma392/gw_eccentricity/main/data/hreal.png\"></h1>\n\n<h3 align=\"center\"> Defining eccentricity for gravitational wave astronomy </h4>\n\n<div align=\"center\">\n\n[![github](https://img.shields.io/badge/GitHub-gw_eccentricity-blue.svg)](https://github.com/vijayvarma392/gw_eccentricity)\n[![PyPI version](https://badge.fury.io/py/gw_eccentricity.svg?kill_cache=1)](https://pypi.org/project/gw_eccentricity)\n[![Conda (channel only)](https://img.shields.io/conda/vn/conda-forge/gw_eccentricity)](https://anaconda.org/conda-forge/gw_eccentricity)\n[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/vijayvarma392/gw_eccentricity/blob/main/LICENSE)\n[![Build Status](https://github.com/vijayvarma392/gw_eccentricity/actions/workflows/test.yml/badge.svg?kill_cache=1)](https://github.com/vijayvarma392/gw_eccentricity/actions/workflows/test.yml)\n[![Documentation Status](https://readthedocs.org/projects/gw-eccentricity/badge/?version=latest)](https://gw-eccentricity.readthedocs.io/en/latest/?badge=latest)\n\n</div>\n\n# About\n\n**gw_eccentricity** provides methods to measure eccentricity and mean anomaly\nfrom gravitational waveforms.\n\nThese methods are described in the following paper: <br/>\n- [1] Md Arif Shaikh, Vijay Varma, Harald Pfeiffer, Antoni Ramos-Buades and Maarten van de Meent,\n\"Defining eccentricity for gravitational wave astronomy\", (2023). [arXiv:2302.11257](https://arxiv.org/abs/2302.11257)\n\nPlease see [Credits](#credits) below for citing this work.\nThis package lives on [GitHub](https://github.com/vijayvarma392/gw_eccentricity), is compatible with\n`python3`, and is tested every week. You can see the current build status of\nthe main branch at the top of this page.\n\n\n# Installation\n\n## PyPI\n**gw_eccentricity** is available through [PyPI](https://pypi.org/project/gw_eccentricity/):\n\n```shell\npip install gw_eccentricity\n```\n\n## Conda\n**gw_eccentricity** can be installed using `conda` also:\n```shell\nconda install -c conda-forge gw_eccentricity\n```\n\n## From source\n\n```shell\ngit clone git@github.com:vijayvarma392/gw_eccentricity.git\ncd gw_eccentricity\npython setup.py install\n```\n\nIf you do not have root permissions, replace the last step with\n`python setup.py install --user`\n\n## Dependencies\n\nAll of these can be installed through pip or conda.\n* [numpy](https://docs.scipy.org/doc/numpy/user/install.html)\n* [scipy](https://www.scipy.org/install.html)\n* [h5py](http://docs.h5py.org/en/latest/build.html)\n* [lalsuite](https://pypi.org/project/lalsuite)\n\n# Usage\nSee the example notebook [here](https://github.com/vijayvarma392/gw_eccentricity/blob/main/examples/gw_eccentricity_demo.ipynb) for a demo.\n\n# Making contributions\nSee this\n[README](https://github.com/vijayvarma392/gw_eccentricity/blob/main/README_developers.md)\nfor instructions on how to make contributions to this package.\n\nPlease report bugs by raising an issue on our\n[GitHub](https://github.com/vijayvarma392/gw_eccentricity) repository.\n\n# Credits\nThe main contributors to this code are [Md Arif Shaikh](https://md-arif-shaikh.github.io/), [Vijay\nVarma](https://vijayvarma.com), and [Harald Pfeiffer](https://www.aei.mpg.de/person/54205/2784). You can find the full list of contributors\n[here](https://github.com/vijayvarma392/gw_eccentricity/graphs/contributors).\n\nIf you find this package useful in your work, please cite reference [1] and\nthis package. You can use the following bibtex keys:\n```BibTeX\n@article{Shaikh:2023ypz,\n    author = \"Shaikh, Md Arif and Varma, Vijay and Pfeiffer, Harald P. and Ramos-Buades, Antoni and van de Meent, Maarten\",\n    title = \"{Defining eccentricity for gravitational wave astronomy}\",\n    eprint = \"2302.11257\",\n    archivePrefix = \"arXiv\",\n    primaryClass = \"gr-qc\",\n    month = \"2\",\n    year = \"2023\",\n    Note = \"{\\href{https://pypi.org/project/gw_eccentricity}{pypi.org/project/gw\\_eccentricity}}\",\n}\n```\n\n---\nImage at the top shows an eccentric gravitational wave signal (SXS:BBH:2558) from [arXiv:2209.03390](https://arxiv.org/abs/2209.03390).\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "Defining eccentricity for gravitational wave astronomy.",
    "version": "1.0.4",
    "project_urls": {
        "Homepage": "https://github.com/vijayvarma392/gw_eccentricity"
    },
    "split_keywords": [
        "black-holes",
        "gravitational-waves"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "92e85a1a465b5c231d9d90b8644ab062709d014a382211b218afe8d6d7e21946",
                "md5": "9f538ed0b0ada861fc6426cd0ede05d9",
                "sha256": "4a9c3e67d035f233e6281b3088ec060e70aaf45fb8407ca429ca34d18ff6333b"
            },
            "downloads": -1,
            "filename": "gw_eccentricity-1.0.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "9f538ed0b0ada861fc6426cd0ede05d9",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 84620,
            "upload_time": "2023-10-23T04:41:18",
            "upload_time_iso_8601": "2023-10-23T04:41:18.226376Z",
            "url": "https://files.pythonhosted.org/packages/92/e8/5a1a465b5c231d9d90b8644ab062709d014a382211b218afe8d6d7e21946/gw_eccentricity-1.0.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "8cf38a0f248376dc6fa247c1103577175339d0fb4d051207cb8cde22d6852d1a",
                "md5": "d2be6facb0646b54001d4f196704efe1",
                "sha256": "61ca038be8b0a4bb98bdd86d0930d4d8e862b1d7232baa26990c684fbed0095c"
            },
            "downloads": -1,
            "filename": "gw_eccentricity-1.0.4.tar.gz",
            "has_sig": false,
            "md5_digest": "d2be6facb0646b54001d4f196704efe1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 85469,
            "upload_time": "2023-10-23T04:41:19",
            "upload_time_iso_8601": "2023-10-23T04:41:19.977737Z",
            "url": "https://files.pythonhosted.org/packages/8c/f3/8a0f248376dc6fa247c1103577175339d0fb4d051207cb8cde22d6852d1a/gw_eccentricity-1.0.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-10-23 04:41:19",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "vijayvarma392",
    "github_project": "gw_eccentricity",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "gw-eccentricity"
}
        
Elapsed time: 0.12697s