Particula is a simple aerosol particle simulator. It is designed to be easy to use and easy to extend. The goal is to have a robust aerosol (gas phase and particle phase) simulation system that can be used to answer scientific questions that arise in experiments and research endeavors.
The main goal is to develop an aerosol particle model that is usable, efficient, and productive. In this process, we all will learn developing models in Python and associated packages. Let us all be friendly, respectful, and nice to each other. Any code added to this repository is automatically owned by all. Please speak up if something (even if trivial) bothers you. Talking through things always helps. This is an open-source project, so feel free to contribute, however small or big your contribution may be.
We follow the Google Python style guide here. We have contribution guidelines here and a code of conduct here as well.
The development of this package will be illustrated through Jupyter notebooks (here) that will be put together in the form of a Jupyter book on our website. To use it, you can install particula
from PyPI or conda-forge with pip install particula
or conda install -c conda-forge particula
, respectively.
For development, you can fork this repository and then install particula
in an editable (-e
) mode --- this is achieved by pip install -e ".[dev]"
in the root of this repository. Invoking pip install -e ".[dev]"
will install particula
, its runtime requirements, and the development and test requirements. The editable mode is useful because it allows seeing the manifestation of code edits globally through the particula
package in your environment (in a way, with the -e
mode, particula
self-updates to account for the latest local code edits).