Project

General

Profile

ISIS 3.6.0 Release Candidate Available

Added by Ian Humphrey about 1 month ago

A new release candidate, isis3.6.0-rc0 is available for download.
The binaries (applications) for this release candidate are not hosted on the rsync servers anymore; instead, they are hosted at Anaconda.org (instructions below will describe in detail how to download and set up the isis3.6.0 environment).
Note that the data will still be distributed on the rsync servers.

Attached are: ApiChanges.pdf, ParameterChanges.pdf, and ReleaseNotes.pdf. Note that these will have broken links.

Notable changes

The following notable changes have been made to the isis3.6.0 release candidate:

  • first public release of ipce application -- Up to now, 30+ standalone ISIS3 applications have been required for the photogrammetric control process in ISIS3. The process can be difficult to understand, error-prone, inefficient, and costly. IPCE (Integrated Photogrammetric Control Environment) is intended to ultimately integrate all aspects of the photogrammetric control process into a single environment. IPCE improves the control process through the 1) simplification of data management; 2) implementation of rigorous algorithms; 3) automation of processes and analysis; and 4) provision of statistical and graphical data analysis tools. Currently IPCE combines functionality of ISIS applications jigsaw, qmos, qnet, and qview.

  • corrected inaccuracies with tracking in the mosaicking software

  • refactored clementine camera model

  • infrastructure

    • implemented CMake infrastucture for building and testing
    • dependency management migrated from internal process to using conda and Anaconda.org for building and distribution
    • isis3.6.0+ applications hosted on Anaconda.org instead of rsync server (data still hosted on rsync servers)
    • test data now hosted on rsync server (isis3testData module)

Known Issues

  • If you are developing on macOS10.13, there is a type of warning you will likely encounter that is not related to building isis3. This seems to be an issue with how the command line tools (development SDK) is shipped on macOS10.13. The warnings look like: > ld: warning: text-based stub file /System/Library/Frameworks/AGL.framework/AGL.tbd and library file /System/Library/Frameworks/AGL.framework/AGL are out of sync. Falling back to library file for linking.

Notes

There are some important considerations to keep in mind when using this release candidate:
* Do not use this version for production work. A stable isis3.6.0 release will be uploaded after one or two weeks, which will be suitable for production work.
* The ISIS3 online documentation will not be updated until the stable release is announced.
* The ISIS3 documentation will be available in the release candidate as local files.

The following operating systems are supported for this release candidate:
* Fedora28
* Ubuntu18.04
* macOS High Sierra 10.13

(Other Linux/macOS variants may be able to run this release candidate, but are not supported.)

If you find a problem with this release candidate, please create an issue here: https://github.com/USGS-Astrogeology/ISIS3/issues/new

Installation Instructions

  1. Open a bash terminal
  2. Install anaconda3 (this should add conda to your PATH) -- see https://www.anaconda.com/download
  3. If Linux: source ~/.bashrc
  4. If macOS: source ~/.bash_profile
  5. Add conda-forge channel to your anaconda install -- conda config --add channels conda-forge
  6. Add usgs-astrogeology channel to your anaconda install -- conda config --add channels usgs-astrogeology
  7. Create new environment -- conda create -n isis3
  8. Install isis3.6.0 release candidate -- conda install -c usgs-astrogeology isis3
  9. Activate the isis3.6.0 environment -- source activate isis3
  10. Download data to location of choice ($CONDA_PREFIX/data is the default location isis3VarInit.py looks in): bash mkdir $CONDA_PREFIX/data rsync -azv --delete --partial isisdist.astrogeology.usgs.gov::isis3data/data/base $CONDA_PREFIX/data/
  11. Set up ISIS3 variables -- python $CONDA_PREFIX/scripts/isis3VarInit.py
  12. Re-activate the isis3 environment -- source activate isis3
  13. Run qview to verify that your environment is working

If you want to be able to run isis3 applications without activating an environment every time you login or create a new terminal, follow these instructions:

For Linux, add the following lines to the bottom of ~/.bashrc. For macOS, add the following lines to the bottom of ~/.bash_profile:

source activate isis3
python $CONDA_PREFIX/scripts/isis3VarInit.py
source activate isis3

For documentation, open file:///$ISISROOT/docs/index.html
For release notes, open file:///$ISISROOT/docs/docoments/ReleaseNotes/ReleaseNotes.html

ReleaseNotes.pdf (40.5 KB) Ian Humphrey, 2018-10-29 11:31 AM

ParameterChanges.pdf (40.3 KB) Ian Humphrey, 2018-10-29 11:31 AM

ApiChanges.pdf (35 KB) Ian Humphrey, 2018-10-29 11:31 AM


Comments