Skip to main content

Dynamic hand gesture detection library using ML.

Project description

HandGestureRec

Short Summary:

The library is open source https://github.com/AhmadBodayr/HandGestureRec

This is a dynamic hand gesture detection library, the user can interact with the library using a GUI built using Tkinter.

Implementation:

The library uses the webcam as the sensor and it gives the user access to the webcam using opencv, then the handlandmarks are collected using MediaPipe.

GUI:

The GUI is the main way for the user to interact with the toolkit. It is written in Tkinter for python wich is the default GUI library for Python. The GUI is simple and easy to use.

The Backend:

It is comprised of:

Data Collection:

The data collection is done using OpenCV and MediaPipe, each gesture is composed of 80 videos each is 30 frames, with each frame containing the 42 landmarks for each hand. Each landmark is an X, Y, Z tupple which describes the location of that specific landmark.

Data Storage Strategy:

No DBMS was used instead a folder tree which is composed of 3 submodules was built. The first submodule is a gestures folder that contains all the gestures defined by the user, the second is a datasets submodule which contains all the datasets created by the user. A single dataset is a non null subset of the gestures.

The machine learning algorithm:

The ML. model used is an LSTM model which was built using Tensorflow 2.X and the Keras ApI. for tensorFlow.

How to use:

install the library from $ pip using pip install HandGestureRecSiliconM1 and in your python project write at the terminal run

    1. The user define one or more gesture using the GUI. One gesture is to be defined at a time. The gesture is defined by giving it a name and pressing create gesture then OpenCV will give the user access to the webcam, 80 videos will be taken each is 30 frames in length so the user needs to do the gesture for 80 times. The starting time of each try of the 80 will be shown on the screen.
    1. After the user defines 1 or more gestures, he can then use the datasets submodule to create a dataset which will then serve as an input to the ML. model. To create a dataset the user have to give it a name and choose a subset of the gestures he defiend before hand then press create dataset.
    1. After having one or more datasets the user can then can to the models submodule to crerate a model to a specific dataset. There is a 1:1 relation between the datasets and the models meaning that every dataset can only contribute to only one model.
    1. After creating one or more models the user can test his models using the testing submodule.

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

HandGestureRec-0.1.5.tar.gz (9.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

HandGestureRec-0.1.5-py3-none-any.whl (12.2 kB view details)

Uploaded Python 3

File details

Details for the file HandGestureRec-0.1.5.tar.gz.

File metadata

  • Download URL: HandGestureRec-0.1.5.tar.gz
  • Upload date:
  • Size: 9.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.10

File hashes

Hashes for HandGestureRec-0.1.5.tar.gz
Algorithm Hash digest
SHA256 5d609383fbe041adc186c1bb7dd281431df678ffe8adbf68370b9170fe3abe78
MD5 af5af8ac86312ac28ce1107e26409ac9
BLAKE2b-256 2fde7e5eae8bbf6cf0af75906f41f47cc6c3c5b42afdcadb50506d500669640a

See more details on using hashes here.

File details

Details for the file HandGestureRec-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: HandGestureRec-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 12.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.10

File hashes

Hashes for HandGestureRec-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 d2504f1e207de1032a34db9de2fc2830daafc0df1d9b2c79be996f2b3fee5451
MD5 137df208f6321257fd43b7fc671a2565
BLAKE2b-256 ba1e71d54f424472cd5448f477ad8b36d39dd2ad12fbc0a1146ab1ccd590966d

See more details on using hashes here.

Supported by

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