Index: palm/trunk/DOC/app/chapter_3.2.html
===================================================================
--- palm/trunk/DOC/app/chapter_3.2.html	(revision 328)
+++ palm/trunk/DOC/app/chapter_3.2.html	(revision 336)
@@ -32,5 +32,5 @@
 <p style="line-height: 100%;">The following configuration
 data
-exclusively applies to model runs on the IBM Regatta hanni of the
+exclusively applies to model runs on the SGI ICE system of the
 HLRN when using several processing elements (i.e. for the parallel
 version of the model). The proper installation of the model is
@@ -38,13 +38,9 @@
 5.0</a>). Furthermore it is supposed that the user is located in
 the
-directory <tt><font style="font-size: 10pt;" size="2">$HOME/palm/current_version/SOURCE</font></tt>
-on its local computer. There are the FORTRAN source codes of the
-model (<tt><font style="font-size: 10pt;" size="2">*.f90</font></tt>)
-as
-well as the configuration file (name: <tt><font style="font-size: 10pt;" size="2">.mrun.config</font></tt>)
-and the make file (name: <tt><font style="font-size: 10pt;" size="2">Makefile</font></tt>).
+directory <tt><font style="font-size: 10pt;" size="2">$HOME/palm/current_version</font></tt>
+&nbsp;on its local computer, where the configuration file (<tt><font style="font-size: 10pt;" size="2">.mrun.config</font></tt>) should reside.
 The configuration file has the following contents (among other things):
 <br>&nbsp;
-</p><pre style="line-height: 100%;"><font style="font-size: 10pt;" size="2">% source_path <i>$HOME/palm/current_version/SOURCE</i></font><br><font style="font-size: 10pt;" size="2">% mainprog <i>palm.f90</i></font><br><font style="font-size: 10pt;" size="2">% use_makefile <i>true</i></font><br><font style="font-size: 10pt;" size="2">% fopts <i>-O3:-g:-qrealsize=8:-Q:-q64:-qmaxmem=-1:-qtune=pwr4:-qarch=pwr4:-qnosave:-qnoescape ibmh parallel<span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;"></span></i></font><br><font style="font-size: 10pt;" size="2">% lopts <span style="font-style: italic;">-O3:-g:-qrealsize=8:-Q:-q64:-qmaxmem=-1:-qtune=pwr4:-qarch=pwr4:-qnosave:-qnoescape:-lesslsmp ibmh parallel</span></font><br><font style="font-size: 10pt;" size="2">#</font><br><font style="font-size: 10pt;" size="2">EC:[[ \$locat = execution]] &amp; &amp; <i>cat </i>RUN_CONTROL </font><br><font style="font-size: 10pt;" size="2">#</font><br><a href="chapter_3.4.html#PARIN"><font style="font-size: 10pt;" size="2">PARIN</font></a><font style="font-size: 10pt;" size="2"> in:job:npe d3# ~/palm/current_version/JOBS/$fname/INPUT _p3d</font><br><font style="font-size: 10pt;" size="2">#</font><br><a href="chapter_3.4.html#RUN_CONTROL"><font style="font-size: 10pt;" size="2">RUN_CONTROL</font></a><font style="font-size: 10pt;" size="2"> out:loc:tr d3# ~/palm/current_version/JOBS/$fname/MONITORING _rc</font><br><a href="chapter_3.4.html#HEADER"><font style="font-size: 10pt;" size="2">HEADER</font></a><font style="font-size: 10pt;" size="2"> out:loc:tr d3# ~/palm/current_version/JOBS/$fname/MONITORING _header</font><br><a href="chapter_3.4.html#PLOT1D_PAR"><font style="font-size: 10pt;" size="2">PLOT1D_PAR</font></a><font style="font-size: 10pt;" size="2"> out:loc:tr pr# ~/palm/current_version/JOBS/$fname/OUTPUT _pr_par</font><br><a href="chapter_3.4.html#PLOT1D_DATA"><font style="font-size: 10pt;" size="2">PLOT1D_DATA</font></a><font style="font-size: 10pt;" size="2"> out:loc:tr pr# ~/palm/current_version/JOBS/$fname/OUTPUT _pr_in</font></pre>
+</p><pre style="line-height: 100%;"><font style="font-size: 10pt;" size="2">%mainprog          palm.f90<br>%base_directory    $HOME/palm/current_version<br>%base_data         ~/palm/current_version/JOBS<br>%source_path       $base_directory/trunk/SOURCE<br>#<br></font><font style="font-size: 10pt;" size="2">%fopts      -g:-w:-xT:-O3:-cpp:-r8:-ftz:-fno-alias:-no-prec-div:-no-prec-sqrt:-ip:-nbs:-convert:little_endian  lcsgih parallel<br></font><font style="font-size: 10pt;" size="2">%lopts      -g:-w:-xT:-O3:-cpp:-r8:-ftz:-fno-alias:-no-prec-div:-no-prec-sqrt:-ip:-nbs:-Vaxlib                 lcsgih parallel</font><font style="font-size: 10pt;" size="2"><br>#</font><br><font style="font-size: 10pt;" size="2">EC:[[ \$locat = execution]] &amp; &amp; <i>cat </i>RUN_CONTROL </font><br><font style="font-size: 10pt;" size="2">#</font><br><a href="chapter_3.4.html#PARIN"><font style="font-size: 10pt;" size="2">PARIN</font></a><font style="font-size: 10pt;" size="2"> in:job  d3#  $base_data/$fname/INPUT _p3d</font><br><font style="font-size: 10pt;" size="2">#</font><br><a href="chapter_3.4.html#RUN_CONTROL"><font style="font-size: 10pt;" size="2">RUN_CONTROL</font></a><font style="font-size: 10pt;" size="2"> out:loc:tr d3#   $base_data/$fname/MONITORING _rc</font><br><a href="chapter_3.4.html#HEADER"><font style="font-size: 10pt;" size="2">HEADER</font></a><font style="font-size: 10pt;" size="2">      out:loc:tr d3#   $base_data/$fname/MONITORING _header</font><span style="font-family: mon;"><span style="text-decoration: underline;"><br></span><a href="chapter_3.4.html#DATA_1D_PR_NETCDF">DATA_1D_PR_NETCDF</a></span><font style="font-size: 10pt;" size="2">   out:loc:tr pr# ~/palm/current_version/JOBS/$fname/OUTPUT _pr  nc</font></pre>
 <p style="line-height: 100%;"><font face="Thorndale, serif">The first
 five lines specify values of
@@ -56,15 +52,11 @@
 variable. Again separated by blank t<font face="Thorndale, serif">he
 so-called validity domain</font> can be indicated (later more).
-With the first three variables <b>mrun</b> gets to know in
+With the first four variables <b>mrun</b> gets to know in
 which
 directory the source code lies (</font><tt><i><font face="Thorndale, serif">source_path</font></i></tt><font face="Thorndale, serif">),
-the file name of the main program (</font><tt><i><font face="Thorndale, serif">mainprog</font></i></tt><font face="Thorndale, serif">)
-and that the <font face="Thorndale, serif">make mechanism
-should be
-used </font>for compiling (</font><tt><font face="Thorndale, serif"><i>use_makefile
-=</i> <i>true</i></font></tt><font face="Thorndale, serif">). <b>mrun
+the file name of the main program (</font><tt><i><font face="Thorndale, serif">mainprog</font></i></tt><font face="Thorndale, serif">)</font><font face="Thorndale, serif">. Also, two variables are defined which contain path informations used later in the file (<span style="font-style: italic;">base_directory</span>, <span style="font-style: italic;">base_data</span>).&nbsp; <b>mrun
 </b>needs these information, <font color="#000000">because
 for each
-model run the executable is created by compiling the source files.</font>
+model run the executable is created by compiling the respective source file.</font>
 Normally, only the main program (palm.f90) will be compiled while all
 other object files are just linked. These object files have already
@@ -84,21 +76,12 @@
 interpret these colons as blanks (2 colons written one behind the
 other will be interpreted as a colon). Thus in the example above</font> fopts
-has the value<tt><font face="Thorndale, serif"> </font></tt>&ldquo;<font style="font-size: 10pt; font-family: monospace;" size="2"><i>-O3
--g
--qrealsize=8 -Q -q64 -qmaxmem=-1 -qtune=pwr4 -qarch=pwr4 -qnosave
--qnoescape</i></font><tt><i><font face="Thorndale, serif"><font color="#000000">&rdquo;</font></font></i></tt><font face="Thorndale, serif"><font color="#000000">.
-Thus a PALM executable is generated using high level optimization (</font></font><font color="#000000"><span style="font-style: italic; font-family: monospace;">-O3</span></font><font face="Thorndale, serif"><font color="#000000">).</font></font><font color="#000000"><font face="Thorndale, serif">
+has the value<tt><font face="Thorndale, serif"> </font></tt>&ldquo;<tt>-g -w -xT -O3 -cpp -r8 -ftz -fno-alias -no-prec-div -no-prec-sqrt -ip -nbs -convert little_endian<i><font face="Thorndale, serif"><font color="#000000">&rdquo;</font></font></i></tt><font face="Thorndale, serif"><font color="#000000">.
+Thus a PALM executable is generated using high level optimization (</font></font><font color="#000000"><span style="font-family: monospace;">-O3</span></font><font face="Thorndale, serif"><font color="#000000">).</font></font><font color="#000000"><font face="Thorndale, serif">
 For all other options
-see the compiler manual on the IBM (</font><font size="2"><font face="Cumberland, monospace">man</font></font></font><tt><font color="#000000">
-<font size="2"><font face="Cumberland, monospace">f90</font></font></font></tt><font face="Thorndale, serif"><font color="#000000">).
+see the compiler manual on the SGI (</font><font size="2"><font face="Cumberland, monospace">man</font></font></font><tt><font color="#000000"> <span style="font-family: Cumberland,monospace;">ifort</span></font></tt><font face="Thorndale, serif"><font color="#000000">).
 Additional libraries
-which the compiler should use are described by
+which the compiler should use may have to be given by
 the environment variable </font></font><tt><font size="2"><font face="Cumberland, monospace"><font color="#000000">lopts</font></font></font></tt><font color="#000000">
-<font face="Thorndale, serif">(loader options).</font></font><font color="#800000">
-</font><font face="Thorndale, serif"><font color="#000000">Here you
-have to indicate a special IBM library (ESSL, </font></font>Engineering
-and Scientific Subroutine Library)<font face="Thorndale, serif"><font color="#000000">.</font><font color="#800000">
-</font>On the
-IBM-Regatta, all compiler options have also to be given to the linker.</font><font color="#000000"><font face="Thorndale, serif"> </font></font>
+<font face="Thorndale, serif">(loader options).</font></font><font color="#000000"><font face="Thorndale, serif"> </font></font>
 </p><p style="line-height: 100%;"><font color="#000000">Compiler and
 loader options usually differ from computer to computer. In the
@@ -111,10 +94,10 @@
 the so-called validity domain which follows in the appropriate
 variable lines after the value of variables.</font></font><font color="#000000">
-In the example above the entry &ldquo;</font><font color="#000000"><font style="font-size: 11pt; font-style: italic; font-family: monospace;" size="2">ibmh</font></font><tt><font color="#000000"><span style="font-style: italic; font-family: monospace;">
+In the example above the entry &ldquo;</font><font color="#000000"><font style="font-size: 11pt; font-style: italic; font-family: monospace;" size="2">lcsgih</font></font><tt><font color="#000000"><span style="font-style: italic; font-family: monospace;">
 </span></font><font color="#000000"><i><font style="font-size: 11pt;" size="2">parallel</font></i></font></tt><font color="#000000">&rdquo;
 stands for </font><tt><font style="font-size: 10pt;" size="2"><font color="#000000">fopts</font></font></tt><font color="#000000">
 and </font><tt><font style="font-size: 10pt;" size="2"><font color="#000000">lopts</font></font></tt><font color="#000000">.
 These lines only become active if a run on the parallel computer of
-the HLRN (</font><tt><i><font style="font-size: 10pt;" size="2">ibmh</font></i></tt><font color="#000000">)
+the HLRN (</font><tt><i><font style="font-size: 10pt;" size="2">lcsgih</font></i></tt><font color="#000000">)
 on several <font color="#000000">(</font><tt><i><font style="font-size: 10pt;" size="2"><font color="#000000">parallel</font></font></i></tt><font color="#000000">)
 </font>processors is started. The activation takes place when you
@@ -124,5 +107,5 @@
 (see below). This way, the validity domain can be limited also for all
 other environment-variables. If no validity domain
-is indicated then the given values of variables are valid on all
+is indicated then the given values of variables are valid for all
 computers. </font>
 </p><p style="line-height: 100%;">After the value
@@ -208,5 +191,5 @@
 indicated within the mrun <b>call</b> by the option <a href="http://www.muk.uni-hannover.de/institut/software/mrun_beschreibung.html#Opt-r">-r</a>.
 Thus a call of the form </p>
-<ul> <pre style="margin-bottom: 0.5cm; line-height: 100%;"><font style="font-size: 10pt;" size="2">mrun - h ibmh -d abcde -r d3</font></pre></ul>
+<ul> <pre style="margin-bottom: 0.5cm; line-height: 100%;"><font style="font-size: 10pt;" size="2">mrun - h lcsgih -d abcde -r "d3#"</font></pre></ul>
 <p style="line-height: 100%;">would lead to the fact that
 the input
@@ -217,5 +200,5 @@
 these files are to be copied of <b>mrun</b> then the call
 must be</p>
-<ul> <pre style="margin-bottom: 0.5cm; line-height: 100%;"><font style="font-size: 10pt;" size="2">mrun -h ibmh -d abcde -r "d3 pr"</font></pre></ul>
+<ul> <pre style="margin-bottom: 0.5cm; line-height: 100%;"><font style="font-size: 10pt;" size="2">mrun -h lcsgih -d abcde -r "d3# pr#"</font></pre></ul>
 <p style="line-height: 100%;">Instead of the option -r you
 can
@@ -225,5 +208,5 @@
 file all file connection statements are actually executed then
 the call must be: </p>
-<ul> <pre style="margin-bottom: 0.5cm; line-height: 100%;"><font style="font-size: 10pt;" size="2">mrun -h ibmh -d abcde -i d3 -o "d3 pr"</font></pre></ul>
+<ul> <pre style="margin-bottom: 0.5cm; line-height: 100%;"><font style="font-size: 10pt;" size="2">mrun -h lcsgih -d abcde -i "d3#" -o "d3# pr#"</font></pre></ul>
 <p style="line-height: 100%;"><font color="#000000">The
 names of the
@@ -258,5 +241,5 @@
 <p style="line-height: 100%;">The example configuration
 file also
-instructs <b>mrun</b> to copy four output files of the
+instructs <b>mrun</b> to copy three output files of the
 model to
 appropriate permanent files of the user at the end of the run.
@@ -266,7 +249,5 @@
 are located, as well as a file with data of horizontally averaged
 vertical profiles
-(<tt><a href="chapter_3.4.html#PLOT1D_DATA">PLOT1D_DATA</a></tt>)
-and an associated parameter file (<tt><a href="chapter_3.4.html#PLOT1D_PAR">PLOT1D_PAR</a></tt>),
-which can be used as input files for the plot program <a href="http://www.muk.uni-hannover.de/institut/software/profil_beschreibung.html">profil</a>.
+(<tt><a href="chapter_3.4.html#DATA_1D_PR_NETCDF">DATA_1D_PR_NETCDF</a></tt>).
 A model run does not presuppose neither the file connection statements
 for
@@ -283,7 +264,7 @@
 execution of a
 model run
-on several processors on the IBM Regatta "hanni" of the HLRN must be
+on several processors on the SGI ICE of the HLRN must be
 supplemented by the following options in each case: </p>
-<ul> <pre style="margin-bottom: 0.5cm; line-height: 100%;"><font style="font-size: 10pt;" size="2">mrun - K parallel -X &hellip; -t &hellip; -m &hellip;</font></pre></ul>
+<ul style="font-family: monospace;"> <pre style="margin-bottom: 0.5cm; line-height: 100%;"><font style="font-size: 10pt;" size="2">mrun - K parallel -X ... -T ... -t ... -m ---</font></pre></ul>
 <p style="line-height: 100%;">Only the indication of <tt><font style="font-size: 11pt;" size="2">-K
 parallel</font></tt> causes the parallel execution of the
@@ -294,20 +275,17 @@
 option <tt><font style="font-size: 10pt;" size="2">-X</font>
 </tt><font size="2">(</font><font style="font-size: 10pt;" size="2">e.g.
-</font><tt><font style="font-size: 10pt;" size="2">-X
-4</font></tt><font size="2">).</font>
+</font><tt><font style="font-size: 10pt;" size="2">-X 32</font></tt><font size="2">) and the number of tasks (processors) on onde node have to be given by option -T.</font>
 In each case the permitted CPU time in seconds and the required memory
 size in MB must be indicated by the options <tt><font style="font-size: 11pt;" size="2">-t</font></tt>
 and <tt><font style="font-size: 11pt;" size="2">-m</font></tt>,
 respectively<font face="Thorndale, serif">.</font>
-Alternatively, these can be set by the appropriate environment
+Alternatively, memory and cpu-time demands can be set by the appropriate environment
 variables in the configuration file: </p>
-<blockquote style="line-height: 100%;"><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace">%
-memory&nbsp; <i>1630</i> ibmh parallel</font></font></tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"><br> </font></font><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace">%
-cputime <i>1000</i> ibmh parallel</font></font></tt></blockquote>
+<blockquote style="line-height: 100%;"><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace">%memory&nbsp; <i>1500</i> lcsgih parallel</font></font></tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace"><br> </font></font><tt><font style="font-size: 10pt;" size="2"><font face="Cumberland, monospace">%cputime <i>1000</i> lcsgih parallel</font></font></tt></blockquote>
 <p style="line-height: 100%;">The values indicated there
 can be
 overridden with the values of the options <tt><font style="font-size: 10pt;" size="2">-t</font></tt>
 and/or <tt><font style="font-size: 10pt;" size="2">-m</font></tt>,
-respectivly. </p>
+respectivly.</p><p style="line-height: 100%;"><span style="font-weight: bold;">Warning: When changing the coniguration file, please never use the TAB key!</span> </p>
 <hr><p style="line-height: 100%;"><br>
 <font color="#000080"><font color="#000080"><a href="chapter_3.1.html"><font color="#000080"><img src="left.gif" name="Grafik1" align="bottom" border="2" height="32" width="32"></font></a><a href="index.html"><font color="#000080"><img src="up.gif" name="Grafik2" align="bottom" border="2" height="32" width="32"></font></a><a href="chapter_3.3.html"><font color="#000080"><img src="right.gif" name="Grafik3" align="bottom" border="2" height="32" width="32"></font></a></font></font></p><p style="line-height: 100%;"><i>Last change:&nbsp;</i>
Index: palm/trunk/DOC/app/chapter_4.2.html
===================================================================
--- palm/trunk/DOC/app/chapter_4.2.html	(revision 328)
+++ palm/trunk/DOC/app/chapter_4.2.html	(revision 336)
@@ -10663,5 +10663,8 @@
 
 
- <tr>
+ <tr><td style="vertical-align: top;"><a name="groundplate_color"></a><span style="font-weight: bold;">groundplate_color</span></td><td style="vertical-align: top;">R(3)</td><td style="vertical-align: top;"><span style="font-style: italic;">0.0, 0.6, 0.0</span></td><td style="vertical-align: top;">Color of the ground plate.<br><br>The color is given in RGB (red/green/blue) portions. The default color of the ground plate is green.</td></tr><tr><td style="vertical-align: top;"><span style="font-weight: bold;"><a name="isosurface_color"></a>isosurface_color</span></td><td style="vertical-align: top;">R(3,10)</td><td style="vertical-align: top;"><span style="font-style: italic;">0.9, 0.9, 0.9</span><br style="font-style: italic;"><span style="font-style: italic;">0.8, 0.1, 0.1</span><br style="font-style: italic;"><span style="font-style: italic;">0.1, 0.1, 0.8<br>0.1, 0.8, 0.1<br>0.6, 0.1, 0.1<br>0.1, 0.1, 0.6<br>0.1, 0.6, 0.1<br>0.4, 0.1, 0.1<br>0.1, 0.1, 0.4<br>0.1, 0.4, 0.1</span></td><td style="vertical-align: top;">Color of the isosurface(s).<br><br>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.</td></tr><tr>
 
 
@@ -10742,5 +10745,5 @@
 cross sections see <a href="#data_output">data_output</a>.
 The theshold value for which the isosurface is
-to be created can be defined with parameter <a href="#threshold">threshold</a>.<br>
+to be created can be defined with parameter <a href="#threshold">threshold</a>. The isosurface color is controlled by parameter <a href="#isosurface_color">isosurface_color</a>.<br>
 
 
@@ -10782,16 +10785,10 @@
 
 
-The declaration color charts to be
+The declaration of color charts to be
 used still have to be given "manually" in subroutine <a href="chapter_3.4.html#user_dvrp_coltab"><span style="font-family: monospace;">user_dvrp_coltab</span></a>
-(file <tt><font style="font-size: 11pt;" size="2">user_interface.f90</font></tt>).&nbsp;
-      <br>
-
-
-A change of particle colors and/or particle diameters (e.g.
-according
-to the local characteristics of the flow field) to be used for the
-visualization, must be carried out by adding respective code extensions
-to <a href="chapter_3.4.html#user_particle_attributes"><tt><font style="font-size: 11pt;" size="2">user_particle_attributes</font></tt></a>
-(in file <tt><font style="font-size: 11pt;" size="2">user_interface.f90</font></tt>).&nbsp;</td>
+(file <tt><font style="font-size: 11pt;" size="2">user_dvrp_coltab.f90</font></tt>).&nbsp;
+
+
+</td>
 
 
@@ -11067,5 +11064,5 @@
 
 
- </tr>
+ </tr><tr><td style="vertical-align: top;"><span style="font-weight: bold;"><a name="topography_color"></a>topography_color</span></td><td style="vertical-align: top;">R(3)</td><td style="vertical-align: top;"><span style="font-style: italic;">0.8, 0.7, 0.6</span></td><td style="vertical-align: top;">Color of the topography.<br><br>The color is given in RGB (red/green/blue) portions. If topograpy is switched on (see <a href="chapter_4.1.html#topography">topography</a>), its default color is a kind of gray.</td></tr>
 
 
Index: palm/trunk/DOC/app/chapter_4.5.7.html
===================================================================
--- palm/trunk/DOC/app/chapter_4.5.7.html	(revision 328)
+++ palm/trunk/DOC/app/chapter_4.5.7.html	(revision 336)
@@ -1,26 +1,25 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html><head>
-<meta http-equiv="CONTENT-TYPE" content="text/html; charset=windows-1252"><title>PALM
-chapter 4.5.7</title> <meta name="GENERATOR" content="StarOffice 7 (Win32)"> <meta name="AUTHOR" content="Siegfried Raasch"> <meta name="CREATED" content="20041029;14344622"> <meta name="CHANGED" content="20050119;9531085"> <meta name="KEYWORDS" content="parallel LES model"> <style>
+<meta http-equiv="CONTENT-TYPE" content="text/html; charset=windows-1252"><title>PALM chapter 4.5.7</title> <meta name="GENERATOR" content="StarOffice 7 (Win32)"> <meta name="AUTHOR" content="Siegfried Raasch"> <meta name="CREATED" content="20041029;14344622"> <meta name="CHANGED" content="20050119;9531085"> <meta name="KEYWORDS" content="parallel LES model"> <style>
 <!--
 @page { size: 21cm 29.7cm }
 -->
 </style></head>
-
 <body style="direction: ltr;" lang="en-US"><h4 style="line-height: 100%;"><font size="4">4.5.7
 Plots of
 isosurfaces, 2d cross sections and particles with dvrp</font></h4>
-<p style="line-height: 100%;">The <span style="font-weight: bold;">dvrp</span>
-software developed by the RRZN
-(Stephan Olbrich, Carsten Chmielewski) allows a creation of plot
-sequences with PALM,
-which can be animated via a special plugin for internet browsers. With
-suitable graphic hardware even stereoscopic views are
-possible. <br>
+<p style="line-height: 100%;"><span style="font-weight: bold;">Preliminary note:</span></p><p style="line-height: 100%;">Usage of the <span style="font-weight: bold;">dvrp</span>-software requires installation of additional software components (dvrp-library, streaming-server, browser-plugin) which are <span style="font-weight: bold;">not</span>
+part of the PALM distribution. Currently (May 2009), this software is
+only available on the the HLRN/IMUK system and partly on RIAM's NEC
+system. If you are interested in using <span style="font-weight: bold;">dvrp</span> on your system, please contact the PALM developers.</p><br><span style="font-weight: bold;">General remarks:</span><p style="line-height: 100%;">The <span style="font-weight: bold;">dvrp</span>
+software was originally developed by the RRZN
+(Stephan Olbrich, Carsten Chmielewski) and is meanwhile continuosly developed and improved under the name <span style="font-weight: bold;">dsvr</span> by the University of D&uuml;sseldorf (Prof. Stephan Olbrich, see webpage of the <a href="http://www.dsvr-software.de/">dsvr-software</a>). It allows to create 3d-animations with PALM,
+which can be displayed via a special plugin for internet browsers. With
+suitable graphic hardware (e.g. NVIDIA quattro FX cards) even stereoscopic views are
+possible.</p><p style="line-height: 100%;">
 In contrast to the other kinds of visualization output realized
-in PALM (<b>profil</b>, <b>iso2d</b> and <b>AVS</b>),
+in PALM (1d-, 2d-, 3d-NetCDF output),
 where the data
-is output in a format suitable for the plot software, the creation of
-plots via <span style="font-weight: bold;">dvrp</span>
+is output in a format suitable for many kinds of post-processing graphic software, the creation of animations via <span style="font-weight: bold;">dvrp</span>
 software is
 integrated in PALM, i.e. respective routines are directly called within
@@ -46,18 +45,18 @@
 the main focus of the BMBF project "Application of
 tele-immersion in long-distance networks" (2001-2002),
-which was a joint project of RRZN, ZIB and IMUK. This work is currently
-continued by RRZN in the new DFG-funded project "EVITA - Untersuchung
+which was a joint project of RRZN, ZIB and IMUK. This work was
+continued by RRZN in the DFG-funded project "<a href="http://www.rrzn.uni-hannover.de/evita.html">EVITA</a> - Untersuchung
 effizienter
-<br>Methoden zur visuellen und haptischen tele-immersiven
+Methoden zur visuellen und haptischen tele-immersiven
 Exploration
-<br>komplexer Volumen- und Str&ouml;mungsdaten aus
+komplexer Volumen- und Str&ouml;mungsdaten aus
 parallelisierten,
-<br>dynamischen 3D-Simulationen" (2005-2007). </p>
-<p style="line-height: 100%;">The calls of the <span style="font-weight: bold;">dvrp</span> routines are
+dynamischen 3D-Simulationen" (2005-2007). </p>
+<p style="line-height: 100%;"></p><p style="line-height: 100%;"><span style="font-weight: bold;">Using dvrp with PALM:</span></p><p style="line-height: 100%;">The calls of the <span style="font-weight: bold;">dvrp</span> routines are
 contained within a
 PALM software package (see chapter <a href="chapter_3.7.html">3.7</a>).
-To use this package, the additional option <tt><font size="2">-p
-&ldquo;dvrp_graphics&rdquo;</font></tt>
-has to be given in the <b>mrun</b> call. This
+To use this package, the additional option<tt style="font-family: monospace;"> </tt><font style="font-family: Courier New,Courier,monospace;" size="2">-p
+<span style="font-family: Helvetica,Arial,sans-serif;">&ldquo;</span>dvrp_graphics<span style="font-family: Helvetica,Arial,sans-serif;">&rdquo;</span></font><span style="font-family: monospace;">
+</span>has to be given in the <b>mrun</b> call. This
 automatically links the
 required libraries.
@@ -67,22 +66,23 @@
 graphic
 data are not output to local files but directly to a special remote
-computer which is defined via the package parameter <a href="chapter_4.2.html#dvrp_host">dvrp_host</a>.
-The
-default values of the dvrp parameters are cause the output to be
-directed to a so-called streaming server at the
+computer which is defined via the package parameter <a href="chapter_4.2.html#dvrp_host">dvrp_host</a>. If the default values of the dvrp parameters are used, data are send to a so-called <span style="font-style: italic;">streaming server</span> at the
 RRZN. Apart from graphic data an additional html file is created, which
-can be used by an internet browser to view the data (a special <span style="font-weight: bold;">dvrp</span> plugin is
-needed). </p>
-<p style="line-height: 100%;">Since July 2001, the basic
-functionality
-of the <span style="font-weight: bold;">dvrp</span>
-software is
-installed in PALM and steerable via the
-package parameters. However, some code modifications may still need to
-be done by the user (e.g. in
-the subroutine <tt><font style="font-size: 10pt;" size="2">plot_dvrp</font></tt>
-in order to define suitable color tables).
-<br>For further detailed information please ask Siegfried Raasch.
-</p>
+can be opened by an internet browser to view the data (a special <span style="font-weight: bold;">dvrp</span> plugin is required for this).</p><p style="line-height: 100%;"></p><p style="line-height: 100%;"><span style="font-weight: bold;">Quickstart guide for using dvrp on the HLRN/IMUK-System (May 2009):</span> </p>
+<ol><li>
+Add the following define statements for environment variables to the configuration file (<span style="font-family: Courier New,Courier,monospace;">.mrun.config</span>):<br><br><span style="font-family: Courier New,Courier,monospace;"></span><span style="font-family: Courier New,Courier,monospace;"> &nbsp; &nbsp;%dvr_inc&nbsp;&nbsp;
+-I/home/h/niksiraa/dvr_mvapich2/lib&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; lcsgih parallel</span><br style="font-family: Courier New,Courier,monospace;"><span style="font-family: Courier New,Courier,monospace;">&nbsp; &nbsp;%dvr_lib&nbsp;&nbsp;&nbsp;-L/home/h/niksiraa/dvr_mvapich2/lib:-lDVRP2:-lftp&nbsp; &nbsp; lcsgih
+parallel</span><br><br><br></li><li>Add the dvrp-steering parameters to your NAMELIST-parameter file, e.g.<br><br><span style="font-family: Courier New,Courier,monospace;">&nbsp;&amp;d3par &nbsp;end_time = 3600.0,<br>&nbsp; ... &nbsp; &nbsp; /<br><br>&nbsp;&amp;dvrp_graphics_par &nbsp; dvrp_username = '&lt;replace by your IMUK username&gt;',<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; dvrp_host = '130.75.105.2',<br>&nbsp;
+&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+dvrp_directory = '&lt;replace by a name of your choice&gt;', ... /<br></span><br>For other dvrp-parameters see <a href="chapter_4.2.html#Paketparameter">chapter 4.2</a>. An example parameter file can be found in directory <span style="font-family: Courier New,Courier,monospace;">..../trunk/EXAMPLES/dvr_building</span>.<span style="font-family: Courier New,Courier,monospace;"><br><br></span></li><li>Submit the job&nbsp; with <span style="font-weight: bold;">mrun</span>-command<br><br><span style="font-family: Courier New,Courier,monospace;">&nbsp; &nbsp;mrun .... -p dvrp_graphics ....</span><br><br></li><li><span style="font-family: Courier New,Courier,monospace;"><span style="font-family: Times New Roman,Times,serif;">After the job has finished, the dvrp-output can be found on the IMUK-cluster in a subdirectory under <span style="font-family: Courier New,Courier,monospace;">/data/raasch/Dvrp_daten</span>. The name of the subdirectory is determined by the dvrp-parameter <a href="chapter_4.2.html#dvrp_directory">dvrp_directory</a> (see above), i.e. if the user has set <span style="font-family: Courier New,Courier,monospace;">dvrp_directory</span> = <span style="font-style: italic;">'movie_1'</span>, the dvrp-data are stored under&nbsp;<span style="font-family: Courier New,Courier,monospace;">/data/raasch/Dvrp_daten/movie_1</span>.<br><br></span></span></li><li><span style="font-family: Courier New,Courier,monospace;"><span style="font-family: Times New Roman,Times,serif;">Change to this subdirectory (e.g. </span></span><span style="font-family: Courier New,Courier,monospace;"><span style="font-family: Times New Roman,Times,serif;"><span style="font-family: Courier New,Courier,monospace;">/data/raasch/Dvrp_daten/movie_1</span></span></span><span style="font-family: Courier New,Courier,monospace;"><span style="font-family: Times New Roman,Times,serif;">) and enter the command<br><br><span style="font-family: Courier New,Courier,monospace;">&nbsp; &nbsp;process_dvr_output</span><br><br>It will create a file with name <span style="font-family: Courier New,Courier,monospace;">all_streams_streaming.html</span>.<br><br></span></span></li><li><span style="font-family: Courier New,Courier,monospace;"><span style="font-family: Times New Roman,Times,serif;">Call the opera-browser (i.e. enter the command <span style="font-family: Courier New,Courier,monospace;">opera</span>) and open the file </span></span><span style="font-family: Courier New,Courier,monospace;"><span style="font-family: Times New Roman,Times,serif;"><span style="font-family: Courier New,Courier,monospace;">all_streams_streaming.html</span>.</span></span><span style="font-family: Courier New,Courier,monospace;"><span style="font-family: Times New Roman,Times,serif;"></span><br><br></span>A complete example parameter file for ... can be found under &nbsp;.../trunk/.....<br></li></ol><span style="font-weight: bold;">Further features:<br></span>The script<span style="font-family: Courier New,Courier,monospace;"> process_dvr_output </span>has additional options:<br><br><span style="font-weight: bold; font-family: Courier New,Courier,monospace;">-s</span> &nbsp; &nbsp; : <span style="font-weight: bold;">create sequence output</span>.
+All streams (and static scenes) are collected to one sequence (one
+static scene), which can be displayed with a browser without using the
+streaming server (the so-called sequence mode). This allows e.g. to
+show animations on a notebook without beeing connected to the internet.
+When the script is called with this option, the sequence is generated
+in subdirectory sequence_data. Copy this subdirectory and the file
+all_streams_sequence.html to a directory on your local computer and
+open the file all_streams_sequence.html with your browser. For this,
+you will need to install the the dvr-plugin (see webpage of the <a href="http://www.dsvr-software.de/">dsvr-software</a>) on your local computer, which is also available for Windows.<br><br><span style="font-weight: bold;">-a</span> &nbsp; &nbsp; &nbsp;: <span style="font-weight: bold;">acceleration factor</span>. If, in case of sequence mode, the performance of the animation is to slow, you can accelerate it. E.g., by using <span style="font-family: Courier New,Courier,monospace;">"-a 2</span>", only every second frame of the original streams will be used for the sequence.<br><br><br><br><br><span style="font-weight: bold;">Current limitations (May 09):</span><br>Only a special opera-version on host "bora" can be used. Log-in on "bora" and call &nbsp;<span style="font-family: Courier New,Courier,monospace;">/usr/local/bin/opera</span>. <span style="font-weight: bold;">Before that(!!!)</span>, enter the command "<span style="font-family: Courier New,Courier,monospace;">export LD_PRELOAD=libXm.so</span>" !
 <hr><p style="line-height: 100%;"><br>
 <font color="#000080"><font color="#000080"><a href="chapter_4.5.6.html"><font color="#000080"><img src="left.gif" name="Grafik1" align="bottom" border="2" height="32" width="32"></font></a><a href="index.html"><font color="#000080"><img src="up.gif" name="Grafik2" align="bottom" border="2" height="32" width="32"></font></a><a href="chapter_4.6.html"><font color="#000080"><img src="right.gif" name="Grafik3" align="bottom" border="2" height="32" width="32"></font></a></font></font></p><p style="line-height: 100%;">&nbsp;<i>Last
Index: palm/trunk/DOC/app/chapter_4.6.html
===================================================================
--- palm/trunk/DOC/app/chapter_4.6.html	(revision 328)
+++ palm/trunk/DOC/app/chapter_4.6.html	(revision 336)
@@ -6379,5 +6379,5 @@
 
 
-    <tr>
+    <tr><td align="undefined" valign="undefined"><a href="chapter_4.2.html#groundplate_color"><span style="font-weight: bold;">groundplate_color</span></a></td><td align="undefined" valign="undefined">P</td><td align="undefined" valign="undefined">R(3)</td><td align="undefined" valign="undefined"><span style="font-style: italic;">0.0, 0.6, 0.0</span></td><td align="undefined" valign="undefined">Color of the ground plate</td></tr><tr>
 
 
@@ -6634,5 +6634,5 @@
 
 
-    <tr>
+    <tr><td align="undefined" valign="undefined"><a href="chapter_4.2.html#isosurface_color"><span style="font-weight: bold;">isosurface_color</span></a></td><td align="undefined" valign="undefined">P</td><td align="undefined" valign="undefined">R(3,10)</td><td align="undefined" valign="undefined"><span style="font-style: italic;">0.9, 0.9, 0.9</span><br style="font-style: italic;"><span style="font-style: italic;">0.8, 0.1, 0.1</span><br style="font-style: italic;"><span style="font-style: italic;">......</span></td><td align="undefined" valign="undefined">Color of the isosurface(s).</td></tr><tr>
 
 
@@ -13789,5 +13789,5 @@
 
 
- <tr><td style="vertical-align: top;"><a style="font-weight: bold;" href="chapter_4.1.html#topography_grid_convention">topography_grid_convention</a></td><td style="vertical-align: top;">I</td><td style="vertical-align: top;">C * 11</td><td><span style="font-style: italic;">default depends on value of <a href="chapter_4.1.html#topography">topography</a>; see text for details</span><span style="font-style: italic;"></span></td><td style="vertical-align: top;">Convention for defining the&nbsp;topography grid.</td></tr><tr>
+ <tr><td align="undefined" valign="undefined"><a href="chapter_4.2.html#topography_color"><span style="font-weight: bold;">topography_color</span></a></td><td align="undefined" valign="undefined">P</td><td align="undefined" valign="undefined">R(3)</td><td align="undefined" valign="undefined"><span style="font-style: italic;">0.8, 0.7, 0.6</span></td><td align="undefined" valign="undefined">Color of the topography.</td></tr><tr><td style="vertical-align: top;"><a style="font-weight: bold;" href="chapter_4.1.html#topography_grid_convention">topography_grid_convention</a></td><td style="vertical-align: top;">I</td><td style="vertical-align: top;">C * 11</td><td><span style="font-style: italic;">default depends on value of <a href="chapter_4.1.html#topography">topography</a>; see text for details</span><span style="font-style: italic;"></span></td><td style="vertical-align: top;">Convention for defining the&nbsp;topography grid.</td></tr><tr>
 
 
Index: palm/trunk/DOC/app/chapter_5.0.html
===================================================================
--- palm/trunk/DOC/app/chapter_5.0.html	(revision 328)
+++ palm/trunk/DOC/app/chapter_5.0.html	(revision 336)
@@ -1,6 +1,5 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html><head>
-<meta http-equiv="CONTENT-TYPE" content="text/html; charset=windows-1252"><title>PALM
-chapter 5.0</title> <meta name="GENERATOR" content="StarOffice 7 (Win32)"> <meta name="AUTHOR" content="Siegfried Raasch"> <meta name="CREATED" content="20041103;12380720"> <meta name="CHANGED" content="20041123;15532356"> <meta name="KEYWORDS" content="parallel LES model"> <style>
+<meta http-equiv="CONTENT-TYPE" content="text/html; charset=windows-1252"><title>PALM chapter 5.0</title> <meta name="GENERATOR" content="StarOffice 7 (Win32)"> <meta name="AUTHOR" content="Siegfried Raasch"> <meta name="CREATED" content="20041103;12380720"> <meta name="CHANGED" content="20041123;15532356"> <meta name="KEYWORDS" content="parallel LES model"> <style>
 <!--
 @page { size: 21cm 29.7cm }
@@ -170,5 +169,7 @@
 identifier&gt;</span>.
 You only have to uncomment lines for those hosts on which you intend to
-use PALM.</font></p><p style="line-height: 100%;"><font color="#000000">Beside the default configuration file</font><font style="font-family: Courier New,Courier,monospace;" color="#000000"> .mrun.config.default</font><font color="#000000">, the directory<span style="font-family: Courier New,Courier,monospace;">
+use PALM.</font></p><p style="line-height: 100%;"><font color="#000000"><span style="font-weight: bold;">Warning:
+When editing the configuration file, please NEVER use the TAB key.
+Otherwise, very confusing errors in mrun execution may occur.</span></font></p><p style="line-height: 100%;"><font color="#000000">Beside the default configuration file</font><font style="font-family: Courier New,Courier,monospace;" color="#000000"> .mrun.config.default</font><font color="#000000">, the directory<span style="font-family: Courier New,Courier,monospace;">
 trunk/SCRIPTS </span>contains additional configuration files
 which are already adjusted for special hosts:<span style="font-family: Courier New,Courier,monospace;">
