Skip to main content

A framework to built on top of MAVSDK which provides physical/virtual drone abstraction, abstraction for all async calls, gives the end users an arduino-eqsue interface, and provides movement and utility methods based on relative coordinate systems

Project description

Pteranadon

drawing

Formatting Unit Tests Integration Tests PyPI Build

A framework to built on top of MAVSDK which provides physical/virtual drone abstraction, abstraction for all async calls, gives the end users an arduino-eqsue interface, and provides movement and utility methods based on relative coordinate systems.


Requirements for Use

  • python 3.8+
  • PX4_Autopilot (either local or remote)
  • mavsdk>=1.4.0
  • numpy>=1.23.0
  • pymavlink>=2.4.37
  • grpcio>=1.47.0
  • pyserial>=3.5
  • Additional requirements needed for code in the implementations module

Platform Compatibility

Ubuntu (Most Supported)

  • Supported for development and visual simulation
  • Gazebo simulator (non-headless) requires Ubuntu
  • PX4 has wider compatibility between Unix systems including Ubuntu

Windows/WSL (Supported)

  • Supported for development and visual simulation
  • WSL Ubuntu 20.0.4 container
  • Gazebo simulator's window can be passed through
  • PX4 compatible

macOS (Least Supported)

  • Supported for development and headless simulation
  • PX4 Gazebo Headless Docker container allows for the running of the PX4 drone in the background.
  • Gazebo visualization in docker with X-server forwarding is possible, but not successfully reproduced yet.

Project Installation

pip install pteranodon

Installation from source

  1. Download pteranodon source code using git:
    • git clone https://github.com/Autonolab/pteranodon.git
  2. Run the build target from the Makefile:
    • cd pteranodon
    • make build

Usage

For more information on the setup and usage of pteranodon, please refer to USAGE.md

Running Simulations

For more information on the usage of pteranodon in simulations environments, please refer to SIMULATION.md

Contributing

Welcome and thank you very much for your contribution. For the process of submitting PR, please refer to CONTRIBUTING.md

Contributors

This project exists thanks to all the people who contribute. Contribute.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pteranodon-0.0.1.1.tar.gz (62.3 MB view hashes)

Uploaded Source

Built Distribution

pteranodon-0.0.1.1-py3-none-any.whl (87.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page