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 |
|
|