flow-theory 0.1.0

Theoretical estimates for high-speed aerodynamics: skin friction, Stanton number, swallowing length, and more

flow_theory

Theoretical estimates for high-speed aerodynamics.

Install

pip install flow-theory

Quick Start

import flow_theory

Documentation

Full documentation: https://uahypersonics.github.io/flow-theory

Citation

If you use flow_theory in your research, please cite it:

@software{flow_theory,
  author = {Hader, Christoph},
  title = {flow\_theory: Theoretical Estimates for High-Speed Aerodynamics},
  url = {https://github.com/uahypersonics/flow-theory},
  year = {2026}
}

Code Style

This project follows established Python community conventions so that contributors can focus on the physics rather than inventing formatting rules.

Convention	What it covers	Reference
PEP 8	Code formatting, naming, whitespace	Python standard style guide
PEP 257	Docstring structure (triple-quoted, imperative mood)	Python standard docstring conventions
numpydoc	Docstring sections (Parameters, Returns, Attributes)	NumPy/SciPy docstring standard — the norm for scientific Python
Ruff	Automated linting and formatting	Enforces PEP 8 compliance automatically
typing / TYPE_CHECKING	Type hints for IDE support and static analysis	Python standard library

Releasing

This project uses Semantic Versioning (vMAJOR.MINOR.PATCH):

• MAJOR (v1.0.0, v2.0.0): Breaking API changes
• MINOR (v0.3.0, v0.4.0): New features, backward-compatible
• PATCH (v0.3.1, v0.3.2): Bug fixes, minor corrections

To publish a new version to PyPI:

1. Commit and push to main
2. Tag and push:

   git tag -a vMAJOR.MINOR.PATCH -m "Release vMAJOR.MINOR.PATCH"
   git push origin vMAJOR.MINOR.PATCH