== PALM source code change log ==

'''Current revision:'''  [[CRev]] [[BR]]
'''Current fixed release:''' 4.0 (r1540)

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

'''Previous changes:'''
* Changes [wiki:/doc/tec/changelog_2013-2016 2013-2016] 
* Changes [wiki:/doc/tec/changelog_2009-2012 2009-2012].
* Changes [http://www.muk.uni-hannover.de/~raasch/PALM_group/doc/tec/tec_doc_1998-2008.html 1998-2008]

Please follow the [wiki:/doc/tec/developerrules 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''' =||
|----------------
{{{#!td style="vertical-align:top;width: 50px"
17/03/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
AH
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2180
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
C
}}}
{{{#!td style="vertical-align:top"
Recently added checks to ensure that pdims match the grid dimensions are removed as unnecessary in the automatic determination 
of pdims in init_pegrid.f90.
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
17/03/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
AH
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2178
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
B
}}}
{{{#!td style="vertical-align:top"
Index limits for perturbations are now set also in case of nested boundary conditions in check_parameters.f90.
Setting perturbations at all times near inflow boundary is removed in case of nested boundaries in time_integration.f90.
Calls for pmci_ensure_nest_mass_conservation and pres are added after the nest initialization in the main program palm.f90.
Checks to ensure that pdims match the grid dimensions are added in the automatic determination of pdims in init_pegrid.f90.
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
13/03/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
AH
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2176
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
B, N
}}}
{{{#!td style="vertical-align:top"
'''Bugfixes:''' 3-D interpolation to create initial conditions for nests is now skipped in case of restart (palm.f90). 

'''New:''' vertical cell-counts for anterpolation are now precomputed and stored in 1-D arrays kfc_w and kfc_s (pmc_interface_mod.f90).
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
13/03/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
BM
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2174
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
B,N,C
}}}
{{{#!td style="vertical-align:top"
'''Bugfixes:''' setting of kcb=0, excluding child corner point anterpolation (pmc_interface_mod.f90)

'''New:''' nesting can now be used with cloud physics (pmc_interface_mod.f90, time_integration.f90).

''Changed:''' default setting of {{{most_method}}} changed to 'newton' to avoid problems over non-homogeneous surfaces.
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
08/03/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
HK
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2172
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
B
}}}
{{{#!td style="vertical-align:top"
Bugfix: Moved parallel random generator initialization into respective module and removed global array (dirturb_field, init_3d_model, random_generator_parallel_mod)
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
06/03/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
MS
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2169
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
B
}}}
{{{#!td style="vertical-align:top"
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)
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
01/03/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
JS
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2164
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
B
}}}
{{{#!td style="vertical-align:top"
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.f90)
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
22/02/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
MS
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2157
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
B
}}}
{{{#!td style="vertical-align:top"
Bugfix in read_restart_data in case radiation_scheme = 'clear_sky' or 'constant'. (radiation_model_mod.f90)
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
21/02/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
FH
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2155
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
B
}}}
{{{#!td style="vertical-align:top"
Bugfix: cloud microphysics are now also calculated on ghostpoints (prognostic_equations.f90, microphysics_mod.f90)
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
17/02/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
LV
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2152
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
N, B
}}}
{{{#!td style="vertical-align:top"
'''New'''\\
- Tip loss correction for the wind turbine parametrization (wind_turbine_model_mod.f90)\\
- new control parameter tl_cor (Default=.FALSE.)\\
[[BR]]
'''Bugfix'''\\
- Bugfix in subroutine wtm_read_blade_tables (wind_turbine_model_mod.f90)\\
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
09/02/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
KS
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2147
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
C, B
}}}
{{{#!td style="vertical-align:top"
'''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)\\
[[BR]]
'''Bugfix'''\\
- Land surface parameters II corrected for veg_type 18 and 19 (land_surface_model_mod)
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
06/02/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
TG
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2141
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
C
}}}
{{{#!td style="vertical-align:top"
Changed check for existing files in '''mrun''' at the beginning of a run. (mrun)
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
02/02/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
SR
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2134
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
N
}}}
{{{#!td style="vertical-align:top"
Option {{{-E}}} added to '''msub''' commands on HLRN-III machines to allow output of more job information in the job protocol files. (subjob)
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
24/01/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
SR
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2130
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
B
}}}
{{{#!td style="vertical-align:top"
In case of nested runs the stop condition in case of too small timesteps is communicated to all parent/child processes. (Makefile, timestep)
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
20/01/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
MS
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2128
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
B
}}}
{{{#!td style="vertical-align:top"
Bugfix, setting of user-defined topography in case of ocean simulations. (init_grid)
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
20/01/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
SR
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2126
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
C
}}}
{{{#!td style="vertical-align:top"
For ocean simulations, density in SGS-TKE-production is replaced by potential density. (production_e)
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
18/01/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
FH
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2122
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
C
}}}
{{{#!td style="vertical-align:top"
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).
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
17/01/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
SR
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2118
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
C
}}}
{{{#!td style="vertical-align:top"
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)
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
16/01/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
BM
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2116
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
N
}}}
{{{#!td style="vertical-align:top"
Beta version of new tool {{{palm_gf}}} added. {{{palm_gf}}} allows to calculate all possible processor grids. A detailed description will follow.
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
12/01/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
FK
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2114
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
N
}}}
{{{#!td style="vertical-align:top"
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.
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
09/01/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
FK
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2108
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
C
}}}
{{{#!td style="vertical-align:top"
Preparation for doxygen comments. (modules) 
}}}
|----------------
{{{#!td style="vertical-align:top;width: 50px"
05/01/17
}}}
{{{#!td style="vertical-align:top;width: 50px"
MS
}}}
{{{#!td style="vertical-align:top;width: 75px"
r2100
}}}
{{{#!td style="vertical-align:top"
4.0
}}}
{{{#!td style="vertical-align:top"
B
}}}
{{{#!td style="vertical-align:top"
Bugfix: Prevent extremely large SGS-velocities by limiting TKE in stochastic terms. (lpm_advec) ////

Copyright update. (all source-code files)
}}}
|----------------