------------------- README_JUNE2009.txt ------------------- Disclaimer: Any use of trade, product, or firm names in this document is for descriptive purposes only and does not imply endorsement by the U.S. Government. A) This distribution site contains data files, in-house software, and tutorials used by the USGS Astrogeology Science Center for stereo processing of HiRISE images using ISIS3 and SOCET SETv5.4.1 (SOCET SET is a registered trademark of BAE). The site is divided into the three zip files for download: 1) DATA.zip (~1 GB) DATA.zip contains global MOLA gridded dataset as ISIS3 cubes, and procedures to download the MOLA Track (PEDR) data. This is a one- time download -- independent of software or tutorial versions. 2) SOFTWARE_JUNE2009.zip SOFTWARE_JUNE2009.zip contains our in-house software, PERL scripts and the SOCET SET plugin sensor needed for HiRISE stereoprocessing using SOCET SET v5.4.1, and ISIS 3.1.18 or ISIS 3.1.20. (ISIS 3.1.19 has a bug in campt (needed for HiRISE) that is corrected in ISIS 3.1.20, so we are omitting ISIS 3.1.19.) For SOLARIS only, we are supplying the ISIS3.1.17 version of the code (ISIS is frozen at version 3.1.17 for SOLARIS.) To follow our procedures, you will also need to download FWTools software and the MOLA pedr2tab program(instructions below.) 3) TUTORIALS_JUNE2009.zip TUTORIALS_JUNE2009.zip contains a tutorial and PowerPoint presentation describing our stereo processing procedures using HiRISE images, ISIS3 and SOCET SET v5.4.1 B) The following summarizes the changes made since the May 2008 distribution. 1) Changes to our working configuration: a) We ported to SOCET SET running under Windows, because i) ISIS support for Solaris is being phased out with ISIS 3.1.17 being the last version to support the Sun Solaris platform. ii) We had performance issues with SOCET SET crashing under Solaris that greatly impeded efficiency. ** We are maintaining one of our Solaris 9 SOCET SET workstations for the time being. We will distribute our SOCET SET programs under Solaris for as long as we can. ** To maintain compatibility with USGS, we encourage users to switch to SOCET SET under Windows when Solaris hardware ages, or when SOCET SET is no longer supported under Solaris 9. b) We replaced our Z-Screen Stereo Display Monitors with Planar Stereo Display Monitors. c) We added a Guest Facility SOCET SET Workstation to our site. 2) New tutorial for HiRISE stereomapping with steps for novice SOCET SET users, and users of our Guest Facility. We plan to add more details over time. 3) All ISIS processing is now performed in ISIS3, version 3.1.18 or later for Linux and MAC operating sytems. (ISIS3.1.17 for Solaris.) This means that ISIS2 is no longer needed for HiRISE. 4) All SOCET SET processing is performed under version 5.4.1. 5) Import/Export programs and procedures are now divided between an ISIS processing machine and a SOCET SET workstation. 6) frame2pushbroom_noprojWorkaround and hi2socet_noprojWorkaround are replaced by calc_pushbroom_keywords (ISIS3 program) and import_pushbroom (SOCET SET program) 7) New ISIS3 processing script, hidata4socet.pl, that gathers all support data needed for HiRISE mapping, i.e.: MOLA DEM coverage MOLA Track point data coverage Statisitics for SOCET SET project creation campt listing 8) Updated procedures to use SOCET SET's NGATE (Next Generation Automatic Terrain Extraction) tool for DEM generation. C) The content of each zip file is listed below. SOFTWARE_JUNE2009.zip is organized by software package. All ISIS and SOCET SET programs have been compiled for you, with binaries in the BIN directories. The source code is provided for your reference. See the documents in TUTORIALS_JUNE2009.zip for details on software/procedures. Also, note that the listing for isis3.1.18 and isis3.1.20 is combined under isis3.1.XX in this README file. -------- DATA.zip -------- GLOBAL_MOLA_DEMS/ --> (data used by hidata4socet.pl) mola_128ppd_north_simp_88lat.isis3.cub.gz mola_128ppd_south_simp_88lat.isis3.cub.gz GLOBAL_MOLA_PEDR/ --> (data used by hidata4socet.pl) PEDR2TAB.PRM wget_mola.script Example_mola_files.txt --------------------- SOFTWARE_JUNE2009.zip --------------------- isis_3.1.17_SOLARIS/ BIN/ SOLARIS/ calc_pushbroom_keywords calc_pushbroom_keywords.xml isis3arc_dd PERL_SCRIPTS/ hi4socet.pl hidata4socet.pl hinoproj.pl--> (Run by hi4socet.pl) isis3gdal_jp2.pl isis3world.pl pedrTAB2SHP_og.pl --> (Run by hidata4socet.pl) SOURCE_CODE/ isis3arc_dd.c --> a c-program that converts an ISIS3 DEM into an ascii ARC GRID, in decimal degrees. (Run by hidata4socet.pl) calc_pushbroom_keywords/ --> An ISIS3 program that creates a list file of pushbroom keywords. (Run by hi4socet.pl) Makefile calc_pushbroom_keywords.cpp calc_pushbroom_keywords.xml get_mounting_angles.cpp get_naif_matrices.cpp isis_3.1.XX/ BIN/ LINUX_X86/ calc_pushbroom_keywords calc_pushbroom_keywords.xml isis3arc_dd LINUX_X86_64BIT/ calc_pushbroom_keywords calc_pushbroom_keywords.xml isis3arc_dd MACOSX_Intel/ calc_pushbroom_keywords calc_pushbroom_keywords.xml isis3arc_dd MACOSX_PowerPC/ calc_pushbroom_keywords calc_pushbroom_keywords.xml isis3arc_dd PERL_SCRIPTS/ hi4socet.pl hidata4socet.pl hinoproj.pl--> (Run by hi4socet.pl) isis3gdal_jp2.pl isis3world.pl pedrTAB2SHP_og.pl --> (Run by hidata4socet.pl) SOURCE_CODE/ isis3arc_dd.c --> a c-program that converts an ISIS3 DEM into an ascii ARC GRID, in decimal degrees. (Run by hidata4socet.pl) calc_pushbroom_keywords/ --> An ISIS3 program that creates a list file of pushbroom keywords. (Run by hi4socet.pl) Makefile calc_pushbroom_keywords.cpp calc_pushbroom_keywords.xml get_mounting_angles.cpp get_naif_matrices.cpp SS_5.4.1/ bin/ SOLARIS/ calcOrthoBdry dem2isis2 import_pushbroom ortho2isis2 WINDOWS/ calcOrthoBdry.exe dem2isis2.exe import_pushbroom.exe ortho2isis2.exe internal_dbs/ DTM_STRATEGY/ ngate_HIRISE.strategy --> NGATE strategy file for HiRISE images adapt.strat.onepassAfterNGATE --> AATE strategy file used to smooth NGATE results filterpass.strat --> AATE strategy file used with the Difference of Gaussian method described in SOCET_SET_for_HiRISE_June2009.ppt GEODETIC/ --> database files updated with planetary figures datum_name_mapping.dat ellipsiod.dat geodetic.dat geodetic.doc smplugins/ -->Debugged generic pushbroom sensor model SOLARIS/ libSS_USGSAstro_GenericPushbroom_pluginSM.so WINDOWS/ libSS_USGSAstro_GenericPushbroom_pluginSM.dll SOURCE_CODE/ calcOrthoBdry/ -->Report extent of a DEM for orthoimage generation calcOrthoBdry.cpp makefile_calcOrthoBdry.sol makefile_calcOrthoBdry.win dem2isis3/ -->Exports SS DEM of Mars to ISIS3 cubes dem2isis3.cpp makefile_dem2isis3.sol makefile_dem2isis3.win import_pushbroom/ --> Imports a linescanner/pushbroom image Currently supports cameras: MOC-NA, HiRISE and CTX import_pushbroom.cpp makefile_import_pushbroom.sol makefile_import_pushbroom.win ortho2isis3/ -->Exports SS Orthoimages of Mars to ISIS3 cubes makefile_ortho2isis3.sol makefile_ortho2isis3.win ortho2isis3.cpp ---------------------- TUTORIALS_JUNE2009.zip ---------------------- HiRISE_StereoProcessingTutorial_JUNE2009.pdf SOCET_SET_for_HiRISE_June2009.ppt =============================== ISIS MACHINE INSTALLATION STEPS =============================== 1) INSTALL ISIS3 ---------------- Instructions for installing ISIS3 are found at: http://isis.astrogeology.usgs.gov/documents/InstallGuide/index.html 2) INSTALL ISIS MACHINE BINARY FILES ------------------------------------ ISIS_3.1.18/BIN and ISIS_3.1.20/BIN is separated by operating system. For the operating system and ISIS installation of your ISIS processing machine, copy the directory contents to a local directory, and add the location of that directory to your $path. 3) DOWNLOAD AND INSTALL FWTools ------------------------------ FWTools is need for programs ogr2ogr and gdal. ogr2ogr is run by PERL scrpt pedrTAB2SHP_og.pl to convert MOLA tracks from ocentric to ographic latitude coordinates. gdal is run by PERL script isis3gdal_jp2.pl to convert ISIS3 images to JPEG 2000. Download and install ftools/ogr2ogr from: Source: http://trac.osgeo.org/gdal/wiki/DownloadSource Instructions: http://trac.osgeo.org/gdal/wiki/BuildingOnUnix Solaris Notes: http://trac.osgeo.org/gdal/wiki/SolarisNotes Binaries for linux: http://fwtools.maptools.org/ (after uncompressing type "./install" and then place the "bin_safe" directory in your $path). Binaries for MAC: Get GDAL Framework from KyngChaos http://www.kyngchaos.com/ 4) DOWNLOAD AND INSTALL PEDR2TAB -------------------------------- pedr2tab is a Fortran program that generates an ASCII table of PEDR data. It is run by PERL script hidata4socet.pl. pedr2tab is provided for, Sun/UNIX, PC/Windows, and Macintosh platforms. For Linux compiling the Windows version of the code should work. Download pedr2tab from: http://pds-geosciences.wustl.edu/missions/mgs/molasoftware.html#PEDR2TAB 5) INSTALL GLOBAL MOLA DEMs ---------------------------- Copy the contents of DATA/GLOBAL_MOLA_DEMS to a local directory, and Gunzip each ISIS cube. When gunzip'ed, each cube will be 991 MB. 6) DOWNLOAD MOLA PEDR FILES ---------------------------- The MOLA PEDR files contain the MOLA Track data. Copy DATA/GLOBAL_MOLA_PEDR to a local directory with at least 23 GB of space. Then download all pedr files into that directory: Either source the provided script (DATA/GLOBAL_MOLA_PEDR/wget_mola.script), or download the files from http://pds-geosciences.wustl.edu/missions/mgs/pedr.html After files are downloaded, create a list file of all PEDR files, with full path. Name the list file mola_files.txt and place it in your local directory containing the PEDR files. (For an example listing, see GLOBAL_MOLA_PEDR/Example_mola_files.txt) Also in DATA/GLOBAL_MOLA_PEDR is a PEDR parameters file named PEDR2TAB.PRM. Do not modify this file – it is a master file used by PERL script hidata4socet.pl 7) INSTALL PERL SCRIPTS ----------------------- Place contents of ISIS_3.1.xx/PERL_SCRIPTS in a local directory, and add the location of that directory to your $path 8) PERL SCRIPT MODIFICATIONS ---------------------------- hi4socet.pl: ------------ modify line 264 to replace /usgs/dev/contrib/bin/ with the path to your local location of calc_pushbroom_keywords. hidata4socet.pl: --------------- modify line 395 to replace /home/thare/bin/linux/pedr2tab.PCLINUX with your local pedr2tab executable program, and /farm/sci/mola/ with your local path to mola_files.txt ==================================== SOCET SET MACHINE INSTALLATION STEPS ==================================== 1) INSTALL SOCET SET BINARY FILES --------------------------------- SOFTWARE_JUNE2009/SS_5.4.1/BIN is separated by SOLARIS and WINDOWS operating systems. For the operating system of your SOCET SET machine, copy the directory contents into /bin 2) INSTALL PUSHBROOM SENSOR MODEL --------------------------------- SOFTWARE_JUNE2009/SS_5.4.1/ SMPLUGINS is separated by SOLARIS and WINDOWS operating systems. For the operating system of your SOCET SET machine, copy the directory contents into /lib/smplugins. 3) UPDATE GEODETIC FILES ------------------------- Replace /internal_dbs/GEODETIC files with the contents of SOFTWARE_JUNE2009/SS_5.4.1/internal_dbs/GEODETIC. (The same files are used for both WINDOWS and SOLARIS operating systems.) 4) ADD CUSTOMIZED DTM STRATEGY FILES ------------------------------------ Add the contents of SOFTWARE_JUNE2009/SS_5.4.1/internal_dbs/DTM_STRATEGY/ to /internal_dbs/DTM_STRATEGY. (The same files are used for both WINDOWS and SOLARIS operating systems.)