Skip to content

The flight-analyzer program is part of the scientific paper "Fliegen am Limit - Aktive Sicherheit im Gleitschirmsport", that was first published on 10/14/2022 and is being further developped by 03/31/2024 as of the "Schweizer Jugend forscht 2024" initiative.

License

Notifications You must be signed in to change notification settings

nicolashuberIT/flight-analyzer

Repository files navigation

flight-analyzer

Python License Testing Formatting Linting

Overview

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:

Date Description Author Supervisor Context Link
10/24/2022 Original paper Nicolas Huber Albert Kern Kantonsschule Zürcher Oberland (KZO) nicolas-huber.ch
03/31/2024 Updated paper Nicolas Huber Albert Kern, Ronald Luijten Schweizer Jugend forscht (SJf) nicolas-huber.ch

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

Attribution
Huber, Nicolas (2024): Fliegen am Limit - Aktive Sicherheit im Gleitschirmsport, Zürich: Kantonsschule Zürcher Oberland (KZO) & Schweizer Jugend forscht (SJf).

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

All the best,
Nicolas


Contents


Technical documentation

Introduction

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.

Getting started

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.

Architecture

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
⎣

Basic Usage

Please click here to read the Basic Usage documentation.

Algorithms and helpers

Please click here to read the Algorithms and Helpers documentation.


Research

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!
Cover
Fig. 1: Cover (Daniela Arslan, 2023)

Always happy landing.


Development

Please click here to read the Development documentation.


License & Intellectual Property

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


Disclaimer

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


© 2024, Nicolas Huber. All rights reserved.

About

The flight-analyzer program is part of the scientific paper "Fliegen am Limit - Aktive Sicherheit im Gleitschirmsport", that was first published on 10/14/2022 and is being further developped by 03/31/2024 as of the "Schweizer Jugend forscht 2024" initiative.

Topics

Resources

License

Stars

Watchers

Forks