avl-aero-tables 1.8.0

Generate aerodynamic lookup tables using AVL (Athena Vortex Lattice)

avl-aero-tables

A Python package that drives AVL (Athena Vortex Lattice) by Mark Drela and Harold Youngren (MIT) programmatically — piping sweep commands to AVL's stdin, parsing its .st output, and returning structured aerodynamic lookup tables.

Install

pip install avl-aero-tables

Requires Python 3.12+ and the AVL binary installed at ~/bin/avl.

Documentation

Full installation guide, walkthrough, API reference, and more at the docs site.

Quick look

CLI

Define a sweep in a YAML project file and run it in one command:

$ avl-aero-tables sweep examples/bd/bd.yml         # run sweep → _runs/bd/<timestamp>/
$ avl-aero-tables plot geometry examples/bd/bd.yml  # interactive 3-D geometry plot
$ avl-aero-tables plot aero _runs/bd/               # plot latest sweep results

Python API

Call the same steps programmatically:

from avl_aero_tables import avl_fileread, avl_fileplot, avl_sweep, aero_filewrite, aero_fileplot

geom    = avl_fileread("examples/bd/bd.avl")            # parse geometry
fig     = avl_fileplot(geom)                            # interactive 3-D plot
results = avl_sweep("examples/bd/bd.avl", alpha, beta, out_dir="_runs")  # run AVL sweep
aero    = aero_filewrite(results)                       # build lookup tables
figs    = aero_fileplot(aero)                           # plot aero database

References

• AVL homepage
• AVL User Primer