pyaspenplus

pyaspenplus is a lightweight Python wrapper to interact with Aspen Plus via a programmatic API. It provides a simple client interface to open cases, run simulations, read and write stream values, and save results. The library is backend-agnostic and supports a COM backend (for real Aspen Plus on Windows) and a Mock backend (for development and testing).

Features

• Connect to Aspen Plus via COM (Windows)
• Open / save case files, run simulations
• Read and write stream properties
• Clean, documented API and examples
• CI workflows for testing and publishing to PyPI.

Installation

Install from PyPI (available after publishing):

pip install pyaspenplus

Or install from git (available):

git clone https://github.com/YuzeHao2023/pyaspenplus.git
pip3 install -e .

Note: To use the COM backend you must be on Windows with Aspen Plus installed and pywin32 (or comtypes) available.

Fast start

Install：

git clone https://github.com/YuzeHao2023/pyaspenplus.git
cd pyaspenplus
pip3 install -e .

Install requirements:

pip3 install -r requirements.txt

Test:

import pyaspenplus

Quick example

from pyaspenplus import AspenPlusClient

client = AspenPlusClient(backend="mock")  # use mock for local testing
with client.connect():
    client.open_case("example.bkp")
    client.run()
    streams = client.get_streams()
    print(streams)

Full examples in the examples/ folder.

Documentation

See docs/usage.md and docs/api.md for usage and API reference.

License

Apache-2.0 license