Masked data output

General

From release 3.7a (r483) output of masked data is implemented in PALM. This feature allows to output quantities at different mask locations and can already use netCDF4 file format.
Default quantities (instantaneous and time averaged) are available and can be declared with the parameter data_output_masks, user-defined quantities can be output with data_output_masks_user.

Output steering

Different runtime parameters defines the masks and steers the output of the quantities assigned with data_output_masks and/or data_output_masks_user:

dt_domask
mask_scale_x
mask_scale_y
mask_scale_z
mask_x
mask_y
mask_z
mask_x_loop
mask_y_loop
mask_z_loop
skip_time_domask

So far 20 different masks can be defined. Each mask is output to one local file.

Instantaneous data of mask 1 are output to file DATA_MASK_01_NETCDF, time-averaged data to file DATA_MASK_01_AV_NETCDF.
Instantaneous data of mask 2 are output to file DATA_MASK_02_NETCDF, time-averaged data to file DATA_MASK_02_AV_NETCDF.
Instantaneous data of mask 3 are output to file DATA_MASK_03_NETCDF, time-averaged data to file DATA_MASK_03_AV_NETCDF.

Besides assigning the parameters listed above, the required output files have to be comment out in the mrun-configuration file?:

#----------------------------------------------------------------------------
# List of output-files
#----------------------------------------------------------------------------
DATA_MASK_01_NETCDF       out:loc      ma#:maf         $output_data      _m01     nc
DATA_MASK_01_AV_NETCDF    out:loc      ma#:maf         $output_data      _m01_av  nc
DATA_MASK_02_NETCDF       out:loc      ma#:maf         $output_data      _m02     nc
DATA_MASK_02_AV_NETCDF    out:loc      ma#:maf         $output_data      _m02_av  nc
#DATA_MASK_03_NETCDF       out:loc      ma#:maf         $output_data      _m03     nc
#DATA_MASK_03_AV_NETCDF    out:loc      ma#:maf         $output_data      _m03_av  nc
...
#DATA_MASK_20_NETCDF       out:loc      ma#:maf         $output_data      _m20     nc
#DATA_MASK_20_AV_NETCDF    out:loc      ma#:maf         $output_data      _m20_av  nc

Here output of masks 1 and 2 is done. Masks 3 to 20 will not be output even if the parameters are assigned.

Within the mrun call ma# has to be added to the mrun-option -r:

mrun -d example_cbl -h... -r "d3# ma#"

Examples