Create Ucf Landmarks Application User's Guide Version 1.0

Overview

This is a application that creates landmarks from ucf files. Ucfs are not directly useful for landmark data, because the number of points per contour and the sampling rate cannot assumed to be the same between two ucfs. To solve this problem, two homologous ucf files are used (where the contours are homologous), and they are resampled so that each contour has the same number of points, so that point based homology can be established.

All ucfs are sampled at a constant sampling frequency. This sampling frequency is implicitly set by the user. The user must provide the number of points used to sample the shortest contour. This puts a lower bound on the number of number of points per contour. The sampling frequency can then be computed: sampFreq = minNum/shortestLength, where minNum is the minimum number of points per contour and shortest length is the length of the shortest contour. All other contours are sampled using this sample frequency.

The application requires four arguments. The first two are the ucfs to be resampled, and the last two are the filenames for the output landmark files. The ucfs must have the same number of contours, which are homologous. The user can specify the number of points to establish the sampling frequency with '-num posInt', where 'posInt' is a positive integer.

If the output files already exist, and error will occur. This can be overridden with the '-overwrite' flag. The '-version' flag prints the name and version. The '-verbose' flag enables message reporting to the console. The '-usage' flag prints an explanation of the flags. The '-debug' flag prints additional error information if an error occurs.

Examples