org.openimaj.image.processing.face.detection

Class DatasetFaceDetector

java.lang.Object

org.openimaj.image.processing.face.detection.DatasetFaceDetector

public class DatasetFaceDetector
extends Object

Convenience methods for dealing with face detections in datasets and lists of images.

Author:

Jonathon Hare (jsh2@ecs.soton.ac.uk)

Method Summary

Modifier and Type	Method and Description
static <FACE extends DetectedFace> FACE	getBiggest(List<FACE> faces) Get the biggest face (by area) from the list
static <PERSON,IMAGE extends Image<?,IMAGE>,FACE extends DetectedFace> GroupedDataset<PERSON,ListDataset<FACE>,FACE>	process(GroupedDataset<PERSON,? extends ListDataset<IMAGE>,IMAGE> input, FaceDetector<FACE,IMAGE> detector) Apply a face detector to all the images in the given dataset, choosing only the biggest face if multiple are found.
static <IMAGE extends Image<?,IMAGE>,FACE extends DetectedFace> ListDataset<FACE>	process(List<IMAGE> instances, FaceDetector<FACE,IMAGE> detector) Apply a face detector to all the images in the given dataset, choosing only the biggest face if multiple are found.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

process

public static <PERSON,IMAGE extends Image<?,IMAGE>,FACE extends DetectedFace> GroupedDataset<PERSON,ListDataset<FACE>,FACE> process(GroupedDataset<PERSON,? extends ListDataset<IMAGE>,IMAGE> input,
                                                                                                                                    FaceDetector<FACE,IMAGE> detector)

Apply a face detector to all the images in the given dataset, choosing only the biggest face if multiple are found.

Type Parameters:

PERSON - Type representing a person

IMAGE - Type of image

FACE - Type of DetectedFace extracted

Parameters:

input - The input dataset

detector - The face detector

Returns:

a dataset of detected faces.

process

public static <IMAGE extends Image<?,IMAGE>,FACE extends DetectedFace> ListDataset<FACE> process(List<IMAGE> instances,
                                                                                                 FaceDetector<FACE,IMAGE> detector)

Apply a face detector to all the images in the given dataset, choosing only the biggest face if multiple are found.

Type Parameters:

IMAGE - Type of image

FACE - Type of DetectedFace extracted

Parameters:

instances - The input faces

detector - The face detector

Returns:

a dataset of detected faces.

getBiggest

public static <FACE extends DetectedFace> FACE getBiggest(List<FACE> faces)

Get the biggest face (by area) from the list

Type Parameters:

FACE - Type of DetectedFace

Parameters:

faces - the list of faces

Returns:

the biggest face or null if the list is null or empty