The flight-analyzer program is part of the scientific paper "Fliegen am Limit - Aktive Sicherheit im Gleitschirmsport", that was first published on 10/24/2022 and is being further developped by 03/31/2024 as of the "Schweizer Jugend forscht 2024" initiative. The application automates the analysis of paragliding flights and contains a selection of algorithms to process tracklogs. As part of the paper, this tool is designed to deliver a clean dataset that can be used to conduct and optimize advanced analyses and simulate the stationary glide of a paraglider. Please find a detailed description of the algorithms as well as concepts and findings in the sections below, in the paper itself or in the code.

Both the original and updated paper are listed below:

If you'd like to use the content of both this documentation and the revised paper, please cite as follows:

Thank you for your dedication to proper attribution. Happy reading & always happy landing!

All the best,
Nicolas

• flight-analyzer
  • Overview
  • Contents
  • Technical documentation
    • Introduction
    • Getting started
    • Architecture
    • Basic Usage
    • Algorithms and helpers
  • Research
  • Development
  • License & Intellectual Property
  • Disclaimer

The goal of the flight-analyzer application is to automatically manipulate large datasets, which contain the track logs of paragliding flights. The program evaluates for each point of the flight if it is on a straight line or not, which is relevant for modelling the stationary glide of a paraglider. This allows further analyses and the filtering by position of the point. After the input dataset has been filtered the tool can apply a selection of algorithms, which have been developped as of the "Fliegen am Limit" paper, to simulate the stationary flight of a paraglider. This serves as a foundation for the development of new algorithms, more advanced models and to conduct further analyses. In addition, the tool offers some helpers such as tools to visualize the manipulated data or preprocess raw input files.

Detailed descriptions can be found in docstrings and comments within the source code of this project.

Make sure to install Python 3.9 or higher on your machine. The code has only been tested for the Python versions 3.9, 3.10, 3.11 and 3.12-dev and should properly work on MacOS, Ubuntu Linux and Windows. It's recommended to use pyenv to manage local python environments as well as dependencies. To run this project make sure to activate an environment that supports Python 3.9 or higher and then run pip install -r requirements.txt. The application should work fine with the dependencies (indicated version) listed in requirements.txt.

The application is structured as follows:

⎡ flight-analyzer
⎢ ⟶ .github/
⎢ ⟶ docs/
⎢   ⟶ datasets/
⎢   ⟶ documentation/
⎢   ⟶ images/
⎢   ⟶ optimization/
⎢   ⟶ research/
⎢ ⟶ src/
⎢   ⟶ algorithms/
⎢   ⟶ analysis/
⎢   ⟶ executor/
⎢   ⟶ helpers/
⎢   ⟶ packages/
⎢   ⟶ constants.py
⎢ ⟶ tests/
⎢ ⟶ main.ipynb
⎢ ⟶ LICENSE.md
⎢ ⟶ README.md
⎢ ⟶ requirements.txt
⎢ ⟶ testing.sh
⎢ ⟶ update_testing.sh
⎣

Please click here to read the Basic Usage documentation.

Please click here to read the Algorithms and Helpers documentation.

Please click here to read the Research Report, which contains documentation about the process of creating the analyses that can be found in the paper.

Why the effort, you're asking?

Because paragliding is beautiful!
Fig. 1: Cover (Daniela Arslan, 2023)

Always happy landing.

Please click here to read the Development documentation.

The source code of this application is licensed under this license. Please click here to read the License & Intellectual Property documentation.

The author is not responsible for any damage caused by the use of the software.

© 2024, Nicolas Huber. All rights reserved.