Real-time Display

From CSU-CHILL

Revision as of 13:46, 9 August 2010 by Jgeorge (talk | contribs) (→‎Download and Install from CVS: Updated installation instructions)

The CHILL Engineering Display is a radar visualization tool, which allows the radar variables generated by the signal processor to be viewed in a variety of ways. The display communicates via the VCHILL protocol to the signal processor. Scan conversion of the incoming data from polar (r-θ) to Cartesian coordinates is done in software using an algorithm that is guaranteed to not generate "holes" in the display, while not producing overlap.

Main Window

The figure below shows the main control window of the display program. It lists all available fields from the moment server, along with their minimum and maximum values. PPI/RHI displays or A-scope windows can be launched from here.

Engineering Display Main Window

Display Windows

PPI Window

Engineering Display PPI Window

The Plan Position Indicator (PPI) display shows a range vs. azimuth display. Color values indicate the variable value at each point. The data is underlayed by a basemap, which indicates selected highways, geographic features, county lines, etc. Several basemaps are available, these may be picked from a webserver or from local disk files. Also shown is an overlay consisting of radials and range rings, along with an overlay map, indicating local landmarks such as towns and cities. Each of these features may be disabled or partially made transparent.

On the right side, an annotation pane is shown. This resizable pane shows operating statistics of the radar and the color scale. Important parameters such as polarization mode, transmitter power, date and time are shown here.

Along the bottom, the marker and cursor position and values are shown. The marker is positioned by clicking on the map. The cursor represents the value under the current mouse position. Also shown are the antenna position and the current scan name which the radar is executing.

Zooming is done by drawing a bandbox around the region to be zoomed. The display automatically picks the correct scale factor and center point to highlight the chosen area. The display center can also be set using the mouse. This allows the user to peruse the current scan as it arrives from the radar.

The display also shows a histogram of the values within the current display window. This may be used to get quick estimates of bias, etc.

RHI Window

Engineering Display RHI Window

The Range-Height Indicator (RHI) display shows the radar data in a range vs. height display. It is used when the radar executes vertical scans. Similar to the PPI mode, color indicates the variable value at that point. No base map is shown in this case, however, range rings and radials are shown as an overlay over the data.

Most features of the PPI display, such as zooming and panning are maintained in the RHI display. In addition, the height axis may be scaled differently from the range axis, this allows the vertical structure of storms to be more carefully examined. The height displayed is corrected for a curved earth model, and also takes into account the standard atmospheric model for height correction with range. If desired, this behavior may be turned off.

A-scope Window

Engineering Display Ascope Window

The A-scope shows a range profile of the selected variable from the signal processor. It is useful for measuring range trends. The a-scope has two operating modes, a realtime mode and a fixed mode. In realtime mode, the a-scope updates itself each time a new ray arrives from the signal processor. This gives a continuously updating waveform on screen, which is useful for diagnosis and when the antenna is in fixed-pointing mode. Unlike the standalone A-scope program, this program requires a functioning signal processor to function. It only sees the processed moments, and hence cannot display spectra of range gates, etc.

In the fixed mode, the display shows the range profile at the marker position on a corresponding PPI or RHI view. This allows range profiles at various locations to be examined.

The a-scope allows the user to zoom and pan the display using the mouse. Zooming is done by drawing a bandbox of the region to zoom. Once zoomed, the display scrollbars become active and allow the display to be panned in either axis.

A cursor and marker are available in the a-scope. The marker is synchronized with the marker in the PPI/RHI displays, and is shown on the a-scope as a dashed line. The cursor position is shown as a triangle with the corresponding range and value underneath. The value at the marker and cursor is shown on the status bar on the bottom of the a-scope.

Post processing options are available to the user in the form of smoothing. Three types of smoothing are available, as shown in the table below.

Method Features
None No smoothing applied
3x Averaging Average of current gate with adjacent ones
5x Averaging Average of gate with two adjacent ones
5x FIR A simple FIR filter is applied to the two gates surrounding each gate.
Post procssing modes in the A-scope Display

Smoothing options

The display program offers several modes to smooth the input data before display in the PPI and RHI modes. The options are listed in the table below.

Method Features
None No smoothing applied
1D Mean Pixel is average of adjacent range gates
2D Mean Pixel is average of adjacent range gates and azimuths
1D Median Pixel is the median of adjacent range gates
2D Median Pixel is the median of adjacent range gates and azimuths
Smoothing modes in the Engineering Display

The mean filters perform simple smoothing, they tend to reduce the variance of the fields due to averaging. They do not attenuate speckle noise seen due to interference, birds, aircraft, etc. Median filters are good at removing speckle noise, but do not reduce the variance as much as the mean filters.

Alpha Thresholding

Engineering Display Alpha Threshold Editor

The display program makes use of alpha-blending to implement thresholding. This means that the thresholding need not be an on-off action. Gradual slopes of any arbitrary shape can be programmed in through the alpha editor. Conventional thresholding can be emulated by drawing thresholding function in the alpha editor. This method of thresholding improves the visual quality of the result, since thresholded edges appear smoother than with conventional thresholding schemes.

Color Map Editor

Several color maps are available, these can be selected using the Color Map Editor. Each Color Map has several color tables which can be associated with a particular field. The field assignments are done in the Color Map Editor, while the color tables themselves are edited in the Color Table Editor.

Downloading

The display program may be downloaded and run from the CHILL CVS server by anonymous CVS. These are the procedures required to download and build the display.

Required Libraries

This section lists the libraries required to build the display program. Note that the steps given work only for distributions such as Fedora Core that use the Yellowdog Update Manager (YUM). Please refer to your Linux distribution's documentation for similar instructions for other distributions.

Installing gtk2 (windowing library), libgnomeui (application framework), libglade2 (UI creation)

# yum -y install gtk2-devel libgnomeui-devel libglade2-devel

Installing cURL (web download helper), gtkdatabox (visualization)

# yum -y install curl-devel gtkdatabox-devel

Required Tools

This is a list of tools required to build the software. Again, the install steps work only for YUM based distributions

gcc (C compiler), automake, libtoolize and autoconf (build tools)

# yum -y install gcc automake autoconf libtoolize

cvs (version control system)

# yum -y install cvs

Installation

The real-time display is a part of the CDP signal processing suite, which is available on request as a tarball or via git.

Using a tarball

Extract the tarball to a working directory.

$ tar zxf cdp.tar.gz

Change directories to the display program and execute the build steps.

$ cd cdp/gtk_display
$ ./autogen.sh
$ make

Installing the program (must be root for default install target, which is /usr/local)

# make install

Using git

Clone the cdp git repository to a working directory on your machine, by following the instructions here. The remaining steps should be the same as above.

Running the program

You can run the program from the working directory

$ cd cdp/gtk_display/src
$ ./gtk_display

Once the installation step described above is completed, you can run it from anywhere:

$ gtk_display

If installed as root, entries will be created under your window manager menus (if available). On Fedora and derived distributions, this is under Applications->Other->GTK Display.