Skip to content

ldci/Face

Repository files navigation

Face

This the open source code used for the paper Lalauze-Pol R, Jouen F. Facial Growth in Children from 1 Month to 7 Years: A Biometric Approach by Image Processing. GSL J Pediatr. 2020; 1:105.

Required

First of all you need to install Red Language. Download a recent or the latest version (Automated builds, master branch). See Red Programming Language.

Face also uses redCV library which is included in redCV/libs directory.

Face software also requires python 3: python >= 3.8 .

Face software requires DLib c++ library for facial landmarks recognition and Python 3.

macOS and Linux users

In most cases, required python libraries are still installed.

For installing dlib for Python just do pip install dlib or pip3 install dlib in your terminal.

Windows users

Installation can be a little bit complicated with Windows.

You need to install cMake. Have a look here cmake install .

You can also need to install Visual Studio build tools from here.

In Visual Studio go to the Individual Components tab, Visual C++ Tools for Cmake, and check the checkbox under the "Compilers, build tools and runtimes" section. Then save the modifications.

If all is correct, pip install dlib should be sufficient for installing python dlib version.

Face Compilation

Modify in face.red, line 16 appDir: to-red-file rejoin [home "/Programmation/Red/Face/"] to adapt to your path

Compilation is very easy: just cd to the face-main directory and type red -c face.red. For Windows users, use WindowsPowerShell as terminal. In case of problems, type red -u -c face.red to upgrade runtime library.

Using Face

You must use command-line interface since Face uses a lot of directories related to the main application directory.

Open your terminal, change to Face application directory with cd and just type ./face.

Face processes 2-D images of faces for measuring facial heights, ratios and surfaces. You'll find in /publication directory, our paper which gives all details about the used method.

Basic Use

Load a source image e.g. /images/face1.png, and modify angle if necessary. Then save the modified image. This creates a copy of the source image, e.g. /images/face1C.png. Now you can detect the landmarks with DLib network and compute facial heights and surfaces.

You can also load an image as a processed image. Do not use the copy image file name, but the source image file name. The mapping betwen both images is automatic. Now you can find landmarks and compute values.

Computed values can be copied to an excel sheet: Classeur1.xlsx.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages