| Name: | EinsteinPy |
|---|---|
| Website: | https://einsteinpy.org/ |
| Version: | 0.2.dev0 |
EinsteinPy is an open source pure Python package dedicated to problems arising in General Relativity and relativistic physics, such as goedesics calculation for vacuum solutions for Einstein's field equations, calculation of various quantities in these geometries like Schwarzschild Radius and event horizon. The library also has functions for Symbolic calculations in GR like Christoffel Symbols and much more is planned. The library aims to solve Einstein's field equations for arbitarily complicated matter distribution as one of the main goals. It is released under the MIT license.
Complete documentation, including a user guide and an API reference, can be read on the wonderful Read the Docs.
In the examples directory you can find several Jupyter notebooks with specific applications of einsteinpy. You can consider theses Jupyter Notebooks as tutorials for einsteinpy. You can launch a cloud Jupyter server using binder to edit the notebooks without installing anything. Try it out!
https://beta.mybinder.org/v2/gh/einsteinpy/einsteinpy/master?filepath=index.ipynb
EinsteinPy requires the following Python packages:
- NumPy, for basic numerical routines
- Astropy, for physical units and time handling
- numba (optional), for accelerating the code
- matplotlib, for geodesics plotting and visualisations.
- SciPy, for solving ordinary differential equations.
- SymPy (optional), for symbolic calculations related to GR.
EinstienPy is usually tested on Linux, Windows and OS X on Python 3.5, 3.6 and 3.7 against latest NumPy.
| Platform | Site | Status |
|---|---|---|
| Linux | CircleCI | |
| OS X | Travis CI | |
| Windows x64 | Appveyor | |
The easiest and fastest way to get the package up and running is to install EinsteinPy using conda:
$ conda install einsteinpy --channel conda-forge
Please check out the guide for alternative installation methods.
If installed correctly, the tests can be run using pytest:
$ python -c "import einsteinpy.testing; einsteinpy.testing.test()" ============================= test session starts ============================== platform linux -- Python 3.7.1, pytest-4.3.1, py-1.8.0, pluggy-0.9.0 rootdir: /home/shreyas/Local Forks/einsteinpy, inifile: setup.cfg plugins: remotedata-0.3.1, openfiles-0.3.1, doctestplus-0.3.0, cov-2.5.1, arraydiff-0.3 collected 56 items [...] ==================== 56 passed, 1 warnings in 28.19 seconds ==================== $
If the installation fails or you find something that doesn't work as expected, please open an issue in the issue tracker.
EinsteinPy is a community project, hence all contributions are more than welcome! For more information, head to CONTRIBUTING.rst.
Release announcements and general discussion take place on our mailing list. Feel free to join!
https://groups.io/g/einsteinpy-dev
Please join our [matrix] channel or gitter chat room for further queries.
If you use EinsteinPy on your project, please drop us a line.
You can also use the DOI to cite it in your publications. This is the latest one:
And this is an example citation format:
Shreyas Bapat et al.. (2019). EinsteinPy: einsteinpy 0.1.0. Zenodo. 10.5281/zenodo.2582388
EinsteinPy is released under the MIT license, hence allowing commercial use of the library. Please refer to COPYING.
EinsteinPy comes from the name of the famous physicist, nobel laureate, revolutionary person, Prof. Albert Einstein. This is a small tribute from our part for the amazing work he did for the science.
EinsteinPy is focused on general relativity. One can always discuss probable features on the mailing list and try to implement it. We welcome every contribution and will be happy to include it in EinsteinPy.
EinsteinPy is actively maintained and we hope to receive an influx of new contributors. The best way to get an idea of the roadmap is to see the Milestones of the project.
The whole documentation, and code structure is shamelessly inspired by poliastro . We really thank the developers to help us acheive this.