See the Quickstart instructions to start using simpar quickly. For those interested in developing for simpar, see the Development instructions where we walk through an editable installation of simpar on a Python virtual environment and running the test suite and linter.


The quickest way to get started with the simpar package is with pip. Run the following command to install it.

pip install simpar


We welcome contributions from the community for this project! Here is the preferred development setup. First, clone the repository.

git clone
cd simpar
git config --local include.path ../.gitconfig

Note: The final line adds functionality for stripping Jupyter notebook output and metadata for version management.

Next, create a Python virtual environment and install simpar with the -e flag and the development dependencies.

cd simpar
python3 -m venv venv
source venv/bin/activate
pip install -e ."[dev]"

The included Makefile includes a few targets to help with development: test runs the test suite, cov gives a coverage report in the command line, cov-html opens an interactive coverage report in the browser, and lint runs the flake8 linter on the source code to ensure it follows PEP 8 standards.