A Specifications of CONVERT Applications

 A.1 Explanatory Notes

A.1 Explanatory Notes

The Parameters section lists the application’s parameters, with the format:

       name  =  type (access)
          description

The description entry has a notation scheme to indicate normally defaulted parameters, i.e. those for which there will be no prompt. For such parameters a matching pair of square brackets ([]) terminates the description. The content between the brackets mean

[]
Empty brackets means that the default is created dynamically by the application, and may depend on the values of other parameters. Therefore, the default cannot be given explicitly.
[,]
As above, but there are two default values that are created dynamically.
[default]
Occasionally, a description of the default is given in normal type.
[default]
If the brackets contain a value in teletype-fount, this is the explicit default value.

There is also a Usage entry. This shows how the application is invoked from the command line. It lists the positional parameters in order followed by any prompted keyword parameters using a “KEYWORD=?” syntax. Defaulted keyword parameters do not appear. Positional parameters that are normally defaulted are indicated by being enclosed in square brackets. Keyword (i.e. not positional) parameters are needed where the number of parameters are large, and usually occur because they depend on the value of another parameter. An example should clarify.

       ndf2ascii in out [comp] [reclen] noperec=?

IN, OUT, COMP, and RECLEN are all positional parameters. Only IN, and OUT would be prompted if not given on the command line. The remaining parameter, NOPEREC, depends on the value of another parameter (it is FIXED), and will be prompted for when FIXED is TRUE.

The Examples section shows how to run the application from the command line. More often you’ll enter the command name and just some of the parameters, and be prompted for the rest.

Examples give command lines as accepted by the tasks themselves. From the UNIX shell, metacharacters (notably [, ] and ") must be escaped or enclosed in single quotes. For example:

  ascii2ndf ngc253q.dat ngc253 q shape=’[100,60]’
  fits2ndf ’"abc.fit,def.fits"’ ’fgh,ijk"’ fmtcnv=’"F,T"’ noproexts

List of all Convert Commands

ASCII2NDF – Converts a text file to an NDF
AST2NDF – Converts an Asterix data cube into a simple NDF
DA2NDF – Converts a direct-access unformatted file to an NDF
DST2NDF – Converts a Figaro (Version 2) DST file to an NDF
FITS2NDF – Converts FITS files into NDFs
GASP2NDF – Converts an image in GASP format to an NDF
GIF2NDF – Converts a GIF file into an NDF.
IRAF2NDF – Converts an IRAF image to an NDF
IRCAM2NDF – Converts an IRCAM data file to a series of NDFs
MTFITS2NDF – Converts FITS magnetic tape files into NDFs.
NDF2ASCII – Converts an NDF to a text file
NDF2DA – Converts an NDF to a direct-access unformatted file
NDF2DST – Converts an NDF to a Figaro (Version 2) DST file
NDF2FITS – Converts NDFs into FITS files
NDF2GASP – Converts a two-dimensional NDF into a GASP image
NDF2GIF – Converts an NDF into a GIF file.
NDF2IRAF – Converts an NDF to an IRAF image
NDF2PGM – Converts an NDF to a PBMPLUS-style PGM-format file.
NDF2TIFF – Converts an NDF to an 8-bit TIFF-6.0-format file.
NDF2UNF – Converts an NDF to a sequential unformatted file
SPECX2NDF – Converts a SPECX map into a simple data cube, or SPECX data files to individual spectra.
TIFF2NDF – Converts a TIFF file into an NDF.
UNF2NDF – Converts a sequential unformatted file to an NDF