Commit 8f39154b authored by Nadine Wieters's avatar Nadine Wieters

Added description for changing fesom14 output.

parent a18efb4f
No preview for this file type
......@@ -10,6 +10,7 @@
%\usepackage{tocstyle}
\usepackage{layout}
\usepackage{glossaries}
\usepackage[super]{nth}
\newcommand{\model}[1]{\sffamily{#1}\normalfont}
......@@ -840,8 +841,40 @@ And you can change the frequency of how often a restart snapshot will be written
restart_rate_fesom=1
restart_unit_fesom='m'
\end{lstlisting}
\subsubsection{Change FESOM1.4 output frequency}
\index{\model{FESOM1.4}\ output} The output frequency of \model{FESOM1.4}\ is controlled by YAML syntax. To change the default behaviour for a output variable, you have to set the output frequencies in your runscript explicitly for \textbf{all} possible variables. See listing \ref{yaml_example} for an example.
\subsubsection{Change FESOM1.4 output and output frequency}
\index{\model{FESOM1.4}\ output} The output and output frequency of \model{FESOM1.4}\ is controlled by a output scheduler written in C++ and uses a YAML configuration file. To change the default behaviour for the output, you can set this in your runscript and the esm-runscript functions will generate a YAML configuration file that can be read in by the outpput scheduler of \model{FESOM1.4}. \textbf{You have to set the output frequencies in your runscript explicitly for \textbf{all} possible variables or none at all. In the latter case, the default (see example in listing \ref{yaml_example}) will be taken.}
To set a different output (other than the default), set the following variables in your runscript as described in the following.
\begin{description}
\item[fesom\_yaml\_number\_varlist=n] Number of different output frequencies. You have to set a list of variables that should be written to output in the same frequency. Set here the number of different output frequencies you have in the output. For each different nth frequency, set also the following variables:
\item[fesom\_yaml\_varlist\_n="var1,var2,var3"] A list of variables with output frequency n.
\item[fesom\_yaml\_unit\_n="\texttt{<value>}"] The unit of the n$^{th}$ output frequency. Replace \verb|<value>| with a value described in table \ref{tab:fesom14_output_units}.
\item[fesom\_yaml\_rate\_n="\texttt{<number>}"] The n$^{th}$ output frequency. Replace \verb|<number>| with a number of the output frequency (in the unit set by \verb|fesom_yaml_unit_n|).
\item[fesom\_yaml\_first\_n="\texttt{<number>}"] Number (in units of \verb|fesom_yaml_unit_n|) at which the first output for the n$^{th}$ output frequency should be written.
\end{description}
See listing \ref{yaml_example} for an example. This example describes also the default output.
Possible output frequency units are:
\begin{table}[h]
\centering
\begin{tabular}{|c|l|}
\hline
\textbf{Value} & \textbf{Associated Unit} \\
\hline
s & model timesteps \\
\hline
d & days \\
\hline
m & months \\
\hline
y & years \\
\hline
\end{tabular}
\caption{\model{FESOM1.4} output units}
\label{tab:fesom14_output_units}
\end{table}
%\begin{fullpage}
% \label{yaml_example}
......@@ -859,9 +892,9 @@ restart_unit_fesom='m'
fesom_yaml_number_varlist=4
fesom_yaml_varlist_1="tso"
fesom_yaml_unit_1="m"
fesom_yaml_rate_1=1
fesom_yaml_first_1=1
fesom_yaml_unit_1="s"
fesom_yaml_rate_1=12
fesom_yaml_first_1=12
fesom_yaml_varlist_2="evs,fsitherm,hfds,opottemptend,pbo,prlq,prsn,rsdo,siarean,siareas,sidmassevapsubl,sidmasssi,sidmassth,sidmasstranx,sidmasstrany,siextentn,siextents,sifllatstop,sisnconc,sisnmass,sisnthick,sispeed,sivol,sivoln,sivols,soga,thetaoga,u2o,uo,uso,uto,v2o,vo,volo,vso,vto,w2o,wfo,wo,wso,wto,zossq,rho,uhice,uhsnow,urho,uv,vhice,vhsnow,virtual_salt,vrho"
......@@ -870,13 +903,13 @@ fesom_yaml_rate_2=1
fesom_yaml_first_2=1
fesom_yaml_varlist_3="lwrd,olat,olwout,osen,relax_salt,shum,tair,uwind,vwind"
fesom_yaml_unit_3="m"
fesom_yaml_unit_3="y"
fesom_yaml_rate_3=1
fesom_yaml_first_3=1
fesom_yaml_first_3=1000
fesom_yaml_varlist_4="mlotst,omldamax,sic,sistrxdtop,sistrxubot,sistrydtop,sistryubot,sithick,sitimefrac,siu,siv,so,sos,tauuo,tauvo,thetao,tos,zos,flice,wnet,evap,runoff,thdgr,thdgrsn"
fesom_yaml_unit_4="m"
fesom_yaml_unit_4="d"
fesom_yaml_rate_4=1
fesom_yaml_first_4=1
\end{lstlisting}
......@@ -887,6 +920,20 @@ For \model{AWI-CM 1.4} post processing is switched on per default. To switch it
\begin{verbatim}
POST_PROCESSING_awicm=0
\end{verbatim}
To generate one file for each run when writing more then once to output, set
\begin{verbatim}
CONCATENATE_POST_PROCESS_echam=1
\end{verbatim}
More option regarding post-processing:
\paragraph*{Echam:}
\begin{verbatim}
MEANTAGS_echam="BOT LOG MM"
\end{verbatim}
\paragraph*{Fesom:}
\begin{verbatim}
MEANTAGS_fesom="BOT LOG MM"
\end{verbatim}
\subsection{AWI-CM 2}
\subsection{PISM}
\subsection{Recom}
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment