The latest version can be downloaded from the ASF website at https://www.asf.alaska.edu/data-tools/mapready/.
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.
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 Converter.
By default, the installer also creates desktop icons for MapReady and ASF View.
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:
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 components 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:
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.
Required packages to build ASF tools:
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:
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