Differences between revisions 20 and 21
Deletions are marked like this. Additions are marked like this.
Line 114: Line 114:
=== KAPLIBS ===
 * New routine kpg1Ch2pm - creates an AST PolyMap from a POLYNOMIAL HDS structure.
 * Routine kpg1_fit1d re-written in C for thread-safety.
 * New routine KPG1_SAXAX added. It sets the attributes of an axis in an AST Frame so that they describe an array component of an NDF.
 * The IPLOT argument of routine KPG1_GRAPH is now "Given and Returned" and must be initialised before calling KPG1_GRAPH.

Starlink Software Collection - Hawaiki Release Notes

  • This page is a work in progress containing the changes that will be in the hawaiki release


  • All Starlink command-line applications now support message filtering using the MSG_FILTER and QUIET parameters. The QUIET parameter can always be used to disable message output from a command. MSG_FILTER can take strings values of "NONE", "QUIET", "NORM", "VERBOSE", "DEBUG", "DEBUG1" to "DEBUG20" and "ALL. Applications that used an ILEVEL parameter now use MSG_FILTER (KAPPA, CUPID and POLPACK). The MSG_FILTER environment variable can be set to one of these values to globally control message output.
  • This is the first release that officially supports SCUBA-2 data processing.
  • The Tcl/Tk libraries have been updated to version 8.5. This improves the appearance of all Tk based applications.

Changes to Applications


  • New commands: astmask, astmatchaxes, astgetregframe.


  • CUPID now propagates provenance information to output files.
  • The ILEVEL parameter has been replaced with MSG_FILTER.
  • MAKECLUMPS - Random clumps parameter values can now be created with a Poisson distribution.
  • FINDCLUMPS no longer creates a border of bad pixels around the edges of the output mask.


  • As issue in the addstar command random number generating function has been fixed. This problem could cause the PAUSE prompt to be issued (sometimes repeatably).


  • ARDMASK can now use an ARD expression like "DIMENSION(2),FRAME(2)" to blank a 2 pixel border around every plane in a 3D cube.
  • The dimensionality restriction on BLOCK has been removed. As a consequence the AXES parameter is withdrawn.
  • A new command called CARPET has been added that, in conjunction with GAIA, can produce a carpet plot of a 2D array.
  • The ILEVEL parameter used by FFCLEAN, MSTATS and WCSMOSAIC has been replaced with MSG_FILTER.
  • FITSLIST has new Parameters ENCODING and FULLWCS allow the list of displayed FITS cards to include cards derived from the NDF WCS component, in addition to those read from the FITS extension.
  • NDFCOPY has a new COMP parameter that permits the QUALITY or VARIANCE component to become the DATA_ARRAY in the output NDF.
  • REGIONMASK can now determine the 2-d plane to mask by matching the region to the N-d frameset.
  • REGRID - METHOD=GAUSS can now be used when re-sampling as well as when re-binning.
  • PROVSHOW can now write the provenance information to a "dot" format file suitable for visualization by tools such as GraphViz or OmniGraffle.

  • SETAXIS now correctly sets the AXIS units to degrees when the selected axis is a celestial longitude or latitude axis. Previously reported radians.
  • WCSTRAN has a new SKYDEG parameter to force a celestial longitude and latitude to be formatted as decimal degrees.
  • No longer report an error if there are too few points for ordered statistics. The median will be set to the bad value.
  • A new standard WCS co-ordinate Frame called "FRACTION" (similar to PIXEL, AXIS, GRID, etc.) has been added. It represents fractional position across the pixel array.
  • Application parameters that take "groups" of values are now stored in expanded form in the history component of any output NDFs.


This release includes major updates for GAIA.

GAIA and Skycat have been updated to use Tcl/Tk 8.5 and most of the associated packages have also been updated. The major visible changes are the arrival of anti-aliased fonts and the updating of some widgets.

The font used for displaying symbols (the alpha and delta symbols shown in the main panel) is no longer required as unicode fonts are now used by default. This also means that unicode symbols can be drawn in overlay text. The font handling for the astrometry grid overlay has also been changed to use anti-aliased fonts and unicode.

Note if you have saved your startup options you will see a message:

  • "Warning: rejected incompatible session persistent option: -wcsfont"

when GAIA starts up. To get rid of this just re-apply the options in the startup options window (File menu).

During this update the ability to get the grid overlay fonts to scale with the zoom factor has been removed. Hopefully now that rotated text is clearer this will not be needed.

Other changes:

  • The X, Y, RA and DEC coordinate readouts have been changed so you can now enter a new position and centre on it (assuming the position isn't off image, or near to an edge, in those cases the image will just scroll to the edge).
  • The Filter button in a Skycat catalogue window has been enhanced so that it now removes any off-image objects, unless there are objects that are not plotted, in which case it removes them (this was the old behaviour).

  • It is now possible to select a colour and font for labelling objects displayed by a Skycat catalogue window. Previously this could only be done using the graphics toolbox facilities.
  • The optional coordinate label in the spectral extraction plot can now have the filename displayed as a prefix to the coordinates of the extraction. To enable this select the Full coordinate label item in the Options menu. Note that this and the old Coordinate label are now session persistent.

  • A problem displaying CUPID catalogues that include extra columns (using the extracols=1 parameter) has been fixed. Previously an Unknown STC shape error was thrown.

  • The detection of compressed images in FITS file has been improved. Previously only those with EXTNAME of COMPRESSED_IMAGE were detected.
  • A bug in the 2D mask toolbox caused GAIA to crash when a given mask didn't exist. This has been fixed.
  • The Skycat catalogue windows now have a Clear all objects item in the Options menu. This quickly clears all the plotting symbols from the image.

  • The UCAC3 catalogue has been added to the standard Skycat catalogues.
  • Short integer data types (FITS BITPIX 16 & -16, HDS _WORD & _UWORD) may now have data display limits outside those of the data type. Previously these data types unexpectably wrapped or refused to extend the contrast when given limits outside the data range.

  • The patch toolbox now says when you have not defined any background regions. Previously an uninformative error dialog was shown.
  • The import plain text file dialog now supports the definition of the RA and Dec celestial coordinate system.
  • If the current directory or the one pointed to by GAIA_TEMP_DIR is not writable temporary files will be written into /tmp instead.
  • The presence of illegal negative variance values should be handled when requesting that they be displayed as errors. Previously this condition caused GAIA to abort.
  • The C-shell initialisation scripts used to start GAIA commands have all been replaced with sh scripts. Any personal aliases etc. based on the old scripts will need to be changed to use the sh replacements.
  • When extracting regions using the regions toolbox the default action is now to also autocrop the result removing any surrounding blank areas.
  • A bug in the positioning of the grid axes when the image has swapped RA and Dec axes has been fixed. Previously an attempt to explicitly position the axes failed.


  • A bug in the gaussian error calculations has been fixed. Previously errors were a factor sqrt(N) too large.


  • The ILEVEL parameter has been replaced with MSG_FILTER


  • First official release supporting SCUBA-2 raw data (rather than simulated data).
  • New command CALCNOISE for calculating the noise properties of a SCUBA-2 observation.
  • New command COPYFLAT to copy a flatfield from one SCUBA-2 observation to another.
  • New command STACKFRAMES for taking a collection of 2d images (eg noise images or responsivities) and placing them into a time series cube.
  • SC2FFT will now concatenate all related files before calculating the FFT.
  • MAKECUBE can now avoid generating very thin tiles when tiling is enabled.
  • MAKECUBE now uses offset sky co-ordinates in the output cube if, and only if, the input tracking system is (Az,El) or geocentric apparent (RA,Dec).
  • JCMTSTATE2CAT now calculate DRA and DDEC columns to indicate arcsecond offsets from base position. Additionally DAZ and DEL are now given as offsets from BASE rather than offsets from the first base position.
  • For SCUBA-2 files JCMTSTATE2CAT will now include MCE header information and will calculate the tau dynamically from the raw WVM data.


  • The meta-data sent with a spectrum via SAMP now includes some SSA version 1 utypes (spectrum.char.fluxaxis.name, spectrum.char.fluxaxis.unit, spectrum.char.spectralaxis.name and spectrum.char.spectralaxis.unit).
  • The statistics window has been extended to include some alpha trimmed means in the extended statistics option.
  • The loading of spectra using SSAP downloads no longer blocks the interface. The previous behaviour was a bug.
  • Support for asynchronous calls from SAMP has been improved.
  • Table spectra sent via SAMP will now preserve the selected columns for coordinates, data and errors. Previously the first three columns were always selected.
  • The line identifier plot configuration options controlling the addition of the id name as a prefix or suffix are now saved between sessions.
  • A bug in the plot configuration for displaying dual sideband line identifiers has been fixed. Previously matching lines from the other sideband where always shown, regardless of the initial setting.
  • A bug when reading back spectra saved as part of a stack has been fixed. Previously when spectra which were really n-dimensional but with only one non-trivial dimension were read back the first axis of the WCS was used as the spectral axis, regardless of whether this was correct or not.
  • The locale used by SPLAT is now fixed to POSIX, this means that all numbers should be entered using decimal notation.
  • The Sesame name resolution service is now the default for SSAP VO queries.

Changes to Libraries


  • Fix truncation error when AGI_USER exceeded 63 characters.


  • Allow the DIMENSION statement to be used to specify a dimensionality that is different to that of the array being masked.


  • New routine atlAddWcsAxis allows new axes to be appended to each frame in a FrameSet.


  • New routine kpg1Ch2pm - creates an AST PolyMap from a POLYNOMIAL HDS structure.

  • Routine kpg1_fit1d re-written in C for thread-safety.
  • New routine KPG1_SAXAX added. It sets the attributes of an axis in an AST Frame so that they describe an array component of an NDF.
  • The IPLOT argument of routine KPG1_GRAPH is now "Given and Returned" and must be initialised before calling KPG1_GRAPH.


  • Message filtering will now look at both the MSG_FILTER and QUIET parameters in addition to the MSG_FILTER environment variable.
  • !msgIfget no longer takes an argument describing the name of the ADAM parameter.
  • New routine !msgIfgetenv to read the message filtering level from the environment.
  • !msgIflev now returns a string representation of the current message filter level.
  • MSG_FLEVOK is now part of the Fortran interface.


  • "%" can now be used to indicate a percentage of the data array in an NDF section.
  • Add a new frame FRACTION providing normalised pixel coordinates that are guaranteed to use the range 0.0 to 1.0.
  • Add AUTO_HISTORY environment variable. If set and true, history will be written to all NDFs created.
  • New routine NDF_ISIN returns a flag indicating if one NDF is contained within another NDF.


  • New routines NDG_BEGGH/NDF_ENDGH allows automatic expansion of "group"-valued parameters when storing the parameter values in the History component of any output NDFs.
  • An input NDF is no longer recorded as an ancestor within the PROVENANCE extension of any output NDFs if the input NDF is contained within another input NDF (e.g. within an extension).


  • The IFL parser now includes two new parameters (MSG_FILTER and QUIET) if they have not previously been defined in the IFL file.
  • Message filtering is now enabled in the fixed ADAM part to allow all applications to benefit from a unified API.

Starlink: Hawaiki (last edited 2010-02-06 02:04:45 by TimJenness)