{ "info": { "author": "Davide Gerosa", "author_email": "d.gerosa@damtp.cam.ac.uk", "bugtrack_url": null, "classifiers": [ "Intended Audience :: Science/Research", "Programming Language :: Python :: 2.7", "Topic :: Scientific/Engineering :: Astronomy", "Topic :: Scientific/Engineering :: Mathematics", "Topic :: Scientific/Engineering :: Physics", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "precession\n==========\n\n**Author** Davide Gerosa\n\n**email** dgerosa@caltech.edu\n\n**Copyright** Copyright (C) 2016 Davide Gerosa\n\n**Licence** CC BY 4.0\n\n**Version** 1.0.3\n\nDYNAMICS OF SPINNING BLACK-HOLE BINARIES WITH PYTHON\n====================================================\n\n``precession`` is an open-source Python module to study the dynamics of\nprecessing black-hole binaries in the post-Newtonian regime. The code\nprovides a comprehensive toolbox to (i) study the evolution of the\nblack-hole spins along their precession cycles, (ii) perform\ngravitational-wave driven binary inspirals using both orbit-averaged and\nprecession-averaged integrations, and (iii) predict the properties of\nthe merger remnant through fitting formulae obtained from numerical\nrelativity simulations. ``precession`` is a ready-to-use tool to add the\nblack-hole spin dynamics to larger-scale numerical studies such as\ngravitational-wave parameter estimation codes, population synthesis\nmodels to predict gravitational-wave event rates, galaxy merger trees\nand cosmological simulations of structure formation. ``precession``\nprovides fast and reliable integration methods to propagate statistical\nsamples of black-hole binaries from/to large separations where they form\nto/from small separations where they become detectable, thus linking\ngravitational-wave observations of spinning black-hole binaries to their\nastrophysical formation history. The code is also a useful tool to\ncompute initial parameters for numerical relativity simulations\ntargeting specific precessing systems.\n\nThis code is released to the community under the `Creative Commons\nAttribution International\nlicense `__. Essentially,\nyou may use ``precession`` as you like but must make reference to our\nwork. When using ``precession`` in any published work, please cite the\npaper describing its implementation:\n\n- *PRECESSION: Dynamics of spinning black-hole binaries with python.*\n D. Gerosa, M. Kesden. PRD 93 (2016)\n `124066 `__.\n `arXiv:1605.01067 `__\n\n``precession`` is an open-source code distributed under git\nversion-control system on\n\n- `github.com/dgerosa/precession `__\n\nAPI documentation can be generated automatically in html format from the\ncode docstrings using ``pdoc``, and is uplodad to a dedicated branch of\nthe git repository\n\n- `dgerosa.github.io/precession `__\n\nFurther information and scientific results are available at:\n\n- `www.tapir.caltech.edu/~dgerosa/precession `__\n- `www.davidegerosa.com/precession `__\n\nINSTALLATION\n------------\n\n``precession`` works in python 2.x and has been tested on 2.7.10. It can\nbe installed through `pip `__:\n\n::\n\n pip install precession\n\nPrerequisites are ``numpy``, ``scipy`` and ``parmap``, which can be all\ninstalled through pip. Information on all code functions are available\nthrough Pyhton's built-in help system\n\n::\n\n import precession\n help(precession.function)\n\nSeveral tests and tutorial are available in the submodule\n``precession.test``. A detailed description of the functionalies of the\ncode is provided in the scientific paper\n`arXiv:1605.01067 `__, where examples\nare also presented.\n\nRESULTS\n-------\n\n``precession`` has been used in the following published papers:\n\n- Gerosa and Sesana. MNRAS 446 (2015) 38-55.\n `arXiv:1405.2072 `__\n- Kesden et al. PRL 114 (2015) 081103.\n `arXiv:1411.0674 `__\n- Gerosa et al. MNRAS 451 (2015) 3941-3954.\n `arXiv:1503.06807 `__\n- Gerosa et al. PRD 92 (2015) 064016.\n `arXiv:1506.03492 `__\n- Gerosa et al. PRL 115 (2015) 141102.\n `arXiv:1506.09116 `__\n- Trifiro' et al. PRD 93 (2016) 044071.\n `arXiv:1507.05587 `__\n- Gerosa and Kesden. PRD 93 (2016) 124066.\n `arXiv:1605.01067 `__\n- Gerosa and Moore. PRL 117 (2016) 011101.\n `arXiv:1606.04226 `__\n- Rodriguez et al. APJL 832 (2016) L2\n `arXiv:1609.05916 `__\n- Gerosa et al. CQG 34 (2017) 6, 064004\n `arXiv:1612.05263 `__\n- Gerosa and Berti. PRD 95 (2017) 124046.\n `arXiv:1703.06223 `__\n- Zhao et al. PRD 96 (2017) 024007.\n `arXiv:1705.02369 `__\n- Wysocki et al. PRD 97 (2018) 043014\n `arXiv:1709.01943 `__\n- Gerosa J.Phys.Conf.Ser. 957 (2018) 012014.\n `arXiv:1711.1003 `__\n- Rodriguez et al. PRL 120 (2018) 151101.\n `arXiv:1712.0493 `__\n- Gerosa et al. PRD 97 (2018) 104049.\n `arXiv:1802.04276 `__\n- Gerosa et al. PRD 98 (2018) 084036.\n `arXiv:1808.02491 `__\n- Varma et al. `arXiv:1809.09125 `__\n- Tso et al. `arXiv:1807.00075 `__\n\nRELEASES\n--------\n\n|DOI|\n\n*v1.0.0* Stable version released together with the first arxiv\nsubmission of `arXiv:1605.01067 `__.\n\n*v1.0.2* Clarifications on typos in Eq. (36) and (37) of\n`arXiv:1605.01067 `__. See\nhelp(precession) for more information.\n\n*v1.0.3* Python 3 now supported (hurray!). By default, ``finalspin`` now\nreturns more updated result by Hofmann, Barausse and Rezzolla 2016.\n\nCREDITS\n-------\n\nThe code is developed and maintained by `Davide\nGerosa `__. Please, report bugs to\n\n::\n\n dgerosa@caltech.edu\n\nI am happy to help you out!\n\n**Thanks**: M. Kesden, U. Sperhake, E. Berti, R. O'Shaughnessy, A.\nSesana, D. Trifiro', A. Klein, J. Vosmera and X. Zhao.\n\n.. |DOI| image:: https://zenodo.org/badge/46057982.svg\n :target: https://zenodo.org/badge/latestdoi/46057982\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/dgerosa/precession/", "keywords": "black hole spin inspiral precession post-Newtonian", "license": "CC by 4.0", "maintainer": "", "maintainer_email": "", "name": "precession", "package_url": "https://pypi.org/project/precession/", "platform": "", "project_url": "https://pypi.org/project/precession/", "project_urls": { "Homepage": "https://github.com/dgerosa/precession/" }, "release_url": "https://pypi.org/project/precession/1.0.3/", "requires_dist": null, "requires_python": "", "summary": "Dynamics of precessing black-hole binaries", "version": "1.0.3" }, "last_serial": 4459198, "releases": { "0.0.0.50": [ { "comment_text": "", "digests": { "md5": "ea667790ef8f572f8c7e6b5bdb9b775b", "sha256": "e44e8bbbd8e19ca3c98fd559badb49fdb6e5541ff25ab6b6b87d64aaadfe7b03" }, "downloads": -1, "filename": "precession-0.0.0.50.tar.gz", "has_sig": false, "md5_digest": "ea667790ef8f572f8c7e6b5bdb9b775b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 44328, "upload_time": "2016-04-12T16:09:03", "url": "https://files.pythonhosted.org/packages/46/22/ba8802a45494291ca6bd32159a7fbc0e4302e192d31cfafaf31bb19f275b/precession-0.0.0.50.tar.gz" } ], "0.9.1": [ { "comment_text": "", "digests": { "md5": "577419cdddbb29aca91d3ebbf58dc4e4", "sha256": "ce72e91f66b1b4d4aefd5348132aa88d30b779abcb2e9ca77023493108940e13" }, "downloads": -1, "filename": "precession-0.9.1.tar.gz", "has_sig": false, "md5_digest": "577419cdddbb29aca91d3ebbf58dc4e4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 45064, "upload_time": "2016-04-25T09:47:37", "url": "https://files.pythonhosted.org/packages/55/4c/bb8f1084a55c1c34889b7df71a3eb60a8c008f6101db347ecff1bdcb6179/precession-0.9.1.tar.gz" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "6efc72205bb8a50f2f4e24565f82975f", "sha256": "0dd89720cf12928234d97cb9444effc9d254df06eb328b75dfcdf0ded25e0fce" }, "downloads": -1, "filename": "precession-1.0.0.tar.gz", "has_sig": false, "md5_digest": "6efc72205bb8a50f2f4e24565f82975f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 45124, "upload_time": "2016-05-05T09:46:20", "url": "https://files.pythonhosted.org/packages/d0/8e/0c92012b4d6ac8c38876e185c2b66255eab4d5e5f081d3caa78a9a47663f/precession-1.0.0.tar.gz" } ], "1.0.1": [ { "comment_text": "", "digests": { "md5": "e39854e7f61ce1314b00dbae1441dd15", "sha256": "bd3d29c8fa14d74b7c88c17084fe9265a30bdd7b45b9560827bb68beb1bfdf83" }, "downloads": -1, "filename": "precession-1.0.1.tar.gz", "has_sig": false, "md5_digest": "e39854e7f61ce1314b00dbae1441dd15", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 45301, "upload_time": "2017-09-21T16:54:12", "url": "https://files.pythonhosted.org/packages/35/f8/0a21b865f9df3de5355b42dd626012686f0b590d553f494615e0ad9fb980/precession-1.0.1.tar.gz" } ], "1.0.2": [ { "comment_text": "", "digests": { "md5": "1bb8bb15a6bbf1b24140e9b51e6550fe", "sha256": "6b78f449550f00c4b1ccbbcb9a490feffc768cd3ffeb2b6b1a4e251cbc86caef" }, "downloads": -1, "filename": "precession-1.0.2.tar.gz", "has_sig": false, "md5_digest": "1bb8bb15a6bbf1b24140e9b51e6550fe", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 45719, "upload_time": "2017-11-09T22:17:09", "url": "https://files.pythonhosted.org/packages/77/b4/ea05dad9ff46917252b277a6c369ae75c708d4f53bdaff1f704b7e176681/precession-1.0.2.tar.gz" } ], "1.0.3": [ { "comment_text": "", "digests": { "md5": "9d4321371dc13a11f18032f01b41d2be", "sha256": "792bf8e3441c4ea012b91d278eca00bb134bcb94a601716491884935648d7bec" }, "downloads": -1, "filename": "precession-1.0.3.tar.gz", "has_sig": false, "md5_digest": "9d4321371dc13a11f18032f01b41d2be", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 45249, "upload_time": "2018-11-06T22:38:40", "url": "https://files.pythonhosted.org/packages/3e/91/d9fe695ea0ce9740e318ef78bf2d2402e5996e42cc0be19b9de5730b1281/precession-1.0.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "9d4321371dc13a11f18032f01b41d2be", "sha256": "792bf8e3441c4ea012b91d278eca00bb134bcb94a601716491884935648d7bec" }, "downloads": -1, "filename": "precession-1.0.3.tar.gz", "has_sig": false, "md5_digest": "9d4321371dc13a11f18032f01b41d2be", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 45249, "upload_time": "2018-11-06T22:38:40", "url": "https://files.pythonhosted.org/packages/3e/91/d9fe695ea0ce9740e318ef78bf2d2402e5996e42cc0be19b9de5730b1281/precession-1.0.3.tar.gz" } ] }