<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
                   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<!-- lifted from troff+man by doclifter -->
<refentry id='datainfo1'>
<!--  @(#)datainfo.1 2001/04/02 NIST -->
<!--  I Image Group -->
<!--  G. T. Candela &amp; Craig I. Watson -->

<refmeta>
<refentrytitle>DATAINFO</refentrytitle>
<manvolnum>1A</manvolnum>
<refmiscinfo class='date'>02 April 2001</refmiscinfo>
<refmiscinfo class='source'>NIST</refmiscinfo>
<refmiscinfo class='manual'>NFIS Reference Manual</refmiscinfo>
</refmeta>
<refnamediv id='name'>
<refname>datainfo</refname>
<refpurpose>shows the header information of a PCASYS data file.</refpurpose>
</refnamediv>
<!-- body begins here -->
<refsynopsisdiv id='synopsis'>
<cmdsynopsis>
  <command>datainfo</command>    
    <arg choice='plain'><replaceable>&lt;datafile&gt;</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>


<refsect1 id='description'><title>DESCRIPTION</title>
<para><emphasis remap='B'>Datainfo</emphasis>
reads the header information from a PCASYS data file and writes a
short report of this information to the standard output.</para>

<para>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.</para>

<para>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.</para>

</refsect1>

<refsect1 id='options'><title>OPTIONS</title>
<variablelist remap='TP'>
  <varlistentry>
  <term><emphasis remap='I'>&lt;datafile&gt;</emphasis></term>
  <listitem>
<para>Data file whose header information is to be reported.</para>
  </listitem>
  </varlistentry>
</variablelist>
</refsect1>

<refsect1 id='examples'><title>EXAMPLE(S)</title>
<para>From <emphasis remap='I'>test/pcasys/execs/datainfo/datainfo.src</emphasis>:</para>

<!-- .RS -->
<para><emphasis remap='B'>% datainfo ../../data/oas/fv1-9.cls &gt;&amp; fv1-9cls.dat</emphasis></para>

<para><emphasis remap='B'>% datainfo ../../data/oas/fv1.oas &gt;&amp; fv1oas.dat</emphasis></para>

<para><emphasis remap='B'>% datainfo ../meancov/fv1-9.cov &gt;&amp; fv1-9cov.dat</emphasis>
<!-- .br -->
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).</para>
</refsect1>

<refsect1 id='see_also'><title>SEE ALSO</title>
<para>chgdesc (1A)</para>

</refsect1>

<refsect1 id='author'><title>AUTHOR</title>
<para>NIST/ITL/DIV894/Image Group</para>
</refsect1>
</refentry>

