source: palm/trunk/DOC/app/chapter_4.5.4.html @ 1411

Last change on this file since 1411 was 62, checked in by raasch, 18 years ago

Id string added to all html files

  • Property svn:keywords set to Id
File size: 10.1 KB
RevLine 
[5]1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
[62]2<html><head>
3<meta http-equiv="CONTENT-TYPE" content="text/html; charset=windows-1252"><title>PALM
4chapter 4.5.4</title> <meta name="GENERATOR" content="StarOffice 7 (Win32)"> <meta name="AUTHOR" content="Siegfried Raasch"> <meta name="CREATED" content="20041027;10130843"> <meta name="CHANGED" content="20041117;11420847"> <meta name="KEYWORDS" content="parallel LES model"> <style>
5<!--
6@page { size: 21cm 29.7cm }
7-->
8</style></head>
9
10<body style="direction: ltr;" lang="en-US"><h4 style="line-height: 100%;"><font size="4">4.5.4
11Plots of 2d cross
[5]12sections with iso2d</font></h4>
[62]13<p style="line-height: 100%;">PALM permits simultaneous
14output xy, xz
[5]15and&nbsp;
16yz cross sections. Since the output of all three cross section plots is
17steered in the same way, only the creation of xy plots is described.</p>
18<p style="line-height: 100%;">Output of xy cross
19sections requires to set at least two parameters: first, the temporal
[62]20interval of the output time (run parameter <a href="chapter_4.2.html#dt_do2d_xy"><u>dt_do2d_xy)</u></a><span style="text-decoration: none;">
[5]21and second<span style="text-decoration: none;"></span>
[62]22the names of the quantities for which cross section output is wanted</span><span style="text-decoration: none;"><span style="text-decoration: none;"> (<a href="chapter_4.2.html#data_output">data_output</a></span></span>).
[5]23The string <span style="font-style: italic;">'_xy'</span>
24must be appended to these name strings in either case. Output times
25cannot be defined
26directly but only via the output time interval, starting from the
27beginning of the initial 3d run (t=0, but no cross sections are
[62]28written at the time t=0; exceptions see <a href="chapter_4.2.html#do2d_at_begin">do2d_at_begin</a>).
[5]29The exact location (height level) of the cross
[62]30section(s) can be defined with run parameter <a href="chapter_4.2.html#section_xy">section_xy</a>.
31If no values have been assigned to <b>data_output</b> and <b>section_xy</b>
32or
[5]33if the value given for <b>dt_do2d_xy </b>is
34larger than the simulated time (see <a href="chapter_4.1.html#end_time">end_time</a>),
35<b>then there will be no output!</b><br>
[62]36</p><p style="line-height: 100%;">Data is output in
37binary format
[5]38into the
39local file <a href="chapter_3.4.html#PLOT2D_XY">PLOT2D_XY</a>.
40This file must be linked with a permanent file by
[62]41using a file connection statement in the <b>mrun</b>
42configuration
[5]43file (see e.g. <a href="chapter_3.2.html">chapter
443.2</a>). At the end of the run the local file is copied to this
45file. Such a statement can look like this: </p>
[62]46<ul> <pre style="margin-bottom: 0.5cm; line-height: 100%;"><font style="font-size: 10pt;" size="2">PLOT2D_XY out:loc:tr pxy ~/PLOT/$fname _pxy_in.</font></pre></ul>
47<p style="line-height: 100%;">If the respective <b>mrun</b>
48call is
[5]49like </p>
[62]50<ul> <pre style="margin-bottom: 0.5cm; line-height: 100%;"><font style="font-size: 10pt;" size="2">mrun -d test -r &ldquo;pxy&rdquo;&hellip;</font></pre></ul>
51<p style="line-height: 100%;">then the local file <tt><font style="font-size: 10pt;" size="2">PLOT2D_XY</font></tt>
52is copied to the permanent file <tt><font style="font-size: 10pt;" size="2">~/PLOT/test/test_pxy_in</font>
53</tt>. However, the character string <font style="font-size: 10pt;" size="2">&ldquo;</font><tt><font style="font-size: 10pt;" size="2">pxy</font></tt><font style="font-size: 10pt;" size="2">&rdquo;</font>
[5]54activating the file connection statement (see third column of the
[62]55statement) must be given in the <b>mrun</b> call as
56argument of the
[5]57option -r (and/or -o)<b>.</b> <span style="text-decoration: none;">If
[62]58t</span>his is forgotten by mistake, the model outputs the data
59to
[5]60the local file, but this is not copied to the permanent file and thus
61the data are not available for the user after the run has finished.</p>
62<p style="line-height: 100%;">The created data file can be
63directly used as input file for the plot software <b>iso2d</b>.
[62]64However, this requires the user to assign <a href="chapter_4.2.html#data_output_2d_on_each_pe">data_output_2d_on_each_pe</a>
[5]65= <i>.FALSE. </i>(see also at the end of this chapter) . <b>iso2d</b>
66needs another file, the so-called parameter file, which specifies the
67plot
68layout. This file contains a
69so-called global parameter set which applies to all plots as well as
70a local parameter set which is valid for each individual plot. These
71global and
72local parameter sets are also created by PALM and output into two
73different local files named <a href="chapter_3.4.html#PLOT2D_XY_GLOBAL">PLOT2D_XY_GLOBAL</a>
74and <a href="chapter_3.4.html#PLOT2D_XY_LOCAL">PLOT2D_XY_LOCAL</a>.
[62]75These must be combined to one file via a so-called <a href="http://www.muk.uni-hannover.de/institut/software/mrun_beschreibung.html#chapter6.2">output
76command</a> in the configuration file. The resulting file also
77needs a
[5]78file connection statement: </p>
[62]79<ul> <pre style="line-height: 100%;"><font style="font-size: 10pt;" size="2">OC: [[ -f PLOT2D_XY_GLOBAL]] &amp;&amp; cat PLOT2D_XY_LOCAL &gt;&gt; PLOT2D_XY_GLOBAL</font><br><br><font style="font-size: 10pt;" size="2">PLOT2D_XY_GLOBAL out:loc:tr pxy ~/PLOT/$fname _pxy_par.</font></pre></ul>
80<p style="line-height: 100%;">The output command (corn
81shell syntax)
[5]82tests whether the file <tt><font style="font-size: 10pt;" size="2">PLOT2D_XY_GLOBAL</font></tt>
83exists and if so the file <tt><font style="font-size: 10pt;" size="2">PLOT2D_XY_LOCAL</font></tt>
[62]84is appended via the "cat" command to the file <tt><font style="font-size: 10pt;" size="2">PLOT2D_XY_GLOBAL</font></tt>
85which then contains all parameters needed by <b>iso2d</b>.&nbsp;
86This
[5]87relatively pedantic proceeding is due to the fact that PALM
88can produce the file PLOT2D_XY_GLOBAL only at the end of the simulation
89(when the final value of the global <span style="font-weight: bold;">iso2d</span>-parameter
[62]90<a href="http://www.muk.uni-hannover.de/institut/software/iso2d_beschreibung.html#PLANZ">planz</a>
[5]91is known), while the local parameter sets are written continuously
92to the file PLOT2D_XY_LOCAL during the run. A consequence is, that in
[62]93case of aborts of a run the file <tt><font style="font-size: 10pt;" size="2">PLOT2D_XY_GLOBAL</font></tt>
[5]94has possibly not been created and thus a visualization of the data -
95although they may be available - is
96not possible (in such a case, the user may create the parameter file
97manually). </p>
[62]98<p style="line-height: 100%;">If you are in the directory <tt><font style="font-size: 10pt;" size="2">~/PLOT/test</font></tt>,
99the data
[5]100can be plotted by entering
[62]101</p><ul> <pre style="margin-bottom: 0.5cm; line-height: 100%;"><font style="font-size: 10pt;" size="2">iso2d -d test _pxy_in -p test_pxy_par</font></pre>
102</ul><p style="line-height: 100%;">By default plot
103layout as specified in
[5]104the parameter file is as follows: for each cross section of each
105individual quantity a seperate plot is created using isolines. Isolines
106with negative values are displayed in
107red color. The axes do not have labels and the units are [m]. For
108identification, each plot is
109provided with a title, which contains the model version number, the
110run identifier (base file name + number of the restart run), the name
111of the host where the run was executed, and the date and time of the
112beginning
113of the run. Furthermore each plot carries a
114caption where the name of the displayed quantity, the output time
115(starting from
116beginning of the 3d simulation, t=0) and the location of the cross
117sections (as height level and grid point number) is noted. </p>
[62]118<p style="line-height: 100%;">The layout of the plots can
119be
[5]120varied by editing the parameter file (according to the
121various features of <b>iso2d</b>: color shading,
[62]122vector plots, streamlines, etc.). For a detailed description of the <span style="font-weight: bold;">iso2d</span> parameters see
123the
124<a href="http://www.muk.uni-hannover.de/institut/software/iso2d_beschreibung.html">iso2d</a>
[5]125manual (only in German). </p>
[62]126<p style="line-height: 100%;">With parallel runs and
127choice of <a href="chapter_4.2.html#data_output_2d_on_each_pe">data_output_2d_on_each_pe</a>
[5]128= <i>.T.</i> each PE outputs the data of its subdomain
[62]129to a separate file with the name
130PLOT2D_XY_&lt;processor-Id&gt;,
[5]131whereby &lt;processor-Id&gt; is a four digit number (e.g.
[62]132PLOT2D_XY_0000). These files are not suitable for <span style="font-weight: bold;">iso2d</span>, but after the
[5]133end
[62]134of a run they can be combined to one file readable by <span style="font-weight: bold;">iso2d</span>. This is done
135via a
[5]136further output command in the configuration file: </p>
[62]137<ul> <pre style="margin-bottom: 0.5cm; line-height: 100%;"><font style="font-size: 10pt;" size="2">OC:[[$ ( echo $localhost | cut -c1-3 ) = imbh ]] &amp;&amp; combine_plot_fields.x</font></pre></ul>
138<p style="line-height: 100%;">The program <tt><font style="font-size: 10pt;" size="2">combine_plot_fields.x</font></tt>
[5]139collects the data from the individual processor files and outputs it
140into the local file <tt><font style="font-size: 10pt;" size="2">PLOT2D_XY</font></tt>
141which can be processed by <span style="font-weight: bold;">iso2d</span>.
142Using this call, possibly existing
143files of the other cross sections (xz, yz) and of 3d volume data are
144also combined.&nbsp;The tool writes
145informative messages about the actions accomplished into the job
146protocol, even if no files were found (i.e. the output command
147may remain in the configuration file, even if no appropriate files
148are created during the simulation). <br>
[62]149<b><br>Note:</b> due to internal
150restrictions of <b>iso2d </b>the file <tt><font style="font-size: 10pt;" size="2">PLOT2D_XY</font></tt>
[5]151may not contain more than 99 cross sections. This restriction does not
152apply
[62]153for the production of video clips via <b>iso2d</b>.
154&nbsp; </p>
155<hr><p style="line-height: 100%;"><br>
156<font color="#000080"><font color="#000080"><a href="chapter_4.5.3.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.5.5.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
157change:&nbsp;&nbsp;</i>
158$Id: chapter_4.5.4.html 62 2007-03-13 02:52:40Z suehring $</p>
159</body></html>
Note: See TracBrowser for help on using the repository browser.