This is version 3.3.11 xbrowse is an image browsing tool that works over the Internet. xbrowse uses progressive transmission to facilitate browsing large images over the limited bandwitdh supplied by the Internet. For more information see the xbrowse man page. In order to compile xbrowse, you will need The X Window System (X11R5, R6 or R6.1) and UNIX. To run xbrowse, you will need a workstation that is `on the Internet'. For the impatient: type `xmkmf; make Makefiles; make depend; make; make install'. To test xbrowse, type `xbrowse'. Do not worry about error from makedepend saying that some include files coud not be found. Compiling xbrowse: Any user can compile xbrowse and do so in just about any directory. However, the user who installs xbrowse should ideally have write permission for the directories where X11 binaries, application library files, and application resource files are stored on the target system. If the person building xbrowse does *not* have these permissions, then they can edit either Imakefile or Makefile.dist and install xbrowse and its associated files in directories where they do have write permission. To modify the Imakefile so that xbrowse and its associated files are installed in a special set of directories, change the definitions of BINDIR, LIBDIR, and MANDIR in the Imakefile. In the Imakefile, these definitions are currently commented-out (since xmkmf supplies default values for them). By uncommenting the definintions and supplying your own values you will override the system defaults. NB: When running `xmkmf' or `make depend' you will get some warnings about files not found, ... ignore these since those warnings. Also, during compilation of the FileComp widget, you will see one or two warnings; ignor them. If you use site specific directories for your X11 application library, then you should edit XBrowse.ad so that xbrowse will look in the correct directory for the palette files (normally, X11 stores application specific library files in `/usr/lib/X11/<app name>/'). Scan the begining of XBrowse.ad for `palette_path' and make sure it is defined correctly. If xbrowse cannot read its palette file, then it will print an error message to that effect and use the default system palette. Generally the system palettes are unusable with imagery. xbrowse-3.3.9 has been compiled on the following machines: Machine OS X version Compiler(s) ------------------------------------------------------------------------ DECstation 5000/240 Ultrix 4.3 X11R5 gcc DEC Alpha OSF/1.3, 3.0 X11R5 cc, gcc Sparc SunOS 4.1.3 X11R5,R6 gcc, gcc-2.7.2 SGI IRIX X11R5 cc To compile, type `xmkmf' followed by `make Makefiles', `make depend' and `make'. Once you are satisfied with the build, type `make install'. If you don't have imake, then follow the directions in Makefile.dist to tailor it to your system, then type `make' and `make install'. If you compile this code on any machine/OS combination not listed above, please send me email (firstname.lastname@example.org) describing what you did and/or any lingering problems you have. Using xbrowse: xbrowse contains fallback resources (incorporated into the xbrowse source code at compile time via George Ferguson's ad2c program) so it is not necessary to install the XBrowse application defaults resource file for xbrowse to work. However, if you do install the application defaults (this happens automatically when you type `make install' - assuming you have the privs to write to you app-defaults directory) you will still get the typical sort of X11 client behavior re: resources. The tar file contains the source code for xbrowse, various files used by the program (the X11 resource file, ...) and other files such as this one. In the diectory `palettes' there are several files which can be used as palettes for xbrowse. We use the file named `color'. In this palette, white represents very cold areas (0-4 C) and red represents hot areas (30 C). xbrowse can be used to browse our ~20,000 image archive of AVHRR data. To access this archive, run xbrowse without either the `-list' or the `-path' options. xbrowse will prompt you for the start and end dates of the images you wish to look at (e.g., if you entered 01/25/85 and 02/25/85 as the start and end dates, then xbrowse would begin sequentially displaying all the images in the archive that fall between those dates). The archive starts on 1 April 1979 and continues to the present. Each image in the archive covers the area from latitude 60.575N longitude 96.222W to latitude 9.399N longitude 33.768W. The images use a linear projection and the resolution of the data is 5km/pixel. In addition, Jim Bisagni maintains an archive of data for the Gulf of Main which can be accessed via xbrowse. To look at that archive use the `-server' command line option and give `dcz.gso.uri.edu' as the machine name. Copyright 1991, 1992, 1993, 1994 University of Rhode Island. Portions of the program Copyright 1992 Robert Forsman, (FileComp dialog boxes) Copyright (C) 1989 by Jef Poskanzer. (pgm image file library) Mr Poskanzer's copyright notice: Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. This software is provided "as is" without express or implied warranty. Thanks to RAMO@uvphys.phys.UVic.CA for the RS6000 patches and binary.