== dvr parameters ==


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


||='''Parameter Name'''  =||='''FORTRAN Type'''  =||='''Default Value'''  =||='''Explanation'''  =||
|----------------
{{{#!td style="vertical-align:top;width:150px"
[=#clip_dvrp_l '''clip_dvrp_l''']
}}}
{{{#!td style="vertical-align:top;width:50px"
R
}}}
{{{#!td style="vertical-align:top;width:100px"
0.0
}}}
{{{#!td
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.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#clip_dvrp_n '''clip_dvrp_n''']
}}}
{{{#!td style="vertical-align:top"
R
}}}
{{{#!td style="vertical-align:top"
([../inipar#ny ny]+1)*[../inipar#dy dy]
}}}
{{{#!td
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.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#clip_dvrp_r '''clip_dvrp_r''']
}}}
{{{#!td style="vertical-align:top"
R
}}}
{{{#!td style="vertical-align:top"
([#nx nx]+1)*[#dx dx]
}}}
{{{#!td
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.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#clip_dvrp_s '''clip_dvrp_s''']
}}}
{{{#!td style="vertical-align:top"
R
}}}
{{{#!td style="vertical-align:top"
0.0
}}}
{{{#!td
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.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#cluster_size '''cluster_size''']
}}}
{{{#!td style="vertical-align:top"
I
}}}
{{{#!td style="vertical-align:top"
}}}
{{{#!td
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!
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#color_interval '''color_interval''']
}}}
{{{#!td style="vertical-align:top"
R(2)
}}}
{{{#!td style="vertical-align:top"
0.0, 1.0
}}}
{{{#!td
Interval of values used for determining the particle color displayed in the animation.\\\\
See [#particle_color particle_color] for further explanation.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#dt_dvrp '''dt_dvrp''']
}}}
{{{#!td style="vertical-align:top"
R
}}}
{{{#!td style="vertical-align:top"
9999999.9
}}}
{{{#!td
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 dt_prel]). Objects to be displayed have to be determined with [#mode_dvrp mode_dvrp].\\\\
If output of scenes created by '''dvr''' software is switched on (see [#mode_dvrp 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 dt_dopr]).  Is '''dt_dvrp''' < [#dt dt], then scenes are created and output after each time step (if this is requested it should be '''dt_dvrp''' = 0). 
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#dvrpsize_interval '''dvrpsize_interval''']
}}}
{{{#!td style="vertical-align:top"
R(2)
}}}
{{{#!td style="vertical-align:top"
0.0, 1.0
}}}
{{{#!td
Interval of values used for determining the particle size displayed in the animation.\\\\
See [#particle_dvrpsize particle_dvrpsize] for further explanation.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#dvrp_directory '''dvrp_directory''']
}}}
{{{#!td style="vertical-align:top"
C*80
}}}
{{{#!td style="vertical-align:top"
'default'
}}}
{{{#!td
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 dvrp_username]) and the base file name (given as the argument of '''mrun''' option -d) as '' '<user name>/<base file name>'.''
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#dvrp_file '''dvrp_file''']
}}}
{{{#!td style="vertical-align:top"
C*80
}}}
{{{#!td style="vertical-align:top"
'default'
}}}
{{{#!td
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 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.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#dvrp_host '''dvrp_host''']
}}}
{{{#!td style="vertical-align:top"
C*80
}}}
{{{#!td style="vertical-align:top"
'origin.rvs.uni-hannover.de'
}}}
{{{#!td
Name of the computer to which data created by the '''dvr''' software shall be transferred. \\\\
In case of [#dvrp_output dvrp_output] = '' 'rtsp' '' only the default value is allowed (streaming server of the RRZN). For [#dvrp_output dvrp_output] = '' 'local' '' the assigned value is ignored.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#dvrp_output '''dvrp_output''']
}}}
{{{#!td style="vertical-align:top"
C*10
}}}
{{{#!td style="vertical-align:top"
'rtsp'
}}}
{{{#!td
Output mode for the '''dvr''' software.\\\\
The following settings are allowed:\\
{{{#!table style="border:none"
{{{#!td style="vertical-align:top;border:none"
'' 'rtsp' ''
}}}
{{{#!td style="vertical-align:top;border:none"
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 dvrp_host] and [#dvrp_directory dvrp_directory].
}}}
|------
{{{#!td style="vertical-align:top;border:none"
'' 'ftp' ''
}}}
{{{#!td style="vertical-align:top;border:none"
Data created by the '''dvr''' software is transferred to the destination host (see [#dvrp_host dvrp_host] and [#dvrp_directory dvrp_directory]) using ftp.\\
}}}
|------
{{{#!td style="vertical-align:top;border:none"
'' 'local' ''
}}}
{{{#!td style="vertical-align:top;border:none"
Data created by the '''dvr''' software is output locally on a file defined by [#dvrp_file dvrp_file].
}}}
}}}
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#dvrp_password '''dvrp_password''']
}}}
{{{#!td style="vertical-align:top"
C*80
}}}
{{{#!td style="vertical-align:top"
'!**!**!**!**'
}}}
{{{#!td
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 dvrp_output] = '' 'ftp'.'' For [#dvrp_output dvrp_output] = '' 'rtsp' '' the default value must not be changed!
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#dvrp_psize '''dvrp_psize''']
}}}
{{{#!td style="vertical-align:top"
R
}}}
{{{#!td style="vertical-align:top"
0.2 * [#dx dx]
}}}
{{{#!td
Diameter that particles are given in visualizations with the '''dvr''' software (in m).\\
In case that particles are visualized with the '''dvr''' software (see [wiki:chapter_457 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 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 radius]!
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#dvrp_username '''dvrp_username''']
}}}
{{{#!td style="vertical-align:top"
C*80
}}}
{{{#!td style="vertical-align:top"
}}}
{{{#!td
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 dvrp_output] = '' 'rtsp' '' or '' 'ftp'.''
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#groundplate_color '''groundplate_color''']
}}}
{{{#!td style="vertical-align:top"
R(3)
}}}
{{{#!td style="vertical-align:top"
0.0, 0.6, 0.0
}}}
{{{#!td
Color of the ground plate.\\\\
The color is given in RGB (red/green/blue) portions. The default color of the ground plate is green.
}}}
|----------------