DATAINFO

Name

datainfo -- shows the header information of a PCASYS data file.

Synopsis

datainfo <datafile>

DESCRIPTION

Datainfo reads the header information from a PCASYS data file and writes a short report of this information to the standard output.

The file must be in one of the official PCASYS data file formats, which are "matrix" (matrix of floating point numbers), "covariance" (covariance matrix of floating point numbers, with only the nonstrict lower triangle stored since a covariance matrix is symmetric), and "classes" (classes, represented as unsigned characters, which are thought of as being integers in the range 0 through 255). PCASYS data files come in these three types, and can be either "ascii" or "binary", so there are really 6 types in all.

Datainfo reports the description string of the data file, its type (matrix, etc.), whether it is ascii or binary, and then some final information specific to the file type: if matrix, the two dimensions; if covariance, the order (of the symmetric covariance matrix, i.e. the number that both dimensions equal) and the number of input vectors used to make the covariance; if classes, the number of elements.

OPTIONS

<datafile>

Data file whose header information is to be reported.

EXAMPLE(S)

From test/pcasys/execs/datainfo/datainfo.src:

% datainfo ../../data/oas/fv1-9.cls >& fv1-9cls.dat

% datainfo ../../data/oas/fv1.oas >& fv1oas.dat

% datainfo ../meancov/fv1-9.cov >& fv1-9cov.dat Prints out the file header information for the various types of files, class (fv1-9.cls), orientation arrays (fv1.oas), and covariance (fv1-9.cov).

SEE ALSO

chgdesc (1A)

AUTHOR

NIST/ITL/DIV894/Image Group