Isis 3 Documentation
Installing IsisDownloading and installing Isis 3 | Home |
Platforms
Isis 3 applications are compiled and linked on our local systems. We provide copies of some of the necessary third party libraries, but we can not provide them for all operating system, hardware and distribution combinations. Other libraries are assumed to be available from your installation. As we upgrade to new software and hardware we may introduce incompatibilities with older platforms. In some cases we will not have the resources to resolve all problems, but we will attempt to remain compatible within reason and our resource limits.
1) Find Disk Space
The current distribution of Isis 3 contains over 300 applications. It includes the complete source, binaries, documentation, and libraries necessary to run the applications. Note: This does not include 3rd party binaries and header files necessary for developing Isis applications. The data area is available as a seperate download. Be aware, the full data area is very large (many 10s of GBs). This includes SPICE kernels for Apollo, CASSINI, Clementine1, Dawn, Galileo, Lunar Reconnaissance Orbiter, Lunar Orbiter, Mariner10, Messenger, Mars Global Surveyor, Mars Odyssey, Mars Reconnaissance Orbiter, Viking, Voyager, and others. Other missions are included as they become available in Isis.
We suggest you install Isis3 in a work area, away from any existing Isis2.x installations. Change your current working directory to where you want isis3 installed and create a directory named isis3. The rsync commands in step 2 will place all of Isis and the SPICE kernels under this directory. If you are looking for Isis 2, please refer to the Isis 2 Installation Guide for instructions on downloading and installing Isis 2.
Example:
$ cd /work1
$ mkdir isis3
$ cd isis3
2) Download Isis3
We are distributing Isis3 using two rsync servers. If the "rsync" command is is not available on your system please see your system administrator. To download Isis3 follow the example for your hardware and operating system combination. Make sure to include the period "." at the end of the "rsync" commands - if you don't, you will only get a list of available downloads from the rsync server.
Announcing our new rsync server mirror. We have a new rsync server with a much faster connection. The old system is still up, but we encourage the use of the new one.
- New - isisdist.astrogeology.usgs.gov
- Old - isisdist.wr.usgs.gov
All of the example commands below use the "New" server name. You can use the "Old" server name if you need to.
Warning: You must be in the correct directory as shown above, and you must type the follwing commands correctly. If you do not you could remove files not associated with ISIS.
Example for MacOSX 10.5 32-bit Intel compatible systems:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::x86_darwin_OSX/isis .
Example for Fedora 14 Linux x86 64-bit Intel compatible systems:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::x86-64_linux_FEDORA/isis .
Example for Open SUSE 11.3 Linux x86 64-bit Intel compatible systems:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::x86-64_linux_SUSE11/isis .
Example for RHEL 5.6 Linux x86 64-bit Intel compatible systems:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::x86-64_linux_RHEL/isis .
Example for RHEL 5.6 Linux x86 32-bit Intel compatible systems:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::x86_linux_RHEL/isis .
Example for Ubuntu 10.04 Linux x86 64-bit Intel compatible systems:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::x86-64_linux_UBUNTU/isis .
Example for Debian 6.0 Linux x86 64-bit Intel compatible systems:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::x86-64_linux_DEBIAN/isis .
Example for RHEL 6.1 Linux x86 64-bit Intel compatible systems:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::x86-64_linux_RHEL6/isis .
Note: Isis3 can also be downloaded over port 80. To use port 80 change
isisdist.astrogeology.usgs.gov:: in the previous commands to rsync://isisdist.astrogeology.usgs.gov:80::.
Example: rsync -azv --delete --partial rsync://isisdist.astrogeology.usgs.gov:80::x86-64_linux_RHEL/isis .
Note: We are no longer building Isis 3 for Linux SuSE 9.X, 10.X, RedHat Enterprise 3, 4 or equivalent systems or Mac OSX with the Power PC processor.
3) Get the Isis3 data files
The data area is separate from the source code. This data area is crucial to Isis3 and some of it must be downloaded.
Announcing a new service useable by ISIS to retrieve SPICE data for cubes. Isis can now use a service to retreive the SPICE data for most instruments Isis supports via the internet. This can significantly reduce the size of the download from our data area. If you want to use this new service and not have to download all the SPICE data add the following argument to the mission-specific rsync commands below:
--exclude='kernels'
For example: rsync -azv --exclude='kernels' --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/cassini data/
Perform this step from the same directory you ran the previous rsync command. In the example it was "/work1/isis3".
To download all Isis3 data files use the following command.
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data .
Note: The isis3 data area is very large (over 130GB). You may want to consider downloading only the missions you require. To download specific Isis3 mission data files use the following commands. Please note: Regardless of the mission the base data is required.
Required Download
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/base data/
Apollo Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/apollo15 data/
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/apollo16 data/
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/apollo17 data/
Cassini Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/cassini data/
Chan1 Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/chan1 data/
Clementine Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/clementine1 data/
Dawn Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/dawn data/
Galileo Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/galileo data/
Ideal Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/ideal data/
Lunar Orbiter Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/lo data/
Lunar Reconnaissance Orbiter Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/lro data/
Mars Exploration Rover Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/mer data/
Mariner10 Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/mariner10 data/
Messenger Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/messenger data/
Mars Express Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/mex data/
Mars Global Surveyor Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/mgs data/
Mars Reconnaissance Orbiter Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/mro data/
Odyssey Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/odyssey data/
Rolo Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/rolo data/
Smart1 Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/smart1 data/
Viking Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/viking1 data/
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/viking2 data/
Voyager Mission:
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/voyager1 data/
rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/voyager2 data/
4) Set up your environment
Isis3 needs to know where all its pieces are located. We use an environment variable called "ISISROOT" to do this. For the above example set ISISROOT as follows:
for C shells:
setenv ISISROOT /work1/isis3/isis
for Bourne shells:
ISISROOT=/work1/isis3/isis
export ISISROOT
Run the startup script for Isis. This script assumes you installed the Isis 3 data area in the same directory you installed the Isis 3 package. If you did not do this, you will need to modify the script to meet your needs.
for C shells:
source $ISISROOT/scripts/isis3Startup.csh
for Bourne shells:
. $ISISROOT/scripts/isis3Startup.sh
If you encounter any problems we will be monitoring our discussion board daily and will respond to any questions as best we can.
Information and Warnings
Isis 3 and Isis 2 will have collisions of executable names (e.g., pds2isis exists in both systems). It is best to remove initializations of Isis 2 from your startup file otherwise you may get unpredictable results.
The shell script used to set your environment to run Isis3 modifies the PATH environment variable.
The installation for Isis 3 does not allow the installer to choose what data sets to install or where to put them. The only control is through the destination directory in the rsync command. If you choose to move the data area you will need to modify the isis3Startup.xxx script.
Document History
| Deborah Lee Soltesz | 2004-03-24 | Added missing flags to rsync command |
| Stuart C. Sides | 2005-09-27 | Updated for isis 3.0.8 |
| Stuart C. Sides | 2006-05-12 | Updated for isis 3.0.18 |
| Jeff Anderson | 2006-10-30 | Remove references to beta version |
| Jac Shinaman | 2007-01-18 | Updated for isis 3.1.5 - Mac OS X |
| Steven Koechle | 2008-04-09 | Added rsync options for data |
| Stuart sides | 2008-09-22 | Updated for 3.1.17 |
| Stuart Sides | 2010-03-18 | Updated for release 3.2.0 |
| Steven Lambright | 2010-06-25 | Updated for release 3.2.1 |
| Jai Rideout | 2011-04-15 | Added rsync partial option to rsync commands and added new mission-specific sections |