]> Pileus Git - ~andy/rsl/blob - doc/whats_new.html
RSL v1.44
[~andy/rsl] / doc / whats_new.html
1 <!doctype html public "-//w3c//dtd html 4.0 transitional//en">
2 <html>
3 <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
5    <meta name="GENERATOR" content="Mozilla/4.7 [en] (X11; U; Linux 2.2.12 i686) [Netscape]">
6 </head>
7 <body>
8 <a href="index.html"><img SRC="rsl.gif" height=100 width=100></a>
9 <hr>
10 <br>&nbsp;
11 <br>&nbsp;
12 <h1>
13 What's new?</h1>
14
15 <h2> Version 1.44:</h2>
16 Mainly internal improvements. See <a href="../CHANGES">CHANGES</a>.
17 <h2> Version 1.43:</h2>
18 Mostly bug fixes.  See <a href="../CHANGES">CHANGES</a>.
19 <h2>
20 Version 1.42: Bug fix.</h2>
21 Changed scale_factor used for storing differential phase (PH) in UF from 100 to
22 10.  The usual scale factor of 100 caused values over 327.67 to become negative
23 when converted to short integer.
24 <h2>
25 Version 1.41 supports WSR-88D Level II Build 12 format.</h2>
26 <h2>
27 Version 1.39 supports WSR-88D Level II Build 10 format.</h2>
28 <h2>
29 Version 1.34 supports WSR-88D Level II Build 8 format.</h2>
30 RSL can read both the old and new WSR-88D Level II data format.
31 <h2>
32 Version 1.33 supports WSR-88D Level II Build 5 format.</h2>
33 RSL can read both the old and new WSR-88D Level II data format.
34
35 <h2>
36 Version 1.25 release (what's new since v1.24).</h2>
37 Merged changes from version 1.24.1.&nbsp; Also, HDF&nbsp;routines are back
38 as not having them in the library caused more problems than it was worth.&nbsp;
39 But, the most significant change is that the entire package is configured
40 by the <b>configure</b> script (provided).&nbsp; Building the package is
41 done in two steps.&nbsp; This is a dramatic improvment over previous releases.
42 <h2>
43 Version 1.24.1 release (what's new since v1.24).</h2>
44 Removed the HDF component.&nbsp; Those routines are now part of gvs, where
45 they belong.&nbsp; However, basic support in <a href="RSL_anyformat_to_radar.html">RSL_anyformat_to_radar</a>
46 will exist for HDF -- it will still recognize an HDF file and call
47 <a href="RSL_hdf_to_radar.html">RSL_hdf_to_radar</a>.&nbsp;
48 RSL_hdf_to_radar is located in gvs/gvslib.&nbsp; To configure HDF into
49 RSL, specify <b>-DHAVE_TSDIS_TOOLKIT</b> in the Makefile.
50 <p>Added project[24] to the <a href="RSL_radar_header_struct.html">radar->h</a>
51 structure.
52 <h2>
53 Version 1.23 release (what's new since v1.18).</h2>
54 RSL now accpets the EDGE format.&nbsp;
55 KDP definition changed.&nbsp; It now normalizes the value based on the
56 radar wavelength.&nbsp; A bug in the RADTEC ingest routine was removed.&nbsp;
57 Other than that, mostly bug fixes that were very minor.&nbsp; Added <a href="RSL_color_table.html">RSL_set_color_table</a>
58 and <a href="RSL_color_table.html">RSL_get_color_table</a>.&nbsp; These
59 routines permit better user control of the color table.
60 <h2>
61 Version 1.18 release (what's new since v1.15).</h2>
62 This version adds the RADTEC format ingest routine.&nbsp; See <a href="RSL_radtec_to_radar.html">RSL_radtec_to_radar</a>.&nbsp;
63 RADTEC requires the use of the PKWARE Data Compression Library, available
64 from PKWARE, Inc., http://www.pkware.com.&nbsp; Also made several minor
65 bug fixes and the image generation was enhanced to allow generation of
66 images out to the range specified.&nbsp; Previously,&nbsp; image pixels
67 were 1km, now they are range/radius.
68 <h2>
69 Version 1.15 release (what's new since v1.14).</h2>
70 This version&nbsp; adds&nbsp; the RAPIC format ingest routine.&nbsp; See
71 <a href="RSL_rapic_to_radar.html">RSL_rapic_to_radar</a>.&nbsp;
72 A data truncation bug was fixed in the UF ingest.&nbsp; This bug only affects
73 the velocity data.&nbsp; The Lassen ingest no longer depends on (radar->h.name),&nbsp;
74 for calibration of Gunn Point data.&nbsp; It is now done based on time
75 periods of the data.&nbsp; Please see the <a href="CHANGES">CHANGES</a>
76 file for more information.
77 <h2>
78 Version 1.14 release (what's new since v1.11).</h2>
79 This version continues the minor bug fixes to the HDF component.&nbsp;
80 Additionally, it includes calibration for the Gunn Point radar, in Lassen
81 format.&nbsp;&nbsp; The distinction of Gunn Point data from other lassen
82 data is done by assumming the radar name (radar->h.name) is 'Gunn_Pt'.&nbsp;
83 Please see the <a href="CHANGES">CHANGES</a> file for more information.
84 <h2>
85 Version 1.11 release (what's new since v1.8).</h2>
86 Version 1.9 represented a bug fix to the HDF component.&nbsp; Version 1.10
87 represented a minor
88 <br>upgrade, mostly to the HDF component, but, other areas were modified
89 and that's why it is called an upgrade rather than a bug fix.&nbsp; Version
90 1.11 represents a minor bug fix release from v1.10.&nbsp; It only affects
91 the
92 <br>HDF components.&nbsp;&nbsp; Please see the <a href="CHANGES">CHANGES</a>
93 file for more detailed information regarding what changed.
94 <p>In version 1.10, ZDR color tables were modifed and a first draft of
95 the South Africa data format ingest routine was added.
96 <br>&nbsp;
97 <h2>
98 Version 1.8 release (what's new since v1.7).</h2>
99 Added <a href="RSL_read_these_sweeps.html">RSL_read_these_sweeps</a>.&nbsp;
100 Specify specific sweep numbers for ingest.&nbsp; This drastically speeds
101 up ingest, if you're only interested in the first or first couple of sweeps.&nbsp;
102 For example, making base scans images.
103 <p>Added <a href="RSL_load_color_table.html">RSL_load_zdr_color_table</a>.
104 <p>More HDF mods; more warning messages.
105 <p>The TRMM Office has fixed several bugs in the TSDIS toolkit. For proper
106 HDF creation, that conforming to TSDIS HDF specifications, you will need
107 toolkit 4.5r1.1. Toolkit 4.5r1.1 is an unofficial release; the TRMM office
108 will pass this out upon request.
109 <br>&nbsp;
110 <h2>
111 Version 1.7 release (what's new since v1.6).</h2>
112 This version fixes the lat/lon signs.&nbsp; Also, lat/lon are added to
113 each ray for UF when extended headers are available in SIGMET files.&nbsp;
114 Also, the HDF component has changed.&nbsp; This affects RSL_radar_to_hdf
115 and RSL_hdf_to_radar.
116 <h2>
117 Version 1.6 release (what's new since v1.5).</h2>
118 This version of RSL will work with TSDIS toolkit 4.5r1.&nbsp; UF now has
119 lat/lon stored for each ray, suitable for moving platforms.&nbsp; Also,
120 the wsr88d code does not default to KMLB.
121 <h2>
122 Version 1.5 release (what's new since v1.4).</h2>
123 The HDF component has changed again. This version of RSL will work with
124 toolkit 4.0 or toolkit 4.0.1. Version 4.0.1 is an un-official release of
125 the TSDIS toolkit. This version removes the temporary files created during
126 level 1 processing. There was only one file that changed, the file may
127 be obtained from the TRMM Office, upon request.
128 <p>One minor consistancy check was added to the wsr88d ingest; it checks
129 that the number of bins in a ray is reasonable. This problem usually manifests
130 itself from bad input files.
131 <h2>
132 Version 1.4 release (what's new since v1.0).</h2>
133 The HDF component is in a state of flux. The <a href="http://tsdis/tsdis/tsdistk.html">TSDIS
134 toolkit</a> keeps changing -- the interface keeps changing. The TSDIS toolkit
135 is, in the TRMM Office opinion, not stable. Their latest release is 4.0
136 and it has fixed many problems. One minor problem remains for level 1 processing:
137 temporary config files are not removed when the toolkit is closed.
138 <p>RSL is incorporated into a larger package called GVBOX. The latest version
139 of GVBOX is 1.1. GVBOX is a complete ground validation system to generate
140 TRMM GV products on pentium PCs running Linux. GVBOX is available on CDROM.
141 <p>RSL is now LGPL-ed.
142 <p>Added the routine <a href="RSL_select_fields.html">RSL_select_fields</a>
143 to reduce memory requirements upon reading data. This works very nicely
144 for LASSEN data where the number of fields is large, however, only 2 or
145 3 are needed.
146 <h2>
147 Version 1.0 release (what's new since v0.45).</h2>
148 Version 1.0 marks the jump from the previous stable version, version 0.45.
149 A few very minor bugs were encountered and repaired. But, the bulk of this
150 transisition is improved documentation with the addition of a Users Guide.
151 Additionally, the SIGMET ingest was repaired and can now read version 2
152 files, HDF I/O was added and the LASSEN ingest modified to read version
153 1.4 files. Version 1.4 LASSEN files were used during the MCTEX experiment.
154 Other than that, no major modifications were made. Technically, version
155 1.0 is a minor upgrade to RSL 0.45. But, due to the witnessed stability
156 of RSL, it was decided to call it version 1.0.
157 <br>&nbsp;
158 <h2>
159 Can read compressed files automatically (new since v0.41)</h2>
160 Transparent, to all ingest routines the capability of filtering the input
161 data file through the GNU gzip program for decompressing the file has been
162 added. This feature does not appear to slow the I/O time and, in some cases,
163 especially on 486 pc's, improves overall throughput time. Two generic,
164 internal routines, have been added: <b>compress_pipe</b> and <b>uncompress_pipe</b>.
165 Each routine takes a <b>FILE *</b> and redirects it through <b>gzip</b>.
166 Each routine returns a new <b>FILE *</b>. Wsr88d files occupy 1/10 the
167 disk space when compressed and the TRMM Office plans to compress wsr88d
168 files to CDROM and 8mm tape for overall throughput savings for the production
169 system. It will no longer be necessary to decompress the data before processing
170 level 1.
171 <p>Similiarly, UF output can be saved using the gzip filter. The new routine
172 added is <a href="RSL_radar_to_uf.html">RSL_radar_to_uf_gzip</a> which
173 utilizes the gzip compression filter.
174 <h2>
175 Can read stdin (new since v0.39)</h2>
176 A new routine is provided called <a href="RSL_uf_to_radar.html">RSL_uf_to_radar_fp</a>
177 which takes an open file descriptor and returns a radar pointer. That file
178 pointer can be <b>stdin</b>. This special interface syntax, for the UF
179 ingest, is an exception to the interfaces that the other ingest routines
180 have. All other ingest routines, including <a href="RSL_uf_to_radar.html">RSL_uf_to_radar</a>,
181 have been modified to read stdin when the input filename is NULL. The complete
182 list of routines is: <a href="RSL_wsr88d_to_radar.html">RSL_wsr88d_to_radar</a>,
183 <a href="RSL_nsig_to_radar.html">RSL_nsig_to_radar</a>,
184 <a href="RSL_lassen_to_radar.html">RSL_lassen_to_radar</a>,
185 <a href="RSL_uf_to_radar.html">RSL_uf_to_radar</a>,
186 <a href="RSL_mcgill_to_radar.html">RSL_mcgill_to_radar</a>
187 and <a href="RSL_toga_to_radar.html">RSL_toga_to_radar</a>. The only routine
188 that will not accept stdin will be <a href="RSL_anyformat_to_radar.html">RSL_anyformat_to_radar</a>.
189 That routine will not be able to handle reading stdin because it needs
190 to read the first few bytes of the file to determine which ingest routine
191 to call. If you plan to make a filter program, you'll just have to know
192 what file format you expect: UF, nsig, wsr88d, etc.
193 <br>&nbsp;
194 <br>&nbsp;
195 </body>
196 </html>