Release Notes:
Isis 2 Documentation
Release Notes:
ISIS RELEASE NOTES For March 20, 2003 ISIS Release
This document describes the changes and enhancements that have been made to ISIS since the previous release on January 30, 2003. This is divided into several sections:
We currently support Sun Solaris 2.6 and RedHat Linux 6.1. ISIS will run on Redhat 7.2 and 7.3, but we have not yet verified the results. However, if you intent to use either of these operating systems you will need to download and install the appropriate Redhat ncurses4-5.04 library RPM for i386. The objective here is to install a libncurses.so library that is compatible with both ISIS and RedHat 7.2 or 7.3.
The IDL display programs in this ISIS release are compatible with IDL Version 5.4. We have discovered minor bugs when using the ISIS program "cv" in IDL 5.2 that are still present in IDL 5.4. Please see the Known Bugs page for a discription of these bugs. In addition, refer to Notes on Use of the IDL Display Programs for proper display setup instructions.
Most of the ISIS IDL programs and routines use the CALL_EXTERNAL function to call Fortran/C routines. The CALL_EXTERNAL interface was changed in IDL 5.5. Thus, most of the ISIS IDL code will not work correctly with IDL 5.5. (Also, in IDL 5.5 there is a change in the parameters to the IDL routines that access HDF/HDF-EOS files. The "cv" program has not yet been updated to account for these changes.)
The $ISISDOC directory contains Release Notes for each release of ISIS. These are contained in files named "isisYYMMDD_release.notes" or "isis_release_notes.YYMMDD", where YYMMDD is the date of the ISIS release. Each Release Notes file describes changes in the system since the previous release.
The current documentation for a release of ISIS is contained in a set of files in the $ISISHTML directory, which is part of the local ISIS installation. These are in a format that can be accessed with a web browser. For example, to view the local copy of the ISIS documentation with netscape, type:
netscape $ISISHTML/documentation.html
You can also access the ISIS documentation over the Internet at the ISIS web site. However, note that the documentation on the ISIS web site is updated each time updates are made to our internal developmental version of ISIS. Thus, the web site documentation might contain information on new or modified programs that are not yet contained in the public release of ISIS that is described in your local $ISISHTML directory. However, the web site can be used for registering to receive update notices and for looking at the latest version of the Frequently Asked Questions list.
In addition to new documentation for the new programs and minor updates to documentation for previously existing programs, the following are some additional program documentation updates: NONE
ISIS Release Notes - March 20th, 2003 Release Notes have been linked. These notes include descriptions of the new updates included in this release.
ISIS Program List - Alphabetical and ISIS Program List - Menu Categories - Updated these two pages with new ISIS programs.
ISIS Installation Guide - Updated for the March 20, 2003 release - Added the new PDPLOT utility to the ISIS base kit installation.
All support is now handled through the Isis Support Center.
Mars Odyssey THEMIS Geometry Processing With ISIS - Updated to reflect the software changes as of the January 30, 2003 ISIS update.
lev1prop - This *NEW* program propagates Level 1 keyword groups (ISIS_TARGET, ISIS_GEOMETRY, ISIS_INSTRUMENT) from an input file to a pre-existing output file.
linfit - This *NEW* program computes the coefficients of the linear least squares fit of two or three images.
lomarkfid - This *NEW* program will create a copy of the input file with the fiducials labeled based on a beginning position entered by the user.
pc2d - This *NEW* program provides the capability to do two-dimensional photoclinometry in an interactive environment. There is a web page forthcoming that will describe how to set up your environment to use this program and how to use the program.
pho_emp_global - This *NEW* program fits empirical photometric functions to Hapke for a range of phase angles. See pdf for details.
pho_emp_local - This *NEW* program fits empirical photometric functions to Hapke for a single geometry (rather than for a range of phase functions as in pho_emp_global). See pdf for details.
Old map projection programs (nuproj, etc) - now recognize the EQUIDISTANT_CYLINDRICAL map projection (produced by the "Levels" software).
cubeavg - Added the option to output a cube file containing the sums of the input cubes.
labels - Increased the allowable number of entries in the file containing label keyword values.
lev1tolev2 - This program has not been generating the desired default values for the mapping parameters since it was changed in October 2001. The problem has been corrected.
lev2tolev2 - This program has not been generating the desired default values for the mapping parameters since it was changed in October 2001. The problem has been corrected.
losupport2ck1 - User inputs have been simplified to be more consistent with other LO programs and avoid parsing problems when run in a script.
makespk09 - User inputs have been simplified to be more consistent with other LO programs and avoid parsing problems when run in a script.
qview - Read/Write reseau valid flag and increase the floating point precision of the reseau positions when writing to the output.
TAE Menus - The program menus (obtained by typing "menu" (without the quotes) at the TAE prompt) have been updated to include the new programs.
NONE
NONE
NONE
lo_parameters.def.1 - This file is now stored in the ISISLODATA area along with lo_parameters.def.2.
NONE
thm_parameters.def.7 - The empirical optical distortion correction parameters for both IR and VIS were updated. This includes correction to IR Band 10 that is an extrapolation from the corrections for the other bands. The change in band-to-band registration for VIS and IR Bands 1-9 should be very small.
NONE
vgr_kernels.def.1 - This file now includes a pc kernel so that the complete set of planetary constants is used to project to and from the surface of the target bodies.
libisisclinom - This *NEW* library contains subroutines related to clinometry.
libisisfastfil - This *NEW* library provides the ability to perform a fast, flexible boxcar filter on a REAL*4 array in memory. The algorithm was developed by Eric Eliason and was then modified to operate on an array resident in memory. The library was originally developed for use in photoclinometry, but is general enough to be used in other programs.
libisispht - The make file now includes the pht_get_hapke_img subroutine
libisiss9fast - This *NEW* library contains routines for fast iterative solution of the sparse matrix equations arising from finite element or difference methods with a 3x3 molecule on a rectangular mesh. The molecule may be spatially varying but the weight relating any two nodes must be independent of their order, so that the resulting matrix is symmetric. These routines are used by the two-dimensional photoclinometry software, but may be of interest for other applications such as geophysical modeling.
pht_func - Fixed a problem in which the subroutine was incorrectly comparing char_pht_function with the character string 'HAPKES' to determine if smooth Hapke will be performed. The subroutine now compares char_pht_function with the character strings 'HAPH_S' and 'HAPL_S' to determine if smooth Hapke will be performed.
pht_get_hapke_img - Added support for 1st and 2nd order Henyey-Greenstein.
spi.h - Added spi_phosun to the list of prototypes.
spi_bind_F.c - Added binding for spi_phosun.
Our Perl scripts require that you have Perl installed in /usr/bin. If you have Perl installed in a different directory you need to set up a link between your location and /usr/bin/perl. To accomplish this you need to determine the absolute path name of your Perl executables. Then type the following at the command line:
This will estabish a softlink between our perl scripts and your Perl exectables. If you don't have root priviledges you will have to see your Sys-Admin person to execute this command.
If you use and develop your own Perl scripts and modules you may be using the PERL5LIB environment variable. If you are, please be aware that we are also setting this variable in the ISIS startup scripts to point to our Perl modules. Our startup scripts will check to see if you have PERL5LIB defined and then append to your path list (and not overwrite it). Therefore, if you are defining this variable, it is important to so before initiating ISIS. If you define PERL5LIB after initiating ISIS, you may overwrite our ISIS Perl path names and our Perl scripts will not operate correctly. <End of Release Notes>
Contact us online at the Isis Support Center: http://isisdist.wr.usgs.gov