{"id":13651856,"url":"https://github.com/JSBSim-Team/jsbsim","last_synced_at":"2025-04-22T22:32:27.947Z","repository":{"id":38710785,"uuid":"114565720","full_name":"JSBSim-Team/jsbsim","owner":"JSBSim-Team","description":"An open source flight dynamics \u0026 control software library","archived":false,"fork":false,"pushed_at":"2025-04-21T12:02:47.000Z","size":52408,"stargazers_count":1540,"open_issues_count":43,"forks_count":487,"subscribers_count":56,"default_branch":"master","last_synced_at":"2025-04-21T13:23:13.054Z","etag":null,"topics":["aerospace-engineering","aircraft","aircraft-control","aircraft-design","flight-dynamics","flight-simulation","jsbsim","matlab","python","simulation","unreal-engine-plugin"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JSBSim-Team.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-12-17T20:18:32.000Z","updated_at":"2025-04-21T12:48:21.000Z","dependencies_parsed_at":"2023-02-19T01:15:37.667Z","dependency_job_id":"babaff6a-7dd3-4b41-b0d2-d188105ff179","html_url":"https://github.com/JSBSim-Team/jsbsim","commit_stats":{"total_commits":5458,"total_committers":58,"mean_commits":94.10344827586206,"dds":0.6381458409673872,"last_synced_commit":"6f0c4d805c499cf18280bcf8d7af358aee494876"},"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JSBSim-Team%2Fjsbsim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JSBSim-Team%2Fjsbsim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JSBSim-Team%2Fjsbsim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JSBSim-Team%2Fjsbsim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JSBSim-Team","download_url":"https://codeload.github.com/JSBSim-Team/jsbsim/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250334116,"owners_count":21413513,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aerospace-engineering","aircraft","aircraft-control","aircraft-design","flight-dynamics","flight-simulation","jsbsim","matlab","python","simulation","unreal-engine-plugin"],"created_at":"2024-08-02T02:00:52.952Z","updated_at":"2025-04-22T22:32:27.938Z","avatar_url":"https://github.com/JSBSim-Team.png","language":"C++","readme":"[![C/C++ build](https://github.com/JSBSim-Team/jsbsim/workflows/C/C++%20build/badge.svg?branch=master\u0026event=push)](https://github.com/bcoconni/jsbsim/actions?query=workflow%3A%22C%2FC%2B%2B+build%22)\n[![PyPI](https://img.shields.io/pypi/v/jsbsim)](https://pypi.org/project/JSBSim)\n[![Conda (channel only)](https://img.shields.io/conda/vn/conda-forge/jsbsim)](https://anaconda.org/conda-forge/jsbsim)\n[![PyPI Downloads](https://static.pepy.tech/personalized-badge/jsbsim?period=total\u0026units=international_system\u0026left_color=grey\u0026right_color=blue\u0026left_text=pypi%20downloads)](https://pepy.tech/project/jsbsim)\n[![Downloads GitHub](https://img.shields.io/github/downloads/JSBSim-Team/jsbsim/total?label=Downloads%20GitHub)](https://github.com/JSBSim-Team/jsbsim/releases)\n[![Downloads SourceForge](https://img.shields.io/sourceforge/dt/jsbsim?label=Downloads%20SourceForge)](https://sourceforge.net/projects/jsbsim/files/)\n\n\u003cp align=\"center\"\u003e\n\u003cimg width=\"250\" heigth=\"250\" src=\"https://github.com/JSBSim-Team/jsbsim-logo/blob/master/logo_JSBSIM_globe.png\"\u003e\n\u003c/p\u003e\n\n# Introduction\n\nJSBSim is a multi-platform, general purpose object-oriented Flight Dynamics Model (FDM) written in C++. The FDM is essentially the physics \u0026 math model that defines the movement of an aircraft, rocket, etc., under the forces and moments applied to it using the various control mechanisms and from the forces of nature. JSBSim can be run in a standalone batch mode flight simulator (no graphical displays a.k.a. console mode) for testing and study, or integrated with the [Unreal engine](https://www.unrealengine.com), [FlightGear](https://www.flightgear.org/) and many other simulation environments.\n\nFeatures include:\n\n* Nonlinear 6 DoF (Degree of Freedom)\n* Fully configurable flight control system, aerodynamics, propulsion, landing gear arrangement, etc. through XML-based text file format.\n* Accurate Earth model including:\n  * Rotational effects on the equations of motion (Coriolis and centrifugal acceleration modeled).\n  * Oblate spherical shape and geodetic coordinates according to the [WGS84 geodetic system](https://en.wikipedia.org/wiki/World_Geodetic_System).\n  * Atmosphere modeled according to the [International Standard Atmosphere (1976)](https://ntrs.nasa.gov/archive/nasa/casi.ntrs.nasa.gov/19770009539.pdf).\n* Configurable data output formats to screen, file, socket, or any combination of those.\n\nJSBSim also includes the following bindings:\n\n* A [Python](https://www.python.org) module which provides the exact same features as the C++ library\n* A [Matlab S-Function](https://github.com/JSBSim-Team/jsbsim/blob/master/matlab) that interfaces JSBSim with [MATLAB Simulink](https://fr.mathworks.com/products/simulink.html).\n* An [Unreal Engine plugin](https://github.com/JSBSim-Team/jsbsim/blob/master/UnrealEngine/) to build a connection between the flight dynamics model from JSBSim and the entire virtual environment provided by [Unreal engine](https://www.unrealengine.com).\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"UnrealEngine/UEReferenceApp.png\"\u003e\n\u003c/p\u003e\n\nIn 2015, [NASA performed some verification check cases on 7 flight dynamics software **including JSBSim**](https://nescacademy.nasa.gov/flightsim) (the other 6 being NASA in-house software). The results showed that the 7 simulation tools *\"were good enough to indicate agreement between a majority of simulation tools for all cases published. Most of the remaining differences are explained and could be reduced with further effort.\"*\n\n## Applications and Usages\n\nJSBSim is used in a range of projects among which:\n\n* Unreal Engine's [Antoinette Project](https://www.unrealengine.com/en-US/blog/antoinette-project-tools-to-create-the-next-generation-of-flight-simulators): tools to create the next generation of flight simulators.\n* Flight simulation: [FlightGear](http://www.flightgear.org), [OutTerra](https://www.outerra.com/wfeatures.html), [Skybolt Engine](https://github.com/Piraxus/Skybolt)\n* SITL (Software In The Loop) Drone Autopilot testing : [ArduPilot](https://ardupilot.org/dev/docs/sitl-with-jsbsim.html), [PX4 Autopilot](https://dev.px4.io/master/en/simulation/jsbsim.html), [Paparazzi](https://wiki.paparazziuav.org/wiki/Simulation)\n* Machine Learning Aircraft control: [gym-jsbsim](https://github.com/galleon/gym-jsbsim)\n* [DARPA Virtual Air Combat Competition](https://www.darpa.mil/news-events/2019-10-21) where one of the AI went undefeated in five rounds of mock air combat against an Air Force fighter (see the [video on YouTube](https://www.youtube.com/watch?v=IOJhgC1ksNU)).\n\n## Academic and Industry Research\n\nJSBSim is also used in academic and industry research ([more than 700 citations referenced by Google Scholar](https://scholar.google.com/scholar?\u0026q=jsbsim) as of May 2023).\n\nIn 2023 JSBSim was featured in the article [\"A deep reinforcement learning control approach for high-performance aircraft\"](https://link.springer.com/article/10.1007/s11071-023-08725-y) , by De Marco et al. (2023), _Nonlinear Dynamics_, an International Journal of Nonlinear Dynamics and Chaos in Engineering Systems by Springer (doi: 10.1007/s11071-023-08725-y). The open-access article is available as a PDF here [https://link.springer.com/content/pdf/10.1007/s11071-023-08725-y.pdf](https://link.springer.com/content/pdf/10.1007/s11071-023-08725-y.pdf). The work demonstrates an application of Deep Reinforcement Learning (DRL) to flight control and guidance, leveraging the JSBSim interface to MATLAB/Simulink.\n\nAnother more advanced application within the field of Deep Reinforcement Learning is presented in the article [\"Hierarchical Reinforcement Learning for Air Combat at DARPA's AlphaDogfight Trials\"](https://ieeexplore.ieee.org/document/9950612) by A. P. Pope et al. (2023), _IEEE Transactions on Artificial Intelligence_ (doi: 10.1109/TAI.2022.3222143), featuring a hierarchical reinforcement learning approach. The trained agent was designed alongside of and competed against active fighter pilots, and ultimately defeated a graduate of the United States Air Force's F-16 Weapons Instructor Course in match play. See also the [DARPA Virtual Air Combat Competition](https://www.darpa.mil/news-events/2019-10-21).\n\n# User Guide\n\n## Installation\n\n### Windows\n\nA Windows installer `JSBSim-1.2.2-setup.exe` is available in the [release section](https://github.com/JSBSim-Team/jsbsim/releases/tag/v1.2.2). It installs the 2 executables along with aircraft data and some example scripts:\n\n* `JSBSim.exe` which runs FDM simulations.\n* `aeromatic.exe` which builds aircraft definitions from Question/Answer interface\n\nBoth executables are console line commands.\n\nThe Windows installer also contains the files needed to build the JSBSim Matlab S-Function (see [our MATLAB README](matlab/README.md) for more details about using JSBSim in Matlab).\n\n### Ubuntu Linux\n\nDebian packages for Ubuntu Linux \"Jammy\" 22.04 LTS and \"Noble\" 24.04 LTS for 64 bits platforms are also available in the [JSBSim project release section](https://github.com/JSBSim-Team/jsbsim/releases/tag/v1.2.2). There are 3 packages for each platform:\n\n* `JSBSim_1.2.2-1471.amd64.deb` which installs the executables `JSBSim` and `aeromatic`\n* `JSBSim-devel_1.2.2-1471.amd64.deb` which installs the development resources (headers and libraries)\n* `python3-JSBSim_1.2.2-1471.amd64.deb` which installs the Python module of JSBSim\n\n### Python module\n\nJSBSim provides binary wheel packages for its Python module on Windows, Mac OSX and Linux platforms for several Python versions (3.9, 3.10, 3.11, 3.12 and 3.13). These can be installed using either `pip` or `conda`.\n\n#### Installation with `pip`\n\nBinary packages a.k.a. [wheel packages](https://www.python.org/dev/peps/pep-0427) are available from the [Python Package Index (PyPI)](https://pypi.org), a repository of software for the Python programming language.\n\nInstalling `jsbsim` using `pip` can be achieved with:\n\n```bash\n\u003e pip install jsbsim\n```\n\nCheck the [pip documentation](https://packaging.python.org/tutorials/installing-packages) for more details.\n\nNote that wheel packages for Linux meet the [PEP600 ManyLinux packages requirements](https://www.python.org/dev/peps/pep-0600) and as such are compatible with a majority of Linux distributions.\n\n#### Installation with `conda`\n\n[Conda](https://docs.conda.io/projects/conda/en/latest/index.html) is an open-source package management system and environment management system that runs on Windows, macOS, and Linux. The JSBSim conda package is available from [`conda-forge`](https://conda-forge.org), a community led collection of recipes, build infrastructure and distributions for the conda package manager.\n\nInstalling `jsbsim` from the `conda-forge` channel can be achieved by adding `conda-forge` to your channels with:\n\n```bash\n\u003e conda config --add channels conda-forge\n```\n\nOnce the `conda-forge` channel has been enabled, `jsbsim` can be installed with:\n\n```bash\n\u003e conda install jsbsim\n```\n\nIt is possible to list all of the versions of `jsbsim` available on your platform with:\n\n```bash\n\u003e conda search jsbsim --channel conda-forge\n```\n\n### Other platforms\n\nAt the moment, JSBSim does not provide binaries for platforms other than Windows 64 bits and Ubuntu 64 bits. Alternatively, you can use [JSBSim wheel packages](https://github.com/bcoconni/jsbsim#python-module) for Windows, Linux or MacOS. Otherwise you should follow the instructions in the [developer docs](doc/DevelopersDocs.md) to build JSBSim on your platform.\n\n### Aircraft data and example scripts\n\nJSBSim aircraft data and example scripts are automatically installed if you are using [Python wheel packages](https://github.com/bcoconni/jsbsim#python-module). Otherwise, you can get aircraft data and example scripts by downloading either the [zip package](https://github.com/JSBSim-Team/jsbsim/archive/v1.2.2.zip) or the [tar.gz package](https://github.com/JSBSim-Team/jsbsim/archive/v1.2.2.tar.gz).\n\n## Quick start\n\nOnce you have downloaded (or built) the binaries and unzipped the [aircraft data](#aircraft-data-and-example-scripts). Go to the root of the data package and make sure the executable is accessible from there.\n\nYou can then run an FDM simulation with the following command:\n\n```bash\n\u003e JSBSim.exe --script=scripts/c1721.xml\n```\n\nMore options are available if you run:\n\n```bash\n\u003e JSBSim.exe --help\n```\n\n## User documentation\n\nA first place to look at for JSBSim documentation resources is \u003chttps://jsbsim.sourceforge.net/documentation.html\u003e. This link points to the official [JSBSim Reference Manual](https://jsbsim.sourceforge.net/JSBSimReferenceManual.pdf), a PDF which is the best source of information for users and developers.\n\nHowever, due to the nature of the development of the project (JSBSim sources are updated often, sometimes even daily), several new features that are available in the software are not yet documented in the reference manual. Starting from March 2018 a new effort is underway to deliver an up-to-date documentation web site. You can browse the new *JSBSim Online Reference Manual* by going to: [https://jsbsim-team.github.io/jsbsim-reference-manual](https://jsbsim-team.github.io/jsbsim-reference-manual). The online manual is under construction and as a first milestone it will incorporate all the non-outdated material contained in the original PDF Reference Manual. The online manual web site is based on the GitHub Pages technology and its sources are available [here](https://github.com/JSBSim-Team/jsbsim-reference-manual). Eventually, the PDF Reference Manual will be superseded by the online manual, which is designed to be updated collaboratively as well as in efficient and timely fashion.\n\n## Interfacing JSBSim with your application\n\n### Using the C++ API\n\nJSBSim can be interfaced or integrated to your application via a C++ API. The following code illustrates how JSBSim can be called by a small program, with execution being controlled by a script:\n\n```c++\n#include \u003cFGFDMExec.h\u003e\n\nint main(int argc, char **argv)\n{\n  JSBSim::FGFDMExec FDMExec;\n  FDMExec.LoadScript(SGPath(argv[1]));\n  FDMExec.RunIC();\n  bool result = true;\n  while (result) result = FDMExec.Run();\n}\n ```\n\nThe API is described in more details in the [C++ API documentation](doc/DevelopersDocs.md#c-api-documentation)\n\n### Using the Python module\n\nJSBSim can also be used as a Python module. JSBSim Python wheels are provided with the proverbial \"batteries included\" i.e. with some default aircraft data and example scripts.\n\nThe following code provides a simple example of how to interface with JSBSim using the Python programming language:\n\n```python\nimport jsbsim\n\nfdm = jsbsim.FGFDMExec(None)  # Use JSBSim default aircraft data.\nfdm.load_script('scripts/c1723.xml')\nfdm.run_ic()\n\nwhile fdm.run():\n  pass\n```\n\nProviding `jsbsim.FGFDMExec` with the value `None` allows using the installed default aircraft data and scripts (in the example above we are using the script `scripts/c1723.xml`, one of the many scripts installed by default).\n\nThe default aircraft data is located in a directory which path can be retrieved with the function `get_default_root_dir()`:\n\n```python\nprint(jsbsim.get_default_root_dir())\n```\n\nA more elaborate example of Python code is [JSBSim.py](https://github.com/JSBSim-Team/jsbsim/blob/master/python/JSBSim.py), the Python equivalent to `JSBSim.exe`.\n\n# Contributing Source Code Changes\n\nIf you would like to contribute source code changes please take a look at the [Contributing Source Code Changes to JSBSim](https://github.com/JSBSim-Team/jsbsim/wiki/Contributing-Source-Code-Changes-to-JSBSim) Wiki page for instructions on how to go about contributing.\n\n# Contact\n\nFor more information about JSBSim, you can contact the development team on [GitHub discussion](https://github.com/JSBSim-Team/jsbsim/discussions) or submit tickets on \u003chttps://github.com/JSBSim-Team/jsbsim/issues\u003e\n\nWe are also on Facebook: \u003chttps://www.facebook.com/jsbsim/\u003e\n\n# Legal Notice\n\nThe JSBSim library is open source and is licensed under the [LGPL 2.1 license](https://opensource.org/licenses/LGPL-2.1). The license is included in the source code file [COPYING](https://github.com/JSBSim-Team/jsbsim/blob/master/COPYING).\n\nThe Unreal Engine Reference Application for JSBSim is open source and is licensed under the [MIT license](https://opensource.org/licenses/MIT). The license is included in the source code file [UnrealEngine/LICENSE.txt](https://github.com/JSBSim-Team/jsbsim/blob/master/UnrealEngine/LICENSE.txt).\n\nThe JSBSim interface with MATLAB including the S-Function is open source and is licensed under the [BSD license](https://opensource.org/licenses/bsd-license.php). The license is included in the source code file [matlab/LICENSE.txt](https://github.com/JSBSim-Team/jsbsim/blob/master/matlab/LICENSE.txt).\n\nThe Python module of JSBSim is open source and is licensed under the [LGPL 2.1 license](https://opensource.org/licenses/LGPL-2.1). The license is included in the source code file [COPYING](https://github.com/JSBSim-Team/jsbsim/blob/master/COPYING).\n\nNo proprietary code is included. All code included within the JSBSim project has been developed on a volunteer basis using publicly available information, and is often directly linked to a particular textbook, for educational reference. In some cases, code of a generic nature has been donated back to the project.\n\nLikewise, the aircraft models included in this project and distribution do not include any proprietary, sensitive, or classified data. All data is derived from textbooks (such as Stevens and Lewis \"Aircraft Control and Simulation\" and Sutton's \"Rocket Propulsion Elements\"), freely available technical reports (see: \u003chttps://ntrs.nasa.gov\u003e and \u003chttps://www.aiaa.org\u003e), or other public data (such as the FAA web site). Aircraft models included in the JSBSim distribution and with names corresponding to existing commercial or military aircraft are approximations crafted using publicly available information, and are for educational or entertainment uses only.\n","funding_links":[],"categories":["Security \u0026 Safety 🪂"],"sub_categories":["Simulators 🌐"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FJSBSim-Team%2Fjsbsim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FJSBSim-Team%2Fjsbsim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FJSBSim-Team%2Fjsbsim/lists"}