Changeset 3989 for branches/2013/dev_r3853_CNRS9_ConfSetting/DOC/TexFiles/Chapters/Introduction.tex

Timestamp:

2013-07-24T11:48:35+02:00 (11 years ago)

Author:

clevy

Message:

Configuration setting/Step3 and doc, see ticket:#1074

File:

• branches/2013/dev_r3853_CNRS9_ConfSetting/DOC/TexFiles/Chapters/Introduction.tex (modified) (1 diff)

branches/2013/dev_r3853_CNRS9_ConfSetting/DOC/TexFiles/Chapters/Introduction.tex

@@ -81 +81 @@
 the coefficients with \citet{Blanke1993}, \citet{Large_al_RG94}, \citet{Pacanowski_Philander_JPO81}, 
 or \citet{Umlauf_Burchard_JMS03} mixing schemes.
+ \vspace{1cm}
+ 
+ 
+\noindent CPP keys and namelists are used for inputs to the code.  \newline
+
+\noindent \index{CPP keys} CPP keys \newline
+Some CPP keys are implemented in the FORTRAN code to allow code selection at compiling step. This selection of code at compilation time reduces the reliability of the whole platform since it changes the code from one set of CPP keys to the other. It is used only when the addition/suppression of the part of code highly changes the amount of memory at run time.
+Usual coding looks like : 
+ \vspace{-10pt}
+\begin{alltt}
+\tiny  
+\begin{verbatim}
+#if defined key_option1    
+             This part of the FORTRAN code will be active   
+             only if key_option1 is activated at compiling step 
+#endif  
+\end{verbatim} 
+\end{alltt}     
+
+
+\noindent \index{Namelist} Namelists
+
+The namelist allows to input variables (character, logical, real and integer) into the code. There is one namelist file for each component of NEMO (dynamics, sea-ice, biogeochemistry...) containing all the FOTRAN namelists needed. The implementation in NEMO uses a two step process. For each FORTRAN namelist, two files are read:
+\begin{enumerate}
+\item A reference namelist ( in \textit{CONFIG/SHARED/namelist\_ref} ) is read first. This file contains all the namelist variables which are initialised to default values  
+\item A configuration namelist ( in \textit{CONFIG/CFG\_NAME/EXP00/namelist\_cfg} ) is read aferwards. This file contains only the namelist variables which are changed from default values, and overwrites those.
+\end{enumerate}
+A template can be found in \textit{NEMO/OPA\_SRC/module.example}
+The effective namelist, taken in account during the run, is stored at execution time in an output\_namelist\_dyn (or \_ice or \_top) file.
+ \vspace{1cm}
+
 
 Model outputs management and specific online diagnostics are described in chapters~\ref{DIA}.