source: palm/trunk/TUTORIAL/SOURCE/user_defined_code.tex @ 1434

Last change on this file since 1434 was 1234, checked in by kanani, 11 years ago

update of some tutorial presentations

  • Property svn:keywords set to Id
File size: 46.3 KB
Line 
1% $Id: user_defined_code.tex 1234 2013-09-25 06:17:49Z keck $
2\input{header_tmp.tex}
3%\input{../header_lectures.tex}
4
5\usepackage[utf8]{inputenc}
6\usepackage{ngerman}
7\usepackage{pgf}
8\usetheme{Dresden}
9\usepackage{subfigure}
10\usepackage{units}
11\usepackage{multimedia}
12\usepackage{hyperref}
13\newcommand{\event}[1]{\newcommand{\eventname}{#1}}
14\usepackage{xmpmulti}
15\usepackage{tikz}
16\usetikzlibrary{shapes,arrows,positioning}
17%\usetikzlibrary{decorations.markings}             %neues paket
18%\usetikzlibrary{decorations.pathreplacing}        %neues paket
19\def\Tiny{\fontsize{4pt}{4pt}\selectfont}
20\usepackage{amsmath}
21\usepackage{amssymb}
22\usepackage{multicol}
23\usepackage{pdfcomment}
24\usepackage{graphicx}
25\usepackage{listings}
26\lstset{showspaces=false,language=fortran,basicstyle=
27        \ttfamily,showstringspaces=false,captionpos=b}
28
29\institute{Institut fÌr Meteorologie und Klimatologie, Leibniz UniversitÀt Hannover}
30\date{last update: \today}
31\event{PALM Seminar}
32\setbeamertemplate{navigation symbols}{}
33
34\setbeamertemplate{footline}
35  {
36    \begin{beamercolorbox}[rightskip=-0.1cm]&
37     {\includegraphics[height=0.65cm]{imuk_logo.pdf}\hfill \includegraphics[height=0.65cm]{luh_logo.pdf}}
38    \end{beamercolorbox}
39    \begin{beamercolorbox}[ht=2.5ex,dp=1.125ex,
40      leftskip=.3cm,rightskip=0.3cm plus1fil]{title in head/foot}
41      {\leavevmode{\usebeamerfont{author in head/foot}\insertshortauthor} \hfill \eventname \hfill \insertframenumber \; / \inserttotalframenumber}
42    \end{beamercolorbox}
43    \begin{beamercolorbox}[colsep=1.5pt]{lower separation line foot}
44    \end{beamercolorbox}
45  }
46%\logo{\includegraphics[width=0.3\textwidth]{luhimuk_logo.pdf}}
47
48\title[The PALM User-Interface]{The PALM User-Interface}
49\author{Siegfried Raasch}
50
51\begin{document}
52
53% Folie 1
54\begin{frame}
55\titlepage
56\end{frame}
57
58\section{The PALM User-Interface}
59\subsection{The PALM User-Interface}
60
61% Folie 2
62\begin{frame}
63   \frametitle{Purpose of the User-Interface}
64   \scriptsize
65   \begin{itemize}
66      \item<2-> The standard (default) PALM code cannot account for every specific demand of a user. In order to include these specific demands, the user would have to modify the standard code.
67   \end{itemize}
68   \vspace{2mm}
69   \onslide<3->
70   \textbf{Problem:}
71   \begin{itemize}
72      \item<3-> If a new PALM version is released (current release is 3.9) and the user wants to use it, he would have to add his modifications to the new release again.
73   \end{itemize}   
74   \vspace{3mm}
75   \onslide<4->
76   \textbf{Solution:}
77   \begin{itemize}
78      \item<4-> PALM offers a \grqq user-interface\grqq, i.e. a set of subroutines, where the user can add his modifications and which can be re-used for future releases of the standard PALM code.
79      \item<5-> By using the user-interface, the standard code does not have to be modified by the user in most of all cases.
80      \item<6-> The user-interface subroutines are almost \grqq empty\grqq\, by default. They are called from the standard PALM code but (with some very minor exceptions) do not contain any executable code.
81   \end{itemize}   
82\end{frame}
83
84% Folie 3
85\begin{frame}
86   \frametitle{General Structure of the User-Interface}
87   \tikzstyle{yellow} = [rectangle, draw, fill=yellow!30, text width=0.7\textwidth, font=\Tiny]
88   \scriptsize
89   \begin{itemize}
90      \item<1-> All routines can be found under \texttt{.../trunk/SOURCE}.
91      \item<2-> There is one file for each routine. Filenames are \texttt{user\underline{ }*.f90}.\\
92Example: \texttt{user\underline{ }last\underline{ }actions.f90}
93   \end{itemize}
94   \onslide<3->
95   \begin{center}
96   \begin{tikzpicture}[auto]
97      \node[yellow]{~\texttt{SUBROUTINE user\_last\_actions} \\
98                    \par\medskip
99                    \texttt{!------------------------------------------------------------------------------!}\\
100                    \texttt{!}\\
101                    \texttt{! Description:}\\
102                    \texttt{! ------------}\\
103                    \texttt{! Execution of user-defined actions at the end of a job.}\\
104                    \texttt{!------------------------------------------------------------------------------!}\\
105                    \par\medskip
106                    ~~~~\texttt{USE control\_parameters}\\
107                    ~~~~\texttt{USE user}\\
108                    \par\medskip
109                    ~~~~\texttt{IMPLICIT NONE}\\
110                    \par\medskip
111                    \texttt{!}\\
112                    \texttt{!-- Here the user-defined actions at the end of a job follow.}\\
113                    \texttt{!-- Sample for user-defined output:}\\
114                    \vspace{0.5mm}
115                    ~~~~\texttt{IF ( write\_binary(1:4) == 'true' )  THEN}\\
116                    \vspace{0.5mm}
117                    \texttt{!~~~~~~~IF ( ALLOCATED( u2\_av ) )  THEN}\\
118                    \vspace{0.5mm}
119                    \texttt{!~~~~~~~~~~WRITE ( 14 )  'u2\_av~~~~~~~~~~~~~~~';  WRITE ( 14 )  u2\_av}\\
120                    \vspace{0.5mm}
121                    \texttt{!~~~~~~~ENDIF}\\
122                    \par\medskip
123                    ~~~~~~~\texttt{WRITE ( 14 )  '*** end user ***~~~~'}\\
124                    \par\medskip
125                    ~~~~\texttt{ENDIF}\\
126                    \par\medskip
127                    ~\texttt{END SUBROUTINE user\_last\_actions}};
128   \end{tikzpicture}
129   \end{center}
130%   \includegraphics[scale=0.3]{user_defined_code_figures/user_last_actions.png}\\   
131\end{frame}
132
133% Folie 4
134\begin{frame}
135   \frametitle{Embedding of User-Interface Routines}
136   \tikzstyle{yellow} = [rectangle, draw, fill=yellow!30, text width=0.7\textwidth, font=\Tiny]
137   \scriptsize
138   \begin{itemize}
139      \item<1-> The user-interface routines are called from specific, well-defined locations in the standard PALM code.\\
140   \ \\
141   Example from \texttt{palm.f90}:
142   \end{itemize}
143   \onslide<2->
144   \begin{center}
145      \begin{tikzpicture}[auto]
146         \node[yellow]{~\texttt{...}\\
147                       \vspace{0.5mm}
148                       \texttt{!}\\
149                       \texttt{!-- If required, final user-defined actions, and}\\
150                       \texttt{!-- last actions on the open files and close files. Unit 14 was opened}\\
151                       \texttt{!-- in write\_3d\_binary but it is closed here, to allow writing on this}\\
152                       \texttt{!-- unit in routine user\_last\_actions.}\\
153                       \vspace{0.5mm}
154                       ~~~~\texttt{CALL cpu\_log( log\_point(4), 'last actions', 'start' )}\\
155                       ~~~~\texttt{DO  i = 0, io\_blocks-1}\\
156                       ~~~~~~~\texttt{IF ( i == io\_group )  THEN}\\
157                       ~~~~~~~~~~\texttt{\textcolor{blue}{CALL user\_last\_actions}}\\
158                       \vspace{0.5mm}
159                       ~~~~~~~~~~\texttt{IF ( write\_binary(1:4) == 'true' )  CALL close\_file( 14 )}\\
160                       ~~~~~~~\texttt{ENDIF}\\
161                       \vspace{0.5mm}
162                       \texttt{\#if defined( \_\_parallel )}\\
163                       ~~~~~~~\texttt{CALL MPI\_BARRIER( comm2d, ierr )}\\
164                       \vspace{0.5mm}
165                       \texttt{\#endif}\\
166                       \vspace{0.5mm}
167                       ~~~~\texttt{ENDDO}\\
168                       \vspace{0.5mm}
169                       ~~~~\texttt{CALL close\_file( 0 )}\\
170                       \vspace{0.5mm}
171                       ~~~~\texttt{CALL close\_dvrp}\\
172                       ~~~~\texttt{CALL cpu\_log( log\_point(4), 'last actions', 'stop' )}\\
173                       \vspace{1mm}
174                       ~\texttt{...}\\
175                       \vspace{1mm}
176                       \texttt{!}\\
177                       \texttt{!-- Take final CPU-time for CPU-time analysis}\\
178                       ~~~~\texttt{CALL cpu\_log( log\_point(1), 'total', 'stop' )}\\
179                       ~~~~\texttt{CALL cpu\_statistics}\\
180                       \texttt{\#if defined( \_\_parallel )}\\
181                       ~~~~\texttt{CALL MPI\_FINALIZE( ierr )}\\
182                       \vspace{0.5mm}
183                       \texttt{\#endif}\\
184                       \par\medskip
185                       ~\texttt{END PROGRAM palm}};
186      \end{tikzpicture} 
187   \end{center}
188
189%   \includegraphics[scale=0.33]{user_defined_code_figures/embedding.png}\\
190\end{frame}
191
192
193% Folie 5
194\begin{frame}
195   \frametitle{Embedding of User-Interface Routines\\
196   Flow Chart Overview (I): Initial Steps}
197   \scriptsize
198   \begin{tikzpicture}[scale=0.8, transform shape]
199      % Define colours
200      \tikzstyle{green} = [draw, fill=green!30, text width=7.1em, text centered, minimum height=1.6em]
201      \tikzstyle{green1} = [draw, fill=green!30, text width=12em, text centered, minimum height=1.6em]
202      \tikzstyle{green2} = [draw, fill=green!30, text width=10em, text centered, minimum height=1.6em]
203      \tikzstyle{yellow} = [draw, fill=yellow!30, text width=7.1em, text centered, minimum height=1.6em]
204      \tikzstyle{orange} = [draw, fill=orange!60, text width=7.1em, text centered]
205     
206      % Define coordinates and draw nodes     
207      \node[yellow, text width=5em] (PALM) at (0,0.1) {PALM};
208
209      \coordinate (A) at (0,-0.7);
210      \node[yellow, right=0.6cm of A] (parin) {parin};
211
212      \node[green, right=1mm of parin] (userparin) {user\_parin};
213      \draw[-] (parin) -- (userparin);
214
215      \coordinate[below=0.6cm of A] (B);
216      \node[yellow, right=0.6cm of B] (initgrid) {init\_grid};
217
218      \node[green, right=1mm of initgrid] (userinigrid) {user\_init\_grid};
219      \draw[-] (initgrid) -- (userinigrid);
220
221      \coordinate[below=0.6cm of B] (C);
222      \node[yellow, right=0.6cm of C] (checkparam) {check\_parameters};
223
224      \coordinate[below=0.3cm of checkparam] (D);
225      \node[green1, right=0.6cm of D] (usercheckdataout) {user\_check\_data\_output/\_pr};
226
227      \coordinate[below=0.55cm of D] (E);
228      \node[green1, right=0.6cm of E] (usercheckparam) {user\_check\_parameters};
229
230      \coordinate[below=1.7cm of C] (F);
231      \node[yellow, right=0.6cm of F] (init3dmodel) {init\_3d\_model};
232
233      \coordinate[below=0.3cm of init3dmodel] (G);
234      \node[green2, right=0.6cm of G] (userinit3d) {user\_init\_3d\_model};
235
236      \coordinate[below=0.55cm of G] (H);
237      \node[yellow, right=0.6cm of H] (read3dbin) {read\_3d\_binary};
238
239      \coordinate[below=0.3cm of read3dbin] (I);
240      \node[green1, right=0.6cm of I] (userreadrestart) {user\_read\_restart\_data};
241
242      \coordinate[below=1.15cm of H] (J);
243      \node[green1, right=0.6cm of J] (userinitplan) {user\_init\_plant\_canopy};
244
245      \coordinate[below=0.6cm of J] (K);
246      \node[yellow, right=0.6cm of K] (lpminit) {lpm\_init};
247
248      \node[green, right=1mm of lpminit] (userlpminit) {user\_lpm\_init};
249      \draw[-] (lpminit) -- (userlpminit);     
250
251      \coordinate[below=0.6cm of K] (L);
252      \node[green, right=0.6cm of L] (userinit) {user\_init};
253
254      \coordinate[below=4.05cm of F] (M);
255      \node[yellow, right=0.6cm of M] (header) {header};
256
257      \node[green, right=1mm of header] (userheader) {user\_header};
258      \draw[-] (header) -- (userheader);     
259%     
260       % Draw lines
261       \draw[-, thick] (PALM) -- (0,-7.8);
262       \draw[dotted, thick] (0,-8.2) -- (0,-7.8);
263       \draw[-] (A) -- (parin);
264       \draw[-] (B) -- (initgrid);
265       \draw[-] (C) -- (checkparam);
266       \draw[-] (checkparam.south) |- (usercheckdataout.west);
267       \draw[-] (checkparam.south) |- (usercheckparam.west);
268       \draw[-] (F) -- (init3dmodel);
269       \draw[-,dashed] (init3dmodel.south) |- (userinit3d.west);
270       \draw[-,dashed] (init3dmodel.south) |- (read3dbin.west);
271       \draw[-] (read3dbin.south) |- (userreadrestart.west);
272       \draw[-,dashed] (init3dmodel.south) |- (userinitplan);
273       \draw[-,dashed] (init3dmodel.south) |- (lpminit);
274       \draw[-] (init3dmodel.south) |- (userinit);
275       \draw[-] (M) -- (header);   
276     
277   \end{tikzpicture}
278\end{frame}
279
280% Folie 6
281\begin{frame}
282   \frametitle{Embedding of User-Interface Routines\\
283   Flow Chart Overview (II): Time Integration Loop}
284   \scriptsize
285   \begin{tikzpicture}[scale=0.7, transform shape]
286      % Define colours
287      \tikzstyle{green} = [draw, fill=green!30, text width=7.1em, text centered, minimum height=1.6em]
288      \tikzstyle{green1} = [draw, fill=green!30, text width=10em, text centered, minimum height=1.6em]
289      \tikzstyle{yellow} = [draw, fill=yellow!30, text width=7.1em, text centered, minimum height=1.6em]
290      \tikzstyle{orange} = [draw, fill=orange!60, text width=7.1em, text centered]
291      \tikzstyle{orange1} = [draw, fill=orange!80, text width=11em, text centered]     
292      \definecolor{grey}{rgb}{0.25,0.25,0.25}
293
294      % Define coordinates and draw nodes     
295      \node[draw, text width=25em,minimum height=4.0em,fill=black!15] (progframe) at (5.75,-1.5) {};
296
297      \coordinate (A) at (0,0);
298
299      \node[orange, right=0.6cm of A] (timeint) {time\_integration};       
300     
301      \coordinate[below=0.3cm of timeint] (B);
302      \coordinate[below=0.8cm of timeint] (C);   
303      \coordinate[right=2cm of C] (D);   
304      \coordinate[right=3.8cm of D] (E);
305                 
306      \node[green, right=0.6cm of B, text width=14em] (useractions1) {\textcolor{blue}{user\_actions\_(\textit{'before\_timestep'})}};   
307         
308      \node[orange1, below=0.2cm of D] (progeq) {prognostic\_equations\_vector};   
309      \node[orange1, below=0.2cm of E] (progeqfast) {prognostic\_equations\_cache};
310           
311      \node[green, right=0.3cm of progframe, text width=14em] (useractions2) {\textcolor{blue}{user\_actions\_(\textit{'*\_tendency'})}};
312     
313     
314      \coordinate[below=2.3cm of timeint] (F);
315      \coordinate[below=2.9cm of timeint] (G);
316      \coordinate[below=3.5cm of timeint] (H);
317      \coordinate[below=4.1cm of timeint] (I);
318
319                             
320      \node[yellow, right=0.6cm of F] (lpm) {lpm};
321      \node[green, right=0.9cm of lpm, text width=10em] (userlpmadvec) {user\_lpm\_advec};
322      \node[yellow, right=0.6cm of G] (exchangehoriz) {exchange\_horiz}
323%      \node[yellow, right=0.0cm of exchangehoriz] (asselin) {asselin\_filter};     
324      \node[yellow, right=0.6cm of H] (swaptimelevel) {swap\_timelevel};
325      \node[yellow, right=0.6cm of I] (pres) {pres};
326     
327      \coordinate[below=0.3cm of pres] (J);   
328      \coordinate[below=5.1cm of timeint] (K);     
329      \coordinate[below=5.7cm of timeint] (L);
330      \coordinate[below=6.3cm of timeint] (M);
331      \coordinate[below=6.9cm of timeint] (N);     
332      \coordinate[below=8.2cm of timeint] (O);
333      \coordinate[below=8.8cm of timeint] (P);     
334                 
335%      \node[yellow, right=0.6cm of K] (prandtlfluxes) {prandtl\_fluxes};   
336      \node[green, right=0.6cm of K, text width=14em] (useractions3) {\textcolor{blue}{user\_actions\_(\textit{'after\_integration'})}};             
337%      \node[yellow, right=0.6cm of L] (diffusivities) {diffusivities};             
338%      \node[yellow, right=0.6cm of L] (checkrestart) {check\_for\_restart};     
339      \node[yellow, right=0.6cm of L] (flowstat) {flow\_statistics};
340      \node[green, right=0.6cm of flowstat] (userstat2) {user\_statistics}
341
342      \node[yellow, right=0.6cm of M] (sum3ddata) {sum\_up\_3d\_data}
343      \node[green1, right=0.6cm of sum3ddata] (user3ddataav) {user\_3d\_data\_averaging};
344
345      \node[green, right=0.6cm of O, text width=14em] (useractions4) {\textcolor{blue}{user\_actions\_(\textit{'after\_timestep'})}};
346%      \node[yellow, right=0.6cm of P] (timestep) {timestep};             
347
348      \node[yellow, right=0.2cm of user3ddataav] (dataoutput) {data\_output\_***};
349      \node[green, right=0.2cm of dataoutput] (userdvrpcoltab) {user\_dvrp\_coltab};
350      \coordinate[below=0.2cm of dataoutput] (Q);   
351      \coordinate[right=0.4cm of Q] (R);   
352      \coordinate[right=3.0cm of R] (S);
353         
354      \node[green, below=0.2cm of R, text width=9em] (output2d) {user\_data\_output\_2d};
355      \node[green, below=0.2cm of S, text width=9em] (output3d) {user\_data\_output\_3d};
356     
357
358
359      \draw[dotted, thick] (0,0.05) -- (0,0.3);
360      \draw[-, thick] (0,0.05) -- (0,-8.8);
361      \draw[dotted, thick] (0,-9.2) -- (0,-8.8);
362      \draw[-, thick] (A) -- (timeint);
363      \draw[-, thick] (timeint) -- (P);
364      \draw[-, thick] (B) -- (useractions1);
365      \draw[-, thick] (C) -- (D);
366      \draw[-, thick] (D) -- (E);
367      \draw[->, thick] (E) -- (progeqfast);
368      \draw[-, thick] (progeq) -- (D);     
369      \draw[-, thick] (progframe) -- (useractions2);
370      \draw[-, thick] (F) -- (lpm);   
371      \draw[-, thick] (userlpmadvec) -- (lpm);   
372      \draw[-, thick] (G) -- (exchangehoriz);
373      \draw[-, thick] (H) -- (swaptimelevel);
374      \draw[-, thick] (I) -- (pres);     
375      \draw[dotted, thick] (pres) -- (J);
376%      \draw[-, thick] (K) -- (prandtlfluxes);   
377      \draw[-, thick] (K) -- (useractions3);     
378      \draw[-, thick] (L) -- (flowstat); 
379      \draw[-, thick] (M) -- (sum3ddata); 
380      \draw[-, thick] (sum3ddata) -- (user3ddataav);
381
382      \draw[-, thick] (userstat2) -- (flowstat); 
383      \draw[-, thick] (O) -- (useractions4);
384%      \draw[-, thick] (O) -- (timestep);   
385      \draw[-, thick] (dataoutput) -- (Q);
386      \draw[-, thick] (S) -- (Q);
387      \draw[-, thick] (R) -- (output2d);
388      \draw[-, thick] (S) -- (output3d);
389   \end{tikzpicture}
390\end{frame}
391
392
393% Folie 7
394\begin{frame}
395   \frametitle{Embedding of User-Interface Routines\\
396   Flow Chart Overview (III): Final Steps}
397   \scriptsize
398   \begin{tikzpicture}[scale=0.8, transform shape]
399      % Define colours
400      \tikzstyle{green} = [draw, fill=green!30, text width=7.1em, text centered, minimum height=1.6em]
401      \tikzstyle{yellow} = [draw, fill=yellow!30, text width=7.1em, text centered, minimum height=1.6em]
402      \tikzstyle{orange} = [draw, fill=orange!60, text width=7.1em, text centered]
403     
404      % Define coordinates and draw nodes     
405      \node[green, text width=5em] (PALM) at (0,0.1) {PALM};
406
407      \coordinate (A) at (0,-0.7);
408
409
410      \node[orange, right=0.6cm of A] (timeint) {time\_integration};       
411      \coordinate[below=0.5cm of timeint] (B);
412      \coordinate[below=1.0cm of timeint] (C);   
413     
414      \coordinate[below=2.5cm of PALM] (D); 
415     
416      \node[yellow, right=0.6cm of D] (write3dbinary) {write\_3d\_binary};
417      \node[yellow, right=0.9cm of write3dbinary] (writevarlist) {write\_var\_list};   
418       
419      \coordinate[below=3.5cm of PALM] (E);
420      \coordinate[below=4.1cm of PALM] (F);
421      \coordinate[below=4.7cm of PALM] (G);
422      \node[yellow, right=0.6cm of E] (header) {header};     
423      \node[green, right=0.6cm of F] (userlastactions) {user\_last\_actions};   
424      \node[yellow, right=0.6cm of G] (cpustat) {cpu\_statistics};               
425      % Draw lines
426      \draw[-, thick] (PALM) -- (G);
427      \draw[-, thick] (A) -- (timeint);
428      \draw[-, thick] (B) -- (timeint);
429      \draw[dotted, thick] (B) -- (C);
430      \draw[dashed, thick] (D) -- (write3dbinary);
431      \draw[-, thick] (write3dbinary) -- (writevarlist);
432      \draw[-, thick] (E) -- (header);
433      \draw[-, thick] (F) -- (userlastactions);
434      \draw[-, thick] (G) -- (cpustat);
435
436   \end{tikzpicture}
437\end{frame}
438
439% Folie 8
440\begin{frame}
441   \frametitle{Complete List of User-Interface Routines (I)}
442   \tiny
443   \begin{tabular}{|p{2.5cm}|p{2.4cm}|p{2.1cm}|p{3cm}|}
444      \hline
445           \textbf{Name} & \textbf{Arguments} & \textbf{Called from} & \textbf{Task}\\
446           \hline
447           \texttt{user\_3d\_data\_averaging} & \texttt{mode}, \texttt{variable} & \texttt{average\_3d\_data} + \texttt{sum\_up\_3d\_data} & temporal averaging for user-defined quantities\\
448           \hline
449           \texttt{user\_actions} \texttt{user\_actions} & \texttt{location} \,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\,\, \texttt{i}, \texttt{j}, \texttt{location} & \texttt{time\_integration} +
450\texttt{prognostic\_equations} & e.g. additional forces to be included in the prognostic equations\\
451           \hline
452           \texttt{user\_dummy (user\_additional \_routines.f90)} & - - - & - - - & for additional subroutines defined by the user\\
453           \hline
454           \texttt{user\_check\_data\_output} & \texttt{variable}, \texttt{unit} & \texttt{check\_parameters} + \texttt{init\_masks}& check the user-defined output quantities\\
455           \hline
456           \texttt{user\_check\_data\_output\_pr} & \texttt{variable}, \texttt{var\_count}, \texttt{unit} & \texttt{check\_parameters} & check the user-defined profile output quantities\\
457           \hline
458           \texttt{user\_check\_parameters} & - - - & \texttt{check\_parameters} & check user-defined variables\\
459           \hline         
460           \texttt{user\_data\_output\_2d} & \texttt{av}, \texttt{variable}, \texttt{found}, \texttt{grid}, \texttt{local\_pf}, \texttt{two\_d} & \texttt{data\_output\_2d} & output/calculation of additional user-defined quantities\\       
461           \hline         
462           \texttt{user\_data\_output\_3d} & \texttt{av}, \texttt{variable}, \texttt{found}, \texttt{local\_pf}, \texttt{nz\_do} & \texttt{data\_output\_3d} & output/calculation of additional user-defined quantities\\
463           \hline         
464           \texttt{user\_data\_output\_dvrp} & \texttt{output\_variable}, \texttt{local\_pf} & \texttt{data\_output\_dvrp} & output of additional user-defined quantities\\
465           \hline
466           \texttt{user\_data\_output\_mask} & \texttt{av}, \texttt{variable}, \texttt{found}, \texttt{local\_pf} & \texttt{data\_output\_mask} & output of additional masked user-defined quantities\\
467           \hline
468           \texttt{user\_define\_netcdf\_grid} & \texttt{variable}, \texttt{found}, \texttt{grid\_x}, \texttt{grid\_y}, \texttt{grid\_z} & \texttt{netcdf} & defining the grid for additional output quantities\\
469           \hline
470           \texttt{user\_dvrp\_coltab} & \texttt{mode}, \texttt{variable} & \texttt{data\_output\_dvrp} & defining color tables for particles\\   
471           \hline
472           \texttt{user\_header} & \texttt{io} & \texttt{header} & output user variables to header\\
473           \hline
474           \texttt{user\_init} & - - - & \texttt{init\_3d\_model} & e.g. reading from restart file\\
475           \hline
476   \end{tabular}
477
478\end{frame}
479
480% Folie 9
481\begin{frame}
482   \frametitle{Complete List of User-Interface Routines (II)}
483   \tiny
484   \ \\
485   \begin{tabular}{|p{2.5cm}|p{2.4cm}|p{2.1cm}|p{3cm}|}
486      \hline
487           \textbf{Name} & \textbf{Arguments} & \textbf{Called from} & \textbf{Task}\\
488           \hline
489           \texttt{user\_init\_3d\_model} & - - - & \texttt{init\_3d\_model} & special initializations\\
490           \hline
491           \texttt{user\_init\_grid} & \texttt{gls} & \texttt{init\_grid} & defining a special topography\\
492           \hline         
493           \texttt{user\_init\_plant\_canopy} & - - - & \texttt{init\_3d\_model} & setting of leaf area density and canopy drag coefficient\\
494           \hline
495           \texttt{user\_last\_actions} & - - - & \texttt{palm} & e.g. output for restart runs\\
496           \hline
497           \texttt{user\_lpm\_advec} & - - - & \texttt{lpm} & modification of particles after advection \\
498           \hline
499           \texttt{user\_lmp\_init} & - - - & \texttt{lpm\_init} & defining initial particle sources \\
500           \hline
501           \texttt{user\_lpm\_set\_attributes} & - - - & \texttt{lpm} & defining particles attributes \\
502           \hline
503           \texttt{MODULE user (user\_module.f90)} & - - - & - - - & contains user defined variables\\
504           \hline                 
505           \texttt{user\_parin} &  & \texttt{parin} & reading user variables\\     
506           \hline 
507           \texttt{user\_read\_restart\_data} & \texttt{i}, \texttt{nxlfa}, \texttt{nxl\_on\_file}, \texttt{nxrfa}, \texttt{nxr\_on\_file}, \texttt{nynfa}, \texttt{nyn\_on\_file}, \texttt{nysfa}, \texttt{nys\_on\_file}, \texttt{offset\_xa}, \texttt{offset\_ya}, \texttt{overlap\_count}, \texttt{tmp\_2d}, \texttt{tmp\_3d} & \texttt{read\_3d\_binary} & reading user-defined 2d/3d-arrays from the restart file\\         
508           \hline                 
509           \texttt{user\_spectra} & \texttt{mode}, \texttt{m}, \texttt{pr} & \texttt{calc\_spectra} + \texttt{data\_output\_spectra} & output/calculation of additional user-defined quantities\\         
510           \hline         
511           \texttt{user\_statistics} & \texttt{mode}, \texttt{sr}, \texttt{tn} & \texttt{flow\_statistics} & calculating additional horizontal averages + time series quantities\\             
512           \hline             
513   \end{tabular}
514   \ \\
515   \ \\
516   See PALM online documentation under \\
517   \textbf{http://palm.muk.uni-hannover.de/wiki/doc/app/userint}\\
518   for detailed explanations.
519
520\end{frame}
521
522% Folie 10
523\begin{frame}
524   \frametitle{Data Access / Exchange}
525   \tikzstyle{yellow} = [rectangle, draw, fill=yellow!30, text width=0.6\textwidth, font=\tiny]
526   \footnotesize
527   \begin{itemize}
528      \item<2-> \textbf{Between the standard PALM code and the user-interface:}\\
529      \begin{itemize}
530         \scriptsize
531         \item<3-> by including the respective PALM modules in the user-interface subroutines.\\
532         \begin{center}
533%           \includegraphics[scale=0.3]{user_defined_code_figures/data_access_exchange.png}
534            \begin{tikzpicture}[auto]
535               \node[yellow]{\texttt{SUBROUTINE user\_actions( location )} \\
536                             \par\medskip
537                             ~~~~~\texttt{\textcolor{blue}{USE arrays\_3d}} \\
538                             ~~~~~\texttt{\textcolor{blue}{USE control\_parameters}} \\
539                             ~~~~~\texttt{\textcolor{blue}{USE cpulog}} \\
540                             ~~~~~\texttt{\textcolor{blue}{USE indices}} \\
541                             ~~~~~\texttt{\textcolor{blue}{USE interfaces}} \\
542                             ~~~~~\texttt{\textcolor{blue}{USE pegrid}} \\
543                             ~~~~~\texttt{\textcolor{red}{USE user}} \\
544                             \par\medskip
545                             ~~~~~\texttt{IMPLICIT NONE} \\
546                             \par\medskip
547                             ~~~~~\texttt{CHARACTER (LEN=$^\ast$) ::  location} \\
548                             \par\medskip
549                             ~~~~~\texttt{INTEGER ::  i, j, k}};
550            \end{tikzpicture}
551         \end{center} 
552      \end{itemize}
553      \item<4-> \textbf{Within the user-interface:}
554      \begin{itemize}
555         \scriptsize
556         \item by the module \texttt{\textcolor{red}{user}} (file \texttt{user\underline{ }module.f90}),  which is used in every subroutine included in the interface.\\ \textbf{This module is (and should be) never used in the standard PALM code, in order to avoid data flow from the user interface to the\\ PALM default code!}
557      \end{itemize}
558   \end{itemize}
559
560\end{frame}
561
562% Folie 11
563\begin{frame}
564   \frametitle{Usage of \texttt{user\underline{ }actions} (I)}
565   \tikzstyle{yellow} = [rectangle, draw, fill=yellow!30, text width=0.7\textwidth, font=\tiny]
566   \scriptsize
567   \begin{itemize}
568      \item<1-> \texttt{user\underline{ }actions} is designed to add additional terms to the prognostic equations or to carry out special actions at the beginning or the end of each timestep.
569      \vspace{1.8mm}
570      \item<2-> Therefore, several calls of \texttt{user\underline{ }actions} can be found in the default PALM routines \texttt{time\underline{ }integration} and \texttt{prognostic\underline{ }equations}. The place from which it is called is communicated to the routine by a string-argument, e.g.\\
571   \ \\
572   \quad \texttt{CALL user\underline{ }actions ( 'u-tendency' )}\\
573   \ \\
574        \onslide<3-> It means that this call is from a place within \texttt{prognostic\underline{ }equations}, where the tendencies for the u-component are calculated and integrated:
575   \end{itemize}
576   \vspace{-3mm}
577   \begin{center}
578   \begin{tikzpicture}[auto]
579      \node[yellow] {\texttt{DO  i = nxl, nxr} \\
580                     ~~~\texttt{DO  j = nys, nyn} \\
581                     \texttt{...} \\
582                     ~~~~~~\texttt{CALL diffusion\_u( i, j )}\\
583                     ~~~~~~\texttt{CALL coriolis( i, j, 1 )} \\
584                     \texttt{...}\\
585                     ~~~~~~\texttt{\textcolor{blue}{CALL user\_actions( i, j, 'u-tendency' )}}\\
586                     \texttt{!} \\
587                     \texttt{!-- Prognostic equation for u-velocity component} \\
588                     ~~~~~~\texttt{DO  k = nzb\_u\_inner(j,i)+1, nzt} \\
589                     ~~~~~~~~~\texttt{u\_p(k,j,i) = u(k,j,i) + dt\_3d * ( tsc(2) * tend(k,j,i) + \&} \\
590                     \hspace{4.08cm} \texttt{tsc(3) * tu\_m(k,j,i) )       \&} \\
591                     \hspace{2.93cm} \texttt{- tsc(5) * rdf(k) * ( u(k,j,i) - ug(k) )}\\
592                     ~~~~~~\texttt{ENDDO} \\
593                     \texttt{...}};
594   \end{tikzpicture}
595   \end{center}
596%    \begin{center}
597%       \includegraphics[scale=0.33]{user_defined_code_figures/user_actions_1.png}
598%    \end{center}
599\end{frame}
600
601% Folie 12
602\begin{frame}
603   \frametitle{Usage of \texttt{user\underline{ }actions} (II)}
604   \tikzstyle{yellow} = [rectangle, draw, fill=yellow!30, text width=0.7\textwidth, font=\tiny]
605   \scriptsize
606   \begin{itemize}
607      \item Additional tendencies have to be included by the user at the respective code line in \texttt{user\underline{ }actions}:
608   \end{itemize}
609   \begin{center}
610      \begin{tikzpicture}[auto]
611         \node[yellow]{~\texttt{SUBROUTINE user\_actions( location )}\\
612                       \texttt{...}\\
613                       \texttt{!}\\
614                       \texttt{!--    Here the user-defined actions follow}\\
615                       \texttt{!--    No calls for single grid points are allowed at locations before and}\\
616                       \texttt{!--    after the timestep, since these calls are not within an i,j-loop}\\
617                       ~~~~~~~\texttt{SELECT CASE ( location )}\\
618                       \texttt{...}\\
619                       ~~~~~~~~~~\texttt{CASE ( 'after\_timestep' )}\\
620                       \texttt{!}\\
621                       \texttt{!-- Enter actions to be done after every timestep here}\\
622                       \par\medskip
623                       ~~~~~~~~~~\texttt{CASE ( 'u-tendency' )}\\
624                       \texttt{!}\\
625                       \texttt{!-- Enter actions to be done in the u-tendency term here}\\
626                       ~~~~~~~~~~~~~\texttt{\textcolor{blue}{DO i = nxl, nxr}}\\
627                       ~~~~~~~~~~~~~~~~\texttt{\textcolor{blue}{DO j = nys, nyn}}\\
628                       ~~~~~~~~~~~~~~~~~~~\texttt{\textcolor{blue}{DO k = nxb+1, nzt}}\\
629                       ~~~~~~~~~~~~~~~~~~~~~~~~~\texttt{\textcolor{blue}{tend(k,j,i) = tend(k,j,i) - const * u(k,j,i) ...}}\\
630                       ~~~~~~~~~~~~~~~~~~~\texttt{\textcolor{blue}{ENDDO}}\\
631                       ~~~~~~~~~~~~~~~~\texttt{\textcolor{blue}{ENDDO}}\\
632                       ~~~~~~~~~~~~~\texttt{\textcolor{blue}{ENDDO}}\\
633                       \par\bigskip
634                       ~~~~~~~~~~\texttt{CASE ( 'v-tendency' )}\\
635                       \texttt{...}};
636      \end{tikzpicture}
637%      \includegraphics[scale=0.35]{user_defined_code_figures/user_actions_2.png}
638   \end{center}
639\end{frame}
640
641% Folie 13
642\begin{frame}[t]
643   \frametitle{Usage of \texttt{user\underline{ }actions} (III)}
644   \tikzstyle{yellow} = [rectangle, draw, fill=yellow!30, text width=0.5\textwidth, font=\Tiny]
645   \scriptsize
646   \begin{columns}[T]
647      \begin{column}{1.15\textwidth}
648         \begin{itemize}
649            \item<1-> The different versions of \texttt{prognostic\underline{ }equations} (\texttt{prognostic\underline{ }equations\underline{ }cache}, \texttt{prognostic\underline{ }equations\underline{ }vector}) contain different calls of \texttt{user\underline{ }actions}:
650            \item<2-> From \texttt{prognostic\underline{ }equations\underline{ }vector}: \hspace{0.6em}\texttt{CALL user\underline{ }actions ( 'u-tendency' )}
651            \item<3-> From \texttt{prognostic\underline{ }equations},\\
652            \texttt{prognostic\underline{ }equations\underline{ }cache}:\hspace{4em}\texttt{CALL user\underline{ }actions ( i, j, 'u-tendency' )}
653            \vspace{3mm}
654            \item<4-> In case that \texttt{prognostic\underline{ }equations}\\
655            \texttt{prognostic\underline{ }equations\underline{ }cache} are\\
656            used, the user has to add his code in\\
657            the interface routine\\
658            \texttt{user\underline{ }actions\underline{ }ij}:
659            \vspace{3mm}
660            \item<5-> Here, only the \texttt{k}-loop (vertical direction)\\
661            has to be used, because loops over\\
662            i and j are carried out in\\
663            \texttt{prognostic\underline{ }equations\underline{ }cache}.
664         \end{itemize}
665      \end{column}
666   \end{columns}
667 
668   \uncover<4->{%
669   \begin{tikzpicture}[remember picture, overlay]
670      \node [yellow,shift={(9.2 cm,3.0cm)}]  at (current page.south west){~\texttt{SUBROUTINE user\_actions\_ij( i, j, location )}\\
671                                                                          \par\medskip
672                                                                          ~~~\texttt{USE control\_parameters}\\
673                                                                          ~~~\texttt{USE pegrid}\\
674                                                                          ~~~\texttt{USE user}\\
675                                                                          \par\medskip
676                                                                          ~~~\texttt{IMPLICIT NONE}\
677                                                                          \par\medskip
678                                                                          ~~~\texttt{CHARACTER (LEN=*) ::  location}\\
679                                                                          \par\medskip
680                                                                          ~~~\texttt{INTEGER ::  i, idum, j}\\
681                                                                          \par\medskip
682                                                                          \texttt{!}\\
683                                                                          \texttt{!--    Here the user-defined actions follow}\\
684                                                                          \vspace{0.5mm}
685                                                                          ~~~\texttt{SELECT CASE ( location )}\\
686                                                                          \par\medskip
687                                                                          ~~~~~~\texttt{CASE ( 'u-tendency' )}\\
688                                                                          \texttt{!}\\
689                                                                          \texttt{!--Enter actions to be done in the u-tendency term here}\\
690                                                                          ~~~~~~~~~\texttt{\textcolor{blue}{DO k = nzb+1, nzt-1}}\\
691                                                                          ~~~~~~~~~~~~~~~\texttt{\textcolor{blue}{tend(k,j,i) = tend(k,j,i) + ...}}\\
692                                                                          ~~~~~~~~~\texttt{\textcolor{blue}{ENDDO}}\\
693                                                                          \par\medskip
694                                                                          ~~~~~~\texttt{CASE ( 'v-tendency' )}};
695%          {%
696%          \begin{tikzpicture}[remember picture, overlay]
697% %            \node[text width=14em] at (0,0) {\includegraphics[scale=0.3]{user_defined_code_figures/user_actions_3.png}};
698%          \end{tikzpicture}
699%          };
700    \end{tikzpicture}}
701   
702\end{frame}
703
704% Folie 14
705\begin{frame}
706   \frametitle{Steering the User-Interface}
707   \tikzstyle{yellow} = [rectangle, draw, fill=yellow!30, text width=0.7\textwidth, font=\Tiny]
708   \scriptsize
709   \begin{columns}[T]
710      \begin{column}{1.1\textwidth}
711         For steering the user-interface code, the user may want to add some additional variables and set their respective values within the parameter-file (e.g. \texttt{example\underline{ }cbl\underline{ }p3d}). This requires the following actions (example for a variable named \texttt{foo}):
712      \end{column}
713   \end{columns}
714   \vspace{1mm}
715      \begin{enumerate}
716         \item<1-> Add the variable name to module \texttt{user} in order to define it and to make it available in all user-interface subroutines. Set a default value for this variable.
717         \begin{center}
718%            \includegraphics[scale=0.3]{user_defined_code_figures/steering_1.png}
719            \begin{tikzpicture}
720               \node[yellow]{~\texttt{MODULE user}\\
721                             \vspace{0.4mm}
722                             \texttt{...}\\
723                             \vspace{0.4mm}
724                             ~\texttt{REAL \hspace{0.4cm}:: ~~\textcolor{blue}{foo = 0.0}}\\
725                             \vspace{0.4mm}
726                             \texttt{...}\\
727                             \vspace{0.4mm}
728                             ~\texttt{END MODULE user}};
729            \end{tikzpicture}
730         \end{center}
731         \vspace{1mm}
732         \item<2-> Add the variable to the NAMELIST \texttt{/userpar/}. This NAMELIST already contains four predefined variables.
733         \begin{center}
734%            \includegraphics[scale=0.3]{user_defined_code_figures/steering_2.png}
735            \begin{tikzpicture}
736               \node[yellow]{~\texttt{SUBROUTINE user\_parin}\\
737                             \vspace{0.4mm}
738                             \texttt{...}\\
739                             \vspace{0.4mm}
740                             ~~~~~\texttt{NAMELIST ~~/userpar/ ~~ data\_output\_pr\_user, data\_output\_user,}\\
741                             \vspace{0.4mm}
742                             \hspace{3cm}\texttt{\textcolor{blue}{foo}, region}\\
743                             \vspace{0.4mm}
744                             \texttt{...}\\
745                             \vspace{0.4mm}
746                             ~\texttt{END SUBROUTINE user\_parin}};
747            \end{tikzpicture}
748         \end{center}
749         \vspace{1mm}
750         \item<3-> Add the NAMELIST \texttt{\&userpar} to the parameter file (e.g. \texttt{example\underline{ }cbl\underline{ }p3d}) and assign a value to this variable.         
751         \begin{center}
752%            \includegraphics[scale=0.3]{user_defined_code_figures/steering_3.png}
753            \begin{tikzpicture}
754               \node[yellow]{~\texttt{\&inipar ~~~ nx = ... ~~/}\\
755                             \vspace{0.4mm}
756                             ~\texttt{\&d3par ~~~ end\_time = 3600.0, ... ~~/}\\
757                             \par\smallskip
758                             ~\texttt{\textcolor{blue}{\&userpar ~~foo = 12345.6 ~~/}}};
759            \end{tikzpicture}
760         \end{center}
761         \vspace{1mm}
762         \item<4-> Output the variable's value using \texttt{user\underline{ }header}.
763      \end{enumerate}
764     
765
766\end{frame}
767
768% Folie 15
769\begin{frame}
770   \frametitle{User-Defined Output}
771   \scriptsize
772   \begin{itemize}
773      \item<2-> A very typical request of users is the calculation and output of quantities which are not part of PALM's standard output (e.g. a 3D-array of the resolved-scale vertical heat (temperature) flux).
774      \vspace{2mm}
775      \item<3-> The default user interface includes a number of subroutines which allow the calculation of user-defined quantities and output of these quantities as profiles, timeseries, 2d cross section or 3d volume data. These are e.g.\\
776      \texttt{user\underline{ }check\underline{ }data\underline{ }output}, \texttt{user\underline{ }check\underline{ }data\underline{ }output\underline{ }pr},\\
777      \texttt{user\underline{ }define\underline{ }netcdf\underline{ }grid}, \texttt{user\underline{ }statistics},\\
778      \texttt{user\underline{ }3d\underline{ }data\underline{ }averaging}, \texttt{user\underline{ }data\underline{ }output\underline{ }2d},\\
779      \texttt{user\underline{ }data\underline{ }output\underline{ }3d}.
780      \vspace{2mm}
781      \item<4-> The respective subroutines contain, as an example, code lines (written as comment lines) for calculating and output the square of the u-component velocity.
782      \vspace{2mm}
783      \item<5-> These quantities are output to PALM‘s standard netCDF files, i.e.\\ \texttt{DATA\underline{ }1D\underline{ }PR\underline{ }NETCDF}, \texttt{DATA\underline{ }1D\underline{ }TS\underline{ }NETCDF}, \texttt{DATA\underline{ }2D\underline{ }XY\underline{ }NETCDF} or \texttt{DATA\underline{ }3D\underline{ }NETCDF}.
784      \vspace{2mm}
785      \item<6-> The online documentation gives very detailed instructions about how to modify the interface in order to output user-defined quantities under\\
786      \vspace{1mm}
787      \textbf{http://palm.muk.uni-hannover.de/wiki/doc/app/userint/output}
788   \end{itemize}
789\end{frame}
790
791% Folie 16
792\begin{frame}
793   \frametitle{User-Defined Data for Restart Runs (I)}
794   \tikzstyle{yellow} = [rectangle, draw, fill=yellow!30, text width=0.7\textwidth, font=\tiny]
795   \scriptsize
796   \begin{itemize}
797      \item It might be neccessary to save the values of user-defined variables at the end of a model run in order to use them for a restart run.\\
798      \ \\
799      This can be done using the routine \texttt{user\underline{ }last\underline{ }actions}.\\
800      \grqq \texttt{14}\grqq\, is the file-id for the restart file (local filename \texttt{BINOUT}):
801   \end{itemize}
802   \begin{center}
803%      \includegraphics[scale=0.3]{user_defined_code_figures/restart_1.png}
804      \begin{tikzpicture}[auto]
805         \node[yellow]{~\texttt{SUBROUTINE user\_last\_actions}\\
806                       \texttt{...}\\
807                       ~~~~~\texttt{\textcolor{blue}{WRITE ( 14 )  'foo \hspace{2cm}';  WRITE ( 14 )  foo}}\\
808                       ~~~~~\texttt{\textcolor{blue}{WRITE ( 14 )  'bar \hspace{2cm}';  WRITE ( 14 )  bar}}
809                       \par\smallskip
810                       ~~~~~\texttt{WRITE ( 14 ) '*** end user *** \hspace{0.66cm}'}
811                       \par\smallskip
812                       ~\texttt{END SUBROUTINE user\_last\_actions}};
813      \end{tikzpicture}
814   \end{center}
815\end{frame}
816
817% Folie 17
818\begin{frame}
819   \frametitle{User-Defined Data for Restart Runs (II)}
820   \tikzstyle{yellow} = [rectangle, draw, fill=yellow!30, text width=0.95\textwidth, font=\tiny]
821   \scriptsize
822   \begin{itemize}
823      \item Additionally, these variables have to be read from the restart file (file-id \grqq \texttt{13}\grqq\,, local filename \texttt{BININ}) by adding code to the routine \texttt{user\underline{ }read\underline{ }restart\underline{ }data}:
824   \end{itemize}
825   \vspace{-2.7mm}
826   \begin{center}
827%      \includegraphics[scale=0.3]{user_defined_code_figures/restart_2.png}
828      \begin{tikzpicture}
829         \node[yellow]{\texttt{~SUBROUTINE user\_read\_restart\_data( i, nxlfa, nxl\_on\_file, nxrfa, nxr\_on\_file, \&} \\
830                       \hspace{3.84cm}\texttt{nynfa, nyn\_on\_file, nysfa, nys\_on\_file,    \&} \\
831                       \hspace{3.84cm}\texttt{offset\_xa, offset\_ya, overlap\_count,       \&} \\
832                       \hspace{3.84cm}\texttt{tmp\_2d, tmp\_3d )}\\
833                       \texttt{...} \\
834                       ~~~~~\texttt{IF ( initializing\_actions == 'read\_restart\_data' )  THEN}\\
835                       ~~~~~~~~~\texttt{READ ( 13 )  field\_char} \\
836                       ~~~~~~~~~\texttt{DO  WHILE ( TRIM( field\_char )  '*** end user ***' )}\\
837                       \par\smallskip
838                       ~~~~~~~~~~~~~\texttt{nxlf = nxlfa(i,k)}
839                       \texttt{...} \\
840                       ~~~~~~~~~~~~~\texttt{SELECT CASE ( TRIM( field\_char ) )}\\
841                       \par\smallskip
842                       ~~~~~~~~~~~~~~~~~\texttt{CASE ( '\textcolor{blue}{foo}' )} \\
843                       ~~~~~~~~~~~~~~~~~~~~~\texttt{IF ( .NOT. ALLOCATED( \textcolor{blue}{foo} ) ) THEN}\\
844                       ~~~~~~~~~~~~~~~~~~~~~~~~~\texttt{ALLOCATE( \textcolor{blue}{foo}(nzb:nzt+1,nysg:nyng,nxlg:nxrg) )}\\
845                       ~~~~~~~~~~~~~~~~~~~~~\texttt{ENDIF}\\
846                       ~~~~~~~~~~~~~~~~~~~~~\texttt{IF ( k == 1 )  READ ( 13 )  tmp\_3d}\\
847                       ~~~~~~~~~~~~~~~~~~~~~\texttt{\textcolor{blue}{foo}(:,nysc-nbgp:nync+nbgp,nxlc-nbgp:nxrc+nbgp) = \&} \\
848                       \hspace{4.5cm}\texttt{tmp\_3d(:,nysf-nbgp:nynf+nbgp,nxlf-nbgp:nxrf+nbgp)}\\
849                       \texttt{...}\\
850                       ~~~~~~~~~~~~~\texttt{END SELECT}\\
851                       \par\smallskip
852                       ~~~~~~~~~\texttt{ENDDO}
853                       \par\smallskip
854                       ~~~~~~~~~\texttt{READ ( 13 )  field\_char}\\
855                       \par\smallskip
856                       ~~~~~~~~~\texttt{ENDDO}\\
857                       ~~~~~\texttt{ENDIF}\\
858                       \par\smallskip
859                       ~\texttt{END SUBROUTINE user\_read\_restart\_data}};
860      \end{tikzpicture}
861   \end{center}
862\end{frame}
863
864% Folie 18
865\begin{frame}
866   \frametitle{Using the User-Interface with \texttt{mrun}}
867   \scriptsize
868   \begin{columns}[T]
869      \begin{column}{1.1\textwidth}
870         \vspace{-1mm}
871         \textbf{Users can add their own (modified) user-interface to a PALM-run by carrying out the following steps:}
872         \begin{enumerate}
873            \item<2-> Copy the default (empty) user-interface files that you need (e.g. user\underline{ }module.f90, user\underline{ }parin.f90, user\underline{ }actions.f90) to a directory of your choice, e.g.:\\
874            \tiny
875            \par\smallskip
876                 \quad \texttt{cd \~{ }/palm/current\underline{ }version}\\
877                 \quad \texttt{mkdir -p USER\underline{ }CODE/example\underline{ }cbl}\\
878                 \quad \texttt{cp trunk/SOURCE/user\underline{ }module.f90  USER\underline{ }CODE/example\underline{ }cbl/user\underline{ }module.f90}\\
879                 \quad \texttt{cp trunk/SOURCE/user\underline{ }parin.f90\hspace{1em}USER\underline{ }CODE/example\underline{ }cbl/user\underline{ }parin.f90}\\
880            \quad \texttt{...}
881            \scriptsize
882            \vspace{-1mm}
883            \item<3-> Set an additional path in the configuration file \texttt{.mrun.config} to allow \texttt{mrun} to find and include this file:\\
884            \tiny
885                 \quad \texttt{\%add\underline{ }source\underline{ }path \hspace{1em} \$base\underline{ }directory/USER\underline{ }CODE/\$fname}
886                 \scriptsize
887                 \item<4-> Modify the interface routines according to your needs.
888                 \item<5-> Start a PALM run by executing\\
889                 \tiny
890                 \quad  \texttt{mrun -d example\underline{ }cbl ...}\\
891                 \scriptsize
892                 The files user\underline{ }*.f90 will be automatically compiled within the job / interactive run and will replace the respective PALM default user-interface files.
893              \end{enumerate}
894              \vspace{-2mm}
895         \begin{itemize}
896                 \item<6-> \textbf{The modified user-interface file cannot be pre-compiled by using} \texttt{mbuild}!
897                 \item<7-> The above method allows to use different user-interfaces for different runs. Just store the respective interface-files in subdirectories \texttt{USER\underline{ }CODE/abcd}, \texttt{USER\underline{ }CODE/cdef}, etc. and start \texttt{mrun} with option \grqq \texttt{-d abcd}\grqq, \grqq \texttt{-d cdef}\grqq, etc.
898         \end{itemize}
899
900      \end{column}
901   \end{columns} 
902   
903\end{frame}
904
905\end{document}
Note: See TracBrowser for help on using the repository browser.