/[MITgcm]/manual/s_phys_pkgs/rw.tex
ViewVC logotype

Diff of /manual/s_phys_pkgs/rw.tex

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph | View Patch Patch

revision 1.2 by cnh, Wed Jan 28 21:29:09 2004 UTC revision 1.6 by edhill, Tue Oct 12 18:16:03 2004 UTC
# Line 1  Line 1 
1  \section{Basic binary I/O utilities}  % $Header$
2    % $Name$
3    
4    
5    \section{RW Basic binary I/O utilities}
6  \label{sec:pkg:rw}  \label{sec:pkg:rw}
7  The {\tt rw/} package provides a very rudimentary binary I/O capability  \begin{rawhtml}
8  for quickly writing {\bf single record} direct-access Fortran binary files.  <!-- 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.  It is primarily used for writing diagnostic output.
14    
15  \subsection{Introduction}  \subsection{Introduction}
16  Package {\tt rw/} is an interface to the more general {\tt mdsio/} package.  Package {\tt rw} is an interface to the more general {\tt mdsio} package.
17  It can be used to write or read direct-access Fortran binary files for  The {\tt rw} package can be used to write or read direct-access Fortran
18  two-dimensional XY and three-dimensional XYZ arrays. Each call to an {\tt rw/}  binary files for two-dimensional XY and three-dimensional XYZ arrays.
19  read or write routine will read (or write) to the first record of a file.  The arrays are assumed to have been declared according to the standard
20  To write files with multiple records use the package {\tt mdsio/} or the  MITgcm two-dimensional or three-dimensional floating point array type:
21  package {\tt mnc/ \ref{sec:pkg:mnc}} which produces netCDF \cite{rew:97}  \begin{verbatim}
22  based output.  C     Example of declaring a standard two dimensional "long"
23    C     floating point type array (the _RL macro is usually
24  \subsection{Key subroutines, parameters and files}  C     mapped to 64-bit floats in most configurations)
25  \label{sec:pkg:rw:implementation_synopsis}        _RL anArray(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
26  \subsection{Package Reference}  \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    %% \subsection{Key subroutines, parameters and files}
39    %% \label{sec:pkg:rw:implementation_synopsis}
40    %% The {\tt rw} package has
41    
Legend:
Removed from v.1.2  
changed lines
  Added in v.1.6
  ViewVC Help
Powered by ViewVC 1.1.22