MESSENGER MDIS Data Users’ Workshop 46th LPSC March 15, 2015 Presented by Kris Becker Computer Scientist, [email protected] & Tammy Becker Cartographer, [email protected] 3/15/2015 1 ISIS3 Tutorial and MESSENGER MDIS Data Users’ Workshop • Objective: Provide an introduction to ISIS3 and demonstrate its use in processing of MESSENGER MDIS data – ISIS3 Fundamentals – Standard Processing Concepts and Tools – Cartographic Map Projections – Hands-On Lessons o Create a Monochrome Map Mosaic (EDRs-WAC) o Create a 3-Color Map Mosaic (EDRs-WAC) o Color processing of an 8-Wavelength Observation o Working with PDS Map Products • Monochrome MDIS BDR Mosaic • Color MDIS MDR Mosaic o Working with Very High Resolution Data (NAC) – Export and Application Support for ISIS3 Products 3/15/2015 2 ISIS - Integrated Software for Imagers and Spectrometers • Over 300 image processing applications • Strong emphasis on geometric functionality – Photogrammetry / Camera models – Cartography / Map projections – Adjust/Improve Instrument Position and Orientation – Generate Digital Map Mosaics • In use for over 30 years – Software generations: PICS, ISIS2, ISIS3 • Support for over 55 NASA/ESA instruments – Framing Cameras (e.g, MDIS Narrow Angle and Wide Angle cameras) – Line Scan Cameras (e.g., THEMIS-IR, HiRISE) – Push Frame Cameras (e.g., LROC-WAC) – Special Cases o Radar Instruments (e.g., LROC-MiniRF) o Spot Instruments (e.g., Cassini-VIMS) 3/15/2015 3 Mission Instruments Supported by ISIS3 Moon Mars • Lunar Orbiter III, IV, &, V (Medium and HiRes) • Mars Global Surveyor MOC (NAC & WAC) • Clementine UVVIS, NIR, HIRES, & LWIR • Mars Odyssey THEMIS (VIS & IR) • Apollo Metric 15/16/17 • Mars Express HRSC • Apollo Panoramic 15/16/17 • Mars Reconnaissance Orbiter HiRISE, CTX, • Lunar Reconnaissance Orbiter NACL, NACR, MARCI, CRISM WAC (VIS & UV), MiniRF • Viking Orbiter 1 & 2 (A & B) • Chandrayaan-1 M3, MiniRF • Kaguya MI (VIS & NIR) Jovian • Galileo SSI Mercury • Mariner 10 (A & B) Saturnian • MESSENGER MDIS (NAC & WAC) • Cassini ISS (NAC & WAC), VIMS Asteroids Other • Dawn FC (1 & 2), VIR • Ideal Camera (Special ISIS Perfect Virtual • Near Earth Asteroid Rendezvous Shoemaker MSI Instrument – Distortion-Free!) • Hayabusa AMICA • Upcoming – OSIRIS-REx OCAMS Pluto • Upcoming – New Horizons MVIC, LORRI, LEISA Multiple Target Bodies • Voyager 1 & 2 (NAC & WAC) Fifty-five instruments in all!! 3/15/2015 4 Current ISIS Status • ISIS 3.4.8 (Released Dec 2014) • ISIS 3.4.9 (Scheduled Release: End of March 2015) • UNIX-based Supported Platform OSes – Mac OSX 10.6, 10.8 and higher (32 & 64 bit Intel) – Debian 7 (64 bit) – Fedora 18 (64 bit) – Redhat Enterprise 6.5 (64 bit) (via SL 6.5) – Scientific Linux (SL) 6.5 (64 bit) – Ubuntu 12.04 LTS (64 bit) • Download via Internet – Full distribution >200GB – Selective download using rsync utility – Java client installer 3/15/2015 5 ISIS3 Documentation, Support and User Guides • General Information – http://isis.astrogeology.usgs.gov • Installation Guide – http://isis.astrogeology.usgs.gov/documents/InstallGuide • Table of ISIS Applications – http://isis.astrogeology.usgs.gov/Application o The ISIS3 Software Manual is organized by • Functional Category & Mission Specific Programs • User Support Forum – http://isis.astrogeology.usgs.gov/IsisSupport • Online Workshops – http://isis.astrogeology.usgs.gov/IsisWorkshop • Isis Command Line Options – http://isis.astrogeology.usgs.gov/documents/CommandLine/CommandLine.html • Unix/Linux Command Reference Cheat-Sheet – http://www.cheat-sheets.org/saved-copy/fwunixref.pdf 3/15/2015 6 #################################################### # Customize elements of the user interface ISIS User Preferences # # ProgressBarPercent = 1 | 2 | 5 | 10 # ProgressBar = On | Off Examples of IsisPreferences settings to change # GuiStyle = windows | motif | cde | motifplus | # platinum | sgi | kde | aqua • HistoryPath # GuiHelpBrowser = { your preferred browser path } o Change location of the application parameter # GuiFontName = helvitica|times|charter | any legal font # GuiFontSize = 10 | 12 | 14 | any font point size history files to default to the user’s current # HistoryPath = {your preferred location for the directory application .par files} • HistoryPath = ./ # HistoryRecording = On | Off #################################################### • ProgressBar o Show progress percent for all applications Group=UserInterface ProgressBarPercent = 10 • ProgressBar = On ProgressBar = On • Cube Customization defaults GuiStyle = windows GuiHelpBrowser = firefox o Change the gigabyte size allowed for cubes GuiFontName = helvitica • MaximumSize = 55 GuiFontSize = 10 GuiWidth = 460 • Mac Browser Options GuiHeight = 600 o To use default browser for Mac OSX HistoryPath = $HOME/.Isis/history HistoryRecording = On • GuiHelpBrowser = open EndGroup Instructions to over-ride system-wide defaults: … 1. Create a “hidden” .Isis directory in your $HOME area 2. Copy the IsisPreferences file to this directory > cp $ISISROOT/IsisPreferences $HOME/.Isis/IsisPreferences 3. View and edit your copy of the IsisPreferences file For more information on Isis Preferences, go to http://isis.astrogeology.usgs.gov/documents/PreferenceDictionary/PreferenceDictionary.html http://isis.astrogeology.usgs.gov/documents/EnvironmentAndPreferencesSetup/EnvironmentAndPreferencesSetup.html 3/15/2015 7 Executing ISIS3 Applications Application Documentation Application GUI Interface Click the Help drop down menu o The “About this program” opens a browser with detailed program information. Use the “What’s This?” tool to find out more about the parameters – FROM – TO – FORMAT – APPEND 3/15/2015 8 Executing ISIS3 Applications Application GUI Interface • Click File Selection Button o Select Input filename to load FROM • Click Run Button • View the Results Log Area o Program output placed here o Clear log 3/15/2015 9 Executing ISIS3 Applications Application GUI Interface • Parameter History – Recovery of previous execution commands – Use the History buttons to recall & cycle through the run commands • Command line – The text box shows the terminal window command to run program outside of GUI • Exit the program 3/15/2015 10 Executing ISIS3 Applications Command Line Options > stats from=input.cub -help • Run the stats program from the command line FROM = Null • Append the ISIS –help option to see all parameters for TO = Null this program o Valid parameter values with “*” are the Default settings FORMAT = (*PVL, FLAT) • The ISIS –webhelp option opens the on-line APPEND = TRUE documentation for this program VALIDMIN = Null • Use the –gui option to open the application with VALIDMAX = Null parameters already filled in from the command line • Batch processing achieved through the command line > stats from=input.cub –webhelp option [-batchlist] o External to the GUI, -batchlist is only associated with the > stats from=input.cub –gui command line o Not accessible to applications within the GUI o Reads single to multiple rows and columns of text and > stats –batchlist=file.lis from=\$1 passes to the application parameters ISIS command options and their uses http://isis.astrogeology.usgs.gov/documents/CommandLine/CommandLine.html 3/15/2015 11 ISIS3 Application User Documentation Selecting a ‘bolded/underlined’ term will display the Glossary 3/15/2015 12 ISIS Processing History > cathist 1. Print all ISIS commands applied to an ISIS cube to the from=input.cub screen in PVL format. > cathist 2. Write all ISIS commands applied to an ISIS cube to a text from=input.cub file in PVL format. to=input.pvl 3. Print all ISIS commands applied to an ISIS cube to the > cathist screen in brief mode, (i.e. in command line format). from=input.cub mode=brief Session Logs • Program output o All executed applications append output to print.prt o Basic accounting information on the application run is included o All user parameters o Application results 3/15/2015 13 Typical Standard Output to print.prt Application Object = stats Name IsisVersion = "3.4.8.6010 stable | 2014-11-26" ProgramVersion = 2013-11-12 ProgramPath = /usgs/pkgs/isis3.4.8/isis/bin Version of ISIS3 ExecutionDateTime = 2015-03-06T10:52:00 HostName = astrovm1.wr.usgs.gov Date of Execution UserName = tbecker Description = "Generates statistics about a cube" Group = UserParameters FROM = EW0249037420F.lev1.cub FORMAT = PVL APPEND = TRUE End_Group Group = Results From = EW0249037420F.lev1.cub Band = 1 Average = 0.044823747606398 StandardDeviation = 0.0064236440931258 Variance = 4.126320343515e-05 Median = 0.043860295335343 Mode = 0.041518581464479 Skew = 0.44995593953587 Minimum = 0.024972274899483 Maximum = 0.20238755643368 Sum = 46817.507899931 TotalPixels = 1048576 ValidPixels = 1044480 OverValidMaximumPixels = 0 UnderValidMinimumPixels = 0 NullPixels = 4096 LisPixels = 0 LrsPixels = 0 HisPixels = 0 HrsPixels = 0 End_Group Group = Accounting ConnectTime = 00:00:00.0 3/15/2015 CpuTime = 00:00:00.1 14 End_Group Image Visualization • Qview – On-line presentation regarding qview details o http://isis.astrogeology.usgs.gov/IsisWorkshop/uploads/8/8b/Qview.pdf 3/15/2015 15 PDS NAIF ISIS3 Science Analysis & Products PDS EDR Images ISIS Science Analysis & SPICE ToolKit Camera and and Kernels Mapping Products Tools . Cartographic Maps [ISIS] . Stereo [SocetSet] ISIS . Geologic Mapping [GIS] Camera Model Additional Target Instrument Body and Information Shape *addendum Model *Note: For additional information on SPICE, refer to: http://naif.jpl.nasa.gov/naif/Ancillary_Data_Production.pdf 3/15/2015 16 ISIS3 Cartographic Processing