1 |
cnh |
1.31 |
% $Header: /u/gcmpack/manual/manual.tex,v 1.30 2005/07/14 19:22:18 molod Exp $ |
2 |
adcroft |
1.2 |
% $Name: $ |
3 |
adcroft |
1.1 |
|
4 |
edhill |
1.26 |
\documentclass[10pt]{book} |
5 |
adcroft |
1.1 |
|
6 |
adcroft |
1.8 |
%To help cross-reference |
7 |
|
|
%\usepackage{showlabels} |
8 |
|
|
|
9 |
|
|
%aja%\usepackage{amsfonts} |
10 |
adcroft |
1.1 |
\usepackage{amsmath} |
11 |
cnh |
1.7 |
\usepackage{html} |
12 |
cnh |
1.19 |
\usepackage{hthtml} |
13 |
adcroft |
1.10 |
\usepackage{graphicx} |
14 |
adcroft |
1.8 |
|
15 |
|
|
%cnh%\usepackage{array} |
16 |
|
|
%cnh%\usepackage{multirow} |
17 |
cnh |
1.12 |
|
18 |
edhill |
1.16 |
%eh3 Commands to reference either files or symbols within the "HTML-ized" |
19 |
|
|
%eh3 ("vdb") code. |
20 |
|
|
%eh3 |
21 |
afe |
1.23 |
%afe seems like these need to be long, sorry |
22 |
|
|
\newcommand{\varlink}[2]{\htmladdnormallink{\tt #1}{../code_reference/vdb/byname/#2.html}} |
23 |
|
|
\newcommand{\filelink}[2]{\htmladdnormallink{\bf \tt #1}{../code_reference/vdb/byname/#2.html}} |
24 |
afe |
1.22 |
|
25 |
|
|
% afe Commands to standardize typesetting |
26 |
afe |
1.23 |
\newcommand{\file}[1]{\texttt{#1}} |
27 |
|
|
\newcommand{\sectiontitle}[1]{\textsl{#1}} |
28 |
|
|
\newcommand{\code}[1]{\texttt{#1}} |
29 |
afe |
1.22 |
|
30 |
edhill |
1.25 |
%% EH3 : try out the epsfig package |
31 |
edhill |
1.18 |
\usepackage[dvips]{epsfig} |
32 |
|
|
\def\scalefig#1{\epsfxsize #1\textwidth} |
33 |
edhill |
1.25 |
|
34 |
|
|
%EH3% ========================================================== |
35 |
|
|
%EH3% *** PRIVATE SECTIONS ****** PRIVATE SECTIONS *** |
36 |
|
|
%EH3% |
37 |
|
|
%EH3% Directions: To build the ``private'' or ``local-only'' |
38 |
|
|
%EH3% version of this manual, then edit the following so |
39 |
|
|
%EH3% they appear as: |
40 |
|
|
%EH3% |
41 |
|
|
%EH3% % \includecomment{versionprivate} |
42 |
|
|
%EH3% \excludecoment{versionprivate} |
43 |
|
|
%EH3% |
44 |
|
|
%EH3% The default is to include everything which is: |
45 |
|
|
%EH3% |
46 |
|
|
%EH3% \includecomment{versionprivate} |
47 |
|
|
%EH3% % \excludecoment{versionprivate} |
48 |
|
|
|
49 |
afe |
1.28 |
%\includecomment{versionprivate} |
50 |
|
|
\excludecomment{versionprivate} |
51 |
edhill |
1.25 |
|
52 |
|
|
%EH3% |
53 |
|
|
%EH3% To use this comment, simply bracket any part of the |
54 |
|
|
%EH3% manual with two lines that contain ONLY the following |
55 |
|
|
%EH3% pair: |
56 |
|
|
%EH3% |
57 |
|
|
%EH3% \begin{versionprivate} |
58 |
|
|
%EH3% \end{versionprivate} |
59 |
|
|
%EH3% |
60 |
|
|
%EH3% with NO additional comments or other commands on the |
61 |
|
|
%EH3% lines containing the \begin{...}\end{...} statements. |
62 |
|
|
%EH3% |
63 |
|
|
%EH3% *** PRIVATE SECTIONS ****** PRIVATE SECTIONS *** |
64 |
|
|
%EH3% ========================================================== |
65 |
cnh |
1.12 |
|
66 |
adcroft |
1.8 |
|
67 |
|
|
%ph%\usepackage{epsfig} |
68 |
|
|
%ph%\usepackage{psfrag} |
69 |
|
|
%ph%\usepackage{oldgerm} |
70 |
|
|
|
71 |
adcroft |
1.2 |
% I commented the following because it introduced excessive white space |
72 |
adcroft |
1.8 |
%aja%\usepackage{palatcm} % better PDF |
73 |
adcroft |
1.1 |
|
74 |
|
|
% page headers and footers |
75 |
adcroft |
1.8 |
%cnh%\usepackage{fancyhdr} |
76 |
adcroft |
1.2 |
%\pagestyle{fancy} |
77 |
adcroft |
1.8 |
%cnh%\fancyhead{} |
78 |
|
|
%cnh%\fancyhead[LO]{\slshape \rightmark} |
79 |
|
|
%cnh%\fancyhead[RE]{\slshape \leftmark} |
80 |
|
|
%cnh%\fancyhead[RO,LE]{\thepage} |
81 |
|
|
%cnh%\fancyfoot[CO,CE]{\today} |
82 |
|
|
%cnh%\fancyfoot[RO,LE]{ } |
83 |
|
|
%cnh%\renewcommand{\headrulewidth}{0.4pt} |
84 |
|
|
%cnh%\renewcommand{\footrulewidth}{0.4pt} |
85 |
adcroft |
1.1 |
|
86 |
heimbach |
1.5 |
% bibtex stuff |
87 |
adcroft |
1.10 |
%aja%\newcommand{\BIBPATH}{.} |
88 |
|
|
%aja%\usepackage{natbib} |
89 |
|
|
%aja%\bibliographystyle{\BIBPATH/jmr_my} |
90 |
|
|
%aja%\gdef\harvardleft{[} |
91 |
|
|
%aja%\gdef\harvardright{]} |
92 |
|
|
%aja%\bibpunct{[}{]}{,}{a}{}{,} |
93 |
|
|
\bibliographystyle{plain} |
94 |
heimbach |
1.5 |
|
95 |
adcroft |
1.1 |
% referencing |
96 |
adcroft |
1.8 |
%ph%\newcommand{\refequ}[1]{equation (\ref{equ:#1})} |
97 |
|
|
%ph%\newcommand{\refequbig}[1]{Equation (\ref{equ:#1})} |
98 |
|
|
%ph%\newcommand{\reftab}[1]{Tab.~\ref{tab:#1}} |
99 |
|
|
%ph%\newcommand{\reftabno}[1]{\ref{tab:#1}} |
100 |
|
|
%ph%\newcommand{\reffig}[1]{Fig.~\ref{fig:#1}} |
101 |
|
|
%ph%\newcommand{\reffigno}[1]{\ref{fig:#1}} |
102 |
adcroft |
1.1 |
|
103 |
|
|
% stuff for psfrag |
104 |
adcroft |
1.8 |
%ph%\newcommand{\textinfigure}[1]{{\footnotesize\textbf{\textsf{#1}}}} |
105 |
|
|
%ph%\newcommand{\mathinfigure}[1]{\small\ensuremath{{#1}}} |
106 |
adcroft |
1.1 |
|
107 |
adcroft |
1.3 |
% This allows numbering of subsubsections |
108 |
|
|
\setcounter{secnumdepth}{3} |
109 |
|
|
% This changes the the chapter title |
110 |
|
|
%\renewcommand{\chaptername}{Section} |
111 |
|
|
|
112 |
adcroft |
1.11 |
|
113 |
|
|
% This allows hyperlinks in PDF |
114 |
|
|
% hyperref package and colors for hyperref package |
115 |
|
|
\usepackage{color} |
116 |
cnh |
1.31 |
\usepackage{hyperref} |
117 |
cnh |
1.29 |
%\usepackage[dvips] |
118 |
adcroft |
1.11 |
\definecolor{darkgreen}{rgb}{0,0.4,0} |
119 |
|
|
\definecolor{darkblue}{rgb}{0,0,0.4} |
120 |
|
|
\definecolor{darkred}{rgb}{0.5,0,0} |
121 |
|
|
\hypersetup{breaklinks=true, |
122 |
|
|
colorlinks=true, |
123 |
|
|
linkcolor=darkgreen, |
124 |
|
|
citecolor=darkblue, |
125 |
|
|
pagecolor=darkred, |
126 |
|
|
pdftitle={MITgcm Release 1 Documentation}, |
127 |
edhill |
1.15 |
pdfauthor={MITgcm-support@mitgcm.org}, |
128 |
adcroft |
1.11 |
pdfkeywords={oceanography, ocean model, general circulation model, |
129 |
|
|
non-hydrostatic, finite volume, inverse methods, adjoint method} |
130 |
|
|
} |
131 |
molod |
1.17 |
|
132 |
|
|
% Some definitions (AMM) |
133 |
|
|
\def\p#1{{\partial \over {\partial #1}}} |
134 |
|
|
\def\pp#1#2{{\partial #1 \over {\partial #2}}} |
135 |
|
|
\def\dd#1#2{{d #1 \over {d #2}}} |
136 |
|
|
\def\bq{\begin{equation}} |
137 |
|
|
\def\bqa{\begin{eqnarray}} |
138 |
|
|
\def\eq{\end{equation}} |
139 |
|
|
\def\eqa{\end{eqnarray}} |
140 |
|
|
|
141 |
|
|
\def\h{ {1\over2} } |
142 |
|
|
\def\txt{\mbox{$2^\circ$ x $2.5^\circ \,$}} |
143 |
|
|
\def\fxf{\mbox{$4^\circ$ x $5^\circ \,$}} |
144 |
|
|
|
145 |
|
|
\def\blankpage{ \vspace*{\fill} \vspace{5in} \vfill \newpage} |
146 |
|
|
|
147 |
adcroft |
1.1 |
|
148 |
|
|
\begin{document} |
149 |
cnh |
1.9 |
|
150 |
|
|
\bodytext{bgcolor="#FFFFFFFF"} |
151 |
adcroft |
1.1 |
|
152 |
|
|
\tableofcontents |
153 |
adcroft |
1.10 |
%\pagebreak |
154 |
adcroft |
1.1 |
|
155 |
adcroft |
1.10 |
%\part{MIT GCM basics} |
156 |
adcroft |
1.3 |
|
157 |
|
|
% Section: Overview |
158 |
adcroft |
1.1 |
\input{part1/part1} |
159 |
adcroft |
1.8 |
%\pagebreak |
160 |
adcroft |
1.1 |
|
161 |
adcroft |
1.3 |
% Section: Discretization and Algorithm |
162 |
adcroft |
1.1 |
\input{part2/part2} |
163 |
adcroft |
1.8 |
%\pagebreak |
164 |
adcroft |
1.1 |
|
165 |
adcroft |
1.3 |
% Section: Getting started |
166 |
adcroft |
1.1 |
\input{part3/part3} |
167 |
adcroft |
1.8 |
%\pagebreak |
168 |
adcroft |
1.1 |
|
169 |
adcroft |
1.3 |
% Section: Software Architecture |
170 |
adcroft |
1.1 |
\input{part4/part4} |
171 |
adcroft |
1.8 |
%\pagebreak |
172 |
adcroft |
1.1 |
|
173 |
adcroft |
1.3 |
|
174 |
adcroft |
1.10 |
%\part{Adjoint of the MIT GCM} |
175 |
adcroft |
1.3 |
|
176 |
|
|
% Section: Automatic Differentiation |
177 |
adcroft |
1.1 |
\input{part5/part5} |
178 |
adcroft |
1.8 |
%\pagebreak |
179 |
adcroft |
1.1 |
|
180 |
adcroft |
1.3 |
|
181 |
adcroft |
1.10 |
%\part{Additional features} |
182 |
adcroft |
1.3 |
|
183 |
|
|
% Section: Physical Packages |
184 |
adcroft |
1.1 |
\input{part6/part6} |
185 |
adcroft |
1.8 |
%\pagebreak |
186 |
adcroft |
1.1 |
|
187 |
molod |
1.30 |
% Section: Pre-processing and Post-processing Tools |
188 |
adcroft |
1.1 |
\input{part7/part7} |
189 |
adcroft |
1.14 |
%\pagebreak |
190 |
|
|
|
191 |
|
|
% Section: ECCO |
192 |
|
|
\input{part8/part8} |
193 |
edhill |
1.24 |
%\pagebreak |
194 |
|
|
|
195 |
|
|
% Section: Model Uses |
196 |
|
|
\input{model_uses} |
197 |
adcroft |
1.8 |
%\pagebreak |
198 |
adcroft |
1.1 |
|
199 |
heimbach |
1.5 |
% Section: References: |
200 |
adcroft |
1.10 |
%\markboth{BIBLIOGRAPHY}{BIBLIOGRAPHY} |
201 |
heimbach |
1.6 |
\addcontentsline{toc}{chapter}{BIBLIOGRAPHY} |
202 |
adcroft |
1.10 |
%aja%\bibliography{\BIBPATH/manual_references} |
203 |
|
|
\bibliography{manual_references} |
204 |
heimbach |
1.6 |
|
205 |
adcroft |
1.1 |
\end{document} |