YawPy is a Python 3D graphics engine which provides real-time 3D model outputs based on IMU data.
The engine consists of three types of complimentary filtering modes:
- Dead-Reckoning Mode: Basic filtering with gyroscope data.
- Dead-Reckoning w/ Accellerometer Mode: Dead-reckoning filter enhanced with accellerometer data.
- Dead-Reckoning w/ Accellerometer & Magnetometer Mode: Dead-reckoning filter enhanced with accellerometer and magnetometer data.
YawPy is an extension of the open source RenderPy.
Clone the repository by running git clone https://github.com/lukezsmith/YawPy.git
in terminal or download the zip.
Install dependencies by running pip3 install -r requirements.txt
in terminal.
YawPy requires the following arguments to be passed to the render.py
script:
- IMU Data Path: String
- Model Data Path: String
- Filter Mode: Integer (1 = Simple Dead-Reckoning, 2 = Dead-Reckoning w/ accelerometer, 3 = Dead-Reckoning w/ accelerometer & magnetometer)
To run YawPy execute python3 render.py <data-path> <model-path> <filter-mode>
All dependencies are listed in requirements.txt