Alaska Satellite FacilityMapReady Installation Guide

The latest version can be downloaded from the ASF web site at http://www.asf.alaska.edu.

How you install the tool depends on which operating system you are using. Windows packages come with an installer, Linux packages come as an RPM, and Source packages contain source code with an autoconf-style configure script.

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. If running Windows 7, you will need to install the package as administrator, this is done by right clicking the installer and selecting the Run as Administrator option.

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:

gunzip mapready-X.X.X-linux.tar.gz
tar xvf mapready-X.X.X-linux.tar

Then, as root, install the rpm:

rpm -i asf_mapready-X.X.X-1.i386.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:

rpm -ql asf_mapready | grep asf_import

You should see something like the following:

/usr/local/bin/asf_import

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:

PATH=/opt/asf_tools/bin:$PATH
export PATH

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

setenv PATH /opt/asf_tools/bin:$PATH

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

Required packages to build ASF tools:

• • gcc
• • gcc-c++
• • pkgconfig
• • automake
• • autoconf
• • gtk2-devel
• • libglade2-devel
• • glade2
• • bison
• • flex

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:

gunzip mapready-X.X.X-src.tar.gz
tar xvf mapready-X.X.X-src.tar

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

cd asf_tools
./configure --prefix=[[installation location]]
make

Next install them:

make install

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.

PATH=[[installation location]]/bin:$PATH
export PATH

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

setenv PATH [[installation location]]/bin:$PATH

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

./configure --prefix=/home/jdoe/asf_tools
make
make install
echo "PATH=/home/jdoe/asf_tools/bin:$PATH" >>
~/.bashrc
echo "export PATH" >> ~/.bashrc