Home

Context Navigation

dvrpar

Timestamp:: Apr 6, 2016 3:49:00 PM (9 years ago)
Author:: scharf
Comment:: --

Legend:

: Unmodified
: Added
: Removed
: Modified

doc/app/dvrpar

-                      v108
+                      v109
 {{{#!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.\\\\
+This parameter can be used to reduce the number of polygons which form the topography isosurface. In case of large numerical grids (large number of grid points) 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!
+'''Warning:''' The allowed range of values is not checked. Wrong values may lead to unforeseen effects or even aborts!
 }}}
 |----------------
 …
 {{{#!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 [../parpar#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 [../d3par#dt_dopr dt_dopr]).  Is '''dt_dvrp''' < [../d3par#dt dt], then scenes are created and output after each time step (if this is requested it should be '''dt_dvrp''' = 0).
+Isosurfaces, cross sections and particles can be displayed simultaneously. The display of particles requires that the particle transport is switched on (see [../parpar#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). The 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 [../d3par#dt_dopr dt_dopr]).  Is '''dt_dvrp''' < [../d3par#dt dt], then scenes are created and output after each time step (if this is requested it should be '''dt_dvrp''' = 0).
 }}}
 |----------------
 …
 {{{#!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>'.''
+By default, the directory name is generated from the username (see package parameter [#dvrp_username dvrp_username]) and the base file name (given as the argument of '''mrun''' option -d) as '' '<username>/<base file name>'.''
 }}}
 |----------------
 …
 In case that particles are visualized with the '''dvr''' software (see [../dvr here] for a description), 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 [source:palm/trunk/SOURCE/user_init_particles.f90 user_init_particles] (at the beginning of the simulation) and/or to redefine it after each timestep in routine [source:palm/trunk/SOURCE/user_particle_attributes.f90 user_particle_attributes].\\
+Another way to control the particles diameter is to set it with the user-interface in routine [source:palm/trunk/SOURCE/user_init_particles.f90 user_init_particles] (at the beginning of the simulation) and/or to redefine it after each time step in routine [source:palm/trunk/SOURCE/user_particle_attributes.f90 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 [../parpar#radius radius]!
 }}}
 …
 }}}
 {{{#!td
 User name of a valid account on the computer to which data created by the '''dvr''' software is to be transferred.\\\\
+Username 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
 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.:
+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 [../d3par#data_output 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 [../d3par#data_output data_output]. The theshold value for which the isosurface is to be created can be defined with parameter [#threshold threshold]. The isosurface color is controlled by parameter [#isosurface_color isosurface_color].\\\\
+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 [../d3par#data_output 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 [../d3par#data_output data_output]. The threshold value for which the isosurface is to be created can be defined with parameter [#threshold threshold]. The isosurface color is controlled by parameter [#isosurface_color isosurface_color].\\\\
 The particles color and size can be set using parameters [#particle_color particle_color] and [#particle_dvrpsize particle_dvrpsize].\\\\
 The vertical extension of the displayed domain is given by [../d3par#nz_do3d nz_do3d].\\\\
 …
 }}}
 {{{#!td
 Parameter, which allows to bind the displayed particle color to certain flow quantities.\\\\
+Parameter, which allows to calculate the displayed particle color depending on certain flow quantities.\\\\
 By default, particles have a black color.\\\\
 Allowed values for '''particle_color''' are:
 …
 }}}
 }}}
 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 color_interval].\\\\
+The color table 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 color_interval].\\\\
 Example:\\
 If '''particle_color''' ='' 'pt*' ''and [#color_interval 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''.
 …
 }}}
 {{{#!td
 Parameter, which allows to bind the displayed particle size to certain flow quantities.\\\\
+Parameter, which allows calculates the displayed particle size depending on certain flow quantities.\\\\
 The default particle size (diameter) is determined with parameter [#dvrp_psize dvrp_psize].\\\\
 Allowed values for '''particle_dvrpsize''' are:
 …
 }}}
 }}}
 The particle sizes ranges from 0.25*[../inipar#dx dx] m to 0.85*[../inipar#dx dx] m. The interval of values from the above listed quantities to be mapped to these sizes is defined by parameter [#dvrpsize_interval dvrpsize_interval].\\\\
+The particle sizes range from 0.25*[../inipar#dx dx] m to 0.85*[../inipar#dx dx] m. The interval of values from the above-listed quantities to be mapped to these sizes is defined by parameter [#dvrpsize_interval dvrpsize_interval].\\\\
 Example:\\
 If '''particle_dvrpsize''' ='' 'absw' ''and [#dvrpsize_interval 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*[../inipar#dx dx] ''m and those at positions with |w| >= ''2.0'' m/s will have a size of ''0.85*[../inipar#dx dx] ''m, while those with ''1.0'' m/s < |w| < ''2.0'' m/s will linearly vary in size from ''0.25*[../inipar#dx dx] ''m to'' 0.85*[../inipar#dx dx] ''m.
 …
 {{{#!td
 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 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.\\\\
+In case that slicers have to be displayed (see [#mode_dvrp mode_dvrp]), this parameter defines the ranges of values of the respective quantities to which the color table in use has to be mapped. If e.g. a temperature slice shall be displayed, the color table defines colors from blue to red, and '''slicer_range_limits_dvrp''' = ''290.0, 305.0'' then areas with a 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 mode_dvrp] for the declaration of color charts.
 …
 {{{#!td
 Color of the topography.\\\\
 The color is given in RGB (red/green/blue) portions. If topograpy is switched on (see [../inipar#topography topography]), its default color is a kind of gray.
 }}}
+The color is given in RGB (red/green/blue) portions. If topography is switched on (see [../inipar#topography topography]), its default color is a kind of gray.
+}}}