org.openimaj.image.model.asm.datasets

Class ShapeModelDatasets

java.lang.Object

org.openimaj.image.model.asm.datasets.ShapeModelDatasets

public class ShapeModelDatasets
extends Object

Utilities for creating with ShapeModelDataset instances.

Author:

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

Method Summary

Modifier and Type	Method and Description
static <IMAGE extends Image<?,IMAGE>> ShapeModelDataset<IMAGE>	create(List<IndependentPair<PointList,IMAGE>> data, PointListConnections connections) Create a dataset with the given data.
static <IMAGE extends Image<?,IMAGE>> ShapeModelDataset<IMAGE>	loadASFDataset(String path, InputStreamObjectReader<IMAGE> reader) Load a dataset from ASF format files as used by the IMM dataset.
static <IMAGE extends Image<?,IMAGE>> ShapeModelDataset<IMAGE>	loadPTSDataset(String ptsDirPath, String imgDirPath, String modelFilePath, InputStreamObjectReader<IMAGE> reader) Load a dataset from PTS format files as used by Tim Cootes's ASM/AAM tools.

Methods inherited from class java.lang.Object

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

Method Detail

create

public static <IMAGE extends Image<?,IMAGE>> ShapeModelDataset<IMAGE> create(List<IndependentPair<PointList,IMAGE>> data,
                                                                             PointListConnections connections)

Create a dataset with the given data.

Parameters:

data - the image-pointset pairs

connections - the connections across the points

Returns:

the dataset

loadASFDataset

public static <IMAGE extends Image<?,IMAGE>> ShapeModelDataset<IMAGE> loadASFDataset(String path,
                                                                                     InputStreamObjectReader<IMAGE> reader)
                                                                              throws IOException

Load a dataset from ASF format files as used by the IMM dataset. If the images are present, they will also be loaded (images must have the same name as the corresponding ASF files, but with a different extension).

Parameters:

path - the file system path or uri. See the Apache Commons VFS2 documentation for all the details.

reader - the reader with which to load the images

Returns:

the dataset

Throws:

IOException - if an error occurs

See Also:

IMMFaceDatabase, "http://commons.apache.org/proper/commons-vfs/filesystems.html"

loadPTSDataset

public static <IMAGE extends Image<?,IMAGE>> ShapeModelDataset<IMAGE> loadPTSDataset(String ptsDirPath,
                                                                                     String imgDirPath,
                                                                                     String modelFilePath,
                                                                                     InputStreamObjectReader<IMAGE> reader)
                                                                              throws IOException

Load a dataset from PTS format files as used by Tim Cootes's ASM/AAM tools. If the images are present, they will also be loaded (images must have the same name as the corresponding PTS files, but with a different extension).

Parameters:

ptsDirPath - the directory containing the pts files

imgDirPath - the directory containing the images

modelFilePath - the path to the model (connections) file

reader - the reader with which to load the images

Returns:

the dataset

Throws:

IOException - if an error occurs

See Also:

IMMFaceDatabase, "http://commons.apache.org/proper/commons-vfs/filesystems.html"