Version 104 (modified by witha, 14 years ago) (diff)

--

dvr parameters
















Package: (mrun option -r) dvrp_graphics
NAMELIST group name: dvrp_graphics_par

Parameter Name FORTRAN
Type
Default
Value
Explanation

clip_dvrp_l

R

0.0

Left boundary of the displayed domain (in m).

This parameter can be used to restrict the display of the total horizontal domain, e.g. to reduce the data size of the dvr-output in order to speed-up the animated sequence.

clip_dvrp_n

R

(ny+1)*dy

North boundary of the displayed domain (in m).

This parameter can be used to restrict the display of the total horizontal domain, e.g. to reduce the data size of the dvr-output in order to speed-up the animated sequence.

clip_dvrp_r

R

(nx+1)*dx

Right boundary of the displayed domain (in m).

This parameter can be used to restrict the display of the total horizontal domain, e.g. to reduce the data size of the dvr-output in order to speed-up the animated sequence.

clip_dvrp_s

R

0.0

South boundary of the displayed domain (in m).

This parameter can be used to restrict the display of the total horizontal domain, e.g. to reduce the data size of the dvr-output in order to speed-up the animated sequence.

cluster_size

I

Vertex cluster size for polygon reduction of topography.

This parameter can be used to reduce the number of polygones which form the topography isosurface. In case of large numerical grids (large number of gridpoints) and/or complex topography, cluster_size > 1 may speed up the animation significantly. Disadvantage: buildings may loose their strict rectangular shape.

The allowed range of values is 1 <= cluster_size <= 5.

Warning: The allowed range of values is not checked. Wrong values may lead to unforseen effects or even aborts!

color_interval

R(2)

0.0, 1.0

Interval of values used for determining the particle color displayed in the animation.

See particle_color for further explanation.

dt_dvrp

R

9999999.9

Temporal interval of scenes to be displayed with the dvr software (in s).

Isosurfaces, cross sections and particles can be displayed simultaneous. The display of particles requires that the particle transport is switched on (see dt_prel). Objects to be displayed have to be determined with mode_dvrp.

If output of scenes created by dvr software is switched on (see mode_dvrp), this parameter can be used to assign the temporal interval at which scenes are to be created (and the respective graphical data is to be output to the streaming server). Reference time is the beginning of the simulation, i.e. output takes place at times t = dt_dvrp, 2*dt_dvrp, 3*dt_dvrp, etc. The actual output times can deviate from these theoretical values (see dt_dopr). Is dt_dvrp < dt, then scenes are created and output after each time step (if this is requested it should be dt_dvrp = 0).

dvrpsize_interval

R(2)

0.0, 1.0

Interval of values used for determining the particle size displayed in the animation.

See particle_dvrpsize for further explanation.

dvrp_directory

C*80

'default'

Name of the directory into which data created by the dvr software shall be saved.

By default, the directory name is generated from the user name (see package parameter dvrp_username) and the base file name (given as the argument of mrun option -d) as '<user name>/<base file name>'.

dvrp_file

C*80

'default'

Name of the file into which data created by the dvr software shall be output.

This parameter can be given a value only in case of dvrp_output = 'local' which determines that the data created by dvr is output to a local file (on the machine where PALM is executed). Apart from the default, it is only allowed to assign '/dev/null' (which means that no output is really stored). This can be used for special runtime measurements of the dvr software.

dvrp_host

C*80

'origin.rvs.uni-hannover.de'

Name of the computer to which data created by the dvr software shall be transferred.

In case of dvrp_output = 'rtsp' only the default value is allowed (streaming server of the RRZN). For dvrp_output = 'local' the assigned value is ignored.

dvrp_output

C*10

'rtsp'

Output mode for the dvr software.

The following settings are allowed:

'rtsp'

Data created by the dvr software is transferred using a special transmission protocol to a so-called streaming server, which is able to continuously transfer visualization data with a high transmission rate. Additionally, with this output mode a set of files is generated automatically within a directory on the streaming server (beside the visualization data e.g. some html-files) which can be used to visualize the data via an internet-browser plugin. Host (streaming-server) and directory can be defined by the user with dvrp_host and dvrp_directory.

'ftp'

Data created by the dvr software is transferred to the destination host (see dvrp_host and dvrp_directory) using ftp.

'local'

Data created by the dvr software is output locally on a file defined by dvrp_file.

dvrp_password

C*80

'********'

Password for the computer to which data created by the dvr software is to be transferred.

Assigning a password is only necessary in case of dvrp_output = 'ftp'. For dvrp_output = 'rtsp' the default value must not be changed!

dvrp_psize

R

0.2 * dx

Diameter that particles are given in visualizations with the dvr software (in m).
In case that particles are visualized with the dvr software (see chapter 4.5.7?), their size can be set by parameter dvrp_psize. All particles are displayed with this same size.
Alternatively, the particle size can be controlled by certain flow parameters using parameter particle_dvrpsize.
Another way to control the particles diameter is to set it with the user-interface in routine user_init_particles (at the beginning of the simulation) and/or to redefine it after each timestep in routine user_particle_attributes.
Note: This parameter determines exclusively the size under which particles appear in the dvr visualization. The flow relevant particle radius is determined via the particle parameter radius!

dvrp_username

C*80

User name of a valid account on the computer to which data created by the dvr software is to be transferred.

Assigning a value to this parameter is required in case of dvrp_output = 'rtsp' or 'ftp'.

groundplate_color

R(3)

0.0, 0.6, 0.0

Color of the ground plate.

The color is given in RGB (red/green/blue) portions. The default color of the ground plate is green.

isosurface_color

R(3,10)

0.9, 0.9, 0.9 0.8, 0.1, 0.1 0.1, 0.1, 0.8 0.1, 0.8, 0.1 0.6, 0.1, 0.1 0.1, 0.1, 0.6 0.1, 0.6, 0.1 0.4, 0.1, 0.1 0.1, 0.1, 0.4 0.1, 0.4, 0.1

Color of the isosurface(s).

Colors are given in RGB (red/green/blue) portions. By default, the first isosurface has a gray color, the second a red color, the third a blue color, etc.

mode_dvrp

C*20(10)

10 * ' '

Graphical objects (isosurfaces, slicers, particles) which are to be created by the dvr software.

Several different objects can be assigned simultaneously and will be displayed in the same scene. Allowed values for mode_dvrp are 'isosurface##' (isosurface), 'slicer##' (cross sections), and 'particles'. Within the strings the hash characters (##) have to be replaced by two digits 01≤##≤99. Up to 10 objects can be assigned at the same time, e.g.:

mode_dvrp = 'isosurface02', 'slicer01', 'particles', 'slicer02'

In this case one isosurface, two cross sections, and particles will be created. The quantities for which isosurfaces or cross sections are to be created have to be selected with the parameter data_output (data_output also determines the orientation of the cross section, thus xy, xz, or yz). Since for data_output lists of variables may be assigned, the digits at the end of the mode_dvrp-string select the quantity, which is given at the respective position in the respective list (e.g. 'isosurface02' selects the second 3D quantity of data_output, 'slicer01' selects the first 2D quantity of data_output). If e.g. data_output is assigned as data_output = 'u_xy', 'w_xz', 'v_yz', 'pt', 'u', 'w', then - assuming the above assignment of mode_dvrp - an isosurface of u, a horizontal cross section of u and a vertical cross section (xz) of w are created. For locations of the cross sections see data_output. The theshold value for which the isosurface is to be created can be defined with parameter threshold. The isosurface color is controlled by parameter isosurface_color.

The particles color and size can be set using parameters particle_color and particle_dvrpsize.

The vertical extension of the displayed domain is given by nz_do3d.

The displayed horizontal domain can be restricted using parameters clip_dvrp_l, clip_dvrp_r, clip_dvrp_n, clip_dvrp_s.

If user-defined dvrp objects exist (see chapter 3.5.4?), then mode_dvrp may also refer to quantities selected with the parameter data_output_user (internally PALM appends them to those selected with the parameter data_output).

Assignments of mode_dvrp must correspond to those of data_output and data_output_user! If e.g. data_output = 'pt_xy', 'w' was set, then only the digits "01" are allowed for mode_dvrp, thus 'isosurface01' and/or 'slicer01'.

Further details about using the dvr software are given in chapter 4.5.7?.

Note:
The declaration of color charts to be used still have to be given "manually" in subroutine user_dvrp_coltab (file user_dvrp_coltab.f90).

particle_color

C*10

'none'

Parameter, which allows to bind the displayed particle color to certain flow quantities.

By default, particles have a black color.

Allowed values for particle_color are:

'absuv'

Particle color depends on the absolute value of the resolved-scale horizontal velocity (SQRT(u2+v2) at the particle position.

'pt*'

Particle color depends on the deviation of the resolved-scale potential temperature at the particle position from the horizontally averaged potential temperature (total domain).

'z'

Particle color depends on the height of the particle with respect to the bottom boundary (z=0).

The colortable used for particles ranges from deep blue to deep red with yellow in between. The interval of values from the above listed quantities to be mapped to these colors is defined by parameter color_interval.

Example:
If particle_color = 'pt*' and color_interval = -0.5, +0.5, then all particles at positions with pt* <= -0.5 K will have a deep blue color and those at positions with pt* >= +0.5 K will have a deep red color, while those with -0.5 < pt* < +0.5 will vary in color from deep blue to deep red and transition from yellow to blue indicate pt* ~ 0.0.

particle_dvrpsize

C*10

'none'

Parameter, which allows to bind the displayed particle size to certain flow quantities.

The default particle size (diameter) is determined with parameter dvrp_psize.

Allowed values for particle_dvrpsize are:

'absw'

The particle size depends on the absolute value of the resolved-scale vertical velocity w at the particle position.

The particle sizes ranges from 0.25*dx m to 0.85*dx m. The interval of values from the above listed quantities to be mapped to these sizes is defined by parameter dvrpsize_interval.

Example:
If particle_dvrpsize = 'absw' and dvrpsize_interval = 1.0, 2.0, then all particles at positions where the absolute value of w is <= 1.0 m/s will have a size of 0.25*dx m and those at positions with |w| >= 2.0 m/s will have a size of 0.85*dx m, while those with 1.0 m/s < |w| < 2.0 m/s will linearly vary in size from 0.25*dx m to 0.85*dx m.

slicer_range_limits _dvrp

R(2,10)

10 * (-1,1)

Ranges of values to which a color table has to be mapped (units of the respective quantity).

In case that slicers have to be displayed (see mode_dvrp), this parameter defines the ranges of values of the respective quantities to which the colortable in use has to be mapped. If e.g. a temperature slice shall be displayed, the colortable defines colors from blue to red, and slicer_range_limits_dvrp = 290.0, 305.0 then areas with temperature of 290 K are displayed in dark blue and those with 305.0 are displayed in dark red. Temperatures within these limits will be displayed by a continuous color gradient from blue to red and Temperatures outside the limits will be displayed either in dark blue or in dark red.

Up to ten different ranges can be assigned in case that more than one slicer has to be displayed.

See mode_dvrp for the declaration of color charts.

superelevation

R

1.0

Superelevation factor for the vertical coordinate.

For domains with unfavorable ratio between the vertical and the horizontal size (the vertical size is determined by nz_do3d) a superelevation /= 1.0 may be used. If e.g. the horizontal size is substantially larger than the vertical size, a superelevation much larger than 1.0 should be used, since otherwise the domain appears as a "flat disk" in the visualization and thus the vertical direction is only very poorly resolved.

superelevation_x

R

1.0

Superelevation factor for the horizontal (x) coordinate.

This parameter can be used to stretch the displayed domain along the x-direction. See also superelevation.

superelevation_y

R

1.0

Superelevation factor for the horizontal (y) coordinate.

This parameter can be used to stretch the displayed domain along the y-direction. See also superelevation.

threshold

R(10)

0.0

Threshold value for which an isosurface is to be created by the dvr software.

If the creation of isosurfaces is switched on via parameter mode_dvrp, then the respective threshold value for which the isosurface is to be created can be assigned via threshold. If several isosurfaces are given by mode_dvrp, then an individual threshold value for each isosurface can be assigned. The order of the threshold values refers to the order of the isosurfaces given by mode_dvrp.

topography_color

R(3)

0.8, 0.7, 0.6

Color of the topography.

The color is given in RGB (red/green/blue) portions. If topograpy is switched on (see topography), its default color is a kind of gray.