SatView Release 3.1 Notes


April 1994

This is the latest release of SatView. It is an X-window-based tool for viewing satellite images and weather data. To build it, type build in the top-level directory. The environment variable OPENWINHOME must be defined as the openwindows home directory. Usually, this is usr/openwin.

SatView requires XView to build. If you don't have XView, it is obtainable by anonymous ftp from expo.lcs.mit.edu in the/contrib directory.

SatView also requires NCAR graphics. For information on how to obtain a license, click here.

Depending on the version of NCAR graphics on your system, you may need to change the line

NCAR_LIBS = -lncarg -lncarg_loc -lncarg_gks -lncarg_c

in rel3.1/src/sv/Imakefile to

NCAR_LIBS = -lncarg -lncarg_loc -lncarg_gks

On BSD systems, you might need to remove the library -lintl from the line SYSLIBS = -lxview -lolgx -lX11 -lm -lintl

in rel3.1/src/util. Also, since the software is written in ANSI C, you may need to change the line

CC = cc

to

CC = acc

in the Imakefiles in rel3.1/src/*.

Make these changes before executing the 'build' script.

As a courtesy, the NETCDF source code is included in this release. SatView needs libnetcdf.a installed in order to build successfully. If this library is not already installed on your system, you will need to build and install it. To do so, enter configure from directory rel3.1/src/netcdf. Then enter make. The software will configure and build itself. Contact your system administrator about installing it in a public place.

SatView has been built on both BSD and SYSV Sun SPARCstations. Building on other architectures could be trickier.

If the top level directory is called rel3.1, the resulting directory structure will look like this after a successful build:

This release requires about 12 megabytes of disk space to build successfully. About 2.6 MB of this is taken up by the sample data files.

An ANSI C compiler is necessary to build SatView. An F77 compiler is needed as well.

The SatView executable file, as well a several utilities will reside in rel3.1/bin. Several libraries will be placed in rel3.1/lib. These include the libraries for creating and reading satellite image files and overlay files. rel3.1/data contains some sample data to help verify whether SatView is running properly. rel3.1/doc contains a PostScript version of the SatView user's manual, as well as man pages for utility programs and subroutines.

There are a few sample data files in rel3.1/data. GOES.1APR85.lw is a longwave satellite image file (along with the lat/lon file GOES.1APR85.ll). ECM.1APR85.100mb.temp is an ECMWF temperature overlay file. 94030712_eP.cdf is a NetCDF format pressure data file (useable as an example of the format which SatView expects). 94030712_eU.cdf and 94030712_eV.cdf contain the U and V components of vector data, also in NetCDF format.

There is a sample .satviewrc file in rel3.1. It was included to illustrate the user options of SatView. These options are discussed more fully in the user's manual.

rel3.1/src/examples contains several example programs to illustrate reading and writing SI format (SatView's data format) files from C or Fortran. Also see the manual for information on how to create data files in the correct format for SatView.

What's new in Release 3.1:

  1. SatView can use NetCDF format files for gridded (vector and scalar) data.
  2. SatView now lets you save your preferences interactively to the .satviewrc file, rather than editing your .Xresources file.
  3. It is now possible to highlight a number of different image values using the mouse and the color bar.
  4. You can add latitude, longitude and text labels to the map.
  5. Several new defaults/properties.
  6. Lots of bug fixes.

On DEC Alphas:

  1. You may have to set DEFINES=-DHAVE_PROTOTYPES in the Imakefiles for src/sv src/si and src/util. Then do a build from the top directory.
  2. You may have to pass the compiler the -DSYSV flag to get glob.c to compile (in src/si).

Questions and problems should be directed to satview@atmos.washington.edu. Please report any bugs you encounter.

Department of Atmospheric Sciences, AK-40
University of Washington
Seattle, Wash 98195