Giter Club home page Giter Club logo

aircraft-physics's Introduction

Aircraft-Physics

Fixed wing aircraft physics for Unity. Based on paper by Khan and Nahon 2015.

W. Khan and M. Nahon, "Real-time modeling of agile fixed-wing UAV aerodynamics," 2015 International Conference on Unmanned Aircraft Systems (ICUAS), Denver, CO, 2015, pp. 1188-1195, doi: 10.1109/ICUAS.2015.7152411.

Video explaining the basics of how the system works.

Thumbnail

Getting started

To get started download the repo and open the project in Unity. Open the scene Cessna-172 in the folder Assets/Aircraft Physics/Example/Scenes. In this scene I set up a simple plane. You can try to fly it by hitting play and using instructions on the screen.

Note that this is not a fully realistic Cessna-172. The equations in Khan and Nahon 2015 result in about a 1.5 times more drag than measured for real Cessna. This is probably the result of me using the model outside of its range of applicability. Because of this reason I had to multiply the thrust of the real plane by 1.5. The other significant difference is in the position of the center of mass. Unity doesn't allow to set density to individual colliders, so the COM is way off.

Components

Let's see what components do we have on the Aircraft game object. First of all, there is a Rigidbody. Note that it has it's Drag and Angular Drag fields set to zero. Unity's built-in drag will mess up the physics of the plane. Though you can have a little bit of angular drag for extra stability, you don't need it.

The second component is AircraftPhysics. It applies aerodynamic forces and thrust to the Rigidbody. It exposes a field for the thrust force in newtons and a list of AeroSurfaces. This model computes the total force and torque acting on an airplane as a sum of impacts of separate parts, represented by the game objects with AeroSurface components. AeroSurface can be a wing, or a part of a wing, or a part of a tail etc. The rectangular gizmos represent all the AeroSurfaces that constitute this aircraft. The child object of Aircraft called Aerodynamics contains as its children a number of AeroSurfaces referenced in the list in AircraftPhysics.

Gizmos

The last component is AircraftController. It interacts with the AircraftPhysics and AeroSurfaces to apply control inputs to the plane. AircraftPhysics and AeroSurface are the core parts of the system and don't need to be changed most of the time. The AircraftController however is written as an example which you can expand upon.

The another important child of Aircraft called Collision has all the colliders which constitute the plane. For gears I use Unity's WheelCollider. It can be tricky to work with and quite unpredictable (though the same can probably be said about this system). You can change WheelCollider for something simpler and more robust.

AeroSurface

Let's take a look at the AeroSurface's inspector.

AeroSurface inspector

It has a reference to a AeroSurfaceConfig. It is a ScriptableObject that contains the aerodynamic parameters of the surface.

Parameter Description
Lift Slope Slope angle of the lift coefficient in low angle of attack mode
Skin Friction Determines how much drag the surface creates due to friction (note, that drag is also created due to lift)
Zero Lift AoA Angle of attack at which surface creates zero lift
Stall Angle High/Low Angles of attack at which stall starts
Chord Mean chord of the surface
Flap Fraction How much of the surface is movable as a control surface. Shown by the gizmo as an orange region
Span Length of the surface
Aspect Ratio Aspect Ratio. Can be calculated from the chord and span automatically or set manually for the surfaces which are a part of a longer one. For example the wings are made of two parts stacked next to each other, so the flaps and ailerons could be controlled separately. In this case the aspect ratio for the parts should be set manually as an aspect ratio of the whole wing.

Each AeroSurface with non zero Flap Fraction has a moving part, which deflection angle can be set by a SetFlapAngle method. Using them allows to implement control surfaces. AirplaneController has a list of AeroSurfaces marked as control surfaces. It sets their deflection angles according to their input type. As an example there are Pitch, Yaw, Roll and Flap types. Input multiplier is needed for the surfaces to react to the input in opposite directions (like ailerons).

Editor tools

The important part of constructing an aircraft is to understand the balance of it. This system has some rudimentary editor tools for that. First of all, it shows positions of the center of mass (COM, orange wire sphere) and the aerodynamic center (ADC, blue wire sphere). The latter is defined as a point of application of aerodynamic forces. Secondly, it shows force of gravity and combined aerodynamic forces (arrows pointing from the centers COM and ADC spheres). Lastly, it shows lift, drag and torque acting on each surface as blue, red and green arrows.

The scriptable object AircraftPhysicsDisplaySettings in the Core/Config folder allows to change the appearance of this gizmos. You can also choose angle of attack, airspeed and air density for which forces are calculated in Edit mode.

Display settings

aircraft-physics's People

Contributors

gasgiant avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.