Isis 2 Documentation
ISIS RELEASE NOTES For February 10, 2005 ISIS Release
This document describes the changes and enhancements that have been made to ISIS since the previous release on October 22, 2004. This is divided into several sections:
We currently support Sun Solaris 9.0 and SuSE Linux 9.0. We have also added support for Mac OS X (see section 10).
LINUX:
We have run extensive tests of ISIS binaries built on Intel/AMD chipsets under SuSE 9.0. The binaries have been successfully exercised on the following Linux distributions:
kernel.................2.4.21-99 gcc....................3.3.1-24 glibc..................2.3.2-88 libgcc.................3.3.1-24 ncurses................5.3-110 perl...................5.8.1-46 OpenMotif..............2.2.2-355 rpm....................4.1.1-71 rpm-build (binaries are in the rpm package)
SOLARIS:
ISIS was built under Solaris 9 on UltraSparc Sun-Fire-V210 hardware using the GNU FORTRAN, C, and C++ compilers with the following components:
gcc....................3.3 libgcc.................3.3 libc...................11.9 ncurses................5.3 perl...................5.6.1 Motif..................2.1.2 pkginfo/pkgchk/pkgadd/pkgrm 11.9
Mac OS X:
ISIS 2.1 was build using Mac OS X version10.3.3 on PowerPC G4 hardware. It has been known to run on G5 hardware also. It was built using the following components:
Kernel.................Darwin 7.3.0 gcc-g++................3.3 20030304 (Build 1495) g77....................3.5.0 20040429 (experimental) perl...................5.8.1 Apple X11..............1.0 Xfree86................4.3.0 OpenMotif..............2.2.4
The IDL display programs in this ISIS release are compatible with IDL Version 6.0.
Refer to the document "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 versions of IDL older than 5.5, and it is recommended that you use IDL 6.0.
Also, in IDL 5.5 there was 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. Thus, accessing HDF/HDF-EOS files with "cv" will not work correctly
On Sun Solaris machines, the default invocation of IDL will execute the 64-bit version. This is incompatable with ISIS which is built in 32-bit mode. To use ISIS applications on Solaris systems (or any 64-bit system that IDL supports), you must start IDL as "idl -32". This will execute the 32-bit version of IDL.
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 (http://wwwflag.wr.usgs.gov/ISIS). 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: lev1stats.pdf - Has been modified to include column numbers for the reported statistical elements; intended for easier reading.
NAIF SPICE Kernels (MGS/MOC)- Updated to include the extended mission mapping cycles 67 through 75. We are currently using version N0056 of the NAIF SPICE Toolkit.
ISIS Release Notes - February 3rd, 2005 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.
isschange - This *NEW* program will convert pixel positions in a matchpoint file to Cassini ISS camera x/y positions in mm.
lochange - This *NEW* program will convert pixel positions in a matchpoint file to Lunar Orbiter camera x/y positions in mm.
All "merlev" programs - Spirit has now exceeded 99 sites, causing the merlev software to calculate an incorrect site frame code. The problem has been corrected.
Cassini ISS Camera Model - A bug in this routine was identified as the cause of a reproducible crash of "qview". Internal data structure was initialized to a reasonable value to prevent this problem.
lev1torand - This program will now write the frame number only as the FSC into the output Rand file instead of the subframe number.
lev2tolev2 - A problem was fixed with a libisislev routine that was causing "lev2tolev2" to die when a TARGDEF was specified with a pathname containing a system logical (such as $ISISDATA).
levinit - This program will now fail on Lunar Orbiter cubes if any of the measured fiducials cannot be found in the lookup table.
levpt - The program was modified so that a DEM can be used as the source for the local radius in a level 1 image. If a DEM is not specified for a level 1 image, then "levpt" will use the ellipsoid defined by the radii in the targdef file as the source for the local radius.
lomarkfid - This program has been updated to run correctly on medium resolution images. The fiducials on medium resolution images are numbered increasing to the right, but the high resolution images are numbered increasing to the left.
pc2d - Added a check to make sure that the input (FROM) file does not contain any ISIS special pixel values. Photoclinometry cannot be done on files with these pixels in them.
qview - A Motif routine with a bug which was causing "qview" to crash has been replaced.
rand2ck1 - This program quit working for Viking_Orbiter data as of the October 22nd, 2004 build. The problem has been corrected.
rand2ck1 - This program adjusts the Lunar Orbiter twist angle input from Rand so that it fits within the ISIS series of rotations.
rand2ck1 - A problem processing the Viking Orbiters was corrected.
sbdr2grid - Fixed so that when an INITFROM image is specified, the input map structure is copied straight into the output map structure before the output file gets created. Also, replaced the ACT_EMISSION_ANGLE option with ACT_INCIDENCE_ANGLE for the raster and control variables because there is no ACT_EMISSION_ANGLE column in the SBDR table.
sbdr2grid - Modified so that any non-character field in SBDR.TBL can be used as the RASTER or CONTROL parameter.
thmirmc - A new parameter, DEGRES, was added to allow the user to specify map resolution in pixels/degree.
thmvismc - A new parameter, DEGRES, was added to allow the user to specify map resolution in pixels/degree. Modified how input filenames are parsed by using the PERL library function basename. This prevents problems when relative pathnames areused.
TAE Menus - The program menus (obtained by typing "menu" (without the quotes) at the TAE prompt) have been updated to include the new programs.
isis_keywords.sav - The keyword SPACECRAFT_CLOCK_START_COUNT was erroneously defined as an integer causing a condition that inhibited users from changing the keyword value (using "labels"). The keyword definition has been changed to string.
SBDR.TBL - Added an extra field to describe the type of data that each field is composed of: Active, Passive, Altimetry, Radiometry, or Scatterometry.
lo_4_hi_fiducials - This table of Lunar Orbiter fiducial positions has been fixed so that it now lists a position for fiducial 148b.
MGS_SCLKSCET.00056.tsc - A *NEW* MGS mission MOC clock kernel (SCLK) supplied by NAIF (see$ISISMGSDATA/moc_kernels.def.13).
MGS_SCLKSCET.00057.tsc - A *NEW* MGS mission MOC clock kernel (SCLK) supplied by NAIF. It is now the default SCLK used in all ISIS applications (see $ISISMGSDATA/moc_kernels.def.14).
isis_moc_kernels.txt - A descriptive and "how to" text file - updated to reflect the 15th, 16th and 17th extended mission phase.
moc_helio.tab - This file contains the helicentric distance from MARS to the SUN and is used to calibrate MOC images in moccal. It previously only contained data up to July 7, 2004. It has been updated to extend the data set to Dec 31, 2005.
moc_kernels.def.13 - A *NEW* MGS/MOC SPICE kernels definition file containing a comprehensive prioritized list of the MGS/MOC SPICE kernels available in the ISIS system.
moc_kernels.def.14 - A *NEW* MGS/MOC SPICE kernels definition file containing a comprehensive prioritized list of the MGS/MOC SPICE kernels available in the ISIS system. It is now the default SPICE kernels definition file used in all ISIS applications.
mgs_ext15.bsp - A *NEW* MGS mission MOC SPK kernel that covers the 67th, 68th, and 69th 28-day mapping cycles of the Extended phase of the mission (mapping orbits 22622 through 23648):
COVERAGE BEGIN TIME (TDB): 2004 MAR 31 00:00:00.000 COVERAGE END TIME (TDB): 2004 JUN 23 01:00:00.000
mgs_ext16.bsp - A *NEW* MGS mission MOC SPK kernel that covers the 70th, 71rst, and 72nd 28-day mapping cycles of the Extended phase of the mission (mapping orbits 23649 through 24675):
COVERAGE BEGIN TIME (TDB): 2004 JUN 23 00:00:00.000 COVERAGE END TIME (TDB): 2004 SEP 15 01:00:00.000
mgs_ext17.bsp - A *NEW* MGS mission MOC SPK kernel that covers the 73rd, 74th, and 75th 28-day mapping cycles of the Extended phase of the mission (mapping orbits 24676 through 25702):
COVERAGE BEGIN TIME (TDB): 2004 SEP 15 00:00:00.000 COVERAGE END TIME (TDB): 2004 DEC 08 01:00:00.000
mgs_sc_ext15.bc - A *NEW* MGS mission MOC CK kernel that covers the 67th, 68th, and 69th mapping cycles of the Extended phase of the mission:
COVERAGE BEGIN TIME (UTC): 2004-MAR-31 00:00:59.921 COVERAGE END TIME (UTC): 2004-JUN-22 23:59:54.683
mgs_sc_ext16.bc - A *NEW* MGS mission MOC CK kernel that covers the 70th, 71rst, and 72nd mapping cycles of the Extended phase of the mission:
COVERAGE BEGIN TIME (UTC): 2004-JUN-23 00:00:30.681 COVERAGE END TIME (UTC): 2004-SEP-14 16:53:05.438
mgs_sc_ext17.bc - A *NEW* MGS mission MOC CK kernel that covers the 73rd, 74th, and 75th 28-day mapping cycles of the Extended phase of the mission (mapping orbits 24676 through 25702):
COVERAGE BEGIN TIME (UTC): 2004-SEP-15 19:13:41.420 COVERAGE END TIME (UTC): 2004-DEC-07 23:59:56.167
*mgs_map.bsp - *NOTE: This file is included in ISISMGSDATA, however it is recommended that you use mgs_map_rec.bsp* - An updated MGS mission MOC kernel. Coverage times are:
COVERAGE BEGIN TIME (UTC): 2004 DEC 07 23:58:55.817 COVERAGE END TIME (UTC): 2005 FEB 14 13:08:55.815
mgs_map_rec.bsp - An updated MGS mission MOC SPK kernel. Coverage times are:
COVERAGE BEGIN TIME (UTC): 2004 DEC 07 23:58:55.817 COVERAGE END TIME (UTC): 2005 JAN 23 16:43:55.815
ORB1_SCLKSCET.00093.tsc - A *NEW* M01 Odyssey mission clock kernel (SCLK) supplied by NAIF. It is now the default SCLK used in all ISIS applications (see $ISISM01DATA/thm_kernels.def.5).
ORB1_SCLKSCET.00098.tsc - A *NEW* M01 Odyssey mission clock kernel (SCLK) supplied by NAIF. It is now the default SCLK used in all ISIS applications (see $ISISM01DATA/thm_kernels*.def.6 files).
thm_kernels.def.5 - A *NEW* M01 Odyssey SPICE kernels definition file containing a comprehensive prioritized list of the M01 SPICE kernels available in the ISIS system.
thm_kernels.def.6 - A *NEW* M01 Odyssey SPICE kernels definition file containing a comprehensive prioritized list of the M01 SPICE kernels available in the ISIS system. It is now the default SPICE kernels definition file used in all ISIS applications.
thm_kernels_both.def.5 - A *NEW* M01 Odyssey SPICE kernels definition file. It contains a comprehensive prioritized list of the M01 CK SPICE kernels available in the ISIS system, along with the new "fake" nadir SPICE files that use nominal nadir-pointed orientation to fill in gaps in the "regular" M01 CK files.
thm_kernels_both.def.6 - A *NEW* M01 Odyssey SPICE kernels definition file. It contains a comprehensive prioritized list of the M01 CK SPICE kernels available in the ISIS system, along with the new "fake" nadir SPICE files that use nominal nadir-pointed orientation to fill in gaps in the "regular" M01 CK files. It is now the default SPICE kernels definition file for people who want to include the nadir definitions with the "normal" CK definitions when using ISIS applications.
thm_kernels_nadir.def.5 - A *NEW* M01 Odyssey SPICE kernels definition file. It contains a comprehensive prioritized list of the M01 SPICE kernels available in the ISIS system along with the new "fake" nadir SPICE files that use nominal nadir-pointed orientation to fill in gaps in the "regular" M01 files.
thm_kernels_nadir.def.6 - A *NEW* M01 Odyssey SPICE kernels definition file. It contains a comprehensive prioritized list of the M01 SPICE kernels available in the ISIS system along with the new "fake" nadir SPICE files that use nominal nadir-pointed orientation to fill in gaps in the "regular" M01 files. It is now the default SPICE kernels definition file for people who want to include the nadir definitions when using ISIS applications.
m01_map10.bsp - A *NEW* M01 Odyssey SPK kernel that covers part of the mapping phase of the mission. Coverage times are:
COVERAGE BEGIN TIME (TDB): 2004 APR 01 00:00:00.000 COVERAGE END TIME (TDB): 2004 JUL 01 01:00:00.000
m01_map11.bsp - A *NEW* M01 Odyssey SPK kernel that covers part of the mapping phase of the mission. Coverage times are:
COVERAGE BEGIN TIME (TDB): 2004 JUL 01 00:00:00.000 COVERAGE END TIME (TDB): 2004 OCT 01 01:00:00.000
m01_map.bsp - A *NEW* "on-going" M01 Odyssey SPK kernel that covers the mapping phase of the mission from the date of the last "normal release" SPK kernel (in this case m01_map9.bsp). Coverage times are:
COVERAGE BEGIN TIME (UTC): 2004 SEP 30 23:58:55.818 COVERAGE END TIME (UTC): 2004 DEC 26 23:58:55.816
m01_map_rec.bsp - A *NEW* "on-going" reconstructed M01 Odyssey SPK kernel that covers the mapping phase of the mission from the date of the last "normal release" SPK kernel (in this case m01_map9.bsp). Coverage times are:
COVERAGE BEGIN TIME (UTC): 2004 SEP 30 23:58:55.818 COVERAGE END TIME (UTC): 2004 DEC 08 14:03:55.817
m01_sc_map10.bc - A *NEW* M01 Odyssey CK kernel that covers part of the mapping phase of the mission. Coverage times are:
COVERAGE BEGIN TIME (UTC): 2004-APR-01 00:00:01.441 COVERAGE END TIME (UTC): 2004-JUN-30 23:59:59.927
m01_sc_map11.bc - A *NEW* M01 Odyssey CK kernel that covers part of the mapping phase of the mission. Coverage times are:
COVERAGE BEGIN TIME (UTC): 2004-JUL-01 00:00:03.728 COVERAGE END TIME (UTC): 2004-SEP-30 23:59:58.963
m01_sc_map10_rec_nadir.bc - A *NEW* M01 Odyssey CK kernel providing nominal nadir-pointed orientation that covers part of the mapping phase of the mission. Coverage times are:
COVERAGE BEGIN TIME (UTC): 2004 APR 01 00:28:55.813 COVERAGE END TIME (UTC): 2004 JUL 01 01:00:00.000
m01_sc_map11_rec_nadir.bc - A *NEW* M01 Odyssey CK kernel providing nominal nadir-pointed orientation that covers part of the mapping phase of the mission. Coverage times are:
COVERAGE BEGIN TIME (UTC): 2004 JUL 01 00:28:55.815 COVERAGE END TIME (UTC): 2004 OCT 01 01:00:00.003
m01_sc_map_nadir.bc - A *NEW* "on-going" M01 Odyssey CK kernel providing nominal nadir-pointed orientation that covers the mapping phase of the mission from the date of the last "normal release" CK kernel (in this case m01_sc_map9_rec_nadir.bc). Coverage times are:
COVERAGE BEGIN TIME (UTC): 2004 OCT 01 00:28:55.818 COVERAGE END TIME (UTC): 2004 DEC 26 23:28:55.816
m01_sc_map_rec_nadir.bc - A *NEW* "on-going" M01 Odyssey reconstructed CK kernel providing nominal nadir-pointed orientation that covers the mapping phase of the mission from the date of the last "normal release" CK kernel (in this case m01_sc_map9_rec_nadir.bc). Coverage times are:
COVERAGE BEGIN TIME (UTC): 2004 OCT 01 00:28:55.818 COVERAGE END TIME (UTC): 2004 DEC 08 13:33:55.815
Cassini ISS Camera Model - A bug in this routine was identified as the cause of a reproduceable crash of "qview'. Internal data structure was initiatialized to a reasonable value to prevent this problem.
lev1_calc_resolution.c - Modified so that the DEM information gets copied to the data structures before calling the lev1_linesamp_to_latlon routine.
lev1_linesamp_to_latlon.c - Modified so that a DEM can be used as the source for the local radius of a level 1 image.
lev1u_frame_routines.c - Modified lev1u_frame_pointing_to_cls routine so that testing of tolerance between old and new pointing is not checked when a DEM is being used as the source for the local radius in a level 1 image.
lev1u_lo_linesamp_to_camxy.c - This is a *NEW* routine that will compute the Lunar Orbiter high resolution camera x/y coordinates from a pixel position in an image.
lev1u_lo_med_linesamp_to_camxy.c - This is a *NEW* routine that will compute the Lunar Orbiter medium resolution camera x/y coordinates from a pixel position in an image.
lev1u_css_iss_linesamp_to_camxy.c - This is a *NEW* routine that will compute the Cassini ISS camera x/y coordinates from a pixel position in an image.
levu_not_implemented.c - This is a *NEW* routine that issues an error message if called and is the default linesamp_to_camxy routine for all missions.
lev1u_cass_vims_routines.c - Fixed bug in Vims camera model which caused "garbage" around the edges of some projected vims images.
levu_init_target_from_user.c - this routine was fixed so that it properly translates the pathname of the TARGDEF parameter when a system logical is specified (such as $ISISDATA).
levdem.h - Added useradius and demradius items to the dem structure. These two new items are needed when calculating the line, sample resolutions in a level 1 image that uses a DEM as its source for the local radius.
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.
The Mac OS X operating system is now officially supported with this release. ISIS for the Mac (Darwin) operatin system is released as version 2.2.0 but should be conceptually viewed as the same as 2.1.3, the release for Linux and Solaris.
Mac ISIS has undergone some structural changes. Some libraries have been consolidated into a single library and some changes in code expressly to support the Mac OS have been made. We will be migrating Linux and Solaris to the 2.2.x version soon and a subsequent release will be forthcoming.
Here is a brief summary of the major changes that has occured in Mac ISIS that is unique to this release:
Photoclinometry Library Consolidation - The ISIS libraries libisisclinom, libisisfastfil, libisiss9fast have been incorporated into libisispht thus merging all the photoclinometry libraries into one.
Overhaul of Make system - ISIS 2.2.0 has undergone an overhaul of the make system to enable support of some elements unique to the Mac. This work is unfinished and will continue with the integration of Linux and Solaris operating systems.
See http://isis.astrogeology.usgs.gov/IsisSupport/viewtopic.php?t=124 for more information on this topic.
Contact us online at the Isis Support Center: http://isisdist.wr.usgs.gov