face_bu3dfe_83_to_face_bu3dfe_83¶
-
menpo.landmark.
face_bu3dfe_83_to_face_bu3dfe_83
(pcloud)[source]¶ Apply the BU-3DFE (Binghamton University 3D Facial Expression) Database 83-point facial semantic labels.
The semantic labels applied are as follows:
right_eye
left_eye
right_eyebrow
left_eyebrow
right_nose
left_nose
nostrils
outer_mouth
inner_mouth
jaw
- Parameters
x (
LabelledPointUndirectedGraph
orPointCloud
or ndarray) – The input labelled point graph, pointcloud, subclass of those or array to label. If a pointcloud is passed, then only the connectivity information is propagated to the pointcloud (a subclass ofPointCloud
may be returned).return_mapping (bool, optional) – Only applicable if a
PointCloud
or ndarray is passed. Returns the mapping dictionary which maps labels to indices into the resultingPointCloud
(which is then used to for building aLabelledPointUndirectedGraph
. This parameter is only provided for internal use so that other labellers can piggyback off one another.
- Returns
x_labelled (
LabelledPointUndirectedGraph
orPointCloud
) – If aLabelledPointUndirectedGraph
was passed, aLabelledPointUndirectedGraph
is returned. This labelled pointgraph will contain specific labels and these labels may refer to sub-pointclouds with specific connectivity information.If a
PointCloud
was passed, aPointCloud
is returned. Only the connectivity information is propagated to the pointcloud (a subclass ofPointCloud
may be returned).mapping_dict (ordereddict {str -> int ndarray}, optional) – Only returned if
return_mapping==True
. Used for buildingLabelledPointUndirectedGraph
.
:raises :
LabellingError
: If the given labelled point graph/pointcloud contains less than the expected number of points.