Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/weblineindia/aiml-pupil-detection
The Pupil Detection AI ML program is used to get the co-ordinates of eyes and detect the pupil region. It only works with human face images.
https://github.com/weblineindia/aiml-pupil-detection
ai-ml aiml aiml-pupil-detection artificial-intelligence artificial-intelligence-algorithms dlib dlib-face-detection dlib-face-recognition eye-corner-points eye-detection eye-detection-using-opencv face-detection face-detection-using-opencv houghcircles machine-learning opencv opencv-library opencv-python pupil-detection python
Last synced: about 1 month ago
JSON representation
The Pupil Detection AI ML program is used to get the co-ordinates of eyes and detect the pupil region. It only works with human face images.
- Host: GitHub
- URL: https://github.com/weblineindia/aiml-pupil-detection
- Owner: weblineindia
- License: mit
- Created: 2020-07-03T08:25:12.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-12-27T07:55:47.000Z (12 months ago)
- Last Synced: 2023-12-27T08:40:08.447Z (12 months ago)
- Topics: ai-ml, aiml, aiml-pupil-detection, artificial-intelligence, artificial-intelligence-algorithms, dlib, dlib-face-detection, dlib-face-recognition, eye-corner-points, eye-detection, eye-detection-using-opencv, face-detection, face-detection-using-opencv, houghcircles, machine-learning, opencv, opencv-library, opencv-python, pupil-detection, python
- Language: Python
- Homepage: https://www.weblineindia.com/communities.html
- Size: 94 MB
- Stars: 21
- Watchers: 3
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Pupil Detection using Dlib face landmark detector
The code is used to get the co-ordinates of eyes and detect the pupil region accurately.
It works with human face images. Dlib's facial landmark detector is used for extracting the coordinates from the eye region.
The eye corner points are collected and it check for dark colored region between the detected eye corner points of each eye.
It uses OpenCV's houghcircles for detecting circle in a gray scaled image. Thus the pupil is calculated as the midpoint of the circle.
## Table of contents
- [Getting started](#getting-started)
- [Installation](#installation)
- [Features](#features)
- [Usage](#usage)
- [Results](#results)
- [Want to Contribute?](#want-to-contribute)
- [Need Help / Support?](#need-help)
- [Collection of Other Components](#collection-of-components)
- [Changelog](#changelog)
- [Credits](#credits)
- [License](#license)
- [Keywords](#Keywords)
## Getting started
Prerequisites for running the code are:
- Python = 3.5
- python-opencv = 4.2.0
We have tested our program in above version, however you can use it in other versions as well.
## Installation
From terminal run this
```
pip install numpy
pip install imutils
pip install scikit-image
pip install argparse
pip install opencv-python
pip install opencv-contrib-python
```
## dlib installation for ubuntu
### Step:1
pip install dlib
If above command doesn't work then follow below steps
### Step:2 Install system dependencies
sudo apt-get install -y --fix-missing \
build-essential \
cmake \
gfortran \
git \
wget \
curl \
graphicsmagick \
libgraphicsmagick1-dev \
libatlas-dev \
libavcodec-dev \
libavformat-dev \
libgtk2.0-dev \
libjpeg-dev \
liblapack-dev \
libswscale-dev \
pkg-config \
python3-dev \
python3-numpy \
software-properties-common \
zip \
&& apt-get clean && rm -rf /tmp/* /var/tmp/*
### Step:3 Clone dlib
git clone -b 'v19.9' --single-branch https://github.com/davisking/dlib.git
cd dlib
### Step:4
Run below command if system supports AVX instructions
```
sudo python setup.py install --yes USE_AVX_INSTRUCTIONS
```
Or
```
sudo pyhton setup.py install
```
## Features
- Accurately detects the eye pupil on human face.
- HoughCircles is used to detect circles.
## Usage
Inside the project directory run:
```
python pupil_detection.py -i path-to-directory-of-input-images -o path-to-output-directory
```
You can find sample images in image folder and result images in output folder.
### Results
## Want to Contribute?
- Created something awesome, made this code better, added some functionality, or whatever (this is the hardest part).
- [Fork it](http://help.github.com/forking/).
- Create new branch to contribute your changes.
- Commit all your changes to your branch.
- Submit a [pull request](http://help.github.com/pull-requests/).
-----
## Need Help?
We also provide a free, basic support for all users who want to use this AI ML based pupil detection techniques for their projects. In case you want to customize this Pupil detection technique for your development needs, then feel free to contact our [AI ML developers](https://www.weblineindia.com/ai-ml-dl-development.html).
-----
## Collection of Components
We have built many other components and free resources for software development in various programming languages. Kindly click here to view our [Free Resources for Software Development](https://www.weblineindia.com/communities.html).
------
## Changelog
Detailed changes for each release are documented in [CHANGELOG.md](./CHANGELOG.md).
## Credits
Refered dlib face detection lib [Dlib](http://dlib.net/python/index.html).
## License
[MIT](LICENSE)
[mit]: https://github.com/miguelmota/is-valid-domain/blob/e48e90f3ecd55431bbdba950eea013c2072d2fac/LICENSE
## Keywords
Pupil-detection, face-detection, eye-detection, opencv-image-processing, dlib, HoughCircles, artificial-intelligence, machine-learning, ai-ml