| 3 |
|
|
| 4 |
%\section{Getting started} |
%\section{Getting started} |
| 5 |
|
|
| 6 |
In this section, we describe how to use the model. In the first |
We believe the best way to familiarize yourself with the |
|
section, we provide enough information to help you get started with |
|
|
the model. We believe the best way to familiarize yourself with the |
|
| 7 |
model is to run the case study examples provided with the base |
model is to run the case study examples provided with the base |
| 8 |
version. Information on how to obtain, compile, and run the code is |
version. Information on how to obtain, compile, and run the code is |
| 9 |
found there as well as a brief description of the model structure |
found here as well as a brief description of the model structure |
| 10 |
directory and the case study examples. The latter and the code |
directory and the case study examples. Information is also provided |
| 11 |
structure are described more fully in chapters |
here on how to customize the code when you are ready to try implementing |
| 12 |
\ref{chap:discretization} and \ref{chap:sarch}, respectively. Here, in |
the configuration you have in mind. The code and algorithm |
| 13 |
this section, we provide information on how to customize the code when |
are described more fully in chapters \ref{chap:discretization} and |
| 14 |
you are ready to try implementing the configuration you have in mind. |
\ref{chap:sarch}. |
| 15 |
|
|
| 16 |
\section{Where to find information} |
\section{Where to find information} |
| 17 |
\label{sect:whereToFindInfo} |
\label{sect:whereToFindInfo} |
| 892 |
used to restart the model but are overwritten every other time they are |
used to restart the model but are overwritten every other time they are |
| 893 |
output to save disk space during long integrations. |
output to save disk space during long integrations. |
| 894 |
|
|
|
|
|
|
|
|
| 895 |
\subsubsection{MNC output files} |
\subsubsection{MNC output files} |
| 896 |
|
|
| 897 |
Unlike the \texttt{mdsio} output, the \texttt{mnc}--generated output |
Unlike the \texttt{mdsio} output, the \texttt{mnc}--generated output |
| 898 |
is usually (though not necessarily) placed within a subdirectory with |
is usually (though not necessarily) placed within a subdirectory with |
| 899 |
a name such as \texttt{mnc\_test\_\${DATE}\_\${SEQ}}. The files |
a name such as \texttt{mnc\_test\_\${DATE}\_\${SEQ}}. |
|
within this subdirectory are all in the ``self-describing'' netCDF |
|
|
format and can thus be browsed and/or plotted using tools such as: |
|
|
\begin{itemize} |
|
|
\item \texttt{ncdump} is a utility which is typically included |
|
|
with every netCDF install: |
|
|
\begin{rawhtml} <A href="http://www.unidata.ucar.edu/packages/netcdf/"> \end{rawhtml} |
|
|
\begin{verbatim} |
|
|
http://www.unidata.ucar.edu/packages/netcdf/ |
|
|
\end{verbatim} |
|
|
\begin{rawhtml} </A> \end{rawhtml} and it converts the netCDF |
|
|
binaries into formatted ASCII text files. |
|
|
|
|
|
\item \texttt{ncview} utility is a very convenient and quick way |
|
|
to plot netCDF data and it runs on most OSes: |
|
|
\begin{rawhtml} <A href="http://meteora.ucsd.edu/~pierce/ncview_home_page.html"> \end{rawhtml} |
|
|
\begin{verbatim} |
|
|
http://meteora.ucsd.edu/~pierce/ncview_home_page.html |
|
|
\end{verbatim} |
|
|
\begin{rawhtml} </A> \end{rawhtml} |
|
|
|
|
|
\item MatLAB(c) and other common post-processing environments provide |
|
|
various netCDF interfaces including: |
|
|
\begin{rawhtml} <A href="http://mexcdf.sourceforge.net/"> \end{rawhtml} |
|
|
\begin{verbatim} |
|
|
http://mexcdf.sourceforge.net/ |
|
|
\end{verbatim} |
|
|
\begin{rawhtml} </A> \end{rawhtml} |
|
|
\begin{rawhtml} <A href="http://woodshole.er.usgs.gov/staffpages/cdenham/public_html/MexCDF/nc4ml5.html"> \end{rawhtml} |
|
|
\begin{verbatim} |
|
|
http://woodshole.er.usgs.gov/staffpages/cdenham/public_html/MexCDF/nc4ml5.html |
|
|
\end{verbatim} |
|
|
\begin{rawhtml} </A> \end{rawhtml} |
|
|
\end{itemize} |
|
|
|
|
| 900 |
|
|
| 901 |
\subsection{Looking at the output} |
\subsection{Looking at the output} |
| 902 |
|
|
| 932 |
Similar scripts for netCDF output (\texttt{rdmnc.m}) are available and |
Similar scripts for netCDF output (\texttt{rdmnc.m}) are available and |
| 933 |
they are described in Section \ref{sec:pkg:mnc}. |
they are described in Section \ref{sec:pkg:mnc}. |
| 934 |
|
|
| 935 |
|
The MNC output files are all in the ``self-describing'' netCDF |
| 936 |
|
format and can thus be browsed and/or plotted using tools such as: |
| 937 |
|
\begin{itemize} |
| 938 |
|
\item \texttt{ncdump} is a utility which is typically included |
| 939 |
|
with every netCDF install: |
| 940 |
|
\begin{rawhtml} <A href="http://www.unidata.ucar.edu/packages/netcdf/"> \end{rawhtml} |
| 941 |
|
\begin{verbatim} |
| 942 |
|
http://www.unidata.ucar.edu/packages/netcdf/ |
| 943 |
|
\end{verbatim} |
| 944 |
|
\begin{rawhtml} </A> \end{rawhtml} and it converts the netCDF |
| 945 |
|
binaries into formatted ASCII text files. |
| 946 |
|
|
| 947 |
|
\item \texttt{ncview} utility is a very convenient and quick way |
| 948 |
|
to plot netCDF data and it runs on most OSes: |
| 949 |
|
\begin{rawhtml} <A href="http://meteora.ucsd.edu/~pierce/ncview_home_page.html"> \end{rawhtml} |
| 950 |
|
\begin{verbatim} |
| 951 |
|
http://meteora.ucsd.edu/~pierce/ncview_home_page.html |
| 952 |
|
\end{verbatim} |
| 953 |
|
\begin{rawhtml} </A> \end{rawhtml} |
| 954 |
|
|
| 955 |
|
\item MatLAB(c) and other common post-processing environments provide |
| 956 |
|
various netCDF interfaces including: |
| 957 |
|
\begin{rawhtml} <A href="http://mexcdf.sourceforge.net/"> \end{rawhtml} |
| 958 |
|
\begin{verbatim} |
| 959 |
|
http://mexcdf.sourceforge.net/ |
| 960 |
|
\end{verbatim} |
| 961 |
|
\begin{rawhtml} </A> \end{rawhtml} |
| 962 |
|
\begin{rawhtml} <A href="http://woodshole.er.usgs.gov/staffpages/cdenham/public_html/MexCDF/nc4ml5.html"> \end{rawhtml} |
| 963 |
|
\begin{verbatim} |
| 964 |
|
http://woodshole.er.usgs.gov/staffpages/cdenham/public_html/MexCDF/nc4ml5.html |
| 965 |
|
\end{verbatim} |
| 966 |
|
\begin{rawhtml} </A> \end{rawhtml} |
| 967 |
|
\end{itemize} |
| 968 |
|
|