source: palm/tags/release-3.4a/SOURCE/parin.f90 @ 818

Last change on this file since 818 was 139, checked in by raasch, 16 years ago

New:
---

Plant canopy model of Watanabe (2004,BLM 112,307-341) added.
It can be switched on by the inipar parameter plant_canopy.
The inipar parameter canopy_mode can be used to prescribe a
plant canopy type. The default case is a homogeneous plant
canopy. Heterogeneous distributions of the leaf area
density and the canopy drag coefficient can be defined in the
new routine user_init_plant_canopy (user_interface).
The inipar parameters lad_surface, lad_vertical_gradient and
lad_vertical_gradient_level can be used in order to
prescribe the vertical profile of leaf area density. The
inipar parameter drag_coefficient determines the canopy
drag coefficient.
Finally, the inipar parameter pch_index determines the
index of the upper boundary of the plant canopy.

Allow new case bc_uv_t = 'dirichlet_0' for channel flow.

For unknown variables (CASE DEFAULT) call new subroutine user_data_output_dvrp

Pressure boundary conditions for vertical walls added to the multigrid solver.
They are applied using new wall flag arrays (wall_flags_..) which are defined
for each grid level. New argument gls added to routine user_init_grid
(user_interface).

Frequence of sorting particles can be controlled with new particles_par
parameter dt_sort_particles. Sorting is moved from the SGS timestep loop in
advec_particles after the end of this loop.

advec_particles, check_parameters, data_output_dvrp, header, init_3d_model, init_grid, init_particles, init_pegrid, modules, package_parin, parin, plant_canopy_model, read_var_list, read_3d_binary, user_interface, write_var_list, write_3d_binary

Changed:


Redefine initial nzb_local as the actual total size of topography (later the
extent of topography in nzb_local is reduced by 1dx at the E topography walls
and by 1dy at the N topography walls to form the basis for nzb_s_inner);
for consistency redefine 'single_building' case.

Vertical profiles now based on nzb_s_inner; they are divided by
ngp_2dh_s_inner (scalars, procucts of scalars) and ngp_2dh (staggered velocity
components and their products, procucts of scalars and velocity components),
respectively.

Allow two instead of one digit to specify isosurface and slicer variables.

Status of 3D-volume NetCDF data file only depends on switch netcdf_64bit_3d (check_open)

prognostic_equations include the respective wall_*flux in the parameter list of
calls of diffusion_s. Same as before, only the values of wall_heatflux(0:4)
can be assigned. At present, wall_humidityflux, wall_qflux, wall_salinityflux,
and wall_scalarflux are kept zero. diffusion_s uses the respective wall_*flux
instead of wall_heatflux. This update serves two purposes:

  • it avoids errors in calculations with humidity/scalar/salinity and prescribed

non-zero wall_heatflux,

  • it prepares PALM for a possible assignment of wall fluxes of

humidity/scalar/salinity in a future release.

buoyancy, check_open, data_output_dvrp, diffusion_s, diffusivities, flow_statistics, header, init_3d_model, init_dvrp, init_grid, modules, prognostic_equations

Errors:


Bugfix: summation of sums_l_l in diffusivities.

Several bugfixes in the ocean part: Initial density rho is calculated
(init_ocean). Error in initializing u_init and v_init removed
(check_parameters). Calculation of density flux now starts from
nzb+1 (production_e).

Bugfix: pleft/pright changed to pnorth/psouth in sendrecv of particle tail
numbers along y, small bugfixes in the SGS part (advec_particles)

Bugfix: model_string needed a default value (combine_plot_fields)

Bugfix: wavenumber calculation for even nx in routines maketri (poisfft)

Bugfix: assignment of fluxes at walls

Bugfix: absolute value of f must be used when calculating the Blackadar mixing length (init_1d_model)

advec_particles, check_parameters, combine_plot_fields, diffusion_s, diffusivities, init_ocean, init_1d_model, poisfft, production_e

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