|
1 |
| -|build_status|_ |Coveralls|_ |docs|_ |pypi_version|_ |black|_ |doi|_ |
| 1 | +diffsims is an open-source Python library for simulating diffraction. |
| 2 | + |
| 3 | +The package is released under the GPL v3 license. |
| 4 | + |
| 5 | +.. |pypi_version| image:: https://img.shields.io/pypi/v/diffsims.svg?style=flat |
| 6 | + :target: https://pypi.python.org/pypi/diffsims |
| 7 | + |
| 8 | +.. |conda| image:: https://img.shields.io/conda/vn/conda-forge/diffsims.svg?logo=conda-forge&logoColor=white |
| 9 | + :target: https://anaconda.org/conda-forge/diffsims |
2 | 10 |
|
3 | 11 | .. |build_status| image:: https://github.com/pyxem/diffsims/workflows/build/badge.svg
|
4 |
| -.. _build_status: https://github.com/pyxem/diffsims/actions |
| 12 | + :target: https://github.com/pyxem/diffsims/actions/workflows/build.yml |
5 | 13 |
|
6 |
| -.. |Coveralls| image:: https://coveralls.io/repos/github/pyxem/diffsims/badge.svg?branch=master |
7 |
| -.. _Coveralls: https://coveralls.io/github/pyxem/diffsims?branch=master |
| 14 | +.. |python| image:: https://img.shields.io/badge/python-3.8+-blue.svg |
| 15 | + :target: https://www.python.org/downloads/ |
8 | 16 |
|
9 |
| -.. |docs| image:: https://readthedocs.org/projects/diffsims/badge/?version=latest |
10 |
| -.. _docs: https://diffsims.readthedocs.io/en/latest |
| 17 | +.. |Coveralls| image:: https://coveralls.io/repos/github/pyxem/diffsims/badge.svg?branch=main |
| 18 | + :target: https://coveralls.io/github/pyxem/diffsims?branch=main |
11 | 19 |
|
12 |
| -.. |pypi_version| image:: https://img.shields.io/pypi/v/diffsims.svg?style=flat |
13 |
| -.. _pypi_version: https://pypi.org/project/diffsims/ |
| 20 | +.. |pypi_downloads| image:: https://img.shields.io/pypi/dm/diffsims.svg?label=PyPI%20downloads |
| 21 | + :target: https://pypi.org/project/diffsims/ |
14 | 22 |
|
15 |
| -.. |black| image:: https://img.shields.io/badge/code%20style-black-000000.svg |
16 |
| -.. _black: https://github.com/psf/black |
| 23 | +.. |conda_downloads| image:: https://img.shields.io/conda/dn/conda-forge/diffsims.svg?label=Conda%20downloads |
| 24 | + :target: https://anaconda.org/conda-forge/diffsims |
17 | 25 |
|
18 | 26 | .. |doi| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.3337900.svg
|
19 |
| -.. _doi: https://doi.org/10.5281/zenodo.3337900 |
| 27 | + :target: https://doi.org/10.5281/zenodo.3337900 |
20 | 28 |
|
21 |
| -diffsims is an open-source Python library for simulating diffraction. |
| 29 | +.. |GPLv3| image:: https://img.shields.io/github/license/pyxem/diffsims |
| 30 | + :target: https://opensource.org/license/GPL-3.0 |
22 | 31 |
|
23 |
| -If simulations performed using diffsims form a part of published work please |
24 |
| -cite the DOI at the top of this page. You can find demos in the `diffsims-demos |
25 |
| -<https://github.com/pyxem/diffsims-demos>`_ repository. See the `documentation |
26 |
| -<https://diffsims.readthedocs.io/en/latest/>`_ for installation instructions, the API |
27 |
| -reference, the changelog and more. |
| 32 | +.. |GH-issues| image:: https://img.shields.io/badge/GitHub-Issues-green?logo=github |
| 33 | + :target: https://github.com/pyxem/diffsims/issues |
| 34 | + |
| 35 | +.. |docs| image:: https://readthedocs.org/projects/diffsims/badge/?version=latest |
| 36 | + :target: https://diffsims.readthedocs.io/en/latest |
| 37 | + |
| 38 | +.. |black| image:: https://img.shields.io/badge/code%20style-black-000000.svg |
| 39 | + :target: https://github.com/psf/black |
| 40 | + |
| 41 | ++----------------------+------------------------------------------------+ |
| 42 | +| Deployment | |pypi_version| |conda| | |
| 43 | ++----------------------+------------------------------------------------+ |
| 44 | +| Build status | |build_status| |docs| |python| | |
| 45 | ++----------------------+------------------------------------------------+ |
| 46 | +| Metrics | |Coveralls| | |
| 47 | ++----------------------+------------------------------------------------+ |
| 48 | +| Activity | |pypi_downloads| |conda_downloads| | |
| 49 | ++----------------------+------------------------------------------------+ |
| 50 | +| Citation | |doi| | |
| 51 | ++----------------------+------------------------------------------------+ |
| 52 | +| License | |GPLv3| | |
| 53 | ++----------------------+------------------------------------------------+ |
| 54 | +| Community | |GH-issues| | |
| 55 | ++----------------------+------------------------------------------------+ |
| 56 | +| Formatter | |black| | |
| 57 | ++----------------------+------------------------------------------------+ |
| 58 | + |
| 59 | +Documentation |
| 60 | +------------- |
| 61 | + |
| 62 | +Refer to the `documentation <https://diffsims.readthedocs.io>`__ for detailed |
| 63 | +installation instructions, a user guide, a technical (API) reference, and the `changelog |
| 64 | +<https://diffsims.readthedocs.io/en/latest/changelog.html>`_. |
| 65 | + |
| 66 | +Installation |
| 67 | +------------ |
| 68 | + |
| 69 | +diffsims can be installed with ``pip``:: |
| 70 | + |
| 71 | + pip install diffsims |
28 | 72 |
|
29 |
| -diffsims is released under the GPL v3 license. |
| 73 | +or ``conda``:: |
| 74 | + |
| 75 | + conda install diffsims -c conda-forge |
| 76 | + |
| 77 | +The source code is hosted in `GitHub <https://github.com/pyxem/diffsims>`_, and can also |
| 78 | +be downloaded from `PyPI <https://pypi.org/project/diffsims>`_ and |
| 79 | +`Anaconda <https://anaconda.org/conda-forge/diffsims>`_. |
| 80 | + |
| 81 | +Further details are available in the |
| 82 | +`installation guide |
| 83 | +<https://diffsims.readthedocs.io/en/latest/user/installation.html>`_. |
| 84 | + |
| 85 | +Citing diffsims |
| 86 | +--------------- |
| 87 | + |
| 88 | +If simulations performed using diffsims form a part of published work please |
| 89 | +cite the DOI at the top of this page. |
0 commit comments