Home


About us
PALM
PALM-4U
Installation
Release notes
Documentation
Getting Help
Gallery
Developers area

Ignore:
Timestamp:
Mar 6, 2007 12:28:36 PM (17 years ago)
Author:
raasch
Message:

preliminary version, several changes to be explained later

File:
1 edited

Legend:

Unmodified
Added
Removed

  • palm/trunk/DOC/app/chapter_4.5.3.html

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