https://github.com/julianneswinoga/flightgear-python
Interface package to the FlightGear flight simulation software aimed at simplicity
https://github.com/julianneswinoga/flightgear-python
flight-simulation flightgear interface python
Last synced: 4 months ago
JSON representation
Interface package to the FlightGear flight simulation software aimed at simplicity
- Host: GitHub
- URL: https://github.com/julianneswinoga/flightgear-python
- Owner: julianneswinoga
- License: mit
- Created: 2022-08-03T17:52:00.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2025-01-11T16:10:52.000Z (6 months ago)
- Last Synced: 2025-03-16T10:33:33.859Z (4 months ago)
- Topics: flight-simulation, flightgear, interface, python
- Language: Python
- Homepage:
- Size: 241 KB
- Stars: 27
- Watchers: 2
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# FlightGear Python Interface
[](https://flightgear-python.readthedocs.io/en/latest/?badge=latest)
[](https://circleci.com/gh/julianneswinoga/flightgear-python)
[](https://coveralls.io/github/julianneswinoga/flightgear-python?branch=master)
[](https://pypi.org/project/flightgear-python/)
[](https://pypistats.org/packages/flightgear-python)
`flightgear-python` is an interface package to the [FlightGear flight simulation software](https://www.flightgear.org/) aimed at simplicity.
Install: `pip3 install flightgear-python`
Don't know where to begin? Check out the [quick-start](https://flightgear-python.readthedocs.io/en/latest/quickstart.html) documentation.
Flight Dynamics Model (FDM) example, from `examples/simple_fdm.py`
```python
"""
Simple Flight Dynamics Model (FDM) example that makes the altitude increase and the plane roll in the air.
"""
import time
from flightgear_python.fg_if import FDMConnection
def fdm_callback(fdm_data, event_pipe):
if event_pipe.child_poll():
phi_rad_child, = event_pipe.child_recv() # unpack tuple
# set only the data that we need to
fdm_data['phi_rad'] = phi_rad_child # we can force our own values
fdm_data.alt_m = fdm_data.alt_m + 0.5 # or just make a relative change
return fdm_data # return the whole structure
"""
Start FlightGear with `--native-fdm=socket,out,30,localhost,5501,udp --native-fdm=socket,in,30,localhost,5502,udp`
(you probably also want `--fdm=null` and `--max-fps=30` to stop the simulation fighting with
these external commands)
"""
if __name__ == '__main__': # NOTE: This is REQUIRED on Windows!
fdm_conn = FDMConnection()
fdm_event_pipe = fdm_conn.connect_rx('localhost', 5501, fdm_callback)
fdm_conn.connect_tx('localhost', 5502)
fdm_conn.start() # Start the FDM RX/TX loop
phi_rad_parent = 0.0
while True:
phi_rad_parent += 0.1
# could also do `fdm_conn.event_pipe.parent_send` so you just need to pass around `fdm_conn`
fdm_event_pipe.parent_send((phi_rad_parent,)) # send tuple
time.sleep(0.5)
```
Supported interfaces:
- [x] [Native Protocol](https://wiki.flightgear.org/Property_Tree/Sockets) (currently only UDP)
- [x] Flight Dynamics Model ([`net_fdm.hxx`](https://sourceforge.net/p/flightgear/flightgear/ci/next/tree/src/Network/net_fdm.hxx)) version 24, 25
- [x] Controls ([`net_ctrls.hxx`](https://sourceforge.net/p/flightgear/flightgear/ci/next/tree/src/Network/net_ctrls.hxx)) version 27
- [x] GUI ([`net_gui.hxx`](https://sourceforge.net/p/flightgear/flightgear/ci/next/tree/src/Network/net_gui.hxx)) version 8
- [ ] [Generic Protocol](https://wiki.flightgear.org/Generic_protocol)
- [x] [Telnet](https://wiki.flightgear.org/Telnet_usage)
- [x] [HTTP](https://wiki.flightgear.org/Property_Tree_Servers)