/PlasmaPy

A community developed python package for plasma physics in the very early stages of development.

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

PlasmaPy

Build Status Coverage Status

A community developed Python package for plasma physics.

Project Status

PlasmaPy is in an early stage of development. The goals of this project are described in our vision statement and an earlier conference poster:

  • Murphy, Nicholas A, Huang, Yi-Min, & PlasmaPy Community. (2016, October). PlasmaPy: beginning a community developed Python package for plasma physics. Zenodo. http://doi.org/10.5281/zenodo.163752

We recently created a guide on contributing to PlasmaPy, which also contains instructions on how to join our email list. New contributors are very welcome!

If you have any questions, please contact Nick Murphy at namurphy@cfa.harvard.edu, Yi-Min Huang at yiminh@princeton.edu, or Drew Leonard at andy.j.leonard@gmail.com.

Installation

There are multiple options to download the source code for PlasmaPy. The simplest is to select "Clone or Download" on our repository page. This will provide an option to download a zip file plus information on how to clone the repository. If you have git installed on your computer and you would like to use HTTPS (which is the default and easier to set up), then run:

git clone https://github.com/PlasmaPy/PlasmaPy.git

If you have set up an SSH key, an equivalent and more secure command is:

git clone git@github.com:PlasmaPy/PlasmaPy.git

The contributing to PlasmaPy guide has instructions on how to fork a repository so that you may make pull requests.

In the top level directory, run

python setup.py install

PlasmaPy is presently being designed to be compatible with Python 3.6 and above, and does not guarantee support for Python 3.5 and below. PlasmaPy is not compatible with Python 2.

License

PlasmaPy is licensed under a 3-clause BSD style license - see LICENSE.md file in the top-level directory.