Skip to main content

Dynamic hand gesture detection library using ML.

Project description

HandGestureRec

Short Summary:

The library is an open source dynamic hand gesture recognition built using python with a Tkinter GUI and ML. using Tensorflow, Keras Api for TF, OpneCV for camera access and MediaPipe for hand landmarks detection https://github.com/AhmadBodayr/HandGestureRec

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.6.tar.gz (9.8 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.6-py3-none-any.whl (12.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: HandGestureRec-0.1.6.tar.gz
  • Upload date:
  • Size: 9.8 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.6.tar.gz
Algorithm Hash digest
SHA256 1b48bf7579dbc3a173ef27c15dbce7b207742c6e93f794bbb82addffd7a17227
MD5 936be95e5c1847ddf1088ae218c4f737
BLAKE2b-256 b6b53d84e929967cd95645f8c720a004fc1f914e629455385ced0bdeae74b261

See more details on using hashes here.

File details

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

File metadata

  • Download URL: HandGestureRec-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 12.7 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 7eec62b04b82223efbe28628ada4ce869a41450942b1930a7441b4cfb535fdcb
MD5 d7dcc0f059457fbe2ec3a2d434d79e25
BLAKE2b-256 1d10f7a6f9fe1e1beaf8aaf65f8ea6747729ccc8427ba006ff0a0c9ce9412840

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