Debian Codegraph @

docs/manual/chapters/obs.xml

raw
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3 (C) Copyright 1996-2016 ECMWF.
4
5 This software is licensed under the terms of the Apache Licence Version 2.0
6 which can be obtained at http://www.apache.org/licenses/LICENSE-2.0.
7 In applying this licence, ECMWF does not waive the privileges and immunities
8 granted to it by virtue of its status as an intergovernmental organisation nor
9 does it submit to any jurisdiction.
10 -->
11
12 <chapter id="ObservationPlotting" label="VII">
13 <title>Observation Plotting</title>
14
15 <xi:include href="../phrases/chapterinfo_mod.xml"
16 xmlns:xi="http://www.w3.org/2001/XInclude" />
17
18 <section id="Observation_Introduction">
19 <title>Introduction</title>
20
21 <para><productname>Magics</productname> observation plotting allows the
22 plotting of observation types stored in WMO BUFR.
23 </para>
24
25 <important>
26 <title>What about ODB?</title>
27
28 <productname>Magics</productname> also supports the plotting of observations and analysis feedback from ECMWF's
29 ODB format. This is feature is currently only supported within ECMWF and will be described
30 in a seperate chapter when available.
31 </important>
32
33 <para>All observation types may be plotted, i.e. SYNOP, AIREP, SATOB,
34 DRIBU, TEMP, PILOT and SATEM. Within each observation type, specific code
35 types may be selected for plotting, e.g. ships only may be selected from
36 SYNOP. The user has full control over the type, number and size of the
37 observations. The amount of meteorological information plotted may also be
38 controlled by the user.</para>
39
40 <para>The meteorological data plotted, e.g. pressure, temperature etc,
41 will be called meteorological variables in this chapter to distinguish
42 them from <productname>Magics</productname> parameters.</para>
43
44 <important>
45 <title>Magics++ - we need your feedback</title>
46 You can help to improve the support of BUFR observation plotting in <productname>Magics</productname>
47 by providing bug reports and example data.
48 </important>
49
50 <section id="Action_Routine_POBS">
51 <title>Action Routine POBS</title>
52
53 <para>Plotting of observations in <productname>Magics</productname> is
54 achieved by calling action routine <function>POBS</function>, which has no
55 arguments, e.g. <code>CALL POBS</code>. Any
56 <productname>Magics</productname> parameters required should be set and
57 the input data defined before calling <function>POBS</function>. Depending
58 on the user requirements, <function>POBS</function> will plot any
59 observations from the user's input that fit in the current map. All
60 observations that do not fit the user's criteria or whose positions are
61 outside the geographical area of the current map will be ignored.</para>
62
63 <section id="Obs_Data_Input">
64 <title>Data Input</title>
65
66 <para>Data for observation plotting must be presented to Magics in the
67 form of an input file. Data for plotting must be in WMO BUFR code.
68 The parameter <parameter>OBS_INPUT_FILE_NAME</parameter> should be used to pass the name
69 and address path of the file containing the observations for plotting.
70 Full details of data input are given in chapter Data
71 Input.</para>
72 </section>
73
74 <section id="Meteorological_Variables">
75 <title>Meteorological Variables</title>
76
77 <para>Parameters exist to control all aspects of observation plotting.
78 These parameters all start with the prefix <parameter>OBS</parameter>,
79 e.g. <parameter>OBS_TEMPERATURE</parameter>.</para>
80
81 <para>Each observation type has its own fixed list of meteorological
82 variables, any of which may be 'turned off', i.e. not plotted. For
83 example, if pressure is not required to be plotted, it may be 'turned off'
84 by the following:</para>
85
86 <programlisting> CALL <function>PSETC</function>('<parameter>OBS_PRESSURE</parameter>','OFF')</programlisting>
87
88 <para>The meteorological variables to be plotted, by default, for each
89 observation type are given in the sections that describe each observation
90 type.</para>
91
92 <para>The colour in which each of the plotting variables is plotted is
93 also controlled by <productname>Magics</productname> parameters. Each
94 variable has its own default colour but this may be user controlled with
95 the relevant parameter, e.g.</para>
96
97 <programlisting> CALL <function>PSETC</function> ('<parameter>OBS_PRESSURE_COLOUR</parameter>', 'GREEN')</programlisting>
98 </section>
99
100 <section id="Observation_Size_Position_and_Separation">
101 <title>Observation Size, Position and Separation</title>
102
103 <para>A circle or triangle (for DRIBU only) will be plotted to mark the
104 position of each observation. The user may inhibit this by setting the
105 parameter <parameter>OBS_STATION_RING</parameter> to
106 '<code>OFF</code>'.</para>
107
108 <para>The size of observations, i.e. the height of the numbers and
109 symbols, may be controlled by setting the parameter
110 <parameter>OBS_SIZE</parameter> to the required value, the default being
111 0.2cm.</para>
112
113 <para>To ensure that plotted observations do not overlap, the parameter
114 <parameter>OBS_DISTANCE_APART</parameter> may be set. The default value of
115 1.0cm means that, after plotting an observation, no other observation will
116 be plotted within one centimetre of it. The distance between observations
117 is measured from the centre of each.</para>
118
119 <para>If only the positions of observations are to be plotted, the
120 parameter <parameter>OBS_POSITION_ONLY</parameter> should be set to
121 '<code>ON</code>' , the default being '<code>OFF</code>' . When only the
122 positions of observations are plotted, a different symbol is used for each
123 observation type. It is possible to
124 plot the station identification when positions only are requested.</para>
125
126 </section>
127
128 <section id="Obs_Pressure_Levels">
129 <title>Pressure Levels</title>
130
131 <para>For observations, other than surface observations, the user may
132 specify the pressure level (hPa) to be plotted by setting the parameter
133 <parameter>OBS_LEVEL</parameter> to the required level, e.g.</para>
134
135 <programlisting> CALL <function>PSETI</function> ('<parameter>OBS_LEVEL</parameter>',850)</programlisting>
136
137 <para>The default for <parameter>OBS_LEVEL</parameter> is 500 hPa.</para>
138
139 <para>To enable the plotting of off-level data, the parameter
140 <parameter>OBS_LEVEL_TOLERANCE</parameter> may be set to a value, in hPa,
141 above and below the level set in <parameter>OBS_LEVEL</parameter>, the
142 default value for the tolerance being <code>0</code>.</para>
143
144 <para>If plotting of the thickness between two levels is required, two
145 pressure levels must be defined, i.e. the top and bottom levels of the
146 layer for which the thickness is to be plotted. Users may specify these
147 two levels by setting the parameters <parameter>OBS_LEVEL</parameter> and
148 <parameter>OBS_LEVEL_2</parameter> to the required values in hPa, the
149 defaults being <code>500</code> and <code>1000</code>, respectively.
150 Thicknesses may be plotted for TEMP and SATEM observations.</para>
151 </section>
152
153 <section id="Observation_Identification">
154 <title>Observation Identification</title>
155
156 <para>The observation identification may be plotted by setting the
157 parameter <parameter>OBS_IDENTIFICATION</parameter> to '<code>ON</code>' ,
158 the default being '<code>OFF</code>' for all observation types. An
159 observation may be identified by its observation type, its code type or
160 its station identifier. To specify the required identification, the
161 parameter <parameter>OBS_IDENTIFICATION_TYPE</parameter> may be set,
162 e.g.</para>
163
164 <programlisting> CALL <function>PSETC</function> ('<parameter>OBS_IDENTIFICATION_TYPE</parameter>','OBSERVATION_TYPE')</programlisting>
165
166 <para>By default, the station identifier will be plotted.</para>
167 </section>
168 </section>
169
170 <section id="Observation_Selection_Parameters">
171 <title>Observation Selection Parameters</title>
172
173 <para>There are parameters available to enable users to select
174 observations for plotting. In some cases, a combination of parameters may
175 be used to define the required observations.</para>
176
177 <para><productname>Magics</productname> will only use these parameters if
178 they are set by the user. The value set in these parameters stays in
179 effect until changed or reset. To reset the value of a parameter, users
180 should use routine <function>PRESET</function>, e.g. <code>CALL PRESET
181 ('OBS_IDENTIFIER_LIST')</code>. This has the effect that
182 <productname>Magics</productname> assumes that the parameter has not been
183 set by the user and, where applicable, the parameter is reset to its
184 default value.</para>
185
186 <para>The following sections describe these parameters.</para>
187
188 <section id="Identifier_List">
189 <title>Identifier List</title>
190
191 <para><parameter>OBS_IDENTIFIER_LIST</parameter> is used to pass a list
192 of station identifiers. The station list should be stored in a character
193 array and passed by the following call:</para>
194
195 <programlisting> CALL <function>PSET1C</function> ('<parameter>OBS_IDENTIFIER_LIST</parameter>',ILIST,N)</programlisting>
196
197 <para>where <code>ILIST</code> is a character array containing the list
198 of station identifiers and <code>N</code> is the length of the
199 array.</para>
200
201 <para>Only the observations listed in the array will be plotted. Land
202 station identifiers, e.g. <code>03953</code>, as well as ship
203 identifiers, which include alphabetic characters in their identifiers,
204 may be passed in the array. This parameter should not be used for
205 passing satellite numbers (<remark>see Satellite Number
206 List</remark>).</para>
207
208 <para>A full list of station identifiers can be found in the WMO manual
209 on Observing Stations.</para>
210 </section>
211
212 <section id="Type_List">
213 <title>Type List</title>
214
215 <para><parameter>OBS_TYPE_LIST</parameter> is used to pass a list of
216 observation types, i.e. SYNOP, AIREP, SATOB, DRIBU, TEMP, PILOT and
217 SATEM. The list of observation types should be stored in a character
218 array and passed as follows:</para>
219
220 <programlisting> CALL <function>PSET1C</function> ('<parameter>OBS_TYPE_LIST</parameter>',OTYPE,N)</programlisting>
221
222 <para>where <code>OTYPE</code> is the array containing the list of
223 observation types and <code>N</code> is the length of the array. Only
224 those observations whose observation type is included in the list will
225 be plotted.</para>
226 </section>
227
228 <section id="Code_Type_List">
229 <title>Code Type List</title>
230
231 <para><parameter>OBS_CODE_TYPE_LIST</parameter> is used to pass a list
232 of code types.</para>
233
234 <para>Within each observation type, there exists various code types,
235 e.g. SYNOPS have different code types for each individual type of
236 observation (code type 21 = SHIP ). Further descriptions of observation
237 types and code types can be found in the next section. The list of code
238 types (integer numbers) should be stored in an integer array and passed
239 by the following call:</para>
240
241 <programlisting> CALL <function>PSET1I</function> ('<parameter>OBS_CODE_TYPE_LIST</parameter>',ICLIST,N)</programlisting>
242
243 <para>where <code>ICLIST</code> is the array containing the list of code
244 types and <code>N</code> is the length of the array. Only those
245 observations whose code type is in the list will be plotted.</para>
246 </section>
247
248 <section id="Satellite_Number_List">
249 <title>Satellite Number List</title>
250
251 <para><parameter>OBS_SATELLITE_NUMBER_LIST</parameter> is used to pass a
252 list of satellite numbers for both SATOB and SATEM observations.</para>
253
254 <para>For each satellite code type, there exists various numbers to
255 identify the particular satellite. This number is actually the station
256 identifier (37 = NOAA9 ). The list of satellite numbers should be stored
257 in an integer array and passed as follows:</para>
258
259 <programlisting> CALL <function>PSET1I</function> ('<parameter>OBS_SATELLITE_NUMBER_LIST</parameter>',ISLIST,N)</programlisting>
260
261 <para>where <code>ISLIST</code> is the array containing the list of
262 satellite numbers and <code>N</code> is the length of
263 <code>ISLIST</code>. Please note that the parameter
264 <parameter>OBS_IDENTIFIER_LIST</parameter> should not be used to pass a
265 list of satellite numbers.</para>
266 </section>
267
268 <section id="Time_Check">
269 <title>Time Check</title>
270
271 <para>If observations are required for a particular time only, the
272 parameter <parameter>OBS_TIME</parameter> should be set to the required
273 time.</para>
274
275 <para>Even though the input file may contain observations for various
276 times, only those whose time is specified in
277 <parameter>OBS_TIME</parameter> will be plotted. To activate this time
278 check, the parameter <parameter>OBS_TIME_CHECK</parameter> should be set
279 to '<code>ON</code>' , the default being '<code>OFF</code>'. After
280 plotting reports for a particular time, the time check may be
281 deactivated by setting <code>OBS_TIME_CHECK</code> to
282 '<code>OFF</code>'.</para>
283
284 <para>The format for setting <parameter>OBS_TIME</parameter> is as
285 follows:</para>
286
287 <programlisting> CALL <function>PSETI</function> ('<parameter>OBS_TIME</parameter>',hhmm)</programlisting>
288
289 <para><code>hh</code> is the hour required and mm are the minutes.
290 <code>CALL PSETI ('OBS_TIME',1230)</code> specifies that observations
291 are required for 1230 UTC only. The default value is
292 <code>1200</code>.</para>
293
294 <para>Please note the difference between
295 <parameter>OBS_TIME_CHECK</parameter> and the parameter
296 <parameter>OBS_TIME_PLOT</parameter>, which should be set to
297 '<code>ON</code>' when the time of an observation is to be plotted. The
298 parameter <parameter>OBS_TIME_TOLERANCE</parameter> enables users to
299 specify a time range for plotting observations. It should be used in
300 conjunction with the parameter <parameter>OBS_TIME</parameter>.
301 <parameter>OBS_TIME_TOLERANCE</parameter> may be set as follows:</para>
302
303 <programlisting> CALL <function>PSETI</function> ('<parameter>OBS_TIME_TOLERANCE</parameter>',hhmm)</programlisting>
304
305 <para>where <code>hh</code> is a number of hours and <code>mm</code> is
306 a number of minutes. For example, if <parameter>OBS_TIME</parameter> is
307 set to <code>1200</code> and <parameter>OBS_TIME_TOLERANCE</parameter>
308 is set to <code>330</code>, the time range for which observations are to
309 be plotted is 0830-1530 UTC. <parameter>OBS_TIME_TOLERANCE</parameter>,
310 whose default value is <code>0</code> , is only used if
311 <parameter>OBS_TIME_CHECK</parameter> has been set to
312 '<code>ON</code>'.</para>
313
314 <highlights>
315 <para>Diagram 3</para>
316 </highlights>
317 </section>
318
319 <section id="OBS_Date_Check">
320 <title>OBS Date Check</title>
321
322 <para>There are <productname>Magics</productname> parameters to
323 control/filter observations by <code><parameter>DATE</parameter></code>.
324 The parameter <parameter>OBS_DATE</parameter> may be set to the date of
325 the observations required to be plotted, e.g. <code>CALL PSETI
326 ('OBS_DATE',951207)</code> (7th Dec. 1995). Observations from other
327 dates will be ignored. However, The parameter
328 <parameter>OBS_DATE_TOLERANCE</parameter> may be used to set a period,
329 before and after the date set in <parameter>OBS_DATE</parameter> , for
330 which observations are to be plotted, e.g. <code>CALL PSETI
331 ('OBS_DATE_TOLERANCE',2)</code> (2 days before and after
332 <parameter>OBS_DATE</parameter> , default <code>0</code>).</para>
333
334 <para>The parameters, <parameter>OBS_DATE</parameter> and
335 <parameter>OBS_DATE_TOLERANCE</parameter> are only used in
336 <productname>Magics</productname> if the parameter
337 <parameter>OBS_DATE_CHECK</parameter> is set to '<code>ON</code>'. If
338 <parameter>OBS_DATE_CHECK</parameter>='<code>OFF</code>' , which is the
339 default, no check is made on the date of the data.</para>
340 </section>
341
342 <remark>
343 Is this FEEDBACK???
344 <section id="Confidence_Check">
345 <title>Confidence Check</title>
346
347 <para>The ECMWF Quality Control assigns confidence values (percentage
348 values) to each of the meteorological variables in each observation,
349 including the report type and the report position. A feature of
350 observation plotting is the ability to be able to plot observations
351 which have been given low confidence values by the Quality
352 Control.</para>
353
354 <para>There are three parameters to control this.
355 <parameter>OBS_CONFIDENCE_CHECK</parameter> may be set to
356 '<code>ON</code>' to enable this feature. The default is
357 '<code>OFF</code>'. <parameter>OBS_CONFIDENCE_LEVEL</parameter> may be
358 set to a value (integer) between 0 and 100 to indicate the maximum
359 acceptable level. This means that if the checked variables have
360 confidence values which are lower than the set level, the station ring
361 for that observation will be plotted.
362 <parameter>OBS_CONFIDENCE_PARAMETER</parameter> may be set to one of 7
363 values to indicate which of the meteorological variables are to be
364 checked. The valid values are '<code>POSITION</code>' (default),
365 '<code>TEMPERATURE</code>' , '<code>PRESSURE</code>' ,
366 '<code>HEIGHT</code>' , '<code>WIND</code>' , '<code>DEWPOINT</code>'
367 and '<code>ANY</code>'. If set to any value except '<code>ANY</code>',
368 then only that variable will be checked for the confidence level. If set
369 to '<code>ANY</code>', all of the above variables will be checked and if
370 any of them fail the check, the observation will be plotted.</para>
371 </section>
372 </remark>
373 </section>
374
375 <section id="Obs_Plotting_Formats">
376 <title>Plotting Formats</title>
377
378 <para>Each observation type has its own set of meteorological variables
379 for plotting.</para>
380
381 <para>The following sections describe each of the observation types and
382 the variables plotted by them. Please note that the station identification
383 which may be plotted by all observation types may be one of the following:
384 OBSERVATION TYPE (see previous section), CODE TYPE (numbered as in
385 previous section) or STATION IDENTIFIER.</para>
386
387 <para>A plotting layout, showing the positions of the variables, is given
388 for each of the observation types. Wind plotting and ship direction and
389 speed have been omitted from these layouts.</para>
390
391 <para>It may be necessary, depending on the wind direction, to move some
392 of the variables to a different position. This will be done
393 automatically.</para>
394
395 <para>The station identification may also be automatically moved nearer to
396 the centre of the observation, depending on whether the dewpoint and/or
397 the sea surface temperature are omitted from the plotting. This is to
398 avoid overplotting of observations. If the plotting of observation
399 positions is requested, with station identification turned on, the
400 identification will be moved a position immediately to the right of the
401 station ring or symbol.</para>
402
403 <section id="Surface_Plotting_Formats">
404 <title>Surface Plotting Formats</title>
405
406 <para>The full layout for plotting surface observations is given below
407 and is used for plotting SYNOP and DRIBU observations.</para>
408
409 <highlights>
410 <para>FrameMaker figure here</para>
411 </highlights>
412
413 <para>The symbols in the above layout are explained in the following
414 sections.</para>
415
416 <para>The full surface layout is available for SYNOP plotting. If any of
417 the variables are omitted from the observation the space reserved for it
418 will be left blank, except, as explained above, for station
419 identification. Only a limited number of the variables are available for
420 plotting DRIBU observations.</para>
421 </section>
422
423 <section id="Observation_Type_SYNOP">
424 <title>Observation Type SYNOP</title>
425
426 <para>SYNOP or surface observations means all synoptic surface
427 observations from land stations and ships, including automatic stations
428 and SHRED, but not including DRIBU, BATHY or TESAC. The meteorological
429 variables plotted, together with their corresponding
430 <productname>Magics</productname> parameters and default colour and
431 status (<code>ON</code> or <code>OFF</code>) are listed below.</para>
432
433 <para>Please note that the <productname>Magics</productname> parameter
434 <parameter>OBS_CLOUD</parameter> controls the plotting of all cloud
435 information. If set to '<code>OFF</code>' , no cloud will be plotted,
436 regardless of the setting of the other cloud parameters. If set to
437 '<code>ON</code>' , the value set in the other parameters will then be
438 taken into consideration.</para>
439
440 <para>Users should also note the observation time may be plotted in the
441 space reserved for plotting cloud 8 groups. Only one of these variables
442 should be requested for plotting. If the two of them are requested, the
443 8 groups take precedence.</para>
444
445 <section id="High_Altitude_Stations">
446 <title>High Altitude Stations</title>
447
448 <para>In synoptic plotting for high altitude stations, instead of mean
449 sea level pressure, the height in metres of the nearest standard
450 pressure level will be plotted.</para>
451
452 <table id="table_high_alt">
453 <title>Magics parameters for high altitude stations</title>
454
455 <tgroup cols="4">
456 <colspec colwidth="1.2*" />
457 <colspec colwidth="1.2*" />
458 <colspec colwidth="0.3*" />
459 <colspec colwidth="0.7*" />
460
461 <thead>
462 <row>
463 <entry>Meteorological Variable</entry>
464
465 <entry>Magics Parameter</entry>
466
467 <entry>Status</entry>
468
469 <entry>Default Colour</entry>
470 </row>
471 </thead>
472
473 <tbody>
474 <row>
475 <entry>STATION RING (O)</entry>
476
477 <entry>OBS_STATION_RING</entry>
478
479 <entry>ON</entry>
480
481 <entry>FOREGROUND</entry>
482 </row>
483
484 <row>
485 <entry>STATION IDENTIFICATION (IDEN)</entry>
486
487 <entry>OBS_IDENTIFICATION</entry>
488
489 <entry>ON</entry>
490
491 <entry>FOREGROUND</entry>
492 </row>
493
494 <row>
495 <entry>WIND SPEED AND DIRECTION</entry>
496
497 <entry>OBS_WIND</entry>
498
499 <entry>ON</entry>
500
501 <entry>FOREGROUND</entry>
502 </row>
503
504 <row>
505 <entry>MSL PRESSURE (PPP)</entry>
506
507 <entry>OBS_PRESSURE</entry>
508
509 <entry>ON</entry>
510
511 <entry>FOREGROUND</entry>
512 </row>
513
514 <row>
515 <entry>AIR TEMPERATURE (TT)</entry>
516
517 <entry>OBS_TEMPERATURE</entry>
518
519 <entry>ON</entry>
520
521 <entry>FOREGROUND</entry>
522 </row>
523
524 <row>
525 <entry>SEA SURFACE TEMPERATURE (TsTs)</entry>
526
527 <entry>OBS_SEA_SURFACE_TEMPERATURE</entry>
528
529 <entry>ON</entry>
530
531 <entry>FOREGROUND</entry>
532 </row>
533
534 <row>
535 <entry>PRESSURE TENDENCY (ppa)</entry>
536
537 <entry>OBS_PRESSURE_TENDENCY</entry>
538
539 <entry>ON</entry>
540
541 <entry>FOREGROUND/RED(neg)</entry>
542 </row>
543
544 <row>
545 <entry>PRESENT WEATHER (ww)</entry>
546
547 <entry>OBS_PRESENT_WEATHER</entry>
548
549 <entry>ON</entry>
550
551 <entry>FOREGROUND</entry>
552 </row>
553
554 <row>
555 <entry>PAST WEATHER (W1W2)</entry>
556
557 <entry>OBS_PAST_WEATHER</entry>
558
559 <entry>ON</entry>
560
561 <entry>RED</entry>
562 </row>
563
564 <row>
565 <entry>VISIBILITY (vv)</entry>
566
567 <entry>OBS_VISIBILITY</entry>
568
569 <entry>ON</entry>
570
571 <entry>FOREGROUND</entry>
572 </row>
573
574 <row>
575 <entry>DEWPOINT (TdTd)</entry>
576
577 <entry>OBS_DEWPOINT</entry>
578
579 <entry>ON</entry>
580
581 <entry>RED</entry>
582 </row>
583
584 <row>
585 <entry>CLOUD (ALL)</entry>
586
587 <entry>OBS_CLOUD</entry>
588
589 <entry>ON</entry>
590
591 <entry>No Parameter</entry>
592 </row>
593
594 <row>
595 <entry>LOW CLOUD (CL)</entry>
596
597 <entry>OBS_LOW_CLOUD</entry>
598
599 <entry>ON</entry>
600
601 <entry>FOREGROUND</entry>
602 </row>
603
604 <row>
605 <entry>MEDIUM CLOUD (CM)</entry>
606
607 <entry>OBS_MEDIUM_CLOUD</entry>
608
609 <entry>ON</entry>
610
611 <entry>FOREGROUND</entry>
612 </row>
613
614 <row>
615 <entry>HIGH CLOUD (CH)</entry>
616
617 <entry>OBS_HIGH_CLOUD</entry>
618
619 <entry>ON</entry>
620
621 <entry>RED</entry>
622 </row>
623
624 <row>
625 <entry>OBSERVATION TIME (TIME)</entry>
626
627 <entry>OBS_TIME_PLOT</entry>
628
629 <entry>OFF</entry>
630
631 <entry>FOREGROUND</entry>
632 </row>
633
634 <row>
635 <entry>WAVES AND SWELL</entry>
636
637 <entry>OBS_WAVES</entry>
638
639 <entry>OFF</entry>
640
641 <entry>FOREGROUND</entry>
642 </row>
643 </tbody>
644 </tgroup>
645 </table>
646 </section>
647
648 <section id="Wave_and_Swell_Observations">
649 <title>Wave and Swell Observations</title>
650
651 <para>It is possible to plot wave and swell direction and height (Wav1
652 and Wav2) on surface ship observations. It is necessary in this case
653 to pass part 2 of the ship observation (SS2 in MARS) to
654 <productname>Magics</productname>. The
655 <productname>Magics</productname> parameter
656 <parameter>OBS_INPUT_FILE_NAME</parameter> should be set to the name
657 (including the path) of the file containing the observations. The
658 parameter <parameter>OBS_WAVES</parameter> should be set to
659 '<code>ON</code>' and <function>POBS</function> called in the normal
660 way. For each wave reported in the observation, the period and height
661 of the wave or swell are plotted as pphh where pp is the period and hh
662 the height. The direction of the wave/swell is also plotted according
663 to WMO standards.</para>
664 </section>
665
666 <section id="Soil_and_Earth_Temperatures">
667 <title>Soil and Earth Temperatures</title>
668
669 <para>Soil and earth temperature can be plotted using
670 <productname>Magics</productname> in the usual way, i.e. pass the file
671 containing the observations to <productname>Magics</productname> and
672 call <function>POBS</function>. However, even though they are
673 classified by <productname>MARS</productname> as Code type 1 and
674 Subtype 7, they have their own special format in BUFR code and have a
675 unique plotting standard (see below). They report temperatures at four
676 depths in the earth's soil and these depths may vary.
677 <productname>Magics</productname> plots the data for the four depths
678 to the right of the station circle, with the shallowest depth on top.
679 The temperature for each depth is plotted followed by the actual depth
680 in brackets, e.g. 13 (4) means a temperature of 13 degrees Celsius at
681 4 cm depth.</para>
682
683 <para>To enable the filtering of these observations, from a file
684 containing mixed observations, the abbreviation <code>SOILT</code> can
685 be used when setting the parameter
686 <parameter>OBS_TYPE_LIST</parameter>. The height of the station above
687 sea level is plotted to the left of the station circle. This may be
688 turned off by setting <parameter>OBS_STATION_HEIGHT</parameter> to
689 '<code>OFF</code>'. Following is a description of how soil and earth
690 temperatures are plotted (STH = Station height, ST = soil temperature
691 and dep = depth):</para>
692
693 <table id="table_soil_temp">
694 <title>Magics parameters for soil temperatures</title>
695
696 <tgroup cols="4">
697 <colspec colwidth="1.45*" />
698 <colspec colwidth="1.2*" />
699 <colspec colwidth="0.3*" />
700 <colspec colwidth="0.68*" />
701
702 <thead>
703 <row>
704 <entry>Meteorological Variable</entry>
705
706 <entry>Magics Parameter</entry>
707
708 <entry>Status</entry>
709
710 <entry>Default Colour</entry>
711 </row>
712 </thead>
713
714 <tbody>
715 <row>
716 <entry>SOIL TEMPERATURE LEVEL 1</entry>
717
718 <entry>OBS_SOIL_TEMPERATURE_LEVEL_1</entry>
719
720 <entry>ON</entry>
721
722 <entry>FOREGROUND</entry>
723 </row>
724
725 <row>
726 <entry>SOIL TEMPERATURE LEVEL 2</entry>
727
728 <entry>OBS_SOIL_TEMPERATURE_LEVEL_2</entry>
729
730 <entry>ON</entry>
731
732 <entry>FOREGROUND</entry>
733 </row>
734
735 <row>
736 <entry>SOIL TEMPERATURE LEVEL 3</entry>
737
738 <entry>OBS_SOIL_TEMPERATURE_LEVEL_3</entry>
739
740 <entry>ON</entry>
741
742 <entry>FOREGROUND</entry>
743 </row>
744
745 <row>
746 <entry>SOIL TEMPERATURE LEVEL 4</entry>
747
748 <entry>OBS_SOIL_TEMPERATURE_LEVEL_4</entry>
749
750 <entry>ON</entry>
751
752 <entry>FOREGROUND</entry>
753 </row>
754
755 <row>
756 <entry>STATION HEIGHT</entry>
757
758 <entry>OBS_STATION_HEIGHT</entry>
759
760 <entry>ON</entry>
761
762 <entry>FOREGROUND</entry>
763 </row>
764 </tbody>
765 </tgroup>
766 </table>
767
768
769 <para></para>
770 </section>
771
772 <section id="Observation_Type_DRIBU">
773 <title>Observation Type DRIBU</title>
774
775 <para>DRIBU observations are all drifting observation stations,
776 including BATHY and TESAC. The format for plotting layout for DRIBU
777 observations is as follows :</para>
778
779
780 <para>The meteorological variables plotted, together with the
781 corresponding <productname>Magics</productname> parameters and their
782 default colour and status (on or off) are listed below. Please note
783 that a triangle is plotted as the station ring for DRIBU.</para>
784
785 <table id="table_DRIBU">
786 <title>Magics parameters for DRIBU observations</title>
787
788 <tgroup cols="4">
789 <colspec colwidth="1.2*" />
790 <colspec colwidth="1.2*" />
791 <colspec colwidth="0.3*" />
792 <colspec colwidth="0.7*" />
793
794 <thead>
795 <row>
796 <entry>Meteorological Variable</entry>
797
798 <entry>Magics Parameter</entry>
799
800 <entry>Status</entry>
801
802 <entry>Default Colour</entry>
803 </row>
804 </thead>
805
806 <tbody>
807 <row>
808 <entry>STATION RING (O)</entry>
809
810 <entry>OBS_STATION_RING</entry>
811
812 <entry>ON</entry>
813
814 <entry>FOREGROUND</entry>
815 </row>
816
817 <row>
818 <entry>STATION IDENTIFICATION (IDEN)</entry>
819
820 <entry>OBS_IDENTIFICATION</entry>
821
822 <entry>OFF</entry>
823
824 <entry>FOREGROUND</entry>
825 </row>
826
827 <row>
828 <entry>WIND SPEED AND DIRECTION</entry>
829
830 <entry>OBS_WIND</entry>
831
832 <entry>ON</entry>
833
834 <entry>FOREGROUND</entry>
835 </row>
836
837 <row>
838 <entry>MSL PRESSURE (PPP)</entry>
839
840 <entry>OBS_PRESSURE</entry>
841
842 <entry>ON</entry>
843
844 <entry>FOREGROUND</entry>
845 </row>
846
847 <row>
848 <entry>AIR TEMPERATURE (TT)</entry>
849
850 <entry>OBS_TEMPERATURE</entry>
851
852 <entry>ON</entry>
853
854 <entry>FOREGROUND</entry>
855 </row>
856
857 <row>
858 <entry>SEA SURFACE TEMPERATURE (TsTs)</entry>
859
860 <entry>OBS_SEA_SURFACE_TEMPERATURE</entry>
861
862 <entry>ON</entry>
863
864 <entry>FOREGROUND</entry>
865 </row>
866
867 <row>
868 <entry>OBSERVATION TIME (TIME)</entry>
869
870 <entry>OBS_TIME_PLOT</entry>
871
872 <entry>OFF</entry>
873
874 <entry>FOREGROUND</entry>
875 </row>
876 </tbody>
877 </tgroup>
878 </table>
879 </section>
880
881 <section id="Upper_Air_Observations">
882 <title>Upper Air Observations</title>
883
884 <para>The full standard layout used for plotting upper air
885 observations is as follows:</para>
886
887 <para>For all upper air plotting, except SATEM, the above layout is
888 used and the spaces not used are left blank. However, as none of the
889 upper air observation types uses the full plotting layout, the station
890 identification (IDEN ) is moved, automatically, nearer to the centre
891 of the observation when the dewpoint (TdTd ) and/or the sea surface
892 temperature (TsTs ) are not plotted.</para>
893
894 <para>Users may select the pressure level for which observations are
895 to be plotted by setting the parameter
896 <parameter>OBS_LEVEL</parameter> to the required level in hPa (default
897 value for <parameter>OBS_LEVEL</parameter> is <code>500</code>
898 hPa).</para>
899
900 <para>Off-level plotting may be achieved by setting the parameter
901 <parameter>OBS_LEVEL_TOLERANCE</parameter> to a value, above and below
902 <parameter>OBS_LEVEL</parameter>, for which observations are to be
903 plotted. The value set must be in hPa and the default is
904 <code>0</code>.</para>
905
906 <para>If the thickness between two levels is required,
907 <parameter>OBS_LEVEL</parameter> should be set to one of the required
908 levels, <parameter>OBS_LEVEL_2</parameter> should be set to the other
909 level and <parameter>OBS_THICKNESS</parameter> should be set to
910 '<code>ON</code>'.</para>
911
912 <section id="Exception_to_Standard_Upper_Air">
913 <title>Exception to Standard</title>
914
915 <para><remark>From the above diagram, it is obvious that t</remark>There is no place
916 for pressure plotting. In some cases (e.g. TEMP, PILOT) there may be
917 no need to plot the pressure as the user will know that all the
918 observation are at a certain pressure level
919 (<productname>Magics</productname> parameter
920 <parameter>OBS_LEVEL</parameter> controls the pressure level).
921 However for reports such as AIREP and SATOB , there are no
922 'standard' pressure levels and it is probably desirable to plot the
923 pressure level for each report. It is also probably desirable to
924 plot the two pressure levels for TOVS , SATEMS etc. A
925 <productname>Magics</productname> parameter
926 <parameter>OBS_UPPER_AIR_PRESSURE</parameter> exists to control the
927 plotting of upper air pressure for all the upper air observations.
928 The valid values for this parameter are '<code>ON</code>'
929 /'<code>OFF</code>', the default being '<code>OFF</code>'. If set to
930 '<code>ON</code>', the pressure will be plotted as follows:</para>
931
932 <para><code>TEMP, PILOT, SATOB, AIREP</code></para>
933
934 <para>IF HHH is to be plotted, The pressure will be plotted
935 immediately above HHH . If HHH is not to be plotted the pressure
936 will be plotted instead of and in the position of HHH . The pressure
937 will always be in round brackets to distinguish it from HHH , i.e.
938 (PPP ). Examples:</para>
939
940 <para>Pressure and Height plotted:</para>
941
942 <highlights>
943 <para>FM Diagram</para>
944 </highlights>
945
946 <para>Pressure but not Height plotted:</para>
947
948 <highlights>
949 <para>FM Diagram</para>
950 </highlights>
951
952 <para>SATEM, TOVS</para>
953
954 <para>Two pressure levels will be plotted, one replacing HHH and the
955 other (PPP2 ) replacing, or above, TT in the above diagram. The
956 pressure will always be plotted in round brackets. Examples :</para>
957
958 <para>Pressure levels with Temperature:</para>
959
960 <highlights>
961 <para>FM Diagram</para>
962 </highlights>
963
964 <para>Pressure levels without Temperature:</para>
965
966 <highlights>
967 <para>FM Diagram</para>
968 </highlights>
969
970 <highlights>
971 <para>Diagram 8</para>
972 </highlights>
973 </section>
974 </section>
975
976 <section>
977 <title>Observation Type AIREP</title>
978
979 <para>AIREP observations are all observations from aircraft, including
980 CODAR and COLBA. Following is the format for plotting AIREP
981 observations. Note the position of the station identification, due to
982 the fact that dewpoint and sea surface temperature are not
983 plotted.</para>
984
985 <highlights>
986 <para>FM Diagram</para>
987 </highlights>
988
989 <para>The meteorological variables plotted, together with the
990 corresponding <productname>Magics</productname> parameters and their
991 default colour and status (on or off) are listed below.</para>
992
993 <para><table id="table_AIREP">
994 <title>Magics parameters for AIREP observations</title>
995
996 <tgroup cols="4">
997 <colspec colwidth="1.2*" />
998 <colspec colwidth="1.2*" />
999 <colspec colwidth="0.3*" />
1000 <colspec colwidth="0.7*" />
1001
1002 <thead>
1003 <row>
1004 <entry>Meteorological Variable</entry>
1005
1006 <entry>Magics Parameter</entry>
1007
1008 <entry>Status</entry>
1009
1010 <entry>Default Colour</entry>
1011 </row>
1012 </thead>
1013
1014 <tbody>
1015 <row>
1016 <entry>STATION RING (O)</entry>
1017
1018 <entry>OBS_STATION_RING</entry>
1019
1020 <entry>ON</entry>
1021
1022 <entry>FOREGROUND</entry>
1023 </row>
1024
1025 <row>
1026 <entry>STATION IDENTIFICATION (IDEN)</entry>
1027
1028 <entry>OBS_IDENTIFICATION</entry>
1029
1030 <entry>OFF</entry>
1031
1032 <entry>FOREGROUND</entry>
1033 </row>
1034
1035 <row>
1036 <entry>WIND SPEED AND DIRECTION</entry>
1037
1038 <entry>OBS_WIND</entry>
1039
1040 <entry>ON</entry>
1041
1042 <entry>FOREGROUND</entry>
1043 </row>
1044
1045 <row>
1046 <entry>PRESSURE LEVEL(PPP)</entry>
1047
1048 <entry>OBS_UPPER_AIR_PRESSURE</entry>
1049
1050 <entry>ON</entry>
1051
1052 <entry>FOREGROUND</entry>
1053 </row>
1054
1055 <row>
1056 <entry>TEMPERATURE (TT)</entry>
1057
1058 <entry>OBS_TEMPERATURE</entry>
1059
1060 <entry>ON</entry>
1061
1062 <entry>FOREGROUND</entry>
1063 </row>
1064
1065 <row>
1066 <entry>OBSERVATION TIME (TIME)</entry>
1067
1068 <entry>OBS_TIME_PLOT</entry>
1069
1070 <entry>OFF</entry>
1071
1072 <entry>FOREGROUND</entry>
1073 </row>
1074 </tbody>
1075 </tgroup>
1076 </table></para>
1077 </section>
1078
1079 <section>
1080 <title>Observation Type SATOB</title>
1081
1082 <para>SATOB are reports from satellites of wind, surface temperature,
1083 clouds and radiation. Following is the format or plotting layout for
1084 SATOB observations:</para>
1085
1086 <highlights>
1087 <para>FM Diagram</para>
1088 </highlights>
1089
1090 <para>The meteorological variables plotted, together with the
1091 corresponding <productname>Magics</productname> parameters and their
1092 default colour and status (ON or OFF) are listed below.</para>
1093
1094 <para><table id="table_SATOB">
1095 <title>Magics parameters for SATOB observations</title>
1096
1097 <tgroup cols="4">
1098 <colspec colwidth="1.2*" />
1099 <colspec colwidth="1.2*" />
1100 <colspec colwidth="0.3*" />
1101 <colspec colwidth="0.7*" />
1102
1103 <thead>
1104 <row>
1105 <entry>Meteorological Variable</entry>
1106
1107 <entry>Magics Parameter</entry>
1108
1109 <entry>Status</entry>
1110
1111 <entry>Default Colour</entry>
1112 </row>
1113 </thead>
1114
1115 <tbody>
1116 <row>
1117 <entry>STATION RING (O)</entry>
1118
1119 <entry>OBS_STATION_RING</entry>
1120
1121 <entry>ON</entry>
1122
1123 <entry>FOREGROUND</entry>
1124 </row>
1125
1126 <row>
1127 <entry>STATION IDENTIFICATION (IDEN)</entry>
1128
1129 <entry>OBS_IDENTIFICATION</entry>
1130
1131 <entry>OFF</entry>
1132
1133 <entry>FOREGROUND</entry>
1134 </row>
1135
1136 <row>
1137 <entry>WIND SPEED AND DIRECTION</entry>
1138
1139 <entry>OBS_WIND</entry>
1140
1141 <entry>ON</entry>
1142
1143 <entry>FOREGROUND</entry>
1144 </row>
1145
1146 <row>
1147 <entry>PRESSURE LEVEL(PPP)</entry>
1148
1149 <entry>OBS_UPPER_AIR_PRESSURE</entry>
1150
1151 <entry>OFF</entry>
1152
1153 <entry>FOREGROUND</entry>
1154 </row>
1155
1156 <row>
1157 <entry>CLOUD TEMPERATURE (TT)</entry>
1158
1159 <entry>OBS_TEMPERATURE</entry>
1160
1161 <entry>ON</entry>
1162
1163 <entry>FOREGROUND</entry>
1164 </row>
1165
1166 <row>
1167 <entry>SEA SURFACE TEMPERATURE (TsTs)</entry>
1168
1169 <entry>OBS_SEA_SURFACE_TEMPERATURE</entry>
1170
1171 <entry>ON</entry>
1172
1173 <entry>FOREGROUND</entry>
1174 </row>
1175
1176 <row>
1177 <entry>OBSERVATION TIME (TIME)</entry>
1178
1179 <entry>OBS_TIME_PLOT</entry>
1180
1181 <entry>OFF</entry>
1182
1183 <entry>FOREGROUND</entry>
1184 </row>
1185 </tbody>
1186 </tgroup>
1187 </table></para>
1188
1189 <highlights>
1190 <para>Diagrams 9, 10, 11</para>
1191 </highlights>
1192 </section>
1193
1194 <section>
1195 <title>Observation Type TEMP</title>
1196
1197 <para>TEMP observations are all Radio Sonde observations, including
1198 TEMPSHIP. Following is the format or plotting layout for TEMP
1199 observations:</para>
1200
1201 <highlights>
1202 <para>FM Diagram</para>
1203 </highlights>
1204
1205 <para>The meteorological variables plotted, together with the
1206 corresponding <productname>Magics</productname> parameters and their
1207 default colour and status (ON or OFF ) are listed below.</para>
1208
1209 <para><table id="table_TEMP">
1210 <title>Magics parameters for TEMP observations</title>
1211
1212 <tgroup cols="4">
1213 <colspec colwidth="1.2*" />
1214 <colspec colwidth="1.2*" />
1215 <colspec colwidth="0.3*" />
1216 <colspec colwidth="0.7*" />
1217
1218 <thead>
1219 <row>
1220 <entry>Meteorological Variable</entry>
1221
1222 <entry>Magics Parameter</entry>
1223
1224 <entry>Status</entry>
1225
1226 <entry>Default Colour</entry>
1227 </row>
1228 </thead>
1229
1230 <tbody>
1231 <row>
1232 <entry>STATION RING (O)</entry>
1233
1234 <entry>OBS_STATION_RING</entry>
1235
1236 <entry>ON</entry>
1237
1238 <entry>FOREGROUND</entry>
1239 </row>
1240
1241 <row>
1242 <entry>STATION IDENTIFICATION (IDEN)</entry>
1243
1244 <entry>OBS_IDENTIFICATION</entry>
1245
1246 <entry>OFF</entry>
1247
1248 <entry>FOREGROUND</entry>
1249 </row>
1250
1251 <row>
1252 <entry>WIND SPEED AND DIRECTION</entry>
1253
1254 <entry>OBS_WIND</entry>
1255
1256 <entry>ON</entry>
1257
1258 <entry>FOREGROUND</entry>
1259 </row>
1260
1261 <row>
1262 <entry>PRESSURE LEVEL(PPP)</entry>
1263
1264 <entry>OBS_UPPER_AIR_PRESSURE</entry>
1265
1266 <entry>OFF</entry>
1267
1268 <entry>FOREGROUND</entry>
1269 </row>
1270
1271 <row>
1272 <entry>TEMPERATURE (TT)</entry>
1273
1274 <entry>OBS_TEMPERATURE</entry>
1275
1276 <entry>ON</entry>
1277
1278 <entry>FOREGROUND</entry>
1279 </row>
1280
1281 <row>
1282 <entry>DEWPOINT (TdTd)</entry>
1283
1284 <entry>OBS_DEWPOINT</entry>
1285
1286 <entry>ON</entry>
1287
1288 <entry>RED</entry>
1289 </row>
1290
1291 <row>
1292 <entry>TEMPERATURE (TT)</entry>
1293
1294 <entry>OBS_TEMPERATURE</entry>
1295
1296 <entry>ON</entry>
1297
1298 <entry>FOREGROUND</entry>
1299 </row>
1300
1301 <row>
1302 <entry>GEOPOTENTIAL (HHH)</entry>
1303
1304 <entry>OBS_HEIGHT</entry>
1305
1306 <entry>ON</entry>
1307
1308 <entry>FOREGROUND</entry>
1309 </row>
1310
1311 <row>
1312 <entry>THICKNESS BETWEEN OBS_LEVEL AND OBS_LEVEL2
1313 (THK)</entry>
1314
1315 <entry>OBS_THICKNESS</entry>
1316
1317 <entry>OFF</entry>
1318
1319 <entry>FOREGROUND</entry>
1320 </row>
1321
1322 <row>
1323 <entry>THETA VALUE (THE)</entry>
1324
1325 <entry>OBS_THETA</entry>
1326
1327 <entry>ON</entry>
1328
1329 <entry>FOREGROUND</entry>
1330 </row>
1331
1332 <row>
1333 <entry>OBSERVATION TIME (TIME)</entry>
1334
1335 <entry>OBS_TIME_PLOT</entry>
1336
1337 <entry>OFF</entry>
1338
1339 <entry>FOREGROUND</entry>
1340 </row>
1341
1342 <row>
1343 <entry>THERMAL WIND</entry>
1344
1345 <entry>OBS_THERMAL_WIND</entry>
1346
1347 <entry>OFF</entry>
1348
1349 <entry>FOREGROUND</entry>
1350 </row>
1351 </tbody>
1352 </tgroup>
1353 </table>The height of the pressure level (HHH) is plotted in
1354 decametres.</para>
1355
1356 <section>
1357 <title>Observation Theta</title>
1358
1359 <para>The parameter <parameter>OBS_THETA</parameter>, plotted by
1360 TEMP observations, may be used to plot one of several derived
1361 values, e.g. relative humidity, potential temperature.</para>
1362
1363 <para>The parameter <parameter>OBS_THETA_TYPE</parameter> may be set
1364 to the derived value required, e.g.</para>
1365
1366 <programlisting> CALL <function>PSETC</function> ('<parameter>OBS_THETA_TYPE</parameter>','POTENTIAL_TEMPERATURE')</programlisting>
1367
1368 <para>The default value for this parameter is
1369 '<code>RELATIVE_HUMIDITY</code>'.</para>
1370
1371 <highlights>
1372 <para>Diagram 12</para>
1373 </highlights>
1374 </section>
1375 </section>
1376
1377 <section>
1378 <title>Observation Type PILOT</title>
1379
1380 <para>PILOT observations are all upper wind observations from land and
1381 sea stations. Following is the format or plotting layout for PILOT
1382 observations:</para>
1383
1384 <highlights>
1385 <para>FM Diagram</para>
1386 </highlights>
1387
1388 <para>The meteorological variables plotted, together with the
1389 corresponding Magics parameters and their default colour and status
1390 (on or off) are listed below.</para>
1391
1392 <para><table id="table_PILOT">
1393 <title>Magics parameters for PILOT observations</title>
1394
1395 <tgroup cols="4">
1396 <colspec colwidth="1.2*" />
1397 <colspec colwidth="1.2*" />
1398 <colspec colwidth="0.3*" />
1399 <colspec colwidth="0.7*" />
1400
1401 <thead>
1402 <row>
1403 <entry>Meteorological Variable</entry>
1404
1405 <entry>Magics Parameter</entry>
1406
1407 <entry>Status</entry>
1408
1409 <entry>Default Colour</entry>
1410 </row>
1411 </thead>
1412
1413 <tbody>
1414 <row>
1415 <entry>STATION RING (O)</entry>
1416
1417 <entry>OBS_STATION_RING</entry>
1418
1419 <entry>ON</entry>
1420
1421 <entry>FOREGROUND</entry>
1422 </row>
1423
1424 <row>
1425 <entry>STATION IDENTIFICATION (IDEN)</entry>
1426
1427 <entry>OBS_IDENTIFICATION</entry>
1428
1429 <entry>OFF</entry>
1430
1431 <entry>FOREGROUND</entry>
1432 </row>
1433
1434 <row>
1435 <entry>WIND SPEED AND DIRECTION</entry>
1436
1437 <entry>OBS_WIND</entry>
1438
1439 <entry>ON</entry>
1440
1441 <entry>FOREGROUND</entry>
1442 </row>
1443
1444 <row>
1445 <entry>PRESSURE LEVEL(PPP)</entry>
1446
1447 <entry>OBS_UPPER_AIR_PRESSURE</entry>
1448
1449 <entry>OFF</entry>
1450
1451 <entry>FOREGROUND</entry>
1452 </row>
1453
1454 <row>
1455 <entry>GEOPOTENTIAL (HHH)</entry>
1456
1457 <entry>OBS_HEIGHT</entry>
1458
1459 <entry>ON</entry>
1460
1461 <entry>FOREGROUND</entry>
1462 </row>
1463
1464 <row>
1465 <entry>OBSERVATION TIME (TIME)</entry>
1466
1467 <entry>OBS_TIME_PLOT</entry>
1468
1469 <entry>OFF</entry>
1470
1471 <entry>FOREGROUND</entry>
1472 </row>
1473
1474 <row>
1475 <entry>THERMAL WIND</entry>
1476
1477 <entry>OBS_THERMAL_WIND</entry>
1478
1479 <entry>OFF</entry>
1480
1481 <entry>FOREGROUND</entry>
1482 </row>
1483 </tbody>
1484 </tgroup>
1485 </table></para>
1486
1487 <section>
1488 <title>Thermal Wind</title>
1489
1490 <para>It is possible to plot the thermal wind for a layer in the
1491 atmosphere when plotting TEMP and PILOT observations. As for
1492 thickness, the thermal wind may be plotted for the layer between
1493 <parameter>OBS_LEVEL_2</parameter> and
1494 <parameter>OBS_LEVEL</parameter>. To plot the thermal wind, the
1495 parameter <parameter>OBS_THERMAL_WIND</parameter> should be set to
1496 '<code>ON</code>', the default being '<code>OFF</code>'. The
1497 parameter <parameter>OBS_THERMAL_WIND_LINE_STYLE</parameter> allows
1498 the user to define the line style for plotting the thermal wind.
1499 Valid values are <code>SOLID</code>, <code>DOT</code> and
1500 <code>DASH</code> (default and WMO standard).</para>
1501
1502 <highlights>
1503 <para>Diagram 13</para>
1504 </highlights>
1505 </section>
1506 </section>
1507
1508 <section>
1509 <title>Observation Type SATEM</title>
1510
1511 <para>SATEM observations are all reports of satellite remote upper air
1512 soundings of pressure, temperature and humidity, including TOVS and
1513 PAOBS. Following is the format or plotting layout for SATEM
1514 observations:</para>
1515
1516 <highlights>
1517 <para>FM Diagram</para>
1518 </highlights>
1519
1520 <para>The meteorological variables plotted, together with the
1521 corresponding <productname>Magics</productname> parameters and their
1522 default colour and status (ON or OFF) are listed below.</para>
1523
1524 <para><table id="table_SATEM">
1525 <title>Magics parameters for SATEM observations</title>
1526
1527 <tgroup cols="4">
1528 <colspec colwidth="1.2*" />
1529 <colspec colwidth="1.2*" />
1530 <colspec colwidth="0.3*" />
1531 <colspec colwidth="0.7*" />
1532
1533 <thead>
1534 <row>
1535 <entry>Meteorological Variable</entry>
1536
1537 <entry>Magics Parameter</entry>
1538
1539 <entry>Status</entry>
1540
1541 <entry>Default Colour</entry>
1542 </row>
1543 </thead>
1544
1545 <tbody>
1546 <row>
1547 <entry>STATION RING (O)</entry>
1548
1549 <entry>OBS_STATION_RING</entry>
1550
1551 <entry>ON</entry>
1552
1553 <entry>FOREGROUND</entry>
1554 </row>
1555
1556 <row>
1557 <entry>STATION IDENTIFICATION (IDEN)</entry>
1558
1559 <entry>OBS_IDENTIFICATION</entry>
1560
1561 <entry>OFF</entry>
1562
1563 <entry>FOREGROUND</entry>
1564 </row>
1565
1566 <row>
1567 <entry>PRESSURE LEVELS (LEV1, LEV2)</entry>
1568
1569 <entry>OBS_UPPER_AIR_PRESSURE</entry>
1570
1571 <entry>OFF</entry>
1572
1573 <entry>FOREGROUND</entry>
1574 </row>
1575
1576 <row>
1577 <entry>THICKNESS BETWEEN OBS_LEVEL AND OBS_LEVEL2
1578 (THK)</entry>
1579
1580 <entry>OBS_THICKNESS</entry>
1581
1582 <entry>OFF</entry>
1583
1584 <entry>FOREGROUND</entry>
1585 </row>
1586
1587 <row>
1588 <entry>SURFACE TEMPERATURE (TsTs)</entry>
1589
1590 <entry>OBS_SEA_SURFACE_TEMPERATURE</entry>
1591
1592 <entry>OFF</entry>
1593
1594 <entry>FOREGROUND</entry>
1595 </row>
1596
1597 <row>
1598 <entry>WATER PRECIPITABLE (WAP)</entry>
1599
1600 <entry>OBS_WATER_PRECIPITABLE</entry>
1601
1602 <entry>OFF</entry>
1603
1604 <entry>FOREGROUND</entry>
1605 </row>
1606
1607 <row>
1608 <entry>OBSERVATION TIME (TIME)</entry>
1609
1610 <entry>OBS_TIME_PLOT</entry>
1611
1612 <entry>OFF</entry>
1613
1614 <entry>FOREGROUND</entry>
1615 </row>
1616 </tbody>
1617 </tgroup>
1618 </table>Users may select the two pressure levels required by setting
1619 the parameters <parameter>OBS_LEVEL</parameter> and
1620 <parameter>OBS_LEVEL_2</parameter> to the required levels in hPa. The
1621 default values are 500 hPa for <parameter>OBS_LEVEL</parameter> and
1622 1000 hPa for <parameter>OBS_LEVEL_2</parameter>. Please note that, by
1623 default, the THICKNESS between the two selected levels will be
1624 plotted. However, if <parameter>OBS_SATEM_TEMPERATURE</parameter> is
1625 set '<code>ON</code>', the calculated mean temperature between the two
1626 levels will be plotted.</para>
1627
1628 <para>Cloud amount is also plotted inside the station ring. There are
1629 three values of cloud amount plotted: no cloud, partly cloudy or
1630 completely cloudy.</para>
1631
1632 <section>
1633 <title>Profiler Data</title>
1634
1635 <para>This consists of wind plotting at varying levels, the levels
1636 being measured in metres above the observing station. The
1637 <productname>Magics</productname> parameter
1638 <parameter>OBS_LEVEL</parameter> may be used to specify the required
1639 level, remembering that the level values increase as they rise above
1640 the station (pressure level values decrease). There is no need to
1641 specify anything extra; just pass the relevant file containing the
1642 PROFILER data.</para>
1643 </section>
1644 </section>
1645 </section>
1646 </section>
1647
1648 <section id="Obs_Programming_Tips">
1649 <title>Programming Tips</title>
1650
1651 <para>Action routine <function>POBS</function> must be called to plot
1652 observations.</para>
1653
1654 <para>Before plotting observations, the required page layout and mapping
1655 parameters should be set as usual and any relevant
1656 <productname>Magics</productname> observation parameters should be
1657 set.</para>
1658
1659 <para>It is possible to plot contours, winds fields and observations on
1660 the same subpage. The observations may be plotted before or after the
1661 contours or winds.</para>
1662
1663 <para>The observations on an input file may be of different observation
1664 types, e.g. SYNOPS, TEMPS, SATEMS, etc. There is no need to specify the
1665 observation type for plotting unless a specific type is required. By
1666 default, action routine <function>POBS</function> will plot all the
1667 observations on the input file regardless of observation type.</para>
1668
1669 <para>If specific observation types or code types are required, the user
1670 should set the appropriate parameters.</para>
1671
1672 <para>Some of the <productname>Magics</productname> observation parameters
1673 will only be used by <productname>Magics</productname> when they are set
1674 by the user. When any of the observation parameters are set, the value set
1675 will be used by <productname>Magics</productname> until changed or reset
1676 by the user.</para>
1677
1678 <para>To reset a parameter, users should use the routine
1679 <function>PRESET</function>, e.g.</para>
1680
1681 <programlisting> CALL <function>PRESET</function> ('<parameter>OBS_TYPE_LIST</parameter>')</programlisting>
1682
1683 <para><function>PRESET</function> has the dual function of replacing the
1684 current value of the parameter, if appropriate, with its default value and
1685 informing <productname>Magics</productname> that this parameter has not
1686 been set by the user.</para>
1687
1688 <para>It is possible to call <function>POBS</function> more than once
1689 using the same input file and plotting different observations each time.
1690 The input file will be rewound automatically each time
1691 <function>POBS</function> is called.</para>
1692 </section>
1693
1694 <section id="BUFR_Parameter_Tables">
1695 <title>BUFR Parameter Tables</title>
1696
1697 <para>To enable the decoding of observations coded in BUFR, it is
1698 necessary to have tables which describe the contents of the BUFR code,
1699 e.g. the names and units of parameters, reference values and scale
1700 factors. The "parameters", as understood in the BUFR context, include
1701 not just the meteorological variables, but also the location of the
1702 observation, block/station number, instrumentation etc. Each parameter
1703 is described by a descriptor, which is an integer number that uniquely
1704 identifies the parameter, e.g. Temperature, Pressure,
1705 latitude/longitude, block number. These BUFR tables are stored at an
1706 address defined by an environment variable (which is made known to
1707 <productname>Magics</productname> installers at the various sites). The
1708 tables are then used in the BUFR decoding part of
1709 <productname>Magics</productname> and their use is transparent to the
1710 user. There are standard descriptor numbers for each of the
1711 "parameters". It is possible to use local descriptor numbers instead of
1712 the standard ones and these local descriptors would be described in the
1713 BUFR tables.</para>
1714
1715 <section id="BUFR_Parameter_Lists">
1716 <title>BUFR Parameter Lists</title>
1717
1718 <para>To make it possible for <productname>Magics</productname> to be
1719 able to plot observations from BUFR code from varying originating
1720 centres, which may or may not use local descriptor numbers, it is
1721 necessary for <productname>Magics</productname> to be able to identify
1722 the descriptor numbers of the meteorological variables and those
1723 "parameters" that describe the position and time of the observation. To
1724 enable this for each originating centre, there are external files called
1725 BUFR Parameter Lists, where each file consists of a list of descriptors
1726 for the meteorological variables and the position and time "parameters".
1727 For each originating centre, these descriptor numbers should match those
1728 in the BUFR Tables described above.</para>
1729
1730 <para>There are two BUFR Parameter Lists for each originating centre,
1731 one for surface observations and one for upper air. Each list consists
1732 of entry lines, one entry line per meteorological variable or
1733 "parameter". An entry line consists of a descriptor number followed by
1734 an ampersand(&amp;) and then, optionally, text to describe the
1735 variable.</para>
1736
1737 <para><token>descriptor &amp; text describing the meteorological
1738 variable or "parameter"</token></para>
1739
1740 <para>For example, the first three lines of the upper air BUFR Parameter
1741 List should be as follows:</para>
1742
1743 <programlisting>
1744 11001 &amp; WIND DIRECTION
1745 11002 &amp; WIND SPEED
1746 10195 &amp; HEIGHT in mtrs</programlisting>
1747
1748 <para>The position of the line in the list, not the text, is what
1749 actually defines the meteorological variable, e.g. the first entry line
1750 in the upper air BUFR Parameter Table is always the entry for Wind
1751 Direction, the second Wind Speed and the third Height. It is necessary
1752 to include each entry line in the file, even if they are not to be used.
1753 Complete lists for upper air and surface are given below.</para>
1754 </section>
1755
1756 <section id="Accessing_BUFR_Parameter_Lists">
1757 <title>Accessing BUFR Parameter Lists</title>
1758
1759 <para>There are two modes of accessing the BUFR Parameter Lists in
1760 <productname>Magics</productname>. By default, the lists are stored at
1761 an address path controlled by an environment variable, which is made
1762 known to installers at the various sites. The other mode of access is by
1763 setting a <productname>Magics</productname> parameter,
1764 <parameter>BUFR_PARAM_LIST_ADDRESS_PATH</parameter>, to the address path
1765 of the tables. This means that users can then use their own lists. Each
1766 upper air list name should have the format <token>bufrtab_ua_nn</token>
1767 (surface lists should have the format bufrtab_surf_nn) where nn is the
1768 number of the originating Centre of the BUFR data, e.g. 98 for ECMWF, 85
1769 for France.</para>
1770 </section>
1771
1772 <section id="Surface_BUFR_Parameter_List">
1773 <title>Surface BUFR Parameter List</title>
1774
1775 <para>The ECMWF BUFR Parameter List for surface data,
1776 <token>bufrtab_surf_98</token> is as follows (38 lines):</para>
1777
1778 <programlisting>11011 &amp; WIND DIRECTION at 10 m
1779 11012 &amp; WIND SPEED at 10m
1780 20001 &amp; HORIZONTAL VISIBILITY
1781 20003 &amp; PRESENT WEATHER
1782 12004 &amp; TEMPERATURE at 2m
1783 20012 &amp; MEDIUM CLOUD
1784 20012 &amp; HIGH CLOUD
1785 10051 &amp; MSL PRESSURE
1786 10063 &amp; PRESSURE TENDENCY CHARACTERISTIC(a)
1787 10061 &amp; PRESSURE TENDENCY AMOUNT (pp)
1788 20004 &amp; PAST WEATHER (1)
1789 20005 &amp; PAST WEATHER (2)
1790 20011 &amp; CLOUD AMOUNT (nh)
1791 20013 &amp; HEIGHT OF CLOUD BASE (h)
1792 20012 &amp; LOW CLOUD
1793 12006 &amp; DEWPOINT at 2m
1794 22042 &amp; SEA TEMPERATURE
1795 1012 &amp; SHIP'S DIRECTION
1796 1013 &amp; SHIP'S SPEED
1797 20010 &amp; TOTAL CLOUD
1798 22002 &amp; DIRECTION OF WIND WAVES
1799 22012 &amp; PERIOD OF WIND WAVES
1800 22022 &amp; HEIGHT OF WIND WAVES
1801 22003 &amp; DIRECTION OF SWELL WAVES
1802 22013 &amp; PERIOD OF SWELL WAVES
1803 22023 &amp; HEIGHT OF SWELL WAVES
1804 22001 &amp; DIRECTION OF WAVES
1805 22011 &amp; PERIOD OF WAVES
1806 20021 &amp; HEIGHT OF WAVES
1807 4004 &amp; HOUR
1808 4005 &amp; MINUTE
1809 5001 &amp; LATITUDE (HIGH ACCURACY)
1810 5002 &amp; LATITUDE (COARSE ACCURACY)
1811 6001 &amp; LONGITUDE (HIGH ACCURACY)
1812 6002 &amp; LONGITUDE (COARSE ACCURACY)
1813 7001 &amp; HEIGHT OF STATION in mtrs
1814 7061 &amp; DEPTH BELOW LAND SURFACE
1815 12030 &amp; SOIL TEMPERATURES</programlisting>
1816
1817 <para>To make local surface BUFR Parameter Lists, it is only necessary
1818 to copy the above ECMWF surface list to a new list (with an appropriate
1819 name) and change the descriptor numbers to the ones to be used locally.
1820 It is important that all the above lines are included in each list, even
1821 if they are not to be used in plotting.</para>
1822
1823 <para>The position and time "parameters" are only given in the surface
1824 list.</para>
1825 </section>
1826
1827 <section id="Upper_Air_BUFR_Parameter_List">
1828 <title>Upper Air BUFR Parameter List</title>
1829
1830 <para>Following is a listing of all the entries in the ECMWF BUFR
1831 Parameter List for upper air, <token>bufrtab_ua_98</token> (18
1832 lines):</para>
1833
1834 <programlisting>11001 &amp;WIND DIRECTION
1835 11002 &amp; WIND SPEED
1836 10195 &amp; HEIGHT in mtrs
1837 12003 &amp; DEW POINT TEMPERATURE
1838 12001 &amp; TEMPERATURE
1839 7004 &amp; PRESSURE level in pascals
1840 7006 &amp; HEIGHT ABOVE STATION in mtrs
1841 22042 &amp; SEA TEMPERATURE
1842 11003 &amp; U-COMPONENT
1843 11004 &amp; V-COMPONENT
1844 10003 &amp; HEIGHT in gp mtrs
1845 11192 &amp; U-COMPONENT at 10m
1846 11193 &amp; V-COMPONENT at 10m
1847 7002 &amp; ALTITUDE in mtrs
1848 12007 &amp; VIRTUAL TEMPERATURE
1849 13016 &amp; PRECIPITABLE WATER
1850 20010 &amp; TOTAL CLOUD
1851 10004 &amp; PRESSURE in pascals</programlisting>
1852
1853 <para>To make local upper air BUFR Parameter Lists, it is only necessary
1854 to copy the above ECMWF upper air list to a new list (with an
1855 appropriate name) and change the descriptor numbers to the ones to be
1856 used locally. It is important that all the above lines are included in
1857 each list, even if they are not to be used in plotting.</para>
1858 </section>
1859 </section>
1860
1861
1862 <xi:include href="../paramtables/pobs_tables.xml"
1863 xmlns:xi="http://www.w3.org/2001/XInclude" />
1864
1865 <section id="Observation Program_Examples">
1866 <title>Program Examples</title>
1867
1868 <para>These examples show some basic plots generated from observations. Please feel free to use these programs as basis for your own developments.
1869 </para>
1870 </section>
1871
1872 <xi:include href="../examples/manual/xml/obs_examples.xml"
1873 xmlns:xi="http://www.w3.org/2001/XInclude" />
1874
1875 </chapter>