source: palm/trunk/DOC/app/chapter_4.5.3.html @ 17

Last change on this file since 17 was 5, checked in by raasch, 18 years ago

html-documentation added

File size: 8.6 KB
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<html>
3<head>
4  <meta http-equiv="CONTENT-TYPE"
5 content="text/html; charset=windows-1252">
6  <title>PALM chapter 4.5.3</title>
7  <meta name="GENERATOR" content="StarOffice 7  (Win32)">
8  <meta name="AUTHOR" content="Siegfried Raasch">
9  <meta name="CREATED" content="20041026;14291096">
10  <meta name="CHANGED" content="20041117;11335481">
11  <meta name="KEYWORDS" content="parallel LES model">
12  <style>
13        <!--
14                @page { size: 21cm 29.7cm }
15        -->
16        </style>
17</head>
18<body dir="ltr" lang="en-US">
19<h4 style="line-height: 100%;"><font size="4">4.5.3 Plots of time
20series
21with profil</font></h4>
22<p style="line-height: 100%;">Output of time series is enabled
23by providing a value for the run parameter <a
24 href="chapter_4.2.html#dt_dots">dt_dots</a>,
25which specifies the temporal interval at which time series data is
26output. Output times cannot be defined
27directly but only via the output time interval, starting from the
28beginning of the initial 3d run (t=0, but no data is output at that
29time). The time series data
30represent sums, averages or extreme values which by default refer to
31the total model domain.
32Output of time series for user-defined subdomains is possible with the
33help of the initialization parameter
34<a href="chapter_4.1.html#statistic_regions">statistic_regions</a>.
35</p>
36<p style="line-height: 100%;">Time series are output into the local
37file <a href="chapter_3.4.html#PLOTTS_DATA">PLOTTS_DATA</a>.
38This file must be linked with a permanent file via a file connection
39statement in the <b>mrun</b> configuration file (see e.g. <a
40 href="chapter_3.2.html">Chapter
413.2</a>). At the end of the run the local file is copied to this
42file. Such a statement can look like this: </p>
43<ul>
44  <pre style="margin-bottom: 0.5cm; line-height: 100%;"><font
45 style="font-size: 10pt;" size="2">PLOTTS_DATA  out:loc:tr  ts   ~/PLOT/$fname   _ts_in</font></pre>
46</ul>
47<p style="line-height: 100%;">If the respective <b>mrun</b> call is
48like<br>
49</p>
50<ul>
51  <pre style="margin-bottom: 0.5cm; line-height: 100%;"><font
52 style="font-size: 10pt;" size="2">mrun -d test -r “ts”…</font></pre>
53</ul>
54<p style="line-height: 100%;">then the local file <tt><font
55 style="font-size: 10pt;" size="2">PLOTTS_DATA</font></tt>
56is copied to the permanent file <tt><font style="font-size: 10pt;"
57 size="2">~/PLOT/test/test_ts_in</font>
58</tt><font face="Thorndale, serif">.</font> However, the character
59string <font style="font-size: 10pt;" size="2">“</font><tt><font
60 style="font-size: 10pt;" size="2">ts</font></tt><font
61 style="font-size: 10pt;" size="2">”</font>
62activating the file connection staement (see third column of the
63statement) must be given in the <b>mrun</b> call as argument of the
64option -r (and/or -o)<b>. </b>If this is
65forgotten by mistake, the model outputs the data to the local file, but
66this is
67not copied to the permanent file and thus the data are not available
68for the user after the run has finished. </p>
69<p style="line-height: 100%;">The time series data file always
70contains all time series available. Which time series are
71actually plotted can be specified via the parameter <a
72 href="chapter_4.2.html#data_output_ts">data_output_ts</a>.<br>
73</p>
74<p style="line-height: 100%;">The created data file can be directly
75used as input file for the plot
76routine <b>profil</b>. Beside the data file,&nbsp; <b>profil</b>
77needs another file, the
78so-called parameter file, which specifies the plot layout. This file is
79created by PALM under the local
80name <a href="chapter_3.4.html#PLOTTS_PAR">PLOTTS_PAR</a>
81and also needs a file connection statement, e.g.: </p>
82<ul>
83  <pre style="margin-bottom: 0.5cm; line-height: 100%;"><font
84 style="font-size: 10pt;" size="2">PLOTTS_PAR out:loc:tr  ts  ~/PLOT/$fname  _ts_par</font></pre>
85</ul>
86<p style="line-height: 100%;">If you are in the directory
87<tt><font style="font-size: 10pt;" size="2">~/PLOT/test</font>,</tt>the
88data can be plotted by entering </p>
89<ul>
90  <pre style="margin-bottom: 0.5cm; line-height: 100%;"><font
91 style="font-size: 10pt;" size="2">profil -d  test_ts_in  -p test_ts_par</font></pre>
92</ul>
93<p style="line-height: 100%;">Which time series are actually plotted
94can be determined with the parameter <a href="chapter_4.2.html#data_output_ts">data_output_ts</a>.
95</p>
96<p style="line-height: 100%;">By default plot layout as specified in
97the parameter file is as follows: the individual time series are
98plotted
99into individual coordinate systems (panels) which are arranged one upon
100the other. Typically several time
101series are plotted
102together into one panel. The grouping is fixed PALM-internally (it can
103be changed by editing the parameter input file). The parameter <b>data_output_ts</b>
104determines which time series are actually to be plotted. If none of the
105time series
106which are assigned to a certain panel is plotted,
107then this panel is completely omitted in the plot. </p>
108<p style="line-height: 100%;">The time series are always plotted
109one page only. or identification, each plot is
110provided with a title, which contains the model version number, the
111run identifier (base file name + number of the restart run), the name
112of the host where the run was executed, the date and time of the
113beginning
114of the run as well as the averaging domain (by default: <span
115 style="font-style: italic;">'total
116domain'</span>).
117The x axes of the panels have the label “<i>time
118in s</i>”, the y axes have no label. The
119run parameters <a href="chapter_4.2.html#cross_ts_uymin">cross_ts_uymin</a>
120and <a href="chapter_4.2.html#cross_ts_uymax">cross_ts_uymax</a>
121can be used to assign the range of values of the y axis individually
122for
123each panel. By default, the range of values is calculated
124from the minimum and maximum values of the time series. Each system
125has a legend which contains an entry for each time serias. The legend
126string is taken from file PLOTTS_DATA where the time
127series contained are noted in the comment lines at the
128beginning of the file. If a panel contains more than one time series
129then they are marked by different
130colors and types of lines. </p>
131<p style="line-height: 100%;">If a simulation needs restart runs, then
132one usually would like to have the time series of the complete
133simulation in one plot. Using the file connection statements shown
134above, a new cycle of time series data file and of the parameter file
135is created for each run and thus the time series could only be plotted
136in pieces. If one wants to have the complete time series in one
137plot, the configuration file must be changed such that for
138restart runs the time series data are appended to already existing
139data (thus all data are output into one file). Then the configuration
140file has two entries for PLOTTS_DATA:
141</p>
142<ul>
143  <pre style="line-height: 100%;"><font style="font-size: 10pt;"
144 size="2">PLOTTS_DATA out:loc:tr   ts#  ~/PLOT/$fname  _ts_in</font><br><font
145 style="font-size: 10pt;" size="2">PLOTTS_DATA out:loc:tra  tsf  ~/PLOT/$fname  _ts_in.</font></pre>
146</ul>
147<p style="line-height: 100%;">The first run of the job chain is now </p>
148<ul>
149  <pre style="margin-bottom: 0.5cm; line-height: 100%;"><font
150 style="font-size: 10pt;" size="2">mrun  -d  test -r “ts#…</font></pre>
151</ul>
152<p style="line-height: 100%;">For the restart runs, the "#" in the <span
153 style="font-weight: bold;">mrun</span>
154call is automatically replaced by an "f". At the end of the job chain
155there will only be one data file containing the complete time series
156data. The file connection staement for the parameter file PLOTTS_PAR
157has not changed, thus a new cycle of the respective permanent file is
158created for each run. The highest
159cycle of this file can be used as parameter file in order to plot the
160complete time series. </p>
161<p style="line-height: 100%;">The default layout of the plots of time
162series described can be changed by editing the
163parameter file. For a detailed description of the <span
164 style="font-weight: bold;">profil</span> parameters see the
165<a
166 href="http://www.muk.uni-hannover.de/institut/software/profil_beschreibung.html">profil</a>
167manual (only in German).&nbsp;<br>
168</p>
169<hr>
170<p style="line-height: 100%;"><br>
171<font color="#000080"><font color="#000080"><a href="chapter_4.5.2.html"><font
172 color="#000080"><img src="left.gif" name="Grafik1" align="bottom"
173 border="2" height="32" width="32"></font></a><a href="index.html"><font
174 color="#000080"><img src="up.gif" name="Grafik2" align="bottom"
175 border="2" height="32" width="32"></font></a><a
176 href="chapter_4.5.4.html"><font color="#000080"><img src="right.gif"
177 name="Grafik3" align="bottom" border="2" height="32" width="32"></font></a></font></font></p>
178<p style="line-height: 100%;">&nbsp;<span style="font-style: italic;">Last
179change:</span> 19/04/05 (SR)<br>
180</p>
181</body>
182</html>
Note: See TracBrowser for help on using the repository browser.