Lidia

Lightweight Instrument Display Interface for Aircraft

lidia is a Python package for serving an aircraft instruments panel as a web page.

Installation

Use the package manager pip to install lidia.

pip install lidia

Argument completion

Lidia uses argcomplete to provide shell completions for bash and zsh, which can be enabled like this:

pip install argcomplete
activate-global-python-argcomplete

Usage

lidia demo

# if your Scripts folder isn't in Path:
python3 -m lidia demo

# use other source
lidia rpctask

# show general help
lidia --help

# show help for a specific source
lidia demo --help

# pass the main server arguments before the source name
lidia -P 5556 demo

Then open the served page in a browser, by default localhost:5555. The controls for showing and hiding elements of the GUI are shown when hovering the mouse in the bottom left region of the page.

Support

Report problems in Codeberg Issues

Roadmap

• Set target state for marsh source using ATTITUDE_TARGET and POSITION_TARGET_GLOBAL_INT
• Additional PFD indicators: ILS, VOR on HSI
• CAS (Crew Alerting System) screen

Contributing

• Contributions should be made to the Codeberg repository
• Python code should be formatted with autopep8
• Other source files should be formatted with Prettier
• Install packages for development with pip install -r requirements.txt
• To properly run as a module without building and installing, cd into src/ and run python3 -m lidia
• APIs deprecated in previous versions, waiting to be changed in next major release are marked with @deprecated comment

Acknowledgements

This software was developed in Department of Aerospace Science and Technology of Politecnico di Milano.

Instrument graphics designed by Davide Marchesoli and Qiuyang Xia.

License

MIT