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 details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file pteranodon-0.0.1.1.tar.gz.

File metadata

  • Download URL: pteranodon-0.0.1.1.tar.gz
  • Upload date:
  • Size: 62.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.6

File hashes

Hashes for pteranodon-0.0.1.1.tar.gz
Algorithm Hash digest
SHA256 e2642ae03e9c380005dba45771a0ffbaf32c371cf7a5b542d9a102ce61dc5444
MD5 3fdfbaa2df36cb0e1dae955eb4bd2b90
BLAKE2b-256 12049a8447e67e52c78a5cea41de25f5b5a3d0399f4aba9881bbe2199ad9982e

See more details on using hashes here.

File details

Details for the file pteranodon-0.0.1.1-py3-none-any.whl.

File metadata

  • Download URL: pteranodon-0.0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 87.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.6

File hashes

Hashes for pteranodon-0.0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 69695c9107d2c69ccf4912fd704203630d5ee46d01e88e28d91f84b993cb4c6f
MD5 c3c7d5306dc8d5af2c8338c0e011a454
BLAKE2b-256 3477f95475c8ec1cf7c233bd407f68b80c525aec1e11be91d0484b7389115ea0

See more details on using hashes here.

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