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

<refmeta>
<refentrytitle>OAS2PICS</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>oas2pics</refname>
<refpurpose>makes pictures of orientation arrays.</refpurpose>
</refnamediv>
<!-- body begins here -->
<refsynopsisdiv id='synopsis'>
<cmdsynopsis>
  <command>oas2pics</command>    
    <arg choice='plain'><replaceable>&lt;oasfile&gt;&lt;i_start&gt;&lt;i_finishoutpics_dir&gt;&lt;verbose&gt;</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>


<refsect1 id='description'><title>DESCRIPTION</title>
<para><emphasis remap='B'>Oas2pics</emphasis>
reads a specified segment of orientation arrays (oas) from a file,
and makes IHead raster images depicting the oas.  This can be useful
for testing whether oas are reasonable, and to find out about their
characteristics.</para>
</refsect1>

<refsect1 id='options'><title>OPTIONS</title>
<variablelist remap='TP'>
  <varlistentry>
  <term><emphasis remap='I'>&lt;oasfile&gt;</emphasis></term>
  <listitem>
<para>A PCASYS "matrix" file containing orientation arrays, with each row being
one oa.  First dimension is number of oas in the file, and second
dimension must be 1680 (the dimensionality of one oa). (Usually the
output of <emphasis remap='B'>mkoas</emphasis>.)</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis remap='I'>&lt;i_start&gt; &lt;i_finish&gt;</emphasis></term>
  <listitem>
<para>The program makes pictures of the segment consisting of oas i_start
through i_finish, numbering starting at 1.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis remap='I'>&lt;outpics_dir&gt;</emphasis></term>
  <listitem>
<para>The program makes image files in this directory.  (If the directory
does not already exist, the program makes it.)  The files will
have names i.pct where i goes from i_start through i_finish.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis remap='I'>&lt;verbose&gt;</emphasis></term>
  <listitem>
<para>If y, the program writes a progress message to stdout for each
oa it is making a picture of.</para>
  </listitem>
  </varlistentry>
</variablelist>
</refsect1>

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

<!-- .RS -->
<para><emphasis remap='B'>% oas2pics ../../data/oas/fv1.oas 1 2 oaspics y</emphasis>
<!-- .br -->
Makes a set of images files (IHEAD format) so the user can
see how the orientation arrays look and compare to the actual
fingerprint image if desired. The files can be converted to JPEG
format using the <emphasis remap='B'>cjegb</emphasis> command.</para>
</refsect1>

<refsect1 id='see_also'><title>SEE ALSO</title>
<para>mkoas (1A), dpyimage (1D), cjpegb (1D)</para>

</refsect1>

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

