/usr/share/doc/grads/html/stnmap.html is in grads 3:2.1.0-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 | <!--Copyright (C) 1988-2005 by the Institute of Global Environment and Society (IGES). See file COPYRIGHT for more information.-->
<h2>stnmap</h2>
<code>stnmap [ -<i>i fname</i> ]</code><p>
<h3>Usage Notes</h3>
<code>stnmap</code> is a GrADS utility that writes out a hash
table
and/or link list information for station data that allows
GrADS to access the report data more efficiently.
<p>
If you change the data file - perhaps by appending another
time group - you will also have to change the descriptor
file to reflect the changes - the new number of times for
example - and then rerun the <code>stnmap</code> utility.
<p>
Note the difference between station descriptor file and a
grid descriptor file:<p>
<ul>
<code>DTYPE</code> specify a data
type of: station<p>
<code>STNMAP</code> gives the file
name of the station mapping file. <p>
<code>XDEF, YDEF, ZDEF</code> not
specified.<p>
<code>TDEF</code> describes the
time grouping interval and
the number of the time groups in the
file.<p>
<code>VAR</code> surface
variables must come first, and
are given a zero for the
number-of-levels field. Level dependent
variables are listed after the surface
variables, and are given a one in the
number-of-levels field.</ul><p>
<h3>Examples</h3>
When a data set, for example <code>ua.reps</code> is written, and
the
descriptor file <code>stat.ctl</code>, including the information
records
for the station data file <code>ua.reps</code> is created, you
should
then create the station map file <code>ua.map</code> (named in the
<code>STNMAP</code>
record of the descriptor file; see below) by running the
<code>stnmap</code> utility.<p>
Example descriptor file: <code>stat.ctl</code>
<ul>
<code>
DSET ^ua.reps<br>
DTYPE station<br>
STNMAP ^ua.map<br>
UNDEF -999.0<br>
TITLE Real Time Upper air obs<br>
TDEF 10 linear 12z18jan1992 12hr<br>
VARS 12<br>
slp 0 99 SLP<br>
ts 0 99 Temps<br>
us 0 99 U Winds<br>
vs 0 99 V Winds<br>
z 1 99 Heightsa<br>
t 1 99 Temps<br>
u 1 99 U Winds<br>
v 1 99 V WInds<br>
ENDVARS</code></ul><p>
Running the <code>stnmap</code> utility:<p>
<dd> <code>stnmap -i stat.ctl</code><p>
The station map file <code>ua.map</code> is a binary file, which
includes
the hash table and/or link list information.
|