AAMC - Active Appearance Model Console Interface - version 0.97 Copyright (c) Mikkel B. Stegmann 2003, mbs@imm.dtu.dk.

All rights reserved. For further information see http://www.imm.dtu.dk/~aam/ This version of AAMC was built on: Jan 20 2003 10:24:40 USAGE: aamc <b|e|loo|m|p|r|reg|s|t|u|w|sm|cm|d> [additional mode arguments] MODES: aamc b <input dir> <out model> [acf file] aamc e <model> <dir> [still|movie|both|none*] [pseudo|auto*] aamc loo <input dir> [acf file] [still|movie|both|none*] [pseudo|auto*] aamc m <model.amf> <all|shape|texture|combined> [#modes] [#frames] [white |black*] [range] aamc p [b|s|e|loo] <usual set of parameters> aamc r <model.amf> <input dir> aamc reg <input dir> aamc s <input model.amf> <input dir> [movie filename] aamc t <model.amf> <input movie> aamc u <utility function> arguments ... aamc w <write options> <annotation> [reduction factor] aamc sm <input movie> [output extension] aamc cm <input dir> <ext> <output avi> <frame rate> <gray|rgb> [comp] aamc d For futher help write: 'aamc -help', 'aamc -full' or 'aamc <modename> -help' The tool 'aamc' is the console interface to the AAM-API. --------------------------------------------------------------------MODE: b - Builds an Active Appearance Model. --------------------------------------------------------------------USAGE: aamc b <input dir> <out model> [acf file] DESCRIPTION: Builds an Active Appearance Model. In this mode the principal component analysis, parameter optimization training etc. are done. input dir : Directory containing images and annotations. out model : Filename (and path) of the output model file. Ex. 'model42'. acf file : AAM configuration file. --------------------------------------------------------------------MODE: e - Evaluates an Active Appearance Model. --------------------------------------------------------------------USAGE: aamc e <model> <dir> [still|movie|both|none*] [pseudo|auto*] DESCRIPTION: Evaluates an Active Appearance Model.

model : The model .amf that should be evaluated. dir : Directory containing images and ground truth annotations. [still|movie|both] : Write stills of the initial and optimized model and/or movies of the complete optimization. [pseudo|auto*] : Initialisation method. Output is written in the input dir in the file 'results.txt' Default settings are marked with an asterisk (*) --------------------------------------------------------------------MODE: loo - Leave-one-out evaluation of a training set. --------------------------------------------------------------------USAGE: aamc loo <input dir> [acf file] [still|movie|both|none*] [pseudo|auto*] DESCRIPTION: Leave-one-out evaluation of a training set. This mode performs cross-validation of a training set. input dir : Directory containing images and annotations. acf file : AAM configuration file. [still|movie|both] : Write stills of the initial and optimized model and/or movies of the complete optimization. [pseudo|auto*] : Initialisation method. Output is written in the directory 'loo_results'. Default settings are marked with an asterisk (*) --------------------------------------------------------------------MODE: m - Writes Active Appearance Model mode movies. --------------------------------------------------------------------USAGE: aamc m <model.amf> <all|shape|texture|combined> [#modes] [#frames] [white| black*] [range] DESCRIPTION: Writes Active Appearance Model mode movies. This mode documents the given AAM by generating movies showing the shape, texture and combined variation resulting from the PCAs. Output are written in current dir. [#modes] [#frames] [white|black] [range] : : : : The number of model modes to render (3). The frames to render each mode in (10). Background colour (black). Parameter range (3).

--------------------------------------------------------------------MODE: p - 3-level pyramidal (multi-scale) AAM. ---------------------------------------------------------------------

USAGE: aamc p [b|s|e|loo] <usual set of parameters> DESCRIPTION: 3-level pyramidal (multi-scale) AAM. This mode implements the modes b,s,e and loo using a 3-level aam. Parameters after the mode name are set as in the 1-level modes. --------------------------------------------------------------------MODE: r - Tests the regression prediction in an AAM. --------------------------------------------------------------------USAGE: aamc r <model.amf> <input dir> DESCRIPTION: Tests the regression prediction in an AAM. Output is written in the current dir in matlab format. --------------------------------------------------------------------MODE: reg - Registration from a set of shapes. --------------------------------------------------------------------USAGE: aamc reg <input dir> DESCRIPTION: Registration from a set of shapes. This mode creates a registration movie from a set of shapes. input dir : Directory containing images and annotations. <convex|no-convex*>: Usage of the convex hull as shape extent. --------------------------------------------------------------------MODE: s - Active Appearance Model search. --------------------------------------------------------------------USAGE: aamc s <input model.amf> <input dir> [movie filename] DESCRIPTION: Active Appearance Model search. Search output is written in the input dir. Automatic initialisation is performed on all BMP images. --------------------------------------------------------------------MODE: t - Performs tracking in a movie file (.avi). ---------------------------------------------------------------------

USAGE: aamc t <model.amf> <input movie> DESCRIPTION: Performs tracking in a movie file (.avi). This mode performs a through initialisation of the AAM in the first frame and uses the convergened position as initial pose in the next frame (and so on...). Example usage: aamc t mymodel.amf hand.avi --------------------------------------------------------------------MODE: u - Utility functions --------------------------------------------------------------------USAGE: aamc u <utility function> arguments ... DESCRIPTION: Utility functions Print area utility Usage: aamc u printarea --------------------------------------------------------------------MODE: w - Plots an annotation into it's host image. <write options> Set one or several of the following options to get the desired result (not sensitive to ordering): s p i n m t <annotation> Plots the shape as connecting lines Plots all shape points as cross-hairs Dots the interior of the shape Draws point normals Plots a Delaunay triangulation of the shape Similar to 'm' but removes all concave triangles

An .asf-file.

[reduction factor] Optional integer image/annotation reduction factor [2-n] Example usage: aamc w si c6302.asf --------------------------------------------------------------------USAGE: aamc w <write options> <annotation> [reduction factor]

DESCRIPTION: Plots an annotation into it's host image. <write options> Set one or several of the following options to get the desired result (not sensitive to ordering): s p i n m t <annotation> Plots the shape as connecting lines Plots all shape points as cross-hairs Dots the interior of the shape Draws point normals Plots a Delaunay triangulation of the shape Similar to 'm' but removes all concave triangles

An .asf-file.

[reduction factor] Optional integer image/annotation reduction factor [2-n] Example usage: aamc w si c6302.asf

--------------------------------------------------------------------MODE: sm - Split movie file (.avi) into frames. --------------------------------------------------------------------USAGE: aamc sm <input movie> [output extension] DESCRIPTION: Split movie file (.avi) into frames. Example usage: aamc sm shape01.avi bmp --------------------------------------------------------------------MODE: cm - Collects a movie file from BMP/HIPS frames. If the optional 'comp' is equal to '1' a compression dialog is shown. In all other cases the AVI format is uncompressed. --------------------------------------------------------------------USAGE: aamc cm <input dir> <ext> <output avi> <frame rate> <gray|rgb> [comp] DESCRIPTION: Collects a movie file from BMP/HIPS frames. If the optional 'comp' is equal to '1' a compression dialog is shown. In all other cases the AVI format is uncompressed.

Example usage: aamc cm frames\ hips movie.avi 4 rgb 1 --------------------------------------------------------------------MODE: d - Debug/Test console mode. Don't use! --------------------------------------------------------------------USAGE: aamc d DESCRIPTION: Debug/Test console mode. Don't use!