<?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='mktran1'>
<!--  @(#)mktran.1 2001/04/02 NIST -->
<!--  I Image Group -->
<!--  G. T. Candela &amp; Craig I. Watson -->

<refmeta>
<refentrytitle>MKTRAN</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>mktran</refname>
<refpurpose>makes transform matrix from regional weights and eigenvectors.</refpurpose>
</refnamediv>
<!-- body begins here -->
<refsynopsisdiv id='synopsis'>
<cmdsynopsis>
  <command>mktran</command>    
    <arg choice='plain'><replaceable>&lt;regwts_file&gt;&lt;eigvecs_file&gt;&lt;n_eigvecs_use&gt;&lt;tranmat_file&gt;&lt;tranmat_file_desc&gt;&lt;ascii_outfile&gt;</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>


<refsect1 id='description'><title>DESCRIPTION</title>
<para><emphasis remap='B'>Mktran</emphasis>
takes a matrix of regional weights, and a set of eigenvectors, and
makes a transform matrix from the regional weights and the specified
number of (first) eigenvectors.  The resulting matrix is suitable for
transforming an orientation array into a low-dimensional feature
vector.</para>
</refsect1>

<refsect1 id='options'><title>OPTIONS</title>
<variablelist remap='TP'>
  <varlistentry>
  <term><emphasis remap='I'>&lt;regwts_file&gt;</emphasis></term>
  <listitem>
<para>Regional weights file in PCASYS "matrix" format.  The dimensions must
be 14x15, because that is the pattern of 2x2-vector blocks of
orientation vectors. (Usually the output of <emphasis remap='B'>optrws</emphasis>.)</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis remap='I'>&lt;eigvecs_file&gt;</emphasis></term>
  <listitem>
<para>Eigenvectors file in PCASYS "matrix" format.  The first dimension is
the number of eigenvectors contained in the file; the second dimension
must be 1680, which is the dimension of an orientation array when it
is thought of as a single vector. (Usually the output of <emphasis remap='B'>eva_evt</emphasis>.)</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis remap='I'>&lt;n_eigvecs_use&gt;</emphasis></term>
  <listitem>
<para>The number (first) eigenvectors to be used.  This will
be the first dimension of the resulting transform matrix.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis remap='I'>&lt;tranmat_file&gt;</emphasis></term>
  <listitem>
<para>Transform file to be made, in PCASYS "matrix" format.  First dimension
will be <emphasis remap='I'>n_eigvecs_use</emphasis> and second dimension will be 1680.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis remap='I'>&lt;tranmat_file_desc&gt;</emphasis></term>
  <listitem>
<para>A string to be written into the transform matrix output file as its
description string.  This string can be of any length, but must not
contain embedded newline characters.  If it contains spaces, tabs, or
shell metacharacters that are not to be expanded, then it should be
quoted.  To leave the description empty, use '' (two single quotes,
i.e.  single-quoted empty string).  To let mktran make a description,
use - (hyphen).</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis remap='I'>&lt;ascii_outfile&gt;</emphasis></term>
  <listitem>
<para>If y, makes an ascii output file; if n, binary.  Binary is
recommended, unless the output file must be portable across different
byte orders or floating-point formats.</para>
  </listitem>
  </varlistentry>
</variablelist>
</refsect1>

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

<!-- .RS -->
<para><emphasis remap='B'>% mktran ../optrws/optrws.bin ../eva_evt/fv1-9.evt 64 fv1-9.opt - n</emphasis>
<!-- .br -->
Uses a set of optimized regional weights (<emphasis remap='I'>optrws.bin</emphasis>) to
adjust a eigen-vector basis set (<emphasis remap='I'>fv1-9.evt</emphasis>) and create
a new transformation matrix (<emphasis remap='I'>fv1-9.opt</emphasis>) that is used
to reduce the dimensionality of the feature vectors.</para>
</refsect1>

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

</refsect1>

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

