feat: support ingenuity realistic flight simulation and control

Author: BarisYazici

ingenuity_mars_helicopter/Dockerfile

@@ -0,0 +1,13 @@
+FROM openrobotics/space_robots_demo
+
+COPY ingenuity_mars_helicopter /home/spaceros-user/demos_ws/src/ingenuity_mars_helicopter
+COPY helicopter_flight_control /home/spaceros-user/demos_ws/src/helicopter_flight_control
+COPY helicopter_flight_simulation /home/spaceros-user/demos_ws/src/helicopter_flight_simulation
+COPY ingenuity_bringup /home/spaceros-user/demos_ws/src/ingenuity_bringup
+COPY ingenuity_description /home/spaceros-user/demos_ws/src/ingenuity_description
+COPY ./entrypoint.sh /home/spaceros-user/entrypoint.sh
+
+
+RUN sudo chmod +x /home/spaceros-user/entrypoint.sh
+
+ENTRYPOINT ["/home/spaceros-user/entrypoint.sh"]

ingenuity_mars_helicopter/README.md

@@ -0,0 +1,139 @@
+# NASA Space ROS Sim Summer Sprint Challenge
+   Team lead freelance username: Barisyaz
+   Submission title: Ingenuity Flight Simulator
+
+# Ingenuity Flight Simulator
+
+This project simulates the Ingenuity Mars Helicopter using Gazebo and ROS 2 in Space-ROS.
+
+Aim of this project is to develop tools to mimic the Martian environment as close as possible. This enables space robots to easily iterate over the development cycles. This is important especially for the aerial vehicles. Because the air is much thinner and the nature events are different. Having this in mind, I develop the Ingenuity Flight Simulator, calculating the lift and drag forces as close to the Martian atmosphere and gravity as possible. This could enable Nasa engineers to develop controllers that can react to the nature events or test flight controllers with sensor noise such as IMU, altimeter or Camera.
+
+## Structure
+
+Each folder is a ROS 2 package. Each package has their own README.md file explaining the APIs and usage examples.
+
+## Prerequisites
+
+- Docker
+- NVIDIA GPU (optional, but recommended for better performance)
+
+## Setup
+
+This project builds on `openrobotics/space_robots_demo` docker image. To build that docker image follow the instructions at this [README](https://github.com/space-ros/docker/blob/main/moveit2/README.md). To build that image, you also need to build the spaceros base image. You can access that [here](https://github.com/space-ros/space-ros).
+
+After ensuring you have the `openrobotics/space_robots_demo` docker image. Go ahead and clone this repo.
+
+1. Clone this repository:
+   ```bash
+   git clone [email protected]:BarisYazici/demos.git
+   git checkout feat/ingenuity-helicopter-simulation
+
+   ```
+
+2. Build the Ingenuity Flight Simulator image:
+   ```bash
+   cd ingenuity_flight_simulator
+   ./build.sh
+   ```
+
+## Running the Simulation
+
+First run the following to allow GUI passthrough:
+```bash
+xhost +local:docker
+```
+
+To start the simulation, run:
+```bash
+./run.sh
+```
+
+while the simulation is running in another terminal:
+
+```bash
+docker exec -it ingenuity_flight_simulator bash
+```
+
+to view all the topics coming from the simulator do:
+
+```bash
+ign topic -l
+```
+
+As an example you can subscribe to the /imu topic published from the ingenuity's body.
+
+```bash
+ign topic -et /imu
+```
+
+
+This will launch the Gazebo simulation with the Ingenuity model. Gazebo simulation GUI and RViz will pop up in new windows. By default, the Ingenuity's flight controller is activated and hovers the Martian helicopter to 10 meters of altitude.
+
+
+## Contribution to Simulation and Control of Ingenuity
+
+To control the ingenuity helicopter we need to change the angle of attack of the blade. There are two ways to change the angle of attack of the blades. First one is collective, this changes the angle of attack of the blades uniformly over the rotation of the blade. Collective control changes the altitude of the helicopter. Second way of control is cyclic control. This way we change the angle of attack interchangeably such that it creates different lift in different parts of the rotation. Cyclic control allows us to translate in x and y directions.
+
+Ingenuity flight controller plugin implements a PID controller to change the collective to reach the desired altitude published as a gazebo ignition topic. This controller doesn't yet control the attitude of the helicopter.
+
+
+## Demonstration
+
+Here are some GIFs demonstrating the Ingenuity in action:
+
+![Mars dust storm](assets/mars_dust_storm.gif)
+*Demonstrate mars dust storm*
+
+![Take-off](assets/altitude_control.gif)
+*Take-off *
+
+![Landing](assets/landing.gif)
+*Landing*
+
+![martian helicopter](assets/martian_helicopter.png)
+*Close up view of Ingenuity*
+
+![rviz visualization](assets/rviz.png)
+*RViz visualization integration*
+
+## Architecture
+
+
+Here's a diagram illustrating the architecture:
+
+```mermaid
+graph TD
+    A[User Input] -->|/alpha_c, /alpha_s| D[Flight Simulation Plugin]
+    A -->|/desired_altitude| C[Flight Control Plugin]
+    C -->|/angle_of_attack| D
+    D -->|Forces & Torques| E[Gazebo Physics Engine]
+    E -->|Physics Update| F[Ingenuity Model]
+    F -->|State Feedback| E
+    E -->|Model State| D
+    D -->|Telemetry| G[Visualization]
+    
+    subgraph Gazebo Simulation
+    E
+    F
+    end
+    
+    subgraph Gazebo Plugins
+    C
+    D
+    end
+    
+    classDef userInput fill:#f9f,stroke:#333,stroke-width:2px;
+    classDef gazebo fill:#cfc,stroke:#333,stroke-width:2px;
+    classDef spaceROS fill:#fcf,stroke:#333,stroke-width:2px;
+    classDef visualization fill:#ccf,stroke:#333,stroke-width:2px;
+    
+    class A userInput;
+    class E,F gazebo;
+    class C,D spaceROS;
+    class G visualization;
+```
+
+
+## License
+
+Apache License 2.0

ingenuity_mars_helicopter/assets/altitude_control.gif

@@ -0,0 +1 @@
+docker build -t ingenuity_flight_simulator .