pyflightstream
Version-aware Python driver for the FlightStream panel-method solver: write a run matrix, and pyflightstream plans, runs and post-processes every point, from your workstation or a cluster. MIT licensed.
CHANGELOG.md describes package changes and the retained release history. Use the upgrade guidance when moving an existing workspace to a newer package version.
Documentation: nevesgeovana.github.io/pyflightstream
What it does
matrix -> plan -> run -> collect -> post -> products
(.fs) (free, (local (cluster (polars, rotor tables,
no solver) or HPC) jobs) sections, averages, provenance)
- One row, one simulation. A pipe-separated matrix names each case, its flight condition, its sweep and the input artifacts it uses (reference, setup, post-processing).
- Checked before it costs a licence.
planbuilds every script without the solver and refuses what the target FlightStream build cannot run, with the reason. - Every command has evidence. Each solver command is validated against a per-version database; every entry cites a manual page or a committed probe report.
- Products you open directly. CSV polars, rotor coefficient tables, sections, probes and time averages, each stating the flight condition it belongs to, plus a provenance record per run.
Install
pip install "pyflightstream[dev,plot,geom,fsi,excel]"
The extras add development and documentation tools (dev), plotting (plot),
spatial geometry queries (geom), structural coupling (fsi) and workbook
authoring (excel). Maintainers reading licensed manuals also install
pyflightstream[manual].
Python 3.12 or newer. FlightStream itself is licensed separately and is located through your workspace, never guessed.
Quick start without a solver
pyfs-workspace init my-study
Getting started
starts with an executable solver-free example, then walks the geometry,
matrix, reference, setup and post-processing inputs needed before planning.
Initialization creates my-study/inputs/INPUTS.md; read it next. Planning
needs those inputs but no solver license. Running requires a separately
licensed FlightStream installation.
From the GUI to pyfs maps each GUI step to the key that takes it here.
Command-line tools
| Tool | What it is for |
|---|---|
pyfs-workspace |
Create or migrate a workspace; archive simulations; prepare geometry, custom fields and actuator profiles |
pyfs-matrix |
Plan, run, collect and post a run matrix; storage (space-in-use, free-space, delete-sims) and sync between workspaces |
pyfs-qa |
Command-validity probes and physics regression on a licensed machine |
pyfs-fsi |
The structural executable of the aeroelastic coupling loop |
pyfs-manual |
Maintainer tool: compare FlightStream manuals with the command database |
Capability status
| Capability | Status |
|---|---|
| Command database, script builder, version refusals | supported |
| Parsers, tables, run manifest, reconstruction | supported |
| Campaigns, run matrices, workspace, pre-flight | supported |
| Far-field ledgers and probe surveys | experimental |
| FSI structural beam and modal analysis | experimental (docs/examples/_sources/wing_static_deflection.py, docs/examples/_sources/fsi_campbell_diagram.py) |
| FSI coupled driver (the four-phase loop) | experimental: offline replay only, never run against a live solver in CI |
| Rotary two-way coupling | not validated |
Experimental means the interface may change without a deprecation window, and the evidence behind it is narrower than for the supported rows.
Supported FlightStream versions
| Version | Vendor name | Support level | Build |
|---|---|---|---|
| 25.000 | 25.0 | documented |
12162024 |
| 25.100 | 25.1 | documented |
5062025 |
| 26.000 | 26.0 | documented |
10202025 |
| 26.100 | 26.1 | operational |
2122026 |
| 26.101 | 26.1 | operational |
5012026 |
| 26.120 | 26.12 | operational |
7012026 |
| 26.121 | 26.12 | operational |
7262026 |
| 26.122 | 26.12 | operational |
8092026 |
| 26.123 | 26.12 | operational |
8112026 |
| 26.124 | 26.12 | operational |
8172026 |
| 26.125 | 26.12 | operational |
10052026 |
operational means the minimal geometry-to-loads workflow builds for that
version, checked by a test. documented describes the database support level;
it does not imply that no measurements exist for that build. Individual commands
may carry different evidence. The details, and how to tell
which build you have, are on
Which build do I have:
import pyflightstream
for row in pyflightstream.support_table():
print(row.summary)
Contributing
pip install -e .[dev,fsi,geom]
pre-commit install
pytest
The hard invariants are in CONTRIBUTING.md. Tier 1 runs anywhere; tiers 2
and 3 need a licensed FlightStream and are described in
the test tiers.
Citing and license
Cite the release you used through its Zenodo DOI (CITATION.cff). MIT
licensed; contributions must be original or MIT-compatible, and code derived
from the AGPL pyFlightscript package is not accepted.
1 maintainer
Metadata
1 maintainer
Release files for pyflightstream 0.44.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| pyflightstream-0.44.0.tar.gz | 3.0 MB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pyflightstream-0.44.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 6.2 MB
Release files / pyflightstream-0.44.0.tar.gz
| Download URL | pyflightstream-0.44.0.tar.gz |
|---|---|
| Size | 3.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4cf6d7264d7508ad2a860b2c225d345b3b9d17aeb035df926d395421f3c92124
|
|
BLAKE2b-256 checksum How to use checksums |
d431837db63accb0e56fdbb827882218e40b9159ed953ca008388532663066c7
|
| 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 23, 2026.
Transparency logRelease files / pyflightstream-0.44.0-py3-none-any.whl
| Download URL | pyflightstream-0.44.0-py3-none-any.whl |
|---|---|
| Size | 3.3 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
378875fbdee214ce59532a7bc216c31e521b150c409425f78a9df6f9cb92b55c
|
|
BLAKE2b-256 checksum How to use checksums |
d3a2e9ab7505202d97ffab83f1a1fd262198f976218491964529f3eeee45a8e9
|
| 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 23, 2026.
Transparency logSecurity for pyflightstream 0.44.0
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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for pyflightstream-0.44.0.tar.gz
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 23, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
