manual/s_outp_pkgs/rw.tex

% $Header: /u/gcmpack/manual/part7/rw.tex,v 1.1 2005/07/18 20:45:28 molod Exp $
% $Name:  $


\subsection{RW Basic binary I/O utilities}
\label{sec:pkg:rw}
\begin{rawhtml}
<!-- CMIREDIR:package_rw: -->
\end{rawhtml}

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.

\subsubsection{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 declared according to the standard
MITgcm two-dimensional or three-dimensional floating point array type:
\begin{verbatim}
C     Example of declaring a standard two dimensional "long" 
C     floating point type array (the _RL macro is usually 
C     mapped to 64-bit 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 direct access Fortran files with
multiple records use the package {\tt mdsio} (see section
\ref{sec:pkg:mdsio}).  To write self-describing files that contain
embedded information describing the variables being written and the
spatial and temporal locations of those variables use the package {\tt
  mnc} (see section \ref{sec:pkg:mnc}) which produces
\htlink{netCDF}{http://www.unidata.ucar.edu/packages/netcdf}
\cite{rew:97} based output.

%% \subsubsection{Key subroutines, parameters and files}
%% \label{sec:pkg:rw:implementation_synopsis}
%% The {\tt rw} package has 

1	% $Header: /u/gcmpack/manual/part7/rw.tex,v 1.1 2005/07/18 20:45:28 molod Exp $
2	% $Name: $
3
4
5	\subsection{RW Basic binary I/O utilities}
6	\label{sec:pkg:rw}
7	\begin{rawhtml}
8	<!-- CMIREDIR:package_rw: -->
9	\end{rawhtml}
10
11	The {\tt rw} package provides a very rudimentary binary I/O capability
12	for quickly writing {\it single record} direct-access Fortran binary files.
13	It is primarily used for writing diagnostic output.
14
15	\subsubsection{Introduction}
16	Package {\tt rw} is an interface to the more general {\tt mdsio} package.
17	The {\tt rw} package can be used to write or read direct-access Fortran
18	binary files for two-dimensional XY and three-dimensional XYZ arrays.
19	The arrays are assumed to have been declared according to the standard
20	MITgcm two-dimensional or three-dimensional floating point array type:
21	\begin{verbatim}
22	C Example of declaring a standard two dimensional "long"
23	C floating point type array (the _RL macro is usually
24	C mapped to 64-bit floats in most configurations)
25	_RL anArray(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
26	\end{verbatim}
27
28	Each call to an {\tt rw} read or write routine will read (or write) to
29	the first record of a file. To write direct access Fortran files with
30	multiple records use the package {\tt mdsio} (see section
31	\ref{sec:pkg:mdsio}). To write self-describing files that contain
32	embedded information describing the variables being written and the
33	spatial and temporal locations of those variables use the package {\tt
34	mnc} (see section \ref{sec:pkg:mnc}) which produces
35	\htlink{netCDF}{http://www.unidata.ucar.edu/packages/netcdf}
36	\cite{rew:97} based output.
37
38	%% \subsubsection{Key subroutines, parameters and files}
39	%% \label{sec:pkg:rw:implementation_synopsis}
40	%% The {\tt rw} package has
41