AIML-Pupil-Detection

KO | EN

gitlite — search

#python #nodejs #javascript #java #docker #library #swift #arduino #aws #php #command-line #packer

AIML-Pupil-Detection

★ 40 Open GitHub ↗

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.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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

AIML-Pupil-Detection

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README