Skip to main content

Full compatible drone library to automate computer vision algorithms on parrot drones.

Project description

CI Documentation Status coverage report codestyle Version

DroneVision

Drone Vision (DroneVis) is a full compatible drone library to automate computer vision algorithms on parrot drones. You can read a detailed documentation of Drone Vision docs.

DroneVis is a cutting-edge drone software library that has been specifically designed for use with the AR. Drone. It has been extensively tested both indoors and outdoors, and offers a wide range of features including adaptability in connecting to the drone, advanced computer vision algorithms, and 3 user-friendly interfaces. This makes it easy for users to take full advantage of the drone's capabilities and control it with simple commands. All of the implemented real-time data, inference, and detection achieve a minimum fps >= 4.5 on an Intel core 8 CPU.

Features

  • Unified state-of-the art computer vision algoritms
  • Full control over the drone
  • PEP8 compliant (unified code style)
  • Documented functions and classes
  • Tests, high code coverage and type hints
  • Clean code
  • Multiple implementations for the same models
  • Logger with timestamps
  • Three UI for easier usage (GUI, CLI, Gesture Recognition)

Computer Vision Models

You provide a wide variety of 20+ computer vision and recommends users to the best models in terms of accuracy and speed, whilst giving users the chance to use any model of their choice.

Drone Control

  • Right ➡️, Left :arrow_left:
  • Up ⬆️, Down :arrow_down:
  • Forward ▶️, Backward ◀️
  • Takeoff 🚀, Land 🛬
  • Reset 🔄, Emergency 🚨
  • Rotate Left ↩️ /Right :arrow_right_hook:
  • Hover 🔍, Calibrate 🔧
  • Camera Stream 📹/Record ⏺️
  • Hand Gesture Control 🖌️

How to Install

Install PyTorch You should consider installing the version of Pytorch that corresponds to your cuda version.

You start controling your drone now with just two commands:

pip install dronevis # install the library 
dronevis-gui # run library GUI

Press the start button to start a demo drone simulation, and run your favourite algorithms with the stream button.

You can control your drone with our CLI:

dronevis

Getting Started

Dronevis is built with multiple modes for customizibility. You can view all the options for either runnning our GUI or CLI as follows:

dronevis --help

The default mode for running either the CLI or the GUI is the demo mode. You can alter the mode by providing "real" to --drone argument.

dronevis --drone=real # cli real drone mode

or for GUI,

dronevis-gui --drone=real # gui real drone mode

Documentation

Dronevis is developed with an extensive documentation for easier user contributions. You can check our full documentation in here to go more in-depth of how the library is structure and how to contribute your favourite model.

Citing the Project

To cite this repository:

@software{drone-vis,
  author  = {Ahmed Heakl, Fatma Youssef, Abdallah-Elbarkokry},
  title   = {Dronevis: Full compatible drone library to automate computer vision algorithms on parrot drones},
  year    = {2023},
  url     = {github.com/ahmedheakl/drone-vis},
  version = {1.3.0}
}

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

dronevis-1.3.0.tar.gz (74.4 kB view hashes)

Uploaded Source

Built Distribution

dronevis-1.3.0-py3-none-any.whl (96.2 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