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, download the desired Windows version using the links above, open the downloaded file (double-clicking on it will open it), and run the installer program contained within. If running Windows 7, you will need to install the package as administrator: right-click the installer and select the Run as Administrator option.
After installation, the MapReady software is contained in a start-menu group called ASF Tools, which contains the following:
- ASF MapReady: the main software program (formerly known as “Convert)
- ASF MapReady Manual: an extensive PDF document that describes all of the installed programs and contains examples of their use
- ASF View: a viewer application capable of displaying a variety of SAR data formats, including CEOS, GeoTIFF, ASF Internal Format files
- CEOS Metadata Viewer reads the CEOS leader file which contains the metadata associated with the binary data and has both binary and ASCII components
- Projection Coordinate Converter: a utility for converting coordinate values from one map projection to another
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 be downloaded, compiled, and installed in your own home directory, which does not require root privileges.
To install the package:
1. Extract the RPM from the archive:
gunzip mapready-X.X.X-linux.tar.gz
tar xvf mapready-X.X.X-linux.tar
2. As root, install the RPM:
rpm -i asf_mapready-X.X.X-1.i386.rpm
(Replace the Xs with whatever version you downloaded, for example: “rpm -i asf_mapready-2.0.5-1.i386.rpm”)
3. Locate the directory containing the installed package. After the package is installed, you can find the location of the installed components 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.
4. Add the directory containing the installed package to your path in order to run the tools. The method of adding a path depends on which UNIX shell you are using.
For example, suppose the software was installed in /opt/asf_tools. For sh, ksh, bash, or similar shells, 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 containing the downloaded archive, then follow the following steps:
1. Extract the directory tree from the archive:
gunzip mapready-X.X.X-src.tar.gz
tar xvf mapready-X.X.X-src.tar
2. 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
3. Install the tools
make install
4. 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 similar shells, 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