Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

pfh.glidersim

A Python library for estimating the flight dynamics of gliding aircraft.

To simplify its use in common engineering applications (such as control modeling and statistical filtering), the glider dynamics are encoded as differential equations (ẋ = f(x, u)).

Key Features

Modeling

  • Novel wing geometry model optimized for nonlinear designs

  • Paraglider component models parametrized by basic technical data

  • Paraglider system models that accept all three primary control inputs: brakes, accelerator, and weight shift (direct manipulation of the risers and individual lines is not supported)

  • Stateless models that are easy understand, use, extend, and test

Aerodynamics

  • Nonlinear aerodynamics using a fast nonlinear lifting-line theory model

  • Graceful accuracy degradation near stall (important for paragliders, which frequently operate at relatively high angles of attack)

  • Supports non-uniform wind fields and non-uniform wind vectors along the aerodynamic surfaces, enabling simulations involving local wind sheer, thermal lift and sink, wing rotation, etc.

  • Includes paraglider system dynamics models that account for apparent mass (nonlinear dynamics due to the motion of an object through a fluid that become more significant for low-density volumes such as parafoils)

Usability

  • Flight dynamics are encoded as numerical state derivatives, providing a simple model interface

  • Includes a rudimentary simulator for generating flight trajectories from predefined wing control and wind field inputs

  • Open source with a permissive license, built using the Python scientific computing stack (NumPy, SciPy, and Numba). Usable from within embedded Python interpreters, such as the Python consoles in Blender and FreeCAD.

Non-features

Equally important is what it does not do:

  • The library is not suitable for studying behaviors involving turbulence, wing deformations, rapid wing maneuvers, or post-stall behaviors.

  • The library is not a structural simulator. The models are not adequate for designing or testing the structural integrity of a design; they assume rigid-body dynamics without estimating internal forces. (For example, it neglects suspension line tension, cell billowing, canopy wrinkling, etc.)

  • The library is not focused on engineering control input sequences or wind field models. The bundled simulator is for executing simulations given some inputs, not for designing them.

  • The library is not focused on execution time. Although speed is important, the design prioritizes readability, functionality, and flexibility.

Installation

To install the latest release of the package into a Python virtual environment:

$ pip install pfh.glidersim

Or, for the latest development version:

$ pip install git+https://github.com/pfheatwole/glidersim

Documentation

  • Design overview: for the background and architecture of the library, refer to the design guide.

  • Examples: to use the library to build glider models or run flight simulations, refer to the usage guide.

  • API: to program using the library, refer to the library reference.

  • Derivations: for a deeper discussion of the modeling choices, mathematical derivations, and literature references, refer to my thesis: Parametric Paraglider Modeling.

Disclaimer

This software has been stable for my purposes, but should be considered “alpha” quality. The design (including the API) needs more users to test it before it could be considered stable. Also the estimates produced by the nonlinear aerodynamics method needs more verification.

Metadata

Release files for pfh.glidersim 2022.3.0a0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pfh.glidersim 2022.3.0a0
File Size Uploaded
pfh.glidersim-2022.3.0a0.tar.gz 1.2 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for pfh.glidersim 2022.3.0a0
File Interpreter ABI Platform
pfh.glidersim-2022.3.0a0-py3-none-any.whl Python 3 none any Details

Total release size: 2.4 MB

Release files / pfh.glidersim-2022.3.0a0.tar.gz

Download URL pfh.glidersim-2022.3.0a0.tar.gz
Size 1.2 MB
Tags Source
SHA-256 checksum
How to use checksums
a6c474ce94b550aa93ac0dbff397edf3fa815e043475be0b240f316e19570118
BLAKE2b-256 checksum
How to use checksums
133d44f371959329679f461138a4390ba545a6854acd4e467b5c39098a5a2a79
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.10.3

Release files / pfh.glidersim-2022.3.0a0-py3-none-any.whl

Download URL pfh.glidersim-2022.3.0a0-py3-none-any.whl
Size 1.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
aef75079aea2473db9830d6fe733cd272990da7f297b7d1a94764e3da602e5a0
BLAKE2b-256 checksum
How to use checksums
78052c657af97ec2e15cb5ff73fb91b8c86b8e217f9a7cc660d1b7c793e482ef
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.10.3

Release history Release notifications | RSS feed

This release

2022.3.0a0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page