<?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='mlpfeats1'>
<!--  @(#)mlpfeats.1 2001/04/02 NIST -->
<!--  I Image Group -->
<!--  Craig I. Watson &amp; C. L. Wilson -->

<refmeta>
<refentrytitle>MLPFEATS</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>mlpfeats</refname>
<refpurpose>converts PCASYS formatted feature files into the format compatible with the mlp command line function.</refpurpose>
</refnamediv>
<!-- body begins here -->
<refsynopsisdiv id='synopsis'>
<cmdsynopsis>
  <command>mlpfeats</command>    
    <arg choice='plain'><replaceable>&lt;feats_file&gt;&lt;class_file&gt;&lt;mlp_feats_file&gt;</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>


<refsect1 id='description'><title>DESCRIPTION</title>
<para><emphasis remap='B'>Mlpfeats</emphasis>
is used to convert a PCASYS formatted feature
file from the lintran function into the format used by the
mlp command. PCASYS keeps the feature file and class file in
separate files and mlp stores them in a single file with
different header information format. At this point it was decided to
just convert the format from PCASYS features to mlp features
file format, any future release may try and resolve this
problem into a single format.</para>
</refsect1>

<refsect1 id='options'><title>OPTIONS</title>
<variablelist remap='TP'>
  <varlistentry>
  <term><emphasis remap='I'>&lt;feats_file&gt;</emphasis></term>
  <listitem>
<para>The PCASYS formatted features file. (Usually the output of
<emphasis remap='B'>lintran</emphasis>.)</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis remap='I'>&lt;class_file&gt;</emphasis></term>
  <listitem>
<para>The PCASYS formatted class file.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis remap='I'>&lt;mlp_feats_file&gt;</emphasis></term>
  <listitem>
<para>The MLP features file to be written, containing the PCASYS formatted
feature and class files merged into a single MLP formatted file.</para>
  </listitem>
  </varlistentry>
</variablelist>
</refsect1>

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

<!-- .RS -->
<para><emphasis remap='B'>% mlpfeats ../lintran/fv1-9mlp.kls ../../data/oas/fv1-9.cls fv1-9mlp.kls</emphasis>
<!-- .br -->
Converts the feature file from the PCASYS file format to the mlp
data file format (combines class and features into a single file.)
It is unfortunate that two file formats exist but for now it is
easier to keep both formats around.</para>
</refsect1>

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

</refsect1>

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

