You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
**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.**
13
+
#### 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.
The pybilt package has been tested using [Anaconda Python](https://www.anaconda.com/) 2.7, 3.6, and 3.7.
57
45
58
-
The pybilt package has been tested using [Anaconda Python](https://www.anaconda.com/) 2.7 and Python 3.6;
46
+
#### Sunsetting of Python 2
47
+
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.
59
49
60
-
The following section describes the process for setting up the dependencies and
61
-
installing the 'pybilt' package using a conda environment and the setup.py
62
-
script.
63
-
64
-
#### Setup and install using Anaconda's conda tool
65
-
66
-
##### Method 1 (manual package installation)
67
-
First, clone or download the GitHub repo
68
-
```
69
-
git clone https://github.com/blakeaw/PyBILT.git
50
+
### pip install
51
+
You can install the latest version of the `pybilt` package using `pip` sourced from the GitHub repo:
70
52
```
71
-
Then create a new conda environment for pybilt and activate it:
However, this will not automatically install the core dependencies. You will have to do that separately:
75
56
```
76
-
The install the preferred python version:
77
-
* for Python 2.7
57
+
pip install MDAnalysis numpy scipy matplotlib seaborn six future
78
58
```
79
-
conda install python=2.7
80
-
```
81
-
* for Python 3.6
82
-
```
83
-
conda install python=3.6
84
-
```
85
59
86
-
Then install all the pybilt run dependencies:
87
-
```
88
-
conda install numpy scipy matplotlib seaborn six future
89
-
conda install -c conda-forge MDAnalysis
60
+
### conda install
61
+
First make sure you have the `conda-forge` channel in your channel list; that is the channel from which MDAnalysis is installed. You can use the following command to add it to the bottom of your channel list:
90
62
```
91
-
Then install pybilt:
92
-
```
93
-
python PyBILT/setup.py install
63
+
conda config --append channels conda-forge
94
64
```
95
65
96
-
If you want to run the pybilt tests you can install pytest:
97
-
```
98
-
conda install pytest
66
+
Then you can install the `pybilt` package from the `blakeaw` Anaconda Cloud channel,
99
67
```
100
-
101
-
If you want to run the pybilt Jupyter notebooks (PyBILT/jupyter_notebooks), then install Jupyter:
68
+
conda install -c blakeaw pybilt
102
69
```
103
-
conda install jupyter
104
-
```
105
-
Note that the notebooks have not been updated for Python 3 yet.
70
+
The core dependencies will be automatically installed.
106
71
107
-
If you want to build local versions of doc pages install the following packages:
108
-
```
109
-
conda install sphinx
110
-
pip install sphinx_rtd_theme
111
-
pip install recommonmark
112
-
```
72
+
### Recommended additional software
113
73
114
-
##### Method 2 (From environment yaml)
74
+
The following software is not required for the basic operation of **PyBILT**, but provides extra capabilities and features when installed.
115
75
116
-
The files environment_py27.yml and environment_py36.yml have been provided to allow for easy setup of a new conda
117
-
environment with all of the most recently tested versions of dependencies.
118
-
Run:
119
-
* For Python 2.7:
120
-
```
121
-
conda env create -f environment_py27.yml
122
-
```
123
-
* For Python 3.6
124
-
```
125
-
conda env create -f environment_py36.yml
126
-
```
76
+
#### 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.
127
78
128
-
which will create a new conda environment named *pybilt* with the appropriate
129
-
dependencies. Then activate the environment
130
-
```
131
-
source activate pybilt
132
-
```
133
-
Next, run the setup.py script with install,
134
-
```
135
-
python PyBILT/setup.py install
136
-
```
137
-
to install the 'pybilt' package into the *pybilt* environment.
79
+
#### 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).
138
81
139
-
If you want to run the pybilt Jupyter notebooks (PyBILT/jupyter_notebooks), then install Jupyter:
140
-
```
141
-
conda install jupyter
142
-
```
143
82
Note that the notebooks have not been updated for Python 3 yet.
144
83
84
+
#### sphinx, sphinx_rtd_theme, and recommonmark
85
+
If you want to build local versions of doc pages install the following additional packages:
**PyBILT** is composed of 2 primary analysis packages:
149
97
* bilayer_analyzer -- The [bilayer_analyzer](http://pybilt.readthedocs.io/en/latest/pybilt.bilayer_analyzer.html#module-pybilt.bilayer_analyzer.bilayer_analyzer) is an analysis package that
@@ -187,40 +135,33 @@ analysis type. See the [documentation](https://pybilt.readthedocs.io/en/latest/b
187
135
(using matplotlib and seaborn) for some of the properties
188
136
that can be computed from functions in the other modules.
189
137
e.g. mean squared displacement and area per lipid.
190
-
191
-
------
192
-
193
-
## Documentation
194
-
138
+
## Docs
195
139
Visit the PyBILT docs on [Read the Docs](http://pybilt.readthedocs.io/en/latest/index.html).
196
140
Docs can also be viewed offline/locally by opening the [PyBILT/docs/build/html/index.html](docs/build/html/index.html) file from the
197
141
repo in a web browser; however, this build of the docs is not updated often.
142
+
143
+
## Jupyter IPython notebooks
198
144
In addition
199
-
to the doc pages, there are currently a few Jupyter IPython
145
+
to the Docs, there are currently a few Jupyter IPython
200
146
[notebooks](jupyter_notebooks) that provide some examples and show some basic
201
147
usage (these have not been updated/tested for/with python 3 yet); updates and more of these are in the pipeline.
202
148
203
149
------
204
150
205
-
##Contact
151
+
# Contact
206
152
207
153
To report problems or bugs please open a
208
-
[GitHub Issue](https://github.com/blakeaw/PyBILT/issues). Additionally, any
154
+
[GitHub Issue](https://github.com/LoLab-VU/PyBILT/issues). Additionally, any
209
155
comments, suggestions, or feature requests for PyBILT can also be submitted as
If you would like to contribute directly to PyBILT's development please
223
-
1. Fork the repo (https://github.com/blakeaw/PyBILT/fork)
164
+
1. Fork the repo (https://github.com/LoLab-VU/PyBILT/fork)
224
165
2. Create a new branch for your feature (git checkout -b feature/foo_bar)
225
166
3. Create test code for your feature
226
167
4. Once your feature passes its own test, run all the tests using [pytest](https://docs.pytest.org/en/latest/) (python -m pytest)
@@ -230,42 +171,41 @@ If you would like to contribute directly to PyBILT's development please
230
171
231
172
------
232
173
233
-
##License
174
+
# License
234
175
235
176
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details
236
177
237
178
------
238
179
239
-
##Acknowledgments
180
+
# Acknowledgments
240
181
241
182
* A special thanks to James Pino (https://github.com/JamesPino) for his inciteful comments and suggestions that have helped improve the quality of this code, and thanks to him for pointing out some very useful coding tools.
242
183
* Thanks to my advisors, Carlos F. Lopez and Arvind Ramanathan, for catalyzing this project and for providing me with the space and means to pursue it.
243
184
244
185
------
245
186
246
-
## Built With
247
-
248
-
*[ANACONDA](https://www.continuum.io/) - ANACONDA Python distribution and CONDA package and environment manager
249
-
*[PyCharm](https://www.jetbrains.com/pycharm/) - Text Editor/IDE
250
-
*[ATOM](https://atom.io/) - Text Editor/IDE
251
-
*[Sublime Text](https://www.sublimetext.com/) - Text Editor used in earlier work
252
-
*[Landscape](https://landscape.io/) - Code quality analysis and tracking
253
-
*[Git](https://git-scm.com/) - Version control
254
-
*[GitHub](https://github.com/) - Development Platform and repository storage
*[recommonmark](https://github.com/rtfd/recommonmark) - A docutils-compatibility bridge to CommonMark
257
-
*[Read the Docs](https://readthedocs.org/) - Documentation hosting
258
-
*[docstring-coverage](https://bitbucket.org/DataGreed/docstring-coverage/wiki/Home) - A simple audit tool for examining python source files for missing docstrings.
259
-
*[Python-Modernize](https://python-modernize.readthedocs.io/en/latest/) - Automatic modernization of Python 2 code for dual Python 2 and 3 support.
187
+
# Citing
260
188
261
-
------
189
+
If you use the **PyBILT** software as a part of your research, please cite the GitHub repo.
190
+
191
+
Also, please cite the following references as appropriate for scientific/research software used with/via **PyBILT**:
192
+
193
+
#### MDAnalysis
194
+
See: https://www.mdanalysis.org/pages/citations/
195
+
196
+
#### Packages from the SciPy ecosystem
197
+
198
+
These include NumPy, SciPy, and Matplotlib for which references can be obtained from:
199
+
https://www.scipy.org/citing.html
200
+
201
+
#### seaborn
202
+
Reference can be exported from the [seaborn Zeondo DOI entry](https://doi.org/10.5281/zenodo.592845)
0 commit comments