Modified applications

The following applications have been modified:

CENTROID

• Positions can now be read from and written to position list catalogues such as created by CURSOR and LISTMAKE.

• All positions, both given by the user and returned by the program, now refer to the Current Frame of the NDF.

• Either the initial or final positions may now be marked on the screen (see Parameter MARK).

• There is now much greater control over the appearance of any annotation draw over the screen. This is provided through the PLOTSTYLE parameter which allow plotting attributes to be set.

• The error on the final position is now returned in Parameters XERR and YERR.

• The following parameters have been removed (alternatives to using these old parameters are indicated):

  COSYS

  -- Use application WCSFRAME to set the required co-ordinate Frame  first.

• The following new parameters have been added: DESCRIBE, ERROR, GUESS, INCAT, MARKER, OUTCAT, PLOTSTYLE, QUIET, TITLE, XERR, YERR.

• The following parameters have been modified:

  CENTRE

  -- This is now a string parameter in which is returned the formatted co-ordinates of the last centroid position, in the current Frame of the NDF.

  INIT

  -- This is now a string parameter which should be given the co-ordinates of the initial guess in the Current Frame of the NDF.

  MARK

  -- Now indicates whether the initial or final positions should be marked on the screen.

  MODE

  -- Now accepts the extra value "Catalogue".

  XCEN,YCEN

  -- These are now string parameters which return the formatted x and y co-ordinates of the last centroid position, in the current Frame of the NDF.

COMPADD

A bug has been fixed which could produce incorrect WCS co-ordinates in the output NDF if the lower bounds of the input NDF were not (1, 1).

COMPAVE

A bug has been fixed which could produce incorrect WCS co-ordinates in the output NDF if the lower bounds of the input NDF were not (1, 1).

CONTOVER

CONTOVER has been scheduled for withdrawl at the next release of KAPPA, and a warning message is now displayed every time CONTOVER is run. Use "contour clear=no" instead to draw a contour map over an existing data picture.

CURSOR

A bug has been fixed which resulted in CURSOR running out of picture identifiers (and consequently aborting) if more than 40 positions were given.

DISPLAY

New Parameters KEY, KEYPOS and KEYSTYLE have been added, allowing DISPLAY to create a key containing a colour ramp in the same style as LUTVIEW.

DRAWSIG

• There is now much greater control over the appearance of the lines drawn. Each line may be drawn with a different appearance. This is provided through the STYLE parameter which allow plotting attributes to be set for each line drawn.

• The following parameters have been removed (alternatives to using these old parameters are indicated):

  LINESTYLE

  -- Use the STYLE parameter to specify a value for the plotting attribute Style(Lines).

  SIGCOL

  -- Use the Colour(Lines)  plotting attributes.

  THICK

  -- Use the Width(Lines)  plotting attributes.

• The following new parameters have been added: STYLE.

EXP10

This command is now a synonym for expon base=10D0.

EXPE

This command is now a synonym for expon base=natural.

EXPON

Re-written to use NDF data structures.

FITSMOD

A new output Parameter EXISTS has been added to store the result of the final "Exist" operation.

GREYPLOT

GREYPLOT has been scheduled for withdrawl at the next release of KAPPA, and a warning message is now displayed every time GREYPLOT is run. DISPLAY can now produce a key to the colour table using the new KEY parameter, so there is no longer any real need for GREYPLOT.

HISTOGRAM

• There is now much greater control over the appearance of the plot. This is provided through the STYLE parameter which allow plotting attributes to be set.

• The following parameters have been removed (alternatives to using these old parameters are indicated):

  ABSLAB

  -- Use the STYLE parameter to specify a value for the plotting attribute Label(1).

  FONT

  -- Use the Font  plotting attributes.

  MAJTIC

  -- Use the Gap  plotting attributes.

  MINTIC

  -- Use the MinTick plotting attribute.

  ORDLAB

  -- Use Label(2) plotting attribute.

  OUTTIC

  -- Use MajTickLen  and MinTickLen  plotting attributes.

  PLTITL

  -- Use the Title  plotting attribute.

  PXSIZE

  -- Create the picture first with the required picture size using PICDEF.

  PYSIZE

  -- See PXSIZE.

  THICK

  -- Use the Width  plotting attributes.

• The following new parameters have been added: AXES, MARGIN, MARKER, STYLE, XLEFT, XRIGHT, YBOT, YTOP.

• The following parameters have been modified:

  XLOG

  -- If a logarithmic horizontal axis is requested, the axis is now annotated with equally spaced values of the logarithm (base 10) of the data value.

  YLOG

  -- If a logarithmic vertical axis is requested, the vertical axis is now annotated with equally spaced values of the logarithm (base 10) of the pixel count.

LINPLOT

A new Parameter LMODE has been added to allow the default limits for the vertical axis to be chosen in various ways (for instance using percentiles, multiples of the standard deviation, etc.).

LOG10

This command is now a synonym for logar base=10D0.

LOGAR

Re-written to use NDF data structures.

LOGE

This command is now a synonym for logar base=natural.

LUTVIEW

• The annotation placed around the colour ramp can now be controlled in much greater detail using the new STYLE parameter.

• If MODE="XY", the bounds of the area occupied by the colour ramp and annotation can be specified in a variety of co-ordinate systems (specified by the new Parameter FRAME).

• The following parameters have been removed (alternatives to using these old parameters are indicated):

  ANNOTA

  -- Use the STYLE parameter to specify which elements of the annotation (if any) are required. For instance, set "NumLab(1)=0" to suppress the numerical data values.

  OUTLINE

  -- Use the STYLE parameter to specify which elements of the annotation (if any) are required. For instance, set "BORDER=0" to suppress the box drawn around the colour ramp.

• The following new parameters have been added: FRAME, STYLE.

• The following parameters have been modified:

  LBOUND

  -- Now gives the lower bounds in the co-ordinate Frame specified by Parameter FRAME. The parameter type is now LITERAL rather than _REAL.

  UBOUND

  -- Now gives the upper bounds in the co-ordinate Frame specified by Parameter FRAME. The parameter type is now LITERAL rather than _REAL.

MLINPLOT

• The appearance of the annotated axes can now be controlled in much greater detail using the new STYLE parameter.

• The horizontal axis may now be annotated with values from one of the axes in the Current co-ordinate Frame of the NDF (see new Parameter USEAXIS).

• The appearance of the data curves (colour, line style, line width, etc.) can now be specified individually using the new PENS and MODE parameters.

• Vertical error bars can now be displayed if the supplied NDF has a VARIANCE component (see new Parameter ERRBAR).

• If the display is not cleared (using Parameter CLEAR), then an attempt is made to align the new plot with any existing plot.

• The vertical and horizontal position of the key can now be controlled using new Parameter KEYPOS, and its appearance can be controlled using new Parameter KEYSTYLE.

• The strings which which to label the data curves can now be given explicitly using new Parameter LABELS.

• Whether or not vertical offset markers are drawn for each curve is now controlled by the new Parameter ZMARK.

• The following parameters have been removed (alternatives to using these old parameters are indicated):

  ABSLAB

  -- Use the STYLE parameter to specify a value for the plotting attribute Label(1).

  FONT

  -- Use the Font  plotting attributes.

  LBSIZE

  -- Use the Size(Labels)  plotting attribute.

  MAJTIC

  -- Use the Gap  plotting attributes.

  MINTIC

  -- Use the MinTick plotting attribute.

  ORDLAB

  -- Use Label(2) plotting attribute.

  OUTTIC

  -- Use MajTickLen  and MinTickLen  plotting attributes.

  PLTITL

  -- Use the Title  plotting attribute.

  PXSIZE

  -- Create the picture first using PICDEF, the required picture size using the SIZE.

  PYSIZE

  -- See PXSIZE.

  TICLN

  -- Use the MajTickLen  and MinTickLen  plotting attributes.

  XLOG

  -- Logarithmic x axes are not currently supported.

  YLIMIT

  -- Use new Parameters YBOT and YTOP.

• The following new parameters have been added: AXES, ERRBAR, FREQ, KEYPOS, KEYSTYLE, LABELS, MARGIN, MARKER, MODE, PENS, SIGMA, STYLE, USEAXIS, XLEFT, XRIGHT, YBOT, YTOP, ZMARK.

• The following parameters have been modified:

  LNINDX

  -- Ranges of pixel indices are now specified using a colon (":") instead of a hyphen ("-"). So for instance, pixel rows 5 to 10 would now be given as "5:10" and not "5-10".

  OFFSET

  -- Now double precision.

  SPACE

  -- Now accepts the additional value "None" which specifies that all curves should be drawn with the same vertical zero point.

  YLOG

  -- If a logarithmic vertical axis is requested, the vertical axis is now annotated with equally spaced values of the logarithm (base 10) of the supplied data. Also, the curves are drawn with the vertical offsets specified by Parameter SPACE, and the appearance specified by Parameters PENS and STYLE.

NORMALIZE

• There is now much greater control over the appearance of the normalization plot. This is provided through the STYLE parameter which allow plotting attributes to be set.

• The following parameters have been removed (alternatives to using these old parameters are indicated):

  ABSLAB

  -- Use the STYLE parameter to specify a value for the plotting attribute Label(1).

  FONT

  -- Use the Font  plotting attributes.

  MAJTIC

  -- Use the Gap  plotting attributes.

  MINTIC

  -- Use the MinTick plotting attribute.

  ORDLAB

  -- Use Label(2) plotting attribute.

  OUTTIC

  -- Use MajTickLen  and MinTickLen  plotting attributes.

  PTITLE

  -- Use the Title  plotting attribute.

• The following new parameters have been added: AXES, MARGIN, MARKER, STYLE, XLEFT, XRIGHT, YBOT, YTOP.

PIXDUPE

• Modified so that pixel origin information is not lost. For instance, if you expand two aligned images by the same factor, they will still be aligned after the expansion.

PSF

• Positions can now be read from position list catalogues such as created by CURSOR and LISTMAKE.

• All positions and distances, both given by the user and returned by program, now refer to the Current Frame of the NDF. For instance, this means that if the Current Frame of the NDF is a SKY Frame, then:
  • celestial co-ordinates must be provided for the star positions.
  • the FWHM will be displayed in arcseconds.
  • the radial distance in the plot will be displayed in arcseconds.
  • the orientation of the major axis will be given as a position angle (from north through east).

  Note, it is assumed that the image scale does not vary significantly across the image, so you should be cautious about using PSF with very large images.

  If, instead, the Current Frame of the NDF is the PIXEL Frame, then:

  • pixel co-ordinates must be provided for the star positions.
  • the FWHM will be displayed in pixels.
  • the plot will be annotated in pixels.
  • the orientation of the major axis will be given as the angle from the first (X) axis through the second (Y) axis.

• The appearance of the annotated axes can now be controlled in much greater detail using the new STYLE parameter.

• If the display is not cleared (using Parameter CLEAR), then an attempt is made to align the new plot with any existing plot.

• The following parameters have been removed (alternatives to using these old parameters are indicated):

  ABSLAB

  -- Use the STYLE parameter to specify a value for the plotting attribute Label(1).

  COSYS

  -- Use application WCSFRAME to set the required co-ordinate Frame first.

  FONT

  -- Use the Font  plotting attributes.

  MAJTIC

  -- Use the Gap  plotting attributes.

  MINTIC

  -- Use the MinTick plotting attribute.

  ORDLAB

  -- Use Label(2) plotting attribute.

  OUTTIC

  -- Use MajTickLen  and MinTickLen  plotting attributes.

  PLTITL

  -- Use the Title  plotting attribute.

  PXSIZE

  -- Create the picture first using PICDEF, the required picture size using the SIZE.

  PYSIZE

  -- See PXSIZE.

  RADUNITS

  -- Use application WCSFRAME to set the required co-ordinate Frame first, or set the Unit attribute for Axis 1 of the input NDF using application WCSATTRIB.

  SCALE

  -- Use application WCSFRAME to set the required co-ordinate Frame first. Create a new Frame if necessary using application WCSADD.

• The following new parameters have been added: AXES, INCAT, MARGIN, MARKER, STYLE, USEAXIS, XLEFT, XRIGHT, YBOT, YTOP.

• The following parameters have been modified:

  OUT

  -- The pixel origin is no longer [1,1]. Instead, the pixel bounds are chosen to align the model PSF with the first fitted star in pixel co-ordinates. As a consequence, the PSF centre may not be exactly at the centre of the output image (it will, however, still be within one pixel of the centre). A WCS component is stored in the output NDF holding a copy of the input WCS component. An additional Frame with Domain name OFFSET is added, and is made the current Frame. This Frame measures the distance from the PSF centre in the units in which the FWHM is reported. These changes allows the model PSF to be aligned with the input NDF for comparison purposes, using WCSALIGN, CONTOUR, etc. Also, the output NDF is now created with the same type as the input NDF.

ROTATE

• Modified so that rotation occurs around the origin of pixel co-ordinates. This means that origin information is not lost. For instance, if you rotate two aligned images by the same angle, they will still be aligned after the rotation. Negative rotation angles are now accepted.

TURBOCONT

TURBOCONT has been scheduled for withdrawl at the next release of KAPPA, and a warning message is now displayed every time TURBOCONT is run. To retain TURBOCONT would require it to be converted to use PGPLOT /AST. This would slow it down so that it would offer little speed benefit over CONTOUR. In these days of higher powered workstatations the small difference in speed would not justify having two essentially identical applications.

VECPLOT

• Axes are now annotated with values in the current co-ordinate Frame of the supplied NDF.
• Information describing the co-ordinate Frames available in the supplied NDF is stored with the DATA picture in the AGI graphics database.
• If the screen is not cleared before plotting a vector map (i.e. if the Parameter CLEAR is set to FALSE), then an attempt will be made to align the new contour map spatially with any existing DATA picture. This alignment occurs by preference in the current co-ordinate Frame of the supplied vector magnitude NDF, but may occur in another Frame if the existing DATA picture does not have suitable WCS information stored with it.
• There is now much greater control over the appearance of the map. This is provided through the STYLE and KEYSTYLE parameters which allow plotting attributes to be set.
• The position of the key can now be controlled both vertically and horizontally.
• The following parameters have been removed (alternatives to using these old parameters are indicated):

  ABSLAB

  -- Use the STYLE parameter to specify a value for the plotting attribute Label(1).

  BORDER

  -- Set AXES=TRUE, and suppress everything but the border by setting suitable plotting attributes (e.g. MajTickLen=0, MinTickLen=0, TextLab=0 etc.).

  COSYS

  -- Use application WCSFRAME to set the required co-ordinate Frame first.

  FONT

  -- Use the Font  plotting attributes.

  MAJTIC

  -- Use the Gap  plotting attributes.

  MINTIC

  -- Use the MinTick plotting attribute.

  ORDLAB

  -- Use Label(2) plotting attribute.

  OUTTIC

  -- Use MajTickLen  and MinTickLen  plotting attributes.

  PLTITL

  -- Use the Title  plotting attribute.

  PXSIZE

  -- Create the picture first using PICDEF, specifying the required picture size using the new Parameter SIZE.

  PYSIZE

  -- See PXSIZE.

  THICK

  -- Use the Width  plotting attributes.

  VECCOL

  -- Use the Colour(vectors)  plotting attributes.

  VTYPE

  -- Use the new Parameter ARROW.

• The following new parameters have been added: ARROW, FILL, KEYPOS, KEYSTYLE, MARGIN, STYLE, USEAXIS.

• The following parameters have been modified:

  AXES

  -- Axes are now annotated with the current co-ordinate Frame of the NDF.

  CLEAR

  -- Setting CLEAR=FALSE cause the new contour map to be aligned spatially with any existing DATA picture (if possible).

  KEY

  -- The appearance of the key can now be controlled using Parameter KEYSTYLE, and the position of the key can be controlled using Parameter KEYPOS.

WCSALIGN

• Several new interpolation methods have been added, and an improved algorithm is now used which should be more efficient in some cases.