\section{AmrDerive}

\subsection{Overview}

{\em AmrDerive} is a data extraction and analysis tool for
Adaptive Mesh Refinement ({\bf AMR}) data sets.  It creates
plot files from other plot files, typically creating new data
sets from state data.
{\em AmrDerive} works for 2D and 3D data sets and can run in parallel
on both SMP and distributed memory parallel machines using parallel
{\em BoxLib} and parallel {\em DataServices}.

{\em AmrDerive} requires the user to write code to perform specific
derivation functions.  The release version contains a framework
for reading and writing plot files and accessing data in parallel,
and examples are provided for the user to use and modify. 



\subsection{Using AmrDerive}

[Not finished...]

Using the {\bf -help} argument (or no arguments) will cause
{\em amrderive} to print a usage message and exit.  The usage
is currently as follows for an execuatble compiled with
AmrDerive.cpp.

\begin{verbatim}
AmrDerive3d.OSF1.KCC.ex
    outfile = outputFileName
    infile  = inputFileName(s)
    type    = derivedTypeName
   [-help]
   [-verbose]
   [fab.format = FormatType]
      where FormatType=IEEE32(default), ASCII, 8BIT, or NATIVE

Available types:
  logden
  xvel
  yvel
  zvel
  teng
  eint
  kint
  vorticity
  concentration
  dilitation
\end{verbatim}


\subsubsection{Writing Derive Functions}

[Not finished...]


\subsection{Files and Directories}

\begin{verbatim}
AmrDerive.cpp
AmrDeriveAvgPlots.cpp
AmrDeriveBinTrac.cpp
AmrDeriveIntegrate.cpp
AmrDeriveMatLab.cpp
AmrDerivePeriodicFab.cpp
Derived.H
DERIVE_3D.F
\end{verbatim}


\subsection{Examples}

[Not finished...]

AmrDerive3d.OSF1.KCC.MPI.ex infile=plt0010 outfile=plt0010.logden type=logden 


\subsection{FAQ}

To expand file names on the command line, you must use
a space after the equal sign.

inputs=plt*   (No match--does not expand plt*.)

use:
inputs= plt*  (with space before plt*).

