Windows Installation

The Windows package contains just a single file, the installer.

To install, you open the archive file that you downloaded (double-clicking on it will open it); then run the installer program contained within.

After installation, you will have a start-menu group called "ASF Tools", and inside that another program group called "MapReady 2.0". Inside that group, "ASF MapReady" is the main program (formerly known as "Convert").

The "MapReady 2.0" start menu group also contains a link to the ASF MapReady Manual, an extensive document that describes all of the installed programs and contains examples of their use.

Also installed: ASF View (a viewer application which can display CEOS format data, as well as GeoTIFFs, ASF Internal Format files, etc.), the CEOS Metadata Viewer, and the Projection Coordinate Conveter.

By default, the installer also creates desktop icons for MapReady and ASF View.

Linux Installation

To install the RPM, you must have root access. If you do not, you will need your system administrator to install the package for you. If this is not feasible, the Source package can instead downloaded, compiled, and installed in your own home directory which does not require root privileges.

To install the package:

First extract the rpm from the archive:

Then, as root, install the rpm:

(Of course you need to replace the X's with whatever version you downloaded, for example: "rpm -i asf_mapready-2.0.5-1.i386.rpm")

After the package is installed, you can find out where individual compenents were put by using this rpm command, which does not require root access:

You should see something like the following:

which tells you that the package has been installed in /usr/local, which is the default.

This directory needs to be added to your path, in order to run the tools. Exactly how you do this depends on which UNIX shell you are using.

For example, suppose the software was installed in /opt/asf_tools. For sh, ksh, bash, or the like, add these lines to your ~/.profile or ~/.bashrc file:

For csh or tcsh, add this line to your ~/.cshrc file:

If you've gone with the default installation location of /usr/local, you may already have /usr/local/bin in your path, in which case you don't need to do anything.

Source Installation

After you've downloaded the archive, you need to extract the package and compile the tools before they can be installed. To do this, make sure you're in the directory where the archive was downloaded to and:

First extract the directory tree from the archive:

Then build the tools. Please note that you will need permissions to put files into [[installation location]]! The default is /usr/local.

Next install them:

Lastly you need to include the tools in your path. You do this one of two ways depending on the UNIX shell you are using.

For sh, ksh, bash, and the like, add the following lines to either the ~/.profile or ~/.bashrc file.

For csh or tcsh, add this line to the ~/.cshrc file:

For example, say you would like to install the tools in a folder called "asf_tools" in your home directory (/home/jdoe/asf_tools), and you use the bash UNIX shell