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

Last change on this file since 392 was 392, checked in by raasch, 15 years ago

New:
---

Adapted for machine lck
(mrun, mbuild, subjob)

bc_lr/bc_ns in most subroutines replaced by LOGICAL variables bc_lr_cyc,
bc_ns_cyc for speed optimization
(check_parameters, diffusion_u, diffusion_v, diffusion_w, modules)

Additional timestep criterion in case of simulations with plant canopy (timestep)

Check for illegal entries in section_xy|xz|yz that exceed nz+1|ny+1|nx+1
(check_parameters)

Clipping of dvrp output implemented. Default colourtable for particles
implemented, particle attributes (color, dvrp_size) can be set with new
parameters particle_color, particle_dvrpsize, color_interval,
dvrpsize_interval (init_dvrp, data_output_dvrp, modules, user_data_output_dvrp).
Slicer attributes (dvrp) are set with new routine set_slicer_attributes_dvrp
and are controlled with existing parameters slicer_range_limits.
(set_slicer_attributes_dvrp)

Ocean atmosphere coupling allows to use independent precursor runs in order
to account for different spin-up times. The time when coupling has to be
started is given by new inipar parameter coupling_start_time. The precursor
ocean run has to be started using new mrun option "-y" in order to add
appendix "_O" to all output files.
(check_for_restart, check_parameters, data_output_2d, data_output_3d,
data_output_profiles, data_output_ptseries, data_output_spectra,
data_output_tseries, header, init_coupling, modules, mrun,
parin, read_var_list, surface_coupler, time_integration, write_var_list)

Polygon reduction for topography and ground plate isosurface. Reduction level
for buildings can be chosen with parameter cluster_size. (init_dvrp)

External pressure gradient (check_parameters, header, init_3d_model, modules,
parin, prognostic_equations, read_var_list, write_var_list)

New topography case 'single_street_canyon' (header, init_grid, modules, parin,
read_var_list, user_check_parameters, user_header, user_init_grid, write_var_list)

Option to predefine a target bulk velocity for conserve_volume_flow
(check_parameters, header, init_3d_model, modules, parin, read_var_list,
write_var_list)

Option for user defined 2D data output in xy cross sections at z=nzb+1
(data_output_2d, user_data_output_2d)

xy cross section output of surface heatfluxes (latent, sensible)
(average_3d_data, check_parameters, data_output_2d, modules, read_3d_binary,
sum_up_3d_data, write_3d_binary)

average_3d_data, check_for_restart, check_parameters, data_output_2d, data_output_3d, data_output_dvrp, data_output_profiles, data_output_ptseries, data_output_spectra, data_output_tseries, init_coupling, init_dvrp, init_grid, init_3d_model, header, mbuild, modules, mrun, package_parin, parin, prognostic_equations, read_3d_binary, read_var_list, subjob, surface_coupler, timestep, time_integration, user_check_parameters, user_data_output_2d, user_data_output_dvrp, user_header, user_init_grid, write_3d_binary, write_var_list

New: set_particle_attributes, set_slicer_attributes_dvrp

Changed:


lcmuk changed to lc to avoid problems with Intel compiler on sgi-ice
(poisfft)

For extended NetCDF files, the updated title attribute includes an update of
time_average_text where appropriate. (netcdf)

In case of restart runs without extension, initial profiles are not written
to NetCDF-file anymore. (data_output_profiles, modules, read_var_list, write_var_list)

Small change in formatting of the message handling routine concering the output in the
job protocoll. (message)

initializing_actions='read_data_for_recycling' renamed to 'cyclic_fill', now
independent of turbulent_inflow (check_parameters, header, init_3d_model)

2 NetCDF error numbers changed. (data_output_3d)

A Link to the website appendix_a.html is printed for further information
about the possible errors. (message)

Temperature gradient criterion for estimating the boundary layer height
replaced by the gradient criterion of Sullivan et al. (1998). (flow_statistics)

NetCDF unit attribute in timeseries output in case of statistic regions added
(netcdf)

Output of NetCDF messages with aid of message handling routine.
(check_open, close_file, data_output_2d, data_output_3d,
data_output_profiles, data_output_ptseries, data_output_spectra,
data_output_tseries, netcdf, output_particles_netcdf)

Output of messages replaced by message handling routine.
(advec_particles, advec_s_bc, buoyancy, calc_spectra, check_for_restart,
check_open, coriolis, cpu_log, data_output_2d, data_output_3d, data_output_dvrp,
data_output_profiles, data_output_spectra, fft_xy, flow_statistics, header,
init_1d_model, init_3d_model, init_dvrp, init_grid, init_particles, init_pegrid,
netcdf, parin, plant_canopy_model, poisfft_hybrid, poismg, read_3d_binary,
read_var_list, surface_coupler, temperton_fft, timestep, user_actions,
user_data_output_dvrp, user_dvrp_coltab, user_init_grid, user_init_plant_canopy,
user_parin, user_read_restart_data, user_spectra )

Maximum number of tails is calculated from maximum number of particles and
skip_particles_for_tail (init_particles)

Value of vertical_particle_advection may differ for each particle group
(advec_particles, header, modules)

First constant in array den also defined as type double. (eqn_state_seawater)

Parameter dvrp_psize moved from particles_par to dvrp_graphics_par. (package_parin)

topography_grid_convention moved from userpar to inipar (check_parameters,
header, parin, read_var_list, user_check_parameters, user_header,
user_init_grid, user_parin, write_var_list)

Default value of grid_matching changed to strict.

Adjustments for runs on lcxt4 (necessary due to an software update on CRAY) and
for coupled runs on ibmy (mrun, subjob)

advec_particles, advec_s_bc, buoyancy, calc_spectra, check_for_restart, check_open, check_parameters, close_file, coriolis, cpu_log, data_output_2d, data_output_3d, data_output_dvrp, data_output_profiles, data_output_ptseries, data_output_spectra, data_output_tseries, eqn_state_seawater, fft_xy, flow_statistics, header, init_1d_model, init_3d_model, init_dvrp, init_grid, init_particles, init_pegrid, message, mrun, netcdf, output_particles_netcdf, package_parin, parin, plant_canopy_model, poisfft, poisfft_hybrid, poismg, read_3d_binary, read_var_list, sort_particles, subjob, user_check_parameters, user_header, user_init_grid, user_parin, surface_coupler, temperton_fft, timestep, user_actions, user_data_output_dvrp, user_dvrp_coltab, user_init_grid, user_init_plant_canopy, user_parin, user_read_restart_data, user_spectra, write_var_list

Errors:


Bugfix: Initial hydrostatic pressure profile in case of ocean runs is now
calculated in 5 iteration steps. (init_ocean)

Bugfix: wrong sign in buoyancy production of ocean part in case of not using
the reference density (only in 3D routine production_e) (production_e)

Bugfix: output of averaged 2d/3d quantities requires that an avaraging
interval has been set, respective error message is included (check_parameters)

Bugfix: Output on unit 14 only if requested by write_binary.
(user_last_actions)

Bugfix to avoid zero division by km_neutral (production_e)

Bugfix for extended NetCDF files: In order to avoid 'data mode' errors if
updated attributes are larger than their original size, NF90_PUT_ATT is called
in 'define mode' enclosed by NF90_REDEF and NF90_ENDDEF calls. This implies a
possible performance loss; an alternative strategy would be to ensure equal
attribute size in a job chain. (netcdf)

Bugfix: correction of initial volume flow for non-flat topography (init_3d_model)
Bugfix: zero initialization of arrays within buildings for 'cyclic_fill' (init_3d_model)

Bugfix: to_be_resorted => s_av for time-averaged scalars (data_output_2d, data_output_3d)

Bugfix: error in formatting the output (message)

Bugfix: avoid that ngp_2dh_s_inner becomes zero (init_3_model)

Typographical error: unit of wpt in dots_unit (modules)

Bugfix: error in check, if particles moved further than one subdomain length.
This check must not be applied for newly released particles. (advec_particles)

Bugfix: several tail counters are initialized, particle_tail_coordinates is
only written to file if its third index is > 0, arrays for tails are allocated
with a minimum size of 10 tails if there is no tail initially (init_particles,
advec_particles)

Bugfix: pressure included for profile output (check_parameters)

Bugfix: Type of count and count_rate changed to default INTEGER on NEC machines
(cpu_log)

Bugfix: output if particle time series only if particle advection is switched
on. (time_integration)

Bugfix: qsws was calculated in case of constant heatflux = .FALSE. (prandtl_fluxes)

Bugfix: averaging along z is not allowed for 2d quantities (e.g. u* and z0) (data_output_2d)

Typographical errors (netcdf)

If the inversion height calculated by the prerun is zero, inflow_damping_height
must be explicitly specified (init_3d_model)

Small bugfix concerning 3d 64bit netcdf output format (header)

Bugfix: dt_fixed removed from the restart file, because otherwise, no change
from a fixed to a variable timestep would be possible in restart runs.
(read_var_list, write_var_list)

Bugfix: initial setting of time_coupling in coupled restart runs (time_integration)

advec_particles, check_parameters, cpu_log, data_output_2d, data_output_3d, header, init_3d_model, init_particles, init_ocean, modules, netcdf, prandtl_fluxes, production_e, read_var_list, time_integration, user_last_actions, write_var_list

  • Property svn:keywords set to Id
File size: 12.0 KB
Line 
1 SUBROUTINE parin
2
3!------------------------------------------------------------------------------!
4! Current revisions:
5! -----------------
6!
7!
8! Former revisions:
9! -----------------
10! $Id: parin.f90 392 2009-09-24 10:39:14Z raasch $
11!
12! 291 2009-04-16 12:07:26Z raasch
13! +local_dvrserver_running in envpar
14! Output of messages replaced by message handling routine.
15! +canyon_height, canyon_width_x, canyon_width_y, canyon_wall_left,
16! canyon_wall_south, conserve_volume_flow_mode, coupling_start_time,
17! dp_external, dp_level_b, dp_smooth, dpdxy, u_bulk, v_bulk in inipar
18! topography_grid_convention moved from userpar
19!
20! 197 2008-09-16 15:29:03Z raasch
21! +cthf,leaf_surface_concentration, scalar_exchange_coefficient
22! +inflow_damping_height, inflow_damping_width, recycling_width,
23! turbulent_inflow in inipar, -skip_time_dosp in d3par,
24! allocation of hom_sum moved from init_3d_model to here,
25! npex, npey moved from inipar to d3par, setting of myid_char_14 removed,
26! lad is allways allocated
27!
28! 138 2007-11-28 10:03:58Z letzel
29! +canopy_mode, drag_coefficient, lad_surface, lad_vertical_gradient,
30! lad_vertical_gradient_level, pch_index, plant_canopy,
31! +allocation of leaf area density field
32!
33! 108 2007-08-24 15:10:38Z letzel
34! +e_init, top_momentumflux_u|v in inipar, +dt_coupling in d3par
35!
36! 95 2007-06-02 16:48:38Z raasch
37! +bc_sa_t, bottom_salinityflux, ocean, sa_surface, sa_vertical_gradient,
38! sa_vertical_gradient_level, top_salinityflux in inipar,
39! sa_init is allocated
40!
41! 87 2007-05-22 15:46:47Z raasch
42! Size of hom increased by the maximum number of user-defined profiles,
43! var_hom renamed pr_palm
44!
45! 82 2007-04-16 15:40:52Z raasch
46! +return_addres, return_username in envpar
47!
48! 75 2007-03-22 09:54:05Z raasch
49! +dt_max, netcdf_64bit_3d, precipitation_amount_interval in d3par,
50! +loop_optimization, pt_reference in inipar, -data_output_ts,
51! moisture renamed humidity
52!
53! 20 2007-02-26 00:12:32Z raasch
54! +top_heatflux, use_top_fluxes in inipar
55!
56! -netcdf_64bit_3d
57!
58! 3 2007-02-13 11:30:58Z raasch
59! +netcdf_64bit_3d in d3par,
60! RCS Log replace by Id keyword, revision history cleaned up
61!
62! Revision 1.57  2007/02/11 13:11:22  raasch
63! Values of environment variables are now read from file ENVPAR instead of
64! reading them with a system call, + NAMELIST envpar
65!
66! Revision 1.1  1997/07/24 11:22:50  raasch
67! Initial revision
68!
69!
70! Description:
71! ------------
72! This subroutine reads variables controling the run from the NAMELIST files
73!------------------------------------------------------------------------------!
74
75    USE arrays_3d
76    USE averaging
77    USE control_parameters
78    USE dvrp_variables
79    USE grid_variables
80    USE indices
81    USE model_1d
82    USE pegrid
83    USE profil_parameter
84    USE statistics
85
86    IMPLICIT NONE
87
88    INTEGER ::  idum
89
90
91    NAMELIST /inipar/  adjust_mixing_length, alpha_surface, bc_e_b, bc_lr, &
92                       bc_ns, bc_p_b, bc_p_t, bc_pt_b, bc_pt_t, bc_q_b, &
93             bc_q_t,bc_s_b, bc_s_t, bc_sa_t, bc_uv_b, bc_uv_t, &
94             bottom_salinityflux, building_height, building_length_x, &
95             building_length_y, building_wall_left, building_wall_south, &
96             canopy_mode, canyon_height, canyon_width_x, canyon_width_y, &
97             canyon_wall_left, canyon_wall_south, cloud_droplets, &
98             cloud_physics, conserve_volume_flow, conserve_volume_flow_mode, &
99             coupling_start_time, cthf, cut_spline_overshoot, &
100             damp_level_1d, dissipation_1d, dp_external, dp_level_b, &
101             dp_smooth, dpdxy, drag_coefficient, dt, dt_pr_1d, &
102             dt_run_control_1d, dx, dy, dz, dz_max, dz_stretch_factor, & 
103             dz_stretch_level, e_init, e_min, end_time_1d, fft_method, &
104             galilei_transformation, grid_matching, humidity, &
105             inflow_damping_height, inflow_damping_width, &
106             inflow_disturbance_begin, inflow_disturbance_end, &
107             initializing_actions, km_constant, km_damp_max, lad_surface, &
108             lad_vertical_gradient, lad_vertical_gradient_level, &
109             leaf_surface_concentration, long_filter_factor, &
110             loop_optimization, mixing_length_1d, momentum_advec, &
111             netcdf_precision, nsor_ini, nx, ny, &
112             nz, ocean, omega, outflow_damping_width, overshoot_limit_e, &
113             overshoot_limit_pt, overshoot_limit_u, overshoot_limit_v, &
114             overshoot_limit_w, passive_scalar, pch_index, phi, & 
115             plant_canopy, prandtl_layer, precipitation, pt_reference, &
116             pt_surface, pt_surface_initial_change, pt_vertical_gradient, &
117             pt_vertical_gradient_level, q_surface, q_surface_initial_change, &
118             q_vertical_gradient, q_vertical_gradient_level, radiation, &
119             random_generator, random_heatflux, recycling_width, rif_max, &
120             rif_min, roughness_length, sa_surface, sa_vertical_gradient, &
121             sa_vertical_gradient_level, scalar_advec, &
122             scalar_exchange_coefficient, statistic_regions, &
123             surface_heatflux, surface_pressure, surface_scalarflux, &
124             surface_waterflux, s_surface, s_surface_initial_change, &
125             s_vertical_gradient, s_vertical_gradient_level, timestep_scheme, &
126             topography, topography_grid_convention, top_heatflux, &
127             top_momentumflux_u, top_momentumflux_v, &
128             top_salinityflux, turbulent_inflow, ug_surface, &
129             ug_vertical_gradient, ug_vertical_gradient_level, u_bulk, &
130             ups_limit_e, ups_limit_pt, ups_limit_u, ups_limit_v, ups_limit_w, &
131             use_surface_fluxes, use_top_fluxes, use_ug_for_galilei_tr, &
132             use_upstream_for_tke, vg_surface, vg_vertical_gradient, &
133             vg_vertical_gradient_level, v_bulk, wall_adjustment, wall_heatflux
134
135
136    NAMELIST /d3par/   averaging_interval,  averaging_interval_pr, &
137                       call_psolver_at_all_substeps, cfl_factor, &
138                       create_disturbances, cross_normalized_x, &
139                       cross_normalized_y, cross_profiles, cross_ts_uymax, &
140                       cross_ts_uymin, cross_xtext, cycle_mg, data_output, &
141                       data_output_format, data_output_pr, &
142                       data_output_2d_on_each_pe, disturbance_amplitude, &
143                       disturbance_energy_limit, disturbance_level_b, &
144                       disturbance_level_t, do2d_at_begin, do3d_at_begin, &
145                       do3d_compress, do3d_comp_prec, dt, dt_averaging_input, &
146                       dt_averaging_input_pr, dt_coupling, dt_data_output, &
147                       dt_data_output_av, dt_disturb, dt_dopr, &
148                       dt_dopr_listing, dt_dots, dt_do2d_xy, dt_do2d_xz, &
149                       dt_do2d_yz, dt_do3d, dt_max, dt_restart, dt_run_control,&
150                       end_time, force_print_header, mg_cycles, &
151                       mg_switch_to_pe0_level, netcdf_64bit, netcdf_64bit_3d, &
152                       ngsrb, normalizing_region, npex, npey, nsor, nz_do3d, &
153                       omega_sor, &
154                       prandtl_number, precipitation_amount_interval, &
155                       profile_columns, profile_rows, psolver, &
156                       rayleigh_damping_factor, rayleigh_damping_height, &
157                       residual_limit, restart_time, section_xy, section_xz, &
158                       section_yz, skip_time_data_output, &
159                       skip_time_data_output_av, skip_time_dopr, &
160                       skip_time_do2d_xy, skip_time_do2d_xz, &
161                       skip_time_do2d_yz, skip_time_do3d, &
162                       termination_time_needed, use_prior_plot1d_parameters, &
163                       z_max_do1d, z_max_do1d_normalized, z_max_do2d
164
165
166    NAMELIST /envpar/  host, local_dvrserver_running, maximum_cpu_time_allowed,  &
167                       revision, return_addres, return_username, run_identifier, &
168                       tasks_per_node, write_binary
169
170!
171!-- Open the NAMELIST-file which is send with this job
172    CALL check_open( 11 )
173
174!
175!-- Read the control parameters for initialization.
176!-- The namelist "inipar" must be provided in the NAMELIST-file. If this is
177!-- not the case and the file contains - instead of "inipar" - any other
178!-- namelist, a read error is created on t3e and control is transferred
179!-- to the statement with label 10. Therefore, on t3e machines one can not
180!-- distinguish between errors produced by a wrong "inipar" namelist or
181!-- because this namelist is totally missing.
182    READ ( 11, inipar, ERR=10, END=11 )
183    GOTO 12
184 10 message_string = 'errors in \$inipar &or no \$inipar-namelist ' // &
185                     'found (CRAY-machines only)'
186    CALL message( 'parin', 'PA0271', 1, 2, 0, 6, 0 )
187
188 11 message_string = 'no \$inipar-namelist found'
189    CALL message( 'parin', 'PA0272', 1, 2, 0, 6, 0 )
190
191!
192!-- If required, read control parameters from restart file (produced by
193!-- a prior run). All PEs are reading from file created by PE0 (see check_open)
194 12 IF ( TRIM( initializing_actions ) == 'read_restart_data' )  THEN
195
196       CALL read_var_list
197!
198!--    The restart file will be reopened when reading the subdomain data
199       CALL close_file( 13 )
200
201!
202!--    Increment the run count
203       runnr = runnr + 1
204
205    ENDIF
206
207!
208!-- Definition of names of areas used for computing statistics. They must
209!-- be defined at this place, because they are allowed to be redefined by
210!-- the user in user_parin.
211    region = 'total domain'
212
213!
214!-- Read runtime parameters given by the user for this run (namelist "d3par").
215!-- The namelist "d3par" can be omitted. In that case, default values are
216!-- used for the parameters.
217    READ ( 11, d3par, END=20 )
218
219!
220!-- Read control parameters for optionally used model software packages
221 20 CALL package_parin
222
223!
224!-- Read user-defined variables
225    CALL user_parin
226
227!
228!-- Check in case of initial run, if the grid point numbers are well defined
229!-- and allocate some arrays which are already needed in init_pegrid or
230!-- check_parameters. During restart jobs, these arrays will be allocated
231!-- in read_var_list. All other arrays are allocated in init_3d_model.
232    IF ( TRIM( initializing_actions ) /= 'read_restart_data' )  THEN
233
234       IF ( nx <= 0 )  THEN
235          WRITE( message_string, * ) 'no value or wrong value given for nx: ',&
236                                     'nx=', nx
237          CALL message( 'parin', 'PA0273', 1, 2, 0, 6, 0 )
238       ENDIF
239       IF ( ny <= 0 )  THEN
240          WRITE( message_string, * ) 'no value or wrong value given for ny: ',&
241                                     'ny=', ny
242          CALL message( 'parin', 'PA0274', 1, 2, 0, 6, 0 )
243       ENDIF
244       IF ( nz <= 0 )  THEN
245          WRITE( message_string, * ) 'no value or wrong value given for nz: ',&
246                                     'nz=', nz
247          CALL message( 'parin', 'PA0275', 1, 2, 0, 6, 0 )
248       ENDIF
249!
250!--    ATTENTION: in case of changes to the following statement please also
251!--    check the allocate statement in routine read_var_list
252       ALLOCATE( lad(0:nz+1),pt_init(0:nz+1), q_init(0:nz+1), sa_init(0:nz+1), &
253                 ug(0:nz+1), u_init(0:nz+1), v_init(0:nz+1), vg(0:nz+1),       &
254                 hom(0:nz+1,2,pr_palm+max_pr_user,0:statistic_regions),        &
255                 hom_sum(0:nz+1,pr_palm+max_pr_user,0:statistic_regions) )
256       hom = 0.0
257
258    ENDIF
259
260!
261!-- NAMELIST-file is not needed anymore
262    CALL close_file( 11 )
263
264!
265!-- Read values of environment variables (this NAMELIST file is generated by
266!-- mrun)
267    OPEN ( 90, FILE='ENVPAR', STATUS='OLD', FORM='FORMATTED', ERR=30 )
268    READ ( 90, envpar, ERR=31, END=32 )
269    CLOSE ( 90 )
270    RETURN
271
272 30 message_string = 'local file ENVPAR not found' // &
273                     '&some variables for steering may not be properly set'
274    CALL message( 'parin', 'PA0276', 0, 1, 0, 6, 0 )
275    RETURN
276
277 31 message_string = 'errors in local file ENVPAR' // &
278                     '&some variables for steering may not be properly set'
279    CALL message( 'parin', 'PA0277', 0, 1, 0, 6, 0 )
280    RETURN
281
282 32 message_string = 'no envpar-NAMELIST found in local file ENVPAR'  // &
283                     '&some variables for steering may not be properly set'
284    CALL message( 'parin', 'PA0278', 0, 1, 0, 6, 0 )
285
286 END SUBROUTINE parin
Note: See TracBrowser for help on using the repository browser.