Originally developed by Jon S. Berndt and now maintained by the open-source community (used extensively by FlightGear and others), JSBSim is written in C++ but configured entirely via XML. This means you can design, tweak, and test a realistic aircraft’s behavior without recompiling a single line of code.
#include <FGFDMExec.h> using namespace JSBSim; int main() { FGFDMExec fdm; fdm.SetAircraftPath("aircraft/c172"); fdm.LoadScript("scripts/c1721.xml");
Introduction: Why JSBSim? In the world of flight simulation, the "physics engine" that dictates how an aircraft responds to control inputs, wind gusts, and atmospheric conditions is known as the Flight Dynamics Model (FDM). While many simulators rely on black-box, pre-compiled DLLs or lookup tables, JSBSim stands apart as an open-source, highly modular, and mathematically rigorous FDM. jsbsim tutorial
JSBSim --realtime --nice --logdir=output --script=scripts/c1723.xml Note: You need an external visualizer (like FlightGear or your own OpenGL app) to see the graphics. Navigate to aircraft/c172/ . The main file is c172.xml . Open it.
while (fdm.Run()) { double lat = fdm.GetProperty("position/lat-deg"); double lon = fdm.GetProperty("position/lon-deg"); double roll = fdm.GetProperty("attitude/roll-rad"); // Send these to your OpenGL/Unreal engine } return 0; } JSBSim exposes a property tree via Socket or HTTP . Enable the socket server in your script: Originally developed by Jon S
In c172.xml , find the <flight_control> section:
<?xml version="1.0"?> <runscript> <use aircraft="c172" initialization="reset"/> <run start="0" end="60" dt="0.01"> <property value="20.0"> simulation/sim-time-sec </property> <!-- Start at 20 sec --> <property value="140.0"> velocities/vc-kts </property> <!-- 140 knots --> <property value="0.1"> fcs/elevator-cmd-norm </property> <!-- Pull back slightly --> <!-- Define a landing at 40 seconds --> <event name="Flaps Down" time="40"> <set value="1.0"> fcs/flaps-cmd-norm </set> </event> </run> </runscript> #include <FGFDMExec
<flight_control name="C172 FCS"> <channel name="Pitch"> <summer name="Pitch Sum"> <input>fcs/elevator-cmd-norm</input> <!-- From joystick --> <input>fcs/pitch-trim-cmd-norm</input> <!-- Trim --> <clipto> -1 1 </clipto> </summer> <pure_gain name="Elevator Gain" gain="1.0"> <input>fcs/pitch-sum</input> <output>fcs/elevator-pos-rad</output> </pure_gain> </channel> </flight_control> The output fcs/elevator-pos-rad is then fed into the aerodynamic table for Cm (pitch moment). You don't just launch the aircraft; you launch a script . A script is an XML file that sets initial conditions and defines maneuvers.