Tsview command line options

-help

Gives a list of available options:

-count :N (only print N pulses)
-data (print data values)
-help (print this list and exit)
-length :N (max line length to use)
-skip :N (skip the first N pulses)
-verbose (print full header info) 
-noExit (do not exit when done) pathname 
(all other arguments ignored)

pathname

This is the directory and name of the TS file.

Before starting tsview, use the cd command to go to the directory where the archive files are located. This saves you from having to specify the full path and to allow the X-window center button and copy/paste technique to be used to avoid typing file names.

In the archive directory, use the ls command to view the files that you want by date and time using standard UNIX options for ls. The asterisk * is a wild card.

The file names are very long, so you do not want to type them. Instead, highlight the file name and click the middle button to copy the text to the terminal cursor location.

The file name format is designed to make it easy to identify TS files. In this example, we used a file with the name:

RVP10.20031208.192519.074.Ascope_DEFAULT.0.H.249

The file name format is:

site.YYMMDD.HHMMSS.SSS.taskname.sweep.polarization.maxrange

The fields are as follows:

site

Site name typed in the setup program on RVP10 that generated the data. site fields are preprocessed to remove characters that would mess up the filename, such as unprintable characters, space and /.

taskname

Identification of the application configuration that was operating when the TS data were collected. In the case of IRIS, it is the IRIS TASK name. In the case of the Ascope utility, it is set to ascope_<filename> where filename is the name of the saved ascope configuration that was used to collect the data (in the example, Ascope_DEFAULT). In the case of a custom user application, the user can specify an appropriate ID for the configuration so that it is archived appropriately. taskname fields are preprocessed to remove characters that would mess up the filename, such as unprintable characters, space and /.

sweep

A full 360° (or partial sector in sector mode) of data, typically collected at a fixed elevation angle. Most data acquisition software packages, such as IRIS, collect volume scan data this way. The sweeps are indexed 1, 2, 3, ... In the case where ascope is used for RVP10 operation, there is no concept of a sweep and the sweep number is set to 0. For RHI scanning, the concept of a sweep is the same, except that it is an elevation sweep rather than azimuth sweep.

polarization

This is the transmit polarization. There are four choices: H, V, H+V (simultaneous H and V transmit) and ALT (alternating H and V transmit).

-count:N

Each file consists of the IQ data for all range bins for each pulse in the sweep.

Use -count:N to define how many pulses to display.

In the example in the -data section, the count is set to 1, that is, only the information for one pulse is displayed.

-data

Use the –data option to see the IQ values for each range bin.

This example has the time series values for 400 bins for the 101st pulse:

$ tsview RVP10.20031208.192519.074* –count:1 –skip:100 –data Site:RVP8 
Pulse #101 at :19:25:19.406 8 DEC 2003 UTC, Az: 9.99, El:29.98 
0: (–91.2 ,244 ) (–91.2, 0) (–80.4,209) (–87.4,149) (–82.2,150) (–79.9, 95) 
6: (–84.2 ,157 ) (–81.4,182) (–81.6,100) (–83.8,276) (–79.2,331) (–83.9,220)
12: (–83.2 ,202 ) (–84.9, 53) (–78.7, 52) (–82.3,184) (–82.7,121) (–78.7,286)
. . .
390: (–90.2 ,244 ) (–83.5 ,228) (–83.7,264) (–86.4,181) (–85.4,182)  (–84.8,206)
396: (–84.5, 19) (–118,233) (–81.0 ,149) (–96.5,256) (–90.9,249) 
Bin 396 Bin 397 Bin 398 Bin 399 Bin 400 

The label on the left is the index number of the first range bin on the line. The numbers displayed are the power of the pulse in dBm and the angle in degrees of the IQ vector.

-length:N

The -length:N option allows you to specify the maximum number of characters to display under the –data option. In this example, the length is set to 43 characters.

$  tsview RVP8.20031208.192519.074* –count:1 –skip:1 00 –data
–length :43  Site:RVP10
Pulse #101 at :19:25:19.406 8 DEC 2003 UTC, Az: 9.99, El:29.98
0: (–91.2 ,244 ) (–91.2, 0) (–80.4,209)
3: (–87.4 ,149 ) (–82.2,150) (–79.9, 95) 

-skip:N

Use -skip:N to specify how many pulses to skip before starting the terminal listing. In this example, we wanted the 101st pulse, so we specified -skip:100.

-verbose

Use -verbose to see the detailed information contained in the headers. This was enabled in the example session. See Starting tsview sample session.