Performs a crop of the periocular region of the face

This algorithm is a legacy one. The API has changed since its implementation. New versions and forks will need to be updated.
This algorithm is splittable

Algorithms have at least one input and one output. All algorithm endpoints are organized in groups. Groups are used by the platform to indicate which inputs and outputs are synchronized together. The first group is automatically synchronized with the channel defined by the block in which the algorithm is deployed.

Group: main

Endpoint Name Data Format Nature
image system/array_3d_uint8/1 Input
eye_centers system/eye_positions/1 Input
cropped_image system/array_2d_floats/1 Output

Parameters allow users to change the configuration of an algorithm when scheduling an experiment

Name Description Type Default Range/Choices
left-eye-x Final position of the left eye (x-coord) uint32 44
left-eye-y Final position of the left eye (y-coord) uint32 12
color Final color channel string gray gray, red, green, blue, ichrominance
crop-height Final image height uint32 25
crop-width Final image width uint32 58
right-eye-x Final position of the right eye (x-coord) uint32 11
right-eye-y Final position of the right eye (y-coord) uint32 12

The code for this algorithm in Python
The ruler at 80 columns indicate suggested POSIX line breaks (for readability).
The editor will automatically enlarge to accomodate the entirety of your input
Use keyboard shortcuts for search/replace and faster editing. For example, use Ctrl-F (PC) or Cmd-F (Mac) to search through this box

This algorithm performs the conversion of RGB images to: grayscale, red channel, green channel, blue channel or ichrominance of an image followed by a periocular cropping of the face, given the eye center coordinates.

The difference between this algorithm with the one published here ( is that for this one the output is system/array_2d_floats/1

The ichormiance conversion is the one implemented in [Lui2012] and is defined as follows:

I = 0.596*R − 0.275*G − 0.321*B, where R, G and B are respectively the red, green and blue channels.

This implementation relies on the `Bob <>`_ library.

The inputs are:

  • image: an RGB image as a three-dimensional array of uint8, the first dimension being the number of color planes (3), and the second and third dimensions corresponding to the height and width of the original image, respectively.
  • eye_centers: the coordinates of the eye centers in the original image space

The output cropped_image is a grayscale cropped image as a two-dimensional array of floats (64 bits).

[Lui2012]Lui, Yui Man, et al. "Preliminary studies on the good, the bad, and the ugly face recognition challenge problem." Computer Vision and Pattern Recognition Workshops (CVPRW), 2012 IEEE Computer Society Conference on. IEEE, 2012.

Docutils System Messages

System Message: ERROR/3 (<string>, line 12); backlink

Unknown target name: "bob &amp;amp;amp;lt;;amp;amp;gt;".


Updated Name Databases/Protocols Analyzers
smarcel/tpereira/full_isv_multi/2/btas2015_face-periocular_mobio-female_det mobio/1@female tutorial/eerhter_postperf_iso/1
tpereira/tpereira/full_isv/2/btas2015_periocular_mobio-female_det_bobv2-0 mobio/1@female tutorial/eerhter_postperf_iso/1
tpereira/tpereira/full_isv_multi/2/btas2015_face-periocular_cpqd-smartphone-male_det cpqd/1@smartphone_male tutorial/eerhter_postperf_iso/1
tpereira/tpereira/full_isv/2/btas2015_periocular_cpqd-smartphone-male_det cpqd/1@smartphone_male tutorial/eerhter_postperf_iso/1
tpereira/tpereira/full_isv_multi/2/btas2015_face-periocular_mobio-male_det mobio/1@male tutorial/eerhter_postperf_iso/1
tpereira/tpereira/full_isv/2/btas2015_periocular_mobio-male_det mobio/1@male tutorial/eerhter_postperf_iso/1
tpereira/tpereira/full_isv_multi/2/btas2015_face-periocular_cpqd-smartphone-female_det cpqd/1@smartphone_female tutorial/eerhter_postperf_iso/1
tpereira/tpereira/full_isv/2/btas2015_periocular_cpqd-smartphone-female_det cpqd/1@smartphone_female tutorial/eerhter_postperf_iso/1
tpereira/tpereira/full_isv_multi/2/btas2015_face-periocular_mobio-female_det mobio/1@female tutorial/eerhter_postperf_iso/1
tpereira/tpereira/full_isv/2/btas2015_periocular_mobio-female_det mobio/1@female tutorial/eerhter_postperf_iso/1

This table shows the number of times this algorithm has been successfully run using the given environment. Note this does not provide sufficient information to evaluate if the algorithm will run when submitted to different conditions.

Terms of Service | Contact Information | BEAT platform version 1.3.1rc1 | © Idiap Research Institute - 2013-2019