Skip to content

Commit c15f2e3

Browse files
committed
Updated the README with the Zenodo DOI badge and citing info. I also made some other changes to the PyBILT and pybilt name in the text.
1 parent a077421 commit c15f2e3

2 files changed

Lines changed: 20 additions & 18 deletions

File tree

README.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@
88
[![release](https://img.shields.io/github/release-pre/LoLab-VU/PyBILT.svg)](https://github.com/LoLab-VU/PyBILT/releases/tag/v0.2.0)
99
[![Anaconda-Server Badge](https://anaconda.org/blakeaw/pybilt/badges/version.svg)](https://anaconda.org/blakeaw/pybilt)
1010
[![Documentation Status](https://readthedocs.org/projects/pybilt/badge/?version=latest)](http://pybilt.readthedocs.io/en/latest/?badge=latest)
11+
[![DOI](https://zenodo.org/badge/85123567.svg)](https://zenodo.org/badge/latestdoi/85123567)
1112

1213
------
1314
#### PyBILT is a Python toolkit developed to analyze molecular simulation trajectories of lipid bilayers systems. The toolkit includes a variety of analyses from various lipid bilayer molecular simulation publications.
@@ -31,7 +32,7 @@ The analyses include:
3132
# Install
3233

3334
### Core dependencies
34-
PyBILT has the following core dependencies:
35+
**PyBILT** has the following core dependencies:
3536
* [MDAnalysis](https://www.mdanalysis.org/)
3637
* [NumPy](http://www.numpy.org/)
3738
* [SciPy](https://www.scipy.org/)
@@ -41,11 +42,11 @@ PyBILT has the following core dependencies:
4142
* [future](http://python-future.org/)
4243

4344
### Python version support
44-
The pybilt package has been tested using [Anaconda Python](https://www.anaconda.com/) 2.7, 3.6, and 3.7.
45+
The `pybilt` package has been tested using [Anaconda Python](https://www.anaconda.com/) 2.7, 3.6, and 3.7.
4546

4647
#### Sunsetting of Python 2
4748
Please be aware that Python 2 is scheduled to be sunset on January 1 2020. You can read about it here: [https://www.python.org/doc/sunset-python-2/](https://www.python.org/doc/sunset-python-2/)
48-
Parallel to the sunsetting of Python 2 many open source packages are also dropping support for Python 2 ([https://python3statement.org/](https://python3statement.org/)), including some of PyBILT's core dependencies. As such, after January 1, 2020, PyBILT will also likely sunset its support for Python 2.7.
49+
Parallel to the sunsetting of Python 2 many open source packages are also dropping support for Python 2 ([https://python3statement.org/](https://python3statement.org/)), including some of **PyBILT**'s core dependencies. As such, after January 1, 2020, **PyBILT** will also likely sunset its support for Python 2.7.
4950

5051
### pip install
5152
You can install the latest version of the `pybilt` package using `pip` sourced from the GitHub repo:
@@ -74,10 +75,10 @@ The core dependencies will be automatically installed.
7475
The following software is not required for the basic operation of **PyBILT**, but provides extra capabilities and features when installed.
7576

7677
#### pytest
77-
The pybilt test suite is designed to be run with [pytest](https://docs.pytest.org/en/latest/), so if you want to run the tests then you will need to install pytest.
78+
The `pybilt` test suite is designed to be run with [pytest](https://docs.pytest.org/en/latest/), so if you want to run the tests then you will need to install pytest.
7879

7980
#### Jupyter
80-
PyBILT comes with a set of [Jupyter IPython notebooks](./jupyter_notebooks) which supplement the doc pages. If you want to run these notebooks locally then you will need to intall [Jupyter](https://jupyter.org/) (or at least the IPython kernel).
81+
**PyBILT** comes with a set of [Jupyter IPython notebooks](./jupyter_notebooks) which supplement the doc pages. If you want to run these notebooks locally then you will need to intall [Jupyter](https://jupyter.org/) (or at least the IPython kernel).
8182

8283
Note that the notebooks have not been updated for Python 3 yet.
8384

@@ -136,7 +137,7 @@ analysis type. See the [documentation](https://pybilt.readthedocs.io/en/latest/b
136137
that can be computed from functions in the other modules.
137138
e.g. mean squared displacement and area per lipid.
138139
## Docs
139-
Visit the PyBILT docs on [Read the Docs](http://pybilt.readthedocs.io/en/latest/index.html).
140+
Visit the **PyBILT** docs on [Read the Docs](http://pybilt.readthedocs.io/en/latest/index.html).
140141
Docs can also be viewed offline/locally by opening the [PyBILT/docs/build/html/index.html](docs/build/html/index.html) file from the
141142
repo in a web browser; however, this build of the docs is not updated often.
142143

@@ -152,15 +153,15 @@ usage (these have not been updated/tested for/with python 3 yet); updates and mo
152153

153154
To report problems or bugs please open a
154155
[GitHub Issue](https://github.com/LoLab-VU/PyBILT/issues). Additionally, any
155-
comments, suggestions, or feature requests for PyBILT can also be submitted as
156+
comments, suggestions, or feature requests for **PyBILT** can also be submitted as
156157
a
157158
[GitHub Issue](https://github.com/LoLab-VU/PyBILT/issues).
158159

159160
------
160161

161162
# Contributing
162163

163-
If you would like to contribute directly to PyBILT's development please
164+
If you would like to contribute directly to **PyBILT**'s development please
164165
1. Fork the repo (https://github.com/LoLab-VU/PyBILT/fork)
165166
2. Create a new branch for your feature (git checkout -b feature/foo_bar)
166167
3. Create test code for your feature
@@ -186,7 +187,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
186187

187188
# Citing
188189

189-
If you use the **PyBILT** software as a part of your research, please cite the GitHub repo.
190+
If you use the **PyBILT** software as a part of your research, please cite the its use. You can export the **PyBILT** software citation in your preferred format from its [Zenodo DOI](https://doi.org/10.5281/zenodo.3426128) entry.
190191

191192
Also, please cite the following references as appropriate for scientific/research software used with/via **PyBILT**:
192193

docs/source/readme.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@
88
[![release](https://img.shields.io/github/release-pre/LoLab-VU/PyBILT.svg)](https://github.com/LoLab-VU/PyBILT/releases/tag/v0.2.0)
99
[![Anaconda-Server Badge](https://anaconda.org/blakeaw/pybilt/badges/version.svg)](https://anaconda.org/blakeaw/pybilt)
1010
[![Documentation Status](https://readthedocs.org/projects/pybilt/badge/?version=latest)](http://pybilt.readthedocs.io/en/latest/?badge=latest)
11+
[![DOI](https://zenodo.org/badge/85123567.svg)](https://zenodo.org/badge/latestdoi/85123567)
1112

1213
------
1314
#### PyBILT is a Python toolkit developed to analyze molecular simulation trajectories of lipid bilayers systems. The toolkit includes a variety of analyses from various lipid bilayer molecular simulation publications.
@@ -31,7 +32,7 @@ The analyses include:
3132
# Install
3233

3334
### Core dependencies
34-
PyBILT has the following core dependencies:
35+
**PyBILT** has the following core dependencies:
3536
* [MDAnalysis](https://www.mdanalysis.org/)
3637
* [NumPy](http://www.numpy.org/)
3738
* [SciPy](https://www.scipy.org/)
@@ -41,11 +42,11 @@ PyBILT has the following core dependencies:
4142
* [future](http://python-future.org/)
4243

4344
### Python version support
44-
The pybilt package has been tested using [Anaconda Python](https://www.anaconda.com/) 2.7, 3.6, and 3.7.
45+
The `pybilt` package has been tested using [Anaconda Python](https://www.anaconda.com/) 2.7, 3.6, and 3.7.
4546

4647
#### Sunsetting of Python 2
4748
Please be aware that Python 2 is scheduled to be sunset on January 1 2020. You can read about it here: [https://www.python.org/doc/sunset-python-2/](https://www.python.org/doc/sunset-python-2/)
48-
Parallel to the sunsetting of Python 2 many open source packages are also dropping support for Python 2 ([https://python3statement.org/](https://python3statement.org/)), including some of PyBILT's core dependencies. As such, after January 1, 2020, PyBILT will also likely sunset its support for Python 2.7.
49+
Parallel to the sunsetting of Python 2 many open source packages are also dropping support for Python 2 ([https://python3statement.org/](https://python3statement.org/)), including some of **PyBILT**'s core dependencies. As such, after January 1, 2020, **PyBILT** will also likely sunset its support for Python 2.7.
4950

5051
### pip install
5152
You can install the latest version of the `pybilt` package using `pip` sourced from the GitHub repo:
@@ -74,10 +75,10 @@ The core dependencies will be automatically installed.
7475
The following software is not required for the basic operation of **PyBILT**, but provides extra capabilities and features when installed.
7576

7677
#### pytest
77-
The pybilt test suite is designed to be run with [pytest](https://docs.pytest.org/en/latest/), so if you want to run the tests then you will need to install pytest.
78+
The `pybilt` test suite is designed to be run with [pytest](https://docs.pytest.org/en/latest/), so if you want to run the tests then you will need to install pytest.
7879

7980
#### Jupyter
80-
PyBILT comes with a set of [Jupyter IPython notebooks](./jupyter_notebooks) which supplement the doc pages. If you want to run these notebooks locally then you will need to intall [Jupyter](https://jupyter.org/) (or at least the IPython kernel).
81+
**PyBILT** comes with a set of [Jupyter IPython notebooks](./jupyter_notebooks) which supplement the doc pages. If you want to run these notebooks locally then you will need to intall [Jupyter](https://jupyter.org/) (or at least the IPython kernel).
8182

8283
Note that the notebooks have not been updated for Python 3 yet.
8384

@@ -136,7 +137,7 @@ analysis type. See the [documentation](https://pybilt.readthedocs.io/en/latest/b
136137
that can be computed from functions in the other modules.
137138
e.g. mean squared displacement and area per lipid.
138139
## Docs
139-
Visit the PyBILT docs on [Read the Docs](http://pybilt.readthedocs.io/en/latest/index.html).
140+
Visit the **PyBILT** docs on [Read the Docs](http://pybilt.readthedocs.io/en/latest/index.html).
140141
Docs can also be viewed offline/locally by opening the [PyBILT/docs/build/html/index.html](docs/build/html/index.html) file from the
141142
repo in a web browser; however, this build of the docs is not updated often.
142143

@@ -152,15 +153,15 @@ usage (these have not been updated/tested for/with python 3 yet); updates and mo
152153

153154
To report problems or bugs please open a
154155
[GitHub Issue](https://github.com/LoLab-VU/PyBILT/issues). Additionally, any
155-
comments, suggestions, or feature requests for PyBILT can also be submitted as
156+
comments, suggestions, or feature requests for **PyBILT** can also be submitted as
156157
a
157158
[GitHub Issue](https://github.com/LoLab-VU/PyBILT/issues).
158159

159160
------
160161

161162
# Contributing
162163

163-
If you would like to contribute directly to PyBILT's development please
164+
If you would like to contribute directly to **PyBILT**'s development please
164165
1. Fork the repo (https://github.com/LoLab-VU/PyBILT/fork)
165166
2. Create a new branch for your feature (git checkout -b feature/foo_bar)
166167
3. Create test code for your feature
@@ -186,7 +187,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
186187

187188
# Citing
188189

189-
If you use the **PyBILT** software as a part of your research, please cite the GitHub repo.
190+
If you use the **PyBILT** software as a part of your research, please cite the its use. You can export the **PyBILT** software citation in your preferred format from its [Zenodo DOI](https://doi.org/10.5281/zenodo.3426128) entry.
190191

191192
Also, please cite the following references as appropriate for scientific/research software used with/via **PyBILT**:
192193

0 commit comments

Comments
 (0)