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