cd $ISISDATA rsync -azv --exclude='kernels' --delete --partial isisdist.astrogeology.usgs.gov::isisdata/data/cassini .**WARNING:** Some instruments require mission data to be present for radiometric calibration, which is not supported by the SPICE Web Server, and some programs that are designed to run an image from ingestion through the mapping phase do not have an option to use the SPICE Web Service. For information specific to an instrument, see the documentation for radiometric calibration programs. ### Mission Specific Data Downloads For versions of ISIS prior to ISIS 4.1.0, please use the `--legacy` flag | Mission | Command | | ------ | ------ | | Apollo 15 | `downloadIsisData apollo15 $ISISDATA` | | Apollo 16 | `downloadIsisData apollo16 $ISISDATA` | | Apollo 17 | `downloadIsisData apollo17 $ISISDATA` | | Cassini | `downloadIsisData cassini $ISISDATA` | | Chandrayaan 1 | `downloadIsisData chandrayaan1 $ISISDATA` | | Clementine 1 | `downloadIsisData clementine1 $ISISDATA` | | Dawn | `downloadIsisData dawn $ISISDATA` | | ExoMars | `downloadIsisData tgo $ISISDATA` | | Galileo | `downloadIsisData galileo $ISISDATA` | | Hayabusa 2 | `downloadIsisData hayabusa2 $ISISDATA` | | Juno | `downloadIsisData juno $ISISDATA` | | Kaguya | `downloadIsisData kaguya $ISISDATA` | | Lunar Orbiter | `downloadIsisData lo $ISISDATA` | | Lunar Reconnaissance Orbiter | `downloadIsisData lro $ISISDATA` | | Mars Exploration Rover | `downloadIsisData mer $ISISDATA` | | Mariner10 | `downloadIsisData mariner10 $ISISDATA` | | Messenger | `downloadIsisData messenger $ISISDATA` | | Mars Express | `downloadIsisData mex $ISISDATA` | | Mars Global Surveyor | `downloadIsisData mgs $ISISDATA` | | Mars Reconnaissance Orbiter | `downloadIsisData mro $ISISDATA` | | Mars Odyssey | `downloadIsisData odyssey $ISISDATA` | | Near | `downloadIsisData near $ISISDATA` | | New Horizons | `downloadIsisData newhorizons $ISISDATA` | | OSIRIS-REx | `downloadIsisData osirisrex $ISISDATA` | | Rolo | `downloadIsisData rolo $ISISDATA` | | Rosetta | `downloadIsisData rosetta $ISISDATA` | | Smart1 | `downloadIsisData smart1 $ISISDATA` | | Viking 1 | `downloadIsisData viking1 $ISISDATA` | | Viking 2 | `downloadIsisData viking2 $ISISDATA` | | Voyager 1 | `downloadIsisData voyager1 $ISISDATA` | | Voyager 2 | `downloadIsisData voyager2 $ISISDATA` | ### ISIS Test Data ISIS is comprised of two types of tests, custom Makefile based tests, and GTest based tests. Those that are GTest based, make economical use of data that exists on the ISIS3 repo along with the source, so no special data is required to run those other than the ISIS data area. The Makefile tests depend on a separate source of data that consists of a few gigabytes of input and expected output data used for testing ISIS applications. The Makefile based tests use the `ISISTESTDATA` environment variable to know where the required data are located. The total size of this test data decreases as we work towards converting Makefile tests to GTests. ###How to download the ISIS test data with rclone Test data is hosted using Amazon S3 storage buckets. We recommend using rclone to pull the data into a local directory. You can download rclone using their instructions (see: https://rclone.org/downloads/) or by using an anaconda environment (see: https://docs.anaconda.com/anaconda/install/). If you already have an anaconda environment up, install rclone with: `conda install –c conda-forge rclone` Next, you will want to configure rclone using a default S3 configuration. See: https://rclone.org/s3/ for detailed information on how to configure S3, but for the purposes of downloading the ISIS3 test data, you simply run rclone config which will start an interactive menu. Press enter through it all except for these details: 1. Set S3 as both your storage type and storage provider 2. Set us-west-2 as both your region to connect to and as the location constraint. 3. Everything else, just leave as the default. Example output: https://gist.github.com/Kelvinrr/706bbd54b1c2c30d0ce3d12f7dcaa10a Once rclone is configured, simply run: `rclone sync remote:asc-isisdata/isis_testData/ $ISISTESTDATA` where: - $ISISTESTDATA is the environment variable defining the location of the ISISTESTDATA - remote: is the name of the configuration you created earlier. This can be whatever you want to name it, in this case it is named remote. - asc-isisdata/isis_testData/ is the name of the S3 bucket you’re downloading from $ISISTESTDATA should now contain a full clone of the ISIS test data for running Makefile based tests. Notes: - Users can download specific files from the bucket by adding path data or file information to the first argument, that is, to download only the ‘base’ folder from the isis_testData bucket, the user could call: rclone sync remote:asc-isisdata/isis_testData/base - It is important that users understand the difference in rclone’s ‘sync’ and ‘copy’ methods. ‘copy’ will overwrite all data in the destination with data from source. ‘sync’ replaces only changed data. - Syncing / copying in either direction (local -> remote or remote -> local) results in any changed data being overwritten. There is no warning message on overwrite. ## Installing older versions of ISIS --------------------------------- ### How do I install ISIS2? If you are looking for ISIS2, please [refer to the ISIS 2 Installation Guide](http://isis.astrogeology.usgs.gov/Isis2/isis-bin/installation.cgi) for instructions on downloading and installing ISIS 2. ### How do I install ISIS3.5.2 or earlier? If you are looking for a version of ISIS prior to 3.6.0, please [refer to the Legacy ISIS3 Installation Guide](https://isis.astrogeology.usgs.gov/documents/LegacyInstallGuide/index.html) for instructions on downloading and installing ISIS, versions prior to 3.6.0 ### How do I access the ISISDATA download script with ISIS 7.0.0 or earlier You can download the script and config file from the repo: ``` # install rclone conda install -c conda-forge rclone # download the script and rclone config file curl https://raw.githubusercontent.com/USGS-Astrogeology/ISIS3/dev/isis/scripts/downloadIsisData -o downloadIsisData.py curl https://raw.githubusercontent.com/USGS-Astrogeology/ISIS3/dev/isis/config/rclone.conf -o rclone.conf # run the script as normal, using --config to point to where you downloaded the config file python downloadIsisData