ToDo-List

Documentation

Page (e. g. wiki/doc/app/userint)	What to do?	Name
wiki/doc/app/jobcontrol	Restructure mrun documentation --> Update and simplify palmrun documentation, check links to former mrun (now palmrun) docu
wiki/doc/tec/mbuild	Description of mbuild --> Now palmbuild, update docu and links
wiki/doc/tec/subjob	Description of subjob --> no longer exists
wiki/doc/app/mrungui	Update mrungui description --> Now palmrungui, update docu and links
wiki/doc	more clear structure for wiki/doc
wiki/doc/tec/1d_model	Description of 1d model
wiki/doc/tec/cloud_physics	Description of cloud physics module
wiki/doc/app/errmsg	complete and check existing PALM error messages (Remaining Numbers without description: PA0149, 226, 228, 234, 245-270, 296-301, 309, 319-321, 327, 328, 330, 334-338, 460-464, UI0002; the error message itself is sufficient for many of these -> mark them in a special way?)	Simon and Sebastian with help from others
<page>	Links from manual to tutorial
<page>	Write descriptions for exercises 6-14 (divide all exercises into Tutorial exercises and Advanced exercises), Advanced examples->Research project examples
wiki/doc/	Description of statistical methods (computation of fluxes and variances, horizontal averaging, etc.)
wiki/doc/tec/wtm	Write documentation for wind turbine parametrization code	Björn Witha
	Add additions/correction page for the Maronga et al. 2015 paper so that we can incorporate them in the next model description paper
Tutorial	Various exercises and general presentation are since long time listed as "under construction". Links have been removed for now.
	* Data visualization with VAPOR
	* Data visualization with DVR
	* Exercise 6: Cumulus cloud from cloud droplets
	* Exercise 7: Ocean mixed layer
	* Exercise 8: Atmosphere-ocean coupling
	* Exercise 9: Canopy flow
	* Exercise 12: Non-cyclic boundary conditions
	* Exercise 13: Turbulence recycling
	* Exercise 14: Using DVR
	* Example: Footprints
	* Example: Stable boundary layer (GABLS3)
	* Cloud Physics up to date?
homepage	replace the provisional picture (showing Kelvin-Helmholtz waves) by a nicer one from an urban canopy simulation

PALM seminar improvements (for 2017) mainly Farah

Item	What to do?	Name
Parameter file inconsistencies	Settings for data output are not consistent within the parameter file. For example, 3d/2d/pr output variables are explicitly declared, but timeseries are always the same (confusing for users). Also, differentiation between data_output and data_output_pr is confusing. A possible solution would be to use data_output exlusively and include profiles, e.g. for pt this then would read "pt", "pt_xy", "pt_pr", etc.
dt_dots	Description in the documentation should be revised (default value)
palmplot	Make palmplot compatible with latest NCL versions
...

Source Code

Program parts	What to do?	Name
PALM code	W* and Z_I in the first line of the run control file don't correspond to the values in the last run control output line of the previous run.
PALM code	Bug: restart crashes in sum_up_3d_data if an _av quantity is given in the restart run NAMELIST file (_p3dr) but not in the initial run NAMELIST file (_p3d)
	develop new GUI for parameter file generation
mrun, subjob	allow batch-job-directives (e.g. PBS) and execution commands (mpiexec, aprun, etc.) to be configured using entries in .mrun.config	Siggi r2422
mrun, subjob, mbuild	cleaning (make everything bash compatible?!)	Siggi r2422
PALM code	code clearing and restructuring following programmer guidelines of DWD/DMI	all, Siggi
PALM code	Add description for all variables/quantities used in PALM according to doxygen syntax, most important is file modules.f90	Farah
	- move initialization from init_3d_model to the respective modules
<page>	Avoid collecting of 2D data on PE0 (topography data, surface coupling layer)
<page>	Subgrid-scale saturation fluctuation for Lagrangian cloud model	Fabian
	implementation of a tracbot, which automatically runs and checks examples in case of any code changes
data_output	implement output of hydrostatic pressure (already done!)	Helge
data_output	implement output of scalar and momentum fluxes calculated by temporal EC
PALM code	Create temporary job sub-directories via mrun (does not work properly with the FORTRAN system call function)
PALM code	Discuss the treatment of package parameters, regarding their appearance in read_var_list and write_var_list. Discuss the general treatment / separation of inipar and d3par parameters.	all
Example runs	Modify the "building" example run (example_building_p3d), since topography is allowed with WS-scheme
PALM code	For reference_state='horizontal_average' round the averaged profile (e.g. 3.3 digits) to make runs repeatable
PALM code	Avoid repeating code blocks in data_output routines and use subroutines instead
PALM code	Avoid unnecessary grid checks when using multi grid solver	??
PALM code	Implement Johannes' splitting and merging algorithm for Lagrangian particles	Johannes
PALM code	make simple random number generator available for general usage	Fabian
PALM code	Implement and homogenize output of cloud-physical variables derived from bulk and Lagrangian cloud physics (e.g., qc, ql, qr, lpt, pt)	Fabian
PALM code/ documentation	Change the name specific humidity to mixing ratio! We don't compute specific humidities.	Fabian
data_output	In profile output define zu and zw only once instead of define a vertical dimension for each individual variable (e.g. zpt, zw"u, zw"v, ...)
data_output	When calculating vertical cross sections averaged along x or y, leave out topography
data_output	Do not output ghost points (still done in masked output)
data output steering	User find it confusing that they have to specify the data output in the parameter file (e.g. for xy and 3d output) and then switch data output on AGAIN in the mrun call. Maybe we can find a more convenient solution?
PALM code	Separate option "cyclic_fill" from restart run to avoid unwanted effects (e.g. surface heat flux value in namelist of a run using "cyclic_fill" will always be overwritten by the value used in the precursor run).
PALM code	define dimensions of data_output, data_output_pr, etc. as variables (avoid fixed numbers in code)
PALM code	Implement a more flexible y-shift method for non-cyclic but also for cyclic runs	Simon
PALM code	Particle code: unify allocation of particle arrays within lpm_droplet_collision, lpm_droplet_condensation, ... (REAL(wp), DIMENSION(:), ALLOCATABLE or REAL(wp), DIMENSION(prt_count(k,j,i)))	Fabian
PALM code	Use only one Magnus formula within the code (not several as in microphysics.f90, lpm_droplet_condensation.f90, calc_liquid_water.f90, land_surface_model.f90)	Fabian
PALM code	Implement PALM error messages in parallel random number generator module	Helge
mrun / data output	Use same cycle number for all output files	Siggi r2262
PALM code	Review summation of "1E-5_wp" in lines 164/167 in diffusivities.f90 (r2119), see ticket:393
data_output	Make use of already implemented 'long_name' attribute of variables, i.e. give possibility to assign a long_name for user defined variables
data_output	Set missing values/fill values inside topography and define these missing values as attributes in NetCDF file.
data_output	Make proper use of global attributes; especially do not write time average interval in title if there exists a specific attribute (time_avg) for this.
mrun, .mrun.config	allow for a different name and directory for the "job_queue" folder	Siggi r2422
PALM code	for consistency reasons, implement "initial gradient" top boundary conditions for the mixing ratio too	Fabian
RRTMG coupling	allow for dry runs with RRTMG (might lead to unrealistic results if the atmosphere is considered totally dry!)	Björn
PALM code	allow more flexible vertical grid stretching, e.g. for having near-surface stretching, constant grid spacing above and again stretching in the free atmosphere
check parameters	with psolver=multigrid, check that the subdomains can be divived by 2 at least once (see documentation of the multigrid). Is this still a problem? Needs to be checked.
LSM	adjustments	Björn
Flux output	adjustments for LSM and USM	Helge+Björn
Spectra output	Check and possibly revise spectra normalization with wavenumber
Initialization	It needs to be clarified that the initial wind profile constructed by ug_surface, ug_vertical_gradient etc. describes the forcing by the geostrophic wind (pressure gradient), and at the same time depicts the initial actual-wind profile.
PALM scripts	Not all SCRIPTS bash based yet.
palmrun	make working directory independent from installation directory	Siggi
NAMELISTs	it should be possible to give output levels in real coordinates (m) instead of grid level, output should then be done for the nearest grid point
data_output	all output checks should be done BEFORE the first time step, and not when the first output is done
Nesting output	additional output of nesting information is required (e.g. in header): for root domain: number of nested domains, name of nested domains, number of nesting levels; for each domain: position of the nest domains given in grid index number range, e.g. (20..40,10:15), also position of lower left corners in physical coordinates?

Code performance

	define setups for scaling / benchmark runs	Björn, Siggi, Fabian
	carry out runs to determine PALM's weak/strong scaling behaviour + parallel efficiency, this might be good to be carried out during the test phase of the HLRNIV	?
<page>	<what>	<name>

Tools

-	new plotting tool to replace palmplot	Christoph + Hiwi
-	revision of document_changes to be called only once	Björn
-	extend PALM grid finder for nesting configurations	Hiwi
-	development and implementation of an automatic mechanism to test source code modifications	Helge