Machwave is a Python library for chemical propulsion simulation. The library makes it easy to model solid or biliquid rocket engines, analyse performance and integrate the results into trajectory simulations.
Getting Started
Installation
Install Machwave using pip:
pip install machwave
macOS prerequisite: gfortran
Machwave depends on rocketcea, which does
not publish macOS wheels on PyPI. On macOS, pip therefore builds rocketcea from
source and needs a Fortran compiler. Homebrew's gcc formula installs only
versioned binaries (e.g. gfortran-15), so an unversioned gfortran symlink
must be added to PATH before pip install machwave:
brew install gcc
ln -sf "$(ls "$(brew --prefix)"/bin/gfortran-* | sort -V | tail -n 1)" "$(brew --prefix)/bin/gfortran"
Linux and Windows users do not need this step — rocketcea ships prebuilt wheels for those platforms.
Documentation
The full documentation is available at felipebogaertsm.github.io/machwave.
Development Setup
If you're contributing to Machwave, you'll need uv for dependency management.
Installing uv
macOS / Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows (PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
For more details, visit the official uv installation guide.
Clone and Install
Clone the repository and install dependencies:
git clone https://github.com/felipebogaertsm/machwave.git
cd machwave
make install
Publishing a New Release
-
Create a release on GitHub with a tag matching
vX.Y.Z(e.g.v1.2.0). The version is derived automatically from the git tag. -
The publish workflow builds the package and publishes it to PyPI via trusted publishing (OIDC).
1 maintainer
Metadata
1 maintainer
Release files for machwave 0.9.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| machwave-0.9.2.tar.gz | 611.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| machwave-0.9.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 772.9 kB
Release files / machwave-0.9.2.tar.gz
| Download URL | machwave-0.9.2.tar.gz |
|---|---|
| Size | 611.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cb08ed493717753a4bc93a201078a198da4c313aed9242ddb2a25fd82b50cc66
|
|
BLAKE2b-256 checksum How to use checksums |
0366da5b90419c782ff8cff46725a2375fca289878fc974728fa746f6ef1f615
|
| 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 Aug 24, 2026.
Transparency logRelease files / machwave-0.9.2-py3-none-any.whl
| Download URL | machwave-0.9.2-py3-none-any.whl |
|---|---|
| Size | 161.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bfa5d07389c64a7dbda657015e14fc17e354bbc32bf06e1b00ef8dfc203e5740
|
|
BLAKE2b-256 checksum How to use checksums |
6ad7552f79dda0ecb2082557d4480ec17d6ae3690992f80c55986088c2178094
|
| 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 Aug 24, 2026.
Transparency log
