PALM source code change log

Current revision:

r4901

Current fixed release: 4.0 (r1540)

The following table documents all changes to the PALM repository since 2017.

Previous changes:

• Changes 2013-2016
• Changes 2009-2012.
• Changes ​1998-2008

Please follow the rules for developers when carrying out source code changes!

Entries in the fifth column specify the type of the change: change of existing code (C), new code (N) or bugfix (B). More detailed information about the changes may sometimes be found in the header comment lines of the respectively changed routines.

Date	Author	svn Revision	Last Release	Type	Description
07/06/17	BW	r2257	4.0	B, C	Bugfix: turb_cl_tab and turb_cd_tab were set to zero before being allocated (wind_turbine_model_mod) Change: adjustments for lceddy, removed lcflow-specific code (mbuild, mrun, subjob)
07/06/17	MS	r2256	4.0	B, C, N	Bugfix: remove ring-dependency. (Makefile) Change: change default value of zeta_min to -20. (modules) New: Enable heat/scalar/waterflux at downward-facing surfaces (modules, surface_mod)
07/06/17	HK	r2255	4.0	C	Implemented PALM specific error message handling for parallel random number generator. (random_generator_parallel_mod)
07/06/17	HK	r2252	4.0	C	Air density now depending on surface_pressure even in boussinesq mode and perturbation pressure now depending on flux_output_mode. (flow_statistics, init_3d_model)
06/06/17	SG	r2251	4.0	N	Doxygen comment added. (check_parameters)
06/06/17	SW	r2249	4.0	B	Changed error message. (check_parameters, land_surface_model_mod, radiation_model_mod)
06/06/17	SW	r2247	4.0	B	Changed error message. (land_surface_model_mod)
02/06/17	JS	r2245	4.0	B	Apply boundary conditions for y-direction. Otherwise the origin y-position of particles is also changed for boundary conditions of reflection and absorption. (lpm_exchange_horiz)
01/06/17	BM	r2242	4.0	C	Soil model was adjusted so that the number of soil layers are now freely adjustable via the NAMELIST. The default configuration was changes to a 8-layer setup in order to account for a faster response to turbulence. Note that the new configuration is made for temperature and moisture defined at the center of the soil layers. The current discretization as well as the skin layer still needs adaption. The land surface model thus should be used with care in the present form (land_surface_model_mod). The RRTMG interface was adjusted to allow for PALM runs without cloud physics and humidity. (radiation_model_mod)
01/06/17	AH	r2241	4.0	B	Minor indexing error in pmci_init_loglaw_correction is corrected (pmc_interface_mod)
01/06/17	MS	r2239	4.0	B	Bugfix xy-output of land-surface variables. (netcdf_interface_mod)
31/05/17	MS	r2238	4.0	B	Bugfixes in Makefile, and remove unnecessary module load. (init_pegrid, Makefile)
31/05/17	MS	r2237	4.0	B	Bugfix in writing restart data. (land_surface_model_mod) Bugfix in dependencies on new surface module. (Makefile)
31/05/17	MS	r2236	4.0	N	Add NetCDF input file for topography. (.mrun.config.*)
30/05/17	MS	r2232	4.0	N, C	New topography concept implemented: topography is now considered via flag arrays instead of 2D index arrays overhanging structures like bridges are now possible, i.e. the limitation of surface-mounted topography does not exist anymore new generic topography for tunnels added New surface-modeling concept implemented. surface elements are packed into one-dimensional arrays, belonging to derived data types each surface element comprises relevant data, e.g. modeled momentum and heatfluxes different surfaces are distinguished, i.e. urban-type, natural-type, and default-type surfaces; in addition, different surface facings are considered (upward-, downward-facing, northward-, southward, eastward- and westward-facing surfaces) land-surface model works now also with topography Enable input of topography data in NetCDF format OPENMP bugfix. (poismg_noopt) A documentation about the revised topography and surface-modelling concept can be found here.
30/05/17	AH	r2230	4.0	B	Minor indexing error in pmci_init_anterp_tophat that in certain case caused an overflow is corrected (pmc_interface_mod)
16/05/17	SR	r2225	4.0	C	Simple installation scripts now running under bash. (palm_simple_install, palm_simple_run)
15/05/17	MS	r2223	4.0	B	Add check for particle release at/above model top. (lpm_init)
10/05/17	FK	r2221	4.0	C	Update of .mrun.config.idefix due to change of software paths.
09/05/17	AH	r2220	4.0	B	Two near-wall correction-related array indexing bugs corrected in the interpolation routines (pmc_interface_mod.f90).
28/04/17	MS	r2215	4.0	B	Normalization of spectra output. (spectra_mod)
24/04/17	FK	r2214	4.0	B, C	Bugfix: Added exchange of ghost points in array pc_heating_rate needed for output of pcm_heatrate, and added onetime ghost point exchange of lad_s after initialization (plant_canopy_model_mod) Change: Formatting and clean-up of subroutine pcm_read_plant_canopy_3d, minor re-organization of canopy-heating initialization (plant_canopy_model_mod) Removal of output quantities usm_lad and usm_canopy_hr (urban_surface_mod)
19/04/17	FK	r2210	4.0	B, C, N	Bugfix: for division by zero (urban_surface_mod) Change: removed cpp switch __mpi3 (urban_surface_mod) some formatting in SUBROUTINE usm_find_boundary_face (urban_surface_mod) New: 3D plant canopy model output of leaf area density pcm_lad and plant canopy heat rate pcm_heatrate (check_parameters, data_output_3d, netcdf_interface_mod, plant_canopy_model_mod)
13/04/17	FK	r2202	4.0	N	New .mrun.config.idefix for MOSAIK workstation.
11/04/17	MS	r2200	4.0	C, B	Change: Remove monotonic adjustment for 5th-order advection scheme. (advec_ws, check_parameters, init_grid, init_pegrid, header, modules) Bugfixes: Fix bugs in reading restart data and 2D ghostpoint exchange. (radiation_model_mod)
24/03/17	SR	r2197	4.0	B	Do not allow odd values for nz at the coarsest grid level in case of optimized multigrid solver. This change may decrease the number of possible grid levels which may result in a slower convergence of the solver. Users should carefully choose nz in order to allow for as much levels as possible. Always the best choice would be a multiple of 2. (init_pegrid)
23/03/17	SR	r2194	4.0	B	In case of ocean runs, density is now used in single-value reference state instead of potential density. (init_ocean)
22/03/17	SR	r2192	4.0	B	Index bounds of arrays spectrum_x and spectrum_y revised. (spectra_mod) Misplaced and missing openMP directives from r2155. (prognostic_equations)
21/03/17	SR	r2189, r2190	4.0	B	String rho renamed rho_ocean for the cross section output. (data_output_2d, netcdf_interface_mod)
21/03/17	SR	r2187	4.0	C	Adjustment of compute node names for lckyuh. (subjob)
21/03/17	SR	r2185	4.0	B, C	Bugfix: localhost renamed local_host. (subjob) Change: Batch-environment on lckyu*-hosts is checked by environment variable PJM_ENVIRONMENT. (mrun)
17/03/17	JS	r2183	4.0	N	Added parameters for simplified particle initialization. An initial particle number concentration (number_concentration) for the LCM can be prescribed. Also the number of particles which are created in every grid box can be prescribed with the new parameter number_particles_per_gridbox . (lpm_init, mod_particle_attributes, package_parin)
17/03/17	AH	r2180	4.0	C	Recently added checks to ensure that pdims match the grid dimensions are removed as unnecessary in the automatic determination of pdims in init_pegrid.
17/03/17	AH	r2178	4.0	B	Index limits for perturbations are now set also in case of nested boundary conditions. (check_parameters) Setting perturbations at all times near inflow boundary is removed in case of nested boundaries. (time_integration) Calls for pmci_ensure_nest_mass_conservation and pres are added after the nest initialization. (palm) Checks to ensure that pdims match the grid dimensions are added in the automatic determination of pdims. (init_pegrid)
13/03/17	AH	r2176	4.0	B, N	Bugfixes: 3-D interpolation to create initial conditions for nests is now skipped in case of restart (palm). New: vertical cell-counts for anterpolation are now precomputed and stored in 1-D arrays kfc_w and kfc_s (pmc_interface_mod).
13/03/17	BM	r2174	4.0	B,N,C	Bugfixes: setting of kcb=0, excluding child corner point anterpolation. (pmc_interface_mod) New: nesting can now be used with cloud physics. (pmc_interface_mod, time_integration) Changed: default setting of most_method changed to 'newton' to avoid problems over non-homogeneous surfaces.
08/03/17	HK	r2172	4.0	B	Bugfix: Moved parallel random generator initialization into respective module and removed global array (dirturb_field, init_3d_model, random_generator_parallel_mod)
06/03/17	MS	r2169	4.0	B	Bugfix, move setting of topography_grid_convention to init_grid, else, in case of restarts generic topography may not set properly if no value is prescribed. (check_parameters, init_grid)
01/03/17	JS	r2164	4.0	B	Bugfix in radiation_check_data_output: missing case request for rad_lw_in, rad_lw_out, rad_sw_in, and rad_sw_out added and correct units for output variables added. (radiation_model_mod)
22/02/17	MS	r2157	4.0	B	Bugfix in read_restart_data in case radiation_scheme = 'clear_sky' or 'constant'. (radiation_model_mod)
21/02/17	FH	r2155	4.0	B	Bugfix: cloud microphysics are now also calculated on ghostpoints. (prognostic_equations, microphysics_mod)
17/02/17	LV	r2152	4.0	N, B	New Tip loss correction for the wind turbine parametrization (wind_turbine_model_mod) new control parameter tl_cor (Default=.FALSE.) Bugfix Bugfix in subroutine wtm_read_blade_tables (wind_turbine_model_mod)
09/02/17	KS	r2147	4.0	C, B	Changes improved label bar in palmplot (cross_sections.ncl) added gharbi and kuma to the list of known hosts (subjob) changed allocation of resources for lcbullhh (mrun) Bugfix Land surface parameters II corrected for veg_type 18 and 19 (land_surface_model_mod)
06/02/17	TG	r2141	4.0	C	Changed check for existing files in mrun at the beginning of a run. (mrun)
02/02/17	SR	r2134	4.0	N	Option -E added to msub commands on HLRN-III machines to allow output of more job information in the job protocol files. (subjob)
24/01/17	SR	r2130	4.0	B	In case of nested runs the stop condition in case of too small timesteps is communicated to all parent/child processes. (Makefile, timestep)
20/01/17	MS	r2128	4.0	B	Bugfix, setting of user-defined topography in case of ocean simulations. (init_grid)
20/01/17	SR	r2126	4.0	C	For ocean simulations, density in SGS-TKE-production is replaced by potential density. (production_e)
18/01/17	FH	r2122	4.0	C	A particle ID has been introduced. It is stored on the particle variables id1 and id2. (Creating two IDs is necessary due to the large number of potentially simulated particles.) For this purpose, the unused particles variables tailpoints and tail_id have been renamed. Moreover, the unused particle variable dvrp_psize has been renamed to user and can be used by the user. (lpm_data_output_particles, lpm_init, lpm_set_attributes, mod_particle_attributes) Additionally, the calculation of the equilibrium radius of aerosols has been improved (lpm_init). And the code has been reformatted (lpm_droplet_collision).
17/01/17	SR	r2118	4.0	C	All OpenACC directives and related parts removed from the code (trunk). See the new GPU-porting branch for the OpenACC-GPU version of PALM. (Makefile, advec_ws, boundary_conds, buoyancy, check_parameters, coriolis, cpulog_mod, diffusion_e, diffusion_s, diffusion_u, diffusion_v, diffusion_w, diffusivities, exchange_horiz, fft_xy_mod, flow_statistics, header, init_3d_model, modules, palm, parin, poisfft_mod, pres, production_e, prognostic_equations, surface_layer_fluxes_mod, swap_timelevel, time_integration, timestep, transpose, tridia_solver_mod, wall_fluxes, deleted: cuda_fft_interfaces_mod)
16/01/17	BM	r2116	4.0	N	Beta version of new tool palm_gf added. palm_gf allows to calculate all possible processor grids. A detailed description will follow.
12/01/17	FK	r2114	4.0	N	cpp switch __mpi3 added for MPI-3 standard code. (urban_surface_mod) This was necessary because some older compiler versions cannot handle MPI-3 operations, hence, respective parts of the code shall only be compiled if explicitly enabled by the cpp switch __mpi3. However, the urban surface model only works with these MPI-3 operations included.
09/01/17	FK	r2108	4.0	C	Preparation for doxygen comments. (modules)
06/01/17	HK	r2104	4.0	B	Bugfix: For approximation related flux input conversion (ls_forcing_mod)
05/01/17	MS	r2100	4.0	B	Bugfix: Prevent extremely large SGS-velocities by limiting TKE in stochastic terms. (lpm_advec) Copyright update. (all source-code files)