lukezsmith / YawPy

A Python 3D graphics engine which provides real-time 3D model outputs based on IMU data.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

YawPy

YawPy is a Python 3D graphics engine which provides real-time 3D model outputs based on IMU data.

YawPy

The engine consists of three types of complimentary filtering modes:

  1. Dead-Reckoning Mode: Basic filtering with gyroscope data.
  2. Dead-Reckoning w/ Accellerometer Mode: Dead-reckoning filter enhanced with accellerometer data.
  3. Dead-Reckoning w/ Accellerometer & Magnetometer Mode: Dead-reckoning filter enhanced with accellerometer and magnetometer data.

YawPy is an extension of the open source RenderPy.

Installation & Setup

1.1 - Downloading YawPy:

Clone the repository by running git clone https://github.com/lukezsmith/YawPy.git in terminal or download the zip.

1.2 - Installation:

Install dependencies by running pip3 install -r requirements.txt in terminal.

1.3 - Running YawPy:

YawPy requires the following arguments to be passed to the render.py script:

  1. IMU Data Path: String
  2. Model Data Path: String
  3. 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>

Dependencies

All dependencies are listed in requirements.txt

About

A Python 3D graphics engine which provides real-time 3D model outputs based on IMU data.

License:MIT License


Languages

Language:Python 100.0%