simbl

Compressible similarity boundary layer solver with Falkner-Skan and Falkner-Skan-Cooke support.

Install

pip install similarity-bl

Quick Start

API:

from simbl import SimilarityInputs, SolverOptions, solve_similarity

inputs = SimilarityInputs(mach_edge=6.0, temp_edge=55.0, wall_bc="adiabatic")
options = SolverOptions()

solution, info = solve_similarity(inputs, options)
print(f"f''(0) = {solution.fpp[0]:.6f}")
print(f"g(0)   = {solution.g[0]:.6f}")

CLI:

simbl init                   # generate a template config file
simbl solve config.toml      # solve from config
simbl solve --mach 6.0 --temp-edge 55.0 --wall adiabatic

Documentation

Full documentation: https://uahypersonics.github.io/similarity-bl

Citation

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

@software{simbl,
  author = {Hader, Christoph},
  title = {simbl: Compressible Similarity Boundary Layer Solver},
  url = {https://github.com/uahypersonics/similarity-bl},
  year = {2026}
}

Validation and Verification

Reproducible VnV cases comparing simbl against independent reference data are in vnv/.

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:

Verify locally and fix any errors before cutting the release:
```
ruff check .
pytest
```
Commit and push to main

Tag and push:

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

similarity_bl-0.5.1.tar.gz (2.0 MB view details)

Uploaded Aug 1, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

similarity_bl-0.5.1-py3-none-any.whl (159.2 kB view details)

Uploaded Aug 1, 2026 Python 3

File details

Details for the file similarity_bl-0.5.1.tar.gz.

File metadata

Download URL: similarity_bl-0.5.1.tar.gz
Upload date: Aug 1, 2026
Size: 2.0 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for similarity_bl-0.5.1.tar.gz
Algorithm	Hash digest
SHA256	`fa24df957d6b633fa65bfa42c99ed0ad0366e6d7222df9b5fa77ceec028d35ee`
MD5	`193a3441f7840ef59084b7265e6b1a76`
BLAKE2b-256	`0d482c635fe39a985f409ea760b95c589e5f4570a525fcb2e16371c31bc19e7f`

See more details on using hashes here.

Provenance

The following attestation bundles were made for similarity_bl-0.5.1.tar.gz:

Publisher: publish.yml on uahypersonics/similarity-bl

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: similarity_bl-0.5.1.tar.gz
- Subject digest: fa24df957d6b633fa65bfa42c99ed0ad0366e6d7222df9b5fa77ceec028d35ee
- Sigstore transparency entry: 2312794447
- Sigstore integration time: Aug 1, 2026
Source repository:
- Permalink: uahypersonics/similarity-bl@df5741aa2bbc890996eab72a1edb4ee86d9e71ff
- Branch / Tag: refs/tags/v0.5.1
- Owner: https://github.com/uahypersonics
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@df5741aa2bbc890996eab72a1edb4ee86d9e71ff
- Trigger Event: push