This release is a pre-release and may not be stable for production use.
Pywr-next
This is repository contains the current work-in-progress for the next major revision to
Pywr. It uses Rust as a backend instead of Cython. It
is currently not ready for use beyond development and experimentation. Comments and discussions are welcome.
User Guide
·
Report Bug
·
Request Feature
Table of Contents
About The Project
Pywr-1.x is a Python library which utilises Cython for performance. Over time this has resulted in a "core" set of data structures and objects that are written in Cython to gain maximum performance. Cython has the nice benefit of making it easy to extend that core functionality using regular Python. However, the border between what is Python and what is Cython is a bit blurred and not well designed in certain places.
One option for the future development of Pywr (e.g. Pywr-2.x) would be a more explicit separation between the compute "core" and higher level functionality. Rust is a candidate for writing that core largely independent of Python, and possibly offers the benefits of (1) greater performance than Cython, and (2) easier maintenance in the future.
Requirements
Any major revision to Pywr will have the following feature requirements:
- Retain the "Parameter" system from Pywr-1.x - this is core functionality that makes Pywr really flexible.
- Extendable in Python space.
- An improved approach for outputting data and metrics.
- Better error handling.
- Cross-platform.
- Faster!
- Strong input file (JSON) schema.
Built With
Getting started
Installing pre-compiled wheels
See instructions in the Pywr book.
Compiling from source
This repository contains a version of Clp using Git submodules. In order to build those submodules must be initialised first.
git submodule init
git submodule update
Rust is required for installation of the Python extension. To create a Python development installation requires first compiling the Rust library and then the Python extension. The following example uses a virtual environment to install the Python dependencies, compile the Pywr extension and run the Pywr Python CLI.
python -m venv .venv # create a new virtual environment
source .venv/bin/activate # activate the virtual environment (linux)
# .venv\Scripts\activate # activate the virtual environment (windows)
pip install maturin # install maturin for building the Python extension
maturin develop # compile the Pywr Python extension
python -m pywr # run the Pywr Python CLI
Usage
Rust CLI
A basic command line interface is included such that you can use this version of Pywr without Python. This CLI is in the
pywr-cli crate.
To see the CLI commands available run the following:
cargo run -p pywr-cli -- --help
To run a Pywr v2 model use the following:
cargo run -p pywr-cli -- run tests/models/simple1.json
Python CLI
If the Python extension has been compiled using the above instructions a model can be run using the basic Python CLI.
python -m pywr run tests/models/simple1.json
Porting a Pywr v1.x model to v2.x
This version of Pywr is not backward compatible with Pywr v1.x. One of the major reasons for this version is the lack of a strong schema in the Pywr v1.x JSON files. Pywr v2.x uses an updated JSON schema that is defined in this repository. Therefore, v1.x JSON files must be converted to the v2.x JSON schema. This conversion can be undertaken manually, but there is also a work-in-progress conversion tool. The conversion tool uses a v1.x schema defined in the pywr-schema project.
Please note that conversion from Pywr v1.x to v2.x is experimental and not all features of Pywr are implemented in
pywr-schema or have been implemented in Pywr v2.x yet. Due to the changes between these versions it is very likely an
automatic conversion will not completely convert your model, and it WILL require manual testing and checking.
cargo run --no-default-features -- convert /path/to/my/v1.x/model.json
Feedback on porting models is very welcome, so please open an issue with any questions or problems.
Crates
This repository contains the following crates:
Pywr-core
A low-level Rust library for constructing network models. This crate interfaces with linear program solvers.
Feature flags:
| Feature | Description | Default |
|---|---|---|
pyo3 |
Enable the Python bindings. | True |
highs |
Enable the HiGHS LP solver. | False |
ipm-ocl |
Enable the OpenCL IPM solver (requires nightly). | False |
ipm-simd |
Enable the AVX IPM solver (requires nightly). | False |
cbc |
Enable the CBC MILP solver. | False |
Pywr-schema
A Rust library for validating Pywr JSON files against a schema, and then building a model from the schema using
pywr-core.
Feature flags:
| Feature | Description | Default |
|---|---|---|
core |
Enable building models from the schema with pywr-core. This feature is enabled by default, but requires a lot of dependencies. If you only require schema validation and manipulation consider building this crate with default-features = false |
True |
pyo3 |
Enable the Python bindings. | True |
highs |
Enable the HiGHS LP solver. | False |
ipm-ocl |
Enable the OpenCL IPM solver (requires nightly). | False |
ipm-simd |
Enable the AVX IPM solver (requires nightly). | False |
cbc |
Enable the CBC MILP solver. | False |
Pywr-cli
A command line interface for running Pywr models.
Pywr-python
A Python extension (and package) for constructing and running Pywr models.
Roadmap
- Proof-of-concept - demonstrate the benefits of the RIIR approach.
- Redesign of outputs & metrics.
- Redesign of variable API for integration with external optimisation algorithms.
- Implement outstanding
Parametersfrom Pywr v1.x - Design & implement Python API using Rust extension.
- Release Pywr v2.x beta
See the open issues for a full list of proposed features (and known issues).
Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
License
Distributed under the Apache 2.0 or MIT License. See LICENSE.txt for more information.
Contact
James Tomlinson - tomo.bbe@gmail.com
Project Link: https://github.com/pywr/pywr-next
Copyright (C) 2020-2023 James Tomlinson Associates Ltd.
1 maintainer
Metadata
1 maintainer
Release files for pywr 2.0.0b12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pywr-2.0.0b12.tar.gz | 8.2 MB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| pywr-2.0.0b12-cp310-abi3-win_amd64.whl | CPython 3.10 | abi3 | Windows x86-64 | Details |
| pywr-2.0.0b12-cp310-abi3-manylinux_2_28_x86_64.whl | CPython 3.10 | abi3 | Linux glibc 2.28+ x86-64 | Details |
| pywr-2.0.0b12-cp310-abi3-macosx_11_0_arm64.whl | CPython 3.10 | abi3 | macOS 11.0+ ARM64 | Details |
| pywr-2.0.0b12-cp310-abi3-macosx_10_12_x86_64.whl | CPython 3.10 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 76.2 MB
Release files / pywr-2.0.0b12.tar.gz
| Download URL | pywr-2.0.0b12.tar.gz |
|---|---|
| Size | 8.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2638291b458aedbc626feb83d9c4f493b9f1bd6cd737831531d29a9e51df20bf
|
|
BLAKE2b-256 checksum How to use checksums |
8b09de28594f298705c3eae544c89816548843456084ef9f3def080cff62a4d3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / pywr-2.0.0b12-cp310-abi3-win_amd64.whl
| Download URL | pywr-2.0.0b12-cp310-abi3-win_amd64.whl |
|---|---|
| Size | 17.4 MB |
| Tags | CPython 3.10 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
a4f30f08cead4fa0b97593818aed86099d454773ae5dc72174aad7ef1649f456
|
|
BLAKE2b-256 checksum How to use checksums |
e4d1ab9b994594b0a71cd00018f92041e13351ce56e72837c20375e745995bf0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / pywr-2.0.0b12-cp310-abi3-manylinux_2_28_x86_64.whl
| Download URL | pywr-2.0.0b12-cp310-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 18.5 MB |
| Tags | CPython 3.10 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
3279094438c667face032f97c31ec3b8f36590f387598f197c27b9409036bd2a
|
|
BLAKE2b-256 checksum How to use checksums |
3d40a57ca6dd77a40333f539e69d39b37f291d253320e9711c6c94c495e3d630
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / pywr-2.0.0b12-cp310-abi3-macosx_11_0_arm64.whl
| Download URL | pywr-2.0.0b12-cp310-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 15.6 MB |
| Tags | CPython 3.10 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
9831148f9ded9b114c30b1d5e6ee0dbfbaeb1d84042bd9dd5a6e3a75a0aed579
|
|
BLAKE2b-256 checksum How to use checksums |
b68837f2db1414f88662644efb7b78ec137983d0a7e04520a8ab50884f07a69f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / pywr-2.0.0b12-cp310-abi3-macosx_10_12_x86_64.whl
| Download URL | pywr-2.0.0b12-cp310-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 16.5 MB |
| Tags | CPython 3.10 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
420c94ed24e24ffaf26eb5a942c5ca205dd9ee595031094cdf02ef2709c4f205
|
|
BLAKE2b-256 checksum How to use checksums |
b70e634d41a5999f53257e9ef785f187dab555bbc9ba5d4afbd9eb9df19b3b36
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency log
