Release Notes:

The ISIS system has been revised as of February 14, 1997. The following is a list of changes and enhancements that have occurred since the last version was released on August 19, 1996.

addspec
"addspec" - Changed the name of the SPECFILE parameter to TBLFROM.

Changed the name of the MULT parameter to MUL and changed its default value from -1.0 to +1.0. (It seemed like the default action of a program called "addspec" should be addition rather than subtraction.) Revised the user documentation.

automos
automos.pdf has been changed so that the user can now enter almost all the parameters that are used in mosaic from the automos pdf. Previously automos used the default mosaic values for most of the mosaic parameters. Also, a change was made in the way the scale is checked for all the images. Images that the scale difference is very small will now be treated as equal and the program will not fail.

avg_sd
The avg_sd program has been modified to compute the average and/or standard deviation for backplanes in the input file. The user also may bypass computing the average and/or standard deviation for the core if they wish. See the pdf for further details on the new tae paramters.

back2core
"back2core" - This is a new procedure PDF that copies a set of backplanes from an existing cube file to a newly-created cube file by running "zero" and "bandcopy". (This is useful for such things as copying spectral unmixing fraction backplanes into core planes for RGB color composisite display by "qview" or output to the film writer.)

bandcopy
"bandcopy" - This is a new program that is a Unix port of Bob Mehlman's BANDMOVE program in the VMS version of ISIS. This program copies a core band or a backplane from one cube file into a core band or backplane of a second existing cube file. If a backplane containing Region of Interest (ROI) definitions is copied to a backplane of the second file, then the ROI description keywords in the label are also copied to the output file.

bandtab
"bandtab" - The user description was updated and the names of the parameters were changed to conform to current standards.

base2l1
A new program was brought over to the system from vax called "base2l1". It will create the transformation data file (TFILE) for "geom" (see "geom" for more information) to project a Clementine, Galileo, Mariner, Viking or Voyager "level2" cube or mosaic from a map projection to "level1" geometry using a "level1" cube-to-match. There is more explanation in the pdf help. The program 'base2l1' has been changed so that the user's input, falseno, gets transmitted to jigsaw as product ID.

cleanlab
The "cleanlab" program has been modified. The parameter (CLRHST) used to initialize the HISTORY has been renamed to "INITHIST" to be consistant with the "labels" program parameter. The PDF help content has also been updated and rectified to ISIS PDF standards and user feedback.

clemgoup
CLEMGROUP has been changed to put the word MISSINGDATA in any column that did not have a value (was blank).

CLEMGROUP was changed to check for duplicate entries (or files in the same exposure set). It will also print a line of MISSINGDATA when there is only one exposure to a set instead of two.

clemprod
The Clementine application clemprod had a bug where a variable was not initialized prior to its use. This problem became apparent when we optimized the DEC Alpha version of ISIS. It is impossible to predict how it behaves on other platforms because of the problem. Indications are that it has worked ok.

cpylab
Some bugs have been fixed in cpylab. Also, the MGN option has been removed because this option was no longer needed.

One of the COPY options has been changed in cpylab. Previsously the four options for COPY were "MATCH", "SPICE", "BANDBIN", and "ALL". THE "ALL" option has been changed to "LIST". This change should remove some confusion about what the program does when LIST is chosen. The program will copy the keywords that are listed in the isis_keywords.sav file. Any keyword listed in the isis_exclude_keys.sav file will not be copied with the LIST option.

Some bugs have been fixed in CPYLAB. The image_map_projection group will now be copied correctly and a problem was fixed in the COPY = LIST option.

cubeavg
There is a new program, cubeavg, which creates a spectral average from a multi-band input cube. See pdf for more information.

cubeit
Cubeit has a new user parameter that will increase the history size of the output cube. See Tracie have you have any questions.

cubespec
"cubespec" - Changed the name of the TABLEFIL parameter to TBLTO and changed its length from 64 characters to 128 characters. Changed the default ASCII format (recorded in the output table file) from F10.2 to F12.4 for the AVERAGE, MIN, MAX, and SIGMA columns. Revised the user documentation.

cv
The following changes were made to the CV display program:

1. The Region of Interest Control panel was modified. Two "Write File" functions were added. "Stats to Table" writes statistics for the currently selected region to a table file. "All Means to ISL" writes the average spectra for each reagion to an Instrument Spectral Library file. (This file can then be used to supply the spectral endmembers for the spectral unmixing program.) The "Turn Off" button was changed to "Turn Off/On" so that it toggles the overlay display of the currently selected region. The "New Plot"/"Update Plot" droplist widget has been added to allow selecting the plotting mode. "New Plot" creates a new plot window each time a plot function is selected. "Update Plot" replaces the contents of the latest plot window that has the same type (if it still exists).
2. The format of the numbers in the statistics listing was changed to show four digits after the decimal point (rather than two).
3. The spectral profile plot is now updated only when the sample and/or line coordinate changes. This eliminates re-plotting when the cursor is moved within a zoomed pixel.

The ability to use the "Development" area for IDL programs (e.g., CV) has been added. As before, by default, IDL programs are run out of the standard ISIS system executable area. The user can type the following command at the operating system prompt to switch to using the "develpment" version of IDL programs: setdevidl
If you desire to switch back to using the IDL programs that are in the standard system area, you can re-source your .cshrc file.

The following changes were made to the CV display program:

1. The "Functions" menu on the top level menu bar was divided into a "Functions" category and a "Cursor Functions" category (which now includes the functions that dynamically display information as the cursor is moved over a display window).
2. The "ISL Viewer" function was added to the "Functions" category in the top level menu bar. This new function allows several options for plotting spectra contained in Instrument Spectral Library files. This also allows listing of items from the spectral headers of ISL entries.
3. The "Region of Interest" function was updated so that more information is written to the spectral headers when the means of all regions are written to an ISL file.
4. The plotting windows have been changed to allow deleting a data set that is being plotted. To delete a data set, click the RIGHT mouse button on the name of the data set. (Note that you must now click with the RIGHT mouse button BELOW the names to turn off the display of the names.) As usual, the on-line "help" files have been updated to describe these changes. $ISISEXE/cv.hlp is a text file that contains the complete description of CV. $ISISEXE/cv_islviewercon.hlp is a text file that describes the new ISL Viewer function.

"cv" - The region of interest function was changed to write more

information to the ISL file that contains average spectra for all regions. The ISL Viewer function was changed to show more information in the spectrum header listing. When you exit from "cv", the colormap translation table mode is now reset to the "normal" default value. (This will prevent the occurrance of incorrect colors on the display if another IDL program is run after you exit from "cv".)

"cv" - The Instrument Spectral Library viewer was updated to show additional spectral header items (which are produced by the "specpr2isl" program).

findmatch
New parameter was added to findmatch called DOSD to match the parameter of the same name that was added to matchpt.

findrx
The findrx program was modified to read the new nominal location files and template files. A change was also made to print the name of the nominal file used to the session log file.

fit
Also, a bug was found in the plotting of data in the print.prt log file by the "fit" program. The data plot was incorrect, however, the line of best fit was correct.

fixlucas
The documentation for FIXLUCAS has been updated thanks to input from reviewers. fixlucas was corrected to only reverse the orientation of the longitude for lunar cubes only.

geoback
Two new backplanes have been added to GEOBACK. The default is set to "NO" for both new planes. They are LATITUDE and LONGITUDE. No programs are currently using these backplanes (but there will be one soon). See Kay if there are problems.

grid
Problems running GRID on Alpha's should be fixed.

histplane
"histplane" switched the high instrument saturation and high representation saturation counts in the print file. I have corrected the problem.

hstret
"hstret" - Changed the name of the STRFILE parameter to TBLTO and gave it a default value ("strtable.tbl"). Changed the name of the TBLOBJ parameter to OBJNAM. Revised the user documentation.

lab2spice
LAB2SPICE has been updated with improved documentation.

labels
A bug was fixed in the labels program which caused the file_state to be set to dirty when the user attempted to change an invalid keyword.

makeflat
The makeflat program has been changed to use memory allocation which enables the program to work for any size input image as long as the machine running the program does not run out of memory.

maketopo
A new program was added to the system called MAKETOPO. There may be no need for this program until someone starts working on astroids. See the documentation for details.

multimatch
"multimatch" has been updated so that the default saturation percent to use for the automatic display range computation has been changed from 0.5 percent to 0.25 percent. Note that when you run "multimatch," you can override the default "tvtie" parameters by specifying desired values on the command line. The names of these parameters are the same as the names of the "tvtie" parameters. For example, to use a different set of saturation values: IDL> multimatch, 'no3match.fil', losat1=0.1, hisat1=0.3, losat2=0.1, hisat2=0.3

naiflab
"naiflab" has been updated and Galileo SPICE data has been installed for reconstructed G1 and G2 and predict C3.

nuproj
A problem was found with NUPROJ when reprojecting an image with map rotation. The output image still had the rotation in the labels even though it was projected correctly with no rotation. The problem was corrected by always putting the correct map rotation in the labels even if it is 0. The same is true of reference latitude and reference longitude.

A change was made to the distortion correction routine that should not affect anyone but people working with images run thru NOPROJ.

A change was made to NUPROJ to handle images less than 64 pixels square.

photom
A change has been made to the albedo option in photom so that the phase angle used in normailizing to the Buratti function is 2.0 instead of 3.5.

photompr
The sfrom parameter has been added to both photompr and photom. This will allow the users to extract out a single band from a multiband cube and process the data using photompr and photom.

Also the functionality was added to photom to output the processing parameters used in photompr to the output cube file history label.

photopt
PHOTOPT has been updated with improved documentation. A request has been made to rename the program.

PHOTOPT has been renamed B4EQUAL.

photostat
Some minor updates have been made to PHOTOSTAT so that it won't choke on images with no SPICE.

pointvu
POINTVU will project spacecraft image cubes of irregular bodies such as Phobos or Amalthea to a map projection. One of three map projections may be used: Sinusoidal equal-area, Simple cylindrical or Orthographic. See documentation for details.

random
The number of control points RANDOM can handle has been increased to 2500.

ratiocs
"ratiocs" - Changed the name of the SPECFILE parameter to TBLFROM.

Changed the name of the MULT parameter to MUL. Revised the user documentation.

regcolor
A new procedure called REGCOLOR has been written. The camera angles of all cubes in a color set must be corrected with TVMATCH and JIGSAW before this procedure is used. This procedure will find the latitude and longitude range common to all the cubes in the set using PHOTOSTAT and run PLANORTH or PLANSINU and GEOM to create a set of cubes that will be the same size and have the same mapping parameters so that they can be merged into a multi-band cube.

A test has been added to REGCOLOR to check longitude range and keep it within 180 degrees of the center longitude.

The size of the file names was increased to the standard 128 characters and more documentation was added to REGCOLOR.

specpr
New SPECPR format spectral library files in $ISISDATA (can be used as input to the "specpr2isl" program):

        NimsLib - Wendy Calvin's collection of spectra convolved to
                a set of NIMS wavelengths (29 Spectra at 408 Wavelengths
                (0.6984 to 5.2264 micrometers))
        aglib001 - Spectra from the Pilot Land Data System
                (430 Spectra at 826 Wavelengths (0.400 to
                2.500 micrometers))
        aglib002 - J. Salisbury IR Spectra 2.1-25 um
                (488 Spectra at 2287 Wavelengths (2.0795 to
                25.0442 micrometers))
 

specpr2isl
"specpr2isl" - This is a new program that translates Roger Clark's SPECPR spectral library files into ISIS Instrument Spectral Library (ISL) format.

spice2rand
spice2rand had a bug that caused it to not work correctly when the nomat and err=BOTH options were used. The error occurred in the nomat file if the first image in the list did not have any match points in its label. The problem has been fixed.

SSICAL
PDF documentation was updated, and the program no longer prints the warning message for mismatch of GAIN_MODE_ID between input file and gain file.

ssidata
The Galileo SSI SPICE has been altered to include the updated spacecraft trajectory data for G2 and C3.

stretch
A new feature has been added to the stretch program. There are five new TAE parameters that will allow the users to change the special pixel values found in the input file to a valid value that the user enters in the output file. The default null (--) value for each of these parameters will cause the program to propogate the special pixel values from the input file to the output file unchanged. See the pdf for more details.

A change has been made to the camera distortion subroutine to allow for "NOPROJed" images. There should be no change to your images if you are not using NOPROJ.

Note to NOPROJ users: not all software is in place for fixing problems with QVIEW.

A new TAE parameter, SATURAT, has been added to the stretch program. Set this value to "YES" if you wish to set those values that lie outside the minimum and maximum stretch values to the special pixel values, low- or highrepresentation saturation values. Set this value to "NO" if you wish to stretch those values that lie outside the minimum and maximum stretch values the same as those that fall within the minimum and maximum stretch values. Some documentation changes were made also.

tvtie
The error saying the point was off the planet when doing the subpixel registration in tvtie has been corrected to indicate the point is too close to the edge of the image.

u_error
A new version of u_error has been installed that allows the programmer to turn off error reporting to the screen or log file. The new routine called u_set_erract is located within the source code for u_error. For details about the calling parameters, look in the u_error.c source code for the routine u_set_erract. No changes are required to existing code if you do not wish to turn off error reporting.

uvviscal
The problem with uvviscal on the Alpha's has been corrected. You will now get the exact same values when you run uvviscal on the Sun's and Alpha's.

warp3
Another new program was added to the system called WARP3. This program will interpolate spot elevations or contour lines. This algorithm is unbelievably slow but might be useful for small files. This program was also developed for future work on astroids. See documentation for details.

VIKCAL
PDF documentation was updated, and a bug using 8 or 16-bit dark current files was corrected. There is also a new user parameter which determines where the data file is written when SPT_FLAG is set to YES. A bug was fixed which caused the file_state to be set to dirty when the user attempted to change an invalid keyword.

The PDFs cleanlab.pdf, convert.pdf and str2int.pdf have been edited as a result of user feedback. They adhere to ISIS PDF standards.

The following non-program specific changes were also made.

The Naif planet kernel was updated to include the latest values for Mercury.

The latest spice files from Mert Davies for Mariner 10 are now in the system.

A missing Galileo SSI Callisto c-kernel file has been installed on the alphas.

The Galileo SSI spacecraft kernels have been updated to include reconstructed E4 data and updated predict for the remainder of the mission. Also the predict c-kernel for day 12/19/96 had been updated.

The reconstructed spacecraft kernel for pre-Jupiter Galileo SSI released on 12-13-96, has been installed in ISIS. Also predict camera pointing for E04 has been installed. The predict spacecraft kernel for E04 was installed earlier. Please contact Debbie Cook if you have any questions.

An infrequent (but potentially harmful) bug has been fixed in the label parsing software. Its fix may result in more efficient label parsing and updating. Please report any anomilies you may encounter that cannot be directly attributed to pilot error, programming errors, etc...

The camera pointing is available for the Galileo E-6 encounter.