org.openimaj.image.processing.face.detection

Class SandeepFaceDetector

java.lang.Object

org.openimaj.image.processing.face.detection.SandeepFaceDetector

All Implemented Interfaces:

FaceDetector<CCDetectedFace,MBFImage>, ReadableBinary, ReadWriteableBinary, WriteableBinary

@Reference(type=Article,
           author={"Sandeep, K","Rajagopalan, A N"},
           title="Human Face Detection in Cluttered Color Images Using Skin Color and Edge Information",
           year="2002",
           journal="Electrical Engineering",
           url="http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.12.730&rep=rep1&type=pdf",
           publisher="Citeseer")
public class SandeepFaceDetector
extends Object
implements FaceDetector<CCDetectedFace,MBFImage>

Implementation of a face detector along the lines of "Human Face Detection in Cluttered Color Images Using Skin Color and Edge Information" K. Sandeep and A. N. Rajagopalan (IIT/Madras)

Author:

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

Field Summary

Fields

Modifier and Type	Field and Description
static double	GOLDEN_RATIO The golden ratio (for comparing facial height/width)

Constructor Summary

Constructors

Constructor and Description
SandeepFaceDetector() Construct a new SandeepFaceDetector with the default skin-tone model.
SandeepFaceDetector(MBFPixelClassificationModel skinModel) Construct the detector with the given pixel classification model.

Method Summary

Modifier and Type	Method and Description
byte[]	binaryHeader() Header for binary input.
List<CCDetectedFace>	detectFaces(MBFImage inputRGB) Detect faces in the image and return a list of faces found.
protected List<CCDetectedFace>	extractFaces(FImage faceMap, FImage skinMap, FImage image)
protected FImage	generateFaceMap(FImage skin, FImage edge)
protected FImage	generateSkinColorMap(MBFImage inputHS)
protected FImage	generateSobelMagnitudes(MBFImage inputRGB)
float	getEdgeThreshold()
float	getPercentageThreshold()
MBFPixelClassificationModel	getSkinModel()
float	getSkinThreshold()
static void	main(String[] args) Run the face detector following the conventions of the ocv detector
void	readBinary(DataInput in) Read internal state from in.
void	setEdgeThreshold(float edgeThreshold) Set the edge threshold.
void	setPercentageThreshold(float percentageThreshold) Set the percentage threshold
void	setSkinModel(MBFPixelClassificationModel skinModel) Set the underlying skin-tone classifier
void	setSkinThreshold(float skinThreshold) Set the detection threshold.
void	writeBinary(DataOutput out) Write the content of this as binary to out.

Methods inherited from class java.lang.Object

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

Field Detail

GOLDEN_RATIO

public static final double GOLDEN_RATIO

The golden ratio (for comparing facial height/width)

See Also:

Constant Field Values

Constructor Detail

SandeepFaceDetector

public SandeepFaceDetector()

Construct a new SandeepFaceDetector with the default skin-tone model.

SandeepFaceDetector

public SandeepFaceDetector(MBFPixelClassificationModel skinModel)

Construct the detector with the given pixel classification model.

Parameters:

skinModel - the underlying classification model.

Method Detail

generateSkinColorMap

protected FImage generateSkinColorMap(MBFImage inputHS)

generateSobelMagnitudes

protected FImage generateSobelMagnitudes(MBFImage inputRGB)

generateFaceMap

protected FImage generateFaceMap(FImage skin,
                                 FImage edge)

extractFaces

protected List<CCDetectedFace> extractFaces(FImage faceMap,
                                            FImage skinMap,
                                            FImage image)

detectFaces

public List<CCDetectedFace> detectFaces(MBFImage inputRGB)

Description copied from interface: FaceDetector

Detect faces in the image and return a list of faces found.

Specified by:

detectFaces in interface FaceDetector<CCDetectedFace,MBFImage>

Parameters:

inputRGB - Image to search in

Returns:

List of detected faces.

getSkinModel

public MBFPixelClassificationModel getSkinModel()

Returns:

The underlying skin-tone classifier

setSkinModel

public void setSkinModel(MBFPixelClassificationModel skinModel)

Set the underlying skin-tone classifier

Parameters:

skinModel -

getSkinThreshold

public float getSkinThreshold()

Returns:

the detection threshold.

setSkinThreshold

public void setSkinThreshold(float skinThreshold)

Set the detection threshold.

Parameters:

skinThreshold -

getEdgeThreshold

public float getEdgeThreshold()

Returns:

The edge threshold.

setEdgeThreshold

public void setEdgeThreshold(float edgeThreshold)

Set the edge threshold.

Parameters:

edgeThreshold -

getPercentageThreshold

public float getPercentageThreshold()

Returns:

The percentage threshold

setPercentageThreshold

public void setPercentageThreshold(float percentageThreshold)

Set the percentage threshold

Parameters:

percentageThreshold -

main

public static void main(String[] args)
                 throws IOException

Run the face detector following the conventions of the ocv detector

Parameters:

args -

Throws:

IOException

readBinary

public void readBinary(DataInput in)
                throws IOException

Description copied from interface: ReadableBinary

Read internal state from in.

Specified by:

readBinary in interface ReadableBinary

Parameters:

in - source to read from.

Throws:

IOException - an error reading input

binaryHeader

public byte[] binaryHeader()

Description copied from interface: ReadableBinary

Header for binary input. Will be automatically read by IOUtils when using readBinary().

Specified by:

binaryHeader in interface ReadableBinary

Specified by:

binaryHeader in interface WriteableBinary

Returns:

header

writeBinary

public void writeBinary(DataOutput out)
                 throws IOException

Description copied from interface: WriteableBinary

Write the content of this as binary to out.

Specified by:

writeBinary in interface WriteableBinary

Parameters:

out - sink to write to

Throws:

IOException - an error writing to out