E Changes in Version 3.1

• New C function kpg1Config gets a KeyMap containing configuration parameters from the user, with name checking and default values supplied.
• The new routine KPG1_DSSFM displays information about the storage form of an NDF array.
• There is a new generic routine KPG_FISEx that fills a section of a multi-dimensional array.
• The new KPG1_GTGPT routine is a variant of KPG1_GTGRP to obtain groups of strings. KPG1_GTGPT supports group members that are not ‘sticky’, in other words the strings only last for the current invocation of an application.
• The new more-general KPG_ISEQN replaces the old IRCAM-specific NXTNAM routine. This increments trailing sequence numbers in strings, most often used to generate a series of filenames.
• Add new routine KPG_LR2Ax that is the same as KPG_LDA2x (formerly LD2AR) except it processes single-precision sparse data.
• There is a new routine KPG_NORVx to replace the old NORMAL. It has the benefits of being generic and can operate on an array.
• KPG_OSTAx added. It uses recurrence formulae to calculate simple statistics robustly. It also extends KPG1_STATx by deriving the skewness and kurtosis.
• DIMLST is renamed KPG_DIMLS.
• ICMMM has been renamed KPG_IMMMx and made generic. The calculations are now in performed double precision. Note that the API has changed: the first two arguments have been transposed to the standard order, and the returned floating-point statistics are now double precision.
• LD2AR has been renamed KPG_LD2Ax and made generic.
• Remove FTS1_TREAD since the MAG library has now been removed from the main Starlink source tree.
• A number of long-deprecated old routines without a package prefix have been removed. These are listed below. The corresponding replacement routines appear in the right column.

  BAD2Dx	KPG_FISEx setting the fill value to VAL__BADx
  CHVALx	KPG1_CHVAx
  COPAx	VEC_xTOx or KPG1_COPY
  COPY1D	"	"
  COPY2D	"	"
  COPY3D	"	"
  CPSECR	KPG1_CPNDx
  CREOUT	NDF_CREP and NDF_CPUT
  ELNMBx	KPG1_ELNMx
  EXPARR	KPG1_EXPOx
  INSET	CHR_INSET
  LOGARR	KPG1_LOGAx
  NORMAL	KPG_NORVx
  NXTNAM	KPG_ISEQN
  POWARR	KPG1_POWx
  ZERO1D	KPG1_FILLx setting the fill value to 0.0.
  ZERO2D	KPG1_FILLx setting the fill value to 0.0.

• KPG1_ASSET now parses the supplied parameter name for a non-alphanumeric prefix and suffix to determine whether or not temporary attributes are supported via the new KPG1_GTGPT routine. A suffix indicates that KPG1_ASSET will be called again for the same parameter, affecting the value to write to the parameter file.
• The KPG1_PLTLN routine now accepts a value 6 for the MODE argument, which causes a staircase plot to be produced in which bad values are not flanked by vertical lines to the lower edge of the plot (as are produced by Mode 1), leaving a gap.
• KPG1_STDSx and KPG1_STFLx can respectively report or log the skewness and kurtosis via two additional arguments. Users of these routines will need to modify calling routines accordingly; without skewness or kurtosis values to document supply VAL__BADD for each undefined statistic.
• Support for FITS tapes was removed from FTS1_PHEAD, FTS1_RDATA, FTS1_RGRDA, FTS1_RSTAB, FTS1_SKIP. Argument MEDIUM in these routines now only accepts the value DISK.
• Config files can now include <def> to revert to the default value.
• Config files can now include <undef> to store an undefined value using kpg1Kymap.