How To: Installing ISIS3 on a Windows computer

Dear Dialog,

Today I have an instructional on how to install ISIS3 on a Windows computer. This How To is pulled heavily from the USGS’s blog post about it with a few tweaks an modifications.

On Windows:

  • In Cortana: search for Windows Powershell. Left click > Run As Administrator

  • Copy/Paste the following command into the Powershell and execute

    Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
  • This will prompt you to restart your computer, do this now.

  • From the App store, download Ubuntu and install it. (It may take a few minutes to install )

    • You will be prompted to create a username and password

On Ubuntu:

  • Run the following commands to update everything that we need.

    > sudo apt-get update

    • this will make sure everything is up to date, just in case

    > sudo apt install x11-apps

    > sudo apt-get install lxde

    • These will install a GUI that will allow us to view images through isis. This step will take a while. (+30 min?)

  • For the next step, there is likely a missing library from the previous step and we need it.

    > wget http://security.ubuntu.com/ubuntu/pool/main/i/icu/libicu52_52.1-3ubuntu0.8_amd64.deb

    > sudo dpkg -i libicu52_52.1-3ubuntu0.8_amd64.deb

    • Use the same library as in the previous step to unpackage it

Get ISIS3

  • The next step is to download isis from the server and this can be done a handful of ways. Since there is limited space on the computers that I am using, I am deciding to put isis on an external hard drive and then have the computer point to it when isis is run. If you want to store isis on your own home directory some of the commands will need a little tweaking (or they can found in the blog post referenced earlier ). In Ubuntu run:

    > cd /mnt/e

    > mkdir isis3

    > cd isis3

    > rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::x86-64_linux_UBUNTU/isis .

    > rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/base data/

    > rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/mro data/

    • We want all of the mro data so download it now. this will take multiple hours

Get Ames Stereo Pipeline:

  • Visit https://ti.arc.nasa.gov/tech/asr/groups/intelligent-robotics/ngt/stereo/ and download the latest version of ASP for Linux.

    • save ASP in the same directory as isis on the hard drive. It will be in a tarball format. In Ubuntu navigate to the directory where it is then untar it

    > cd /mnt/e

    > tar -xvf StereoPipeline-2.6.1-2018-09-06-x86_64-Linux.tar

    • The StereoPipeline file is just the latest one at the time of writing. It may be different in the future.

    > rm StereoPipeline-2.6.1-2018-09-06-x86_64-Linux.tar

  • Now we need to update the .bashrc file usually found in your home directory in order to have the computer point to ISIS and the ASP. This step is overall necessary to tell the computer where to look but it can be modified if your files are in a different place.

    > vi ~/.bashrc

    • add the following lines to bottom of .bashrc by clicking ‘i’ to insert text. the last line changes the directory when Ubuntu is initially opened and is optional

      export DISPLAY=:0

ISISROOT=/mnt/e/isis3/isis

export ISISROOT

.  $ISISROOT/scripts/isis3Startup.sh

export PATH=/mnt/e/StereoPipeline-2.6.1-2018-09-06-x86_64-Linux:$PATH

cd /mnt/c/Users/wyingling/Desktop/DTMgen

  • Now hit “Esc” > “:wq“ to save and quit the vi terminal.

  • Now close then open the Ubuntu terminal to initialize your changes.

  • ISIS should be ready to run as normal now!

W