3 <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
4 <META NAME="GENERATOR" CONTENT="Mozilla/4.01b6C [en] (X11; I; Linux 2.0.28 i686) [Netscape]">
7 <A HREF="index.html"><IMG SRC="rsl.gif" HEIGHT=100 WIDTH=100></A><A HREF="index.html"> </A>
12 RSL_read_these_sweeps</H1>
17 <B>#include "rsl.h"</B>
18 <BR><B>void RSL_read_these_sweeps(char *sweep#, [char *sweep#...], NULL);</B>
23 Call this routine prior to any ingest routine and only the sweeps specified
24 will be stored in memory. This drastically reduces memory requirements
25 and speeds up the ingest, especially, if you're only interesed in a few
26 sweeps. This function is useful, for instance, when you're making
27 images of the base sweeps. Why bother reading the entire file when
28 you only need the first sweep? By default, all sweeps are ingested.
29 The sweep# is a character string representing the sweep number, "4" for
30 instance. Order does not matter. Specify NULL as the last argument.
31 This signals this routine when to stop parsing for sweep numbers.
32 The first sweep is "0".
34 <P>The list of possible sweep numbers is: "all", "none", "0", "1", ...
36 <P>Action or side-effects: A second call to this function over-rides any
37 previous settings. In other words, multiple calls are not additive.
38 Therefore, you must list all the sweeps you want in a single call.
40 <P>RSL_read_these_sweeps("1", "2", NULL);
42 <P>which reads the second and third sweep is not the same as:
44 <P>RSL_read_these_sweeps("1", NULL);
45 <BR>RSL_read_these_sweeps("2", NULL);
47 <P>wherein, only the third (index 2) sweep is ingested.
54 Upon successful completion, RSL_read_these_sweeps silently sets a hidden
55 array that each of the specific radar format ingest routines access.
60 <A HREF="RSL_anyformat_to_radar.html">RSL_anyformat_to_radar</A>.
62 <HR>Author: <A HREF="john.merritt.html">John H. Merritt</A>.