source: palm/trunk/SOURCE/parin.f90 @ 410

Last change on this file since 410 was 410, checked in by letzel, 12 years ago
  • reintegrate branch letzel/masked_output into trunk; new funtionality: masked data output (not yet documented)
  • Property svn:keywords set to Id
File size: 15.6 KB
Line 
1 SUBROUTINE parin
2
3!------------------------------------------------------------------------------!
4! Current revisions:
5! -----------------
6! +wall_humidityflux, wall_scalarflux
7!
8! Branch revisions:
9! -----------------
10! Masked data output: + dt_domask, mask_01~20_x|y|z, mask_01~20_x|y|z_loop,
11! mask_scale_x|y|z, masks, netcdf_format_mask[_av], skip_time_domask
12!
13! Former revisions:
14! -----------------
15! $Id: parin.f90 410 2009-12-04 17:05:40Z letzel $
16!
17! 291 2009-04-16 12:07:26Z raasch
18! +local_dvrserver_running in envpar
19! Output of messages replaced by message handling routine.
20! +canyon_height, canyon_width_x, canyon_width_y, canyon_wall_left,
21! canyon_wall_south, conserve_volume_flow_mode, coupling_start_time,
22! dp_external, dp_level_b, dp_smooth, dpdxy, u_bulk, v_bulk in inipar
23! topography_grid_convention moved from userpar
24!
25! 197 2008-09-16 15:29:03Z raasch
26! +cthf,leaf_surface_concentration, scalar_exchange_coefficient
27! +inflow_damping_height, inflow_damping_width, recycling_width,
28! turbulent_inflow in inipar, -skip_time_dosp in d3par,
29! allocation of hom_sum moved from init_3d_model to here,
30! npex, npey moved from inipar to d3par, setting of myid_char_14 removed,
31! lad is allways allocated
32!
33! 138 2007-11-28 10:03:58Z letzel
34! +canopy_mode, drag_coefficient, lad_surface, lad_vertical_gradient,
35! lad_vertical_gradient_level, pch_index, plant_canopy,
36! +allocation of leaf area density field
37!
38! 108 2007-08-24 15:10:38Z letzel
39! +e_init, top_momentumflux_u|v in inipar, +dt_coupling in d3par
40!
41! 95 2007-06-02 16:48:38Z raasch
42! +bc_sa_t, bottom_salinityflux, ocean, sa_surface, sa_vertical_gradient,
43! sa_vertical_gradient_level, top_salinityflux in inipar,
44! sa_init is allocated
45!
46! 87 2007-05-22 15:46:47Z raasch
47! Size of hom increased by the maximum number of user-defined profiles,
48! var_hom renamed pr_palm
49!
50! 82 2007-04-16 15:40:52Z raasch
51! +return_addres, return_username in envpar
52!
53! 75 2007-03-22 09:54:05Z raasch
54! +dt_max, netcdf_64bit_3d, precipitation_amount_interval in d3par,
55! +loop_optimization, pt_reference in inipar, -data_output_ts,
56! moisture renamed humidity
57!
58! 20 2007-02-26 00:12:32Z raasch
59! +top_heatflux, use_top_fluxes in inipar
60!
61! -netcdf_64bit_3d
62!
63! 3 2007-02-13 11:30:58Z raasch
64! +netcdf_64bit_3d in d3par,
65! RCS Log replace by Id keyword, revision history cleaned up
66!
67! Revision 1.57  2007/02/11 13:11:22  raasch
68! Values of environment variables are now read from file ENVPAR instead of
69! reading them with a system call, + NAMELIST envpar
70!
71! Revision 1.1  1997/07/24 11:22:50  raasch
72! Initial revision
73!
74!
75! Description:
76! ------------
77! This subroutine reads variables controling the run from the NAMELIST files
78!------------------------------------------------------------------------------!
79
80    USE arrays_3d
81    USE averaging
82    USE control_parameters
83    USE dvrp_variables
84    USE grid_variables
85    USE indices
86    USE model_1d
87    USE pegrid
88    USE profil_parameter
89    USE statistics
90
91    IMPLICIT NONE
92
93    INTEGER ::  idum
94
95
96    NAMELIST /inipar/  adjust_mixing_length, alpha_surface, bc_e_b, bc_lr, &
97                       bc_ns, bc_p_b, bc_p_t, bc_pt_b, bc_pt_t, bc_q_b, &
98             bc_q_t,bc_s_b, bc_s_t, bc_sa_t, bc_uv_b, bc_uv_t, &
99             bottom_salinityflux, building_height, building_length_x, &
100             building_length_y, building_wall_left, building_wall_south, &
101             canopy_mode, canyon_height, canyon_width_x, canyon_width_y, &
102             canyon_wall_left, canyon_wall_south, cloud_droplets, &
103             cloud_physics, conserve_volume_flow, conserve_volume_flow_mode, &
104             coupling_start_time, cthf, cut_spline_overshoot, &
105             damp_level_1d, dissipation_1d, dp_external, dp_level_b, &
106             dp_smooth, dpdxy, drag_coefficient, dt, dt_pr_1d, &
107             dt_run_control_1d, dx, dy, dz, dz_max, dz_stretch_factor, & 
108             dz_stretch_level, e_init, e_min, end_time_1d, fft_method, &
109             galilei_transformation, grid_matching, humidity, &
110             inflow_damping_height, inflow_damping_width, &
111             inflow_disturbance_begin, inflow_disturbance_end, &
112             initializing_actions, km_constant, km_damp_max, lad_surface, &
113             lad_vertical_gradient, lad_vertical_gradient_level, &
114             leaf_surface_concentration, long_filter_factor, &
115             loop_optimization, mixing_length_1d, masks, momentum_advec, &
116             netcdf_precision, nsor_ini, nx, ny, &
117             nz, ocean, omega, outflow_damping_width, overshoot_limit_e, &
118             overshoot_limit_pt, overshoot_limit_u, overshoot_limit_v, &
119             overshoot_limit_w, passive_scalar, pch_index, phi, & 
120             plant_canopy, prandtl_layer, precipitation, pt_reference, &
121             pt_surface, pt_surface_initial_change, pt_vertical_gradient, &
122             pt_vertical_gradient_level, q_surface, q_surface_initial_change, &
123             q_vertical_gradient, q_vertical_gradient_level, radiation, &
124             random_generator, random_heatflux, recycling_width, rif_max, &
125             rif_min, roughness_length, sa_surface, sa_vertical_gradient, &
126             sa_vertical_gradient_level, scalar_advec, &
127             scalar_exchange_coefficient, statistic_regions, &
128             surface_heatflux, surface_pressure, surface_scalarflux, &
129             surface_waterflux, s_surface, s_surface_initial_change, &
130             s_vertical_gradient, s_vertical_gradient_level, timestep_scheme, &
131             topography, topography_grid_convention, top_heatflux, &
132             top_momentumflux_u, top_momentumflux_v, &
133             top_salinityflux, turbulent_inflow, ug_surface, &
134             ug_vertical_gradient, ug_vertical_gradient_level, u_bulk, &
135             ups_limit_e, ups_limit_pt, ups_limit_u, ups_limit_v, ups_limit_w, &
136             use_surface_fluxes, use_top_fluxes, use_ug_for_galilei_tr, &
137             use_upstream_for_tke, vg_surface, vg_vertical_gradient, &
138             vg_vertical_gradient_level, v_bulk, wall_adjustment, &
139             wall_heatflux, wall_humidityflux, wall_scalarflux
140
141
142    NAMELIST /d3par/   averaging_interval,  averaging_interval_pr, &
143                       call_psolver_at_all_substeps, cfl_factor, &
144                       create_disturbances, cross_normalized_x, &
145                       cross_normalized_y, cross_profiles, cross_ts_uymax, &
146                       cross_ts_uymin, cross_xtext, cycle_mg, data_output, &
147                       data_output_format, &
148                       data_output_mask_01, data_output_mask_02, &
149                       data_output_mask_03, data_output_mask_04, &
150                       data_output_mask_05, data_output_mask_06, &
151                       data_output_mask_07, data_output_mask_08, &
152                       data_output_mask_09, data_output_mask_10, &
153                       data_output_mask_11, data_output_mask_12, &
154                       data_output_mask_13, data_output_mask_14, &
155                       data_output_mask_15, data_output_mask_16, &
156                       data_output_mask_17, data_output_mask_18, &
157                       data_output_mask_19, data_output_mask_20, &
158                       data_output_pr, &
159                       data_output_2d_on_each_pe, disturbance_amplitude, &
160                       disturbance_energy_limit, disturbance_level_b, &
161                       disturbance_level_t, do2d_at_begin, do3d_at_begin, &
162                       do3d_compress, do3d_comp_prec, dt, dt_averaging_input, &
163                       dt_averaging_input_pr, dt_coupling, dt_data_output, &
164                       dt_data_output_av, dt_disturb, dt_domask, dt_dopr, &
165                       dt_dopr_listing, dt_dots, dt_do2d_xy, dt_do2d_xz, &
166                       dt_do2d_yz, dt_do3d, dt_max, dt_restart, dt_run_control,&
167                       end_time, force_print_header, &
168                       mask_scale_x, mask_scale_y, mask_scale_z, &
169                       mask_01_x, mask_02_x, mask_03_x, mask_04_x, &
170                       mask_05_x, mask_06_x, mask_07_x, mask_08_x, &
171                       mask_09_x, mask_10_x, mask_11_x, mask_12_x, &
172                       mask_13_x, mask_14_x, mask_15_x, mask_16_x, &
173                       mask_17_x, mask_18_x, mask_19_x, mask_20_x, &
174                       mask_01_y, mask_02_y, mask_03_y, mask_04_y, &
175                       mask_05_y, mask_06_y, mask_07_y, mask_08_y, &
176                       mask_09_y, mask_10_y, mask_11_y, mask_12_y, &
177                       mask_13_y, mask_14_y, mask_15_y, mask_16_y, &
178                       mask_17_y, mask_18_y, mask_19_y, mask_20_y, &
179                       mask_01_z, mask_02_z, mask_03_z, mask_04_z, &
180                       mask_05_z, mask_06_z, mask_07_z, mask_08_z, &
181                       mask_09_z, mask_10_z, mask_11_z, mask_12_z, &
182                       mask_13_z, mask_14_z, mask_15_z, mask_16_z, &
183                       mask_17_z, mask_18_z, mask_19_z, mask_20_z, &
184                       mask_01_x_loop, mask_02_x_loop, mask_03_x_loop, &
185                       mask_04_x_loop, mask_05_x_loop, mask_06_x_loop, &
186                       mask_07_x_loop, mask_08_x_loop, mask_09_x_loop, &
187                       mask_10_x_loop, mask_11_x_loop, mask_12_x_loop, &
188                       mask_13_x_loop, mask_14_x_loop, mask_15_x_loop, &
189                       mask_16_x_loop, mask_17_x_loop, mask_18_x_loop, &
190                       mask_19_x_loop, mask_20_x_loop, &
191                       mask_01_y_loop, mask_02_y_loop, mask_03_y_loop, &
192                       mask_04_y_loop, mask_05_y_loop, mask_06_y_loop, &
193                       mask_07_y_loop, mask_08_y_loop, mask_09_y_loop, &
194                       mask_10_y_loop, mask_11_y_loop, mask_12_y_loop, &
195                       mask_13_y_loop, mask_14_y_loop, mask_15_y_loop, &
196                       mask_16_y_loop, mask_17_y_loop, mask_18_y_loop, &
197                       mask_19_y_loop, mask_20_y_loop, &
198                       mask_01_z_loop, mask_02_z_loop, mask_03_z_loop, &
199                       mask_04_z_loop, mask_05_z_loop, mask_06_z_loop, &
200                       mask_07_z_loop, mask_08_z_loop, mask_09_z_loop, &
201                       mask_10_z_loop, mask_11_z_loop, mask_12_z_loop, &
202                       mask_13_z_loop, mask_14_z_loop, mask_15_z_loop, &
203                       mask_16_z_loop, mask_17_z_loop, mask_18_z_loop, &
204                       mask_19_z_loop, mask_20_z_loop, &
205                       mg_cycles, mg_switch_to_pe0_level, &
206                       netcdf_64bit, netcdf_64bit_3d, &
207                       netcdf_format_mask, netcdf_format_mask_av, &
208                       ngsrb, normalizing_region, npex, npey, nsor, nz_do3d, &
209                       omega_sor, &
210                       prandtl_number, precipitation_amount_interval, &
211                       profile_columns, profile_rows, psolver, &
212                       rayleigh_damping_factor, rayleigh_damping_height, &
213                       residual_limit, restart_time, section_xy, section_xz, &
214                       section_yz, skip_time_data_output, &
215                       skip_time_data_output_av, skip_time_dopr, &
216                       skip_time_do2d_xy, skip_time_do2d_xz, &
217                       skip_time_do2d_yz, skip_time_do3d, skip_time_domask, &
218                       termination_time_needed, use_prior_plot1d_parameters, &
219                       z_max_do1d, z_max_do1d_normalized, z_max_do2d
220
221
222    NAMELIST /envpar/  host, local_dvrserver_running, maximum_cpu_time_allowed,  &
223                       revision, return_addres, return_username, run_identifier, &
224                       tasks_per_node, write_binary
225
226!
227!-- Open the NAMELIST-file which is send with this job
228    CALL check_open( 11 )
229
230!
231!-- Read the control parameters for initialization.
232!-- The namelist "inipar" must be provided in the NAMELIST-file. If this is
233!-- not the case and the file contains - instead of "inipar" - any other
234!-- namelist, a read error is created on t3e and control is transferred
235!-- to the statement with label 10. Therefore, on t3e machines one can not
236!-- distinguish between errors produced by a wrong "inipar" namelist or
237!-- because this namelist is totally missing.
238    READ ( 11, inipar, ERR=10, END=11 )
239    GOTO 12
240 10 message_string = 'errors in \$inipar &or no \$inipar-namelist ' // &
241                     'found (CRAY-machines only)'
242    CALL message( 'parin', 'PA0271', 1, 2, 0, 6, 0 )
243
244 11 message_string = 'no \$inipar-namelist found'
245    CALL message( 'parin', 'PA0272', 1, 2, 0, 6, 0 )
246
247!
248!-- If required, read control parameters from restart file (produced by
249!-- a prior run). All PEs are reading from file created by PE0 (see check_open)
250 12 IF ( TRIM( initializing_actions ) == 'read_restart_data' )  THEN
251
252       CALL read_var_list
253!
254!--    The restart file will be reopened when reading the subdomain data
255       CALL close_file( 13 )
256
257!
258!--    Increment the run count
259       runnr = runnr + 1
260
261    ENDIF
262
263!
264!-- Definition of names of areas used for computing statistics. They must
265!-- be defined at this place, because they are allowed to be redefined by
266!-- the user in user_parin.
267    region = 'total domain'
268
269!
270!-- Read runtime parameters given by the user for this run (namelist "d3par").
271!-- The namelist "d3par" can be omitted. In that case, default values are
272!-- used for the parameters.
273    READ ( 11, d3par, END=20 )
274
275!
276!-- Read control parameters for optionally used model software packages
277 20 CALL package_parin
278
279!
280!-- Read user-defined variables
281    CALL user_parin
282
283!
284!-- Check in case of initial run, if the grid point numbers are well defined
285!-- and allocate some arrays which are already needed in init_pegrid or
286!-- check_parameters. During restart jobs, these arrays will be allocated
287!-- in read_var_list. All other arrays are allocated in init_3d_model.
288    IF ( TRIM( initializing_actions ) /= 'read_restart_data' )  THEN
289
290       IF ( nx <= 0 )  THEN
291          WRITE( message_string, * ) 'no value or wrong value given for nx: ',&
292                                     'nx=', nx
293          CALL message( 'parin', 'PA0273', 1, 2, 0, 6, 0 )
294       ENDIF
295       IF ( ny <= 0 )  THEN
296          WRITE( message_string, * ) 'no value or wrong value given for ny: ',&
297                                     'ny=', ny
298          CALL message( 'parin', 'PA0274', 1, 2, 0, 6, 0 )
299       ENDIF
300       IF ( nz <= 0 )  THEN
301          WRITE( message_string, * ) 'no value or wrong value given for nz: ',&
302                                     'nz=', nz
303          CALL message( 'parin', 'PA0275', 1, 2, 0, 6, 0 )
304       ENDIF
305!
306!--    ATTENTION: in case of changes to the following statement please also
307!--    check the allocate statement in routine read_var_list
308       ALLOCATE( lad(0:nz+1),pt_init(0:nz+1), q_init(0:nz+1), sa_init(0:nz+1), &
309                 ug(0:nz+1), u_init(0:nz+1), v_init(0:nz+1), vg(0:nz+1),       &
310                 hom(0:nz+1,2,pr_palm+max_pr_user,0:statistic_regions),        &
311                 hom_sum(0:nz+1,pr_palm+max_pr_user,0:statistic_regions) )
312       hom = 0.0
313
314    ENDIF
315
316!
317!-- NAMELIST-file is not needed anymore
318    CALL close_file( 11 )
319
320!
321!-- Read values of environment variables (this NAMELIST file is generated by
322!-- mrun)
323    OPEN ( 90, FILE='ENVPAR', STATUS='OLD', FORM='FORMATTED', ERR=30 )
324    READ ( 90, envpar, ERR=31, END=32 )
325    CLOSE ( 90 )
326    RETURN
327
328 30 message_string = 'local file ENVPAR not found' // &
329                     '&some variables for steering may not be properly set'
330    CALL message( 'parin', 'PA0276', 0, 1, 0, 6, 0 )
331    RETURN
332
333 31 message_string = 'errors in local file ENVPAR' // &
334                     '&some variables for steering may not be properly set'
335    CALL message( 'parin', 'PA0277', 0, 1, 0, 6, 0 )
336    RETURN
337
338 32 message_string = 'no envpar-NAMELIST found in local file ENVPAR'  // &
339                     '&some variables for steering may not be properly set'
340    CALL message( 'parin', 'PA0278', 0, 1, 0, 6, 0 )
341
342 END SUBROUTINE parin
Note: See TracBrowser for help on using the repository browser.