manual/s_phys_pkgs/rw.tex

\section{Basic binary I/O utilities}
\label{sec:pkg:rw}
The {\tt rw} package provides a very rudimentary binary I/O capability
for quickly writing {\it single record} direct-access Fortran binary files. 
It is primarily used for writing diagnostic output.

\subsection{Introduction}
Package {\tt rw} is an interface to the more general {\tt mdsio} package.
The {\tt rw} package can be used to write or read direct-access Fortran 
binary files for two-dimensional XY and three-dimensional XYZ arrays. 
The arrays are assumed to have been decalred according to the standard
MITgcm two-dimensional or the-dimensional floating poit array type e.g
\begin{verbatim}
C     Example of declaring a standard two dimensional "long" floating
C     point type array (the _RL macro is usually mapped to 64-bit 
C     floats in most configurations)
      _RL anArray(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
\end{verbatim}
Each call to an {\tt rw} read or write routine will read (or write) to the 
first record of a file. To write files with multiple records use the 
package {\tt mdsio} (see section) or the package {\tt mnc} (see section {sec:pkg:mnc}) 
which produces netCDF \cite{rew:97} based output.

\subsection{Key subroutines, parameters and files}
\label{sec:pkg:rw:implementation_synopsis}
\subsection{Package Reference}
1	cnh	1.1	\section{Basic binary I/O utilities}
2	cnh	1.2	\label{sec:pkg:rw}
3	cnh	1.3	The {\tt rw} package provides a very rudimentary binary I/O capability
4			for quickly writing {\it single record} direct-access Fortran binary files.
5	cnh	1.2	It is primarily used for writing diagnostic output.
6	cnh	1.3
7	cnh	1.2	\subsection{Introduction}
8	cnh	1.3	Package {\tt rw} is an interface to the more general {\tt mdsio} package.
9			The {\tt rw} package can be used to write or read direct-access Fortran
10			binary files for two-dimensional XY and three-dimensional XYZ arrays.
11			The arrays are assumed to have been decalred according to the standard
12			MITgcm two-dimensional or the-dimensional floating poit array type e.g
13			\begin{verbatim}
14			C Example of declaring a standard two dimensional "long" floating
15			C point type array (the _RL macro is usually mapped to 64-bit
16			C floats in most configurations)
17			_RL anArray(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
18			\end{verbatim}
19			Each call to an {\tt rw} read or write routine will read (or write) to the
20			first record of a file. To write files with multiple records use the
21			package {\tt mdsio} (see section) or the package {\tt mnc} (see section {sec:pkg:mnc})
22			which produces netCDF \cite{rew:97} based output.
23	cnh	1.2
24	cnh	1.1	\subsection{Key subroutines, parameters and files}
25			\label{sec:pkg:rw:implementation_synopsis}
26			\subsection{Package Reference}