1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
---|
2 | <html><head> |
---|
3 | <meta http-equiv="CONTENT-TYPE" content="text/html; charset=windows-1252"><title>PALM |
---|
4 | chapter 3.5.1</title> <meta name="GENERATOR" content="StarOffice 7 (Win32)"> <meta name="AUTHOR" content="Siegfried Raasch"> <meta name="CREATED" content="20040802;11451548"> <meta name="CHANGED" content="20041112;14401801"> <meta name="KEYWORDS" content="parallel LES model"> <style> |
---|
5 | <!-- |
---|
6 | @page { size: 21cm 29.7cm } |
---|
7 | --> |
---|
8 | </style></head> |
---|
9 | <body style="direction: ltr;" lang="en-US"><h3 style="line-height: 100%;">3.5.1 Interfaces for |
---|
10 | user-defined code<br> |
---|
11 | </h3><p style="margin-bottom: 0cm; line-height: 100%;">The |
---|
12 | following table |
---|
13 | describes the available interfaces for user-defined code in the model, |
---|
14 | the |
---|
15 | names and possible arguments of the subroutines involved as well as |
---|
16 | actions which can be accomplished in these subroutines. <br> |
---|
17 | </p> |
---|
18 | <table style="width: 100%;" border="1" cellpadding="2" cellspacing="4"> <col width="211"> <col width="117"> <col width="862"> <tbody> <tr><td width="211"> <p><font size="4"><b>Call |
---|
19 | location</b></font></p> </td> <td width="117"> <p><font size="4"><b>Subroutine |
---|
20 | name and |
---|
21 | argument</b></font></p> </td> <td style="width: 862px;"> <p><font size="4"><b>Possible |
---|
22 | actions</b></font></p> </td> </tr> <tr><td>---</td><td><span style="font-family: monospace;"><a name="user"></a>MODULE |
---|
23 | user</span></td><td>All |
---|
24 | user-defined variables which are used outside the respective local |
---|
25 | scopes of the user-defined subroutines have to be declared here.</td></tr><tr valign="top"> <td width="211"> <p>End |
---|
26 | of <tt><font style="font-size: 10pt;" size="2">parin.f90</font></tt></p> |
---|
27 | </td> <td width="117"> <p><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"><a name="user_parin"></a>user_parin</font></font></tt></p> |
---|
28 | </td> <td width="862"> <p>Declaration of |
---|
29 | user-defined parameters in the NAMELIST |
---|
30 | group <tt><font style="font-size: 10pt;" size="2">&userpar</font></tt>. |
---|
31 | These |
---|
32 | parameters can be read from the local file <a href="chapter_3.4.html#PARIN">PARIN</a> |
---|
33 | and be used for steering the user-defined code (see <a href="chapter_4.0.html">chapter |
---|
34 | 4.0</a>). The user-defined parameter <a href="chapter_4.3.html#region">region</a> |
---|
35 | is already pre-defined in <tt><font style="font-size: 10pt;" size="2">&userpar</font></tt> |
---|
36 | and must not be changed. Additional NAMELIST groups may be declared if |
---|
37 | desired. <br> |
---|
38 | The CPU time needed for executing <tt><font style="font-size: 10pt;" size="2">user_parin</font></tt> |
---|
39 | is included in the |
---|
40 | local file <a href="chapter_3.4.html#CPU_MEASURES">CPU_MEASURES</a> |
---|
41 | within the category “initialisation”.</p> </td> |
---|
42 | </tr> <tr valign="top"> <td width="211"><p>End |
---|
43 | of <tt><font style="font-size: 10pt;" size="2">header.f90</font></tt></p> |
---|
44 | </td> |
---|
45 | <td width="117"> <p><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"><a name="user_header"></a>user_header( |
---|
46 | io )</font></font></tt></p> </td> <td width="862"> <p>Output of the values of the |
---|
47 | user-defined parameters to |
---|
48 | the |
---|
49 | local files <a href="chapter_3.4.html#HEADER">HEADER</a> |
---|
50 | and <a href="chapter_3.4.html#RUN_CONTROL">RUN_CONTROL</a>. |
---|
51 | This output should be made anyway in order to subsequently check the |
---|
52 | parameter values used for the respective run. The number of the output |
---|
53 | unit is passed as an argument and must be used in each WRITE statement |
---|
54 | (e.g.: “<tt><font face="Cumberland, monospace"><font style="font-size: 10pt;" size="2">WRITE </font><font style="font-size: 10pt;" size="2">( io,…</font></font></tt><font style="font-size: 10pt;" size="2">”))</font>. |
---|
55 | By default, this |
---|
56 | subroutine only creates output if a user-defined NAMELIST is found in |
---|
57 | file <a href="chapter_3.4.html#PARIN">PARIN</a> |
---|
58 | (in this case <tt><font face="Thorndale, serif">the</font></tt> |
---|
59 | variable <tt><font style="font-size: 10pt;" size="2">user_defined_namelist_found</font></tt> |
---|
60 | is set <i>.TRUE.</i> in <tt><font style="font-size: 10pt;" size="2">user_parin</font></tt>). |
---|
61 | The names of any |
---|
62 | user-defined |
---|
63 | subdomains are displayed by default (see <a href="chapter_4.1.html#statistic_regions">statistic_regions</a>).</p> |
---|
64 | </td> </tr> <tr valign="top"> <td width="211"> <p>End of <tt><font style="font-size: 10pt;" size="2">init_3d_model.f90</font></tt></p> |
---|
65 | </td> <td width="117"> <p><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"><a name="user_init"></a>user_init</font></font></tt></p> |
---|
66 | </td> <td width="862"> <p>Here, user-defined |
---|
67 | initialization actions which should |
---|
68 | be |
---|
69 | accomplished before the start of the 3D-model can be implemented (e.g. |
---|
70 | inhomogenous change of the surface temperature, the roughness length, |
---|
71 | or similar). At this point, all default parameter initializations of |
---|
72 | the model (<a href="chapter_4.1.html">chapter |
---|
73 | 4.1</a>) have already been carried out at all. </p> |
---|
74 | <p>One of the most important actions here is the definition |
---|
75 | of |
---|
76 | user-defined subdomains for statistic analysis and output (see <a href="chapter_4.1.html#statistic_regions">statistic_regions</a> |
---|
77 | and <a href="chapter_3.5.3.html">chapter |
---|
78 | 3.5.3</a>) and of additional time series quantities (see comment |
---|
79 | line example in the file). <br> |
---|
80 | CPU time for <tt><font style="font-size: 10pt;" size="2">user_init</font></tt> |
---|
81 | is considered in the local file <a href="chapter_3.4.html#CPU_MEASURES">CPU_MEASURES</a> |
---|
82 | within the category “initialisation”.</p><p>See |
---|
83 | also <tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"><a href="#user_init_3d_model">user_init_3d_model</a>.</font></font></tt></p> |
---|
84 | </td> </tr> <tr> <td style="vertical-align: top;"><tt><font style="font-size: 10pt;" size="2">DEFAULT</font></tt> |
---|
85 | case of <tt><font style="font-size: 10pt;" size="2">SELECT |
---|
86 | CASE( TRIM(topography) ) </font></tt>command in the |
---|
87 | middle of <tt><font style="font-size: 10pt;" size="2">init_grid.f90</font></tt></td> <td style="vertical-align: top;"><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"><a name="user_init_grid"></a>user_init_grid</font></font></tt></td> |
---|
88 | <td> <p>Execution of user-defined grid initializing |
---|
89 | actions.</p> <p>Here, the user can define the |
---|
90 | two-dimensional index |
---|
91 | array <tt><font style="font-size: 10pt;" size="2">nzb_local</font></tt> that is used to |
---|
92 | set up a non-flat topography. This requires definition of at least one |
---|
93 | new <a href="chapter_4.1.html#topography">topography</a> mode |
---|
94 | in the <tt><font style="font-size: 10pt;" size="2">SELECT CASE( TRIM(topography) ) </font></tt>command |
---|
95 | in <tt><font style="font-size: 10pt;" size="2">user_init_grid</font></tt>. |
---|
96 | Note that the <a href="chapter_4.1.html#topography">topography</a> modes |
---|
97 | <span style="font-style: italic;">'flat'</span> |
---|
98 | and <span style="font-style: italic;">'single_building'</span> |
---|
99 | are not allowed here since these are the standard cases used in the |
---|
100 | calling routine <tt><font style="font-size: 10pt;" size="2">init_grid</font></tt>. </p> <p>CPU |
---|
101 | time for <tt><font style="font-size: 10pt;" size="2">user_init_grid</font></tt> |
---|
102 | is considered in the local file <a href="chapter_3.4.html#CPU_MEASURES">CPU_MEASURES</a> |
---|
103 | within the category “initialisation”.</p> </td> |
---|
104 | </tr> <tr><td style="vertical-align: top;">In |
---|
105 | the middle of <tt><font style="font-size: 10pt;" size="2">init_3d_model.f90</font></tt></td><td style="vertical-align: top;"><span style="font-family: monospace;"></span><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"><a name="user_init_3d_model"></a>user_init_3d_<br>model</font></font></tt></td><td style="vertical-align: top;">Initialization of the 3d-model.<br><br>Allows |
---|
106 | the complete initialization of the 3d model. The user is responsible to |
---|
107 | set at least all those quantities which are normally set within <tt><font style="font-size: 10pt;" size="2">init_3d_model</font></tt>.</td></tr><tr valign="top"> <td width="211"> <p>In |
---|
108 | the middle of <tt><font style="font-size: 10pt;" size="2">init_particles.f90</font></tt></p> |
---|
109 | </td> <td width="117"> <p><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"><a name="user_init_particles"></a>user_init_</font></font></tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"> <br> </font></font><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace">particles</font></font></tt></p> |
---|
110 | </td> <td width="862"> <p>With this routine |
---|
111 | e.g. size and color of particles, |
---|
112 | which have |
---|
113 | been released initially from a source, can be specified. Like the |
---|
114 | calling routine <tt><font style="font-size: 10pt;" size="2">init_particles</font><font style="font-size: 11pt;" size="2">,</font></tt> |
---|
115 | this routine is only |
---|
116 | called if particle advection is switched on (see package parameter <a href="chapter_4.2.html#dt_prel">dt_prel</a>).</p> |
---|
117 | </td> </tr> <tr valign="top"> <td width="211"> <p>End of <tt><font style="font-size: 10pt;" size="2">advec_particles.f90</font></tt></p> |
---|
118 | </td> <td width="117"> <p><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"><a name="user_particle_attributes"></a>user_particle_</font></font></tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"> <br> </font></font><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace">attributes</font></font></tt></p> |
---|
119 | </td> <td width="862"> <p>Here the particles |
---|
120 | can be assigned new attributes |
---|
121 | (diameter, |
---|
122 | color etc.) after each time step. Like the calling routine <tt><font style="font-size: 10pt;" size="2">advec_particles</font><font style="font-size: 11pt;" size="2">,</font> </tt>this |
---|
123 | routine is only |
---|
124 | called if particle advection is switched on (see package parameter <a href="chapter_4.2.html#dt_prel">dt_prel</a>).</p> |
---|
125 | </td> </tr> <tr valign="top"> <td width="211"> <p>Before the plot of particles and |
---|
126 | cross-sections in <br> <tt><font style="font-size: 10pt;" size="2">dvrp_plot.f90</font></tt></p> |
---|
127 | </td> <td width="117"> <p><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"><a name="user_dvrp_coltab"></a>user_dvrp_coltab |
---|
128 | (</font></font></tt><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"> mode )</font></font></tt></p> |
---|
129 | </td> <td width="862"> <p>With this routine, |
---|
130 | color tables can be adjusted which |
---|
131 | should |
---|
132 | be used for output with the dvrp software. Individuell color tables for |
---|
133 | particles and cross-sections are possible. For this purpose the two |
---|
134 | arrays <tt><font style="font-size: 10pt;" size="2">interval_values_dvrp</font></tt> |
---|
135 | and <tt><font style="font-size: 10pt;" size="2">interval_h_dvrp</font></tt> |
---|
136 | (declared in the module <tt><font style="font-size: 10pt;" size="2">dvrp_variables</font></tt>) |
---|
137 | have to be preset with appropriate values. The number of color table |
---|
138 | entries must be assigned to the variable of <tt><font style="font-size: 10pt;" size="2">dvrp_colourtable_entries</font></tt>. |
---|
139 | The value of the subroutine argument <span style="font-family: monospace;">mode</span> defines, |
---|
140 | whether the color |
---|
141 | table is valid for particles or for cross-sections<span style="font-family: monospace;"></span> (i.e. <tt><font size="2">mode</font></tt> |
---|
142 | can have the values “<i>particles”</i> |
---|
143 | or “<i>slicer”</i>). <br> |
---|
144 | This routine only becomes active if dvrp-graphics is switched on (see |
---|
145 | package parameter <a href="chapter_4.2.html#dt_dvrp">dt_dvrp</a>).</p> |
---|
146 | </td> </tr> <tr valign="top"> <td width="211"> <p>Beginning and end of the time |
---|
147 | integration loop |
---|
148 | of <br> <tt><font style="font-size: 10pt;" size="2">time_integration.f90</font></tt> |
---|
149 | as well as after each prognostic equation in <br> <tt><font style="font-size: 10pt;" size="2">prognostic_equations.f90</font></tt></p> |
---|
150 | </td> <td width="117"> <p><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"><a name="user_actions"></a>user_actions( |
---|
151 | location )</font></font></tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"> </font></font> </p> |
---|
152 | <p>or<br> <font face="Cumberland, monospace"><font style="font-size: 10pt;" size="2"> </font></font> |
---|
153 | </p> <p><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace">user_actions( |
---|
154 | i, j,</font></font></tt><span style="font-family: Cumberland,monospace;"> </span><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace">location )</font></font></tt></p> |
---|
155 | </td> <td width="862"> <p>In this routine |
---|
156 | user actions can be implemented which |
---|
157 | are to |
---|
158 | be executed either at each time step or at certain times (defined by |
---|
159 | the user). Since in each case the routine is called at the beginning |
---|
160 | and at the end of a time step as well as after each prognostic equation |
---|
161 | it must be defined at which place (and/or at which places) the |
---|
162 | respective actions are supposed to be executed. For this purpose an |
---|
163 | appropriate CASE structure is already inserted in this routine. The |
---|
164 | location of the calling routine is passed to this routine via the |
---|
165 | argument <tt><font style="font-size: 10pt;" size="2">location</font></tt>. |
---|
166 | For example, if called at the beginning of a time step, <tt><font style="font-size: 10pt;" size="2">location</font></tt> |
---|
167 | = <i>'before_timestep' </i>and if |
---|
168 | called at the end, <tt><font style="font-size: 10pt;" size="2">location</font></tt><font style="font-size: 10pt;" size="2"> </font>= <i>'after_timestep'</i><span style="font-weight: bold;">.</span></p><p>Calculation |
---|
169 | of user-defined output quantities should be carried out at <span style="font-family: monospace;">location</span> = <span style="font-style: italic;">'after_integration'</span>.<span style="font-weight: bold;"></span></p><p><span style="font-weight: bold;">Important:</span> |
---|
170 | if the |
---|
171 | cache-optimized version of <span style="font-family: monospace;">prognostic_equation.f90</span> |
---|
172 | is used (this is the default for IBM-Regatta-Systems), the loop |
---|
173 | variables <tt>i</tt> and <tt>j</tt> must be |
---|
174 | passed as arguments for |
---|
175 | all calls within <span style="font-family: monospace;">prognostic_equations</span>. |
---|
176 | </p> <p>CPU time for <tt><font style="font-size: 10pt;" size="2">user_actions</font></tt> |
---|
177 | appears within the category “user_actions” in the |
---|
178 | local file <a href="chapter_3.4.html#CPU_MEASURES">CPU_MEASURES</a>. |
---|
179 | If the cache-optimized version of <span style="font-family: monospace;">prognostic_equation.f90</span> |
---|
180 | is used, this time measurement only considers the CPU time which was |
---|
181 | needed outside of the prognostic equations. Time needed for calls |
---|
182 | within prognostic_equations is considered within the category "all |
---|
183 | prog.equations".<br> </p> <p><b>Important:</b> |
---|
184 | this subroutine is written |
---|
185 | as a FORTRAN |
---|
186 | module, which uses so-called function overloading. It can be called in |
---|
187 | two ways: with one argument (<tt><font style="font-size: 10pt;" size="2">location</font></tt>) |
---|
188 | and with three arguments <font style="font-size: 10pt;" size="2">(</font><tt><font style="font-size: 10pt;" size="2">i, j, location</font></tt><font style="font-size: 10pt;" size="2">)</font>. The |
---|
189 | three argument version |
---|
190 | is used in the cache-optimized version of <span style="font-family: monospace;">prognostic_equations</span>. |
---|
191 | Depending |
---|
192 | on the number of given arguments the subroutine internally calls <tt><font style="font-size: 10pt;" size="2">user_actions</font></tt> |
---|
193 | or <tt><font style="font-size: 10pt;" size="2">user_actions_ij</font></tt>. |
---|
194 | So the |
---|
195 | user must insert the actions (code extensions) desired for the |
---|
196 | respective prognostic equation either in the CASE structure of <tt><font style="font-size: 10pt;" size="2">user_actions</font><font style="font-size: 11pt;" size="2">,</font> </tt>or/and |
---|
197 | in the CASE |
---|
198 | structure of <tt><font style="font-size: 10pt;" size="2">user_actions_ij</font></tt>!</p> </td> |
---|
199 | </tr> <tr valign="top"> <td width="211"><p><tt><font style="font-size: 10pt;" size="2">flow_statistics.f90</font></tt> |
---|
200 | before the summation of array <span style="font-family: monospace;">hom</span> |
---|
201 | (horizontal averages)<br> </p> </td> <td width="117"> <p><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"><a name="user_statistics"></a>user_statistics<br>( |
---|
202 | sr )</font></font></tt></p> </td> <td width="862"> <p>Horizontal |
---|
203 | averages of vertical profiles of user-defined |
---|
204 | quantities can be computed here. Also, additional time series |
---|
205 | quantities can be calculated. They have to be defined before in routine |
---|
206 | <a href="#user_init"><span style="font-family: Courier New,Courier,monospace;">user_init</span></a>. |
---|
207 | The routine is called once for each defined statistic region (see <a href="chapter_4.1.html#statistic_region">statistic_region</a>).</p><p></p><p>The |
---|
208 | routine contains some simple examples (as comment lines) in order to |
---|
209 | demonstrate how to use it.</p><p><br>Profiles have to |
---|
210 | be written to |
---|
211 | the array <tt><font style="font-size: 10pt;" size="2">sums</font></tt>. |
---|
212 | Please use profile numbers starting from 70 upward (thus e.g. <tt><font style="font-size: 10pt;" size="2">sums (…, |
---|
213 | 60) =</font></tt><font style="font-size: 10pt;" size="2">…)</font>. These additional |
---|
214 | profiles |
---|
215 | are temporally averaged in <tt><font style="font-size: 10pt;" size="2">flow_statistics</font></tt>.</p> </td> |
---|
216 | </tr> <tr><td style="vertical-align: top;">End |
---|
217 | of <span style="font-family: monospace;">check_parameters.f90</span> |
---|
218 | where output quantities are checked</td><td style="vertical-align: top;"><span style="font-family: monospace;"><a name="user_check_data_output"></a>user_check_data_<br>output( |
---|
219 | variable, unit )</span></td><td style="vertical-align: top;">Here the <span style="font-family: monospace;">unit</span>(s) of |
---|
220 | user-defined output quantities (see <a href="chapter_4.3.html#data_output_user">data_output_user</a>) |
---|
221 | have to be set. Input parameter <span style="font-family: monospace;">variable</span> |
---|
222 | contains the string identifier of the respective variable. For those |
---|
223 | variables not recognized by the user, the parameter <span style="font-family: monospace;">unit</span> is set to |
---|
224 | "illegal", which tells the calling routine that the output variable is |
---|
225 | not defined and leads to a program abort.<br><br>See <a href="chapter_3.5.4.html">chapter 3.5.4</a> about |
---|
226 | creating user-defined output quantities.</td></tr><tr><td style="vertical-align: top;"><span style="font-family: monospace;">netcdf.f90</span> (4 |
---|
227 | times) where the vertical grid coordinates for cross sections and |
---|
228 | volume data are defined</td><td style="vertical-align: top;"><span style="font-family: monospace;"><a name="user_define_netcdf_grid"></a>user_define_<br>netcdf_grid( |
---|
229 | variable, found, grid_x, grid_y, grid_z )</span></td><td style="vertical-align: top;">Set the grid on which |
---|
230 | user-defined output quantities (see <a href="chapter_4.3.html#data_output_user">data_output_user</a>) |
---|
231 | are defined. Input parameter <span style="font-family: monospace;">variable</span> |
---|
232 | contains the string identifier of the respective variable. Allowed |
---|
233 | values are <span style="font-style: italic;">'x'</span> |
---|
234 | and <span style="font-style: italic;">'xu'</span> |
---|
235 | for <span style="font-family: monospace;">grid_x</span>, |
---|
236 | <span style="font-style: italic;">'y'</span> and <span style="font-style: italic;">'yv'</span> for <span style="font-family: monospace;">grid_y</span>, and<span style="font-family: monospace;"></span> <span style="font-style: italic;">'zu'</span> and <span style="font-style: italic;">'zw'</span> for <span style="font-family: monospace;">grid_z</span>. The |
---|
237 | output parameter <span style="font-family: monospace;">found</span> |
---|
238 | has to be set <span style="font-style: italic;">.TRUE.</span> |
---|
239 | by the user, otherwise an error message will appear in the job protocol |
---|
240 | for the respective output quantity.<br><br><span style="font-weight: bold;">Example:</span><br>If |
---|
241 | an output quantity is defined at the center of the grid boxes, the |
---|
242 | following settings have to be used:<br><br><div style="margin-left: 40px;"><span style="font-family: monospace;">grid_x = <span style="font-style: italic;">'x'</span></span><br style="font-family: monospace;"><span style="font-family: monospace;">grid_y = <span style="font-style: italic;">'y'</span></span><br style="font-family: monospace;"><span style="font-family: monospace;">grid_z = <span style="font-style: italic;">'zu'</span></span><br style="font-family: monospace;"><span style="font-family: monospace;">found = <span style="font-style: italic;">.TRUE.</span></span><br></div><br>For |
---|
243 | defining an output quantity at the grid points where the |
---|
244 | u-velocity-component is defined, please use<br><br><div style="margin-left: 40px;"><span style="font-family: monospace;">grid_x = <span style="font-style: italic;">'xu'</span></span><br style="font-family: monospace;"><span style="font-family: monospace;">grid_y = <span style="font-style: italic;">'y'</span></span><br style="font-family: monospace;"><span style="font-family: monospace;">grid_z = <span style="font-style: italic;">'zu'</span></span><br style="font-family: monospace;"><span style="font-family: monospace;">found = <span style="font-style: italic;">.TRUE.</span></span><br></div><br>See |
---|
245 | <a href="chapter_3.5.4.html">chapter 3.5.4</a> about |
---|
246 | creating user-defined output quantities.</td></tr><tr><td style="vertical-align: top;">Middle of <span style="font-family: monospace;">data_output_2d.f90</span></td><td style="vertical-align: top;"><span style="font-family: monospace;"><a name="user_data_output_2d"></a>user_data_<br>output_2d( |
---|
247 | av, variable, found, grid, local_pf )</span></td><td style="vertical-align: top;">Resorts user-defined quantities |
---|
248 | (to be output as cross-section data; see <a href="chapter_4.3.html#data_output_user">data_output_user</a>) |
---|
249 | with indices (k,j,i) to a temporary array <span style="font-family: monospace;">local_pf</span> with |
---|
250 | indices (i,j,k) and sets the <span style="font-family: monospace;">grid</span> |
---|
251 | on which they are defined. Depending on the value of input parameter <span style="font-family: monospace;">av</span> resorting is |
---|
252 | done for instantaneous (<span style="font-family: monospace;">av</span>=<span style="font-style: italic;">0</span>) or time averaged |
---|
253 | data (<span style="font-family: monospace;">av</span>=<span style="font-style: italic;">1</span>). Input parameter |
---|
254 | <span style="font-family: monospace;">variable</span> |
---|
255 | contains the string identifier of the respective variable. Allowed |
---|
256 | values for <span style="font-family: monospace;">grid</span> |
---|
257 | are <span style="font-style: italic;">'zu'</span> |
---|
258 | and <span style="font-style: italic;">'zw'</span>. |
---|
259 | The output parameter <span style="font-family: monospace;">found</span> |
---|
260 | has to be set <span style="font-style: italic;">.TRUE.</span> |
---|
261 | by the user, otherwise an error message will appear in the job protocol |
---|
262 | for the respective output quantity.<br><br>See <a href="chapter_3.5.4.html">chapter 3.5.4</a> about |
---|
263 | creating user-defined output quantities.</td></tr><tr><td style="vertical-align: top;"><span style="font-family: monospace;">data_output_3d.f90</span> |
---|
264 | at the end of the CASE structure</td><td style="vertical-align: top;"><span style="font-family: monospace;"><a name="user_data_output_3d"></a>user_data_<br>output_3d( |
---|
265 | av, variable, found, local_pf, nz_do )</span></td><td style="vertical-align: top;">Resorts user-defined quantities |
---|
266 | (to be output as volume data; see <a href="chapter_4.3.html#data_output_user">data_output_user</a>) |
---|
267 | with indices (k,j,i) to a temporary array <span style="font-family: monospace;">local_pf</span> with |
---|
268 | indices (i,j,k) and sets the <span style="font-family: monospace;">grid</span> |
---|
269 | on which they are defined. Depending on the value of input parameter <span style="font-family: monospace;">av</span> resorting is |
---|
270 | done for instantaneous (<span style="font-family: monospace;">av</span>=<span style="font-style: italic;">0</span>) or time averaged |
---|
271 | data (<span style="font-family: monospace;">av</span>=<span style="font-style: italic;">1</span>). Input parameter |
---|
272 | <span style="font-family: monospace;">variable</span> |
---|
273 | contains the string identifier of the respective variable<span style="font-family: monospace;"></span><span style="font-style: italic;"></span><span style="font-style: italic;"></span>. The input |
---|
274 | parameter <span style="font-family: monospace;">nz_do</span> |
---|
275 | defines the upper limit of vertical grid index k of the output array |
---|
276 | (see <a href="chapter_4.2.html#nz_do3d">nz_do3d</a>). |
---|
277 | The output parameter <span style="font-family: monospace;">found</span> |
---|
278 | has to be set <span style="font-style: italic;">.TRUE.</span> |
---|
279 | by the user, otherwise an error message will appear in the job protocol |
---|
280 | for the respective output quantity.<br><br>See <a href="chapter_3.5.4.html">chapter 3.5.4</a> about |
---|
281 | creating user-defined output quantities.</td></tr><tr><td style="vertical-align: top;">End of <span style="font-family: monospace;">average_3d_data.f90</span>, |
---|
282 | middle and end of <span style="font-family: monospace;">sum_up_3d_data.f90</span></td><td style="vertical-align: top;"><span style="font-family: monospace;"><a name="user_3d_data_averaging"></a>user_3d_data_<br>averaging( |
---|
283 | mode, variable )</span></td><td style="vertical-align: top;">Sum up and time-average of |
---|
284 | user-defined output quantities (see <a href="chapter_4.3.html#data_output_user">data_output_user</a>) |
---|
285 | as well as allocation of the arrays necessary for storing the |
---|
286 | respective averages. Input parameter <span style="font-family: monospace;">variable</span> |
---|
287 | contains the string identifier of the respective variable. Depending on |
---|
288 | the requested action, input parameter <span style="font-family: monospace;">mode</span> has the |
---|
289 | value <span style="font-style: italic;">'allocate'</span>, |
---|
290 | <span style="font-style: italic;">'sum'</span>, or <span style="font-style: italic;">'average'</span>.<br><br>See |
---|
291 | <a href="chapter_3.5.4.html">chapter 3.5.4</a> about |
---|
292 | creating user-defined output quantities. </td></tr><tr valign="top"> <td width="211"> <p>End |
---|
293 | of <tt><font style="font-size: 10pt;" size="2">palm.f90</font></tt></p> |
---|
294 | </td> <td width="117"> <p><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"><a name="user_last_action"></a>user_last_</font></font></tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"> <br> </font></font><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace">action</font></font></tt></p> |
---|
295 | </td> <td width="862"> <p>User-defined |
---|
296 | actions which are to be executed at the end |
---|
297 | of a |
---|
298 | model run. When <tt><font style="font-size: 10pt;" size="2">user_last_actions</font></tt> |
---|
299 | is called all model actions are already completed, but the files opened |
---|
300 | by the model are not closed yet and possibly terminating actions for |
---|
301 | these files (see subroutine of <tt><font style="font-size: 10pt;" size="2">close_files</font></tt>) |
---|
302 | are also not carried |
---|
303 | out yet. <br> |
---|
304 | CPU time for <tt><font style="font-size: 10pt;" size="2">user_last_actions</font></tt> |
---|
305 | appears in the local file <a href="chapter_3.4.html#CPU_MEASURES">CPU_MEASURES</a> |
---|
306 | within the category “last actions” (the time |
---|
307 | necessary for <tt><font style="font-size: 10pt;" size="2">close_files</font></tt> is included).</p> |
---|
308 | </td> </tr> </tbody></table><hr> |
---|
309 | <p style="line-height: 100%;"><br><font color="#000080"><font color="#000080"><a href="chapter_3.5.html"><font color="#000080"><img src="left.gif" name="Grafik1" align="bottom" border="2" height="32" width="32"></font></a><a href="index.html"><font color="#000080"><img src="up.gif" name="Grafik2" align="bottom" border="2" height="32" width="32"></font></a><a href="chapter_3.5.2.html"><font color="#000080"><img src="right.gif" name="Grafik3" align="bottom" border="2" height="32" width="32"></font></a></font></font></p><p style="line-height: 100%;"><i>Last |
---|
310 | change: </i>$Id: chapter_3.5.1.html 62 2007-03-13 02:52:40Z heinze $</p> |
---|
311 | </body></html> |
---|