yet another HAB simulator

This is a high altitude balloon simulator built in Bevy. The goal is to simulate the flight of a HAB (High Altitude Balloon) and to provide a software-in-the-loop platform for testing out various physics and engineering concepts with a realistic simulation.

This project is split into three parts:

  • yahs is the main simulation crate. It is a Bevy plugin that can be added to any Bevy project.
  • yahs-ui is a simple UI for the simulation. It is not required but it is useful for visualizing the simulation and for simulation and for debugging.
  • yahs-cli is a command line tool for running the simulation. It is useful for testing out the simulation without having to deal with the UI or for running the simulation in a headless mode.

Usage

As a library

Add yahs to your Cargo.toml:

[dependencies]
yahs = "0.4.0"

Then, add the SimulatorPlugins to your Bevy app:

use yahs::prelude::SimulatorPlugins;

fn main() {
    App::new().add_plugins(SimulatorPlugins);
}

Then you can use all of the components and systems from the yahs crate.

As an application

Running this package as a standalone application compiles all of the crates and runs the CLI by default:

cargo run

Force the standalone application to run the GUI instead of the CLI:

cargo run --bin yahs-ui