--- manual/s_phys_pkgs/rw.tex 2004/01/29 16:42:12 1.4 +++ manual/s_phys_pkgs/rw.tex 2004/01/29 21:12:31 1.5 @@ -1,3 +1,7 @@ +% $Header: /home/ubuntu/mnt/e9_copy/manual/s_phys_pkgs/Attic/rw.tex,v 1.5 2004/01/29 21:12:31 edhill Exp $ +% $Name: $ + + \section{RW Basic binary I/O utilities} \label{sec:pkg:rw} The {\tt rw} package provides a very rudimentary binary I/O capability @@ -8,33 +12,37 @@ 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 +The arrays are assumed to have been declared according to the standard +MITgcm two-dimensional or the-dimensional floating point array type (see figure \ref{fig:pkg:rw:standarddeclaration}). -\begin{figure} +\begin[h]{figure} +{\small \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) +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} +} \caption{An example of the fixed form Fortran declaration for a standard MITgcm two-dimensional array type. } \label{fig:pkg:rw:standarddeclaration} \end{figure} -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 +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} +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. \subsection{Key subroutines, parameters and files} \label{sec:pkg:rw:implementation_synopsis} The {\tt rw} package has + + \subsection{Package Reference}