2 |
% $Name$ |
% $Name$ |
3 |
|
|
4 |
|
|
5 |
\section{Fortran Binary I/O: MDSIO and RW} |
\section{Fortran Native I/O: MDSIO and RW} |
6 |
\label{sec:mdsio_and_rw} |
\label{sec:mdsio_and_rw} |
7 |
|
|
8 |
|
|
11 |
\begin{rawhtml} |
\begin{rawhtml} |
12 |
<!-- CMIREDIR:package_mdsio: --> |
<!-- CMIREDIR:package_mdsio: --> |
13 |
\end{rawhtml} |
\end{rawhtml} |
|
\label{sec:pkg:rw} |
|
14 |
|
|
15 |
\subsubsection{Introduction} |
\subsubsection{Introduction} |
16 |
The \texttt{mdsio} package contains a group of Fortran routines |
The \texttt{mdsio} package contains a group of Fortran routines |
164 |
multiple threads or MPI processes simultaneously writing to the same |
multiple threads or MPI processes simultaneously writing to the same |
165 |
file. |
file. |
166 |
|
|
167 |
\item[Meta-data] is written on a per-file basis using a second file |
\item[Meta-data] is written by MITgcm on a per-file basis using a |
168 |
with a \texttt{.meta} extension as described above. One should be |
second file with a \texttt{.meta} extension as described above. |
169 |
careful not to delete the metadata files when using convenient |
MITgcm itself does not read the \texttt{*.meta} files, they are |
170 |
MatLAB post-processing scripts such as \texttt{rdmds()}. |
there primarly for convenience during post-processing. One should |
171 |
|
be careful not to delete the meta-data files when using MatLAB |
172 |
|
post-processing scripts such as \texttt{rdmds()} since it relies |
173 |
|
upon them. |
174 |
|
|
175 |
\item[Numerous files] can be written by \texttt{mdsio} due to its |
\item[Numerous files] can be written by \texttt{mdsio} due to its |
176 |
typically per-time-step and per-variable orientation. The creation of |
typically per-time-step and per-variable orientation. The creation of |
177 |
both a binary (\texttt{*.data}) and ASCII text meta--data |
both a binary (\texttt{*.data}) and ASCII text meta-data |
178 |
(\texttt{*.meta}) file for each output type step tends to exacerbate |
(\texttt{*.meta}) file for each output type step tends to exacerbate |
179 |
the problem. Some (mostly, older) operating systems do not |
the problem. Some (mostly, older) operating systems do not |
180 |
gracefully handle large numbers (\textit{eg.} many thousands) of |
gracefully handle large numbers (\textit{eg.} many thousands) of |