Skip to content

Commit ef4b69f

Browse files
authored
README update with pyOpenSci review suggestions: repotatus badge; target-audience paragraph; Fortran/CMake dependency mentioned earlier on (#396)
1 parent d472424 commit ef4b69f

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

README.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,13 @@
44

55
PyPartMC is a Python interface to [PartMC](https://lagrange.mechse.illinois.edu/partmc/),
66
a particle-resolved Monte-Carlo code for atmospheric aerosol simulation.
7+
Development of PyPartMC has been intended to remove limitations to the use of Fortran-implemented PartMC.
8+
PyPartMC facilitates the dissemination of computational research results by streamlining independent execution
9+
of PartMC simulations (also during peer-review processes).
10+
Additionally, the ability to easily package examples, simple simulations, and results in a web-based notebook
11+
allows PyPartMC to support the efforts of many members of the scientific community, including researchers,
12+
instructors, and students, with nominal software and hardware requirements.
13+
714
PyPartMC is implemented in C++ and it also constitutes a C++ API to the PartMC Fortran internals.
815
The Python API can facilitate using PartMC from other environments - see, e.g., Julia and Matlab examples below.
916

@@ -20,6 +27,7 @@ If interested in contributing to PyPartMC, please have a look a the [notes for d
2027
[![codecov](https://codecov.io/gh/open-atmos/PyPartMC/graph/badge.svg?token=27IK9ZIQXE)](https://codecov.io/gh/open-atmos/PyPartMC)
2128
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.7662635.svg)](https://doi.org/10.5281/zenodo.7662635)
2229
[![PyPI version](https://badge.fury.io/py/PyPartMC.svg)](https://pypi.org/p/PyPartMC)
30+
[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
2331

2432
## TL;DR (try in a Jupyter notebook)
2533

@@ -34,6 +42,12 @@ If interested in contributing to PyPartMC, please have a look a the [notes for d
3442
import PyPartMC
3543
```
3644

45+
Note that, depending on the environment (OS, hardware, Python version), the pip-install invocation
46+
may either trigger a download of a pre-compiled binary, or trigger compilation of PyPartMC.
47+
In the latter case, a Fortran compiler and some development tools includiong CMake, m4 and perl
48+
are required (while all non-Python dependencies are included in the PyPartMC source archive).
49+
In both cases, all Python dependencies will be resolved by pip.
50+
3751
#### Jupyter notebooks with examples
3852
Note: clicking the badges below redirects to cloud-computing platforms. The mybinder.org links allow anonymous execution, Google Colab requires logging in with a Google account, ARM JupyerHub requires logging in with an ARM account (and directing Jupyter to a particular notebook within the `examples` folder).
3953

0 commit comments

Comments
 (0)