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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
|
v1.42 (Released 7/12/2011)
This is the README file for the Radar Software Library (RSL).
The author of RSL is John H. Merritt.
RSL is maintained by Bart Kelley <Bartie.L.Kelley@nasa.gov>.
What is RSL?
This software manipulates NexRad, Lassen, UF, sigmet, kwajalein,
toga, RAPIC, RADTEC, mcgill and EDGE radar formats.
The radar data is used by the NASA TRMM Office to produce rain
and climatological products. This software
can ingest an entire input data file, representing it in RAM as it
is on disk, manipulate the data and produce simple images. The intent
of this library is to provide you with the tools to manipulate the
data. With those tools you gain easy access to the different radar
fields (reflectivity, velocity, spectral width, etc.) and ancilliary
information (headers: time, beam width, angles, etc). And, with the
tools you can code a scientific application that are radar format
independent.
COPYRIGHT NOTICE:
NASA/TRMM, Code 910.1.
This is the TRMM Office Radar Software Library.
Copyright (C) 1996-1999
John H. Merritt
SM&A Corp.
Vienna, Virginia
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
System Requirements:
Linux, Mac OS X 10.5.
Note: MS Windows is not supported.
Memory Requirements:
16 Mbytes of RAM just to ingest the data. Plus any for your application.
If you expect to use the TSDIS toolkit component, which requires the HDF
library, then you'll need at least 64 MB RAM!
Software Environment. Additional libraries may be needed for building
or linking, especially if you plan to use the TSDIS Toolkit and HDF.
All the source for wsr88d, lassen, tg, nsig, mcgill, kwajalein,
etc, are included in librsl.a and librsl.so. RSL works on big or
little endian machines. HP, SUN, SGI are examples of big endian machines.
Intel 386/486/Pentium is an example of a little endian machine.
Additional software needed for executing RSL code is listed below.
Note, RSL can be built without TSDIS toolkit and without HDF and
without PKWARE support.
pbmplus (Jef Poskanzer) Available via anon ftp to ftp.uu.net. This is
used when making GIF, PPM, PBM, PGM, PICT, etc.
images. Output via pipes. Required for executing
your RSL application, if you plan to output images.
This is not required when
linking your application with the RSL.
You only need ppmtogif and ppmtopict.
gcc (GNU cc compiler) Normal cc or acc (sun) will work. Not required,
but, you do need an ansi compilier.
gzip (GNU compress) Available via anon ftp to ftp.uu.net. Unpacking.
Input and output filters for auto un/compressing.
make (GNU make) GNU make version 3.76. Standard make on SGI
IRIX 6.2 doesn't work. It's a good idea
to have GNU make (GNU tar too).
PKWARE Data Version 1.11. Needed for the RAPIC ingest.
Compression library. Call PKWARE, Inc. at 414-354-8699 or via
http://www.pkware.com.
libetor The EDGE libraray to decode the EDGE format.
This is available from Enterprise Electronics
Corporation, Enterprise, Alabama, USA 36330
334-347-3478.
Example mainlines are provided in the directory examples.
INSTALLATION INSTRUCTIONS
--------------------------
1. Unpack the GNU compressed tar archive, example:
tar -xzf rsl-v1.29.tgz
-or-
zcat rsl-v1.29.tgz | tar xf -
2. If you DON'T want LASSEN capability or you find that your system
can not compile the lassen routines, you must edit acconfig.h and
change '#define HAVE_LASSEN 1' to '#undef HAVE_LASSEN'.
3. configure
make install -- Installs the RSL library, and then installs
any_to_gif and any_to_uf.
NOTE: You can specify the --prefix=/some/other/dir as an option to
the configure command. This will install the librsl.so there
and will install the examples there. Also, when resolving
whether you have hdf, tsdistk, etc. the --prefix instructs
configure to look in the prefix/lib directory for those libraries.
The examples installed are any_to_gif and any_to_uf.
BUILDING APPLICATIONS
---------------------
Place the following line in your C code:
#include "rsl.h"
And link your application with:
-lrsl -lm
If you're on a SUN, you might have to specify:
-lrsl -lnsl -lm
If you want HDF and TSDIS toolkit libraries (the link line looks messy):
setenv TSDISTK /usr/local/toolkit (or your top-level directory name)
-lrsl -L/usr/local/hdf/lib -L/usr/local/toolkit/lib \
-ltsdistk -lmfhdf -ldf -ljpeg -lz -lm
Be sure to substitute the appropriate -L specification for the HDF
and the TSDISTK library paths on your system.
PROBLEMS
--------
1. If you don't have ppmtogif nor ppmtopict, you can still make images. The
images will be PPM files. Create two commands called 'ppmtogif' and
'ppmtopict' that consists of the following two lines:
---- cut ----
#!/bin/csh -f
cat
---- cut ----
Make these new commands executable and
place them in a directory that is in your $PATH. No translation
of PPM will happen and you can use 'xv', for instance, to view
the files.
2. Linking on SUN running SunOS 5.4, you may need to add '-lnsl' to
the link line to link your application. 'libnsl.{a,so}' is where
the 'xdr' routines reside.
3. On our HP, gcc cannot build a shared library in one fell swoop. You
must use the '-v' option. You'll get an error similiar to that shown
in the following 'make' excerpt.
----- cut -----
gcc -v -shared -W1,-soname,librsl.so.1 -o librsl.so.1.17 rapic_to_radar.o rapic.tab.o lex.rapic.o rapic_routines.o radar.o volume.o image_gen.o cappi.o fraction.o read_write.o farea.o range.o radar_to_uf.o uf_to_radar.o lassen_to_radar.o wsr88d_to_radar.o carpi.o cube.o sort_rays.o toga_to_radar.o gts.o histogram.o ray_indexes.o anyformat_to_radar.o get_win.o endian.o mcgill_to_radar.o mcgill.o interp.o toga.o lassen.o wsr88d.o wsr88d_get_site.o gzip.o prune.o reverse.o fix_headers.o radar_to_hdf_1.o radar_to_hdf_2.o nsig_to_radar.o nsig.o nsig2_to_radar.o hdf_to_radar.o toolkit_memory_mgt.o africa_to_radar.o africa.o
Reading specs from /opt/hppd/lib/gcc/gcc-lib/hppa1.1-hp-hpux9.05/2.7.2.1/specs
gcc version 2.7.2.1
/opt/hppd/lib/gcc/gcc-lib/hppa1.1-hp-hpux9.05/2.7.2.1/ld -b -o librsl.so.1.17 -L/opt/hppd/lib/gcc/gcc-lib/hppa1.1-hp-hpux9.05/2.7.2.1 -L/opt/hppd/lib/gcc rapic_to_radar.o rapic.tab.o lex.rapic.o rapic_routines.o radar.o volume.o image_gen.o cappi.o fraction.o read_write.o farea.o range.o radar_to_uf.o uf_to_radar.o lassen_to_radar.o wsr88d_to_radar.o carpi.o cube.o sort_rays.o toga_to_radar.o gts.o histogram.o ray_indexes.o anyformat_to_radar.o get_win.o endian.o mcgill_to_radar.o mcgill.o interp.o toga.o lassen.o wsr88d.o wsr88d_get_site.o gzip.o prune.o reverse.o fix_headers.o radar_to_hdf_1.o radar_to_hdf_2.o nsig_to_radar.o nsig.o nsig2_to_radar.o hdf_to_radar.o toolkit_memory_mgt.o africa_to_radar.o africa.o
/bin/ld: DP-Relative Code in file /usr/tmp/cca11778.o - Shared Library must be Position-Independent
collect2: ld returned 1 exit status
make: *** [librsl.so.1.17] Error 1
----- cut -----
Take the 'ld' command that is shown, the second of the two commands,
and execute it directly at the Unix prompt. It will create the
shared library. I don't get it, but, it works. My guess is that
the 'gcc' command is doing something that is not shown. What is
shown are the correct commands. Go figure.
Contributions
-------------
Dave Wolff - Most of the specifications for the functionality and feedback
during debugging.
Mike Kolander - The HDF, Mcgill and kwaj to radar routines.
Alan McConnell - The toga_to_radar routine.
Dennis Flanigan - New sorting code. Echo top height routines. Vertical
structure code.
Thuy Nguyen - Bug fixes and testing.
Paul Kucera - Testing, bug reports and SIGMET code.
Michael Whimpy - BMRC, Austrailia. Lassen modifications.
Don Burrows - The edge_to_radar routine.
QUESTIONS
---------
Contact the TRMM Office help at help@radar.gsfc.nasa.gov
|
