[SCM] Handle World Coordinate Systems in Astronomy branch, debian, updated. 4e637f44991518aac2d1e13e7846db9674155fa9
Ole Streicher
debian at liska.ath.cx
Tue Jun 4 08:49:19 UTC 2013
The following commit has been merged in the debian branch:
commit e02959434f6799c1adbf7dbd820aaad19de749cb
Author: Ole Streicher <debian at liska.ath.cx>
Date: Fri May 31 14:03:37 2013 +0200
New upstream version 7.3.1
diff --git a/AST_ERR b/AST_ERR
index 37476e7..e2ab80d 100644
--- a/AST_ERR
+++ b/AST_ERR
@@ -613,3 +613,11 @@
INTEGER AST__WRERR
PARAMETER ( AST__WRERR = 233934370 )
+* Bad variant Mapping name
+ INTEGER AST__BDVNM
+ PARAMETER ( AST__BDVNM = 233934378 )
+
+* Attempt to add a variant Mapping to a mirror Frame
+ INTEGER AST__MIRRO
+ PARAMETER ( AST__MIRRO = 233934386 )
+
diff --git a/ast.news b/ast.news
index 57aed1e..b276490 100644
--- a/ast.news
+++ b/ast.news
@@ -1,6 +1,6 @@
AST Library
-----------
- A new release (V7.2.0) of the Starlink AST (astrometry) library is
+ A new release (V7.3.0) of the Starlink AST (astrometry) library is
now available.
AST provides a comprehensive range of facilities for attaching
@@ -16,11 +16,31 @@ environment-independent.
Main Changes in this Version
----------------------------
+- IMPORTANT! The interface for the astRebinSeq<X> (AST_REBINSEQ) family
+of functions has been changed in order to allow a greater number of
+pixels to be pasted into the output array. In C, the "nused" parameter
+is now a pointer to a "int64_t" variable, instead of a simple "int". In
+Fortran, the NUSED argument for AST_REBINSEQ<X> is now an INTEGER*8.
+
+APPLICATION CODE SHOULD BE CHANGED ACCORDINGLY TO AVOID SEGMENTATION
+FAULTS AND OTHER ERRATIC BEHAVIOUR.
+
+- Added a new facility to the FrameSet class to allow each Frame to be
+associated with multiple Mappings, any one of which can be used to
+connect the Frame to the other Frames in the FrameSet. The choice of
+which Mapping to use is controlled by the new "Variant" attribute of the
+FrameSet class.
+
+- Mappings (but not Frames) that have a value set for their Ident attribute
+are now left unchanged by the astSimplify (AST_SIMPLIFY) function.
+
+Main Changes in V7.2.0
+----------------------
+
- A new method call astMapDefined has been added to the KeyMap class.
It checks if a gtiven key name has a defined value in a given KeyMap.
-
Main Changes in V7.1.1
----------------------
diff --git a/ast_err.h b/ast_err.h
index eda9d2d..96f673a 100644
--- a/ast_err.h
+++ b/ast_err.h
@@ -465,4 +465,10 @@ enum { AST__ISNAN = 233934362 }; /* messid=451 */
/* write error */
enum { AST__WRERR = 233934370 }; /* messid=452 */
+/* Bad variant Mapping name */
+enum { AST__BDVNM = 233934378 }; /* messid=453 */
+
+/* Attempt to add a variant Mapping to a mirror Frame */
+enum { AST__MIRRO = 233934386 }; /* messid=454 */
+
#endif /* AST_ERROR_DEFINED */
diff --git a/cmpmap.c b/cmpmap.c
index a805628..9e9d8c1 100644
--- a/cmpmap.c
+++ b/cmpmap.c
@@ -146,6 +146,9 @@ f The CmpMap class does not define any new routines beyond those
* 5-FEB-2013 (DSB):
* Take account of Invert flags when combining parallel CmpMaps in
* series.
+* 29-APR-2013 (DSB):
+* In MapList, use the astDoNotSimplify method to check that it is
+* OK to expand the CmpMap.
*class--
*/
@@ -1127,8 +1130,9 @@ static int MapList( AstMapping *this_mapping, int series, int invert,
this = (AstCmpMap *) this_mapping;
/* Check if the CmpMap combines its component Mappings in the same way
- (series or parallel) as the decomposition requires. */
- if ( this->series == series ) {
+ (series or parallel) as the decomposition requires. Also, do not
+ expand CmpMaps that are not appropriate for simplification. */
+ if ( this->series == series && !astDoNotSimplify( this ) ) {
/* If so, obtain the Invert attribute values to be applied to each
component Mapping. */
diff --git a/configure b/configure
index 6b73619..3c351b0 100755
--- a/configure
+++ b/configure
@@ -1,7 +1,7 @@
#! /bin/sh
# From configure.ac Revision.
# Guess values for system-dependent variables and create Makefiles.
-# Generated by Starlink Autoconf 2.59 for ast 7.2.0.
+# Generated by Starlink Autoconf 2.59 for ast 7.3.1.
#
# Report bugs to <starlink at jiscmail.ac.uk>.
#
@@ -424,8 +424,8 @@ SHELL=${CONFIG_SHELL-/bin/sh}
# Identity of this package.
PACKAGE_NAME='ast'
PACKAGE_TARNAME='ast'
-PACKAGE_VERSION='7.2.0'
-PACKAGE_STRING='ast 7.2.0'
+PACKAGE_VERSION='7.3.1'
+PACKAGE_STRING='ast 7.3.1'
PACKAGE_BUGREPORT='starlink at jiscmail.ac.uk'
ac_unique_file="ast_link.in"
@@ -980,7 +980,7 @@ if test "$ac_init_help" = "long"; then
# Omit some internal or obsolete options to make the list less imposing.
# This message is too long to be a string in the A/UX 3.1 sh.
cat <<_ACEOF
-\`configure' configures ast 7.2.0 to adapt to many kinds of systems.
+\`configure' configures ast 7.3.1 to adapt to many kinds of systems.
Usage: $0 [OPTION]... [VAR=VALUE]...
@@ -1046,7 +1046,7 @@ fi
if test -n "$ac_init_help"; then
case $ac_init_help in
- short | recursive ) echo "Configuration of ast 7.2.0:";;
+ short | recursive ) echo "Configuration of ast 7.3.1:";;
esac
cat <<\_ACEOF
@@ -1198,7 +1198,7 @@ fi
test -n "$ac_init_help" && exit 0
if $ac_init_version; then
cat <<\_ACEOF
-ast configure 7.2.0
+ast configure 7.3.1
generated by Starlink Autoconf 2.59
Copyright (C) 2003 Free Software Foundation, Inc.
@@ -1212,7 +1212,7 @@ cat >&5 <<_ACEOF
This file contains any messages produced by compilers while
running configure, to aid debugging if configure makes a mistake.
-It was created by ast $as_me 7.2.0, which was
+It was created by ast $as_me 7.3.1, which was
generated by Starlink Autoconf 2.59. Invocation command line was
$ $0 $@
@@ -1857,7 +1857,7 @@ fi
# Define the identity of the package.
PACKAGE='ast'
- VERSION='7.2.0'
+ VERSION='7.3.1'
cat >>confdefs.h <<_ACEOF
@@ -25259,7 +25259,7 @@ _ASBOX
} >&5
cat >&5 <<_CSEOF
-This file was extended by ast $as_me 7.2.0, which was
+This file was extended by ast $as_me 7.3.1, which was
generated by Starlink Autoconf 2.59. Invocation command line was
CONFIG_FILES = $CONFIG_FILES
@@ -25322,7 +25322,7 @@ _ACEOF
cat >>$CONFIG_STATUS <<_ACEOF
ac_cs_version="\\
-ast config.status 7.2.0
+ast config.status 7.3.1
configured by $0, generated by Starlink Autoconf 2.59,
with options \\"`echo "$ac_configure_args" | sed 's/[\\""\`\$]/\\\\&/g'`\\"
diff --git a/configure.ac b/configure.ac
index a353347..f5208b9 100644
--- a/configure.ac
+++ b/configure.ac
@@ -7,7 +7,7 @@ dnl 1.5. It should work with autoconf versions 2.50 or better, and
dnl automake 1.6 or better.
dnl Initialisation: package name and version number
-AC_INIT(ast, 7.2.0, starlink at jiscmail.ac.uk)
+AC_INIT(ast, 7.3.1, starlink at jiscmail.ac.uk)
dnl Require autoconf-2.50 at least
AC_PREREQ(2.50)
diff --git a/fac_1521_err b/fac_1521_err
index 9cbf70d..da5d78d 100644
--- a/fac_1521_err
+++ b/fac_1521_err
@@ -152,3 +152,5 @@ FACILITY AST
450,NOFIT,Fit failed
451,ISNAN,A transformation generated one or more NaN values
452,WRERR,write error
+453,BDVNM,Bad variant Mapping name
+454,MIRRO,Attempt to add a variant Mapping to a mirror Frame
diff --git a/fframeset.c b/fframeset.c
index 74ba44d..c2f9f60 100644
--- a/fframeset.c
+++ b/fframeset.c
@@ -15,6 +15,8 @@
* Routines Defined:
* AST_ADDFRAME
+* AST_ADDVARIANT
+* AST_MIRRORVARIANTS
* AST_FRAMESET
* AST_GETFRAME
* AST_GETMAPPING
@@ -176,3 +178,34 @@ F77_SUBROUTINE(ast_removeframe)( INTEGER(THIS),
astRemoveFrame( astI2P( *THIS ), *IFRAME );
)
}
+
+F77_SUBROUTINE(ast_addvariant)( INTEGER(THIS),
+ INTEGER(MAP),
+ CHARACTER(NAME),
+ INTEGER(STATUS)
+ TRAIL(NAME) ) {
+ GENPTR_INTEGER(THIS)
+ GENPTR_INTEGER(MAP)
+ GENPTR_CHARACTER(NAME)
+ char *name;
+
+ astAt( "AST_ADDVARIANT", NULL, 0 );
+ astWatchSTATUS(
+ name = astString( NAME, NAME_length );
+ astAddVariant( astI2P( *THIS ), astI2P( *MAP ), name );
+ name = astFree( name );
+ )
+}
+
+F77_SUBROUTINE(ast_mirrorvariants)( INTEGER(THIS),
+ INTEGER(IFRAME),
+ INTEGER(STATUS) ) {
+ GENPTR_INTEGER(THIS)
+ GENPTR_INTEGER(IFRAME)
+
+ astAt( "AST_MIRRORVARIANTS", NULL, 0 );
+ astWatchSTATUS(
+ astMirrorVariants( astI2P( *THIS ), *IFRAME );
+ )
+}
+
diff --git a/fitschan.c b/fitschan.c
index 62f0fae..fffc49f 100644
--- a/fitschan.c
+++ b/fitschan.c
@@ -1056,6 +1056,13 @@ f - AST_WRITEFITS: Write all cards out to the sink function
* 15-APR-2013 (DSB):
* Correct initialisation of missing coefficients When reading a
* SAO plate solution header.
+* 16-APR-2013 (DSB):
+* When determining default Encoding value, use "VLSR" keyword if
+* "VELO-..." is not available.
+* 30-MAY-2013 (DSB):
+* Prevent seg fault caused by overrunning the coeffs array in
+* WATCoeffs in cases where the TNX/ZPX projection is found to be
+* of a form that cannot be implemented as a TPN projection.
*class--
*/
@@ -11348,7 +11355,6 @@ static int GetEncoding( AstFitsChan *this, int *status ){
* Synopsis:
* #include "fitschan.h"
-
* int GetEncoding( AstFitsChan *this, int *status )
* Class Membership:
@@ -11364,8 +11370,7 @@ static int GetEncoding( AstFitsChan *this, int *status ){
* i, j and m are integers and s is a single upper case character):
*
* 1) Any keywords starting with "BEGAST" = Native encoding
-* 2) DELTAV and VELO-xxx keywords = FITS-CLASS.
-
+* 2) DELTAV and VELO-xxx (or VLSR) keywords = FITS-CLASS.
* 3) Any AIPS spectral CTYPE values:
* Any of CDi_j, PROJP, LONPOLE, LATPOLE = FITS-AIPS++ encoding:
@@ -19225,9 +19230,8 @@ static int LooksLikeClass( AstFitsChan *this, const char *method,
* Synopsis:
* #include "fitschan.h"
-
-* int LooksLikeClass( AstFitsChan *this, const char *method,
-* const char *class, int *status )
+* int LooksLikeClass( AstFitsChan *this, const char *method,
+* const char *class, int *status )
* Class Membership:
* FitsChan member function.
@@ -19236,7 +19240,7 @@ static int LooksLikeClass( AstFitsChan *this, const char *method,
* Returns non-zero if the supplied FitsChan probably uses FITS-CLASS
* encoding. This is the case if it contains a DELTAV keyword and a
* keyword of the form VELO-xxx", where xxx is one of the accepted
-* standards of rest.
+* standards of rest, or "VLSR".
* Parameters:
* this
@@ -19263,8 +19267,9 @@ static int LooksLikeClass( AstFitsChan *this, const char *method,
/* Check the global status. */
if( !astOK ) return ret;
-/* See if there is a "DELTAV" card, and a "VELO-xxx" card. */
+/* See if there is a "DELTAV" card, and a "VELO-xxx" or "VLSR" card. */
if( astKeyFields( this, "DELTAV", 0, NULL, NULL ) && (
+ astKeyFields( this, "VLSR", 0, NULL, NULL ) ||
astKeyFields( this, "VELO-OBS", 0, NULL, NULL ) ||
astKeyFields( this, "VELO-HEL", 0, NULL, NULL ) ||
astKeyFields( this, "VELO-EAR", 0, NULL, NULL ) ||
@@ -32415,8 +32420,9 @@ static int WATCoeffs( const char *watstr, int iaxis, double **cvals,
coeff = NULL;
porder = -1;
-/* Loop round each word. */
- for( iword = 0; iword < nword; iword++ ) {
+/* Loop round each word. Break early if we find that the projection
+ cannot be represented as a TPN projection. */
+ for( iword = 0; iword < nword && *ok; iword++ ) {
/* Convert the word to double. */
dval = astChr2Double( w2[ iword ] );
@@ -32495,7 +32501,7 @@ static int WATCoeffs( const char *watstr, int iaxis, double **cvals,
if( porder == -1 || nword != 8 + nab[ porder ] ) *ok = 0;
/* If we can handle the projection, proceed. */
- if( *ok ) {
+ if( *ok && astOK ) {
/* If the coefficients were supplied in chebyshev form, convert to simple
form. */
@@ -38863,7 +38869,7 @@ f affects the behaviour of the AST_WRITE and AST_READ routines when
* string "BEGAST", then NATIVE encoding is used,
* - Otherwise, FITS-CLASS is used if the FitsChan contains a DELTAV
* keyword and a keyword of the form VELO-xxx, where xxx indicates one
-* of the rest frames used by class (e.g. "VELO-LSR").
+* of the rest frames used by class (e.g. "VELO-LSR"), or "VLSR".
* - Otherwise, if the FitsChan contains a CTYPE keyword which
* represents a spectral axis using the conventions of the AIPS and
* AIPS++ projects (e.g. "FELO-LSR", etc), then one of FITS-AIPS or
diff --git a/fmapping.c b/fmapping.c
index a9f8f3d..152359f 100644
--- a/fmapping.c
+++ b/fmapping.c
@@ -100,6 +100,8 @@
#include "error.h" /* Error reporting facilities */
#include "mapping.h" /* C interface to the Mapping class */
+#include <stdint.h>
+
/* Module Variables. */
/* ================= */
/* Pointer to user-supplied (FORTRAN 77) interpolation function for
@@ -534,7 +536,7 @@ F77_SUBROUTINE(ast_rebinseq##f)( INTEGER(THIS), \
Ftype##_ARRAY(OUT), \
Ftype##_ARRAY(OUT_VAR), \
DOUBLE_ARRAY(WEIGHTS), \
- INTEGER(NUSED), \
+ INTEGER8(NUSED), \
INTEGER(STATUS) ) { \
GENPTR_INTEGER(THIS) \
GENPTR_DOUBLE(WLIM) \
@@ -557,11 +559,12 @@ F77_SUBROUTINE(ast_rebinseq##f)( INTEGER(THIS), \
GENPTR_##Ftype##_ARRAY(OUT) \
GENPTR_##Ftype##_ARRAY(OUT_VAR) \
GENPTR_DOUBLE_ARRAY(WEIGHTS) \
- GENPTR_INTEGER(NUSED) \
+ GENPTR_INTEGER8(NUSED) \
GENPTR_INTEGER(STATUS) \
\
Xtype *out_var; \
const Xtype *in_var; \
+ int64_t nused; \
\
astAt( "AST_REBINSEQ"#F, NULL, 0 ); \
astWatchSTATUS( \
@@ -582,13 +585,15 @@ F77_SUBROUTINE(ast_rebinseq##f)( INTEGER(THIS), \
out_var = NULL; \
} \
\
+ nused = *NUSED; \
astRebinSeq##X( astI2P( *THIS ), *WLIM, *NDIM_IN, \
LBND_IN, UBND_IN, (const Xtype *) IN, in_var, \
*INTERP, PARAMS, *FLAGS, \
*TOL, *MAXPIX, *BADVAL, \
*NDIM_OUT, LBND_OUT, UBND_OUT, \
LBND, UBND, (Xtype *) OUT, out_var, WEIGHTS, \
- NUSED ); \
+ &nused ); \
+ *NUSED = nused; \
) \
} \
diff --git a/frame.c b/frame.c
index c634ede..094118c 100644
--- a/frame.c
+++ b/frame.c
@@ -268,6 +268,14 @@ f - AST_UNFORMAT: Read a formatted coordinate value for a Frame axis
* superclass target.
* 11-APR-2012 (DSB):
* Change astValidateAxis so that it can permute in either direction.
+* 29-APR-2013 (DSB):
+* Added protected methods astSetFrameVariants and astGetFrameVariants.
+* 1-MAY-2013 (DSB):
+* Override the astDoNotSimplify method to indicate that Frames should
+* always be simplified. This is mainly because the STC class uses the
+* Ident attribute with Frames, and preventing such frames from
+* simplifying (which is what the parent astDoNotSimplify method does)
+* causes the STC tester in the ast_tester directory to fail.
*class--
*/
@@ -710,6 +718,7 @@ static int (* parent_testattrib)( AstObject *, const char *, int * );
static void (* parent_clearattrib)( AstObject *, const char *, int * );
static void (* parent_setattrib)( AstObject *, const char *, int * );
static void (* parent_cleanattribs)( AstObject *, int * );
+static int (* parent_getobjsize)( AstObject *, int * );
#if defined(THREAD_SAFE)
static int (* parent_managelock)( AstObject *, int, int, AstObject **, int * );
@@ -826,6 +835,7 @@ static int ConsistentMaxAxes( AstFrame *, int, int * );
static int ConsistentMinAxes( AstFrame *, int, int * );
static int DefaultMaxAxes( AstFrame *, int * );
static int DefaultMinAxes( AstFrame *, int * );
+static int DoNotSimplify( AstMapping *, int * );
static int Equal( AstObject *, AstObject *, int * );
static int Fields( AstFrame *, int, const char *, const char *, int, char **, int *, double *, int * );
static int GetDigits( AstFrame *, int * );
@@ -834,6 +844,7 @@ static int GetIsLinear( AstMapping *, int * );
static int GetIsSimple( AstMapping *, int * );
static int LineContains( AstFrame *, AstLineDef *, int, double *, int * );
static int LineCrossing( AstFrame *, AstLineDef *, AstLineDef *, double **, int * );
+static int GetObjSize( AstObject *, int * );
static void CleanAttribs( AstObject *, int * );
static void LineOffset( AstFrame *, AstLineDef *, double, double, double[2], int * );
@@ -886,6 +897,9 @@ static int GetActiveUnit( AstFrame *, int * );
static int TestActiveUnit( AstFrame *, int * );
static void SetActiveUnit( AstFrame *, int, int * );
+static AstFrameSet *GetFrameVariants( AstFrame *, int * );
+static void SetFrameVariants( AstFrame *, AstFrameSet *, int * );
+
static int GetFrameFlags( AstFrame *, int * );
static int *MapSplit( AstMapping *, int, const int *, AstMapping **, int * );
static int GetMatchEnd( AstFrame *, int * );
@@ -3267,6 +3281,51 @@ f invoked with STATUS set to an error value, or if it should fail for
return result;
}
+static int DoNotSimplify( AstMapping *this, int *status ) {
+/*
+* Name:
+* DoNotSimplify
+
+* Purpose:
+* Check if a Mapping is appropriate for simplification.
+
+* Type:
+* Private function.
+
+* Synopsis:
+* #include "object.h"
+* int DoNotSImplify( AstMapping *this );
+
+* Class Membership:
+* CmpMap member function (over-rides the astDoNotSimplify protected
+* method inherited from the parent class).
+
+* Description:
+* This function returns a flag indivating if the supplied Mapping is
+* appropriate for simplification.
+
+* Parameters:
+* this
+* Pointer to the Mapping.
+* status
+* Pointer to the inherited status variable.
+
+* Returned Value:
+* Non-zero if the supplied Mapping is not appropriate for
+* simplification, and zero otherwise.
+
+* Notes:
+* - A value of 0 will be returned if this function is invoked
+* with the global error status set, or if it should fail for any
+* reason.
+
+*/
+
+/* Unlike basic Mappings, Frames that have a set value for the Ident
+ can be simplified. So always return zero. */
+ return 0;
+}
+
static int Equal( AstObject *this_object, AstObject *that_object, int *status ) {
/*
* Name:
@@ -5480,6 +5539,78 @@ static int GetNout( AstMapping *this_mapping, int *status ) {
return result;
}
+static int GetObjSize( AstObject *this_object, int *status ) {
+/*
+* Name:
+* GetObjSize
+
+* Purpose:
+* Return the in-memory size of an Object.
+
+* Type:
+* Private function.
+
+* Synopsis:
+* #include "frame.h"
+* int GetObjSize( AstObject *this, int *status )
+
+* Class Membership:
+* Frame member function (over-rides the astGetObjSize protected
+* method inherited from the parent class).
+
+* Description:
+* This function returns the in-memory size of the supplied Frame,
+* in bytes.
+
+* Parameters:
+* this
+* Pointer to the Frame.
+* status
+* Pointer to the inherited status variable.
+
+* Returned Value:
+* The Object size, in bytes.
+
+* Notes:
+* - A value of zero will be returned if this function is invoked
+* with the global status set, or if it should fail for any reason.
+*/
+
+/* Local Variables: */
+ AstFrame *this; /* Pointer to Frame structure */
+ int axis; /* Axis index */
+ int result; /* Result value to return */
+
+/* Initialise. */
+ result = 0;
+
+/* Check the global error status. */
+ if ( !astOK ) return result;
+
+/* Obtain a pointers to the FrameSet structure. */
+ this = (AstFrame *) this_object;
+
+/* Invoke the GetObjSize method inherited from the parent class, and then
+ add on any components of the class structure defined by this class
+ which are stored in dynamically allocated memory. */
+ result = (*parent_getobjsize)( this_object, status );
+ result += astGetObjSize( this->variants );
+ result += astTSizeOf( this->domain );
+ result += astTSizeOf( this->title );
+ result += astTSizeOf( this->axis );
+ result += astTSizeOf( this->perm );
+
+ for ( axis = 0; axis < this->naxes; axis++ ) {
+ result += astGetObjSize( this->axis[ axis ] );
+ }
+
+/* If an error occurred, clear the result value. */
+ if ( !astOK ) result = 0;
+
+/* Return the result, */
+ return result;
+}
+
static const int *GetPerm( AstFrame *this, int *status ) {
/*
*+
@@ -5540,6 +5671,61 @@ static const int *GetPerm( AstFrame *this, int *status ) {
return this->perm;
}
+static AstFrameSet *GetFrameVariants( AstFrame *this, int *status ){
+/*
+*+
+* Name:
+* astGetFrameVariants
+
+* Purpose:
+* Returns the FrameSet holding the available Frame variants.
+
+* Type:
+* Protected virtual function.
+
+* Synopsis:
+* #include "frame.h"
+* AstFrameSet *astGetFrameVariants( AstFrame *this )
+
+* Class Membership:
+* Frame method.
+
+* Description:
+* This function returns a pointer to any FrameSet previously stored
+* in the Frame using method astSetVariants.
+
+* Parameters:
+* this
+* Pointer to the Frame.
+
+* Returned Value:
+* astGetFrameVariants
+* A pointer to the FrameSet. It should be annulled using astAnnul
+* when no longer needed. NULL will be returned if no FrameSet is
+* stored in the Frame.
+
+* Notes:
+* - A NULL value will be returned if this function is invoked with the
+* AST error status set, or if it should fail for any reason.
+*-
+*/
+
+/* Local Variables: */
+ AstFrameSet *result;
+
+/* Initialise. */
+ result = NULL;
+
+/* Check the global error status. */
+ if ( !astOK ) return result;
+
+/* Get a clone of any FrameSet pointer. */
+ if( this->variants ) result = astClone( this->variants );
+
+/* Return the result. */
+ return result;
+}
+
void astInitFrameVtab_( AstFrameVtab *vtab, const char *name, int *status ) {
/*
*+
@@ -5708,6 +5894,9 @@ void astInitFrameVtab_( AstFrameVtab *vtab, const char *name, int *status ) {
vtab->GetActiveUnit = GetActiveUnit;
vtab->SetActiveUnit = SetActiveUnit;
+ vtab->GetFrameVariants = GetFrameVariants;
+ vtab->SetFrameVariants = SetFrameVariants;
+
vtab->ClearSystem = ClearSystem;
vtab->GetSystem = GetSystem;
vtab->SetSystem = SetSystem;
@@ -5757,6 +5946,8 @@ void astInitFrameVtab_( AstFrameVtab *vtab, const char *name, int *status ) {
replace them with pointers to the new member functions. */
object = (AstObjectVtab *) vtab;
+ parent_getobjsize = object->GetObjSize;
+ object->GetObjSize = GetObjSize;
parent_clearattrib = object->ClearAttrib;
object->ClearAttrib = ClearAttrib;
parent_getattrib = object->GetAttrib;
@@ -5786,6 +5977,7 @@ void astInitFrameVtab_( AstFrameVtab *vtab, const char *name, int *status ) {
mapping->ReportPoints = ReportPoints;
mapping->Transform = Transform;
mapping->MapSplit = MapSplit;
+ mapping->DoNotSimplify = DoNotSimplify;
/* Declare the copy constructor, destructor and class dump
function. */
@@ -6532,6 +6724,8 @@ static int ManageLock( AstObject *this_object, int mode, int extra,
if( !result ) result = astManageLock( this->axis[ i ], mode, extra,
fail );
}
+ if( this->variants && !result ) result = astManageLock( this->variants, mode,
+ extra, fail );
return result;
@@ -9847,6 +10041,52 @@ static void SetFrameFlags( AstFrame *this, int flags, int *status ){
this->flags = flags;
}
+static void SetFrameVariants( AstFrame *this, AstFrameSet *variants, int *status ){
+/*
+*+
+* Name:
+* astSetFrameVariants
+
+* Purpose:
+* Store a FrameSet holding alternative Frame properties.
+
+* Type:
+* Protected virtual function.
+
+* Synopsis:
+* #include "frame.h"
+* void astSetVariants( AstFrame *this, AstFrameSet *variants )
+
+* Class Membership:
+* Frame method.
+
+* Description:
+* This function adds sets of alternative Frame properties to a Frame.
+
+* Parameters:
+* this
+* Pointer to the Frame.
+* variants
+* Pointer to a FrameSet in which each Frame is of the same class
+* and dimensionality as "this" and all Frames have unique Domain
+* names.
+
+* Notes:
+* - A clone of the supplied FrameSet pointer is stored in the Frame.
+*-
+*/
+
+/* Check the global error status. */
+ if ( !astOK ) return;
+
+/* Annul any variants FrameSet already stored in the Frame. */
+ if( this->variants ) this->variants = astAnnul( this->variants );
+
+/* Store a clone of ht esupplied FrameSet pointer. */
+ if( variants ) this->variants = astClone( variants );
+
+}
+
static void SetUnit( AstFrame *this, int axis, const char *unit, int *status ) {
/*
* Name:
@@ -13088,6 +13328,7 @@ static void Copy( const AstObject *objin, AstObject *objout, int *status ) {
out->domain = NULL;
out->perm = NULL;
out->title = NULL;
+ out->variants = NULL;
/* If necessary, allocate memory in the output Frame and store a copy of the
input Title and Domain strings. */
@@ -13121,6 +13362,9 @@ static void Copy( const AstObject *objin, AstObject *objout, int *status ) {
}
}
+/* Other remaining objects */
+ if( in->variants ) out->variants = astCopy( in->variants );
+
/* If an error occurred, free any allocated memory. */
if ( !astOK ) {
out->axis = astFree( out->axis );
@@ -13182,6 +13426,9 @@ static void Delete( AstObject *obj, int *status ) {
/* Free memory used for the axis permutation array if necessary. */
this->perm = astFree( this->perm );
+
+/* Other objects. */
+ if( this->variants ) this->variants = astAnnul( this->variants );
}
/* Dump function. */
@@ -13663,6 +13910,11 @@ static void Dump( AstObject *this_object, AstChannel *channel, int *status ) {
/* Free the inverse axis permutation array. */
invperm = astFree( invperm );
+
+/* Variants */
+/* ------- */
+ if( this->variants ) astWriteObject( channel, "Vrnts", 1, 0,
+ this->variants, "Variant Frames" );
}
/* Undefine macros local to this function. */
@@ -13890,6 +14142,7 @@ AstFrame *astInitFrame_( void *mem, size_t size, int init,
new->obslon = AST__BAD;
new->dut1 = AST__BAD;
new->flags = 0;
+ new->variants = NULL;
/* Allocate memory to store pointers to the Frame's Axis objects and to store
its axis permutation array. */
@@ -14300,6 +14553,10 @@ AstFrame *astLoadFrame_( void *mem, size_t size,
/* Free the string value. */
sval = astFree( sval );
}
+
+/* Variants. */
+/* -------- */
+ new->variants = astReadObject( channel, "vrnts", NULL );
}
/* If an error occurred, clean up by deleting the new Frame. */
@@ -14430,6 +14687,14 @@ const int *astGetPerm_( AstFrame *this, int *status ) {
if ( !astOK ) return NULL;
return (**astMEMBER(this,Frame,GetPerm))( this, status );
}
+AstFrameSet *astGetFrameVariants_( AstFrame *this, int *status ) {
+ if ( !astOK ) return NULL;
+ return (**astMEMBER(this,Frame,GetFrameVariants))( this, status );
+}
+void astSetFrameVariants_( AstFrame *this, AstFrameSet *variants, int *status ) {
+ if ( !astOK ) return;
+ (**astMEMBER(this,Frame,SetFrameVariants))( this, variants, status );
+}
int astMatch_( AstFrame *this, AstFrame *target, int matchsub,
diff --git a/frame.h b/frame.h
index 3949b27..11dbcc6 100644
--- a/frame.h
+++ b/frame.h
@@ -622,6 +622,7 @@ typedef struct AstFrame {
AstSystemType system; /* Code identifying coordinate system */
AstSystemType alignsystem; /* Code for Alignment coordinate system */
int flags; /* Bit mask containing various protected flags */
+ struct AstFrameSet *variants; /* FrameSet defining alternative properties for the Frame */
} AstFrame;
/* Cached Line structure. */
@@ -759,6 +760,8 @@ typedef struct AstFrameVtab {
void (* ValidateAxisSelection)( AstFrame *, int, const int *, const char *, int * );
void (* LineOffset)( AstFrame *, AstLineDef *, double, double, double[2], int * );
AstPointSet *(* FrameGrid)( AstFrame *, int, const double *, const double *, int * );
+ struct AstFrameSet *(* GetFrameVariants)( AstFrame *, int * );
+ void (* SetFrameVariants)( AstFrame *, struct AstFrameSet *, int * );
double (* GetTop)( AstFrame *, int, int * );
int (* TestTop)( AstFrame *, int, int * );
@@ -896,6 +899,8 @@ void astNorm_( AstFrame *, double[], int * );
void astOffset_( AstFrame *, const double[], const double[], double, double[], int * );
void astResolve_( AstFrame *, const double [], const double [], const double [], double [], double *, double *, int * );
void astSetActiveUnit_( AstFrame *, int, int * );
+AstFrameSet *astGetFrameVariants_( AstFrame *, int * );
+void astSetFrameVariants_( AstFrame *, AstFrameSet *, int * );
#if defined(astCLASS) /* Protected */
void astNormBox_( AstFrame *, double *, double *, AstMapping *, int * );
@@ -1122,6 +1127,10 @@ astINVOKE(V,astGetActiveUnit_(astCheckFrame(this),STATUS_PTR))
astINVOKE(V,astSetActiveUnit_(astCheckFrame(this),value,STATUS_PTR))
#if defined(astCLASS) /* Protected */
+#define astGetFrameVariants(this) \
+astINVOKE(O,astGetFrameVariants_(astCheckFrame(this),STATUS_PTR))
+#define astSetFrameVariants(this,variants) \
+astINVOKE(V,astSetFrameVariants_(astCheckFrame(this),astCheckFrameSet(variants),STATUS_PTR))
#define astNormBox(this,lbnd,ubnd,reg) \
astINVOKE(V,astNormBox_(astCheckFrame(this),lbnd,ubnd,astCheckMapping(reg),STATUS_PTR))
#define astFormat(this,axis,value) \
diff --git a/frameset.c b/frameset.c
index 0d4a1ba..0a0d53c 100644
--- a/frameset.c
+++ b/frameset.c
@@ -64,10 +64,12 @@ f Mapping, a FrameSet may also be inverted (see AST_INVERT), which
* In addition to those attributes common to all Frames, every
* FrameSet also has the following attributes:
*
+* - AllVariants: List of all variant mappings store with current Frame
* - Base: FrameSet base Frame index
* - Current: FrameSet current Frame index
* - Nframe: Number of Frames in a FrameSet
-*
+* - Variant: Name of variant mapping in use by current Frame
+
* Every FrameSet also inherits any further attributes that belong
* to its current Frame, regardless of that Frame's class. (For
* example, the Equinox attribute, defined by the SkyFrame class, is
@@ -83,15 +85,19 @@ f following routines may also be applied to all FrameSets:
*
c - astAddFrame: Add a Frame to a FrameSet to define a new coordinate
c system
+c - astAddVariant: Add a variant Mapping to the current Frame
c - astGetFrame: Obtain a pointer to a specified Frame in a FrameSet
c - astGetMapping: Obtain a Mapping between two Frames in a FrameSet
+c - astMirrorVariants: Make the current Frame mirror variant Mappings in another Frame
c - astRemapFrame: Modify a Frame's relationship to the other Frames in a
c FrameSet
c - astRemoveFrame: Remove a Frame from a FrameSet
f - AST_ADDFRAME: Add a Frame to a FrameSet to define a new coordinate
f system
+f - AST_ADDVARIANT: Add a variant Mapping to the current Frame
f - AST_GETFRAME: Obtain a pointer to a specified Frame in a FrameSet
f - AST_GETMAPPING: Obtain a Mapping between two Frames in a FrameSet
+f - AST_MIRRORVARIANTS: Make the current Frame mirror variant Mappings in another Frame
f - AST_REMAPFRAME: Modify a Frame's relationship to the other Frames in a
f FrameSet
f - AST_REMOVEFRAME: Remove a Frame from a FrameSet
@@ -245,6 +251,9 @@ f - AST_REMOVEFRAME: Remove a Frame from a FrameSet
* Fix bug in AppendAxes that could cause internal Mappings to
* be inverted unintentionally when astAddFrame is called with
* iframe=AST__ALLFRAMES.
+* 29-APR-2013 (DSB):
+* Added attributes AllVariants and Variant. Also added methods
+* astAddVariant and astMirrorVariants.
*class--
*/
@@ -255,6 +264,8 @@ f - AST_REMOVEFRAME: Remove a Frame from a FrameSet
"protected" symbols available. */
#define astCLASS FrameSet
+#define GETALLVARIANTS_BUFF_LEN 200
+
/*
* Name:
* MAKE_CLEAR
@@ -790,6 +801,7 @@ static int (* parent_managelock)( AstObject *, int, int, AstObject **, int * );
globals->Integrity_Frame = NULL; \
globals->Integrity_Method = ""; \
globals->Integrity_Lost = 0; \
+ globals->GetAllVariants_Buff[ 0 ] = 0; \
/* Create the function that initialises global data for this module. */
astMAKE_INITGLOBALS(FrameSet)
@@ -801,6 +813,7 @@ astMAKE_INITGLOBALS(FrameSet)
#define integrity_frame astGLOBAL(FrameSet,Integrity_Frame)
#define integrity_method astGLOBAL(FrameSet,Integrity_Method)
#define integrity_lost astGLOBAL(FrameSet,Integrity_Lost)
+#define getallvariants_buff astGLOBAL(FrameSet,GetAllVariants_Buff)
@@ -809,7 +822,7 @@ astMAKE_INITGLOBALS(FrameSet)
#else
/* Buffer returned by GetAttrib. */
-static char getattrib_buff[ 51 ];
+static char getattrib_buff[ AST__FRAMESET_GETATTRIB_BUFF_LEN + 1 ];
/* Variables associated with preserving FrameSet integrity. */
static AstFrame *integrity_frame = NULL; /* Pointer to copy of current Frame */
@@ -822,18 +835,21 @@ static int integrity_lost = 0; /* Current Frame modified? */
static AstFrameSetVtab class_vtab; /* Virtual function table */
static int class_init = 0; /* Virtual function table initialised? */
+/* String buffers. */
+static char getallvariants_buff[ AST__FRAMESET_GETALLVARIANTS_BUFF_LEN + 1 ];
+
#endif
/* Prototypes for Private Member Functions. */
/* ======================================== */
-static int GetObjSize( AstObject *, int * );
static AstAxis *GetAxis( AstFrame *, int, int * );
static AstFrame *GetFrame( AstFrameSet *, int, int * );
static AstFrame *PickAxes( AstFrame *, int, const int[], AstMapping **, int * );
static AstFrameSet *Convert( AstFrame *, AstFrame *, const char *, int * );
static AstFrameSet *ConvertX( AstFrame *, AstFrame *, const char *, int * );
static AstFrameSet *FindFrame( AstFrame *, AstFrame *, const char *, int * );
+static AstLineDef *LineDef( AstFrame *, const double[2], const double[2], int * );
static AstMapping *CombineMaps( AstMapping *, int, AstMapping *, int, int, int * );
static AstMapping *GetMapping( AstFrameSet *, int, int, int * );
static AstMapping *RemoveRegions( AstMapping *, int * );
@@ -842,6 +858,8 @@ static AstObject *Cast( AstObject *, AstObject *, int * );
static AstPointSet *FrameGrid( AstFrame *, int, const double *, const double *, int * );
static AstPointSet *ResolvePoints( AstFrame *, const double [], const double [], AstPointSet *, AstPointSet *, int * );
static AstPointSet *Transform( AstMapping *, AstPointSet *, int, AstPointSet *, int * );
+static AstSystemType SystemCode( AstFrame *, const char *, int * );
+static AstSystemType ValidateSystem( AstFrame *, AstSystemType, const char *, int * );
static const char *Abbrev( AstFrame *, int, const char *, const char *, const char *, int * );
static const char *Format( AstFrame *, int, double, int * );
static const char *GetAttrib( AstObject *, const char *, int * );
@@ -851,35 +869,26 @@ static const char *GetLabel( AstFrame *, int, int * );
static const char *GetSymbol( AstFrame *, int, int * );
static const char *GetTitle( AstFrame *, int * );
static const char *GetUnit( AstFrame *, int, int * );
+static const char *GetAllVariants( AstFrameSet *, int * );
+static const char *SystemString( AstFrame *, AstSystemType, int * );
static const int *GetPerm( AstFrame *, int * );
static double Angle( AstFrame *, const double[], const double[], const double[], int * );
static double AxAngle( AstFrame *, const double[], const double[], int, int * );
static double AxDistance( AstFrame *, int, double, double, int * );
static double AxOffset( AstFrame *, int, double, double, int * );
-static double Offset2( AstFrame *, const double[2], double, double, double[2], int * );
-static double Rate( AstMapping *, double *, int, int, int * );
-static AstSystemType ValidateSystem( AstFrame *, AstSystemType, const char *, int * );
-static AstSystemType SystemCode( AstFrame *, const char *, int * );
-static const char *SystemString( AstFrame *, AstSystemType, int * );
-static void CheckPerm( AstFrame *, const int *, const char *, int * );
-static void Resolve( AstFrame *, const double [], const double [], const double [], double [], double *, double *, int * );
-static void ValidateAxisSelection( AstFrame *, int, const int *, const char *, int * );
-static AstLineDef *LineDef( AstFrame *, const double[2], const double[2], int * );
-static int Equal( AstObject *, AstObject *, int * );
-static int LineCrossing( AstFrame *, AstLineDef *, AstLineDef *, double **, int * );
-static int LineContains( AstFrame *, AstLineDef *, int, double *, int * );
-static void LineOffset( AstFrame *, AstLineDef *, double, double, double[2], int * );
-
static double Distance( AstFrame *, const double[], const double[], int * );
static double Gap( AstFrame *, int, double, int *, int * );
+static double Offset2( AstFrame *, const double[2], double, double, double[2], int * );
+static double Rate( AstMapping *, double *, int, int, int * );
static int *MapSplit( AstMapping *, int, const int *, AstMapping **, int * );
+static int Equal( AstObject *, AstObject *, int * );
static int Fields( AstFrame *, int, const char *, const char *, int, char **, int *, double *, int * );
static int ForceCopy( AstFrameSet *, int, int * );
+static int GetActiveUnit( AstFrame *, int * );
static int GetBase( AstFrameSet *, int * );
static int GetCurrent( AstFrameSet *, int * );
static int GetDigits( AstFrame *, int * );
static int GetDirection( AstFrame *, int, int * );
-static int GetActiveUnit( AstFrame *, int * );
static int GetIsLinear( AstMapping *, int * );
static int GetMatchEnd( AstFrame *, int * );
static int GetMaxAxes( AstFrame *, int * );
@@ -888,14 +897,19 @@ static int GetNaxes( AstFrame *, int * );
static int GetNframe( AstFrameSet *, int * );
static int GetNin( AstMapping *, int * );
static int GetNout( AstMapping *, int * );
+static int GetObjSize( AstObject *, int * );
static int GetPermute( AstFrame *, int * );
static int GetPreserveAxes( AstFrame *, int * );
static int GetTranForward( AstMapping *, int * );
static int GetTranInverse( AstMapping *, int * );
+static int GetVarFrm( AstFrameSet *, int, int * );
static int IsUnitFrame( AstFrame *, int * );
+static int LineContains( AstFrame *, AstLineDef *, int, double *, int * );
+static int LineCrossing( AstFrame *, AstLineDef *, AstLineDef *, double **, int * );
static int Match( AstFrame *, AstFrame *, int, int **, int **, AstMapping **, AstFrame **, int * );
static int Span( AstFrameSet *, AstFrame **, int, int, int, AstMapping **, int *, int * );
static int SubFrame( AstFrame *, AstFrame *, int, const int *, const int *, AstMapping **, AstFrame **, int * );
+static int TestActiveUnit( AstFrame *, int * );
static int TestAttrib( AstObject *, const char *, int * );
static int TestBase( AstFrameSet *, int * );
static int TestCurrent( AstFrameSet *, int * );
@@ -904,7 +918,6 @@ static int TestDirection( AstFrame *, int, int * );
static int TestDomain( AstFrame *, int * );
static int TestFormat( AstFrame *, int, int * );
static int TestLabel( AstFrame *, int, int * );
-static int TestActiveUnit( AstFrame *, int * );
static int TestMatchEnd( AstFrame *, int * );
static int TestMaxAxes( AstFrame *, int * );
static int TestMinAxes( AstFrame *, int * );
@@ -918,6 +931,7 @@ static int ValidateAxis( AstFrame *, int, int, const char *, int * );
static int ValidateFrameIndex( AstFrameSet *, int, const char *, int * );
static void AddFrame( AstFrameSet *, int, AstMapping *, AstFrame *, int * );
static void AppendAxes( AstFrameSet *, AstFrame *, int * );
+static void CheckPerm( AstFrame *, const int *, const char *, int * );
static void Clear( AstObject *, const char *, int * );
static void ClearAttrib( AstObject *, const char *, int * );
static void ClearBase( AstFrameSet *, int * );
@@ -939,6 +953,7 @@ static void Copy( const AstObject *, AstObject *, int * );
static void Delete( AstObject *, int * );
static void Dump( AstObject *, AstChannel *, int * );
static void Intersect( AstFrame *, const double[2], const double[2], const double[2], const double[2], double[2], int * );
+static void LineOffset( AstFrame *, AstLineDef *, double, double, double[2], int * );
static void MatchAxes( AstFrame *, AstFrame *, int *, int * );
static void MatchAxesX( AstFrame *, AstFrame *, int *, int * );
static void Norm( AstFrame *, double[], int * );
@@ -948,10 +963,15 @@ static void Overlay( AstFrame *, const int *, AstFrame *, int * );
static void PermAxes( AstFrame *, const int[], int * );
static void PrimaryFrame( AstFrame *, int, AstFrame **, int *, int * );
static void RecordIntegrity( AstFrameSet *, int * );
+static void AddVariant( AstFrameSet *, AstMapping *, const char *, int * );
+static void MirrorVariants( AstFrameSet *, int, int * );
static void RemapFrame( AstFrameSet *, int, AstMapping *, int * );
static void RemoveFrame( AstFrameSet *, int, int * );
+static void RemoveMirrors( AstFrameSet *, int, int * );
static void ReportPoints( AstMapping *, int, AstPointSet *, AstPointSet *, int * );
+static void Resolve( AstFrame *, const double [], const double [], const double [], double [], double *, double *, int * );
static void RestoreIntegrity( AstFrameSet *, int * );
+static void SetActiveUnit( AstFrame *, int, int * );
static void SetAttrib( AstObject *, const char *, int * );
static void SetAxis( AstFrame *, int, AstAxis *, int * );
static void SetBase( AstFrameSet *, int, int * );
@@ -961,7 +981,6 @@ static void SetDirection( AstFrame *, int, int, int * );
static void SetDomain( AstFrame *, const char *, int * );
static void SetFormat( AstFrame *, int, const char *, int * );
static void SetLabel( AstFrame *, int, const char *, int * );
-static void SetActiveUnit( AstFrame *, int, int * );
static void SetMatchEnd( AstFrame *, int, int * );
static void SetMaxAxes( AstFrame *, int, int * );
static void SetMinAxes( AstFrame *, int, int * );
@@ -972,6 +991,7 @@ static void SetTitle( AstFrame *, const char *, int * );
static void SetUnit( AstFrame *, int, const char *, int * );
static void TidyNodes( AstFrameSet *, int * );
static void VSet( AstObject *, const char *, char **, va_list, int * );
+static void ValidateAxisSelection( AstFrame *, int, const int *, const char *, int * );
static double GetBottom( AstFrame *, int, int * );
static int TestBottom( AstFrame *, int, int * );
@@ -1015,6 +1035,11 @@ static int TestAlignSystem( AstFrame *, int * );
static void ClearAlignSystem( AstFrame *, int * );
static void SetAlignSystem( AstFrame *, AstSystemType, int * );
+static const char *GetVariant( AstFrameSet *, int * );
+static int TestVariant( AstFrameSet *, int * );
+static void ClearVariant( AstFrameSet *, int * );
+static void SetVariant( AstFrameSet *, const char *, int * );
+
#if defined(THREAD_SAFE)
static int ManageLock( AstObject *, int, int, AstObject **, int * );
#endif
@@ -1334,6 +1359,8 @@ f AST_SIMPLIFY
Frame. */
this->frame = astGrow( this->frame, this->nframe + 1,
sizeof( AstFrame * ) );
+ this->varfrm = astGrow( this->varfrm, this->nframe + 1,
+ sizeof( int ) );
this->node = astGrow( this->node, this->nframe + 1, sizeof( int ) );
this->map = astGrow( this->map, this->nnode, sizeof( AstMapping * ) );
this->link = astGrow( this->link, this->nnode, sizeof( int ) );
@@ -1345,6 +1372,10 @@ f AST_SIMPLIFY
this->frame[ this->nframe ] = astClone( frame );
this->map[ this->nnode - 1 ] = astClone( map );
+/* Indicate the Frame does not reflect the variant Mappings of any other
+ Frame. */
+ this->varfrm[ this->nframe ] = 0;
+
/* Associate the Frame with the Mapping via the "node" array. */
this->node[ this->nframe ] = this->nnode;
@@ -1391,6 +1422,7 @@ f AST_SIMPLIFY
/* Extend the original FrameSet's arrays to accommodate the new Frames
and nodes. */
this->frame = astGrow( this->frame, nframe, sizeof( AstFrame * ) );
+ this->varfrm = astGrow( this->varfrm, nframe, sizeof( int ) );
this->node = astGrow( this->node, nframe, sizeof( int ) );
this->map = astGrow( this->map, nnode - 1, sizeof( AstMapping * ) );
this->link = astGrow( this->link, nnode - 1, sizeof( int ) );
@@ -1406,6 +1438,12 @@ f AST_SIMPLIFY
astClone( frameset->frame[ ifr - 1 ] );
this->node[ this->nframe + ifr - 1 ] =
frameset->node[ ifr - 1 ] + this->nnode;
+ if( frameset->varfrm[ ifr - 1 ] > 0 ) {
+ this->varfrm[ this->nframe + ifr - 1 ] =
+ frameset->varfrm[ ifr - 1 ] + this->nframe;
+ } else {
+ this->varfrm[ this->nframe + ifr - 1 ] = 0;
+ }
}
/* Similarly, transfer the new node data, cloning each Mapping
@@ -1540,6 +1578,7 @@ f AST_SIMPLIFY
this->frame[ this->nframe + ifr - 1 ] =
astAnnul( this->frame[ this->nframe + ifr - 1 ] );
this->node[ this->nframe + ifr - 1 ] = -1;
+ this->varfrm[ this->nframe + ifr - 1 ] = 0;
}
for ( inode = 0; inode < frameset->nnode; inode++ ) {
this->map[ this->nnode + inode - 1 ] =
@@ -1552,6 +1591,221 @@ f AST_SIMPLIFY
}
}
+static void AddVariant( AstFrameSet *this, AstMapping *map,
+ const char *name, int *status ) {
+/*
+*++
+* Name:
+c astAddVariant
+f AST_ADDVARIANT
+
+* Purpose:
+* Store a new variant Mapping for the current Frame in a FrameSet.
+
+* Type:
+* Public virtual function.
+
+* Synopsis:
+c #include "frameset.h"
+c void astAddVariant( AstFrameSet *this, AstMapping *map,
+c const char *name, int *status )
+f CALL AST_ADDVARIANT( THIS, MAP, NAME, STATUS )
+
+* Class Membership:
+* FrameSet method.
+
+* Description:
+c This function
+f This routine
+* allows a new variant Mapping to be stored with the current Frame
+* in a FrameSet. See the "Variant" attribute for more details. It can
+* also be used to rename the currently selected variant Mapping.
+
+* Parameters:
+c this
+f THIS = INTEGER (Given)
+* Pointer to the FrameSet.
+c map
+f MAP = INTEGER (Given)
+* Pointer to a Mapping which describes how to convert
+* coordinates from the current Frame to the new variant of the
+* current Frame. If
+c NULL
+f AST__NULL
+* is supplied, then the name associated with the currently selected
+* variant of the current Frame is set to the value supplied for
+c "name", but no new variant is added.
+f NAME, but no new variant is added.
+c name
+f NAME = CHARACTER * ( * ) (Given)
+* The name to associate with the new variant Mapping (or the currently
+* selected variant Mapping if
+c "map" is NULL).
+f MAP is AST__NULL).
+f STATUS = INTEGER (Given and Returned)
+f The global status.
+
+* Notes:
+* - The newly added Variant becomes the current variant on exit (this is
+* equivalent to setting the Variant attribute to the value supplied for
+c "name).
+f NAME).
+* - An error is reported if a variant with the supplied name already
+* exists in the current Frame.
+* - An error is reported if the current Frame is a mirror for the
+* variant Mappings in another Frame. This is only the case if the
+c astMirrorVariants function
+f AST_MIRRORVARIANTS routine
+* has been called to make the current Frame act as a mirror.
+
+*--
+*/
+
+/* Local Variables: */
+ AstCmpMap *map2;
+ AstFrame *frm;
+ AstFrame *tfrm;
+ AstFrame *vfrm;
+ AstFrameSet *tfs;
+ AstFrameSet *vfs;
+ AstMapping *map1;
+ AstMapping *map3;
+ char *myname;
+ const char *dom;
+ int icur;
+ int ifrm;
+ int new;
+ int nfrm;
+
+/* Check the global error status. */
+ if ( !astOK ) return;
+
+/* Get the one-based index of the current Frame. */
+ icur = astGetCurrent( this );
+
+/* Report an error if the current Frame is just a mirror. */
+ if( this->varfrm[ icur - 1 ] > 0 && astOK ) {
+ astError( AST__MIRRO, "astAddVariant(%s): Illegal attempt to "
+ "add a variant Mapping to a mirror Frame (programming "
+ "error).", status, astGetClass( this ) );
+ }
+
+/* Get a copy of the supplied string and clean it. */
+ myname = astStore( NULL, name, strlen( name ) + 1 );
+ astRemoveLeadingBlanks( myname );
+ astChrCase( NULL, myname, 1, 0 );
+ if( astOK ) {
+ myname[ astChrLen( myname ) ] = 0;
+
+/* Get the Variants FrameSet for the current Frame in "this". */
+ frm = astGetFrame( this, icur );
+ vfs = astGetFrameVariants( frm );
+
+/* If current Frame of this has no Variant FrameSet, create a Variants
+ FrameSet containing a copy of the current Frame (retain its Domain
+ as the default variant name). */
+ if( !vfs ) {
+ tfrm = astCopy( frm );
+ vfs = astFrameSet( tfrm, " ", status );
+ tfrm = astAnnul( tfrm );
+ new = 1;
+ } else {
+ new = 0;
+ }
+
+/* Check the Variants FrameSet does not already contain a Frame with
+ a Domain equal to the supplied name. */
+ nfrm = astGetNframe( vfs );
+ for( ifrm = 0; ifrm < nfrm && astOK; ifrm++ ) {
+ vfrm = astGetFrame( vfs, ifrm + 1 );
+ dom = astGetDomain( vfrm );
+ if( astOK && !strcmp( dom, myname ) ) {
+ astError( AST__BDVNM, "astAddVariant(%s): Cannot add a "
+ "variant %s Frame with name '%s' because one "
+ "already exists in the %s (programming "
+ "error).", status, astGetClass( this ),
+ astGetDomain( frm ), myname, astGetClass( this ) );
+ }
+ vfrm = astAnnul( vfrm );
+ }
+
+/* If no Mapping was supplied, just set the name of the currently
+ selected variant. The names are stored in the Domain attribute of
+ the Frames in the variants FrameSet, so set teh DOmain for the current
+ Frame. */
+ if( !map ){
+ vfrm = astGetFrame( vfs, AST__CURRENT );
+ astSetDomain( vfrm, name );
+ vfrm = astAnnul( vfrm );
+
+/* If a Mapping was supplied.... */
+ } else {
+
+/* Get the Mapping from the current Frame in the variants FrameSet to the
+ current Frame in "this". Temporarily match the Domains so that
+ astConvert can work. */
+ vfrm = astGetFrame( vfs, AST__CURRENT );
+ dom = astGetDomain( frm );
+ if( dom ) dom = astStore( NULL, dom, strlen( dom ) + 1 );
+ astSetDomain( frm, astGetDomain( vfrm ) );
+ tfs = astConvert( vfrm, frm, "" );
+ astSetDomain( frm, dom );
+ if( tfs ) {
+ map1 = astGetMapping( tfs, AST__BASE, AST__CURRENT );
+ tfs = astAnnul( tfs );
+
+/* Concatenate it with the supplied Mapping to get the mapping from the
+ current Frame in the Variants FrameSet to the new variant Frame. */
+ map2 = astCmpMap( map1, map, 1, " ", status );
+ map3 = astSimplify( map2 );
+
+/* Add a copy of parent Frame into Variants FrameSet, using the above
+ mapping to connect it to the original current Variants Frame. Set
+ its Domain to the supplied name. Re-instate the original current Frame
+ afterwards. Remove the variant frame info before adding it. */
+ (void) astAnnul( vfrm );
+ vfrm = astCopy( frm );
+ astSetFrameVariants( vfrm, NULL );
+ astSetDomain( vfrm, name );
+ icur = astGetCurrent( vfs );
+ astAddFrame( vfs, AST__CURRENT, map3, vfrm );
+ astSetCurrent( vfs, icur );
+
+/* Free resources. */
+ map1 = astAnnul( map1 );
+ map2 = astAnnul( map2 );
+ map3 = astAnnul( map3 );
+
+/* Report an error if a Mapping cannot be found from the new variant Frame
+ to the current Frame in "this". */
+ } else if( astOK ) {
+ astError( AST__INTER, "astAddVariant(%s): Cannot convert "
+ "from a %s with Domain '%s' to a %s with Domain "
+ "'%s' (internal programming error).", status,
+ astGetClass( this ), astGetClass( vfrm ),
+ astGetDomain( vfrm ), astGetClass( frm ),
+ astGetDomain( frm ) );
+ }
+
+/* Free resources. */
+ dom = astFree( (void *) dom );
+ vfrm = astAnnul( vfrm );
+ }
+
+/* If all is well, and the Variants FrameSet is new, store a pointer to
+ it in the current Frame of "this". */
+ if( new ) astSetFrameVariants( frm, vfs );
+
+/* Make the new Variant the current variant. */
+ if( map ) astSetVariant( this, name );
+
+/* Free remaining resources. */
+ frm = astAnnul( frm );
+ vfs = astAnnul( vfs );
+ }
+ myname = astFree( myname );
+}
+
static double Angle( AstFrame *this_frame, const double a[],
const double b[], const double c[], int *status ) {
/*
@@ -2321,10 +2575,16 @@ static void ClearAttrib( AstObject *this_object, const char *attrib, int *status
} else if ( !strcmp( attrib, "report" ) ) {
astClearReport( this );
+/* Variant. */
+/* -------- */
+ } else if ( !strcmp( attrib, "variant" ) ) {
+ astClearVariant( this );
+
/* If the name was not recognised, test if it matches any of the
read-only attributes of this class. If it does, then report an
error. */
- } else if ( !strcmp( attrib, "class" ) ||
+ } else if ( !strcmp( attrib, "allvariants" ) ||
+ !strcmp( attrib, "class" ) ||
!strcmp( attrib, "nframe" ) ||
!strcmp( attrib, "nin" ) ||
!strcmp( attrib, "nobject" ) ||
@@ -2443,6 +2703,56 @@ static void ClearCurrent( AstFrameSet *this, int *status ) {
if ( astOK ) *( invert ? &this->base : &this->current ) = -INT_MAX;
}
+static void ClearVariant( AstFrameSet *this, int *status ) {
+/*
+*+
+* Name:
+* astClearVariant
+
+* Purpose:
+* Clear the value of the Variant attribute of a FrameSet.
+
+* Type:
+* Protected virtual function.
+
+* Synopsis:
+* #include "frameset.h"
+* void astClearVariant( AstFrameSet *this )
+
+* Class Membership:
+* FrameSet method.
+
+* Description:
+* This function clears the value of the Variant attribute of a
+* FrameSet.
+
+* Parameters:
+* this
+* Pointer to the FrameSet.
+*-
+*/
+
+/* Local Variables: */
+ AstFrame *frm;
+ int icur;
+
+/* Check the global error status. */
+ if ( !astOK ) return;
+
+/* Get the one-based index of the Frame to use. */
+ icur = GetVarFrm( this, astGetCurrent( this ), status );
+
+/* Get a pointer to the current Frame in the FrameSet. */
+ frm = astGetFrame( this, icur );
+
+/* Replace any Variants FrameSet in the Frame with a NULL pointer. */
+ astSetFrameVariants( frm, NULL );
+
+/* Annul the current Frame pointer. */
+ frm = astAnnul( frm );
+
+}
+
static AstMapping *CombineMaps( AstMapping *mapping1, int invert1,
AstMapping *mapping2, int invert2,
int series, int *status ) {
@@ -3635,7 +3945,7 @@ static int ForceCopy( AstFrameSet *this, int iframe, int *status ) {
*/
/* Local Variables: */
- astDECLARE_GLOBALS /* Declare the thread specific global data */
+ astDECLARE_GLOBALS /* Declare the thread specific global data */
AstFrame *frame; /* Pointer to Frame */
AstFrame *tmp; /* Temporary Frame pointer */
int ifr; /* Loop counter for Frames */
@@ -3909,6 +4219,7 @@ static int GetObjSize( AstObject *this_object, int *status ) {
}
result += astTSizeOf( this->frame );
+ result += astTSizeOf( this->varfrm );
result += astTSizeOf( this->node );
result += astTSizeOf( this->map );
result += astTSizeOf( this->link );
@@ -4007,9 +4318,14 @@ static const char *GetAttrib( AstObject *this_object, const char *attrib, int *s
/* We first handle attributes that apply to the FrameSet as a whole
(rather than to the current Frame). */
+/* AllVariants. */
+/* ------------ */
+ if ( !strcmp( attrib, "allvariants" ) ) {
+ result = astGetAllVariants( this );
+
/* Base. */
/* ----- */
- if ( !strcmp( attrib, "base" ) ) {
+ } else if ( !strcmp( attrib, "base" ) ) {
base = astGetBase( this );
if ( astOK ) {
(void) sprintf( getattrib_buff, "%d", base );
@@ -4121,6 +4437,11 @@ static const char *GetAttrib( AstObject *this_object, const char *attrib, int *s
result = getattrib_buff;
}
+/* Variant. */
+/* -------- */
+ } else if ( !strcmp( attrib, "variant" ) ) {
+ result = astGetVariant( this );
+
/* Pass unrecognised attributes on to the FrameSet's current Frame for
further interpretation. */
} else {
@@ -5165,6 +5486,155 @@ static int GetUseDefs( AstObject *this_object, int *status ) {
return result;
}
+static int GetVarFrm( AstFrameSet *this, int iframe, int *status ) {
+/*
+* Name:
+* GetVarFrm
+
+* Purpose:
+* Get the index of the variants Frame for a nominated Frame.
+
+* Type:
+* Private function.
+
+* Synopsis:
+* #include "frameset.h"
+* int GetVarFrm( AstFrameSet *this, int iframe, int *status ) {
+
+* Class Membership:
+* Private function.
+
+* Description:
+* This function returns the index of the variants Frame associated
+* with a nominated mirror Frame. See astMirrorVariants.
+
+* Parameters:
+* this
+* Pointer to the FrameSet.
+* iframe
+* The one-based index of the nominated Frame that may potentially be
+* a mirror for the variant Mappings in another Frame.
+* status
+* Pointer to the inherited status variable.
+
+* Returned Value:
+* The one-based Frame index of the Frame that defines the variant
+* Mappings associated with Frame "iframe". This will be the same as
+* "iframe" unless the nominated Frame is a mirror for another Frame.
+*/
+
+/* Local Variables: */
+ int result; /* Value to return */
+
+/* Initialise. */
+ result = AST__NOFRAME;
+
+/* Check the global error status. */
+ if ( !astOK ) return result;
+
+/* Initialise the returned value. */
+ result = iframe;
+
+/* If the nominated Frame is mirroring another Frame, return the index of
+ the mirrored Frame. Walk up the chain until we reach a Frame which is
+ not a mirror for another Frame. */
+ while( this->varfrm[ result - 1 ] > 0 ) {
+ if( this->varfrm[ result - 1 ] == result ) {
+ astError( AST__INTER, "GetVarFrm(FrameSet): FrameSet is corrupt "
+ "(internal programming error).", status );
+ break;
+ } else {
+ result = this->varfrm[ result - 1 ];
+ }
+ }
+
+/* Return the result. */
+ return result;
+}
+
+static const char *GetVariant( AstFrameSet *this, int *status ) {
+/*
+*+
+* Name:
+* astGetVariant
+
+* Purpose:
+* Obtain the value of the Variant attribute for a FrameSet.
+
+* Type:
+* Protected virtual function.
+
+* Synopsis:
+* #include "frameset.h"
+* const char *astGetVariant( AstFrameSet *this )
+
+* Class Membership:
+* FrameSet method.
+
+* Description:
+* This function returns the value of the Variant attribute for a
+* FrameSet.
+
+* Parameters:
+* this
+* Pointer to the FrameSet.
+
+* Returned Value:
+* The Variant attribute value.
+
+* Notes:
+* - A NULL value will be returned if this function is invoked
+* with the global status set, or if it should fail for any reason.
+*-
+*/
+
+/* Local Variables: */
+ AstFrame *frm;
+ AstFrame *vfs;
+ const char *result;
+ int icur;
+ int iuse;
+
+/* Initialise */
+ result = NULL;
+
+/* Check the global error status. */
+ if ( !astOK ) return result;
+
+/* Get the one-based index of the current Frame. */
+ icur = astGetCurrent( this );
+
+/* The current Frame may mirror the variant Mappings in another Frame,
+ rather than defining any variant Mappings itself. Get the one-based
+ index of the Frame that defines the variant Mappings to use. */
+ iuse = GetVarFrm( this, icur, status );
+
+/* Get a pointer to the Variants FrameSet in the used Frame. */
+ frm = astGetFrame( this, iuse );
+ vfs = astGetFrameVariants( frm );
+
+/* If the current Frame has no Variants FrameSet, return the Domain name
+ of the current Frame. */
+ if( !vfs ) {
+ result = astGetDomain( this );
+
+/* Otherwise, return the Domain name of the current Frame in the Variants
+ FrameSet. Then annul the Variants FrameSet pointer. */
+ } else {
+ result = astGetDomain( vfs );
+ vfs = astAnnul( vfs );
+ }
+
+/* Annul the current Frame pointer. */
+ frm = astAnnul( frm );
+
+/* If an error occurred, clear the result. */
+ if ( !astOK ) result = NULL;
+
+/* Return the result. */
+ return result;
+}
+
void astInitFrameSetVtab_( AstFrameSetVtab *vtab, const char *name, int *status ) {
/*
*+
@@ -5229,6 +5699,7 @@ void astInitFrameSetVtab_( AstFrameSetVtab *vtab, const char *name, int *status
/* Store pointers to the member functions (implemented here) that
provide virtual methods for this class. */
vtab->AddFrame = AddFrame;
+ vtab->AddVariant = AddVariant;
vtab->ClearBase = ClearBase;
vtab->ClearCurrent = ClearCurrent;
vtab->GetBase = GetBase;
@@ -5236,6 +5707,8 @@ void astInitFrameSetVtab_( AstFrameSetVtab *vtab, const char *name, int *status
vtab->GetFrame = GetFrame;
vtab->GetMapping = GetMapping;
vtab->GetNframe = GetNframe;
+ vtab->GetAllVariants = GetAllVariants;
+ vtab->MirrorVariants = MirrorVariants;
vtab->RemapFrame = RemapFrame;
vtab->RemoveFrame = RemoveFrame;
vtab->SetBase = SetBase;
@@ -5244,6 +5717,11 @@ void astInitFrameSetVtab_( AstFrameSetVtab *vtab, const char *name, int *status
vtab->TestCurrent = TestCurrent;
vtab->ValidateFrameIndex = ValidateFrameIndex;
+ vtab->ClearVariant = ClearVariant;
+ vtab->GetVariant = GetVariant;
+ vtab->SetVariant = SetVariant;
+ vtab->TestVariant = TestVariant;
+
/* Save the inherited pointers to methods that will be extended, and
replace them with pointers to the new member functions. */
object = (AstObjectVtab *) vtab;
@@ -5880,15 +6358,132 @@ static void LineOffset( AstFrame *this_frame, AstLineDef *line, double par,
fr = astAnnul( fr );
}
-#if defined(THREAD_SAFE)
-static int ManageLock( AstObject *this_object, int mode, int extra,
- AstObject **fail, int *status ) {
+static const char *GetAllVariants( AstFrameSet *this, int *status ) {
/*
* Name:
-* ManageLock
+* GetAllVariants
* Purpose:
-* Manage the thread lock on an Object.
+* Get a pointer to a list of the variant Mappings for the current Frame.
+
+* Type:
+* Private function.
+
+* Synopsis:
+* #include "frameset.h"
+* const char *getAllVariants( AstFrameSet *this )
+
+* Class Membership:
+* FrameSet member function.
+
+* Description:
+* This function returns a space separated list of names for all the
+* variant Mappings associated with the current Frame. See attribute
+* "Variant". If the current Frame has no variant Mappings, the return
+* value contains just the Domain name of the current Frame in the
+* supplied FrameSet.
+
+* Parameters:
+* this
+* Pointer to the Frame.
+
+* Returned Value:
+* A pointer to a null-terminated string containing the list.
+
+* Notes:
+* - The returned string pointer may point at memory allocated
+* within the FrameSet, or at static memory. The contents of the
+* string may be over-written or the pointer may become invalid
+* following a further invocation of the same function or any
+* modification of the Frame. A copy of the string should
+* therefore be made if necessary.
+* - A NULL pointer will be returned if this function is invoked
+* with the global error status set, or if it should fail for any
+* reason.
+*/
+
+/* Local Variables: */
+ astDECLARE_GLOBALS
+ AstFrame *frm;
+ AstFrame *vfrm;
+ AstFrameSet *vfs;
+ const char *dom;
+ const char *result;
+ int ifrm;
+ int nc;
+ int icur;
+ int nfrm;
+
+/* Check the global error status. */
+ if ( !astOK ) return NULL;
+
+/* Get a pointer to the structure holding thread-specific global data. */
+ astGET_GLOBALS( this );
+
+/* Get the one-based index of the Frame that defines the available
+ variant Mappings. */
+ icur = GetVarFrm( this, astGetCurrent( this ), status );
+
+/* Get the variants FrameSet from the Frame selected above. */
+ frm = astGetFrame( this, icur );
+ vfs = astGetFrameVariants( frm );
+
+/* If the Frame does not have a variants FrameSet, just return the DOmain
+ name from the current Frame. */
+ if( !vfs ) {
+ result = astGetDomain( this );
+
+/* If a variants FrameSet was found, form a space sperated list of the
+ Domain names in the FrameSet, stored in the static "getallvariants_buff"
+ string. */
+ } else if( astOK ){
+ nc = 0;
+
+ nfrm = astGetNframe( vfs );
+ for( ifrm = 0; ifrm < nfrm; ifrm++ ) {
+ vfrm = astGetFrame( vfs, ifrm + 1 );
+ dom = astGetDomain( vfrm );
+ if( astOK ){
+ if( ( nc + strlen(dom) + 1 ) < GETALLVARIANTS_BUFF_LEN ) {
+ nc += sprintf( getallvariants_buff + nc, "%s ", dom );
+ } else {
+ astError( AST__INTER, "astGetAllVariants(%s): Buffer "
+ "overflow - too many variants.", status,
+ astGetClass(this) );
+ }
+ }
+ vfrm = astAnnul( vfrm );
+ }
+
+/* Remove the final space. */
+ getallvariants_buff[ nc - 1 ] = 0;
+
+/* Return a pointer to the buffer. */
+ result = getallvariants_buff;
+
+/* Annul the pointer to the variants FrameSet. */
+ vfs = astAnnul( vfs );
+ }
+
+/* Free the pointer to the current Frame. */
+ frm = astAnnul( frm );
+
+/* If an error occurred, clear the result value. */
+ if ( !astOK ) result = NULL;
+
+/* Return the result. */
+ return result;
+}
+
+#if defined(THREAD_SAFE)
+static int ManageLock( AstObject *this_object, int mode, int extra,
+ AstObject **fail, int *status ) {
+/*
+* Name:
+* ManageLock
+
+* Purpose:
+* Manage the thread lock on an Object.
* Type:
* Private function.
@@ -6367,6 +6962,115 @@ static void MatchAxesX( AstFrame *frm2_frame, AstFrame *frm1, int *axes,
frm2 = astAnnul( frm2 );
}
+static void MirrorVariants( AstFrameSet *this, int iframe, int *status ) {
+/*
+*++
+* Name:
+c astMirrorVariants
+f AST_MIRRORVARIANTS
+
+* Purpose:
+* Make the current Frame mirror the variant Mappings in another Frame.
+
+* Type:
+* Public virtual function.
+
+* Synopsis:
+c #include "frameset.h"
+c void astMirrorVariants( AstFrameSet *this, int iframe, int *status )
+f CALL AST_MIRRORVARIANTS( THIS, IFRAME, STATUS )
+
+* Class Membership:
+* FrameSet method.
+
+* Description:
+c This function
+f This routine
+* indicates that all access to the Variant attribute of the current
+* Frame should should be forwarded to some other nominated Frame in
+* the FrameSet. For instance, if a value is set subsequently for the
+* Variant attribute of the current Frame, the current Frame will be left
+* unchanged and the setting is instead applied to the nominated Frame.
+* Likewise, if the value of the Variant attribute is requested, the
+* value returned is the value stored for the nominated Frame rather
+* than the current Frame itself.
+*
+* This provides a mechanism for propagating the effects of variant
+* Mappings around a FrameSet. If a new Frame is added to a FrameSet
+* by connecting it to an pre-existing Frame that has two or more variant
+* Mappings, then it may be appropriate to set the new Frame so that it
+* mirrors the variants Mappings of the pre-existing Frame. If this is
+* done, then it will be possible to select a specific variant Mapping
+* using either the pre-existing Frame or the new Frame.
+
+* Parameters:
+c this
+f THIS = INTEGER (Given)
+* Pointer to the FrameSet.
+c iframe
+f IFRAME = INTEGER (Given)
+* The index of the Frame within the FrameSet which is to be
+* mirrored by the current Frame. This value should lie in the range
+* from 1 to the number of Frames in the FrameSet (as given by its
+* Nframe attribute). If AST__NOFRAME is supplied (or the current
+* Frame is specified), then any mirroring established by a previous
+* call to this
+c function
+f routine
+* is disabled.
+f STATUS = INTEGER (Given and Returned)
+f The global status.
+
+* Notes:
+* - Mirrors can be chained. That is, if Frame B is set to be a mirror
+* of Frame A, and Frame C is set to be a mirror of Frame B, then
+* Frame C will act as a mirror of Frame A.
+* - Variant Mappings cannot be added to the current Frame if it is
+* mirroring another Frame. So calls to the
+c astAddVariant function
+f AST_ADDVARIANT routine
+* will cause an error to be reported if the current Frame is
+* mirroring another Frame.
+* - A value of AST__BASE may be given for the
+c "iframe" parameter
+f IFRAME argument
+* to specify the base Frame.
+* - Any variant Mappings explicitly added to the current Frame using
+c astAddVariant
+f AST_ADDVARIANT
+* will be ignored if the current Frame is mirroring another Frame.
+
+*--
+*/
+
+/* Local Variables: */
+ int icur;
+
+/* Check the global error status. */
+ if ( !astOK ) return;
+
+/* Get the current Frame index. */
+ icur = astGetCurrent( this );
+
+/* If AST__NOFRAME, disable any mirroring. */
+ if( iframe == AST__NOFRAME ) {
+ this->varfrm[ icur - 1 ] = 0;
+
+/* Otherwise, validate and translate the Frame index supplied. */
+ } else {
+ iframe = astValidateFrameIndex( this, iframe, "astMirrorVariants" );
+
+/* If the current Frame has been specified, disable any mirroring. */
+ if( iframe == icur ) {
+ this->varfrm[ icur - 1 ] = 0;
+
+/* Otherwise, store the one-based variants frame index. */
+ } else {
+ this->varfrm[ icur - 1 ] = iframe;
+ }
+ }
+}
+
static void Norm( AstFrame *this_frame, double value[], int *status ) {
/*
* Name:
@@ -7266,14 +7970,19 @@ c (astAddFrame) and the original one removed if necessary
c (astRemoveFrame).
f (AST_ADDFRAME) and the original one removed if necessary
f (AST_REMOVEFRAME).
+* - Any variant Mappings associated with the remapped Frame (except
+* for the current variant) will be lost as a consequence of calling this
+* method (see attribute "Variant").
*--
*/
/* Local Variables: */
AstFrame *fr; /* Pointer to Frame */
+ int icur; /* Index of original current Frame */
int naxes; /* Number of Frame axes */
int nin; /* Number of Mapping input coordinates */
int nout; /* Number of Mapping output coordinates */
+ int varfrm; /* The index of the variants frame */
/* Check the global error status. */
if ( !astOK ) return;
@@ -7281,6 +7990,31 @@ f (AST_REMOVEFRAME).
/* Validate and translate the Frame index supplied. */
iframe = astValidateFrameIndex( this, iframe, "astRemapFrame" );
+/* Variant Mappings from a source node to a destination node are stored
+ within the Frame object associated with the destination node. But
+ remapping a Frame causes the Frame to be dissociated from its original
+ node, and associated with a new node, leaving the original node
+ without any Frame in which to store its variant mappings. So we are
+ forced to remove the variant Mappings if the Frame is remapped. We do
+ this by clearing the Variant attribute before the Frame is remapped.
+ This will leave the current variant as the sole Mapping between the
+ original source and destination nodes. However, if the Frame being
+ remapped is just a mirror for another Frame, then we do not need to
+ do this since the Frame being mirrored is not itself being remapped
+ and so can retain its variant mappings. So we temporarily prevent the
+ remapped Frame from acting as a mirror before we clear the Variant
+ attribute. */
+ icur = astGetCurrent( this );
+ astSetCurrent( this, iframe );
+
+ varfrm = this->varfrm[ iframe - 1 ];
+ this->varfrm[ iframe - 1 ] = 0;
+
+ astClearVariant( this );
+
+ this->varfrm[ iframe - 1 ] = varfrm;
+ astSetCurrent( this, icur );
+
/* Obtain the number of input and output coordinates per point for the
Mapping supplied. */
nin = astGetNin( map );
@@ -7430,15 +8164,27 @@ f IFRAME argument to specify the base Frame or the current
} else {
this->frame[ iframe - 1 ] = astAnnul( this->frame[ iframe - 1 ] );
+/* Ensure that the variant Mappings in the Frame being removed are not
+ mirrored by any other Frames in the FrameSet. */
+ RemoveMirrors( this, iframe, status );
+
+/* Any Frames that are mirroring variants in Frames higher than the
+ removed Frame need to have their mirror frame indicies decremented. */
+ for ( ifr = 1; ifr <= this->nframe; ifr++ ) {
+ if( this->varfrm[ ifr - 1 ] > iframe ) this->varfrm[ ifr - 1 ]--;
+ }
+
/* Loop to move all subsequent Frame pointers down in the FrameSet's
"frame" array to close the resulting gap. Also move the associated
- "node" array contents in the same way. */
+ "node" and "varfrm" array contents in the same way. */
for ( ifr = iframe; ifr < this->nframe; ifr++ ) {
this->frame[ ifr - 1 ] = this->frame[ ifr ];
this->node[ ifr - 1 ] = this->node[ ifr ];
+ this->varfrm[ ifr - 1 ] = this->varfrm[ ifr ];
}
this->frame[ this->nframe - 1 ] = NULL;
this->node[ this->nframe - 1 ] = -1;
+ this->varfrm[ this->nframe - 1 ] = 0;
/* Decrement the Frame count. */
this->nframe--;
@@ -7475,6 +8221,79 @@ f IFRAME argument to specify the base Frame or the current
}
}
+static void RemoveMirrors( AstFrameSet *this, int iframe, int *status ) {
+/*
+* Name:
+* RemoveMirrors
+
+* Purpose:
+* Ensure no other Frames act as mirrors for a specified Frame.
+
+* Type:
+* Private function.
+
+* Synopsis:
+* #include "frameset.h"
+* void RemoveMirrors( AstFrameSet *this, int iframe, int *status )
+
+* Class Membership:
+* Private function.
+
+* Description:
+* This function searchs the FrameSet for Frames that are currently
+* acting as mirrors for the variant Mappings in the Frame with index
+* "iframe", and disables mirroring in any found Frames. It should be
+* used when "iframe" has its variant Mappings removed.
+
+* Parameters:
+* this
+* Pointer to the FrameSet.
+* iframe
+* One-based index of a Frame that has had its variant Mappings
+* removed.
+* status
+* Pointer to the inherited status variable.
+
+*/
+
+/* Local Variables: */
+ int *frmlist;
+ int ifr;
+ int nfrm;
+
+/* Check the global error status. */
+ if ( !astOK ) return;
+
+/* Iniitalise a list to hold the indices of the FRames that mirror
+ "iframe". */
+ nfrm = 0;
+ frmlist = NULL;
+
+/* Check each Frame in the FrameSet. */
+ for( ifr = 1; ifr <= this->nframe; ifr++ ) {
+
+/* Get the index of the Frame that defines the variant Mappings to use
+ with Frame "ifr". If this is "iframe", then add "ifr" to the list of
+ Frames that need to be "de-mirrored". We cannot "de-mirror" the Frame
+ immediately as doing so may break a chain of mirrors, resulting in the
+ Frames higher up the chain no longer being associated with "iframe". */
+ if( GetVarFrm( this, ifr, status ) == iframe ) {
+ frmlist = astGrow( frmlist, nfrm + 1, sizeof( *frmlist ) );
+ if( astOK ) frmlist[ nfrm++ ] = ifr;
+ }
+ }
+
+/* Loop round all the Frames found above that mirror "iframe". */
+ for( ifr = 0; ifr < nfrm; ifr++ ) {
+
+/* Indicate that the Frame no longer mirrors any other Frame. */
+ this->varfrm[ frmlist[ ifr ] - 1 ] = 0;
+ }
+
+/* Free the list. */
+ frmlist = astFree( frmlist );
+}
+
static AstMapping *RemoveRegions( AstMapping *this_mapping, int *status ) {
/*
* Name:
@@ -8108,6 +8927,7 @@ static void SetAttrib( AstObject *this_object, const char *setting, int *status
int len; /* Length of setting string */
int nc; /* Number of characters read by astSscanf */
int report; /* Report attribute value */
+ int variant; /* Offset of Variant string */
/* Check the global error status. */
if ( !astOK ) return;
@@ -8230,6 +9050,13 @@ static void SetAttrib( AstObject *this_object, const char *setting, int *status
&& ( nc >= len ) ) {
astSetReport( this, report );
+/* Variant. */
+/* -------- */
+ } else if ( nc = 0,
+ ( 0 == astSscanf( setting, "variant=%n%*[^\n]%n", &variant, &nc ) )
+ && ( nc >= len ) ) {
+ astSetVariant( this, setting + variant );
+
/* Define a macro to see if the setting string matches any of the
read-only attributes of this class. */
#define MATCH(attrib) \
@@ -8238,7 +9065,8 @@ static void SetAttrib( AstObject *this_object, const char *setting, int *status
/* If the attribute was not recognised, use this macro to report an error
if a read-only attribute has been specified. */
- } else if ( MATCH( "class" ) ||
+ } else if ( MATCH( "allvariants" ) ||
+ MATCH( "class" ) ||
MATCH( "nframe" ) ||
MATCH( "nin" ) ||
MATCH( "nobject" ) ||
@@ -8439,6 +9267,223 @@ static void SetCurrent( AstFrameSet *this, int iframe, int *status ) {
if ( astOK ) *( invert ? &this->base : &this->current ) = iframe;
}
+static void SetVariant( AstFrameSet *this, const char *variant, int *status ) {
+/*
+*+
+* Name:
+* astSetVariant
+
+* Purpose:
+* Set a value for the Variant attribute of a FrameSet.
+
+* Type:
+* Protected virtual function.
+
+* Synopsis:
+* #include "frameset.h"
+* void astSetVariant( AstFrameSet *this, const char *variant )
+
+* Class Membership:
+* FrameSet method.
+
+* Description:
+* This function sets a value for the Variant attribute of a FrameSet.
+
+* Parameters:
+* this
+* Pointer to the FrameSet.
+* variant
+* Value to be set for the Variant attribute.
+
+* Notes:
+* - An error will be reported if the supplied variant name cannot be
+* found in the Variants FrameSet associated with the current Frame.
+
+*-
+*/
+
+/* Local Variables: */
+ AstCmpMap *map6;
+ AstCmpMap *map5;
+ AstCmpMap *map4;
+ AstFrame *frm;
+ AstFrame *vfrm;
+ AstFrameSet *tfs;
+ AstFrameSet *vfs;
+ AstMapping *map0;
+ AstMapping *map2;
+ AstMapping *map3;
+ AstMapping *map1;
+ char *myvar;
+ const char *dom;
+ int icur;
+ int ifrm;
+ int inode;
+ int inv0;
+ int inv;
+ int nfrm;
+
+/* Check the global error status. */
+ if ( !astOK ) return;
+
+/* Get a copy of the supplied string and clean it. */
+ myvar = astStore( NULL, variant, strlen( variant ) + 1 );
+ astRemoveLeadingBlanks( myvar );
+ astChrCase( NULL, myvar, 1, 0 );
+ if( astOK ) {
+ myvar[ astChrLen( myvar ) ] = 0;
+
+/* Get the one-based index of the Frame that defines the available
+ variant Mappings. */
+ icur = GetVarFrm( this, astGetCurrent( this ), status );
+
+/* Get the variants FrameSet from the Frame selected above. */
+ frm = astGetFrame( this, icur );
+ vfs = astGetFrameVariants( frm );
+
+/* If there is no variants FrameSet in the Frame, the only allowed value
+ for "Variant" is the Domain name of the current Frame. */
+ if( ! vfs ) {
+ dom = astGetDomain( this );
+ if( astOK && strcmp( myvar, dom ) ) {
+ astError( AST__ATTIN, "astSetVariant(%s): Unknown Frame "
+ "variant '%s' requested.", status, astGetClass( this ),
+ myvar );
+ }
+
+/* If there is a variants FrameSet in the Frame... */
+ } else {
+
+/* Find the index of the Frame in the Variants FrameSet that has a Domain
+ equal to myvar. */
+ nfrm = astGetNframe( vfs );
+ for( ifrm = 0; ifrm < nfrm; ifrm++ ) {
+ vfrm = astGetFrame( vfs, ifrm + 1 );
+ dom = astGetDomain( vfrm );
+ vfrm = astAnnul( vfrm );
+ if( !astOK || !strcmp( myvar, dom ) ) break;
+ }
+
+/* Report an error if no such Frame found. */
+ if( ifrm == nfrm && astOK ) {
+ astError( AST__ATTIN, "astSetVariant(%s): Unknown Frame "
+ "variant '%s' requested - available variants are "
+ "'%s'.", status, astGetClass(this), myvar,
+ astGetAllVariants(this) );
+
+/* Otherwise, get a Mapping from the current Frame in "this" to the
+ currently selected Variant Frame. We cannot assume that they are the
+ same as attributes of the current Frame (e.g. System) may have been
+ changed since the variant was added. If the required Frame is already
+ the current Frame, there is nothing more to do since the required
+ variant is already selected. */
+ } else if( ifrm + 1 != astGetCurrent( vfs ) ){
+ vfrm = astGetFrame( vfs, AST__CURRENT );
+ dom = astGetDomain( frm );
+ if( dom ) dom = astStore( NULL, dom, strlen( dom ) + 1 );
+ astSetDomain( frm, astGetDomain( vfrm ) );
+ tfs = astConvert( frm, vfrm, "" );
+ astSetDomain( frm, dom );
+ if( tfs ) {
+ map1 = astGetMapping( tfs, AST__BASE, AST__CURRENT );
+ tfs = astAnnul( tfs );
+ vfrm = astAnnul( vfrm );
+
+/* Get the Mapping from the original Variant Frame to the requested variant
+ Frame. */
+ map2 = astGetMapping( vfs, AST__CURRENT, ifrm + 1 );
+
+/* Get a Mapping from the new variant Frame to the current Frame in "this". */
+ vfrm = astGetFrame( vfs, ifrm + 1 );
+ astSetDomain( frm, astGetDomain( vfrm ) );
+ tfs = astConvert( vfrm, frm, "" );
+ astSetDomain( frm, dom );
+ if( tfs ) {
+ map3 = astGetMapping( tfs, AST__BASE, AST__CURRENT );
+ tfs = astAnnul( tfs );
+
+/* Concatentate the three Mappings, to get the Mapping from the old
+ variant Frame to the new variant Frame. */
+ map4 = astCmpMap( map1, map2, 1, " ", status );
+ map5 = astCmpMap( map4, map3, 1, " ", status );
+
+/* Now we modify the Mapping in the FrameSet. First get the index of the node
+ with which the Frame is associated. */
+ inode = this->node[ icur - 1 ];
+
+/* Get the Mapping that generates the node values, and its Invert flag. */
+ map0 = this->map[ inode - 1 ];
+ inv0 = this->invert[ inode - 1 ];
+
+/* Temporarily reset the invert flag in the Mapping to account for any
+ changes made to the Mapping via other pointers. */
+ inv = astGetInvert( map0 );
+ astSetInvert( map0, inv0 );
+
+/* Concatentate with "map5" to get the Mapping form the the parent node
+ to the new variant of the current node. */
+ map6 = astCmpMap( map0, map5, 1, " ", status );
+
+/* Simplify it and use it to replace the Mapping in the FrameSet structure. */
+ this->map[ inode - 1 ] = astSimplify( map6 );
+ this->invert[ inode - 1 ] = astGetInvert( this->map[ inode - 1 ] );
+
+/* Re-instate the original Invert flag and free the old Mapping pointer. */
+ astSetInvert( map0, inv );
+ map0 = astAnnul( map0 );
+
+/* Make the variant Frame the current Frame within the Variants FrameSet. */
+ astSetCurrent( vfs, ifrm + 1 );
+
+/* Free resources. */
+ map6 = astAnnul( map6 );
+ map5 = astAnnul( map5 );
+ map4 = astAnnul( map4 );
+ map3 = astAnnul( map3 );
+
+/* Report an error if a Mapping cannot be found from the new variant Frame
+ to the current Frame in "this". */
+ } else if( astOK ) {
+ astError( AST__INTER, "astSetVariant(%s): Cannot convert "
+ "from a %s with Domain '%s' to a %s with Domain "
+ "'%s' (internal programming error).", status,
+ astGetClass( this ), astGetClass( vfrm ),
+ astGetDomain( vfrm ), astGetClass( frm ),
+ astGetDomain( frm ) );
+ }
+
+/* Free resources. */
+ map2 = astAnnul( map2 );
+ map1 = astAnnul( map1 );
+
+/* Report an error if a Mapping cannot be found from the current Frame in
+ "this" to the current Variant Frame. */
+ } else if( astOK ) {
+ astError( AST__INTER, "astSetVariant(%s): Cannot convert "
+ "from a %s with Domain '%s' to a %s with Domain "
+ "'%s' (internal programming error).", status,
+ astGetClass( this ), astGetClass( frm ),
+ astGetDomain( frm ), astGetClass( vfrm ),
+ astGetDomain( vfrm ) );
+ }
+
+/* Free resources. */
+ vfrm = astAnnul( vfrm );
+ dom = astFree( (void *) dom );
+ }
+
+/* Annul the pointer to the Variants FrameSet. */
+ vfs = astAnnul( vfs );
+ }
+
+/* Annul the pointer to the current Frame in "this". */
+ frm = astAnnul( frm );
+ }
+
+/* Free the memory holding the cleaned variant name. */
+ myvar = astFree( myvar );
+}
+
static AstMapping *Simplify( AstMapping *this_mapping, int *status ) {
/*
* Name:
@@ -9152,10 +10197,16 @@ static int TestAttrib( AstObject *this_object, const char *attrib, int *status )
} else if ( !strcmp( attrib, "report" ) ) {
result = astTestReport( this );
+/* Variant. */
+/* -------- */
+ } else if ( !strcmp( attrib, "variant" ) ) {
+ result = astTestVariant( this );
+
/* If the name is not recognised, test if it matches any of the
read-only attributes of this class. If it does, then return
zero. */
- } else if ( !strcmp( attrib, "class" ) ||
+ } else if ( !strcmp( attrib, "allvariants" ) ||
+ !strcmp( attrib, "class" ) ||
!strcmp( attrib, "nframe" ) ||
!strcmp( attrib, "nin" ) ||
!strcmp( attrib, "nobject" ) ||
@@ -9313,6 +10364,72 @@ static int TestCurrent( AstFrameSet *this, int *status ) {
return result;
}
+static int TestVariant( AstFrameSet *this, int *status ) {
+/*
+*+
+* Name:
+* astTestVariant
+
+* Purpose:
+* Determine if a value has been set for the Variant attribute of a FrameSet.
+
+* Type:
+* Protected virtual function.
+
+* Synopsis:
+* #include "frameset.h"
+* int astTestVariant( AstFrameSet *this )
+
+* Class Membership:
+* FrameSet method.
+
+* Description:
+* This function returns a boolean result to indicate if a value
+* has been set for the Variant attribute of a FrameSet.
+
+* Parameters:
+* this
+* Pointer to the FrameSet.
+
+* Returned Value:
+* Zero or 1, depending on whether a value has been set.
+
+* Notes:
+* - A value of zero will be returned if this function is invoked
+* with the global status set, or if it should fail for any reason.
+*-
+*/
+
+/* Local Variables: */
+ AstFrame *frm;
+ AstFrameSet *vfs;
+ int result;
+ int icur;
+
+/* Initialise. */
+ result = 0;
+
+/* Check the global error status. */
+ if ( !astOK ) return result;
+
+/* Get the one-based index of the Frame to use. */
+ icur = GetVarFrm( this, astGetCurrent( this ), status );
+
+/* Get a pointer to the Variants FrameSet in the current Frame. */
+ frm = astGetFrame( this, icur );
+ vfs = astGetFrameVariants( frm );
+
+/* If it is null, return zero, otherwise 1. */
+ result = vfs ? 1 : 0;
+
+/* Annul pointers. */
+ if( vfs ) vfs = astAnnul( vfs );
+ frm = astAnnul( frm );
+
+/* Return the result. */
+ return result;
+}
+
static void TidyNodes( AstFrameSet *this, int *status ) {
/*
* Name:
@@ -10189,6 +11306,33 @@ static void VSet( AstObject *this_object, const char *settings,
/*
*att++
* Name:
+* AllVariants
+
+* Purpose:
+* A list of the variant Mappings associated with the current Frame.
+
+* Type:
+* Public attribute.
+
+* Synopsis:
+* String, read-only.
+
+* Description:
+* This attrbute gives a space separated list of the names of all the
+* variant Mappings associated with the current Frame (see attribute
+* "Variant"). If the current Frame has no variant Mappings, then the
+* list will hold a single entry equal to the Domain name of the
+* current Frame.
+
+* Applicability:
+* FrameSet
+* All FrameSets have this attribute.
+*att--
+*/
+
+/*
+*att++
+* Name:
* Base
* Purpose:
@@ -10275,6 +11419,121 @@ f Invert attribute, with the AST_INVERT routine for example) will
*att--
*/
+/*
+*att++
+* Name:
+* Variant
+
+* Purpose:
+* Indicates which variant of the current Frame is to be used.
+
+* Type:
+* Public attribute.
+
+* Synopsis:
+* String.
+
+* Description:
+* This attribute can be used to change the Mapping that connects the
+* current Frame to the other Frames in the FrameSet. By default, each
+* Frame in a FrameSet is connected to the other Frames by a single
+* Mapping that can only be changed by using the
+c astRemapFrame
+f AST_REMAPFRAME
+* method. However, it is also possible to associate multiple Mappings
+* with a Frame, each Mapping having an identifying name. If this is
+* done, the "Variant" attribute can be set to indicate the name of
+* the Mapping that is to be used with the current Frame.
+*
+* A possible (if unlikely) use-case is to create a FrameSet that can
+* be used to describe the WCS of an image formed by co-adding images
+* of two different parts of the sky. In such an image, each pixel contains
+* flux from two points on the sky.and so the WCS for the image should
+* ideally contain one pixel Frame and two SkyFrames - one describing
+* each of the two co-added images. There is nothing to prevent a
+* FrameSet containing two explicit SkyFrames, but the problem then arises
+* of how to distinguish between them. The two primary characteristics of
+* a Frame that distinguishes it from other Frames ar eits class and its
+* Domain attribute value. The class of a Frame cannot be changed, but we
+* could in principle use two different Domain values to distinguish the
+* two SkyFrames. However, in practice it is not uncommon for application
+* software to assume that SkyFrames will have the default Domain value
+* of "SKY". That is, instead of searching for Frames that have a class
+* of "SkyFrame", such software searches for Frames that have a Domain
+* of "SKY". To alleviate this problem, it is possible to add a single
+* SkyFrame to the FrameSet, but specifying two alternate Mappings to
+* use with the SkyFrame. Setting the "Variant" attribute to the name
+* of one or the other of these alternate Mappings will cause the
+* SkyFrame to be remapped within the FrameSet so that it uses the
+* specified Mapping. The same facility can be used with any class of
+* Frame, not just SkyFrames.
+*
+* To use this facility, the Frame should first be added to the
+* FrameSet in the usual manner using the
+c astAddFrame method. By default, the Mapping supplied to astAddFrame
+f AST_ADDFRAME method. By default, the Mapping supplied to AST_ADDVARIANT
+* is assigned a name equal to the Domain name of the Frame. To assign a
+* different name to it, the
+c astAddVariant
+f AST_ADDVARIANT
+* method should then be called specifying the required name and a NULL
+* Mapping. The
+c astAddFrame
+f AST_ADDFRAME
+* method should then be called repeatedly to add each required extra
+* Mapping to the current Frame, supplying a unique name for each one.
+*
+* Each Frame in a FrameSet can have its own set of variant Mappings.
+* To control the Mappings in use with a specific Frame, you need first
+* to make it the current Frame in the FrameSet.
+*
+* The
+c astMirrorVariants function
+f AST_MIRRORVARIANTS routine
+* allows the effects of variant Mappings associated with a nominated
+* Frame to be propagated to other Frames in the FrameSet.
+*
+* Once this has been done, setting a new value for the "Variant"
+* attribute of a FrameSet will cause the current Frame in the
+* FrameSet to be remapped to use the specified variant Mapping. An
+* error will be reported if the current Frame has no variant Mapping
+* with the supplied name.
+*
+* Getting the value of the "Variant" attribute will return the name
+* of the variant Mapping currently in use with the current Frame. If
+* the Frame has no variant Mappings, the value will default to the
+* Domain name of the current Frame.
+*
+* Clearing the "Variant" attribute will have the effect of removing
+* all variant Mappings (except for the currently selected Mapping) from
+* the current Frame.
+*
+* Testing the "Variant" attribute will return
+c a non-zero value
+f .TRUE.
+* if the current Frame contains any variant Mappings, and
+c zero
+f .FALSE.
+* otherwise.
+*
+* A complete list of the names associated with all the available
+* variant Mappings in the current Frame can be obtained from the
+* AllVariants attribute.
+*
+* If a Frame with variant Mappings is remapped using the
+c astRemapFrame
+f AST_REMAPFRAME
+* method, the currently selected variant Mapping is used by
+c astRemapFrame
+f AST_REMAPFRAME
+* and the other variant Mappings are removed from the Frame.
+
+* Applicability:
+* FrameSet
+* All FrameSets have this attribute.
+*att--
+*/
+
/* Access to attributes of the current Frame. */
/* ------------------------------------------ */
/* Use the macros defined at the start of this file to implement
@@ -10430,6 +11689,7 @@ static void Copy( const AstObject *objin, AstObject *objout, int *status ) {
/* For safety, first clear any references to the input memory from
the output FrameSet. */
out->frame = NULL;
+ out->varfrm = NULL;
out->node = NULL;
out->map = NULL;
out->link = NULL;
@@ -10438,6 +11698,8 @@ static void Copy( const AstObject *objin, AstObject *objout, int *status ) {
/* Allocate memory in the output FrameSet to store the Frame and node
information and copy scalar information across. */
out->frame = astMalloc( sizeof( AstFrame * ) * (size_t) in->nframe );
+ out->varfrm = astStore( NULL, in->varfrm, sizeof( int ) *
+ (size_t) in->nframe );
out->node = astStore( NULL, in->node, sizeof( int ) *
(size_t) in->nframe );
out->map = astMalloc( sizeof( AstMapping * ) * (size_t) ( in->nnode - 1 ) );
@@ -10472,6 +11734,7 @@ static void Copy( const AstObject *objin, AstObject *objout, int *status ) {
/* If an error occurred, clean up by freeing all memory allocated above. */
if ( !astOK ) {
out->frame = astFree( out->frame );
+ out->varfrm = astFree( out->varfrm );
out->node = astFree( out->node );
out->map = astFree( out->map );
out->link = astFree( out->link );
@@ -10534,6 +11797,7 @@ static void Delete( AstObject *obj, int *status ) {
/* Free all allocated memory. */
this->frame = astFree( this->frame );
+ this->varfrm = astFree( this->varfrm );
this->node = astFree( this->node );
this->map = astFree( this->map );
this->link = astFree( this->link );
@@ -10659,6 +11923,24 @@ static void Dump( AstObject *this_object, AstChannel *channel, int *status ) {
astWriteInt( channel, key, set, 0, ival, comment );
}
+/* Index of variants Frame for each Frame. */
+/* --------------------------------------- */
+ for ( ifr = 1; ifr <= this->nframe; ifr++ ) {
+
+/* Retain the one-based Frame index values in varfrm. Regard a number as
+ "set" if it is greater than zero. */
+ ival = this->varfrm[ ifr - 1 ];
+ set = ( ival > 0 );
+
+/* Create a suitable keyword and comment. */
+ (void) sprintf( key, "VFr%d", ifr );
+ (void) sprintf( comment,
+ "Frame %d inherits variants from Frame %d", ifr, ival );
+
+/* Write out the value. */
+ astWriteInt( channel, key, set, 0, ival, comment );
+ }
+
/* Links between nodes. */
/* -------------------- */
/* Each node in the FrameSet (except the first) has a link to another
@@ -10942,6 +12224,7 @@ AstFrameSet *astInitFrameSet_( void *mem, size_t size, int init,
/* Allocate memory for the arrays of Frame information. */
new->frame = astMalloc( sizeof( AstFrame * ) );
new->node = astMalloc( sizeof( int ) );
+ new->varfrm = astMalloc( sizeof( int ) );
/* The node arrays are not required until at least two Frames are
present. */
@@ -10954,6 +12237,7 @@ AstFrameSet *astInitFrameSet_( void *mem, size_t size, int init,
if ( astOK ) {
new->frame[ 0 ] = astClone( frame );
new->node[ 0 ] = 0;
+ new->varfrm[ 0 ] = 0;
new->nframe = 1;
new->nnode = 1;
@@ -10978,6 +12262,8 @@ AstFrameSet *astInitFrameSet_( void *mem, size_t size, int init,
new->frame = astMalloc( sizeof( AstFrame * ) * (size_t) old->nframe );
new->node = astStore( NULL, old->node,
sizeof( int ) * (size_t) old->nframe );
+ new->varfrm = astStore( NULL, old->varfrm,
+ sizeof( int ) * (size_t) old->nframe );
new->map = astMalloc( sizeof( AstMapping * ) *
(size_t) ( old->nnode - 1 ) );
new->link = astStore( NULL, old->link,
@@ -11014,6 +12300,7 @@ AstFrameSet *astInitFrameSet_( void *mem, size_t size, int init,
if ( !astOK ) {
new->frame = astFree( new->frame );
new->node = astFree( new->node );
+ new->varfrm = astFree( new->varfrm );
new->map = astFree( new->map );
new->link = astFree( new->link );
new->invert = astFree( new->invert );
@@ -11174,85 +12461,92 @@ AstFrameSet *astLoadFrameSet_( void *mem, size_t size,
/* Nframe. */
/* ------- */
- new->nframe = astReadInt( channel, "nframe", 1 );
- if ( new->nframe < 0 ) new->nframe = 1;
+ new->nframe = astReadInt( channel, "nframe", 1 );
+ if ( new->nframe < 0 ) new->nframe = 1;
/* Number of nodes. */
/* ---------------- */
- new->nnode = astReadInt( channel, "nnode", new->nframe );
- if ( new->nnode < 1 ) new->nnode = 1;
+ new->nnode = astReadInt( channel, "nnode", new->nframe );
+ if ( new->nnode < 1 ) new->nnode = 1;
/* Allocate memory to hold Frame and node information. */
- new->frame = astMalloc( sizeof( AstFrame *) * (size_t) new->nframe );
- new->node = astMalloc( sizeof( int ) * (size_t) new->nframe );
- new->link = astMalloc( sizeof( int ) * (size_t) ( new->nnode - 1 ) );
- new->invert = astMalloc( sizeof( int ) * (size_t) ( new->nnode - 1 ) );
- new->map = astMalloc( sizeof( AstMapping * ) *
- (size_t) ( new->nnode - 1 ) );
+ new->frame = astMalloc( sizeof( AstFrame *) * (size_t) new->nframe );
+ new->node = astMalloc( sizeof( int ) * (size_t) new->nframe );
+ new->varfrm = astMalloc( sizeof( int ) * (size_t) new->nframe );
+ new->link = astMalloc( sizeof( int ) * (size_t) ( new->nnode - 1 ) );
+ new->invert = astMalloc( sizeof( int ) * (size_t) ( new->nnode - 1 ) );
+ new->map = astMalloc( sizeof( AstMapping * ) *
+ (size_t) ( new->nnode - 1 ) );
/* If an error occurs, ensure that all allocated memory is freed. */
- if ( !astOK ) {
- new->frame = astFree( new->frame );
- new->node = astFree( new->node );
- new->link = astFree( new->link );
- new->invert = astFree( new->invert );
- new->map = astFree( new->map );
+ if ( !astOK ) {
+ new->frame = astFree( new->frame );
+ new->node = astFree( new->node );
+ new->varfrm = astFree( new->varfrm );
+ new->link = astFree( new->link );
+ new->invert = astFree( new->invert );
+ new->map = astFree( new->map );
/* Otherwise, initialise the arrays which will hold Object pointers. */
- } else {
- for ( ifr = 1; ifr <= new->nframe; ifr++ ) {
- new->frame[ ifr - 1 ] = NULL;
- }
- for ( inode = 1; inode < new->nnode; inode++ ) {
- new->map[ inode - 1 ] = NULL;
- }
+ } else {
+ for ( ifr = 1; ifr <= new->nframe; ifr++ ) {
+ new->frame[ ifr - 1 ] = NULL;
+ }
+ for ( inode = 1; inode < new->nnode; inode++ ) {
+ new->map[ inode - 1 ] = NULL;
+ }
/* Read Frame data... */
- for ( ifr = 1; ifr <= new->nframe; ifr++ ) {
+ for ( ifr = 1; ifr <= new->nframe; ifr++ ) {
/* Frame objects. */
/* -------------- */
/* Create the required keyword and then read the Frame. */
- (void) sprintf( key, "frm%d", ifr );
- new->frame[ ifr - 1 ] = astReadObject( channel, key, NULL );
+ (void) sprintf( key, "frm%d", ifr );
+ new->frame[ ifr - 1 ] = astReadObject( channel, key, NULL );
/* Node index for each Frame. */
/* -------------------------- */
- (void) sprintf( key, "nod%d", ifr );
- new->node[ ifr - 1 ] = astReadInt( channel, key, ifr ) - 1;
- }
+ (void) sprintf( key, "nod%d", ifr );
+ new->node[ ifr - 1 ] = astReadInt( channel, key, ifr ) - 1;
+
+/* Index of variants Frame. */
+/* ------------------------ */
+ (void) sprintf( key, "vfr%d", ifr );
+ new->varfrm[ ifr - 1 ] = astReadInt( channel, key, 0 );
+ }
/* Read node data... */
- for ( inode = 1; inode < new->nnode; inode++ ) {
+ for ( inode = 1; inode < new->nnode; inode++ ) {
/* Links between nodes. */
/* -------------------- */
- (void) sprintf( key, "lnk%d", inode + 1 );
- new->link[ inode - 1 ] = astReadInt( channel, key, 0 ) - 1;
+ (void) sprintf( key, "lnk%d", inode + 1 );
+ new->link[ inode - 1 ] = astReadInt( channel, key, 0 ) - 1;
/* Inversion flags. */
/* ---------------- */
- (void) sprintf( key, "inv%d", inode + 1 );
- new->invert[ inode - 1 ] = astReadInt( channel, key, 0 );
+ (void) sprintf( key, "inv%d", inode + 1 );
+ new->invert[ inode - 1 ] = astReadInt( channel, key, 0 );
/* Mapping objects. */
/* ---------------- */
- (void) sprintf( key, "map%d", inode + 1 );
- new->map[ inode - 1 ] = astReadObject( channel, key, NULL );
- }
+ (void) sprintf( key, "map%d", inode + 1 );
+ new->map[ inode - 1 ] = astReadObject( channel, key, NULL );
+ }
/* Read remaining data... */
/* Base. */
/* ----- */
- new->base = astReadInt( channel, "base", -INT_MAX );
- if ( new->base < 1 ) new->base = -INT_MAX;
+ new->base = astReadInt( channel, "base", -INT_MAX );
+ if ( new->base < 1 ) new->base = -INT_MAX;
/* Current. */
/* -------- */
- new->current = astReadInt( channel, "currnt", -INT_MAX );
- if ( new->base < 1 ) new->base = -INT_MAX;
- }
+ new->current = astReadInt( channel, "currnt", -INT_MAX );
+ if ( new->base < 1 ) new->base = -INT_MAX;
+ }
/* If an error occurred, clean up by deleting the new FrameSet. */
if ( !astOK ) new = astDelete( new );
@@ -11289,6 +12583,10 @@ void astClearCurrent_( AstFrameSet *this, int *status ) {
if ( !astOK ) return;
(**astMEMBER(this,FrameSet,ClearCurrent))( this, status );
}
+void astClearVariant_( AstFrameSet *this, int *status ) {
+ if ( !astOK ) return;
+ (**astMEMBER(this,FrameSet,ClearVariant))( this, status );
+}
int astGetBase_( AstFrameSet *this, int *status ) {
if ( !astOK ) return 0;
return (**astMEMBER(this,FrameSet,GetBase))( this, status );
@@ -11297,6 +12595,10 @@ int astGetCurrent_( AstFrameSet *this, int *status ) {
if ( !astOK ) return 0;
return (**astMEMBER(this,FrameSet,GetCurrent))( this, status );
}
+const char *astGetVariant_( AstFrameSet *this, int *status ) {
+ if ( !astOK ) return NULL;
+ return (**astMEMBER(this,FrameSet,GetVariant))( this, status );
+}
AstFrame *astGetFrame_( AstFrameSet *this, int iframe, int *status ) {
if ( !astOK ) return NULL;
return (**astMEMBER(this,FrameSet,GetFrame))( this, iframe, status );
@@ -11313,6 +12615,14 @@ void astRemapFrame_( AstFrameSet *this, int iframe, AstMapping *map, int *status
if ( !astOK ) return;
(**astMEMBER(this,FrameSet,RemapFrame))( this, iframe, map, status );
}
+void astAddVariant_( AstFrameSet *this, AstMapping *map, const char *name, int *status ) {
+ if ( !astOK ) return;
+ (**astMEMBER(this,FrameSet,AddVariant))( this, map, name, status );
+}
+void astMirrorVariants_( AstFrameSet *this, int iframe, int *status ) {
+ if ( !astOK ) return;
+ (**astMEMBER(this,FrameSet,MirrorVariants))( this, iframe, status );
+}
void astRemoveFrame_( AstFrameSet *this, int iframe, int *status ) {
if ( !astOK ) return;
(**astMEMBER(this,FrameSet,RemoveFrame))( this, iframe, status );
@@ -11325,6 +12635,10 @@ void astSetCurrent_( AstFrameSet *this, int icurrent, int *status ) {
if ( !astOK ) return;
(**astMEMBER(this,FrameSet,SetCurrent))( this, icurrent, status );
}
+void astSetVariant_( AstFrameSet *this, const char *variant, int *status ) {
+ if ( !astOK ) return;
+ (**astMEMBER(this,FrameSet,SetVariant))( this, variant, status );
+}
int astTestBase_( AstFrameSet *this, int *status ) {
if ( !astOK ) return 0;
return (**astMEMBER(this,FrameSet,TestBase))( this, status );
@@ -11333,12 +12647,20 @@ int astTestCurrent_( AstFrameSet *this, int *status ) {
if ( !astOK ) return 0;
return (**astMEMBER(this,FrameSet,TestCurrent))( this, status );
}
+int astTestVariant_( AstFrameSet *this, int *status ) {
+ if ( !astOK ) return 0;
+ return (**astMEMBER(this,FrameSet,TestVariant))( this, status );
+}
int astValidateFrameIndex_( AstFrameSet *this, int iframe,
const char *method, int *status ) {
if ( !astOK ) return 0;
return (**astMEMBER(this,FrameSet,ValidateFrameIndex))( this, iframe,
method, status );
}
+const char *astGetAllVariants_( AstFrameSet *this, int *status ) {
+ if ( !astOK ) return NULL;
+ return (**astMEMBER(this,FrameSet,GetAllVariants))( this, status );
+}
/* Special public interface functions. */
/* =================================== */
diff --git a/frameset.h b/frameset.h
index b8cacb5..5063956 100644
--- a/frameset.h
+++ b/frameset.h
@@ -463,6 +463,8 @@
#define AST__CURRENT (-1) /* Identify current Frame */
#define AST__NOFRAME (-99) /* An invalid Frame index */
#define AST__ALLFRAMES (-199) /* A value representing all Frames */
+#define AST__FRAMESET_GETALLVARIANTS_BUFF_LEN 200 /* Length for AllVariants buffer */
+#define AST__FRAMESET_GETATTRIB_BUFF_LEN 200 /* Length for GetAtribb buffer */
/* Type Definitions. */
/* ================= */
@@ -478,6 +480,7 @@ typedef struct AstFrameSet {
/* Attributes specific to objects in this class. */
AstFrame **frame; /* Array of Frame pointers */
AstMapping **map; /* Array of Mapping pointers */
+ int *varfrm; /* Array of variants Frames indicies */
int *invert; /* Array of Mapping Invert values */
int *link; /* Parent node index for each node */
int *node; /* Index of node associated with Frame */
@@ -510,12 +513,19 @@ typedef struct AstFrameSetVtab {
int (* TestCurrent)( AstFrameSet *, int * );
int (* ValidateFrameIndex)( AstFrameSet *, int, const char *, int * );
void (* AddFrame)( AstFrameSet *, int, AstMapping *, AstFrame *, int * );
+ void (* AddVariant)( AstFrameSet *, AstMapping *, const char *, int * );
+ void (* MirrorVariants)( AstFrameSet *, int, int * );
void (* ClearBase)( AstFrameSet *, int * );
void (* ClearCurrent)( AstFrameSet *, int * );
void (* RemapFrame)( AstFrameSet *, int, AstMapping *, int * );
void (* RemoveFrame)( AstFrameSet *, int, int * );
void (* SetBase)( AstFrameSet *, int, int * );
void (* SetCurrent)( AstFrameSet *, int, int * );
+ void (* ClearVariant)( AstFrameSet *, int * );
+ const char *(* GetVariant)( AstFrameSet *, int * );
+ void (* SetVariant)( AstFrameSet *, const char *, int * );
+ int (* TestVariant)( AstFrameSet *, int * );
+ const char *(* GetAllVariants)( AstFrameSet *, int * );
} AstFrameSetVtab;
#if defined(THREAD_SAFE)
@@ -525,7 +535,8 @@ typedef struct AstFrameSetVtab {
typedef struct AstFrameSetGlobals {
AstFrameSetVtab Class_Vtab;
int Class_Init;
- char GetAttrib_Buff[ 51 ];
+ char GetAttrib_Buff[ AST__FRAMESET_GETATTRIB_BUFF_LEN + 1 ];
+ char GetAllVariants_Buff[ AST__FRAMESET_GETALLVARIANTS_BUFF_LEN + 1 ];
AstFrame *Integrity_Frame;
const char *Integrity_Method;
int Integrity_Lost;
@@ -574,10 +585,13 @@ void astInitFrameSetGlobals_( AstFrameSetGlobals * );
AstFrame *astGetFrame_( AstFrameSet *, int, int * );
AstMapping *astGetMapping_( AstFrameSet *, int, int, int * );
void astAddFrame_( AstFrameSet *, int , AstMapping *, AstFrame *, int * );
+void astAddVariant_( AstFrameSet *, AstMapping *, const char *, int * );
+void astMirrorVariants_( AstFrameSet *, int, int * );
void astRemapFrame_( AstFrameSet *, int, AstMapping *, int * );
void astRemoveFrame_( AstFrameSet *, int, int * );
#if defined(astCLASS) /* Protected */
+const char *astGetAllVariants_( AstFrameSet *, int * );
int astGetBase_( AstFrameSet *, int * );
int astGetCurrent_( AstFrameSet *, int * );
int astGetNframe_( AstFrameSet *, int * );
@@ -588,6 +602,10 @@ void astClearBase_( AstFrameSet *, int * );
void astClearCurrent_( AstFrameSet *, int * );
void astSetBase_( AstFrameSet *, int, int * );
void astSetCurrent_( AstFrameSet *, int, int * );
+void astClearVariant_( AstFrameSet *, int * );
+const char *astGetVariant_( AstFrameSet *, int * );
+void astSetVariant_( AstFrameSet *, const char *, int * );
+int astTestVariant_( AstFrameSet *, int * );
#endif
/* Function interfaces. */
@@ -636,6 +654,10 @@ astINVOKE(O,astLoadFrameSet_(mem,size,vtab,name,astCheckChannel(channel),STATUS_
of object is supplied. */
#define astAddFrame(this,iframe,map,frame) \
astINVOKE(V,astAddFrame_(astCheckFrameSet(this),iframe,(((iframe)!=AST__ALLFRAMES)?astCheckMapping(map):NULL),astCheckFrame(frame),STATUS_PTR))
+#define astAddVariant(this,map,name) \
+astINVOKE(V,astAddVariant_(astCheckFrameSet(this),map?astCheckMapping(map):NULL,name,STATUS_PTR))
+#define astMirrorVariants(this,iframe) \
+astINVOKE(V,astMirrorVariants_(astCheckFrameSet(this),iframe,STATUS_PTR))
#define astGetFrame(this,iframe) \
astINVOKE(O,astGetFrame_(astCheckFrameSet(this),iframe,STATUS_PTR))
#define astGetMapping(this,iframe1,iframe2) \
@@ -668,6 +690,16 @@ astINVOKE(V,astTestBase_(astCheckFrameSet(this),STATUS_PTR))
astINVOKE(V,astTestCurrent_(astCheckFrameSet(this),STATUS_PTR))
#define astValidateFrameIndex(this,iframe,method) \
astINVOKE(V,astValidateFrameIndex_(astCheckFrameSet(this),iframe,method,STATUS_PTR))
+#define astClearVariant(this) \
+astINVOKE(V,astClearVariant_(astCheckFrameSet(this),STATUS_PTR))
+#define astGetVariant(this) \
+astINVOKE(V,astGetVariant_(astCheckFrameSet(this),STATUS_PTR))
+#define astSetVariant(this,variant) \
+astINVOKE(V,astSetVariant_(astCheckFrameSet(this),variant,STATUS_PTR))
+#define astTestVariant(this) \
+astINVOKE(V,astTestVariant_(astCheckFrameSet(this),STATUS_PTR))
+#define astGetAllVariants(this) \
+astINVOKE(V,astGetAllVariants_(astCheckFrameSet(this),STATUS_PTR))
#endif
#endif
diff --git a/mapping.c b/mapping.c
index e629789..719dc06 100644
--- a/mapping.c
+++ b/mapping.c
@@ -341,6 +341,23 @@ f - AST_TRANN: Transform N-dimensional coordinates
* 16-OCT-2012 (DSB):
* In MatrixDet, ignore rows/columns filled with AST_BAD as well as
* rows/columns filled with zeros.
+* 26-APR-2013 (DSB):
+* Change the "nused" parameter of astRebinSeq<X> from "int *" to
+* "size_t *" to allow greater amounts of data to be pasted into
+* the output array.
+* 29-APR-2013 (DSB):
+* No sot simplify Mappings that have a set value for their Ident
+* attribute. If an Ident value has been set then it means that we
+* should be trying to preserve the identify of the Mapping. This
+* is implemented via a new protected method (astDoNotSimplify) which
+* is overridden by the Frame class so that this restriction applies
+* only to genuine Mappings, not Frames.
+* 9-MAY-2013 (DSB):
+* Change the "nused" parameter of astRebinSeq<X> from "size_t *" to
+* "int64_t *" to cater for systems where "size_t" is only 32 bits long.
+* 20-MAY-2013 (DSB):
+* Always perform a linear fit in RebinAdaptively if flux
+* conservation is requested.
*class--
*/
@@ -392,6 +409,7 @@ f - AST_TRANN: Transform N-dimensional coordinates
#include <limits.h>
#include <math.h>
#include <stdio.h>
+#include <stdint.h>
#include <stdlib.h>
#include <string.h>
@@ -576,24 +594,24 @@ static void RebinSeq##X( AstMapping *, double, int, const int [], const int [],
const Xtype [], const Xtype [], int, const double [], \
int, double, int, Xtype, int, const int [], \
const int [], const int [], const int [], Xtype [], \
- Xtype [], double [], int *, int * ); \
+ Xtype [], double [], int64_t *, int * ); \
\
static void SpreadKernel1##X( AstMapping *, int, const int *, const int *, \
const Xtype *, const Xtype *, double, int, const int *, \
const double *const *, \
void (*)( double, const double *, int, double *, int * ), \
int, const double *, int, Xtype, int, Xtype *, \
- Xtype *, double *, int *, int * ); \
+ Xtype *, double *, int64_t *, int * ); \
\
static void SpreadLinear##X( int, const int *, const int *, const Xtype *, \
const Xtype *, double, int, const int *, const double *const *, \
- int, Xtype, int, Xtype *, Xtype *, double *, int *, \
+ int, Xtype, int, Xtype *, Xtype *, double *, int64_t *, \
int * ); \
\
static void SpreadNearest##X( int, const int *, const int *, const Xtype *, \
const Xtype *, double, int, const int *, const double *const *, \
int, Xtype, int, Xtype *, Xtype *, double *, \
- int *, int * );
+ int64_t *, int * );
DECLARE_GENERIC(D,double)
DECLARE_GENERIC(F,float)
@@ -639,9 +657,10 @@ static int MapList( AstMapping *, int, int, int *, AstMapping ***, int **, int *
static int MapMerge( AstMapping *, int, int, int *, AstMapping ***, int **, int * );
static int MaxI( int, int, int * );
static int MinI( int, int, int * );
+static int DoNotSimplify( AstMapping *, int * );
static int QuadApprox( AstMapping *, const double[2], const double[2], int, int, double *, double *, int * );
-static int RebinAdaptively( AstMapping *, int, const int *, const int *, const void *, const void *, DataType, int, const double *, int, double, int, const void *, int, const int *, const int *, const int *, const int *, int, void *, void *, double *, int *, int * );
-static int RebinWithBlocking( AstMapping *, const double *, int, const int *, const int *, const void *, const void *, DataType, int, const double *, int, const void *, int, const int *, const int *, const int *, const int *, int, void *, void *, double *, int *, int * );
+static int RebinAdaptively( AstMapping *, int, const int *, const int *, const void *, const void *, DataType, int, const double *, int, double, int, const void *, int, const int *, const int *, const int *, const int *, int, void *, void *, double *, int64_t *, int * );
+static int RebinWithBlocking( AstMapping *, const double *, int, const int *, const int *, const void *, const void *, DataType, int, const double *, int, const void *, int, const int *, const int *, const int *, const int *, int, void *, void *, double *, int64_t *, int * );
static int ResampleAdaptively( AstMapping *, int, const int *, const int *, const void *, const void *, DataType, int, void (*)( void ), const double *, int, double, int, const void *, int, const int *, const int *, const int *, const int *, void *, void *, int * );
static int ResampleSection( AstMapping *, const double *, int, const int *, const int *, const void *, const void *, DataType, int, void (*)( void ), const double *, double, int, const void *, int, const int *, const int *, const int *, const int *, void *, void *, int * );
static int ResampleWithBlocking( AstMapping *, const double *, int, const int *, const int *, const void *, const void *, DataType, int, void (*)( void ), const double *, int, const void *, int, const int *, const int *, const int *, const int *, void *, void *, int * );
@@ -661,7 +680,7 @@ static void GlobalBounds( MapData *, double *, double *, double [], double [], i
static void Invert( AstMapping *, int * );
static void MapBox( AstMapping *, const double [], const double [], int, int, double *, double *, double [], double [], int * );
static void RateFun( AstMapping *, double *, int, int, int, double *, double *, int * );
-static void RebinSection( AstMapping *, const double *, int, const int *, const int *, const void *, const void *, double, DataType, int, const double *, int, const void *, int, const int *, const int *, const int *, const int *, int, void *, void *, double *, int *, int * );
+static void RebinSection( AstMapping *, const double *, int, const int *, const int *, const void *, const void *, double, DataType, int, const double *, int, const void *, int, const int *, const int *, const int *, const int *, int, void *, void *, double *, int64_t *, int * );
static void ReportPoints( AstMapping *, int, AstPointSet *, AstPointSet *, int * );
static void SetAttrib( AstObject *, const char *, int * );
static void SetInvert( AstMapping *, int, int * );
@@ -972,6 +991,53 @@ static void Decompose( AstMapping *this, AstMapping **map1, AstMapping **map2,
if( invert2 ) *invert2 = 0;
}
+static int DoNotSimplify( AstMapping *this, int *status ) {
+/*
+*+
+* Name:
+* astMapMerge
+
+* Purpose:
+* Check if a Mapping is appropriate for simplification.
+
+* Type:
+* Protected virtual function.
+
+* Synopsis:
+* #include "mapping.h"
+* int astDoNotSImplify( AstMapping *this );
+
+* Class Membership:
+* Mapping method.
+
+* Description:
+* This function returns a flag indivating if the supplied Mapping is
+* appropriate for simplification.
+
+* Parameters:
+* this
+* Pointer to the Mapping.
+
+* Returned Value:
+* Non-zero if the supplied Mapping is not appropriate for
+* simplification, and zero otherwise.
+
+* Notes:
+* - A value of 0 will be returned if this function is invoked
+* with the global error status set, or if it should fail for any
+* reason.
+*-
+*/
+
+/* Check inherited status. */
+ if( !astOK ) return 0;
+
+/* Mappings that have a set value for the Ident attribute should not be
+ simplified since we want to preserve their individual identify (otherwise
+ why would the user have given them an Ident value?). */
+ return astTestIdent( this );
+}
+
int astRateState_( int disabled, int *status ) {
/*
*+
@@ -2421,6 +2487,7 @@ VTAB_GENERIC(LD)
vtab->ClearInvert = ClearInvert;
vtab->ClearReport = ClearReport;
vtab->Decompose = Decompose;
+ vtab->DoNotSimplify = DoNotSimplify;
vtab->GetInvert = GetInvert;
vtab->GetIsLinear = GetIsLinear;
vtab->GetIsSimple = GetIsSimple;
@@ -8927,6 +8994,9 @@ static double Rate( AstMapping *this, double *at, int ax1, int ax2,
}
}
+/* Free resources */
+ RateFun( NULL, NULL, -2, 0, 0, NULL, NULL, status );
+
/* Return the result. */
return ret;
@@ -9937,7 +10007,7 @@ static int RebinAdaptively( AstMapping *this, int ndim_in,
const int *ubnd_out, const int *lbnd,
const int *ubnd, int npix_out,
void *out, void *out_var, double *work,
- int *nused, int *status ){
+ int64_t *nused, int *status ){
/*
* Name:
* RebinAdaptively
@@ -9959,7 +10029,7 @@ static int RebinAdaptively( AstMapping *this, int ndim_in,
* int ndim_out, const int *lbnd_out,
* const int *ubnd_out, const int *lbnd,
* const int *ubnd, int npix_out, void *out,
-* void *out_var, double *work, int *nused,
+* void *out_var, double *work, int64_t *nused,
* int *status )
* Class Membership:
@@ -10146,7 +10216,7 @@ static int RebinAdaptively( AstMapping *this, int ndim_in,
* If no accumulated weights are required, a NULL pointer should be
* given.
* nused
-* An optional pointer to an int which will be incremented by the
+* An optional pointer to a int64_t which will be incremented by the
* number of input values pasted into the output array. Ignored if NULL.
* status
* Pointer to the inherited status variable.
@@ -10173,6 +10243,7 @@ static int RebinAdaptively( AstMapping *this, int ndim_in,
int i; /* Loop count */
int isLinear; /* Is the transformation linear? */
int mxdim; /* Largest output section dimension size */
+ int need_fit; /* Do we need to perform a linear fit? */
int npix; /* Number of pixels in output section */
int npoint; /* Number of points for obtaining a fit */
int nvertex; /* Number of vertices of output section */
@@ -10227,10 +10298,13 @@ static int RebinAdaptively( AstMapping *this, int ndim_in,
user-supplied scale factor. */
toobig = ( maxpix < mxdim );
-/* Assume the Mapping is significantly non-linear before deciding
- whether to sub-divide the output section. */
+/* Indicate we do not yet have a linear fit. */
linear_fit = NULL;
+/* Initialise a flag indicating if we need to perform a linear fit. This
+ is always the case if flux conservation was requested. */
+ need_fit = ( flags & AST__CONSERVEFLUX );
+
/* If the output section is too small to be worth obtaining a linear
fit, or if the accuracy tolerance is zero, we will not
sub-divide. This means that the Mapping will be used to transform
@@ -10247,12 +10321,18 @@ static int RebinAdaptively( AstMapping *this, int ndim_in,
} else if ( toobig ) {
divide = 1;
-/* If neither of the above apply, then attempt to fit a linear
- approximation to the Mapping's forward transformation over the
- range of coordinates covered by the input section. We need to
- temporarily copy the integer bounds into floating point arrays to
- use astLinearApprox. */
+/* If neither of the above apply, we need to do a fiot regardless of
+ whether flux conservation was requested or not. Whether we divide or
+ not will depend on whether the Mapping is linear or not. */
} else {
+ need_fit = 1;
+ }
+
+/* If required, attempt to fit a linear approximation to the Mapping's
+ forward transformation over the range of coordinates covered by the
+ input section. We need to temporarily copy the integer bounds into
+ floating point arrays to use astLinearApprox. */
+ if( need_fit ) {
/* Allocate memory for floating point bounds and for the coefficient array */
flbnd = astMalloc( sizeof( double )*(size_t) ndim_in );
@@ -10374,7 +10454,7 @@ static void RebinSection( AstMapping *this, const double *linear_fit,
const int *lbnd_out, const int *ubnd_out,
const int *lbnd, const int *ubnd, int npix_out,
void *out, void *out_var, double *work,
- int *nused, int *status ) {
+ int64_t *nused, int *status ) {
/*
* Name:
* RebinSection
@@ -10395,7 +10475,7 @@ static void RebinSection( AstMapping *this, const double *linear_fit,
* const int *lbnd_out, const int *ubnd_out,
* const int *lbnd, const int *ubnd, int npix_out,
* void *out, void *out_var, double *work,
-* int *nused, int *status )
+* int64_t *nused, int *status )
* Class Membership:
* Mapping member function.
@@ -10550,7 +10630,7 @@ static void RebinSection( AstMapping *this, const double *linear_fit,
* If no accumulated weights are required, a NULL pointer should be
* given.
* nused
-* An optional pointer to an int which will be incremented by the
+* An optional pointer to a int64_t which will be incremented by the
* number of input values pasted into the output array. Ignored if NULL.
* Notes:
@@ -11293,7 +11373,7 @@ c double tol, int maxpix, <Xtype> badval,
c int ndim_out, const int lbnd_out[],
c const int ubnd_out[], const int lbnd[],
c const int ubnd[], <Xtype> out[], <Xtype> out_var[],
-c double weights[], int *nused );
+c double weights[], int64_t *nused );
f CALL AST_REBINSEQ<X>( THIS, WLIM, NDIM_IN, LBND_IN, UBND_IN, IN, IN_VAR,
f SPREAD, PARAMS, FLAGS, TOL, MAXPIX, BADVAL,
f NDIM_OUT, LBND_OUT, UBND_OUT, LBND, UBND, OUT,
@@ -11675,8 +11755,8 @@ f FLAGS parameter.
c (i.e. Fortran array indexing is used).
f (i.e. normal Fortran array storage order).
c nused
-f NUSED = INTEGER (Given and Returned)
-c A pointer to an int containing the
+f NUSED = INTEGER*8 (Given and Returned)
+c A pointer to an int64_t containing the
f The
* number of input data values that have been added into the output
* array so far. The supplied value is incremented on exit by the
@@ -11872,7 +11952,7 @@ static void RebinSeq##X( AstMapping *this, double wlim, int ndim_in, \
int ndim_out, const int lbnd_out[], \
const int ubnd_out[], const int lbnd[], \
const int ubnd[], Xtype out[], Xtype out_var[], \
- double weights[], int *nused, int *status ) { \
+ double weights[], int64_t *nused, int *status ) { \
\
/* Local Variables: */ \
AstMapping *simple; /* Pointer to simplified Mapping */ \
@@ -12209,8 +12289,14 @@ static void RebinSeq##X( AstMapping *this, double wlim, int ndim_in, \
\
/* If the sum of the squared weights is not available, compare the weight \
for this output pixel with the mean weight per input pixel. */ \
- } else { \
+ } else if( mwpip != AST__BAD ){ \
neff = wgt/mwpip; \
+\
+ } else if( astOK ) { \
+ astError( AST__BADIN, "astRebinSeq"#X"(%s): The rebinned data " \
+ "cannot be normalised - a bad value (%zu) has been " \
+ "supplied for 'nused' (programming error).", \
+ status, astGetClass( this ), *nused ); \
} \
\
/* Assign bad values to unused output pixels. */ \
@@ -12275,7 +12361,7 @@ static int RebinWithBlocking( AstMapping *this, const double *linear_fit,
const int *lbnd_out, const int *ubnd_out,
const int *lbnd, const int *ubnd, int npix_out,
void *out, void *out_var, double *work,
- int *nused, int *status ) {
+ int64_t *nused, int *status ) {
/*
* Name:
* RebinWithBlocking
@@ -12297,7 +12383,7 @@ static int RebinWithBlocking( AstMapping *this, const double *linear_fit,
* const int *lbnd_out, const int *ubnd_out,
* const int *lbnd, const int *ubnd, int npix_out,
* void *out, void *out_var, double *work,
-* int *nused, int *status )
+* int64_t *nused, int *status )
* Class Membership:
* Mapping member function.
@@ -12456,7 +12542,7 @@ static int RebinWithBlocking( AstMapping *this, const double *linear_fit,
* If no accumulated weights are required, a NULL pointer should be
* given.
* nused
-* An optional pointer to an int which will be incremented by the
+* An optional pointer to a int64_t which will be incremented by the
* number of input values pasted into the output array. Ignored if NULL.
* Returned Value:
@@ -16267,6 +16353,10 @@ f AST_SIMPLIFY = INTEGER
* inter-Frame Mappings have been simplified.
* Notes:
+* - Mappings that have a set value for their Ident attribute are
+* left unchanged after simplification. This is so that their
+* individual identity is preserved. This restriction does not
+* apply to the simplification of Frames.
* - This function can safely be applied even to Mappings which
* cannot be simplified. If no simplification is possible, it
c behaves exactly like astClone and returns a pointer to the
@@ -16849,7 +16939,7 @@ static int SpecialBounds( const MapData *mapdata, double *lbnd, double *ubnd,
* double *, int * ),
* int neighb, const double *params, int flags,
* <Xtype> badval, int npix_out, <Xtype> *out,
-* <Xtype> *out_var, double *work, int *nused,
+* <Xtype> *out_var, double *work, int64_t *nused,
* int *status )
* Class Membership:
@@ -17000,7 +17090,7 @@ static int SpecialBounds( const MapData *mapdata, double *lbnd, double *ubnd,
* array are incremented on exit by the sum of the weights used
* with each output pixel.
* nused
-* An optional pointer to an int which will be incremented by the
+* An optional pointer to a int64_t which will be incremented by the
* number of input values pasted into the output array. Ignored if NULL.
* Notes:
@@ -17021,7 +17111,7 @@ static void SpreadKernel1##X( AstMapping *this, int ndim_out, \
int neighb, const double *params, \
int flags, Xtype badval, int npix_out, \
Xtype *out, Xtype *out_var, double *work, \
- int *nused, int *status ) { \
+ int64_t *nused, int *status ) { \
\
/* Local Variables: */ \
astDECLARE_GLOBALS /* Thread-specific data */ \
@@ -18093,7 +18183,7 @@ MAKE_SPREAD_KERNEL1(I,int,1)
* double infac, int npoint, const int *offset,
* const double *const *coords, int flags,
* <Xtype> badval, int npix_out, <Xtype> *out,
-* <Xtype> *out_var, double *work, int *nused )
+* <Xtype> *out_var, double *work, int64_t *nused )
* Class Membership:
* Mapping member function.
@@ -18221,7 +18311,7 @@ MAKE_SPREAD_KERNEL1(I,int,1)
* If no accumulated weights are required, a NULL pointer should be
* given.
* nused
-* An optional pointer to an int which will be incremented by the
+* An optional pointer to a int64_t which will be incremented by the
* number of input values pasted into the output array. Ignored if NULL.
* Notes:
@@ -18238,7 +18328,8 @@ static void SpreadLinear##X( int ndim_out, \
double infac, int npoint, const int *offset, \
const double *const *coords, int flags, \
Xtype badval, int npix_out, Xtype *out, \
- Xtype *out_var, double *work, int *nused, int *status ) { \
+ Xtype *out_var, double *work, int64_t *nused, \
+ int *status ) { \
\
/* Local Variables: */ \
Xtype c; /* Contribution to output value */ \
@@ -18928,7 +19019,7 @@ MAKE_SPREAD_LINEAR(I,int,1)
* const <Xtype> *in_var, double infac, int npoint,
* const int *offset, const double *const *coords,
* int flags, <Xtype> badval, int npix_out, <Xtype> *out,
-* <Xtype> *out_var, double *work, int *nused,
+* <Xtype> *out_var, double *work, int64_t *nused,
* int *status )
* Class Membership:
@@ -19060,7 +19151,7 @@ MAKE_SPREAD_LINEAR(I,int,1)
* array are incremented on exit by the sum of the weights used
* with each output pixel.
* nused
-* An optional pointer to an int which will be incremented by the
+* An optional pointer to a size_t which will be incremented by the
* number of input values pasted into the output array. Ignored if NULL.
* Notes:
@@ -19076,7 +19167,8 @@ static void SpreadNearest##X( int ndim_out, \
double infac, int npoint, const int *offset, \
const double *const *coords, int flags, \
Xtype badval, int npix_out, Xtype *out, \
- Xtype *out_var, double *work, int *nused, int *status ) { \
+ Xtype *out_var, double *work, int64_t *nused, \
+ int *status ) { \
\
/* Local Variables: */ \
Xtype c; /* Contribution to output value */ \
@@ -23532,10 +23624,15 @@ int *astMapSplit_( AstMapping *this, int nin, const int *in, AstMapping **map,
}
int astMapMerge_( AstMapping *this, int where, int series, int *nmap,
AstMapping ***map_list, int **invert_list, int *status ) {
- if ( !astOK ) return -1;
+
+ if ( !astOK || astDoNotSimplify( this ) ) return -1;
return (**astMEMBER(this,Mapping,MapMerge))( this, where, series, nmap,
map_list, invert_list, status );
}
+int astDoNotSimplify_( AstMapping *this, int *status ) {
+ if ( !astOK ) return 0;
+ return (**astMEMBER(this,Mapping,DoNotSimplify))( this, status );
+}
void astReportPoints_( AstMapping *this, int forward,
AstPointSet *in_points, AstPointSet *out_points, int *status ) {
if ( !astOK ) return;
@@ -23617,7 +23714,7 @@ void astRebinSeq##X##_( AstMapping *this, double wlim, int ndim_in, const int *l
int ndim_out, \
const int *lbnd_out, const int *ubnd_out, \
const int *lbnd, const int *ubnd, Xtype *out, \
- Xtype *out_var, double *weights, int *nused, \
+ Xtype *out_var, double *weights, int64_t *nused, \
int *status ) { \
if ( !astOK ) return; \
(**astMEMBER(this,Mapping,RebinSeq##X))( this, wlim, ndim_in, lbnd_in, \
@@ -23670,9 +23767,9 @@ AstMapping *astRemoveRegions_( AstMapping *this, int *status ) {
AstMapping *astSimplify_( AstMapping *this, int *status ) {
AstMapping *result;
if ( !astOK ) return NULL;
- if( !astGetIsSimple( this ) ) { /* Only simplify if not already done */
+ if( !astGetIsSimple( this ) && !astDoNotSimplify( this ) ) {
result = (**astMEMBER(this,Mapping,Simplify))( this, status );
- if( result ) result->issimple = 1;/* Indicate simplification has been done */
+ if( result ) result->issimple = 1; /* Indicate simplification has been done */
} else {
result = astClone( this );
}
diff --git a/mapping.h b/mapping.h
index 59f7a5b..e0f2609 100644
--- a/mapping.h
+++ b/mapping.h
@@ -330,6 +330,7 @@
/* C header files. */
/* --------------- */
#include <stddef.h>
+#include <stdint.h>
/* Macros. */
/* ======= */
@@ -443,6 +444,7 @@ typedef struct AstMappingVtab {
AstMapping *(* Simplify)( AstMapping *, int * );
AstPointSet *(* Transform)( AstMapping *, AstPointSet *, int, AstPointSet *, int * );
double (* Rate)( AstMapping *, double *, int, int, int * );
+ int (* DoNotSimplify)( AstMapping *, int * );
int (* GetInvert)( AstMapping *, int * );
int (* GetIsSimple)( AstMapping *, int * );
int (* GetNin)( AstMapping *, int * );
@@ -507,7 +509,7 @@ DECLARE_GENERIC_ALL(LD,long double)
const Xtype [], const Xtype [], int, const double [], \
int, double, int, Xtype, int, const int [], \
const int [], const int [], const int [], Xtype [], \
- Xtype [], double [], int *, int * );
+ Xtype [], double [], int64_t *, int * );
DECLARE_GENERIC_DFI(D,double)
DECLARE_GENERIC_DFI(F,float)
@@ -606,7 +608,7 @@ PROTO_GENERIC_ALL(LD,long double)
const Xtype [], const Xtype [], int, const double [], \
int, double, int, Xtype, int, const int [], \
const int [], const int [], const int [], Xtype [], \
- Xtype [], double [], int *, int * );
+ Xtype [], double [], int64_t *, int * );
PROTO_GENERIC_DFI(D,double)
PROTO_GENERIC_DFI(F,float)
@@ -652,6 +654,7 @@ int astGetReport_( AstMapping *, int * );
int astGetTranForward_( AstMapping *, int * );
int astGetTranInverse_( AstMapping *, int * );
int astGetIsLinear_( AstMapping *, int * );
+int astDoNotSimplify_( AstMapping *, int * );
int astMapMerge_( AstMapping *, int, int, int *, AstMapping ***, int **, int * );
int astTestInvert_( AstMapping *, int * );
int astTestReport_( AstMapping *, int * );
@@ -818,6 +821,8 @@ astINVOKE(V,astSetReport_(astCheckMapping(this),value,STATUS_PTR))
astINVOKE(V,astTestInvert_(astCheckMapping(this),STATUS_PTR))
#define astTestReport(this) \
astINVOKE(V,astTestReport_(astCheckMapping(this),STATUS_PTR))
+#define astDoNotSimplify(this) \
+astINVOKE(V,astDoNotSimplify_(astCheckMapping(this),STATUS_PTR))
/* Since a NULL PointSet pointer is acceptable here, we must omit the argument
checking in that case. (But unfortunately, "out" then gets evaluated
diff --git a/sun210.htx_tar b/sun210.htx_tar
index 378a13b..3a23824 100644
Binary files a/sun210.htx_tar and b/sun210.htx_tar differ
diff --git a/sun210.ps b/sun210.ps
index 39dc026..a65629f 100644
--- a/sun210.ps
+++ b/sun210.ps
@@ -1,8 +1,8 @@
%!PS-Adobe-2.0
%%Creator: dvips(k) 5.96.1 Copyright 2007 Radical Eye Software
%%Title: sun210.dvi
-%%CreationDate: Mon Apr 15 12:41:11 2013
-%%Pages: 619
+%%CreationDate: Thu May 30 12:03:20 2013
+%%Pages: 626
%%PageOrder: Ascend
%%BoundingBox: 0 0 595 842
%%DocumentFonts: CMR10 CMCSC10 CMBX10 CMR12 CMBX12 CMSL10 CMTT10 CMTI10
@@ -13,7 +13,7 @@
%DVIPSWebPage: (www.radicaleye.com)
%DVIPSCommandLine: dvips -f sun210
%DVIPSParameters: dpi=600
-%DVIPSSource: TeX output 2013.04.15:1241
+%DVIPSSource: TeX output 2013.05.30:1203
%%BeginProcSet: tex.pro 0 0
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -6153,8 +6153,8 @@ rf /Fw 131[112 1[50 59 59 81 59 62 44 44 46 1[62 56 62
61 75 60 75 65 6[82 102 102 139 102 103 94 75 100 101
92 101 105 128 81 105 1[50 105 106 85 88 103 97 96 102
7[67 67 67 67 67 67 67 67 67 67 67 37 45 3[52 52 27[75
-78 11[{}68 119.552 /CMBX12 rf /FB 169[122 30[81 4[81
-3[45 46[{}4 143.462 /CMBX12 rf /FC 134[123 3[129 90 92
+78 11[{}68 119.552 /CMBX12 rf /FB 169[122 30[81 3[81
+4[45 46[{}4 143.462 /CMBX12 rf /FC 134[123 3[129 90 92
95 2[116 129 194 65 2[65 1[116 71 106 129 1[129 113 9[240
175 1[162 129 2[159 3[140 3[182 183 146 2[168 1[175 23[90
90 65 39[{}30 206.559 /CMBX12 rf /FD 134[51 51 1[51 54
@@ -6187,11 +6187,11 @@ h(Appleton)h(Labora)-6 b(tor)g(y)1176 b FE(SUN/210.27)0
464 y FD(P)m(article)34 b(Ph)m(ysics)h(&)d(Astronom)m(y)i(Researc)m(h)g
(Council)0 577 y(Starlink)f(Pro)5 b(ject)0 690 y(Starlink)33
b(User)h(Note)e(210.27)2455 927 y FG(R.F.)f(W)-8 b(arren-Smith)31
-b(&)f(D.S.)h(Berry)3013 1040 y(7th)f(Decem)m(b)s(er)i(2012)p
+b(&)f(D.S.)h(Berry)3156 1040 y(29th)g(April)f(2013)p
0 1183 3780 12 v 1657 1504 a FC(AST)702 1754 y(A)78 b(Library)e(for)h
(Handling)520 2003 y(W)-19 b(orld)77 b(Co)6 b(ordinate)78
b(Systems)1192 2252 y(in)f(Astronom)-6 b(y)1726 2618
-y FB(V7.2)826 2931 y FC(Programmer's)76 b(Guide)999 3134
+y FB(V7.3)826 2931 y FC(Programmer's)76 b(Guide)999 3134
y(\(F)-19 b(ortran)78 b(V)-19 b(ersion\))245 3396 y
gsave currentpoint currentpoint translate -90 neg rotate neg exch neg exch translate
245
@@ -48331,7 +48331,7 @@ g(and)g(for)g(generating)i(graphical)f(output)f(based)g(on)g(it.)0
(t-indep)s(enden)m(t.)p eop end
%%Page: 2 2
TeXDict begin 2 1 bop 0 52 a FG(ii)3245 b Fz(SUN/210.27)0
-5670 y FG(Cop)m(yrigh)m(t)31 b(\(C\))g(2012)h(Science)f(&)f(T)-8
+5670 y FG(Cop)m(yrigh)m(t)31 b(\(C\))g(2013)h(Science)f(&)f(T)-8
b(ec)m(hnology)32 b(F)-8 b(acilities)34 b(Council)p eop
end
%%Page: 3 3
@@ -48929,227 +48929,230 @@ g(Use)g(AST)e(.)46 b(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)
g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(184)0 4183 y FE(A)d(The)35
b(AST)g(Class)f(Hierarc)m(h)m(y)2307 b(185)0 4393 y(B)62
b(AST)35 b(Routine)g(Descriptions)2277 b(187)0 4604 y(C)60
-b(AST)35 b(A)m(ttribute)f(Descriptions)2207 b(411)0 4815
-y(D)56 b(AST)35 b(Class)g(Descriptions)2403 b(515)0 5025
-y(E)67 b(UNIX)35 b(Command)g(Descriptions)2101 b(561)0
-5236 y(F)70 b(FITS-W)m(CS)34 b(Co)m(v)m(erage)2523 b(565)136
+b(AST)35 b(A)m(ttribute)f(Descriptions)2207 b(415)0 4815
+y(D)56 b(AST)35 b(Class)g(Descriptions)2403 b(521)0 5025
+y(E)67 b(UNIX)35 b(Command)g(Descriptions)2101 b(567)0
+5236 y(F)70 b(FITS-W)m(CS)34 b(Co)m(v)m(erage)2523 b(571)136
5350 y FG(F.1)80 b(P)m(ap)s(er)31 b(I)f(-)g(General)i(Linear)e(Co)s
(ordinates)c(.)46 b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h
-(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(565)345
+(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(571)345
5464 y(F.1.1)92 b(Requiremen)m(ts)31 b(for)f(a)h(Successful)f(W)-8
b(rite)32 b(Op)s(eration)61 b(.)46 b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)
-f(.)h(.)g(.)f(.)h(.)60 b(565)345 5579 y(F.1.2)92 b(Use)31
+f(.)h(.)g(.)f(.)h(.)60 b(571)345 5579 y(F.1.2)92 b(Use)31
b(and)f(Choice)h(of)f(CTYPE)p Fx(i)39 b FG(k)m(eyw)m(ords)71
b(.)45 b(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)
-g(.)f(.)h(.)60 b(565)345 5693 y(F.1.3)92 b(Choice)31
+g(.)f(.)h(.)60 b(571)345 5693 y(F.1.3)92 b(Choice)31
b(of)g(Reference)g(P)m(oin)m(t)57 b(.)45 b(.)h(.)g(.)f(.)h(.)g(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)
-h(.)60 b(567)p eop end
+h(.)60 b(573)p eop end
%%Page: 8 8
TeXDict begin 8 7 bop 0 52 a FG(viii)3140 b Fz(CONTENTS)345
351 y FG(F.1.4)92 b(Choice)31 b(of)g(Axis)f(Ordering)49
b(.)d(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h
-(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(567)345
+(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(573)345
465 y(F.1.5)92 b(Alternate)32 b(Axis)f(Descriptions)50
b(.)c(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f
-(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(567)136 579 y(F.2)80
+(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(573)136 579 y(F.2)80
b(P)m(ap)s(er)31 b(I)s(I)e(-)i(Celestial)h(Co)s(ordinates)h(.)46
b(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g
-(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(568)345 693
+(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(574)345 693
y(F.2.1)92 b(Requiremen)m(ts)31 b(for)f(a)h(Successful)f(W)-8
b(rite)32 b(Op)s(eration)61 b(.)46 b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)
-f(.)h(.)g(.)f(.)h(.)60 b(568)345 807 y(F.2.2)92 b(Choice)31
+f(.)h(.)g(.)f(.)h(.)60 b(574)345 807 y(F.2.2)92 b(Choice)31
b(of)g(LONPOLE/LA)-8 b(TPOLE)36 b(.)46 b(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)
g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(568)345 922 y(F.2.3)92 b(User)31 b(De\014ned)f(Fiducial)h(P)m(oin)m
+b(574)345 922 y(F.2.3)92 b(User)31 b(De\014ned)f(Fiducial)h(P)m(oin)m
(ts)82 b(.)46 b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g
-(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(570)345 1036
+(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(576)345 1036
y(F.2.4)92 b(Common)30 b(Non-Standard)g(F)-8 b(eatures)54
b(.)46 b(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)
-g(.)f(.)h(.)g(.)f(.)h(.)60 b(570)136 1150 y(F.3)80 b(P)m(ap)s(er)31
+g(.)f(.)h(.)g(.)f(.)h(.)60 b(576)136 1150 y(F.3)80 b(P)m(ap)s(er)31
b(I)s(I)s(I)d(-)j(Sp)s(ectral)f(Co)s(ordinates)82 b(.)45
b(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f
-(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(571)345 1264
+(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(577)345 1264
y(F.3.1)92 b(Requiremen)m(ts)31 b(for)f(a)h(Successful)f(W)-8
b(rite)32 b(Op)s(eration)61 b(.)46 b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)
-f(.)h(.)g(.)f(.)h(.)60 b(571)345 1378 y(F.3.2)92 b(Common)30
+f(.)h(.)g(.)f(.)h(.)60 b(577)345 1378 y(F.3.2)92 b(Common)30
b(Non-Standard)g(F)-8 b(eatures)54 b(.)46 b(.)g(.)g(.)f(.)h(.)g(.)f(.)h
(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(573)136 1492 y(F.4)80 b(P)m(ap)s(er)31 b(IV)f(-)h(Co)s(ordinate)f
+b(579)136 1492 y(F.4)80 b(P)m(ap)s(er)31 b(IV)f(-)h(Co)s(ordinate)f
(Distortions)78 b(.)46 b(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)
g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(573)345 1606 y(F.4.1)92 b(The)30 b(\\-SIP")h(distortion)g(co)s(de)76
+b(579)345 1606 y(F.4.1)92 b(The)30 b(\\-SIP")h(distortion)g(co)s(de)76
b(.)46 b(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
-f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(573)0 1815 y
+f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(579)0 1815 y
FE(G)54 b(Changes)35 b(and)g(New)f(F)-9 b(eatures)2239
-b(574)136 1929 y FG(G.1)68 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.1)
+b(580)136 1929 y FG(G.1)68 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.1)
47 b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)
g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(574)136 2043 y(G.2)68 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.2)47
+b(580)136 2043 y(G.2)68 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.2)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(575)136 2157 y(G.3)68 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.3)47
+b(581)136 2157 y(G.3)68 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.3)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(576)136 2272 y(G.4)68 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.4)47
+b(582)136 2272 y(G.4)68 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.4)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(577)136 2386 y(G.5)68 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.5)47
+b(583)136 2386 y(G.5)68 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.5)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(578)136 2500 y(G.6)68 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.6)47
+b(584)136 2500 y(G.6)68 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.6)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(579)136 2614 y(G.7)68 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.7)47
+b(585)136 2614 y(G.7)68 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.7)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(581)136 2728 y(G.8)68 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.8-2)
+b(587)136 2728 y(G.8)68 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.8-2)
42 b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)
-f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(582)136
+f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(588)136
2842 y(G.9)68 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.8-3)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(582)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(588)136
2956 y(G.10)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.8-4)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(583)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(589)136
3070 y(G.11)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.8-5)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(583)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(589)136
3184 y(G.12)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.8-7)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(583)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(589)136
3298 y(G.13)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.8-8)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(584)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(590)136
3412 y(G.14)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.8-13)68
b(.)46 b(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)
-h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(584)136
+h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(590)136
3526 y(G.15)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V2.0)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(585)136 3640 y(G.16)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.0)47
+b(591)136 3640 y(G.16)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.0)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(587)136 3754 y(G.17)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.1)47
+b(593)136 3754 y(G.17)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.1)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(589)136 3868 y(G.18)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.2)47
+b(595)136 3868 y(G.18)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.2)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(590)136 3982 y(G.19)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.3)47
+b(596)136 3982 y(G.19)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.3)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(591)136 4096 y(G.20)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.4)47
+b(597)136 4096 y(G.20)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.4)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(592)136 4210 y(G.21)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.5)47
+b(598)136 4210 y(G.21)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.5)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(593)136 4324 y(G.22)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.6)47
+b(599)136 4324 y(G.22)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.6)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(594)136 4438 y(G.23)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.7)47
+b(600)136 4438 y(G.23)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.7)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(594)136 4553 y(G.24)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.0)47
+b(600)136 4553 y(G.24)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.0)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(594)136 4667 y(G.25)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.1)47
+b(600)136 4667 y(G.25)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.1)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(595)136 4781 y(G.26)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.2)47
+b(601)136 4781 y(G.26)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.2)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(595)136 4895 y(G.27)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.3)47
+b(601)136 4895 y(G.27)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.3)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(596)136 5009 y(G.28)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.4)47
+b(602)136 5009 y(G.28)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.4)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(597)136 5123 y(G.29)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.5)47
+b(603)136 5123 y(G.29)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.5)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(598)136 5237 y(G.30)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.6)47
+b(604)136 5237 y(G.30)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.6)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(599)136 5351 y(G.31)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.0)47
+b(605)136 5351 y(G.31)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.0)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(599)136 5465 y(G.32)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.1)47
+b(605)136 5465 y(G.32)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.1)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(599)136 5579 y(G.33)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.2)47
+b(605)136 5579 y(G.33)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.2)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(600)136 5693 y(G.34)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.3)47
+b(606)136 5693 y(G.34)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.3)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(601)p eop end
+b(607)p eop end
%%Page: 9 9
TeXDict begin 9 8 bop 0 52 a Fz(SUN/210.27)3224 b FG(ix)136
351 y(G.35)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.3-1)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(602)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(608)136
464 y(G.36)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.3-2)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(603)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(609)136
577 y(G.37)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.4-0)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(603)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(609)136
690 y(G.38)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.5-0)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(604)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(610)136
803 y(G.39)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.6-0)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(604)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(610)136
916 y(G.40)23 b(ChangesIn)m(tro)s(duced)30 b(in)g(V5.6-1)72
b(.)46 b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)
-f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(604)136
+f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(610)136
1029 y(G.41)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.7-0)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(605)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(611)136
1142 y(G.42)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.7-1)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(605)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(611)136
1255 y(G.43)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.7-2)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(606)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(612)136
1367 y(G.44)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V6.0)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(606)136 1480 y(G.45)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V6.0-1)
+b(612)136 1480 y(G.45)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V6.0-1)
42 b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)
-f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(607)136
+f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(613)136
1593 y(G.46)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.0.0)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(607)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(613)136
1706 y(G.47)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.0.1)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(607)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(613)136
1819 y(G.48)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.0.2)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(607)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(613)136
1932 y(G.49)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.0.3)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(608)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(614)136
2045 y(G.50)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.0.4)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(608)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(614)136
2158 y(G.51)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.0.5)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(608)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(614)136
2271 y(G.52)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.0.6)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(608)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(614)136
2384 y(G.53)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.1.0)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(609)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(615)136
2497 y(G.54)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.1.1)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(609)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(615)136
2609 y(G.55)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.2.0)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(609)p
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(615)136
+2722 y(G.56)23 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.3.0)47
+b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(615)p
eop end
%%Page: 10 10
TeXDict begin 10 9 bop 0 52 a FG(x)3247 b Fz(SUN/210.27)p
@@ -49158,7 +49161,7 @@ eop end
TeXDict begin 1 10 bop 3734 52 a FG(1)p 945 709 1890
12 v 1755 898 a FA(AST)1202 1047 y(A)45 b(Library)g(for)g(Handling)1097
1196 y(W)-11 b(orld)45 b(Co)t(ordinate)h(Systems)1486
-1346 y(in)f(Astronom)l(y)1753 1592 y(V7.2)p 945 1783
+1346 y(in)f(Astronom)l(y)1753 1592 y(V7.3)p 945 1783
V 994 2176 a Fx(This)33 b(is)g(the)g(F)-7 b(ortr)i(an)35
b(version)e(of)g(this)g(do)-5 b(cument.)1101 2289 y(F)e(or)34
b(the)f(C)g(version,)g(ple)-5 b(ase)33 b(se)-5 b(e)33
@@ -111299,2671 +111302,2717 @@ v 0 482 a FA(AST)p Fe(_)p FA(ADDP)-11 b(ARAMETER)1732
483 y Fd(Add)39 b(a)1789 583 y(new)1737 682 y(global)1682
782 y(parame-)1818 881 y(ter)1730 981 y(de\014ni-)1717
1081 y(tion)f(to)1714 1180 y(a)h(table)2258 482 y FA(AST)p
-Fe(_)p FA(ADDP)-11 b(ARAMETER)0 1345 y Fc(Description:)44
+Fe(_)p FA(ADDP)-11 b(ARAMETER)0 1353 y Fc(Description:)44
b Fj(Adds)29 b(the)h(de\014nition)f(of)f(a)h(new)f(global)g(parameter)f
(to)i(the)g(supplied)g(table.)40 b(Note,)29 b(this)g(do)r(es)g(not)227
-1445 y(store)k(a)h(v)-5 b(alue)34 b(for)f(the)i(parameter.)55
+1453 y(store)k(a)h(v)-5 b(alue)34 b(for)f(the)i(parameter.)55
b(T)-7 b(o)33 b(get)h(or)f(set)h(the)h(parameter)d(v)-5
b(alue,)36 b(the)f(metho)r(ds)f(of)g(the)g(parem)n(t)227
-1544 y(KeyMap)27 b(class)g(should)g(b)r(e)h(used,)g(using)f(the)h(name)
-f(of)h(the)g(parameter)e(as)h(the)h(k)n(ey)-7 b(.)0 1693
+1553 y(KeyMap)27 b(class)g(should)g(b)r(e)h(used,)g(using)f(the)h(name)
+f(of)h(the)g(parameter)e(as)h(the)h(k)n(ey)-7 b(.)0 1710
y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_ADDPARAMETE)o(R\()37
-b(THIS,)42 b(NAME,)f(STATUS)g(\))0 1842 y Fc(Argumen)m(ts:)259
-1978 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 2078
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(T)-7 b(able.)259 2210
+b(THIS,)42 b(NAME,)f(STATUS)g(\))0 1867 y Fc(Argumen)m(ts:)259
+2011 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 2110
+y Fj(P)n(oin)n(ter)26 b(to)i(the)g(T)-7 b(able.)259 2247
y Fc(NAME)31 b(=)h(CHARA)m(CTER)g Fi(\003)f Fc(\()h Fi(\003)f
-Fc(\))h(\(Giv)m(en\))427 2310 y Fj(The)39 b(parameter)d(name.)69
+Fc(\))h(\(Giv)m(en\))427 2346 y Fj(The)39 b(parameter)d(name.)69
b(T)-7 b(railing)37 b(spaces)g(are)h(ignored)f(\(all)h(other)g(spaces)f
-(are)g(signi\014can)n(t\).)69 b(The)427 2409 y(supplied)28
+(are)g(signi\014can)n(t\).)69 b(The)427 2446 y(supplied)28
b(string)f(is)h(con)n(v)n(erted)e(to)h(upp)r(er)h(case.)259
-2542 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 2641 y Fj(The)c(global)e(status.)0 2803
-y Fc(Notes:)340 3085 y Fi(\017)45 b Fj(Unlik)n(e)23 b(columns,)h(the)f
+2583 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 2682 y Fj(The)c(global)e(status.)0 2852
+y Fc(Notes:)340 3142 y Fi(\017)45 b Fj(Unlik)n(e)23 b(columns,)h(the)f
(de\014nition)g(of)g(a)g(parameter)e(do)r(es)h(not)h(sp)r(ecify)g(its)h
(t)n(yp)r(e,)g(size)e(or)g(dimensionalit)n(y)-7 b(.)p
-0 3283 V 0 3414 a FA(AST)p Fe(_)p FA(ANGLE)1034 3415
-y Fd(Calculate)37 b(the)h(angle)g(subtended)h(b)m(y)1203
-3529 y(t)m(w)m(o)e(p)s(oin)m(ts)h(at)g(a)h(third)f(p)s(oin)m(t)2967
-3414 y FA(AST)p Fe(_)p FA(ANGLE)0 3717 y Fc(Description:)44
-b Fj(This)28 b(routine)g(\014nds)g(the)g(angle)f(at)h(p)r(oin)n(t)g(B)g
-(b)r(et)n(w)n(een)g(the)h(line)f(joining)g(p)r(oin)n(ts)f(A)i(and)f(B,)
-f(and)h(the)227 3817 y(line)j(joining)g(p)r(oin)n(ts)f(C)h(and)g(B.)f
-(These)h(lines)f(will)h(in)g(fact)g(b)r(e)g(geo)r(desic)f(curv)n(es)f
-(appropriate)g(to)i(the)g(F)-7 b(rame)227 3917 y(in)28
-b(use.)37 b(F)-7 b(or)27 b(instance,)g(in)h(SkyF)-7 b(rame,)27
-b(they)h(will)g(b)r(e)g(great)e(circles.)0 4065 y Fc(In)m(v)m(o)s
-(cation:)123 b Ft(RESULT)41 b(=)i(AST_ANGLE\()c(THIS,)j(A,)h(B,)g(C,)f
-(STATUS)f(\))0 4214 y Fc(Argumen)m(ts:)259 4350 y(THIS)32
-b(=)g(INTEGER)g(\(Giv)m(en\))427 4450 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(F)-7 b(rame.)259 4582 y Fc(A\()32 b Fi(\003)g
-Fc(\))g(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427 4682
-y Fj(An)d(arra)n(y)c(with)k(one)f(elemen)n(t)g(for)f(eac)n(h)h(F)-7
-b(rame)26 b(axis)g(\(Naxes)h(attribute\))h(con)n(taining)e(the)h(co)r
-(ordinates)427 4782 y(of)h(the)g(\014rst)f(p)r(oin)n(t.)259
-4914 y Fc(B\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m
-(en\))427 5014 y Fj(An)d(arra)n(y)c(with)k(one)f(elemen)n(t)g(for)f
-(eac)n(h)h(F)-7 b(rame)26 b(axis)g(\(Naxes)h(attribute\))h(con)n
-(taining)e(the)h(co)r(ordinates)427 5113 y(of)h(the)g(second)f(p)r(oin)
-n(t.)259 5246 y Fc(C\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e
-(\(Giv)m(en\))427 5345 y Fj(An)d(arra)n(y)c(with)k(one)f(elemen)n(t)g
-(for)f(eac)n(h)h(F)-7 b(rame)26 b(axis)g(\(Naxes)h(attribute\))h(con)n
-(taining)e(the)h(co)r(ordinates)427 5445 y(of)h(the)g(third)g(p)r(oin)n
-(t.)259 5577 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 5677 y Fj(The)c(global)e(status.)p eop
-end
+0 3348 V 0 3479 a FA(AST)p Fe(_)p FA(ADD)l(V)-15 b(ARIANT)310
+b Fd(Store)38 b(a)h(new)1465 3578 y(v)-7 b(arian)m(t)37
+b(Mapping)1516 3693 y(for)h(the)g(curren)m(t)1613 3793
+y(F)-10 b(rame)38 b(in)g(a)1648 3892 y(F)-10 b(rameSet)2505
+3479 y FA(AST)p Fe(_)p FA(ADD)l(V)-15 b(ARIANT)0 4065
+y Fc(Description:)44 b Fj(This)38 b(routine)g(allo)n(ws)f(a)g(new)h(v)
+-5 b(arian)n(t)37 b(Mapping)h(to)g(b)r(e)g(stored)f(with)i(the)f
+(curren)n(t)f(F)-7 b(rame)38 b(in)g(a)227 4165 y(F)-7
+b(rameSet.)35 b(See)22 b(the)h Ft(")p Fj(V)-7 b(arian)n(t)p
+Ft(")20 b Fj(attribute)i(for)g(more)f(details.)35 b(It)22
+b(can)g(also)f(b)r(e)h(used)g(to)g(rename)f(the)i(curren)n(tly)227
+4265 y(selected)28 b(v)-5 b(arian)n(t)26 b(Mapping.)0
+4422 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_ADDVARIANT\()37
+b(THIS,)42 b(MAP,)g(NAME,)f(STATUS)g(\))0 4579 y Fc(Argumen)m(ts:)259
+4722 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 4822
+y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7 b(rameSet.)259
+4959 y Fc(MAP)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 5058
+y Fj(P)n(oin)n(ter)25 b(to)h(a)h(Mapping)f(whic)n(h)g(describ)r(es)g
+(ho)n(w)g(to)g(con)n(v)n(ert)f(co)r(ordinates)g(from)h(the)h(curren)n
+(t)f(F)-7 b(rame)26 b(to)427 5158 y(the)i(new)f(v)-5
+b(arian)n(t)26 b(of)h(the)g(curren)n(t)g(F)-7 b(rame.)36
+b(If)27 b(AST)p Ft(__)p Fj(NULL)g(is)g(supplied,)h(then)g(the)f(name)g
+(asso)r(ciated)427 5258 y(with)21 b(the)g(curren)n(tly)e(selected)i(v)
+-5 b(arian)n(t)19 b(of)h(the)h(curren)n(t)f(F)-7 b(rame)20
+b(is)g(set)g(to)h(the)f(v)-5 b(alue)21 b(supplied)f(for)g(NAME,)427
+5357 y(but)28 b(no)g(new)f(v)-5 b(arian)n(t)27 b(is)h(added.)259
+5494 y Fc(NAME)j(=)h(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 5593 y Fj(The)25 b(name)g(to)g(asso)
+r(ciate)e(with)i(the)h(new)f(v)-5 b(arian)n(t)24 b(Mapping)g(\(or)g
+(the)i(curren)n(tly)d(selected)i(v)-5 b(arian)n(t)24
+b(Map-)427 5693 y(ping)k(if)g(MAP)f(is)h(AST)p Ft(__)p
+Fj(NULL\).)p eop end
%%Page: 191 201
-TeXDict begin 191 200 bop 3643 52 a FG(191)0 351 y Fc(Returned)32
-b(V)-8 b(alue:)259 491 y(AST)p Ft(_)p Fc(ANGLE)32 b(=)g(DOUBLE)h
-(PRECISION)427 591 y Fj(The)c(angle)e(in)i(radians,)e(from)h(the)g
-(line)h(AB)f(to)g(the)h(line)f(CB.)g(If)h(the)g(F)-7
-b(rame)27 b(is)i(2-dimensional,)e(it)h(will)427 690 y(b)r(e)33
-b(in)f(the)h(range)e($)p Fi(n)p Fj(pm)h Fi(n)p Fj(pi$,)h(and)f(p)r
-(ositiv)n(e)g(rotation)f(is)h(in)g(the)h(same)f(sense)g(as)f(rotation)g
-(from)h(the)427 790 y(p)r(ositiv)n(e)d(direction)g(of)g(axis)f(2)h(to)g
-(the)h(p)r(ositiv)n(e)e(direction)h(of)g(axis)g(1.)41
-b(If)30 b(the)f(F)-7 b(rame)29 b(has)f(more)h(than)g(2)427
-890 y(axes,)e(a)g(p)r(ositiv)n(e)g(v)-5 b(alue)28 b(will)g(alw)n(a)n
-(ys)d(b)r(e)j(returned)f(in)h(the)g(range)f(zero)f(to)i($)p
-Fi(n)p Fj(pi$.)0 1055 y Fc(Notes:)340 1341 y Fi(\017)45
-b Fj(A)27 b(v)-5 b(alue)26 b(of)h(AST)p Ft(__)p Fj(BAD)f(will)h(also)e
-(b)r(e)i(returned)f(if)h(p)r(oin)n(ts)f(A)h(and)f(B)g(are)g(co-inciden)
-n(t,)g(or)f(if)i(p)r(oin)n(ts)g(B)427 1441 y(and)h(C)f(are)g
-(co-inciden)n(t.)340 1575 y Fi(\017)45 b Fj(A)29 b(v)-5
-b(alue)29 b(of)g(AST)p Ft(__)p Fj(BAD)g(will)g(also)f(b)r(e)h(returned)
-g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(ST)-7
-b(A)g(TUS)30 b(set)f(to)427 1675 y(an)f(error)d(v)-5
+TeXDict begin 191 200 bop 3643 52 a FG(191)259 351 y
+Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+451 y Fj(The)c(global)e(status.)0 619 y Fc(Notes:)340
+908 y Fi(\017)45 b Fj(The)32 b(newly)g(added)g(V)-7 b(arian)n(t)31
+b(b)r(ecomes)h(the)g(curren)n(t)f(v)-5 b(arian)n(t)31
+b(on)h(exit)g(\(this)g(is)g(equiv)-5 b(alen)n(t)32 b(to)g(setting)427
+1008 y(the)c(V)-7 b(arian)n(t)27 b(attribute)h(to)f(the)h(v)-5
+b(alue)28 b(supplied)g(for)f(NAME\).)340 1144 y Fi(\017)45
+b Fj(An)27 b(error)e(is)i(rep)r(orted)e(if)j(a)e(v)-5
+b(arian)n(t)25 b(with)j(the)f(supplied)g(name)f(already)f(exists)h(in)h
+(the)g(curren)n(t)f(F)-7 b(rame.)340 1280 y Fi(\017)45
+b Fj(An)35 b(error)e(is)i(rep)r(orted)f(if)h(the)g(curren)n(t)f(F)-7
+b(rame)34 b(is)g(a)h(mirror)e(for)h(the)h(v)-5 b(arian)n(t)34
+b(Mappings)g(in)h(another)427 1380 y(F)-7 b(rame.)59
+b(This)35 b(is)g(only)g(the)h(case)e(if)i(the)f(AST)p
+Ft(_)p Fj(MIRR)n(OR)-9 b(V)g(ARIANTS)36 b(routine)f(has)f(b)r(een)i
+(called)f(to)427 1479 y(mak)n(e)27 b(the)h(curren)n(t)f(F)-7
+b(rame)27 b(act)g(as)g(a)g(mirror.)p 0 1685 3780 12 v
+0 1816 a FA(AST)p Fe(_)p FA(ANGLE)1034 1817 y Fd(Calculate)37
+b(the)h(angle)g(subtended)h(b)m(y)1203 1931 y(t)m(w)m(o)e(p)s(oin)m(ts)
+h(at)g(a)h(third)f(p)s(oin)m(t)2967 1816 y FA(AST)p Fe(_)p
+FA(ANGLE)0 2126 y Fc(Description:)44 b Fj(This)28 b(routine)g(\014nds)g
+(the)g(angle)f(at)h(p)r(oin)n(t)g(B)g(b)r(et)n(w)n(een)g(the)h(line)f
+(joining)g(p)r(oin)n(ts)f(A)i(and)f(B,)f(and)h(the)227
+2226 y(line)j(joining)g(p)r(oin)n(ts)f(C)h(and)g(B.)f(These)h(lines)f
+(will)h(in)g(fact)g(b)r(e)g(geo)r(desic)f(curv)n(es)f(appropriate)g(to)
+i(the)g(F)-7 b(rame)227 2326 y(in)28 b(use.)37 b(F)-7
+b(or)27 b(instance,)g(in)h(SkyF)-7 b(rame,)27 b(they)h(will)g(b)r(e)g
+(great)e(circles.)0 2482 y Fc(In)m(v)m(o)s(cation:)123
+b Ft(RESULT)41 b(=)i(AST_ANGLE\()c(THIS,)j(A,)h(B,)g(C,)f(STATUS)f(\))0
+2637 y Fc(Argumen)m(ts:)259 2780 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 2880 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rame.)259 3016 y Fc(A\()32 b Fi(\003)g Fc(\))g(=)g(DOUBLE)g
+(PRECISION)f(\(Giv)m(en\))427 3116 y Fj(An)d(arra)n(y)c(with)k(one)f
+(elemen)n(t)g(for)f(eac)n(h)h(F)-7 b(rame)26 b(axis)g(\(Naxes)h
+(attribute\))h(con)n(taining)e(the)h(co)r(ordinates)427
+3215 y(of)h(the)g(\014rst)f(p)r(oin)n(t.)259 3351 y Fc(B\()32
+b Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m(en\))427
+3451 y Fj(An)d(arra)n(y)c(with)k(one)f(elemen)n(t)g(for)f(eac)n(h)h(F)
+-7 b(rame)26 b(axis)g(\(Naxes)h(attribute\))h(con)n(taining)e(the)h(co)
+r(ordinates)427 3551 y(of)h(the)g(second)f(p)r(oin)n(t.)259
+3687 y Fc(C\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m
+(en\))427 3786 y Fj(An)d(arra)n(y)c(with)k(one)f(elemen)n(t)g(for)f
+(eac)n(h)h(F)-7 b(rame)26 b(axis)g(\(Naxes)h(attribute\))h(con)n
+(taining)e(the)h(co)r(ordinates)427 3886 y(of)h(the)g(third)g(p)r(oin)n
+(t.)259 4022 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 4122 y Fj(The)c(global)e(status.)0 4290
+y Fc(Returned)32 b(V)-8 b(alue:)259 4433 y(AST)p Ft(_)p
+Fc(ANGLE)32 b(=)g(DOUBLE)h(PRECISION)427 4532 y Fj(The)c(angle)e(in)i
+(radians,)e(from)h(the)g(line)h(AB)f(to)g(the)h(line)f(CB.)g(If)h(the)g
+(F)-7 b(rame)27 b(is)i(2-dimensional,)e(it)h(will)427
+4632 y(b)r(e)33 b(in)f(the)h(range)e($)p Fi(n)p Fj(pm)h
+Fi(n)p Fj(pi$,)h(and)f(p)r(ositiv)n(e)g(rotation)f(is)h(in)g(the)h
+(same)f(sense)g(as)f(rotation)g(from)h(the)427 4732 y(p)r(ositiv)n(e)d
+(direction)g(of)g(axis)f(2)h(to)g(the)h(p)r(ositiv)n(e)e(direction)h
+(of)g(axis)g(1.)41 b(If)30 b(the)f(F)-7 b(rame)29 b(has)f(more)h(than)g
+(2)427 4831 y(axes,)e(a)g(p)r(ositiv)n(e)g(v)-5 b(alue)28
+b(will)g(alw)n(a)n(ys)d(b)r(e)j(returned)f(in)h(the)g(range)f(zero)f
+(to)i($)p Fi(n)p Fj(pi$.)0 5000 y Fc(Notes:)340 5289
+y Fi(\017)45 b Fj(A)27 b(v)-5 b(alue)26 b(of)h(AST)p
+Ft(__)p Fj(BAD)f(will)h(also)e(b)r(e)i(returned)f(if)h(p)r(oin)n(ts)f
+(A)h(and)f(B)g(are)g(co-inciden)n(t,)g(or)f(if)i(p)r(oin)n(ts)g(B)427
+5388 y(and)h(C)f(are)g(co-inciden)n(t.)340 5524 y Fi(\017)45
+b Fj(A)29 b(v)-5 b(alue)29 b(of)g(AST)p Ft(__)p Fj(BAD)g(will)g(also)f
+(b)r(e)h(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g
+(with)h(ST)-7 b(A)g(TUS)30 b(set)f(to)427 5624 y(an)f(error)d(v)-5
b(alue,)28 b(or)e(if)j(it)f(should)f(fail)h(for)f(an)n(y)g(reason.)p
-0 1877 3780 12 v 0 2008 a FA(AST)p Fe(_)p FA(ANNUL)1137
-2009 y Fd(Ann)m(ul)38 b(a)h(p)s(oin)m(ter)e(to)h(an)h(Ob)7
-b(ject)2952 2008 y FA(AST)p Fe(_)p FA(ANNUL)0 2201 y
-Fc(Description:)44 b Fj(This)33 b(routine)f(ann)n(uls)g(a)g(p)r(oin)n
-(ter)g(to)h(an)f(Ob)5 b(ject)33 b(so)f(that)g(it)h(is)g(no)f(longer)g
-(recognised)e(as)i(a)h(v)-5 b(alid)227 2301 y(p)r(oin)n(ter)37
-b(b)n(y)h(the)g(AST)g(library)-7 b(.)66 b(An)n(y)37 b(resources)f(asso)
-r(ciated)g(with)i(the)g(p)r(oin)n(ter)f(are)g(released)f(and)i(made)227
-2401 y(a)n(v)-5 b(ailable)27 b(for)g(re-use.)227 2527
-y(This)d(routine)f(also)g(decremen)n(ts)g(the)h(Ob)5
-b(ject's)23 b(RefCoun)n(t)h(attribute)f(b)n(y)h(one.)35
-b(If)24 b(this)g(attribute)g(reac)n(hes)e(zero)227 2627
-y(\(whic)n(h)28 b(happ)r(ens)g(when)g(the)f(last)h(p)r(oin)n(ter)f(to)g
-(the)h(Ob)5 b(ject)28 b(is)f(ann)n(ulled\),)h(then)g(the)g(Ob)5
-b(ject)28 b(is)f(deleted.)0 2779 y Fc(In)m(v)m(o)s(cation:)123
-b Ft(CALL)42 b(AST_ANNUL\()d(THIS,)j(STATUS)f(\))0 2932
-y Fc(Argumen)m(ts:)259 3072 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en)g(and)
-g(Returned\))427 3172 y Fj(The)c(Ob)5 b(ject)27 b(p)r(oin)n(ter)h(to)f
+eop end
+%%Page: 192 202
+TeXDict begin 192 201 bop 0 52 a FG(192)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(ANNUL)1137 483 y Fd(Ann)m(ul)38
+b(a)h(p)s(oin)m(ter)e(to)h(an)h(Ob)7 b(ject)2952 482
+y FA(AST)p Fe(_)p FA(ANNUL)0 667 y Fc(Description:)44
+b Fj(This)33 b(routine)f(ann)n(uls)g(a)g(p)r(oin)n(ter)g(to)h(an)f(Ob)5
+b(ject)33 b(so)f(that)g(it)h(is)g(no)f(longer)g(recognised)e(as)i(a)h
+(v)-5 b(alid)227 766 y(p)r(oin)n(ter)37 b(b)n(y)h(the)g(AST)g(library)
+-7 b(.)66 b(An)n(y)37 b(resources)f(asso)r(ciated)g(with)i(the)g(p)r
+(oin)n(ter)f(are)g(released)f(and)i(made)227 866 y(a)n(v)-5
+b(ailable)27 b(for)g(re-use.)227 989 y(This)d(routine)f(also)g
+(decremen)n(ts)g(the)h(Ob)5 b(ject's)23 b(RefCoun)n(t)h(attribute)f(b)n
+(y)h(one.)35 b(If)24 b(this)g(attribute)g(reac)n(hes)e(zero)227
+1089 y(\(whic)n(h)28 b(happ)r(ens)g(when)g(the)f(last)h(p)r(oin)n(ter)f
+(to)g(the)h(Ob)5 b(ject)28 b(is)f(ann)n(ulled\),)h(then)g(the)g(Ob)5
+b(ject)28 b(is)f(deleted.)0 1236 y Fc(In)m(v)m(o)s(cation:)123
+b Ft(CALL)42 b(AST_ANNUL\()d(THIS,)j(STATUS)f(\))0 1383
+y Fc(Argumen)m(ts:)259 1517 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en)g(and)
+g(Returned\))427 1616 y Fj(The)c(Ob)5 b(ject)27 b(p)r(oin)n(ter)h(to)f
(b)r(e)h(ann)n(ulled.)37 b(A)28 b(n)n(ull)f(p)r(oin)n(ter)h(v)-5
b(alue)27 b(\(AST)p Ft(__)p Fj(NULL\))h(is)g(alw)n(a)n(ys)d(returned.)
-259 3306 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 3406 y Fj(The)c(global)e(status.)0 3571
-y Fc(Class)31 b(Applicabilit)m(y:)259 3711 y(Ob)5 b(ject)427
-3811 y Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5
-b(jects.)0 3976 y Fc(Notes:)340 4262 y Fi(\017)45 b Fj(This)28
+259 1747 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 1846 y Fj(The)c(global)e(status.)0 2006
+y Fc(Class)31 b(Applicabilit)m(y:)259 2140 y(Ob)5 b(ject)427
+2239 y Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5
+b(jects.)0 2399 y Fc(Notes:)340 2679 y Fi(\017)45 b Fj(This)28
b(routine)f(attempts)g(to)h(execute)f(ev)n(en)g(if)g(ST)-7
b(A)g(TUS)29 b(is)e(set)g(to)h(an)f(error)e(v)-5 b(alue)27
-b(on)g(en)n(try)-7 b(,)27 b(although)427 4362 y(no)34
+b(on)g(en)n(try)-7 b(,)27 b(although)427 2779 y(no)34
b(further)f(error)f(rep)r(ort)h(will)h(b)r(e)g(made)g(if)g(it)g
(subsequen)n(tly)f(fails)h(under)f(these)h(circumstances.)54
-b(In)427 4461 y(particular,)27 b(it)i(will)f(fail)g(if)h(the)f(p)r(oin)
+b(In)427 2878 y(particular,)27 b(it)i(will)f(fail)g(if)h(the)f(p)r(oin)
n(ter)g(suppled)g(is)g(not)g(v)-5 b(alid,)28 b(but)h(this)f(will)g
-(only)g(b)r(e)g(rep)r(orted)g(if)g(the)427 4561 y(error)e(status)h(is)h
-(clear)e(on)i(en)n(try)-7 b(.)p 0 4764 V 0 4894 a FA(AST)p
-Fe(_)p FA(AXANGLE)1214 4895 y Fd(Returns)38 b(the)h(angle)f(from)f(an)
-1211 5010 y(axis,)h(to)g(a)h(line)f(through)f(t)m(w)m(o)1733
-5121 y(p)s(oin)m(ts)2764 4894 y FA(AST)p Fe(_)p FA(AXANGLE)0
-5313 y Fc(Description:)44 b Fj(This)35 b(routine)f(\014nds)h(the)g
+(only)g(b)r(e)g(rep)r(orted)g(if)g(the)427 2978 y(error)e(status)h(is)h
+(clear)e(on)i(en)n(try)-7 b(.)p 0 3172 V 0 3303 a FA(AST)p
+Fe(_)p FA(AXANGLE)1214 3304 y Fd(Returns)38 b(the)h(angle)f(from)f(an)
+1211 3418 y(axis,)h(to)g(a)h(line)f(through)f(t)m(w)m(o)1733
+3529 y(p)s(oin)m(ts)2764 3303 y FA(AST)p Fe(_)p FA(AXANGLE)0
+3713 y Fc(Description:)44 b Fj(This)35 b(routine)f(\014nds)h(the)g
(angle,)h(as)e(seen)h(from)f(p)r(oin)n(t)h(A,)g(b)r(et)n(w)n(een)g(the)
-g(p)r(ositiv)n(e)f(direction)g(of)h(a)227 5413 y(sp)r(eci\014ed)28
+g(p)r(ositiv)n(e)f(direction)g(of)h(a)227 3813 y(sp)r(eci\014ed)28
b(axis,)f(and)g(the)h(geo)r(desic)f(curv)n(e)g(joining)g(p)r(oin)n(t)h
-(A)g(to)f(p)r(oin)n(t)h(B.)0 5566 y Fc(In)m(v)m(o)s(cation:)123
+(A)g(to)f(p)r(oin)n(t)h(B.)0 3960 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_AXANGLE\()c(THIS,)i(A,)i(B,)g(AXIS,)e(STATUS)g
-(\))0 5718 y Fc(Argumen)m(ts:)p eop end
-%%Page: 192 202
-TeXDict begin 192 201 bop 0 52 a FG(192)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(THIS)h(=)g(INTEGER)g
-(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
-b(rame.)259 582 y Fc(A\()32 b Fi(\003)g Fc(\))g(=)g(DOUBLE)g(PRECISION)
-f(\(Giv)m(en\))427 681 y Fj(An)d(arra)n(y)c(with)k(one)f(elemen)n(t)g
-(for)f(eac)n(h)h(F)-7 b(rame)26 b(axis)g(\(Naxes)h(attribute\))h(con)n
-(taining)e(the)h(co)r(ordinates)427 781 y(of)h(the)g(\014rst)f(p)r(oin)
-n(t.)259 912 y Fc(B\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e
-(\(Giv)m(en\))427 1011 y Fj(An)d(arra)n(y)c(with)k(one)f(elemen)n(t)g
-(for)f(eac)n(h)h(F)-7 b(rame)26 b(axis)g(\(Naxes)h(attribute\))h(con)n
-(taining)e(the)h(co)r(ordinates)427 1111 y(of)h(the)g(second)f(p)r(oin)
-n(t.)259 1241 y Fc(AXIS)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
-1341 y Fj(The)24 b(n)n(um)n(b)r(er)g(of)f(the)h(F)-7
-b(rame)24 b(axis)f(from)g(whic)n(h)h(the)g(angle)f(is)g(to)h(b)r(e)g
-(measured)f(\(axis)g(n)n(um)n(b)r(ering)g(starts)427
-1441 y(at)28 b(1)f(for)g(the)h(\014rst)f(axis\).)259
-1571 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 1671 y Fj(The)c(global)e(status.)0 1831
-y Fc(Returned)32 b(V)-8 b(alue:)259 1965 y(AST)p Ft(_)p
-Fc(AXANGLE)33 b(=)f(DOUBLE)g(PRECISION)427 2065 y Fj(The)d(angle)g(in)g
-(radians,)f(from)h(the)g(p)r(ositiv)n(e)g(direction)f(of)h(the)h(sp)r
-(eci\014ed)f(axis,)g(to)g(the)g(line)g(AB.)h(If)f(the)427
-2164 y(F)-7 b(rame)28 b(is)g(2-dimensional,)g(it)g(will)h(b)r(e)g(in)f
-(the)h(range)e([-PI/2,+PI/2],)e(and)j(p)r(ositiv)n(e)g(rotation)f(is)i
-(in)f(the)427 2264 y(same)j(sense)f(as)g(rotation)g(from)g(the)i(p)r
-(ositiv)n(e)e(direction)g(of)h(axis)f(2)h(to)f(the)i(p)r(ositiv)n(e)e
-(direction)h(of)f(axis)427 2364 y(1.)43 b(If)30 b(the)g(F)-7
-b(rame)30 b(has)f(more)g(than)h(2)f(axes,)g(a)h(p)r(ositiv)n(e)f(v)-5
-b(alue)30 b(will)g(alw)n(a)n(ys)d(b)r(e)k(returned)e(in)h(the)g(range)
-427 2463 y(zero)d(to)g(PI.)0 2623 y Fc(Notes:)340 2903
-y Fi(\017)45 b Fj(The)28 b(geo)r(desic)f(curv)n(e)g(used)h(b)n(y)g
-(this)g(routine)g(is)g(the)g(path)g(of)g(shortest)g(distance)f(b)r(et)n
-(w)n(een)h(t)n(w)n(o)g(p)r(oin)n(ts,)427 3003 y(as)f(de\014ned)h(b)n(y)
-f(the)h(AST)p Ft(_)p Fj(DIST)-7 b(ANCE)29 b(function.)340
-3134 y Fi(\017)45 b Fj(This)19 b(function)g(will)g(return)f
-Ft(")p Fj(bad)p Ft(")g Fj(co)r(ordinate)g(v)-5 b(alues)18
-b(\(AST)p Ft(__)p Fj(BAD\))i(if)f(an)n(y)f(of)g(the)i(input)f(co)r
-(ordinates)427 3233 y(has)27 b(this)h(v)-5 b(alue,)28
-b(or)e(if)j(the)f(require)e(p)r(osition)h(angle)g(is)h(unde\014ned.)p
-0 3428 3780 12 v 0 3559 a FA(AST)p Fe(_)p FA(AXDIST)-11
-b(ANCE)1442 3560 y Fd(Find)39 b(the)f(distance)1454 3660
-y(b)s(et)m(w)m(een)g(t)m(w)m(o)f(axis)1735 3759 y(v)-7
-b(alues)2543 3559 y FA(AST)p Fe(_)p FA(AXDIST)c(ANCE)0
-3921 y Fc(Description:)44 b Fj(This)28 b(routine)e(returns)h(a)g
+(\))0 4107 y Fc(Argumen)m(ts:)259 4241 y(THIS)32 b(=)g(INTEGER)g(\(Giv)
+m(en\))427 4340 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rame.)259 4471 y Fc(A\()32 b Fi(\003)g Fc(\))g(=)g(DOUBLE)g
+(PRECISION)f(\(Giv)m(en\))427 4570 y Fj(An)d(arra)n(y)c(with)k(one)f
+(elemen)n(t)g(for)f(eac)n(h)h(F)-7 b(rame)26 b(axis)g(\(Naxes)h
+(attribute\))h(con)n(taining)e(the)h(co)r(ordinates)427
+4670 y(of)h(the)g(\014rst)f(p)r(oin)n(t.)259 4800 y Fc(B\()32
+b Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m(en\))427
+4900 y Fj(An)d(arra)n(y)c(with)k(one)f(elemen)n(t)g(for)f(eac)n(h)h(F)
+-7 b(rame)26 b(axis)g(\(Naxes)h(attribute\))h(con)n(taining)e(the)h(co)
+r(ordinates)427 4999 y(of)h(the)g(second)f(p)r(oin)n(t.)259
+5130 y Fc(AXIS)33 b(=)f(INTEGER)f(\(Giv)m(en\))427 5229
+y Fj(The)24 b(n)n(um)n(b)r(er)g(of)f(the)h(F)-7 b(rame)24
+b(axis)f(from)g(whic)n(h)h(the)g(angle)f(is)g(to)h(b)r(e)g(measured)f
+(\(axis)g(n)n(um)n(b)r(ering)g(starts)427 5329 y(at)28
+b(1)f(for)g(the)h(\014rst)f(axis\).)259 5459 y Fc(ST)-8
+b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+5559 y Fj(The)c(global)e(status.)0 5718 y Fc(Returned)32
+b(V)-8 b(alue:)p eop end
+%%Page: 193 203
+TeXDict begin 193 202 bop 3643 52 a FG(193)259 351 y
+Fc(AST)p Ft(_)p Fc(AXANGLE)33 b(=)f(DOUBLE)g(PRECISION)427
+451 y Fj(The)d(angle)g(in)g(radians,)f(from)h(the)g(p)r(ositiv)n(e)g
+(direction)f(of)h(the)h(sp)r(eci\014ed)f(axis,)g(to)g(the)g(line)g(AB.)
+h(If)f(the)427 551 y(F)-7 b(rame)28 b(is)g(2-dimensional,)g(it)g(will)h
+(b)r(e)g(in)f(the)h(range)e([-PI/2,+PI/2],)e(and)j(p)r(ositiv)n(e)g
+(rotation)f(is)i(in)f(the)427 650 y(same)j(sense)f(as)g(rotation)g
+(from)g(the)i(p)r(ositiv)n(e)e(direction)g(of)h(axis)f(2)h(to)f(the)i
+(p)r(ositiv)n(e)e(direction)h(of)f(axis)427 750 y(1.)43
+b(If)30 b(the)g(F)-7 b(rame)30 b(has)f(more)g(than)h(2)f(axes,)g(a)h(p)
+r(ositiv)n(e)f(v)-5 b(alue)30 b(will)g(alw)n(a)n(ys)d(b)r(e)k(returned)
+e(in)h(the)g(range)427 849 y(zero)d(to)g(PI.)0 1034 y
+Fc(Notes:)340 1339 y Fi(\017)45 b Fj(The)28 b(geo)r(desic)f(curv)n(e)g
+(used)h(b)n(y)g(this)g(routine)g(is)g(the)g(path)g(of)g(shortest)g
+(distance)f(b)r(et)n(w)n(een)h(t)n(w)n(o)g(p)r(oin)n(ts,)427
+1439 y(as)f(de\014ned)h(b)n(y)f(the)h(AST)p Ft(_)p Fj(DIST)-7
+b(ANCE)29 b(function.)340 1583 y Fi(\017)45 b Fj(This)19
+b(function)g(will)g(return)f Ft(")p Fj(bad)p Ft(")g Fj(co)r(ordinate)g
+(v)-5 b(alues)18 b(\(AST)p Ft(__)p Fj(BAD\))i(if)f(an)n(y)f(of)g(the)i
+(input)f(co)r(ordinates)427 1683 y(has)27 b(this)h(v)-5
+b(alue,)28 b(or)e(if)j(the)f(require)e(p)r(osition)h(angle)g(is)h
+(unde\014ned.)p 0 1905 3780 12 v 0 2036 a FA(AST)p Fe(_)p
+FA(AXDIST)-11 b(ANCE)1442 2037 y Fd(Find)39 b(the)f(distance)1454
+2136 y(b)s(et)m(w)m(een)g(t)m(w)m(o)f(axis)1735 2236
+y(v)-7 b(alues)2543 2036 y FA(AST)p Fe(_)p FA(AXDIST)c(ANCE)0
+2424 y Fc(Description:)44 b Fj(This)28 b(routine)e(returns)h(a)g
(signed)f(v)-5 b(alue)27 b(represen)n(ting)f(the)i(axis)e(incremen)n(t)
-h(from)g(axis)f(v)-5 b(alue)27 b(v1)g(to)227 4020 y(axis)g(v)-5
-b(alue)28 b(v2.)227 4144 y(F)-7 b(or)24 b(a)g(simple)h(F)-7
+h(from)g(axis)f(v)-5 b(alue)27 b(v1)g(to)227 2524 y(axis)g(v)-5
+b(alue)28 b(v2.)227 2660 y(F)-7 b(or)24 b(a)g(simple)h(F)-7
b(rame,)25 b(this)g(is)f(a)h(trivial)f(op)r(eration)f(returning)h(the)h
(di\013erence)g(b)r(et)n(w)n(een)f(the)h(t)n(w)n(o)f(axis)g(v)-5
-b(alues.)227 4243 y(But)28 b(for)f(other)g(deriv)n(ed)g(classes)f(of)i
+b(alues.)227 2760 y(But)28 b(for)f(other)g(deriv)n(ed)g(classes)f(of)i
(F)-7 b(rame)27 b(\(suc)n(h)h(as)e(a)i(SkyF)-7 b(rame\))27
-b(this)h(is)f(not)h(the)g(case.)0 4391 y Fc(In)m(v)m(o)s(cation:)123
+b(this)h(is)f(not)h(the)g(case.)0 2932 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_AXDISTANCE\()37 b(THIS,)42 b(AXIS,)f(V1,)i
-(V2,)f(STATUS)f(\))0 4538 y Fc(Argumen)m(ts:)259 4672
-y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 4772 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(F)-7 b(rame.)259 4902 y Fc(AXIS)33 b(=)f(INTEGER)f(\(Giv)m
-(en\))427 5002 y Fj(The)d(index)g(of)f(the)h(axis)f(to)g(whic)n(h)h
+(V2,)f(STATUS)f(\))0 3104 y Fc(Argumen)m(ts:)259 3263
+y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 3363 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(F)-7 b(rame.)259 3507 y Fc(AXIS)33 b(=)f(INTEGER)f(\(Giv)m
+(en\))427 3607 y Fj(The)d(index)g(of)f(the)h(axis)f(to)g(whic)n(h)h
(the)g(supplied)g(v)-5 b(alues)27 b(refer.)36 b(The)28
-b(\014rst)f(axis)g(has)g(index)h(1.)259 5133 y Fc(V1)k(=)g(DOUBLE)g
-(PRECISION)f(\(Giv)m(en\))427 5232 y Fj(The)d(\014rst)f(axis)g(v)-5
-b(alue.)259 5363 y Fc(V2)32 b(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427
-5463 y Fj(The)d(second)f(axis)g(v)-5 b(alue.)259 5593
+b(\014rst)f(axis)g(has)g(index)h(1.)259 3751 y Fc(V1)k(=)g(DOUBLE)g
+(PRECISION)f(\(Giv)m(en\))427 3851 y Fj(The)d(\014rst)f(axis)g(v)-5
+b(alue.)259 3995 y Fc(V2)32 b(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427
+4095 y Fj(The)d(second)f(axis)g(v)-5 b(alue.)259 4239
y Fc(ST)d(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-5693 y Fj(The)c(global)e(status.)p eop end
-%%Page: 193 203
-TeXDict begin 193 202 bop 3643 52 a FG(193)0 351 y Fc(Returned)32
-b(V)-8 b(alue:)259 530 y(AST)p Ft(_)p Fc(AXDIST)g(ANCE)33
-b(=)f(DOUBLE)g(PRECISION)427 630 y Fj(The)c(distance)f(from)h(the)f
+4338 y Fj(The)c(global)e(status.)0 4523 y Fc(Returned)32
+b(V)-8 b(alue:)259 4682 y(AST)p Ft(_)p Fc(AXDIST)g(ANCE)33
+b(=)f(DOUBLE)g(PRECISION)427 4782 y Fj(The)c(distance)f(from)h(the)f
(\014rst)h(to)f(the)h(second)f(axis)g(v)-5 b(alue.)0
-834 y Fc(Notes:)340 1159 y Fi(\017)45 b Fj(This)33 b(function)g(will)f
+4967 y Fc(Notes:)340 5272 y Fi(\017)45 b Fj(This)33 b(function)g(will)f
(return)g(a)g Ft(")p Fj(bad)p Ft(")f Fj(result)h(v)-5
b(alue)33 b(\(AST)p Ft(__)p Fj(BAD\))g(if)f(an)n(y)g(of)g(the)h(input)g
-(v)-5 b(alues)32 b(has)427 1259 y(this)c(v)-5 b(alue.)340
-1413 y Fi(\017)45 b Fj(A)29 b Ft(")p Fj(bad)p Ft(")f
+(v)-5 b(alues)32 b(has)427 5372 y(this)c(v)-5 b(alue.)340
+5516 y Fi(\017)45 b Fj(A)29 b Ft(")p Fj(bad)p Ft(")f
Fj(v)-5 b(alue)28 b(will)h(also)e(b)r(e)i(returned)f(if)h(this)g
(function)g(is)f(in)n(v)n(ok)n(ed)f(with)i(ST)-7 b(A)g(TUS)30
-b(set)e(to)g(an)h(error)427 1513 y(v)-5 b(alue,)28 b(or)f(if)h(it)g
-(should)f(fail)h(for)f(an)n(y)g(reason.)p 0 1755 3780
-12 v 0 1885 a FA(AST)p Fe(_)p FA(AX)l(OFFSET)1248 1886
-y Fd(Add)38 b(an)h(incremen)m(t)e(on)m(to)g(a)1408 1986
-y(supplied)h(axis)g(v)-7 b(alue)2722 1885 y FA(AST)p
-Fe(_)p FA(AX)l(OFFSET)0 2217 y Fc(Description:)44 b Fj(This)19
-b(routine)f(returns)g(an)g(axis)g(v)-5 b(alue)19 b(formed)f(b)n(y)g
-(adding)h(a)f(signed)g(axis)g(incremen)n(t)g(on)n(to)g(a)g(supplied)227
-2317 y(axis)27 b(v)-5 b(alue.)227 2463 y(F)e(or)29 b(a)h(simple)g(F)-7
-b(rame,)29 b(this)i(is)e(a)h(trivial)f(op)r(eration)f(returning)h(the)i
-(sum)e(of)h(the)g(t)n(w)n(o)f(supplied)h(v)-5 b(alues.)43
-b(But)227 2562 y(for)27 b(other)g(deriv)n(ed)g(classes)f(of)i(F)-7
+b(set)e(to)g(an)h(error)427 5616 y(v)-5 b(alue,)28 b(or)f(if)h(it)g
+(should)f(fail)h(for)f(an)n(y)g(reason.)p eop end
+%%Page: 194 204
+TeXDict begin 194 203 bop 0 52 a FG(194)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(AX)l(OFFSET)1248 483 y Fd(Add)38
+b(an)h(incremen)m(t)e(on)m(to)g(a)1408 583 y(supplied)h(axis)g(v)-7
+b(alue)2722 482 y FA(AST)p Fe(_)p FA(AX)l(OFFSET)0 761
+y Fc(Description:)44 b Fj(This)19 b(routine)f(returns)g(an)g(axis)g(v)
+-5 b(alue)19 b(formed)f(b)n(y)g(adding)h(a)f(signed)g(axis)g(incremen)n
+(t)g(on)n(to)g(a)g(supplied)227 860 y(axis)27 b(v)-5
+b(alue.)227 982 y(F)e(or)29 b(a)h(simple)g(F)-7 b(rame,)29
+b(this)i(is)e(a)h(trivial)f(op)r(eration)f(returning)h(the)i(sum)e(of)h
+(the)g(t)n(w)n(o)f(supplied)h(v)-5 b(alues.)43 b(But)227
+1082 y(for)27 b(other)g(deriv)n(ed)g(classes)f(of)i(F)-7
b(rame)27 b(\(suc)n(h)h(as)f(a)g(SkyF)-7 b(rame\))27
-b(this)h(is)f(not)h(the)g(case.)0 2754 y Fc(In)m(v)m(o)s(cation:)123
+b(this)h(is)f(not)h(the)g(case.)0 1226 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_AXOFFSET\()38 b(THIS,)k(AXIS,)f(V1,)i(DIST,)e
-(STATUS)g(\))0 2946 y Fc(Argumen)m(ts:)259 3125 y(THIS)32
-b(=)g(INTEGER)g(\(Giv)m(en\))427 3225 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(F)-7 b(rame.)259 3379 y Fc(AXIS)33 b(=)f(INTEGER)f(\(Giv)m
-(en\))427 3479 y Fj(The)d(index)g(of)f(the)h(axis)f(to)g(whic)n(h)h
+(STATUS)g(\))0 1370 y Fc(Argumen)m(ts:)259 1501 y(THIS)32
+b(=)g(INTEGER)g(\(Giv)m(en\))427 1600 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(F)-7 b(rame.)259 1728 y Fc(AXIS)33 b(=)f(INTEGER)f(\(Giv)m
+(en\))427 1827 y Fj(The)d(index)g(of)f(the)h(axis)f(to)g(whic)n(h)h
(the)g(supplied)g(v)-5 b(alues)27 b(refer.)36 b(The)28
-b(\014rst)f(axis)g(has)g(index)h(1.)259 3633 y Fc(V1)k(=)g(DOUBLE)g
-(PRECISION)f(\(Giv)m(en\))427 3732 y Fj(The)d(original)e(axis)h(v)-5
-b(alue.)259 3886 y Fc(DIST)33 b(=)f(DOUBLE)g(PRECISION)f(\(Giv)m(en\))
-427 3986 y Fj(The)d(axis)f(incremen)n(t)g(to)h(add)f(to)g(the)h
-(original)e(axis)h(v)-5 b(alue.)259 4140 y Fc(ST)d(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 4240
-y Fj(The)c(global)e(status.)0 4444 y Fc(Returned)32 b(V)-8
-b(alue:)259 4623 y(AST)p Ft(_)p Fc(AX)m(OFFSET)33 b(=)f(DOUBLE)g
-(PRECISION)427 4723 y Fj(The)c(incremen)n(ted)f(axis)g(v)-5
-b(alue.)0 4927 y Fc(Notes:)340 5252 y Fi(\017)45 b Fj(This)33
+b(\014rst)f(axis)g(has)g(index)h(1.)259 1955 y Fc(V1)k(=)g(DOUBLE)g
+(PRECISION)f(\(Giv)m(en\))427 2055 y Fj(The)d(original)e(axis)h(v)-5
+b(alue.)259 2182 y Fc(DIST)33 b(=)f(DOUBLE)g(PRECISION)f(\(Giv)m(en\))
+427 2282 y Fj(The)d(axis)f(incremen)n(t)g(to)h(add)f(to)g(the)h
+(original)e(axis)h(v)-5 b(alue.)259 2409 y Fc(ST)d(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 2509
+y Fj(The)c(global)e(status.)0 2665 y Fc(Returned)32 b(V)-8
+b(alue:)259 2796 y(AST)p Ft(_)p Fc(AX)m(OFFSET)33 b(=)f(DOUBLE)g
+(PRECISION)427 2896 y Fj(The)c(incremen)n(ted)f(axis)g(v)-5
+b(alue.)0 3052 y Fc(Notes:)340 3329 y Fi(\017)45 b Fj(This)33
b(function)g(will)f(return)g(a)g Ft(")p Fj(bad)p Ft(")f
Fj(result)h(v)-5 b(alue)33 b(\(AST)p Ft(__)p Fj(BAD\))g(if)f(an)n(y)g
-(of)g(the)h(input)g(v)-5 b(alues)32 b(has)427 5352 y(this)c(v)-5
-b(alue.)340 5506 y Fi(\017)45 b Fj(A)29 b Ft(")p Fj(bad)p
+(of)g(the)h(input)g(v)-5 b(alues)32 b(has)427 3429 y(this)c(v)-5
+b(alue.)340 3556 y Fi(\017)45 b Fj(A)29 b Ft(")p Fj(bad)p
Ft(")f Fj(v)-5 b(alue)28 b(will)h(also)e(b)r(e)i(returned)f(if)h(this)g
(function)g(is)f(in)n(v)n(ok)n(ed)f(with)i(ST)-7 b(A)g(TUS)30
-b(set)e(to)g(an)h(error)427 5606 y(v)-5 b(alue,)28 b(or)f(if)h(it)g
-(should)f(fail)h(for)f(an)n(y)g(reason.)p eop end
-%%Page: 194 204
-TeXDict begin 194 203 bop 0 52 a FG(194)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(BBUF)868 483 y Fd(Begin)38
+b(set)e(to)g(an)h(error)427 3656 y(v)-5 b(alue,)28 b(or)f(if)h(it)g
+(should)f(fail)h(for)f(an)n(y)g(reason.)p 0 3844 V 0
+3975 a FA(AST)p Fe(_)p FA(BBUF)868 3976 y Fd(Begin)38
b(a)h(new)f(graphical)e(bu\013ering)i(con)m(text)3069
-482 y FA(AST)p Fe(_)p FA(BBUF)0 667 y Fc(Description:)44
+3975 y FA(AST)p Fe(_)p FA(BBUF)0 4154 y Fc(Description:)44
b Fj(This)39 b(routine)g(starts)f(a)g(new)h(graphics)e(bu\013ering)i
(con)n(text.)70 b(A)39 b(matc)n(hing)g(call)f(to)h(the)g(routine)227
-766 y(AST)p Ft(_)p Fj(EBUF)28 b(should)f(b)r(e)h(used)g(to)f(end)h(the)
-g(con)n(text.)0 913 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
-b(AST_BBUF\()e(THIS)h(STATUS)h(\))0 1060 y Fc(Argumen)m(ts:)259
-1194 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1293
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259 1424 y Fc(ST)-8
-b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-1523 y Fj(The)c(global)e(status.)0 1683 y Fc(Notes:)340
-1962 y Fi(\017)45 b Fj(The)30 b(nature)g(of)g(the)g(bu\013ering)g(is)f
+4254 y(AST)p Ft(_)p Fj(EBUF)28 b(should)f(b)r(e)h(used)g(to)f(end)h
+(the)g(con)n(text.)0 4398 y Fc(In)m(v)m(o)s(cation:)123
+b Ft(CALL)42 b(AST_BBUF\()e(THIS)h(STATUS)h(\))0 4542
+y Fc(Argumen)m(ts:)259 4673 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
+4773 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259 4900
+y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
+427 5000 y Fj(The)c(global)e(status.)0 5156 y Fc(Notes:)340
+5433 y Fi(\017)45 b Fj(The)30 b(nature)g(of)g(the)g(bu\013ering)g(is)f
(determined)i(b)n(y)e(the)i(underlying)e(graphics)f(system)i(\(as)g
-(de\014ned)g(b)n(y)427 2062 y(the)23 b(curren)n(t)e(grf)g(mo)r(dule\).)
+(de\014ned)g(b)n(y)427 5533 y(the)23 b(curren)n(t)e(grf)g(mo)r(dule\).)
36 b(Eac)n(h)21 b(call)g(to)h(this)h(routine)e(to)h(this)g(routine)g
-(simply)g(in)n(v)n(ok)n(es)e(the)j(astGBBuf)427 2162
-y(function)28 b(in)g(the)g(grf)f(mo)r(dule.)p 0 2356
-V 0 2486 a FA(AST)p Fe(_)p FA(BEGIN)451 b Fd(Begin)38
+(simply)g(in)n(v)n(ok)n(es)e(the)j(astGBBuf)427 5632
+y(function)28 b(in)g(the)g(grf)f(mo)r(dule.)p eop end
+%%Page: 195 205
+TeXDict begin 195 204 bop 3643 52 a FG(195)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(BEGIN)451 b Fd(Begin)38
b(a)g(new)h(AST)f(con)m(text)451 b FA(AST)p Fe(_)p FA(BEGIN)0
-2670 y Fc(Description:)44 b Fj(This)34 b(routine)g(b)r(egins)g(a)g(new)
-g(AST)g(con)n(text.)56 b(An)n(y)34 b(Ob)5 b(ject)34 b(p)r(oin)n(ters)g
-(created)f(within)i(this)f(con-)227 2769 y(text)f(will)f(b)r(e)h(ann)n
+675 y Fc(Description:)44 b Fj(This)34 b(routine)g(b)r(egins)g(a)g(new)g
+(AST)g(con)n(text.)56 b(An)n(y)34 b(Ob)5 b(ject)34 b(p)r(oin)n(ters)g
+(created)f(within)i(this)f(con-)227 775 y(text)f(will)f(b)r(e)h(ann)n
(ulled)f(when)g(it)h(is)f(later)g(ended)g(using)g(AST)p
Ft(_)p Fj(END)h(\(just)g(as)e(if)i(AST)p Ft(_)p Fj(ANNUL)g(had)f(b)r
-(een)227 2869 y(in)n(v)n(ok)n(ed\),)39 b(unless)e(they)h(ha)n(v)n(e)e
+(een)227 874 y(in)n(v)n(ok)n(ed\),)39 b(unless)e(they)h(ha)n(v)n(e)e
(\014rst)h(b)r(een)h(exp)r(orted)f(using)h(AST)p Ft(_)p
Fj(EXPOR)-7 b(T)36 b(or)h(rendered)f(exempt)i(using)227
-2969 y(AST)p Ft(_)p Fj(EXEMPT.)22 b(If)h(ann)n(ulling)g(a)f(p)r(oin)n
+974 y(AST)p Ft(_)p Fj(EXEMPT.)22 b(If)h(ann)n(ulling)g(a)f(p)r(oin)n
(ter)h(causes)f(an)g(Ob)5 b(ject's)23 b(RefCoun)n(t)g(attribute)g(to)g
-(fall)g(to)g(zero)e(\(whic)n(h)227 3068 y(happ)r(ens)28
+(fall)g(to)g(zero)e(\(whic)n(h)227 1074 y(happ)r(ens)28
b(when)g(the)g(last)f(p)r(oin)n(ter)g(to)h(it)g(is)f(ann)n(ulled\),)h
(then)g(the)g(Ob)5 b(ject)27 b(will)h(b)r(e)g(deleted.)0
-3215 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_BEGIN\()d(STATUS)
-i(\))0 3362 y Fc(Argumen)m(ts:)259 3496 y(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 3595
-y Fj(The)c(global)e(status.)0 3755 y Fc(Class)31 b(Applicabilit)m(y:)
-259 3889 y(Ob)5 b(ject)427 3988 y Fj(This)28 b(routine)f(applies)g(to)h
-(all)f(Ob)5 b(jects.)0 4147 y Fc(Notes:)340 4427 y Fi(\017)45
+1228 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_BEGIN\()d(STATUS)
+i(\))0 1382 y Fc(Argumen)m(ts:)259 1523 y(ST)-8 b(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 1623
+y Fj(The)c(global)e(status.)0 1789 y Fc(Class)31 b(Applicabilit)m(y:)
+259 1930 y(Ob)5 b(ject)427 2030 y Fj(This)28 b(routine)f(applies)g(to)h
+(all)f(Ob)5 b(jects.)0 2196 y Fc(Notes:)340 2484 y Fi(\017)45
b Fj(This)28 b(routine)f(attempts)h(to)g(execute)f(ev)n(en)g(if)h(ST)-7
b(A)g(TUS)29 b(is)e(set)h(to)f(an)h(error)d(v)-5 b(alue.)340
-4558 y Fi(\017)45 b Fj(Con)n(texts)27 b(delimited)i(b)n(y)e(AST)p
+2619 y Fi(\017)45 b Fj(Con)n(texts)27 b(delimited)i(b)n(y)e(AST)p
Ft(_)p Fj(BEGIN)g(and)h(AST)p Ft(_)p Fj(END)g(ma)n(y)e(b)r(e)i(nested)g
-(to)g(an)n(y)e(depth.)p 0 4752 V 0 4882 a FA(AST)p Fe(_)p
-FA(BORDER)1177 4883 y Fd(Dra)m(w)38 b(a)g(b)s(order)g(around)g(v)-7
-b(alid)1468 4983 y(regions)37 b(of)h(a)h(Plot)2860 4882
-y FA(AST)p Fe(_)p FA(BORDER)0 5171 y Fc(Description:)44
+(to)g(an)n(y)e(depth.)p 0 2823 V 0 2953 a FA(AST)p Fe(_)p
+FA(BORDER)1177 2954 y Fd(Dra)m(w)38 b(a)g(b)s(order)g(around)g(v)-7
+b(alid)1468 3054 y(regions)37 b(of)h(a)h(Plot)2860 2953
+y FA(AST)p Fe(_)p FA(BORDER)0 3252 y Fc(Description:)44
b Fj(This)32 b(function)h(dra)n(ws)e(a)h(\(line\))h(b)r(order)e(around)
g(regions)g(of)h(the)g(plotting)h(area)d(of)i(a)g(Plot)g(whic)n(h)227
-5271 y(corresp)r(ond)d(to)h(v)-5 b(alid,)30 b(unclipp)r(ed)h(ph)n
+3352 y(corresp)r(ond)d(to)h(v)-5 b(alid,)30 b(unclipp)r(ed)h(ph)n
(ysical)f(co)r(ordinates.)42 b(F)-7 b(or)30 b(example,)g(when)g
-(plotting)g(using)g(an)g(all-sky)227 5371 y(map)g(pro)5
+(plotting)g(using)g(an)g(all-sky)227 3451 y(map)g(pro)5
b(jection,)29 b(this)h(function)g(could)f(b)r(e)h(used)g(to)f(dra)n(w)g
(the)h(b)r(oundary)f(of)g(the)h(celestial)f(sphere)g(when)h(it)227
-5470 y(is)e(pro)5 b(jected)27 b(on)g(to)g(the)h(plotting)g(surface.)227
-5593 y(If)k(the)g(en)n(tire)f(plotting)g(area)f(con)n(tains)h(v)-5
+3551 y(is)e(pro)5 b(jected)27 b(on)g(to)g(the)h(plotting)g(surface.)227
+3678 y(If)k(the)g(en)n(tire)f(plotting)g(area)f(con)n(tains)h(v)-5
b(alid,)32 b(unclipp)r(ed)g(ph)n(ysical)f(co)r(ordinates,)g(then)h(the)
-g(b)r(oundary)e(will)227 5693 y(just)e(b)r(e)g(a)g(rectangular)d(b)r(o)
-n(x)i(around)g(the)h(edges)f(of)g(the)h(plotting)g(area.)p
-eop end
-%%Page: 195 205
-TeXDict begin 195 204 bop 3643 52 a FG(195)227 351 y
-Fj(If)19 b(the)g(Plot)f(is)h(a)f(Plot3D,)g(this)h(metho)r(d)g(is)f
+g(b)r(oundary)e(will)227 3777 y(just)e(b)r(e)g(a)g(rectangular)d(b)r(o)
+n(x)i(around)g(the)h(edges)f(of)g(the)h(plotting)g(area.)227
+3904 y(If)19 b(the)g(Plot)f(is)h(a)f(Plot3D,)g(this)h(metho)r(d)g(is)f
(applied)h(individually)g(to)f(eac)n(h)g(of)g(the)h(three)g(2D)f(Plots)
-g(encapsulated)227 451 y(within)23 b(the)g(Plot3D)f(\(eac)n(h)f(of)i
+g(encapsulated)227 4004 y(within)23 b(the)g(Plot3D)f(\(eac)n(h)f(of)i
(these)f(Plots)f(corresp)r(onds)g(to)h(a)g(single)g(2D)g(plane)g(in)h
-(the)f(3D)h(graphics)d(system\).)227 551 y(In)36 b(addition,)i(if)e
+(the)f(3D)h(graphics)d(system\).)227 4104 y(In)36 b(addition,)i(if)e
(the)g(en)n(tire)f(plotting)h(v)n(olume)e(has)i(v)-5
b(alid)35 b(co)r(ordinates)f(in)i(the)g(3D)g(curren)n(t)f(F)-7
-b(rame)35 b(of)g(the)227 650 y(Plot3D,)g(then)i(additional)e(lines)g
+b(rame)35 b(of)g(the)227 4203 y(Plot3D,)g(then)i(additional)e(lines)g
(are)g(dra)n(wn)g(along)f(the)i(edges)f(of)h(the)g(3D)f(plotting)h(v)n
-(olume)f(so)g(that)h(the)227 750 y(en)n(tire)27 b(plotting)h(v)n(olume)
-f(is)h(enclosed)e(within)j(a)e(cub)r(oid)h(grid.)0 901
-y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_BORDER\()c
-(THIS,)j(STATUS)f(\))0 1052 y Fc(Argumen)m(ts:)259 1190
-y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1290 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(Plot.)259 1424 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f
-(\(Giv)m(en)h(and)g(Returned\))427 1523 y Fj(The)c(global)e(status.)0
-1687 y Fc(Returned)32 b(V)-8 b(alue:)259 1825 y(AST)p
-Ft(_)p Fc(BORDER)31 b(=)h(LOGICAL)427 1925 y Fj(.F)-9
+(olume)f(so)g(that)h(the)227 4303 y(en)n(tire)27 b(plotting)h(v)n
+(olume)f(is)h(enclosed)e(within)j(a)e(cub)r(oid)h(grid.)0
+4457 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_BORDER\()c
+(THIS,)j(STATUS)f(\))0 4611 y Fc(Argumen)m(ts:)259 4752
+y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 4852 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(Plot.)259 4987 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f
+(\(Giv)m(en)h(and)g(Returned\))427 5086 y Fj(The)c(global)e(status.)0
+5253 y Fc(Returned)32 b(V)-8 b(alue:)259 5394 y(AST)p
+Ft(_)p Fc(BORDER)31 b(=)h(LOGICAL)427 5494 y Fj(.F)-9
b(ALSE.)37 b(is)g(returned)g(if)h(the)g(plotting)f(space)f(is)h
(completely)g(\014lled)h(b)n(y)f(v)-5 b(alid,)39 b(unclipp)r(ed)f(ph)n
-(ysical)427 2024 y(co)r(ordinates)23 b(\(so)h(that)g(only)g(a)g
+(ysical)427 5593 y(co)r(ordinates)23 b(\(so)h(that)g(only)g(a)g
(rectangular)e(b)r(o)n(x)i(w)n(as)f(dra)n(wn)g(around)h(the)g(edge\).)
-36 b(Otherwise,)24 b(.TR)n(UE.)427 2124 y(is)k(returned.)0
-2288 y Fc(Notes:)340 2572 y Fi(\017)45 b Fj(A)28 b(v)-5
-b(alue)28 b(of)f(.F)-9 b(ALSE.)28 b(will)g(b)r(e)g(returned)f(if)h
-(this)g(function)g(is)f(in)n(v)n(ok)n(ed)g(with)h(ST)-7
-b(A)g(TUS)28 b(set)g(to)f(an)h(error)427 2671 y(v)-5
-b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)340
-2805 y Fi(\017)45 b Fj(An)23 b(error)e(results)h(if)i(either)e(the)h
-(curren)n(t)f(F)-7 b(rame)22 b(or)g(the)h(base)f(F)-7
+36 b(Otherwise,)24 b(.TR)n(UE.)427 5693 y(is)k(returned.)p
+eop end
+%%Page: 196 206
+TeXDict begin 196 205 bop 0 52 a FG(196)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Notes:)340
+634 y Fi(\017)45 b Fj(A)28 b(v)-5 b(alue)28 b(of)f(.F)-9
+b(ALSE.)28 b(will)g(b)r(e)g(returned)f(if)h(this)g(function)g(is)f(in)n
+(v)n(ok)n(ed)g(with)h(ST)-7 b(A)g(TUS)28 b(set)g(to)f(an)h(error)427
+733 y(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
+(reason.)340 866 y Fi(\017)45 b Fj(An)23 b(error)e(results)h(if)i
+(either)e(the)h(curren)n(t)f(F)-7 b(rame)22 b(or)g(the)h(base)f(F)-7
b(rame)23 b(of)f(the)h(Plot)g(is)f(not)h(2-dimensional)427
-2905 y(or)k(\(for)g(a)h(Plot3D\))f(3-dimensional.)340
-3038 y Fi(\017)45 b Fj(An)30 b(error)d(also)g(results)i(if)g(the)g
+965 y(or)k(\(for)g(a)h(Plot3D\))f(3-dimensional.)340
+1098 y Fi(\017)45 b Fj(An)30 b(error)d(also)g(results)i(if)g(the)g
(transformation)f(b)r(et)n(w)n(een)h(the)g(base)f(and)h(curren)n(t)f(F)
--7 b(rames)28 b(of)h(the)g(Plot)427 3138 y(is)f(not)f(de\014ned)h
+-7 b(rames)28 b(of)h(the)g(Plot)427 1198 y(is)f(not)f(de\014ned)h
(\(i.e.)38 b(the)28 b(Plot's)e(T)-7 b(ranF)g(orw)n(ard)25
-b(attribute)j(is)g(zero\).)p 0 3339 3780 12 v 0 3470
-a FA(AST)p Fe(_)p FA(BOUNDINGBO)l(X)1661 3469 y Fd(Return)39
-b(a)1651 3569 y(b)s(ounding)1708 3684 y(b)s(o)m(x)f(for)1629
-3783 y(previously)1732 3898 y(dra)m(wn)1678 3997 y(graphics)2385
-3470 y FA(AST)p Fe(_)p FA(BOUNDINGBO)l(X)0 4188 y Fc(Description:)44
+b(attribute)j(is)g(zero\).)p 0 1396 3780 12 v 0 1527
+a FA(AST)p Fe(_)p FA(BOUNDINGBO)l(X)264 b Fd(Return)39
+b(a)1651 1626 y(b)s(ounding)1708 1741 y(b)s(o)m(x)f(for)1629
+1840 y(previously)1732 1955 y(dra)m(wn)1678 2055 y(graphics)2385
+1527 y FA(AST)p Fe(_)p FA(BOUNDINGBO)l(X)0 2243 y Fc(Description:)44
b Fj(This)30 b(routine)e(returns)h(the)h(b)r(ounds)f(of)g(a)g(b)r(o)n
(x)g(whic)n(h)g(just)h(encompasess)d(the)j(graphics)e(pro)r(duced)227
-4288 y(b)n(y)21 b(the)g(previous)f(call)h(to)g(an)n(y)f(of)h(the)h
+2343 y(b)n(y)21 b(the)g(previous)f(call)h(to)g(an)n(y)f(of)h(the)h
(Plot)e(metho)r(ds)h(whic)n(h)g(pro)r(duce)g(graphical)f(output.)35
-b(If)21 b(no)g(suc)n(h)g(previous)227 4387 y(call)26
+b(If)21 b(no)g(suc)n(h)g(previous)227 2442 y(call)26
b(has)f(y)n(et)g(b)r(een)i(made,)f(or)e(if)j(the)f(call)f(failed)h(for)
f(an)n(y)g(reason,)g(then)h(the)g(b)r(ounding)g(b)r(o)n(x)g(returned)f
-(b)n(y)g(this)227 4487 y(routine)i(is)h(unde\014ned.)0
-4638 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_BOUNDINGBOX)o(\()
-c(THIS,)j(LBND,)h(UBND,)f(STATUS)g(\))0 4789 y Fc(Argumen)m(ts:)259
-4927 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 5027
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259 5161 y Fc(LBND\()k(2)g(\))
-g(=)g(REAL)g(\(Returned\))427 5260 y Fj(A)26 b(t)n(w)n(o)f(elemen)n(t)g
+(b)n(y)g(this)227 2542 y(routine)i(is)h(unde\014ned.)0
+2691 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_BOUNDINGBOX)o(\()
+c(THIS,)j(LBND,)h(UBND,)f(STATUS)g(\))0 2840 y Fc(Argumen)m(ts:)259
+2976 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 3076
+y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259 3209 y Fc(LBND\()k(2)g(\))
+g(=)g(REAL)g(\(Returned\))427 3308 y Fj(A)26 b(t)n(w)n(o)f(elemen)n(t)g
(arra)n(y)e(in)j(whic)n(h)f(is)g(returned)g(the)h(lo)n(w)n(er)e(limits)
i(of)f(the)h(b)r(ounding)f(b)r(o)n(x)g(on)g(eac)n(h)g(of)g(the)427
-5360 y(t)n(w)n(o)i(axes)g(of)g(the)h(graphics)e(co)r(ordinate)h(system)
+3408 y(t)n(w)n(o)i(axes)g(of)g(the)h(graphics)e(co)r(ordinate)h(system)
g(\(the)h(base)f(F)-7 b(rame)28 b(of)f(the)h(Plot\).)259
-5494 y Fc(UBND\()k(2)g(\))g(=)g(REAL)g(\(Returned\))427
-5593 y Fj(A)h(t)n(w)n(o)f(elemen)n(t)g(arra)n(y)e(in)j(whic)n(h)f(is)h
+3540 y Fc(UBND\()k(2)g(\))g(=)g(REAL)g(\(Returned\))427
+3640 y Fj(A)h(t)n(w)n(o)f(elemen)n(t)g(arra)n(y)e(in)j(whic)n(h)f(is)h
(returned)f(the)h(upp)r(er)f(limits)h(of)g(the)f(b)r(ounding)h(b)r(o)n
-(x)f(on)g(eac)n(h)g(of)427 5693 y(the)c(t)n(w)n(o)f(axes)g(of)g(the)h
+(x)f(on)g(eac)n(h)g(of)427 3740 y(the)c(t)n(w)n(o)f(axes)g(of)g(the)h
(graphics)e(co)r(ordinate)h(system)g(\(the)h(base)f(F)-7
-b(rame)27 b(of)h(the)g(Plot\).)p eop end
-%%Page: 196 206
-TeXDict begin 196 205 bop 0 52 a FG(196)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(ST)-8
-b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-451 y Fj(The)c(global)e(status.)0 611 y Fc(Notes:)340
-892 y Fi(\017)45 b Fj(An)28 b(error)e(results)h(if)h(the)g(base)f(F)-7
+b(rame)27 b(of)h(the)g(Plot\).)259 3872 y Fc(ST)-8 b(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 3972
+y Fj(The)c(global)e(status.)0 4133 y Fc(Notes:)340 4416
+y Fi(\017)45 b Fj(An)28 b(error)e(results)h(if)h(the)g(base)f(F)-7
b(rame)27 b(of)h(the)g(Plot)f(is)g(not)h(2-dimensional.)p
-0 1089 3780 12 v 0 1219 a FA(AST)p Fe(_)p FA(BO)l(X)924
-b Fd(Create)38 b(a)g(Bo)m(x)926 b FA(AST)p Fe(_)p FA(BO)l(X)0
-1393 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
-(Bo)n(x)g(and)g(optionally)g(initialises)g(its)h(attributes.)227
-1517 y(The)35 b(Bo)n(x)f(class)g(implemen)n(ts)i(a)e(Region)g(whic)n(h)
+0 4614 V 0 4745 a FA(AST)p Fe(_)p FA(BO)l(X)924 b Fd(Create)38
+b(a)g(Bo)m(x)926 b FA(AST)p Fe(_)p FA(BO)l(X)0 4921 y
+Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g(Bo)n
+(x)g(and)g(optionally)g(initialises)g(its)h(attributes.)227
+5046 y(The)35 b(Bo)n(x)f(class)g(implemen)n(ts)i(a)e(Region)g(whic)n(h)
h(represen)n(ts)f(a)g(b)r(o)n(x)h(with)g(sides)g(parallel)f(to)h(the)g
-(axes)f(of)h(a)227 1617 y(F)-7 b(rame)36 b(\(i.e.)64
+(axes)f(of)h(a)227 5145 y(F)-7 b(rame)36 b(\(i.e.)64
b(an)36 b(area)f(whic)n(h)i(encloses)e(a)h(giv)n(en)g(range)f(of)h(v)-5
b(alues)37 b(on)f(eac)n(h)f(axis\).)63 b(A)37 b(Bo)n(x)f(is)g(similar)g
-(to)227 1716 y(an)h(In)n(terv)-5 b(al,)40 b(the)d(only)g(real)g
+(to)227 5245 y(an)h(In)n(terv)-5 b(al,)40 b(the)d(only)g(real)g
(di\013erence)g(b)r(eing)g(that)h(the)g(In)n(terv)-5
b(al)36 b(class)h(allo)n(ws)f(some)h(axis)f(limits)i(to)f(b)r(e)227
-1816 y(unsp)r(eci\014ed.)g(Note,)26 b(a)e(Bo)n(x)h(will)g(only)g(lo)r
+5345 y(unsp)r(eci\014ed.)g(Note,)26 b(a)e(Bo)n(x)h(will)g(only)g(lo)r
(ok)f(lik)n(e)h(a)g(b)r(o)n(x)g(if)g(the)h(F)-7 b(rame)25
b(geometry)f(is)h(appro)n(ximately)e(\015at.)36 b(F)-7
-b(or)227 1915 y(instance,)34 b(a)e(Bo)n(x)f(cen)n(tred)h(close)f(to)h
+b(or)227 5444 y(instance,)34 b(a)e(Bo)n(x)f(cen)n(tred)h(close)f(to)h
(a)g(p)r(ole)h(in)f(a)g(SkyF)-7 b(rame)32 b(will)g(lo)r(ok)g(more)f
(lik)n(e)h(a)g(fan)h(than)f(a)g(b)r(o)n(x)g(\(the)227
-2015 y(P)n(olygon)26 b(class)g(can)i(b)r(e)g(used)f(to)h(create)e(a)h
+5544 y(P)n(olygon)26 b(class)g(can)i(b)r(e)g(used)f(to)h(create)e(a)h
(b)r(o)n(x-lik)n(e)g(region)f(close)h(to)g(a)h(p)r(ole\).)0
-2163 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_BOX\()d
-(FRAME,)h(FORM,)h(POINT1,)f(POINT2,)f(UNC,)i(OPTIONS,)f(STATUS)g(\))0
-2311 y Fc(Argumen)m(ts:)259 2446 y(FRAME)31 b(=)h(INTEGER)g(\(Giv)m
-(en\))427 2546 y Fj(A)d(p)r(oin)n(ter)g(to)f(the)i(F)-7
-b(rame)28 b(in)h(whic)n(h)g(the)g(region)e(is)i(de\014ned.)41
-b(A)29 b(deep)g(cop)n(y)f(is)g(tak)n(en)g(of)h(the)g(supplied)427
-2645 y(F)-7 b(rame.)71 b(This)39 b(means)f(that)h(an)n(y)g(subsequen)n
-(t)f(c)n(hanges)g(made)h(to)f(the)i(F)-7 b(rame)38 b(using)h(the)g
-(supplied)427 2745 y(p)r(oin)n(ter)27 b(will)h(ha)n(v)n(e)f(no)g
-(e\013ect)h(the)g(Region.)259 2876 y Fc(F)m(ORM)j(=)h(INTEGER)g(\(Giv)m
-(en\))427 2976 y Fj(Indicates)g(ho)n(w)g(the)g(b)r(o)n(x)g(is)g
-(describ)r(ed)f(b)n(y)h(the)h(remaining)e(parameters.)48
-b(A)33 b(v)-5 b(alue)32 b(of)g(zero)f(indicates)427 3075
-y(that)d(the)g(b)r(o)n(x)f(is)h(sp)r(eci\014ed)g(b)n(y)f(a)g(cen)n(tre)
-g(p)r(osition)h(and)f(a)h(corner)e(p)r(osition.)36 b(A)28
-b(v)-5 b(alue)28 b(of)g(one)f(indicates)427 3175 y(that)h(the)g(b)r(o)n
-(x)f(is)h(sp)r(eci\014ed)g(b)n(y)f(a)g(t)n(w)n(o)g(opp)r(osite)g
-(corner)f(p)r(ositions.)259 3306 y Fc(POINT1\()32 b Fi(\003)f
-Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m(en\))427 3406
-y Fj(An)23 b(arra)n(y)d(with)j(one)f(elemen)n(t)h(for)f(eac)n(h)g(F)-7
-b(rame)22 b(axis)f(\(Naxes)i(attribute\).)35 b(If)23
-b(F)n(ORM)f(is)h(zero,)f(this)h(arra)n(y)427 3506 y(should)31
-b(con)n(tain)f(the)h(co)r(ordinates)e(at)i(the)g(cen)n(tre)f(of)h(the)g
-(b)r(o)n(x.)45 b(If)32 b(F)n(ORM)e(is)h(one,)g(it)g(should)f(con)n
-(tain)427 3605 y(the)e(co)r(ordinates)f(at)g(the)i(corner)d(of)i(the)g
-(b)r(o)n(x)f(whic)n(h)h(is)g(diagonally)e(opp)r(osite)h(the)h(corner)f
-(sp)r(eci\014ed)h(b)n(y)427 3705 y(POINT2.)259 3836 y
-Fc(POINT2\()k Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m(en\))
-427 3936 y Fj(An)d(arra)n(y)c(with)k(one)f(elemen)n(t)g(for)f(eac)n(h)h
-(F)-7 b(rame)26 b(axis)g(\(Naxes)h(attribute\))h(con)n(taining)e(the)h
-(co)r(ordinates)427 4036 y(at)h(an)n(y)f(corner)f(of)h(the)h(b)r(o)n
-(x.)259 4167 y Fc(UNC)k(=)g(INTEGER)f(\(Giv)m(en\))427
-4266 y Fj(An)i(optional)e(p)r(oin)n(ter)h(to)g(an)g(existing)g(Region)f
-(whic)n(h)h(sp)r(eci\014es)g(the)h(uncertain)n(ties)e(asso)r(ciated)g
-(with)427 4366 y(the)j(b)r(oundary)f(of)g(the)h(Bo)n(x)f(b)r(eing)g
-(created.)54 b(The)34 b(uncertain)n(t)n(y)e(in)i(an)n(y)f(p)r(oin)n(t)h
-(on)f(the)h(b)r(oundary)f(of)427 4466 y(the)g(Bo)n(x)e(is)h(found)h(b)n
-(y)f(shifting)h(the)f(supplied)h Ft(")p Fj(uncertain)n(t)n(y)p
+5693 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_BOX\()d
+(FRAME,)h(FORM,)h(POINT1,)f(POINT2,)f(UNC,)i(OPTIONS,)f(STATUS)g(\))p
+eop end
+%%Page: 197 207
+TeXDict begin 197 206 bop 3643 52 a FG(197)0 351 y Fc(Argumen)m(ts:)259
+503 y(FRAME)31 b(=)h(INTEGER)g(\(Giv)m(en\))427 603 y
+Fj(A)d(p)r(oin)n(ter)g(to)f(the)i(F)-7 b(rame)28 b(in)h(whic)n(h)g(the)
+g(region)e(is)i(de\014ned.)41 b(A)29 b(deep)g(cop)n(y)f(is)g(tak)n(en)g
+(of)h(the)g(supplied)427 702 y(F)-7 b(rame.)71 b(This)39
+b(means)f(that)h(an)n(y)g(subsequen)n(t)f(c)n(hanges)g(made)h(to)f(the)
+i(F)-7 b(rame)38 b(using)h(the)g(supplied)427 802 y(p)r(oin)n(ter)27
+b(will)h(ha)n(v)n(e)f(no)g(e\013ect)h(the)g(Region.)259
+942 y Fc(F)m(ORM)j(=)h(INTEGER)g(\(Giv)m(en\))427 1042
+y Fj(Indicates)g(ho)n(w)g(the)g(b)r(o)n(x)g(is)g(describ)r(ed)f(b)n(y)h
+(the)h(remaining)e(parameters.)48 b(A)33 b(v)-5 b(alue)32
+b(of)g(zero)f(indicates)427 1141 y(that)d(the)g(b)r(o)n(x)f(is)h(sp)r
+(eci\014ed)g(b)n(y)f(a)g(cen)n(tre)g(p)r(osition)h(and)f(a)h(corner)e
+(p)r(osition.)36 b(A)28 b(v)-5 b(alue)28 b(of)g(one)f(indicates)427
+1241 y(that)h(the)g(b)r(o)n(x)f(is)h(sp)r(eci\014ed)g(b)n(y)f(a)g(t)n
+(w)n(o)g(opp)r(osite)g(corner)f(p)r(ositions.)259 1382
+y Fc(POINT1\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m
+(en\))427 1481 y Fj(An)23 b(arra)n(y)d(with)j(one)f(elemen)n(t)h(for)f
+(eac)n(h)g(F)-7 b(rame)22 b(axis)f(\(Naxes)i(attribute\).)35
+b(If)23 b(F)n(ORM)f(is)h(zero,)f(this)h(arra)n(y)427
+1581 y(should)31 b(con)n(tain)f(the)h(co)r(ordinates)e(at)i(the)g(cen)n
+(tre)f(of)h(the)g(b)r(o)n(x.)45 b(If)32 b(F)n(ORM)e(is)h(one,)g(it)g
+(should)f(con)n(tain)427 1680 y(the)e(co)r(ordinates)f(at)g(the)i
+(corner)d(of)i(the)g(b)r(o)n(x)f(whic)n(h)h(is)g(diagonally)e(opp)r
+(osite)h(the)h(corner)f(sp)r(eci\014ed)h(b)n(y)427 1780
+y(POINT2.)259 1920 y Fc(POINT2\()k Fi(\003)f Fc(\))h(=)g(DOUBLE)h
+(PRECISION)e(\(Giv)m(en\))427 2020 y Fj(An)d(arra)n(y)c(with)k(one)f
+(elemen)n(t)g(for)f(eac)n(h)h(F)-7 b(rame)26 b(axis)g(\(Naxes)h
+(attribute\))h(con)n(taining)e(the)h(co)r(ordinates)427
+2120 y(at)h(an)n(y)f(corner)f(of)h(the)h(b)r(o)n(x.)259
+2260 y Fc(UNC)k(=)g(INTEGER)f(\(Giv)m(en\))427 2360 y
+Fj(An)i(optional)e(p)r(oin)n(ter)h(to)g(an)g(existing)g(Region)f(whic)n
+(h)h(sp)r(eci\014es)g(the)h(uncertain)n(ties)e(asso)r(ciated)g(with)427
+2459 y(the)j(b)r(oundary)f(of)g(the)h(Bo)n(x)f(b)r(eing)g(created.)54
+b(The)34 b(uncertain)n(t)n(y)e(in)i(an)n(y)f(p)r(oin)n(t)h(on)f(the)h
+(b)r(oundary)f(of)427 2559 y(the)g(Bo)n(x)e(is)h(found)h(b)n(y)f
+(shifting)h(the)f(supplied)h Ft(")p Fj(uncertain)n(t)n(y)p
Ft(")e Fj(Region)g(so)h(that)g(it)h(is)f(cen)n(tred)g(at)g(the)427
-4565 y(b)r(oundary)e(p)r(oin)n(t)h(b)r(eing)g(considered.)44
+2659 y(b)r(oundary)e(p)r(oin)n(t)h(b)r(eing)g(considered.)44
b(The)31 b(area)e(co)n(v)n(ered)g(b)n(y)h(the)h(shifted)g(uncertain)n
-(t)n(y)f(Region)g(then)427 4665 y(represen)n(ts)g(the)i(uncertain)n(t)n
+(t)n(y)f(Region)g(then)427 2758 y(represen)n(ts)g(the)i(uncertain)n(t)n
(y)f(in)g(the)h(b)r(oundary)f(p)r(osition.)48 b(The)31
b(uncertain)n(t)n(y)g(is)g(assumed)g(to)g(b)r(e)h(the)427
-4765 y(same)27 b(for)g(all)h(p)r(oin)n(ts.)427 4880 y(If)38
+2858 y(same)27 b(for)g(all)h(p)r(oin)n(ts.)427 2978 y(If)38
b(supplied,)j(the)d(uncertain)n(t)n(y)f(Region)g(m)n(ust)g(b)r(e)i(of)e
(a)g(class)g(for)g(whic)n(h)h(all)f(instances)g(are)g(cen)n(tro-)427
-4980 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24 b(Circle,)g(Ellipse,)h
+3078 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24 b(Circle,)g(Ellipse,)h
(etc.\))36 b(or)23 b(b)r(e)i(a)e(Prism)h(con)n(taining)f(cen)n
-(tro-symetric)f(comp)r(onen)n(t)427 5079 y(Regions.)57
+(tro-symetric)f(comp)r(onen)n(t)427 3177 y(Regions.)57
b(A)35 b(deep)f(cop)n(y)g(of)g(the)h(supplied)g(Region)f(will)g(b)r(e)h
(tak)n(en,)h(so)e(subsequen)n(t)g(c)n(hanges)f(to)h(the)427
-5179 y(uncertain)n(t)n(y)g(Region)g(using)g(the)h(supplied)g(p)r(oin)n
+3277 y(uncertain)n(t)n(y)g(Region)g(using)g(the)h(supplied)g(p)r(oin)n
(ter)g(will)f(ha)n(v)n(e)g(no)g(e\013ect)h(on)g(the)g(created)f(Bo)n
-(x.)57 b(Al-)427 5279 y(ternativ)n(ely)-7 b(,)34 b(a)f(n)n(ull)g(Ob)5
+(x.)57 b(Al-)427 3376 y(ternativ)n(ely)-7 b(,)34 b(a)f(n)n(ull)g(Ob)5
b(ject)33 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fj(NULL\))g(ma)n(y)f(b)r(e)
i(supplied,)h(in)e(whic)n(h)g(case)f(a)h(default)427
-5378 y(uncertain)n(t)n(y)27 b(is)g(used)h(equiv)-5 b(alen)n(t)27
+3476 y(uncertain)n(t)n(y)27 b(is)g(used)h(equiv)-5 b(alen)n(t)27
b(to)h(a)f(b)r(o)n(x)g(1.0E-6)f(of)h(the)h(size)f(of)h(the)g(Bo)n(x)e
-(b)r(eing)i(created.)427 5494 y(The)h(uncertain)n(t)n(y)f(Region)g(has)
+(b)r(eing)i(created.)427 3596 y(The)h(uncertain)n(t)n(y)f(Region)g(has)
h(t)n(w)n(o)f(uses:)39 b(1\))29 b(when)g(the)g(AST)p
Ft(_)p Fj(O)n(VERLAP)f(function)h(compares)e(t)n(w)n(o)427
-5593 y(Regions)j(for)g(equalit)n(y)g(the)h(uncertain)n(t)n(y)f(Region)g
+3696 y(Regions)j(for)g(equalit)n(y)g(the)h(uncertain)n(t)n(y)f(Region)g
(is)g(used)h(to)g(determine)f(the)h(tolerance)f(on)g(the)h(com-)427
-5693 y(parison,)23 b(and)g(2\))g(when)g(a)f(Region)h(is)g(mapp)r(ed)g
+3795 y(parison,)23 b(and)g(2\))g(when)g(a)f(Region)h(is)g(mapp)r(ed)g
(in)n(to)g(a)f(di\013eren)n(t)i(co)r(ordinate)d(system)i(and)g
-(subsequen)n(tly)p eop end
-%%Page: 197 207
-TeXDict begin 197 206 bop 3643 52 a FG(197)427 351 y
-Fj(simpli\014ed)21 b(\(using)f(AST)p Ft(_)p Fj(SIMPLIFY\),)h(the)f
-(uncertain)n(ties)g(are)f(used)h(to)g(determine)g(if)h(the)g
-(transformed)427 451 y(b)r(oundary)27 b(can)g(b)r(e)h(accurately)f
-(represen)n(ted)f(b)n(y)h(a)g(sp)r(eci\014c)h(shap)r(e)g(of)f(Region.)
-259 583 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f
-Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427 683 y Fj(A)g(c)n(haracter)e
-(string)h(con)n(taining)f(an)h(optional)g(comma-separated)e(list)j(of)g
-(attribute)f(assignmen)n(ts)g(to)427 783 y(b)r(e)f(used)f(for)g
-(initialising)g(the)h(new)f(Bo)n(x.)41 b(The)30 b(syn)n(tax)e(used)h
-(is)h(iden)n(tical)f(to)g(that)g(for)g(the)h(AST)p Ft(_)p
-Fj(SET)427 882 y(routine.)259 1015 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 1114
-y Fj(The)c(global)e(status.)0 1276 y Fc(Returned)32 b(V)-8
-b(alue:)259 1412 y(AST)p Ft(_)p Fc(BO)m(X)32 b(=)g(INTEGER)427
-1512 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(Bo)n(x.)0
-1673 y Fc(Notes:)340 1956 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+(subsequen)n(tly)427 3895 y(simpli\014ed)e(\(using)f(AST)p
+Ft(_)p Fj(SIMPLIFY\),)h(the)f(uncertain)n(ties)g(are)f(used)h(to)g
+(determine)g(if)h(the)g(transformed)427 3995 y(b)r(oundary)27
+b(can)g(b)r(e)h(accurately)f(represen)n(ted)f(b)n(y)h(a)g(sp)r
+(eci\014c)h(shap)r(e)g(of)f(Region.)259 4135 y Fc(OPTIONS)32
+b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))
+427 4235 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h
+(optional)g(comma-separated)e(list)j(of)g(attribute)f(assignmen)n(ts)g
+(to)427 4334 y(b)r(e)f(used)f(for)g(initialising)g(the)h(new)f(Bo)n(x.)
+41 b(The)30 b(syn)n(tax)e(used)h(is)h(iden)n(tical)f(to)g(that)g(for)g
+(the)h(AST)p Ft(_)p Fj(SET)427 4434 y(routine.)259 4574
+y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
+427 4674 y Fj(The)c(global)e(status.)0 4851 y Fc(Returned)32
+b(V)-8 b(alue:)259 5003 y(AST)p Ft(_)p Fc(BO)m(X)32 b(=)g(INTEGER)427
+5102 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(Bo)n(x.)0
+5280 y Fc(Notes:)340 5577 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 2055 y(set)28 b(to)f(an)h(error)d(v)-5
-b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)-2
-2217 y Fc(Status)33 b(Handling)n(:)227 2363 y Fj(The)d(protected)g(in)n
-(terface)f(to)g(this)h(function)h(includes)f(an)f(extra)g(parameter)f
-(at)i(the)g(end)g(of)g(the)g(parameter)227 2463 y(list)37
-b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)
-r(oin)n(ter)g(to)h(the)g(in)n(teger)e(inherited)i(status)f(v)-5
-b(ariable:)54 b Ft(")p Fj(in)n(t)227 2562 y Fi(\003)p
-Fj(status)p Ft(")p Fj(.)p 0 2761 3780 12 v 0 2892 a FA(AST)p
-Fe(_)p FA(CHANNEL)1441 2893 y Fd(Create)37 b(a)i(Channel)2765
-2892 y FA(AST)p Fe(_)p FA(CHANNEL)0 3068 y Fc(Description:)44
-b Fj(This)28 b(function)g(creates)f(a)g(new)g(Channel)h(and)f
-(optionally)g(initialises)g(its)h(attributes.)227 3192
-y(A)22 b(Channel)g(implemen)n(ts)g(lo)n(w-lev)n(el)e(input/output)i
-(for)f(the)i(AST)f(library)-7 b(.)33 b(W)-7 b(riting)22
-b(an)f(Ob)5 b(ject)22 b(to)f(a)h(Channel)227 3292 y(\(using)34
-b(AST)p Ft(_)p Fj(WRITE\))h(will)f(generate)f(a)h(textual)g(represen)n
-(tation)e(of)i(that)h(Ob)5 b(ject,)35 b(and)f(reading)f(from)h(a)227
-3391 y(Channel)28 b(\(using)f(AST)p Ft(_)p Fj(READ\))h(will)g(create)f
-(a)g(new)h(Ob)5 b(ject)27 b(from)h(its)f(textual)h(represen)n(tation.)
-227 3516 y(Normally)-7 b(,)22 b(when)h(y)n(ou)e(use)g(a)h(Channel,)h(y)
-n(ou)e(should)h(pro)n(vide)e Ft(")p Fj(source)p Ft(")g
-Fj(and)i Ft(")p Fj(sink)p Ft(")f Fj(routines)g(whic)n(h)h(connect)227
-3615 y(it)38 b(to)f(an)f(external)h(data)f(store)g(b)n(y)h(reading)f
+b(A)g(TUS)427 5677 y(set)28 b(to)f(an)h(error)d(v)-5
+b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
+eop end
+%%Page: 198 208
+TeXDict begin 198 207 bop 0 52 a FG(198)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)-2 351 y Fc(Status)i(Handling)n(:)
+227 497 y Fj(The)d(protected)g(in)n(terface)f(to)g(this)h(function)h
+(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g(the)g
+(parameter)227 597 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62
+b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)
+e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fj(in)n(t)227
+697 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p 0 896 3780
+12 v 0 1027 a FA(AST)p Fe(_)p FA(CHANNEL)1441 1028 y
+Fd(Create)37 b(a)i(Channel)2765 1027 y FA(AST)p Fe(_)p
+FA(CHANNEL)0 1204 y Fc(Description:)44 b Fj(This)28 b(function)g
+(creates)f(a)g(new)g(Channel)h(and)f(optionally)g(initialises)g(its)h
+(attributes.)227 1329 y(A)22 b(Channel)g(implemen)n(ts)g(lo)n(w-lev)n
+(el)e(input/output)i(for)f(the)i(AST)f(library)-7 b(.)33
+b(W)-7 b(riting)22 b(an)f(Ob)5 b(ject)22 b(to)f(a)h(Channel)227
+1428 y(\(using)34 b(AST)p Ft(_)p Fj(WRITE\))h(will)f(generate)f(a)h
+(textual)g(represen)n(tation)e(of)i(that)h(Ob)5 b(ject,)35
+b(and)f(reading)f(from)h(a)227 1528 y(Channel)28 b(\(using)f(AST)p
+Ft(_)p Fj(READ\))h(will)g(create)f(a)g(new)h(Ob)5 b(ject)27
+b(from)h(its)f(textual)h(represen)n(tation.)227 1652
+y(Normally)-7 b(,)22 b(when)h(y)n(ou)e(use)g(a)h(Channel,)h(y)n(ou)e
+(should)h(pro)n(vide)e Ft(")p Fj(source)p Ft(")g Fj(and)i
+Ft(")p Fj(sink)p Ft(")f Fj(routines)g(whic)n(h)h(connect)227
+1752 y(it)38 b(to)f(an)f(external)h(data)f(store)g(b)n(y)h(reading)f
(and)h(writing)f(the)i(resulting)e(text.)66 b(By)37 b(default,)j(ho)n
-(w)n(ev)n(er,)d(a)227 3715 y(Channel)e(will)f(read)g(from)g(standard)f
+(w)n(ev)n(er,)d(a)227 1852 y(Channel)e(will)f(read)g(from)g(standard)f
(input)j(and)e(write)g(to)h(standard)e(output.)58 b(Alternativ)n(ely)-7
-b(,)36 b(a)e(Channel)227 3814 y(can)25 b(b)r(e)h(told)g(to)f(read)g(or)
+b(,)36 b(a)e(Channel)227 1951 y(can)25 b(b)r(e)h(told)g(to)f(read)g(or)
g(write)g(from)g(sp)r(eci\014c)h(text)g(\014les)f(using)g(the)h
-(SinkFile)g(and)g(SourceFile)e(attributes,)i(in)227 3914
+(SinkFile)g(and)g(SourceFile)e(attributes,)i(in)227 2051
y(whic)n(h)i(case)f(no)g(sink)g(or)g(source)f(function)j(need)e(b)r(e)h
-(supplied.)0 4063 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
+(supplied.)0 2201 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
b(=)i(AST_CHANNEL\()c(SOURCE,)h(SINK,)i(OPTIONS,)e(STATUS)h(\))0
-4212 y Fc(Argumen)m(ts:)259 4349 y(SOUR)m(CE)32 b(=)g(SUBR)m(OUTINE)g
-(\(Giv)m(en\))427 4448 y Fj(A)26 b(source)d(routine,)j(whic)n(h)f(is)g
+2350 y Fc(Argumen)m(ts:)259 2487 y(SOUR)m(CE)32 b(=)g(SUBR)m(OUTINE)g
+(\(Giv)m(en\))427 2587 y Fj(A)26 b(source)d(routine,)j(whic)n(h)f(is)g
(a)f(subroutine)h(whic)n(h)g(tak)n(es)f(a)h(single)f(in)n(teger)g
-(error)f(status)i(argumen)n(t.)35 b(If)427 4548 y(no)30
+(error)f(status)i(argumen)n(t.)35 b(If)427 2686 y(no)30
b(v)-5 b(alue)29 b(has)g(b)r(een)i(set)e(for)h(the)g(SourceFile)f
(attribute,)h(this)g(routine)f(will)h(b)r(e)h(used)e(b)n(y)h(the)g
-(Channel)427 4647 y(to)35 b(obtain)f(lines)g(of)g(input)i(text.)57
+(Channel)427 2786 y(to)35 b(obtain)f(lines)g(of)g(input)i(text.)57
b(On)35 b(eac)n(h)e(in)n(v)n(o)r(cation,)i(it)g(should)f(read)g(the)g
-(next)h(input)g(line)g(from)427 4747 y(some)e(external)f(data)h(store,)
+(next)h(input)g(line)g(from)427 2886 y(some)e(external)f(data)h(store,)
g(and)g(then)h(return)e(the)i(resulting)e(text)i(to)f(the)g(AST)h
-(library)d(b)n(y)i(calling)427 4847 y(AST)p Ft(_)p Fj(PUTLINE.)k(It)g
+(library)d(b)n(y)i(calling)427 2985 y(AST)p Ft(_)p Fj(PUTLINE.)k(It)g
(should)f(supply)h(a)g(negativ)n(e)f(line)h(length)g(when)g(there)f
-(are)g(no)h(more)f(lines)h(to)427 4946 y(read.)h(If)29
+(are)g(no)h(more)f(lines)h(to)427 3085 y(read.)h(If)29
b(an)f(error)e(o)r(ccurs,)h(it)i(should)f(set)g(its)h(o)n(wn)e(error)f
(status)i(argumen)n(t)g(to)g(an)g(error)e(v)-5 b(alue)28
-b(b)r(efore)427 5046 y(returning.)427 5162 y(If)i(the)f(n)n(ull)h
+b(b)r(efore)427 3185 y(returning.)427 3301 y(If)i(the)f(n)n(ull)h
(routine)e(AST)p Ft(_)p Fj(NULL)i(is)f(suppied)g(as)f(the)i(SOUR)n(CE)e
(v)-5 b(alue,)30 b(and)f(no)g(v)-5 b(alue)29 b(has)f(b)r(een)i(set)427
-5262 y(for)d(the)h(SourceFile)f(attribute,)h(the)g(Channel)g(will)f
-(read)g(from)g(standard)g(input)h(instead.)259 5394 y
-Fc(SINK)k(=)g(SUBR)m(OUTINE)g(\(Giv)m(en\))427 5494 y
+3400 y(for)d(the)h(SourceFile)f(attribute,)h(the)g(Channel)g(will)f
+(read)g(from)g(standard)g(input)h(instead.)259 3533 y
+Fc(SINK)k(=)g(SUBR)m(OUTINE)g(\(Giv)m(en\))427 3633 y
Fj(A)f(sink)f(routine,)g(whic)n(h)h(is)f(a)f(subroutine)h(whic)n(h)g
(tak)n(es)g(a)f(single)h(in)n(teger)f(error)g(status)h(argumen)n(t.)43
-b(If)427 5593 y(no)35 b(v)-5 b(alue)34 b(has)g(b)r(een)i(set)e(for)g
+b(If)427 3733 y(no)35 b(v)-5 b(alue)34 b(has)g(b)r(een)i(set)e(for)g
(the)h(SinkFile)h(attribute,)g(this)f(routine)g(will)f(b)r(e)i(used)e
-(b)n(y)h(the)g(Channel)427 5693 y(to)h(deliv)n(er)e(lines)i(of)f
+(b)n(y)h(the)g(Channel)427 3832 y(to)h(deliv)n(er)e(lines)i(of)f
(output)h(text.)61 b(On)35 b(eac)n(h)g(in)n(v)n(o)r(cation,)h(it)g
-(should)g(obtain)f(the)h(next)f(output)h(line)p eop end
-%%Page: 198 208
-TeXDict begin 198 207 bop 0 52 a FG(198)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(from)25
-b(the)h(AST)f(library)f(b)n(y)h(calling)f(AST)p Ft(_)p
-Fj(GETLINE,)h(and)g(then)g(deliv)n(er)g(the)g(resulting)g(text)g(to)g
-(some)427 451 y(external)f(data)g(store.)34 b(If)25 b(an)f(error)e(o)r
-(ccurs,)j(it)f(should)g(set)h(its)f(o)n(wn)g(error)e(status)i(argumen)n
-(t)f(to)i(an)f(error)427 551 y(v)-5 b(alue)28 b(b)r(efore)f(returning.)
-427 664 y(If)k(the)f(n)n(ull)g(routine)g(AST)p Ft(_)p
-Fj(NULL)h(is)e(suppied)i(as)e(the)i(SINK)f(v)-5 b(alue,)30
-b(and)g(no)g(v)-5 b(alue)30 b(has)g(b)r(een)g(set)g(for)427
-764 y(the)e(SinkFile)g(attribute,)g(the)g(Channel)g(will)f(write)h(to)f
-(standard)g(output)h(instead.)259 891 y Fc(OPTIONS)k(=)g(CHARA)m(CTER)g
-Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-991 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)f
-(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r(e)
-427 1090 y(used)27 b(for)f(initialising)g(the)h(new)g(Channel.)37
+(should)g(obtain)f(the)h(next)f(output)h(line)427 3932
+y(from)25 b(the)h(AST)f(library)f(b)n(y)h(calling)f(AST)p
+Ft(_)p Fj(GETLINE,)h(and)g(then)g(deliv)n(er)g(the)g(resulting)g(text)g
+(to)g(some)427 4032 y(external)f(data)g(store.)34 b(If)25
+b(an)f(error)e(o)r(ccurs,)j(it)f(should)g(set)h(its)f(o)n(wn)g(error)e
+(status)i(argumen)n(t)f(to)i(an)f(error)427 4131 y(v)-5
+b(alue)28 b(b)r(efore)f(returning.)427 4248 y(If)k(the)f(n)n(ull)g
+(routine)g(AST)p Ft(_)p Fj(NULL)h(is)e(suppied)i(as)e(the)i(SINK)f(v)-5
+b(alue,)30 b(and)g(no)g(v)-5 b(alue)30 b(has)g(b)r(een)g(set)g(for)427
+4347 y(the)e(SinkFile)g(attribute,)g(the)g(Channel)g(will)f(write)h(to)
+f(standard)g(output)h(instead.)259 4480 y Fc(OPTIONS)k(=)g(CHARA)m
+(CTER)g Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
+4580 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)
+f(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r
+(e)427 4679 y(used)27 b(for)f(initialising)g(the)h(new)g(Channel.)37
b(The)26 b(syn)n(tax)g(used)h(is)f(iden)n(tical)g(to)h(that)g(for)f
-(the)h(AST)p Ft(_)p Fj(SET)427 1190 y(routine.)259 1317
+(the)h(AST)p Ft(_)p Fj(SET)427 4779 y(routine.)259 4912
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 1417 y Fj(The)c(global)e(status.)0 1573 y Fc(Returned)32
-b(V)-8 b(alue:)259 1704 y(AST)p Ft(_)p Fc(CHANNEL)32
-b(=)g(INTEGER)427 1804 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
-(Channel.)0 1960 y Fc(Notes:)340 2237 y Fi(\017)45 b
-Fj(The)35 b(names)f(of)g(the)h(routines)f(supplied)h(for)f(the)h(SOUR)n
-(CE)f(and)g(SINK)h(argumen)n(ts)e(should)i(app)r(ear)427
-2337 y(in)25 b(EXTERNAL)g(statemen)n(ts)g(in)g(the)g(F)-7
+427 5012 y Fj(The)c(global)e(status.)0 5174 y Fc(Returned)32
+b(V)-8 b(alue:)259 5311 y(AST)p Ft(_)p Fc(CHANNEL)32
+b(=)g(INTEGER)427 5410 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
+(Channel.)0 5572 y Fc(Notes:)p eop end
+%%Page: 199 209
+TeXDict begin 199 208 bop 3643 52 a FG(199)340 351 y
+Fi(\017)45 b Fj(The)35 b(names)f(of)g(the)h(routines)f(supplied)h(for)f
+(the)h(SOUR)n(CE)f(and)g(SINK)h(argumen)n(ts)e(should)i(app)r(ear)427
+451 y(in)25 b(EXTERNAL)g(statemen)n(ts)g(in)g(the)g(F)-7
b(ortran)24 b(routine)g(whic)n(h)h(in)n(v)n(ok)n(es)e(AST)p
-Ft(_)p Fj(CHANNEL.)j(Ho)n(w)n(ev)n(er,)427 2437 y(this)36
+Ft(_)p Fj(CHANNEL.)j(Ho)n(w)n(ev)n(er,)427 551 y(this)36
b(is)f(not)g(generally)f(necessary)f(for)i(the)g(n)n(ull)h(routine)f
(AST)p Ft(_)p Fj(NULL)g(\(so)g(long)f(as)h(the)h(AST)p
-Ft(_)p Fj(P)-7 b(AR)427 2536 y(include)28 b(\014le)g(has)f(b)r(een)h
-(used\).)340 2664 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+Ft(_)p Fj(P)-7 b(AR)427 650 y(include)28 b(\014le)g(has)f(b)r(een)h
+(used\).)340 780 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 2763 y(set)28 b(to)f(an)h(error)d(v)-5
-b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)340
-2891 y Fi(\017)45 b Fj(Note)36 b(that)f(the)h(n)n(ull)f(routine)g(AST)p
+b(A)g(TUS)427 880 y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28
+b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)340
+1010 y Fi(\017)45 b Fj(Note)36 b(that)f(the)h(n)n(ull)f(routine)g(AST)p
Ft(_)p Fj(NULL)h(\(one)f(underscore\))f(is)h(di\013eren)n(t)h(to)f(AST)
-p Ft(__)p Fj(NULL)g(\(t)n(w)n(o)427 2990 y(underscores\),)26
+p Ft(__)p Fj(NULL)g(\(t)n(w)n(o)427 1109 y(underscores\),)26
b(whic)n(h)i(is)f(the)h(n)n(ull)g(Ob)5 b(ject)28 b(p)r(oin)n(ter.)p
-0 3179 3780 12 v 0 3309 a FA(AST)p Fe(_)p FA(CIR)l(CLE)1503
-3310 y Fd(Create)37 b(a)i(Circle)2938 3309 y FA(AST)p
-Fe(_)p FA(CIR)l(CLE)0 3475 y Fc(Description:)44 b Fj(This)28
+0 1303 3780 12 v 0 1433 a FA(AST)p Fe(_)p FA(CIR)l(CLE)1503
+1434 y Fd(Create)37 b(a)i(Circle)2938 1433 y FA(AST)p
+Fe(_)p FA(CIR)l(CLE)0 1604 y Fc(Description:)44 b Fj(This)28
b(function)g(creates)f(a)g(new)g(Circle)g(and)h(optionally)f
-(initialises)g(its)h(attributes.)227 3597 y(A)g(Circle)f(is)h(a)f
+(initialises)g(its)h(attributes.)227 1727 y(A)g(Circle)f(is)h(a)f
(Region)g(whic)n(h)g(represen)n(ts)g(a)g(circle)g(or)f(sphere)h(within)
-i(the)f(supplied)g(F)-7 b(rame.)0 3741 y Fc(In)m(v)m(o)s(cation:)123
+i(the)f(supplied)g(F)-7 b(rame.)0 1874 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_CIRCLE\()c(FRAME,)i(FORM,)h(CENTRE,)e(POINT,)h
-(UNC,)h(OPTIONS,)f(STATUS)g(\))0 3885 y Fc(Argumen)m(ts:)259
-4016 y(FRAME)31 b(=)h(INTEGER)g(\(Giv)m(en\))427 4115
+(UNC,)h(OPTIONS,)f(STATUS)g(\))0 2021 y Fc(Argumen)m(ts:)259
+2154 y(FRAME)31 b(=)h(INTEGER)g(\(Giv)m(en\))427 2254
y Fj(A)d(p)r(oin)n(ter)g(to)f(the)i(F)-7 b(rame)28 b(in)h(whic)n(h)g
(the)g(region)e(is)i(de\014ned.)41 b(A)29 b(deep)g(cop)n(y)f(is)g(tak)n
-(en)g(of)h(the)g(supplied)427 4215 y(F)-7 b(rame.)71
+(en)g(of)h(the)g(supplied)427 2353 y(F)-7 b(rame.)71
b(This)39 b(means)f(that)h(an)n(y)g(subsequen)n(t)f(c)n(hanges)g(made)h
(to)f(the)i(F)-7 b(rame)38 b(using)h(the)g(supplied)427
-4315 y(p)r(oin)n(ter)27 b(will)h(ha)n(v)n(e)f(no)g(e\013ect)h(the)g
-(Region.)259 4442 y Fc(F)m(ORM)j(=)h(INTEGER)g(\(Giv)m(en\))427
-4542 y Fj(Indicates)c(ho)n(w)g(the)h(circle)f(is)g(describ)r(ed)h(b)n
+2453 y(p)r(oin)n(ter)27 b(will)h(ha)n(v)n(e)f(no)g(e\013ect)h(the)g
+(Region.)259 2583 y Fc(F)m(ORM)j(=)h(INTEGER)g(\(Giv)m(en\))427
+2683 y Fj(Indicates)c(ho)n(w)g(the)h(circle)f(is)g(describ)r(ed)h(b)n
(y)f(the)h(remaining)e(parameters.)38 b(A)29 b(v)-5 b(alue)28
-b(of)g(zero)g(indicates)427 4641 y(that)h(the)f(circle)f(is)h(sp)r
+b(of)g(zero)g(indicates)427 2782 y(that)h(the)f(circle)f(is)h(sp)r
(eci\014ed)h(b)n(y)e(a)h(cen)n(tre)f(p)r(osition)h(and)g(a)g(p)r
(osition)g(on)f(the)i(circumference.)37 b(A)29 b(v)-5
-b(alue)427 4741 y(of)28 b(one)f(indicates)g(that)h(the)g(circle)f(is)h
+b(alue)427 2882 y(of)28 b(one)f(indicates)g(that)h(the)g(circle)f(is)h
(sp)r(eci\014ed)g(b)n(y)f(a)g(cen)n(tre)g(p)r(osition)h(and)f(a)g
-(scalar)f(radius.)259 4868 y Fc(CENTRE\()31 b Fi(\003)h
-Fc(\))f(=)i(DOUBLE)f(PRECISION)f(\(Giv)m(en\))427 4968
+(scalar)f(radius.)259 3012 y Fc(CENTRE\()31 b Fi(\003)h
+Fc(\))f(=)i(DOUBLE)f(PRECISION)f(\(Giv)m(en\))427 3111
y Fj(An)d(arra)n(y)c(with)k(one)f(elemen)n(t)g(for)f(eac)n(h)h(F)-7
b(rame)26 b(axis)g(\(Naxes)h(attribute\))h(con)n(taining)e(the)h(co)r
-(ordinates)427 5068 y(at)h(the)g(cen)n(tre)f(of)g(the)h(circle)f(or)g
-(sphere.)259 5195 y Fc(POINT\()32 b Fi(\003)g Fc(\))g(=)g(DOUBLE)g
-(PRECISION)f(\(Giv)m(en\))427 5295 y Fj(If)k(F)n(ORM)f(is)g(zero,)h
+(ordinates)427 3211 y(at)h(the)g(cen)n(tre)f(of)g(the)h(circle)f(or)g
+(sphere.)259 3341 y Fc(POINT\()32 b Fi(\003)g Fc(\))g(=)g(DOUBLE)g
+(PRECISION)f(\(Giv)m(en\))427 3441 y Fj(If)k(F)n(ORM)f(is)g(zero,)h
(then)g(this)f(arra)n(y)e(should)i(ha)n(v)n(e)f(one)h(elemen)n(t)g(for)
g(eac)n(h)f(F)-7 b(rame)34 b(axis)f(\(Naxes)h(at-)427
-5394 y(tribute\),)e(and)e(should)g(b)r(e)h(supplied)f(holding)g(the)h
+3540 y(tribute\),)e(and)e(should)g(b)r(e)h(supplied)f(holding)g(the)h
(co)r(ordinates)e(at)h(a)g(p)r(oin)n(t)g(on)g(the)h(circumference)f(of)
-427 5494 y(the)k(circle)e(or)h(sphere.)53 b(If)33 b(F)n(ORM)g(is)g
+427 3640 y(the)k(circle)e(or)h(sphere.)53 b(If)33 b(F)n(ORM)g(is)g
(one,)i(then)e(this)h(arra)n(y)d(should)i(ha)n(v)n(e)f(one)h(elemen)n
-(t)g(only)g(whic)n(h)427 5593 y(should)h(b)r(e)g(supplied)g(holding)f
+(t)g(only)g(whic)n(h)427 3739 y(should)h(b)r(e)g(supplied)g(holding)f
(the)h(scalar)e(radius)h(of)h(the)g(circle)f(or)g(sphere,)i(as)e(a)g
-(geo)r(desic)g(distance)427 5693 y(within)c(the)f(F)-7
-b(rame.)p eop end
-%%Page: 199 209
-TeXDict begin 199 208 bop 3643 52 a FG(199)259 351 y
-Fc(UNC)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 451 y Fj(An)i(optional)e(p)r
-(oin)n(ter)h(to)g(an)g(existing)g(Region)f(whic)n(h)h(sp)r(eci\014es)g
-(the)h(uncertain)n(ties)e(asso)r(ciated)g(with)427 551
-y(the)f(b)r(oundary)f(of)g(the)h(Circle)f(b)r(eing)g(created.)41
-b(The)30 b(uncertain)n(t)n(y)e(in)i(an)n(y)f(p)r(oin)n(t)g(on)g(the)h
-(b)r(oundary)f(of)427 650 y(the)g(Circle)e(is)h(found)g(b)n(y)f
-(shifting)i(the)f(supplied)g Ft(")p Fj(uncertain)n(t)n(y)p
+(geo)r(desic)g(distance)427 3839 y(within)c(the)f(F)-7
+b(rame.)259 3969 y Fc(UNC)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
+4069 y Fj(An)i(optional)e(p)r(oin)n(ter)h(to)g(an)g(existing)g(Region)f
+(whic)n(h)h(sp)r(eci\014es)g(the)h(uncertain)n(ties)e(asso)r(ciated)g
+(with)427 4168 y(the)f(b)r(oundary)f(of)g(the)h(Circle)f(b)r(eing)g
+(created.)41 b(The)30 b(uncertain)n(t)n(y)e(in)i(an)n(y)f(p)r(oin)n(t)g
+(on)g(the)h(b)r(oundary)f(of)427 4268 y(the)g(Circle)e(is)h(found)g(b)n
+(y)f(shifting)i(the)f(supplied)g Ft(")p Fj(uncertain)n(t)n(y)p
Ft(")e Fj(Region)i(so)f(that)h(it)g(is)g(cen)n(tred)f(at)h(the)427
-750 y(b)r(oundary)i(p)r(oin)n(t)h(b)r(eing)g(considered.)44
+4368 y(b)r(oundary)i(p)r(oin)n(t)h(b)r(eing)g(considered.)44
b(The)31 b(area)e(co)n(v)n(ered)g(b)n(y)h(the)h(shifted)g(uncertain)n
-(t)n(y)f(Region)g(then)427 849 y(represen)n(ts)g(the)i(uncertain)n(t)n
+(t)n(y)f(Region)g(then)427 4467 y(represen)n(ts)g(the)i(uncertain)n(t)n
(y)f(in)g(the)h(b)r(oundary)f(p)r(osition.)48 b(The)31
b(uncertain)n(t)n(y)g(is)g(assumed)g(to)g(b)r(e)h(the)427
-949 y(same)27 b(for)g(all)h(p)r(oin)n(ts.)427 1065 y(If)38
+4567 y(same)27 b(for)g(all)h(p)r(oin)n(ts.)427 4682 y(If)38
b(supplied,)j(the)d(uncertain)n(t)n(y)f(Region)g(m)n(ust)g(b)r(e)i(of)e
(a)g(class)g(for)g(whic)n(h)h(all)f(instances)g(are)g(cen)n(tro-)427
-1164 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24 b(Circle,)g(Ellipse,)h
+4781 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24 b(Circle,)g(Ellipse,)h
(etc.\))36 b(or)23 b(b)r(e)i(a)e(Prism)h(con)n(taining)f(cen)n
-(tro-symetric)f(comp)r(onen)n(t)427 1264 y(Regions.)57
+(tro-symetric)f(comp)r(onen)n(t)427 4881 y(Regions.)57
b(A)35 b(deep)f(cop)n(y)g(of)g(the)h(supplied)g(Region)f(will)g(b)r(e)h
(tak)n(en,)h(so)e(subsequen)n(t)g(c)n(hanges)f(to)h(the)427
-1364 y(uncertain)n(t)n(y)c(Region)f(using)h(the)h(supplied)f(p)r(oin)n
+4980 y(uncertain)n(t)n(y)c(Region)f(using)h(the)h(supplied)f(p)r(oin)n
(ter)g(will)h(ha)n(v)n(e)e(no)h(e\013ect)g(on)g(the)h(created)e
-(Circle.)45 b(Al-)427 1463 y(ternativ)n(ely)-7 b(,)34
+(Circle.)45 b(Al-)427 5080 y(ternativ)n(ely)-7 b(,)34
b(a)f(n)n(ull)g(Ob)5 b(ject)33 b(p)r(oin)n(ter)g(\(AST)p
Ft(__)p Fj(NULL\))g(ma)n(y)f(b)r(e)i(supplied,)h(in)e(whic)n(h)g(case)f
-(a)h(default)427 1563 y(uncertain)n(t)n(y)27 b(is)g(used)h(equiv)-5
+(a)h(default)427 5180 y(uncertain)n(t)n(y)27 b(is)g(used)h(equiv)-5
b(alen)n(t)27 b(to)h(a)f(b)r(o)n(x)g(1.0E-6)f(of)h(the)h(size)f(of)h
-(the)g(Circle)f(b)r(eing)h(created.)427 1679 y(The)h(uncertain)n(t)n(y)
+(the)g(Circle)f(b)r(eing)h(created.)427 5295 y(The)h(uncertain)n(t)n(y)
f(Region)g(has)h(t)n(w)n(o)f(uses:)39 b(1\))29 b(when)g(the)g(AST)p
Ft(_)p Fj(O)n(VERLAP)f(function)h(compares)e(t)n(w)n(o)427
-1778 y(Regions)j(for)g(equalit)n(y)g(the)h(uncertain)n(t)n(y)f(Region)g
+5394 y(Regions)j(for)g(equalit)n(y)g(the)h(uncertain)n(t)n(y)f(Region)g
(is)g(used)h(to)g(determine)f(the)h(tolerance)f(on)g(the)h(com-)427
-1878 y(parison,)23 b(and)g(2\))g(when)g(a)f(Region)h(is)g(mapp)r(ed)g
+5494 y(parison,)23 b(and)g(2\))g(when)g(a)f(Region)h(is)g(mapp)r(ed)g
(in)n(to)g(a)f(di\013eren)n(t)i(co)r(ordinate)d(system)i(and)g
-(subsequen)n(tly)427 1978 y(simpli\014ed)e(\(using)f(AST)p
+(subsequen)n(tly)427 5593 y(simpli\014ed)e(\(using)f(AST)p
Ft(_)p Fj(SIMPLIFY\),)h(the)f(uncertain)n(ties)g(are)f(used)h(to)g
-(determine)g(if)h(the)g(transformed)427 2077 y(b)r(oundary)27
+(determine)g(if)h(the)g(transformed)427 5693 y(b)r(oundary)27
b(can)g(b)r(e)h(accurately)f(represen)n(ted)f(b)n(y)h(a)g(sp)r
-(eci\014c)h(shap)r(e)g(of)f(Region.)259 2209 y Fc(OPTIONS)32
-b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))
-427 2309 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h
-(optional)g(comma-separated)e(list)j(of)g(attribute)f(assignmen)n(ts)g
-(to)427 2408 y(b)r(e)26 b(used)f(for)f(initialising)h(the)g(new)g
-(Circle.)36 b(The)25 b(syn)n(tax)f(used)h(is)g(iden)n(tical)g(to)g
-(that)g(for)g(the)g(AST)p Ft(_)p Fj(SET)427 2508 y(routine.)259
-2640 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 2739 y Fj(The)c(global)e(status.)0 2900
-y Fc(Returned)32 b(V)-8 b(alue:)259 3036 y(AST)p Ft(_)p
-Fc(CIR)m(CLE)32 b(=)g(INTEGER)427 3135 y Fj(A)c(p)r(oin)n(ter)f(to)h
-(the)g(new)g(Circle.)0 3296 y Fc(Notes:)340 3578 y Fi(\017)45
-b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
+(eci\014c)h(shap)r(e)g(of)f(Region.)p eop end
+%%Page: 200 210
+TeXDict begin 200 209 bop 0 52 a FG(200)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(OPTIONS)h(=)g(CHARA)m
+(CTER)g Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
+451 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h(optional)g
+(comma-separated)e(list)j(of)g(attribute)f(assignmen)n(ts)g(to)427
+551 y(b)r(e)26 b(used)f(for)f(initialising)h(the)g(new)g(Circle.)36
+b(The)25 b(syn)n(tax)f(used)h(is)g(iden)n(tical)g(to)g(that)g(for)g
+(the)g(AST)p Ft(_)p Fj(SET)427 650 y(routine.)259 793
+y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
+427 893 y Fj(The)c(global)e(status.)0 1075 y Fc(Returned)32
+b(V)-8 b(alue:)259 1232 y(AST)p Ft(_)p Fc(CIR)m(CLE)32
+b(=)g(INTEGER)427 1332 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
+(Circle.)0 1514 y Fc(Notes:)340 1817 y Fi(\017)45 b Fj(A)21
+b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 3677
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 1917
y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 3875 3780 12 v 0 4005
-a FA(AST)p Fe(_)p FA(CIR)l(CLEP)-11 b(ARS)1586 4006 y
-Fd(Returns)39 b(the)1643 4106 y(geometric)1459 4221 y(parameters)d(of)i
-(an)1740 4335 y(Circle)2581 4005 y FA(AST)p Fe(_)p FA(CIR)l(CLEP)-11
-b(ARS)0 4499 y Fc(Description:)44 b Fj(This)28 b(routine)f(returns)g
+(fail)h(for)f(an)n(y)g(reason.)p 0 2137 3780 12 v 0 2267
+a FA(AST)p Fe(_)p FA(CIR)l(CLEP)-11 b(ARS)1586 2268 y
+Fd(Returns)39 b(the)1643 2368 y(geometric)1459 2483 y(parameters)d(of)i
+(an)1740 2597 y(Circle)2581 2267 y FA(AST)p Fe(_)p FA(CIR)l(CLEP)-11
+b(ARS)0 2783 y Fc(Description:)44 b Fj(This)28 b(routine)f(returns)g
(the)h(geometric)e(parameters)g(describing)h(the)h(supplied)g(Circle.)0
-4647 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_CIRCLEPARS\()37
+2953 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_CIRCLEPARS\()37
b(THIS,)42 b(CENTRE,)e(RADIUS,)h(P1,)h(STATUS)f(\))0
-4796 y Fc(Argumen)m(ts:)259 4931 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 5031 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Region.)259
-5163 y Fc(CENTRE\()j Fi(\003)h Fc(\))f(=)i(DOUBLE)f(PRECISION)f
-(\(Returned\))427 5262 y Fj(An)j(arra)n(y)c(in)k(whic)n(h)f(to)g
+3123 y Fc(Argumen)m(ts:)259 3280 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 3380 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Region.)259
+3523 y Fc(CENTRE\()j Fi(\003)h Fc(\))f(=)i(DOUBLE)f(PRECISION)f
+(\(Returned\))427 3622 y Fj(An)j(arra)n(y)c(in)k(whic)n(h)f(to)g
(return)f(the)i(co)r(ordinates)d(of)i(the)g(Circle)g(cen)n(tre.)52
-b(The)34 b(length)f(of)g(this)g(arra)n(y)427 5362 y(should)28
+b(The)34 b(length)f(of)g(this)g(arra)n(y)427 3722 y(should)28
b(b)r(e)g(no)f(less)g(than)h(the)g(n)n(um)n(b)r(er)f(of)h(axes)e(in)i
-(the)g(asso)r(ciated)e(co)r(ordinate)h(system.)259 5494
+(the)g(asso)r(ciated)e(co)r(ordinate)h(system.)259 3865
y Fc(RADIUS)33 b(=)f(DOUBLE)g(PRECISION)f(\(Returned\))427
-5593 y Fj(Returned)22 b(holding)f(the)h(radius)f(of)g(the)h(Circle,)g
+3965 y Fj(Returned)22 b(holding)f(the)h(radius)f(of)g(the)h(Circle,)g
(as)f(an)g(geo)r(desic)g(distance)g(in)h(the)g(asso)r(ciated)e(co)r
-(ordinate)427 5693 y(system.)p eop end
-%%Page: 200 210
-TeXDict begin 200 209 bop 0 52 a FG(200)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(P1\()h
+(ordinate)427 4064 y(system.)259 4207 y Fc(P1\()32 b
Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Returned\))427
-451 y Fj(An)23 b(arra)n(y)c(in)k(whic)n(h)f(to)g(return)f(the)i(co)r
+4307 y Fj(An)23 b(arra)n(y)c(in)k(whic)n(h)f(to)g(return)f(the)i(co)r
(ordinates)d(of)i(a)g(p)r(oin)n(t)g(on)g(the)g(circumference)g(of)g
-(the)g(Circle.)35 b(The)427 551 y(length)c(of)g(this)f(arra)n(y)f
+(the)g(Circle.)35 b(The)427 4407 y(length)c(of)g(this)f(arra)n(y)f
(should)h(b)r(e)h(no)f(less)g(than)h(the)g(n)n(um)n(b)r(er)f(of)h(axes)
-f(in)h(the)g(asso)r(ciated)e(co)r(ordinate)427 650 y(system.)259
-781 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 880 y Fj(The)c(global)e(status.)0 1040
-y Fc(Notes:)340 1321 y Fi(\017)45 b Fj(If)24 b(the)g(co)r(ordinate)e
+f(in)h(the)g(asso)r(ciated)e(co)r(ordinate)427 4506 y(system.)259
+4649 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 4749 y Fj(The)c(global)e(status.)0 4931
+y Fc(Notes:)340 5234 y Fi(\017)45 b Fj(If)24 b(the)g(co)r(ordinate)e
(system)h(represen)n(ted)f(b)n(y)h(the)g(Circle)g(has)g(b)r(een)g(c)n
(hanged)f(since)h(it)h(w)n(as)e(\014rst)h(created,)427
-1420 y(the)c(returned)f(parameters)f(refer)h(to)h(the)g(new)f(\(c)n
+5334 y(the)c(returned)f(parameters)f(refer)h(to)h(the)g(new)f(\(c)n
(hanged\))g(co)r(ordinate)g(system,)i(rather)d(than)i(the)g(original)
-427 1520 y(co)r(ordinate)27 b(system.)37 b(Note)28 b(ho)n(w)n(ev)n(er)e
+427 5434 y(co)r(ordinate)27 b(system.)37 b(Note)28 b(ho)n(w)n(ev)n(er)e
(that)i(if)g(the)g(transformation)f(from)g(original)f(to)i(new)g(co)r
-(ordinate)427 1620 y(system)38 b(is)h(non-linear,)h(the)f(shap)r(e)f
+(ordinate)427 5533 y(system)38 b(is)h(non-linear,)h(the)f(shap)r(e)f
(represen)n(ted)f(b)n(y)h(the)h(supplied)g(Circle)f(ob)5
-b(ject)38 b(ma)n(y)g(not)g(b)r(e)h(an)427 1719 y(accurate)27
-b(circle.)p 0 1914 3780 12 v 0 2045 a FA(AST)p Fe(_)p
-FA(CLEAR)968 2046 y Fd(Clear)37 b(attribute)f(v)-7 b(alues)39
-b(for)e(an)i(Ob)7 b(ject)2980 2045 y FA(AST)p Fe(_)p
-FA(CLEAR)0 2230 y Fc(Description:)44 b Fj(This)31 b(routine)g(clears)e
-(the)i(v)-5 b(alues)31 b(of)f(a)h(sp)r(eci\014ed)g(set)g(of)f
-(attributes)h(for)f(an)h(Ob)5 b(ject.)46 b(Clearing)30
-b(an)227 2330 y(attribute)21 b(cancels)e(an)n(y)g(v)-5
-b(alue)20 b(that)h(has)e(previously)g(b)r(een)i(explicitly)f(set)g(for)
-g(it,)i(so)d(that)i(the)f(standard)f(default)227 2430
-y(attribute)35 b(v)-5 b(alue)34 b(will)h(subsequen)n(tly)f(b)r(e)g
-(used)h(instead.)57 b(This)34 b(also)g(causes)f(the)i(AST)p
-Ft(_)p Fj(TEST)f(function)h(to)227 2529 y(return)27 b(the)h(v)-5
-b(alue)28 b(.F)-9 b(ALSE.)27 b(for)g(the)h(attribute,)g(indicating)g
-(that)g(no)f(v)-5 b(alue)27 b(has)g(b)r(een)h(set.)0
-2677 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_CLEAR\()d(THIS,)j
-(ATTRIB,)e(STATUS)h(\))0 2824 y Fc(Argumen)m(ts:)259
-2958 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 3058
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5 b(ject.)259 3189
+b(ject)38 b(ma)n(y)g(not)g(b)r(e)h(an)427 5633 y(accurate)27
+b(circle.)p eop end
+%%Page: 201 211
+TeXDict begin 201 210 bop 3643 52 a FG(201)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(CLEAR)968 483 y Fd(Clear)37
+b(attribute)f(v)-7 b(alues)39 b(for)e(an)i(Ob)7 b(ject)2980
+482 y FA(AST)p Fe(_)p FA(CLEAR)0 685 y Fc(Description:)44
+b Fj(This)31 b(routine)g(clears)e(the)i(v)-5 b(alues)31
+b(of)f(a)h(sp)r(eci\014ed)g(set)g(of)f(attributes)h(for)f(an)h(Ob)5
+b(ject.)46 b(Clearing)30 b(an)227 785 y(attribute)21
+b(cancels)e(an)n(y)g(v)-5 b(alue)20 b(that)h(has)e(previously)g(b)r
+(een)i(explicitly)f(set)g(for)g(it,)i(so)d(that)i(the)f(standard)f
+(default)227 885 y(attribute)35 b(v)-5 b(alue)34 b(will)h(subsequen)n
+(tly)f(b)r(e)g(used)h(instead.)57 b(This)34 b(also)g(causes)f(the)i
+(AST)p Ft(_)p Fj(TEST)f(function)h(to)227 984 y(return)27
+b(the)h(v)-5 b(alue)28 b(.F)-9 b(ALSE.)27 b(for)g(the)h(attribute,)g
+(indicating)g(that)g(no)f(v)-5 b(alue)27 b(has)g(b)r(een)h(set.)0
+1147 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_CLEAR\()d(THIS,)j
+(ATTRIB,)e(STATUS)h(\))0 1310 y Fc(Argumen)m(ts:)259
+1461 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1560
+y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5 b(ject.)259 1700
y Fc(A)-8 b(TTRIB)33 b(=)f(CHARA)m(CTER)f Fi(\003)h Fc(\()g
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 3288 y Fj(A)j(c)n(haracter)d(string)
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1799 y Fj(A)j(c)n(haracter)d(string)
h(con)n(taining)h(a)f(comma-separated)f(list)j(of)f(the)h(names)e(of)h
-(the)h(attributes)f(to)g(b)r(e)427 3388 y(cleared.)259
-3518 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 3618 y Fj(The)c(global)e(status.)0 3778
-y Fc(Class)31 b(Applicabilit)m(y:)259 3912 y(Ob)5 b(ject)427
-4012 y Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5
-b(jects.)0 4172 y Fc(Notes:)340 4452 y Fi(\017)45 b Fj(A)n(ttribute)28
+(the)h(attributes)f(to)g(b)r(e)427 1899 y(cleared.)259
+2039 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 2138 y Fj(The)c(global)e(status.)0 2314
+y Fc(Class)31 b(Applicabilit)m(y:)259 2464 y(Ob)5 b(ject)427
+2564 y Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5
+b(jects.)0 2739 y Fc(Notes:)340 3035 y Fi(\017)45 b Fj(A)n(ttribute)28
b(names)g(are)e(not)i(case)f(sensitiv)n(e)g(and)g(ma)n(y)g(b)r(e)h
-(surrounded)e(b)n(y)i(white)g(space.)340 4583 y Fi(\017)45
+(surrounded)e(b)n(y)i(white)g(space.)340 3175 y Fi(\017)45
b Fj(It)28 b(do)r(es)f(no)h(harm)f(to)g(clear)g(an)g(attribute)h(whose)
-f(v)-5 b(alue)27 b(has)g(not)h(b)r(een)g(set.)340 4713
+f(v)-5 b(alue)27 b(has)g(not)h(b)r(een)g(set.)340 3315
y Fi(\017)45 b Fj(An)28 b(error)e(will)i(result)f(if)h(an)g(attempt)g
(is)f(made)h(to)f(clear)g(the)h(v)-5 b(alue)27 b(of)h(a)f(read-only)f
-(attribute.)p 0 4908 V 0 5039 a FA(AST)p Fe(_)p FA(CLIP)965
-5040 y Fd(Set)39 b(up)g(or)f(remo)m(v)m(e)f(clipping)g(for)h(a)h(Plot)
-3128 5039 y FA(AST)p Fe(_)p FA(CLIP)0 5225 y Fc(Description:)44
+(attribute.)p 0 3527 V 0 3658 a FA(AST)p Fe(_)p FA(CLIP)965
+3659 y Fd(Set)39 b(up)g(or)f(remo)m(v)m(e)f(clipping)g(for)h(a)h(Plot)
+3128 3658 y FA(AST)p Fe(_)p FA(CLIP)0 3862 y Fc(Description:)44
b Fj(This)28 b(routine)g(de\014nes)g(regions)e(of)i(a)g(Plot)f(whic)n
(h)h(are)f(to)h(b)r(e)g(clipp)r(ed.)39 b(An)n(y)28 b(subsequen)n(t)f
-(graphical)227 5324 y(output)f(created)f(using)g(the)g(Plot)g(will)g
+(graphical)227 3961 y(output)f(created)f(using)g(the)g(Plot)g(will)g
(then)h(b)r(e)g(visible)f(only)g(within)h(the)g(unclipp)r(ed)g(regions)
-e(of)h(the)h(plotting)227 5424 y(area.)36 b(See)27 b(also)g(the)h(Clip)
-g(attribute.)0 5571 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
+e(of)h(the)h(plotting)227 4061 y(area.)36 b(See)27 b(also)g(the)h(Clip)
+g(attribute.)0 4224 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
b(AST_CLIP\()e(THIS,)h(IFRAME,)g(LBND,)g(UBND,)h(STATUS)f(\))0
-5718 y Fc(Argumen)m(ts:)p eop end
-%%Page: 201 211
-TeXDict begin 201 210 bop 3643 52 a FG(201)259 351 y
-Fc(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(Plot.)259 595 y Fc(IFRAME)j(=)h(INTEGER)g(\(Giv)m(en\))427
-694 y Fj(The)e(index)g(of)f(the)i(F)-7 b(rame)29 b(within)h(the)g(Plot)
-f(to)h(whic)n(h)g(the)g(clipping)f(limits)i(supplied)f(in)g(LBND)g(and)
-427 794 y(UBND)i(\(b)r(elo)n(w\))g(refer.)47 b(Clipping)31
+4387 y Fc(Argumen)m(ts:)259 4537 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 4637 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259
+4776 y Fc(IFRAME)j(=)h(INTEGER)g(\(Giv)m(en\))427 4876
+y Fj(The)e(index)g(of)f(the)i(F)-7 b(rame)29 b(within)h(the)g(Plot)f
+(to)h(whic)n(h)g(the)g(clipping)f(limits)i(supplied)f(in)g(LBND)g(and)
+427 4976 y(UBND)i(\(b)r(elo)n(w\))g(refer.)47 b(Clipping)31
b(ma)n(y)f(b)r(e)i(applied)f(to)g(an)n(y)g(of)g(the)g(co)r(ordinate)f
-(systems)h(asso)r(ciated)427 894 y(with)24 b(a)g(Plot)f(\(as)g
+(systems)h(asso)r(ciated)427 5075 y(with)24 b(a)g(Plot)f(\(as)g
(de\014ned)h(b)n(y)f(the)h(F)-7 b(rames)23 b(it)h(con)n(tains\),)g(so)f
(this)h(index)f(ma)n(y)g(tak)n(e)g(an)n(y)g(v)-5 b(alue)23
-b(from)h(1)f(to)427 993 y(the)31 b(n)n(um)n(b)r(er)e(of)h(F)-7
+b(from)h(1)f(to)427 5175 y(the)31 b(n)n(um)n(b)r(er)e(of)h(F)-7
b(rames)30 b(in)g(the)g(Plot)g(\(Nframe)g(attribute\).)45
b(In)30 b(addition,)g(the)h(v)-5 b(alues)29 b(AST)p Ft(__)p
-Fj(BASE)427 1093 y(and)f(AST)p Ft(__)p Fj(CURRENT)f(ma)n(y)g(b)r(e)h
+Fj(BASE)427 5274 y(and)f(AST)p Ft(__)p Fj(CURRENT)f(ma)n(y)g(b)r(e)h
(used)g(to)f(sp)r(ecify)h(the)g(base)f(and)g(curren)n(t)g(F)-7
-b(rames)27 b(resp)r(ectiv)n(ely)-7 b(.)427 1215 y(F)g(or)32
+b(rames)27 b(resp)r(ectiv)n(ely)-7 b(.)427 5394 y(F)g(or)32
b(example,)i(a)f(v)-5 b(alue)32 b(of)h(AST)p Ft(__)p
Fj(CURRENT)g(causes)e(clipping)i(to)g(b)r(e)g(p)r(erformed)f(in)i(ph)n
-(ysical)d(co-)427 1314 y(ordinates,)g(while)g(a)g(v)-5
+(ysical)d(co-)427 5494 y(ordinates,)g(while)g(a)g(v)-5
b(alue)31 b(of)g(AST)p Ft(__)p Fj(BASE)f(w)n(ould)h(clip)g(in)g
(graphical)f(co)r(ordinates.)45 b(Clipping)31 b(ma)n(y)427
-1414 y(also)24 b(b)r(e)h(remo)n(v)n(ed)e(completely)h(b)n(y)g(giving)g
+5593 y(also)24 b(b)r(e)h(remo)n(v)n(ed)e(completely)h(b)n(y)g(giving)g
(a)g(v)-5 b(alue)25 b(of)f(AST)p Ft(__)p Fj(NOFRAME.)g(In)h(this)g
-(case)f(an)n(y)g(clipping)427 1513 y(b)r(ounds)k(supplied)g(\(b)r(elo)n
-(w\))g(are)e(ignored.)259 1657 y Fc(LBND\()32 b Fi(\003)g
-Fc(\))g(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427 1757
-y Fj(An)43 b(arra)n(y)c(with)j(one)g(elemen)n(t)g(for)f(eac)n(h)g(axis)
-g(of)h(the)g(clipping)g(F)-7 b(rame)41 b(\(iden)n(ti\014ed)i(b)n(y)e
-(the)i(index)427 1857 y(IFRAME\).)c(This)g(should)f(con)n(tain)g(the)h
-(lo)n(w)n(er)e(b)r(ound,)k(on)d(eac)n(h)g(axis,)i(of)f(the)g(region)e
-(whic)n(h)h(is)h(to)427 1956 y(remain)27 b(visible)h(\(unclipp)r(ed\).)
-259 2100 y Fc(UBND\()k Fi(\003)g Fc(\))g(=)g(DOUBLE)g(PRECISION)f
-(\(Giv)m(en\))427 2200 y Fj(An)43 b(arra)n(y)c(with)j(one)g(elemen)n(t)
+(case)f(an)n(y)g(clipping)427 5693 y(b)r(ounds)k(supplied)g(\(b)r(elo)n
+(w\))g(are)e(ignored.)p eop end
+%%Page: 202 212
+TeXDict begin 202 211 bop 0 52 a FG(202)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(LBND\()h
+Fi(\003)g Fc(\))g(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427
+451 y Fj(An)43 b(arra)n(y)c(with)j(one)g(elemen)n(t)g(for)f(eac)n(h)g
+(axis)g(of)h(the)g(clipping)g(F)-7 b(rame)41 b(\(iden)n(ti\014ed)i(b)n
+(y)e(the)i(index)427 551 y(IFRAME\).)c(This)g(should)f(con)n(tain)g
+(the)h(lo)n(w)n(er)e(b)r(ound,)k(on)d(eac)n(h)g(axis,)i(of)f(the)g
+(region)e(whic)n(h)h(is)h(to)427 650 y(remain)27 b(visible)h(\(unclipp)
+r(ed\).)259 788 y Fc(UBND\()k Fi(\003)g Fc(\))g(=)g(DOUBLE)g(PRECISION)
+f(\(Giv)m(en\))427 888 y Fj(An)43 b(arra)n(y)c(with)j(one)g(elemen)n(t)
g(for)f(eac)n(h)g(axis)g(of)h(the)g(clipping)g(F)-7 b(rame)41
-b(\(iden)n(ti\014ed)i(b)n(y)e(the)i(index)427 2299 y(IFRAME\).)38
+b(\(iden)n(ti\014ed)i(b)n(y)e(the)i(index)427 987 y(IFRAME\).)38
b(This)f(should)g(con)n(tain)f(the)i(upp)r(er)f(b)r(ound,)j(on)d(eac)n
(h)f(axis,)j(of)e(the)h(region)e(whic)n(h)h(is)g(to)427
-2399 y(remain)27 b(visible)h(\(unclipp)r(ed\).)259 2543
+1087 y(remain)27 b(visible)h(\(unclipp)r(ed\).)259 1225
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 2642 y Fj(The)c(global)e(status.)0 2826 y Fc(Notes:)340
-3131 y Fi(\017)45 b Fj(Only)22 b(one)g(clipping)g(F)-7
+427 1324 y Fj(The)c(global)e(status.)0 1496 y Fc(Notes:)340
+1788 y Fi(\017)45 b Fj(Only)22 b(one)g(clipping)g(F)-7
b(rame)21 b(ma)n(y)g(b)r(e)i(activ)n(e)e(at)h(a)g(time.)35
b(This)22 b(routine)g(will)g(deactiv)-5 b(ate)22 b(an)n(y)f
-(previously-)427 3230 y(established)28 b(clipping)f(F)-7
+(previously-)427 1888 y(established)28 b(clipping)f(F)-7
b(rame)27 b(b)r(efore)h(setting)f(up)h(new)g(clipping)f(limits.)340
-3374 y Fi(\017)45 b Fj(The)32 b(clipping)f(pro)r(duced)g(b)n(y)g(this)h
+2026 y Fi(\017)45 b Fj(The)32 b(clipping)f(pro)r(duced)g(b)n(y)g(this)h
(routine)f(is)g(in)h(addition)f(to)h(that)f(sp)r(eci\014ed)h(b)n(y)f
-(the)h(Clip)f(attribute)427 3474 y(whic)n(h)40 b(o)r(ccurs)f(at)g(the)h
+(the)h(Clip)f(attribute)427 2125 y(whic)n(h)40 b(o)r(ccurs)f(at)g(the)h
(edges)f(of)h(the)g(plotting)g(area)e(established)h(when)h(the)g(Plot)f
-(is)h(created)f(\(see)427 3574 y(AST)p Ft(_)p Fj(PLOT\).)27
+(is)h(created)f(\(see)427 2225 y(AST)p Ft(_)p Fj(PLOT\).)27
b(The)h(underlying)f(graphics)f(system)h(ma)n(y)g(also)g(imp)r(ose)g
-(further)h(clipping.)340 3717 y Fi(\017)45 b Fj(When)25
+(further)h(clipping.)340 2363 y Fi(\017)45 b Fj(When)25
b(testing)f(a)f(graphical)g(p)r(osition)h(for)f(clipping,)i(it)f(is)g
(\014rst)g(transformed)f(in)n(to)h(the)g(clipping)g(F)-7
-b(rame.)427 3817 y(The)33 b(resulting)f(co)r(ordinate)g(on)g(eac)n(h)g
+b(rame.)427 2462 y(The)33 b(resulting)f(co)r(ordinate)g(on)g(eac)n(h)g
(axis)g(is)h(then)g(c)n(hec)n(k)n(ed)f(against)f(the)j(clipping)e
-(limits)i(\(giv)n(en)e(b)n(y)427 3917 y(LBND)21 b(and)g(UBND\).)h(By)e
+(limits)i(\(giv)n(en)e(b)n(y)427 2562 y(LBND)21 b(and)g(UBND\).)h(By)e
(default,)j(a)d(p)r(osition)g(is)h(clipp)r(ed)g(if)g(an)n(y)f(co)r
-(ordinate)f(lies)i(outside)f(these)h(limits.)427 4016
+(ordinate)f(lies)i(outside)f(these)h(limits.)427 2662
y(Ho)n(w)n(ev)n(er,)h(if)i(a)e(non-zero)g(v)-5 b(alue)22
b(is)h(assigned)f(to)h(the)g(Plot's)f(ClipOp)h(attribute,)h(then)g(a)e
-(p)r(osition)h(is)g(only)427 4116 y(clipp)r(ed)29 b(if)f(the)g(co)r
+(p)r(osition)h(is)g(only)427 2761 y(clipp)r(ed)29 b(if)f(the)g(co)r
(ordinates)e(on)h(all)g(axes)g(lie)h(outside)f(their)h(clipping)f
-(limits.)340 4260 y Fi(\017)45 b Fj(If)28 b(the)f(lo)n(w)n(er)f
+(limits.)340 2899 y Fi(\017)45 b Fj(If)28 b(the)f(lo)n(w)n(er)f
(clipping)h(limit)h(exceeds)e(the)i(upp)r(er)f(limit)h(for)e(an)n(y)h
(axis,)f(then)i(the)f(sense)g(of)g(clipping)g(for)427
-4359 y(that)k(axis)f(is)g(rev)n(ersed)f(\(so)h(that)h(co)r(ordinate)e
+2999 y(that)k(axis)f(is)g(rev)n(ersed)f(\(so)h(that)h(co)r(ordinate)e
(v)-5 b(alues)30 b(lying)h(b)r(et)n(w)n(een)f(the)h(limits)g(are)f
-(clipp)r(ed)h(instead)427 4459 y(of)k(those)g(lying)g(outside)g(the)g
+(clipp)r(ed)h(instead)427 3098 y(of)k(those)g(lying)g(outside)g(the)g
(limits\).)61 b(T)-7 b(o)34 b(pro)r(duce)h(a)g Ft(")p
Fj(hole)p Ft(")f Fj(in)h(a)g(co)r(ordinate)f(space)g(\(that)i(is,)h(an)
-427 4559 y(in)n(ternal)24 b(region)g(where)g(nothing)h(is)f(plotted\),)
+427 3198 y(in)n(ternal)24 b(region)g(where)g(nothing)h(is)f(plotted\),)
i(y)n(ou)e(should)h(supply)g(all)f(the)h(b)r(ounds)g(in)g(rev)n(ersed)e
-(order,)427 4658 y(and)28 b(set)f(the)h(ClipOp)g(attribute)g(for)f(the)
-h(Plot)f(to)g(a)g(non-zero)f(v)-5 b(alue.)340 4802 y
+(order,)427 3297 y(and)28 b(set)f(the)h(ClipOp)g(attribute)g(for)f(the)
+h(Plot)f(to)g(a)g(non-zero)f(v)-5 b(alue.)340 3435 y
Fi(\017)45 b Fj(Either)25 b(clipping)h(limit)g(ma)n(y)f(b)r(e)h(set)f
(to)h(the)g(v)-5 b(alue)25 b(AST)p Ft(__)p Fj(BAD,)h(whic)n(h)f(is)h
(equiv)-5 b(alen)n(t)25 b(to)g(setting)h(it)g(to)427
-4902 y(in\014nit)n(y)i(\(or)f(min)n(us)h(in\014nit)n(y)g(for)f(a)g(lo)n
+3535 y(in\014nit)n(y)i(\(or)f(min)n(us)h(in\014nit)n(y)g(for)f(a)g(lo)n
(w)n(er)f(b)r(ound\))i(so)f(that)h(it)g(is)g(not)f(used.)340
-5046 y Fi(\017)45 b Fj(If)29 b(a)e(graphical)f(p)r(osition)i(results)f
+3673 y Fi(\017)45 b Fj(If)29 b(a)e(graphical)f(p)r(osition)i(results)f
(in)h(an)n(y)f(bad)h(co)r(ordinate)f(v)-5 b(alues)27
-b(\(AST)p Ft(__)p Fj(BAD\))i(when)f(transformed)427 5145
+b(\(AST)p Ft(__)p Fj(BAD\))i(when)f(transformed)427 3772
y(in)n(to)i(the)h(clipping)f(F)-7 b(rame,)31 b(then)g(it)g(is)f
(treated)g(\(for)g(the)h(purp)r(oses)e(of)h(pro)r(ducing)g(graphical)f
-(output\))427 5245 y(as)e(if)h(it)g(w)n(ere)f(clipp)r(ed.)340
-5389 y Fi(\017)45 b Fj(When)23 b(a)f(Plot)g(is)g(used)g(as)g(a)f
+(output\))427 3872 y(as)e(if)h(it)g(w)n(ere)f(clipp)r(ed.)340
+4010 y Fi(\017)45 b Fj(When)23 b(a)f(Plot)g(is)g(used)g(as)g(a)f
(Mapping)h(to)g(transform)g(p)r(oin)n(ts)g(\(e.g.)35
b(using)22 b(AST)p Ft(_)p Fj(TRAN2\),)h(an)n(y)f(clipp)r(ed)427
-5488 y(output)28 b(p)r(oin)n(ts)g(are)f(assigned)f(co)r(ordinate)g(v)-5
-b(alues)28 b(of)f(AST)p Ft(__)p Fj(BAD.)340 5632 y Fi(\017)45
+4109 y(output)28 b(p)r(oin)n(ts)g(are)f(assigned)f(co)r(ordinate)g(v)-5
+b(alues)28 b(of)f(AST)p Ft(__)p Fj(BAD.)340 4247 y Fi(\017)45
b Fj(An)28 b(error)e(results)h(if)h(the)g(base)f(F)-7
b(rame)27 b(of)h(the)g(Plot)f(is)g(not)h(2-dimensional.)p
-eop end
-%%Page: 202 212
-TeXDict begin 202 211 bop 0 52 a FG(202)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(CLONE)968 490 y Fd(Clone)38
-b(\(duplicate\))e(an)i(Ob)7 b(ject)38 b(p)s(oin)m(ter)2976
-482 y FA(AST)p Fe(_)p FA(CLONE)0 692 y Fc(Description:)44
-b Fj(This)34 b(function)g(returns)f(a)g(duplicate)h(p)r(oin)n(ter)f(to)
-h(an)f(existing)g(Ob)5 b(ject.)55 b(It)34 b(also)e(incremen)n(ts)h(the)
-227 791 y(Ob)5 b(ject's)28 b(RefCoun)n(t)f(attribute)h(to)g(k)n(eep)f
-(trac)n(k)f(of)i(ho)n(w)f(man)n(y)g(p)r(oin)n(ters)f(ha)n(v)n(e)h(b)r
-(een)h(issued.)227 919 y(Note)40 b(that)g(this)g(function)g(is)f(NOT)h
+0 4456 3780 12 v 0 4587 a FA(AST)p Fe(_)p FA(CLONE)968
+4594 y Fd(Clone)38 b(\(duplicate\))e(an)i(Ob)7 b(ject)38
+b(p)s(oin)m(ter)2976 4587 y FA(AST)p Fe(_)p FA(CLONE)0
+4800 y Fc(Description:)44 b Fj(This)34 b(function)g(returns)f(a)g
+(duplicate)h(p)r(oin)n(ter)f(to)h(an)f(existing)g(Ob)5
+b(ject.)55 b(It)34 b(also)e(incremen)n(ts)h(the)227 4899
+y(Ob)5 b(ject's)28 b(RefCoun)n(t)f(attribute)h(to)g(k)n(eep)f(trac)n(k)
+f(of)i(ho)n(w)f(man)n(y)g(p)r(oin)n(ters)f(ha)n(v)n(e)h(b)r(een)h
+(issued.)227 5029 y(Note)40 b(that)g(this)g(function)g(is)f(NOT)h
(equiv)-5 b(alen)n(t)39 b(to)g(an)g(assignmen)n(t)g(statemen)n(t,)k(as)
-38 b(in)i(general)e(the)i(t)n(w)n(o)227 1019 y(p)r(oin)n(ters)27
+38 b(in)i(general)e(the)i(t)n(w)n(o)227 5129 y(p)r(oin)n(ters)27
b(will)h(not)g(ha)n(v)n(e)e(the)i(same)f(v)-5 b(alue.)0
-1175 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_CLONE\()c
-(THIS,)j(STATUS)f(\))0 1331 y Fc(Argumen)m(ts:)259 1474
-y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1574 y Fj(Original)26
-b(p)r(oin)n(ter)i(to)f(the)h(Ob)5 b(ject.)259 1710 y
+5288 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_CLONE\()c
+(THIS,)j(STATUS)f(\))0 5447 y Fc(Argumen)m(ts:)259 5593
+y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 5693 y Fj(Original)26
+b(p)r(oin)n(ter)i(to)f(the)h(Ob)5 b(ject.)p eop end
+%%Page: 203 213
+TeXDict begin 203 212 bop 3643 52 a FG(203)259 351 y
Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-1810 y Fj(The)c(global)e(status.)0 1978 y Fc(Class)31
-b(Applicabilit)m(y:)259 2121 y(Ob)5 b(ject)427 2221 y
-Fj(This)28 b(function)g(applies)f(to)h(all)f(Ob)5 b(jects.)0
-2390 y Fc(Returned)32 b(V)-8 b(alue:)259 2533 y(AST)p
-Ft(_)p Fc(CLONE)32 b(=)g(INTEGER)427 2632 y Fj(A)c(duplicate)g(p)r(oin)
-n(ter)f(to)h(the)g(same)f(Ob)5 b(ject.)0 2801 y Fc(Notes:)340
-3090 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20
-b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e
-(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 3190 y(set)28 b(to)f(an)h(error)d(v)-5
-b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-0 3396 V 0 3526 a FA(AST)p Fe(_)p FA(CMPFRAME)216 b Fd(Create)37
-b(a)h(CmpF)-10 b(rame)217 b FA(AST)p Fe(_)p FA(CMPFRAME)0
-3722 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
-(CmpF)-7 b(rame)28 b(and)f(optionally)g(initialises)g(its)h
-(attributes.)227 3849 y(A)40 b(CmpF)-7 b(rame)38 b(is)h(a)f(comp)r
-(ound)h(F)-7 b(rame)39 b(whic)n(h)g(allo)n(ws)e(t)n(w)n(o)h(comp)r
-(onen)n(t)h(F)-7 b(rames)38 b(\(of)h(an)n(y)f(class\))g(to)h(b)r(e)227
-3949 y(merged)34 b(together)h(to)f(form)h(a)g(more)f(complex)g(F)-7
+451 y Fj(The)c(global)e(status.)0 619 y Fc(Class)31 b(Applicabilit)m
+(y:)259 761 y(Ob)5 b(ject)427 861 y Fj(This)28 b(function)g(applies)f
+(to)h(all)f(Ob)5 b(jects.)0 1029 y Fc(Returned)32 b(V)-8
+b(alue:)259 1171 y(AST)p Ft(_)p Fc(CLONE)32 b(=)g(INTEGER)427
+1271 y Fj(A)c(duplicate)g(p)r(oin)n(ter)f(to)h(the)g(same)f(Ob)5
+b(ject.)0 1438 y Fc(Notes:)340 1727 y Fi(\017)45 b Fj(A)21
+b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
+Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 1826
+y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 2032 3780 12 v 0 2162
+a FA(AST)p Fe(_)p FA(CMPFRAME)216 b Fd(Create)37 b(a)h(CmpF)-10
+b(rame)217 b FA(AST)p Fe(_)p FA(CMPFRAME)0 2357 y Fc(Description:)44
+b Fj(This)28 b(function)g(creates)f(a)g(new)g(CmpF)-7
+b(rame)28 b(and)f(optionally)g(initialises)g(its)h(attributes.)227
+2484 y(A)40 b(CmpF)-7 b(rame)38 b(is)h(a)f(comp)r(ound)h(F)-7
+b(rame)39 b(whic)n(h)g(allo)n(ws)e(t)n(w)n(o)h(comp)r(onen)n(t)h(F)-7
+b(rames)38 b(\(of)h(an)n(y)f(class\))g(to)h(b)r(e)227
+2584 y(merged)34 b(together)h(to)f(form)h(a)g(more)f(complex)g(F)-7
b(rame.)59 b(The)35 b(axes)f(of)h(the)g(t)n(w)n(o)f(comp)r(onen)n(t)h
-(F)-7 b(rames)34 b(then)227 4049 y(app)r(ear)i(together)g(in)h(the)g
+(F)-7 b(rames)34 b(then)227 2684 y(app)r(ear)i(together)g(in)h(the)g
(resulting)f(CmpF)-7 b(rame)36 b(\(those)h(of)f(the)h(\014rst)g(F)-7
b(rame,)38 b(follo)n(w)n(ed)e(b)n(y)g(those)h(of)f(the)227
-4148 y(second)27 b(F)-7 b(rame\).)227 4276 y(Since)24
+2783 y(second)27 b(F)-7 b(rame\).)227 2911 y(Since)24
b(a)f(CmpF)-7 b(rame)23 b(is)g(itself)h(a)f(F)-7 b(rame,)24
b(it)g(can)f(b)r(e)g(used)h(as)e(a)h(comp)r(onen)n(t)g(in)h(forming)f
-(further)g(CmpF)-7 b(rames.)227 4376 y(F)g(rames)27 b(of)h(arbitrary)d
+(further)g(CmpF)-7 b(rames.)227 3010 y(F)g(rames)27 b(of)h(arbitrary)d
(complexit)n(y)i(ma)n(y)g(b)r(e)h(built)g(from)g(simple)f(individual)h
-(F)-7 b(rames)27 b(in)h(this)g(w)n(a)n(y)-7 b(.)227 4504
+(F)-7 b(rames)27 b(in)h(this)g(w)n(a)n(y)-7 b(.)227 3138
y(Also)39 b(since)f(a)h(F)-7 b(rame)38 b(is)h(a)f(Mapping,)j(a)e(CmpF)
-7 b(rame)38 b(can)h(also)f(b)r(e)h(used)g(as)f(a)g(Mapping.)70
-b(Normally)-7 b(,)41 b(a)227 4603 y(CmpF)-7 b(rame)35
+b(Normally)-7 b(,)41 b(a)227 3237 y(CmpF)-7 b(rame)35
b(is)g(simply)h(equiv)-5 b(alen)n(t)35 b(to)g(a)g(UnitMap,)i(but)f(if)g
(either)f(of)g(the)h(comp)r(onen)n(t)f(F)-7 b(rames)34
-b(within)i(a)227 4703 y(CmpF)-7 b(rame)41 b(is)f(a)g(Region)g(\(a)g
+b(within)i(a)227 3337 y(CmpF)-7 b(rame)41 b(is)f(a)g(Region)g(\(a)g
(sub-class)g(of)g(F)-7 b(rame\),)44 b(then)d(the)g(CmpF)-7
-b(rame)40 b(will)h(use)f(the)h(Region)f(as)g(a)227 4803
+b(rame)40 b(will)h(use)f(the)h(Region)f(as)g(a)227 3437
y(Mapping)g(when)g(transforming)e(v)-5 b(alues)39 b(for)g(axes)g
(describ)r(ed)h(b)n(y)f(the)h(Region.)73 b(Th)n(us)39
-b(input)i(axis)e(v)-5 b(alues)227 4902 y(corresp)r(onding)26
+b(input)i(axis)e(v)-5 b(alues)227 3536 y(corresp)r(onding)26
b(to)h(p)r(ositions)h(whic)n(h)f(are)g(outside)g(the)h(Region)f(will)h
(result)f(in)h(bad)f(output)i(axis)d(v)-5 b(alues.)0
-5058 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_CMPFRAME\()
-38 b(FRAME1,)j(FRAME2,)g(OPTIONS,)f(STATUS)h(\))0 5214
-y Fc(Argumen)m(ts:)259 5358 y(FRAME1)31 b(=)h(INTEGER)f(\(Giv)m(en\))
-427 5457 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f(comp)r(onen)n(t)g
-(F)-7 b(rame.)259 5593 y Fc(FRAME2)31 b(=)h(INTEGER)f(\(Giv)m(en\))427
-5693 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(second)f(comp)r(onen)n(t)g(F)-7
-b(rame.)p eop end
-%%Page: 203 213
-TeXDict begin 203 212 bop 3643 52 a FG(203)259 351 y
-Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 451 y Fj(A)g(c)n(haracter)e(string)h
-(con)n(taining)f(an)h(optional)g(comma-separated)e(list)j(of)g
-(attribute)f(assignmen)n(ts)g(to)427 551 y(b)r(e)38 b(used)g(for)f
-(initialising)h(the)g(new)g(CmpF)-7 b(rame.)67 b(The)38
-b(syn)n(tax)e(used)i(is)g(iden)n(tical)f(to)h(that)g(for)f(the)427
-650 y(AST)p Ft(_)p Fj(SET)27 b(routine.)259 779 y Fc(ST)-8
-b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-878 y Fj(The)c(global)e(status.)0 1036 y Fc(Returned)32
-b(V)-8 b(alue:)259 1169 y(AST)p Ft(_)p Fc(CMPFRAME)31
-b(=)h(INTEGER)427 1268 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(CmpF)
--7 b(rame.)0 1426 y Fc(Notes:)340 1704 y Fi(\017)45 b
-Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
+3692 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_CMPFRAME\()
+38 b(FRAME1,)j(FRAME2,)g(OPTIONS,)f(STATUS)h(\))0 3847
+y Fc(Argumen)m(ts:)259 3990 y(FRAME1)31 b(=)h(INTEGER)f(\(Giv)m(en\))
+427 4089 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f(comp)r(onen)n(t)g
+(F)-7 b(rame.)259 4225 y Fc(FRAME2)31 b(=)h(INTEGER)f(\(Giv)m(en\))427
+4325 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(second)f(comp)r(onen)n(t)g(F)-7
+b(rame.)259 4460 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g
+Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
+4560 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h(optional)g
+(comma-separated)e(list)j(of)g(attribute)f(assignmen)n(ts)g(to)427
+4660 y(b)r(e)38 b(used)g(for)f(initialising)h(the)g(new)g(CmpF)-7
+b(rame.)67 b(The)38 b(syn)n(tax)e(used)i(is)g(iden)n(tical)f(to)h(that)
+g(for)f(the)427 4759 y(AST)p Ft(_)p Fj(SET)27 b(routine.)259
+4895 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 4995 y Fj(The)c(global)e(status.)0 5163
+y Fc(Returned)32 b(V)-8 b(alue:)259 5305 y(AST)p Ft(_)p
+Fc(CMPFRAME)31 b(=)h(INTEGER)427 5405 y Fj(A)c(p)r(oin)n(ter)f(to)h
+(the)g(new)g(CmpF)-7 b(rame.)0 5572 y Fc(Notes:)p eop
+end
+%%Page: 204 214
+TeXDict begin 204 213 bop 0 52 a FG(204)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 1804
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 451
y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)-2 1962 y Fc(Status)33
-b(Handling)n(:)227 2108 y Fj(The)d(protected)g(in)n(terface)f(to)g
-(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
-(of)g(the)g(parameter)227 2208 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
-(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
-(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
-Fj(in)n(t)227 2307 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p
-0 2498 3780 12 v 0 2629 a FA(AST)p Fe(_)p FA(CMPMAP)441
-b Fd(Create)38 b(a)g(CmpMap)444 b FA(AST)p Fe(_)p FA(CMPMAP)0
-2809 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+(fail)h(for)f(an)n(y)g(reason.)-2 630 y Fc(Status)33
+b(Handling)n(:)227 776 y Fj(The)d(protected)g(in)n(terface)f(to)g(this)
+h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g
+(the)g(parameter)227 876 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62
+b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)
+e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fj(in)n(t)227
+975 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p 0 1192 3780
+12 v 0 1322 a FA(AST)p Fe(_)p FA(CMPMAP)441 b Fd(Create)38
+b(a)g(CmpMap)444 b FA(AST)p Fe(_)p FA(CMPMAP)0 1528 y
+Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
(CmpMap)h(and)f(optionally)g(initialises)h(its)f(attributes.)227
-2932 y(A)k(CmpMap)g(is)g(a)f(comp)r(ound)h(Mapping)f(whic)n(h)h(allo)n
+1661 y(A)k(CmpMap)g(is)g(a)f(comp)r(ound)h(Mapping)f(whic)n(h)h(allo)n
(ws)e(t)n(w)n(o)h(comp)r(onen)n(t)h(Mappings)f(\(of)h(an)n(y)f(class\))
-g(to)g(b)r(e)227 3031 y(connected)h(together)e(to)h(form)g(a)g(more)g
+g(to)g(b)r(e)227 1761 y(connected)h(together)e(to)h(form)g(a)g(more)g
(complex)g(Mapping.)45 b(This)30 b(connection)g(ma)n(y)g(either)g(b)r
-(e)h Ft(")p Fj(in)f(series)p Ft(")227 3131 y Fj(\(where)21
+(e)h Ft(")p Fj(in)f(series)p Ft(")227 1861 y Fj(\(where)21
b(the)g(\014rst)g(Mapping)f(is)h(used)g(to)g(transform)f(the)h(co)r
(ordinates)e(of)i(eac)n(h)f(p)r(oin)n(t)i(and)e(the)i(second)e(mapping)
-227 3231 y(is)g(then)g(applied)f(to)g(the)h(result\),)h(or)e
+227 1960 y(is)g(then)g(applied)f(to)g(the)h(result\),)h(or)e
Ft(")p Fj(in)g(parallel)p Ft(")f Fj(\(where)h(one)g(Mapping)g
-(transforms)f(the)i(earlier)e(co)r(ordinates)227 3330
+(transforms)f(the)i(earlier)e(co)r(ordinates)227 2060
y(for)27 b(eac)n(h)g(p)r(oin)n(t)h(and)f(the)h(second)f(Mapping)h(sim)n
(ultaneously)e(transforms)g(the)i(later)f(co)r(ordinates\).)227
-3453 y(Since)f(a)f(CmpMap)g(is)h(itself)g(a)f(Mapping,)g(it)h(can)f(b)r
+2193 y(Since)f(a)f(CmpMap)g(is)h(itself)g(a)f(Mapping,)g(it)h(can)f(b)r
(e)h(used)f(as)g(a)g(comp)r(onen)n(t)g(in)h(forming)e(further)i
-(CmpMaps.)227 3552 y(Mappings)h(of)h(arbitrary)d(complexit)n(y)i(ma)n
+(CmpMaps.)227 2293 y(Mappings)h(of)h(arbitrary)d(complexit)n(y)i(ma)n
(y)g(b)r(e)h(built)h(from)e(simple)h(individual)f(Mappings)g(in)h(this)
-g(w)n(a)n(y)-7 b(.)0 3698 y Fc(In)m(v)m(o)s(cation:)123
+g(w)n(a)n(y)-7 b(.)0 2459 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_CMPMAP\()c(MAP1,)j(MAP2,)f(SERIES,)g(OPTIONS,)
-f(STATUS)h(\))0 3843 y Fc(Argumen)m(ts:)259 3975 y(MAP1)32
-b(=)g(INTEGER)f(\(Giv)m(en\))427 4075 y Fj(P)n(oin)n(ter)26
+f(STATUS)h(\))0 2626 y Fc(Argumen)m(ts:)259 2780 y(MAP1)32
+b(=)g(INTEGER)f(\(Giv)m(en\))427 2879 y Fj(P)n(oin)n(ter)26
b(to)i(the)g(\014rst)f(comp)r(onen)n(t)g(Mapping.)259
-4204 y Fc(MAP2)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 4303
+3021 y Fc(MAP2)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 3120
y Fj(P)n(oin)n(ter)26 b(to)i(the)g(second)f(comp)r(onen)n(t)g(Mapping.)
-259 4432 y Fc(SERIES)k(=)h(LOGICAL)h(\(Giv)m(en\))427
-4532 y Fj(If)25 b(a)f(.TR)n(UE.)h(v)-5 b(alue)24 b(is)h(giv)n(en)f(for)
+259 3262 y Fc(SERIES)k(=)h(LOGICAL)h(\(Giv)m(en\))427
+3361 y Fj(If)25 b(a)f(.TR)n(UE.)h(v)-5 b(alue)24 b(is)h(giv)n(en)f(for)
g(this)h(argumen)n(t,)f(the)h(t)n(w)n(o)f(comp)r(onen)n(t)g(Mappings)g
-(will)h(b)r(e)g(connected)427 4631 y(in)j(series.)36
+(will)h(b)r(e)g(connected)427 3461 y(in)j(series.)36
b(A)28 b(.F)-9 b(ALSE.)27 b(v)-5 b(alue)28 b(requests)f(that)h(they)f
-(are)g(connected)g(in)h(parallel.)259 4760 y Fc(OPTIONS)k(=)g(CHARA)m
+(are)g(connected)g(in)h(parallel.)259 3602 y Fc(OPTIONS)k(=)g(CHARA)m
(CTER)g Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-4860 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)
+3702 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)
f(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r
-(e)427 4959 y(used)j(for)g(initialising)f(the)h(new)g(CmpMap.)36
+(e)427 3802 y(used)j(for)g(initialising)f(the)h(new)g(CmpMap.)36
b(The)24 b(syn)n(tax)f(used)h(is)g(iden)n(tical)f(to)h(that)g(for)g
-(the)g(AST)p Ft(_)p Fj(SET)427 5059 y(routine.)259 5188
+(the)g(AST)p Ft(_)p Fj(SET)427 3901 y(routine.)259 4043
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 5287 y Fj(The)c(global)e(status.)0 5445 y Fc(Returned)32
-b(V)-8 b(alue:)259 5577 y(AST)p Ft(_)p Fc(CMPMAP)32 b(=)g(INTEGER)427
-5677 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(CmpMap.)p
-eop end
-%%Page: 204 214
-TeXDict begin 204 213 bop 0 52 a FG(204)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Notes:)340
-649 y Fi(\017)45 b Fj(If)37 b(the)g(comp)r(onen)n(t)g(Mappings)f(are)g
-(connected)g(in)h(series,)h(then)f(using)g(the)g(resulting)f(CmpMap)h
-(to)427 749 y(transform)g(co)r(ordinates)g(will)i(cause)e(the)i
-(\014rst)f(Mapping)g(to)g(b)r(e)g(applied,)j(follo)n(w)n(ed)d(b)n(y)g
-(the)g(second)427 849 y(Mapping.)e(If)26 b(the)h(in)n(v)n(erse)d
-(CmpMap)i(transformation)e(is)i(requested,)f(the)i(t)n(w)n(o)e(comp)r
-(onen)n(t)g(Mappings)427 948 y(will)j(b)r(e)g(applied)g(in)g(b)r(oth)g
-(the)g(rev)n(erse)d(order)h(and)i(the)g(rev)n(erse)e(direction.)340
-1089 y Fi(\017)45 b Fj(When)27 b(connecting)f(t)n(w)n(o)g(comp)r(onen)n
-(t)g(Mappings)f(in)i(series,)e(the)i(n)n(um)n(b)r(er)f(of)h(output)f
-(co)r(ordinates)f(gen-)427 1189 y(erated)h(b)n(y)g(the)g(\014rst)g
-(Mapping)g(\(its)h(Nout)f(attribute\))h(m)n(ust)f(equal)f(the)i(n)n(um)
-n(b)r(er)f(of)g(input)h(co)r(ordinates)427 1288 y(accepted)h(b)n(y)f
-(the)h(second)f(Mapping)g(\(its)h(Nin)g(attribute\).)340
-1429 y Fi(\017)45 b Fj(If)19 b(the)g(comp)r(onen)n(t)g(Mappings)f(of)h
-(a)f(CmpMap)h(are)e(connected)i(in)g(parallel,)g(then)h(the)f(\014rst)f
-(Mapping)g(will)427 1529 y(b)r(e)28 b(used)f(to)g(transform)g(the)g
+427 4142 y Fj(The)c(global)e(status.)0 4321 y Fc(Returned)32
+b(V)-8 b(alue:)259 4475 y(AST)p Ft(_)p Fc(CMPMAP)32 b(=)g(INTEGER)427
+4575 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(CmpMap.)0
+4754 y Fc(Notes:)340 5053 y Fi(\017)45 b Fj(If)37 b(the)g(comp)r(onen)n
+(t)g(Mappings)f(are)g(connected)g(in)h(series,)h(then)f(using)g(the)g
+(resulting)f(CmpMap)h(to)427 5153 y(transform)g(co)r(ordinates)g(will)i
+(cause)e(the)i(\014rst)f(Mapping)g(to)g(b)r(e)g(applied,)j(follo)n(w)n
+(ed)d(b)n(y)g(the)g(second)427 5253 y(Mapping.)e(If)26
+b(the)h(in)n(v)n(erse)d(CmpMap)i(transformation)e(is)i(requested,)f
+(the)i(t)n(w)n(o)e(comp)r(onen)n(t)g(Mappings)427 5352
+y(will)j(b)r(e)g(applied)g(in)g(b)r(oth)g(the)g(rev)n(erse)d(order)h
+(and)i(the)g(rev)n(erse)e(direction.)340 5494 y Fi(\017)45
+b Fj(When)27 b(connecting)f(t)n(w)n(o)g(comp)r(onen)n(t)g(Mappings)f
+(in)i(series,)e(the)i(n)n(um)n(b)r(er)f(of)h(output)f(co)r(ordinates)f
+(gen-)427 5593 y(erated)h(b)n(y)g(the)g(\014rst)g(Mapping)g(\(its)h
+(Nout)f(attribute\))h(m)n(ust)f(equal)f(the)i(n)n(um)n(b)r(er)f(of)g
+(input)h(co)r(ordinates)427 5693 y(accepted)h(b)n(y)f(the)h(second)f
+(Mapping)g(\(its)h(Nin)g(attribute\).)p eop end
+%%Page: 205 215
+TeXDict begin 205 214 bop 3643 52 a FG(205)340 351 y
+Fi(\017)45 b Fj(If)19 b(the)g(comp)r(onen)n(t)g(Mappings)f(of)h(a)f
+(CmpMap)h(are)e(connected)i(in)g(parallel,)g(then)h(the)f(\014rst)f
+(Mapping)g(will)427 451 y(b)r(e)28 b(used)f(to)g(transform)g(the)g
(earlier)f(input)i(co)r(ordinates)e(for)h(eac)n(h)f(p)r(oin)n(t)i
-(\(and)f(to)g(pro)r(duce)g(the)h(earlier)427 1628 y(output)34
+(\(and)f(to)g(pro)r(duce)g(the)h(earlier)427 551 y(output)34
b(co)r(ordinates\))e(and)g(the)i(second)e(Mapping)h(will)g(b)r(e)h
(used)e(sim)n(ultaneously)h(to)f(transform)g(the)427
-1728 y(remaining)f(input)i(co)r(ordinates)e(\(to)h(pro)r(duce)g(the)h
+650 y(remaining)f(input)i(co)r(ordinates)e(\(to)h(pro)r(duce)g(the)h
(remaining)e(output)h(co)r(ordinates)f(for)h(eac)n(h)f(p)r(oin)n(t\).)
-427 1827 y(If)37 b(the)g(in)n(v)n(erse)e(transformation)f(is)j
+427 750 y(If)37 b(the)g(in)n(v)n(erse)e(transformation)f(is)j
(requested,)g(eac)n(h)f(Mapping)g(will)h(still)f(b)r(e)h(applied)f(to)g
-(the)h(same)427 1927 y(co)r(ordinates,)27 b(but)h(in)g(the)g(rev)n
-(erse)d(direction.)340 2068 y Fi(\017)45 b Fj(When)27
-b(connecting)e(t)n(w)n(o)g(comp)r(onen)n(t)g(Mappings)g(in)h(parallel,)
-f(there)h(is)f(no)h(restriction)e(on)i(the)g(n)n(um)n(b)r(er)427
-2167 y(of)i(input)g(and)g(output)g(co)r(ordinates)e(for)h(eac)n(h)g
-(Mapping.)340 2308 y Fi(\017)45 b Fj(Note)35 b(that)h(the)f(comp)r
-(onen)n(t)g(Mappings)g(supplied)g(are)f(not)h(copied)g(b)n(y)g(AST)p
-Ft(_)p Fj(CMPMAP)g(\(the)h(new)427 2408 y(CmpMap)41 b(simply)f(retains)
+(the)h(same)427 849 y(co)r(ordinates,)27 b(but)h(in)g(the)g(rev)n(erse)
+d(direction.)340 971 y Fi(\017)45 b Fj(When)27 b(connecting)e(t)n(w)n
+(o)g(comp)r(onen)n(t)g(Mappings)g(in)h(parallel,)f(there)h(is)f(no)h
+(restriction)e(on)i(the)g(n)n(um)n(b)r(er)427 1070 y(of)i(input)g(and)g
+(output)g(co)r(ordinates)e(for)h(eac)n(h)g(Mapping.)340
+1191 y Fi(\017)45 b Fj(Note)35 b(that)h(the)f(comp)r(onen)n(t)g
+(Mappings)g(supplied)g(are)f(not)h(copied)g(b)n(y)g(AST)p
+Ft(_)p Fj(CMPMAP)g(\(the)h(new)427 1291 y(CmpMap)41 b(simply)f(retains)
g(a)g(reference)f(to)h(them\).)76 b(They)41 b(ma)n(y)e(con)n(tin)n(ue)h
-(to)g(b)r(e)h(used)f(for)g(other)427 2507 y(purp)r(oses,)i(but)f
+(to)g(b)r(e)h(used)f(for)g(other)427 1391 y(purp)r(oses,)i(but)f
(should)e(not)h(b)r(e)g(deleted.)74 b(If)40 b(a)f(CmpMap)h(con)n
(taining)f(a)g(cop)n(y)g(of)h(its)g(comp)r(onen)n(t)427
-2607 y(Mappings)27 b(is)h(required,)e(then)j(a)e(cop)n(y)f(of)i(the)g
+1490 y(Mappings)27 b(is)h(required,)e(then)j(a)e(cop)n(y)f(of)i(the)g
(CmpMap)g(should)f(b)r(e)h(made)f(using)h(AST)p Ft(_)p
-Fj(COPY.)340 2748 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+Fj(COPY.)340 1611 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 2847 y(set)28 b(to)f(an)h(error)d(v)-5
+b(A)g(TUS)427 1711 y(set)28 b(to)f(an)h(error)d(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-0 3062 3780 12 v 0 3193 a FA(AST)p Fe(_)p FA(CMPREGION)152
+0 1887 3780 12 v 0 2017 a FA(AST)p Fe(_)p FA(CMPREGION)152
b Fd(Create)38 b(a)g(CmpRegion)152 b FA(AST)p Fe(_)p
-FA(CMPREGION)0 3397 y Fc(Description:)44 b Fj(This)28
+FA(CMPREGION)0 2182 y Fc(Description:)44 b Fj(This)28
b(function)g(creates)f(a)g(new)g(CmpRegion)h(and)f(optionally)g
-(initialises)g(its)h(attributes.)227 3529 y(A)i(CmpRegion)f(is)h(a)f
+(initialises)g(its)h(attributes.)227 2301 y(A)i(CmpRegion)f(is)h(a)f
(Region)g(whic)n(h)g(allo)n(ws)g(t)n(w)n(o)f(comp)r(onen)n(t)i(Regions)
e(\(of)i(an)n(y)f(class\))g(to)g(b)r(e)h(com)n(bined)g(to)227
-3629 y(form)g(a)f(more)f(complex)i(Region.)42 b(This)29
+2401 y(form)g(a)f(more)f(complex)i(Region.)42 b(This)29
b(com)n(bination)g(ma)n(y)g(b)r(e)h(p)r(erformed)f(a)g(b)r(o)r(olean)g
-(AND,)i(OR)e(or)g(X)n(OR)227 3729 y(\(exclusiv)n(e)j(OR\))h(op)r
+(AND,)i(OR)e(or)g(X)n(OR)227 2500 y(\(exclusiv)n(e)j(OR\))h(op)r
(erator.)49 b(If)33 b(the)g(AND)g(op)r(erator)e(is)h(used,)i(then)f(a)f
-(p)r(osition)g(is)h(inside)f(the)h(CmpRegion)227 3828
+(p)r(osition)g(is)h(inside)f(the)h(CmpRegion)227 2600
y(only)28 b(if)g(it)g(is)g(inside)g(b)r(oth)g(of)g(its)g(t)n(w)n(o)f
(comp)r(onen)n(t)g(Regions.)37 b(If)28 b(the)g(OR)g(op)r(erator)e(is)h
-(used,)h(then)g(a)g(p)r(osition)227 3928 y(is)g(inside)h(the)g
+(used,)h(then)g(a)g(p)r(osition)227 2700 y(is)g(inside)h(the)g
(CmpRegion)f(if)g(it)h(is)f(inside)h(either)f(\(or)g(b)r(oth\))h(of)f
(its)h(t)n(w)n(o)e(comp)r(onen)n(t)h(Regions.)38 b(If)29
-b(the)g(X)n(OR)227 4028 y(op)r(erator)24 b(is)i(used,)g(then)h(a)e(p)r
+b(the)g(X)n(OR)227 2799 y(op)r(erator)24 b(is)i(used,)g(then)h(a)e(p)r
(osition)h(is)g(inside)g(the)g(CmpRegion)f(if)i(it)f(is)g(inside)f(one)
-h(but)g(not)g(b)r(oth)h(of)e(its)h(t)n(w)n(o)227 4127
+h(but)g(not)g(b)r(oth)h(of)e(its)h(t)n(w)n(o)227 2899
y(comp)r(onen)n(t)j(Regions.)41 b(Other)28 b(op)r(erators)g(can)g(b)r
(e)i(formed)f(b)n(y)g(negating)f(one)h(or)f(b)r(oth)i(comp)r(onen)n(t)f
-(Regions)227 4227 y(b)r(efore)f(using)f(them)h(to)f(construct)h(a)f
-(new)g(CmpRegion.)227 4359 y(The)i(t)n(w)n(o)e(comp)r(onen)n(t)h
+(Regions)227 2999 y(b)r(efore)f(using)f(them)h(to)f(construct)h(a)f
+(new)g(CmpRegion.)227 3117 y(The)i(t)n(w)n(o)e(comp)r(onen)n(t)h
(Region)g(need)g(not)h(refer)e(to)h(the)h(same)f(co)r(ordinate)f(F)-7
b(rame,)28 b(but)h(it)g(m)n(ust)f(b)r(e)h(p)r(ossible)227
-4459 y(for)22 b(the)h(AST)p Ft(_)p Fj(CONVER)-7 b(T)23
+3217 y(for)22 b(the)h(AST)p Ft(_)p Fj(CONVER)-7 b(T)23
b(function)g(to)f(determine)h(a)f(Mapping)g(b)r(et)n(w)n(een)h(them)g
-(\(an)g(error)d(will)j(b)r(e)g(rep)r(orted)227 4558 y(otherwise)33
+(\(an)g(error)d(will)j(b)r(e)g(rep)r(orted)227 3316 y(otherwise)33
b(when)g(the)h(CmpRegion)f(is)g(created\).)54 b(F)-7
b(or)33 b(instance,)i(a)e(CmpRegion)g(ma)n(y)f(com)n(bine)h(a)g(Region)
-227 4658 y(de\014ned)k(within)f(an)g(ICRS)g(SkyF)-7 b(rame)36
+227 3416 y(de\014ned)k(within)f(an)g(ICRS)g(SkyF)-7 b(rame)36
b(with)g(a)g(Region)f(de\014ned)i(within)f(a)g(Galactic)f(SkyF)-7
-b(rame.)62 b(This)36 b(is)227 4758 y(acceptable)24 b(b)r(ecause)h(the)g
+b(rame.)62 b(This)36 b(is)227 3516 y(acceptable)24 b(b)r(ecause)h(the)g
(SkyF)-7 b(rame)24 b(class)g(kno)n(ws)f(ho)n(w)h(to)h(con)n(v)n(ert)e
(b)r(et)n(w)n(een)i(these)g(t)n(w)n(o)f(systems,)h(and)f(con-)227
-4857 y(sequen)n(tly)j(the)g(AST)p Ft(_)p Fj(CONVER)-7
+3615 y(sequen)n(tly)j(the)g(AST)p Ft(_)p Fj(CONVER)-7
b(T)27 b(function)g(will)h(also)d(b)r(e)j(able)e(to)h(con)n(v)n(ert)f
(b)r(et)n(w)n(een)h(them.)37 b(In)27 b(suc)n(h)g(cases,)227
-4957 y(the)33 b(second)g(comp)r(onen)n(t)f(Region)g(will)h(b)r(e)h
+3715 y(the)33 b(second)g(comp)r(onen)n(t)f(Region)g(will)h(b)r(e)h
(mapp)r(ed)f(in)n(to)f(the)h(co)r(ordinate)f(F)-7 b(rame)32
-b(of)h(the)g(\014rst)g(comp)r(onen)n(t)227 5057 y(Region,)g(and)g(the)f
+b(of)h(the)g(\014rst)g(comp)r(onen)n(t)227 3815 y(Region,)g(and)g(the)f
(F)-7 b(rame)32 b(represen)n(ted)g(b)n(y)g(the)h(CmpRegion)f(as)f(a)h
(whole)g(will)h(b)r(e)g(the)g(F)-7 b(rame)32 b(of)g(the)h(\014rst)227
-5156 y(comp)r(onen)n(t)28 b(Region.)227 5289 y(Since)20
+3914 y(comp)r(onen)n(t)28 b(Region.)227 4033 y(Since)20
b(a)f(CmpRegion)f(is)i(itself)f(a)g(Region,)i(it)e(can)g(b)r(e)h(used)f
(as)g(a)g(comp)r(onen)n(t)g(in)g(forming)g(further)g(CmpRegions.)227
-5388 y(Regions)27 b(of)g(arbitrary)f(complexit)n(y)h(ma)n(y)g(b)r(e)h
+4133 y(Regions)27 b(of)g(arbitrary)f(complexit)n(y)h(ma)n(y)g(b)r(e)h
(built)g(from)g(simple)f(individual)h(Regions)f(in)g(this)h(w)n(a)n(y)
--7 b(.)0 5553 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
+-7 b(.)0 4270 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
b(=)i(AST_CMPREGION\()38 b(REGION1,)i(REGION2,)g(OPER,)i(OPTIONS,)e
-(STATUS)h(\))0 5718 y Fc(Argumen)m(ts:)p eop end
-%%Page: 205 215
-TeXDict begin 205 214 bop 3643 52 a FG(205)259 351 y
-Fc(REGION1)31 b(=)h(INTEGER)f(\(Giv)m(en\))427 451 y
-Fj(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f(comp)r(onen)n(t)g(Region.)
-259 578 y Fc(REGION2)k(=)h(INTEGER)f(\(Giv)m(en\))427
-677 y Fj(P)n(oin)n(ter)20 b(to)h(the)g(second)g(comp)r(onen)n(t)f
-(Region.)34 b(This)21 b(Region)g(will)g(b)r(e)h(transformed)d(in)n(to)i
-(the)h(co)r(ordinate)427 777 y(F)-7 b(rame)27 b(of)h(the)g(\014rst)f
-(region)g(b)r(efore)g(use.)37 b(An)28 b(error)d(will)j(b)r(e)g(rep)r
-(orted)f(if)h(this)g(is)f(not)h(p)r(ossible.)259 904
-y Fc(OPER)j(=)h(INTEGER)g(\(Giv)m(en\))427 1003 y Fj(The)38
-b(b)r(o)r(olean)f(op)r(erator)f(with)i(whic)n(h)g(to)f(com)n(bine)h
-(the)g(t)n(w)n(o)f(Regions.)66 b(This)37 b(m)n(ust)h(b)r(e)g(one)g(of)f
-(the)427 1103 y(sym)n(b)r(olic)27 b(constan)n(ts)g(AST)p
-Ft(__)p Fj(AND,)h(AST)p Ft(__)p Fj(OR)f(or)g(AST)p Ft(__)p
-Fj(X)n(OR.)259 1229 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g
-Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-1329 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h(optional)g
-(comma-separated)e(list)j(of)g(attribute)f(assignmen)n(ts)g(to)427
-1429 y(b)r(e)37 b(used)f(for)g(initialising)g(the)h(new)g(CmpRegion.)63
+(STATUS)h(\))0 4408 y Fc(Argumen)m(ts:)259 4533 y(REGION1)31
+b(=)h(INTEGER)f(\(Giv)m(en\))427 4632 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(\014rst)f(comp)r(onen)n(t)g(Region.)259
+4753 y Fc(REGION2)k(=)h(INTEGER)f(\(Giv)m(en\))427 4853
+y Fj(P)n(oin)n(ter)20 b(to)h(the)g(second)g(comp)r(onen)n(t)f(Region.)
+34 b(This)21 b(Region)g(will)g(b)r(e)h(transformed)d(in)n(to)i(the)h
+(co)r(ordinate)427 4953 y(F)-7 b(rame)27 b(of)h(the)g(\014rst)f(region)
+g(b)r(efore)g(use.)37 b(An)28 b(error)d(will)j(b)r(e)g(rep)r(orted)f
+(if)h(this)g(is)f(not)h(p)r(ossible.)259 5074 y Fc(OPER)j(=)h(INTEGER)g
+(\(Giv)m(en\))427 5173 y Fj(The)38 b(b)r(o)r(olean)f(op)r(erator)f
+(with)i(whic)n(h)g(to)f(com)n(bine)h(the)g(t)n(w)n(o)f(Regions.)66
+b(This)37 b(m)n(ust)h(b)r(e)g(one)g(of)f(the)427 5273
+y(sym)n(b)r(olic)27 b(constan)n(ts)g(AST)p Ft(__)p Fj(AND,)h(AST)p
+Ft(__)p Fj(OR)f(or)g(AST)p Ft(__)p Fj(X)n(OR.)259 5394
+y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 5494 y Fj(A)g(c)n(haracter)e(string)
+h(con)n(taining)f(an)h(optional)g(comma-separated)e(list)j(of)g
+(attribute)f(assignmen)n(ts)g(to)427 5593 y(b)r(e)37
+b(used)f(for)g(initialising)g(the)h(new)g(CmpRegion.)63
b(The)36 b(syn)n(tax)g(used)g(is)g(iden)n(tical)g(to)h(that)f(for)g
-(the)427 1528 y(AST)p Ft(_)p Fj(SET)27 b(routine.)259
-1655 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 1755 y Fj(The)c(global)e(status.)0 1910
-y Fc(Returned)32 b(V)-8 b(alue:)259 2041 y(AST)p Ft(_)p
-Fc(CMPREGION)31 b(=)h(INTEGER)427 2140 y Fj(A)c(p)r(oin)n(ter)f(to)h
-(the)g(new)g(CmpRegion.)0 2296 y Fc(Notes:)340 2572 y
-Fi(\017)45 b Fj(If)35 b(one)f(of)g(the)h(supplied)g(Regions)e(has)h(an)
-g(asso)r(ciated)f(uncertain)n(t)n(y)-7 b(,)35 b(that)g(uncertain)n(t)n
-(y)e(will)i(also)e(b)r(e)427 2672 y(used)h(for)f(the)h(returned)f
+(the)427 5693 y(AST)p Ft(_)p Fj(SET)27 b(routine.)p eop
+end
+%%Page: 206 216
+TeXDict begin 206 215 bop 0 52 a FG(206)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(ST)-8
+b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+451 y Fj(The)c(global)e(status.)0 611 y Fc(Returned)32
+b(V)-8 b(alue:)259 746 y(AST)p Ft(_)p Fc(CMPREGION)31
+b(=)h(INTEGER)427 846 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
+(CmpRegion.)0 1007 y Fc(Notes:)340 1288 y Fi(\017)45
+b Fj(If)35 b(one)f(of)g(the)h(supplied)g(Regions)e(has)h(an)g(asso)r
+(ciated)f(uncertain)n(t)n(y)-7 b(,)35 b(that)g(uncertain)n(t)n(y)e
+(will)i(also)e(b)r(e)427 1387 y(used)h(for)f(the)h(returned)f
(CmpRegion.)55 b(If)34 b(b)r(oth)g(supplied)g(Regions)e(ha)n(v)n(e)h
-(asso)r(ciated)f(uncertain)n(ties,)427 2772 y(the)c(uncertain)n(t)n(y)f
+(asso)r(ciated)f(uncertain)n(ties,)427 1487 y(the)c(uncertain)n(t)n(y)f
(asso)r(ciated)f(with)i(the)g(\014rst)g(Region)f(will)g(b)r(e)h(used)g
-(for)f(the)h(returned)f(CmpRegion.)340 2898 y Fi(\017)45
+(for)f(the)h(returned)f(CmpRegion.)340 1618 y Fi(\017)45
b Fj(Deep)22 b(copies)f(are)f(tak)n(en)h(of)g(the)h(supplied)g
(Regions.)33 b(This)22 b(means)f(that)g(an)n(y)g(subsequen)n(t)g(c)n
-(hanges)f(made)427 2998 y(to)26 b(the)g(comp)r(onen)n(t)g(Regions)f
+(hanges)f(made)427 1718 y(to)26 b(the)g(comp)r(onen)n(t)g(Regions)f
(using)g(the)i(supplied)f(p)r(oin)n(ters)f(will)h(ha)n(v)n(e)f(no)h
-(e\013ect)g(on)g(the)g(CmpRegion.)340 3125 y Fi(\017)45
+(e\013ect)g(on)g(the)g(CmpRegion.)340 1850 y Fi(\017)45
b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 3224
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 1949
y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 3411 3780 12 v 0 3542
-a FA(AST)p Fe(_)p FA(COLUMNNAME)1538 3543 y Fd(Get)39
-b(the)f(name)1537 3642 y(of)g(the)h(column)1636 3742
-y(at)f(a)h(giv)m(en)1569 3857 y(index)g(within)1648 3956
-y(the)f(T)-10 b(able)2411 3542 y FA(AST)p Fe(_)p FA(COLUMNNAME)0
-4110 y Fc(Description:)44 b Fj(This)23 b(function)h(returns)e(a)g
+(fail)h(for)f(an)n(y)g(reason.)p 0 2146 3780 12 v 0 2276
+a FA(AST)p Fe(_)p FA(COLUMNNAME)1538 2277 y Fd(Get)39
+b(the)f(name)1537 2377 y(of)g(the)h(column)1636 2477
+y(at)f(a)h(giv)m(en)1569 2591 y(index)g(within)1648 2691
+y(the)f(T)-10 b(able)2411 2276 y FA(AST)p Fe(_)p FA(COLUMNNAME)0
+2854 y Fc(Description:)44 b Fj(This)23 b(function)h(returns)e(a)g
(string)h(holding)f(the)h(name)g(of)g(the)g(column)g(with)h(the)f(giv)n
-(en)f(index)h(within)227 4209 y(the)28 b(T)-7 b(able.)227
-4331 y(This)29 b(function)h(is)f(in)n(tended)g(primarily)f(as)g(a)h
+(en)f(index)h(within)227 2953 y(the)28 b(T)-7 b(able.)227
+3077 y(This)29 b(function)h(is)f(in)n(tended)g(primarily)f(as)g(a)h
(means)f(of)h(iterating)g(round)f(all)h(the)g(columns)g(in)g(a)g(T)-7
-b(able.)40 b(F)-7 b(or)227 4430 y(this)28 b(purp)r(ose,)f(the)h(n)n(um)
+b(able.)40 b(F)-7 b(or)227 3177 y(this)28 b(purp)r(ose,)f(the)h(n)n(um)
n(b)r(er)g(of)f(columns)h(in)g(the)g(T)-7 b(able)27 b(is)g(giv)n(en)g
(b)n(y)h(the)g(Ncolumn)f(attribute)h(of)g(the)g(T)-7
-b(able.)227 4530 y(This)28 b(function)g(could)f(then)i(b)r(e)f(called)f
+b(able.)227 3276 y(This)28 b(function)g(could)f(then)i(b)r(e)f(called)f
(in)h(a)f(lo)r(op,)g(with)h(the)g(index)g(v)-5 b(alue)27
-b(going)g(from)g(one)g(to)h(Ncolumn.)227 4651 y(Note,)e(the)f(index)h
+b(going)g(from)g(one)g(to)h(Ncolumn.)227 3400 y(Note,)e(the)f(index)h
(asso)r(ciated)d(with)j(a)f(column)g(decreases)e(monotonically)h(with)i
-(the)f(age)f(of)h(the)h(column:)35 b(the)227 4751 y(oldest)25
+(the)f(age)f(of)h(the)h(column:)35 b(the)227 3500 y(oldest)25
b(Column)g(in)h(the)f(T)-7 b(able)25 b(will)g(ha)n(v)n(e)f(index)h
(one,)h(and)f(the)g(Column)g(added)g(most)g(recen)n(tly)f(to)h(the)h(T)
--7 b(able)227 4851 y(will)28 b(ha)n(v)n(e)f(the)g(largest)g(index.)0
-4994 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i
+-7 b(able)227 3599 y(will)28 b(ha)n(v)n(e)f(the)g(largest)g(index.)0
+3747 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i
(AST_COLUMNNAME\()37 b(THIS,)42 b(INDEX,)f(STATUS)g(\))0
-5137 y Fc(Argumen)m(ts:)259 5267 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 5367 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(T)-7
-b(able.)259 5494 y Fc(INDEX)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
-5593 y Fj(The)h(index)f(in)n(to)g(the)h(list)g(of)f(columns.)48
+3896 y Fc(Argumen)m(ts:)259 4031 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 4130 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(T)-7
+b(able.)259 4262 y Fc(INDEX)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
+4361 y Fj(The)h(index)f(in)n(to)g(the)h(list)g(of)f(columns.)48
b(The)31 b(\014rst)g(column)h(has)e(index)i(one,)g(and)f(the)h(last)f
-(has)g(index)427 5693 y Ft(")p Fj(Ncolumn)p Ft(")p Fj(.)p
-eop end
-%%Page: 206 216
-TeXDict begin 206 215 bop 0 52 a FG(206)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(ST)-8
-b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-451 y Fj(The)c(global)e(status.)0 604 y Fc(Returned)32
-b(V)-8 b(alue:)259 732 y(AST)p Ft(_)p Fc(COLUMNNAME)31
-b(=)h(CHARA)m(CTER)g Fi(\003)f Fc(\()h(AST)p Ft(__)p
-Fc(SZCHR)g(\))427 832 y Fj(The)c(upp)r(er)g(case)e(column)i(name.)0
-985 y Fc(Notes:)340 1259 y Fi(\017)45 b Fj(A)25 b(blank)f(string)f
-(will)i(b)r(e)f(returned)g(if)h(this)g(function)f(is)g(in)n(v)n(ok)n
-(ed)f(with)i(ST)-7 b(A)g(TUS)25 b(set)f(to)g(an)g(error)f(v)-5
-b(alue,)427 1358 y(or)27 b(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)p 0 1541 3780 12 v 0 1671 a FA(AST)p Fe(_)p
-FA(COLUMNNULL)1531 1672 y Fd(Get)39 b(or)f(set)h(the)1472
-1772 y(n)m(ull)f(v)-7 b(alue)38 b(for)g(an)1511 1871
-y(in)m(teger)f(column)1494 1986 y(of)h(a)h(FITS)g(table)2463
-1671 y FA(AST)p Fe(_)p FA(COLUMNNULL)0 2134 y Fc(Description:)44
-b Fj(This)37 b(function)h(allo)n(ws)e(a)g(n)n(ull)i(v)-5
-b(alue)37 b(to)g(b)r(e)g(stored)f(with)i(a)f(named)g(in)n(teger-v)-5
-b(alued)35 b(column)i(in)227 2234 y(a)g(FitsT)-7 b(able.)65
+(has)g(index)427 4461 y Ft(")p Fj(Ncolumn)p Ft(")p Fj(.)259
+4592 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 4692 y Fj(The)c(global)e(status.)0 4852
+y Fc(Returned)32 b(V)-8 b(alue:)259 4988 y(AST)p Ft(_)p
+Fc(COLUMNNAME)31 b(=)h(CHARA)m(CTER)g Fi(\003)f Fc(\()h(AST)p
+Ft(__)p Fc(SZCHR)g(\))427 5087 y Fj(The)c(upp)r(er)g(case)e(column)i
+(name.)0 5248 y Fc(Notes:)340 5529 y Fi(\017)45 b Fj(A)25
+b(blank)f(string)f(will)i(b)r(e)f(returned)g(if)h(this)g(function)f(is)
+g(in)n(v)n(ok)n(ed)f(with)i(ST)-7 b(A)g(TUS)25 b(set)f(to)g(an)g(error)
+f(v)-5 b(alue,)427 5628 y(or)27 b(if)h(it)g(should)f(fail)h(for)f(an)n
+(y)g(reason.)p eop end
+%%Page: 207 217
+TeXDict begin 207 216 bop 3643 52 a FG(207)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(COLUMNNULL)1531 483 y
+Fd(Get)39 b(or)f(set)h(the)1472 583 y(n)m(ull)f(v)-7
+b(alue)38 b(for)g(an)1511 682 y(in)m(teger)f(column)1494
+797 y(of)h(a)h(FITS)g(table)2463 482 y FA(AST)p Fe(_)p
+FA(COLUMNNULL)0 983 y Fc(Description:)44 b Fj(This)37
+b(function)h(allo)n(ws)e(a)g(n)n(ull)i(v)-5 b(alue)37
+b(to)g(b)r(e)g(stored)f(with)i(a)f(named)g(in)n(teger-v)-5
+b(alued)35 b(column)i(in)227 1083 y(a)g(FitsT)-7 b(able.)65
b(The)37 b(supplied)g(n)n(ull)g(v)-5 b(alue)37 b(is)g(assigned)f(to)h
(the)g(TNULLn)g(k)n(eyw)n(ord)f(in)h(the)g(FITS)g(header)227
-2334 y(asso)r(ciated)28 b(with)i(the)f(FitsT)-7 b(able.)41
+1183 y(asso)r(ciated)28 b(with)i(the)f(FitsT)-7 b(able.)41
b(A)30 b(v)-5 b(alue)29 b(in)g(the)g(named)g(column)g(is)g(then)h
(considered)e(to)h(b)r(e)g(n)n(ull)h(if)f(1\))g(it)227
-2433 y(equals)e(the)h(n)n(ull)g(v)-5 b(alue)27 b(supplied)h(to)g(this)g
+1282 y(equals)e(the)h(n)n(ull)g(v)-5 b(alue)27 b(supplied)h(to)g(this)g
(function,)g(or)f(2\))g(no)g(v)-5 b(alue)28 b(has)f(y)n(et)g(b)r(een)h
-(stored)f(in)h(the)g(cell.)227 2554 y(As)k(w)n(ell)g(as)f(setting)h(a)f
+(stored)f(in)h(the)g(cell.)227 1417 y(As)k(w)n(ell)g(as)f(setting)h(a)f
(new)h(n)n(ull)g(v)-5 b(alue,)33 b(this)f(function)h(also)e(returns)g
(the)h(previous)f(n)n(ull)h(v)-5 b(alue.)50 b(If)32 b(no)f(n)n(ull)227
-2653 y(v)-5 b(alue)24 b(has)f(b)r(een)g(set)h(previously)-7
+1517 y(v)-5 b(alue)24 b(has)f(b)r(een)g(set)h(previously)-7
b(,)23 b(a)g(default)h(v)-5 b(alue)23 b(will)h(b)r(e)g(returned.)35
b(This)24 b(default)f(will)h(b)r(e)g(an)f(in)n(teger)g(v)-5
-b(alue)227 2753 y(that)28 b(do)r(es)g(not)g(curren)n(tly)e(o)r(ccur)i
+b(alue)227 1616 y(that)28 b(do)r(es)g(not)g(curren)n(tly)e(o)r(ccur)i
(an)n(ywhere)e(within)i(the)h(named)e(column.)38 b(If)28
b(no)f(suc)n(h)h(v)-5 b(alue)28 b(can)f(b)r(e)h(found,)227
-2852 y(what)e(happ)r(ens)g(dep)r(ends)g(on)g(whether)g(the)g(column)g
+1716 y(what)e(happ)r(ens)g(dep)r(ends)g(on)g(whether)g(the)g(column)g
(con)n(tains)f(an)n(y)g(cells)h(in)g(whic)n(h)g(no)f(v)-5
-b(alues)26 b(ha)n(v)n(e)f(y)n(et)g(b)r(een)227 2952 y(stored.)40
+b(alues)26 b(ha)n(v)n(e)f(y)n(et)g(b)r(een)227 1816 y(stored.)40
b(If)29 b(so,)f(an)h(error)d(will)j(b)r(e)g(rep)r(orted.)40
b(Otherwise)28 b(\(i.e.)40 b(if)29 b(there)g(are)f(no)g(n)n(ull)h(v)-5
-b(alues)28 b(in)h(the)g(column\),)227 3052 y(an)d(arbitrary)e(v)-5
+b(alues)28 b(in)h(the)g(column\),)227 1915 y(an)d(arbitrary)e(v)-5
b(alue)26 b(of)g(zero)f(will)i(b)r(e)f(returned)g(as)f(the)i(function)g
(v)-5 b(alue,)26 b(and)g(no)g(TNULLn)h(k)n(eyw)n(ord)d(will)i(b)r(e)227
-3151 y(stored)h(in)h(the)g(FITS)g(header.)227 3272 y(A)h(\015ag)e(is)h
+2015 y(stored)h(in)h(the)g(FITS)g(header.)227 2150 y(A)h(\015ag)e(is)h
(returned)g(indicating)g(if)h(the)g(returned)e(n)n(ull)i(v)-5
b(alue)28 b(w)n(as)f(set)h(explicitly)h(b)n(y)e(a)h(previous)f(call)h
-(to)g(this)227 3371 y(function,)h(or)d(is)i(a)f(default)h(v)-5
-b(alue.)227 3491 y(A)25 b(second)e(\015ag)g(is)h(returned)g(indicating)
+(to)g(this)227 2250 y(function,)h(or)d(is)i(a)f(default)h(v)-5
+b(alue.)227 2385 y(A)25 b(second)e(\015ag)g(is)h(returned)g(indicating)
g(if)g(the)g(named)g(column)g(con)n(tains)f(an)n(y)h(n)n(ull)g(v)-5
b(alues)23 b(\(i.e.)36 b(v)-5 b(alues)24 b(equal)227
-3591 y(to)k(the)g(supplied)g(n)n(ull)f(v)-5 b(alue,)28
+2484 y(to)k(the)g(supplied)g(n)n(ull)f(v)-5 b(alue,)28
b(or)f(cells)g(to)g(whic)n(h)h(no)f(v)-5 b(alue)28 b(has)f(y)n(et)g(b)r
-(een)h(assigned\).)0 3732 y Fc(In)m(v)m(o)s(cation:)123
+(een)h(assigned\).)0 2655 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_COLUMNNULL\()37 b(THIS,)42 b(COLUMN,)f(SET,)h
-(NEWVAL,)e(WASSET,)h(HASNULL,)f(STATUS)227 3831 y(\))0
-3972 y Fc(Argumen)m(ts:)259 4100 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 4200 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(T)-7
-b(able.)259 4324 y Fc(COLUMN)32 b(=)g(CHARA)m(CTER)f
+(NEWVAL,)e(WASSET,)h(HASNULL,)f(STATUS)227 2754 y(\))0
+2925 y Fc(Argumen)m(ts:)259 3082 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 3181 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(T)-7
+b(able.)259 3325 y Fc(COLUMN)32 b(=)g(CHARA)m(CTER)f
Fi(\003)h Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-4424 y Fj(The)c(c)n(haracter)d(string)i(holding)h(the)g(name)f(of)g
+3424 y Fj(The)c(c)n(haracter)d(string)i(holding)h(the)g(name)f(of)g
(the)h(column.)37 b(T)-7 b(railing)27 b(spaces)g(are)f(ignored.)259
-4548 y Fc(SET)32 b(=)g(LOGICAL)h(\(Giv)m(en\))427 4648
+3568 y Fc(SET)32 b(=)g(LOGICAL)h(\(Giv)m(en\))427 3667
y Fj(If)23 b(.TR)n(UE.,)h(the)e(v)-5 b(alue)23 b(supplied)g(for)f
(argumen)n(t)f(NEWV)-9 b(AL)23 b(will)g(b)r(e)g(stored)f(as)f(the)i
-(curren)n(t)f(n)n(ull)h(v)-5 b(alue,)427 4747 y(replacing)25
+(curren)n(t)f(n)n(ull)h(v)-5 b(alue,)427 3767 y(replacing)25
b(an)n(y)h(v)-5 b(alue)26 b(set)h(b)n(y)f(a)g(previous)f(call)h(to)g
(this)h(function.)37 b(If)27 b(.F)-9 b(ALSE.,)26 b(the)h(v)-5
-b(alue)26 b(supplied)h(for)427 4847 y(argumen)n(t)g(NEWV)-9
+b(alue)26 b(supplied)h(for)427 3867 y(argumen)n(t)g(NEWV)-9
b(AL)28 b(is)f(ignored)g(and)g(the)h(curren)n(t)f(n)n(ull)h(v)-5
-b(alue)27 b(is)h(left)g(unc)n(hanged.)259 4971 y Fc(NEWV)-11
-b(AL)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 5071 y Fj(The)22
+b(alue)27 b(is)h(left)g(unc)n(hanged.)259 4010 y Fc(NEWV)-11
+b(AL)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 4110 y Fj(The)22
b(new)h(n)n(ull)f(v)-5 b(alue)22 b(to)g(use.)34 b(Ignored)21
b(if)i(SET)f(is)g(.F)-9 b(ALSE.)22 b(An)g(error)e(will)i(b)r(e)h(rep)r
-(orted)e(if)i(the)f(supplied)427 5170 y(v)-5 b(alue)34
+(orted)e(if)i(the)f(supplied)427 4209 y(v)-5 b(alue)34
b(is)g(outside)g(the)h(range)d(of)i(v)-5 b(alues)34 b(that)h(can)e(b)r
(e)i(stored)e(in)h(the)h(in)n(teger)e(data)h(t)n(yp)r(e)g(asso)r
-(ciated)427 5270 y(with)28 b(the)g(column.)259 5394 y
+(ciated)427 4309 y(with)28 b(the)g(column.)259 4452 y
Fc(W)-11 b(ASSET)32 b(=)h(LOGICAL)f(\(Returned\))427
-5494 y Fj(.TR)n(UE.)23 b(will)h(b)r(e)f(returned)g(if)h(the)f(returned)
+4552 y Fj(.TR)n(UE.)23 b(will)h(b)r(e)f(returned)g(if)h(the)f(returned)
g(n)n(ull)g(v)-5 b(alue)23 b(w)n(as)g(set)g(previously)f(via)g(an)h
-(earlier)f(in)n(v)n(o)r(cation)427 5593 y(of)31 b(this)f(function.)46
+(earlier)f(in)n(v)n(o)r(cation)427 4651 y(of)31 b(this)f(function.)46
b(.F)-9 b(ALSE.)30 b(is)g(returned)g(otherwise.)44 b(If)31
b(the)g(named)f(column)g(do)r(es)g(not)h(exist,)f(or)g(an)427
-5693 y(error)c(o)r(ccurs,)h(a)g(v)-5 b(alue)27 b(of)h(.F)-9
-b(ALSE.)27 b(is)h(returned.)p eop end
-%%Page: 207 217
-TeXDict begin 207 216 bop 3643 52 a FG(207)259 351 y
-Fc(HASNULL)33 b(=)f(LOGICAL)h(\(Returned\))427 451 y
-Fj(.TR)n(UE.)25 b(will)g(b)r(e)g(returned)g(if)g(and)g(only)g(if)g(the)
-h(named)e(column)h(curren)n(tly)f(con)n(tains)g(an)n(y)h(v)-5
-b(alues)24 b(equal)427 551 y(to)34 b(the)h(n)n(ull)g(v)-5
+4751 y(error)c(o)r(ccurs,)h(a)g(v)-5 b(alue)27 b(of)h(.F)-9
+b(ALSE.)27 b(is)h(returned.)259 4894 y Fc(HASNULL)33
+b(=)f(LOGICAL)h(\(Returned\))427 4994 y Fj(.TR)n(UE.)25
+b(will)g(b)r(e)g(returned)g(if)g(and)g(only)g(if)g(the)h(named)e
+(column)h(curren)n(tly)f(con)n(tains)g(an)n(y)h(v)-5
+b(alues)24 b(equal)427 5093 y(to)34 b(the)h(n)n(ull)g(v)-5
b(alue)34 b(on)g(exit)g(\(i.e.)58 b(NEWV)-9 b(AL)35 b(if)f(SET)g(is)h
(.TR)n(UE.)f(or)f(the)i(returned)f(function)h(v)-5 b(alue)427
-650 y(otherwise\),)38 b(or)d(con)n(tains)g(an)n(y)g(empt)n(y)h(cells.)
+5193 y(otherwise\),)38 b(or)d(con)n(tains)g(an)n(y)g(empt)n(y)h(cells.)
61 b(If)37 b(the)f(named)g(column)g(do)r(es)f(not)h(exist,)i(or)d(an)h
-(error)427 750 y(o)r(ccurs,)27 b(a)g(v)-5 b(alue)28 b(of)f(.F)-9
-b(ALSE.)28 b(is)f(returned.)259 889 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 988
-y Fj(The)c(global)e(status.)0 1163 y Fc(Returned)32 b(V)-8
-b(alue:)259 1312 y(AST)p Ft(_)p Fc(COLUMNNULL)33 b(=)f(INTEGER)427
-1411 y Fj(The)h(n)n(ull)g(v)-5 b(alue)32 b(that)h(w)n(as)f(in)g(use)h
-(on)f(en)n(try)g(to)g(this)h(function.)53 b(If)33 b(a)f(n)n(ull)h(v)-5
-b(alue)32 b(has)g(b)r(een)h(set)g(b)n(y)f(a)427 1511
-y(previous)f(in)n(v)n(o)r(cation)g(of)i(this)f(function,)i(it)f(will)f
-(b)r(e)h(returned.)51 b(Otherwise,)32 b(if)h(SET)f(is)g(.TR)n(UE.,)h
-(the)427 1610 y(supplied)d(NEWV)-9 b(AL)29 b(v)-5 b(alue)30
-b(is)f(returned.)41 b(Otherwise,)29 b(a)g(default)h(v)-5
-b(alue)29 b(is)g(c)n(hosen)f(\(if)i(p)r(ossible\))f(that)427
-1710 y(do)r(es)22 b(not)h(curren)n(tly)e(o)r(ccur)h(in)h(the)g(named)f
-(column.)35 b(If)23 b(all)f(a)n(v)-5 b(ailable)21 b(v)-5
-b(alues)23 b(are)e(in)i(use)f(in)h(the)g(column,)427
-1810 y(an)j(error)e(is)h(rep)r(orted)g(if)i(and)e(only)g(if)i(the)f
+(error)427 5293 y(o)r(ccurs,)27 b(a)g(v)-5 b(alue)28
+b(of)f(.F)-9 b(ALSE.)28 b(is)f(returned.)259 5436 y Fc(ST)-8
+b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+5536 y Fj(The)c(global)e(status.)0 5718 y Fc(Returned)32
+b(V)-8 b(alue:)p eop end
+%%Page: 208 218
+TeXDict begin 208 217 bop 0 52 a FG(208)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(AST)p
+Ft(_)p Fc(COLUMNNULL)i(=)f(INTEGER)427 451 y Fj(The)h(n)n(ull)g(v)-5
+b(alue)32 b(that)h(w)n(as)f(in)g(use)h(on)f(en)n(try)g(to)g(this)h
+(function.)53 b(If)33 b(a)f(n)n(ull)h(v)-5 b(alue)32
+b(has)g(b)r(een)h(set)g(b)n(y)f(a)427 551 y(previous)f(in)n(v)n(o)r
+(cation)g(of)i(this)f(function,)i(it)f(will)f(b)r(e)h(returned.)51
+b(Otherwise,)32 b(if)h(SET)f(is)g(.TR)n(UE.,)h(the)427
+650 y(supplied)d(NEWV)-9 b(AL)29 b(v)-5 b(alue)30 b(is)f(returned.)41
+b(Otherwise,)29 b(a)g(default)h(v)-5 b(alue)29 b(is)g(c)n(hosen)f(\(if)
+i(p)r(ossible\))f(that)427 750 y(do)r(es)22 b(not)h(curren)n(tly)e(o)r
+(ccur)h(in)h(the)g(named)f(column.)35 b(If)23 b(all)f(a)n(v)-5
+b(ailable)21 b(v)-5 b(alues)23 b(are)e(in)i(use)f(in)h(the)g(column,)
+427 849 y(an)j(error)e(is)h(rep)r(orted)g(if)i(and)e(only)g(if)i(the)f
(column)g(con)n(tains)e(an)n(y)h(empt)n(y)h(cells.)36
-b(Otherwise,)26 b(a)f(v)-5 b(alue)26 b(of)427 1909 y(zero)j(is)g
+b(Otherwise,)26 b(a)f(v)-5 b(alue)26 b(of)427 949 y(zero)j(is)g
(returned.)43 b(A)30 b(v)-5 b(alue)29 b(of)h(zero)f(is)g(also)g
(returned)g(if)h(the)g(named)g(column)f(do)r(es)g(not)h(exist,)g(or)f
-(an)427 2009 y(error)d(o)r(ccurs.)0 2183 y Fc(Notes:)340
-2478 y Fi(\017)45 b Fj(The)33 b(FITS)g(binary)f(table)h(de\014nition)g
+(an)427 1049 y(error)d(o)r(ccurs.)0 1240 y Fc(Notes:)340
+1552 y Fi(\017)45 b Fj(The)33 b(FITS)g(binary)f(table)h(de\014nition)g
(allo)n(ws)f(only)g(in)n(teger-v)-5 b(alued)32 b(columns)g(to)h(ha)n(v)
-n(e)e(an)i(asso)r(ciated)427 2578 y(n)n(ull)28 b(v)-5
+n(e)e(an)i(asso)r(ciated)427 1652 y(n)n(ull)28 b(v)-5
b(alue.)37 b(This)27 b(routine)h(will)f(return)g(without)i(action)e(if)
h(the)g(column)f(is)h(not)f(in)n(teger-v)-5 b(alued.)p
-0 2790 3780 12 v 0 2920 a FA(AST)p Fe(_)p FA(COLUMNSHAPE)1586
-2921 y Fd(Returns)39 b(the)1577 3021 y(shap)s(e)g(of)g(the)1618
-3135 y(v)-7 b(alues)39 b(in)f(a)1721 3235 y(named)1704
-3335 y(column)2372 2920 y FA(AST)p Fe(_)p FA(COLUMNSHAPE)0
-3513 y Fc(Description:)44 b Fj(This)29 b(routine)e(returns)h(the)h(n)n
+0 1880 3780 12 v 0 2011 a FA(AST)p Fe(_)p FA(COLUMNSHAPE)1586
+2012 y Fd(Returns)39 b(the)1577 2112 y(shap)s(e)g(of)g(the)1618
+2226 y(v)-7 b(alues)39 b(in)f(a)1721 2326 y(named)1704
+2425 y(column)2372 2011 y FA(AST)p Fe(_)p FA(COLUMNSHAPE)0
+2620 y Fc(Description:)44 b Fj(This)29 b(routine)e(returns)h(the)h(n)n
(um)n(b)r(er)f(of)g(dimensions)g(spaned)g(b)n(y)g(eac)n(h)f(v)-5
-b(alue)28 b(in)h(a)e(named)i(column)227 3612 y(of)k(a)f(T)-7
+b(alue)28 b(in)h(a)e(named)i(column)227 2720 y(of)k(a)f(T)-7
b(able,)33 b(together)f(with)h(the)f(length)h(of)f(eac)n(h)g
(dimension.)51 b(These)32 b(are)g(the)h(v)-5 b(alues)32
-b(supplied)h(when)f(the)227 3712 y(column)c(w)n(as)e(created)h(using)g
-(AST)p Ft(_)p Fj(ADDCOLUMN.)0 3874 y Fc(In)m(v)m(o)s(cation:)123
+b(supplied)h(when)f(the)227 2820 y(column)c(w)n(as)e(created)h(using)g
+(AST)p Ft(_)p Fj(ADDCOLUMN.)0 2999 y Fc(In)m(v)m(o)s(cation:)123
b Ft(CALL)42 b(AST_COLUMNSHAPE)o(\()c(THIS,)j(COLUMN,)g(MXDIM,)g(NDIM,)
-g(DIMS,)h(STATUS)f(\))0 4036 y Fc(Argumen)m(ts:)259 4185
-y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 4284 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(T)-7 b(able.)259 4423 y Fc(COLUMN)32 b(=)g(CHARA)m(CTER)f
+g(DIMS,)h(STATUS)f(\))0 3177 y Fc(Argumen)m(ts:)259 3343
+y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 3443 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(T)-7 b(able.)259 3590 y Fc(COLUMN)32 b(=)g(CHARA)m(CTER)f
Fi(\003)h Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-4523 y Fj(The)24 b(c)n(haracter)f(string)g(holding)h(the)g(upp)r(er)h
+3690 y Fj(The)24 b(c)n(haracter)f(string)g(holding)h(the)g(upp)r(er)h
(case)e(name)h(of)g(the)h(column.)35 b(T)-7 b(railing)23
-b(spaces)h(are)f(ignored.)259 4662 y Fc(MXDIM)32 b(=)g(INTEGER)f(\(Giv)
-m(en\))427 4762 y Fj(The)d(length)g(of)f(the)h(DIMS)g(arra)n(y)-7
-b(.)259 4901 y Fc(NDIM)32 b(=)g(INTEGER)f(\(Returned\))427
-5000 y Fj(The)e(n)n(um)n(b)r(er)f(of)h(dimensions)f(spanned)g(b)n(y)g
+b(spaces)h(are)f(ignored.)259 3838 y Fc(MXDIM)32 b(=)g(INTEGER)f(\(Giv)
+m(en\))427 3937 y Fj(The)d(length)g(of)f(the)h(DIMS)g(arra)n(y)-7
+b(.)259 4085 y Fc(NDIM)32 b(=)g(INTEGER)f(\(Returned\))427
+4184 y Fj(The)e(n)n(um)n(b)r(er)f(of)h(dimensions)f(spanned)g(b)n(y)g
(v)-5 b(alues)29 b(in)f(the)h(named)g(column.)39 b(This)29
-b(will)g(b)r(e)g(zero)e(if)i(the)427 5100 y(column)f(con)n(tains)e
-(scalar)g(v)-5 b(alues.)259 5239 y Fc(DIMS\()32 b(MXDIM)g(\))g(=)g
-(INTEGER)f(\(Returned\))427 5339 y Fj(An)f(arra)n(y)c(in)j(whic)n(h)g
+b(will)g(b)r(e)g(zero)e(if)i(the)427 4284 y(column)f(con)n(tains)e
+(scalar)g(v)-5 b(alues.)259 4432 y Fc(DIMS\()32 b(MXDIM)g(\))g(=)g
+(INTEGER)f(\(Returned\))427 4531 y Fj(An)f(arra)n(y)c(in)j(whic)n(h)g
(to)g(return)f(the)h(length)g(of)g(eac)n(h)f(dimension.)41
b(An)n(y)29 b(excess)f(trailing)g(elemen)n(ts)g(will)427
-5438 y(b)r(e)g(\014lled)g(with)g(the)g(v)-5 b(alue)28
-b(1.)259 5577 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)
-g(Returned\))427 5677 y Fj(The)c(global)e(status.)p eop
-end
-%%Page: 208 218
-TeXDict begin 208 217 bop 0 52 a FG(208)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Notes:)340
-633 y Fi(\017)45 b Fj(No)28 b(error)e(is)j(rep)r(orted)e(if)i(the)f
-(requested)g(column)g(cannot)g(b)r(e)g(found)h(in)f(the)h(giv)n(en)e(T)
--7 b(able.)38 b(A)29 b(v)-5 b(alue)28 b(of)427 732 y(zero)f(is)g
-(returned)g(for)g(NDIM)i(and)e(the)h(supplied)g(v)-5
-b(alues)28 b(in)f(DIMS)i(are)d(left)j(unc)n(hanged.)340
-864 y Fi(\017)45 b Fj(A)28 b(v)-5 b(alue)28 b(of)f(zero)g(is)g
+4631 y(b)r(e)g(\014lled)g(with)g(the)g(v)-5 b(alue)28
+b(1.)259 4778 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)
+g(Returned\))427 4878 y Fj(The)c(global)e(status.)0 5069
+y Fc(Notes:)340 5381 y Fi(\017)45 b Fj(No)28 b(error)e(is)j(rep)r
+(orted)e(if)i(the)f(requested)g(column)g(cannot)g(b)r(e)g(found)h(in)f
+(the)h(giv)n(en)e(T)-7 b(able.)38 b(A)29 b(v)-5 b(alue)28
+b(of)427 5481 y(zero)f(is)g(returned)g(for)g(NDIM)i(and)e(the)h
+(supplied)g(v)-5 b(alues)28 b(in)f(DIMS)i(are)d(left)j(unc)n(hanged.)
+340 5628 y Fi(\017)45 b Fj(A)28 b(v)-5 b(alue)28 b(of)f(zero)g(is)g
(returned)g(for)g(NDIM)i(if)f(an)f(error)f(o)r(ccurs.)p
-0 1061 3780 12 v 0 1192 a FA(AST)p Fe(_)p FA(COLUMNSIZE)1415
-1193 y Fd(Get)38 b(the)h(n)m(um)m(b)s(er)f(of)1489 1292
-y(b)m(ytes)h(needed)g(to)1423 1407 y(hold)f(a)h(full)f(column)1709
-1507 y(of)h(data)2538 1192 y FA(AST)p Fe(_)p FA(COLUMNSIZE)0
-1670 y Fc(Description:)44 b Fj(This)37 b(function)g(returns)f(the)h(n)n
-(um)n(b)r(er)f(of)g(b)n(ytes)g(of)h(memory)e(that)i(m)n(ust)g(b)r(e)g
-(allo)r(cated)e(prior)h(to)227 1770 y(retrieving)27 b(the)h(data)f
-(from)g(a)g(column)h(using)f(AST)p Ft(_)p Fj(GETCOLUMND)n(A)-7
-b(T)g(A.)0 1918 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
-b(=)i(AST_COLUMNSIZE\()37 b(THIS,)42 b(COLUMN,)f(STATUS)g(\))0
-2066 y Fc(Argumen)m(ts:)259 2202 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 2301 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(T)-7
-b(able.)259 2433 y Fc(COLUMN)32 b(=)g(CHARA)m(CTER)f
-Fi(\003)h Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-2533 y Fj(The)c(c)n(haracter)d(string)i(holding)h(the)g(name)f(of)g
-(the)h(column.)37 b(T)-7 b(railing)27 b(spaces)g(are)f(ignored.)259
-2665 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 2764 y Fj(The)c(global)e(status.)0 2925
-y Fc(Returned)32 b(V)-8 b(alue:)259 3060 y(AST)p Ft(_)p
-Fc(COLUMNNULL)33 b(=)f(INTEGER)427 3160 y Fj(The)c(n)n(um)n(b)r(er)f
-(of)h(b)n(ytes)f(required)g(to)g(store)g(the)h(column)f(data.)0
-3321 y Fc(Notes:)340 3602 y Fi(\017)45 b Fj(An)28 b(error)e(will)i(b)r
-(e)g(rep)r(orted)f(if)h(the)g(named)f(column)h(do)r(es)f(not)h(exist)f
-(in)h(the)g(FitsT)-7 b(able.)340 3734 y Fi(\017)45 b
-Fj(Zero)27 b(will)g(b)r(e)h(returned)g(as)f(the)h(function)g(v)-5
-b(alue)27 b(in)h(an)f(error)f(o)r(ccurs.)p 0 3931 V 0
-4062 a FA(AST)p Fe(_)p FA(CONVER)-11 b(T)1224 4063 y
-Fd(Determine)38 b(ho)m(w)g(to)g(con)m(v)m(ert)1285 4162
-y(b)s(et)m(w)m(een)g(t)m(w)m(o)f(co)s(ordinate)1692 4262
-y(systems)2772 4062 y FA(AST)p Fe(_)p FA(CONVER)-11 b(T)0
-4449 y Fc(Description:)44 b Fj(This)29 b(function)h(compares)d(t)n(w)n
+eop end
+%%Page: 209 219
+TeXDict begin 209 218 bop 3643 52 a FG(209)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(COLUMNSIZE)1415 483 y
+Fd(Get)38 b(the)h(n)m(um)m(b)s(er)f(of)1489 583 y(b)m(ytes)h(needed)g
+(to)1423 697 y(hold)f(a)h(full)f(column)1709 797 y(of)h(data)2538
+482 y FA(AST)p Fe(_)p FA(COLUMNSIZE)0 964 y Fc(Description:)44
+b Fj(This)37 b(function)g(returns)f(the)h(n)n(um)n(b)r(er)f(of)g(b)n
+(ytes)g(of)h(memory)e(that)i(m)n(ust)g(b)r(e)g(allo)r(cated)e(prior)h
+(to)227 1063 y(retrieving)27 b(the)h(data)f(from)g(a)g(column)h(using)f
+(AST)p Ft(_)p Fj(GETCOLUMND)n(A)-7 b(T)g(A.)0 1214 y
+Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_COLUMNSIZE\()37
+b(THIS,)42 b(COLUMN,)f(STATUS)g(\))0 1365 y Fc(Argumen)m(ts:)259
+1503 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1602
+y Fj(P)n(oin)n(ter)26 b(to)i(the)g(T)-7 b(able.)259 1736
+y Fc(COLUMN)32 b(=)g(CHARA)m(CTER)f Fi(\003)h Fc(\()g
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1835 y Fj(The)c(c)n(haracter)d
+(string)i(holding)h(the)g(name)f(of)g(the)h(column.)37
+b(T)-7 b(railing)27 b(spaces)g(are)f(ignored.)259 1969
+y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
+427 2069 y Fj(The)c(global)e(status.)0 2232 y Fc(Returned)32
+b(V)-8 b(alue:)259 2370 y(AST)p Ft(_)p Fc(COLUMNNULL)33
+b(=)f(INTEGER)427 2469 y Fj(The)c(n)n(um)n(b)r(er)f(of)h(b)n(ytes)f
+(required)g(to)g(store)g(the)h(column)f(data.)0 2633
+y Fc(Notes:)340 2916 y Fi(\017)45 b Fj(An)28 b(error)e(will)i(b)r(e)g
+(rep)r(orted)f(if)h(the)g(named)f(column)h(do)r(es)f(not)h(exist)f(in)h
+(the)g(FitsT)-7 b(able.)340 3050 y Fi(\017)45 b Fj(Zero)27
+b(will)g(b)r(e)h(returned)g(as)f(the)h(function)g(v)-5
+b(alue)27 b(in)h(an)f(error)f(o)r(ccurs.)p 0 3251 V 0
+3381 a FA(AST)p Fe(_)p FA(CONVER)-11 b(T)1224 3382 y
+Fd(Determine)38 b(ho)m(w)g(to)g(con)m(v)m(ert)1285 3482
+y(b)s(et)m(w)m(een)g(t)m(w)m(o)f(co)s(ordinate)1692 3581
+y(systems)2772 3381 y FA(AST)p Fe(_)p FA(CONVER)-11 b(T)0
+3772 y Fc(Description:)44 b Fj(This)29 b(function)h(compares)d(t)n(w)n
(o)h(F)-7 b(rames)28 b(and)h(determines)f(whether)h(it)g(is)g(p)r
-(ossible)f(to)h(con)n(v)n(ert)f(b)r(e-)227 4548 y(t)n(w)n(een)c(the)h
+(ossible)f(to)h(con)n(v)n(ert)f(b)r(e-)227 3871 y(t)n(w)n(een)c(the)h
(co)r(ordinate)e(systems)g(whic)n(h)h(they)h(represen)n(t.)34
b(If)25 b(con)n(v)n(ersion)d(is)i(p)r(ossible,)g(it)h(returns)e(a)h(F)
--7 b(rameSet)227 4648 y(whic)n(h)34 b(describ)r(es)f(the)h(con)n(v)n
+-7 b(rameSet)227 3971 y(whic)n(h)34 b(describ)r(es)f(the)h(con)n(v)n
(ersion)d(and)j(whic)n(h)f(ma)n(y)g(b)r(e)h(used)g(\(as)f(a)g
-(Mapping\))h(to)f(transform)g(co)r(ordinate)227 4748
-y(v)-5 b(alues)27 b(in)h(either)g(direction.)227 4872
+(Mapping\))h(to)f(transform)g(co)r(ordinate)227 4071
+y(v)-5 b(alues)27 b(in)h(either)g(direction.)227 4196
y(The)38 b(same)g(function)g(ma)n(y)g(also)e(b)r(e)j(used)f(to)g
(determine)g(ho)n(w)f(to)h(con)n(v)n(ert)f(b)r(et)n(w)n(een)g(t)n(w)n
-(o)h(F)-7 b(rameSets)37 b(\(or)227 4971 y(b)r(et)n(w)n(een)23
+(o)h(F)-7 b(rameSets)37 b(\(or)227 4295 y(b)r(et)n(w)n(een)23
b(a)g(F)-7 b(rame)22 b(and)h(a)f(F)-7 b(rameSet,)24 b(or)e(vice)g(v)n
(ersa\).)34 b(This)23 b(mo)r(de)g(is)g(in)n(tended)g(for)f(use)h(when)g
-(\(for)g(example\))227 5071 y(t)n(w)n(o)f(images)g(ha)n(v)n(e)f(b)r
+(\(for)g(example\))227 4395 y(t)n(w)n(o)f(images)g(ha)n(v)n(e)f(b)r
(een)i(calibrated)f(b)n(y)h(attac)n(hing)e(a)i(F)-7 b(rameSet)22
b(to)h(eac)n(h.)34 b(AST)p Ft(_)p Fj(CONVER)-7 b(T)22
-b(migh)n(t)h(then)g(b)r(e)227 5171 y(used)29 b(to)f(searc)n(h)f(for)h
+b(migh)n(t)h(then)g(b)r(e)227 4495 y(used)29 b(to)f(searc)n(h)f(for)h
(a)g(celestial)g(co)r(ordinate)g(system)g(that)h(b)r(oth)g(images)e(ha)
-n(v)n(e)h(in)g(common,)h(and)f(the)h(result)227 5270
+n(v)n(e)h(in)g(common,)h(and)f(the)h(result)227 4594
y(could)k(then)g(b)r(e)h(used)f(to)f(con)n(v)n(ert)g(b)r(et)n(w)n(een)h
(the)g(pixel)g(co)r(ordinates)e(of)i(b)r(oth)h(images)d({)i(ha)n(ving)f
-(e\013ectiv)n(ely)227 5370 y(used)c(their)f(celestial)h(co)r(ordinate)e
-(systems)h(to)h(align)e(them.)227 5494 y(When)33 b(using)f(F)-7
+(e\013ectiv)n(ely)227 4694 y(used)c(their)f(celestial)h(co)r(ordinate)e
+(systems)h(to)h(align)e(them.)227 4819 y(When)33 b(using)f(F)-7
b(rameSets,)33 b(there)f(ma)n(y)f(b)r(e)i(more)e(than)h(one)g(p)r
(ossible)g(in)n(termediate)f(co)r(ordinate)g(system)h(in)227
-5593 y(whic)n(h)j(to)g(p)r(erform)f(the)h(con)n(v)n(ersion)e(\(for)h
+4919 y(whic)n(h)j(to)g(p)r(erform)f(the)h(con)n(v)n(ersion)e(\(for)h
(instance,)j(t)n(w)n(o)d(F)-7 b(rameSets)34 b(migh)n(t)h(b)r(oth)g(ha)n
-(v)n(e)f(celestial)g(co)r(ordi-)227 5693 y(nates,)27
+(v)n(e)f(celestial)g(co)r(ordi-)227 5018 y(nates,)27
b(detector)g(co)r(ordinates,)g(pixel)g(co)r(ordinates,)f(etc.\).)38
-b(A)27 b(comma-separated)e(list)j(of)g(co)r(ordinate)e(system)p
-eop end
-%%Page: 209 219
-TeXDict begin 209 218 bop 3643 52 a FG(209)227 351 y
-Fj(domains)24 b(ma)n(y)g(therefore)g(b)r(e)h(giv)n(en)f(whic)n(h)g
+b(A)27 b(comma-separated)e(list)j(of)g(co)r(ordinate)e(system)227
+5118 y(domains)e(ma)n(y)g(therefore)g(b)r(e)h(giv)n(en)f(whic)n(h)g
(de\014nes)h(a)f(priorit)n(y)g(order)f(to)h(use)h(when)g(selecting)f
-(the)h(in)n(termedi-)227 451 y(ate)c(co)r(ordinate)e(system.)34
+(the)h(in)n(termedi-)227 5218 y(ate)c(co)r(ordinate)e(system.)34
b(The)21 b(path)g(used)f(for)g(con)n(v)n(ersion)f(m)n(ust)h(go)g(via)g
-(an)g(in)n(termediate)g(co)r(ordinate)g(system)227 551
+(an)g(in)n(termediate)g(co)r(ordinate)g(system)227 5317
y(whose)k(Domain)h(attribute)f(matc)n(hes)g(one)h(of)f(the)h(domains)f
(giv)n(en.)35 b(If)25 b(con)n(v)n(ersion)d(cannot)j(b)r(e)g(ac)n(hiev)n
-(ed)e(using)227 650 y(the)28 b(\014rst)g(domain,)f(the)h(next)g(one)f
+(ed)e(using)227 5417 y(the)28 b(\014rst)g(domain,)f(the)h(next)g(one)f
(is)g(considered,)g(and)g(so)g(on,)h(un)n(til)g(success)e(is)i(ac)n
-(hiev)n(ed.)0 810 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
+(hiev)n(ed.)0 5568 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
b(=)i(AST_CONVERT\()c(FROM,)i(TO,)i(DOMAINLIST,)c(STATUS)i(\))0
-971 y Fc(Argumen)m(ts:)259 1118 y(FR)m(OM)31 b(=)h(INTEGER)g(\(Giv)m
-(en\))427 1217 y Fj(P)n(oin)n(ter)27 b(to)h(a)g(F)-7
-b(rame)27 b(whic)n(h)h(represen)n(ts)f(the)i Ft(")p Fj(source)p
-Ft(")d Fj(co)r(ordinate)h(system.)38 b(This)28 b(is)g(the)h(co)r
-(ordinate)427 1317 y(system)f(in)f(whic)n(h)h(y)n(ou)f(already)f(ha)n
-(v)n(e)g(co)r(ordinates)h(a)n(v)-5 b(ailable.)427 1436
-y(If)26 b(a)g(F)-7 b(rameSet)25 b(is)h(giv)n(en,)f(its)h(curren)n(t)f
-(F)-7 b(rame)25 b(\(as)g(determined)h(b)n(y)f(its)h(Curren)n(t)f
-(attribute\))h(is)g(tak)n(en)f(to)427 1536 y(describ)r(e)32
-b(the)g(source)f(co)r(ordinate)g(system.)50 b(Note)32
-b(that)g(the)h(Base)e(attribute)h(of)g(this)h(F)-7 b(rameSet)31
-b(ma)n(y)427 1635 y(b)r(e)d(mo)r(di\014ed)f(b)n(y)g(this)g(function)g
-(to)g(indicate)g(whic)n(h)g(in)n(termediate)f(co)r(ordinate)g(system)h
-(w)n(as)f(used)h(\(see)427 1735 y(under)h Ft(")p Fj(F)-7
-b(rameSets)p Ft(")26 b Fj(in)i(the)g Ft(")p Fj(Applicabilit)n(y)p
-Ft(")f Fj(section)g(for)g(details\).)259 1873 y Fc(TO)32
-b(=)g(INTEGER)f(\(Giv)m(en\))427 1973 y Fj(P)n(oin)n(ter)d(to)i(a)f(F)
--7 b(rame)29 b(whic)n(h)h(represen)n(ts)e(the)i Ft(")p
-Fj(destination)p Ft(")f Fj(co)r(ordinate)g(system.)43
-b(This)29 b(is)h(the)g(co)r(or-)427 2072 y(dinate)e(system)f(in)n(to)h
+5718 y Fc(Argumen)m(ts:)p eop end
+%%Page: 210 220
+TeXDict begin 210 219 bop 0 52 a FG(210)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(FR)m(OM)g(=)h
+(INTEGER)g(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)27
+b(to)h(a)g(F)-7 b(rame)27 b(whic)n(h)h(represen)n(ts)f(the)i
+Ft(")p Fj(source)p Ft(")d Fj(co)r(ordinate)h(system.)38
+b(This)28 b(is)g(the)h(co)r(ordinate)427 551 y(system)f(in)f(whic)n(h)h
+(y)n(ou)f(already)f(ha)n(v)n(e)g(co)r(ordinates)h(a)n(v)-5
+b(ailable.)427 671 y(If)26 b(a)g(F)-7 b(rameSet)25 b(is)h(giv)n(en,)f
+(its)h(curren)n(t)f(F)-7 b(rame)25 b(\(as)g(determined)h(b)n(y)f(its)h
+(Curren)n(t)f(attribute\))h(is)g(tak)n(en)f(to)427 771
+y(describ)r(e)32 b(the)g(source)f(co)r(ordinate)g(system.)50
+b(Note)32 b(that)g(the)h(Base)e(attribute)h(of)g(this)h(F)-7
+b(rameSet)31 b(ma)n(y)427 870 y(b)r(e)d(mo)r(di\014ed)f(b)n(y)g(this)g
+(function)g(to)g(indicate)g(whic)n(h)g(in)n(termediate)f(co)r(ordinate)
+g(system)h(w)n(as)f(used)h(\(see)427 970 y(under)h Ft(")p
+Fj(F)-7 b(rameSets)p Ft(")26 b Fj(in)i(the)g Ft(")p Fj(Applicabilit)n
+(y)p Ft(")f Fj(section)g(for)g(details\).)259 1111 y
+Fc(TO)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 1211 y Fj(P)n(oin)n(ter)d(to)
+i(a)f(F)-7 b(rame)29 b(whic)n(h)h(represen)n(ts)e(the)i
+Ft(")p Fj(destination)p Ft(")f Fj(co)r(ordinate)g(system.)43
+b(This)29 b(is)h(the)g(co)r(or-)427 1310 y(dinate)e(system)f(in)n(to)h
(whic)n(h)f(y)n(ou)g(wish)h(to)f(con)n(v)n(ert)f(y)n(our)h(co)r
-(ordinates.)427 2191 y(If)33 b(a)f(F)-7 b(rameSet)32
+(ordinates.)427 1431 y(If)33 b(a)f(F)-7 b(rameSet)32
b(is)g(giv)n(en,)h(its)f(curren)n(t)f(F)-7 b(rame)32
b(\(as)g(determined)g(b)n(y)g(its)h(Curren)n(t)e(attribute\))i(is)f
-(tak)n(en)427 2291 y(to)25 b(describ)r(e)g(the)h(destination)f(co)r
+(tak)n(en)427 1530 y(to)25 b(describ)r(e)g(the)h(destination)f(co)r
(ordinate)f(system.)35 b(Note)26 b(that)f(the)h(Base)e(attribute)h(of)g
-(this)h(F)-7 b(rameSet)427 2391 y(ma)n(y)25 b(b)r(e)i(mo)r(di\014ed)f
+(this)h(F)-7 b(rameSet)427 1630 y(ma)n(y)25 b(b)r(e)i(mo)r(di\014ed)f
(b)n(y)g(this)g(function)g(to)g(indicate)g(whic)n(h)g(in)n(termediate)f
-(co)r(ordinate)g(system)h(w)n(as)f(used)427 2490 y(\(see)j(under)f
+(co)r(ordinate)g(system)h(w)n(as)f(used)427 1729 y(\(see)j(under)f
Ft(")p Fj(F)-7 b(rameSets)p Ft(")27 b Fj(in)g(the)h Ft(")p
Fj(Applicabilit)n(y)p Ft(")f Fj(section)h(for)f(details\).)259
-2628 y Fc(DOMAINLIST)33 b(=)f(CHARA)m(CTER)f Fi(\003)h
-Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427 2728 y Fj(A)f(c)n(haracter)d
+1871 y Fc(DOMAINLIST)33 b(=)f(CHARA)m(CTER)f Fi(\003)h
+Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1970 y Fj(A)f(c)n(haracter)d
(string)h(con)n(taining)g(a)h(comma-separated)e(list)i(of)g(F)-7
b(rame)30 b(domains.)44 b(This)30 b(ma)n(y)f(b)r(e)i(used)427
-2828 y(to)23 b(de\014ne)g(a)g(priorit)n(y)f(order)f(for)i(the)g
+2070 y(to)23 b(de\014ne)g(a)g(priorit)n(y)f(order)f(for)i(the)g
(di\013eren)n(t)g(in)n(termediate)g(co)r(ordinate)f(systems)g(that)h
-(migh)n(t)g(b)r(e)h(used)427 2927 y(to)k(p)r(erform)f(the)h(con)n(v)n
-(ersion.)427 3046 y(The)39 b(function)g(will)f(\014rst)g(try)g(to)g
+(migh)n(t)g(b)r(e)h(used)427 2170 y(to)k(p)r(erform)f(the)h(con)n(v)n
+(ersion.)427 2290 y(The)39 b(function)g(will)f(\014rst)g(try)g(to)g
(obtain)g(a)g(con)n(v)n(ersion)e(b)n(y)i(making)g(use)g(only)g(of)g(an)
-g(in)n(termediate)427 3146 y(co)r(ordinate)h(system)g(whose)g(Domain)h
+g(in)n(termediate)427 2390 y(co)r(ordinate)h(system)g(whose)g(Domain)h
(attribute)g(matc)n(hes)f(the)h(\014rst)g(domain)f(in)h(this)g(list.)74
-b(If)40 b(this)427 3245 y(fails,)32 b(the)g(second)f(domain)g(in)g(the)
+b(If)40 b(this)427 2489 y(fails,)32 b(the)g(second)f(domain)g(in)g(the)
h(list)g(will)f(b)r(e)h(used,)g(and)g(so)e(on,)i(un)n(til)g(con)n(v)n
-(ersion)d(is)i(ac)n(hiev)n(ed.)47 b(A)427 3345 y(blank)26
+(ersion)d(is)i(ac)n(hiev)n(ed.)47 b(A)427 2589 y(blank)26
b(domain)g(\(e.g.)36 b(t)n(w)n(o)25 b(consecutiv)n(e)g(commas\))g
(indicates)h(that)g(all)g(co)r(ordinate)f(systems)g(should)h(b)r(e)427
-3445 y(considered,)h(regardless)e(of)j(their)f(domains.)427
-3564 y(This)37 b(list)h(is)f(case-insensitiv)n(e)f(and)h(all)g(white)g
+2688 y(considered,)h(regardless)e(of)j(their)f(domains.)427
+2809 y(This)37 b(list)h(is)f(case-insensitiv)n(e)f(and)h(all)g(white)g
(space)g(is)g(ignored.)65 b(If)37 b(y)n(ou)g(do)g(not)g(wish)g(to)g
-(restrict)427 3663 y(the)d(domain)f(in)h(this)g(w)n(a)n(y)-7
+(restrict)427 2908 y(the)d(domain)f(in)h(this)g(w)n(a)n(y)-7
b(,)34 b(y)n(ou)e(should)i(supply)f(a)g(blank)g(string.)54
-b(This)34 b(is)f(normally)f(appropriate)g(if)427 3763
+b(This)34 b(is)f(normally)f(appropriate)g(if)427 3008
y(either)d(of)g(the)h(source)e(or)g(destination)h(co)r(ordinate)f
(systems)h(are)f(describ)r(ed)h(b)n(y)g(F)-7 b(rames)28
-b(\(rather)g(than)427 3863 y(F)-7 b(rameSets\),)35 b(since)e(there)g
+b(\(rather)g(than)427 3108 y(F)-7 b(rameSets\),)35 b(since)e(there)g
(is)g(then)h(usually)f(only)g(one)g(p)r(ossible)g(c)n(hoice)g(of)g(in)n
-(termediate)g(co)r(ordinate)427 3962 y(system.)259 4100
+(termediate)g(co)r(ordinate)427 3207 y(system.)259 3349
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 4200 y Fj(The)c(global)e(status.)0 4373 y Fc(Class)31
-b(Applicabilit)m(y:)259 4520 y(DSBSp)s(ecF)-8 b(rame)427
-4620 y Fj(If)24 b(the)g(AlignSideBand)g(attribute)g(is)f(non-zero,)g
+427 3448 y Fj(The)c(global)e(status.)0 3627 y Fc(Class)31
+b(Applicabilit)m(y:)259 3780 y(DSBSp)s(ecF)-8 b(rame)427
+3879 y Fj(If)24 b(the)g(AlignSideBand)g(attribute)g(is)f(non-zero,)g
(alignmen)n(t)g(o)r(ccurs)g(in)h(the)g(upp)r(er)f(sideband)h(expressed)
-427 4719 y(within)30 b(the)f(sp)r(ectral)f(system)g(and)h(standard)e
+427 3979 y(within)30 b(the)f(sp)r(ectral)f(system)g(and)h(standard)e
(of)i(rest)f(giv)n(en)g(b)n(y)g(attributes)h(AlignSystem)f(and)h
-(Align-)427 4819 y(StdOfRest.)58 b(If)35 b(AlignSideBand)f(is)g(zero,)i
+(Align-)427 4079 y(StdOfRest.)58 b(If)35 b(AlignSideBand)f(is)g(zero,)i
(the)e(t)n(w)n(o)g(DSBSp)r(ecF)-7 b(rames)34 b(are)g(aligned)f(as)h(if)
-h(they)g(w)n(ere)427 4918 y(simple)28 b(Sp)r(ecF)-7 b(rames)27
+h(they)g(w)n(ere)427 4178 y(simple)28 b(Sp)r(ecF)-7 b(rames)27
b(\(i.e.)37 b(the)28 b(SideBand)g(is)f(ignored\).)259
-5057 y Fc(F)-8 b(rame)427 5156 y Fj(This)26 b(function)f(applies)g(to)g
+4319 y Fc(F)-8 b(rame)427 4419 y Fj(This)26 b(function)f(applies)g(to)g
(all)g(F)-7 b(rames.)36 b(Alignmen)n(t)25 b(o)r(ccurs)g(within)h(the)f
-(co)r(ordinate)f(system)h(giv)n(en)g(b)n(y)427 5256 y(attribute)j
-(AlignSystem.)259 5394 y Fc(F)-8 b(rameSet)427 5494 y
+(co)r(ordinate)f(system)h(giv)n(en)g(b)n(y)427 4519 y(attribute)j
+(AlignSystem.)259 4660 y Fc(F)-8 b(rameSet)427 4760 y
Fj(If)30 b(either)g(of)g(the)g(FR)n(OM)f(or)g(TO)h(argumen)n(ts)e(is)i
(a)f(p)r(oin)n(ter)g(to)h(a)f(F)-7 b(rameSet,)31 b(then)f(AST)p
-Ft(_)p Fj(CONVER)-7 b(T)427 5593 y(will)34 b(attempt)g(to)f(con)n(v)n
+Ft(_)p Fj(CONVER)-7 b(T)427 4859 y(will)34 b(attempt)g(to)f(con)n(v)n
(ert)f(from)h(the)h(co)r(ordinate)e(system)h(describ)r(ed)g(b)n(y)g
-(the)h(curren)n(t)e(F)-7 b(rame)33 b(of)g(the)427 5693
+(the)h(curren)n(t)e(F)-7 b(rame)33 b(of)g(the)427 4959
y(FR)n(OM)28 b(F)-7 b(rameSet)27 b(to)g(that)h(describ)r(ed)g(b)n(y)f
(the)h(curren)n(t)f(F)-7 b(rame)27 b(of)g(the)h(TO)g(F)-7
-b(rameSet.)p eop end
-%%Page: 210 220
-TeXDict begin 210 219 bop 0 52 a FG(210)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(T)-7
-b(o)34 b(ac)n(hiev)n(e)g(this,)i(it)f(will)g(consider)f(all)g(of)g(the)
-h(F)-7 b(rames)34 b(within)h(eac)n(h)f(F)-7 b(rameSet)35
-b(as)e(a)i(p)r(ossible)f(w)n(a)n(y)427 451 y(of)g(reac)n(hing)e(an)i
-(in)n(termediate)f(co)r(ordinate)g(system)g(that)h(can)g(b)r(e)g(used)g
-(for)f(the)h(con)n(v)n(ersion.)53 b(There)427 551 y(is)30
-b(then)h(the)g(p)r(ossibilit)n(y)f(that)h(more)e(than)i(one)e(con)n(v)n
-(ersion)f(path)j(ma)n(y)f(exist)g(and,)h(unless)f(the)g(c)n(hoice)427
-650 y(is)g(su\016cien)n(tly)g(restricted)f(b)n(y)g(the)h(DOMAINLIST)h
-(string,)e(the)i(sequence)e(in)h(whic)n(h)f(the)i(F)-7
-b(rames)29 b(are)427 750 y(considered)19 b(can)h(b)r(e)g(imp)r(ortan)n
-(t.)34 b(In)20 b(this)h(case,)f(the)h(searc)n(h)d(for)i(a)f(con)n(v)n
-(ersion)f(path)i(pro)r(ceeds)f(as)h(follo)n(ws:)510 960
-y Fi(\017)45 b Fj(Eac)n(h)27 b(\014eld)h(in)f(the)h(DOMAINLIST)h
-(string)e(is)g(considered)g(in)g(turn.)510 1078 y Fi(\017)45
-b Fj(The)26 b(F)-7 b(rames)24 b(within)i(eac)n(h)f(F)-7
+b(rameSet.)427 5079 y(T)g(o)34 b(ac)n(hiev)n(e)g(this,)i(it)f(will)g
+(consider)f(all)g(of)g(the)h(F)-7 b(rames)34 b(within)h(eac)n(h)f(F)-7
+b(rameSet)35 b(as)e(a)i(p)r(ossible)f(w)n(a)n(y)427 5179
+y(of)g(reac)n(hing)e(an)i(in)n(termediate)f(co)r(ordinate)g(system)g
+(that)h(can)g(b)r(e)g(used)g(for)f(the)h(con)n(v)n(ersion.)53
+b(There)427 5278 y(is)30 b(then)h(the)g(p)r(ossibilit)n(y)f(that)h
+(more)e(than)i(one)e(con)n(v)n(ersion)f(path)j(ma)n(y)f(exist)g(and,)h
+(unless)f(the)g(c)n(hoice)427 5378 y(is)g(su\016cien)n(tly)g
+(restricted)f(b)n(y)g(the)h(DOMAINLIST)h(string,)e(the)i(sequence)e(in)
+h(whic)n(h)f(the)i(F)-7 b(rames)29 b(are)427 5478 y(considered)19
+b(can)h(b)r(e)g(imp)r(ortan)n(t.)34 b(In)20 b(this)h(case,)f(the)h
+(searc)n(h)d(for)i(a)f(con)n(v)n(ersion)f(path)i(pro)r(ceeds)f(as)h
+(follo)n(ws:)510 5693 y Fi(\017)45 b Fj(Eac)n(h)27 b(\014eld)h(in)f
+(the)h(DOMAINLIST)h(string)e(is)g(considered)g(in)g(turn.)p
+eop end
+%%Page: 211 221
+TeXDict begin 211 220 bop 3643 52 a FG(211)510 351 y
+Fi(\017)45 b Fj(The)26 b(F)-7 b(rames)24 b(within)i(eac)n(h)f(F)-7
b(rameSet)25 b(are)f(considered)h(in)g(a)g(sp)r(eci\014c)h(order:)34
-b(\(1\))26 b(the)f(base)g(F)-7 b(rame)597 1178 y(is)28
+b(\(1\))26 b(the)f(base)g(F)-7 b(rame)597 451 y(is)28
b(alw)n(a)n(ys)d(considered)i(\014rst,)g(\(2\))h(after)f(this)h(come)f
(all)h(the)g(other)f(F)-7 b(rames)26 b(in)i(F)-7 b(rame-index)27
-b(order)597 1277 y(\(but)h(omitting)f(the)g(base)g(and)f(curren)n(t)g
-(F)-7 b(rames\),)27 b(\(3\))g(the)g(curren)n(t)f(F)-7
-b(rame)27 b(is)g(alw)n(a)n(ys)e(considered)597 1377 y(last.)35
-b(Ho)n(w)n(ev)n(er,)22 b(if)i(either)f(F)-7 b(rameSet's)23
-b(In)n(v)n(ert)f(attribute)h(is)h(set)f(to)g(a)f(non-zero)g(v)-5
-b(alue)23 b(\(so)g(that)g(the)597 1476 y(F)-7 b(rameSet)30
-b(is)h(in)n(v)n(erted\),)f(then)h(its)g(F)-7 b(rames)30
-b(are)f(considered)h(in)g(rev)n(erse)f(order.)44 b(\(Note)31
-b(that)f(this)597 1576 y(still)h(means)e(that)h(the)h(base)e(F)-7
-b(rame)29 b(is)h(considered)f(\014rst)h(and)g(the)g(curren)n(t)f(F)-7
-b(rame)30 b(last,)g(b)r(ecause)597 1676 y(the)e(In)n(v)n(ert)f(v)-5
-b(alue)27 b(will)h(also)f(cause)g(these)g(F)-7 b(rames)27
-b(to)h(sw)n(ap)e(places.\))510 1794 y Fi(\017)45 b Fj(All)34
+b(order)597 551 y(\(but)h(omitting)f(the)g(base)g(and)f(curren)n(t)g(F)
+-7 b(rames\),)27 b(\(3\))g(the)g(curren)n(t)f(F)-7 b(rame)27
+b(is)g(alw)n(a)n(ys)e(considered)597 650 y(last.)35 b(Ho)n(w)n(ev)n
+(er,)22 b(if)i(either)f(F)-7 b(rameSet's)23 b(In)n(v)n(ert)f(attribute)
+h(is)h(set)f(to)g(a)f(non-zero)g(v)-5 b(alue)23 b(\(so)g(that)g(the)597
+750 y(F)-7 b(rameSet)30 b(is)h(in)n(v)n(erted\),)f(then)h(its)g(F)-7
+b(rames)30 b(are)f(considered)h(in)g(rev)n(erse)f(order.)44
+b(\(Note)31 b(that)f(this)597 849 y(still)h(means)e(that)h(the)h(base)e
+(F)-7 b(rame)29 b(is)h(considered)f(\014rst)h(and)g(the)g(curren)n(t)f
+(F)-7 b(rame)30 b(last,)g(b)r(ecause)597 949 y(the)e(In)n(v)n(ert)f(v)
+-5 b(alue)27 b(will)h(also)f(cause)g(these)g(F)-7 b(rames)27
+b(to)h(sw)n(ap)e(places.\))510 1067 y Fi(\017)45 b Fj(All)34
b(source)d(F)-7 b(rames)33 b(are)f(\014rst)g(considered)g(\(in)i(the)f
(appropriate)e(order\))h(for)h(con)n(v)n(ersion)d(to)j(the)597
-1893 y(\014rst)26 b(destination)g(F)-7 b(rame.)36 b(If)27
+1167 y(\014rst)26 b(destination)g(F)-7 b(rame.)36 b(If)27
b(no)e(suitable)h(in)n(termediate)g(co)r(ordinate)f(system)h(emerges,)f
-(they)i(are)597 1993 y(then)d(considered)e(again)g(for)g(con)n(v)n
+(they)i(are)597 1267 y(then)d(considered)e(again)g(for)g(con)n(v)n
(ersion)f(to)h(the)i(second)e(destination)h(F)-7 b(rame)22
-b(\(in)i(the)f(appropriate)597 2092 y(order\),)k(and)g(so)g(on.)510
-2210 y Fi(\017)45 b Fj(Generally)-7 b(,)26 b(the)h(\014rst)f(suitable)g
+b(\(in)i(the)f(appropriate)597 1366 y(order\),)k(and)g(so)g(on.)510
+1485 y Fi(\017)45 b Fj(Generally)-7 b(,)26 b(the)h(\014rst)f(suitable)g
(in)n(termediate)h(co)r(ordinate)e(system)h(found)h(is)f(used.)36
-b(Ho)n(w)n(ev)n(er,)25 b(the)597 2310 y(o)n(v)n(erall)32
+b(Ho)n(w)n(ev)n(er,)25 b(the)597 1584 y(o)n(v)n(erall)32
b(Mapping)i(b)r(et)n(w)n(een)h(the)f(source)g(and)g(destination)g(co)r
-(ordinate)f(systems)h(is)g(also)f(exam-)597 2410 y(ined.)51
+(ordinate)f(systems)h(is)g(also)f(exam-)597 1684 y(ined.)51
b(Preference)31 b(is)h(giv)n(en)f(to)h(cases)f(where)h(b)r(oth)g(the)h
(forw)n(ard)d(and)i(in)n(v)n(erse)f(transformations)597
-2509 y(are)g(de\014ned)g(\(as)g(indicated)g(b)n(y)g(the)h(T)-7
+1784 y(are)g(de\014ned)g(\(as)g(indicated)g(b)n(y)g(the)h(T)-7
b(ranF)g(orw)n(ard)29 b(and)i(T)-7 b(ranIn)n(v)n(erse)29
-b(attributes\).)48 b(If)31 b(only)g(one)597 2609 y(transformation)26
+b(attributes\).)48 b(If)31 b(only)g(one)597 1883 y(transformation)26
b(is)i(de\014ned,)g(the)g(forw)n(ard)e(one)h(is)g(preferred.)510
-2727 y Fi(\017)45 b Fj(If)39 b(the)g(domain)f(of)g(the)h(in)n
+2002 y Fi(\017)45 b Fj(If)39 b(the)g(domain)f(of)g(the)h(in)n
(termediate)f(co)r(ordinate)f(system)h(matc)n(hes)g(the)h(curren)n(t)e
-(DOMAIN-)597 2826 y(LIST)29 b(\014eld,)f(the)h(con)n(v)n(ersion)d(path)
+(DOMAIN-)597 2101 y(LIST)29 b(\014eld,)f(the)h(con)n(v)n(ersion)d(path)
i(is)h(accepted.)38 b(Otherwise,)28 b(the)h(next)f(DOMAINLIST)h
-(\014eld)g(is)597 2926 y(considered)e(and)g(the)h(pro)r(cess)f(rep)r
-(eated.)427 3062 y(If)33 b(con)n(v)n(ersion)c(is)j(p)r(ossible,)g(the)h
+(\014eld)g(is)597 2201 y(considered)e(and)g(the)h(pro)r(cess)f(rep)r
+(eated.)427 2338 y(If)33 b(con)n(v)n(ersion)c(is)j(p)r(ossible,)g(the)h
(Base)d(attributes)i(of)g(the)g(t)n(w)n(o)f(F)-7 b(rameSets)31
-b(will)h(b)r(e)h(mo)r(di\014ed)f(on)f(exit)427 3162 y(to)h(iden)n(tify)
+b(will)h(b)r(e)h(mo)r(di\014ed)f(on)f(exit)427 2438 y(to)h(iden)n(tify)
g(the)g(F)-7 b(rames)31 b(used)g(to)h(access)e(the)i(in)n(termediate)f
(co)r(ordinate)f(system)i(whic)n(h)f(w)n(as)g(\014nally)427
-3261 y(accepted.)427 3379 y(Note)26 b(that)f(it)h(is)f(p)r(ossible)g
+2538 y(accepted.)427 2656 y(Note)26 b(that)f(it)h(is)f(p)r(ossible)g
(to)h(force)e(a)h(particular)f(F)-7 b(rame)25 b(within)h(a)f(F)-7
b(rameSet)25 b(to)h(b)r(e)g(used)f(as)g(the)g(basis)427
-3479 y(for)32 b(the)g(in)n(termediate)g(co)r(ordinate)f(system,)i(if)f
+2756 y(for)32 b(the)g(in)n(termediate)g(co)r(ordinate)f(system,)i(if)f
(it)h(is)f(suitable,)h(b)n(y)f(\(a\))g(fo)r(cussing)g(atten)n(tion)g
-(on)f(it)i(b)n(y)427 3578 y(sp)r(ecifying)h(its)f(domain)g(in)h(the)g
+(on)f(it)i(b)n(y)427 2855 y(sp)r(ecifying)h(its)f(domain)g(in)h(the)g
(DOMAINLIST)g(string,)g(or)f(\(b\))h(making)f(it)h(the)g(base)e(F)-7
-b(rame,)35 b(since)427 3678 y(this)28 b(is)g(alw)n(a)n(ys)d(considered)
-i(\014rst.)259 3814 y Fc(Sp)s(ecF)-8 b(rame)427 3914
+b(rame,)35 b(since)427 2955 y(this)28 b(is)g(alw)n(a)n(ys)d(considered)
+i(\014rst.)259 3092 y Fc(Sp)s(ecF)-8 b(rame)427 3192
y Fj(Alignmen)n(t)28 b(o)r(ccurs)e(within)i(the)g(sp)r(ectral)f(system)
g(and)g(standard)g(of)g(rest)g(giv)n(en)f(b)n(y)i(attributes)f(Align-)
-427 4013 y(System)h(and)f(AlignStdOfRest.)259 4150 y
-Fc(TimeF)-8 b(rame)427 4249 y Fj(Alignmen)n(t)24 b(o)r(ccurs)e(within)h
+427 3292 y(System)h(and)f(AlignStdOfRest.)259 3429 y
+Fc(TimeF)-8 b(rame)427 3528 y Fj(Alignmen)n(t)24 b(o)r(ccurs)e(within)h
(the)h(time)f(system)g(and)g(time)g(scale)g(giv)n(en)f(b)n(y)h
-(attributes)g(AlignSystem)g(and)427 4349 y(AlignTimeScale.)0
-4517 y Fc(Returned)32 b(V)-8 b(alue:)259 4660 y(AST)p
-Ft(_)p Fc(CONVER)g(T)32 b(=)g(INTEGER)427 4760 y Fj(If)21
+(attributes)g(AlignSystem)g(and)427 3628 y(AlignTimeScale.)0
+3799 y Fc(Returned)32 b(V)-8 b(alue:)259 3944 y(AST)p
+Ft(_)p Fc(CONVER)g(T)32 b(=)g(INTEGER)427 4044 y Fj(If)21
b(the)g(requested)e(co)r(ordinate)g(con)n(v)n(ersion)f(is)j(p)r
(ossible,)g(the)g(function)g(returns)e(a)h(p)r(oin)n(ter)g(to)g(a)g(F)
--7 b(rameSet)427 4860 y(whic)n(h)28 b(describ)r(es)f(the)h(con)n(v)n
+-7 b(rameSet)427 4144 y(whic)n(h)28 b(describ)r(es)f(the)h(con)n(v)n
(ersion.)36 b(Otherwise,)27 b(a)g(n)n(ull)h(Ob)5 b(ject)28
b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))h(is)g(returned)427
-4959 y(without)g(error.)427 5077 y(If)37 b(a)g(F)-7 b(rameSet)36
+4243 y(without)g(error.)427 4362 y(If)37 b(a)g(F)-7 b(rameSet)36
b(is)h(returned,)h(it)f(will)g(con)n(tain)f(t)n(w)n(o)g(F)-7
b(rames.)64 b(F)-7 b(rame)36 b(n)n(um)n(b)r(er)g(1)h(\(its)g(base)f(F)
--7 b(rame\))427 5177 y(will)34 b(describ)r(e)f(the)h(source)f(co)r
+-7 b(rame\))427 4461 y(will)34 b(describ)r(e)f(the)h(source)f(co)r
(ordinate)f(system,)j(corresp)r(onding)d(to)h(the)h(FR)n(OM)f(argumen)n
-(t.)54 b(F)-7 b(rame)427 5276 y(n)n(um)n(b)r(er)27 b(2)g(\(its)g
+(t.)54 b(F)-7 b(rame)427 4561 y(n)n(um)n(b)r(er)27 b(2)g(\(its)g
(curren)n(t)f(F)-7 b(rame\))27 b(will)g(describ)r(e)g(the)g
(destination)g(co)r(ordinate)f(system,)h(corresp)r(onding)427
-5376 y(to)34 b(the)g(TO)f(argumen)n(t.)55 b(The)33 b(Mapping)h(whic)n
+4661 y(to)34 b(the)g(TO)f(argumen)n(t.)55 b(The)33 b(Mapping)h(whic)n
(h)f(in)n(ter-relates)f(these)i(t)n(w)n(o)f(F)-7 b(rames)33
-b(will)h(p)r(erform)f(the)427 5476 y(required)27 b(con)n(v)n(ersion)e
+b(will)h(p)r(erform)f(the)427 4760 y(required)27 b(con)n(v)n(ersion)e
(b)r(et)n(w)n(een)j(their)f(resp)r(ectiv)n(e)g(co)r(ordinate)g
-(systems.)427 5593 y(Note)c(that)g(a)g(F)-7 b(rameSet)23
+(systems.)427 4879 y(Note)c(that)g(a)g(F)-7 b(rameSet)23
b(ma)n(y)f(b)r(e)h(used)g(b)r(oth)h(as)e(a)g(Mapping)h(and)g(as)f(a)g
(F)-7 b(rame.)35 b(If)24 b(the)f(result)g(is)f(used)h(as)427
-5693 y(a)f(Mapping)h(\(e.g.)35 b(with)23 b(AST)p Ft(_)p
+4978 y(a)f(Mapping)h(\(e.g.)35 b(with)23 b(AST)p Ft(_)p
Fj(TRAN2\),)h(then)f(it)f(pro)n(vides)g(a)g(means)g(of)g(con)n(v)n
-(erting)f(co)r(ordinates)g(from)p eop end
-%%Page: 211 221
-TeXDict begin 211 220 bop 3643 52 a FG(211)427 351 y
-Fj(the)34 b(source)e(to)i(the)g(destination)f(co)r(ordinate)f(system)i
-(\(or)f(vice)g(v)n(ersa)f(if)i(its)f(in)n(v)n(erse)f(transformation)427
-451 y(is)g(selected\).)50 b(If)33 b(it)f(is)g(used)g(as)f(a)h(F)-7
-b(rame,)33 b(its)f(attributes)g(will)g(describ)r(e)g(the)g(destination)
-g(co)r(ordinate)427 551 y(system.)0 714 y Fc(Examples:)227
-856 y Fy(CVT)47 b(=)h(AST)p Ft(_)p Fy(CONVERT\()c(A,)j(B,)g(')h(',)f
-(STATUS)f(\))427 952 y Fj(A)n(ttempts)26 b(to)f(con)n(v)n(ert)e(b)r(et)
-n(w)n(een)i(the)g(co)r(ordinate)f(systems)g(represen)n(ted)g(b)n(y)g(A)
-i(and)e(B)h(\(assumed)f(to)h(b)r(e)427 1052 y(F)-7 b(rames\).)52
-b(If)33 b(successful,)h(a)e(F)-7 b(rameSet)32 b(is)h(returned)f(via)g
-(the)h(CVT)g(p)r(oin)n(ter)f(whic)n(h)h(ma)n(y)f(b)r(e)h(used)g(to)427
-1151 y(apply)28 b(the)g(con)n(v)n(ersion)d(to)i(sets)h(of)f(co)r
-(ordinates)f(\(e.g.)37 b(using)27 b(AST)p Ft(_)p Fj(TRAN2\).)227
-1277 y Fy(CVT)47 b(=)h(AST)p Ft(_)p Fy(CONVERT\()c(AST)p
-Ft(_)p Fy(SKYFRAME\()g(')j(',)h(STATUS)e(\),)h(AST)p
-Ft(_)p Fy(SKYFRAME\()227 1377 y('Equinox=2005',)d(STATUS)i(\),)h(')h
-(',)f(STATUS)f(\))427 1463 y Fj(Creates)23 b(a)g(F)-7
+(erting)f(co)r(ordinates)g(from)427 5078 y(the)34 b(source)e(to)i(the)g
+(destination)f(co)r(ordinate)f(system)i(\(or)f(vice)g(v)n(ersa)f(if)i
+(its)f(in)n(v)n(erse)f(transformation)427 5178 y(is)g(selected\).)50
+b(If)33 b(it)f(is)g(used)g(as)f(a)h(F)-7 b(rame,)33 b(its)f(attributes)
+g(will)g(describ)r(e)g(the)g(destination)g(co)r(ordinate)427
+5277 y(system.)0 5448 y Fc(Examples:)227 5597 y Fy(CVT)47
+b(=)h(AST)p Ft(_)p Fy(CONVERT\()c(A,)j(B,)g(')h(',)f(STATUS)f(\))427
+5693 y Fj(A)n(ttempts)26 b(to)f(con)n(v)n(ert)e(b)r(et)n(w)n(een)i(the)
+g(co)r(ordinate)f(systems)g(represen)n(ted)g(b)n(y)g(A)i(and)e(B)h
+(\(assumed)f(to)h(b)r(e)p eop end
+%%Page: 212 222
+TeXDict begin 212 221 bop 0 52 a FG(212)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(F)-7
+b(rames\).)52 b(If)33 b(successful,)h(a)e(F)-7 b(rameSet)32
+b(is)h(returned)f(via)g(the)h(CVT)g(p)r(oin)n(ter)f(whic)n(h)h(ma)n(y)f
+(b)r(e)h(used)g(to)427 451 y(apply)28 b(the)g(con)n(v)n(ersion)d(to)i
+(sets)h(of)f(co)r(ordinates)f(\(e.g.)37 b(using)27 b(AST)p
+Ft(_)p Fj(TRAN2\).)227 584 y Fy(CVT)47 b(=)h(AST)p Ft(_)p
+Fy(CONVERT\()c(AST)p Ft(_)p Fy(SKYFRAME\()g(')j(',)h(STATUS)e(\),)h
+(AST)p Ft(_)p Fy(SKYFRAME\()227 684 y('Equinox=2005',)d(STATUS)i(\),)h
+(')h(',)f(STATUS)f(\))427 770 y Fj(Creates)23 b(a)g(F)-7
b(rameSet)23 b(whic)n(h)g(describ)r(es)g(precession)f(in)i(the)g
(default)g(FK5)f(celestial)g(co)r(ordinate)f(system)427
-1563 y(b)r(et)n(w)n(een)27 b(equino)n(xes)f(J2000)e(\(also)i(the)i
+869 y(b)r(et)n(w)n(een)27 b(equino)n(xes)f(J2000)e(\(also)i(the)i
(default\))f(and)g(J2005.)34 b(The)27 b(returned)f(CVT)i(p)r(oin)n(ter)
-e(ma)n(y)g(then)427 1662 y(b)r(e)31 b(passed)f(to)g(AST)p
+e(ma)n(y)g(then)427 969 y(b)r(e)31 b(passed)f(to)g(AST)p
Ft(_)p Fj(TRAN2)h(to)g(apply)f(this)h(precession)e(correction)g(to)h
-(an)n(y)g(n)n(um)n(b)r(er)g(of)h(co)r(ordinate)427 1762
-y(v)-5 b(alues)27 b(giv)n(en)g(in)h(radians.)427 1879
+(an)n(y)g(n)n(um)n(b)r(er)g(of)h(co)r(ordinate)427 1069
+y(v)-5 b(alues)27 b(giv)n(en)g(in)h(radians.)427 1189
y(Note)h(that)h(the)f(returned)f(F)-7 b(rameSet)29 b(also)f(con)n
(tains)g(information)g(ab)r(out)h(ho)n(w)g(to)f(format)h(co)r(ordinate)
-427 1978 y(v)-5 b(alues.)47 b(This)30 b(means)h(that)g(setting)g(its)g
+427 1288 y(v)-5 b(alues.)47 b(This)30 b(means)h(that)g(setting)g(its)g
(Rep)r(ort)f(attribute)h(to)g(1)g(is)f(a)h(simple)g(w)n(a)n(y)e(to)i
-(obtain)g(prin)n(ted)427 2078 y(output)j(\(formatted)f(in)g
+(obtain)g(prin)n(ted)427 1388 y(output)j(\(formatted)f(in)g
(sexagesimal)e(notation\))i(to)g(sho)n(w)f(the)i(co)r(ordinate)e(v)-5
-b(alues)32 b(b)r(efore)h(and)g(after)427 2178 y(con)n(v)n(ersion.)227
-2315 y Fy(CVT)47 b(=)h(AST)p Ft(_)p Fy(CONVERT\()c(A,)j(B,)g
-('SKY,DETECTOR,',)d(STATUS)i(\))427 2411 y Fj(A)n(ttempts)34
+b(alues)32 b(b)r(efore)h(and)g(after)427 1488 y(con)n(v)n(ersion.)227
+1632 y Fy(CVT)47 b(=)h(AST)p Ft(_)p Fy(CONVERT\()c(A,)j(B,)g
+('SKY,DETECTOR,',)d(STATUS)i(\))427 1728 y Fj(A)n(ttempts)34
b(to)f(con)n(v)n(ert)f(b)r(et)n(w)n(een)h(the)g(co)r(ordinate)f
(systems)g(represen)n(ted)g(b)n(y)h(the)g(curren)n(t)f(F)-7
-b(rames)33 b(of)427 2511 y(A)h(and)f(B)g(\(no)n(w)g(assumed)g(to)g(b)r
+b(rames)33 b(of)427 1828 y(A)h(and)f(B)g(\(no)n(w)g(assumed)g(to)g(b)r
(e)g(F)-7 b(rameSets\),)35 b(via)e(the)g(in)n(termediate)g
Ft(")p Fj(SKY)p Ft(")g Fj(co)r(ordinate)f(system.)427
-2610 y(This,)c(b)n(y)g(default,)g(is)g(the)g(Domain)g(asso)r(ciated)e
+1927 y(This,)c(b)n(y)g(default,)g(is)g(the)g(Domain)g(asso)r(ciated)e
(with)i(a)g(celestial)f(co)r(ordinate)g(system)g(represen)n(ted)g(b)n
-(y)427 2710 y(a)g(SkyF)-7 b(rame.)427 2826 y(If)21 b(this)h(fails)e
+(y)427 2027 y(a)g(SkyF)-7 b(rame.)427 2147 y(If)21 b(this)h(fails)e
(\(for)h(example,)g(b)r(ecause)g(either)f(F)-7 b(rameSet)21
b(lac)n(ks)e(celestial)i(co)r(ordinate)e(information\),)j(then)427
-2926 y(the)27 b(user-de\014ned)g Ft(")p Fj(DETECTOR)p
+2247 y(the)27 b(user-de\014ned)g Ft(")p Fj(DETECTOR)p
Ft(")e Fj(co)r(ordinate)g(system)i(is)f(used)h(instead.)37
-b(If)27 b(this)g(also)f(fails,)h(then)g(all)427 3026
+b(If)27 b(this)g(also)f(fails,)h(then)g(all)427 2346
y(other)g(p)r(ossible)h(w)n(a)n(ys)e(of)h(ac)n(hieving)g(con)n(v)n
(ersion)e(are)h(considered)h(b)r(efore)g(giving)g(up.)427
-3142 y(The)e(returned)g(p)r(oin)n(ter)g(CVT)g(indicates)g(whether)g
+2466 y(The)e(returned)g(p)r(oin)n(ter)g(CVT)g(indicates)g(whether)g
(con)n(v)n(ersion)e(w)n(as)h(p)r(ossible)h(and)g(will)g(ha)n(v)n(e)f
-(the)i(v)-5 b(alue)427 3242 y(AST)p Ft(__)p Fj(NULL)33
+(the)i(v)-5 b(alue)427 2566 y(AST)p Ft(__)p Fj(NULL)33
b(if)h(it)f(w)n(as)f(not.)53 b(If)33 b(con)n(v)n(ersion)e(w)n(as)h(p)r
(ossible,)i(CVT)f(will)g(p)r(oin)n(t)g(at)g(a)g(new)g(F)-7
-b(rameSet)427 3342 y(describing)27 b(the)h(con)n(v)n(ersion.)427
-3458 y(The)g(Base)f(attributes)h(of)g(the)g(t)n(w)n(o)f(F)-7
+b(rameSet)427 2666 y(describing)27 b(the)h(con)n(v)n(ersion.)427
+2786 y(The)g(Base)f(attributes)h(of)g(the)g(t)n(w)n(o)f(F)-7
b(rameSets)28 b(will)g(b)r(e)g(set)g(b)n(y)f(AST)p Ft(_)p
-Fj(CONVER)-7 b(T)28 b(to)g(indicate)g(whic)n(h)427 3558
+Fj(CONVER)-7 b(T)28 b(to)g(indicate)g(whic)n(h)427 2885
y(of)j(their)f(F)-7 b(rames)30 b(w)n(as)g(used)h(for)f(the)h(in)n
(termediate)f(co)r(ordinate)g(system.)45 b(This)31 b(means)f(that)h(y)n
-(ou)f(can)427 3658 y(subsequen)n(tly)22 b(determine)g(whic)n(h)h(co)r
+(ou)f(can)427 2985 y(subsequen)n(tly)22 b(determine)g(whic)n(h)h(co)r
(ordinate)e(system)h(w)n(as)f(used)h(b)n(y)g(enquiring)g(the)g(Domain)g
-(attribute)427 3757 y(of)28 b(either)f(base)g(F)-7 b(rame.)0
-3921 y Fc(Notes:)340 4205 y Fi(\017)45 b Fj(The)40 b(Mapping)f
+(attribute)427 3085 y(of)28 b(either)f(base)g(F)-7 b(rame.)0
+3262 y Fc(Notes:)340 3560 y Fi(\017)45 b Fj(The)40 b(Mapping)f
(represen)n(ted)f(b)n(y)h(the)h(returned)f(F)-7 b(rameSet)40
b(results)f(in)g(alignmen)n(t)g(taking)g(place)g(in)427
-4305 y(the)g(co)r(ordinate)e(system)g(sp)r(eci\014ed)i(b)n(y)e(the)i
+3660 y(the)g(co)r(ordinate)e(system)g(sp)r(eci\014ed)i(b)n(y)e(the)i
(AlignSystem)f(attribute)g(of)g(the)h(TO)e(F)-7 b(rame.)68
-b(See)38 b(the)427 4404 y(description)27 b(of)h(the)g(AlignSystem)g
-(attribute)f(for)g(further)h(details.)340 4538 y Fi(\017)45
+b(See)38 b(the)427 3759 y(description)27 b(of)h(the)g(AlignSystem)g
+(attribute)f(for)g(further)h(details.)340 3900 y Fi(\017)45
b Fj(When)d(aligning)e(\(sa)n(y\))g(t)n(w)n(o)h(images,)i(whic)n(h)e
(ha)n(v)n(e)f(b)r(een)h(calibrated)f(b)n(y)h(attac)n(hing)f(F)-7
-b(rameSets)41 b(to)427 4638 y(them,)26 b(it)e(is)h(usually)e(necessary)
+b(rameSets)41 b(to)427 4000 y(them,)26 b(it)e(is)h(usually)e(necessary)
g(to)h(con)n(v)n(ert)f(b)r(et)n(w)n(een)h(the)h(base)e(F)-7
b(rames)24 b(\(represen)n(ting)f Ft(")p Fj(nativ)n(e)p
-Ft(")g Fj(pixel)427 4737 y(co)r(ordinates\))f(of)g(b)r(oth)i(F)-7
+Ft(")g Fj(pixel)427 4099 y(co)r(ordinates\))f(of)g(b)r(oth)i(F)-7
b(rameSets.)34 b(This)23 b(ma)n(y)f(b)r(e)h(ac)n(hiev)n(ed)f(b)n(y)g
(in)n(v)n(erting)g(the)h(F)-7 b(rameSets)22 b(\(e.g.)35
-b(using)427 4837 y(astIn)n(v)n(ert\))27 b(so)g(as)g(to)g(in)n(terc)n
+b(using)427 4199 y(astIn)n(v)n(ert\))27 b(so)g(as)g(to)g(in)n(terc)n
(hange)f(their)i(base)f(and)g(curren)n(t)g(F)-7 b(rames)27
-b(b)r(efore)g(using)g(astCon)n(v)n(ert.)340 4971 y Fi(\017)45
+b(b)r(efore)g(using)g(astCon)n(v)n(ert.)340 4339 y Fi(\017)45
b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 5070
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 4439
y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 5271 3780 12 v 0 5402
-a FA(AST)p Fe(_)p FA(COPY)1482 5403 y Fd(Cop)m(y)37 b(an)i(Ob)7
-b(ject)3057 5402 y FA(AST)p Fe(_)p FA(COPY)0 5593 y Fc(Description:)44
+(fail)h(for)f(an)n(y)g(reason.)p 0 4654 3780 12 v 0 4785
+a FA(AST)p Fe(_)p FA(COPY)1482 4786 y Fd(Cop)m(y)37 b(an)i(Ob)7
+b(ject)3057 4785 y FA(AST)p Fe(_)p FA(COPY)0 4990 y Fc(Description:)44
b Fj(This)38 b(function)h(creates)d(a)i(cop)n(y)f(of)h(an)f(Ob)5
b(ject)38 b(and)g(returns)f(a)h(p)r(oin)n(ter)f(to)h(the)g(resulting)g
-(new)227 5693 y(Ob)5 b(ject.)62 b(It)36 b(mak)n(es)f(a)h
+(new)227 5090 y(Ob)5 b(ject.)62 b(It)36 b(mak)n(es)f(a)h
Ft(")p Fj(deep)p Ft(")f Fj(cop)n(y)-7 b(,)38 b(whic)n(h)d(con)n(tains)h
(no)f(references)g(to)h(an)n(y)f(other)g(Ob)5 b(ject)36
-b(\(i.e.)63 b(if)36 b(the)p eop end
-%%Page: 212 222
-TeXDict begin 212 221 bop 0 52 a FG(212)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)227 351 y Fj(original)e(Ob)5
+b(\(i.e.)63 b(if)36 b(the)227 5189 y(original)29 b(Ob)5
b(ject)31 b(con)n(tains)f(references)g(to)g(other)g(Ob)5
b(jects,)32 b(then)f(the)g(actual)f(data)h(are)e(copied,)j(not)f
-(simply)227 451 y(the)d(references\).)36 b(This)27 b(means)f(that)i(mo)
-r(di\014cations)e(ma)n(y)h(safely)f(b)r(e)i(made)f(to)f(the)i(cop)n(y)e
-(without)i(indirectly)227 551 y(a\013ecting)g(an)n(y)e(other)h(Ob)5
-b(ject.)0 695 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
-b(=)i(AST_COPY\()d(THIS,)h(STATUS)h(\))0 839 y Fc(Argumen)m(ts:)259
-970 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1069 y
-Fj(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5 b(ject)27 b(to)h(b)r(e)g(copied.)
-259 1197 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 1296 y Fj(The)c(global)e(status.)0 1453
-y Fc(Class)31 b(Applicabilit)m(y:)259 1584 y(Ob)5 b(ject)427
-1684 y Fj(This)28 b(function)g(applies)f(to)h(all)f(Ob)5
-b(jects.)0 1840 y Fc(Returned)32 b(V)-8 b(alue:)259 1971
-y(AST)p Ft(_)p Fc(COPY)32 b(=)g(INTEGER)427 2071 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(new)f(Ob)5 b(ject.)0 2227 y Fc(Notes:)340
-2504 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20
+(simply)227 5289 y(the)d(references\).)36 b(This)27 b(means)f(that)i
+(mo)r(di\014cations)e(ma)n(y)h(safely)f(b)r(e)i(made)f(to)f(the)i(cop)n
+(y)e(without)i(indirectly)227 5388 y(a\013ecting)g(an)n(y)e(other)h(Ob)
+5 b(ject.)0 5553 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
+b(=)i(AST_COPY\()d(THIS,)h(STATUS)h(\))0 5718 y Fc(Argumen)m(ts:)p
+eop end
+%%Page: 213 223
+TeXDict begin 213 222 bop 3643 52 a FG(213)259 351 y
+Fc(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(Ob)5 b(ject)27 b(to)h(b)r(e)g(copied.)259
+586 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 686 y Fj(The)c(global)e(status.)0 852
+y Fc(Class)31 b(Applicabilit)m(y:)259 993 y(Ob)5 b(ject)427
+1092 y Fj(This)28 b(function)g(applies)f(to)h(all)f(Ob)5
+b(jects.)0 1259 y Fc(Returned)32 b(V)-8 b(alue:)259 1399
+y(AST)p Ft(_)p Fc(COPY)32 b(=)g(INTEGER)427 1499 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(new)f(Ob)5 b(ject.)0 1665 y Fc(Notes:)340
+1952 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20
b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e
(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 2604 y(set)28 b(to)f(an)h(error)d(v)-5
+b(A)g(TUS)427 2052 y(set)28 b(to)f(an)h(error)d(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-0 2792 3780 12 v 0 2923 a FA(AST)p Fe(_)p FA(CURRENTTIME)1609
-2924 y Fd(Return)39 b(the)1706 3024 y(curren)m(t)1582
-3123 y(system)f(time)2401 2923 y FA(AST)p Fe(_)p FA(CURRENTTIME)0
-3301 y Fc(Description:)44 b Fj(This)36 b(routine)f(returns)f(the)i
+0 2256 3780 12 v 0 2386 a FA(AST)p Fe(_)p FA(CURRENTTIME)1609
+2387 y Fd(Return)39 b(the)1706 2487 y(curren)m(t)1582
+2587 y(system)f(time)2401 2386 y FA(AST)p Fe(_)p FA(CURRENTTIME)0
+2780 y Fc(Description:)44 b Fj(This)36 b(routine)f(returns)f(the)i
(curren)n(t)e(system)h(time,)j(represen)n(ted)c(in)i(the)g(form)f(sp)r
-(eci\014ed)g(b)n(y)g(the)227 3401 y(supplied)f(TimeF)-7
+(eci\014ed)g(b)n(y)g(the)227 2879 y(supplied)f(TimeF)-7
b(rame.)53 b(That)34 b(is,)g(the)g(returned)f(\015oating)f(p)r(oin)n(t)
i(v)-5 b(alue)33 b(should)g(b)r(e)h(in)n(terpreted)e(using)h(the)227
-3501 y(attribute)d(v)-5 b(alues)28 b(of)h(the)h(TimeF)-7
+2979 y(attribute)d(v)-5 b(alues)28 b(of)h(the)h(TimeF)-7
b(rame.)41 b(This)29 b(includes)g(System,)h(TimeOrigin,)e(L)-7
-b(TO\013set,)30 b(TimeScale,)f(and)227 3600 y(Unit.)0
-3744 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i
-(AST_CURRENTTIME\()37 b(THIS,)42 b(STATUS)f(\))0 3888
-y Fc(Argumen)m(ts:)259 4020 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
-4119 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(TimeF)-7 b(rame.)259
-4247 y Fc(ST)f(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 4346 y Fj(The)c(global)e(status.)0 4503
-y Fc(Returned)32 b(V)-8 b(alue:)259 4634 y(AST)p Ft(_)p
-Fc(CURRENTTIME)32 b(=)g(DOUBLE)0 4890 y(Notes:)340 5167
+b(TO\013set,)30 b(TimeScale,)f(and)227 3079 y(Unit.)0
+3233 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i
+(AST_CURRENTTIME\()37 b(THIS,)42 b(STATUS)f(\))0 3386
+y Fc(Argumen)m(ts:)259 3527 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
+3627 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(TimeF)-7 b(rame.)259
+3762 y Fc(ST)f(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 3862 y Fj(The)c(global)e(status.)0 4028
+y Fc(Returned)32 b(V)-8 b(alue:)259 4169 y(AST)p Ft(_)p
+Fc(CURRENTTIME)32 b(=)g(DOUBLE)0 4435 y(Notes:)340 4722
y Fi(\017)45 b Fj(V)-7 b(alues)35 b(of)g(AST)p Ft(__)p
Fj(BAD)g(will)h(b)r(e)f(returned)g(if)g(this)h(function)g(is)f(in)n(v)n
(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)36 b(set)f(to)g(an)427
-5267 y(error)26 b(v)-5 b(alue,)27 b(or)g(if)h(it)g(should)g(fail)f(for)
-g(an)n(y)g(reason.)340 5394 y Fi(\017)45 b Fj(It)33 b(is)f(assumes)f
+4821 y(error)26 b(v)-5 b(alue,)27 b(or)g(if)h(it)g(should)g(fail)f(for)
+g(an)n(y)g(reason.)340 4956 y Fi(\017)45 b Fj(It)33 b(is)f(assumes)f
(that)i(the)g(system)f(time)g(\(returned)h(b)n(y)f(the)g(C)h(time\(\))g
-(function\))g(follo)n(ws)e(the)i(POSIX)427 5494 y(standard,)24
+(function\))g(follo)n(ws)e(the)i(POSIX)427 5056 y(standard,)24
b(represen)n(ting)e(a)h(con)n(tin)n(uous)f(monotonic)h(increasing)f
(coun)n(t)h(of)g(SI)h(seconds)f(since)g(the)h(ep)r(o)r(c)n(h)427
-5593 y(00:00:00)j(UTC)k(1)e(Jan)n(uary)f(1970)g(AD)j(\(equiv)-5
+5155 y(00:00:00)j(UTC)k(1)e(Jan)n(uary)f(1970)g(AD)j(\(equiv)-5
b(alen)n(t)30 b(to)g(T)-7 b(AI)30 b(with)g(a)g(constan)n(t)f
-(o\013set\).)44 b(Resolution)30 b(is)427 5693 y(one)d(second.)p
-eop end
-%%Page: 213 223
-TeXDict begin 213 222 bop 3643 52 a FG(213)340 351 y
-Fi(\017)45 b Fj(An)24 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)h(the)g
-(TimeF)-7 b(rame)23 b(has)g(a)g(TimeScale)h(v)-5 b(alue)23
-b(whic)n(h)h(cannot)f(b)r(e)h(con)n(v)n(erted)427 451
-y(to)k(T)-7 b(AI)28 b(\(e.g.)36 b Ft(")p Fj(angular)p
+(o\013set\).)44 b(Resolution)30 b(is)427 5255 y(one)d(second.)340
+5390 y Fi(\017)45 b Fj(An)24 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)
+h(the)g(TimeF)-7 b(rame)23 b(has)g(a)g(TimeScale)h(v)-5
+b(alue)23 b(whic)n(h)h(cannot)f(b)r(e)h(con)n(v)n(erted)427
+5490 y(to)k(T)-7 b(AI)28 b(\(e.g.)36 b Ft(")p Fj(angular)p
Ft(")26 b Fj(systems)h(suc)n(h)g(as)g(UT1,)g(GMST,)h(LMST)g(and)g
-(LAST\).)340 594 y Fi(\017)45 b Fj(An)n(y)28 b(inaccuracy)e(in)i(the)g
+(LAST\).)340 5625 y Fi(\017)45 b Fj(An)n(y)28 b(inaccuracy)e(in)i(the)g
(system)f(clo)r(c)n(k)g(will)h(b)r(e)g(re\015ected)f(in)h(the)g(v)-5
-b(alue)27 b(returned)h(b)n(y)f(this)h(function.)p 0 812
-3780 12 v 0 943 a FA(AST)p Fe(_)p FA(CUR)-15 b(VE)1318
-944 y Fd(Dra)m(w)38 b(a)g(geo)s(desic)g(curv)m(e)2972
-943 y FA(AST)p Fe(_)p FA(CUR)-15 b(VE)0 1153 y Fc(Description:)44
+b(alue)27 b(returned)h(b)n(y)f(this)h(function.)p eop
+end
+%%Page: 214 224
+TeXDict begin 214 223 bop 0 52 a FG(214)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(CUR)-15 b(VE)1318 483 y
+Fd(Dra)m(w)38 b(a)g(geo)s(desic)g(curv)m(e)2972 482 y
+FA(AST)p Fe(_)p FA(CUR)-15 b(VE)0 671 y Fc(Description:)44
b Fj(This)24 b(routine)g(dra)n(ws)f(a)h(geo)r(desic)f(curv)n(e)g(b)r
(et)n(w)n(een)h(t)n(w)n(o)g(p)r(oin)n(ts)g(in)g(the)h(ph)n(ysical)e(co)
-r(ordinate)g(system)227 1252 y(of)g(a)f(Plot.)34 b(The)23
+r(ordinate)g(system)227 771 y(of)g(a)f(Plot.)34 b(The)23
b(curv)n(e)e(dra)n(wn)g(is)h(the)h(path)g(of)f(shortest)g(distance)g
(joining)g(the)h(t)n(w)n(o)e(p)r(oin)n(ts)h(\(as)g(de\014ned)h(b)n(y)f
-(the)227 1352 y(AST)p Ft(_)p Fj(DIST)-7 b(ANCE)30 b(function)g(for)e
+(the)227 870 y(AST)p Ft(_)p Fj(DIST)-7 b(ANCE)30 b(function)g(for)e
(the)i(curren)n(t)e(F)-7 b(rame)29 b(of)g(the)g(Plot\).)41
b(F)-7 b(or)29 b(example,)g(if)g(the)h(curren)n(t)e(F)-7
-b(rame)227 1451 y(is)24 b(a)g(basic)f(F)-7 b(rame,)25
+b(rame)227 970 y(is)24 b(a)g(basic)f(F)-7 b(rame,)25
b(then)f(the)g(curv)n(e)g(joining)f(the)i(t)n(w)n(o)e(p)r(oin)n(ts)h
(will)g(b)r(e)h(a)e(straigh)n(t)g(line)h(in)h(ph)n(ysical)e(co)r
-(ordinate)227 1551 y(space.)34 b(If)23 b(the)f(curren)n(t)f(F)-7
+(ordinate)227 1070 y(space.)34 b(If)23 b(the)f(curren)n(t)f(F)-7
b(rame)21 b(is)h(more)f(sp)r(ecialised)g(and)h(describ)r(es,)g(for)g
-(instance,)g(a)g(sky)f(co)r(ordinate)g(system,)227 1651
+(instance,)g(a)g(sky)f(co)r(ordinate)g(system,)227 1169
y(then)32 b(the)f(geo)r(desic)g(curv)n(e)f(w)n(ould)g(b)r(e)i(a)f
(great)e(circle)i(in)g(ph)n(ysical)g(co)r(ordinate)e(space)i(passing)f
-(through)g(the)227 1750 y(t)n(w)n(o)d(sky)g(p)r(ositions)g(giv)n(en.)
-227 1885 y(Note)g(that)g(the)g(geo)r(desic)f(curv)n(e)g(is)h
+(through)g(the)227 1269 y(t)n(w)n(o)d(sky)g(p)r(ositions)g(giv)n(en.)
+227 1393 y(Note)g(that)g(the)g(geo)r(desic)f(curv)n(e)g(is)h
(transformed)e(in)n(to)i(graphical)e(co)r(ordinate)h(space)g(for)g
-(plotting,)h(so)f(that)h(a)227 1984 y(straigh)n(t)20
+(plotting,)h(so)f(that)h(a)227 1493 y(straigh)n(t)20
b(line)h(in)g(ph)n(ysical)e(co)r(ordinates)h(ma)n(y)g(result)g(in)h(a)f
(curv)n(ed)g(line)h(b)r(eing)g(dra)n(wn)e(if)j(the)f(Mapping)f(in)n(v)n
-(olv)n(ed)227 2084 y(is)29 b(non-linear.)40 b(An)n(y)29
+(olv)n(ed)227 1592 y(is)29 b(non-linear.)40 b(An)n(y)29
b(discon)n(tin)n(uities)g(in)g(the)h(Mapping)e(b)r(et)n(w)n(een)h(ph)n
(ysical)g(and)f(graphical)g(co)r(ordinates)g(are)227
-2184 y(catered)f(for,)g(as)g(is)h(an)n(y)e(clipping)i(established)f
-(using)h(AST)p Ft(_)p Fj(CLIP)-7 b(.)227 2318 y(If)38
+1692 y(catered)f(for,)g(as)g(is)h(an)n(y)e(clipping)i(established)f
+(using)h(AST)p Ft(_)p Fj(CLIP)-7 b(.)227 1816 y(If)38
b(y)n(ou)f(need)h(to)f(dra)n(w)g(man)n(y)g(geo)r(desic)g(curv)n(es)f
(end-to-end,)k(then)e(the)g(AST)p Ft(_)p Fj(POL)-7 b(YCUR)e(VE)37
-b(routine)g(is)227 2418 y(equiv)-5 b(alen)n(t)28 b(to)f(rep)r(eatedly)g
+b(routine)g(is)227 1916 y(equiv)-5 b(alen)n(t)28 b(to)f(rep)r(eatedly)g
(calling)g(AST)p Ft(_)p Fj(CUR)-9 b(VE,)28 b(but)g(will)g(usually)f(b)r
-(e)h(more)f(e\016cien)n(t.)227 2552 y(If)h(y)n(ou)f(need)h(to)f(dra)n
+(e)h(more)f(e\016cien)n(t.)227 2040 y(If)h(y)n(ou)f(need)h(to)f(dra)n
(w)g(curv)n(es)f(whic)n(h)i(are)e(not)i(geo)r(desics,)e(see)i(AST)p
Ft(_)p Fj(GENCUR)-9 b(VE)27 b(or)g(AST)p Ft(_)p Fj(GRIDLINE.)0
-2721 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_CURVE\()d(THIS,)j
-(START,)f(FINISH,)f(STATUS)i(\))0 2890 y Fc(Argumen)m(ts:)259
-3046 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 3146
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259 3288 y Fc(ST)-8
+2189 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_CURVE\()d(THIS,)j
+(START,)f(FINISH,)f(STATUS)i(\))0 2338 y Fc(Argumen)m(ts:)259
+2474 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 2574
+y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259 2707 y Fc(ST)-8
b(AR)g(T\()33 b Fi(\003)e Fc(\))h(=)g(DOUBLE)g(PRECISION)g(\(Giv)m
-(en\))427 3388 y Fj(An)f(arra)n(y)-7 b(,)30 b(with)h(one)f(elemen)n(t)h
+(en\))427 2806 y Fj(An)f(arra)n(y)-7 b(,)30 b(with)h(one)f(elemen)n(t)h
(for)f(eac)n(h)g(axis)g(of)h(the)g(Plot,)g(giving)e(the)j(ph)n(ysical)d
-(co)r(ordinates)h(of)g(the)427 3488 y(\014rst)e(p)r(oin)n(t)f(on)h(the)
-g(geo)r(desic)e(curv)n(e.)259 3630 y Fc(FINISH\()32 b
+(co)r(ordinates)h(of)g(the)427 2906 y(\014rst)e(p)r(oin)n(t)f(on)h(the)
+g(geo)r(desic)e(curv)n(e.)259 3038 y Fc(FINISH\()32 b
Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m(en\))427
-3730 y Fj(An)g(arra)n(y)-7 b(,)30 b(with)h(one)f(elemen)n(t)h(for)f
+3138 y Fj(An)g(arra)n(y)-7 b(,)30 b(with)h(one)f(elemen)n(t)h(for)f
(eac)n(h)g(axis)g(of)h(the)g(Plot,)g(giving)e(the)j(ph)n(ysical)d(co)r
-(ordinates)h(of)g(the)427 3830 y(second)d(p)r(oin)n(t)h(on)f(the)h(geo)
-r(desic)f(curv)n(e.)259 3972 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 4072
-y Fj(The)c(global)e(status.)0 4253 y Fc(Notes:)340 4556
+(ordinates)h(of)g(the)427 3237 y(second)d(p)r(oin)n(t)h(on)f(the)h(geo)
+r(desic)f(curv)n(e.)259 3370 y Fc(ST)-8 b(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 3470
+y Fj(The)c(global)e(status.)0 3631 y Fc(Notes:)340 3913
y Fi(\017)45 b Fj(No)32 b(curv)n(e)f(is)g(dra)n(wn)g(if)h(either)g(of)g
(the)g(ST)-7 b(AR)g(T)32 b(or)f(FINISH)i(arra)n(ys)c(con)n(tains)i(an)n
-(y)g(co)r(ordinates)f(with)427 4655 y(the)e(v)-5 b(alue)28
-b(AST)p Ft(__)p Fj(BAD.)340 4798 y Fi(\017)45 b Fj(An)28
+(y)g(co)r(ordinates)f(with)427 4013 y(the)e(v)-5 b(alue)28
+b(AST)p Ft(__)p Fj(BAD.)340 4145 y Fi(\017)45 b Fj(An)28
b(error)e(results)h(if)h(the)g(base)f(F)-7 b(rame)27
-b(of)h(the)g(Plot)f(is)g(not)h(2-dimensional.)340 4940
+b(of)h(the)g(Plot)f(is)g(not)h(2-dimensional.)340 4278
y Fi(\017)45 b Fj(An)30 b(error)d(also)g(results)i(if)g(the)g
(transformation)f(b)r(et)n(w)n(een)h(the)g(curren)n(t)f(and)h(base)f(F)
--7 b(rames)28 b(of)h(the)g(Plot)427 5040 y(is)f(not)f(de\014ned)h
+-7 b(rames)28 b(of)h(the)g(Plot)427 4377 y(is)f(not)f(de\014ned)h
(\(i.e.)38 b(the)28 b(Plot's)e(T)-7 b(ranIn)n(v)n(erse)26
-b(attribute)h(is)h(zero\).)p 0 5259 V 0 5390 a FA(AST)p
-Fe(_)p FA(DECOMPOSE)1554 5389 y Fd(Decomp)s(ose)38 b(a)1435
-5503 y(Mapping)g(in)m(to)f(t)m(w)m(o)1610 5602 y(comp)s(onen)m(t)1641
-5715 y(Mappings)2575 5390 y FA(AST)p Fe(_)p FA(DECOMPOSE)p
-eop end
-%%Page: 214 224
-TeXDict begin 214 223 bop 0 52 a FG(214)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Description:)44
-b Fj(This)36 b(routine)g(returns)f(p)r(oin)n(ters)g(to)h(t)n(w)n(o)f
-(Mappings)g(whic)n(h,)j(when)e(applied)g(either)g(in)g(series)e(or)227
-451 y(parallel,)27 b(are)f(equiv)-5 b(alen)n(t)28 b(to)f(the)h
-(supplied)g(Mapping.)227 572 y(Since)h(the)g(F)-7 b(rame)28
-b(class)f(inherits)i(from)f(the)h(Mapping)f(class,)g(F)-7
-b(rames)27 b(can)h(b)r(e)h(considered)f(as)f(sp)r(ecial)i(t)n(yp)r(es)
-227 672 y(of)f(Mappings)f(and)g(so)g(this)h(metho)r(d)g(can)f(b)r(e)h
-(used)g(to)f(decomp)r(ose)g(either)h(CmpMaps)f(or)g(CmpF)-7
-b(rames.)0 814 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
-b(AST_DECOMPOSE\()37 b(THIS,)42 b(MAP1,)g(MAP2,)f(SERIES,)g(INVERT1,)f
-(INVERT2,)g(STATUS)h(\))0 957 y Fc(Argumen)m(ts:)259
-1086 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1186
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Mapping.)259 1312
-y Fc(MAP1)k(=)g(INTEGER)f(\(Returned\))427 1412 y Fj(A)d(p)r(oin)n(ter)
-f(to)h(\014rst)f(comp)r(onen)n(t)h(Mapping.)259 1538
-y Fc(MAP2)k(=)g(INTEGER)f(\(Returned\))427 1637 y Fj(A)d(p)r(oin)n(ter)
-f(to)h(second)f(comp)r(onen)n(t)g(Mapping.)259 1763 y
-Fc(SERIES)k(=)h(LOGICAL)h(\(Returned\))427 1863 y Fj(Indicates)24
-b(if)h(the)f(comp)r(onen)n(t)g(Mappings)g(are)f(applied)h(in)h(series)e
-(or)g(parallel.)35 b(A)24 b(.TR)n(UE.)g(v)-5 b(alue)24
-b(means)427 1963 y(that)32 b(the)f(supplied)h(Mapping)f(is)g(equiv)-5
-b(alen)n(t)31 b(to)g(applying)f(MAP1)h(follo)n(w)n(ed)f(b)n(y)h(MAP2)f
-(in)i(series.)46 b(A)427 2062 y(zero)33 b(v)-5 b(alue)35
-b(means)e(that)i(the)f(supplied)h(Mapping)f(is)g(equiv)-5
-b(alen)n(t)34 b(to)g(applying)g(MAP1)f(to)i(the)f(lo)n(w)n(er)427
-2162 y(n)n(um)n(b)r(ered)28 b(axes)e(and)i(MAP2)f(to)g(the)h(higher)f
-(n)n(um)n(b)r(ered)g(axes,)g(in)h(parallel.)259 2288
-y Fc(INVER)-8 b(T1)32 b(=)g(INTEGER)f(\(Returned\))427
-2387 y Fj(The)d(v)-5 b(alue)27 b(of)h(the)g(In)n(v)n(ert)f(attribute)g
-(to)h(b)r(e)g(used)f(with)i(MAP1.)259 2513 y Fc(INVER)-8
-b(T2)32 b(=)g(INTEGER)f(\(Returned\))427 2613 y Fj(The)d(v)-5
-b(alue)27 b(of)h(the)g(In)n(v)n(ert)f(attribute)g(to)h(b)r(e)g(used)f
-(with)i(MAP2.)0 2768 y Fc(Class)i(Applicabilit)m(y:)259
-2898 y(CmpMap)427 2997 y Fj(If)39 b(the)g(supplied)g(Mapping)f(is)g(a)g
-(CmpMap,)j(then)e(MAP1)f(and)h(MAP2)e(will)i(b)r(e)g(returned)f
-(holding)427 3097 y(p)r(oin)n(ters)d(to)g(the)h(comp)r(onen)n(t)f
+b(attribute)h(is)h(zero\).)p 0 4576 V 0 4707 a FA(AST)p
+Fe(_)p FA(DECOMPOSE)1554 4706 y Fd(Decomp)s(ose)38 b(a)1435
+4819 y(Mapping)g(in)m(to)f(t)m(w)m(o)1610 4919 y(comp)s(onen)m(t)1641
+5032 y(Mappings)2575 4707 y FA(AST)p Fe(_)p FA(DECOMPOSE)0
+5220 y Fc(Description:)44 b Fj(This)36 b(routine)g(returns)f(p)r(oin)n
+(ters)g(to)h(t)n(w)n(o)f(Mappings)g(whic)n(h,)j(when)e(applied)g
+(either)g(in)g(series)e(or)227 5320 y(parallel,)27 b(are)f(equiv)-5
+b(alen)n(t)28 b(to)f(the)h(supplied)g(Mapping.)227 5444
+y(Since)h(the)g(F)-7 b(rame)28 b(class)f(inherits)i(from)f(the)h
+(Mapping)f(class,)g(F)-7 b(rames)27 b(can)h(b)r(e)h(considered)f(as)f
+(sp)r(ecial)i(t)n(yp)r(es)227 5544 y(of)f(Mappings)f(and)g(so)g(this)h
+(metho)r(d)g(can)f(b)r(e)h(used)g(to)f(decomp)r(ose)g(either)h(CmpMaps)
+f(or)g(CmpF)-7 b(rames.)0 5693 y Fc(In)m(v)m(o)s(cation:)123
+b Ft(CALL)42 b(AST_DECOMPOSE\()37 b(THIS,)42 b(MAP1,)g(MAP2,)f(SERIES,)
+g(INVERT1,)f(INVERT2,)g(STATUS)h(\))p eop end
+%%Page: 215 225
+TeXDict begin 215 224 bop 3643 52 a FG(215)0 351 y Fc(Argumen)m(ts:)259
+479 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 579 y
+Fj(P)n(oin)n(ter)26 b(to)i(the)g(Mapping.)259 703 y Fc(MAP1)k(=)g
+(INTEGER)f(\(Returned\))427 803 y Fj(A)d(p)r(oin)n(ter)f(to)h(\014rst)f
+(comp)r(onen)n(t)h(Mapping.)259 927 y Fc(MAP2)k(=)g(INTEGER)f
+(\(Returned\))427 1026 y Fj(A)d(p)r(oin)n(ter)f(to)h(second)f(comp)r
+(onen)n(t)g(Mapping.)259 1151 y Fc(SERIES)k(=)h(LOGICAL)h(\(Returned\))
+427 1250 y Fj(Indicates)24 b(if)h(the)f(comp)r(onen)n(t)g(Mappings)g
+(are)f(applied)h(in)h(series)e(or)g(parallel.)35 b(A)24
+b(.TR)n(UE.)g(v)-5 b(alue)24 b(means)427 1350 y(that)32
+b(the)f(supplied)h(Mapping)f(is)g(equiv)-5 b(alen)n(t)31
+b(to)g(applying)f(MAP1)h(follo)n(w)n(ed)f(b)n(y)h(MAP2)f(in)i(series.)
+46 b(A)427 1450 y(zero)33 b(v)-5 b(alue)35 b(means)e(that)i(the)f
+(supplied)h(Mapping)f(is)g(equiv)-5 b(alen)n(t)34 b(to)g(applying)g
+(MAP1)f(to)i(the)f(lo)n(w)n(er)427 1549 y(n)n(um)n(b)r(ered)28
+b(axes)e(and)i(MAP2)f(to)g(the)h(higher)f(n)n(um)n(b)r(ered)g(axes,)g
+(in)h(parallel.)259 1673 y Fc(INVER)-8 b(T1)32 b(=)g(INTEGER)f
+(\(Returned\))427 1773 y Fj(The)d(v)-5 b(alue)27 b(of)h(the)g(In)n(v)n
+(ert)f(attribute)g(to)h(b)r(e)g(used)f(with)i(MAP1.)259
+1897 y Fc(INVER)-8 b(T2)32 b(=)g(INTEGER)f(\(Returned\))427
+1997 y Fj(The)d(v)-5 b(alue)27 b(of)h(the)g(In)n(v)n(ert)f(attribute)g
+(to)h(b)r(e)g(used)f(with)i(MAP2.)0 2150 y Fc(Class)i(Applicabilit)m
+(y:)259 2278 y(CmpMap)427 2378 y Fj(If)39 b(the)g(supplied)g(Mapping)f
+(is)g(a)g(CmpMap,)j(then)e(MAP1)f(and)h(MAP2)e(will)i(b)r(e)g(returned)
+f(holding)427 2477 y(p)r(oin)n(ters)d(to)g(the)h(comp)r(onen)n(t)f
(Mappings)g(used)g(to)g(create)g(the)h(CmpMap,)h(either)e(in)h(series)e
-(or)h(par-)427 3197 y(allel.)62 b(Note,)38 b(c)n(hanging)d(the)i(In)n
+(or)h(par-)427 2577 y(allel.)62 b(Note,)38 b(c)n(hanging)d(the)i(In)n
(v)n(ert)e(attribute)h(of)g(either)g(of)g(the)g(comp)r(onen)n(t)g
-(Mappings)g(using)f(the)427 3296 y(returned)25 b(p)r(oin)n(ters)f(will)
+(Mappings)g(using)f(the)427 2677 y(returned)25 b(p)r(oin)n(ters)f(will)
i(ha)n(v)n(e)d(no)i(e\013ect)h(on)f(the)g(supplied)g(CmpMap.)36
-b(This)25 b(is)g(b)r(ecause)g(the)h(CmpMap)427 3396 y(remem)n(b)r(ers)
+b(This)25 b(is)g(b)r(ecause)g(the)h(CmpMap)427 2776 y(remem)n(b)r(ers)
31 b(and)g(uses)h(the)g(original)e(settings)h(of)h(the)f(In)n(v)n(ert)g
(attributes)h(\(that)g(is,)g(the)g(v)-5 b(alues)32 b(of)f(the)427
-3495 y(In)n(v)n(ert)23 b(attributes)h(when)g(the)g(CmpMap)g(w)n(as)f
+2876 y(In)n(v)n(ert)23 b(attributes)h(when)g(the)g(CmpMap)g(w)n(as)f
(\014rst)g(created\).)35 b(These)24 b(are)e(the)j(In)n(v)n(ert)d(v)-5
-b(alues)24 b(whic)n(h)g(are)427 3595 y(returned)j(in)h(INVER)-7
-b(T1)28 b(and)f(INVER)-7 b(T2.)259 3721 y Fc(T)f(ranMap)427
-3821 y Fj(If)22 b(the)g(supplied)g(Mapping)g(is)f(a)g(T)-7
+b(alues)24 b(whic)n(h)g(are)427 2975 y(returned)j(in)h(INVER)-7
+b(T1)28 b(and)f(INVER)-7 b(T2.)259 3100 y Fc(T)f(ranMap)427
+3199 y Fj(If)22 b(the)g(supplied)g(Mapping)g(is)f(a)g(T)-7
b(ranMap,)22 b(then)h(MAP1)e(and)g(MAP2)g(will)h(b)r(e)g(returned)f
-(holding)h(p)r(oin)n(t-)427 3920 y(ers)27 b(to)h(the)g(forw)n(ard)f
+(holding)h(p)r(oin)n(t-)427 3299 y(ers)27 b(to)h(the)g(forw)n(ard)f
(and)g(in)n(v)n(erse)g(Mappings)g(represen)n(ted)g(b)n(y)g(the)i(T)-7
-b(ranMap)27 b(\(zero)g(will)h(b)r(e)g(returned)427 4020
+b(ranMap)27 b(\(zero)g(will)h(b)r(e)g(returned)427 3399
y(for)d(SERIES\).)g(Note,)i(c)n(hanging)d(the)i(In)n(v)n(ert)e
(attribute)i(of)f(either)h(of)f(the)h(comp)r(onen)n(t)f(Mappings)g
-(using)427 4120 y(the)h(returned)e(p)r(oin)n(ters)h(will)g(ha)n(v)n(e)f
+(using)427 3498 y(the)h(returned)e(p)r(oin)n(ters)h(will)g(ha)n(v)n(e)f
(no)h(e\013ect)g(on)g(the)g(supplied)h(T)-7 b(ranMap.)35
-b(This)25 b(is)g(b)r(ecause)f(the)i(T)-7 b(ran-)427 4219
+b(This)25 b(is)g(b)r(ecause)f(the)i(T)-7 b(ran-)427 3598
y(Map)29 b(remem)n(b)r(ers)e(and)h(uses)g(the)h(original)e(settings)h
(of)h(the)f(In)n(v)n(ert)g(attributes)g(\(that)h(is,)g(the)g(v)-5
-b(alues)28 b(of)427 4319 y(the)c(In)n(v)n(ert)f(attributes)g(when)h
+b(alues)28 b(of)427 3698 y(the)c(In)n(v)n(ert)f(attributes)g(when)h
(the)g(T)-7 b(ranMap)23 b(w)n(as)f(\014rst)i(created\).)35
b(These)23 b(are)g(the)h(In)n(v)n(ert)e(v)-5 b(alues)24
-b(whic)n(h)427 4418 y(are)j(returned)g(in)h(INVER)-7
-b(T1)27 b(and)h(INVER)-7 b(T2.)259 4544 y Fc(Mapping)427
-4644 y Fj(F)g(or)29 b(an)n(y)f(class)g(of)h(Mapping)g(other)g(than)g(a)
+b(whic)n(h)427 3797 y(are)j(returned)g(in)h(INVER)-7
+b(T1)27 b(and)h(INVER)-7 b(T2.)259 3921 y Fc(Mapping)427
+4021 y Fj(F)g(or)29 b(an)n(y)f(class)g(of)h(Mapping)g(other)g(than)g(a)
g(CmpMap,)g(MAP1)g(will)g(b)r(e)h(returned)f(holding)f(a)h(clone)g(of)
-427 4744 y(the)f(supplied)f(Mapping)g(p)r(oin)n(ter,)g(and)g(MAP2)f
+427 4121 y(the)f(supplied)f(Mapping)g(p)r(oin)n(ter,)g(and)g(MAP2)f
(will)i(b)r(e)f(returned)g(holding)g(AST)p Ft(__)p Fj(NULL.)g(INVER)-7
-b(T1)427 4843 y(will)30 b(b)r(e)g(returned)g(holding)f(the)h(curren)n
+b(T1)427 4220 y(will)30 b(b)r(e)g(returned)g(holding)f(the)h(curren)n
(t)f(v)-5 b(alue)29 b(of)h(the)g(In)n(v)n(ert)f(attribute)h(for)f(the)h
-(supplied)g(Mapping,)427 4943 y(and)e(INVER)-7 b(T2)27
-b(will)h(b)r(e)g(returned)f(holding)g(zero.)259 5069
-y Fc(CmpF)-8 b(rame)427 5169 y Fj(If)35 b(the)f(supplied)g(Mapping)g
+(supplied)g(Mapping,)427 4320 y(and)e(INVER)-7 b(T2)27
+b(will)h(b)r(e)g(returned)f(holding)g(zero.)259 4444
+y Fc(CmpF)-8 b(rame)427 4544 y Fj(If)35 b(the)f(supplied)g(Mapping)g
(is)g(a)f(CmpF)-7 b(rame,)36 b(then)e(MAP1)g(and)f(MAP2)h(will)g(b)r(e)
-g(returned)g(holding)427 5268 y(p)r(oin)n(ters)f(to)g(the)h(comp)r
+g(returned)g(holding)427 4643 y(p)r(oin)n(ters)f(to)g(the)h(comp)r
(onen)n(t)f(F)-7 b(rames)32 b(used)i(to)f(create)f(the)i(CmpF)-7
b(rame.)54 b(The)33 b(comp)r(onen)n(t)g(F)-7 b(rames)427
-5368 y(are)27 b(considered)f(to)i(b)r(e)g(in)g(applied)f(in)h
-(parallel.)259 5494 y Fc(F)-8 b(rame)427 5593 y Fj(F)h(or)31
+4743 y(are)27 b(considered)f(to)i(b)r(e)g(in)g(applied)f(in)h
+(parallel.)259 4867 y Fc(F)-8 b(rame)427 4967 y Fj(F)h(or)31
b(an)n(y)f(class)g(of)h(F)-7 b(rame)30 b(other)g(than)i(a)e(CmpF)-7
b(rame,)32 b(MAP1)e(will)h(b)r(e)h(returned)e(holding)h(a)f(clone)h(of)
-427 5693 y(the)d(supplied)g(F)-7 b(rame)27 b(p)r(oin)n(ter,)h(and)f
+427 5067 y(the)d(supplied)g(F)-7 b(rame)27 b(p)r(oin)n(ter,)h(and)f
(MAP2)g(will)h(b)r(e)g(returned)f(holding)g(AST)p Ft(__)p
-Fj(NULL.)p eop end
-%%Page: 215 225
-TeXDict begin 215 224 bop 3643 52 a FG(215)0 351 y Fc(Notes:)340
-630 y Fi(\017)45 b Fj(The)32 b(returned)f(In)n(v)n(ert)g(v)-5
-b(alues)31 b(should)g(b)r(e)h(used)g(in)g(preference)f(to)g(the)h
-(curren)n(t)f(v)-5 b(alues)31 b(of)h(the)g(In)n(v)n(ert)427
-729 y(attribute)g(in)h(map1)e(and)h(map2.)49 b(This)32
-b(is)g(b)r(ecause)g(the)g(attributes)g(ma)n(y)f(ha)n(v)n(e)g(c)n
-(hanged)g(v)-5 b(alue)32 b(since)427 829 y(the)c(Mappings)f(w)n(ere)g
-(com)n(bined.)340 958 y Fi(\017)45 b Fj(An)n(y)28 b(c)n(hanges)f(made)h
-(to)g(the)g(comp)r(onen)n(t)g(Mappings)f(using)h(the)g(returned)g(p)r
-(oin)n(ters)f(will)h(b)r(e)h(re\015ected)427 1058 y(in)f(the)g
-(supplied)g(Mapping.)p 0 1249 3780 12 v 0 1380 a FA(AST)p
-Fe(_)p FA(DELETE)1453 1381 y Fd(Delete)39 b(an)f(Ob)7
-b(ject)2906 1380 y FA(AST)p Fe(_)p FA(DELETE)0 1562 y
-Fc(Description:)44 b Fj(This)28 b(routine)f(deletes)g(an)g(Ob)5
-b(ject,)27 b(freeing)g(all)g(resources)e(asso)r(ciated)h(with)i(it)g
-(and)f(rendering)f(an)n(y)227 1661 y(remaining)h(p)r(oin)n(ters)g(to)g
-(the)h(Ob)5 b(ject)28 b(in)n(v)-5 b(alid.)227 1784 y(Note)35
-b(that)h(deletion)f(is)g(unconditional,)h(regardless)d(of)i(whether)f
-(other)h(p)r(oin)n(ters)f(to)h(the)g(Ob)5 b(ject)35 b(are)f(still)227
-1883 y(in)f(use)e(\(p)r(ossibly)h(within)h(other)f(Ob)5
-b(jects\).)50 b(A)32 b(safer)f(approac)n(h)f(is)i(to)g(defer)g
-(deletion,)i(un)n(til)e(all)g(references)227 1983 y(to)h(an)f(Ob)5
-b(ject)32 b(ha)n(v)n(e)g(expired,)h(b)n(y)f(using)g(AST)p
-Ft(_)p Fj(BEGIN/AST)p Ft(_)p Fj(END)g(\(together)g(with)h(AST)p
-Ft(_)p Fj(CLONE)f(and)227 2083 y(AST)p Ft(_)p Fj(ANNUL)d(if)f
-(necessary\).)0 2228 y Fc(In)m(v)m(o)s(cation:)123 b
-Ft(CALL)42 b(AST_DELETE\()d(THIS,)i(STATUS)g(\))0 2374
-y Fc(Argumen)m(ts:)259 2506 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en)g(and)
-g(Returned\))427 2606 y Fj(P)n(oin)n(ter)26 b(to)h(the)h(Ob)5
-b(ject)27 b(to)g(b)r(e)h(deleted.)37 b(A)28 b(n)n(ull)f(p)r(oin)n(ter)g
-(v)-5 b(alue)28 b(\(AST)p Ft(__)p Fj(NULL\))f(is)h(alw)n(a)n(ys)d
-(returned.)259 2735 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)
-h(and)g(Returned\))427 2834 y Fj(The)c(global)e(status.)0
-2992 y Fc(Class)31 b(Applicabilit)m(y:)259 3125 y(Ob)5
-b(ject)427 3224 y Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5
-b(jects.)0 3382 y Fc(Notes:)340 3661 y Fi(\017)45 b Fj(This)28
+Fj(NULL.)0 5220 y Fc(Notes:)340 5494 y Fi(\017)45 b Fj(The)32
+b(returned)f(In)n(v)n(ert)g(v)-5 b(alues)31 b(should)g(b)r(e)h(used)g
+(in)g(preference)f(to)g(the)h(curren)n(t)f(v)-5 b(alues)31
+b(of)h(the)g(In)n(v)n(ert)427 5593 y(attribute)g(in)h(map1)e(and)h
+(map2.)49 b(This)32 b(is)g(b)r(ecause)g(the)g(attributes)g(ma)n(y)f(ha)
+n(v)n(e)g(c)n(hanged)g(v)-5 b(alue)32 b(since)427 5693
+y(the)c(Mappings)f(w)n(ere)g(com)n(bined.)p eop end
+%%Page: 216 226
+TeXDict begin 216 225 bop 0 52 a FG(216)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(An)n(y)28 b(c)n(hanges)f(made)h(to)g(the)g(comp)r(onen)n(t)g
+(Mappings)f(using)h(the)g(returned)g(p)r(oin)n(ters)f(will)h(b)r(e)h
+(re\015ected)427 451 y(in)f(the)g(supplied)g(Mapping.)p
+0 639 3780 12 v 0 769 a FA(AST)p Fe(_)p FA(DELETE)1453
+770 y Fd(Delete)39 b(an)f(Ob)7 b(ject)2906 769 y FA(AST)p
+Fe(_)p FA(DELETE)0 948 y Fc(Description:)44 b Fj(This)28
+b(routine)f(deletes)g(an)g(Ob)5 b(ject,)27 b(freeing)g(all)g(resources)
+e(asso)r(ciated)h(with)i(it)g(and)f(rendering)f(an)n(y)227
+1047 y(remaining)h(p)r(oin)n(ters)g(to)g(the)h(Ob)5 b(ject)28
+b(in)n(v)-5 b(alid.)227 1169 y(Note)35 b(that)h(deletion)f(is)g
+(unconditional,)h(regardless)d(of)i(whether)f(other)h(p)r(oin)n(ters)f
+(to)h(the)g(Ob)5 b(ject)35 b(are)f(still)227 1269 y(in)f(use)e(\(p)r
+(ossibly)h(within)h(other)f(Ob)5 b(jects\).)50 b(A)32
+b(safer)f(approac)n(h)f(is)i(to)g(defer)g(deletion,)i(un)n(til)e(all)g
+(references)227 1368 y(to)h(an)f(Ob)5 b(ject)32 b(ha)n(v)n(e)g
+(expired,)h(b)n(y)f(using)g(AST)p Ft(_)p Fj(BEGIN/AST)p
+Ft(_)p Fj(END)g(\(together)g(with)h(AST)p Ft(_)p Fj(CLONE)f(and)227
+1468 y(AST)p Ft(_)p Fj(ANNUL)d(if)f(necessary\).)0 1611
+y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_DELETE\()d(THIS,)i
+(STATUS)g(\))0 1755 y Fc(Argumen)m(ts:)259 1886 y(THIS)32
+b(=)g(INTEGER)g(\(Giv)m(en)g(and)g(Returned\))427 1985
+y Fj(P)n(oin)n(ter)26 b(to)h(the)h(Ob)5 b(ject)27 b(to)g(b)r(e)h
+(deleted.)37 b(A)28 b(n)n(ull)f(p)r(oin)n(ter)g(v)-5
+b(alue)28 b(\(AST)p Ft(__)p Fj(NULL\))f(is)h(alw)n(a)n(ys)d(returned.)
+259 2112 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 2212 y Fj(The)c(global)e(status.)0 2368
+y Fc(Class)31 b(Applicabilit)m(y:)259 2499 y(Ob)5 b(ject)427
+2599 y Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5
+b(jects.)0 2755 y Fc(Notes:)340 3031 y Fi(\017)45 b Fj(This)28
b(routine)f(attempts)g(to)h(execute)f(ev)n(en)g(if)g(ST)-7
b(A)g(TUS)29 b(is)e(set)g(to)h(an)f(error)e(v)-5 b(alue)27
-b(on)g(en)n(try)-7 b(,)27 b(although)427 3761 y(no)h(further)f(error)f
+b(on)g(en)n(try)-7 b(,)27 b(although)427 3131 y(no)h(further)f(error)f
(rep)r(ort)h(will)g(b)r(e)h(made)g(if)g(it)g(subsequen)n(tly)f(fails)g
-(under)h(these)g(circumstances.)p 0 3952 V 0 4083 a FA(AST)p
-Fe(_)p FA(DELFITS)1072 4084 y Fd(Delete)39 b(the)f(curren)m(t)g(FITS)h
-(card)f(in)1604 4183 y(a)h(FitsChan)2873 4083 y FA(AST)p
-Fe(_)p FA(DELFITS)0 4341 y Fc(Description:)44 b Fj(This)33
+(under)h(these)g(circumstances.)p 0 3319 V 0 3449 a FA(AST)p
+Fe(_)p FA(DELFITS)1072 3450 y Fd(Delete)39 b(the)f(curren)m(t)g(FITS)h
+(card)f(in)1604 3550 y(a)h(FitsChan)2873 3449 y FA(AST)p
+Fe(_)p FA(DELFITS)0 3704 y Fc(Description:)44 b Fj(This)33
b(routine)e(deletes)i(the)f(curren)n(t)f(FITS)i(card)e(from)h(a)g
(FitsChan.)51 b(The)32 b(curren)n(t)f(card)h(ma)n(y)f(b)r(e)227
-4441 y(selected)e(using)f(the)h(Card)f(attribute)h(\(if)h(its)e(index)h
+3804 y(selected)e(using)f(the)h(Card)f(attribute)h(\(if)h(its)e(index)h
(is)g(kno)n(wn\))f(or)g(b)n(y)g(using)h(AST)p Ft(_)p
-Fj(FINDFITS)g(\(if)h(only)e(the)227 4540 y(FITS)g(k)n(eyw)n(ord)e(is)h
-(kno)n(wn\).)227 4663 y(After)h(deletion,)g(the)g(follo)n(wing)f(card)f
-(b)r(ecomes)h(the)h(curren)n(t)f(card.)0 4808 y Fc(In)m(v)m(o)s
+Fj(FINDFITS)g(\(if)h(only)e(the)227 3903 y(FITS)g(k)n(eyw)n(ord)e(is)h
+(kno)n(wn\).)227 4025 y(After)h(deletion,)g(the)g(follo)n(wing)f(card)f
+(b)r(ecomes)h(the)h(curren)n(t)f(card.)0 4169 y Fc(In)m(v)m(o)s
(cation:)123 b Ft(CALL)42 b(AST_DELFITS\()c(THIS,)k(STATUS)f(\))0
-4954 y Fc(Argumen)m(ts:)259 5086 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 5186 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
-5315 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 5414 y Fj(The)c(global)e(status.)0 5572
-y Fc(Notes:)p eop end
-%%Page: 216 226
-TeXDict begin 216 225 bop 0 52 a FG(216)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
-b Fj(This)23 b(function)f(returns)g(without)h(action)e(if)i(the)g
-(FitsChan)f(is)h(initially)f(p)r(ositioned)g(at)g(the)h
-Ft(")p Fj(end-of-\014le)p Ft(")427 451 y Fj(\(i.e.)38
-b(if)28 b(the)g(Card)e(attribute)i(exceeds)f(the)h(n)n(um)n(b)r(er)f
-(of)h(cards)e(in)i(the)g(FitsChan\).)340 583 y Fi(\017)45
-b Fj(If)36 b(there)f(are)f(no)h(subsequen)n(t)f(cards)g(in)i(the)f
-(FitsChan,)i(then)f(the)f(Card)g(attribute)g(is)g(left)h(p)r(oin)n
-(ting)427 682 y(at)e(the)g Ft(")p Fj(end-of-\014le)p
+4312 y Fc(Argumen)m(ts:)259 4443 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 4543 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
+4670 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 4769 y Fj(The)c(global)e(status.)0 4925
+y Fc(Notes:)340 5202 y Fi(\017)45 b Fj(This)23 b(function)f(returns)g
+(without)h(action)e(if)i(the)g(FitsChan)f(is)h(initially)f(p)r
+(ositioned)g(at)g(the)h Ft(")p Fj(end-of-\014le)p Ft(")427
+5302 y Fj(\(i.e.)38 b(if)28 b(the)g(Card)e(attribute)i(exceeds)f(the)h
+(n)n(um)n(b)r(er)f(of)h(cards)e(in)i(the)g(FitsChan\).)340
+5429 y Fi(\017)45 b Fj(If)36 b(there)f(are)f(no)h(subsequen)n(t)f
+(cards)g(in)i(the)f(FitsChan,)i(then)f(the)f(Card)g(attribute)g(is)g
+(left)h(p)r(oin)n(ting)427 5529 y(at)e(the)g Ft(")p Fj(end-of-\014le)p
Ft(")e Fj(after)h(deletion)h(\(i.e.)55 b(is)33 b(set)h(to)f(one)g(more)
g(than)g(the)h(n)n(um)n(b)r(er)g(of)f(cards)f(in)i(the)427
-782 y(FitsChan\).)p 0 980 3780 12 v 0 1110 a FA(AST)p
-Fe(_)p FA(DIST)-11 b(ANCE)1320 1111 y Fd(Calculate)37
-b(the)h(distance)1280 1211 y(b)s(et)m(w)m(een)g(t)m(w)m(o)f(p)s(oin)m
-(ts)h(in)g(a)1730 1324 y(F)-10 b(rame)2746 1110 y FA(AST)p
-Fe(_)p FA(DIST)f(ANCE)0 1488 y Fc(Description:)44 b Fj(This)30
-b(function)h(\014nds)f(the)g(distance)g(b)r(et)n(w)n(een)g(t)n(w)n(o)f
-(p)r(oin)n(ts)h(whose)f(F)-7 b(rame)30 b(co)r(ordinates)e(are)h(giv)n
-(en.)227 1587 y(The)f(distance)f(calculated)g(is)h(that)g(along)e(the)i
-(geo)r(desic)f(curv)n(e)f(that)i(joins)g(the)g(t)n(w)n(o)e(p)r(oin)n
-(ts.)227 1712 y(F)-7 b(or)34 b(example,)h(in)f(a)f(basic)h(F)-7
-b(rame,)35 b(the)f(distance)f(calculated)h(will)g(b)r(e)g(the)g
-(Cartesian)f(distance)h(along)e(the)227 1811 y(straigh)n(t)k(line)h
+5628 y(FitsChan\).)p eop end
+%%Page: 217 227
+TeXDict begin 217 226 bop 3643 52 a FG(217)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(DIST)-11 b(ANCE)1320
+483 y Fd(Calculate)37 b(the)h(distance)1280 583 y(b)s(et)m(w)m(een)g(t)
+m(w)m(o)f(p)s(oin)m(ts)h(in)g(a)1730 696 y(F)-10 b(rame)2746
+482 y FA(AST)p Fe(_)p FA(DIST)f(ANCE)0 854 y Fc(Description:)44
+b Fj(This)30 b(function)h(\014nds)f(the)g(distance)g(b)r(et)n(w)n(een)g
+(t)n(w)n(o)f(p)r(oin)n(ts)h(whose)f(F)-7 b(rame)30 b(co)r(ordinates)e
+(are)h(giv)n(en.)227 953 y(The)f(distance)f(calculated)g(is)h(that)g
+(along)e(the)i(geo)r(desic)f(curv)n(e)f(that)i(joins)g(the)g(t)n(w)n(o)
+e(p)r(oin)n(ts.)227 1076 y(F)-7 b(or)34 b(example,)h(in)f(a)f(basic)h
+(F)-7 b(rame,)35 b(the)f(distance)f(calculated)h(will)g(b)r(e)g(the)g
+(Cartesian)f(distance)h(along)e(the)227 1176 y(straigh)n(t)k(line)h
(joining)g(the)h(t)n(w)n(o)e(p)r(oin)n(ts.)65 b(F)-7
b(or)37 b(a)f(more)g(sp)r(ecialised)h(F)-7 b(rame)36
-b(describing)h(a)f(sky)h(co)r(ordinate)227 1911 y(system,)25
+b(describing)h(a)f(sky)h(co)r(ordinate)227 1275 y(system,)25
b(ho)n(w)n(ev)n(er,)f(it)h(w)n(ould)f(b)r(e)i(the)f(distance)f(along)g
(the)h(great)f(circle)g(passing)g(through)g(t)n(w)n(o)g(sky)g(p)r
-(ositions.)0 2059 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
+(ositions.)0 1421 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
b(=)i(AST_DISTANCE\()38 b(THIS,)k(POINT1,)e(POINT2,)h(STATUS)g(\))0
-2208 y Fc(Argumen)m(ts:)259 2343 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 2443 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
-b(rame.)259 2575 y Fc(POINT1\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h
-(PRECISION)e(\(Giv)m(en\))427 2675 y Fj(An)d(arra)n(y)c(with)k(one)f
+1566 y Fc(Argumen)m(ts:)259 1699 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 1799 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rame.)259 1928 y Fc(POINT1\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h
+(PRECISION)e(\(Giv)m(en\))427 2027 y Fj(An)d(arra)n(y)c(with)k(one)f
(elemen)n(t)g(for)f(eac)n(h)h(F)-7 b(rame)26 b(axis)g(\(Naxes)h
(attribute\))h(con)n(taining)e(the)h(co)r(ordinates)427
-2774 y(of)h(the)g(\014rst)f(p)r(oin)n(t.)259 2906 y Fc(POINT2\()32
+2127 y(of)h(the)g(\014rst)f(p)r(oin)n(t.)259 2256 y Fc(POINT2\()32
b Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m(en\))427
-3006 y Fj(An)22 b(arra)n(y)d(with)j(one)f(elemen)n(t)h(for)f(eac)n(h)f
+2355 y Fj(An)22 b(arra)n(y)d(with)j(one)f(elemen)n(t)h(for)f(eac)n(h)f
(F)-7 b(rame)21 b(axis)g(con)n(taining)f(the)i(co)r(ordinates)e(of)i
-(the)g(second)e(p)r(oin)n(t.)259 3138 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 3237
-y Fj(The)c(global)e(status.)0 3398 y Fc(Returned)32 b(V)-8
-b(alue:)259 3534 y(AST)p Ft(_)p Fc(DIST)g(ANCE)33 b(=)f(DOUBLE)g
-(PRECISION)427 3633 y Fj(The)c(distance)f(b)r(et)n(w)n(een)h(the)g(t)n
-(w)n(o)f(p)r(oin)n(ts.)0 3794 y Fc(Notes:)340 4076 y
+(the)g(second)e(p)r(oin)n(t.)259 2484 y Fc(ST)-8 b(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 2584
+y Fj(The)c(global)e(status.)0 2742 y Fc(Returned)32 b(V)-8
+b(alue:)259 2875 y(AST)p Ft(_)p Fc(DIST)g(ANCE)33 b(=)f(DOUBLE)g
+(PRECISION)427 2974 y Fj(The)c(distance)f(b)r(et)n(w)n(een)h(the)g(t)n
+(w)n(o)f(p)r(oin)n(ts.)0 3132 y Fc(Notes:)340 3411 y
Fi(\017)45 b Fj(This)30 b(function)g(will)f(return)g(a)g
Ft(")p Fj(bad)p Ft(")g Fj(result)g(v)-5 b(alue)29 b(\(AST)p
Ft(__)p Fj(BAD\))h(if)g(an)n(y)f(of)g(the)h(input)g(co)r(ordinates)427
-4176 y(has)d(this)h(v)-5 b(alue.)340 4308 y Fi(\017)45
+3511 y(has)d(this)h(v)-5 b(alue.)340 3640 y Fi(\017)45
b Fj(A)29 b Ft(")p Fj(bad)p Ft(")f Fj(v)-5 b(alue)28
b(will)h(also)e(b)r(e)i(returned)f(if)h(this)g(function)g(is)f(in)n(v)n
(ok)n(ed)f(with)i(ST)-7 b(A)g(TUS)30 b(set)e(to)g(an)h(error)427
-4407 y(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)p 0 4605 V 0 4735 a FA(AST)p Fe(_)p FA(DO)l(WNSIZE)1323
-4736 y Fd(Reduce)39 b(the)g(n)m(um)m(b)s(er)f(of)1355
-4836 y(v)m(ertices)g(in)g(a)h(P)m(olygon)2708 4735 y
-FA(AST)p Fe(_)p FA(DO)l(WNSIZE)0 5023 y Fc(Description:)44
+3739 y(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
+(reason.)p 0 3931 V 0 4061 a FA(AST)p Fe(_)p FA(DO)l(WNSIZE)1323
+4062 y Fd(Reduce)39 b(the)g(n)m(um)m(b)s(er)f(of)1355
+4162 y(v)m(ertices)g(in)g(a)h(P)m(olygon)2708 4061 y
+FA(AST)p Fe(_)p FA(DO)l(WNSIZE)0 4343 y Fc(Description:)44
b Fj(This)26 b(function)h(returns)e(a)g(p)r(oin)n(ter)h(to)g(a)f(new)h
(P)n(olygon)e(that)i(con)n(tains)f(a)g(subset)h(of)g(the)h(v)n(ertices)
-d(in)227 5123 y(the)k(supplied)f(P)n(olygon.)35 b(The)27
+d(in)227 4443 y(the)k(supplied)f(P)n(olygon.)35 b(The)27
b(subset)g(is)g(c)n(hosen)f(so)g(that)i(the)f(returned)g(P)n(olygon)e
-(is)h(a)h(go)r(o)r(d)f(appro)n(ximation)227 5222 y(to)g(the)h(supplied)
+(is)h(a)h(go)r(o)r(d)f(appro)n(ximation)227 4543 y(to)g(the)h(supplied)
f(P)n(olygon,)e(within)j(the)f(limits)h(sp)r(eci\014ed)f(b)n(y)g(the)g
(supplied)g(parameter)f(v)-5 b(alues.)36 b(That)26 b(is,)g(the)227
-5322 y(densit)n(y)g(of)g(p)r(oin)n(ts)f(in)h(the)g(returned)g(P)n
+4642 y(densit)n(y)g(of)g(p)r(oin)n(ts)f(in)h(the)g(returned)g(P)n
(olygon)d(is)j(greater)e(at)i(p)r(oin)n(ts)f(where)g(the)i(curv)-5
-b(ature)25 b(of)g(the)h(b)r(oundary)227 5421 y(of)i(the)g(supplied)g(P)
-n(olygon)d(is)j(greater.)0 5570 y Fc(In)m(v)m(o)s(cation:)123
+b(ature)25 b(of)g(the)h(b)r(oundary)227 4742 y(of)i(the)g(supplied)g(P)
+n(olygon)d(is)j(greater.)0 4887 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_DOWNSIZE\()38 b(THIS,)k(MAXERR,)e(MAXVERT,)h
-(STATUS)g(\))0 5718 y Fc(Argumen)m(ts:)p eop end
-%%Page: 217 227
-TeXDict begin 217 226 bop 3643 52 a FG(217)259 351 y
-Fc(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(P)n(olygon.)259 580 y Fc(MAXERR)j(=)h(DOUBLE)g(PRECISION)f
-(\(Giv)m(en\))427 679 y Fj(The)22 b(maxim)n(um)g(allo)n(w)n(ed)e
+(STATUS)g(\))0 5033 y Fc(Argumen)m(ts:)259 5166 y(THIS)32
+b(=)g(INTEGER)g(\(Giv)m(en\))427 5265 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(P)n(olygon.)259 5394 y Fc(MAXERR)j(=)h(DOUBLE)g(PRECISION)
+f(\(Giv)m(en\))427 5494 y Fj(The)22 b(maxim)n(um)g(allo)n(w)n(ed)e
(discrepancy)g(b)r(et)n(w)n(een)i(the)g(supplied)g(and)g(returned)f(P)n
-(olygons,)g(expressed)f(as)427 779 y(a)k(geo)r(desic)f(distance)h
+(olygons,)g(expressed)f(as)427 5593 y(a)k(geo)r(desic)f(distance)h
(within)g(the)h(P)n(olygon's)c(co)r(ordinate)i(frame.)36
b(If)24 b(this)g(is)g(zero)f(or)g(less,)i(the)f(returned)427
-879 y(P)n(olygon)i(will)h(ha)n(v)n(e)g(the)h(n)n(um)n(b)r(er)f(of)h(v)n
-(ertices)e(sp)r(eci\014ed)i(b)n(y)f(MAXVER)-7 b(T.)259
-1008 y Fc(MAXVER)f(T)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
-1107 y Fj(The)36 b(maxim)n(um)f(allo)n(w)n(ed)f(n)n(um)n(b)r(er)h(of)h
-(v)n(ertices)e(in)i(the)f(returned)g(P)n(olygon.)59 b(If)35
-b(this)h(is)f(less)g(than)h(3,)427 1207 y(the)c(n)n(um)n(b)r(er)e(of)h
-(v)n(ertices)f(in)h(the)g(returned)g(P)n(olygon)d(will)k(b)r(e)f(the)g
-(minim)n(um)h(needed)f(to)g(ac)n(hiev)n(e)e(the)427 1306
-y(maxim)n(um)f(discrepancy)e(sp)r(eci\014ed)i(b)n(y)f(MAXERR.)259
-1435 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 1535 y Fj(The)c(global)e(status.)0 1693
-y Fc(Returned)32 b(V)-8 b(alue:)259 1825 y(AST)p Ft(_)p
-Fc(DO)m(WNSIZE)32 b(=)g(INTEGER)427 1925 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(new)f(P)n(olygon.)0 2083 y Fc(Notes:)340
-2361 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20
-b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e
-(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 2461 y(set)28 b(to)f(an)h(error)d(v)-5
+5693 y(P)n(olygon)i(will)h(ha)n(v)n(e)g(the)h(n)n(um)n(b)r(er)f(of)h(v)
+n(ertices)e(sp)r(eci\014ed)i(b)n(y)f(MAXVER)-7 b(T.)p
+eop end
+%%Page: 218 228
+TeXDict begin 218 227 bop 0 52 a FG(218)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(MAXVER)-8
+b(T)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 451 y Fj(The)36
+b(maxim)n(um)f(allo)n(w)n(ed)f(n)n(um)n(b)r(er)h(of)h(v)n(ertices)e(in)
+i(the)f(returned)g(P)n(olygon.)59 b(If)35 b(this)h(is)f(less)g(than)h
+(3,)427 551 y(the)c(n)n(um)n(b)r(er)e(of)h(v)n(ertices)f(in)h(the)g
+(returned)g(P)n(olygon)d(will)k(b)r(e)f(the)g(minim)n(um)h(needed)f(to)
+g(ac)n(hiev)n(e)e(the)427 650 y(maxim)n(um)f(discrepancy)e(sp)r
+(eci\014ed)i(b)n(y)f(MAXERR.)259 779 y Fc(ST)-8 b(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 879
+y Fj(The)c(global)e(status.)0 1037 y Fc(Returned)32 b(V)-8
+b(alue:)259 1170 y(AST)p Ft(_)p Fc(DO)m(WNSIZE)32 b(=)g(INTEGER)427
+1269 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(new)f(P)n(olygon.)0
+1427 y Fc(Notes:)340 1706 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
+(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
+b(A)g(TUS)427 1806 y(set)28 b(to)f(an)h(error)d(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-0 2652 3780 12 v 0 2783 a FA(AST)p Fe(_)p FA(DSBSPECFRAME)210
-b Fd(Create)37 b(a)1752 2882 y(DSB-)1611 2982 y(Sp)s(ecF)-10
-b(rame)2320 2783 y FA(AST)p Fe(_)p FA(DSBSPECFRAME)0
-3163 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+0 1998 3780 12 v 0 2128 a FA(AST)p Fe(_)p FA(DSBSPECFRAME)210
+b Fd(Create)37 b(a)1752 2228 y(DSB-)1611 2327 y(Sp)s(ecF)-10
+b(rame)2320 2128 y FA(AST)p Fe(_)p FA(DSBSPECFRAME)0
+2509 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
(DSBSp)r(ecF)-7 b(rame)28 b(and)g(optionally)e(initialises)i(its)f
-(attributes.)227 3285 y(A)37 b(DSBSp)r(ecF)-7 b(rame)37
+(attributes.)227 2631 y(A)37 b(DSBSp)r(ecF)-7 b(rame)37
b(is)f(a)g(sp)r(ecialised)g(form)g(of)h(Sp)r(ecF)-7 b(rame)36
b(whic)n(h)h(represen)n(ts)e(p)r(ositions)h(in)g(a)g(sp)r(ectrum)227
-3385 y(obtained)f(using)g(a)f(dual)h(sideband)g(instrumen)n(t.)60
+2731 y(obtained)f(using)g(a)f(dual)h(sideband)g(instrumen)n(t.)60
b(Suc)n(h)35 b(an)g(instrumen)n(t)g(pro)r(duces)f(a)h(sp)r(ectrum)g(in)
-h(whic)n(h)227 3485 y(eac)n(h)f(p)r(oin)n(t)h(con)n(tains)e(con)n
+h(whic)n(h)227 2831 y(eac)n(h)f(p)r(oin)n(t)h(con)n(tains)e(con)n
(tributions)h(from)g(t)n(w)n(o)g(distinctly)h(di\013eren)n(t)f
(frequencies,)i(one)f(from)f(the)h Ft(")p Fj(lo)n(w)n(er)227
-3584 y(side)41 b(band)p Ft(")f Fj(\(LSB\))h(and)f(one)g(from)h(the)g
+2930 y(side)41 b(band)p Ft(")f Fj(\(LSB\))h(and)f(one)g(from)h(the)g
Ft(")p Fj(upp)r(er)f(side)g(band)p Ft(")g Fj(\(USB\).)i(Corresp)r
-(onding)d(LSB)h(and)g(USB)227 3684 y(frequencies)d(are)f(connected)h(b)
+(onding)d(LSB)h(and)g(USB)227 3030 y(frequencies)d(are)f(connected)h(b)
n(y)g(the)g(fact)h(that)f(they)g(are)g(an)f(equal)h(distance)g(on)g
-(either)g(side)g(of)g(a)g(\014xed)227 3784 y(cen)n(tral)27
+(either)g(side)g(of)g(a)g(\014xed)227 3129 y(cen)n(tral)27
b(frequency)g(kno)n(wn)g(as)g(the)h Ft(")p Fj(Lo)r(cal)e(Oscillator)p
-Ft(")g Fj(\(LO\))i(frequency)-7 b(.)227 3906 y(When)33
+Ft(")g Fj(\(LO\))i(frequency)-7 b(.)227 3252 y(When)33
b(quoting)e(a)g(p)r(osition)h(within)g(suc)n(h)g(a)f(sp)r(ectrum,)i(it)
g(is)e(necessary)f(to)i(indicate)g(whether)g(the)g(quoted)227
-4006 y(p)r(osition)27 b(is)g(the)g(USB)g(p)r(osition)g(or)f(the)i
+3352 y(p)r(osition)27 b(is)g(the)g(USB)g(p)r(osition)g(or)f(the)i
(corresp)r(onding)d(LSB)i(p)r(osition.)36 b(The)27 b(SideBand)g
-(attribute)g(pro)n(vides)227 4105 y(this)36 b(indication.)60
+(attribute)g(pro)n(vides)227 3451 y(this)36 b(indication.)60
b(Another)35 b(option)g(that)h(the)f(SideBand)g(attribute)h(pro)n
(vides)e(is)h(to)g(represen)n(t)f(a)h(sp)r(ectral)227
-4205 y(p)r(osition)28 b(b)n(y)f(its)h(top)r(o)r(cen)n(tric)f(o\013set)g
-(from)h(the)g(LO)f(frequency)-7 b(.)227 4328 y(In)32
+3551 y(p)r(osition)28 b(b)n(y)f(its)h(top)r(o)r(cen)n(tric)f(o\013set)g
+(from)h(the)g(LO)f(frequency)-7 b(.)227 3674 y(In)32
b(practice,)f(the)h(LO)f(frequency)g(is)g(sp)r(eci\014ed)g(b)n(y)g
(giving)g(the)h(distance)f(from)g(the)g(LO)g(frequency)g(to)g(some)227
-4427 y Ft(")p Fj(cen)n(tral)p Ft(")37 b Fj(sp)r(ectral)h(p)r(osition.)
+3773 y Ft(")p Fj(cen)n(tral)p Ft(")37 b Fj(sp)r(ectral)h(p)r(osition.)
69 b(T)n(ypically)37 b(this)i(cen)n(tral)e(p)r(osition)h(is)h(that)f
-(of)h(some)f(in)n(teresting)f(sp)r(ectral)227 4527 y(feature.)f(The)23
+(of)h(some)f(in)n(teresting)f(sp)r(ectral)227 3873 y(feature.)f(The)23
b(distance)h(from)f(this)h(cen)n(tral)f(p)r(osition)g(to)h(the)g(LO)f
(frequency)g(is)g(kno)n(wn)g(as)g(the)h Ft(")p Fj(in)n(termediate)227
-4626 y(frequency)p Ft(")k Fj(\(IF\).)h(The)g(v)-5 b(alue)28
+3972 y(frequency)p Ft(")k Fj(\(IF\).)h(The)g(v)-5 b(alue)28
b(supplied)h(for)f(IF)h(can)f(b)r(e)h(a)f(signed)g(v)-5
b(alue)28 b(in)h(order)e(to)h(indicate)h(whether)f(the)227
-4726 y(LO)f(frequency)h(is)f(ab)r(o)n(v)n(e)f(or)h(b)r(elo)n(w)g(the)h
-(cen)n(tral)f(p)r(osition.)0 4872 y Fc(In)m(v)m(o)s(cation:)123
+4072 y(LO)f(frequency)h(is)f(ab)r(o)n(v)n(e)f(or)h(b)r(elo)n(w)g(the)h
+(cen)n(tral)f(p)r(osition.)0 4218 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_DSBSPECFRAME)o(\()38 b(OPTIONS,)i(STATUS)h(\))
-0 5017 y Fc(Argumen)m(ts:)259 5149 y(OPTIONS)32 b(=)g(CHARA)m(CTER)g
+0 4364 y Fc(Argumen)m(ts:)259 4496 y(OPTIONS)32 b(=)g(CHARA)m(CTER)g
Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-5249 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h(optional)g
+4596 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h(optional)g
(comma-separated)e(list)j(of)g(attribute)f(assignmen)n(ts)g(to)427
-5349 y(b)r(e)e(used)f(for)g(initialising)g(the)h(new)f(DSBSp)r(ecF)-7
+4695 y(b)r(e)e(used)f(for)g(initialising)g(the)h(new)f(DSBSp)r(ecF)-7
b(rame.)39 b(The)28 b(syn)n(tax)f(used)i(is)f(iden)n(tical)g(to)g(that)
-g(for)g(the)427 5448 y(AST)p Ft(_)p Fj(SET)f(routine.)259
-5577 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 5677 y Fj(The)c(global)e(status.)p eop
-end
-%%Page: 218 228
-TeXDict begin 218 227 bop 0 52 a FG(218)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Returned)h(V)-8
-b(alue:)259 500 y(AST)p Ft(_)p Fc(DSBSPECFRAME)32 b(=)g(INTEGER)427
-600 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(DSBSp)r(ecF)-7
-b(rame.)0 774 y Fc(Notes:)340 1069 y Fi(\017)45 b Fj(A)21
-b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
-Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 1169
-y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 1381 3780 12 v 0 1511
-a FA(AST)p Fe(_)p FA(EBUF)982 1512 y Fd(End)38 b(the)h(curren)m(t)f
-(graphical)e(bu\013ering)1701 1612 y(con)m(text)3076
-1511 y FA(AST)p Fe(_)p FA(EBUF)0 1790 y Fc(Description:)44
-b Fj(This)23 b(routine)g(ends)f(the)i(curren)n(t)e(graphics)f
-(bu\013ering)i(con)n(text.)35 b(It)23 b(should)f(matc)n(h)h(a)g
-(corresp)r(onding)227 1890 y(call)k(to)h(the)g(AST)p
-Ft(_)p Fj(EBUF)f(routine.)0 2052 y Fc(In)m(v)m(o)s(cation:)123
-b Ft(CALL)42 b(AST_EBUF\()e(THIS)h(STATUS)h(\))0 2214
-y Fc(Argumen)m(ts:)259 2363 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
-2462 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259 2601
+g(for)g(the)427 4795 y(AST)p Ft(_)p Fj(SET)f(routine.)259
+4924 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 5024 y Fj(The)c(global)e(status.)0 5182
+y Fc(Returned)32 b(V)-8 b(alue:)259 5315 y(AST)p Ft(_)p
+Fc(DSBSPECFRAME)32 b(=)g(INTEGER)427 5414 y Fj(A)c(p)r(oin)n(ter)f(to)h
+(the)g(new)g(DSBSp)r(ecF)-7 b(rame.)0 5572 y Fc(Notes:)p
+eop end
+%%Page: 219 229
+TeXDict begin 219 228 bop 3643 52 a FG(219)340 351 y
+Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f
+(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f
+(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427
+451 y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g
+(should)f(fail)h(for)f(an)n(y)g(reason.)p 0 675 3780
+12 v 0 806 a FA(AST)p Fe(_)p FA(EBUF)982 807 y Fd(End)38
+b(the)h(curren)m(t)f(graphical)e(bu\013ering)1701 906
+y(con)m(text)3076 806 y FA(AST)p Fe(_)p FA(EBUF)0 1097
+y Fc(Description:)44 b Fj(This)23 b(routine)g(ends)f(the)i(curren)n(t)e
+(graphics)f(bu\013ering)i(con)n(text.)35 b(It)23 b(should)f(matc)n(h)h
+(a)g(corresp)r(onding)227 1197 y(call)k(to)h(the)g(AST)p
+Ft(_)p Fj(EBUF)f(routine.)0 1371 y Fc(In)m(v)m(o)s(cation:)123
+b Ft(CALL)42 b(AST_EBUF\()e(THIS)h(STATUS)h(\))0 1545
+y Fc(Argumen)m(ts:)259 1707 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
+1806 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259 1952
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 2701 y Fj(The)c(global)e(status.)0 2875 y Fc(Notes:)340
-3170 y Fi(\017)45 b Fj(The)30 b(nature)g(of)g(the)g(bu\013ering)g(is)f
+427 2051 y Fj(The)c(global)e(status.)0 2238 y Fc(Notes:)340
+2546 y Fi(\017)45 b Fj(The)30 b(nature)g(of)g(the)g(bu\013ering)g(is)f
(determined)i(b)n(y)e(the)i(underlying)e(graphics)f(system)i(\(as)g
-(de\014ned)g(b)n(y)427 3270 y(the)h(curren)n(t)f(grf)g(mo)r(dule\).)47
+(de\014ned)g(b)n(y)427 2645 y(the)h(curren)n(t)f(grf)g(mo)r(dule\).)47
b(Eac)n(h)30 b(call)g(to)h(this)g(routine)f(simply)h(in)n(v)n(ok)n(es)e
-(the)i(astGEBuf)f(function)h(in)427 3370 y(the)d(grf)f(mo)r(dule.)p
-0 3581 V 0 3712 a FA(AST)p Fe(_)p FA(ELLIPSE)1482 3713
-y Fd(Create)37 b(a)i(Ellipse)2893 3712 y FA(AST)p Fe(_)p
-FA(ELLIPSE)0 3914 y Fc(Description:)44 b Fj(This)28 b(function)g
+(the)i(astGEBuf)f(function)h(in)427 2745 y(the)d(grf)f(mo)r(dule.)p
+0 2969 V 0 3100 a FA(AST)p Fe(_)p FA(ELLIPSE)1482 3101
+y Fd(Create)37 b(a)i(Ellipse)2893 3100 y FA(AST)p Fe(_)p
+FA(ELLIPSE)0 3315 y Fc(Description:)44 b Fj(This)28 b(function)g
(creates)f(a)g(new)g(Ellipse)g(and)h(optionally)f(initialises)g(its)h
-(attributes.)227 4045 y(A)g(Ellipse)f(is)h(a)f(Region)g(whic)n(h)g
+(attributes.)227 3452 y(A)g(Ellipse)f(is)h(a)f(Region)g(whic)n(h)g
(represen)n(ts)g(a)g(elliptical)g(area)g(within)h(the)g(supplied)g
-(2-dimensional)e(F)-7 b(rame.)0 4207 y Fc(In)m(v)m(o)s(cation:)123
+(2-dimensional)e(F)-7 b(rame.)0 3626 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_ELLIPSE\()c(FRAME,)i(FORM,)g(CENTRE,)g
-(POINT1,)g(POINT2,)f(UNC,)i(OPTIONS,)f(STATUS)227 4307
-y(\))0 4469 y Fc(Argumen)m(ts:)259 4618 y(FRAME)31 b(=)h(INTEGER)g
-(\(Giv)m(en\))427 4717 y Fj(A)e(p)r(oin)n(ter)f(to)g(the)g(F)-7
+(POINT1,)g(POINT2,)f(UNC,)i(OPTIONS,)f(STATUS)227 3726
+y(\))0 3900 y Fc(Argumen)m(ts:)259 4062 y(FRAME)31 b(=)h(INTEGER)g
+(\(Giv)m(en\))427 4161 y Fj(A)e(p)r(oin)n(ter)f(to)g(the)g(F)-7
b(rame)29 b(in)g(whic)n(h)g(the)h(region)e(is)h(de\014ned.)42
b(It)30 b(m)n(ust)f(ha)n(v)n(e)f(exactly)g(2)h(axes.)41
-b(A)29 b(deep)427 4817 y(cop)n(y)h(is)g(tak)n(en)f(of)i(the)f(supplied)
+b(A)29 b(deep)427 4261 y(cop)n(y)h(is)g(tak)n(en)f(of)i(the)f(supplied)
h(F)-7 b(rame.)44 b(This)30 b(means)g(that)h(an)n(y)e(subsequen)n(t)h
-(c)n(hanges)f(made)h(to)g(the)427 4917 y(F)-7 b(rame)27
+(c)n(hanges)f(made)h(to)g(the)427 4360 y(F)-7 b(rame)27
b(using)h(the)g(supplied)f(p)r(oin)n(ter)h(will)g(ha)n(v)n(e)e(no)h
-(e\013ect)h(the)g(Region.)259 5056 y Fc(F)m(ORM)j(=)h(INTEGER)g(\(Giv)m
-(en\))427 5155 y Fj(Indicates)26 b(ho)n(w)g(the)g(ellipse)g(is)h
+(e\013ect)h(the)g(Region.)259 4506 y Fc(F)m(ORM)j(=)h(INTEGER)g(\(Giv)m
+(en\))427 4605 y Fj(Indicates)26 b(ho)n(w)g(the)g(ellipse)g(is)h
(describ)r(ed)f(b)n(y)f(the)i(remaining)e(parameters.)35
-b(A)26 b(v)-5 b(alue)27 b(of)f(zero)f(indicates)427 5255
+b(A)26 b(v)-5 b(alue)27 b(of)f(zero)f(indicates)427 4705
y(that)32 b(the)g(ellipse)g(is)f(sp)r(eci\014ed)h(b)n(y)g(a)f(cen)n
(tre)g(p)r(osition)h(and)f(t)n(w)n(o)g(p)r(ositions)g(on)h(the)g
-(circumference.)48 b(A)427 5355 y(v)-5 b(alue)25 b(of)g(one)g
+(circumference.)48 b(A)427 4805 y(v)-5 b(alue)25 b(of)g(one)g
(indicates)g(that)g(the)h(ellipse)f(is)g(sp)r(eci\014ed)g(b)n(y)g(its)g
(cen)n(tre)g(p)r(osition,)g(the)h(half-lengths)e(of)h(its)427
-5454 y(t)n(w)n(o)i(axes,)g(and)g(the)h(orien)n(tation)e(of)i(its)g
-(\014rst)f(axis.)259 5593 y Fc(CENTRE\()k(2)h(\))g(=)g(DOUBLE)g
-(PRECISION)f(\(Giv)m(en\))427 5693 y Fj(An)d(arra)n(y)e(con)n(taining)g
-(the)i(co)r(ordinates)e(at)i(the)g(cen)n(tre)f(of)g(the)h(ellipse.)p
-eop end
-%%Page: 219 229
-TeXDict begin 219 228 bop 3643 52 a FG(219)259 351 y
-Fc(POINT1\()32 b(2)g(\))g(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427
-451 y Fj(If)25 b(F)n(ORM)g(is)f(zero,)h(this)g(arra)n(y)d(should)j(con)
-n(tain)f(the)h(co)r(ordinates)e(of)i(one)f(of)h(the)g(four)f(p)r(oin)n
-(ts)h(where)f(an)427 551 y(axis)j(of)h(the)g(ellipse)g(crosses)d(the)j
-(circumference)f(of)h(the)g(ellipse.)37 b(If)28 b(F)n(ORM)g(is)f(one,)h
-(it)g(should)f(con)n(tain)427 650 y(the)39 b(lengths)f(of)g(semi-ma)5
-b(jor)36 b(and)i(semi-minor)g(axes)f(of)h(the)g(ellipse,)j(giv)n(en)c
-(as)h(geo)r(desic)f(distances)427 750 y(within)29 b(the)f(F)-7
-b(rame.)259 883 y Fc(POINT2\()32 b(2)g(\))g(=)g(DOUBLE)g(PRECISION)f
-(\(Giv)m(en\))427 983 y Fj(If)k(F)n(ORM)f(is)g(zero,)h(this)g(arra)n(y)
-d(should)i(con)n(taining)f(the)h(co)r(ordinates)f(at)h(some)g(other)g
-(p)r(oin)n(t)g(on)g(the)427 1083 y(circumference)25 b(of)h(the)g
-(ellipse,)g(distinct)h(from)e(POINT1.)35 b(If)26 b(F)n(ORM)g(is)f(one,)
-h(the)g(\014rst)g(elemen)n(t)g(of)f(this)427 1182 y(arra)n(y)30
-b(should)h(hold)h(the)g(angle)f(b)r(et)n(w)n(een)h(the)g(second)g(axis)
-f(of)h(the)g(F)-7 b(rame)31 b(and)h(the)g(\014rst)g(ellipse)f(axis)427
-1282 y(\(i.e.)52 b(the)33 b(ellipse)f(axis)f(whic)n(h)i(is)f(sp)r
+4904 y(t)n(w)n(o)i(axes,)g(and)g(the)h(orien)n(tation)e(of)i(its)g
+(\014rst)f(axis.)259 5050 y Fc(CENTRE\()k(2)h(\))g(=)g(DOUBLE)g
+(PRECISION)f(\(Giv)m(en\))427 5149 y Fj(An)d(arra)n(y)e(con)n(taining)g
+(the)i(co)r(ordinates)e(at)i(the)g(cen)n(tre)f(of)g(the)h(ellipse.)259
+5295 y Fc(POINT1\()k(2)g(\))g(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427
+5394 y Fj(If)25 b(F)n(ORM)g(is)f(zero,)h(this)g(arra)n(y)d(should)j
+(con)n(tain)f(the)h(co)r(ordinates)e(of)i(one)f(of)h(the)g(four)f(p)r
+(oin)n(ts)h(where)f(an)427 5494 y(axis)j(of)h(the)g(ellipse)g(crosses)d
+(the)j(circumference)f(of)h(the)g(ellipse.)37 b(If)28
+b(F)n(ORM)g(is)f(one,)h(it)g(should)f(con)n(tain)427
+5593 y(the)39 b(lengths)f(of)g(semi-ma)5 b(jor)36 b(and)i(semi-minor)g
+(axes)f(of)h(the)g(ellipse,)j(giv)n(en)c(as)h(geo)r(desic)f(distances)
+427 5693 y(within)29 b(the)f(F)-7 b(rame.)p eop end
+%%Page: 220 230
+TeXDict begin 220 229 bop 0 52 a FG(220)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(POINT2\()h(2)g(\))g
+(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427 451 y Fj(If)k(F)n(ORM)f(is)g
+(zero,)h(this)g(arra)n(y)d(should)i(con)n(taining)f(the)h(co)r
+(ordinates)f(at)h(some)g(other)g(p)r(oin)n(t)g(on)g(the)427
+551 y(circumference)25 b(of)h(the)g(ellipse,)g(distinct)h(from)e
+(POINT1.)35 b(If)26 b(F)n(ORM)g(is)f(one,)h(the)g(\014rst)g(elemen)n(t)
+g(of)f(this)427 650 y(arra)n(y)30 b(should)h(hold)h(the)g(angle)f(b)r
+(et)n(w)n(een)h(the)g(second)g(axis)f(of)h(the)g(F)-7
+b(rame)31 b(and)h(the)g(\014rst)g(ellipse)f(axis)427
+750 y(\(i.e.)52 b(the)33 b(ellipse)f(axis)f(whic)n(h)i(is)f(sp)r
(eci\014ed)h(\014rst)f(in)g(the)h(POINT1)e(arra)n(y\),)h(and)g(the)h
-(second)e(elemen)n(t)427 1381 y(will)g(b)r(e)g(ignored.)45
+(second)e(elemen)n(t)427 849 y(will)g(b)r(e)g(ignored.)45
b(The)31 b(angle)f(should)g(b)r(e)h(giv)n(en)f(in)h(radians,)f
(measured)g(p)r(ositiv)n(e)g(in)h(the)g(same)f(sense)427
-1481 y(as)g(rotation)g(from)g(the)h(p)r(ositiv)n(e)f(direction)g(of)h
+949 y(as)g(rotation)g(from)g(the)h(p)r(ositiv)n(e)f(direction)g(of)h
(the)g(second)f(F)-7 b(rame)30 b(axis)g(to)g(the)h(p)r(ositiv)n(e)f
-(direction)h(of)427 1581 y(the)d(\014rst)g(F)-7 b(rame)27
-b(axis.)259 1714 y Fc(UNC)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
-1814 y Fj(An)i(optional)e(p)r(oin)n(ter)h(to)g(an)g(existing)g(Region)f
+(direction)h(of)427 1049 y(the)d(\014rst)g(F)-7 b(rame)27
+b(axis.)259 1184 y Fc(UNC)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
+1284 y Fj(An)i(optional)e(p)r(oin)n(ter)h(to)g(an)g(existing)g(Region)f
(whic)n(h)h(sp)r(eci\014es)g(the)h(uncertain)n(ties)e(asso)r(ciated)g
-(with)427 1913 y(the)j(b)r(oundary)f(of)g(the)h(Bo)n(x)f(b)r(eing)g
+(with)427 1384 y(the)j(b)r(oundary)f(of)g(the)h(Bo)n(x)f(b)r(eing)g
(created.)54 b(The)34 b(uncertain)n(t)n(y)e(in)i(an)n(y)f(p)r(oin)n(t)h
-(on)f(the)h(b)r(oundary)f(of)427 2013 y(the)g(Bo)n(x)e(is)h(found)h(b)n
+(on)f(the)h(b)r(oundary)f(of)427 1483 y(the)g(Bo)n(x)e(is)h(found)h(b)n
(y)f(shifting)h(the)f(supplied)h Ft(")p Fj(uncertain)n(t)n(y)p
Ft(")e Fj(Region)g(so)h(that)g(it)h(is)f(cen)n(tred)g(at)g(the)427
-2113 y(b)r(oundary)e(p)r(oin)n(t)h(b)r(eing)g(considered.)44
+1583 y(b)r(oundary)e(p)r(oin)n(t)h(b)r(eing)g(considered.)44
b(The)31 b(area)e(co)n(v)n(ered)g(b)n(y)h(the)h(shifted)g(uncertain)n
-(t)n(y)f(Region)g(then)427 2212 y(represen)n(ts)g(the)i(uncertain)n(t)n
+(t)n(y)f(Region)g(then)427 1682 y(represen)n(ts)g(the)i(uncertain)n(t)n
(y)f(in)g(the)h(b)r(oundary)f(p)r(osition.)48 b(The)31
b(uncertain)n(t)n(y)g(is)g(assumed)g(to)g(b)r(e)h(the)427
-2312 y(same)27 b(for)g(all)h(p)r(oin)n(ts.)427 2428 y(If)38
+1782 y(same)27 b(for)g(all)h(p)r(oin)n(ts.)427 1900 y(If)38
b(supplied,)j(the)d(uncertain)n(t)n(y)f(Region)g(m)n(ust)g(b)r(e)i(of)e
(a)g(class)g(for)g(whic)n(h)h(all)f(instances)g(are)g(cen)n(tro-)427
-2528 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24 b(Circle,)g(Ellipse,)h
+1999 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24 b(Circle,)g(Ellipse,)h
(etc.\))36 b(or)23 b(b)r(e)i(a)e(Prism)h(con)n(taining)f(cen)n
-(tro-symetric)f(comp)r(onen)n(t)427 2628 y(Regions.)57
+(tro-symetric)f(comp)r(onen)n(t)427 2099 y(Regions.)57
b(A)35 b(deep)f(cop)n(y)g(of)g(the)h(supplied)g(Region)f(will)g(b)r(e)h
(tak)n(en,)h(so)e(subsequen)n(t)g(c)n(hanges)f(to)h(the)427
-2727 y(uncertain)n(t)n(y)g(Region)g(using)g(the)h(supplied)g(p)r(oin)n
+2199 y(uncertain)n(t)n(y)g(Region)g(using)g(the)h(supplied)g(p)r(oin)n
(ter)g(will)f(ha)n(v)n(e)g(no)g(e\013ect)h(on)g(the)g(created)f(Bo)n
-(x.)57 b(Al-)427 2827 y(ternativ)n(ely)-7 b(,)34 b(a)f(n)n(ull)g(Ob)5
+(x.)57 b(Al-)427 2298 y(ternativ)n(ely)-7 b(,)34 b(a)f(n)n(ull)g(Ob)5
b(ject)33 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fj(NULL\))g(ma)n(y)f(b)r(e)
i(supplied,)h(in)e(whic)n(h)g(case)f(a)h(default)427
-2927 y(uncertain)n(t)n(y)27 b(is)g(used)h(equiv)-5 b(alen)n(t)27
+2398 y(uncertain)n(t)n(y)27 b(is)g(used)h(equiv)-5 b(alen)n(t)27
b(to)h(a)f(b)r(o)n(x)g(1.0E-6)f(of)h(the)h(size)f(of)h(the)g(Bo)n(x)e
-(b)r(eing)i(created.)427 3043 y(The)h(uncertain)n(t)n(y)f(Region)g(has)
+(b)r(eing)i(created.)427 2515 y(The)h(uncertain)n(t)n(y)f(Region)g(has)
h(t)n(w)n(o)f(uses:)39 b(1\))29 b(when)g(the)g(AST)p
Ft(_)p Fj(O)n(VERLAP)f(function)h(compares)e(t)n(w)n(o)427
-3143 y(Regions)j(for)g(equalit)n(y)g(the)h(uncertain)n(t)n(y)f(Region)g
+2615 y(Regions)j(for)g(equalit)n(y)g(the)h(uncertain)n(t)n(y)f(Region)g
(is)g(used)h(to)g(determine)f(the)h(tolerance)f(on)g(the)h(com-)427
-3242 y(parison,)23 b(and)g(2\))g(when)g(a)f(Region)h(is)g(mapp)r(ed)g
+2715 y(parison,)23 b(and)g(2\))g(when)g(a)f(Region)h(is)g(mapp)r(ed)g
(in)n(to)g(a)f(di\013eren)n(t)i(co)r(ordinate)d(system)i(and)g
-(subsequen)n(tly)427 3342 y(simpli\014ed)e(\(using)f(AST)p
+(subsequen)n(tly)427 2814 y(simpli\014ed)e(\(using)f(AST)p
Ft(_)p Fj(SIMPLIFY\),)h(the)f(uncertain)n(ties)g(are)f(used)h(to)g
-(determine)g(if)h(the)g(transformed)427 3442 y(b)r(oundary)27
+(determine)g(if)h(the)g(transformed)427 2914 y(b)r(oundary)27
b(can)g(b)r(e)h(accurately)f(represen)n(ted)f(b)n(y)h(a)g(sp)r
-(eci\014c)h(shap)r(e)g(of)f(Region.)259 3575 y Fc(OPTIONS)32
+(eci\014c)h(shap)r(e)g(of)f(Region.)259 3050 y Fc(OPTIONS)32
b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))
-427 3675 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h
+427 3149 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h
(optional)g(comma-separated)e(list)j(of)g(attribute)f(assignmen)n(ts)g
-(to)427 3774 y(b)r(e)24 b(used)f(for)g(initialising)f(the)i(new)f
+(to)427 3249 y(b)r(e)24 b(used)f(for)g(initialising)f(the)i(new)f
(Ellipse.)35 b(The)23 b(syn)n(tax)f(used)i(is)f(iden)n(tical)f(to)h
-(that)h(for)e(the)i(AST)p Ft(_)p Fj(SET)427 3874 y(routine.)259
-4008 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 4107 y Fj(The)c(global)e(status.)0 4270
-y Fc(Returned)32 b(V)-8 b(alue:)259 4408 y(AST)p Ft(_)p
-Fc(ELLIPSE)33 b(=)f(INTEGER)427 4508 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)
-g(new)g(Ellipse.)0 4671 y Fc(Notes:)340 4955 y Fi(\017)45
+(that)h(for)e(the)i(AST)p Ft(_)p Fj(SET)427 3349 y(routine.)259
+3484 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 3584 y Fj(The)c(global)e(status.)0 3751
+y Fc(Returned)32 b(V)-8 b(alue:)259 3893 y(AST)p Ft(_)p
+Fc(ELLIPSE)33 b(=)f(INTEGER)427 3993 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)
+g(new)g(Ellipse.)0 4161 y Fc(Notes:)340 4449 y Fi(\017)45
b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 5054
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 4548
y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 5255 3780 12 v 0 5386
-a FA(AST)p Fe(_)p FA(ELLIPSEP)-11 b(ARS)1586 5387 y Fd(Returns)39
-b(the)1643 5486 y(geometric)1459 5601 y(parameters)d(of)i(an)1720
-5715 y(Ellipse)2536 5386 y FA(AST)p Fe(_)p FA(ELLIPSEP)-11
-b(ARS)p eop end
-%%Page: 220 230
-TeXDict begin 220 229 bop 0 52 a FG(220)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Description:)44
-b Fj(This)28 b(routine)f(returns)g(the)h(geometric)e(parameters)g
-(describing)h(the)h(supplied)g(ellipse.)0 499 y Fc(In)m(v)m(o)s
-(cation:)123 b Ft(CALL)42 b(AST_ELLIPSEPARS)o(\()c(THIS,)j(CENTRE,)g
-(A,)i(B,)f(ANGLE,)f(P1,)i(P2,)f(STATUS)f(\))0 647 y Fc(Argumen)m(ts:)
-259 781 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 881
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Region.)259 1012 y
-Fc(CENTRE\()j(2)h(\))g(=)g(DOUBLE)g(PRECISION)f(\(Returned\))427
-1111 y Fj(The)d(co)r(ordinates)e(of)i(the)g(Ellipse)f(cen)n(tre)g(are)f
-(returned)i(in)f(this)h(arra)n(ys.)259 1242 y Fc(A)k(=)g(DOUBLE)g
-(PRECISION)g(\(Returned\))427 1342 y Fj(Returned)c(holding)f(the)h
-(half-length)g(of)f(the)h(\014rst)g(axis)e(of)i(the)g(ellipse.)259
-1473 y Fc(B)k(=)g(DOUBLE)g(PRECISION)f(\(Returned\))427
-1573 y Fj(Returned)d(holding)f(the)h(half-length)g(of)f(the)h(second)f
-(axis)g(of)g(the)h(ellipse.)259 1704 y Fc(ANGLE)k(=)g(DOUBLE)g
-(PRECISION)g(\(Returned\))427 1803 y Fj(If)39 b(the)g(co)r(ordinate)e
-(system)h(in)h(whic)n(h)f(the)h(Ellipse)f(is)g(de\014ned)h(has)f(axes)g
-(\(X,Y\),)h(then)g(ANGLE)g(is)427 1903 y(returned)32
-b(holding)g(the)g(angle)f(from)h(the)h(p)r(ositiv)n(e)e(direction)h(of)
-g(the)h(Y)f(axis)f(to)h(the)h(\014rst)f(axis)f(of)h(the)427
-2003 y(ellipse,)22 b(in)f(radians.)33 b(P)n(ositiv)n(e)19
-b(rotation)g(is)h(in)h(the)g(same)e(sense)h(as)g(rotation)f(from)h(the)
-h(p)r(ositiv)n(e)f(direction)427 2102 y(of)28 b(Y)g(to)f(the)h(p)r
-(ositiv)n(e)f(direction)h(of)f(X.)259 2233 y Fc(P1\()32
-b(2)g(\))g(=)g(DOUBLE)g(PRECISION)f(\(Returned\))427
-2333 y Fj(An)j(arra)n(y)c(in)j(whic)n(h)g(to)g(return)f(the)h(co)r
+(fail)h(for)f(an)n(y)g(reason.)p 0 4753 3780 12 v 0 4884
+a FA(AST)p Fe(_)p FA(ELLIPSEP)-11 b(ARS)1586 4885 y Fd(Returns)39
+b(the)1643 4985 y(geometric)1459 5099 y(parameters)d(of)i(an)1720
+5214 y(Ellipse)2536 4884 y FA(AST)p Fe(_)p FA(ELLIPSEP)-11
+b(ARS)0 5408 y Fc(Description:)44 b Fj(This)28 b(routine)f(returns)g
+(the)h(geometric)e(parameters)g(describing)h(the)h(supplied)g(ellipse.)
+0 5563 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_ELLIPSEPARS)o
+(\()c(THIS,)j(CENTRE,)g(A,)i(B,)f(ANGLE,)f(P1,)i(P2,)f(STATUS)f(\))0
+5718 y Fc(Argumen)m(ts:)p eop end
+%%Page: 221 231
+TeXDict begin 221 230 bop 3643 52 a FG(221)259 351 y
+Fc(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(Region.)259 575 y Fc(CENTRE\()j(2)h(\))g(=)g(DOUBLE)g
+(PRECISION)f(\(Returned\))427 675 y Fj(The)d(co)r(ordinates)e(of)i(the)
+g(Ellipse)f(cen)n(tre)g(are)f(returned)i(in)f(this)h(arra)n(ys.)259
+799 y Fc(A)k(=)g(DOUBLE)g(PRECISION)g(\(Returned\))427
+899 y Fj(Returned)c(holding)f(the)h(half-length)g(of)f(the)h(\014rst)g
+(axis)e(of)i(the)g(ellipse.)259 1023 y Fc(B)k(=)g(DOUBLE)g(PRECISION)f
+(\(Returned\))427 1122 y Fj(Returned)d(holding)f(the)h(half-length)g
+(of)f(the)h(second)f(axis)g(of)g(the)h(ellipse.)259 1247
+y Fc(ANGLE)k(=)g(DOUBLE)g(PRECISION)g(\(Returned\))427
+1346 y Fj(If)39 b(the)g(co)r(ordinate)e(system)h(in)h(whic)n(h)f(the)h
+(Ellipse)f(is)g(de\014ned)h(has)f(axes)g(\(X,Y\),)h(then)g(ANGLE)g(is)
+427 1446 y(returned)32 b(holding)g(the)g(angle)f(from)h(the)h(p)r
+(ositiv)n(e)e(direction)h(of)g(the)h(Y)f(axis)f(to)h(the)h(\014rst)f
+(axis)f(of)h(the)427 1546 y(ellipse,)22 b(in)f(radians.)33
+b(P)n(ositiv)n(e)19 b(rotation)g(is)h(in)h(the)g(same)e(sense)h(as)g
+(rotation)f(from)h(the)h(p)r(ositiv)n(e)f(direction)427
+1645 y(of)28 b(Y)g(to)f(the)h(p)r(ositiv)n(e)f(direction)h(of)f(X.)259
+1769 y Fc(P1\()32 b(2)g(\))g(=)g(DOUBLE)g(PRECISION)f(\(Returned\))427
+1869 y Fj(An)j(arra)n(y)c(in)j(whic)n(h)g(to)g(return)f(the)h(co)r
(ordinates)f(at)g(one)h(of)g(the)g(t)n(w)n(o)f(ends)h(of)g(the)g
-(\014rst)f(axis)g(of)h(the)427 2432 y(ellipse.)259 2563
+(\014rst)f(axis)g(of)h(the)427 1969 y(ellipse.)259 2093
y Fc(P2\()f(2)g(\))g(=)g(DOUBLE)g(PRECISION)f(\(Returned\))427
-2663 y Fj(An)d(arra)n(y)e(in)i(whic)n(h)g(to)f(return)h(the)g(co)r
+2193 y Fj(An)d(arra)n(y)e(in)i(whic)n(h)g(to)f(return)h(the)g(co)r
(ordinates)e(at)i(one)f(of)h(the)g(t)n(w)n(o)f(ends)h(of)f(the)h
-(second)g(axis)f(of)g(the)427 2763 y(ellipse.)259 2894
+(second)g(axis)f(of)g(the)427 2292 y(ellipse.)259 2416
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 2993 y Fj(The)c(global)e(status.)0 3153 y Fc(Notes:)340
-3434 y Fi(\017)45 b Fj(If)22 b(the)g(co)r(ordinate)e(system)h(represen)
+427 2516 y Fj(The)c(global)e(status.)0 2669 y Fc(Notes:)340
+2943 y Fi(\017)45 b Fj(If)22 b(the)g(co)r(ordinate)e(system)h(represen)
n(ted)f(b)n(y)h(the)h(Ellipse)e(has)h(b)r(een)h(c)n(hanged)e(since)h
-(it)h(w)n(as)e(\014rst)h(created,)427 3534 y(the)e(returned)f
+(it)h(w)n(as)e(\014rst)h(created,)427 3043 y(the)e(returned)f
(parameters)f(refer)h(to)h(the)g(new)f(\(c)n(hanged\))g(co)r(ordinate)g
-(system,)i(rather)d(than)i(the)g(original)427 3633 y(co)r(ordinate)27
+(system,)i(rather)d(than)i(the)g(original)427 3143 y(co)r(ordinate)27
b(system.)37 b(Note)28 b(ho)n(w)n(ev)n(er)e(that)i(if)g(the)g
(transformation)f(from)g(original)f(to)i(new)g(co)r(ordinate)427
-3733 y(system)36 b(is)h(non-linear,)g(the)g(shap)r(e)f(represen)n(ted)f
+3242 y(system)36 b(is)h(non-linear,)g(the)g(shap)r(e)f(represen)n(ted)f
(b)n(y)h(the)h(supplied)g(Ellipse)f(ob)5 b(ject)36 b(ma)n(y)g(not)g(b)r
-(e)h(an)427 3833 y(accurate)27 b(ellipse.)340 3964 y
+(e)h(an)427 3342 y(accurate)27 b(ellipse.)340 3466 y
Fi(\017)45 b Fj(V)-7 b(alues)20 b(of)h(AST)p Ft(__)p
Fj(BAD)f(are)f(returned)h(for)g(the)h(parameters)e(without)h(error)f
-(if)i(the)f(ellipse)h(is)f(degenerate)427 4063 y(or)27
-b(unde\014ned.)p 0 4259 3780 12 v 0 4390 a FA(AST)p Fe(_)p
-FA(EMPTYFITS)1377 4391 y Fd(Delete)38 b(all)g(cards)g(in)g(a)1653
-4490 y(FitsChan)2642 4390 y FA(AST)p Fe(_)p FA(EMPTYFITS)0
-4652 y Fc(Description:)44 b Fj(This)28 b(routine)f(deletes)h(all)f
+(if)i(the)f(ellipse)h(is)f(degenerate)427 3566 y(or)27
+b(unde\014ned.)p 0 3748 3780 12 v 0 3878 a FA(AST)p Fe(_)p
+FA(EMPTYFITS)1377 3879 y Fd(Delete)38 b(all)g(cards)g(in)g(a)1653
+3979 y(FitsChan)2642 3878 y FA(AST)p Fe(_)p FA(EMPTYFITS)0
+4127 y Fc(Description:)44 b Fj(This)28 b(routine)f(deletes)h(all)f
(cards)f(and)i(asso)r(ciated)e(information)h(from)g(a)h(FitsChan.)0
-4800 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_EMPTYFITS\()37
-b(THIS,)42 b(STATUS)f(\))0 4947 y Fc(Argumen)m(ts:)259
-5082 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 5182
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259 5313
+4268 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_EMPTYFITS\()37
+b(THIS,)42 b(STATUS)f(\))0 4409 y Fc(Argumen)m(ts:)259
+4537 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 4636
+y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259 4761
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 5412 y Fj(The)c(global)e(status.)0 5572 y Fc(Notes:)p
-eop end
-%%Page: 221 231
-TeXDict begin 221 230 bop 3643 52 a FG(221)340 351 y
-Fi(\017)45 b Fj(This)27 b(metho)r(d)g(simply)g(deletes)g(the)g(cards)f
-(curren)n(tly)g(in)h(the)g(FitsChan.)37 b(Unlik)n(e)26
-b(AST)p Ft(_)p Fj(WRITEFITS,)427 451 y(they)i(are)f(not)g(\014rst)h
+427 4860 y Fj(The)c(global)e(status.)0 5014 y Fc(Notes:)340
+5288 y Fi(\017)45 b Fj(This)27 b(metho)r(d)g(simply)g(deletes)g(the)g
+(cards)f(curren)n(tly)g(in)h(the)g(FitsChan.)37 b(Unlik)n(e)26
+b(AST)p Ft(_)p Fj(WRITEFITS,)427 5387 y(they)i(are)f(not)g(\014rst)h
(written)f(out)h(to)f(the)h(sink)g(function)g(or)f(sink)g(\014le.)340
-585 y Fi(\017)45 b Fj(An)n(y)28 b(T)-7 b(ables)27 b(or)g(w)n(arnings)f
+5511 y Fi(\017)45 b Fj(An)n(y)28 b(T)-7 b(ables)27 b(or)g(w)n(arnings)f
(stored)g(in)i(the)g(FitsChan)g(are)e(also)h(deleted.)340
-720 y Fi(\017)45 b Fj(This)28 b(metho)r(d)g(attempt)g(to)g(execute)f
+5636 y Fi(\017)45 b Fj(This)28 b(metho)r(d)g(attempt)g(to)g(execute)f
(ev)n(en)g(if)h(an)g(error)d(has)i(o)r(ccurred)g(previously)-7
-b(.)p 0 922 3780 12 v 0 1052 a FA(AST)p Fe(_)p FA(END)1357
-1053 y Fd(End)39 b(an)g(AST)f(con)m(text)3152 1052 y
-FA(AST)p Fe(_)p FA(END)0 1232 y Fc(Description:)44 b
-Fj(This)h(routine)f(ends)h(an)g(AST)g(con)n(text)f(whic)n(h)h(w)n(as)f
-(b)r(egun)g(with)i(a)e(matc)n(hing)g(in)n(v)n(o)r(cation)g(of)227
-1332 y(AST)p Ft(_)p Fj(BEGIN.)18 b(An)n(y)h(Ob)5 b(ject)18
-b(p)r(oin)n(ters)g(created)f(within)i(this)g(con)n(text)f(will)h(b)r(e)
-f(ann)n(ulled)h(\(just)g(as)e(if)i(AST)p Ft(_)p Fj(ANNUL)227
-1431 y(had)24 b(b)r(een)h(in)n(v)n(ok)n(ed\))e(and)h(will)g(cease)f(to)
-h(b)r(e)h(v)-5 b(alid)24 b(afterw)n(ards,)f(unless)h(they)h(ha)n(v)n(e)
-e(previously)f(b)r(een)j(exp)r(orted)227 1531 y(using)k(AST)p
-Ft(_)p Fj(EXPOR)-7 b(T)28 b(or)f(rendered)h(exempt)i(using)e(AST)p
-Ft(_)p Fj(EXEMPT.)g(If)h(ann)n(ulling)f(a)h(p)r(oin)n(ter)f(causes)g
-(an)227 1631 y(Ob)5 b(ject's)24 b(RefCoun)n(t)h(attribute)f(to)h(fall)f
-(to)g(zero)g(\(whic)n(h)g(happ)r(ens)h(when)f(the)h(last)f(p)r(oin)n
-(ter)g(to)g(it)h(is)f(ann)n(ulled\),)227 1730 y(then)k(the)g(Ob)5
-b(ject)28 b(will)g(b)r(e)g(deleted.)0 1883 y Fc(In)m(v)m(o)s(cation:)
-123 b Ft(CALL)42 b(AST_END\()e(STATUS)h(\))0 2035 y Fc(Argumen)m(ts:)
-259 2174 y(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 2274 y Fj(The)c(global)e(status.)0 2439
-y Fc(Class)31 b(Applicabilit)m(y:)259 2578 y(Ob)5 b(ject)427
-2678 y Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5
-b(jects.)0 2843 y Fc(Notes:)340 3128 y Fi(\017)45 b Fj(This)28
-b(routine)f(attempts)h(to)g(execute)f(ev)n(en)g(if)h(ST)-7
+b(.)p eop end
+%%Page: 222 232
+TeXDict begin 222 231 bop 0 52 a FG(222)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(END)1357 483 y Fd(End)39
+b(an)g(AST)f(con)m(text)3152 482 y FA(AST)p Fe(_)p FA(END)0
+654 y Fc(Description:)44 b Fj(This)h(routine)f(ends)h(an)g(AST)g(con)n
+(text)f(whic)n(h)h(w)n(as)f(b)r(egun)g(with)i(a)e(matc)n(hing)g(in)n(v)
+n(o)r(cation)g(of)227 754 y(AST)p Ft(_)p Fj(BEGIN.)18
+b(An)n(y)h(Ob)5 b(ject)18 b(p)r(oin)n(ters)g(created)f(within)i(this)g
+(con)n(text)f(will)h(b)r(e)f(ann)n(ulled)h(\(just)g(as)e(if)i(AST)p
+Ft(_)p Fj(ANNUL)227 853 y(had)24 b(b)r(een)h(in)n(v)n(ok)n(ed\))e(and)h
+(will)g(cease)f(to)h(b)r(e)h(v)-5 b(alid)24 b(afterw)n(ards,)f(unless)h
+(they)h(ha)n(v)n(e)e(previously)f(b)r(een)j(exp)r(orted)227
+953 y(using)k(AST)p Ft(_)p Fj(EXPOR)-7 b(T)28 b(or)f(rendered)h(exempt)
+i(using)e(AST)p Ft(_)p Fj(EXEMPT.)g(If)h(ann)n(ulling)f(a)h(p)r(oin)n
+(ter)f(causes)g(an)227 1053 y(Ob)5 b(ject's)24 b(RefCoun)n(t)h
+(attribute)f(to)h(fall)f(to)g(zero)g(\(whic)n(h)g(happ)r(ens)h(when)f
+(the)h(last)f(p)r(oin)n(ter)g(to)g(it)h(is)f(ann)n(ulled\),)227
+1152 y(then)k(the)g(Ob)5 b(ject)28 b(will)g(b)r(e)g(deleted.)0
+1300 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_END\()e(STATUS)h
+(\))0 1447 y Fc(Argumen)m(ts:)259 1581 y(ST)-8 b(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 1681
+y Fj(The)c(global)e(status.)0 1840 y Fc(Class)31 b(Applicabilit)m(y:)
+259 1975 y(Ob)5 b(ject)427 2074 y Fj(This)28 b(routine)f(applies)g(to)h
+(all)f(Ob)5 b(jects.)0 2234 y Fc(Notes:)340 2514 y Fi(\017)45
+b Fj(This)28 b(routine)f(attempts)h(to)g(execute)f(ev)n(en)g(if)h(ST)-7
b(A)g(TUS)29 b(is)e(set)h(to)f(an)h(error)d(v)-5 b(alue.)340
-3262 y Fi(\017)45 b Fj(Con)n(texts)27 b(delimited)i(b)n(y)e(AST)p
+2645 y Fi(\017)45 b Fj(Con)n(texts)27 b(delimited)i(b)n(y)e(AST)p
Ft(_)p Fj(BEGIN)g(and)h(AST)p Ft(_)p Fj(END)g(ma)n(y)e(b)r(e)i(nested)g
-(to)g(an)n(y)e(depth.)p 0 3465 V 0 3595 a FA(AST)p Fe(_)p
-FA(ESCAPES)1218 3596 y Fd(Con)m(trol)36 b(whether)i(graphical)1128
-3711 y(escap)s(e)h(sequences)g(are)f(included)1652 3822
-y(in)g(strings)2832 3595 y FA(AST)p Fe(_)p FA(ESCAPES)0
-4014 y Fc(Description:)44 b Fj(The)39 b(Plot)g(class)f(de\014nes)g(a)h
+(to)g(an)n(y)e(depth.)p 0 2840 V 0 2970 a FA(AST)p Fe(_)p
+FA(ESCAPES)1218 2971 y Fd(Con)m(trol)36 b(whether)i(graphical)1128
+3086 y(escap)s(e)h(sequences)g(are)f(included)1652 3197
+y(in)g(strings)2832 2970 y FA(AST)p Fe(_)p FA(ESCAPES)0
+3381 y Fc(Description:)44 b Fj(The)39 b(Plot)g(class)f(de\014nes)g(a)h
(set)g(of)g(escap)r(e)f(sequences)g(whic)n(h)h(can)f(b)r(e)i(included)f
-(within)h(a)e(text)227 4113 y(string)29 b(in)g(order)f(to)h(con)n(trol)
+(within)h(a)e(text)227 3481 y(string)29 b(in)g(order)f(to)h(con)n(trol)
f(the)h(app)r(earance)f(of)h(sub-strings)f(within)h(the)h(text.)42
-b(See)29 b(the)g(Escap)r(e)f(attribute)227 4213 y(for)j(a)g
+b(See)29 b(the)g(Escap)r(e)f(attribute)227 3581 y(for)j(a)g
(description)f(of)h(these)g(escap)r(e)g(sequences.)46
b(It)32 b(is)f(usually)f(inappropriate)g(for)g(AST)i(to)f(return)g
-(strings)227 4312 y(con)n(taining)i(suc)n(h)h(escap)r(e)f(sequences)h
+(strings)227 3680 y(con)n(taining)i(suc)n(h)h(escap)r(e)f(sequences)h
(when)g(called)g(b)n(y)f(application)h(co)r(de.)56 b(F)-7
-b(or)33 b(instance,)j(an)d(application)227 4412 y(whic)n(h)22
+b(or)33 b(instance,)j(an)d(application)227 3780 y(whic)n(h)22
b(displa)n(ys)e(the)i(v)-5 b(alue)22 b(of)f(the)h(Title)g(attribute)g
(of)f(a)g(F)-7 b(rame)21 b(usually)g(do)r(es)g(not)h(w)n(an)n(t)f(the)h
-(displa)n(y)n(ed)e(string)227 4512 y(to)25 b(include)g(p)r(oten)n
+(displa)n(y)n(ed)e(string)227 3879 y(to)25 b(include)g(p)r(oten)n
(tially)g(long)f(escap)r(e)g(sequences)g(whic)n(h)h(a)g(h)n(uman)f
(read)g(w)n(ould)h(ha)n(v)n(e)e(di\016culy)i(in)n(terpreting.)227
-4611 y(Therefore)37 b(the)h(default)g(b)r(eha)n(viour)f(is)h(for)f(AST)
+3979 y(Therefore)37 b(the)h(default)g(b)r(eha)n(viour)f(is)h(for)f(AST)
h(to)g(strip)g(out)g(suc)n(h)f(escap)r(e)g(sequences)g(when)h(called)g
-(b)n(y)227 4711 y(application)27 b(co)r(de.)37 b(This)27
+(b)n(y)227 4079 y(application)27 b(co)r(de.)37 b(This)27
b(default)i(b)r(eha)n(viour)d(can)h(b)r(e)h(c)n(hanged)f(using)g(this)h
-(function.)0 4863 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
-b(=)i(AST_ESCAPES\()c(NEWVAL,)h(STATUS)h(\))0 5016 y
-Fc(Argumen)m(ts:)259 5155 y(NEWV)-11 b(AL)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 5255 y Fj(A)d(\015ag)f(whic)n(h)h(indicates)f(if)h(escap)r
+(function.)0 4226 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
+b(=)i(AST_ESCAPES\()c(NEWVAL,)h(STATUS)h(\))0 4373 y
+Fc(Argumen)m(ts:)259 4507 y(NEWV)-11 b(AL)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 4607 y Fj(A)d(\015ag)f(whic)n(h)h(indicates)f(if)h(escap)r
(es)f(sequences)g(should)g(b)r(e)h(included)g(in)g(returned)f(strings.)
-39 b(If)29 b(zero)f(is)427 5354 y(supplied,)c(escap)r(e)e(sequences)f
+39 b(If)29 b(zero)f(is)427 4707 y(supplied,)c(escap)r(e)e(sequences)f
(will)h(b)r(e)h(stripp)r(ed)f(out)h(of)f(all)g(strings)f(returned)h(b)n
-(y)g(an)n(y)f(AST)i(function.)35 b(If)427 5454 y(a)20
+(y)g(an)n(y)f(AST)i(function.)35 b(If)427 4806 y(a)20
b(p)r(ositiv)n(e)g(v)-5 b(alue)20 b(is)g(supplied,)j(then)d(an)n(y)g
(escap)r(e)g(sequences)f(will)i(b)r(e)g(retained)e(in)i(the)g(v)-5
-b(alue)20 b(returned)g(to)427 5554 y(the)k(caller.)34
+b(alue)20 b(returned)g(to)427 4906 y(the)k(caller.)34
b(If)24 b(a)e(negativ)n(e)g(v)-5 b(alue)23 b(is)g(supplied,)i(the)e
(curren)n(t)f(v)-5 b(alue)23 b(of)g(the)h(\015ag)e(will)i(b)r(e)f(left)
-h(unc)n(hanged.)0 5718 y Fc(Class)31 b(Applicabilit)m(y:)p
-eop end
-%%Page: 222 232
-TeXDict begin 222 231 bop 0 52 a FG(222)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(Ob)5
-b(ject)427 451 y Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5
-b(jects.)0 615 y Fc(Returned)32 b(V)-8 b(alue:)259 754
-y(AST)p Ft(_)p Fc(ESCAPES)32 b(=)g(INTEGER)427 854 y
-Fj(The)c(v)-5 b(alue)27 b(of)h(the)g(\015ag)f(on)g(en)n(try)g(to)h
-(this)f(function.)0 1018 y Fc(Notes:)340 1303 y Fi(\017)45
-b Fj(This)30 b(function)g(also)f(con)n(trols)f(whether)h(the)h(AST)p
-Ft(_)p Fj(STRIPESCAPES)e(function)i(remo)n(v)n(es)e(escap)r(e)h(se-)427
-1402 y(quences)e(from)h(the)g(supplied)g(string,)f(or)f(returns)h(the)h
-(supplied)g(string)f(without)h(c)n(hange.)340 1537 y
-Fi(\017)45 b Fj(This)28 b(function)g(attempts)g(to)f(execute)h(ev)n(en)
-f(if)h(an)f(error)f(has)h(already)f(o)r(ccurred.)p 0
-1738 3780 12 v 0 1869 a FA(AST)p Fe(_)p FA(EXEMPT)1074
-1870 y Fd(Exempt)38 b(an)h(Ob)7 b(ject)38 b(p)s(oin)m(ter)f(from)1322
-1984 y(AST)i(con)m(text)e(handling)2857 1869 y FA(AST)p
-Fe(_)p FA(EXEMPT)0 2176 y Fc(Description:)44 b Fj(This)29
+h(unc)n(hanged.)0 5066 y Fc(Class)31 b(Applicabilit)m(y:)259
+5200 y(Ob)5 b(ject)427 5299 y Fj(This)28 b(routine)f(applies)g(to)h
+(all)f(Ob)5 b(jects.)0 5459 y Fc(Returned)32 b(V)-8 b(alue:)259
+5593 y(AST)p Ft(_)p Fc(ESCAPES)32 b(=)g(INTEGER)427 5693
+y Fj(The)c(v)-5 b(alue)27 b(of)h(the)g(\015ag)f(on)g(en)n(try)g(to)h
+(this)f(function.)p eop end
+%%Page: 223 233
+TeXDict begin 223 232 bop 3643 52 a FG(223)0 351 y Fc(Notes:)340
+623 y Fi(\017)45 b Fj(This)30 b(function)g(also)f(con)n(trols)f
+(whether)h(the)h(AST)p Ft(_)p Fj(STRIPESCAPES)e(function)i(remo)n(v)n
+(es)e(escap)r(e)h(se-)427 723 y(quences)e(from)h(the)g(supplied)g
+(string,)f(or)f(returns)h(the)h(supplied)g(string)f(without)h(c)n
+(hange.)340 845 y Fi(\017)45 b Fj(This)28 b(function)g(attempts)g(to)f
+(execute)h(ev)n(en)f(if)h(an)f(error)f(has)h(already)f(o)r(ccurred.)p
+0 1024 3780 12 v 0 1154 a FA(AST)p Fe(_)p FA(EXEMPT)1074
+1155 y Fd(Exempt)38 b(an)h(Ob)7 b(ject)38 b(p)s(oin)m(ter)f(from)1322
+1270 y(AST)i(con)m(text)e(handling)2857 1154 y FA(AST)p
+Fe(_)p FA(EXEMPT)0 1438 y Fc(Description:)44 b Fj(This)29
b(routine)g(exempts)g(an)g(Ob)5 b(ject)29 b(p)r(oin)n(ter)f(from)h(AST)
g(con)n(text)g(handling,)g(as)f(implemen)n(ted)i(b)n(y)227
-2275 y(AST)p Ft(_)p Fj(BEGIN)h(and)g(AST)p Ft(_)p Fj(END.)g(This)h
+1538 y(AST)p Ft(_)p Fj(BEGIN)h(and)g(AST)p Ft(_)p Fj(END.)g(This)h
(means)e(that)i(the)f(p)r(oin)n(ter)g(will)g(not)g(b)r(e)h(a\013ected)f
-(when)g(AST)p Ft(_)p Fj(END)227 2375 y(is)36 b(called)f(and)g(will)h
+(when)g(AST)p Ft(_)p Fj(END)227 1637 y(is)36 b(called)f(and)g(will)h
(remain)f(activ)n(e)f(un)n(til)i(the)g(end)g(of)f(the)h(program,)g(or)e
-(un)n(til)i(explicitly)g(ann)n(ulled)f(using)227 2475
-y(AST)p Ft(_)p Fj(ANNUL.)227 2600 y(If)24 b(p)r(ossible,)g(y)n(ou)f
+(un)n(til)i(explicitly)g(ann)n(ulled)f(using)227 1737
+y(AST)p Ft(_)p Fj(ANNUL.)227 1856 y(If)24 b(p)r(ossible,)g(y)n(ou)f
(should)h(a)n(v)n(oid)e(using)h(this)h(routine)f(when)h(writing)f
(applications.)35 b(It)24 b(is)f(pro)n(vided)g(mainly)g(for)227
-2700 y(dev)n(elop)r(ers)30 b(of)i(other)e(libraries,)h(who)g(ma)n(y)g
+1956 y(dev)n(elop)r(ers)30 b(of)i(other)e(libraries,)h(who)g(ma)n(y)g
(wish)g(to)g(retain)g(references)f(to)h(AST)h(Ob)5 b(jects)31
-b(in)g(in)n(ternal)g(data)227 2800 y(structures,)c(and)h(who)f
+b(in)g(in)n(ternal)g(data)227 2055 y(structures,)c(and)h(who)f
(therefore)g(need)g(to)h(a)n(v)n(oid)e(the)i(e\013ects)g(of)f(AST)p
-Ft(_)p Fj(BEGIN)h(and)f(AST)p Ft(_)p Fj(END.)0 2951 y
+Ft(_)p Fj(BEGIN)h(and)f(AST)p Ft(_)p Fj(END.)0 2194 y
Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_EXEMPT\()d(THIS,)i
-(STATUS)g(\))0 3103 y Fc(Argumen)m(ts:)259 3242 y(THIS)32
-b(=)g(INTEGER)g(\(Giv)m(en\))427 3342 y Fj(Ob)5 b(ject)28
+(STATUS)g(\))0 2333 y Fc(Argumen)m(ts:)259 2459 y(THIS)32
+b(=)g(INTEGER)g(\(Giv)m(en\))427 2559 y Fj(Ob)5 b(ject)28
b(p)r(oin)n(ter)f(to)g(b)r(e)h(exempted)g(from)g(con)n(text)f
-(handling.)259 3476 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)
-h(and)g(Returned\))427 3575 y Fj(The)c(global)e(status.)0
-3740 y Fc(Class)31 b(Applicabilit)m(y:)259 3879 y(Ob)5
-b(ject)427 3978 y Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5
-b(jects.)p 0 4180 V 0 4310 a FA(AST)p Fe(_)p FA(EXPOR)-11
-b(T)1081 4311 y Fd(Exp)s(ort)37 b(an)i(Ob)7 b(ject)38
-b(p)s(oin)m(ter)f(to)h(an)1548 4411 y(outer)g(con)m(text)2883
-4310 y FA(AST)p Fe(_)p FA(EXPOR)-11 b(T)0 4579 y Fc(Description:)44
+(handling.)259 2682 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)
+h(and)g(Returned\))427 2781 y Fj(The)c(global)e(status.)0
+2933 y Fc(Class)31 b(Applicabilit)m(y:)259 3059 y(Ob)5
+b(ject)427 3158 y Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5
+b(jects.)p 0 3337 V 0 3467 a FA(AST)p Fe(_)p FA(EXPOR)-11
+b(T)1081 3468 y Fd(Exp)s(ort)37 b(an)i(Ob)7 b(ject)38
+b(p)s(oin)m(ter)f(to)h(an)1548 3568 y(outer)g(con)m(text)2883
+3467 y FA(AST)p Fe(_)p FA(EXPOR)-11 b(T)0 3713 y Fc(Description:)44
b Fj(This)34 b(routine)g(exp)r(orts)f(an)g(Ob)5 b(ject)34
b(p)r(oin)n(ter)g(from)f(the)h(curren)n(t)f(AST)i(con)n(text)e(in)n(to)
-h(the)g(con)n(text)227 4679 y(that)f(encloses)e(the)i(curren)n(t)f
+h(the)g(con)n(text)227 3812 y(that)f(encloses)e(the)i(curren)n(t)f
(one.)51 b(This)33 b(means)f(that)g(the)h(p)r(oin)n(ter)f(will)h(no)f
-(longer)f(b)r(e)i(ann)n(ulled)g(when)f(the)227 4778 y(curren)n(t)27
+(longer)f(b)r(e)i(ann)n(ulled)g(when)f(the)227 3912 y(curren)n(t)27
b(con)n(text)g(is)h(ended)g(\(with)g(AST)p Ft(_)p Fj(END\),)g(but)g
(only)f(when)h(the)g(next)g(outer)f(con)n(text)g(\(if)i(an)n(y\))e
-(ends.)0 4930 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
-b(AST_EXPORT\()d(THIS,)i(STATUS)g(\))0 5082 y Fc(Argumen)m(ts:)259
-5221 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 5321
+(ends.)0 4051 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
+b(AST_EXPORT\()d(THIS,)i(STATUS)g(\))0 4190 y Fc(Argumen)m(ts:)259
+4316 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 4416
y Fj(Ob)5 b(ject)28 b(p)r(oin)n(ter)f(to)g(b)r(e)h(exp)r(orted.)259
-5455 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 5554 y Fj(The)c(global)e(status.)0 5718
-y Fc(Class)31 b(Applicabilit)m(y:)p eop end
-%%Page: 223 233
-TeXDict begin 223 232 bop 3643 52 a FG(223)259 351 y
-Fc(Ob)5 b(ject)427 451 y Fj(This)28 b(routine)f(applies)g(to)h(all)f
-(Ob)5 b(jects.)0 606 y Fc(Notes:)340 881 y Fi(\017)45
-b Fj(It)23 b(is)g(only)g(sensible)f(to)h(apply)g(this)g(routine)f(to)h
-(p)r(oin)n(ters)f(that)h(ha)n(v)n(e)f(b)r(een)h(created)f(within)i
-(\(or)e(exp)r(orted)427 981 y(to\))k(the)h(curren)n(t)e(con)n(text)g
-(and)h(ha)n(v)n(e)f(not)h(b)r(een)g(rendered)g(exempt)g(using)g(AST)p
-Ft(_)p Fj(EXEMPT.)e(Applying)427 1080 y(it)k(to)g(an)f(unsuitable)h(Ob)
+4538 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 4638 y Fj(The)c(global)e(status.)0 4789
+y Fc(Class)31 b(Applicabilit)m(y:)259 4915 y(Ob)5 b(ject)427
+5015 y Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5
+b(jects.)0 5166 y Fc(Notes:)340 5438 y Fi(\017)45 b Fj(It)23
+b(is)g(only)g(sensible)f(to)h(apply)g(this)g(routine)f(to)h(p)r(oin)n
+(ters)f(that)h(ha)n(v)n(e)f(b)r(een)h(created)f(within)i(\(or)e(exp)r
+(orted)427 5538 y(to\))k(the)h(curren)n(t)e(con)n(text)g(and)h(ha)n(v)n
+(e)f(not)h(b)r(een)g(rendered)g(exempt)g(using)g(AST)p
+Ft(_)p Fj(EXEMPT.)e(Applying)427 5637 y(it)k(to)g(an)f(unsuitable)h(Ob)
5 b(ject)27 b(p)r(oin)n(ter)g(has)g(no)h(e\013ect.)p
-0 1265 3780 12 v 0 1396 a FA(AST)p Fe(_)p FA(FINDFITS)1321
-1397 y Fd(Find)39 b(a)f(FITS)i(card)e(in)g(a)1341 1496
-y(FitsChan)f(b)m(y)i(k)m(eyw)m(ord)2802 1396 y FA(AST)p
-Fe(_)p FA(FINDFITS)0 1671 y Fc(Description:)44 b Fj(This)33
-b(function)f(searc)n(hes)f(for)g(a)h(card)g(in)g(a)g(FitsChan)g(b)n(y)g
-(k)n(eyw)n(ord.)49 b(The)32 b(searc)n(h)f(commences)h(at)227
-1770 y(the)k(curren)n(t)e(card)g(\(iden)n(ti\014ed)i(b)n(y)f(the)g
-(Card)f(attribute\))i(and)f(ends)g(when)g(a)f(card)h(is)g(found)g
-(whose)f(FITS)227 1870 y(k)n(eyw)n(ord)25 b(matc)n(hes)h(the)g
-(template)h(supplied,)g(or)f(when)g(the)h(last)f(card)g(in)g(the)h
-(FitsChan)f(has)g(b)r(een)h(searc)n(hed.)227 1991 y(If)33
-b(the)f(searc)n(h)e(is)i(successful)g(\(i.e.)50 b(a)32
-b(card)f(is)h(found)g(whic)n(h)g(matc)n(hes)g(the)g(template\),)i(the)e
-(con)n(ten)n(ts)f(of)h(the)227 2091 y(card)j(are)f(returned)h(and)g
-(the)g(Card)g(attribute)g(is)g(adjusted)h(to)f(iden)n(tify)h(the)f
-(card)g(found)g(or,)i(if)f(required,)227 2190 y(the)e(one)f(follo)n
-(wing)g(it.)54 b(If)34 b(the)g(searc)n(h)e(is)h(not)h(successful,)g
-(the)g(function)g(returns)f(.F)-9 b(ALSE.)33 b(and)h(the)f(Card)227
-2290 y(attribute)28 b(is)g(set)f(to)h(the)g Ft(")p Fj(end-of-\014le)p
-Ft(")p Fj(.)0 2432 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
+eop end
+%%Page: 224 234
+TeXDict begin 224 233 bop 0 52 a FG(224)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(FINDFITS)1321 483 y Fd(Find)39
+b(a)f(FITS)i(card)e(in)g(a)1341 583 y(FitsChan)f(b)m(y)i(k)m(eyw)m(ord)
+2802 482 y FA(AST)p Fe(_)p FA(FINDFITS)0 765 y Fc(Description:)44
+b Fj(This)33 b(function)f(searc)n(hes)f(for)g(a)h(card)g(in)g(a)g
+(FitsChan)g(b)n(y)g(k)n(eyw)n(ord.)49 b(The)32 b(searc)n(h)f(commences)
+h(at)227 865 y(the)k(curren)n(t)e(card)g(\(iden)n(ti\014ed)i(b)n(y)f
+(the)g(Card)f(attribute\))i(and)f(ends)g(when)g(a)f(card)h(is)g(found)g
+(whose)f(FITS)227 964 y(k)n(eyw)n(ord)25 b(matc)n(hes)h(the)g(template)
+h(supplied,)g(or)f(when)g(the)h(last)f(card)g(in)g(the)h(FitsChan)f
+(has)g(b)r(een)h(searc)n(hed.)227 1087 y(If)33 b(the)f(searc)n(h)e(is)i
+(successful)g(\(i.e.)50 b(a)32 b(card)f(is)h(found)g(whic)n(h)g(matc)n
+(hes)g(the)g(template\),)i(the)e(con)n(ten)n(ts)f(of)h(the)227
+1187 y(card)j(are)f(returned)h(and)g(the)g(Card)g(attribute)g(is)g
+(adjusted)h(to)f(iden)n(tify)h(the)f(card)g(found)g(or,)i(if)f
+(required,)227 1286 y(the)e(one)f(follo)n(wing)g(it.)54
+b(If)34 b(the)g(searc)n(h)e(is)h(not)h(successful,)g(the)g(function)g
+(returns)f(.F)-9 b(ALSE.)33 b(and)h(the)f(Card)227 1386
+y(attribute)28 b(is)g(set)f(to)h(the)g Ft(")p Fj(end-of-\014le)p
+Ft(")p Fj(.)0 1532 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
b(=)i(AST_FINDFITS\()38 b(THIS,)k(NAME,)f(CARD,)h(INC,)g(STATUS)f(\))0
-2574 y Fc(Argumen)m(ts:)259 2704 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 2803 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
-2929 y Fc(NAME)j(=)h(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 3029 y Fj(A)e(c)n(haracter)d(string)
+1678 y Fc(Argumen)m(ts:)259 1811 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 1911 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
+2041 y Fc(NAME)j(=)h(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 2140 y Fj(A)e(c)n(haracter)d(string)
h(con)n(taining)g(a)h(template)h(for)e(the)i(k)n(eyw)n(ord)d(to)i(b)r
-(e)g(found.)42 b(In)30 b(the)f(simplest)g(case,)427 3128
+(e)g(found.)42 b(In)30 b(the)f(simplest)g(case,)427 2240
y(this)34 b(should)g(simply)g(b)r(e)g(the)h(k)n(eyw)n(ord)d(name)h
(\(the)i(searc)n(h)d(is)i(case)f(insensitiv)n(e)h(and)f(trailing)h
-(spaces)427 3228 y(are)e(ignored\).)53 b(Ho)n(w)n(ev)n(er,)33
+(spaces)427 2339 y(are)e(ignored\).)53 b(Ho)n(w)n(ev)n(er,)33
b(this)g(template)h(ma)n(y)e(also)g(con)n(tain)h Ft(")p
Fj(\014eld)g(sp)r(eci\014ers)p Ft(")f Fj(whic)n(h)h(are)f(capable)427
-3327 y(of)27 b(matc)n(hing)g(a)g(range)e(of)i(c)n(haracters)e(\(see)i
+2439 y(of)27 b(matc)n(hing)g(a)g(range)e(of)i(c)n(haracters)e(\(see)i
(the)h Ft(")p Fj(Keyw)n(ord)c(T)-7 b(emplates)p Ft(")27
b Fj(section)g(for)f(details\).)37 b(In)27 b(this)427
-3427 y(case,)33 b(the)f(\014rst)g(card)f(with)i(a)f(k)n(eyw)n(ord)e
+2539 y(case,)33 b(the)f(\014rst)g(card)f(with)i(a)f(k)n(eyw)n(ord)e
(whic)n(h)i(matc)n(hes)f(the)i(template)f(will)h(b)r(e)f(found.)51
-b(T)-7 b(o)32 b(\014nd)g(the)427 3527 y(next)c(FITS)g(card)f
+b(T)-7 b(o)32 b(\014nd)g(the)427 2638 y(next)c(FITS)g(card)f
(regardless)e(of)i(its)h(k)n(eyw)n(ord,)e(y)n(ou)h(should)g(use)h(the)g
-(template)g Ft(")p Fj(\045f)p Ft(")p Fj(.)259 3652 y
+(template)g Ft(")p Fj(\045f)p Ft(")p Fj(.)259 2768 y
Fc(CARD)k(=)g(CHARA)m(CTER)f Fi(\003)h Fc(\()g(80)f(\))h(\(Returned\))
-427 3752 y Fj(A)e(c)n(haracter)e(v)-5 b(ariable)29 b(with)h(at)g(least)
+427 2868 y Fj(A)e(c)n(haracter)e(v)-5 b(ariable)29 b(with)h(at)g(least)
f(80)g(c)n(haracters)e(in)j(whic)n(h)g(the)g(FITS)g(card)f(whic)n(h)h
-(is)f(found)h(will)427 3852 y(b)r(e)e(returned.)37 b(If)28
+(is)f(found)h(will)427 2967 y(b)r(e)e(returned.)37 b(If)28
b(the)g(searc)n(h)e(is)h(not)h(successful,)f(a)g(card)g(will)h(not)g(b)
-r(e)g(returned.)259 3977 y Fc(INC)k(=)g(LOGICAL)h(\(Giv)m(en\))427
-4077 y Fj(If)c(this)f(v)-5 b(alue)28 b(is)g(.F)-9 b(ALSE.)28
+r(e)g(returned.)259 3097 y Fc(INC)k(=)g(LOGICAL)h(\(Giv)m(en\))427
+3196 y Fj(If)c(this)f(v)-5 b(alue)28 b(is)g(.F)-9 b(ALSE.)28
b(\(and)g(the)g(searc)n(h)e(is)i(successful\),)g(the)h(FitsChan's)f
-(Card)f(attribute)h(will)g(b)r(e)427 4176 y(set)e(to)g(the)g(index)g
+(Card)f(attribute)h(will)g(b)r(e)427 3296 y(set)e(to)g(the)g(index)g
(of)g(the)g(card)f(that)i(w)n(as)e(found.)36 b(If)27
b(it)f(is)g(.TR)n(UE.,)g(ho)n(w)n(ev)n(er,)e(the)i(Card)f(attribute)h
-(will)427 4276 y(b)r(e)i(incremen)n(ted)g(to)f(iden)n(tify)h(the)g
+(will)427 3396 y(b)r(e)i(incremen)n(ted)g(to)f(iden)n(tify)h(the)g
(card)f(whic)n(h)g(follo)n(ws)g(the)h(one)f(found.)259
-4402 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 4501 y Fj(The)c(global)e(status.)0 4656
-y Fc(Returned)32 b(V)-8 b(alue:)259 4785 y(AST)p Ft(_)p
-Fc(FINDFITS)33 b(=)f(LOGICAL)427 4885 y Fj(.TR)n(UE.)c(if)g(the)g
+3525 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 3625 y Fj(The)c(global)e(status.)0 3783
+y Fc(Returned)32 b(V)-8 b(alue:)259 3917 y(AST)p Ft(_)p
+Fc(FINDFITS)33 b(=)f(LOGICAL)427 4016 y Fj(.TR)n(UE.)c(if)g(the)g
(searc)n(h)e(w)n(as)g(successful,)i(otherwise)e(.F)-9
-b(ALSE..)0 5040 y Fc(Examples:)227 5173 y Fy(RESULT)46
+b(ALSE..)0 4175 y Fc(Examples:)227 4312 y Fy(RESULT)46
b(=)i(AST)p Ft(_)p Fy(FINDFITS\()c(FITSCHAN,)h('\045f',)h(CARD,)h
-(.TRUE.,)f(STATUS)g(\))427 5268 y Fj(Returns)26 b(the)g(curren)n(t)g
+(.TRUE.,)f(STATUS)g(\))427 4408 y Fj(Returns)26 b(the)g(curren)n(t)g
(card)f(in)h(a)f(FitsChan)h(and)g(adv)-5 b(ances)25 b(the)i(Card)e
-(attribute)h(to)g(iden)n(tify)g(the)g(card)427 5368 y(that)i(follo)n
+(attribute)h(to)g(iden)n(tify)g(the)g(card)427 4507 y(that)i(follo)n
(ws)f(\(the)h Ft(")p Fj(\045f)p Ft(")f Fj(template)h(matc)n(hes)f(an)n
-(y)g(k)n(eyw)n(ord\).)227 5498 y Fy(RESULT)46 b(=)i(AST)p
+(y)g(k)n(eyw)n(ord\).)227 4641 y Fy(RESULT)46 b(=)i(AST)p
Ft(_)p Fy(FINDFITS\()c(FITSCHAN,)h('BITPIX',)g(CARD,)i(.TRUE.,)f
-(STATUS)g(\))427 5593 y Fj(Searc)n(hes)34 b(a)h(FitsChan)g(for)f(a)h
+(STATUS)g(\))427 4736 y Fj(Searc)n(hes)34 b(a)h(FitsChan)g(for)f(a)h
(FITS)g(card)g(with)g(the)h Ft(")p Fj(BITPIX)p Ft(")e
-Fj(k)n(eyw)n(ord)f(and)i(returns)f(that)h(card.)427 5693
+Fj(k)n(eyw)n(ord)f(and)i(returns)f(that)h(card.)427 4836
y(The)28 b(Card)f(attribute)g(is)h(then)g(incremen)n(ted)f(to)h(iden)n
-(tify)g(the)g(card)f(that)h(follo)n(ws)e(it.)p eop end
-%%Page: 224 234
-TeXDict begin 224 233 bop 0 52 a FG(224)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)227 355 y Fy(RESULT)46
-b(=)i(AST)p Ft(_)p Fy(FINDFITS\()c(FITSCHAN,)h('COMMENT',)g(CARD,)h
-(.FALSE.,)g(STATUS)g(\))427 451 y Fj(Sets)36 b(the)f(Card)g(attribute)g
-(of)g(a)g(FitsChan)h(to)f(iden)n(tify)h(the)f(next)h(COMMENT)f(card)f
-(\(if)i(an)n(y\))f(and)427 551 y(returns)27 b(that)h(card.)227
-675 y Fy(RESULT)46 b(=)i(AST)p Ft(_)p Fy(FINDFITS\()c(FITSCHAN,)h
-('CRVAL\0451d',)g(CARD,)h(.TRUE.,)g(STATUS)g(\))427 770
-y Fj(Searc)n(hes)28 b(a)h(FitsChan)g(for)g(the)h(next)g(card)e(with)i
-(a)f(k)n(eyw)n(ord)e(of)i(the)h(form)f Ft(")p Fj(CR)-9
-b(V)g(ALi)p Ft(")29 b Fj(\(for)g(example,)427 870 y(an)n(y)k(of)h(the)f
-(k)n(eyw)n(ords)f Ft(")p Fj(CR)-9 b(V)g(AL1)p Ft(")p
-Fj(,)34 b Ft(")p Fj(CR)-9 b(V)g(AL2)p Ft(")32 b Fj(or)h
-Ft(")p Fj(CR)-9 b(V)g(AL3)p Ft(")32 b Fj(w)n(ould)h(b)r(e)h(matc)n
-(hed\).)55 b(The)33 b(card)427 969 y(found)22 b(\(if)g(an)n(y\))e(is)h
-(returned,)i(and)e(the)g(Card)f(attribute)i(is)f(then)g(incremen)n(ted)
-g(to)g(iden)n(tify)h(the)g(follo)n(wing)427 1069 y(card)27
-b(\(ready)g(to)g(searc)n(h)f(for)h(another)g(k)n(eyw)n(ord)f(with)i
-(the)g(same)f(form,)g(p)r(erhaps\).)0 1218 y Fc(Notes:)340
-1488 y Fi(\017)45 b Fj(The)23 b(searc)n(h)f(alw)n(a)n(ys)f(starts)i
+(tify)g(the)g(card)f(that)h(follo)n(ws)e(it.)227 4970
+y Fy(RESULT)46 b(=)i(AST)p Ft(_)p Fy(FINDFITS\()c(FITSCHAN,)h
+('COMMENT',)g(CARD,)h(.FALSE.,)g(STATUS)g(\))427 5065
+y Fj(Sets)36 b(the)f(Card)g(attribute)g(of)g(a)g(FitsChan)h(to)f(iden)n
+(tify)h(the)f(next)h(COMMENT)f(card)f(\(if)i(an)n(y\))f(and)427
+5165 y(returns)27 b(that)h(card.)227 5299 y Fy(RESULT)46
+b(=)i(AST)p Ft(_)p Fy(FINDFITS\()c(FITSCHAN,)h('CRVAL\0451d',)g(CARD,)h
+(.TRUE.,)g(STATUS)g(\))427 5394 y Fj(Searc)n(hes)28 b(a)h(FitsChan)g
+(for)g(the)h(next)g(card)e(with)i(a)f(k)n(eyw)n(ord)e(of)i(the)h(form)f
+Ft(")p Fj(CR)-9 b(V)g(ALi)p Ft(")29 b Fj(\(for)g(example,)427
+5494 y(an)n(y)k(of)h(the)f(k)n(eyw)n(ords)f Ft(")p Fj(CR)-9
+b(V)g(AL1)p Ft(")p Fj(,)34 b Ft(")p Fj(CR)-9 b(V)g(AL2)p
+Ft(")32 b Fj(or)h Ft(")p Fj(CR)-9 b(V)g(AL3)p Ft(")32
+b Fj(w)n(ould)h(b)r(e)h(matc)n(hed\).)55 b(The)33 b(card)427
+5593 y(found)22 b(\(if)g(an)n(y\))e(is)h(returned,)i(and)e(the)g(Card)f
+(attribute)i(is)f(then)g(incremen)n(ted)g(to)g(iden)n(tify)h(the)g
+(follo)n(wing)427 5693 y(card)27 b(\(ready)g(to)g(searc)n(h)f(for)h
+(another)g(k)n(eyw)n(ord)f(with)i(the)g(same)f(form,)g(p)r(erhaps\).)p
+eop end
+%%Page: 225 235
+TeXDict begin 225 234 bop 3643 52 a FG(225)0 351 y Fc(Notes:)340
+674 y Fi(\017)45 b Fj(The)23 b(searc)n(h)f(alw)n(a)n(ys)f(starts)i
(with)g(the)h(curren)n(t)e(card,)h(as)g(iden)n(ti\014ed)g(b)n(y)g(the)h
-(Card)e(attribute.)35 b(T)-7 b(o)23 b(ensure)427 1587
+(Card)e(attribute.)35 b(T)-7 b(o)23 b(ensure)427 774
y(y)n(ou)i(searc)n(h)g(the)h(en)n(tire)g(con)n(ten)n(ts)f(of)h(a)f
(FitsChan,)i(y)n(ou)e(should)h(\014rst)f(clear)g(the)h(Card)g
-(attribute)g(\(using)427 1687 y(AST)p Ft(_)p Fj(CLEAR\).)i(This)g
+(attribute)g(\(using)427 874 y(AST)p Ft(_)p Fj(CLEAR\).)i(This)g
(e\013ectiv)n(ely)f Ft(")p Fj(rewinds)p Ft(")f Fj(the)i(FitsChan.)340
-1807 y Fi(\017)45 b Fj(If)24 b(a)g(searc)n(h)e(is)i(unsuccessful,)g
+1027 y Fi(\017)45 b Fj(If)24 b(a)g(searc)n(h)e(is)i(unsuccessful,)g
(the)g(Card)f(attribute)h(is)g(set)f(to)h(the)g Ft(")p
Fj(end-of-\014le)p Ft(")f Fj(\(i.e.)36 b(to)23 b(one)h(more)e(than)427
-1907 y(the)28 b(n)n(um)n(b)r(er)g(of)f(cards)g(in)g(the)h(FitsChan\).)
-38 b(No)27 b(error)f(o)r(ccurs.)340 2027 y Fi(\017)45
+1127 y(the)28 b(n)n(um)n(b)r(er)g(of)f(cards)g(in)g(the)h(FitsChan\).)
+38 b(No)27 b(error)f(o)r(ccurs.)340 1280 y Fi(\017)45
b Fj(A)26 b(v)-5 b(alue)25 b(of)g(.F)-9 b(ALSE.)25 b(will)h(b)r(e)f
(returned)g(if)h(this)g(function)f(is)g(in)n(v)n(ok)n(ed)f(with)i(the)g
-(AST)f(error)f(status)h(set,)427 2126 y(or)i(if)h(it)g(should)f(fail)h
-(for)f(an)n(y)g(reason.)-2 2275 y Fc(Keyw)m(ord)33 b(T)-8
-b(emplates)n(:)227 2421 y Fj(The)32 b(templates)f(used)h(to)f(matc)n(h)
+(AST)f(error)f(status)h(set,)427 1379 y(or)i(if)h(it)g(should)f(fail)h
+(for)f(an)n(y)g(reason.)-2 1582 y Fc(Keyw)m(ord)33 b(T)-8
+b(emplates)n(:)227 1728 y Fj(The)32 b(templates)f(used)h(to)f(matc)n(h)
g(FITS)h(k)n(eyw)n(ords)d(are)i(normally)f(comp)r(osed)h(of)h(literal)e
-(c)n(haracters,)h(whic)n(h)227 2521 y(m)n(ust)f(matc)n(h)g(the)h(k)n
+(c)n(haracters,)h(whic)n(h)227 1828 y(m)n(ust)f(matc)n(h)g(the)h(k)n
(eyw)n(ord)d(exactly)h(\(apart)h(from)f(case\).)44 b(Ho)n(w)n(ev)n(er,)
29 b(a)h(template)g(ma)n(y)f(also)g(con)n(tain)h Ft(")p
-Fj(\014eld)227 2621 y(sp)r(eci\014ers)p Ft(")25 b Fj(whic)n(h)h(can)g
+Fj(\014eld)227 1927 y(sp)r(eci\014ers)p Ft(")25 b Fj(whic)n(h)h(can)g
(matc)n(h)f(a)h(range)f(of)h(p)r(ossible)f(c)n(haracters.)34
b(This)26 b(allo)n(ws)f(y)n(ou)g(to)h(searc)n(h)e(for)i(k)n(eyw)n(ords)
-227 2720 y(that)36 b(con)n(tain)f(\(for)g(example\))g(n)n(um)n(b)r
+227 2027 y(that)36 b(con)n(tain)f(\(for)g(example\))g(n)n(um)n(b)r
(ers,)i(where)e(the)h(digits)f(comprising)f(the)i(n)n(um)n(b)r(er)f
-(are)f(not)i(kno)n(wn)e(in)227 2820 y(adv)-5 b(ance.)227
-2938 y(A)30 b(\014eld)g(sp)r(eci\014er)g(starts)f(with)h(a)f
+(are)f(not)i(kno)n(wn)e(in)227 2126 y(adv)-5 b(ance.)227
+2271 y(A)30 b(\014eld)g(sp)r(eci\014er)g(starts)f(with)h(a)f
Ft(")p Fj(\045)p Ft(")h Fj(c)n(haracter.)41 b(This)30
b(is)f(follo)n(w)n(ed)g(b)n(y)h(an)f(optional)g(single)h(digit)f(\(0)h
-(to)g(9\))227 3038 y(sp)r(ecifying)e(a)f(\014eld)h(width.)37
+(to)g(9\))227 2371 y(sp)r(ecifying)e(a)f(\014eld)h(width.)37
b(Finally)-7 b(,)28 b(there)f(is)h(a)f(single)g(c)n(haracter)f(whic)n
-(h)h(sp)r(eci\014es)h(the)227 3156 y(t)n(yp)r(e)g(of)g(c)n(haracter)d
-(to)j(b)r(e)g(matc)n(hed,)f(as)g(follo)n(ws:)340 3397
+(h)h(sp)r(eci\014es)h(the)227 2516 y(t)n(yp)r(e)g(of)g(c)n(haracter)d
+(to)j(b)r(e)g(matc)n(hed,)f(as)g(follo)n(ws:)340 2838
y Fi(\017)45 b Ft(")p Fj(c)p Ft(")p Fj(:)36 b(matc)n(hes)27
-b(all)h(upp)r(er)f(case)g(letters,)340 3517 y Fi(\017)45
+b(all)h(upp)r(er)f(case)g(letters,)340 2991 y Fi(\017)45
b Ft(")p Fj(d)p Ft(")p Fj(:)37 b(matc)n(hes)27 b(all)g(decimal)g
-(digits,)340 3637 y Fi(\017)45 b Ft(")p Fj(f)p Ft(")p
+(digits,)340 3144 y Fi(\017)45 b Ft(")p Fj(f)p Ft(")p
Fj(:)39 b(matc)n(hes)29 b(all)f(c)n(haracters)f(whic)n(h)i(are)f(p)r
(ermitted)h(within)h(a)e(FITS)h(k)n(eyw)n(ord)e(\(upp)r(er)j(case)e
-(letters,)427 3737 y(digits,)g(underscores)e(and)h(h)n(yphens\).)227
-3886 y(If)j(the)f(\014eld)g(width)h(is)f(omitted,)h(the)f(\014eld)h(sp)
+(letters,)427 3244 y(digits,)g(underscores)e(and)h(h)n(yphens\).)227
+3446 y(If)j(the)f(\014eld)g(width)h(is)f(omitted,)h(the)f(\014eld)h(sp)
r(eci\014er)e(matc)n(hes)h(one)g(or)f(more)g(c)n(haracters.)39
-b(If)29 b(the)h(\014eld)f(width)227 3986 y(is)f(zero,)e(it)i(matc)n
+b(If)29 b(the)h(\014eld)f(width)227 3546 y(is)f(zero,)e(it)i(matc)n
(hes)f(zero)g(or)g(more)f(c)n(haracters.)35 b(Otherwise,)27
b(it)h(matc)n(hes)f(exactly)g(the)h(n)n(um)n(b)r(er)f(of)227
-4104 y(c)n(haracters)f(sp)r(eci\014ed.)37 b(In)27 b(addition)h(to)f
-(this:)340 4346 y Fi(\017)45 b Fj(The)c(template)g Ft(")p
+3691 y(c)n(haracters)f(sp)r(eci\014ed.)37 b(In)27 b(addition)h(to)f
+(this:)340 4013 y Fi(\017)45 b Fj(The)c(template)g Ft(")p
Fj(\045f)p Ft(")f Fj(will)h(matc)n(h)g(a)f(blank)g(FITS)h(k)n(eyw)n
(ord)e(consisting)h(of)h(8)f(spaces)g(\(as)g(w)n(ell)g(as)427
-4445 y(matc)n(hing)27 b(all)h(other)f(k)n(eyw)n(ords\).)340
-4565 y Fi(\017)45 b Fj(A)28 b(template)g(consisting)f(of)g(8)h(spaces)e
+4112 y(matc)n(hing)27 b(all)h(other)f(k)n(eyw)n(ords\).)340
+4266 y Fi(\017)45 b Fj(A)28 b(template)g(consisting)f(of)g(8)h(spaces)e
(will)i(matc)n(h)f(a)h(blank)f(k)n(eyw)n(ord)f(\(only\).)227
-4714 y(F)-7 b(or)27 b(example:)340 4956 y Fi(\017)45
+4468 y(F)-7 b(or)27 b(example:)340 4790 y Fi(\017)45
b Fj(The)28 b(template)g Ft(")p Fj(BitPix)p Ft(")e Fj(will)i(matc)n(h)f
(the)h(k)n(eyw)n(ord)e Ft(")p Fj(BITPIX)p Ft(")g Fj(only)-7
-b(.)340 5076 y Fi(\017)45 b Fj(The)27 b(template)g Ft(")p
+b(.)340 4943 y Fi(\017)45 b Fj(The)27 b(template)g Ft(")p
Fj(crpix\0451d)p Ft(")f Fj(will)h(matc)n(h)f(k)n(eyw)n(ords)f
(consisting)h(of)h Ft(")p Fj(CRPIX)p Ft(")f Fj(follo)n(w)n(ed)g(b)n(y)g
-(one)h(deci-)427 5176 y(mal)h(digit.)340 5296 y Fi(\017)45
+(one)h(deci-)427 5043 y(mal)h(digit.)340 5196 y Fi(\017)45
b Fj(The)26 b(template)f Ft(")p Fj(P\045c)p Ft(")f Fj(will)i(matc)n(h)e
(an)n(y)h(k)n(eyw)n(ord)e(starting)i(with)g Ft(")p Fj(P)p
Ft(")f Fj(and)h(follo)n(w)n(ed)f(b)n(y)h(one)g(or)f(more)427
-5395 y(letters.)340 5515 y Fi(\017)45 b Fj(The)28 b(template)g
+5296 y(letters.)340 5449 y Fi(\017)45 b Fj(The)28 b(template)g
Ft(")p Fj(E\0450f)p Ft(")e Fj(will)i(matc)n(h)f(an)n(y)g(k)n(eyw)n(ord)
f(b)r(eginning)i(with)g Ft(")p Fj(E)p Ft(")p Fj(.)340
-5635 y Fi(\017)45 b Fj(The)28 b(template)g Ft(")p Fj(\045f)p
+5602 y Fi(\017)45 b Fj(The)28 b(template)g Ft(")p Fj(\045f)p
Ft(")f Fj(will)h(matc)n(h)f(an)n(y)g(k)n(eyw)n(ord)f(at)h(all)h
(\(including)g(a)f(blank)g(one\).)p eop end
-%%Page: 225 235
-TeXDict begin 225 234 bop 3643 52 a FG(225)p 0 351 3780
-12 v 0 482 a FA(AST)p Fe(_)p FA(FINDFRAME)1434 483 y
-Fd(Find)39 b(a)f(co)s(ordinate)1346 583 y(system)g(with)g(sp)s
-(eci\014ed)1527 697 y(c)m(haracteristics)2603 482 y FA(AST)p
-Fe(_)p FA(FINDFRAME)0 874 y Fc(Description:)44 b Fj(This)24
-b(function)h(uses)e(a)h Ft(")p Fj(template)p Ft(")g Fj(F)-7
-b(rame)23 b(to)h(searc)n(h)e(another)h(F)-7 b(rame)24
-b(\(or)f(F)-7 b(rameSet\))24 b(to)g(iden)n(tify)227 973
-y(a)33 b(co)r(ordinate)f(system)i(whic)n(h)f(has)g(a)g(sp)r(eci\014ed)g
-(set)h(of)f(c)n(haracteristics.)52 b(If)33 b(a)g(suitable)h(co)r
-(ordinate)e(system)227 1073 y(can)23 b(b)r(e)h(found,)h(the)f(function)
-g(returns)e(a)i(p)r(oin)n(ter)f(to)g(a)g(F)-7 b(rameSet)23
-b(whic)n(h)h(describ)r(es)e(the)i(required)f(co)r(ordinate)227
-1173 y(system)28 b(and)f(ho)n(w)g(to)g(con)n(v)n(ert)g(co)r(ordinates)f
-(to)h(and)h(from)f(it.)227 1300 y(This)41 b(function)f(is)h(pro)n
-(vided)e(to)h(help)h(answ)n(er)d(general)h(questions)h(ab)r(out)g(co)r
-(ordinate)f(systems,)k(suc)n(h)d(as)227 1400 y(t)n(ypically)f(arise)f
-(when)h(co)r(ordinate)f(information)h(is)g(imp)r(orted)g(in)n(to)g(a)f
-(program)f(as)i(part)g(of)g(an)f(initially)227 1500 y(unkno)n(wn)27
-b(dataset.)37 b(F)-7 b(or)27 b(example:)340 1642 y Fi(\017)45
-b Fj(Is)28 b(there)f(a)g(w)n(a)n(v)n(elength)f(scale?)340
-1778 y Fi(\017)45 b Fj(Is)28 b(there)f(a)g(2-dimensional)g(co)r
-(ordinate)f(system?)340 1914 y Fi(\017)45 b Fj(Is)28
-b(there)f(a)g(celestial)g(co)r(ordinate)g(system?)340
-2050 y Fi(\017)45 b Fj(Can)28 b(I)f(plot)h(the)g(data)f(in)h(ecliptic)g
-(co)r(ordinates?)227 2219 y(Y)-7 b(ou)30 b(can)g(also)f(use)g(this)i
-(function)f(as)f(a)h(means)f(of)h(reconciling)f(a)g(user's)g
-(preference)h(for)f(a)h(particular)e(co)r(or-)227 2318
-y(dinate)k(system)f(\(for)h(example,)g(what)f(t)n(yp)r(e)h(of)g(axes)e
-(to)i(dra)n(w\))e(with)i(what)g(is)f(actually)g(p)r(ossible)g(giv)n(en)
-g(the)227 2418 y(co)r(ordinate)c(information)g(a)n(v)-5
-b(ailable.)227 2546 y(T)e(o)40 b(p)r(erform)f(a)h(searc)n(h,)h(y)n(ou)f
-(supply)g(a)f Ft(")p Fj(target)p Ft(")f Fj(F)-7 b(rame)40
-b(\(or)f(F)-7 b(rameSet\))40 b(whic)n(h)g(represen)n(ts)e(the)j(set)f
-(of)227 2645 y(co)r(ordinate)30 b(systems)g(to)g(b)r(e)i(searc)n(hed.)
-44 b(If)31 b(a)f(basic)g(F)-7 b(rame)31 b(is)f(giv)n(en)g(as)g(the)h
+%%Page: 226 236
+TeXDict begin 226 235 bop 0 52 a FG(226)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(FINDFRAME)1434 483 y Fd(Find)39
+b(a)f(co)s(ordinate)1346 583 y(system)g(with)g(sp)s(eci\014ed)1527
+697 y(c)m(haracteristics)2603 482 y FA(AST)p Fe(_)p FA(FINDFRAME)0
+874 y Fc(Description:)44 b Fj(This)24 b(function)h(uses)e(a)h
+Ft(")p Fj(template)p Ft(")g Fj(F)-7 b(rame)23 b(to)h(searc)n(h)e
+(another)h(F)-7 b(rame)24 b(\(or)f(F)-7 b(rameSet\))24
+b(to)g(iden)n(tify)227 973 y(a)33 b(co)r(ordinate)f(system)i(whic)n(h)f
+(has)g(a)g(sp)r(eci\014ed)g(set)h(of)f(c)n(haracteristics.)52
+b(If)33 b(a)g(suitable)h(co)r(ordinate)e(system)227 1073
+y(can)23 b(b)r(e)h(found,)h(the)f(function)g(returns)e(a)i(p)r(oin)n
+(ter)f(to)g(a)g(F)-7 b(rameSet)23 b(whic)n(h)h(describ)r(es)e(the)i
+(required)f(co)r(ordinate)227 1173 y(system)28 b(and)f(ho)n(w)g(to)g
+(con)n(v)n(ert)g(co)r(ordinates)f(to)h(and)h(from)f(it.)227
+1300 y(This)41 b(function)f(is)h(pro)n(vided)e(to)h(help)h(answ)n(er)d
+(general)h(questions)h(ab)r(out)g(co)r(ordinate)f(systems,)k(suc)n(h)d
+(as)227 1400 y(t)n(ypically)f(arise)f(when)h(co)r(ordinate)f
+(information)h(is)g(imp)r(orted)g(in)n(to)g(a)f(program)f(as)i(part)g
+(of)g(an)f(initially)227 1500 y(unkno)n(wn)27 b(dataset.)37
+b(F)-7 b(or)27 b(example:)340 1642 y Fi(\017)45 b Fj(Is)28
+b(there)f(a)g(w)n(a)n(v)n(elength)f(scale?)340 1778 y
+Fi(\017)45 b Fj(Is)28 b(there)f(a)g(2-dimensional)g(co)r(ordinate)f
+(system?)340 1914 y Fi(\017)45 b Fj(Is)28 b(there)f(a)g(celestial)g(co)
+r(ordinate)g(system?)340 2050 y Fi(\017)45 b Fj(Can)28
+b(I)f(plot)h(the)g(data)f(in)h(ecliptic)g(co)r(ordinates?)227
+2219 y(Y)-7 b(ou)30 b(can)g(also)f(use)g(this)i(function)f(as)f(a)h
+(means)f(of)h(reconciling)f(a)g(user's)g(preference)h(for)f(a)h
+(particular)e(co)r(or-)227 2318 y(dinate)k(system)f(\(for)h(example,)g
+(what)f(t)n(yp)r(e)h(of)g(axes)e(to)i(dra)n(w\))e(with)i(what)g(is)f
+(actually)g(p)r(ossible)g(giv)n(en)g(the)227 2418 y(co)r(ordinate)c
+(information)g(a)n(v)-5 b(ailable.)227 2546 y(T)e(o)40
+b(p)r(erform)f(a)h(searc)n(h,)h(y)n(ou)f(supply)g(a)f
+Ft(")p Fj(target)p Ft(")f Fj(F)-7 b(rame)40 b(\(or)f(F)-7
+b(rameSet\))40 b(whic)n(h)g(represen)n(ts)e(the)j(set)f(of)227
+2645 y(co)r(ordinate)30 b(systems)g(to)g(b)r(e)i(searc)n(hed.)44
+b(If)31 b(a)f(basic)g(F)-7 b(rame)31 b(is)f(giv)n(en)g(as)g(the)h
(target,)g(this)g(set)f(of)h(co)r(ordinate)227 2745 y(systems)h
(consists)g(of)h(the)g(one)f(describ)r(ed)h(b)n(y)f(this)h(F)-7
b(rame,)33 b(plus)g(all)f(other)g Ft(")p Fj(virtual)p
@@ -114030,47 +114079,47 @@ b(rame)30 b(will,)j(in)e(some)g(sense,)h(represen)n(t)427
5693 y(the)c Ft(")p Fj(closest)p Ft(")e Fj(non-virtual)h(co)r(ordinate)
f(system)i(to)f(the)h(one)f(y)n(ou)g(requested.)p eop
end
-%%Page: 226 236
-TeXDict begin 226 235 bop 0 52 a FG(226)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(TEMPLA)-8
-b(TE)33 b(=)f(INTEGER)f(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)e(to)h
-(the)h(template)g(F)-7 b(rame,)31 b(whic)n(h)f(should)g(b)r(e)h(an)f
-(instance)h(of)f(the)h(t)n(yp)r(e)g(of)f(F)-7 b(rame)30
-b(y)n(ou)g(wish)427 551 y(to)e(\014nd.)38 b(If)28 b(y)n(ou)f(w)n(an)n
-(ted)h(to)f(\014nd)i(a)e(F)-7 b(rame)27 b(describing)g(a)h(celestial)f
-(co)r(ordinate)g(system,)h(for)f(example,)427 650 y(then)h(y)n(ou)f
-(migh)n(t)h(use)f(a)g(SkyF)-7 b(rame)27 b(here.)37 b(See)27
-b(the)h Ft(")p Fj(Examples)p Ft(")e Fj(section)h(for)g(more)g(ideas.)
-259 783 y Fc(DOMAINLIST)33 b(=)f(CHARA)m(CTER)f Fi(\003)h
-Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427 883 y Fj(A)f(c)n(haracter)d
-(string)h(con)n(taining)g(a)h(comma-separated)e(list)i(of)g(F)-7
-b(rame)30 b(domains.)44 b(This)30 b(ma)n(y)f(b)r(e)i(used)427
-983 y(to)26 b(establish)f(a)g(priorit)n(y)f(order)g(for)h(the)h
-(di\013eren)n(t)f(t)n(yp)r(es)g(of)h(co)r(ordinate)e(system)h(that)h
-(migh)n(t)f(b)r(e)h(found.)427 1099 y(The)d(function)g(will)g(\014rst)f
-(try)g(to)h(\014nd)g(a)f(suitable)h(co)r(ordinate)e(system)h(whose)g
-(Domain)h(attribute)f(equals)427 1199 y(the)31 b(\014rst)g(domain)f(in)
-h(this)g(list.)47 b(If)31 b(this)g(fails,)h(the)f(second)f(domain)h(in)
-g(the)g(list)g(will)g(b)r(e)g(used,)h(and)e(so)427 1298
-y(on,)e(un)n(til)h(a)e(result)h(is)g(obtained.)38 b(A)28
-b(blank)g(domain)g(\(e.g.)38 b(t)n(w)n(o)27 b(consecutiv)n(e)g
-(commas\))g(indicates)h(that)427 1398 y(an)n(y)f(co)r(ordinate)g
-(system)g(is)g(acceptable)g(\(sub)5 b(ject)28 b(to)g(the)g(template\))g
-(regardless)d(of)j(its)f(domain.)427 1514 y(This)i(list)h(is)f
-(case-insensitiv)n(e)f(and)h(all)g(white)g(space)g(is)g(ignored.)40
-b(If)30 b(y)n(ou)e(do)h(not)g(wish)h(to)f(restrict)f(the)427
-1614 y(domain)f(in)h(this)g(w)n(a)n(y)-7 b(,)27 b(y)n(ou)g(should)g
-(supply)h(a)f(blank)g(string.)259 1747 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 1847
-y Fj(The)c(global)e(status.)0 2009 y Fc(Class)31 b(Applicabilit)m(y:)
-259 2146 y(F)-8 b(rame)427 2246 y Fj(This)28 b(function)g(applies)f(to)
-h(all)f(F)-7 b(rames.)259 2379 y Fc(F)f(rameSet)427 2479
-y Fj(If)24 b(the)f(target)g(is)g(a)g(F)-7 b(rameSet,)23
-b(the)h(p)r(ossibilit)n(y)f(exists)g(that)g(sev)n(eral)f(of)h(the)g(F)
--7 b(rames)23 b(within)g(it)h(migh)n(t)f(b)r(e)427 2578
-y(matc)n(hed)32 b(b)n(y)f(the)h(template.)49 b(Unless)32
-b(the)g(c)n(hoice)f(is)g(su\016cien)n(tly)h(restricted)f(b)n(y)g(the)h
-(DOMAINLIST)427 2678 y(string,)c(the)h(sequence)e(in)i(whic)n(h)f(F)-7
+%%Page: 227 237
+TeXDict begin 227 236 bop 3643 52 a FG(227)259 351 y
+Fc(TEMPLA)-8 b(TE)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
+451 y Fj(P)n(oin)n(ter)e(to)h(the)h(template)g(F)-7 b(rame,)31
+b(whic)n(h)f(should)g(b)r(e)h(an)f(instance)h(of)f(the)h(t)n(yp)r(e)g
+(of)f(F)-7 b(rame)30 b(y)n(ou)g(wish)427 551 y(to)e(\014nd.)38
+b(If)28 b(y)n(ou)f(w)n(an)n(ted)h(to)f(\014nd)i(a)e(F)-7
+b(rame)27 b(describing)g(a)h(celestial)f(co)r(ordinate)g(system,)h(for)
+f(example,)427 650 y(then)h(y)n(ou)f(migh)n(t)h(use)f(a)g(SkyF)-7
+b(rame)27 b(here.)37 b(See)27 b(the)h Ft(")p Fj(Examples)p
+Ft(")e Fj(section)h(for)g(more)g(ideas.)259 783 y Fc(DOMAINLIST)33
+b(=)f(CHARA)m(CTER)f Fi(\003)h Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))
+427 883 y Fj(A)f(c)n(haracter)d(string)h(con)n(taining)g(a)h
+(comma-separated)e(list)i(of)g(F)-7 b(rame)30 b(domains.)44
+b(This)30 b(ma)n(y)f(b)r(e)i(used)427 983 y(to)26 b(establish)f(a)g
+(priorit)n(y)f(order)g(for)h(the)h(di\013eren)n(t)f(t)n(yp)r(es)g(of)h
+(co)r(ordinate)e(system)h(that)h(migh)n(t)f(b)r(e)h(found.)427
+1099 y(The)d(function)g(will)g(\014rst)f(try)g(to)h(\014nd)g(a)f
+(suitable)h(co)r(ordinate)e(system)h(whose)g(Domain)h(attribute)f
+(equals)427 1199 y(the)31 b(\014rst)g(domain)f(in)h(this)g(list.)47
+b(If)31 b(this)g(fails,)h(the)f(second)f(domain)h(in)g(the)g(list)g
+(will)g(b)r(e)g(used,)h(and)e(so)427 1298 y(on,)e(un)n(til)h(a)e
+(result)h(is)g(obtained.)38 b(A)28 b(blank)g(domain)g(\(e.g.)38
+b(t)n(w)n(o)27 b(consecutiv)n(e)g(commas\))g(indicates)h(that)427
+1398 y(an)n(y)f(co)r(ordinate)g(system)g(is)g(acceptable)g(\(sub)5
+b(ject)28 b(to)g(the)g(template\))g(regardless)d(of)j(its)f(domain.)427
+1514 y(This)i(list)h(is)f(case-insensitiv)n(e)f(and)h(all)g(white)g
+(space)g(is)g(ignored.)40 b(If)30 b(y)n(ou)e(do)h(not)g(wish)h(to)f
+(restrict)f(the)427 1614 y(domain)f(in)h(this)g(w)n(a)n(y)-7
+b(,)27 b(y)n(ou)g(should)g(supply)h(a)f(blank)g(string.)259
+1747 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 1847 y Fj(The)c(global)e(status.)0 2009
+y Fc(Class)31 b(Applicabilit)m(y:)259 2146 y(F)-8 b(rame)427
+2246 y Fj(This)28 b(function)g(applies)f(to)h(all)f(F)-7
+b(rames.)259 2379 y Fc(F)f(rameSet)427 2479 y Fj(If)24
+b(the)f(target)g(is)g(a)g(F)-7 b(rameSet,)23 b(the)h(p)r(ossibilit)n(y)
+f(exists)g(that)g(sev)n(eral)f(of)h(the)g(F)-7 b(rames)23
+b(within)g(it)h(migh)n(t)f(b)r(e)427 2578 y(matc)n(hed)32
+b(b)n(y)f(the)h(template.)49 b(Unless)32 b(the)g(c)n(hoice)f(is)g
+(su\016cien)n(tly)h(restricted)f(b)n(y)g(the)h(DOMAINLIST)427
+2678 y(string,)c(the)h(sequence)e(in)i(whic)n(h)f(F)-7
b(rames)27 b(are)h(searc)n(hed)e(can)i(then)h(b)r(ecome)f(imp)r(ortan)n
(t.)38 b(In)29 b(this)f(case,)427 2777 y(the)g(searc)n(h)e(pro)r(ceeds)
h(as)g(follo)n(ws:)510 2885 y Fi(\017)45 b Fj(Eac)n(h)27
@@ -114131,11 +114180,12 @@ b(ran2\),)27 b(then)i(it)g(pro)n(vides)e(a)h(means)g(of)g(con)n(v)n
(ordinate)g(system)h(in)n(to)g(the)h(new)f(co)r(ordinate)f(system)i
(that)f(w)n(as)f(found)i(\(and)f(vice)g(v)n(ersa)p eop
end
-%%Page: 227 237
-TeXDict begin 227 236 bop 3643 52 a FG(227)427 351 y
-Fj(if)30 b(its)f(in)n(v)n(erse)e(transformation)g(is)i(selected\).)41
-b(If)29 b(it)h(is)f(used)f(as)h(a)f(F)-7 b(rame,)29 b(its)g(attributes)
-g(will)g(describ)r(e)427 451 y(the)f(new)g(co)r(ordinate)e(system.)0
+%%Page: 228 238
+TeXDict begin 228 237 bop 0 52 a FG(228)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(if)f(its)f(in)n(v)n
+(erse)e(transformation)g(is)i(selected\).)41 b(If)29
+b(it)h(is)f(used)f(as)h(a)f(F)-7 b(rame,)29 b(its)g(attributes)g(will)g
+(describ)r(e)427 451 y(the)f(new)g(co)r(ordinate)e(system.)0
614 y Fc(Examples:)227 723 y Fy(RESULT)46 b(=)i(AST)p
Ft(_)p Fy(FINDFRAME\()c(TARGET,)h(AST)p Ft(_)p Fy(FRAME\()g(3,)i(')h
(',)f(STATUS)f(\),)h(')h(',)227 822 y(STATUS)e(\))427
@@ -114233,16 +114283,16 @@ b(will)427 5593 y(alw)n(a)n(ys)e(b)r(e)j(1-dimensional,)f(but)g(will)h
(found)h(b)n(y)g(a)427 5693 y(suitable)c(Mapping)f(\(e.g.)37
b(a)27 b(P)n(ermMap\))f(whic)n(h)i(simply)g(extracts)e(the)i(\014rst)g
(axis.)p eop end
-%%Page: 228 238
-TeXDict begin 228 237 bop 0 52 a FG(228)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(If)e(w)n(e)e(had)h(w)
-n(an)n(ted)f(a)h(F)-7 b(rame)27 b(represen)n(ting)f(the)j(actual)e
-(\(1,)h(2)f(or)g(3-dimensional\))g(co)r(ordinate)g(system)427
-451 y(found,)h(w)n(e)f(could)h(set)f(the)h(Preserv)n(eAxes)d(attribute)
-j(to)g(a)f(non-zero)f(v)-5 b(alue)27 b(in)h(the)g(template.)227
-560 y Fy(RESULT)46 b(=)i(AST)p Ft(_)p Fy(FINDFRAME\()c(TARGET,)h(AST)p
-Ft(_)p Fy(SKYFRAME\()f('Permute=0',)h(STATUS)h(\),)h(')227
-659 y(',)g(STATUS)g(\))427 738 y Fj(Searc)n(hes)39 b(for)h(an)n(y)g
+%%Page: 229 239
+TeXDict begin 229 238 bop 3643 52 a FG(229)427 351 y
+Fj(If)29 b(w)n(e)e(had)h(w)n(an)n(ted)f(a)h(F)-7 b(rame)27
+b(represen)n(ting)f(the)j(actual)e(\(1,)h(2)f(or)g(3-dimensional\))g
+(co)r(ordinate)g(system)427 451 y(found,)h(w)n(e)f(could)h(set)f(the)h
+(Preserv)n(eAxes)d(attribute)j(to)g(a)f(non-zero)f(v)-5
+b(alue)27 b(in)h(the)g(template.)227 560 y Fy(RESULT)46
+b(=)i(AST)p Ft(_)p Fy(FINDFRAME\()c(TARGET,)h(AST)p Ft(_)p
+Fy(SKYFRAME\()f('Permute=0',)h(STATUS)h(\),)h(')227 659
+y(',)g(STATUS)g(\))427 738 y Fj(Searc)n(hes)39 b(for)h(an)n(y)g
(celestial)g(co)r(ordinate)f(system)h(in)h(the)g(target,)h(but)f(only)f
(\014nds)h(one)f(if)h(its)g(axes)427 838 y(are)35 b(in)i(the)f(con)n(v)
n(en)n(tional)e(\(longitude,latitude\))j(order)e(and)g(ha)n(v)n(e)g
@@ -114342,15 +114392,16 @@ b(Note)31 b(that)427 5494 y(the)i(DOMAINLIST)g(string)f(pro)n(vides)f
(enien)n(t)g(in)n(terface)h(if)g(y)n(ou)g(wish)g(to)g(searc)n(h)f
(automatically)g(for)h(another)427 5693 y(domain)27 b(if)i(the)f
(\014rst)f(searc)n(h)f(fails.)p eop end
-%%Page: 229 239
-TeXDict begin 229 238 bop 3643 52 a FG(229)340 351 y
-Fi(\017)45 b Fj(Normally)-7 b(,)29 b(a)g(template)h(will)f(only)g(matc)
-n(h)g(a)g(F)-7 b(rame)29 b(whic)n(h)g(has)g(the)g(same)g(n)n(um)n(b)r
-(er)g(of)g(axes)f(as)h(itself.)427 451 y(Ho)n(w)n(ev)n(er,)i(for)g
-(some)g(classes)f(of)h(template,)i(this)f(default)f(b)r(eha)n(viour)g
-(ma)n(y)f(b)r(e)i(c)n(hanged)f(b)n(y)g(means)g(of)427
-551 y(the)f(MinAxes,)g(MaxAxes)e(and)h(Matc)n(hEnd)g(attributes.)42
-b(In)29 b(addition,)h(the)f(b)r(eha)n(viour)f(of)h(a)g(template)427
+%%Page: 230 240
+TeXDict begin 230 239 bop 0 52 a FG(230)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(Normally)-7 b(,)29 b(a)g(template)h(will)f(only)g(matc)n(h)g(a)g
+(F)-7 b(rame)29 b(whic)n(h)g(has)g(the)g(same)g(n)n(um)n(b)r(er)g(of)g
+(axes)f(as)h(itself.)427 451 y(Ho)n(w)n(ev)n(er,)i(for)g(some)g
+(classes)f(of)h(template,)i(this)f(default)f(b)r(eha)n(viour)g(ma)n(y)f
+(b)r(e)i(c)n(hanged)f(b)n(y)g(means)g(of)427 551 y(the)f(MinAxes,)g
+(MaxAxes)e(and)h(Matc)n(hEnd)g(attributes.)42 b(In)29
+b(addition,)h(the)f(b)r(eha)n(viour)f(of)h(a)g(template)427
650 y(ma)n(y)38 b(b)r(e)h(in\015uenced)g(b)n(y)f(its)h(P)n(erm)n(ute)e
(and)i(Preserv)n(eAxes)d(attributes,)41 b(whic)n(h)e(con)n(trol)e
(whether)h(it)427 750 y(matc)n(hes)30 b(F)-7 b(rames)30
@@ -114462,13 +114513,12 @@ Ft(_)p Fj(WRITE,)g(when)h(used)f(with)g(a)g(FitsChan,)h(dep)r(ends)227
b(general,)f(ho)n(w)n(ev)n(er,)g(all)h(use)f(of)h(AST)p
Ft(_)p Fj(READ)g(is)g(destructiv)n(e,)g(so)f(that)h(FITS)p
eop end
-%%Page: 230 240
-TeXDict begin 230 239 bop 0 52 a FG(230)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)227 351 y Fj(header)21
-b(cards)g(are)g(consumed)g(in)h(the)g(pro)r(cess)f(of)h(reading)e(an)i
-(Ob)5 b(ject,)22 b(and)g(are)f(remo)n(v)n(ed)f(from)h(the)i(FitsChan)
-227 451 y(\(this)28 b(deletion)g(can)f(b)r(e)h(prev)n(en)n(ted)f(for)g
-(sp)r(eci\014c)h(cards)e(b)n(y)i(calling)f(the)h(AST)p
+%%Page: 231 241
+TeXDict begin 231 240 bop 3643 52 a FG(231)227 351 y
+Fj(header)21 b(cards)g(are)g(consumed)g(in)h(the)g(pro)r(cess)f(of)h
+(reading)e(an)i(Ob)5 b(ject,)22 b(and)g(are)f(remo)n(v)n(ed)f(from)h
+(the)i(FitsChan)227 451 y(\(this)28 b(deletion)g(can)f(b)r(e)h(prev)n
+(en)n(ted)f(for)g(sp)r(eci\014c)h(cards)e(b)n(y)i(calling)f(the)h(AST)p
Ft(_)p Fj(RET)-7 b(AINFITS)28 b(routine\).)227 580 y(If)38
b(the)f(enco)r(ding)f(in)h(use)g(allo)n(ws)f(only)g(a)h(single)f(Ob)5
b(ject)37 b(description)f(to)h(b)r(e)g(stored)f(in)h(a)g(FitsChan)g
@@ -114552,14 +114602,15 @@ Ft(")g Fj(card)g(will)h(b)r(e)g(written)f(via)g(the)h(sink)f(routine.)
36 b(Y)-7 b(ou)26 b(should)f(add)g(this)h(card)f(y)n(ourself)427
5693 y(after)j(the)g(FitsChan)f(has)g(b)r(een)h(deleted.)p
eop end
-%%Page: 231 241
-TeXDict begin 231 240 bop 3643 52 a FG(231)340 351 y
-Fi(\017)45 b Fj(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g
-(\(AST)p Ft(__)p Fj(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g
-(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 451
-y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f
-(an)n(y)g(reason.)340 596 y Fi(\017)45 b Fj(Note)36 b(that)f(the)h(n)n
-(ull)f(routine)g(AST)p Ft(_)p Fj(NULL)h(\(one)f(underscore\))f(is)h
+%%Page: 232 242
+TeXDict begin 232 241 bop 0 52 a FG(232)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
+Ft(__)p Fj(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 451 y(AST)28
+b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
+(reason.)340 596 y Fi(\017)45 b Fj(Note)36 b(that)f(the)h(n)n(ull)f
+(routine)g(AST)p Ft(_)p Fj(NULL)h(\(one)f(underscore\))f(is)h
(di\013eren)n(t)h(to)f(AST)p Ft(__)p Fj(NULL)g(\(t)n(w)n(o)427
696 y(underscores\),)26 b(whic)n(h)i(is)f(the)h(n)n(ull)g(Ob)5
b(ject)28 b(p)r(oin)n(ter.)-2 883 y Fc(Status)33 b(Handling)n(:)227
@@ -114623,37 +114674,36 @@ b(describ)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)
r(oin)n(ter)g(to)h(the)g(in)n(teger)e(inherited)i(status)f(v)-5
b(ariable:)54 b Ft(")p Fj(in)n(t)227 5631 y Fi(\003)p
Fj(status)p Ft(")p Fj(.)p eop end
-%%Page: 232 242
-TeXDict begin 232 241 bop 0 52 a FG(232)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(FLUXFRAME)1374 483 y Fd(Create)38
-b(a)g(FluxF)-10 b(rame)2576 482 y FA(AST)p Fe(_)p FA(FLUXFRAME)0
-712 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
-(FluxF)-7 b(rame)28 b(and)f(optionally)g(initialises)g(its)h
-(attributes.)227 864 y(A)c(FluxF)-7 b(rame)22 b(is)h(a)g(sp)r
-(ecialised)f(form)h(of)g(one-dimensional)e(F)-7 b(rame)23
-b(whic)n(h)g(represen)n(ts)e(v)-5 b(arious)22 b(systems)h(used)227
-964 y(to)36 b(represen)n(t)f(the)h(signal)f(lev)n(el)g(in)i(an)e
-(observ)-5 b(ation.)61 b(The)36 b(particular)e(co)r(ordinate)h(system)h
-(to)g(b)r(e)g(used)g(is)227 1063 y(sp)r(eci\014ed)31
-b(b)n(y)f(setting)h(the)g(FluxF)-7 b(rame's)30 b(System)h(attribute)g
-(quali\014ed,)g(as)f(necessary)-7 b(,)29 b(b)n(y)i(other)f(attributes)
-227 1163 y(suc)n(h)e(as)e(the)i(units,)h(etc)e(\(see)h(the)g
-(description)f(of)g(the)h(System)g(attribute)g(for)f(details\).)227
-1314 y(All)i(\015ux)f(v)-5 b(alues)28 b(are)f(assumed)g(to)h(b)r(e)h
-(measured)e(at)h(the)h(same)e(frequency)h(or)f(w)n(a)n(v)n(elength)f
-(\(as)i(giv)n(en)f(b)n(y)h(the)227 1414 y(Sp)r(ecV)-7
-b(al)28 b(attribute\).)38 b(Th)n(us)27 b(this)h(class)e(is)i(more)f
-(appropriate)f(for)h(use)g(with)h(images)f(rather)f(than)i(sp)r(ectra.)
-0 1617 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i
-(AST_FLUXFRAME\()38 b(SPECVAL,)i(SPECFRM,)g(OPTIONS,)h(STATUS)g(\))0
-1820 y Fc(Argumen)m(ts:)259 2011 y(SPECV)-11 b(AL)33
-b(=)f(DOUBLE)g(PRECISION)g(\(Giv)m(en\))427 2110 y Fj(The)37
-b(sp)r(ectral)e(v)-5 b(alue)36 b(to)g(whic)n(h)g(the)h(\015ux)f(v)-5
-b(alues)36 b(refer,)i(giv)n(en)d(in)i(the)f(sp)r(ectral)g(co)r
-(ordinate)f(system)427 2210 y(sp)r(eci\014ed)22 b(b)n(y)e(SPECFRM.)h
-(The)g(v)-5 b(alue)21 b(supplied)h(for)e(the)i(SPECV)-9
-b(AL)20 b(parameter)g(b)r(ecomes)h(the)g(default)427
+%%Page: 233 243
+TeXDict begin 233 242 bop 3643 52 a FG(233)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(FLUXFRAME)1374 483 y
+Fd(Create)38 b(a)g(FluxF)-10 b(rame)2576 482 y FA(AST)p
+Fe(_)p FA(FLUXFRAME)0 712 y Fc(Description:)44 b Fj(This)28
+b(function)g(creates)f(a)g(new)g(FluxF)-7 b(rame)28 b(and)f(optionally)
+g(initialises)g(its)h(attributes.)227 864 y(A)c(FluxF)-7
+b(rame)22 b(is)h(a)g(sp)r(ecialised)f(form)h(of)g(one-dimensional)e(F)
+-7 b(rame)23 b(whic)n(h)g(represen)n(ts)e(v)-5 b(arious)22
+b(systems)h(used)227 964 y(to)36 b(represen)n(t)f(the)h(signal)f(lev)n
+(el)g(in)i(an)e(observ)-5 b(ation.)61 b(The)36 b(particular)e(co)r
+(ordinate)h(system)h(to)g(b)r(e)g(used)g(is)227 1063
+y(sp)r(eci\014ed)31 b(b)n(y)f(setting)h(the)g(FluxF)-7
+b(rame's)30 b(System)h(attribute)g(quali\014ed,)g(as)f(necessary)-7
+b(,)29 b(b)n(y)i(other)f(attributes)227 1163 y(suc)n(h)e(as)e(the)i
+(units,)h(etc)e(\(see)h(the)g(description)f(of)g(the)h(System)g
+(attribute)g(for)f(details\).)227 1314 y(All)i(\015ux)f(v)-5
+b(alues)28 b(are)f(assumed)g(to)h(b)r(e)h(measured)e(at)h(the)h(same)e
+(frequency)h(or)f(w)n(a)n(v)n(elength)f(\(as)i(giv)n(en)f(b)n(y)h(the)
+227 1414 y(Sp)r(ecV)-7 b(al)28 b(attribute\).)38 b(Th)n(us)27
+b(this)h(class)e(is)i(more)f(appropriate)f(for)h(use)g(with)h(images)f
+(rather)f(than)i(sp)r(ectra.)0 1617 y Fc(In)m(v)m(o)s(cation:)123
+b Ft(RESULT)41 b(=)i(AST_FLUXFRAME\()38 b(SPECVAL,)i(SPECFRM,)g
+(OPTIONS,)h(STATUS)g(\))0 1820 y Fc(Argumen)m(ts:)259
+2011 y(SPECV)-11 b(AL)33 b(=)f(DOUBLE)g(PRECISION)g(\(Giv)m(en\))427
+2110 y Fj(The)37 b(sp)r(ectral)e(v)-5 b(alue)36 b(to)g(whic)n(h)g(the)h
+(\015ux)f(v)-5 b(alues)36 b(refer,)i(giv)n(en)d(in)i(the)f(sp)r(ectral)
+g(co)r(ordinate)f(system)427 2210 y(sp)r(eci\014ed)22
+b(b)n(y)e(SPECFRM.)h(The)g(v)-5 b(alue)21 b(supplied)h(for)e(the)i
+(SPECV)-9 b(AL)20 b(parameter)g(b)r(ecomes)h(the)g(default)427
2309 y(v)-5 b(alue)39 b(for)f(the)h(Sp)r(ecV)-7 b(al)39
b(attribute.)71 b(A)39 b(v)-5 b(alue)38 b(of)h(AST)p
Ft(__)p Fj(BAD)g(ma)n(y)f(b)r(e)h(supplied)g(if)g(the)g(sp)r(ectral)427
@@ -114704,10 +114754,11 @@ Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 5600
y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
(fail)h(for)f(an)n(y)g(reason.)p eop end
-%%Page: 233 243
-TeXDict begin 233 242 bop 3643 52 a FG(233)p 0 351 3780
-12 v 0 482 a FA(AST)p Fe(_)p FA(F)l(ORMA)-11 b(T)1078
-483 y Fd(F)h(ormat)37 b(a)i(co)s(ordinate)d(v)-7 b(alue)38
+%%Page: 234 244
+TeXDict begin 234 243 bop 0 52 a FG(234)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(F)l(ORMA)-11 b(T)1078 483
+y Fd(F)h(ormat)37 b(a)i(co)s(ordinate)d(v)-7 b(alue)38
b(for)g(a)1611 583 y(F)-10 b(rame)38 b(axis)2855 482
y FA(AST)p Fe(_)p FA(F)l(ORMA)-11 b(T)0 760 y Fc(Description:)44
b Fj(This)26 b(function)h(returns)e(a)h(c)n(haracter)e(string)h(con)n
@@ -114774,74 +114825,73 @@ y Fj(The)c(n)n(um)n(b)r(er)f(of)h(F)-7 b(rame)26 b(axes)g(\(i.e.)37
b(the)27 b(n)n(um)n(b)r(er)f(of)h(dimensions)f(of)g(the)h(co)r
(ordinate)f(space)g(whic)n(h)g(the)427 5693 y(F)-7 b(rame)27
b(describ)r(es\).)p eop end
-%%Page: 234 244
-TeXDict begin 234 243 bop 0 52 a FG(234)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(OPTIONS)h(=)g(CHARA)m
-(CTER)g Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-451 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h(optional)g
-(comma-separated)e(list)j(of)g(attribute)f(assignmen)n(ts)g(to)427
-551 y(b)r(e)25 b(used)f(for)f(initialising)h(the)g(new)h(F)-7
-b(rame.)35 b(The)24 b(syn)n(tax)f(used)h(is)g(iden)n(tical)g(to)g(that)
-g(for)g(the)g(AST)p Ft(_)p Fj(SET)427 650 y(routine.)37
-b(If)28 b(no)f(initialisation)g(is)h(required,)e(a)i(blank)f(v)-5
-b(alue)27 b(ma)n(y)g(b)r(e)h(supplied.)259 788 y Fc(ST)-8
-b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-888 y Fj(The)c(global)e(status.)0 1060 y Fc(Returned)32
-b(V)-8 b(alue:)259 1206 y(AST)p Ft(_)p Fc(FRAME)31 b(=)h(INTEGER)427
-1306 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(F)-7 b(rame.)0
-1478 y Fc(Examples:)227 1625 y Fy(FRAME)47 b(=)g(AST)p
-Ft(_)p Fy(FRAME\()e(2,)i('Title=Energy)d(Spectrum',)h(STATUS)h(\);)427
-1724 y Fj(Creates)31 b(a)g(new)h(2-dimensional)e(F)-7
-b(rame)31 b(and)h(initialises)f(its)h(Title)g(attribute)g(to)g(the)g
-(string)f Ft(")p Fj(Energy)427 1824 y(Sp)r(ectrum)p Ft(")p
-Fj(.)227 1962 y Fy(FRAME)47 b(=)g(AST)p Ft(_)p Fy(FRAME\()e(2,)i
-('Label\(1\)=Energy,)c(Label\(2\)=Response',)g(STATUS)j(\);)427
-2061 y Fj(Creates)26 b(a)g(new)h(2-dimensional)e(F)-7
-b(rame)26 b(and)g(initialises)h(its)f(axis)g(Lab)r(el)h(attributes)f
-(to)h(suitable)f(string)427 2161 y(v)-5 b(alues.)0 2333
-y Fc(Notes:)340 2625 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
-b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
-(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 2725 y(set)28 b(to)f(an)h(error)d(v)-5
-b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-0 2934 3780 12 v 0 3065 a FA(AST)p Fe(_)p FA(FRAMESET)318
-b Fd(Create)37 b(a)i(F)-10 b(rameSet)319 b FA(AST)p Fe(_)p
-FA(FRAMESET)0 3252 y Fc(Description:)44 b Fj(This)28
-b(function)g(creates)f(a)g(new)g(F)-7 b(rameSet)28 b(and)f(optionally)g
-(initialises)g(its)h(attributes.)227 3381 y(A)23 b(F)-7
-b(rameSet)23 b(consists)e(of)i(a)f(set)h(of)f(one)h(or)e(more)h(F)-7
-b(rames)22 b(\(whic)n(h)h(describ)r(e)f(co)r(ordinate)f(systems\),)j
-(connected)227 3481 y(together)j(b)n(y)g(Mappings)f(\(whic)n(h)i
-(describ)r(e)e(ho)n(w)h(the)h(co)r(ordinate)e(systems)g(are)h(in)n
-(ter-related\).)35 b(A)28 b(F)-7 b(rameSet)227 3581 y(mak)n(es)28
-b(it)i(p)r(ossible)e(to)h(obtain)g(a)f(Mapping)h(b)r(et)n(w)n(een)g(an)
-n(y)f(pair)g(of)h(these)g(F)-7 b(rames)28 b(\(i.e.)41
-b(to)29 b(con)n(v)n(ert)f(b)r(et)n(w)n(een)227 3680 y(an)n(y)e(of)g
-(the)g(co)r(ordinate)f(systems)h(whic)n(h)g(it)g(describ)r(es\).)36
-b(The)26 b(individual)h(F)-7 b(rames)25 b(are)g(iden)n(ti\014ed)h
-(within)h(the)227 3780 y(F)-7 b(rameSet)34 b(b)n(y)g(an)f(in)n(teger)g
-(index,)j(with)e(F)-7 b(rames)34 b(b)r(eing)g(n)n(um)n(b)r(ered)f
-(consecutiv)n(ely)g(from)h(one)f(as)g(they)i(are)227
-3880 y(added)28 b(to)f(the)h(F)-7 b(rameSet.)227 4009
-y(Ev)n(ery)29 b(F)-7 b(rameSet)30 b(has)f(a)h Ft(")p
-Fj(base)p Ft(")e Fj(F)-7 b(rame)30 b(and)g(a)g Ft(")p
-Fj(curren)n(t)p Ft(")e Fj(F)-7 b(rame)30 b(\(whic)n(h)g(are)f(allo)n(w)
-n(ed)g(to)h(b)r(e)g(the)h(same\).)227 4109 y(An)n(y)k(of)g(the)g(F)-7
-b(rames)35 b(ma)n(y)f(b)r(e)h(nominated)g(to)g(hold)f(these)h(p)r
-(ositions,)i(and)e(the)g(c)n(hoice)f(is)h(determined)g(b)n(y)227
-4208 y(the)d(v)-5 b(alues)31 b(of)h(the)g(F)-7 b(rameSet's)31
-b(Base)f(and)i(Curren)n(t)e(attributes,)j(whic)n(h)e(hold)h(the)f
-(indices)h(of)f(the)h(relev)-5 b(an)n(t)227 4308 y(F)e(rames.)35
-b(By)25 b(default,)h(the)f(\014rst)f(F)-7 b(rame)25 b(added)f(to)h(a)f
-(F)-7 b(rameSet)25 b(is)f(its)h(base)f(F)-7 b(rame,)25
-b(and)g(the)g(last)f(one)h(added)227 4408 y(is)j(its)g(curren)n(t)e(F)
--7 b(rame.)227 4537 y(The)36 b(base)f(F)-7 b(rame)35
-b(describ)r(es)h(the)g Ft(")p Fj(nativ)n(e)p Ft(")e Fj(co)r(ordinate)h
-(system)g(of)h(whatev)n(er)f(the)h(F)-7 b(rameSet)35
-b(is)h(used)g(to)227 4637 y(calibrate)27 b(\(e.g.)36
-b(the)28 b(pixel)f(co)r(ordinates)f(of)i(an)f(image\))g(and)g(the)h
-(curren)n(t)e(F)-7 b(rame)27 b(describ)r(es)g(the)h Ft(")p
-Fj(apparen)n(t)p Ft(")227 4736 y Fj(co)r(ordinate)21
+%%Page: 235 245
+TeXDict begin 235 244 bop 3643 52 a FG(235)259 351 y
+Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 451 y Fj(A)g(c)n(haracter)e(string)h
+(con)n(taining)f(an)h(optional)g(comma-separated)e(list)j(of)g
+(attribute)f(assignmen)n(ts)g(to)427 551 y(b)r(e)25 b(used)f(for)f
+(initialising)h(the)g(new)h(F)-7 b(rame.)35 b(The)24
+b(syn)n(tax)f(used)h(is)g(iden)n(tical)g(to)g(that)g(for)g(the)g(AST)p
+Ft(_)p Fj(SET)427 650 y(routine.)37 b(If)28 b(no)f(initialisation)g(is)
+h(required,)e(a)i(blank)f(v)-5 b(alue)27 b(ma)n(y)g(b)r(e)h(supplied.)
+259 788 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 888 y Fj(The)c(global)e(status.)0 1060
+y Fc(Returned)32 b(V)-8 b(alue:)259 1206 y(AST)p Ft(_)p
+Fc(FRAME)31 b(=)h(INTEGER)427 1306 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g
+(new)g(F)-7 b(rame.)0 1478 y Fc(Examples:)227 1625 y
+Fy(FRAME)47 b(=)g(AST)p Ft(_)p Fy(FRAME\()e(2,)i('Title=Energy)d
+(Spectrum',)h(STATUS)h(\);)427 1724 y Fj(Creates)31 b(a)g(new)h
+(2-dimensional)e(F)-7 b(rame)31 b(and)h(initialises)f(its)h(Title)g
+(attribute)g(to)g(the)g(string)f Ft(")p Fj(Energy)427
+1824 y(Sp)r(ectrum)p Ft(")p Fj(.)227 1962 y Fy(FRAME)47
+b(=)g(AST)p Ft(_)p Fy(FRAME\()e(2,)i('Label\(1\)=Energy,)c
+(Label\(2\)=Response',)g(STATUS)j(\);)427 2061 y Fj(Creates)26
+b(a)g(new)h(2-dimensional)e(F)-7 b(rame)26 b(and)g(initialises)h(its)f
+(axis)g(Lab)r(el)h(attributes)f(to)h(suitable)f(string)427
+2161 y(v)-5 b(alues.)0 2333 y Fc(Notes:)340 2625 y Fi(\017)45
+b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
+Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 2725
+y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 2934 3780 12 v 0 3065
+a FA(AST)p Fe(_)p FA(FRAMESET)318 b Fd(Create)37 b(a)i(F)-10
+b(rameSet)319 b FA(AST)p Fe(_)p FA(FRAMESET)0 3252 y
+Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g(F)-7
+b(rameSet)28 b(and)f(optionally)g(initialises)g(its)h(attributes.)227
+3381 y(A)23 b(F)-7 b(rameSet)23 b(consists)e(of)i(a)f(set)h(of)f(one)h
+(or)e(more)h(F)-7 b(rames)22 b(\(whic)n(h)h(describ)r(e)f(co)r
+(ordinate)f(systems\),)j(connected)227 3481 y(together)j(b)n(y)g
+(Mappings)f(\(whic)n(h)i(describ)r(e)e(ho)n(w)h(the)h(co)r(ordinate)e
+(systems)g(are)h(in)n(ter-related\).)35 b(A)28 b(F)-7
+b(rameSet)227 3581 y(mak)n(es)28 b(it)i(p)r(ossible)e(to)h(obtain)g(a)f
+(Mapping)h(b)r(et)n(w)n(een)g(an)n(y)f(pair)g(of)h(these)g(F)-7
+b(rames)28 b(\(i.e.)41 b(to)29 b(con)n(v)n(ert)f(b)r(et)n(w)n(een)227
+3680 y(an)n(y)e(of)g(the)g(co)r(ordinate)f(systems)h(whic)n(h)g(it)g
+(describ)r(es\).)36 b(The)26 b(individual)h(F)-7 b(rames)25
+b(are)g(iden)n(ti\014ed)h(within)h(the)227 3780 y(F)-7
+b(rameSet)34 b(b)n(y)g(an)f(in)n(teger)g(index,)j(with)e(F)-7
+b(rames)34 b(b)r(eing)g(n)n(um)n(b)r(ered)f(consecutiv)n(ely)g(from)h
+(one)f(as)g(they)i(are)227 3880 y(added)28 b(to)f(the)h(F)-7
+b(rameSet.)227 4009 y(Ev)n(ery)29 b(F)-7 b(rameSet)30
+b(has)f(a)h Ft(")p Fj(base)p Ft(")e Fj(F)-7 b(rame)30
+b(and)g(a)g Ft(")p Fj(curren)n(t)p Ft(")e Fj(F)-7 b(rame)30
+b(\(whic)n(h)g(are)f(allo)n(w)n(ed)g(to)h(b)r(e)g(the)h(same\).)227
+4109 y(An)n(y)k(of)g(the)g(F)-7 b(rames)35 b(ma)n(y)f(b)r(e)h
+(nominated)g(to)g(hold)f(these)h(p)r(ositions,)i(and)e(the)g(c)n(hoice)
+f(is)h(determined)g(b)n(y)227 4208 y(the)d(v)-5 b(alues)31
+b(of)h(the)g(F)-7 b(rameSet's)31 b(Base)f(and)i(Curren)n(t)e
+(attributes,)j(whic)n(h)e(hold)h(the)f(indices)h(of)f(the)h(relev)-5
+b(an)n(t)227 4308 y(F)e(rames.)35 b(By)25 b(default,)h(the)f(\014rst)f
+(F)-7 b(rame)25 b(added)f(to)h(a)f(F)-7 b(rameSet)25
+b(is)f(its)h(base)f(F)-7 b(rame,)25 b(and)g(the)g(last)f(one)h(added)
+227 4408 y(is)j(its)g(curren)n(t)e(F)-7 b(rame.)227 4537
+y(The)36 b(base)f(F)-7 b(rame)35 b(describ)r(es)h(the)g
+Ft(")p Fj(nativ)n(e)p Ft(")e Fj(co)r(ordinate)h(system)g(of)h(whatev)n
+(er)f(the)h(F)-7 b(rameSet)35 b(is)h(used)g(to)227 4637
+y(calibrate)27 b(\(e.g.)36 b(the)28 b(pixel)f(co)r(ordinates)f(of)i(an)
+f(image\))g(and)g(the)h(curren)n(t)e(F)-7 b(rame)27 b(describ)r(es)g
+(the)h Ft(")p Fj(apparen)n(t)p Ft(")227 4736 y Fj(co)r(ordinate)21
b(system)g(in)h(whic)n(h)g(it)g(should)f(b)r(e)h(view)n(ed)g(\(e.g.)34
b(displa)n(y)n(ed,)22 b(etc.\).)36 b(An)n(y)21 b(further)h(F)-7
b(rames)21 b(represen)n(t)227 4836 y(a)27 b(library)g(of)g(alternativ)n
@@ -114867,20 +114917,21 @@ g(AST)p Ft(_)p Fj(INVER)-7 b(T\),)34 b(whic)n(h)f(has)g(the)h(e\013ect)
g(of)f(in)n(terc)n(hanging)e(its)j(base)f(and)g(curren)n(t)f(F)-7
b(rames)227 5693 y(and)28 b(hence)f(of)h(rev)n(ersing)d(the)j(Mapping)g
(b)r(et)n(w)n(een)f(them.)p eop end
-%%Page: 235 245
-TeXDict begin 235 244 bop 3643 52 a FG(235)227 351 y
-Fj(Regions)33 b(ma)n(y)f(b)r(e)i(added)f(in)n(to)h(a)f(F)-7
-b(rameSet)33 b(\(since)g(a)g(Region)g(is)g(a)g(t)n(yp)r(e)h(of)f(F)-7
-b(rame\),)35 b(either)e(explicitly)g(or)227 451 y(as)e(comp)r(onen)n
-(ts)g(within)h(CmpF)-7 b(rames.)48 b(In)31 b(this)h(case)e(the)i
-(Mapping)f(b)r(et)n(w)n(een)g(a)g(pair)g(of)g(F)-7 b(rames)31
-b(within)h(a)227 551 y(F)-7 b(rameSet)35 b(will)g(include)g(the)h
-(e\013ects)f(of)g(the)g(clipping)g(pro)r(duced)g(b)n(y)f(an)n(y)h
-(Regions)f(included)h(in)g(the)g(path)227 650 y(b)r(et)n(w)n(een)28
-b(the)g(F)-7 b(rames.)0 799 y Fc(In)m(v)m(o)s(cation:)123
-b Ft(RESULT)41 b(=)i(AST_FRAMESET\()38 b(FRAME,)j(OPTIONS,)g(STATUS)g
-(\))0 947 y Fc(Argumen)m(ts:)259 1083 y(FRAME)31 b(=)h(INTEGER)g(\(Giv)
-m(en\))427 1183 y Fj(P)n(oin)n(ter)27 b(to)h(the)g(\014rst)g(F)-7
+%%Page: 236 246
+TeXDict begin 236 245 bop 0 52 a FG(236)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)227 351 y Fj(Regions)i(ma)n(y)f(b)
+r(e)i(added)f(in)n(to)h(a)f(F)-7 b(rameSet)33 b(\(since)g(a)g(Region)g
+(is)g(a)g(t)n(yp)r(e)h(of)f(F)-7 b(rame\),)35 b(either)e(explicitly)g
+(or)227 451 y(as)e(comp)r(onen)n(ts)g(within)h(CmpF)-7
+b(rames.)48 b(In)31 b(this)h(case)e(the)i(Mapping)f(b)r(et)n(w)n(een)g
+(a)g(pair)g(of)g(F)-7 b(rames)31 b(within)h(a)227 551
+y(F)-7 b(rameSet)35 b(will)g(include)g(the)h(e\013ects)f(of)g(the)g
+(clipping)g(pro)r(duced)g(b)n(y)f(an)n(y)h(Regions)f(included)h(in)g
+(the)g(path)227 650 y(b)r(et)n(w)n(een)28 b(the)g(F)-7
+b(rames.)0 799 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
+b(=)i(AST_FRAMESET\()38 b(FRAME,)j(OPTIONS,)g(STATUS)g(\))0
+947 y Fc(Argumen)m(ts:)259 1083 y(FRAME)31 b(=)h(INTEGER)g(\(Giv)m
+(en\))427 1183 y Fj(P)n(oin)n(ter)27 b(to)h(the)g(\014rst)g(F)-7
b(rame)28 b(to)g(b)r(e)g(inserted)g(in)n(to)g(the)g(F)-7
b(rameSet.)39 b(This)28 b(initially)g(b)r(ecomes)g(b)r(oth)g(the)427
1282 y(base)j(and)h(the)g(curren)n(t)f(F)-7 b(rame.)48
@@ -114946,41 +114997,41 @@ n(ting)g(o\013set)h(along)427 5593 y(the)31 b(required)d(curv)n(e,)i
g(at)h(o\013set)g(1.0.)51 b(Note,)34 b(this)f(o\013set)f(do)r(es)h(not)
f(need)h(to)g(b)r(e)g(linearly)e(related)h(to)h(distance)p
eop end
-%%Page: 236 246
-TeXDict begin 236 245 bop 0 52 a FG(236)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(along)e(the)h(curv)n
-(e.)42 b(The)30 b(n)n(um)n(b)r(er)f(of)h(output)g(co)r(ordinates)f
-(should)g(equal)g(the)h(n)n(um)n(b)r(er)g(of)f(axes)g(in)h(the)427
-451 y(curren)n(t)e(F)-7 b(rame)28 b(of)h(the)g(Plot.)39
-b(The)29 b(Mapping)f(should)g(map)h(a)f(sp)r(eci\014ed)h(o\013set)f
-(along)g(the)h(curv)n(e,)f(in)n(to)427 551 y(the)h(corresp)r(onding)e
-(co)r(ordinates)g(in)i(the)h(curren)n(t)d(F)-7 b(rame)29
-b(of)f(the)h(Plot.)40 b(The)29 b(in)n(v)n(erse)e(transformation)427
-650 y(need)h(not)g(b)r(e)g(de\014ned.)259 785 y Fc(ST)-8
-b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-885 y Fj(The)c(global)e(status.)0 1051 y Fc(Notes:)340
-1337 y Fi(\017)45 b Fj(An)28 b(error)e(results)h(if)h(the)g(base)f(F)-7
-b(rame)27 b(of)h(the)g(Plot)f(is)g(not)h(2-dimensional.)340
-1472 y Fi(\017)45 b Fj(An)30 b(error)d(also)g(results)i(if)g(the)g
-(transformation)f(b)r(et)n(w)n(een)h(the)g(curren)n(t)f(and)h(base)f(F)
--7 b(rames)28 b(of)h(the)g(Plot)427 1572 y(is)f(not)f(de\014ned)h
-(\(i.e.)38 b(the)28 b(Plot's)e(T)-7 b(ranIn)n(v)n(erse)26
-b(attribute)h(is)h(zero\).)p 0 1775 3780 12 v 0 1906
-a FA(AST)p Fe(_)p FA(GET)p Fb(<)p FA(X)p Fb(>)1145 1907
-y Fd(Get)38 b(an)h(attribute)d(v)-7 b(alue)38 b(for)g(an)1716
-2007 y(Ob)7 b(ject)2877 1906 y FA(AST)p Fe(_)p FA(GET)p
-Fb(<)p FA(X)p Fb(>)0 2200 y Fc(Description:)44 b Fj(This)29
-b(is)f(a)g(family)g(of)h(functions)f(whic)n(h)h(return)f(a)f(sp)r
-(eci\014ed)i(attribute)g(v)-5 b(alue)28 b(for)g(an)g(Ob)5
-b(ject)28 b(using)227 2299 y(one)c(of)h(sev)n(eral)e(di\013eren)n(t)h
-(data)g(t)n(yp)r(es.)36 b(The)25 b(t)n(yp)r(e)f(is)h(selected)f(b)n(y)g
-(replacing)g Fl(<)p Fj(X)p Fl(>)g Fj(in)h(the)f(function)i(name)e(b)n
-(y)227 2399 y(C,)j(D,)g(I,)g(L)f(or)g(R,)h(to)f(obtain)g(a)h(result)f
-(in)h(Character,)e(Double)h(precision,)g(In)n(teger,)g(Logical)f(or)h
-(Real)g(format,)227 2499 y(resp)r(ectiv)n(ely)-7 b(.)227
-2625 y(If)30 b(p)r(ossible,)f(the)h(attribute)g(v)-5
-b(alue)29 b(is)g(con)n(v)n(erted)f(to)h(the)g(t)n(yp)r(e)h(y)n(ou)e
-(request.)42 b(If)29 b(con)n(v)n(ersion)e(is)j(not)f(p)r(ossible,)227
+%%Page: 237 247
+TeXDict begin 237 246 bop 3643 52 a FG(237)427 351 y
+Fj(along)29 b(the)h(curv)n(e.)42 b(The)30 b(n)n(um)n(b)r(er)f(of)h
+(output)g(co)r(ordinates)f(should)g(equal)g(the)h(n)n(um)n(b)r(er)g(of)
+f(axes)g(in)h(the)427 451 y(curren)n(t)e(F)-7 b(rame)28
+b(of)h(the)g(Plot.)39 b(The)29 b(Mapping)f(should)g(map)h(a)f(sp)r
+(eci\014ed)h(o\013set)f(along)g(the)h(curv)n(e,)f(in)n(to)427
+551 y(the)h(corresp)r(onding)e(co)r(ordinates)g(in)i(the)h(curren)n(t)d
+(F)-7 b(rame)29 b(of)f(the)h(Plot.)40 b(The)29 b(in)n(v)n(erse)e
+(transformation)427 650 y(need)h(not)g(b)r(e)g(de\014ned.)259
+785 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 885 y Fj(The)c(global)e(status.)0 1051
+y Fc(Notes:)340 1337 y Fi(\017)45 b Fj(An)28 b(error)e(results)h(if)h
+(the)g(base)f(F)-7 b(rame)27 b(of)h(the)g(Plot)f(is)g(not)h
+(2-dimensional.)340 1472 y Fi(\017)45 b Fj(An)30 b(error)d(also)g
+(results)i(if)g(the)g(transformation)f(b)r(et)n(w)n(een)h(the)g(curren)
+n(t)f(and)h(base)f(F)-7 b(rames)28 b(of)h(the)g(Plot)427
+1572 y(is)f(not)f(de\014ned)h(\(i.e.)38 b(the)28 b(Plot's)e(T)-7
+b(ranIn)n(v)n(erse)26 b(attribute)h(is)h(zero\).)p 0
+1775 3780 12 v 0 1906 a FA(AST)p Fe(_)p FA(GET)p Fb(<)p
+FA(X)p Fb(>)1145 1907 y Fd(Get)38 b(an)h(attribute)d(v)-7
+b(alue)38 b(for)g(an)1716 2007 y(Ob)7 b(ject)2877 1906
+y FA(AST)p Fe(_)p FA(GET)p Fb(<)p FA(X)p Fb(>)0 2200
+y Fc(Description:)44 b Fj(This)29 b(is)f(a)g(family)g(of)h(functions)f
+(whic)n(h)h(return)f(a)f(sp)r(eci\014ed)i(attribute)g(v)-5
+b(alue)28 b(for)g(an)g(Ob)5 b(ject)28 b(using)227 2299
+y(one)c(of)h(sev)n(eral)e(di\013eren)n(t)h(data)g(t)n(yp)r(es.)36
+b(The)25 b(t)n(yp)r(e)f(is)h(selected)f(b)n(y)g(replacing)g
+Fl(<)p Fj(X)p Fl(>)g Fj(in)h(the)f(function)i(name)e(b)n(y)227
+2399 y(C,)j(D,)g(I,)g(L)f(or)g(R,)h(to)f(obtain)g(a)h(result)f(in)h
+(Character,)e(Double)h(precision,)g(In)n(teger,)g(Logical)f(or)h(Real)g
+(format,)227 2499 y(resp)r(ectiv)n(ely)-7 b(.)227 2625
+y(If)30 b(p)r(ossible,)f(the)h(attribute)g(v)-5 b(alue)29
+b(is)g(con)n(v)n(erted)f(to)h(the)g(t)n(yp)r(e)h(y)n(ou)e(request.)42
+b(If)29 b(con)n(v)n(ersion)e(is)j(not)f(p)r(ossible,)227
2725 y(an)f(error)d(will)j(result.)0 2879 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_GET)p Fl(<)p Ft(X)p Fl(>)p Ft(\()c(THIS,)j
(ATTRIB,)e(STATUS)h(\))0 3032 y Fc(Argumen)m(ts:)259
@@ -115010,17 +115061,18 @@ b(ject)28 b(FRAME)f(as)g(an)h(in)n(teger.)0 5406 y Fc(Notes:)340
5693 y Fi(\017)45 b Fj(A)n(ttribute)28 b(names)g(are)e(not)i(case)f
(sensitiv)n(e)g(and)g(ma)n(y)g(b)r(e)h(surrounded)e(b)n(y)i(white)g
(space.)p eop end
-%%Page: 237 247
-TeXDict begin 237 246 bop 3643 52 a FG(237)340 351 y
-Fi(\017)45 b Fj(An)29 b(appropriate)d Ft(")p Fj(n)n(ull)p
-Ft(")h Fj(v)-5 b(alue)28 b(will)g(b)r(e)g(returned)g(if)g(this)g
-(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(ST)-7 b(A)g(TUS)29
-b(set)f(to)427 451 y(an)i(error)d(v)-5 b(alue,)31 b(or)e(if)h(it)g
-(should)f(fail)h(for)f(an)n(y)g(reason.)42 b(This)30
-b(n)n(ull)g(v)-5 b(alue)29 b(is)h(zero)e(for)i(n)n(umeric)f(v)-5
-b(alues,)427 551 y(.F)c(ALSE.)28 b(for)f(logical)f(v)-5
-b(alues,)27 b(and)h(blank)f(for)g(c)n(haracter)f(v)-5
-b(alues.)340 685 y Fi(\017)45 b Fj(Numerical)26 b(attribute)g(v)-5
+%%Page: 238 248
+TeXDict begin 238 247 bop 0 52 a FG(238)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(An)29 b(appropriate)d Ft(")p Fj(n)n(ull)p Ft(")h
+Fj(v)-5 b(alue)28 b(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
+(is)e(in)n(v)n(ok)n(ed)g(with)h(ST)-7 b(A)g(TUS)29 b(set)f(to)427
+451 y(an)i(error)d(v)-5 b(alue,)31 b(or)e(if)h(it)g(should)f(fail)h
+(for)f(an)n(y)g(reason.)42 b(This)30 b(n)n(ull)g(v)-5
+b(alue)29 b(is)h(zero)e(for)i(n)n(umeric)f(v)-5 b(alues,)427
+551 y(.F)c(ALSE.)28 b(for)f(logical)f(v)-5 b(alues,)27
+b(and)h(blank)f(for)g(c)n(haracter)f(v)-5 b(alues.)340
+685 y Fi(\017)45 b Fj(Numerical)26 b(attribute)g(v)-5
b(alues)26 b(of)g(zero)g(translate)f(to)h(logical)f(v)-5
b(alue)26 b(.F)-9 b(ALSE.)26 b(and)g(all)g(other)f(n)n(umerical)427
784 y(v)-5 b(alues)27 b(translate)g(to)h(.TR)n(UE..)p
@@ -115061,16 +115113,16 @@ b(from)f(a)g(named)h(column)f(in)n(to)h(a)f(supplied)h(bu\013er)0
5593 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 5693
y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsT)-7 b(able.)p
eop end
-%%Page: 238 248
-TeXDict begin 238 247 bop 0 52 a FG(238)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(COLUMN)h(=)g(CHARA)m
-(CTER)f Fi(\003)h Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-451 y Fj(The)c(c)n(haracter)d(string)i(holding)h(the)g(name)f(of)g(the)
-h(column.)37 b(T)-7 b(railing)27 b(spaces)g(are)f(ignored.)259
-584 y Fc(RNULL)33 b(=)f(REAL)f(\(Giv)m(en\))427 684 y
-Fj(The)44 b(v)-5 b(alue)44 b(to)f(return)g(in)h(COLD)n(A)-7
-b(T)g(A)44 b(for)f(an)n(y)g(cells)h(for)f(whic)n(h)g(no)h(v)-5
-b(alue)43 b(has)g(b)r(een)i(stored)d(in)427 783 y(the)d(FitsT)-7
+%%Page: 239 249
+TeXDict begin 239 248 bop 3643 52 a FG(239)259 351 y
+Fc(COLUMN)32 b(=)g(CHARA)m(CTER)f Fi(\003)h Fc(\()g Fi(\003)f
+Fc(\))h(\(Giv)m(en\))427 451 y Fj(The)c(c)n(haracter)d(string)i
+(holding)h(the)g(name)f(of)g(the)h(column.)37 b(T)-7
+b(railing)27 b(spaces)g(are)f(ignored.)259 584 y Fc(RNULL)33
+b(=)f(REAL)f(\(Giv)m(en\))427 684 y Fj(The)44 b(v)-5
+b(alue)44 b(to)f(return)g(in)h(COLD)n(A)-7 b(T)g(A)44
+b(for)f(an)n(y)g(cells)h(for)f(whic)n(h)g(no)h(v)-5 b(alue)43
+b(has)g(b)r(een)i(stored)d(in)427 783 y(the)d(FitsT)-7
b(able.)71 b(Ignored)37 b(if)i(the)g(column's)g(data)f(t)n(yp)r(e)h(is)
g(not)f(AST)p Ft(__)p Fj(FLO)n(A)-7 b(TTYPE.)37 b(Supplying)427
883 y(AST)p Ft(__)p Fj(NANR)28 b(will)g(cause)f(a)g(single)g(precision)
@@ -115147,14 +115199,15 @@ b(alues.)340 5427 y Fi(\017)45 b Fj(F)28 b(-)f(Floating)g(p)r(oin)n(t)h
(v)-5 b(alues.)340 5560 y Fi(\017)45 b Fj(I)28 b(-)f(In)n(teger)g(v)-5
b(alues.)340 5693 y Fi(\017)45 b Fj(L)28 b(-)f(Logical)f(\(i.e.)38
b(b)r(o)r(olean\))27 b(v)-5 b(alues.)p eop end
-%%Page: 239 249
-TeXDict begin 239 248 bop 3643 52 a FG(239)340 351 y
-Fi(\017)45 b Fj(S)28 b(-)f(String)h(v)-5 b(alues.)340
-483 y Fi(\017)45 b Fj(CN)32 b(-)g(A)g Ft(")p Fj(CONTINUE)p
-Ft(")e Fj(v)-5 b(alue,)33 b(these)e(are)g(treated)g(lik)n(e)g(string)g
-(v)-5 b(alues,)33 b(but)f(are)f(enco)r(ded)g(without)427
-583 y(an)d(equals)e(sign.)227 744 y(The)i(data)f(t)n(yp)r(e)h(of)f(the)
-h Ft(")p Fj(v)-5 b(alue)p Ft(")27 b Fj(argumen)n(t)227
+%%Page: 240 250
+TeXDict begin 240 249 bop 0 52 a FG(240)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(S)28 b(-)f(String)h(v)-5 b(alues.)340 483 y Fi(\017)45
+b Fj(CN)32 b(-)g(A)g Ft(")p Fj(CONTINUE)p Ft(")e Fj(v)-5
+b(alue,)33 b(these)e(are)g(treated)g(lik)n(e)g(string)g(v)-5
+b(alues,)33 b(but)f(are)f(enco)r(ded)g(without)427 583
+y(an)d(equals)e(sign.)227 744 y(The)i(data)f(t)n(yp)r(e)h(of)f(the)h
+Ft(")p Fj(v)-5 b(alue)p Ft(")27 b Fj(argumen)n(t)227
868 y(dep)r(ends)h(on)g Fl(<)p Fj(X)p Fl(>)f Fj(as)g(follo)n(ws:)340
1128 y Fi(\017)45 b Fj(CF)32 b(-)e(DOUBLE)h(PRECISION\(2\))f(\(a)h(2)g
(elemen)n(t)g(arra)n(y)e(to)i(hold)g(the)h(real)e(and)h(imaginary)e
@@ -115216,35 +115269,34 @@ y(If)i(necessary)-7 b(,)34 b(the)g(AST)p Ft(_)p Fj(TESTFITS)f(function)
h(can)f(b)r(e)h(used)f(to)h(determine)f(if)h(the)g(k)n(eyw)n(ord)e(has)
h(a)427 5693 y(de\014ned)28 b(v)-5 b(alue)28 b(in)g(the)g(FitsChan)f
(prior)g(to)g(calling)g(this)h(function.)p eop end
-%%Page: 240 250
-TeXDict begin 240 249 bop 0 52 a FG(240)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
-b Fj(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)h(the)g(k)n(eyw)n
-(ord)d(name)j(do)r(es)f(not)h(conform)e(to)i(FITS)g(requiremen)n(ts.)
-340 489 y Fi(\017)45 b Fj(.F)-9 b(ALSE.)26 b(is)g(returned)g(as)f(the)i
-(function)f(v)-5 b(alue)26 b(if)h(an)f(error)e(has)h(already)g(o)r
-(ccurred,)g(or)g(if)i(this)f(function)427 588 y(should)i(fail)f(for)g
-(an)n(y)g(reason.)340 726 y Fi(\017)45 b Fj(The)28 b(FITS)g(standard)f
-(sa)n(ys)f(that)i(string)f(k)n(eyw)n(ord)e(v)-5 b(alues)28
-b(should)f(b)r(e)h(padded)g(with)g(trailing)e(spaces)h(if)427
-826 y(they)21 b(are)e(shorter)h(than)g(8)g(c)n(haracters.)33
-b(F)-7 b(or)19 b(this)i(reason,)g(trailing)e(spaces)h(are)f(remo)n(v)n
-(ed)g(from)h(the)h(string)427 925 y(returned)27 b(b)n(y)g(AST)p
-Ft(_)p Fj(GETFITSS)g(if)g(the)h(original)d(string)i(\(including)g(an)n
-(y)f(trailing)h(spaces\))f(con)n(tains)g(8)427 1025 y(or)h(few)n(er)g
-(c)n(haracters.)35 b(T)-7 b(railing)26 b(spaces)h(are)f(not)i(remo)n(v)
-n(ed)e(from)h(longer)f(strings.)p 0 1234 3780 12 v 0
-1364 a FA(AST)p Fe(_)p FA(GETFRAME)1340 1365 y Fd(Obtain)38
-b(a)g(p)s(oin)m(ter)g(to)g(a)1377 1480 y(sp)s(eci\014ed)h(F)-10
-b(rame)38 b(in)g(a)1648 1593 y(F)-10 b(rameSet)2658 1364
-y FA(AST)p Fe(_)p FA(GETFRAME)0 1768 y Fc(Description:)44
-b Fj(This)28 b(function)g(returns)f(a)g(p)r(oin)n(ter)g(to)h(a)f(sp)r
-(eci\014ed)h(F)-7 b(rame)27 b(in)h(a)f(F)-7 b(rameSet.)0
-1927 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_GETFRAME\()
-38 b(THIS,)k(IFRAME,)e(STATUS)i(\))0 2086 y Fc(Argumen)m(ts:)259
-2232 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 2331
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7 b(rameSet.)259
-2469 y Fc(IFRAME)31 b(=)h(INTEGER)g(\(Giv)m(en\))427
+%%Page: 241 251
+TeXDict begin 241 250 bop 3643 52 a FG(241)340 351 y
+Fi(\017)45 b Fj(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)h(the)g
+(k)n(eyw)n(ord)d(name)j(do)r(es)f(not)h(conform)e(to)i(FITS)g
+(requiremen)n(ts.)340 489 y Fi(\017)45 b Fj(.F)-9 b(ALSE.)26
+b(is)g(returned)g(as)f(the)i(function)f(v)-5 b(alue)26
+b(if)h(an)f(error)e(has)h(already)g(o)r(ccurred,)g(or)g(if)i(this)f
+(function)427 588 y(should)i(fail)f(for)g(an)n(y)g(reason.)340
+726 y Fi(\017)45 b Fj(The)28 b(FITS)g(standard)f(sa)n(ys)f(that)i
+(string)f(k)n(eyw)n(ord)e(v)-5 b(alues)28 b(should)f(b)r(e)h(padded)g
+(with)g(trailing)e(spaces)h(if)427 826 y(they)21 b(are)e(shorter)h
+(than)g(8)g(c)n(haracters.)33 b(F)-7 b(or)19 b(this)i(reason,)g
+(trailing)e(spaces)h(are)f(remo)n(v)n(ed)g(from)h(the)h(string)427
+925 y(returned)27 b(b)n(y)g(AST)p Ft(_)p Fj(GETFITSS)g(if)g(the)h
+(original)d(string)i(\(including)g(an)n(y)f(trailing)h(spaces\))f(con)n
+(tains)g(8)427 1025 y(or)h(few)n(er)g(c)n(haracters.)35
+b(T)-7 b(railing)26 b(spaces)h(are)f(not)i(remo)n(v)n(ed)e(from)h
+(longer)f(strings.)p 0 1234 3780 12 v 0 1364 a FA(AST)p
+Fe(_)p FA(GETFRAME)1340 1365 y Fd(Obtain)38 b(a)g(p)s(oin)m(ter)g(to)g
+(a)1377 1480 y(sp)s(eci\014ed)h(F)-10 b(rame)38 b(in)g(a)1648
+1593 y(F)-10 b(rameSet)2658 1364 y FA(AST)p Fe(_)p FA(GETFRAME)0
+1768 y Fc(Description:)44 b Fj(This)28 b(function)g(returns)f(a)g(p)r
+(oin)n(ter)g(to)h(a)f(sp)r(eci\014ed)h(F)-7 b(rame)27
+b(in)h(a)f(F)-7 b(rameSet.)0 1927 y Fc(In)m(v)m(o)s(cation:)123
+b Ft(RESULT)41 b(=)i(AST_GETFRAME\()38 b(THIS,)k(IFRAME,)e(STATUS)i(\))
+0 2086 y Fc(Argumen)m(ts:)259 2232 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 2331 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rameSet.)259 2469 y Fc(IFRAME)31 b(=)h(INTEGER)g(\(Giv)m(en\))427
2568 y Fj(The)j(index)g(of)f(the)h(required)f(F)-7 b(rame)34
b(within)h(the)g(F)-7 b(rameSet.)58 b(This)35 b(v)-5
b(alue)34 b(should)g(lie)h(in)g(the)g(range)427 2668
@@ -115274,8 +115326,9 @@ y(de-)1738 5130 y(scrib)s(es)1860 5229 y(a)1742 5329
y(Plot's)1738 5429 y(graph-)1824 5539 y(ics)1782 5639
y(con-)1787 5739 y(text)2194 4599 y FA(AST)p Fe(_)p FA(GETGRF)l
(CONTEXT)p eop end
-%%Page: 241 251
-TeXDict begin 241 250 bop 3643 52 a FG(241)0 351 y Fc(Description:)44
+%%Page: 242 252
+TeXDict begin 242 251 bop 0 52 a FG(242)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Description:)44
b Fj(This)25 b(routine)g(returns)f(a)h(reference)f(to)g(a)h(KeyMap)f
(that)h(will)g(b)r(e)h(passed)e(to)h(an)n(y)f(dra)n(wing)f(routines)227
451 y(registered)k(using)g(AST)p Ft(_)p Fj(GRFSET.)i(This)e(KeyMap)h
@@ -115339,28 +115392,28 @@ g(represen)n(ted)f(b)n(y)i(t)n(w)n(o)e(F)-7 b(rames)27
b(in)h(a)f(F)-7 b(rameSet.)0 5693 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_GETMAPPING\()37 b(THIS,)42 b(IFRAME1,)e
(IFRAME2,)g(STATUS)i(\))p eop end
-%%Page: 242 252
-TeXDict begin 242 251 bop 0 52 a FG(242)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Argumen)m(ts:)259
-481 y(THIS)h(=)g(INTEGER)g(\(Giv)m(en\))427 580 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(F)-7 b(rameSet.)259 706 y Fc(IFRAME1)31
-b(=)h(INTEGER)f(\(Giv)m(en\))427 806 y Fj(The)g(index)g(of)g(the)h
-(\014rst)e(F)-7 b(rame)31 b(in)g(the)g(F)-7 b(rameSet.)47
-b(This)31 b(F)-7 b(rame)30 b(describ)r(es)h(the)g(co)r(ordinate)f
-(system)427 906 y(for)d(the)h Ft(")p Fj(input)p Ft(")g
-Fj(end)g(of)f(the)h(Mapping.)259 1031 y Fc(IFRAME2)j(=)h(INTEGER)f
-(\(Giv)m(en\))427 1131 y Fj(The)25 b(index)f(of)h(the)f(second)g(F)-7
-b(rame)24 b(in)h(the)f(F)-7 b(rameSet.)36 b(This)24 b(F)-7
-b(rame)24 b(describ)r(es)g(the)h(co)r(ordinate)e(system)427
-1231 y(for)k(the)h Ft(")p Fj(output)p Ft(")g Fj(end)f(of)h(the)g
-(Mapping.)259 1357 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h
-(and)g(Returned\))427 1456 y Fj(The)c(global)e(status.)0
-1611 y Fc(Returned)32 b(V)-8 b(alue:)259 1741 y(AST)p
-Ft(_)p Fc(GETMAPPING)33 b(=)f(INTEGER)427 1840 y Fj(P)n(oin)n(ter)e(to)
-h(a)f(Mapping)h(whose)g(forw)n(ard)e(transformation)g(con)n(v)n(erts)h
-(co)r(ordinates)f(from)i(the)h(\014rst)e(co-)427 1940
-y(ordinate)25 b(system)h(to)f(the)h(second)f(one,)h(and)g(whose)f(in)n
-(v)n(erse)f(transformation)g(con)n(v)n(erts)g(co)r(ordinates)g(in)427
+%%Page: 243 253
+TeXDict begin 243 252 bop 3643 52 a FG(243)0 351 y Fc(Argumen)m(ts:)259
+481 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 580 y
+Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7 b(rameSet.)259
+706 y Fc(IFRAME1)31 b(=)h(INTEGER)f(\(Giv)m(en\))427
+806 y Fj(The)g(index)g(of)g(the)h(\014rst)e(F)-7 b(rame)31
+b(in)g(the)g(F)-7 b(rameSet.)47 b(This)31 b(F)-7 b(rame)30
+b(describ)r(es)h(the)g(co)r(ordinate)f(system)427 906
+y(for)d(the)h Ft(")p Fj(input)p Ft(")g Fj(end)g(of)f(the)h(Mapping.)259
+1031 y Fc(IFRAME2)j(=)h(INTEGER)f(\(Giv)m(en\))427 1131
+y Fj(The)25 b(index)f(of)h(the)f(second)g(F)-7 b(rame)24
+b(in)h(the)f(F)-7 b(rameSet.)36 b(This)24 b(F)-7 b(rame)24
+b(describ)r(es)g(the)h(co)r(ordinate)e(system)427 1231
+y(for)k(the)h Ft(")p Fj(output)p Ft(")g Fj(end)f(of)h(the)g(Mapping.)
+259 1357 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 1456 y Fj(The)c(global)e(status.)0 1611
+y Fc(Returned)32 b(V)-8 b(alue:)259 1741 y(AST)p Ft(_)p
+Fc(GETMAPPING)33 b(=)f(INTEGER)427 1840 y Fj(P)n(oin)n(ter)e(to)h(a)f
+(Mapping)h(whose)g(forw)n(ard)e(transformation)g(con)n(v)n(erts)h(co)r
+(ordinates)f(from)i(the)h(\014rst)e(co-)427 1940 y(ordinate)25
+b(system)h(to)f(the)h(second)f(one,)h(and)g(whose)f(in)n(v)n(erse)f
+(transformation)g(con)n(v)n(erts)g(co)r(ordinates)g(in)427
2040 y(the)k(opp)r(osite)f(direction.)0 2194 y Fc(Notes:)340
2470 y Fi(\017)45 b Fj(The)23 b(returned)g(Mapping)f(will)h(include)h
(the)f(clipping)g(e\013ect)g(of)g(an)n(y)f(Regions)g(whic)n(h)h(o)r
@@ -115414,41 +115467,41 @@ e(celestial)h(co)r(ordinate)g(system.)33 b(If)19 b(AST)p
Ft(__)p Fj(NULL)427 5593 y(is)31 b(supplied,)h(then)g(the)f(longitude)g
(and)g(latitude)g(v)-5 b(alues)31 b(are)f(returned)h(as)f(FK5)g(J2000)f
(RA)i(and)g(Dec)427 5693 y(v)-5 b(alues.)p eop end
-%%Page: 243 253
-TeXDict begin 243 252 bop 3643 52 a FG(243)259 351 y
-Fc(LON)32 b(=)g(DOUBLE)g(PRECISION)f(\(Returned\))427
-451 y Fj(The)i(longitude)g(of)f(the)h(reference)f(p)r(oin)n(t,)i(in)f
-(the)g(co)r(ordinate)f(system)g(represen)n(ted)g(b)n(y)g(the)h
-(supplied)427 551 y(SkyF)-7 b(rame)27 b(\(radians\).)259
-667 y Fc(LA)-8 b(T)33 b(=)f(DOUBLE)g(PRECISION)g(\(Returned\))427
-767 y Fj(The)37 b(latitude)h(of)e(the)i(reference)e(p)r(oin)n(t,)j(in)e
-(the)g(co)r(ordinate)f(system)h(represen)n(ted)e(b)n(y)i(the)g
-(supplied)427 867 y(SkyF)-7 b(rame)27 b(\(radians\).)259
-984 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 1083 y Fj(The)c(global)e(status.)0 1229
-y Fc(Notes:)340 1496 y Fi(\017)45 b Fj(V)-7 b(alues)35
-b(of)g(AST)p Ft(__)p Fj(BAD)g(will)h(b)r(e)f(returned)g(if)g(this)h
-(function)g(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)36
-b(set)f(to)g(an)427 1595 y(error)26 b(v)-5 b(alue,)27
-b(or)g(if)h(it)g(should)g(fail)f(for)g(an)n(y)g(reason.)p
-0 1763 3780 12 v 0 1893 a FA(AST)p Fe(_)p FA(GETREGIONBOUNDS)1902
-1911 y Fd(Returns)1902 2011 y(the)1902 2110 y(b)s(ound-)1902
-2210 y(ing)1902 2324 y(b)s(o)m(x)1902 2424 y(of)1902
-2524 y(Re-)1902 2623 y(gion)2052 1893 y FA(AST)p Fe(_)p
-FA(GETREGIONBOUNDS)0 2780 y Fc(Description:)44 b Fj(This)39
-b(routine)f(returns)g(the)h(upp)r(er)f(and)h(lo)n(w)n(er)e(limits)i(of)
-f(a)g(b)r(o)n(x)h(whic)n(h)f(just)h(encompasses)e(the)227
-2880 y(supplied)j(Region.)72 b(The)40 b(limits)f(are)g(returned)g(as)g
-(axis)g(v)-5 b(alues)39 b(within)h(the)g(F)-7 b(rame)39
-b(represen)n(ted)f(b)n(y)h(the)227 2980 y(Region.)g(The)29
-b(v)-5 b(alue)29 b(of)f(the)h(Negated)f(attribute)h(is)g(ignored)e
-(\(i.e.)40 b(it)29 b(is)g(assumed)f(that)h(the)g(Region)f(has)g(not)227
-3079 y(b)r(een)g(negated\).)0 3213 y Fc(In)m(v)m(o)s(cation:)123
-b Ft(CALL)42 b(AST_GETREGIONBO)o(UND)o(S\()37 b(THIS,)42
-b(LBND,)f(UBND,)h(STATUS)f(\))0 3346 y Fc(Argumen)m(ts:)259
-3467 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 3566
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Region.)259 3683 y
-Fc(LBND\(\))k(=)h(DOUBLE)f(PRECISION)f(\(Returned\))427
+%%Page: 244 254
+TeXDict begin 244 253 bop 0 52 a FG(244)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(LON)h(=)g(DOUBLE)g
+(PRECISION)f(\(Returned\))427 451 y Fj(The)i(longitude)g(of)f(the)h
+(reference)f(p)r(oin)n(t,)i(in)f(the)g(co)r(ordinate)f(system)g
+(represen)n(ted)g(b)n(y)g(the)h(supplied)427 551 y(SkyF)-7
+b(rame)27 b(\(radians\).)259 667 y Fc(LA)-8 b(T)33 b(=)f(DOUBLE)g
+(PRECISION)g(\(Returned\))427 767 y Fj(The)37 b(latitude)h(of)e(the)i
+(reference)e(p)r(oin)n(t,)j(in)e(the)g(co)r(ordinate)f(system)h
+(represen)n(ted)e(b)n(y)i(the)g(supplied)427 867 y(SkyF)-7
+b(rame)27 b(\(radians\).)259 984 y Fc(ST)-8 b(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 1083
+y Fj(The)c(global)e(status.)0 1229 y Fc(Notes:)340 1496
+y Fi(\017)45 b Fj(V)-7 b(alues)35 b(of)g(AST)p Ft(__)p
+Fj(BAD)g(will)h(b)r(e)f(returned)g(if)g(this)h(function)g(is)f(in)n(v)n
+(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)36 b(set)f(to)g(an)427
+1595 y(error)26 b(v)-5 b(alue,)27 b(or)g(if)h(it)g(should)g(fail)f(for)
+g(an)n(y)g(reason.)p 0 1763 3780 12 v 0 1893 a FA(AST)p
+Fe(_)p FA(GETREGIONBOUNDS)1902 1911 y Fd(Returns)1902
+2011 y(the)1902 2110 y(b)s(ound-)1902 2210 y(ing)1902
+2324 y(b)s(o)m(x)1902 2424 y(of)1902 2524 y(Re-)1902
+2623 y(gion)2052 1893 y FA(AST)p Fe(_)p FA(GETREGIONBOUNDS)0
+2780 y Fc(Description:)44 b Fj(This)39 b(routine)f(returns)g(the)h(upp)
+r(er)f(and)h(lo)n(w)n(er)e(limits)i(of)f(a)g(b)r(o)n(x)h(whic)n(h)f
+(just)h(encompasses)e(the)227 2880 y(supplied)j(Region.)72
+b(The)40 b(limits)f(are)g(returned)g(as)g(axis)g(v)-5
+b(alues)39 b(within)h(the)g(F)-7 b(rame)39 b(represen)n(ted)f(b)n(y)h
+(the)227 2980 y(Region.)g(The)29 b(v)-5 b(alue)29 b(of)f(the)h(Negated)
+f(attribute)h(is)g(ignored)e(\(i.e.)40 b(it)29 b(is)g(assumed)f(that)h
+(the)g(Region)f(has)g(not)227 3079 y(b)r(een)g(negated\).)0
+3213 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_GETREGIONBO)o
+(UND)o(S\()37 b(THIS,)42 b(LBND,)f(UBND,)h(STATUS)f(\))0
+3346 y Fc(Argumen)m(ts:)259 3467 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 3566 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Region.)259
+3683 y Fc(LBND\(\))k(=)h(DOUBLE)f(PRECISION)f(\(Returned\))427
3783 y Fj(An)e(arra)n(y)c(in)j(whic)n(h)g(to)g(return)g(the)g(lo)n(w)n
(er)e(axis)i(b)r(ounds)g(co)n(v)n(ered)e(b)n(y)h(the)i(Region.)37
b(It)28 b(should)g(ha)n(v)n(e)f(at)427 3882 y(least)33
@@ -115480,10 +115533,9 @@ b(Note,)28 b(this)g(is)g(di\013eren)n(t)g(to)g(an)g(axis)f(whic)n(h)h
(cannot)g(b)r(e)g(determined,)h(AST)p Ft(__)p Fj(BAD)g(is)f(returned)g
(for)g(b)r(oth)h(upp)r(er)g(and)427 5659 y(lo)n(w)n(er)d(b)r(ounds)p
eop end
-%%Page: 244 254
-TeXDict begin 244 253 bop 0 52 a FG(244)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(GETREGIONFRAME)1824 500
+%%Page: 245 255
+TeXDict begin 245 254 bop 3643 52 a FG(245)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(GETREGIONFRAME)1824 500
y Fd(Obtain)1860 599 y(a)1824 699 y(p)s(oin)m(ter)1838
798 y(to)1824 898 y(the)1824 998 y(en-)1824 1097 y(cap-)1824
1197 y(su-)1824 1297 y(lated)1824 1396 y(F)-10 b(rame)1824
@@ -115517,8 +115569,9 @@ b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
y(face)38 b(or)1795 5417 y(v)m(ol-)1717 5516 y(ume)e(of)1752
5616 y(a)j(Re-)1782 5715 y(gion)2214 4388 y FA(AST)p
Fe(_)p FA(GETREGIONMESH)p eop end
-%%Page: 245 255
-TeXDict begin 245 254 bop 3643 52 a FG(245)0 351 y Fc(Description:)44
+%%Page: 246 256
+TeXDict begin 246 255 bop 0 52 a FG(246)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Description:)44
b Fj(This)32 b(routine)f(returns)f(the)i(axis)f(v)-5
b(alues)30 b(at)i(a)f(mesh)g(of)g(p)r(oin)n(ts)h(either)f(co)n(v)n
(ering)e(the)j(surface)e(\(i.e.)227 451 y(b)r(oundary\))f(of)f(the)i
@@ -115578,9 +115631,8 @@ b(ho)n(w)n(ev)n(er)e(that)i(if)g(the)g(transformation)f(from)g
y(de-)1838 5303 y(\014ne)1838 5403 y(the)1838 5503 y(giv)m(en)1838
5616 y(Re-)1838 5715 y(gion)2094 4577 y FA(AST)p Fe(_)p
FA(GETREGIONPOINTS)p eop end
-%%Page: 246 256
-TeXDict begin 246 255 bop 0 52 a FG(246)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Description:)44
+%%Page: 247 257
+TeXDict begin 247 256 bop 3643 52 a FG(247)0 351 y Fc(Description:)44
b Fj(This)32 b(routine)g(returns)f(the)h(axis)f(v)-5
b(alues)31 b(at)h(the)g(p)r(oin)n(ts)g(that)g(de\014ne)g(the)g
(supplied)h(Region.)49 b(The)227 451 y(particular)25
@@ -115652,28 +115704,28 @@ b(alue)27 b(of)h(zero)e(for)i(NPOINT)f(and)g(lea)n(v)n(es)f(the)i
5593 y Fc(P)m(oin)m(tList)427 5693 y Fj(The)h(p)r(ositions)f(returned)g
(are)g(those)g(that)h(w)n(ere)f(supplied)h(when)f(the)h(P)n(oin)n
(tList)f(w)n(as)f(constructed.)p eop end
-%%Page: 247 257
-TeXDict begin 247 256 bop 3643 52 a FG(247)259 351 y
-Fc(P)m(olygon)427 451 y Fj(The)36 b(p)r(ositions)f(returned)g(are)f
-(the)i(v)n(ertex)f(p)r(ositions)g(that)g(w)n(ere)g(supplied)h(when)f
-(the)h(P)n(olygon)e(w)n(as)427 551 y(constructed.)259
-669 y Fc(Prism)427 768 y Fj(Returns)c(a)g(v)-5 b(alue)29
-b(of)h(zero)f(for)h(NPOINT)f(and)h(lea)n(v)n(es)e(the)j(supplied)f
-(arra)n(y)e(con)n(ten)n(ts)h(unc)n(hanged.)43 b(T)-7
-b(o)427 868 y(\014nd)31 b(the)g(p)r(oin)n(ts)g(de\014ning)g(a)f(Prism,)
-g(use)h(this)g(metho)r(d)g(on)f(the)h(comp)r(onen)n(t)g(Regions,)f
-(whic)n(h)h(can)f(b)r(e)427 968 y(accessed)d(b)n(y)g(in)n(v)n(oking)f
-(AST)p Ft(_)p Fj(DECOMPOSE)g(on)h(the)h(CmpRegion.)0
-1115 y Fc(Notes:)340 1383 y Fi(\017)45 b Fj(If)21 b(the)h(co)r
-(ordinate)d(system)i(represen)n(ted)e(b)n(y)h(the)i(Region)e(has)g(b)r
-(een)h(c)n(hanged)f(since)g(it)h(w)n(as)f(\014rst)g(created,)427
-1483 y(the)h(returned)f(axis)f(v)-5 b(alues)20 b(refer)g(to)g(the)g
-(new)h(\(c)n(hanged\))e(co)r(ordinate)g(system,)j(rather)d(than)i(the)f
-(original)427 1582 y(co)r(ordinate)27 b(system.)37 b(Note)28
-b(ho)n(w)n(ev)n(er)e(that)i(if)g(the)g(transformation)f(from)g
-(original)f(to)i(new)g(co)r(ordinate)427 1682 y(system)j(is)f
-(non-linear,)g(the)h(shap)r(e)f(within)i(the)f(new)f(co)r(ordinate)g
-(system)g(ma)n(y)g(b)r(e)h(distorted,)g(and)f(so)427
+%%Page: 248 258
+TeXDict begin 248 257 bop 0 52 a FG(248)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(P)m(olygon)427
+451 y Fj(The)36 b(p)r(ositions)f(returned)g(are)f(the)i(v)n(ertex)f(p)r
+(ositions)g(that)g(w)n(ere)g(supplied)h(when)f(the)h(P)n(olygon)e(w)n
+(as)427 551 y(constructed.)259 669 y Fc(Prism)427 768
+y Fj(Returns)c(a)g(v)-5 b(alue)29 b(of)h(zero)f(for)h(NPOINT)f(and)h
+(lea)n(v)n(es)e(the)j(supplied)f(arra)n(y)e(con)n(ten)n(ts)h(unc)n
+(hanged.)43 b(T)-7 b(o)427 868 y(\014nd)31 b(the)g(p)r(oin)n(ts)g
+(de\014ning)g(a)f(Prism,)g(use)h(this)g(metho)r(d)g(on)f(the)h(comp)r
+(onen)n(t)g(Regions,)f(whic)n(h)h(can)f(b)r(e)427 968
+y(accessed)d(b)n(y)g(in)n(v)n(oking)f(AST)p Ft(_)p Fj(DECOMPOSE)g(on)h
+(the)h(CmpRegion.)0 1115 y Fc(Notes:)340 1383 y Fi(\017)45
+b Fj(If)21 b(the)h(co)r(ordinate)d(system)i(represen)n(ted)e(b)n(y)h
+(the)i(Region)e(has)g(b)r(een)h(c)n(hanged)f(since)g(it)h(w)n(as)f
+(\014rst)g(created,)427 1483 y(the)h(returned)f(axis)f(v)-5
+b(alues)20 b(refer)g(to)g(the)g(new)h(\(c)n(hanged\))e(co)r(ordinate)g
+(system,)j(rather)d(than)i(the)f(original)427 1582 y(co)r(ordinate)27
+b(system.)37 b(Note)28 b(ho)n(w)n(ev)n(er)e(that)i(if)g(the)g
+(transformation)f(from)g(original)f(to)i(new)g(co)r(ordinate)427
+1682 y(system)j(is)f(non-linear,)g(the)h(shap)r(e)f(within)i(the)f(new)
+f(co)r(ordinate)g(system)g(ma)n(y)g(b)r(e)h(distorted,)g(and)f(so)427
1782 y(ma)n(y)d(not)h(matc)n(h)f(that)h(implied)g(b)n(y)g(the)f(name)h
(of)f(the)h(Region)f(sub)r(class)g(\(Circle,)h(Bo)n(x,)e(etc\).)p
0 1952 3780 12 v 0 2083 a FA(AST)p Fe(_)p FA(GETSTCCOORD)1710
@@ -115722,10 +115774,9 @@ b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
b(A)g(TUS)427 5642 y(set)28 b(to)f(an)h(error)d(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
eop end
-%%Page: 248 258
-TeXDict begin 248 257 bop 0 52 a FG(248)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(GETSTCNCOORD)216 b Fd(Return)1808
+%%Page: 249 259
+TeXDict begin 249 258 bop 3643 52 a FG(249)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(GETSTCNCOORD)216 b Fd(Return)1808
581 y(the)1696 681 y(n)m(um)m(b)s(er)1662 780 y(of)38
b(Astro-)1709 880 y(Co)s(ords)1670 980 y(elemen)m(ts)1665
1079 y(stored)g(in)1727 1179 y(an)h(Stc)2288 482 y FA(AST)p
@@ -115767,28 +115818,28 @@ Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 5643
y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
(fail)h(for)f(an)n(y)g(reason.)p eop end
-%%Page: 249 259
-TeXDict begin 249 258 bop 3643 52 a FG(249)p 0 351 3780
-12 v 0 482 a FA(AST)p Fe(_)p FA(GETT)-11 b(ABLES)421
-b Fd(Retriev)m(e)37 b(an)m(y)1306 596 y(FitsT)-10 b(ables)38
-b(curren)m(tly)f(in)1604 711 y(a)i(FitsChan)2637 482
-y FA(AST)p Fe(_)p FA(GETT)-11 b(ABLES)0 882 y Fc(Description:)44
-b Fj(If)22 b(the)f(supplied)h(FitsChan)f(curren)n(tly)f(con)n(tains)g
-(an)n(y)h(tables,)h(then)g(this)f(function)h(returns)e(a)h(p)r(oin)n
-(ter)227 982 y(to)29 b(a)f(KeyMap.)38 b(Eac)n(h)28 b(en)n(try)g(in)g
-(the)h(KeyMap)f(is)g(a)g(p)r(oin)n(ter)g(to)h(a)f(FitsT)-7
-b(able)28 b(holding)g(the)h(data)f(for)g(a)g(FITS)227
-1082 y(binary)k(table.)53 b(The)33 b(k)n(ey)f(used)h(to)g(access)f(eac)
-n(h)g(en)n(try)g(is)h(the)g(FITS)g(extension)g(name)f(in)i(whic)n(h)e
-(the)i(table)227 1181 y(should)28 b(b)r(e)g(stored.)227
-1309 y(T)-7 b(ables)18 b(can)g(b)r(e)h(presen)n(t)f(in)g(a)g(FitsChan)h
-(as)e(a)h(result)g(either)h(of)f(using)g(the)h(AST)p
-Ft(_)p Fj(PUTT)-7 b(ABLE)17 b(\(or)h(AST)p Ft(_)p Fj(PUTT)-7
-b(ABLES\))227 1408 y(metho)r(d)30 b(to)f(store)f(existing)h(tables)g
-(in)g(the)g(FitsChan,)h(or)e(of)h(using)g(the)h(AST)p
-Ft(_)p Fj(WRITE)f(metho)r(d)g(to)g(write)g(a)227 1508
-y(F)-7 b(rameSet)28 b(to)h(the)g(FitsChan.)39 b(F)-7
-b(or)28 b(the)h(later)e(case,)h(if)h(the)g(FitsChan)f
+%%Page: 250 260
+TeXDict begin 250 259 bop 0 52 a FG(250)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(GETT)-11 b(ABLES)421 b Fd(Retriev)m(e)37
+b(an)m(y)1306 596 y(FitsT)-10 b(ables)38 b(curren)m(tly)f(in)1604
+711 y(a)i(FitsChan)2637 482 y FA(AST)p Fe(_)p FA(GETT)-11
+b(ABLES)0 882 y Fc(Description:)44 b Fj(If)22 b(the)f(supplied)h
+(FitsChan)f(curren)n(tly)f(con)n(tains)g(an)n(y)h(tables,)h(then)g
+(this)f(function)h(returns)e(a)h(p)r(oin)n(ter)227 982
+y(to)29 b(a)f(KeyMap.)38 b(Eac)n(h)28 b(en)n(try)g(in)g(the)h(KeyMap)f
+(is)g(a)g(p)r(oin)n(ter)g(to)h(a)f(FitsT)-7 b(able)28
+b(holding)g(the)h(data)f(for)g(a)g(FITS)227 1082 y(binary)k(table.)53
+b(The)33 b(k)n(ey)f(used)h(to)g(access)f(eac)n(h)g(en)n(try)g(is)h(the)
+g(FITS)g(extension)g(name)f(in)i(whic)n(h)e(the)i(table)227
+1181 y(should)28 b(b)r(e)g(stored.)227 1309 y(T)-7 b(ables)18
+b(can)g(b)r(e)h(presen)n(t)f(in)g(a)g(FitsChan)h(as)e(a)h(result)g
+(either)h(of)f(using)g(the)h(AST)p Ft(_)p Fj(PUTT)-7
+b(ABLE)17 b(\(or)h(AST)p Ft(_)p Fj(PUTT)-7 b(ABLES\))227
+1408 y(metho)r(d)30 b(to)f(store)f(existing)h(tables)g(in)g(the)g
+(FitsChan,)h(or)e(of)h(using)g(the)h(AST)p Ft(_)p Fj(WRITE)f(metho)r(d)
+g(to)g(write)g(a)227 1508 y(F)-7 b(rameSet)28 b(to)h(the)g(FitsChan.)39
+b(F)-7 b(or)28 b(the)h(later)e(case,)h(if)h(the)g(FitsChan)f
Ft(")p Fj(T)-7 b(abOK)p Ft(")27 b Fj(attribute)h(is)h(p)r(ositiv)n(e)f
(and)227 1608 y(the)k(F)-7 b(rameSet)32 b(requires)e(a)h(lo)r(ok-up)g
(table)g(to)h(describ)r(e)f(one)g(or)g(more)f(axes,)i(then)g(the)g
@@ -115839,10 +115890,9 @@ Ft(")p Fj(Applicabilit)n(y)p Ft(")f Fj(b)r(elo)n(w\).)34
b(If)19 b(.F)-9 b(ALSE.)19 b(is)f(supplied,)j(then)f(AST)p
Ft(__)p Fj(NULL)427 5693 y(will)28 b(b)r(e)g(returned)f(\(without)i
(error\).)p eop end
-%%Page: 250 260
-TeXDict begin 250 259 bop 0 52 a FG(250)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(ST)-8
-b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+%%Page: 251 261
+TeXDict begin 251 260 bop 3643 52 a FG(251)259 351 y
+Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
451 y Fj(The)c(global)e(status.)0 621 y Fc(Class)31 b(Applicabilit)m
(y:)259 765 y(CmpRegion)427 864 y Fj(The)f(default)g(uncertain)n(t)n(y)
f(for)g(a)h(CmpRegion)f(is)g(tak)n(en)h(from)f(one)g(of)h(the)g(t)n(w)n
@@ -115910,8 +115960,9 @@ y Fc(Argumen)m(ts:)259 5341 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
5440 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259 5577
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
427 5677 y Fj(The)c(global)e(status.)p eop end
-%%Page: 251 261
-TeXDict begin 251 260 bop 3643 52 a FG(251)0 351 y Fc(Notes:)340
+%%Page: 252 262
+TeXDict begin 252 261 bop 0 52 a FG(252)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Notes:)340
632 y Fi(\017)45 b Fj(This)26 b(routine)g(returns)f(without)i(action)e
(if)h(there)g(are)f(no)h(snapshots)f(to)h(restore.)35
b(No)25 b(error)f(is)i(rep)r(orted)427 732 y(in)i(this)g(case.)p
@@ -115981,21 +116032,21 @@ b Fj(BBuf)28 b(-)f(Start)h(a)f(new)h(graphics)e(bu\013ering)h(con)n
(text)510 5578 y Fi(\017)45 b Fj(Cap)28 b(-)f(Inquire)g(a)g(capabilit)n
(y)510 5693 y Fi(\017)45 b Fj(EBuf)28 b(-)f(End)h(the)g(curren)n(t)e
(graphics)g(bu\013ering)i(con)n(text)p eop end
-%%Page: 252 262
-TeXDict begin 252 261 bop 0 52 a FG(252)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)510 351 y Fi(\017)45
-b Fj(Flush)28 b(-)g(Flush)f(all)h(p)r(ending)g(graphics)e(to)h(the)h
-(output)g(device)510 467 y Fi(\017)45 b Fj(Line)28 b(-)f(Dra)n(w)g(a)g
-(p)r(olyline)h(\(i.e.)37 b(a)27 b(set)h(of)f(connected)h(lines\))510
-583 y Fi(\017)45 b Fj(Mark)27 b(-)g(Dra)n(w)g(a)g(set)h(of)f(mark)n
-(ers)510 699 y Fi(\017)45 b Fj(Qc)n(h)27 b(-)h(Return)f(the)h(c)n
-(haracter)e(heigh)n(t)h(in)h(w)n(orld)f(co)r(ordinates)510
-814 y Fi(\017)45 b Fj(Scales)27 b(-)h(Get)g(the)g(axis)e(scales)510
-930 y Fi(\017)45 b Fj(T)-7 b(ext)28 b(-)f(Dra)n(w)g(a)g(c)n(haracter)f
-(string)510 1046 y Fi(\017)45 b Fj(TxExt)27 b(-)h(Get)g(the)g(exten)n
-(t)f(of)h(a)f(c)n(haracter)f(string)427 1178 y(The)k(string)g(is)g
-(case)f(insensitiv)n(e.)44 b(F)-7 b(or)30 b(details)f(of)h(the)h(in)n
-(terface)e(required)g(for)h(eac)n(h,)g(see)g(the)g(sections)427
+%%Page: 253 263
+TeXDict begin 253 262 bop 3643 52 a FG(253)510 351 y
+Fi(\017)45 b Fj(Flush)28 b(-)g(Flush)f(all)h(p)r(ending)g(graphics)e
+(to)h(the)h(output)g(device)510 467 y Fi(\017)45 b Fj(Line)28
+b(-)f(Dra)n(w)g(a)g(p)r(olyline)h(\(i.e.)37 b(a)27 b(set)h(of)f
+(connected)h(lines\))510 583 y Fi(\017)45 b Fj(Mark)27
+b(-)g(Dra)n(w)g(a)g(set)h(of)f(mark)n(ers)510 699 y Fi(\017)45
+b Fj(Qc)n(h)27 b(-)h(Return)f(the)h(c)n(haracter)e(heigh)n(t)h(in)h(w)n
+(orld)f(co)r(ordinates)510 814 y Fi(\017)45 b Fj(Scales)27
+b(-)h(Get)g(the)g(axis)e(scales)510 930 y Fi(\017)45
+b Fj(T)-7 b(ext)28 b(-)f(Dra)n(w)g(a)g(c)n(haracter)f(string)510
+1046 y Fi(\017)45 b Fj(TxExt)27 b(-)h(Get)g(the)g(exten)n(t)f(of)h(a)f
+(c)n(haracter)f(string)427 1178 y(The)k(string)g(is)g(case)f
+(insensitiv)n(e.)44 b(F)-7 b(or)30 b(details)f(of)h(the)h(in)n(terface)
+e(required)g(for)h(eac)n(h,)g(see)g(the)g(sections)427
1277 y(b)r(elo)n(w.)259 1409 y Fc(FUN)i(=)g(INTEGER)g(FUNCTION)g(\(Giv)
m(en\))427 1509 y Fj(The)39 b(name)g(of)g(the)h(routine)f(to)g(b)r(e)g
(used)g(to)g(pro)n(vide)f(the)i(functionalit)n(y)f(indicated)g(b)n(y)g
@@ -116067,12 +116118,13 @@ Ft(__)p Fj(TEXT.)-2 5547 y Fc(BBuf)n(:)227 5693 y Fj(The)j
Ft(")p Fj(BBuf)p Ft(")f Fj(function)h(should)g(start)f(a)g(new)g
(graphics)g(bu\013ering)g(con)n(text.)34 b(A)21 b(matc)n(hing)f(call)h
(to)f(the)h(function)p eop end
-%%Page: 253 263
-TeXDict begin 253 262 bop 3643 52 a FG(253)227 351 y
-Ft(")p Fj(EBuf)p Ft(")37 b Fj(should)h(b)r(e)h(used)f(to)g(end)g(the)g
-(con)n(text.)68 b(The)38 b(nature)g(of)g(the)g(bu\013ering)g(is)g
-(determined)g(b)n(y)g(the)227 451 y(underlying)27 b(graphics)f(system.)
-227 584 y(INTEGER)h(FUNCTION)i(BBUF\()f(GRF)n(CON)f(\))340
+%%Page: 254 264
+TeXDict begin 254 263 bop 0 52 a FG(254)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)227 351 y Ft(")p
+Fj(EBuf)p Ft(")37 b Fj(should)h(b)r(e)h(used)f(to)g(end)g(the)g(con)n
+(text.)68 b(The)38 b(nature)g(of)g(the)g(bu\013ering)g(is)g(determined)
+g(b)n(y)g(the)227 451 y(underlying)27 b(graphics)f(system.)227
+584 y(INTEGER)h(FUNCTION)i(BBUF\()f(GRF)n(CON)f(\))340
872 y Fi(\017)45 b Fj(GRF)n(CON)25 b(=)g(INTEGER)g(\(Giv)n(en\))g(-)g
(A)g(KeyMap)f(con)n(taining)g(information)h(passed)f(from)h(the)g
(calling)427 972 y(application.)-2 1152 y Fc(Cap)n(:)227
@@ -116154,9 +116206,8 @@ b(It)28 b(requires)e(the)i(follo)n(wing)e(in)n(terface:)227
5577 y Fi(\017)45 b Fj(GRF)n(CON)25 b(=)g(INTEGER)g(\(Giv)n(en\))g(-)g
(A)g(KeyMap)f(con)n(taining)g(information)h(passed)f(from)h(the)g
(calling)427 5677 y(application.)p eop end
-%%Page: 254 264
-TeXDict begin 254 263 bop 0 52 a FG(254)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)-2 351 y Fc(Flush)n(:)227
+%%Page: 255 265
+TeXDict begin 255 264 bop 3643 52 a FG(255)-2 351 y Fc(Flush)n(:)227
497 y Fj(The)19 b Ft(")p Fj(Flush)p Ft(")g Fj(function)g(ensures)f
(that)i(the)f(displa)n(y)f(device)h(is)g(up-to-date,)h(b)n(y)f
(\015ushing)g(an)n(y)f(p)r(ending)h(graphics)227 597
@@ -116223,11 +116274,12 @@ b(increase)f(from)h(left)h(to)g(righ)n(t,)g(and)f(3\))g(Y)227
b(It)28 b(requires)f(the)g(follo)n(wing)g(in)n(terface:)227
5598 y(INTEGER)g(FUNCTION)i(SCALES\()e(GRF)n(CON,)h(ALPHA,)g(BET)-7
b(A)27 b(\))p eop end
-%%Page: 255 265
-TeXDict begin 255 264 bop 3643 52 a FG(255)340 351 y
-Fi(\017)45 b Fj(GRF)n(CON)25 b(=)g(INTEGER)g(\(Giv)n(en\))g(-)g(A)g
-(KeyMap)f(con)n(taining)g(information)h(passed)f(from)h(the)g(calling)
-427 451 y(application.)340 574 y Fi(\017)45 b Fj(ALPHA)28
+%%Page: 256 266
+TeXDict begin 256 265 bop 0 52 a FG(256)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(GRF)n(CON)25 b(=)g(INTEGER)g(\(Giv)n(en\))g(-)g(A)g(KeyMap)f(con)n
+(taining)g(information)h(passed)f(from)h(the)g(calling)427
+451 y(application.)340 574 y Fi(\017)45 b Fj(ALPHA)28
b(=)f(REAL)h(\(Returned\))g(The)g(scale)f(for)g(the)h(X)g(axis)e
(\(i.e.)38 b(Xnorm)27 b(=)g(alpha)p Fi(\003)p Fj(Xw)n(orld\).)340
697 y Fi(\017)45 b Fj(BET)-7 b(A)28 b(=)f(REAL)g(\(Returned\))i(The)e
@@ -116319,10 +116371,9 @@ b(See)27 b Ft(")p Fj(T)-7 b(ext)p Ft(")27 b Fj(ab)r(o)n(v)n(e.)340
(Returned)f(holding)g(the)h(y)g(co)r(ordinate)e(of)i(eac)n(h)f(corner)f
(of)h(the)427 5637 y(b)r(ounding)28 b(b)r(o)n(x.)p eop
end
-%%Page: 256 266
-TeXDict begin 256 265 bop 0 52 a FG(256)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(GRID)913 483 y Fd(Dra)m(w)38
+%%Page: 257 267
+TeXDict begin 257 266 bop 3643 52 a FG(257)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(GRID)913 483 y Fd(Dra)m(w)38
b(a)g(set)h(of)f(lab)s(elled)g(co)s(ordinate)e(axes)3089
482 y FA(AST)p Fe(_)p FA(GRID)0 651 y Fc(Description:)44
b Fj(This)20 b(routine)g(dra)n(ws)e(a)i(complete)g(annotated)f(set)h
@@ -116397,9 +116448,10 @@ g(axis)g(of)h(the)g(Plot,)g(giving)e(the)j(ph)n(ysical)d(co)r
(giv)n(en)h(as)f(an)h(incremen)n(t)g(along)f(the)h(selected)g(ph)n
(ysical)g(axis.)35 b(This)427 5693 y(ma)n(y)27 b(b)r(e)h(p)r(ositiv)n
(e)f(or)g(negativ)n(e.)p eop end
-%%Page: 257 267
-TeXDict begin 257 266 bop 3643 52 a FG(257)259 351 y
-Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+%%Page: 258 268
+TeXDict begin 258 267 bop 0 52 a FG(258)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(ST)-8
+b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
451 y Fj(The)c(global)e(status.)0 617 y Fc(Notes:)340
904 y Fi(\017)45 b Fj(No)27 b(curv)n(e)f(is)h(dra)n(wn)f(if)h(the)h(ST)
-7 b(AR)g(T)27 b(arra)n(y)e(con)n(tains)h(an)n(y)g(co)r(ordinates)g
@@ -116467,27 +116519,27 @@ Fd(Get)38 b(the)h(FITS)1511 5324 y(headers)f(from)f(a)1648
b(function)g(returns)f(a)g(p)r(oin)n(ter)g(to)g(a)g(FitsChan)h(holding)
f(copies)f(of)i(the)g(FITS)g(headers)e(asso)r(ciated)227
5693 y(with)28 b(a)g(FitsT)-7 b(able.)p eop end
-%%Page: 258 268
-TeXDict begin 258 267 bop 0 52 a FG(258)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(In)m(v)m(o)s(cation:)
-123 b Ft(RESULT)41 b(=)i(AST_GETTABLEHEAD)o(ER\()37 b(THIS,)k(STATUS)g
-(\))0 518 y Fc(Argumen)m(ts:)259 671 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 771 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsT)-7
-b(able.)259 912 y Fc(ST)f(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 1012 y Fj(The)c(global)e(status.)0 1191
-y Fc(Returned)32 b(V)-8 b(alue:)259 1344 y(AST)p Ft(_)p
-Fc(GetT)g(ableHeader)32 b(=)g(INTEGER)427 1444 y Fj(A)c(p)r(oin)n(ter)f
-(to)h(a)f(deep)h(cop)n(y)f(of)g(the)h(FitsChan)g(stored)e(within)j(the)
-f(FitsT)-7 b(able.)0 1623 y Fc(Notes:)340 1923 y Fi(\017)45
-b Fj(The)28 b(returned)f(p)r(oin)n(ter)g(should)h(b)r(e)g(ann)n(ulled)f
-(using)g(AST)p Ft(_)p Fj(ANNUL)i(when)f(it)g(is)f(no)g(longer)g
-(needed.)340 2064 y Fi(\017)45 b Fj(Changing)21 b(the)h(con)n(ten)n(ts)
-f(of)h(the)g(returned)g(FitsChan)f(will)h(ha)n(v)n(e)f(no)g(e\013ect)i
-(on)e(the)h(FitsT)-7 b(able.)35 b(T)-7 b(o)22 b(mo)r(d-)427
-2164 y(ify)d(the)g(FitsT)-7 b(able,)20 b(the)f(mo)r(di\014ed)g
-(FitsChan)f(m)n(ust)g(b)r(e)h(stored)f(in)g(the)h(FitsT)-7
-b(able)19 b(using)f(AST)p Ft(_)p Fj(PUTT)-7 b(ABLEHEADER.)p
-0 2380 3780 12 v 0 2511 a FA(AST)p Fe(_)p FA(HASA)c(TTRIBUTE)1646
+%%Page: 259 269
+TeXDict begin 259 268 bop 3643 52 a FG(259)0 351 y Fc(In)m(v)m(o)s
+(cation:)123 b Ft(RESULT)41 b(=)i(AST_GETTABLEHEAD)o(ER\()37
+b(THIS,)k(STATUS)g(\))0 518 y Fc(Argumen)m(ts:)259 671
+y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 771 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(FitsT)-7 b(able.)259 912 y Fc(ST)f(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 1012
+y Fj(The)c(global)e(status.)0 1191 y Fc(Returned)32 b(V)-8
+b(alue:)259 1344 y(AST)p Ft(_)p Fc(GetT)g(ableHeader)32
+b(=)g(INTEGER)427 1444 y Fj(A)c(p)r(oin)n(ter)f(to)h(a)f(deep)h(cop)n
+(y)f(of)g(the)h(FitsChan)g(stored)e(within)j(the)f(FitsT)-7
+b(able.)0 1623 y Fc(Notes:)340 1923 y Fi(\017)45 b Fj(The)28
+b(returned)f(p)r(oin)n(ter)g(should)h(b)r(e)g(ann)n(ulled)f(using)g
+(AST)p Ft(_)p Fj(ANNUL)i(when)f(it)g(is)f(no)g(longer)g(needed.)340
+2064 y Fi(\017)45 b Fj(Changing)21 b(the)h(con)n(ten)n(ts)f(of)h(the)g
+(returned)g(FitsChan)f(will)h(ha)n(v)n(e)f(no)g(e\013ect)i(on)e(the)h
+(FitsT)-7 b(able.)35 b(T)-7 b(o)22 b(mo)r(d-)427 2164
+y(ify)d(the)g(FitsT)-7 b(able,)20 b(the)f(mo)r(di\014ed)g(FitsChan)f(m)
+n(ust)g(b)r(e)h(stored)f(in)g(the)h(FitsT)-7 b(able)19
+b(using)f(AST)p Ft(_)p Fj(PUTT)-7 b(ABLEHEADER.)p 0 2380
+3780 12 v 0 2511 a FA(AST)p Fe(_)p FA(HASA)c(TTRIBUTE)1646
2512 y Fd(T)h(est)38 b(if)g(an)1611 2611 y(Ob)7 b(ject)38
b(has)1672 2726 y(a)g(named)1662 2826 y(attribute)2358
2511 y FA(AST)p Fe(_)p FA(HASA)-11 b(TTRIBUTE)0 3008
@@ -116513,11 +116565,12 @@ b Fj(A)28 b(v)-5 b(alue)28 b(of)f(.F)-9 b(ALSE.)28 b(will)g(b)r(e)g
b(A)g(TUS)28 b(set)g(to)f(an)h(error)427 5619 y(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
eop end
-%%Page: 259 269
-TeXDict begin 259 268 bop 3643 52 a FG(259)p 0 351 3780
-12 v 0 482 a FA(AST)p Fe(_)p FA(HASCOLUMN)1528 483 y
-Fd(Returns)38 b(a)h(\015ag)1534 598 y(indicating)d(if)i(a)1442
-712 y(column)g(is)g(presen)m(t)1631 827 y(in)h(a)f(T)-10
+%%Page: 260 270
+TeXDict begin 260 269 bop 0 52 a FG(260)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(HASCOLUMN)1528 483 y Fd(Returns)38
+b(a)h(\015ag)1534 598 y(indicating)d(if)i(a)1442 712
+y(column)g(is)g(presen)m(t)1631 827 y(in)h(a)f(T)-10
b(able)2552 482 y FA(AST)p Fe(_)p FA(HASCOLUMN)0 985
y Fc(Description:)44 b Fj(This)32 b(routine)e(returns)h(a)g(\015ag)f
(indicating)h(if)h(a)f(named)g(column)g(exists)g(in)g(a)g(T)-7
@@ -116560,11 +116613,10 @@ b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
5647 y Fi(\017)45 b Fj(A)28 b(v)-5 b(alue)28 b(of)f(.F)-9
b(ALSE.)28 b(is)f(returned)g(for)h(if)g(an)f(error)f(o)r(ccurs.)p
eop end
-%%Page: 260 270
-TeXDict begin 260 269 bop 0 52 a FG(260)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(IMPOR)-11 b(T)1062 483 y
-Fd(Imp)s(ort)38 b(an)g(Ob)7 b(ject)38 b(p)s(oin)m(ter)g(to)g(the)1498
+%%Page: 261 271
+TeXDict begin 261 270 bop 3643 52 a FG(261)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(IMPOR)-11 b(T)1062 483
+y Fd(Imp)s(ort)38 b(an)g(Ob)7 b(ject)38 b(p)s(oin)m(ter)g(to)g(the)1498
583 y(curren)m(t)f(con)m(text)2895 482 y FA(AST)p Fe(_)p
FA(IMPOR)-11 b(T)0 750 y Fc(Description:)44 b Fj(This)23
b(routine)e(imp)r(orts)h(an)g(Ob)5 b(ject)22 b(p)r(oin)n(ter)g(that)h
@@ -116629,9 +116681,10 @@ y Fj(An)39 b(arra)n(y)d(with)j(one)e(elemen)n(t)i(for)e(eac)n(h)h(F)-7
b(rame)37 b(axis)h(in)g(whic)n(h)g(the)h(co)r(ordinates)e(of)h(the)h
(required)427 5693 y(in)n(tersection)27 b(will)h(b)r(e)g(returned.)p
eop end
-%%Page: 261 271
-TeXDict begin 261 270 bop 3643 52 a FG(261)259 351 y
-Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+%%Page: 262 272
+TeXDict begin 262 271 bop 0 52 a FG(262)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(ST)-8
+b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
451 y Fj(The)c(global)e(status.)0 612 y Fc(Notes:)340
893 y Fi(\017)45 b Fj(F)-7 b(or)19 b(SkyF)-7 b(rames)19
b(eac)n(h)g(curv)n(e)f(will)i(b)r(e)g(a)g(great)e(circle,)j(and)e(in)h
@@ -116722,23 +116775,22 @@ b(supplied,)j(the)d(uncertain)n(t)n(y)f(Region)g(m)n(ust)g(b)r(e)i(of)e
5693 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24 b(Circle,)g(Ellipse,)h
(etc.\))36 b(or)23 b(b)r(e)i(a)e(Prism)h(con)n(taining)f(cen)n
(tro-symetric)f(comp)r(onen)n(t)p eop end
-%%Page: 262 272
-TeXDict begin 262 271 bop 0 52 a FG(262)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(Regions.)57
-b(A)35 b(deep)f(cop)n(y)g(of)g(the)h(supplied)g(Region)f(will)g(b)r(e)h
-(tak)n(en,)h(so)e(subsequen)n(t)g(c)n(hanges)f(to)h(the)427
-451 y(uncertain)n(t)n(y)g(Region)g(using)g(the)h(supplied)g(p)r(oin)n
-(ter)g(will)f(ha)n(v)n(e)g(no)g(e\013ect)h(on)g(the)g(created)f(Bo)n
-(x.)57 b(Al-)427 551 y(ternativ)n(ely)-7 b(,)34 b(a)f(n)n(ull)g(Ob)5
-b(ject)33 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fj(NULL\))g(ma)n(y)f(b)r(e)
-i(supplied,)h(in)e(whic)n(h)g(case)f(a)h(default)427
-650 y(uncertain)n(t)n(y)27 b(is)g(used)h(equiv)-5 b(alen)n(t)27
-b(to)h(a)f(b)r(o)n(x)g(1.0E-6)f(of)h(the)h(size)f(of)h(the)g(Bo)n(x)e
-(b)r(eing)i(created.)427 768 y(The)h(uncertain)n(t)n(y)f(Region)g(has)h
-(t)n(w)n(o)f(uses:)39 b(1\))29 b(when)g(the)g(AST)p Ft(_)p
-Fj(O)n(VERLAP)f(function)h(compares)e(t)n(w)n(o)427 868
-y(Regions)j(for)g(equalit)n(y)g(the)h(uncertain)n(t)n(y)f(Region)g(is)g
-(used)h(to)g(determine)f(the)h(tolerance)f(on)g(the)h(com-)427
+%%Page: 263 273
+TeXDict begin 263 272 bop 3643 52 a FG(263)427 351 y
+Fj(Regions.)57 b(A)35 b(deep)f(cop)n(y)g(of)g(the)h(supplied)g(Region)f
+(will)g(b)r(e)h(tak)n(en,)h(so)e(subsequen)n(t)g(c)n(hanges)f(to)h(the)
+427 451 y(uncertain)n(t)n(y)g(Region)g(using)g(the)h(supplied)g(p)r
+(oin)n(ter)g(will)f(ha)n(v)n(e)g(no)g(e\013ect)h(on)g(the)g(created)f
+(Bo)n(x.)57 b(Al-)427 551 y(ternativ)n(ely)-7 b(,)34
+b(a)f(n)n(ull)g(Ob)5 b(ject)33 b(p)r(oin)n(ter)g(\(AST)p
+Ft(__)p Fj(NULL\))g(ma)n(y)f(b)r(e)i(supplied,)h(in)e(whic)n(h)g(case)f
+(a)h(default)427 650 y(uncertain)n(t)n(y)27 b(is)g(used)h(equiv)-5
+b(alen)n(t)27 b(to)h(a)f(b)r(o)n(x)g(1.0E-6)f(of)h(the)h(size)f(of)h
+(the)g(Bo)n(x)e(b)r(eing)i(created.)427 768 y(The)h(uncertain)n(t)n(y)f
+(Region)g(has)h(t)n(w)n(o)f(uses:)39 b(1\))29 b(when)g(the)g(AST)p
+Ft(_)p Fj(O)n(VERLAP)f(function)h(compares)e(t)n(w)n(o)427
+868 y(Regions)j(for)g(equalit)n(y)g(the)h(uncertain)n(t)n(y)f(Region)g
+(is)g(used)h(to)g(determine)f(the)h(tolerance)f(on)g(the)h(com-)427
967 y(parison,)23 b(and)g(2\))g(when)g(a)f(Region)h(is)g(mapp)r(ed)g
(in)n(to)g(a)f(di\013eren)n(t)i(co)r(ordinate)d(system)i(and)g
(subsequen)n(tly)427 1067 y(simpli\014ed)e(\(using)f(AST)p
@@ -116805,29 +116857,30 @@ Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
Ft(_)p Fj(INTRAREG\).)h(This)f(name)g(is)g(case)g(sensitiv)n(e.)53
b(All)427 5693 y(white)28 b(space)f(will)h(b)r(e)g(remo)n(v)n(ed)e(b)r
(efore)h(use.)p eop end
-%%Page: 263 273
-TeXDict begin 263 272 bop 3643 52 a FG(263)259 351 y
-Fc(NIN)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 451 y Fj(The)e(n)n(um)n(b)r
-(er)g(of)g(input)h(co)r(ordinates.)40 b(This)29 b(m)n(ust)h(b)r(e)f
-(compatible)g(with)h(the)f(n)n(um)n(b)r(er)g(of)g(input)h(co)r(or-)427
-551 y(dinates)25 b(accepted)g(b)n(y)g(the)g(transformation)e(routine)i
-(\(as)g(sp)r(eci\014ed)g(when)g(this)g(routine)g(w)n(as)f(registered)
-427 650 y(using)k(AST)p Ft(_)p Fj(INTRAREG\).)259 779
-y Fc(NOUT)k(=)g(INTEGER)g(\(Giv)m(en\))427 879 y Fj(The)22
-b(n)n(um)n(b)r(er)g(of)f(output)i(co)r(ordinates.)33
-b(This)22 b(m)n(ust)g(b)r(e)g(compatible)g(with)g(the)g(n)n(um)n(b)r
-(er)g(of)g(output)g(co)r(or-)427 978 y(dinates)h(pro)r(duced)g(b)n(y)g
-(the)h(transformation)e(routine)g(\(as)h(sp)r(eci\014ed)h(when)f(this)h
-(routine)f(w)n(as)f(registered)427 1078 y(using)28 b(AST)p
-Ft(_)p Fj(INTRAREG\).)259 1207 y Fc(OPTIONS)k(=)g(CHARA)m(CTER)g
-Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-1307 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)
-f(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r
-(e)427 1406 y(used)j(for)f(initialising)g(the)h(new)g(In)n(traMap.)34
-b(The)24 b(syn)n(tax)e(used)i(is)f(iden)n(tical)h(to)f(that)h(for)f
-(the)h(AST)p Ft(_)p Fj(SET)427 1506 y(routine.)259 1635
-y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 1735 y Fj(The)c(global)e(status.)0 1893 y Fc(Returned)32
+%%Page: 264 274
+TeXDict begin 264 273 bop 0 52 a FG(264)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(NIN)h(=)g(INTEGER)f
+(\(Giv)m(en\))427 451 y Fj(The)e(n)n(um)n(b)r(er)g(of)g(input)h(co)r
+(ordinates.)40 b(This)29 b(m)n(ust)h(b)r(e)f(compatible)g(with)h(the)f
+(n)n(um)n(b)r(er)g(of)g(input)h(co)r(or-)427 551 y(dinates)25
+b(accepted)g(b)n(y)g(the)g(transformation)e(routine)i(\(as)g(sp)r
+(eci\014ed)g(when)g(this)g(routine)g(w)n(as)f(registered)427
+650 y(using)k(AST)p Ft(_)p Fj(INTRAREG\).)259 779 y Fc(NOUT)k(=)g
+(INTEGER)g(\(Giv)m(en\))427 879 y Fj(The)22 b(n)n(um)n(b)r(er)g(of)f
+(output)i(co)r(ordinates.)33 b(This)22 b(m)n(ust)g(b)r(e)g(compatible)g
+(with)g(the)g(n)n(um)n(b)r(er)g(of)g(output)g(co)r(or-)427
+978 y(dinates)h(pro)r(duced)g(b)n(y)g(the)h(transformation)e(routine)g
+(\(as)h(sp)r(eci\014ed)h(when)f(this)h(routine)f(w)n(as)f(registered)
+427 1078 y(using)28 b(AST)p Ft(_)p Fj(INTRAREG\).)259
+1207 y Fc(OPTIONS)k(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1307 y Fj(A)22 b(c)n(haracter)e
+(string)h(con)n(taining)g(an)h(optional)f(comma-separated)e(list)j(of)g
+(attribute)g(assignmen)n(ts)f(to)g(b)r(e)427 1406 y(used)j(for)f
+(initialising)g(the)h(new)g(In)n(traMap.)34 b(The)24
+b(syn)n(tax)e(used)i(is)f(iden)n(tical)h(to)f(that)h(for)f(the)h(AST)p
+Ft(_)p Fj(SET)427 1506 y(routine.)259 1635 y Fc(ST)-8
+b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+1735 y Fj(The)c(global)e(status.)0 1893 y Fc(Returned)32
b(V)-8 b(alue:)259 2025 y(AST)p Ft(_)p Fc(INTRAMAP)32
b(=)g(INTEGER)427 2125 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(In)n
(traMap.)0 2283 y Fc(Notes:)340 2562 y Fi(\017)45 b Fj(A)21
@@ -116881,18 +116934,17 @@ b(A)31 b(v)-5 b(alue)31 b(of)f(AST)p Ft(__)p Fj(ANY)h(ma)n(y)427
5693 y(b)r(e)d(giv)n(en)f(if)h(the)g(routine)f(is)h(able)f(to)h(pro)r
(duce)f(a)g(v)-5 b(ariable)26 b(n)n(um)n(b)r(er)i(of)f(output)i(co)r
(ordinates.)p eop end
-%%Page: 264 274
-TeXDict begin 264 273 bop 0 52 a FG(264)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(TRAN)h(=)g(SUBR)m
-(OUTINE)g(\(Giv)m(en\))427 451 y Fj(The)20 b(transformation)d(routine)i
-(to)g(b)r(e)h(registered.)33 b(This)19 b(routine)g(should)g(p)r(erform)
-g(whatev)n(er)f(co)r(ordinate)427 551 y(transformations)26
-b(are)h(required)f(and)i(should)f(ha)n(v)n(e)f(an)i(in)n(terface)f(lik)
-n(e)g(AST)p Ft(_)p Fj(TRANN)h(\(q.v.\).)427 667 y(This)33
-b(transformation)f(routine)h(m)n(ust)g(also)f(app)r(ear)g(in)i(an)f
-(EXTERNAL)g(statemen)n(t)g(in)g(the)h(routine)427 766
-y(whic)n(h)28 b(calls)f(AST)p Ft(_)p Fj(INTRAREG.)259
-899 y Fc(FLA)m(GS)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
+%%Page: 265 275
+TeXDict begin 265 274 bop 3643 52 a FG(265)259 351 y
+Fc(TRAN)32 b(=)g(SUBR)m(OUTINE)g(\(Giv)m(en\))427 451
+y Fj(The)20 b(transformation)d(routine)i(to)g(b)r(e)h(registered.)33
+b(This)19 b(routine)g(should)g(p)r(erform)g(whatev)n(er)f(co)r
+(ordinate)427 551 y(transformations)26 b(are)h(required)f(and)i(should)
+f(ha)n(v)n(e)f(an)i(in)n(terface)f(lik)n(e)g(AST)p Ft(_)p
+Fj(TRANN)h(\(q.v.\).)427 667 y(This)33 b(transformation)f(routine)h(m)n
+(ust)g(also)f(app)r(ear)g(in)i(an)f(EXTERNAL)g(statemen)n(t)g(in)g(the)
+h(routine)427 766 y(whic)n(h)28 b(calls)f(AST)p Ft(_)p
+Fj(INTRAREG.)259 899 y Fc(FLA)m(GS)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
998 y Fj(This)j(v)-5 b(alue)33 b(ma)n(y)g(b)r(e)h(used)g(to)f(supply)h
(a)f(set)g(of)h(\015ags)e(whic)n(h)i(describ)r(e)f(the)h
(transformation)e(routine)427 1098 y(and)g(whic)n(h)h(ma)n(y)e
@@ -116977,22 +117029,22 @@ Ft(__)p Fj(NOFWD:)c(If)g(this)f(\015ag)f(is)h(set,)k(it)c(indicates)g
5693 y(implemen)n(t)24 b(a)f(forw)n(ard)e(co)r(ordinate)h
(transformation.)33 b(In)24 b(this)f(case,)g(an)n(y)f(In)n(traMap)g
(whic)n(h)h(uses)g(it)g(will)p eop end
-%%Page: 265 275
-TeXDict begin 265 274 bop 3643 52 a FG(265)427 351 y
-Fj(ha)n(v)n(e)27 b(a)h(T)-7 b(ranF)g(orw)n(ard)26 b(attribute)i(v)-5
-b(alue)28 b(of)h(zero)e(and)h(the)g(transformation)f(routine)h(itself)g
-(will)h(not)f(b)r(e)427 451 y(called)c(with)g(its)h(F)n(OR)-9
-b(W)g(ARD)24 b(argumen)n(t)f(set)h(to)g(.TR)n(UE..)35
-b(By)24 b(default,)h(it)f(is)g(assumed)g(that)g(a)f(forw)n(ard)427
-551 y(transformation)j(is)i(pro)n(vided.)340 684 y Fi(\017)45
-b Fj(AST)p Ft(__)p Fj(NOINV:)25 b(If)g(this)g(\015ag)f(is)h(set,)h(it)f
-(indicates)f(that)i(the)f(transformation)e(routine)h(do)r(es)h(not)g
-(imple-)427 784 y(men)n(t)e(an)g(in)n(v)n(erse)e(co)r(ordinate)g
-(transformation.)34 b(In)23 b(this)g(case,)f(an)n(y)g(In)n(traMap)g
-(whic)n(h)h(uses)f(it)h(will)g(ha)n(v)n(e)427 884 y(a)28
-b(T)-7 b(ranIn)n(v)n(erse)26 b(attribute)j(v)-5 b(alue)28
-b(of)g(zero)f(and)h(the)h(transformation)e(routine)h(itself)g(will)h
-(not)f(b)r(e)h(called)427 983 y(with)37 b(its)g(F)n(OR)-9
+%%Page: 266 276
+TeXDict begin 266 275 bop 0 52 a FG(266)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(ha)n(v)n(e)c(a)h(T)-7
+b(ranF)g(orw)n(ard)26 b(attribute)i(v)-5 b(alue)28 b(of)h(zero)e(and)h
+(the)g(transformation)f(routine)h(itself)g(will)h(not)f(b)r(e)427
+451 y(called)c(with)g(its)h(F)n(OR)-9 b(W)g(ARD)24 b(argumen)n(t)f(set)
+h(to)g(.TR)n(UE..)35 b(By)24 b(default,)h(it)f(is)g(assumed)g(that)g(a)
+f(forw)n(ard)427 551 y(transformation)j(is)i(pro)n(vided.)340
+684 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(NOINV:)25 b(If)g(this)g(\015ag)f
+(is)h(set,)h(it)f(indicates)f(that)i(the)f(transformation)e(routine)h
+(do)r(es)h(not)g(imple-)427 784 y(men)n(t)e(an)g(in)n(v)n(erse)e(co)r
+(ordinate)g(transformation.)34 b(In)23 b(this)g(case,)f(an)n(y)g(In)n
+(traMap)g(whic)n(h)h(uses)f(it)h(will)g(ha)n(v)n(e)427
+884 y(a)28 b(T)-7 b(ranIn)n(v)n(erse)26 b(attribute)j(v)-5
+b(alue)28 b(of)g(zero)f(and)h(the)h(transformation)e(routine)h(itself)g
+(will)h(not)f(b)r(e)h(called)427 983 y(with)37 b(its)g(F)n(OR)-9
b(W)g(ARD)37 b(argumen)n(t)e(set)h(to)h(.F)-9 b(ALSE..)63
b(By)36 b(default,)j(it)e(is)f(assumed)g(that)h(an)f(in)n(v)n(erse)427
1083 y(transformation)26 b(is)i(pro)n(vided.)340 1217
@@ -117056,49 +117108,48 @@ y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5 b(ject.)259 5455
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
427 5555 y Fj(The)c(global)e(status.)0 5718 y Fc(Class)31
b(Applicabilit)m(y:)p eop end
-%%Page: 266 276
-TeXDict begin 266 275 bop 0 52 a FG(266)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(Ob)5
-b(ject)427 451 y Fj(These)28 b(functions)f(apply)h(to)f(all)h(Ob)5
-b(jects.)0 610 y Fc(Returned)32 b(V)-8 b(alue:)259 744
-y(AST)p Ft(_)p Fc(ISA)p Fl(<)p Fc(CLASS)p Fl(>)32 b Fc(=)g(LOGICAL)427
-844 y Fj(.TR)n(UE.)f(if)h(the)f(Ob)5 b(ject)31 b(b)r(elongs)f(to)h(the)
-h(class)e(called)g Fl(<)p Fj(CLASS)p Fl(>)h Fj(\(or)f(to)h(a)g(class)f
-(deriv)n(ed)g(from)h(it\),)427 943 y(otherwise)c(.F)-9
-b(ALSE..)0 1103 y Fc(Examples:)227 1241 y Fy(MEMBER)46
-b(=)i(AST)p Ft(_)p Fy(ISAFRAME\()c(OBJ,)i(STATUS)h(\);)427
-1336 y Fj(T)-7 b(ests)33 b(whether)g(Ob)5 b(ject)33 b(OBJ)f(is)h(a)f
-(mem)n(b)r(er)h(of)g(the)g(F)-7 b(rame)33 b(class,)g(or)f(of)h(an)n(y)f
-(class)g(deriv)n(ed)g(from)h(a)427 1436 y(F)-7 b(rame.)0
-1596 y Fc(Notes:)340 1876 y Fi(\017)45 b Fj(Ev)n(ery)31
-b(AST)h(class)f(pro)n(vides)g(a)h(function)g(\(AST)p
-Ft(_)p Fj(ISA)p Fl(<)p Fj(CLASS)p Fl(>)p Fj(\))h(of)f(this)g(form,)h
-(where)f Fl(<)p Fj(CLASS)p Fl(>)427 1975 y Fj(should)c(b)r(e)g
-(replaced)e(b)n(y)i(the)g(class)e(name.)340 2106 y Fi(\017)45
-b Fj(This)25 b(function)h(attempts)f(to)g(execute)f(ev)n(en)h(if)g(ST)
--7 b(A)g(TUS)26 b(is)f(set)g(to)f(an)h(error)e(v)-5 b(alue)25
-b(on)f(en)n(try)-7 b(,)25 b(although)427 2205 y(no)j(further)f(error)f
-(rep)r(ort)h(will)g(b)r(e)h(made)g(if)g(it)g(subsequen)n(tly)f(fails)g
-(under)h(these)g(circumstances.)340 2336 y Fi(\017)45
-b Fj(A)27 b(v)-5 b(alue)27 b(of)f(.F)-9 b(ALSE.)27 b(will)g(b)r(e)g
-(returned)f(if)i(this)f(function)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)35 b(In)27 b(particular,)427 2435 y(it)h(will)g(fail)g(if)g
-(the)g(p)r(oin)n(ter)f(supplied)h(do)r(es)f(not)h(iden)n(tify)g(an)f
-(Ob)5 b(ject)28 b(of)f(an)n(y)g(sort.)p 0 2629 3780 12
-v 0 2760 a FA(AST)p Fe(_)p FA(KEYMAP)485 b Fd(Create)37
-b(a)h(KeyMap)487 b FA(AST)p Fe(_)p FA(KEYMAP)0 2944 y
-Fc(Description:)44 b Fj(This)19 b(function)g(creates)f(a)g(new)h(empt)n
-(y)g(KeyMap)e(and)i(optionally)f(initialises)g(its)h(attributes.)34
-b(En)n(tries)227 3043 y(can)h(then)h(b)r(e)g(added)f(to)h(the)f(KeyMap)
-g(using)g(the)h(AST)p Ft(_)p Fj(MAPPUT0)p Fl(<)p Fj(X)p
-Fl(>)e Fj(and)h(AST)p Ft(_)p Fj(MAPPUT1)p Fl(<)p Fj(X)p
-Fl(>)227 3143 y Fj(functions.)227 3266 y(The)20 b(KeyMap)e(class)h(is)g
-(used)h(to)f(store)g(a)g(set)g(of)h(v)-5 b(alues)19 b(with)h(asso)r
-(ciated)e(k)n(eys)g(whic)n(h)i(iden)n(tify)g(the)g(v)-5
-b(alues.)34 b(The)227 3366 y(k)n(eys)28 b(are)g(strings.)41
-b(These)28 b(ma)n(y)h(b)r(e)g(case)f(sensitiv)n(e)h(or)f(insensitiv)n
-(e)g(as)h(selected)g(b)n(y)f(the)i(KeyCase)d(attribute,)227
-3466 y(and)33 b(trailing)e(spaces)h(are)f(ignored.)50
+%%Page: 267 277
+TeXDict begin 267 276 bop 3643 52 a FG(267)259 351 y
+Fc(Ob)5 b(ject)427 451 y Fj(These)28 b(functions)f(apply)h(to)f(all)h
+(Ob)5 b(jects.)0 610 y Fc(Returned)32 b(V)-8 b(alue:)259
+744 y(AST)p Ft(_)p Fc(ISA)p Fl(<)p Fc(CLASS)p Fl(>)32
+b Fc(=)g(LOGICAL)427 844 y Fj(.TR)n(UE.)f(if)h(the)f(Ob)5
+b(ject)31 b(b)r(elongs)f(to)h(the)h(class)e(called)g
+Fl(<)p Fj(CLASS)p Fl(>)h Fj(\(or)f(to)h(a)g(class)f(deriv)n(ed)g(from)h
+(it\),)427 943 y(otherwise)c(.F)-9 b(ALSE..)0 1103 y
+Fc(Examples:)227 1241 y Fy(MEMBER)46 b(=)i(AST)p Ft(_)p
+Fy(ISAFRAME\()c(OBJ,)i(STATUS)h(\);)427 1336 y Fj(T)-7
+b(ests)33 b(whether)g(Ob)5 b(ject)33 b(OBJ)f(is)h(a)f(mem)n(b)r(er)h
+(of)g(the)g(F)-7 b(rame)33 b(class,)g(or)f(of)h(an)n(y)f(class)g(deriv)
+n(ed)g(from)h(a)427 1436 y(F)-7 b(rame.)0 1596 y Fc(Notes:)340
+1876 y Fi(\017)45 b Fj(Ev)n(ery)31 b(AST)h(class)f(pro)n(vides)g(a)h
+(function)g(\(AST)p Ft(_)p Fj(ISA)p Fl(<)p Fj(CLASS)p
+Fl(>)p Fj(\))h(of)f(this)g(form,)h(where)f Fl(<)p Fj(CLASS)p
+Fl(>)427 1975 y Fj(should)c(b)r(e)g(replaced)e(b)n(y)i(the)g(class)e
+(name.)340 2106 y Fi(\017)45 b Fj(This)25 b(function)h(attempts)f(to)g
+(execute)f(ev)n(en)h(if)g(ST)-7 b(A)g(TUS)26 b(is)f(set)g(to)f(an)h
+(error)e(v)-5 b(alue)25 b(on)f(en)n(try)-7 b(,)25 b(although)427
+2205 y(no)j(further)f(error)f(rep)r(ort)h(will)g(b)r(e)h(made)g(if)g
+(it)g(subsequen)n(tly)f(fails)g(under)h(these)g(circumstances.)340
+2336 y Fi(\017)45 b Fj(A)27 b(v)-5 b(alue)27 b(of)f(.F)-9
+b(ALSE.)27 b(will)g(b)r(e)g(returned)f(if)i(this)f(function)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)35 b(In)27 b(particular,)427
+2435 y(it)h(will)g(fail)g(if)g(the)g(p)r(oin)n(ter)f(supplied)h(do)r
+(es)f(not)h(iden)n(tify)g(an)f(Ob)5 b(ject)28 b(of)f(an)n(y)g(sort.)p
+0 2629 3780 12 v 0 2760 a FA(AST)p Fe(_)p FA(KEYMAP)485
+b Fd(Create)37 b(a)h(KeyMap)487 b FA(AST)p Fe(_)p FA(KEYMAP)0
+2944 y Fc(Description:)44 b Fj(This)19 b(function)g(creates)f(a)g(new)h
+(empt)n(y)g(KeyMap)e(and)i(optionally)f(initialises)g(its)h
+(attributes.)34 b(En)n(tries)227 3043 y(can)h(then)h(b)r(e)g(added)f
+(to)h(the)f(KeyMap)g(using)g(the)h(AST)p Ft(_)p Fj(MAPPUT0)p
+Fl(<)p Fj(X)p Fl(>)e Fj(and)h(AST)p Ft(_)p Fj(MAPPUT1)p
+Fl(<)p Fj(X)p Fl(>)227 3143 y Fj(functions.)227 3266
+y(The)20 b(KeyMap)e(class)h(is)g(used)h(to)f(store)g(a)g(set)g(of)h(v)
+-5 b(alues)19 b(with)h(asso)r(ciated)e(k)n(eys)g(whic)n(h)i(iden)n
+(tify)g(the)g(v)-5 b(alues.)34 b(The)227 3366 y(k)n(eys)28
+b(are)g(strings.)41 b(These)28 b(ma)n(y)h(b)r(e)g(case)f(sensitiv)n(e)h
+(or)f(insensitiv)n(e)g(as)h(selected)g(b)n(y)f(the)i(KeyCase)d
+(attribute,)227 3466 y(and)33 b(trailing)e(spaces)h(are)f(ignored.)50
b(The)33 b(v)-5 b(alue)32 b(asso)r(ciated)f(with)i(a)f(k)n(ey)g(can)g
(b)r(e)h(in)n(teger)e(\(signed)i(4)f(and)g(2)227 3565
y(b)n(yte,)22 b(or)d(unsigned)h(1)g(b)n(yte\),)i(\015oating)d(p)r(oin)n
@@ -117130,13 +117181,14 @@ b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
b(V)-8 b(alue:)259 5313 y(AST)p Ft(_)p Fc(MAP)32 b(=)g(INTEGER)427
5413 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(KeyMap.)0
5572 y Fc(Notes:)p eop end
-%%Page: 267 277
-TeXDict begin 267 276 bop 3643 52 a FG(267)340 351 y
-Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f
-(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f
-(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427
-451 y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g
-(should)f(fail)h(for)f(an)n(y)g(reason.)-2 624 y Fc(Status)33
+%%Page: 268 278
+TeXDict begin 268 277 bop 0 52 a FG(268)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
+Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 451
+y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)-2 624 y Fc(Status)33
b(Handling)n(:)227 770 y Fj(The)d(protected)g(in)n(terface)f(to)g(this)
h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g
(the)g(parameter)227 870 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62
@@ -117208,12 +117260,11 @@ Fj(in)h(+)f(\014t\(9\))p Fi(\003)p Fj(Y)p Ft(_)p Fj(in)259
5446 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
(Returned\))427 5545 y Fj(The)c(global)e(status.)0 5718
y Fc(Returned)32 b(V)-8 b(alue:)p eop end
-%%Page: 268 278
-TeXDict begin 268 277 bop 0 52 a FG(268)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(AST)p
-Ft(_)p Fc(LINEARAPPR)m(O)m(X)i(=)f(LOGICAL)427 451 y
-Fj(If)26 b(the)g(forw)n(ard)e(transformation)g(is)h(su\016cien)n(tly)h
-(linear,)f(.TR)n(UE)g(is)h(returned.)36 b(Otherwise)24
+%%Page: 269 279
+TeXDict begin 269 278 bop 3643 52 a FG(269)259 351 y
+Fc(AST)p Ft(_)p Fc(LINEARAPPR)m(O)m(X)33 b(=)f(LOGICAL)427
+451 y Fj(If)26 b(the)g(forw)n(ard)e(transformation)g(is)h(su\016cien)n
+(tly)h(linear,)f(.TR)n(UE)g(is)h(returned.)36 b(Otherwise)24
b(.F)-9 b(ALSE.)26 b(is)427 551 y(returned)h(and)h(the)g(\014t)g
(co-e\016cien)n(ts)e(are)h(set)h(to)f(AST)p Ft(__)p Fj(BAD.)0
712 y Fc(Notes:)340 995 y Fi(\017)45 b Fj(This)31 b(function)g(\014ts)g
@@ -117282,16 +117333,16 @@ b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
b(V)-8 b(alue:)259 5311 y(AST)p Ft(_)p Fc(LUTMAP)34 b(=)e(INTEGER)427
5410 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(LutMap.)0
5572 y Fc(Notes:)p eop end
-%%Page: 269 279
-TeXDict begin 269 278 bop 3643 52 a FG(269)340 351 y
-Fi(\017)45 b Fj(If)38 b(the)f(en)n(tries)f(in)h(the)h(lo)r(okup)e
-(table)h(either)g(increase)e(or)h(decrease)g(monotonically)-7
-b(,)38 b(then)f(the)h(new)427 451 y(LutMap's)25 b(T)-7
-b(ranIn)n(v)n(erse)23 b(attribute)j(will)f(ha)n(v)n(e)f(a)h(v)-5
-b(alue)25 b(of)g(one,)g(indicating)g(that)h(the)g(in)n(v)n(erse)d
-(transfor-)427 551 y(mation)j(can)g(b)r(e)h(p)r(erformed.)36
-b(Otherwise,)25 b(it)i(will)g(ha)n(v)n(e)e(a)g(v)-5 b(alue)27
-b(of)f(zero,)f(so)h(that)g(an)n(y)g(attempt)h(to)f(use)427
+%%Page: 270 280
+TeXDict begin 270 279 bop 0 52 a FG(270)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(If)38 b(the)f(en)n(tries)f(in)h(the)h(lo)r(okup)e(table)h(either)g
+(increase)e(or)h(decrease)g(monotonically)-7 b(,)38 b(then)f(the)h(new)
+427 451 y(LutMap's)25 b(T)-7 b(ranIn)n(v)n(erse)23 b(attribute)j(will)f
+(ha)n(v)n(e)f(a)h(v)-5 b(alue)25 b(of)g(one,)g(indicating)g(that)h(the)
+g(in)n(v)n(erse)d(transfor-)427 551 y(mation)j(can)g(b)r(e)h(p)r
+(erformed.)36 b(Otherwise,)25 b(it)i(will)g(ha)n(v)n(e)e(a)g(v)-5
+b(alue)27 b(of)f(zero,)f(so)h(that)g(an)n(y)g(attempt)h(to)f(use)427
650 y(the)i(in)n(v)n(erse)e(transformation)g(will)i(result)f(in)h(an)g
(error.)340 778 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
@@ -117373,10 +117424,9 @@ Ft(_)p Fc(OUT)32 b(=)g(DOUBLE)h(PRECISION)e(\(Returned\))427
h(nominated)f(output)h(co)r(ordinate)f(within)h(the)g(sp)r(eci\014ed)f
(region)g(of)427 5693 y(input)29 b(co)r(ordinate)d(space.)p
eop end
-%%Page: 270 280
-TeXDict begin 270 279 bop 0 52 a FG(270)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(UBND)p
-Ft(_)p Fc(OUT)h(=)g(DOUBLE)h(PRECISION)e(\(Returned\))427
+%%Page: 271 281
+TeXDict begin 271 280 bop 3643 52 a FG(271)259 351 y
+Fc(UBND)p Ft(_)p Fc(OUT)32 b(=)g(DOUBLE)h(PRECISION)e(\(Returned\))427
451 y Fj(The)h(highest)g(v)-5 b(alue)31 b(tak)n(en)g(b)n(y)h(the)g
(nominated)f(output)h(co)r(ordinate)f(within)h(the)g(sp)r(eci\014ed)g
(region)f(of)427 551 y(input)e(co)r(ordinate)d(space.)259
@@ -117451,24 +117501,24 @@ b(the)f(destination)h(con)n(tains)e(a)h(scalar)f(KeyMap)h(en)n(try)f
(destination)f(KeyMap)g(en)n(try)g(using)g(this)h(function,)h(rather)
427 5693 y(than)d(simply)g(replacing)e(the)i(destination)f(KeyMap)g(en)
n(try)-7 b(.)p eop end
-%%Page: 271 281
-TeXDict begin 271 280 bop 3643 52 a FG(271)340 351 y
-Fi(\017)45 b Fj(If)29 b(the)g(destination)f(en)n(try)g(has)f(a)h
-(non-zero)f(v)-5 b(alue)28 b(for)g(its)g(MapLo)r(c)n(k)n(ed)f
-(attribute,)i(then)g(an)f(error)e(will)427 451 y(b)r(e)36
-b(rep)r(orted)g(if)g(the)g(source)f(KeyMap)g(con)n(tains)f(an)n(y)h(k)n
-(eys)g(that)h(do)g(not)g(already)e(exist)i(within)g(the)427
-551 y(destination)28 b(KeyMap.)p 0 759 3780 12 v 0 890
-a FA(AST)p Fe(_)p FA(MAPDEFINED)p Fb(<)p FA(X)p Fb(>)1734
-891 y Fd(Chec)m(k)1807 990 y(if)38 b(a)1710 1090 y(KeyMap)1782
-1190 y(con-)1717 1289 y(tains)g(a)1812 1389 y(de-)1766
-1488 y(\014ned)1758 1588 y(v)-7 b(alue)1771 1688 y(for)38
-b(a)1804 1787 y(k)m(ey)2221 890 y FA(AST)p Fe(_)p FA(MAPDEFINED)p
-Fb(<)p FA(X)p Fb(>)0 1985 y Fc(Description:)44 b Fj(This)23
-b(function)f(c)n(hec)n(ks)f(to)h(see)g(if)h(a)f(KeyMap)f(con)n(tains)g
-(a)h(de\014ned)h(v)-5 b(alue)22 b(for)f(a)h(giv)n(en)g(k)n(ey)-7
-b(.)34 b(If)23 b(the)f(k)n(ey)227 2085 y(is)d(presen)n(t)e(in)i(the)g
-(KeyMap)e(but)i(has)f(an)g(unde\014ned)h(v)-5 b(alue)18
+%%Page: 272 282
+TeXDict begin 272 281 bop 0 52 a FG(272)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(If)29 b(the)g(destination)f(en)n(try)g(has)f(a)h(non-zero)f(v)-5
+b(alue)28 b(for)g(its)g(MapLo)r(c)n(k)n(ed)f(attribute,)i(then)g(an)f
+(error)e(will)427 451 y(b)r(e)36 b(rep)r(orted)g(if)g(the)g(source)f
+(KeyMap)g(con)n(tains)f(an)n(y)h(k)n(eys)g(that)h(do)g(not)g(already)e
+(exist)i(within)g(the)427 551 y(destination)28 b(KeyMap.)p
+0 759 3780 12 v 0 890 a FA(AST)p Fe(_)p FA(MAPDEFINED)p
+Fb(<)p FA(X)p Fb(>)1734 891 y Fd(Chec)m(k)1807 990 y(if)38
+b(a)1710 1090 y(KeyMap)1782 1190 y(con-)1717 1289 y(tains)g(a)1812
+1389 y(de-)1766 1488 y(\014ned)1758 1588 y(v)-7 b(alue)1771
+1688 y(for)38 b(a)1804 1787 y(k)m(ey)2221 890 y FA(AST)p
+Fe(_)p FA(MAPDEFINED)p Fb(<)p FA(X)p Fb(>)0 1985 y Fc(Description:)44
+b Fj(This)23 b(function)f(c)n(hec)n(ks)f(to)h(see)g(if)h(a)f(KeyMap)f
+(con)n(tains)g(a)h(de\014ned)h(v)-5 b(alue)22 b(for)f(a)h(giv)n(en)g(k)
+n(ey)-7 b(.)34 b(If)23 b(the)f(k)n(ey)227 2085 y(is)d(presen)n(t)e(in)i
+(the)g(KeyMap)e(but)i(has)f(an)g(unde\014ned)h(v)-5 b(alue)18
b(it)h(returns)f(.F)-9 b(ALSE.)18 b(\(unlik)n(e)h(AST)p
Ft(_)p Fj(MAPHASKEY)227 2185 y(whic)n(h)28 b(w)n(ould)f(return)g(.TR)n
(UE.\).)0 2343 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
@@ -117516,18 +117566,18 @@ Ft(RESULT)41 b(=)i(AST_MAPGET0)p Fl(<)p Ft(X)p Fl(>)p
Ft(\()37 b(THIS,)42 b(KEY,)g(VALUE,)f(STATUS)g(\))227
5560 y(RESULT)g(=)j(AST_MAPGET0C\()38 b(THIS,)j(KEY,)h(VALUE,)f(L,)i
(STATUS)e(\))0 5718 y Fc(Argumen)m(ts:)p eop end
-%%Page: 272 282
-TeXDict begin 272 281 bop 0 52 a FG(272)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(THIS)h(=)g(INTEGER)g
-(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)259
-596 y Fc(KEY)k(=)g(CHARA)m(CTER)f Fi(\003)h Fc(\()g Fi(\003)f
-Fc(\))h(\(Giv)m(en\))427 696 y Fj(The)f(c)n(haracter)d(string)h(iden)n
-(tifying)i(the)f(v)-5 b(alue)30 b(to)g(b)r(e)h(retriev)n(ed.)43
-b(T)-7 b(railing)30 b(spaces)f(are)g(ignored.)44 b(The)427
-796 y(supplied)26 b(string)f(is)g(con)n(v)n(erted)f(to)h(upp)r(er)g
-(case)g(b)r(efore)g(use)g(if)h(the)g(KeyCase)e(attribute)h(is)g(curren)
-n(tly)g(set)427 895 y(to)j(zero.)259 1041 y Fc(V)-11
-b(ALUE)33 b(=)f Fl(<)p Fc(X)p Fl(>)p Fc(t)m(yp)s(e)g(\(Returned\))427
+%%Page: 273 283
+TeXDict begin 273 282 bop 3643 52 a FG(273)259 351 y
+Fc(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(KeyMap.)259 596 y Fc(KEY)k(=)g(CHARA)m(CTER)f
+Fi(\003)h Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427
+696 y Fj(The)f(c)n(haracter)d(string)h(iden)n(tifying)i(the)f(v)-5
+b(alue)30 b(to)g(b)r(e)h(retriev)n(ed.)43 b(T)-7 b(railing)30
+b(spaces)f(are)g(ignored.)44 b(The)427 796 y(supplied)26
+b(string)f(is)g(con)n(v)n(erted)f(to)h(upp)r(er)g(case)g(b)r(efore)g
+(use)g(if)h(the)g(KeyCase)e(attribute)h(is)g(curren)n(tly)g(set)427
+895 y(to)j(zero.)259 1041 y Fc(V)-11 b(ALUE)33 b(=)f
+Fl(<)p Fc(X)p Fl(>)p Fc(t)m(yp)s(e)g(\(Returned\))427
1140 y Fj(The)27 b(requested)f(v)-5 b(alue.)37 b(If)27
b(the)g(requested)f(k)n(ey)g(is)g(not)h(found,)g(or)f(if)h(it)h(is)e
(found)h(but)g(has)g(an)f(unde\014ned)427 1240 y(v)-5
@@ -117586,9 +117636,10 @@ b Fj(S:)28 b(INTEGER)p Fi(\003)p Fj(2)e(\(short)h(in)n(teger\))340
b(alue,)45 b(while)227 5614 y(AST)p Ft(_)p Fj(MAPGET0I)27
b(w)n(ould)g(b)r(e)h(used)g(to)f(get)g(an)h(INTEGER,)f(etc.)p
eop end
-%%Page: 273 283
-TeXDict begin 273 282 bop 3643 52 a FG(273)p 0 351 3780
-12 v 0 482 a FA(AST)p Fe(_)p FA(MAPGET1)p Fb(<)p FA(X)p
+%%Page: 274 284
+TeXDict begin 274 283 bop 0 52 a FG(274)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(MAPGET1)p Fb(<)p FA(X)p
Fb(>)277 b Fd(Get)38 b(a)h(v)m(ector)1571 581 y(v)-7
b(alue)39 b(from)e(a)1672 681 y(KeyMap)2489 482 y FA(AST)p
Fe(_)p FA(MAPGET1)p Fb(<)p FA(X)p Fb(>)0 871 y Fc(Description:)44
@@ -117661,13 +117712,12 @@ y Fi(\017)45 b Fj(D:)28 b(DOUBLE)g(PRECISION)340 5426
y Fi(\017)45 b Fj(R:)28 b(REAL)340 5560 y Fi(\017)45
b Fj(I:)28 b(INTEGER)340 5693 y Fi(\017)45 b Fj(C:)28
b(CHARA)n(CTER)p eop end
-%%Page: 274 284
-TeXDict begin 274 283 bop 0 52 a FG(274)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
-b Fj(A:)28 b(INTEGER)f(used)h(to)f(iden)n(tify)i(an)e(AstOb)5
-b(ject)340 489 y Fi(\017)45 b Fj(S:)28 b(INTEGER)p Fi(\003)p
-Fj(2)e(\(short)h(in)n(teger\))340 627 y Fi(\017)45 b
-Fj(B:)28 b(Unsigned)f(b)n(yte)227 798 y(F)-7 b(or)18
+%%Page: 275 285
+TeXDict begin 275 284 bop 3643 52 a FG(275)340 351 y
+Fi(\017)45 b Fj(A:)28 b(INTEGER)f(used)h(to)f(iden)n(tify)i(an)e(AstOb)
+5 b(ject)340 489 y Fi(\017)45 b Fj(S:)28 b(INTEGER)p
+Fi(\003)p Fj(2)e(\(short)h(in)n(teger\))340 627 y Fi(\017)45
+b Fj(B:)28 b(Unsigned)f(b)n(yte)227 798 y(F)-7 b(or)18
b(example,)i(AST)p Ft(_)p Fj(MAPGET1D)e(w)n(ould)g(b)r(e)g(used)h(to)f
(get)g(DOUBLE)g(PRECISION)f(v)-5 b(alues,)20 b(while)f(AST)p
Ft(_)p Fj(MAPGET1I)227 898 y(w)n(ould)27 b(b)r(e)h(used)g(to)f(get)h
@@ -117725,8 +117775,9 @@ Fc(MAPGETELEM)p Fl(<)p Fc(X)p Fl(>)31 b Fc(=)h(LOGICAL)427
(unde\014ned)427 5672 y(v)-5 b(alue)28 b(\(see)f(AST)p
Ft(_)p Fj(MAPPUTU\).)h(.F)-9 b(ALSE.)28 b(is)f(returned)g(otherwise.)p
eop end
-%%Page: 275 285
-TeXDict begin 275 284 bop 3643 52 a FG(275)0 351 y Fc(Notes:)340
+%%Page: 276 286
+TeXDict begin 276 285 bop 0 52 a FG(276)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Notes:)340
633 y Fi(\017)45 b Fj(No)30 b(error)e(is)i(rep)r(orted)f(if)h(the)h
(requested)e(k)n(ey)g(cannot)h(b)r(e)g(found)g(in)g(the)h(giv)n(en)e
(KeyMap,)g(or)g(if)i(it)f(has)427 732 y(an)e(unde\014ned)g(v)-5
@@ -117785,10 +117836,9 @@ b(of)g(.F)-9 b(ALSE.)39 b(will)f(b)r(e)h(returned)f(if)h(an)f(error)e
(has)i(already)f(o)r(ccurred,)j(or)d(if)i(this)427 5628
y(function)28 b(should)g(fail)f(for)h(an)n(y)e(reason.)p
eop end
-%%Page: 276 286
-TeXDict begin 276 285 bop 0 52 a FG(276)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(MAPKEY)1158 483 y Fd(Get)38
+%%Page: 277 287
+TeXDict begin 277 286 bop 3643 52 a FG(277)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(MAPKEY)1158 483 y Fd(Get)38
b(the)h(k)m(ey)f(at)g(a)h(giv)m(en)e(index)1389 598 y(within)g(the)i
(KeyMap)2832 482 y FA(AST)p Fe(_)p FA(MAPKEY)0 798 y
Fc(Description:)44 b Fj(This)31 b(function)g(returns)e(a)h(string)g
@@ -117846,21 +117896,21 @@ b(The)22 b(supplied)427 5307 y(string)27 b(is)g(con)n(v)n(erted)f(to)h
b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
5545 y Fj(The)c(global)e(status.)0 5718 y Fc(Returned)32
b(V)-8 b(alue:)p eop end
-%%Page: 277 287
-TeXDict begin 277 286 bop 3643 52 a FG(277)259 351 y
-Fc(AST)p Ft(_)p Fc(MAPLENC)32 b(=)g(INTEGER)427 451 y
-Fj(The)j(length)g(\(i.e.)59 b(n)n(um)n(b)r(er)35 b(of)g(c)n
-(haracters\))e(of)h(the)i(longest)e(formatted)g(v)-5
-b(alue)35 b(asso)r(ciated)f(with)h(the)427 551 y(named)28
-b(en)n(try)-7 b(.)0 718 y Fc(Notes:)340 1007 y Fi(\017)45
-b Fj(A)21 b(function)g(v)-5 b(alue)21 b(of)f(zero)f(will)i(b)r(e)g
-(returned)f(without)h(error)e(if)i(the)g(named)f(en)n(try)g(cannot)g(b)
-r(e)h(formatted)427 1106 y(as)27 b(a)g(c)n(haracter)f(string.)340
-1242 y Fi(\017)45 b Fj(A)29 b(function)g(v)-5 b(alue)28
-b(of)g(zero)f(will)h(b)r(e)h(returned)e(if)i(an)f(error)e(has)i
-(already)e(o)r(ccurred,)i(or)f(if)i(this)f(function)427
-1342 y(should)g(fail)f(for)g(an)n(y)g(reason.)p 0 1547
-3780 12 v 0 1677 a FA(AST)p Fe(_)p FA(MAPLENGTH)1519
+%%Page: 278 288
+TeXDict begin 278 287 bop 0 52 a FG(278)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(AST)p
+Ft(_)p Fc(MAPLENC)h(=)g(INTEGER)427 451 y Fj(The)j(length)g(\(i.e.)59
+b(n)n(um)n(b)r(er)35 b(of)g(c)n(haracters\))e(of)h(the)i(longest)e
+(formatted)g(v)-5 b(alue)35 b(asso)r(ciated)f(with)h(the)427
+551 y(named)28 b(en)n(try)-7 b(.)0 718 y Fc(Notes:)340
+1007 y Fi(\017)45 b Fj(A)21 b(function)g(v)-5 b(alue)21
+b(of)f(zero)f(will)i(b)r(e)g(returned)f(without)h(error)e(if)i(the)g
+(named)f(en)n(try)g(cannot)g(b)r(e)h(formatted)427 1106
+y(as)27 b(a)g(c)n(haracter)f(string.)340 1242 y Fi(\017)45
+b Fj(A)29 b(function)g(v)-5 b(alue)28 b(of)g(zero)f(will)h(b)r(e)h
+(returned)e(if)i(an)f(error)e(has)i(already)e(o)r(ccurred,)i(or)f(if)i
+(this)f(function)427 1342 y(should)g(fail)f(for)g(an)n(y)g(reason.)p
+0 1547 3780 12 v 0 1677 a FA(AST)p Fe(_)p FA(MAPLENGTH)1519
1678 y Fd(Get)38 b(the)h(v)m(ector)1430 1778 y(length)e(of)i(an)f(en)m
(try)1555 1891 y(in)g(a)h(KeyMap)2549 1677 y FA(AST)p
Fe(_)p FA(MAPLENGTH)0 2091 y Fc(Description:)44 b Fj(This)23
@@ -117907,19 +117957,18 @@ Fj(section)g(b)r(elo)n(w)g(for)g(the)h(co)r(de)f(appropriate)f(to)i
y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_MAPPUT0)p
Fl(<)p Ft(X)p Fl(>)p Ft(\()37 b(THIS,)42 b(KEY,)f(VALUE,)h(COMMENT,)e
(STATUS)h(\))0 5718 y Fc(Argumen)m(ts:)p eop end
-%%Page: 278 288
-TeXDict begin 278 287 bop 0 52 a FG(278)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(THIS)h(=)g(INTEGER)g
-(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap)e(in)i
-(whic)n(h)g(to)f(store)g(the)h(supplied)g(v)-5 b(alue.)259
-581 y Fc(KEY)32 b(=)g(CHARA)m(CTER)f Fi(\003)h Fc(\()g
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 681 y Fj(A)27 b(c)n(haracter)e
-(string)h(to)h(b)r(e)g(stored)f(with)i(the)f(v)-5 b(alue,)27
-b(whic)n(h)g(can)f(later)g(b)r(e)i(used)e(to)h(iden)n(tify)g(the)h(v)-5
-b(alue.)427 780 y(T)e(railing)28 b(spaces)h(are)f(ignored.)40
-b(The)29 b(supplied)h(string)e(is)h(con)n(v)n(erted)f(to)h(upp)r(er)g
-(case)g(b)r(efore)g(use)g(if)g(the)427 880 y(KeyCase)d(attribute)i(is)g
-(curren)n(tly)e(set)i(to)f(zero.)259 1010 y Fc(V)-11
+%%Page: 279 289
+TeXDict begin 279 288 bop 3643 52 a FG(279)259 351 y
+Fc(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(KeyMap)e(in)i(whic)n(h)g(to)f(store)g(the)h(supplied)g(v)
+-5 b(alue.)259 581 y Fc(KEY)32 b(=)g(CHARA)m(CTER)f Fi(\003)h
+Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427 681 y Fj(A)27
+b(c)n(haracter)e(string)h(to)h(b)r(e)g(stored)f(with)i(the)f(v)-5
+b(alue,)27 b(whic)n(h)g(can)f(later)g(b)r(e)i(used)e(to)h(iden)n(tify)g
+(the)h(v)-5 b(alue.)427 780 y(T)e(railing)28 b(spaces)h(are)f(ignored.)
+40 b(The)29 b(supplied)h(string)e(is)h(con)n(v)n(erted)f(to)h(upp)r(er)
+g(case)g(b)r(efore)g(use)g(if)g(the)427 880 y(KeyCase)d(attribute)i(is)
+g(curren)n(tly)e(set)i(to)f(zero.)259 1010 y Fc(V)-11
b(ALUE)33 b(=)f Fl(<)p Fc(X)p Fl(>)p Fc(t)m(yp)s(e)g(\(Giv)m(en\))427
1110 y Fj(The)d(v)-5 b(alue)28 b(to)g(b)r(e)h(stored.)38
b(The)28 b(data)g(t)n(yp)r(e)h(of)f(this)h(v)-5 b(alue)28
@@ -117986,37 +118035,37 @@ y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_MAPPUT1)p
Fl(<)p Ft(X)p Fl(>)p Ft(\()37 b(THIS,)42 b(KEY,)f(SIZE,)h(VALUE,)f
(COMMENT,)f(STATUS)h(\))0 5718 y Fc(Argumen)m(ts:)p eop
end
-%%Page: 279 289
-TeXDict begin 279 288 bop 3643 52 a FG(279)259 351 y
-Fc(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(KeyMap)e(in)i(whic)n(h)g(to)f(store)g(the)h(supplied)g(v)
--5 b(alues.)259 585 y Fc(KEY)32 b(=)g(CHARA)m(CTER)f
+%%Page: 280 290
+TeXDict begin 280 289 bop 0 52 a FG(280)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(THIS)h(=)g(INTEGER)g
+(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap)e(in)i
+(whic)n(h)g(to)f(store)g(the)h(supplied)g(v)-5 b(alues.)259
+585 y Fc(KEY)32 b(=)g(CHARA)m(CTER)f Fi(\003)h Fc(\()g
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 685 y Fj(A)24 b(c)n(haracter)c
+(string)j(to)g(b)r(e)g(stored)f(with)h(the)h(v)-5 b(alues,)23
+b(whic)n(h)g(can)g(later)f(b)r(e)h(used)g(to)g(iden)n(tify)h(the)f(v)-5
+b(alues.)427 784 y(T)e(railing)28 b(spaces)h(are)f(ignored.)40
+b(The)29 b(supplied)h(string)e(is)h(con)n(v)n(erted)f(to)h(upp)r(er)g
+(case)g(b)r(efore)g(use)g(if)g(the)427 884 y(KeyCase)d(attribute)i(is)g
+(curren)n(tly)e(set)i(to)f(zero.)259 1018 y Fc(SIZE)32
+b(=)g(INTEGER)g(\(Giv)m(en\))427 1118 y Fj(The)c(n)n(um)n(b)r(er)f(of)h
+(elemen)n(ts)f(in)h(the)g(supplied)g(arra)n(y)d(of)j(v)-5
+b(alues.)259 1252 y Fc(V)-11 b(ALUE\()33 b Fi(\003)f
+Fc(\))g(=)g Fl(<)p Fc(X)p Fl(>)p Fc(t)m(yp)s(e)f(\(Giv)m(en\))427
+1352 y Fj(The)g(arra)n(y)c(of)k(v)-5 b(alues)29 b(to)h(b)r(e)h(stored.)
+44 b(The)30 b(data)g(t)n(yp)r(e)g(of)g(this)h(v)-5 b(alue)30
+b(should)g(matc)n(h)g(the)g(1-c)n(haracter)427 1451 y(t)n(yp)r(e)f(co)r
+(de)g(app)r(ended)g(to)g(the)h(routine)e(name)h(\(e.g.)41
+b(if)29 b(y)n(ou)f(are)g(using)h(AST)p Ft(_)p Fj(MAPPUT1A,)f(the)h(t)n
+(yp)r(e)427 1551 y(of)f(this)g(v)-5 b(alue)27 b(should)h(b)r(e)g
+Ft(")p Fj(in)n(teger)e(p)r(oin)n(ter)h(for)g(an)g(AstOb)5
+b(ject\))p Ft(")p Fj(.)259 1685 y Fc(COMMENT)31 b(=)h(CHARA)m(CTER)f
Fi(\003)h Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-685 y Fj(A)24 b(c)n(haracter)c(string)j(to)g(b)r(e)g(stored)f(with)h
-(the)h(v)-5 b(alues,)23 b(whic)n(h)g(can)g(later)f(b)r(e)h(used)g(to)g
-(iden)n(tify)h(the)f(v)-5 b(alues.)427 784 y(T)e(railing)28
-b(spaces)h(are)f(ignored.)40 b(The)29 b(supplied)h(string)e(is)h(con)n
-(v)n(erted)f(to)h(upp)r(er)g(case)g(b)r(efore)g(use)g(if)g(the)427
-884 y(KeyCase)d(attribute)i(is)g(curren)n(tly)e(set)i(to)f(zero.)259
-1018 y Fc(SIZE)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1118
-y Fj(The)c(n)n(um)n(b)r(er)f(of)h(elemen)n(ts)f(in)h(the)g(supplied)g
-(arra)n(y)d(of)j(v)-5 b(alues.)259 1252 y Fc(V)-11 b(ALUE\()33
-b Fi(\003)f Fc(\))g(=)g Fl(<)p Fc(X)p Fl(>)p Fc(t)m(yp)s(e)f(\(Giv)m
-(en\))427 1352 y Fj(The)g(arra)n(y)c(of)k(v)-5 b(alues)29
-b(to)h(b)r(e)h(stored.)44 b(The)30 b(data)g(t)n(yp)r(e)g(of)g(this)h(v)
--5 b(alue)30 b(should)g(matc)n(h)g(the)g(1-c)n(haracter)427
-1451 y(t)n(yp)r(e)f(co)r(de)g(app)r(ended)g(to)g(the)h(routine)e(name)h
-(\(e.g.)41 b(if)29 b(y)n(ou)f(are)g(using)h(AST)p Ft(_)p
-Fj(MAPPUT1A,)f(the)h(t)n(yp)r(e)427 1551 y(of)f(this)g(v)-5
-b(alue)27 b(should)h(b)r(e)g Ft(")p Fj(in)n(teger)e(p)r(oin)n(ter)h
-(for)g(an)g(AstOb)5 b(ject\))p Ft(")p Fj(.)259 1685 y
-Fc(COMMENT)31 b(=)h(CHARA)m(CTER)f Fi(\003)h Fc(\()g
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1785 y Fj(A)c(commen)n(t)g(string)f
-(to)g(b)r(e)h(stored)f(with)h(the)g(v)-5 b(alues.)259
-1919 y Fc(ST)d(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 2019 y Fj(The)c(global)e(status.)0 2183
-y Fc(Notes:)340 2469 y Fi(\017)45 b Fj(If)23 b(the)g(supplied)g(k)n(ey)
-f(is)g(already)f(in)i(use)f(in)h(the)g(KeyMap,)f(the)h(new)g(v)-5
+1785 y Fj(A)c(commen)n(t)g(string)f(to)g(b)r(e)h(stored)f(with)h(the)g
+(v)-5 b(alues.)259 1919 y Fc(ST)d(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m
+(en)h(and)g(Returned\))427 2019 y Fj(The)c(global)e(status.)0
+2183 y Fc(Notes:)340 2469 y Fi(\017)45 b Fj(If)23 b(the)g(supplied)g(k)
+n(ey)f(is)g(already)f(in)i(use)f(in)h(the)g(KeyMap,)f(the)h(new)g(v)-5
b(alues)22 b(will)g(replace)g(the)h(old)f(v)-5 b(alues.)-2
2633 y Fc(Data)33 b(T)m(yp)s(e)g(Co)s(des)n(:)227 2779
y Fj(T)-7 b(o)18 b(select)h(the)f(appropriate)f(routine,)j(y)n(ou)d
@@ -118044,9 +118093,8 @@ y(v)-7 b(alue)1791 4819 y(in)m(to)1828 4918 y(an)1802
5317 y(v)m(ec-)1815 5417 y(tor)1762 5516 y(v)-7 b(alue)1792
5616 y(in)39 b(a)1762 5715 y(KeyMap)2170 4520 y FA(AST)p
Fe(_)p FA(MAPPUTELEM)p Fb(<)p FA(X)p Fb(>)p eop end
-%%Page: 280 290
-TeXDict begin 280 289 bop 0 52 a FG(280)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Description:)44
+%%Page: 281 291
+TeXDict begin 281 290 bop 3643 52 a FG(281)0 351 y Fc(Description:)44
b Fj(This)c(is)f(a)g(set)h(of)f(functions)h(for)f(storing)f(a)h(v)-5
b(alue)40 b(in)g(a)f(single)g(elemen)n(t)g(of)h(a)f(v)n(ector)f(v)-5
b(alue)39 b(in)227 451 y(a)c(KeyMap.)57 b(Y)-7 b(ou)35
@@ -118118,11 +118166,12 @@ b(CHARA)n(CTER)340 5558 y Fi(\017)45 b Fj(A:)28 b(INTEGER)f(used)h(to)f
(iden)n(tify)i(an)e(AstOb)5 b(ject)340 5693 y Fi(\017)45
b Fj(S:)28 b(INTEGER)p Fi(\003)p Fj(2)e(\(short)h(in)n(teger\))p
eop end
-%%Page: 281 291
-TeXDict begin 281 290 bop 3643 52 a FG(281)340 351 y
-Fi(\017)45 b Fj(B:)28 b(BYTE)f(\(unsigned\))227 539 y(F)-7
-b(or)24 b(example,)h(AST)p Ft(_)p Fj(MAPPUTELEMD)e(w)n(ould)h(b)r(e)h
-(used)g(to)f(put)h(a)f(DOUBLE)g(PRECISION)f(v)-5 b(alue,)25
+%%Page: 282 292
+TeXDict begin 282 291 bop 0 52 a FG(282)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(B:)28 b(BYTE)f(\(unsigned\))227 539 y(F)-7 b(or)24
+b(example,)h(AST)p Ft(_)p Fj(MAPPUTELEMD)e(w)n(ould)h(b)r(e)h(used)g
+(to)f(put)h(a)f(DOUBLE)g(PRECISION)f(v)-5 b(alue,)25
b(while)227 639 y(AST)p Ft(_)p Fj(MAPPUTELEMI)h(w)n(ould)i(b)r(e)g
(used)f(to)h(put)g(an)f(INTEGER)g(v)-5 b(alue,)28 b(etc.)p
0 864 3780 12 v 0 995 a FA(AST)p Fe(_)p FA(MAPPUTU)1196
@@ -118176,44 +118225,44 @@ b Ft(RESULT)41 b(=)i(AST_MAPREGION\()38 b(THIS,)j(MAP,)h(FRAME,)f
(STATUS)g(\))0 5431 y Fc(Argumen)m(ts:)259 5593 y(THIS)32
b(=)g(INTEGER)g(\(Giv)m(en\))427 5693 y Fj(P)n(oin)n(ter)26
b(to)i(the)g(Region.)p eop end
-%%Page: 282 292
-TeXDict begin 282 291 bop 0 52 a FG(282)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(MAP)h(=)g(INTEGER)f
-(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)25 b(to)i(a)f(Mapping)g(whic)n
-(h)h(transforms)e(p)r(ositions)h(from)h(the)g(co)r(ordinate)e(system)h
-(represen)n(ted)g(b)n(y)427 551 y(the)32 b(supplied)g(Region)e(to)i
-(the)f(co)r(ordinate)f(system)i(sp)r(eci\014ed)f(b)n(y)g(FRAME.)h(The)f
-(supplied)h(Mapping)427 650 y(should)k(de\014ne)f(b)r(oth)h(forw)n(ard)
-e(and)i(in)n(v)n(erse)e(transformations,)h(and)h(these)f
-(transformations)f(should)427 750 y(form)20 b(a)g(gen)n(uine)g(in)n(v)n
-(erse)f(pair.)33 b(That)21 b(is,)g(transforming)e(a)h(p)r(osition)g
-(using)g(the)h(forw)n(ard)d(transformation)427 849 y(and)29
-b(then)g(using)f(the)h(in)n(v)n(erse)e(transformation)g(should)h(pro)r
-(duce)h(the)g(original)e(input)i(p)r(osition.)40 b(Some)427
-949 y(Mapping)31 b(classes)e(\(suc)n(h)i(as)f(P)n(ermMap,)g(MathMap,)i
-(SphMap\))f(can)g(result)f(in)h(Mappings)f(for)h(whic)n(h)427
-1049 y(this)d(is)g(not)f(true.)259 1182 y Fc(FRAME)k(=)h(INTEGER)g
-(\(Giv)m(en\))427 1281 y Fj(P)n(oin)n(ter)26 b(to)i(a)f(F)-7
-b(rame)27 b(describing)g(the)h(co)r(ordinate)e(system)h(in)h(whic)n(h)g
-(the)g(new)f(Region)g(is)h(required.)259 1414 y Fc(ST)-8
-b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-1514 y Fj(The)c(global)e(status.)0 1676 y Fc(Returned)32
-b(V)-8 b(alue:)259 1813 y(AST)p Ft(_)p Fc(MAPREGION)31
-b(=)h(INTEGER)427 1913 y Fj(A)26 b(p)r(oin)n(ter)e(to)h(a)f(new)h
-(Region.)36 b(This)24 b(Region)h(will)g(represen)n(t)e(the)j(area)d
-(within)j(the)f(co)r(ordinate)f(system)427 2013 y(sp)r(eci\014ed)k(b)n
-(y)f(FRAME)h(whic)n(h)g(corresp)r(onds)e(to)h(the)h(supplied)g(Region.)
-0 2175 y Fc(Notes:)340 2458 y Fi(\017)45 b Fj(The)24
-b(uncertain)n(t)n(y)f(asso)r(ciated)f(with)i(the)h(supplied)f(Region)f
-(is)g(mo)r(di\014ed)h(using)g(the)g(supplied)g(Mapping.)340
-2591 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20
-b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e
-(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 2691 y(set)28 b(to)f(an)h(error)d(v)-5
-b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-0 2890 3780 12 v 0 3021 a FA(AST)p Fe(_)p FA(MAPREMO)l(VE)1419
-3022 y Fd(Remo)m(v)m(ed)38 b(a)g(named)1569 3122 y(en)m(try)g(from)g(a)
-1672 3235 y(KeyMap)2524 3021 y FA(AST)p Fe(_)p FA(MAPREMO)l(VE)0
+%%Page: 283 293
+TeXDict begin 283 292 bop 3643 52 a FG(283)259 351 y
+Fc(MAP)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)25
+b(to)i(a)f(Mapping)g(whic)n(h)h(transforms)e(p)r(ositions)h(from)h(the)
+g(co)r(ordinate)e(system)h(represen)n(ted)g(b)n(y)427
+551 y(the)32 b(supplied)g(Region)e(to)i(the)f(co)r(ordinate)f(system)i
+(sp)r(eci\014ed)f(b)n(y)g(FRAME.)h(The)f(supplied)h(Mapping)427
+650 y(should)k(de\014ne)f(b)r(oth)h(forw)n(ard)e(and)i(in)n(v)n(erse)e
+(transformations,)h(and)h(these)f(transformations)f(should)427
+750 y(form)20 b(a)g(gen)n(uine)g(in)n(v)n(erse)f(pair.)33
+b(That)21 b(is,)g(transforming)e(a)h(p)r(osition)g(using)g(the)h(forw)n
+(ard)d(transformation)427 849 y(and)29 b(then)g(using)f(the)h(in)n(v)n
+(erse)e(transformation)g(should)h(pro)r(duce)h(the)g(original)e(input)i
+(p)r(osition.)40 b(Some)427 949 y(Mapping)31 b(classes)e(\(suc)n(h)i
+(as)f(P)n(ermMap,)g(MathMap,)i(SphMap\))f(can)g(result)f(in)h(Mappings)
+f(for)h(whic)n(h)427 1049 y(this)d(is)g(not)f(true.)259
+1182 y Fc(FRAME)k(=)h(INTEGER)g(\(Giv)m(en\))427 1281
+y Fj(P)n(oin)n(ter)26 b(to)i(a)f(F)-7 b(rame)27 b(describing)g(the)h
+(co)r(ordinate)e(system)h(in)h(whic)n(h)g(the)g(new)f(Region)g(is)h
+(required.)259 1414 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)
+h(and)g(Returned\))427 1514 y Fj(The)c(global)e(status.)0
+1676 y Fc(Returned)32 b(V)-8 b(alue:)259 1813 y(AST)p
+Ft(_)p Fc(MAPREGION)31 b(=)h(INTEGER)427 1913 y Fj(A)26
+b(p)r(oin)n(ter)e(to)h(a)f(new)h(Region.)36 b(This)24
+b(Region)h(will)g(represen)n(t)e(the)j(area)d(within)j(the)f(co)r
+(ordinate)f(system)427 2013 y(sp)r(eci\014ed)k(b)n(y)f(FRAME)h(whic)n
+(h)g(corresp)r(onds)e(to)h(the)h(supplied)g(Region.)0
+2175 y Fc(Notes:)340 2458 y Fi(\017)45 b Fj(The)24 b(uncertain)n(t)n(y)
+f(asso)r(ciated)f(with)i(the)h(supplied)f(Region)f(is)g(mo)r(di\014ed)h
+(using)g(the)g(supplied)g(Mapping.)340 2591 y Fi(\017)45
+b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
+Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 2691
+y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 2890 3780 12 v 0 3021
+a FA(AST)p Fe(_)p FA(MAPREMO)l(VE)1419 3022 y Fd(Remo)m(v)m(ed)38
+b(a)g(named)1569 3122 y(en)m(try)g(from)g(a)1672 3235
+y(KeyMap)2524 3021 y FA(AST)p Fe(_)p FA(MAPREMO)l(VE)0
3424 y Fc(Description:)44 b Fj(This)35 b(routine)g(remo)n(v)n(es)e(a)i
(named)g(en)n(try)g(from)f(a)h(KeyMap.)59 b(It)35 b(returns)f(without)i
(action)f(if)g(the)227 3524 y(KeyMap)27 b(do)r(es)g(not)h(con)n(tain)f
@@ -118239,11 +118288,12 @@ b Fj(This)24 b(routine)f(asso)r(ciated)g(a)g(new)h(k)n(ey)f(with)h(an)g
(the)g(KeyMap.)0 5693 y Fc(In)m(v)m(o)s(cation:)123 b
Ft(CALL)42 b(AST_MAPRENAME\()37 b(THIS,)42 b(OLDKEY,)f(NEWKEY,)f
(STATUS)h(\))p eop end
-%%Page: 283 293
-TeXDict begin 283 292 bop 3643 52 a FG(283)0 351 y Fc(Argumen)m(ts:)259
-492 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 591 y
-Fj(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)259 726 y Fc(OLDKEY)k(=)g
-(CHARA)m(CTER)g Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
+%%Page: 284 294
+TeXDict begin 284 293 bop 0 52 a FG(284)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Argumen)m(ts:)259
+492 y(THIS)h(=)g(INTEGER)g(\(Giv)m(en\))427 591 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(KeyMap.)259 726 y Fc(OLDKEY)k(=)g(CHARA)m(CTER)g
+Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
826 y Fj(The)f(c)n(haracter)d(string)i(iden)n(tifying)h(the)g(en)n(try)
f(to)h(b)r(e)g(renamed.)45 b(T)-7 b(railing)30 b(spaces)f(are)h
(ignored.)45 b(The)427 925 y(supplied)26 b(string)f(is)g(con)n(v)n
@@ -118297,13 +118347,13 @@ b(Also,)28 b(an)n(y)f(output)i(whic)n(h)f(is)g(not)227
5565 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_MAPSPLIT\()c
(THIS,)j(NIN,)h(IN,)h(OUT,)f(MAP,)g(STATUS)f(\))0 5718
y Fc(Argumen)m(ts:)p eop end
-%%Page: 284 294
-TeXDict begin 284 293 bop 0 52 a FG(284)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(THIS)h(=)g(INTEGER)g
-(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Mapping)f(to)g
-(b)r(e)h(split.)259 585 y Fc(NIN)k(=)g(INTEGER)f(\(Giv)m(en\))427
-685 y Fj(The)d(n)n(um)n(b)r(er)f(of)h(inputs)g(to)f(pic)n(k)h(from)f
-(THIS.)259 818 y Fc(IN\()32 b(NIN)f(\))h(=)g(INTEGER)g(\(Giv)m(en\))427
+%%Page: 285 295
+TeXDict begin 285 294 bop 3643 52 a FG(285)259 351 y
+Fc(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(Mapping)f(to)g(b)r(e)h(split.)259 585 y
+Fc(NIN)k(=)g(INTEGER)f(\(Giv)m(en\))427 685 y Fj(The)d(n)n(um)n(b)r(er)
+f(of)h(inputs)g(to)f(pic)n(k)h(from)f(THIS.)259 818 y
+Fc(IN\()32 b(NIN)f(\))h(=)g(INTEGER)g(\(Giv)m(en\))427
918 y Fj(An)39 b(arra)n(y)c(holding)j(the)g(indices)g(within)h(the)f
(supplied)h(Mapping)e(of)h(the)h(inputs)f(whic)n(h)g(are)f(to)h(b)r(e)
427 1018 y(pic)n(k)n(ed)31 b(from)h(the)g(Mapping.)49
@@ -118375,8 +118425,9 @@ b(alues)21 b(created)g(b)n(y)h(AST)p Ft(_)p Fj(MAPPUTU\).)g(AST)p
Ft(__)p Fj(BADTYPE)f(is)g(returned)h(if)g(the)g(sup-)427
5677 y(plied)28 b(k)n(ey)f(is)h(not)f(found)h(in)g(the)g(KeyMap.)p
eop end
-%%Page: 285 295
-TeXDict begin 285 294 bop 3643 52 a FG(285)0 351 y Fc(Notes:)340
+%%Page: 286 296
+TeXDict begin 286 295 bop 0 52 a FG(286)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Notes:)340
673 y Fi(\017)45 b Fj(A)26 b(function)g(v)-5 b(alue)26
b(of)f(AST)p Ft(__)p Fj(BADTYPE)g(will)h(b)r(e)g(returned)f(if)h(an)f
(error)f(has)h(already)f(o)r(ccurred,)g(or)h(if)427 773
@@ -118444,15 +118495,14 @@ n(t)f(and)h(base)f(F)-7 b(rames)28 b(of)h(the)g(Plot)427
5603 y(is)f(not)f(de\014ned)h(\(i.e.)38 b(the)28 b(Plot's)e(T)-7
b(ranIn)n(v)n(erse)26 b(attribute)h(is)h(zero\).)p eop
end
-%%Page: 286 296
-TeXDict begin 286 295 bop 0 52 a FG(286)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(MASK)p Fb(<)p FA(X)p Fb(>)1280
-483 y Fd(Mask)39 b(a)f(region)f(of)i(a)f(data)1789 598
-y(grid)2755 482 y FA(AST)p Fe(_)p FA(MASK)p Fb(<)p FA(X)p
-Fb(>)0 781 y Fc(Description:)44 b Fj(This)34 b(is)f(a)g(set)g(of)g
-(functions)h(for)e(masking)h(out)g(regions)f(within)i(gridded)e(data)h
-(\(e.g.)54 b(an)33 b(image\).)227 881 y(The)g(functions)h(mo)r
+%%Page: 287 297
+TeXDict begin 287 296 bop 3643 52 a FG(287)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(MASK)p Fb(<)p FA(X)p
+Fb(>)1280 483 y Fd(Mask)39 b(a)f(region)f(of)i(a)f(data)1789
+598 y(grid)2755 482 y FA(AST)p Fe(_)p FA(MASK)p Fb(<)p
+FA(X)p Fb(>)0 781 y Fc(Description:)44 b Fj(This)34 b(is)f(a)g(set)g
+(of)g(functions)h(for)e(masking)h(out)g(regions)f(within)i(gridded)e
+(data)h(\(e.g.)54 b(an)33 b(image\).)227 881 y(The)g(functions)h(mo)r
(di\014es)f(a)f(giv)n(en)h(data)f(grid)h(b)n(y)f(assigning)g(a)g(sp)r
(eci\014ed)i(v)-5 b(alue)33 b(to)f(all)h(samples)g(whic)n(h)g(are)227
981 y(inside)28 b(\(or)f(outside)g(if)h(INSIDE)g(is)g(.F)-9
@@ -118539,27 +118589,28 @@ y(along)24 b(a)h(particular)f(\(J'th\))j(dimension)e(b)r(eing)g
(ving)g(unit)h(exten)n(t)f(along)f(eac)n(h)h(dimension)g(with)h(in)n
(tegral)427 5693 y(co)r(ordinate)27 b(v)-5 b(alues)27
b(at)g(its)h(cen)n(tre.)p eop end
-%%Page: 287 297
-TeXDict begin 287 296 bop 3643 52 a FG(287)259 351 y
-Fc(IN\()32 b Fi(\003)f Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p
-Fl(>)g Fc(\(Giv)m(en)g(and)g(Returned\))427 451 y Fj(An)24
-b(arra)n(y)-7 b(,)21 b(with)j(one)f(elemen)n(t)g(for)f(eac)n(h)g(pixel)
-i(in)f(the)g(input)h(grid,)f(con)n(taining)f(the)i(data)e(to)h(b)r(e)g
-(mask)n(ed.)427 551 y(The)30 b(n)n(umerical)e(t)n(yp)r(e)h(of)h(this)f
-(arra)n(y)e(should)i(matc)n(h)g(the)h(1-)e(or)g(2-c)n(haracter)f(t)n
-(yp)r(e)i(co)r(de)g(app)r(ended)h(to)427 650 y(the)24
-b(function)g(name)f(\(e.g.)35 b(if)23 b(y)n(ou)g(are)f(using)h(AST)p
-Ft(_)p Fj(MASKR,)g(the)h(t)n(yp)r(e)f(of)g(eac)n(h)g(arra)n(y)e(elemen)
-n(t)i(should)427 750 y(b)r(e)28 b(REAL\).)427 878 y(The)33
-b(storage)f(order)f(of)j(data)e(within)i(this)g(arra)n(y)c(should)j(b)r
-(e)h(suc)n(h)f(that)g(the)h(index)f(of)g(the)g(\014rst)g(grid)427
-978 y(dimension)39 b(v)-5 b(aries)39 b(most)g(rapidly)g(and)g(that)g
-(of)h(the)f(\014nal)g(dimension)h(least)f(rapidly)f(\(i.e.)73
-b(normal)427 1077 y(F)-7 b(ortran)27 b(arra)n(y)e(storage)h(order\).)
-427 1205 y(On)h(exit,)h(the)g(samples)e(sp)r(eci\014ed)i(b)n(y)f
-(INSIDE)g(are)g(set)g(to)g(the)h(v)-5 b(alue)27 b(of)g(V)-9
-b(AL.)28 b(All)f(other)g(samples)g(are)427 1305 y(left)i(unc)n(hanged.)
-259 1462 y Fc(V)-11 b(AL)33 b(=)f Fl(<)p Fc(Xt)m(yp)s(e)p
+%%Page: 288 298
+TeXDict begin 288 297 bop 0 52 a FG(288)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(IN\()h
+Fi(\003)f Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p Fl(>)g
+Fc(\(Giv)m(en)g(and)g(Returned\))427 451 y Fj(An)24 b(arra)n(y)-7
+b(,)21 b(with)j(one)f(elemen)n(t)g(for)f(eac)n(h)g(pixel)i(in)f(the)g
+(input)h(grid,)f(con)n(taining)f(the)i(data)e(to)h(b)r(e)g(mask)n(ed.)
+427 551 y(The)30 b(n)n(umerical)e(t)n(yp)r(e)h(of)h(this)f(arra)n(y)e
+(should)i(matc)n(h)g(the)h(1-)e(or)g(2-c)n(haracter)f(t)n(yp)r(e)i(co)r
+(de)g(app)r(ended)h(to)427 650 y(the)24 b(function)g(name)f(\(e.g.)35
+b(if)23 b(y)n(ou)g(are)f(using)h(AST)p Ft(_)p Fj(MASKR,)g(the)h(t)n(yp)
+r(e)f(of)g(eac)n(h)g(arra)n(y)e(elemen)n(t)i(should)427
+750 y(b)r(e)28 b(REAL\).)427 878 y(The)33 b(storage)f(order)f(of)j
+(data)e(within)i(this)g(arra)n(y)c(should)j(b)r(e)h(suc)n(h)f(that)g
+(the)h(index)f(of)g(the)g(\014rst)g(grid)427 978 y(dimension)39
+b(v)-5 b(aries)39 b(most)g(rapidly)g(and)g(that)g(of)h(the)f(\014nal)g
+(dimension)h(least)f(rapidly)f(\(i.e.)73 b(normal)427
+1077 y(F)-7 b(ortran)27 b(arra)n(y)e(storage)h(order\).)427
+1205 y(On)h(exit,)h(the)g(samples)e(sp)r(eci\014ed)i(b)n(y)f(INSIDE)g
+(are)g(set)g(to)g(the)h(v)-5 b(alue)27 b(of)g(V)-9 b(AL.)28
+b(All)f(other)g(samples)g(are)427 1305 y(left)i(unc)n(hanged.)259
+1462 y Fc(V)-11 b(AL)33 b(=)f Fl(<)p Fc(Xt)m(yp)s(e)p
Fl(>)g Fc(\(Giv)m(en\))427 1561 y Fj(This)h(argumen)n(t)e(should)h(ha)n
(v)n(e)g(the)g(same)g(t)n(yp)r(e)h(as)f(the)h(elemen)n(ts)f(of)g(the)h
(IN)g(arra)n(y)-7 b(.)49 b(It)33 b(sp)r(eci\014es)f(the)427
@@ -118603,11 +118654,10 @@ Fj(2)e(arra)n(y\),)f(etc.)227 5499 y(F)-7 b(or)32 b(compatibilit)n(y)h
h(are)f(pro)n(vided)g(as)g(synon)n(yms)227 5599 y(for)27
b(S)h(and)g(US)g(resp)r(ectiv)n(ely)e(\(but)j(only)e(in)h(the)g(F)-7
b(ortran)26 b(in)n(terface)h(to)h(AST\).)p eop end
-%%Page: 288 298
-TeXDict begin 288 297 bop 0 52 a FG(288)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(MA)-11 b(TCHAXES)1660 483
-y Fd(Find)39 b(an)m(y)1405 598 y(corresp)s(onding)d(axes)1528
+%%Page: 289 299
+TeXDict begin 289 298 bop 3643 52 a FG(289)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(MA)-11 b(TCHAXES)1660
+483 y Fd(Find)39 b(an)m(y)1405 598 y(corresp)s(onding)d(axes)1528
711 y(in)i(t)m(w)m(o)f(F)-10 b(rames)2568 482 y FA(AST)p
Fe(_)p FA(MA)f(TCHAXES)0 877 y Fc(Description:)44 b Fj(This)c(function)
h(lo)r(oks)e(for)g(corresp)r(onding)f(axes)h(within)i(t)n(w)n(o)e
@@ -118676,28 +118726,28 @@ y(ma)n(y)j(b)r(e)h(stored)f(as)g(part)g(of)h(a)f(dataset)g(and)g(in)n
(cation:)123 b Ft(RESULT)41 b(=)i(AST_MATHMAP\()c(NIN,)j(NOUT,)f(NFWD,)
h(FWD,)g(NINV,)f(INV,)h(OPTIONS,)e(STATUS)h(\))0 5718
y Fc(Argumen)m(ts:)p eop end
-%%Page: 289 299
-TeXDict begin 289 298 bop 3643 52 a FG(289)259 351 y
-Fc(NIN)32 b(=)g(INTEGER)427 451 y Fj(Num)n(b)r(er)c(of)f(input)i(v)-5
-b(ariables)26 b(for)h(the)h(MathMap.)36 b(This)28 b(determines)f(the)h
-(v)-5 b(alue)27 b(of)h(its)f(Nin)h(attribute.)259 582
-y Fc(NOUT)k(=)g(INTEGER)427 681 y Fj(Num)n(b)r(er)20
-b(of)g(output)h(v)-5 b(ariables)18 b(for)h(the)i(MathMap.)34
-b(This)20 b(determines)f(the)i(v)-5 b(alue)19 b(of)h(its)g(Nout)g
-(attribute.)259 812 y Fc(NFWD)32 b(=)g(INTEGER)427 912
-y Fj(The)26 b(n)n(um)n(b)r(er)f(of)h(forw)n(ard)e(transformation)g
-(functions)i(b)r(eing)g(supplied.)37 b(This)25 b(m)n(ust)h(b)r(e)g(at)g
-(least)f(equal)427 1011 y(to)35 b(NOUT,)g(but)h(ma)n(y)e(b)r(e)i
-(increased)e(to)g(accommo)r(date)g(an)n(y)h(additional)f(expressions)f
-(whic)n(h)i(de\014ne)427 1111 y(in)n(termediate)23 b(v)-5
-b(ariables)21 b(for)i(the)g(forw)n(ard)e(transformation)g(\(see)i(the)g
-Ft(")p Fj(Calculating)f(In)n(termediate)g(V)-7 b(al-)427
-1211 y(ues)p Ft(")27 b Fj(section)h(b)r(elo)n(w\).)259
-1342 y Fc(FWD)k(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\)\()h(NFWD)g(\))427 1441 y Fj(An)c(arra)n(y)d(whic)n(h)i
-(con)n(tains)g(the)g(expressions)f(de\014ning)h(the)h(forw)n(ard)e
-(transformation.)35 b(The)27 b(syn)n(tax)g(of)427 1541
-y(these)h(expressions)e(is)h(describ)r(ed)h(b)r(elo)n(w.)259
+%%Page: 290 300
+TeXDict begin 290 299 bop 0 52 a FG(290)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(NIN)h(=)g(INTEGER)427
+451 y Fj(Num)n(b)r(er)c(of)f(input)i(v)-5 b(ariables)26
+b(for)h(the)h(MathMap.)36 b(This)28 b(determines)f(the)h(v)-5
+b(alue)27 b(of)h(its)f(Nin)h(attribute.)259 582 y Fc(NOUT)k(=)g
+(INTEGER)427 681 y Fj(Num)n(b)r(er)20 b(of)g(output)h(v)-5
+b(ariables)18 b(for)h(the)i(MathMap.)34 b(This)20 b(determines)f(the)i
+(v)-5 b(alue)19 b(of)h(its)g(Nout)g(attribute.)259 812
+y Fc(NFWD)32 b(=)g(INTEGER)427 912 y Fj(The)26 b(n)n(um)n(b)r(er)f(of)h
+(forw)n(ard)e(transformation)g(functions)i(b)r(eing)g(supplied.)37
+b(This)25 b(m)n(ust)h(b)r(e)g(at)g(least)f(equal)427
+1011 y(to)35 b(NOUT,)g(but)h(ma)n(y)e(b)r(e)i(increased)e(to)g(accommo)
+r(date)g(an)n(y)h(additional)f(expressions)f(whic)n(h)i(de\014ne)427
+1111 y(in)n(termediate)23 b(v)-5 b(ariables)21 b(for)i(the)g(forw)n
+(ard)e(transformation)g(\(see)i(the)g Ft(")p Fj(Calculating)f(In)n
+(termediate)g(V)-7 b(al-)427 1211 y(ues)p Ft(")27 b Fj(section)h(b)r
+(elo)n(w\).)259 1342 y Fc(FWD)k(=)g(CHARA)m(CTER)g Fi(\003)f
+Fc(\()h Fi(\003)f Fc(\)\()h(NFWD)g(\))427 1441 y Fj(An)c(arra)n(y)d
+(whic)n(h)i(con)n(tains)g(the)g(expressions)f(de\014ning)h(the)h(forw)n
+(ard)e(transformation.)35 b(The)27 b(syn)n(tax)g(of)427
+1541 y(these)h(expressions)e(is)h(describ)r(ed)h(b)r(elo)n(w.)259
1672 y Fc(NINV)k(=)g(INTEGER)427 1771 y Fj(The)c(n)n(um)n(b)r(er)g(of)g
(in)n(v)n(erse)f(transformation)f(functions)i(b)r(eing)h(supplied.)38
b(This)28 b(m)n(ust)g(b)r(e)h(at)f(least)f(equal)427
@@ -118760,32 +118810,31 @@ b(\(giv)n(en)h(b)n(y)g(the)g(MathMap's)g(Nout)h(attribute\).)227
(t)h(use:)340 5693 y Fi(\017)45 b Fj('R)28 b(=)f(SQR)-7
b(T\()28 b(X)g Fi(\003)f Fj(X)h(+)f(Y)h Fi(\003)g Fj(Y)g(\)')p
eop end
-%%Page: 290 300
-TeXDict begin 290 299 bop 0 52 a FG(290)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
-b Fj('THET)-7 b(A)28 b(=)f(A)-7 b(T)g(AN2\()29 b(Y,)f(X)g(\)')227
-503 y(whic)n(h)21 b(de\014nes)f(a)g(transformation)f(from)h(Cartesian)f
-(to)i(p)r(olar)e(co)r(ordinates.)33 b(Here,)22 b(the)f(v)-5
-b(ariables)19 b(that)i(app)r(ear)227 603 y(on)30 b(the)h(left)g(of)f
-(eac)n(h)g(expression)f(\(R)h(and)h(THET)-7 b(A\))30
-b(pro)n(vide)g(names)f(for)h(the)h(output)g(v)-5 b(ariables)29
-b(and)h(those)227 702 y(that)e(app)r(ear)f(on)g(the)h(righ)n(t)f(\(X)h
-(and)g(Y\))g(are)e(references)h(to)g(input)i(v)-5 b(ariables.)227
-822 y(T)e(o)28 b(complemen)n(t)g(this,)h(y)n(ou)f(m)n(ust)g(also)f
-(supply)h(expressions)f(for)h(the)g(in)n(v)n(erse)f(transformation)g
-(via)g(the)i(INV)227 921 y(argumen)n(t.)62 b(In)36 b(this)h(case,)g
-(the)g(n)n(um)n(b)r(er)f(of)g(expressions)f(giv)n(en)g(w)n(ould)h
-(normally)f(matc)n(h)h(the)h(n)n(um)n(b)r(er)f(of)227
-1021 y(MathMap)28 b(input)g(co)r(ordinates)e(\(giv)n(en)h(b)n(y)h(the)g
-(Nin)g(attribute\).)37 b(If)28 b(Nin)g(is)g(2,)f(y)n(ou)g(migh)n(t)g
-(use:)340 1147 y Fi(\017)45 b Fj('X)28 b(=)g(R)f Fi(\003)g
-Fj(COS\()h(THET)-7 b(A)28 b(\)')340 1270 y Fi(\017)45
-b Fj('Y)28 b(=)g(R)f Fi(\003)g Fj(SIN\()i(THET)-7 b(A)28
-b(\)')227 1422 y(whic)n(h)f(expresses)e(the)i(transformation)e(from)i
-(p)r(olar)f(to)g(Cartesian)g(co)r(ordinates.)35 b(Note)26
-b(that)h(here)g(the)g(input)227 1522 y(v)-5 b(ariables)33
-b(\(X)i(and)f(Y\))g(are)g(named)g(on)f(the)i(left)g(of)f(eac)n(h)f
-(expression,)h(and)g(the)h(output)f(v)-5 b(ariables)33
+%%Page: 291 301
+TeXDict begin 291 300 bop 3643 52 a FG(291)340 351 y
+Fi(\017)45 b Fj('THET)-7 b(A)28 b(=)f(A)-7 b(T)g(AN2\()29
+b(Y,)f(X)g(\)')227 503 y(whic)n(h)21 b(de\014nes)f(a)g(transformation)f
+(from)h(Cartesian)f(to)i(p)r(olar)e(co)r(ordinates.)33
+b(Here,)22 b(the)f(v)-5 b(ariables)19 b(that)i(app)r(ear)227
+603 y(on)30 b(the)h(left)g(of)f(eac)n(h)g(expression)f(\(R)h(and)h
+(THET)-7 b(A\))30 b(pro)n(vide)g(names)f(for)h(the)h(output)g(v)-5
+b(ariables)29 b(and)h(those)227 702 y(that)e(app)r(ear)f(on)g(the)h
+(righ)n(t)f(\(X)h(and)g(Y\))g(are)e(references)h(to)g(input)i(v)-5
+b(ariables.)227 822 y(T)e(o)28 b(complemen)n(t)g(this,)h(y)n(ou)f(m)n
+(ust)g(also)f(supply)h(expressions)f(for)h(the)g(in)n(v)n(erse)f
+(transformation)g(via)g(the)i(INV)227 921 y(argumen)n(t.)62
+b(In)36 b(this)h(case,)g(the)g(n)n(um)n(b)r(er)f(of)g(expressions)f
+(giv)n(en)g(w)n(ould)h(normally)f(matc)n(h)h(the)h(n)n(um)n(b)r(er)f
+(of)227 1021 y(MathMap)28 b(input)g(co)r(ordinates)e(\(giv)n(en)h(b)n
+(y)h(the)g(Nin)g(attribute\).)37 b(If)28 b(Nin)g(is)g(2,)f(y)n(ou)g
+(migh)n(t)g(use:)340 1147 y Fi(\017)45 b Fj('X)28 b(=)g(R)f
+Fi(\003)g Fj(COS\()h(THET)-7 b(A)28 b(\)')340 1270 y
+Fi(\017)45 b Fj('Y)28 b(=)g(R)f Fi(\003)g Fj(SIN\()i(THET)-7
+b(A)28 b(\)')227 1422 y(whic)n(h)f(expresses)e(the)i(transformation)e
+(from)i(p)r(olar)f(to)g(Cartesian)g(co)r(ordinates.)35
+b(Note)26 b(that)h(here)g(the)g(input)227 1522 y(v)-5
+b(ariables)33 b(\(X)i(and)f(Y\))g(are)g(named)g(on)f(the)i(left)g(of)f
+(eac)n(h)f(expression,)h(and)g(the)h(output)f(v)-5 b(ariables)33
b(\(R)i(and)227 1621 y(THET)-7 b(A\))28 b(are)f(referenced)g(on)g(the)h
(righ)n(t.)227 1741 y(Normally)-7 b(,)25 b(y)n(ou)e(cannot)i(refer)f
(to)g(a)g(v)-5 b(ariable)24 b(on)g(the)h(righ)n(t)f(of)h(an)f
@@ -118862,8 +118911,9 @@ b(ma)n(y)i(b)r(e)g(used)h(to)f(o)n(v)n(er-ride)e(the)j(normal)e(order)h
(limit)h(to)f(the)g(length)g(of)g(expressions)e(and)i(they)g(are)f
(insensitiv)n(e)g(to)h(case)f(or)g(the)i(presence)e(of)227
5693 y(additional)27 b(white)h(space.)p eop end
-%%Page: 291 301
-TeXDict begin 291 300 bop 3643 52 a FG(291)-2 351 y Fc(V)-8
+%%Page: 292 302
+TeXDict begin 292 301 bop 0 52 a FG(292)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)-2 351 y Fc(V)-8
b(ariables)n(:)227 497 y Fj(V)h(ariable)26 b(names)h(m)n(ust)f(b)r
(egin)h(with)h(an)e(alphab)r(etic)h(c)n(haracter)e(and)h(ma)n(y)g(con)n
(tain)h(only)f(alphab)r(etic)h(c)n(harac-)227 597 y(ters,)j(digits,)g
@@ -118953,14 +119003,13 @@ Ft(")g Fj(is)h(also)f(pro)n(vided,)g(although)g(this)i(is)f(not)g
5693 y(the)g(C-lik)n(e)f(synon)n(ym)g Ft(")p Fi(^^)p
Ft(")g Fj(ma)n(y)g(b)r(e)h(used,)g(although)f(this)h(is)f(also)g(not)g
(standard.\))p eop end
-%%Page: 292 302
-TeXDict begin 292 301 bop 0 52 a FG(292)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
-b Fj(X1)35 b(.EQV.)g(X2:)52 b(T)-7 b(ests)35 b(whether)h(the)f(logical)
-f(states)h(of)g(X1)g(and)g(X2)h(\(i.e.)60 b(.TR)n(UE./.F)-9
-b(ALSE.\))35 b(are)427 451 y(equal.)h(It)26 b(is)f(the)g(negativ)n(e)g
-(of)g(the)h(exclusiv)n(e)e(OR)h(\(X)n(OR\))h(function.)36
-b(T)-7 b(ri-state)25 b(logic)f(is)h(not)h(used)f(with)427
+%%Page: 293 303
+TeXDict begin 293 302 bop 3643 52 a FG(293)340 351 y
+Fi(\017)45 b Fj(X1)35 b(.EQV.)g(X2:)52 b(T)-7 b(ests)35
+b(whether)h(the)f(logical)f(states)h(of)g(X1)g(and)g(X2)h(\(i.e.)60
+b(.TR)n(UE./.F)-9 b(ALSE.\))35 b(are)427 451 y(equal.)h(It)26
+b(is)f(the)g(negativ)n(e)g(of)g(the)h(exclusiv)n(e)e(OR)h(\(X)n(OR\))h
+(function.)36 b(T)-7 b(ri-state)25 b(logic)f(is)h(not)h(used)f(with)427
551 y(this)j(op)r(erator.)340 685 y Fi(\017)45 b Fj(.NOT.)37
b(X:)g(Logical)e(unary)g(NOT)h(op)r(eration,)i(returning)e(1)g(if)h(X)g
(is)f(zero,)h(and)g(0)f(otherwise.)62 b(\(The)427 785
@@ -119046,25 +119095,25 @@ b(in)n(teger)f(v)-5 b(alue)32 b(of)g(X2)g(is)g(tak)n(en)f(\(rounding)g
(e\).)42 b(This)29 b(is)h(equiv)-5 b(alen)n(t)29 b(to)g(dividing)g(X1)h
(b)n(y)f(the)h(corresp)r(onding)427 5693 y(p)r(o)n(w)n(er)d(of)g(2.)p
eop end
-%%Page: 293 303
-TeXDict begin 293 302 bop 3643 52 a FG(293)340 351 y
-Fi(\017)45 b Fj(X1)24 b Fl(<<)g Fj(X2:)35 b(Left)n(w)n(ard)23
-b(bit)h(shift.)37 b(The)24 b(in)n(teger)f(v)-5 b(alue)24
-b(of)g(X2)g(is)g(tak)n(en)g(\(rounding)f(to)n(w)n(ards)g(zero\),)h(and)
-427 451 y(the)30 b(bits)f(represen)n(ting)f(X1)h(are)f(then)i(shifted)f
-(this)h(n)n(um)n(b)r(er)f(of)g(places)f(to)h(the)h(left)g(\(or)e(to)h
-(the)h(righ)n(t)e(if)427 551 y(the)f(n)n(um)n(b)r(er)f(of)h(places)e
-(is)i(negativ)n(e\).)35 b(This)27 b(is)f(equiv)-5 b(alen)n(t)26
-b(to)h(m)n(ultiplying)f(X1)h(b)n(y)f(the)h(corresp)r(onding)427
-650 y(p)r(o)n(w)n(er)g(of)g(2.)340 783 y Fi(\017)45 b
-Fj(X1)25 b(&)g(X2:)36 b(Bit)n(wise)24 b(AND)j(b)r(et)n(w)n(een)e(the)g
-(bits)h(of)f(X1)g(and)g(those)g(of)g(X2)g(\(equiv)-5
-b(alen)n(t)25 b(to)g(a)g(logical)f(AND)427 883 y(applied)k(at)f(eac)n
-(h)g(bit)h(p)r(osition)g(in)g(turn\).)340 1015 y Fi(\017)45
-b Fj(X1)34 b Fi(j)g Fj(X2:)50 b(Bit)n(wise)34 b(OR)g(b)r(et)n(w)n(een)g
-(the)g(bits)h(of)f(X1)g(and)g(those)f(of)h(X2)g(\(equiv)-5
-b(alen)n(t)34 b(to)g(a)g(logical)f(OR)427 1115 y(applied)28
-b(at)f(eac)n(h)g(bit)h(p)r(osition)g(in)g(turn\).)340
+%%Page: 294 304
+TeXDict begin 294 303 bop 0 52 a FG(294)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(X1)24 b Fl(<<)g Fj(X2:)35 b(Left)n(w)n(ard)23 b(bit)h(shift.)37
+b(The)24 b(in)n(teger)f(v)-5 b(alue)24 b(of)g(X2)g(is)g(tak)n(en)g
+(\(rounding)f(to)n(w)n(ards)g(zero\),)h(and)427 451 y(the)30
+b(bits)f(represen)n(ting)f(X1)h(are)f(then)i(shifted)f(this)h(n)n(um)n
+(b)r(er)f(of)g(places)f(to)h(the)h(left)g(\(or)e(to)h(the)h(righ)n(t)e
+(if)427 551 y(the)f(n)n(um)n(b)r(er)f(of)h(places)e(is)i(negativ)n
+(e\).)35 b(This)27 b(is)f(equiv)-5 b(alen)n(t)26 b(to)h(m)n(ultiplying)
+f(X1)h(b)n(y)f(the)h(corresp)r(onding)427 650 y(p)r(o)n(w)n(er)g(of)g
+(2.)340 783 y Fi(\017)45 b Fj(X1)25 b(&)g(X2:)36 b(Bit)n(wise)24
+b(AND)j(b)r(et)n(w)n(een)e(the)g(bits)h(of)f(X1)g(and)g(those)g(of)g
+(X2)g(\(equiv)-5 b(alen)n(t)25 b(to)g(a)g(logical)f(AND)427
+883 y(applied)k(at)f(eac)n(h)g(bit)h(p)r(osition)g(in)g(turn\).)340
+1015 y Fi(\017)45 b Fj(X1)34 b Fi(j)g Fj(X2:)50 b(Bit)n(wise)34
+b(OR)g(b)r(et)n(w)n(een)g(the)g(bits)h(of)f(X1)g(and)g(those)f(of)h(X2)
+g(\(equiv)-5 b(alen)n(t)34 b(to)g(a)g(logical)f(OR)427
+1115 y(applied)28 b(at)f(eac)n(h)g(bit)h(p)r(osition)g(in)g(turn\).)340
1248 y Fi(\017)45 b Fj(X1)30 b Fi(^)h Fj(X2:)43 b(Bit)n(wise)29
b(exclusiv)n(e)h(OR)g(\(X)n(OR\))h(b)r(et)n(w)n(een)f(the)h(bits)f(of)h
(X1)f(and)g(those)g(of)g(X2)h(\(equiv)-5 b(alen)n(t)427
@@ -119129,19 +119178,19 @@ b(Largest)e(in)n(teger)h(not)g(greater)f(than)i(X)g(\(round)f(to)n(w)n
(ards)f(min)n(us)i(in\014nit)n(y\).)340 5693 y Fi(\017)45
b Fj(FMOD\(X1,)28 b(X2\):)37 b(Remainder)27 b(when)h(X1)g(is)f(divided)
h(b)n(y)f(X2,)h(same)f(as)g(MOD\(X1,)h(X2\).)p eop end
-%%Page: 294 304
-TeXDict begin 294 303 bop 0 52 a FG(294)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
-b Fj(GA)n(USS\(X1,)27 b(X2\):)37 b(Random)25 b(sample)h(from)g(a)f
-(Gaussian)g(distribution)h(with)h(mean)f(X1)g(and)g(standard)427
-451 y(deviation)h(X2.)340 583 y Fi(\017)45 b Fj(INT\(X\):)29
-b(In)n(teger)e(part)g(of)g(X)h(\(round)g(to)n(w)n(ards)d(zero\),)i
-(same)g(as)g(AINT\(X\).)340 715 y Fi(\017)45 b Fj(ISBAD\(X\):)29
-b(Returns)f(1)f(if)h(X)g(has)f(the)h Fl(<)p Fj(bad)p
-Fl(>)f Fj(v)-5 b(alue)27 b(\(AST)p Ft(__)p Fj(BAD\),)i(otherwise)d(0.)
-340 848 y Fi(\017)45 b Fj(LOG\(X\):)28 b(Natural)f(logarithm)g(of)g(X.)
-340 980 y Fi(\017)45 b Fj(LOG10\(X\):)27 b(Logarithm)g(of)g(X)h(to)g
-(base)f(10.)340 1112 y Fi(\017)45 b Fj(MAX\(X1,)29 b(X2,)e(...\):)38
+%%Page: 295 305
+TeXDict begin 295 304 bop 3643 52 a FG(295)340 351 y
+Fi(\017)45 b Fj(GA)n(USS\(X1,)27 b(X2\):)37 b(Random)25
+b(sample)h(from)g(a)f(Gaussian)g(distribution)h(with)h(mean)f(X1)g(and)
+g(standard)427 451 y(deviation)h(X2.)340 583 y Fi(\017)45
+b Fj(INT\(X\):)29 b(In)n(teger)e(part)g(of)g(X)h(\(round)g(to)n(w)n
+(ards)d(zero\),)i(same)g(as)g(AINT\(X\).)340 715 y Fi(\017)45
+b Fj(ISBAD\(X\):)29 b(Returns)f(1)f(if)h(X)g(has)f(the)h
+Fl(<)p Fj(bad)p Fl(>)f Fj(v)-5 b(alue)27 b(\(AST)p Ft(__)p
+Fj(BAD\),)i(otherwise)d(0.)340 848 y Fi(\017)45 b Fj(LOG\(X\):)28
+b(Natural)f(logarithm)g(of)g(X.)340 980 y Fi(\017)45
+b Fj(LOG10\(X\):)27 b(Logarithm)g(of)g(X)h(to)g(base)f(10.)340
+1112 y Fi(\017)45 b Fj(MAX\(X1,)29 b(X2,)e(...\):)38
b(Maxim)n(um)27 b(of)h(t)n(w)n(o)e(or)h(more)g(v)-5 b(alues.)340
1245 y Fi(\017)45 b Fj(MIN\(X1,)28 b(X2,)g(...\):)37
b(Minim)n(um)29 b(of)e(t)n(w)n(o)g(or)g(more)f(v)-5 b(alues.)340
@@ -119214,17 +119263,18 @@ b Fl(<)p Fj(min)p Fl(>)p Fj(:)h(Smallest)32 b(p)r(ositiv)n(e)f(n)n(um)n
(b)r(er)h(whic)n(h)g(can)g(b)r(e)g(represen)n(ted)f(as)h(a)f
(normalised)g(\015oating)g(p)r(oin)n(t)427 5693 y(\(double)d
(precision\))f(v)-5 b(alue.)p eop end
-%%Page: 295 305
-TeXDict begin 295 304 bop 3643 52 a FG(295)340 351 y
-Fi(\017)45 b Fl(<)p Fj(min)p Ft(_)p Fj(10)p Ft(_)p Fj(exp)p
-Fl(>)p Fj(:)39 b(Minim)n(um)30 b(negativ)n(e)e(in)n(teger)h(suc)n(h)g
-(that)h(10)f(raised)f(to)i(that)f(p)r(o)n(w)n(er)g(can)g(b)r(e)h
-(repre-)427 451 y(sen)n(ted)e(as)f(a)g(normalised)f(\015oating)h(p)r
-(oin)n(t)h(\(double)g(precision\))f(v)-5 b(alue.)340
-581 y Fi(\017)45 b Fl(<)p Fj(min)p Ft(_)p Fj(exp)p Fl(>)p
-Fj(:)35 b(Minim)n(um)25 b(negativ)n(e)e(in)n(teger)h(suc)n(h)g(that)h
-Fl(<)p Fj(radix)p Fl(>)e Fj(raised)h(to)g(that)h(p)r(o)n(w)n(er)e(min)n
-(us)i(1)f(can)427 680 y(b)r(e)k(represen)n(ted)f(as)g(a)g(normalised)f
+%%Page: 296 306
+TeXDict begin 296 305 bop 0 52 a FG(296)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fl(<)p Fj(min)p Ft(_)p Fj(10)p Ft(_)p Fj(exp)p Fl(>)p
+Fj(:)39 b(Minim)n(um)30 b(negativ)n(e)e(in)n(teger)h(suc)n(h)g(that)h
+(10)f(raised)f(to)i(that)f(p)r(o)n(w)n(er)g(can)g(b)r(e)h(repre-)427
+451 y(sen)n(ted)e(as)f(a)g(normalised)f(\015oating)h(p)r(oin)n(t)h
+(\(double)g(precision\))f(v)-5 b(alue.)340 581 y Fi(\017)45
+b Fl(<)p Fj(min)p Ft(_)p Fj(exp)p Fl(>)p Fj(:)35 b(Minim)n(um)25
+b(negativ)n(e)e(in)n(teger)h(suc)n(h)g(that)h Fl(<)p
+Fj(radix)p Fl(>)e Fj(raised)h(to)g(that)h(p)r(o)n(w)n(er)e(min)n(us)i
+(1)f(can)427 680 y(b)r(e)k(represen)n(ted)f(as)g(a)g(normalised)f
(\015oating)h(p)r(oin)n(t)h(\(double)g(precision\))e(v)-5
b(alue.)340 810 y Fi(\017)45 b Fl(<)p Fj(pi)p Fl(>)p
Fj(:)37 b(Ratio)27 b(of)g(the)h(circumference)f(of)h(a)f(circle)g(to)g
@@ -119281,9536 +119331,9630 @@ b Ft(RESULT)41 b(=)i(AST_MATRIXMAP\()38 b(NIN,)k(NOUT,)f(FORM,)h
Fj(The)d(n)n(um)n(b)r(er)f(of)h(input)g(co)r(ordinates,)e(whic)n(h)i
(determines)f(the)h(n)n(um)n(b)r(er)g(of)f(columns)h(in)f(the)h
(matrix.)p eop end
-%%Page: 296 306
-TeXDict begin 296 305 bop 0 52 a FG(296)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(NOUT)h(=)g(INTEGER)g
-(\(Giv)m(en\))427 451 y Fj(The)c(n)n(um)n(b)r(er)f(of)h(output)g(co)r
-(ordinates,)e(whic)n(h)i(determines)f(the)h(n)n(um)n(b)r(er)f(of)h(ro)n
-(ws)e(in)i(the)g(matrix.)259 581 y Fc(F)m(ORM)j(=)h(INTEGER)g(\(Giv)m
-(en\))427 681 y Fj(An)c(in)n(teger)f(whic)n(h)h(indicates)f(the)h(form)
-f(in)h(whic)n(h)g(the)g(matrix)f(elemen)n(ts)g(will)h(b)r(e)g
-(supplied.)427 795 y(A)j(v)-5 b(alue)30 b(of)g(zero)f(indicates)h(that)
-g(a)g(full)h(NOUT)f(x)g(NIN)h(matrix)e(of)h(v)-5 b(alues)30
-b(will)h(b)r(e)f(supplied)h(via)e(the)427 895 y(MA)-7
-b(TRIX)36 b(argumen)n(t)d(\(b)r(elo)n(w\).)59 b(In)35
-b(this)g(case,)g(the)g(elemen)n(ts)g(should)f(b)r(e)h(giv)n(en)f(in)h
-(ro)n(w)f(order)f(\(the)427 995 y(elemen)n(ts)28 b(of)f(the)h(\014rst)g
-(ro)n(w,)e(follo)n(w)n(ed)h(b)n(y)g(the)h(elemen)n(ts)f(of)h(the)g
-(second)f(ro)n(w,)f(etc.\).)427 1109 y(A)34 b(v)-5 b(alue)34
-b(of)g(1)f(indicates)g(that)h(only)f(the)i(diagonal)d(elemen)n(ts)h(of)
-h(the)g(matrix)f(will)h(b)r(e)g(supplied,)i(and)427 1209
-y(that)25 b(all)g(others)e(should)i(b)r(e)g(zero.)35
+%%Page: 297 307
+TeXDict begin 297 306 bop 3643 52 a FG(297)259 351 y
+Fc(NOUT)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 451 y Fj(The)c(n)n(um)n(b)r
+(er)f(of)h(output)g(co)r(ordinates,)e(whic)n(h)i(determines)f(the)h(n)n
+(um)n(b)r(er)f(of)h(ro)n(ws)e(in)i(the)g(matrix.)259
+622 y Fc(F)m(ORM)j(=)h(INTEGER)g(\(Giv)m(en\))427 722
+y Fj(An)c(in)n(teger)f(whic)n(h)h(indicates)f(the)h(form)f(in)h(whic)n
+(h)g(the)g(matrix)f(elemen)n(ts)g(will)h(b)r(e)g(supplied.)427
+858 y(A)j(v)-5 b(alue)30 b(of)g(zero)f(indicates)h(that)g(a)g(full)h
+(NOUT)f(x)g(NIN)h(matrix)e(of)h(v)-5 b(alues)30 b(will)h(b)r(e)f
+(supplied)h(via)e(the)427 957 y(MA)-7 b(TRIX)36 b(argumen)n(t)d(\(b)r
+(elo)n(w\).)59 b(In)35 b(this)g(case,)g(the)g(elemen)n(ts)g(should)f(b)
+r(e)h(giv)n(en)f(in)h(ro)n(w)f(order)f(\(the)427 1057
+y(elemen)n(ts)28 b(of)f(the)h(\014rst)g(ro)n(w,)e(follo)n(w)n(ed)h(b)n
+(y)g(the)h(elemen)n(ts)f(of)h(the)g(second)f(ro)n(w,)f(etc.\).)427
+1192 y(A)34 b(v)-5 b(alue)34 b(of)g(1)f(indicates)g(that)h(only)f(the)i
+(diagonal)d(elemen)n(ts)h(of)h(the)g(matrix)f(will)h(b)r(e)g(supplied,)
+i(and)427 1292 y(that)25 b(all)g(others)e(should)i(b)r(e)g(zero.)35
b(In)25 b(this)f(case,)h(the)g(elemen)n(ts)f(of)h(MA)-7
-b(TRIX)26 b(should)e(con)n(tain)g(only)g(the)427 1309
+b(TRIX)26 b(should)e(con)n(tain)g(only)g(the)427 1392
y(diagonal)i(elemen)n(ts,)i(stored)f(consecutiv)n(ely)-7
-b(.)427 1423 y(A)32 b(v)-5 b(alue)32 b(of)f(2)h(indicates)f(that)h(a)f
+b(.)427 1527 y(A)32 b(v)-5 b(alue)32 b(of)f(2)h(indicates)f(that)h(a)f
Ft(")p Fj(unit)p Ft(")h Fj(matrix)f(is)g(required,)h(whose)f(diagonal)f
-(elemen)n(ts)h(are)g(set)h(to)427 1523 y(unit)n(y)c(\(with)g(all)g
+(elemen)n(ts)h(are)g(set)h(to)427 1627 y(unit)n(y)c(\(with)g(all)g
(other)f(elemen)n(ts)g(zero\).)36 b(In)28 b(this)g(case,)f(the)h(MA)-7
-b(TRIX)28 b(argumen)n(t)f(is)g(not)h(used.)259 1653 y
+b(TRIX)28 b(argumen)n(t)f(is)g(not)h(used.)259 1798 y
Fc(MA)-8 b(TRIX\()32 b Fi(\003)g Fc(\))g(=)g(DOUBLE)g(PRECISION)f
-(\(Giv)m(en\))427 1753 y Fj(The)d(arra)n(y)d(of)j(matrix)f(elemen)n(ts)
+(\(Giv)m(en\))427 1898 y Fj(The)d(arra)n(y)d(of)j(matrix)f(elemen)n(ts)
g(to)h(b)r(e)g(used,)f(stored)g(according)f(to)h(the)h(v)-5
-b(alue)28 b(of)f(F)n(ORM.)259 1883 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g
+b(alue)28 b(of)f(F)n(ORM.)259 2070 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g
Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-1982 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h(optional)g
+2169 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h(optional)g
(comma-separated)e(list)j(of)g(attribute)f(assignmen)n(ts)g(to)427
-2082 y(b)r(e)38 b(used)f(for)g(initialising)f(the)i(new)f(MatrixMap.)65
+2269 y(b)r(e)38 b(used)f(for)g(initialising)f(the)i(new)f(MatrixMap.)65
b(The)37 b(syn)n(tax)f(used)h(is)g(iden)n(tical)g(to)g(that)h(for)e
-(the)427 2182 y(AST)p Ft(_)p Fj(SET)27 b(routine.)259
-2312 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 2411 y Fj(The)c(global)e(status.)0 2570
-y Fc(Returned)32 b(V)-8 b(alue:)259 2704 y(AST)p Ft(_)p
-Fc(MA)g(TRIXMAP)33 b(=)f(INTEGER)427 2803 y Fj(A)c(p)r(oin)n(ter)f(to)h
-(the)g(new)g(MatrixMap.)0 2963 y Fc(Notes:)340 3242 y
+(the)427 2368 y(AST)p Ft(_)p Fj(SET)27 b(routine.)259
+2540 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 2640 y Fj(The)c(global)e(status.)0 2879
+y Fc(Returned)32 b(V)-8 b(alue:)259 3093 y(AST)p Ft(_)p
+Fc(MA)g(TRIXMAP)33 b(=)f(INTEGER)427 3192 y Fj(A)c(p)r(oin)n(ter)f(to)h
+(the)g(new)g(MatrixMap.)0 3431 y Fc(Notes:)340 3791 y
Fi(\017)45 b Fj(In)32 b(general,)e(a)h(MatrixMap's)f(forw)n(ard)g
(transformation)f(will)j(alw)n(a)n(ys)d(b)r(e)j(a)n(v)-5
-b(ailable)30 b(\(as)h(indicated)g(b)n(y)427 3342 y(its)h(T)-7
+b(ailable)30 b(\(as)h(indicated)g(b)n(y)427 3891 y(its)h(T)-7
b(ranF)g(orw)n(ard)29 b(attribute\),)k(but)f(its)f(in)n(v)n(erse)f
(transformation)g(\(T)-7 b(ranIn)n(v)n(erse)29 b(attribute\))j(will)g
-(only)427 3441 y(b)r(e)c(a)n(v)-5 b(ailable)27 b(if)h(the)g(asso)r
+(only)427 3991 y(b)r(e)c(a)n(v)-5 b(ailable)27 b(if)h(the)g(asso)r
(ciated)e(matrix)h(is)g(square)g(and)g(non-singular.)340
-3571 y Fi(\017)45 b Fj(As)32 b(an)f(exception)f(to)i(this,)g(the)g(in)n
+4162 y Fi(\017)45 b Fj(As)32 b(an)f(exception)f(to)i(this,)g(the)g(in)n
(v)n(erse)d(transformation)h(is)h(alw)n(a)n(ys)e(a)n(v)-5
-b(ailable)30 b(if)i(a)f(unit)h(or)e(diagonal)427 3671
+b(ailable)30 b(if)i(a)f(unit)h(or)e(diagonal)427 4262
y(matrix)19 b(is)g(sp)r(eci\014ed.)35 b(In)19 b(this)h(case,)g(if)g
(the)g(matrix)f(is)g(not)h(square,)f(one)g(or)g(more)f(of)i(the)g
-(input)g(co)r(ordinate)427 3771 y(v)-5 b(alues)28 b(ma)n(y)f(not)h(b)r
+(input)g(co)r(ordinate)427 4361 y(v)-5 b(alues)28 b(ma)n(y)f(not)h(b)r
(e)g(reco)n(v)n(erable)d(from)i(a)g(set)h(of)g(output)g(co)r
(ordinates.)36 b(An)n(y)28 b(co)r(ordinates)e(a\013ected)i(in)427
-3870 y(this)g(w)n(a)n(y)f(will)g(simply)h(b)r(e)g(set)g(to)f(the)h(v)-5
-b(alue)28 b(zero.)340 4000 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+4461 y(this)g(w)n(a)n(y)f(will)g(simply)h(b)r(e)g(set)g(to)f(the)h(v)-5
+b(alue)28 b(zero.)340 4633 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 4100 y(set)28 b(to)f(an)h(error)d(v)-5
+b(A)g(TUS)427 4732 y(set)28 b(to)f(an)h(error)d(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)-2
-4259 y Fc(Status)33 b(Handling)n(:)227 4405 y Fj(The)d(protected)g(in)n
+4971 y Fc(Status)33 b(Handling)n(:)227 5118 y Fj(The)d(protected)g(in)n
(terface)f(to)g(this)h(function)h(includes)f(an)f(extra)g(parameter)f
-(at)i(the)g(end)g(of)g(the)g(parameter)227 4505 y(list)37
+(at)i(the)g(end)g(of)g(the)g(parameter)227 5217 y(list)37
b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)
r(oin)n(ter)g(to)h(the)g(in)n(teger)e(inherited)i(status)f(v)-5
-b(ariable:)54 b Ft(")p Fj(in)n(t)227 4604 y Fi(\003)p
-Fj(status)p Ft(")p Fj(.)p 0 4798 3780 12 v 0 4929 a FA(AST)p
-Fe(_)p FA(NEGA)-11 b(TE)1093 4930 y Fd(Negate)37 b(the)i(area)e
-(represen)m(ted)h(b)m(y)1665 5043 y(a)g(Region)2877 4929
-y FA(AST)p Fe(_)p FA(NEGA)-11 b(TE)0 5226 y Fc(Description:)44
-b Fj(This)d(function)f(negates)g(the)g(area)f(represen)n(ted)g(b)n(y)h
-(a)g(Region.)74 b(That)40 b(is,)j(p)r(oin)n(ts)d(whic)n(h)h(w)n(ere)227
-5326 y(previously)22 b(inside)h(the)h(region)e(will)h(then)h(b)r(e)f
-(outside,)h(and)f(p)r(oin)n(ts)g(whic)n(h)g(w)n(ere)f(outside)h(will)h
-(b)r(e)f(inside.)36 b(This)227 5425 y(is)28 b(acomplished)f(b)n(y)g
-(toggling)f(the)i(state)g(of)f(the)h(Negated)f(attribute)h(for)f(the)h
-(supplied)g(region.)0 5572 y Fc(In)m(v)m(o)s(cation:)123
-b Ft(CALL)42 b(AST_NEGATE\()d(THIS,)i(STATUS)g(\))0 5718
-y Fc(Argumen)m(ts:)p eop end
-%%Page: 297 307
-TeXDict begin 297 306 bop 3643 52 a FG(297)259 351 y
-Fc(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(Region.)259 584 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 683
-y Fj(The)c(global)e(status.)p 0 882 3780 12 v 0 1013
-a FA(AST)p Fe(_)p FA(NORM)937 1014 y Fd(Normalise)36
-b(a)j(set)f(of)h(F)-10 b(rame)38 b(co)s(ordinates)3014
-1013 y FA(AST)p Fe(_)p FA(NORM)0 1189 y Fc(Description:)44
-b Fj(This)32 b(routine)f(normalises)f(a)h(set)h(of)f(F)-7
-b(rame)31 b(co)r(ordinate)f(v)-5 b(alues)32 b(whic)n(h)f(migh)n(t)h(b)r
-(e)f(unsuitable)h(for)227 1289 y(displa)n(y)23 b(\(e.g.)35
-b(ma)n(y)22 b(lie)h(outside)g(the)h(exp)r(ected)f(range\))f(in)n(to)h
-(a)g(set)g(of)g(acceptable)f(v)-5 b(alues)23 b(suitable)g(for)f(displa)
-n(y)-7 b(.)0 1438 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
-b(AST_NORM\()e(THIS,)h(VALUE,)g(STATUS)g(\))0 1587 y
-Fc(Argumen)m(ts:)259 1724 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
-1823 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7 b(rame.)259
-1956 y Fc(V)c(ALUE\()33 b Fi(\003)f Fc(\))g(=)g(DOUBLE)g(PRECISION)f
-(\(Giv)m(en)h(and)h(Returned\))427 2055 y Fj(An)21 b(arra)n(y)c(with)k
-(one)f(elemen)n(t)g(for)f(eac)n(h)g(F)-7 b(rame)20 b(axis)f(\(Naxes)h
-(attribute\).)35 b(Initially)-7 b(,)21 b(this)g(should)e(con)n(tain)427
-2155 y(a)34 b(set)g(of)g(co)r(ordinate)f(v)-5 b(alues)33
+b(ariable:)54 b Ft(")p Fj(in)n(t)227 5317 y Fi(\003)p
+Fj(status)p Ft(")p Fj(.)p 0 5593 3780 12 v eop end
+%%Page: 298 308
+TeXDict begin 298 307 bop 0 52 a FG(298)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 533 y FA(AST)p
+Fe(_)p FA(MIRR)l(OR)-15 b(V)g(ARIANTS)1758 551 y Fd(Mak)m(e)1808
+650 y(the)1789 750 y(cur-)1787 849 y(ren)m(t)1758 949
+y(F)-10 b(rame)1782 1049 y(mir-)1815 1148 y(ror)1808
+1248 y(the)1774 1348 y(v)j(ari-)1807 1447 y(an)m(t)1758
+1547 y(Map-)1758 1658 y(pings)1841 1769 y(in)1808 1868
+y(an-)1758 1968 y(other)1758 2067 y(F)d(rame)2174 533
+y FA(AST)p Fe(_)p FA(MIRR)l(OR)-15 b(V)g(ARIANTS)0 2208
+y Fc(Description:)44 b Fj(This)25 b(routine)f(indicates)g(that)g(all)g
+(access)g(to)g(the)h(V)-7 b(arian)n(t)23 b(attribute)i(of)f(the)h
+(curren)n(t)e(F)-7 b(rame)24 b(should)227 2308 y(should)35
+b(b)r(e)g(forw)n(arded)e(to)i(some)g(other)f(nominated)h(F)-7
+b(rame)34 b(in)h(the)g(F)-7 b(rameSet.)59 b(F)-7 b(or)34
+b(instance,)j(if)e(a)g(v)-5 b(alue)227 2407 y(is)31 b(set)g(subsequen)n
+(tly)f(for)g(the)h(V)-7 b(arian)n(t)30 b(attribute)h(of)f(the)h(curren)
+n(t)f(F)-7 b(rame,)31 b(the)g(curren)n(t)f(F)-7 b(rame)30
+b(will)h(b)r(e)g(left)227 2507 y(unc)n(hanged)i(and)g(the)h(setting)g
+(is)f(instead)h(applied)f(to)h(the)f(nominated)h(F)-7
+b(rame.)54 b(Lik)n(ewise,)34 b(if)g(the)g(v)-5 b(alue)34
+b(of)227 2607 y(the)28 b(V)-7 b(arian)n(t)25 b(attribute)j(is)e
+(requested,)h(the)g(v)-5 b(alue)27 b(returned)f(is)h(the)g(v)-5
+b(alue)27 b(stored)f(for)g(the)h(nominated)g(F)-7 b(rame)227
+2706 y(rather)27 b(than)h(the)g(curren)n(t)e(F)-7 b(rame)27
+b(itself.)227 2825 y(This)g(pro)n(vides)e(a)i(mec)n(hanism)f(for)g
+(propagating)f(the)i(e\013ects)g(of)g(v)-5 b(arian)n(t)26
+b(Mappings)g(around)f(a)i(F)-7 b(rameSet.)36 b(If)227
+2924 y(a)d(new)g(F)-7 b(rame)32 b(is)h(added)f(to)h(a)f(F)-7
+b(rameSet)33 b(b)n(y)f(connecting)h(it)g(to)g(an)f(pre-existing)g(F)-7
+b(rame)32 b(that)h(has)f(t)n(w)n(o)g(or)227 3024 y(more)f(v)-5
+b(arian)n(t)31 b(Mappings,)i(then)f(it)g(ma)n(y)g(b)r(e)g(appropriate)e
+(to)i(set)g(the)g(new)g(F)-7 b(rame)31 b(so)h(that)g(it)g(mirrors)e
+(the)227 3124 y(v)-5 b(arian)n(ts)32 b(Mappings)h(of)g(the)h
+(pre-existing)e(F)-7 b(rame.)53 b(If)33 b(this)h(is)f(done,)i(then)e
+(it)h(will)f(b)r(e)h(p)r(ossible)f(to)g(select)g(a)227
+3223 y(sp)r(eci\014c)28 b(v)-5 b(arian)n(t)27 b(Mapping)g(using)g
+(either)h(the)g(pre-existing)e(F)-7 b(rame)27 b(or)g(the)h(new)f(F)-7
+b(rame.)0 3360 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
+b(AST_MIRRORVARIA)o(NTS)o(\()37 b(THIS,)42 b(IFRAME,)f(STATUS)g(\))0
+3497 y Fc(Argumen)m(ts:)259 3621 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 3721 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rameSet.)259 3841 y Fc(IFRAME)31 b(=)h(INTEGER)g(\(Giv)m(en\))427
+3941 y Fj(The)d(index)g(of)g(the)g(F)-7 b(rame)28 b(within)i(the)f(F)-7
+b(rameSet)28 b(whic)n(h)h(is)g(to)f(b)r(e)h(mirrored)f(b)n(y)g(the)h
+(curren)n(t)f(F)-7 b(rame.)427 4041 y(This)27 b(v)-5
+b(alue)26 b(should)g(lie)h(in)g(the)g(range)e(from)h(1)g(to)g(the)h(n)n
+(um)n(b)r(er)f(of)h(F)-7 b(rames)25 b(in)i(the)g(F)-7
+b(rameSet)26 b(\(as)g(giv)n(en)427 4140 y(b)n(y)c(its)g(Nframe)f
+(attribute\).)36 b(If)22 b(AST)p Ft(__)p Fj(NOFRAME)g(is)f(supplied)i
+(\(or)e(the)h(curren)n(t)f(F)-7 b(rame)21 b(is)h(sp)r(eci\014ed\),)427
+4240 y(then)28 b(an)n(y)f(mirroring)f(established)h(b)n(y)g(a)h
+(previous)e(call)h(to)h(this)g(routine)f(is)g(disabled.)259
+4360 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 4460 y Fj(The)c(global)e(status.)0 4609
+y Fc(Notes:)340 4880 y Fi(\017)45 b Fj(Mirrors)27 b(can)i(b)r(e)g(c)n
+(hained.)40 b(That)29 b(is,)g(if)g(F)-7 b(rame)28 b(B)h(is)g(set)g(to)f
+(b)r(e)i(a)e(mirror)f(of)i(F)-7 b(rame)28 b(A,)i(and)e(F)-7
+b(rame)29 b(C)427 4979 y(is)f(set)f(to)h(b)r(e)g(a)f(mirror)f(of)i(F)-7
+b(rame)27 b(B,)g(then)h(F)-7 b(rame)27 b(C)h(will)g(act)f(as)g(a)g
+(mirror)f(of)i(F)-7 b(rame)27 b(A.)340 5100 y Fi(\017)45
+b Fj(V)-7 b(arian)n(t)33 b(Mappings)h(cannot)f(b)r(e)h(added)g(to)g
+(the)g(curren)n(t)f(F)-7 b(rame)34 b(if)g(it)g(is)g(mirroring)e
+(another)h(F)-7 b(rame.)427 5199 y(So)26 b(calls)f(to)h(the)h(AST)p
+Ft(_)p Fj(ADD)n(V)-9 b(ARIANT)28 b(routine)d(will)i(cause)e(an)h(error)
+e(to)i(b)r(e)g(rep)r(orted)f(if)i(the)f(curren)n(t)427
+5299 y(F)-7 b(rame)27 b(is)h(mirroring)d(another)i(F)-7
+b(rame.)340 5419 y Fi(\017)45 b Fj(A)26 b(v)-5 b(alue)26
+b(of)g(AST)p Ft(__)p Fj(BASE)f(ma)n(y)g(b)r(e)h(giv)n(en)f(for)g(the)h
+(IFRAME)g(argumen)n(t)f(to)h(sp)r(ecify)g(the)g(base)f(F)-7
+b(rame.)340 5540 y Fi(\017)45 b Fj(An)n(y)24 b(v)-5 b(arian)n(t)22
+b(Mappings)h(explicitly)h(added)g(to)f(the)h(curren)n(t)f(F)-7
+b(rame)23 b(using)g(AST)p Ft(_)p Fj(ADD)n(V)-9 b(ARIANT)25
+b(will)427 5639 y(b)r(e)j(ignored)f(if)h(the)g(curren)n(t)f(F)-7
+b(rame)27 b(is)g(mirroring)f(another)g(F)-7 b(rame.)p
+eop end
+%%Page: 299 309
+TeXDict begin 299 308 bop 3643 52 a FG(299)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(NEGA)-11 b(TE)1093 483
+y Fd(Negate)37 b(the)i(area)e(represen)m(ted)h(b)m(y)1665
+596 y(a)g(Region)2877 482 y FA(AST)p Fe(_)p FA(NEGA)-11
+b(TE)0 832 y Fc(Description:)44 b Fj(This)d(function)f(negates)g(the)g
+(area)f(represen)n(ted)g(b)n(y)h(a)g(Region.)74 b(That)40
+b(is,)j(p)r(oin)n(ts)d(whic)n(h)h(w)n(ere)227 932 y(previously)22
+b(inside)h(the)h(region)e(will)h(then)h(b)r(e)f(outside,)h(and)f(p)r
+(oin)n(ts)g(whic)n(h)g(w)n(ere)f(outside)h(will)h(b)r(e)f(inside.)36
+b(This)227 1031 y(is)28 b(acomplished)f(b)n(y)g(toggling)f(the)i(state)
+g(of)f(the)h(Negated)f(attribute)h(for)f(the)h(supplied)g(region.)0
+1228 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_NEGATE\()d(THIS,)
+i(STATUS)g(\))0 1424 y Fc(Argumen)m(ts:)259 1608 y(THIS)32
+b(=)g(INTEGER)g(\(Giv)m(en\))427 1707 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(Region.)259 1864 y Fc(ST)-8 b(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 1963
+y Fj(The)c(global)e(status.)p 0 2209 V 0 2340 a FA(AST)p
+Fe(_)p FA(NORM)937 2341 y Fd(Normalise)36 b(a)j(set)f(of)h(F)-10
+b(rame)38 b(co)s(ordinates)3014 2340 y FA(AST)p Fe(_)p
+FA(NORM)0 2564 y Fc(Description:)44 b Fj(This)32 b(routine)f
+(normalises)f(a)h(set)h(of)f(F)-7 b(rame)31 b(co)r(ordinate)f(v)-5
+b(alues)32 b(whic)n(h)f(migh)n(t)h(b)r(e)f(unsuitable)h(for)227
+2663 y(displa)n(y)23 b(\(e.g.)35 b(ma)n(y)22 b(lie)h(outside)g(the)h
+(exp)r(ected)f(range\))f(in)n(to)h(a)g(set)g(of)g(acceptable)f(v)-5
+b(alues)23 b(suitable)g(for)f(displa)n(y)-7 b(.)0 2860
+y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_NORM\()e(THIS,)h
+(VALUE,)g(STATUS)g(\))0 3056 y Fc(Argumen)m(ts:)259 3240
+y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 3339 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(F)-7 b(rame.)259 3496 y Fc(V)c(ALUE\()33
+b Fi(\003)f Fc(\))g(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en)h(and)h
+(Returned\))427 3595 y Fj(An)21 b(arra)n(y)c(with)k(one)f(elemen)n(t)g
+(for)f(eac)n(h)g(F)-7 b(rame)20 b(axis)f(\(Naxes)h(attribute\).)35
+b(Initially)-7 b(,)21 b(this)g(should)e(con)n(tain)427
+3695 y(a)34 b(set)g(of)g(co)r(ordinate)f(v)-5 b(alues)33
b(represen)n(ting)g(a)h(p)r(oin)n(t)g(in)g(the)g(space)g(whic)n(h)g
-(the)g(F)-7 b(rame)34 b(describ)r(es.)55 b(If)427 2255
+(the)g(F)-7 b(rame)34 b(describ)r(es.)55 b(If)427 3795
y(these)33 b(v)-5 b(alues)32 b(lie)h(outside)g(the)g(exp)r(ected)g
(range)e(for)i(the)g(F)-7 b(rame,)33 b(they)g(will)g(b)r(e)g(replaced)f
-(with)h(more)427 2354 y(acceptable)27 b(\(normalised\))g(v)-5
+(with)h(more)427 3894 y(acceptable)27 b(\(normalised\))g(v)-5
b(alues.)37 b(Otherwise,)26 b(they)i(will)g(b)r(e)g(returned)f(unc)n
-(hanged.)259 2487 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h
-(and)g(Returned\))427 2587 y Fj(The)c(global)e(status.)0
-2748 y Fc(Notes:)340 3031 y Fi(\017)45 b Fj(F)-7 b(or)34
+(hanged.)259 4050 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h
+(and)g(Returned\))427 4150 y Fj(The)c(global)e(status.)0
+4359 y Fc(Notes:)340 4689 y Fi(\017)45 b Fj(F)-7 b(or)34
b(some)f(classes)g(of)h(F)-7 b(rame,)36 b(whose)d(co)r(ordinate)g(v)-5
b(alues)34 b(are)f(not)h(constrained,)h(this)g(function)f(will)427
-3130 y(nev)n(er)d(mo)r(dify)h(the)g(v)-5 b(alues)31 b(supplied.)49
+4788 y(nev)n(er)d(mo)r(dify)h(the)g(v)-5 b(alues)31 b(supplied.)49
b(Ho)n(w)n(ev)n(er,)31 b(for)g(F)-7 b(rames)30 b(whose)h(axes)g
-(represen)n(t)f(cyclic)h(quan)n(ti-)427 3230 y(ties)i(\(suc)n(h)f(as)f
+(represen)n(t)f(cyclic)h(quan)n(ti-)427 4888 y(ties)i(\(suc)n(h)f(as)f
(angles)h(or)f(p)r(ositions)h(on)g(the)g(sky\),)h(co)r(ordinates)e
(will)i(t)n(ypically)e(b)r(e)i(wrapp)r(ed)f(in)n(to)g(an)427
-3330 y(appropriate)26 b(standard)h(range,)f(suc)n(h)h(as)g(zero)g(to)g
-(2)p Fi(\003)p Fj(pi.)340 3462 y Fi(\017)45 b Fj(The)31
+4987 y(appropriate)26 b(standard)h(range,)f(suc)n(h)h(as)g(zero)g(to)g
+(2)p Fi(\003)p Fj(pi.)340 5144 y Fi(\017)45 b Fj(The)31
b(NormMap)e(class)h(is)g(a)g(Mapping)f(whic)n(h)i(can)f(b)r(e)g(used)h
(to)f(normalise)f(a)h(set)g(of)g(p)r(oin)n(ts)g(using)g(the)427
-3562 y(AST)p Ft(_)p Fj(NORM)e(routine)f(of)h(a)f(sp)r(eci\014ed)h(F)-7
-b(rame.)340 3695 y Fi(\017)45 b Fj(It)d(is)g(in)n(tended)g(to)f(b)r(e)h
+5243 y(AST)p Ft(_)p Fj(NORM)e(routine)f(of)h(a)f(sp)r(eci\014ed)h(F)-7
+b(rame.)340 5400 y Fi(\017)45 b Fj(It)d(is)g(in)n(tended)g(to)f(b)r(e)h
(p)r(ossible)f(to)h(put)g(an)n(y)f(set)g(of)h(co)r(ordinates)e(in)n(to)
-h(a)g(form)g(suitable)h(for)f(dis-)427 3794 y(pla)n(y)c(b)n(y)h(using)f
+h(a)g(form)g(suitable)h(for)f(dis-)427 5499 y(pla)n(y)c(b)n(y)h(using)f
(this)h(function)g(to)g(normalise)e(them,)41 b(follo)n(w)n(ed)36
-b(b)n(y)i(appropriate)e(formatting)h(\(using)427 3894
-y(AST)p Ft(_)p Fj(F)n(ORMA)-7 b(T\).)p 0 4093 V 0 4223
-a FA(AST)p Fe(_)p FA(NORMMAP)303 b Fd(Create)37 b(a)i(NormMap)304
-b FA(AST)p Fe(_)p FA(NORMMAP)0 4412 y Fc(Description:)44
-b Fj(This)28 b(function)g(creates)f(a)g(new)g(NormMap)g(and)h
-(optionally)e(initialises)i(its)g(attributes.)227 4536
-y(A)k(NormMap)e(is)i(a)e(Mapping)h(whic)n(h)g(normalises)f(co)r
+b(b)n(y)i(appropriate)e(formatting)h(\(using)427 5599
+y(AST)p Ft(_)p Fj(F)n(ORMA)-7 b(T\).)p eop end
+%%Page: 300 310
+TeXDict begin 300 309 bop 0 52 a FG(300)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(NORMMAP)303 b Fd(Create)37
+b(a)i(NormMap)304 b FA(AST)p Fe(_)p FA(NORMMAP)0 656
+y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+(NormMap)g(and)h(optionally)e(initialises)i(its)g(attributes.)227
+777 y(A)k(NormMap)e(is)i(a)e(Mapping)h(whic)n(h)g(normalises)f(co)r
(ordinate)g(v)-5 b(alues)31 b(using)g(the)h(AST)p Ft(_)p
-Fj(NORM)f(routine)g(of)227 4636 y(the)38 b(supplied)g(F)-7
+Fj(NORM)f(routine)g(of)227 876 y(the)38 b(supplied)g(F)-7
b(rame.)65 b(The)37 b(n)n(um)n(b)r(er)h(of)f(inputs)h(and)f(outputs)g
(of)h(a)f(NormMap)f(are)g(b)r(oth)i(equal)f(to)g(the)227
-4735 y(n)n(um)n(b)r(er)28 b(of)f(axes)g(in)h(the)g(supplied)g(F)-7
-b(rame.)227 4860 y(The)26 b(forw)n(ard)f(and)h(in)n(v)n(erse)e
+976 y(n)n(um)n(b)r(er)28 b(of)f(axes)g(in)h(the)g(supplied)g(F)-7
+b(rame.)227 1097 y(The)26 b(forw)n(ard)f(and)h(in)n(v)n(erse)e
(transformation)h(of)h(a)f(NormMap)h(are)f(b)r(oth)h(de\014ned)g(but)h
-(are)e(iden)n(tical)h(\(that)h(is,)227 4959 y(they)h(do)g(not)f(form)h
+(are)e(iden)n(tical)h(\(that)h(is,)227 1197 y(they)h(do)g(not)f(form)h
(a)f(real)g(in)n(v)n(erse)f(pair)h(in)h(that)g(the)g(in)n(v)n(erse)e
(transformation)g(do)r(es)i(not)f(undo)h(the)g(normal-)227
-5059 y(isation,)h(instead)f(it)i(reapplies)d(it\).)42
+1296 y(isation,)h(instead)f(it)i(reapplies)d(it\).)42
b(Ho)n(w)n(ev)n(er,)27 b(the)i(AST)p Ft(_)p Fj(SIMPLIFY)g(function)g
-(will)g(replace)f(neigh)n(b)r(ouring)227 5159 y(pairs)f(of)g(forw)n
+(will)g(replace)f(neigh)n(b)r(ouring)227 1396 y(pairs)f(of)g(forw)n
(ard)f(and)i(in)n(v)n(erse)e(NormMaps)h(b)n(y)g(a)g(single)g(UnitMap.)0
-5308 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_NORMMAP\()c
-(FRAME,)i(OPTIONS,)f(STATUS)h(\))0 5457 y Fc(Argumen)m(ts:)259
-5593 y(FRAME)31 b(=)h(INTEGER)g(\(Giv)m(en\))427 5693
+1538 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_NORMMAP\()c
+(FRAME,)i(OPTIONS,)f(STATUS)h(\))0 1680 y Fc(Argumen)m(ts:)259
+1809 y(FRAME)31 b(=)h(INTEGER)g(\(Giv)m(en\))427 1909
y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(F)-7 b(rame)27 b(whic)n(h)g(is)h
(to)f(b)r(e)h(used)g(to)f(normalise)g(the)h(supplied)g(axis)e(v)-5
-b(alues.)p eop end
-%%Page: 298 308
-TeXDict begin 298 307 bop 0 52 a FG(298)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(OPTIONS)h(=)g(CHARA)m
-(CTER)g Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-451 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)f
-(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r(e)
-427 551 y(used)h(for)f(initialising)h(the)g(new)g(NormMap.)34
+b(alues.)259 2035 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g
+Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
+2134 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)
+f(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r
+(e)427 2234 y(used)h(for)f(initialising)h(the)g(new)g(NormMap.)34
b(The)22 b(syn)n(tax)f(used)h(is)f(iden)n(tical)h(to)f(that)i(for)e
-(the)h(AST)p Ft(_)p Fj(SET)427 650 y(routine.)259 777
+(the)h(AST)p Ft(_)p Fj(SET)427 2334 y(routine.)259 2459
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 877 y Fj(The)c(global)e(status.)0 1033 y Fc(Returned)32
-b(V)-8 b(alue:)259 1164 y(AST)p Ft(_)p Fc(NORMMAP)31
-b(=)h(INTEGER)427 1263 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
-(NormMap.)0 1420 y Fc(Notes:)340 1696 y Fi(\017)45 b
+427 2559 y Fj(The)c(global)e(status.)0 2713 y Fc(Returned)32
+b(V)-8 b(alue:)259 2843 y(AST)p Ft(_)p Fc(NORMMAP)31
+b(=)h(INTEGER)427 2942 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
+(NormMap.)0 3097 y Fc(Notes:)340 3372 y Fi(\017)45 b
Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 1796
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 3472
y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)-2 1952 y Fc(Status)33
-b(Handling)n(:)227 2098 y Fj(The)d(protected)g(in)n(terface)f(to)g
+(fail)h(for)f(an)n(y)g(reason.)-2 3626 y Fc(Status)33
+b(Handling)n(:)227 3772 y Fj(The)d(protected)g(in)n(terface)f(to)g
(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
-(of)g(the)g(parameter)227 2198 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
+(of)g(the)g(parameter)227 3872 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
-Fj(in)n(t)227 2297 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p
-0 2485 3780 12 v 0 2616 a FA(AST)p Fe(_)p FA(NULLREGION)419
-b Fd(Create)37 b(a)1604 2715 y(NullRegion)2527 2616 y
-FA(AST)p Fe(_)p FA(NULLREGION)0 2893 y Fc(Description:)44
-b Fj(This)28 b(function)g(creates)f(a)g(new)g(NullRegion)h(and)f
-(optionally)g(initialises)g(its)h(attributes.)227 3014
-y(A)k(NullRegion)f(is)f(a)h(Region)g(with)g(no)g(b)r(ounds.)47
-b(If)32 b(the)f(Negated)g(attribute)g(of)g(a)g(NullRegion)g(is)g
-(false,)g(the)227 3114 y(NullRegion)k(represen)n(ts)f(a)g(Region)g(con)
-n(taining)g(no)h(p)r(oin)n(ts.)59 b(If)35 b(the)h(Negated)e(attribute)h
-(of)g(a)g(NullRegion)227 3214 y(is)f(true,)h(the)f(NullRegion)f
-(represen)n(ts)f(an)h(in\014nite)i(Region)d(con)n(taining)h(all)g(p)r
-(oin)n(ts)h(within)g(the)g(co)r(ordinate)227 3313 y(system.)0
-3457 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i
-(AST_NULLREGION\()37 b(FRAME,)42 b(UNC,)f(OPTIONS,)g(STATUS)g(\))0
-3601 y Fc(Argumen)m(ts:)259 3731 y(FRAME)31 b(=)h(INTEGER)g(\(Giv)m
-(en\))427 3831 y Fj(A)d(p)r(oin)n(ter)g(to)f(the)i(F)-7
-b(rame)28 b(in)h(whic)n(h)g(the)g(region)e(is)i(de\014ned.)41
-b(A)29 b(deep)g(cop)n(y)f(is)g(tak)n(en)g(of)h(the)g(supplied)427
-3931 y(F)-7 b(rame.)71 b(This)39 b(means)f(that)h(an)n(y)g(subsequen)n
+Fj(in)n(t)227 3972 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p
+0 4156 V 0 4287 a FA(AST)p Fe(_)p FA(NULLREGION)419 b
+Fd(Create)37 b(a)1604 4386 y(NullRegion)2527 4287 y FA(AST)p
+Fe(_)p FA(NULLREGION)0 4561 y Fc(Description:)44 b Fj(This)28
+b(function)g(creates)f(a)g(new)g(NullRegion)h(and)f(optionally)g
+(initialises)g(its)h(attributes.)227 4682 y(A)k(NullRegion)f(is)f(a)h
+(Region)g(with)g(no)g(b)r(ounds.)47 b(If)32 b(the)f(Negated)g
+(attribute)g(of)g(a)g(NullRegion)g(is)g(false,)g(the)227
+4781 y(NullRegion)k(represen)n(ts)f(a)g(Region)g(con)n(taining)g(no)h
+(p)r(oin)n(ts.)59 b(If)35 b(the)h(Negated)e(attribute)h(of)g(a)g
+(NullRegion)227 4881 y(is)f(true,)h(the)f(NullRegion)f(represen)n(ts)f
+(an)h(in\014nite)i(Region)d(con)n(taining)h(all)g(p)r(oin)n(ts)h
+(within)g(the)g(co)r(ordinate)227 4981 y(system.)0 5123
+y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_NULLREGION\()37
+b(FRAME,)42 b(UNC,)f(OPTIONS,)g(STATUS)g(\))0 5265 y
+Fc(Argumen)m(ts:)259 5394 y(FRAME)31 b(=)h(INTEGER)g(\(Giv)m(en\))427
+5494 y Fj(A)d(p)r(oin)n(ter)g(to)f(the)i(F)-7 b(rame)28
+b(in)h(whic)n(h)g(the)g(region)e(is)i(de\014ned.)41 b(A)29
+b(deep)g(cop)n(y)f(is)g(tak)n(en)g(of)h(the)g(supplied)427
+5593 y(F)-7 b(rame.)71 b(This)39 b(means)f(that)h(an)n(y)g(subsequen)n
(t)f(c)n(hanges)g(made)h(to)f(the)i(F)-7 b(rame)38 b(using)h(the)g
-(supplied)427 4030 y(p)r(oin)n(ter)27 b(will)h(ha)n(v)n(e)f(no)g
-(e\013ect)h(the)g(Region.)259 4157 y Fc(UNC)k(=)g(INTEGER)f(\(Giv)m
-(en\))427 4257 y Fj(An)i(optional)e(p)r(oin)n(ter)h(to)g(an)g(existing)
-g(Region)f(whic)n(h)h(sp)r(eci\014es)g(the)h(uncertain)n(ties)e(asso)r
-(ciated)g(with)427 4357 y(p)r(ositions)37 b(in)h(the)g(supplied)g(F)-7
-b(rame.)65 b(The)38 b(uncertain)n(t)n(y)e(in)i(an)n(y)f(p)r(oin)n(t)g
-(in)h(the)g(F)-7 b(rame)37 b(is)g(found)h(b)n(y)427 4456
-y(shifting)25 b(the)f(supplied)g Ft(")p Fj(uncertain)n(t)n(y)p
-Ft(")f Fj(Region)g(so)g(that)h(it)h(is)f(cen)n(tred)f(at)h(the)g(p)r
-(oin)n(t)g(b)r(eing)h(considered.)427 4556 y(The)34 b(area)e(co)n(v)n
-(ered)g(b)n(y)i(the)g(shifted)g(uncertain)n(t)n(y)f(Region)g(then)i
-(represen)n(ts)d(the)i(uncertain)n(t)n(y)f(in)h(the)427
-4656 y(p)r(osition.)j(The)28 b(uncertain)n(t)n(y)e(is)i(assumed)f(to)g
-(b)r(e)h(the)g(same)f(for)g(all)h(p)r(oin)n(ts.)427 4769
-y(If)38 b(supplied,)j(the)d(uncertain)n(t)n(y)f(Region)g(m)n(ust)g(b)r
-(e)i(of)e(a)g(class)g(for)g(whic)n(h)h(all)f(instances)g(are)g(cen)n
-(tro-)427 4869 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24
-b(Circle,)g(Ellipse,)h(etc.\))36 b(or)23 b(b)r(e)i(a)e(Prism)h(con)n
-(taining)f(cen)n(tro-symetric)f(comp)r(onen)n(t)427 4968
-y(Regions.)57 b(A)35 b(deep)f(cop)n(y)g(of)g(the)h(supplied)g(Region)f
-(will)g(b)r(e)h(tak)n(en,)h(so)e(subsequen)n(t)g(c)n(hanges)f(to)h(the)
-427 5068 y(uncertain)n(t)n(y)g(Region)g(using)g(the)h(supplied)g(p)r
-(oin)n(ter)g(will)f(ha)n(v)n(e)g(no)g(e\013ect)h(on)g(the)g(created)f
-(Bo)n(x.)57 b(Al-)427 5167 y(ternativ)n(ely)-7 b(,)34
-b(a)f(n)n(ull)g(Ob)5 b(ject)33 b(p)r(oin)n(ter)g(\(AST)p
-Ft(__)p Fj(NULL\))g(ma)n(y)f(b)r(e)i(supplied,)h(in)e(whic)n(h)g(case)f
-(a)h(default)427 5267 y(uncertain)n(t)n(y)27 b(of)h(zero)e(is)i(used.)
-259 5394 y Fc(OPTIONS)k(=)g(CHARA)m(CTER)g Fi(\003)f
-Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427 5494 y Fj(A)g(c)n(haracter)e
-(string)h(con)n(taining)f(an)h(optional)g(comma-separated)e(list)j(of)g
-(attribute)f(assignmen)n(ts)g(to)427 5593 y(b)r(e)38
+(supplied)427 5693 y(p)r(oin)n(ter)27 b(will)h(ha)n(v)n(e)f(no)g
+(e\013ect)h(the)g(Region.)p eop end
+%%Page: 301 311
+TeXDict begin 301 310 bop 3643 52 a FG(301)259 351 y
+Fc(UNC)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 451 y Fj(An)i(optional)e(p)r
+(oin)n(ter)h(to)g(an)g(existing)g(Region)f(whic)n(h)h(sp)r(eci\014es)g
+(the)h(uncertain)n(ties)e(asso)r(ciated)g(with)427 551
+y(p)r(ositions)37 b(in)h(the)g(supplied)g(F)-7 b(rame.)65
+b(The)38 b(uncertain)n(t)n(y)e(in)i(an)n(y)f(p)r(oin)n(t)g(in)h(the)g
+(F)-7 b(rame)37 b(is)g(found)h(b)n(y)427 650 y(shifting)25
+b(the)f(supplied)g Ft(")p Fj(uncertain)n(t)n(y)p Ft(")f
+Fj(Region)g(so)g(that)h(it)h(is)f(cen)n(tred)f(at)h(the)g(p)r(oin)n(t)g
+(b)r(eing)h(considered.)427 750 y(The)34 b(area)e(co)n(v)n(ered)g(b)n
+(y)i(the)g(shifted)g(uncertain)n(t)n(y)f(Region)g(then)i(represen)n(ts)
+d(the)i(uncertain)n(t)n(y)f(in)h(the)427 849 y(p)r(osition.)j(The)28
+b(uncertain)n(t)n(y)e(is)i(assumed)f(to)g(b)r(e)h(the)g(same)f(for)g
+(all)h(p)r(oin)n(ts.)427 961 y(If)38 b(supplied,)j(the)d(uncertain)n(t)
+n(y)f(Region)g(m)n(ust)g(b)r(e)i(of)e(a)g(class)g(for)g(whic)n(h)h(all)
+f(instances)g(are)g(cen)n(tro-)427 1060 y(symetric)24
+b(\(e.g.)35 b(Bo)n(x,)24 b(Circle,)g(Ellipse,)h(etc.\))36
+b(or)23 b(b)r(e)i(a)e(Prism)h(con)n(taining)f(cen)n(tro-symetric)f
+(comp)r(onen)n(t)427 1160 y(Regions.)57 b(A)35 b(deep)f(cop)n(y)g(of)g
+(the)h(supplied)g(Region)f(will)g(b)r(e)h(tak)n(en,)h(so)e(subsequen)n
+(t)g(c)n(hanges)f(to)h(the)427 1260 y(uncertain)n(t)n(y)g(Region)g
+(using)g(the)h(supplied)g(p)r(oin)n(ter)g(will)f(ha)n(v)n(e)g(no)g
+(e\013ect)h(on)g(the)g(created)f(Bo)n(x.)57 b(Al-)427
+1359 y(ternativ)n(ely)-7 b(,)34 b(a)f(n)n(ull)g(Ob)5
+b(ject)33 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fj(NULL\))g(ma)n(y)f(b)r(e)
+i(supplied,)h(in)e(whic)n(h)g(case)f(a)h(default)427
+1459 y(uncertain)n(t)n(y)27 b(of)h(zero)e(is)i(used.)259
+1582 y Fc(OPTIONS)k(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1682 y Fj(A)g(c)n(haracter)e(string)
+h(con)n(taining)f(an)h(optional)g(comma-separated)e(list)j(of)g
+(attribute)f(assignmen)n(ts)g(to)427 1781 y(b)r(e)38
b(used)g(for)f(initialising)g(the)h(new)g(NullRegion.)67
b(The)38 b(syn)n(tax)e(used)i(is)f(iden)n(tical)h(to)f(that)h(for)f
-(the)427 5693 y(AST)p Ft(_)p Fj(SET)27 b(routine.)p eop
-end
-%%Page: 299 309
-TeXDict begin 299 308 bop 3643 52 a FG(299)259 351 y
-Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-451 y Fj(The)c(global)e(status.)0 607 y Fc(Returned)32
-b(V)-8 b(alue:)259 737 y(AST)p Ft(_)p Fc(NULLREGION)32
-b(=)g(INTEGER)427 837 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
-(NullRegion.)0 992 y Fc(Notes:)340 1269 y Fi(\017)45
-b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
-Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 1368
-y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 1555 3780 12 v 0 1686
-a FA(AST)p Fe(_)p FA(OFFSET)1208 1687 y Fd(Calculate)36
-b(an)j(o\013set)g(along)e(a)1524 1801 y(geo)s(desic)h(curv)m(e)2922
-1686 y FA(AST)p Fe(_)p FA(OFFSET)0 1978 y Fc(Description:)44
+(the)427 1881 y(AST)p Ft(_)p Fj(SET)27 b(routine.)259
+2004 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 2104 y Fj(The)c(global)e(status.)0 2256
+y Fc(Returned)32 b(V)-8 b(alue:)259 2383 y(AST)p Ft(_)p
+Fc(NULLREGION)32 b(=)g(INTEGER)427 2482 y Fj(A)c(p)r(oin)n(ter)f(to)h
+(the)g(new)g(NullRegion.)0 2634 y Fc(Notes:)340 2907
+y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f
+(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f
+(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427
+3007 y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g
+(should)f(fail)h(for)f(an)n(y)g(reason.)p 0 3187 3780
+12 v 0 3317 a FA(AST)p Fe(_)p FA(OFFSET)1208 3318 y Fd(Calculate)36
+b(an)j(o\013set)g(along)e(a)1524 3433 y(geo)s(desic)h(curv)m(e)2922
+3317 y FA(AST)p Fe(_)p FA(OFFSET)0 3602 y Fc(Description:)44
b Fj(This)20 b(routine)f(\014nds)h(the)f(F)-7 b(rame)19
b(co)r(ordinate)g(v)-5 b(alues)19 b(of)g(a)g(p)r(oin)n(t)h(whic)n(h)f
-(is)h(o\013set)f(a)g(sp)r(eci\014ed)h(distance)227 2078
+(is)h(o\013set)f(a)g(sp)r(eci\014ed)h(distance)227 3702
y(along)27 b(the)h(geo)r(desic)e(curv)n(e)h(b)r(et)n(w)n(een)g(t)n(w)n
-(o)g(other)g(p)r(oin)n(ts.)227 2199 y(F)-7 b(or)28 b(example,)h(in)f(a)
+(o)g(other)g(p)r(oin)n(ts.)227 3822 y(F)-7 b(or)28 b(example,)h(in)f(a)
h(basic)f(F)-7 b(rame,)28 b(this)h(o\013set)f(will)h(b)r(e)g(along)e
(the)i(straigh)n(t)f(line)g(joining)h(t)n(w)n(o)e(p)r(oin)n(ts.)40
-b(F)-7 b(or)28 b(a)227 2299 y(more)h(sp)r(ecialised)h(F)-7
+b(F)-7 b(or)28 b(a)227 3921 y(more)h(sp)r(ecialised)h(F)-7
b(rame)29 b(describing)h(a)f(sky)h(co)r(ordinate)e(system,)j(ho)n(w)n
(ev)n(er,)d(it)j(w)n(ould)e(b)r(e)i(along)d(the)j(great)227
-2398 y(circle)c(passing)g(through)g(t)n(w)n(o)f(sky)i(p)r(ositions.)0
-2542 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_OFFSET\()d(THIS,)
+4021 y(circle)c(passing)g(through)g(t)n(w)n(o)f(sky)i(p)r(ositions.)0
+4161 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_OFFSET\()d(THIS,)
i(POINT1,)g(POINT2,)g(OFFSET,)f(POINT3,)h(STATUS)g(\))0
-2685 y Fc(Argumen)m(ts:)259 2815 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 2915 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
-b(rame.)259 3042 y Fc(POINT1\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h
-(PRECISION)e(\(Giv)m(en\))427 3141 y Fj(An)h(arra)n(y)d(with)j(one)f
+4300 y Fc(Argumen)m(ts:)259 4427 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 4527 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rame.)259 4650 y Fc(POINT1\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h
+(PRECISION)e(\(Giv)m(en\))427 4749 y Fj(An)h(arra)n(y)d(with)j(one)f
(elemen)n(t)g(for)g(eac)n(h)g(F)-7 b(rame)30 b(axis)h(\(Naxes)g
(attribute\).)48 b(This)32 b(should)f(con)n(tain)f(the)427
-3241 y(co)r(ordinates)c(of)i(the)g(p)r(oin)n(t)g(marking)e(the)i(start)
-f(of)h(the)g(geo)r(desic)e(curv)n(e.)259 3367 y Fc(POINT2\()32
+4849 y(co)r(ordinates)c(of)i(the)g(p)r(oin)n(t)g(marking)e(the)i(start)
+f(of)h(the)g(geo)r(desic)e(curv)n(e.)259 4972 y Fc(POINT2\()32
b Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m(en\))427
-3467 y Fj(An)g(arra)n(y)c(with)k(one)f(elemen)n(t)g(for)f(eac)n(h)g(F)
+5072 y Fj(An)g(arra)n(y)c(with)k(one)f(elemen)n(t)g(for)f(eac)n(h)g(F)
-7 b(rame)30 b(axis.)43 b(This)30 b(should)g(con)n(tain)f(the)i(co)r
-(ordinates)d(of)i(the)427 3567 y(p)r(oin)n(t)e(marking)e(the)i(end)g
-(of)g(the)g(geo)r(desic)e(curv)n(e.)259 3693 y Fc(OFFSET)32
-b(=)g(DOUBLE)g(PRECISION)427 3793 y Fj(The)27 b(required)e(o\013set)i
+(ordinates)d(of)i(the)427 5171 y(p)r(oin)n(t)e(marking)e(the)i(end)g
+(of)g(the)g(geo)r(desic)e(curv)n(e.)259 5295 y Fc(OFFSET)32
+b(=)g(DOUBLE)g(PRECISION)427 5394 y Fj(The)27 b(required)e(o\013set)i
(from)f(the)h(\014rst)f(p)r(oin)n(t)g(along)g(the)g(geo)r(desic)g(curv)
n(e.)35 b(If)27 b(this)g(is)f(p)r(ositiv)n(e,)h(it)g(will)f(b)r(e)427
-3893 y(to)n(w)n(ards)20 b(the)i(second)f(p)r(oin)n(t.)35
+5494 y(to)n(w)n(ards)20 b(the)i(second)f(p)r(oin)n(t.)35
b(If)22 b(it)g(is)f(negativ)n(e,)h(it)g(will)f(b)r(e)h(in)g(the)g(opp)r
(osite)f(direction.)35 b(This)21 b(o\013set)g(need)427
-3992 y(not)28 b(imply)g(a)f(p)r(osition)h(lying)f(b)r(et)n(w)n(een)h
+5593 y(not)28 b(imply)g(a)f(p)r(osition)h(lying)f(b)r(et)n(w)n(een)h
(the)g(t)n(w)n(o)f(p)r(oin)n(ts)h(giv)n(en,)f(as)g(the)h(curv)n(e)e
-(will)i(b)r(e)g(extrap)r(olated)f(if)427 4092 y(necessary)-7
-b(.)259 4219 y Fc(POINT3\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h
-(PRECISION)e(\(Returned\))427 4318 y Fj(An)25 b(arra)n(y)c(with)k(one)e
-(elemen)n(t)i(for)e(eac)n(h)g(F)-7 b(rame)24 b(axis)f(in)h(whic)n(h)g
-(the)g(co)r(ordinates)f(of)h(the)g(required)f(p)r(oin)n(t)427
-4418 y(will)28 b(b)r(e)g(returned.)259 4545 y Fc(ST)-8
-b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-4644 y Fj(The)c(global)e(status.)0 4800 y Fc(Notes:)340
-5076 y Fi(\017)45 b Fj(The)28 b(geo)r(desic)f(curv)n(e)g(used)h(b)n(y)g
-(this)g(routine)g(is)g(the)g(path)g(of)g(shortest)g(distance)f(b)r(et)n
-(w)n(een)h(t)n(w)n(o)g(p)r(oin)n(ts,)427 5176 y(as)f(de\014ned)h(b)n(y)
-f(the)h(AST)p Ft(_)p Fj(DIST)-7 b(ANCE)29 b(function.)340
-5303 y Fi(\017)45 b Fj(This)19 b(function)g(will)g(return)f
-Ft(")p Fj(bad)p Ft(")g Fj(co)r(ordinate)g(v)-5 b(alues)18
-b(\(AST)p Ft(__)p Fj(BAD\))i(if)f(an)n(y)f(of)g(the)i(input)f(co)r
-(ordinates)427 5402 y(has)27 b(this)h(v)-5 b(alue.)340
-5529 y Fi(\017)45 b Ft(")p Fj(Bad)p Ft(")32 b Fj(co)r(ordinate)f(v)-5
-b(alues)32 b(will)h(also)e(b)r(e)i(returned)f(if)h(the)g(t)n(w)n(o)f(p)
-r(oin)n(ts)g(supplied)h(are)f(coinciden)n(t)g(\(or)427
-5629 y(otherwise)27 b(fail)h(to)f(uniquely)h(sp)r(ecify)g(a)f(geo)r
-(desic)g(curv)n(e\))f(but)j(the)f(requested)f(o\013set)g(is)h
-(non-zero.)p eop end
-%%Page: 300 310
-TeXDict begin 300 309 bop 0 52 a FG(300)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(OFFSET2)1208 483 y Fd(Calculate)36
-b(an)j(o\013set)g(along)e(a)1133 598 y(geo)s(desic)i(curv)m(e)f(in)g(a)
-h(2D)g(F)-10 b(rame)2854 482 y FA(AST)p Fe(_)p FA(OFFSET2)0
-829 y Fc(Description:)44 b Fj(This)20 b(routine)f(\014nds)h(the)f(F)-7
-b(rame)19 b(co)r(ordinate)g(v)-5 b(alues)19 b(of)g(a)g(p)r(oin)n(t)h
-(whic)n(h)f(is)h(o\013set)f(a)g(sp)r(eci\014ed)h(distance)227
-929 y(along)26 b(the)h(geo)r(desic)f(curv)n(e)g(at)h(a)g(giv)n(en)f
-(angle)g(from)h(a)f(sp)r(eci\014ed)h(starting)g(p)r(oin)n(t.)36
-b(It)28 b(can)e(only)h(b)r(e)g(used)g(with)227 1028 y(2-dimensional)g
-(F)-7 b(rames.)227 1174 y(F)g(or)28 b(example,)h(in)f(a)h(basic)f(F)-7
+(will)i(b)r(e)g(extrap)r(olated)f(if)427 5693 y(necessary)-7
+b(.)p eop end
+%%Page: 302 312
+TeXDict begin 302 311 bop 0 52 a FG(302)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(POINT3\()h
+Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Returned\))427
+451 y Fj(An)25 b(arra)n(y)c(with)k(one)e(elemen)n(t)i(for)e(eac)n(h)g
+(F)-7 b(rame)24 b(axis)f(in)h(whic)n(h)g(the)g(co)r(ordinates)f(of)h
+(the)g(required)f(p)r(oin)n(t)427 551 y(will)28 b(b)r(e)g(returned.)259
+676 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 775 y Fj(The)c(global)e(status.)0 930
+y Fc(Notes:)340 1205 y Fi(\017)45 b Fj(The)28 b(geo)r(desic)f(curv)n(e)
+g(used)h(b)n(y)g(this)g(routine)g(is)g(the)g(path)g(of)g(shortest)g
+(distance)f(b)r(et)n(w)n(een)h(t)n(w)n(o)g(p)r(oin)n(ts,)427
+1304 y(as)f(de\014ned)h(b)n(y)f(the)h(AST)p Ft(_)p Fj(DIST)-7
+b(ANCE)29 b(function.)340 1429 y Fi(\017)45 b Fj(This)19
+b(function)g(will)g(return)f Ft(")p Fj(bad)p Ft(")g Fj(co)r(ordinate)g
+(v)-5 b(alues)18 b(\(AST)p Ft(__)p Fj(BAD\))i(if)f(an)n(y)f(of)g(the)i
+(input)f(co)r(ordinates)427 1529 y(has)27 b(this)h(v)-5
+b(alue.)340 1654 y Fi(\017)45 b Ft(")p Fj(Bad)p Ft(")32
+b Fj(co)r(ordinate)f(v)-5 b(alues)32 b(will)h(also)e(b)r(e)i(returned)f
+(if)h(the)g(t)n(w)n(o)f(p)r(oin)n(ts)g(supplied)h(are)f(coinciden)n(t)g
+(\(or)427 1754 y(otherwise)27 b(fail)h(to)f(uniquely)h(sp)r(ecify)g(a)f
+(geo)r(desic)g(curv)n(e\))f(but)j(the)f(requested)f(o\013set)g(is)h
+(non-zero.)p 0 1938 3780 12 v 0 2069 a FA(AST)p Fe(_)p
+FA(OFFSET2)1208 2070 y Fd(Calculate)36 b(an)j(o\013set)g(along)e(a)1133
+2184 y(geo)s(desic)i(curv)m(e)f(in)g(a)h(2D)g(F)-10 b(rame)2854
+2069 y FA(AST)p Fe(_)p FA(OFFSET2)0 2358 y Fc(Description:)44
+b Fj(This)20 b(routine)f(\014nds)h(the)f(F)-7 b(rame)19
+b(co)r(ordinate)g(v)-5 b(alues)19 b(of)g(a)g(p)r(oin)n(t)h(whic)n(h)f
+(is)h(o\013set)f(a)g(sp)r(eci\014ed)h(distance)227 2457
+y(along)26 b(the)h(geo)r(desic)f(curv)n(e)g(at)h(a)g(giv)n(en)f(angle)g
+(from)h(a)f(sp)r(eci\014ed)h(starting)g(p)r(oin)n(t.)36
+b(It)28 b(can)e(only)h(b)r(e)g(used)g(with)227 2557 y(2-dimensional)g
+(F)-7 b(rames.)227 2678 y(F)g(or)28 b(example,)h(in)f(a)h(basic)f(F)-7
b(rame,)28 b(this)h(o\013set)f(will)h(b)r(e)g(along)e(the)i(straigh)n
(t)f(line)g(joining)h(t)n(w)n(o)e(p)r(oin)n(ts.)40 b(F)-7
-b(or)28 b(a)227 1274 y(more)h(sp)r(ecialised)h(F)-7 b(rame)29
+b(or)28 b(a)227 2777 y(more)h(sp)r(ecialised)h(F)-7 b(rame)29
b(describing)h(a)f(sky)h(co)r(ordinate)e(system,)j(ho)n(w)n(ev)n(er,)d
-(it)j(w)n(ould)e(b)r(e)i(along)d(the)j(great)227 1373
+(it)j(w)n(ould)e(b)r(e)i(along)d(the)j(great)227 2877
y(circle)c(passing)g(through)g(t)n(w)n(o)f(sky)i(p)r(ositions.)0
-1565 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_OFFSET2\()c
+3019 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_OFFSET2\()c
(THIS,)i(POINT1,)g(ANGLE,)g(OFFSET,)g(POINT2,)f(STATUS)h(\))0
-1757 y Fc(Argumen)m(ts:)259 1936 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 2036 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
-b(rame.)259 2190 y Fc(POINT1\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h
-(PRECISION)e(\(Giv)m(en\))427 2290 y Fj(An)h(arra)n(y)d(with)j(one)f
+3161 y Fc(Argumen)m(ts:)259 3289 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 3389 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rame.)259 3514 y Fc(POINT1\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h
+(PRECISION)e(\(Giv)m(en\))427 3614 y Fj(An)h(arra)n(y)d(with)j(one)f
(elemen)n(t)g(for)g(eac)n(h)g(F)-7 b(rame)30 b(axis)h(\(Naxes)g
(attribute\).)48 b(This)32 b(should)f(con)n(tain)f(the)427
-2389 y(co)r(ordinates)c(of)i(the)g(p)r(oin)n(t)g(marking)e(the)i(start)
-f(of)h(the)g(geo)r(desic)e(curv)n(e.)259 2543 y Fc(ANGLE)32
-b(=)g(DOUBLE)g(PRECISION)g(\(Giv)m(en\))427 2643 y Fj(The)d(angle)f
+3714 y(co)r(ordinates)c(of)i(the)g(p)r(oin)n(t)g(marking)e(the)i(start)
+f(of)h(the)g(geo)r(desic)e(curv)n(e.)259 3839 y Fc(ANGLE)32
+b(=)g(DOUBLE)g(PRECISION)g(\(Giv)m(en\))427 3938 y Fj(The)d(angle)f
(\(in)i(radians\))e(from)g(the)i(p)r(ositiv)n(e)e(direction)h(of)g(the)
g(second)f(axis,)h(to)g(the)g(direction)f(of)h(the)427
-2743 y(required)38 b(p)r(osition,)i(as)e(seen)g(from)g(the)g(starting)g
+4038 y(required)38 b(p)r(osition,)i(as)e(seen)g(from)g(the)g(starting)g
(p)r(osition.)68 b(P)n(ositiv)n(e)37 b(rotation)g(is)h(in)g(the)h
-(sense)f(of)427 2842 y(rotation)27 b(from)g(the)h(p)r(ositiv)n(e)f
+(sense)f(of)427 4138 y(rotation)27 b(from)g(the)h(p)r(ositiv)n(e)f
(direction)g(of)h(axis)f(2)g(to)g(the)h(p)r(ositiv)n(e)g(direction)f
-(of)g(axis)g(1.)259 2996 y Fc(OFFSET)32 b(=)g(DOUBLE)g(PRECISION)427
-3096 y Fj(The)27 b(required)e(o\013set)i(from)f(the)h(\014rst)f(p)r
+(of)g(axis)g(1.)259 4263 y Fc(OFFSET)32 b(=)g(DOUBLE)g(PRECISION)427
+4362 y Fj(The)27 b(required)e(o\013set)i(from)f(the)h(\014rst)f(p)r
(oin)n(t)g(along)g(the)g(geo)r(desic)g(curv)n(e.)35 b(If)27
b(this)g(is)f(p)r(ositiv)n(e,)h(it)g(will)f(b)r(e)427
-3196 y(in)i(the)g(direction)f(of)h(the)g(giv)n(en)f(angle.)36
+4462 y(in)i(the)g(direction)f(of)h(the)g(giv)n(en)f(angle.)36
b(If)28 b(it)g(is)f(negativ)n(e,)g(it)h(will)g(b)r(e)g(in)f(the)h(opp)r
-(osite)g(direction.)259 3350 y Fc(POINT2\()k Fi(\003)f
-Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Returned\))427 3449
+(osite)g(direction.)259 4587 y Fc(POINT2\()k Fi(\003)f
+Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Returned\))427 4687
y Fj(An)25 b(arra)n(y)c(with)k(one)e(elemen)n(t)i(for)e(eac)n(h)g(F)-7
b(rame)24 b(axis)f(in)h(whic)n(h)g(the)g(co)r(ordinates)f(of)h(the)g
-(required)f(p)r(oin)n(t)427 3549 y(will)28 b(b)r(e)g(returned.)259
-3703 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 3803 y Fj(The)c(global)e(status.)0 4007
-y Fc(Returned)32 b(V)-8 b(alue:)259 4186 y(AST)p Ft(_)p
-Fc(OFFSET2)32 b(=)g(DOUBLE)g(PRECISION)427 4286 y Fj(The)27
+(required)f(p)r(oin)n(t)427 4787 y(will)28 b(b)r(e)g(returned.)259
+4912 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 5011 y Fj(The)c(global)e(status.)0 5166
+y Fc(Returned)32 b(V)-8 b(alue:)259 5295 y(AST)p Ft(_)p
+Fc(OFFSET2)32 b(=)g(DOUBLE)g(PRECISION)427 5394 y Fj(The)27
b(direction)f(of)g(the)h(geo)r(desic)e(curv)n(e)g(at)h(the)h(end)g(p)r
(oin)n(t.)36 b(That)27 b(is,)f(the)h(angle)e(\(in)i(radians\))f(b)r(et)
-n(w)n(een)427 4386 y(the)35 b(p)r(ositiv)n(e)e(direction)h(of)g(the)g
+n(w)n(een)427 5494 y(the)35 b(p)r(ositiv)n(e)e(direction)h(of)g(the)g
(second)f(axis)h(and)g(the)g(con)n(tin)n(uation)f(of)h(the)g(geo)r
-(desic)f(curv)n(e)g(at)h(the)427 4485 y(requested)29
+(desic)f(curv)n(e)g(at)h(the)427 5593 y(requested)29
b(end)h(p)r(oin)n(t.)42 b(P)n(ositiv)n(e)28 b(rotation)g(is)h(in)h(the)
g(sense)f(of)g(rotation)f(from)h(the)h(p)r(ositiv)n(e)f(direction)427
-4585 y(of)f(axis)f(2)g(to)g(the)h(p)r(ositiv)n(e)f(direction)h(of)f
-(axis)g(1.)0 4789 y Fc(Notes:)340 5114 y Fi(\017)45 b
-Fj(The)28 b(geo)r(desic)f(curv)n(e)g(used)h(b)n(y)g(this)g(routine)g
-(is)g(the)g(path)g(of)g(shortest)g(distance)f(b)r(et)n(w)n(een)h(t)n(w)
-n(o)g(p)r(oin)n(ts,)427 5214 y(as)f(de\014ned)h(b)n(y)f(the)h(AST)p
-Ft(_)p Fj(DIST)-7 b(ANCE)29 b(function.)340 5368 y Fi(\017)45
-b Fj(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)h(the)g(F)-7
-b(rame)27 b(is)g(not)h(2-dimensional.)340 5522 y Fi(\017)45
-b Fj(This)19 b(function)g(will)g(return)f Ft(")p Fj(bad)p
-Ft(")g Fj(co)r(ordinate)g(v)-5 b(alues)18 b(\(AST)p Ft(__)p
-Fj(BAD\))i(if)f(an)n(y)f(of)g(the)i(input)f(co)r(ordinates)427
-5622 y(has)27 b(this)h(v)-5 b(alue.)p eop end
-%%Page: 301 311
-TeXDict begin 301 310 bop 3643 52 a FG(301)p 0 351 3780
-12 v 0 482 a FA(AST)p Fe(_)p FA(OUTLINE)p Fb(<)p FA(X)p
-Fb(>)313 b Fd(Create)37 b(a)h(new)1486 581 y(P)m(olygon)e(outling)1391
-696 y(v)-7 b(alues)39 b(in)f(a)h(2D)g(data)1789 795 y(grid)2542
-482 y FA(AST)p Fe(_)p FA(OUTLINE)p Fb(<)p FA(X)p Fb(>)0
-979 y Fc(Description:)44 b Fj(This)27 b(is)g(a)g(set)g(of)g(functions)g
-(that)g(create)g(a)f(P)n(olygon)f(enclosing)h(a)h(single)f(con)n
-(tiguous)g(set)h(of)g(pixels)227 1078 y(that)h(ha)n(v)n(e)f(a)g(sp)r
-(eci\014ed)h(v)-5 b(alue)27 b(within)h(a)g(gridded)f(2-dimensional)f
-(data)h(arra)n(y)e(\(e.g.)37 b(an)27 b(image\).)227 1201
-y(A)40 b(basic)f(2-dimensional)e(F)-7 b(rame)39 b(is)g(used)h(to)f
-(represen)n(t)f(the)h(pixel)h(co)r(ordinate)e(system)h(in)g(the)h
-(returned)227 1301 y(P)n(olygon.)33 b(The)21 b(Domain)g(attribute)h(is)
-f(set)g(to)h Ft(")p Fj(PIXEL)p Ft(")p Fj(,)f(the)g(Title)h(attribute)f
-(is)h(set)f(to)g Ft(")p Fj(Pixel)f(co)r(ordinates)p Ft(")p
-Fj(,)227 1400 y(and)i(the)h(Unit)f(attribute)h(for)e(eac)n(h)g(axis)h
-(is)g(set)g(to)g Ft(")p Fj(pixel)p Ft(")p Fj(.)34 b(All)22
-b(other)g(attributes)g(are)f(left)i(unset.)35 b(The)22
-b(nature)227 1500 y(of)28 b(the)g(pixel)f(co)r(ordinate)g(system)g(is)h
-(determined)f(b)n(y)h(parameter)e(ST)-7 b(ARPIX.)227
-1623 y(The)33 b(MAXERR)f(and)h(MAXVER)-7 b(T)33 b(parameters)d(can)i(b)
-r(e)h(used)f(to)h(con)n(trol)e(ho)n(w)g(accurately)g(the)i(returned)227
-1723 y(P)n(olygon)28 b(represen)n(ts)g(the)i(required)f(region)f(in)i
-(the)g(data)f(arra)n(y)-7 b(.)41 b(The)30 b(n)n(um)n(b)r(er)f(of)h(v)n
-(ertices)e(in)i(the)g(returned)227 1822 y(P)n(olygon)c(will)h(b)r(e)i
-(the)e(minim)n(um)i(needed)f(to)f(ac)n(hiev)n(e)f(the)i(required)f
-(accuracy)-7 b(.)227 1946 y(Y)g(ou)34 b(should)g(use)g(a)f(function)i
-(whic)n(h)f(matc)n(hes)f(the)h(n)n(umerical)f(t)n(yp)r(e)i(of)f(the)g
-(data)f(y)n(ou)g(are)g(pro)r(cessing)g(b)n(y)227 2045
-y(replacing)e Fl(<)p Fj(X)p Fl(>)g Fj(in)h(the)g(generic)e(function)i
-(name)g(AST)p Ft(_)p Fj(OUTLINE)p Fl(<)p Fj(X)p Fl(>)e
-Fj(are)h(pro)r(cesing)f(data)h(with)h(t)n(yp)r(e)227
-2145 y(REAL,)c(y)n(ou)f(should)g(use)g(the)i(function)f(AST)p
-Ft(_)p Fj(OUTLINER)f(\(see)g(the)h Ft(")p Fj(Data)f(T)n(yp)r(e)h(Co)r
-(des)p Ft(")f Fj(section)g(b)r(elo)n(w)227 2244 y(for)g(the)h(co)r(des)
-f(appropriate)f(to)i(other)f(n)n(umerical)g(t)n(yp)r(es\).)0
-2391 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_OUTLINE)p
-Fl(<)p Ft(X)p Fl(>)p Ft(\()37 b(VALUE,)k(OPER,)h(ARRAY,)f(LBND,)h
-(UBND,)f(MAXERR,)g(MAXVERT,)227 2491 y(INSIDE,)g(STARPIX,)f(STATUS)h
-(\))0 2637 y Fc(Argumen)m(ts:)259 2771 y(V)-11 b(ALUE)33
-b(=)f Fl(<)p Fc(Xt)m(yp)s(e)p Fl(>)g Fc(\(Giv)m(en\))427
-2870 y Fj(A)c(data)f(v)-5 b(alue)28 b(that)g(sp)r(eci\014es)f(the)h
-(pixels)g(to)f(b)r(e)h(outlined.)259 3000 y Fc(OPER)j(=)h(INTEGER)g
-(\(Giv)m(en\))427 3100 y Fj(Indicates)26 b(ho)n(w)g(the)h(V)-9
+5693 y(of)f(axis)f(2)g(to)g(the)h(p)r(ositiv)n(e)f(direction)h(of)f
+(axis)g(1.)p eop end
+%%Page: 303 313
+TeXDict begin 303 312 bop 3643 52 a FG(303)0 351 y Fc(Notes:)340
+642 y Fi(\017)45 b Fj(The)28 b(geo)r(desic)f(curv)n(e)g(used)h(b)n(y)g
+(this)g(routine)g(is)g(the)g(path)g(of)g(shortest)g(distance)f(b)r(et)n
+(w)n(een)h(t)n(w)n(o)g(p)r(oin)n(ts,)427 741 y(as)f(de\014ned)h(b)n(y)f
+(the)h(AST)p Ft(_)p Fj(DIST)-7 b(ANCE)29 b(function.)340
+878 y Fi(\017)45 b Fj(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)h
+(the)g(F)-7 b(rame)27 b(is)g(not)h(2-dimensional.)340
+1015 y Fi(\017)45 b Fj(This)19 b(function)g(will)g(return)f
+Ft(")p Fj(bad)p Ft(")g Fj(co)r(ordinate)g(v)-5 b(alues)18
+b(\(AST)p Ft(__)p Fj(BAD\))i(if)f(an)n(y)f(of)g(the)i(input)f(co)r
+(ordinates)427 1114 y(has)27 b(this)h(v)-5 b(alue.)p
+0 1321 3780 12 v 0 1452 a FA(AST)p Fe(_)p FA(OUTLINE)p
+Fb(<)p FA(X)p Fb(>)313 b Fd(Create)37 b(a)h(new)1486
+1551 y(P)m(olygon)e(outling)1391 1666 y(v)-7 b(alues)39
+b(in)f(a)h(2D)g(data)1789 1765 y(grid)2542 1452 y FA(AST)p
+Fe(_)p FA(OUTLINE)p Fb(<)p FA(X)p Fb(>)0 1962 y Fc(Description:)44
+b Fj(This)27 b(is)g(a)g(set)g(of)g(functions)g(that)g(create)g(a)f(P)n
+(olygon)f(enclosing)h(a)h(single)f(con)n(tiguous)g(set)h(of)g(pixels)
+227 2062 y(that)h(ha)n(v)n(e)f(a)g(sp)r(eci\014ed)h(v)-5
+b(alue)27 b(within)h(a)g(gridded)f(2-dimensional)f(data)h(arra)n(y)e
+(\(e.g.)37 b(an)27 b(image\).)227 2190 y(A)40 b(basic)f(2-dimensional)e
+(F)-7 b(rame)39 b(is)g(used)h(to)f(represen)n(t)f(the)h(pixel)h(co)r
+(ordinate)e(system)h(in)g(the)h(returned)227 2290 y(P)n(olygon.)33
+b(The)21 b(Domain)g(attribute)h(is)f(set)g(to)h Ft(")p
+Fj(PIXEL)p Ft(")p Fj(,)f(the)g(Title)h(attribute)f(is)h(set)f(to)g
+Ft(")p Fj(Pixel)f(co)r(ordinates)p Ft(")p Fj(,)227 2389
+y(and)i(the)h(Unit)f(attribute)h(for)e(eac)n(h)g(axis)h(is)g(set)g(to)g
+Ft(")p Fj(pixel)p Ft(")p Fj(.)34 b(All)22 b(other)g(attributes)g(are)f
+(left)i(unset.)35 b(The)22 b(nature)227 2489 y(of)28
+b(the)g(pixel)f(co)r(ordinate)g(system)g(is)h(determined)f(b)n(y)h
+(parameter)e(ST)-7 b(ARPIX.)227 2617 y(The)33 b(MAXERR)f(and)h(MAXVER)
+-7 b(T)33 b(parameters)d(can)i(b)r(e)h(used)f(to)h(con)n(trol)e(ho)n(w)
+g(accurately)g(the)i(returned)227 2717 y(P)n(olygon)28
+b(represen)n(ts)g(the)i(required)f(region)f(in)i(the)g(data)f(arra)n(y)
+-7 b(.)41 b(The)30 b(n)n(um)n(b)r(er)f(of)h(v)n(ertices)e(in)i(the)g
+(returned)227 2817 y(P)n(olygon)c(will)h(b)r(e)i(the)e(minim)n(um)i
+(needed)f(to)f(ac)n(hiev)n(e)f(the)i(required)f(accuracy)-7
+b(.)227 2945 y(Y)g(ou)34 b(should)g(use)g(a)f(function)i(whic)n(h)f
+(matc)n(hes)f(the)h(n)n(umerical)f(t)n(yp)r(e)i(of)f(the)g(data)f(y)n
+(ou)g(are)g(pro)r(cessing)g(b)n(y)227 3045 y(replacing)e
+Fl(<)p Fj(X)p Fl(>)g Fj(in)h(the)g(generic)e(function)i(name)g(AST)p
+Ft(_)p Fj(OUTLINE)p Fl(<)p Fj(X)p Fl(>)e Fj(are)h(pro)r(cesing)f(data)h
+(with)h(t)n(yp)r(e)227 3144 y(REAL,)c(y)n(ou)f(should)g(use)g(the)i
+(function)f(AST)p Ft(_)p Fj(OUTLINER)f(\(see)g(the)h
+Ft(")p Fj(Data)f(T)n(yp)r(e)h(Co)r(des)p Ft(")f Fj(section)g(b)r(elo)n
+(w)227 3244 y(for)g(the)h(co)r(des)f(appropriate)f(to)i(other)f(n)n
+(umerical)g(t)n(yp)r(es\).)0 3401 y Fc(In)m(v)m(o)s(cation:)123
+b Ft(RESULT)41 b(=)i(AST_OUTLINE)p Fl(<)p Ft(X)p Fl(>)p
+Ft(\()37 b(VALUE,)k(OPER,)h(ARRAY,)f(LBND,)h(UBND,)f(MAXERR,)g
+(MAXVERT,)227 3501 y(INSIDE,)g(STARPIX,)f(STATUS)h(\))0
+3658 y Fc(Argumen)m(ts:)259 3802 y(V)-11 b(ALUE)33 b(=)f
+Fl(<)p Fc(Xt)m(yp)s(e)p Fl(>)g Fc(\(Giv)m(en\))427 3902
+y Fj(A)c(data)f(v)-5 b(alue)28 b(that)g(sp)r(eci\014es)f(the)h(pixels)g
+(to)f(b)r(e)h(outlined.)259 4039 y Fc(OPER)j(=)h(INTEGER)g(\(Giv)m
+(en\))427 4138 y Fj(Indicates)26 b(ho)n(w)g(the)h(V)-9
b(ALUE)27 b(parameter)e(is)h(used)g(to)h(select)f(the)h(outlined)g
(pixels.)36 b(It)27 b(can)f(ha)n(v)n(e)f(an)n(y)h(of)427
-3200 y(the)i(follo)n(wing)f(v)-5 b(alues:)510 3304 y
+4238 y(the)i(follo)n(wing)f(v)-5 b(alues:)510 4349 y
Fi(\017)45 b Fj(AST)p Ft(__)p Fj(L)-7 b(T:)27 b(outline)h(pixels)g
(with)g(v)-5 b(alue)27 b(less)g(than)h(V)-9 b(ALUE.)510
-3419 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(LE:)27 b(outline)h(pixels)f
+4467 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(LE:)27 b(outline)h(pixels)f
(with)h(v)-5 b(alue)28 b(less)f(than)g(or)g(equal)g(to)h(V)-9
-b(ALUE.)510 3534 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(EQ:)27
+b(ALUE.)510 4585 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(EQ:)27
b(outline)g(pixels)h(with)g(v)-5 b(alue)27 b(equal)g(to)h(V)-9
-b(ALUE.)510 3648 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(NE:)27
+b(ALUE.)510 4704 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(NE:)27
b(outline)h(pixels)f(with)i(v)-5 b(alue)27 b(not)h(equal)f(to)g(V)-9
-b(ALUE.)510 3763 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(GE:)27
+b(ALUE.)510 4822 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(GE:)27
b(outline)h(pixels)f(with)h(v)-5 b(alue)28 b(greater)e(than)h(or)g
-(equal)g(to)h(V)-9 b(ALUE.)510 3878 y Fi(\017)45 b Fj(AST)p
+(equal)g(to)h(V)-9 b(ALUE.)510 4940 y Fi(\017)45 b Fj(AST)p
Ft(__)p Fj(GT:)28 b(outline)f(pixels)h(with)g(v)-5 b(alue)27
-b(greater)f(than)i(V)-9 b(ALUE.)259 4008 y Fc(ARRA)h(Y\()32
+b(greater)f(than)i(V)-9 b(ALUE.)259 5077 y Fc(ARRA)h(Y\()32
b Fi(\003)f Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p Fl(>)g
-Fc(\(Giv)m(en\))427 4108 y Fj(A)27 b(2-dimensional)d(arra)n(y)g(con)n
+Fc(\(Giv)m(en\))427 5176 y Fj(A)27 b(2-dimensional)d(arra)n(y)g(con)n
(taining)h(the)i(data)e(to)h(b)r(e)h(pro)r(cessed.)35
b(The)26 b(n)n(umerical)f(t)n(yp)r(e)i(of)f(this)g(arra)n(y)427
-4207 y(should)g(matc)n(h)h(the)f(1-)g(or)g(2-c)n(haracter)d(t)n(yp)r(e)
+5276 y(should)g(matc)n(h)h(the)f(1-)g(or)g(2-c)n(haracter)d(t)n(yp)r(e)
k(co)r(de)f(app)r(ended)h(to)f(the)h(function)g(name)f(\(e.g.)36
-b(if)27 b(y)n(ou)f(are)427 4307 y(using)i(AST)p Ft(_)p
+b(if)27 b(y)n(ou)f(are)427 5376 y(using)i(AST)p Ft(_)p
Fj(OUTLINER,)f(the)h(t)n(yp)r(e)g(of)f(eac)n(h)g(arra)n(y)e(elemen)n(t)
-j(should)f(b)r(e)h(REAL\).)427 4422 y(The)33 b(storage)f(order)f(of)j
+j(should)f(b)r(e)h(REAL\).)427 5494 y(The)33 b(storage)f(order)f(of)j
(data)e(within)i(this)g(arra)n(y)c(should)j(b)r(e)h(suc)n(h)f(that)g
-(the)h(index)f(of)g(the)g(\014rst)g(grid)427 4521 y(dimension)h(v)-5
+(the)h(index)f(of)g(the)g(\014rst)g(grid)427 5593 y(dimension)h(v)-5
b(aries)33 b(most)g(rapidly)g(and)h(that)g(of)g(the)g(second)f
(dimension)h(least)f(rapidly)g(\(i.e.)56 b(normal)427
-4621 y(F)-7 b(ortran)27 b(arra)n(y)e(storage)h(order\).)259
-4751 y Fc(LBND\()32 b(2)g(\))g(=)g(INTEGER)f(\(Giv)m(en\))427
-4850 y Fj(An)j(arra)n(y)d(con)n(taining)h(the)i(co)r(ordinates)e(of)h
-(the)h(cen)n(tre)f(of)g(the)g(\014rst)h(pixel)f(in)g(the)h(input)g
-(grid)f(along)427 4950 y(eac)n(h)27 b(dimension.)259
-5080 y Fc(UBND\()32 b(2\))g(=)g(INTEGER)f(\(Giv)m(en\))427
-5180 y Fj(An)k(arra)n(y)d(con)n(taining)h(the)h(co)r(ordinates)f(of)h
-(the)h(cen)n(tre)f(of)g(the)g(last)g(pixel)g(in)h(the)f(input)h(grid)f
-(along)427 5279 y(eac)n(h)27 b(dimension.)427 5394 y(Note)i(that)g
-(LBND)g(and)f(UBND)h(together)f(de\014ne)h(the)f(shap)r(e)h(and)f(size)
-g(of)h(the)g(input)g(grid,)f(its)h(exten)n(t)427 5494
-y(along)24 b(a)h(particular)f(\(J'th\))j(dimension)e(b)r(eing)g
+5693 y(F)-7 b(ortran)27 b(arra)n(y)e(storage)h(order\).)p
+eop end
+%%Page: 304 314
+TeXDict begin 304 313 bop 0 52 a FG(304)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(LBND\()h(2)g(\))g(=)g
+(INTEGER)f(\(Giv)m(en\))427 451 y Fj(An)j(arra)n(y)d(con)n(taining)h
+(the)i(co)r(ordinates)e(of)h(the)h(cen)n(tre)f(of)g(the)g(\014rst)h
+(pixel)f(in)g(the)h(input)g(grid)f(along)427 551 y(eac)n(h)27
+b(dimension.)259 696 y Fc(UBND\()32 b(2\))g(=)g(INTEGER)f(\(Giv)m(en\))
+427 796 y Fj(An)k(arra)n(y)d(con)n(taining)h(the)h(co)r(ordinates)f(of)
+h(the)h(cen)n(tre)f(of)g(the)g(last)g(pixel)g(in)h(the)f(input)h(grid)f
+(along)427 895 y(eac)n(h)27 b(dimension.)427 1018 y(Note)i(that)g(LBND)
+g(and)f(UBND)h(together)f(de\014ne)h(the)f(shap)r(e)h(and)f(size)g(of)h
+(the)g(input)g(grid,)f(its)h(exten)n(t)427 1118 y(along)24
+b(a)h(particular)f(\(J'th\))j(dimension)e(b)r(eing)g
(UBND\(J\)-LBND\(J\)+1.)37 b(They)25 b(also)f(de\014ne)i(the)g(input)
-427 5593 y(grid's)33 b(co)r(ordinate)f(system,)i(eac)n(h)f(pixel)g(ha)n
+427 1217 y(grid's)33 b(co)r(ordinate)f(system,)i(eac)n(h)f(pixel)g(ha)n
(ving)g(unit)h(exten)n(t)f(along)f(eac)n(h)h(dimension)g(with)h(in)n
-(tegral)427 5693 y(co)r(ordinate)27 b(v)-5 b(alues)27
+(tegral)427 1317 y(co)r(ordinate)27 b(v)-5 b(alues)27
b(at)g(its)h(cen)n(tre)f(or)g(upp)r(er)h(corner,)e(as)h(selected)g(b)n
-(y)h(parameter)e(ST)-7 b(ARPIX.)p eop end
-%%Page: 302 312
-TeXDict begin 302 311 bop 0 52 a FG(302)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(MAXERR)g(=)h(DOUBLE)g
-(PRECISION)f(\(Giv)m(en\))427 451 y Fj(T)-7 b(ogether)28
-b(with)h(MAXVER)-7 b(T,)30 b(this)f(determines)g(ho)n(w)f(accurately)g
-(the)h(returned)f(P)n(olygon)f(represen)n(ts)427 551
-y(the)32 b(required)e(region)h(of)g(the)h(data)f(arra)n(y)-7
+(y)h(parameter)e(ST)-7 b(ARPIX.)259 1462 y Fc(MAXERR)31
+b(=)h(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427 1562 y Fj(T)-7
+b(ogether)28 b(with)h(MAXVER)-7 b(T,)30 b(this)f(determines)g(ho)n(w)f
+(accurately)g(the)h(returned)f(P)n(olygon)f(represen)n(ts)427
+1662 y(the)32 b(required)e(region)h(of)g(the)h(data)f(arra)n(y)-7
b(.)46 b(It)31 b(giv)n(es)f(the)i(target)f(discrepancy)f(b)r(et)n(w)n
-(een)h(the)h(returned)427 650 y(P)n(olygon)23 b(and)h(the)h(accurate)e
+(een)h(the)h(returned)427 1761 y(P)n(olygon)23 b(and)h(the)h(accurate)e
(outline)h(in)h(the)g(data)f(arra)n(y)-7 b(,)23 b(expressed)g(as)h(a)g
-(n)n(um)n(b)r(er)g(of)g(pixels.)36 b(Insignif-)427 750
+(n)n(um)n(b)r(er)g(of)g(pixels.)36 b(Insignif-)427 1861
y(ican)n(t)24 b(v)n(ertices)g(are)f(remo)n(v)n(ed)g(from)h(the)h
(accurate)f(outline,)h(one)f(b)n(y)g(one,)h(un)n(til)g(the)g(n)n(um)n
-(b)r(er)f(of)h(v)n(ertices)427 849 y(remaining)c(in)i(the)f(returned)g
+(b)r(er)f(of)h(v)n(ertices)427 1960 y(remaining)c(in)i(the)f(returned)g
(P)n(olygon)d(equals)j(MAXVER)-7 b(T,)22 b(or)f(the)i(largest)d
-(discrepancy)h(b)r(et)n(w)n(een)h(the)427 949 y(accurate)i(outline)i
+(discrepancy)h(b)r(et)n(w)n(een)h(the)427 2060 y(accurate)i(outline)i
(and)f(the)h(returned)f(P)n(olygon)e(is)j(greater)d(than)j(MAXERR.)g
-(If)g(MAXERR)g(is)f(zero)f(or)427 1049 y(less,)k(its)h(v)-5
+(If)g(MAXERR)g(is)f(zero)f(or)427 2160 y(less,)k(its)h(v)-5
b(alue)28 b(is)g(ignored)f(and)h(the)h(returned)f(P)n(olygon)e(will)i
(ha)n(v)n(e)f(the)i(n)n(um)n(b)r(er)f(of)g(v)n(ertices)f(sp)r
-(eci\014ed)427 1148 y(b)n(y)h(MAXVER)-7 b(T.)259 1282
-y Fc(MAXVER)f(T)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 1382
+(eci\014ed)427 2259 y(b)n(y)h(MAXVER)-7 b(T.)259 2405
+y Fc(MAXVER)f(T)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 2504
y Fj(T)-7 b(ogether)33 b(with)i(MAXERR,)g(this)g(determines)f(ho)n(w)f
(accurately)g(the)i(returned)f(P)n(olygon)e(represen)n(ts)427
-1482 y(the)24 b(required)f(region)f(of)h(the)h(data)f(arra)n(y)-7
+2604 y(the)24 b(required)f(region)f(of)h(the)h(data)f(arra)n(y)-7
b(.)33 b(It)24 b(giv)n(es)e(the)i(maxim)n(um)f(allo)n(w)n(ed)g(n)n(um)n
-(b)r(er)g(of)g(v)n(ertices)f(in)i(the)427 1581 y(returned)30
+(b)r(er)g(of)g(v)n(ertices)f(in)i(the)427 2704 y(returned)30
b(P)n(olygon.)42 b(Insigni\014can)n(t)30 b(v)n(ertices)f(are)g(remo)n
(v)n(ed)g(from)h(the)g(accurate)f(outline,)i(one)f(b)n(y)g(one,)427
-1681 y(un)n(til)k(the)g(n)n(um)n(b)r(er)g(of)f(v)n(ertices)g(remaining)
+2803 y(un)n(til)k(the)g(n)n(um)n(b)r(er)g(of)f(v)n(ertices)g(remaining)
g(in)h(the)g(returned)f(P)n(olygon)e(equals)i(MAXVER)-7
-b(T,)34 b(or)f(the)427 1780 y(largest)f(discrepancy)g(b)r(et)n(w)n(een)
+b(T,)34 b(or)f(the)427 2903 y(largest)f(discrepancy)g(b)r(et)n(w)n(een)
i(the)f(accurate)f(outline)i(and)f(the)h(returned)f(P)n(olygon)e(is)i
-(greater)e(than)427 1880 y(MAXERR.)i(If)g(MAXVER)-7 b(T)33
+(greater)e(than)427 3003 y(MAXERR.)i(If)g(MAXVER)-7 b(T)33
b(is)f(less)f(than)i(3,)g(its)f(v)-5 b(alue)32 b(is)g(ignored)f(and)h
-(the)h(n)n(um)n(b)r(er)f(of)g(v)n(ertices)f(in)427 1980
+(the)h(n)n(um)n(b)r(er)f(of)g(v)n(ertices)f(in)427 3102
y(the)i(returned)f(P)n(olygon)f(will)i(b)r(e)g(the)g(minim)n(um)g
(needed)g(to)f(ensure)g(that)h(the)g(discrepancy)f(b)r(et)n(w)n(een)427
-2079 y(the)c(accurate)f(outline)g(and)h(the)g(returned)f(P)n(olygon)e
-(is)j(less)f(than)h(MAXERR.)259 2213 y Fc(INSIDE\()k(2)g(\))g(=)g
-(INTEGER)f(\(Giv)m(en\))427 2313 y Fj(An)40 b(arra)n(y)c(con)n(taining)
+3202 y(the)c(accurate)f(outline)g(and)h(the)g(returned)f(P)n(olygon)e
+(is)j(less)f(than)h(MAXERR.)259 3347 y Fc(INSIDE\()k(2)g(\))g(=)g
+(INTEGER)f(\(Giv)m(en\))427 3447 y Fj(An)40 b(arra)n(y)c(con)n(taining)
i(the)h(indices)g(of)f(a)h(pixel)g(kno)n(wn)f(to)g(b)r(e)i(inside)e
-(the)i(required)d(region.)70 b(This)427 2413 y(is)33
+(the)i(required)d(region.)70 b(This)427 3547 y(is)33
b(needed)g(b)r(ecause)f(the)i(supplied)f(data)f(arra)n(y)f(ma)n(y)h
(con)n(tain)g(sev)n(eral)f(disjoin)n(t)i(areas)e(of)i(pixels)f(that)427
-2512 y(satisfy)25 b(the)g(criterion)f(sp)r(eci\014ed)h(b)n(y)f(V)-9
+3646 y(satisfy)25 b(the)g(criterion)f(sp)r(eci\014ed)h(b)n(y)f(V)-9
b(ALUE)25 b(and)g(OPER.)f(In)h(suc)n(h)f(cases,)g(the)i(area)d(describ)
-r(ed)i(b)n(y)f(the)427 2612 y(returned)h(P)n(olygon)d(will)j(b)r(e)h
+r(ed)i(b)n(y)f(the)427 3746 y(returned)h(P)n(olygon)d(will)j(b)r(e)h
(the)f(one)g(that)g(con)n(tains)f(the)h(pixel)g(sp)r(eci\014ed)g(b)n(y)
-f(INSIDE.)i(If)f(the)g(sp)r(eci\014ed)427 2711 y(pixel)f(is)f(outside)h
+f(INSIDE.)i(If)f(the)g(sp)r(eci\014ed)427 3846 y(pixel)f(is)f(outside)h
(the)g(b)r(ounds)g(giv)n(en)e(b)n(y)i(LBND)g(and)f(UBND,)i(or)e(has)g
(a)g(v)-5 b(alue)23 b(that)h(do)r(es)g(not)f(meet)h(the)427
-2811 y(criterion)k(sp)r(eci\014ed)h(b)n(y)g(V)-9 b(ALUE)29
+3945 y(criterion)k(sp)r(eci\014ed)h(b)n(y)g(V)-9 b(ALUE)29
b(and)g(OPER,)e(then)j(this)f(function)g(will)g(searc)n(h)f(for)g(a)h
-(suitable)g(pixel.)427 2911 y(The)h(searc)n(h)d(starts)i(at)g(the)h
+(suitable)g(pixel.)427 4045 y(The)h(searc)n(h)d(starts)i(at)g(the)h
(cen)n(tral)e(pixel)i(and)f(pro)r(ceeds)f(in)i(a)f(spiral)f(manner)h
-(un)n(til)h(a)f(pixel)g(is)g(found)427 3010 y(that)f(meets)g(the)g(sp)r
-(eci\014ed)g(crierion.)259 3144 y Fc(ST)-8 b(ARPIX)33
-b(=)f(LOGICAL)h(\(Giv)m(en\))427 3244 y Fj(A)19 b(\015ag)f(indicating)g
+(un)n(til)h(a)f(pixel)g(is)g(found)427 4144 y(that)f(meets)g(the)g(sp)r
+(eci\014ed)g(crierion.)259 4290 y Fc(ST)-8 b(ARPIX)33
+b(=)f(LOGICAL)h(\(Giv)m(en\))427 4390 y Fj(A)19 b(\015ag)f(indicating)g
(the)h(nature)e(of)i(the)g(pixel)f(co)r(ordinate)f(system)h(used)h(to)f
-(describ)r(e)g(the)h(v)n(ertex)e(p)r(ositions)427 3344
+(describ)r(e)g(the)h(v)n(ertex)e(p)r(ositions)427 4489
y(in)33 b(the)g(returned)e(P)n(olygon.)49 b(If)33 b(.TR)n(UE.,)g(the)g
(standard)e(Starlink)h(de\014nition)h(of)f(pixel)h(co)r(ordinate)e(is)
-427 3443 y(used)23 b(in)f(whic)n(h)h(a)f(pixel)g(with)h(in)n(teger)f
+427 4589 y(used)23 b(in)f(whic)n(h)h(a)f(pixel)g(with)h(in)n(teger)f
(index)g(I)h(spans)f(a)g(range)f(of)h(pixel)h(co)r(ordinate)e(from)h
-(\(I-1\))g(to)h(I)f(\(i.e.)427 3543 y(pixel)30 b(corners)f(ha)n(v)n(e)g
+(\(I-1\))g(to)h(I)f(\(i.e.)427 4688 y(pixel)30 b(corners)f(ha)n(v)n(e)g
(in)n(tegral)f(pixel)i(co)r(ordinates\).)44 b(If)30 b(.F)-9
b(ALSE.,)31 b(the)f(de\014nition)h(of)f(pixel)g(co)r(ordinate)427
-3642 y(used)f(b)n(y)g(other)g(AST)g(functions)h(suc)n(h)e(as)h(AST)p
+4788 y(used)f(b)n(y)g(other)g(AST)g(functions)h(suc)n(h)e(as)h(AST)p
Ft(_)p Fj(RESAMPLE,)f(AST)p Ft(_)p Fj(MASK,)h(etc.,)h(is)f(used.)41
-b(In)29 b(this)427 3742 y(de\014nition,)23 b(a)e(pixel)g(with)h(in)n
+b(In)29 b(this)427 4888 y(de\014nition,)23 b(a)e(pixel)g(with)h(in)n
(teger)f(index)g(I)g(spans)g(a)g(range)f(of)h(pixel)g(co)r(ordinate)g
-(from)f(\(I-0.5\))h(to)g(\(I+0.5\))427 3842 y(\(i.e.)38
+(from)f(\(I-0.5\))h(to)g(\(I+0.5\))427 4987 y(\(i.e.)38
b(pixel)27 b(cen)n(tres)g(ha)n(v)n(e)f(in)n(tegral)h(pixel)g(co)r
-(ordinates\).)259 3976 y Fc(BO)m(XSIZE)32 b(=)g(INTEGER)g(\(Giv)m(en\))
-427 4075 y Fj(The)38 b(full)g(width)g(in)g(pixels)f(of)h(a)f(smo)r
+(ordinates\).)259 5133 y Fc(BO)m(XSIZE)32 b(=)g(INTEGER)g(\(Giv)m(en\))
+427 5232 y Fj(The)38 b(full)g(width)g(in)g(pixels)f(of)h(a)f(smo)r
(othing)g(b)r(o)n(x)g(to)g(b)r(e)h(applied)g(to)f(the)h(p)r(olygon)e(v)
-n(ertices)h(b)r(efore)427 4175 y(do)n(wnsizing)29 b(the)i(p)r(olygon)e
+n(ertices)h(b)r(efore)427 5332 y(do)n(wnsizing)29 b(the)i(p)r(olygon)e
(to)i(a)f(smaller)f(n)n(um)n(b)r(er)h(of)g(v)n(ertices.)44
b(If)31 b(an)f(ev)n(en)g(n)n(um)n(b)r(er)g(is)g(supplied,)h(the)427
-4275 y(next)d(larger)e(o)r(dd)i(n)n(um)n(b)r(er)f(is)g(used.)37
+5432 y(next)d(larger)e(o)r(dd)i(n)n(um)n(b)r(er)f(is)g(used.)37
b(V)-7 b(alues)28 b(of)f(one)g(or)g(zero)g(result)g(in)h(no)f(smo)r
-(othing.)259 4409 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h
-(and)g(Returned\))427 4508 y Fj(The)c(global)e(status.)0
-4672 y Fc(Returned)32 b(V)-8 b(alue:)259 4811 y(AST)p
-Ft(_)p Fc(OUTLINE)p Fl(<)p Fc(X)p Fl(>)32 b Fc(=)g(INTEGER)427
-4911 y Fj(The)c(n)n(um)n(b)r(er)f(of)h(pixels)f(to)h(whic)n(h)f(a)g(v)
--5 b(alue)28 b(of)f(BAD)n(V)-9 b(AL)28 b(has)g(b)r(een)g(assigned.)0
-5075 y Fc(Notes:)340 5360 y Fi(\017)45 b Fj(This)27 b(function)h(pro)r
-(ceeds)e(b)n(y)h(\014rst)g(\014nding)g(a)g(v)n(ery)f(accurate)g(p)r
-(olygon,)g(and)h(then)h(remo)n(ving)d(insigni\014-)427
-5459 y(can)n(t)i(v)n(ertices)g(from)g(this)h(\014ne)g(p)r(olygon)f
-(using)g(AST)p Ft(_)p Fj(DO)n(WNSIZE.)340 5593 y Fi(\017)45
-b Fj(The)27 b(returned)g(P)n(olygon)d(is)j(the)h(outer)e(b)r(oundary)g
-(of)h(the)g(con)n(tiguous)f(set)h(of)f(pixels)h(that)g(includes)g(ths)
-427 5693 y(sp)r(eci\014ed)k Ft(")p Fj(inside)p Ft(")f
-Fj(p)r(oin)n(t,)i(and)f(satisfy)f(the)h(sp)r(eci\014ed)g(v)-5
-b(alue)31 b(requiremen)n(t.)46 b(This)30 b(set)h(of)g(pixels)f(ma)n(y)p
+(othing.)259 5577 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h
+(and)g(Returned\))427 5677 y Fj(The)c(global)e(status.)p
eop end
-%%Page: 303 313
-TeXDict begin 303 312 bop 3643 52 a FG(303)427 351 y
-Fj(p)r(oten)n(tially)22 b(include)h Ft(")p Fj(holes)p
-Ft(")d Fj(where)i(the)g(pixel)g(v)-5 b(alues)22 b(fail)g(to)g(meet)h
-(the)f(sp)r(eci\014ed)g(v)-5 b(alue)22 b(requiremen)n(t.)427
-451 y(Suc)n(h)28 b(holes)f(will)h(b)r(e)g(ignored)e(b)n(y)h(this)h
-(function.)340 583 y Fi(\017)45 b Fj(A)27 b(v)-5 b(alue)25
-b(of)h(zero)f(will)h(b)r(e)g(returned)g(if)g(this)g(function)h(is)f(in)
-n(v)n(ok)n(ed)e(with)j(the)f(global)f(error)f(status)h(set,)h(or)427
-682 y(if)i(it)g(should)g(fail)f(for)h(an)n(y)e(reason.)-2
-843 y Fc(Data)33 b(T)m(yp)s(e)g(Co)s(des)n(:)227 990
-y Fj(T)-7 b(o)26 b(select)g(the)g(appropriate)e(masking)h(function,)i
-(y)n(ou)e(should)h(replace)f Fl(<)p Fj(X)p Fl(>)h Fj(in)g(the)g
-(generic)f(function)i(name)227 1089 y(AST)p Ft(_)p Fj(OUTLINE)p
-Fl(<)p Fj(X)p Fl(>)h Fj(with)h(a)f(1-)g(or)g(2-c)n(haracter)d(data)j(t)
-n(yp)r(e)h(co)r(de,)g(so)f(as)g(to)g(matc)n(h)h(the)g(n)n(umerical)e(t)
-n(yp)r(e)227 1189 y Fl(<)p Fj(Xt)n(yp)r(e)p Fl(>)g Fj(of)h(the)g(data)f
-(y)n(ou)g(are)g(pro)r(cessing,)f(as)h(follo)n(ws:)340
-1324 y Fi(\017)45 b Fj(D:)28 b(DOUBLE)g(PRECISION)340
-1456 y Fi(\017)45 b Fj(R:)28 b(REAL)340 1588 y Fi(\017)45
-b Fj(I:)28 b(INTEGER)340 1720 y Fi(\017)45 b Fj(UI:)28
-b(INTEGER)f(\(treated)h(as)f(unsigned\))340 1852 y Fi(\017)45
-b Fj(S:)28 b(INTEGER)p Fi(\003)p Fj(2)e(\(short)h(in)n(teger\))340
-1984 y Fi(\017)45 b Fj(US:)28 b(INTEGER)p Fi(\003)p Fj(2)f(\(short)g
-(in)n(teger,)f(treated)i(as)f(unsigned\))340 2116 y Fi(\017)45
-b Fj(B:)28 b(BYTE)f(\(treated)h(as)e(signed\))340 2248
-y Fi(\017)45 b Fj(UB:)28 b(BYTE)f(\(treated)h(as)f(unsigned\))227
-2409 y(F)-7 b(or)40 b(example,)j(AST)p Ft(_)p Fj(OUTLINED)e(w)n(ould)f
-(b)r(e)h(used)f(to)g(pro)r(cess)g(DOUBLE)g(PRECISION)f(data,)k(while)
-227 2509 y(AST)p Ft(_)p Fj(OUTLINES)29 b(w)n(ould)h(b)r(e)f(used)h(to)f
-(pro)r(cess)g(short)g(in)n(teger)f(data)h(\(stored)g(in)h(an)f(INTEGER)
-p Fi(\003)p Fj(2)g(arra)n(y\),)227 2608 y(etc.)227 2732
+%%Page: 305 315
+TeXDict begin 305 314 bop 3643 52 a FG(305)0 351 y Fc(Returned)32
+b(V)-8 b(alue:)259 491 y(AST)p Ft(_)p Fc(OUTLINE)p Fl(<)p
+Fc(X)p Fl(>)32 b Fc(=)g(INTEGER)427 591 y Fj(The)c(n)n(um)n(b)r(er)f
+(of)h(pixels)f(to)h(whic)n(h)f(a)g(v)-5 b(alue)28 b(of)f(BAD)n(V)-9
+b(AL)28 b(has)g(b)r(een)g(assigned.)0 757 y Fc(Notes:)340
+1043 y Fi(\017)45 b Fj(This)27 b(function)h(pro)r(ceeds)e(b)n(y)h
+(\014rst)g(\014nding)g(a)g(v)n(ery)f(accurate)g(p)r(olygon,)g(and)h
+(then)h(remo)n(ving)d(insigni\014-)427 1142 y(can)n(t)i(v)n(ertices)g
+(from)g(this)h(\014ne)g(p)r(olygon)f(using)g(AST)p Ft(_)p
+Fj(DO)n(WNSIZE.)340 1277 y Fi(\017)45 b Fj(The)27 b(returned)g(P)n
+(olygon)d(is)j(the)h(outer)e(b)r(oundary)g(of)h(the)g(con)n(tiguous)f
+(set)h(of)f(pixels)h(that)g(includes)g(ths)427 1377 y(sp)r(eci\014ed)k
+Ft(")p Fj(inside)p Ft(")f Fj(p)r(oin)n(t,)i(and)f(satisfy)f(the)h(sp)r
+(eci\014ed)g(v)-5 b(alue)31 b(requiremen)n(t.)46 b(This)30
+b(set)h(of)g(pixels)f(ma)n(y)427 1476 y(p)r(oten)n(tially)22
+b(include)h Ft(")p Fj(holes)p Ft(")d Fj(where)i(the)g(pixel)g(v)-5
+b(alues)22 b(fail)g(to)g(meet)h(the)f(sp)r(eci\014ed)g(v)-5
+b(alue)22 b(requiremen)n(t.)427 1576 y(Suc)n(h)28 b(holes)f(will)h(b)r
+(e)g(ignored)e(b)n(y)h(this)h(function.)340 1711 y Fi(\017)45
+b Fj(A)27 b(v)-5 b(alue)25 b(of)h(zero)f(will)h(b)r(e)g(returned)g(if)g
+(this)g(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(the)f(global)f(error)
+f(status)h(set,)h(or)427 1810 y(if)i(it)g(should)g(fail)f(for)h(an)n(y)
+e(reason.)-2 1976 y Fc(Data)33 b(T)m(yp)s(e)g(Co)s(des)n(:)227
+2122 y Fj(T)-7 b(o)26 b(select)g(the)g(appropriate)e(masking)h
+(function,)i(y)n(ou)e(should)h(replace)f Fl(<)p Fj(X)p
+Fl(>)h Fj(in)g(the)g(generic)f(function)i(name)227 2222
+y(AST)p Ft(_)p Fj(OUTLINE)p Fl(<)p Fj(X)p Fl(>)h Fj(with)h(a)f(1-)g(or)
+g(2-c)n(haracter)d(data)j(t)n(yp)r(e)h(co)r(de,)g(so)f(as)g(to)g(matc)n
+(h)h(the)g(n)n(umerical)e(t)n(yp)r(e)227 2321 y Fl(<)p
+Fj(Xt)n(yp)r(e)p Fl(>)g Fj(of)h(the)g(data)f(y)n(ou)g(are)g(pro)r
+(cessing,)f(as)h(follo)n(ws:)340 2461 y Fi(\017)45 b
+Fj(D:)28 b(DOUBLE)g(PRECISION)340 2596 y Fi(\017)45 b
+Fj(R:)28 b(REAL)340 2731 y Fi(\017)45 b Fj(I:)28 b(INTEGER)340
+2866 y Fi(\017)45 b Fj(UI:)28 b(INTEGER)f(\(treated)h(as)f(unsigned\))
+340 3000 y Fi(\017)45 b Fj(S:)28 b(INTEGER)p Fi(\003)p
+Fj(2)e(\(short)h(in)n(teger\))340 3135 y Fi(\017)45 b
+Fj(US:)28 b(INTEGER)p Fi(\003)p Fj(2)f(\(short)g(in)n(teger,)f(treated)
+i(as)f(unsigned\))340 3270 y Fi(\017)45 b Fj(B:)28 b(BYTE)f(\(treated)h
+(as)e(signed\))340 3404 y Fi(\017)45 b Fj(UB:)28 b(BYTE)f(\(treated)h
+(as)f(unsigned\))227 3570 y(F)-7 b(or)40 b(example,)j(AST)p
+Ft(_)p Fj(OUTLINED)e(w)n(ould)f(b)r(e)h(used)f(to)g(pro)r(cess)g
+(DOUBLE)g(PRECISION)f(data,)k(while)227 3670 y(AST)p
+Ft(_)p Fj(OUTLINES)29 b(w)n(ould)h(b)r(e)f(used)h(to)f(pro)r(cess)g
+(short)g(in)n(teger)f(data)h(\(stored)g(in)h(an)f(INTEGER)p
+Fi(\003)p Fj(2)g(arra)n(y\),)227 3769 y(etc.)227 3896
y(F)-7 b(or)32 b(compatibilit)n(y)h(with)g(other)f(Starlink)g
(facilities,)i(the)f(co)r(des)g(W)g(and)f(UW)h(are)f(pro)n(vided)g(as)g
-(synon)n(yms)227 2832 y(for)27 b(S)h(and)g(US)g(resp)r(ectiv)n(ely)e
+(synon)n(yms)227 3995 y(for)27 b(S)h(and)g(US)g(resp)r(ectiv)n(ely)e
(\(but)j(only)e(in)h(the)g(F)-7 b(ortran)26 b(in)n(terface)h(to)h
-(AST\).)p 0 3030 3780 12 v 0 3160 a FA(AST)p Fe(_)p FA(O)l(VERLAP)1214
-3161 y Fd(T)-10 b(est)39 b(if)f(t)m(w)m(o)f(regions)h(o)m(v)m(erlap)
-1625 3276 y(eac)m(h)g(other)2787 3160 y FA(AST)p Fe(_)p
-FA(O)l(VERLAP)0 3440 y Fc(Description:)44 b Fj(This)39
+(AST\).)p 0 4198 3780 12 v 0 4329 a FA(AST)p Fe(_)p FA(O)l(VERLAP)1214
+4330 y Fd(T)-10 b(est)39 b(if)f(t)m(w)m(o)f(regions)h(o)m(v)m(erlap)
+1625 4444 y(eac)m(h)g(other)2787 4329 y FA(AST)p Fe(_)p
+FA(O)l(VERLAP)0 4614 y Fc(Description:)44 b Fj(This)39
b(function)h(returns)e(an)g(in)n(teger)g(v)-5 b(alue)39
b(indicating)g(if)g(the)g(t)n(w)n(o)g(supplied)g(Regions)f(o)n(v)n
-(erlap.)227 3539 y(The)30 b(t)n(w)n(o)g(Regions)f(are)g(con)n(v)n
+(erlap.)227 4713 y(The)30 b(t)n(w)n(o)g(Regions)f(are)g(con)n(v)n
(erted)f(to)i(a)g(commnon)f(co)r(ordinate)g(system)h(b)r(efore)f(p)r
-(erforming)h(the)g(c)n(hec)n(k.)43 b(If)227 3639 y(this)33
+(erforming)h(the)g(c)n(hec)n(k.)43 b(If)227 4813 y(this)33
b(con)n(v)n(ersion)e(is)i(not)g(p)r(ossible)f(\(for)h(instance)g(b)r
(ecause)f(the)h(t)n(w)n(o)g(Regions)e(represen)n(t)h(areas)f(in)i
-(di\013eren)n(t)227 3739 y(domains\),)28 b(then)g(the)g(c)n(hec)n(k)e
+(di\013eren)n(t)227 4913 y(domains\),)28 b(then)g(the)g(c)n(hec)n(k)e
(cannot)h(b)r(e)h(p)r(erformed)g(and)f(a)g(zero)g(v)-5
-b(alue)27 b(is)h(returned)f(to)g(indicate)h(this.)0 3887
+b(alue)27 b(is)h(returned)f(to)g(indicate)h(this.)0 5066
y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_OVERLAP\()c
-(THIS,)i(THAT,)h(STATUS)f(\))0 4036 y Fc(Argumen)m(ts:)259
-4171 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 4271
+(THIS,)i(THAT,)h(STATUS)f(\))0 5219 y Fc(Argumen)m(ts:)259
+5359 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 5459
y Fj(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f(Region.)259
-4403 y Fc(THA)-8 b(T)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
-4502 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(second)f(Region.)259
-4634 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 4734 y Fj(The)c(global)e(status.)0 4895
-y Fc(Returned)32 b(V)-8 b(alue:)259 5031 y(AST)p Ft(_)p
-Fc(O)m(VERLAP)33 b(=)f(INTEGER)427 5130 y Fj(A)c(v)-5
-b(alue)28 b(indicating)f(if)h(there)g(is)f(an)n(y)g(o)n(v)n(erlap)e(b)r
-(et)n(w)n(een)j(the)g(t)n(w)n(o)f(Regions.)36 b(P)n(ossible)26
-b(v)-5 b(alues)27 b(are:)427 5246 y(0)i(-)f(The)h(c)n(hec)n(k)f(could)h
-(not)g(b)r(e)g(p)r(erformed)f(b)r(ecause)g(the)i(second)e(Region)g
-(could)h(not)f(b)r(e)i(mapp)r(ed)f(in)n(to)427 5346 y(the)f(co)r
-(ordinate)f(system)g(of)h(the)g(\014rst)f(Region.)427
-5461 y(1)g(-)h(There)f(is)g(no)h(o)n(v)n(erlap)d(b)r(et)n(w)n(een)j
-(the)g(t)n(w)n(o)f(Regions.)427 5577 y(2)g(-)h(The)f(\014rst)h(Region)f
-(is)g(completely)h(inside)f(the)h(second)f(Region.)427
-5693 y(3)g(-)h(The)f(second)g(Region)g(is)h(completely)f(inside)h(the)g
-(\014rst)f(Region.)p eop end
-%%Page: 304 314
-TeXDict begin 304 313 bop 0 52 a FG(304)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(4)c(-)h(There)f(is)g
-(partial)g(o)n(v)n(erlap)f(b)r(et)n(w)n(een)h(the)h(t)n(w)n(o)f
-(Regions.)427 467 y(5)g(-)h(The)f(Regions)g(are)g(iden)n(tical)g(to)h
-(within)g(their)f(uncertain)n(ties.)427 582 y(6)e(-)g(The)g(second)g
-(Region)f(is)h(the)h(exact)e(negation)g(of)h(the)h(\014rst)f(Region)f
-(to)h(within)h(their)f(uncertain)n(ties.)0 742 y Fc(Notes:)340
-1023 y Fi(\017)45 b Fj(The)22 b(returned)f(v)-5 b(alues)22
+5593 y Fc(THA)-8 b(T)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
+5693 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(second)f(Region.)p
+eop end
+%%Page: 306 316
+TeXDict begin 306 315 bop 0 52 a FG(306)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(ST)-8
+b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+451 y Fj(The)c(global)e(status.)0 616 y Fc(Returned)32
+b(V)-8 b(alue:)259 755 y(AST)p Ft(_)p Fc(O)m(VERLAP)33
+b(=)f(INTEGER)427 855 y Fj(A)c(v)-5 b(alue)28 b(indicating)f(if)h
+(there)g(is)f(an)n(y)g(o)n(v)n(erlap)e(b)r(et)n(w)n(een)j(the)g(t)n(w)n
+(o)f(Regions.)36 b(P)n(ossible)26 b(v)-5 b(alues)27 b(are:)427
+972 y(0)i(-)f(The)h(c)n(hec)n(k)f(could)h(not)g(b)r(e)g(p)r(erformed)f
+(b)r(ecause)g(the)i(second)e(Region)g(could)h(not)f(b)r(e)i(mapp)r(ed)f
+(in)n(to)427 1071 y(the)f(co)r(ordinate)f(system)g(of)h(the)g(\014rst)f
+(Region.)427 1188 y(1)g(-)h(There)f(is)g(no)h(o)n(v)n(erlap)d(b)r(et)n
+(w)n(een)j(the)g(t)n(w)n(o)f(Regions.)427 1305 y(2)g(-)h(The)f(\014rst)
+h(Region)f(is)g(completely)h(inside)f(the)h(second)f(Region.)427
+1422 y(3)g(-)h(The)f(second)g(Region)g(is)h(completely)f(inside)h(the)g
+(\014rst)f(Region.)427 1539 y(4)g(-)h(There)f(is)g(partial)g(o)n(v)n
+(erlap)f(b)r(et)n(w)n(een)h(the)h(t)n(w)n(o)f(Regions.)427
+1656 y(5)g(-)h(The)f(Regions)g(are)g(iden)n(tical)g(to)h(within)g
+(their)f(uncertain)n(ties.)427 1773 y(6)e(-)g(The)g(second)g(Region)f
+(is)h(the)h(exact)e(negation)g(of)h(the)h(\014rst)f(Region)f(to)h
+(within)h(their)f(uncertain)n(ties.)0 1938 y Fc(Notes:)340
+2224 y Fi(\017)45 b Fj(The)22 b(returned)f(v)-5 b(alues)22
b(5)f(and)h(6)f(do)g(not)h(c)n(hec)n(k)f(the)h(v)-5 b(alue)22
b(of)f(the)h(Closed)g(attribute)f(in)h(the)h(t)n(w)n(o)d(Regions.)340
-1154 y Fi(\017)45 b Fj(A)29 b(v)-5 b(alue)29 b(of)f(zero)g(will)h(b)r
+2358 y Fi(\017)45 b Fj(A)29 b(v)-5 b(alue)29 b(of)f(zero)g(will)h(b)r
(e)g(returned)f(if)h(this)g(function)g(is)f(in)n(v)n(ok)n(ed)f(with)j
-(the)f(AST)g(error)d(status)j(set,)f(or)427 1253 y(if)g(it)g(should)g
-(fail)f(for)h(an)n(y)e(reason.)p 0 1449 3780 12 v 0 1580
+(the)f(AST)g(error)d(status)j(set,)f(or)427 2457 y(if)g(it)g(should)g
+(fail)f(for)h(an)n(y)e(reason.)p 0 2660 3780 12 v 0 2790
a FA(AST)p Fe(_)p FA(P)-11 b(ARAMETERNAME)156 b Fd(Get)1808
-1679 y(the)1788 1779 y(name)1843 1878 y(of)1808 1978
-y(the)1788 2078 y(global)1808 2177 y(pa-)1788 2277 y(ram-)1792
-2377 y(eter)1789 2476 y(at)38 b(a)1788 2576 y(giv)m(en)1821
-2687 y(in-)1800 2786 y(dex)1788 2886 y(within)1808 2986
-y(the)1804 3085 y(T)-10 b(a-)1815 3185 y(ble)2143 1580
-y FA(AST)p Fe(_)p FA(P)f(ARAMETERNAME)0 3347 y Fc(Description:)44
+2890 y(the)1788 2989 y(name)1843 3089 y(of)1808 3189
+y(the)1788 3288 y(global)1808 3388 y(pa-)1788 3487 y(ram-)1792
+3587 y(eter)1789 3687 y(at)38 b(a)1788 3786 y(giv)m(en)1821
+3897 y(in-)1800 3997 y(dex)1788 4096 y(within)1808 4196
+y(the)1804 4296 y(T)-10 b(a-)1815 4395 y(ble)2143 2790
+y FA(AST)p Fe(_)p FA(P)f(ARAMETERNAME)0 4564 y Fc(Description:)44
b Fj(This)32 b(function)h(returns)e(a)g(string)h(holding)f(the)i(name)e
(of)h(the)g(global)f(parameter)g(with)h(the)g(giv)n(en)227
-3446 y(index)c(within)g(the)g(T)-7 b(able.)227 3570 y(This)33
+4664 y(index)c(within)g(the)g(T)-7 b(able.)227 4790 y(This)33
b(function)g(is)f(in)n(tended)h(primarily)e(as)h(a)g(means)g(of)h
(iterating)e(round)h(all)g(the)h(parameters)e(in)i(a)f(T)-7
-b(able.)227 3670 y(F)g(or)29 b(this)h(purp)r(ose,)g(the)g(n)n(um)n(b)r
+b(able.)227 4889 y(F)g(or)29 b(this)h(purp)r(ose,)g(the)g(n)n(um)n(b)r
(er)f(of)h(parameters)e(in)h(the)h(T)-7 b(able)30 b(is)f(giv)n(en)g(b)n
-(y)g(the)h(Nparameter)f(attribute)h(of)227 3769 y(the)j(T)-7
+(y)g(the)h(Nparameter)f(attribute)h(of)227 4989 y(the)j(T)-7
b(able.)50 b(This)32 b(function)g(could)g(then)h(b)r(e)f(called)g(in)g
(a)g(lo)r(op,)h(with)f(the)g(index)h(v)-5 b(alue)32 b(going)e(from)i
-(one)g(to)227 3869 y(Nparameter.)227 3993 y(Note,)22
+(one)g(to)227 5088 y(Nparameter.)227 5214 y(Note,)22
b(the)f(index)g(asso)r(ciated)e(with)i(a)g(parameter)e(decreases)g
(monotonically)g(with)i(the)g(age)f(of)g(the)h(parameter:)227
-4092 y(the)28 b(oldest)g(P)n(arameter)d(in)j(the)h(T)-7
+5314 y(the)28 b(oldest)g(P)n(arameter)d(in)j(the)h(T)-7
b(able)27 b(will)h(ha)n(v)n(e)f(index)h(one,)f(and)h(the)g(P)n
-(arameter)d(added)j(most)g(recen)n(tly)f(to)227 4192
+(arameter)d(added)j(most)g(recen)n(tly)f(to)227 5414
y(the)h(T)-7 b(able)28 b(will)f(ha)n(v)n(e)g(the)h(largest)e(index.)0
-4340 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i
+5566 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i
(AST_PARAMETERNAM)o(E\()37 b(THIS,)42 b(INDEX,)f(STATUS)g(\))0
-4487 y Fc(Argumen)m(ts:)259 4622 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 4721 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(T)-7
-b(able.)259 4853 y Fc(INDEX)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
-4952 y Fj(The)h(index)h(in)n(to)f(the)g(list)g(of)h(parameters.)48
-b(The)33 b(\014rst)e(parameter)g(has)h(index)g(one,)h(and)f(the)g(last)
-g(has)427 5052 y(index)c Ft(")p Fj(Nparameter)p Ft(")p
-Fj(.)259 5183 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)
-g(Returned\))427 5282 y Fj(The)c(global)e(status.)0 5443
-y Fc(Returned)32 b(V)-8 b(alue:)259 5577 y(AST)p Ft(_)p
-Fc(P)g(ARAMETERNAME)31 b(=)h(CHARA)m(CTER)f Fi(\003)h
-Fc(\()g(AST)p Ft(__)p Fc(SZCHR)f(\))427 5677 y Fj(The)d(upp)r(er)g
-(case)e(parameter)h(name.)p eop end
-%%Page: 305 315
-TeXDict begin 305 314 bop 3643 52 a FG(305)0 351 y Fc(Notes:)340
-634 y Fi(\017)45 b Fj(A)25 b(blank)f(string)f(will)i(b)r(e)f(returned)g
-(if)h(this)g(function)f(is)g(in)n(v)n(ok)n(ed)f(with)i(ST)-7
+5718 y Fc(Argumen)m(ts:)p eop end
+%%Page: 307 317
+TeXDict begin 307 316 bop 3643 52 a FG(307)259 351 y
+Fc(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(T)-7 b(able.)259 582 y Fc(INDEX)32 b(=)g(INTEGER)f(\(Giv)m
+(en\))427 682 y Fj(The)h(index)h(in)n(to)f(the)g(list)g(of)h
+(parameters.)48 b(The)33 b(\014rst)e(parameter)g(has)h(index)g(one,)h
+(and)f(the)g(last)g(has)427 782 y(index)c Ft(")p Fj(Nparameter)p
+Ft(")p Fj(.)259 913 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)
+h(and)g(Returned\))427 1013 y Fj(The)c(global)e(status.)0
+1173 y Fc(Returned)32 b(V)-8 b(alue:)259 1308 y(AST)p
+Ft(_)p Fc(P)g(ARAMETERNAME)31 b(=)h(CHARA)m(CTER)f Fi(\003)h
+Fc(\()g(AST)p Ft(__)p Fc(SZCHR)f(\))427 1408 y Fj(The)d(upp)r(er)g
+(case)e(parameter)h(name.)0 1568 y Fc(Notes:)340 1849
+y Fi(\017)45 b Fj(A)25 b(blank)f(string)f(will)i(b)r(e)f(returned)g(if)
+h(this)g(function)f(is)g(in)n(v)n(ok)n(ed)f(with)i(ST)-7
b(A)g(TUS)25 b(set)f(to)g(an)g(error)f(v)-5 b(alue,)427
-734 y(or)27 b(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-0 934 3780 12 v 0 1064 a FA(AST)p Fe(_)p FA(PCDMAP)1439
-1065 y Fd(Create)37 b(a)h(PcdMap)2835 1064 y FA(AST)p
-Fe(_)p FA(PCDMAP)0 1255 y Fc(Description:)44 b Fj(This)28
+1949 y(or)27 b(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
+0 2145 3780 12 v 0 2276 a FA(AST)p Fe(_)p FA(PCDMAP)1439
+2277 y Fd(Create)37 b(a)h(PcdMap)2835 2276 y FA(AST)p
+Fe(_)p FA(PCDMAP)0 2463 y Fc(Description:)44 b Fj(This)28
b(function)g(creates)f(a)g(new)g(PcdMap)g(and)h(optionally)e
-(initialises)i(its)g(attributes.)227 1380 y(A)35 b(PcdMap)f(is)g(a)h
+(initialises)i(its)g(attributes.)227 2587 y(A)35 b(PcdMap)f(is)g(a)h
(non-linear)e(Mapping)h(whic)n(h)g(transforms)f(2-dimensional)h(p)r
-(ositions)g(to)g(correct)f(for)h(the)227 1479 y(radial)h(distortion)h
+(ositions)g(to)g(correct)f(for)h(the)227 2686 y(radial)h(distortion)h
(in)n(tro)r(duced)g(b)n(y)g(some)f(cameras)g(and)h(telescop)r(es.)62
b(This)36 b(can)g(tak)n(e)f(the)i(form)f(either)g(of)227
-1579 y(pincushion)28 b(or)f(barrel)f(distortion,)h(and)g(is)h(c)n
+2786 y(pincushion)28 b(or)f(barrel)f(distortion,)h(and)g(is)h(c)n
(haracterized)d(b)n(y)j(a)f(single)g(distortion)g(co)r(e\016cien)n(t.)
-227 1704 y(A)g(PcdMap)f(is)g(sp)r(eci\014ed)h(b)n(y)f(giving)g(this)h
+227 2910 y(A)g(PcdMap)f(is)g(sp)r(eci\014ed)h(b)n(y)f(giving)g(this)h
(distortion)f(co)r(e\016cien)n(t)g(and)g(the)h(co)r(ordinates)e(of)i
-(the)g(cen)n(tre)f(of)g(the)227 1803 y(radial)h(distortion.)36
+(the)g(cen)n(tre)f(of)g(the)227 3009 y(radial)h(distortion.)36
b(The)28 b(forw)n(ard)d(transformation)h(of)i(a)f(PcdMap)g(applies)g
-(the)h(distortion:)227 1928 y(RD)g(=)g(R)g Fi(\003)f
+(the)h(distortion:)227 3133 y(RD)g(=)g(R)g Fi(\003)f
Fj(\()h(1)f(+)g(C)h Fi(\003)f Fj(R)h Fi(\003)f Fj(R)h(\))227
-2053 y(where)h(R)h(is)g(the)g(undistorted)f(radial)g(distance)g(from)h
+3257 y(where)h(R)h(is)g(the)g(undistorted)f(radial)g(distance)g(from)h
(the)g(distortion)f(cen)n(tre)g(\(sp)r(eci\014ed)h(b)n(y)f(attribute)h
-(Pcd-)227 2153 y(Cen\),)k(RD)e(is)g(the)g(radial)e(distance)i(from)f
+(Pcd-)227 3357 y(Cen\),)k(RD)e(is)g(the)g(radial)e(distance)i(from)f
(the)i(same)e(cen)n(tre)g(in)h(the)g(presence)f(of)h(distortion,)g(and)
-g(C)g(is)f(the)227 2252 y(distortion)c(co)r(e\016cien)n(t)h(\(giv)n(en)
-f(b)n(y)g(attribute)h(Disco\).)227 2377 y(The)33 b(in)n(v)n(erse)f
+g(C)g(is)f(the)227 3456 y(distortion)c(co)r(e\016cien)n(t)h(\(giv)n(en)
+f(b)n(y)g(attribute)h(Disco\).)227 3580 y(The)33 b(in)n(v)n(erse)f
(transformation)f(of)i(a)f(PcdMap)h(remo)n(v)n(es)d(the)k(distortion)e
(pro)r(duced)h(b)n(y)f(the)h(forw)n(ard)f(trans-)227
-2477 y(formation.)42 b(The)29 b(expression)f(used)i(to)f(deriv)n(e)g(R)
+3680 y(formation.)42 b(The)29 b(expression)f(used)i(to)f(deriv)n(e)g(R)
g(from)g(RD)i(is)e(an)g(appro)n(ximate)f(in)n(v)n(erse)g(of)h(the)h
-(expression)227 2576 y(ab)r(o)n(v)n(e,)f(obtained)g(from)g(t)n(w)n(o)g
+(expression)227 3779 y(ab)r(o)n(v)n(e,)f(obtained)g(from)g(t)n(w)n(o)g
(iterations)f(of)h(the)h(Newton-Raphson)f(metho)r(d.)42
-b(The)30 b(mismatc)n(h)f(b)r(et)n(w)n(een)g(the)227 2676
+b(The)30 b(mismatc)n(h)f(b)r(et)n(w)n(een)g(the)227 3879
y(forw)n(ard)d(and)h(in)n(v)n(erse)f(expressions)f(is)i(negligible)g
(for)f(astrometric)g(applications)g(\(to)i(reac)n(h)e(1)h(milliarcsec)f
-(at)227 2775 y(the)g(edge)g(of)g(the)g(Anglo-Australian)e(T)-7
+(at)227 3979 y(the)g(edge)g(of)g(the)g(Anglo-Australian)e(T)-7
b(elescop)r(e)25 b(triplet)h(or)f(a)h(Sc)n(hmidt)g(\014eld)g(w)n(ould)f
-(require)g(\014eld)h(diameters)227 2875 y(of)i(2.4)f(and)g(42)g
-(degrees)f(resp)r(ectiv)n(ely\).)227 3000 y(If)39 b(a)f(PcdMap)f(is)h
+(require)g(\014eld)h(diameters)227 4078 y(of)i(2.4)f(and)g(42)g
+(degrees)f(resp)r(ectiv)n(ely\).)227 4202 y(If)39 b(a)f(PcdMap)f(is)h
(in)n(v)n(erted)f(\(e.g.)69 b(using)37 b(AST)p Ft(_)p
Fj(INVER)-7 b(T\))39 b(then)g(the)f(roles)f(of)h(the)h(forw)n(ard)d
-(and)i(in)n(v)n(erse)227 3099 y(transformations)19 b(are)g(rev)n
+(and)i(in)n(v)n(erse)227 4302 y(transformations)19 b(are)g(rev)n
(ersed;)i(the)g(forw)n(ard)d(transformation)h(will)i(remo)n(v)n(e)d
-(the)j(distortion,)g(and)f(the)h(in)n(v)n(erse)227 3199
-y(transformation)26 b(will)i(apply)f(it.)0 3349 y Fc(In)m(v)m(o)s
+(the)j(distortion,)g(and)f(the)h(in)n(v)n(erse)227 4401
+y(transformation)26 b(will)i(apply)f(it.)0 4549 y Fc(In)m(v)m(o)s
(cation:)123 b Ft(RESULT)41 b(=)i(AST_PCDMAP\()c(DISCO,)i(PCDCEN,)g
-(OPTIONS,)f(STATUS)h(\))0 3499 y Fc(Argumen)m(ts:)259
-3636 y(DISCO)32 b(=)g(DOUBLE)g(PRECISION)g(\(Giv)m(en\))427
-3736 y Fj(The)23 b(distortion)f(co)r(e\016cien)n(t.)35
+(OPTIONS,)f(STATUS)h(\))0 4697 y Fc(Argumen)m(ts:)259
+4832 y(DISCO)32 b(=)g(DOUBLE)g(PRECISION)g(\(Giv)m(en\))427
+4932 y Fj(The)23 b(distortion)f(co)r(e\016cien)n(t.)35
b(Negativ)n(e)21 b(v)-5 b(alues)23 b(giv)n(e)e(barrel)h(distortion,)h
(p)r(ositiv)n(e)f(v)-5 b(alues)22 b(giv)n(e)g(pincush-)427
-3835 y(ion)28 b(distortion,)f(and)g(zero)g(giv)n(es)f(no)h(distortion.)
-259 3968 y Fc(PCDCEN\()32 b(2)f(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m
-(en\))427 4068 y Fj(An)d(arra)n(y)e(con)n(taining)g(the)i(co)r
+5032 y(ion)28 b(distortion,)f(and)g(zero)g(giv)n(es)f(no)h(distortion.)
+259 5163 y Fc(PCDCEN\()32 b(2)f(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m
+(en\))427 5263 y Fj(An)d(arra)n(y)e(con)n(taining)g(the)i(co)r
(ordinates)e(of)i(the)g(cen)n(tre)f(of)g(the)h(distortion.)259
-4201 y Fc(OPTIONS)k(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 4301 y Fj(A)22 b(c)n(haracter)e
+5394 y Fc(OPTIONS)k(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 5494 y Fj(A)22 b(c)n(haracter)e
(string)h(con)n(taining)g(an)h(optional)f(comma-separated)e(list)j(of)g
-(attribute)g(assignmen)n(ts)f(to)g(b)r(e)427 4400 y(used)27
+(attribute)g(assignmen)n(ts)f(to)g(b)r(e)427 5593 y(used)27
b(for)e(initialising)i(the)f(new)h(PcdMap.)36 b(The)26
b(syn)n(tax)g(used)g(is)g(iden)n(tical)g(to)h(that)f(for)g(the)h(AST)p
-Ft(_)p Fj(SET)427 4500 y(routine.)259 4633 y Fc(ST)-8
+Ft(_)p Fj(SET)427 5693 y(routine.)p eop end
+%%Page: 308 318
+TeXDict begin 308 317 bop 0 52 a FG(308)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(ST)-8
b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-4733 y Fj(The)c(global)e(status.)0 4895 y Fc(Returned)32
-b(V)-8 b(alue:)259 5032 y(AST)p Ft(_)p Fc(PCDMAP)33 b(=)f(INTEGER)427
-5132 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(PcdMap.)0
-5294 y Fc(Notes:)340 5577 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+451 y Fj(The)c(global)e(status.)0 613 y Fc(Returned)32
+b(V)-8 b(alue:)259 750 y(AST)p Ft(_)p Fc(PCDMAP)33 b(=)f(INTEGER)427
+849 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(PcdMap.)0
+1012 y Fc(Notes:)340 1294 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 5677 y(set)28 b(to)f(an)h(error)d(v)-5
-b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
+b(A)g(TUS)427 1394 y(set)28 b(to)f(an)h(error)d(v)-5
+b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)-2
+1556 y Fc(Status)33 b(Handling)n(:)227 1702 y Fj(The)d(protected)g(in)n
+(terface)f(to)g(this)h(function)h(includes)f(an)f(extra)g(parameter)f
+(at)i(the)g(end)g(of)g(the)g(parameter)227 1802 y(list)37
+b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)
+r(oin)n(ter)g(to)h(the)g(in)n(teger)e(inherited)i(status)f(v)-5
+b(ariable:)54 b Ft(")p Fj(in)n(t)227 1902 y Fi(\003)p
+Fj(status)p Ft(")p Fj(.)p 0 2101 3780 12 v 0 2232 a FA(AST)p
+Fe(_)p FA(PERMAXES)1302 2233 y Fd(P)m(erm)m(ute)37 b(the)h(axis)g
+(order)1613 2332 y(in)g(a)h(F)-10 b(rame)2674 2232 y
+FA(AST)p Fe(_)p FA(PERMAXES)0 2498 y Fc(Description:)44
+b Fj(This)28 b(routine)f(p)r(erm)n(utes)h(the)g(order)e(in)i(whic)n(h)f
+(a)g(F)-7 b(rame's)27 b(axes)g(o)r(ccur.)0 2648 y Fc(In)m(v)m(o)s
+(cation:)123 b Ft(CALL)42 b(AST_PERMAXES\()c(THIS,)j(PERM,)h(STATUS)f
+(\))0 2798 y Fc(Argumen)m(ts:)259 2935 y(THIS)32 b(=)g(INTEGER)g(\(Giv)
+m(en\))427 3034 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rame.)259 3167 y Fc(PERM\()31 b Fi(\003)h Fc(\))g(=)g(INTEGER)f
+(\(Giv)m(en\))427 3267 y Fj(An)k(arra)n(y)e(with)i(one)f(elemen)n(t)h
+(for)f(eac)n(h)f(axis)h(of)h(the)g(F)-7 b(rame)34 b(\(Naxes)g
+(attribute\).)58 b(This)35 b(should)f(list)427 3366 y(the)28
+b(axes)e(in)h(their)g(new)h(order,)e(using)g(the)i(original)d(axis)i(n)
+n(um)n(b)r(ering)f(\(whic)n(h)i(starts)e(at)h(1)g(for)f(the)i(\014rst)
+427 3466 y(axis\).)259 3599 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f
+(\(Giv)m(en)h(and)g(Returned\))427 3699 y Fj(The)c(global)e(status.)0
+3861 y Fc(Notes:)340 4144 y Fi(\017)45 b Fj(Only)29 b(gen)n(uine)g(p)r
+(erm)n(utations)f(of)i(the)f(axis)g(order)e(are)i(p)r(ermitted,)h(so)f
+(eac)n(h)f(axis)g(m)n(ust)i(b)r(e)f(referenced)427 4243
+y(exactly)e(once)g(in)h(the)g(PERM)f(arra)n(y)-7 b(.)340
+4376 y Fi(\017)45 b Fj(If)28 b(successiv)n(e)f(axis)f(p)r(erm)n
+(utations)h(are)g(applied)h(to)f(a)g(F)-7 b(rame,)27
+b(then)h(the)g(e\013ects)g(are)f(cum)n(ulativ)n(e.)p
+0 4576 V 0 4707 a FA(AST)p Fe(_)p FA(PERMMAP)1401 4706
+y Fd(Create)37 b(a)i(P)m(ermMap)2719 4707 y FA(AST)p
+Fe(_)p FA(PERMMAP)0 4895 y Fc(Description:)44 b Fj(This)28
+b(function)g(creates)f(a)g(new)g(P)n(ermMap)g(and)g(optionally)g
+(initialises)g(its)h(attributes.)227 5020 y(A)g(P)n(ermMap)d(is)i(a)g
+(Mapping)f(whic)n(h)h(p)r(erm)n(utes)g(the)g(order)f(of)h(co)r
+(ordinates,)e(and)i(p)r(ossibly)g(also)f(c)n(hanges)f(the)227
+5120 y(n)n(um)n(b)r(er)j(of)f(co)r(ordinates,)f(b)r(et)n(w)n(een)i(its)
+g(input)g(and)g(output.)227 5244 y(In)37 b(addition)f(to)g(p)r(erm)n
+(uting)h(the)f(co)r(ordinate)g(order,)h(a)f(P)n(ermMap)f(ma)n(y)h(also)
+f(assign)g(constan)n(t)h(v)-5 b(alues)36 b(to)227 5344
+y(co)r(ordinates.)53 b(This)33 b(is)g(useful)h(when)g(the)f(n)n(um)n(b)
+r(er)g(of)h(co)r(ordinates)d(is)j(b)r(eing)f(increased)f(as)h(it)h
+(allo)n(ws)e(\014xed)227 5444 y(v)-5 b(alues)27 b(to)h(b)r(e)g
+(assigned)e(to)i(an)n(y)f(new)g(ones.)0 5593 y Fc(In)m(v)m(o)s(cation:)
+123 b Ft(RESULT)41 b(=)i(AST_PERMMAP\()c(NIN,)j(INPERM,)e(NOUT,)i
+(OUTPERM,)e(CONSTANT,)g(OPTIONS,)g(STATUS)227 5693 y(\))p
eop end
-%%Page: 306 316
-TeXDict begin 306 315 bop 0 52 a FG(306)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)-2 351 y Fc(Status)i(Handling)n(:)
-227 497 y Fj(The)d(protected)g(in)n(terface)f(to)g(this)h(function)h
-(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g(the)g
-(parameter)227 597 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62
-b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)
-e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fj(in)n(t)227
-697 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p 0 891 3780
-12 v 0 1022 a FA(AST)p Fe(_)p FA(PERMAXES)1302 1023 y
-Fd(P)m(erm)m(ute)37 b(the)h(axis)g(order)1613 1122 y(in)g(a)h(F)-10
-b(rame)2674 1022 y FA(AST)p Fe(_)p FA(PERMAXES)0 1283
-y Fc(Description:)44 b Fj(This)28 b(routine)f(p)r(erm)n(utes)h(the)g
-(order)e(in)i(whic)n(h)f(a)g(F)-7 b(rame's)27 b(axes)g(o)r(ccur.)0
-1430 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_PERMAXES\()c
-(THIS,)j(PERM,)h(STATUS)f(\))0 1577 y Fc(Argumen)m(ts:)259
-1710 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1810
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7 b(rame.)259 1940
-y Fc(PERM\()31 b Fi(\003)h Fc(\))g(=)g(INTEGER)f(\(Giv)m(en\))427
-2040 y Fj(An)k(arra)n(y)e(with)i(one)f(elemen)n(t)h(for)f(eac)n(h)f
-(axis)h(of)h(the)g(F)-7 b(rame)34 b(\(Naxes)g(attribute\).)58
-b(This)35 b(should)f(list)427 2140 y(the)28 b(axes)e(in)h(their)g(new)h
-(order,)e(using)g(the)i(original)d(axis)i(n)n(um)n(b)r(ering)f(\(whic)n
-(h)i(starts)e(at)h(1)g(for)f(the)i(\014rst)427 2239 y(axis\).)259
-2370 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 2469 y Fj(The)c(global)e(status.)0 2629
-y Fc(Notes:)340 2909 y Fi(\017)45 b Fj(Only)29 b(gen)n(uine)g(p)r(erm)n
-(utations)f(of)i(the)f(axis)g(order)e(are)i(p)r(ermitted,)h(so)f(eac)n
-(h)f(axis)g(m)n(ust)i(b)r(e)f(referenced)427 3008 y(exactly)e(once)g
-(in)h(the)g(PERM)f(arra)n(y)-7 b(.)340 3138 y Fi(\017)45
-b Fj(If)28 b(successiv)n(e)f(axis)f(p)r(erm)n(utations)h(are)g(applied)
-h(to)f(a)g(F)-7 b(rame,)27 b(then)h(the)g(e\013ects)g(are)f(cum)n
-(ulativ)n(e.)p 0 3333 V 0 3463 a FA(AST)p Fe(_)p FA(PERMMAP)338
-b Fd(Create)37 b(a)i(P)m(ermMap)339 b FA(AST)p Fe(_)p
-FA(PERMMAP)0 3647 y Fc(Description:)44 b Fj(This)28 b(function)g
-(creates)f(a)g(new)g(P)n(ermMap)g(and)g(optionally)g(initialises)g(its)
-h(attributes.)227 3770 y(A)g(P)n(ermMap)d(is)i(a)g(Mapping)f(whic)n(h)h
-(p)r(erm)n(utes)g(the)g(order)f(of)h(co)r(ordinates,)e(and)i(p)r
-(ossibly)g(also)f(c)n(hanges)f(the)227 3870 y(n)n(um)n(b)r(er)j(of)f
-(co)r(ordinates,)f(b)r(et)n(w)n(een)i(its)g(input)g(and)g(output.)227
-3993 y(In)37 b(addition)f(to)g(p)r(erm)n(uting)h(the)f(co)r(ordinate)g
-(order,)h(a)f(P)n(ermMap)f(ma)n(y)h(also)f(assign)g(constan)n(t)h(v)-5
-b(alues)36 b(to)227 4093 y(co)r(ordinates.)53 b(This)33
-b(is)g(useful)h(when)g(the)f(n)n(um)n(b)r(er)g(of)h(co)r(ordinates)d
-(is)j(b)r(eing)f(increased)f(as)h(it)h(allo)n(ws)e(\014xed)227
-4192 y(v)-5 b(alues)27 b(to)h(b)r(e)g(assigned)e(to)i(an)n(y)f(new)g
-(ones.)0 4339 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
-b(=)i(AST_PERMMAP\()c(NIN,)j(INPERM,)e(NOUT,)i(OUTPERM,)e(CONSTANT,)g
-(OPTIONS,)g(STATUS)227 4439 y(\))0 4586 y Fc(Argumen)m(ts:)259
-4720 y(NIN)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 4819 y
-Fj(The)d(n)n(um)n(b)r(er)f(of)h(input)g(co)r(ordinates.)259
-4950 y Fc(INPERM)j(=)h(INTEGER\()g(NIN)f(\))h(\(Giv)m(en\))427
-5049 y Fj(An)d(arra)n(y)d(whic)n(h,)i(for)g(eac)n(h)f(input)i(co)r
-(ordinate,)e(should)h(con)n(tain)g(the)h(n)n(um)n(b)r(er)e(of)i(the)f
-(output)h(co)r(ordi-)427 5149 y(nate)g(whose)g(v)-5 b(alue)29
-b(is)g(to)g(b)r(e)h(used)f(\(note)h(that)f(this)h(arra)n(y)d(therefore)
-h(de\014nes)h(the)h(in)n(v)n(erse)e(co)r(ordinate)427
-5248 y(transformation\).)36 b(Co)r(ordinates)26 b(are)h(n)n(um)n(b)r
-(ered)g(starting)g(from)g(1.)427 5363 y(F)-7 b(or)28
+%%Page: 309 319
+TeXDict begin 309 318 bop 3643 52 a FG(309)0 351 y Fc(Argumen)m(ts:)259
+516 y(NIN)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 616 y Fj(The)d(n)n(um)n
+(b)r(er)f(of)h(input)g(co)r(ordinates.)259 763 y Fc(INPERM)j(=)h
+(INTEGER\()g(NIN)f(\))h(\(Giv)m(en\))427 863 y Fj(An)d(arra)n(y)d(whic)
+n(h,)i(for)g(eac)n(h)f(input)i(co)r(ordinate,)e(should)h(con)n(tain)g
+(the)h(n)n(um)n(b)r(er)e(of)i(the)f(output)h(co)r(ordi-)427
+963 y(nate)g(whose)g(v)-5 b(alue)29 b(is)g(to)g(b)r(e)h(used)f(\(note)h
+(that)f(this)h(arra)n(y)d(therefore)h(de\014nes)h(the)h(in)n(v)n(erse)e
+(co)r(ordinate)427 1062 y(transformation\).)36 b(Co)r(ordinates)26
+b(are)h(n)n(um)n(b)r(ered)g(starting)g(from)g(1.)427
+1186 y(F)-7 b(or)28 b(details)g(of)g(additional)g(sp)r(ecial)g(v)-5
+b(alues)28 b(that)h(ma)n(y)f(b)r(e)g(used)h(in)f(this)h(arra)n(y)-7
+b(,)26 b(see)i(the)h(description)f(of)427 1285 y(the)g(CONST)-7
+b(ANT)28 b(argumen)n(t.)259 1433 y Fc(NOUT)k(=)g(INTEGER)g(\(Giv)m
+(en\))427 1532 y Fj(The)c(n)n(um)n(b)r(er)f(of)h(output)g(co)r
+(ordinates.)259 1679 y Fc(OUTPERM)k(=)g(INTEGER\()f(NOUT)h(\))g(\(Giv)m
+(en\))427 1779 y Fj(An)19 b(arra)n(y)e(whic)n(h,)j(for)f(eac)n(h)f
+(output)h(co)r(ordinate,)g(should)g(con)n(tain)f(the)h(n)n(um)n(b)r(er)
+f(of)h(the)g(input)h(co)r(ordinate)427 1879 y(whose)40
+b(v)-5 b(alue)40 b(is)h(to)f(b)r(e)h(used)f(\(note)h(that)g(this)f
+(arra)n(y)e(therefore)i(de\014nes)g(the)h(forw)n(ard)e(co)r(ordinate)
+427 1978 y(transformation\).)d(Co)r(ordinates)26 b(are)h(n)n(um)n(b)r
+(ered)g(starting)g(from)g(1.)427 2102 y(F)-7 b(or)28
b(details)g(of)g(additional)g(sp)r(ecial)g(v)-5 b(alues)28
b(that)h(ma)n(y)f(b)r(e)g(used)h(in)f(this)h(arra)n(y)-7
-b(,)26 b(see)i(the)h(description)f(of)427 5463 y(the)g(CONST)-7
-b(ANT)28 b(argumen)n(t.)259 5593 y Fc(NOUT)k(=)g(INTEGER)g(\(Giv)m
-(en\))427 5693 y Fj(The)c(n)n(um)n(b)r(er)f(of)h(output)g(co)r
-(ordinates.)p eop end
-%%Page: 307 317
-TeXDict begin 307 316 bop 3643 52 a FG(307)259 351 y
-Fc(OUTPERM)32 b(=)g(INTEGER\()f(NOUT)h(\))g(\(Giv)m(en\))427
-451 y Fj(An)19 b(arra)n(y)e(whic)n(h,)j(for)f(eac)n(h)f(output)h(co)r
-(ordinate,)g(should)g(con)n(tain)f(the)h(n)n(um)n(b)r(er)f(of)h(the)g
-(input)h(co)r(ordinate)427 551 y(whose)40 b(v)-5 b(alue)40
-b(is)h(to)f(b)r(e)h(used)f(\(note)h(that)g(this)f(arra)n(y)e(therefore)
-i(de\014nes)g(the)h(forw)n(ard)e(co)r(ordinate)427 650
-y(transformation\).)d(Co)r(ordinates)26 b(are)h(n)n(um)n(b)r(ered)g
-(starting)g(from)g(1.)427 768 y(F)-7 b(or)28 b(details)g(of)g
-(additional)g(sp)r(ecial)g(v)-5 b(alues)28 b(that)h(ma)n(y)f(b)r(e)g
-(used)h(in)f(this)h(arra)n(y)-7 b(,)26 b(see)i(the)h(description)f(of)
-427 867 y(the)g(CONST)-7 b(ANT)28 b(argumen)n(t.)259
-1003 y Fc(CONST)-8 b(ANT)32 b(=)g(DOUBLE)h(PRECISION\()e
-Fi(\003)g Fc(\))h(\(Giv)m(en\))427 1103 y Fj(An)22 b(arra)n(y)d(con)n
-(taining)h(v)-5 b(alues)21 b(whic)n(h)g(ma)n(y)g(b)r(e)g(assigned)f(to)
-i(input)g(and/or)d(output)j(co)r(ordinates)e(instead)427
-1203 y(of)h(deriving)f(them)h(from)g(other)f(co)r(ordinate)f(v)-5
-b(alues.)35 b(If)21 b(either)f(of)h(the)g(INPERM)g(or)e(OUTPERM)h(arra)
-n(ys)427 1302 y(con)n(tains)i(a)g(negativ)n(e)g(v)-5
-b(alue,)23 b(it)g(is)g(used)f(to)h(address)e(this)i(CONST)-7
-b(ANT)24 b(arra)n(y)c(\(suc)n(h)i(that)h(-1)f(addresses)427
-1402 y(the)j(\014rst)g(elemen)n(t,)g(-2)f(addresses)f(the)i(second)f
+b(,)26 b(see)i(the)h(description)f(of)427 2201 y(the)g(CONST)-7
+b(ANT)28 b(argumen)n(t.)259 2349 y Fc(CONST)-8 b(ANT)32
+b(=)g(DOUBLE)h(PRECISION\()e Fi(\003)g Fc(\))h(\(Giv)m(en\))427
+2448 y Fj(An)22 b(arra)n(y)d(con)n(taining)h(v)-5 b(alues)21
+b(whic)n(h)g(ma)n(y)g(b)r(e)g(assigned)f(to)i(input)g(and/or)d(output)j
+(co)r(ordinates)e(instead)427 2548 y(of)h(deriving)f(them)h(from)g
+(other)f(co)r(ordinate)f(v)-5 b(alues.)35 b(If)21 b(either)f(of)h(the)g
+(INPERM)g(or)e(OUTPERM)h(arra)n(ys)427 2647 y(con)n(tains)i(a)g
+(negativ)n(e)g(v)-5 b(alue,)23 b(it)g(is)g(used)f(to)h(address)e(this)i
+(CONST)-7 b(ANT)24 b(arra)n(y)c(\(suc)n(h)i(that)h(-1)f(addresses)427
+2747 y(the)j(\014rst)g(elemen)n(t,)g(-2)f(addresses)f(the)i(second)f
(elemen)n(t,)h(etc.\))37 b(and)24 b(the)h(v)-5 b(alue)25
-b(obtained)f(is)h(used)f(as)g(the)427 1501 y(corresp)r(onding)i(co)r
-(ordinate)g(v)-5 b(alue.)427 1619 y(Care)29 b(should)h(b)r(e)h(tak)n
+b(obtained)f(is)h(used)f(as)g(the)427 2847 y(corresp)r(onding)i(co)r
+(ordinate)g(v)-5 b(alue.)427 2970 y(Care)29 b(should)h(b)r(e)h(tak)n
(en)f(to)g(ensure)f(that)i(lo)r(cations)e(lying)h(outside)g(the)h
-(exten)n(t)f(of)g(this)h(arra)n(y)c(are)j(not)427 1719
+(exten)n(t)f(of)g(this)h(arra)n(y)c(are)j(not)427 3070
y(acciden)n(tally)25 b(addressed.)35 b(The)26 b(arra)n(y)d(is)j(not)f
(used)h(if)g(the)g(INPERM)g(and)f(OUTPERM)g(arra)n(ys)e(do)j(not)427
-1818 y(con)n(tain)h(negativ)n(e)g(v)-5 b(alues.)259 1954
+3169 y(con)n(tain)h(negativ)n(e)g(v)-5 b(alues.)259 3317
y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 2054 y Fj(A)22 b(c)n(haracter)e
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 3416 y Fj(A)22 b(c)n(haracter)e
(string)h(con)n(taining)g(an)h(optional)f(comma-separated)e(list)j(of)g
-(attribute)g(assignmen)n(ts)f(to)g(b)r(e)427 2153 y(used)i(for)f
+(attribute)g(assignmen)n(ts)f(to)g(b)r(e)427 3516 y(used)i(for)f
(initialising)g(the)i(new)e(P)n(ermMap.)34 b(The)23 b(syn)n(tax)f(used)
g(is)h(iden)n(tical)f(to)h(that)g(for)f(the)h(AST)p Ft(_)p
-Fj(SET)427 2253 y(routine.)259 2389 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 2489
-y Fj(The)c(global)e(status.)0 2656 y Fc(Returned)32 b(V)-8
-b(alue:)259 2799 y(AST)p Ft(_)p Fc(PERMMAP)31 b(=)i(INTEGER)427
-2898 y Fj(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(P)n(ermMap.)0
-3066 y Fc(Notes:)340 3355 y Fi(\017)45 b Fj(If)37 b(either)f(of)g(the)g
+Fj(SET)427 3616 y(routine.)259 3763 y Fc(ST)-8 b(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 3862
+y Fj(The)c(global)e(status.)0 4053 y Fc(Returned)32 b(V)-8
+b(alue:)259 4218 y(AST)p Ft(_)p Fc(PERMMAP)31 b(=)i(INTEGER)427
+4318 y Fj(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(P)n(ermMap.)0
+4509 y Fc(Notes:)340 4820 y Fi(\017)45 b Fj(If)37 b(either)f(of)g(the)g
(INPERM)g(or)f(OUTPERM)g(arra)n(ys)f(con)n(tains)h(a)h(zero)f(v)-5
b(alue)36 b(\(or)f(a)h(p)r(ositiv)n(e)g(v)-5 b(alue)427
-3454 y(whic)n(h)39 b(do)r(es)g(not)g(iden)n(tify)h(a)f(v)-5
+4920 y(whic)n(h)39 b(do)r(es)g(not)g(iden)n(tify)h(a)f(v)-5
b(alid)39 b(output/input)h(co)r(ordinate,)h(as)e(appropriate\),)h(then)
-g(the)g(v)-5 b(alue)427 3554 y(AST)p Ft(__)p Fj(BAD)28
+g(the)g(v)-5 b(alue)427 5019 y(AST)p Ft(__)p Fj(BAD)28
b(is)f(assigned)g(as)g(the)h(new)f(co)r(ordinate)g(v)-5
-b(alue.)340 3690 y Fi(\017)45 b Fj(This)29 b(function)g(do)r(es)g(not)g
+b(alue.)340 5167 y Fi(\017)45 b Fj(This)29 b(function)g(do)r(es)g(not)g
(attempt)g(to)g(ensure)f(that)h(the)g(forw)n(ard)e(and)i(in)n(v)n(erse)
-e(transformations)g(p)r(er-)427 3789 y(formed)37 b(b)n(y)g(the)h(P)n
+e(transformations)g(p)r(er-)427 5266 y(formed)37 b(b)n(y)g(the)h(P)n
(ermMap)e(are)g(self-consisten)n(t)h(in)h(an)n(y)e(w)n(a)n(y)-7
b(.)65 b(Y)-7 b(ou)37 b(are)g(therefore)f(free)h(to)h(supply)427
-3889 y(co)r(ordinate)27 b(p)r(erm)n(utation)g(arra)n(ys)e(that)j(ac)n
+5366 y(co)r(ordinate)27 b(p)r(erm)n(utation)g(arra)n(ys)e(that)j(ac)n
(hiev)n(e)e(whatev)n(er)h(e\013ect)h(is)f(desired.)340
-4025 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20
+5513 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20
b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e
(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 4125 y(set)28 b(to)f(an)h(error)d(v)-5
+b(A)g(TUS)427 5613 y(set)28 b(to)f(an)h(error)d(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-0 4330 3780 12 v 0 4460 a FA(AST)p Fe(_)p FA(PICKAXES)1291
-4461 y Fd(Create)37 b(a)h(new)h(F)-10 b(rame)38 b(b)m(y)1359
-4576 y(pic)m(king)g(axes)g(from)g(an)1585 4687 y(existing)g(one)2738
-4460 y FA(AST)p Fe(_)p FA(PICKAXES)0 4882 y Fc(Description:)44
-b Fj(This)31 b(function)h(creates)e(a)g(new)i(F)-7 b(rame)30
-b(whose)g(axes)g(are)h(copied)f(from)h(an)g(existing)f(F)-7
-b(rame)31 b(along)227 4981 y(with)d(other)f(F)-7 b(rame)26
-b(attributes,)i(suc)n(h)e(as)h(its)g(Title.)37 b(An)n(y)28
-b(n)n(um)n(b)r(er)f(\(zero)f(or)g(more\))h(of)g(the)h(original)d(F)-7
-b(rame's)227 5081 y(axes)24 b(ma)n(y)f(b)r(e)i(copied,)g(in)g(an)n(y)e
-(order,)h(and)g(additional)g(axes)f(with)i(default)g(attributes)f(ma)n
-(y)g(also)f(b)r(e)i(included)227 5181 y(in)j(the)g(new)g(F)-7
-b(rame.)227 5308 y(A)33 b(Mapping)e(that)i(con)n(v)n(erts)d(b)r(et)n(w)
-n(een)i(the)g(co)r(ordinate)f(systems)h(describ)r(ed)g(b)n(y)f(the)i(t)
-n(w)n(o)e(F)-7 b(rames)31 b(will)i(also)227 5408 y(b)r(e)28
-b(returned.)0 5563 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
-b(=)i(AST_PICKAXES\()38 b(THIS,)k(NAXES,)f(AXES,)g(MAP,)h(STATUS)f(\))0
-5718 y Fc(Argumen)m(ts:)p eop end
-%%Page: 308 318
-TeXDict begin 308 317 bop 0 52 a FG(308)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(THIS)h(=)g(INTEGER)g
-(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(original)e(F)
--7 b(rame.)259 605 y Fc(NAXES)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
-704 y Fj(The)d(n)n(um)n(b)r(er)f(of)h(axes)e(required)h(in)h(the)g(new)
-g(F)-7 b(rame.)259 858 y Fc(AXES\()32 b(NAXES)g(\))g(=)g(INTEGER)f
-(\(Giv)m(en\))427 957 y Fj(An)h(arra)n(y)d(whic)n(h)j(lists)f(the)h
+eop end
+%%Page: 310 320
+TeXDict begin 310 319 bop 0 52 a FG(310)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(PICKAXES)1291 483 y Fd(Create)37
+b(a)h(new)h(F)-10 b(rame)38 b(b)m(y)1359 598 y(pic)m(king)g(axes)g
+(from)g(an)1585 708 y(existing)g(one)2738 482 y FA(AST)p
+Fe(_)p FA(PICKAXES)0 908 y Fc(Description:)44 b Fj(This)31
+b(function)h(creates)e(a)g(new)i(F)-7 b(rame)30 b(whose)g(axes)g(are)h
+(copied)f(from)h(an)g(existing)f(F)-7 b(rame)31 b(along)227
+1008 y(with)d(other)f(F)-7 b(rame)26 b(attributes,)i(suc)n(h)e(as)h
+(its)g(Title.)37 b(An)n(y)28 b(n)n(um)n(b)r(er)f(\(zero)f(or)g(more\))h
+(of)g(the)h(original)d(F)-7 b(rame's)227 1107 y(axes)24
+b(ma)n(y)f(b)r(e)i(copied,)g(in)g(an)n(y)e(order,)h(and)g(additional)g
+(axes)f(with)i(default)g(attributes)f(ma)n(y)g(also)f(b)r(e)i(included)
+227 1207 y(in)j(the)g(new)g(F)-7 b(rame.)227 1337 y(A)33
+b(Mapping)e(that)i(con)n(v)n(erts)d(b)r(et)n(w)n(een)i(the)g(co)r
+(ordinate)f(systems)h(describ)r(ed)g(b)n(y)f(the)i(t)n(w)n(o)e(F)-7
+b(rames)31 b(will)i(also)227 1437 y(b)r(e)28 b(returned.)0
+1597 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_PICKAXES\()
+38 b(THIS,)k(NAXES,)f(AXES,)g(MAP,)h(STATUS)f(\))0 1758
+y Fc(Argumen)m(ts:)259 1905 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
+2005 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(original)e(F)-7
+b(rame.)259 2143 y Fc(NAXES)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
+2242 y Fj(The)d(n)n(um)n(b)r(er)f(of)h(axes)e(required)h(in)h(the)g
+(new)g(F)-7 b(rame.)259 2381 y Fc(AXES\()32 b(NAXES)g(\))g(=)g(INTEGER)
+f(\(Giv)m(en\))427 2480 y Fj(An)h(arra)n(y)d(whic)n(h)j(lists)f(the)h
(axes)f(to)g(b)r(e)h(copied.)48 b(These)31 b(should)h(b)r(e)f(giv)n(en)
-g(in)h(the)g(order)e(required)g(in)427 1057 y(the)35
+g(in)h(the)g(order)e(required)g(in)427 2580 y(the)35
b(new)f(F)-7 b(rame,)36 b(using)e(the)g(axis)g(n)n(um)n(b)r(ering)g(in)
g(the)h(original)e(F)-7 b(rame)33 b(\(whic)n(h)i(starts)e(at)i(1)e(for)
-h(the)427 1157 y(\014rst)26 b(axis\).)36 b(Axes)26 b(ma)n(y)f(b)r(e)h
+h(the)427 2680 y(\014rst)26 b(axis\).)36 b(Axes)26 b(ma)n(y)f(b)r(e)h
(selected)g(in)h(an)n(y)e(order,)g(but)h(eac)n(h)g(ma)n(y)f(only)g(b)r
-(e)i(used)f(once.)36 b(If)26 b(additional)427 1256 y(\(default\))i
+(e)i(used)f(once.)36 b(If)26 b(additional)427 2779 y(\(default\))i
(axes)d(are)h(also)f(to)h(b)r(e)h(included,)h(the)e(corresp)r(onding)f
(elemen)n(ts)h(of)h(this)f(arra)n(y)f(should)h(b)r(e)h(set)427
-1356 y(to)h(zero.)259 1510 y Fc(MAP)k(=)g(INTEGER)f(\(Returned\))427
-1609 y Fj(A)c(p)r(oin)n(ter)f(to)h(a)f(new)g(Mapping.)37
+2879 y(to)h(zero.)259 3017 y Fc(MAP)k(=)g(INTEGER)f(\(Returned\))427
+3117 y Fj(A)c(p)r(oin)n(ter)f(to)h(a)f(new)g(Mapping.)37
b(This)26 b(will)h(b)r(e)g(a)f(P)n(ermMap)f(\(or)h(a)g(UnitMap)h(as)f
-(a)g(sp)r(ecial)g(case\))g(that)427 1709 y(describ)r(es)32
+(a)g(sp)r(ecial)g(case\))g(that)427 3216 y(describ)r(es)32
b(the)h(axis)f(p)r(erm)n(utation)h(that)g(has)f(tak)n(en)g(place)g(b)r
(et)n(w)n(een)h(the)g(original)e(and)i(new)f(F)-7 b(rames.)427
-1808 y(The)26 b(Mapping's)f(forw)n(ard)g(transformation)f(will)i(con)n
+3316 y(The)26 b(Mapping's)f(forw)n(ard)g(transformation)f(will)i(con)n
(v)n(ert)e(co)r(ordinates)h(from)g(the)h(original)f(F)-7
-b(rame)25 b(in)n(to)427 1908 y(the)j(new)g(one,)f(and)h(vice)f(v)n
-(ersa.)259 2062 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h
-(and)g(Returned\))427 2161 y Fj(The)c(global)e(status.)0
-2365 y Fc(Class)31 b(Applicabilit)m(y:)259 2543 y(F)-8
-b(rame)427 2642 y Fj(This)27 b(function)h(applies)e(to)h(all)g(F)-7
+b(rame)25 b(in)n(to)427 3416 y(the)j(new)g(one,)f(and)h(vice)f(v)n
+(ersa.)259 3554 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h
+(and)g(Returned\))427 3654 y Fj(The)c(global)e(status.)0
+3827 y Fc(Class)31 b(Applicabilit)m(y:)259 3974 y(F)-8
+b(rame)427 4073 y Fj(This)27 b(function)h(applies)e(to)h(all)g(F)-7
b(rames.)36 b(The)27 b(class)f(of)h(F)-7 b(rame)26 b(returned)h(ma)n(y)
-f(di\013er)h(from)g(that)g(of)g(the)427 2742 y(original)g(F)-7
+f(di\013er)h(from)g(that)g(of)g(the)427 4173 y(original)g(F)-7
b(rame,)27 b(dep)r(ending)h(on)g(whic)n(h)g(axes)f(are)g(selected.)37
b(F)-7 b(or)28 b(example,)f(if)h(a)g(single)f(axis)g(is)h(pic)n(k)n(ed)
-427 2842 y(from)i(a)g(SkyF)-7 b(rame)29 b(\(whic)n(h)h(m)n(ust)h(alw)n
+427 4273 y(from)i(a)g(SkyF)-7 b(rame)29 b(\(whic)n(h)h(m)n(ust)h(alw)n
(a)n(ys)d(ha)n(v)n(e)h(t)n(w)n(o)g(axes\))h(then)g(the)h(resulting)e(F)
--7 b(rame)30 b(cannot)f(b)r(e)i(a)427 2941 y(v)-5 b(alid)28
+-7 b(rame)30 b(cannot)f(b)r(e)i(a)427 4372 y(v)-5 b(alid)28
b(SkyF)-7 b(rame,)27 b(so)g(will)h(rev)n(ert)e(to)h(the)h(paren)n(t)f
-(class)g(\(F)-7 b(rame\))27 b(instead.)259 3095 y Fc(F)-8
-b(rameSet)427 3194 y Fj(Using)19 b(this)g(function)g(on)g(a)f(F)-7
+(class)g(\(F)-7 b(rame\))27 b(instead.)259 4511 y Fc(F)-8
+b(rameSet)427 4610 y Fj(Using)19 b(this)g(function)g(on)g(a)f(F)-7
b(rameSet)19 b(is)f(iden)n(tical)h(to)f(using)h(it)g(on)f(the)i(curren)
n(t)d(F)-7 b(rame)19 b(in)g(the)g(F)-7 b(rameSet.)427
-3294 y(The)28 b(returned)f(F)-7 b(rame)27 b(will)h(not)g(b)r(e)g(a)f(F)
--7 b(rameSet.)259 3448 y Fc(Region)427 3547 y Fj(If)27
+4710 y(The)28 b(returned)f(F)-7 b(rame)27 b(will)h(not)g(b)r(e)g(a)f(F)
+-7 b(rameSet.)259 4848 y Fc(Region)427 4948 y Fj(If)27
b(this)f(function)h(is)f(used)g(on)g(a)f(Region,)h(an)g(attempt)g(is)g
(made)g(to)g(retain)g(the)g(b)r(ounds)g(information)g(on)427
-3647 y(the)g(selected)e(axes.)36 b(If)25 b(succesful,)g(the)h(returned)
+5048 y(the)g(selected)e(axes.)36 b(If)25 b(succesful,)g(the)h(returned)
e(F)-7 b(rame)25 b(will)g(b)r(e)g(a)g(Region)f(of)h(some)f(class.)35
-b(Otherwise,)427 3747 y(the)j(returned)g(F)-7 b(rame)37
+b(Otherwise,)427 5147 y(the)j(returned)g(F)-7 b(rame)37
b(is)g(obtained)h(b)n(y)f(calling)g(this)h(function)h(on)e(the)h(F)-7
-b(rame)37 b(represen)n(ted)g(b)n(y)g(the)427 3846 y(supplied)c(Region)f
+b(rame)37 b(represen)n(ted)g(b)n(y)g(the)427 5247 y(supplied)c(Region)f
(\(the)h(returned)g(F)-7 b(rame)32 b(will)h(then)g(not)f(b)r(e)h(a)g
(Region\).)51 b(In)33 b(order)e(to)i(b)r(e)g(succesful,)427
-3946 y(the)d(selected)f(axes)g(in)g(the)h(Region)f(m)n(ust)g(b)r(e)h
+5346 y(the)d(selected)f(axes)g(in)g(the)h(Region)f(m)n(ust)g(b)r(e)h
(indep)r(enden)n(t)g(of)f(the)h(others.)41 b(F)-7 b(or)29
-b(instance,)h(a)f(Bo)n(x)f(can)427 4045 y(b)r(e)i(split)g(in)g(this)g
+b(instance,)h(a)f(Bo)n(x)f(can)427 5446 y(b)r(e)i(split)g(in)g(this)g
(w)n(a)n(y)e(but)i(a)f(Circle)g(cannot.)42 b(Another)30
b(requiremen)n(t)e(for)h(success)g(is)g(that)h(no)f(default)427
-4145 y(axes)e(are)g(added)g(\(that)h(is,)g(the)g(AXES)g(arra)n(y)d(m)n
+5546 y(axes)e(are)g(added)g(\(that)h(is,)g(the)g(AXES)g(arra)n(y)d(m)n
(ust)i(not)h(con)n(tain)f(an)n(y)g(zero)f(v)-5 b(alues.)0
-4349 y Fc(Returned)32 b(V)-8 b(alue:)259 4527 y(AST)p
-Ft(_)p Fc(PICKAXES)33 b(=)f(INTEGER)427 4626 y Fj(A)c(p)r(oin)n(ter)f
-(to)h(the)g(new)g(F)-7 b(rame.)0 4830 y Fc(Notes:)340
-5154 y Fi(\017)45 b Fj(The)22 b(new)f(F)-7 b(rame)21
-b(will)h(con)n(tain)f(a)g Ft(")p Fj(deep)p Ft(")g Fj(cop)n(y)f(\(c.f.)
-36 b(AST)p Ft(_)p Fj(COPY\))21 b(of)h(all)f(the)h(data)f(selected)g
-(from)g(the)427 5253 y(original)26 b(F)-7 b(rame.)37
-b(Mo)r(difying)27 b(an)n(y)g(asp)r(ect)g(of)h(the)g(new)g(F)-7
-b(rame)27 b(will)g(therefore)g(not)h(a\013ect)f(the)h(original)427
-5353 y(one.)340 5507 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
-b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
-(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 5606 y(set)28 b(to)f(an)h(error)d(v)-5
-b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-eop end
-%%Page: 309 319
-TeXDict begin 309 318 bop 3643 52 a FG(309)p 0 351 3780
-12 v 0 482 a FA(AST)p Fe(_)p FA(PLOT)1544 483 y Fd(Create)37
-b(a)i(Plot)3081 482 y FA(AST)p Fe(_)p FA(PLOT)0 653 y
-Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g(Plot)g
-(and)h(optionally)f(initialises)g(its)h(attributes.)227
-776 y(A)20 b(Plot)e(is)h(a)g(sp)r(ecialised)g(form)g(of)g(F)-7
-b(rameSet,)20 b(in)g(whic)n(h)f(the)h(base)e(F)-7 b(rame)19
-b(describ)r(es)f(a)h Ft(")p Fj(graphical)p Ft(")e Fj(co)r(ordinate)227
-875 y(system)27 b(and)g(is)h(asso)r(ciated)d(with)j(a)f(rectangular)e
-(plotting)j(area)d(in)j(the)g(underlying)e(graphics)g(system.)37
-b(This)227 975 y(plotting)28 b(area)e(is)i(where)f(graphical)f(output)i
-(app)r(ears.)35 b(It)28 b(is)g(de\014ned)g(when)g(the)g(Plot)f(is)g
-(created.)227 1098 y(The)36 b(curren)n(t)e(F)-7 b(rame)35
-b(of)h(a)f(Plot)g(describ)r(es)g(a)g Ft(")p Fj(ph)n(ysical)p
-Ft(")f Fj(co)r(ordinate)g(system,)j(whic)n(h)f(is)f(the)h(co)r
-(ordinate)227 1197 y(system)41 b(in)h(whic)n(h)f(plotting)h(op)r
-(erations)e(are)g(sp)r(eci\014ed.)79 b(The)41 b(results)g(of)g(eac)n(h)
-g(plotting)g(op)r(eration)g(are)227 1297 y(automatically)26
-b(transformed)f(in)n(to)i(graphical)e(co)r(ordinates)g(so)h(as)g(to)h
-(app)r(ear)e(in)i(the)g(plotting)g(area)e(\(sub)5 b(ject)227
-1397 y(to)28 b(an)n(y)f(clipping)g(whic)n(h)h(ma)n(y)f(b)r(e)h(in)f
-(e\013ect\).)227 1520 y(Because)39 b(the)h(Mapping)g(b)r(et)n(w)n(een)f
-(ph)n(ysical)g(and)h(graphical)e(co)r(ordinates)h(ma)n(y)g(often)h(b)r
-(e)g(non-linear,)h(or)227 1619 y(ev)n(en)f(discon)n(tin)n(uous,)i(most)
-e(plotting)g(do)r(es)g(not)g(result)f(in)i(simple)f(straigh)n(t)f
-(lines.)74 b(The)40 b(basic)g(plotting)227 1719 y(elemen)n(t)g(is)f
-(therefore)f(not)h(a)g(straigh)n(t)f(line,)k(but)e(a)f(geo)r(desic)f
-(curv)n(e)g(\(see)h(AST)p Ft(_)p Fj(CUR)-9 b(VE\).)40
-b(A)f(Plot)g(also)227 1819 y(pro)n(vides)d(facilities)i(for)f(dra)n
-(wing)f(mark)n(ers)g(or)h(sym)n(b)r(ols)g(\(AST)p Ft(_)p
-Fj(MARK\),)h(text)g(\(AST)p Ft(_)p Fj(TEXT\))g(and)f(grid)227
-1918 y(lines)25 b(\(AST)p Ft(_)p Fj(GRIDLINE\).)h(It)f(is)g(also)e(p)r
-(ossible)i(to)g(dra)n(w)e(curvilinear)h(axes)g(with)h(optional)f(co)r
-(ordinate)g(grids)227 2018 y(\(AST)p Ft(_)p Fj(GRID\).)30
-b(A)e(range)f(of)h(Plot)g(attributes)g(is)g(a)n(v)-5
-b(ailable)27 b(to)h(allo)n(w)f(precise)g(con)n(trol)g(o)n(v)n(er)g(the)
-h(app)r(earance)227 2117 y(of)g(graphical)e(output)i(pro)r(duced)f(b)n
-(y)h(these)f(routines.)227 2240 y(Y)-7 b(ou)20 b(ma)n(y)f(select)h
+5718 y Fc(Returned)32 b(V)-8 b(alue:)p eop end
+%%Page: 311 321
+TeXDict begin 311 320 bop 3643 52 a FG(311)259 351 y
+Fc(AST)p Ft(_)p Fc(PICKAXES)33 b(=)f(INTEGER)427 451
+y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(F)-7 b(rame.)0
+619 y Fc(Notes:)340 908 y Fi(\017)45 b Fj(The)22 b(new)f(F)-7
+b(rame)21 b(will)h(con)n(tain)f(a)g Ft(")p Fj(deep)p
+Ft(")g Fj(cop)n(y)f(\(c.f.)36 b(AST)p Ft(_)p Fj(COPY\))21
+b(of)h(all)f(the)h(data)f(selected)g(from)g(the)427 1008
+y(original)26 b(F)-7 b(rame.)37 b(Mo)r(difying)27 b(an)n(y)g(asp)r(ect)
+g(of)h(the)g(new)g(F)-7 b(rame)27 b(will)g(therefore)g(not)h(a\013ect)f
+(the)h(original)427 1108 y(one.)340 1244 y Fi(\017)45
+b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
+Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 1343
+y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 1549 3780 12 v 0 1680
+a FA(AST)p Fe(_)p FA(PLOT)1544 1681 y Fd(Create)37 b(a)i(Plot)3081
+1680 y FA(AST)p Fe(_)p FA(PLOT)0 1863 y Fc(Description:)44
+b Fj(This)28 b(function)g(creates)f(a)g(new)g(Plot)g(and)h(optionally)f
+(initialises)g(its)h(attributes.)227 1991 y(A)20 b(Plot)e(is)h(a)g(sp)r
+(ecialised)g(form)g(of)g(F)-7 b(rameSet,)20 b(in)g(whic)n(h)f(the)h
+(base)e(F)-7 b(rame)19 b(describ)r(es)f(a)h Ft(")p Fj(graphical)p
+Ft(")e Fj(co)r(ordinate)227 2090 y(system)27 b(and)g(is)h(asso)r
+(ciated)d(with)j(a)f(rectangular)e(plotting)j(area)d(in)j(the)g
+(underlying)e(graphics)g(system.)37 b(This)227 2190 y(plotting)28
+b(area)e(is)i(where)f(graphical)f(output)i(app)r(ears.)35
+b(It)28 b(is)g(de\014ned)g(when)g(the)g(Plot)f(is)g(created.)227
+2318 y(The)36 b(curren)n(t)e(F)-7 b(rame)35 b(of)h(a)f(Plot)g(describ)r
+(es)g(a)g Ft(")p Fj(ph)n(ysical)p Ft(")f Fj(co)r(ordinate)g(system,)j
+(whic)n(h)f(is)f(the)h(co)r(ordinate)227 2417 y(system)41
+b(in)h(whic)n(h)f(plotting)h(op)r(erations)e(are)g(sp)r(eci\014ed.)79
+b(The)41 b(results)g(of)g(eac)n(h)g(plotting)g(op)r(eration)g(are)227
+2517 y(automatically)26 b(transformed)f(in)n(to)i(graphical)e(co)r
+(ordinates)g(so)h(as)g(to)h(app)r(ear)e(in)i(the)g(plotting)g(area)e
+(\(sub)5 b(ject)227 2617 y(to)28 b(an)n(y)f(clipping)g(whic)n(h)h(ma)n
+(y)f(b)r(e)h(in)f(e\013ect\).)227 2744 y(Because)39 b(the)h(Mapping)g
+(b)r(et)n(w)n(een)f(ph)n(ysical)g(and)h(graphical)e(co)r(ordinates)h
+(ma)n(y)g(often)h(b)r(e)g(non-linear,)h(or)227 2844 y(ev)n(en)f(discon)
+n(tin)n(uous,)i(most)e(plotting)g(do)r(es)g(not)g(result)f(in)i(simple)
+f(straigh)n(t)f(lines.)74 b(The)40 b(basic)g(plotting)227
+2944 y(elemen)n(t)g(is)f(therefore)f(not)h(a)g(straigh)n(t)f(line,)k
+(but)e(a)f(geo)r(desic)f(curv)n(e)g(\(see)h(AST)p Ft(_)p
+Fj(CUR)-9 b(VE\).)40 b(A)f(Plot)g(also)227 3043 y(pro)n(vides)d
+(facilities)i(for)f(dra)n(wing)f(mark)n(ers)g(or)h(sym)n(b)r(ols)g
+(\(AST)p Ft(_)p Fj(MARK\),)h(text)g(\(AST)p Ft(_)p Fj(TEXT\))g(and)f
+(grid)227 3143 y(lines)25 b(\(AST)p Ft(_)p Fj(GRIDLINE\).)h(It)f(is)g
+(also)e(p)r(ossible)i(to)g(dra)n(w)e(curvilinear)h(axes)g(with)h
+(optional)f(co)r(ordinate)g(grids)227 3243 y(\(AST)p
+Ft(_)p Fj(GRID\).)30 b(A)e(range)f(of)h(Plot)g(attributes)g(is)g(a)n(v)
+-5 b(ailable)27 b(to)h(allo)n(w)f(precise)g(con)n(trol)g(o)n(v)n(er)g
+(the)h(app)r(earance)227 3342 y(of)g(graphical)e(output)i(pro)r(duced)f
+(b)n(y)h(these)f(routines.)227 3470 y(Y)-7 b(ou)20 b(ma)n(y)f(select)h
(di\013eren)n(t)f(ph)n(ysical)g(co)r(ordinate)g(systems)g(in)h(whic)n
(h)f(to)h(plot)g(\(including)g(the)g(nativ)n(e)f(graphical)227
-2340 y(co)r(ordinate)33 b(system)h(itself)6 b(\))35 b(b)n(y)f
+3570 y(co)r(ordinate)33 b(system)h(itself)6 b(\))35 b(b)n(y)f
(selecting)g(di\013eren)n(t)g(F)-7 b(rames)33 b(as)h(the)g(curren)n(t)f
-(F)-7 b(rame)34 b(of)g(a)g(Plot,)h(using)e(its)227 2440
+(F)-7 b(rame)34 b(of)g(a)g(Plot,)h(using)e(its)227 3669
y(Curren)n(t)21 b(attribute.)35 b(Y)-7 b(ou)22 b(ma)n(y)e(also)h(set)g
(up)h(clipping)g(\(see)f(AST)p Ft(_)p Fj(CLIP\))g(to)h(limit)g(the)g
-(exten)n(t)f(of)h(an)n(y)f(plotting)227 2539 y(y)n(ou)26
+(exten)n(t)f(of)h(an)n(y)f(plotting)227 3769 y(y)n(ou)26
b(p)r(erform,)h(and)f(this)h(ma)n(y)f(b)r(e)h(done)f(in)h(an)n(y)f(of)h
(the)g(co)r(ordinate)e(systems)i(asso)r(ciated)e(with)i(the)g(Plot,)g
-(not)227 2639 y(necessarily)f(the)i(one)f(y)n(ou)g(are)g(plotting)g
-(in.)227 2762 y(Lik)n(e)k(an)n(y)f(F)-7 b(rameSet,)32
+(not)227 3868 y(necessarily)f(the)i(one)f(y)n(ou)g(are)g(plotting)g
+(in.)227 3996 y(Lik)n(e)k(an)n(y)f(F)-7 b(rameSet,)32
b(a)f(Plot)g(ma)n(y)f(also)g(b)r(e)i(used)f(as)g(a)f(F)-7
b(rame.)47 b(In)32 b(this)f(case,)h(it)f(b)r(eha)n(v)n(es)f(lik)n(e)h
-(its)g(curren)n(t)227 2862 y(F)-7 b(rame,)27 b(whic)n(h)h(describ)r(es)
-f(the)h(ph)n(ysical)f(co)r(ordinate)f(system.)227 2985
+(its)g(curren)n(t)227 4096 y(F)-7 b(rame,)27 b(whic)n(h)h(describ)r(es)
+f(the)h(ph)n(ysical)f(co)r(ordinate)f(system.)227 4224
y(When)35 b(used)f(as)g(a)g(Mapping,)h(a)f(Plot)g(describ)r(es)f(the)i
(in)n(ter-relation)e(b)r(et)n(w)n(een)h(graphical)e(co)r(ordinates)h
-(\(its)227 3084 y(base)k(F)-7 b(rame\))38 b(and)f(ph)n(ysical)g(co)r
+(\(its)227 4323 y(base)k(F)-7 b(rame\))38 b(and)f(ph)n(ysical)g(co)r
(ordinates)g(\(its)h(curren)n(t)f(F)-7 b(rame\).)67 b(It)38
b(di\013ers)f(from)h(a)f(normal)g(F)-7 b(rameSet,)227
-3184 y(ho)n(w)n(ev)n(er,)29 b(in)h(that)h(an)e(attempt)i(to)f
+4423 y(ho)n(w)n(ev)n(er,)29 b(in)h(that)h(an)e(attempt)i(to)f
(transform)f(p)r(oin)n(ts)h(whic)n(h)g(lie)g(in)h(clipp)r(ed)f(areas)f
-(of)h(the)g(Plot)g(will)g(result)227 3283 y(in)e(bad)g(co)r(ordinate)e
-(v)-5 b(alues)27 b(\(AST)p Ft(__)p Fj(BAD\).)0 3430 y
+(of)h(the)g(Plot)g(will)g(result)227 4523 y(in)e(bad)g(co)r(ordinate)e
+(v)-5 b(alues)27 b(\(AST)p Ft(__)p Fj(BAD\).)0 4679 y
Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_PLOT\()d(FRAME,)h
-(GRAPHBOX,)f(BASEBOX,)g(OPTIONS,)g(STATUS)i(\))0 3576
-y Fc(Argumen)m(ts:)259 3710 y(FRAME)31 b(=)h(INTEGER)g(\(Giv)m(en\))427
-3809 y Fj(P)n(oin)n(ter)h(to)h(a)g(F)-7 b(rame)34 b(describing)g(the)h
+(GRAPHBOX,)f(BASEBOX,)g(OPTIONS,)g(STATUS)i(\))0 4834
+y Fc(Argumen)m(ts:)259 4977 y(FRAME)31 b(=)h(INTEGER)g(\(Giv)m(en\))427
+5077 y Fj(P)n(oin)n(ter)h(to)h(a)g(F)-7 b(rame)34 b(describing)g(the)h
(ph)n(ysical)e(co)r(ordinate)g(system)i(in)f(whic)n(h)h(to)f(plot.)57
-b(A)35 b(p)r(oin)n(ter)427 3909 y(to)29 b(a)g(F)-7 b(rameSet)29
+b(A)35 b(p)r(oin)n(ter)427 5177 y(to)29 b(a)g(F)-7 b(rameSet)29
b(ma)n(y)f(also)g(b)r(e)h(giv)n(en,)g(in)g(whic)n(h)g(case)f(its)i
(curren)n(t)e(F)-7 b(rame)28 b(will)i(b)r(e)f(used)g(to)g(de\014ne)g
-(the)427 4009 y(ph)n(ysical)i(co)r(ordinate)g(system)h(and)g(its)g
+(the)427 5276 y(ph)n(ysical)i(co)r(ordinate)g(system)h(and)g(its)g
(base)f(F)-7 b(rame)31 b(will)i(b)r(e)f(mapp)r(ed)g(on)g(to)g
-(graphical)e(co)r(ordinates)427 4108 y(\(see)e(b)r(elo)n(w\).)427
-4223 y(If)h(a)g(n)n(ull)f(Ob)5 b(ject)29 b(p)r(oin)n(ter)f(\(AST)p
+(graphical)e(co)r(ordinates)427 5376 y(\(see)e(b)r(elo)n(w\).)427
+5494 y(If)h(a)g(n)n(ull)f(Ob)5 b(ject)29 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fj(NULL\))h(is)g(giv)n(en,)f(a)g(default)h(2-dimensional)f(F)-7
-b(rame)28 b(will)h(b)r(e)g(used)427 4322 y(to)35 b(describ)r(e)f(the)h
+b(rame)28 b(will)h(b)r(e)g(used)427 5593 y(to)35 b(describ)r(e)f(the)h
(ph)n(ysical)f(co)r(ordinate)f(system.)58 b(Lab)r(els,)36
b(etc.)58 b(ma)n(y)34 b(then)h(b)r(e)g(attac)n(hed)f(to)h(this)g(b)n(y)
-427 4422 y(setting)28 b(the)g(appropriate)e(F)-7 b(rame)27
-b(attributes)g(\(e.g.)37 b(Lab)r(el\(axis\)\))27 b(for)h(the)g(Plot.)
-259 4552 y Fc(GRAPHBO)m(X\()k(4)g(\))g(=)g(REAL)f(\(Giv)m(en\))427
-4652 y Fj(An)h(arra)n(y)c(giving)i(the)h(p)r(osition)g(and)g(exten)n(t)
-g(of)g(the)g(plotting)g(area)e(\(on)i(the)g(plotting)g(surface)f(of)h
-(the)427 4751 y(underlying)e(graphics)f(system\))i(in)g(whic)n(h)f
-(graphical)f(output)i(is)g(to)f(app)r(ear.)42 b(This)30
-b(m)n(ust)f(b)r(e)h(sp)r(eci\014ed)427 4851 y(using)e(graphical)e(co)r
-(ordinates)g(appropriate)g(to)h(the)h(underlying)f(graphics)f(system.)
-427 4965 y(The)k(\014rst)f(pair)f(of)h(v)-5 b(alues)29
-b(should)g(giv)n(e)f(the)i(co)r(ordinates)e(of)h(the)h(b)r(ottom)f
-(left)h(corner)e(of)h(the)h(plotting)427 5065 y(area)25
-b(and)i(the)g(second)f(pair)g(should)h(giv)n(e)e(the)i(co)r(ordinates)f
-(of)g(the)h(top)g(righ)n(t)f(corner.)35 b(The)27 b(co)r(ordinate)427
-5165 y(on)41 b(the)g(horizon)n(tal)e(axis)h(should)g(b)r(e)i(giv)n(en)d
-(\014rst)i(in)g(eac)n(h)f(pair.)75 b(Note)41 b(that)g(the)g(order)f(in)
-h(whic)n(h)427 5264 y(these)26 b(p)r(oin)n(ts)h(are)e(giv)n(en)g(is)h
-(imp)r(ortan)n(t)g(b)r(ecause)g(it)g(de\014nes)g(up,)h(do)n(wn,)f(left)
-h(and)f(righ)n(t)f(for)h(subsequen)n(t)427 5364 y(graphical)g(op)r
-(erations.)259 5494 y Fc(BASEBO)m(X\()32 b(4)g(\))g(=)g(DOUBLE)g
-(PRECISION)f(\(Giv)m(en\))427 5593 y Fj(An)c(arra)n(y)d(giving)i(the)h
-(co)r(ordinates)e(of)i(t)n(w)n(o)e(p)r(oin)n(ts)i(in)g(the)g(supplied)g
-(F)-7 b(rame)26 b(\(or)f(in)i(the)g(base)f(F)-7 b(rame)26
-b(if)427 5693 y(a)k(F)-7 b(rameSet)31 b(w)n(as)e(supplied\))i(whic)n(h)
-g(corresp)r(ond)d(to)j(the)g(b)r(ottom)f(left)i(and)e(top)g(righ)n(t)g
-(corners)f(of)h(the)p eop end
-%%Page: 310 320
-TeXDict begin 310 319 bop 0 52 a FG(310)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(plotting)25
-b(area,)g(as)f(sp)r(eci\014ed)h(ab)r(o)n(v)n(e.)35 b(This)25
-b(range)f(of)h(co)r(ordinates)e(will)i(b)r(e)h(mapp)r(ed)f(linearly)g
-(on)f(to)h(the)427 451 y(plotting)j(area.)35 b(The)28
-b(co)r(ordinates)e(should)i(b)r(e)g(giv)n(en)e(in)i(the)g(same)f(order)
-f(as)h(ab)r(o)n(v)n(e.)259 584 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g
-Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-683 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h(optional)g
-(comma-separated)e(list)j(of)g(attribute)f(assignmen)n(ts)g(to)427
-783 y(b)r(e)e(used)g(for)f(initialising)h(the)g(new)f(Plot.)40
-b(The)29 b(syn)n(tax)f(used)g(is)h(iden)n(tical)f(to)h(that)g(for)f
-(the)h(AST)p Ft(_)p Fj(SET)427 882 y(routine.)37 b(If)28
-b(no)f(initialisation)g(is)h(required,)e(a)i(blank)f(v)-5
-b(alue)27 b(ma)n(y)g(b)r(e)h(supplied.)259 1015 y Fc(ST)-8
-b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-1115 y Fj(The)c(global)e(status.)0 1276 y Fc(Returned)32
-b(V)-8 b(alue:)259 1412 y(AST)p Ft(_)p Fc(PLOT)427 1512
-y Fj(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Plot.)0
-1674 y Fc(Notes:)340 1956 y Fi(\017)45 b Fj(The)24 b(base)f(F)-7
+427 5693 y(setting)28 b(the)g(appropriate)e(F)-7 b(rame)27
+b(attributes)g(\(e.g.)37 b(Lab)r(el\(axis\)\))27 b(for)h(the)g(Plot.)p
+eop end
+%%Page: 312 322
+TeXDict begin 312 321 bop 0 52 a FG(312)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(GRAPHBO)m(X\()h(4)g
+(\))g(=)g(REAL)f(\(Giv)m(en\))427 451 y Fj(An)h(arra)n(y)c(giving)i
+(the)h(p)r(osition)g(and)g(exten)n(t)g(of)g(the)g(plotting)g(area)e
+(\(on)i(the)g(plotting)g(surface)f(of)h(the)427 551 y(underlying)e
+(graphics)f(system\))i(in)g(whic)n(h)f(graphical)f(output)i(is)g(to)f
+(app)r(ear.)42 b(This)30 b(m)n(ust)f(b)r(e)h(sp)r(eci\014ed)427
+650 y(using)e(graphical)e(co)r(ordinates)g(appropriate)g(to)h(the)h
+(underlying)f(graphics)f(system.)427 780 y(The)k(\014rst)f(pair)f(of)h
+(v)-5 b(alues)29 b(should)g(giv)n(e)f(the)i(co)r(ordinates)e(of)h(the)h
+(b)r(ottom)f(left)h(corner)e(of)h(the)h(plotting)427
+879 y(area)25 b(and)i(the)g(second)f(pair)g(should)h(giv)n(e)e(the)i
+(co)r(ordinates)f(of)g(the)h(top)g(righ)n(t)f(corner.)35
+b(The)27 b(co)r(ordinate)427 979 y(on)41 b(the)g(horizon)n(tal)e(axis)h
+(should)g(b)r(e)i(giv)n(en)d(\014rst)i(in)g(eac)n(h)f(pair.)75
+b(Note)41 b(that)g(the)g(order)f(in)h(whic)n(h)427 1079
+y(these)26 b(p)r(oin)n(ts)h(are)e(giv)n(en)g(is)h(imp)r(ortan)n(t)g(b)r
+(ecause)g(it)g(de\014nes)g(up,)h(do)n(wn,)f(left)h(and)f(righ)n(t)f
+(for)h(subsequen)n(t)427 1178 y(graphical)g(op)r(erations.)259
+1338 y Fc(BASEBO)m(X\()32 b(4)g(\))g(=)g(DOUBLE)g(PRECISION)f(\(Giv)m
+(en\))427 1437 y Fj(An)c(arra)n(y)d(giving)i(the)h(co)r(ordinates)e(of)
+i(t)n(w)n(o)e(p)r(oin)n(ts)i(in)g(the)g(supplied)g(F)-7
+b(rame)26 b(\(or)f(in)i(the)g(base)f(F)-7 b(rame)26 b(if)427
+1537 y(a)k(F)-7 b(rameSet)31 b(w)n(as)e(supplied\))i(whic)n(h)g
+(corresp)r(ond)d(to)j(the)g(b)r(ottom)f(left)i(and)e(top)g(righ)n(t)g
+(corners)f(of)h(the)427 1636 y(plotting)25 b(area,)g(as)f(sp)r
+(eci\014ed)h(ab)r(o)n(v)n(e.)35 b(This)25 b(range)f(of)h(co)r
+(ordinates)e(will)i(b)r(e)h(mapp)r(ed)f(linearly)g(on)f(to)h(the)427
+1736 y(plotting)j(area.)35 b(The)28 b(co)r(ordinates)e(should)i(b)r(e)g
+(giv)n(en)e(in)i(the)g(same)f(order)f(as)h(ab)r(o)n(v)n(e.)259
+1895 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1995 y Fj(A)g(c)n(haracter)e(string)
+h(con)n(taining)f(an)h(optional)g(comma-separated)e(list)j(of)g
+(attribute)f(assignmen)n(ts)g(to)427 2095 y(b)r(e)e(used)g(for)f
+(initialising)h(the)g(new)f(Plot.)40 b(The)29 b(syn)n(tax)f(used)g(is)h
+(iden)n(tical)f(to)h(that)g(for)f(the)h(AST)p Ft(_)p
+Fj(SET)427 2194 y(routine.)37 b(If)28 b(no)f(initialisation)g(is)h
+(required,)e(a)i(blank)f(v)-5 b(alue)27 b(ma)n(y)g(b)r(e)h(supplied.)
+259 2354 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 2453 y Fj(The)c(global)e(status.)0 2668
+y Fc(Returned)32 b(V)-8 b(alue:)259 2858 y(AST)p Ft(_)p
+Fc(PLOT)427 2958 y Fj(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Plot.)0
+3173 y Fc(Notes:)340 3508 y Fi(\017)45 b Fj(The)24 b(base)f(F)-7
b(rame)24 b(of)g(the)g(returned)f(Plot)h(will)g(b)r(e)g(a)g(new)f(F)-7
b(rame)24 b(whic)n(h)g(is)f(created)h(b)n(y)f(this)h(function)h(to)427
-2056 y(represen)n(t)32 b(the)h(co)r(ordinate)f(system)g(of)h(the)g
+3608 y(represen)n(t)32 b(the)h(co)r(ordinate)f(system)g(of)h(the)g
(underlying)f(graphics)g(system)g(\(graphical)g(co)r(ordinates\).)427
-2155 y(It)h(is)g(giv)n(en)f(a)g(F)-7 b(rame)33 b(index)g(of)f(1)h
+3708 y(It)h(is)g(giv)n(en)f(a)g(F)-7 b(rame)33 b(index)g(of)f(1)h
(within)g(the)g(Plot.)52 b(The)33 b(c)n(hoice)f(of)h(base)f(F)-7
-b(rame)32 b(\(Base)g(attribute\))427 2255 y(should)26
+b(rame)32 b(\(Base)g(attribute\))427 3807 y(should)26
b(not,)g(in)g(general,)f(b)r(e)h(c)n(hanged)e(once)h(a)h(Plot)f(has)g
(b)r(een)h(created)f(\(although)g(y)n(ou)g(could)h(use)f(this)427
-2355 y(as)i(a)g(w)n(a)n(y)g(of)g(mo)n(ving)g(the)h(plotting)f(area)g
-(around)f(on)h(the)h(plotting)g(surface\).)340 2487 y
+3907 y(as)i(a)g(w)n(a)n(y)g(of)g(mo)n(ving)g(the)h(plotting)f(area)g
+(around)f(on)h(the)h(plotting)g(surface\).)340 4066 y
Fi(\017)45 b Fj(If)31 b(a)f(F)-7 b(rame)30 b(is)g(supplied)g(\(via)g
(the)h(FRAME)g(p)r(oin)n(ter\),)g(then)f(it)h(b)r(ecomes)f(the)h
-(curren)n(t)e(F)-7 b(rame)30 b(of)g(the)427 2587 y(new)e(Plot)f(and)g
+(curren)n(t)e(F)-7 b(rame)30 b(of)g(the)427 4166 y(new)e(Plot)f(and)g
(is)h(giv)n(en)f(a)g(F)-7 b(rame)27 b(index)h(of)f(2.)340
-2719 y Fi(\017)45 b Fj(If)29 b(a)g(F)-7 b(rameSet)28
+4325 y Fi(\017)45 b Fj(If)29 b(a)g(F)-7 b(rameSet)28
b(is)h(supplied)g(\(via)f(the)h(FRAME)g(p)r(oin)n(ter\),)g(then)h(all)e
(the)h(F)-7 b(rames)28 b(within)h(this)g(F)-7 b(rame-)427
-2819 y(Set)34 b(b)r(ecome)g(part)f(of)h(the)g(new)g(Plot)f(\(where)h
+4425 y(Set)34 b(b)r(ecome)g(part)f(of)h(the)g(new)g(Plot)f(\(where)h
(their)g(F)-7 b(rame)33 b(indices)h(are)f(increased)f(b)n(y)i(1\),)h
-(with)f(the)427 2919 y(F)-7 b(rameSet's)27 b(curren)n(t)g(F)-7
+(with)f(the)427 4524 y(F)-7 b(rameSet's)27 b(curren)n(t)g(F)-7
b(rame)27 b(b)r(ecoming)h(the)g(curren)n(t)e(F)-7 b(rame)27
-b(of)h(the)g(Plot.)340 3051 y Fi(\017)45 b Fj(If)33 b(a)f(n)n(ull)h(Ob)
+b(of)h(the)g(Plot.)340 4684 y Fi(\017)45 b Fj(If)33 b(a)f(n)n(ull)h(Ob)
5 b(ject)32 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fj(NULL\))h(is)f
(supplied)h(\(via)f(the)h(FRAME)f(p)r(oin)n(ter\),)i(then)f(the)f(re-)
-427 3151 y(turned)k(Plot)e(will)i(con)n(tain)e(t)n(w)n(o)h(F)-7
+427 4784 y(turned)k(Plot)e(will)i(con)n(tain)e(t)n(w)n(o)h(F)-7
b(rames,)36 b(b)r(oth)g(created)f(b)n(y)g(this)g(function.)61
-b(The)35 b(base)g(F)-7 b(rame)34 b(will)427 3251 y(describ)r(e)23
+b(The)35 b(base)g(F)-7 b(rame)34 b(will)427 4883 y(describ)r(e)23
b(graphics)f(co)r(ordinates)f(\(as)i(ab)r(o)n(v)n(e\))f(and)h(the)h
(curren)n(t)e(F)-7 b(rame)23 b(will)g(b)r(e)g(a)g(basic)g(F)-7
-b(rame)22 b(with)i(no)427 3350 y(attributes)i(set)g(\(this)h(will)f
+b(rame)22 b(with)i(no)427 4983 y(attributes)i(set)g(\(this)h(will)f
(therefore)f(giv)n(e)g(default)h(v)-5 b(alues)26 b(for)f(suc)n(h)g
-(things)h(as)g(the)g(Plot)f(Title)h(and)g(the)427 3450
+(things)h(as)g(the)g(Plot)f(Title)h(and)g(the)427 5082
y(Lab)r(el)21 b(on)g(eac)n(h)f(axis\).)35 b(Ph)n(ysical)19
b(co)r(ordinates)h(will)h(b)r(e)h(mapp)r(ed)f(linearly)g(on)f(to)h
-(graphical)f(co)r(ordinates.)340 3582 y Fi(\017)45 b
+(graphical)f(co)r(ordinates.)340 5242 y Fi(\017)45 b
Fj(An)29 b(error)e(will)h(result)g(if)h(the)g(F)-7 b(rame)28
b(supplied)h(\(or)f(the)g(base)g(F)-7 b(rame)28 b(if)h(a)f(F)-7
-b(rameSet)28 b(w)n(as)g(supplied\))h(is)427 3682 y(not)f
-(2-dimensional.)340 3815 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+b(rameSet)28 b(w)n(as)g(supplied\))h(is)427 5341 y(not)f
+(2-dimensional.)340 5501 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 3914 y(set)28 b(to)f(an)h(error)d(v)-5
+b(A)g(TUS)427 5600 y(set)28 b(to)f(an)h(error)d(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-0 4113 3780 12 v 0 4244 a FA(AST)p Fe(_)p FA(PLOT3D)1470
-4245 y Fd(Create)38 b(a)g(Plot3D)2911 4244 y FA(AST)p
-Fe(_)p FA(PLOT3D)0 4420 y Fc(Description:)44 b Fj(This)28
-b(function)g(creates)f(a)g(new)g(Plot3D)g(and)h(optionally)f
-(initialises)g(its)h(attributes.)227 4544 y(A)g(Plot3D)f(is)h(a)f(sp)r
-(ecialised)g(form)g(of)h(Plot)f(that)h(pro)n(vides)e(facilities)h(for)h
-(pro)r(ducing)f(3D)g(graphical)f(output.)0 4694 y Fc(In)m(v)m(o)s
-(cation:)123 b Ft(RESULT)41 b(=)i(AST_PLOT3D\()c(FRAME,)i(GRAPHBOX,)f
-(BASEBOX,)g(OPTIONS,)h(STATUS)g(\))0 4843 y Fc(Argumen)m(ts:)259
-4979 y(FRAME)31 b(=)h(INTEGER)g(\(Giv)m(en\))427 5079
-y Fj(P)n(oin)n(ter)h(to)h(a)g(F)-7 b(rame)34 b(describing)g(the)h(ph)n
-(ysical)e(co)r(ordinate)g(system)i(in)f(whic)n(h)h(to)f(plot.)57
-b(A)35 b(p)r(oin)n(ter)427 5178 y(to)29 b(a)g(F)-7 b(rameSet)29
-b(ma)n(y)f(also)g(b)r(e)h(giv)n(en,)g(in)g(whic)n(h)g(case)f(its)i
-(curren)n(t)e(F)-7 b(rame)28 b(will)i(b)r(e)f(used)g(to)g(de\014ne)g
-(the)427 5278 y(ph)n(ysical)i(co)r(ordinate)g(system)h(and)g(its)g
-(base)f(F)-7 b(rame)31 b(will)i(b)r(e)f(mapp)r(ed)g(on)g(to)g
-(graphical)e(co)r(ordinates)427 5378 y(\(see)e(b)r(elo)n(w\).)427
-5494 y(If)h(a)g(n)n(ull)f(Ob)5 b(ject)29 b(p)r(oin)n(ter)f(\(AST)p
+eop end
+%%Page: 313 323
+TeXDict begin 313 322 bop 3643 52 a FG(313)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(PLOT3D)1470 483 y Fd(Create)38
+b(a)g(Plot3D)2911 482 y FA(AST)p Fe(_)p FA(PLOT3D)0 671
+y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+(Plot3D)g(and)h(optionally)f(initialises)g(its)h(attributes.)227
+802 y(A)g(Plot3D)f(is)h(a)f(sp)r(ecialised)g(form)g(of)h(Plot)f(that)h
+(pro)n(vides)e(facilities)h(for)h(pro)r(ducing)f(3D)g(graphical)f
+(output.)0 964 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
+b(=)i(AST_PLOT3D\()c(FRAME,)i(GRAPHBOX,)f(BASEBOX,)g(OPTIONS,)h(STATUS)
+g(\))0 1126 y Fc(Argumen)m(ts:)259 1275 y(FRAME)31 b(=)h(INTEGER)g
+(\(Giv)m(en\))427 1375 y Fj(P)n(oin)n(ter)h(to)h(a)g(F)-7
+b(rame)34 b(describing)g(the)h(ph)n(ysical)e(co)r(ordinate)g(system)i
+(in)f(whic)n(h)h(to)f(plot.)57 b(A)35 b(p)r(oin)n(ter)427
+1475 y(to)29 b(a)g(F)-7 b(rameSet)29 b(ma)n(y)f(also)g(b)r(e)h(giv)n
+(en,)g(in)g(whic)n(h)g(case)f(its)i(curren)n(t)e(F)-7
+b(rame)28 b(will)i(b)r(e)f(used)g(to)g(de\014ne)g(the)427
+1574 y(ph)n(ysical)i(co)r(ordinate)g(system)h(and)g(its)g(base)f(F)-7
+b(rame)31 b(will)i(b)r(e)f(mapp)r(ed)g(on)g(to)g(graphical)e(co)r
+(ordinates)427 1674 y(\(see)e(b)r(elo)n(w\).)427 1793
+y(If)h(a)g(n)n(ull)f(Ob)5 b(ject)29 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fj(NULL\))h(is)g(giv)n(en,)f(a)g(default)h(3-dimensional)f(F)-7
-b(rame)28 b(will)h(b)r(e)g(used)427 5593 y(to)35 b(describ)r(e)f(the)h
+b(rame)28 b(will)h(b)r(e)g(used)427 1893 y(to)35 b(describ)r(e)f(the)h
(ph)n(ysical)f(co)r(ordinate)f(system.)58 b(Lab)r(els,)36
b(etc.)58 b(ma)n(y)34 b(then)h(b)r(e)g(attac)n(hed)f(to)h(this)g(b)n(y)
-427 5693 y(setting)28 b(the)g(appropriate)e(F)-7 b(rame)27
-b(attributes)g(\(e.g.)37 b(Lab)r(el\(axis\)\))27 b(for)h(the)g(Plot.)p
-eop end
-%%Page: 311 321
-TeXDict begin 311 320 bop 3643 52 a FG(311)259 351 y
-Fc(GRAPHBO)m(X\()32 b(6)g(\))g(=)g(REAL)f(\(Giv)m(en\))427
-451 y Fj(An)k(arra)n(y)e(giving)h(the)h(p)r(osition)f(and)h(exten)n(t)f
-(of)h(the)g(plotting)g(v)n(olume)f(\(within)i(the)f(plotting)f(space)
-427 551 y(of)i(the)g(underlying)f(graphics)f(system\))h(in)h(whic)n(h)g
-(graphical)d(output)k(is)e(to)g(app)r(ear.)60 b(This)36
-b(m)n(ust)f(b)r(e)427 650 y(sp)r(eci\014ed)28 b(using)f(graphical)f(co)
-r(ordinates)h(appropriate)e(to)j(the)g(underlying)f(graphics)f(system.)
-427 770 y(The)g(\014rst)g(triple)g(of)g(v)-5 b(alues)26
-b(should)g(giv)n(e)f(the)h(co)r(ordinates)f(of)h(the)g(b)r(ottom)h
-(left)g(corner)d(of)i(the)h(plotting)427 870 y(v)n(olume)i(and)g(the)h
-(second)e(triple)i(should)f(giv)n(e)f(the)i(co)r(ordinates)e(of)h(the)g
-(top)h(righ)n(t)e(corner.)41 b(The)29 b(co)r(or-)427
-969 y(dinate)e(on)f(the)h(horizon)n(tal)e(axis)h(should)g(b)r(e)h(giv)n
-(en)f(\014rst)g(in)h(eac)n(h)f(pair.)35 b(Note)27 b(that)g(the)g(order)
-e(in)i(whic)n(h)427 1069 y(these)f(p)r(oin)n(ts)h(are)e(giv)n(en)g(is)h
-(imp)r(ortan)n(t)g(b)r(ecause)g(it)g(de\014nes)g(up,)h(do)n(wn,)f(left)
-h(and)f(righ)n(t)f(for)h(subsequen)n(t)427 1168 y(graphical)g(op)r
-(erations.)259 1308 y Fc(BASEBO)m(X\()32 b(6)g(\))g(=)g(DOUBLE)g
-(PRECISION)f(\(Giv)m(en\))427 1408 y Fj(An)c(arra)n(y)d(giving)i(the)h
-(co)r(ordinates)e(of)i(t)n(w)n(o)e(p)r(oin)n(ts)i(in)g(the)g(supplied)g
-(F)-7 b(rame)26 b(\(or)f(in)i(the)g(base)f(F)-7 b(rame)26
-b(if)427 1508 y(a)k(F)-7 b(rameSet)31 b(w)n(as)e(supplied\))i(whic)n(h)
-g(corresp)r(ond)d(to)j(the)g(b)r(ottom)f(left)i(and)e(top)g(righ)n(t)g
-(corners)f(of)h(the)427 1607 y(plotting)e(v)n(olume,)f(as)g(sp)r
+427 1992 y(setting)28 b(the)g(appropriate)e(F)-7 b(rame)27
+b(attributes)g(\(e.g.)37 b(Lab)r(el\(axis\)\))27 b(for)h(the)g(Plot.)
+259 2132 y Fc(GRAPHBO)m(X\()k(6)g(\))g(=)g(REAL)f(\(Giv)m(en\))427
+2231 y Fj(An)k(arra)n(y)e(giving)h(the)h(p)r(osition)f(and)h(exten)n(t)
+f(of)h(the)g(plotting)g(v)n(olume)f(\(within)i(the)f(plotting)f(space)
+427 2331 y(of)i(the)g(underlying)f(graphics)f(system\))h(in)h(whic)n(h)
+g(graphical)d(output)k(is)e(to)g(app)r(ear.)60 b(This)36
+b(m)n(ust)f(b)r(e)427 2430 y(sp)r(eci\014ed)28 b(using)f(graphical)f
+(co)r(ordinates)h(appropriate)e(to)j(the)g(underlying)f(graphics)f
+(system.)427 2550 y(The)g(\014rst)g(triple)g(of)g(v)-5
+b(alues)26 b(should)g(giv)n(e)f(the)h(co)r(ordinates)f(of)h(the)g(b)r
+(ottom)h(left)g(corner)d(of)i(the)h(plotting)427 2650
+y(v)n(olume)i(and)g(the)h(second)e(triple)i(should)f(giv)n(e)f(the)i
+(co)r(ordinates)e(of)h(the)g(top)h(righ)n(t)e(corner.)41
+b(The)29 b(co)r(or-)427 2749 y(dinate)e(on)f(the)h(horizon)n(tal)e
+(axis)h(should)g(b)r(e)h(giv)n(en)f(\014rst)g(in)h(eac)n(h)f(pair.)35
+b(Note)27 b(that)g(the)g(order)e(in)i(whic)n(h)427 2849
+y(these)f(p)r(oin)n(ts)h(are)e(giv)n(en)g(is)h(imp)r(ortan)n(t)g(b)r
+(ecause)g(it)g(de\014nes)g(up,)h(do)n(wn,)f(left)h(and)f(righ)n(t)f
+(for)h(subsequen)n(t)427 2948 y(graphical)g(op)r(erations.)259
+3088 y Fc(BASEBO)m(X\()32 b(6)g(\))g(=)g(DOUBLE)g(PRECISION)f(\(Giv)m
+(en\))427 3187 y Fj(An)c(arra)n(y)d(giving)i(the)h(co)r(ordinates)e(of)
+i(t)n(w)n(o)e(p)r(oin)n(ts)i(in)g(the)g(supplied)g(F)-7
+b(rame)26 b(\(or)f(in)i(the)g(base)f(F)-7 b(rame)26 b(if)427
+3287 y(a)k(F)-7 b(rameSet)31 b(w)n(as)e(supplied\))i(whic)n(h)g
+(corresp)r(ond)d(to)j(the)g(b)r(ottom)f(left)i(and)e(top)g(righ)n(t)g
+(corners)f(of)h(the)427 3386 y(plotting)e(v)n(olume,)f(as)g(sp)r
(eci\014ed)h(ab)r(o)n(v)n(e.)36 b(This)27 b(range)g(of)g(co)r
(ordinates)g(will)g(b)r(e)i(mapp)r(ed)f(linearly)e(on)i(to)427
-1707 y(the)g(plotting)g(area.)35 b(The)28 b(co)r(ordinates)e(should)h
+3486 y(the)g(plotting)g(area.)35 b(The)28 b(co)r(ordinates)e(should)h
(b)r(e)h(giv)n(en)f(in)h(the)g(same)f(order)f(as)h(ab)r(o)n(v)n(e.)259
-1847 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1947 y Fj(A)g(c)n(haracter)e(string)
+3625 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 3725 y Fj(A)g(c)n(haracter)e(string)
h(con)n(taining)f(an)h(optional)g(comma-separated)e(list)j(of)g
-(attribute)f(assignmen)n(ts)g(to)427 2046 y(b)r(e)24
+(attribute)f(assignmen)n(ts)g(to)427 3824 y(b)r(e)24
b(used)e(for)h(initialising)f(the)h(new)g(Plot3D.)g(The)g(syn)n(tax)e
(used)i(is)g(iden)n(tical)g(to)f(that)h(for)g(the)g(AST)p
-Ft(_)p Fj(SET)427 2146 y(routine.)37 b(If)28 b(no)f(initialisation)g
+Ft(_)p Fj(SET)427 3924 y(routine.)37 b(If)28 b(no)f(initialisation)g
(is)h(required,)e(a)i(blank)f(v)-5 b(alue)27 b(ma)n(y)g(b)r(e)h
-(supplied.)259 2286 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)
-h(and)g(Returned\))427 2386 y Fj(The)c(global)e(status.)0
-2562 y Fc(Returned)32 b(V)-8 b(alue:)259 2713 y(AST)p
-Ft(_)p Fc(PLOT3D)33 b(=)f(INTEGER)427 2812 y Fj(A)c(p)r(oin)n(ter)f(to)
-h(the)g(new)g(Plot3D.)0 2988 y Fc(Notes:)340 3285 y Fi(\017)45
+(supplied.)259 4063 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)
+h(and)g(Returned\))427 4163 y Fj(The)c(global)e(status.)0
+4337 y Fc(Returned)32 b(V)-8 b(alue:)259 4486 y(AST)p
+Ft(_)p Fc(PLOT3D)33 b(=)f(INTEGER)427 4586 y Fj(A)c(p)r(oin)n(ter)f(to)
+h(the)g(new)g(Plot3D.)0 4761 y Fc(Notes:)340 5056 y Fi(\017)45
b Fj(The)24 b(base)f(F)-7 b(rame)23 b(of)g(the)h(returned)f(Plot3D)g
(will)g(b)r(e)h(a)f(new)h(F)-7 b(rame)23 b(whic)n(h)g(is)g(created)g(b)
-n(y)g(this)h(function)427 3385 y(to)f(represen)n(t)f(the)i(co)r
+n(y)g(this)h(function)427 5155 y(to)f(represen)n(t)f(the)i(co)r
(ordinate)e(system)g(of)h(the)h(underlying)e(graphics)g(system)h
-(\(graphical)f(co)r(ordinates\).)427 3485 y(It)28 b(is)g(giv)n(en)f(a)g
+(\(graphical)f(co)r(ordinates\).)427 5255 y(It)28 b(is)g(giv)n(en)f(a)g
(F)-7 b(rame)28 b(index)f(of)h(1)f(within)i(the)f(Plot3D.)f(The)h(c)n
(hoice)f(of)h(base)f(F)-7 b(rame)27 b(\(Base)g(attribute\))427
-3584 y(should)i(not,)h(in)g(general,)e(b)r(e)i(c)n(hanged)e(once)h(a)g
+5355 y(should)i(not,)h(in)g(general,)e(b)r(e)i(c)n(hanged)e(once)h(a)g
(Plot3D)g(has)g(b)r(een)h(created)e(\(although)h(y)n(ou)g(could)g(use)
-427 3684 y(this)f(as)f(a)g(w)n(a)n(y)g(of)g(mo)n(ving)g(the)h(plotting)
+427 5454 y(this)f(as)f(a)g(w)n(a)n(y)g(of)g(mo)n(ving)g(the)h(plotting)
f(area)f(around)h(on)g(the)h(plotting)g(surface\).)340
-3824 y Fi(\017)45 b Fj(If)31 b(a)f(F)-7 b(rame)30 b(is)g(supplied)g
+5593 y Fi(\017)45 b Fj(If)31 b(a)f(F)-7 b(rame)30 b(is)g(supplied)g
(\(via)g(the)h(FRAME)g(p)r(oin)n(ter\),)g(then)f(it)h(b)r(ecomes)f(the)
-h(curren)n(t)e(F)-7 b(rame)30 b(of)g(the)427 3924 y(new)e(Plot3D)f(and)
-g(is)h(giv)n(en)f(a)g(F)-7 b(rame)27 b(index)h(of)f(2.)340
-4064 y Fi(\017)45 b Fj(If)24 b(a)e(F)-7 b(rameSet)23
-b(is)f(supplied)h(\(via)g(the)g(FRAME)g(p)r(oin)n(ter\),)h(then)f(all)g
-(the)g(F)-7 b(rames)22 b(within)i(this)f(F)-7 b(rameSet)427
-4163 y(b)r(ecome)37 b(part)f(of)h(the)g(new)g(Plot3D)f(\(where)g(their)
-h(F)-7 b(rame)36 b(indices)g(are)g(increased)g(b)n(y)g(1\),)j(with)e
-(the)427 4263 y(F)-7 b(rameSet's)27 b(curren)n(t)g(F)-7
-b(rame)27 b(b)r(ecoming)h(the)g(curren)n(t)e(F)-7 b(rame)27
-b(of)h(the)g(Plot3D.)340 4403 y Fi(\017)45 b Fj(A)n(t)34
-b(least)f(one)g(of)g(the)h(three)g(axes)e(of)h(the)h(curren)n(t)f(F)-7
-b(rame)33 b(m)n(ust)g(b)r(e)h(indep)r(enden)n(t)g(of)g(the)g(other)e(t)
-n(w)n(o)427 4502 y(curren)n(t)27 b(F)-7 b(rame)27 b(axes.)340
-4642 y Fi(\017)45 b Fj(If)33 b(a)f(n)n(ull)h(Ob)5 b(ject)32
+h(curren)n(t)e(F)-7 b(rame)30 b(of)g(the)427 5693 y(new)e(Plot3D)f(and)
+g(is)h(giv)n(en)f(a)g(F)-7 b(rame)27 b(index)h(of)f(2.)p
+eop end
+%%Page: 314 324
+TeXDict begin 314 323 bop 0 52 a FG(314)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(If)24 b(a)e(F)-7 b(rameSet)23 b(is)f(supplied)h(\(via)g(the)g
+(FRAME)g(p)r(oin)n(ter\),)h(then)f(all)g(the)g(F)-7 b(rames)22
+b(within)i(this)f(F)-7 b(rameSet)427 451 y(b)r(ecome)37
+b(part)f(of)h(the)g(new)g(Plot3D)f(\(where)g(their)h(F)-7
+b(rame)36 b(indices)g(are)g(increased)g(b)n(y)g(1\),)j(with)e(the)427
+551 y(F)-7 b(rameSet's)27 b(curren)n(t)g(F)-7 b(rame)27
+b(b)r(ecoming)h(the)g(curren)n(t)e(F)-7 b(rame)27 b(of)h(the)g(Plot3D.)
+340 682 y Fi(\017)45 b Fj(A)n(t)34 b(least)f(one)g(of)g(the)h(three)g
+(axes)e(of)h(the)h(curren)n(t)f(F)-7 b(rame)33 b(m)n(ust)g(b)r(e)h
+(indep)r(enden)n(t)g(of)g(the)g(other)e(t)n(w)n(o)427
+781 y(curren)n(t)27 b(F)-7 b(rame)27 b(axes.)340 913
+y Fi(\017)45 b Fj(If)33 b(a)f(n)n(ull)h(Ob)5 b(ject)32
b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fj(NULL\))h(is)f(supplied)h(\(via)f
(the)h(FRAME)f(p)r(oin)n(ter\),)i(then)f(the)f(re-)427
-4742 y(turned)d(Plot3D)f(will)h(con)n(tain)g(t)n(w)n(o)f(F)-7
+1012 y(turned)d(Plot3D)f(will)h(con)n(tain)g(t)n(w)n(o)f(F)-7
b(rames,)28 b(b)r(oth)h(created)f(b)n(y)h(this)g(function.)41
-b(The)29 b(base)f(F)-7 b(rame)28 b(will)427 4842 y(describ)r(e)j
+b(The)29 b(base)f(F)-7 b(rame)28 b(will)427 1112 y(describ)r(e)j
(graphics)f(co)r(ordinates)f(\(as)i(ab)r(o)n(v)n(e\))f(and)h(the)g
(curren)n(t)f(F)-7 b(rame)31 b(will)g(b)r(e)h(a)e(basic)h(F)-7
-b(rame)30 b(with)427 4941 y(no)h(attributes)h(set)f(\(this)h(will)g
+b(rame)30 b(with)427 1212 y(no)h(attributes)h(set)f(\(this)h(will)g
(therefore)e(giv)n(e)h(default)h(v)-5 b(alues)31 b(for)g(suc)n(h)g
-(things)g(as)g(the)g(Plot3D)g(Title)427 5041 y(and)i(the)g(Lab)r(el)f
+(things)g(as)g(the)g(Plot3D)g(Title)427 1311 y(and)i(the)g(Lab)r(el)f
(on)g(eac)n(h)g(axis\).)52 b(Ph)n(ysical)31 b(co)r(ordinates)g(will)i
(b)r(e)g(mapp)r(ed)g(linearly)e(on)i(to)f(graphical)427
-5141 y(co)r(ordinates.)340 5281 y Fi(\017)45 b Fj(An)29
+1411 y(co)r(ordinates.)340 1542 y Fi(\017)45 b Fj(An)29
b(error)e(will)h(result)g(if)h(the)g(F)-7 b(rame)28 b(supplied)h(\(or)f
(the)g(base)g(F)-7 b(rame)28 b(if)h(a)f(F)-7 b(rameSet)28
-b(w)n(as)g(supplied\))h(is)427 5380 y(not)f(3-dimensional.)340
-5520 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20
+b(w)n(as)g(supplied\))h(is)427 1642 y(not)f(3-dimensional.)340
+1773 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20
b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e
(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 5620 y(set)28 b(to)f(an)h(error)d(v)-5
+b(A)g(TUS)427 1873 y(set)28 b(to)f(an)h(error)d(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-eop end
-%%Page: 312 322
-TeXDict begin 312 321 bop 0 52 a FG(312)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(POINTLIST)341 b Fd(Create)38
-b(a)g(P)m(oin)m(tList)341 b FA(AST)p Fe(_)p FA(POINTLIST)0
-660 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
-(P)n(oin)n(tList)g(ob)5 b(ject)27 b(and)h(optionally)e(initialises)i
-(its)g(attributes.)227 785 y(A)39 b(P)n(oin)n(tList)f(ob)5
-b(ject)39 b(is)f(a)g(sp)r(ecialised)h(t)n(yp)r(e)g(of)f(Region)g(whic)n
-(h)h(represen)n(ts)e(a)i(collection)f(of)g(p)r(oin)n(ts)h(in)g(a)227
-884 y(co)r(ordinate)27 b(F)-7 b(rame.)0 1035 y Fc(In)m(v)m(o)s(cation:)
-123 b Ft(RESULT)41 b(=)i(AST_POINTLIST\()38 b(FRAME,)j(NPNT,)g(COORD,)h
-(DIM,)f(POINTS,)g(UNC,)h(OPTIONS,)e(STATUS)227 1134 y(\))0
-1285 y Fc(Argumen)m(ts:)259 1422 y(FRAME)31 b(=)h(INTEGER)g(\(Giv)m
-(en\))427 1522 y Fj(A)d(p)r(oin)n(ter)g(to)f(the)i(F)-7
+0 2069 3780 12 v 0 2200 a FA(AST)p Fe(_)p FA(POINTLIST)341
+b Fd(Create)38 b(a)g(P)m(oin)m(tList)341 b FA(AST)p Fe(_)p
+FA(POINTLIST)0 2374 y Fc(Description:)44 b Fj(This)28
+b(function)g(creates)f(a)g(new)g(P)n(oin)n(tList)g(ob)5
+b(ject)27 b(and)h(optionally)e(initialises)i(its)g(attributes.)227
+2497 y(A)39 b(P)n(oin)n(tList)f(ob)5 b(ject)39 b(is)f(a)g(sp)r
+(ecialised)h(t)n(yp)r(e)g(of)f(Region)g(whic)n(h)h(represen)n(ts)e(a)i
+(collection)f(of)g(p)r(oin)n(ts)h(in)g(a)227 2597 y(co)r(ordinate)27
+b(F)-7 b(rame.)0 2745 y Fc(In)m(v)m(o)s(cation:)123 b
+Ft(RESULT)41 b(=)i(AST_POINTLIST\()38 b(FRAME,)j(NPNT,)g(COORD,)h(DIM,)
+f(POINTS,)g(UNC,)h(OPTIONS,)e(STATUS)227 2845 y(\))0
+2993 y Fc(Argumen)m(ts:)259 3127 y(FRAME)31 b(=)h(INTEGER)g(\(Giv)m
+(en\))427 3227 y Fj(A)d(p)r(oin)n(ter)g(to)f(the)i(F)-7
b(rame)28 b(in)h(whic)n(h)g(the)g(region)e(is)i(de\014ned.)41
b(A)29 b(deep)g(cop)n(y)f(is)g(tak)n(en)g(of)h(the)g(supplied)427
-1621 y(F)-7 b(rame.)71 b(This)39 b(means)f(that)h(an)n(y)g(subsequen)n
+3327 y(F)-7 b(rame.)71 b(This)39 b(means)f(that)h(an)n(y)g(subsequen)n
(t)f(c)n(hanges)g(made)h(to)f(the)i(F)-7 b(rame)38 b(using)h(the)g
-(supplied)427 1721 y(p)r(oin)n(ter)27 b(will)h(ha)n(v)n(e)f(no)g
-(e\013ect)h(the)g(Region.)259 1854 y Fc(NPNT)k(=)g(INTEGER)f(\(Giv)m
-(en\))427 1954 y Fj(The)d(n)n(um)n(b)r(er)f(of)h(p)r(oin)n(ts)f(in)h
-(the)g(Region.)259 2087 y Fc(NCOORD)j(=)h(INTEGER)f(\(Giv)m(en\))427
-2187 y Fj(The)j(n)n(um)n(b)r(er)g(of)g(co)r(ordinates)f(b)r(eing)h
+(supplied)427 3426 y(p)r(oin)n(ter)27 b(will)h(ha)n(v)n(e)f(no)g
+(e\013ect)h(the)g(Region.)259 3558 y Fc(NPNT)k(=)g(INTEGER)f(\(Giv)m
+(en\))427 3657 y Fj(The)d(n)n(um)n(b)r(er)f(of)h(p)r(oin)n(ts)f(in)h
+(the)g(Region.)259 3789 y Fc(NCOORD)j(=)h(INTEGER)f(\(Giv)m(en\))427
+3888 y Fj(The)j(n)n(um)n(b)r(er)g(of)g(co)r(ordinates)f(b)r(eing)h
(supplied)g(for)f(eac)n(h)h(p)r(oin)n(t.)56 b(This)34
-b(m)n(ust)g(equal)g(the)g(n)n(um)n(b)r(er)g(of)427 2287
+b(m)n(ust)g(equal)g(the)g(n)n(um)n(b)r(er)g(of)427 3988
y(axes)27 b(in)h(the)g(supplied)g(F)-7 b(rame,)27 b(giv)n(en)g(b)n(y)g
-(its)h(Naxes)f(attribute.)259 2420 y Fc(DIM)32 b(=)g(INTEGER)f(\(Giv)m
-(en\))427 2520 y Fj(The)d(n)n(um)n(b)r(er)g(of)g(elemen)n(ts)g(along)e
+(its)h(Naxes)f(attribute.)259 4119 y Fc(DIM)32 b(=)g(INTEGER)f(\(Giv)m
+(en\))427 4219 y Fj(The)d(n)n(um)n(b)r(er)g(of)g(elemen)n(ts)g(along)e
(the)j(\014rst)e(dimension)h(of)g(the)g(POINTS)g(arra)n(y)d(\(whic)n(h)
-j(con)n(tains)f(the)427 2619 y(p)r(oin)n(t)38 b(co)r(ordinates\).)67
+j(con)n(tains)f(the)427 4319 y(p)r(oin)n(t)38 b(co)r(ordinates\).)67
b(This)38 b(v)-5 b(alue)38 b(is)f(required)g(so)h(that)g(the)g(co)r
(ordinate)f(v)-5 b(alues)37 b(can)h(b)r(e)g(correctly)427
-2719 y(lo)r(cated)26 b(if)h(they)f(do)g(not)g(en)n(tirely)g(\014ll)g
+4418 y(lo)r(cated)26 b(if)h(they)f(do)g(not)g(en)n(tirely)g(\014ll)g
(this)h(arra)n(y)-7 b(.)34 b(The)26 b(v)-5 b(alue)26
b(giv)n(en)g(should)g(not)g(b)r(e)g(less)g(than)g(NPNT.)259
-2852 y Fc(POINTS\()32 b(DIM,)g(NCOORD)f(\))h(=)g(DOUBLE)g(PRECISION)f
-(\(Giv)m(en\))427 2952 y Fj(A)e(2-dimensional)e(arra)n(y)f(giving)h
+4550 y Fc(POINTS\()32 b(DIM,)g(NCOORD)f(\))h(=)g(DOUBLE)g(PRECISION)f
+(\(Giv)m(en\))427 4649 y Fj(A)e(2-dimensional)e(arra)n(y)f(giving)h
(the)i(ph)n(ysical)f(co)r(ordinates)f(of)h(the)h(p)r(oin)n(ts.)39
-b(These)28 b(should)g(b)r(e)g(stored)427 3051 y(suc)n(h)23
+b(These)28 b(should)g(b)r(e)g(stored)427 4749 y(suc)n(h)23
b(that)h(the)g(v)-5 b(alue)23 b(of)g(co)r(ordinate)f(n)n(um)n(b)r(er)h
(COORD)g(for)g(p)r(oin)n(t)h(n)n(um)n(b)r(er)f(PNT)g(is)g(found)h(in)f
-(elemen)n(t)427 3151 y(IN\(PNT,COORD\).)259 3284 y Fc(UNC)32
-b(=)g(INTEGER)f(\(Giv)m(en\))427 3384 y Fj(An)i(optional)e(p)r(oin)n
+(elemen)n(t)427 4848 y(IN\(PNT,COORD\).)259 4980 y Fc(UNC)32
+b(=)g(INTEGER)f(\(Giv)m(en\))427 5079 y Fj(An)i(optional)e(p)r(oin)n
(ter)h(to)g(an)g(existing)g(Region)f(whic)n(h)h(sp)r(eci\014es)g(the)h
-(uncertain)n(ties)e(asso)r(ciated)g(with)427 3484 y(eac)n(h)36
+(uncertain)n(ties)e(asso)r(ciated)g(with)427 5179 y(eac)n(h)36
b(p)r(oin)n(t)g(in)h(the)f(P)n(oin)n(tList)f(b)r(eing)i(created.)62
b(The)36 b(uncertain)n(t)n(y)g(at)g(an)n(y)f(p)r(oin)n(t)i(in)f(the)h
-(P)n(oin)n(tList)427 3583 y(is)i(found)g(b)n(y)g(shifting)h(the)f
+(P)n(oin)n(tList)427 5279 y(is)i(found)g(b)n(y)g(shifting)h(the)f
(supplied)g Ft(")p Fj(uncertain)n(t)n(y)p Ft(")e Fj(Region)i(so)f(that)
-h(it)h(is)f(cen)n(tred)f(at)h(the)g(p)r(oin)n(t)427 3683
+h(it)h(is)f(cen)n(tred)f(at)h(the)g(p)r(oin)n(t)427 5378
y(b)r(eing)c(considered.)57 b(The)35 b(area)e(co)n(v)n(ered)g(b)n(y)h
(the)h(shifted)g(uncertain)n(t)n(y)f(Region)g(then)h(represen)n(ts)e
-(the)427 3782 y(uncertain)n(t)n(y)27 b(in)h(the)g(p)r(osition.)37
+(the)427 5478 y(uncertain)n(t)n(y)27 b(in)h(the)g(p)r(osition.)37
b(The)27 b(uncertain)n(t)n(y)g(is)g(assumed)g(to)h(b)r(e)g(the)g(same)f
-(for)g(all)g(p)r(oin)n(ts.)427 3899 y(If)38 b(supplied,)j(the)d
+(for)g(all)g(p)r(oin)n(ts.)427 5593 y(If)38 b(supplied,)j(the)d
(uncertain)n(t)n(y)f(Region)g(m)n(ust)g(b)r(e)i(of)e(a)g(class)g(for)g
-(whic)n(h)h(all)f(instances)g(are)g(cen)n(tro-)427 3999
+(whic)n(h)h(all)f(instances)g(are)g(cen)n(tro-)427 5693
y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24 b(Circle,)g(Ellipse,)h(etc.\))36
b(or)23 b(b)r(e)i(a)e(Prism)h(con)n(taining)f(cen)n(tro-symetric)f
-(comp)r(onen)n(t)427 4098 y(Regions.)57 b(A)35 b(deep)f(cop)n(y)g(of)g
-(the)h(supplied)g(Region)f(will)g(b)r(e)h(tak)n(en,)h(so)e(subsequen)n
-(t)g(c)n(hanges)f(to)h(the)427 4198 y(uncertain)n(t)n(y)g(Region)g
-(using)g(the)h(supplied)g(p)r(oin)n(ter)g(will)f(ha)n(v)n(e)g(no)g
-(e\013ect)h(on)g(the)g(created)f(Bo)n(x.)57 b(Al-)427
-4297 y(ternativ)n(ely)-7 b(,)34 b(a)f(n)n(ull)g(Ob)5
-b(ject)33 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fj(NULL\))g(ma)n(y)f(b)r(e)
-i(supplied,)h(in)e(whic)n(h)g(case)f(a)h(default)427
-4397 y(uncertain)n(t)n(y)23 b(is)g(used)g(equiv)-5 b(alen)n(t)23
-b(to)g(a)f(b)r(o)n(x)h(1.0E-6)e(of)i(the)h(size)e(of)i(the)f(b)r
-(ounding)g(b)r(o)n(x)g(of)g(the)h(P)n(oin)n(tList)427
-4497 y(b)r(eing)k(created.)427 4613 y(The)h(uncertain)n(t)n(y)f(Region)
-g(has)h(t)n(w)n(o)f(uses:)39 b(1\))29 b(when)g(the)g(AST)p
+(comp)r(onen)n(t)p eop end
+%%Page: 315 325
+TeXDict begin 315 324 bop 3643 52 a FG(315)427 351 y
+Fj(Regions.)57 b(A)35 b(deep)f(cop)n(y)g(of)g(the)h(supplied)g(Region)f
+(will)g(b)r(e)h(tak)n(en,)h(so)e(subsequen)n(t)g(c)n(hanges)f(to)h(the)
+427 451 y(uncertain)n(t)n(y)g(Region)g(using)g(the)h(supplied)g(p)r
+(oin)n(ter)g(will)f(ha)n(v)n(e)g(no)g(e\013ect)h(on)g(the)g(created)f
+(Bo)n(x.)57 b(Al-)427 551 y(ternativ)n(ely)-7 b(,)34
+b(a)f(n)n(ull)g(Ob)5 b(ject)33 b(p)r(oin)n(ter)g(\(AST)p
+Ft(__)p Fj(NULL\))g(ma)n(y)f(b)r(e)i(supplied,)h(in)e(whic)n(h)g(case)f
+(a)h(default)427 650 y(uncertain)n(t)n(y)23 b(is)g(used)g(equiv)-5
+b(alen)n(t)23 b(to)g(a)f(b)r(o)n(x)h(1.0E-6)e(of)i(the)h(size)e(of)i
+(the)f(b)r(ounding)g(b)r(o)n(x)g(of)g(the)h(P)n(oin)n(tList)427
+750 y(b)r(eing)k(created.)427 866 y(The)h(uncertain)n(t)n(y)f(Region)g
+(has)h(t)n(w)n(o)f(uses:)39 b(1\))29 b(when)g(the)g(AST)p
Ft(_)p Fj(O)n(VERLAP)f(function)h(compares)e(t)n(w)n(o)427
-4713 y(Regions)j(for)g(equalit)n(y)g(the)h(uncertain)n(t)n(y)f(Region)g
+966 y(Regions)j(for)g(equalit)n(y)g(the)h(uncertain)n(t)n(y)f(Region)g
(is)g(used)h(to)g(determine)f(the)h(tolerance)f(on)g(the)h(com-)427
-4812 y(parison,)23 b(and)g(2\))g(when)g(a)f(Region)h(is)g(mapp)r(ed)g
+1065 y(parison,)23 b(and)g(2\))g(when)g(a)f(Region)h(is)g(mapp)r(ed)g
(in)n(to)g(a)f(di\013eren)n(t)i(co)r(ordinate)d(system)i(and)g
-(subsequen)n(tly)427 4912 y(simpli\014ed)e(\(using)f(AST)p
+(subsequen)n(tly)427 1165 y(simpli\014ed)e(\(using)f(AST)p
Ft(_)p Fj(SIMPLIFY\),)h(the)f(uncertain)n(ties)g(are)f(used)h(to)g
-(determine)g(if)h(the)g(transformed)427 5012 y(b)r(oundary)27
+(determine)g(if)h(the)g(transformed)427 1264 y(b)r(oundary)27
b(can)g(b)r(e)h(accurately)f(represen)n(ted)f(b)n(y)h(a)g(sp)r
-(eci\014c)h(shap)r(e)g(of)f(Region.)259 5145 y Fc(OPTIONS)32
+(eci\014c)h(shap)r(e)g(of)f(Region.)259 1397 y Fc(OPTIONS)32
b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))
-427 5245 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h
+427 1497 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h
(optional)f(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f
-(to)g(b)r(e)427 5344 y(used)j(for)g(initialising)g(the)h(new)f(P)n(oin)
+(to)g(b)r(e)427 1596 y(used)j(for)g(initialising)g(the)h(new)f(P)n(oin)
n(tList.)35 b(The)24 b(syn)n(tax)f(used)h(is)g(iden)n(tical)g(to)g
-(that)h(for)e(the)i(AST)p Ft(_)p Fj(SET)427 5444 y(routine.)259
-5577 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 5677 y Fj(The)c(global)e(status.)p eop
-end
-%%Page: 313 323
-TeXDict begin 313 322 bop 3643 52 a FG(313)0 351 y Fc(Returned)32
-b(V)-8 b(alue:)259 472 y(AST)p Ft(_)p Fc(POINTLIST)34
-b(=)e(INTEGER)427 572 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(P)n
-(oin)n(tList.)0 718 y Fc(Notes:)340 984 y Fi(\017)45
-b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
-Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 1084
-y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)-2 1230 y Fc(Status)33
-b(Handling)n(:)227 1376 y Fj(The)d(protected)g(in)n(terface)f(to)g
-(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
-(of)g(the)g(parameter)227 1476 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
-(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
-(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
-Fj(in)n(t)227 1575 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p
-0 1743 3780 12 v 0 1874 a FA(AST)p Fe(_)p FA(POL)-11
-b(YCUR)c(VE)1480 1875 y Fd(Dra)m(w)38 b(a)h(series)f(of)1407
-1974 y(connected)g(geo)s(desic)1730 2074 y(curv)m(es)2608
-1874 y FA(AST)p Fe(_)p FA(POL)-11 b(YCUR)c(VE)0 2208
-y Fc(Description:)44 b Fj(This)22 b(routine)g(joins)g(a)f(series)g(of)h
-(p)r(oin)n(ts)g(sp)r(eci\014ed)g(in)g(the)h(ph)n(ysical)e(co)r
-(ordinate)f(system)i(of)g(a)g(Plot)f(b)n(y)227 2308 y(dra)n(wing)d(a)h
-(sequence)g(of)g(geo)r(desic)f(curv)n(es.)33 b(It)20
-b(is)f(equiv)-5 b(alen)n(t)19 b(to)g(making)f(rep)r(eated)h(calls)g(to)
-g(the)h(AST)p Ft(_)p Fj(CUR)-9 b(VE)227 2407 y(routine)23
-b(\(q.v.\),)h(except)g(that)f(AST)p Ft(_)p Fj(POL)-7
-b(YCUR)e(VE)22 b(will)i(generally)d(b)r(e)j(more)e(e\016cien)n(t)h
-(when)h(dra)n(wing)d(man)n(y)227 2507 y(geo)r(desic)27
-b(curv)n(es)f(end-to-end.)37 b(A)28 b(t)n(ypical)f(application)g(of)g
-(this)h(migh)n(t)g(b)r(e)g(in)g(dra)n(wing)e(con)n(tour)g(lines.)227
-2623 y(As)i(with)f(AST)p Ft(_)p Fj(CUR)-9 b(VE,)27 b(full)h(accoun)n(t)
-f(is)g(tak)n(en)f(of)i(the)f(Mapping)g(b)r(et)n(w)n(een)g(ph)n(ysical)f
-(and)i(graphical)d(co)r(or-)227 2723 y(dinate)j(systems.)36
-b(This)28 b(includes)g(an)n(y)e(discon)n(tin)n(uities)i(and)f(clipping)
-h(established)f(using)g(AST)p Ft(_)p Fj(CLIP)-7 b(.)0
-2857 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_POLYCURVE\()37
-b(THIS,)42 b(NPOINT,)f(NCOORD,)f(INDIM,)h(IN,)i(STATUS)e(\))0
-2990 y Fc(Argumen)m(ts:)259 3111 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 3211 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259
-3328 y Fc(NPOINT)k(=)g(INTEGER)f(\(Giv)m(en\))427 3427
-y Fj(The)d(n)n(um)n(b)r(er)f(of)h(p)r(oin)n(ts)f(b)r(et)n(w)n(een)h
-(whic)n(h)f(geo)r(desic)g(curv)n(es)f(are)h(to)h(b)r(e)g(dra)n(wn.)259
-3544 y Fc(NCOORD)j(=)h(INTEGER)f(\(Giv)m(en\))427 3644
-y Fj(The)37 b(n)n(um)n(b)r(er)f(of)h(co)r(ordinates)e(b)r(eing)h
-(supplied)h(for)f(eac)n(h)g(p)r(oin)n(t)g(\(i.e.)64 b(the)37
-b(n)n(um)n(b)r(er)f(of)h(axes)e(in)i(the)427 3744 y(curren)n(t)27
-b(F)-7 b(rame)27 b(of)h(the)g(Plot,)f(as)g(giv)n(en)f(b)n(y)i(its)f
-(Naxes)g(attribute\).)259 3861 y Fc(INDIM)32 b(=)g(INTEGER)f(\(Giv)m
-(en\))427 3960 y Fj(The)e(n)n(um)n(b)r(er)f(of)g(elemen)n(ts)g(along)f
-(the)i(\014rst)f(dimension)g(of)g(the)h(IN)f(arra)n(y)e(\(whic)n(h)j
-(con)n(tains)e(the)i(input)427 4060 y(co)r(ordinates\).)37
+(that)h(for)e(the)i(AST)p Ft(_)p Fj(SET)427 1696 y(routine.)259
+1829 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 1928 y Fj(The)c(global)e(status.)0 2090
+y Fc(Returned)32 b(V)-8 b(alue:)259 2226 y(AST)p Ft(_)p
+Fc(POINTLIST)34 b(=)e(INTEGER)427 2326 y Fj(A)c(p)r(oin)n(ter)f(to)h
+(the)g(new)g(P)n(oin)n(tList.)0 2487 y Fc(Notes:)340
+2770 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20
+b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e
+(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
+b(A)g(TUS)427 2869 y(set)28 b(to)f(an)h(error)d(v)-5
+b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)-2
+3031 y Fc(Status)33 b(Handling)n(:)227 3177 y Fj(The)d(protected)g(in)n
+(terface)f(to)g(this)h(function)h(includes)f(an)f(extra)g(parameter)f
+(at)i(the)g(end)g(of)g(the)g(parameter)227 3277 y(list)37
+b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)
+r(oin)n(ter)g(to)h(the)g(in)n(teger)e(inherited)i(status)f(v)-5
+b(ariable:)54 b Ft(")p Fj(in)n(t)227 3376 y Fi(\003)p
+Fj(status)p Ft(")p Fj(.)p 0 3575 3780 12 v 0 3706 a FA(AST)p
+Fe(_)p FA(POL)-11 b(YCUR)c(VE)1480 3707 y Fd(Dra)m(w)38
+b(a)h(series)f(of)1407 3807 y(connected)g(geo)s(desic)1730
+3906 y(curv)m(es)2608 3706 y FA(AST)p Fe(_)p FA(POL)-11
+b(YCUR)c(VE)0 4072 y Fc(Description:)44 b Fj(This)22
+b(routine)g(joins)g(a)f(series)g(of)h(p)r(oin)n(ts)g(sp)r(eci\014ed)g
+(in)g(the)h(ph)n(ysical)e(co)r(ordinate)f(system)i(of)g(a)g(Plot)f(b)n
+(y)227 4171 y(dra)n(wing)d(a)h(sequence)g(of)g(geo)r(desic)f(curv)n
+(es.)33 b(It)20 b(is)f(equiv)-5 b(alen)n(t)19 b(to)g(making)f(rep)r
+(eated)h(calls)g(to)g(the)h(AST)p Ft(_)p Fj(CUR)-9 b(VE)227
+4271 y(routine)23 b(\(q.v.\),)h(except)g(that)f(AST)p
+Ft(_)p Fj(POL)-7 b(YCUR)e(VE)22 b(will)i(generally)d(b)r(e)j(more)e
+(e\016cien)n(t)h(when)h(dra)n(wing)d(man)n(y)227 4370
+y(geo)r(desic)27 b(curv)n(es)f(end-to-end.)37 b(A)28
+b(t)n(ypical)f(application)g(of)g(this)h(migh)n(t)g(b)r(e)g(in)g(dra)n
+(wing)e(con)n(tour)g(lines.)227 4495 y(As)i(with)f(AST)p
+Ft(_)p Fj(CUR)-9 b(VE,)27 b(full)h(accoun)n(t)f(is)g(tak)n(en)f(of)i
+(the)f(Mapping)g(b)r(et)n(w)n(een)g(ph)n(ysical)f(and)i(graphical)d(co)
+r(or-)227 4594 y(dinate)j(systems.)36 b(This)28 b(includes)g(an)n(y)e
+(discon)n(tin)n(uities)i(and)f(clipping)h(established)f(using)g(AST)p
+Ft(_)p Fj(CLIP)-7 b(.)0 4744 y Fc(In)m(v)m(o)s(cation:)123
+b Ft(CALL)42 b(AST_POLYCURVE\()37 b(THIS,)42 b(NPOINT,)f(NCOORD,)f
+(INDIM,)h(IN,)i(STATUS)e(\))0 4893 y Fc(Argumen)m(ts:)259
+5029 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 5129
+y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259 5261 y Fc(NPOINT)k(=)g
+(INTEGER)f(\(Giv)m(en\))427 5361 y Fj(The)d(n)n(um)n(b)r(er)f(of)h(p)r
+(oin)n(ts)f(b)r(et)n(w)n(een)h(whic)n(h)f(geo)r(desic)g(curv)n(es)f
+(are)h(to)h(b)r(e)g(dra)n(wn.)259 5494 y Fc(NCOORD)j(=)h(INTEGER)f
+(\(Giv)m(en\))427 5593 y Fj(The)37 b(n)n(um)n(b)r(er)f(of)h(co)r
+(ordinates)e(b)r(eing)h(supplied)h(for)f(eac)n(h)g(p)r(oin)n(t)g
+(\(i.e.)64 b(the)37 b(n)n(um)n(b)r(er)f(of)h(axes)e(in)i(the)427
+5693 y(curren)n(t)27 b(F)-7 b(rame)27 b(of)h(the)g(Plot,)f(as)g(giv)n
+(en)f(b)n(y)i(its)f(Naxes)g(attribute\).)p eop end
+%%Page: 316 326
+TeXDict begin 316 325 bop 0 52 a FG(316)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(INDIM)h(=)g(INTEGER)f
+(\(Giv)m(en\))427 451 y Fj(The)e(n)n(um)n(b)r(er)f(of)g(elemen)n(ts)g
+(along)f(the)i(\014rst)f(dimension)g(of)g(the)h(IN)f(arra)n(y)e(\(whic)
+n(h)j(con)n(tains)e(the)i(input)427 551 y(co)r(ordinates\).)37
b(This)28 b(v)-5 b(alue)28 b(is)g(required)f(so)h(that)g(the)g(co)r
(ordinate)f(v)-5 b(alues)28 b(can)f(b)r(e)i(correctly)d(lo)r(cated)i
-(if)427 4160 y(they)g(do)f(not)h(en)n(tirely)f(\014ll)h(this)g(arra)n
-(y)-7 b(.)34 b(The)28 b(v)-5 b(alue)28 b(giv)n(en)e(should)i(not)f(b)r
-(e)h(less)f(than)h(NPOINT.)259 4277 y Fc(IN\()k(INDIM,)f(NCOORD)g(\))h
-(=)g(DOUBLE)g(PRECISION)g(\(Giv)m(en\))427 4376 y Fj(A)h(2-dimensional)
-f(arra)n(y)e(giving)i(the)h(ph)n(ysical)f(co)r(ordinates)g(of)g(the)h
-(p)r(oin)n(ts)g(whic)n(h)g(are)f(to)g(b)r(e)h(joined)427
-4476 y(in)i(sequence)g(b)n(y)g(geo)r(desic)e(curv)n(es.)58
+(if)427 650 y(they)g(do)f(not)h(en)n(tirely)f(\014ll)h(this)g(arra)n(y)
+-7 b(.)34 b(The)28 b(v)-5 b(alue)28 b(giv)n(en)e(should)i(not)f(b)r(e)h
+(less)f(than)h(NPOINT.)259 792 y Fc(IN\()k(INDIM,)f(NCOORD)g(\))h(=)g
+(DOUBLE)g(PRECISION)g(\(Giv)m(en\))427 892 y Fj(A)h(2-dimensional)f
+(arra)n(y)e(giving)i(the)h(ph)n(ysical)f(co)r(ordinates)g(of)g(the)h(p)
+r(oin)n(ts)g(whic)n(h)g(are)f(to)g(b)r(e)h(joined)427
+992 y(in)i(sequence)g(b)n(y)g(geo)r(desic)e(curv)n(es.)58
b(These)35 b(should)g(b)r(e)g(stored)f(suc)n(h)h(that)g(the)g(v)-5
-b(alue)35 b(of)g(co)r(ordinate)427 4575 y(n)n(um)n(b)r(er)28
+b(alue)35 b(of)g(co)r(ordinate)427 1091 y(n)n(um)n(b)r(er)28
b(COORD)f(for)g(input)h(p)r(oin)n(t)g(n)n(um)n(b)r(er)g(POINT)e(is)i
-(found)g(in)g(elemen)n(t)f(IN\(POINT,COORD\).)259 4692
+(found)g(in)g(elemen)n(t)f(IN\(POINT,COORD\).)259 1233
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 4792 y Fj(The)c(global)e(status.)0 4938 y Fc(Notes:)340
-5205 y Fi(\017)45 b Fj(No)32 b(curv)n(e)f(is)i(dra)n(wn)e(on)h(either)g
+427 1333 y Fj(The)c(global)e(status.)0 1514 y Fc(Notes:)340
+1815 y Fi(\017)45 b Fj(No)32 b(curv)n(e)f(is)i(dra)n(wn)e(on)h(either)g
(side)g(of)g(an)n(y)f(p)r(oin)n(t)h(whic)n(h)h(has)e(an)n(y)h(co)r
-(ordinate)f(equal)g(to)h(the)h(v)-5 b(alue)427 5305 y(AST)p
-Ft(__)p Fj(BAD.)340 5422 y Fi(\017)45 b Fj(An)28 b(error)e(results)h
+(ordinate)f(equal)g(to)h(the)h(v)-5 b(alue)427 1915 y(AST)p
+Ft(__)p Fj(BAD.)340 2057 y Fi(\017)45 b Fj(An)28 b(error)e(results)h
(if)h(the)g(base)f(F)-7 b(rame)27 b(of)h(the)g(Plot)f(is)g(not)h
-(2-dimensional.)340 5539 y Fi(\017)45 b Fj(An)30 b(error)d(also)g
+(2-dimensional.)340 2199 y Fi(\017)45 b Fj(An)30 b(error)d(also)g
(results)i(if)g(the)g(transformation)f(b)r(et)n(w)n(een)h(the)g(curren)
n(t)f(and)h(base)f(F)-7 b(rames)28 b(of)h(the)g(Plot)427
-5638 y(is)f(not)f(de\014ned)h(\(i.e.)38 b(the)28 b(Plot's)e(T)-7
-b(ranIn)n(v)n(erse)26 b(attribute)h(is)h(zero\).)p eop
-end
-%%Page: 314 324
-TeXDict begin 314 323 bop 0 52 a FG(314)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(POL)-11 b(YGON)1447 483
-y Fd(Create)37 b(a)h(P)m(olygon)2772 482 y FA(AST)p Fe(_)p
-FA(POL)-11 b(YGON)0 669 y Fc(Description:)44 b Fj(This)28
-b(function)g(creates)f(a)g(new)g(P)n(olygon)f(ob)5 b(ject)27
-b(and)h(optionally)e(initialises)i(its)f(attributes.)227
-793 y(The)36 b(P)n(olygon)d(class)i(implemen)n(ts)g(a)g(p)r(olygonal)f
+2299 y(is)f(not)f(de\014ned)h(\(i.e.)38 b(the)28 b(Plot's)e(T)-7
+b(ranIn)n(v)n(erse)26 b(attribute)h(is)h(zero\).)p 0
+2517 3780 12 v 0 2647 a FA(AST)p Fe(_)p FA(POL)-11 b(YGON)1447
+2648 y Fd(Create)37 b(a)h(P)m(olygon)2772 2647 y FA(AST)p
+Fe(_)p FA(POL)-11 b(YGON)0 2856 y Fc(Description:)44
+b Fj(This)28 b(function)g(creates)f(a)g(new)g(P)n(olygon)f(ob)5
+b(ject)27 b(and)h(optionally)e(initialises)i(its)f(attributes.)227
+2990 y(The)36 b(P)n(olygon)d(class)i(implemen)n(ts)g(a)g(p)r(olygonal)f
(area,)i(de\014ned)g(b)n(y)f(a)h(collection)e(of)i(v)n(ertices,)g
-(within)g(a)f(2-)227 893 y(dimensional)20 b(F)-7 b(rame.)34
+(within)g(a)f(2-)227 3089 y(dimensional)20 b(F)-7 b(rame.)34
b(The)21 b(v)n(ertices)e(are)h(connected)g(together)g(b)n(y)g(geo)r
(desic)g(curv)n(es)f(within)i(the)g(encapsulated)227
-992 y(F)-7 b(rame.)34 b(F)-7 b(or)20 b(instance,)i(if)f(the)g
+3189 y(F)-7 b(rame.)34 b(F)-7 b(or)20 b(instance,)i(if)f(the)g
(encapsulated)f(F)-7 b(rame)21 b(is)f(a)g(simple)h(F)-7
b(rame)20 b(then)h(the)g(geo)r(desics)f(will)h(b)r(e)g(straigh)n(t)227
-1092 y(lines,)33 b(but)f(if)g(the)g(F)-7 b(rame)31 b(is)h(a)f(SkyF)-7
+3289 y(lines,)33 b(but)f(if)g(the)g(F)-7 b(rame)31 b(is)h(a)f(SkyF)-7
b(rame)31 b(then)h(the)g(geo)r(desics)e(will)i(b)r(e)g(great)e
-(circles.)48 b(Note,)33 b(the)f(v)n(ertices)227 1192
+(circles.)48 b(Note,)33 b(the)f(v)n(ertices)227 3388
y(m)n(ust)d(b)r(e)g(supplied)g(in)g(an)f(order)f(suc)n(h)i(that)g(the)g
(inside)f(of)h(the)g(p)r(olygon)f(is)g(to)h(the)g(left)g(of)f(the)h(b)r
-(oundary)f(as)227 1291 y(the)f(v)n(ertices)e(are)h(tra)n(v)n(ersed.)34
+(oundary)f(as)227 3488 y(the)f(v)n(ertices)e(are)h(tra)n(v)n(ersed.)34
b(Supplying)26 b(them)h(in)g(the)g(rev)n(erse)d(order)h(will)i
-(e\013ectiv)n(ely)f(negate)g(the)h(p)r(olygon.)227 1415
+(e\013ectiv)n(ely)f(negate)g(the)h(p)r(olygon.)227 3622
y(Within)33 b(a)e(SkyF)-7 b(rame,)32 b(neigh)n(b)r(ouring)e(v)n
(ertices)g(are)h(alw)n(a)n(ys)e(joined)j(using)f(the)h(shortest)e
-(path.)49 b(Th)n(us)31 b(if)h(an)227 1515 y(edge)f(of)g(180)f(degrees)g
+(path.)49 b(Th)n(us)31 b(if)h(an)227 3722 y(edge)f(of)g(180)f(degrees)g
(or)g(more)g(in)i(length)f(is)g(required,)g(it)h(should)e(b)r(e)i
(split)g(in)n(to)e(section)h(eac)n(h)g(of)g(whic)n(h)g(is)227
-1615 y(less)k(than)h(180)e(degrees.)59 b(The)35 b(closed)g(path)g
+3821 y(less)k(than)h(180)e(degrees.)59 b(The)35 b(closed)g(path)g
(joining)g(all)h(the)f(v)n(ertices)g(in)g(order)f(will)i(divide)f(the)h
-(celestial)227 1714 y(sphere)f(in)n(to)h(t)n(w)n(o)f(disjoin)n(t)h
+(celestial)227 3921 y(sphere)f(in)n(to)h(t)n(w)n(o)f(disjoin)n(t)h
(regions.)60 b(The)36 b(inside)g(of)g(the)g(p)r(olygon)f(is)g(the)h
-(region)f(whic)n(h)h(is)f(circled)h(in)g(an)227 1814
+(region)f(whic)n(h)h(is)f(circled)h(in)g(an)227 4020
y(an)n(ti-clo)r(c)n(kwise)25 b(manner)h(\(when)i(view)n(ed)e(from)g
(the)h(inside)g(of)g(the)g(celestial)f(sphere\))h(when)g(mo)n(ving)e
-(through)227 1913 y(the)h(list)f(of)g(v)n(ertices)f(in)i(the)f(order)f
+(through)227 4120 y(the)h(list)f(of)g(v)n(ertices)f(in)i(the)f(order)f
(in)h(whic)n(h)g(they)h(w)n(ere)e(supplied)h(when)h(the)f(P)n(olygon)e
-(w)n(as)h(created)h(\(i.e.)36 b(the)227 2013 y(inside)28
+(w)n(as)h(created)h(\(i.e.)36 b(the)227 4220 y(inside)28
b(is)f(to)h(the)g(left)g(of)g(the)g(b)r(oundary)f(when)g(mo)n(ving)g
(through)g(the)h(v)n(ertices)e(in)i(the)g(order)e(supplied\).)0
-2161 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_POLYGON\()c
+4388 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_POLYGON\()c
(FRAME,)i(NPNT,)g(DIM,)h(POINTS,)f(UNC,)h(OPTIONS,)e(STATUS)h(\))0
-2309 y Fc(Argumen)m(ts:)259 2445 y(FRAME)31 b(=)h(INTEGER)g(\(Giv)m
-(en\))427 2544 y Fj(A)e(p)r(oin)n(ter)f(to)g(the)g(F)-7
+4556 y Fc(Argumen)m(ts:)259 4711 y(FRAME)31 b(=)h(INTEGER)g(\(Giv)m
+(en\))427 4811 y Fj(A)e(p)r(oin)n(ter)f(to)g(the)g(F)-7
b(rame)29 b(in)g(whic)n(h)g(the)h(region)e(is)h(de\014ned.)42
b(It)30 b(m)n(ust)f(ha)n(v)n(e)f(exactly)g(2)h(axes.)41
-b(A)29 b(deep)427 2644 y(cop)n(y)h(is)g(tak)n(en)f(of)i(the)f(supplied)
+b(A)29 b(deep)427 4910 y(cop)n(y)h(is)g(tak)n(en)f(of)i(the)f(supplied)
h(F)-7 b(rame.)44 b(This)30 b(means)g(that)h(an)n(y)e(subsequen)n(t)h
-(c)n(hanges)f(made)h(to)g(the)427 2744 y(F)-7 b(rame)27
+(c)n(hanges)f(made)h(to)g(the)427 5010 y(F)-7 b(rame)27
b(using)h(the)g(supplied)f(p)r(oin)n(ter)h(will)g(ha)n(v)n(e)e(no)h
-(e\013ect)h(the)g(Region.)259 2875 y Fc(NPNT)k(=)g(INTEGER)f(\(Giv)m
-(en\))427 2975 y Fj(The)d(n)n(um)n(b)r(er)f(of)h(p)r(oin)n(ts)f(in)h
-(the)g(Region.)259 3106 y Fc(DIM)k(=)g(INTEGER)f(\(Giv)m(en\))427
-3206 y Fj(The)d(n)n(um)n(b)r(er)g(of)g(elemen)n(ts)g(along)e(the)j
+(e\013ect)h(the)g(Region.)259 5152 y Fc(NPNT)k(=)g(INTEGER)f(\(Giv)m
+(en\))427 5252 y Fj(The)d(n)n(um)n(b)r(er)f(of)h(p)r(oin)n(ts)f(in)h
+(the)g(Region.)259 5394 y Fc(DIM)k(=)g(INTEGER)f(\(Giv)m(en\))427
+5494 y Fj(The)d(n)n(um)n(b)r(er)g(of)g(elemen)n(ts)g(along)e(the)j
(\014rst)e(dimension)h(of)g(the)g(POINTS)g(arra)n(y)d(\(whic)n(h)j(con)
-n(tains)f(the)427 3306 y(p)r(oin)n(t)38 b(co)r(ordinates\).)67
+n(tains)f(the)427 5593 y(p)r(oin)n(t)38 b(co)r(ordinates\).)67
b(This)38 b(v)-5 b(alue)38 b(is)f(required)g(so)h(that)g(the)g(co)r
(ordinate)f(v)-5 b(alues)37 b(can)h(b)r(e)g(correctly)427
-3405 y(lo)r(cated)26 b(if)h(they)f(do)g(not)g(en)n(tirely)g(\014ll)g
+5693 y(lo)r(cated)26 b(if)h(they)f(do)g(not)g(en)n(tirely)g(\014ll)g
(this)h(arra)n(y)-7 b(.)34 b(The)26 b(v)-5 b(alue)26
-b(giv)n(en)g(should)g(not)g(b)r(e)g(less)g(than)g(NPNT.)259
-3537 y Fc(POINTS\()32 b(DIM,)g(2)f(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)
-m(en\))427 3637 y Fj(A)25 b(2-dimensional)e(arra)n(y)f(giving)i(the)g
-(ph)n(ysical)g(co)r(ordinates)f(of)h(the)h(v)n(ertices.)34
-b(These)25 b(should)f(b)r(e)g(stored)427 3736 y(suc)n(h)f(that)h(the)g
+b(giv)n(en)g(should)g(not)g(b)r(e)g(less)g(than)g(NPNT.)p
+eop end
+%%Page: 317 327
+TeXDict begin 317 326 bop 3643 52 a FG(317)259 351 y
+Fc(POINTS\()32 b(DIM,)g(2)f(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m(en\))
+427 451 y Fj(A)25 b(2-dimensional)e(arra)n(y)f(giving)i(the)g(ph)n
+(ysical)g(co)r(ordinates)f(of)h(the)h(v)n(ertices.)34
+b(These)25 b(should)f(b)r(e)g(stored)427 551 y(suc)n(h)f(that)h(the)g
(v)-5 b(alue)23 b(of)g(co)r(ordinate)f(n)n(um)n(b)r(er)h(COORD)g(for)g
(p)r(oin)n(t)h(n)n(um)n(b)r(er)f(PNT)g(is)g(found)h(in)f(elemen)n(t)427
-3836 y(IN\(PNT,COORD\).)259 3967 y Fc(UNC)32 b(=)g(INTEGER)f(\(Giv)m
-(en\))427 4067 y Fj(An)i(optional)e(p)r(oin)n(ter)h(to)g(an)g(existing)
-g(Region)f(whic)n(h)h(sp)r(eci\014es)g(the)h(uncertain)n(ties)e(asso)r
-(ciated)g(with)427 4167 y(the)j(b)r(oundary)f(of)g(the)h(Bo)n(x)f(b)r
+650 y(IN\(PNT,COORD\).)259 784 y Fc(UNC)32 b(=)g(INTEGER)f(\(Giv)m
+(en\))427 884 y Fj(An)i(optional)e(p)r(oin)n(ter)h(to)g(an)g(existing)g
+(Region)f(whic)n(h)h(sp)r(eci\014es)g(the)h(uncertain)n(ties)e(asso)r
+(ciated)g(with)427 984 y(the)j(b)r(oundary)f(of)g(the)h(Bo)n(x)f(b)r
(eing)g(created.)54 b(The)34 b(uncertain)n(t)n(y)e(in)i(an)n(y)f(p)r
-(oin)n(t)h(on)f(the)h(b)r(oundary)f(of)427 4266 y(the)g(Bo)n(x)e(is)h
+(oin)n(t)h(on)f(the)h(b)r(oundary)f(of)427 1083 y(the)g(Bo)n(x)e(is)h
(found)h(b)n(y)f(shifting)h(the)f(supplied)h Ft(")p Fj(uncertain)n(t)n
(y)p Ft(")e Fj(Region)g(so)h(that)g(it)h(is)f(cen)n(tred)g(at)g(the)427
-4366 y(b)r(oundary)e(p)r(oin)n(t)h(b)r(eing)g(considered.)44
+1183 y(b)r(oundary)e(p)r(oin)n(t)h(b)r(eing)g(considered.)44
b(The)31 b(area)e(co)n(v)n(ered)g(b)n(y)h(the)h(shifted)g(uncertain)n
-(t)n(y)f(Region)g(then)427 4466 y(represen)n(ts)g(the)i(uncertain)n(t)n
+(t)n(y)f(Region)g(then)427 1283 y(represen)n(ts)g(the)i(uncertain)n(t)n
(y)f(in)g(the)h(b)r(oundary)f(p)r(osition.)48 b(The)31
b(uncertain)n(t)n(y)g(is)g(assumed)g(to)g(b)r(e)h(the)427
-4565 y(same)27 b(for)g(all)h(p)r(oin)n(ts.)427 4681 y(If)38
+1382 y(same)27 b(for)g(all)h(p)r(oin)n(ts.)427 1499 y(If)38
b(supplied,)j(the)d(uncertain)n(t)n(y)f(Region)g(m)n(ust)g(b)r(e)i(of)e
(a)g(class)g(for)g(whic)n(h)h(all)f(instances)g(are)g(cen)n(tro-)427
-4780 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24 b(Circle,)g(Ellipse,)h
+1599 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24 b(Circle,)g(Ellipse,)h
(etc.\))36 b(or)23 b(b)r(e)i(a)e(Prism)h(con)n(taining)f(cen)n
-(tro-symetric)f(comp)r(onen)n(t)427 4880 y(Regions.)57
+(tro-symetric)f(comp)r(onen)n(t)427 1698 y(Regions.)57
b(A)35 b(deep)f(cop)n(y)g(of)g(the)h(supplied)g(Region)f(will)g(b)r(e)h
(tak)n(en,)h(so)e(subsequen)n(t)g(c)n(hanges)f(to)h(the)427
-4980 y(uncertain)n(t)n(y)g(Region)g(using)g(the)h(supplied)g(p)r(oin)n
+1798 y(uncertain)n(t)n(y)g(Region)g(using)g(the)h(supplied)g(p)r(oin)n
(ter)g(will)f(ha)n(v)n(e)g(no)g(e\013ect)h(on)g(the)g(created)f(Bo)n
-(x.)57 b(Al-)427 5079 y(ternativ)n(ely)-7 b(,)34 b(a)f(n)n(ull)g(Ob)5
+(x.)57 b(Al-)427 1898 y(ternativ)n(ely)-7 b(,)34 b(a)f(n)n(ull)g(Ob)5
b(ject)33 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fj(NULL\))g(ma)n(y)f(b)r(e)
i(supplied,)h(in)e(whic)n(h)g(case)f(a)h(default)427
-5179 y(uncertain)n(t)n(y)27 b(is)g(used)h(equiv)-5 b(alen)n(t)27
+1997 y(uncertain)n(t)n(y)27 b(is)g(used)h(equiv)-5 b(alen)n(t)27
b(to)h(a)f(b)r(o)n(x)g(1.0E-6)f(of)h(the)h(size)f(of)h(the)g(Bo)n(x)e
-(b)r(eing)i(created.)427 5295 y(The)h(uncertain)n(t)n(y)f(Region)g(has)
+(b)r(eing)i(created.)427 2114 y(The)h(uncertain)n(t)n(y)f(Region)g(has)
h(t)n(w)n(o)f(uses:)39 b(1\))29 b(when)g(the)g(AST)p
Ft(_)p Fj(O)n(VERLAP)f(function)h(compares)e(t)n(w)n(o)427
-5394 y(Regions)j(for)g(equalit)n(y)g(the)h(uncertain)n(t)n(y)f(Region)g
+2214 y(Regions)j(for)g(equalit)n(y)g(the)h(uncertain)n(t)n(y)f(Region)g
(is)g(used)h(to)g(determine)f(the)h(tolerance)f(on)g(the)h(com-)427
-5494 y(parison,)23 b(and)g(2\))g(when)g(a)f(Region)h(is)g(mapp)r(ed)g
+2313 y(parison,)23 b(and)g(2\))g(when)g(a)f(Region)h(is)g(mapp)r(ed)g
(in)n(to)g(a)f(di\013eren)n(t)i(co)r(ordinate)d(system)i(and)g
-(subsequen)n(tly)427 5593 y(simpli\014ed)e(\(using)f(AST)p
+(subsequen)n(tly)427 2413 y(simpli\014ed)e(\(using)f(AST)p
Ft(_)p Fj(SIMPLIFY\),)h(the)f(uncertain)n(ties)g(are)f(used)h(to)g
-(determine)g(if)h(the)g(transformed)427 5693 y(b)r(oundary)27
+(determine)g(if)h(the)g(transformed)427 2513 y(b)r(oundary)27
b(can)g(b)r(e)h(accurately)f(represen)n(ted)f(b)n(y)h(a)g(sp)r
-(eci\014c)h(shap)r(e)g(of)f(Region.)p eop end
-%%Page: 315 325
-TeXDict begin 315 324 bop 3643 52 a FG(315)259 351 y
-Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 451 y Fj(A)22 b(c)n(haracter)e
-(string)h(con)n(taining)g(an)h(optional)f(comma-separated)e(list)j(of)g
-(attribute)g(assignmen)n(ts)f(to)g(b)r(e)427 551 y(used)27
-b(for)g(initialising)g(the)h(new)f(P)n(olygon.)34 b(The)28
-b(syn)n(tax)e(used)h(is)g(iden)n(tical)g(to)g(that)h(for)e(the)i(AST)p
-Ft(_)p Fj(SET)427 650 y(routine.)259 781 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 881
-y Fj(The)c(global)e(status.)0 1041 y Fc(Returned)32 b(V)-8
-b(alue:)259 1176 y(AST)p Ft(_)p Fc(POL)g(YGON)32 b(=)g(INTEGER)427
-1276 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(P)n(olygon.)0
-1436 y Fc(Notes:)340 1717 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
-b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
-(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 1817 y(set)28 b(to)f(an)h(error)d(v)-5
-b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)-2
-1977 y Fc(Status)33 b(Handling)n(:)227 2123 y Fj(The)d(protected)g(in)n
-(terface)f(to)g(this)h(function)h(includes)f(an)f(extra)g(parameter)f
-(at)i(the)g(end)g(of)g(the)g(parameter)227 2223 y(list)37
-b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)
-r(oin)n(ter)g(to)h(the)g(in)n(teger)e(inherited)i(status)f(v)-5
-b(ariable:)54 b Ft(")p Fj(in)n(t)227 2322 y Fi(\003)p
-Fj(status)p Ft(")p Fj(.)p 0 2519 3780 12 v 0 2649 a FA(AST)p
-Fe(_)p FA(POL)-11 b(YMAP)1422 2650 y Fd(Create)38 b(a)g(P)m(olyMap)2763
-2649 y FA(AST)p Fe(_)p FA(POL)-11 b(YMAP)0 2836 y Fc(Description:)44
+(eci\014c)h(shap)r(e)g(of)f(Region.)259 2647 y Fc(OPTIONS)32
+b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))
+427 2747 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h
+(optional)f(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f
+(to)g(b)r(e)427 2846 y(used)27 b(for)g(initialising)g(the)h(new)f(P)n
+(olygon.)34 b(The)28 b(syn)n(tax)e(used)h(is)g(iden)n(tical)g(to)g
+(that)h(for)e(the)i(AST)p Ft(_)p Fj(SET)427 2946 y(routine.)259
+3080 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 3180 y Fj(The)c(global)e(status.)0 3344
+y Fc(Returned)32 b(V)-8 b(alue:)259 3484 y(AST)p Ft(_)p
+Fc(POL)g(YGON)32 b(=)g(INTEGER)427 3583 y Fj(A)c(p)r(oin)n(ter)f(to)h
+(the)g(new)g(P)n(olygon.)0 3748 y Fc(Notes:)340 4033
+y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f
+(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f
+(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427
+4133 y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g
+(should)f(fail)h(for)f(an)n(y)g(reason.)-2 4298 y Fc(Status)33
+b(Handling)n(:)227 4444 y Fj(The)d(protected)g(in)n(terface)f(to)g
+(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
+(of)g(the)g(parameter)227 4543 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
+(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
+(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
+Fj(in)n(t)227 4643 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p
+0 4845 3780 12 v 0 4976 a FA(AST)p Fe(_)p FA(POL)-11
+b(YMAP)1422 4977 y Fd(Create)38 b(a)g(P)m(olyMap)2763
+4976 y FA(AST)p Fe(_)p FA(POL)-11 b(YMAP)0 5169 y Fc(Description:)44
b Fj(This)28 b(function)g(creates)f(a)g(new)g(P)n(olyMap)f(and)i
-(optionally)f(initialises)g(its)h(attributes.)227 2960
+(optionally)f(initialises)g(its)h(attributes.)227 5295
y(A)g(P)n(olyMap)e(is)h(a)g(form)g(of)g(Mapping)g(whic)n(h)g(p)r
(erforms)f(a)h(general)f(p)r(olynomial)h(transformation.)35
-b(Eac)n(h)26 b(out-)227 3059 y(put)j(co)r(ordinate)d(is)h(a)h(p)r
+b(Eac)n(h)26 b(out-)227 5394 y(put)j(co)r(ordinate)d(is)h(a)h(p)r
(olynomial)f(function)h(of)f(all)h(the)g(input)g(co)r(ordinates.)36
b(The)27 b(co)r(e\016cien)n(ts)h(are)e(sp)r(eci\014ed)227
-3159 y(separately)33 b(for)h(eac)n(h)g(output)h(co)r(ordinate.)57
+5494 y(separately)33 b(for)h(eac)n(h)g(output)h(co)r(ordinate.)57
b(The)35 b(forw)n(ard)e(and)h(in)n(v)n(erse)f(transformations)g(are)h
-(de\014ned)h(in-)227 3259 y(dep)r(endan)n(tly)30 b(b)n(y)g(separate)f
+(de\014ned)h(in-)227 5593 y(dep)r(endan)n(tly)30 b(b)n(y)g(separate)f
(sets)h(of)g(co)r(e\016cien)n(ts.)44 b(If)30 b(no)g(in)n(v)n(erse)e
(transformation)h(is)h(supplied,)h(an)e(iterativ)n(e)227
-3358 y(metho)r(d)f(can)g(b)r(e)g(used)f(to)h(ev)-5 b(aluate)27
+5693 y(metho)r(d)f(can)g(b)r(e)g(used)f(to)h(ev)-5 b(aluate)27
b(the)h(in)n(v)n(erse)e(based)h(only)g(on)g(the)h(forw)n(ard)e
-(transformation.)0 3506 y Fc(In)m(v)m(o)s(cation:)123
-b Ft(RESULT)41 b(=)i(AST_POLYMAP\()c(NIN,)j(NOUT,)f(NCOEFF_F,)f
-(COEFF_F,)g(NCOEFF_I,)g(COEFF_I,)g(OPTIONS,)227 3606
-y(STATUS)h(\))0 3754 y Fc(Argumen)m(ts:)259 3889 y(NIN)32
-b(=)g(INTEGER)f(\(Giv)m(en\))427 3988 y Fj(The)d(n)n(um)n(b)r(er)f(of)h
-(input)g(co)r(ordinates.)259 4119 y Fc(NOUT)k(=)g(INTEGER)g(\(Giv)m
-(en\))427 4219 y Fj(The)c(n)n(um)n(b)r(er)f(of)h(output)g(co)r
-(ordinates.)259 4350 y Fc(NCOEFF)p Ft(_)p Fc(F)j(=)h(INTEGER)f(\(Giv)m
-(en\))427 4450 y Fj(The)36 b(n)n(um)n(b)r(er)f(of)h(non-zero)d(co)r
-(e\016cien)n(ts)i(necessary)f(to)i(de\014ne)f(the)h(forw)n(ard)e
-(transformation)g(of)h(the)427 4550 y(P)n(olyMap.)h(If)28
-b(zero)e(is)i(supplied,)g(the)g(forw)n(ard)d(transformation)h(will)i(b)
-r(e)g(unde\014ned.)259 4681 y Fc(COEFF)p Ft(_)p Fc(F\()j
-Fi(\003)h Fc(\))g(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427
-4781 y Fj(An)22 b(arra)n(y)d(con)n(taining)h Ft(")p Fj(NCOEFF)p
-Ft(_)p Fj(F)p Fi(\003)p Fj(\()h(2)g(+)g(NIN)g(\))p Ft(")h
-Fj(elemen)n(ts.)34 b(Eac)n(h)21 b(group)f(of)h Ft(")p
-Fj(2)g(+)g(NIN)p Ft(")g Fj(adjacen)n(t)427 4880 y(elemen)n(ts)26
-b(describ)r(e)f(a)f(single)h(co)r(e\016cien)n(t)h(of)f(the)h(forw)n
-(ard)d(transformation.)35 b(Within)26 b(eac)n(h)f(suc)n(h)g(group,)427
-4980 y(the)g(\014rst)g(elemen)n(t)g(is)f(the)h(co)r(e\016cien)n(t)g(v)
--5 b(alue;)25 b(the)h(next)e(elemen)n(t)h(is)g(the)g(in)n(teger)f
-(index)g(of)h(the)g(P)n(olyMap)427 5079 y(output)33 b(whic)n(h)f(uses)f
-(the)h(co)r(e\016cien)n(t)g(within)h(its)f(de\014ning)g(p)r(olynomial)f
-(\(the)i(\014rst)f(output)g(has)g(index)427 5179 y(1\);)48
-b(the)41 b(remaining)f(elemen)n(ts)h(of)g(the)g(group)f(giv)n(e)g(the)h
-(in)n(teger)f(p)r(o)n(w)n(ers)g(to)g(use)h(with)h(eac)n(h)e(input)427
-5279 y(co)r(ordinate)27 b(v)-5 b(alue)27 b(\(p)r(o)n(w)n(ers)g(m)n(ust)
+(transformation.)p eop end
+%%Page: 318 328
+TeXDict begin 318 327 bop 0 52 a FG(318)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(In)m(v)m(o)s(cation:)
+123 b Ft(RESULT)41 b(=)i(AST_POLYMAP\()c(NIN,)j(NOUT,)f(NCOEFF_F,)f
+(COEFF_F,)g(NCOEFF_I,)g(COEFF_I,)g(OPTIONS,)227 451 y(STATUS)h(\))0
+600 y Fc(Argumen)m(ts:)259 736 y(NIN)32 b(=)g(INTEGER)f(\(Giv)m(en\))
+427 836 y Fj(The)d(n)n(um)n(b)r(er)f(of)h(input)g(co)r(ordinates.)259
+969 y Fc(NOUT)k(=)g(INTEGER)g(\(Giv)m(en\))427 1068 y
+Fj(The)c(n)n(um)n(b)r(er)f(of)h(output)g(co)r(ordinates.)259
+1201 y Fc(NCOEFF)p Ft(_)p Fc(F)j(=)h(INTEGER)f(\(Giv)m(en\))427
+1300 y Fj(The)36 b(n)n(um)n(b)r(er)f(of)h(non-zero)d(co)r(e\016cien)n
+(ts)i(necessary)f(to)i(de\014ne)f(the)h(forw)n(ard)e(transformation)g
+(of)h(the)427 1400 y(P)n(olyMap.)h(If)28 b(zero)e(is)i(supplied,)g(the)
+g(forw)n(ard)d(transformation)h(will)i(b)r(e)g(unde\014ned.)259
+1533 y Fc(COEFF)p Ft(_)p Fc(F\()j Fi(\003)h Fc(\))g(=)g(DOUBLE)g
+(PRECISION)f(\(Giv)m(en\))427 1632 y Fj(An)22 b(arra)n(y)d(con)n
+(taining)h Ft(")p Fj(NCOEFF)p Ft(_)p Fj(F)p Fi(\003)p
+Fj(\()h(2)g(+)g(NIN)g(\))p Ft(")h Fj(elemen)n(ts.)34
+b(Eac)n(h)21 b(group)f(of)h Ft(")p Fj(2)g(+)g(NIN)p Ft(")g
+Fj(adjacen)n(t)427 1732 y(elemen)n(ts)26 b(describ)r(e)f(a)f(single)h
+(co)r(e\016cien)n(t)h(of)f(the)h(forw)n(ard)d(transformation.)35
+b(Within)26 b(eac)n(h)f(suc)n(h)g(group,)427 1831 y(the)g(\014rst)g
+(elemen)n(t)g(is)f(the)h(co)r(e\016cien)n(t)g(v)-5 b(alue;)25
+b(the)h(next)e(elemen)n(t)h(is)g(the)g(in)n(teger)f(index)g(of)h(the)g
+(P)n(olyMap)427 1931 y(output)33 b(whic)n(h)f(uses)f(the)h(co)r
+(e\016cien)n(t)g(within)h(its)f(de\014ning)g(p)r(olynomial)f(\(the)i
+(\014rst)f(output)g(has)g(index)427 2031 y(1\);)48 b(the)41
+b(remaining)f(elemen)n(ts)h(of)g(the)g(group)f(giv)n(e)g(the)h(in)n
+(teger)f(p)r(o)n(w)n(ers)g(to)g(use)h(with)h(eac)n(h)e(input)427
+2130 y(co)r(ordinate)27 b(v)-5 b(alue)27 b(\(p)r(o)n(w)n(ers)g(m)n(ust)
h(not)f(b)r(e)h(negativ)n(e,)f(and)h(\015oating)f(p)r(oin)n(t)g(v)-5
-b(alues)28 b(are)e(rounded)i(to)f(the)427 5378 y(nearest)g(in)n
-(teger\).)427 5494 y(F)-7 b(or)24 b(instance,)h(if)g(the)f(P)n(olyMap)f
+b(alues)28 b(are)e(rounded)i(to)f(the)427 2230 y(nearest)g(in)n
+(teger\).)427 2346 y(F)-7 b(or)24 b(instance,)h(if)g(the)f(P)n(olyMap)f
(has)h(3)g(inputs)h(and)f(2)g(outputs,)h(eac)n(h)f(group)f(consisting)g
-(of)i(5)f(elemen)n(ts,)427 5593 y(A)i(groups)e(suc)n(h)h(as)f
+(of)i(5)f(elemen)n(ts,)427 2446 y(A)i(groups)e(suc)n(h)h(as)f
Ft(")p Fj(\(1.2,)h(2.0,)g(1.0,)g(3.0,)g(0.0\))p Ft(")f
Fj(describ)r(es)g(a)h(co)r(e\016cien)n(t)g(with)h(v)-5
-b(alue)25 b(1.2)f(whic)n(h)i(is)f(used)427 5693 y(within)36
+b(alue)25 b(1.2)f(whic)n(h)i(is)f(used)427 2545 y(within)36
b(the)f(de\014nition)h(of)e(output)i(2.)59 b(The)35 b(output)g(v)-5
-b(alue)35 b(is)g(incremen)n(ted)f(b)n(y)h(the)g(pro)r(duct)g(of)g(the)p
-eop end
-%%Page: 316 326
-TeXDict begin 316 325 bop 0 52 a FG(316)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(co)r(e\016cien)n(t)25
-b(v)-5 b(alue,)25 b(the)g(v)-5 b(alue)24 b(of)h(input)g(co)r(ordinate)e
-(1)i(raised)e(to)h(the)h(p)r(o)n(w)n(er)f(1,)h(and)f(the)h(v)-5
-b(alue)24 b(of)h(input)427 451 y(co)r(ordinate)g(2)g(raised)f(to)i(the)
-g(p)r(o)n(w)n(er)e(3.)36 b(Input)26 b(co)r(ordinate)f(3)g(is)g(not)h
-(used)f(since)h(its)g(p)r(o)n(w)n(er)e(is)h(sp)r(eci\014ed)427
-551 y(as)i(zero.)36 b(As)27 b(another)f(example,)h(the)h(group)e
-Ft(")p Fj(\(-1.0,)g(1.0,)h(0.0,)g(0.0,)f(0.0)h(\))p Ft(")g
-Fj(describ)r(es)g(adds)f(a)h(constan)n(t)427 650 y(v)-5
-b(alue)30 b(-1.0)e(on)n(to)g(output)i(1)f(\(it)i(is)e(a)g(constan)n(t)g
-(v)-5 b(alue)29 b(since)g(the)h(p)r(o)n(w)n(er)e(for)h(ev)n(ery)f
-(input)i(axis)f(is)g(giv)n(en)427 750 y(as)e(zero\).)427
-865 y(Eac)n(h)i(\014nal)h(output)g(co)r(ordinate)f(v)-5
-b(alue)30 b(is)g(the)g(sum)g(of)g(the)g Ft(")p Fj(NCOEFF)p
-Ft(_)p Fj(F)p Ft(")f Fj(terms)h(describ)r(ed)g(b)n(y)f(the)427
-965 y Ft(")p Fj(NCOEFF)p Ft(_)p Fj(F)p Ft(")e Fj(groups)f(within)i(the)
-g(supplied)g(arra)n(y)-7 b(.)259 1096 y Fc(NCOEFF)p Ft(_)p
-Fc(I)31 b(=)h(INTEGER)f(\(Giv)m(en\))427 1196 y Fj(The)38
-b(n)n(um)n(b)r(er)g(of)g(non-zero)e(co)r(e\016cien)n(ts)i(necessary)e
-(to)i(de\014ne)g(the)g(in)n(v)n(erse)f(transformation)f(of)i(the)427
-1295 y(P)n(olyMap.)e(If)28 b(zero)e(is)i(supplied,)g(the)g(in)n(v)n
-(erse)e(transformation)g(will)h(b)r(e)h(unde\014ned.)259
-1427 y Fc(COEFF)p Ft(_)p Fc(I\()j Fi(\003)h Fc(\))g(=)g(DOUBLE)g
-(PRECISION)f(\(Giv)m(en\))427 1526 y Fj(An)i(arra)n(y)d(con)n(taining)i
+b(alue)35 b(is)g(incremen)n(ted)f(b)n(y)h(the)g(pro)r(duct)g(of)g(the)
+427 2645 y(co)r(e\016cien)n(t)25 b(v)-5 b(alue,)25 b(the)g(v)-5
+b(alue)24 b(of)h(input)g(co)r(ordinate)e(1)i(raised)e(to)h(the)h(p)r(o)
+n(w)n(er)f(1,)h(and)f(the)h(v)-5 b(alue)24 b(of)h(input)427
+2745 y(co)r(ordinate)g(2)g(raised)f(to)i(the)g(p)r(o)n(w)n(er)e(3.)36
+b(Input)26 b(co)r(ordinate)f(3)g(is)g(not)h(used)f(since)h(its)g(p)r(o)
+n(w)n(er)e(is)h(sp)r(eci\014ed)427 2844 y(as)i(zero.)36
+b(As)27 b(another)f(example,)h(the)h(group)e Ft(")p Fj(\(-1.0,)g(1.0,)h
+(0.0,)g(0.0,)f(0.0)h(\))p Ft(")g Fj(describ)r(es)g(adds)f(a)h(constan)n
+(t)427 2944 y(v)-5 b(alue)30 b(-1.0)e(on)n(to)g(output)i(1)f(\(it)i(is)
+e(a)g(constan)n(t)g(v)-5 b(alue)29 b(since)g(the)h(p)r(o)n(w)n(er)e
+(for)h(ev)n(ery)f(input)i(axis)f(is)g(giv)n(en)427 3043
+y(as)e(zero\).)427 3160 y(Eac)n(h)i(\014nal)h(output)g(co)r(ordinate)f
+(v)-5 b(alue)30 b(is)g(the)g(sum)g(of)g(the)g Ft(")p
+Fj(NCOEFF)p Ft(_)p Fj(F)p Ft(")f Fj(terms)h(describ)r(ed)g(b)n(y)f(the)
+427 3259 y Ft(")p Fj(NCOEFF)p Ft(_)p Fj(F)p Ft(")e Fj(groups)f(within)i
+(the)g(supplied)g(arra)n(y)-7 b(.)259 3392 y Fc(NCOEFF)p
+Ft(_)p Fc(I)31 b(=)h(INTEGER)f(\(Giv)m(en\))427 3491
+y Fj(The)38 b(n)n(um)n(b)r(er)g(of)g(non-zero)e(co)r(e\016cien)n(ts)i
+(necessary)e(to)i(de\014ne)g(the)g(in)n(v)n(erse)f(transformation)f(of)
+i(the)427 3591 y(P)n(olyMap.)e(If)28 b(zero)e(is)i(supplied,)g(the)g
+(in)n(v)n(erse)e(transformation)g(will)h(b)r(e)h(unde\014ned.)259
+3724 y Fc(COEFF)p Ft(_)p Fc(I\()j Fi(\003)h Fc(\))g(=)g(DOUBLE)g
+(PRECISION)f(\(Giv)m(en\))427 3823 y Fj(An)i(arra)n(y)d(con)n(taining)i
Ft(")p Fj(NCOEFF)p Ft(_)p Fj(I)p Fi(\003)p Fj(\()f(2)h(+)g(NOUT)h(\))p
Ft(")f Fj(elemen)n(ts.)51 b(Eac)n(h)31 b(group)h(of)g
-Ft(")p Fj(2)g(+)g(NOUT)p Ft(")427 1626 y Fj(adjacen)n(t)e(elemen)n(ts)g
+Ft(")p Fj(2)g(+)g(NOUT)p Ft(")427 3923 y Fj(adjacen)n(t)e(elemen)n(ts)g
(describ)r(e)f(a)h(single)f(co)r(e\016cien)n(t)h(of)g(the)h(in)n(v)n
-(erse)d(transformation,)h(using)h(the)g(same)427 1725
+(erse)d(transformation,)h(using)h(the)g(same)427 4023
y(sc)n(hame)d(as)g Ft(")p Fj(COEFF)p Ft(_)p Fj(F)p Ft(")p
Fj(,)f(except)i(that)g Ft(")p Fj(inputs)p Ft(")f Fj(and)g
Ft(")p Fj(outputs)p Ft(")g Fj(are)g(transp)r(osed.)259
-1857 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1956 y Fj(A)22 b(c)n(haracter)e
+4155 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 4255 y Fj(A)22 b(c)n(haracter)e
(string)h(con)n(taining)g(an)h(optional)f(comma-separated)e(list)j(of)g
-(attribute)g(assignmen)n(ts)f(to)g(b)r(e)427 2056 y(used)k(for)f
+(attribute)g(assignmen)n(ts)f(to)g(b)r(e)427 4354 y(used)k(for)f
(initialising)h(the)g(new)g(P)n(olyMap.)34 b(The)25 b(syn)n(tax)f(used)
h(is)f(iden)n(tical)h(to)g(that)g(for)f(the)h(AST)p Ft(_)p
-Fj(SET)427 2156 y(routine.)259 2287 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 2387
-y Fj(The)c(global)e(status.)0 2547 y Fc(Returned)32 b(V)-8
-b(alue:)259 2682 y(AST)p Ft(_)p Fc(POL)g(YMAP)33 b(=)f(INTEGER)427
-2781 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(P)n(olyMap.)0
-2942 y Fc(Notes:)340 3223 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+Fj(SET)427 4454 y(routine.)259 4587 y Fc(ST)-8 b(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 4686
+y Fj(The)c(global)e(status.)0 4848 y Fc(Returned)32 b(V)-8
+b(alue:)259 4984 y(AST)p Ft(_)p Fc(POL)g(YMAP)33 b(=)f(INTEGER)427
+5084 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(P)n(olyMap.)0
+5245 y Fc(Notes:)340 5528 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 3322 y(set)28 b(to)f(an)h(error)d(v)-5
+b(A)g(TUS)427 5627 y(set)28 b(to)f(an)h(error)d(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-0 3518 3780 12 v 0 3649 a FA(AST)p Fe(_)p FA(POL)-11
-b(YTRAN)1249 3650 y Fd(Fit)38 b(a)h(P)m(olyMap)e(in)m(v)m(erse)h(or)
-1296 3765 y(forw)m(ard)e(transformation)2684 3649 y FA(AST)p
-Fe(_)p FA(POL)-11 b(YTRAN)0 3927 y Fc(Description:)44
+eop end
+%%Page: 319 329
+TeXDict begin 319 328 bop 3643 52 a FG(319)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(POL)-11 b(YTRAN)1249
+483 y Fd(Fit)38 b(a)h(P)m(olyMap)e(in)m(v)m(erse)h(or)1296
+598 y(forw)m(ard)e(transformation)2684 482 y FA(AST)p
+Fe(_)p FA(POL)-11 b(YTRAN)0 738 y Fc(Description:)44
b Fj(This)28 b(function)h(creates)e(a)h(new)g(P)n(olyMap)f(whic)n(h)h
(is)g(a)f(cop)n(y)h(of)g(the)g(supplied)h(P)n(olyMap,)d(in)j(whic)n(h)
-227 4027 y(a)24 b(sp)r(eci\014ed)h(transformation)d(\(forw)n(ard)h(or)h
+227 837 y(a)24 b(sp)r(eci\014ed)h(transformation)d(\(forw)n(ard)h(or)h
(in)n(v)n(erse\))f(has)h(b)r(een)g(replaced)g(b)n(y)g(a)g(new)g(p)r
-(olynomial)g(transforma-)227 4126 y(tion.)35 b(The)19
+(olynomial)g(transforma-)227 937 y(tion.)35 b(The)19
b(co)r(e\016cien)n(ts)h(of)f(the)h(new)g(transformation)e(are)h
(estimated)h(b)n(y)f(sampling)g(the)h(other)f(transformation)227
-4226 y(and)33 b(p)r(erforming)e(a)h(least)g(squares)f(p)r(olynomial)h
+1037 y(and)33 b(p)r(erforming)e(a)h(least)g(squares)f(p)r(olynomial)h
(\014t)h(in)g(the)g(opp)r(osite)f(direction)g(to)g(the)h(sampled)f(p)r
-(ositions)227 4326 y(and)c(v)-5 b(alues.)227 4449 y(This)28
+(ositions)227 1136 y(and)c(v)-5 b(alues.)227 1254 y(This)28
b(metho)r(d)g(can)f(only)g(b)r(e)h(used)g(on)f(\(1-input,1-output\))h
-(or)f(\(2-input,2-output\))h(P)n(olyMaps.)227 4573 y(The)c
+(or)f(\(2-input,2-output\))h(P)n(olyMaps.)227 1373 y(The)c
(transformation)e(to)h(create)g(is)g(sp)r(eci\014ed)h(b)n(y)g(the)g(F)n
(OR)-9 b(W)g(ARD)24 b(parameter.)34 b(In)23 b(what)h(follo)n(ws)e
-Ft(")p Fj(X)p Ft(")i Fj(refers)227 4673 y(to)e(the)g(inputs)h(of)f(the)
+Ft(")p Fj(X)p Ft(")i Fj(refers)227 1472 y(to)e(the)g(inputs)h(of)f(the)
g(P)n(olyMap,)f(and)h Ft(")p Fj(Y)p Ft(")f Fj(to)h(the)g(outputs)h(of)f
(the)g(P)n(olyMap.)33 b(The)22 b(forw)n(ard)e(transformation)227
-4772 y(transforms)36 b(input)i(v)-5 b(alues)37 b(\(X\))i(in)n(to)e
+1572 y(transforms)36 b(input)i(v)-5 b(alues)37 b(\(X\))i(in)n(to)e
(output)h(v)-5 b(alues)37 b(\(Y\),)h(and)g(the)f(in)n(v)n(erse)f
-(transformation)g(transforms)227 4872 y(output)f(v)-5
+(transformation)g(transforms)227 1671 y(output)f(v)-5
b(alues)33 b(\(Y\))i(in)n(to)f(input)h(v)-5 b(alues)33
b(\(X\).)i(Within)g(a)f(P)n(olyMap,)g(eac)n(h)f(transformation)f(is)i
-(represen)n(ted)227 4972 y(b)n(y)29 b(an)g(indep)r(enden)n(t)h(set)f
+(represen)n(ted)227 1771 y(b)n(y)29 b(an)g(indep)r(enden)n(t)h(set)f
(of)g(p)r(olynomials,)g(P)p Ft(_)p Fj(f)f(or)g(P)p Ft(_)p
Fj(i:)40 b(Y=P)p Ft(_)p Fj(f\(X\))29 b(for)f(the)i(forw)n(ard)d
-(transformation)h(and)227 5071 y(X=P)p Ft(_)p Fj(i\(Y\))g(for)f(the)h
-(in)n(v)n(erse)e(transformation.)227 5195 y(The)k(F)n(OR)-9
+(transformation)h(and)227 1871 y(X=P)p Ft(_)p Fj(i\(Y\))g(for)f(the)h
+(in)n(v)n(erse)e(transformation.)227 1989 y(The)k(F)n(OR)-9
b(W)g(ARD)31 b(parameter)d(sp)r(eci\014es)i(the)g(transformation)f(to)h
(b)r(e)g(replaced.)43 b(If)30 b(it)h(is)f(is)g(.TR)n(UE.,)g(a)g(new)227
-5295 y(forw)n(ard)e(transformation)g(is)i(created)f(b)n(y)g(\014rst)h
+2088 y(forw)n(ard)e(transformation)g(is)i(created)f(b)n(y)g(\014rst)h
(\014nding)g(the)g(input)g(v)-5 b(alues)30 b(\(X\))g(using)g(the)g(in)n
-(v)n(erse)e(transfor-)227 5394 y(mation)i(\(whic)n(h)g(m)n(ust)g(b)r(e)
+(v)n(erse)e(transfor-)227 2188 y(mation)i(\(whic)n(h)g(m)n(ust)g(b)r(e)
h(a)n(v)-5 b(ailable\))28 b(at)i(a)g(regular)e(grid)h(of)h(p)r(oin)n
(ts)g(\(Y\))h(co)n(v)n(ering)d(a)h(rectangular)f(region)h(of)227
-5494 y(the)h(P)n(olyMap's)d(output)j(space.)40 b(The)30
+2288 y(the)h(P)n(olyMap's)d(output)j(space.)40 b(The)30
b(co)r(e\016cien)n(ts)e(of)h(the)h(required)e(forw)n(ard)f(p)r
-(olynomial,)i(Y=P)p Ft(_)p Fj(f\(X\),)h(are)227 5593
+(olynomial,)i(Y=P)p Ft(_)p Fj(f\(X\),)h(are)227 2387
y(c)n(hosen)25 b(in)g(order)f(to)h(minimise)h(the)g(sum)f(of)h(the)f
(squared)g(residuals)f(b)r(et)n(w)n(een)h(the)h(sampled)f(v)-5
-b(alues)25 b(of)g(Y)h(and)227 5693 y(P)p Ft(_)p Fj(f\(X\).)p
-eop end
-%%Page: 317 327
-TeXDict begin 317 326 bop 3643 52 a FG(317)227 351 y
-Fj(If)27 b(F)n(OR)-9 b(W)g(ARD)27 b(is)g(.F)-9 b(ALSE.)26
+b(alues)25 b(of)g(Y)h(and)227 2487 y(P)p Ft(_)p Fj(f\(X\).)227
+2605 y(If)h(F)n(OR)-9 b(W)g(ARD)27 b(is)g(.F)-9 b(ALSE.)26
b(\(probably)g(the)h(most)g(lik)n(ely)f(case\),)g(a)g(new)h(in)n(v)n
-(erse)e(transformation)g(is)h(created)227 451 y(b)n(y)i(\014rst)g
+(erse)e(transformation)g(is)h(created)227 2705 y(b)n(y)i(\014rst)g
(\014nding)g(the)h(output)f(v)-5 b(alues)28 b(\(Y\))h(using)e(the)i
(forw)n(ard)d(transformation)h(\(whic)n(h)h(m)n(ust)g(b)r(e)h(a)n(v)-5
-b(ailable\))227 551 y(at)32 b(a)g(regular)e(grid)i(of)g(p)r(oin)n(ts)g
+b(ailable\))227 2804 y(at)32 b(a)g(regular)e(grid)i(of)g(p)r(oin)n(ts)g
(\(X\))h(co)n(v)n(ering)d(a)i(rectangular)e(region)h(of)h(the)g(P)n
-(olyMap's)f(input)i(space.)50 b(The)227 650 y(co)r(e\016cien)n(ts)24
+(olyMap's)f(input)i(space.)50 b(The)227 2904 y(co)r(e\016cien)n(ts)24
b(of)g(the)h(required)e(in)n(v)n(erse)f(p)r(olynomial,)j(X=P)p
Ft(_)p Fj(i\(Y\),)f(are)f(c)n(hosen)g(in)i(order)d(to)i(minimise)h(the)
-f(sum)227 750 y(of)k(the)g(squared)e(residuals)h(b)r(et)n(w)n(een)g
+f(sum)227 3004 y(of)k(the)g(squared)e(residuals)h(b)r(et)n(w)n(een)g
(the)h(sampled)g(v)-5 b(alues)27 b(of)g(X)h(and)g(P)p
-Ft(_)p Fj(i\(Y\).)227 878 y(This)21 b(\014tting)g(pro)r(cess)e(is)h(p)r
-(erformed)g(rep)r(eatedly)g(with)h(increasing)e(p)r(olynomial)h(orders)
-f(\(starting)h(with)h(linear\))227 978 y(un)n(til)f(the)f(target)f
-(accuracy)f(is)i(ac)n(hiev)n(ed,)g(or)f(a)h(sp)r(eci\014ed)g(maxim)n
-(um)g(order)e(is)i(reac)n(hed.)33 b(If)19 b(the)g(target)f(accuracy)227
-1078 y(cannot)35 b(b)r(e)h(ac)n(hiev)n(ed)e(ev)n(en)h(with)h(this)g
-(maxim)n(um-order)e(p)r(olynomial,)j(the)f(b)r(est)g(\014tting)g(maxim)
-n(um-order)227 1177 y(p)r(olynomial)d(is)h(returned)f(so)g(long)g(as)f
-(its)i(accuracy)e(is)h(b)r(etter)h(than)g(MAXA)n(CC.)g(If)g(it)g(is)g
-(not,)h(an)e(error)f(is)227 1277 y(rep)r(orted.)0 1435
-y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_POLYTRAN\()38
-b(THIS,)k(FORWARD,)e(ACC,)i(MAXACC,)f(MAXORDER,)f(LBND,)h(UBND,)h
-(STATUS)227 1534 y(\))0 1692 y Fc(Argumen)m(ts:)259 1837
-y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1936 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(original)e(Mapping.)259 2073 y Fc(F)m(OR)-11
-b(W)g(ARD)32 b(=)g(LOGICAL)h(\(Giv)m(en\))427 2173 y
+Ft(_)p Fj(i\(Y\).)227 3122 y(This)21 b(\014tting)g(pro)r(cess)e(is)h(p)
+r(erformed)g(rep)r(eatedly)g(with)h(increasing)e(p)r(olynomial)h
+(orders)f(\(starting)h(with)h(linear\))227 3221 y(un)n(til)f(the)f
+(target)f(accuracy)f(is)i(ac)n(hiev)n(ed,)g(or)f(a)h(sp)r(eci\014ed)g
+(maxim)n(um)g(order)e(is)i(reac)n(hed.)33 b(If)19 b(the)g(target)f
+(accuracy)227 3321 y(cannot)35 b(b)r(e)h(ac)n(hiev)n(ed)e(ev)n(en)h
+(with)h(this)g(maxim)n(um-order)e(p)r(olynomial,)j(the)f(b)r(est)g
+(\014tting)g(maxim)n(um-order)227 3421 y(p)r(olynomial)d(is)h(returned)
+f(so)g(long)g(as)f(its)i(accuracy)e(is)h(b)r(etter)h(than)g(MAXA)n(CC.)
+g(If)g(it)g(is)g(not,)h(an)e(error)f(is)227 3520 y(rep)r(orted.)0
+3657 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_POLYTRAN\()
+38 b(THIS,)k(FORWARD,)e(ACC,)i(MAXACC,)f(MAXORDER,)f(LBND,)h(UBND,)h
+(STATUS)227 3757 y(\))0 3893 y Fc(Argumen)m(ts:)259 4017
+y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 4117 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(original)e(Mapping.)259 4237 y Fc(F)m(OR)-11
+b(W)g(ARD)32 b(=)g(LOGICAL)h(\(Giv)m(en\))427 4336 y
Fj(If)28 b(.TR)n(UE.,)g(the)g(forw)n(ard)e(P)n(olyMap)g(transformation)
g(is)h(replaced.)36 b(Otherwise)27 b(the)h(in)n(v)n(erse)e(transfor-)
-427 2273 y(mation)i(is)f(replaced.)259 2410 y Fc(A)m(CC)32
-b(=)g(DOUBLE)h(\(Giv)m(en\))427 2509 y Fj(The)f(target)e(accuracy)-7
+427 4436 y(mation)i(is)f(replaced.)259 4556 y Fc(A)m(CC)32
+b(=)g(DOUBLE)h(\(Giv)m(en\))427 4656 y Fj(The)f(target)e(accuracy)-7
b(,)31 b(expressed)f(as)h(a)f(geo)r(desic)h(distance)g(within)h(the)g
-(P)n(olyMap's)d(input)j(space)f(\(if)427 2609 y(F)n(OR)-9
+(P)n(olyMap's)d(input)j(space)f(\(if)427 4755 y(F)n(OR)-9
b(W)g(ARD)28 b(is)g(.F)-9 b(ALSE.\))28 b(or)e(output)i(space)f(\(if)i
-(F)n(OR)-9 b(W)g(ARD)28 b(is)f(.TR)n(UE.\).)259 2746
-y Fc(MAXA)m(CC)32 b(=)g(DOUBLE)h(\(Giv)m(en\))427 2846
+(F)n(OR)-9 b(W)g(ARD)28 b(is)f(.TR)n(UE.\).)259 4876
+y Fc(MAXA)m(CC)32 b(=)g(DOUBLE)h(\(Giv)m(en\))427 4975
y Fj(The)g(maxim)n(um)f(allo)n(w)n(ed)e(accuracy)h(for)g(an)h
(acceptable)g(p)r(olynomial,)g(expressed)f(as)h(a)g(geo)r(desic)f(dis-)
-427 2945 y(tance)24 b(within)h(the)f(P)n(olyMap's)e(input)j(space)e
+427 5075 y(tance)24 b(within)h(the)f(P)n(olyMap's)e(input)j(space)e
(\(if)i(F)n(OR)-9 b(W)g(ARD)24 b(is)g(.F)-9 b(ALSE.\))24
-b(or)f(output)h(space)g(\(if)g(F)n(OR-)427 3045 y(W)-9
-b(ARD)29 b(is)e(.TR)n(UE.\).)259 3182 y Fc(MAX)m(ORDER)k(=)h(INTEGER)g
-(\(Giv)m(en\))427 3281 y Fj(The)22 b(maxim)n(um)f(allo)n(w)n(ed)f(p)r
+b(or)f(output)h(space)g(\(if)g(F)n(OR-)427 5174 y(W)-9
+b(ARD)29 b(is)e(.TR)n(UE.\).)259 5295 y Fc(MAX)m(ORDER)k(=)h(INTEGER)g
+(\(Giv)m(en\))427 5394 y Fj(The)22 b(maxim)n(um)f(allo)n(w)n(ed)f(p)r
(olynomial)h(order.)34 b(This)21 b(is)g(one)h(more)e(than)i(the)g
-(maxim)n(um)f(p)r(o)n(w)n(er)f(of)i(either)427 3381 y(input)30
+(maxim)n(um)f(p)r(o)n(w)n(er)f(of)i(either)427 5494 y(input)30
b(axis.)41 b(So)29 b(for)g(instance,)h(a)e(v)-5 b(alue)30
b(of)f(3)g(refers)f(to)h(a)g(quadratic)f(p)r(olynomial.)41
-b(Note,)30 b(cross)e(terms)427 3481 y(with)i(total)f(p)r(o)n(w)n(ers)f
+b(Note,)30 b(cross)e(terms)427 5593 y(with)i(total)f(p)r(o)n(w)n(ers)f
(greater)g(than)h(or)g(equal)g(to)g(MAX)n(ORDER)g(are)g(not)g(inlcuded)
-h(in)g(the)f(\014t.)43 b(So)29 b(the)427 3580 y(maxim)n(um)18
+h(in)g(the)f(\014t.)43 b(So)29 b(the)427 5693 y(maxim)n(um)18
b(n)n(um)n(b)r(er)h(of)f(terms)g(in)h(eac)n(h)e(of)i(the)f(\014tted)h
(p)r(olynomials)f(is)g(MAX)n(ORDER)p Fi(\003)p Fj(\(MAX)n(ORDER+1\)/2.)
-259 3717 y Fc(LBND\()32 b Fi(\003)g Fc(\))g(=)g(DOUBLE)g(PRECISION)f
-(\(Giv)m(en\))427 3817 y Fj(An)c(arra)n(y)c(holding)j(the)g(lo)n(w)n
-(er)e(b)r(ounds)j(of)e(a)h(rectangular)e(region)h(within)h(the)g(P)n
-(olyMap's)f(input)h(space)427 3917 y(\(if)g(F)n(OR)-9
+p eop end
+%%Page: 320 330
+TeXDict begin 320 329 bop 0 52 a FG(320)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(LBND\()h
+Fi(\003)g Fc(\))g(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427
+451 y Fj(An)c(arra)n(y)c(holding)j(the)g(lo)n(w)n(er)e(b)r(ounds)j(of)e
+(a)h(rectangular)e(region)h(within)h(the)g(P)n(olyMap's)f(input)h
+(space)427 551 y(\(if)g(F)n(OR)-9 b(W)g(ARD)26 b(is)e(.F)-9
+b(ALSE.\))26 b(or)e(output)h(space)g(\(if)h(F)n(OR)-9
+b(W)g(ARD)25 b(is)g(.TR)n(UE.\).)36 b(The)25 b(new)g(p)r(olynomial)427
+650 y(will)30 b(b)r(e)g(ev)-5 b(aluated)29 b(o)n(v)n(er)f(this)i
+(rectangle.)42 b(The)29 b(length)h(of)g(this)g(arra)n(y)d(should)i
+(equal)g(the)h(v)-5 b(alue)30 b(of)f(the)427 750 y(P)n(olyMap's)d(Nin)i
+(or)f(Nout)h(attribute,)g(dep)r(ending)g(on)f(F)n(OR)-9
+b(W)g(ARD.)259 882 y Fc(UBND\()32 b Fi(\003)g Fc(\))g(=)g(DOUBLE)g
+(PRECISION)f(\(Giv)m(en\))427 981 y Fj(An)25 b(arra)n(y)d(holding)i
+(the)h(upp)r(er)g(b)r(ounds)f(of)h(a)f(rectangular)e(region)h(within)j
+(the)e(P)n(olyMap's)f(input)i(space)427 1081 y(\(if)h(F)n(OR)-9
b(W)g(ARD)26 b(is)e(.F)-9 b(ALSE.\))26 b(or)e(output)h(space)g(\(if)h
(F)n(OR)-9 b(W)g(ARD)25 b(is)g(.TR)n(UE.\).)36 b(The)25
-b(new)g(p)r(olynomial)427 4016 y(will)30 b(b)r(e)g(ev)-5
+b(new)g(p)r(olynomial)427 1181 y(will)30 b(b)r(e)g(ev)-5
b(aluated)29 b(o)n(v)n(er)f(this)i(rectangle.)42 b(The)29
b(length)h(of)g(this)g(arra)n(y)d(should)i(equal)g(the)h(v)-5
-b(alue)30 b(of)f(the)427 4116 y(P)n(olyMap's)d(Nin)i(or)f(Nout)h
+b(alue)30 b(of)f(the)427 1280 y(P)n(olyMap's)d(Nin)i(or)f(Nout)h
(attribute,)g(dep)r(ending)g(on)f(F)n(OR)-9 b(W)g(ARD.)259
-4253 y Fc(UBND\()32 b Fi(\003)g Fc(\))g(=)g(DOUBLE)g(PRECISION)f(\(Giv)
-m(en\))427 4352 y Fj(An)25 b(arra)n(y)d(holding)i(the)h(upp)r(er)g(b)r
-(ounds)f(of)h(a)f(rectangular)e(region)h(within)j(the)e(P)n(olyMap's)f
-(input)i(space)427 4452 y(\(if)h(F)n(OR)-9 b(W)g(ARD)26
-b(is)e(.F)-9 b(ALSE.\))26 b(or)e(output)h(space)g(\(if)h(F)n(OR)-9
-b(W)g(ARD)25 b(is)g(.TR)n(UE.\).)36 b(The)25 b(new)g(p)r(olynomial)427
-4552 y(will)30 b(b)r(e)g(ev)-5 b(aluated)29 b(o)n(v)n(er)f(this)i
-(rectangle.)42 b(The)29 b(length)h(of)g(this)g(arra)n(y)d(should)i
-(equal)g(the)h(v)-5 b(alue)30 b(of)f(the)427 4651 y(P)n(olyMap's)d(Nin)
-i(or)f(Nout)h(attribute,)g(dep)r(ending)g(on)f(F)n(OR)-9
-b(W)g(ARD.)259 4788 y Fc(ST)h(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h
-(and)g(Returned\))427 4888 y Fj(The)c(global)e(status.)0
-5058 y Fc(Returned)32 b(V)-8 b(alue:)259 5203 y(AST)p
-Ft(_)p Fc(POL)g(YTRAN)33 b(=)f(INTEGER)427 5303 y Fj(A)f(p)r(oin)n(ter)
-f(to)h(the)g(new)f(P)n(olyMap.)44 b(AST)p Ft(__)p Fj(NULL)31
+1412 y Fc(ST)h(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 1512 y Fj(The)c(global)e(status.)0 1673
+y Fc(Returned)32 b(V)-8 b(alue:)259 1809 y(AST)p Ft(_)p
+Fc(POL)g(YTRAN)33 b(=)f(INTEGER)427 1908 y Fj(A)f(p)r(oin)n(ter)f(to)h
+(the)g(new)f(P)n(olyMap.)44 b(AST)p Ft(__)p Fj(NULL)31
b(will)f(b)r(e)h(returned)f(if)h(the)g(\014t)g(fails)g(to)f(ac)n(hiev)n
-(e)f(the)427 5402 y(accuracy)d(sp)r(eci\014ed)i(b)n(y)f(MAXA)n(CC,)i
-(but)f(no)f(error)f(will)i(b)r(e)g(rep)r(orted.)0 5572
-y Fc(Notes:)p eop end
-%%Page: 318 328
-TeXDict begin 318 327 bop 0 52 a FG(318)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
-b Fj(This)24 b(function)g(can)f(only)g(b)r(e)g(used)h(on)f(1D)g(or)g
-(2D)g(P)n(olyMaps)f(whic)n(h)h(ha)n(v)n(e)f(the)i(same)f(n)n(um)n(b)r
-(er)g(of)g(inputs)427 451 y(and)28 b(outputs.)340 586
-y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f
-(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f
-(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427
-685 y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g
-(should)f(fail)h(for)f(an)n(y)g(reason.)p 0 889 3780
-12 v 0 1019 a FA(AST)p Fe(_)p FA(PRISM)724 b Fd(Create)37
-b(a)h(Prism)725 b FA(AST)p Fe(_)p FA(PRISM)0 1200 y Fc(Description:)44
-b Fj(This)28 b(function)g(creates)f(a)g(new)g(Prism)g(and)g(optionally)
-g(initialises)h(its)f(attributes.)227 1327 y(A)21 b(Prism)e(is)h(a)f
-(Region)g(whic)n(h)h(represen)n(ts)f(an)h(extrusion)f(of)h(an)f
-(existing)h(Region)f(in)n(to)h(one)g(or)f(more)g(orthogonal)227
-1426 y(dimensions)k(\(sp)r(eci\014ed)h(b)n(y)f(another)f(Region\).)35
-b(If)23 b(the)h(Region)e(to)h(b)r(e)h(extruded)f(has)f(N)i(axes,)f(and)
-g(the)g(Region)227 1526 y(de\014ning)36 b(the)f(extrusion)f(has)h(M)g
-(axes,)i(then)e(the)h(resulting)f(Prism)f(will)h(ha)n(v)n(e)f(\(M+N\))i
-(axes.)59 b(A)35 b(p)r(oin)n(t)h(is)227 1625 y(inside)28
-b(the)g(Prism)f(if)h(the)g(\014rst)f(N)h(axis)f(v)-5
+(e)f(the)427 2008 y(accuracy)d(sp)r(eci\014ed)i(b)n(y)f(MAXA)n(CC,)i
+(but)f(no)f(error)f(will)i(b)r(e)g(rep)r(orted.)0 2169
+y Fc(Notes:)340 2450 y Fi(\017)45 b Fj(This)24 b(function)g(can)f(only)
+g(b)r(e)g(used)h(on)f(1D)g(or)g(2D)g(P)n(olyMaps)f(whic)n(h)h(ha)n(v)n
+(e)f(the)i(same)f(n)n(um)n(b)r(er)g(of)g(inputs)427 2550
+y(and)28 b(outputs.)340 2682 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
+(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
+b(A)g(TUS)427 2782 y(set)28 b(to)f(an)h(error)d(v)-5
+b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
+0 2979 3780 12 v 0 3110 a FA(AST)p Fe(_)p FA(PRISM)724
+b Fd(Create)37 b(a)h(Prism)725 b FA(AST)p Fe(_)p FA(PRISM)0
+3285 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+(Prism)g(and)g(optionally)g(initialises)h(its)f(attributes.)227
+3409 y(A)21 b(Prism)e(is)h(a)f(Region)g(whic)n(h)h(represen)n(ts)f(an)h
+(extrusion)f(of)h(an)f(existing)h(Region)f(in)n(to)h(one)g(or)f(more)g
+(orthogonal)227 3509 y(dimensions)k(\(sp)r(eci\014ed)h(b)n(y)f(another)
+f(Region\).)35 b(If)23 b(the)h(Region)e(to)h(b)r(e)h(extruded)f(has)f
+(N)i(axes,)f(and)g(the)g(Region)227 3608 y(de\014ning)36
+b(the)f(extrusion)f(has)h(M)g(axes,)i(then)e(the)h(resulting)f(Prism)f
+(will)h(ha)n(v)n(e)f(\(M+N\))i(axes.)59 b(A)35 b(p)r(oin)n(t)h(is)227
+3708 y(inside)28 b(the)g(Prism)f(if)h(the)g(\014rst)f(N)h(axis)f(v)-5
b(alues)28 b(corresp)r(ond)e(to)h(a)g(p)r(oin)n(t)h(inside)g(the)g
-(Region)f(b)r(eing)h(extruded,)227 1725 y(and)g(the)g(remaining)e(M)i
+(Region)f(b)r(eing)h(extruded,)227 3808 y(and)g(the)g(remaining)e(M)i
(axis)f(v)-5 b(alues)27 b(corresp)r(ond)f(to)i(a)f(p)r(oin)n(t)h
(inside)f(the)h(Region)f(de\014ning)h(the)g(extrusion.)227
-1852 y(As)33 b(an)g(example,)h(a)f(cylinder)g(can)f(b)r(e)i(represen)n
+3932 y(As)33 b(an)g(example,)h(a)f(cylinder)g(can)f(b)r(e)i(represen)n
(ted)e(b)n(y)h(extruding)f(an)h(existing)g(Circle,)h(using)e(an)h(In)n
-(terv)-5 b(al)227 1951 y(to)31 b(de\014ne)g(the)g(extrusion.)46
+(terv)-5 b(al)227 4031 y(to)31 b(de\014ne)g(the)g(extrusion.)46
b(Ih)31 b(this)g(case,)g(the)g(In)n(terv)-5 b(al)30 b(w)n(ould)h(ha)n
(v)n(e)e(a)i(single)f(axis)g(and)h(w)n(ould)f(sp)r(ecify)h(the)227
-2051 y(upp)r(er)d(and)f(lo)n(w)n(er)f(limits)j(of)e(the)h(cylinder)f
-(along)g(its)g(length.)0 2204 y Fc(In)m(v)m(o)s(cation:)123
+4131 y(upp)r(er)d(and)f(lo)n(w)n(er)f(limits)j(of)e(the)h(cylinder)f
+(along)g(its)g(length.)0 4280 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_PRISM\()c(REGION1,)i(REGION2,)f(OPTIONS,)g
-(STATUS)h(\))0 2358 y Fc(Argumen)m(ts:)259 2498 y(REGION1)31
-b(=)h(INTEGER)f(\(Giv)m(en\))427 2598 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(Region)f(to)g(b)r(e)h(extruded.)259 2733
-y Fc(REGION2)j(=)h(INTEGER)f(\(Giv)m(en\))427 2832 y
+(STATUS)h(\))0 4428 y Fc(Argumen)m(ts:)259 4564 y(REGION1)31
+b(=)h(INTEGER)f(\(Giv)m(en\))427 4663 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(Region)f(to)g(b)r(e)h(extruded.)259 4795
+y Fc(REGION2)j(=)h(INTEGER)f(\(Giv)m(en\))427 4895 y
Fj(P)n(oin)n(ter)26 b(to)i(the)g(Region)f(de\014ning)g(the)h(exten)n(t)
-g(of)f(the)h(extrusion.)259 2967 y Fc(OPTIONS)k(=)g(CHARA)m(CTER)g
+g(of)f(the)h(extrusion.)259 5027 y Fc(OPTIONS)k(=)g(CHARA)m(CTER)g
Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-3067 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h(optional)g
+5127 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h(optional)g
(comma-separated)e(list)j(of)g(attribute)f(assignmen)n(ts)g(to)427
-3166 y(b)r(e)26 b(used)e(for)h(initialising)g(the)g(new)g(Prism.)35
+5226 y(b)r(e)26 b(used)e(for)h(initialising)g(the)g(new)g(Prism.)35
b(The)25 b(syn)n(tax)f(used)h(is)g(iden)n(tical)f(to)h(that)g(for)g
-(the)g(AST)p Ft(_)p Fj(SET)427 3266 y(routine.)259 3401
+(the)g(AST)p Ft(_)p Fj(SET)427 5326 y(routine.)259 5458
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 3500 y Fj(The)c(global)e(status.)0 3666 y Fc(Returned)32
-b(V)-8 b(alue:)259 3807 y(AST)p Ft(_)p Fc(PRISM)32 b(=)g(INTEGER)427
-3906 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(Prism.)0
-4072 y Fc(Notes:)340 4359 y Fi(\017)45 b Fj(Deep)37 b(copies)g(are)e
-(tak)n(en)i(of)f(the)i(supplied)f(Regions.)63 b(This)37
-b(means)f(that)i(an)n(y)e(subsequen)n(t)g(c)n(hanges)427
-4458 y(made)25 b(to)h(the)f(comp)r(onen)n(t)g(Regions)g(using)g(the)h
-(supplied)f(p)r(oin)n(ters)g(will)h(ha)n(v)n(e)e(no)h(e\013ect)h(on)f
-(the)g(Prism.)340 4593 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
-b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
-(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 4693 y(set)28 b(to)f(an)h(error)d(v)-5
-b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-0 4896 V 0 5027 a FA(AST)p Fe(_)p FA(PUR)l(GER)l(O)l(WS)1429
-5028 y Fd(Remo)m(v)m(e)37 b(all)h(empt)m(y)1441 5142
-y(ro)m(ws)f(from)h(a)g(table)2555 5027 y FA(AST)p Fe(_)p
-FA(PUR)l(GER)l(O)l(WS)0 5312 y Fc(Description:)44 b Fj(This)30
-b(function)h(remo)n(v)n(es)d(all)h(empt)n(y)h(ro)n(ws)e(from)i(the)g(T)
--7 b(able,)30 b(renaming)f(the)h(k)n(ey)g(asso)r(ciated)e(with)227
-5412 y(eac)n(h)f(table)h(cell)f(accordingly)-7 b(.)0
-5565 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_PURGEROWS\()37
-b(THIS,)42 b(STATUS)f(\))0 5718 y Fc(Argumen)m(ts:)p
-eop end
-%%Page: 319 329
-TeXDict begin 319 328 bop 3643 52 a FG(319)259 351 y
-Fc(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(T)-7 b(able.)259 605 y Fc(ST)f(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 705
-y Fj(The)c(global)e(status.)p 0 948 3780 12 v 0 1078
-a FA(AST)p Fe(_)p FA(PUR)l(GEW)l(CS)1324 1079 y Fd(Delete)39
-b(all)f(cards)g(in)g(the)1376 1179 y(FitsChan)g(describing)1439
-1293 y(W)m(CS)h(information)2655 1078 y FA(AST)p Fe(_)p
-FA(PUR)l(GEW)l(CS)0 1502 y Fc(Description:)44 b Fj(This)36
-b(routine)f(deletes)g(all)h(cards)e(in)i(a)f(FitsChan)h(that)f(relate)g
-(to)g(an)n(y)g(of)h(the)g(recognised)d(W)n(CS)227 1602
-y(enco)r(dings.)k(On)27 b(exit,)h(the)g(curren)n(t)e(card)h(is)h(the)g
-(\014rst)f(remaining)g(card)f(in)i(the)g(FitsChan.)0
-1795 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_PURGEWCS\()c
-(THIS,)j(STATUS)h(\))0 1988 y Fc(Argumen)m(ts:)259 2167
-y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 2267 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(FitsChan.)259 2421 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 2521
-y Fj(The)c(global)e(status.)p 0 2764 V 0 2894 a FA(AST)p
-Fe(_)p FA(PUTCARDS)1396 2895 y Fd(Store)38 b(a)g(set)h(of)f(FITS)1450
-2995 y(header)h(cards)f(in)h(a)1653 3095 y(FitsChan)2683
-2894 y FA(AST)p Fe(_)p FA(PUTCARDS)0 3303 y Fc(Description:)44
+427 5557 y Fj(The)c(global)e(status.)0 5718 y Fc(Returned)32
+b(V)-8 b(alue:)p eop end
+%%Page: 321 331
+TeXDict begin 321 330 bop 3643 52 a FG(321)259 351 y
+Fc(AST)p Ft(_)p Fc(PRISM)32 b(=)g(INTEGER)427 451 y Fj(A)c(p)r(oin)n
+(ter)f(to)h(the)g(new)g(Prism.)0 615 y Fc(Notes:)340
+900 y Fi(\017)45 b Fj(Deep)37 b(copies)g(are)e(tak)n(en)i(of)f(the)i
+(supplied)f(Regions.)63 b(This)37 b(means)f(that)i(an)n(y)e(subsequen)n
+(t)g(c)n(hanges)427 1000 y(made)25 b(to)h(the)f(comp)r(onen)n(t)g
+(Regions)g(using)g(the)h(supplied)f(p)r(oin)n(ters)g(will)h(ha)n(v)n(e)
+e(no)h(e\013ect)h(on)f(the)g(Prism.)340 1134 y Fi(\017)45
+b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
+Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 1233
+y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 1435 3780 12 v 0 1566
+a FA(AST)p Fe(_)p FA(PUR)l(GER)l(O)l(WS)1429 1567 y Fd(Remo)m(v)m(e)37
+b(all)h(empt)m(y)1441 1681 y(ro)m(ws)f(from)h(a)g(table)2555
+1566 y FA(AST)p Fe(_)p FA(PUR)l(GER)l(O)l(WS)0 1849 y
+Fc(Description:)44 b Fj(This)30 b(function)h(remo)n(v)n(es)d(all)h
+(empt)n(y)h(ro)n(ws)e(from)i(the)g(T)-7 b(able,)30 b(renaming)f(the)h
+(k)n(ey)g(asso)r(ciated)e(with)227 1949 y(eac)n(h)f(table)h(cell)f
+(accordingly)-7 b(.)0 2101 y Fc(In)m(v)m(o)s(cation:)123
+b Ft(CALL)42 b(AST_PURGEROWS\()37 b(THIS,)42 b(STATUS)f(\))0
+2253 y Fc(Argumen)m(ts:)259 2391 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 2491 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(T)-7
+b(able.)259 2625 y Fc(ST)f(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)
+g(Returned\))427 2725 y Fj(The)c(global)e(status.)p 0
+2926 V 0 3057 a FA(AST)p Fe(_)p FA(PUR)l(GEW)l(CS)1324
+3058 y Fd(Delete)39 b(all)f(cards)g(in)g(the)1376 3158
+y(FitsChan)g(describing)1439 3272 y(W)m(CS)h(information)2655
+3057 y FA(AST)p Fe(_)p FA(PUR)l(GEW)l(CS)0 3440 y Fc(Description:)44
+b Fj(This)36 b(routine)f(deletes)g(all)h(cards)e(in)i(a)f(FitsChan)h
+(that)f(relate)g(to)g(an)n(y)g(of)h(the)g(recognised)d(W)n(CS)227
+3540 y(enco)r(dings.)k(On)27 b(exit,)h(the)g(curren)n(t)e(card)h(is)h
+(the)g(\014rst)f(remaining)g(card)f(in)i(the)g(FitsChan.)0
+3692 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_PURGEWCS\()c
+(THIS,)j(STATUS)h(\))0 3844 y Fc(Argumen)m(ts:)259 3982
+y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 4082 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(FitsChan.)259 4216 y Fc(ST)-8 b(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 4316
+y Fj(The)c(global)e(status.)p 0 4517 V 0 4648 a FA(AST)p
+Fe(_)p FA(PUTCARDS)1396 4649 y Fd(Store)38 b(a)g(set)h(of)f(FITS)1450
+4749 y(header)h(cards)f(in)h(a)1653 4848 y(FitsChan)2683
+4648 y FA(AST)p Fe(_)p FA(PUTCARDS)0 5016 y Fc(Description:)44
b Fj(This)36 b(routine)e(stores)g(a)h(set)g(of)h(FITS)f(header)f(cards)
h(in)g(a)g(FitsChan.)60 b(The)35 b(cards)f(are)g(supplied)227
-3403 y(concatenated)41 b(together)f(in)n(to)h(a)g(single)g(c)n
+5116 y(concatenated)41 b(together)f(in)n(to)h(a)g(single)g(c)n
(haracter)e(string.)78 b(An)n(y)41 b(existing)g(cards)f(in)h(the)h
-(FitsChan)g(are)227 3503 y(remo)n(v)n(ed)24 b(b)r(efore)g(the)i(new)f
+(FitsChan)g(are)227 5216 y(remo)n(v)n(ed)24 b(b)r(efore)g(the)i(new)f
(cards)f(are)g(added.)35 b(The)25 b(FitsChan)g(is)g Ft(")p
Fj(re-w)n(ound)p Ft(")e Fj(on)i(exit)g(b)n(y)g(clearing)e(its)i(Card)
-227 3602 y(attribute.)67 b(This)38 b(means)f(that)h(a)f(subsequen)n(t)h
+227 5315 y(attribute.)67 b(This)38 b(means)f(that)h(a)f(subsequen)n(t)h
(in)n(v)n(o)r(cation)e(of)i(AST)p Ft(_)p Fj(READ)g(can)f(b)r(e)h(made)f
-(immediately)227 3702 y(without)28 b(the)g(need)g(to)f(re-wind)h(the)f
-(FitsChan)h(\014rst.)0 3895 y Fc(In)m(v)m(o)s(cation:)123
+(immediately)227 5415 y(without)28 b(the)g(need)g(to)f(re-wind)h(the)f
+(FitsChan)h(\014rst.)0 5567 y Fc(In)m(v)m(o)s(cation:)123
b Ft(CALL)42 b(AST_PUTCARDS\()c(THIS,)j(CARDS,)h(STATUS)f(\))0
-4087 y Fc(Argumen)m(ts:)259 4267 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 4367 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
-4521 y Fc(CARDS)k(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 4621 y Fj(A)39 b(c)n(haracter)e
+5718 y Fc(Argumen)m(ts:)p eop end
+%%Page: 322 332
+TeXDict begin 322 331 bop 0 52 a FG(322)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(THIS)h(=)g(INTEGER)g
+(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
+582 y Fc(CARDS)k(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 681 y Fj(A)39 b(c)n(haracter)e
(string)h(con)n(taining)g(the)h(FITS)h(cards)d(to)i(b)r(e)g(stored.)70
-b(Eac)n(h)38 b(individual)h(card)f(should)427 4721 y(o)r(ccup)n(y)23
+b(Eac)n(h)38 b(individual)h(card)f(should)427 781 y(o)r(ccup)n(y)23
b(80)g(c)n(haracters)f(in)h(this)h(string,)g(and)g(there)f(should)h(b)r
(e)g(no)f(delimiters,)i(new)e(lines,)i(etc,)g(b)r(et)n(w)n(een)427
-4820 y(adjacen)n(t)i(cards.)36 b(The)28 b(\014nal)f(card)g(ma)n(y)g(b)r
-(e)h(less)f(than)h(80)e(c)n(haracters)g(long.)259 4975
+881 y(adjacen)n(t)i(cards.)36 b(The)28 b(\014nal)f(card)g(ma)n(y)g(b)r
+(e)h(less)f(than)h(80)e(c)n(haracters)g(long.)259 1011
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 5074 y Fj(The)c(global)e(status.)0 5280 y Fc(Notes:)340
-5605 y Fi(\017)45 b Fj(An)28 b(error)e(will)i(result)f(if)h(the)g
+427 1111 y Fj(The)c(global)e(status.)0 1271 y Fc(Notes:)340
+1551 y Fi(\017)45 b Fj(An)28 b(error)e(will)i(result)f(if)h(the)g
(supplied)g(string)f(con)n(tains)g(an)n(y)f(cards)h(whic)n(h)h(cannot)f
-(b)r(e)h(in)n(terpreted.)p eop end
-%%Page: 320 330
-TeXDict begin 320 329 bop 0 52 a FG(320)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(PUTCOLUMND)l(A)-11 b(T)g(A)1761
-500 y Fd(Store)1789 599 y(new)1776 699 y(data)1797 798
-y(v)k(al-)1808 898 y(ues)1820 998 y(for)1828 1097 y(all)1774
-1197 y(ro)m(ws)1794 1297 y(of)38 b(a)1799 1396 y(col-)1776
-1496 y(umn)2171 482 y FA(AST)p Fe(_)p FA(PUTCOLUMND)l(A)-11
-b(T)g(A)0 1648 y Fc(Description:)44 b Fj(This)34 b(routine)f(copies)g
+(b)r(e)h(in)n(terpreted.)p 0 1746 3780 12 v 0 1877 a
+FA(AST)p Fe(_)p FA(PUTCOLUMND)l(A)-11 b(T)g(A)1761 1894
+y Fd(Store)1789 1994 y(new)1776 2094 y(data)1797 2193
+y(v)k(al-)1808 2293 y(ues)1820 2393 y(for)1828 2492 y(all)1774
+2592 y(ro)m(ws)1794 2691 y(of)38 b(a)1799 2791 y(col-)1776
+2891 y(umn)2171 1877 y FA(AST)p Fe(_)p FA(PUTCOLUMND)l(A)-11
+b(T)g(A)0 3052 y Fc(Description:)44 b Fj(This)34 b(routine)f(copies)g
(data)g(v)-5 b(alues)34 b(from)f(a)g(supplied)h(bu\013er)g(in)n(to)f(a)
-h(named)f(column.)55 b(The)34 b(\014rst)227 1747 y(elemen)n(t)d(in)g
+h(named)f(column.)55 b(The)34 b(\014rst)227 3152 y(elemen)n(t)d(in)g
(the)g(bu\013er)g(b)r(ecomes)f(the)i(\014rst)e(elemen)n(t)h(in)g(the)g
(\014rst)f(ro)n(w)g(of)h(the)g(column.)46 b(If)31 b(the)g(bu\013er)g
-(do)r(es)227 1847 y(not)d(completely)f(\014ll)h(the)g(column,)g(then)g
+(do)r(es)227 3251 y(not)d(completely)f(\014ll)h(the)g(column,)g(then)g
(an)n(y)f(trailing)g(ro)n(ws)f(are)g(\014lled)i(with)g(n)n(ull)g(v)-5
-b(alues.)0 1989 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
+b(alues.)0 3399 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
b(AST_PUTCOLUMNDA)o(TA\()37 b(THIS,)k(COLUMN,)g(CLEN,)h(SIZE,)f
-(COLDATA,)f(STATUS)h(\))0 2132 y Fc(Argumen)m(ts:)259
-2261 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 2361
+(COLDATA,)f(STATUS)h(\))0 3546 y Fc(Argumen)m(ts:)259
+3680 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 3780
y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsT)-7 b(able.)259
-2487 y Fc(COLUMN)32 b(=)g(CHARA)m(CTER)f Fi(\003)h Fc(\()g
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 2586 y Fj(The)c(c)n(haracter)d
+3911 y Fc(COLUMN)32 b(=)g(CHARA)m(CTER)f Fi(\003)h Fc(\()g
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 4010 y Fj(The)c(c)n(haracter)d
(string)i(holding)h(the)g(name)f(of)g(the)h(column.)37
-b(T)-7 b(railing)27 b(spaces)g(are)f(ignored.)259 2712
-y Fc(CLEN)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 2812 y
+b(T)-7 b(railing)27 b(spaces)g(are)f(ignored.)259 4141
+y Fc(CLEN)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 4241 y
Fj(If)26 b(the)f(column)g(holds)g(c)n(haracter)e(strings,)i(then)h
(this)f(m)n(ust)g(b)r(e)h(set)f(to)g(the)h(length)f(of)g(eac)n(h)f
-(\014xed)i(length)427 2911 y(string)h(in)g(the)h(supplied)g(arra)n(y)-7
+(\014xed)i(length)427 4340 y(string)h(in)g(the)h(supplied)g(arra)n(y)-7
b(.)34 b(This)27 b(is)g(often)h(determined)f(b)n(y)g(the)h(appropriate)
-d(TF)n(ORMn)i(k)n(eyw)n(ord)427 3011 y(in)21 b(the)g(binary)e(table)h
+d(TF)n(ORMn)i(k)n(eyw)n(ord)427 4440 y(in)21 b(the)g(binary)e(table)h
(header.)34 b(The)20 b(supplied)h(v)-5 b(alue)20 b(is)g(ignored)f(if)i
(the)g(column)f(do)r(es)g(not)g(hold)h(c)n(haracter)427
-3111 y(data.)259 3237 y Fc(SIZE)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
-3336 y Fj(The)26 b(size)g(of)g(the)h(COLD)n(A)-7 b(T)g(A)26
+4540 y(data.)259 4670 y Fc(SIZE)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
+4770 y Fj(The)26 b(size)g(of)g(the)h(COLD)n(A)-7 b(T)g(A)26
b(arra)n(y)-7 b(,)25 b(in)h(b)n(ytes.)36 b(This)26 b(should)g(b)r(e)g
(an)g(in)n(teger)g(m)n(ultiple)g(of)g(the)h(n)n(um)n(b)r(er)427
-3436 y(of)f(b)n(ytes)g(needed)h(to)f(hold)g(the)h(full)g(v)n(ector)e(v)
+4870 y(of)f(b)n(ytes)g(needed)h(to)f(hold)g(the)h(full)g(v)n(ector)e(v)
-5 b(alue)26 b(stored)f(in)i(a)e(single)h(cell)g(of)h(the)f(column.)37
-b(An)26 b(error)f(is)427 3536 y(rep)r(orted)i(if)h(this)g(is)g(not)f
-(the)h(case.)259 3661 y Fc(COLD)m(A)-8 b(T)g(A\()34 b
-Fi(\003)d Fc(\))h(=)g(BYTE)g(\(Giv)m(en\))427 3761 y
+b(An)26 b(error)f(is)427 4969 y(rep)r(orted)i(if)h(this)g(is)g(not)f
+(the)h(case.)259 5100 y Fc(COLD)m(A)-8 b(T)g(A\()34 b
+Fi(\003)d Fc(\))h(=)g(BYTE)g(\(Giv)m(en\))427 5200 y
Fj(An)25 b(area)e(of)i(memory)f(holding)g(the)h(data)f(to)g(cop)n(y)g
(in)n(to)h(the)g(column.)35 b(The)25 b(v)-5 b(alues)24
-b(should)h(b)r(e)g(stored)e(in)427 3861 y(ro)n(w)h(order.)35
+b(should)h(b)r(e)g(stored)e(in)427 5299 y(ro)n(w)h(order.)35
b(If)25 b(the)h(column)f(holds)g(non-scalar)e(v)-5 b(alues,)25
b(the)h(elemen)n(ts)f(of)g(eac)n(h)f(v)-5 b(alue)25 b(should)g(b)r(e)g
-(stored)427 3960 y(in)j Ft(")p Fj(F)-7 b(ortran)p Ft(")26
+(stored)427 5399 y(in)j Ft(")p Fj(F)-7 b(ortran)p Ft(")26
b Fj(order.)35 b(No)28 b(data)f(t)n(yp)r(e)h(con)n(v)n(ersion)d(is)i(p)
-r(erformed.)259 4086 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m
-(en)h(and)g(Returned\))427 4186 y Fj(The)c(global)e(status.)p
-0 4371 V 0 4502 a FA(AST)p Fe(_)p FA(PUTFITS)1118 4503
-y Fd(Store)38 b(a)h(FITS)g(header)f(card)g(in)h(a)1653
-4602 y(FitsChan)2857 4502 y FA(AST)p Fe(_)p FA(PUTFITS)0
-4754 y Fc(Description:)44 b Fj(This)28 b(routine)f(stores)g(a)g(FITS)i
-(header)d(card)h(in)h(a)g(FitsChan.)37 b(The)28 b(card)f(is)h(either)f
-(inserted)h(b)r(efore)227 4854 y(the)g(curren)n(t)f(card)g(\(iden)n
-(ti\014ed)h(b)n(y)f(the)h(Card)f(attribute\),)h(or)f(o)n(v)n(er-writes)
-e(the)j(curren)n(t)f(card,)f(as)h(required.)0 4996 y
-Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_PUTFITS\()c(THIS,)k
-(CARD,)f(OVERWRITE,)f(STATUS)h(\))0 5139 y Fc(Argumen)m(ts:)259
-5268 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 5368
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259 5494
-y Fc(CARD)k(=)g(CHARA)m(CTER)f Fi(\003)h Fc(\()g(80)f(\))h(\(Giv)m
-(en\))427 5593 y Fj(A)26 b(c)n(haracter)e(string)h(string)f(con)n
+r(erformed.)259 5530 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m
+(en)h(and)g(Returned\))427 5629 y Fj(The)c(global)e(status.)p
+eop end
+%%Page: 323 333
+TeXDict begin 323 332 bop 3643 52 a FG(323)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(PUTFITS)1118 483 y Fd(Store)38
+b(a)h(FITS)g(header)f(card)g(in)h(a)1653 583 y(FitsChan)2857
+482 y FA(AST)p Fe(_)p FA(PUTFITS)0 741 y Fc(Description:)44
+b Fj(This)28 b(routine)f(stores)g(a)g(FITS)i(header)d(card)h(in)h(a)g
+(FitsChan.)37 b(The)28 b(card)f(is)h(either)f(inserted)h(b)r(efore)227
+841 y(the)g(curren)n(t)f(card)g(\(iden)n(ti\014ed)h(b)n(y)f(the)h(Card)
+f(attribute\),)h(or)f(o)n(v)n(er-writes)e(the)j(curren)n(t)f(card,)f
+(as)h(required.)0 987 y Fc(In)m(v)m(o)s(cation:)123 b
+Ft(CALL)42 b(AST_PUTFITS\()c(THIS,)k(CARD,)f(OVERWRITE,)f(STATUS)h(\))0
+1132 y Fc(Argumen)m(ts:)259 1265 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 1365 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
+1494 y Fc(CARD)k(=)g(CHARA)m(CTER)f Fi(\003)h Fc(\()g(80)f(\))h(\(Giv)m
+(en\))427 1594 y Fj(A)26 b(c)n(haracter)e(string)h(string)f(con)n
(taining)h(the)h(FITS)g(card)f(to)g(b)r(e)h(stored.)35
-b(No)26 b(more)f(than)g(80)g(c)n(haracters)427 5693 y(will)j(b)r(e)g
-(used)g(from)f(this)h(string.)p eop end
-%%Page: 321 331
-TeXDict begin 321 330 bop 3643 52 a FG(321)259 351 y
-Fc(O)m(VER)-11 b(WRITE)32 b(=)g(LOGICAL)g(\(Giv)m(en\))427
-451 y Fj(If)26 b(this)h(v)-5 b(alue)25 b(is)h(.F)-9 b(ALSE.,)26
-b(the)g(new)g(card)f(is)h(inserted)f(in)h(fron)n(t)g(of)f(the)h(curren)
-n(t)f(card)g(in)h(the)h(FitsChan)427 551 y(\(as)22 b(iden)n(ti\014ed)h
-(b)n(y)f(the)g(initial)h(v)-5 b(alue)22 b(of)g(the)h(Card)e
-(attribute\).)36 b(If)23 b(it)f(is)g(.TR)n(UE.,)i(the)e(new)g(card)g
-(replaces)427 650 y(the)35 b(curren)n(t)e(card.)55 b(In)35
-b(either)f(case,)h(the)f(Card)f(attribute)h(is)g(then)h(incremen)n(ted)
-f(b)n(y)g(one)f(so)h(that)g(it)427 750 y(subsequen)n(tly)27
-b(iden)n(ti\014es)h(the)g(card)f(follo)n(wing)f(the)i(one)g(stored.)259
-886 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 985 y Fj(The)c(global)e(status.)0 1154
-y Fc(Notes:)340 1443 y Fi(\017)45 b Fj(If)28 b(the)g(Card)e(attribute)h
-(initially)h(p)r(oin)n(ts)f(at)g(the)h Ft(")p Fj(end-of-\014le)p
-Ft(")e Fj(\(i.e.)37 b(exceeds)26 b(the)i(n)n(um)n(b)r(er)f(of)g(cards)f
-(in)427 1543 y(the)i(FitsChan\),)g(then)g(the)g(new)g(card)f(is)g(app)r
-(ended)h(as)f(the)h(last)f(card)g(in)h(the)g(FitsChan.)340
-1679 y Fi(\017)45 b Fj(An)28 b(error)e(will)i(result)f(if)h(the)g
-(supplied)g(string)f(cannot)g(b)r(e)h(in)n(terpreted)f(as)g(a)g(FITS)h
-(header)f(card.)p 0 1884 3780 12 v 0 2015 a FA(AST)p
-Fe(_)p FA(PUTLINE)1215 2016 y Fd(Store)38 b(a)g(text)g(line)g(read)g(b)
-m(y)h(a)1298 2131 y(Channel)e(source)i(routine)2835 2015
-y FA(AST)p Fe(_)p FA(PUTLINE)0 2303 y Fc(Description:)44
-b Fj(This)33 b(routine)f(should)g(only)g(b)r(e)h(used)f(when)g
-(implemen)n(ting)h(a)f(routine)g(whic)n(h)g(will)h(b)r(e)g(passed)e(as)
-227 2402 y(the)d(SOUR)n(CE)f(argumen)n(t)g(to)g(AST)p
-Ft(_)p Fj(CHANNEL.)h(It)g(should)g(b)r(e)g(used)g(to)f(pass)g(bac)n(k)g
-(\(to)h(the)g(AST)g(library\))227 2502 y(eac)n(h)h(line)h(of)f(text)h
-(read)e(from)h(the)h(external)f(data)g(source.)41 b(One)29
-b(suc)n(h)g(line)g(should)h(b)r(e)f(passed)g(bac)n(k)g(in)g(this)227
-2602 y(w)n(a)n(y)e(for)g(eac)n(h)f(in)n(v)n(o)r(cation)h(of)g(the)h
-(source)f(routine.)0 2758 y Fc(In)m(v)m(o)s(cation:)123
-b Ft(CALL)42 b(AST_PUTLINE\()c(LINE,)k(L,)h(STATUS)e(\))0
-2914 y Fc(Argumen)m(ts:)259 3057 y(LINE)32 b(=)g(CHARA)m(CTER)g
-Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-3156 y Fj(A)c(c)n(haracter)e(string)h(con)n(taining)f(the)i(line)g(of)g
-(input)g(text)g(whic)n(h)f(has)h(b)r(een)g(read.)259
-3292 y Fc(L)k(=)g(INTEGER)g(\(Giv)m(en\))427 3392 y Fj(The)i(n)n(um)n
-(b)r(er)f(of)h(c)n(haracters)d(in)j(the)g(input)g(line,)h(whic)n(h)f
-(ma)n(y)f(b)r(e)g(zero.)54 b(If)34 b(there)f(is)h(no)f(more)g(input)427
-3492 y(a)n(v)-5 b(ailable)24 b(\(e.g.)35 b(an)25 b(end)g(of)f(\014le)h
-(has)f(b)r(een)h(reac)n(hed\),)g(this)g(v)-5 b(alue)24
-b(should)h(b)r(e)g(set)f(negativ)n(e)g(and)g(this)h(will)427
-3591 y(terminate)j(the)g(read)e(op)r(eration)h(on)g(the)h(Channel.)259
-3727 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 3827 y Fj(The)c(global)e(status.)0 3995
-y Fc(Notes:)340 4284 y Fi(\017)45 b Fj(This)28 b(routine)f(is)h(only)f
-(a)n(v)-5 b(ailable)26 b(in)i(the)g(F)-7 b(ortran)26
-b(in)n(terface)h(to)h(the)g(AST)g(library)-7 b(.)p 0
-4490 V 0 4621 a FA(AST)p Fe(_)p FA(PUTT)c(ABLE)1284 4622
-y Fd(Store)37 b(a)i(single)f(FitsT)-10 b(able)1536 4736
-y(in)38 b(a)h(FitsChan)2711 4621 y FA(AST)p Fe(_)p FA(PUTT)-11
-b(ABLE)0 4908 y Fc(Description:)44 b Fj(This)e(routine)f(allo)n(ws)f(a)
-h(represen)n(tation)f(of)h(a)g(single)g(FITS)h(binary)f(table)g(to)h(b)
-r(e)g(stored)e(in)i(a)227 5008 y(FitsChan.)c(F)-7 b(or)28
+b(No)26 b(more)f(than)g(80)g(c)n(haracters)427 1693 y(will)j(b)r(e)g
+(used)g(from)f(this)h(string.)259 1823 y Fc(O)m(VER)-11
+b(WRITE)32 b(=)g(LOGICAL)g(\(Giv)m(en\))427 1922 y Fj(If)26
+b(this)h(v)-5 b(alue)25 b(is)h(.F)-9 b(ALSE.,)26 b(the)g(new)g(card)f
+(is)h(inserted)f(in)h(fron)n(t)g(of)f(the)h(curren)n(t)f(card)g(in)h
+(the)h(FitsChan)427 2022 y(\(as)22 b(iden)n(ti\014ed)h(b)n(y)f(the)g
+(initial)h(v)-5 b(alue)22 b(of)g(the)h(Card)e(attribute\).)36
+b(If)23 b(it)f(is)g(.TR)n(UE.,)i(the)e(new)g(card)g(replaces)427
+2122 y(the)35 b(curren)n(t)e(card.)55 b(In)35 b(either)f(case,)h(the)f
+(Card)f(attribute)h(is)g(then)h(incremen)n(ted)f(b)n(y)g(one)f(so)h
+(that)g(it)427 2221 y(subsequen)n(tly)27 b(iden)n(ti\014es)h(the)g
+(card)f(follo)n(wing)f(the)i(one)g(stored.)259 2350 y
+Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+2450 y Fj(The)c(global)e(status.)0 2608 y Fc(Notes:)340
+2887 y Fi(\017)45 b Fj(If)28 b(the)g(Card)e(attribute)h(initially)h(p)r
+(oin)n(ts)f(at)g(the)h Ft(")p Fj(end-of-\014le)p Ft(")e
+Fj(\(i.e.)37 b(exceeds)26 b(the)i(n)n(um)n(b)r(er)f(of)g(cards)f(in)427
+2987 y(the)i(FitsChan\),)g(then)g(the)g(new)g(card)f(is)g(app)r(ended)h
+(as)f(the)h(last)f(card)g(in)h(the)g(FitsChan.)340 3116
+y Fi(\017)45 b Fj(An)28 b(error)e(will)i(result)f(if)h(the)g(supplied)g
+(string)f(cannot)g(b)r(e)h(in)n(terpreted)f(as)g(a)g(FITS)h(header)f
+(card.)p 0 3308 V 0 3439 a FA(AST)p Fe(_)p FA(PUTLINE)1215
+3440 y Fd(Store)38 b(a)g(text)g(line)g(read)g(b)m(y)h(a)1298
+3555 y(Channel)e(source)i(routine)2835 3439 y FA(AST)p
+Fe(_)p FA(PUTLINE)0 3713 y Fc(Description:)44 b Fj(This)33
+b(routine)f(should)g(only)g(b)r(e)h(used)f(when)g(implemen)n(ting)h(a)f
+(routine)g(whic)n(h)g(will)h(b)r(e)g(passed)e(as)227
+3813 y(the)d(SOUR)n(CE)f(argumen)n(t)g(to)g(AST)p Ft(_)p
+Fj(CHANNEL.)h(It)g(should)g(b)r(e)g(used)g(to)f(pass)g(bac)n(k)g(\(to)h
+(the)g(AST)g(library\))227 3912 y(eac)n(h)h(line)h(of)f(text)h(read)e
+(from)h(the)h(external)f(data)g(source.)41 b(One)29 b(suc)n(h)g(line)g
+(should)h(b)r(e)f(passed)g(bac)n(k)g(in)g(this)227 4012
+y(w)n(a)n(y)e(for)g(eac)n(h)f(in)n(v)n(o)r(cation)h(of)g(the)h(source)f
+(routine.)0 4158 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
+b(AST_PUTLINE\()c(LINE,)k(L,)h(STATUS)e(\))0 4304 y Fc(Argumen)m(ts:)
+259 4437 y(LINE)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 4536 y Fj(A)c(c)n(haracter)e(string)
+h(con)n(taining)f(the)i(line)g(of)g(input)g(text)g(whic)n(h)f(has)h(b)r
+(een)g(read.)259 4666 y Fc(L)k(=)g(INTEGER)g(\(Giv)m(en\))427
+4765 y Fj(The)i(n)n(um)n(b)r(er)f(of)h(c)n(haracters)d(in)j(the)g
+(input)g(line,)h(whic)n(h)f(ma)n(y)f(b)r(e)g(zero.)54
+b(If)34 b(there)f(is)h(no)f(more)g(input)427 4865 y(a)n(v)-5
+b(ailable)24 b(\(e.g.)35 b(an)25 b(end)g(of)f(\014le)h(has)f(b)r(een)h
+(reac)n(hed\),)g(this)g(v)-5 b(alue)24 b(should)h(b)r(e)g(set)f
+(negativ)n(e)g(and)g(this)h(will)427 4964 y(terminate)j(the)g(read)e
+(op)r(eration)h(on)g(the)h(Channel.)259 5094 y Fc(ST)-8
+b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+5193 y Fj(The)c(global)e(status.)0 5352 y Fc(Notes:)340
+5631 y Fi(\017)45 b Fj(This)28 b(routine)f(is)h(only)f(a)n(v)-5
+b(ailable)26 b(in)i(the)g(F)-7 b(ortran)26 b(in)n(terface)h(to)h(the)g
+(AST)g(library)-7 b(.)p eop end
+%%Page: 324 334
+TeXDict begin 324 333 bop 0 52 a FG(324)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(PUTT)-11 b(ABLE)1284 483
+y Fd(Store)37 b(a)i(single)f(FitsT)-10 b(able)1536 598
+y(in)38 b(a)h(FitsChan)2711 482 y FA(AST)p Fe(_)p FA(PUTT)-11
+b(ABLE)0 747 y Fc(Description:)44 b Fj(This)e(routine)f(allo)n(ws)f(a)h
+(represen)n(tation)f(of)h(a)g(single)g(FITS)h(binary)f(table)g(to)h(b)r
+(e)g(stored)e(in)i(a)227 847 y(FitsChan.)c(F)-7 b(or)28
b(instance,)f(this)i(ma)n(y)e(pro)n(vide)g(the)h(co)r(ordinate)f(lo)r
(ok-up)g(tables)g(needed)h(sub)r(equen)n(tly)g(when)227
-5108 y(reading)e(FITS-W)n(CS)i(headers)e(for)h(axes)f(describ)r(ed)h
+946 y(reading)e(FITS-W)n(CS)i(headers)e(for)h(axes)f(describ)r(ed)h
(using)g(the)g Ft(")p Fj(-T)-7 b(AB)p Ft(")27 b Fj(algorithm.)35
-b(Since,)28 b(in)f(general,)f(the)227 5207 y(calling)21
+b(Since,)28 b(in)f(general,)f(the)227 1046 y(calling)21
b(application)h(ma)n(y)f(not)h(kno)n(w)f(whic)n(h)g(tables)h(will)g(b)r
(e)g(needed)g(-)g(if)g(an)n(y)f(-)h(prior)e(to)i(calling)f(AST)p
-Ft(_)p Fj(READ,)227 5307 y(the)32 b(AST)p Ft(_)p Fj(T)-7
+Ft(_)p Fj(READ,)227 1146 y(the)32 b(AST)p Ft(_)p Fj(T)-7
b(ABLESOUR)n(CE)31 b(routine)g(pro)n(vides)g(an)g(alternativ)n(e)f(mec)
-n(hanism)i(in)g(whic)n(h)f(a)h(caller-supplied)227 5407
+n(hanism)i(in)g(whic)n(h)f(a)h(caller-supplied)227 1245
y(function)c(is)g(in)n(v)n(ok)n(ed)e(to)i(store)e(a)h(named)h(table)f
-(in)h(the)g(FitsChan.)0 5563 y Fc(In)m(v)m(o)s(cation:)123
+(in)h(the)g(FitsChan.)0 1387 y Fc(In)m(v)m(o)s(cation:)123
b Ft(CALL)42 b(AST_PUTTABLE\()c(THIS,)j(TABLE,)h(EXTNAM,)e(STATUS)h(\))
-0 5718 y Fc(Argumen)m(ts:)p eop end
-%%Page: 322 332
-TeXDict begin 322 331 bop 0 52 a FG(322)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(THIS)h(=)g(INTEGER)g
-(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
-579 y Fc(T)-8 b(ABLE)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
-679 y Fj(P)n(oin)n(ter)38 b(to)h(a)g(FitsT)-7 b(able)39
+0 1528 y Fc(Argumen)m(ts:)259 1656 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 1756 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
+1881 y Fc(T)-8 b(ABLE)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
+1980 y Fj(P)n(oin)n(ter)38 b(to)h(a)g(FitsT)-7 b(able)39
b(to)g(b)r(e)h(added)f(to)g(the)g(FitsChan.)72 b(If)40
b(a)e(FitsT)-7 b(able)40 b(with)f(the)h(asso)r(ciated)427
-779 y(extension)26 b(name)h(already)e(exists)h(in)h(the)g(FitsChan,)f
+2080 y(extension)26 b(name)h(already)e(exists)h(in)h(the)g(FitsChan,)f
(it)h(is)g(replaced)e(with)i(the)g(new)g(one.)36 b(A)27
-b(deep)f(cop)n(y)427 878 y(of)h(the)g(FitsT)-7 b(able)26
+b(deep)f(cop)n(y)427 2180 y(of)h(the)g(FitsT)-7 b(able)26
b(is)h(stored)e(in)i(the)g(FitsChan,)g(so)f(an)n(y)g(subsequen)n(t)g(c)
-n(hanges)f(made)h(to)h(the)g(FitsT)-7 b(able)427 978
+n(hanges)f(made)h(to)h(the)g(FitsT)-7 b(able)427 2279
y(will)28 b(ha)n(v)n(e)f(no)g(e\013ect)h(on)f(the)h(b)r(eha)n(viour)f
-(of)g(the)h(FitsChan.)259 1106 y Fc(EXTNAM)k(=)g(CHARA)m(CTER)f
+(of)g(the)h(FitsChan.)259 2404 y Fc(EXTNAM)k(=)g(CHARA)m(CTER)f
Fi(\003)h Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-1206 y Fj(The)c(name)f(of)h(the)g(FITS)g(extension)f(asso)r(ciated)f
-(with)i(the)g(table.)259 1335 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 1434
-y Fj(The)c(global)e(status.)0 1592 y Fc(Notes:)340 1870
+2504 y Fj(The)c(name)f(of)h(the)g(FITS)g(extension)f(asso)r(ciated)f
+(with)i(the)g(table.)259 2629 y Fc(ST)-8 b(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 2728
+y Fj(The)c(global)e(status.)0 2882 y Fc(Notes:)340 3156
y Fi(\017)45 b Fj(T)-7 b(ables)27 b(stored)g(in)h(the)g(FitsChan)g(ma)n
(y)e(b)r(e)i(retriev)n(ed)f(using)g(AST)p Ft(_)p Fj(GETT)-7
-b(ABLES.)340 1999 y Fi(\017)45 b Fj(The)28 b(AST)p Ft(_)p
+b(ABLES.)340 3281 y Fi(\017)45 b Fj(The)28 b(AST)p Ft(_)p
Fj(PUTT)-7 b(ABLES)27 b(metho)r(d)h(can)f(add)h(m)n(ultiple)g(FitsT)-7
-b(ables)27 b(in)h(a)f(single)g(call.)p 0 2189 3780 12
-v 0 2320 a FA(AST)p Fe(_)p FA(PUTT)-11 b(ABLEHEADER)1807
-2338 y Fd(Store)1807 2437 y(new)1807 2537 y(FITS)1807
-2636 y(head-)1818 2736 y(ers)1841 2836 y(in)1860 2935
-y(a)1807 3035 y(Fit-)1807 3135 y(sT)h(able)2124 2320
-y FA(AST)p Fe(_)p FA(PUTT)f(ABLEHEADER)0 3292 y Fc(Description:)44
+b(ables)27 b(in)h(a)f(single)g(call.)p 0 3464 V 0 3595
+a FA(AST)p Fe(_)p FA(PUTT)-11 b(ABLEHEADER)1807 3613
+y Fd(Store)1807 3712 y(new)1807 3812 y(FITS)1807 3912
+y(head-)1818 4011 y(ers)1841 4111 y(in)1860 4210 y(a)1807
+4310 y(Fit-)1807 4410 y(sT)h(able)2124 3595 y FA(AST)p
+Fe(_)p FA(PUTT)f(ABLEHEADER)0 4559 y Fc(Description:)44
b Fj(This)25 b(routine)e(stores)h(new)g(FITS)h(headers)e(in)h(the)h
(supplied)g(FitsT)-7 b(able.)35 b(An)n(y)25 b(existing)e(headers)h(are)
-227 3391 y(\014rst)k(deleted.)0 3536 y Fc(In)m(v)m(o)s(cation:)123
+227 4659 y(\014rst)k(deleted.)0 4800 y Fc(In)m(v)m(o)s(cation:)123
b Ft(CALL)42 b(AST_PUTTABLEHEA)o(DER)o(\()37 b(THIS,)42
-b(HEADER,)f(STATUS)g(\))0 3682 y Fc(Argumen)m(ts:)259
-3814 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 3913
+b(HEADER,)f(STATUS)g(\))0 4942 y Fc(Argumen)m(ts:)259
+5070 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 5170
y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsT)-7 b(able.)259
-4042 y Fc(HEADER)31 b(=)h(INTEGER)f(\(Giv)m(en\))427
-4141 y Fj(P)n(oin)n(ter)h(to)h(a)g(FitsChan)h(holding)f(the)h(headers)e
+5295 y Fc(HEADER)31 b(=)h(INTEGER)f(\(Giv)m(en\))427
+5394 y Fj(P)n(oin)n(ter)h(to)h(a)g(FitsChan)h(holding)f(the)h(headers)e
(for)h(the)h(FitsT)-7 b(able.)54 b(A)34 b(deep)g(cop)n(y)e(of)h(the)h
-(supplied)427 4241 y(FitsChan)19 b(is)g(stored)f(in)h(the)g(FitsT)-7
+(supplied)427 5494 y(FitsChan)19 b(is)g(stored)f(in)h(the)g(FitsT)-7
b(able,)21 b(replacing)c(the)i(curren)n(t)f(FitsChan)h(in)g(the)g
-(Fitstable.)35 b(Keyw)n(ords)427 4341 y(that)d(are)f(\014xed)h(either)g
+(Fitstable.)35 b(Keyw)n(ords)427 5593 y(that)d(are)f(\014xed)h(either)g
(b)n(y)g(the)g(prop)r(erties)f(of)h(the)g(T)-7 b(able,)33
b(or)e(b)n(y)h(the)g(FITS)g(standard,)g(are)f(remo)n(v)n(ed)427
-4440 y(from)d(the)g(cop)n(y)e(\(see)i Ft(")p Fj(Notes:)p
-Ft(")e Fj(b)r(elo)n(w\).)259 4569 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 4668
-y Fj(The)c(global)e(status.)0 4826 y Fc(Notes:)340 5104
-y Fi(\017)45 b Fj(The)27 b(attributes)f(of)h(the)g(supplied)g
+5693 y(from)d(the)g(cop)n(y)e(\(see)i Ft(")p Fj(Notes:)p
+Ft(")e Fj(b)r(elo)n(w\).)p eop end
+%%Page: 325 335
+TeXDict begin 325 334 bop 3643 52 a FG(325)259 351 y
+Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+451 y Fj(The)c(global)e(status.)0 664 y Fc(Notes:)340
+998 y Fi(\017)45 b Fj(The)27 b(attributes)f(of)h(the)g(supplied)g
(FitsChan,)g(together)e(with)i(an)n(y)f(source)f(and)i(sink)f
-(functions)h(asso)r(ci-)427 5204 y(ated)h(with)g(the)g(FitsChan,)g(are)
-e(copied)h(to)h(the)g(FitsT)-7 b(able.)340 5332 y Fi(\017)45
+(functions)h(asso)r(ci-)427 1098 y(ated)h(with)g(the)g(FitsChan,)g(are)
+e(copied)h(to)h(the)g(FitsT)-7 b(able.)340 1256 y Fi(\017)45
b Fj(V)-7 b(alues)30 b(for)g(the)g(follo)n(wing)f(k)n(eyw)n(ords)f(are)
h(generated)g(automatically)g(b)n(y)h(the)g(FitsT)-7
-b(able)30 b(\(an)n(y)g(v)-5 b(alues)427 5432 y(for)36
+b(able)30 b(\(an)n(y)g(v)-5 b(alues)427 1356 y(for)36
b(these)g(k)n(eyw)n(ords)d(in)j(the)h(supplied)f(FitsChan)g(will)g(b)r
(e)g(ignored\):)53 b Ft(")p Fj(XTENSION)p Ft(")p Fj(,)37
-b Ft(")p Fj(BITPIX)p Ft(")p Fj(,)427 5532 y Ft(")p Fj(NAXIS)p
+b Ft(")p Fj(BITPIX)p Ft(")p Fj(,)427 1455 y Ft(")p Fj(NAXIS)p
Ft(")p Fj(,)30 b Ft(")p Fj(NAXIS1)p Ft(")p Fj(,)f Ft(")p
Fj(NAXIS2)p Ft(")p Fj(,)h Ft(")p Fj(PCOUNT)p Ft(")p Fj(,)e
Ft(")p Fj(GCOUNT)p Ft(")p Fj(,)h Ft(")p Fj(TFIELDS)p
Ft(")p Fj(,)g Ft(")p Fj(TF)n(ORM\045d)p Ft(")p Fj(,)427
-5631 y Ft(")p Fj(TTYPE\045d)p Ft(")p Fj(,)e Ft(")p Fj(TNULL\045d)p
+1555 y Ft(")p Fj(TTYPE\045d)p Ft(")p Fj(,)e Ft(")p Fj(TNULL\045d)p
Ft(")p Fj(,)g Ft(")p Fj(THEAP)p Ft(")p Fj(,)g Ft(")p
-Fj(TDIM\045d)p Ft(")p Fj(.)p eop end
-%%Page: 323 333
-TeXDict begin 323 332 bop 3643 52 a FG(323)p 0 351 3780
-12 v 0 482 a FA(AST)p Fe(_)p FA(PUTT)-11 b(ABLES)284
-b Fd(Store)38 b(one)h(or)f(more)1508 581 y(FitsT)-10
-b(ables)38 b(in)g(a)1653 681 y(FitsChan)2636 482 y FA(AST)p
-Fe(_)p FA(PUTT)-11 b(ABLES)0 838 y Fc(Description:)44
-b Fj(This)31 b(routine)g(allo)n(ws)e(represen)n(tations)g(of)i(one)g
-(or)f(more)g(FITS)i(binary)e(tables)g(to)h(b)r(e)h(stored)e(in)h(a)227
-937 y(FitsChan.)36 b(F)-7 b(or)23 b(instance,)h(these)f(ma)n(y)g(pro)n
-(vide)f(the)i(co)r(ordinate)e(lo)r(ok-up)h(tables)g(needed)h(sub)r
-(equen)n(tly)f(when)227 1037 y(reading)j(FITS-W)n(CS)i(headers)e(for)h
-(axes)f(describ)r(ed)h(using)g(the)g Ft(")p Fj(-T)-7
-b(AB)p Ft(")27 b Fj(algorithm.)35 b(Since,)28 b(in)f(general,)f(the)227
-1136 y(calling)21 b(application)h(ma)n(y)f(not)h(kno)n(w)f(whic)n(h)g
-(tables)h(will)g(b)r(e)g(needed)g(-)g(if)g(an)n(y)f(-)h(prior)e(to)i
-(calling)f(AST)p Ft(_)p Fj(READ,)227 1236 y(the)32 b(AST)p
-Ft(_)p Fj(T)-7 b(ABLESOUR)n(CE)31 b(routine)g(pro)n(vides)g(an)g
-(alternativ)n(e)f(mec)n(hanism)i(in)g(whic)n(h)f(a)h(caller-supplied)
-227 1336 y(function)c(is)g(in)n(v)n(ok)n(ed)e(to)i(store)e(a)h(named)h
-(table)f(in)h(the)g(FitsChan.)0 1481 y Fc(In)m(v)m(o)s(cation:)123
+Fj(TDIM\045d)p Ft(")p Fj(.)p 0 1806 3780 12 v 0 1936
+a FA(AST)p Fe(_)p FA(PUTT)-11 b(ABLES)284 b Fd(Store)38
+b(one)h(or)f(more)1508 2036 y(FitsT)-10 b(ables)38 b(in)g(a)1653
+2135 y(FitsChan)2636 1936 y FA(AST)p Fe(_)p FA(PUTT)-11
+b(ABLES)0 2352 y Fc(Description:)44 b Fj(This)31 b(routine)g(allo)n(ws)
+e(represen)n(tations)g(of)i(one)g(or)f(more)g(FITS)i(binary)e(tables)g
+(to)h(b)r(e)h(stored)e(in)h(a)227 2452 y(FitsChan.)36
+b(F)-7 b(or)23 b(instance,)h(these)f(ma)n(y)g(pro)n(vide)f(the)i(co)r
+(ordinate)e(lo)r(ok-up)h(tables)g(needed)h(sub)r(equen)n(tly)f(when)227
+2552 y(reading)j(FITS-W)n(CS)i(headers)e(for)h(axes)f(describ)r(ed)h
+(using)g(the)g Ft(")p Fj(-T)-7 b(AB)p Ft(")27 b Fj(algorithm.)35
+b(Since,)28 b(in)f(general,)f(the)227 2651 y(calling)21
+b(application)h(ma)n(y)f(not)h(kno)n(w)f(whic)n(h)g(tables)h(will)g(b)r
+(e)g(needed)g(-)g(if)g(an)n(y)f(-)h(prior)e(to)i(calling)f(AST)p
+Ft(_)p Fj(READ,)227 2751 y(the)32 b(AST)p Ft(_)p Fj(T)-7
+b(ABLESOUR)n(CE)31 b(routine)g(pro)n(vides)g(an)g(alternativ)n(e)f(mec)
+n(hanism)i(in)g(whic)n(h)f(a)h(caller-supplied)227 2850
+y(function)c(is)g(in)n(v)n(ok)n(ed)e(to)i(store)e(a)h(named)h(table)f
+(in)h(the)g(FitsChan.)0 3051 y Fc(In)m(v)m(o)s(cation:)123
b Ft(CALL)42 b(AST_PUTTABLES\()37 b(THIS,)42 b(TABLES,)f(STATUS)g(\))0
-1626 y Fc(Argumen)m(ts:)259 1758 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 1857 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
-1986 y Fc(T)-8 b(ABLES)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
-2085 y Fj(P)n(oin)n(ter)f(to)g(a)h(KeyMap)f(holding)h(the)g(tables)g
+3252 y Fc(Argumen)m(ts:)259 3440 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 3540 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
+3698 y Fc(T)-8 b(ABLES)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
+3798 y Fj(P)n(oin)n(ter)f(to)g(a)h(KeyMap)f(holding)h(the)g(tables)g
(that)g(are)f(to)h(b)r(e)g(added)g(to)g(the)g(FitsChan.)47
-b(Eac)n(h)30 b(en)n(try)427 2185 y(should)23 b(hold)g(a)f(scalar)f(v)-5
+b(Eac)n(h)30 b(en)n(try)427 3897 y(should)23 b(hold)g(a)f(scalar)f(v)-5
b(alue)23 b(whic)n(h)g(is)g(a)f(p)r(oin)n(ter)g(to)h(a)g(FitsT)-7
b(able)23 b(to)f(b)r(e)i(added)e(to)h(the)g(FitsChan.)36
-b(An)n(y)427 2284 y(un)n(usable)28 b(en)n(tries)g(are)g(ignored.)38
+b(An)n(y)427 3997 y(un)n(usable)28 b(en)n(tries)g(are)g(ignored.)38
b(The)29 b(k)n(ey)f(asso)r(ciated)f(with)i(eac)n(h)f(en)n(try)g(should)
-g(b)r(e)h(the)g(name)g(of)f(the)427 2384 y(FITS)e(binary)f(extension)h
+g(b)r(e)h(the)g(name)g(of)f(the)427 4097 y(FITS)e(binary)f(extension)h
(from)f(whic)n(h)h(the)g(table)f(w)n(as)g(read.)35 b(If)27
b(a)e(FitsT)-7 b(able)26 b(with)g(the)g(asso)r(ciated)e(k)n(ey)427
-2484 y(already)k(exists)h(in)h(the)g(FitsChan,)g(it)g(is)g(replaced)e
+4196 y(already)k(exists)h(in)h(the)g(FitsChan,)g(it)g(is)g(replaced)e
(with)i(the)g(new)g(one.)42 b(A)30 b(deep)f(cop)n(y)g(of)g(eac)n(h)g
-(usable)427 2583 y(FitsT)-7 b(able)30 b(is)g(stored)f(in)h(the)g
+(usable)427 4296 y(FitsT)-7 b(able)30 b(is)g(stored)f(in)h(the)g
(FitsChan,)h(so)e(an)n(y)g(subsequen)n(t)h(c)n(hanges)e(made)i(to)g
-(the)g(FitsT)-7 b(ables)29 b(will)427 2683 y(ha)n(v)n(e)e(no)g
+(the)g(FitsT)-7 b(ables)29 b(will)427 4395 y(ha)n(v)n(e)e(no)g
(e\013ect)h(on)f(the)h(b)r(eha)n(viour)f(of)g(the)h(FitsChan.)259
-2811 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 2911 y Fj(The)c(global)e(status.)0 3068
-y Fc(Notes:)340 3346 y Fi(\017)45 b Fj(T)-7 b(ables)27
+4554 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 4654 y Fj(The)c(global)e(status.)0 4867
+y Fc(Notes:)340 5201 y Fi(\017)45 b Fj(T)-7 b(ables)27
b(stored)g(in)h(the)g(FitsChan)g(ma)n(y)e(b)r(e)i(retriev)n(ed)f(using)
-g(AST)p Ft(_)p Fj(GETT)-7 b(ABLES.)340 3475 y Fi(\017)45
+g(AST)p Ft(_)p Fj(GETT)-7 b(ABLES.)340 5359 y Fi(\017)45
b Fj(The)28 b(tables)f(in)h(the)g(supplied)g(KeyMap)f(are)f(added)i(to)
f(an)n(y)g(tables)g(already)f(in)i(the)g(FitsChan.)340
-3603 y Fi(\017)45 b Fj(The)g(AST)p Ft(_)p Fj(PUTT)-7
+5518 y Fi(\017)45 b Fj(The)g(AST)p Ft(_)p Fj(PUTT)-7
b(ABLE)43 b(metho)r(d)i(pro)n(vides)e(a)h(simpler)g(means)g(of)h
-(adding)f(a)g(single)f(table)i(to)f(a)427 3703 y(FitsChan.)p
-0 3893 V 0 4024 a FA(AST)p Fe(_)p FA(QUAD)l(APPR)l(O)l(X)1662
-4025 y Fd(Obtain)38 b(a)1648 4124 y(quadratic)1519 4235
-y(appro)m(ximation)1695 4348 y(to)h(a)f(2D)1664 4448
-y(Mapping)2462 4024 y FA(AST)p Fe(_)p FA(QUAD)l(APPR)l(O)l(X)0
-4628 y Fc(Description:)44 b Fj(This)27 b(function)g(returns)e(the)i
+(adding)f(a)g(single)f(table)i(to)f(a)427 5617 y(FitsChan.)p
+eop end
+%%Page: 326 336
+TeXDict begin 326 335 bop 0 52 a FG(326)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(QUAD)l(APPR)l(O)l(X)1662
+483 y Fd(Obtain)38 b(a)1648 583 y(quadratic)1519 693
+y(appro)m(ximation)1695 807 y(to)h(a)f(2D)1664 906 y(Mapping)2462
+482 y FA(AST)p Fe(_)p FA(QUAD)l(APPR)l(O)l(X)0 1091 y
+Fc(Description:)44 b Fj(This)27 b(function)g(returns)e(the)i
(co-e\016cien)n(ts)e(of)h(a)g(quadratic)f(\014t)i(to)f(the)h(supplied)g
-(Mapping)f(o)n(v)n(er)e(the)227 4728 y(input)33 b(area)c(sp)r
+(Mapping)f(o)n(v)n(er)e(the)227 1191 y(input)33 b(area)c(sp)r
(eci\014ed)j(b)n(y)f(LBND)h(and)g(UBND.)g(The)f(Mapping)g(m)n(ust)h(ha)
n(v)n(e)e(2)h(inputs,)i(but)f(ma)n(y)f(ha)n(v)n(e)f(an)n(y)227
-4827 y(n)n(um)n(b)r(er)g(of)f(outputs.)44 b(The)30 b(i'th)g(Mapping)f
+1291 y(n)n(um)n(b)r(er)g(of)f(outputs.)44 b(The)30 b(i'th)g(Mapping)f
(output)h(is)g(mo)r(delled)g(as)f(a)g(quadratic)g(function)h(of)g(the)g
-(2)f(inputs)227 4927 y(\(x,y\):)227 5049 y(output)p Ft(_)p
+(2)f(inputs)227 1390 y(\(x,y\):)227 1514 y(output)p Ft(_)p
Fj(i)f(=)f(a)p Ft(_)p Fj(i)p Ft(_)p Fj(0)f(+)h(a)p Ft(_)p
Fj(i)p Ft(_)p Fj(1)p Fi(\003)p Fj(x)f(+)h(a)p Ft(_)p
Fj(i)p Ft(_)p Fj(2)p Fi(\003)p Fj(y)e(+)i(a)p Ft(_)p
Fj(i)p Ft(_)p Fj(3)p Fi(\003)p Fj(x)p Fi(\003)p Fj(y)e(+)i(a)p
Ft(_)p Fj(i)p Ft(_)p Fj(4)p Fi(\003)p Fj(x)p Fi(\003)p
Fj(x)e(+)i(a)p Ft(_)p Fj(i)p Ft(_)p Fj(5)p Fi(\003)p
-Fj(y)p Fi(\003)p Fj(y)227 5171 y(The)h(FIT)g(arra)n(y)d(is)i(returned)h
+Fj(y)p Fi(\003)p Fj(y)227 1637 y(The)h(FIT)g(arra)n(y)d(is)i(returned)h
(holding)f(the)h(v)-5 b(alues)27 b(of)h(the)g(co-e\016cien)n(ts)e(a)p
Ft(_)p Fj(0)p Ft(_)p Fj(0,)g(a)p Ft(_)p Fj(0)p Ft(_)p
-Fj(1,)f(etc.)0 5316 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
+Fj(1,)f(etc.)0 1785 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
b(=)i(AST_QUADAPPROX\()37 b(THIS,)42 b(LBND,)f(UBND,)h(NX,)g(NY,)h
-(FIT,)f(RMS,)g(STATUS)f(\))0 5461 y Fc(Argumen)m(ts:)259
-5593 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 5693
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Mapping.)p eop end
-%%Page: 324 334
-TeXDict begin 324 333 bop 0 52 a FG(324)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(LBND\()h
-Fi(\003)g Fc(\))g(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427
-451 y Fj(An)26 b(arra)n(y)d(con)n(taining)h(the)i(lo)n(w)n(er)d(b)r
-(ounds)j(of)f(a)g(b)r(o)n(x)f(de\014ned)i(within)g(the)g(input)g(co)r
-(ordinate)e(system)h(of)427 551 y(the)j(Mapping.)36 b(The)27
-b(n)n(um)n(b)r(er)g(of)g(elemen)n(ts)g(in)g(this)g(arra)n(y)e(should)i
-(equal)f(the)i(v)-5 b(alue)27 b(of)g(the)g(Mapping's)427
-650 y(Nin)h(attribute.)37 b(This)28 b(b)r(o)n(x)f(should)h(sp)r(ecify)f
-(the)h(region)f(o)n(v)n(er)e(whic)n(h)j(the)g(\014t)g(is)g(to)f(b)r(e)h
-(p)r(erformed.)259 777 y Fc(UBND\()k Fi(\003)g Fc(\))g(=)g(DOUBLE)g
-(PRECISION)f(\(Giv)m(en\))427 877 y Fj(An)f(arra)n(y)d(con)n(taining)i
+(FIT,)f(RMS,)g(STATUS)f(\))0 1933 y Fc(Argumen)m(ts:)259
+2067 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 2167
+y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Mapping.)259 2298
+y Fc(LBND\()k Fi(\003)g Fc(\))g(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en\))
+427 2397 y Fj(An)26 b(arra)n(y)d(con)n(taining)h(the)i(lo)n(w)n(er)d(b)
+r(ounds)j(of)f(a)g(b)r(o)n(x)f(de\014ned)i(within)g(the)g(input)g(co)r
+(ordinate)e(system)h(of)427 2497 y(the)j(Mapping.)36
+b(The)27 b(n)n(um)n(b)r(er)g(of)g(elemen)n(ts)g(in)g(this)g(arra)n(y)e
+(should)i(equal)f(the)i(v)-5 b(alue)27 b(of)g(the)g(Mapping's)427
+2597 y(Nin)h(attribute.)37 b(This)28 b(b)r(o)n(x)f(should)h(sp)r(ecify)
+f(the)h(region)f(o)n(v)n(er)e(whic)n(h)j(the)g(\014t)g(is)g(to)f(b)r(e)
+h(p)r(erformed.)259 2728 y Fc(UBND\()k Fi(\003)g Fc(\))g(=)g(DOUBLE)g
+(PRECISION)f(\(Giv)m(en\))427 2827 y Fj(An)f(arra)n(y)d(con)n(taining)i
(the)h(upp)r(er)g(b)r(ounds)f(of)h(the)g(b)r(o)n(x)f(sp)r(ecifying)g
(the)h(region)f(o)n(v)n(er)e(whic)n(h)j(the)g(\014t)g(is)427
-976 y(to)e(b)r(e)g(p)r(erformed.)259 1103 y Fc(NX)k(=)g(INTEGER)f
-(\(Giv)m(en\))427 1203 y Fj(The)d(n)n(um)n(b)r(er)g(of)f(p)r(oin)n(ts)h
+2927 y(to)e(b)r(e)g(p)r(erformed.)259 3058 y Fc(NX)k(=)g(INTEGER)f
+(\(Giv)m(en\))427 3157 y Fj(The)d(n)n(um)n(b)r(er)g(of)f(p)r(oin)n(ts)h
(to)f(place)h(along)e(the)i(\014rst)g(Mapping)f(input.)38
b(The)28 b(\014rst)f(p)r(oin)n(t)h(is)g(at)g(LBND\()g(1)427
-1303 y(\))h(and)e(the)i(last)e(is)h(at)g(UBND\()h(1)e(\).)38
+3257 y(\))h(and)e(the)i(last)e(is)h(at)g(UBND\()h(1)e(\).)38
b(If)29 b(a)e(v)-5 b(alue)28 b(less)f(than)h(three)g(is)g(supplied)g(a)
-g(v)-5 b(alue)28 b(of)f(three)h(will)g(b)r(e)427 1402
-y(used.)259 1529 y Fc(NY)k(=)g(INTEGER)f(\(Giv)m(en\))427
-1629 y Fj(The)26 b(n)n(um)n(b)r(er)g(of)g(p)r(oin)n(ts)g(to)g(place)f
+g(v)-5 b(alue)28 b(of)f(three)h(will)g(b)r(e)427 3357
+y(used.)259 3488 y Fc(NY)k(=)g(INTEGER)f(\(Giv)m(en\))427
+3587 y Fj(The)26 b(n)n(um)n(b)r(er)g(of)g(p)r(oin)n(ts)g(to)g(place)f
(along)g(the)h(second)g(Mapping)f(input.)37 b(The)26
-b(\014rst)g(p)r(oin)n(t)g(is)g(at)g(LBND\()427 1728 y(2)k(\))g(and)f
+b(\014rst)g(p)r(oin)n(t)g(is)g(at)g(LBND\()427 3687 y(2)k(\))g(and)f
(the)h(last)g(is)f(at)h(UBND\()h(2)e(\).)44 b(If)30 b(a)f(v)-5
b(alue)30 b(less)f(than)h(three)g(is)f(supplied)h(a)g(v)-5
-b(alue)29 b(of)h(three)f(will)427 1828 y(b)r(e)f(used.)259
-1955 y Fc(FIT\()33 b Fi(\003)e Fc(\))h(=)g(DOUBLE)g(PRECISION)g
-(\(Returned\))427 2055 y Fj(An)d(arra)n(y)c(in)k(whic)n(h)f(to)g
+b(alue)29 b(of)h(three)f(will)427 3786 y(b)r(e)f(used.)259
+3917 y Fc(FIT\()33 b Fi(\003)e Fc(\))h(=)g(DOUBLE)g(PRECISION)g
+(\(Returned\))427 4017 y Fj(An)d(arra)n(y)c(in)k(whic)n(h)f(to)g
(return)f(the)i(co-e\016cien)n(ts)e(of)h(the)g(quadratic)f(appro)n
-(ximation)f(to)i(the)g(sp)r(eci\014ed)427 2154 y(transformation.)33
+(ximation)f(to)i(the)g(sp)r(eci\014ed)427 4117 y(transformation.)33
b(This)20 b(arra)n(y)e(should)i(ha)n(v)n(e)f(at)h(least)f
Ft(")p Fj(6)p Fi(\003)p Fj(Nout)p Ft(")p Fj(,)i(elemen)n(ts.)34
-b(The)20 b(\014rst)g(6)g(elemen)n(ts)g(hold)427 2254
+b(The)20 b(\014rst)g(6)g(elemen)n(ts)g(hold)427 4216
y(the)28 b(\014t)h(to)e(the)h(\014rst)g(Mapping)f(output.)38
b(The)28 b(next)f(6)h(elemen)n(ts)f(hold)h(the)g(\014t)g(to)g(the)g
-(second)f(Mapping)427 2354 y(output,)33 b(etc.)47 b(So)31
+(second)f(Mapping)427 4316 y(output,)33 b(etc.)47 b(So)31
b(if)g(the)h(Mapping)f(has)f(2)h(inputs)g(and)g(2)g(outputs)g(the)h
-(quadratic)e(appro)n(ximation)f(to)427 2453 y(the)f(forw)n(ard)e
-(transformation)g(is:)427 2566 y(X)p Ft(_)p Fj(out)18
+(quadratic)e(appro)n(ximation)f(to)427 4416 y(the)f(forw)n(ard)e
+(transformation)g(is:)427 4531 y(X)p Ft(_)p Fj(out)18
b(=)h(\014t\(1\))f(+)g(\014t\(2\))p Fi(\003)p Fj(X)p
Ft(_)p Fj(in)h(+)f(\014t\(3\))p Fi(\003)p Fj(Y)p Ft(_)p
Fj(in)g(+)h(\014t\(4\))p Fi(\003)p Fj(X)p Ft(_)p Fj(in)p
Fi(\003)p Fj(Y)p Ft(_)p Fj(in)f(+)g(\014t\(5\))p Fi(\003)p
Fj(X)p Ft(_)p Fj(in)p Fi(\003)p Fj(X)p Ft(_)p Fj(in)g(+)g(\014t\(6\))p
Fi(\003)p Fj(Y)p Ft(_)p Fj(in)p Fi(\003)p Fj(Y)p Ft(_)p
-Fj(in)427 2666 y(Y)p Ft(_)p Fj(out)40 b(=)f(\014t\(7\))h(+)f
+Fj(in)427 4631 y(Y)p Ft(_)p Fj(out)40 b(=)f(\014t\(7\))h(+)f
(\014t\(8\))p Fi(\003)p Fj(X)p Ft(_)p Fj(in)g(+)g(\014t\(9\))p
Fi(\003)p Fj(Y)p Ft(_)p Fj(in)h(+)f(\014t\(10\))p Fi(\003)p
Fj(X)p Ft(_)p Fj(in)p Fi(\003)p Fj(Y)p Ft(_)p Fj(in)f(+)h(\014t\(11\))p
Fi(\003)p Fj(X)p Ft(_)p Fj(in)p Fi(\003)p Fj(X)p Ft(_)p
-Fj(in)g(+)427 2766 y(\014t\(12\))p Fi(\003)p Fj(Y)p Ft(_)p
-Fj(in)p Fi(\003)p Fj(Y)p Ft(_)p Fj(in)259 2893 y Fc(RMS)31
-b(=)h(DOUBLE)h(PRECISION)e(\(Returned\))427 2992 y Fj(The)d(RMS)g
+Fj(in)g(+)427 4730 y(\014t\(12\))p Fi(\003)p Fj(Y)p Ft(_)p
+Fj(in)p Fi(\003)p Fj(Y)p Ft(_)p Fj(in)259 4861 y Fc(RMS)31
+b(=)h(DOUBLE)h(PRECISION)e(\(Returned\))427 4961 y Fj(The)d(RMS)g
(residual)f(b)r(et)n(w)n(een)g(the)h(\014t)g(and)g(the)g(Mapping,)f
-(summed)h(o)n(v)n(er)e(all)h(Mapping)g(outputs.)259 3119
+(summed)h(o)n(v)n(er)e(all)h(Mapping)g(outputs.)259 5092
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 3219 y Fj(The)c(global)e(status.)0 3375 y Fc(Returned)32
-b(V)-8 b(alue:)259 3506 y(AST)p Ft(_)p Fc(QUAD)m(APPR)m(O)m(X)34
-b(=)e(LOGICAL)427 3605 y Fj(If)23 b(a)f(quadratic)f(appro)n(ximation)f
+427 5191 y Fj(The)c(global)e(status.)0 5351 y Fc(Returned)32
+b(V)-8 b(alue:)259 5486 y(AST)p Ft(_)p Fc(QUAD)m(APPR)m(O)m(X)34
+b(=)e(LOGICAL)427 5585 y Fj(If)23 b(a)f(quadratic)f(appro)n(ximation)f
(w)n(as)h(created,)h(.TR)n(UE)g(is)g(returned.)35 b(Otherwise)21
-b(.F)-9 b(ALSE.)22 b(is)g(returned)427 3705 y(and)28
+b(.F)-9 b(ALSE.)22 b(is)g(returned)427 5685 y(and)28
b(the)g(\014t)g(co-e\016cien)n(ts)e(are)h(set)h(to)f(AST)p
-Ft(__)p Fj(BAD.)0 3861 y Fc(Notes:)340 4137 y Fi(\017)45
-b Fj(This)31 b(function)g(\014ts)g(the)g(Mapping's)g(forw)n(ard)e
-(transformation.)44 b(T)-7 b(o)31 b(\014t)g(the)g(in)n(v)n(erse)e
-(transformation,)427 4237 y(the)f(Mapping)f(should)h(b)r(e)g(in)n(v)n
-(erted)f(using)g(AST)p Ft(_)p Fj(INVER)-7 b(T)28 b(b)r(efore)f(in)n(v)n
-(oking)f(this)i(function.)340 4364 y Fi(\017)45 b Fj(A)32
-b(v)-5 b(alue)32 b(of)f(.F)-9 b(ALSE.)32 b(will)g(b)r(e)g(returned)f
-(if)h(this)g(function)g(is)g(in)n(v)n(ok)n(ed)e(with)i(the)g(global)e
-(error)g(status)427 4464 y(set,)e(or)f(if)h(it)g(should)f(fail)h(for)f
-(an)n(y)g(reason.)p 0 4651 3780 12 v 0 4782 a FA(AST)p
-Fe(_)p FA(RA)-11 b(TE)1052 4783 y Fd(Calculate)37 b(the)h(rate)g(of)g
-(c)m(hange)g(of)h(a)1472 4896 y(Mapping)f(output)3076
-4782 y FA(AST)p Fe(_)p FA(RA)-11 b(TE)0 5073 y Fc(Description:)44
-b Fj(This)32 b(routine)f(ev)-5 b(aluates)31 b(the)g(rate)g(of)h(c)n
-(hange)e(of)h(a)g(sp)r(eci\014ed)h(output)g(of)f(the)h(supplied)g
-(Mapping)227 5173 y(with)c(resp)r(ect)g(to)f(a)g(sp)r(eci\014ed)h
-(input,)h(at)e(a)g(sp)r(eci\014ed)h(input)h(p)r(osition.)227
-5295 y(The)d(result)f(is)g(estimated)g(b)n(y)g(in)n(terp)r(olating)g
-(the)g(function)h(using)f(a)g(fourth)g(order)f(p)r(olynomial)h(in)g
-(the)h(neigh-)227 5394 y(b)r(ourho)r(o)r(d)i(of)h(the)g(sp)r(eci\014ed)
-f(p)r(osition.)40 b(The)28 b(size)h(of)f(the)h(neigh)n(b)r(ourho)r(o)r
-(d)e(used)i(is)f(c)n(hosen)g(to)g(minimise)h(the)227
-5494 y(RMS)38 b(residual)f(p)r(er)g(unit)h(length)g(b)r(et)n(w)n(een)f
+Ft(__)p Fj(BAD.)p eop end
+%%Page: 327 337
+TeXDict begin 327 336 bop 3643 52 a FG(327)0 351 y Fc(Notes:)340
+678 y Fi(\017)45 b Fj(This)31 b(function)g(\014ts)g(the)g(Mapping's)g
+(forw)n(ard)e(transformation.)44 b(T)-7 b(o)31 b(\014t)g(the)g(in)n(v)n
+(erse)e(transformation,)427 778 y(the)f(Mapping)f(should)h(b)r(e)g(in)n
+(v)n(erted)f(using)g(AST)p Ft(_)p Fj(INVER)-7 b(T)28
+b(b)r(efore)f(in)n(v)n(oking)f(this)i(function.)340 933
+y Fi(\017)45 b Fj(A)32 b(v)-5 b(alue)32 b(of)f(.F)-9
+b(ALSE.)32 b(will)g(b)r(e)g(returned)f(if)h(this)g(function)g(is)g(in)n
+(v)n(ok)n(ed)e(with)i(the)g(global)e(error)g(status)427
+1033 y(set,)e(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
+0 1276 3780 12 v 0 1407 a FA(AST)p Fe(_)p FA(RA)-11 b(TE)1052
+1408 y Fd(Calculate)37 b(the)h(rate)g(of)g(c)m(hange)g(of)h(a)1472
+1521 y(Mapping)f(output)3076 1407 y FA(AST)p Fe(_)p FA(RA)-11
+b(TE)0 1754 y Fc(Description:)44 b Fj(This)32 b(routine)f(ev)-5
+b(aluates)31 b(the)g(rate)g(of)h(c)n(hange)e(of)h(a)g(sp)r(eci\014ed)h
+(output)g(of)f(the)h(supplied)g(Mapping)227 1854 y(with)c(resp)r(ect)g
+(to)f(a)g(sp)r(eci\014ed)h(input,)h(at)e(a)g(sp)r(eci\014ed)h(input)h
+(p)r(osition.)227 2001 y(The)d(result)f(is)g(estimated)g(b)n(y)g(in)n
+(terp)r(olating)g(the)g(function)h(using)f(a)g(fourth)g(order)f(p)r
+(olynomial)h(in)g(the)h(neigh-)227 2101 y(b)r(ourho)r(o)r(d)i(of)h(the)
+g(sp)r(eci\014ed)f(p)r(osition.)40 b(The)28 b(size)h(of)f(the)h(neigh)n
+(b)r(ourho)r(o)r(d)e(used)i(is)f(c)n(hosen)g(to)g(minimise)h(the)227
+2200 y(RMS)38 b(residual)f(p)r(er)g(unit)h(length)g(b)r(et)n(w)n(een)f
(the)h(in)n(terp)r(olating)e(p)r(olynomial)h(and)g(the)h(supplied)g
-(Mapping)227 5593 y(function.)59 b(This)35 b(metho)r(d)g(pro)r(duces)f
+(Mapping)227 2300 y(function.)59 b(This)35 b(metho)r(d)g(pro)r(duces)f
(go)r(o)r(d)g(accuracy)f(but)j(can)e(in)n(v)n(olv)n(e)f(ev)-5
-b(aluating)35 b(the)g(Mapping)f(100)f(or)227 5693 y(more)27
-b(times.)p eop end
-%%Page: 325 335
-TeXDict begin 325 334 bop 3643 52 a FG(325)0 351 y Fc(In)m(v)m(o)s
-(cation:)123 b Ft(RESULT)41 b(=)i(AST_RATE\()d(THIS,)h(AT,)i(AX1,)f
-(AX2,)g(STATUS)f(\))0 516 y Fc(Argumen)m(ts:)259 668
-y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 767 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(Mapping)f(to)g(b)r(e)h(applied.)259 908
-y Fc(A)-8 b(T\()33 b Fi(\003)e Fc(\))h(=)g(DOUBLE)g(PRECISION)g(\(Giv)m
-(en\))427 1007 y Fj(An)23 b(arra)n(y)c(holding)j(the)g(axis)f(v)-5
-b(alues)22 b(at)f(the)i(p)r(osition)e(at)h(whic)n(h)g(the)g(rate)f(of)h
-(c)n(hange)f(is)h(to)g(b)r(e)g(ev)-5 b(aluated.)427 1107
-y(The)28 b(n)n(um)n(b)r(er)f(of)h(elemen)n(ts)f(in)h(this)g(arra)n(y)d
-(should)j(equal)f(the)h(n)n(um)n(b)r(er)f(of)h(inputs)g(to)f(the)h
-(Mapping.)259 1248 y Fc(AX1)k(=)g(INTEGER)f(\(Giv)m(en\))427
-1347 y Fj(The)f(index)f(of)h(the)f(Mapping)g(output)h(for)f(whic)n(h)g
-(the)h(rate)f(of)g(c)n(hange)f(is)i(to)f(b)r(e)h(found)g(\(output)g(n)n
-(um-)427 1447 y(b)r(ering)d(starts)g(at)h(1)f(for)g(the)h(\014rst)f
-(output\).)259 1587 y Fc(AX2)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
-1687 y Fj(The)k(index)g(of)g(the)g(Mapping)g(input)h(whic)n(h)e(is)h
-(to)g(b)r(e)g(v)-5 b(aried)35 b(in)g(order)e(to)i(\014nd)g(the)h(rate)e
-(of)h(c)n(hange)427 1787 y(\(input)29 b(n)n(um)n(b)r(ering)e(starts)g
-(at)g(1)g(for)g(the)h(\014rst)g(input\).)259 1927 y Fc(ST)-8
-b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-2027 y Fj(The)c(global)e(status.)0 2204 y Fc(Returned)32
-b(V)-8 b(alue:)259 2356 y(AST)p Ft(_)p Fc(RA)g(TE)32
-b(=)g(DOUBLE)g(PRECISION)427 2455 y Fj(The)c(rate)g(of)g(c)n(hange)f
-(of)h(Mapping)f(output)i(AX1)f(with)h(resp)r(ect)e(to)h(input)h(AX2,)f
-(ev)-5 b(aluated)28 b(at)g(A)-7 b(T,)28 b(or)427 2555
-y(AST)p Ft(__)p Fj(BAD)g(if)g(the)g(v)-5 b(alue)28 b(cannot)f(b)r(e)h
-(calculated.)0 2732 y Fc(Notes:)340 3030 y Fi(\017)45
-b Fj(A)24 b(v)-5 b(alue)23 b(of)g(AST)p Ft(__)p Fj(BAD)h(will)f(b)r(e)h
-(returned)f(if)h(this)g(function)g(is)f(in)n(v)n(ok)n(ed)f(with)i(the)f
-(global)f(error)g(status)427 3129 y(set,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 3344 3780 12 v 0 3475
-a FA(AST)p Fe(_)p FA(RA)-11 b(TEMAP)1416 3474 y Fd(Create)37
-b(a)i(RateMap)2755 3475 y FA(AST)p Fe(_)p FA(RA)-11 b(TEMAP)0
-3679 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+b(aluating)35 b(the)g(Mapping)f(100)f(or)227 2399 y(more)27
+b(times.)0 2593 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
+b(=)i(AST_RATE\()d(THIS,)h(AT,)i(AX1,)f(AX2,)g(STATUS)f(\))0
+2787 y Fc(Argumen)m(ts:)259 2968 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 3068 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Mapping)f(to)g(b)r(e)
+h(applied.)259 3223 y Fc(A)-8 b(T\()33 b Fi(\003)e Fc(\))h(=)g(DOUBLE)g
+(PRECISION)g(\(Giv)m(en\))427 3322 y Fj(An)23 b(arra)n(y)c(holding)j
+(the)g(axis)f(v)-5 b(alues)22 b(at)f(the)i(p)r(osition)e(at)h(whic)n(h)
+g(the)g(rate)f(of)h(c)n(hange)f(is)h(to)g(b)r(e)g(ev)-5
+b(aluated.)427 3422 y(The)28 b(n)n(um)n(b)r(er)f(of)h(elemen)n(ts)f(in)
+h(this)g(arra)n(y)d(should)j(equal)f(the)h(n)n(um)n(b)r(er)f(of)h
+(inputs)g(to)f(the)h(Mapping.)259 3577 y Fc(AX1)k(=)g(INTEGER)f(\(Giv)m
+(en\))427 3677 y Fj(The)f(index)f(of)h(the)f(Mapping)g(output)h(for)f
+(whic)n(h)g(the)h(rate)f(of)g(c)n(hange)f(is)i(to)f(b)r(e)h(found)g
+(\(output)g(n)n(um-)427 3776 y(b)r(ering)d(starts)g(at)h(1)f(for)g(the)
+h(\014rst)f(output\).)259 3931 y Fc(AX2)32 b(=)g(INTEGER)f(\(Giv)m
+(en\))427 4031 y Fj(The)k(index)g(of)g(the)g(Mapping)g(input)h(whic)n
+(h)e(is)h(to)g(b)r(e)g(v)-5 b(aried)35 b(in)g(order)e(to)i(\014nd)g
+(the)h(rate)e(of)h(c)n(hange)427 4131 y(\(input)29 b(n)n(um)n(b)r
+(ering)e(starts)g(at)g(1)g(for)g(the)h(\014rst)g(input\).)259
+4286 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 4385 y Fj(The)c(global)e(status.)0 4592
+y Fc(Returned)32 b(V)-8 b(alue:)259 4773 y(AST)p Ft(_)p
+Fc(RA)g(TE)32 b(=)g(DOUBLE)g(PRECISION)427 4872 y Fj(The)c(rate)g(of)g
+(c)n(hange)f(of)h(Mapping)f(output)i(AX1)f(with)h(resp)r(ect)e(to)h
+(input)h(AX2,)f(ev)-5 b(aluated)28 b(at)g(A)-7 b(T,)28
+b(or)427 4972 y(AST)p Ft(__)p Fj(BAD)g(if)g(the)g(v)-5
+b(alue)28 b(cannot)f(b)r(e)h(calculated.)0 5178 y Fc(Notes:)340
+5505 y Fi(\017)45 b Fj(A)24 b(v)-5 b(alue)23 b(of)g(AST)p
+Ft(__)p Fj(BAD)h(will)f(b)r(e)h(returned)f(if)h(this)g(function)g(is)f
+(in)n(v)n(ok)n(ed)f(with)i(the)f(global)f(error)g(status)427
+5605 y(set,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)
+p eop end
+%%Page: 328 338
+TeXDict begin 328 337 bop 0 52 a FG(328)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(RA)-11 b(TEMAP)388 b Fd(Create)37
+b(a)i(RateMap)390 b FA(AST)p Fe(_)p FA(RA)-11 b(TEMAP)0
+702 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
(RateMap)h(and)f(optionally)g(initialises)g(its)h(attributes.)227
-3811 y(A)37 b(RateMap)g(is)f(a)g(Mapping)h(whic)n(h)f(represen)n(ts)g
-(a)g(single)g(elemen)n(t)h(of)g(the)g(Jacobian)e(matrix)h(of)h(another)
-227 3910 y(Mapping.)k(The)28 b(Mapping)h(for)f(whic)n(h)h(the)g
-(Jacobian)f(is)g(required)g(is)h(sp)r(eci\014ed)g(when)g(the)g(new)g
-(RateMap)g(is)227 4010 y(created,)e(and)h(is)f(referred)f(to)i(as)f
-(the)h Ft(")p Fj(encapsulated)e(Mapping)p Ft(")h Fj(b)r(elo)n(w.)227
-4142 y(The)39 b(n)n(um)n(b)r(er)f(of)g(inputs)h(to)f(a)g(RateMap)g(is)g
+843 y(A)37 b(RateMap)g(is)f(a)g(Mapping)h(whic)n(h)f(represen)n(ts)g(a)
+g(single)g(elemen)n(t)h(of)g(the)g(Jacobian)e(matrix)h(of)h(another)227
+943 y(Mapping.)k(The)28 b(Mapping)h(for)f(whic)n(h)h(the)g(Jacobian)f
+(is)g(required)g(is)h(sp)r(eci\014ed)g(when)g(the)g(new)g(RateMap)g(is)
+227 1042 y(created,)e(and)h(is)f(referred)f(to)i(as)f(the)h
+Ft(")p Fj(encapsulated)e(Mapping)p Ft(")h Fj(b)r(elo)n(w.)227
+1183 y(The)39 b(n)n(um)n(b)r(er)f(of)g(inputs)h(to)f(a)g(RateMap)g(is)g
(the)h(same)f(as)f(the)i(n)n(um)n(b)r(er)f(of)h(inputs)f(to)h(its)f
-(encapsulated)227 4242 y(Mapping.)e(The)27 b(n)n(um)n(b)r(er)f(of)h
+(encapsulated)227 1282 y(Mapping.)e(The)27 b(n)n(um)n(b)r(er)f(of)h
(outputs)g(from)f(a)g(RateMap)g(is)h(alw)n(a)n(ys)e(one.)36
-b(This)26 b(one)g(output)i(equals)d(the)i(rate)227 4341
+b(This)26 b(one)g(output)i(equals)d(the)i(rate)227 1382
y(of)c(c)n(hange)f(of)h(a)g(sp)r(eci\014ed)g(output)h(of)f(the)g
(encapsulated)g(Mapping)f(with)i(resp)r(ect)f(to)f(a)h(sp)r(eci\014ed)g
-(input)h(of)f(the)227 4441 y(encapsulated)k(Mapping)g(\(the)i(input)f
+(input)h(of)f(the)227 1482 y(encapsulated)k(Mapping)g(\(the)i(input)f
(and)g(output)g(to)f(use)h(are)e(sp)r(eci\014ed)i(when)g(the)g(RateMap)
-f(is)h(created\).)227 4573 y(A)g(RateMap)f(whic)n(h)h(has)e(not)i(b)r
+f(is)h(created\).)227 1622 y(A)g(RateMap)f(whic)n(h)h(has)e(not)i(b)r
(een)g(in)n(v)n(erted)e(do)r(es)i(not)f(de\014ne)h(an)f(in)n(v)n(erse)f
-(transformation.)35 b(If)28 b(a)f(RateMap)227 4673 y(has)g(b)r(een)h
+(transformation.)35 b(If)28 b(a)f(RateMap)227 1722 y(has)g(b)r(een)h
(in)n(v)n(erted)f(then)h(it)g(will)g(de\014ne)g(an)f(in)n(v)n(erse)f
(transformation)g(but)j(not)e(a)g(forw)n(ard)f(transformation.)0
-4838 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_RATEMAP\()c
-(MAP,)j(AX1,)g(AX2,)f(OPTIONS,)g(STATUS)g(\))0 5002 y
-Fc(Argumen)m(ts:)259 5154 y(MAP)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
-5254 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(encapsulated)f(Mapping.)259
-5394 y Fc(AX1)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 5494
+1903 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_RATEMAP\()c
+(MAP,)j(AX1,)g(AX2,)f(OPTIONS,)g(STATUS)g(\))0 2085 y
+Fc(Argumen)m(ts:)259 2253 y(MAP)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
+2353 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(encapsulated)f(Mapping.)259
+2502 y Fc(AX1)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 2601
y Fj(Index)26 b(of)h(the)f(output)h(from)f(the)g(encapsulated)g
(Mapping)g(for)f(whic)n(h)h(the)h(rate)e(of)h(c)n(hange)f(is)i
-(required.)427 5593 y(This)g(corresp)r(onds)e(to)i(the)g(delta)g(quan)n
+(required.)427 2701 y(This)g(corresp)r(onds)e(to)i(the)g(delta)g(quan)n
(tit)n(y)f(forming)g(the)h(n)n(umerator)f(of)g(the)i(required)d(elemen)
-n(t)i(of)g(the)427 5693 y(Jacobian)f(matrix.)37 b(The)27
-b(\014rst)h(axis)f(has)g(index)g(1.)p eop end
-%%Page: 326 336
-TeXDict begin 326 335 bop 0 52 a FG(326)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(AX2)h(=)g(INTEGER)f
-(\(Giv)m(en\))427 451 y Fj(Index)f(of)g(the)h(input)g(to)f(the)g
-(encapsulated)g(Mapping)f(whic)n(h)h(is)g(to)g(b)r(e)h(v)-5
-b(aried.)43 b(This)31 b(corresp)r(onds)d(to)427 551 y(the)h(delta)g
-(quan)n(tit)n(y)f(forming)h(the)g(denominator)e(of)i(the)g(required)f
-(elemen)n(t)h(of)g(the)g(Jacobian)e(matrix.)427 650 y(The)h(\014rst)f
-(axis)g(has)g(index)h(1.)259 784 y Fc(OPTIONS)k(=)g(CHARA)m(CTER)g
-Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-883 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)f
-(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r(e)
-427 983 y(used)j(for)g(initialising)g(the)g(new)h(RateMap.)35
-b(The)24 b(syn)n(tax)f(used)h(is)h(iden)n(tical)e(to)h(that)h(for)e
-(the)i(AST)p Ft(_)p Fj(SET)427 1083 y(routine.)259 1216
-y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 1316 y Fj(The)c(global)e(status.)0 1479 y Fc(Returned)32
-b(V)-8 b(alue:)259 1617 y(AST)p Ft(_)p Fc(RA)g(TEMAP)32
-b(=)g(INTEGER)427 1716 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
-(RateMap.)0 1880 y Fc(Notes:)340 2164 y Fi(\017)45 b
-Fj(The)28 b(forw)n(ard)e(transformation)g(of)h(the)h(encapsulated)f
-(Mapping)g(m)n(ust)h(b)r(e)g(de\014ned.)340 2297 y Fi(\017)45
-b Fj(Note)32 b(that)g(the)g(comp)r(onen)n(t)g(Mappings)f(supplied)h
-(are)f(not)h(copied)f(b)n(y)h(AST)p Ft(_)p Fj(RA)-7 b(TEMAP)31
-b(\(the)i(new)427 2397 y(RateMap)40 b(simply)h(retains)f(a)g(reference)
-g(to)g(them\).)77 b(They)40 b(ma)n(y)g(con)n(tin)n(ue)g(to)h(b)r(e)g
-(used)f(for)g(other)427 2497 y(purp)r(oses,)j(but)d(should)g(not)g(b)r
-(e)g(deleted.)75 b(If)40 b(a)g(RateMap)f(con)n(taining)g(a)h(cop)n(y)f
-(of)h(its)g(comp)r(onen)n(t)427 2596 y(Mappings)27 b(is)h(required,)e
-(then)j(a)e(cop)n(y)f(of)i(the)g(RateMap)f(should)h(b)r(e)g(made)f
-(using)g(AST)p Ft(_)p Fj(COPY.)340 2730 y Fi(\017)45
-b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
-Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 2829
-y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 3030 3780 12 v 0 3161
-a FA(AST)p Fe(_)p FA(READ)1066 3162 y Fd(Read)39 b(an)g(Ob)7
-b(ject)38 b(from)f(a)i(Channel)3055 3161 y FA(AST)p Fe(_)p
-FA(READ)0 3352 y Fc(Description:)44 b Fj(This)35 b(function)g(reads)f
-(the)h(next)g(Ob)5 b(ject)34 b(from)h(a)f(Channel)h(and)f(returns)g(a)h
-(p)r(oin)n(ter)f(to)g(the)i(new)227 3452 y(Ob)5 b(ject.)0
-3602 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_READ\()d
-(THIS,)h(STATUS)h(\))0 3753 y Fc(Argumen)m(ts:)259 3891
-y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 3991 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(Channel.)259 4124 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 4224
-y Fj(The)c(global)e(status.)0 4387 y Fc(Class)31 b(Applicabilit)m(y:)
-259 4525 y(FitsChan)427 4625 y Fj(All)24 b(successful)g(use)f(of)h(AST)
-p Ft(_)p Fj(READ)g(on)f(a)h(FitsChan)g(is)f(destructiv)n(e,)h(so)f
-(that)h(FITS)g(header)f(cards)g(are)427 4724 y(consumed)g(in)h(the)g
-(pro)r(cess)e(of)i(reading)e(an)h(Ob)5 b(ject,)25 b(and)e(are)f(remo)n
-(v)n(ed)g(from)h(the)h(FitsChan)g(\(this)g(dele-)427
-4824 y(tion)g(can)f(b)r(e)g(prev)n(en)n(ted)g(for)g(sp)r(eci\014c)g
-(cards)f(b)n(y)h(calling)g(the)h(FitsChan)f(AST)p Ft(_)p
-Fj(RET)-7 b(AINFITS)24 b(routine\).)427 4924 y(An)36
-b(unsuccessful)g(call)f(of)h(AST)p Ft(_)p Fj(READ)f(\(for)h(instance,)h
-(caused)e(b)n(y)g(the)h(FitsChan)g(not)g(con)n(taining)427
-5023 y(the)30 b(necessary)d(FITS)i(headers)f(cards)f(needed)i(to)g
-(create)f(an)h(Ob)5 b(ject\))29 b(results)f(in)h(the)g(con)n(ten)n(ts)f
-(of)h(the)427 5123 y(FitsChan)f(b)r(eing)g(left)g(unc)n(hanged.)259
-5256 y Fc(StcsChan)427 5356 y Fj(The)f(AST)h(Ob)5 b(ject)26
-b(returned)h(b)n(y)g(a)f(successful)h(use)g(of)g(AST)p
+n(t)i(of)g(the)427 2801 y(Jacobian)f(matrix.)37 b(The)27
+b(\014rst)h(axis)f(has)g(index)g(1.)259 2949 y Fc(AX2)32
+b(=)g(INTEGER)f(\(Giv)m(en\))427 3049 y Fj(Index)f(of)g(the)h(input)g
+(to)f(the)g(encapsulated)g(Mapping)f(whic)n(h)h(is)g(to)g(b)r(e)h(v)-5
+b(aried.)43 b(This)31 b(corresp)r(onds)d(to)427 3149
+y(the)h(delta)g(quan)n(tit)n(y)f(forming)h(the)g(denominator)e(of)i
+(the)g(required)f(elemen)n(t)h(of)g(the)g(Jacobian)e(matrix.)427
+3248 y(The)h(\014rst)f(axis)g(has)g(index)h(1.)259 3397
+y Fc(OPTIONS)k(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h Fi(\003)f
+Fc(\))h(\(Giv)m(en\))427 3497 y Fj(A)22 b(c)n(haracter)e(string)h(con)n
+(taining)g(an)h(optional)f(comma-separated)e(list)j(of)g(attribute)g
+(assignmen)n(ts)f(to)g(b)r(e)427 3596 y(used)j(for)g(initialising)g
+(the)g(new)h(RateMap.)35 b(The)24 b(syn)n(tax)f(used)h(is)h(iden)n
+(tical)e(to)h(that)h(for)e(the)i(AST)p Ft(_)p Fj(SET)427
+3696 y(routine.)259 3845 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)
+m(en)h(and)g(Returned\))427 3944 y Fj(The)c(global)e(status.)0
+4138 y Fc(Returned)32 b(V)-8 b(alue:)259 4307 y(AST)p
+Ft(_)p Fc(RA)g(TEMAP)32 b(=)g(INTEGER)427 4406 y Fj(A)c(p)r(oin)n(ter)f
+(to)h(the)g(new)g(RateMap.)0 4600 y Fc(Notes:)340 4915
+y Fi(\017)45 b Fj(The)28 b(forw)n(ard)e(transformation)g(of)h(the)h
+(encapsulated)f(Mapping)g(m)n(ust)h(b)r(e)g(de\014ned.)340
+5064 y Fi(\017)45 b Fj(Note)32 b(that)g(the)g(comp)r(onen)n(t)g
+(Mappings)f(supplied)h(are)f(not)h(copied)f(b)n(y)h(AST)p
+Ft(_)p Fj(RA)-7 b(TEMAP)31 b(\(the)i(new)427 5163 y(RateMap)40
+b(simply)h(retains)f(a)g(reference)g(to)g(them\).)77
+b(They)40 b(ma)n(y)g(con)n(tin)n(ue)g(to)h(b)r(e)g(used)f(for)g(other)
+427 5263 y(purp)r(oses,)j(but)d(should)g(not)g(b)r(e)g(deleted.)75
+b(If)40 b(a)g(RateMap)f(con)n(taining)g(a)h(cop)n(y)f(of)h(its)g(comp)r
+(onen)n(t)427 5363 y(Mappings)27 b(is)h(required,)e(then)j(a)e(cop)n(y)
+f(of)i(the)g(RateMap)f(should)h(b)r(e)g(made)f(using)g(AST)p
+Ft(_)p Fj(COPY.)340 5511 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
+(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
+b(A)g(TUS)427 5611 y(set)28 b(to)f(an)h(error)d(v)-5
+b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
+eop end
+%%Page: 329 339
+TeXDict begin 329 338 bop 3643 52 a FG(329)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(READ)1066 483 y Fd(Read)39
+b(an)g(Ob)7 b(ject)38 b(from)f(a)i(Channel)3055 482 y
+FA(AST)p Fe(_)p FA(READ)0 673 y Fc(Description:)44 b
+Fj(This)35 b(function)g(reads)f(the)h(next)g(Ob)5 b(ject)34
+b(from)h(a)f(Channel)h(and)f(returns)g(a)h(p)r(oin)n(ter)f(to)g(the)i
+(new)227 773 y(Ob)5 b(ject.)0 924 y Fc(In)m(v)m(o)s(cation:)123
+b Ft(RESULT)41 b(=)i(AST_READ\()d(THIS,)h(STATUS)h(\))0
+1074 y Fc(Argumen)m(ts:)259 1212 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 1312 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Channel.)259
+1445 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 1545 y Fj(The)c(global)e(status.)0 1708
+y Fc(Class)31 b(Applicabilit)m(y:)259 1846 y(FitsChan)427
+1946 y Fj(All)24 b(successful)g(use)f(of)h(AST)p Ft(_)p
+Fj(READ)g(on)f(a)h(FitsChan)g(is)f(destructiv)n(e,)h(so)f(that)h(FITS)g
+(header)f(cards)g(are)427 2045 y(consumed)g(in)h(the)g(pro)r(cess)e(of)
+i(reading)e(an)h(Ob)5 b(ject,)25 b(and)e(are)f(remo)n(v)n(ed)g(from)h
+(the)h(FitsChan)g(\(this)g(dele-)427 2145 y(tion)g(can)f(b)r(e)g(prev)n
+(en)n(ted)g(for)g(sp)r(eci\014c)g(cards)f(b)n(y)h(calling)g(the)h
+(FitsChan)f(AST)p Ft(_)p Fj(RET)-7 b(AINFITS)24 b(routine\).)427
+2245 y(An)36 b(unsuccessful)g(call)f(of)h(AST)p Ft(_)p
+Fj(READ)f(\(for)h(instance,)h(caused)e(b)n(y)g(the)h(FitsChan)g(not)g
+(con)n(taining)427 2344 y(the)30 b(necessary)d(FITS)i(headers)f(cards)f
+(needed)i(to)g(create)f(an)h(Ob)5 b(ject\))29 b(results)f(in)h(the)g
+(con)n(ten)n(ts)f(of)h(the)427 2444 y(FitsChan)f(b)r(eing)g(left)g(unc)
+n(hanged.)259 2577 y Fc(StcsChan)427 2677 y Fj(The)f(AST)h(Ob)5
+b(ject)26 b(returned)h(b)n(y)g(a)f(successful)h(use)g(of)g(AST)p
Ft(_)p Fj(READ)g(on)g(an)f(StcsChan,)h(will)g(b)r(e)h(either)427
-5456 y(a)g(Region)g(or)f(a)h(KeyMap,)f(dep)r(ending)i(on)f(the)h(v)-5
+2777 y(a)g(Region)g(or)f(a)h(KeyMap,)f(dep)r(ending)i(on)f(the)h(v)-5
b(alues)27 b(of)i(the)f(StcsArea,)g(StcsCo)r(ords)f(and)h(StcsProps)427
-5555 y(attributes.)37 b(See)28 b(the)g(do)r(cumen)n(tation)f(for)g
+2876 y(attributes.)37 b(See)28 b(the)g(do)r(cumen)n(tation)f(for)g
(these)h(attributes)f(for)g(further)h(information.)0
-5718 y Fc(Returned)k(V)-8 b(alue:)p eop end
-%%Page: 327 337
-TeXDict begin 327 336 bop 3643 52 a FG(327)259 351 y
-Fc(AST)p Ft(_)p Fc(READ)32 b(=)g(INTEGER)427 451 y Fj(A)c(p)r(oin)n
-(ter)f(to)g(the)h(new)g(Ob)5 b(ject.)36 b(The)28 b(class)e(to)h(whic)n
-(h)h(this)f(will)h(b)r(elong)f(is)g(determined)h(b)n(y)f(the)h(input)
-427 551 y(data,)f(so)g(is)h(not)f(kno)n(wn)g(in)h(adv)-5
-b(ance.)0 709 y Fc(Notes:)340 989 y Fi(\017)45 b Fj(A)24
+3040 y Fc(Returned)k(V)-8 b(alue:)259 3177 y(AST)p Ft(_)p
+Fc(READ)32 b(=)g(INTEGER)427 3277 y Fj(A)c(p)r(oin)n(ter)f(to)g(the)h
+(new)g(Ob)5 b(ject.)36 b(The)28 b(class)e(to)h(whic)n(h)h(this)f(will)h
+(b)r(elong)f(is)g(determined)h(b)n(y)f(the)h(input)427
+3377 y(data,)f(so)g(is)h(not)f(kno)n(wn)g(in)h(adv)-5
+b(ance.)0 3540 y Fc(Notes:)340 3824 y Fi(\017)45 b Fj(A)24
b(n)n(ull)g(Ob)5 b(ject)24 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fj(NULL\))h(will)g(b)r(e)h(returned,)f(without)g(error,)f(if)h
-(the)g(Channel)g(con)n(tains)427 1089 y(no)k(further)f(Ob)5
-b(jects)27 b(to)h(b)r(e)g(read.)340 1218 y Fi(\017)45
+(the)g(Channel)g(con)n(tains)427 3923 y(no)k(further)f(Ob)5
+b(jects)27 b(to)h(b)r(e)g(read.)340 4057 y Fi(\017)45
b Fj(A)26 b(n)n(ull)f(Ob)5 b(ject)25 b(p)r(oin)n(ter)g(will)g(also)f(b)
r(e)h(returned)g(if)h(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j
-(ST)-7 b(A)g(TUS)26 b(set)f(to)g(an)427 1318 y(error)h(v)-5
+(ST)-7 b(A)g(TUS)26 b(set)f(to)g(an)427 4157 y(error)h(v)-5
b(alue,)27 b(or)g(if)h(it)g(should)g(fail)f(for)g(an)n(y)g(reason.)p
-0 1511 3780 12 v 0 1642 a FA(AST)p Fe(_)p FA(READFITS)1182
-1643 y Fd(Read)39 b(cards)f(in)m(to)f(a)i(FitsChan)1262
-1743 y(from)e(the)i(source)f(function)2752 1642 y FA(AST)p
-Fe(_)p FA(READFITS)0 1902 y Fc(Description:)44 b Fj(This)30
+0 4357 V 0 4488 a FA(AST)p Fe(_)p FA(READFITS)1182 4489
+y Fd(Read)39 b(cards)f(in)m(to)f(a)i(FitsChan)1262 4588
+y(from)e(the)i(source)f(function)2752 4488 y FA(AST)p
+Fe(_)p FA(READFITS)0 4755 y Fc(Description:)44 b Fj(This)30
b(routine)f(reads)g(cards)g(from)g(the)h(source)f(function)h(that)g(w)n
-(as)f(sp)r(eci\014ed)h(when)f(the)i(FitsChan)227 2002
+(as)f(sp)r(eci\014ed)h(when)f(the)i(FitsChan)227 4855
y(w)n(as)18 b(created,)i(and)f(stores)e(them)i(in)h(the)f(FitsChan.)34
b(This)18 b(normally)g(happ)r(ens)h(once-only)-7 b(,)19
-b(when)g(the)h(FitsChan)227 2101 y(is)33 b(accessed)f(for)g(the)h
+b(when)g(the)h(FitsChan)227 4955 y(is)33 b(accessed)f(for)g(the)h
(\014rst)g(time.)53 b(This)33 b(routine)f(pro)n(vides)f(a)i(means)f(of)
-h(forcing)f(a)g(re-read)f(of)i(the)g(external)227 2201
+h(forcing)f(a)g(re-read)f(of)i(the)g(external)227 5054
y(source,)f(and)g(ma)n(y)g(b)r(e)g(useful)h(if)f(\(sa)n(y\))g(new)g
(cards)f(ha)n(v)n(e)g(b)r(een)h(dep)r(osited)h(in)n(to)f(the)g
-(external)f(source.)50 b(An)n(y)227 2301 y(new)n(cards)26
+(external)f(source.)50 b(An)n(y)227 5154 y(new)n(cards)26
b(read)h(from)g(the)h(source)f(are)f(app)r(ended)i(to)g(the)g(end)g(of)
f(the)h(curren)n(t)f(con)n(ten)n(ts)g(of)g(the)h(FitsChan.)0
-2447 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_READFITS\()c
-(THIS,)j(STATUS)h(\))0 2594 y Fc(Argumen)m(ts:)259 2727
-y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 2827 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(FitsChan.)259 2957 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 3056
-y Fj(The)c(global)e(status.)0 3215 y Fc(Notes:)340 3495
-y Fi(\017)45 b Fj(This)30 b(function)h(returns)e(without)i(action)e(if)
-i(no)e(source)g(function)i(w)n(as)e(sp)r(eci\014ed)h(when)g(the)h
-(FitsChan)427 3594 y(w)n(as)c(created.)340 3724 y Fi(\017)45
+5305 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_READFITS\()c
+(THIS,)j(STATUS)h(\))0 5456 y Fc(Argumen)m(ts:)259 5593
+y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 5693 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(FitsChan.)p eop end
+%%Page: 330 340
+TeXDict begin 330 339 bop 0 52 a FG(330)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(ST)-8
+b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+451 y Fj(The)c(global)e(status.)0 612 y Fc(Notes:)340
+894 y Fi(\017)45 b Fj(This)30 b(function)h(returns)e(without)i(action)e
+(if)i(no)e(source)g(function)i(w)n(as)e(sp)r(eci\014ed)h(when)g(the)h
+(FitsChan)427 993 y(w)n(as)c(created.)340 1125 y Fi(\017)45
b Fj(The)29 b(SourceFile)g(attribute)g(is)g(ignored)f(b)n(y)g(this)i
(routine.)40 b(New)30 b(cards)d(are)h(read)h(from)f(the)i(source)d
-(\014le)427 3824 y(whenev)n(er)g(a)g(new)h(v)-5 b(alue)27
+(\014le)427 1225 y(whenev)n(er)g(a)g(new)h(v)-5 b(alue)27
b(is)h(assigned)e(to)i(the)g(SourceFile)e(attribute.)p
-0 4017 V 0 4148 a FA(AST)p Fe(_)p FA(REBIN)p Fb(<)p FA(X)p
-Fb(>)1266 4149 y Fd(Rebin)39 b(a)g(region)e(of)h(a)h(data)1789
-4263 y(grid)2725 4148 y FA(AST)p Fe(_)p FA(REBIN)p Fb(<)p
-FA(X)p Fb(>)0 4451 y Fc(Description:)44 b Fj(This)29
+0 1422 3780 12 v 0 1553 a FA(AST)p Fe(_)p FA(REBIN)p
+Fb(<)p FA(X)p Fb(>)1266 1554 y Fd(Rebin)39 b(a)g(region)e(of)h(a)h
+(data)1789 1668 y(grid)2725 1553 y FA(AST)p Fe(_)p FA(REBIN)p
+Fb(<)p FA(X)p Fb(>)0 1860 y Fc(Description:)44 b Fj(This)29
b(is)f(a)g(set)g(of)g(functions)h(for)e(rebinning)h(gridded)g(data)g
(\(e.g.)38 b(an)28 b(image\))g(under)g(the)h(con)n(trol)e(of)227
-4550 y(a)f(geometrical)f(transformation,)g(whic)n(h)h(is)g(sp)r
+1960 y(a)f(geometrical)f(transformation,)g(whic)n(h)h(is)g(sp)r
(eci\014ed)h(b)n(y)f(a)g(Mapping.)36 b(The)26 b(functions)h(op)r(erate)
-e(on)h(a)g(pair)g(of)227 4650 y(data)f(grids)f(\(input)i(and)f
+e(on)h(a)g(pair)g(of)227 2059 y(data)f(grids)f(\(input)i(and)f
(output\),)i(eac)n(h)d(of)h(whic)n(h)g(ma)n(y)g(ha)n(v)n(e)f(an)n(y)g
(n)n(um)n(b)r(er)h(of)g(dimensions.)36 b(Rebinning)25
-b(ma)n(y)227 4750 y(b)r(e)e(restricted)f(to)g(a)g(sp)r(eci\014ed)g
+b(ma)n(y)227 2159 y(b)r(e)e(restricted)f(to)g(a)g(sp)r(eci\014ed)g
(region)f(of)i(the)f(input)h(grid.)35 b(An)23 b(asso)r(ciated)e(grid)g
-(of)i(error)d(estimates)i(asso)r(ciated)227 4849 y(with)30
+(of)i(error)d(estimates)i(asso)r(ciated)227 2259 y(with)30
b(the)g(input)g(data)f(ma)n(y)g(also)f(b)r(e)i(supplied)g(\(in)g(the)g
(form)f(of)g(v)-5 b(ariance)29 b(v)-5 b(alues\),)30 b(so)e(as)h(to)h
-(pro)r(duce)f(error)227 4949 y(estimates)f(for)f(the)h(rebined)f
+(pro)r(duce)f(error)227 2358 y(estimates)f(for)f(the)h(rebined)f
(output)h(data.)37 b(Propagation)24 b(of)k(missing)f(data)g(\(bad)h
-(pixels\))g(is)f(supp)r(orted.)227 5072 y(Note,)d(if)f(y)n(ou)e(will)i
+(pixels\))g(is)f(supp)r(orted.)227 2482 y(Note,)d(if)f(y)n(ou)e(will)i
(b)r(e)g(rebining)f(a)g(sequence)g(of)g(input)i(arra)n(ys)19
b(and)k(then)g(co-adding)e(them)i(in)n(to)f(a)g(single)g(arra)n(y)-7
-b(,)227 5171 y(the)28 b(alternativ)n(e)f(AST)p Ft(_)p
+b(,)227 2582 y(the)28 b(alternativ)n(e)f(AST)p Ft(_)p
Fj(REBINSEQ)p Fl(<)p Fj(X)p Fl(>)e Fj(routines)i(will)h(in)g(general)e
-(b)r(e)i(more)f(e\016cien)n(t.)227 5295 y(Y)-7 b(ou)32
+(b)r(e)i(more)f(e\016cien)n(t.)227 2706 y(Y)-7 b(ou)32
b(should)g(use)g(a)g(rebinning)g(function)g(whic)n(h)g(matc)n(hes)g
(the)g(n)n(umerical)g(t)n(yp)r(e)g(of)g(the)h(data)e(y)n(ou)h(are)f
-(pro-)227 5394 y(cessing)h(b)n(y)h(replacing)f Fl(<)p
+(pro-)227 2806 y(cessing)h(b)n(y)h(replacing)f Fl(<)p
Fj(X)p Fl(>)g Fj(in)h(the)h(generic)e(function)h(name)g(AST)p
Ft(_)p Fj(REBIN)p Fl(<)p Fj(X)p Fl(>)f Fj(b)n(y)g(an)h(appropriate)e
-(1-)227 5494 y(or)26 b(2-c)n(haracter)e(t)n(yp)r(e)j(co)r(de.)36
+(1-)227 2905 y(or)26 b(2-c)n(haracter)e(t)n(yp)r(e)j(co)r(de.)36
b(F)-7 b(or)26 b(example,)h(if)g(y)n(ou)f(are)g(rebinning)g(data)g
(with)i(t)n(yp)r(e)f(REAL,)f(y)n(ou)g(should)h(use)227
-5593 y(the)j(function)g(AST)p Ft(_)p Fj(REBINR)f(\(see)g(the)h
+3005 y(the)j(function)g(AST)p Ft(_)p Fj(REBINR)f(\(see)g(the)h
Ft(")p Fj(Data)f(T)n(yp)r(e)g(Co)r(des)p Ft(")g Fj(section)g(b)r(elo)n
-(w)g(for)g(the)g(co)r(des)g(appropriate)227 5693 y(to)f(other)f(n)n
-(umerical)g(t)n(yp)r(es\).)p eop end
-%%Page: 328 338
-TeXDict begin 328 337 bop 0 52 a FG(328)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)227 351 y Fj(Rebinning)e(of)g(the)
-g(grid)f(of)g(input)i(data)e(is)h(p)r(erformed)f(b)n(y)g(transforming)g
-(the)h(co)r(ordinates)e(of)i(the)g(cen)n(tre)f(of)227
-451 y(eac)n(h)h(input)g(grid)g(elemen)n(t)g(\(or)f(pixel\))i(in)n(to)f
-(the)g(co)r(ordinate)f(system)h(of)g(the)g(output)h(grid.)41
-b(The)29 b(input)h(pixel)227 551 y(v)-5 b(alue)35 b(is)g(then)h
-(divided)f(up)h(and)f(assigned)f(to)h(the)g(output)h(pixels)f(in)g(the)
-h(neigh)n(b)r(ourho)r(o)r(d)e(of)h(the)h(cen)n(tral)227
-650 y(output)30 b(co)r(ordinates.)39 b(A)29 b(c)n(hoice)g(of)f(sc)n
-(hemes)h(are)f(pro)n(vided)f(for)i(determining)g(ho)n(w)f(eac)n(h)g
-(input)i(pixel)f(v)-5 b(alue)227 750 y(is)24 b(divided)g(up)h(b)r(et)n
-(w)n(een)f(the)g(output)g(pixels.)36 b(In)24 b(general,)f(eac)n(h)h
-(output)g(pixel)g(ma)n(y)f(b)r(e)i(assigned)d(v)-5 b(alues)24
-b(from)227 849 y(more)18 b(than)h(one)g(input)h(pixel.)34
-b(All)19 b(con)n(tributions)f(to)h(a)f(giv)n(en)h(output)g(pixel)g(are)
-f(summed)h(to)g(pro)r(duce)f(the)i(\014nal)227 949 y(output)25
+(w)g(for)g(the)g(co)r(des)g(appropriate)227 3105 y(to)f(other)f(n)n
+(umerical)g(t)n(yp)r(es\).)227 3229 y(Rebinning)i(of)g(the)g(grid)f(of)
+g(input)i(data)e(is)h(p)r(erformed)f(b)n(y)g(transforming)g(the)h(co)r
+(ordinates)e(of)i(the)g(cen)n(tre)f(of)227 3328 y(eac)n(h)h(input)g
+(grid)g(elemen)n(t)g(\(or)f(pixel\))i(in)n(to)f(the)g(co)r(ordinate)f
+(system)h(of)g(the)g(output)h(grid.)41 b(The)29 b(input)h(pixel)227
+3428 y(v)-5 b(alue)35 b(is)g(then)h(divided)f(up)h(and)f(assigned)f(to)
+h(the)g(output)h(pixels)f(in)g(the)h(neigh)n(b)r(ourho)r(o)r(d)e(of)h
+(the)h(cen)n(tral)227 3527 y(output)30 b(co)r(ordinates.)39
+b(A)29 b(c)n(hoice)g(of)f(sc)n(hemes)h(are)f(pro)n(vided)f(for)i
+(determining)g(ho)n(w)f(eac)n(h)g(input)i(pixel)f(v)-5
+b(alue)227 3627 y(is)24 b(divided)g(up)h(b)r(et)n(w)n(een)f(the)g
+(output)g(pixels.)36 b(In)24 b(general,)f(eac)n(h)h(output)g(pixel)g
+(ma)n(y)f(b)r(e)i(assigned)d(v)-5 b(alues)24 b(from)227
+3727 y(more)18 b(than)h(one)g(input)h(pixel.)34 b(All)19
+b(con)n(tributions)f(to)h(a)f(giv)n(en)h(output)g(pixel)g(are)f(summed)
+h(to)g(pro)r(duce)f(the)i(\014nal)227 3826 y(output)25
b(pixel)f(v)-5 b(alue.)36 b(Output)25 b(pixels)f(can)f(b)r(e)i(set)f
(to)g(the)h(supplied)f(bad)g(v)-5 b(alue)24 b(if)h(they)g(receiv)n(e)d
-(con)n(tributions)227 1049 y(from)28 b(an)f(insu\016cien)n(t)h(n)n(um)n
+(con)n(tributions)227 3926 y(from)28 b(an)f(insu\016cien)n(t)h(n)n(um)n
(b)r(er)f(of)h(input)g(pixels.)37 b(This)27 b(is)h(con)n(trolled)e(b)n
-(y)h(the)h(WLIM)g(argumen)n(t.)227 1172 y(Input)34 b(pixel)e(co)r
+(y)h(the)h(WLIM)g(argumen)n(t.)227 4050 y(Input)34 b(pixel)e(co)r
(ordinates)g(are)f(transformed)h(in)n(to)g(the)h(co)r(ordinate)f
(system)g(of)h(the)g(output)g(grid)f(using)g(the)227
-1272 y(forw)n(ard)f(transformation)f(of)i(the)h(Mapping)f(whic)n(h)g
+4150 y(forw)n(ard)f(transformation)f(of)i(the)h(Mapping)f(whic)n(h)g
(is)g(supplied.)50 b(This)33 b(means)e(that)i(geometrical)d(features)
-227 1372 y(in)i(the)f(input)h(data)f(are)f(sub)5 b(jected)31
+227 4249 y(in)i(the)f(input)h(data)f(are)f(sub)5 b(jected)31
b(to)g(the)h(Mapping's)e(forw)n(ard)g(transformation)f(as)i(they)g(are)
-f(transferred)227 1471 y(from)e(the)g(input)g(to)f(the)h(output)g
-(grid.)227 1595 y(In)c(practice,)f(transforming)e(the)j(co)r(ordinates)
+f(transferred)227 4349 y(from)e(the)g(input)g(to)f(the)h(output)g
+(grid.)227 4473 y(In)c(practice,)f(transforming)e(the)j(co)r(ordinates)
e(of)h(ev)n(ery)e(pixel)j(of)f(a)f(large)g(data)h(grid)f(can)h(b)r(e)g
-(time-consuming,)227 1694 y(esp)r(ecially)38 b(if)g(the)h(Mapping)f(in)
+(time-consuming,)227 4573 y(esp)r(ecially)38 b(if)g(the)h(Mapping)f(in)
n(v)n(olv)n(es)e(complicated)i(functions,)j(suc)n(h)c(as)h(sky)f(pro)5
-b(jections.)67 b(T)-7 b(o)38 b(impro)n(v)n(e)227 1794
+b(jections.)67 b(T)-7 b(o)38 b(impro)n(v)n(e)227 4672
y(p)r(erformance,)29 b(it)g(is)g(therefore)f(p)r(ossible)g(to)h(appro)n
(ximate)e(non-linear)h(Mappings)g(b)n(y)h(a)g(set)g(of)f(linear)h
-(trans-)227 1894 y(formations)h(whic)n(h)h(are)f(applied)g(piece-wise)h
+(trans-)227 4772 y(formations)h(whic)n(h)h(are)f(applied)g(piece-wise)h
(to)f(separate)g(sub-regions)f(of)h(the)i(data.)46 b(This)30
-b(appro)n(ximation)227 1993 y(pro)r(cess)37 b(is)h(applied)g
+b(appro)n(ximation)227 4872 y(pro)r(cess)37 b(is)h(applied)g
(automatically)f(b)n(y)h(an)g(adaptiv)n(e)f(algorithm,)i(under)f(con)n
-(trol)f(of)h(an)g(accuracy)e(crite-)227 2093 y(rion)25
+(trol)f(of)h(an)g(accuracy)e(crite-)227 4971 y(rion)25
b(whic)n(h)h(expresses)f(the)h(maxim)n(um)g(tolerable)f(geometrical)f
(distortion)h(whic)n(h)h(ma)n(y)f(b)r(e)i(in)n(tro)r(duced,)f(as)f(a)
-227 2193 y(fraction)i(of)h(a)f(pixel.)227 2316 y(This)34
+227 5071 y(fraction)i(of)h(a)f(pixel.)227 5195 y(This)34
b(algorithm)e(\014rst)h(attempts)h(to)g(appro)n(ximate)e(the)i(Mapping)
-f(with)h(a)f(linear)g(transformation)f(applied)227 2416
+f(with)h(a)f(linear)g(transformation)f(applied)227 5295
y(o)n(v)n(er)j(the)j(whole)e(region)g(of)h(the)g(input)h(grid)e(whic)n
(h)h(is)g(b)r(eing)g(used.)65 b(If)37 b(this)g(pro)n(v)n(es)e(to)i(b)r
-(e)g(insu\016cien)n(tly)227 2515 y(accurate,)c(the)h(input)f(region)f
+(e)g(insu\016cien)n(tly)227 5394 y(accurate,)c(the)h(input)f(region)f
(is)h(sub-divided)g(in)n(to)f(t)n(w)n(o)h(along)e(its)i(largest)f
-(dimension)h(and)g(the)g(pro)r(cess)f(is)227 2615 y(rep)r(eated)h
+(dimension)h(and)g(the)g(pro)r(cess)f(is)227 5494 y(rep)r(eated)h
(within)h(eac)n(h)f(of)g(the)h(resulting)e(sub-regions.)53
b(This)33 b(pro)r(cess)f(of)h(sub-division)g(con)n(tin)n(ues)f(un)n
-(til)i(a)227 2715 y(su\016cien)n(tly)27 b(go)r(o)r(d)g(linear)f(appro)n
+(til)i(a)227 5593 y(su\016cien)n(tly)27 b(go)r(o)r(d)g(linear)f(appro)n
(ximation)g(is)h(found,)g(or)f(the)i(region)e(to)h(whic)n(h)g(it)h(is)f
-(b)r(eing)g(applied)g(b)r(ecomes)227 2814 y(to)r(o)h(small)f(\(in)h
-(whic)n(h)f(case)g(the)h(original)e(Mapping)h(is)h(used)g(directly\).)0
-2962 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_REBIN)p
-Fl(<)p Ft(X)p Fl(>)p Ft(\()c(THIS,)j(WLIM,)h(NDIM_IN,)e(LBND_IN,)g
-(UBND_IN,)h(IN,)h(IN_VAR,)f(SPREAD,)227 3062 y(PARAMS,)g(FLAGS,)g(TOL,)
-h(MAXPIX,)f(BADVAL,)f(NDIM_OUT,)g(LBND_OUT,)g(UBND_OUT,)g(LBND,)h
-(UBND,)h(OUT,)227 3161 y(OUT_VAR,)f(STATUS)g(\))0 3309
-y Fc(Argumen)m(ts:)259 3444 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
-3543 y Fj(P)n(oin)n(ter)19 b(to)h(a)f(Mapping,)j(whose)d(forw)n(ard)f
+(b)r(eing)g(applied)g(b)r(ecomes)227 5693 y(to)r(o)h(small)f(\(in)h
+(whic)n(h)f(case)g(the)h(original)e(Mapping)h(is)h(used)g(directly\).)p
+eop end
+%%Page: 331 341
+TeXDict begin 331 340 bop 3643 52 a FG(331)0 351 y Fc(In)m(v)m(o)s
+(cation:)123 b Ft(CALL)42 b(AST_REBIN)p Fl(<)p Ft(X)p
+Fl(>)p Ft(\()c(THIS,)j(WLIM,)h(NDIM_IN,)e(LBND_IN,)g(UBND_IN,)h(IN,)h
+(IN_VAR,)f(SPREAD,)227 451 y(PARAMS,)g(FLAGS,)g(TOL,)h(MAXPIX,)f
+(BADVAL,)f(NDIM_OUT,)g(LBND_OUT,)g(UBND_OUT,)g(LBND,)h(UBND,)h(OUT,)227
+551 y(OUT_VAR,)f(STATUS)g(\))0 727 y Fc(Argumen)m(ts:)259
+890 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 990 y
+Fj(P)n(oin)n(ter)19 b(to)h(a)f(Mapping,)j(whose)d(forw)n(ard)f
(transformation)h(will)h(b)r(e)h(used)f(to)g(transform)f(the)h(co)r
-(ordinates)427 3643 y(of)28 b(pixels)f(in)h(the)g(input)g(grid)f(in)n
+(ordinates)427 1089 y(of)28 b(pixels)f(in)h(the)g(input)g(grid)f(in)n
(to)h(the)g(co)r(ordinate)e(system)h(of)h(the)g(output)g(grid.)427
-3758 y(The)c(n)n(um)n(b)r(er)g(of)g(input)h(co)r(ordinates)e(used)h(b)n
+1212 y(The)c(n)n(um)n(b)r(er)g(of)g(input)h(co)r(ordinates)e(used)h(b)n
(y)g(this)g(Mapping)g(\(as)f(giv)n(en)h(b)n(y)f(its)i(Nin)f
-(attribute\))h(should)427 3858 y(matc)n(h)f(the)h(n)n(um)n(b)r(er)f(of)
+(attribute\))h(should)427 1312 y(matc)n(h)f(the)h(n)n(um)n(b)r(er)f(of)
g(input)h(grid)f(dimensions)f(giv)n(en)h(b)n(y)g(the)g(v)-5
b(alue)25 b(of)f(NDIM)p Ft(_)p Fj(IN)h(b)r(elo)n(w.)35
-b(Similarly)-7 b(,)427 3957 y(the)29 b(n)n(um)n(b)r(er)e(of)h(output)g
+b(Similarly)-7 b(,)427 1411 y(the)29 b(n)n(um)n(b)r(er)e(of)h(output)g
(co)r(ordinates)f(\(Nout)h(attribute\))h(should)e(matc)n(h)h(the)g(n)n
-(um)n(b)r(er)g(of)g(output)g(grid)427 4057 y(dimensions)g(giv)n(en)e(b)
-n(y)i(NDIM)p Ft(_)p Fj(OUT.)259 4188 y Fc(WLIM)k(=)g(DOUBLE)g
-(PRECISION)g(\(Giv)m(en\))427 4288 y Fj(Giv)n(es)27 b(the)g(required)f
+(um)n(b)r(er)g(of)g(output)g(grid)427 1511 y(dimensions)g(giv)n(en)e(b)
+n(y)i(NDIM)p Ft(_)p Fj(OUT.)259 1657 y Fc(WLIM)k(=)g(DOUBLE)g
+(PRECISION)g(\(Giv)m(en\))427 1757 y Fj(Giv)n(es)27 b(the)g(required)f
(n)n(um)n(b)r(er)g(of)h(input)h(pixel)f(v)-5 b(alues)26
b(whic)n(h)h(m)n(ust)g(con)n(tribute)g(to)f(an)h(output)g(pixel)g(in)
-427 4387 y(order)f(for)h(the)h(output)f(pixel)h(v)-5
+427 1857 y(order)f(for)h(the)h(output)f(pixel)h(v)-5
b(alue)27 b(to)g(b)r(e)h(considered)e(v)-5 b(alid.)37
b(If)27 b(the)h(sum)f(of)h(the)f(input)h(pixel)g(w)n(eigh)n(ts)427
-4487 y(con)n(tributing)f(to)h(an)g(output)g(pixel)g(is)f(less)h(than)g
+1956 y(con)n(tributing)f(to)h(an)g(output)g(pixel)g(is)f(less)h(than)g
(the)g(supplied)g(WLIM)g(v)-5 b(alue,)28 b(then)g(the)g(output)h(pixel)
-427 4587 y(v)-5 b(alue)28 b(is)f(returned)g(set)h(to)f(the)h(supplied)g
-(bad)g(v)-5 b(alue.)259 4718 y Fc(NDIM)p Ft(_)p Fc(IN)31
-b(=)h(INTEGER)g(\(Giv)m(en\))427 4817 y Fj(The)c(n)n(um)n(b)r(er)f(of)h
+427 2056 y(v)-5 b(alue)28 b(is)f(returned)g(set)h(to)f(the)h(supplied)g
+(bad)g(v)-5 b(alue.)259 2202 y Fc(NDIM)p Ft(_)p Fc(IN)31
+b(=)h(INTEGER)g(\(Giv)m(en\))427 2302 y Fj(The)c(n)n(um)n(b)r(er)f(of)h
(dimensions)f(in)h(the)g(input)g(grid.)36 b(This)28 b(should)f(b)r(e)h
-(at)g(least)f(one.)259 4948 y Fc(LBND)p Ft(_)p Fc(IN\()32
+(at)g(least)f(one.)259 2448 y Fc(LBND)p Ft(_)p Fc(IN\()32
b(NDIM)p Ft(_)p Fc(IN)f(\))h(=)g(INTEGER)f(\(Giv)m(en\))427
-5048 y Fj(An)j(arra)n(y)d(con)n(taining)h(the)i(co)r(ordinates)e(of)h
+2547 y Fj(An)j(arra)n(y)d(con)n(taining)h(the)i(co)r(ordinates)e(of)h
(the)h(cen)n(tre)f(of)g(the)g(\014rst)h(pixel)f(in)g(the)h(input)g
-(grid)f(along)427 5148 y(eac)n(h)27 b(dimension.)259
-5279 y Fc(UBND)p Ft(_)p Fc(IN\()32 b(NDIM)p Ft(_)p Fc(IN)f(\))h(=)g
-(INTEGER)f(\(Giv)m(en\))427 5378 y Fj(An)k(arra)n(y)d(con)n(taining)h
+(grid)f(along)427 2647 y(eac)n(h)27 b(dimension.)259
+2793 y Fc(UBND)p Ft(_)p Fc(IN\()32 b(NDIM)p Ft(_)p Fc(IN)f(\))h(=)g
+(INTEGER)f(\(Giv)m(en\))427 2893 y Fj(An)k(arra)n(y)d(con)n(taining)h
(the)h(co)r(ordinates)f(of)h(the)h(cen)n(tre)f(of)g(the)g(last)g(pixel)
-g(in)h(the)f(input)h(grid)f(along)427 5478 y(eac)n(h)27
-b(dimension.)427 5593 y(Note)h(that)f(LBND)p Ft(_)p Fj(IN)h(and)f(UBND)
+g(in)h(the)f(input)h(grid)f(along)427 2993 y(eac)n(h)27
+b(dimension.)427 3116 y(Note)h(that)f(LBND)p Ft(_)p Fj(IN)h(and)f(UBND)
p Ft(_)p Fj(IN)h(together)f(de\014ne)g(the)h(shap)r(e)f(and)g(size)g
-(of)h(the)g(input)g(grid,)e(its)427 5693 y(exten)n(t)33
+(of)h(the)g(input)g(grid,)e(its)427 3215 y(exten)n(t)33
b(along)e(a)i(particular)e(\(J'th\))j(dimension)e(b)r(eing)h(UBND)p
Ft(_)p Fj(IN\(J\)-LBND)p Ft(_)p Fj(IN\(J\)+1.)52 b(They)33
-b(also)p eop end
-%%Page: 329 339
-TeXDict begin 329 338 bop 3643 52 a FG(329)427 351 y
-Fj(de\014ne)25 b(the)f(input)i(grid's)d(co)r(ordinate)g(system,)i(eac)n
-(h)e(pixel)i(ha)n(ving)e(unit)i(exten)n(t)f(along)f(eac)n(h)h
-(dimension)427 451 y(with)k(in)n(tegral)f(co)r(ordinate)f(v)-5
-b(alues)27 b(at)h(its)g(cen)n(tre.)259 577 y Fc(IN\()k
+b(also)427 3315 y(de\014ne)25 b(the)f(input)i(grid's)d(co)r(ordinate)g
+(system,)i(eac)n(h)e(pixel)i(ha)n(ving)e(unit)i(exten)n(t)f(along)f
+(eac)n(h)h(dimension)427 3414 y(with)k(in)n(tegral)f(co)r(ordinate)f(v)
+-5 b(alues)27 b(at)h(its)g(cen)n(tre.)259 3561 y Fc(IN\()k
Fi(\003)f Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p Fl(>)g
-Fc(\(Giv)m(en\))427 676 y Fj(An)k(arra)n(y)-7 b(,)36
+Fc(\(Giv)m(en\))427 3660 y Fj(An)k(arra)n(y)-7 b(,)36
b(with)g(one)g(elemen)n(t)f(for)h(eac)n(h)f(pixel)g(in)h(the)g(input)h
(grid,)g(con)n(taining)e(the)h(input)g(data)g(to)427
-776 y(b)r(e)c(rebined.)47 b(The)32 b(n)n(umerical)e(t)n(yp)r(e)h(of)h
+3760 y(b)r(e)c(rebined.)47 b(The)32 b(n)n(umerical)e(t)n(yp)r(e)h(of)h
(this)f(arra)n(y)e(should)i(matc)n(h)g(the)g(1-)g(or)f(2-c)n(haracter)e
-(t)n(yp)r(e)k(co)r(de)427 875 y(app)r(ended)d(to)f(the)g(function)h
+(t)n(yp)r(e)k(co)r(de)427 3860 y(app)r(ended)d(to)f(the)g(function)h
(name)f(\(e.g.)38 b(if)29 b(y)n(ou)f(are)f(using)h(AST)p
Ft(_)p Fj(REBINR,)g(the)g(t)n(yp)r(e)g(of)h(eac)n(h)e(arra)n(y)427
-975 y(elemen)n(t)h(should)f(b)r(e)h(REAL\).)427 1088
+3959 y(elemen)n(t)h(should)f(b)r(e)h(REAL\).)427 4082
y(The)33 b(storage)f(order)f(of)j(data)e(within)i(this)g(arra)n(y)c
(should)j(b)r(e)h(suc)n(h)f(that)g(the)h(index)f(of)g(the)g(\014rst)g
-(grid)427 1187 y(dimension)39 b(v)-5 b(aries)39 b(most)g(rapidly)g(and)
+(grid)427 4182 y(dimension)39 b(v)-5 b(aries)39 b(most)g(rapidly)g(and)
g(that)g(of)h(the)f(\014nal)g(dimension)h(least)f(rapidly)f(\(i.e.)73
-b(normal)427 1287 y(F)-7 b(ortran)27 b(arra)n(y)e(storage)h(order\).)
-259 1413 y Fc(IN)p Ft(_)p Fc(V)-11 b(AR\()32 b Fi(\003)f
+b(normal)427 4281 y(F)-7 b(ortran)27 b(arra)n(y)e(storage)h(order\).)
+259 4428 y Fc(IN)p Ft(_)p Fc(V)-11 b(AR\()32 b Fi(\003)f
Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p Fl(>)g Fc(\(Giv)m(en\))427
-1512 y Fj(An)24 b(optional)e(second)h(arra)n(y)e(with)i(the)h(same)f
+4527 y Fj(An)24 b(optional)e(second)h(arra)n(y)e(with)i(the)h(same)f
(size)f(and)h(t)n(yp)r(e)h(as)e(the)i(IN)f(arra)n(y)-7
b(.)34 b(If)23 b(the)h(AST)p Ft(__)p Fj(USEV)-9 b(AR)427
-1612 y(\015ag)28 b(is)g(set)h(via)f(the)h(FLA)n(GS)g(argumen)n(t)e(\(b)
+4627 y(\015ag)28 b(is)g(set)h(via)f(the)h(FLA)n(GS)g(argumen)n(t)e(\(b)
r(elo)n(w\),)i(this)g(arra)n(y)d(should)i(con)n(tain)g(a)g(set)h(of)f
-(non-negativ)n(e)427 1712 y(v)-5 b(alues)32 b(whic)n(h)h(represen)n(t)e
+(non-negativ)n(e)427 4726 y(v)-5 b(alues)32 b(whic)n(h)h(represen)n(t)e
(estimates)h(of)g(the)h(statistical)f(v)-5 b(ariance)31
b(asso)r(ciated)g(with)i(eac)n(h)e(elemen)n(t)i(of)427
-1811 y(the)28 b(IN)g(arra)n(y)-7 b(.)35 b(Estimates)27
+4826 y(the)28 b(IN)g(arra)n(y)-7 b(.)35 b(Estimates)27
b(of)g(the)h(v)-5 b(ariance)27 b(of)g(the)h(rebined)g(output)g(data)f
-(will)h(then)g(b)r(e)g(calculated.)427 1924 y(If)d(the)g(AST)p
+(will)h(then)g(b)r(e)g(calculated.)427 4949 y(If)d(the)g(AST)p
Ft(__)p Fj(USEV)-9 b(AR)25 b(\015ag)f(is)g(not)h(set,)g(no)g(input)g(v)
-5 b(ariance)24 b(estimates)g(are)g(required)f(and)i(this)g(arra)n(y)
-427 2024 y(will)j(not)g(b)r(e)g(used.)37 b(A)27 b(dumm)n(y)h(\(e.g.)37
+427 5049 y(will)j(not)g(b)r(e)g(used.)37 b(A)27 b(dumm)n(y)h(\(e.g.)37
b(one-elemen)n(t\))27 b(arra)n(y)e(ma)n(y)i(then)h(b)r(e)g(supplied.)
-259 2149 y Fc(SPREAD)k(=)g(INTEGER)f(\(Giv)m(en\))427
-2249 y Fj(This)25 b(argumen)n(t)e(sp)r(eci\014es)i(the)g(sc)n(heme)f
+259 5195 y Fc(SPREAD)k(=)g(INTEGER)f(\(Giv)m(en\))427
+5295 y Fj(This)25 b(argumen)n(t)e(sp)r(eci\014es)i(the)g(sc)n(heme)f
(to)g(b)r(e)h(used)g(for)f(dividing)g(eac)n(h)g(input)h(data)f(v)-5
-b(alue)25 b(up)g(amongst)427 2348 y(the)30 b(corresp)r(onding)d(output)
+b(alue)25 b(up)g(amongst)427 5394 y(the)30 b(corresp)r(onding)d(output)
j(pixels.)42 b(It)30 b(ma)n(y)e(b)r(e)i(used)f(to)h(select)f(from)g(a)g
-(set)g(of)g(pre-de\014ned)g(sc)n(hemes)427 2448 y(b)n(y)f(supplying)f
+(set)g(of)g(pre-de\014ned)g(sc)n(hemes)427 5494 y(b)n(y)f(supplying)f
(one)g(of)h(the)g(v)-5 b(alues)27 b(describ)r(ed)g(in)h(the)g
Ft(")p Fj(Pixel)f(Spreading)g(Sc)n(hemes)p Ft(")f Fj(section)i(b)r(elo)
-n(w.)36 b(If)427 2548 y(a)d(v)-5 b(alue)34 b(of)f(zero)g(is)g
+n(w.)36 b(If)427 5593 y(a)d(v)-5 b(alue)34 b(of)f(zero)g(is)g
(supplied,)i(then)f(the)g(default)g(linear)f(spreading)f(sc)n(heme)h
-(is)h(used)f(\(equiv)-5 b(alen)n(t)34 b(to)427 2647 y(supplying)28
-b(the)g(v)-5 b(alue)27 b(AST)p Ft(__)p Fj(LINEAR\).)259
-2773 y Fc(P)-8 b(ARAMS\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)
-e(\(Giv)m(en\))427 2873 y Fj(An)23 b(optional)f(arra)n(y)e(whic)n(h)i
-(should)g(con)n(tain)g(an)n(y)g(additional)f(parameter)g(v)-5
-b(alues)22 b(required)g(b)n(y)g(the)h(pixel)427 2972
-y(spreading)g(sc)n(heme.)36 b(If)24 b(suc)n(h)g(parameters)f(are)g
-(required,)h(this)h(will)g(b)r(e)f(noted)h(in)f(the)h
-Ft(")p Fj(Pixel)f(Spreading)427 3072 y(Sc)n(hemes)p Ft(")j
-Fj(section)g(b)r(elo)n(w.)427 3185 y(If)f(no)e(additional)g(parameters)
-g(are)f(required,)i(this)g(arra)n(y)d(is)j(not)g(used.)36
-b(A)25 b(dumm)n(y)g(\(e.g.)36 b(one-elemen)n(t\))427
-3284 y(arra)n(y)26 b(ma)n(y)g(then)j(b)r(e)f(supplied.)259
-3410 y Fc(FLA)m(GS)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
-3510 y Fj(The)36 b(sum)f(of)h(a)f(set)g(of)g(\015ag)g(v)-5
+(is)h(used)f(\(equiv)-5 b(alen)n(t)34 b(to)427 5693 y(supplying)28
+b(the)g(v)-5 b(alue)27 b(AST)p Ft(__)p Fj(LINEAR\).)p
+eop end
+%%Page: 332 342
+TeXDict begin 332 341 bop 0 52 a FG(332)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(P)-8
+b(ARAMS\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m(en\))
+427 451 y Fj(An)23 b(optional)f(arra)n(y)e(whic)n(h)i(should)g(con)n
+(tain)g(an)n(y)g(additional)f(parameter)g(v)-5 b(alues)22
+b(required)g(b)n(y)g(the)h(pixel)427 551 y(spreading)g(sc)n(heme.)36
+b(If)24 b(suc)n(h)g(parameters)f(are)g(required,)h(this)h(will)g(b)r(e)
+f(noted)h(in)f(the)h Ft(")p Fj(Pixel)f(Spreading)427
+650 y(Sc)n(hemes)p Ft(")j Fj(section)g(b)r(elo)n(w.)427
+773 y(If)f(no)e(additional)g(parameters)g(are)f(required,)i(this)g
+(arra)n(y)d(is)j(not)g(used.)36 b(A)25 b(dumm)n(y)g(\(e.g.)36
+b(one-elemen)n(t\))427 872 y(arra)n(y)26 b(ma)n(y)g(then)j(b)r(e)f
+(supplied.)259 1018 y Fc(FLA)m(GS)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
+1118 y Fj(The)36 b(sum)f(of)h(a)f(set)g(of)g(\015ag)g(v)-5
b(alues)35 b(whic)n(h)g(ma)n(y)g(b)r(e)h(used)f(to)g(pro)n(vide)g
-(additional)g(con)n(trol)f(o)n(v)n(er)f(the)427 3609
+(additional)g(con)n(trol)f(o)n(v)n(er)f(the)427 1217
y(rebinning)d(op)r(eration.)45 b(See)31 b(the)f Ft(")p
Fj(Con)n(trol)f(Flags)p Ft(")g Fj(section)i(b)r(elo)n(w)f(for)g(a)g
-(description)g(of)g(the)h(options)427 3709 y(a)n(v)-5
+(description)g(of)g(the)h(options)427 1317 y(a)n(v)-5
b(ailable.)36 b(If)28 b(no)f(\015ag)g(v)-5 b(alues)27
b(are)g(to)g(b)r(e)h(set,)g(a)f(v)-5 b(alue)28 b(of)f(zero)g(should)g
-(b)r(e)h(giv)n(en.)259 3835 y Fc(TOL)k(=)h(DOUBLE)f(PRECISION)f(\(Giv)m
-(en\))427 3934 y Fj(The)j(maxim)n(um)f(tolerable)f(geometrical)f
+(b)r(e)h(giv)n(en.)259 1463 y Fc(TOL)k(=)h(DOUBLE)f(PRECISION)f(\(Giv)m
+(en\))427 1562 y Fj(The)j(maxim)n(um)f(tolerable)f(geometrical)f
(distortion)i(whic)n(h)g(ma)n(y)f(b)r(e)i(in)n(tro)r(duced)f(as)f(a)h
-(result)g(of)g(ap-)427 4034 y(pro)n(ximating)c(non-linear)f(Mappings)h
+(result)g(of)g(ap-)427 1662 y(pro)n(ximating)c(non-linear)f(Mappings)h
(b)n(y)h(a)f(set)h(of)g(piece-wise)f(linear)g(transformations.)42
-b(This)30 b(should)427 4133 y(b)r(e)e(expressed)f(as)g(a)g(displacemen)
+b(This)30 b(should)427 1761 y(b)r(e)e(expressed)f(as)g(a)g(displacemen)
n(t)g(in)h(pixels)f(in)h(the)g(output)g(grid's)f(co)r(ordinate)f
-(system.)427 4246 y(If)34 b(piece-wise)f(linear)g(appro)n(ximation)f
+(system.)427 1884 y(If)34 b(piece-wise)f(linear)g(appro)n(ximation)f
(is)h(not)h(required,)g(a)f(v)-5 b(alue)33 b(of)h(zero)e(ma)n(y)h(b)r
-(e)h(giv)n(en.)54 b(This)33 b(will)427 4346 y(ensure)k(that)g(the)h
+(e)h(giv)n(en.)54 b(This)33 b(will)427 1984 y(ensure)k(that)g(the)h
(Mapping)e(is)h(used)g(without)h(an)n(y)e(appro)n(ximation,)i(but)g(ma)
-n(y)e(increase)g(execution)427 4445 y(time.)427 4558
+n(y)e(increase)g(execution)427 2083 y(time.)427 2206
y(If)d(the)f(v)-5 b(alue)32 b(is)g(to)r(o)g(high,)h(discon)n(tin)n
(uities)e(b)r(et)n(w)n(een)h(the)h(linear)e(appro)n(ximations)f(used)i
-(in)g(adjacen)n(t)427 4658 y(panel)h(will)g(b)r(e)g(higher,)h(and)f(ma)
+(in)g(adjacen)n(t)427 2306 y(panel)h(will)g(b)r(e)g(higher,)h(and)f(ma)
n(y)f(cause)g(the)i(edges)e(of)h(the)g(panel)g(to)g(b)r(e)g(visible)g
-(when)g(viewing)f(the)427 4757 y(output)c(image)f(at)h(high)f(con)n
+(when)g(viewing)f(the)427 2405 y(output)c(image)f(at)h(high)f(con)n
(trast.)36 b(If)28 b(this)g(is)f(a)g(problem,)g(reduce)h(the)g
-(tolerance)e(v)-5 b(alue)27 b(used.)259 4883 y Fc(MAXPIX)33
-b(=)f(INTEGER)f(\(Giv)m(en\))427 4983 y Fj(A)42 b(v)-5
+(tolerance)e(v)-5 b(alue)27 b(used.)259 2551 y Fc(MAXPIX)33
+b(=)f(INTEGER)f(\(Giv)m(en\))427 2650 y Fj(A)42 b(v)-5
b(alue)40 b(whic)n(h)h(sp)r(eci\014es)g(an)g(initial)g(scale)g(size)f
(\(in)i(pixels\))f(for)f(the)i(adaptiv)n(e)e(algorithm)g(whic)n(h)427
-5082 y(appro)n(ximates)d(non-linear)g(Mappings)h(with)h(piece-wise)f
+2750 y(appro)n(ximates)d(non-linear)g(Mappings)h(with)h(piece-wise)f
(linear)g(transformations.)68 b(Normally)-7 b(,)40 b(this)427
-5182 y(should)e(b)r(e)g(a)g(large)e(v)-5 b(alue)38 b(\(larger)e(than)j
+2850 y(should)e(b)r(e)g(a)g(large)e(v)-5 b(alue)38 b(\(larger)e(than)j
(an)n(y)e(dimension)h(of)f(the)i(region)d(of)i(the)h(input)f(grid)g(b)r
-(eing)427 5281 y(used\).)46 b(In)31 b(this)g(case,)g(a)f(\014rst)g
+(eing)427 2949 y(used\).)46 b(In)31 b(this)g(case,)g(a)f(\014rst)g
(attempt)h(to)g(appro)n(ximate)e(the)i(Mapping)f(b)n(y)g(a)g(linear)g
-(transformation)427 5381 y(will)e(b)r(e)g(made)f(o)n(v)n(er)f(the)i(en)
-n(tire)f(input)i(region.)427 5494 y(If)k(a)f(smaller)f(v)-5
+(transformation)427 3049 y(will)e(b)r(e)g(made)f(o)n(v)n(er)f(the)i(en)
+n(tire)f(input)i(region.)427 3172 y(If)k(a)f(smaller)f(v)-5
b(alue)33 b(is)f(used,)i(the)e(input)h(region)f(will)g(\014rst)g(b)r(e)
h(divided)g(in)n(to)f(sub-regions)e(whose)i(size)427
-5593 y(do)r(es)40 b(not)g(exceed)f(MAXPIX)h(pixels)g(in)g(an)n(y)f
+3271 y(do)r(es)40 b(not)g(exceed)f(MAXPIX)h(pixels)g(in)g(an)n(y)f
(dimension.)74 b(Only)39 b(at)h(this)g(p)r(oin)n(t)g(will)g(attempts)h
-(at)427 5693 y(appro)n(ximation)26 b(commence.)p eop
-end
-%%Page: 330 340
-TeXDict begin 330 339 bop 0 52 a FG(330)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(This)38
-b(v)-5 b(alue)38 b(ma)n(y)g(o)r(ccasionally)e(b)r(e)j(useful)f(in)h
-(prev)n(en)n(ting)e(false)h(con)n(v)n(ergence)d(of)j(the)h(adaptiv)n(e)
-e(al-)427 451 y(gorithm)c(in)g(cases)f(where)g(the)h(Mapping)g(app)r
-(ears)f(appro)n(ximately)f(linear)h(on)h(large)e(scales,)j(but)f(has)
-427 551 y(irregularities)27 b(\(e.g.)40 b(holes\))28
-b(on)g(smaller)g(scales.)39 b(A)29 b(v)-5 b(alue)28 b(of,)h(sa)n(y)-7
-b(,)28 b(50)g(to)g(100)g(pixels)g(can)g(also)g(b)r(e)h(em-)427
-650 y(plo)n(y)n(ed)23 b(as)f(a)h(safeguard)f(in)i(general-purp)r(ose)d
-(soft)n(w)n(are,)i(since)g(the)h(e\013ect)f(on)h(p)r(erformance)e(is)h
-(minimal.)427 766 y(If)e(to)r(o)f(small)g(a)g(v)-5 b(alue)20
-b(is)g(giv)n(en,)h(it)g(will)f(ha)n(v)n(e)f(the)i(e\013ect)g(of)f
-(inhibiting)h(linear)f(appro)n(ximation)e(altogether)427
-866 y(\(equiv)-5 b(alen)n(t)21 b(to)f(setting)h(TOL)f(to)g(zero\).)34
-b(Although)20 b(this)h(ma)n(y)f(degrade)f(p)r(erformance,)i(accurate)e
-(results)427 965 y(will)28 b(still)g(b)r(e)g(obtained.)259
-1098 y Fc(BAD)m(V)-11 b(AL)34 b(=)e Fl(<)p Fc(Xt)m(yp)s(e)p
-Fl(>)f Fc(\(Giv)m(en\))427 1197 y Fj(This)i(argumen)n(t)e(should)h(ha)n
+(at)427 3371 y(appro)n(ximation)26 b(commence.)427 3493
+y(This)38 b(v)-5 b(alue)38 b(ma)n(y)g(o)r(ccasionally)e(b)r(e)j(useful)
+f(in)h(prev)n(en)n(ting)e(false)h(con)n(v)n(ergence)d(of)j(the)h
+(adaptiv)n(e)e(al-)427 3593 y(gorithm)c(in)g(cases)f(where)g(the)h
+(Mapping)g(app)r(ears)f(appro)n(ximately)f(linear)h(on)h(large)e
+(scales,)j(but)f(has)427 3693 y(irregularities)27 b(\(e.g.)40
+b(holes\))28 b(on)g(smaller)g(scales.)39 b(A)29 b(v)-5
+b(alue)28 b(of,)h(sa)n(y)-7 b(,)28 b(50)g(to)g(100)g(pixels)g(can)g
+(also)g(b)r(e)h(em-)427 3792 y(plo)n(y)n(ed)23 b(as)f(a)h(safeguard)f
+(in)i(general-purp)r(ose)d(soft)n(w)n(are,)i(since)g(the)h(e\013ect)f
+(on)h(p)r(erformance)e(is)h(minimal.)427 3915 y(If)e(to)r(o)f(small)g
+(a)g(v)-5 b(alue)20 b(is)g(giv)n(en,)h(it)g(will)f(ha)n(v)n(e)f(the)i
+(e\013ect)g(of)f(inhibiting)h(linear)f(appro)n(ximation)e(altogether)
+427 4015 y(\(equiv)-5 b(alen)n(t)21 b(to)f(setting)h(TOL)f(to)g
+(zero\).)34 b(Although)20 b(this)h(ma)n(y)f(degrade)f(p)r(erformance,)i
+(accurate)e(results)427 4114 y(will)28 b(still)g(b)r(e)g(obtained.)259
+4260 y Fc(BAD)m(V)-11 b(AL)34 b(=)e Fl(<)p Fc(Xt)m(yp)s(e)p
+Fl(>)f Fc(\(Giv)m(en\))427 4359 y Fj(This)i(argumen)n(t)e(should)h(ha)n
(v)n(e)g(the)g(same)g(t)n(yp)r(e)h(as)f(the)h(elemen)n(ts)f(of)g(the)h
(IN)g(arra)n(y)-7 b(.)49 b(It)33 b(sp)r(eci\014es)f(the)427
-1297 y(v)-5 b(alue)28 b(used)f(to)h(\015ag)f(missing)g(data)g(\(bad)h
+4459 y(v)-5 b(alue)28 b(used)f(to)h(\015ag)f(missing)g(data)g(\(bad)h
(pixels\))f(in)h(the)g(input)g(and)g(output)g(arra)n(ys.)427
-1413 y(If)33 b(the)f(AST)p Ft(__)p Fj(USEBAD)g(\015ag)f(is)h(set)g(via)
+4582 y(If)33 b(the)f(AST)p Ft(__)p Fj(USEBAD)g(\015ag)f(is)h(set)g(via)
f(the)i(FLA)n(GS)f(argumen)n(t,)g(then)h(this)f(v)-5
-b(alue)32 b(is)g(used)f(to)h(test)427 1513 y(for)27 b(bad)h(pixels)f
+b(alue)32 b(is)g(used)f(to)h(test)427 4681 y(for)27 b(bad)h(pixels)f
(in)h(the)g(IN)g(\(and)g(IN)p Ft(_)p Fj(V)-9 b(AR\))28
-b(arra)n(y\(s\).)427 1629 y(In)e(all)g(cases,)f(this)h(v)-5
+b(arra)n(y\(s\).)427 4804 y(In)e(all)g(cases,)f(this)h(v)-5
b(alue)26 b(is)g(also)f(used)h(to)g(\015ag)f(an)n(y)g(output)h(elemen)n
(ts)g(in)g(the)h(OUT)e(\(and)h(OUT)p Ft(_)p Fj(V)-9 b(AR\))427
-1728 y(arra)n(y\(s\))34 b(for)i(whic)n(h)g(rebined)g(v)-5
+4904 y(arra)n(y\(s\))34 b(for)i(whic)n(h)g(rebined)g(v)-5
b(alues)36 b(could)g(not)h(b)r(e)f(obtained)g(\(see)g(the)h
-Ft(")p Fj(Propagation)c(of)j(Missing)427 1828 y(Data)p
+Ft(")p Fj(Propagation)c(of)j(Missing)427 5003 y(Data)p
Ft(")27 b Fj(section)g(b)r(elo)n(w)h(for)f(details)g(of)h(the)g
(circumstances)e(under)i(whic)n(h)f(this)h(ma)n(y)f(o)r(ccur\).)259
-1960 y Fc(NDIM)p Ft(_)p Fc(OUT)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
-2060 y Fj(The)38 b(n)n(um)n(b)r(er)f(of)g(dimensions)g(in)h(the)f
+5149 y Fc(NDIM)p Ft(_)p Fc(OUT)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
+5248 y Fj(The)38 b(n)n(um)n(b)r(er)f(of)g(dimensions)g(in)h(the)f
(output)h(grid.)66 b(This)37 b(should)g(b)r(e)h(at)f(least)g(one.)65
-b(It)38 b(need)g(not)427 2160 y(necessarily)26 b(b)r(e)i(equal)f(to)h
+b(It)38 b(need)g(not)427 5348 y(necessarily)26 b(b)r(e)i(equal)f(to)h
(the)g(n)n(um)n(b)r(er)f(of)h(dimensions)f(in)h(the)g(input)g(grid.)259
-2292 y Fc(LBND)p Ft(_)p Fc(OUT\()33 b(NDIM)p Ft(_)p Fc(OUT)e(\))h(=)g
-(INTEGER)g(\(Giv)m(en\))427 2392 y Fj(An)f(arra)n(y)d(con)n(taining)h
+5494 y Fc(LBND)p Ft(_)p Fc(OUT\()33 b(NDIM)p Ft(_)p Fc(OUT)e(\))h(=)g
+(INTEGER)g(\(Giv)m(en\))427 5593 y Fj(An)f(arra)n(y)d(con)n(taining)h
(the)h(co)r(ordinates)f(of)h(the)h(cen)n(tre)e(of)h(the)h(\014rst)f
-(pixel)g(in)g(the)h(output)f(grid)g(along)427 2491 y(eac)n(h)d
-(dimension.)259 2624 y Fc(UBND)p Ft(_)p Fc(OUT\()33 b(NDIM)p
-Ft(_)p Fc(OUT)e(\))h(=)g(INTEGER)g(\(Giv)m(en\))427 2723
-y Fj(An)g(arra)n(y)c(con)n(taining)i(the)i(co)r(ordinates)d(of)i(the)h
-(cen)n(tre)e(of)h(the)h(last)e(pixel)h(in)h(the)f(output)h(grid)e
-(along)427 2823 y(eac)n(h)d(dimension.)427 2939 y(Note)41
-b(that)g(LBND)p Ft(_)p Fj(OUT)f(and)g(UBND)p Ft(_)p Fj(OUT)h(together)e
-(de\014ne)i(the)g(shap)r(e,)i(size)d(and)h(co)r(ordinate)427
-3039 y(system)24 b(of)f(the)h(output)h(grid)d(in)i(the)g(same)g(w)n(a)n
-(y)e(as)h(LBND)p Ft(_)p Fj(IN)h(and)f(UBND)p Ft(_)p Fj(IN)i(de\014ne)f
-(the)g(shap)r(e,)g(size)427 3138 y(and)k(co)r(ordinate)e(system)h(of)h
-(the)g(input)g(grid.)259 3271 y Fc(LBND\()k(NDIM)p Ft(_)p
-Fc(IN)f(\))h(=)g(INTEGER)g(\(Giv)m(en\))427 3370 y Fj(An)c(arra)n(y)c
-(con)n(taining)i(the)i(co)r(ordinates)d(of)i(the)g(\014rst)g(pixel)g
-(in)g(the)h(region)d(of)i(the)h(input)g(grid)e(whic)n(h)h(is)427
-3470 y(to)h(b)r(e)g(included)g(in)g(the)g(rebined)f(output)h(arra)n(y)
--7 b(.)259 3602 y Fc(UBND\()32 b(NDIM)p Ft(_)p Fc(IN)f(\))h(=)h
-(INTEGER)e(\(Giv)m(en\))427 3702 y Fj(An)e(arra)n(y)c(con)n(taining)i
-(the)h(co)r(ordinates)e(of)i(the)g(last)g(pixel)g(in)g(the)g(region)e
-(of)i(the)g(input)h(grid)e(whic)n(h)h(is)427 3801 y(to)g(b)r(e)g
-(included)g(in)g(the)g(rebined)f(output)h(arra)n(y)-7
-b(.)427 3917 y(Note)26 b(that)g(LBND)h(and)e(UBND)i(together)e
-(de\014ne)h(the)g(shap)r(e)g(and)g(p)r(osition)g(of)f(a)h(\(h)n(yp)r
-(er-\)rectangular)427 4017 y(region)19 b(of)i(the)f(input)h(grid)f
-(whic)n(h)g(is)g(to)h(b)r(e)f(included)h(in)g(the)f(rebined)h(output)f
-(arra)n(y)-7 b(.)33 b(This)20 b(region)f(should)427 4117
-y(lie)33 b(wholly)e(within)i(the)g(exten)n(t)f(of)g(the)h(input)g(grid)
-e(\(as)h(de\014ned)h(b)n(y)f(the)g(LBND)p Ft(_)p Fj(IN)h(and)f(UBND)p
-Ft(_)p Fj(IN)427 4216 y(arra)n(ys\).)j(Regions)26 b(of)i(the)g(input)g
-(grid)f(lying)h(outside)f(this)h(region)e(will)i(not)g(b)r(e)g(used.)
-259 4349 y Fc(OUT\()33 b Fi(\003)e Fc(\))h(=)g Fl(<)p
-Fc(Xt)m(yp)s(e)p Fl(>)f Fc(\(Returned\))427 4448 y Fj(An)24
-b(arra)n(y)-7 b(,)22 b(with)j(one)e(elemen)n(t)g(for)g(eac)n(h)g(pixel)
-h(in)g(the)f(output)i(grid,)e(in)h(whic)n(h)g(the)g(rebined)f(data)g(v)
--5 b(alues)427 4548 y(will)33 b(b)r(e)f(returned.)50
-b(The)32 b(n)n(umerical)f(t)n(yp)r(e)i(of)f(this)g(arra)n(y)e(should)i
-(matc)n(h)f(that)i(of)f(the)g(IN)h(arra)n(y)-7 b(,)31
-b(and)427 4648 y(the)f(data)e(storage)g(order)f(should)i(b)r(e)h(suc)n
-(h)f(that)g(the)h(index)f(of)g(the)g(\014rst)g(grid)g(dimension)g(v)-5
-b(aries)28 b(most)427 4747 y(rapidly)22 b(and)g(that)g(of)g(the)h
+(pixel)g(in)g(the)h(output)f(grid)g(along)427 5693 y(eac)n(h)d
+(dimension.)p eop end
+%%Page: 333 343
+TeXDict begin 333 342 bop 3643 52 a FG(333)259 351 y
+Fc(UBND)p Ft(_)p Fc(OUT\()33 b(NDIM)p Ft(_)p Fc(OUT)e(\))h(=)g(INTEGER)
+g(\(Giv)m(en\))427 451 y Fj(An)g(arra)n(y)c(con)n(taining)i(the)i(co)r
+(ordinates)d(of)i(the)h(cen)n(tre)e(of)h(the)h(last)e(pixel)h(in)h(the)
+f(output)h(grid)e(along)427 551 y(eac)n(h)d(dimension.)427
+669 y(Note)41 b(that)g(LBND)p Ft(_)p Fj(OUT)f(and)g(UBND)p
+Ft(_)p Fj(OUT)h(together)e(de\014ne)i(the)g(shap)r(e,)i(size)d(and)h
+(co)r(ordinate)427 769 y(system)24 b(of)f(the)h(output)h(grid)d(in)i
+(the)g(same)g(w)n(a)n(y)e(as)h(LBND)p Ft(_)p Fj(IN)h(and)f(UBND)p
+Ft(_)p Fj(IN)i(de\014ne)f(the)g(shap)r(e,)g(size)427
+868 y(and)k(co)r(ordinate)e(system)h(of)h(the)g(input)g(grid.)259
+1005 y Fc(LBND\()k(NDIM)p Ft(_)p Fc(IN)f(\))h(=)g(INTEGER)g(\(Giv)m
+(en\))427 1105 y Fj(An)c(arra)n(y)c(con)n(taining)i(the)i(co)r
+(ordinates)d(of)i(the)g(\014rst)g(pixel)g(in)g(the)h(region)d(of)i(the)
+h(input)g(grid)e(whic)n(h)h(is)427 1205 y(to)h(b)r(e)g(included)g(in)g
+(the)g(rebined)f(output)h(arra)n(y)-7 b(.)259 1342 y
+Fc(UBND\()32 b(NDIM)p Ft(_)p Fc(IN)f(\))h(=)h(INTEGER)e(\(Giv)m(en\))
+427 1441 y Fj(An)e(arra)n(y)c(con)n(taining)i(the)h(co)r(ordinates)e
+(of)i(the)g(last)g(pixel)g(in)g(the)g(region)e(of)i(the)g(input)h(grid)
+e(whic)n(h)h(is)427 1541 y(to)g(b)r(e)g(included)g(in)g(the)g(rebined)f
+(output)h(arra)n(y)-7 b(.)427 1659 y(Note)26 b(that)g(LBND)h(and)e
+(UBND)i(together)e(de\014ne)h(the)g(shap)r(e)g(and)g(p)r(osition)g(of)f
+(a)h(\(h)n(yp)r(er-\)rectangular)427 1759 y(region)19
+b(of)i(the)f(input)h(grid)f(whic)n(h)g(is)g(to)h(b)r(e)f(included)h(in)
+g(the)f(rebined)h(output)f(arra)n(y)-7 b(.)33 b(This)20
+b(region)f(should)427 1859 y(lie)33 b(wholly)e(within)i(the)g(exten)n
+(t)f(of)g(the)h(input)g(grid)e(\(as)h(de\014ned)h(b)n(y)f(the)g(LBND)p
+Ft(_)p Fj(IN)h(and)f(UBND)p Ft(_)p Fj(IN)427 1958 y(arra)n(ys\).)j
+(Regions)26 b(of)i(the)g(input)g(grid)f(lying)h(outside)f(this)h
+(region)e(will)i(not)g(b)r(e)g(used.)259 2095 y Fc(OUT\()33
+b Fi(\003)e Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p Fl(>)f
+Fc(\(Returned\))427 2195 y Fj(An)24 b(arra)n(y)-7 b(,)22
+b(with)j(one)e(elemen)n(t)g(for)g(eac)n(h)g(pixel)h(in)g(the)f(output)i
+(grid,)e(in)h(whic)n(h)g(the)g(rebined)f(data)g(v)-5
+b(alues)427 2295 y(will)33 b(b)r(e)f(returned.)50 b(The)32
+b(n)n(umerical)f(t)n(yp)r(e)i(of)f(this)g(arra)n(y)e(should)i(matc)n(h)
+f(that)i(of)f(the)g(IN)h(arra)n(y)-7 b(,)31 b(and)427
+2394 y(the)f(data)e(storage)g(order)f(should)i(b)r(e)h(suc)n(h)f(that)g
+(the)h(index)f(of)g(the)g(\014rst)g(grid)g(dimension)g(v)-5
+b(aries)28 b(most)427 2494 y(rapidly)22 b(and)g(that)g(of)g(the)h
(\014nal)f(dimension)g(least)g(rapidly)f(\(i.e.)36 b(normal)21
b(F)-7 b(ortran)21 b(arra)n(y)e(storage)i(order\).)259
-4880 y Fc(OUT)p Ft(_)p Fc(V)-11 b(AR\()33 b Fi(\003)e
+2631 y Fc(OUT)p Ft(_)p Fc(V)-11 b(AR\()33 b Fi(\003)e
Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p Fl(>)f Fc(\(Returned\))427
-4979 y Fj(An)25 b(optional)f(arra)n(y)d(with)k(the)g(same)f(t)n(yp)r(e)
+2731 y Fj(An)25 b(optional)f(arra)n(y)d(with)k(the)g(same)f(t)n(yp)r(e)
g(and)g(size)g(as)g(the)g(OUT)g(arra)n(y)-7 b(.)34 b(If)25
b(the)f(AST)p Ft(__)p Fj(USEV)-9 b(AR)24 b(\015ag)427
-5079 y(is)30 b(set)f(via)h(the)g(FLA)n(GS)g(argumen)n(t,)f(this)h(arra)
+2830 y(is)30 b(set)f(via)h(the)g(FLA)n(GS)g(argumen)n(t,)f(this)h(arra)
n(y)d(will)j(b)r(e)g(used)g(to)f(return)g(v)-5 b(ariance)29
-b(estimates)g(for)g(the)427 5178 y(rebined)f(data)f(v)-5
-b(alues.)427 5295 y(The)23 b(output)f(v)-5 b(ariance)22
+b(estimates)g(for)g(the)427 2930 y(rebined)f(data)f(v)-5
+b(alues.)427 3048 y(The)23 b(output)f(v)-5 b(ariance)22
b(v)-5 b(alues)21 b(will)i(b)r(e)g(calculated)e(on)h(the)h(assumption)f
-(that)g(errors)e(on)i(the)h(input)g(data)427 5394 y(v)-5
+(that)g(errors)e(on)i(the)h(input)g(data)427 3148 y(v)-5
b(alues)24 b(are)g(statistically)f(indep)r(enden)n(t)i(and)g(that)f
(their)g(v)-5 b(ariance)24 b(estimates)g(ma)n(y)f(simply)i(b)r(e)f
-(summed)427 5494 y(\(with)30 b(appropriate)d(w)n(eigh)n(ting)g
+(summed)427 3248 y(\(with)30 b(appropriate)d(w)n(eigh)n(ting)g
(factors\))h(when)h(sev)n(eral)e(input)i(pixels)g(con)n(tribute)f(to)h
-(an)f(output)h(data)427 5593 y(v)-5 b(alue.)59 b(If)35
+(an)f(output)h(data)427 3347 y(v)-5 b(alue.)59 b(If)35
b(this)g(assumption)f(is)h(not)g(v)-5 b(alid,)36 b(then)f(the)h(output)
f(error)e(estimates)h(ma)n(y)g(b)r(e)h(biased.)58 b(In)427
-5693 y(addition,)31 b(note)f(that)h(the)f(statistical)g(errors)e(on)i
+3447 y(addition,)31 b(note)f(that)h(the)f(statistical)g(errors)e(on)i
(neigh)n(b)r(ouring)f(output)h(data)g(v)-5 b(alues)30
-b(\(as)g(w)n(ell)g(as)f(the)p eop end
-%%Page: 331 341
-TeXDict begin 331 340 bop 3643 52 a FG(331)427 351 y
-Fj(estimates)32 b(of)f(those)g(errors\))f(ma)n(y)h(often)h(b)r(e)g
-(correlated,)f(ev)n(en)g(if)h(the)g(ab)r(o)n(v)n(e)f(assumption)g(ab)r
-(out)g(the)427 451 y(input)e(data)e(is)g(correct,)g(b)r(ecause)g(of)g
-(the)h(pixel)g(spreading)e(sc)n(hemes)h(emplo)n(y)n(ed.)427
-569 y(If)34 b(the)h(AST)p Ft(__)p Fj(USEV)-9 b(AR)33
-b(\015ag)g(is)h(not)f(set,)j(no)d(output)i(v)-5 b(ariance)32
-b(estimates)h(will)h(b)r(e)h(calculated)e(and)427 669
-y(this)28 b(arra)n(y)d(will)j(not)g(b)r(e)g(used.)37
-b(A)28 b(dumm)n(y)f(\(e.g.)37 b(one-elemen)n(t\))27 b(arra)n(y)f(ma)n
-(y)g(then)j(b)r(e)f(supplied.)259 806 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 906
-y Fj(The)c(global)e(status.)-2 1076 y Fc(Data)33 b(T)m(yp)s(e)g(Co)s
-(des)n(:)227 1222 y Fj(T)-7 b(o)39 b(select)g(the)h(appropriate)e
-(rebinning)h(function,)k(y)n(ou)38 b(should)h(replace)g
-Fl(<)p Fj(X)p Fl(>)f Fj(in)i(the)g(generic)e(function)227
-1322 y(name)c(AST)p Ft(_)p Fj(REBIN)p Fl(<)p Fj(X)p Fl(>)f
-Fj(with)i(a)f(1-)f(or)g(2-c)n(haracter)f(data)h(t)n(yp)r(e)i(co)r(de,)g
-(so)f(as)f(to)h(matc)n(h)g(the)g(n)n(umerical)227 1422
-y(t)n(yp)r(e)28 b Fl(<)p Fj(Xt)n(yp)r(e)p Fl(>)f Fj(of)h(the)g(data)f
-(y)n(ou)g(are)f(pro)r(cessing,)h(as)f(follo)n(ws:)340
-1567 y Fi(\017)45 b Fj(D:)28 b(DOUBLE)g(PRECISION)340
-1704 y Fi(\017)45 b Fj(R:)28 b(REAL)340 1841 y Fi(\017)45
-b Fj(I:)28 b(INTEGER)227 2012 y(F)-7 b(or)18 b(example,)i(AST)p
+b(\(as)g(w)n(ell)g(as)f(the)427 3547 y(estimates)j(of)f(those)g
+(errors\))f(ma)n(y)h(often)h(b)r(e)g(correlated,)f(ev)n(en)g(if)h(the)g
+(ab)r(o)n(v)n(e)f(assumption)g(ab)r(out)g(the)427 3646
+y(input)e(data)e(is)g(correct,)g(b)r(ecause)g(of)g(the)h(pixel)g
+(spreading)e(sc)n(hemes)h(emplo)n(y)n(ed.)427 3765 y(If)34
+b(the)h(AST)p Ft(__)p Fj(USEV)-9 b(AR)33 b(\015ag)g(is)h(not)f(set,)j
+(no)d(output)i(v)-5 b(ariance)32 b(estimates)h(will)h(b)r(e)h
+(calculated)e(and)427 3864 y(this)28 b(arra)n(y)d(will)j(not)g(b)r(e)g
+(used.)37 b(A)28 b(dumm)n(y)f(\(e.g.)37 b(one-elemen)n(t\))27
+b(arra)n(y)f(ma)n(y)g(then)j(b)r(e)f(supplied.)259 4001
+y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
+427 4101 y Fj(The)c(global)e(status.)-2 4272 y Fc(Data)33
+b(T)m(yp)s(e)g(Co)s(des)n(:)227 4418 y Fj(T)-7 b(o)39
+b(select)g(the)h(appropriate)e(rebinning)h(function,)k(y)n(ou)38
+b(should)h(replace)g Fl(<)p Fj(X)p Fl(>)f Fj(in)i(the)g(generic)e
+(function)227 4517 y(name)c(AST)p Ft(_)p Fj(REBIN)p Fl(<)p
+Fj(X)p Fl(>)f Fj(with)i(a)f(1-)f(or)g(2-c)n(haracter)f(data)h(t)n(yp)r
+(e)i(co)r(de,)g(so)f(as)f(to)h(matc)n(h)g(the)g(n)n(umerical)227
+4617 y(t)n(yp)r(e)28 b Fl(<)p Fj(Xt)n(yp)r(e)p Fl(>)f
+Fj(of)h(the)g(data)f(y)n(ou)g(are)f(pro)r(cessing,)h(as)f(follo)n(ws:)
+340 4762 y Fi(\017)45 b Fj(D:)28 b(DOUBLE)g(PRECISION)340
+4899 y Fi(\017)45 b Fj(R:)28 b(REAL)340 5036 y Fi(\017)45
+b Fj(I:)28 b(INTEGER)227 5207 y(F)-7 b(or)18 b(example,)i(AST)p
Ft(_)p Fj(REBIND)e(w)n(ould)g(b)r(e)h(used)f(to)h(pro)r(cess)e(DOUBLE)h
(PRECISION)f(data,)j(while)f(AST)p Ft(_)p Fj(REBINI)227
-2112 y(w)n(ould)27 b(b)r(e)h(used)g(to)f(pro)r(cess)g(in)n(teger)g
+5306 y(w)n(ould)27 b(b)r(e)h(used)g(to)f(pro)r(cess)g(in)n(teger)g
(data)g(\(stored)g(in)h(an)f(INTEGER)g(arra)n(y\),)f(etc.)227
-2240 y(Note)38 b(that,)i(unlik)n(e)d(AST)p Ft(_)p Fj(RESAMPLE)p
+5435 y(Note)38 b(that,)i(unlik)n(e)d(AST)p Ft(_)p Fj(RESAMPLE)p
Fl(<)p Fj(X)p Fl(>)p Fj(,)i(the)e(AST)p Ft(_)p Fj(REBIN)p
Fl(<)p Fj(X)p Fl(>)g Fj(set)g(of)h(functions)f(do)r(es)g(not)h(y)n(et)
-227 2340 y(supp)r(ort)28 b(unsigned)f(in)n(teger)g(data)g(t)n(yp)r(es)g
-(or)g(in)n(tegers)g(of)g(di\013eren)n(t)h(sizes.)-2 2498
-y Fc(Pixel)k(Spreading)f(Sc)m(hemes)n(:)227 2644 y Fj(The)c(pixel)g
+227 5535 y(supp)r(ort)28 b(unsigned)f(in)n(teger)g(data)g(t)n(yp)r(es)g
+(or)g(in)n(tegers)g(of)g(di\013eren)n(t)h(sizes.)-2 5693
+y Fc(Pixel)k(Spreading)f(Sc)m(hemes)n(:)p eop end
+%%Page: 334 344
+TeXDict begin 334 343 bop 0 52 a FG(334)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)227 351 y Fj(The)c(pixel)g
(spreading)f(sc)n(heme)g(sp)r(eci\014es)h(the)g(P)n(oin)n(t)f(Spread)g
(F)-7 b(unction)27 b(\(PSF\))g(applied)g(to)g(eac)n(h)f(input)i(pixel)
-227 2744 y(v)-5 b(alue)34 b(as)g(it)h(is)f(copied)g(in)n(to)g(the)h
+227 451 y(v)-5 b(alue)34 b(as)g(it)h(is)f(copied)g(in)n(to)g(the)h
(output)g(arra)n(y)-7 b(.)54 b(It)35 b(can)f(b)r(e)h(though)n(t)f(of)g
(as)f(the)i(in)n(v)n(erse)e(of)h(the)h(sub-pixel)227
-2844 y(in)n(terp)r(olation)30 b(sc)n(hemes)f(used)i(b)n(y)f(the)h(AST)p
+551 y(in)n(terp)r(olation)30 b(sc)n(hemes)f(used)i(b)n(y)f(the)h(AST)p
Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)e Fj(group)g(of)h(functions.)46
-b(That)30 b(is,)h(in)g(a)f(sub-)227 2943 y(pixel)22 b(in)n(terp)r
+b(That)30 b(is,)h(in)g(a)f(sub-)227 650 y(pixel)22 b(in)n(terp)r
(olation)e(sc)n(heme)h(the)h(k)n(ernel)e(sp)r(eci\014es)h(the)h(w)n
(eigh)n(t)e(to)i(assign)e(to)h(eac)n(h)f(input)i(pixel)g(when)f
-(forming)227 3043 y(the)26 b(w)n(eigh)n(ted)e(mean)h(of)h(the)f(input)h
+(forming)227 750 y(the)26 b(w)n(eigh)n(ted)e(mean)h(of)h(the)f(input)h
(pixels,)g(whereas)e(the)h(k)n(ernel)g(in)g(a)g(pixel)g(spreading)f(sc)
-n(heme)h(sp)r(eci\014es)g(the)227 3142 y(fraction)18
-b(of)h(the)f(input)i(data)e(v)-5 b(alue)18 b(whic)n(h)g(is)h(to)f(b)r
-(e)h(assigned)e(to)i(eac)n(h)e(output)i(pixel.)34 b(As)19
-b(for)f(in)n(terp)r(olation,)h(the)227 3242 y(c)n(hoice)g(of)g
-(suitable)h(pixel)f(spreading)f(sc)n(heme)h(in)n(v)n(olv)n(es)f(stric)n
-(king)g(a)h(balance)g(b)r(et)n(w)n(een)h(sc)n(hemes)e(whic)n(h)i(tend)g
-(to)227 3342 y(degrade)k(sharp)g(features)h(in)g(the)g(data)g(b)n(y)g
-(smo)r(othing)f(them,)i(and)f(those)g(whic)n(h)g(attempt)g(to)g
-(preserv)n(e)f(sharp)227 3441 y(features)34 b(but)h(whic)n(h)f(often)g
-(tend)h(to)f(in)n(tro)r(duce)g(un)n(w)n(an)n(ted)f(artifacts.)56
-b(See)35 b(the)f(AST)p Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p
-Fl(>)227 3541 y Fj(do)r(cumen)n(tation)28 b(for)f(further)g
-(discussion.)227 3670 y(The)d(binning)g(algorithm)f(used)h(has)f(the)h
-(abilit)n(y)g(to)g(in)n(tro)r(duce)f(artifacts)g(not)h(seen)g(when)g
-(using)f(a)h(resampling)227 3769 y(algorithm.)45 b(P)n(articularly)-7
-b(,)28 b(when)j(viewing)f(the)h(output)g(image)f(at)g(high)g(con)n
-(trast,)g(systems)g(of)g(curv)n(es)g(lines)227 3869 y(co)n(v)n(ering)d
-(the)i(en)n(tire)g(image)f(ma)n(y)g(b)r(e)i(visible.)40
-b(These)29 b(are)f(caused)g(b)n(y)h(a)f(b)r(eating)h(e\013ect)h(b)r(et)
-n(w)n(een)e(the)i(input)227 3969 y(pixel)38 b(p)r(ositions)g(and)f(the)
-i(output)f(pixels)g(p)r(osition,)i(and)e(their)f(nature)h(and)f
-(strength)h(dep)r(end)g(critically)227 4068 y(up)r(on)33
-b(the)g(nature)f(of)h(the)g(Mapping)f(and)g(the)h(spreading)f(function)
-h(b)r(eing)f(used.)52 b(In)33 b(general,)g(the)g(nearest)227
-4168 y(neigh)n(b)r(our)d(spreading)f(function)i(demonstrates)e(this)i
-(e\013ect)g(more)e(clearly)g(than)i(the)g(other)e(functions,)j(and)227
-4268 y(for)27 b(this)h(reason)e(should)i(b)r(e)g(used)f(with)h
-(caution.)227 4397 y(The)39 b(follo)n(wing)e(v)-5 b(alues)38
+n(heme)h(sp)r(eci\014es)g(the)227 849 y(fraction)18 b(of)h(the)f(input)
+i(data)e(v)-5 b(alue)18 b(whic)n(h)g(is)h(to)f(b)r(e)h(assigned)e(to)i
+(eac)n(h)e(output)i(pixel.)34 b(As)19 b(for)f(in)n(terp)r(olation,)h
+(the)227 949 y(c)n(hoice)g(of)g(suitable)h(pixel)f(spreading)f(sc)n
+(heme)h(in)n(v)n(olv)n(es)f(stric)n(king)g(a)h(balance)g(b)r(et)n(w)n
+(een)h(sc)n(hemes)e(whic)n(h)i(tend)g(to)227 1049 y(degrade)k(sharp)g
+(features)h(in)g(the)g(data)g(b)n(y)g(smo)r(othing)f(them,)i(and)f
+(those)g(whic)n(h)g(attempt)g(to)g(preserv)n(e)f(sharp)227
+1148 y(features)34 b(but)h(whic)n(h)f(often)g(tend)h(to)f(in)n(tro)r
+(duce)g(un)n(w)n(an)n(ted)f(artifacts.)56 b(See)35 b(the)f(AST)p
+Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)227 1248 y Fj(do)r(cumen)n
+(tation)28 b(for)f(further)g(discussion.)227 1370 y(The)d(binning)g
+(algorithm)f(used)h(has)f(the)h(abilit)n(y)g(to)g(in)n(tro)r(duce)f
+(artifacts)g(not)h(seen)g(when)g(using)f(a)h(resampling)227
+1469 y(algorithm.)45 b(P)n(articularly)-7 b(,)28 b(when)j(viewing)f
+(the)h(output)g(image)f(at)g(high)g(con)n(trast,)g(systems)g(of)g(curv)
+n(es)g(lines)227 1569 y(co)n(v)n(ering)d(the)i(en)n(tire)g(image)f(ma)n
+(y)g(b)r(e)i(visible.)40 b(These)29 b(are)f(caused)g(b)n(y)h(a)f(b)r
+(eating)h(e\013ect)h(b)r(et)n(w)n(een)e(the)i(input)227
+1669 y(pixel)38 b(p)r(ositions)g(and)f(the)i(output)f(pixels)g(p)r
+(osition,)i(and)e(their)f(nature)h(and)f(strength)h(dep)r(end)g
+(critically)227 1768 y(up)r(on)33 b(the)g(nature)f(of)h(the)g(Mapping)f
+(and)g(the)h(spreading)f(function)h(b)r(eing)f(used.)52
+b(In)33 b(general,)g(the)g(nearest)227 1868 y(neigh)n(b)r(our)d
+(spreading)f(function)i(demonstrates)e(this)i(e\013ect)g(more)e
+(clearly)g(than)i(the)g(other)e(functions,)j(and)227
+1967 y(for)27 b(this)h(reason)e(should)i(b)r(e)g(used)f(with)h
+(caution.)227 2089 y(The)39 b(follo)n(wing)e(v)-5 b(alues)38
b(\(de\014ned)h(in)f(the)h(AST)p Ft(_)p Fj(P)-7 b(AR)38
b(include)h(\014le\))f(ma)n(y)g(b)r(e)h(assigned)e(to)h(the)h(SPREAD)
-227 4496 y(parameter.)i(See)29 b(the)h(AST)p Ft(_)p Fj(RESAMPLE)p
+227 2189 y(parameter.)i(See)29 b(the)h(AST)p Ft(_)p Fj(RESAMPLE)p
Fl(<)p Fj(X)p Fl(>)d Fj(do)r(cumen)n(tation)i(for)g(details)g(of)h
-(these)f(sc)n(hemes)f(including)227 4596 y(the)g(use)g(of)f(the)h
+(these)f(sc)n(hemes)f(including)227 2289 y(the)g(use)g(of)f(the)h
(FSPREAD)g(and)f(P)-7 b(ARAMS)29 b(argumen)n(ts:)340
-4870 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(NEAREST)340 5007
-y Fi(\017)g Fj(AST)p Ft(__)p Fj(LINEAR)340 5144 y Fi(\017)g
-Fj(AST)p Ft(__)p Fj(SINC)340 5281 y Fi(\017)g Fj(AST)p
-Ft(__)p Fj(SINCSINC)340 5419 y Fi(\017)g Fj(AST)p Ft(__)p
-Fj(SINCCOS)340 5556 y Fi(\017)g Fj(AST)p Ft(__)p Fj(SINCGA)n(USS)340
-5693 y Fi(\017)g Fj(AST)p Ft(__)p Fj(SOMBCOS)p eop end
-%%Page: 332 342
-TeXDict begin 332 341 bop 0 52 a FG(332)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)227 351 y Fj(In)19
-b(addition,)h(the)f(follo)n(wing)e(sc)n(hemes)h(can)g(b)r(e)g(used)h
-(with)g(AST)p Ft(_)p Fj(REBIN)p Fl(<)p Fj(X)p Fl(>)e
-Fj(but)i(not)g(with)f(AST)p Ft(_)p Fj(RESAMPLE)p Fl(<)p
-Fj(X)p Fl(>)p Fj(:)340 601 y Fi(\017)45 b Fj(AST)p Ft(__)p
-Fj(GA)n(USS:)24 b(This)f(sc)n(heme)g(uses)g(a)g(k)n(ernel)f(of)h(the)h
-(form)f(exp\(-k)p Fi(\003)p Fj(x)p Fi(\003)p Fj(x\),)g(with)g(k)h(a)e
-(p)r(ositiv)n(e)h(constan)n(t)427 701 y(determined)k(b)n(y)f(the)g
-(full-width)i(at)e(half-maxim)n(um)g(\(FWHM\).)h(The)g(FWHM)g(should)f
-(b)r(e)h(supplied)f(in)427 801 y(units)33 b(of)g(output)g(pixels)f(b)n
+2541 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(NEAREST)340 2669
+y Fi(\017)g Fj(AST)p Ft(__)p Fj(LINEAR)340 2796 y Fi(\017)g
+Fj(AST)p Ft(__)p Fj(SINC)340 2924 y Fi(\017)g Fj(AST)p
+Ft(__)p Fj(SINCSINC)340 3051 y Fi(\017)g Fj(AST)p Ft(__)p
+Fj(SINCCOS)340 3178 y Fi(\017)g Fj(AST)p Ft(__)p Fj(SINCGA)n(USS)340
+3306 y Fi(\017)g Fj(AST)p Ft(__)p Fj(SOMBCOS)227 3462
+y(In)19 b(addition,)h(the)f(follo)n(wing)e(sc)n(hemes)h(can)g(b)r(e)g
+(used)h(with)g(AST)p Ft(_)p Fj(REBIN)p Fl(<)p Fj(X)p
+Fl(>)e Fj(but)i(not)g(with)f(AST)p Ft(_)p Fj(RESAMPLE)p
+Fl(<)p Fj(X)p Fl(>)p Fj(:)340 3715 y Fi(\017)45 b Fj(AST)p
+Ft(__)p Fj(GA)n(USS:)24 b(This)f(sc)n(heme)g(uses)g(a)g(k)n(ernel)f(of)
+h(the)h(form)f(exp\(-k)p Fi(\003)p Fj(x)p Fi(\003)p Fj(x\),)g(with)g(k)
+h(a)e(p)r(ositiv)n(e)h(constan)n(t)427 3815 y(determined)k(b)n(y)f(the)
+g(full-width)i(at)e(half-maxim)n(um)g(\(FWHM\).)h(The)g(FWHM)g(should)f
+(b)r(e)h(supplied)f(in)427 3914 y(units)33 b(of)g(output)g(pixels)f(b)n
(y)g(means)g(of)h(the)g(P)-7 b(ARAMS\(2\))33 b(v)-5 b(alue)32
b(and)h(should)f(b)r(e)h(at)g(least)f(0.1.)51 b(The)427
-900 y(P)-7 b(ARAMS\(1\))25 b(v)-5 b(alue)24 b(should)f(b)r(e)i(used)e
+4014 y(P)-7 b(ARAMS\(1\))25 b(v)-5 b(alue)24 b(should)f(b)r(e)i(used)e
(to)h(sp)r(ecify)g(at)g(what)g(p)r(oin)n(t)g(the)g(Gaussian)f(is)h
-(truncated)g(to)g(zero.)427 1000 y(This)k(should)g(b)r(e)g(giv)n(en)f
+(truncated)g(to)g(zero.)427 4114 y(This)k(should)g(b)r(e)g(giv)n(en)f
(as)g(a)h(n)n(um)n(b)r(er)g(of)f(output)i(pixels)f(on)f(either)h(side)g
-(of)g(the)g(cen)n(tral)f(output)h(p)r(oin)n(t)427 1100
+(of)g(the)g(cen)n(tral)f(output)h(p)r(oin)n(t)427 4213
y(in)g(eac)n(h)f(dimension)g(\(the)i(nearest)d(in)n(teger)h(v)-5
-b(alue)28 b(is)f(used\).)-2 1254 y Fc(Con)m(trol)32 b(Flags)n(:)227
-1400 y Fj(The)24 b(follo)n(wing)f(\015ags)g(are)g(de\014ned)h(in)g(the)
+b(alue)28 b(is)f(used\).)-2 4370 y Fc(Con)m(trol)32 b(Flags)n(:)227
+4516 y Fj(The)24 b(follo)n(wing)f(\015ags)g(are)g(de\014ned)h(in)g(the)
g(AST)p Ft(_)p Fj(P)-7 b(AR)24 b(include)g(\014le)g(and)g(ma)n(y)f(b)r
-(e)h(used)g(to)g(pro)n(vide)e(additional)227 1500 y(con)n(trol)32
+(e)h(used)g(to)g(pro)n(vide)e(additional)227 4615 y(con)n(trol)32
b(o)n(v)n(er)e(the)j(rebinning)f(pro)r(cess.)51 b(Ha)n(ving)32
b(selected)g(a)g(set)h(of)f(\015ags,)h(y)n(ou)f(should)g(supply)h(the)g
-(sum)g(of)227 1600 y(their)28 b(v)-5 b(alues)27 b(via)g(the)h(FLA)n(GS)
-g(argumen)n(t:)340 1850 y Fi(\017)45 b Fj(AST)p Ft(__)p
+(sum)g(of)227 4715 y(their)28 b(v)-5 b(alues)27 b(via)g(the)h(FLA)n(GS)
+g(argumen)n(t:)340 4968 y Fi(\017)45 b Fj(AST)p Ft(__)p
Fj(USEBAD:)33 b(Indicates)g(that)h(there)f(ma)n(y)f(b)r(e)i(bad)f
(pixels)f(in)i(the)f(input)h(arra)n(y\(s\))d(whic)n(h)i(m)n(ust)427
-1949 y(b)r(e)26 b(recognised)d(b)n(y)i(comparing)e(with)j(the)f(v)-5
+5067 y(b)r(e)26 b(recognised)d(b)n(y)i(comparing)e(with)j(the)f(v)-5
b(alue)25 b(giv)n(en)g(for)f(BAD)n(V)-9 b(AL)26 b(and)e(propagated)g
-(to)h(the)g(output)427 2049 y(arra)n(y\(s\).)41 b(If)30
+(to)h(the)g(output)427 5167 y(arra)n(y\(s\).)41 b(If)30
b(this)g(\015ag)f(is)g(not)h(set,)g(all)f(input)h(v)-5
b(alues)30 b(are)e(treated)h(literally)g(and)h(the)g(BAD)n(V)-9
-b(AL)30 b(v)-5 b(alue)427 2149 y(is)28 b(only)f(used)h(for)f
-(\015agging)f(output)i(arra)n(y)d(v)-5 b(alues.)340 2274
+b(AL)30 b(v)-5 b(alue)427 5267 y(is)28 b(only)f(used)h(for)f
+(\015agging)f(output)i(arra)n(y)d(v)-5 b(alues.)340 5394
y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(USEV)-9 b(AR:)25 b(Indicates)f(that)
g(v)-5 b(ariance)23 b(information)h(should)g(b)r(e)h(pro)r(cessed)e(in)
-i(order)e(to)h(pro)n(vide)427 2374 y(estimates)34 b(of)g(the)g
+i(order)e(to)h(pro)n(vide)427 5494 y(estimates)34 b(of)g(the)g
(statistical)f(error)f(asso)r(ciated)h(with)h(the)g(rebined)g(v)-5
b(alues.)55 b(If)35 b(this)f(\015ag)f(is)h(not)g(set,)427
-2473 y(no)c(v)-5 b(ariance)29 b(pro)r(cessing)g(will)i(o)r(ccur)e(and)i
+5593 y(no)c(v)-5 b(ariance)29 b(pro)r(cessing)g(will)i(o)r(ccur)e(and)i
(the)f(IN)p Ft(_)p Fj(V)-9 b(AR)31 b(and)f(OUT)p Ft(_)p
Fj(V)-9 b(AR)30 b(arra)n(ys)e(will)j(not)f(b)r(e)h(used.)427
-2573 y(\(Note)d(that)g(this)g(\015ag)f(is)g(only)g(a)n(v)-5
+5693 y(\(Note)d(that)g(this)g(\015ag)f(is)g(only)g(a)n(v)-5
b(ailable)27 b(in)h(the)g(F)-7 b(ortran)26 b(in)n(terface)h(to)g
-(AST.\))-2 2728 y Fc(Propagation)33 b(of)e(Missing)f(Data)n(:)227
-2874 y Fj(Instances)40 b(of)h(missing)f(data)g(\(bad)h(pixels\))g(in)f
-(the)h(output)h(grid)e(are)f(iden)n(ti\014ed)i(b)n(y)g(o)r(ccurrences)e
-(of)h(the)227 2974 y(BAD)n(V)-9 b(AL)23 b(v)-5 b(alue)22
-b(in)g(the)h(OUT)f(arra)n(y)-7 b(.)33 b(These)22 b(are)f(pro)r(duced)h
-(if)h(the)f(sum)h(of)f(the)g(w)n(eigh)n(ts)f(of)i(the)f(con)n
-(tributing)227 3073 y(input)29 b(pixels)e(is)h(less)f(than)g(WLIM.)227
-3194 y(An)22 b(input)h(pixel)e(is)h(considered)e(bad)i(\(and)f(is)h
-(consequen)n(tly)e(ignored\))h(if)h(its)g(data)f(v)-5
-b(alue)21 b(is)h(equal)f(to)g(BAD)n(V)-9 b(AL)227 3294
-y(and)28 b(the)g(AST)p Ft(__)p Fj(USEBAD)f(\015ag)g(is)h(set)f(via)g
-(the)h(FLA)n(GS)g(argumen)n(t.)227 3415 y(In)h(addition,)f(asso)r
-(ciated)f(output)i(v)-5 b(ariance)27 b(estimates)h(\(if)i(calculated\))
-e(ma)n(y)f(b)r(e)i(declared)e(bad)i(and)f(\015agged)227
-3514 y(with)g(the)g(BAD)n(V)-9 b(AL)28 b(v)-5 b(alue)28
+(AST.\))p eop end
+%%Page: 335 345
+TeXDict begin 335 344 bop 3643 52 a FG(335)-2 351 y Fc(Propagation)33
+b(of)e(Missing)f(Data)n(:)227 497 y Fj(Instances)40 b(of)h(missing)f
+(data)g(\(bad)h(pixels\))g(in)f(the)h(output)h(grid)e(are)f(iden)n
+(ti\014ed)i(b)n(y)g(o)r(ccurrences)e(of)h(the)227 597
+y(BAD)n(V)-9 b(AL)23 b(v)-5 b(alue)22 b(in)g(the)h(OUT)f(arra)n(y)-7
+b(.)33 b(These)22 b(are)f(pro)r(duced)h(if)h(the)f(sum)h(of)f(the)g(w)n
+(eigh)n(ts)f(of)i(the)f(con)n(tributing)227 697 y(input)29
+b(pixels)e(is)h(less)f(than)g(WLIM.)227 814 y(An)22 b(input)h(pixel)e
+(is)h(considered)e(bad)i(\(and)f(is)h(consequen)n(tly)e(ignored\))h(if)
+h(its)g(data)f(v)-5 b(alue)21 b(is)h(equal)f(to)g(BAD)n(V)-9
+b(AL)227 914 y(and)28 b(the)g(AST)p Ft(__)p Fj(USEBAD)f(\015ag)g(is)h
+(set)f(via)g(the)h(FLA)n(GS)g(argumen)n(t.)227 1032 y(In)h(addition,)f
+(asso)r(ciated)f(output)i(v)-5 b(ariance)27 b(estimates)h(\(if)i
+(calculated\))e(ma)n(y)f(b)r(e)i(declared)e(bad)i(and)f(\015agged)227
+1132 y(with)g(the)g(BAD)n(V)-9 b(AL)28 b(v)-5 b(alue)28
b(in)g(the)g(OUT)p Ft(_)p Fj(V)-9 b(AR)27 b(arra)n(y)e(for)j(similar)e
-(reasons.)p 0 3699 3780 12 v 0 3830 a FA(AST)p Fe(_)p
-FA(REBINSEQ)p Fb(<)p FA(X)p Fb(>)1515 3831 y Fd(Rebin)39
-b(a)f(region)1485 3945 y(of)g(a)g(sequence)i(of)1633
-4060 y(data)d(grids)2461 3830 y FA(AST)p Fe(_)p FA(REBINSEQ)p
-Fb(<)p FA(X)p Fb(>)0 4234 y Fc(Description:)44 b Fj(This)25
+(reasons.)p 0 1304 3780 12 v 0 1435 a FA(AST)p Fe(_)p
+FA(REBINSEQ)p Fb(<)p FA(X)p Fb(>)1515 1436 y Fd(Rebin)39
+b(a)f(region)1485 1551 y(of)g(a)g(sequence)i(of)1633
+1665 y(data)d(grids)2461 1435 y FA(AST)p Fe(_)p FA(REBINSEQ)p
+Fb(<)p FA(X)p Fb(>)0 1827 y Fc(Description:)44 b Fj(This)25
b(set)h(of)f(routines)f(is)h(iden)n(tical)g(to)g(AST)p
Ft(_)p Fj(REBIN)p Fl(<)p Fj(X)p Fl(>)f Fj(except)h(that)h(the)f
-(rebinned)g(input)h(data)227 4334 y(is)c(added)g(in)n(to)f(the)h
+(rebinned)g(input)h(data)227 1927 y(is)c(added)g(in)n(to)f(the)h
(supplied)g(output)h(arra)n(ys,)d(rather)h(than)h(simply)g(o)n(v)n
(er-writing)d(the)j(con)n(ten)n(ts)f(of)h(the)g(output)227
-4434 y(arra)n(ys.)46 b(Th)n(us,)33 b(b)n(y)e(calling)g(this)g(routine)g
+2027 y(arra)n(ys.)46 b(Th)n(us,)33 b(b)n(y)e(calling)g(this)g(routine)g
(rep)r(eatedly)-7 b(,)33 b(a)e(sequence)g(of)g(input)h(arra)n(ys)d(can)
-i(b)r(e)h(rebinned)g(and)227 4533 y(accum)n(ulated)27
+i(b)r(e)h(rebinned)g(and)227 2126 y(accum)n(ulated)27
b(in)n(to)h(a)f(single)g(output)h(arra)n(y)-7 b(,)25
b(e\013ectiv)n(ely)j(forming)f(a)g(mosaic)g(of)g(the)h(input)g(data)g
-(arra)n(ys.)227 4654 y(In)h(addition,)g(the)g(w)n(eigh)n(ts)f(asso)r
+(arra)n(ys.)227 2244 y(In)h(addition,)g(the)g(w)n(eigh)n(ts)f(asso)r
(ciated)f(with)j(eac)n(h)e(output)h(pixel)g(are)e(returned.)40
-b(The)29 b(w)n(eigh)n(t)f(of)h(an)f(output)227 4754 y(pixel)23
+b(The)29 b(w)n(eigh)n(t)f(of)h(an)f(output)227 2344 y(pixel)23
b(indicates)f(the)h(n)n(um)n(b)r(er)g(of)f(input)i(pixels)e(whic)n(h)h
(ha)n(v)n(e)e(b)r(een)i(accum)n(ulated)f(in)h(that)g(output)g(pixel.)35
-b(If)23 b(the)227 4853 y(en)n(tire)30 b(v)-5 b(alue)30
+b(If)23 b(the)227 2443 y(en)n(tire)30 b(v)-5 b(alue)30
b(of)h(an)f(input)h(pixel)f(is)g(assigned)f(to)i(a)e(single)h(output)h
(pixel,)g(then)g(the)g(w)n(eigh)n(t)e(of)h(that)h(output)227
-4953 y(pixel)25 b(is)f(incremen)n(ted)h(b)n(y)f(one.)36
+2543 y(pixel)25 b(is)f(incremen)n(ted)h(b)n(y)f(one.)36
b(If)25 b(some)f(fraction)g(of)g(the)h(v)-5 b(alue)25
b(of)f(an)g(input)i(pixel)e(is)h(assigned)e(to)i(an)f(output)227
-5053 y(pixel,)k(then)g(the)g(w)n(eigh)n(t)f(of)h(that)f(output)i(pixel)
+2643 y(pixel,)k(then)g(the)g(w)n(eigh)n(t)f(of)h(that)f(output)i(pixel)
e(is)h(incremen)n(ted)f(b)n(y)g(the)h(fraction)f(used.)227
-5174 y(The)f(start)f(of)g(a)h(new)f(sequence)g(is)h(indicated)g(b)n(y)f
+2760 y(The)f(start)f(of)g(a)h(new)f(sequence)g(is)h(indicated)g(b)n(y)f
(sp)r(ecifying)g(the)h(AST)p Ft(__)p Fj(REBININIT)f(\015ag)g(via)g(the)
-h(FLA)n(GS)227 5273 y(argumen)n(t.)81 b(This)43 b(causes)f(the)h
+h(FLA)n(GS)227 2860 y(argumen)n(t.)81 b(This)43 b(causes)f(the)h
(supplied)g(arra)n(ys)d(to)i(b)r(e)h(\014lled)g(with)g(zeros)f(b)r
-(efore)g(the)h(rebinned)g(input)227 5373 y(data)d(is)g(added)f(in)n(to)
+(efore)g(the)h(rebinned)g(input)227 2960 y(data)d(is)g(added)f(in)n(to)
h(them.)74 b(Subsequenct)41 b(in)n(v)n(o)r(cations)d(within)i(the)h
-(same)e(sequence)g(should)h(omit)g(the)227 5472 y(AST)p
-Ft(__)p Fj(REBININIT)27 b(\015ag.)227 5593 y(The)k(last)f(call)g(in)h
+(same)e(sequence)g(should)h(omit)g(the)227 3059 y(AST)p
+Ft(__)p Fj(REBININIT)27 b(\015ag.)227 3177 y(The)k(last)f(call)g(in)h
(a)f(sequence)g(is)h(indicated)g(b)n(y)f(sp)r(ecifying)h(the)g(AST)p
Ft(__)p Fj(REBINEND)f(\015ag.)45 b(Dep)r(ending)31 b(on)227
-5693 y(whic)n(h)36 b(\015ags)f(are)f(supplied,)k(this)e(ma)n(y)f(cause)
+3277 y(whic)n(h)36 b(\015ags)f(are)f(supplied,)k(this)e(ma)n(y)f(cause)
g(the)h(output)h(data)e(and)g(v)-5 b(ariance)35 b(arra)n(ys)e(to)j(b)r
-(e)g(normalised)p eop end
-%%Page: 333 343
-TeXDict begin 333 342 bop 3643 52 a FG(333)227 351 y
-Fj(b)r(efore)25 b(b)r(eing)h(returned.)35 b(This)25 b(normalisation)f
-(consists)g(of)i(dividing)f(the)g(data)g(arra)n(y)e(b)n(y)i(the)h(w)n
-(eigh)n(ts)e(arra)n(y)-7 b(,)227 451 y(and)32 b(can)f(eliminate)g
-(artifacts)g(whic)n(h)h(ma)n(y)e(b)r(e)i(in)n(tro)r(duced)g(in)n(to)f
-(the)h(rebinned)f(data)g(as)g(a)g(consequence)g(of)227
-551 y(aliasing)j(b)r(et)n(w)n(een)i(the)g(input)g(and)f(output)h
-(grids.)60 b(This)35 b(results)g(in)h(eac)n(h)f(output)h(pixel)f(v)-5
-b(alue)36 b(b)r(eing)f(the)227 650 y(w)n(eigh)n(ted)26
-b(mean)h(of)f(the)i(input)f(pixel)g(v)-5 b(alues)26 b(that)h(fall)g(in)
-g(the)g(neigh)n(b)r(ourho)r(o)r(d)f(of)g(the)h(output)h(pixel)e
-(\(rather)227 750 y(lik)n(e)37 b(AST)p Ft(_)p Fj(RESAMPLE)p
-Fl(<)p Fj(X)p Fl(>)p Fj(\).)63 b(Optionally)-7 b(,)39
-b(these)e(normalised)e(v)-5 b(alues)37 b(can)f(then)i(b)r(e)f(m)n
-(ultiplied)g(b)n(y)g(a)227 849 y(scaling)23 b(factor)h(to)g(ensure)f
-(that)i(the)f(total)g(data)g(sum)g(in)g(an)n(y)g(small)g(area)e(is)i
-(unc)n(hanged.)35 b(This)24 b(scaling)f(factor)227 949
-y(is)32 b(equiv)-5 b(alen)n(t)31 b(to)h(the)g(n)n(um)n(b)r(er)f(of)h
-(input)h(pixel)e(v)-5 b(alues)32 b(that)g(fall)f(in)n(to)h(eac)n(h)f
-(output)h(pixel.)49 b(In)32 b(addition)g(to)227 1049
-y(normalisation)d(of)i(the)g(output)g(data)g(v)-5 b(alues,)31
-b(an)n(y)f(output)h(v)-5 b(ariances)29 b(are)h(also)g(appropriately)f
-(normalised,)227 1148 y(and)f(an)n(y)f(output)h(data)f(v)-5
-b(alues)27 b(with)h(w)n(eigh)n(t)f(less)g(than)h(WLIM)g(are)e(set)i(to)
-f(BAD)n(V)-9 b(AL.)227 1279 y(Output)34 b(v)-5 b(ariances)32
-b(can)h(b)r(e)g(generated)f(in)i(t)n(w)n(o)e(w)n(a)n(ys;)j(b)n(y)d
-(rebinning)h(the)h(supplied)f(input)h(v)-5 b(ariances)32
-b(with)227 1379 y(appropriate)21 b(w)n(eigh)n(ts,)i(or)f(b)n(y)g
-(\014nding)h(the)g(spread)f(of)g(input)i(data)e(v)-5
+(e)g(normalised)227 3377 y(b)r(efore)25 b(b)r(eing)h(returned.)35
+b(This)25 b(normalisation)f(consists)g(of)i(dividing)f(the)g(data)g
+(arra)n(y)e(b)n(y)i(the)h(w)n(eigh)n(ts)e(arra)n(y)-7
+b(,)227 3476 y(and)32 b(can)f(eliminate)g(artifacts)g(whic)n(h)h(ma)n
+(y)e(b)r(e)i(in)n(tro)r(duced)g(in)n(to)f(the)h(rebinned)f(data)g(as)g
+(a)g(consequence)g(of)227 3576 y(aliasing)j(b)r(et)n(w)n(een)i(the)g
+(input)g(and)f(output)h(grids.)60 b(This)35 b(results)g(in)h(eac)n(h)f
+(output)h(pixel)f(v)-5 b(alue)36 b(b)r(eing)f(the)227
+3675 y(w)n(eigh)n(ted)26 b(mean)h(of)f(the)i(input)f(pixel)g(v)-5
+b(alues)26 b(that)h(fall)g(in)g(the)g(neigh)n(b)r(ourho)r(o)r(d)f(of)g
+(the)h(output)h(pixel)e(\(rather)227 3775 y(lik)n(e)37
+b(AST)p Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p Fj(\).)63
+b(Optionally)-7 b(,)39 b(these)e(normalised)e(v)-5 b(alues)37
+b(can)f(then)i(b)r(e)f(m)n(ultiplied)g(b)n(y)g(a)227
+3875 y(scaling)23 b(factor)h(to)g(ensure)f(that)i(the)f(total)g(data)g
+(sum)g(in)g(an)n(y)g(small)g(area)e(is)i(unc)n(hanged.)35
+b(This)24 b(scaling)f(factor)227 3974 y(is)32 b(equiv)-5
+b(alen)n(t)31 b(to)h(the)g(n)n(um)n(b)r(er)f(of)h(input)h(pixel)e(v)-5
+b(alues)32 b(that)g(fall)f(in)n(to)h(eac)n(h)f(output)h(pixel.)49
+b(In)32 b(addition)g(to)227 4074 y(normalisation)d(of)i(the)g(output)g
+(data)g(v)-5 b(alues,)31 b(an)n(y)f(output)h(v)-5 b(ariances)29
+b(are)h(also)g(appropriately)f(normalised,)227 4174 y(and)f(an)n(y)f
+(output)h(data)f(v)-5 b(alues)27 b(with)h(w)n(eigh)n(t)f(less)g(than)h
+(WLIM)g(are)e(set)i(to)f(BAD)n(V)-9 b(AL.)227 4291 y(Output)34
+b(v)-5 b(ariances)32 b(can)h(b)r(e)g(generated)f(in)i(t)n(w)n(o)e(w)n
+(a)n(ys;)j(b)n(y)d(rebinning)h(the)h(supplied)f(input)h(v)-5
+b(ariances)32 b(with)227 4391 y(appropriate)21 b(w)n(eigh)n(ts,)i(or)f
+(b)n(y)g(\014nding)h(the)g(spread)f(of)g(input)i(data)e(v)-5
b(alues)22 b(con)n(tributing)g(to)h(eac)n(h)e(output)j(pixel)227
-1478 y(\(see)k(the)g(AST)p Ft(__)p Fj(GENV)-9 b(AR)27
+4491 y(\(see)k(the)g(AST)p Ft(__)p Fj(GENV)-9 b(AR)27
b(and)h(AST)p Ft(__)p Fj(USEV)-9 b(AR)27 b(\015ags\).)0
-1640 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_REBINSEQ)p
+4627 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_REBINSEQ)p
Fl(<)p Ft(X)p Fl(>)o Ft(\()c(THIS,)j(WLIM,)h(NDIM_IN,)e(LBND_IN,)g
-(UBND_IN,)g(IN,)j(IN_VAR,)e(SPREAD,)227 1740 y(PARAMS,)g(FLAGS,)g(TOL,)
+(UBND_IN,)g(IN,)j(IN_VAR,)e(SPREAD,)227 4726 y(PARAMS,)g(FLAGS,)g(TOL,)
h(MAXPIX,)f(BADVAL,)f(NDIM_OUT,)g(LBND_OUT,)g(UBND_OUT,)g(LBND,)h
-(UBND,)h(OUT,)227 1839 y(OUT_VAR,)f(WEIGHTS,)f(NUSED,)h(STATUS)g(\))0
-2001 y Fc(Argumen)m(ts:)259 2150 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 2249 y Fj(P)n(oin)n(ter)19 b(to)h(a)f(Mapping,)j(whose)d
+(UBND,)h(OUT,)227 4826 y(OUT_VAR,)f(WEIGHTS,)f(NUSED,)h(STATUS)g(\))0
+4962 y Fc(Argumen)m(ts:)259 5085 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 5185 y Fj(P)n(oin)n(ter)19 b(to)h(a)f(Mapping,)j(whose)d
(forw)n(ard)f(transformation)h(will)h(b)r(e)h(used)f(to)g(transform)f
-(the)h(co)r(ordinates)427 2349 y(of)28 b(pixels)f(in)h(the)g(input)g
+(the)h(co)r(ordinates)427 5285 y(of)28 b(pixels)f(in)h(the)g(input)g
(grid)f(in)n(to)h(the)g(co)r(ordinate)e(system)h(of)h(the)g(output)g
-(grid.)427 2468 y(The)c(n)n(um)n(b)r(er)g(of)g(input)h(co)r(ordinates)e
+(grid.)427 5394 y(The)c(n)n(um)n(b)r(er)g(of)g(input)h(co)r(ordinates)e
(used)h(b)n(y)g(this)g(Mapping)g(\(as)f(giv)n(en)h(b)n(y)f(its)i(Nin)f
-(attribute\))h(should)427 2568 y(matc)n(h)f(the)h(n)n(um)n(b)r(er)f(of)
+(attribute\))h(should)427 5494 y(matc)n(h)f(the)h(n)n(um)n(b)r(er)f(of)
g(input)h(grid)f(dimensions)f(giv)n(en)h(b)n(y)g(the)g(v)-5
b(alue)25 b(of)f(NDIM)p Ft(_)p Fj(IN)h(b)r(elo)n(w.)35
-b(Similarly)-7 b(,)427 2667 y(the)29 b(n)n(um)n(b)r(er)e(of)h(output)g
+b(Similarly)-7 b(,)427 5593 y(the)29 b(n)n(um)n(b)r(er)e(of)h(output)g
(co)r(ordinates)f(\(Nout)h(attribute\))h(should)e(matc)n(h)h(the)g(n)n
-(um)n(b)r(er)g(of)g(output)g(grid)427 2767 y(dimensions)g(giv)n(en)e(b)
-n(y)i(NDIM)p Ft(_)p Fj(OUT.)259 2906 y Fc(WLIM)k(=)g(DOUBLE)g
-(PRECISION)g(\(Giv)m(en\))427 3006 y Fj(This)d(v)-5 b(alue)28
+(um)n(b)r(er)g(of)g(output)g(grid)427 5693 y(dimensions)g(giv)n(en)e(b)
+n(y)i(NDIM)p Ft(_)p Fj(OUT.)p eop end
+%%Page: 336 346
+TeXDict begin 336 345 bop 0 52 a FG(336)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(WLIM)h(=)g(DOUBLE)g
+(PRECISION)g(\(Giv)m(en\))427 451 y Fj(This)d(v)-5 b(alue)28
b(is)h(only)f(used)g(if)i(the)f(AST)p Ft(__)p Fj(REBINEND)f(\015ag)f
(is)i(sp)r(eci\014ed)g(via)f(the)h(FLA)n(GS)g(argumen)n(t.)427
-3105 y(It)h(giv)n(es)d(the)j(required)e(n)n(um)n(b)r(er)g(of)h(input)h
+551 y(It)h(giv)n(es)d(the)j(required)e(n)n(um)n(b)r(er)g(of)h(input)h
(pixel)f(v)-5 b(alues)28 b(whic)n(h)h(m)n(ust)g(con)n(tribute)g(to)f
-(an)h(output)h(pixel)427 3205 y(\(i.e.)50 b(the)33 b(output)f(pixel)g
-(w)n(eigh)n(t\))f(in)h(order)f(for)g(the)i(output)f(pixel)g(v)-5
+(an)h(output)h(pixel)427 650 y(\(i.e.)50 b(the)33 b(output)f(pixel)g(w)
+n(eigh)n(t\))f(in)h(order)f(for)g(the)i(output)f(pixel)g(v)-5
b(alue)32 b(to)f(b)r(e)i(considered)d(v)-5 b(alid.)50
-b(If)427 3304 y(the)31 b(sum)f(of)g(the)h(input)g(pixel)f(w)n(eigh)n
-(ts)g(con)n(tributing)f(to)h(an)g(output)h(pixel)f(is)h(less)e(than)i
-(the)f(supplied)427 3404 y(WLIM)j(v)-5 b(alue,)35 b(then)e(the)g
-(output)g(pixel)g(v)-5 b(alue)33 b(is)g(returned)f(set)h(to)g(the)g
-(supplied)g(bad)g(v)-5 b(alue.)52 b(If)33 b(the)427 3504
-y(supplied)28 b(v)-5 b(alue)28 b(is)f(less)g(than)h(1.0E-10)d(then)j
-(1.0E-10)d(is)j(used)f(instead.)259 3643 y Fc(NDIM)p
-Ft(_)p Fc(IN)k(=)h(INTEGER)g(\(Giv)m(en\))427 3742 y
-Fj(The)c(n)n(um)n(b)r(er)f(of)h(dimensions)f(in)h(the)g(input)g(grid.)
-36 b(This)28 b(should)f(b)r(e)h(at)g(least)f(one.)259
-3881 y Fc(LBND)p Ft(_)p Fc(IN\()32 b(NDIM)p Ft(_)p Fc(IN)f(\))h(=)g
-(INTEGER)f(\(Giv)m(en\))427 3981 y Fj(An)j(arra)n(y)d(con)n(taining)h
-(the)i(co)r(ordinates)e(of)h(the)h(cen)n(tre)f(of)g(the)g(\014rst)h
-(pixel)f(in)g(the)h(input)g(grid)f(along)427 4081 y(eac)n(h)27
-b(dimension.)259 4220 y Fc(UBND)p Ft(_)p Fc(IN\()32 b(NDIM)p
-Ft(_)p Fc(IN)f(\))h(=)g(INTEGER)f(\(Giv)m(en\))427 4319
-y Fj(An)k(arra)n(y)d(con)n(taining)h(the)h(co)r(ordinates)f(of)h(the)h
-(cen)n(tre)f(of)g(the)g(last)g(pixel)g(in)h(the)f(input)h(grid)f(along)
-427 4419 y(eac)n(h)27 b(dimension.)427 4538 y(Note)h(that)f(LBND)p
-Ft(_)p Fj(IN)h(and)f(UBND)p Ft(_)p Fj(IN)h(together)f(de\014ne)g(the)h
-(shap)r(e)f(and)g(size)g(of)h(the)g(input)g(grid,)e(its)427
-4638 y(exten)n(t)33 b(along)e(a)i(particular)e(\(J'th\))j(dimension)e
-(b)r(eing)h(UBND)p Ft(_)p Fj(IN\(J\)-LBND)p Ft(_)p Fj(IN\(J\)+1.)52
-b(They)33 b(also)427 4737 y(de\014ne)25 b(the)f(input)i(grid's)d(co)r
-(ordinate)g(system,)i(eac)n(h)e(pixel)i(ha)n(ving)e(unit)i(exten)n(t)f
-(along)f(eac)n(h)h(dimension)427 4837 y(with)k(in)n(tegral)f(co)r
-(ordinate)f(v)-5 b(alues)27 b(at)h(its)g(cen)n(tre.)259
-4976 y Fc(IN\()k Fi(\003)f Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p
-Fl(>)g Fc(\(Giv)m(en\))427 5076 y Fj(An)k(arra)n(y)-7
-b(,)36 b(with)g(one)g(elemen)n(t)f(for)h(eac)n(h)f(pixel)g(in)h(the)g
-(input)h(grid,)g(con)n(taining)e(the)h(input)g(data)g(to)427
-5175 y(b)r(e)c(rebined.)47 b(The)32 b(n)n(umerical)e(t)n(yp)r(e)h(of)h
+b(If)427 750 y(the)31 b(sum)f(of)g(the)h(input)g(pixel)f(w)n(eigh)n(ts)
+g(con)n(tributing)f(to)h(an)g(output)h(pixel)f(is)h(less)e(than)i(the)f
+(supplied)427 849 y(WLIM)j(v)-5 b(alue,)35 b(then)e(the)g(output)g
+(pixel)g(v)-5 b(alue)33 b(is)g(returned)f(set)h(to)g(the)g(supplied)g
+(bad)g(v)-5 b(alue.)52 b(If)33 b(the)427 949 y(supplied)28
+b(v)-5 b(alue)28 b(is)f(less)g(than)h(1.0E-10)d(then)j(1.0E-10)d(is)j
+(used)f(instead.)259 1083 y Fc(NDIM)p Ft(_)p Fc(IN)k(=)h(INTEGER)g
+(\(Giv)m(en\))427 1183 y Fj(The)c(n)n(um)n(b)r(er)f(of)h(dimensions)f
+(in)h(the)g(input)g(grid.)36 b(This)28 b(should)f(b)r(e)h(at)g(least)f
+(one.)259 1317 y Fc(LBND)p Ft(_)p Fc(IN\()32 b(NDIM)p
+Ft(_)p Fc(IN)f(\))h(=)g(INTEGER)f(\(Giv)m(en\))427 1416
+y Fj(An)j(arra)n(y)d(con)n(taining)h(the)i(co)r(ordinates)e(of)h(the)h
+(cen)n(tre)f(of)g(the)g(\014rst)h(pixel)f(in)g(the)h(input)g(grid)f
+(along)427 1516 y(eac)n(h)27 b(dimension.)259 1650 y
+Fc(UBND)p Ft(_)p Fc(IN\()32 b(NDIM)p Ft(_)p Fc(IN)f(\))h(=)g(INTEGER)f
+(\(Giv)m(en\))427 1749 y Fj(An)k(arra)n(y)d(con)n(taining)h(the)h(co)r
+(ordinates)f(of)h(the)h(cen)n(tre)f(of)g(the)g(last)g(pixel)g(in)h(the)
+f(input)h(grid)f(along)427 1849 y(eac)n(h)27 b(dimension.)427
+1966 y(Note)h(that)f(LBND)p Ft(_)p Fj(IN)h(and)f(UBND)p
+Ft(_)p Fj(IN)h(together)f(de\014ne)g(the)h(shap)r(e)f(and)g(size)g(of)h
+(the)g(input)g(grid,)e(its)427 2065 y(exten)n(t)33 b(along)e(a)i
+(particular)e(\(J'th\))j(dimension)e(b)r(eing)h(UBND)p
+Ft(_)p Fj(IN\(J\)-LBND)p Ft(_)p Fj(IN\(J\)+1.)52 b(They)33
+b(also)427 2165 y(de\014ne)25 b(the)f(input)i(grid's)d(co)r(ordinate)g
+(system,)i(eac)n(h)e(pixel)i(ha)n(ving)e(unit)i(exten)n(t)f(along)f
+(eac)n(h)h(dimension)427 2265 y(with)k(in)n(tegral)f(co)r(ordinate)f(v)
+-5 b(alues)27 b(at)h(its)g(cen)n(tre.)259 2399 y Fc(IN\()k
+Fi(\003)f Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p Fl(>)g
+Fc(\(Giv)m(en\))427 2498 y Fj(An)k(arra)n(y)-7 b(,)36
+b(with)g(one)g(elemen)n(t)f(for)h(eac)n(h)f(pixel)g(in)h(the)g(input)h
+(grid,)g(con)n(taining)e(the)h(input)g(data)g(to)427
+2598 y(b)r(e)c(rebined.)47 b(The)32 b(n)n(umerical)e(t)n(yp)r(e)h(of)h
(this)f(arra)n(y)e(should)i(matc)n(h)g(the)g(1-)g(or)f(2-c)n(haracter)e
-(t)n(yp)r(e)k(co)r(de)427 5275 y(app)r(ended)g(to)f(the)h(function)g
+(t)n(yp)r(e)k(co)r(de)427 2698 y(app)r(ended)g(to)f(the)h(function)g
(name)f(\(e.g.)48 b(if)32 b(y)n(ou)e(are)h(using)f(AST)p
Ft(_)p Fj(REBINSEQR,)h(the)h(t)n(yp)r(e)f(of)g(eac)n(h)427
-5374 y(arra)n(y)26 b(elemen)n(t)h(should)h(b)r(e)g(REAL\).)427
-5494 y(The)33 b(storage)f(order)f(of)j(data)e(within)i(this)g(arra)n(y)
+2797 y(arra)n(y)26 b(elemen)n(t)h(should)h(b)r(e)g(REAL\).)427
+2914 y(The)33 b(storage)f(order)f(of)j(data)e(within)i(this)g(arra)n(y)
c(should)j(b)r(e)h(suc)n(h)f(that)g(the)h(index)f(of)g(the)g(\014rst)g
-(grid)427 5593 y(dimension)39 b(v)-5 b(aries)39 b(most)g(rapidly)g(and)
+(grid)427 3014 y(dimension)39 b(v)-5 b(aries)39 b(most)g(rapidly)g(and)
g(that)g(of)h(the)f(\014nal)g(dimension)h(least)f(rapidly)f(\(i.e.)73
-b(normal)427 5693 y(F)-7 b(ortran)27 b(arra)n(y)e(storage)h(order\).)p
-eop end
-%%Page: 334 344
-TeXDict begin 334 343 bop 0 52 a FG(334)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(IN)p
-Ft(_)p Fc(V)-11 b(AR\()32 b Fi(\003)f Fc(\))h(=)g Fl(<)p
-Fc(Xt)m(yp)s(e)p Fl(>)g Fc(\(Giv)m(en\))427 451 y Fj(An)20
-b(optional)e(second)h(arra)n(y)e(with)i(the)h(same)e(size)h(and)g(t)n
-(yp)r(e)g(as)g(the)g(IN)h(arra)n(y)-7 b(.)31 b(If)20
-b(giv)n(en,)g(this)f(should)g(con-)427 551 y(tain)g(a)f(set)g(of)h
-(non-negativ)n(e)e(v)-5 b(alues)18 b(whic)n(h)g(represen)n(t)f
-(estimates)h(of)h(the)g(statistical)f(v)-5 b(ariance)17
-b(asso)r(ciated)427 650 y(with)29 b(eac)n(h)f(elemen)n(t)h(of)g(the)g
-(IN)g(arra)n(y)-7 b(.)37 b(If)30 b(neither)e(the)h(AST)p
+b(normal)427 3113 y(F)-7 b(ortran)27 b(arra)n(y)e(storage)h(order\).)
+259 3247 y Fc(IN)p Ft(_)p Fc(V)-11 b(AR\()32 b Fi(\003)f
+Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p Fl(>)g Fc(\(Giv)m(en\))427
+3347 y Fj(An)20 b(optional)e(second)h(arra)n(y)e(with)i(the)h(same)e
+(size)h(and)g(t)n(yp)r(e)g(as)g(the)g(IN)h(arra)n(y)-7
+b(.)31 b(If)20 b(giv)n(en,)g(this)f(should)g(con-)427
+3446 y(tain)g(a)f(set)g(of)h(non-negativ)n(e)e(v)-5 b(alues)18
+b(whic)n(h)g(represen)n(t)f(estimates)h(of)h(the)g(statistical)f(v)-5
+b(ariance)17 b(asso)r(ciated)427 3546 y(with)29 b(eac)n(h)f(elemen)n(t)
+h(of)g(the)g(IN)g(arra)n(y)-7 b(.)37 b(If)30 b(neither)e(the)h(AST)p
Ft(__)p Fj(USEV)-9 b(AR)29 b(nor)f(the)h(AST)p Ft(__)p
-Fj(V)-9 b(AR)g(W)n(GT)427 750 y(\015ag)22 b(is)h(set,)h(no)f(input)h(v)
--5 b(ariance)22 b(estimates)g(are)g(required)g(and)h(this)g(arra)n(y)e
-(will)i(not)g(b)r(e)h(used.)35 b(A)23 b(dumm)n(y)427
-849 y(\(e.g.)37 b(one-elemen)n(t\))27 b(arra)n(y)e(ma)n(y)i(then)h(b)r
-(e)g(supplied.)259 989 y Fc(SPREAD)k(=)g(INTEGER)f(\(Giv)m(en\))427
-1089 y Fj(This)25 b(argumen)n(t)e(sp)r(eci\014es)i(the)g(sc)n(heme)f
+Fj(V)-9 b(AR)g(W)n(GT)427 3646 y(\015ag)22 b(is)h(set,)h(no)f(input)h
+(v)-5 b(ariance)22 b(estimates)g(are)g(required)g(and)h(this)g(arra)n
+(y)e(will)i(not)g(b)r(e)h(used.)35 b(A)23 b(dumm)n(y)427
+3745 y(\(e.g.)37 b(one-elemen)n(t\))27 b(arra)n(y)e(ma)n(y)i(then)h(b)r
+(e)g(supplied.)259 3879 y Fc(SPREAD)k(=)g(INTEGER)f(\(Giv)m(en\))427
+3979 y Fj(This)25 b(argumen)n(t)e(sp)r(eci\014es)i(the)g(sc)n(heme)f
(to)g(b)r(e)h(used)g(for)f(dividing)g(eac)n(h)g(input)h(data)f(v)-5
-b(alue)25 b(up)g(amongst)427 1188 y(the)30 b(corresp)r(onding)d(output)
+b(alue)25 b(up)g(amongst)427 4078 y(the)30 b(corresp)r(onding)d(output)
j(pixels.)42 b(It)30 b(ma)n(y)e(b)r(e)i(used)f(to)h(select)f(from)g(a)g
-(set)g(of)g(pre-de\014ned)g(sc)n(hemes)427 1288 y(b)n(y)36
+(set)g(of)g(pre-de\014ned)g(sc)n(hemes)427 4178 y(b)n(y)36
b(supplying)f(one)g(of)g(the)h(v)-5 b(alues)35 b(describ)r(ed)h(in)g
(the)f Ft(")p Fj(Pixel)g(Spreading)g(Sc)n(hemes)p Ft(")f
-Fj(section)h(in)h(the)427 1388 y(description)26 b(of)g(the)h(AST)p
+Fj(section)h(in)h(the)427 4278 y(description)26 b(of)g(the)h(AST)p
Ft(_)p Fj(REBIN)p Fl(<)p Fj(X)p Fl(>)f Fj(routines.)36
b(If)26 b(a)g(v)-5 b(alue)27 b(of)f(zero)f(is)h(supplied,)h(then)g(the)
-g(default)427 1487 y(linear)g(spreading)f(sc)n(heme)i(is)f(used)h
+g(default)427 4377 y(linear)g(spreading)f(sc)n(heme)i(is)f(used)h
(\(equiv)-5 b(alen)n(t)27 b(to)h(supplying)f(the)h(v)-5
-b(alue)28 b(AST)p Ft(__)p Fj(LINEAR\).)259 1627 y Fc(P)-8
+b(alue)28 b(AST)p Ft(__)p Fj(LINEAR\).)259 4511 y Fc(P)-8
b(ARAMS\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m(en\))
-427 1726 y Fj(An)23 b(optional)f(arra)n(y)e(whic)n(h)i(should)g(con)n
+427 4611 y Fj(An)23 b(optional)f(arra)n(y)e(whic)n(h)i(should)g(con)n
(tain)g(an)n(y)g(additional)f(parameter)g(v)-5 b(alues)22
-b(required)g(b)n(y)g(the)h(pixel)427 1826 y(spreading)g(sc)n(heme.)36
+b(required)g(b)n(y)g(the)h(pixel)427 4711 y(spreading)g(sc)n(heme.)36
b(If)24 b(suc)n(h)g(parameters)f(are)g(required,)h(this)h(will)g(b)r(e)
f(noted)h(in)f(the)h Ft(")p Fj(Pixel)f(Spreading)427
-1926 y(Sc)n(hemes)p Ft(")j Fj(section)g(in)h(the)g(description)f(of)h
+4810 y(Sc)n(hemes)p Ft(")j Fj(section)g(in)h(the)g(description)f(of)h
(the)g(AST)p Ft(_)p Fj(REBIN)p Fl(<)p Fj(X)p Fl(>)e Fj(routines.)427
-2045 y(If)g(no)e(additional)g(parameters)g(are)f(required,)i(this)g
+4927 y(If)g(no)e(additional)g(parameters)g(are)f(required,)i(this)g
(arra)n(y)d(is)j(not)g(used.)36 b(A)25 b(dumm)n(y)g(\(e.g.)36
-b(one-elemen)n(t\))427 2145 y(arra)n(y)26 b(ma)n(y)g(then)j(b)r(e)f
-(supplied.)259 2285 y Fc(FLA)m(GS)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
-2384 y Fj(The)36 b(sum)f(of)h(a)f(set)g(of)g(\015ag)g(v)-5
+b(one-elemen)n(t\))427 5027 y(arra)n(y)26 b(ma)n(y)g(then)j(b)r(e)f
+(supplied.)259 5161 y Fc(FLA)m(GS)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
+5260 y Fj(The)36 b(sum)f(of)h(a)f(set)g(of)g(\015ag)g(v)-5
b(alues)35 b(whic)n(h)g(ma)n(y)g(b)r(e)h(used)f(to)g(pro)n(vide)g
-(additional)g(con)n(trol)f(o)n(v)n(er)f(the)427 2484
+(additional)g(con)n(trol)f(o)n(v)n(er)f(the)427 5360
y(rebinning)d(op)r(eration.)45 b(See)31 b(the)f Ft(")p
Fj(Con)n(trol)f(Flags)p Ft(")g Fj(section)i(b)r(elo)n(w)f(for)g(a)g
-(description)g(of)g(the)h(options)427 2584 y(a)n(v)-5
+(description)g(of)g(the)h(options)427 5459 y(a)n(v)-5
b(ailable.)36 b(If)28 b(no)f(\015ag)g(v)-5 b(alues)27
b(are)g(to)g(b)r(e)h(set,)g(a)f(v)-5 b(alue)28 b(of)f(zero)g(should)g
-(b)r(e)h(giv)n(en.)259 2723 y Fc(TOL)k(=)h(DOUBLE)f(PRECISION)f(\(Giv)m
-(en\))427 2823 y Fj(The)j(maxim)n(um)f(tolerable)f(geometrical)f
+(b)r(e)h(giv)n(en.)259 5593 y Fc(TOL)k(=)h(DOUBLE)f(PRECISION)f(\(Giv)m
+(en\))427 5693 y Fj(The)j(maxim)n(um)f(tolerable)f(geometrical)f
(distortion)i(whic)n(h)g(ma)n(y)f(b)r(e)i(in)n(tro)r(duced)f(as)f(a)h
-(result)g(of)g(ap-)427 2923 y(pro)n(ximating)c(non-linear)f(Mappings)h
-(b)n(y)h(a)f(set)h(of)g(piece-wise)f(linear)g(transformations.)42
-b(This)30 b(should)427 3022 y(b)r(e)e(expressed)f(as)g(a)g(displacemen)
-n(t)g(in)h(pixels)f(in)h(the)g(output)g(grid's)f(co)r(ordinate)f
-(system.)427 3142 y(If)34 b(piece-wise)f(linear)g(appro)n(ximation)f
-(is)h(not)h(required,)g(a)f(v)-5 b(alue)33 b(of)h(zero)e(ma)n(y)h(b)r
-(e)h(giv)n(en.)54 b(This)33 b(will)427 3241 y(ensure)k(that)g(the)h
-(Mapping)e(is)h(used)g(without)h(an)n(y)e(appro)n(ximation,)i(but)g(ma)
-n(y)e(increase)g(execution)427 3341 y(time.)427 3461
-y(If)d(the)f(v)-5 b(alue)32 b(is)g(to)r(o)g(high,)h(discon)n(tin)n
-(uities)e(b)r(et)n(w)n(een)h(the)h(linear)e(appro)n(ximations)f(used)i
-(in)g(adjacen)n(t)427 3560 y(panel)h(will)g(b)r(e)g(higher,)h(and)f(ma)
-n(y)f(cause)g(the)i(edges)e(of)h(the)g(panel)g(to)g(b)r(e)g(visible)g
-(when)g(viewing)f(the)427 3660 y(output)c(image)f(at)h(high)f(con)n
-(trast.)36 b(If)28 b(this)g(is)f(a)g(problem,)g(reduce)h(the)g
-(tolerance)e(v)-5 b(alue)27 b(used.)259 3800 y Fc(MAXPIX)33
-b(=)f(INTEGER)f(\(Giv)m(en\))427 3899 y Fj(A)42 b(v)-5
-b(alue)40 b(whic)n(h)h(sp)r(eci\014es)g(an)g(initial)g(scale)g(size)f
-(\(in)i(pixels\))f(for)f(the)i(adaptiv)n(e)e(algorithm)g(whic)n(h)427
-3999 y(appro)n(ximates)d(non-linear)g(Mappings)h(with)h(piece-wise)f
-(linear)g(transformations.)68 b(Normally)-7 b(,)40 b(this)427
-4098 y(should)e(b)r(e)g(a)g(large)e(v)-5 b(alue)38 b(\(larger)e(than)j
-(an)n(y)e(dimension)h(of)f(the)i(region)d(of)i(the)h(input)f(grid)g(b)r
-(eing)427 4198 y(used\).)46 b(In)31 b(this)g(case,)g(a)f(\014rst)g
-(attempt)h(to)g(appro)n(ximate)e(the)i(Mapping)f(b)n(y)g(a)g(linear)g
-(transformation)427 4298 y(will)e(b)r(e)g(made)f(o)n(v)n(er)f(the)i(en)
-n(tire)f(input)i(region.)427 4417 y(If)k(a)f(smaller)f(v)-5
-b(alue)33 b(is)f(used,)i(the)e(input)h(region)f(will)g(\014rst)g(b)r(e)
-h(divided)g(in)n(to)f(sub-regions)e(whose)i(size)427
-4517 y(do)r(es)40 b(not)g(exceed)f(MAXPIX)h(pixels)g(in)g(an)n(y)f
-(dimension.)74 b(Only)39 b(at)h(this)g(p)r(oin)n(t)g(will)g(attempts)h
-(at)427 4617 y(appro)n(ximation)26 b(commence.)427 4736
-y(This)38 b(v)-5 b(alue)38 b(ma)n(y)g(o)r(ccasionally)e(b)r(e)j(useful)
-f(in)h(prev)n(en)n(ting)e(false)h(con)n(v)n(ergence)d(of)j(the)h
-(adaptiv)n(e)e(al-)427 4836 y(gorithm)c(in)g(cases)f(where)g(the)h
-(Mapping)g(app)r(ears)f(appro)n(ximately)f(linear)h(on)h(large)e
-(scales,)j(but)f(has)427 4936 y(irregularities)27 b(\(e.g.)40
-b(holes\))28 b(on)g(smaller)g(scales.)39 b(A)29 b(v)-5
-b(alue)28 b(of,)h(sa)n(y)-7 b(,)28 b(50)g(to)g(100)g(pixels)g(can)g
-(also)g(b)r(e)h(em-)427 5035 y(plo)n(y)n(ed)23 b(as)f(a)h(safeguard)f
-(in)i(general-purp)r(ose)d(soft)n(w)n(are,)i(since)g(the)h(e\013ect)f
-(on)h(p)r(erformance)e(is)h(minimal.)427 5155 y(If)e(to)r(o)f(small)g
-(a)g(v)-5 b(alue)20 b(is)g(giv)n(en,)h(it)g(will)f(ha)n(v)n(e)f(the)i
-(e\013ect)g(of)f(inhibiting)h(linear)f(appro)n(ximation)e(altogether)
-427 5254 y(\(equiv)-5 b(alen)n(t)21 b(to)f(setting)h(TOL)f(to)g
-(zero\).)34 b(Although)20 b(this)h(ma)n(y)f(degrade)f(p)r(erformance,)i
-(accurate)e(results)427 5354 y(will)28 b(still)g(b)r(e)g(obtained.)259
-5494 y Fc(BAD)m(V)-11 b(AL)34 b(=)e Fl(<)p Fc(Xt)m(yp)s(e)p
-Fl(>)f Fc(\(Giv)m(en\))427 5593 y Fj(This)i(argumen)n(t)e(should)h(ha)n
+(result)g(of)g(ap-)p eop end
+%%Page: 337 347
+TeXDict begin 337 346 bop 3643 52 a FG(337)427 351 y
+Fj(pro)n(ximating)29 b(non-linear)f(Mappings)h(b)n(y)h(a)f(set)h(of)g
+(piece-wise)f(linear)g(transformations.)42 b(This)30
+b(should)427 451 y(b)r(e)e(expressed)f(as)g(a)g(displacemen)n(t)g(in)h
+(pixels)f(in)h(the)g(output)g(grid's)f(co)r(ordinate)f(system.)427
+571 y(If)34 b(piece-wise)f(linear)g(appro)n(ximation)f(is)h(not)h
+(required,)g(a)f(v)-5 b(alue)33 b(of)h(zero)e(ma)n(y)h(b)r(e)h(giv)n
+(en.)54 b(This)33 b(will)427 671 y(ensure)k(that)g(the)h(Mapping)e(is)h
+(used)g(without)h(an)n(y)e(appro)n(ximation,)i(but)g(ma)n(y)e(increase)
+g(execution)427 771 y(time.)427 891 y(If)d(the)f(v)-5
+b(alue)32 b(is)g(to)r(o)g(high,)h(discon)n(tin)n(uities)e(b)r(et)n(w)n
+(een)h(the)h(linear)e(appro)n(ximations)f(used)i(in)g(adjacen)n(t)427
+991 y(panel)h(will)g(b)r(e)g(higher,)h(and)f(ma)n(y)f(cause)g(the)i
+(edges)e(of)h(the)g(panel)g(to)g(b)r(e)g(visible)g(when)g(viewing)f
+(the)427 1090 y(output)c(image)f(at)h(high)f(con)n(trast.)36
+b(If)28 b(this)g(is)f(a)g(problem,)g(reduce)h(the)g(tolerance)e(v)-5
+b(alue)27 b(used.)259 1232 y Fc(MAXPIX)33 b(=)f(INTEGER)f(\(Giv)m(en\))
+427 1332 y Fj(A)42 b(v)-5 b(alue)40 b(whic)n(h)h(sp)r(eci\014es)g(an)g
+(initial)g(scale)g(size)f(\(in)i(pixels\))f(for)f(the)i(adaptiv)n(e)e
+(algorithm)g(whic)n(h)427 1431 y(appro)n(ximates)d(non-linear)g
+(Mappings)h(with)h(piece-wise)f(linear)g(transformations.)68
+b(Normally)-7 b(,)40 b(this)427 1531 y(should)e(b)r(e)g(a)g(large)e(v)
+-5 b(alue)38 b(\(larger)e(than)j(an)n(y)e(dimension)h(of)f(the)i
+(region)d(of)i(the)h(input)f(grid)g(b)r(eing)427 1630
+y(used\).)46 b(In)31 b(this)g(case,)g(a)f(\014rst)g(attempt)h(to)g
+(appro)n(ximate)e(the)i(Mapping)f(b)n(y)g(a)g(linear)g(transformation)
+427 1730 y(will)e(b)r(e)g(made)f(o)n(v)n(er)f(the)i(en)n(tire)f(input)i
+(region.)427 1851 y(If)k(a)f(smaller)f(v)-5 b(alue)33
+b(is)f(used,)i(the)e(input)h(region)f(will)g(\014rst)g(b)r(e)h(divided)
+g(in)n(to)f(sub-regions)e(whose)i(size)427 1950 y(do)r(es)40
+b(not)g(exceed)f(MAXPIX)h(pixels)g(in)g(an)n(y)f(dimension.)74
+b(Only)39 b(at)h(this)g(p)r(oin)n(t)g(will)g(attempts)h(at)427
+2050 y(appro)n(ximation)26 b(commence.)427 2170 y(This)38
+b(v)-5 b(alue)38 b(ma)n(y)g(o)r(ccasionally)e(b)r(e)j(useful)f(in)h
+(prev)n(en)n(ting)e(false)h(con)n(v)n(ergence)d(of)j(the)h(adaptiv)n(e)
+e(al-)427 2270 y(gorithm)c(in)g(cases)f(where)g(the)h(Mapping)g(app)r
+(ears)f(appro)n(ximately)f(linear)h(on)h(large)e(scales,)j(but)f(has)
+427 2370 y(irregularities)27 b(\(e.g.)40 b(holes\))28
+b(on)g(smaller)g(scales.)39 b(A)29 b(v)-5 b(alue)28 b(of,)h(sa)n(y)-7
+b(,)28 b(50)g(to)g(100)g(pixels)g(can)g(also)g(b)r(e)h(em-)427
+2469 y(plo)n(y)n(ed)23 b(as)f(a)h(safeguard)f(in)i(general-purp)r(ose)d
+(soft)n(w)n(are,)i(since)g(the)h(e\013ect)f(on)h(p)r(erformance)e(is)h
+(minimal.)427 2590 y(If)e(to)r(o)f(small)g(a)g(v)-5 b(alue)20
+b(is)g(giv)n(en,)h(it)g(will)f(ha)n(v)n(e)f(the)i(e\013ect)g(of)f
+(inhibiting)h(linear)f(appro)n(ximation)e(altogether)427
+2689 y(\(equiv)-5 b(alen)n(t)21 b(to)f(setting)h(TOL)f(to)g(zero\).)34
+b(Although)20 b(this)h(ma)n(y)f(degrade)f(p)r(erformance,)i(accurate)e
+(results)427 2789 y(will)28 b(still)g(b)r(e)g(obtained.)259
+2930 y Fc(BAD)m(V)-11 b(AL)34 b(=)e Fl(<)p Fc(Xt)m(yp)s(e)p
+Fl(>)f Fc(\(Giv)m(en\))427 3030 y Fj(This)i(argumen)n(t)e(should)h(ha)n
(v)n(e)g(the)g(same)g(t)n(yp)r(e)h(as)f(the)h(elemen)n(ts)f(of)g(the)h
(IN)g(arra)n(y)-7 b(.)49 b(It)33 b(sp)r(eci\014es)f(the)427
-5693 y(v)-5 b(alue)28 b(used)f(to)h(\015ag)f(missing)g(data)g(\(bad)h
-(pixels\))f(in)h(the)g(input)g(and)g(output)g(arra)n(ys.)p
-eop end
-%%Page: 335 345
-TeXDict begin 335 344 bop 3643 52 a FG(335)427 351 y
-Fj(If)33 b(the)f(AST)p Ft(__)p Fj(USEBAD)g(\015ag)f(is)h(set)g(via)f
-(the)i(FLA)n(GS)f(argumen)n(t,)g(then)h(this)f(v)-5 b(alue)32
-b(is)g(used)f(to)h(test)427 451 y(for)27 b(bad)h(pixels)f(in)h(the)g
-(IN)g(\(and)g(IN)p Ft(_)p Fj(V)-9 b(AR\))28 b(arra)n(y\(s\).)427
-563 y(In)e(all)g(cases,)f(this)h(v)-5 b(alue)26 b(is)g(also)f(used)h
-(to)g(\015ag)f(an)n(y)g(output)h(elemen)n(ts)g(in)g(the)h(OUT)e(\(and)h
-(OUT)p Ft(_)p Fj(V)-9 b(AR\))427 663 y(arra)n(y\(s\))34
-b(for)i(whic)n(h)g(rebined)g(v)-5 b(alues)36 b(could)g(not)h(b)r(e)f
-(obtained)g(\(see)g(the)h Ft(")p Fj(Propagation)c(of)j(Missing)427
-762 y(Data)p Ft(")27 b Fj(section)g(b)r(elo)n(w)h(for)f(details)g(of)h
-(the)g(circumstances)e(under)i(whic)n(h)f(this)h(ma)n(y)f(o)r(ccur\).)
-259 887 y Fc(NDIM)p Ft(_)p Fc(OUT)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
-986 y Fj(The)38 b(n)n(um)n(b)r(er)f(of)g(dimensions)g(in)h(the)f
+3130 y(v)-5 b(alue)28 b(used)f(to)h(\015ag)f(missing)g(data)g(\(bad)h
+(pixels\))f(in)h(the)g(input)g(and)g(output)g(arra)n(ys.)427
+3250 y(If)33 b(the)f(AST)p Ft(__)p Fj(USEBAD)g(\015ag)f(is)h(set)g(via)
+f(the)i(FLA)n(GS)f(argumen)n(t,)g(then)h(this)f(v)-5
+b(alue)32 b(is)g(used)f(to)h(test)427 3350 y(for)27 b(bad)h(pixels)f
+(in)h(the)g(IN)g(\(and)g(IN)p Ft(_)p Fj(V)-9 b(AR\))28
+b(arra)n(y\(s\).)427 3470 y(In)e(all)g(cases,)f(this)h(v)-5
+b(alue)26 b(is)g(also)f(used)h(to)g(\015ag)f(an)n(y)g(output)h(elemen)n
+(ts)g(in)g(the)h(OUT)e(\(and)h(OUT)p Ft(_)p Fj(V)-9 b(AR\))427
+3570 y(arra)n(y\(s\))34 b(for)i(whic)n(h)g(rebined)g(v)-5
+b(alues)36 b(could)g(not)h(b)r(e)f(obtained)g(\(see)g(the)h
+Ft(")p Fj(Propagation)c(of)j(Missing)427 3670 y(Data)p
+Ft(")27 b Fj(section)g(b)r(elo)n(w)h(for)f(details)g(of)h(the)g
+(circumstances)e(under)i(whic)n(h)f(this)h(ma)n(y)f(o)r(ccur\).)259
+3811 y Fc(NDIM)p Ft(_)p Fc(OUT)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
+3911 y Fj(The)38 b(n)n(um)n(b)r(er)f(of)g(dimensions)g(in)h(the)f
(output)h(grid.)66 b(This)37 b(should)g(b)r(e)h(at)f(least)g(one.)65
-b(It)38 b(need)g(not)427 1086 y(necessarily)26 b(b)r(e)i(equal)f(to)h
+b(It)38 b(need)g(not)427 4010 y(necessarily)26 b(b)r(e)i(equal)f(to)h
(the)g(n)n(um)n(b)r(er)f(of)h(dimensions)f(in)h(the)g(input)g(grid.)259
-1210 y Fc(LBND)p Ft(_)p Fc(OUT\()33 b(NDIM)p Ft(_)p Fc(OUT)e(\))h(=)g
-(INTEGER)g(\(Giv)m(en\))427 1310 y Fj(An)f(arra)n(y)d(con)n(taining)h
+4152 y Fc(LBND)p Ft(_)p Fc(OUT\()33 b(NDIM)p Ft(_)p Fc(OUT)e(\))h(=)g
+(INTEGER)g(\(Giv)m(en\))427 4251 y Fj(An)f(arra)n(y)d(con)n(taining)h
(the)h(co)r(ordinates)f(of)h(the)h(cen)n(tre)e(of)h(the)h(\014rst)f
-(pixel)g(in)g(the)h(output)f(grid)g(along)427 1410 y(eac)n(h)d
-(dimension.)259 1534 y Fc(UBND)p Ft(_)p Fc(OUT\()33 b(NDIM)p
-Ft(_)p Fc(OUT)e(\))h(=)g(INTEGER)g(\(Giv)m(en\))427 1634
+(pixel)g(in)g(the)h(output)f(grid)g(along)427 4351 y(eac)n(h)d
+(dimension.)259 4493 y Fc(UBND)p Ft(_)p Fc(OUT\()33 b(NDIM)p
+Ft(_)p Fc(OUT)e(\))h(=)g(INTEGER)g(\(Giv)m(en\))427 4592
y Fj(An)g(arra)n(y)c(con)n(taining)i(the)i(co)r(ordinates)d(of)i(the)h
(cen)n(tre)e(of)h(the)h(last)e(pixel)h(in)h(the)f(output)h(grid)e
-(along)427 1733 y(eac)n(h)d(dimension.)427 1845 y(Note)41
+(along)427 4692 y(eac)n(h)d(dimension.)427 4812 y(Note)41
b(that)g(LBND)p Ft(_)p Fj(OUT)f(and)g(UBND)p Ft(_)p Fj(OUT)h(together)e
(de\014ne)i(the)g(shap)r(e,)i(size)d(and)h(co)r(ordinate)427
-1945 y(system)24 b(of)f(the)h(output)h(grid)d(in)i(the)g(same)g(w)n(a)n
+4912 y(system)24 b(of)f(the)h(output)h(grid)d(in)i(the)g(same)g(w)n(a)n
(y)e(as)h(LBND)p Ft(_)p Fj(IN)h(and)f(UBND)p Ft(_)p Fj(IN)i(de\014ne)f
-(the)g(shap)r(e,)g(size)427 2045 y(and)k(co)r(ordinate)e(system)h(of)h
-(the)g(input)g(grid.)259 2169 y Fc(LBND\()k(NDIM)p Ft(_)p
-Fc(IN)f(\))h(=)g(INTEGER)g(\(Giv)m(en\))427 2269 y Fj(An)c(arra)n(y)c
+(the)g(shap)r(e,)g(size)427 5012 y(and)k(co)r(ordinate)e(system)h(of)h
+(the)g(input)g(grid.)259 5153 y Fc(LBND\()k(NDIM)p Ft(_)p
+Fc(IN)f(\))h(=)g(INTEGER)g(\(Giv)m(en\))427 5253 y Fj(An)c(arra)n(y)c
(con)n(taining)i(the)i(co)r(ordinates)d(of)i(the)g(\014rst)g(pixel)g
(in)g(the)h(region)d(of)i(the)h(input)g(grid)e(whic)n(h)h(is)427
-2368 y(to)h(b)r(e)g(included)g(in)g(the)g(rebined)f(output)h(arra)n(y)
--7 b(.)259 2493 y Fc(UBND\()32 b(NDIM)p Ft(_)p Fc(IN)f(\))h(=)h
-(INTEGER)e(\(Giv)m(en\))427 2592 y Fj(An)e(arra)n(y)c(con)n(taining)i
+5352 y(to)h(b)r(e)g(included)g(in)g(the)g(rebined)f(output)h(arra)n(y)
+-7 b(.)259 5494 y Fc(UBND\()32 b(NDIM)p Ft(_)p Fc(IN)f(\))h(=)h
+(INTEGER)e(\(Giv)m(en\))427 5593 y Fj(An)e(arra)n(y)c(con)n(taining)i
(the)h(co)r(ordinates)e(of)i(the)g(last)g(pixel)g(in)g(the)g(region)e
-(of)i(the)g(input)h(grid)e(whic)n(h)h(is)427 2692 y(to)g(b)r(e)g
+(of)i(the)g(input)h(grid)e(whic)n(h)h(is)427 5693 y(to)g(b)r(e)g
(included)g(in)g(the)g(rebined)f(output)h(arra)n(y)-7
-b(.)427 2804 y(Note)26 b(that)g(LBND)h(and)e(UBND)i(together)e
-(de\014ne)h(the)g(shap)r(e)g(and)g(p)r(osition)g(of)f(a)h(\(h)n(yp)r
-(er-\)rectangular)427 2904 y(region)19 b(of)i(the)f(input)h(grid)f
-(whic)n(h)g(is)g(to)h(b)r(e)f(included)h(in)g(the)f(rebined)h(output)f
-(arra)n(y)-7 b(.)33 b(This)20 b(region)f(should)427 3003
-y(lie)33 b(wholly)e(within)i(the)g(exten)n(t)f(of)g(the)h(input)g(grid)
-e(\(as)h(de\014ned)h(b)n(y)f(the)g(LBND)p Ft(_)p Fj(IN)h(and)f(UBND)p
-Ft(_)p Fj(IN)427 3103 y(arra)n(ys\).)j(Regions)26 b(of)i(the)g(input)g
-(grid)f(lying)h(outside)f(this)h(region)e(will)i(not)g(b)r(e)g(used.)
-259 3227 y Fc(OUT\()33 b Fi(\003)e Fc(\))h(=)g Fl(<)p
-Fc(Xt)m(yp)s(e)p Fl(>)f Fc(\(Giv)m(en)i(and)f(Returned\))427
-3327 y Fj(An)26 b(arra)n(y)-7 b(,)23 b(with)j(one)f(elemen)n(t)g(for)g
-(eac)n(h)f(pixel)h(in)h(the)f(output)h(grid.)35 b(The)25
-b(rebined)g(data)g(v)-5 b(alues)25 b(will)g(b)r(e)427
-3427 y(added)h(in)n(to)f(the)h(original)e(con)n(ten)n(ts)h(of)g(this)h
-(arra)n(y)-7 b(.)34 b(The)26 b(n)n(umerical)e(t)n(yp)r(e)i(of)g(this)f
-(arra)n(y)f(should)h(matc)n(h)427 3526 y(that)33 b(of)g(the)g(IN)g
-(arra)n(y)-7 b(,)32 b(and)g(the)h(data)f(storage)f(order)g(should)i(b)r
-(e)g(suc)n(h)f(that)h(the)g(index)g(of)g(the)g(\014rst)427
-3626 y(grid)27 b(dimension)h(v)-5 b(aries)27 b(most)h(rapidly)f(and)h
-(that)g(of)g(the)g(\014nal)g(dimension)g(least)f(rapidly)g(\(i.e.)39
-b(normal)427 3726 y(F)-7 b(ortran)27 b(arra)n(y)e(storage)h(order\).)
-259 3850 y Fc(OUT)p Ft(_)p Fc(V)-11 b(AR\()33 b Fi(\003)e
+b(.)p eop end
+%%Page: 338 348
+TeXDict begin 338 347 bop 0 52 a FG(338)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(Note)26
+b(that)g(LBND)h(and)e(UBND)i(together)e(de\014ne)h(the)g(shap)r(e)g
+(and)g(p)r(osition)g(of)f(a)h(\(h)n(yp)r(er-\)rectangular)427
+451 y(region)19 b(of)i(the)f(input)h(grid)f(whic)n(h)g(is)g(to)h(b)r(e)
+f(included)h(in)g(the)f(rebined)h(output)f(arra)n(y)-7
+b(.)33 b(This)20 b(region)f(should)427 551 y(lie)33 b(wholly)e(within)i
+(the)g(exten)n(t)f(of)g(the)h(input)g(grid)e(\(as)h(de\014ned)h(b)n(y)f
+(the)g(LBND)p Ft(_)p Fj(IN)h(and)f(UBND)p Ft(_)p Fj(IN)427
+650 y(arra)n(ys\).)j(Regions)26 b(of)i(the)g(input)g(grid)f(lying)h
+(outside)f(this)h(region)e(will)i(not)g(b)r(e)g(used.)259
+783 y Fc(OUT\()33 b Fi(\003)e Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p
+Fl(>)f Fc(\(Giv)m(en)i(and)f(Returned\))427 883 y Fj(An)26
+b(arra)n(y)-7 b(,)23 b(with)j(one)f(elemen)n(t)g(for)g(eac)n(h)f(pixel)
+h(in)h(the)f(output)h(grid.)35 b(The)25 b(rebined)g(data)g(v)-5
+b(alues)25 b(will)g(b)r(e)427 982 y(added)h(in)n(to)f(the)h(original)e
+(con)n(ten)n(ts)h(of)g(this)h(arra)n(y)-7 b(.)34 b(The)26
+b(n)n(umerical)e(t)n(yp)r(e)i(of)g(this)f(arra)n(y)f(should)h(matc)n(h)
+427 1082 y(that)33 b(of)g(the)g(IN)g(arra)n(y)-7 b(,)32
+b(and)g(the)h(data)f(storage)f(order)g(should)i(b)r(e)g(suc)n(h)f(that)
+h(the)g(index)g(of)g(the)g(\014rst)427 1181 y(grid)27
+b(dimension)h(v)-5 b(aries)27 b(most)h(rapidly)f(and)h(that)g(of)g(the)
+g(\014nal)g(dimension)g(least)f(rapidly)g(\(i.e.)39 b(normal)427
+1281 y(F)-7 b(ortran)27 b(arra)n(y)e(storage)h(order\).)259
+1414 y Fc(OUT)p Ft(_)p Fc(V)-11 b(AR\()33 b Fi(\003)e
Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p Fl(>)f Fc(\(Giv)m(en)i(and)f
-(Returned\))427 3950 y Fj(A)f(arra)n(y)d(with)j(the)g(same)e(t)n(yp)r
+(Returned\))427 1513 y Fj(A)f(arra)n(y)d(with)j(the)g(same)e(t)n(yp)r
(e)i(and)f(size)g(as)g(the)g(OUT)h(arra)n(y)-7 b(.)43
b(This)30 b(arra)n(y)e(will)i(only)g(b)r(e)h(used)f(if)h(the)427
-4049 y(AST)p Ft(__)p Fj(USEV)-9 b(AR)36 b(or)g(AST)p
+1613 y(AST)p Ft(__)p Fj(USEV)-9 b(AR)36 b(or)g(AST)p
Ft(__)p Fj(GENV)-9 b(AR)36 b(\015ag)f(is)i(set)f(via)f(the)i(FLA)n(GS)g
(argumen)n(t,)g(via)f(the)g Ft(")p Fj(\015ags)p Ft(")427
-4149 y Fj(parameter,)d(in)g(whic)n(h)g(case)f(v)-5 b(ariance)31
+1713 y Fj(parameter,)d(in)g(whic)n(h)g(case)f(v)-5 b(ariance)31
b(estimates)i(for)f(the)h(rebined)g(data)f(v)-5 b(alues)33
-b(will)g(b)r(e)g(added)g(in)n(to)427 4249 y(the)28 b(arra)n(y)-7
+b(will)g(b)r(e)g(added)g(in)n(to)427 1812 y(the)28 b(arra)n(y)-7
b(.)34 b(If)27 b(neither)g(the)g(AST)p Ft(__)p Fj(USEV)-9
b(AR)27 b(\015ag)f(nor)g(the)i(AST)p Ft(__)p Fj(GENV)-9
-b(AR)26 b(\015ag)h(is)f(set,)h(no)g(output)427 4348 y(v)-5
+b(AR)26 b(\015ag)h(is)f(set,)h(no)g(output)427 1912 y(v)-5
b(ariance)31 b(estimates)h(will)g(b)r(e)h(calculated)e(and)h(this)g
(arra)n(y)e(will)i(not)g(b)r(e)h(used.)50 b(A)32 b(dumm)n(y)g(\(e.g.)50
-b(one-)427 4448 y(elemen)n(t\))28 b(arra)n(y)e(ma)n(y)g(then)j(b)r(e)f
-(supplied.)259 4572 y Fc(WEIGHTS\()k Fi(\003)f Fc(\))h(=)g(DOUBLE)h
-(PRECISION)e(\(Giv)m(en)h(and)g(Returned\))427 4672 y
+b(one-)427 2012 y(elemen)n(t\))28 b(arra)n(y)e(ma)n(y)g(then)j(b)r(e)f
+(supplied.)259 2144 y Fc(WEIGHTS\()k Fi(\003)f Fc(\))h(=)g(DOUBLE)h
+(PRECISION)e(\(Giv)m(en)h(and)g(Returned\))427 2244 y
Fj(An)24 b(arra)n(y)e(with)i(one)f(or)f(t)n(w)n(o)h(elemen)n(ts)h(for)f
(eac)n(h)g(pixel)g(in)h(the)g(output)g(grid,)g(dep)r(ending)g(on)f
-(whether)g(or)427 4772 y(not)c(the)f(AST)p Ft(__)p Fj(GENV)-9
+(whether)g(or)427 2343 y(not)c(the)f(AST)p Ft(__)p Fj(GENV)-9
b(AR)19 b(\015ag)e(has)h(b)r(een)h(supplied)g(via)e(the)i(FLA)n(GS)g
(parameter.)32 b(If)19 b(AST)p Ft(__)p Fj(GENV)-9 b(AR)427
-4871 y(has)30 b(not)f(b)r(een)i(sp)r(eci\014ed)f(then)g(the)g(arra)n(y)
+2443 y(has)30 b(not)f(b)r(een)i(sp)r(eci\014ed)f(then)g(the)g(arra)n(y)
e(should)h(ha)n(v)n(e)g(one)g(elemen)n(t)h(for)g(eac)n(h)f(output)h
-(pixel,)h(and)e(it)427 4971 y(will)d(b)r(e)g(used)f(to)h(accum)n(ulate)
+(pixel,)h(and)e(it)427 2543 y(will)d(b)r(e)g(used)f(to)h(accum)n(ulate)
f(the)h(w)n(eigh)n(t)e(asso)r(ciated)h(with)h(eac)n(h)e(output)i
(pixel.)37 b(If)26 b(AST)p Ft(__)p Fj(GENV)-9 b(AR)427
-5070 y(has)30 b(b)r(een)g(sp)r(eci\014ed)g(then)h(the)f(arra)n(y)e
+2642 y(has)30 b(b)r(een)g(sp)r(eci\014ed)g(then)h(the)f(arra)n(y)e
(should)h(ha)n(v)n(e)g(t)n(w)n(o)g(elemen)n(ts)h(for)f(eac)n(h)g
-(output)i(pixel.)44 b(The)30 b(\014rst)427 5170 y(half)i(of)f(the)h
+(output)i(pixel.)44 b(The)30 b(\014rst)427 2742 y(half)i(of)f(the)h
(arra)n(y)d(is)i(again)f(used)i(to)f(accum)n(ulate)g(the)g(w)n(eigh)n
(t)g(asso)r(ciated)f(with)i(eac)n(h)f(output)h(pixel,)427
-5270 y(and)f(the)f(second)g(half)h(is)f(used)g(to)h(accum)n(ulate)e
+2842 y(and)f(the)f(second)g(half)h(is)f(used)g(to)h(accum)n(ulate)e
(the)i(square)e(of)i(the)f(w)n(eigh)n(ts.)45 b(In)30
-b(eac)n(h)g(half,)h(the)g(data)427 5369 y(storage)g(order)g(should)h(b)
+b(eac)n(h)g(half,)h(the)g(data)427 2941 y(storage)g(order)g(should)h(b)
r(e)h(suc)n(h)f(that)h(the)g(index)f(of)h(the)f(\014rst)h(grid)e
-(dimension)i(v)-5 b(aries)31 b(most)h(rapidly)427 5469
+(dimension)i(v)-5 b(aries)31 b(most)h(rapidly)427 3041
y(and)c(that)g(of)f(the)h(\014nal)g(dimension)f(least)g(rapidly)g
(\(i.e.)37 b(normal)27 b(F)-7 b(ortran)26 b(arra)n(y)g(storage)f
-(order\).)259 5593 y Fc(NUSED)32 b(=)g(INTEGER)f(\(Giv)m(en)i(and)f
-(Returned\))427 5693 y Fj(The)i(n)n(um)n(b)r(er)g(of)f(input)i(data)e
-(v)-5 b(alues)33 b(that)h(ha)n(v)n(e)f(b)r(een)h(added)g(in)n(to)f(the)
-h(output)g(arra)n(y)e(so)h(far.)55 b(The)p eop end
-%%Page: 336 346
-TeXDict begin 336 345 bop 0 52 a FG(336)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(supplied)21
-b(v)-5 b(alue)20 b(is)g(incremen)n(ted)g(on)g(exit)g(b)n(y)g(the)g(n)n
-(um)n(b)r(er)g(of)g(input)h(v)-5 b(alues)20 b(used.)34
-b(The)20 b(v)-5 b(alue)20 b(is)g(initially)427 451 y(set)28
-b(to)f(zero)g(if)h(the)g(AST)p Ft(__)p Fj(REBININIT)f(\015ag)g(is)g
-(set)h(in)g(FLA)n(GS.)259 586 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 685
-y Fj(The)c(global)e(status.)-2 851 y Fc(Data)33 b(T)m(yp)s(e)g(Co)s
-(des)n(:)227 997 y Fj(T)-7 b(o)23 b(select)f(the)i(appropriate)d
-(rebinning)h(function,)j(y)n(ou)d(should)g(replace)g
-Fl(<)p Fj(X)p Fl(>)g Fj(in)h(the)h(generic)d(function)j(name)227
-1097 y(AST)p Ft(_)p Fj(REBINSEQ)p Fl(<)p Fj(X)p Fl(>)g
-Fj(with)i(a)f(1-)f(or)h(2-c)n(haracter)d(data)j(t)n(yp)r(e)h(co)r(de,)f
-(so)g(as)g(to)g(matc)n(h)g(the)h(n)n(umerical)e(t)n(yp)r(e)227
-1196 y Fl(<)p Fj(Xt)n(yp)r(e)p Fl(>)j Fj(of)h(the)g(data)f(y)n(ou)g
-(are)g(pro)r(cessing,)f(as)h(follo)n(ws:)340 1337 y Fi(\017)45
-b Fj(D:)28 b(DOUBLE)g(PRECISION)340 1471 y Fi(\017)45
-b Fj(R:)28 b(REAL)340 1606 y Fi(\017)45 b Fj(I:)28 b(INTEGER)227
-1772 y(F)-7 b(or)18 b(example,)i(AST)p Ft(_)p Fj(REBIND)e(w)n(ould)g(b)
-r(e)h(used)f(to)h(pro)r(cess)e(DOUBLE)h(PRECISION)f(data,)j(while)f
-(AST)p Ft(_)p Fj(REBINI)227 1871 y(w)n(ould)27 b(b)r(e)h(used)g(to)f
-(pro)r(cess)g(in)n(teger)g(data)g(\(stored)g(in)h(an)f(INTEGER)g(arra)n
-(y\),)f(etc.)227 1998 y(Note)d(that,)h(unlik)n(e)e(AST)p
-Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p Fj(,)g(the)h(AST)p
-Ft(_)p Fj(REBINSEQ)p Fl(<)p Fj(X)p Fl(>)e Fj(set)h(of)g(functions)h(do)
-r(es)f(not)h(y)n(et)227 2097 y(supp)r(ort)28 b(unsigned)f(in)n(teger)g
-(data)g(t)n(yp)r(es)g(or)g(in)n(tegers)g(of)g(di\013eren)n(t)h(sizes.)
--2 2251 y Fc(Con)m(trol)k(Flags)n(:)227 2397 y Fj(The)24
-b(follo)n(wing)f(\015ags)g(are)g(de\014ned)h(in)g(the)g(AST)p
-Ft(_)p Fj(P)-7 b(AR)24 b(include)g(\014le)g(and)g(ma)n(y)f(b)r(e)h
-(used)g(to)g(pro)n(vide)e(additional)227 2496 y(con)n(trol)32
-b(o)n(v)n(er)e(the)j(rebinning)f(pro)r(cess.)51 b(Ha)n(ving)32
-b(selected)g(a)g(set)h(of)f(\015ags,)h(y)n(ou)f(should)g(supply)h(the)g
-(sum)g(of)227 2596 y(their)28 b(v)-5 b(alues)27 b(via)g(the)h(FLA)n(GS)
-g(argumen)n(t:)340 2863 y Fi(\017)45 b Fj(AST)p Ft(__)p
-Fj(REBININIT:)28 b(Used)g(to)f(mark)g(the)i(\014rst)e(call)h(in)g(a)g
-(sequence.)37 b(It)28 b(indicates)g(that)g(the)g(supplied)427
-2962 y(OUT,)k(OUT)p Ft(_)p Fj(V)-9 b(AR)32 b(and)f(WEIGHTS)i(arra)n(ys)
-c(should)j(b)r(e)g(\014lled)g(with)g(zeros)f(\(th)n(us)h(o)n(v)n
-(er-writing)d(an)n(y)427 3062 y(supplied)h(v)-5 b(alues\))30
-b(b)r(efore)f(adding)g(the)h(rebinned)f(input)i(data)e(in)n(to)g(them.)
-43 b(This)30 b(\015ag)e(should)i(b)r(e)g(used)427 3162
-y(when)e(rebinning)f(the)h(\014rst)g(input)g(arra)n(y)d(in)j(a)f
-(sequence.)340 3296 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(REBINEND:)34
-b(Used)h(to)g(mark)f(the)h(last)f(call)g(in)h(a)g(sequence.)57
-b(It)35 b(causes)f(eac)n(h)g(v)-5 b(alue)34 b(in)h(the)427
-3396 y(OUT)30 b(and)h(OUT)p Ft(_)p Fj(V)-9 b(AR)30 b(arra)n(ys)d(to)k
-(b)r(e)f(divided)h(b)n(y)f(a)g(normalisation)e(factor)i(b)r(efore)g(b)r
-(eing)g(returned.)427 3496 y(The)d(normalisation)d(factor)i(for)g(eac)n
-(h)f(output)i(data)f(v)-5 b(alue)26 b(is)g(just)h(the)g(corresp)r
-(onding)d(v)-5 b(alue)26 b(from)g(the)427 3595 y(w)n(eigh)n(ts)31
-b(arra)n(y)-7 b(.)46 b(The)31 b(normalisation)f(factor)g(for)h(eac)n(h)
-g(output)g(v)-5 b(ariance)31 b(v)-5 b(alue)31 b(is)g(the)h(square)e(of)
-h(the)427 3695 y(data)k(v)-5 b(alue)34 b(normalisation)f(factor)h
-(\(see)h(also)e(AST)p Ft(__)p Fj(CONSER)-9 b(VEFLUX\).)35
-b(It)g(also)e(causes)h(output)427 3794 y(data)39 b(v)-5
-b(alues)38 b(to)h(b)r(e)g(set)g(bad)f(if)i(the)f(corresp)r(onding)e(w)n
-(eigh)n(t)h(is)h(less)f(than)h(the)g(v)-5 b(alue)39 b(supplied)g(for)
-427 3894 y(argumen)n(t)34 b(WLIM.)g(It)h(also)f(causes)f(an)n(y)h(temp)
-r(orary)f(v)-5 b(alues)34 b(stored)f(in)i(the)g(output)g(v)-5
-b(ariance)33 b(arra)n(y)427 3994 y(\(see)27 b(\015ag)e(AST)p
-Ft(__)p Fj(GENV)-9 b(AR)26 b(b)r(elo)n(w\))h(to)f(b)r(e)h(con)n(v)n
-(erted)e(in)n(to)h(usable)g(v)-5 b(ariance)25 b(v)-5
-b(alues.)36 b(Note,)27 b(this)f(\015ag)427 4093 y(is)i(ignored)e(if)i
-(the)g(AST)p Ft(__)p Fj(NONORM)f(\015ag)g(is)h(set.)340
-4228 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(USEBAD:)33 b(Indicates)g(that)h
-(there)f(ma)n(y)f(b)r(e)i(bad)f(pixels)f(in)i(the)f(input)h(arra)n
-(y\(s\))d(whic)n(h)i(m)n(ust)427 4328 y(b)r(e)26 b(recognised)d(b)n(y)i
-(comparing)e(with)j(the)f(v)-5 b(alue)25 b(giv)n(en)g(for)f(BAD)n(V)-9
-b(AL)26 b(and)e(propagated)g(to)h(the)g(output)427 4427
-y(arra)n(y\(s\).)41 b(If)30 b(this)g(\015ag)f(is)g(not)h(set,)g(all)f
-(input)h(v)-5 b(alues)30 b(are)e(treated)h(literally)g(and)h(the)g(BAD)
-n(V)-9 b(AL)30 b(v)-5 b(alue)427 4527 y(is)28 b(only)f(used)h(for)f
-(\015agging)f(output)i(arra)n(y)d(v)-5 b(alues.)340 4662
+(order\).)259 3174 y Fc(NUSED)32 b(=)g(INTEGER)p Fi(\003)p
+Fc(8)f(\(Giv)m(en)h(and)g(Returned\))427 3273 y Fj(The)i(n)n(um)n(b)r
+(er)g(of)f(input)i(data)e(v)-5 b(alues)33 b(that)h(ha)n(v)n(e)f(b)r
+(een)h(added)g(in)n(to)f(the)h(output)g(arra)n(y)e(so)h(far.)55
+b(The)427 3373 y(supplied)21 b(v)-5 b(alue)20 b(is)g(incremen)n(ted)g
+(on)g(exit)g(b)n(y)g(the)g(n)n(um)n(b)r(er)g(of)g(input)h(v)-5
+b(alues)20 b(used.)34 b(The)20 b(v)-5 b(alue)20 b(is)g(initially)427
+3472 y(set)28 b(to)f(zero)g(if)h(the)g(AST)p Ft(__)p
+Fj(REBININIT)f(\015ag)g(is)g(set)h(in)g(FLA)n(GS.)259
+3605 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 3705 y Fj(The)c(global)e(status.)-2 3867
+y Fc(Data)33 b(T)m(yp)s(e)g(Co)s(des)n(:)227 4013 y Fj(T)-7
+b(o)23 b(select)f(the)i(appropriate)d(rebinning)h(function,)j(y)n(ou)d
+(should)g(replace)g Fl(<)p Fj(X)p Fl(>)g Fj(in)h(the)h(generic)d
+(function)j(name)227 4112 y(AST)p Ft(_)p Fj(REBINSEQ)p
+Fl(<)p Fj(X)p Fl(>)g Fj(with)i(a)f(1-)f(or)h(2-c)n(haracter)d(data)j(t)
+n(yp)r(e)h(co)r(de,)f(so)g(as)g(to)g(matc)n(h)g(the)h(n)n(umerical)e(t)
+n(yp)r(e)227 4212 y Fl(<)p Fj(Xt)n(yp)r(e)p Fl(>)j Fj(of)h(the)g(data)f
+(y)n(ou)g(are)g(pro)r(cessing,)f(as)h(follo)n(ws:)340
+4348 y Fi(\017)45 b Fj(D:)28 b(DOUBLE)g(PRECISION)340
+4481 y Fi(\017)45 b Fj(R:)28 b(REAL)340 4614 y Fi(\017)45
+b Fj(I:)28 b(INTEGER)227 4776 y(F)-7 b(or)18 b(example,)i(AST)p
+Ft(_)p Fj(REBIND)e(w)n(ould)g(b)r(e)h(used)f(to)h(pro)r(cess)e(DOUBLE)h
+(PRECISION)f(data,)j(while)f(AST)p Ft(_)p Fj(REBINI)227
+4875 y(w)n(ould)27 b(b)r(e)h(used)g(to)f(pro)r(cess)g(in)n(teger)g
+(data)g(\(stored)g(in)h(an)f(INTEGER)g(arra)n(y\),)f(etc.)227
+5000 y(Note)d(that,)h(unlik)n(e)e(AST)p Ft(_)p Fj(RESAMPLE)p
+Fl(<)p Fj(X)p Fl(>)p Fj(,)g(the)h(AST)p Ft(_)p Fj(REBINSEQ)p
+Fl(<)p Fj(X)p Fl(>)e Fj(set)h(of)g(functions)h(do)r(es)f(not)h(y)n(et)
+227 5099 y(supp)r(ort)28 b(unsigned)f(in)n(teger)g(data)g(t)n(yp)r(es)g
+(or)g(in)n(tegers)g(of)g(di\013eren)n(t)h(sizes.)-2 5249
+y Fc(Con)m(trol)k(Flags)n(:)227 5395 y Fj(The)24 b(follo)n(wing)f
+(\015ags)g(are)g(de\014ned)h(in)g(the)g(AST)p Ft(_)p
+Fj(P)-7 b(AR)24 b(include)g(\014le)g(and)g(ma)n(y)f(b)r(e)h(used)g(to)g
+(pro)n(vide)e(additional)227 5494 y(con)n(trol)32 b(o)n(v)n(er)e(the)j
+(rebinning)f(pro)r(cess.)51 b(Ha)n(ving)32 b(selected)g(a)g(set)h(of)f
+(\015ags,)h(y)n(ou)f(should)g(supply)h(the)g(sum)g(of)227
+5594 y(their)28 b(v)-5 b(alues)27 b(via)g(the)h(FLA)n(GS)g(argumen)n
+(t:)p eop end
+%%Page: 339 349
+TeXDict begin 339 348 bop 3643 52 a FG(339)340 351 y
+Fi(\017)45 b Fj(AST)p Ft(__)p Fj(REBININIT:)28 b(Used)g(to)f(mark)g
+(the)i(\014rst)e(call)h(in)g(a)g(sequence.)37 b(It)28
+b(indicates)g(that)g(the)g(supplied)427 451 y(OUT,)k(OUT)p
+Ft(_)p Fj(V)-9 b(AR)32 b(and)f(WEIGHTS)i(arra)n(ys)c(should)j(b)r(e)g
+(\014lled)g(with)g(zeros)f(\(th)n(us)h(o)n(v)n(er-writing)d(an)n(y)427
+551 y(supplied)h(v)-5 b(alues\))30 b(b)r(efore)f(adding)g(the)h
+(rebinned)f(input)i(data)e(in)n(to)g(them.)43 b(This)30
+b(\015ag)e(should)i(b)r(e)g(used)427 650 y(when)e(rebinning)f(the)h
+(\014rst)g(input)g(arra)n(y)d(in)j(a)f(sequence.)340
+770 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(REBINEND:)34 b(Used)h(to)g(mark)
+f(the)h(last)f(call)g(in)h(a)g(sequence.)57 b(It)35 b(causes)f(eac)n(h)
+g(v)-5 b(alue)34 b(in)h(the)427 870 y(OUT)30 b(and)h(OUT)p
+Ft(_)p Fj(V)-9 b(AR)30 b(arra)n(ys)d(to)k(b)r(e)f(divided)h(b)n(y)f(a)g
+(normalisation)e(factor)i(b)r(efore)g(b)r(eing)g(returned.)427
+969 y(The)d(normalisation)d(factor)i(for)g(eac)n(h)f(output)i(data)f(v)
+-5 b(alue)26 b(is)g(just)h(the)g(corresp)r(onding)d(v)-5
+b(alue)26 b(from)g(the)427 1069 y(w)n(eigh)n(ts)31 b(arra)n(y)-7
+b(.)46 b(The)31 b(normalisation)f(factor)g(for)h(eac)n(h)g(output)g(v)
+-5 b(ariance)31 b(v)-5 b(alue)31 b(is)g(the)h(square)e(of)h(the)427
+1168 y(data)k(v)-5 b(alue)34 b(normalisation)f(factor)h(\(see)h(also)e
+(AST)p Ft(__)p Fj(CONSER)-9 b(VEFLUX\).)35 b(It)g(also)e(causes)h
+(output)427 1268 y(data)39 b(v)-5 b(alues)38 b(to)h(b)r(e)g(set)g(bad)f
+(if)i(the)f(corresp)r(onding)e(w)n(eigh)n(t)h(is)h(less)f(than)h(the)g
+(v)-5 b(alue)39 b(supplied)g(for)427 1368 y(argumen)n(t)34
+b(WLIM.)g(It)h(also)f(causes)f(an)n(y)h(temp)r(orary)f(v)-5
+b(alues)34 b(stored)f(in)i(the)g(output)g(v)-5 b(ariance)33
+b(arra)n(y)427 1467 y(\(see)27 b(\015ag)e(AST)p Ft(__)p
+Fj(GENV)-9 b(AR)26 b(b)r(elo)n(w\))h(to)f(b)r(e)h(con)n(v)n(erted)e(in)
+n(to)h(usable)g(v)-5 b(ariance)25 b(v)-5 b(alues.)36
+b(Note,)27 b(this)f(\015ag)427 1567 y(is)i(ignored)e(if)i(the)g(AST)p
+Ft(__)p Fj(NONORM)f(\015ag)g(is)h(set.)340 1687 y Fi(\017)45
+b Fj(AST)p Ft(__)p Fj(USEBAD:)33 b(Indicates)g(that)h(there)f(ma)n(y)f
+(b)r(e)i(bad)f(pixels)f(in)i(the)f(input)h(arra)n(y\(s\))d(whic)n(h)i
+(m)n(ust)427 1786 y(b)r(e)26 b(recognised)d(b)n(y)i(comparing)e(with)j
+(the)f(v)-5 b(alue)25 b(giv)n(en)g(for)f(BAD)n(V)-9 b(AL)26
+b(and)e(propagated)g(to)h(the)g(output)427 1886 y(arra)n(y\(s\).)41
+b(If)30 b(this)g(\015ag)f(is)g(not)h(set,)g(all)f(input)h(v)-5
+b(alues)30 b(are)e(treated)h(literally)g(and)h(the)g(BAD)n(V)-9
+b(AL)30 b(v)-5 b(alue)427 1986 y(is)28 b(only)f(used)h(for)f
+(\015agging)f(output)i(arra)n(y)d(v)-5 b(alues.)340 2105
y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(USEV)-9 b(AR:)36 b(Indicates)g(that)
g(output)h(v)-5 b(ariance)35 b(estimates)h(should)f(b)r(e)i(created)e
-(b)n(y)h(rebinning)427 4761 y(the)g(supplied)f(input)h(v)-5
+(b)n(y)h(rebinning)427 2205 y(the)g(supplied)f(input)h(v)-5
b(ariance)33 b(estimates.)59 b(An)35 b(error)e(will)j(b)r(e)f(rep)r
(orted)f(if)i(b)r(oth)f(this)g(\015ag)f(and)h(the)427
-4861 y(AST)p Ft(__)p Fj(GENV)-9 b(AR)28 b(\015ag)f(are)f(supplied.)340
-4996 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(GENV)-9 b(AR:)33
+2305 y(AST)p Ft(__)p Fj(GENV)-9 b(AR)28 b(\015ag)f(are)f(supplied.)340
+2424 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(GENV)-9 b(AR:)33
b(Indicates)g(that)h(output)f(v)-5 b(ariance)32 b(estimates)h(should)g
-(b)r(e)g(created)g(based)f(on)h(the)427 5095 y(spread)19
+(b)r(e)g(created)g(based)f(on)h(the)427 2524 y(spread)19
b(of)h(input)h(data)e(v)-5 b(alues)19 b(con)n(tributing)h(to)f(eac)n(h)
g(output)i(pixel.)34 b(An)20 b(error)e(will)i(b)r(e)h(rep)r(orted)e(if)
-h(b)r(oth)427 5195 y(this)29 b(\015ag)e(and)h(the)h(AST)p
+h(b)r(oth)427 2624 y(this)29 b(\015ag)e(and)h(the)h(AST)p
Ft(__)p Fj(USEV)-9 b(AR)28 b(\015ag)f(are)g(supplied.)39
b(If)29 b(the)g(AST)p Ft(__)p Fj(GENV)-9 b(AR)28 b(\015ag)f(is)h(sp)r
-(eci\014ed,)427 5295 y(the)e(supplied)g(output)h(v)-5
+(eci\014ed,)427 2723 y(the)e(supplied)g(output)h(v)-5
b(ariance)24 b(arra)n(y)g(is)h(\014rst)h(used)f(as)g(a)h(w)n(ork)e
(arra)n(y)f(to)j(accum)n(ulate)f(the)h(temp)r(orary)427
-5394 y(v)-5 b(alues)33 b(needed)h(to)f(generate)g(the)h(output)g(v)-5
+2823 y(v)-5 b(alues)33 b(needed)h(to)f(generate)g(the)h(output)g(v)-5
b(ariances.)53 b(When)34 b(the)g(sequence)f(ends)g(\(as)g(indicated)h
-(b)n(y)427 5494 y(the)h(AST)p Ft(__)p Fj(REBINEND)f(\015ag\),)i(the)f
+(b)n(y)427 2923 y(the)h(AST)p Ft(__)p Fj(REBINEND)f(\015ag\),)i(the)f
(con)n(ten)n(ts)f(of)g(the)h(output)g(v)-5 b(ariance)33
-b(arra)n(y)f(are)i(con)n(v)n(erted)f(in)n(to)427 5593
+b(arra)n(y)f(are)i(con)n(v)n(erted)f(in)n(to)427 3022
y(the)f(required)d(v)-5 b(ariance)30 b(estimates.)47
b(If)31 b(the)g(generation)f(of)g(suc)n(h)h(output)g(v)-5
-b(ariances)30 b(is)h(required,)f(this)427 5693 y(\015ag)g(should)f(b)r
+b(ariances)30 b(is)h(required,)f(this)427 3122 y(\015ag)g(should)f(b)r
(e)i(used)f(on)g(ev)n(ery)f(in)n(v)n(o)r(cation)f(of)i(this)h(routine)e
-(within)i(a)f(sequence,)g(and)g(an)n(y)f(supplied)p eop
-end
-%%Page: 337 347
-TeXDict begin 337 346 bop 3643 52 a FG(337)427 351 y
-Fj(input)37 b(v)-5 b(ariances)35 b(will)i(ha)n(v)n(e)e(no)h(e\013ect)h
-(on)f(the)h(output)g(v)-5 b(ariances)35 b(\(although)h(input)h(v)-5
-b(ariances)35 b(will)427 451 y(still)i(b)r(e)g(used)f(to)h(w)n(eigh)n
-(t)e(the)i(input)g(data)f(if)h(the)g(AST)p Ft(__)p Fj(V)-9
-b(AR)g(W)n(GT)36 b(\015ag)g(is)g(also)g(supplied\).)64
-b(The)427 551 y(statistical)29 b(meaning)f(of)g(these)h(output)g(v)-5
+(within)i(a)f(sequence,)g(and)g(an)n(y)f(supplied)427
+3221 y(input)37 b(v)-5 b(ariances)35 b(will)i(ha)n(v)n(e)e(no)h
+(e\013ect)h(on)f(the)h(output)g(v)-5 b(ariances)35 b(\(although)h
+(input)h(v)-5 b(ariances)35 b(will)427 3321 y(still)i(b)r(e)g(used)f
+(to)h(w)n(eigh)n(t)e(the)i(input)g(data)f(if)h(the)g(AST)p
+Ft(__)p Fj(V)-9 b(AR)g(W)n(GT)36 b(\015ag)g(is)g(also)g(supplied\).)64
+b(The)427 3421 y(statistical)29 b(meaning)f(of)g(these)h(output)g(v)-5
b(arianes)28 b(is)g(determined)h(b)n(y)g(the)g(presence)f(or)g(absence)
-g(of)g(the)427 650 y(AST)p Ft(__)p Fj(DISV)-9 b(AR)28
-b(\015ag)f(\(see)h(b)r(elo)n(w\).)340 782 y Fi(\017)45
+g(of)g(the)427 3520 y(AST)p Ft(__)p Fj(DISV)-9 b(AR)28
+b(\015ag)f(\(see)h(b)r(elo)n(w\).)340 3640 y Fi(\017)45
b Fj(AST)p Ft(__)p Fj(DISV)-9 b(AR:)26 b(This)g(\015ag)f(is)g(ignored)f
(unless)i(the)g(AST)p Ft(__)p Fj(GENV)-9 b(AR)25 b(\015ag)g(has)g(also)
-f(b)r(een)i(sp)r(eci\014ed.)427 882 y(It)32 b(determines)g(the)g
+f(b)r(een)i(sp)r(eci\014ed.)427 3740 y(It)32 b(determines)g(the)g
(statistical)g(meaning)f(of)h(the)g(generated)e(output)j(v)-5
b(ariances.)48 b(If)32 b(AST)p Ft(__)p Fj(DISV)-9 b(AR)427
-981 y(is)43 b(not)h(sp)r(eci\014ed,)j(generated)42 b(v)-5
+3839 y(is)43 b(not)h(sp)r(eci\014ed,)j(generated)42 b(v)-5
b(ariances)42 b(represen)n(t)g(v)-5 b(ariances)42 b(on)h(the)h(output)g
-(mean)f(v)-5 b(alues.)83 b(If)427 1081 y(AST)p Ft(__)p
+(mean)f(v)-5 b(alues.)83 b(If)427 3939 y(AST)p Ft(__)p
Fj(DISV)-9 b(AR)23 b(is)f(sp)r(eci\014ed,)i(the)f(generated)e(v)-5
b(ariances)21 b(represen)n(t)g(the)h(v)-5 b(ariance)22
-b(of)g(the)g(distribution)427 1181 y(from)28 b(whic)n(h)f(the)h(input)h
+b(of)g(the)g(distribution)427 4039 y(from)28 b(whic)n(h)f(the)h(input)h
(v)-5 b(alues)27 b(w)n(ere)g(tak)n(en.)37 b(Eac)n(h)26
b(output)i(v)-5 b(ariance)27 b(created)g(with)h(AST)p
-Ft(__)p Fj(DISV)-9 b(AR)427 1280 y(will)29 b(b)r(e)h(larger)d(than)i
+Ft(__)p Fj(DISV)-9 b(AR)427 4138 y(will)29 b(b)r(e)h(larger)d(than)i
(that)g(created)f(without)h(AST)p Ft(__)p Fj(DISV)-9
b(AR)30 b(b)n(y)e(a)h(factor)f(equal)g(to)h(the)g(n)n(um)n(b)r(er)g(of)
-427 1380 y(input)g(samples)e(that)g(con)n(tribute)h(to)f(the)h(output)g
-(sample.)340 1512 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(V)-9
+427 4238 y(input)g(samples)e(that)g(con)n(tribute)h(to)f(the)h(output)g
+(sample.)340 4358 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(V)-9
b(AR)g(W)n(GT:)29 b(Indicates)f(that)h(the)g(input)g(data)f(should)h(b)
r(e)g(w)n(eigh)n(ted)f(b)n(y)g(the)h(recipro)r(cal)e(of)h(the)427
-1612 y(input)e(v)-5 b(ariances.)35 b(Otherwise,)25 b(all)g(input)h
+4457 y(input)e(v)-5 b(ariances.)35 b(Otherwise,)25 b(all)g(input)h
(data)f(are)g(giv)n(en)f(equal)h(w)n(eigh)n(t.)36 b(If)25
-b(this)h(\015ag)f(is)g(sp)r(eci\014ed,)h(the)427 1711
+b(this)h(\015ag)f(is)g(sp)r(eci\014ed,)h(the)427 4557
y(calculation)e(of)h(the)g(output)g(v)-5 b(ariances)23
b(\(if)i(an)n(y\))g(is)f(mo)r(di\014ed)h(to)g(tak)n(e)f(accoun)n(t)f
-(of)i(the)g(v)-5 b(arying)24 b(w)n(eigh)n(ts)427 1811
+(of)i(the)g(v)-5 b(arying)24 b(w)n(eigh)n(ts)427 4656
y(assigned)j(to)g(the)h(input)h(data)e(v)-5 b(alues.)340
-1943 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(NONORM:)19 b(If)h(the)f(simple)
+4776 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(NONORM:)19 b(If)h(the)f(simple)
g(unnormalised)g(sum)g(of)g(all)g(input)h(data)e(falling)h(in)h(eac)n
-(h)e(output)i(pixel)427 2043 y(is)f(required,)g(then)g(this)g(\015ag)f
+(h)e(output)i(pixel)427 4876 y(is)f(required,)g(then)g(this)g(\015ag)f
(should)g(b)r(e)h(set)g(on)f(eac)n(h)g(call)g(in)h(the)g(sequence)f
-(and)g(the)h(AST)p Ft(__)p Fj(REBINEND)427 2142 y(should)i(not)g(b)r(e)
+(and)g(the)h(AST)p Ft(__)p Fj(REBINEND)427 4975 y(should)i(not)g(b)r(e)
h(used)f(on)g(the)h(last)f(call.)34 b(In)21 b(this)h(case)e(WEIGHTS)i
(and)f(NUSED)g(are)g(ignored.)33 b(This)21 b(\015ag)427
-2242 y(cannot)36 b(b)r(e)i(used)e(with)h(the)g(AST)p
+5075 y(cannot)36 b(b)r(e)i(used)e(with)h(the)g(AST)p
Ft(__)p Fj(CONSER)-9 b(VEFLUX,)36 b(AST)p Ft(__)p Fj(GENV)-9
b(AR)37 b(or)f(AST)p Ft(__)p Fj(V)-9 b(AR)g(W)n(GT)427
-2342 y(\015ag.)340 2474 y Fi(\017)45 b Fj(AST)p Ft(__)p
+5175 y(\015ag.)340 5295 y Fi(\017)45 b Fj(AST)p Ft(__)p
Fj(CONSER)-9 b(VEFLUX:)35 b(Indicates)g(that)g(the)h(normalized)e
(output)i(pixel)f(v)-5 b(alues)35 b(generated)f(b)n(y)427
-2573 y(the)k(AST)p Ft(__)p Fj(REBINEND)f(\015ag)f(should)h(b)r(e)h
+5394 y(the)k(AST)p Ft(__)p Fj(REBINEND)f(\015ag)f(should)h(b)r(e)h
(scaled)f(in)g(suc)n(h)g(a)g(w)n(a)n(y)f(as)h(to)g(preserv)n(e)e(the)j
-(total)f(data)427 2673 y(v)-5 b(alue)36 b(in)h(a)e(feature)h(on)g(the)g
+(total)f(data)427 5494 y(v)-5 b(alue)36 b(in)h(a)e(feature)h(on)g(the)g
(sky)-7 b(.)62 b(Without)37 b(this)g(\015ag,)g(eac)n(h)f(normalised)f
-(output)h(pixel)g(v)-5 b(alue)36 b(rep-)427 2772 y(resen)n(ts)42
+(output)h(pixel)g(v)-5 b(alue)36 b(rep-)427 5593 y(resen)n(ts)42
b(a)g(w)n(eigh)n(ted)f(mean)h(of)h(the)f(input)i(data)d(v)-5
b(alues)42 b(around)g(the)h(corresp)r(onding)d(input)j(p)r(osi-)427
-2872 y(tion.)53 b(\(i.e.)g(AST)p Ft(_)p Fj(REBINSEQ)p
+5693 y(tion.)53 b(\(i.e.)g(AST)p Ft(_)p Fj(REBINSEQ)p
Fl(<)p Fj(F)p Fl(>)31 b Fj(b)r(eha)n(v)n(es)h(similarly)g(to)h(AST)p
Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p Fj(\).)51 b(This)33
-b(\(i.e.)427 2972 y(AST)p Ft(_)p Fj(REBINSEQ)p Fl(<)p
-Fj(F)p Fl(>)27 b Fj(b)r(eha)n(v)n(es)h(similarly)g(to)g(AST)p
-Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p Fj(\).)39 b(This)29
-b(is)f(appropriate)f(if)427 3071 y(the)e(input)f(data)g(represen)n(ts)e
-(the)j(spatial)e(densit)n(y)h(of)g(some)f(quan)n(tit)n(y)h(\(e.g.)35
-b(surface)23 b(brigh)n(tness)g(in)i(Jan-)427 3171 y(skys)f(p)r(er)h
-(square)e(arc-second\))g(b)r(ecause)h(the)h(output)h(pixel)e(v)-5
+b(\(i.e.)p eop end
+%%Page: 340 350
+TeXDict begin 340 349 bop 0 52 a FG(340)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(AST)p
+Ft(_)p Fj(REBINSEQ)p Fl(<)p Fj(F)p Fl(>)c Fj(b)r(eha)n(v)n(es)h
+(similarly)g(to)g(AST)p Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p
+Fl(>)p Fj(\).)39 b(This)29 b(is)f(appropriate)f(if)427
+451 y(the)e(input)f(data)g(represen)n(ts)e(the)j(spatial)e(densit)n(y)h
+(of)g(some)f(quan)n(tit)n(y)h(\(e.g.)35 b(surface)23
+b(brigh)n(tness)g(in)i(Jan-)427 551 y(skys)f(p)r(er)h(square)e
+(arc-second\))g(b)r(ecause)h(the)h(output)h(pixel)e(v)-5
b(alues)25 b(will)g(ha)n(v)n(e)e(the)i(same)f(normalisation)427
-3271 y(and)h(units)h(as)f(the)g(input)i(pixel)e(v)-5
-b(alues.)36 b(Ho)n(w)n(ev)n(er,)24 b(if)h(the)h(input)g(data)f(v)-5
+650 y(and)h(units)h(as)f(the)g(input)i(pixel)e(v)-5 b(alues.)36
+b(Ho)n(w)n(ev)n(er,)24 b(if)h(the)h(input)g(data)f(v)-5
b(alues)25 b(represen)n(t)f(\015ux)h(\(or)g(some)427
-3370 y(other)e(ph)n(ysical)g(quan)n(tit)n(y\))h(p)r(er)f(pixel,)i(then)
-f(the)g(AST)p Ft(__)p Fj(CONSER)-9 b(VEFLUX)23 b(\015ag)g(could)h(b)r
-(e)g(of)g(use.)35 b(It)427 3470 y(causes)27 b(eac)n(h)g(output)h(pixel)
-g(v)-5 b(alue)27 b(to)h(b)r(e)g(scaled)f(b)n(y)g(the)h(ratio)f(of)h
-(the)g(output)g(pixel)g(size)f(to)h(the)g(input)427 3569
-y(pixel)g(size.)227 3731 y(This)38 b(\015ag)g(can)f(only)h(b)r(e)g
-(used)h(if)f(the)h(Mapping)e(is)h(successfully)g(appro)n(ximated)e(b)n
-(y)i(one)g(or)f(more)g(linear)227 3830 y(transformations.)71
-b(Th)n(us)40 b(an)f(error)f(will)h(b)r(e)i(rep)r(orted)d(if)j(it)f
-(used)f(when)h(the)g(TOL)f(argumen)n(t)g(is)g(set)h(to)227
-3930 y(zero)d(\(whic)n(h)h(stops)f(the)h(use)f(of)h(linear)f(appro)n
-(ximations\),)h(or)f(if)h(the)g(Mapping)f(is)h(to)r(o)f(non-linear)g
-(to)g(b)r(e)227 4030 y(appro)n(ximated)f(b)n(y)h(a)f(piece-wise)h
-(linear)f(transformation.)64 b(The)37 b(ratio)f(of)h(output)h(to)f
-(input)h(pixel)f(size)g(is)227 4129 y(ev)-5 b(aluated)19
-b(once)h(for)f(eac)n(h)f(panel)i(of)f(the)h(piece-wise)f(linear)g
-(appro)n(ximation)e(to)j(the)g(Mapping,)g(and)g(is)f(assumed)227
-4229 y(to)33 b(b)r(e)h(constan)n(t)f(for)g(all)g(output)g(pixels)g(in)h
-(the)g(panel.)54 b(The)33 b(scaling)f(factors)g(for)h(adjacen)n(t)g
-(panels)g(will)g(in)227 4328 y(general)f(di\013er)h(sligh)n(tly)-7
+750 y(other)e(ph)n(ysical)g(quan)n(tit)n(y\))h(p)r(er)f(pixel,)i(then)f
+(the)g(AST)p Ft(__)p Fj(CONSER)-9 b(VEFLUX)23 b(\015ag)g(could)h(b)r(e)
+g(of)g(use.)35 b(It)427 849 y(causes)27 b(eac)n(h)g(output)h(pixel)g(v)
+-5 b(alue)27 b(to)h(b)r(e)g(scaled)f(b)n(y)g(the)h(ratio)f(of)h(the)g
+(output)g(pixel)g(size)f(to)h(the)g(input)427 949 y(pixel)g(size.)227
+1128 y(This)38 b(\015ag)g(can)f(only)h(b)r(e)g(used)h(if)f(the)h
+(Mapping)e(is)h(successfully)g(appro)n(ximated)e(b)n(y)i(one)g(or)f
+(more)g(linear)227 1228 y(transformations.)71 b(Th)n(us)40
+b(an)f(error)f(will)h(b)r(e)i(rep)r(orted)d(if)j(it)f(used)f(when)h
+(the)g(TOL)f(argumen)n(t)g(is)g(set)h(to)227 1328 y(zero)d(\(whic)n(h)h
+(stops)f(the)h(use)f(of)h(linear)f(appro)n(ximations\),)h(or)f(if)h
+(the)g(Mapping)f(is)h(to)r(o)f(non-linear)g(to)g(b)r(e)227
+1427 y(appro)n(ximated)f(b)n(y)h(a)f(piece-wise)h(linear)f
+(transformation.)64 b(The)37 b(ratio)f(of)h(output)h(to)f(input)h
+(pixel)f(size)g(is)227 1527 y(ev)-5 b(aluated)19 b(once)h(for)f(eac)n
+(h)f(panel)i(of)f(the)h(piece-wise)f(linear)g(appro)n(ximation)e(to)j
+(the)g(Mapping,)g(and)g(is)f(assumed)227 1626 y(to)33
+b(b)r(e)h(constan)n(t)f(for)g(all)g(output)g(pixels)g(in)h(the)g
+(panel.)54 b(The)33 b(scaling)f(factors)g(for)h(adjacen)n(t)g(panels)g
+(will)g(in)227 1726 y(general)f(di\013er)h(sligh)n(tly)-7
b(,)34 b(and)e(so)h(the)g(join)n(ts)g(b)r(et)n(w)n(een)g(panels)f(ma)n
(y)g(b)r(e)i(visible)e(when)h(viewing)g(the)g(output)227
-4428 y(image)k(at)g(high)g(con)n(trast.)64 b(If)38 b(this)f(is)g(a)g
+1826 y(image)k(at)g(high)g(con)n(trast.)64 b(If)38 b(this)f(is)g(a)g
(problem,)i(reduce)e(the)g(v)-5 b(alue)37 b(of)g(the)h(TOL)f(argumen)n
-(t)f(un)n(til)h(the)227 4528 y(di\013erence)28 b(b)r(et)n(w)n(een)f
+(t)f(un)n(til)h(the)227 1925 y(di\013erence)28 b(b)r(et)n(w)n(een)f
(adjacen)n(t)g(panels)h(is)f(su\016cien)n(tly)h(small)f(to)g(b)r(e)h
-(insigni\014can)n(t.)227 4652 y(This)e(\015ag)e(should)h(normally)g(b)r
+(insigni\014can)n(t.)227 2059 y(This)e(\015ag)e(should)h(normally)g(b)r
(e)h(supplied)f(on)g(eac)n(h)g(in)n(v)n(o)r(cation)f(of)i(AST)p
Ft(_)p Fj(REBINSEQ)p Fl(<)p Fj(X)p Fl(>)d Fj(within)j(a)f(giv)n(en)227
-4751 y(sequence.)227 4876 y(Note,)38 b(this)e(\015ag)e(cannot)h(b)r(e)h
+2158 y(sequence.)227 2291 y(Note,)38 b(this)e(\015ag)e(cannot)h(b)r(e)h
(used)f(in)h(conjunction)g(with)g(the)f(AST)p Ft(__)p
Fj(NOSCALE)g(\015ag)g(\(an)g(error)f(will)h(b)r(e)227
-4975 y(rep)r(orted)27 b(if)h(b)r(oth)g(\015ags)f(are)f(sp)r
-(eci\014ed\).)-2 5124 y Fc(Propagation)33 b(of)e(Missing)f(Data)n(:)227
-5270 y Fj(Instances)40 b(of)h(missing)f(data)g(\(bad)h(pixels\))g(in)f
+2391 y(rep)r(orted)27 b(if)h(b)r(oth)g(\015ags)f(are)f(sp)r
+(eci\014ed\).)-2 2558 y Fc(Propagation)33 b(of)e(Missing)f(Data)n(:)227
+2704 y Fj(Instances)40 b(of)h(missing)f(data)g(\(bad)h(pixels\))g(in)f
(the)h(output)h(grid)e(are)f(iden)n(ti\014ed)i(b)n(y)g(o)r(ccurrences)e
-(of)h(the)227 5370 y(BAD)n(V)-9 b(AL)39 b(v)-5 b(alue)39
+(of)h(the)227 2804 y(BAD)n(V)-9 b(AL)39 b(v)-5 b(alue)39
b(in)f(the)h(OUT)g(arra)n(y)-7 b(.)67 b(These)38 b(are)g(only)g(pro)r
(duced)g(if)h(the)g(AST)p Ft(__)p Fj(REBINEND)f(\015ag)g(is)227
-5469 y(sp)r(eci\014ed)28 b(and)g(a)f(pixel)g(has)g(zero)g(w)n(eigh)n
-(t.)227 5593 y(An)22 b(input)h(pixel)e(is)h(considered)e(bad)i(\(and)f
+2903 y(sp)r(eci\014ed)28 b(and)g(a)f(pixel)g(has)g(zero)g(w)n(eigh)n
+(t.)227 3036 y(An)22 b(input)h(pixel)e(is)h(considered)e(bad)i(\(and)f
(is)h(consequen)n(tly)e(ignored\))h(if)h(its)g(data)f(v)-5
-b(alue)21 b(is)h(equal)f(to)g(BAD)n(V)-9 b(AL)227 5693
+b(alue)21 b(is)h(equal)f(to)g(BAD)n(V)-9 b(AL)227 3136
y(and)28 b(the)g(AST)p Ft(__)p Fj(USEBAD)f(\015ag)g(is)h(set)f(via)g
-(the)h(FLA)n(GS)g(argumen)n(t.)p eop end
-%%Page: 338 348
-TeXDict begin 338 347 bop 0 52 a FG(338)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)227 351 y Fj(In)e(addition,)f
-(asso)r(ciated)f(output)i(v)-5 b(ariance)27 b(estimates)h(\(if)i
-(calculated\))e(ma)n(y)f(b)r(e)i(declared)e(bad)i(and)f(\015agged)227
-451 y(with)g(the)g(BAD)n(V)-9 b(AL)28 b(v)-5 b(alue)28
+(the)h(FLA)n(GS)g(argumen)n(t.)227 3269 y(In)h(addition,)f(asso)r
+(ciated)f(output)i(v)-5 b(ariance)27 b(estimates)h(\(if)i(calculated\))
+e(ma)n(y)f(b)r(e)i(declared)e(bad)i(and)f(\015agged)227
+3369 y(with)g(the)g(BAD)n(V)-9 b(AL)28 b(v)-5 b(alue)28
b(in)g(the)g(OUT)p Ft(_)p Fj(V)-9 b(AR)27 b(arra)n(y)e(for)j(similar)e
-(reasons.)p 0 695 3780 12 v 0 826 a FA(AST)p Fe(_)p FA(REMAPFRAME)1659
-827 y Fd(Mo)s(dify)38 b(a)1690 941 y(F)-10 b(rame's)1519
-1041 y(relationship)36 b(to)1554 1155 y(other)h(F)-10
-b(rames)1531 1255 y(in)39 b(a)f(F)-10 b(rameSet)2436
-826 y FA(AST)p Fe(_)p FA(REMAPFRAME)0 1470 y Fc(Description:)44
-b Fj(This)39 b(routine)f(mo)r(di\014es)h(the)g(relationship)f(\(i.e.)71
-b(Mapping\))39 b(b)r(et)n(w)n(een)f(a)h(sp)r(eci\014ed)g(F)-7
-b(rame)38 b(in)h(a)227 1570 y(F)-7 b(rameSet)28 b(and)f(the)h(other)f
-(F)-7 b(rames)27 b(in)h(that)g(F)-7 b(rameSet.)227 1716
-y(T)n(ypically)g(,)31 b(this)f(migh)n(t)g(b)r(e)h(required)f(if)g(the)h
-(F)-7 b(rameSet)30 b(has)g(b)r(een)h(used)f(to)g(calibrate)g(\(sa)n
-(y\))f(an)h(image,)h(and)227 1816 y(that)h(image)e(is)h(re-binned.)48
-b(The)31 b(F)-7 b(rame)30 b(describing)h(the)g(image)g(will)g(then)h
-(ha)n(v)n(e)e(undergone)g(a)h(co)r(ordinate)227 1916
-y(transformation,)26 b(and)i(this)g(should)f(b)r(e)h(comm)n(unicated)f
-(to)h(the)g(asso)r(ciated)e(F)-7 b(rameSet)27 b(using)g(this)h
-(routine.)0 2110 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
-b(AST_REMAPFRAME\()37 b(THIS,)42 b(IFRAME,)e(MAP,)i(STATUS)f(\))0
-2304 y Fc(Argumen)m(ts:)259 2485 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 2585 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
-b(rameSet.)259 2740 y Fc(IFRAME)31 b(=)h(INTEGER)g(\(Giv)m(en\))427
-2840 y Fj(The)i(index)h(within)g(the)f(F)-7 b(rameSet)34
+(reasons.)p 0 3585 3780 12 v 0 3716 a FA(AST)p Fe(_)p
+FA(REMAPFRAME)1659 3717 y Fd(Mo)s(dify)38 b(a)1690 3832
+y(F)-10 b(rame's)1519 3931 y(relationship)36 b(to)1554
+4046 y(other)h(F)-10 b(rames)1531 4146 y(in)39 b(a)f(F)-10
+b(rameSet)2436 3716 y FA(AST)p Fe(_)p FA(REMAPFRAME)0
+4333 y Fc(Description:)44 b Fj(This)39 b(routine)f(mo)r(di\014es)h(the)
+g(relationship)f(\(i.e.)71 b(Mapping\))39 b(b)r(et)n(w)n(een)f(a)h(sp)r
+(eci\014ed)g(F)-7 b(rame)38 b(in)h(a)227 4433 y(F)-7
+b(rameSet)28 b(and)f(the)h(other)f(F)-7 b(rames)27 b(in)h(that)g(F)-7
+b(rameSet.)227 4566 y(T)n(ypically)g(,)31 b(this)f(migh)n(t)g(b)r(e)h
+(required)f(if)g(the)h(F)-7 b(rameSet)30 b(has)g(b)r(een)h(used)f(to)g
+(calibrate)g(\(sa)n(y\))f(an)h(image,)h(and)227 4666
+y(that)h(image)e(is)h(re-binned.)48 b(The)31 b(F)-7 b(rame)30
+b(describing)h(the)g(image)g(will)g(then)h(ha)n(v)n(e)e(undergone)g(a)h
+(co)r(ordinate)227 4765 y(transformation,)26 b(and)i(this)g(should)f(b)
+r(e)h(comm)n(unicated)f(to)h(the)g(asso)r(ciated)e(F)-7
+b(rameSet)27 b(using)g(this)h(routine.)0 4932 y Fc(In)m(v)m(o)s
+(cation:)123 b Ft(CALL)42 b(AST_REMAPFRAME\()37 b(THIS,)42
+b(IFRAME,)e(MAP,)i(STATUS)f(\))0 5099 y Fc(Argumen)m(ts:)259
+5253 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 5352
+y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7 b(rameSet.)259
+5494 y Fc(IFRAME)31 b(=)h(INTEGER)g(\(Giv)m(en\))427
+5593 y Fj(The)i(index)h(within)g(the)f(F)-7 b(rameSet)34
b(of)g(the)h(F)-7 b(rame)33 b(to)h(b)r(e)h(mo)r(di\014ed.)57
b(This)34 b(v)-5 b(alue)34 b(should)g(lie)g(in)g(the)427
-2939 y(range)27 b(from)g(1)g(to)g(the)h(n)n(um)n(b)r(er)g(of)f(F)-7
+5693 y(range)27 b(from)g(1)g(to)g(the)h(n)n(um)n(b)r(er)g(of)f(F)-7
b(rames)27 b(in)h(the)g(F)-7 b(rameSet)27 b(\(as)h(giv)n(en)e(b)n(y)i
-(its)f(Nframe)h(attribute\).)259 3095 y Fc(MAP)k(=)g(INTEGER)f(\(Giv)m
-(en\))427 3194 y Fj(P)n(oin)n(ter)38 b(to)i(a)f(Mapping)g(whose)g(forw)
-n(ard)f(transformation)g(con)n(v)n(erts)g(co)r(ordinate)h(v)-5
-b(alues)39 b(from)g(the)427 3294 y(original)27 b(co)r(ordinate)f
-(system)i(describ)r(ed)f(b)n(y)h(the)g(F)-7 b(rame)27
-b(to)h(the)g(new)g(one,)g(and)f(whose)g(in)n(v)n(erse)g(trans-)427
-3393 y(formation)g(con)n(v)n(erts)f(in)i(the)g(opp)r(osite)f
-(direction.)259 3549 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m
-(en)h(and)g(Returned\))427 3648 y Fj(The)c(global)e(status.)0
-3855 y Fc(Notes:)340 4182 y Fi(\017)45 b Fj(A)32 b(v)-5
+(its)f(Nframe)h(attribute\).)p eop end
+%%Page: 341 351
+TeXDict begin 341 350 bop 3643 52 a FG(341)259 351 y
+Fc(MAP)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)38
+b(to)i(a)f(Mapping)g(whose)g(forw)n(ard)f(transformation)g(con)n(v)n
+(erts)g(co)r(ordinate)h(v)-5 b(alues)39 b(from)g(the)427
+551 y(original)27 b(co)r(ordinate)f(system)i(describ)r(ed)f(b)n(y)h
+(the)g(F)-7 b(rame)27 b(to)h(the)g(new)g(one,)g(and)f(whose)g(in)n(v)n
+(erse)g(trans-)427 650 y(formation)g(con)n(v)n(erts)f(in)i(the)g(opp)r
+(osite)f(direction.)259 810 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f
+(\(Giv)m(en)h(and)g(Returned\))427 910 y Fj(The)c(global)e(status.)0
+1126 y Fc(Notes:)340 1464 y Fi(\017)45 b Fj(A)32 b(v)-5
b(alue)31 b(of)g(AST)p Ft(__)p Fj(BASE)f(or)g(AST)p Ft(__)p
Fj(CURRENT)h(ma)n(y)g(b)r(e)g(giv)n(en)f(for)h(the)g(IFRAME)h(argumen)n
-(t)e(to)427 4282 y(sp)r(ecify)e(the)g(base)f(F)-7 b(rame)27
+(t)e(to)427 1563 y(sp)r(ecify)e(the)g(base)f(F)-7 b(rame)27
b(or)g(the)h(curren)n(t)f(F)-7 b(rame)27 b(resp)r(ectiv)n(ely)-7
-b(.)340 4437 y Fi(\017)45 b Fj(The)29 b(relationship)e(b)r(et)n(w)n
+b(.)340 1723 y Fi(\017)45 b Fj(The)29 b(relationship)e(b)r(et)n(w)n
(een)h(the)h(selected)f(F)-7 b(rame)28 b(and)g(an)n(y)g(other)g(F)-7
b(rame)28 b(within)h(the)f(F)-7 b(rameSet)28 b(will)427
-4537 y(b)r(e)j(mo)r(di\014ed)g(b)n(y)g(this)f(routine,)h(but)h(the)f
+1823 y(b)r(e)j(mo)r(di\014ed)g(b)n(y)g(this)f(routine,)h(but)h(the)f
(relationship)e(b)r(et)n(w)n(een)i(all)f(other)g(F)-7
-b(rames)30 b(in)h(the)g(F)-7 b(rameSet)427 4636 y(remains)27
-b(unc)n(hanged.)340 4792 y Fi(\017)45 b Fj(The)27 b(n)n(um)n(b)r(er)g
+b(rames)30 b(in)h(the)g(F)-7 b(rameSet)427 1923 y(remains)27
+b(unc)n(hanged.)340 2083 y Fi(\017)45 b Fj(The)27 b(n)n(um)n(b)r(er)g
(of)g(input)h(co)r(ordinate)e(v)-5 b(alues)27 b(accepted)g(b)n(y)f(the)
i(Mapping)f(\(its)g(Nin)h(attribute\))f(and)g(the)427
-4891 y(n)n(um)n(b)r(er)j(of)g(output)g(co)r(ordinate)f(v)-5
+2182 y(n)n(um)n(b)r(er)j(of)g(output)g(co)r(ordinate)f(v)-5
b(alues)30 b(generated)f(\(its)h(Nout)g(attribute\))h(m)n(ust)f(b)r(e)g
-(equal)g(and)f(m)n(ust)427 4991 y(matc)n(h)f(the)g(n)n(um)n(b)r(er)f
+(equal)g(and)f(m)n(ust)427 2282 y(matc)n(h)f(the)g(n)n(um)n(b)r(er)f
(of)h(axes)e(in)i(the)g(F)-7 b(rame)27 b(b)r(eing)h(mo)r(di\014ed.)340
-5146 y Fi(\017)45 b Fj(If)26 b(a)f(simple)h(c)n(hange)e(of)i(axis)f
+2442 y Fi(\017)45 b Fj(If)26 b(a)f(simple)h(c)n(hange)e(of)i(axis)f
(order)f(is)h(required,)g(then)h(the)g(AST)p Ft(_)p Fj(PERMAXES)f
-(routine)g(ma)n(y)g(pro)n(vide)427 5246 y(a)i(more)g(straigh)n(tforw)n
+(routine)g(ma)n(y)g(pro)n(vide)427 2542 y(a)i(more)g(straigh)n(tforw)n
(ard)e(metho)r(d)j(of)g(making)e(the)i(required)f(c)n(hanges)f(to)i
-(the)g(F)-7 b(rameSet.)340 5401 y Fi(\017)45 b Fj(This)34
+(the)g(F)-7 b(rameSet.)340 2702 y Fi(\017)45 b Fj(This)34
b(routine)f(cannot)g(b)r(e)h(used)f(to)h(c)n(hange)e(the)i(n)n(um)n(b)r
(er)f(of)h(F)-7 b(rame)33 b(axes.)54 b(T)-7 b(o)33 b(ac)n(hiev)n(e)f
-(this,)j(a)f(new)427 5500 y(F)-7 b(rame)26 b(m)n(ust)g(b)r(e)h(added)f
+(this,)j(a)f(new)427 2802 y(F)-7 b(rame)26 b(m)n(ust)g(b)r(e)h(added)f
(to)g(the)g(F)-7 b(rameSet)26 b(\(AST)p Ft(_)p Fj(ADDFRAME\))i(and)e
-(the)g(original)f(one)h(remo)n(v)n(ed)e(if)427 5600 y(necessary)i
-(\(AST)p Ft(_)p Fj(REMO)n(VEFRAME\).)p eop end
-%%Page: 339 349
-TeXDict begin 339 348 bop 3643 52 a FG(339)p 0 351 3780
-12 v 0 482 a FA(AST)p Fe(_)p FA(REMO)l(VECOLUMN)1702
-500 y Fd(Remo)m(v)m(e)1860 599 y(a)1704 699 y(column)1722
-798 y(from)38 b(a)1763 898 y(table)2230 482 y FA(AST)p
-Fe(_)p FA(REMO)l(VECOLUMN)0 1046 y Fc(Description:)44
+(the)g(original)f(one)h(remo)n(v)n(ed)e(if)427 2901 y(necessary)i
+(\(AST)p Ft(_)p Fj(REMO)n(VEFRAME\).)340 3061 y Fi(\017)45
+b Fj(An)n(y)28 b(v)-5 b(arian)n(t)28 b(Mappings)f(asso)r(ciated)g(with)
+h(the)h(remapp)r(ed)f(F)-7 b(rame)28 b(\(except)g(for)g(the)g(curren)n
+(t)f(v)-5 b(arian)n(t\))427 3161 y(will)28 b(b)r(e)g(lost)f(as)g(a)g
+(consequence)g(of)h(calling)f(this)g(metho)r(d)i(\(see)e(attribute)h
+Ft(")p Fj(V)-7 b(arian)n(t)p Ft(")p Fj(\).)p 0 3415 3780
+12 v 0 3546 a FA(AST)p Fe(_)p FA(REMO)l(VECOLUMN)1702
+3563 y Fd(Remo)m(v)m(e)1860 3663 y(a)1704 3763 y(column)1722
+3862 y(from)38 b(a)1763 3962 y(table)2230 3546 y FA(AST)p
+Fe(_)p FA(REMO)l(VECOLUMN)0 4182 y Fc(Description:)44
b Fj(This)34 b(function)f(remo)n(v)n(es)e(a)i(sp)r(eci\014ed)h(column)f
(from)g(the)g(supplied)h(table.)53 b(The)34 b(routine)e(returns)227
-1146 y(without)c(action)f(if)h(the)g(named)g(column)g(do)r(es)f(not)g
+4282 y(without)c(action)f(if)h(the)g(named)g(column)g(do)r(es)f(not)g
(exist)h(in)g(the)g(T)-7 b(able)27 b(\(no)h(error)d(is)j(rep)r
-(orted\).)0 1286 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
+(orted\).)0 4486 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
b(AST_REMOVECOLUM)o(N\()37 b(THIS,)42 b(NAME,)f(STATUS)g(\))0
-1427 y Fc(Argumen)m(ts:)259 1555 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 1654 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(T)-7
-b(able.)259 1778 y Fc(NAME)31 b(=)h(CHARA)m(CTER)g Fi(\003)f
-Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1878 y Fj(The)38
+4690 y Fc(Argumen)m(ts:)259 4881 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 4981 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(T)-7
+b(able.)259 5141 y Fc(NAME)31 b(=)h(CHARA)m(CTER)g Fi(\003)f
+Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427 5240 y Fj(The)38
b(column)f(name.)66 b(T)-7 b(railing)36 b(spaces)g(are)h(ignored)f
(\(all)h(other)g(spaces)f(are)h(signi\014can)n(t\).)65
-b(Case)37 b(is)427 1977 y(signi\014can)n(t.)259 2102
+b(Case)37 b(is)427 5340 y(signi\014can)n(t.)259 5500
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 2201 y Fj(The)c(global)e(status.)p 0 2383 V 0 2513
-a FA(AST)p Fe(_)p FA(REMO)l(VEFRAME)201 b Fd(Remo)m(v)m(e)38
-b(a)1591 2613 y(F)-10 b(rame)39 b(from)1600 2712 y(a)f(F)-10
-b(rameSet)2343 2513 y FA(AST)p Fe(_)p FA(REMO)l(VEFRAME)0
-2860 y Fc(Description:)44 b Fj(This)30 b(routine)f(remo)n(v)n(es)e(a)i
+427 5600 y Fj(The)c(global)e(status.)p eop end
+%%Page: 342 352
+TeXDict begin 342 351 bop 0 52 a FG(342)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(REMO)l(VEFRAME)201 b Fd(Remo)m(v)m(e)38
+b(a)1591 581 y(F)-10 b(rame)39 b(from)1600 681 y(a)f(F)-10
+b(rameSet)2343 482 y FA(AST)p Fe(_)p FA(REMO)l(VEFRAME)0
+854 y Fc(Description:)44 b Fj(This)30 b(routine)f(remo)n(v)n(es)e(a)i
(F)-7 b(rame)29 b(from)g(a)g(F)-7 b(rameSet.)41 b(All)30
b(other)f(F)-7 b(rames)28 b(in)i(the)g(F)-7 b(rameSet)29
-b(ha)n(v)n(e)227 2960 y(their)f(indices)f(re-n)n(um)n(b)r(ered)g(from)g
+b(ha)n(v)n(e)227 953 y(their)f(indices)f(re-n)n(um)n(b)r(ered)g(from)g
(one)g(\(if)i(necessary\),)d(but)i(are)f(otherwise)f(unc)n(hanged.)0
-3101 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_REMOVEFRAME)o(\()
-c(THIS,)j(IFRAME,)g(STATUS)g(\))0 3241 y Fc(Argumen)m(ts:)259
-3369 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 3469
+1110 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_REMOVEFRAME)o(\()
+c(THIS,)j(IFRAME,)g(STATUS)g(\))0 1266 y Fc(Argumen)m(ts:)259
+1410 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1509
y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7 b(rameSet.)259
-3593 y Fc(IFRAME)31 b(=)h(INTEGER)g(\(Giv)m(en\))427
-3692 y Fj(The)j(index)g(within)g(the)g(F)-7 b(rameSet)34
+1646 y Fc(IFRAME)31 b(=)h(INTEGER)g(\(Giv)m(en\))427
+1745 y Fj(The)j(index)g(within)g(the)g(F)-7 b(rameSet)34
b(of)h(the)g(F)-7 b(rame)34 b(to)h(b)r(e)g(remo)n(v)n(ed.)56
b(This)35 b(v)-5 b(alue)34 b(should)h(lie)f(in)h(the)427
-3792 y(range)27 b(from)g(1)g(to)g(the)h(n)n(um)n(b)r(er)g(of)f(F)-7
+1845 y(range)27 b(from)g(1)g(to)g(the)h(n)n(um)n(b)r(er)g(of)f(F)-7
b(rames)27 b(in)h(the)g(F)-7 b(rameSet)27 b(\(as)h(giv)n(en)e(b)n(y)i
-(its)f(Nframe)h(attribute\).)259 3916 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 4016
-y Fj(The)c(global)e(status.)0 4169 y Fc(Notes:)340 4442
+(its)f(Nframe)h(attribute\).)259 1981 y Fc(ST)-8 b(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 2081
+y Fj(The)c(global)e(status.)0 2250 y Fc(Notes:)340 2539
y Fi(\017)45 b Fj(Remo)n(ving)31 b(a)g(F)-7 b(rame)31
b(from)g(a)g(F)-7 b(rameSet)32 b(do)r(es)f(not)h(a\013ect)f(the)h
(relationship)f(b)r(et)n(w)n(een)g(other)g(F)-7 b(rames)427
-4542 y(in)28 b(the)g(F)-7 b(rameSet,)28 b(ev)n(en)f(if)h(they)g
+2639 y(in)28 b(the)g(F)-7 b(rameSet,)28 b(ev)n(en)f(if)h(they)g
(originally)d(dep)r(ended)k(on)e(the)h(F)-7 b(rame)27
-b(b)r(eing)h(remo)n(v)n(ed.)340 4666 y Fi(\017)45 b Fj(The)31
+b(b)r(eing)h(remo)n(v)n(ed.)340 2775 y Fi(\017)45 b Fj(The)31
b(n)n(um)n(b)r(er)g(of)g(F)-7 b(rames)30 b(in)i(a)e(F)-7
b(rameSet)31 b(cannot)g(b)r(e)g(reduced)g(to)g(zero.)46
-b(An)31 b(error)e(will)j(result)e(if)i(an)427 4766 y(attempt)d(is)e
+b(An)31 b(error)e(will)j(result)e(if)i(an)427 2875 y(attempt)d(is)e
(made)g(to)h(remo)n(v)n(e)e(the)i(only)f(remaining)g(F)-7
-b(rame.)340 4890 y Fi(\017)45 b Fj(A)32 b(v)-5 b(alue)31
+b(rame.)340 3011 y Fi(\017)45 b Fj(A)32 b(v)-5 b(alue)31
b(of)g(AST)p Ft(__)p Fj(BASE)f(or)g(AST)p Ft(__)p Fj(CURRENT)h(ma)n(y)g
(b)r(e)g(giv)n(en)f(for)h(the)g(IFRAME)h(argumen)n(t)e(to)427
-4989 y(sp)r(ecify)e(the)g(base)f(F)-7 b(rame)27 b(or)g(the)h(curren)n
-(t)f(F)-7 b(rame)27 b(resp)r(ectiv)n(ely)-7 b(.)340 5113
+3111 y(sp)r(ecify)e(the)g(base)f(F)-7 b(rame)27 b(or)g(the)h(curren)n
+(t)f(F)-7 b(rame)27 b(resp)r(ectiv)n(ely)-7 b(.)340 3247
y Fi(\017)45 b Fj(If)22 b(a)f(F)-7 b(rameSet's)21 b(base)f(or)h(curren)
n(t)f(F)-7 b(rame)21 b(is)g(remo)n(v)n(ed,)g(the)g(Base)g(or)f(Curren)n
-(t)h(attribute)g(\(resp)r(ectiv)n(ely\))427 5213 y(of)30
+(t)h(attribute)g(\(resp)r(ectiv)n(ely\))427 3347 y(of)30
b(the)g(F)-7 b(rameSet)30 b(will)g(ha)n(v)n(e)f(its)h(v)-5
b(alue)30 b(cleared,)f(so)g(that)i(another)d(F)-7 b(rame)30
-b(will)g(then)g(assume)f(its)i(role)427 5313 y(b)n(y)d(default.)340
-5437 y Fi(\017)45 b Fj(If)26 b(an)n(y)f(other)g(F)-7
+b(will)g(then)g(assume)f(its)i(role)427 3447 y(b)n(y)d(default.)340
+3583 y Fi(\017)45 b Fj(If)26 b(an)n(y)f(other)g(F)-7
b(rame)25 b(is)g(remo)n(v)n(ed,)f(the)i(base)f(and)g(curren)n(t)g(F)-7
b(rames)24 b(will)i(remain)f(the)h(same.)35 b(T)-7 b(o)25
-b(ensure)427 5536 y(this,)37 b(the)d(Base)g(and/or)e(Curren)n(t)i
+b(ensure)427 3683 y(this,)37 b(the)d(Base)g(and/or)e(Curren)n(t)i
(attributes)g(of)g(the)h(F)-7 b(rameSet)34 b(will)h(b)r(e)f(c)n
-(hanged,)i(if)e(necessary)-7 b(,)35 b(to)427 5636 y(re\015ect)28
+(hanged,)i(if)e(necessary)-7 b(,)35 b(to)427 3782 y(re\015ect)28
b(an)n(y)e(c)n(hange)h(in)h(the)g(indices)f(of)h(these)f(F)-7
-b(rames.)p eop end
-%%Page: 340 350
-TeXDict begin 340 349 bop 0 52 a FG(340)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(REMO)l(VEP)-11 b(ARAMETER)1966
-500 y Fd(Remo)m(v)m(e)1966 599 y(a)1966 699 y(global)1966
-798 y(pa-)1966 898 y(ram-)1966 998 y(e-)1966 1097 y(ter)1966
-1197 y(from)1966 1297 y(a)1966 1396 y(ta-)1966 1496 y(ble)2116
-482 y FA(AST)p Fe(_)p FA(REMO)l(VEP)g(ARAMETER)0 1660
-y Fc(Description:)44 b Fj(This)29 b(function)g(remo)n(v)n(es)e(a)h(sp)r
-(eci\014ed)h(global)e(parameter)g(from)i(the)g(supplied)g(table.)39
-b(The)29 b(routine)227 1760 y(returns)e(without)h(action)f(if)h(the)g
-(named)g(parameter)e(do)r(es)h(not)h(exist)f(in)h(the)g(T)-7
-b(able)27 b(\(no)h(error)e(is)h(rep)r(orted\).)0 1909
+b(rames.)p 0 3989 V 0 4119 a FA(AST)p Fe(_)p FA(REMO)l(VEP)c(ARAMETER)
+1966 4137 y Fd(Remo)m(v)m(e)1966 4237 y(a)1966 4336 y(global)1966
+4436 y(pa-)1966 4535 y(ram-)1966 4635 y(e-)1966 4735
+y(ter)1966 4834 y(from)1966 4934 y(a)1966 5034 y(ta-)1966
+5133 y(ble)2116 4119 y FA(AST)p Fe(_)p FA(REMO)l(VEP)g(ARAMETER)0
+5306 y Fc(Description:)44 b Fj(This)29 b(function)g(remo)n(v)n(es)e(a)h
+(sp)r(eci\014ed)h(global)e(parameter)g(from)i(the)g(supplied)g(table.)
+39 b(The)29 b(routine)227 5405 y(returns)e(without)h(action)f(if)h(the)
+g(named)g(parameter)e(do)r(es)h(not)h(exist)f(in)h(the)g(T)-7
+b(able)27 b(\(no)h(error)e(is)h(rep)r(orted\).)0 5562
y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_REMOVEPARAM)o(ETE)o
-(R\()37 b(THIS,)42 b(NAME,)f(STATUS)g(\))0 2058 y Fc(Argumen)m(ts:)259
-2194 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 2293
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(T)-7 b(able.)259 2425
-y Fc(NAME)31 b(=)h(CHARA)m(CTER)g Fi(\003)f Fc(\()h Fi(\003)f
-Fc(\))h(\(Giv)m(en\))427 2525 y Fj(The)f(parameter)f(name.)47
-b(T)-7 b(railing)30 b(spaces)g(are)g(ignored)g(\(all)h(other)g(spaces)f
-(are)g(signi\014can)n(t\).)46 b(Case)31 b(is)427 2625
-y(signi\014can)n(t.)259 2757 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 2857
-y Fj(The)c(global)e(status.)p 0 3055 V 0 3185 a FA(AST)p
-Fe(_)p FA(REMO)l(VEREGIONS)1712 3203 y Fd(Remo)m(v)m(e)1799
-3303 y(an)m(y)1801 3416 y(Re-)1759 3516 y(gions)1722
-3630 y(from)38 b(a)1755 3730 y(Map-)1779 3841 y(ping)2220
-3185 y FA(AST)p Fe(_)p FA(REMO)l(VEREGIONS)0 4033 y Fc(Description:)44
-b Fj(This)33 b(function)g(searc)n(hes)e(the)i(suppliedMapping)g(\(whic)
-n(h)g(ma)n(y)f(b)r(e)h(a)f(comp)r(ound)h(Mapping)f(suc)n(h)227
-4133 y(as)d(a)g(CmpMap\))g(for)g(an)n(y)f(comp)r(onen)n(t)h(Mappings)g
-(that)g(are)f(instances)h(of)g(the)h(AST)f(Region)g(class.)41
-b(It)29 b(then)227 4232 y(creates)f(a)h(new)g(Mapping)f(from)h(whic)n
-(h)g(all)f(Regions)g(ha)n(v)n(e)g(b)r(een)h(remo)n(v)n(ed.)40
-b(If)29 b(a)f(Region)h(cannot)f(simply)h(b)r(e)227 4332
-y(remo)n(v)n(ed)34 b(\(for)i(instance,)h(if)f(it)g(is)f(a)g(comp)r
+(R\()37 b(THIS,)42 b(NAME,)f(STATUS)g(\))0 5718 y Fc(Argumen)m(ts:)p
+eop end
+%%Page: 343 353
+TeXDict begin 343 352 bop 3643 52 a FG(343)259 351 y
+Fc(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(T)-7 b(able.)259 584 y Fc(NAME)31 b(=)h(CHARA)m(CTER)g
+Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
+683 y Fj(The)f(parameter)f(name.)47 b(T)-7 b(railing)30
+b(spaces)g(are)g(ignored)g(\(all)h(other)g(spaces)f(are)g(signi\014can)
+n(t\).)46 b(Case)31 b(is)427 783 y(signi\014can)n(t.)259
+915 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 1015 y Fj(The)c(global)e(status.)p 0
+1214 3780 12 v 0 1345 a FA(AST)p Fe(_)p FA(REMO)l(VEREGIONS)1712
+1362 y Fd(Remo)m(v)m(e)1799 1462 y(an)m(y)1801 1575 y(Re-)1759
+1675 y(gions)1722 1789 y(from)38 b(a)1755 1889 y(Map-)1779
+2000 y(ping)2220 1345 y FA(AST)p Fe(_)p FA(REMO)l(VEREGIONS)0
+2193 y Fc(Description:)44 b Fj(This)33 b(function)g(searc)n(hes)e(the)i
+(suppliedMapping)g(\(whic)n(h)g(ma)n(y)f(b)r(e)h(a)f(comp)r(ound)h
+(Mapping)f(suc)n(h)227 2293 y(as)d(a)g(CmpMap\))g(for)g(an)n(y)f(comp)r
+(onen)n(t)h(Mappings)g(that)g(are)f(instances)h(of)g(the)h(AST)f
+(Region)g(class.)41 b(It)29 b(then)227 2392 y(creates)f(a)h(new)g
+(Mapping)f(from)h(whic)n(h)g(all)f(Regions)g(ha)n(v)n(e)g(b)r(een)h
+(remo)n(v)n(ed.)40 b(If)29 b(a)f(Region)h(cannot)f(simply)h(b)r(e)227
+2492 y(remo)n(v)n(ed)34 b(\(for)i(instance,)h(if)f(it)g(is)f(a)g(comp)r
(onen)n(t)h(of)f(a)g(parallel)g(CmpMap\),)j(then)e(it)g(is)f(replaced)g
-(with)h(an)227 4431 y(equiv)-5 b(alen)n(t)28 b(UnitMap)g(in)g(the)g
-(returned)f(Mapping.)0 4580 y Fc(In)m(v)m(o)s(cation:)123
+(with)h(an)227 2592 y(equiv)-5 b(alen)n(t)28 b(UnitMap)g(in)g(the)g
+(returned)f(Mapping.)0 2741 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_REMOVEREGION)o(S\()37 b(THIS,)42
-b(STATUS)f(\))0 4729 y Fc(Argumen)m(ts:)259 4865 y(THIS)32
-b(=)g(INTEGER)g(\(Giv)m(en\))427 4965 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(original)e(Mapping.)259 5097 y Fc(ST)-8
+b(STATUS)f(\))0 2890 y Fc(Argumen)m(ts:)259 3026 y(THIS)32
+b(=)g(INTEGER)g(\(Giv)m(en\))427 3126 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(original)e(Mapping.)259 3259 y Fc(ST)-8
b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-5197 y Fj(The)c(global)e(status.)0 5358 y Fc(Class)31
-b(Applicabilit)m(y:)259 5494 y(CmpF)-8 b(rame)427 5593
+3358 y Fj(The)c(global)e(status.)0 3520 y Fc(Class)31
+b(Applicabilit)m(y:)259 3656 y(CmpF)-8 b(rame)427 3756
y Fj(If)35 b(the)f(supplied)g(Mapping)g(is)g(a)f(CmpF)-7
b(rame,)36 b(an)n(y)d(comp)r(onen)n(t)g(F)-7 b(rames)34
-b(that)g(are)f(instances)g(of)h(the)427 5693 y(Region)27
+b(that)g(are)f(instances)g(of)h(the)427 3856 y(Region)27
b(class)g(are)f(replaced)h(b)n(y)g(the)h(equiv)-5 b(alen)n(t)28
-b(F)-7 b(rame.)p eop end
-%%Page: 341 351
-TeXDict begin 341 350 bop 3643 52 a FG(341)259 351 y
-Fc(F)-8 b(rameSet)427 451 y Fj(If)29 b(the)f(supplied)g(Mapping)g(is)f
-(a)h(F)-7 b(rameSet,)28 b(the)g(returned)g(Mapping)f(will)h(b)r(e)h(a)e
-(cop)n(y)g(of)h(the)g(supplied)427 551 y(F)-7 b(rameSet)29
-b(in)g(whic)n(h)g(Regions)f(ha)n(v)n(e)g(b)r(een)i(remo)n(v)n(ed)d
-(from)i(all)g(the)g(in)n(ter-F)-7 b(rame)28 b(Mappings,)h(and)f(an)n(y)
-427 650 y(F)-7 b(rames)27 b(whic)n(h)h(are)e(instances)h(of)h(the)g
-(Region)f(class)f(are)h(repalced)g(b)n(y)g(the)h(equiv)-5
-b(alen)n(t)27 b(F)-7 b(rame.)259 784 y Fc(Mapping)427
-884 y Fj(This)28 b(function)g(applies)f(to)h(all)f(Mappings.)259
-1017 y Fc(Region)427 1117 y Fj(If)h(the)g(supplied)g(Mapping)f(is)h(a)f
+b(F)-7 b(rame.)259 3988 y Fc(F)f(rameSet)427 4088 y Fj(If)29
+b(the)f(supplied)g(Mapping)g(is)f(a)h(F)-7 b(rameSet,)28
+b(the)g(returned)g(Mapping)f(will)h(b)r(e)h(a)e(cop)n(y)g(of)h(the)g
+(supplied)427 4187 y(F)-7 b(rameSet)29 b(in)g(whic)n(h)g(Regions)f(ha)n
+(v)n(e)g(b)r(een)i(remo)n(v)n(ed)d(from)i(all)g(the)g(in)n(ter-F)-7
+b(rame)28 b(Mappings,)h(and)f(an)n(y)427 4287 y(F)-7
+b(rames)27 b(whic)n(h)h(are)e(instances)h(of)h(the)g(Region)f(class)f
+(are)h(repalced)g(b)n(y)g(the)h(equiv)-5 b(alen)n(t)27
+b(F)-7 b(rame.)259 4420 y Fc(Mapping)427 4519 y Fj(This)28
+b(function)g(applies)f(to)h(all)f(Mappings.)259 4652
+y Fc(Region)427 4752 y Fj(If)h(the)g(supplied)g(Mapping)f(is)h(a)f
(Region,)g(the)h(returned)f(Mapping)g(will)h(b)r(e)g(the)g(equiv)-5
-b(alen)n(t)28 b(F)-7 b(rame.)0 1281 y Fc(Returned)32
-b(V)-8 b(alue:)259 1419 y(AST)p Ft(_)p Fc(REMO)m(VEREGIONS)30
-b(=)i(INTEGER)427 1519 y Fj(A)c(new)g(p)r(oin)n(ter)f(to)h(the)g(\(p)r
-(ossibly)f(mo)r(di\014ed\))h(Mapping.)0 1683 y Fc(Notes:)340
-1968 y Fi(\017)45 b Fj(This)22 b(function)f(can)g(safely)g(b)r(e)h
+b(alen)n(t)28 b(F)-7 b(rame.)0 4913 y Fc(Returned)32
+b(V)-8 b(alue:)259 5050 y(AST)p Ft(_)p Fc(REMO)m(VEREGIONS)30
+b(=)i(INTEGER)427 5149 y Fj(A)c(new)g(p)r(oin)n(ter)f(to)h(the)g(\(p)r
+(ossibly)f(mo)r(di\014ed\))h(Mapping.)0 5311 y Fc(Notes:)340
+5593 y Fi(\017)45 b Fj(This)22 b(function)f(can)g(safely)g(b)r(e)h
(applied)f(ev)n(en)g(to)g(Mappings)f(whic)n(h)i(con)n(tain)e(no)h
-(Regions.)34 b(If)22 b(no)f(Regions)427 2067 y(are)f(found,)i(it)f(b)r
+(Regions.)34 b(If)22 b(no)f(Regions)427 5693 y(are)f(found,)i(it)f(b)r
(eha)n(v)n(es)e(exactly)h(lik)n(e)g(AST)p Ft(_)p Fj(CLONE)f(and)h
-(returns)g(a)g(p)r(oin)n(ter)g(to)g(the)h(original)e(Mapping.)340
-2201 y Fi(\017)45 b Fj(The)26 b(Mapping)f(returned)g(b)n(y)g(this)h
-(function)g(ma)n(y)e(not)i(b)r(e)g(indep)r(enden)n(t)g(of)f(the)h
-(original)e(\(ev)n(en)h(if)h(some)427 2301 y(Regions)37
-b(w)n(ere)g(remo)n(v)n(ed\),)i(and)f(mo)r(difying)g(it)g(ma)n(y)f
-(therefore)g(result)g(in)h(indirect)g(mo)r(di\014cation)g(of)427
-2400 y(the)e(original.)58 b(If)35 b(a)g(completely)g(indep)r(enden)n(t)
-h(result)f(is)g(required,)h(a)f(cop)n(y)f(should)h(b)r(e)h(made)f
-(using)427 2500 y(AST)p Ft(_)p Fj(COPY.)340 2634 y Fi(\017)45
-b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
-Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 2733
-y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 2935 3780 12 v 0 3065
-a FA(AST)p Fe(_)p FA(REMO)l(VER)l(O)l(W)260 b Fd(Remo)m(v)m(e)38
-b(a)g(ro)m(w)1576 3165 y(from)f(a)i(table)2512 3065 y
-FA(AST)p Fe(_)p FA(REMO)l(VER)l(O)l(W)0 3332 y Fc(Description:)44
-b Fj(This)20 b(function)g(remo)n(v)n(es)d(a)j(sp)r(eci\014ed)f(ro)n(w)g
-(from)g(the)h(supplied)g(table.)34 b(The)19 b(routine)g(returns)g
-(without)227 3432 y(action)27 b(if)h(the)g(ro)n(w)f(do)r(es)g(not)h
-(exist)f(in)h(the)g(T)-7 b(able)27 b(\(no)h(error)e(is)h(rep)r
-(orted\).)0 3583 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
-b(AST_REMOVEROW\()37 b(THIS,)42 b(INDEX,)f(STATUS)g(\))0
-3735 y Fc(Argumen)m(ts:)259 3873 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 3973 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(T)-7
-b(able.)259 4107 y Fc(INDEX)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
-4206 y Fj(The)d(index)g(of)f(the)h(ro)n(w)f(to)g(b)r(e)h(remo)n(v)n
-(ed.)35 b(The)28 b(\014rst)f(ro)n(w)g(has)g(index)g(1.)259
-4340 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 4440 y Fj(The)c(global)e(status.)p 0
-4641 V 0 4772 a FA(AST)p Fe(_)p FA(REMO)l(VET)-11 b(ABLES)228
-b Fd(Remo)m(v)m(e)1730 4871 y(one)39 b(or)1763 4971 y(more)1740
-5070 y(tables)1722 5170 y(from)f(a)1653 5270 y(FitsChan)2322
-4772 y FA(AST)p Fe(_)p FA(REMO)l(VET)-11 b(ABLES)0 5442
-y Fc(Description:)44 b Fj(This)d(routine)f(remo)n(v)n(es)f(the)i(named)
-f(tables)g(from)h(the)f(FitsChan,)k(it)d(they)g(exist)g(\(no)f(error)f
-(is)227 5542 y(rep)r(orted)27 b(if)h(an)n(y)f(the)h(tables)f(do)h(not)f
-(exist\).)0 5693 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
-b(AST_REMOVETABLE)o(S\()37 b(THIS,)42 b(KEY,)g(STATUS)f(\))p
+(returns)g(a)g(p)r(oin)n(ter)g(to)g(the)h(original)e(Mapping.)p
eop end
-%%Page: 342 352
-TeXDict begin 342 351 bop 0 52 a FG(342)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Argumen)m(ts:)259
-483 y(THIS)h(=)g(INTEGER)g(\(Giv)m(en\))427 583 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(FitsChan.)259 711 y Fc(KEY)k(=)g(CHARA)m(CTER)f
-Fi(\003)h Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-810 y Fj(The)c(k)n(ey)e(indicating)h(whic)n(h)g(tables)g(to)g(exist.)37
-b(A)27 b(single)g(k)n(ey)f(or)h(a)f(comma-separated)f(list)j(of)f(k)n
-(eys)f(can)427 910 y(b)r(e)i(supplied.)37 b(If)29 b(a)e(blank)g(string)
-g(is)g(supplied,)h(all)g(tables)f(are)g(remo)n(v)n(ed.)259
-1038 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 1137 y Fj(The)c(global)e(status.)p 0
-1327 3780 12 v 0 1458 a FA(AST)p Fe(_)p FA(RESAMPLE)p
-Fb(<)p FA(X)p Fb(>)1596 1459 y Fd(Resample)38 b(a)1618
-1573 y(region)f(of)i(a)1656 1688 y(data)e(grid)2411 1458
-y FA(AST)p Fe(_)p FA(RESAMPLE)p Fb(<)p FA(X)p Fb(>)0
-1872 y Fc(Description:)44 b Fj(This)31 b(is)g(a)f(set)h(of)g(functions)
-g(for)f(resampling)g(gridded)g(data)h(\(e.g.)46 b(an)31
-b(image\))f(under)h(the)g(con)n(trol)227 1971 y(of)c(a)e(geometrical)g
-(transformation,)g(whic)n(h)h(is)g(sp)r(eci\014ed)h(b)n(y)f(a)g
-(Mapping.)36 b(The)26 b(functions)h(op)r(erate)e(on)h(a)g(pair)227
-2071 y(of)i(data)f(grids)f(\(input)j(and)f(output\),)g(eac)n(h)f(of)g
-(whic)n(h)h(ma)n(y)f(ha)n(v)n(e)f(an)n(y)h(n)n(um)n(b)r(er)g(of)h
-(dimensions.)36 b(Resampling)227 2171 y(ma)n(y)c(b)r(e)g(restricted)g
-(to)g(a)g(sp)r(eci\014ed)h(region)d(of)j(the)f(output)h(grid.)50
-b(An)33 b(asso)r(ciated)e(grid)g(of)i(error)d(estimates)227
-2270 y(asso)r(ciated)36 b(with)h(the)g(input)h(data)e(ma)n(y)g(also)g
-(b)r(e)h(supplied)g(\(in)g(the)h(form)e(of)h(v)-5 b(ariance)35
-b(v)-5 b(alues\),)39 b(so)e(as)f(to)227 2370 y(pro)r(duce)29
-b(error)f(estimates)h(for)g(the)h(resampled)e(output)i(data.)42
-b(Propagation)27 b(of)i(missing)g(data)g(\(bad)h(pixels\))227
-2470 y(is)e(supp)r(orted.)227 2592 y(Y)-7 b(ou)29 b(should)g(use)g(a)f
-(resampling)g(function)h(whic)n(h)g(matc)n(hes)g(the)g(n)n(umerical)f
-(t)n(yp)r(e)h(of)g(the)g(data)g(y)n(ou)f(are)g(pro-)227
-2691 y(cessing)c(b)n(y)h(replacing)f Fl(<)p Fj(X)p Fl(>)g
-Fj(in)h(the)h(generic)d(function)j(name)f(AST)p Ft(_)p
-Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)e Fj(b)n(y)i(an)f(appropriate)227
-2791 y(1-)i(or)f(2-c)n(haracter)f(t)n(yp)r(e)j(co)r(de.)36
+%%Page: 344 354
+TeXDict begin 344 353 bop 0 52 a FG(344)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(The)26 b(Mapping)f(returned)g(b)n(y)g(this)h(function)g(ma)n(y)e
+(not)i(b)r(e)g(indep)r(enden)n(t)g(of)f(the)h(original)e(\(ev)n(en)h
+(if)h(some)427 451 y(Regions)37 b(w)n(ere)g(remo)n(v)n(ed\),)i(and)f
+(mo)r(difying)g(it)g(ma)n(y)f(therefore)g(result)g(in)h(indirect)g(mo)r
+(di\014cation)g(of)427 551 y(the)e(original.)58 b(If)35
+b(a)g(completely)g(indep)r(enden)n(t)h(result)f(is)g(required,)h(a)f
+(cop)n(y)f(should)h(b)r(e)h(made)f(using)427 650 y(AST)p
+Ft(_)p Fj(COPY.)340 782 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
+(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
+b(A)g(TUS)427 881 y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28
+b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
+0 1077 3780 12 v 0 1208 a FA(AST)p Fe(_)p FA(REMO)l(VER)l(O)l(W)260
+b Fd(Remo)m(v)m(e)38 b(a)g(ro)m(w)1576 1307 y(from)f(a)i(table)2512
+1208 y FA(AST)p Fe(_)p FA(REMO)l(VER)l(O)l(W)0 1470 y
+Fc(Description:)44 b Fj(This)20 b(function)g(remo)n(v)n(es)d(a)j(sp)r
+(eci\014ed)f(ro)n(w)g(from)g(the)h(supplied)g(table.)34
+b(The)19 b(routine)g(returns)g(without)227 1570 y(action)27
+b(if)h(the)g(ro)n(w)f(do)r(es)g(not)h(exist)f(in)h(the)g(T)-7
+b(able)27 b(\(no)h(error)e(is)h(rep)r(orted\).)0 1718
+y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_REMOVEROW\()37
+b(THIS,)42 b(INDEX,)f(STATUS)g(\))0 1866 y Fc(Argumen)m(ts:)259
+2001 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 2100
+y Fj(P)n(oin)n(ter)26 b(to)i(the)g(T)-7 b(able.)259 2232
+y Fc(INDEX)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 2331 y
+Fj(The)d(index)g(of)f(the)h(ro)n(w)f(to)g(b)r(e)h(remo)n(v)n(ed.)35
+b(The)28 b(\014rst)f(ro)n(w)g(has)g(index)g(1.)259 2463
+y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
+427 2562 y Fj(The)c(global)e(status.)p 0 2759 V 0 2889
+a FA(AST)p Fe(_)p FA(REMO)l(VET)-11 b(ABLES)228 b Fd(Remo)m(v)m(e)1730
+2989 y(one)39 b(or)1763 3088 y(more)1740 3188 y(tables)1722
+3287 y(from)f(a)1653 3387 y(FitsChan)2322 2889 y FA(AST)p
+Fe(_)p FA(REMO)l(VET)-11 b(ABLES)0 3554 y Fc(Description:)44
+b Fj(This)d(routine)f(remo)n(v)n(es)f(the)i(named)f(tables)g(from)h
+(the)f(FitsChan,)k(it)d(they)g(exist)g(\(no)f(error)f(is)227
+3654 y(rep)r(orted)27 b(if)h(an)n(y)f(the)h(tables)f(do)h(not)f
+(exist\).)0 3802 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
+b(AST_REMOVETABLE)o(S\()37 b(THIS,)42 b(KEY,)g(STATUS)f(\))0
+3950 y Fc(Argumen)m(ts:)259 4085 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 4184 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
+4316 y Fc(KEY)k(=)g(CHARA)m(CTER)f Fi(\003)h Fc(\()g
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 4415 y Fj(The)c(k)n(ey)e(indicating)
+h(whic)n(h)g(tables)g(to)g(exist.)37 b(A)27 b(single)g(k)n(ey)f(or)h(a)
+f(comma-separated)f(list)j(of)f(k)n(eys)f(can)427 4515
+y(b)r(e)i(supplied.)37 b(If)29 b(a)e(blank)g(string)g(is)g(supplied,)h
+(all)g(tables)f(are)g(remo)n(v)n(ed.)259 4646 y Fc(ST)-8
+b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+4746 y Fj(The)c(global)e(status.)p 0 4942 V 0 5073 a
+FA(AST)p Fe(_)p FA(RESAMPLE)p Fb(<)p FA(X)p Fb(>)1596
+5074 y Fd(Resample)38 b(a)1618 5189 y(region)f(of)i(a)1656
+5303 y(data)e(grid)2411 5073 y FA(AST)p Fe(_)p FA(RESAMPLE)p
+Fb(<)p FA(X)p Fb(>)0 5494 y Fc(Description:)44 b Fj(This)31
+b(is)g(a)f(set)h(of)g(functions)g(for)f(resampling)g(gridded)g(data)h
+(\(e.g.)46 b(an)31 b(image\))f(under)h(the)g(con)n(trol)227
+5593 y(of)c(a)e(geometrical)g(transformation,)g(whic)n(h)h(is)g(sp)r
+(eci\014ed)h(b)n(y)f(a)g(Mapping.)36 b(The)26 b(functions)h(op)r(erate)
+e(on)h(a)g(pair)227 5693 y(of)i(data)f(grids)f(\(input)j(and)f
+(output\),)g(eac)n(h)f(of)g(whic)n(h)h(ma)n(y)f(ha)n(v)n(e)f(an)n(y)h
+(n)n(um)n(b)r(er)g(of)h(dimensions.)36 b(Resampling)p
+eop end
+%%Page: 345 355
+TeXDict begin 345 354 bop 3643 52 a FG(345)227 351 y
+Fj(ma)n(y)32 b(b)r(e)g(restricted)g(to)g(a)g(sp)r(eci\014ed)h(region)d
+(of)j(the)f(output)h(grid.)50 b(An)33 b(asso)r(ciated)e(grid)g(of)i
+(error)d(estimates)227 451 y(asso)r(ciated)36 b(with)h(the)g(input)h
+(data)e(ma)n(y)g(also)g(b)r(e)h(supplied)g(\(in)g(the)h(form)e(of)h(v)
+-5 b(ariance)35 b(v)-5 b(alues\),)39 b(so)e(as)f(to)227
+551 y(pro)r(duce)29 b(error)f(estimates)h(for)g(the)h(resampled)e
+(output)i(data.)42 b(Propagation)27 b(of)i(missing)g(data)g(\(bad)h
+(pixels\))227 650 y(is)e(supp)r(orted.)227 771 y(Y)-7
+b(ou)29 b(should)g(use)g(a)f(resampling)g(function)h(whic)n(h)g(matc)n
+(hes)g(the)g(n)n(umerical)f(t)n(yp)r(e)h(of)g(the)g(data)g(y)n(ou)f
+(are)g(pro-)227 871 y(cessing)c(b)n(y)h(replacing)f Fl(<)p
+Fj(X)p Fl(>)g Fj(in)h(the)h(generic)d(function)j(name)f(AST)p
+Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)e Fj(b)n(y)i(an)f(appropriate)
+227 971 y(1-)i(or)f(2-c)n(haracter)f(t)n(yp)r(e)j(co)r(de.)36
b(F)-7 b(or)26 b(example,)g(if)h(y)n(ou)f(are)f(resampling)g(data)h
-(with)h(t)n(yp)r(e)g(REAL,)f(y)n(ou)g(should)227 2891
+(with)h(t)n(yp)r(e)g(REAL,)f(y)n(ou)g(should)227 1070
y(use)38 b(the)g(function)g(AST)p Ft(_)p Fj(RESAMPLER)e(\(see)i(the)g
Ft(")p Fj(Data)f(T)n(yp)r(e)g(Co)r(des)p Ft(")g Fj(section)g(b)r(elo)n
-(w)g(for)g(the)h(co)r(des)227 2990 y(appropriate)26 b(to)i(other)f(n)n
-(umerical)f(t)n(yp)r(es\).)227 3112 y(Resampling)f(of)h(the)f(grid)g
+(w)g(for)g(the)h(co)r(des)227 1170 y(appropriate)26 b(to)i(other)f(n)n
+(umerical)f(t)n(yp)r(es\).)227 1291 y(Resampling)f(of)h(the)f(grid)g
(of)h(input)g(data)f(is)g(p)r(erformed)g(b)n(y)h(transforming)e(the)h
-(co)r(ordinates)f(of)i(the)g(cen)n(tre)f(of)227 3212
+(co)r(ordinates)f(of)i(the)g(cen)n(tre)f(of)227 1391
y(eac)n(h)d(output)g(grid)g(elemen)n(t)g(\(or)g(pixel\))g(in)n(to)g
(the)h(co)r(ordinate)e(system)h(of)g(the)h(input)g(grid.)34
-b(Since)23 b(the)f(resulting)227 3312 y(co)r(ordinates)27
+b(Since)23 b(the)f(resulting)227 1491 y(co)r(ordinates)27
b(will)h(not,)g(in)g(general,)f(coincide)h(with)g(the)h(cen)n(tre)e(of)
h(an)g(input)h(pixel,)f(sub-pixel)f(in)n(terp)r(olation)227
-3411 y(is)35 b(p)r(erformed)g(b)r(et)n(w)n(een)g(the)h(neigh)n(b)r
+1590 y(is)35 b(p)r(erformed)g(b)r(et)n(w)n(een)g(the)h(neigh)n(b)r
(ouring)e(input)i(pixels.)60 b(This)35 b(pro)r(duces)f(a)h(resampled)f
-(v)-5 b(alue)36 b(whic)n(h)f(is)227 3511 y(then)26 b(assigned)d(to)i
+(v)-5 b(alue)36 b(whic)n(h)f(is)227 1690 y(then)26 b(assigned)d(to)i
(the)g(output)g(pixel.)36 b(A)26 b(c)n(hoice)e(of)g(sub-pixel)h(in)n
(terp)r(olation)f(sc)n(hemes)g(is)h(pro)n(vided,)f(but)h(y)n(ou)227
-3610 y(ma)n(y)i(also)g(implemen)n(t)h(y)n(our)e(o)n(wn.)227
-3733 y(This)g(algorithm)f(samples)h(the)h(input)g(data)e(v)-5
+1789 y(ma)n(y)i(also)g(implemen)n(t)h(y)n(our)e(o)n(wn.)227
+1911 y(This)g(algorithm)f(samples)h(the)h(input)g(data)e(v)-5
b(alue,)27 b(it)f(do)r(es)g(not)g(in)n(tegrate)f(it.)37
b(Th)n(us)26 b(total)g(data)g(v)-5 b(alue)26 b(in)g(the)227
-3832 y(input)31 b(image)f(will)h(not,)g(in)f(general,)g(b)r(e)h
+2010 y(input)31 b(image)f(will)h(not,)g(in)f(general,)g(b)r(e)h
(conserv)n(ed.)43 b(Ho)n(w)n(ev)n(er,)30 b(an)g(option)g(is)g(pro)n
-(vided)f(\(see)i(the)f Ft(")p Fj(Con)n(trol)227 3932
+(vided)f(\(see)i(the)f Ft(")p Fj(Con)n(trol)227 2110
y(Flags)p Ft(")38 b Fj(section)h(b)r(elo)n(w\))g(whic)n(h)h(can)e(pro)r
(duce)h(appro)n(ximate)f(\015ux)h(conserv)-5 b(ation)38
-b(b)n(y)h(scaling)f(the)i(output)227 4031 y(v)-5 b(alues)34
+b(b)n(y)h(scaling)f(the)i(output)227 2210 y(v)-5 b(alues)34
b(using)f(the)h(ratio)f(of)h(the)g(output)h(pixel)f(size)f(to)h(the)g
(input)h(pixel)f(size.)55 b(Ho)n(w)n(ev)n(er,)34 b(if)g(accurate)e
-(\015ux)227 4131 y(conserv)-5 b(ation)28 b(is)h(imp)r(ortan)n(t)g(to)g
+(\015ux)227 2309 y(conserv)-5 b(ation)28 b(is)h(imp)r(ortan)n(t)g(to)g
(y)n(ou,)g(consder)f(using)g(the)i(AST)p Ft(_)p Fj(REBIN)p
Fl(<)p Fj(X)p Fl(>)e Fj(or)g(AST)p Ft(_)p Fj(REBINSEQ)p
-Fl(<)p Fj(X)p Fl(>)227 4231 y Fj(family)g(of)g(routines)e(instead.)227
-4353 y(Output)32 b(pixel)g(co)r(ordinates)e(are)h(transformed)f(in)n
+Fl(<)p Fj(X)p Fl(>)227 2409 y Fj(family)g(of)g(routines)e(instead.)227
+2530 y(Output)32 b(pixel)g(co)r(ordinates)e(are)h(transformed)f(in)n
(to)h(the)h(co)r(ordinate)e(system)i(of)f(the)h(input)g(grid)f(using)g
-(the)227 4452 y(in)n(v)n(erse)i(transformation)g(of)h(the)h(Mapping)e
+(the)227 2630 y(in)n(v)n(erse)i(transformation)g(of)h(the)h(Mapping)e
(whic)n(h)i(is)f(supplied.)57 b(This)34 b(means)g(that)h(geometrical)d
-(features)227 4552 y(in)g(the)f(input)h(data)f(are)f(sub)5
+(features)227 2729 y(in)g(the)f(input)h(data)f(are)f(sub)5
b(jected)31 b(to)g(the)h(Mapping's)e(forw)n(ard)g(transformation)f(as)i
-(they)g(are)f(transferred)227 4652 y(from)24 b(the)g(input)g(to)g(the)g
+(they)g(are)f(transferred)227 2829 y(from)24 b(the)g(input)g(to)g(the)g
(output)g(grid)f(\(although)g(the)h(Mapping's)f(forw)n(ard)f
-(transformation)g(is)i(not)f(explicitly)227 4751 y(used\).)227
-4873 y(In)h(practice,)f(transforming)e(the)j(co)r(ordinates)e(of)h(ev)n
+(transformation)g(is)i(not)f(explicitly)227 2929 y(used\).)227
+3050 y(In)h(practice,)f(transforming)e(the)j(co)r(ordinates)e(of)h(ev)n
(ery)e(pixel)j(of)f(a)f(large)g(data)h(grid)f(can)h(b)r(e)g
-(time-consuming,)227 4973 y(esp)r(ecially)38 b(if)g(the)h(Mapping)f(in)
+(time-consuming,)227 3150 y(esp)r(ecially)38 b(if)g(the)h(Mapping)f(in)
n(v)n(olv)n(es)e(complicated)i(functions,)j(suc)n(h)c(as)h(sky)f(pro)5
-b(jections.)67 b(T)-7 b(o)38 b(impro)n(v)n(e)227 5073
+b(jections.)67 b(T)-7 b(o)38 b(impro)n(v)n(e)227 3249
y(p)r(erformance,)29 b(it)g(is)g(therefore)f(p)r(ossible)g(to)h(appro)n
(ximate)e(non-linear)h(Mappings)g(b)n(y)h(a)g(set)g(of)f(linear)h
-(trans-)227 5172 y(formations)h(whic)n(h)h(are)f(applied)g(piece-wise)h
+(trans-)227 3349 y(formations)h(whic)n(h)h(are)f(applied)g(piece-wise)h
(to)f(separate)g(sub-regions)f(of)h(the)i(data.)46 b(This)30
-b(appro)n(ximation)227 5272 y(pro)r(cess)37 b(is)h(applied)g
+b(appro)n(ximation)227 3449 y(pro)r(cess)37 b(is)h(applied)g
(automatically)f(b)n(y)h(an)g(adaptiv)n(e)f(algorithm,)i(under)f(con)n
-(trol)f(of)h(an)g(accuracy)e(crite-)227 5372 y(rion)25
+(trol)f(of)h(an)g(accuracy)e(crite-)227 3548 y(rion)25
b(whic)n(h)h(expresses)f(the)h(maxim)n(um)g(tolerable)f(geometrical)f
(distortion)h(whic)n(h)h(ma)n(y)f(b)r(e)i(in)n(tro)r(duced,)f(as)f(a)
-227 5471 y(fraction)i(of)h(a)f(pixel.)227 5593 y(This)34
+227 3648 y(fraction)i(of)h(a)f(pixel.)227 3769 y(This)34
b(algorithm)e(\014rst)h(attempts)h(to)g(appro)n(ximate)e(the)i(Mapping)
-f(with)h(a)f(linear)g(transformation)f(applied)227 5693
+f(with)h(a)f(linear)g(transformation)f(applied)227 3869
y(o)n(v)n(er)h(the)h(whole)g(region)f(of)h(the)h(output)g(grid)e(whic)n
(h)i(is)f(b)r(eing)g(used.)57 b(If)35 b(this)f(pro)n(v)n(es)f(to)h(b)r
-(e)g(insu\016cien)n(tly)p eop end
-%%Page: 343 353
-TeXDict begin 343 352 bop 3643 52 a FG(343)227 351 y
-Fj(accurate,)29 b(the)h(output)g(region)f(is)g(sub-divided)h(in)n(to)f
-(t)n(w)n(o)g(along)f(its)i(largest)e(dimension)i(and)f(the)h(pro)r
-(cess)f(is)227 451 y(rep)r(eated)k(within)h(eac)n(h)f(of)g(the)h
-(resulting)e(sub-regions.)53 b(This)33 b(pro)r(cess)f(of)h
-(sub-division)g(con)n(tin)n(ues)f(un)n(til)i(a)227 551
-y(su\016cien)n(tly)27 b(go)r(o)r(d)g(linear)f(appro)n(ximation)g(is)h
-(found,)g(or)f(the)i(region)e(to)h(whic)n(h)g(it)h(is)f(b)r(eing)g
-(applied)g(b)r(ecomes)227 650 y(to)r(o)h(small)f(\(in)h(whic)n(h)f
-(case)g(the)h(original)e(Mapping)h(is)h(used)g(directly\).)0
-808 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_RESAMPLE)p
-Fl(<)p Ft(X)p Fl(>)p Ft(\()37 b(THIS,)k(NDIM_IN,)g(LBND_IN,)f(UBND_IN,)
-g(IN,)j(IN_VAR,)d(INTERP,)227 907 y(FINTERP,)h(PARAMS,)f(FLAGS,)h(TOL,)
-h(MAXPIX,)f(BADVAL,)g(NDIM_OUT,)f(LBND_OUT,)f(UBND_OUT,)h(LBND,)i
-(UBND,)227 1007 y(OUT,)g(OUT_VAR,)e(STATUS)i(\))0 1165
-y Fc(Argumen)m(ts:)259 1310 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
-1409 y Fj(P)n(oin)n(ter)21 b(to)h(a)g(Mapping,)h(whose)f(in)n(v)n(erse)
-f(transformation)g(will)i(b)r(e)f(used)h(to)f(transform)f(the)i(co)r
-(ordinates)427 1509 y(of)36 b(pixels)f(in)h(the)g(output)h(grid)e(in)n
+(e)g(insu\016cien)n(tly)227 3968 y(accurate,)29 b(the)h(output)g
+(region)f(is)g(sub-divided)h(in)n(to)f(t)n(w)n(o)g(along)f(its)i
+(largest)e(dimension)i(and)f(the)h(pro)r(cess)f(is)227
+4068 y(rep)r(eated)k(within)h(eac)n(h)f(of)g(the)h(resulting)e
+(sub-regions.)53 b(This)33 b(pro)r(cess)f(of)h(sub-division)g(con)n
+(tin)n(ues)f(un)n(til)i(a)227 4168 y(su\016cien)n(tly)27
+b(go)r(o)r(d)g(linear)f(appro)n(ximation)g(is)h(found,)g(or)f(the)i
+(region)e(to)h(whic)n(h)g(it)h(is)f(b)r(eing)g(applied)g(b)r(ecomes)227
+4267 y(to)r(o)h(small)f(\(in)h(whic)n(h)f(case)g(the)h(original)e
+(Mapping)h(is)h(used)g(directly\).)0 4410 y Fc(In)m(v)m(o)s(cation:)123
+b Ft(RESULT)41 b(=)i(AST_RESAMPLE)p Fl(<)p Ft(X)p Fl(>)p
+Ft(\()37 b(THIS,)k(NDIM_IN,)g(LBND_IN,)f(UBND_IN,)g(IN,)j(IN_VAR,)d
+(INTERP,)227 4510 y(FINTERP,)h(PARAMS,)f(FLAGS,)h(TOL,)h(MAXPIX,)f
+(BADVAL,)g(NDIM_OUT,)f(LBND_OUT,)f(UBND_OUT,)h(LBND,)i(UBND,)227
+4610 y(OUT,)g(OUT_VAR,)e(STATUS)i(\))0 4753 y Fc(Argumen)m(ts:)259
+4883 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 4982
+y Fj(P)n(oin)n(ter)21 b(to)h(a)g(Mapping,)h(whose)f(in)n(v)n(erse)f
+(transformation)g(will)i(b)r(e)f(used)h(to)f(transform)f(the)i(co)r
+(ordinates)427 5082 y(of)36 b(pixels)f(in)h(the)g(output)h(grid)e(in)n
(to)g(the)h(co)r(ordinate)f(system)g(of)h(the)g(input)h(grid.)60
-b(This)36 b(yields)f(the)427 1608 y(p)r(ositions)h(whic)n(h)g(are)f
+b(This)36 b(yields)f(the)427 5181 y(p)r(ositions)h(whic)n(h)g(are)f
(used)h(to)g(obtain)g(resampled)f(v)-5 b(alues)36 b(b)n(y)f(sub-pixel)h
-(in)n(terp)r(olation)f(within)i(the)427 1708 y(input)29
-b(grid.)427 1826 y(The)24 b(n)n(um)n(b)r(er)g(of)g(input)h(co)r
+(in)n(terp)r(olation)f(within)i(the)427 5281 y(input)29
+b(grid.)427 5394 y(The)24 b(n)n(um)n(b)r(er)g(of)g(input)h(co)r
(ordinates)e(used)h(b)n(y)g(this)g(Mapping)g(\(as)f(giv)n(en)h(b)n(y)f
-(its)i(Nin)f(attribute\))h(should)427 1926 y(matc)n(h)f(the)h(n)n(um)n
+(its)i(Nin)f(attribute\))h(should)427 5494 y(matc)n(h)f(the)h(n)n(um)n
(b)r(er)f(of)g(input)h(grid)f(dimensions)f(giv)n(en)h(b)n(y)g(the)g(v)
-5 b(alue)25 b(of)f(NDIM)p Ft(_)p Fj(IN)h(b)r(elo)n(w.)35
-b(Similarly)-7 b(,)427 2026 y(the)29 b(n)n(um)n(b)r(er)e(of)h(output)g
+b(Similarly)-7 b(,)427 5593 y(the)29 b(n)n(um)n(b)r(er)e(of)h(output)g
(co)r(ordinates)f(\(Nout)h(attribute\))h(should)e(matc)n(h)h(the)g(n)n
-(um)n(b)r(er)g(of)g(output)g(grid)427 2125 y(dimensions)g(giv)n(en)e(b)
-n(y)i(NDIM)p Ft(_)p Fj(OUT.)259 2262 y Fc(NDIM)p Ft(_)p
-Fc(IN)j(=)h(INTEGER)g(\(Giv)m(en\))427 2362 y Fj(The)c(n)n(um)n(b)r(er)
-f(of)h(dimensions)f(in)h(the)g(input)g(grid.)36 b(This)28
-b(should)f(b)r(e)h(at)g(least)f(one.)259 2499 y Fc(LBND)p
-Ft(_)p Fc(IN\()32 b(NDIM)p Ft(_)p Fc(IN)f(\))h(=)g(INTEGER)f(\(Giv)m
-(en\))427 2598 y Fj(An)j(arra)n(y)d(con)n(taining)h(the)i(co)r
+(um)n(b)r(er)g(of)g(output)g(grid)427 5693 y(dimensions)g(giv)n(en)e(b)
+n(y)i(NDIM)p Ft(_)p Fj(OUT.)p eop end
+%%Page: 346 356
+TeXDict begin 346 355 bop 0 52 a FG(346)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(NDIM)p
+Ft(_)p Fc(IN)g(=)h(INTEGER)g(\(Giv)m(en\))427 451 y Fj(The)c(n)n(um)n
+(b)r(er)f(of)h(dimensions)f(in)h(the)g(input)g(grid.)36
+b(This)28 b(should)f(b)r(e)h(at)g(least)f(one.)259 578
+y Fc(LBND)p Ft(_)p Fc(IN\()32 b(NDIM)p Ft(_)p Fc(IN)f(\))h(=)g(INTEGER)
+f(\(Giv)m(en\))427 678 y Fj(An)j(arra)n(y)d(con)n(taining)h(the)i(co)r
(ordinates)e(of)h(the)h(cen)n(tre)f(of)g(the)g(\014rst)h(pixel)f(in)g
-(the)h(input)g(grid)f(along)427 2698 y(eac)n(h)27 b(dimension.)259
-2835 y Fc(UBND)p Ft(_)p Fc(IN\()32 b(NDIM)p Ft(_)p Fc(IN)f(\))h(=)g
-(INTEGER)f(\(Giv)m(en\))427 2935 y Fj(An)k(arra)n(y)d(con)n(taining)h
+(the)h(input)g(grid)f(along)427 777 y(eac)n(h)27 b(dimension.)259
+904 y Fc(UBND)p Ft(_)p Fc(IN\()32 b(NDIM)p Ft(_)p Fc(IN)f(\))h(=)g
+(INTEGER)f(\(Giv)m(en\))427 1004 y Fj(An)k(arra)n(y)d(con)n(taining)h
(the)h(co)r(ordinates)f(of)h(the)h(cen)n(tre)f(of)g(the)g(last)g(pixel)
-g(in)h(the)f(input)h(grid)f(along)427 3034 y(eac)n(h)27
-b(dimension.)427 3153 y(Note)h(that)f(LBND)p Ft(_)p Fj(IN)h(and)f(UBND)
+g(in)h(the)f(input)h(grid)f(along)427 1104 y(eac)n(h)27
+b(dimension.)427 1217 y(Note)h(that)f(LBND)p Ft(_)p Fj(IN)h(and)f(UBND)
p Ft(_)p Fj(IN)h(together)f(de\014ne)g(the)h(shap)r(e)f(and)g(size)g
-(of)h(the)g(input)g(grid,)e(its)427 3252 y(exten)n(t)33
+(of)h(the)g(input)g(grid,)e(its)427 1317 y(exten)n(t)33
b(along)e(a)i(particular)e(\(J'th\))j(dimension)e(b)r(eing)h(UBND)p
Ft(_)p Fj(IN\(J\)-LBND)p Ft(_)p Fj(IN\(J\)+1.)52 b(They)33
-b(also)427 3352 y(de\014ne)25 b(the)f(input)i(grid's)d(co)r(ordinate)g
+b(also)427 1416 y(de\014ne)25 b(the)f(input)i(grid's)d(co)r(ordinate)g
(system,)i(eac)n(h)e(pixel)i(ha)n(ving)e(unit)i(exten)n(t)f(along)f
-(eac)n(h)h(dimension)427 3451 y(with)k(in)n(tegral)f(co)r(ordinate)f(v)
--5 b(alues)27 b(at)h(its)g(cen)n(tre.)259 3588 y Fc(IN\()k
+(eac)n(h)h(dimension)427 1516 y(with)k(in)n(tegral)f(co)r(ordinate)f(v)
+-5 b(alues)27 b(at)h(its)g(cen)n(tre.)259 1643 y Fc(IN\()k
Fi(\003)f Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p Fl(>)g
-Fc(\(Giv)m(en\))427 3688 y Fj(An)e(arra)n(y)-7 b(,)26
+Fc(\(Giv)m(en\))427 1742 y Fj(An)e(arra)n(y)-7 b(,)26
b(with)k(one)e(elemen)n(t)h(for)f(eac)n(h)g(pixel)h(in)g(the)h(input)f
(grid,)g(con)n(taining)e(the)j(input)f(data)g(to)f(b)r(e)427
-3788 y(resampled.)51 b(The)32 b(n)n(umerical)g(t)n(yp)r(e)g(of)h(this)f
+1842 y(resampled.)51 b(The)32 b(n)n(umerical)g(t)n(yp)r(e)g(of)h(this)f
(arra)n(y)e(should)j(matc)n(h)f(the)h(1-)e(or)h(2-c)n(haracter)d(t)n
-(yp)r(e)k(co)r(de)427 3887 y(app)r(ended)d(to)f(the)h(function)g(name)f
+(yp)r(e)k(co)r(de)427 1942 y(app)r(ended)d(to)f(the)h(function)g(name)f
(\(e.g.)42 b(if)30 b(y)n(ou)f(are)f(using)h(AST)p Ft(_)p
-Fj(RESAMPLER,)g(the)g(t)n(yp)r(e)h(of)f(eac)n(h)427 3987
+Fj(RESAMPLER,)g(the)g(t)n(yp)r(e)h(of)f(eac)n(h)427 2041
y(arra)n(y)d(elemen)n(t)h(should)h(b)r(e)g(REAL\).)427
-4105 y(The)33 b(storage)f(order)f(of)j(data)e(within)i(this)g(arra)n(y)
+2155 y(The)33 b(storage)f(order)f(of)j(data)e(within)i(this)g(arra)n(y)
c(should)j(b)r(e)h(suc)n(h)f(that)g(the)h(index)f(of)g(the)g(\014rst)g
-(grid)427 4205 y(dimension)39 b(v)-5 b(aries)39 b(most)g(rapidly)g(and)
+(grid)427 2254 y(dimension)39 b(v)-5 b(aries)39 b(most)g(rapidly)g(and)
g(that)g(of)h(the)f(\014nal)g(dimension)h(least)f(rapidly)f(\(i.e.)73
-b(normal)427 4304 y(F)-7 b(ortran)27 b(arra)n(y)e(storage)h(order\).)
-259 4441 y Fc(IN)p Ft(_)p Fc(V)-11 b(AR\()32 b Fi(\003)f
+b(normal)427 2354 y(F)-7 b(ortran)27 b(arra)n(y)e(storage)h(order\).)
+259 2481 y Fc(IN)p Ft(_)p Fc(V)-11 b(AR\()32 b Fi(\003)f
Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p Fl(>)g Fc(\(Giv)m(en\))427
-4541 y Fj(An)24 b(optional)e(second)h(arra)n(y)e(with)i(the)h(same)f
+2581 y Fj(An)24 b(optional)e(second)h(arra)n(y)e(with)i(the)h(same)f
(size)f(and)h(t)n(yp)r(e)h(as)e(the)i(IN)f(arra)n(y)-7
b(.)34 b(If)23 b(the)h(AST)p Ft(__)p Fj(USEV)-9 b(AR)427
-4641 y(\015ag)28 b(is)g(set)h(via)f(the)h(FLA)n(GS)g(argumen)n(t)e(\(b)
+2680 y(\015ag)28 b(is)g(set)h(via)f(the)h(FLA)n(GS)g(argumen)n(t)e(\(b)
r(elo)n(w\),)i(this)g(arra)n(y)d(should)i(con)n(tain)g(a)g(set)h(of)f
-(non-negativ)n(e)427 4740 y(v)-5 b(alues)32 b(whic)n(h)h(represen)n(t)e
+(non-negativ)n(e)427 2780 y(v)-5 b(alues)32 b(whic)n(h)h(represen)n(t)e
(estimates)h(of)g(the)h(statistical)f(v)-5 b(ariance)31
b(asso)r(ciated)g(with)i(eac)n(h)e(elemen)n(t)i(of)427
-4840 y(the)26 b(IN)f(arra)n(y)-7 b(.)33 b(Estimates)25
+2880 y(the)26 b(IN)f(arra)n(y)-7 b(.)33 b(Estimates)25
b(of)f(the)i(v)-5 b(ariance)23 b(of)i(the)g(resampled)g(output)g(data)f
-(will)h(then)h(b)r(e)f(calculated.)427 4958 y(If)g(the)g(AST)p
+(will)h(then)h(b)r(e)f(calculated.)427 2993 y(If)g(the)g(AST)p
Ft(__)p Fj(USEV)-9 b(AR)25 b(\015ag)f(is)g(not)h(set,)g(no)g(input)g(v)
-5 b(ariance)24 b(estimates)g(are)g(required)f(and)i(this)g(arra)n(y)
-427 5058 y(will)j(not)g(b)r(e)g(used.)37 b(A)27 b(dumm)n(y)h(\(e.g.)37
+427 3093 y(will)j(not)g(b)r(e)g(used.)37 b(A)27 b(dumm)n(y)h(\(e.g.)37
b(one-elemen)n(t\))27 b(arra)n(y)e(ma)n(y)i(then)h(b)r(e)g(supplied.)
-259 5195 y Fc(INTERP)k(=)g(INTEGER)f(\(Giv)m(en\))427
-5295 y Fj(This)i(argumen)n(t)f(sp)r(eci\014es)h(the)g(sc)n(heme)g(to)f
+259 3220 y Fc(INTERP)k(=)g(INTEGER)f(\(Giv)m(en\))427
+3319 y Fj(This)i(argumen)n(t)f(sp)r(eci\014es)h(the)g(sc)n(heme)g(to)f
(b)r(e)i(used)f(for)f(sub-pixel)h(in)n(terp)r(olation)f(within)h(the)h
-(input)427 5394 y(grid.)62 b(It)36 b(ma)n(y)f(b)r(e)i(used)f(to)f
+(input)427 3419 y(grid.)62 b(It)36 b(ma)n(y)f(b)r(e)i(used)f(to)f
(select)h(from)g(a)f(set)h(of)g(pre-de\014ned)g(sc)n(hemes)f(b)n(y)h
-(supplying)g(one)f(of)h(the)427 5494 y(v)-5 b(alues)31
+(supplying)g(one)f(of)h(the)427 3518 y(v)-5 b(alues)31
b(describ)r(ed)f(in)i(the)f Ft(")p Fj(Sub-Pixel)f(In)n(terp)r(olation)g
(Sc)n(hemes)p Ft(")g Fj(section)g(b)r(elo)n(w.)46 b(If)32
-b(a)e(v)-5 b(alue)31 b(of)g(zero)427 5593 y(is)d(supplied,)h(then)f
+b(a)e(v)-5 b(alue)31 b(of)g(zero)427 3618 y(is)d(supplied,)h(then)f
(the)g(default)h(linear)e(in)n(terp)r(olation)g(sc)n(heme)h(is)g(used)g
(\(equiv)-5 b(alen)n(t)28 b(to)f(supplying)h(the)427
-5693 y(v)-5 b(alue)28 b(AST)p Ft(__)p Fj(LINEAR\).)p
-eop end
-%%Page: 344 354
-TeXDict begin 344 353 bop 0 52 a FG(344)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(Alternativ)n(ely)-7
-b(,)25 b(y)n(ou)e(ma)n(y)h(supply)g(a)g(v)-5 b(alue)24
-b(whic)n(h)g(indicates)g(that)h(y)n(ou)e(will)h(pro)n(vide)f(y)n(our)g
-(o)n(wn)h(routine)427 451 y(to)39 b(p)r(erform)f(sub-pixel)g(in)n(terp)
-r(olation)g(b)n(y)g(means)g(of)g(the)h(FINTERP)g(argumen)n(t.)68
-b(Again,)41 b(see)d(the)427 551 y Ft(")p Fj(Sub-Pixel)27
+3718 y(v)-5 b(alue)28 b(AST)p Ft(__)p Fj(LINEAR\).)427
+3831 y(Alternativ)n(ely)-7 b(,)25 b(y)n(ou)e(ma)n(y)h(supply)g(a)g(v)-5
+b(alue)24 b(whic)n(h)g(indicates)g(that)h(y)n(ou)e(will)h(pro)n(vide)f
+(y)n(our)g(o)n(wn)h(routine)427 3931 y(to)39 b(p)r(erform)f(sub-pixel)g
+(in)n(terp)r(olation)g(b)n(y)g(means)g(of)g(the)h(FINTERP)g(argumen)n
+(t.)68 b(Again,)41 b(see)d(the)427 4030 y Ft(")p Fj(Sub-Pixel)27
b(In)n(terp)r(olation)g(Sc)n(hemes)p Ft(")f Fj(section)i(b)r(elo)n(w)f
-(for)g(details.)259 690 y Fc(FINTERP)32 b(=)g(SUBR)m(OUTINE)g(\(Giv)m
-(en\))427 790 y Fj(If)g(the)f(v)-5 b(alue)32 b(giv)n(en)e(for)h(the)g
+(for)g(details.)259 4157 y Fc(FINTERP)32 b(=)g(SUBR)m(OUTINE)g(\(Giv)m
+(en\))427 4257 y Fj(If)g(the)f(v)-5 b(alue)32 b(giv)n(en)e(for)h(the)g
(INTERP)g(argumen)n(t)f(indicates)h(that)g(y)n(ou)g(will)g(pro)n(vide)f
-(y)n(our)g(o)n(wn)h(rou-)427 889 y(tine)39 b(for)f(sub-pixel)g(in)n
+(y)n(our)g(o)n(wn)h(rou-)427 4357 y(tine)39 b(for)f(sub-pixel)g(in)n
(terp)r(olation,)i(then)f(the)g(name)f(of)h(that)f(routine)g(should)h
-(b)r(e)f(giv)n(en)g(here)g(\(the)427 989 y(name)31 b(should)g(also)g
+(b)r(e)f(giv)n(en)g(here)g(\(the)427 4456 y(name)31 b(should)g(also)g
(app)r(ear)f(in)i(a)e(F)-7 b(ortran)31 b(EXTERNAL)g(statemen)n(t)g(in)h
-(the)f(routine)g(whic)n(h)g(in)n(v)n(ok)n(es)427 1089
+(the)f(routine)g(whic)n(h)g(in)n(v)n(ok)n(es)427 4556
y(AST)p Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p Fj(\).)37
b(F)-7 b(or)27 b(details)h(of)g(the)g(in)n(terface)f(whic)n(h)h(the)g
-(routine)g(should)f(ha)n(v)n(e)g(\(sev)n(eral)427 1188
+(routine)g(should)f(ha)n(v)n(e)g(\(sev)n(eral)427 4656
y(are)c(p)r(ossible,)i(dep)r(ending)f(on)g(the)g(v)-5
b(alue)24 b(of)g(INTERP\),)g(see)g(the)g Ft(")p Fj(Sub-Pixel)f(In)n
-(terp)r(olation)g(Sc)n(hemes)p Ft(")427 1288 y Fj(section)k(b)r(elo)n
-(w.)427 1408 y(If)35 b(the)f(INTERP)f(argumen)n(t)g(has)h(an)n(y)f
+(terp)r(olation)g(Sc)n(hemes)p Ft(")427 4755 y Fj(section)k(b)r(elo)n
+(w.)427 4869 y(If)35 b(the)f(INTERP)f(argumen)n(t)g(has)h(an)n(y)f
(other)g(v)-5 b(alue,)36 b(corresp)r(onding)c(to)h(one)h(of)g(the)g
-(pre-de\014ned)g(in-)427 1507 y(terp)r(olation)28 b(sc)n(hemes,)g(then)
+(pre-de\014ned)g(in-)427 4968 y(terp)r(olation)28 b(sc)n(hemes,)g(then)
h(this)f(routine)g(will)h(not)f(b)r(e)h(used)g(and)f(y)n(ou)g(ma)n(y)f
-(supply)i(the)f(n)n(ull)h(routine)427 1607 y(AST)p Ft(_)p
+(supply)i(the)f(n)n(ull)h(routine)427 5068 y(AST)p Ft(_)p
Fj(NULL)e(here)f(\(note)g(only)g(one)g(underscore\).)35
b(No)26 b(EXTERNAL)g(statemen)n(t)g(is)g(required)g(for)f(this)427
-1706 y(routine,)j(so)e(long)h(as)g(the)h(AST)p Ft(_)p
+5167 y(routine,)j(so)e(long)h(as)g(the)h(AST)p Ft(_)p
Fj(P)-7 b(AR)28 b(include)g(\014le)g(has)f(b)r(een)h(used.)259
-1846 y Fc(P)-8 b(ARAMS\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)
-e(\(Giv)m(en\))427 1946 y Fj(An)39 b(optional)f(arra)n(y)f(whic)n(h)h
+5295 y Fc(P)-8 b(ARAMS\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)
+e(\(Giv)m(en\))427 5394 y Fj(An)39 b(optional)f(arra)n(y)f(whic)n(h)h
(should)h(con)n(tain)f(an)n(y)g(additional)g(parameter)f(v)-5
-b(alues)38 b(required)g(b)n(y)g(the)427 2045 y(sub-pixel)e(in)n(terp)r
+b(alues)38 b(required)g(b)n(y)g(the)427 5494 y(sub-pixel)e(in)n(terp)r
(olation)f(sc)n(heme.)61 b(If)37 b(suc)n(h)e(parameters)f(are)h
(required,)i(this)g(will)f(b)r(e)g(noted)g(in)g(the)427
-2145 y Ft(")p Fj(Sub-Pixel)26 b(In)n(terp)r(olation)f(Sc)n(hemes)p
+5593 y Ft(")p Fj(Sub-Pixel)26 b(In)n(terp)r(olation)f(Sc)n(hemes)p
Ft(")h Fj(section)g(b)r(elo)n(w)g(\(y)n(ou)g(ma)n(y)g(also)f(use)h
-(this)h(arra)n(y)d(to)i(pass)g(v)-5 b(alues)427 2245
-y(to)28 b(y)n(our)e(o)n(wn)h(in)n(terp)r(olation)g(routine\).)427
-2364 y(If)f(no)e(additional)g(parameters)g(are)f(required,)i(this)g
+(this)h(arra)n(y)d(to)i(pass)g(v)-5 b(alues)427 5693
+y(to)28 b(y)n(our)e(o)n(wn)h(in)n(terp)r(olation)g(routine\).)p
+eop end
+%%Page: 347 357
+TeXDict begin 347 356 bop 3643 52 a FG(347)427 351 y
+Fj(If)26 b(no)e(additional)g(parameters)g(are)f(required,)i(this)g
(arra)n(y)d(is)j(not)g(used.)36 b(A)25 b(dumm)n(y)g(\(e.g.)36
-b(one-elemen)n(t\))427 2464 y(arra)n(y)26 b(ma)n(y)g(then)j(b)r(e)f
-(supplied.)259 2604 y Fc(FLA)m(GS)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
-2703 y Fj(The)36 b(sum)f(of)h(a)f(set)g(of)g(\015ag)g(v)-5
+b(one-elemen)n(t\))427 451 y(arra)n(y)26 b(ma)n(y)g(then)j(b)r(e)f
+(supplied.)259 597 y Fc(FLA)m(GS)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
+696 y Fj(The)36 b(sum)f(of)h(a)f(set)g(of)g(\015ag)g(v)-5
b(alues)35 b(whic)n(h)g(ma)n(y)g(b)r(e)h(used)f(to)g(pro)n(vide)g
-(additional)g(con)n(trol)f(o)n(v)n(er)f(the)427 2803
-y(resampling)26 b(op)r(eration.)36 b(See)27 b(the)g Ft(")p
-Fj(Con)n(trol)e(Flags)p Ft(")h Fj(section)h(b)r(elo)n(w)f(for)h(a)f
-(description)h(of)g(the)g(options)427 2902 y(a)n(v)-5
-b(ailable.)36 b(If)28 b(no)f(\015ag)g(v)-5 b(alues)27
-b(are)g(to)g(b)r(e)h(set,)g(a)f(v)-5 b(alue)28 b(of)f(zero)g(should)g
-(b)r(e)h(giv)n(en.)259 3042 y Fc(TOL)k(=)h(DOUBLE)f(PRECISION)f(\(Giv)m
-(en\))427 3142 y Fj(The)j(maxim)n(um)f(tolerable)f(geometrical)f
-(distortion)i(whic)n(h)g(ma)n(y)f(b)r(e)i(in)n(tro)r(duced)f(as)f(a)h
-(result)g(of)g(ap-)427 3241 y(pro)n(ximating)c(non-linear)f(Mappings)h
-(b)n(y)h(a)f(set)h(of)g(piece-wise)f(linear)g(transformations.)42
-b(This)30 b(should)427 3341 y(b)r(e)e(expressed)f(as)g(a)g(displacemen)
-n(t)g(in)h(pixels)f(in)h(the)g(input)h(grid's)d(co)r(ordinate)h
-(system.)427 3461 y(If)34 b(piece-wise)f(linear)g(appro)n(ximation)f
-(is)h(not)h(required,)g(a)f(v)-5 b(alue)33 b(of)h(zero)e(ma)n(y)h(b)r
-(e)h(giv)n(en.)54 b(This)33 b(will)427 3560 y(ensure)k(that)g(the)h
-(Mapping)e(is)h(used)g(without)h(an)n(y)e(appro)n(ximation,)i(but)g(ma)
-n(y)e(increase)g(execution)427 3660 y(time.)259 3800
-y Fc(MAXPIX)d(=)f(INTEGER)f(\(Giv)m(en\))427 3899 y Fj(A)42
-b(v)-5 b(alue)40 b(whic)n(h)h(sp)r(eci\014es)g(an)g(initial)g(scale)g
-(size)f(\(in)i(pixels\))f(for)f(the)i(adaptiv)n(e)e(algorithm)g(whic)n
-(h)427 3999 y(appro)n(ximates)d(non-linear)g(Mappings)h(with)h
-(piece-wise)f(linear)g(transformations.)68 b(Normally)-7
-b(,)40 b(this)427 4098 y(should)35 b(b)r(e)g(a)f(large)g(v)-5
-b(alue)34 b(\(larger)f(than)i(an)n(y)f(dimension)h(of)g(the)g(region)e
-(of)i(the)g(output)g(grid)g(b)r(eing)427 4198 y(used\).)46
-b(In)31 b(this)g(case,)g(a)f(\014rst)g(attempt)h(to)g(appro)n(ximate)e
-(the)i(Mapping)f(b)n(y)g(a)g(linear)g(transformation)427
-4298 y(will)e(b)r(e)g(made)f(o)n(v)n(er)f(the)i(en)n(tire)f(output)i
-(region.)427 4417 y(If)40 b(a)g(smaller)e(v)-5 b(alue)40
+(additional)g(con)n(trol)f(o)n(v)n(er)f(the)427 796 y(resampling)26
+b(op)r(eration.)36 b(See)27 b(the)g Ft(")p Fj(Con)n(trol)e(Flags)p
+Ft(")h Fj(section)h(b)r(elo)n(w)f(for)h(a)f(description)h(of)g(the)g
+(options)427 895 y(a)n(v)-5 b(ailable.)36 b(If)28 b(no)f(\015ag)g(v)-5
+b(alues)27 b(are)g(to)g(b)r(e)h(set,)g(a)f(v)-5 b(alue)28
+b(of)f(zero)g(should)g(b)r(e)h(giv)n(en.)259 1041 y Fc(TOL)k(=)h
+(DOUBLE)f(PRECISION)f(\(Giv)m(en\))427 1141 y Fj(The)j(maxim)n(um)f
+(tolerable)f(geometrical)f(distortion)i(whic)n(h)g(ma)n(y)f(b)r(e)i(in)
+n(tro)r(duced)f(as)f(a)h(result)g(of)g(ap-)427 1240 y(pro)n(ximating)c
+(non-linear)f(Mappings)h(b)n(y)h(a)f(set)h(of)g(piece-wise)f(linear)g
+(transformations.)42 b(This)30 b(should)427 1340 y(b)r(e)e(expressed)f
+(as)g(a)g(displacemen)n(t)g(in)h(pixels)f(in)h(the)g(input)h(grid's)d
+(co)r(ordinate)h(system.)427 1463 y(If)34 b(piece-wise)f(linear)g
+(appro)n(ximation)f(is)h(not)h(required,)g(a)f(v)-5 b(alue)33
+b(of)h(zero)e(ma)n(y)h(b)r(e)h(giv)n(en.)54 b(This)33
+b(will)427 1562 y(ensure)k(that)g(the)h(Mapping)e(is)h(used)g(without)h
+(an)n(y)e(appro)n(ximation,)i(but)g(ma)n(y)e(increase)g(execution)427
+1662 y(time.)259 1807 y Fc(MAXPIX)d(=)f(INTEGER)f(\(Giv)m(en\))427
+1907 y Fj(A)42 b(v)-5 b(alue)40 b(whic)n(h)h(sp)r(eci\014es)g(an)g
+(initial)g(scale)g(size)f(\(in)i(pixels\))f(for)f(the)i(adaptiv)n(e)e
+(algorithm)g(whic)n(h)427 2007 y(appro)n(ximates)d(non-linear)g
+(Mappings)h(with)h(piece-wise)f(linear)g(transformations.)68
+b(Normally)-7 b(,)40 b(this)427 2106 y(should)35 b(b)r(e)g(a)f(large)g
+(v)-5 b(alue)34 b(\(larger)f(than)i(an)n(y)f(dimension)h(of)g(the)g
+(region)e(of)i(the)g(output)g(grid)g(b)r(eing)427 2206
+y(used\).)46 b(In)31 b(this)g(case,)g(a)f(\014rst)g(attempt)h(to)g
+(appro)n(ximate)e(the)i(Mapping)f(b)n(y)g(a)g(linear)g(transformation)
+427 2306 y(will)e(b)r(e)g(made)f(o)n(v)n(er)f(the)i(en)n(tire)f(output)
+i(region.)427 2428 y(If)40 b(a)g(smaller)e(v)-5 b(alue)40
b(is)f(used,)k(the)d(output)g(region)f(will)h(\014rst)f(b)r(e)h
-(divided)g(in)n(to)g(sub-regions)d(whose)427 4517 y(size)30
+(divided)g(in)n(to)g(sub-regions)d(whose)427 2528 y(size)30
b(do)r(es)f(not)h(exceed)g(MAXPIX)g(pixels)g(in)g(an)n(y)f(dimension.)
44 b(Only)29 b(at)h(this)g(p)r(oin)n(t)g(will)g(attempts)h(at)427
-4617 y(appro)n(ximation)26 b(commence.)427 4736 y(This)38
+2627 y(appro)n(ximation)26 b(commence.)427 2750 y(This)38
b(v)-5 b(alue)38 b(ma)n(y)g(o)r(ccasionally)e(b)r(e)j(useful)f(in)h
(prev)n(en)n(ting)e(false)h(con)n(v)n(ergence)d(of)j(the)h(adaptiv)n(e)
-e(al-)427 4836 y(gorithm)c(in)g(cases)f(where)g(the)h(Mapping)g(app)r
+e(al-)427 2850 y(gorithm)c(in)g(cases)f(where)g(the)h(Mapping)g(app)r
(ears)f(appro)n(ximately)f(linear)h(on)h(large)e(scales,)j(but)f(has)
-427 4936 y(irregularities)27 b(\(e.g.)40 b(holes\))28
+427 2949 y(irregularities)27 b(\(e.g.)40 b(holes\))28
b(on)g(smaller)g(scales.)39 b(A)29 b(v)-5 b(alue)28 b(of,)h(sa)n(y)-7
b(,)28 b(50)g(to)g(100)g(pixels)g(can)g(also)g(b)r(e)h(em-)427
-5035 y(plo)n(y)n(ed)23 b(as)f(a)h(safeguard)f(in)i(general-purp)r(ose)d
+3049 y(plo)n(y)n(ed)23 b(as)f(a)h(safeguard)f(in)i(general-purp)r(ose)d
(soft)n(w)n(are,)i(since)g(the)h(e\013ect)f(on)h(p)r(erformance)e(is)h
-(minimal.)427 5155 y(If)e(to)r(o)f(small)g(a)g(v)-5 b(alue)20
+(minimal.)427 3172 y(If)e(to)r(o)f(small)g(a)g(v)-5 b(alue)20
b(is)g(giv)n(en,)h(it)g(will)f(ha)n(v)n(e)f(the)i(e\013ect)g(of)f
(inhibiting)h(linear)f(appro)n(ximation)e(altogether)427
-5254 y(\(equiv)-5 b(alen)n(t)21 b(to)f(setting)h(TOL)f(to)g(zero\).)34
+3271 y(\(equiv)-5 b(alen)n(t)21 b(to)f(setting)h(TOL)f(to)g(zero\).)34
b(Although)20 b(this)h(ma)n(y)f(degrade)f(p)r(erformance,)i(accurate)e
-(results)427 5354 y(will)28 b(still)g(b)r(e)g(obtained.)259
-5494 y Fc(BAD)m(V)-11 b(AL)34 b(=)e Fl(<)p Fc(Xt)m(yp)s(e)p
-Fl(>)f Fc(\(Giv)m(en\))427 5593 y Fj(This)i(argumen)n(t)e(should)h(ha)n
+(results)427 3371 y(will)28 b(still)g(b)r(e)g(obtained.)259
+3516 y Fc(BAD)m(V)-11 b(AL)34 b(=)e Fl(<)p Fc(Xt)m(yp)s(e)p
+Fl(>)f Fc(\(Giv)m(en\))427 3616 y Fj(This)i(argumen)n(t)e(should)h(ha)n
(v)n(e)g(the)g(same)g(t)n(yp)r(e)h(as)f(the)h(elemen)n(ts)f(of)g(the)h
(IN)g(arra)n(y)-7 b(.)49 b(It)33 b(sp)r(eci\014es)f(the)427
-5693 y(v)-5 b(alue)28 b(used)f(to)h(\015ag)f(missing)g(data)g(\(bad)h
-(pixels\))f(in)h(the)g(input)g(and)g(output)g(arra)n(ys.)p
-eop end
-%%Page: 345 355
-TeXDict begin 345 354 bop 3643 52 a FG(345)427 351 y
-Fj(If)33 b(the)f(AST)p Ft(__)p Fj(USEBAD)g(\015ag)f(is)h(set)g(via)f
-(the)i(FLA)n(GS)f(argumen)n(t,)g(then)h(this)f(v)-5 b(alue)32
-b(is)g(used)f(to)h(test)427 451 y(for)27 b(bad)h(pixels)f(in)h(the)g
-(IN)g(\(and)g(IN)p Ft(_)p Fj(V)-9 b(AR\))28 b(arra)n(y\(s\).)427
-563 y(Unless)35 b(the)h(AST)p Ft(__)p Fj(NOBAD)f(\015ag)f(is)h(set)g
-(via)g(the)h(FLA)n(GS)f(argumen)n(t,)h(this)g(v)-5 b(alue)35
-b(is)g(also)f(used)h(to)427 663 y(\015ag)29 b(an)n(y)f(output)i(elemen)
-n(ts)f(in)g(the)h(OUT)f(\(and)g(OUT)p Ft(_)p Fj(V)-9
-b(AR\))30 b(arra)n(y\(s\))d(for)i(whic)n(h)g(resampled)f(v)-5
-b(alues)427 762 y(could)34 b(not)g(b)r(e)g(obtained)f(\(see)h(the)g
-Ft(")p Fj(Propagation)d(of)j(Missing)f(Data)p Ft(")g
-Fj(section)g(b)r(elo)n(w)h(for)f(details)h(of)427 862
-y(the)23 b(circumstances)f(under)h(whic)n(h)f(this)h(ma)n(y)f(o)r
+3716 y(v)-5 b(alue)28 b(used)f(to)h(\015ag)f(missing)g(data)g(\(bad)h
+(pixels\))f(in)h(the)g(input)g(and)g(output)g(arra)n(ys.)427
+3838 y(If)33 b(the)f(AST)p Ft(__)p Fj(USEBAD)g(\015ag)f(is)h(set)g(via)
+f(the)i(FLA)n(GS)f(argumen)n(t,)g(then)h(this)f(v)-5
+b(alue)32 b(is)g(used)f(to)h(test)427 3938 y(for)27 b(bad)h(pixels)f
+(in)h(the)g(IN)g(\(and)g(IN)p Ft(_)p Fj(V)-9 b(AR\))28
+b(arra)n(y\(s\).)427 4061 y(Unless)35 b(the)h(AST)p Ft(__)p
+Fj(NOBAD)f(\015ag)f(is)h(set)g(via)g(the)h(FLA)n(GS)f(argumen)n(t,)h
+(this)g(v)-5 b(alue)35 b(is)g(also)f(used)h(to)427 4160
+y(\015ag)29 b(an)n(y)f(output)i(elemen)n(ts)f(in)g(the)h(OUT)f(\(and)g
+(OUT)p Ft(_)p Fj(V)-9 b(AR\))30 b(arra)n(y\(s\))d(for)i(whic)n(h)g
+(resampled)f(v)-5 b(alues)427 4260 y(could)34 b(not)g(b)r(e)g(obtained)
+f(\(see)h(the)g Ft(")p Fj(Propagation)d(of)j(Missing)f(Data)p
+Ft(")g Fj(section)g(b)r(elo)n(w)h(for)f(details)h(of)427
+4359 y(the)23 b(circumstances)f(under)h(whic)n(h)f(this)h(ma)n(y)f(o)r
(ccur\).)35 b(The)23 b(AST)p Ft(_)p Fj(RESAMPLE)p Fl(<)p
-Fj(X)p Fl(>)e Fj(function)i(return)427 961 y(v)-5 b(alue)32
+Fj(X)p Fl(>)e Fj(function)i(return)427 4459 y(v)-5 b(alue)32
b(indicates)g(whether)g(an)n(y)f(suc)n(h)h(v)-5 b(alues)31
b(ha)n(v)n(e)g(b)r(een)i(pro)r(duced.)50 b(If)32 b(the)h(AST)p
-Ft(__)p Fj(NOBAD)e(\015ag)h(is)427 1061 y(set.)41 b(then)30
+Ft(__)p Fj(NOBAD)e(\015ag)h(is)427 4559 y(set.)41 b(then)30
b(output)f(arra)n(y)e(elemen)n(ts)i(for)f(whic)n(h)h(no)g(resampled)f
(v)-5 b(alue)29 b(could)g(b)r(e)g(obtained)g(are)f(left)i(set)427
-1161 y(to)e(the)g(v)-5 b(alue)27 b(they)h(had)f(on)h(en)n(try)f(to)g
-(this)h(function.)259 1285 y Fc(NDIM)p Ft(_)p Fc(OUT)k(=)g(INTEGER)f
-(\(Giv)m(en\))427 1385 y Fj(The)38 b(n)n(um)n(b)r(er)f(of)g(dimensions)
+4658 y(to)e(the)g(v)-5 b(alue)27 b(they)h(had)f(on)h(en)n(try)f(to)g
+(this)h(function.)259 4804 y Fc(NDIM)p Ft(_)p Fc(OUT)k(=)g(INTEGER)f
+(\(Giv)m(en\))427 4904 y Fj(The)38 b(n)n(um)n(b)r(er)f(of)g(dimensions)
g(in)h(the)f(output)h(grid.)66 b(This)37 b(should)g(b)r(e)h(at)f(least)
-g(one.)65 b(It)38 b(need)g(not)427 1484 y(necessarily)26
+g(one.)65 b(It)38 b(need)g(not)427 5003 y(necessarily)26
b(b)r(e)i(equal)f(to)h(the)g(n)n(um)n(b)r(er)f(of)h(dimensions)f(in)h
-(the)g(input)g(grid.)259 1609 y Fc(LBND)p Ft(_)p Fc(OUT\()33
+(the)g(input)g(grid.)259 5149 y Fc(LBND)p Ft(_)p Fc(OUT\()33
b(NDIM)p Ft(_)p Fc(OUT)e(\))h(=)g(INTEGER)g(\(Giv)m(en\))427
-1709 y Fj(An)f(arra)n(y)d(con)n(taining)h(the)h(co)r(ordinates)f(of)h
+5248 y Fj(An)f(arra)n(y)d(con)n(taining)h(the)h(co)r(ordinates)f(of)h
(the)h(cen)n(tre)e(of)h(the)h(\014rst)f(pixel)g(in)g(the)h(output)f
-(grid)g(along)427 1808 y(eac)n(h)d(dimension.)259 1933
+(grid)g(along)427 5348 y(eac)n(h)d(dimension.)259 5494
y Fc(UBND)p Ft(_)p Fc(OUT\()33 b(NDIM)p Ft(_)p Fc(OUT)e(\))h(=)g
-(INTEGER)g(\(Giv)m(en\))427 2032 y Fj(An)g(arra)n(y)c(con)n(taining)i
+(INTEGER)g(\(Giv)m(en\))427 5593 y Fj(An)g(arra)n(y)c(con)n(taining)i
(the)i(co)r(ordinates)d(of)i(the)h(cen)n(tre)e(of)h(the)h(last)e(pixel)
-h(in)h(the)f(output)h(grid)e(along)427 2132 y(eac)n(h)d(dimension.)427
-2244 y(Note)41 b(that)g(LBND)p Ft(_)p Fj(OUT)f(and)g(UBND)p
-Ft(_)p Fj(OUT)h(together)e(de\014ne)i(the)g(shap)r(e,)i(size)d(and)h
-(co)r(ordinate)427 2344 y(system)24 b(of)f(the)h(output)h(grid)d(in)i
-(the)g(same)g(w)n(a)n(y)e(as)h(LBND)p Ft(_)p Fj(IN)h(and)f(UBND)p
-Ft(_)p Fj(IN)i(de\014ne)f(the)g(shap)r(e,)g(size)427
-2443 y(and)k(co)r(ordinate)e(system)h(of)h(the)g(input)g(grid.)259
-2568 y Fc(LBND\()k(NDIM)p Ft(_)p Fc(OUT)g(\))g(=)g(INTEGER)f(\(Giv)m
-(en\))427 2667 y Fj(An)37 b(arra)n(y)c(con)n(taining)i(the)h(co)r
-(ordinates)f(of)h(the)g(\014rst)g(pixel)f(in)i(the)f(region)e(of)i(the)
-h(output)f(grid)f(for)427 2767 y(whic)n(h)28 b(a)f(resampled)g(v)-5
-b(alue)27 b(is)h(to)f(b)r(e)h(calculated.)259 2891 y
-Fc(UBND\()k(NDIM)p Ft(_)p Fc(OUT)g(\))g(=)g(INTEGER)f(\(Giv)m(en\))427
-2991 y Fj(An)23 b(arra)n(y)d(con)n(taining)h(the)i(co)r(ordinates)e(of)
-h(the)g(last)g(pixel)h(in)f(the)h(region)e(of)h(the)h(output)f(grid)g
-(for)g(whic)n(h)427 3091 y(a)27 b(resampled)g(v)-5 b(alue)28
-b(is)f(to)h(b)r(e)g(calculated.)427 3203 y(Note)e(that)g(LBND)h(and)e
-(UBND)i(together)e(de\014ne)h(the)g(shap)r(e)g(and)g(p)r(osition)g(of)f
-(a)h(\(h)n(yp)r(er-\)rectangular)427 3302 y(region)42
-b(of)i(the)f(output)h(grid)f(for)f(whic)n(h)i(resampled)e(v)-5
-b(alues)43 b(should)g(b)r(e)h(pro)r(duced.)84 b(This)43
-b(region)427 3402 y(should)32 b(lie)h(wholly)f(within)h(the)f(exten)n
-(t)h(of)f(the)h(output)g(grid)e(\(as)h(de\014ned)h(b)n(y)f(the)h(LBND)p
-Ft(_)p Fj(OUT)f(and)427 3502 y(UBND)p Ft(_)p Fj(OUT)20
-b(arra)n(ys\).)31 b(Regions)19 b(of)g(the)g(output)h(grid)e(lying)h
-(outside)g(this)g(region)f(will)h(not)h(b)r(e)f(mo)r(di\014ed.)259
-3626 y Fc(OUT\()33 b Fi(\003)e Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p
-Fl(>)f Fc(\(Returned\))427 3726 y Fj(An)e(arra)n(y)-7
+h(in)h(the)f(output)h(grid)e(along)427 5693 y(eac)n(h)d(dimension.)p
+eop end
+%%Page: 348 358
+TeXDict begin 348 357 bop 0 52 a FG(348)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(Note)41
+b(that)g(LBND)p Ft(_)p Fj(OUT)f(and)g(UBND)p Ft(_)p Fj(OUT)h(together)e
+(de\014ne)i(the)g(shap)r(e,)i(size)d(and)h(co)r(ordinate)427
+451 y(system)24 b(of)f(the)h(output)h(grid)d(in)i(the)g(same)g(w)n(a)n
+(y)e(as)h(LBND)p Ft(_)p Fj(IN)h(and)f(UBND)p Ft(_)p Fj(IN)i(de\014ne)f
+(the)g(shap)r(e,)g(size)427 551 y(and)k(co)r(ordinate)e(system)h(of)h
+(the)g(input)g(grid.)259 680 y Fc(LBND\()k(NDIM)p Ft(_)p
+Fc(OUT)g(\))g(=)g(INTEGER)f(\(Giv)m(en\))427 779 y Fj(An)37
+b(arra)n(y)c(con)n(taining)i(the)h(co)r(ordinates)f(of)h(the)g(\014rst)
+g(pixel)f(in)i(the)f(region)e(of)i(the)h(output)f(grid)f(for)427
+879 y(whic)n(h)28 b(a)f(resampled)g(v)-5 b(alue)27 b(is)h(to)f(b)r(e)h
+(calculated.)259 1008 y Fc(UBND\()k(NDIM)p Ft(_)p Fc(OUT)g(\))g(=)g
+(INTEGER)f(\(Giv)m(en\))427 1108 y Fj(An)23 b(arra)n(y)d(con)n(taining)
+h(the)i(co)r(ordinates)e(of)h(the)g(last)g(pixel)h(in)f(the)h(region)e
+(of)h(the)h(output)f(grid)g(for)g(whic)n(h)427 1207 y(a)27
+b(resampled)g(v)-5 b(alue)28 b(is)f(to)h(b)r(e)g(calculated.)427
+1322 y(Note)e(that)g(LBND)h(and)e(UBND)i(together)e(de\014ne)h(the)g
+(shap)r(e)g(and)g(p)r(osition)g(of)f(a)h(\(h)n(yp)r(er-\)rectangular)
+427 1421 y(region)42 b(of)i(the)f(output)h(grid)f(for)f(whic)n(h)i
+(resampled)e(v)-5 b(alues)43 b(should)g(b)r(e)h(pro)r(duced.)84
+b(This)43 b(region)427 1521 y(should)32 b(lie)h(wholly)f(within)h(the)f
+(exten)n(t)h(of)f(the)h(output)g(grid)e(\(as)h(de\014ned)h(b)n(y)f(the)
+h(LBND)p Ft(_)p Fj(OUT)f(and)427 1621 y(UBND)p Ft(_)p
+Fj(OUT)20 b(arra)n(ys\).)31 b(Regions)19 b(of)g(the)g(output)h(grid)e
+(lying)h(outside)g(this)g(region)f(will)h(not)h(b)r(e)f(mo)r(di\014ed.)
+259 1750 y Fc(OUT\()33 b Fi(\003)e Fc(\))h(=)g Fl(<)p
+Fc(Xt)m(yp)s(e)p Fl(>)f Fc(\(Returned\))427 1849 y Fj(An)e(arra)n(y)-7
b(,)26 b(with)j(one)f(elemen)n(t)g(for)g(eac)n(h)g(pixel)g(in)g(the)h
(output)g(grid,)f(in)n(to)g(whic)n(h)g(the)h(resampled)e(data)427
-3825 y(v)-5 b(alues)27 b(will)h(b)r(e)g(returned.)36
+1949 y(v)-5 b(alues)27 b(will)h(b)r(e)g(returned.)36
b(The)27 b(n)n(umerical)g(t)n(yp)r(e)g(of)h(this)f(arra)n(y)e(should)i
(matc)n(h)h(that)f(of)g(the)h(IN)g(arra)n(y)-7 b(,)427
-3925 y(and)32 b(the)g(data)f(storage)f(order)g(should)i(b)r(e)g(suc)n
+2049 y(and)32 b(the)g(data)f(storage)f(order)g(should)i(b)r(e)g(suc)n
(h)g(that)g(the)g(index)g(of)f(the)h(\014rst)g(grid)f(dimension)h(v)-5
-b(aries)427 4024 y(most)27 b(rapidly)g(and)g(that)h(of)f(the)h(\014nal)
+b(aries)427 2148 y(most)27 b(rapidly)g(and)g(that)h(of)f(the)h(\014nal)
f(dimension)g(least)g(rapidly)g(\(i.e.)37 b(normal)26
-b(F)-7 b(ortran)27 b(arra)n(y)e(storage)427 4124 y(order\).)259
-4249 y Fc(OUT)p Ft(_)p Fc(V)-11 b(AR\()33 b Fi(\003)e
+b(F)-7 b(ortran)27 b(arra)n(y)e(storage)427 2248 y(order\).)259
+2377 y Fc(OUT)p Ft(_)p Fc(V)-11 b(AR\()33 b Fi(\003)e
Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p Fl(>)f Fc(\(Returned\))427
-4348 y Fj(An)25 b(optional)f(arra)n(y)d(with)k(the)g(same)f(t)n(yp)r(e)
+2477 y Fj(An)25 b(optional)f(arra)n(y)d(with)k(the)g(same)f(t)n(yp)r(e)
g(and)g(size)g(as)g(the)g(OUT)g(arra)n(y)-7 b(.)34 b(If)25
b(the)f(AST)p Ft(__)p Fj(USEV)-9 b(AR)24 b(\015ag)427
-4448 y(is)30 b(set)f(via)h(the)g(FLA)n(GS)g(argumen)n(t,)f(this)h(arra)
+2576 y(is)30 b(set)f(via)h(the)g(FLA)n(GS)g(argumen)n(t,)f(this)h(arra)
n(y)d(will)j(b)r(e)g(used)g(to)f(return)g(v)-5 b(ariance)29
-b(estimates)g(for)g(the)427 4547 y(resampled)e(data)g(v)-5
-b(alues.)427 4659 y(The)23 b(output)f(v)-5 b(ariance)22
+b(estimates)g(for)g(the)427 2676 y(resampled)e(data)g(v)-5
+b(alues.)427 2790 y(The)23 b(output)f(v)-5 b(ariance)22
b(v)-5 b(alues)21 b(will)i(b)r(e)g(calculated)e(on)h(the)h(assumption)f
-(that)g(errors)e(on)i(the)h(input)g(data)427 4759 y(v)-5
+(that)g(errors)e(on)i(the)h(input)g(data)427 2890 y(v)-5
b(alues)24 b(are)g(statistically)f(indep)r(enden)n(t)i(and)g(that)f
(their)g(v)-5 b(ariance)24 b(estimates)g(ma)n(y)f(simply)i(b)r(e)f
-(summed)427 4859 y(\(with)30 b(appropriate)d(w)n(eigh)n(ting)g
+(summed)427 2989 y(\(with)30 b(appropriate)d(w)n(eigh)n(ting)g
(factors\))h(when)h(sev)n(eral)e(input)i(pixels)g(con)n(tribute)f(to)h
-(an)f(output)h(data)427 4958 y(v)-5 b(alue.)59 b(If)35
+(an)f(output)h(data)427 3089 y(v)-5 b(alue.)59 b(If)35
b(this)g(assumption)f(is)h(not)g(v)-5 b(alid,)36 b(then)f(the)h(output)
f(error)e(estimates)h(ma)n(y)g(b)r(e)h(biased.)58 b(In)427
-5058 y(addition,)31 b(note)f(that)h(the)f(statistical)g(errors)e(on)i
+3189 y(addition,)31 b(note)f(that)h(the)f(statistical)g(errors)e(on)i
(neigh)n(b)r(ouring)f(output)h(data)g(v)-5 b(alues)30
-b(\(as)g(w)n(ell)g(as)f(the)427 5158 y(estimates)j(of)f(those)g
+b(\(as)g(w)n(ell)g(as)f(the)427 3288 y(estimates)j(of)f(those)g
(errors\))f(ma)n(y)h(often)h(b)r(e)g(correlated,)f(ev)n(en)g(if)h(the)g
-(ab)r(o)n(v)n(e)f(assumption)g(ab)r(out)g(the)427 5257
+(ab)r(o)n(v)n(e)f(assumption)g(ab)r(out)g(the)427 3388
y(input)e(data)e(is)g(correct,)g(b)r(ecause)g(of)g(the)h(sub-pixel)g
(in)n(terp)r(olation)e(sc)n(hemes)h(emplo)n(y)n(ed.)427
-5369 y(If)34 b(the)h(AST)p Ft(__)p Fj(USEV)-9 b(AR)33
+3502 y(If)34 b(the)h(AST)p Ft(__)p Fj(USEV)-9 b(AR)33
b(\015ag)g(is)h(not)f(set,)j(no)d(output)i(v)-5 b(ariance)32
-b(estimates)h(will)h(b)r(e)h(calculated)e(and)427 5469
+b(estimates)h(will)h(b)r(e)h(calculated)e(and)427 3602
y(this)28 b(arra)n(y)d(will)j(not)g(b)r(e)g(used.)37
b(A)28 b(dumm)n(y)f(\(e.g.)37 b(one-elemen)n(t\))27 b(arra)n(y)f(ma)n
-(y)g(then)j(b)r(e)f(supplied.)259 5593 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 5693
-y Fj(The)c(global)e(status.)p eop end
-%%Page: 346 356
-TeXDict begin 346 355 bop 0 52 a FG(346)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Returned)h(V)-8
-b(alue:)259 491 y(AST)p Ft(_)p Fc(RESAMPLE)p Fl(<)p Fc(X)p
-Fl(>)31 b Fc(=)h(INTEGER)427 590 y Fj(The)h(n)n(um)n(b)r(er)f(of)g
-(output)h(pixels)g(for)f(whic)n(h)g(no)g(v)-5 b(alid)33
+(y)g(then)j(b)r(e)f(supplied.)259 3731 y Fc(ST)-8 b(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 3831
+y Fj(The)c(global)e(status.)0 3989 y Fc(Returned)32 b(V)-8
+b(alue:)259 4122 y(AST)p Ft(_)p Fc(RESAMPLE)p Fl(<)p
+Fc(X)p Fl(>)31 b Fc(=)h(INTEGER)427 4221 y Fj(The)h(n)n(um)n(b)r(er)f
+(of)g(output)h(pixels)g(for)f(whic)n(h)g(no)g(v)-5 b(alid)33
b(resampled)e(v)-5 b(alue)33 b(could)f(b)r(e)h(obtained.)51
-b(Th)n(us,)427 690 y(in)33 b(the)g(absence)f(of)h(an)n(y)f(error,)g(a)h
-(returned)f(v)-5 b(alue)33 b(of)f(zero)g(indicates)h(that)g(all)f(the)h
-(required)f(output)427 790 y(pixels)f(receiv)n(ed)f(v)-5
+b(Th)n(us,)427 4321 y(in)33 b(the)g(absence)f(of)h(an)n(y)f(error,)g(a)
+h(returned)f(v)-5 b(alue)33 b(of)f(zero)g(indicates)h(that)g(all)f(the)
+h(required)f(output)427 4421 y(pixels)f(receiv)n(ed)f(v)-5
b(alid)31 b(resampled)f(data)h(v)-5 b(alues)30 b(\(and)h(v)-5
b(ariances\).)46 b(See)31 b(the)h(BAD)n(V)-9 b(AL)31
-b(and)g(FLA)n(GS)427 889 y(argumen)n(ts.)0 1054 y Fc(Notes:)340
-1340 y Fi(\017)45 b Fj(A)27 b(v)-5 b(alue)25 b(of)h(zero)f(will)h(b)r
+b(and)g(FLA)n(GS)427 4520 y(argumen)n(ts.)0 4678 y Fc(Notes:)340
+4957 y Fi(\017)45 b Fj(A)27 b(v)-5 b(alue)25 b(of)h(zero)f(will)h(b)r
(e)g(returned)g(if)g(this)g(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j
-(the)f(global)f(error)f(status)h(set,)h(or)427 1440 y(if)i(it)g(should)
-g(fail)f(for)h(an)n(y)e(reason.)-2 1605 y Fc(Data)33
-b(T)m(yp)s(e)g(Co)s(des)n(:)227 1751 y Fj(T)-7 b(o)19
+(the)f(global)f(error)f(status)h(set,)h(or)427 5057 y(if)i(it)g(should)
+g(fail)f(for)h(an)n(y)e(reason.)-2 5215 y Fc(Data)33
+b(T)m(yp)s(e)g(Co)s(des)n(:)227 5361 y Fj(T)-7 b(o)19
b(select)g(the)g(appropriate)f(resampling)g(function,)j(y)n(ou)e
(should)f(replace)h Fl(<)p Fj(X)p Fl(>)f Fj(in)i(the)f(generic)f
-(function)i(name)227 1850 y(AST)p Ft(_)p Fj(RESAMPLE)p
+(function)i(name)227 5461 y(AST)p Ft(_)p Fj(RESAMPLE)p
Fl(<)p Fj(X)p Fl(>)i Fj(with)i(a)f(1-)f(or)g(2-c)n(haracter)f(data)i(t)
n(yp)r(e)g(co)r(de,)h(so)f(as)f(to)h(matc)n(h)g(the)h(n)n(umerical)e(t)
-n(yp)r(e)227 1950 y Fl(<)p Fj(Xt)n(yp)r(e)p Fl(>)27 b
+n(yp)r(e)227 5560 y Fl(<)p Fj(Xt)n(yp)r(e)p Fl(>)27 b
Fj(of)h(the)g(data)f(y)n(ou)g(are)g(pro)r(cessing,)f(as)h(follo)n(ws:)
-340 2089 y Fi(\017)45 b Fj(D:)28 b(DOUBLE)g(PRECISION)340
-2224 y Fi(\017)45 b Fj(R:)28 b(REAL)340 2358 y Fi(\017)45
-b Fj(I:)28 b(INTEGER)340 2493 y Fi(\017)45 b Fj(UI:)28
-b(INTEGER)f(\(treated)h(as)f(unsigned\))340 2627 y Fi(\017)45
-b Fj(S:)28 b(INTEGER)p Fi(\003)p Fj(2)e(\(short)h(in)n(teger\))340
-2761 y Fi(\017)45 b Fj(US:)28 b(INTEGER)p Fi(\003)p Fj(2)f(\(short)g
-(in)n(teger,)f(treated)i(as)f(unsigned\))340 2896 y Fi(\017)45
-b Fj(B:)28 b(BYTE)f(\(treated)h(as)e(signed\))340 3030
-y Fi(\017)45 b Fj(UB:)28 b(BYTE)f(\(treated)h(as)f(unsigned\))227
-3195 y(F)-7 b(or)33 b(example,)i(AST)p Ft(_)p Fj(RESAMPLED)e(w)n(ould)g
+340 5693 y Fi(\017)45 b Fj(D:)28 b(DOUBLE)g(PRECISION)p
+eop end
+%%Page: 349 359
+TeXDict begin 349 358 bop 3643 52 a FG(349)340 351 y
+Fi(\017)45 b Fj(R:)28 b(REAL)340 486 y Fi(\017)45 b Fj(I:)28
+b(INTEGER)340 621 y Fi(\017)45 b Fj(UI:)28 b(INTEGER)f(\(treated)h(as)f
+(unsigned\))340 756 y Fi(\017)45 b Fj(S:)28 b(INTEGER)p
+Fi(\003)p Fj(2)e(\(short)h(in)n(teger\))340 892 y Fi(\017)45
+b Fj(US:)28 b(INTEGER)p Fi(\003)p Fj(2)f(\(short)g(in)n(teger,)f
+(treated)i(as)f(unsigned\))340 1027 y Fi(\017)45 b Fj(B:)28
+b(BYTE)f(\(treated)h(as)e(signed\))340 1162 y Fi(\017)45
+b Fj(UB:)28 b(BYTE)f(\(treated)h(as)f(unsigned\))227
+1328 y(F)-7 b(or)33 b(example,)i(AST)p Ft(_)p Fj(RESAMPLED)e(w)n(ould)g
(b)r(e)h(used)f(to)h(pro)r(cess)e(DOUBLE)h(PRECISION)g(data,)h(while)
-227 3295 y(AST)p Ft(_)p Fj(RESAMPLES)23 b(w)n(ould)g(b)r(e)h(used)f(to)
+227 1428 y(AST)p Ft(_)p Fj(RESAMPLES)23 b(w)n(ould)g(b)r(e)h(used)f(to)
g(pro)r(cess)g(short)f(in)n(teger)h(data)g(\(stored)g(in)g(an)h
-(INTEGER)p Fi(\003)p Fj(2)e(arra)n(y\),)227 3395 y(etc.)227
-3521 y(F)-7 b(or)32 b(compatibilit)n(y)h(with)g(other)f(Starlink)g
+(INTEGER)p Fi(\003)p Fj(2)e(arra)n(y\),)227 1527 y(etc.)227
+1654 y(F)-7 b(or)32 b(compatibilit)n(y)h(with)g(other)f(Starlink)g
(facilities,)i(the)f(co)r(des)g(W)g(and)f(UW)h(are)f(pro)n(vided)g(as)g
-(synon)n(yms)227 3620 y(for)27 b(S)h(and)g(US)g(resp)r(ectiv)n(ely)e
+(synon)n(yms)227 1754 y(for)27 b(S)h(and)g(US)g(resp)r(ectiv)n(ely)e
(\(but)j(only)e(in)h(the)g(F)-7 b(ortran)26 b(in)n(terface)h(to)h
-(AST\).)-2 3773 y Fc(Sub-Pixel)k(In)m(terp)s(olation)f(Sc)m(hemes)n(:)
-227 3919 y Fj(There)d(is)f(no)h(suc)n(h)f(thing)h(as)g(a)f(p)r(erfect)h
+(AST\).)-2 1908 y Fc(Sub-Pixel)k(In)m(terp)s(olation)f(Sc)m(hemes)n(:)
+227 2054 y Fj(There)d(is)f(no)h(suc)n(h)f(thing)h(as)g(a)f(p)r(erfect)h
(sub-pixel)g(in)n(terp)r(olation)f(sc)n(heme)g(and,)h(in)g(practice,)f
-(all)h(resampling)227 4019 y(will)34 b(result)e(in)i(some)e
+(all)h(resampling)227 2153 y(will)34 b(result)e(in)i(some)e
(degradation)f(of)i(gridded)g(data.)52 b(A)34 b(range)d(of)i(sc)n
-(hemes)g(is)f(therefore)h(pro)n(vided,)g(from)227 4118
+(hemes)g(is)f(therefore)h(pro)n(vided,)g(from)227 2253
y(whic)n(h)28 b(y)n(ou)f(can)g(c)n(ho)r(ose)f(the)i(one)f(whic)n(h)h(b)
-r(est)g(suits)g(y)n(our)e(needs.)227 4244 y(In)h(general,)e(a)g
+r(est)g(suits)g(y)n(our)e(needs.)227 2380 y(In)h(general,)e(a)g
(balance)h(m)n(ust)g(b)r(e)g(struc)n(k)f(b)r(et)n(w)n(een)i(sc)n(hemes)
e(whic)n(h)h(tend)g(to)g(degrade)f(sharp)g(features)h(in)g(the)227
-4344 y(data)d(b)n(y)g(smo)r(othing)g(them,)i(and)f(those)f(whic)n(h)g
+2479 y(data)d(b)n(y)g(smo)r(othing)g(them,)i(and)f(those)f(whic)n(h)g
(attempt)h(to)g(preserv)n(e)d(sharp)i(features.)35 b(The)24
-b(latter)f(will)g(often)227 4444 y(tend)32 b(to)g(in)n(tro)r(duce)f(un)
+b(latter)f(will)g(often)227 2579 y(tend)32 b(to)g(in)n(tro)r(duce)f(un)
n(w)n(an)n(ted)g(oscillations,)g(t)n(ypically)g(visible)g(as)g
Ft(")p Fj(ringing)p Ft(")f Fj(around)g(sharp)h(features)g(and)227
-4543 y(edges,)j(esp)r(ecially)f(if)g(the)h(data)e(are)g(under-sampled)h
+2679 y(edges,)j(esp)r(ecially)f(if)g(the)h(data)e(are)g(under-sampled)h
(\(i.e.)54 b(if)33 b(the)h(sharp)r(est)e(features)h(are)f(less)g(than)i
-(ab)r(out)227 4643 y(t)n(w)n(o)27 b(pixels)h(across\).)36
+(ab)r(out)227 2778 y(t)n(w)n(o)27 b(pixels)h(across\).)36
b(In)28 b(practice,)f(a)g(go)r(o)r(d)h(in)n(terp)r(olation)e(sc)n(heme)
i(is)g(lik)n(ely)f(to)h(b)r(e)g(a)f(compromise)g(and)g(ma)n(y)227
-4742 y(exhibit)h(some)f(asp)r(ects)h(of)f(b)r(oth)h(these)g(features.)
-227 4869 y(F)-7 b(or)31 b(under-sampled)g(data,)h(some)f(in)n(terp)r
+2878 y(exhibit)h(some)f(asp)r(ects)h(of)f(b)r(oth)h(these)g(features.)
+227 3005 y(F)-7 b(or)31 b(under-sampled)g(data,)h(some)f(in)n(terp)r
(olation)g(sc)n(hemes)f(ma)n(y)h(app)r(ear)g(to)g(preserv)n(e)f(data)h
-(resolution)g(b)r(e-)227 4968 y(cause)25 b(they)h(transform)e(single)h
+(resolution)g(b)r(e-)227 3104 y(cause)25 b(they)h(transform)e(single)h
(input)h(pixels)g(in)n(to)f(single)g(output)h(pixels,)f(rather)g(than)g
-(spreading)g(their)g(data)227 5068 y(b)r(et)n(w)n(een)j(sev)n(eral)e
+(spreading)g(their)g(data)227 3204 y(b)r(et)n(w)n(een)j(sev)n(eral)e
(output)j(pixels.)38 b(While)28 b(this)h(ma)n(y)e(lo)r(ok)g(b)r(etter)i
(cosmetically)-7 b(,)27 b(it)h(can)g(result)g(in)g(a)g(geomet-)227
-5167 y(rical)e(shift)h(of)g(sharp)e(features)h(in)h(the)g(data.)36
+3304 y(rical)e(shift)h(of)g(sharp)e(features)h(in)h(the)g(data.)36
b(Y)-7 b(ou)26 b(should)g(b)r(ew)n(are)g(of)g(this)h(if)g(y)n(ou)f
-(plan)g(to)h(use)f(suc)n(h)g(features)227 5267 y(\(e.g.\))37
-b(for)27 b(image)g(alignmen)n(t.)227 5393 y(The)j(follo)n(wing)f(are)h
+(plan)g(to)h(use)f(suc)n(h)g(features)227 3403 y(\(e.g.\))37
+b(for)27 b(image)g(alignmen)n(t.)227 3530 y(The)j(follo)n(wing)f(are)h
(t)n(w)n(o)f(easy-to-use)f(sub-pixel)i(in)n(terp)r(olation)f(sc)n
(hemes)g(whic)n(h)h(are)g(generally)e(applicable.)227
-5493 y(They)k(are)f(selected)h(b)n(y)g(supplying)g(the)g(appropriate)e
+3630 y(They)k(are)f(selected)h(b)n(y)g(supplying)g(the)g(appropriate)e
(v)-5 b(alue)32 b(\(de\014ned)h(in)f(the)g(AST)p Ft(_)p
-Fj(P)-7 b(AR)32 b(include)h(\014le\))f(via)227 5592 y(the)c(INTERP)f
+Fj(P)-7 b(AR)32 b(include)h(\014le\))f(via)227 3729 y(the)c(INTERP)f
(argumen)n(t.)36 b(In)28 b(these)f(cases,)g(the)h(FINTERP)f(and)h(P)-7
-b(ARAMS)28 b(argumen)n(ts)e(are)h(not)g(used:)p eop end
-%%Page: 347 357
-TeXDict begin 347 356 bop 3643 52 a FG(347)340 351 y
-Fi(\017)45 b Fj(AST)p Ft(__)p Fj(NEAREST:)24 b(This)h(is)f(the)h
+b(ARAMS)28 b(argumen)n(ts)e(are)h(not)g(used:)340 3997
+y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(NEAREST:)24 b(This)h(is)f(the)h
(simplest)g(p)r(ossible)f(sc)n(heme,)h(in)g(whic)n(h)f(the)h(v)-5
-b(alue)25 b(of)f(the)h(input)h(pixel)427 451 y(with)j(the)g(nearest)f
+b(alue)25 b(of)f(the)h(input)h(pixel)427 4096 y(with)j(the)g(nearest)f
(cen)n(tre)g(to)h(the)g(in)n(terp)r(olation)f(p)r(oin)n(t)g(is)h(used.)
40 b(This)29 b(is)f(v)n(ery)g(quic)n(k)g(to)g(execute)h(and)427
-551 y(will)38 b(preserv)n(e)d(single-pixel)h(features)h(in)g(the)h
+4196 y(will)38 b(preserv)n(e)d(single-pixel)h(features)h(in)g(the)h
(data,)h(but)f(ma)n(y)e(displace)h(them)h(b)n(y)f(up)g(to)g(half)h
-(their)427 650 y(width)28 b(along)e(eac)n(h)h(dimension.)36
+(their)427 4296 y(width)28 b(along)e(eac)n(h)h(dimension.)36
b(It)28 b(often)g(giv)n(es)e(a)g(go)r(o)r(d)h(cosmetic)g(result,)g(so)g
-(is)g(useful)g(for)g(quic)n(k-lo)r(ok)427 750 y(pro)r(cessing,)f(but)j
+(is)g(useful)g(for)g(quic)n(k-lo)r(ok)427 4395 y(pro)r(cessing,)f(but)j
(is)e(unsuitable)h(if)g(accurate)e(geometrical)g(transformation)g(is)i
-(required.)340 882 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(LINEAR:)40
+(required.)340 4530 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(LINEAR:)40
b(This)h(is)f(the)h(default)g(sc)n(heme,)j(whic)n(h)c(uses)g(linear)g
-(in)n(terp)r(olation)g(b)r(et)n(w)n(een)g(the)427 982
+(in)n(terp)r(olation)g(b)r(et)n(w)n(een)g(the)427 4630
y(nearest)35 b(neigh)n(b)r(ouring)f(pixels)i(in)g(the)g(input)g(grid)f
(\(there)h(are)e(t)n(w)n(o)h(neigh)n(b)r(ours)g(in)g(one)h(dimension,)
-427 1081 y(four)h(neigh)n(b)r(ours)f(in)i(t)n(w)n(o)f(dimensions,)i
+427 4730 y(four)h(neigh)n(b)r(ours)f(in)i(t)n(w)n(o)f(dimensions,)i
(eigh)n(t)e(in)h(three)f(dimensions,)i(etc.\).)67 b(It)38
-b(is)f(sup)r(erior)f(to)h(the)427 1181 y(nearest-pixel)25
+b(is)f(sup)r(erior)f(to)h(the)427 4829 y(nearest-pixel)25
b(sc)n(heme)h(\(ab)r(o)n(v)n(e\))g(in)g(not)g(displacing)g(features)g
(in)g(the)h(data,)f(y)n(et)g(it)h(still)f(executes)g(fairly)427
-1280 y(rapidly)-7 b(.)74 b(It)40 b(is)g(generally)e(a)i(safe)f(c)n
+4929 y(rapidly)-7 b(.)74 b(It)40 b(is)g(generally)e(a)i(safe)f(c)n
(hoice)g(if)i(y)n(ou)e(do)h(not)g(ha)n(v)n(e)e(an)n(y)h(particular)g
-(reason)f(to)i(fa)n(v)n(our)427 1380 y(another)g(sc)n(heme,)k(since)c
+(reason)f(to)i(fa)n(v)n(our)427 5029 y(another)g(sc)n(heme,)k(since)c
(it)h(cannot)g(in)n(tro)r(duce)f(oscillations.)75 b(Ho)n(w)n(ev)n(er,)
-42 b(it)f(do)r(es)g(in)n(tro)r(duce)f(some)427 1480 y(spatial)28
+42 b(it)f(do)r(es)g(in)n(tro)r(duce)f(some)427 5128 y(spatial)28
b(smo)r(othing)f(whic)n(h)i(v)-5 b(aries)27 b(according)f(to)i(the)h
(distance)f(of)g(the)h(in)n(terp)r(olation)e(p)r(oin)n(t)h(from)g(the)
-427 1579 y(neigh)n(b)r(ouring)g(pixels.)39 b(This)29
+427 5228 y(neigh)n(b)r(ouring)g(pixels.)39 b(This)29
b(can)f(degrade)f(the)i(shap)r(e)f(of)h(sharp)e(features)h(in)h(the)g
-(data)f(in)h(a)f(p)r(osition-)427 1679 y(dep)r(enden)n(t)f(w)n(a)n(y)-7
+(data)f(in)h(a)f(p)r(osition-)427 5327 y(dep)r(enden)n(t)f(w)n(a)n(y)-7
b(.)35 b(It)27 b(ma)n(y)e(also)g(sho)n(w)h(in)g(the)h(output)g(v)-5
b(ariance)24 b(grid)i(\(if)h(used\))f(as)g(a)g(pattern)g(of)g(strip)r
-(es)427 1779 y(or)h(fringes.)227 1940 y(An)35 b(alternativ)n(e)e(set)h
+(es)427 5427 y(or)h(fringes.)227 5593 y(An)35 b(alternativ)n(e)e(set)h
(of)h(in)n(terp)r(olation)e(sc)n(hemes)h(is)g(based)g(on)g(forming)g
(the)g(in)n(terp)r(olated)g(v)-5 b(alue)34 b(from)g(the)227
-2039 y(w)n(eigh)n(ted)g(sum)h(of)f(a)g(set)h(of)f(surrounding)f(pixel)i
+5693 y(w)n(eigh)n(ted)g(sum)h(of)f(a)g(set)h(of)f(surrounding)f(pixel)i
(v)-5 b(alues)34 b(\(not)h(necessarily)e(just)i(the)g(nearest)e(neigh)n
-(b)r(ours\).)227 2139 y(This)27 b(approac)n(h)e(has)h(its)h(origins)e
-(in)i(the)g(theory)f(of)h(digital)f(\014ltering,)h(in)f(whic)n(h)h(in)n
-(terp)r(olated)f(v)-5 b(alues)27 b(are)e(ob-)227 2239
-y(tained)f(b)n(y)g(conceptually)f(passing)g(the)h(sampled)f(data)h
-(\(represen)n(ted)e(b)n(y)i(a)f(grid)g(of)h(delta)g(functions\))g
-(through)227 2338 y(a)30 b(linear)g(\014lter)g(whic)n(h)g(implemen)n
-(ts)h(a)f(con)n(v)n(olution.)43 b(Because)29 b(the)i(con)n(v)n(olution)
-e(k)n(ernel)g(is)h(con)n(tin)n(uous,)g(the)227 2438 y(con)n(v)n
-(olution)23 b(yields)h(a)g(con)n(tin)n(uous)f(function)h(whic)n(h)g(ma)
-n(y)g(then)g(b)r(e)h(ev)-5 b(aluated)24 b(at)g(fractional)f(pixel)h(p)r
-(ositions.)227 2537 y(The)33 b(\(p)r(ossibly)g(m)n(ulti-dimensional\))f
-(k)n(ernel)g(is)h(usually)f(regarded)f(as)h Ft(")p Fj(separable)p
-Ft(")e Fj(and)i(formed)h(from)f(the)227 2637 y(pro)r(duct)22
+(b)r(ours\).)p eop end
+%%Page: 350 360
+TeXDict begin 350 359 bop 0 52 a FG(350)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)227 351 y Fj(This)c(approac)n(h)e
+(has)h(its)h(origins)e(in)i(the)g(theory)f(of)h(digital)f(\014ltering,)
+h(in)f(whic)n(h)h(in)n(terp)r(olated)f(v)-5 b(alues)27
+b(are)e(ob-)227 451 y(tained)f(b)n(y)g(conceptually)f(passing)g(the)h
+(sampled)f(data)h(\(represen)n(ted)e(b)n(y)i(a)f(grid)g(of)h(delta)g
+(functions\))g(through)227 551 y(a)30 b(linear)g(\014lter)g(whic)n(h)g
+(implemen)n(ts)h(a)f(con)n(v)n(olution.)43 b(Because)29
+b(the)i(con)n(v)n(olution)e(k)n(ernel)g(is)h(con)n(tin)n(uous,)g(the)
+227 650 y(con)n(v)n(olution)23 b(yields)h(a)g(con)n(tin)n(uous)f
+(function)h(whic)n(h)g(ma)n(y)g(then)g(b)r(e)h(ev)-5
+b(aluated)24 b(at)g(fractional)f(pixel)h(p)r(ositions.)227
+750 y(The)33 b(\(p)r(ossibly)g(m)n(ulti-dimensional\))f(k)n(ernel)g(is)
+h(usually)f(regarded)f(as)h Ft(")p Fj(separable)p Ft(")e
+Fj(and)i(formed)h(from)f(the)227 849 y(pro)r(duct)22
b(of)g(a)f(set)h(of)g(iden)n(tical)g(1-dimensional)e(k)n(ernel)h
(functions,)i(ev)-5 b(aluated)22 b(along)f(eac)n(h)g(dimension.)35
-b(Di\013er-)227 2737 y(en)n(t)29 b(in)n(terp)r(olation)f(sc)n(hemes)h
+b(Di\013er-)227 949 y(en)n(t)29 b(in)n(terp)r(olation)f(sc)n(hemes)h
(are)e(then)j(distinguished)f(b)n(y)f(the)i(c)n(hoice)e(of)h(this)g
-(1-dimensional)e(in)n(terp)r(olation)227 2836 y(k)n(ernel.)36
+(1-dimensional)e(in)n(terp)r(olation)227 1049 y(k)n(ernel.)36
b(The)28 b(n)n(um)n(b)r(er)f(of)h(surrounding)e(pixels)h(whic)n(h)h
(con)n(tribute)f(to)h(the)g(result)f(ma)n(y)g(also)f(b)r(e)i(v)-5
-b(aried.)227 2961 y(F)e(rom)29 b(a)f(practical)g(standp)r(oin)n(t,)h
+b(aried.)227 1169 y(F)e(rom)29 b(a)f(practical)g(standp)r(oin)n(t,)h
(it)h(is)f(useful)g(to)g(divide)g(the)g(w)n(eigh)n(ted)f(sum)h(of)g
(pixel)g(v)-5 b(alues)29 b(b)n(y)f(the)i(sum)f(of)227
-3060 y(the)g(w)n(eigh)n(ts)e(when)h(determining)g(the)h(in)n(terp)r
+1269 y(the)g(w)n(eigh)n(ts)e(when)h(determining)g(the)h(in)n(terp)r
(olated)e(v)-5 b(alue.)38 b(Strictly)-7 b(,)29 b(this)f(means)g(that)g
-(a)g(true)g(con)n(v)n(olution)227 3160 y(is)e(no)f(longer)g(b)r(eing)h
+(a)g(true)g(con)n(v)n(olution)227 1368 y(is)e(no)f(longer)g(b)r(eing)h
(p)r(erformed.)36 b(Ho)n(w)n(ev)n(er,)24 b(the)i(distinction)g(is)g
(rarely)e(imp)r(ortan)n(t)h(in)h(practice)f(b)r(ecause)h(\(for)227
-3259 y(sligh)n(tly)e(subtle)h(reasons\))d(the)j(sum)f(of)g(w)n(eigh)n
+1468 y(sligh)n(tly)e(subtle)h(reasons\))d(the)j(sum)f(of)g(w)n(eigh)n
(ts)g(is)g(alw)n(a)n(ys)e(appro)n(ximately)h(constan)n(t)g(for)h(go)r
-(o)r(d)f(in)n(terp)r(olation)227 3359 y(k)n(ernels.)51
+(o)r(d)f(in)n(terp)r(olation)227 1568 y(k)n(ernels.)51
b(The)33 b(adv)-5 b(an)n(tage)31 b(of)i(this)g(tec)n(hnique,)h(whic)n
(h)f(is)f(used)h(here,)h(is)e(that)h(it)g(can)g(easily)f(accommo)r
-(date)227 3459 y(missing)27 b(data)g(and)h(tends)g(to)f(minimise)h(un)n
+(date)227 1667 y(missing)27 b(data)g(and)h(tends)g(to)f(minimise)h(un)n
(w)n(an)n(ted)f(oscillations)f(at)i(the)g(edges)f(of)g(the)h(data)f
-(grid.)227 3583 y(In)d(the)g(follo)n(wing)e(sc)n(hemes,)h(whic)n(h)h
+(grid.)227 1788 y(In)d(the)g(follo)n(wing)e(sc)n(hemes,)h(whic)n(h)h
(are)e(based)h(on)g(a)g(1-dimensional)f(in)n(terp)r(olation)g(k)n
-(ernel,)i(the)f(\014rst)g(elemen)n(t)227 3682 y(of)j(the)g(P)-7
+(ernel,)i(the)f(\014rst)g(elemen)n(t)227 1887 y(of)j(the)g(P)-7
b(ARAMS)26 b(arra)n(y)e(should)h(b)r(e)h(used)g(to)f(sp)r(ecify)h(ho)n
(w)f(man)n(y)h(pixels)f(are)g(to)g(con)n(tribute)h(to)f(the)h(in)n
-(terp)r(o-)227 3782 y(lated)31 b(result)g(on)f(either)h(side)g(of)f
+(terp)r(o-)227 1987 y(lated)31 b(result)g(on)f(either)h(side)g(of)f
(the)i(in)n(terp)r(olation)e(p)r(oin)n(t)h(in)g(eac)n(h)f(dimension)g
-(\(the)i(nearest)e(in)n(teger)g(v)-5 b(alue)227 3882
+(\(the)i(nearest)e(in)n(teger)g(v)-5 b(alue)227 2086
y(is)27 b(used\).)36 b(Execution)26 b(time)h(increases)e(rapidly)h
(with)h(this)f(n)n(um)n(b)r(er.)36 b(T)n(ypically)-7
b(,)26 b(a)g(v)-5 b(alue)27 b(of)f(2)g(is)g(appropriate)227
-3981 y(and)k(the)h(minim)n(um)f(v)-5 b(alue)30 b(used)g(will)g(b)r(e)h
+2186 y(and)k(the)h(minim)n(um)f(v)-5 b(alue)30 b(used)g(will)g(b)r(e)h
(1)f(\(i.e.)44 b(t)n(w)n(o)29 b(pixels)h(altogether,)g(one)f(on)h
-(either)g(side)g(of)g(the)g(in)n(ter-)227 4081 y(p)r(olation)g(p)r(oin)
+(either)g(side)g(of)g(the)g(in)n(ter-)227 2286 y(p)r(olation)g(p)r(oin)
n(t\).)44 b(A)30 b(v)-5 b(alue)30 b(of)f(zero)g(or)g(less)g(ma)n(y)h(b)
r(e)g(giv)n(en)f(for)g(P)-7 b(ARAMS\(1\))31 b(to)e(indicate)h(that)g(a)
-g(suitable)227 4181 y(n)n(um)n(b)r(er)e(of)f(pixels)h(should)f(b)r(e)h
-(calculated)f(automatically)-7 b(.)227 4305 y(In)28 b(eac)n(h)f(of)g
+g(suitable)227 2385 y(n)n(um)n(b)r(er)e(of)f(pixels)h(should)f(b)r(e)h
+(calculated)f(automatically)-7 b(.)227 2506 y(In)28 b(eac)n(h)f(of)g
(these)h(cases,)f(the)h(FINTERP)f(argumen)n(t)f(is)i(not)f(used:)340
-4565 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(GA)n(USS:)22
+2754 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(GA)n(USS:)22
b(This)g(sc)n(heme)f(uses)g(a)g(k)n(ernel)g(of)h(the)g(form)f(exp\(-k)p
Fi(\003)p Fj(x)p Fi(\003)p Fj(x\),)g(with)h(k)g(a)f(p)r(ositiv)n(e)g
-(constan)n(t.)427 4664 y(The)32 b(full-width)g(at)g(half-maxim)n(um)f
+(constan)n(t.)427 2854 y(The)32 b(full-width)g(at)g(half-maxim)n(um)f
(\(FWHM\))i(is)e(giv)n(en)g(b)n(y)g(P)-7 b(ARAMS\(2\))32
-b(v)-5 b(alue,)33 b(whic)n(h)e(should)g(b)r(e)427 4764
+b(v)-5 b(alue,)33 b(whic)n(h)e(should)g(b)r(e)427 2953
y(at)f(least)g(0.1)f(\(in)h(addition,)h(setting)f(P)-7
b(ARAMS\(1\))30 b(to)g(zero)f(will)h(select)g(the)h(n)n(um)n(b)r(er)e
-(of)h(con)n(tributing)427 4864 y(pixels)e(so)f(as)h(to)g(utilise)g(the)
+(of)h(con)n(tributing)427 3053 y(pixels)e(so)f(as)h(to)g(utilise)g(the)
g(width)h(of)f(the)g(k)n(ernel)f(out)h(to)g(where)g(the)g(en)n(v)n
-(elop)r(e)f(declines)h(to)g(1\045)f(of)h(its)427 4963
+(elop)r(e)f(declines)h(to)g(1\045)f(of)h(its)427 3153
y(maxim)n(um)d(v)-5 b(alue\).)36 b(This)25 b(k)n(ernel)f(suppresses)g
(noise)g(at)h(the)g(exp)r(ense)g(of)g(smo)r(othing)f(the)h(output)h
-(arra)n(y)-7 b(.)340 5095 y Fi(\017)45 b Fj(AST)p Ft(__)p
+(arra)n(y)-7 b(.)340 3277 y Fi(\017)45 b Fj(AST)p Ft(__)p
Fj(SINC:)27 b(This)f(sc)n(heme)g(uses)g(a)g(sinc\(pi)p
Fi(\003)p Fj(x\))g(k)n(ernel,)g(where)g(x)g(is)g(the)h(pixel)f
-(o\013set)h(from)f(the)g(in)n(ter-)427 5195 y(p)r(olation)j(p)r(oin)n
+(o\013set)h(from)f(the)g(in)n(ter-)427 3377 y(p)r(olation)j(p)r(oin)n
(t)h(and)g(sinc\(z\)=sin\(z\)/z.)42 b(This)30 b(sometimes)f(features)g
(as)g(an)g Ft(")p Fj(optimal)p Ft(")f Fj(in)n(terp)r(olation)427
-5295 y(k)n(ernel)35 b(in)h(b)r(o)r(oks)f(on)g(image)g(pro)r(cessing.)59
+3476 y(k)n(ernel)35 b(in)h(b)r(o)r(oks)f(on)g(image)g(pro)r(cessing.)59
b(Its)36 b(supp)r(osed)f(optimalit)n(y)h(dep)r(ends)g(on)f(the)h
-(assumption)427 5394 y(that)d(the)g(data)e(are)h(band-limited)g(\(i.e.)
+(assumption)427 3576 y(that)d(the)g(data)e(are)h(band-limited)g(\(i.e.)
52 b(ha)n(v)n(e)31 b(no)h(spatial)g(frequencies)g(ab)r(o)n(v)n(e)f(a)h
-(certain)f(v)-5 b(alue\))33 b(and)427 5494 y(are)e(adequately)g
+(certain)f(v)-5 b(alue\))33 b(and)427 3676 y(are)e(adequately)g
(sampled.)49 b(In)32 b(practice,)g(astronomical)d(data)j(rarely)e(meet)
-i(these)f(requiremen)n(ts.)48 b(In)427 5593 y(addition,)35
+i(these)f(requiremen)n(ts.)48 b(In)427 3775 y(addition,)35
b(high)e(spatial)g(frequencies)f(are)h(often)g(presen)n(t)g(due)g
(\(e.g.\))54 b(to)33 b(image)g(defects)g(and)g(cosmic)427
-5693 y(ra)n(y)22 b(ev)n(en)n(ts.)35 b(Consequen)n(tly)-7
+3875 y(ra)n(y)22 b(ev)n(en)n(ts.)35 b(Consequen)n(tly)-7
b(,)24 b(substan)n(tial)e(ringing)h(can)g(b)r(e)h(exp)r(erienced)f
-(with)h(this)f(k)n(ernel.)35 b(The)24 b(k)n(ernel)p eop
-end
-%%Page: 348 358
-TeXDict begin 348 357 bop 0 52 a FG(348)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(also)i(deca)n(ys)g
-(slo)n(wly)g(with)i(distance,)g(so)e(that)i(man)n(y)e(surrounding)g
-(pixels)h(are)f(required,)h(leading)g(to)427 451 y(p)r(o)r(or)24
-b(p)r(erformance.)35 b(Abruptly)25 b(truncating)g(it,)g(b)n(y)g(using)f
-(only)g(a)h(few)g(neigh)n(b)r(ouring)e(pixels,)i(impro)n(v)n(es)427
-551 y(p)r(erformance)37 b(and)g(ma)n(y)g(reduce)h(ringing)e(\(if)j(P)-7
-b(ARAMS\(1\))38 b(is)g(set)g(to)f(zero,)i(then)g(only)e(t)n(w)n(o)g
-(pixels)427 650 y(will)31 b(b)r(e)g(used)g(on)f(either)g(side\).)46
+(with)h(this)f(k)n(ernel.)35 b(The)24 b(k)n(ernel)427
+3974 y(also)33 b(deca)n(ys)g(slo)n(wly)g(with)i(distance,)g(so)e(that)i
+(man)n(y)e(surrounding)g(pixels)h(are)f(required,)h(leading)g(to)427
+4074 y(p)r(o)r(or)24 b(p)r(erformance.)35 b(Abruptly)25
+b(truncating)g(it,)g(b)n(y)g(using)f(only)g(a)h(few)g(neigh)n(b)r
+(ouring)e(pixels,)i(impro)n(v)n(es)427 4174 y(p)r(erformance)37
+b(and)g(ma)n(y)g(reduce)h(ringing)e(\(if)j(P)-7 b(ARAMS\(1\))38
+b(is)g(set)g(to)f(zero,)i(then)g(only)e(t)n(w)n(o)g(pixels)427
+4273 y(will)31 b(b)r(e)g(used)g(on)f(either)g(side\).)46
b(Ho)n(w)n(ev)n(er,)30 b(a)g(more)g(gradual)f(truncation,)i(as)f
-(implemen)n(ted)h(b)n(y)f(other)427 750 y(k)n(ernels,)c(is)g(generally)
-f(to)h(b)r(e)g(preferred.)36 b(This)26 b(k)n(ernel)f(is)i(pro)n(vided)e
-(mainly)h(so)g(that)g(y)n(ou)g(can)g(con)n(vince)427
-849 y(y)n(ourself)h(not)g(to)h(use)f(it!)340 978 y Fi(\017)45
-b Fj(AST)p Ft(__)p Fj(SINCSINC:)25 b(This)g(sc)n(heme)g(uses)f(an)h
-(impro)n(v)n(ed)e(k)n(ernel,)i(of)g(the)g(form)f(sinc\(pi)p
+(implemen)n(ted)h(b)n(y)f(other)427 4373 y(k)n(ernels,)c(is)g
+(generally)f(to)h(b)r(e)g(preferred.)36 b(This)26 b(k)n(ernel)f(is)i
+(pro)n(vided)e(mainly)h(so)g(that)g(y)n(ou)g(can)g(con)n(vince)427
+4473 y(y)n(ourself)h(not)g(to)h(use)f(it!)340 4597 y
+Fi(\017)45 b Fj(AST)p Ft(__)p Fj(SINCSINC:)25 b(This)g(sc)n(heme)g
+(uses)f(an)h(impro)n(v)n(ed)e(k)n(ernel,)i(of)g(the)g(form)f(sinc\(pi)p
Fi(\003)p Fj(x\).sinc\(k)p Fi(\003)p Fj(pi)p Fi(\003)p
-Fj(x\),)427 1078 y(with)32 b(k)f(a)f(constan)n(t,)h(out)g(to)g(the)g(p)
+Fj(x\),)427 4697 y(with)32 b(k)f(a)f(constan)n(t,)h(out)g(to)g(the)g(p)
r(oin)n(t)g(where)g(sinc\(k)p Fi(\003)p Fj(pi)p Fi(\003)p
Fj(x\))f(go)r(es)g(to)h(zero,)f(and)h(zero)f(b)r(ey)n(ond.)47
-b(The)427 1178 y(second)32 b(sinc\(\))i(factor)e(pro)n(vides)f(an)i
+b(The)427 4796 y(second)32 b(sinc\(\))i(factor)e(pro)n(vides)f(an)i
Ft(")p Fj(en)n(v)n(elop)r(e)p Ft(")e Fj(whic)n(h)i(gradually)e(rolls)h
(o\013)h(the)g(normal)f(sinc\(pi)p Fi(\003)p Fj(x\))427
-1277 y(k)n(ernel)27 b(at)g(large)e(o\013sets.)37 b(The)27
+4896 y(k)n(ernel)27 b(at)g(large)e(o\013sets.)37 b(The)27
b(width)h(of)f(this)g(en)n(v)n(elop)r(e)g(is)g(sp)r(eci\014ed)g(b)n(y)g
-(giving)f(the)i(n)n(um)n(b)r(er)f(of)g(pixels)427 1377
+(giving)f(the)i(n)n(um)n(b)r(er)f(of)g(pixels)427 4996
y(o\013set)j(at)f(whic)n(h)h(it)g(go)r(es)e(to)i(zero)e(b)n(y)h(means)g
(of)h(the)g(P)-7 b(ARAMS\(2\))30 b(v)-5 b(alue,)30 b(whic)n(h)f(should)
-h(b)r(e)g(at)f(least)427 1476 y(1.0)34 b(\(in)i(addition,)g(setting)f
+h(b)r(e)g(at)f(least)427 5095 y(1.0)34 b(\(in)i(addition,)g(setting)f
(P)-7 b(ARAMS\(1\))36 b(to)e(zero)g(will)h(select)g(the)g(n)n(um)n(b)r
-(er)g(of)g(con)n(tributing)f(pixels)427 1576 y(so)g(as)g(to)g(utilise)g
+(er)g(of)g(con)n(tributing)f(pixels)427 5195 y(so)g(as)g(to)g(utilise)g
(the)h(full)g(width)g(of)g(the)f(k)n(ernel,)h(out)g(to)f(where)g(it)h
(reac)n(hes)d(zero\).)57 b(The)34 b(case)f(giv)n(en)427
-1676 y(b)n(y)i(P)-7 b(ARAMS\(1\)=2,)37 b(P)-7 b(ARAMS\(2\)=2)35
+5295 y(b)n(y)i(P)-7 b(ARAMS\(1\)=2,)37 b(P)-7 b(ARAMS\(2\)=2)35
b(is)g(t)n(ypically)g(a)g(go)r(o)r(d)f(c)n(hoice)h(and)g(is)g
-(sometimes)g(kno)n(wn)f(as)427 1775 y(the)i(Lanczos)e(k)n(ernel.)60
+(sometimes)g(kno)n(wn)f(as)427 5394 y(the)i(Lanczos)e(k)n(ernel.)60
b(This)35 b(is)g(a)g(v)-5 b(aluable)35 b(general-purp)r(ose)e(in)n
-(terp)r(olation)i(sc)n(heme,)i(in)n(termediate)427 1875
+(terp)r(olation)i(sc)n(heme,)i(in)n(termediate)427 5494
y(in)d(its)f(visual)g(e\013ect)h(on)f(images)f(b)r(et)n(w)n(een)h(the)h
(AST)p Ft(__)p Fj(NEAREST)e(and)h(AST)p Ft(__)p Fj(LINEAR)g(sc)n
-(hemes.)427 1975 y(Although)i(the)f(k)n(ernel)f(is)h(sligh)n(tly)g
+(hemes.)427 5593 y(Although)i(the)f(k)n(ernel)f(is)h(sligh)n(tly)g
(oscillatory)-7 b(,)34 b(ringing)f(is)h(adequately)f(suppressed)h(if)g
-(the)h(data)f(are)427 2074 y(w)n(ell)28 b(sampled.)340
-2203 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(SINCCOS:)38 b(This)g(sc)n(heme)
-g(uses)g(a)g(k)n(ernel)f(of)h(the)h(form)f(sinc\(pi)p
-Fi(\003)p Fj(x\).cos\(k)p Fi(\003)p Fj(pi)p Fi(\003)p
-Fj(x\),)h(with)g(k)f(a)427 2303 y(constan)n(t,)32 b(out)f(to)g(the)h(p)
-r(oin)n(t)f(where)g(cos\(k)p Fi(\003)p Fj(pi)p Fi(\003)p
-Fj(x\))f(go)r(es)h(to)g(zero,)g(and)g(zero)f(b)r(ey)n(ond.)48
-b(As)31 b(ab)r(o)n(v)n(e,)g(the)427 2402 y(cos\(\))h(factor)f(pro)n
-(vides)f(an)h(en)n(v)n(elop)r(e)g(whic)n(h)h(gradually)e(rolls)g(o\013)
-i(the)g(sinc\(\))g(k)n(ernel)f(at)h(large)e(o\013sets.)427
-2502 y(The)e(width)h(of)e(this)h(en)n(v)n(elop)r(e)f(is)h(sp)r
-(eci\014ed)g(b)n(y)f(giving)g(the)h(n)n(um)n(b)r(er)g(of)g(pixels)f
-(o\013set)h(at)g(whic)n(h)f(it)i(go)r(es)427 2602 y(to)d(zero)f(b)n(y)g
-(means)g(of)h(the)g(P)-7 b(ARAMS\(2\))27 b(v)-5 b(alue,)26
-b(whic)n(h)g(should)f(b)r(e)h(at)g(least)f(1.0)g(\(in)i(addition,)f
-(setting)427 2701 y(P)-7 b(ARAMS\(1\))38 b(to)f(zero)f(will)i(select)f
-(the)g(n)n(um)n(b)r(er)g(of)g(con)n(tributing)g(pixels)g(so)f(as)h(to)g
-(utilise)g(the)h(full)427 2801 y(width)33 b(of)f(the)g(k)n(ernel,)g
-(out)g(to)g(where)g(it)g(reac)n(hes)e(zero\).)50 b(This)31
-b(sc)n(heme)h(giv)n(es)f(similar)g(results)g(to)h(the)427
-2901 y(AST)p Ft(__)p Fj(SINCSINC)c(sc)n(heme,)f(whic)n(h)h(it)g(resem)n
-(bles.)340 3029 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(SINCGA)n(USS:)35
-b(This)f(sc)n(heme)f(uses)h(a)g(k)n(ernel)f(of)h(the)g(form)g(sinc\(pi)
-p Fi(\003)p Fj(x\).exp\(-k)p Fi(\003)p Fj(x)p Fi(\003)p
-Fj(x\),)g(with)h(k)427 3129 y(a)c(p)r(ositiv)n(e)g(constan)n(t.)48
-b(Here,)32 b(the)g(sinc\(\))g(k)n(ernel)e(is)h(rolled)g(o\013)g(using)g
-(a)g(Gaussian)g(en)n(v)n(elop)r(e)f(whic)n(h)i(is)427
-3229 y(sp)r(eci\014ed)i(b)n(y)e(giving)h(its)g(full-width)h(at)f
-(half-maxim)n(um)f(\(FWHM\))j(b)n(y)e(means)f(of)i(the)f(P)-7
-b(ARAMS\(2\))427 3328 y(v)i(alue,)32 b(whic)n(h)f(should)g(b)r(e)g(at)g
-(least)f(0.1)h(\(in)g(addition,)h(setting)f(P)-7 b(ARAMS\(1\))31
-b(to)g(zero)f(will)h(select)g(the)427 3428 y(n)n(um)n(b)r(er)22
-b(of)f(con)n(tributing)g(pixels)g(so)g(as)g(to)h(utilise)f(the)h(width)
-h(of)e(the)h(k)n(ernel)f(out)g(to)h(where)f(the)h(en)n(v)n(elop)r(e)427
-3528 y(declines)k(to)f(1\045)h(of)f(its)h(maxim)n(um)g(v)-5
-b(alue\).)36 b(On)25 b(astronomical)f(images)h(and)g(sp)r(ectra,)h(go)r
-(o)r(d)f(results)g(are)427 3627 y(often)36 b(obtained)g(b)n(y)g(appro)n
-(ximately)e(matc)n(hing)h(the)h(FWHM)h(of)f(the)g(en)n(v)n(elop)r(e)f
-(function,)k(giv)n(en)c(b)n(y)427 3727 y(P)-7 b(ARAMS\(2\),)31
-b(to)e(the)g(p)r(oin)n(t)h(spread)e(function)i(of)f(the)h(input)g
-(data.)41 b(Ho)n(w)n(ev)n(er,)28 b(there)h(do)r(es)g(not)g(seem)427
-3827 y(to)f(b)r(e)g(an)n(y)f(theoretical)f(reason)g(for)h(this.)340
-3955 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(SOMB:)24 b(This)h(sc)n(heme)g
-(uses)f(a)g(som)n(b\(pi)p Fi(\003)p Fj(x\))h(k)n(ernel)f(\(a)g
-Ft(")p Fj(som)n(brero)p Ft(")e Fj(function\),)k(where)f(x)f(is)h(the)
-427 4055 y(pixel)32 b(o\013set)g(from)f(the)i(in)n(terp)r(olation)e(p)r
+(the)h(data)f(are)427 5693 y(w)n(ell)28 b(sampled.)p
+eop end
+%%Page: 351 361
+TeXDict begin 351 360 bop 3643 52 a FG(351)340 351 y
+Fi(\017)45 b Fj(AST)p Ft(__)p Fj(SINCCOS:)38 b(This)g(sc)n(heme)g(uses)
+g(a)g(k)n(ernel)f(of)h(the)h(form)f(sinc\(pi)p Fi(\003)p
+Fj(x\).cos\(k)p Fi(\003)p Fj(pi)p Fi(\003)p Fj(x\),)h(with)g(k)f(a)427
+451 y(constan)n(t,)32 b(out)f(to)g(the)h(p)r(oin)n(t)f(where)g(cos\(k)p
+Fi(\003)p Fj(pi)p Fi(\003)p Fj(x\))f(go)r(es)h(to)g(zero,)g(and)g(zero)
+f(b)r(ey)n(ond.)48 b(As)31 b(ab)r(o)n(v)n(e,)g(the)427
+551 y(cos\(\))h(factor)f(pro)n(vides)f(an)h(en)n(v)n(elop)r(e)g(whic)n
+(h)h(gradually)e(rolls)g(o\013)i(the)g(sinc\(\))g(k)n(ernel)f(at)h
+(large)e(o\013sets.)427 650 y(The)e(width)h(of)e(this)h(en)n(v)n(elop)r
+(e)f(is)h(sp)r(eci\014ed)g(b)n(y)f(giving)g(the)h(n)n(um)n(b)r(er)g(of)
+g(pixels)f(o\013set)h(at)g(whic)n(h)f(it)i(go)r(es)427
+750 y(to)d(zero)f(b)n(y)g(means)g(of)h(the)g(P)-7 b(ARAMS\(2\))27
+b(v)-5 b(alue,)26 b(whic)n(h)g(should)f(b)r(e)h(at)g(least)f(1.0)g
+(\(in)i(addition,)f(setting)427 849 y(P)-7 b(ARAMS\(1\))38
+b(to)f(zero)f(will)i(select)f(the)g(n)n(um)n(b)r(er)g(of)g(con)n
+(tributing)g(pixels)g(so)f(as)h(to)g(utilise)g(the)h(full)427
+949 y(width)33 b(of)f(the)g(k)n(ernel,)g(out)g(to)g(where)g(it)g(reac)n
+(hes)e(zero\).)50 b(This)31 b(sc)n(heme)h(giv)n(es)f(similar)g(results)
+g(to)h(the)427 1049 y(AST)p Ft(__)p Fj(SINCSINC)c(sc)n(heme,)f(whic)n
+(h)h(it)g(resem)n(bles.)340 1179 y Fi(\017)45 b Fj(AST)p
+Ft(__)p Fj(SINCGA)n(USS:)35 b(This)f(sc)n(heme)f(uses)h(a)g(k)n(ernel)f
+(of)h(the)g(form)g(sinc\(pi)p Fi(\003)p Fj(x\).exp\(-k)p
+Fi(\003)p Fj(x)p Fi(\003)p Fj(x\),)g(with)h(k)427 1279
+y(a)c(p)r(ositiv)n(e)g(constan)n(t.)48 b(Here,)32 b(the)g(sinc\(\))g(k)
+n(ernel)e(is)h(rolled)g(o\013)g(using)g(a)g(Gaussian)g(en)n(v)n(elop)r
+(e)f(whic)n(h)i(is)427 1378 y(sp)r(eci\014ed)i(b)n(y)e(giving)h(its)g
+(full-width)h(at)f(half-maxim)n(um)f(\(FWHM\))j(b)n(y)e(means)f(of)i
+(the)f(P)-7 b(ARAMS\(2\))427 1478 y(v)i(alue,)32 b(whic)n(h)f(should)g
+(b)r(e)g(at)g(least)f(0.1)h(\(in)g(addition,)h(setting)f(P)-7
+b(ARAMS\(1\))31 b(to)g(zero)f(will)h(select)g(the)427
+1578 y(n)n(um)n(b)r(er)22 b(of)f(con)n(tributing)g(pixels)g(so)g(as)g
+(to)h(utilise)f(the)h(width)h(of)e(the)h(k)n(ernel)f(out)g(to)h(where)f
+(the)h(en)n(v)n(elop)r(e)427 1677 y(declines)k(to)f(1\045)h(of)f(its)h
+(maxim)n(um)g(v)-5 b(alue\).)36 b(On)25 b(astronomical)f(images)h(and)g
+(sp)r(ectra,)h(go)r(o)r(d)f(results)g(are)427 1777 y(often)36
+b(obtained)g(b)n(y)g(appro)n(ximately)e(matc)n(hing)h(the)h(FWHM)h(of)f
+(the)g(en)n(v)n(elop)r(e)f(function,)k(giv)n(en)c(b)n(y)427
+1877 y(P)-7 b(ARAMS\(2\),)31 b(to)e(the)g(p)r(oin)n(t)h(spread)e
+(function)i(of)f(the)h(input)g(data.)41 b(Ho)n(w)n(ev)n(er,)28
+b(there)h(do)r(es)g(not)g(seem)427 1976 y(to)f(b)r(e)g(an)n(y)f
+(theoretical)f(reason)g(for)h(this.)340 2107 y Fi(\017)45
+b Fj(AST)p Ft(__)p Fj(SOMB:)24 b(This)h(sc)n(heme)g(uses)f(a)g(som)n
+(b\(pi)p Fi(\003)p Fj(x\))h(k)n(ernel)f(\(a)g Ft(")p
+Fj(som)n(brero)p Ft(")e Fj(function\),)k(where)f(x)f(is)h(the)427
+2206 y(pixel)32 b(o\013set)g(from)f(the)i(in)n(terp)r(olation)e(p)r
(oin)n(t)h(and)f(som)n(b\(z\)=2)p Fi(\003)p Fj(J1\(z\)/z)f(\(J1)h(is)h
-(a)f(Bessel)g(function)i(of)427 4155 y(the)24 b(\014rst)g(kind)f(of)h
+(a)f(Bessel)g(function)i(of)427 2306 y(the)24 b(\014rst)g(kind)f(of)h
(order)e(1\).)36 b(It)24 b(is)f(similar)g(to)g(the)h(AST)p
Ft(__)p Fj(SINC)g(k)n(ernel,)g(and)f(has)g(the)h(same)f(parameter)427
-4254 y(usage.)340 4383 y Fi(\017)45 b Fj(AST)p Ft(__)p
+2406 y(usage.)340 2536 y Fi(\017)45 b Fj(AST)p Ft(__)p
Fj(SOMBCOS:)30 b(This)g(sc)n(heme)g(uses)g(a)g(k)n(ernel)f(of)i(the)g
(form)f(som)n(b\(pi)p Fi(\003)p Fj(x\).cos\(k)p Fi(\003)p
-Fj(pi)p Fi(\003)p Fj(x\),)f(with)i(k)f(a)427 4483 y(constan)n(t,)g(out)
+Fj(pi)p Fi(\003)p Fj(x\),)f(with)i(k)f(a)427 2636 y(constan)n(t,)g(out)
g(to)g(the)g(p)r(oin)n(t)g(where)f(cos\(k)p Fi(\003)p
Fj(pi)p Fi(\003)p Fj(x\))g(go)r(es)g(to)g(zero,)h(and)g(zero)e(b)r(ey)n
-(ond.)44 b(It)30 b(is)g(similar)f(to)427 4583 y(the)f(AST)p
+(ond.)44 b(It)30 b(is)g(similar)f(to)427 2736 y(the)f(AST)p
Ft(__)p Fj(SINCCOS)f(k)n(ernel,)g(and)h(has)f(the)h(same)f(parameter)f
-(usage.)227 4741 y(In)i(addition,)g(the)g(follo)n(wing)e(sc)n(hemes)h
+(usage.)227 2895 y(In)i(addition,)g(the)g(follo)n(wing)e(sc)n(hemes)h
(are)g(pro)n(vided)f(whic)n(h)i(are)e(not)i(based)f(on)g(a)g
-(1-dimensional)g(k)n(ernel:)340 4996 y Fi(\017)45 b Fj(AST)p
+(1-dimensional)g(k)n(ernel:)340 3153 y Fi(\017)45 b Fj(AST)p
Ft(__)p Fj(BLOCKA)-9 b(VE:)20 b(This)h(sc)n(heme)g(simply)g(tak)n(es)f
(an)h(a)n(v)n(erage)d(of)j(all)g(the)h(pixels)f(on)f(the)i(input)g
-(grid)e(in)427 5095 y(a)k(cub)r(e)h(cen)n(tred)f(on)g(the)h(in)n(terp)r
+(grid)e(in)427 3252 y(a)k(cub)r(e)h(cen)n(tred)f(on)g(the)h(in)n(terp)r
(olation)f(p)r(oin)n(t.)36 b(The)24 b(n)n(um)n(b)r(er)g(of)g(pixels)h
-(in)f(the)h(cub)r(e)g(is)f(determined)h(b)n(y)427 5195
+(in)f(the)h(cub)r(e)g(is)f(determined)h(b)n(y)427 3352
y(the)g(v)-5 b(alue)25 b(of)g(the)g(\014rst)g(elemen)n(t)g(of)f(the)h
(P)-7 b(ARAMS)26 b(arra)n(y)-7 b(,)23 b(whic)n(h)i(giv)n(es)e(the)i(n)n
-(um)n(b)r(er)g(of)g(pixels)f(in)h(eac)n(h)427 5295 y(dimension)e(on)f
+(um)n(b)r(er)g(of)g(pixels)f(in)h(eac)n(h)427 3452 y(dimension)e(on)f
(either)h(side)f(of)h(the)g(cen)n(tral)f(p)r(oin)n(t.)35
b(Hence)23 b(a)f(blo)r(c)n(k)h(of)f(\(2)h Fi(\003)f Fj(P)-7
b(ARAMS\(1\)\))p Fi(\003\003)p Fj(NDIM)p Ft(_)p Fj(IN)427
-5394 y(pixels)31 b(in)g(the)g(input)g(grid)f(will)h(b)r(e)g(examined)f
+3551 y(pixels)31 b(in)g(the)g(input)g(grid)f(will)h(b)r(e)g(examined)f
(to)h(determine)g(the)g(v)-5 b(alue)30 b(of)h(the)g(output)g(pixel.)46
-b(If)31 b(the)427 5494 y(v)-5 b(ariance)32 b(is)h(not)g(b)r(eing)g
+b(If)31 b(the)427 3651 y(v)-5 b(ariance)32 b(is)h(not)g(b)r(eing)g
(used)g(\(USEV)-9 b(AR)33 b(=)g(.F)-9 b(ALSE.\))33 b(then)h(all)e(v)-5
b(alid)33 b(pixels)g(in)g(this)h(cub)r(e)f(will)g(b)r(e)427
-5593 y(a)n(v)n(eraged)22 b(in)i(to)g(the)g(result)g(with)g(equal)g(w)n
+3750 y(a)n(v)n(eraged)22 b(in)i(to)g(the)g(result)g(with)g(equal)g(w)n
(eigh)n(t.)35 b(If)24 b(v)-5 b(ariances)23 b(are)g(b)r(eing)h(used,)h
-(then)g(eac)n(h)e(input)i(pixel)427 5693 y(will)35 b(b)r(e)g(w)n(eigh)n
+(then)g(eac)n(h)e(input)i(pixel)427 3850 y(will)35 b(b)r(e)g(w)n(eigh)n
(ted)e(prop)r(ortionally)g(to)h(the)h(recipro)r(cal)e(of)h(its)h(v)-5
-b(ariance;)37 b(an)n(y)c(pixel)i(without)g(a)f(v)-5 b(alid)p
-eop end
-%%Page: 349 359
-TeXDict begin 349 358 bop 3643 52 a FG(349)427 351 y
-Fj(v)-5 b(ariance)33 b(will)h(b)r(e)h(discarded.)55 b(This)34
-b(sc)n(heme)g(is)f(suitable)h(where)g(the)g(output)h(grid)e(is)h(m)n
-(uc)n(h)g(coarser)427 451 y(than)28 b(the)g(input)h(grid;)e(if)i(the)f
-(ratio)f(of)h(pixel)g(sizes)f(is)h(R)g(then)g(a)g(suitable)f(v)-5
-b(alue)28 b(of)g(P)-7 b(ARAMS\(1\))28 b(ma)n(y)427 551
-y(b)r(e)g(R/2.)227 712 y(Finally)-7 b(,)33 b(supplying)e(the)h(follo)n
-(wing)f(v)-5 b(alues)31 b(for)g(INTERP)h(allo)n(ws)e(y)n(ou)h(to)g
-(implemen)n(t)h(y)n(our)f(o)n(wn)g(sub-pixel)227 812
-y(in)n(terp)r(olation)f(sc)n(heme)g(b)n(y)g(means)g(of)h(y)n(our)e(o)n
-(wn)h(routine.)46 b(Y)-7 b(ou)30 b(should)h(supply)f(the)h(name)g(of)f
-(this)h(routine)227 912 y(via)c(the)h(FINTERP)g(argumen)n(t:)340
-1173 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(UKERN1:)33 b(In)22
+b(ariance;)37 b(an)n(y)c(pixel)i(without)g(a)f(v)-5 b(alid)427
+3950 y(v)g(ariance)33 b(will)h(b)r(e)h(discarded.)55
+b(This)34 b(sc)n(heme)g(is)f(suitable)h(where)g(the)g(output)h(grid)e
+(is)h(m)n(uc)n(h)g(coarser)427 4049 y(than)28 b(the)g(input)h(grid;)e
+(if)i(the)f(ratio)f(of)h(pixel)g(sizes)f(is)h(R)g(then)g(a)g(suitable)f
+(v)-5 b(alue)28 b(of)g(P)-7 b(ARAMS\(1\))28 b(ma)n(y)427
+4149 y(b)r(e)g(R/2.)227 4309 y(Finally)-7 b(,)33 b(supplying)e(the)h
+(follo)n(wing)f(v)-5 b(alues)31 b(for)g(INTERP)h(allo)n(ws)e(y)n(ou)h
+(to)g(implemen)n(t)h(y)n(our)f(o)n(wn)g(sub-pixel)227
+4408 y(in)n(terp)r(olation)f(sc)n(heme)g(b)n(y)g(means)g(of)h(y)n(our)e
+(o)n(wn)h(routine.)46 b(Y)-7 b(ou)30 b(should)h(supply)f(the)h(name)g
+(of)f(this)h(routine)227 4508 y(via)c(the)h(FINTERP)g(argumen)n(t:)340
+4765 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(UKERN1:)33 b(In)22
b(this)g(sc)n(heme,)g(y)n(ou)f(supply)g(a)g(routine)h(to)f(ev)-5
b(aluate)21 b(y)n(our)g(o)n(wn)f(1-dimensional)h(in-)427
-1272 y(terp)r(olation)g(k)n(ernel,)h(whic)n(h)g(is)g(then)g(used)g(to)f
+4865 y(terp)r(olation)g(k)n(ernel,)h(whic)n(h)g(is)g(then)g(used)g(to)f
(p)r(erform)g(sub-pixel)h(in)n(terp)r(olation)f(\(as)g(describ)r(ed)h
-(ab)r(o)n(v)n(e\).)427 1372 y(The)29 b(routine)e(y)n(ou)h(supply)g
+(ab)r(o)n(v)n(e\).)427 4965 y(The)29 b(routine)e(y)n(ou)h(supply)g
(should)g(ha)n(v)n(e)f(the)i(same)e(in)n(terface)h(as)f(the)i
-(\014ctitious)f(AST)p Ft(_)p Fj(UKERN1)g(rou-)427 1471
+(\014ctitious)f(AST)p Ft(_)p Fj(UKERN1)g(rou-)427 5064
y(tine)33 b(\(q.v.\).)51 b(In)33 b(addition,)g(a)f(v)-5
b(alue)32 b(should)g(b)r(e)h(giv)n(en)f(via)f(P)-7 b(ARAMS\(1\))33
-b(to)f(sp)r(ecify)h(the)g(n)n(um)n(b)r(er)f(of)427 1571
+b(to)f(sp)r(ecify)h(the)g(n)n(um)n(b)r(er)f(of)427 5164
y(neigh)n(b)r(ouring)e(pixels)h(whic)n(h)h(are)e(to)h(con)n(tribute)g
(to)g(eac)n(h)g(in)n(terp)r(olated)g(v)-5 b(alue)31 b(\(in)h(the)f
-(same)g(w)n(a)n(y)f(as)427 1671 y(for)d(the)h(pre-de\014ned)g(in)n
+(same)g(w)n(a)n(y)f(as)427 5264 y(for)d(the)h(pre-de\014ned)g(in)n
(terp)r(olation)e(sc)n(hemes)h(describ)r(ed)h(ab)r(o)n(v)n(e\).)36
b(Other)27 b(elemen)n(ts)g(of)h(the)g(P)-7 b(ARAMS)427
-1770 y(arra)n(y)26 b(are)g(a)n(v)-5 b(ailable)26 b(to)i(pass)f(v)-5
+5363 y(arra)n(y)26 b(are)g(a)n(v)-5 b(ailable)26 b(to)i(pass)f(v)-5
b(alues)27 b(to)g(y)n(our)g(in)n(terp)r(olation)f(routine.)340
-1903 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(UINTERP:)39 b(This)h(is)g(a)g
+5494 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(UINTERP:)39 b(This)h(is)g(a)g
(completely)g(general)e(sc)n(heme,)43 b(in)d(whic)n(h)g(y)n(our)f(in)n
-(terp)r(olation)g(rou-)427 2003 y(tine)f(has)f(access)g(to)g(all)g(of)h
+(terp)r(olation)g(rou-)427 5593 y(tine)f(has)f(access)g(to)g(all)g(of)h
(the)g(input)g(data.)67 b(This)37 b(allo)n(ws)f(y)n(ou)h(to)g(implemen)
-n(t)i(an)n(y)d(in)n(terp)r(olation)427 2102 y(algorithm)e(y)n(ou)h(c)n
+n(t)i(an)n(y)d(in)n(terp)r(olation)427 5693 y(algorithm)e(y)n(ou)h(c)n
(ho)r(ose,)h(whic)n(h)f(could)g(\(for)g(example\))g(b)r(e)h
-(non-linear,)g(or)e(adaptiv)n(e.)59 b(In)36 b(this)f(case,)427
-2202 y(the)27 b(AST)p Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p
-Fl(>)e Fj(functions)h(pla)n(y)g(no)g(role)g(in)g(the)h(sub-pixel)f(in)n
-(terp)r(olation)g(pro)r(cess)f(and)427 2302 y(simply)34
-b(handle)g(the)g(geometrical)e(transformation)g(of)i(co)r(ordinates)f
-(and)g(other)g(housek)n(eeping.)55 b(The)427 2401 y(routine)30
-b(y)n(ou)f(supply)h(should)f(ha)n(v)n(e)g(the)h(same)g(in)n(terface)f
-(as)g(the)h(\014ctitious)h(AST)p Ft(_)p Fj(UINTERP)e(routine)427
-2501 y(\(q.v.\).)50 b(In)32 b(this)g(case,)g(the)g(P)-7
-b(ARAMS)33 b(argumen)n(t)d(is)i(not)g(used)g(b)n(y)f(AST)p
-Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p Fj(,)g(but)i(is)427
-2600 y(a)n(v)-5 b(ailable)27 b(to)g(pass)g(v)-5 b(alues)27
-b(to)h(y)n(our)e(in)n(terp)r(olation)h(routine.)-2 2762
-y Fc(Con)m(trol)32 b(Flags)n(:)227 2908 y Fj(The)24 b(follo)n(wing)f
-(\015ags)g(are)g(de\014ned)h(in)g(the)g(AST)p Ft(_)p
-Fj(P)-7 b(AR)24 b(include)g(\014le)g(and)g(ma)n(y)f(b)r(e)h(used)g(to)g
-(pro)n(vide)e(additional)227 3008 y(con)n(trol)29 b(o)n(v)n(er)f(the)i
-(resampling)e(pro)r(cess.)43 b(Ha)n(ving)28 b(selected)i(a)f(set)h(of)g
-(\015ags,)f(y)n(ou)g(should)h(supply)g(the)g(sum)g(of)227
-3108 y(their)e(v)-5 b(alues)27 b(via)g(the)h(FLA)n(GS)g(argumen)n(t:)
-340 3369 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(NOBAD:)22
-b(Indicates)g(that)h(an)n(y)e(output)i(arra)n(y)d(elemen)n(ts)i(for)f
-(whic)n(h)i(no)e(resampled)h(v)-5 b(alue)22 b(could)427
-3468 y(b)r(e)g(obtained)f(should)h(b)r(e)f(left)i(set)e(to)g(the)h(v)-5
-b(alue)21 b(they)h(had)f(on)h(en)n(try)e(to)i(this)g(function.)35
-b(If)22 b(this)g(\015ag)e(is)i(not)427 3568 y(supplied,)34
-b(suc)n(h)e(output)g(arra)n(y)e(elemen)n(ts)i(are)f(set)h(to)g(the)g(v)
--5 b(alue)32 b(supplied)h(for)e(argumen)n(t)g(BAD)n(V)-9
-b(AL.)427 3667 y(Note,)39 b(this)d(\015ag)g(cannot)g(b)r(e)g(used)g(in)
-h(conjunction)f(with)h(the)g(AST)p Ft(__)p Fj(CONSER)-9
-b(VEFLUX)35 b(\015ag)h(\(an)427 3767 y(error)26 b(will)i(b)r(e)g(rep)r
-(orted)f(if)h(b)r(oth)g(\015ags)e(are)h(sp)r(eci\014ed\).)340
-3900 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(URESAMP1,)27
-b(2,)g(3)g(&)h(4:)36 b(A)28 b(set)g(of)f(four)g(\015ags)g(whic)n(h)g
-(are)g(reserv)n(ed)f(for)h(y)n(our)f(o)n(wn)h(use.)37
-b(They)427 3999 y(ma)n(y)e(b)r(e)h(used)f(to)g(pass)f(priv)-5
+(non-linear,)g(or)e(adaptiv)n(e.)59 b(In)36 b(this)f(case,)p
+eop end
+%%Page: 352 362
+TeXDict begin 352 361 bop 0 52 a FG(352)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(the)c(AST)p
+Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)e Fj(functions)h(pla)n(y)g(no)g
+(role)g(in)g(the)h(sub-pixel)f(in)n(terp)r(olation)g(pro)r(cess)f(and)
+427 451 y(simply)34 b(handle)g(the)g(geometrical)e(transformation)g(of)
+i(co)r(ordinates)f(and)g(other)g(housek)n(eeping.)55
+b(The)427 551 y(routine)30 b(y)n(ou)f(supply)h(should)f(ha)n(v)n(e)g
+(the)h(same)g(in)n(terface)f(as)g(the)h(\014ctitious)h(AST)p
+Ft(_)p Fj(UINTERP)e(routine)427 650 y(\(q.v.\).)50 b(In)32
+b(this)g(case,)g(the)g(P)-7 b(ARAMS)33 b(argumen)n(t)d(is)i(not)g(used)
+g(b)n(y)f(AST)p Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p
+Fj(,)g(but)i(is)427 750 y(a)n(v)-5 b(ailable)27 b(to)g(pass)g(v)-5
+b(alues)27 b(to)h(y)n(our)e(in)n(terp)r(olation)h(routine.)-2
+909 y Fc(Con)m(trol)32 b(Flags)n(:)227 1055 y Fj(The)24
+b(follo)n(wing)f(\015ags)g(are)g(de\014ned)h(in)g(the)g(AST)p
+Ft(_)p Fj(P)-7 b(AR)24 b(include)g(\014le)g(and)g(ma)n(y)f(b)r(e)h
+(used)g(to)g(pro)n(vide)e(additional)227 1154 y(con)n(trol)29
+b(o)n(v)n(er)f(the)i(resampling)e(pro)r(cess.)43 b(Ha)n(ving)28
+b(selected)i(a)f(set)h(of)g(\015ags,)f(y)n(ou)g(should)h(supply)g(the)g
+(sum)g(of)227 1254 y(their)e(v)-5 b(alues)27 b(via)g(the)h(FLA)n(GS)g
+(argumen)n(t:)340 1511 y Fi(\017)45 b Fj(AST)p Ft(__)p
+Fj(NOBAD:)22 b(Indicates)g(that)h(an)n(y)e(output)i(arra)n(y)d(elemen)n
+(ts)i(for)f(whic)n(h)i(no)e(resampled)h(v)-5 b(alue)22
+b(could)427 1610 y(b)r(e)g(obtained)f(should)h(b)r(e)f(left)i(set)e(to)
+g(the)h(v)-5 b(alue)21 b(they)h(had)f(on)h(en)n(try)e(to)i(this)g
+(function.)35 b(If)22 b(this)g(\015ag)e(is)i(not)427
+1710 y(supplied,)34 b(suc)n(h)e(output)g(arra)n(y)e(elemen)n(ts)i(are)f
+(set)h(to)g(the)g(v)-5 b(alue)32 b(supplied)h(for)e(argumen)n(t)g(BAD)n
+(V)-9 b(AL.)427 1809 y(Note,)39 b(this)d(\015ag)g(cannot)g(b)r(e)g
+(used)g(in)h(conjunction)f(with)h(the)g(AST)p Ft(__)p
+Fj(CONSER)-9 b(VEFLUX)35 b(\015ag)h(\(an)427 1909 y(error)26
+b(will)i(b)r(e)g(rep)r(orted)f(if)h(b)r(oth)g(\015ags)e(are)h(sp)r
+(eci\014ed\).)340 2039 y Fi(\017)45 b Fj(AST)p Ft(__)p
+Fj(URESAMP1,)27 b(2,)g(3)g(&)h(4:)36 b(A)28 b(set)g(of)f(four)g
+(\015ags)g(whic)n(h)g(are)g(reserv)n(ed)f(for)h(y)n(our)f(o)n(wn)h
+(use.)37 b(They)427 2139 y(ma)n(y)e(b)r(e)h(used)f(to)g(pass)f(priv)-5
b(ate)35 b(information)g(to)g(an)n(y)g(sub-pixel)g(in)n(terp)r(olation)
-f(routine)h(whic)n(h)g(y)n(ou)427 4099 y(implemen)n(t)28
+f(routine)h(whic)n(h)g(y)n(ou)427 2238 y(implemen)n(t)28
b(y)n(ourself.)36 b(They)28 b(are)e(ignored)h(b)n(y)g(all)g(the)h
(pre-de\014ned)f(in)n(terp)r(olation)g(sc)n(hemes.)340
-4232 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(USEBAD:)33 b(Indicates)g(that)h
+2368 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(USEBAD:)33 b(Indicates)g(that)h
(there)f(ma)n(y)f(b)r(e)i(bad)f(pixels)f(in)i(the)f(input)h(arra)n
-(y\(s\))d(whic)n(h)i(m)n(ust)427 4332 y(b)r(e)26 b(recognised)d(b)n(y)i
+(y\(s\))d(whic)n(h)i(m)n(ust)427 2468 y(b)r(e)26 b(recognised)d(b)n(y)i
(comparing)e(with)j(the)f(v)-5 b(alue)25 b(giv)n(en)g(for)f(BAD)n(V)-9
-b(AL)26 b(and)e(propagated)g(to)h(the)g(output)427 4431
+b(AL)26 b(and)e(propagated)g(to)h(the)g(output)427 2567
y(arra)n(y\(s\).)41 b(If)30 b(this)g(\015ag)f(is)g(not)h(set,)g(all)f
(input)h(v)-5 b(alues)30 b(are)e(treated)h(literally)g(and)h(the)g(BAD)
-n(V)-9 b(AL)30 b(v)-5 b(alue)427 4531 y(is)28 b(only)f(used)h(for)f
-(\015agging)f(output)i(arra)n(y)d(v)-5 b(alues.)340 4664
+n(V)-9 b(AL)30 b(v)-5 b(alue)427 2667 y(is)28 b(only)f(used)h(for)f
+(\015agging)f(output)i(arra)n(y)d(v)-5 b(alues.)340 2797
y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(USEV)-9 b(AR:)25 b(Indicates)f(that)
g(v)-5 b(ariance)23 b(information)h(should)g(b)r(e)h(pro)r(cessed)e(in)
-i(order)e(to)h(pro)n(vide)427 4763 y(estimates)k(of)g(the)h
+i(order)e(to)h(pro)n(vide)427 2896 y(estimates)k(of)g(the)h
(statistical)e(error)g(asso)r(ciated)f(with)j(the)g(resampled)e(v)-5
b(alues.)38 b(If)29 b(this)f(\015ag)f(is)h(not)h(set,)427
-4863 y(no)h(v)-5 b(ariance)29 b(pro)r(cessing)g(will)i(o)r(ccur)e(and)i
+2996 y(no)h(v)-5 b(ariance)29 b(pro)r(cessing)g(will)i(o)r(ccur)e(and)i
(the)f(IN)p Ft(_)p Fj(V)-9 b(AR)31 b(and)f(OUT)p Ft(_)p
Fj(V)-9 b(AR)30 b(arra)n(ys)e(will)j(not)f(b)r(e)h(used.)427
-4962 y(\(Note)d(that)g(this)g(\015ag)f(is)g(only)g(a)n(v)-5
+3096 y(\(Note)d(that)g(this)g(\015ag)f(is)g(only)g(a)n(v)-5
b(ailable)27 b(in)h(the)g(F)-7 b(ortran)26 b(in)n(terface)h(to)g
-(AST.\))340 5095 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(CONSER)-9
+(AST.\))340 3226 y Fi(\017)45 b Fj(AST)p Ft(__)p Fj(CONSER)-9
b(VEFLUX:)28 b(Indicates)h(that)f(the)h(output)h(pixel)e(v)-5
b(alues)29 b(should)f(b)r(e)h(scaled)f(in)h(suc)n(h)f(a)427
-5195 y(w)n(a)n(y)c(as)g(to)g(preserv)n(e)f(\(appro)n(ximately\))g(the)i
+3325 y(w)n(a)n(y)c(as)g(to)g(preserv)n(e)f(\(appro)n(ximately\))g(the)i
(total)g(data)f(v)-5 b(alue)25 b(in)f(a)h(feature)f(on)g(the)h(sky)-7
-b(.)36 b(Without)25 b(this)427 5295 y(\015ag,)k(eac)n(h)f(output)i
+b(.)36 b(Without)25 b(this)427 3425 y(\015ag,)k(eac)n(h)f(output)i
(pixel)f(v)-5 b(alue)29 b(represen)n(ts)f(an)g(instan)n(taneous)g
(sample)h(of)g(the)h(input)f(data)g(v)-5 b(alues)29 b(at)427
-5394 y(the)e(corresp)r(onding)d(input)j(p)r(osition.)36
+3524 y(the)e(corresp)r(onding)d(input)j(p)r(osition.)36
b(This)26 b(is)g(appropriate)e(if)i(the)h(input)g(data)e(represen)n(ts)
-g(the)h(spatial)427 5494 y(densit)n(y)k(of)f(some)g(quan)n(tit)n(y)h
+g(the)h(spatial)427 3624 y(densit)n(y)k(of)f(some)g(quan)n(tit)n(y)h
(\(e.g.)43 b(surface)28 b(brigh)n(tness)h(in)h(Janskys)e(p)r(er)i
-(square)e(arc-second\))g(b)r(ecause)427 5593 y(the)g(output)f(pixel)g
+(square)e(arc-second\))g(b)r(ecause)427 3724 y(the)g(output)f(pixel)g
(v)-5 b(alues)26 b(will)h(ha)n(v)n(e)f(the)h(same)g(normalisation)e
(and)i(units)g(as)f(the)h(input)h(pixel)f(v)-5 b(alues.)427
-5693 y(Ho)n(w)n(ev)n(er,)27 b(if)i(the)g(input)g(data)f(v)-5
+3823 y(Ho)n(w)n(ev)n(er,)27 b(if)i(the)g(input)g(data)f(v)-5
b(alues)28 b(represen)n(t)f(\015ux)i(\(or)f(some)g(other)f(ph)n(ysical)
-h(quan)n(tit)n(y\))g(p)r(er)h(pixel,)p eop end
-%%Page: 350 360
-TeXDict begin 350 359 bop 0 52 a FG(350)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(then)g(the)g(AST)p
+h(quan)n(tit)n(y\))g(p)r(er)h(pixel,)427 3923 y(then)i(the)g(AST)p
Ft(__)p Fj(CONSER)-9 b(VEFLUX)30 b(\015ag)g(could)h(b)r(e)g(used.)46
b(This)30 b(causes)g(eac)n(h)g(output)h(pixel)g(v)-5
-b(alue)427 451 y(to)28 b(b)r(e)g(scaled)f(b)n(y)g(the)h(ratio)f(of)g
+b(alue)427 4023 y(to)28 b(b)r(e)g(scaled)f(b)n(y)g(the)h(ratio)f(of)g
(the)h(output)g(pixel)g(size)f(to)h(the)g(input)g(pixel)g(size.)227
-628 y(This)38 b(\015ag)g(can)f(only)h(b)r(e)g(used)h(if)f(the)h
+4181 y(This)38 b(\015ag)g(can)f(only)h(b)r(e)g(used)h(if)f(the)h
(Mapping)e(is)h(successfully)g(appro)n(ximated)e(b)n(y)i(one)g(or)f
-(more)g(linear)227 727 y(transformations.)71 b(Th)n(us)40
+(more)g(linear)227 4281 y(transformations.)71 b(Th)n(us)40
b(an)f(error)f(will)h(b)r(e)i(rep)r(orted)d(if)j(it)f(used)f(when)h
-(the)g(TOL)f(argumen)n(t)g(is)g(set)h(to)227 827 y(zero)d(\(whic)n(h)h
+(the)g(TOL)f(argumen)n(t)g(is)g(set)h(to)227 4381 y(zero)d(\(whic)n(h)h
(stops)f(the)h(use)f(of)h(linear)f(appro)n(ximations\),)h(or)f(if)h
(the)g(Mapping)f(is)h(to)r(o)f(non-linear)g(to)g(b)r(e)227
-926 y(appro)n(ximated)f(b)n(y)h(a)f(piece-wise)h(linear)f
+4480 y(appro)n(ximated)f(b)n(y)h(a)f(piece-wise)h(linear)f
(transformation.)64 b(The)37 b(ratio)f(of)h(output)h(to)f(input)h
-(pixel)f(size)g(is)227 1026 y(ev)-5 b(aluated)19 b(once)h(for)f(eac)n
+(pixel)f(size)g(is)227 4580 y(ev)-5 b(aluated)19 b(once)h(for)f(eac)n
(h)f(panel)i(of)f(the)h(piece-wise)f(linear)g(appro)n(ximation)e(to)j
-(the)g(Mapping,)g(and)g(is)f(assumed)227 1126 y(to)33
+(the)g(Mapping,)g(and)g(is)f(assumed)227 4680 y(to)33
b(b)r(e)h(constan)n(t)f(for)g(all)g(output)g(pixels)g(in)h(the)g
(panel.)54 b(The)33 b(scaling)f(factors)g(for)h(adjacen)n(t)g(panels)g
-(will)g(in)227 1225 y(general)f(di\013er)h(sligh)n(tly)-7
+(will)g(in)227 4779 y(general)f(di\013er)h(sligh)n(tly)-7
b(,)34 b(and)e(so)h(the)g(join)n(ts)g(b)r(et)n(w)n(een)g(panels)f(ma)n
(y)g(b)r(e)i(visible)e(when)h(viewing)g(the)g(output)227
-1325 y(image)k(at)g(high)g(con)n(trast.)64 b(If)38 b(this)f(is)g(a)g
+4879 y(image)k(at)g(high)g(con)n(trast.)64 b(If)38 b(this)f(is)g(a)g
(problem,)i(reduce)e(the)g(v)-5 b(alue)37 b(of)g(the)h(TOL)f(argumen)n
-(t)f(un)n(til)h(the)227 1425 y(di\013erence)28 b(b)r(et)n(w)n(een)f
+(t)f(un)n(til)h(the)227 4979 y(di\013erence)28 b(b)r(et)n(w)n(een)f
(adjacen)n(t)g(panels)h(is)f(su\016cien)n(tly)h(small)f(to)g(b)r(e)h
-(insigni\014can)n(t.)227 1556 y(Note,)22 b(this)e(\015ag)f(cannot)g(b)r
+(insigni\014can)n(t.)227 5102 y(Note,)22 b(this)e(\015ag)f(cannot)g(b)r
(e)h(used)g(in)g(conjunction)g(with)g(the)h(AST)p Ft(__)p
Fj(NOBAD)e(\015ag)g(\(an)h(error)e(will)i(b)r(e)g(rep)r(orted)227
-1656 y(if)28 b(b)r(oth)g(\015ags)f(are)g(sp)r(eci\014ed\).)-2
-1820 y Fc(Propagation)33 b(of)e(Missing)f(Data)n(:)227
-1966 y Fj(Unless)j(the)g(AST)p Ft(__)p Fj(NOBAD)g(\015ag)f(is)h(sp)r
+5201 y(if)28 b(b)r(oth)g(\015ags)f(are)g(sp)r(eci\014ed\).)-2
+5348 y Fc(Propagation)33 b(of)e(Missing)f(Data)n(:)227
+5494 y Fj(Unless)j(the)g(AST)p Ft(__)p Fj(NOBAD)g(\015ag)f(is)h(sp)r
(eci\014ed,)i(instances)d(of)h(missing)f(data)h(\(bad)g(pixels\))g(in)g
-(the)g(output)227 2066 y(grid)22 b(are)g(iden)n(ti\014ed)h(b)n(y)g(o)r
+(the)g(output)227 5593 y(grid)22 b(are)g(iden)n(ti\014ed)h(b)n(y)g(o)r
(ccurrences)e(of)i(the)g(BAD)n(V)-9 b(AL)23 b(v)-5 b(alue)23
b(in)g(the)g(OUT)f(arra)n(y)-7 b(.)33 b(These)23 b(ma)n(y)f(b)r(e)h
-(pro)r(duced)227 2166 y(if)28 b(an)n(y)f(of)h(the)g(follo)n(wing)e
-(happ)r(en:)340 2449 y Fi(\017)45 b Fj(The)35 b(input)h(p)r(osition)f
-(\(the)h(transformed)e(p)r(osition)h(of)g(the)g(output)h(pixel's)f(cen)
-n(tre\))f(lies)h(outside)g(the)427 2548 y(b)r(oundary)27
-b(of)h(the)g(grid)f(of)g(input)h(pixels.)340 2688 y Fi(\017)45
-b Fj(The)32 b(input)h(p)r(osition)e(lies)h(inside)g(the)g(b)r(oundary)f
-(of)g(a)h(bad)f(input)i(pixel.)49 b(In)32 b(this)g(con)n(text,)g(an)g
-(input)427 2788 y(pixel)g(is)f(considered)f(bad)i(if)g(its)f(data)g(v)
--5 b(alue)31 b(is)h(equal)f(to)g(BAD)n(V)-9 b(AL)32 b(and)f(the)h(AST)p
-Ft(__)p Fj(USEBAD)f(\015ag)427 2888 y(is)h(set)f(via)g(the)h(FLA)n(GS)g
+(pro)r(duced)227 5693 y(if)28 b(an)n(y)f(of)h(the)g(follo)n(wing)e
+(happ)r(en:)p eop end
+%%Page: 353 363
+TeXDict begin 353 362 bop 3643 52 a FG(353)340 489 y
+Fi(\017)45 b Fj(The)35 b(input)h(p)r(osition)f(\(the)h(transformed)e(p)
+r(osition)h(of)g(the)g(output)h(pixel's)f(cen)n(tre\))f(lies)h(outside)
+g(the)427 588 y(b)r(oundary)27 b(of)h(the)g(grid)f(of)g(input)h
+(pixels.)340 722 y Fi(\017)45 b Fj(The)32 b(input)h(p)r(osition)e(lies)
+h(inside)g(the)g(b)r(oundary)f(of)g(a)h(bad)f(input)i(pixel.)49
+b(In)32 b(this)g(con)n(text,)g(an)g(input)427 821 y(pixel)g(is)f
+(considered)f(bad)i(if)g(its)f(data)g(v)-5 b(alue)31
+b(is)h(equal)f(to)g(BAD)n(V)-9 b(AL)32 b(and)f(the)h(AST)p
+Ft(__)p Fj(USEBAD)f(\015ag)427 921 y(is)h(set)f(via)g(the)h(FLA)n(GS)g
(argumen)n(t.)48 b(\(P)n(ositions)30 b(whic)n(h)i(ha)n(v)n(e)e(half-in)
n(tegral)g(co)r(ordinate)h(v)-5 b(alues,)32 b(and)427
-2987 y(therefore)d(lie)g(on)h(a)f(pixel)g(b)r(oundary)-7
+1020 y(therefore)d(lie)g(on)h(a)f(pixel)g(b)r(oundary)-7
b(,)30 b(are)e(regarded)g(as)h(lying)g(within)h(the)g(pixel)f(with)h
-(the)g(larger,)e(i.e.)427 3087 y(more)f(p)r(ositiv)n(e,)g(index.\))340
-3227 y Fi(\017)45 b Fj(The)27 b(set)g(of)g(neigh)n(b)r(ouring)e(input)j
+(the)g(larger,)e(i.e.)427 1120 y(more)f(p)r(ositiv)n(e,)g(index.\))340
+1253 y Fi(\017)45 b Fj(The)27 b(set)g(of)g(neigh)n(b)r(ouring)e(input)j
(pixels)f(\(excluding)f(those)h(whic)n(h)g(are)e(bad\))i(is)g
-(unsuitable)g(for)f(calcu-)427 3327 y(lating)g(an)f(in)n(terp)r(olated)
+(unsuitable)g(for)f(calcu-)427 1353 y(lating)g(an)f(in)n(terp)r(olated)
h(v)-5 b(alue.)36 b(Whether)26 b(this)g(is)g(true)f(ma)n(y)h(dep)r(end)
-g(on)g(the)g(sub-pixel)f(in)n(terp)r(olation)427 3426
-y(sc)n(heme)i(in)h(use.)340 3567 y Fi(\017)45 b Fj(The)31
+g(on)g(the)g(sub-pixel)f(in)n(terp)r(olation)427 1453
+y(sc)n(heme)i(in)h(use.)340 1586 y Fi(\017)45 b Fj(The)31
b(in)n(terp)r(olated)g(v)-5 b(alue)31 b(lies)g(outside)g(the)g(range)f
(whic)n(h)h(can)g(b)r(e)h(represen)n(ted)d(using)i(the)h(data)e(t)n(yp)
-r(e)427 3666 y(of)e(the)g(OUT)f(arra)n(y)-7 b(.)227 3843
+r(e)427 1686 y(of)e(the)g(OUT)f(arra)n(y)-7 b(.)227 1848
y(In)29 b(addition,)f(asso)r(ciated)f(output)i(v)-5 b(ariance)27
b(estimates)h(\(if)i(calculated\))e(ma)n(y)f(b)r(e)i(declared)e(bad)i
-(and)f(\015agged)227 3942 y(with)g(the)g(BAD)n(V)-9 b(AL)28
+(and)f(\015agged)227 1948 y(with)g(the)g(BAD)n(V)-9 b(AL)28
b(v)-5 b(alue)28 b(in)g(the)g(OUT)p Ft(_)p Fj(V)-9 b(AR)27
b(arra)n(y)e(under)j(an)n(y)f(of)g(the)h(follo)n(wing)f(circumstances:)
-340 4225 y Fi(\017)45 b Fj(The)28 b(asso)r(ciated)e(resampled)h(data)g
+340 2210 y Fi(\017)45 b Fj(The)28 b(asso)r(ciated)e(resampled)h(data)g
(v)-5 b(alue)28 b(\(in)g(the)g(OUT)f(arra)n(y\))f(is)h(bad.)340
-4366 y Fi(\017)45 b Fj(The)19 b(set)g(of)g(neigh)n(b)r(ouring)e(input)j
+2344 y Fi(\017)45 b Fj(The)19 b(set)g(of)g(neigh)n(b)r(ouring)e(input)j
(pixels)e(whic)n(h)h(con)n(tributed)g(to)f(the)i(output)f(data)f(v)-5
-b(alue)19 b(do)f(not)h(all)g(ha)n(v)n(e)427 4465 y(v)-5
+b(alue)19 b(do)f(not)h(all)g(ha)n(v)n(e)427 2443 y(v)-5
b(alid)34 b(v)-5 b(ariance)32 b(estimates)h(asso)r(ciated)f(with)h
(them.)55 b(In)33 b(this)h(con)n(text,)g(an)f(input)i(v)-5
-b(ariance)32 b(estimate)427 4565 y(ma)n(y)27 b(b)r(e)i(regarded)d(as)h
+b(ariance)32 b(estimate)427 2543 y(ma)n(y)27 b(b)r(e)i(regarded)d(as)h
(bad)h(either)g(b)r(ecause)f(it)h(has)g(the)g(v)-5 b(alue)28
b(BAD)n(V)-9 b(AL)28 b(\(and)g(the)h(AST)p Ft(__)p Fj(USEBAD)427
-4665 y(\015ag)e(is)h(set\),)g(or)e(b)r(ecause)h(it)h(is)g(negativ)n(e.)
-340 4805 y Fi(\017)45 b Fj(The)23 b(set)f(of)h(neigh)n(b)r(ouring)e
+2642 y(\015ag)e(is)h(set\),)g(or)e(b)r(ecause)h(it)h(is)g(negativ)n(e.)
+340 2776 y Fi(\017)45 b Fj(The)23 b(set)f(of)h(neigh)n(b)r(ouring)e
(input)i(pixels)g(for)f(whic)n(h)g(v)-5 b(alid)23 b(v)-5
b(ariance)21 b(v)-5 b(alues)22 b(are)g(a)n(v)-5 b(ailable)21
-b(is)h(unsuitable)427 4904 y(for)30 b(calculating)f(an)g(o)n(v)n(erall)
+b(is)h(unsuitable)427 2875 y(for)30 b(calculating)f(an)g(o)n(v)n(erall)
f(v)-5 b(ariance)28 b(v)-5 b(alue.)44 b(Whether)30 b(this)g(is)g(true)g
-(ma)n(y)f(dep)r(end)h(on)g(the)g(sub-pixel)427 5004 y(in)n(terp)r
-(olation)d(sc)n(heme)g(in)h(use.)340 5144 y Fi(\017)45
+(ma)n(y)f(dep)r(end)h(on)g(the)g(sub-pixel)427 2975 y(in)n(terp)r
+(olation)d(sc)n(heme)g(in)h(use.)340 3108 y Fi(\017)45
b Fj(The)25 b(v)-5 b(ariance)23 b(v)-5 b(alue)25 b(lies)f(outside)h
(the)g(range)e(whic)n(h)i(can)f(b)r(e)h(represen)n(ted)e(using)i(the)g
-(data)f(t)n(yp)r(e)h(of)f(the)427 5244 y(OUT)p Ft(_)p
-Fj(V)-9 b(AR)28 b(arra)n(y)-7 b(.)227 5420 y(If)22 b(the)f(AST)p
+(data)f(t)n(yp)r(e)h(of)f(the)427 3208 y(OUT)p Ft(_)p
+Fj(V)-9 b(AR)28 b(arra)n(y)-7 b(.)227 3371 y(If)22 b(the)f(AST)p
Ft(__)p Fj(NOBAD)g(\015ag)g(is)f(sp)r(eci\014ed)i(via)e(argumen)n(t)g
(FLA)n(GS,)i(then)f(output)h(arra)n(y)d(elemen)n(ts)i(that)g(w)n(ould)
-227 5520 y(otherwise)k(b)r(e)i(set)f(to)g(BAD)n(V)-9
+227 3470 y(otherwise)k(b)r(e)i(set)f(to)g(BAD)n(V)-9
b(AL)26 b(are)g(instead)f(left)i(holding)f(the)g(v)-5
b(alue)26 b(they)h(had)e(on)h(en)n(try)g(to)g(this)g(function.)227
-5620 y(The)i(n)n(um)n(b)r(er)f(of)h(suc)n(h)f(arra)n(y)e(elemen)n(ts)j
+3570 y(The)i(n)n(um)n(b)r(er)f(of)h(suc)n(h)f(arra)n(y)e(elemen)n(ts)j
(is)f(returned)g(as)g(the)h(function)h(v)-5 b(alue.)p
-eop end
-%%Page: 351 361
-TeXDict begin 351 360 bop 3643 52 a FG(351)p 0 351 3780
-12 v 0 482 a FA(AST)p Fe(_)p FA(RESOL)-15 b(VE)1243 483
-y Fd(Resolv)m(e)38 b(a)h(v)m(ector)e(in)m(to)g(t)m(w)m(o)1294
-583 y(orthogonal)f(comp)s(onen)m(ts)2828 482 y FA(AST)p
-Fe(_)p FA(RESOL)-15 b(VE)0 748 y Fc(Description:)44 b
-Fj(This)21 b(routine)f(resolv)n(es)e(a)i(v)n(ector)g(in)n(to)g(t)n(w)n
-(o)f(p)r(erp)r(endicular)i(comp)r(onen)n(ts.)34 b(The)20
-b(v)n(ector)f(from)h(p)r(oin)n(t)h(1)227 847 y(to)g(p)r(oin)n(t)g(2)g
+0 3770 3780 12 v 0 3901 a FA(AST)p Fe(_)p FA(RESOL)-15
+b(VE)1243 3902 y Fd(Resolv)m(e)38 b(a)h(v)m(ector)e(in)m(to)g(t)m(w)m
+(o)1294 4002 y(orthogonal)f(comp)s(onen)m(ts)2828 3901
+y FA(AST)p Fe(_)p FA(RESOL)-15 b(VE)0 4191 y Fc(Description:)44
+b Fj(This)21 b(routine)f(resolv)n(es)e(a)i(v)n(ector)g(in)n(to)g(t)n(w)
+n(o)f(p)r(erp)r(endicular)i(comp)r(onen)n(ts.)34 b(The)20
+b(v)n(ector)f(from)h(p)r(oin)n(t)h(1)227 4291 y(to)g(p)r(oin)n(t)g(2)g
(is)g(used)g(as)f(the)h(basis)f(v)n(ector.)34 b(The)21
b(v)n(ector)e(from)i(p)r(oin)n(t)g(1)g(to)g(p)r(oin)n(t)g(3)f(is)h
-(resolv)n(ed)e(in)n(to)i(comp)r(onen)n(ts)227 947 y(parallel)29
+(resolv)n(ed)e(in)n(to)i(comp)r(onen)n(ts)227 4391 y(parallel)29
b(and)h(p)r(erp)r(endicular)g(to)g(this)g(basis)g(v)n(ector.)43
b(The)30 b(lengths)g(of)g(the)h(t)n(w)n(o)e(comp)r(onen)n(ts)h(are)f
-(returned,)227 1046 y(together)e(with)h(the)g(p)r(osition)f(of)h
+(returned,)227 4490 y(together)e(with)h(the)g(p)r(osition)f(of)h
(closest)f(aproac)n(h)e(of)j(the)g(basis)f(v)n(ector)f(to)i(p)r(oin)n
-(t)f(3.)0 1184 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
+(t)f(3.)0 4641 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
b(AST_RESOLVE\()c(THIS,)k(POINT1,)f(POINT2,)f(POINT3,)h(POINT4,)g(D1,)h
-(D2,)g(STATUS)f(\))0 1322 y Fc(Argumen)m(ts:)259 1446
-y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1546 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(F)-7 b(rame.)259 1667 y Fc(POINT1\()32 b
+(D2,)g(STATUS)f(\))0 4791 y Fc(Argumen)m(ts:)259 4928
+y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 5028 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(F)-7 b(rame.)259 5161 y Fc(POINT1\()32 b
Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m(en\))427
-1766 y Fj(An)i(arra)n(y)c(with)k(one)e(elemen)n(t)i(for)e(eac)n(h)g(F)
+5261 y Fj(An)i(arra)n(y)c(with)k(one)e(elemen)n(t)i(for)e(eac)n(h)g(F)
-7 b(rame)32 b(axis)f(\(Naxes)h(attribute\).)50 b(This)32
-b(marks)f(the)h(start)g(of)427 1866 y(the)c(basis)f(v)n(ector,)f(and)i
+b(marks)f(the)h(start)g(of)427 5360 y(the)c(basis)f(v)n(ector,)f(and)i
(of)f(the)h(v)n(ector)f(to)g(b)r(e)h(resolv)n(ed.)259
-1987 y Fc(POINT2\()k Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m
-(en\))427 2086 y Fj(An)c(arra)n(y)c(with)k(one)e(elemen)n(t)h(for)f
+5494 y Fc(POINT2\()k Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m
+(en\))427 5593 y Fj(An)c(arra)n(y)c(with)k(one)e(elemen)n(t)h(for)f
(eac)n(h)h(F)-7 b(rame)25 b(axis)g(\(Naxes)h(attribute\).)36
-b(This)26 b(marks)f(the)h(end)g(of)g(the)427 2186 y(basis)h(v)n(ector.)
-259 2307 y Fc(POINT3\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e
-(\(Giv)m(en\))427 2407 y Fj(An)c(arra)n(y)c(with)k(one)e(elemen)n(t)h
-(for)f(eac)n(h)h(F)-7 b(rame)25 b(axis)g(\(Naxes)h(attribute\).)36
-b(This)26 b(marks)f(the)h(end)g(of)g(the)427 2506 y(v)n(ector)h(to)g(b)
-r(e)h(resolv)n(ed.)259 2627 y Fc(POINT4\()k Fi(\003)f
-Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Returned\))427 2727
-y Fj(An)23 b(arra)n(y)d(with)j(one)f(elemen)n(t)g(for)g(eac)n(h)f(F)-7
-b(rame)22 b(axis)f(in)i(whic)n(h)f(the)h(co)r(ordinates)e(of)h(the)h(p)
-r(oin)n(t)f(of)g(closest)427 2826 y(approac)n(h)k(of)i(the)f(basis)g(v)
-n(ector)g(to)g(p)r(oin)n(t)h(3)f(will)h(b)r(e)g(returned.)259
-2947 y Fc(D1)k(=)g(DOUBLE)g(PRECISION)g(\(Returned\))427
-3047 y Fj(The)i(distance)f(from)g(p)r(oin)n(t)g(1)g(to)g(p)r(oin)n(t)h
-(4)f(\(that)h(is,)h(the)e(length)h(of)f(the)h(comp)r(onen)n(t)f
-(parallel)f(to)h(the)427 3147 y(basis)27 b(v)n(ector\).)36
-b(P)n(ositiv)n(e)26 b(v)-5 b(alues)27 b(are)g(in)h(the)g(same)f(sense)g
-(as)g(mo)n(v)n(emen)n(t)f(from)i(p)r(oin)n(t)f(1)h(to)f(p)r(oin)n(t)h
-(2.)259 3268 y Fc(D2)k(=)g(DOUBLE)g(PRECISION)g(\(Returned\))427
-3367 y Fj(The)d(distance)f(from)g(p)r(oin)n(t)g(4)g(to)g(p)r(oin)n(t)h
-(3)e(\(that)i(is,)g(the)f(length)h(of)f(the)h(comp)r(onen)n(t)f(p)r
-(erp)r(endicular)g(to)427 3467 y(the)g(basis)f(v)n(ector\).)36
+b(This)26 b(marks)f(the)h(end)g(of)g(the)427 5693 y(basis)h(v)n(ector.)
+p eop end
+%%Page: 354 364
+TeXDict begin 354 363 bop 0 52 a FG(354)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(POINT3\()h
+Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m(en\))427
+451 y Fj(An)c(arra)n(y)c(with)k(one)e(elemen)n(t)h(for)f(eac)n(h)h(F)-7
+b(rame)25 b(axis)g(\(Naxes)h(attribute\).)36 b(This)26
+b(marks)f(the)h(end)g(of)g(the)427 551 y(v)n(ector)h(to)g(b)r(e)h
+(resolv)n(ed.)259 695 y Fc(POINT4\()k Fi(\003)f Fc(\))h(=)g(DOUBLE)h
+(PRECISION)e(\(Returned\))427 794 y Fj(An)23 b(arra)n(y)d(with)j(one)f
+(elemen)n(t)g(for)g(eac)n(h)f(F)-7 b(rame)22 b(axis)f(in)i(whic)n(h)f
+(the)h(co)r(ordinates)e(of)h(the)h(p)r(oin)n(t)f(of)g(closest)427
+894 y(approac)n(h)k(of)i(the)f(basis)g(v)n(ector)g(to)g(p)r(oin)n(t)h
+(3)f(will)h(b)r(e)g(returned.)259 1038 y Fc(D1)k(=)g(DOUBLE)g
+(PRECISION)g(\(Returned\))427 1138 y Fj(The)i(distance)f(from)g(p)r
+(oin)n(t)g(1)g(to)g(p)r(oin)n(t)h(4)f(\(that)h(is,)h(the)e(length)h(of)
+f(the)h(comp)r(onen)n(t)f(parallel)f(to)h(the)427 1238
+y(basis)27 b(v)n(ector\).)36 b(P)n(ositiv)n(e)26 b(v)-5
+b(alues)27 b(are)g(in)h(the)g(same)f(sense)g(as)g(mo)n(v)n(emen)n(t)f
+(from)i(p)r(oin)n(t)f(1)h(to)f(p)r(oin)n(t)h(2.)259 1382
+y Fc(D2)k(=)g(DOUBLE)g(PRECISION)g(\(Returned\))427 1481
+y Fj(The)d(distance)f(from)g(p)r(oin)n(t)g(4)g(to)g(p)r(oin)n(t)h(3)e
+(\(that)i(is,)g(the)f(length)h(of)f(the)h(comp)r(onen)n(t)f(p)r(erp)r
+(endicular)g(to)427 1581 y(the)g(basis)f(v)n(ector\).)36
b(The)28 b(v)-5 b(alue)27 b(is)h(alw)n(a)n(ys)d(p)r(ositiv)n(e.)259
-3588 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 3687 y Fj(The)c(global)e(status.)0 3837
-y Fc(Notes:)340 4108 y Fi(\017)45 b Fj(Eac)n(h)20 b(v)n(ector)g(used)h
+1725 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 1825 y Fj(The)c(global)e(status.)0 2010
+y Fc(Notes:)340 2315 y Fi(\017)45 b Fj(Eac)n(h)20 b(v)n(ector)g(used)h
(in)h(this)f(routine)g(is)g(the)h(path)f(of)g(shortest)g(distance)g(b)r
(et)n(w)n(een)g(t)n(w)n(o)f(p)r(oin)n(ts,)j(as)d(de\014ned)427
-4208 y(b)n(y)28 b(the)g(AST)p Ft(_)p Fj(DIST)-7 b(ANCE)28
-b(function.)340 4329 y Fi(\017)45 b Fj(This)19 b(function)g(will)g
+2415 y(b)n(y)28 b(the)g(AST)p Ft(_)p Fj(DIST)-7 b(ANCE)28
+b(function.)340 2559 y Fi(\017)45 b Fj(This)19 b(function)g(will)g
(return)f Ft(")p Fj(bad)p Ft(")g Fj(co)r(ordinate)g(v)-5
b(alues)18 b(\(AST)p Ft(__)p Fj(BAD\))i(if)f(an)n(y)f(of)g(the)i(input)
-f(co)r(ordinates)427 4428 y(has)27 b(this)h(v)-5 b(alue,)28
+f(co)r(ordinates)427 2659 y(has)27 b(this)h(v)-5 b(alue,)28
b(or)e(if)j(the)f(required)e(output)i(v)-5 b(alues)28
-b(are)e(unde\014ned.)p 0 4604 V 0 4734 a FA(AST)p Fe(_)p
-FA(RET)-11 b(AINFITS)1456 4735 y Fd(Indicate)38 b(that)f(the)1459
-4835 y(curren)m(t)g(card)i(in)f(a)1388 4935 y(FitsChan)f(should)i(b)s
-(e)1682 5034 y(retained)2618 4734 y FA(AST)p Fe(_)p FA(RET)-11
-b(AINFITS)0 5176 y Fc(Description:)44 b Fj(This)e(routine)f(stores)g(a)
-g(\015ag)g(with)h(the)g(curren)n(t)f(card)g(in)h(the)g(FitsChan)g
-(indicating)f(that)h(the)227 5276 y(card)35 b(should)g(not)h(b)r(e)g
-(remo)n(v)n(ed)d(from)j(the)g(FitsChan)f(when)h(an)f(Ob)5
-b(ject)35 b(is)h(read)e(from)i(the)f(FitsChan)h(us-)227
-5375 y(ing)28 b(AST)p Ft(_)p Fj(READ.)227 5494 y(Cards)23
-b(that)i(ha)n(v)n(e)e(not)h(b)r(een)g(\015agged)f(in)i(this)f(w)n(a)n
-(y)f(are)g(remo)n(v)n(ed)f(when)j(a)e(read)h(op)r(eration)f(completes)h
-(succes-)227 5593 y(fully)-7 b(,)27 b(but)f(only)g(if)g(the)g(card)f(w)
-n(as)f(used)i(in)g(the)g(pro)r(cess)e(of)i(creating)f(the)h(returned)f
-(AST)h(Ob)5 b(ject.)36 b(An)n(y)26 b(cards)227 5693 y(that)g(are)e
-(irrelev)-5 b(an)n(t)24 b(to)i(the)f(creation)g(of)g(the)h(AST)f(Ob)5
+b(are)e(unde\014ned.)p 0 2881 3780 12 v 0 3011 a FA(AST)p
+Fe(_)p FA(RET)-11 b(AINFITS)1456 3012 y Fd(Indicate)38
+b(that)f(the)1459 3112 y(curren)m(t)g(card)i(in)f(a)1388
+3212 y(FitsChan)f(should)i(b)s(e)1682 3311 y(retained)2618
+3011 y FA(AST)p Fe(_)p FA(RET)-11 b(AINFITS)0 3500 y
+Fc(Description:)44 b Fj(This)e(routine)f(stores)g(a)g(\015ag)g(with)h
+(the)g(curren)n(t)f(card)g(in)h(the)g(FitsChan)g(indicating)f(that)h
+(the)227 3599 y(card)35 b(should)g(not)h(b)r(e)g(remo)n(v)n(ed)d(from)j
+(the)g(FitsChan)f(when)h(an)f(Ob)5 b(ject)35 b(is)h(read)e(from)i(the)f
+(FitsChan)h(us-)227 3699 y(ing)28 b(AST)p Ft(_)p Fj(READ.)227
+3835 y(Cards)23 b(that)i(ha)n(v)n(e)e(not)h(b)r(een)g(\015agged)f(in)i
+(this)f(w)n(a)n(y)f(are)g(remo)n(v)n(ed)f(when)j(a)e(read)h(op)r
+(eration)f(completes)h(succes-)227 3935 y(fully)-7 b(,)27
+b(but)f(only)g(if)g(the)g(card)f(w)n(as)f(used)i(in)g(the)g(pro)r(cess)
+e(of)i(creating)f(the)h(returned)f(AST)h(Ob)5 b(ject.)36
+b(An)n(y)26 b(cards)227 4034 y(that)g(are)e(irrelev)-5
+b(an)n(t)24 b(to)i(the)f(creation)g(of)g(the)h(AST)f(Ob)5
b(ject)26 b(are)e(retained)h(whether)g(or)g(not)g(they)g(are)g
-(\015agged.)p eop end
-%%Page: 352 362
-TeXDict begin 352 361 bop 0 52 a FG(352)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(In)m(v)m(o)s(cation:)
-123 b Ft(CALL)42 b(AST_RETAINFITS\()37 b(THIS,)42 b(STATUS)f(\))0
-538 y Fc(Argumen)m(ts:)259 712 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))
-427 812 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
-963 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 1063 y Fj(The)c(global)e(status.)0 1262
-y Fc(Notes:)340 1582 y Fi(\017)45 b Fj(This)23 b(function)f(returns)g
+(\015agged.)0 4207 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
+b(AST_RETAINFITS\()37 b(THIS,)42 b(STATUS)f(\))0 4379
+y Fc(Argumen)m(ts:)259 4538 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
+4638 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
+4782 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 4882 y Fj(The)c(global)e(status.)0 5066
+y Fc(Notes:)340 5372 y Fi(\017)45 b Fj(This)23 b(function)f(returns)g
(without)h(action)e(if)i(the)g(FitsChan)f(is)h(initially)f(p)r
(ositioned)g(at)g(the)h Ft(")p Fj(end-of-\014le)p Ft(")427
-1682 y Fj(\(i.e.)38 b(if)28 b(the)g(Card)e(attribute)i(exceeds)f(the)h
+5471 y Fj(\(i.e.)38 b(if)28 b(the)g(Card)e(attribute)i(exceeds)f(the)h
(n)n(um)n(b)r(er)f(of)h(cards)e(in)i(the)g(FitsChan\).)340
-1834 y Fi(\017)45 b Fj(The)28 b(curren)n(t)f(card)f(is)i(not)f(c)n
-(hanged)g(b)n(y)g(this)h(function.)p 0 2070 3780 12 v
-0 2201 a FA(AST)p Fe(_)p FA(SAME)946 2202 y Fd(T)-10
+5616 y Fi(\017)45 b Fj(The)28 b(curren)n(t)f(card)f(is)i(not)f(c)n
+(hanged)g(b)n(y)g(this)h(function.)p eop end
+%%Page: 355 365
+TeXDict begin 355 364 bop 3643 52 a FG(355)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(SAME)946 483 y Fd(T)-10
b(est)39 b(if)f(t)m(w)m(o)f(AST)h(p)s(oin)m(ters)g(refer)g(to)g(the)
-1569 2317 y(same)g(Ob)7 b(ject)3056 2201 y FA(AST)p Fe(_)p
-FA(SAME)0 2543 y Fc(Description:)44 b Fj(This)31 b(function)g(returns)f
+1569 598 y(same)g(Ob)7 b(ject)3056 482 y FA(AST)p Fe(_)p
+FA(SAME)0 786 y Fc(Description:)44 b Fj(This)31 b(function)g(returns)f
(a)g(logical)f(result)h(to)h(indicate)f(whether)h(t)n(w)n(o)e(p)r(oin)n
-(ters)h(refer)g(to)g(the)h(same)227 2642 y(Ob)5 b(ject.)0
-2829 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_SAME\()d
-(THIS,)h(THAT,)h(STATUS)f(\))0 3016 y Fc(Argumen)m(ts:)259
-3190 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 3290
+(ters)h(refer)g(to)g(the)h(same)227 886 y(Ob)5 b(ject.)0
+1035 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_SAME\()d
+(THIS,)h(THAT,)h(STATUS)f(\))0 1184 y Fc(Argumen)m(ts:)259
+1321 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1420
y Fj(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f(Ob)5 b(ject.)259
-3441 y Fc(THA)-8 b(T)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
-3541 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(second)f(Ob)5
-b(ject.)259 3693 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h
-(and)g(Returned\))427 3792 y Fj(The)c(global)e(status.)0
-3992 y Fc(Class)31 b(Applicabilit)m(y:)259 4166 y(Ob)5
-b(ject)427 4265 y Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5
-b(jects.)0 4465 y Fc(Returned)32 b(V)-8 b(alue:)259 4638
-y(AST)p Ft(_)p Fc(SAME)32 b(=)g(LOGICAL)427 4738 y Fj(.TR)n(UE.)c(if)g
+1553 y Fc(THA)-8 b(T)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
+1653 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(second)f(Ob)5
+b(ject.)259 1785 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h
+(and)g(Returned\))427 1885 y Fj(The)c(global)e(status.)0
+2047 y Fc(Class)31 b(Applicabilit)m(y:)259 2183 y(Ob)5
+b(ject)427 2283 y Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5
+b(jects.)0 2445 y Fc(Returned)32 b(V)-8 b(alue:)259 2581
+y(AST)p Ft(_)p Fc(SAME)32 b(=)g(LOGICAL)427 2681 y Fj(.TR)n(UE.)c(if)g
(the)g(t)n(w)n(o)f(p)r(oin)n(ters)f(refer)h(to)h(the)g(same)f(Ob)5
-b(ject,)27 b(otherwise)g(.F)-9 b(ALSE.)0 4937 y Fc(Notes:)340
-5257 y Fi(\017)45 b Fj(Tw)n(o)37 b(indep)r(enden)n(t)h(Ob)5
+b(ject,)27 b(otherwise)g(.F)-9 b(ALSE.)0 2842 y Fc(Notes:)340
+3125 y Fi(\017)45 b Fj(Tw)n(o)37 b(indep)r(enden)n(t)h(Ob)5
b(jects)37 b(that)g(happ)r(en)h(to)f(b)r(e)h(iden)n(tical)f(are)f(not)h
-(considered)g(to)g(b)r(e)h(the)f(same)427 5357 y(Ob)5
-b(ject)28 b(b)n(y)f(this)h(function.)340 5509 y Fi(\017)45
+(considered)g(to)g(b)r(e)h(the)f(same)427 3224 y(Ob)5
+b(ject)28 b(b)n(y)f(this)h(function.)340 3357 y Fi(\017)45
b Fj(A)28 b(v)-5 b(alue)28 b(of)f(.F)-9 b(ALSE.)28 b(will)g(b)r(e)g
(returned)f(if)h(this)g(function)g(is)f(in)n(v)n(ok)n(ed)g(with)h(ST)-7
-b(A)g(TUS)28 b(set)g(to)f(an)h(error)427 5608 y(v)-5
+b(A)g(TUS)28 b(set)g(to)f(an)h(error)427 3457 y(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-eop end
-%%Page: 353 363
-TeXDict begin 353 362 bop 3643 52 a FG(353)p 0 351 3780
-12 v 0 482 a FA(AST)p Fe(_)p FA(SELECTORMAP)293 b Fd(Create)37
-b(a)1573 581 y(SelectorMap)2403 482 y FA(AST)p Fe(_)p
-FA(SELECTORMAP)0 778 y Fc(Description:)44 b Fj(This)28
-b(function)g(creates)f(a)g(new)g(SelectorMap)g(and)g(optionally)g
-(initialises)g(its)h(attributes.)227 906 y(A)g(SelectorMap)f(is)g(a)g
-(Mapping)h(that)g(iden)n(ti\014es)f(whic)n(h)h(Region)f(con)n(tains)f
-(a)i(giv)n(en)e(input)j(p)r(osition.)227 1034 y(A)40
-b(SelectorMap)e(encapsulates)h(a)g(n)n(um)n(b)r(er)g(of)g(Regions)f
-(that)i(all)f(ha)n(v)n(e)f(the)i(same)f(n)n(um)n(b)r(er)g(of)g(axes)g
-(and)227 1134 y(represen)n(t)31 b(the)h(same)f(co)r(ordinate)g(F)-7
-b(rame.)49 b(The)32 b(n)n(um)n(b)r(er)g(of)f(inputs)i(\(Nin)f
-(attribute\))h(of)e(the)i(SelectorMap)227 1233 y(equals)24
+0 3656 V 0 3786 a FA(AST)p Fe(_)p FA(SELECTORMAP)293
+b Fd(Create)37 b(a)1573 3886 y(SelectorMap)2403 3786
+y FA(AST)p Fe(_)p FA(SELECTORMAP)0 4074 y Fc(Description:)44
+b Fj(This)28 b(function)g(creates)f(a)g(new)g(SelectorMap)g(and)g
+(optionally)g(initialises)g(its)h(attributes.)227 4199
+y(A)g(SelectorMap)f(is)g(a)g(Mapping)h(that)g(iden)n(ti\014es)f(whic)n
+(h)h(Region)f(con)n(tains)f(a)i(giv)n(en)e(input)j(p)r(osition.)227
+4323 y(A)40 b(SelectorMap)e(encapsulates)h(a)g(n)n(um)n(b)r(er)g(of)g
+(Regions)f(that)i(all)f(ha)n(v)n(e)f(the)i(same)f(n)n(um)n(b)r(er)g(of)
+g(axes)g(and)227 4423 y(represen)n(t)31 b(the)h(same)f(co)r(ordinate)g
+(F)-7 b(rame.)49 b(The)32 b(n)n(um)n(b)r(er)g(of)f(inputs)i(\(Nin)f
+(attribute\))h(of)e(the)i(SelectorMap)227 4523 y(equals)24
b(the)h(n)n(um)n(b)r(er)f(of)g(axes)f(spanned)h(b)n(y)g(one)g(of)h(the)
f(encapsulated)g(Region.)35 b(All)25 b(SelectorMaps)e(ha)n(v)n(e)g
-(only)227 1333 y(a)k(single)h(output.)37 b(SelectorMaps)26
+(only)227 4622 y(a)k(single)h(output.)37 b(SelectorMaps)26
b(do)i(not)f(de\014ne)h(an)f(in)n(v)n(erse)f(transformation.)227
-1461 y(F)-7 b(or)36 b(eac)n(h)f(input)i(p)r(osition,)h(the)e(forw)n
+4747 y(F)-7 b(or)36 b(eac)n(h)f(input)i(p)r(osition,)h(the)e(forw)n
(ard)e(transformation)h(of)h(a)f(SelectorMap)g(searc)n(hes)f(through)h
-(the)i(en-)227 1561 y(capsulated)d(Regions)f(\(in)i(the)g(order)e
+(the)i(en-)227 4846 y(capsulated)d(Regions)f(\(in)i(the)g(order)e
(supplied)i(when)f(the)h(SelectorMap)e(w)n(as)h(created\))f(un)n(til)i
-(a)f(Region)g(is)227 1660 y(found)27 b(whic)n(h)g(con)n(tains)f(the)h
+(a)f(Region)g(is)227 4946 y(found)27 b(whic)n(h)g(con)n(tains)f(the)h
(input)g(p)r(osition.)36 b(The)27 b(index)g(asso)r(ciated)e(with)i
-(this)g(Region)f(is)h(returned)f(as)g(the)227 1760 y(SelectorMap)h
+(this)g(Region)f(is)h(returned)f(as)g(the)227 5046 y(SelectorMap)h
(output)h(v)-5 b(alue)27 b(\(the)h(index)g(v)-5 b(alue)27
b(is)h(the)g(p)r(osition)f(of)h(the)f(Region)g(within)h(the)g(list)g
-(of)g(Regions)227 1860 y(supplied)c(when)g(the)g(SelectorMap)f(w)n(as)g
+(of)g(Regions)227 5145 y(supplied)c(when)g(the)g(SelectorMap)f(w)n(as)g
(created,)g(starting)g(at)h(1)f(for)g(the)h(\014rst)g(Region\).)35
-b(If)24 b(an)f(input)i(p)r(osition)227 1959 y(is)j(not)f(con)n(tained)g
+b(If)24 b(an)f(input)i(p)r(osition)227 5245 y(is)j(not)f(con)n(tained)g
(within)i(an)n(y)d(Region,)h(a)h(v)-5 b(alue)27 b(of)h(zero)e(is)i
(returned)f(b)n(y)g(the)h(forw)n(ard)e(transformation.)227
-2088 y(If)35 b(a)e(comp)r(ound)h(Mapping)g(con)n(tains)f(a)h
+5369 y(If)35 b(a)e(comp)r(ound)h(Mapping)g(con)n(tains)f(a)h
(SelectorMap)f(in)h(series)f(with)i(its)f(o)n(wn)g(in)n(v)n(erse,)g
-(the)g(com)n(bination)227 2187 y(of)29 b(the)f(t)n(w)n(o)g(adjacen)n(t)
+(the)g(com)n(bination)227 5469 y(of)29 b(the)f(t)n(w)n(o)g(adjacen)n(t)
g(SelectorMaps)f(will)h(b)r(e)h(replaced)e(b)n(y)h(a)g(UnitMap)h(when)g
-(the)f(comp)r(ound)h(Mapping)f(is)227 2287 y(simpli\014ed)g(using)g
-(AST)p Ft(_)p Fj(SIMPLIFY.)227 2415 y(In)g(practice,)f(SelectorMaps)f
-(are)h(often)h(used)f(in)h(conjunction)g(with)g(Switc)n(hMaps.)0
-2572 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i
-(AST_SELECTORMAP\()37 b(NREG,)42 b(REGS,)f(BADVAL,)g(OPTIONS,)f(STATUS)
-h(\))0 2729 y Fc(Argumen)m(ts:)259 2873 y(NREG)31 b(=)h(INTEGER)f
-(\(Giv)m(en\))427 2972 y Fj(The)d(n)n(um)n(b)r(er)f(of)h(supplied)g
-(Regions.)259 3109 y Fc(REGS\()j(NREG)g(\))h(=)g(INTEGER)g(\(Giv)m
-(en\))427 3209 y Fj(An)41 b(arra)n(y)d(of)j(p)r(oin)n(ters)f(to)g(the)h
-(Regions.)74 b(All)41 b(the)g(supplied)g(Regions)f(m)n(ust)g(relate)g
-(to)g(the)h(same)427 3308 y(co)r(ordinate)23 b(F)-7 b(rame.)35
-b(The)23 b(n)n(um)n(b)r(er)g(of)h(axes)e(in)i(this)g(co)r(ordinate)e(F)
--7 b(rame)23 b(de\014nes)h(the)f(n)n(um)n(b)r(er)h(of)f(inputs)427
-3408 y(for)k(the)h(SelectorMap.)259 3544 y Fc(BAD)m(V)-11
-b(AL)34 b(=)e(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427 3644
+(the)f(comp)r(ound)h(Mapping)f(is)227 5569 y(simpli\014ed)g(using)g
+(AST)p Ft(_)p Fj(SIMPLIFY.)227 5693 y(In)g(practice,)f(SelectorMaps)f
+(are)h(often)h(used)f(in)h(conjunction)g(with)g(Switc)n(hMaps.)p
+eop end
+%%Page: 356 366
+TeXDict begin 356 365 bop 0 52 a FG(356)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(In)m(v)m(o)s(cation:)
+123 b Ft(RESULT)41 b(=)i(AST_SELECTORMAP\()37 b(NREG,)42
+b(REGS,)f(BADVAL,)g(OPTIONS,)f(STATUS)h(\))0 498 y Fc(Argumen)m(ts:)259
+633 y(NREG)31 b(=)h(INTEGER)f(\(Giv)m(en\))427 732 y
+Fj(The)d(n)n(um)n(b)r(er)f(of)h(supplied)g(Regions.)259
+863 y Fc(REGS\()j(NREG)g(\))h(=)g(INTEGER)g(\(Giv)m(en\))427
+962 y Fj(An)41 b(arra)n(y)d(of)j(p)r(oin)n(ters)f(to)g(the)h(Regions.)
+74 b(All)41 b(the)g(supplied)g(Regions)f(m)n(ust)g(relate)g(to)g(the)h
+(same)427 1062 y(co)r(ordinate)23 b(F)-7 b(rame.)35 b(The)23
+b(n)n(um)n(b)r(er)g(of)h(axes)e(in)i(this)g(co)r(ordinate)e(F)-7
+b(rame)23 b(de\014nes)h(the)f(n)n(um)n(b)r(er)h(of)f(inputs)427
+1162 y(for)k(the)h(SelectorMap.)259 1292 y Fc(BAD)m(V)-11
+b(AL)34 b(=)e(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427 1392
y Fj(The)k(v)-5 b(alue)34 b(to)g(b)r(e)h(returned)e(b)n(y)h(the)h(forw)
n(ard)e(transformation)f(of)j(the)f(SelectorMap)g(for)f(an)n(y)h(input)
-427 3744 y(p)r(ositions)27 b(that)h(ha)n(v)n(e)f(a)g(bad)g(\(AST)p
+427 1492 y(p)r(ositions)27 b(that)h(ha)n(v)n(e)f(a)g(bad)g(\(AST)p
Ft(__)p Fj(BAD\))i(v)-5 b(alue)27 b(on)g(an)n(y)g(axis.)259
-3880 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 3980 y Fj(A)g(c)n(haracter)e(string)
+1622 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1722 y Fj(A)g(c)n(haracter)e(string)
h(con)n(taining)f(an)h(optional)g(comma-separated)e(list)j(of)g
-(attribute)f(assignmen)n(ts)g(to)427 4080 y(b)r(e)36
+(attribute)f(assignmen)n(ts)g(to)427 1821 y(b)r(e)36
b(used)f(for)f(initialising)h(the)g(new)g(SelectorMap.)58
b(The)35 b(syn)n(tax)f(used)h(is)g(iden)n(tical)g(to)g(that)g(for)f
-(the)427 4179 y(AST)p Ft(_)p Fj(SET)27 b(routine.)259
-4316 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 4415 y Fj(The)c(global)e(status.)0 4585
-y Fc(Returned)32 b(V)-8 b(alue:)259 4729 y(AST)p Ft(_)p
-Fc(SELECTORMAP)32 b(=)g(INTEGER)427 4828 y Fj(A)c(p)r(oin)n(ter)f(to)h
-(the)g(new)g(SelectorMap.)0 4998 y Fc(Notes:)340 5288
+(the)427 1921 y(AST)p Ft(_)p Fj(SET)27 b(routine.)259
+2052 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 2151 y Fj(The)c(global)e(status.)0 2311
+y Fc(Returned)32 b(V)-8 b(alue:)259 2445 y(AST)p Ft(_)p
+Fc(SELECTORMAP)32 b(=)g(INTEGER)427 2545 y Fj(A)c(p)r(oin)n(ter)f(to)h
+(the)g(new)g(SelectorMap.)0 2704 y Fc(Notes:)340 2985
y Fi(\017)45 b Fj(Deep)22 b(copies)f(are)f(tak)n(en)h(of)g(the)h
(supplied)g(Regions.)33 b(This)22 b(means)f(that)g(an)n(y)g(subsequen)n
-(t)g(c)n(hanges)f(made)427 5387 y(to)k(the)h(comp)r(onen)n(t)f(Regions)
+(t)g(c)n(hanges)f(made)427 3084 y(to)k(the)h(comp)r(onen)n(t)f(Regions)
f(using)h(the)g(supplied)h(p)r(oin)n(ters)e(will)i(ha)n(v)n(e)e(no)g
-(e\013ect)i(on)f(the)h(SelectorMap.)340 5524 y Fi(\017)45
+(e\013ect)i(on)f(the)h(SelectorMap.)340 3215 y Fi(\017)45
b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 5623
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 3314
y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p eop end
-%%Page: 354 364
-TeXDict begin 354 363 bop 0 52 a FG(354)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(SET)1023 483 y Fd(Set)38
-b(attribute)f(v)-7 b(alues)38 b(for)g(an)h(Ob)7 b(ject)3192
-482 y FA(AST)p Fe(_)p FA(SET)0 675 y Fc(Description:)44
-b Fj(This)22 b(routine)g(assigns)e(a)h(set)h(of)g(attribute)g(v)-5
+(fail)h(for)f(an)n(y)g(reason.)p 0 3509 3780 12 v 0 3640
+a FA(AST)p Fe(_)p FA(SET)1023 3641 y Fd(Set)38 b(attribute)f(v)-7
+b(alues)38 b(for)g(an)h(Ob)7 b(ject)3192 3640 y FA(AST)p
+Fe(_)p FA(SET)0 3825 y Fc(Description:)44 b Fj(This)22
+b(routine)g(assigns)e(a)h(set)h(of)g(attribute)g(v)-5
b(alues)21 b(to)h(an)f(Ob)5 b(ject,)23 b(o)n(v)n(er-riding)c(an)n(y)i
-(previous)g(v)-5 b(alues.)227 775 y(The)33 b(attributes)h(and)f(their)g
-(new)g(v)-5 b(alues)33 b(are)f(sp)r(eci\014ed)h(via)g(a)g(c)n(haracter)
-e(string,)j(whic)n(h)f(should)g(con)n(tain)f(a)227 875
-y(comma-separated)26 b(list)h(of)h(the)g(form:)227 1001
-y Ft(")p Fj(attribute)p Ft(_)p Fj(1)f(=)g(v)-5 b(alue)p
+(previous)g(v)-5 b(alues.)227 3925 y(The)33 b(attributes)h(and)f(their)
+g(new)g(v)-5 b(alues)33 b(are)f(sp)r(eci\014ed)h(via)g(a)g(c)n
+(haracter)e(string,)j(whic)n(h)f(should)g(con)n(tain)f(a)227
+4025 y(comma-separated)26 b(list)h(of)h(the)g(form:)227
+4148 y Ft(")p Fj(attribute)p Ft(_)p Fj(1)f(=)g(v)-5 b(alue)p
Ft(_)p Fj(1,)27 b(attribute)p Ft(_)p Fj(2)f(=)i(v)-5
-b(alue)p Ft(_)p Fj(2,)26 b(...)37 b Ft(")227 1128 y Fj(where)22
+b(alue)p Ft(_)p Fj(2,)26 b(...)37 b Ft(")227 4271 y Fj(where)22
b Ft(")p Fj(attribute)p Ft(_)p Fj(n)p Ft(")g Fj(sp)r(eci\014es)g(an)h
(attribute)f(name,)i(and)e(the)h(v)-5 b(alue)23 b(to)f(the)h(righ)n(t)f
(of)h(eac)n(h)e Ft(")p Fj(=)p Ft(")h Fj(sign)g(should)227
-1227 y(b)r(e)36 b(a)f(suitable)h(textual)f(represen)n(tation)f(of)h
+4371 y(b)r(e)36 b(a)f(suitable)h(textual)f(represen)n(tation)f(of)h
(the)h(v)-5 b(alue)35 b(to)h(b)r(e)g(assigned.)59 b(This)35
b(v)-5 b(alue)36 b(will)f(b)r(e)h(in)n(terpreted)227
-1327 y(according)26 b(to)i(the)g(attribute's)f(data)g(t)n(yp)r(e.)0
-1480 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_SET\()e(THIS,)h
-(SETTINGS,)f(STATUS)h(\))0 1633 y Fc(Argumen)m(ts:)259
-1773 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1873
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5 b(ject.)259 2008
+4471 y(according)26 b(to)i(the)g(attribute's)f(data)g(t)n(yp)r(e.)0
+4618 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_SET\()e(THIS,)h
+(SETTINGS,)f(STATUS)h(\))0 4765 y Fc(Argumen)m(ts:)259
+4899 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 4999
+y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5 b(ject.)259 5129
y Fc(SETTINGS)33 b(=)f(CHARA)m(CTER)f Fi(\003)h Fc(\()f
-Fi(\003)h Fc(\))g(\(Giv)m(en\))427 2107 y Fj(A)j(c)n(haracter)e(string)
+Fi(\003)h Fc(\))g(\(Giv)m(en\))427 5229 y Fj(A)j(c)n(haracter)e(string)
h(con)n(taining)g(a)h(comma-separated)d(list)j(of)g(attribute)g
-(settings)g(in)g(the)g(form)g(de-)427 2207 y(scrib)r(ed)28
-b(ab)r(o)n(v)n(e.)259 2341 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f
-(\(Giv)m(en)h(and)g(Returned\))427 2441 y Fj(The)c(global)e(status.)0
-2607 y Fc(Class)31 b(Applicabilit)m(y:)259 2747 y(Ob)5
-b(ject)427 2846 y Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5
-b(jects.)0 3012 y Fc(Examples:)227 3153 y Fy(CALL)47
+(settings)g(in)g(the)g(form)g(de-)427 5329 y(scrib)r(ed)28
+b(ab)r(o)n(v)n(e.)259 5459 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f
+(\(Giv)m(en)h(and)g(Returned\))427 5559 y Fj(The)c(global)e(status.)0
+5718 y Fc(Class)31 b(Applicabilit)m(y:)p eop end
+%%Page: 357 367
+TeXDict begin 357 366 bop 3643 52 a FG(357)259 351 y
+Fc(Ob)5 b(ject)427 451 y Fj(This)28 b(routine)f(applies)g(to)h(all)f
+(Ob)5 b(jects.)0 615 y Fc(Examples:)227 755 y Fy(CALL)47
b(AST)p Ft(_)p Fy(SET\()e(MAP,)i('Report)f(=)h(1,)g(Zoom)g(=)g(25.0',)g
-(STATUS)f(\))427 3252 y Fj(Sets)28 b(the)g(Rep)r(ort)f(attribute)h(for)
-f(Ob)5 b(ject)28 b(MAP)f(to)h(the)g(v)-5 b(alue)27 b(1)g(and)h(the)g
-(Zo)r(om)f(attribute)g(to)h(25.0.)227 3391 y Fy(CALL)47
-b(AST)p Ft(_)p Fy(SET\()e(FRAME,)h('Label\()g(1)i(\))f(=Offset)f(from)h
-(cluster)e(axis',)h(STATUS)h(\))427 3486 y Fj(Sets)28
+(STATUS)f(\))427 854 y Fj(Sets)28 b(the)g(Rep)r(ort)f(attribute)h(for)f
+(Ob)5 b(ject)28 b(MAP)f(to)h(the)g(v)-5 b(alue)27 b(1)g(and)h(the)g(Zo)
+r(om)f(attribute)g(to)h(25.0.)227 992 y Fy(CALL)47 b(AST)p
+Ft(_)p Fy(SET\()e(FRAME,)h('Label\()g(1)i(\))f(=Offset)f(from)h
+(cluster)e(axis',)h(STATUS)h(\))427 1088 y Fj(Sets)28
b(the)g(Lab)r(el\(1\))g(attribute)f(for)g(Ob)5 b(ject)28
-b(FRAME)g(to)f(a)g(suitable)h(string.)0 3652 y Fc(Notes:)340
-3938 y Fi(\017)45 b Fj(A)n(ttribute)28 b(names)g(are)e(not)i(case)f
+b(FRAME)g(to)f(a)g(suitable)h(string.)0 1252 y Fc(Notes:)340
+1538 y Fi(\017)45 b Fj(A)n(ttribute)28 b(names)g(are)e(not)i(case)f
(sensitiv)n(e)g(and)g(ma)n(y)g(b)r(e)h(surrounded)e(b)n(y)i(white)g
-(space.)340 4073 y Fi(\017)45 b Fj(White)33 b(space)e(ma)n(y)f(also)h
+(space.)340 1672 y Fi(\017)45 b Fj(White)33 b(space)e(ma)n(y)f(also)h
(surround)g(attribute)g(v)-5 b(alues,)33 b(where)e(it)h(will)g
-(generally)e(b)r(e)i(ignored)e(\(except)427 4172 y(for)24
+(generally)e(b)r(e)i(ignored)e(\(except)427 1771 y(for)24
b(string-v)-5 b(alued)23 b(attributes)i(where)e(it)i(is)f(signi\014can)
n(t)g(and)g(forms)g(part)f(of)i(the)f(v)-5 b(alue)25
-b(to)f(b)r(e)g(assigned\).)340 4307 y Fi(\017)45 b Fj(T)-7
+b(to)f(b)r(e)g(assigned\).)340 1905 y Fi(\017)45 b Fj(T)-7
b(o)31 b(include)h(a)f(literal)g(comma)g(in)h(the)g(v)-5
b(alue)31 b(assigned)g(to)g(an)g(attribute,)i(the)f(whole)f(attribute)h
-(v)-5 b(alue)427 4407 y(should)28 b(b)r(e)g(enclosed)f(in)g(quotation)g
-(mark)n(es.)340 4541 y Fi(\017)45 b Fj(An)28 b(error)e(will)i(result)f
+(v)-5 b(alue)427 2005 y(should)28 b(b)r(e)g(enclosed)f(in)g(quotation)g
+(mark)n(es.)340 2139 y Fi(\017)45 b Fj(An)28 b(error)e(will)i(result)f
(if)h(an)g(attempt)g(is)f(made)h(to)f(set)h(a)f(v)-5
-b(alue)27 b(for)g(a)h(read-only)e(attribute.)p 0 4744
-V 0 4875 a FA(AST)p Fe(_)p FA(SET)p Fb(<)p FA(X)p Fb(>)1158
-4876 y Fd(Set)39 b(an)f(attribute)f(v)-7 b(alue)38 b(for)g(an)1716
-4976 y(Ob)7 b(ject)2908 4875 y FA(AST)p Fe(_)p FA(SET)p
-Fb(<)p FA(X)p Fb(>)0 5168 y Fc(Description:)44 b Fj(This)29
-b(is)g(a)g(family)g(of)g(routines)f(whic)n(h)h(set)g(a)g(sp)r
-(eci\014ed)g(attribute)g(v)-5 b(alue)29 b(for)g(an)f(Ob)5
-b(ject)29 b(using)g(one)227 5268 y(of)g(sev)n(eral)f(di\013eren)n(t)h
+b(alue)27 b(for)g(a)h(read-only)e(attribute.)p 0 2341
+3780 12 v 0 2472 a FA(AST)p Fe(_)p FA(SET)p Fb(<)p FA(X)p
+Fb(>)1158 2473 y Fd(Set)39 b(an)f(attribute)f(v)-7 b(alue)38
+b(for)g(an)1716 2572 y(Ob)7 b(ject)2908 2472 y FA(AST)p
+Fe(_)p FA(SET)p Fb(<)p FA(X)p Fb(>)0 2764 y Fc(Description:)44
+b Fj(This)29 b(is)g(a)g(family)g(of)g(routines)f(whic)n(h)h(set)g(a)g
+(sp)r(eci\014ed)g(attribute)g(v)-5 b(alue)29 b(for)g(an)f(Ob)5
+b(ject)29 b(using)g(one)227 2864 y(of)g(sev)n(eral)f(di\013eren)n(t)h
(data)g(t)n(yp)r(es.)41 b(The)30 b(t)n(yp)r(e)f(is)g(selected)g(b)n(y)g
(replacing)f Fl(<)p Fj(X)p Fl(>)h Fj(in)g(the)h(routine)f(name)g(b)n(y)
-g(C,)227 5367 y(D,)34 b(I,)g(L)f(or)f(R,)i(to)f(supply)h(a)f(v)-5
+g(C,)227 2963 y(D,)34 b(I,)g(L)f(or)f(R,)i(to)f(supply)h(a)f(v)-5
b(alue)33 b(in)g(Character,)h(Double)f(precision,)h(In)n(teger,)g
-(Logical)e(or)g(Real)h(format,)227 5467 y(resp)r(ectiv)n(ely)-7
-b(.)227 5593 y(If)36 b(p)r(ossible,)h(the)f(v)-5 b(alue)36
+(Logical)e(or)g(Real)h(format,)227 3063 y(resp)r(ectiv)n(ely)-7
+b(.)227 3189 y(If)36 b(p)r(ossible,)h(the)f(v)-5 b(alue)36
b(y)n(ou)e(supply)i(is)f(con)n(v)n(erted)f(to)i(the)f(t)n(yp)r(e)h(of)g
(the)f(attribute.)61 b(If)36 b(con)n(v)n(ersion)d(is)j(not)227
-5693 y(p)r(ossible,)28 b(an)f(error)f(will)h(result.)p
-eop end
-%%Page: 355 365
-TeXDict begin 355 364 bop 3643 52 a FG(355)0 351 y Fc(In)m(v)m(o)s
-(cation:)123 b Ft(CALL)42 b(AST_SET)p Fl(<)p Ft(X)p Fl(>)p
-Ft(\()d(THIS,)i(ATTRIB,)g(VALUE,)g(STATUS)g(\))0 499
-y Fc(Argumen)m(ts:)259 634 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
-733 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5 b(ject.)259
-864 y Fc(A)-8 b(TTRIB)33 b(=)f(CHARA)m(CTER)f Fi(\003)h
-Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427 964 y Fj(A)c(c)n(haracter)e
-(string)h(con)n(taining)f(the)i(name)g(of)f(the)h(attribute)g(whose)f
-(v)-5 b(alue)27 b(is)h(to)f(b)r(e)h(set.)259 1095 y Fc(V)-11
-b(ALUE)33 b(=)f Fl(<)p Fc(X)p Fl(>)p Fc(t)m(yp)s(e)g(\(Giv)m(en\))427
-1195 y Fj(The)c(v)-5 b(alue)27 b(to)h(b)r(e)g(set)f(for)h(the)g
-(attribute,)f(in)h(the)g(data)f(t)n(yp)r(e)h(corresp)r(onding)e(to)h
-Fl(<)p Fj(X)p Fl(>)p Fj(.)259 1326 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 1425
-y Fj(The)c(global)e(status.)0 1585 y Fc(Class)31 b(Applicabilit)m(y:)
-259 1720 y(Ob)5 b(ject)427 1820 y Fj(These)28 b(routines)f(apply)g(to)g
-(all)h(Ob)5 b(jects.)0 1980 y Fc(Examples:)227 2119 y
-Fy(CALL)47 b(AST)p Ft(_)p Fy(SETC\()e(PLOT,)h('Title',)g(CVALUE,)g
-(STATUS)g(\))427 2214 y Fj(Sets)38 b(the)h(Title)f(attribute)h(v)-5
-b(alue)38 b(for)f(Ob)5 b(ject)38 b(PLOT)f(to)h(the)h(con)n(ten)n(ts)e
-(of)h(the)h(c)n(haracter)d(v)-5 b(ariable)427 2314 y(CV)c(ALUE.)227
-2449 y Fy(CALL)47 b(AST)p Ft(_)p Fy(SETL\()e(FRAME,)h('Preserve',)f
-(.TRUE.,)h(STATUS)g(\);)427 2545 y Fj(Sets)28 b(the)g(Preserv)n(e)d
+3288 y(p)r(ossible,)28 b(an)f(error)f(will)h(result.)0
+3440 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_SET)p
+Fl(<)p Ft(X)p Fl(>)p Ft(\()d(THIS,)i(ATTRIB,)g(VALUE,)g(STATUS)g(\))0
+3592 y Fc(Argumen)m(ts:)259 3731 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 3831 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5
+b(ject.)259 3965 y Fc(A)-8 b(TTRIB)33 b(=)f(CHARA)m(CTER)f
+Fi(\003)h Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427
+4065 y Fj(A)c(c)n(haracter)e(string)h(con)n(taining)f(the)i(name)g(of)f
+(the)h(attribute)g(whose)f(v)-5 b(alue)27 b(is)h(to)f(b)r(e)h(set.)259
+4199 y Fc(V)-11 b(ALUE)33 b(=)f Fl(<)p Fc(X)p Fl(>)p
+Fc(t)m(yp)s(e)g(\(Giv)m(en\))427 4299 y Fj(The)c(v)-5
+b(alue)27 b(to)h(b)r(e)g(set)f(for)h(the)g(attribute,)f(in)h(the)g
+(data)f(t)n(yp)r(e)h(corresp)r(onding)e(to)h Fl(<)p Fj(X)p
+Fl(>)p Fj(.)259 4433 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m
+(en)h(and)g(Returned\))427 4532 y Fj(The)c(global)e(status.)0
+4697 y Fc(Class)31 b(Applicabilit)m(y:)259 4836 y(Ob)5
+b(ject)427 4936 y Fj(These)28 b(routines)f(apply)g(to)g(all)h(Ob)5
+b(jects.)0 5100 y Fc(Examples:)227 5243 y Fy(CALL)47
+b(AST)p Ft(_)p Fy(SETC\()e(PLOT,)h('Title',)g(CVALUE,)g(STATUS)g(\))427
+5339 y Fj(Sets)38 b(the)h(Title)f(attribute)h(v)-5 b(alue)38
+b(for)f(Ob)5 b(ject)38 b(PLOT)f(to)h(the)h(con)n(ten)n(ts)e(of)h(the)h
+(c)n(haracter)d(v)-5 b(ariable)427 5438 y(CV)c(ALUE.)227
+5577 y Fy(CALL)47 b(AST)p Ft(_)p Fy(SETL\()e(FRAME,)h('Preserve',)f
+(.TRUE.,)h(STATUS)g(\);)427 5672 y Fj(Sets)28 b(the)g(Preserv)n(e)d
(attribute)j(v)-5 b(alue)27 b(for)g(Ob)5 b(ject)28 b(FRAME)g(to)f(1)g
-(\(true\).)0 2705 y Fc(Notes:)340 2985 y Fi(\017)45 b
-Fj(A)n(ttribute)28 b(names)g(are)e(not)i(case)f(sensitiv)n(e)g(and)g
-(ma)n(y)g(b)r(e)h(surrounded)e(b)n(y)i(white)g(space.)340
-3117 y Fi(\017)45 b Fj(The)34 b(logical)f(v)-5 b(alue)34
-b(.F)-9 b(ALSE.)34 b(will)h(translate)e(to)h(a)f(n)n(umerical)h
-(attribute)g(v)-5 b(alue)34 b(of)g(zero)f(and)h(logical)427
-3216 y(.TR)n(UE.)28 b(will)f(translate)g(to)h(one.)340
-3347 y Fi(\017)45 b Fj(An)28 b(error)e(will)i(result)f(if)h(an)g
+(\(true\).)p eop end
+%%Page: 358 368
+TeXDict begin 358 367 bop 0 52 a FG(358)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Notes:)340
+645 y Fi(\017)45 b Fj(A)n(ttribute)28 b(names)g(are)e(not)i(case)f
+(sensitiv)n(e)g(and)g(ma)n(y)g(b)r(e)h(surrounded)e(b)n(y)i(white)g
+(space.)340 784 y Fi(\017)45 b Fj(The)34 b(logical)f(v)-5
+b(alue)34 b(.F)-9 b(ALSE.)34 b(will)h(translate)e(to)h(a)f(n)n
+(umerical)h(attribute)g(v)-5 b(alue)34 b(of)g(zero)f(and)h(logical)427
+884 y(.TR)n(UE.)28 b(will)f(translate)g(to)h(one.)340
+1022 y Fi(\017)45 b Fj(An)28 b(error)e(will)i(result)f(if)h(an)g
(attempt)g(is)f(made)h(to)f(set)h(a)f(v)-5 b(alue)27
-b(for)g(a)h(read-only)e(attribute.)p 0 3543 3780 12 v
-0 3674 a FA(AST)p Fe(_)p FA(SET)-11 b(A)l(CTIVEUNIT)1706
-3675 y Fd(Sp)s(ecify)1687 3789 y(ho)m(w)37 b(the)1774
-3889 y(Unit)1662 3988 y(attribute)1644 4088 y(should)h(b)s(e)1776
-4188 y(used)2322 3674 y FA(AST)p Fe(_)p FA(SET)-11 b(A)l(CTIVEUNIT)0
-4350 y Fc(Description:)44 b Fj(This)25 b(routine)f(sets)g(the)h(curren)
+b(for)g(a)h(read-only)e(attribute.)p 0 1233 3780 12 v
+0 1364 a FA(AST)p Fe(_)p FA(SET)-11 b(A)l(CTIVEUNIT)1706
+1365 y Fd(Sp)s(ecify)1687 1479 y(ho)m(w)37 b(the)1774
+1579 y(Unit)1662 1679 y(attribute)1644 1778 y(should)h(b)s(e)1776
+1878 y(used)2322 1364 y FA(AST)p Fe(_)p FA(SET)-11 b(A)l(CTIVEUNIT)0
+2055 y Fc(Description:)44 b Fj(This)25 b(routine)f(sets)g(the)h(curren)
n(t)f(v)-5 b(alue)24 b(of)h(the)g(Activ)n(eUnit)g(\015ag)f(for)g(a)g(F)
--7 b(rame,)25 b(whic)n(h)f(con)n(trols)f(ho)n(w)227 4449
+-7 b(rame,)25 b(whic)n(h)f(con)n(trols)f(ho)n(w)227 2155
y(the)h(F)-7 b(rame)22 b(b)r(eha)n(v)n(es)g(when)i(it)f(is)g(used)g
(\(b)n(y)g(AST)p Ft(_)p Fj(FINDFRAME)h(or)f(AST)p Ft(_)p
-Fj(CONVER)-7 b(T\))23 b(to)g(matc)n(h)g(another)227 4549
+Fj(CONVER)-7 b(T\))23 b(to)g(matc)n(h)g(another)227 2254
y(F)-7 b(rame.)35 b(If)23 b(the)g(Activ)n(eUnit)g(\015ag)f(is)g(set)h
(in)f(b)r(oth)h(template)g(and)g(target)e(F)-7 b(rames)22
-b(then)h(the)g(returned)f(Mapping)227 4649 y(tak)n(es)j(in)n(to)g
+b(then)h(the)g(returned)f(Mapping)227 2354 y(tak)n(es)j(in)n(to)g
(accoun)n(t)g(an)n(y)f(di\013erences)h(in)h(axis)f(units.)36
b(The)26 b(default)g(v)-5 b(alue)25 b(for)g(simple)h(F)-7
-b(rames)24 b(is)i(zero,)f(whic)n(h)227 4748 y(preserv)n(es)h(the)i(b)r
+b(rames)24 b(is)i(zero,)f(whic)n(h)227 2453 y(preserv)n(es)h(the)i(b)r
(eha)n(viour)e(of)i(v)n(ersions)d(of)j(AST)g(prior)e(to)i(v)n(ersion)e
-(2.0.)227 4872 y(If)c(the)f(Activ)n(eUnit)h(\015ag)e(of)i(either)f(F)-7
+(2.0.)227 2584 y(If)c(the)f(Activ)n(eUnit)h(\015ag)e(of)i(either)f(F)-7
b(rame)20 b(is)h(.F)-9 b(ALSE.,)22 b(then)g(the)g(Mapping)e(will)i
-(ignore)d(an)n(y)i(di\013erence)g(in)g(the)227 4972 y(Unit)31
+(ignore)d(an)n(y)i(di\013erence)g(in)g(the)227 2683 y(Unit)31
b(attributes)f(of)g(corresp)r(onding)e(template)j(and)f(target)f(axes.)
44 b(In)30 b(this)g(mo)r(de,)h(the)g(Unit)g(attributes)f(are)227
-5071 y(purely)23 b(descriptiv)n(e)f(commen)n(tary)g(for)h(the)h(b)r
+2783 y(purely)23 b(descriptiv)n(e)f(commen)n(tary)g(for)h(the)h(b)r
(ene\014t)g(of)f(h)n(uman)g(readers)e(and)i(do)g(not)g(in\015uence)h
-(the)f(Mappings)227 5171 y(b)r(et)n(w)n(een)k(F)-7 b(rames.)36
+(the)f(Mappings)227 2883 y(b)r(et)n(w)n(een)k(F)-7 b(rames.)36
b(This)27 b(is)f(the)i(b)r(eha)n(viour)d(whic)n(h)i(all)g(F)-7
b(rames)26 b(had)g(in)h(older)f(v)n(ersion)g(of)h(AST,)g(prior)f(to)g
-(the)227 5270 y(in)n(tro)r(duction)i(of)f(this)h(attribute.)227
-5394 y(If)j(the)h(Activ)n(eUnit)f(\015ag)f(of)h(b)r(oth)g(F)-7
+(the)227 2982 y(in)n(tro)r(duction)i(of)f(this)h(attribute.)227
+3113 y(If)j(the)h(Activ)n(eUnit)f(\015ag)f(of)h(b)r(oth)g(F)-7
b(rames)30 b(is)g(.TR)n(UE.,)i(then)f(the)g(Mapping)f(from)h(template)g
-(to)g(target)e(will)227 5494 y(tak)n(e)35 b(accoun)n(t)g(of)g(an)n(y)g
+(to)g(target)e(will)227 3212 y(tak)n(e)35 b(accoun)n(t)g(of)g(an)n(y)g
(di\013erence)h(in)g(the)g(axis)f(Unit)h(attributes,)i(where-ev)n(er)33
b(p)r(ossible.)61 b(F)-7 b(or)35 b(instance,)i(if)227
-5593 y(corresp)r(onding)31 b(target)g(and)h(template)h(axes)e(ha)n(v)n
+3312 y(corresp)r(onding)31 b(target)g(and)h(template)h(axes)e(ha)n(v)n
(e)g(Unit)i(strings)f(of)g Ft(")p Fj(km)p Ft(")f Fj(and)h
Ft(")p Fj(m)p Ft(")p Fj(,)h(then)g(the)g(F)-7 b(rameSet)227
-5693 y(class)35 b(will)i(use)f(a)f(Zo)r(omMap)g(to)h(connect)g(them)h
+3411 y(class)35 b(will)i(use)f(a)f(Zo)r(omMap)g(to)h(connect)g(them)h
(whic)n(h)f(in)n(tro)r(duces)f(a)h(scaling)f(of)h(1000.)61
-b(If)36 b(no)g(Mapping)p eop end
-%%Page: 356 366
-TeXDict begin 356 365 bop 0 52 a FG(356)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)227 351 y Fj(can)g(b)r(e)g(found)h
-(b)r(et)n(w)n(een)f(the)g(corresp)r(onding)e(units)j(string,)f(then)g
-(an)g(error)e(is)i(rep)r(orted.)47 b(In)31 b(this)g(mo)r(de,)h(it)227
-451 y(is)f(assumed)g(that)g(v)-5 b(alues)31 b(of)g(the)h(Unit)g
+b(If)36 b(no)g(Mapping)227 3511 y(can)31 b(b)r(e)g(found)h(b)r(et)n(w)n
+(een)f(the)g(corresp)r(onding)e(units)j(string,)f(then)g(an)g(error)e
+(is)i(rep)r(orted.)47 b(In)31 b(this)g(mo)r(de,)h(it)227
+3611 y(is)f(assumed)g(that)g(v)-5 b(alues)31 b(of)g(the)h(Unit)g
(attribute)f(conform)g(to)g(the)h(syn)n(tax)e(for)g(units)i(strings)e
-(describ)r(ed)h(in)227 551 y(the)g(FITS)g(W)n(CS)f(P)n(ap)r(er)f(I)i
+(describ)r(ed)h(in)227 3710 y(the)g(FITS)g(W)n(CS)f(P)n(ap)r(er)f(I)i
Ft(")p Fj(Represen)n(tations)e(of)h(w)n(orld)f(co)r(ordinates)g(in)i
-(FITS)p Ft(")f Fj(\(Greisen)g(&)h(Calabretta\).)227 650
+(FITS)p Ft(")f Fj(\(Greisen)g(&)h(Calabretta\).)227 3810
y(P)n(articularly)-7 b(,)30 b(an)n(y)h(of)g(the)h(named)f(unit)h(sym)n
(b)r(ols,)g(functions,)h(op)r(erators)c(or)i(standard)f(m)n(ultiplier)h
-(pre\014xes)227 750 y(listed)c(within)g(that)f(pap)r(er)g(can)g(b)r(e)g
-(used)h(within)g(a)e(units)i(string.)36 b(A)26 b(units)h(string)f(ma)n
-(y)f(con)n(tain)h(sym)n(b)r(ols)f(for)227 849 y(unit)31
+(pre\014xes)227 3910 y(listed)c(within)g(that)f(pap)r(er)g(can)g(b)r(e)
+g(used)h(within)g(a)e(units)i(string.)36 b(A)26 b(units)h(string)f(ma)n
+(y)f(con)n(tain)h(sym)n(b)r(ols)f(for)227 4009 y(unit)31
b(whic)n(h)g(are)e(not)i(listed)g(in)f(the)h(FITS)g(pap)r(er,)g(but)g
(transformation)e(to)h(an)n(y)g(other)g(units)h(will)g(then)g(not)227
-949 y(b)r(e)f(p)r(ossible)f(\(except)h(to)f(units)h(whic)n(h)f(dep)r
+4109 y(b)r(e)f(p)r(ossible)f(\(except)h(to)f(units)h(whic)n(h)f(dep)r
(end)h(only)f(on)g(the)h(same)f(unkno)n(wn)g(units)h(-)f(th)n(us)g
-Ft(")p Fj(\015ops)p Ft(")f Fj(can)h(b)r(e)227 1049 y(transformed)e(to)g
+Ft(")p Fj(\015ops)p Ft(")f Fj(can)h(b)r(e)227 4208 y(transformed)e(to)g
Ft(")p Fj(M\015ops)p Ft(")g Fj(ev)n(en)g(though)g Ft(")p
Fj(\015ops)p Ft(")f Fj(is)i(not)g(a)f(standard)f(FITS)i(unit)h(sym)n(b)
-r(ol\).)227 1173 y(A)c(range)e(of)h(common)g(non-standard)f(v)-5
+r(ol\).)227 4339 y(A)c(range)e(of)h(common)g(non-standard)f(v)-5
b(ariations)23 b(of)i(unit)g(names)f(and)g(m)n(ultiplier)h(pre\014xes)e
-(are)h(also)f(allo)n(w)n(ed,)227 1273 y(suc)n(h)28 b(as)f(adding)g(an)g
+(are)h(also)f(allo)n(w)n(ed,)227 4438 y(suc)n(h)28 b(as)f(adding)g(an)g
Ft(")p Fj(s)p Ft(")g Fj(to)h(the)g(end)g(of)f(Angstrom,)g(using)h(a)f
(lo)n(w)n(er)f(case)h Ft(")p Fj(a)p Ft(")f Fj(at)i(the)g(start)f(of)h
-Ft(")p Fj(angstrom)p Ft(")p Fj(,)227 1373 y Ft(")p Fj(micron)p
+Ft(")p Fj(angstrom)p Ft(")p Fj(,)227 4538 y Ft(")p Fj(micron)p
Ft(")e Fj(instead)i(of)f Ft(")p Fj(um)p Ft(")p Fj(,)h
Ft(")p Fj(sec)p Ft(")e Fj(instead)h(of)h Ft(")p Fj(s)p
-Ft(")p Fj(,)f(etc.)227 1497 y(If)c(the)f(Activ)n(eUnit)h(\015ag)f(is)g
+Ft(")p Fj(,)f(etc.)227 4668 y(If)c(the)f(Activ)n(eUnit)h(\015ag)f(is)g
(.TR)n(UE.,)h(setting)f(a)g(new)g(Unit)h(v)-5 b(alue)22
b(for)g(an)f(axis)h(ma)n(y)f(also)g(c)n(hange)g(its)i(Lab)r(el)f(and)
-227 1597 y(Sym)n(b)r(ol)30 b(attributes.)45 b(F)-7 b(or)30
+227 4768 y(Sym)n(b)r(ol)30 b(attributes.)45 b(F)-7 b(or)30
b(instance,)g(if)h(an)f(axis)f(has)h(Unit)h Ft(")p Fj(Hz)p
Ft(")f Fj(and)g(Lab)r(el)g Ft(")p Fj(frequency)p Ft(")p
-Fj(,)f(then)i(c)n(hanging)227 1697 y(its)j(Unit)g(to)g
+Fj(,)f(then)i(c)n(hanging)227 4868 y(its)j(Unit)g(to)g
Ft(")p Fj(log\(Hz\))p Ft(")e Fj(will)i(c)n(hange)e(its)i(Lab)r(el)g(to)
f Ft(")p Fj(log\()f(frequency)i(\))p Ft(")p Fj(.)54 b(In)34
-b(addition,)h(the)f(Axis)f(F)-7 b(ormat)227 1796 y(attribute)28
+b(addition,)h(the)f(Axis)f(F)-7 b(ormat)227 4967 y(attribute)28
b(will)g(b)r(e)g(cleared)e(when-ev)n(er)h(a)g(new)h(v)-5
b(alue)27 b(is)h(assigned)e(to)h(the)h(Unit)h(attribute.)227
-1921 y(Note,)h(if)f(a)g(.TR)n(UE.)g(v)-5 b(alue)29 b(is)g(set)g(for)f
+5098 y(Note,)h(if)f(a)g(.TR)n(UE.)g(v)-5 b(alue)29 b(is)g(set)g(for)f
(the)i(Activ)n(eUnit)f(\015ag,)g(then)g(c)n(hanging)f(a)h(Unit)h(v)-5
-b(alue)29 b(for)f(the)h(curren)n(t)227 2021 y(F)-7 b(rame)29
+b(alue)29 b(for)f(the)h(curren)n(t)227 5197 y(F)-7 b(rame)29
b(within)h(a)f(F)-7 b(rameSet)29 b(will)h(result)f(in)h(the)f(F)-7
b(rame)29 b(b)r(eing)h(re-mapp)r(ed)e(\(that)i(is,)g(the)g(Mappings)f
-(whic)n(h)227 2120 y(de\014ne)d(the)f(relationships)f(b)r(et)n(w)n(een)
+(whic)n(h)227 5297 y(de\014ne)d(the)f(relationships)f(b)r(et)n(w)n(een)
i(F)-7 b(rames)24 b(within)i(the)f(F)-7 b(rameSet)25
b(will)h(b)r(e)f(mo)r(di\014ed)h(to)f(tak)n(e)g(in)n(to)f(accoun)n(t)
-227 2220 y(the)k(c)n(hange)f(in)h(Units\).)0 2370 y Fc(In)m(v)m(o)s
+227 5396 y(the)k(c)n(hange)f(in)h(Units\).)0 5557 y Fc(In)m(v)m(o)s
(cation:)123 b Ft(CALL)42 b(AST_SETACTIVEUN)o(IT\()37
-b(THIS,)k(VALUE,)g(STATUS)h(\))0 2519 y Fc(Argumen)m(ts:)259
-2656 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 2756
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7 b(rame.)259 2889
-y Fc(V)c(ALUE)33 b(=)f(LOGICAL)h(\(Giv)m(en\))427 2989
-y Fj(The)28 b(new)g(v)-5 b(alue)27 b(to)h(use.)259 3122
-y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 3221 y Fj(The)c(global)e(status.)0 3383 y Fc(Class)31
-b(Applicabilit)m(y:)259 3520 y(SkyF)-8 b(rame)427 3620
-y Fj(The)25 b(Activ)n(eUnit)h(\015ag)e(for)g(a)h(SkyF)-7
-b(rame)24 b(is)g(alw)n(a)n(ys)f(.F)-9 b(ALSE.)25 b(\(an)n(y)f(v)-5
-b(alue)25 b(supplied)g(using)g(this)g(routine)427 3719
-y(is)j(ignored\).)259 3853 y Fc(Sp)s(ecF)-8 b(rame)427
-3952 y Fj(The)24 b(Activ)n(eUnit)h(\015ag)f(for)f(a)h(Sp)r(ecF)-7
+b(THIS,)k(VALUE,)g(STATUS)h(\))0 5718 y Fc(Argumen)m(ts:)p
+eop end
+%%Page: 359 369
+TeXDict begin 359 368 bop 3643 52 a FG(359)259 351 y
+Fc(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(F)-7 b(rame.)259 583 y Fc(V)c(ALUE)33 b(=)f(LOGICAL)h
+(\(Giv)m(en\))427 683 y Fj(The)28 b(new)g(v)-5 b(alue)27
+b(to)h(use.)259 815 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)
+h(and)g(Returned\))427 915 y Fj(The)c(global)e(status.)0
+1077 y Fc(Class)31 b(Applicabilit)m(y:)259 1213 y(SkyF)-8
+b(rame)427 1312 y Fj(The)25 b(Activ)n(eUnit)h(\015ag)e(for)g(a)h(SkyF)
+-7 b(rame)24 b(is)g(alw)n(a)n(ys)f(.F)-9 b(ALSE.)25 b(\(an)n(y)f(v)-5
+b(alue)25 b(supplied)g(using)g(this)g(routine)427 1412
+y(is)j(ignored\).)259 1544 y Fc(Sp)s(ecF)-8 b(rame)427
+1644 y Fj(The)24 b(Activ)n(eUnit)h(\015ag)f(for)f(a)h(Sp)r(ecF)-7
b(rame)24 b(is)g(alw)n(a)n(ys)e(.TR)n(UE.)i(\(an)n(y)f(v)-5
-b(alue)24 b(supplied)h(using)f(this)g(routine)427 4052
-y(is)k(ignored\).)259 4185 y Fc(FluxF)-8 b(rame)427 4284
+b(alue)24 b(supplied)h(using)f(this)g(routine)427 1743
+y(is)k(ignored\).)259 1876 y Fc(FluxF)-8 b(rame)427 1976
y Fj(The)25 b(Activ)n(eUnit)f(\015ag)g(for)g(a)f(FluxF)-7
b(rame)24 b(is)g(alw)n(a)n(ys)e(.TR)n(UE.)i(\(an)n(y)g(v)-5
-b(alue)24 b(supplied)h(using)f(this)g(routine)427 4384
-y(is)k(ignored\).)259 4517 y Fc(CmpF)-8 b(rame)427 4617
+b(alue)24 b(supplied)h(using)f(this)g(routine)427 2075
+y(is)k(ignored\).)259 2208 y Fc(CmpF)-8 b(rame)427 2307
y Fj(The)26 b(default)g(Activ)n(eUnit)g(\015ag)e(for)h(a)g(CmpF)-7
b(rame)25 b(is)h(.TR)n(UE.)f(if)h(b)r(oth)g(of)f(the)h(comp)r(onen)n(t)
-f(F)-7 b(rames)25 b(are)427 4716 y(using)j(activ)n(e)f(units,)i(and)f
+f(F)-7 b(rames)25 b(are)427 2407 y(using)j(activ)n(e)f(units,)i(and)f
(.F)-9 b(ALSE.)28 b(otherwise.)38 b(When)28 b(a)g(new)g(v)-5
b(alue)28 b(is)g(set)g(for)g(the)g(Activ)n(eUnit)h(\015ag,)427
-4816 y(the)e(\015ag)e(v)-5 b(alue)26 b(is)g(propagated)e(to)i(the)h
+2506 y(the)e(\015ag)e(v)-5 b(alue)26 b(is)g(propagated)e(to)i(the)h
(comp)r(onen)n(t)e(F)-7 b(rames.)36 b(This)26 b(c)n(hange)f(will)h(b)r
-(e)h(re\015ected)e(through)427 4916 y(all)j(references)e(to)h(the)h
+(e)h(re\015ected)e(through)427 2606 y(all)j(references)e(to)h(the)h
(comp)r(onen)n(t)g(F)-7 b(rames,)27 b(not)g(just)h(those)g
-(encapsulated)f(within)h(the)g(CmpF)-7 b(rame.)259 5049
-y Fc(Region:)427 5148 y Fj(Regions)27 b(alw)n(a)n(ys)f(use)h(activ)n(e)
-g(units)h(if)g(p)r(ossible.)0 5310 y Fc(Notes:)340 5593
+(encapsulated)f(within)h(the)g(CmpF)-7 b(rame.)259 2739
+y Fc(Region:)427 2838 y Fj(Regions)27 b(alw)n(a)n(ys)f(use)h(activ)n(e)
+g(units)h(if)g(p)r(ossible.)0 3000 y Fc(Notes:)340 3282
y Fi(\017)45 b Fj(The)28 b(Activ)n(eUnit)g(\015ag)f(resem)n(bles)f(a)h
(F)-7 b(rame)27 b(attribute,)g(except)h(that)g(it)f(cannot)g(b)r(e)h
-(tested)g(or)f(cleared,)427 5693 y(and)h(it)g(cannot)f(b)r(e)h
+(tested)g(or)f(cleared,)427 3381 y(and)h(it)g(cannot)f(b)r(e)h
(accessed)e(using)h(the)h(generic)f(AST)p Ft(_)p Fj(GET)p
Fl(<)p Fj(X)p Fl(>)g Fj(and)g(AST)p Ft(_)p Fj(SET)p Fl(<)p
-Fj(X)p Fl(>)g Fj(routines.)p eop end
-%%Page: 357 367
-TeXDict begin 357 366 bop 3643 52 a FG(357)340 351 y
-Fi(\017)45 b Fj(The)33 b(AST)p Ft(_)p Fj(GET)-7 b(A)n(CTIVEUNIT)33
-b(routine)g(can)g(b)r(e)g(used)g(to)g(retriev)n(e)f(the)h(curren)n(t)f
-(v)-5 b(alue)33 b(of)g(the)h(Ac-)427 451 y(tiv)n(eUnit)28
-b(\015ag.)p 0 662 3780 12 v 0 792 a FA(AST)p Fe(_)p FA(SETFITS)p
-Fb(<)p FA(X)p Fb(>)1326 793 y Fd(Store)38 b(a)g(k)m(eyw)m(ord)e(v)-7
-b(alue)1536 908 y(in)38 b(a)h(FitsChan)2605 792 y FA(AST)p
-Fe(_)p FA(SETFITS)p Fb(<)p FA(X)p Fb(>)0 1085 y Fc(Description:)44
+Fj(X)p Fl(>)g Fj(routines.)340 3514 y Fi(\017)45 b Fj(The)33
+b(AST)p Ft(_)p Fj(GET)-7 b(A)n(CTIVEUNIT)33 b(routine)g(can)g(b)r(e)g
+(used)g(to)g(retriev)n(e)f(the)h(curren)n(t)f(v)-5 b(alue)33
+b(of)g(the)h(Ac-)427 3613 y(tiv)n(eUnit)28 b(\015ag.)p
+0 3812 3780 12 v 0 3943 a FA(AST)p Fe(_)p FA(SETFITS)p
+Fb(<)p FA(X)p Fb(>)1326 3944 y Fd(Store)38 b(a)g(k)m(eyw)m(ord)e(v)-7
+b(alue)1536 4058 y(in)38 b(a)h(FitsChan)2605 3943 y FA(AST)p
+Fe(_)p FA(SETFITS)p Fb(<)p FA(X)p Fb(>)0 4223 y Fc(Description:)44
b Fj(This)29 b(is)f(a)f(family)i(of)f(routines)g(whic)n(h)g(store)f(v)
-5 b(alues)28 b(for)f(named)i(k)n(eyw)n(ords)d(within)j(a)e(FitsChan)i
-(at)227 1185 y(the)i(curren)n(t)f(card)g(p)r(osition.)46
+(at)227 4323 y(the)i(curren)n(t)f(card)g(p)r(osition.)46
b(The)31 b(supplied)g(k)n(eyw)n(ord)d(v)-5 b(alue)31
b(can)f(either)h(o)n(v)n(er-write)d(an)i(existing)g(k)n(eyw)n(ord)227
-1284 y(v)-5 b(alue,)28 b(or)f(can)g(b)r(e)h(inserted)f(as)g(a)g(new)h
-(header)f(card)f(in)n(to)i(the)g(FitsChan.)227 1414 y(The)h(k)n(eyw)n
+4422 y(v)-5 b(alue,)28 b(or)f(can)g(b)r(e)h(inserted)f(as)g(a)g(new)h
+(header)f(card)f(in)n(to)i(the)g(FitsChan.)227 4547 y(The)h(k)n(eyw)n
(ord)e(data)h(t)n(yp)r(e)h(is)g(selected)g(b)n(y)f(replacing)g
Fl(<)p Fj(X)p Fl(>)g Fj(in)h(the)g(routine)f(name)h(b)n(y)f(one)h(of)g
-(the)g(follo)n(wing)227 1514 y(strings)e(represen)n(ting)f(the)i
-(recognised)e(FITS)i(data)227 1644 y(t)n(yp)r(es:)340
-1923 y Fi(\017)45 b Fj(CF)28 b(-)f(Complex)h(\015oating)e(p)r(oin)n(t)i
-(v)-5 b(alues.)340 2061 y Fi(\017)45 b Fj(CI)28 b(-)f(Complex)g(in)n
-(teger)g(v)-5 b(alues.)340 2200 y Fi(\017)45 b Fj(F)28
-b(-)f(Floating)g(p)r(oin)n(t)h(v)-5 b(alues.)340 2338
+(the)g(follo)n(wing)227 4646 y(strings)e(represen)n(ting)f(the)i
+(recognised)e(FITS)i(data)227 4770 y(t)n(yp)r(es:)340
+5031 y Fi(\017)45 b Fj(CF)28 b(-)f(Complex)h(\015oating)e(p)r(oin)n(t)i
+(v)-5 b(alues.)340 5163 y Fi(\017)45 b Fj(CI)28 b(-)f(Complex)g(in)n
+(teger)g(v)-5 b(alues.)340 5296 y Fi(\017)45 b Fj(F)28
+b(-)f(Floating)g(p)r(oin)n(t)h(v)-5 b(alues.)340 5428
y Fi(\017)45 b Fj(I)28 b(-)f(In)n(teger)g(v)-5 b(alues.)340
-2477 y Fi(\017)45 b Fj(L)28 b(-)f(Logical)f(\(i.e.)38
-b(b)r(o)r(olean\))27 b(v)-5 b(alues.)340 2615 y Fi(\017)45
-b Fj(S)28 b(-)f(String)h(v)-5 b(alues.)340 2754 y Fi(\017)45
+5561 y Fi(\017)45 b Fj(L)28 b(-)f(Logical)f(\(i.e.)38
+b(b)r(o)r(olean\))27 b(v)-5 b(alues.)340 5693 y Fi(\017)45
+b Fj(S)28 b(-)f(String)h(v)-5 b(alues.)p eop end
+%%Page: 360 370
+TeXDict begin 360 369 bop 0 52 a FG(360)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
b Fj(CN)32 b(-)g(A)g Ft(")p Fj(CONTINUE)p Ft(")e Fj(v)-5
b(alue,)33 b(these)e(are)g(treated)g(lik)n(e)g(string)g(v)-5
-b(alues,)33 b(but)f(are)f(enco)r(ded)g(without)427 2854
-y(an)d(equals)e(sign.)227 3027 y(The)i(data)f(t)n(yp)r(e)h(of)f(the)h
+b(alues,)33 b(but)f(are)f(enco)r(ded)g(without)427 451
+y(an)d(equals)e(sign.)227 613 y(The)i(data)f(t)n(yp)r(e)h(of)f(the)h
Ft(")p Fj(v)-5 b(alue)p Ft(")27 b Fj(parameter)f(dep)r(ends)i(on)f
-Fl(<)p Fj(X)p Fl(>)h Fj(as)e(follo)n(ws:)340 3305 y Fi(\017)45
+Fl(<)p Fj(X)p Fl(>)h Fj(as)e(follo)n(ws:)340 875 y Fi(\017)45
b Fj(CF)31 b(-)g(DOUBLE)f(PRECISION\(2\))g(\(a)g(2)h(elemen)n(t)g(arra)
n(y)d(holding)i(the)h(real)f(and)h(imaginary)e(parts)h(of)427
-3405 y(the)e(complex)f(v)-5 b(alue\).)340 3543 y Fi(\017)45
+975 y(the)e(complex)f(v)-5 b(alue\).)340 1108 y Fi(\017)45
b Fj(CI)32 b(-)f(INTEGER\(2\))h(\(a)f(2)g(elemen)n(t)h(arra)n(y)d
(holding)i(the)h(real)f(and)h(imaginary)e(parts)g(of)i(the)g(complex)
-427 3643 y(v)-5 b(alue\).)340 3782 y Fi(\017)45 b Fj(F)28
-b(-)f(DOUBLE)h(PRECISION.)340 3920 y Fi(\017)45 b Fj(I)28
-b(-)f(INTEGER)340 4059 y Fi(\017)45 b Fj(L)28 b(-)f(LOGICAL)340
-4197 y Fi(\017)45 b Fj(S)28 b(-)f(CHARA)n(CTER)340 4336
-y Fi(\017)45 b Fj(CN)28 b(-)g(CHARA)n(CTER)0 4509 y Fc(In)m(v)m(o)s
+427 1208 y(v)-5 b(alue\).)340 1341 y Fi(\017)45 b Fj(F)28
+b(-)f(DOUBLE)h(PRECISION.)340 1474 y Fi(\017)45 b Fj(I)28
+b(-)f(INTEGER)340 1607 y Fi(\017)45 b Fj(L)28 b(-)f(LOGICAL)340
+1740 y Fi(\017)45 b Fj(S)28 b(-)f(CHARA)n(CTER)340 1873
+y Fi(\017)45 b Fj(CN)28 b(-)g(CHARA)n(CTER)0 2036 y Fc(In)m(v)m(o)s
(cation:)123 b Ft(CALL)42 b(AST_SETFITS)p Fl(<)p Ft(X)p
Fl(>)p Ft(\()37 b(THIS,)42 b(NAME,)f(VALUE,)g(COMMENT,)f(OVERWRITE,)g
-(STATUS)h(\))0 4670 y Fc(Argumen)m(ts:)259 4818 y(THIS)32
-b(=)g(INTEGER)g(\(Giv)m(en\))427 4918 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(FitsChan.)259 5056 y Fc(NAME)j(=)h(CHARA)m(CTER)g
+(STATUS)h(\))0 2186 y Fc(Argumen)m(ts:)259 2323 y(THIS)32
+b(=)g(INTEGER)g(\(Giv)m(en\))427 2423 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(FitsChan.)259 2556 y Fc(NAME)j(=)h(CHARA)m(CTER)g
Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-5156 y Fj(A)25 b(c)n(haracter)d(string)i(con)n(taining)g(the)g(FITS)h
+2655 y Fj(A)25 b(c)n(haracter)d(string)i(con)n(taining)g(the)g(FITS)h
(k)n(eyw)n(ord)e(name.)35 b(This)25 b(ma)n(y)e(b)r(e)i(a)f(complete)h
-(FITS)f(header)427 5256 y(card,)k(in)g(whic)n(h)g(case)f(the)h(k)n(eyw)
+(FITS)f(header)427 2755 y(card,)k(in)g(whic)n(h)g(case)f(the)h(k)n(eyw)
n(ord)e(to)i(use)g(is)g(extracted)f(from)g(it.)39 b(No)28
-b(more)f(than)h(80)f(c)n(haracters)f(are)427 5355 y(read)h(from)g(this)
-h(string.)259 5494 y Fc(V)-11 b(ALUE)33 b(=)f Fl(<)p
-Fc(X)p Fl(>)p Fc(t)m(yp)s(e)g(\(Giv)m(en\))427 5593 y
+b(more)f(than)h(80)f(c)n(haracters)f(are)427 2855 y(read)h(from)g(this)
+h(string.)259 2988 y Fc(V)-11 b(ALUE)33 b(=)f Fl(<)p
+Fc(X)p Fl(>)p Fc(t)m(yp)s(e)g(\(Giv)m(en\))427 3087 y
Fj(The)20 b(k)n(eyw)n(ord)d(v)-5 b(alue)19 b(to)g(store)g(with)h(the)f
(named)h(k)n(eyw)n(ord.)32 b(The)19 b(data)g(t)n(yp)r(e)g(of)h(this)f
-(parameter)f(dep)r(ends)427 5693 y(on)28 b Fl(<)p Fj(X)p
-Fl(>)f Fj(as)g(describ)r(ed)g(ab)r(o)n(v)n(e.)p eop end
-%%Page: 358 368
-TeXDict begin 358 367 bop 0 52 a FG(358)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(COMMENT)g(=)h(CHARA)m
-(CTER)f Fi(\003)h Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-451 y Fj(A)i(string)e(holding)h(a)f(commen)n(t)h(to)g(asso)r(ciated)f
-(with)h(the)h(k)n(eyw)n(ord.)51 b(If)34 b(a)e(blank)h(string)f(is)h
-(supplied,)427 551 y(then)c(an)n(y)e(commen)n(t)h(included)h(in)f(the)g
-(string)g(supplied)g(for)g(the)g(NAME)g(parameter)f(is)h(used)g
-(instead.)427 650 y(If)f(NAME)f(con)n(tains)f(no)h(commen)n(t,)h(then)f
-(an)n(y)f(existing)h(commen)n(t)g(in)h(the)f(card)f(b)r(eing)i(o)n(v)n
-(er-written)d(is)427 750 y(retained.)37 b(Otherwise,)26
+(parameter)f(dep)r(ends)427 3187 y(on)28 b Fl(<)p Fj(X)p
+Fl(>)f Fj(as)g(describ)r(ed)g(ab)r(o)n(v)n(e.)259 3320
+y Fc(COMMENT)k(=)h(CHARA)m(CTER)f Fi(\003)h Fc(\()g Fi(\003)f
+Fc(\))h(\(Giv)m(en\))427 3420 y Fj(A)i(string)e(holding)h(a)f(commen)n
+(t)h(to)g(asso)r(ciated)f(with)h(the)h(k)n(eyw)n(ord.)51
+b(If)34 b(a)e(blank)h(string)f(is)h(supplied,)427 3519
+y(then)c(an)n(y)e(commen)n(t)h(included)h(in)f(the)g(string)g(supplied)
+g(for)g(the)g(NAME)g(parameter)f(is)h(used)g(instead.)427
+3619 y(If)f(NAME)f(con)n(tains)f(no)h(commen)n(t,)h(then)f(an)n(y)f
+(existing)h(commen)n(t)g(in)h(the)f(card)f(b)r(eing)i(o)n(v)n
+(er-written)d(is)427 3719 y(retained.)37 b(Otherwise,)26
b(no)i(commen)n(t)f(is)h(stored)e(with)j(the)f(card.)259
-877 y Fc(O)m(VER)-11 b(WRITE)32 b(=)g(LOGICAL)g(\(Giv)m(en\))427
-977 y Fj(If)27 b(.TR)n(UE.,)f(the)g(new)g(card)f(formed)g(from)h(the)g
+3852 y Fc(O)m(VER)-11 b(WRITE)32 b(=)g(LOGICAL)g(\(Giv)m(en\))427
+3951 y Fj(If)27 b(.TR)n(UE.,)f(the)g(new)g(card)f(formed)g(from)h(the)g
(supplied)g(k)n(eyw)n(ord)e(name,)i(v)-5 b(alue)26 b(and)g(commen)n(t)f
-(string)427 1076 y(o)n(v)n(er-writes)30 b(the)j(curren)n(t)f(card,)i
+(string)427 4051 y(o)n(v)n(er-writes)30 b(the)j(curren)n(t)f(card,)i
(and)e(the)h(curren)n(t)f(card)g(is)h(incremen)n(ted)f(to)h(refer)f(to)
-g(the)i(next)e(card)427 1176 y(\(see)c(the)h Ft(")p Fj(Card)p
+g(the)i(next)e(card)427 4151 y(\(see)c(the)h Ft(")p Fj(Card)p
Ft(")e Fj(attribute\).)39 b(If)28 b(.F)-9 b(ALSE.,)29
b(the)f(new)h(card)e(is)h(inserted)g(in)h(fron)n(t)e(of)i(the)f(curren)
-n(t)f(card)427 1275 y(and)h(the)h(curren)n(t)f(card)f(is)h(left)h(unc)n
+n(t)f(card)427 4250 y(and)h(the)h(curren)n(t)f(card)f(is)h(left)h(unc)n
(hanged.)39 b(In)28 b(either)g(case,)g(if)h(the)g(curren)n(t)e(card)h
-(on)g(en)n(try)f(p)r(oin)n(ts)i(to)427 1375 y(the)f Ft(")p
+(on)g(en)n(try)f(p)r(oin)n(ts)i(to)427 4350 y(the)f Ft(")p
Fj(end-of-\014le)p Ft(")p Fj(,)f(the)h(new)f(card)g(is)g(app)r(ended)h
-(to)g(the)g(end)g(of)f(the)h(list.)259 1502 y Fc(ST)-8
+(to)g(the)g(end)g(of)f(the)h(list.)259 4483 y Fc(ST)-8
b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-1602 y Fj(The)c(global)e(status.)0 1758 y Fc(Notes:)340
-2035 y Fi(\017)45 b Fj(The)39 b(routine)f(AST)p Ft(_)p
+4583 y Fj(The)c(global)e(status.)0 4745 y Fc(Notes:)340
+5028 y Fi(\017)45 b Fj(The)39 b(routine)f(AST)p Ft(_)p
Fj(SETFITSU)g(can)g(b)r(e)h(used)g(to)f(indicate)g(that)h(no)f(v)-5
-b(alue)39 b(is)f(asso)r(ciated)f(with)i(a)427 2135 y(k)n(eyw)n(ord.)340
-2262 y Fi(\017)45 b Fj(The)29 b(routine)f(AST)p Ft(_)p
+b(alue)39 b(is)f(asso)r(ciated)f(with)i(a)427 5128 y(k)n(eyw)n(ord.)340
+5261 y Fi(\017)45 b Fj(The)29 b(routine)f(AST)p Ft(_)p
Fj(SETFITSCM)g(can)h(b)r(e)f(used)h(to)f(store)g(a)g(pure)g(commen)n(t)
-h(card)e(\(i.e.)40 b(a)28 b(card)g(with)427 2361 y(a)f(blank)h(k)n(eyw)
-n(ord\).)340 2489 y Fi(\017)45 b Fj(T)-7 b(o)22 b(assign)e(a)i(new)g(v)
+h(card)e(\(i.e.)40 b(a)28 b(card)g(with)427 5361 y(a)f(blank)h(k)n(eyw)
+n(ord\).)340 5494 y Fi(\017)45 b Fj(T)-7 b(o)22 b(assign)e(a)i(new)g(v)
-5 b(alue)21 b(for)h(an)f(existing)h(k)n(eyw)n(ord)d(within)k(a)e
(FitsChan,)i(\014rst)f(\014nd)g(the)h(card)d(describing)427
-2588 y(the)29 b(k)n(eyw)n(ord)d(using)i(AST)p Ft(_)p
+5593 y(the)29 b(k)n(eyw)n(ord)d(using)i(AST)p Ft(_)p
Fj(FINDFITS,)h(and)f(then)h(use)f(one)f(of)i(the)f(AST)p
Ft(_)p Fj(SETFITS)p Fl(<)p Fj(X)p Fl(>)g Fj(family)g(to)427
-2688 y(o)n(v)n(er-write)d(the)j(old)g(v)-5 b(alue.)340
-2815 y Fi(\017)45 b Fj(If,)25 b(on)e(exit,)h(there)f(are)f(no)h(cards)f
-(follo)n(wing)g(the)h(card)g(written)g(b)n(y)g(this)g(routine,)h(then)g
-(the)f(curren)n(t)f(card)427 2915 y(is)28 b(left)g(p)r(oin)n(ting)g(at)
-f(the)h Ft(")p Fj(end-of-\014le)p Ft(")p Fj(.)340 3042
-y Fi(\017)45 b Fj(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)h
-(the)g(k)n(eyw)n(ord)d(name)j(do)r(es)f(not)h(conform)e(to)i(FITS)g
-(requiremen)n(ts.)p 0 3230 3780 12 v 0 3360 a FA(AST)p
-Fe(_)p FA(SETFITSCM)1326 3361 y Fd(Store)37 b(a)i(commen)m(t)e(card)
-1536 3461 y(in)h(a)h(FitsChan)2664 3360 y FA(AST)p Fe(_)p
-FA(SETFITSCM)0 3620 y Fc(Description:)44 b Fj(This)31
-b(routine)g(stores)f(a)h(commen)n(t)g(card)f(\()i(i.e.)47
+5693 y(o)n(v)n(er-write)d(the)j(old)g(v)-5 b(alue.)p
+eop end
+%%Page: 361 371
+TeXDict begin 361 370 bop 3643 52 a FG(361)340 351 y
+Fi(\017)45 b Fj(If,)25 b(on)e(exit,)h(there)f(are)f(no)h(cards)f(follo)
+n(wing)g(the)h(card)g(written)g(b)n(y)g(this)g(routine,)h(then)g(the)f
+(curren)n(t)f(card)427 451 y(is)28 b(left)g(p)r(oin)n(ting)g(at)f(the)h
+Ft(")p Fj(end-of-\014le)p Ft(")p Fj(.)340 576 y Fi(\017)45
+b Fj(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)h(the)g(k)n(eyw)n
+(ord)d(name)j(do)r(es)f(not)h(conform)e(to)i(FITS)g(requiremen)n(ts.)p
+0 759 3780 12 v 0 890 a FA(AST)p Fe(_)p FA(SETFITSCM)1326
+891 y Fd(Store)37 b(a)i(commen)m(t)e(card)1536 991 y(in)h(a)h(FitsChan)
+2664 890 y FA(AST)p Fe(_)p FA(SETFITSCM)0 1145 y Fc(Description:)44
+b Fj(This)31 b(routine)g(stores)f(a)h(commen)n(t)g(card)f(\()i(i.e.)47
b(a)31 b(card)f(with)i(no)f(k)n(eyw)n(ord)e(name)i(or)f(equals)h
-(sign\))227 3720 y(within)j(a)f(FitsChan)g(at)g(the)h(curren)n(t)e
+(sign\))227 1245 y(within)j(a)f(FitsChan)g(at)g(the)h(curren)n(t)e
(card)h(p)r(osition.)53 b(The)34 b(new)f(card)f(can)h(either)g(o)n(v)n
-(er-write)e(an)i(existing)227 3819 y(card,)27 b(or)g(can)g(b)r(e)h
+(er-write)e(an)i(existing)227 1344 y(card,)27 b(or)g(can)g(b)r(e)h
(inserted)f(as)g(a)g(new)h(card)f(in)n(to)g(the)h(FitsChan.)0
-3963 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_SETFITSCM\()37
-b(THIS,)42 b(COMMENT,)e(OVERWRITE,)g(STATUS)h(\))0 4107
-y Fc(Argumen)m(ts:)259 4238 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
-4337 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
-4464 y Fc(COMMENT)j(=)h(CHARA)m(CTER)f Fi(\003)h Fc(\()g
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 4564 y Fj(A)f(string)f(holding)g
+1486 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_SETFITSCM\()37
+b(THIS,)42 b(COMMENT,)e(OVERWRITE,)g(STATUS)h(\))0 1627
+y Fc(Argumen)m(ts:)259 1756 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
+1855 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
+1980 y Fc(COMMENT)j(=)h(CHARA)m(CTER)f Fi(\003)h Fc(\()g
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 2080 y Fj(A)f(string)f(holding)g
(the)h(text)g(of)f(the)h(commen)n(t)g(card.)45 b(If)31
b(a)f(blank)g(string)g(is)g(supplied,)i(then)f(a)f(totally)427
-4664 y(blank)e(card)e(is)i(pro)r(duced.)259 4791 y Fc(O)m(VER)-11
-b(WRITE)32 b(=)g(LOGICAL)g(\(Giv)m(en\))427 4890 y Fj(If)h(.TR)n(UE.,)h
+2180 y(blank)e(card)e(is)i(pro)r(duced.)259 2305 y Fc(O)m(VER)-11
+b(WRITE)32 b(=)g(LOGICAL)g(\(Giv)m(en\))427 2404 y Fj(If)h(.TR)n(UE.,)h
(the)f(new)f(card)g(o)n(v)n(er-writes)e(the)j(curren)n(t)f(card,)h(and)
-f(the)h(curren)n(t)f(card)f(is)i(incremen)n(ted)427 4990
+f(the)h(curren)n(t)f(card)f(is)i(incremen)n(ted)427 2504
y(to)c(refer)e(to)i(the)f(next)h(card)f(\(see)g(the)h
Ft(")p Fj(Card)p Ft(")e Fj(attribute\).)39 b(If)29 b(.F)-9
b(ALSE.,)29 b(the)g(new)f(card)g(is)g(inserted)g(in)427
-5090 y(fron)n(t)d(of)h(the)g(curren)n(t)f(card)g(and)g(the)h(curren)n
+2603 y(fron)n(t)d(of)h(the)g(curren)n(t)f(card)g(and)g(the)h(curren)n
(t)f(card)g(is)g(left)h(unc)n(hanged.)36 b(In)26 b(either)f(case,)g(if)
-h(the)g(curren)n(t)427 5189 y(card)h(on)g(en)n(try)g(p)r(oin)n(ts)h(to)
+h(the)g(curren)n(t)427 2703 y(card)h(on)g(en)n(try)g(p)r(oin)n(ts)h(to)
f(the)h Ft(")p Fj(end-of-\014le)p Ft(")p Fj(,)f(the)h(new)f(card)g(is)h
(app)r(ended)f(to)h(the)g(end)g(of)f(the)h(list.)259
-5317 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 5416 y Fj(The)c(global)e(status.)0 5572
-y Fc(Notes:)p eop end
-%%Page: 359 369
-TeXDict begin 359 368 bop 3643 52 a FG(359)340 351 y
-Fi(\017)45 b Fj(If,)34 b(on)d(exit,)j(there)d(are)g(no)h(cards)f(follo)
-n(wing)g(the)h(card)f(written)h(b)n(y)g(this)g(function,)i(then)e(the)g
-(curren)n(t)427 451 y(card)27 b(is)g(left)i(p)r(oin)n(ting)e(at)h(the)g
-Ft(")p Fj(end-of-\014le)p Ft(")p Fj(.)p 0 643 3780 12
-v 0 773 a FA(AST)p Fe(_)p FA(SETFITSU)1178 774 y Fd(Store)37
-b(an)i(unde\014ned)g(k)m(eyw)m(ord)1385 889 y(v)-7 b(alue)38
-b(in)h(a)f(FitsChan)2785 773 y FA(AST)p Fe(_)p FA(SETFITSU)0
-1047 y Fc(Description:)44 b Fj(This)36 b(routine)e(stores)h(an)g
-(unde\014ned)g(v)-5 b(alue)36 b(for)e(a)h(named)g(k)n(eyw)n(ord)f
-(within)i(a)f(FitsChan)g(at)g(the)227 1147 y(curren)n(t)c(card)f(p)r
-(osition.)49 b(The)31 b(new)h(unde\014ned)g(v)-5 b(alue)31
-b(can)g(either)h(o)n(v)n(er-write)d(an)i(existing)g(k)n(eyw)n(ord)f(v)
--5 b(alue,)227 1246 y(or)27 b(can)g(b)r(e)h(inserted)g(as)e(a)i(new)f
-(header)g(card)g(in)n(to)g(the)h(FitsChan.)0 1392 y Fc(In)m(v)m(o)s
-(cation:)123 b Ft(CALL)42 b(AST_SETFITSU\()c(THIS,)j(NAME,)h(COMMENT,)e
-(OVERWRITE,)g(STATUS)h(\))0 1537 y Fc(Argumen)m(ts:)259
-1670 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1770
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259 1899
-y Fc(NAME)j(=)h(CHARA)m(CTER)g Fi(\003)f Fc(\()h Fi(\003)f
-Fc(\))h(\(Giv)m(en\))427 1998 y Fj(A)25 b(c)n(haracter)d(string)i(con)n
-(taining)g(the)g(FITS)h(k)n(eyw)n(ord)e(name.)35 b(This)25
-b(ma)n(y)e(b)r(e)i(a)f(complete)h(FITS)f(header)427 2098
-y(card,)k(in)g(whic)n(h)g(case)f(the)h(k)n(eyw)n(ord)e(to)i(use)g(is)g
-(extracted)f(from)g(it.)39 b(No)28 b(more)f(than)h(80)f(c)n(haracters)f
-(are)427 2198 y(read)h(from)g(this)h(string.)259 2327
-y Fc(COMMENT)j(=)h(CHARA)m(CTER)f Fi(\003)h Fc(\()g Fi(\003)f
-Fc(\))h(\(Giv)m(en\))427 2426 y Fj(A)i(string)e(holding)h(a)f(commen)n
-(t)h(to)g(asso)r(ciated)f(with)h(the)h(k)n(eyw)n(ord.)51
-b(If)34 b(a)e(blank)h(string)f(is)h(supplied,)427 2526
-y(then)c(an)n(y)e(commen)n(t)h(included)h(in)f(the)g(string)g(supplied)
-g(for)g(the)g(NAME)g(parameter)f(is)h(used)g(instead.)427
-2626 y(If)f(NAME)f(con)n(tains)f(no)h(commen)n(t,)h(then)f(an)n(y)f
-(existing)h(commen)n(t)g(in)h(the)f(card)f(b)r(eing)i(o)n(v)n
-(er-written)d(is)427 2725 y(retained.)37 b(Otherwise,)26
-b(no)i(commen)n(t)f(is)h(stored)e(with)j(the)f(card.)259
-2854 y Fc(O)m(VER)-11 b(WRITE)32 b(=)g(LOGICAL)g(\(Giv)m(en\))427
-2954 y Fj(If)d(.TR)n(UE.,)f(the)h(new)f(card)f(formed)h(from)g(the)g
-(supplied)h(k)n(eyw)n(ord)d(name)i(and)g(commen)n(t)g(string)g(o)n(v)n
-(er-)427 3054 y(writes)33 b(the)g(curren)n(t)g(card,)g(and)g(the)h
-(curren)n(t)e(card)g(is)h(incremen)n(ted)g(to)g(refer)g(to)g(the)g
-(next)g(card)g(\(see)427 3153 y(the)c Ft(")p Fj(Card)p
-Ft(")e Fj(attribute\).)40 b(If)29 b(.F)-9 b(ALSE.,)29
-b(the)g(new)f(card)g(is)g(inserted)g(in)h(fron)n(t)f(of)h(the)g(curren)
-n(t)e(card)h(and)427 3253 y(the)i(curren)n(t)e(card)h(is)g(left)h(unc)n
-(hanged.)41 b(In)30 b(either)f(case,)g(if)h(the)f(curren)n(t)g(card)f
-(on)h(en)n(try)g(p)r(oin)n(ts)g(to)g(the)427 3352 y Ft(")p
-Fj(end-of-\014le)p Ft(")p Fj(,)e(the)h(new)f(card)g(is)g(app)r(ended)h
-(to)g(the)g(end)g(of)f(the)h(list.)259 3482 y Fc(ST)-8
-b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-3581 y Fj(The)c(global)e(status.)0 3739 y Fc(Notes:)340
-4018 y Fi(\017)45 b Fj(If,)34 b(on)d(exit,)j(there)d(are)g(no)h(cards)f
-(follo)n(wing)g(the)h(card)f(written)h(b)n(y)g(this)g(function,)i(then)
-e(the)g(curren)n(t)427 4118 y(card)27 b(is)g(left)i(p)r(oin)n(ting)e
-(at)h(the)g Ft(")p Fj(end-of-\014le)p Ft(")p Fj(.)340
-4247 y Fi(\017)45 b Fj(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)
-h(the)g(k)n(eyw)n(ord)d(name)j(do)r(es)f(not)h(conform)e(to)i(FITS)g
-(requiremen)n(ts.)p 0 4438 V 0 4569 a FA(AST)p Fe(_)p
-FA(SETREFPOS)1462 4570 y Fd(Set)39 b(the)f(reference)1333
-4670 y(p)s(osition)f(in)i(a)f(sp)s(eci\014ed)1400 4784
-y(celestial)f(co)s(ordinate)1715 4884 y(system)2651 4569
-y FA(AST)p Fe(_)p FA(SETREFPOS)0 5070 y Fc(Description:)44
-b Fj(This)25 b(routine)f(sets)g(the)g(reference)g(p)r(osition)g(\(see)g
-(attributes)g(RefRA)h(and)f(RefDec\))i(using)e(axis)f(v)-5
-b(al-)227 5169 y(ues)19 b(\(in)h(radians\))e(supplied)i(within)g(the)f
-(celestial)g(co)r(ordinate)f(system)h(represen)n(ted)f(b)n(y)h(a)g
-(supplied)g(SkyF)-7 b(rame.)0 5315 y Fc(In)m(v)m(o)s(cation:)123
-b Ft(CALL)42 b(AST_SETREFPOS\()37 b(THIS,)42 b(FRM,)g(LON,)g(LAT,)g
-(STATUS)f(\))0 5461 y Fc(Argumen)m(ts:)259 5593 y(THIS)32
-b(=)g(INTEGER)g(\(Giv)m(en\))427 5693 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(Sp)r(ecF)-7 b(rame.)p eop end
-%%Page: 360 370
-TeXDict begin 360 369 bop 0 52 a FG(360)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(FRM)g(=)h(INTEGER)g
-(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)23 b(to)i(the)g(SkyF)-7
-b(rame)24 b(whic)n(h)g(de\014nes)h(the)g(celestial)f(co)r(ordinate)g
-(system)g(in)h(whic)n(h)g(the)g(longitude)427 551 y(and)e(latitude)h(v)
--5 b(alues)23 b(are)g(supplied.)35 b(If)24 b(AST)p Ft(__)p
+2828 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 2928 y Fj(The)c(global)e(status.)0 3082
+y Fc(Notes:)340 3356 y Fi(\017)45 b Fj(If,)34 b(on)d(exit,)j(there)d
+(are)g(no)h(cards)f(follo)n(wing)g(the)h(card)f(written)h(b)n(y)g(this)
+g(function,)i(then)e(the)g(curren)n(t)427 3456 y(card)27
+b(is)g(left)i(p)r(oin)n(ting)e(at)h(the)g Ft(")p Fj(end-of-\014le)p
+Ft(")p Fj(.)p 0 3639 V 0 3770 a FA(AST)p Fe(_)p FA(SETFITSU)1178
+3771 y Fd(Store)37 b(an)i(unde\014ned)g(k)m(eyw)m(ord)1385
+3886 y(v)-7 b(alue)38 b(in)h(a)f(FitsChan)2785 3770 y
+FA(AST)p Fe(_)p FA(SETFITSU)0 4035 y Fc(Description:)44
+b Fj(This)36 b(routine)e(stores)h(an)g(unde\014ned)g(v)-5
+b(alue)36 b(for)e(a)h(named)g(k)n(eyw)n(ord)f(within)i(a)f(FitsChan)g
+(at)g(the)227 4135 y(curren)n(t)c(card)f(p)r(osition.)49
+b(The)31 b(new)h(unde\014ned)g(v)-5 b(alue)31 b(can)g(either)h(o)n(v)n
+(er-write)d(an)i(existing)g(k)n(eyw)n(ord)f(v)-5 b(alue,)227
+4235 y(or)27 b(can)g(b)r(e)h(inserted)g(as)e(a)i(new)f(header)g(card)g
+(in)n(to)g(the)h(FitsChan.)0 4376 y Fc(In)m(v)m(o)s(cation:)123
+b Ft(CALL)42 b(AST_SETFITSU\()c(THIS,)j(NAME,)h(COMMENT,)e(OVERWRITE,)g
+(STATUS)h(\))0 4518 y Fc(Argumen)m(ts:)259 4646 y(THIS)32
+b(=)g(INTEGER)g(\(Giv)m(en\))427 4746 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(FitsChan.)259 4871 y Fc(NAME)j(=)h(CHARA)m(CTER)g
+Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
+4970 y Fj(A)25 b(c)n(haracter)d(string)i(con)n(taining)g(the)g(FITS)h
+(k)n(eyw)n(ord)e(name.)35 b(This)25 b(ma)n(y)e(b)r(e)i(a)f(complete)h
+(FITS)f(header)427 5070 y(card,)k(in)g(whic)n(h)g(case)f(the)h(k)n(eyw)
+n(ord)e(to)i(use)g(is)g(extracted)f(from)g(it.)39 b(No)28
+b(more)f(than)h(80)f(c)n(haracters)f(are)427 5170 y(read)h(from)g(this)
+h(string.)259 5295 y Fc(COMMENT)j(=)h(CHARA)m(CTER)f
+Fi(\003)h Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427
+5394 y Fj(A)i(string)e(holding)h(a)f(commen)n(t)h(to)g(asso)r(ciated)f
+(with)h(the)h(k)n(eyw)n(ord.)51 b(If)34 b(a)e(blank)h(string)f(is)h
+(supplied,)427 5494 y(then)c(an)n(y)e(commen)n(t)h(included)h(in)f(the)
+g(string)g(supplied)g(for)g(the)g(NAME)g(parameter)f(is)h(used)g
+(instead.)427 5593 y(If)f(NAME)f(con)n(tains)f(no)h(commen)n(t,)h(then)
+f(an)n(y)f(existing)h(commen)n(t)g(in)h(the)f(card)f(b)r(eing)i(o)n(v)n
+(er-written)d(is)427 5693 y(retained.)37 b(Otherwise,)26
+b(no)i(commen)n(t)f(is)h(stored)e(with)j(the)f(card.)p
+eop end
+%%Page: 362 372
+TeXDict begin 362 371 bop 0 52 a FG(362)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(O)m(VER)-11
+b(WRITE)32 b(=)g(LOGICAL)g(\(Giv)m(en\))427 451 y Fj(If)d(.TR)n(UE.,)f
+(the)h(new)f(card)f(formed)h(from)g(the)g(supplied)h(k)n(eyw)n(ord)d
+(name)i(and)g(commen)n(t)g(string)g(o)n(v)n(er-)427 551
+y(writes)33 b(the)g(curren)n(t)g(card,)g(and)g(the)h(curren)n(t)e(card)
+g(is)h(incremen)n(ted)g(to)g(refer)g(to)g(the)g(next)g(card)g(\(see)427
+650 y(the)c Ft(")p Fj(Card)p Ft(")e Fj(attribute\).)40
+b(If)29 b(.F)-9 b(ALSE.,)29 b(the)g(new)f(card)g(is)g(inserted)g(in)h
+(fron)n(t)f(of)h(the)g(curren)n(t)e(card)h(and)427 750
+y(the)i(curren)n(t)e(card)h(is)g(left)h(unc)n(hanged.)41
+b(In)30 b(either)f(case,)g(if)h(the)f(curren)n(t)g(card)f(on)h(en)n
+(try)g(p)r(oin)n(ts)g(to)g(the)427 849 y Ft(")p Fj(end-of-\014le)p
+Ft(")p Fj(,)e(the)h(new)f(card)g(is)g(app)r(ended)h(to)g(the)g(end)g
+(of)f(the)h(list.)259 971 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f
+(\(Giv)m(en)h(and)g(Returned\))427 1070 y Fj(The)c(global)e(status.)0
+1220 y Fc(Notes:)340 1491 y Fi(\017)45 b Fj(If,)34 b(on)d(exit,)j
+(there)d(are)g(no)h(cards)f(follo)n(wing)g(the)h(card)f(written)h(b)n
+(y)g(this)g(function,)i(then)e(the)g(curren)n(t)427 1591
+y(card)27 b(is)g(left)i(p)r(oin)n(ting)e(at)h(the)g Ft(")p
+Fj(end-of-\014le)p Ft(")p Fj(.)340 1712 y Fi(\017)45
+b Fj(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)h(the)g(k)n(eyw)n
+(ord)d(name)j(do)r(es)f(not)h(conform)e(to)i(FITS)g(requiremen)n(ts.)p
+0 1888 3780 12 v 0 2019 a FA(AST)p Fe(_)p FA(SETREFPOS)1462
+2020 y Fd(Set)39 b(the)f(reference)1333 2120 y(p)s(osition)f(in)i(a)f
+(sp)s(eci\014ed)1400 2234 y(celestial)f(co)s(ordinate)1715
+2334 y(system)2651 2019 y FA(AST)p Fe(_)p FA(SETREFPOS)0
+2504 y Fc(Description:)44 b Fj(This)25 b(routine)f(sets)g(the)g
+(reference)g(p)r(osition)g(\(see)g(attributes)g(RefRA)h(and)f(RefDec\))
+i(using)e(axis)f(v)-5 b(al-)227 2604 y(ues)19 b(\(in)h(radians\))e
+(supplied)i(within)g(the)f(celestial)g(co)r(ordinate)f(system)h
+(represen)n(ted)f(b)n(y)h(a)g(supplied)g(SkyF)-7 b(rame.)0
+2741 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_SETREFPOS\()37
+b(THIS,)42 b(FRM,)g(LON,)g(LAT,)g(STATUS)f(\))0 2879
+y Fc(Argumen)m(ts:)259 3004 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
+3104 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Sp)r(ecF)-7 b(rame.)259
+3225 y Fc(FRM)31 b(=)h(INTEGER)g(\(Giv)m(en\))427 3324
+y Fj(P)n(oin)n(ter)23 b(to)i(the)g(SkyF)-7 b(rame)24
+b(whic)n(h)g(de\014nes)h(the)g(celestial)f(co)r(ordinate)g(system)g(in)
+h(whic)n(h)g(the)g(longitude)427 3424 y(and)e(latitude)h(v)-5
+b(alues)23 b(are)g(supplied.)35 b(If)24 b(AST)p Ft(__)p
Fj(NULL)f(is)h(supplied,)g(then)g(the)g(supplied)g(longitude)f(and)427
-650 y(latitude)28 b(v)-5 b(alues)28 b(are)e(assumed)h(to)h(b)r(e)g(FK5)
-f(J2000)e(RA)j(and)f(Dec)h(v)-5 b(alues.)259 787 y Fc(LON)32
-b(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427 887 y Fj(The)i(longitude)g
-(of)f(the)h(reference)f(p)r(oin)n(t,)i(in)f(the)g(co)r(ordinate)f
-(system)g(represen)n(ted)g(b)n(y)g(the)h(supplied)427
-986 y(SkyF)-7 b(rame)27 b(\(radians\).)259 1123 y Fc(LA)-8
-b(T)33 b(=)f(DOUBLE)g(PRECISION)g(\(Giv)m(en\))427 1223
-y Fj(The)37 b(latitude)h(of)e(the)i(reference)e(p)r(oin)n(t,)j(in)e
-(the)g(co)r(ordinate)f(system)h(represen)n(ted)e(b)n(y)i(the)g
-(supplied)427 1322 y(SkyF)-7 b(rame)27 b(\(radians\).)259
-1459 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 1559 y Fj(The)c(global)e(status.)p 0
-1766 3780 12 v 0 1897 a FA(AST)p Fe(_)p FA(SETUNC)1061
-1898 y Fd(Store)37 b(uncertain)m(t)m(y)f(information)f(in)1665
-2011 y(a)j(Region)2886 1897 y FA(AST)p Fe(_)p FA(SETUNC)0
-2213 y Fc(Description:)44 b Fj(Eac)n(h)33 b(Region)h(\(of)g(an)n(y)g
+3524 y(latitude)28 b(v)-5 b(alues)28 b(are)e(assumed)h(to)h(b)r(e)g
+(FK5)f(J2000)e(RA)j(and)f(Dec)h(v)-5 b(alues.)259 3645
+y Fc(LON)32 b(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427
+3744 y Fj(The)i(longitude)g(of)f(the)h(reference)f(p)r(oin)n(t,)i(in)f
+(the)g(co)r(ordinate)f(system)g(represen)n(ted)g(b)n(y)g(the)h
+(supplied)427 3844 y(SkyF)-7 b(rame)27 b(\(radians\).)259
+3965 y Fc(LA)-8 b(T)33 b(=)f(DOUBLE)g(PRECISION)g(\(Giv)m(en\))427
+4065 y Fj(The)37 b(latitude)h(of)e(the)i(reference)e(p)r(oin)n(t,)j(in)
+e(the)g(co)r(ordinate)f(system)h(represen)n(ted)e(b)n(y)i(the)g
+(supplied)427 4165 y(SkyF)-7 b(rame)27 b(\(radians\).)259
+4286 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 4385 y Fj(The)c(global)e(status.)p 0
+4561 V 0 4692 a FA(AST)p Fe(_)p FA(SETUNC)1061 4693 y
+Fd(Store)37 b(uncertain)m(t)m(y)f(information)f(in)1665
+4806 y(a)j(Region)2886 4692 y FA(AST)p Fe(_)p FA(SETUNC)0
+4977 y Fc(Description:)44 b Fj(Eac)n(h)33 b(Region)h(\(of)g(an)n(y)g
(class\))f(can)h(ha)n(v)n(e)f(an)h Ft(")p Fj(uncertain)n(t)n(y)p
Ft(")e Fj(whic)n(h)j(sp)r(eci\014es)f(the)g(uncertain)n(ties)227
-2312 y(asso)r(ciated)27 b(with)i(the)g(b)r(oundary)e(of)h(the)h
+5076 y(asso)r(ciated)27 b(with)i(the)g(b)r(oundary)e(of)h(the)h
(Region.)38 b(This)29 b(information)e(is)h(supplied)h(in)g(the)f(form)g
-(of)g(a)g(second)227 2412 y(Region.)77 b(The)41 b(uncertain)n(t)n(y)f
+(of)g(a)g(second)227 5176 y(Region.)77 b(The)41 b(uncertain)n(t)n(y)f
(in)h(an)n(y)f(p)r(oin)n(t)i(on)e(the)i(b)r(oundary)e(of)h(a)g(Region)f
-(is)h(found)g(b)n(y)g(shifting)g(the)227 2512 y(asso)r(ciated)24
+(is)h(found)g(b)n(y)g(shifting)g(the)227 5275 y(asso)r(ciated)24
b Ft(")p Fj(uncertain)n(t)n(y)p Ft(")g Fj(Region)g(so)h(that)h(it)f(is)
g(cen)n(tred)g(at)g(the)h(b)r(oundary)f(p)r(oin)n(t)g(b)r(eing)g
-(considered.)36 b(The)227 2611 y(area)c(co)n(v)n(ered)g(b)n(y)h(the)h
+(considered.)36 b(The)227 5375 y(area)c(co)n(v)n(ered)g(b)n(y)h(the)h
(shifted)g(uncertain)n(t)n(y)f(Region)g(then)h(represen)n(ts)e(the)i
-(uncertain)n(t)n(y)f(in)g(the)h(b)r(oundary)227 2711
+(uncertain)n(t)n(y)f(in)g(the)h(b)r(oundary)227 5475
y(p)r(osition.)j(The)28 b(uncertain)n(t)n(y)e(is)i(assumed)f(to)g(b)r
-(e)h(the)g(same)f(for)g(all)h(p)r(oin)n(ts.)227 2839
+(e)h(the)g(same)f(for)g(all)h(p)r(oin)n(ts.)227 5593
y(The)33 b(uncertain)n(t)n(y)f(is)h(usually)f(sp)r(eci\014ed)i(when)f
(the)g(Region)f(is)h(created,)g(but)h(this)f(routine)g(allo)n(ws)e(it)i
-(to)g(b)r(e)227 2939 y(c)n(hanged)27 b(at)g(an)n(y)g(time.)0
-3097 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_SETUNC\()d(THIS,)
-i(UNC,)h(STATUS)f(\))0 3254 y Fc(Argumen)m(ts:)259 3399
-y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 3498 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(Region)f(whic)n(h)g(is)h(to)f(b)r(e)h(assigned)e(a)i(new)f
-(uncertain)n(t)n(y)-7 b(.)259 3635 y Fc(UNC)32 b(=)g(INTEGER)f(\(Giv)m
-(en\))427 3735 y Fj(P)n(oin)n(ter)39 b(to)i(the)f(new)h(uncertain)n(t)n
-(y)f(Region.)74 b(This)41 b(m)n(ust)g(b)r(e)f(of)h(a)f(class)g(for)f
-(whic)n(h)i(all)f(instances)427 3834 y(are)27 b(cen)n(tro-symetric)e
-(\(e.g.)37 b(Bo)n(x,)26 b(Circle,)i(Ellipse,)f(etc.\))37
-b(or)27 b(b)r(e)g(a)g(Prism)g(con)n(taining)g(cen)n(tro-symetric)427
-3934 y(comp)r(onen)n(t)c(Regions.)34 b(A)24 b(deep)f(cop)n(y)f(of)h
+(to)g(b)r(e)227 5693 y(c)n(hanged)27 b(at)g(an)n(y)g(time.)p
+eop end
+%%Page: 363 373
+TeXDict begin 363 372 bop 3643 52 a FG(363)0 351 y Fc(In)m(v)m(o)s
+(cation:)123 b Ft(CALL)42 b(AST_SETUNC\()d(THIS,)i(UNC,)h(STATUS)f(\))0
+521 y Fc(Argumen)m(ts:)259 678 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))
+427 778 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Region)f(whic)n(h)g(is)h(to)
+f(b)r(e)h(assigned)e(a)i(new)f(uncertain)n(t)n(y)-7 b(.)259
+921 y Fc(UNC)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 1021
+y Fj(P)n(oin)n(ter)39 b(to)i(the)f(new)h(uncertain)n(t)n(y)f(Region.)74
+b(This)41 b(m)n(ust)g(b)r(e)f(of)h(a)f(class)g(for)f(whic)n(h)i(all)f
+(instances)427 1120 y(are)27 b(cen)n(tro-symetric)e(\(e.g.)37
+b(Bo)n(x,)26 b(Circle,)i(Ellipse,)f(etc.\))37 b(or)27
+b(b)r(e)g(a)g(Prism)g(con)n(taining)g(cen)n(tro-symetric)427
+1220 y(comp)r(onen)n(t)c(Regions.)34 b(A)24 b(deep)f(cop)n(y)f(of)h
(the)g(supplied)g(Region)f(will)i(b)r(e)f(tak)n(en,)g(so)f(subsequen)n
-(t)h(c)n(hanges)427 4034 y(to)j(the)g(uncertain)n(t)n(y)f(Region)h
+(t)h(c)n(hanges)427 1319 y(to)j(the)g(uncertain)n(t)n(y)f(Region)h
(using)f(the)h(supplied)h(p)r(oin)n(ter)e(will)h(ha)n(v)n(e)f(no)h
-(e\013ect)g(on)g(the)g(Region)f(THIS.)259 4170 y Fc(ST)-8
+(e\013ect)g(on)g(the)g(Region)f(THIS.)259 1463 y Fc(ST)-8
b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-4270 y Fj(The)c(global)e(status.)p 0 4477 V 0 4608 a
-FA(AST)p Fe(_)p FA(SHIFTMAP)1415 4609 y Fd(Create)37
-b(a)i(ShiftMap)2719 4608 y FA(AST)p Fe(_)p FA(SHIFTMAP)0
-4806 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+1562 y Fj(The)c(global)e(status.)p 0 1782 3780 12 v 0
+1913 a FA(AST)p Fe(_)p FA(SHIFTMAP)1415 1914 y Fd(Create)37
+b(a)i(ShiftMap)2719 1913 y FA(AST)p Fe(_)p FA(SHIFTMAP)0
+2123 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
(ShiftMap)i(and)e(optionally)g(initialises)g(its)h(attributes.)227
-4935 y(A)g(ShiftMap)h(is)e(a)g(linear)g(Mapping)g(whic)n(h)h(shifts)g
+2258 y(A)g(ShiftMap)h(is)e(a)g(linear)g(Mapping)g(whic)n(h)h(shifts)g
(eac)n(h)f(axis)f(b)n(y)i(a)f(sp)r(eci\014ed)h(constan)n(t)f(v)-5
-b(alue.)0 5092 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
+b(alue.)0 2428 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
b(=)i(AST_SHIFTMAP\()38 b(NCOORD,)j(SHIFT,)g(OPTIONS,)f(STATUS)h(\))0
-5250 y Fc(Argumen)m(ts:)259 5394 y(NCOORD)31 b(=)h(INTEGER)f(\(Giv)m
-(en\))427 5494 y Fj(The)25 b(n)n(um)n(b)r(er)f(of)g(co)r(ordinate)g(v)
+2598 y Fc(Argumen)m(ts:)259 2755 y(NCOORD)31 b(=)h(INTEGER)f(\(Giv)m
+(en\))427 2855 y Fj(The)25 b(n)n(um)n(b)r(er)f(of)g(co)r(ordinate)g(v)
-5 b(alues)24 b(for)g(eac)n(h)f(p)r(oin)n(t)i(to)f(b)r(e)h(transformed)
f(\(i.e.)36 b(the)25 b(n)n(um)n(b)r(er)f(of)g(dimen-)427
-5593 y(sions)31 b(of)h(the)h(space)e(in)h(whic)n(h)g(the)g(p)r(oin)n
+2954 y(sions)31 b(of)h(the)h(space)e(in)h(whic)n(h)g(the)g(p)r(oin)n
(ts)g(will)g(reside\).)50 b(The)32 b(same)f(n)n(um)n(b)r(er)h(is)g
-(applicable)f(to)h(b)r(oth)427 5693 y(input)d(and)e(output)h(p)r(oin)n
-(ts.)p eop end
-%%Page: 361 371
-TeXDict begin 361 370 bop 3643 52 a FG(361)259 351 y
-Fc(SHIFT\()33 b(NCOORD)d(\))i(=)g(DOUBLE)h(PRECISION)e(\(Giv)m(en\))427
-451 y Fj(An)25 b(arra)n(y)e(con)n(taining)g(the)i(v)-5
-b(alues)24 b(to)h(b)r(e)g(added)f(on)g(to)h(the)g(input)g(co)r
-(ordinates)e(in)i(order)e(to)i(create)e(the)427 551 y(output)28
-b(co)r(ordinates.)36 b(A)28 b(separate)e(v)-5 b(alue)27
-b(should)h(b)r(e)g(supplied)g(for)f(eac)n(h)g(co)r(ordinate.)259
-677 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 776 y Fj(A)22 b(c)n(haracter)e
-(string)h(con)n(taining)g(an)h(optional)f(comma-separated)e(list)j(of)g
-(attribute)g(assignmen)n(ts)f(to)g(b)r(e)427 876 y(used)j(for)g
-(initialising)g(the)g(new)g(ShiftMap.)37 b(The)24 b(syn)n(tax)f(used)h
-(is)g(iden)n(tical)g(to)g(that)g(for)g(the)g(AST)p Ft(_)p
-Fj(SET)427 976 y(routine.)259 1102 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 1201
-y Fj(The)c(global)e(status.)0 1357 y Fc(Returned)32 b(V)-8
-b(alue:)259 1487 y(AST)p Ft(_)p Fc(SHIFTMAP)33 b(=)f(INTEGER)427
-1586 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(ShiftMap.)0
-1741 y Fc(Notes:)340 2017 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
-b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
-(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 2117 y(set)28 b(to)f(an)h(error)d(v)-5
-b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)-2
-2272 y Fc(Status)33 b(Handling)n(:)227 2418 y Fj(The)d(protected)g(in)n
-(terface)f(to)g(this)h(function)h(includes)f(an)f(extra)g(parameter)f
-(at)i(the)g(end)g(of)g(the)g(parameter)227 2518 y(list)37
-b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)
-r(oin)n(ter)g(to)h(the)g(in)n(teger)e(inherited)i(status)f(v)-5
-b(ariable:)54 b Ft(")p Fj(in)n(t)227 2618 y Fi(\003)p
-Fj(status)p Ft(")p Fj(.)p 0 2804 3780 12 v 0 2934 a FA(AST)p
-Fe(_)p FA(SHO)l(W)919 2935 y Fd(Displa)m(y)38 b(a)h(textual)e(represen)
-m(tation)e(of)k(an)1198 3050 y(Ob)7 b(ject)38 b(on)h(standard)e(output)
-3032 2934 y FA(AST)p Fe(_)p FA(SHO)l(W)0 3226 y Fc(Description:)44
+(applicable)f(to)h(b)r(oth)427 3054 y(input)d(and)e(output)h(p)r(oin)n
+(ts.)259 3197 y Fc(SHIFT\()33 b(NCOORD)d(\))i(=)g(DOUBLE)h(PRECISION)e
+(\(Giv)m(en\))427 3297 y Fj(An)25 b(arra)n(y)e(con)n(taining)g(the)i(v)
+-5 b(alues)24 b(to)h(b)r(e)g(added)f(on)g(to)h(the)g(input)g(co)r
+(ordinates)e(in)i(order)e(to)i(create)e(the)427 3396
+y(output)28 b(co)r(ordinates.)36 b(A)28 b(separate)e(v)-5
+b(alue)27 b(should)h(b)r(e)g(supplied)g(for)f(eac)n(h)g(co)r(ordinate.)
+259 3539 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f
+Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427 3639 y Fj(A)22
+b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)f
+(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r(e)
+427 3739 y(used)j(for)g(initialising)g(the)g(new)g(ShiftMap.)37
+b(The)24 b(syn)n(tax)f(used)h(is)g(iden)n(tical)g(to)g(that)g(for)g
+(the)g(AST)p Ft(_)p Fj(SET)427 3838 y(routine.)259 3981
+y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
+427 4081 y Fj(The)c(global)e(status.)0 4263 y Fc(Returned)32
+b(V)-8 b(alue:)259 4420 y(AST)p Ft(_)p Fc(SHIFTMAP)33
+b(=)f(INTEGER)427 4520 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
+(ShiftMap.)0 4702 y Fc(Notes:)340 5005 y Fi(\017)45 b
+Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
+Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 5105
+y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)-2 5288 y Fc(Status)33
+b(Handling)n(:)227 5434 y Fj(The)d(protected)g(in)n(terface)f(to)g
+(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
+(of)g(the)g(parameter)227 5533 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
+(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
+(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
+Fj(in)n(t)227 5633 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p
+eop end
+%%Page: 364 374
+TeXDict begin 364 373 bop 0 52 a FG(364)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(SHO)l(W)919 483 y Fd(Displa)m(y)38
+b(a)h(textual)e(represen)m(tation)e(of)k(an)1198 598
+y(Ob)7 b(ject)38 b(on)h(standard)e(output)3032 482 y
+FA(AST)p Fe(_)p FA(SHO)l(W)0 777 y Fc(Description:)44
b Fj(This)29 b(routine)g(displa)n(ys)f(a)h(textual)g(description)g(of)g
(an)n(y)f(AST)i(Ob)5 b(ject)29 b(on)g(standard)f(output.)42
-b(It)30 b(is)227 3325 y(pro)n(vided)d(primarily)f(as)h(an)h(aid)f(to)g
-(debugging.)0 3468 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
-b(AST_SHOW\()e(THIS,)h(STATUS)g(\))0 3611 y Fc(Argumen)m(ts:)259
-3741 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 3840
+b(It)30 b(is)227 876 y(pro)n(vided)d(primarily)f(as)h(an)h(aid)f(to)g
+(debugging.)0 1021 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
+b(AST_SHOW\()e(THIS,)h(STATUS)g(\))0 1166 y Fc(Argumen)m(ts:)259
+1298 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1397
y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5 b(ject)27 b(to)h(b)r(e)g
-(displa)n(y)n(ed.)259 3966 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f
-(\(Giv)m(en)h(and)g(Returned\))427 4066 y Fj(The)c(global)e(status.)0
-4221 y Fc(Class)31 b(Applicabilit)m(y:)259 4351 y(Ob)5
-b(ject)427 4451 y Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5
-b(jects.)p 0 4637 V 0 4768 a FA(AST)p Fe(_)p FA(SHO)l(WMESH)1433
-4769 y Fd(Displa)m(y)38 b(a)g(mesh)h(of)1403 4883 y(p)s(oin)m(ts)f(co)m
-(v)m(ering)f(the)1401 4998 y(surface)h(of)g(a)h(Region)2636
-4768 y FA(AST)p Fe(_)p FA(SHO)l(WMESH)0 5173 y Fc(Description:)44
+(displa)n(y)n(ed.)259 1525 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f
+(\(Giv)m(en)h(and)g(Returned\))427 1625 y Fj(The)c(global)e(status.)0
+1782 y Fc(Class)31 b(Applicabilit)m(y:)259 1914 y(Ob)5
+b(ject)427 2013 y Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5
+b(jects.)p 0 2203 V 0 2334 a FA(AST)p Fe(_)p FA(SHO)l(WMESH)1433
+2335 y Fd(Displa)m(y)38 b(a)g(mesh)h(of)1403 2449 y(p)s(oin)m(ts)f(co)m
+(v)m(ering)f(the)1401 2564 y(surface)h(of)g(a)h(Region)2636
+2334 y FA(AST)p Fe(_)p FA(SHO)l(WMESH)0 2743 y Fc(Description:)44
b Fj(This)34 b(routine)g(writes)g(a)f(table)h(to)g(standard)f(output)i
(con)n(taining)e(the)h(axis)f(v)-5 b(alues)34 b(at)g(a)g(mesh)g(of)227
-5273 y(p)r(oin)n(ts)d(co)n(v)n(ering)e(the)j(surface)e(of)h(the)h
+2843 y(p)r(oin)n(ts)d(co)n(v)n(ering)e(the)j(surface)e(of)h(the)h
(supplied)g(Region.)47 b(Eac)n(h)29 b(ro)n(w)h(of)i(output)f(con)n
-(tains)g(a)f(tab-separated)227 5373 y(list)36 b(of)f(axis)f(v)-5
+(tains)g(a)f(tab-separated)227 2942 y(list)36 b(of)f(axis)f(v)-5
b(alues,)37 b(one)e(for)g(eac)n(h)f(axis)h(in)g(the)h(F)-7
b(rame)35 b(encapsulated)f(b)n(y)h(the)h(Region.)59 b(The)36
-b(n)n(um)n(b)r(er)f(of)227 5472 y(p)r(oin)n(ts)28 b(in)g(the)g(mesh)f
+b(n)n(um)n(b)r(er)f(of)227 3042 y(p)r(oin)n(ts)28 b(in)g(the)g(mesh)f
(is)h(determined)g(b)n(y)f(the)h(MeshSize)f(attribute.)227
-5593 y(The)35 b(table)h(is)f(preceded)f(b)n(y)h(a)g(giv)n(en)f(title)i
+3164 y(The)35 b(table)h(is)f(preceded)f(b)n(y)h(a)g(giv)n(en)f(title)i
(string,)g(and)f(follo)n(w)n(ed)g(b)n(y)f(a)h(single)g(line)g(con)n
-(taining)f(the)i(w)n(ord)227 5693 y Ft(")p Fj(ENDMESH)p
-Ft(")p Fj(.)p eop end
-%%Page: 362 372
-TeXDict begin 362 371 bop 0 52 a FG(362)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(In)m(v)m(o)s(cation:)
-123 b Ft(CALL)42 b(AST_SHOWMESH\()c(THIS,)j(FORMAT,)g(TTL,)h(STATUS)f
-(\))0 510 y Fc(Argumen)m(ts:)259 655 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 755 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Region.)259
-892 y Fc(F)m(ORMA)-8 b(T)32 b(=)g(LOGICAL)h(\(Giv)m(en\))427
-992 y Fj(A)28 b(b)r(o)r(olean)f(v)-5 b(alue)28 b(indicating)g(if)g(the)
-g(displa)n(y)n(ed)e(axis)h(v)-5 b(alues)28 b(should)f(b)r(e)h
-(formatted)g(according)e(to)h(the)427 1091 y(F)-7 b(ormat)30
+(taining)f(the)i(w)n(ord)227 3264 y Ft(")p Fj(ENDMESH)p
+Ft(")p Fj(.)0 3409 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
+b(AST_SHOWMESH\()c(THIS,)j(FORMAT,)g(TTL,)h(STATUS)f(\))0
+3553 y Fc(Argumen)m(ts:)259 3685 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 3785 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Region.)259
+3913 y Fc(F)m(ORMA)-8 b(T)32 b(=)g(LOGICAL)h(\(Giv)m(en\))427
+4012 y Fj(A)28 b(b)r(o)r(olean)f(v)-5 b(alue)28 b(indicating)g(if)g
+(the)g(displa)n(y)n(ed)e(axis)h(v)-5 b(alues)28 b(should)f(b)r(e)h
+(formatted)g(according)e(to)h(the)427 4112 y(F)-7 b(ormat)30
b(attribute)g(asso)r(ciated)e(with)j(the)f(F)-7 b(rame's)29
b(axis.)43 b(Otherwise,)30 b(they)g(are)f(displa)n(y)n(ed)g(as)g
-(simple)427 1191 y(\015oating)e(p)r(oin)n(t)h(v)-5 b(alues.)259
-1328 y Fc(TTL)33 b(=)f(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1428 y Fj(A)c(title)g(to)g(displa)n
+(simple)427 4212 y(\015oating)e(p)r(oin)n(t)h(v)-5 b(alues.)259
+4340 y Fc(TTL)33 b(=)f(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 4439 y Fj(A)c(title)g(to)g(displa)n
(y)f(b)r(efore)g(displa)n(ying)g(the)h(\014rst)f(p)r(osition.)259
-1565 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 1665 y Fj(The)c(global)e(status.)p 0
-1873 3780 12 v 0 2004 a FA(AST)p Fe(_)p FA(SIMPLIFY)1384
-2005 y Fd(Simplify)37 b(a)h(Mapping)2787 2004 y FA(AST)p
-Fe(_)p FA(SIMPLIFY)0 2208 y Fc(Description:)44 b Fj(This)h(function)g
+4567 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 4667 y Fj(The)c(global)e(status.)p 0
+4857 V 0 4987 a FA(AST)p Fe(_)p FA(SIMPLIFY)1384 4988
+y Fd(Simplify)37 b(a)h(Mapping)2787 4987 y FA(AST)p Fe(_)p
+FA(SIMPLIFY)0 5172 y Fc(Description:)44 b Fj(This)h(function)g
(simpli\014es)g(a)f(Mapping)g(\(whic)n(h)h(ma)n(y)e(b)r(e)i(a)f(comp)r
-(ound)h(Mapping)f(suc)n(h)g(as)g(a)227 2307 y(CmpMap\))32
+(ound)h(Mapping)f(suc)n(h)g(as)g(a)227 5272 y(CmpMap\))32
b(to)g(eliminate)f(redundan)n(t)h(computational)e(steps,)j(or)e(to)g
(merge)g(separate)f(steps)h(whic)n(h)h(can)f(b)r(e)227
-2407 y(p)r(erformed)c(more)g(e\016cien)n(tly)h(in)g(a)f(single)g(op)r
-(eration.)227 2536 y(As)e(a)g(simple)g(example,)h(a)e(Mapping)h(whic)n
+5372 y(p)r(erformed)c(more)g(e\016cien)n(tly)h(in)g(a)f(single)g(op)r
+(eration.)227 5494 y(As)e(a)g(simple)g(example,)h(a)e(Mapping)h(whic)n
(h)g(m)n(ultiplied)h(co)r(ordinates)e(b)n(y)h(5,)g(and)g(then)h(m)n
-(ultiplied)f(the)h(result)227 2636 y(b)n(y)35 b(10,)g(could)g(b)r(e)g
+(ultiplied)f(the)h(result)227 5593 y(b)n(y)35 b(10,)g(could)g(b)r(e)g
(simpli\014ed)g(to)f(a)h(single)f(step)h(whic)n(h)f(m)n(ultiplied)i(b)n
(y)e(50.)57 b(Similarly)-7 b(,)36 b(a)e(Mapping)h(whic)n(h)227
-2735 y(m)n(ultiplied)29 b(b)n(y)e(5,)g(and)h(then)g(divided)g(b)n(y)f
+5693 y(m)n(ultiplied)29 b(b)n(y)e(5,)g(and)h(then)g(divided)g(b)n(y)f
(5,)g(could)h(b)r(e)g(reduced)f(to)g(a)g(simple)h(cop)n(ying)f(op)r
-(eration.)227 2864 y(This)21 b(function)h(should)f(t)n(ypically)g(b)r
-(e)g(applied)h(to)f(Mappings)f(whic)n(h)h(ha)n(v)n(e)f(undergone)h
-(substan)n(tial)f(pro)r(cessing)227 2964 y(or)i(ha)n(v)n(e)f(b)r(een)i
-(formed)f(b)n(y)g(merging)f(other)h(Mappings.)35 b(It)22
-b(is)h(of)f(p)r(oten)n(tial)g(b)r(ene\014t,)j(for)d(example,)h(in)f
-(reducing)227 3063 y(execution)28 b(time)g(if)g(applied)f(b)r(efore)h
-(using)f(a)g(Mapping)g(to)h(transform)e(a)h(large)g(n)n(um)n(b)r(er)g
-(of)g(co)r(ordinates.)0 3222 y Fc(In)m(v)m(o)s(cation:)123
-b Ft(RESULT)41 b(=)i(AST_SIMPLIFY\()38 b(THIS,)k(STATUS)f(\))0
-3380 y Fc(Argumen)m(ts:)259 3526 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 3626 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(original)e(Mapping.)
-259 3763 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 3863 y Fj(The)c(global)e(status.)0 4033
-y Fc(Class)31 b(Applicabilit)m(y:)259 4179 y(Mapping)427
-4279 y Fj(This)d(function)g(applies)f(to)h(all)f(Mappings.)259
-4416 y Fc(F)-8 b(rameSet)427 4516 y Fj(If)29 b(the)f(supplied)g
+(eration.)p eop end
+%%Page: 365 375
+TeXDict begin 365 374 bop 3643 52 a FG(365)227 351 y
+Fj(This)21 b(function)h(should)f(t)n(ypically)g(b)r(e)g(applied)h(to)f
+(Mappings)f(whic)n(h)h(ha)n(v)n(e)f(undergone)h(substan)n(tial)f(pro)r
+(cessing)227 451 y(or)i(ha)n(v)n(e)f(b)r(een)i(formed)f(b)n(y)g
+(merging)f(other)h(Mappings.)35 b(It)22 b(is)h(of)f(p)r(oten)n(tial)g
+(b)r(ene\014t,)j(for)d(example,)h(in)f(reducing)227 551
+y(execution)28 b(time)g(if)g(applied)f(b)r(efore)h(using)f(a)g(Mapping)
+g(to)h(transform)e(a)h(large)g(n)n(um)n(b)r(er)g(of)g(co)r(ordinates.)0
+701 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_SIMPLIFY\()
+38 b(THIS,)k(STATUS)f(\))0 852 y Fc(Argumen)m(ts:)259
+989 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1089 y
+Fj(P)n(oin)n(ter)26 b(to)i(the)g(original)e(Mapping.)259
+1222 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 1322 y Fj(The)c(global)e(status.)0 1485
+y Fc(Class)31 b(Applicabilit)m(y:)259 1622 y(Mapping)427
+1722 y Fj(This)d(function)g(applies)f(to)h(all)f(Mappings.)259
+1855 y Fc(F)-8 b(rameSet)427 1955 y Fj(If)29 b(the)f(supplied)g
(Mapping)g(is)f(a)h(F)-7 b(rameSet,)28 b(the)g(returned)g(Mapping)f
(will)h(b)r(e)h(a)e(cop)n(y)g(of)h(the)g(supplied)427
-4615 y(F)-7 b(rameSet)28 b(in)g(whic)n(h)f(all)g(the)h(in)n(ter-F)-7
+2055 y(F)-7 b(rameSet)28 b(in)g(whic)n(h)f(all)g(the)h(in)n(ter-F)-7
b(rame)27 b(Mappings)g(ha)n(v)n(e)f(b)r(een)i(simpli\014ed.)0
-4786 y Fc(Returned)k(V)-8 b(alue:)259 4932 y(AST)p Ft(_)p
-Fc(SIMPLIFY)33 b(=)f(INTEGER)427 5031 y Fj(A)c(new)g(p)r(oin)n(ter)f
+2218 y Fc(Returned)k(V)-8 b(alue:)259 2355 y(AST)p Ft(_)p
+Fc(SIMPLIFY)33 b(=)f(INTEGER)427 2455 y Fj(A)c(new)g(p)r(oin)n(ter)f
(to)h(the)g(\(p)r(ossibly)f(simpli\014ed\))h(Mapping.)0
-5202 y Fc(Notes:)340 5494 y Fi(\017)45 b Fj(This)39 b(function)g(can)g
-(safely)f(b)r(e)h(applied)g(ev)n(en)f(to)h(Mappings)f(whic)n(h)h
-(cannot)f(b)r(e)i(simpli\014ed.)71 b(If)39 b(no)427 5593
-y(simpli\014cation)30 b(is)g(p)r(ossible,)h(it)g(b)r(eha)n(v)n(es)e
-(exactly)h(lik)n(e)f(AST)p Ft(_)p Fj(CLONE)h(and)g(returns)f(a)h(p)r
-(oin)n(ter)g(to)g(the)427 5693 y(original)c(Mapping.)p
-eop end
-%%Page: 363 373
-TeXDict begin 363 372 bop 3643 52 a FG(363)340 351 y
-Fi(\017)45 b Fj(The)40 b(Mapping)g(returned)g(b)n(y)g(this)g(function)h
-(ma)n(y)e(not)h(b)r(e)h(indep)r(enden)n(t)g(of)f(the)h(original)d(\(ev)
-n(en)i(if)427 451 y(simpli\014cation)34 b(w)n(as)e(p)r(ossible\),)j
-(and)f(mo)r(difying)f(it)i(ma)n(y)d(therefore)h(result)g(in)h(indirect)
-g(mo)r(di\014cation)427 551 y(of)29 b(the)h(original.)40
-b(If)30 b(a)f(completely)g(indep)r(enden)n(t)h(result)f(is)g(required,)
-g(a)g(cop)n(y)f(should)h(b)r(e)h(made)f(using)427 650
-y(AST)p Ft(_)p Fj(COPY.)340 779 y Fi(\017)45 b Fj(A)21
-b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
-Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 878
-y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 1069 3780 12 v 0 1199
-a FA(AST)p Fe(_)p FA(SKYFRAME)1398 1200 y Fd(Create)37
-b(a)i(SkyF)-10 b(rame)2664 1199 y FA(AST)p Fe(_)p FA(SKYFRAME)0
-1380 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
-(SkyF)-7 b(rame)27 b(and)h(optionally)e(initialises)i(its)f
-(attributes.)227 1502 y(A)h(SkyF)-7 b(rame)26 b(is)h(a)f(sp)r
-(ecialised)h(form)f(of)h(F)-7 b(rame)27 b(whic)n(h)f(describ)r(es)h
-(celestial)f(longitude/latitude)h(co)r(ordinate)227 1602
-y(systems.)53 b(The)33 b(particular)f(celestial)h(co)r(ordinate)f
-(system)h(to)g(b)r(e)g(represen)n(ted)f(is)h(sp)r(eci\014ed)g(b)n(y)g
-(setting)g(the)227 1702 y(SkyF)-7 b(rame's)33 b(System)g(attribute)h
-(\(curren)n(tly)-7 b(,)34 b(the)g(default)g(is)f(ICRS\))h(quali\014ed,)
-h(as)d(necessary)-7 b(,)34 b(b)n(y)f(a)g(mean)227 1801
-y(Equino)n(x)27 b(v)-5 b(alue)27 b(and/or)f(an)h(Ep)r(o)r(c)n(h.)227
-1924 y(F)-7 b(or)28 b(eac)n(h)f(of)g(the)i(supp)r(orted)e(celestial)h
-(co)r(ordinate)e(systems,)i(a)f(SkyF)-7 b(rame)27 b(can)h(apply)f(an)h
-(optional)f(shift)i(of)227 2023 y(origin)21 b(to)h(create)f(a)h(co)r
+2618 y Fc(Notes:)340 2901 y Fi(\017)45 b Fj(Mappings)20
+b(that)g(ha)n(v)n(e)f(a)g(set)h(v)-5 b(alue)20 b(for)f(their)h(Iden)n
+(t)g(attribute)g(are)f(left)i(unc)n(hanged)e(after)h(simpli\014cation.)
+427 3001 y(This)31 b(is)f(so)g(that)h(their)f(individual)h(iden)n(tit)n
+(y)g(is)f(preserv)n(ed.)44 b(This)30 b(restriction)g(do)r(es)g(not)h
+(apply)f(to)g(the)427 3100 y(simpli\014cation)e(of)f(F)-7
+b(rames.)340 3234 y Fi(\017)45 b Fj(This)39 b(function)g(can)g(safely)f
+(b)r(e)h(applied)g(ev)n(en)f(to)h(Mappings)f(whic)n(h)h(cannot)f(b)r(e)
+i(simpli\014ed.)71 b(If)39 b(no)427 3334 y(simpli\014cation)30
+b(is)g(p)r(ossible,)h(it)g(b)r(eha)n(v)n(es)e(exactly)h(lik)n(e)f(AST)p
+Ft(_)p Fj(CLONE)h(and)g(returns)f(a)h(p)r(oin)n(ter)g(to)g(the)427
+3433 y(original)c(Mapping.)340 3567 y Fi(\017)45 b Fj(The)40
+b(Mapping)g(returned)g(b)n(y)g(this)g(function)h(ma)n(y)e(not)h(b)r(e)h
+(indep)r(enden)n(t)g(of)f(the)h(original)d(\(ev)n(en)i(if)427
+3666 y(simpli\014cation)34 b(w)n(as)e(p)r(ossible\),)j(and)f(mo)r
+(difying)f(it)i(ma)n(y)d(therefore)h(result)g(in)h(indirect)g(mo)r
+(di\014cation)427 3766 y(of)29 b(the)h(original.)40 b(If)30
+b(a)f(completely)g(indep)r(enden)n(t)h(result)f(is)g(required,)g(a)g
+(cop)n(y)f(should)h(b)r(e)h(made)f(using)427 3865 y(AST)p
+Ft(_)p Fj(COPY.)340 3999 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
+(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
+b(A)g(TUS)427 4098 y(set)28 b(to)f(an)h(error)d(v)-5
+b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
+0 4299 3780 12 v 0 4429 a FA(AST)p Fe(_)p FA(SKYFRAME)1398
+4430 y Fd(Create)37 b(a)i(SkyF)-10 b(rame)2664 4429 y
+FA(AST)p Fe(_)p FA(SKYFRAME)0 4620 y Fc(Description:)44
+b Fj(This)28 b(function)g(creates)f(a)g(new)g(SkyF)-7
+b(rame)27 b(and)h(optionally)e(initialises)i(its)f(attributes.)227
+4745 y(A)h(SkyF)-7 b(rame)26 b(is)h(a)f(sp)r(ecialised)h(form)f(of)h(F)
+-7 b(rame)27 b(whic)n(h)f(describ)r(es)h(celestial)f
+(longitude/latitude)h(co)r(ordinate)227 4845 y(systems.)53
+b(The)33 b(particular)f(celestial)h(co)r(ordinate)f(system)h(to)g(b)r
+(e)g(represen)n(ted)f(is)h(sp)r(eci\014ed)g(b)n(y)g(setting)g(the)227
+4945 y(SkyF)-7 b(rame's)33 b(System)g(attribute)h(\(curren)n(tly)-7
+b(,)34 b(the)g(default)g(is)f(ICRS\))h(quali\014ed,)h(as)d(necessary)-7
+b(,)34 b(b)n(y)f(a)g(mean)227 5044 y(Equino)n(x)27 b(v)-5
+b(alue)27 b(and/or)f(an)h(Ep)r(o)r(c)n(h.)227 5169 y(F)-7
+b(or)28 b(eac)n(h)f(of)g(the)i(supp)r(orted)e(celestial)h(co)r
+(ordinate)e(systems,)i(a)f(SkyF)-7 b(rame)27 b(can)h(apply)f(an)h
+(optional)f(shift)i(of)227 5269 y(origin)21 b(to)h(create)f(a)h(co)r
(ordinate)f(system)h(represen)n(ting)e(o\013sets)i(within)h(the)g
-(celestial)e(co)r(ordinate)g(system)h(from)227 2123 y(some)33
+(celestial)e(co)r(ordinate)g(system)h(from)227 5369 y(some)33
b(sp)r(eci\014ed)h(p)r(oin)n(t.)55 b(This)34 b(o\013set)f(co)r
(ordinate)g(system)g(can)g(also)g(b)r(e)h(rotated)f(to)g(de\014ne)h
-(new)g(longitude)227 2222 y(and)28 b(latitude)g(axes.)36
+(new)g(longitude)227 5468 y(and)28 b(latitude)g(axes.)36
b(See)27 b(attributes)h(SkyRef,)g(SkyRefIs)f(and)h(SkyRefP)227
-2345 y(All)34 b(the)f(co)r(ordinate)f(v)-5 b(alues)33
+5593 y(All)34 b(the)f(co)r(ordinate)f(v)-5 b(alues)33
b(used)g(b)n(y)g(a)g(SkyF)-7 b(rame)32 b(are)h(in)g(radians.)52
b(These)33 b(ma)n(y)g(b)r(e)g(formatted)g(in)g(more)227
-2444 y(con)n(v)n(en)n(tional)26 b(w)n(a)n(ys)g(for)h(displa)n(y)g(b)n
-(y)g(using)g(AST)p Ft(_)p Fj(F)n(ORMA)-7 b(T.)0 2589
-y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_SKYFRAME\()38
-b(OPTIONS,)j(STATUS)g(\))0 2734 y Fc(Argumen)m(ts:)259
-2866 y(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 2966 y Fj(A)22 b(c)n(haracter)e
-(string)h(con)n(taining)g(an)h(optional)f(comma-separated)e(list)j(of)g
-(attribute)g(assignmen)n(ts)f(to)g(b)r(e)427 3066 y(used)i(for)e
-(initialising)i(the)f(new)h(SkyF)-7 b(rame.)34 b(The)22
-b(syn)n(tax)g(used)g(is)g(iden)n(tical)h(to)f(that)g(for)g(the)h(AST)p
-Ft(_)p Fj(SET)427 3165 y(routine.)37 b(If)28 b(no)f(initialisation)g
-(is)h(required,)e(a)i(blank)f(v)-5 b(alue)27 b(ma)n(y)g(b)r(e)h
-(supplied.)259 3294 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)
-h(and)g(Returned\))427 3393 y Fj(The)c(global)e(status.)0
-3551 y Fc(Returned)32 b(V)-8 b(alue:)259 3683 y(AST)p
-Ft(_)p Fc(SKYFRAME)31 b(=)i(INTEGER)427 3782 y Fj(A)28
-b(p)r(oin)n(ter)f(to)h(the)g(new)g(SkyF)-7 b(rame.)0
-3940 y Fc(Examples:)227 4076 y Fy(FRAME)47 b(=)g(AST)p
-Ft(_)p Fy(SKYFRAME\()d(')k(',)f(STATUS)f(\))427 4171
-y Fj(Creates)27 b(a)g(SkyF)-7 b(rame)27 b(to)g(describ)r(e)g(the)h
+5693 y(con)n(v)n(en)n(tional)26 b(w)n(a)n(ys)g(for)h(displa)n(y)g(b)n
+(y)g(using)g(AST)p Ft(_)p Fj(F)n(ORMA)-7 b(T.)p eop end
+%%Page: 366 376
+TeXDict begin 366 375 bop 0 52 a FG(366)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(In)m(v)m(o)s(cation:)
+123 b Ft(RESULT)41 b(=)i(AST_SKYFRAME\()38 b(OPTIONS,)j(STATUS)g(\))0
+531 y Fc(Argumen)m(ts:)259 698 y(OPTIONS)32 b(=)g(CHARA)m(CTER)g
+Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
+798 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)f
+(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r(e)
+427 898 y(used)i(for)e(initialising)i(the)f(new)h(SkyF)-7
+b(rame.)34 b(The)22 b(syn)n(tax)g(used)g(is)g(iden)n(tical)h(to)f(that)
+g(for)g(the)h(AST)p Ft(_)p Fj(SET)427 997 y(routine.)37
+b(If)28 b(no)f(initialisation)g(is)h(required,)e(a)i(blank)f(v)-5
+b(alue)27 b(ma)n(y)g(b)r(e)h(supplied.)259 1145 y Fc(ST)-8
+b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+1245 y Fj(The)c(global)e(status.)0 1437 y Fc(Returned)32
+b(V)-8 b(alue:)259 1605 y(AST)p Ft(_)p Fc(SKYFRAME)31
+b(=)i(INTEGER)427 1704 y Fj(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g
+(SkyF)-7 b(rame.)0 1897 y Fc(Examples:)227 2068 y Fy(FRAME)47
+b(=)g(AST)p Ft(_)p Fy(SKYFRAME\()d(')k(',)f(STATUS)f(\))427
+2163 y Fj(Creates)27 b(a)g(SkyF)-7 b(rame)27 b(to)g(describ)r(e)g(the)h
(default)h(ICRS)e(celestial)g(co)r(ordinate)g(system.)227
-4288 y Fy(FRAME)47 b(=)g(AST)p Ft(_)p Fy(SKYFRAME\()d('System)i(=)h
+2299 y Fy(FRAME)47 b(=)g(AST)p Ft(_)p Fy(SKYFRAME\()d('System)i(=)h
(FK5,)g(Equinox)f(=)h(J2005,)f(Digits)g(=)i(10',)227
-4387 y(STATUS)e(\))427 4461 y Fj(Creates)23 b(a)g(SkyF)-7
+2399 y(STATUS)e(\))427 2473 y Fj(Creates)23 b(a)g(SkyF)-7
b(rame)23 b(to)h(describ)r(e)f(the)h(FK5)f(celestial)g(co)r(ordinate)g
-(system,)h(with)g(a)g(mean)f(Equino)n(x)g(of)427 4560
+(system,)h(with)g(a)g(mean)f(Equino)n(x)g(of)427 2572
y(J2005.0.)33 b(Because)23 b(esp)r(ecially)g(accurate)f(co)r(ordinates)
g(will)i(b)r(e)g(used,)g(additional)f(precision)g(\(10)f(digits\))427
-4660 y(has)27 b(b)r(een)h(requested.)37 b(This)27 b(will)h(b)r(e)g
+2672 y(has)27 b(b)r(een)h(requested.)37 b(This)27 b(will)h(b)r(e)g
(used)g(when)f(co)r(ordinate)g(v)-5 b(alues)27 b(are)g(formatted)g(for)
-g(displa)n(y)-7 b(.)227 4789 y Fy(FRAME)47 b(=)g(AST)p
+g(displa)n(y)-7 b(.)227 2821 y Fy(FRAME)47 b(=)g(AST)p
Ft(_)p Fy(SKYFRAME\()d('System)i(=)h(FK4,)g(Equinox)f(=)h(1955-SEP-2',)
-e(STATUS)h(\))427 4888 y Fj(Creates)32 b(a)g(SkyF)-7
+e(STATUS)h(\))427 2920 y Fj(Creates)32 b(a)g(SkyF)-7
b(rame)31 b(to)i(describ)r(e)f(the)h(old)f(FK4)g(celestial)g(co)r
(ordinate)f(system.)51 b(A)33 b(default)g(Ep)r(o)r(c)n(h)427
-4988 y(v)-5 b(alue)28 b(\(B1950.0\))d(is)j(used,)g(but)g(the)g(mean)f
+3019 y(v)-5 b(alue)28 b(\(B1950.0\))d(is)j(used,)g(but)g(the)g(mean)f
(Equino)n(x)f(v)-5 b(alue)28 b(is)f(giv)n(en)g(explicitly)h(as)f
-Ft(")p Fj(1955-SEP-2)p Ft(")p Fj(.)227 5117 y Fy(FRAME)47
+Ft(")p Fj(1955-SEP-2)p Ft(")p Fj(.)227 3168 y Fy(FRAME)47
b(=)g(AST)p Ft(_)p Fy(SKYFRAME\()d('System)i(=)h(GAPPT,)f(Epoch)h(=)g
-(')h(//)f(DATE,)f(STATUS)g(\))427 5216 y Fj(Creates)32
+(')h(//)f(DATE,)f(STATUS)g(\))427 3267 y Fj(Creates)32
b(a)h(SkyF)-7 b(rame)32 b(to)h(describ)r(e)f(the)i(Geo)r(cen)n(tric)e
(Apparen)n(t)h(celestial)f(co)r(ordinate)g(system.)53
-b(The)427 5315 y(Ep)r(o)r(c)n(h)37 b(v)-5 b(alue,)39
+b(The)427 3367 y(Ep)r(o)r(c)n(h)37 b(v)-5 b(alue,)39
b(whic)n(h)e(sp)r(eci\014es)g(the)g(date)g(of)g(observ)-5
b(ation,)38 b(is)f(obtained)f(from)h(a)f(date/time)h(string)427
-5415 y(con)n(tained)27 b(in)h(the)g(c)n(haracter)e(v)-5
-b(ariable)26 b(D)n(A)-7 b(TE.)0 5572 y Fc(Notes:)p eop
-end
-%%Page: 364 374
-TeXDict begin 364 373 bop 0 52 a FG(364)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
-b Fj(Curren)n(tly)-7 b(,)26 b(the)g(default)h(celestial)e(co)r
-(ordinate)g(system)g(is)h(ICRS.)h(Ho)n(w)n(ev)n(er,)d(this)i(default)h
-(ma)n(y)e(c)n(hange)427 451 y(in)34 b(future)g(as)f(new)h(astrometric)e
-(standards)g(ev)n(olv)n(e.)54 b(The)33 b(in)n(ten)n(tion)h(is)g(to)f
-(trac)n(k)f(the)i(most)g(mo)r(dern)427 551 y(appropriate)e(standard.)55
-b(F)-7 b(or)33 b(this)h(reason,)g(y)n(ou)f(should)g(use)h(the)g
-(default)g(only)g(if)g(this)g(is)g(what)f(y)n(ou)427
-650 y(in)n(tend)j(\(and)f(can)f(tolerate)g(an)n(y)g(asso)r(ciated)g
-(sligh)n(t)g(c)n(hange)g(in)h(b)r(eha)n(viour)f(with)h(future)h(v)n
-(ersions)d(of)427 750 y(this)d(function\).)43 b(If)30
-b(y)n(ou)e(in)n(tend)i(to)f(use)g(the)h(ICRS)f(system)h(inde\014nitely)
--7 b(,)30 b(then)g(y)n(ou)e(should)i(sp)r(ecify)f(it)427
-849 y(explicitly)f(using)f(an)h(OPTIONS)e(v)-5 b(alue)28
-b(of)f Ft(")p Fj(System=ICRS)p Ft(")p Fj(.)340 992 y
-Fi(\017)45 b Fj(Whic)n(hev)n(er)25 b(celestial)g(co)r(ordinate)f
+3466 y(con)n(tained)27 b(in)h(the)g(c)n(haracter)e(v)-5
+b(ariable)26 b(D)n(A)-7 b(TE.)0 3659 y Fc(Notes:)340
+3972 y Fi(\017)45 b Fj(Curren)n(tly)-7 b(,)26 b(the)g(default)h
+(celestial)e(co)r(ordinate)g(system)g(is)h(ICRS.)h(Ho)n(w)n(ev)n(er,)d
+(this)i(default)h(ma)n(y)e(c)n(hange)427 4071 y(in)34
+b(future)g(as)f(new)h(astrometric)e(standards)g(ev)n(olv)n(e.)54
+b(The)33 b(in)n(ten)n(tion)h(is)g(to)f(trac)n(k)f(the)i(most)g(mo)r
+(dern)427 4171 y(appropriate)e(standard.)55 b(F)-7 b(or)33
+b(this)h(reason,)g(y)n(ou)f(should)g(use)h(the)g(default)g(only)g(if)g
+(this)g(is)g(what)f(y)n(ou)427 4271 y(in)n(tend)j(\(and)f(can)f
+(tolerate)g(an)n(y)g(asso)r(ciated)g(sligh)n(t)g(c)n(hange)g(in)h(b)r
+(eha)n(viour)f(with)h(future)h(v)n(ersions)d(of)427 4370
+y(this)d(function\).)43 b(If)30 b(y)n(ou)e(in)n(tend)i(to)f(use)g(the)h
+(ICRS)f(system)h(inde\014nitely)-7 b(,)30 b(then)g(y)n(ou)e(should)i
+(sp)r(ecify)f(it)427 4470 y(explicitly)f(using)f(an)h(OPTIONS)e(v)-5
+b(alue)28 b(of)f Ft(")p Fj(System=ICRS)p Ft(")p Fj(.)340
+4618 y Fi(\017)45 b Fj(Whic)n(hev)n(er)25 b(celestial)g(co)r(ordinate)f
(system)h(is)g(represen)n(ted,)g(it)h(will)g(ha)n(v)n(e)e(t)n(w)n(o)g
-(axes.)36 b(The)25 b(\014rst)g(of)h(these)427 1091 y(will)f(b)r(e)f
+(axes.)36 b(The)25 b(\014rst)g(of)h(these)427 4718 y(will)f(b)r(e)f
(the)h(longitude)f(axis)g(and)g(the)h(second)e(will)i(b)r(e)f(the)h
(latitude)g(axis.)35 b(This)24 b(order)f(can)h(b)r(e)h(c)n(hanged)427
-1191 y(using)j(AST)p Ft(_)p Fj(PERMAXES)f(if)h(required.)340
-1333 y Fi(\017)45 b Fj(When)19 b(con)n(v)n(ersion)d(b)r(et)n(w)n(een)j
+4817 y(using)j(AST)p Ft(_)p Fj(PERMAXES)f(if)h(required.)340
+4965 y Fi(\017)45 b Fj(When)19 b(con)n(v)n(ersion)d(b)r(et)n(w)n(een)j
(t)n(w)n(o)e(SkyF)-7 b(rames)18 b(is)g(requested)g(\(as)g(when)g
(supplying)g(SkyF)-7 b(rames)18 b(AST)p Ft(_)p Fj(CONVER)-7
-b(T\),)427 1433 y(accoun)n(t)21 b(will)g(b)r(e)h(tak)n(en)e(of)i(the)f
+b(T\),)427 5065 y(accoun)n(t)21 b(will)g(b)r(e)h(tak)n(en)e(of)i(the)f
(nature)g(of)g(the)h(celestial)f(co)r(ordinate)f(systems)h(they)g
-(represen)n(t,)g(together)427 1532 y(with)26 b(an)n(y)f(qualifying)h
+(represen)n(t,)g(together)427 5165 y(with)26 b(an)n(y)f(qualifying)h
(mean)f(Equino)n(x)f(or)h(Ep)r(o)r(c)n(h)g(v)-5 b(alues,)26
b(etc.)36 b(The)26 b(AlignSystem)g(attribute)g(will)g(also)427
-1632 y(b)r(e)31 b(tak)n(en)e(in)n(to)h(accoun)n(t.)44
+5264 y(b)r(e)31 b(tak)n(en)e(in)n(to)h(accoun)n(t.)44
b(The)30 b(results)f(will)i(therefore)e(fully)i(re\015ect)e(the)i
-(relationship)e(b)r(et)n(w)n(een)h(p)r(osi-)427 1732
+(relationship)e(b)r(et)n(w)n(een)h(p)r(osi-)427 5364
y(tions)e(on)f(the)h(sky)f(measured)g(in)h(the)g(t)n(w)n(o)e(systems.)
-340 1874 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20
+340 5512 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20
b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e
(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 1974 y(set)28 b(to)f(an)h(error)d(v)-5
+b(A)g(TUS)427 5612 y(set)28 b(to)f(an)h(error)d(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-0 2192 3780 12 v 0 2323 a FA(AST)p Fe(_)p FA(SKYOFFSETMAP)1638
-2322 y Fd(Returns)39 b(a)1664 2422 y(Mapping)1613 2536
-y(whic)m(h)f(go)s(es)1771 2651 y(from)1678 2751 y(absolute)1713
-2850 y(co)s(ordi-)1685 2950 y(nates)g(to)1660 3049 y(o\013set)h(co-)
-1655 3149 y(ordinates)2319 2323 y FA(AST)p Fe(_)p FA(SKYOFFSETMAP)0
-3334 y Fc(Description:)44 b Fj(This)33 b(function)g(returns)f(a)g
+eop end
+%%Page: 367 377
+TeXDict begin 367 376 bop 3643 52 a FG(367)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(SKYOFFSETMAP)173 b Fd(Returns)39
+b(a)1664 581 y(Mapping)1613 696 y(whic)m(h)f(go)s(es)1771
+810 y(from)1678 910 y(absolute)1713 1010 y(co)s(ordi-)1685
+1109 y(nates)g(to)1660 1209 y(o\013set)h(co-)1655 1309
+y(ordinates)2319 482 y FA(AST)p Fe(_)p FA(SKYOFFSETMAP)0
+1468 y Fc(Description:)44 b Fj(This)33 b(function)g(returns)f(a)g
(Mapping)g(in)h(whic)n(h)f(the)h(forw)n(ard)e(transformation)g
-(transforms)g(a)h(p)r(o-)227 3433 y(sition)d(in)h(the)g(co)r(ordinate)e
+(transforms)g(a)h(p)r(o-)227 1568 y(sition)d(in)h(the)g(co)r(ordinate)e
(system)h(giv)n(en)g(b)n(y)g(the)g(System)h(attribute)f(of)h(the)f
-(supplied)h(SkyF)-7 b(rame,)29 b(in)n(to)g(the)227 3533
+(supplied)h(SkyF)-7 b(rame,)29 b(in)n(to)g(the)227 1667
y(o\013set)d(co)r(ordinate)f(system)g(sp)r(eci\014ed)h(b)n(y)g(the)g
(SkyRef,)g(SkyRefP)f(and)h(SkyRefIs)g(attributes)f(of)h(the)g(supplied)
-227 3632 y(SkyF)-7 b(rame.)227 3766 y(A)28 b(UnitMap)g(is)g(returned)f
+227 1767 y(SkyF)-7 b(rame.)227 1890 y(A)28 b(UnitMap)g(is)g(returned)f
(if)h(the)g(SkyF)-7 b(rame)27 b(do)r(es)g(not)h(de\014ne)g(an)f
-(o\013set)g(co)r(ordinate)g(system.)0 3935 y Fc(In)m(v)m(o)s(cation:)
+(o\013set)g(co)r(ordinate)g(system.)0 2036 y Fc(In)m(v)m(o)s(cation:)
123 b Ft(RESULT)41 b(=)i(AST_SKYOFFSETMAP)o(\()38 b(THIS,)j(STATUS)g
-(\))0 4103 y Fc(Argumen)m(ts:)259 4258 y(THIS)32 b(=)g(INTEGER)g(\(Giv)
-m(en\))427 4358 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(SkyF)-7
-b(rame.)259 4500 y Fc(ST)f(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)
-g(Returned\))427 4600 y Fj(The)c(global)e(status.)0 4781
-y Fc(Returned)32 b(V)-8 b(alue:)259 4936 y(AST)p Ft(_)p
-Fc(SKYOFFSETMAP)32 b(=)g(INTEGER)427 5036 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(returned)f(Mapping.)0 5217 y Fc(Notes:)340
-5518 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20
+(\))0 2182 y Fc(Argumen)m(ts:)259 2316 y(THIS)32 b(=)g(INTEGER)g(\(Giv)
+m(en\))427 2415 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(SkyF)-7
+b(rame.)259 2545 y Fc(ST)f(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)
+g(Returned\))427 2645 y Fj(The)c(global)e(status.)0 2804
+y Fc(Returned)32 b(V)-8 b(alue:)259 2937 y(AST)p Ft(_)p
+Fc(SKYOFFSETMAP)32 b(=)g(INTEGER)427 3037 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(returned)f(Mapping.)0 3195 y Fc(Notes:)340
+3475 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20
b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e
(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 5618 y(set)28 b(to)f(an)h(error)d(v)-5
+b(A)g(TUS)427 3574 y(set)28 b(to)f(an)h(error)d(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
+0 3767 V 0 3898 a FA(AST)p Fe(_)p FA(SLAADD)1223 3899
+y Fd(Add)39 b(a)f(celestial)f(co)s(ordinate)1259 3999
+y(con)m(v)m(ersion)f(to)i(an)h(SlaMap)2883 3898 y FA(AST)p
+Fe(_)p FA(SLAADD)0 4181 y Fc(Description:)44 b Fj(This)24
+b(routine)g(adds)f(one)h(of)g(the)g(standard)f(celestial)h(co)r
+(ordinate)f(system)h(con)n(v)n(ersions)d(pro)n(vided)i(b)n(y)227
+4281 y(the)28 b(SLALIB)g(P)n(ositional)e(Astronom)n(y)g(Library)g
+(\(Starlink)i(User)f(Note)g(SUN/67\))g(to)h(an)f(existing)g(SlaMap.)227
+4404 y(When)d(an)f(SlaMap)f(is)h(\014rst)g(created)f(\(using)h(AST)p
+Ft(_)p Fj(SLAMAP\),)g(it)h(simply)f(p)r(erforms)f(a)h(unit)g(\(n)n
+(ull\))h(Mapping.)227 4504 y(By)31 b(using)g(AST)p Ft(_)p
+Fj(SLAADD)h(\(rep)r(eatedly)f(if)h(necessary\),)e(one)h(or)f(more)h(co)
+r(ordinate)f(con)n(v)n(ersion)e(steps)j(ma)n(y)227 4603
+y(then)36 b(b)r(e)f(added,)i(whic)n(h)e(the)h(SlaMap)f(will)g(p)r
+(erform)g(in)g(sequence.)59 b(This)35 b(allo)n(ws)f(m)n(ulti-step)h
+(con)n(v)n(ersions)227 4703 y(b)r(et)n(w)n(een)20 b(a)g(v)-5
+b(ariet)n(y)18 b(of)i(celestial)g(co)r(ordinate)e(systems)i(to)f(b)r(e)
+i(assem)n(bled)e(out)g(of)h(the)g(building)h(blo)r(c)n(ks)e(pro)n
+(vided)227 4803 y(b)n(y)28 b(SLALIB.)227 4926 y(Normally)-7
+b(,)29 b(if)h(an)f(SlaMap's)g(In)n(v)n(ert)g(attribute)g(is)h(zero)e
+(\(the)i(default\),)h(then)f(its)f(forw)n(ard)f(transformation)g(is)227
+5025 y(p)r(erformed)19 b(b)n(y)f(carrying)f(out)i(eac)n(h)f(of)h(the)g
+(individual)g(co)r(ordinate)f(con)n(v)n(ersions)e(sp)r(eci\014ed)k(b)n
+(y)e(AST)p Ft(_)p Fj(SLAADD)227 5125 y(in)28 b(the)g(order)e(giv)n(en)h
+(\(i.e.)37 b(with)29 b(the)e(most)h(recen)n(tly)f(added)g(con)n(v)n
+(ersion)e(applied)j(last\).)227 5248 y(This)e(order)f(is)h(rev)n(ersed)
+f(if)h(the)h(SlaMap's)e(In)n(v)n(ert)h(attribute)g(is)g(non-zero)f
+(\(or)g(if)i(the)g(in)n(v)n(erse)d(transformation)227
+5347 y(is)j(requested)f(b)n(y)h(an)n(y)f(other)g(means\))h(and)g(eac)n
+(h)f(individual)h(co)r(ordinate)f(con)n(v)n(ersion)e(is)j(also)f
+(replaced)g(b)n(y)g(its)227 5447 y(o)n(wn)f(in)n(v)n(erse.)35
+b(This)25 b(pro)r(cess)f(in)n(v)n(erts)g(the)i(o)n(v)n(erall)d
+(e\013ect)j(of)g(the)f(SlaMap.)36 b(In)25 b(this)h(case,)f(the)h
+(\014rst)f(con)n(v)n(ersion)227 5547 y(to)j(b)r(e)g(applied)f(w)n(ould)
+g(b)r(e)h(the)g(in)n(v)n(erse)f(of)g(the)h(one)f(most)h(recen)n(tly)f
+(added.)0 5693 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42
+b(AST_SLAADD\()d(THIS,)i(CVT,)h(ARGS,)g(STATUS)f(\))p
eop end
-%%Page: 365 375
-TeXDict begin 365 374 bop 3643 52 a FG(365)p 0 351 3780
-12 v 0 482 a FA(AST)p Fe(_)p FA(SLAADD)1223 483 y Fd(Add)39
-b(a)f(celestial)f(co)s(ordinate)1259 583 y(con)m(v)m(ersion)f(to)i(an)h
-(SlaMap)2883 482 y FA(AST)p Fe(_)p FA(SLAADD)0 772 y
-Fc(Description:)44 b Fj(This)24 b(routine)g(adds)f(one)h(of)g(the)g
-(standard)f(celestial)h(co)r(ordinate)f(system)h(con)n(v)n(ersions)d
-(pro)n(vided)i(b)n(y)227 872 y(the)28 b(SLALIB)g(P)n(ositional)e
-(Astronom)n(y)g(Library)g(\(Starlink)i(User)f(Note)g(SUN/67\))g(to)h
-(an)f(existing)g(SlaMap.)227 996 y(When)d(an)f(SlaMap)f(is)h(\014rst)g
-(created)f(\(using)h(AST)p Ft(_)p Fj(SLAMAP\),)g(it)h(simply)f(p)r
-(erforms)f(a)h(unit)g(\(n)n(ull\))h(Mapping.)227 1096
-y(By)31 b(using)g(AST)p Ft(_)p Fj(SLAADD)h(\(rep)r(eatedly)f(if)h
-(necessary\),)e(one)h(or)f(more)h(co)r(ordinate)f(con)n(v)n(ersion)e
-(steps)j(ma)n(y)227 1196 y(then)36 b(b)r(e)f(added,)i(whic)n(h)e(the)h
-(SlaMap)f(will)g(p)r(erform)g(in)g(sequence.)59 b(This)35
-b(allo)n(ws)f(m)n(ulti-step)h(con)n(v)n(ersions)227 1295
-y(b)r(et)n(w)n(een)20 b(a)g(v)-5 b(ariet)n(y)18 b(of)i(celestial)g(co)r
-(ordinate)e(systems)i(to)f(b)r(e)i(assem)n(bled)e(out)g(of)h(the)g
-(building)h(blo)r(c)n(ks)e(pro)n(vided)227 1395 y(b)n(y)28
-b(SLALIB.)227 1520 y(Normally)-7 b(,)29 b(if)h(an)f(SlaMap's)g(In)n(v)n
-(ert)g(attribute)g(is)h(zero)e(\(the)i(default\),)h(then)f(its)f(forw)n
-(ard)f(transformation)g(is)227 1619 y(p)r(erformed)19
-b(b)n(y)f(carrying)f(out)i(eac)n(h)f(of)h(the)g(individual)g(co)r
-(ordinate)f(con)n(v)n(ersions)e(sp)r(eci\014ed)k(b)n(y)e(AST)p
-Ft(_)p Fj(SLAADD)227 1719 y(in)28 b(the)g(order)e(giv)n(en)h(\(i.e.)37
-b(with)29 b(the)e(most)h(recen)n(tly)f(added)g(con)n(v)n(ersion)e
-(applied)j(last\).)227 1844 y(This)e(order)f(is)h(rev)n(ersed)f(if)h
-(the)h(SlaMap's)e(In)n(v)n(ert)h(attribute)g(is)g(non-zero)f(\(or)g(if)
-i(the)g(in)n(v)n(erse)d(transformation)227 1943 y(is)j(requested)f(b)n
-(y)h(an)n(y)f(other)g(means\))h(and)g(eac)n(h)f(individual)h(co)r
-(ordinate)f(con)n(v)n(ersion)e(is)j(also)f(replaced)g(b)n(y)g(its)227
-2043 y(o)n(wn)f(in)n(v)n(erse.)35 b(This)25 b(pro)r(cess)f(in)n(v)n
-(erts)g(the)i(o)n(v)n(erall)d(e\013ect)j(of)g(the)f(SlaMap.)36
-b(In)25 b(this)h(case,)f(the)h(\014rst)f(con)n(v)n(ersion)227
-2143 y(to)j(b)r(e)g(applied)f(w)n(ould)g(b)r(e)h(the)g(in)n(v)n(erse)f
-(of)g(the)h(one)f(most)h(recen)n(tly)f(added.)0 2293
-y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_SLAADD\()d(THIS,)i
-(CVT,)h(ARGS,)g(STATUS)f(\))0 2443 y Fc(Argumen)m(ts:)259
-2580 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 2679
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(SlaMap.)259 2812 y
-Fc(CVT)k(=)h(CHARA)m(CTER)e Fi(\003)g Fc(\()h Fi(\003)g
-Fc(\))g(\(Giv)m(en\))427 2912 y Fj(A)38 b(c)n(haracter)e(string)h(whic)
-n(h)h(iden)n(ti\014es)g(the)g(celestial)f(co)r(ordinate)g(con)n(v)n
-(ersion)e(to)j(b)r(e)g(added)g(to)f(the)427 3012 y(SlaMap.)g(See)27
-b(the)h Ft(")p Fj(SLALIB)f(Con)n(v)n(ersions)p Ft(")e
-Fj(section)i(for)g(details)h(of)f(those)h(a)n(v)-5 b(ailable.)259
-3145 y Fc(AR)m(GS\()32 b Fi(\003)g Fc(\))g(=)g(DOUBLE)g(PRECISION)f
-(\(Giv)m(en\))427 3244 y Fj(An)e(arra)n(y)d(con)n(taining)h(argumen)n
-(t)g(v)-5 b(alues)28 b(for)f(the)i(celestial)e(co)r(ordinate)g(con)n(v)
-n(ersion.)37 b(The)28 b(n)n(um)n(b)r(er)g(of)427 3344
-y(argumen)n(ts)22 b(required,)h(and)g(hence)g(the)g(n)n(um)n(b)r(er)g
-(of)g(arra)n(y)e(elemen)n(ts)h(used,)i(dep)r(ends)g(on)f(the)g(con)n(v)
-n(ersion)427 3444 y(sp)r(eci\014ed)28 b(\(see)f(the)h
-Ft(")p Fj(SLALIB)f(Con)n(v)n(ersions)p Ft(")e Fj(section\).)36
-b(This)28 b(arra)n(y)d(is)i(ignored)f(if)i(no)f(argumen)n(ts)g(are)427
-3543 y(needed.)259 3676 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m
-(en)h(and)g(Returned\))427 3776 y Fj(The)c(global)e(status.)0
-3939 y Fc(Notes:)340 4222 y Fi(\017)45 b Fj(All)38 b(co)r(ordinate)d(v)
--5 b(alues)37 b(pro)r(cessed)e(b)n(y)i(an)f(SlaMap)h(are)e(in)i
-(radians.)64 b(The)36 b(\014rst)h(co)r(ordinate)f(is)g(the)427
-4321 y(celestial)27 b(longitude)h(and)f(the)h(second)f(co)r(ordinate)g
-(is)g(the)h(celestial)f(latitude.)340 4454 y Fi(\017)45
+%%Page: 368 378
+TeXDict begin 368 377 bop 0 52 a FG(368)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Argumen)m(ts:)259
+488 y(THIS)h(=)g(INTEGER)g(\(Giv)m(en\))427 588 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(SlaMap.)259 721 y Fc(CVT)k(=)h(CHARA)m(CTER)e
+Fi(\003)g Fc(\()h Fi(\003)g Fc(\))g(\(Giv)m(en\))427
+821 y Fj(A)38 b(c)n(haracter)e(string)h(whic)n(h)h(iden)n(ti\014es)g
+(the)g(celestial)f(co)r(ordinate)g(con)n(v)n(ersion)e(to)j(b)r(e)g
+(added)g(to)f(the)427 920 y(SlaMap.)g(See)27 b(the)h
+Ft(")p Fj(SLALIB)f(Con)n(v)n(ersions)p Ft(")e Fj(section)i(for)g
+(details)h(of)f(those)h(a)n(v)-5 b(ailable.)259 1053
+y Fc(AR)m(GS\()32 b Fi(\003)g Fc(\))g(=)g(DOUBLE)g(PRECISION)f(\(Giv)m
+(en\))427 1153 y Fj(An)e(arra)n(y)d(con)n(taining)h(argumen)n(t)g(v)-5
+b(alues)28 b(for)f(the)i(celestial)e(co)r(ordinate)g(con)n(v)n(ersion.)
+37 b(The)28 b(n)n(um)n(b)r(er)g(of)427 1253 y(argumen)n(ts)22
+b(required,)h(and)g(hence)g(the)g(n)n(um)n(b)r(er)g(of)g(arra)n(y)e
+(elemen)n(ts)h(used,)i(dep)r(ends)g(on)f(the)g(con)n(v)n(ersion)427
+1352 y(sp)r(eci\014ed)28 b(\(see)f(the)h Ft(")p Fj(SLALIB)f(Con)n(v)n
+(ersions)p Ft(")e Fj(section\).)36 b(This)28 b(arra)n(y)d(is)i(ignored)
+f(if)i(no)f(argumen)n(ts)g(are)427 1452 y(needed.)259
+1585 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 1685 y Fj(The)c(global)e(status.)0 1847
+y Fc(Notes:)340 2130 y Fi(\017)45 b Fj(All)38 b(co)r(ordinate)d(v)-5
+b(alues)37 b(pro)r(cessed)e(b)n(y)i(an)f(SlaMap)h(are)e(in)i(radians.)
+64 b(The)36 b(\014rst)h(co)r(ordinate)f(is)g(the)427
+2230 y(celestial)27 b(longitude)h(and)f(the)h(second)f(co)r(ordinate)g
+(is)g(the)h(celestial)f(latitude.)340 2363 y Fi(\017)45
b Fj(When)21 b(assem)n(bling)d(a)i(m)n(ulti-stage)f(con)n(v)n(ersion,)g
(it)h(can)g(sometimes)f(b)r(e)h(di\016cult)h(to)f(determine)g(the)g
-(most)427 4554 y(economical)j(con)n(v)n(ersion)e(path.)36
+(most)427 2463 y(economical)j(con)n(v)n(ersion)e(path.)36
b(F)-7 b(or)23 b(example,)h(con)n(v)n(erting)e(to)i(the)g(standard)f
-(FK5)g(co)r(ordinate)g(system)427 4654 y(as)37 b(an)h(in)n(termediate)f
+(FK5)g(co)r(ordinate)g(system)427 2562 y(as)37 b(an)h(in)n(termediate)f
(stage)g(is)g(often)h(sensible)g(in)g(form)n(ulating)f(the)h(problem,)i
-(but)e(ma)n(y)f(in)n(tro)r(duce)427 4753 y(unnecessary)31
+(but)e(ma)n(y)f(in)n(tro)r(duce)427 2662 y(unnecessary)31
b(extra)g(con)n(v)n(ersion)f(steps.)51 b(A)33 b(solution)e(to)h(this)h
(is)f(to)g(include)h(all)f(the)g(steps)g(whic)n(h)h(are)427
-4853 y(\(logically\))24 b(necessary)-7 b(,)24 b(but)h(then)g(to)g(use)f
+2762 y(\(logically\))24 b(necessary)-7 b(,)24 b(but)h(then)g(to)g(use)f
(AST)p Ft(_)p Fj(SIMPLIFY)h(to)g(simplify)g(the)g(resulting)f(SlaMap.)
-36 b(The)427 4952 y(simpli\014cation)28 b(pro)r(cess)e(will)i
+36 b(The)427 2861 y(simpli\014cation)28 b(pro)r(cess)e(will)i
(eliminate)g(an)n(y)f(steps)g(whic)n(h)h(turn)f(out)h(not)f(to)h(b)r(e)
-g(needed.)340 5086 y Fi(\017)45 b Fj(This)30 b(routine)g(do)r(es)f(not)
+g(needed.)340 2994 y Fi(\017)45 b Fj(This)30 b(routine)g(do)r(es)f(not)
h(c)n(hec)n(k)f(to)h(ensure)f(that)h(the)h(sequence)e(of)h(co)r
-(ordinate)f(con)n(v)n(ersions)e(added)j(to)427 5185 y(an)e(SlaMap)f(is)
-g(ph)n(ysically)g(meaningful.)-2 5348 y Fc(SLALIB)33
-b(Con)m(v)m(ersions)n(:)227 5494 y Fj(The)19 b(follo)n(wing)f(strings)f
+(ordinate)f(con)n(v)n(ersions)e(added)j(to)427 3094 y(an)e(SlaMap)f(is)
+g(ph)n(ysically)g(meaningful.)-2 3256 y Fc(SLALIB)33
+b(Con)m(v)m(ersions)n(:)227 3402 y Fj(The)19 b(follo)n(wing)f(strings)f
(\(whic)n(h)i(are)f(case-insensitiv)n(e\))f(ma)n(y)h(b)r(e)h(supplied)g
-(via)f(the)h(CVT)g(argumen)n(t)f(to)h(indicate)227 5593
+(via)f(the)h(CVT)g(argumen)n(t)f(to)h(indicate)227 3502
y(whic)n(h)33 b(celestial)e(co)r(ordinate)h(con)n(v)n(ersion)e(is)i(to)
g(b)r(e)h(added)f(to)h(the)f(SlaMap.)51 b(Eac)n(h)31
-b(string)h(is)g(deriv)n(ed)g(from)227 5693 y(the)k(name)g(of)f(the)h
+b(string)h(is)g(deriv)n(ed)g(from)227 3602 y(the)k(name)g(of)f(the)h
(SLALIB)g(routine)f(that)h(p)r(erforms)e(the)i(con)n(v)n(ersion)e(and)h
-(the)h(relev)-5 b(an)n(t)35 b(do)r(cumen)n(tation)p eop
-end
-%%Page: 366 376
-TeXDict begin 366 375 bop 0 52 a FG(366)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)227 351 y Fj(\(SUN/67\))h(should)g
-(b)r(e)g(consulted)g(for)f(details.)50 b(Where)32 b(argumen)n(ts)f(are)
-g(needed)h(b)n(y)f(the)i(con)n(v)n(ersion,)d(they)227
-451 y(are)d(listed)i(in)f(paren)n(theses.)37 b(V)-7 b(alues)28
-b(for)f(these)h(argumen)n(ts)f(should)h(b)r(e)g(giv)n(en,)g(via)f(the)i
-(AR)n(GS)f(arra)n(y)-7 b(,)26 b(in)i(the)227 551 y(order)k(indicated.)
-52 b(The)33 b(argumen)n(t)e(names)h(matc)n(h)h(the)g(corresp)r(onding)d
-(SLALIB)j(routine)f(argumen)n(ts)g(and)227 650 y(their)f(v)-5
-b(alues)30 b(should)h(b)r(e)g(giv)n(en)e(using)i(exactly)f(the)h(same)f
-(units,)i(time)f(scale,)f(calendar,)h(etc.)46 b(as)30
-b(describ)r(ed)227 750 y(in)e(SUN/67:)340 1010 y Fi(\017)45
-b Ft(")p Fj(ADDET)p Ft(")28 b Fj(\(EQ\):)f(Add)h(E-terms)f(of)g(ab)r
-(erration.)340 1142 y Fi(\017)45 b Ft(")p Fj(SUBET)p
+(the)h(relev)-5 b(an)n(t)35 b(do)r(cumen)n(tation)227
+3701 y(\(SUN/67\))d(should)g(b)r(e)g(consulted)g(for)f(details.)50
+b(Where)32 b(argumen)n(ts)f(are)g(needed)h(b)n(y)f(the)i(con)n(v)n
+(ersion,)d(they)227 3801 y(are)d(listed)i(in)f(paren)n(theses.)37
+b(V)-7 b(alues)28 b(for)f(these)h(argumen)n(ts)f(should)h(b)r(e)g(giv)n
+(en,)g(via)f(the)i(AR)n(GS)f(arra)n(y)-7 b(,)26 b(in)i(the)227
+3901 y(order)k(indicated.)52 b(The)33 b(argumen)n(t)e(names)h(matc)n(h)
+h(the)g(corresp)r(onding)d(SLALIB)j(routine)f(argumen)n(ts)g(and)227
+4000 y(their)f(v)-5 b(alues)30 b(should)h(b)r(e)g(giv)n(en)e(using)i
+(exactly)f(the)h(same)f(units,)i(time)f(scale,)f(calendar,)h(etc.)46
+b(as)30 b(describ)r(ed)227 4100 y(in)e(SUN/67:)340 4362
+y Fi(\017)45 b Ft(")p Fj(ADDET)p Ft(")28 b Fj(\(EQ\):)f(Add)h(E-terms)f
+(of)g(ab)r(erration.)340 4495 y Fi(\017)45 b Ft(")p Fj(SUBET)p
Ft(")27 b Fj(\(EQ\):)g(Subtract)h(E-terms)e(of)i(ab)r(erration.)340
-1274 y Fi(\017)45 b Ft(")p Fj(PREBN)p Ft(")26 b Fj(\(BEP0,BEP1\):)35
+4628 y Fi(\017)45 b Ft(")p Fj(PREBN)p Ft(")26 b Fj(\(BEP0,BEP1\):)35
b(Apply)28 b(Bessel-New)n(com)n(b)d(pre-IA)n(U)i(1976)f(\(FK4\))i
-(precession)e(mo)r(del.)340 1407 y Fi(\017)45 b Ft(")p
+(precession)e(mo)r(del.)340 4761 y Fi(\017)45 b Ft(")p
Fj(PREC)p Ft(")26 b Fj(\(EP0,EP1\):)35 b(Apply)28 b(IA)n(U)g(1975)d
-(\(FK5\))j(precession)e(mo)r(del.)340 1539 y Fi(\017)45
+(\(FK5\))j(precession)e(mo)r(del.)340 4894 y Fi(\017)45
b Ft(")p Fj(FK45Z)p Ft(")26 b Fj(\(BEPOCH\):)h(Con)n(v)n(ert)f(FK4)h
(to)g(FK5)g(\(no)h(prop)r(er)e(motion)i(or)e(parallax\).)340
-1671 y Fi(\017)45 b Ft(")p Fj(FK54Z)p Ft(")26 b Fj(\(BEPOCH\):)h(Con)n
+5027 y Fi(\017)45 b Ft(")p Fj(FK54Z)p Ft(")26 b Fj(\(BEPOCH\):)h(Con)n
(v)n(ert)f(FK5)h(to)g(FK4)g(\(no)h(prop)r(er)e(motion)i(or)e
-(parallax\).)340 1803 y Fi(\017)45 b Ft(")p Fj(AMP)p
+(parallax\).)340 5160 y Fi(\017)45 b Ft(")p Fj(AMP)p
Ft(")27 b Fj(\(D)n(A)-7 b(TE,EQ\):)27 b(Con)n(v)n(ert)g(geo)r(cen)n
-(tric)f(apparen)n(t)g(to)i(mean)f(place.)340 1936 y Fi(\017)45
+(tric)f(apparen)n(t)g(to)i(mean)f(place.)340 5294 y Fi(\017)45
b Ft(")p Fj(MAP)p Ft(")27 b Fj(\(EQ,D)n(A)-7 b(TE\):)27
b(Con)n(v)n(ert)g(mean)g(place)g(to)h(geo)r(cen)n(tric)e(apparen)n(t.)
-340 2068 y Fi(\017)45 b Ft(")p Fj(ECLEQ)p Ft(")26 b Fj(\(D)n(A)-7
+340 5427 y Fi(\017)45 b Ft(")p Fj(ECLEQ)p Ft(")26 b Fj(\(D)n(A)-7
b(TE\):)28 b(Con)n(v)n(ert)e(ecliptic)i(co)r(ordinates)e(to)i(FK5)f
-(J2000.0)d(equatorial.)340 2200 y Fi(\017)45 b Ft(")p
+(J2000.0)d(equatorial.)340 5560 y Fi(\017)45 b Ft(")p
Fj(EQECL)p Ft(")26 b Fj(\(D)n(A)-7 b(TE\):)28 b(Con)n(v)n(ert)e
(equatorial)g(FK5)h(J2000.0)e(to)i(ecliptic)h(co)r(ordinates.)340
-2332 y Fi(\017)45 b Ft(")p Fj(GALEQ)p Ft(")p Fj(:)36
+5693 y Fi(\017)45 b Ft(")p Fj(GALEQ)p Ft(")p Fj(:)36
b(Con)n(v)n(ert)26 b(galactic)g(co)r(ordinates)h(to)g(FK5)g(J2000.0)e
-(equatorial.)340 2465 y Fi(\017)45 b Ft(")p Fj(EQGAL)p
-Ft(")p Fj(:)36 b(Con)n(v)n(ert)26 b(FK5)h(J2000.0)e(equatorial)h(to)h
-(galactic)g(co)r(ordinates.)340 2597 y Fi(\017)45 b Ft(")p
-Fj(HFK5Z)p Ft(")26 b Fj(\(JEPOCH\):)h(Con)n(v)n(ert)f(ICRS)i(co)r
-(ordinates)e(to)i(FK5)f(J2000.0)e(equatorial.)340 2729
-y Fi(\017)45 b Ft(")p Fj(FK5HZ)p Ft(")26 b Fj(\(JEPOCH\):)h(Con)n(v)n
-(ert)f(FK5)h(J2000.0)e(equatorial)h(co)r(ordinates)g(to)i(ICRS.)340
-2861 y Fi(\017)45 b Ft(")p Fj(GALSUP)p Ft(")p Fj(:)37
+(equatorial.)p eop end
+%%Page: 369 379
+TeXDict begin 369 378 bop 3643 52 a FG(369)340 351 y
+Fi(\017)45 b Ft(")p Fj(EQGAL)p Ft(")p Fj(:)36 b(Con)n(v)n(ert)26
+b(FK5)h(J2000.0)e(equatorial)h(to)h(galactic)g(co)r(ordinates.)340
+474 y Fi(\017)45 b Ft(")p Fj(HFK5Z)p Ft(")26 b Fj(\(JEPOCH\):)h(Con)n
+(v)n(ert)f(ICRS)i(co)r(ordinates)e(to)i(FK5)f(J2000.0)e(equatorial.)340
+597 y Fi(\017)45 b Ft(")p Fj(FK5HZ)p Ft(")26 b Fj(\(JEPOCH\):)h(Con)n
+(v)n(ert)f(FK5)h(J2000.0)e(equatorial)h(co)r(ordinates)g(to)i(ICRS.)340
+720 y Fi(\017)45 b Ft(")p Fj(GALSUP)p Ft(")p Fj(:)37
b(Con)n(v)n(ert)26 b(galactic)g(to)i(sup)r(ergalactic)e(co)r
-(ordinates.)340 2994 y Fi(\017)45 b Ft(")p Fj(SUPGAL)p
+(ordinates.)340 842 y Fi(\017)45 b Ft(")p Fj(SUPGAL)p
Ft(")p Fj(:)37 b(Con)n(v)n(ert)26 b(sup)r(ergalactic)g(co)r(ordinates)g
-(to)i(galactic.)340 3126 y Fi(\017)45 b Ft(")p Fj(J2000H)p
+(to)i(galactic.)340 965 y Fi(\017)45 b Ft(")p Fj(J2000H)p
Ft(")p Fj(:)34 b(Con)n(v)n(ert)27 b(dynamical)g(J2000.0)d(to)k(ICRS.)
-340 3258 y Fi(\017)45 b Ft(")p Fj(HJ2000)p Ft(")p Fj(:)34
+340 1088 y Fi(\017)45 b Ft(")p Fj(HJ2000)p Ft(")p Fj(:)34
b(Con)n(v)n(ert)27 b(ICRS)g(to)h(dynamical)f(J2000.0.)340
-3390 y Fi(\017)45 b Ft(")p Fj(R2H)p Ft(")27 b Fj(\(LAST\):)i(Con)n(v)n
-(ert)d(RA)i(to)f(Hour)g(Angle.)340 3523 y Fi(\017)45
+1211 y Fi(\017)45 b Ft(")p Fj(R2H)p Ft(")27 b Fj(\(LAST\):)i(Con)n(v)n
+(ert)d(RA)i(to)f(Hour)g(Angle.)340 1334 y Fi(\017)45
b Ft(")p Fj(H2R)p Ft(")27 b Fj(\(LAST\):)i(Con)n(v)n(ert)d(Hour)h
-(Angle)g(to)h(RA.)227 3684 y(F)-7 b(or)36 b(example,)j(to)e(use)f(the)i
+(Angle)g(to)h(RA.)227 1485 y(F)-7 b(or)36 b(example,)j(to)e(use)f(the)i
Ft(")p Fj(ADDET)p Ft(")e Fj(con)n(v)n(ersion,)h(whic)n(h)g(tak)n(es)f
(a)g(single)g(argumen)n(t)g(EQ,)g(y)n(ou)g(should)227
-3783 y(consult)c(the)g(do)r(cumen)n(tation)g(for)f(the)i(SLALIB)f
+1585 y(consult)c(the)g(do)r(cumen)n(tation)g(for)f(the)i(SLALIB)f
(routine)f(SLA)p Ft(_)p Fj(ADDET.)h(This)g(describ)r(es)g(the)g(con)n
-(v)n(ersion)227 3883 y(in)e(detail)f(and)h(sho)n(ws)e(that)i(EQ)e(is)i
+(v)n(ersion)227 1685 y(in)e(detail)f(and)h(sho)n(ws)e(that)i(EQ)e(is)i
(the)f(Besselian)g(ep)r(o)r(c)n(h)g(of)g(the)h(mean)f(equator)g(and)g
-(equino)n(x.)41 b(This)30 b(v)-5 b(alue)227 3983 y(should)28
+(equino)n(x.)41 b(This)30 b(v)-5 b(alue)227 1784 y(should)28
b(then)g(b)r(e)g(supplied)g(to)f(AST)p Ft(_)p Fj(SLAADD)i(in)f(AR)n
-(GS\(1\).)227 4107 y(In)40 b(addition)g(the)g(follo)n(wing)e(strings)h
+(GS\(1\).)227 1904 y(In)40 b(addition)g(the)g(follo)n(wing)e(strings)h
(ma)n(y)g(b)r(e)h(supplied)g(for)f(more)g(complex)g(con)n(v)n(ersions)e
-(whic)n(h)i(do)h(not)227 4207 y(corresp)r(ond)30 b(to)h(an)n(y)g(one)g
+(whic)n(h)i(do)h(not)227 2004 y(corresp)r(ond)30 b(to)h(an)n(y)g(one)g
(single)g(SLALIB)g(routine)g(\(DIURAB)i(is)e(the)h(magnitude)f(of)h
-(the)f(diurnal)g(ab)r(erra-)227 4306 y(tion)j(v)n(ector)e(in)h(units)h
+(the)f(diurnal)g(ab)r(erra-)227 2103 y(tion)j(v)n(ector)e(in)h(units)h
(of)f Ft(")p Fj(da)n(y/\(2.PI\))p Ft(")p Fj(,)f(D)n(A)-7
b(TE)34 b(is)f(the)h(Mo)r(di\014ed)f(Julian)g(Date)h(of)f(the)g(observ)
--5 b(ation,)34 b(and)227 4406 y(\(OBSX,OBSY,OBZ\))k(are)f(the)i(Helio)r
+-5 b(ation,)34 b(and)227 2203 y(\(OBSX,OBSY,OBZ\))k(are)f(the)i(Helio)r
(cen)n(tric-Aries-Ecliptic)d(cartesian)h(co)r(ordinates,)j(in)e
-(metres,)j(of)d(the)227 4505 y(observ)n(er\):)340 4766
+(metres,)j(of)d(the)227 2302 y(observ)n(er\):)340 2548
y Fi(\017)45 b Ft(")p Fj(HPCEQ)p Ft(")38 b Fj(\(D)n(A)-7
b(TE,OBSX,OBSY,OBSZ\):)39 b(Con)n(v)n(ert)f(Heliopro)5
-b(jectiv)n(e-Cartesian)36 b(co)r(ordinates)i(to)427 4865
-y(J2000.0)25 b(equatorial.)340 4997 y Fi(\017)45 b Ft(")p
+b(jectiv)n(e-Cartesian)36 b(co)r(ordinates)i(to)427 2648
+y(J2000.0)25 b(equatorial.)340 2771 y Fi(\017)45 b Ft(")p
Fj(EQHPC)p Ft(")17 b Fj(\(D)n(A)-7 b(TE,OBSX,OBSY,OBSZ\):)18
b(Con)n(v)n(ert)f(J2000.0)e(equatorial)i(co)r(ordinates)g(to)h
-(Heliopro)5 b(jectiv)n(e-)427 5097 y(Cartesian.)340 5229
+(Heliopro)5 b(jectiv)n(e-)427 2870 y(Cartesian.)340 2993
y Fi(\017)45 b Ft(")p Fj(HPREQ)p Ft(")17 b Fj(\(D)n(A)-7
b(TE,OBSX,OBSY,OBSZ\):)18 b(Con)n(v)n(ert)f(Heliopro)5
b(jectiv)n(e-Radial)16 b(co)r(ordinates)h(to)h(J2000.0)427
-5329 y(equatorial.)340 5461 y Fi(\017)45 b Ft(")p Fj(EQHPR)p
+3093 y(equatorial.)340 3216 y Fi(\017)45 b Ft(")p Fj(EQHPR)p
Ft(")17 b Fj(\(D)n(A)-7 b(TE,OBSX,OBSY,OBSZ\):)18 b(Con)n(v)n(ert)f
(J2000.0)f(equatorial)g(co)r(ordinates)h(to)h(Heliopro)5
-b(jectiv)n(e-)427 5561 y(Radial.)340 5693 y Fi(\017)45
+b(jectiv)n(e-)427 3315 y(Radial.)340 3438 y Fi(\017)45
b Ft(")p Fj(HEEQ)p Ft(")26 b Fj(\(D)n(A)-7 b(TE\):)28
b(Con)n(v)n(ert)e(helio-ecliptic)i(co)r(ordinates)e(to)h(J2000.0)e
-(equatorial.)p eop end
-%%Page: 367 377
-TeXDict begin 367 376 bop 3643 52 a FG(367)340 351 y
-Fi(\017)45 b Ft(")p Fj(EQHE)p Ft(")26 b Fj(\(D)n(A)-7
-b(TE\):)28 b(Con)n(v)n(ert)e(J2000.0)f(equatorial)h(co)r(ordinates)g
-(to)i(helio-ecliptic.)340 504 y Fi(\017)45 b Ft(")p Fj(H2E)p
-Ft(")26 b Fj(\(LA)-7 b(T,DIR)n(UAB\):)30 b(Con)n(v)n(ert)c(horizon)g
-(co)r(ordinates)g(to)i(equatorial.)340 657 y Fi(\017)45
-b Ft(")p Fj(E2H)p Ft(")26 b Fj(\(LA)-7 b(T,DIURAB\):)30
-b(Con)n(v)n(ert)c(equatorial)g(co)r(ordinates)g(to)i(horizon.)227
-860 y(Note,)40 b(the)e Ft(")p Fj(H2E)p Ft(")e Fj(and)i
-Ft(")p Fj(E2H)p Ft(")e Fj(con)n(v)n(ersions)f(con)n(v)n(ert)h(b)r(et)n
-(w)n(een)i(top)r(o)r(cen)n(tric)f(horizon)f(co)r(ordinates)g(\(az-)227
-959 y(im)n(uth,elev)-5 b(ation\),)39 b(and)d(apparen)n(t)f(lo)r(cal)h
+(equatorial.)340 3561 y Fi(\017)45 b Ft(")p Fj(EQHE)p
+Ft(")26 b Fj(\(D)n(A)-7 b(TE\):)28 b(Con)n(v)n(ert)e(J2000.0)f
+(equatorial)h(co)r(ordinates)g(to)i(helio-ecliptic.)340
+3684 y Fi(\017)45 b Ft(")p Fj(H2E)p Ft(")26 b Fj(\(LA)-7
+b(T,DIR)n(UAB\):)30 b(Con)n(v)n(ert)c(horizon)g(co)r(ordinates)g(to)i
+(equatorial.)340 3806 y Fi(\017)45 b Ft(")p Fj(E2H)p
+Ft(")26 b Fj(\(LA)-7 b(T,DIURAB\):)30 b(Con)n(v)n(ert)c(equatorial)g
+(co)r(ordinates)g(to)i(horizon.)227 3958 y(Note,)40 b(the)e
+Ft(")p Fj(H2E)p Ft(")e Fj(and)i Ft(")p Fj(E2H)p Ft(")e
+Fj(con)n(v)n(ersions)f(con)n(v)n(ert)h(b)r(et)n(w)n(een)i(top)r(o)r
+(cen)n(tric)f(horizon)f(co)r(ordinates)g(\(az-)227 4058
+y(im)n(uth,elev)-5 b(ation\),)39 b(and)d(apparen)n(t)f(lo)r(cal)h
(equatorial)e(co)r(ordinates)h(\(hour)h(angle,declination\).)61
-b(Th)n(us,)38 b(the)227 1059 y(e\013ects)g(of)f(diurnal)g(ab)r
+b(Th)n(us,)38 b(the)227 4157 y(e\013ects)g(of)f(diurnal)g(ab)r
(erration)f(are)g(tak)n(en)h(in)n(to)g(accoun)n(t)f(in)i(the)f(con)n(v)
-n(ersions)e(but)j(the)g(e\013ects)f(of)g(atmo-)227 1158
-y(spheric)27 b(refraction)g(are)f(not.)p 0 1398 3780
-12 v 0 1529 a FA(AST)p Fe(_)p FA(SLAMAP)1426 1530 y Fd(Create)38
-b(an)g(SlaMap)2870 1529 y FA(AST)p Fe(_)p FA(SLAMAP)0
-1759 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+n(ersions)e(but)j(the)g(e\013ects)f(of)g(atmo-)227 4257
+y(spheric)27 b(refraction)g(are)f(not.)p 0 4436 3780
+12 v 0 4567 a FA(AST)p Fe(_)p FA(SLAMAP)1426 4568 y Fd(Create)38
+b(an)g(SlaMap)2870 4567 y FA(AST)p Fe(_)p FA(SLAMAP)0
+4737 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
(SlaMap)g(and)h(optionally)f(initialises)g(its)h(attributes.)227
-1904 y(An)19 b(SlaMap)f(is)g(a)g(sp)r(ecialised)g(form)g(of)h(Mapping)f
+4856 y(An)19 b(SlaMap)f(is)g(a)g(sp)r(ecialised)g(form)g(of)h(Mapping)f
(whic)n(h)g(can)g(b)r(e)h(used)f(to)h(represen)n(t)e(a)h(sequence)g(of)
-g(con)n(v)n(ersions)227 2003 y(b)r(et)n(w)n(een)28 b(standard)e
+g(con)n(v)n(ersions)227 4956 y(b)r(et)n(w)n(een)28 b(standard)e
(celestial)i(\(longitude,)f(latitude\))i(co)r(ordinate)d(systems.)227
-2148 y(When)e(an)e(SlaMap)h(is)g(\014rst)f(created,)h(it)h(simply)f(p)r
+5075 y(When)e(an)e(SlaMap)h(is)g(\014rst)f(created,)h(it)h(simply)f(p)r
(erforms)f(a)g(unit)i(\(n)n(ull\))f(Mapping)g(on)f(a)h(pair)f(of)h(co)r
-(ordinates.)227 2248 y(Using)39 b(the)g(AST)p Ft(_)p
+(ordinates.)227 5175 y(Using)39 b(the)g(AST)p Ft(_)p
Fj(SLAADD)h(routine,)h(a)e(series)f(of)g(co)r(ordinate)g(con)n(v)n
(ersion)e(steps)j(ma)n(y)f(then)h(b)r(e)h(added,)227
-2347 y(selected)34 b(from)f(those)h(pro)n(vided)e(b)n(y)i(the)g(SLALIB)
+5275 y(selected)34 b(from)f(those)h(pro)n(vided)e(b)n(y)i(the)g(SLALIB)
g(P)n(ositional)e(Astronom)n(y)g(Library)h(\(Starlink)g(User)h(Note)227
-2447 y(SUN/67\).)44 b(This)30 b(allo)n(ws)e(m)n(ulti-step)i(con)n(v)n
+5374 y(SUN/67\).)44 b(This)30 b(allo)n(ws)e(m)n(ulti-step)i(con)n(v)n
(ersions)e(b)r(et)n(w)n(een)i(a)f(v)-5 b(ariet)n(y)29
-b(of)h(celestial)g(co)r(ordinate)e(systems)i(to)227 2546
+b(of)h(celestial)g(co)r(ordinate)e(systems)i(to)227 5474
y(b)r(e)e(assem)n(bled)f(out)h(of)f(the)h(building)g(blo)r(c)n(ks)f
-(pro)n(vided)f(b)n(y)i(SLALIB.)227 2691 y(F)-7 b(or)18
+(pro)n(vided)f(b)n(y)i(SLALIB.)227 5593 y(F)-7 b(or)18
b(details)g(of)g(the)h(individual)g(co)r(ordinate)e(con)n(v)n(ersions)f
(a)n(v)-5 b(ailable,)19 b(see)f(the)h(description)e(of)i(the)f(AST)p
-Ft(_)p Fj(SLAADD)227 2791 y(routine.)0 2981 y Fc(In)m(v)m(o)s(cation:)
+Ft(_)p Fj(SLAADD)227 5693 y(routine.)p eop end
+%%Page: 370 380
+TeXDict begin 370 379 bop 0 52 a FG(370)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(In)m(v)m(o)s(cation:)
123 b Ft(RESULT)41 b(=)i(AST_SLAMAP\()c(FLAGS,)i(OPTIONS,)f(STATUS)i
-(\))0 3170 y Fc(Argumen)m(ts:)259 3347 y(FLA)m(GS)33
-b(=)f(INTEGER)f(\(Giv)m(en\))427 3447 y Fj(This)d(argumen)n(t)e(is)i
-(reserv)n(ed)e(for)h(future)h(use)f(and)h(should)f(curren)n(tly)g(alw)n
-(a)n(ys)e(b)r(e)j(set)g(to)f(zero.)259 3600 y Fc(OPTIONS)32
-b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))
-427 3699 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h
-(optional)f(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f
-(to)g(b)r(e)427 3799 y(used)29 b(for)e(initialising)h(the)h(new)f
-(SlaMap.)39 b(The)28 b(syn)n(tax)f(used)i(is)f(iden)n(tical)g(to)g
-(that)h(for)e(the)i(AST)p Ft(_)p Fj(SET)427 3899 y(routine.)37
-b(If)28 b(no)f(initialisation)g(is)h(required,)e(a)i(blank)f(v)-5
-b(alue)27 b(ma)n(y)g(b)r(e)h(supplied.)259 4052 y Fc(ST)-8
+(\))0 511 y Fc(Argumen)m(ts:)259 658 y(FLA)m(GS)33 b(=)f(INTEGER)f
+(\(Giv)m(en\))427 757 y Fj(This)d(argumen)n(t)e(is)i(reserv)n(ed)e(for)
+h(future)h(use)f(and)h(should)f(curren)n(tly)g(alw)n(a)n(ys)e(b)r(e)j
+(set)g(to)f(zero.)259 895 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g
+Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
+995 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)f
+(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r(e)
+427 1094 y(used)29 b(for)e(initialising)h(the)h(new)f(SlaMap.)39
+b(The)28 b(syn)n(tax)f(used)i(is)f(iden)n(tical)g(to)g(that)h(for)e
+(the)i(AST)p Ft(_)p Fj(SET)427 1194 y(routine.)37 b(If)28
+b(no)f(initialisation)g(is)h(required,)e(a)i(blank)f(v)-5
+b(alue)27 b(ma)n(y)g(b)r(e)h(supplied.)259 1332 y Fc(ST)-8
b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-4151 y Fj(The)c(global)e(status.)0 4353 y Fc(Returned)32
-b(V)-8 b(alue:)259 4530 y(AST)p Ft(_)p Fc(SLAMAP)33 b(=)f(INTEGER)427
-4630 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(SlaMap.)0
-4832 y Fc(Notes:)340 5155 y Fi(\017)45 b Fj(The)32 b(Nin)g(and)f(Nout)h
+1432 y Fj(The)c(global)e(status.)0 1604 y Fc(Returned)32
+b(V)-8 b(alue:)259 1750 y(AST)p Ft(_)p Fc(SLAMAP)33 b(=)f(INTEGER)427
+1850 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(SlaMap.)0
+2022 y Fc(Notes:)340 2315 y Fi(\017)45 b Fj(The)32 b(Nin)g(and)f(Nout)h
(attributes)f(\(n)n(um)n(b)r(er)h(of)f(input)i(and)e(output)h(co)r
-(ordinates\))e(for)h(an)h(SlaMap)f(are)427 5255 y(b)r(oth)g(equal)e(to)
+(ordinates\))e(for)h(an)h(SlaMap)f(are)427 2414 y(b)r(oth)g(equal)e(to)
h(2.)44 b(The)30 b(\014rst)g(co)r(ordinate)f(is)h(the)h(celestial)e
(longitude)h(and)g(the)g(second)g(co)r(ordinate)f(is)427
-5354 y(the)f(celestial)f(latitude.)38 b(All)28 b(co)r(ordinate)e(v)-5
-b(alues)27 b(are)g(in)h(radians.)340 5507 y Fi(\017)45
+2514 y(the)f(celestial)f(latitude.)38 b(All)28 b(co)r(ordinate)e(v)-5
+b(alues)27 b(are)g(in)h(radians.)340 2652 y Fi(\017)45
b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 5607
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 2752
y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p eop end
-%%Page: 368 378
-TeXDict begin 368 377 bop 0 52 a FG(368)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(SPECADD)1224 483 y Fd(Add)39
-b(a)g(sp)s(ectral)f(co)s(ordinate)1251 596 y(con)m(v)m(ersion)e(to)i(a)
-h(Sp)s(ecMap)2788 482 y FA(AST)p Fe(_)p FA(SPECADD)0
-774 y Fc(Description:)44 b Fj(This)24 b(routine)g(adds)g(one)g(of)g
-(the)g(standard)g(sp)r(ectral)f(co)r(ordinate)g(system)h(con)n(v)n
-(ersions)e(listed)i(b)r(elo)n(w)227 874 y(to)k(an)f(existing)g(Sp)r
-(ecMap.)227 996 y(When)j(a)e(Sp)r(ecMap)h(is)g(\014rst)f(created)g
-(\(using)h(AST)p Ft(_)p Fj(SPECMAP\),)f(it)i(simply)f(p)r(erforms)f(a)g
-(unit)i(\(n)n(ull\))f(Map-)227 1095 y(ping.)35 b(By)23
-b(using)g(AST)p Ft(_)p Fj(SPECADD)g(\(rep)r(eatedly)f(if)i
-(necessary\),)e(one)g(or)g(more)h(co)r(ordinate)e(con)n(v)n(ersion)g
-(steps)227 1195 y(ma)n(y)29 b(then)g(b)r(e)h(added,)g(whic)n(h)f(the)g
-(Sp)r(ecMap)h(will)f(p)r(erform)g(in)g(sequence.)41 b(This)29
-b(allo)n(ws)f(m)n(ulti-step)i(con)n(v)n(er-)227 1294
-y(sions)f(b)r(et)n(w)n(een)g(a)g(v)-5 b(ariet)n(y)28
-b(of)h(sp)r(ectral)g(co)r(ordinate)f(systems)g(to)h(b)r(e)h(assem)n
-(bled)e(out)h(of)g(the)h(building)f(blo)r(c)n(ks)227
-1394 y(pro)n(vided)e(b)n(y)g(this)h(class.)227 1516 y(Normally)-7
+(fail)h(for)f(an)n(y)g(reason.)p 0 2961 3780 12 v 0 3092
+a FA(AST)p Fe(_)p FA(SPECADD)1224 3093 y Fd(Add)39 b(a)g(sp)s(ectral)f
+(co)s(ordinate)1251 3206 y(con)m(v)m(ersion)e(to)i(a)h(Sp)s(ecMap)2788
+3092 y FA(AST)p Fe(_)p FA(SPECADD)0 3405 y Fc(Description:)44
+b Fj(This)24 b(routine)g(adds)g(one)g(of)g(the)g(standard)g(sp)r
+(ectral)f(co)r(ordinate)g(system)h(con)n(v)n(ersions)e(listed)i(b)r
+(elo)n(w)227 3505 y(to)k(an)f(existing)g(Sp)r(ecMap.)227
+3634 y(When)j(a)e(Sp)r(ecMap)h(is)g(\014rst)f(created)g(\(using)h(AST)p
+Ft(_)p Fj(SPECMAP\),)f(it)i(simply)f(p)r(erforms)f(a)g(unit)i(\(n)n
+(ull\))f(Map-)227 3734 y(ping.)35 b(By)23 b(using)g(AST)p
+Ft(_)p Fj(SPECADD)g(\(rep)r(eatedly)f(if)i(necessary\),)e(one)g(or)g
+(more)h(co)r(ordinate)e(con)n(v)n(ersion)g(steps)227
+3834 y(ma)n(y)29 b(then)g(b)r(e)h(added,)g(whic)n(h)f(the)g(Sp)r(ecMap)
+h(will)f(p)r(erform)g(in)g(sequence.)41 b(This)29 b(allo)n(ws)f(m)n
+(ulti-step)i(con)n(v)n(er-)227 3933 y(sions)f(b)r(et)n(w)n(een)g(a)g(v)
+-5 b(ariet)n(y)28 b(of)h(sp)r(ectral)g(co)r(ordinate)f(systems)g(to)h
+(b)r(e)h(assem)n(bled)e(out)h(of)g(the)h(building)f(blo)r(c)n(ks)227
+4033 y(pro)n(vided)e(b)n(y)g(this)h(class.)227 4162 y(Normally)-7
b(,)28 b(if)h(a)g(Sp)r(ecMap's)f(In)n(v)n(ert)g(attribute)h(is)f(zero)g
(\(the)h(default\),)h(then)f(its)g(forw)n(ard)e(transformation)g(is)227
-1615 y(p)r(erformed)18 b(b)n(y)g(carrying)f(out)h(eac)n(h)g(of)g(the)h
+4262 y(p)r(erformed)18 b(b)n(y)g(carrying)f(out)h(eac)n(h)g(of)g(the)h
(individual)f(co)r(ordinate)f(con)n(v)n(ersions)f(sp)r(eci\014ed)j(b)n
-(y)f(AST)p Ft(_)p Fj(SPECADD)227 1715 y(in)28 b(the)g(order)e(giv)n(en)
+(y)f(AST)p Ft(_)p Fj(SPECADD)227 4362 y(in)28 b(the)g(order)e(giv)n(en)
h(\(i.e.)37 b(with)29 b(the)e(most)h(recen)n(tly)f(added)g(con)n(v)n
-(ersion)e(applied)j(last\).)227 1837 y(This)23 b(order)e(is)h(rev)n
+(ersion)e(applied)j(last\).)227 4491 y(This)23 b(order)e(is)h(rev)n
(ersed)e(if)j(the)g(Sp)r(ecMap's)f(In)n(v)n(ert)g(attribute)g(is)g
(non-zero)f(\(or)h(if)h(the)f(in)n(v)n(erse)f(transformation)227
-1936 y(is)27 b(requested)f(b)n(y)h(an)n(y)f(other)g(means\))h(and)g
+4591 y(is)27 b(requested)f(b)n(y)h(an)n(y)f(other)g(means\))h(and)g
(eac)n(h)f(individual)h(co)r(ordinate)f(con)n(v)n(ersion)e(is)j(also)f
-(replaced)g(b)n(y)g(its)227 2036 y(o)n(wn)21 b(in)n(v)n(erse.)33
+(replaced)g(b)n(y)g(its)227 4691 y(o)n(wn)21 b(in)n(v)n(erse.)33
b(This)22 b(pro)r(cess)e(in)n(v)n(erts)g(the)i(o)n(v)n(erall)d
(e\013ect)j(of)f(the)h(Sp)r(ecMap.)35 b(In)22 b(this)f(case,)h(the)g
-(\014rst)f(con)n(v)n(ersion)227 2136 y(to)28 b(b)r(e)g(applied)f(w)n
+(\014rst)f(con)n(v)n(ersion)227 4790 y(to)28 b(b)r(e)g(applied)f(w)n
(ould)g(b)r(e)h(the)g(in)n(v)n(erse)f(of)g(the)h(one)f(most)h(recen)n
-(tly)f(added.)0 2280 y Fc(In)m(v)m(o)s(cation:)123 b
+(tly)f(added.)0 4950 y Fc(In)m(v)m(o)s(cation:)123 b
Ft(CALL)42 b(AST_SPECADD\()c(THIS,)k(CVT,)g(ARGS,)f(STATUS)g(\))0
-2424 y Fc(Argumen)m(ts:)259 2555 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 2654 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Sp)r(ecMap.)259
-2782 y Fc(CVT)k(=)h(CHARA)m(CTER)e Fi(\003)g Fc(\()h
-Fi(\003)g Fc(\))g(\(Giv)m(en\))427 2881 y Fj(A)39 b(c)n(haracter)c
+5110 y Fc(Argumen)m(ts:)259 5256 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 5356 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Sp)r(ecMap.)259
+5494 y Fc(CVT)k(=)h(CHARA)m(CTER)e Fi(\003)g Fc(\()h
+Fi(\003)g Fc(\))g(\(Giv)m(en\))427 5593 y Fj(A)39 b(c)n(haracter)c
(string)j(whic)n(h)f(iden)n(ti\014es)i(the)f(sp)r(ectral)f(co)r
(ordinate)g(con)n(v)n(ersion)f(to)h(b)r(e)i(added)e(to)h(the)427
-2981 y(Sp)r(ecMap.)f(See)28 b(the)g Ft(")p Fj(Av)-5 b(ailable)27
+5693 y(Sp)r(ecMap.)f(See)28 b(the)g Ft(")p Fj(Av)-5 b(ailable)27
b(Con)n(v)n(ersions)p Ft(")e Fj(section)i(for)g(details)g(of)h(those)f
-(a)n(v)-5 b(ailable.)259 3108 y Fc(AR)m(GS\()32 b Fi(\003)g
-Fc(\))g(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427 3208
-y Fj(An)e(arra)n(y)d(con)n(taining)h(argumen)n(t)g(v)-5
+(a)n(v)-5 b(ailable.)p eop end
+%%Page: 371 381
+TeXDict begin 371 380 bop 3643 52 a FG(371)259 351 y
+Fc(AR)m(GS\()32 b Fi(\003)g Fc(\))g(=)g(DOUBLE)g(PRECISION)f(\(Giv)m
+(en\))427 451 y Fj(An)e(arra)n(y)d(con)n(taining)h(argumen)n(t)g(v)-5
b(alues)28 b(for)g(the)h(sp)r(ectral)f(co)r(ordinate)f(con)n(v)n
-(ersion.)36 b(The)29 b(n)n(um)n(b)r(er)f(of)427 3308
-y(argumen)n(ts)22 b(required,)h(and)g(hence)g(the)g(n)n(um)n(b)r(er)g
-(of)g(arra)n(y)e(elemen)n(ts)h(used,)i(dep)r(ends)g(on)f(the)g(con)n(v)
-n(ersion)427 3407 y(sp)r(eci\014ed)i(\(see)g(the)f Ft(")p
-Fj(Av)-5 b(ailable)24 b(Con)n(v)n(ersions)p Ft(")e Fj(section\).)36
+(ersion.)36 b(The)29 b(n)n(um)n(b)r(er)f(of)427 551 y(argumen)n(ts)22
+b(required,)h(and)g(hence)g(the)g(n)n(um)n(b)r(er)g(of)g(arra)n(y)e
+(elemen)n(ts)h(used,)i(dep)r(ends)g(on)f(the)g(con)n(v)n(ersion)427
+650 y(sp)r(eci\014ed)i(\(see)g(the)f Ft(")p Fj(Av)-5
+b(ailable)24 b(Con)n(v)n(ersions)p Ft(")e Fj(section\).)36
b(This)24 b(arra)n(y)e(is)j(ignored)e(if)i(no)f(argumen)n(ts)g(are)427
-3507 y(needed.)259 3634 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m
-(en)h(and)g(Returned\))427 3734 y Fj(The)c(global)e(status.)0
-3890 y Fc(Notes:)340 4167 y Fi(\017)45 b Fj(When)37 b(assem)n(bling)e
+750 y(needed.)259 882 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m
+(en)h(and)g(Returned\))427 981 y Fj(The)c(global)e(status.)0
+1142 y Fc(Notes:)340 1424 y Fi(\017)45 b Fj(When)37 b(assem)n(bling)e
(a)g(m)n(ulti-stage)h(con)n(v)n(ersion,)g(it)g(can)g(sometimes)g(b)r(e)
-g(di\016cult)h(to)f(determine)g(the)427 4267 y(most)31
+g(di\016cult)h(to)f(determine)g(the)427 1524 y(most)31
b(economical)g(con)n(v)n(ersion)e(path.)48 b(F)-7 b(or)30
b(example,)i(when)g(con)n(v)n(erting)d(b)r(et)n(w)n(een)j(reference)e
-(frames,)427 4366 y(con)n(v)n(erting)19 b(\014rst)i(to)f(the)i
+(frames,)427 1623 y(con)n(v)n(erting)19 b(\014rst)i(to)f(the)i
(heliographic)d(reference)h(frame)g(as)g(an)h(in)n(termediate)f(stage)g
-(is)h(often)g(sensible)f(in)427 4466 y(form)n(ulating)f(the)i(problem,)
+(is)h(often)g(sensible)f(in)427 1723 y(form)n(ulating)f(the)i(problem,)
g(but)g(ma)n(y)e(in)n(tro)r(duce)h(unnecessary)e(extra)i(con)n(v)n
-(ersion)d(steps.)35 b(A)20 b(solution)g(to)427 4566 y(this)h(is)g(to)f
+(ersion)d(steps.)35 b(A)20 b(solution)g(to)427 1822 y(this)h(is)g(to)f
(include)h(all)g(the)g(steps)f(whic)n(h)h(are)f(\(logically\))g
(necessary)-7 b(,)20 b(but)h(then)g(to)g(use)g(AST)p
-Ft(_)p Fj(SIMPLIFY)427 4665 y(to)27 b(simplify)h(the)g(resulting)e(Sp)r
+Ft(_)p Fj(SIMPLIFY)427 1922 y(to)27 b(simplify)h(the)g(resulting)e(Sp)r
(ecMap.)37 b(The)27 b(simpli\014cation)g(pro)r(cess)f(will)i(eliminate)
-f(an)n(y)g(steps)g(whic)n(h)427 4765 y(turn)h(out)g(not)f(to)h(b)r(e)g
-(needed.)340 4892 y Fi(\017)45 b Fj(This)30 b(routine)g(do)r(es)f(not)h
+f(an)n(y)g(steps)g(whic)n(h)427 2022 y(turn)h(out)g(not)f(to)h(b)r(e)g
+(needed.)340 2154 y Fi(\017)45 b Fj(This)30 b(routine)g(do)r(es)f(not)h
(c)n(hec)n(k)f(to)h(ensure)f(that)h(the)h(sequence)e(of)h(co)r
-(ordinate)f(con)n(v)n(ersions)e(added)j(to)427 4992 y(a)d(Sp)r(ecMap)h
-(is)g(ph)n(ysically)e(meaningful.)-2 5148 y Fc(Av)-5
-b(ailable)32 b(Con)m(v)m(ersions)n(:)227 5295 y Fj(The)19
+(ordinate)f(con)n(v)n(ersions)e(added)j(to)427 2253 y(a)d(Sp)r(ecMap)h
+(is)g(ph)n(ysically)e(meaningful.)-2 2414 y Fc(Av)-5
+b(ailable)32 b(Con)m(v)m(ersions)n(:)227 2560 y Fj(The)19
b(follo)n(wing)f(strings)f(\(whic)n(h)i(are)f(case-insensitiv)n(e\))f
(ma)n(y)h(b)r(e)h(supplied)g(via)f(the)h(CVT)g(argumen)n(t)f(to)h
-(indicate)227 5394 y(whic)n(h)24 b(sp)r(ectral)g(co)r(ordinate)f(con)n
+(indicate)227 2660 y(whic)n(h)24 b(sp)r(ectral)g(co)r(ordinate)f(con)n
(v)n(ersion)f(is)i(to)g(b)r(e)g(added)g(to)g(the)h(Sp)r(ecMap.)36
-b(Where)24 b(argumen)n(ts)e(are)h(needed)227 5494 y(b)n(y)28
+b(Where)24 b(argumen)n(ts)e(are)h(needed)227 2760 y(b)n(y)28
b(the)h(con)n(v)n(ersion,)d(they)j(are)e(listed)h(in)h(paren)n(theses.)
38 b(V)-7 b(alues)28 b(for)f(these)i(argumen)n(ts)e(should)h(b)r(e)g
-(giv)n(en,)g(via)227 5593 y(the)33 b(AR)n(GS)f(arra)n(y)-7
+(giv)n(en,)g(via)227 2859 y(the)33 b(AR)n(GS)f(arra)n(y)-7
b(,)31 b(in)h(the)h(order)e(indicated.)50 b(Units)33
b(and)f(argumen)n(t)f(names)g(are)g(describ)r(ed)h(at)g(the)g(end)h(of)
-227 5693 y(the)28 b(list)g(of)g(con)n(v)n(ersions.)p
-eop end
-%%Page: 369 379
-TeXDict begin 369 378 bop 3643 52 a FG(369)340 489 y
-Fi(\017)45 b Ft(")p Fj(FR)-7 b(TO)n(VL)p Ft(")27 b Fj(\(RF\):)i(Con)n
-(v)n(ert)d(frequency)h(to)g(relativistic)g(v)n(elo)r(cit)n(y)-7
-b(.)340 623 y Fi(\017)45 b Ft(")p Fj(VL)-7 b(TOFR)p Ft(")27
-b Fj(\(RF\):)i(Con)n(v)n(ert)d(relativistic)h(v)n(elo)r(cit)n(y)g(to)g
-(F)-7 b(requency)g(.)340 756 y Fi(\017)45 b Ft(")p Fj(ENTOFR)p
-Ft(")p Fj(:)36 b(Con)n(v)n(ert)26 b(energy)h(to)g(frequency)-7
-b(.)340 890 y Fi(\017)45 b Ft(")p Fj(FR)-7 b(TOEN)p Ft(")p
-Fj(:)36 b(Con)n(v)n(ert)26 b(frequency)h(to)h(energy)-7
-b(.)340 1024 y Fi(\017)45 b Ft(")p Fj(WNTOFR)p Ft(")p
-Fj(:)37 b(Con)n(v)n(ert)26 b(w)n(a)n(v)n(e)g(n)n(um)n(b)r(er)h(to)h
-(frequency)-7 b(.)340 1157 y Fi(\017)45 b Ft(")p Fj(FR)-7
-b(TO)n(WN)p Ft(")p Fj(:)37 b(Con)n(v)n(ert)26 b(frequency)h(to)g(w)n(a)
-n(v)n(e)f(n)n(um)n(b)r(er.)340 1291 y Fi(\017)45 b Ft(")p
-Fj(WVTOFR)p Ft(")p Fj(:)37 b(Con)n(v)n(ert)26 b(w)n(a)n(v)n(elength)g
-(\(v)-5 b(acuum\))28 b(to)g(frequency)-7 b(.)340 1424
-y Fi(\017)45 b Ft(")p Fj(FR)-7 b(TO)n(WV)p Ft(")p Fj(:)37
-b(Con)n(v)n(ert)26 b(frequency)h(to)g(w)n(a)n(v)n(elength)f(\(v)-5
-b(acuum\).)340 1558 y Fi(\017)45 b Ft(")p Fj(A)-9 b(WTOFR)p
-Ft(")p Fj(:)37 b(Con)n(v)n(ert)26 b(w)n(a)n(v)n(elength)g(\(air\))h(to)
-h(frequency)-7 b(.)340 1692 y Fi(\017)45 b Ft(")p Fj(FR)-7
-b(TO)n(A)e(W)p Ft(")p Fj(:)36 b(Con)n(v)n(ert)27 b(frequency)g(to)g(w)n
-(a)n(v)n(elength)f(\(air\).)340 1825 y Fi(\017)45 b Ft(")p
-Fj(VR)-7 b(TO)n(VL)p Ft(")p Fj(:)36 b(Con)n(v)n(ert)26
-b(radio)h(to)g(relativistic)g(v)n(elo)r(cit)n(y)-7 b(.)340
-1959 y Fi(\017)45 b Ft(")p Fj(VL)-7 b(TO)n(VR)p Ft(")p
-Fj(:)36 b(Con)n(v)n(ert)26 b(relativistic)h(to)h(radio)e(v)n(elo)r(cit)
-n(y)-7 b(.)340 2093 y Fi(\017)45 b Ft(")p Fj(V)n(OTO)n(VL)p
-Ft(")p Fj(:)35 b(Con)n(v)n(ert)26 b(optical)i(to)f(relativistic)g(v)n
-(elo)r(cit)n(y)-7 b(.)340 2226 y Fi(\017)45 b Ft(")p
-Fj(VL)-7 b(TO)n(V)n(O)p Ft(")p Fj(:)35 b(Con)n(v)n(ert)27
-b(relativistic)f(to)i(optical)f(v)n(elo)r(cit)n(y)-7
-b(.)340 2360 y Fi(\017)45 b Ft(")p Fj(ZOTO)n(VL)p Ft(")p
-Fj(:)35 b(Con)n(v)n(ert)26 b(redshift)i(to)g(relativistic)e(v)n(elo)r
-(cit)n(y)-7 b(.)340 2493 y Fi(\017)45 b Ft(")p Fj(VL)-7
-b(TOZO)p Ft(")p Fj(:)35 b(Con)n(v)n(ert)27 b(relativistic)g(v)n(elo)r
-(cit)n(y)f(to)i(redshift.)340 2627 y Fi(\017)45 b Ft(")p
-Fj(BTTO)n(VL)p Ft(")p Fj(:)36 b(Con)n(v)n(ert)26 b(b)r(eta)i(factor)e
-(to)i(relativistic)f(v)n(elo)r(cit)n(y)-7 b(.)340 2761
-y Fi(\017)45 b Ft(")p Fj(VL)-7 b(TOBT)p Ft(")p Fj(:)36
-b(Con)n(v)n(ert)26 b(relativistic)h(v)n(elo)r(cit)n(y)g(to)g(b)r(eta)h
-(factor.)340 2894 y Fi(\017)45 b Ft(")p Fj(USF2HL)p Ft(")28
-b Fj(\(V)n(OFF,RA,DEC\):)i(Con)n(v)n(ert)d(frequency)g(from)h(a)g
-(user-de\014ned)g(reference)g(frame)g(to)g(he-)427 2994
-y(lio)r(cen)n(tric.)340 3127 y Fi(\017)45 b Ft(")p Fj(HLF2US)p
-Ft(")31 b Fj(\(V)n(OFF,RA,DEC\):)h(Con)n(v)n(ert)d(frequency)i(from)g
-(helio)r(cen)n(tric)f(reference)g(frame)h(to)g(user-)427
-3227 y(de\014ned.)340 3361 y Fi(\017)45 b Ft(")p Fj(TPF2HL)p
-Ft(")17 b Fj(\(OBSLON,OBSLA)-7 b(T,OBSAL)g(T,EPOCH,RA,DEC\):)17
-b(Con)n(v)n(ert)g(frequency)h(from)g(top)r(o)r(cen-)427
-3460 y(tric)28 b(reference)e(frame)i(to)f(helio)r(cen)n(tric.)340
-3594 y Fi(\017)45 b Ft(")p Fj(HLF2TP)p Ft(")20 b Fj(\(OBSLON,OBSLA)-7
-b(T,OBSAL)g(T,EPOCH,RA,DEC\):)20 b(Con)n(v)n(ert)g(frequency)h(from)g
-(helio-)427 3694 y(cen)n(tric)27 b(reference)g(frame)g(to)h(top)r(o)r
-(cen)n(tric.)340 3827 y Fi(\017)45 b Ft(")p Fj(GEF2HL)p
+227 2959 y(the)28 b(list)g(of)g(con)n(v)n(ersions.)340
+3218 y Fi(\017)45 b Ft(")p Fj(FR)-7 b(TO)n(VL)p Ft(")27
+b Fj(\(RF\):)i(Con)n(v)n(ert)d(frequency)h(to)g(relativistic)g(v)n(elo)
+r(cit)n(y)-7 b(.)340 3350 y Fi(\017)45 b Ft(")p Fj(VL)-7
+b(TOFR)p Ft(")27 b Fj(\(RF\):)i(Con)n(v)n(ert)d(relativistic)h(v)n(elo)
+r(cit)n(y)g(to)g(F)-7 b(requency)g(.)340 3482 y Fi(\017)45
+b Ft(")p Fj(ENTOFR)p Ft(")p Fj(:)36 b(Con)n(v)n(ert)26
+b(energy)h(to)g(frequency)-7 b(.)340 3614 y Fi(\017)45
+b Ft(")p Fj(FR)-7 b(TOEN)p Ft(")p Fj(:)36 b(Con)n(v)n(ert)26
+b(frequency)h(to)h(energy)-7 b(.)340 3746 y Fi(\017)45
+b Ft(")p Fj(WNTOFR)p Ft(")p Fj(:)37 b(Con)n(v)n(ert)26
+b(w)n(a)n(v)n(e)g(n)n(um)n(b)r(er)h(to)h(frequency)-7
+b(.)340 3878 y Fi(\017)45 b Ft(")p Fj(FR)-7 b(TO)n(WN)p
+Ft(")p Fj(:)37 b(Con)n(v)n(ert)26 b(frequency)h(to)g(w)n(a)n(v)n(e)f(n)
+n(um)n(b)r(er.)340 4010 y Fi(\017)45 b Ft(")p Fj(WVTOFR)p
+Ft(")p Fj(:)37 b(Con)n(v)n(ert)26 b(w)n(a)n(v)n(elength)g(\(v)-5
+b(acuum\))28 b(to)g(frequency)-7 b(.)340 4142 y Fi(\017)45
+b Ft(")p Fj(FR)-7 b(TO)n(WV)p Ft(")p Fj(:)37 b(Con)n(v)n(ert)26
+b(frequency)h(to)g(w)n(a)n(v)n(elength)f(\(v)-5 b(acuum\).)340
+4274 y Fi(\017)45 b Ft(")p Fj(A)-9 b(WTOFR)p Ft(")p Fj(:)37
+b(Con)n(v)n(ert)26 b(w)n(a)n(v)n(elength)g(\(air\))h(to)h(frequency)-7
+b(.)340 4406 y Fi(\017)45 b Ft(")p Fj(FR)-7 b(TO)n(A)e(W)p
+Ft(")p Fj(:)36 b(Con)n(v)n(ert)27 b(frequency)g(to)g(w)n(a)n(v)n
+(elength)f(\(air\).)340 4538 y Fi(\017)45 b Ft(")p Fj(VR)-7
+b(TO)n(VL)p Ft(")p Fj(:)36 b(Con)n(v)n(ert)26 b(radio)h(to)g
+(relativistic)g(v)n(elo)r(cit)n(y)-7 b(.)340 4670 y Fi(\017)45
+b Ft(")p Fj(VL)-7 b(TO)n(VR)p Ft(")p Fj(:)36 b(Con)n(v)n(ert)26
+b(relativistic)h(to)h(radio)e(v)n(elo)r(cit)n(y)-7 b(.)340
+4802 y Fi(\017)45 b Ft(")p Fj(V)n(OTO)n(VL)p Ft(")p Fj(:)35
+b(Con)n(v)n(ert)26 b(optical)i(to)f(relativistic)g(v)n(elo)r(cit)n(y)-7
+b(.)340 4934 y Fi(\017)45 b Ft(")p Fj(VL)-7 b(TO)n(V)n(O)p
+Ft(")p Fj(:)35 b(Con)n(v)n(ert)27 b(relativistic)f(to)i(optical)f(v)n
+(elo)r(cit)n(y)-7 b(.)340 5066 y Fi(\017)45 b Ft(")p
+Fj(ZOTO)n(VL)p Ft(")p Fj(:)35 b(Con)n(v)n(ert)26 b(redshift)i(to)g
+(relativistic)e(v)n(elo)r(cit)n(y)-7 b(.)340 5198 y Fi(\017)45
+b Ft(")p Fj(VL)-7 b(TOZO)p Ft(")p Fj(:)35 b(Con)n(v)n(ert)27
+b(relativistic)g(v)n(elo)r(cit)n(y)f(to)i(redshift.)340
+5330 y Fi(\017)45 b Ft(")p Fj(BTTO)n(VL)p Ft(")p Fj(:)36
+b(Con)n(v)n(ert)26 b(b)r(eta)i(factor)e(to)i(relativistic)f(v)n(elo)r
+(cit)n(y)-7 b(.)340 5461 y Fi(\017)45 b Ft(")p Fj(VL)-7
+b(TOBT)p Ft(")p Fj(:)36 b(Con)n(v)n(ert)26 b(relativistic)h(v)n(elo)r
+(cit)n(y)g(to)g(b)r(eta)h(factor.)340 5593 y Fi(\017)45
+b Ft(")p Fj(USF2HL)p Ft(")28 b Fj(\(V)n(OFF,RA,DEC\):)i(Con)n(v)n(ert)d
+(frequency)g(from)h(a)g(user-de\014ned)g(reference)g(frame)g(to)g(he-)
+427 5693 y(lio)r(cen)n(tric.)p eop end
+%%Page: 372 382
+TeXDict begin 372 381 bop 0 52 a FG(372)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Ft(")p Fj(HLF2US)p Ft(")31 b Fj(\(V)n(OFF,RA,DEC\):)h(Con)n(v)n(ert)d
+(frequency)i(from)g(helio)r(cen)n(tric)f(reference)g(frame)h(to)g
+(user-)427 451 y(de\014ned.)340 583 y Fi(\017)45 b Ft(")p
+Fj(TPF2HL)p Ft(")17 b Fj(\(OBSLON,OBSLA)-7 b(T,OBSAL)g
+(T,EPOCH,RA,DEC\):)17 b(Con)n(v)n(ert)g(frequency)h(from)g(top)r(o)r
+(cen-)427 683 y(tric)28 b(reference)e(frame)i(to)f(helio)r(cen)n(tric.)
+340 815 y Fi(\017)45 b Ft(")p Fj(HLF2TP)p Ft(")20 b Fj(\(OBSLON,OBSLA)
+-7 b(T,OBSAL)g(T,EPOCH,RA,DEC\):)20 b(Con)n(v)n(ert)g(frequency)h(from)
+g(helio-)427 914 y(cen)n(tric)27 b(reference)g(frame)g(to)h(top)r(o)r
+(cen)n(tric.)340 1047 y Fi(\017)45 b Ft(")p Fj(GEF2HL)p
Ft(")24 b Fj(\(EPOCH,RA,DEC\):)h(Con)n(v)n(ert)f(frequency)h(from)g
(geo)r(cen)n(tric)f(reference)g(frame)h(to)g(helio-)427
-3927 y(cen)n(tric.)340 4060 y Fi(\017)45 b Ft(")p Fj(HLF2GE)p
+1146 y(cen)n(tric.)340 1278 y Fi(\017)45 b Ft(")p Fj(HLF2GE)p
Ft(")24 b Fj(\(EPOCH,RA,DEC\):)h(Con)n(v)n(ert)f(frequency)h(from)g
(helio)r(cen)n(tric)g(reference)f(frame)h(to)g(geo-)427
-4160 y(cen)n(tric.)340 4294 y Fi(\017)45 b Ft(")p Fj(BYF2HL)p
+1378 y(cen)n(tric.)340 1510 y Fi(\017)45 b Ft(")p Fj(BYF2HL)p
Ft(")30 b Fj(\(EPOCH,RA,DEC\):)g(Con)n(v)n(ert)f(frequency)h(from)g
-(barycen)n(tric)f(reference)h(frame)g(to)g(he-)427 4393
-y(lio)r(cen)n(tric.)340 4527 y Fi(\017)45 b Ft(")p Fj(HLF2BY)p
+(barycen)n(tric)f(reference)h(frame)g(to)g(he-)427 1610
+y(lio)r(cen)n(tric.)340 1742 y Fi(\017)45 b Ft(")p Fj(HLF2BY)p
Ft(")18 b Fj(\(EPOCH,RA,DEC\):)g(Con)n(v)n(ert)f(frequency)h(from)g
(helio)r(cen)n(tric)g(reference)f(frame)h(to)g(barycen-)427
-4626 y(tric.)340 4760 y Fi(\017)45 b Ft(")p Fj(LKF2HL)p
+1842 y(tric.)340 1974 y Fi(\017)45 b Ft(")p Fj(LKF2HL)p
Ft(")27 b Fj(\(RA,DEC\):)j(Con)n(v)n(ert)d(frequency)h(from)g
(kinematic)h(LSR)g(reference)e(frame)i(to)f(helio)r(cen-)427
-4860 y(tric.)340 4993 y Fi(\017)45 b Ft(")p Fj(HLF2LK)p
+2073 y(tric.)340 2206 y Fi(\017)45 b Ft(")p Fj(HLF2LK)p
Ft(")38 b Fj(\(RA,DEC\):)i(Con)n(v)n(ert)d(frequency)i(from)f(helio)r
(cen)n(tric)g(reference)g(frame)h(to)g(kinematic)427
-5093 y(LSR.)340 5227 y Fi(\017)45 b Ft(")p Fj(LDF2HL)p
+2305 y(LSR.)340 2437 y Fi(\017)45 b Ft(")p Fj(LDF2HL)p
Ft(")27 b Fj(\(RA,DEC\):)g(Con)n(v)n(ert)f(frequency)g(from)h
(dynamical)f(LSR)h(reference)f(frame)g(to)h(helio)r(cen-)427
-5326 y(tric.)340 5460 y Fi(\017)45 b Ft(")p Fj(HLF2LD)p
+2537 y(tric.)340 2669 y Fi(\017)45 b Ft(")p Fj(HLF2LD)p
Ft(")37 b Fj(\(RA,DEC\):)h(Con)n(v)n(ert)d(frequency)i(from)f(helio)r
(cen)n(tric)h(reference)f(frame)g(to)h(dynamical)427
-5559 y(LSR.)340 5693 y Fi(\017)45 b Ft(")p Fj(LGF2HL)p
+2769 y(LSR.)340 2901 y Fi(\017)45 b Ft(")p Fj(LGF2HL)p
Ft(")27 b Fj(\(RA,DEC\):)i(Con)n(v)n(ert)d(frequency)h(from)g(lo)r(cal)
-g(group)g(reference)f(frame)i(to)f(helio)r(cen)n(tric.)p
-eop end
-%%Page: 370 380
-TeXDict begin 370 379 bop 0 52 a FG(370)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
-b Ft(")p Fj(HLF2LG)p Ft(")27 b Fj(\(RA,DEC\):)i(Con)n(v)n(ert)d
-(frequency)h(from)g(helio)r(cen)n(tric)g(reference)g(frame)g(to)h(lo)r
-(cal)f(group.)340 487 y Fi(\017)45 b Ft(")p Fj(GLF2HL)p
-Ft(")27 b Fj(\(RA,DEC\):)i(Con)n(v)n(ert)d(frequency)h(from)g(galactic)
-g(reference)f(frame)h(to)h(helio)r(cen)n(tric.)340 622
-y Fi(\017)45 b Ft(")p Fj(HLF2GL)p Ft(")27 b Fj(\(RA,DEC\):)i(Con)n(v)n
-(ert)d(frequency)h(from)g(helio)r(cen)n(tric)g(reference)g(frame)g(to)h
-(galactic.)227 790 y(The)g(units)g(for)f(the)h(v)-5 b(alues)27
-b(pro)r(cessed)g(b)n(y)g(the)h(ab)r(o)n(v)n(e)e(con)n(v)n(ersions)f
-(are)i(as)g(follo)n(ws:)340 1059 y Fi(\017)45 b Fj(all)28
-b(v)n(elo)r(cities:)36 b(metres)27 b(p)r(er)h(second)e(\(p)r(ositiv)n
-(e)i(if)g(the)g(source)e(receeds)h(from)g(the)h(observ)n(er\).)340
-1194 y Fi(\017)45 b Fj(frequency:)37 b(Hertz.)340 1330
-y Fi(\017)45 b Fj(all)28 b(w)n(a)n(v)n(elengths:)35 b(metres.)340
-1466 y Fi(\017)45 b Fj(energy:)36 b(Joules.)340 1601
-y Fi(\017)45 b Fj(w)n(a)n(v)n(e)26 b(n)n(um)n(b)r(er:)37
-b(cycles)27 b(p)r(er)g(metre.)227 1769 y(The)h(argumen)n(ts)e(used)i
+g(group)g(reference)f(frame)i(to)f(helio)r(cen)n(tric.)340
+3033 y Fi(\017)45 b Ft(")p Fj(HLF2LG)p Ft(")27 b Fj(\(RA,DEC\):)i(Con)n
+(v)n(ert)d(frequency)h(from)g(helio)r(cen)n(tric)g(reference)g(frame)g
+(to)h(lo)r(cal)f(group.)340 3165 y Fi(\017)45 b Ft(")p
+Fj(GLF2HL)p Ft(")27 b Fj(\(RA,DEC\):)i(Con)n(v)n(ert)d(frequency)h
+(from)g(galactic)g(reference)f(frame)h(to)h(helio)r(cen)n(tric.)340
+3297 y Fi(\017)45 b Ft(")p Fj(HLF2GL)p Ft(")27 b Fj(\(RA,DEC\):)i(Con)n
+(v)n(ert)d(frequency)h(from)g(helio)r(cen)n(tric)g(reference)g(frame)g
+(to)h(galactic.)227 3459 y(The)g(units)g(for)f(the)h(v)-5
+b(alues)27 b(pro)r(cessed)g(b)n(y)g(the)h(ab)r(o)n(v)n(e)e(con)n(v)n
+(ersions)f(are)i(as)g(follo)n(ws:)340 3719 y Fi(\017)45
+b Fj(all)28 b(v)n(elo)r(cities:)36 b(metres)27 b(p)r(er)h(second)e(\(p)
+r(ositiv)n(e)i(if)g(the)g(source)e(receeds)h(from)g(the)h(observ)n
+(er\).)340 3851 y Fi(\017)45 b Fj(frequency:)37 b(Hertz.)340
+3983 y Fi(\017)45 b Fj(all)28 b(w)n(a)n(v)n(elengths:)35
+b(metres.)340 4115 y Fi(\017)45 b Fj(energy:)36 b(Joules.)340
+4247 y Fi(\017)45 b Fj(w)n(a)n(v)n(e)26 b(n)n(um)n(b)r(er:)37
+b(cycles)27 b(p)r(er)g(metre.)227 4408 y(The)h(argumen)n(ts)e(used)i
(in)g(the)g(ab)r(o)n(v)n(e)e(con)n(v)n(ersions)f(are)h(as)h(follo)n
-(ws:)340 2038 y Fi(\017)45 b Fj(RF:)28 b(Rest)g(frequency)f(\(Hz\).)340
-2173 y Fi(\017)45 b Fj(OBSAL)-7 b(T:)28 b(Geo)r(detic)g(altitude)g(of)f
-(observ)n(er)e(\(IA)n(U)k(1975,)c(metres\).)340 2309
+(ws:)340 4668 y Fi(\017)45 b Fj(RF:)28 b(Rest)g(frequency)f(\(Hz\).)340
+4800 y Fi(\017)45 b Fj(OBSAL)-7 b(T:)28 b(Geo)r(detic)g(altitude)g(of)f
+(observ)n(er)e(\(IA)n(U)k(1975,)c(metres\).)340 4933
y Fi(\017)45 b Fj(OBSLA)-7 b(T:)28 b(Geo)r(detic)g(latitude)g(of)f
-(observ)n(er)e(\(IA)n(U)k(1975,)c(radians\).)340 2444
+(observ)n(er)e(\(IA)n(U)k(1975,)c(radians\).)340 5065
y Fi(\017)45 b Fj(OBSLON:)27 b(Longitude)g(of)h(observ)n(er)d
(\(radians)i(-)g(p)r(ositiv)n(e)g(east)n(w)n(ards\).)340
-2580 y Fi(\017)45 b Fj(EPOCH:)27 b(Ep)r(o)r(c)n(h)g(of)h(observ)-5
+5197 y Fi(\017)45 b Fj(EPOCH:)27 b(Ep)r(o)r(c)n(h)g(of)h(observ)-5
b(ation)26 b(\(UT1)h(expressed)g(as)g(a)g(Mo)r(di\014ed)h(Julian)f
-(Date\).)340 2715 y Fi(\017)45 b Fj(RA:)28 b(Righ)n(t)g(Ascension)f(of)
-g(source)g(\(radians,)f(FK5)h(J2000\).)340 2851 y Fi(\017)45
+(Date\).)340 5329 y Fi(\017)45 b Fj(RA:)28 b(Righ)n(t)g(Ascension)f(of)
+g(source)g(\(radians,)f(FK5)h(J2000\).)340 5461 y Fi(\017)45
b Fj(DEC:)28 b(Declination)g(of)f(source)f(\(radians,)h(FK5)g(J2000\).)
-340 2987 y Fi(\017)45 b Fj(V)n(OFF:)32 b(V)-7 b(elo)r(cit)n(y)32
+340 5593 y Fi(\017)45 b Fj(V)n(OFF:)32 b(V)-7 b(elo)r(cit)n(y)32
b(of)g(the)g(user-de\014ned)g(reference)f(frame,)h(to)n(w)n(ards)e(the)
-j(p)r(osition)f(giv)n(en)f(b)n(y)g(RA)i(and)427 3086
+j(p)r(osition)f(giv)n(en)f(b)n(y)g(RA)i(and)427 5693
y(DEC,)28 b(measured)f(in)g(the)h(helio)r(cen)n(tric)f(reference)g
-(frame.)227 3254 y(If)35 b(the)f(Sp)r(ecMap)g(is)f(3-dimensional,)i
-(source)d(p)r(ositions)h(are)g(pro)n(vided)g(b)n(y)h(the)g(v)-5
-b(alues)33 b(supplied)h(to)g(inputs)227 3353 y(2)f(and)g(3)g(of)h(the)f
-(Sp)r(ecMap)h(\(whic)n(h)f(are)g(simply)g(copied)g(to)g(outputs)h(2)f
-(and)g(3\).)54 b(Note,)35 b(usable)e(v)-5 b(alues)33
-b(are)227 3453 y(still)26 b(required)f(for)g(the)h(RA)f(and)h(DEC)f
-(argumen)n(ts)f(in)i(order)e(to)i(de\014ne)g(the)f Ft(")p
-Fj(user-de\014ned)p Ft(")f Fj(reference)h(frame)227 3552
-y(used)35 b(b)n(y)g(USF2HL)g(and)g(HLF2US.)h(Ho)n(w)n(ev)n(er,)f(AST)p
-Ft(__)p Fj(BAD)g(can)g(b)r(e)g(supplied)h(for)e(RA)i(and)f(DEC)g(if)g
-(the)227 3652 y(user-de\014ned)27 b(reference)g(frame)g(is)h(not)f
-(required.)p 0 3857 3780 12 v 0 3988 a FA(AST)p Fe(_)p
-FA(SPECFLUXFRAME)1721 3987 y Fd(Create)1860 4087 y(a)1708
-4186 y(Sp)s(ecFluxF)-10 b(rame)2224 3988 y FA(AST)p Fe(_)p
-FA(SPECFLUXFRAME)0 4381 y Fc(Description:)44 b Fj(This)28
-b(function)g(creates)f(a)g(new)g(Sp)r(ecFluxF)-7 b(rame)28
-b(and)f(optionally)g(initialises)g(its)h(attributes.)227
-4508 y(A)g(Sp)r(ecFluxF)-7 b(rame)27 b(com)n(bines)g(a)g(Sp)r(ecF)-7
-b(rame)27 b(and)h(a)f(FluxF)-7 b(rame)27 b(in)n(to)g(a)g(single)g
-(2-dimensional)f(comp)r(ound)227 4608 y(F)-7 b(rame.)39
-b(Suc)n(h)28 b(a)g(F)-7 b(rame)28 b(can)f(for)h(instance)g(b)r(e)h
-(used)f(to)g(describ)r(e)g(a)g(Plot)g(of)g(a)g(sp)r(ectrum)g(in)h(whic)
-n(h)f(the)h(\014rst)227 4707 y(axis)e(represen)n(ts)f(sp)r(ectral)h(p)r
-(osition)h(and)f(the)h(second)f(axis)g(represen)n(ts)f(\015ux.)0
-4862 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i
-(AST_SPECFLUXFRAM)o(E\()37 b(FRAME1,)k(FRAME2,)g(OPTIONS,)f(STATUS)h
-(\))0 5017 y Fc(Argumen)m(ts:)259 5159 y(FRAME1)31 b(=)h(INTEGER)f
-(\(Giv)m(en\))427 5259 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Sp)r(ecF)-7
-b(rame.)36 b(This)28 b(will)g(form)f(the)h(\014rst)f(axis)g(in)h(the)g
-(new)g(Sp)r(ecFluxF)-7 b(rame.)259 5394 y Fc(FRAME2)31
-b(=)h(INTEGER)f(\(Giv)m(en\))427 5494 y Fj(P)n(oin)n(ter)f(to)h(the)g
-(FluxF)-7 b(rame.)47 b(This)31 b(will)g(form)g(the)h(second)e(axis)g
-(in)i(the)f(new)g(Sp)r(ecFluxF)-7 b(rame.)48 b(The)427
-5593 y Ft(")p Fj(Sp)r(ecV)-7 b(al)p Ft(")30 b Fj(attribute)h(of)f(this)
-h(FluxF)-7 b(rame)30 b(is)g(not)h(used)f(b)n(y)g(the)h(Sp)r(ecFluxF)-7
-b(rame)31 b(class)e(and)i(so)e(ma)n(y)427 5693 y(b)r(e)f(set)g(to)f
+(frame.)p eop end
+%%Page: 373 383
+TeXDict begin 373 382 bop 3643 52 a FG(373)227 351 y
+Fj(If)35 b(the)f(Sp)r(ecMap)g(is)f(3-dimensional,)i(source)d(p)r
+(ositions)h(are)g(pro)n(vided)g(b)n(y)h(the)g(v)-5 b(alues)33
+b(supplied)h(to)g(inputs)227 451 y(2)f(and)g(3)g(of)h(the)f(Sp)r(ecMap)
+h(\(whic)n(h)f(are)g(simply)g(copied)g(to)g(outputs)h(2)f(and)g(3\).)54
+b(Note,)35 b(usable)e(v)-5 b(alues)33 b(are)227 551 y(still)26
+b(required)f(for)g(the)h(RA)f(and)h(DEC)f(argumen)n(ts)f(in)i(order)e
+(to)i(de\014ne)g(the)f Ft(")p Fj(user-de\014ned)p Ft(")f
+Fj(reference)h(frame)227 650 y(used)35 b(b)n(y)g(USF2HL)g(and)g
+(HLF2US.)h(Ho)n(w)n(ev)n(er,)f(AST)p Ft(__)p Fj(BAD)g(can)g(b)r(e)g
+(supplied)h(for)e(RA)i(and)f(DEC)g(if)g(the)227 750 y(user-de\014ned)27
+b(reference)g(frame)g(is)h(not)f(required.)p 0 983 3780
+12 v 0 1114 a FA(AST)p Fe(_)p FA(SPECFLUXFRAME)1721 1113
+y Fd(Create)1860 1213 y(a)1708 1312 y(Sp)s(ecFluxF)-10
+b(rame)2224 1114 y FA(AST)p Fe(_)p FA(SPECFLUXFRAME)0
+1535 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+(Sp)r(ecFluxF)-7 b(rame)28 b(and)f(optionally)g(initialises)g(its)h
+(attributes.)227 1677 y(A)g(Sp)r(ecFluxF)-7 b(rame)27
+b(com)n(bines)g(a)g(Sp)r(ecF)-7 b(rame)27 b(and)h(a)f(FluxF)-7
+b(rame)27 b(in)n(to)g(a)g(single)g(2-dimensional)f(comp)r(ound)227
+1776 y(F)-7 b(rame.)39 b(Suc)n(h)28 b(a)g(F)-7 b(rame)28
+b(can)f(for)h(instance)g(b)r(e)h(used)f(to)g(describ)r(e)g(a)g(Plot)g
+(of)g(a)g(sp)r(ectrum)g(in)h(whic)n(h)f(the)h(\014rst)227
+1876 y(axis)e(represen)n(ts)f(sp)r(ectral)h(p)r(osition)h(and)f(the)h
+(second)f(axis)g(represen)n(ts)f(\015ux.)0 2059 y Fc(In)m(v)m(o)s
+(cation:)123 b Ft(RESULT)41 b(=)i(AST_SPECFLUXFRAM)o(E\()37
+b(FRAME1,)k(FRAME2,)g(OPTIONS,)f(STATUS)h(\))0 2242 y
+Fc(Argumen)m(ts:)259 2413 y(FRAME1)31 b(=)h(INTEGER)f(\(Giv)m(en\))427
+2512 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Sp)r(ecF)-7 b(rame.)36
+b(This)28 b(will)g(form)f(the)h(\014rst)f(axis)g(in)h(the)g(new)g(Sp)r
+(ecFluxF)-7 b(rame.)259 2662 y Fc(FRAME2)31 b(=)h(INTEGER)f(\(Giv)m
+(en\))427 2762 y Fj(P)n(oin)n(ter)f(to)h(the)g(FluxF)-7
+b(rame.)47 b(This)31 b(will)g(form)g(the)h(second)e(axis)g(in)i(the)f
+(new)g(Sp)r(ecFluxF)-7 b(rame.)48 b(The)427 2861 y Ft(")p
+Fj(Sp)r(ecV)-7 b(al)p Ft(")30 b Fj(attribute)h(of)f(this)h(FluxF)-7
+b(rame)30 b(is)g(not)h(used)f(b)n(y)g(the)h(Sp)r(ecFluxF)-7
+b(rame)31 b(class)e(and)i(so)e(ma)n(y)427 2961 y(b)r(e)f(set)g(to)f
(AST)p Ft(__)p Fj(BAD)h(when)g(the)g(FluxF)-7 b(rame)27
-b(is)h(created.)p eop end
-%%Page: 371 381
-TeXDict begin 371 380 bop 3643 52 a FG(371)259 351 y
-Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 451 y Fj(A)g(c)n(haracter)e(string)h
-(con)n(taining)f(an)h(optional)g(comma-separated)e(list)j(of)g
-(attribute)f(assignmen)n(ts)g(to)427 551 y(b)r(e)e(used)f(for)g
-(initialising)g(the)h(new)f(Sp)r(ecFluxF)-7 b(rame.)39
-b(The)29 b(syn)n(tax)e(used)h(is)h(iden)n(tical)f(to)g(that)g(for)g
-(the)427 650 y(AST)p Ft(_)p Fj(SET)f(routine.)259 791
-y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 891 y Fj(The)c(global)e(status.)0 1070 y Fc(Returned)32
-b(V)-8 b(alue:)259 1223 y(AST)p Ft(_)p Fc(SPECFLUXFRAME)32
-b(=)h(INTEGER)427 1323 y Fj(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Sp)
-r(ecFluxF)-7 b(rame.)0 1502 y Fc(Notes:)340 1801 y Fi(\017)45
-b Fj(The)25 b(supplied)g(F)-7 b(rame)24 b(p)r(oin)n(ters)g(are)g
-(stored)f(directly)-7 b(,)26 b(rather)d(than)i(b)r(eing)g(used)f(to)h
-(create)f(deep)g(copies)427 1901 y(of)g(the)h(supplied)f(F)-7
-b(rames.)35 b(This)24 b(means)g(that)g(an)n(y)f(subsequen)n(t)h(c)n
-(hanges)e(made)i(to)g(the)g(F)-7 b(rames)24 b(via)f(the)427
-2000 y(supplied)28 b(p)r(oin)n(ters)f(will)h(result)f(in)h(equiv)-5
-b(alen)n(t)27 b(c)n(hanges)g(b)r(eing)g(visible)h(in)g(the)g(Sp)r
-(ecFluxF)-7 b(rame.)340 2142 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+b(is)h(created.)259 3111 y Fc(OPTIONS)k(=)g(CHARA)m(CTER)g
+Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
+3210 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h(optional)g
+(comma-separated)e(list)j(of)g(attribute)f(assignmen)n(ts)g(to)427
+3310 y(b)r(e)e(used)f(for)g(initialising)g(the)h(new)f(Sp)r(ecFluxF)-7
+b(rame.)39 b(The)29 b(syn)n(tax)e(used)h(is)h(iden)n(tical)f(to)g(that)
+g(for)g(the)427 3410 y(AST)p Ft(_)p Fj(SET)f(routine.)259
+3559 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 3659 y Fj(The)c(global)e(status.)0 3855
+y Fc(Returned)32 b(V)-8 b(alue:)259 4025 y(AST)p Ft(_)p
+Fc(SPECFLUXFRAME)32 b(=)h(INTEGER)427 4124 y Fj(A)28
+b(p)r(oin)n(ter)f(to)h(the)g(new)g(Sp)r(ecFluxF)-7 b(rame.)0
+4320 y Fc(Notes:)340 4637 y Fi(\017)45 b Fj(The)25 b(supplied)g(F)-7
+b(rame)24 b(p)r(oin)n(ters)g(are)g(stored)f(directly)-7
+b(,)26 b(rather)d(than)i(b)r(eing)g(used)f(to)h(create)f(deep)g(copies)
+427 4736 y(of)g(the)h(supplied)f(F)-7 b(rames.)35 b(This)24
+b(means)g(that)g(an)n(y)f(subsequen)n(t)h(c)n(hanges)e(made)i(to)g(the)
+g(F)-7 b(rames)24 b(via)f(the)427 4836 y(supplied)28
+b(p)r(oin)n(ters)f(will)h(result)f(in)h(equiv)-5 b(alen)n(t)27
+b(c)n(hanges)g(b)r(eing)g(visible)h(in)g(the)g(Sp)r(ecFluxF)-7
+b(rame.)340 4986 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 2241 y(set)28 b(to)f(an)h(error)d(v)-5
+b(A)g(TUS)427 5085 y(set)28 b(to)f(an)h(error)d(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)-2
-2420 y Fc(Status)33 b(Handling)n(:)227 2566 y Fj(The)d(protected)g(in)n
+5281 y Fc(Status)33 b(Handling)n(:)227 5427 y Fj(The)d(protected)g(in)n
(terface)f(to)g(this)h(function)h(includes)f(an)f(extra)g(parameter)f
-(at)i(the)g(end)g(of)g(the)g(parameter)227 2666 y(list)37
+(at)i(the)g(end)g(of)g(the)g(parameter)227 5527 y(list)37
b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)
r(oin)n(ter)g(to)h(the)g(in)n(teger)e(inherited)i(status)f(v)-5
-b(ariable:)54 b Ft(")p Fj(in)n(t)227 2766 y Fi(\003)p
-Fj(status)p Ft(")p Fj(.)p 0 2982 3780 12 v 0 3112 a FA(AST)p
-Fe(_)p FA(SPECFRAME)186 b Fd(Create)37 b(a)h(Sp)s(ecF)-10
-b(rame)188 b FA(AST)p Fe(_)p FA(SPECFRAME)0 3318 y Fc(Description:)44
-b Fj(This)28 b(function)g(creates)f(a)g(new)g(Sp)r(ecF)-7
-b(rame)28 b(and)f(optionally)g(initialises)g(its)h(attributes.)227
-3451 y(A)j(Sp)r(ecF)-7 b(rame)29 b(is)h(a)g(sp)r(ecialised)f(form)h(of)
-g(one-dimensional)e(F)-7 b(rame)30 b(whic)n(h)g(represen)n(ts)e(v)-5
-b(arious)29 b(co)r(ordinate)227 3550 y(systems)23 b(used)h(to)f
-(describ)r(e)g(p)r(ositions)g(within)h(an)f(electro-magnetic)f(sp)r
-(ectrum.)35 b(The)24 b(particular)e(co)r(ordinate)227
-3650 y(system)32 b(to)g(b)r(e)g(used)g(is)g(sp)r(eci\014ed)g(b)n(y)f
-(setting)h(the)g(Sp)r(ecF)-7 b(rame's)32 b(System)g(attribute)g(\(the)g
-(default)h(is)f(w)n(a)n(v)n(e-)227 3750 y(length\))27
-b(quali\014ed,)f(as)g(necessary)-7 b(,)24 b(b)n(y)i(other)g(attributes)
-g(suc)n(h)g(as)f(the)i(rest)e(frequency)-7 b(,)26 b(the)h(standard)e
-(of)h(rest,)227 3849 y(the)i(ep)r(o)r(c)n(h)g(of)f(observ)-5
-b(ation,)27 b(etc)g(\(see)h(the)g(description)f(of)g(the)h(System)g
-(attribute)g(for)f(details\).)227 3982 y(By)d(setting)f(a)h(v)-5
+b(ariable:)54 b Ft(")p Fj(in)n(t)227 5626 y Fi(\003)p
+Fj(status)p Ft(")p Fj(.)p eop end
+%%Page: 374 384
+TeXDict begin 374 383 bop 0 52 a FG(374)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(SPECFRAME)186 b Fd(Create)37
+b(a)h(Sp)s(ecF)-10 b(rame)188 b FA(AST)p Fe(_)p FA(SPECFRAME)0
+668 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+(Sp)r(ecF)-7 b(rame)28 b(and)f(optionally)g(initialises)g(its)h
+(attributes.)227 791 y(A)j(Sp)r(ecF)-7 b(rame)29 b(is)h(a)g(sp)r
+(ecialised)f(form)h(of)g(one-dimensional)e(F)-7 b(rame)30
+b(whic)n(h)g(represen)n(ts)e(v)-5 b(arious)29 b(co)r(ordinate)227
+891 y(systems)23 b(used)h(to)f(describ)r(e)g(p)r(ositions)g(within)h
+(an)f(electro-magnetic)f(sp)r(ectrum.)35 b(The)24 b(particular)e(co)r
+(ordinate)227 991 y(system)32 b(to)g(b)r(e)g(used)g(is)g(sp)r
+(eci\014ed)g(b)n(y)f(setting)h(the)g(Sp)r(ecF)-7 b(rame's)32
+b(System)g(attribute)g(\(the)g(default)h(is)f(w)n(a)n(v)n(e-)227
+1090 y(length\))27 b(quali\014ed,)f(as)g(necessary)-7
+b(,)24 b(b)n(y)i(other)g(attributes)g(suc)n(h)g(as)f(the)i(rest)e
+(frequency)-7 b(,)26 b(the)h(standard)e(of)h(rest,)227
+1190 y(the)i(ep)r(o)r(c)n(h)g(of)f(observ)-5 b(ation,)27
+b(etc)g(\(see)h(the)g(description)f(of)g(the)h(System)g(attribute)g
+(for)f(details\).)227 1314 y(By)d(setting)f(a)h(v)-5
b(alue)23 b(for)h(thr)f(Sp)r(ecOrigin)h(attribute,)g(a)g(Sp)r(ecF)-7
b(rame)23 b(can)h(b)r(e)g(made)f(to)h(represen)n(t)e(o\013sets)i(from)
-227 4082 y(a)j(giv)n(en)g(sp)r(ectral)g(p)r(osition,)h(rather)e(than)i
-(absolute)0 4248 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
-b(=)i(AST_SPECFRAME\()38 b(OPTIONS,)i(STATUS)h(\))0 4415
-y Fc(Argumen)m(ts:)259 4568 y(OPTIONS)32 b(=)g(CHARA)m(CTER)g
+227 1413 y(a)j(giv)n(en)g(sp)r(ectral)g(p)r(osition,)h(rather)e(than)i
+(absolute)0 1561 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
+b(=)i(AST_SPECFRAME\()38 b(OPTIONS,)i(STATUS)h(\))0 1709
+y Fc(Argumen)m(ts:)259 1844 y(OPTIONS)32 b(=)g(CHARA)m(CTER)g
Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-4668 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h(optional)g
+1944 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h(optional)g
(comma-separated)e(list)j(of)g(attribute)f(assignmen)n(ts)g(to)427
-4767 y(b)r(e)39 b(used)f(for)g(initialising)f(the)i(new)f(Sp)r(ecF)-7
+2044 y(b)r(e)39 b(used)f(for)g(initialising)f(the)i(new)f(Sp)r(ecF)-7
b(rame.)69 b(The)38 b(syn)n(tax)f(used)h(is)g(iden)n(tical)g(to)g(that)
-h(for)e(the)427 4867 y(AST)p Ft(_)p Fj(SET)27 b(routine.)37
+h(for)e(the)427 2143 y(AST)p Ft(_)p Fj(SET)27 b(routine.)37
b(If)28 b(no)f(initialisation)g(is)h(required,)f(a)g(blank)g(v)-5
-b(alue)28 b(ma)n(y)e(b)r(e)i(supplied.)259 5008 y Fc(ST)-8
+b(alue)28 b(ma)n(y)e(b)r(e)i(supplied.)259 2275 y Fc(ST)-8
b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-5108 y Fj(The)c(global)e(status.)0 5287 y Fc(Returned)32
-b(V)-8 b(alue:)259 5440 y(AST)p Ft(_)p Fc(SPECFRAME)31
-b(=)h(INTEGER)427 5540 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(Sp)r
-(ecF)-7 b(rame.)0 5718 y Fc(Examples:)p eop end
-%%Page: 372 382
-TeXDict begin 372 381 bop 0 52 a FG(372)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)227 355 y Fy(FRAME)47
+2374 y Fj(The)c(global)e(status.)0 2535 y Fc(Returned)32
+b(V)-8 b(alue:)259 2670 y(AST)p Ft(_)p Fc(SPECFRAME)31
+b(=)h(INTEGER)427 2769 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(Sp)r
+(ecF)-7 b(rame.)0 2930 y Fc(Examples:)227 3069 y Fy(FRAME)47
b(=)g(AST)p Ft(_)p Fy(SPECFRAME\()d(')j(',)g(STATUS)g(\))427
-451 y Fj(Creates)36 b(a)g(Sp)r(ecF)-7 b(rame)36 b(to)g(describ)r(e)g
+3164 y Fj(Creates)36 b(a)g(Sp)r(ecF)-7 b(rame)36 b(to)g(describ)r(e)g
(the)h(default)g(w)n(a)n(v)n(elength)d(sp)r(ectral)i(co)r(ordinate)g
-(system.)63 b(The)427 551 y(RestF)-7 b(req)39 b(attribute)g(\(rest)f
+(system.)63 b(The)427 3264 y(RestF)-7 b(req)39 b(attribute)g(\(rest)f
(frequency\))h(is)g(unsp)r(eci\014ed,)j(so)c(it)i(will)f(not)g(b)r(e)g
-(p)r(ossible)f(to)h(align)f(this)427 650 y(Sp)r(ecF)-7
+(p)r(ossible)f(to)h(align)f(this)427 3364 y(Sp)r(ecF)-7
b(rame)24 b(with)h(another)e(Sp)r(ecF)-7 b(rame)24 b(on)f(the)i(basis)e
(of)h(a)g(v)n(elo)r(cit)n(y-based)e(system.)35 b(The)25
-b(standard)e(of)427 750 y(rest)30 b(is)f(also)g(unsp)r(eci\014ed.)44
+b(standard)e(of)427 3463 y(rest)30 b(is)f(also)g(unsp)r(eci\014ed.)44
b(This)29 b(means)h(that)g(alignmen)n(t)f(will)h(b)r(e)g(p)r(ossible)g
-(with)g(other)f(Sp)r(ecF)-7 b(rames,)427 849 y(but)31
+(with)g(other)f(Sp)r(ecF)-7 b(rames,)427 3563 y(but)31
b(no)g(correction)e(will)h(b)r(e)i(made)e(for)g(Doppler)g(shift)i
(caused)e(b)n(y)g(c)n(hange)f(of)i(rest)f(frame)g(during)g(the)427
-949 y(alignmen)n(t.)227 1069 y Fy(FRAME)47 b(=)g(AST)p
+3663 y(alignmen)n(t.)227 3782 y Fy(FRAME)47 b(=)g(AST)p
Ft(_)p Fy(SPECFRAME\()d('System=VELO,)g(RestFreq=1.0E15,)f
-(StdOfRest=LSRK',)227 1168 y(STATUS)j(\))427 1247 y Fj(Creates)39
+(StdOfRest=LSRK',)227 3882 y(STATUS)j(\))427 3960 y Fj(Creates)39
b(a)h(Sp)r(ecF)-7 b(rame)40 b(describing)f(a)h(apparen)n(t)e(radial)h
(v)n(elo)r(cit)n(y)h(\()p Ft(")p Fj(VELO)p Ft(")p Fj(\))f(axis)g(with)h
-(rest)g(fre-)427 1346 y(quency)35 b(1.0E15)e(Hz)i(\(ab)r(out)g(3000)f
+(rest)g(fre-)427 4059 y(quency)35 b(1.0E15)e(Hz)i(\(ab)r(out)g(3000)f
(Angstroms\),)i(measured)e(in)h(the)h(kinematic)f(Lo)r(cal)f(Standard)h
-(of)427 1446 y(Rest)f(\()p Ft(")p Fj(LSRK)p Ft(")p Fj(\).)56
+(of)427 4159 y(Rest)f(\()p Ft(")p Fj(LSRK)p Ft(")p Fj(\).)56
b(Since)34 b(the)g(source)f(p)r(osition)h(has)f(not)h(b)r(een)h(sp)r
-(eci\014ed)f(\(using)g(attributes)g(RefRA)427 1545 y(and)c(RefDec\),)i
+(eci\014ed)f(\(using)g(attributes)g(RefRA)427 4259 y(and)c(RefDec\),)i
(it)f(will)g(only)e(b)r(e)i(p)r(ossible)f(to)g(align)g(this)g(Sp)r(ecF)
-7 b(rame)30 b(with)h(other)f(Sp)r(ecF)-7 b(rames)30
-b(whic)n(h)427 1645 y(are)d(also)f(measured)h(in)h(the)g(LSRK)f
-(standard)g(of)g(rest.)0 1806 y Fc(Notes:)340 2087 y
+b(whic)n(h)427 4358 y(are)d(also)f(measured)h(in)h(the)g(LSRK)f
+(standard)g(of)g(rest.)0 4519 y Fc(Notes:)340 4800 y
Fi(\017)45 b Fj(When)g(con)n(v)n(ersion)c(b)r(et)n(w)n(een)j(t)n(w)n(o)
e(Sp)r(ecF)-7 b(rames)44 b(is)f(requested)g(\(as)h(when)g(supplying)f
-(Sp)r(ecF)-7 b(rames)427 2187 y(AST)p Ft(_)p Fj(CONVER)g(T\),)36
+(Sp)r(ecF)-7 b(rames)427 4899 y(AST)p Ft(_)p Fj(CONVER)g(T\),)36
b(accoun)n(t)f(will)g(b)r(e)h(tak)n(en)f(of)h(the)g(nature)f(of)h(the)g
-(sp)r(ectral)f(co)r(ordinate)f(systems)427 2287 y(they)f(represen)n(t,)
+(sp)r(ectral)f(co)r(ordinate)f(systems)427 4999 y(they)f(represen)n(t,)
g(together)f(with)h(an)n(y)f(qualifying)g(rest)g(frequency)-7
b(,)34 b(standard)d(of)i(rest,)g(ep)r(o)r(c)n(h)g(v)-5
-b(alues,)427 2386 y(etc.)51 b(The)32 b(AlignSystem)g(and)g
+b(alues,)427 5099 y(etc.)51 b(The)32 b(AlignSystem)g(and)g
(AlignStdOfRest)h(attributes)f(will)g(also)f(b)r(e)i(tak)n(en)e(in)n
-(to)h(accoun)n(t.)50 b(The)427 2486 y(results)25 b(will)h(therefore)f
+(to)h(accoun)n(t.)50 b(The)427 5198 y(results)25 b(will)h(therefore)f
(fully)h(re\015ect)g(the)g(relationship)f(b)r(et)n(w)n(een)g(p)r
(ositions)h(measured)f(in)g(the)i(t)n(w)n(o)e(sys-)427
-2586 y(tems.)37 b(In)27 b(addition,)g(an)n(y)f(di\013erence)g(in)h(the)
+5298 y(tems.)37 b(In)27 b(addition,)g(an)n(y)f(di\013erence)g(in)h(the)
g(Unit)h(attributes)f(of)f(the)h(t)n(w)n(o)f(systems)h(will)f(also)g(b)
-r(e)h(tak)n(en)427 2685 y(in)n(to)h(accoun)n(t.)340 2817
+r(e)h(tak)n(en)427 5397 y(in)n(to)h(accoun)n(t.)340 5529
y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f
(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f
(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427
-2917 y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g
-(should)f(fail)h(for)f(an)n(y)g(reason.)p 0 3114 3780
-12 v 0 3245 a FA(AST)p Fe(_)p FA(SPECMAP)1418 3244 y
-Fd(Create)37 b(a)i(Sp)s(ecMap)2775 3245 y FA(AST)p Fe(_)p
-FA(SPECMAP)0 3431 y Fc(Description:)44 b Fj(This)28 b(function)g
-(creates)f(a)g(new)g(Sp)r(ecMap)h(and)g(optionally)e(initialises)i(its)
-f(attributes.)227 3555 y(An)e(Sp)r(ecMap)e(is)h(a)f(sp)r(ecialised)h
-(form)f(of)h(Mapping)f(whic)n(h)h(can)f(b)r(e)h(used)g(to)g(represen)n
-(t)e(a)i(sequence)f(of)h(con)n(v)n(er-)227 3655 y(sions)i(b)r(et)n(w)n
-(een)h(standard)e(sp)r(ectral)h(co)r(ordinate)f(systems.)36
-b(This)27 b(includes)g(con)n(v)n(ersions)c(b)r(et)n(w)n(een)k
-(frequency)-7 b(,)227 3754 y(w)n(a)n(v)n(elength,)36
-b(and)f(v)-5 b(arious)34 b(forms)h(of)g(v)n(elo)r(cit)n(y)-7
-b(,)37 b(as)d(w)n(ell)h(as)g(con)n(v)n(ersions)e(b)r(et)n(w)n(een)i
-(di\013eren)n(t)h(standards)e(of)227 3854 y(rest.)227
-3978 y(When)19 b(a)f(Sp)r(ecMap)h(is)f(\014rst)g(created,)i(it)e
-(simply)h(p)r(erforms)e(a)h(unit)h(\(n)n(ull\))h(Mapping.)33
-b(Using)18 b(the)h(AST)p Ft(_)p Fj(SPECADD)227 4078 y(routine,)31
+5628 y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g
+(should)f(fail)h(for)f(an)n(y)g(reason.)p eop end
+%%Page: 375 385
+TeXDict begin 375 384 bop 3643 52 a FG(375)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(SPECMAP)411 b Fd(Create)37
+b(a)i(Sp)s(ecMap)414 b FA(AST)p Fe(_)p FA(SPECMAP)0 676
+y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g(Sp)r
+(ecMap)h(and)g(optionally)e(initialises)i(its)f(attributes.)227
+803 y(An)e(Sp)r(ecMap)e(is)h(a)f(sp)r(ecialised)h(form)f(of)h(Mapping)f
+(whic)n(h)h(can)f(b)r(e)h(used)g(to)g(represen)n(t)e(a)i(sequence)f(of)
+h(con)n(v)n(er-)227 902 y(sions)i(b)r(et)n(w)n(een)h(standard)e(sp)r
+(ectral)h(co)r(ordinate)f(systems.)36 b(This)27 b(includes)g(con)n(v)n
+(ersions)c(b)r(et)n(w)n(een)k(frequency)-7 b(,)227 1002
+y(w)n(a)n(v)n(elength,)36 b(and)f(v)-5 b(arious)34 b(forms)h(of)g(v)n
+(elo)r(cit)n(y)-7 b(,)37 b(as)d(w)n(ell)h(as)g(con)n(v)n(ersions)e(b)r
+(et)n(w)n(een)i(di\013eren)n(t)h(standards)e(of)227 1102
+y(rest.)227 1229 y(When)19 b(a)f(Sp)r(ecMap)h(is)f(\014rst)g(created,)i
+(it)e(simply)h(p)r(erforms)e(a)h(unit)h(\(n)n(ull\))h(Mapping.)33
+b(Using)18 b(the)h(AST)p Ft(_)p Fj(SPECADD)227 1328 y(routine,)31
b(a)g(series)e(of)i(co)r(ordinate)f(con)n(v)n(ersion)e(steps)j(ma)n(y)e
(then)j(b)r(e)f(added,)g(selected)g(from)f(the)h(list)g(of)g(sup-)227
-4177 y(p)r(orted)k(con)n(v)n(ersions.)57 b(This)35 b(allo)n(ws)f(m)n
+1428 y(p)r(orted)k(con)n(v)n(ersions.)57 b(This)35 b(allo)n(ws)f(m)n
(ulti-step)h(con)n(v)n(ersions)d(b)r(et)n(w)n(een)j(a)g(v)-5
b(ariet)n(y)34 b(of)h(sp)r(ectral)g(co)r(ordinate)227
-4277 y(systems)27 b(to)h(b)r(e)g(assem)n(bled)f(out)g(of)h(the)g
+1527 y(systems)27 b(to)h(b)r(e)g(assem)n(bled)f(out)g(of)h(the)g
(building)g(blo)r(c)n(ks)e(pro)n(vided)h(b)n(y)g(this)h(class.)227
-4401 y(F)-7 b(or)18 b(details)g(of)g(the)h(individual)g(co)r(ordinate)e
+1655 y(F)-7 b(or)18 b(details)g(of)g(the)h(individual)g(co)r(ordinate)e
(con)n(v)n(ersions)f(a)n(v)-5 b(ailable,)19 b(see)f(the)h(description)e
-(of)i(the)f(AST)p Ft(_)p Fj(SPECADD)227 4501 y(routine.)227
-4625 y(Con)n(v)n(ersions)27 b(are)g(a)n(v)-5 b(ailable)28
+(of)i(the)f(AST)p Ft(_)p Fj(SPECADD)227 1754 y(routine.)227
+1881 y(Con)n(v)n(ersions)27 b(are)g(a)n(v)-5 b(ailable)28
b(to)h(transform)e(b)r(et)n(w)n(een)i(standards)f(of)h(rest.)40
b(Suc)n(h)29 b(con)n(v)n(ersions)d(need)j(to)f(kno)n(w)227
-4724 y(the)23 b(source)e(p)r(osition)i(as)e(an)i(RA)f(and)h(DEC.)f
+1981 y(the)23 b(source)e(p)r(osition)i(as)e(an)i(RA)f(and)h(DEC.)f
(This)h(information)e(can)i(b)r(e)f(supplied)h(in)g(the)g(form)f(of)g
-(parameters)227 4824 y(for)27 b(the)g(relev)-5 b(an)n(t)26
+(parameters)227 2081 y(for)27 b(the)g(relev)-5 b(an)n(t)26
b(con)n(v)n(ersions,)e(in)j(whic)n(h)g(case)f(the)h(Sp)r(ecMap)g(is)f
-(1-dimensional,)g(simply)h(transforming)e(the)227 4923
+(1-dimensional,)g(simply)h(transforming)e(the)227 2180
y(sp)r(ectral)c(axis)g(v)-5 b(alues.)35 b(This)21 b(means)g(that)h(the)
g(same)f(source)g(p)r(osition)g(will)h(alw)n(a)n(ys)e(b)r(e)i(used)f(b)
-n(y)g(the)h(Sp)r(ecMap.)227 5023 y(Ho)n(w)n(ev)n(er,)32
+n(y)g(the)h(Sp)r(ecMap.)227 2280 y(Ho)n(w)n(ev)n(er,)32
b(this)h(ma)n(y)f(not)g(b)r(e)h(appropriate)e(for)h(an)h(accurate)e
(description)h(of)g(a)h(3-D)f(sp)r(ectral)g(cub)r(e,)i(where)227
-5123 y(c)n(hanges)c(of)h(spatial)g(p)r(osition)g(can)g(pro)r(duce)f
+2379 y(c)n(hanges)c(of)h(spatial)g(p)r(osition)g(can)g(pro)r(duce)f
(signi\014can)n(t)h(c)n(hanges)f(in)h(the)h(Doppler)f(shift)g(in)n(tro)
-r(duced)g(when)227 5222 y(transforming)19 b(b)r(et)n(w)n(een)h
+r(duced)g(when)227 2479 y(transforming)19 b(b)r(et)n(w)n(een)h
(standards)e(of)i(rest.)34 b(F)-7 b(or)20 b(this)g(situation,)h(a)f
(3-dimensional)e(Sp)r(ecMap)i(can)g(b)r(e)g(created)227
-5322 y(in)30 b(whic)n(h)g(axes)e(2)h(and)h(3)f(corresp)r(ond)f(to)h
+2579 y(in)30 b(whic)n(h)g(axes)e(2)h(and)h(3)f(corresp)r(ond)f(to)h
(the)h(source)e(RA)i(and)g(DEC)f(The)h(Sp)r(ecMap)g(simply)f(copies)g
-(v)-5 b(alues)227 5422 y(for)27 b(axes)g(2)g(and)h(3)f(from)g(input)h
-(to)g(output\).)0 5570 y Fc(In)m(v)m(o)s(cation:)123
+(v)-5 b(alues)227 2678 y(for)27 b(axes)g(2)g(and)h(3)f(from)g(input)h
+(to)g(output\).)0 2833 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_SPECMAP\()c(NIN,)j(FLAGS,)f(OPTIONS,)f(STATUS)
-h(\))0 5718 y Fc(Argumen)m(ts:)p eop end
-%%Page: 373 383
-TeXDict begin 373 382 bop 3643 52 a FG(373)259 351 y
-Fc(NIN)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 451 y Fj(The)22
-b(n)n(um)n(b)r(er)g(of)g(inputs)h(to)f(the)g(Mapping)g(\(this)h(will)f
-(also)f(equal)h(the)g(n)n(um)n(b)r(er)g(of)g(outputs\).)36
-b(This)22 b(v)-5 b(alue)427 551 y(m)n(ust)33 b(b)r(e)g(either)f(1)g(or)
-g(3.)51 b(In)33 b(either)f(case,)h(the)g(\014rst)f(input)h(and)g
-(output)g(corresp)r(oindis)d(the)j(sp)r(ectral)427 650
-y(axis.)45 b(F)-7 b(or)30 b(a)g(3-axis)f(Sp)r(ecMap,)j(the)f(second)f
-(and)g(third)h(axes)f(giv)n(e)f(the)i(RA)g(and)g(DEC)f(\(J2000)f(FK5\))
-427 750 y(of)k(the)g(source.)51 b(This)32 b(p)r(ositional)g
-(information)g(is)h(used)f(b)n(y)h(con)n(v)n(ersions)d(whic)n(h)i
-(transform)g(b)r(et)n(w)n(een)427 849 y(standards)19
+h(\))0 2987 y Fc(Argumen)m(ts:)259 3129 y(NIN)32 b(=)g(INTEGER)f(\(Giv)
+m(en\))427 3229 y Fj(The)22 b(n)n(um)n(b)r(er)g(of)g(inputs)h(to)f(the)
+g(Mapping)g(\(this)h(will)f(also)f(equal)h(the)g(n)n(um)n(b)r(er)g(of)g
+(outputs\).)36 b(This)22 b(v)-5 b(alue)427 3328 y(m)n(ust)33
+b(b)r(e)g(either)f(1)g(or)g(3.)51 b(In)33 b(either)f(case,)h(the)g
+(\014rst)f(input)h(and)g(output)g(corresp)r(oindis)d(the)j(sp)r(ectral)
+427 3428 y(axis.)45 b(F)-7 b(or)30 b(a)g(3-axis)f(Sp)r(ecMap,)j(the)f
+(second)f(and)g(third)h(axes)f(giv)n(e)f(the)i(RA)g(and)g(DEC)f
+(\(J2000)f(FK5\))427 3527 y(of)k(the)g(source.)51 b(This)32
+b(p)r(ositional)g(information)g(is)h(used)f(b)n(y)h(con)n(v)n(ersions)d
+(whic)n(h)i(transform)g(b)r(et)n(w)n(een)427 3627 y(standards)19
b(of)i(rest,)g(and)f(replaces)f(the)i Ft(")p Fj(RA)p
Ft(")f Fj(and)g Ft(")p Fj(DEC)p Ft(")f Fj(argumen)n(ts)g(for)h(the)h
-(individual)f(con)n(v)n(ersions)427 949 y(listed)28 b(in)g(description)
-f(of)h(the)g Ft(")p Fj(Sp)r(ecAdd)p Ft(")f Fj(routine.)259
-1080 y Fc(FLA)m(GS)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
-1179 y Fj(This)d(argumen)n(t)e(is)i(reserv)n(ed)e(for)h(future)h(use)f
-(and)h(should)f(curren)n(tly)g(alw)n(a)n(ys)e(b)r(e)j(set)g(to)f(zero.)
-259 1310 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f
-Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1410 y Fj(A)22
-b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)f
-(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r(e)
-427 1509 y(used)k(for)e(initialising)i(the)f(new)h(Sp)r(ecMap.)36
+(individual)f(con)n(v)n(ersions)427 3727 y(listed)28
+b(in)g(description)f(of)h(the)g Ft(")p Fj(Sp)r(ecAdd)p
+Ft(")f Fj(routine.)259 3862 y Fc(FLA)m(GS)33 b(=)f(INTEGER)f(\(Giv)m
+(en\))427 3962 y Fj(This)d(argumen)n(t)e(is)i(reserv)n(ed)e(for)h
+(future)h(use)f(and)h(should)f(curren)n(tly)g(alw)n(a)n(ys)e(b)r(e)j
+(set)g(to)f(zero.)259 4097 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g
+Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
+4197 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)
+f(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r
+(e)427 4296 y(used)k(for)e(initialising)i(the)f(new)h(Sp)r(ecMap.)36
b(The)24 b(syn)n(tax)g(used)g(is)g(iden)n(tical)g(to)h(that)f(for)g
-(the)h(AST)p Ft(_)p Fj(SET)427 1609 y(routine.)37 b(If)28
+(the)h(AST)p Ft(_)p Fj(SET)427 4396 y(routine.)37 b(If)28
b(no)f(initialisation)g(is)h(required,)e(a)i(blank)f(v)-5
-b(alue)27 b(ma)n(y)g(b)r(e)h(supplied.)259 1740 y Fc(ST)-8
+b(alue)27 b(ma)n(y)g(b)r(e)h(supplied.)259 4531 y Fc(ST)-8
b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-1839 y Fj(The)c(global)e(status.)0 1999 y Fc(Returned)32
-b(V)-8 b(alue:)259 2134 y(AST)p Ft(_)p Fc(SPECMAP)32
-b(=)g(INTEGER)427 2233 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(Sp)r
-(ecMap.)0 2393 y Fc(Notes:)340 2674 y Fi(\017)45 b Fj(The)32
+4631 y Fj(The)c(global)e(status.)0 4798 y Fc(Returned)32
+b(V)-8 b(alue:)259 4940 y(AST)p Ft(_)p Fc(SPECMAP)32
+b(=)g(INTEGER)427 5039 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(Sp)r
+(ecMap.)0 5206 y Fc(Notes:)340 5494 y Fi(\017)45 b Fj(The)32
b(nature)e(and)i(units)f(of)g(the)h(co)r(ordinate)e(v)-5
b(alues)31 b(supplied)h(for)e(the)i(\014rst)f(input)h(\(i.e.)49
-b(the)31 b(sp)r(ectral)427 2773 y(input\))23 b(of)e(a)g(Sp)r(ecMap)h(m)
+b(the)31 b(sp)r(ectral)427 5593 y(input\))23 b(of)e(a)g(Sp)r(ecMap)h(m)
n(ust)g(b)r(e)g(appropriate)d(to)j(the)g(\014rst)f(con)n(v)n(ersion)e
-(step)j(applied)f(b)n(y)g(the)h(Sp)r(ecMap.)427 2873
+(step)j(applied)f(b)n(y)g(the)h(Sp)r(ecMap.)427 5693
y(F)-7 b(or)19 b(instance,)j(if)e(the)g(\014rst)f(con)n(v)n(ersion)f
(step)i(is)f Ft(")p Fj(FR)-7 b(TO)n(VL)p Ft(")19 b Fj(\(frequency)h(to)
-f(relativistic)g(v)n(elo)r(cit)n(y\),)i(then)427 2972
-y(the)34 b(co)r(ordinate)e(v)-5 b(alues)32 b(for)h(the)h(\014rst)e
-(input)i(should)f(b)r(e)h(frequency)e(in)i(units)f(of)g(Hz.)54
-b(Similarly)-7 b(,)34 b(the)427 3072 y(nature)k(and)h(units)g(of)f(the)
-h(co)r(ordinate)f(v)-5 b(alues)38 b(returned)g(b)n(y)g(a)h(Sp)r(ecMap)f
-(will)h(b)r(e)g(determined)g(b)n(y)427 3172 y(the)c(last)f(con)n(v)n
-(ersion)e(step)i(applied)g(b)n(y)g(the)h(Sp)r(ecMap.)56
-b(F)-7 b(or)34 b(instance,)h(if)g(the)g(last)f(con)n(v)n(ersion)d(step)
-427 3271 y(is)k Ft(")p Fj(VL)-7 b(TO)n(V)n(O)p Ft(")33
-b Fj(\(relativistic)h(v)n(elo)r(cit)n(y)g(to)g(optical)g(v)n(elo)r(cit)
-n(y\),)i(then)f(the)g(co)r(ordinate)f(v)-5 b(alues)34
-b(for)g(the)427 3371 y(\014rst)29 b(output)g(will)g(b)r(e)g(optical)g
-(v)n(elo)r(cit)n(y)e(in)j(units)f(of)f(metres)h(p)r(er)g(second.)39
-b(See)29 b(the)g(description)f(of)h(the)427 3471 y(AST)p
-Ft(_)p Fj(SPECADD)f(routine)f(for)g(the)h(units)g(exp)r(ected)g(and)g
-(returned)f(b)n(y)g(eac)n(h)g(con)n(v)n(ersion.)340 3601
+f(relativistic)g(v)n(elo)r(cit)n(y\),)i(then)p eop end
+%%Page: 376 386
+TeXDict begin 376 385 bop 0 52 a FG(376)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(the)j(co)r(ordinate)e
+(v)-5 b(alues)32 b(for)h(the)h(\014rst)e(input)i(should)f(b)r(e)h
+(frequency)e(in)i(units)f(of)g(Hz.)54 b(Similarly)-7
+b(,)34 b(the)427 451 y(nature)k(and)h(units)g(of)f(the)h(co)r(ordinate)
+f(v)-5 b(alues)38 b(returned)g(b)n(y)g(a)h(Sp)r(ecMap)f(will)h(b)r(e)g
+(determined)g(b)n(y)427 551 y(the)c(last)f(con)n(v)n(ersion)e(step)i
+(applied)g(b)n(y)g(the)h(Sp)r(ecMap.)56 b(F)-7 b(or)34
+b(instance,)h(if)g(the)g(last)f(con)n(v)n(ersion)d(step)427
+650 y(is)k Ft(")p Fj(VL)-7 b(TO)n(V)n(O)p Ft(")33 b Fj(\(relativistic)h
+(v)n(elo)r(cit)n(y)g(to)g(optical)g(v)n(elo)r(cit)n(y\),)i(then)f(the)g
+(co)r(ordinate)f(v)-5 b(alues)34 b(for)g(the)427 750
+y(\014rst)29 b(output)g(will)g(b)r(e)g(optical)g(v)n(elo)r(cit)n(y)e
+(in)j(units)f(of)f(metres)h(p)r(er)g(second.)39 b(See)29
+b(the)g(description)f(of)h(the)427 849 y(AST)p Ft(_)p
+Fj(SPECADD)f(routine)f(for)g(the)h(units)g(exp)r(ected)g(and)g
+(returned)f(b)n(y)g(eac)n(h)g(con)n(v)n(ersion.)340 980
y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f
(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f
(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427
-3701 y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g
-(should)f(fail)h(for)f(an)n(y)g(reason.)p 0 3896 3780
-12 v 0 4027 a FA(AST)p Fe(_)p FA(SPHMAP)1439 4028 y Fd(Create)38
-b(a)g(SphMap)2855 4027 y FA(AST)p Fe(_)p FA(SPHMAP)0
-4213 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+1080 y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g
+(should)f(fail)h(for)f(an)n(y)g(reason.)p 0 1275 3780
+12 v 0 1405 a FA(AST)p Fe(_)p FA(SPHMAP)1439 1406 y Fd(Create)38
+b(a)g(SphMap)2855 1405 y FA(AST)p Fe(_)p FA(SPHMAP)0
+1591 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
(SphMap)h(and)g(optionally)e(initialises)i(its)f(attributes.)227
-4336 y(A)21 b(SphMap)g(is)f(a)g(Mapping)h(whic)n(h)f(transforms)f(p)r
+1714 y(A)21 b(SphMap)g(is)f(a)g(Mapping)h(whic)n(h)f(transforms)f(p)r
(oin)n(ts)i(from)f(a)g(3-dimensional)f(Cartesian)g(co)r(ordinate)h
-(system)227 4436 y(in)n(to)28 b(a)g(2-dimensional)f(spherical)g(co)r
+(system)227 1814 y(in)n(to)28 b(a)g(2-dimensional)f(spherical)g(co)r
(ordinate)g(system)h(\(longitude)g(and)g(latitude)g(on)g(a)g(unit)h
-(sphere)e(cen)n(tred)227 4535 y(at)33 b(the)f(origin\).)51
+(sphere)e(cen)n(tred)227 1914 y(at)33 b(the)f(origin\).)51
b(It)33 b(w)n(orks)d(b)n(y)j(regarding)d(the)j(input)g(co)r(ordinates)e
(as)h(p)r(osition)g(v)n(ectors)f(and)h(\014nding)h(their)227
-4635 y(in)n(tersection)25 b(with)h(the)h(sphere)e(surface.)35
+2013 y(in)n(tersection)25 b(with)h(the)h(sphere)e(surface.)35
b(The)26 b(in)n(v)n(erse)e(transformation)g(alw)n(a)n(ys)g(pro)r(duces)
-h(p)r(oin)n(ts)h(whic)n(h)g(are)227 4735 y(a)h(unit)i(distance)e(from)g
+h(p)r(oin)n(ts)h(whic)n(h)g(are)227 2113 y(a)h(unit)i(distance)e(from)g
(the)h(origin)f(\(i.e.)37 b(unit)28 b(v)n(ectors\).)0
-4882 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_SPHMAP\()c
-(OPTIONS,)h(STATUS)h(\))0 5029 y Fc(Argumen)m(ts:)259
-5164 y(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 5263 y Fj(A)22 b(c)n(haracter)e
+2260 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_SPHMAP\()c
+(OPTIONS,)h(STATUS)h(\))0 2407 y Fc(Argumen)m(ts:)259
+2542 y(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 2641 y Fj(A)22 b(c)n(haracter)e
(string)h(con)n(taining)g(an)h(optional)f(comma-separated)e(list)j(of)g
-(attribute)g(assignmen)n(ts)f(to)g(b)r(e)427 5363 y(used)27
+(attribute)g(assignmen)n(ts)f(to)g(b)r(e)427 2741 y(used)27
b(for)f(initialising)g(the)h(new)f(SphMap.)37 b(The)26
b(syn)n(tax)g(used)g(is)h(iden)n(tical)f(to)g(that)h(for)f(the)h(AST)p
-Ft(_)p Fj(SET)427 5463 y(routine.)259 5593 y Fc(ST)-8
+Ft(_)p Fj(SET)427 2841 y(routine.)259 2971 y Fc(ST)-8
b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-5693 y Fj(The)c(global)e(status.)p eop end
-%%Page: 374 384
-TeXDict begin 374 383 bop 0 52 a FG(374)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Returned)h(V)-8
-b(alue:)259 490 y(AST)p Ft(_)p Fc(SPHMAP)32 b(=)g(INTEGER)427
-589 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(SphMap.)0
-753 y Fc(Notes:)340 1037 y Fi(\017)45 b Fj(The)39 b(spherical)f(co)r
+3071 y Fj(The)c(global)e(status.)0 3231 y Fc(Returned)32
+b(V)-8 b(alue:)259 3365 y(AST)p Ft(_)p Fc(SPHMAP)32 b(=)g(INTEGER)427
+3465 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(SphMap.)0
+3624 y Fc(Notes:)340 3905 y Fi(\017)45 b Fj(The)39 b(spherical)f(co)r
(ordinates)f(are)h(longitude)g(\(p)r(ositiv)n(e)h(an)n(ti-clo)r(c)n
(kwise)e(lo)r(oking)h(from)g(the)h(p)r(ositiv)n(e)427
-1137 y(latitude)24 b(p)r(ole\))f(and)g(latitude.)36 b(The)23
+4004 y(latitude)24 b(p)r(ole\))f(and)g(latitude.)36 b(The)23
b(Cartesian)f(co)r(ordinates)g(are)g(righ)n(t-handed,)h(with)g(the)h(x)
-f(axis)f(\(axis)427 1237 y(1\))28 b(at)f(zero)g(longitude)g(and)h
+f(axis)f(\(axis)427 4104 y(1\))28 b(at)f(zero)g(longitude)g(and)h
(latitude,)g(and)f(the)h(z)g(axis)e(\(axis)i(3\))f(at)g(the)h(p)r
-(ositiv)n(e)g(latitude)g(p)r(ole.)340 1370 y Fi(\017)45
+(ositiv)n(e)g(latitude)g(p)r(ole.)340 4235 y Fi(\017)45
b Fj(A)n(t)28 b(either)g(p)r(ole,)f(the)h(longitude)g(is)f(set)h(to)f
(the)h(v)-5 b(alue)28 b(of)f(the)h(P)n(olarLong)d(attribute.)340
-1504 y Fi(\017)45 b Fj(If)28 b(the)f(Cartesian)f(co)r(ordinates)g(are)g
+4365 y Fi(\017)45 b Fj(If)28 b(the)f(Cartesian)f(co)r(ordinates)g(are)g
(all)h(zero,)f(then)h(the)h(longitude)f(and)g(latitude)g(are)f(set)h
-(to)g(the)h(v)-5 b(alue)427 1604 y(AST)p Ft(__)p Fj(BAD.)340
-1737 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20
+(to)g(the)h(v)-5 b(alue)427 4465 y(AST)p Ft(__)p Fj(BAD.)340
+4596 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20
b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e
(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 1837 y(set)28 b(to)f(an)h(error)d(v)-5
+b(A)g(TUS)427 4695 y(set)28 b(to)f(an)h(error)d(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)-2
-2001 y Fc(Status)33 b(Handling)n(:)227 2147 y Fj(The)d(protected)g(in)n
+4855 y Fc(Status)33 b(Handling)n(:)227 5001 y Fj(The)d(protected)g(in)n
(terface)f(to)g(this)h(function)h(includes)f(an)f(extra)g(parameter)f
-(at)i(the)g(end)g(of)g(the)g(parameter)227 2247 y(list)37
+(at)i(the)g(end)g(of)g(the)g(parameter)227 5101 y(list)37
b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)
r(oin)n(ter)g(to)h(the)g(in)n(teger)e(inherited)i(status)f(v)-5
-b(ariable:)54 b Ft(")p Fj(in)n(t)227 2346 y Fi(\003)p
-Fj(status)p Ft(")p Fj(.)-2 2497 y Fc(Status)33 b(Handling)n(:)227
-2644 y Fj(The)d(protected)g(in)n(terface)f(to)g(this)h(function)h
+b(ariable:)54 b Ft(")p Fj(in)n(t)227 5200 y Fi(\003)p
+Fj(status)p Ft(")p Fj(.)-2 5348 y Fc(Status)33 b(Handling)n(:)227
+5494 y Fj(The)d(protected)g(in)n(terface)f(to)g(this)h(function)h
(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g(the)g
-(parameter)227 2743 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62
+(parameter)227 5593 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62
b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)
e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fj(in)n(t)227
-2843 y Fi(\003)p Fj(status)p Ft(")p Fj(.)-2 2994 y Fc(Status)33
-b(Handling)n(:)227 3140 y Fj(The)d(protected)g(in)n(terface)f(to)g
-(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
-(of)g(the)g(parameter)227 3240 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
-(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
-(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
-Fj(in)n(t)227 3339 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p
-0 3541 3780 12 v 0 3671 a FA(AST)p Fe(_)p FA(STCCA)-11
-b(T)g(ALOGENTR)g(YLOCA)g(TION)2602 3689 y Fd(Create)2602
-3788 y(a)2602 3888 y(Stc-)2602 3988 y(Cat-)2602 4087
-y(a-)2602 4187 y(lo-)2602 4287 y(gEn-)2602 4386 y(try-)2602
-4499 y(Lo-)2602 4599 y(ca-)2602 4699 y(tion)2752 3671
-y FA(AST)p Fe(_)p FA(STCCA)g(T)g(ALOGENTR)g(YLOCA)g(TION)0
-4866 y Fc(Description:)44 b Fj(This)39 b(function)g(creates)f(a)g(new)h
-(StcCatalogEn)n(tryLo)r(cation)c(and)k(optionally)f(initialises)g(its)h
-(at-)227 4966 y(tributes.)227 5091 y(The)20 b(StcCatalogEn)n(tryLo)r
-(cation)c(class)i(is)h(a)g(sub-class)f(of)h(Stc)h(used)f(to)h(describ)r
-(e)e(the)i(co)n(v)n(erage)c(of)k(the)f(datasets)227 5191
-y(con)n(tained)27 b(in)h(some)f(V)n(O)g(resource.)227
-5316 y(See)h(h)n(ttp://hea-www.harv)-5 b(ard.edu/)p Fi(\030)p
-Fj(arots/n)n(v)n(o)o(meta/STC.h)n(tml)0 5468 y Fc(In)m(v)m(o)s(cation:)
-123 b Ft(RESULT)41 b(=)i(AST_STCCATALOGEN)o(TRY)o(LO)o(CAT)o(IO)o(N\()
-37 b(REGION,)k(NCOORDS,)f(COORDS,)h(OPTIONS,)f(STATUS)227
-5567 y(\))0 5718 y Fc(Argumen)m(ts:)p eop end
-%%Page: 375 385
-TeXDict begin 375 384 bop 3643 52 a FG(375)259 351 y
-Fc(REGION)31 b(=)h(INTEGER)f(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(encapsulated)f(Region.)259 581 y Fc(NCOORDS)k(=)h(INTEGER)
-f(\(Giv)m(en\))427 680 y Fj(The)d(length)g(of)f(the)h(COORDS)g(arra)n
-(y)-7 b(.)34 b(Supply)28 b(zero)f(if)h(COORDS)f(should)h(b)r(e)g
-(ignored.)259 810 y Fc(COORDS\()j(NCOORDS)g(\))h(=)g(INTEGER)f(\(Giv)m
-(en\))427 910 y Fj(An)20 b(arra)n(y)c(holding)j(NCOORDS)g(AstKeyMap)f
-(p)r(oin)n(ters)h(\(if)h(NCOORDS)f(is)f(zero,)i(the)g(supplied)f(v)-5
-b(alue)19 b(is)427 1009 y(ignored\).)35 b(Eac)n(h)24
+5693 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p eop end
+%%Page: 377 387
+TeXDict begin 377 386 bop 3643 52 a FG(377)-2 351 y Fc(Status)33
+b(Handling)n(:)227 497 y Fj(The)d(protected)g(in)n(terface)f(to)g(this)
+h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g
+(the)g(parameter)227 597 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62
+b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)
+e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fj(in)n(t)227
+697 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p 0 891 3780
+12 v 0 1022 a FA(AST)p Fe(_)p FA(STCCA)-11 b(T)g(ALOGENTR)g(YLOCA)g
+(TION)2602 1039 y Fd(Create)2602 1139 y(a)2602 1239 y(Stc-)2602
+1338 y(Cat-)2602 1438 y(a-)2602 1538 y(lo-)2602 1637
+y(gEn-)2602 1737 y(try-)2602 1850 y(Lo-)2602 1950 y(ca-)2602
+2049 y(tion)2752 1022 y FA(AST)p Fe(_)p FA(STCCA)g(T)g(ALOGENTR)g
+(YLOCA)g(TION)0 2210 y Fc(Description:)44 b Fj(This)39
+b(function)g(creates)f(a)g(new)h(StcCatalogEn)n(tryLo)r(cation)c(and)k
+(optionally)f(initialises)g(its)h(at-)227 2310 y(tributes.)227
+2433 y(The)20 b(StcCatalogEn)n(tryLo)r(cation)c(class)i(is)h(a)g
+(sub-class)f(of)h(Stc)h(used)f(to)h(describ)r(e)e(the)i(co)n(v)n(erage)
+c(of)k(the)f(datasets)227 2533 y(con)n(tained)27 b(in)h(some)f(V)n(O)g
+(resource.)227 2656 y(See)h(h)n(ttp://hea-www.harv)-5
+b(ard.edu/)p Fi(\030)p Fj(arots/n)n(v)n(o)o(meta/STC.h)n(tml)0
+2803 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i
+(AST_STCCATALOGEN)o(TRY)o(LO)o(CAT)o(IO)o(N\()37 b(REGION,)k(NCOORDS,)f
+(COORDS,)h(OPTIONS,)f(STATUS)227 2903 y(\))0 3050 y Fc(Argumen)m(ts:)
+259 3184 y(REGION)31 b(=)h(INTEGER)f(\(Giv)m(en\))427
+3284 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(encapsulated)f(Region.)259
+3414 y Fc(NCOORDS)k(=)h(INTEGER)f(\(Giv)m(en\))427 3514
+y Fj(The)d(length)g(of)f(the)h(COORDS)g(arra)n(y)-7 b(.)34
+b(Supply)28 b(zero)f(if)h(COORDS)f(should)h(b)r(e)g(ignored.)259
+3644 y Fc(COORDS\()j(NCOORDS)g(\))h(=)g(INTEGER)f(\(Giv)m(en\))427
+3744 y Fj(An)20 b(arra)n(y)c(holding)j(NCOORDS)g(AstKeyMap)f(p)r(oin)n
+(ters)h(\(if)h(NCOORDS)f(is)f(zero,)i(the)g(supplied)f(v)-5
+b(alue)19 b(is)427 3843 y(ignored\).)35 b(Eac)n(h)24
b(supplied)h(KeyMap)f(describ)r(es)g(the)h(con)n(ten)n(ts)g(of)f(a)h
(single)f(STC)h Fl(<)p Fj(AstroCo)r(ords)p Fl(>)d Fj(ele-)427
-1109 y(men)n(t,)f(and)d(should)g(ha)n(v)n(e)f(elemen)n(ts)i(with)f(k)n
+3943 y(men)n(t,)f(and)d(should)g(ha)n(v)n(e)f(elemen)n(ts)i(with)f(k)n
(eys)g(giv)n(en)f(b)n(y)i(constan)n(ts)e(AST)p Ft(__)p
-Fj(STCNAME,)h(AST)p Ft(__)p Fj(STCV)-9 b(ALUE,)427 1209
+Fj(STCNAME,)h(AST)p Ft(__)p Fj(STCV)-9 b(ALUE,)427 4043
y(AST)p Ft(__)p Fj(STCERR)n(OR,)21 b(AST)p Ft(__)p Fj(STCRES,)g(AST)p
Ft(__)p Fj(STCSIZE,)g(AST)p Ft(__)p Fj(STCPIXSZ.)g(An)n(y)h(of)f(these)
-h(ele-)427 1308 y(men)n(ts)d(ma)n(y)e(b)r(e)i(omitted,)i(but)e(no)f
+h(ele-)427 4142 y(men)n(ts)d(ma)n(y)e(b)r(e)i(omitted,)i(but)e(no)f
(other)g(elemen)n(ts)g(should)g(b)r(e)h(included.)34
b(If)19 b(supplied,)i(the)d(AST)p Ft(__)p Fj(STCNAME)427
-1408 y(elemen)n(t)23 b(should)g(b)r(e)h(a)e(v)n(ector)g(of)h(c)n
+4242 y(elemen)n(t)23 b(should)g(b)r(e)h(a)e(v)n(ector)g(of)h(c)n
(haracter)e(string)h(p)r(oin)n(ters)h(holding)f(the)i
Ft(")p Fj(Name)p Ft(")e Fj(item)i(for)e(eac)n(h)g(axis)427
-1507 y(in)34 b(the)g(co)r(ordinate)e(system)i(represen)n(ted)e(b)n(y)h
+4341 y(in)34 b(the)g(co)r(ordinate)e(system)i(represen)n(ted)e(b)n(y)h
(REGION.)g(An)n(y)h(other)f(supplied)h(elemen)n(ts)f(should)g(b)r(e)427
-1607 y(scalar)22 b(elemen)n(ts,)i(eac)n(h)f(holding)g(a)g(p)r(oin)n
+4441 y(scalar)22 b(elemen)n(ts,)i(eac)n(h)f(holding)g(a)g(p)r(oin)n
(ter)g(to)g(a)g(Region)f(describing)h(the)h(asso)r(ciated)e(item)i(of)f
-(ancillary)427 1707 y(information)37 b(\(error,)h(resolution,)g(size,)h
+(ancillary)427 4541 y(information)37 b(\(error,)h(resolution,)g(size,)h
(pixel)f(size)e(or)h(v)-5 b(alue\).)65 b(These)37 b(Regions)f(should)h
-(describ)r(e)g(a)427 1806 y(v)n(olume)27 b(within)i(the)f(co)r
+(describ)r(e)g(a)427 4640 y(v)n(olume)27 b(within)i(the)f(co)r
(ordinate)e(system)h(represen)n(ted)g(b)n(y)g(REGION.)259
-1936 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 2036 y Fj(A)g(c)n(haracter)e(string)
+4771 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 4870 y Fj(A)g(c)n(haracter)e(string)
h(con)n(taining)f(an)h(optional)g(comma-separated)e(list)j(of)g
-(attribute)f(assignmen)n(ts)g(to)427 2135 y(b)r(e)36
+(attribute)f(assignmen)n(ts)g(to)427 4970 y(b)r(e)36
b(used)e(for)h(initialising)g(the)g(new)g(StcCatalogEn)n(tryLo)r
(cation.)55 b(The)35 b(syn)n(tax)f(used)h(is)g(iden)n(tical)g(to)427
-2235 y(that)28 b(for)f(the)h(AST)p Ft(_)p Fj(SET)f(routine.)259
-2365 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 2464 y Fj(The)c(global)e(status.)0 2623
-y Fc(Returned)32 b(V)-8 b(alue:)259 2757 y(AST)p Ft(_)p
+5070 y(that)28 b(for)f(the)h(AST)p Ft(_)p Fj(SET)f(routine.)259
+5200 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 5300 y Fj(The)c(global)e(status.)0 5459
+y Fc(Returned)32 b(V)-8 b(alue:)259 5593 y(AST)p Ft(_)p
Fc(STCCA)g(T)g(ALOGENTR)g(YLOCA)g(TION)34 b(=)e(INTEGER)427
-2856 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(StcCatalogEn)n(tryLo)r
-(cation.)0 3015 y Fc(Notes:)340 3294 y Fi(\017)45 b Fj(A)27
-b(deep)g(cop)n(y)e(is)h(tak)n(en)g(of)h(the)f(supplied)h(Region.)36
-b(This)26 b(means)g(that)h(an)n(y)f(subsequen)n(t)g(c)n(hanges)f(made)
-427 3394 y(to)j(the)g(encapsulated)f(Region)g(using)g(the)h(supplied)g
-(p)r(oin)n(ter)f(will)h(ha)n(v)n(e)e(no)i(e\013ect)g(on)f(the)h(Stc.)
-340 3524 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20
-b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e
-(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 3623 y(set)28 b(to)f(an)h(error)d(v)-5
-b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-0 3817 3780 12 v 0 3947 a FA(AST)p Fe(_)p FA(STCOBSD)l(A)-11
-b(T)g(ALOCA)g(TION)2110 3965 y Fd(Create)2110 4064 y(a)2110
-4164 y(StcOb-)2110 4264 y(s-)2110 4363 y(Dat-)2110 4463
-y(aLo-)2110 4563 y(ca-)2110 4662 y(tion)2260 3947 y FA(AST)p
-Fe(_)p FA(STCOBSD)l(A)g(T)g(ALOCA)g(TION)0 4822 y Fc(Description:)44
-b Fj(This)28 b(function)g(creates)f(a)g(new)g(StcObsDataLo)r(cation)g
-(and)g(optionally)g(initialises)g(its)h(attributes.)227
-4945 y(The)j(StcObsDataLo)r(cation)e(class)h(is)g(a)g(sub-class)f(of)i
-(Stc)g(used)f(to)g(describ)r(e)h(the)g(co)n(v)n(erage)c(of)k(the)f
-(datasets)227 5044 y(con)n(tained)d(in)h(some)f(V)n(O)g(resource.)227
-5167 y(See)h(h)n(ttp://hea-www.harv)-5 b(ard.edu/)p Fi(\030)p
-Fj(arots/n)n(v)n(o)o(meta/STC.h)n(tml)0 5314 y Fc(In)m(v)m(o)s(cation:)
+5693 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(StcCatalogEn)n(tryLo)r
+(cation.)p eop end
+%%Page: 378 388
+TeXDict begin 378 387 bop 0 52 a FG(378)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Notes:)340
+629 y Fi(\017)45 b Fj(A)27 b(deep)g(cop)n(y)e(is)h(tak)n(en)g(of)h(the)
+f(supplied)h(Region.)36 b(This)26 b(means)g(that)h(an)n(y)f(subsequen)n
+(t)g(c)n(hanges)f(made)427 729 y(to)j(the)g(encapsulated)f(Region)g
+(using)g(the)h(supplied)g(p)r(oin)n(ter)f(will)h(ha)n(v)n(e)e(no)i
+(e\013ect)g(on)f(the)h(Stc.)340 858 y Fi(\017)45 b Fj(A)21
+b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
+Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 957
+y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 1148 3780 12 v 0 1279
+a FA(AST)p Fe(_)p FA(STCOBSD)l(A)-11 b(T)g(ALOCA)g(TION)2110
+1296 y Fd(Create)2110 1396 y(a)2110 1495 y(StcOb-)2110
+1595 y(s-)2110 1695 y(Dat-)2110 1794 y(aLo-)2110 1894
+y(ca-)2110 1994 y(tion)2260 1279 y FA(AST)p Fe(_)p FA(STCOBSD)l(A)g(T)g
+(ALOCA)g(TION)0 2151 y Fc(Description:)44 b Fj(This)28
+b(function)g(creates)f(a)g(new)g(StcObsDataLo)r(cation)g(and)g
+(optionally)g(initialises)g(its)h(attributes.)227 2273
+y(The)j(StcObsDataLo)r(cation)e(class)h(is)g(a)g(sub-class)f(of)i(Stc)g
+(used)f(to)g(describ)r(e)h(the)g(co)n(v)n(erage)c(of)k(the)f(datasets)
+227 2373 y(con)n(tained)d(in)h(some)f(V)n(O)g(resource.)227
+2495 y(See)h(h)n(ttp://hea-www.harv)-5 b(ard.edu/)p Fi(\030)p
+Fj(arots/n)n(v)n(o)o(meta/STC.h)n(tml)0 2640 y Fc(In)m(v)m(o)s(cation:)
123 b Ft(RESULT)41 b(=)i(AST_STCOBSDATALO)o(CAT)o(IO)o(N\()37
b(REGION,)k(NCOORDS,)f(COORDS,)h(OPTIONS,)f(STATUS)h(\))0
-5460 y Fc(Argumen)m(ts:)259 5593 y(REGION)31 b(=)h(INTEGER)f(\(Giv)m
-(en\))427 5693 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(encapsulated)f
-(Region.)p eop end
-%%Page: 376 386
-TeXDict begin 376 385 bop 0 52 a FG(376)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(NCOORDS)g(=)h
-(INTEGER)f(\(Giv)m(en\))427 451 y Fj(The)d(length)g(of)f(the)h(COORDS)g
-(arra)n(y)-7 b(.)34 b(Supply)28 b(zero)f(if)h(COORDS)f(should)h(b)r(e)g
-(ignored.)259 586 y Fc(COORDS\()j(NCOORDS)g(\))h(=)g(INTEGER)f(\(Giv)m
-(en\))427 685 y Fj(An)20 b(arra)n(y)c(holding)j(NCOORDS)g(AstKeyMap)f
-(p)r(oin)n(ters)h(\(if)h(NCOORDS)f(is)f(zero,)i(the)g(supplied)f(v)-5
-b(alue)19 b(is)427 785 y(ignored\).)35 b(Eac)n(h)24 b(supplied)h
-(KeyMap)f(describ)r(es)g(the)h(con)n(ten)n(ts)g(of)f(a)h(single)f(STC)h
-Fl(<)p Fj(AstroCo)r(ords)p Fl(>)d Fj(ele-)427 885 y(men)n(t,)f(and)d
-(should)g(ha)n(v)n(e)f(elemen)n(ts)i(with)f(k)n(eys)g(giv)n(en)f(b)n(y)
-i(constan)n(ts)e(AST)p Ft(__)p Fj(STCNAME,)h(AST)p Ft(__)p
-Fj(STCV)-9 b(ALUE,)427 984 y(AST)p Ft(__)p Fj(STCERR)n(OR,)21
-b(AST)p Ft(__)p Fj(STCRES,)g(AST)p Ft(__)p Fj(STCSIZE,)g(AST)p
-Ft(__)p Fj(STCPIXSZ.)g(An)n(y)h(of)f(these)h(ele-)427
-1084 y(men)n(ts)d(ma)n(y)e(b)r(e)i(omitted,)i(but)e(no)f(other)g
-(elemen)n(ts)g(should)g(b)r(e)h(included.)34 b(If)19
-b(supplied,)i(the)d(AST)p Ft(__)p Fj(STCNAME)427 1183
-y(elemen)n(t)23 b(should)g(b)r(e)h(a)e(v)n(ector)g(of)h(c)n(haracter)e
-(string)h(p)r(oin)n(ters)h(holding)f(the)i Ft(")p Fj(Name)p
-Ft(")e Fj(item)i(for)e(eac)n(h)g(axis)427 1283 y(in)34
-b(the)g(co)r(ordinate)e(system)i(represen)n(ted)e(b)n(y)h(REGION.)g(An)
-n(y)h(other)f(supplied)h(elemen)n(ts)f(should)g(b)r(e)427
-1383 y(scalar)22 b(elemen)n(ts,)i(eac)n(h)f(holding)g(a)g(p)r(oin)n
+2785 y Fc(Argumen)m(ts:)259 2917 y(REGION)31 b(=)h(INTEGER)f(\(Giv)m
+(en\))427 3017 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(encapsulated)f
+(Region.)259 3145 y Fc(NCOORDS)k(=)h(INTEGER)f(\(Giv)m(en\))427
+3245 y Fj(The)d(length)g(of)f(the)h(COORDS)g(arra)n(y)-7
+b(.)34 b(Supply)28 b(zero)f(if)h(COORDS)f(should)h(b)r(e)g(ignored.)259
+3374 y Fc(COORDS\()j(NCOORDS)g(\))h(=)g(INTEGER)f(\(Giv)m(en\))427
+3473 y Fj(An)20 b(arra)n(y)c(holding)j(NCOORDS)g(AstKeyMap)f(p)r(oin)n
+(ters)h(\(if)h(NCOORDS)f(is)f(zero,)i(the)g(supplied)f(v)-5
+b(alue)19 b(is)427 3573 y(ignored\).)35 b(Eac)n(h)24
+b(supplied)h(KeyMap)f(describ)r(es)g(the)h(con)n(ten)n(ts)g(of)f(a)h
+(single)f(STC)h Fl(<)p Fj(AstroCo)r(ords)p Fl(>)d Fj(ele-)427
+3673 y(men)n(t,)f(and)d(should)g(ha)n(v)n(e)f(elemen)n(ts)i(with)f(k)n
+(eys)g(giv)n(en)f(b)n(y)i(constan)n(ts)e(AST)p Ft(__)p
+Fj(STCNAME,)h(AST)p Ft(__)p Fj(STCV)-9 b(ALUE,)427 3772
+y(AST)p Ft(__)p Fj(STCERR)n(OR,)21 b(AST)p Ft(__)p Fj(STCRES,)g(AST)p
+Ft(__)p Fj(STCSIZE,)g(AST)p Ft(__)p Fj(STCPIXSZ.)g(An)n(y)h(of)f(these)
+h(ele-)427 3872 y(men)n(ts)d(ma)n(y)e(b)r(e)i(omitted,)i(but)e(no)f
+(other)g(elemen)n(ts)g(should)g(b)r(e)h(included.)34
+b(If)19 b(supplied,)i(the)d(AST)p Ft(__)p Fj(STCNAME)427
+3971 y(elemen)n(t)23 b(should)g(b)r(e)h(a)e(v)n(ector)g(of)h(c)n
+(haracter)e(string)h(p)r(oin)n(ters)h(holding)f(the)i
+Ft(")p Fj(Name)p Ft(")e Fj(item)i(for)e(eac)n(h)g(axis)427
+4071 y(in)34 b(the)g(co)r(ordinate)e(system)i(represen)n(ted)e(b)n(y)h
+(REGION.)g(An)n(y)h(other)f(supplied)h(elemen)n(ts)f(should)g(b)r(e)427
+4171 y(scalar)22 b(elemen)n(ts,)i(eac)n(h)f(holding)g(a)g(p)r(oin)n
(ter)g(to)g(a)g(Region)f(describing)h(the)h(asso)r(ciated)e(item)i(of)f
-(ancillary)427 1482 y(information)37 b(\(error,)h(resolution,)g(size,)h
+(ancillary)427 4270 y(information)37 b(\(error,)h(resolution,)g(size,)h
(pixel)f(size)e(or)h(v)-5 b(alue\).)65 b(These)37 b(Regions)f(should)h
-(describ)r(e)g(a)427 1582 y(v)n(olume)27 b(within)i(the)f(co)r
+(describ)r(e)g(a)427 4370 y(v)n(olume)27 b(within)i(the)f(co)r
(ordinate)e(system)h(represen)n(ted)g(b)n(y)g(REGION.)259
-1717 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1816 y Fj(A)g(c)n(haracter)e(string)
+4498 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 4598 y Fj(A)g(c)n(haracter)e(string)
h(con)n(taining)f(an)h(optional)g(comma-separated)e(list)j(of)g
-(attribute)f(assignmen)n(ts)g(to)427 1916 y(b)r(e)26
+(attribute)f(assignmen)n(ts)g(to)427 4698 y(b)r(e)26
b(used)e(for)h(initialising)f(the)i(new)f(StcObsDataLo)r(cation.)34
b(The)25 b(syn)n(tax)f(used)h(is)g(iden)n(tical)f(to)h(that)g(for)427
-2015 y(the)j(AST)p Ft(_)p Fj(SET)f(routine.)259 2150
+4797 y(the)j(AST)p Ft(_)p Fj(SET)f(routine.)259 4926
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 2250 y Fj(The)c(global)e(status.)0 2416 y Fc(Returned)32
-b(V)-8 b(alue:)259 2556 y(AST)p Ft(_)p Fc(STCOBSD)m(A)g(T)g(ALOCA)g
-(TION)34 b(=)e(INTEGER)427 2655 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g
-(new)g(StcObsDataLo)r(cation.)0 2821 y Fc(Notes:)340
-3107 y Fi(\017)45 b Fj(A)27 b(deep)g(cop)n(y)e(is)h(tak)n(en)g(of)h
-(the)f(supplied)h(Region.)36 b(This)26 b(means)g(that)h(an)n(y)f
-(subsequen)n(t)g(c)n(hanges)f(made)427 3207 y(to)j(the)g(encapsulated)f
-(Region)g(using)g(the)h(supplied)g(p)r(oin)n(ter)f(will)h(ha)n(v)n(e)e
-(no)i(e\013ect)g(on)f(the)h(Stc.)340 3342 y Fi(\017)45
-b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
+427 5025 y Fj(The)c(global)e(status.)0 5183 y Fc(Returned)32
+b(V)-8 b(alue:)259 5315 y(AST)p Ft(_)p Fc(STCOBSD)m(A)g(T)g(ALOCA)g
+(TION)34 b(=)e(INTEGER)427 5415 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g
+(new)g(StcObsDataLo)r(cation.)0 5572 y Fc(Notes:)p eop
+end
+%%Page: 379 389
+TeXDict begin 379 388 bop 3643 52 a FG(379)340 351 y
+Fi(\017)45 b Fj(A)27 b(deep)g(cop)n(y)e(is)h(tak)n(en)g(of)h(the)f
+(supplied)h(Region.)36 b(This)26 b(means)g(that)h(an)n(y)f(subsequen)n
+(t)g(c)n(hanges)f(made)427 451 y(to)j(the)g(encapsulated)f(Region)g
+(using)g(the)h(supplied)g(p)r(oin)n(ter)f(will)h(ha)n(v)n(e)e(no)i
+(e\013ect)g(on)f(the)h(Stc.)340 586 y Fi(\017)45 b Fj(A)21
+b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 3441
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 685
y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 3644 3780 12 v 0 3775
-a FA(AST)p Fe(_)p FA(STCRESOUR)l(CEPR)l(OFILE)2089 3793
-y Fd(Create)2089 3892 y(a)2089 3992 y(StcRe-)2089 4092
-y(sour-)2089 4191 y(ce-)2089 4291 y(Pro-)2089 4390 y(\014le)2239
-3775 y FA(AST)p Fe(_)p FA(STCRESOUR)l(CEPR)l(OFILE)0
-4560 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+(fail)h(for)f(an)n(y)g(reason.)p 0 888 3780 12 v 0 1019
+a FA(AST)p Fe(_)p FA(STCRESOUR)l(CEPR)l(OFILE)2089 1037
+y Fd(Create)2089 1136 y(a)2089 1236 y(StcRe-)2089 1335
+y(sour-)2089 1435 y(ce-)2089 1535 y(Pro-)2089 1634 y(\014le)2239
+1019 y FA(AST)p Fe(_)p FA(STCRESOUR)l(CEPR)l(OFILE)0
+1804 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
(StcResourcePro\014le)f(and)h(optionally)g(initialises)g(its)h
-(attributes.)227 4686 y(The)36 b(StcResourcePro\014le)d(class)i(is)h(a)
+(attributes.)227 1930 y(The)36 b(StcResourcePro\014le)d(class)i(is)h(a)
f(sub-class)f(of)i(Stc)g(used)g(to)f(describ)r(e)h(the)g(co)n(v)n
-(erage)d(of)i(the)h(datasets)227 4786 y(con)n(tained)27
-b(in)h(some)f(V)n(O)g(resource.)227 4912 y(See)h(h)n
+(erage)d(of)i(the)h(datasets)227 2030 y(con)n(tained)27
+b(in)h(some)f(V)n(O)g(resource.)227 2156 y(See)h(h)n
(ttp://hea-www.harv)-5 b(ard.edu/)p Fi(\030)p Fj(arots/n)n(v)n(o)o
-(meta/STC.h)n(tml)0 5066 y Fc(In)m(v)m(o)s(cation:)123
+(meta/STC.h)n(tml)0 2309 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_STCRESOURCEP)o(ROF)o(IL)o(E\()37
b(REGION,)k(NCOORDS,)f(COORDS,)h(OPTIONS,)f(STATUS)h(\))0
-5219 y Fc(Argumen)m(ts:)259 5359 y(REGION)31 b(=)h(INTEGER)f(\(Giv)m
-(en\))427 5459 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(encapsulated)f
-(Region.)259 5593 y Fc(NCOORDS)k(=)h(INTEGER)f(\(Giv)m(en\))427
-5693 y Fj(The)d(length)g(of)f(the)h(COORDS)g(arra)n(y)-7
-b(.)34 b(Supply)28 b(zero)f(if)h(COORDS)f(should)h(b)r(e)g(ignored.)p
-eop end
-%%Page: 377 387
-TeXDict begin 377 386 bop 3643 52 a FG(377)259 351 y
-Fc(COORDS\()31 b(NCOORDS)g(\))h(=)g(INTEGER)f(\(Giv)m(en\))427
-451 y Fj(An)20 b(arra)n(y)c(holding)j(NCOORDS)g(AstKeyMap)f(p)r(oin)n
+2463 y Fc(Argumen)m(ts:)259 2603 y(REGION)31 b(=)h(INTEGER)f(\(Giv)m
+(en\))427 2703 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(encapsulated)f
+(Region.)259 2837 y Fc(NCOORDS)k(=)h(INTEGER)f(\(Giv)m(en\))427
+2937 y Fj(The)d(length)g(of)f(the)h(COORDS)g(arra)n(y)-7
+b(.)34 b(Supply)28 b(zero)f(if)h(COORDS)f(should)h(b)r(e)g(ignored.)259
+3072 y Fc(COORDS\()j(NCOORDS)g(\))h(=)g(INTEGER)f(\(Giv)m(en\))427
+3171 y Fj(An)20 b(arra)n(y)c(holding)j(NCOORDS)g(AstKeyMap)f(p)r(oin)n
(ters)h(\(if)h(NCOORDS)f(is)f(zero,)i(the)g(supplied)f(v)-5
-b(alue)19 b(is)427 551 y(ignored\).)35 b(Eac)n(h)24 b(supplied)h
-(KeyMap)f(describ)r(es)g(the)h(con)n(ten)n(ts)g(of)f(a)h(single)f(STC)h
-Fl(<)p Fj(AstroCo)r(ords)p Fl(>)d Fj(ele-)427 650 y(men)n(t,)f(and)d
-(should)g(ha)n(v)n(e)f(elemen)n(ts)i(with)f(k)n(eys)g(giv)n(en)f(b)n(y)
-i(constan)n(ts)e(AST)p Ft(__)p Fj(STCNAME,)h(AST)p Ft(__)p
-Fj(STCV)-9 b(ALUE,)427 750 y(AST)p Ft(__)p Fj(STCERR)n(OR,)21
-b(AST)p Ft(__)p Fj(STCRES,)g(AST)p Ft(__)p Fj(STCSIZE,)g(AST)p
-Ft(__)p Fj(STCPIXSZ.)g(An)n(y)h(of)f(these)h(ele-)427
-849 y(men)n(ts)d(ma)n(y)e(b)r(e)i(omitted,)i(but)e(no)f(other)g(elemen)
-n(ts)g(should)g(b)r(e)h(included.)34 b(If)19 b(supplied,)i(the)d(AST)p
-Ft(__)p Fj(STCNAME)427 949 y(elemen)n(t)23 b(should)g(b)r(e)h(a)e(v)n
-(ector)g(of)h(c)n(haracter)e(string)h(p)r(oin)n(ters)h(holding)f(the)i
+b(alue)19 b(is)427 3271 y(ignored\).)35 b(Eac)n(h)24
+b(supplied)h(KeyMap)f(describ)r(es)g(the)h(con)n(ten)n(ts)g(of)f(a)h
+(single)f(STC)h Fl(<)p Fj(AstroCo)r(ords)p Fl(>)d Fj(ele-)427
+3371 y(men)n(t,)f(and)d(should)g(ha)n(v)n(e)f(elemen)n(ts)i(with)f(k)n
+(eys)g(giv)n(en)f(b)n(y)i(constan)n(ts)e(AST)p Ft(__)p
+Fj(STCNAME,)h(AST)p Ft(__)p Fj(STCV)-9 b(ALUE,)427 3470
+y(AST)p Ft(__)p Fj(STCERR)n(OR,)21 b(AST)p Ft(__)p Fj(STCRES,)g(AST)p
+Ft(__)p Fj(STCSIZE,)g(AST)p Ft(__)p Fj(STCPIXSZ.)g(An)n(y)h(of)f(these)
+h(ele-)427 3570 y(men)n(ts)d(ma)n(y)e(b)r(e)i(omitted,)i(but)e(no)f
+(other)g(elemen)n(ts)g(should)g(b)r(e)h(included.)34
+b(If)19 b(supplied,)i(the)d(AST)p Ft(__)p Fj(STCNAME)427
+3669 y(elemen)n(t)23 b(should)g(b)r(e)h(a)e(v)n(ector)g(of)h(c)n
+(haracter)e(string)h(p)r(oin)n(ters)h(holding)f(the)i
Ft(")p Fj(Name)p Ft(")e Fj(item)i(for)e(eac)n(h)g(axis)427
-1049 y(in)34 b(the)g(co)r(ordinate)e(system)i(represen)n(ted)e(b)n(y)h
+3769 y(in)34 b(the)g(co)r(ordinate)e(system)i(represen)n(ted)e(b)n(y)h
(REGION.)g(An)n(y)h(other)f(supplied)h(elemen)n(ts)f(should)g(b)r(e)427
-1148 y(scalar)22 b(elemen)n(ts,)i(eac)n(h)f(holding)g(a)g(p)r(oin)n
+3869 y(scalar)22 b(elemen)n(ts,)i(eac)n(h)f(holding)g(a)g(p)r(oin)n
(ter)g(to)g(a)g(Region)f(describing)h(the)h(asso)r(ciated)e(item)i(of)f
-(ancillary)427 1248 y(information)37 b(\(error,)h(resolution,)g(size,)h
+(ancillary)427 3968 y(information)37 b(\(error,)h(resolution,)g(size,)h
(pixel)f(size)e(or)h(v)-5 b(alue\).)65 b(These)37 b(Regions)f(should)h
-(describ)r(e)g(a)427 1348 y(v)n(olume)27 b(within)i(the)f(co)r
+(describ)r(e)g(a)427 4068 y(v)n(olume)27 b(within)i(the)f(co)r
(ordinate)e(system)h(represen)n(ted)g(b)n(y)g(REGION.)259
-1482 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1582 y Fj(A)g(c)n(haracter)e(string)
+4203 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 4302 y Fj(A)g(c)n(haracter)e(string)
h(con)n(taining)f(an)h(optional)g(comma-separated)e(list)j(of)g
-(attribute)f(assignmen)n(ts)g(to)427 1682 y(b)r(e)g(used)f(for)g
+(attribute)f(assignmen)n(ts)g(to)427 4402 y(b)r(e)g(used)f(for)g
(initialising)g(the)g(new)g(StcResourcePro\014le.)43
b(The)30 b(syn)n(tax)f(used)i(is)f(iden)n(tical)g(to)g(that)g(for)427
-1781 y(the)e(AST)p Ft(_)p Fj(SET)f(routine.)259 1916
+4502 y(the)e(AST)p Ft(_)p Fj(SET)f(routine.)259 4636
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 2016 y Fj(The)c(global)e(status.)0 2182 y Fc(Returned)32
-b(V)-8 b(alue:)259 2322 y(AST)p Ft(_)p Fc(STCRESOUR)m(CEPR)m(OFILE)32
-b(=)g(INTEGER)427 2422 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
-(StcResourcePro\014le.)0 2588 y Fc(Notes:)340 2874 y
+427 4736 y Fj(The)c(global)e(status.)0 4902 y Fc(Returned)32
+b(V)-8 b(alue:)259 5042 y(AST)p Ft(_)p Fc(STCRESOUR)m(CEPR)m(OFILE)32
+b(=)g(INTEGER)427 5141 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
+(StcResourcePro\014le.)0 5307 y Fc(Notes:)340 5593 y
Fi(\017)45 b Fj(A)27 b(deep)g(cop)n(y)e(is)h(tak)n(en)g(of)h(the)f
(supplied)h(Region.)36 b(This)26 b(means)g(that)h(an)n(y)f(subsequen)n
-(t)g(c)n(hanges)f(made)427 2974 y(to)j(the)g(encapsulated)f(Region)g
+(t)g(c)n(hanges)f(made)427 5693 y(to)j(the)g(encapsulated)f(Region)g
(using)g(the)h(supplied)g(p)r(oin)n(ter)f(will)h(ha)n(v)n(e)e(no)i
-(e\013ect)g(on)f(the)h(Stc.)340 3109 y Fi(\017)45 b Fj(A)21
-b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
+(e\013ect)g(on)f(the)h(Stc.)p eop end
+%%Page: 380 390
+TeXDict begin 380 389 bop 0 52 a FG(380)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 3209
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 451
y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)-2 3375 y Fc(Status)33
-b(Handling)n(:)227 3521 y Fj(The)d(protected)g(in)n(terface)f(to)g
-(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
-(of)g(the)g(parameter)227 3620 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
-(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
-(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
-Fj(in)n(t)227 3720 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p
-0 3923 3780 12 v 0 4054 a FA(AST)p Fe(_)p FA(STCSCHAN)1379
-4055 y Fd(Create)37 b(an)i(StcsChan)2699 4054 y FA(AST)p
-Fe(_)p FA(STCSCHAN)0 4235 y Fc(Description:)44 b Fj(This)28
+(fail)h(for)f(an)n(y)g(reason.)-2 610 y Fc(Status)33
+b(Handling)n(:)227 756 y Fj(The)d(protected)g(in)n(terface)f(to)g(this)
+h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g
+(the)g(parameter)227 856 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62
+b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)
+e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fj(in)n(t)227
+956 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p 0 1150 3780
+12 v 0 1280 a FA(AST)p Fe(_)p FA(STCSCHAN)1379 1281 y
+Fd(Create)37 b(an)i(StcsChan)2699 1280 y FA(AST)p Fe(_)p
+FA(STCSCHAN)0 1452 y Fc(Description:)44 b Fj(This)28
b(function)g(creates)f(a)g(new)g(StcsChan)h(and)f(optionally)g
-(initialises)g(its)h(attributes.)227 4361 y(A)33 b(StcsChan)f(is)g(a)g
+(initialises)g(its)h(attributes.)227 1575 y(A)33 b(StcsChan)f(is)g(a)g
(sp)r(ecialised)g(form)g(of)g(Channel)g(whic)n(h)g(supp)r(orts)g(STC-S)
h(I/O)e(op)r(erations.)50 b(W)-7 b(riting)32 b(an)227
-4461 y(Ob)5 b(ject)35 b(to)f(an)g(StcsChan)h(\(using)f(AST)p
+1675 y(Ob)5 b(ject)35 b(to)f(an)g(StcsChan)h(\(using)f(AST)p
Ft(_)p Fj(WRITE\))h(will,)h(if)f(the)g(Ob)5 b(ject)35
-b(is)f(suitable,)i(generate)d(an)i(STC-S)227 4561 y(description)24
+b(is)f(suitable,)i(generate)d(an)i(STC-S)227 1774 y(description)24
b(of)g(that)h(Ob)5 b(ject,)25 b(and)f(reading)g(from)g(an)g(StcsChan)g
(will)h(create)e(a)h(new)h(Ob)5 b(ject)24 b(from)g(its)h(STC-S)227
-4660 y(description.)227 4787 y(Normally)-7 b(,)40 b(when)e(y)n(ou)f
+1874 y(description.)227 1997 y(Normally)-7 b(,)40 b(when)e(y)n(ou)f
(use)h(an)f(StcsChan,)k(y)n(ou)c(should)g(pro)n(vide)g
Ft(")p Fj(source)p Ft(")f Fj(and)i Ft(")p Fj(sink)p Ft(")e
-Fj(routines)i(whic)n(h)227 4886 y(connect)f(it)g(to)f(an)h(external)f
+Fj(routines)i(whic)n(h)227 2097 y(connect)f(it)g(to)f(an)h(external)f
(data)g(store)g(b)n(y)g(reading)f(and)i(writing)f(the)h(resulting)f
-(text.)65 b(These)36 b(routines)227 4986 y(should)k(p)r(erform)f(an)n
+(text.)65 b(These)36 b(routines)227 2196 y(should)k(p)r(erform)f(an)n
(y)h(con)n(v)n(ersions)d(needed)j(b)r(et)n(w)n(een)g(external)f(c)n
(haracter)f(enco)r(dings)h(and)h(the)g(in)n(ternal)227
-5086 y(ASCI)r(I)33 b(enco)r(ding.)51 b(If)33 b(no)f(suc)n(h)g(routines)
+2296 y(ASCI)r(I)33 b(enco)r(ding.)51 b(If)33 b(no)f(suc)n(h)g(routines)
g(are)g(supplied,)i(a)e(Channel)g(will)h(read)e(from)h(standard)g
-(input)h(and)227 5185 y(write)28 b(to)f(standard)g(output.)227
-5312 y(Alternativ)n(ely)-7 b(,)29 b(an)g(XmlChan)h(can)e(b)r(e)i(told)f
+(input)h(and)227 2396 y(write)28 b(to)f(standard)g(output.)227
+2519 y(Alternativ)n(ely)-7 b(,)29 b(an)g(XmlChan)h(can)e(b)r(e)i(told)f
(to)g(read)f(or)g(write)h(from)g(sp)r(eci\014c)g(text)h(\014les)f
-(using)g(the)g(SinkFile)227 5411 y(and)f(SourceFile)f(attributes,)g(in)
+(using)g(the)g(SinkFile)227 2618 y(and)f(SourceFile)f(attributes,)g(in)
h(whic)n(h)g(case)e(no)i(sink)f(or)g(source)f(function)i(need)g(b)r(e)g
-(supplied.)0 5565 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
+(supplied.)0 2765 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
b(=)i(AST_STCSCHAN\()38 b(SOURCE,)j(SINK,)g(OPTIONS,)g(STATUS)g(\))0
-5718 y Fc(Argumen)m(ts:)p eop end
-%%Page: 378 388
-TeXDict begin 378 387 bop 0 52 a FG(378)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(SOUR)m(CE)h(=)g(SUBR)
-m(OUTINE)g(\(Giv)m(en\))427 451 y Fj(A)26 b(source)d(routine,)j(whic)n
-(h)f(is)g(a)f(subroutine)h(whic)n(h)g(tak)n(es)f(a)h(single)f(in)n
-(teger)g(error)f(status)i(argumen)n(t.)35 b(If)427 551
-y(no)27 b(v)-5 b(alue)27 b(has)g(b)r(een)g(set)g(for)g(the)g
-(SourceFile)g(attribute,)g(this)h(routine)e(will)i(b)r(e)f(used)g(b)n
-(y)g(the)h(StcsChan)427 650 y(to)35 b(obtain)f(lines)g(of)g(input)i
-(text.)57 b(On)35 b(eac)n(h)e(in)n(v)n(o)r(cation,)i(it)g(should)f
-(read)g(the)g(next)h(input)g(line)g(from)427 750 y(some)e(external)f
-(data)h(store,)g(and)g(then)h(return)e(the)i(resulting)e(text)i(to)f
-(the)g(AST)h(library)d(b)n(y)i(calling)427 849 y(AST)p
-Ft(_)p Fj(PUTLINE.)k(It)g(should)f(supply)h(a)g(negativ)n(e)f(line)h
-(length)g(when)g(there)f(are)g(no)h(more)f(lines)h(to)427
-949 y(read.)h(If)29 b(an)f(error)e(o)r(ccurs,)h(it)i(should)f(set)g
-(its)h(o)n(wn)e(error)f(status)i(argumen)n(t)g(to)g(an)g(error)e(v)-5
-b(alue)28 b(b)r(efore)427 1049 y(returning.)427 1167
-y(If)i(the)f(n)n(ull)h(routine)e(AST)p Ft(_)p Fj(NULL)i(is)f(suppied)g
-(as)f(the)i(SOUR)n(CE)e(v)-5 b(alue,)30 b(and)f(no)g(v)-5
-b(alue)29 b(has)f(b)r(een)i(set)427 1267 y(for)d(the)h(SourceFile)f
-(attribute,)h(the)g(StcsChan)g(will)f(read)g(from)g(standard)g(input)h
-(instead.)259 1404 y Fc(SINK)k(=)g(SUBR)m(OUTINE)g(\(Giv)m(en\))427
-1504 y Fj(A)f(sink)f(routine,)g(whic)n(h)h(is)f(a)f(subroutine)h(whic)n
-(h)g(tak)n(es)g(a)f(single)h(in)n(teger)f(error)g(status)h(argumen)n
-(t.)43 b(If)427 1604 y(no)32 b(v)-5 b(alue)32 b(has)g(b)r(een)g(set)g
-(for)g(the)g(SinkFile)h(attribute,)g(this)g(routine)f(will)g(b)r(e)g
-(used)g(b)n(y)g(the)h(StcsChan)427 1703 y(to)j(deliv)n(er)e(lines)i(of)
-f(output)h(text.)61 b(On)35 b(eac)n(h)g(in)n(v)n(o)r(cation,)h(it)g
-(should)g(obtain)f(the)h(next)f(output)h(line)427 1803
+2912 y Fc(Argumen)m(ts:)259 3046 y(SOUR)m(CE)32 b(=)g(SUBR)m(OUTINE)g
+(\(Giv)m(en\))427 3145 y Fj(A)26 b(source)d(routine,)j(whic)n(h)f(is)g
+(a)f(subroutine)h(whic)n(h)g(tak)n(es)f(a)h(single)f(in)n(teger)g
+(error)f(status)i(argumen)n(t.)35 b(If)427 3245 y(no)27
+b(v)-5 b(alue)27 b(has)g(b)r(een)g(set)g(for)g(the)g(SourceFile)g
+(attribute,)g(this)h(routine)e(will)i(b)r(e)f(used)g(b)n(y)g(the)h
+(StcsChan)427 3345 y(to)35 b(obtain)f(lines)g(of)g(input)i(text.)57
+b(On)35 b(eac)n(h)e(in)n(v)n(o)r(cation,)i(it)g(should)f(read)g(the)g
+(next)h(input)g(line)g(from)427 3444 y(some)e(external)f(data)h(store,)
+g(and)g(then)h(return)e(the)i(resulting)e(text)i(to)f(the)g(AST)h
+(library)d(b)n(y)i(calling)427 3544 y(AST)p Ft(_)p Fj(PUTLINE.)k(It)g
+(should)f(supply)h(a)g(negativ)n(e)f(line)h(length)g(when)g(there)f
+(are)g(no)h(more)f(lines)h(to)427 3644 y(read.)h(If)29
+b(an)f(error)e(o)r(ccurs,)h(it)i(should)f(set)g(its)h(o)n(wn)e(error)f
+(status)i(argumen)n(t)g(to)g(an)g(error)e(v)-5 b(alue)28
+b(b)r(efore)427 3743 y(returning.)427 3858 y(If)i(the)f(n)n(ull)h
+(routine)e(AST)p Ft(_)p Fj(NULL)i(is)f(suppied)g(as)f(the)i(SOUR)n(CE)e
+(v)-5 b(alue,)30 b(and)f(no)g(v)-5 b(alue)29 b(has)f(b)r(een)i(set)427
+3958 y(for)d(the)h(SourceFile)f(attribute,)h(the)g(StcsChan)g(will)f
+(read)g(from)g(standard)g(input)h(instead.)259 4088 y
+Fc(SINK)k(=)g(SUBR)m(OUTINE)g(\(Giv)m(en\))427 4188 y
+Fj(A)f(sink)f(routine,)g(whic)n(h)h(is)f(a)f(subroutine)h(whic)n(h)g
+(tak)n(es)g(a)f(single)h(in)n(teger)f(error)g(status)h(argumen)n(t.)43
+b(If)427 4287 y(no)32 b(v)-5 b(alue)32 b(has)g(b)r(een)g(set)g(for)g
+(the)g(SinkFile)h(attribute,)g(this)g(routine)f(will)g(b)r(e)g(used)g
+(b)n(y)g(the)h(StcsChan)427 4387 y(to)j(deliv)n(er)e(lines)i(of)f
+(output)h(text.)61 b(On)35 b(eac)n(h)g(in)n(v)n(o)r(cation,)h(it)g
+(should)g(obtain)f(the)h(next)f(output)h(line)427 4486
y(from)25 b(the)h(AST)f(library)f(b)n(y)h(calling)f(AST)p
Ft(_)p Fj(GETLINE,)h(and)g(then)g(deliv)n(er)g(the)g(resulting)g(text)g
-(to)g(some)427 1902 y(external)f(data)g(store.)34 b(If)25
+(to)g(some)427 4586 y(external)f(data)g(store.)34 b(If)25
b(an)f(error)e(o)r(ccurs,)j(it)f(should)g(set)h(its)f(o)n(wn)g(error)e
-(status)i(argumen)n(t)f(to)i(an)f(error)427 2002 y(v)-5
-b(alue)28 b(b)r(efore)f(returning.)427 2121 y(If)k(the)f(n)n(ull)g
+(status)i(argumen)n(t)f(to)i(an)f(error)427 4686 y(v)-5
+b(alue)28 b(b)r(efore)f(returning.)427 4801 y(If)k(the)f(n)n(ull)g
(routine)g(AST)p Ft(_)p Fj(NULL)h(is)e(suppied)i(as)e(the)i(SINK)f(v)-5
b(alue,)30 b(and)g(no)g(v)-5 b(alue)30 b(has)g(b)r(een)g(set)g(for)427
-2220 y(the)e(SinkFile)g(attribute,)g(the)g(StcsChan)g(will)f(write)h
-(to)f(standard)g(output)h(instead.)259 2358 y Fc(OPTIONS)k(=)g(CHARA)m
+4900 y(the)e(SinkFile)g(attribute,)g(the)g(StcsChan)g(will)f(write)h
+(to)f(standard)g(output)h(instead.)259 5030 y Fc(OPTIONS)k(=)g(CHARA)m
(CTER)g Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-2457 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)
+5130 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)
f(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r
-(e)427 2557 y(used)j(for)f(initialising)h(the)g(new)f(StcsChan.)36
+(e)427 5230 y(used)j(for)f(initialising)h(the)g(new)f(StcsChan.)36
b(The)24 b(syn)n(tax)e(used)i(is)g(iden)n(tical)f(to)h(that)g(for)f
-(the)h(AST)p Ft(_)p Fj(SET)427 2657 y(routine.)259 2794
+(the)h(AST)p Ft(_)p Fj(SET)427 5329 y(routine.)259 5460
y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 2894 y Fj(The)c(global)e(status.)0 3065 y Fc(Returned)32
-b(V)-8 b(alue:)259 3211 y(AST)p Ft(_)p Fc(STCSCHAN)32
-b(=)g(INTEGER)427 3311 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
-(StcsChan.)0 3482 y Fc(Notes:)340 3774 y Fi(\017)45 b
-Fj(The)27 b(names)g(of)g(the)h(routines)e(supplied)i(for)e(the)i(SOUR)n
-(CE)e(and)h(SINK)g(argumen)n(ts)f(should)h(app)r(ear)f(in)427
-3873 y(EXTERNAL)31 b(statemen)n(ts)f(in)h(the)g(F)-7
-b(ortran)30 b(routine)g(whic)n(h)h(in)n(v)n(ok)n(es)e(AST)p
-Ft(_)p Fj(STCSCHAN.)j(Ho)n(w)n(ev)n(er,)427 3973 y(this)k(is)f(not)g
-(generally)f(necessary)f(for)i(the)g(n)n(ull)h(routine)f(AST)p
-Ft(_)p Fj(NULL)g(\(so)g(long)f(as)h(the)h(AST)p Ft(_)p
-Fj(P)-7 b(AR)427 4073 y(include)28 b(\014le)g(has)f(b)r(een)h(used\).)
-340 4210 y Fi(\017)45 b Fj(If)28 b(the)g(external)e(data)h(source)f(or)
-g(sink)i(uses)e(a)h(c)n(haracter)f(enco)r(ding)g(other)h(than)h(ASCI)r
-(I,)g(the)f(supplied)427 4310 y(source)i(and)g(sink)g(functions)h
-(should)f(translate)g(b)r(et)n(w)n(een)h(the)f(external)g(c)n(haracter)
-f(enco)r(ding)h(and)g(the)427 4409 y(in)n(ternal)e(ASCI)r(I)i(enco)r
-(ding)e(used)g(b)n(y)h(AST.)340 4547 y Fi(\017)45 b Fj(A)35
-b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
+427 5559 y Fj(The)c(global)e(status.)0 5718 y Fc(Returned)32
+b(V)-8 b(alue:)p eop end
+%%Page: 381 391
+TeXDict begin 381 390 bop 3643 52 a FG(381)259 351 y
+Fc(AST)p Ft(_)p Fc(STCSCHAN)32 b(=)g(INTEGER)427 451
+y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(StcsChan.)0
+623 y Fc(Notes:)340 916 y Fi(\017)45 b Fj(The)27 b(names)g(of)g(the)h
+(routines)e(supplied)i(for)e(the)i(SOUR)n(CE)e(and)h(SINK)g(argumen)n
+(ts)f(should)h(app)r(ear)f(in)427 1016 y(EXTERNAL)31
+b(statemen)n(ts)f(in)h(the)g(F)-7 b(ortran)30 b(routine)g(whic)n(h)h
+(in)n(v)n(ok)n(es)e(AST)p Ft(_)p Fj(STCSCHAN.)j(Ho)n(w)n(ev)n(er,)427
+1115 y(this)k(is)f(not)g(generally)f(necessary)f(for)i(the)g(n)n(ull)h
+(routine)f(AST)p Ft(_)p Fj(NULL)g(\(so)g(long)f(as)h(the)h(AST)p
+Ft(_)p Fj(P)-7 b(AR)427 1215 y(include)28 b(\014le)g(has)f(b)r(een)h
+(used\).)340 1353 y Fi(\017)45 b Fj(If)28 b(the)g(external)e(data)h
+(source)f(or)g(sink)i(uses)e(a)h(c)n(haracter)f(enco)r(ding)g(other)h
+(than)h(ASCI)r(I,)g(the)f(supplied)427 1452 y(source)i(and)g(sink)g
+(functions)h(should)f(translate)g(b)r(et)n(w)n(een)h(the)f(external)g
+(c)n(haracter)f(enco)r(ding)h(and)g(the)427 1552 y(in)n(ternal)e(ASCI)r
+(I)i(enco)r(ding)e(used)g(b)n(y)h(AST.)340 1690 y Fi(\017)45
+b Fj(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
Ft(__)p Fj(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
-(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 4646 y(AST)28
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 1790 y(AST)28
b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)340 4784 y Fi(\017)45 b Fj(Note)36 b(that)f(the)h(n)n(ull)f
+(reason.)340 1928 y Fi(\017)45 b Fj(Note)36 b(that)f(the)h(n)n(ull)f
(routine)g(AST)p Ft(_)p Fj(NULL)h(\(one)f(underscore\))f(is)h
(di\013eren)n(t)h(to)f(AST)p Ft(__)p Fj(NULL)g(\(t)n(w)n(o)427
-4884 y(underscores\),)26 b(whic)n(h)i(is)f(the)h(n)n(ull)g(Ob)5
-b(ject)28 b(p)r(oin)n(ter.)p 0 5092 3780 12 v 0 5223
+2027 y(underscores\),)26 b(whic)n(h)i(is)f(the)h(n)n(ull)g(Ob)5
+b(ject)28 b(p)r(oin)n(ter.)p 0 2237 3780 12 v 0 2367
a FA(AST)p Fe(_)p FA(STCSEAR)l(CHLOCA)-11 b(TION)2029
-5241 y Fd(Create)2029 5340 y(a)2029 5440 y(Stc-)2029
-5539 y(Searc)m(hLo-)2029 5639 y(ca-)2029 5739 y(tion)2179
-5223 y FA(AST)p Fe(_)p FA(STCSEAR)l(CHLOCA)g(TION)p eop
-end
-%%Page: 379 389
-TeXDict begin 379 388 bop 3643 52 a FG(379)0 351 y Fc(Description:)44
-b Fj(This)28 b(function)g(creates)f(a)g(new)g(StcSearc)n(hLo)r(cation)f
-(and)i(optionally)e(initialises)i(its)f(attributes.)227
-485 y(The)h(StcSearc)n(hLo)r(cation)e(class)g(is)i(a)f(sub-class)f(of)i
-(Stc)g(used)f(to)h(describ)r(e)f(the)h(co)n(v)n(erage)d(of)i(a)h(V)n(O)
-f(query)-7 b(.)227 619 y(See)28 b(h)n(ttp://hea-www.harv)-5
-b(ard.edu/)p Fi(\030)p Fj(arots/n)n(v)n(o)o(meta/STC.h)n(tml)0
-786 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i
-(AST_STCSEARCHLOC)o(ATI)o(ON)o(\()38 b(REGION,)i(NCOORDS,)g(COORDS,)h
-(OPTIONS,)f(STATUS)i(\))0 954 y Fc(Argumen)m(ts:)259
-1109 y(REGION)31 b(=)h(INTEGER)f(\(Giv)m(en\))427 1209
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(encapsulated)f(Region.)259
-1351 y Fc(NCOORDS)k(=)h(INTEGER)f(\(Giv)m(en\))427 1450
-y Fj(The)d(length)g(of)f(the)h(COORDS)g(arra)n(y)-7 b(.)34
-b(Supply)28 b(zero)f(if)h(COORDS)f(should)h(b)r(e)g(ignored.)259
-1592 y Fc(COORDS\()j(NCOORDS)g(\))h(=)g(INTEGER)f(\(Giv)m(en\))427
-1692 y Fj(An)20 b(arra)n(y)c(holding)j(NCOORDS)g(AstKeyMap)f(p)r(oin)n
+2385 y Fd(Create)2029 2485 y(a)2029 2584 y(Stc-)2029
+2684 y(Searc)m(hLo-)2029 2784 y(ca-)2029 2883 y(tion)2179
+2367 y FA(AST)p Fe(_)p FA(STCSEAR)l(CHLOCA)g(TION)0 3059
+y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+(StcSearc)n(hLo)r(cation)f(and)i(optionally)e(initialises)i(its)f
+(attributes.)227 3189 y(The)h(StcSearc)n(hLo)r(cation)e(class)g(is)i(a)
+f(sub-class)f(of)i(Stc)g(used)f(to)h(describ)r(e)f(the)h(co)n(v)n
+(erage)d(of)i(a)h(V)n(O)f(query)-7 b(.)227 3318 y(See)28
+b(h)n(ttp://hea-www.harv)-5 b(ard.edu/)p Fi(\030)p Fj(arots/n)n(v)n(o)o
+(meta/STC.h)n(tml)0 3478 y Fc(In)m(v)m(o)s(cation:)123
+b Ft(RESULT)41 b(=)i(AST_STCSEARCHLOC)o(ATI)o(ON)o(\()38
+b(REGION,)i(NCOORDS,)g(COORDS,)h(OPTIONS,)f(STATUS)i(\))0
+3638 y Fc(Argumen)m(ts:)259 3785 y(REGION)31 b(=)h(INTEGER)f(\(Giv)m
+(en\))427 3884 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(encapsulated)f
+(Region.)259 4022 y Fc(NCOORDS)k(=)h(INTEGER)f(\(Giv)m(en\))427
+4122 y Fj(The)d(length)g(of)f(the)h(COORDS)g(arra)n(y)-7
+b(.)34 b(Supply)28 b(zero)f(if)h(COORDS)f(should)h(b)r(e)g(ignored.)259
+4260 y Fc(COORDS\()j(NCOORDS)g(\))h(=)g(INTEGER)f(\(Giv)m(en\))427
+4360 y Fj(An)20 b(arra)n(y)c(holding)j(NCOORDS)g(AstKeyMap)f(p)r(oin)n
(ters)h(\(if)h(NCOORDS)f(is)f(zero,)i(the)g(supplied)f(v)-5
-b(alue)19 b(is)427 1792 y(ignored\).)35 b(Eac)n(h)24
+b(alue)19 b(is)427 4459 y(ignored\).)35 b(Eac)n(h)24
b(supplied)h(KeyMap)f(describ)r(es)g(the)h(con)n(ten)n(ts)g(of)f(a)h
(single)f(STC)h Fl(<)p Fj(AstroCo)r(ords)p Fl(>)d Fj(ele-)427
-1891 y(men)n(t,)f(and)d(should)g(ha)n(v)n(e)f(elemen)n(ts)i(with)f(k)n
+4559 y(men)n(t,)f(and)d(should)g(ha)n(v)n(e)f(elemen)n(ts)i(with)f(k)n
(eys)g(giv)n(en)f(b)n(y)i(constan)n(ts)e(AST)p Ft(__)p
-Fj(STCNAME,)h(AST)p Ft(__)p Fj(STCV)-9 b(ALUE,)427 1991
+Fj(STCNAME,)h(AST)p Ft(__)p Fj(STCV)-9 b(ALUE,)427 4658
y(AST)p Ft(__)p Fj(STCERR)n(OR,)21 b(AST)p Ft(__)p Fj(STCRES,)g(AST)p
Ft(__)p Fj(STCSIZE,)g(AST)p Ft(__)p Fj(STCPIXSZ.)g(An)n(y)h(of)f(these)
-h(ele-)427 2090 y(men)n(ts)d(ma)n(y)e(b)r(e)i(omitted,)i(but)e(no)f
+h(ele-)427 4758 y(men)n(ts)d(ma)n(y)e(b)r(e)i(omitted,)i(but)e(no)f
(other)g(elemen)n(ts)g(should)g(b)r(e)h(included.)34
b(If)19 b(supplied,)i(the)d(AST)p Ft(__)p Fj(STCNAME)427
-2190 y(elemen)n(t)23 b(should)g(b)r(e)h(a)e(v)n(ector)g(of)h(c)n
+4858 y(elemen)n(t)23 b(should)g(b)r(e)h(a)e(v)n(ector)g(of)h(c)n
(haracter)e(string)h(p)r(oin)n(ters)h(holding)f(the)i
Ft(")p Fj(Name)p Ft(")e Fj(item)i(for)e(eac)n(h)g(axis)427
-2290 y(in)34 b(the)g(co)r(ordinate)e(system)i(represen)n(ted)e(b)n(y)h
+4957 y(in)34 b(the)g(co)r(ordinate)e(system)i(represen)n(ted)e(b)n(y)h
(REGION.)g(An)n(y)h(other)f(supplied)h(elemen)n(ts)f(should)g(b)r(e)427
-2389 y(scalar)22 b(elemen)n(ts,)i(eac)n(h)f(holding)g(a)g(p)r(oin)n
+5057 y(scalar)22 b(elemen)n(ts,)i(eac)n(h)f(holding)g(a)g(p)r(oin)n
(ter)g(to)g(a)g(Region)f(describing)h(the)h(asso)r(ciated)e(item)i(of)f
-(ancillary)427 2489 y(information)37 b(\(error,)h(resolution,)g(size,)h
+(ancillary)427 5157 y(information)37 b(\(error,)h(resolution,)g(size,)h
(pixel)f(size)e(or)h(v)-5 b(alue\).)65 b(These)37 b(Regions)f(should)h
-(describ)r(e)g(a)427 2589 y(v)n(olume)27 b(within)i(the)f(co)r
+(describ)r(e)g(a)427 5256 y(v)n(olume)27 b(within)i(the)f(co)r
(ordinate)e(system)h(represen)n(ted)g(b)n(y)g(REGION.)259
-2731 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 2830 y Fj(A)g(c)n(haracter)e(string)
+5394 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 5494 y Fj(A)g(c)n(haracter)e(string)
h(con)n(taining)f(an)h(optional)g(comma-separated)e(list)j(of)g
-(attribute)f(assignmen)n(ts)g(to)427 2930 y(b)r(e)g(used)g(for)f
+(attribute)f(assignmen)n(ts)g(to)427 5593 y(b)r(e)g(used)g(for)f
(initialising)g(the)h(new)g(StcSearc)n(hLo)r(cation.)44
b(The)31 b(syn)n(tax)e(used)i(is)f(iden)n(tical)h(to)f(that)h(for)427
-3029 y(the)d(AST)p Ft(_)p Fj(SET)f(routine.)259 3171
-y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 3271 y Fj(The)c(global)e(status.)0 3451 y Fc(Returned)32
-b(V)-8 b(alue:)259 3606 y(AST)p Ft(_)p Fc(STCSEAR)m(CHLOCA)g(TION)33
-b(=)f(INTEGER)427 3706 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
-(StcSearc)n(hLo)r(cation.)0 3886 y Fc(Notes:)340 4187
+5693 y(the)d(AST)p Ft(_)p Fj(SET)f(routine.)p eop end
+%%Page: 382 392
+TeXDict begin 382 391 bop 0 52 a FG(382)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(ST)-8
+b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+451 y Fj(The)c(global)e(status.)0 613 y Fc(Returned)32
+b(V)-8 b(alue:)259 750 y(AST)p Ft(_)p Fc(STCSEAR)m(CHLOCA)g(TION)33
+b(=)f(INTEGER)427 849 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
+(StcSearc)n(hLo)r(cation.)0 1012 y Fc(Notes:)340 1295
y Fi(\017)45 b Fj(A)27 b(deep)g(cop)n(y)e(is)h(tak)n(en)g(of)h(the)f
(supplied)h(Region.)36 b(This)26 b(means)g(that)h(an)n(y)f(subsequen)n
-(t)g(c)n(hanges)f(made)427 4286 y(to)j(the)g(encapsulated)f(Region)g
+(t)g(c)n(hanges)f(made)427 1394 y(to)j(the)g(encapsulated)f(Region)g
(using)g(the)h(supplied)g(p)r(oin)n(ter)f(will)h(ha)n(v)n(e)e(no)i
-(e\013ect)g(on)f(the)h(Stc.)340 4428 y Fi(\017)45 b Fj(A)21
+(e\013ect)g(on)f(the)h(Stc.)340 1527 y Fi(\017)45 b Fj(A)21
b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 4528
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 1627
y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)-2 4708 y Fc(Status)33
-b(Handling)n(:)227 4854 y Fj(The)d(protected)g(in)n(terface)f(to)g
+(fail)h(for)f(an)n(y)g(reason.)-2 1789 y Fc(Status)33
+b(Handling)n(:)227 1935 y Fj(The)d(protected)g(in)n(terface)f(to)g
(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
-(of)g(the)g(parameter)227 4954 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
+(of)g(the)g(parameter)227 2035 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
-Fj(in)n(t)227 5054 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p
-0 5271 3780 12 v 0 5402 a FA(AST)p Fe(_)p FA(STRIPESCAPES)190
-b Fd(Remo)m(v)m(e)37 b(AST)1725 5501 y(escap)s(e)1644
-5601 y(sequences)1556 5715 y(from)h(a)g(string)2421 5402
-y FA(AST)p Fe(_)p FA(STRIPESCAPES)p eop end
-%%Page: 380 390
-TeXDict begin 380 389 bop 0 52 a FG(380)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Description:)44
+Fj(in)n(t)227 2134 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p
+0 2334 3780 12 v 0 2465 a FA(AST)p Fe(_)p FA(STRIPESCAPES)1551
+2464 y Fd(Remo)m(v)m(e)37 b(AST)1725 2564 y(escap)s(e)1644
+2664 y(sequences)1556 2778 y(from)h(a)g(string)2421 2465
+y FA(AST)p Fe(_)p FA(STRIPESCAPES)0 2967 y Fc(Description:)44
b Fj(This)25 b(function)h(remo)n(v)n(es)d(AST)j(escap)r(e)e(sequences)h
(from)f(a)h(supplied)g(string,)g(returning)g(the)g(result-)227
-451 y(ing)32 b(text)g(as)f(the)h(function)g(v)-5 b(alue.)49
+3067 y(ing)32 b(text)g(as)f(the)h(function)g(v)-5 b(alue.)49
b(The)32 b(b)r(eha)n(viour)e(of)i(this)g(function)g(can)f(b)r(e)h(con)n
-(trolled)f(b)n(y)g(in)n(v)n(oking)f(the)227 551 y(AST)p
+(trolled)f(b)n(y)g(in)n(v)n(oking)f(the)227 3167 y(AST)p
Ft(_)p Fj(ESCAPES)e(routine,)h(whic)n(h)g(can)g(b)r(e)h(used)f(to)g
(supress)f(or)g(enable)h(the)g(remo)n(v)-5 b(al)28 b(of)h(escap)r(e)f
-(sequences)227 650 y(b)n(y)g(this)f(function.)227 774
+(sequences)227 3266 y(b)n(y)g(this)f(function.)227 3391
y(AST)33 b(escap)r(e)e(sequences)h(are)f(used)h(b)n(y)f(the)i(Plot)e
(class)h(to)g(mo)r(dify)g(the)g(app)r(earance)f(and)h(p)r(osition)g(of)
-g(sub-)227 873 y(strings)27 b(within)h(a)f(plotted)h(text)g(string.)37
+g(sub-)227 3491 y(strings)27 b(within)h(a)f(plotted)h(text)g(string.)37
b(See)27 b(the)h Ft(")p Fj(Escap)r(e)p Ft(")e Fj(attribute)i(for)f
-(further)g(information.)0 1021 y Fc(In)m(v)m(o)s(cation:)123
+(further)g(information.)0 3640 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_STRIPESCAPES)o(\()38 b(TEXT)k(\))0
-1169 y Fc(Argumen)m(ts:)259 1303 y(TEXT)427 1403 y Fj(The)28
-b(string)f(to)g(b)r(e)h(c)n(hec)n(k)n(ed.)0 1563 y Fc(Returned)k(V)-8
-b(alue:)259 1697 y(AST)p Ft(_)p Fc(STRIPESCAPES)33 b(=)f(CHARA)m(CTER)
-427 1797 y Fj(The)g(mo)r(di\014ed)g(string.)49 b(If)32
+3790 y Fc(Argumen)m(ts:)259 3927 y(TEXT)427 4026 y Fj(The)28
+b(string)f(to)g(b)r(e)h(c)n(hec)n(k)n(ed.)0 4189 y Fc(Returned)k(V)-8
+b(alue:)259 4325 y(AST)p Ft(_)p Fc(STRIPESCAPES)33 b(=)f(CHARA)m(CTER)
+427 4425 y Fj(The)g(mo)r(di\014ed)g(string.)49 b(If)32
b(the)g(AST)p Ft(_)p Fj(ESCAPES)f(routine)h(has)f(b)r(een)h(called)f
-(indicating)h(that)g(escap)r(e)427 1897 y(sequences)27
+(indicating)h(that)g(escap)r(e)427 4525 y(sequences)27
b(should)g(not)h(b)r(e)g(stripp)r(ed,)g(then)g(the)g(supplied)g(string)
-f(is)g(returned)h(without)g(c)n(hange.)p 0 2092 3780
-12 v 0 2223 a FA(AST)p Fe(_)p FA(SWITCHMAP)1366 2224
-y Fd(Create)37 b(a)i(Switc)m(hMap)2568 2223 y FA(AST)p
-Fe(_)p FA(SWITCHMAP)0 2409 y Fc(Description:)44 b Fj(This)28
-b(function)g(creates)f(a)g(new)g(Switc)n(hMap)h(and)f(optionally)g
-(initialises)g(its)h(attributes.)227 2533 y(A)34 b(Switc)n(hMap)e(is)h
-(a)g(Mapping)f(whic)n(h)h(represen)n(ts)f(a)g(set)h(of)g(alternate)f
-(Mappings,)i(eac)n(h)e(of)h(whic)n(h)g(is)g(used)227
-2632 y(to)d(transform)f(p)r(ositions)g(within)i(a)e(particular)g
-(region)f(of)i(the)g(input)h(or)e(output)h(co)r(ordinate)f(system)g(of)
-h(the)227 2732 y(Switc)n(hMap.)227 2855 y(A)k(Switc)n(hMap)e(can)h
-(encapsulate)f(an)n(y)g(n)n(um)n(b)r(er)h(of)g(Mappings,)h(but)f(they)h
-(m)n(ust)f(all)f(ha)n(v)n(e)g(the)h(same)g(n)n(um-)227
-2955 y(b)r(er)d(of)g(inputs)h(\(Nin)f(attribute)g(v)-5
+f(is)g(returned)h(without)g(c)n(hange.)p 0 4724 V 0 4855
+a FA(AST)p Fe(_)p FA(SWITCHMAP)1366 4856 y Fd(Create)37
+b(a)i(Switc)m(hMap)2568 4855 y FA(AST)p Fe(_)p FA(SWITCHMAP)0
+5045 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+(Switc)n(hMap)h(and)f(optionally)g(initialises)g(its)h(attributes.)227
+5170 y(A)34 b(Switc)n(hMap)e(is)h(a)g(Mapping)f(whic)n(h)h(represen)n
+(ts)f(a)g(set)h(of)g(alternate)f(Mappings,)i(eac)n(h)e(of)h(whic)n(h)g
+(is)g(used)227 5269 y(to)d(transform)f(p)r(ositions)g(within)i(a)e
+(particular)g(region)f(of)i(the)g(input)h(or)e(output)h(co)r(ordinate)f
+(system)g(of)h(the)227 5369 y(Switc)n(hMap.)227 5494
+y(A)k(Switc)n(hMap)e(can)h(encapsulate)f(an)n(y)g(n)n(um)n(b)r(er)h(of)
+g(Mappings,)h(but)f(they)h(m)n(ust)f(all)f(ha)n(v)n(e)g(the)h(same)g(n)
+n(um-)227 5593 y(b)r(er)d(of)g(inputs)h(\(Nin)f(attribute)g(v)-5
b(alue\))31 b(and)e(the)i(same)e(n)n(um)n(b)r(er)h(of)g(outputs)g
-(\(Nout)g(attribute)g(v)-5 b(alue\).)45 b(The)227 3055
+(\(Nout)g(attribute)g(v)-5 b(alue\).)45 b(The)227 5693
y(Switc)n(hMap)20 b(itself)h(inherits)f(these)g(same)g(v)-5
b(alues)20 b(for)f(its)i(Nin)f(and)g(Nout)h(attributes.)34
-b(Eac)n(h)19 b(of)h(these)g(Mappings)227 3154 y(represen)n(ts)33
-b(a)h Ft(")p Fj(route)p Ft(")f Fj(through)h(the)g(switc)n(h,)i(and)e
-(are)g(referred)f(to)h(as)g Ft(")p Fj(route)p Ft(")e
-Fj(Mappings)i(b)r(elo)n(w.)57 b(Eac)n(h)227 3254 y(route)30
-b(Mapping)f(transforms)g(p)r(ositions)h(b)r(et)n(w)n(een)g(the)g(input)
-h(and)f(output)g(co)r(ordinate)f(space)h(of)g(the)g(en)n(tire)227
-3354 y(Switc)n(hMap,)f(but)h(only)e(one)h(Mapping)f(will)h(b)r(e)h
-(used)e(to)h(transform)f(an)n(y)g(giv)n(en)g(p)r(osition.)40
-b(The)29 b(selection)g(of)227 3453 y(the)e(appropriate)e(route)h
+b(Eac)n(h)19 b(of)h(these)g(Mappings)p eop end
+%%Page: 383 393
+TeXDict begin 383 392 bop 3643 52 a FG(383)227 351 y
+Fj(represen)n(ts)33 b(a)h Ft(")p Fj(route)p Ft(")f Fj(through)h(the)g
+(switc)n(h,)i(and)e(are)g(referred)f(to)h(as)g Ft(")p
+Fj(route)p Ft(")e Fj(Mappings)i(b)r(elo)n(w.)57 b(Eac)n(h)227
+451 y(route)30 b(Mapping)f(transforms)g(p)r(ositions)h(b)r(et)n(w)n
+(een)g(the)g(input)h(and)f(output)g(co)r(ordinate)f(space)h(of)g(the)g
+(en)n(tire)227 551 y(Switc)n(hMap,)f(but)h(only)e(one)h(Mapping)f(will)
+h(b)r(e)h(used)e(to)h(transform)f(an)n(y)g(giv)n(en)g(p)r(osition.)40
+b(The)29 b(selection)g(of)227 650 y(the)e(appropriate)e(route)h
(Mapping)g(to)g(use)g(with)h(an)n(y)f(giv)n(en)f(input)j(p)r(osition)e
-(is)g(made)g(b)n(y)g(another)g(Mapping,)227 3553 y(called)31
+(is)g(made)g(b)n(y)g(another)g(Mapping,)227 750 y(called)31
b(the)h Ft(")p Fj(selector)p Ft(")e Fj(Mapping.)48 b(Eac)n(h)30
b(Switc)n(hMap)i(encapsulates)e(t)n(w)n(o)h(selector)f(Mappings)h(in)h
-(addition)227 3653 y(to)d(its)g(route)f(Mappings;)h(one)g(for)f(use)h
+(addition)227 849 y(to)d(its)g(route)f(Mappings;)h(one)g(for)f(use)h
(with)g(the)g(Switc)n(hMap's)g(forw)n(ard)e(transformation)g(\(called)i
-(the)g Ft(")p Fj(for-)227 3752 y(w)n(ard)24 b(selector)g(Mapping)p
+(the)g Ft(")p Fj(for-)227 949 y(w)n(ard)24 b(selector)g(Mapping)p
Ft(")p Fj(\),)i(and)f(one)g(for)f(use)h(with)h(the)g(Switc)n(hMap's)f
(in)n(v)n(erse)f(transformation)f(\(called)i(the)227
-3852 y Ft(")p Fj(in)n(v)n(erse)f(selector)h(Mapping)p
+1049 y Ft(")p Fj(in)n(v)n(erse)f(selector)h(Mapping)p
Ft(")p Fj(\).)36 b(The)26 b(forw)n(ard)f(selector)g(Mapping)g(m)n(ust)h
(ha)n(v)n(e)f(the)i(same)e(n)n(um)n(b)r(er)h(of)g(inputs)227
-3951 y(as)k(the)h(route)e(Mappings,)i(but)g(should)f(ha)n(v)n(e)f(only)
+1148 y(as)k(the)h(route)e(Mappings,)i(but)g(should)f(ha)n(v)n(e)f(only)
h(one)g(output.)45 b(Lik)n(ewise,)30 b(the)h(in)n(v)n(erse)e(selector)g
-(Mapping)227 4051 y(m)n(ust)f(ha)n(v)n(e)e(the)i(same)f(n)n(um)n(b)r
+(Mapping)227 1248 y(m)n(ust)f(ha)n(v)n(e)e(the)i(same)f(n)n(um)n(b)r
(er)h(of)f(outputs)h(as)f(the)h(route)f(Mappings,)g(but)h(should)g(ha)n
-(v)n(e)e(only)h(one)h(input.)227 4175 y(When)40 b(the)g(Switc)n(hMap)f
+(v)n(e)e(only)h(one)h(input.)227 1386 y(When)40 b(the)g(Switc)n(hMap)f
(is)h(used)f(to)g(transform)g(a)g(p)r(osition)g(in)h(the)f(forw)n(ard)f
-(direction)h(\(from)h(input)g(to)227 4274 y(output\),)g(eac)n(h)35
+(direction)h(\(from)h(input)g(to)227 1485 y(output\),)g(eac)n(h)35
b(supplied)h(input)h(p)r(osition)f(is)h(\014rst)e(transformed)h(b)n(y)f
-(the)i(forw)n(ard)e(transformation)f(of)i(the)227 4374
+(the)i(forw)n(ard)e(transformation)f(of)i(the)227 1585
y(forw)n(ard)27 b(selector)g(Mapping.)38 b(This)28 b(pro)r(duces)f(a)h
(single)f(output)i(v)-5 b(alue)28 b(for)g(eac)n(h)f(input)i(p)r
-(osition)f(referred)f(to)227 4474 y(as)j(the)h(selector)e(v)-5
+(osition)f(referred)f(to)227 1684 y(as)j(the)h(selector)e(v)-5
b(alue.)45 b(The)30 b(nearest)f(in)n(teger)h(to)g(the)g(selector)g(v)-5
b(alue)30 b(is)g(found,)h(and)f(is)g(used)h(to)f(index)g(the)227
-4573 y(arra)n(y)25 b(of)i(route)f(Mappings)g(\(the)i(\014rst)f
+1784 y(arra)n(y)25 b(of)i(route)f(Mappings)g(\(the)i(\014rst)f
(supplied)g(route)f(Mapping)h(has)f(index)h(1,)g(the)g(second)g(route)f
-(Mapping)227 4673 y(has)34 b(index)h(2,)h(etc\).)59 b(If)35
+(Mapping)227 1884 y(has)34 b(index)h(2,)h(etc\).)59 b(If)35
b(the)g(nearest)f(in)n(teger)g(to)g(the)h(selector)f(v)-5
b(alue)35 b(is)f(less)h(than)f(1)h(or)e(greater)g(than)i(the)227
-4772 y(n)n(um)n(b)r(er)c(of)f(route)g(Mappings,)h(then)h(the)f(Switc)n
+1983 y(n)n(um)n(b)r(er)c(of)f(route)g(Mappings,)h(then)h(the)f(Switc)n
(hMap)f(output)i(p)r(osition)e(is)h(set)f(to)h(a)f(v)-5
-b(alue)31 b(of)g(AST)p Ft(__)p Fj(BAD)227 4872 y(on)k(ev)n(ery)g(axis.)
+b(alue)31 b(of)g(AST)p Ft(__)p Fj(BAD)227 2083 y(on)k(ev)n(ery)g(axis.)
59 b(Otherwise,)37 b(the)f(forw)n(ard)e(transformation)f(of)j(the)g
-(selected)f(route)g(Mapping)g(is)g(used)h(to)227 4972
+(selected)f(route)g(Mapping)g(is)g(used)h(to)227 2183
y(transform)27 b(the)h(supplied)g(input)g(p)r(osition)f(to)h(pro)r
(duce)f(the)h(Switc)n(hMap)g(output)g(p)r(osition.)227
-5095 y(When)33 b(the)g(Switc)n(hMap)f(is)g(used)g(to)g(transform)f(a)h
+2320 y(When)33 b(the)g(Switc)n(hMap)f(is)g(used)g(to)g(transform)f(a)h
(p)r(osition)g(in)h(the)f(in)n(v)n(erse)f(direction)h(\(from)g
-Ft(")p Fj(output)p Ft(")g Fj(to)227 5195 y Ft(")p Fj(input)p
+Ft(")p Fj(output)p Ft(")g Fj(to)227 2420 y Ft(")p Fj(input)p
Ft(")p Fj(\),)26 b(eac)n(h)f(supplied)g Ft(")p Fj(output)p
Ft(")g Fj(p)r(osition)g(is)g(\014rst)g(transformed)f(b)n(y)h(the)h(in)n
-(v)n(erse)e(transformation)f(of)i(the)227 5295 y(in)n(v)n(erse)31
+(v)n(erse)e(transformation)f(of)i(the)227 2519 y(in)n(v)n(erse)31
b(selector)f(Mapping.)49 b(This)32 b(pro)r(duces)f(a)g(selector)g(v)-5
b(alue)31 b(for)g(eac)n(h)g Ft(")p Fj(output)p Ft(")h
-Fj(p)r(osition.)49 b(Again,)32 b(the)227 5394 y(nearest)g(in)n(teger)f
+Fj(p)r(osition.)49 b(Again,)32 b(the)227 2619 y(nearest)g(in)n(teger)f
(to)i(the)g(selector)e(v)-5 b(alue)32 b(is)h(found,)h(and)e(is)g(used)h
(to)f(index)h(the)g(arra)n(y)d(of)i(route)g(Mappings.)227
-5494 y(If)f(this)f(selector)g(index)g(v)-5 b(alue)30
+2719 y(If)f(this)f(selector)g(index)g(v)-5 b(alue)30
b(is)g(within)h(the)g(b)r(ounds)f(of)g(the)h(arra)n(y)d(of)i(route)f
-(Mappings,)i(then)f(the)h(in)n(v)n(erse)227 5593 y(transformation)26
+(Mappings,)i(then)f(the)h(in)n(v)n(erse)227 2818 y(transformation)26
b(of)i(the)g(selected)f(route)g(Mapping)g(is)g(used)h(to)f(transform)g
(the)h(supplied)g Ft(")p Fj(output)p Ft(")f Fj(p)r(osition)227
-5693 y(to)32 b(pro)r(duce)f(the)h(Switc)n(hMap)f Ft(")p
+2918 y(to)32 b(pro)r(duce)f(the)h(Switc)n(hMap)f Ft(")p
Fj(input)p Ft(")h Fj(p)r(osition.)49 b(If)32 b(the)g(selector)e(index)i
-(v)-5 b(alue)31 b(is)h(outside)f(the)h(b)r(ounds)g(of)p
-eop end
-%%Page: 381 391
-TeXDict begin 381 390 bop 3643 52 a FG(381)227 351 y
-Fj(the)25 b(arra)n(y)e(of)h(route)g(Mappings,)h(then)g(the)g(Switc)n
-(hMap)g Ft(")p Fj(input)p Ft(")f Fj(p)r(osition)h(is)f(set)h(to)f(a)g
-(v)-5 b(alue)25 b(of)g(AST)p Ft(__)p Fj(BAD)227 451 y(on)j(ev)n(ery)e
-(axis.)227 587 y(In)f(practice,)f(appropriate)e(selector)h(Mappings)g
-(should)h(b)r(e)h(c)n(hosen)e(to)h(asso)r(ciate)f(a)g(di\013eren)n(t)h
-(route)g(Mapping)227 686 y(with)30 b(eac)n(h)e(region)g(of)h(co)r
-(ordinate)f(space.)41 b(Note)30 b(that)f(the)h(SelectorMap)e(class)g
-(of)h(Mapping)g(is)g(particularly)227 786 y(appropriate)d(for)h(this)h
-(purp)r(ose.)227 922 y(If)38 b(a)f(comp)r(ound)g(Mapping)g(con)n(tains)
-f(a)h(Switc)n(hMap)g(in)g(series)f(with)i(its)f(o)n(wn)g(in)n(v)n
-(erse,)h(the)f(com)n(bination)227 1022 y(of)31 b(the)h(t)n(w)n(o)f
-(adjacen)n(t)f(Switc)n(hMaps)h(will)h(b)r(e)f(replaced)g(b)n(y)g(a)g
-(UnitMap)g(when)h(the)g(comp)r(ound)f(Mapping)g(is)227
-1121 y(simpli\014ed)d(using)g(AST)p Ft(_)p Fj(SIMPLIFY.)0
-1293 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i
-(AST_SWITCHMAP\()38 b(FSMAP,)j(ISMAP,)g(NROUTE,)g(ROUTEMAPS,)e
-(OPTIONS,)h(STATUS)i(\))0 1466 y Fc(Argumen)m(ts:)259
-1625 y(FSMAP)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 1725
+(v)-5 b(alue)31 b(is)h(outside)f(the)h(b)r(ounds)g(of)227
+3018 y(the)25 b(arra)n(y)e(of)h(route)g(Mappings,)h(then)g(the)g(Switc)
+n(hMap)g Ft(")p Fj(input)p Ft(")f Fj(p)r(osition)h(is)f(set)h(to)f(a)g
+(v)-5 b(alue)25 b(of)g(AST)p Ft(__)p Fj(BAD)227 3117
+y(on)j(ev)n(ery)e(axis.)227 3255 y(In)f(practice,)f(appropriate)e
+(selector)h(Mappings)g(should)h(b)r(e)h(c)n(hosen)e(to)h(asso)r(ciate)f
+(a)g(di\013eren)n(t)h(route)g(Mapping)227 3355 y(with)30
+b(eac)n(h)e(region)g(of)h(co)r(ordinate)f(space.)41 b(Note)30
+b(that)f(the)h(SelectorMap)e(class)g(of)h(Mapping)g(is)g(particularly)
+227 3454 y(appropriate)d(for)h(this)h(purp)r(ose.)227
+3592 y(If)38 b(a)f(comp)r(ound)g(Mapping)g(con)n(tains)f(a)h(Switc)n
+(hMap)g(in)g(series)f(with)i(its)f(o)n(wn)g(in)n(v)n(erse,)h(the)f(com)
+n(bination)227 3691 y(of)31 b(the)h(t)n(w)n(o)f(adjacen)n(t)f(Switc)n
+(hMaps)h(will)h(b)r(e)f(replaced)g(b)n(y)g(a)g(UnitMap)g(when)h(the)g
+(comp)r(ound)f(Mapping)g(is)227 3791 y(simpli\014ed)d(using)g(AST)p
+Ft(_)p Fj(SIMPLIFY.)0 3967 y Fc(In)m(v)m(o)s(cation:)123
+b Ft(RESULT)41 b(=)i(AST_SWITCHMAP\()38 b(FSMAP,)j(ISMAP,)g(NROUTE,)g
+(ROUTEMAPS,)e(OPTIONS,)h(STATUS)i(\))0 4143 y Fc(Argumen)m(ts:)259
+4305 y(FSMAP)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 4405
y Fj(P)n(oin)n(ter)d(to)h(the)g(forw)n(ard)f(selector)g(Mapping.)41
b(This)29 b(m)n(ust)h(ha)n(v)n(e)d(a)i(de\014ned)h(forw)n(ard)d
-(transformation,)427 1824 y(but)i(need)g(not)f(ha)n(v)n(e)f(a)h
+(transformation,)427 4504 y(but)i(need)g(not)f(ha)n(v)n(e)f(a)h
(de\014ned)h(in)n(v)n(erse)e(transformation.)37 b(It)29
b(m)n(ust)g(ha)n(v)n(e)e(one)h(output,)h(and)f(the)h(n)n(um-)427
-1924 y(b)r(er)39 b(of)g(inputs)g(m)n(ust)g(matc)n(h)f(the)h(n)n(um)n(b)
+4604 y(b)r(er)39 b(of)g(inputs)g(m)n(ust)g(matc)n(h)f(the)h(n)n(um)n(b)
r(er)g(of)f(inputs)i(of)e(eac)n(h)g(of)h(the)g(supplied)g(route)f
-(Mappings.)427 2023 y(AST)p Ft(__)p Fj(NULL)27 b(ma)n(y)f(b)r(e)i
+(Mappings.)427 4704 y(AST)p Ft(__)p Fj(NULL)27 b(ma)n(y)f(b)r(e)i
(supplied,)f(in)g(whic)n(h)g(case)f(the)h(Switc)n(hMap)g(will)g(ha)n(v)
-n(e)f(an)h(unde\014ned)g(forw)n(ard)427 2123 y(Mapping.)259
-2267 y Fc(ISMAP)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 2367
+n(e)f(an)h(unde\014ned)g(forw)n(ard)427 4803 y(Mapping.)259
+4949 y Fc(ISMAP)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 5049
y Fj(P)n(oin)n(ter)g(to)h(the)h(in)n(v)n(erse)e(selector)g(Mapping.)54
b(This)34 b(m)n(ust)f(ha)n(v)n(e)f(a)h(de\014ned)h(in)n(v)n(erse)e
-(transformation,)427 2467 y(but)e(need)g(not)g(ha)n(v)n(e)e(a)h
+(transformation,)427 5149 y(but)e(need)g(not)g(ha)n(v)n(e)e(a)h
(de\014ned)h(forw)n(ard)e(transformation.)41 b(It)30
b(m)n(ust)g(ha)n(v)n(e)e(one)h(input,)i(and)f(the)g(n)n(um-)427
-2566 y(b)r(er)i(of)g(outputs)g(m)n(ust)g(matc)n(h)g(the)g(n)n(um)n(b)r
+5248 y(b)r(er)i(of)g(outputs)g(m)n(ust)g(matc)n(h)g(the)g(n)n(um)n(b)r
(er)g(of)g(outputs)g(of)g(eac)n(h)f(of)h(the)h(supplied)f(route)f
-(Mappings.)427 2666 y(AST)p Ft(__)p Fj(NULL)e(ma)n(y)g(b)r(e)g
+(Mappings.)427 5348 y(AST)p Ft(__)p Fj(NULL)e(ma)n(y)g(b)r(e)g
(supplied,)h(in)g(whic)n(h)f(case)f(the)i(Switc)n(hMap)f(will)g(ha)n(v)
-n(e)f(an)h(unde\014ned)h(in)n(v)n(erse)427 2765 y(Mapping.)259
-2910 y Fc(NR)m(OUTE)i(=)g(INTEGER)f(\(Giv)m(en\))427
-3009 y Fj(The)d(n)n(um)n(b)r(er)f(of)h(supplied)g(route)f(Mappings.)259
-3154 y Fc(R)m(OUTEMAPS\()32 b(NR)m(OUTE)g(\))g(=)g(INTEGER)g(\(Giv)m
-(en\))427 3253 y Fj(An)37 b(arra)n(y)d(of)i(p)r(oin)n(ters)f(to)h(the)h
-(route)e(Mappings.)62 b(All)37 b(the)f(supplied)h(route)e(Mappings)h(m)
-n(ust)g(ha)n(v)n(e)427 3353 y(common)23 b(v)-5 b(alues)23
-b(for)g(the)h(Nin)g(and)f(Nout)h(attributes,)g(and)f(these)h(v)-5
-b(alues)23 b(de\014ne)h(the)f(n)n(um)n(b)r(er)h(of)f(inputs)427
-3452 y(and)28 b(outputs)g(of)f(the)h(Switc)n(hMap.)259
-3597 y Fc(OPTIONS)k(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 3696 y Fj(A)g(c)n(haracter)e(string)
-h(con)n(taining)f(an)h(optional)g(comma-separated)e(list)j(of)g
-(attribute)f(assignmen)n(ts)g(to)427 3796 y(b)r(e)38
-b(used)g(for)f(initialising)g(the)h(new)g(Switc)n(hMap.)66
-b(The)38 b(syn)n(tax)f(used)g(is)h(iden)n(tical)f(to)g(that)h(for)f
-(the)427 3896 y(AST)p Ft(_)p Fj(SET)27 b(routine.)259
-4040 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 4139 y Fj(The)c(global)e(status.)0 4324
-y Fc(Returned)32 b(V)-8 b(alue:)259 4483 y(AST)p Ft(_)p
-Fc(SWITCHMAP)32 b(=)g(INTEGER)427 4583 y Fj(A)c(p)r(oin)n(ter)f(to)h
-(the)g(new)g(Switc)n(hMap.)0 4768 y Fc(Notes:)340 5073
-y Fi(\017)45 b Fj(Note)38 b(that)g(the)g(comp)r(onen)n(t)f(Mappings)g
-(supplied)h(are)f(not)g(copied)h(b)n(y)f(AST)p Ft(_)p
-Fj(SWITCHMAP)h(\(the)427 5173 y(new)26 b(Switc)n(hMap)f(simply)g
-(retains)g(a)g(reference)f(to)h(them\).)37 b(They)25
-b(ma)n(y)g(con)n(tin)n(ue)f(to)i(b)r(e)f(used)g(for)g(other)427
-5272 y(purp)r(oses,)37 b(but)f(should)g(not)f(b)r(e)i(deleted.)61
-b(If)36 b(a)f(Switc)n(hMap)h(con)n(taining)e(a)i(cop)n(y)e(of)i(its)g
-(comp)r(onen)n(t)427 5372 y(Mappings)27 b(is)h(required,)e(then)j(a)e
-(cop)n(y)f(of)i(the)g(Switc)n(hMap)g(should)f(b)r(e)h(made)f(using)h
-(AST)p Ft(_)p Fj(COPY.)340 5516 y Fi(\017)45 b Fj(A)21
-b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
+n(e)f(an)h(unde\014ned)h(in)n(v)n(erse)427 5447 y(Mapping.)259
+5593 y Fc(NR)m(OUTE)i(=)g(INTEGER)f(\(Giv)m(en\))427
+5693 y Fj(The)d(n)n(um)n(b)r(er)f(of)h(supplied)g(route)f(Mappings.)p
+eop end
+%%Page: 384 394
+TeXDict begin 384 393 bop 0 52 a FG(384)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(R)m(OUTEMAPS\()h(NR)m
+(OUTE)g(\))g(=)g(INTEGER)g(\(Giv)m(en\))427 451 y Fj(An)37
+b(arra)n(y)d(of)i(p)r(oin)n(ters)f(to)h(the)h(route)e(Mappings.)62
+b(All)37 b(the)f(supplied)h(route)e(Mappings)h(m)n(ust)g(ha)n(v)n(e)427
+551 y(common)23 b(v)-5 b(alues)23 b(for)g(the)h(Nin)g(and)f(Nout)h
+(attributes,)g(and)f(these)h(v)-5 b(alues)23 b(de\014ne)h(the)f(n)n(um)
+n(b)r(er)h(of)f(inputs)427 650 y(and)28 b(outputs)g(of)f(the)h(Switc)n
+(hMap.)259 775 y Fc(OPTIONS)k(=)g(CHARA)m(CTER)g Fi(\003)f
+Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427 875 y Fj(A)g(c)n(haracter)e
+(string)h(con)n(taining)f(an)h(optional)g(comma-separated)e(list)j(of)g
+(attribute)f(assignmen)n(ts)g(to)427 974 y(b)r(e)38 b(used)g(for)f
+(initialising)g(the)h(new)g(Switc)n(hMap.)66 b(The)38
+b(syn)n(tax)f(used)g(is)h(iden)n(tical)f(to)g(that)h(for)f(the)427
+1074 y(AST)p Ft(_)p Fj(SET)27 b(routine.)259 1199 y Fc(ST)-8
+b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+1298 y Fj(The)c(global)e(status.)0 1452 y Fc(Returned)32
+b(V)-8 b(alue:)259 1580 y(AST)p Ft(_)p Fc(SWITCHMAP)32
+b(=)g(INTEGER)427 1680 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(Switc)
+n(hMap.)0 1834 y Fc(Notes:)340 2108 y Fi(\017)45 b Fj(Note)38
+b(that)g(the)g(comp)r(onen)n(t)f(Mappings)g(supplied)h(are)f(not)g
+(copied)h(b)n(y)f(AST)p Ft(_)p Fj(SWITCHMAP)h(\(the)427
+2208 y(new)26 b(Switc)n(hMap)f(simply)g(retains)g(a)g(reference)f(to)h
+(them\).)37 b(They)25 b(ma)n(y)g(con)n(tin)n(ue)f(to)i(b)r(e)f(used)g
+(for)g(other)427 2308 y(purp)r(oses,)37 b(but)f(should)g(not)f(b)r(e)i
+(deleted.)61 b(If)36 b(a)f(Switc)n(hMap)h(con)n(taining)e(a)i(cop)n(y)e
+(of)i(its)g(comp)r(onen)n(t)427 2407 y(Mappings)27 b(is)h(required,)e
+(then)j(a)e(cop)n(y)f(of)i(the)g(Switc)n(hMap)g(should)f(b)r(e)h(made)f
+(using)h(AST)p Ft(_)p Fj(COPY.)340 2532 y Fi(\017)45
+b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 5616
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 2632
y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p eop end
-%%Page: 382 392
-TeXDict begin 382 391 bop 0 52 a FG(382)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(T)-11 b(ABLE)1511 483 y
-Fd(Create)37 b(a)i(T)-10 b(able)3000 482 y FA(AST)p Fe(_)p
-FA(T)f(ABLE)0 660 y Fc(Description:)44 b Fj(This)28 b(function)g
-(creates)f(a)g(new)g(empt)n(y)h(T)-7 b(able)27 b(and)h(optionally)f
-(initialises)g(its)h(attributes.)227 785 y(The)40 b(T)-7
-b(able)40 b(class)f(is)h(a)f(t)n(yp)r(e)h(of)g(KeyMap)f(that)h
-(represen)n(ts)f(a)g(t)n(w)n(o-dimensional)f(table)i(of)g(v)-5
-b(alues.)74 b(The)227 885 y(AST)p Ft(_)p Fj(MAPGET...)37
-b(and)27 b(AST)p Ft(_)p Fj(MAPPUT...)37 b(metho)r(ds)28
-b(pro)n(vided)e(b)n(y)i(the)g(KeyMap)f(class)f(should)i(b)r(e)g(used)
-227 984 y(for)h(storing)g(and)h(retrieving)e(v)-5 b(alues)29
-b(from)h(individual)g(cells)f(within)i(a)e(T)-7 b(able.)43
-b(Eac)n(h)28 b(en)n(try)h(in)h(the)h(KeyMap)227 1084
-y(represen)n(ts)k(a)i(single)f(cell)g(of)h(the)g(table)f(and)h(has)f
-(an)g(asso)r(ciated)f(k)n(ey)h(of)h(the)g(form)f Ft(")p
-Fl(<)p Fj(COL)p Fl(>)p Fj(\(i\))p Ft(")f Fj(where)227
-1184 y Ft(")p Fl(<)p Fj(COL)p Fl(>)p Ft(")24 b Fj(is)h(the)h(name)f(of)
+(fail)h(for)f(an)n(y)g(reason.)p 0 2815 3780 12 v 0 2946
+a FA(AST)p Fe(_)p FA(T)-11 b(ABLE)1511 2947 y Fd(Create)37
+b(a)i(T)-10 b(able)3000 2946 y FA(AST)p Fe(_)p FA(T)f(ABLE)0
+3106 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+(empt)n(y)h(T)-7 b(able)27 b(and)h(optionally)f(initialises)g(its)h
+(attributes.)227 3227 y(The)40 b(T)-7 b(able)40 b(class)f(is)h(a)f(t)n
+(yp)r(e)h(of)g(KeyMap)f(that)h(represen)n(ts)f(a)g(t)n(w)n
+(o-dimensional)f(table)i(of)g(v)-5 b(alues.)74 b(The)227
+3326 y(AST)p Ft(_)p Fj(MAPGET...)37 b(and)27 b(AST)p
+Ft(_)p Fj(MAPPUT...)37 b(metho)r(ds)28 b(pro)n(vided)e(b)n(y)i(the)g
+(KeyMap)f(class)f(should)i(b)r(e)g(used)227 3426 y(for)h(storing)g(and)
+h(retrieving)e(v)-5 b(alues)29 b(from)h(individual)g(cells)f(within)i
+(a)e(T)-7 b(able.)43 b(Eac)n(h)28 b(en)n(try)h(in)h(the)h(KeyMap)227
+3526 y(represen)n(ts)k(a)i(single)f(cell)g(of)h(the)g(table)f(and)h
+(has)f(an)g(asso)r(ciated)f(k)n(ey)h(of)h(the)g(form)f
+Ft(")p Fl(<)p Fj(COL)p Fl(>)p Fj(\(i\))p Ft(")f Fj(where)227
+3625 y Ft(")p Fl(<)p Fj(COL)p Fl(>)p Ft(")24 b Fj(is)h(the)h(name)f(of)
h(a)f(table)g(column)h(and)f Ft(")p Fj(i)p Ft(")g Fj(is)h(the)f(ro)n(w)
g(index)g(\(the)i(\014rst)e(ro)n(w)f(is)i(ro)n(w)e(1\).)36
-b(Keys)25 b(of)227 1283 y(this)j(form)f(should)h(alw)n(a)n(ys)d(b)r(e)j
+b(Keys)25 b(of)227 3725 y(this)j(form)f(should)h(alw)n(a)n(ys)d(b)r(e)j
(used)g(when)g(using)f(KeyMap)g(metho)r(ds)h(to)f(access)f(en)n(tries)h
-(within)i(a)e(T)-7 b(able.)227 1409 y(Columns)37 b(m)n(ust)f(b)r(e)h
+(within)i(a)e(T)-7 b(able.)227 3845 y(Columns)37 b(m)n(ust)f(b)r(e)h
(declared)f(using)g(the)h(AST)p Ft(_)p Fj(ADDCOLUMN)h(metho)r(d)f(b)r
-(efore)f(v)-5 b(alues)36 b(can)g(b)r(e)h(stored)227 1508
+(efore)f(v)-5 b(alues)36 b(can)g(b)r(e)h(stored)227 3945
y(within)d(them.)52 b(This)33 b(also)e(\014xes)i(the)g(t)n(yp)r(e)g
(and)f(shap)r(e)h(of)f(the)h(v)-5 b(alues)32 b(that)h(ma)n(y)f(b)r(e)h
-(stored)f(in)h(an)n(y)f(cell)h(of)227 1608 y(the)28 b(column.)36
+(stored)f(in)h(an)n(y)f(cell)h(of)227 4045 y(the)28 b(column.)36
b(Cells)27 b(ma)n(y)f(con)n(tain)h(scalar)e(or)h(v)n(ector)g(v)-5
b(alues)27 b(of)g(an)n(y)f(data)g(t)n(yp)r(e)i(supp)r(orted)e(b)n(y)h
-(the)h(KeyMap)227 1707 y(class.)35 b(Multi-dimensional)24
+(the)h(KeyMap)227 4144 y(class.)35 b(Multi-dimensional)24
b(arra)n(ys)e(ma)n(y)i(also)f(b)r(e)i(stored,)f(but)h(these)g(m)n(ust)f
-(b)r(e)h(v)n(ectorised)e(when)i(storing)e(and)227 1807
+(b)r(e)h(v)n(ectorised)e(when)i(storing)e(and)227 4244
y(retrieving)k(them)i(within)g(a)f(table)h(cell.)39 b(All)29
b(cells)f(within)h(a)f(single)g(column)g(m)n(ust)g(ha)n(v)n(e)g(the)g
-(same)g(t)n(yp)r(e)h(and)227 1907 y(shap)r(e)f(\(sp)r(eci\014ed)g(when)
-g(the)g(column)f(is)h(declared\).)227 2032 y(T)-7 b(ables)30
+(same)g(t)n(yp)r(e)h(and)227 4343 y(shap)r(e)f(\(sp)r(eci\014ed)g(when)
+g(the)g(column)f(is)h(declared\).)227 4464 y(T)-7 b(ables)30
b(ma)n(y)f(ha)n(v)n(e)h(parameters)e(that)j(describ)r(e)e(global)h
(prop)r(erties)f(of)h(the)h(en)n(tire)e(table.)45 b(These)30
-b(are)f(stored)227 2132 y(as)g(en)n(tries)g(in)h(the)g(paren)n(t)f
+b(are)f(stored)227 4564 y(as)g(en)n(tries)g(in)h(the)g(paren)n(t)f
(KeyMap)g(and)g(can)g(b)r(e)h(access)f(using)g(the)h(get)g(and)f(set)h
-(metho)r(d)g(of)f(the)i(KeyMap)227 2231 y(class.)44 b(Ho)n(w)n(ev)n
+(metho)r(d)g(of)f(the)i(KeyMap)227 4663 y(class.)44 b(Ho)n(w)n(ev)n
(er,)29 b(parameters)g(m)n(ust)h(b)r(e)h(declared)f(using)g(the)g(AST)p
Ft(_)p Fj(ADDP)-7 b(ARAMETER)31 b(metho)r(d)g(b)r(efore)227
-2331 y(b)r(eing)d(accessed.)227 2456 y(Note)f(-)f(since)h(accessing)e
+4763 y(b)r(eing)d(accessed.)227 4883 y(Note)f(-)f(since)h(accessing)e
(en)n(tries)h(within)h(a)f(KeyMap)g(is)g(a)g(relativ)n(ely)g(slo)n(w)f
-(pro)r(cess,)h(it)h(is)g(not)f(recommended)227 2556 y(to)i(use)f(the)h
+(pro)r(cess,)h(it)h(is)g(not)f(recommended)227 4983 y(to)i(use)f(the)h
(T)-7 b(able)27 b(class)g(to)h(store)e(v)n(ery)h(large)f(tables.)0
-2706 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_TABLE\()c
-(OPTIONS,)i(STATUS)g(\))0 2857 y Fc(Argumen)m(ts:)259
-2995 y(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 3095 y Fj(A)g(c)n(haracter)e(string)
+5124 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_TABLE\()c
+(OPTIONS,)i(STATUS)g(\))0 5266 y Fc(Argumen)m(ts:)259
+5394 y(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 5494 y Fj(A)g(c)n(haracter)e(string)
h(con)n(taining)f(an)h(optional)g(comma-separated)e(list)j(of)g
-(attribute)f(assignmen)n(ts)g(to)427 3194 y(b)r(e)26
+(attribute)f(assignmen)n(ts)g(to)427 5593 y(b)r(e)26
b(used)g(for)f(initialising)h(the)g(new)g(T)-7 b(able.)36
b(The)26 b(syn)n(tax)f(used)h(is)f(iden)n(tical)h(to)f(that)i(for)e
-(the)h(AST)p Ft(_)p Fj(SET)427 3294 y(routine.)259 3427
-y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 3527 y Fj(The)c(global)e(status.)0 3690 y Fc(Returned)32
-b(V)-8 b(alue:)259 3828 y(AST)p Ft(_)p Fc(T)g(ABLE)33
-b(=)f(INTEGER)427 3928 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(T)-7
-b(able.)0 4091 y Fc(Notes:)340 4375 y Fi(\017)45 b Fj(A)21
+(the)h(AST)p Ft(_)p Fj(SET)427 5693 y(routine.)p eop
+end
+%%Page: 385 395
+TeXDict begin 385 394 bop 3643 52 a FG(385)259 351 y
+Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+451 y Fj(The)c(global)e(status.)0 622 y Fc(Returned)32
+b(V)-8 b(alue:)259 767 y(AST)p Ft(_)p Fc(T)g(ABLE)33
+b(=)f(INTEGER)427 867 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(T)-7
+b(able.)0 1038 y Fc(Notes:)340 1329 y Fi(\017)45 b Fj(A)21
b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 4474
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 1429
y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)-2 4638 y Fc(Status)33
-b(Handling)n(:)227 4784 y Fj(The)d(protected)g(in)n(terface)f(to)g
+(fail)h(for)f(an)n(y)g(reason.)-2 1600 y Fc(Status)33
+b(Handling)n(:)227 1746 y Fj(The)d(protected)g(in)n(terface)f(to)g
(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
-(of)g(the)g(parameter)227 4883 y(list)37 b(describ)r(ed)f(ab)r(o)n(v)n
+(of)g(the)g(parameter)227 1845 y(list)37 b(describ)r(ed)f(ab)r(o)n(v)n
(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
-Fj(in)n(t)227 4983 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p
-0 5184 V 0 5314 a FA(AST)p Fe(_)p FA(T)-11 b(ABLESOUR)l(CE)289
-b Fd(Register)37 b(a)1529 5425 y(source)h(routine)1569
-5524 y(for)g(accessing)1518 5639 y(tables)g(in)g(FITS)1792
-5739 y(\014les)2439 5314 y FA(AST)p Fe(_)p FA(T)-11 b(ABLESOUR)l(CE)p
-eop end
-%%Page: 383 393
-TeXDict begin 383 392 bop 3643 52 a FG(383)0 351 y Fc(Description:)44
-b Fj(This)29 b(routine)g(can)f(b)r(e)i(used)f(to)f(register)g(a)g
-(call-bac)n(k)g(routine)g(with)i(a)e(FitsChan.)41 b(The)29
-b(registered)227 451 y(routine)f(is)f(called)h(when-ev)n(er)f(the)h
-(FitsChan)g(needs)f(to)h(read)f(information)g(from)h(a)f(binary)g
-(table)h(con)n(tained)227 551 y(within)i(a)e(FITS)h(\014le.)39
+Fj(in)n(t)227 1945 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p
+0 2153 3780 12 v 0 2284 a FA(AST)p Fe(_)p FA(T)-11 b(ABLESOUR)l(CE)289
+b Fd(Register)37 b(a)1529 2394 y(source)h(routine)1569
+2494 y(for)g(accessing)1518 2609 y(tables)g(in)g(FITS)1792
+2708 y(\014les)2439 2284 y FA(AST)p Fe(_)p FA(T)-11 b(ABLESOUR)l(CE)0
+2883 y Fc(Description:)44 b Fj(This)29 b(routine)g(can)f(b)r(e)i(used)f
+(to)f(register)g(a)g(call-bac)n(k)g(routine)g(with)i(a)e(FitsChan.)41
+b(The)29 b(registered)227 2982 y(routine)f(is)f(called)h(when-ev)n(er)f
+(the)h(FitsChan)g(needs)f(to)h(read)f(information)g(from)h(a)f(binary)g
+(table)h(con)n(tained)227 3082 y(within)i(a)e(FITS)h(\014le.)39
b(This)29 b(o)r(ccurs)f(if)h(the)g(AST)p Ft(_)p Fj(READ)g(function)g
(is)f(in)n(v)n(ok)n(ed)f(to)i(read)e(a)h(F)-7 b(rameSet)29
-b(from)f(a)227 650 y(set)j(of)f(FITS)g(headers)f(that)i(use)f(the)h
+b(from)f(a)227 3182 y(set)j(of)f(FITS)g(headers)f(that)i(use)f(the)h
Ft(")p Fj(-T)-7 b(AB)p Ft(")29 b Fj(algorithm)g(to)h(describ)r(e)g(one)
g(or)f(more)g(axes.)44 b(Suc)n(h)30 b(axes)g(use)227
-750 y(a)i(FITS)h(binary)e(table)i(to)f(store)f(a)h(lo)r(ok-up)g(table)g
-(of)g(axis)g(v)-5 b(alues.)51 b(The)32 b(FitsChan)g(will)h(fail)f(to)g
-(read)g(suc)n(h)227 849 y(axes)23 b(unless)g(the)h Ft(")p
+3281 y(a)i(FITS)h(binary)e(table)i(to)f(store)f(a)h(lo)r(ok-up)g(table)
+g(of)g(axis)g(v)-5 b(alues.)51 b(The)32 b(FitsChan)g(will)h(fail)f(to)g
+(read)g(suc)n(h)227 3381 y(axes)23 b(unless)g(the)h Ft(")p
Fj(T)-7 b(abOK)p Ft(")22 b Fj(attribute)i(is)f(set)h(to)f(a)g(non-zero)
f(p)r(ositiv)n(e)h(in)n(teger)g(v)-5 b(alue.)35 b(The)24
-b(table)g(con)n(taining)227 949 y(the)j(axis)f(v)-5 b(alues)27
-b(m)n(ust)f(b)r(e)i(made)e(a)n(v)-5 b(ailable)25 b(to)i(the)g(FitsChan)
-g(either)f(b)n(y)h(storing)e(the)j(table)e(con)n(ten)n(ts)g(in)h(the)
-227 1049 y(FitsChan)33 b(\(using)f(AST)p Ft(_)p Fj(PUTT)-7
-b(ABLES)32 b(or)f(AST)p Ft(_)p Fj(PUTT)-7 b(ABLE\))32
-b(prior)g(to)g(in)n(v)n(oking)f(AST)p Ft(_)p Fj(READ)h(or)g(b)n(y)227
-1148 y(registering)26 b(a)h(call-bac)n(k)f(routine)h(using)h(AST)p
-Ft(_)p Fj(T)-7 b(ABLESOUR)n(CE.)26 b(The)i(\014rst)f(metho)r(d)h(is)g
-(p)r(ossibly)f(simpler,)227 1248 y(but)j(requires)e(that)i(the)g(name)f
-(of)g(the)h(extension)f(con)n(taining)f(the)i(table)f(b)r(e)h(kno)n(wn)
-f(in)g(adv)-5 b(ance.)42 b(Since)29 b(the)227 1348 y(table)21
-b(name)g(is)f(em)n(b)r(edded)h(in)g(the)h(FITS)f(headers,)g(the)g(name)
-f(is)h(often)g(not)g(kno)n(wn)f(in)h(adv)-5 b(ance.)34
-b(If)21 b(a)f(call-bac)n(k)227 1447 y(is)28 b(registered,)e(the)i
-(FitsChan)g(will)g(determine)g(the)g(name)f(of)h(the)g(required)f
-(table)h(and)f(in)n(v)n(ok)n(e)f(the)i(call-bac)n(k)227
-1547 y(routine)f(to)h(supply)g(the)g(table)f(at)h(the)g(p)r(oin)n(t)f
-(where)g(it)h(is)g(needed)g(\(i.e.)37 b(within)28 b(the)g(AST)p
-Ft(_)p Fj(READ)g(metho)r(d\).)0 1710 y Fc(In)m(v)m(o)s(cation:)123
-b Ft(CALL)42 b(AST_TABLESOURCE)o(\()c(THIS,)j(TABSOURCE,)f(STATUS)h(\))
-0 1873 y Fc(Argumen)m(ts:)259 2023 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 2122 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
-2262 y Fc(T)-8 b(ABSOUR)m(CE)32 b(=)g(SUBR)m(OUTINE)h(\(Giv)m(en\))427
-2361 y Fj(The)21 b(table)g(source)f(routine)h(to)f(use.)35
+b(table)g(con)n(taining)227 3481 y(the)j(axis)f(v)-5
+b(alues)27 b(m)n(ust)f(b)r(e)i(made)e(a)n(v)-5 b(ailable)25
+b(to)i(the)g(FitsChan)g(either)f(b)n(y)h(storing)e(the)j(table)e(con)n
+(ten)n(ts)g(in)h(the)227 3580 y(FitsChan)33 b(\(using)f(AST)p
+Ft(_)p Fj(PUTT)-7 b(ABLES)32 b(or)f(AST)p Ft(_)p Fj(PUTT)-7
+b(ABLE\))32 b(prior)g(to)g(in)n(v)n(oking)f(AST)p Ft(_)p
+Fj(READ)h(or)g(b)n(y)227 3680 y(registering)26 b(a)h(call-bac)n(k)f
+(routine)h(using)h(AST)p Ft(_)p Fj(T)-7 b(ABLESOUR)n(CE.)26
+b(The)i(\014rst)f(metho)r(d)h(is)g(p)r(ossibly)f(simpler,)227
+3779 y(but)j(requires)e(that)i(the)g(name)f(of)g(the)h(extension)f(con)
+n(taining)f(the)i(table)f(b)r(e)h(kno)n(wn)f(in)g(adv)-5
+b(ance.)42 b(Since)29 b(the)227 3879 y(table)21 b(name)g(is)f(em)n(b)r
+(edded)h(in)g(the)h(FITS)f(headers,)g(the)g(name)f(is)h(often)g(not)g
+(kno)n(wn)f(in)h(adv)-5 b(ance.)34 b(If)21 b(a)f(call-bac)n(k)227
+3979 y(is)28 b(registered,)e(the)i(FitsChan)g(will)g(determine)g(the)g
+(name)f(of)h(the)g(required)f(table)h(and)f(in)n(v)n(ok)n(e)f(the)i
+(call-bac)n(k)227 4078 y(routine)f(to)h(supply)g(the)g(table)f(at)h
+(the)g(p)r(oin)n(t)f(where)g(it)h(is)g(needed)g(\(i.e.)37
+b(within)28 b(the)g(AST)p Ft(_)p Fj(READ)g(metho)r(d\).)0
+4237 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_TABLESOURCE)o(\()
+c(THIS,)j(TABSOURCE,)f(STATUS)h(\))0 4395 y Fc(Argumen)m(ts:)259
+4541 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 4640
+y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259 4778
+y Fc(T)-8 b(ABSOUR)m(CE)32 b(=)g(SUBR)m(OUTINE)h(\(Giv)m(en\))427
+4877 y Fj(The)21 b(table)g(source)f(routine)h(to)f(use.)35
b(It)21 b(tak)n(es)f(\014v)n(e)h(argumen)n(ts)e(-)i(the)h(\014rst)e(is)
-h(a)g(p)r(oin)n(ter)f(to)h(the)g(FitsChan,)427 2461 y(the)26
+h(a)g(p)r(oin)n(ter)f(to)h(the)g(FitsChan,)427 4977 y(the)26
b(second)f(is)g(a)g(string)f(holding)h(the)h(name)f(of)g(the)h(FITS)f
(extension)g(con)n(taining)f(the)i(required)e(binary)427
-2561 y(table)36 b(\()p Ft(")p Fj(EXTNAME)p Ft(")p Fj(\),)i(the)f(third)
+5076 y(table)36 b(\()p Ft(")p Fj(EXTNAME)p Ft(")p Fj(\),)i(the)f(third)
f(is)g(the)h(in)n(teger)e(FITS)i Ft(")p Fj(EXTVER)p Ft(")e
-Fj(header)g(v)-5 b(alue)36 b(for)g(the)g(re-)427 2660
+Fj(header)g(v)-5 b(alue)36 b(for)g(the)g(re-)427 5176
y(quired)25 b(extension,)g(the)h(fourth)f(is)g(the)h(in)n(teger)e(FITS)
i Ft(")p Fj(EXTLEVEL)p Ft(")d Fj(header)h(v)-5 b(alue)25
-b(for)g(the)h(required)427 2760 y(extension,)h(and)h(the)g(\014fth)g
+b(for)g(the)h(required)427 5276 y(extension,)h(and)h(the)g(\014fth)g
(is)g(the)g(inherited)g(in)n(teger)e(status)i(v)-5 b(alue.)427
-2880 y(The)33 b(call-bac)n(k)f(should)h(read)f(the)h(en)n(tire)g(con)n
+5394 y(The)33 b(call-bac)n(k)f(should)h(read)f(the)h(en)n(tire)g(con)n
(ten)n(ts)g(\(header)f(and)h(data\))g(of)g(the)g(binary)g(table)g(in)g
-(the)427 2979 y(named)28 b(extension)f(of)g(the)h(external)f(FITS)h
+(the)427 5494 y(named)28 b(extension)f(of)g(the)h(external)f(FITS)h
(\014le,)f(storing)g(the)h(con)n(ten)n(ts)f(in)g(a)g(newly)h(created)f
-(FitsT)-7 b(able)427 3079 y(ob)5 b(ject.)38 b(It)28 b(should)g(then)g
+(FitsT)-7 b(able)427 5593 y(ob)5 b(ject.)38 b(It)28 b(should)g(then)g
(store)f(this)i(FitsT)-7 b(able)28 b(in)g(the)g(FitsChan)g(using)g(the)
-g(AST)p Ft(_)p Fj(PUTT)-7 b(ABLES)27 b(or)427 3178 y(AST)p
+g(AST)p Ft(_)p Fj(PUTT)-7 b(ABLES)27 b(or)427 5693 y(AST)p
Ft(_)p Fj(PUTT)-7 b(ABLE)29 b(metho)r(d,)i(and)e(\014nally)h(ann)n(ull)
f(its)h(lo)r(cal)f(cop)n(y)g(of)h(the)g(FitsT)-7 b(able)29
-b(p)r(oin)n(ter.)43 b(If)30 b(the)427 3278 y(table)e(cannot)e(b)r(e)i
-(read)e(for)h(an)n(y)g(reason,)f(or)g(if)i(an)n(y)e(other)h(error)e(o)r
-(ccurs,)i(it)g(should)h(return)e(a)h(non-zero)427 3378
-y(in)n(teger)g(for)g(the)h(\014nal)f(\(third\))i(argumen)n(t.)427
-3497 y(If)f(T)-7 b(ABSOUR)n(CE)27 b(is)h(AST)p Ft(_)p
+b(p)r(oin)n(ter.)43 b(If)30 b(the)p eop end
+%%Page: 386 396
+TeXDict begin 386 395 bop 0 52 a FG(386)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(table)d(cannot)e(b)r
+(e)i(read)e(for)h(an)n(y)g(reason,)f(or)g(if)i(an)n(y)e(other)h(error)e
+(o)r(ccurs,)i(it)g(should)h(return)e(a)h(non-zero)427
+451 y(in)n(teger)g(for)g(the)h(\014nal)f(\(third\))i(argumen)n(t.)427
+574 y(If)f(T)-7 b(ABSOUR)n(CE)27 b(is)h(AST)p Ft(_)p
Fj(NULL,)g(an)n(y)f(registered)f(call-bac)n(k)g(function)i(will)g(b)r
-(e)g(remo)n(v)n(ed.)259 3637 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 3737
-y Fj(The)c(global)e(status.)0 3912 y Fc(Notes:)340 4208
-y Fi(\017)45 b Fj(The)29 b(name)g(of)g(the)h(routine)e(supplied)i(for)e
-(the)i(T)-7 b(ABSOUR)n(CE)28 b(argumen)n(t)g(should)h(app)r(ear)f(in)h
-(an)g(EX-)427 4308 y(TERNAL)g(statemen)n(t)f(in)h(the)g(F)-7
-b(ortran)27 b(routine)h(whic)n(h)h(in)n(v)n(ok)n(es)d(AST)p
-Ft(_)p Fj(T)-7 b(ABLESOUR)n(CE.)28 b(Ho)n(w)n(ev)n(er,)427
-4407 y(this)36 b(is)f(not)g(generally)f(necessary)f(for)i(the)g(n)n
-(ull)h(routine)f(AST)p Ft(_)p Fj(NULL)g(\(so)g(long)f(as)h(the)h(AST)p
-Ft(_)p Fj(P)-7 b(AR)427 4507 y(include)28 b(\014le)g(has)f(b)r(een)h
-(used\).)340 4646 y Fi(\017)45 b Fj(Note)36 b(that)f(the)h(n)n(ull)f
+(e)g(remo)n(v)n(ed.)259 719 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f
+(\(Giv)m(en)h(and)g(Returned\))427 819 y Fj(The)c(global)e(status.)0
+1006 y Fc(Notes:)340 1314 y Fi(\017)45 b Fj(The)29 b(name)g(of)g(the)h
+(routine)e(supplied)i(for)e(the)i(T)-7 b(ABSOUR)n(CE)28
+b(argumen)n(t)g(should)h(app)r(ear)f(in)h(an)g(EX-)427
+1414 y(TERNAL)g(statemen)n(t)f(in)h(the)g(F)-7 b(ortran)27
+b(routine)h(whic)n(h)h(in)n(v)n(ok)n(es)d(AST)p Ft(_)p
+Fj(T)-7 b(ABLESOUR)n(CE.)28 b(Ho)n(w)n(ev)n(er,)427 1513
+y(this)36 b(is)f(not)g(generally)f(necessary)f(for)i(the)g(n)n(ull)h
+(routine)f(AST)p Ft(_)p Fj(NULL)g(\(so)g(long)f(as)h(the)h(AST)p
+Ft(_)p Fj(P)-7 b(AR)427 1613 y(include)28 b(\014le)g(has)f(b)r(een)h
+(used\).)340 1759 y Fi(\017)45 b Fj(Note)36 b(that)f(the)h(n)n(ull)f
(routine)g(AST)p Ft(_)p Fj(NULL)h(\(one)f(underscore\))f(is)h
(di\013eren)n(t)h(to)f(AST)p Ft(__)p Fj(NULL)g(\(t)n(w)n(o)427
-4746 y(underscores\),)26 b(whic)n(h)i(is)f(the)h(n)n(ull)g(Ob)5
-b(ject)28 b(p)r(oin)n(ter.)p 0 4959 3780 12 v 0 5090
-a FA(AST)p Fe(_)p FA(TEST)904 5091 y Fd(T)-10 b(est)38
+1858 y(underscores\),)26 b(whic)n(h)i(is)f(the)h(n)n(ull)g(Ob)5
+b(ject)28 b(p)r(oin)n(ter.)p 0 2083 3780 12 v 0 2214
+a FA(AST)p Fe(_)p FA(TEST)904 2215 y Fd(T)-10 b(est)38
b(if)g(an)h(Ob)7 b(ject)38 b(attribute)e(v)-7 b(alue)39
-b(is)f(set)3098 5090 y FA(AST)p Fe(_)p FA(TEST)0 5293
+b(is)f(set)3098 2214 y FA(AST)p Fe(_)p FA(TEST)0 2429
y Fc(Description:)44 b Fj(This)31 b(function)g(returns)f(a)h(logical)e
(result)i(to)f(indicate)h(whether)f(a)h(v)-5 b(alue)30
-b(has)h(b)r(een)g(explicitly)g(set)227 5393 y(for)c(one)h(of)f(an)g(Ob)
-5 b(ject's)28 b(attributes.)0 5556 y Fc(In)m(v)m(o)s(cation:)123
+b(has)h(b)r(een)g(explicitly)g(set)227 2529 y(for)c(one)h(of)f(an)g(Ob)
+5 b(ject's)28 b(attributes.)0 2704 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_TEST\()d(THIS,)h(ATTRIB,)g(STATUS)g(\))0
-5718 y Fc(Argumen)m(ts:)p eop end
-%%Page: 384 394
-TeXDict begin 384 393 bop 0 52 a FG(384)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(THIS)h(=)g(INTEGER)g
-(\(Giv)m(en\))427 451 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5
-b(ject.)259 584 y Fc(A)-8 b(TTRIB)33 b(=)f(CHARA)m(CTER)f
+2879 y Fc(Argumen)m(ts:)259 3041 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 3140 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5
+b(ject.)259 3286 y Fc(A)-8 b(TTRIB)33 b(=)f(CHARA)m(CTER)f
Fi(\003)h Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-684 y Fj(A)c(c)n(haracter)e(string)h(con)n(taining)f(the)i(name)g(of)f
-(the)h(attribute)g(to)f(b)r(e)h(tested.)259 817 y Fc(ST)-8
+3386 y Fj(A)c(c)n(haracter)e(string)h(con)n(taining)f(the)i(name)g(of)f
+(the)h(attribute)g(to)f(b)r(e)h(tested.)259 3531 y Fc(ST)-8
b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-917 y Fj(The)c(global)e(status.)0 1080 y Fc(Class)31
-b(Applicabilit)m(y:)259 1217 y(Ob)5 b(ject)427 1317 y
+3631 y Fj(The)c(global)e(status.)0 3818 y Fc(Class)31
+b(Applicabilit)m(y:)259 3980 y(Ob)5 b(ject)427 4080 y
Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5 b(jects.)0
-1480 y Fc(Returned)32 b(V)-8 b(alue:)259 1617 y(AST)p
-Ft(_)p Fc(TEST)33 b(=)f(LOGICAL)427 1717 y Fj(.TR)n(UE.)20
+4267 y Fc(Returned)32 b(V)-8 b(alue:)259 4429 y(AST)p
+Ft(_)p Fc(TEST)33 b(=)f(LOGICAL)427 4529 y Fj(.TR)n(UE.)20
b(if)g(a)f(v)-5 b(alue)20 b(has)f(previously)f(b)r(een)i(explicitly)g
(set)g(for)f(the)h(attribute)g(\(and)g(hasn't)f(b)r(een)h(cleared\),)
-427 1817 y(otherwise)27 b(.F)-9 b(ALSE..)0 1980 y Fc(Notes:)340
-2263 y Fi(\017)45 b Fj(A)n(ttribute)28 b(names)g(are)e(not)i(case)f
+427 4628 y(otherwise)27 b(.F)-9 b(ALSE..)0 4816 y Fc(Notes:)340
+5124 y Fi(\017)45 b Fj(A)n(ttribute)28 b(names)g(are)e(not)i(case)f
(sensitiv)n(e)g(and)g(ma)n(y)g(b)r(e)h(surrounded)e(b)n(y)i(white)g
-(space.)340 2397 y Fi(\017)45 b Fj(A)28 b(v)-5 b(alue)28
+(space.)340 5269 y Fi(\017)45 b Fj(A)28 b(v)-5 b(alue)28
b(of)f(.F)-9 b(ALSE.)28 b(will)g(b)r(e)g(returned)f(if)h(this)g
(function)g(is)f(in)n(v)n(ok)n(ed)g(with)h(ST)-7 b(A)g(TUS)28
-b(set)g(to)f(an)h(error)427 2496 y(v)-5 b(alue,)28 b(or)f(if)h(it)g
-(should)f(fail)h(for)f(an)n(y)g(reason.)340 2629 y Fi(\017)45
+b(set)g(to)f(an)h(error)427 5369 y(v)-5 b(alue,)28 b(or)f(if)h(it)g
+(should)f(fail)h(for)f(an)n(y)g(reason.)340 5515 y Fi(\017)45
b Fj(A)26 b(v)-5 b(alue)25 b(of)h(.F)-9 b(ALSE.)25 b(will)h(also)e(b)r
(e)i(returned)f(if)g(this)h(function)g(is)f(used)h(to)f(test)h(a)f
-(read-only)e(attribute,)427 2729 y(although)k(no)h(error)d(will)j
-(result.)p 0 2929 3780 12 v 0 3060 a FA(AST)p Fe(_)p
-FA(TESTFITS)1136 3061 y Fd(See)37 b(if)g(a)f(named)g(k)m(eyw)m(ord)f
-(has)i(a)1183 3176 y(de\014ned)i(v)-7 b(alue)39 b(in)f(a)h(FitsChan)
-2795 3060 y FA(AST)p Fe(_)p FA(TESTFITS)0 3342 y Fc(Description:)44
-b Fj(This)31 b(function)h(serc)n(hes)e(for)g(a)h(named)g(k)n(eyw)n(ord)
-e(in)i(a)g(FitsChan.)47 b(If)31 b(found,)i(and)e(if)g(the)g(k)n(eyw)n
-(ord)227 3442 y(has)h(a)h(v)-5 b(alue)32 b(asso)r(ciated)f(with)j(it,)g
-(a)e(.TR)n(UE.)g(v)-5 b(alue)33 b(is)g(returned.)51 b(If)33
-b(the)g(k)n(eyw)n(ord)e(is)h(not)h(found,)h(or)e(if)h(it)227
-3542 y(do)r(es)28 b(not)f(ha)n(v)n(e)g(an)g(asso)r(ciated)f(v)-5
-b(alue,)28 b(a)f(.F)-9 b(ALSE.)27 b(v)-5 b(alue)28 b(is)f(returned.)0
-3692 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_TESTFITS\()
-38 b(THIS,)k(NAME,)f(THERE,)g(STATUS)g(\))0 3843 y Fc(Argumen)m(ts:)259
-3980 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 4080
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259 4213
+(read-only)e(attribute,)427 5614 y(although)k(no)h(error)d(will)j
+(result.)p eop end
+%%Page: 387 397
+TeXDict begin 387 396 bop 3643 52 a FG(387)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(TESTFITS)1136 483 y Fd(See)37
+b(if)g(a)f(named)g(k)m(eyw)m(ord)f(has)i(a)1183 598 y(de\014ned)i(v)-7
+b(alue)39 b(in)f(a)h(FitsChan)2795 482 y FA(AST)p Fe(_)p
+FA(TESTFITS)0 770 y Fc(Description:)44 b Fj(This)31 b(function)h(serc)n
+(hes)e(for)g(a)h(named)g(k)n(eyw)n(ord)e(in)i(a)g(FitsChan.)47
+b(If)31 b(found,)i(and)e(if)g(the)g(k)n(eyw)n(ord)227
+869 y(has)h(a)h(v)-5 b(alue)32 b(asso)r(ciated)f(with)j(it,)g(a)e(.TR)n
+(UE.)g(v)-5 b(alue)33 b(is)g(returned.)51 b(If)33 b(the)g(k)n(eyw)n
+(ord)e(is)h(not)h(found,)h(or)e(if)h(it)227 969 y(do)r(es)28
+b(not)f(ha)n(v)n(e)g(an)g(asso)r(ciated)f(v)-5 b(alue,)28
+b(a)f(.F)-9 b(ALSE.)27 b(v)-5 b(alue)28 b(is)f(returned.)0
+1125 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_TESTFITS\()
+38 b(THIS,)k(NAME,)f(THERE,)g(STATUS)g(\))0 1281 y Fc(Argumen)m(ts:)259
+1424 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1524
+y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259 1660
y Fc(NAME)j(=)h(CHARA)m(CTER)g Fi(\003)f Fc(\()h Fi(\003)f
-Fc(\))h(\(Giv)m(en\))427 4313 y Fj(A)25 b(c)n(haracter)d(string)i(con)n
+Fc(\))h(\(Giv)m(en\))427 1760 y Fj(A)25 b(c)n(haracter)d(string)i(con)n
(taining)g(the)g(FITS)h(k)n(eyw)n(ord)e(name.)35 b(This)25
-b(ma)n(y)e(b)r(e)i(a)f(complete)h(FITS)f(header)427 4412
+b(ma)n(y)e(b)r(e)i(a)f(complete)h(FITS)f(header)427 1859
y(card,)k(in)g(whic)n(h)g(case)f(the)h(k)n(eyw)n(ord)e(to)i(use)g(is)g
(extracted)f(from)g(it.)39 b(No)28 b(more)f(than)h(80)f(c)n(haracters)f
-(are)427 4512 y(read)h(from)g(this)h(string.)259 4645
-y Fc(THERE)j(=)h(LOGICAL)h(\(Returned\))427 4745 y Fj(A)h(v)-5
+(are)427 1959 y(read)h(from)g(this)h(string.)259 2095
+y Fc(THERE)j(=)h(LOGICAL)h(\(Returned\))427 2195 y Fj(A)h(v)-5
b(alue)33 b(of)h(.TR)n(UE.)f(will)h(b)r(e)g(returned)f(if)h(the)g(k)n
(eyw)n(ord)d(w)n(as)i(found)h(in)f(the)h(header,)g(and)g(.F)-9
-b(ALSE.)427 4845 y(otherwise.)35 b(This)24 b(parameter)e(allo)n(ws)h(a)
+b(ALSE.)427 2294 y(otherwise.)35 b(This)24 b(parameter)e(allo)n(ws)h(a)
h(distinction)g(to)g(b)r(e)g(made)g(b)r(et)n(w)n(een)g(the)g(case)f
-(where)h(a)f(k)n(eyw)n(ord)427 4944 y(is)28 b(not)f(presen)n(t,)g(and)h
+(where)h(a)f(k)n(eyw)n(ord)427 2394 y(is)28 b(not)f(presen)n(t,)g(and)h
(the)g(case)f(where)g(a)g(k)n(eyw)n(ord)e(is)j(presen)n(t)f(but)h(has)f
-(no)h(asso)r(ciated)e(v)-5 b(alue.)259 5078 y Fc(ST)d(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 5177
-y Fj(The)c(global)e(status.)0 5340 y Fc(Returned)32 b(V)-8
-b(alue:)259 5478 y(AST)p Ft(_)p Fc(TESTFITS)33 b(=)g(LOGICAL)427
-5577 y Fj(A)28 b(v)-5 b(alue)27 b(of)g(zero)f(.F)-9 b(ALSE.)28
+(no)h(asso)r(ciated)e(v)-5 b(alue.)259 2530 y Fc(ST)d(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 2630
+y Fj(The)c(global)e(status.)0 2798 y Fc(Returned)32 b(V)-8
+b(alue:)259 2942 y(AST)p Ft(_)p Fc(TESTFITS)33 b(=)g(LOGICAL)427
+3041 y Fj(A)28 b(v)-5 b(alue)27 b(of)g(zero)f(.F)-9 b(ALSE.)28
b(is)f(returned)g(if)g(the)h(k)n(eyw)n(ord)d(w)n(as)i(not)g(found)g(in)
-h(the)f(FitsChan)h(or)e(has)h(no)427 5677 y(asso)r(ciated)g(v)-5
+h(the)f(FitsChan)h(or)e(has)h(no)427 3141 y(asso)r(ciated)g(v)-5
b(alue.)36 b(Otherwise,)27 b(a)g(v)-5 b(alue)28 b(of)f(.TR)n(UE.)h(is)f
-(returned.)p eop end
-%%Page: 385 395
-TeXDict begin 385 394 bop 3643 52 a FG(385)0 351 y Fc(Notes:)340
-626 y Fi(\017)45 b Fj(The)28 b(curren)n(t)f(card)f(is)i(left)g(unc)n
-(hanged)f(b)n(y)g(this)h(function.)340 752 y Fi(\017)45
-b Fj(The)27 b(card)e(follo)n(wing)h(the)h(curren)n(t)e(card)h(is)g(c)n
-(hec)n(k)n(ed)f(\014rst.)37 b(If)27 b(this)f(is)h(not)f(the)h(required)
-e(card,)h(then)h(the)427 852 y(rest)21 b(of)h(the)g(FitsChan)g(is)f
-(searc)n(hed,)h(starting)e(with)j(the)f(\014rst)f(card)g(added)g(to)h
-(the)g(FitsChan.)35 b(Therefore)427 951 y(cards)24 b(should)g(b)r(e)h
-(accessed)e(in)i(the)g(order)e(they)i(are)f(stored)f(in)i(the)g
-(FitsChan)g(\(if)g(p)r(ossible\))g(as)f(this)g(will)427
-1051 y(minimise)k(the)g(time)g(sp)r(en)n(t)g(searc)n(hing)e(for)h
-(cards.)340 1176 y Fi(\017)45 b Fj(An)28 b(error)e(will)i(b)r(e)g(rep)r
-(orted)f(if)h(the)g(k)n(eyw)n(ord)d(name)j(do)r(es)f(not)h(conform)e
-(to)i(FITS)g(requiremen)n(ts.)340 1302 y Fi(\017)45 b
-Fj(.F)-9 b(ALSE.)26 b(is)g(returned)g(as)f(the)i(function)f(v)-5
-b(alue)26 b(if)h(an)f(error)e(has)h(already)g(o)r(ccurred,)g(or)g(if)i
-(this)f(function)427 1402 y(should)i(fail)f(for)g(an)n(y)g(reason.)p
-0 1586 3780 12 v 0 1717 a FA(AST)p Fe(_)p FA(TEXT)1150
-1718 y Fd(Dra)m(w)37 b(a)i(text)f(string)f(for)h(a)h(Plot)3071
-1717 y FA(AST)p Fe(_)p FA(TEXT)0 1892 y Fc(Description:)44
+(returned.)0 3309 y Fc(Notes:)340 3599 y Fi(\017)45 b
+Fj(The)28 b(curren)n(t)f(card)f(is)i(left)g(unc)n(hanged)f(b)n(y)g
+(this)h(function.)340 3735 y Fi(\017)45 b Fj(The)27 b(card)e(follo)n
+(wing)h(the)h(curren)n(t)e(card)h(is)g(c)n(hec)n(k)n(ed)f(\014rst.)37
+b(If)27 b(this)f(is)h(not)f(the)h(required)e(card,)h(then)h(the)427
+3834 y(rest)21 b(of)h(the)g(FitsChan)g(is)f(searc)n(hed,)h(starting)e
+(with)j(the)f(\014rst)f(card)g(added)g(to)h(the)g(FitsChan.)35
+b(Therefore)427 3934 y(cards)24 b(should)g(b)r(e)h(accessed)e(in)i(the)
+g(order)e(they)i(are)f(stored)f(in)i(the)g(FitsChan)g(\(if)g(p)r
+(ossible\))g(as)f(this)g(will)427 4034 y(minimise)k(the)g(time)g(sp)r
+(en)n(t)g(searc)n(hing)e(for)h(cards.)340 4170 y Fi(\017)45
+b Fj(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)h(the)g(k)n(eyw)n
+(ord)d(name)j(do)r(es)f(not)h(conform)e(to)i(FITS)g(requiremen)n(ts.)
+340 4306 y Fi(\017)45 b Fj(.F)-9 b(ALSE.)26 b(is)g(returned)g(as)f(the)
+i(function)f(v)-5 b(alue)26 b(if)h(an)f(error)e(has)h(already)g(o)r
+(ccurred,)g(or)g(if)i(this)f(function)427 4406 y(should)i(fail)f(for)g
+(an)n(y)g(reason.)p 0 4612 V 0 4742 a FA(AST)p Fe(_)p
+FA(TEXT)1150 4743 y Fd(Dra)m(w)37 b(a)i(text)f(string)f(for)h(a)h(Plot)
+3071 4742 y FA(AST)p Fe(_)p FA(TEXT)0 4939 y Fc(Description:)44
b Fj(This)38 b(function)g(dra)n(ws)e(a)i(string)f(of)g(text)h(at)g(a)f
(p)r(osition)g(sp)r(eci\014ed)h(in)g(the)g(ph)n(ysical)f(co)r(ordinate)
-227 1992 y(system)e(of)h(a)e(Plot.)60 b(The)35 b(ph)n(ysical)f(p)r
+227 5038 y(system)e(of)h(a)e(Plot.)60 b(The)35 b(ph)n(ysical)f(p)r
(osition)i(is)f(transformed)f(in)n(to)h(graphical)f(co)r(ordinates)f
-(to)j(determine)227 2091 y(where)27 b(the)h(text)g(should)g(app)r(ear)e
-(within)j(the)f(plotting)f(area.)0 2233 y Fc(In)m(v)m(o)s(cation:)123
+(to)j(determine)227 5138 y(where)27 b(the)h(text)g(should)g(app)r(ear)e
+(within)j(the)f(plotting)f(area.)0 5294 y Fc(In)m(v)m(o)s(cation:)123
b Ft(CALL)42 b(AST_TEXT\()e(THIS,)h(TEXT,)h(POS,)g(UP,)g(JUST,)f
-(STATUS)g(\))0 2376 y Fc(Argumen)m(ts:)259 2505 y(THIS)32
-b(=)g(INTEGER)g(\(Giv)m(en\))427 2604 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(Plot.)259 2730 y Fc(TEXT)33 b(=)f(CHARA)m(CTER)f
-Fi(\003)h Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-2829 y Fj(A)c(c)n(haracter)e(string)h(con)n(taining)f(the)i(text)g(to)g
+(STATUS)g(\))0 5450 y Fc(Argumen)m(ts:)259 5593 y(THIS)32
+b(=)g(INTEGER)g(\(Giv)m(en\))427 5693 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(Plot.)p eop end
+%%Page: 388 398
+TeXDict begin 388 397 bop 0 52 a FG(388)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(TEXT)i(=)f(CHARA)m
+(CTER)f Fi(\003)h Fc(\()g Fi(\003)f Fc(\))h(\(Giv)m(en\))427
+451 y Fj(A)c(c)n(haracter)e(string)h(con)n(taining)f(the)i(text)g(to)g
(b)r(e)g(dra)n(wn.)36 b(T)-7 b(railing)26 b(white)i(space)f(is)g
-(ignored.)259 2955 y Fc(POS\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h
-(PRECISION)e(\(Giv)m(en\))427 3055 y Fj(An)g(arra)n(y)-7
+(ignored.)259 580 y Fc(POS\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h
+(PRECISION)e(\(Giv)m(en\))427 679 y Fj(An)g(arra)n(y)-7
b(,)30 b(with)h(one)f(elemen)n(t)h(for)f(eac)n(h)g(axis)g(of)h(the)g
(Plot,)g(giving)e(the)j(ph)n(ysical)d(co)r(ordinates)h(of)g(the)427
-3154 y(p)r(oin)n(t)e(where)f(the)h(reference)f(p)r(osition)g(of)h(the)g
-(text)g(string)f(is)g(to)h(b)r(e)g(placed.)259 3280 y
+779 y(p)r(oin)n(t)e(where)f(the)h(reference)f(p)r(osition)g(of)h(the)g
+(text)g(string)f(is)g(to)h(b)r(e)g(placed.)259 908 y
Fc(UP\()33 b Fi(\003)e Fc(\))h(=)g(REAL)g(\(Giv)m(en\))427
-3379 y Fj(An)e(arra)n(y)d(holding)i(the)g(comp)r(onen)n(ts)g(of)g(a)g
+1007 y Fj(An)e(arra)n(y)d(holding)i(the)g(comp)r(onen)n(ts)g(of)g(a)g
(v)n(ector)f(in)h(the)h Ft(")p Fj(up)p Ft(")e Fj(direction)h(of)g(the)h
-(text)f(\(in)h(graphical)427 3479 y(co)r(ordinates\).)35
+(text)f(\(in)h(graphical)427 1107 y(co)r(ordinates\).)35
b(F)-7 b(or)24 b(example,)g(to)h(get)f(horizon)n(tal)f(text,)i(the)g(v)
n(ector)e([0.0,1.0])g(should)h(b)r(e)h(supplied.)36 b(F)-7
-b(or)427 3579 y(a)26 b(basic)f(Plot,)g(2)h(v)-5 b(alues)25
+b(or)427 1207 y(a)26 b(basic)f(Plot,)g(2)h(v)-5 b(alues)25
b(should)h(b)r(e)g(supplied.)36 b(F)-7 b(or)25 b(a)h(Plot3D,)f(3)g(v)-5
b(alues)26 b(should)f(b)r(e)h(supplied,)h(and)e(the)427
-3678 y(actual)g(up)g(v)n(ector)f(used)g(is)h(the)h(pro)5
+1306 y(actual)g(up)g(v)n(ector)f(used)g(is)h(the)h(pro)5
b(jection)24 b(of)g(the)i(supplied)f(up)g(v)n(ector)f(on)n(to)g(the)h
-(text)h(plane)e(sp)r(eci\014ed)427 3778 y(b)n(y)k(the)g(curren)n(t)e(v)
+(text)h(plane)e(sp)r(eci\014ed)427 1406 y(b)n(y)k(the)g(curren)n(t)e(v)
-5 b(alue)28 b(of)f(the)h(Plot3D's)f(Norm)g(attribute.)259
-3903 y Fc(JUST)33 b(=)f(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 4003 y Fj(A)22 b(c)n(haracter)d
+1535 y Fc(JUST)33 b(=)f(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1634 y Fj(A)22 b(c)n(haracter)d
(string)i(iden)n(tifying)g(the)h(reference)e(p)r(oin)n(t)h(for)g(the)h
(text)f(b)r(eing)h(dra)n(wn.)33 b(The)22 b(\014rst)f(c)n(haracter)427
-4103 y(in)h(this)f(string)g(iden)n(ti\014es)g(the)h(reference)f(p)r
+1734 y(in)h(this)f(string)g(iden)n(ti\014es)g(the)h(reference)f(p)r
(osition)g(in)g(the)h Ft(")p Fj(up)p Ft(")f Fj(direction)g(and)g(ma)n
(y)f(b)r(e)i Ft(")p Fj(B)p Ft(")e Fj(\(baseline\),)427
-4202 y Ft(")p Fj(C)p Ft(")32 b Fj(\(cen)n(tre\),)i Ft(")p
+1834 y Ft(")p Fj(C)p Ft(")32 b Fj(\(cen)n(tre\),)i Ft(")p
Fj(T)p Ft(")e Fj(\(top\))i(or)e Ft(")p Fj(M)p Ft(")g
Fj(\(b)r(ottom\).)53 b(The)33 b(second)f(c)n(haracter)f(iden)n
-(ti\014es)i(the)g(side-to-side)427 4302 y(reference)e(p)r(osition)h
+(ti\014es)i(the)g(side-to-side)427 1933 y(reference)e(p)r(osition)h
(and)g(ma)n(y)f(b)r(e)h Ft(")p Fj(L)p Ft(")f Fj(\(left\),)j
Ft(")p Fj(C)p Ft(")d Fj(\(cen)n(tre\))h(or)f Ft(")p Fj(R)p
Ft(")g Fj(\(righ)n(t)h(\).)50 b(The)32 b(string)f(is)h(case-)427
-4401 y(insensitiv)n(e,)c(and)f(only)g(the)h(\014rst)f(t)n(w)n(o)g(c)n
-(haracters)f(are)g(signi\014can)n(t.)427 4514 y(F)-7
+2033 y(insensitiv)n(e,)c(and)f(only)g(the)h(\014rst)f(t)n(w)n(o)g(c)n
+(haracters)f(are)g(signi\014can)n(t.)427 2147 y(F)-7
b(or)35 b(example,)i(a)d(v)-5 b(alue)35 b(of)g Ft(")p
Fj(BL)p Ft(")g Fj(means)f(that)i(the)f(left)h(end)g(of)f(the)g
-(baseline)g(of)g(the)h(original)d(\(un-)427 4614 y(rotated\))27
+(baseline)g(of)g(the)h(original)d(\(un-)427 2247 y(rotated\))27
b(text)h(is)g(to)f(b)r(e)h(dra)n(wn)f(at)g(the)h(p)r(osition)g(giv)n
-(en)f(b)n(y)g(POS.)259 4739 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f
-(\(Giv)m(en)h(and)g(Returned\))427 4839 y Fj(The)c(global)e(status.)0
-4993 y Fc(Notes:)340 5269 y Fi(\017)45 b Fj(The)34 b(Plot3D)e(class)g
+(en)f(b)n(y)g(POS.)259 2376 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f
+(\(Giv)m(en)h(and)g(Returned\))427 2475 y Fj(The)c(global)e(status.)0
+2633 y Fc(Notes:)340 2912 y Fi(\017)45 b Fj(The)34 b(Plot3D)e(class)g
(curren)n(tly)h(do)r(es)g(not)g(in)n(terpret)g(graphical)e(escap)r(e)i
-(sequences)f(con)n(tained)h(within)427 5368 y(text)28
-b(displa)n(y)n(ed)f(using)g(this)h(metho)r(d.)340 5494
+(sequences)f(con)n(tained)h(within)427 3011 y(text)28
+b(displa)n(y)n(ed)f(using)g(this)h(metho)r(d.)340 3140
y Fi(\017)45 b Fj(T)-7 b(ext)27 b(is)f(not)g(dra)n(wn)f(at)h(p)r
(ositions)g(whic)n(h)g(ha)n(v)n(e)f(an)n(y)g(co)r(ordinate)h(equal)f
(to)h(the)h(v)-5 b(alue)26 b(AST)p Ft(__)p Fj(BAD)g(\(or)427
-5593 y(where)k(the)g(transformation)f(in)n(to)h(graphical)f(co)r
+3240 y(where)k(the)g(transformation)f(in)n(to)h(graphical)f(co)r
(ordinates)f(yields)i(co)r(ordinates)f(con)n(taining)g(the)i(v)-5
-b(alue)427 5693 y(AST)p Ft(__)p Fj(BAD\).)p eop end
-%%Page: 386 396
-TeXDict begin 386 395 bop 0 52 a FG(386)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
-b Fj(If)28 b(the)g(plotting)g(p)r(osition)f(is)h(clipp)r(ed)g(\(see)g
-(AST)p Ft(_)p Fj(CLIP\),)f(then)h(no)f(text)h(is)g(dra)n(wn.)340
-496 y Fi(\017)45 b Fj(An)40 b(error)d(results)i(if)g(the)h(base)e(F)-7
-b(rame)39 b(of)g(the)g(Plot)g(is)g(not)g(2-dimensional)f(or)g(\(for)h
-(a)g(Plot3D\))f(3-)427 595 y(dimensional.)340 740 y Fi(\017)45
-b Fj(An)30 b(error)d(also)g(results)i(if)g(the)g(transformation)f(b)r
-(et)n(w)n(een)h(the)g(curren)n(t)f(and)h(base)f(F)-7
-b(rames)28 b(of)h(the)g(Plot)427 839 y(is)f(not)f(de\014ned)h(\(i.e.)38
-b(the)28 b(Plot's)e(T)-7 b(ranIn)n(v)n(erse)26 b(attribute)h(is)h
-(zero\).)p 0 1062 3780 12 v 0 1192 a FA(AST)p Fe(_)p
-FA(TIMEADD)1311 1193 y Fd(Add)39 b(a)f(time)g(co)s(ordinate)1236
-1293 y(con)m(v)m(ersion)f(to)h(a)g(TimeMap)2781 1192
-y FA(AST)p Fe(_)p FA(TIMEADD)0 1505 y Fc(Description:)44
+b(alue)427 3339 y(AST)p Ft(__)p Fj(BAD\).)340 3468 y
+Fi(\017)45 b Fj(If)28 b(the)g(plotting)g(p)r(osition)f(is)h(clipp)r(ed)
+g(\(see)g(AST)p Ft(_)p Fj(CLIP\),)f(then)h(no)f(text)h(is)g(dra)n(wn.)
+340 3597 y Fi(\017)45 b Fj(An)40 b(error)d(results)i(if)g(the)h(base)e
+(F)-7 b(rame)39 b(of)g(the)g(Plot)g(is)g(not)g(2-dimensional)f(or)g
+(\(for)h(a)g(Plot3D\))f(3-)427 3697 y(dimensional.)340
+3825 y Fi(\017)45 b Fj(An)30 b(error)d(also)g(results)i(if)g(the)g
+(transformation)f(b)r(et)n(w)n(een)h(the)g(curren)n(t)f(and)h(base)f(F)
+-7 b(rames)28 b(of)h(the)g(Plot)427 3925 y(is)f(not)f(de\014ned)h
+(\(i.e.)38 b(the)28 b(Plot's)e(T)-7 b(ranIn)n(v)n(erse)26
+b(attribute)h(is)h(zero\).)p 0 4116 3780 12 v 0 4247
+a FA(AST)p Fe(_)p FA(TIMEADD)1311 4248 y Fd(Add)39 b(a)f(time)g(co)s
+(ordinate)1236 4348 y(con)m(v)m(ersion)f(to)h(a)g(TimeMap)2781
+4247 y FA(AST)p Fe(_)p FA(TIMEADD)0 4528 y Fc(Description:)44
b Fj(This)26 b(routine)g(adds)g(one)f(of)h(the)h(standard)e(time)i(co)r
(ordinate)d(system)i(con)n(v)n(ersions)e(listed)i(b)r(elo)n(w)g(to)227
-1604 y(an)i(existing)f(TimeMap.)227 1740 y(When)h(a)f(TimeMap)g(is)g
+4628 y(an)i(existing)f(TimeMap.)227 4751 y(When)h(a)f(TimeMap)g(is)g
(\014rst)g(created)f(\(using)h(AST)p Ft(_)p Fj(TIMEMAP\),)g(it)g
(simply)g(p)r(erforms)g(a)g(unit)g(\(n)n(ull\))h(Map-)227
-1840 y(ping.)35 b(By)23 b(using)f(AST)p Ft(_)p Fj(TIMEADD)h(\(rep)r
+4850 y(ping.)35 b(By)23 b(using)f(AST)p Ft(_)p Fj(TIMEADD)h(\(rep)r
(eatedly)f(if)h(necessary\),)g(one)f(or)f(more)h(co)r(ordinate)g(con)n
-(v)n(ersion)e(steps)227 1940 y(ma)n(y)27 b(then)i(b)r(e)f(added,)g
+(v)n(ersion)e(steps)227 4950 y(ma)n(y)27 b(then)i(b)r(e)f(added,)g
(whic)n(h)g(the)g(TimeMap)g(will)g(p)r(erform)g(in)g(sequence.)37
b(This)28 b(allo)n(ws)f(m)n(ulti-step)h(con)n(v)n(er-)227
-2039 y(sions)37 b(b)r(et)n(w)n(een)g(a)g(v)-5 b(ariet)n(y)37
+5049 y(sions)37 b(b)r(et)n(w)n(een)g(a)g(v)-5 b(ariet)n(y)37
b(of)g(time)h(co)r(ordinate)e(systems)h(to)g(b)r(e)h(assem)n(bled)e
-(out)i(of)f(the)h(building)f(blo)r(c)n(ks)227 2139 y(pro)n(vided)27
-b(b)n(y)g(this)h(class.)227 2275 y(Normally)-7 b(,)27
+(out)i(of)f(the)h(building)f(blo)r(c)n(ks)227 5149 y(pro)n(vided)27
+b(b)n(y)g(this)h(class.)227 5272 y(Normally)-7 b(,)27
b(if)g(a)g(TimeMap's)g(In)n(v)n(ert)f(attribute)i(is)f(zero)f(\(the)i
(default\),)g(then)f(its)h(forw)n(ard)d(transformation)h(is)227
-2375 y(p)r(erformed)18 b(b)n(y)g(carrying)f(out)h(eac)n(h)g(of)g(the)h
+5371 y(p)r(erformed)18 b(b)n(y)g(carrying)f(out)h(eac)n(h)g(of)g(the)h
(individual)f(co)r(ordinate)f(con)n(v)n(ersions)f(sp)r(eci\014ed)j(b)n
-(y)f(AST)p Ft(_)p Fj(TIMEADD)227 2474 y(in)28 b(the)g(order)e(giv)n(en)
+(y)f(AST)p Ft(_)p Fj(TIMEADD)227 5471 y(in)28 b(the)g(order)e(giv)n(en)
h(\(i.e.)37 b(with)29 b(the)e(most)h(recen)n(tly)f(added)g(con)n(v)n
-(ersion)e(applied)j(last\).)227 2610 y(This)21 b(order)f(is)h(rev)n
+(ersion)e(applied)j(last\).)227 5593 y(This)21 b(order)f(is)h(rev)n
(ersed)e(if)i(the)h(TimeMap's)e(In)n(v)n(ert)g(attribute)h(is)g
(non-zero)f(\(or)g(if)h(the)h(in)n(v)n(erse)d(transformation)227
-2710 y(is)27 b(requested)f(b)n(y)h(an)n(y)f(other)g(means\))h(and)g
+5693 y(is)27 b(requested)f(b)n(y)h(an)n(y)f(other)g(means\))h(and)g
(eac)n(h)f(individual)h(co)r(ordinate)f(con)n(v)n(ersion)e(is)j(also)f
-(replaced)g(b)n(y)g(its)227 2809 y(o)n(wn)20 b(in)n(v)n(erse.)32
-b(This)20 b(pro)r(cess)f(in)n(v)n(erts)g(the)h(o)n(v)n(erall)e
-(e\013ect)i(of)g(the)h(TimeMap.)34 b(In)20 b(this)g(case,)h(the)f
-(\014rst)g(con)n(v)n(ersion)227 2909 y(to)28 b(b)r(e)g(applied)f(w)n
-(ould)g(b)r(e)h(the)g(in)n(v)n(erse)f(of)g(the)h(one)f(most)h(recen)n
-(tly)f(added.)0 3082 y Fc(In)m(v)m(o)s(cation:)123 b
-Ft(CALL)42 b(AST_TIMEADD\()c(THIS,)k(CVT,)g(ARGS,)f(STATUS)g(\))0
-3254 y Fc(Argumen)m(ts:)259 3413 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 3513 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(TimeMap.)259
-3657 y Fc(CVT)k(=)h(CHARA)m(CTER)e Fi(\003)g Fc(\()h
-Fi(\003)g Fc(\))g(\(Giv)m(en\))427 3757 y Fj(A)19 b(c)n(haracter)d
-(string)i(whic)n(h)g(iden)n(ti\014es)h(the)g(time)f(co)r(ordinate)g
-(con)n(v)n(ersion)e(to)i(b)r(e)h(added)f(to)g(the)h(TimeMap.)427
-3857 y(See)28 b(the)g Ft(")p Fj(Av)-5 b(ailable)27 b(Con)n(v)n(ersions)
-p Ft(")d Fj(section)k(for)f(details)g(of)h(those)f(a)n(v)-5
-b(ailable.)259 4001 y Fc(AR)m(GS\()32 b Fi(\003)g Fc(\))g(=)g(DOUBLE)g
-(PRECISION)f(\(Giv)m(en\))427 4101 y Fj(An)38 b(arra)n(y)d(con)n
+(replaced)g(b)n(y)g(its)p eop end
+%%Page: 389 399
+TeXDict begin 389 398 bop 3643 52 a FG(389)227 351 y
+Fj(o)n(wn)20 b(in)n(v)n(erse.)32 b(This)20 b(pro)r(cess)f(in)n(v)n
+(erts)g(the)h(o)n(v)n(erall)e(e\013ect)i(of)g(the)h(TimeMap.)34
+b(In)20 b(this)g(case,)h(the)f(\014rst)g(con)n(v)n(ersion)227
+451 y(to)28 b(b)r(e)g(applied)f(w)n(ould)g(b)r(e)h(the)g(in)n(v)n(erse)
+f(of)g(the)h(one)f(most)h(recen)n(tly)f(added.)0 607
+y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_TIMEADD\()c(THIS,)k
+(CVT,)g(ARGS,)f(STATUS)g(\))0 764 y Fc(Argumen)m(ts:)259
+908 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 1007 y
+Fj(P)n(oin)n(ter)26 b(to)i(the)g(TimeMap.)259 1144 y
+Fc(CVT)k(=)h(CHARA)m(CTER)e Fi(\003)g Fc(\()h Fi(\003)g
+Fc(\))g(\(Giv)m(en\))427 1243 y Fj(A)19 b(c)n(haracter)d(string)i(whic)
+n(h)g(iden)n(ti\014es)h(the)g(time)f(co)r(ordinate)g(con)n(v)n(ersion)e
+(to)i(b)r(e)h(added)f(to)g(the)h(TimeMap.)427 1343 y(See)28
+b(the)g Ft(")p Fj(Av)-5 b(ailable)27 b(Con)n(v)n(ersions)p
+Ft(")d Fj(section)k(for)f(details)g(of)h(those)f(a)n(v)-5
+b(ailable.)259 1479 y Fc(AR)m(GS\()32 b Fi(\003)g Fc(\))g(=)g(DOUBLE)g
+(PRECISION)f(\(Giv)m(en\))427 1579 y Fj(An)38 b(arra)n(y)d(con)n
(taining)h(argumen)n(t)g(v)-5 b(alues)36 b(for)h(the)g(time)h(co)r
(ordinate)e(con)n(v)n(ersion.)63 b(The)37 b(n)n(um)n(b)r(er)g(of)427
-4200 y(argumen)n(ts)22 b(required,)h(and)g(hence)g(the)g(n)n(um)n(b)r
+1679 y(argumen)n(ts)22 b(required,)h(and)g(hence)g(the)g(n)n(um)n(b)r
(er)g(of)g(arra)n(y)e(elemen)n(ts)h(used,)i(dep)r(ends)g(on)f(the)g
-(con)n(v)n(ersion)427 4300 y(sp)r(eci\014ed)i(\(see)g(the)f
+(con)n(v)n(ersion)427 1778 y(sp)r(eci\014ed)i(\(see)g(the)f
Ft(")p Fj(Av)-5 b(ailable)24 b(Con)n(v)n(ersions)p Ft(")e
Fj(section\).)36 b(This)24 b(arra)n(y)e(is)j(ignored)e(if)i(no)f
-(argumen)n(ts)g(are)427 4400 y(needed.)259 4544 y Fc(ST)-8
+(argumen)n(ts)g(are)427 1878 y(needed.)259 2014 y Fc(ST)-8
b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-4644 y Fj(The)c(global)e(status.)0 4828 y Fc(Notes:)340
-5134 y Fi(\017)45 b Fj(When)37 b(assem)n(bling)e(a)g(m)n(ulti-stage)h
+2114 y Fj(The)c(global)e(status.)0 2283 y Fc(Notes:)340
+2573 y Fi(\017)45 b Fj(When)37 b(assem)n(bling)e(a)g(m)n(ulti-stage)h
(con)n(v)n(ersion,)g(it)g(can)g(sometimes)g(b)r(e)g(di\016cult)h(to)f
-(determine)g(the)427 5234 y(most)g(economical)f(con)n(v)n(ersion)e
+(determine)g(the)427 2672 y(most)g(economical)f(con)n(v)n(ersion)e
(path.)62 b(A)36 b(solution)g(to)f(this)h(is)g(to)g(include)g(all)g
-(the)g(steps)g(whic)n(h)g(are)427 5333 y(\(logically\))d(necessary)-7
+(the)g(steps)g(whic)n(h)g(are)427 2772 y(\(logically\))d(necessary)-7
b(,)34 b(but)g(then)g(to)g(use)g(AST)p Ft(_)p Fj(SIMPLIFY)f(to)h
-(simplify)g(the)g(resulting)g(TimeMap.)427 5433 y(The)28
+(simplify)g(the)g(resulting)g(TimeMap.)427 2871 y(The)28
b(simpli\014cation)f(pro)r(cess)g(will)h(eliminate)f(an)n(y)g(steps)h
(whic)n(h)f(turn)h(out)g(not)f(to)h(b)r(e)g(needed.)340
-5577 y Fi(\017)45 b Fj(This)30 b(routine)g(do)r(es)f(not)h(c)n(hec)n(k)
+3008 y Fi(\017)45 b Fj(This)30 b(routine)g(do)r(es)f(not)h(c)n(hec)n(k)
f(to)h(ensure)f(that)h(the)h(sequence)e(of)h(co)r(ordinate)f(con)n(v)n
-(ersions)e(added)j(to)427 5677 y(a)d(TimeMap)h(is)f(ph)n(ysically)g
-(meaningful.)p eop end
-%%Page: 387 397
-TeXDict begin 387 396 bop 3643 52 a FG(387)-2 351 y Fc(Av)-5
-b(ailable)32 b(Con)m(v)m(ersions)n(:)227 497 y Fj(The)19
-b(follo)n(wing)f(strings)f(\(whic)n(h)i(are)f(case-insensitiv)n(e\))f
-(ma)n(y)h(b)r(e)h(supplied)g(via)f(the)h(CVT)g(argumen)n(t)f(to)h
-(indicate)227 597 y(whic)n(h)31 b(time)h(co)r(ordinate)e(con)n(v)n
-(ersion)f(is)i(to)g(b)r(e)g(added)g(to)g(the)g(TimeMap.)48
-b(Where)31 b(argumen)n(ts)e(are)h(needed)227 697 y(b)n(y)e(the)h(con)n
-(v)n(ersion,)d(they)j(are)e(listed)h(in)h(paren)n(theses.)38
-b(V)-7 b(alues)28 b(for)f(these)i(argumen)n(ts)e(should)h(b)r(e)g(giv)n
-(en,)g(via)227 796 y(the)33 b(AR)n(GS)f(arra)n(y)-7 b(,)31
-b(in)h(the)h(order)e(indicated.)50 b(Units)33 b(and)f(argumen)n(t)f
-(names)g(are)g(describ)r(ed)h(at)g(the)g(end)h(of)227
-896 y(the)28 b(list)g(of)g(con)n(v)n(ersions,)d(and)i
+(ersions)e(added)j(to)427 3108 y(a)d(TimeMap)h(is)f(ph)n(ysically)g
+(meaningful.)-2 3277 y Fc(Av)-5 b(ailable)32 b(Con)m(v)m(ersions)n(:)
+227 3423 y Fj(The)19 b(follo)n(wing)f(strings)f(\(whic)n(h)i(are)f
+(case-insensitiv)n(e\))f(ma)n(y)h(b)r(e)h(supplied)g(via)f(the)h(CVT)g
+(argumen)n(t)f(to)h(indicate)227 3522 y(whic)n(h)31 b(time)h(co)r
+(ordinate)e(con)n(v)n(ersion)f(is)i(to)g(b)r(e)g(added)g(to)g(the)g
+(TimeMap.)48 b(Where)31 b(argumen)n(ts)e(are)h(needed)227
+3622 y(b)n(y)e(the)h(con)n(v)n(ersion,)d(they)j(are)e(listed)h(in)h
+(paren)n(theses.)38 b(V)-7 b(alues)28 b(for)f(these)i(argumen)n(ts)e
+(should)h(b)r(e)g(giv)n(en,)g(via)227 3722 y(the)33 b(AR)n(GS)f(arra)n
+(y)-7 b(,)31 b(in)h(the)h(order)e(indicated.)50 b(Units)33
+b(and)f(argumen)n(t)f(names)g(are)g(describ)r(ed)h(at)g(the)g(end)h(of)
+227 3821 y(the)28 b(list)g(of)g(con)n(v)n(ersions,)d(and)i
Ft(")p Fj(MJD)p Ft(")g Fj(means)g(Mo)r(di\014ed)h(Julian)f(Date.)340
-1153 y Fi(\017)45 b Ft(")p Fj(MJDTOMJD)p Ft(")27 b Fj
+4093 y Fi(\017)45 b Ft(")p Fj(MJDTOMJD)p Ft(")27 b Fj
(\(MJDOFF1,MJDOFF2\):)37 b(Con)n(v)n(ert)26 b(MJD)i(from)f(one)g
-(o\013set)h(to)f(another.)340 1284 y Fi(\017)45 b Ft(")p
+(o\013set)h(to)f(another.)340 4229 y Fi(\017)45 b Ft(")p
Fj(MJDTOJD)p Ft(")27 b Fj(\(MJDOFF,JDOFF\):)h(Con)n(v)n(ert)f(MJD)h(to)
-f(Julian)g(Date.)340 1414 y Fi(\017)45 b Ft(")p Fj(JDTOMJD)p
+f(Julian)g(Date.)340 4366 y Fi(\017)45 b Ft(")p Fj(JDTOMJD)p
Ft(")27 b Fj(\(JDOFF,MJDOFF\):)h(Con)n(v)n(ert)f(Julian)g(Date)h(to)f
-(MJD.)340 1545 y Fi(\017)45 b Ft(")p Fj(MJDTOBEP)p Ft(")26
+(MJD.)340 4502 y Fi(\017)45 b Ft(")p Fj(MJDTOBEP)p Ft(")26
b Fj(\(MJDOFF,BEPOFF\):)h(Con)n(v)n(ert)f(MJD)i(to)f(Besselian)g(ep)r
-(o)r(c)n(h.)340 1676 y Fi(\017)45 b Ft(")p Fj(BEPTOMJD)p
+(o)r(c)n(h.)340 4638 y Fi(\017)45 b Ft(")p Fj(BEPTOMJD)p
Ft(")26 b Fj(\(BEPOFF,MJDOFF\):)h(Con)n(v)n(ert)f(Besselian)h(ep)r(o)r
-(c)n(h)g(to)h(MJD.)340 1806 y Fi(\017)45 b Ft(")p Fj(MJDTOJEP)p
+(c)n(h)g(to)h(MJD.)340 4775 y Fi(\017)45 b Ft(")p Fj(MJDTOJEP)p
Ft(")26 b Fj(\(MJDOFF,JEPOFF\):)h(Con)n(v)n(ert)f(MJD)i(to)f(Julian)g
-(ep)r(o)r(c)n(h.)340 1937 y Fi(\017)45 b Ft(")p Fj(JEPTOMJD)p
+(ep)r(o)r(c)n(h.)340 4911 y Fi(\017)45 b Ft(")p Fj(JEPTOMJD)p
Ft(")26 b Fj(\(JEPOFF,MJDOFF\):)h(Con)n(v)n(ert)f(Julian)h(ep)r(o)r(c)n
-(h)h(to)f(MJD.)340 2067 y Fi(\017)45 b Ft(")p Fj(T)-7
+(h)h(to)f(MJD.)340 5048 y Fi(\017)45 b Ft(")p Fj(T)-7
b(AITOUTC)p Ft(")27 b Fj(\(MJDOFF\):)i(Con)n(v)n(ert)d(a)h(T)-7
-b(AI)28 b(MJD)g(to)f(a)g(UTC)h(MJD.)340 2198 y Fi(\017)45
+b(AI)28 b(MJD)g(to)f(a)g(UTC)h(MJD.)340 5184 y Fi(\017)45
b Ft(")p Fj(UTCTOT)-7 b(AI)p Ft(")27 b Fj(\(MJDOFF\):)i(Con)n(v)n(ert)d
-(a)h(UTC)h(MJD)g(to)f(a)g(T)-7 b(AI)28 b(MJD.)340 2328
+(a)h(UTC)h(MJD)g(to)f(a)g(T)-7 b(AI)28 b(MJD.)340 5321
y Fi(\017)45 b Ft(")p Fj(T)-7 b(AITOTT)p Ft(")27 b Fj(\(MJDOFF\):)h
(Con)n(v)n(ert)e(a)i(T)-7 b(AI)28 b(MJD)g(to)f(a)g(TT)h(MJD.)340
-2459 y Fi(\017)45 b Ft(")p Fj(TTTOT)-7 b(AI)p Ft(")27
+5457 y Fi(\017)45 b Ft(")p Fj(TTTOT)-7 b(AI)p Ft(")27
b Fj(\(MJDOFF\):)h(Con)n(v)n(ert)e(a)i(TT)f(MJD)h(to)g(a)f(T)-7
-b(AI)28 b(MJD.)340 2589 y Fi(\017)45 b Ft(")p Fj(TTTOTDB)p
+b(AI)28 b(MJD.)340 5593 y Fi(\017)45 b Ft(")p Fj(TTTOTDB)p
Ft(")33 b Fj(\(MJDOFF,)i(OBSLON,)e(OBSLA)-7 b(T,)34 b(OBSAL)-7
b(T\):)34 b(Con)n(v)n(ert)f(a)g(TT)i(MJD)f(to)g(a)f(TDB)427
-2689 y(MJD.)340 2820 y Fi(\017)45 b Ft(")p Fj(TDBTOTT)p
-Ft(")33 b Fj(\(MJDOFF,)i(OBSLON,)e(OBSLA)-7 b(T,)34 b(OBSAL)-7
-b(T\):)34 b(Con)n(v)n(ert)f(a)g(TDB)i(MJD)f(to)g(a)g(TT)427
-2919 y(MJD.)340 3050 y Fi(\017)45 b Ft(")p Fj(TTTOTCG)p
+5693 y(MJD.)p eop end
+%%Page: 390 400
+TeXDict begin 390 399 bop 0 52 a FG(390)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Ft(")p Fj(TDBTOTT)p Ft(")33 b Fj(\(MJDOFF,)i(OBSLON,)e(OBSLA)-7
+b(T,)34 b(OBSAL)-7 b(T\):)34 b(Con)n(v)n(ert)f(a)g(TDB)i(MJD)f(to)g(a)g
+(TT)427 451 y(MJD.)340 592 y Fi(\017)45 b Ft(")p Fj(TTTOTCG)p
Ft(")27 b Fj(\(MJDOFF\):)h(Con)n(v)n(ert)e(a)h(TT)h(MJD)g(to)f(a)h(TCG)
-f(MJD.)340 3180 y Fi(\017)45 b Ft(")p Fj(TCGTOTT)p Ft(")27
+f(MJD.)340 734 y Fi(\017)45 b Ft(")p Fj(TCGTOTT)p Ft(")27
b Fj(\(MJDOFF\):)h(Con)n(v)n(ert)e(a)h(TCG)h(MJD)g(to)g(a)f(TT)g(MJD.)
-340 3311 y Fi(\017)45 b Ft(")p Fj(TDBTOTCB)p Ft(")27
-b Fj(\(MJDOFF\):)h(Con)n(v)n(ert)e(a)h(TDB)h(MJD)g(to)g(a)f(TCB)g(MJD.)
-340 3441 y Fi(\017)45 b Ft(")p Fj(TCBTOTDB)p Ft(")27
+340 875 y Fi(\017)45 b Ft(")p Fj(TDBTOTCB)p Ft(")27 b
+Fj(\(MJDOFF\):)h(Con)n(v)n(ert)e(a)h(TDB)h(MJD)g(to)g(a)f(TCB)g(MJD.)
+340 1016 y Fi(\017)45 b Ft(")p Fj(TCBTOTDB)p Ft(")27
b Fj(\(MJDOFF\):)h(Con)n(v)n(ert)e(a)h(TCB)h(MJD)g(to)f(a)g(TDB)h(MJD.)
-340 3572 y Fi(\017)45 b Ft(")p Fj(UTTOGMST)p Ft(")27
+340 1158 y Fi(\017)45 b Ft(")p Fj(UTTOGMST)p Ft(")27
b Fj(\(MJDOFF\):)i(Con)n(v)n(ert)d(a)h(UT)h(MJD)g(to)f(a)g(GMST)h(MJD.)
-340 3702 y Fi(\017)45 b Ft(")p Fj(GMSTTOUT)p Ft(")27
+340 1299 y Fi(\017)45 b Ft(")p Fj(GMSTTOUT)p Ft(")27
b Fj(\(MJDOFF\):)i(Con)n(v)n(ert)d(a)h(GMST)h(MJD)g(to)f(a)h(UT)f(MJD.)
-340 3833 y Fi(\017)45 b Ft(")p Fj(GMSTTOLMST)p Ft(")37
+340 1441 y Fi(\017)45 b Ft(")p Fj(GMSTTOLMST)p Ft(")37
b Fj(\(MJDOFF,)h(OBSLON,)f(OBSLA)-7 b(T\):)38 b(Con)n(v)n(ert)e(a)h
-(GMST)h(MJD)g(to)f(a)g(LMST)427 3933 y(MJD.)340 4063
+(GMST)h(MJD)g(to)f(a)g(LMST)427 1540 y(MJD.)340 1682
y Fi(\017)45 b Ft(")p Fj(LMSTTOGMST)p Ft(")37 b Fj(\(MJDOFF,)h(OBSLON,)
f(OBSLA)-7 b(T\):)38 b(Con)n(v)n(ert)e(a)h(LMST)h(MJD)g(to)f(a)g(GMST)
-427 4163 y(MJD.)340 4293 y Fi(\017)45 b Ft(")p Fj(LASTTOLMST)p
+427 1781 y(MJD.)340 1923 y Fi(\017)45 b Ft(")p Fj(LASTTOLMST)p
Ft(")40 b Fj(\(MJDOFF,)g(OBSLON,)g(OBSLA)-7 b(T\):)41
b(Con)n(v)n(ert)d(a)i(GMST)h(MJD)f(to)h(a)e(LMST)427
-4393 y(MJD.)340 4524 y Fi(\017)45 b Ft(")p Fj(LMSTTOLAST)p
+2022 y(MJD.)340 2164 y Fi(\017)45 b Ft(")p Fj(LMSTTOLAST)p
Ft(")40 b Fj(\(MJDOFF,)g(OBSLON,)g(OBSLA)-7 b(T\):)41
b(Con)n(v)n(ert)d(a)i(LMST)h(MJD)f(to)g(a)g(GMST)427
-4623 y(MJD.)340 4754 y Fi(\017)45 b Ft(")p Fj(UTTOUTC)p
+2263 y(MJD.)340 2405 y Fi(\017)45 b Ft(")p Fj(UTTOUTC)p
Ft(")27 b Fj(\(DUT1\):)38 b(Con)n(v)n(ert)26 b(a)h(UT1)h(MJD)f(to)h(a)f
-(UTC)h(MJD.)340 4884 y Fi(\017)45 b Ft(")p Fj(UTCTOUT)p
+(UTC)h(MJD.)340 2546 y Fi(\017)45 b Ft(")p Fj(UTCTOUT)p
Ft(")27 b Fj(\(DUT1\):)38 b(Con)n(v)n(ert)26 b(a)h(UTC)h(MJD)g(to)f(a)g
-(UT1)h(MJD.)340 5015 y Fi(\017)45 b Ft(")p Fj(L)-7 b(TTOUTC)p
+(UT1)h(MJD.)340 2687 y Fi(\017)45 b Ft(")p Fj(L)-7 b(TTOUTC)p
Ft(")27 b Fj(\(L)-7 b(TOFF\):)28 b(Con)n(v)n(ert)e(a)h(Lo)r(cal)g(Time)
-h(MJD)g(to)f(a)g(UTC)h(MJD.)340 5145 y Fi(\017)45 b Ft(")p
+h(MJD)g(to)f(a)g(UTC)h(MJD.)340 2829 y Fi(\017)45 b Ft(")p
Fj(UTCTOL)-7 b(T)p Ft(")27 b Fj(\(L)-7 b(TOFF\):)28 b(Con)n(v)n(ert)e
(a)h(UTC)h(MJD)g(to)g(a)f(Lo)r(cal)g(Time)g(MJD.)227
-5305 y(The)h(units)g(for)f(the)h(v)-5 b(alues)27 b(pro)r(cessed)g(b)n
+3008 y(The)h(units)g(for)f(the)h(v)-5 b(alues)27 b(pro)r(cessed)g(b)n
(y)g(the)h(ab)r(o)n(v)n(e)e(con)n(v)n(ersions)f(are)i(as)g(follo)n(ws:)
-340 5562 y Fi(\017)45 b Fj(Julian)27 b(ep)r(o)r(c)n(hs)h(and)f
-(o\013sets:)37 b(Julian)27 b(y)n(ears)340 5693 y Fi(\017)45
+340 3294 y Fi(\017)45 b Fj(Julian)27 b(ep)r(o)r(c)n(hs)h(and)f
+(o\013sets:)37 b(Julian)27 b(y)n(ears)340 3436 y Fi(\017)45
b Fj(Besselian)27 b(ep)r(o)r(c)n(hs)g(and)h(o\013sets:)36
-b(T)-7 b(ropical)27 b(y)n(ears)p eop end
-%%Page: 388 398
-TeXDict begin 388 397 bop 0 52 a FG(388)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b(T)-7 b(ropical)27 b(y)n(ears)340 3577 y Fi(\017)45
b Fj(Mo)r(di\014ed)28 b(Julian)f(Dates)h(and)f(o\013sets:)37
-b(da)n(ys)340 480 y Fi(\017)45 b Fj(Julian)27 b(Dates)h(and)f
-(o\013sets:)37 b(da)n(ys)227 639 y(The)25 b(argumen)n(ts)f(used)g(in)i
+b(da)n(ys)340 3718 y Fi(\017)45 b Fj(Julian)27 b(Dates)h(and)f
+(o\013sets:)37 b(da)n(ys)227 3897 y(The)25 b(argumen)n(ts)f(used)g(in)i
(the)f(ab)r(o)n(v)n(e)e(con)n(v)n(ersions)f(are)i(the)h(zero-p)r(oin)n
(ts)f(used)g(b)n(y)h(the)g(AST)p Ft(_)p Fj(TRANSF)n(ORM)227
-738 y(routine.)35 b(The)23 b(axis)f(v)-5 b(alues)22 b(supplied)i(and)e
-(returned)g(b)n(y)h(AST)p Ft(_)p Fj(TRANSF)n(ORM)g(are)f(o\013sets)g(a)
-n(w)n(a)n(y)f(from)i(these)227 838 y(zero-p)r(oin)n(ts:)340
-1093 y Fi(\017)45 b Fj(MJDOFF:)28 b(The)g(zero-p)r(oin)n(t)e(b)r(eing)i
-(used)f(with)h(MJD)g(v)-5 b(alues.)340 1222 y Fi(\017)45
-b Fj(JDOFF:)28 b(The)g(zero-p)r(oin)n(t)e(b)r(eing)i(used)f(with)h
-(Julian)g(Date)f(v)-5 b(alues.)340 1351 y Fi(\017)45
-b Fj(BEPOFF:)27 b(The)g(zero-p)r(oin)n(t)g(b)r(eing)g(used)h(with)g
-(Besselian)f(ep)r(o)r(c)n(h)g(v)-5 b(alues.)340 1480
-y Fi(\017)45 b Fj(JEPOFF:)27 b(The)g(zero-p)r(oin)n(t)g(b)r(eing)g
+3997 y(routine.)35 b(The)23 b(axis)f(v)-5 b(alues)22
+b(supplied)i(and)e(returned)g(b)n(y)h(AST)p Ft(_)p Fj(TRANSF)n(ORM)g
+(are)f(o\013sets)g(a)n(w)n(a)n(y)f(from)i(these)227 4097
+y(zero-p)r(oin)n(ts:)340 4383 y Fi(\017)45 b Fj(MJDOFF:)28
+b(The)g(zero-p)r(oin)n(t)e(b)r(eing)i(used)f(with)h(MJD)g(v)-5
+b(alues.)340 4525 y Fi(\017)45 b Fj(JDOFF:)28 b(The)g(zero-p)r(oin)n(t)
+e(b)r(eing)i(used)f(with)h(Julian)g(Date)f(v)-5 b(alues.)340
+4666 y Fi(\017)45 b Fj(BEPOFF:)27 b(The)g(zero-p)r(oin)n(t)g(b)r(eing)g
+(used)h(with)g(Besselian)f(ep)r(o)r(c)n(h)g(v)-5 b(alues.)340
+4807 y Fi(\017)45 b Fj(JEPOFF:)27 b(The)g(zero-p)r(oin)n(t)g(b)r(eing)g
(used)h(with)g(Julian)f(ep)r(o)r(c)n(h)h(v)-5 b(alues.)340
-1609 y Fi(\017)45 b Fj(OBSLON:)27 b(Observ)n(er)f(longitude)h(in)h
-(radians)e(\(+v)n(e)h(w)n(est)n(w)n(ards\).)340 1739
+4949 y Fi(\017)45 b Fj(OBSLON:)27 b(Observ)n(er)f(longitude)h(in)h
+(radians)e(\(+v)n(e)h(w)n(est)n(w)n(ards\).)340 5090
y Fi(\017)45 b Fj(OBSLA)-7 b(T:)28 b(Observ)n(er)d(geo)r(detic)i
(latitude)h(\(IA)n(U)h(1975\))d(in)h(radians)g(\(+v)n(e)g(north)n(w)n
-(ards\).)340 1868 y Fi(\017)45 b Fj(OBSAL)-7 b(T:)28
+(ards\).)340 5232 y Fi(\017)45 b Fj(OBSAL)-7 b(T:)28
b(Observ)n(er)d(geo)r(detic)i(altitude)h(\(IA)n(U)h(1975\))d(in)h
-(metres.)340 1997 y Fi(\017)45 b Fj(DUT1:)37 b(The)28
-b(UT1-UTC)f(v)-5 b(alue)28 b(to)f(use.)340 2126 y Fi(\017)45
+(metres.)340 5373 y Fi(\017)45 b Fj(DUT1:)37 b(The)28
+b(UT1-UTC)f(v)-5 b(alue)28 b(to)f(use.)340 5514 y Fi(\017)45
b Fj(L)-7 b(TOFF:)30 b(The)h(o\013set)f(b)r(et)n(w)n(een)g(Lo)r(cal)f
(Time)h(and)g(UTC)g(\(in)h(hours,)f(p)r(ositiv)n(e)g(for)f(time)i
-(zones)e(east)h(of)427 2225 y(Green)n(wic)n(h\).)p 0
-2417 3780 12 v 0 2548 a FA(AST)p Fe(_)p FA(TIMEFRAME)163
-b Fd(Create)37 b(a)i(TimeF)-10 b(rame)163 b FA(AST)p
-Fe(_)p FA(TIMEFRAME)0 2717 y Fc(Description:)44 b Fj(This)28
-b(function)g(creates)f(a)g(new)g(TimeF)-7 b(rame)28 b(and)f(optionally)
-g(initialises)g(its)h(attributes.)227 2840 y(A)h(TimeF)-7
-b(rame)28 b(is)g(a)g(sp)r(ecialised)f(form)h(of)g(one-dimensional)f(F)
--7 b(rame)28 b(whic)n(h)g(represen)n(ts)f(v)-5 b(arious)27
-b(co)r(ordinate)227 2939 y(systems)g(used)h(to)f(describ)r(e)h(p)r
-(ositions)f(in)h(time.)227 3062 y(A)23 b(TimeF)-7 b(rame)21
-b(represen)n(ts)g(a)g(momen)n(t)h(in)g(time)h(as)e(either)h(an)f(Mo)r
-(di\014ed)i(Julian)e(Date)h(\(MJD\),)h(a)f(Julian)f(Date)227
-3162 y(\(JD\),)f(a)f(Besselian)e(ep)r(o)r(c)n(h)i(or)f(a)h(Julian)g(ep)
-r(o)r(c)n(h,)h(as)f(determined)g(b)n(y)f(the)i(System)f(attribute.)34
-b(Optionally)-7 b(,)20 b(a)f(zero)227 3261 y(p)r(oin)n(t)30
-b(can)g(b)r(e)g(sp)r(eci\014ed)h(\(using)e(attribute)i(TimeOrigin\))e
-(whic)n(h)h(results)f(in)h(the)h(TimeF)-7 b(rame)29 b(represen)n(ting)
-227 3361 y(time)f(o\013sets)g(from)f(the)h(sp)r(eci\014ed)g(zero)e(p)r
-(oin)n(t.)227 3484 y(Ev)n(en)g(though)g(JD)g(and)g(MJD)g(are)g
-(de\014ned)g(as)g(b)r(eing)g(in)g(units)h(of)f(da)n(ys,)g(the)g(TimeF)
--7 b(rame)26 b(class)f(allo)n(ws)g(other)227 3583 y(units)31
-b(to)g(b)r(e)g(used)f(\(via)h(the)g(Unit)g(attribute\))g(on)f(the)h
-(basis)f(of)h(simple)g(scalings)e(\(60)h(seconds)g(=)g(1)g(min)n(ute,)
-227 3683 y(60)i(min)n(utes)h(=)f(1)h(hour,)g(24)f(hours)g(=)g(1)g(da)n
-(y)-7 b(,)33 b(365.25)e(da)n(ys)h(=)g(1)g(y)n(ear\).)51
+(zones)e(east)h(of)427 5614 y(Green)n(wic)n(h\).)p eop
+end
+%%Page: 391 401
+TeXDict begin 391 400 bop 3643 52 a FG(391)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(TIMEFRAME)163 b Fd(Create)37
+b(a)i(TimeF)-10 b(rame)163 b FA(AST)p Fe(_)p FA(TIMEFRAME)0
+710 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+(TimeF)-7 b(rame)28 b(and)f(optionally)g(initialises)g(its)h
+(attributes.)227 859 y(A)h(TimeF)-7 b(rame)28 b(is)g(a)g(sp)r
+(ecialised)f(form)h(of)g(one-dimensional)f(F)-7 b(rame)28
+b(whic)n(h)g(represen)n(ts)f(v)-5 b(arious)27 b(co)r(ordinate)227
+959 y(systems)g(used)h(to)f(describ)r(e)h(p)r(ositions)f(in)h(time.)227
+1109 y(A)23 b(TimeF)-7 b(rame)21 b(represen)n(ts)g(a)g(momen)n(t)h(in)g
+(time)h(as)e(either)h(an)f(Mo)r(di\014ed)i(Julian)e(Date)h(\(MJD\),)h
+(a)f(Julian)f(Date)227 1209 y(\(JD\),)f(a)f(Besselian)e(ep)r(o)r(c)n(h)
+i(or)f(a)h(Julian)g(ep)r(o)r(c)n(h,)h(as)f(determined)g(b)n(y)f(the)i
+(System)f(attribute.)34 b(Optionally)-7 b(,)20 b(a)f(zero)227
+1308 y(p)r(oin)n(t)30 b(can)g(b)r(e)g(sp)r(eci\014ed)h(\(using)e
+(attribute)i(TimeOrigin\))e(whic)n(h)h(results)f(in)h(the)h(TimeF)-7
+b(rame)29 b(represen)n(ting)227 1408 y(time)f(o\013sets)g(from)f(the)h
+(sp)r(eci\014ed)g(zero)e(p)r(oin)n(t.)227 1558 y(Ev)n(en)g(though)g(JD)
+g(and)g(MJD)g(are)g(de\014ned)g(as)g(b)r(eing)g(in)g(units)h(of)f(da)n
+(ys,)g(the)g(TimeF)-7 b(rame)26 b(class)f(allo)n(ws)g(other)227
+1658 y(units)31 b(to)g(b)r(e)g(used)f(\(via)h(the)g(Unit)g(attribute\))
+g(on)f(the)h(basis)f(of)h(simple)g(scalings)e(\(60)h(seconds)g(=)g(1)g
+(min)n(ute,)227 1757 y(60)i(min)n(utes)h(=)f(1)h(hour,)g(24)f(hours)g
+(=)g(1)g(da)n(y)-7 b(,)33 b(365.25)e(da)n(ys)h(=)g(1)g(y)n(ear\).)51
b(Lik)n(ewise,)33 b(Julian)g(ep)r(o)r(c)n(hs)f(can)g(b)r(e)227
-3782 y(describ)r(ed)f(in)f(units)h(other)f(than)h(the)g(usual)f(y)n
+1857 y(describ)r(ed)f(in)f(units)h(other)f(than)h(the)g(usual)f(y)n
(ears.)44 b(Besselian)29 b(ep)r(o)r(c)n(h)i(are)e(alw)n(a)n(ys)g
-(represen)n(ted)g(in)i(units)g(of)227 3882 y(\(tropical\))c(y)n(ears.)
-227 4005 y(The)h(TimeScale)f(attribute)h(allo)n(ws)f(the)h(time)g
+(represen)n(ted)g(in)i(units)g(of)227 1956 y(\(tropical\))c(y)n(ears.)
+227 2106 y(The)h(TimeScale)f(attribute)h(allo)n(ws)f(the)h(time)g
(scale)f(to)g(b)r(e)h(sp)r(eci\014ed)g(\(that)h(is,)e(the)h(ph)n
-(ysical)f(pro)r(ces)g(used)h(to)227 4104 y(de\014ne)34
+(ysical)f(pro)r(ces)g(used)h(to)227 2206 y(de\014ne)34
b(the)g(rate)f(of)g(\015o)n(w)g(of)h(time\).)55 b(MJD,)34
b(JD)g(and)f(Julian)g(ep)r(o)r(c)n(h)h(can)f(b)r(e)h(used)f(to)h
-(represen)n(t)e(a)h(time)h(in)227 4204 y(an)n(y)26 b(supp)r(orted)h
+(represen)n(t)e(a)h(time)h(in)227 2306 y(an)n(y)26 b(supp)r(orted)h
(time)g(scale.)36 b(Ho)n(w)n(ev)n(er,)25 b(Besselian)h(ep)r(o)r(c)n(h)g
(ma)n(y)g(only)h(b)r(e)g(used)g(with)g(the)g Ft(")p Fj(TT)p
-Ft(")f Fj(\(T)-7 b(errestrial)227 4304 y(Time\))39 b(time)g(scale.)70
+Ft(")f Fj(\(T)-7 b(errestrial)227 2405 y(Time\))39 b(time)g(scale.)70
b(The)38 b(list)h(of)g(supp)r(orted)f(time)h(scales)f(includes)h(univ)n
-(ersal)e(time)i(and)f(siderial)g(time.)227 4403 y(Strictly)-7
+(ersal)e(time)i(and)f(siderial)g(time.)227 2505 y(Strictly)-7
b(,)30 b(these)g(represen)n(t)e(angles)g(rather)g(than)i(time)f
(scales,)g(but)h(are)e(included)i(in)g(the)f(list)h(since)f(they)h(are)
-227 4503 y(in)e(common)f(use)h(and)f(are)g(often)h(though)n(t)f(of)g
-(as)g(time)h(scales.)227 4626 y(When)h(a)e(time)h(v)-5
+227 2605 y(in)e(common)f(use)h(and)f(are)g(often)h(though)n(t)f(of)g
+(as)g(time)h(scales.)227 2755 y(When)h(a)e(time)h(v)-5
b(alue)28 b(is)f(formatted)h(it)g(can)f(b)r(e)h(formated)g(either)f(as)
g(a)h(simple)g(\015oating)e(p)r(oin)n(t)i(v)-5 b(alue,)28
-b(or)f(as)g(a)227 4725 y(Gregorian)f(date)h(\(see)h(the)g(F)-7
-b(ormat)27 b(attribute\).)0 4871 y Fc(In)m(v)m(o)s(cation:)123
+b(or)f(as)g(a)227 2854 y(Gregorian)f(date)h(\(see)h(the)g(F)-7
+b(ormat)27 b(attribute\).)0 3055 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_TIMEFRAME\()38 b(OPTIONS,)i(STATUS)h(\))0
-5017 y Fc(Argumen)m(ts:)259 5149 y(OPTIONS)32 b(=)g(CHARA)m(CTER)g
+3255 y Fc(Argumen)m(ts:)259 3442 y(OPTIONS)32 b(=)g(CHARA)m(CTER)g
Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-5249 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h(optional)g
+3542 y Fj(A)g(c)n(haracter)e(string)h(con)n(taining)f(an)h(optional)g
(comma-separated)e(list)j(of)g(attribute)f(assignmen)n(ts)g(to)427
-5349 y(b)r(e)38 b(used)f(for)f(initialising)h(the)g(new)g(TimeF)-7
+3641 y(b)r(e)38 b(used)f(for)f(initialising)h(the)g(new)g(TimeF)-7
b(rame.)64 b(The)37 b(syn)n(tax)f(used)h(is)g(iden)n(tical)g(to)g(that)
-g(for)f(the)427 5448 y(AST)p Ft(_)p Fj(SET)27 b(routine.)37
+g(for)f(the)427 3741 y(AST)p Ft(_)p Fj(SET)27 b(routine.)37
b(If)28 b(no)f(initialisation)g(is)h(required,)f(a)g(blank)g(v)-5
-b(alue)28 b(ma)n(y)e(b)r(e)i(supplied.)259 5577 y Fc(ST)-8
+b(alue)28 b(ma)n(y)e(b)r(e)i(supplied.)259 3899 y Fc(ST)-8
b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-5677 y Fj(The)c(global)e(status.)p eop end
-%%Page: 389 399
-TeXDict begin 389 398 bop 3643 52 a FG(389)0 351 y Fc(Returned)32
-b(V)-8 b(alue:)259 483 y(AST)p Ft(_)p Fc(TIMEFRAME)31
-b(=)h(INTEGER)427 583 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(TimeF)
--7 b(rame.)0 740 y Fc(Notes:)340 1017 y Fi(\017)45 b
+3999 y Fj(The)c(global)e(status.)0 4212 y Fc(Returned)32
+b(V)-8 b(alue:)259 4399 y(AST)p Ft(_)p Fc(TIMEFRAME)31
+b(=)h(INTEGER)427 4499 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(TimeF)
+-7 b(rame.)0 4711 y Fc(Notes:)340 5045 y Fi(\017)45 b
Fj(When)40 b(con)n(v)n(ersion)e(b)r(et)n(w)n(een)h(t)n(w)n(o)g(TimeF)-7
b(rames)39 b(is)g(requested)g(\(as)g(when)h(supplying)f(TimeF)-7
-b(rames)427 1117 y(AST)p Ft(_)p Fj(CONVER)g(T\),)30 b(accoun)n(t)g
+b(rames)427 5144 y(AST)p Ft(_)p Fj(CONVER)g(T\),)30 b(accoun)n(t)g
(will)g(b)r(e)g(tak)n(en)g(of)g(the)g(nature)g(of)g(the)g(time)h(co)r
-(ordinate)e(systems)g(they)427 1217 y(represen)n(t,)35
+(ordinate)e(systems)g(they)427 5244 y(represen)n(t,)35
b(together)f(with)h(an)n(y)f(qualifying)g(time)h(scale,)h(o\013set,)g
-(unit,)h(etc.)58 b(The)35 b(AlignSystem)g(and)427 1316
+(unit,)h(etc.)58 b(The)35 b(AlignSystem)g(and)427 5344
y(AlignTimeScale)28 b(attributes)f(will)h(also)e(b)r(e)i(tak)n(en)f(in)
-n(to)h(accoun)n(t.)340 1444 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+n(to)h(accoun)n(t.)340 5502 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 1544 y(set)28 b(to)f(an)h(error)d(v)-5
+b(A)g(TUS)427 5602 y(set)28 b(to)f(an)h(error)d(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-0 1734 3780 12 v 0 1864 a FA(AST)p Fe(_)p FA(TIMEMAP)389
-b Fd(Create)37 b(a)h(TimeMap)391 b FA(AST)p Fe(_)p FA(TIMEMAP)0
-2043 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+eop end
+%%Page: 392 402
+TeXDict begin 392 401 bop 0 52 a FG(392)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(TIMEMAP)389 b Fd(Create)37
+b(a)h(TimeMap)391 b FA(AST)p Fe(_)p FA(TIMEMAP)0 663
+y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
(TimeMap)h(and)f(optionally)g(initialises)g(its)h(attributes.)227
-2165 y(A)39 b(TimeMap)f(is)g(a)g(sp)r(ecialised)g(form)g(of)g
+785 y(A)39 b(TimeMap)f(is)g(a)g(sp)r(ecialised)g(form)g(of)g
(1-dimensional)f(Mapping)h(whic)n(h)h(can)f(b)r(e)g(used)h(to)f
-(represen)n(t)f(a)227 2265 y(sequence)27 b(of)h(con)n(v)n(ersions)d(b)r
+(represen)n(t)f(a)227 885 y(sequence)27 b(of)h(con)n(v)n(ersions)d(b)r
(et)n(w)n(een)i(standard)g(time)h(co)r(ordinate)f(systems.)227
-2387 y(When)19 b(a)f(TimeMap)g(is)h(\014rst)f(created,)h(it)g(simply)g
+1007 y(When)19 b(a)f(TimeMap)g(is)h(\014rst)f(created,)h(it)g(simply)g
(p)r(erforms)e(a)h(unit)h(\(n)n(ull\))g(Mapping.)34 b(Using)18
-b(the)h(AST)p Ft(_)p Fj(TIMEADD)227 2487 y(routine,)35
+b(the)h(AST)p Ft(_)p Fj(TIMEADD)227 1107 y(routine,)35
b(a)e(series)f(of)h(co)r(ordinate)f(con)n(v)n(ersion)f(steps)i(ma)n(y)g
(then)h(b)r(e)g(added.)54 b(This)33 b(allo)n(ws)f(m)n(ulti-step)h(con-)
-227 2586 y(v)n(ersions)i(b)r(et)n(w)n(een)h(a)g(v)-5
+227 1207 y(v)n(ersions)i(b)r(et)n(w)n(een)h(a)g(v)-5
b(ariet)n(y)35 b(of)h(time)h(co)r(ordinate)e(systems)g(to)h(b)r(e)h
(assem)n(bled)e(out)h(of)g(a)g(set)g(of)g(building)227
-2686 y(blo)r(c)n(ks.)227 2808 y(F)-7 b(or)18 b(details)g(of)g(the)h
+1306 y(blo)r(c)n(ks.)227 1429 y(F)-7 b(or)18 b(details)g(of)g(the)h
(individual)g(co)r(ordinate)e(con)n(v)n(ersions)f(a)n(v)-5
b(ailable,)19 b(see)f(the)h(description)e(of)i(the)f(AST)p
-Ft(_)p Fj(TIMEADD)227 2908 y(routine.)0 3052 y Fc(In)m(v)m(o)s(cation:)
+Ft(_)p Fj(TIMEADD)227 1528 y(routine.)0 1674 y Fc(In)m(v)m(o)s(cation:)
123 b Ft(RESULT)41 b(=)i(AST_TIMEMAP\()c(FLAGS,)i(OPTIONS,)f(STATUS)h
-(\))0 3197 y Fc(Argumen)m(ts:)259 3329 y(FLA)m(GS)33
-b(=)f(INTEGER)f(\(Giv)m(en\))427 3428 y Fj(This)d(argumen)n(t)e(is)i
+(\))0 1819 y Fc(Argumen)m(ts:)259 1952 y(FLA)m(GS)33
+b(=)f(INTEGER)f(\(Giv)m(en\))427 2052 y Fj(This)d(argumen)n(t)e(is)i
(reserv)n(ed)e(for)h(future)h(use)f(and)h(should)f(curren)n(tly)g(alw)n
-(a)n(ys)e(b)r(e)j(set)g(to)f(zero.)259 3556 y Fc(OPTIONS)32
+(a)n(ys)e(b)r(e)j(set)g(to)f(zero.)259 2181 y Fc(OPTIONS)32
b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))
-427 3656 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h
+427 2280 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h
(optional)f(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f
-(to)g(b)r(e)427 3756 y(used)i(for)g(initialising)f(the)i(new)f
+(to)g(b)r(e)427 2380 y(used)i(for)g(initialising)f(the)i(new)f
(TimeMap.)35 b(The)23 b(syn)n(tax)f(used)h(is)g(iden)n(tical)f(to)h
-(that)g(for)g(the)g(AST)p Ft(_)p Fj(SET)427 3855 y(routine.)37
+(that)g(for)g(the)g(AST)p Ft(_)p Fj(SET)427 2479 y(routine.)37
b(If)28 b(no)f(initialisation)g(is)h(required,)e(a)i(blank)f(v)-5
-b(alue)27 b(ma)n(y)g(b)r(e)h(supplied.)259 3983 y Fc(ST)-8
+b(alue)27 b(ma)n(y)g(b)r(e)h(supplied.)259 2608 y Fc(ST)-8
b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-4083 y Fj(The)c(global)e(status.)0 4240 y Fc(Returned)32
-b(V)-8 b(alue:)259 4372 y(AST)p Ft(_)p Fc(TIMEMAP)32
-b(=)g(INTEGER)427 4471 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
-(TimeMap.)0 4628 y Fc(Notes:)340 4906 y Fi(\017)45 b
+2708 y Fj(The)c(global)e(status.)0 2866 y Fc(Returned)32
+b(V)-8 b(alue:)259 2998 y(AST)p Ft(_)p Fc(TIMEMAP)32
+b(=)g(INTEGER)427 3098 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
+(TimeMap.)0 3256 y Fc(Notes:)340 3535 y Fi(\017)45 b
Fj(The)23 b(nature)g(and)g(units)h(of)f(the)g(co)r(ordinate)f(v)-5
b(alues)23 b(supplied)h(for)e(the)i(\014rst)f(input)h(\(i.e.)35
-b(the)24 b(time)g(input\))427 5006 y(of)36 b(a)g(TimeMap)g(m)n(ust)h(b)
+b(the)24 b(time)g(input\))427 3634 y(of)36 b(a)g(TimeMap)g(m)n(ust)h(b)
r(e)f(appropriate)f(to)h(the)h(\014rst)f(con)n(v)n(ersion)d(step)k
-(applied)f(b)n(y)g(the)h(TimeMap.)427 5105 y(F)-7 b(or)23
+(applied)f(b)n(y)g(the)h(TimeMap.)427 3734 y(F)-7 b(or)23
b(instance,)h(if)g(the)g(\014rst)f(con)n(v)n(ersion)e(step)i(is)h
Ft(")p Fj(MJDTOBEP)p Ft(")d Fj(\(Mo)r(di\014ed)j(Julian)f(Date)g(to)h
-(Besselian)427 5205 y(ep)r(o)r(c)n(h\))e(then)g(the)g(co)r(ordinate)f
+(Besselian)427 3833 y(ep)r(o)r(c)n(h\))e(then)g(the)g(co)r(ordinate)f
(v)-5 b(alues)21 b(for)g(the)h(\014rst)f(input)i(should)e(b)r(e)h(date)
g(in)g(units)g(of)f(da)n(ys.)34 b(Similarly)-7 b(,)427
-5305 y(the)28 b(nature)e(and)h(units)g(of)g(the)g(co)r(ordinate)f(v)-5
+3933 y(the)28 b(nature)e(and)h(units)g(of)g(the)g(co)r(ordinate)f(v)-5
b(alues)27 b(returned)f(b)n(y)h(a)f(TimeMap)h(will)g(b)r(e)h
-(determined)f(b)n(y)427 5404 y(the)h(last)g(con)n(v)n(ersion)d(step)j
-(applied)f(b)n(y)g(the)h(TimeMap.)340 5532 y Fi(\017)45
+(determined)f(b)n(y)427 4033 y(the)h(last)g(con)n(v)n(ersion)d(step)j
+(applied)f(b)n(y)g(the)h(TimeMap.)340 4162 y Fi(\017)45
b Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 5632
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 4261
y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p eop end
-%%Page: 390 400
-TeXDict begin 390 399 bop 0 52 a FG(390)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
-v 0 482 a FA(AST)p Fe(_)p FA(TRAN1)1255 483 y Fd(T)-10
-b(ransform)36 b(1-dimensional)1598 583 y(co)s(ordinates)2980
-482 y FA(AST)p Fe(_)p FA(TRAN1)0 755 y Fc(Description:)44
-b Fj(This)37 b(routine)f(applies)g(a)f(Mapping)h(to)h(transform)e(the)h
-(co)r(ordinates)f(of)i(a)f(set)g(of)g(p)r(oin)n(ts)g(in)h(one)227
-855 y(dimension.)0 1011 y Fc(In)m(v)m(o)s(cation:)123
-b Ft(CALL)42 b(AST_TRAN1\()d(THIS,)j(NPOINT,)e(XIN,)i(FORWARD,)f(XOUT,)
-g(STATUS)g(\))0 1168 y Fc(Argumen)m(ts:)259 1311 y(THIS)32
-b(=)g(INTEGER)g(\(Giv)m(en\))427 1411 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(Mapping)f(to)g(b)r(e)h(applied.)259 1547
-y Fc(NPOINT)k(=)g(INTEGER)f(\(Giv)m(en\))427 1646 y Fj(The)d(n)n(um)n
-(b)r(er)f(of)h(p)r(oin)n(ts)f(to)h(b)r(e)g(transformed.)259
-1783 y Fc(XIN\()k(NPOINT)g(\))g(=)g(DOUBLE)g(PRECISION)g(\(Giv)m(en\))
-427 1882 y Fj(An)c(arra)n(y)e(of)h(co)r(ordinate)g(v)-5
-b(alues)27 b(for)g(the)h(input)g(\(un)n(transformed\))f(p)r(oin)n(ts.)
-259 2019 y Fc(F)m(OR)-11 b(W)g(ARD)32 b(=)g(LOGICAL)h(\(Giv)m(en\))427
-2118 y Fj(A)38 b(.TR)n(UE.)e(v)-5 b(alue)37 b(indicates)g(that)h(the)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 4453 V 0 4583 a FA(AST)p
+Fe(_)p FA(TRAN1)1255 4584 y Fd(T)-10 b(ransform)36 b(1-dimensional)1598
+4684 y(co)s(ordinates)2980 4583 y FA(AST)p Fe(_)p FA(TRAN1)0
+4842 y Fc(Description:)44 b Fj(This)37 b(routine)f(applies)g(a)f
+(Mapping)h(to)h(transform)e(the)h(co)r(ordinates)f(of)i(a)f(set)g(of)g
+(p)r(oin)n(ts)g(in)h(one)227 4941 y(dimension.)0 5087
+y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_TRAN1\()d(THIS,)j
+(NPOINT,)e(XIN,)i(FORWARD,)f(XOUT,)g(STATUS)g(\))0 5232
+y Fc(Argumen)m(ts:)259 5365 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
+5464 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Mapping)f(to)g(b)r(e)h
+(applied.)259 5593 y Fc(NPOINT)k(=)g(INTEGER)f(\(Giv)m(en\))427
+5693 y Fj(The)d(n)n(um)n(b)r(er)f(of)h(p)r(oin)n(ts)f(to)h(b)r(e)g
+(transformed.)p eop end
+%%Page: 393 403
+TeXDict begin 393 402 bop 3643 52 a FG(393)259 351 y
+Fc(XIN\()32 b(NPOINT)g(\))g(=)g(DOUBLE)g(PRECISION)g(\(Giv)m(en\))427
+451 y Fj(An)c(arra)n(y)e(of)h(co)r(ordinate)g(v)-5 b(alues)27
+b(for)g(the)h(input)g(\(un)n(transformed\))f(p)r(oin)n(ts.)259
+602 y Fc(F)m(OR)-11 b(W)g(ARD)32 b(=)g(LOGICAL)h(\(Giv)m(en\))427
+702 y Fj(A)38 b(.TR)n(UE.)e(v)-5 b(alue)37 b(indicates)g(that)h(the)f
(Mapping's)g(forw)n(ard)e(co)r(ordinate)h(transformation)f(is)i(to)g(b)
-r(e)427 2218 y(applied,)28 b(while)g(a)f(.F)-9 b(ALSE.)27
+r(e)427 801 y(applied,)28 b(while)g(a)f(.F)-9 b(ALSE.)27
b(v)-5 b(alue)28 b(indicates)f(that)h(the)g(in)n(v)n(erse)e
-(transformation)g(should)i(b)r(e)g(used.)259 2354 y Fc(X)m(OUT\()33
+(transformation)g(should)i(b)r(e)g(used.)259 953 y Fc(X)m(OUT\()33
b(NPOINT)f(\))g(=)g(DOUBLE)g(PRECISION)g(\(Returned\))427
-2454 y Fj(An)c(arra)n(y)e(in)n(to)h(whic)n(h)g(the)h(co)r(ordinates)f
+1052 y Fj(An)c(arra)n(y)e(in)n(to)h(whic)n(h)g(the)h(co)r(ordinates)f
(of)g(the)h(output)g(\(transformed\))f(p)r(oin)n(ts)h(will)g(b)r(e)g
-(written.)259 2590 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h
-(and)g(Returned\))427 2690 y Fj(The)c(global)e(status.)0
-2859 y Fc(Notes:)340 3148 y Fi(\017)45 b Fj(The)28 b(Mapping)f
+(written.)259 1203 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h
+(and)g(Returned\))427 1303 y Fj(The)c(global)e(status.)0
+1502 y Fc(Notes:)340 1821 y Fi(\017)45 b Fj(The)28 b(Mapping)f
(supplied)h(m)n(ust)g(ha)n(v)n(e)e(the)i(v)-5 b(alue)28
b(1)f(for)g(b)r(oth)h(its)g(Nin)g(and)f(Nout)h(attributes.)p
-0 3354 V 0 3485 a FA(AST)p Fe(_)p FA(TRAN2)1255 3486
-y Fd(T)-10 b(ransform)36 b(2-dimensional)1598 3586 y(co)s(ordinates)
-2980 3485 y FA(AST)p Fe(_)p FA(TRAN2)0 3758 y Fc(Description:)44
-b Fj(This)36 b(routine)g(applies)g(a)f(Mapping)h(to)g(transform)f(the)h
-(co)r(ordinates)f(of)h(a)f(set)h(of)g(p)r(oin)n(ts)g(in)g(t)n(w)n(o)227
-3858 y(dimensions.)0 4014 y Fc(In)m(v)m(o)s(cation:)123
-b Ft(CALL)42 b(AST_TRAN2\()d(THIS,)j(NPOINT,)e(XIN,)i(YIN,)g(FORWARD,)e
-(XOUT,)i(YOUT,)g(STATUS)f(\))0 4171 y Fc(Argumen)m(ts:)259
-4314 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 4414
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Mapping)f(to)g(b)r(e)h(applied.)259
-4550 y Fc(NPOINT)k(=)g(INTEGER)f(\(Giv)m(en\))427 4650
-y Fj(The)d(n)n(um)n(b)r(er)f(of)h(p)r(oin)n(ts)f(to)h(b)r(e)g
-(transformed.)259 4786 y Fc(XIN\()k(NPOINT)g(\))g(=)g(DOUBLE)g
-(PRECISION)g(\(Giv)m(en\))427 4886 y Fj(An)c(arra)n(y)e(of)h(X-co)r
+0 2057 3780 12 v 0 2188 a FA(AST)p Fe(_)p FA(TRAN2)1255
+2189 y Fd(T)-10 b(ransform)36 b(2-dimensional)1598 2288
+y(co)s(ordinates)2980 2188 y FA(AST)p Fe(_)p FA(TRAN2)0
+2491 y Fc(Description:)44 b Fj(This)36 b(routine)g(applies)g(a)f
+(Mapping)h(to)g(transform)f(the)h(co)r(ordinates)f(of)h(a)f(set)h(of)g
+(p)r(oin)n(ts)g(in)g(t)n(w)n(o)227 2590 y(dimensions.)0
+2776 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_TRAN2\()d(THIS,)j
+(NPOINT,)e(XIN,)i(YIN,)g(FORWARD,)e(XOUT,)i(YOUT,)g(STATUS)f(\))0
+2963 y Fc(Argumen)m(ts:)259 3136 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 3235 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Mapping)f(to)g(b)r(e)
+h(applied.)259 3387 y Fc(NPOINT)k(=)g(INTEGER)f(\(Giv)m(en\))427
+3486 y Fj(The)d(n)n(um)n(b)r(er)f(of)h(p)r(oin)n(ts)f(to)h(b)r(e)g
+(transformed.)259 3637 y Fc(XIN\()k(NPOINT)g(\))g(=)g(DOUBLE)g
+(PRECISION)g(\(Giv)m(en\))427 3737 y Fj(An)c(arra)n(y)e(of)h(X-co)r
(ordinate)f(v)-5 b(alues)28 b(for)f(the)h(input)g(\(un)n(transformed\))
-f(p)r(oin)n(ts.)259 5022 y Fc(YIN\()32 b(NPOINT)g(\))g(=)g(DOUBLE)g
-(PRECISION)g(\(Giv)m(en\))427 5121 y Fj(An)c(arra)n(y)e(of)h(Y-co)r
+f(p)r(oin)n(ts.)259 3888 y Fc(YIN\()32 b(NPOINT)g(\))g(=)g(DOUBLE)g
+(PRECISION)g(\(Giv)m(en\))427 3988 y Fj(An)c(arra)n(y)e(of)h(Y-co)r
(ordinate)f(v)-5 b(alues)28 b(for)f(the)h(input)g(\(un)n(transformed\))
-f(p)r(oin)n(ts.)259 5258 y Fc(F)m(OR)-11 b(W)g(ARD)32
-b(=)g(LOGICAL)h(\(Giv)m(en\))427 5357 y Fj(A)38 b(.TR)n(UE.)e(v)-5
+f(p)r(oin)n(ts.)259 4139 y Fc(F)m(OR)-11 b(W)g(ARD)32
+b(=)g(LOGICAL)h(\(Giv)m(en\))427 4239 y Fj(A)38 b(.TR)n(UE.)e(v)-5
b(alue)37 b(indicates)g(that)h(the)f(Mapping's)g(forw)n(ard)e(co)r
-(ordinate)h(transformation)f(is)i(to)g(b)r(e)427 5457
+(ordinate)h(transformation)f(is)i(to)g(b)r(e)427 4338
y(applied,)28 b(while)g(a)f(.F)-9 b(ALSE.)27 b(v)-5 b(alue)28
b(indicates)f(that)h(the)g(in)n(v)n(erse)e(transformation)g(should)i(b)
-r(e)g(used.)259 5593 y Fc(X)m(OUT\()33 b(NPOINT)f(\))g(=)g(DOUBLE)g
-(PRECISION)g(\(Returned\))427 5693 y Fj(An)c(arra)n(y)e(in)n(to)h(whic)
+r(e)g(used.)259 4489 y Fc(X)m(OUT\()33 b(NPOINT)f(\))g(=)g(DOUBLE)g
+(PRECISION)g(\(Returned\))427 4589 y Fj(An)c(arra)n(y)e(in)n(to)h(whic)
n(h)g(the)h(X-co)r(ordinates)f(of)g(the)h(output)g(\(transformed\))f(p)
-r(oin)n(ts)h(will)g(b)r(e)g(written.)p eop end
-%%Page: 391 401
-TeXDict begin 391 400 bop 3643 52 a FG(391)259 351 y
-Fc(YOUT\()33 b(NPOINT)f(\))g(=)g(DOUBLE)g(PRECISION)f(\(Returned\))427
-451 y Fj(An)d(arra)n(y)e(in)n(to)h(whic)n(h)g(the)h(Y-co)r(ordinates)f
+r(oin)n(ts)h(will)g(b)r(e)g(written.)259 4740 y Fc(YOUT\()33
+b(NPOINT)f(\))g(=)g(DOUBLE)g(PRECISION)f(\(Returned\))427
+4840 y Fj(An)d(arra)n(y)e(in)n(to)h(whic)n(h)g(the)h(Y-co)r(ordinates)f
(of)g(the)h(output)g(\(transformed\))f(p)r(oin)n(ts)h(will)g(b)r(e)g
-(written.)259 583 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h
-(and)g(Returned\))427 683 y Fj(The)c(global)e(status.)0
-845 y Fc(Notes:)340 1127 y Fi(\017)45 b Fj(The)28 b(Mapping)f(supplied)
-h(m)n(ust)g(ha)n(v)n(e)e(the)i(v)-5 b(alue)28 b(2)f(for)g(b)r(oth)h
-(its)g(Nin)g(and)f(Nout)h(attributes.)p 0 1326 3780 12
-v 0 1456 a FA(AST)p Fe(_)p FA(TRANGRID)1390 1457 y Fd(T)-10
-b(ransform)37 b(a)h(grid)g(of)1663 1568 y(p)s(ositions)2688
-1456 y FA(AST)p Fe(_)p FA(TRANGRID)0 1757 y Fc(Description:)44
+(written.)259 4991 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h
+(and)g(Returned\))427 5091 y Fj(The)c(global)e(status.)0
+5289 y Fc(Notes:)340 5609 y Fi(\017)45 b Fj(The)28 b(Mapping)f
+(supplied)h(m)n(ust)g(ha)n(v)n(e)e(the)i(v)-5 b(alue)28
+b(2)f(for)g(b)r(oth)h(its)g(Nin)g(and)f(Nout)h(attributes.)p
+eop end
+%%Page: 394 404
+TeXDict begin 394 403 bop 0 52 a FG(394)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(TRANGRID)1390 483 y Fd(T)-10
+b(ransform)37 b(a)h(grid)g(of)1663 594 y(p)s(ositions)2688
+482 y FA(AST)p Fe(_)p FA(TRANGRID)0 788 y Fc(Description:)44
b Fj(This)36 b(function)g(uses)f(the)h(supplied)f(Mapping)g(to)h
(transforms)e(a)h(regular)e(square)i(grid)f(of)i(p)r(oin)n(ts)227
-1856 y(co)n(v)n(ering)28 b(a)h(sp)r(eci\014ed)h(b)r(o)n(x.)42
+888 y(co)n(v)n(ering)28 b(a)h(sp)r(eci\014ed)h(b)r(o)n(x.)42
b(It)30 b(attempts)g(to)f(do)g(this)h(quic)n(kly)f(b)n(y)g(\014rst)g
-(appro)n(ximating)f(the)i(Mapping)f(with)227 1956 y(a)35
+(appro)n(ximating)f(the)i(Mapping)f(with)227 987 y(a)35
b(linear)g(transformation)e(applied)j(o)n(v)n(er)d(the)j(whole)f
(region)f(of)h(the)h(input)g(grid)e(whic)n(h)i(is)f(b)r(eing)g(used.)60
-b(If)227 2055 y(this)30 b(pro)n(v)n(es)e(to)i(b)r(e)g(insu\016cien)n
+b(If)227 1087 y(this)30 b(pro)n(v)n(es)e(to)i(b)r(e)g(insu\016cien)n
(tly)g(accurate,)f(the)h(input)h(region)d(is)i(sub-divided)g(in)n(to)f
-(t)n(w)n(o)g(along)g(its)h(largest)227 2155 y(dimension)k(and)g(the)h
+(t)n(w)n(o)g(along)g(its)h(largest)227 1187 y(dimension)k(and)g(the)h
(pro)r(cess)e(is)h(rep)r(eated)g(within)h(eac)n(h)e(of)h(the)h
(resulting)f(sub-regions.)54 b(This)35 b(pro)r(cess)e(of)227
-2255 y(sub-division)21 b(con)n(tin)n(ues)g(un)n(til)g(a)g(su\016cien)n
+1286 y(sub-division)21 b(con)n(tin)n(ues)g(un)n(til)g(a)g(su\016cien)n
(tly)h(go)r(o)r(d)f(linear)f(appro)n(ximation)g(is)h(found,)i(or)e(the)
-g(region)f(to)i(whic)n(h)227 2354 y(it)28 b(is)g(b)r(eing)f(applied)h
+g(region)f(to)i(whic)n(h)227 1386 y(it)28 b(is)g(b)r(eing)f(applied)h
(b)r(ecomes)f(to)r(o)h(small)f(\(in)h(whic)n(h)g(case)e(the)i(original)
-e(Mapping)h(is)h(used)g(directly\).)0 2504 y Fc(In)m(v)m(o)s(cation:)
+e(Mapping)h(is)h(used)g(directly\).)0 1541 y Fc(In)m(v)m(o)s(cation:)
123 b Ft(CALL)42 b(AST_TRANGRID\()c(THIS,)j(NCOORD_IN,)f(LBND,)h(UBND,)
-h(TOL,)g(MAXPIX,)f(FORWARD,)f(NCOORD_OUT,)227 2603 y(OUTDIM,)h(OUT,)h
-(STATUS)f(\))0 2752 y Fc(Argumen)m(ts:)259 2889 y(THIS)32
-b(=)g(INTEGER)g(\(Giv)m(en\))427 2988 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(Mapping)f(to)g(b)r(e)h(applied.)259 3121
+h(TOL,)g(MAXPIX,)f(FORWARD,)f(NCOORD_OUT,)227 1640 y(OUTDIM,)h(OUT,)h
+(STATUS)f(\))0 1795 y Fc(Argumen)m(ts:)259 1937 y(THIS)32
+b(=)g(INTEGER)g(\(Giv)m(en\))427 2036 y Fj(P)n(oin)n(ter)26
+b(to)i(the)g(Mapping)f(to)g(b)r(e)h(applied.)259 2172
y Fc(NCOORD)p Ft(_)p Fc(IN)i(=)i(INTEGER)g(\(Giv)m(en\))427
-3220 y Fj(The)24 b(n)n(um)n(b)r(er)g(of)g(co)r(ordinates)f(b)r(eing)h
+2272 y Fj(The)24 b(n)n(um)n(b)r(er)g(of)g(co)r(ordinates)f(b)r(eing)h
(supplied)g(for)g(eac)n(h)f(b)r(o)n(x)g(corner)g(\(i.e.)36
-b(the)24 b(n)n(um)n(b)r(er)g(of)g(dimensions)427 3320
+b(the)24 b(n)n(um)n(b)r(er)g(of)g(dimensions)427 2371
y(of)k(the)g(space)f(in)h(whic)n(h)f(the)h(input)g(p)r(oin)n(ts)g
-(reside\).)259 3453 y Fc(LBND\()k(NCOORD)p Ft(_)p Fc(IN)f(\))h(=)g
-(INTEGER)f(\(Giv)m(en\))427 3552 y Fj(An)j(arra)n(y)d(con)n(taining)h
+(reside\).)259 2507 y Fc(LBND\()k(NCOORD)p Ft(_)p Fc(IN)f(\))h(=)g
+(INTEGER)f(\(Giv)m(en\))427 2606 y Fj(An)j(arra)n(y)d(con)n(taining)h
(the)i(co)r(ordinates)e(of)h(the)h(cen)n(tre)f(of)g(the)g(\014rst)h
-(pixel)f(in)g(the)h(input)g(grid)f(along)427 3652 y(eac)n(h)27
-b(dimension.)259 3784 y Fc(UBND\()32 b(NCOORD)p Ft(_)p
-Fc(IN)f(\))h(=)g(INTEGER)f(\(Giv)m(en\))427 3884 y Fj(An)k(arra)n(y)d
+(pixel)f(in)g(the)h(input)g(grid)f(along)427 2706 y(eac)n(h)27
+b(dimension.)259 2842 y Fc(UBND\()32 b(NCOORD)p Ft(_)p
+Fc(IN)f(\))h(=)g(INTEGER)f(\(Giv)m(en\))427 2941 y Fj(An)k(arra)n(y)d
(con)n(taining)h(the)h(co)r(ordinates)f(of)h(the)h(cen)n(tre)f(of)g
(the)g(last)g(pixel)g(in)h(the)f(input)h(grid)f(along)427
-3984 y(eac)n(h)27 b(dimension.)427 4100 y(Note)i(that)g(LBND)g(and)f
+3041 y(eac)n(h)27 b(dimension.)427 3158 y(Note)i(that)g(LBND)g(and)f
(UBND)h(together)f(de\014ne)h(the)f(shap)r(e)h(and)f(size)g(of)h(the)g
-(input)g(grid,)f(its)h(exten)n(t)427 4199 y(along)24
+(input)g(grid,)f(its)h(exten)n(t)427 3258 y(along)24
b(a)h(particular)f(\(J'th\))j(dimension)e(b)r(eing)g
(UBND\(J\)-LBND\(J\)+1.)37 b(They)25 b(also)f(de\014ne)i(the)g(input)
-427 4299 y(grid's)33 b(co)r(ordinate)f(system,)i(eac)n(h)f(pixel)g(ha)n
+427 3358 y(grid's)33 b(co)r(ordinate)f(system,)i(eac)n(h)f(pixel)g(ha)n
(ving)g(unit)h(exten)n(t)f(along)f(eac)n(h)h(dimension)g(with)h(in)n
-(tegral)427 4399 y(co)r(ordinate)27 b(v)-5 b(alues)27
-b(at)g(its)h(cen)n(tre.)259 4531 y Fc(TOL)k(=)h(DOUBLE)f(PRECISION)f
-(\(Giv)m(en\))427 4631 y Fj(The)j(maxim)n(um)f(tolerable)f(geometrical)
+(tegral)427 3457 y(co)r(ordinate)27 b(v)-5 b(alues)27
+b(at)g(its)h(cen)n(tre.)259 3593 y Fc(TOL)k(=)h(DOUBLE)f(PRECISION)f
+(\(Giv)m(en\))427 3692 y Fj(The)j(maxim)n(um)f(tolerable)f(geometrical)
f(distortion)i(whic)n(h)g(ma)n(y)f(b)r(e)i(in)n(tro)r(duced)f(as)f(a)h
-(result)g(of)g(ap-)427 4730 y(pro)n(ximating)c(non-linear)f(Mappings)h
+(result)g(of)g(ap-)427 3792 y(pro)n(ximating)c(non-linear)f(Mappings)h
(b)n(y)h(a)f(set)h(of)g(piece-wise)f(linear)g(transformations.)42
-b(This)30 b(should)427 4830 y(b)r(e)e(expressed)f(as)g(a)g(displacemen)
+b(This)30 b(should)427 3892 y(b)r(e)e(expressed)f(as)g(a)g(displacemen)
n(t)g(within)h(the)g(output)h(co)r(ordinate)d(system)h(of)h(the)g
-(Mapping.)427 4946 y(If)34 b(piece-wise)f(linear)g(appro)n(ximation)f
+(Mapping.)427 4009 y(If)34 b(piece-wise)f(linear)g(appro)n(ximation)f
(is)h(not)h(required,)g(a)f(v)-5 b(alue)33 b(of)h(zero)e(ma)n(y)h(b)r
-(e)h(giv)n(en.)54 b(This)33 b(will)427 5046 y(ensure)k(that)g(the)h
+(e)h(giv)n(en.)54 b(This)33 b(will)427 4109 y(ensure)k(that)g(the)h
(Mapping)e(is)h(used)g(without)h(an)n(y)e(appro)n(ximation,)i(but)g(ma)
-n(y)e(increase)g(execution)427 5145 y(time.)427 5262
+n(y)e(increase)g(execution)427 4208 y(time.)427 4326
y(If)d(the)f(v)-5 b(alue)32 b(is)g(to)r(o)g(high,)h(discon)n(tin)n
(uities)e(b)r(et)n(w)n(een)h(the)h(linear)e(appro)n(ximations)f(used)i
-(in)g(adjacen)n(t)427 5361 y(panel)c(will)f(b)r(e)h(higher.)37
+(in)g(adjacen)n(t)427 4426 y(panel)c(will)f(b)r(e)h(higher.)37
b(If)28 b(this)g(is)f(a)g(problem,)g(reduce)h(the)g(tolerance)e(v)-5
-b(alue)27 b(used.)259 5494 y Fc(MAXPIX)33 b(=)f(INTEGER)f(\(Giv)m(en\))
-427 5593 y Fj(A)e(v)-5 b(alue)29 b(whic)n(h)g(sp)r(eci\014es)f(an)h
+b(alue)27 b(used.)259 4561 y Fc(MAXPIX)33 b(=)f(INTEGER)f(\(Giv)m(en\))
+427 4661 y Fj(A)e(v)-5 b(alue)29 b(whic)n(h)g(sp)r(eci\014es)f(an)h
(initial)g(scale)f(size)g(\(in)h(input)h(grid)e(p)r(oin)n(ts\))h(for)f
-(the)h(adaptiv)n(e)f(algorithm)427 5693 y(whic)n(h)j(appro)n(ximates)f
+(the)h(adaptiv)n(e)f(algorithm)427 4760 y(whic)n(h)j(appro)n(ximates)f
(non-linear)g(Mappings)g(with)i(piece-wise)f(linear)f(transformations.)
-46 b(Normally)-7 b(,)p eop end
-%%Page: 392 402
-TeXDict begin 392 401 bop 0 52 a FG(392)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(this)d(should)g(b)r
-(e)g(a)g(large)e(v)-5 b(alue)28 b(\(larger)e(than)i(an)n(y)f(dimension)
-g(of)h(the)g(region)f(of)h(the)g(input)g(grid)g(b)r(eing)427
-451 y(used\).)46 b(In)31 b(this)g(case,)g(a)f(\014rst)g(attempt)h(to)g
+46 b(Normally)-7 b(,)427 4860 y(this)28 b(should)g(b)r(e)g(a)g(large)e
+(v)-5 b(alue)28 b(\(larger)e(than)i(an)n(y)f(dimension)g(of)h(the)g
+(region)f(of)h(the)g(input)g(grid)g(b)r(eing)427 4960
+y(used\).)46 b(In)31 b(this)g(case,)g(a)f(\014rst)g(attempt)h(to)g
(appro)n(ximate)e(the)i(Mapping)f(b)n(y)g(a)g(linear)g(transformation)
-427 551 y(will)e(b)r(e)g(made)f(o)n(v)n(er)f(the)i(en)n(tire)f(input)i
-(region.)427 660 y(If)k(a)f(smaller)f(v)-5 b(alue)33
+427 5059 y(will)e(b)r(e)g(made)f(o)n(v)n(er)f(the)i(en)n(tire)f(input)i
+(region.)427 5177 y(If)k(a)f(smaller)f(v)-5 b(alue)33
b(is)f(used,)i(the)e(input)h(region)f(will)g(\014rst)g(b)r(e)h(divided)
-g(in)n(to)f(sub-regions)e(whose)i(size)427 760 y(do)r(es)c(not)g
+g(in)n(to)f(sub-regions)e(whose)i(size)427 5277 y(do)r(es)c(not)g
(exceed)g(MAXPIX)h(grid)e(p)r(oin)n(ts)h(in)g(an)n(y)g(dimension.)38
b(Only)28 b(at)g(this)h(p)r(oin)n(t)f(will)g(attempts)h(at)427
-860 y(appro)n(ximation)d(commence.)427 970 y(This)38
+5376 y(appro)n(ximation)d(commence.)427 5494 y(This)38
b(v)-5 b(alue)38 b(ma)n(y)g(o)r(ccasionally)e(b)r(e)j(useful)f(in)h
(prev)n(en)n(ting)e(false)h(con)n(v)n(ergence)d(of)j(the)h(adaptiv)n(e)
-e(al-)427 1069 y(gorithm)c(in)g(cases)f(where)g(the)h(Mapping)g(app)r
+e(al-)427 5593 y(gorithm)c(in)g(cases)f(where)g(the)h(Mapping)g(app)r
(ears)f(appro)n(ximately)f(linear)h(on)h(large)e(scales,)j(but)f(has)
-427 1169 y(irregularities)e(\(e.g.)53 b(holes\))32 b(on)h(smaller)f
+427 5693 y(irregularities)e(\(e.g.)53 b(holes\))32 b(on)h(smaller)f
(scales.)52 b(A)33 b(v)-5 b(alue)33 b(of,)h(sa)n(y)-7
-b(,)34 b(50)e(to)g(100)g(grid)g(p)r(oin)n(ts)h(can)g(also)427
-1268 y(b)r(e)h(emplo)n(y)n(ed)e(as)g(a)h(safeguard)f(in)h(general-purp)
-r(ose)e(soft)n(w)n(are,)i(since)g(the)g(e\013ect)h(on)f(p)r(erformance)
-f(is)427 1368 y(minimal.)427 1478 y(If)21 b(to)r(o)f(small)g(a)g(v)-5
+b(,)34 b(50)e(to)g(100)g(grid)g(p)r(oin)n(ts)h(can)g(also)p
+eop end
+%%Page: 395 405
+TeXDict begin 395 404 bop 3643 52 a FG(395)427 351 y
+Fj(b)r(e)34 b(emplo)n(y)n(ed)e(as)g(a)h(safeguard)f(in)h(general-purp)r
+(ose)e(soft)n(w)n(are,)i(since)g(the)g(e\013ect)h(on)f(p)r(erformance)f
+(is)427 451 y(minimal.)427 567 y(If)21 b(to)r(o)f(small)g(a)g(v)-5
b(alue)20 b(is)g(giv)n(en,)h(it)g(will)f(ha)n(v)n(e)f(the)i(e\013ect)g
(of)f(inhibiting)h(linear)f(appro)n(ximation)e(altogether)427
-1578 y(\(equiv)-5 b(alen)n(t)21 b(to)f(setting)h(TOL)f(to)g(zero\).)34
+666 y(\(equiv)-5 b(alen)n(t)21 b(to)f(setting)h(TOL)f(to)g(zero\).)34
b(Although)20 b(this)h(ma)n(y)f(degrade)f(p)r(erformance,)i(accurate)e
-(results)427 1677 y(will)28 b(still)g(b)r(e)g(obtained.)259
-1797 y Fc(F)m(OR)-11 b(W)g(ARD)32 b(=)g(LOGICAL)h(\(Giv)m(en\))427
-1897 y Fj(A)38 b(.TR)n(UE.)e(v)-5 b(alue)37 b(indicates)g(that)h(the)f
+(results)427 766 y(will)28 b(still)g(b)r(e)g(obtained.)259
+898 y Fc(F)m(OR)-11 b(W)g(ARD)32 b(=)g(LOGICAL)h(\(Giv)m(en\))427
+998 y Fj(A)38 b(.TR)n(UE.)e(v)-5 b(alue)37 b(indicates)g(that)h(the)f
(Mapping's)g(forw)n(ard)e(co)r(ordinate)h(transformation)f(is)i(to)g(b)
-r(e)427 1997 y(applied,)28 b(while)g(a)f(.F)-9 b(ALSE.)27
+r(e)427 1098 y(applied,)28 b(while)g(a)f(.F)-9 b(ALSE.)27
b(v)-5 b(alue)28 b(indicates)f(that)h(the)g(in)n(v)n(erse)e
-(transformation)g(should)i(b)r(e)g(used.)259 2117 y Fc(NCOORD)p
-Ft(_)p Fc(OUT)j(=)h(INTEGER)f(\(Giv)m(en\))427 2217 y
+(transformation)g(should)i(b)r(e)g(used.)259 1230 y Fc(NCOORD)p
+Ft(_)p Fc(OUT)j(=)h(INTEGER)f(\(Giv)m(en\))427 1330 y
Fj(The)g(n)n(um)n(b)r(er)e(of)i(co)r(ordinates)d(b)r(eing)j(generated)e
(b)n(y)h(the)g(Mapping)g(for)g(eac)n(h)f(output)i(p)r(oin)n(t)f(\(i.e.)
-45 b(the)427 2316 y(n)n(um)n(b)r(er)28 b(of)g(dimensions)g(of)h(the)f
+45 b(the)427 1429 y(n)n(um)n(b)r(er)28 b(of)g(dimensions)g(of)h(the)f
(space)g(in)g(whic)n(h)h(the)f(output)h(p)r(oin)n(ts)f(reside\).)39
-b(This)28 b(need)g(not)h(b)r(e)f(the)427 2416 y(same)f(as)g(NCOORD)p
-Ft(_)p Fj(IN.)259 2536 y Fc(OUTDIM)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
-2636 y Fj(The)e(n)n(um)n(b)r(er)f(of)g(elemen)n(ts)h(along)e(the)i
+b(This)28 b(need)g(not)h(b)r(e)f(the)427 1529 y(same)f(as)g(NCOORD)p
+Ft(_)p Fj(IN.)259 1661 y Fc(OUTDIM)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
+1761 y Fj(The)e(n)n(um)n(b)r(er)f(of)g(elemen)n(ts)h(along)e(the)i
(\014rst)f(dimension)g(of)h(the)g(OUT)f(arra)n(y)e(\(whic)n(h)j(will)f
-(con)n(tain)g(the)427 2735 y(output)34 b(co)r(ordinates\).)54
+(con)n(tain)g(the)427 1861 y(output)34 b(co)r(ordinates\).)54
b(The)33 b(v)-5 b(alue)34 b(giv)n(en)e(should)i(not)f(b)r(e)h(less)f
(than)h(the)f(n)n(um)n(b)r(er)h(of)f(p)r(oin)n(ts)g(in)h(the)427
-2835 y(grid.)259 2955 y Fc(OUT\()f(OUTDIM,)f(NCOORD)p
+1960 y(grid.)259 2092 y Fc(OUT\()f(OUTDIM,)f(NCOORD)p
Ft(_)p Fc(OUT)f(\))h(=)g(DOUBLE)g(PRECISION)f(\(Returned\))427
-3055 y Fj(An)22 b(arra)n(y)d(in)n(to)i(whic)n(h)g(the)h(co)r(ordinates)
+2192 y Fj(An)22 b(arra)n(y)d(in)n(to)i(whic)n(h)g(the)h(co)r(ordinates)
d(of)j(the)f(output)h(\(transformed\))f(p)r(oin)n(ts)g(will)g(b)r(e)h
-(written.)35 b(These)427 3154 y(will)e(b)r(e)g(stored)f(suc)n(h)g(that)
+(written.)35 b(These)427 2292 y(will)e(b)r(e)g(stored)f(suc)n(h)g(that)
h(the)g(v)-5 b(alue)33 b(of)f(co)r(ordinate)g(n)n(um)n(b)r(er)g(COORD)h
-(for)f(output)h(p)r(oin)n(t)g(n)n(um)n(b)r(er)427 3254
+(for)f(output)h(p)r(oin)n(t)g(n)n(um)n(b)r(er)427 2391
y(POINT)d(will)h(b)r(e)g(found)f(in)h(elemen)n(t)g(OUT\(POINT,COORD\).)
f(The)g(p)r(oin)n(ts)h(are)e(ordered)g(suc)n(h)h(that)427
-3354 y(the)36 b(\014rst)g(axis)f(of)h(the)g(input)h(grid)e(c)n(hanges)f
+2491 y(the)36 b(\014rst)g(axis)f(of)h(the)g(input)h(grid)e(c)n(hanges)f
(most)i(rapidly)-7 b(.)61 b(F)-7 b(or)35 b(example,)i(if)g(the)f(input)
-h(grid)e(is)g(2-)427 3453 y(dimensional)d(and)g(extends)h(from)f
+h(grid)e(is)g(2-)427 2591 y(dimensional)d(and)g(extends)h(from)f
(\(2,-1\))f(to)i(\(3,1\),)g(the)g(output)g(p)r(oin)n(ts)f(will)g(b)r(e)
-h(stored)f(in)g(the)h(order)427 3553 y(\(2,-1\),)27 b(\(3,)h(-1\),)f
-(\(2,0\),)g(\(3,0\),)h(\(2,1\),)f(\(3,1\).)259 3673 y
+h(stored)f(in)g(the)h(order)427 2690 y(\(2,-1\),)27 b(\(3,)h(-1\),)f
+(\(2,0\),)g(\(3,0\),)h(\(2,1\),)f(\(3,1\).)259 2823 y
Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-3773 y Fj(The)c(global)e(status.)0 3922 y Fc(Notes:)340
-4192 y Fi(\017)45 b Fj(If)31 b(the)g(forw)n(ard)e(co)r(ordinate)h
+2922 y Fj(The)c(global)e(status.)0 3084 y Fc(Notes:)340
+3366 y Fi(\017)45 b Fj(If)31 b(the)g(forw)n(ard)e(co)r(ordinate)h
(transformation)f(is)h(b)r(eing)h(applied,)h(the)f(Mapping)f(supplied)h
-(m)n(ust)g(ha)n(v)n(e)427 4291 y(the)24 b(v)-5 b(alue)23
+(m)n(ust)g(ha)n(v)n(e)427 3465 y(the)24 b(v)-5 b(alue)23
b(of)g(NCOORD)p Ft(_)p Fj(IN)h(for)e(its)i(Nin)g(attribute)f(and)g(the)
h(v)-5 b(alue)23 b(of)g(NCOORD)p Ft(_)p Fj(OUT)g(for)g(its)g(Nout)427
-4391 y(attribute.)37 b(If)28 b(the)g(in)n(v)n(erse)e(transformation)g
+3565 y(attribute.)37 b(If)28 b(the)g(in)n(v)n(erse)e(transformation)g
(is)i(b)r(eing)g(applied,)f(these)h(v)-5 b(alues)27 b(should)g(b)r(e)h
-(rev)n(ersed.)p 0 4565 3780 12 v 0 4696 a FA(AST)p Fe(_)p
-FA(TRANMAP)1415 4695 y Fd(Create)37 b(a)i(T)-10 b(ranMap)2727
-4696 y FA(AST)p Fe(_)p FA(TRANMAP)0 4859 y Fc(Description:)44
+(rev)n(ersed.)p 0 3763 3780 12 v 0 3894 a FA(AST)p Fe(_)p
+FA(TRANMAP)1415 3893 y Fd(Create)37 b(a)i(T)-10 b(ranMap)2727
+3894 y FA(AST)p Fe(_)p FA(TRANMAP)0 4081 y Fc(Description:)44
b Fj(This)28 b(function)g(creates)f(a)g(new)g(T)-7 b(ranMap)27
b(and)g(optionally)g(initialises)g(its)h(attributes.)227
-4977 y(A)f(T)-7 b(ranMap)26 b(is)g(a)h(Mapping)f(whic)n(h)g(com)n
+4206 y(A)f(T)-7 b(ranMap)26 b(is)g(a)h(Mapping)f(whic)n(h)g(com)n
(bines)g(the)h(forw)n(ard)e(transformation)g(of)i(a)f(supplied)h
-(Mapping)f(with)227 5077 y(the)34 b(in)n(v)n(erse)d(transformation)g
+(Mapping)f(with)227 4305 y(the)34 b(in)n(v)n(erse)d(transformation)g
(of)i(another)f(supplied)h(Mapping,)h(ignoring)d(the)i(un-used)g
-(transformation)e(in)227 5176 y(eac)n(h)c(Mapping)g(\(indeed)h(the)g
+(transformation)e(in)227 4405 y(eac)n(h)c(Mapping)g(\(indeed)h(the)g
(un-used)g(transformation)e(need)i(not)f(exist\).)227
-5295 y(When)h(the)f(forw)n(ard)e(transformation)h(of)h(the)g(T)-7
+4529 y(When)h(the)f(forw)n(ard)e(transformation)h(of)h(the)g(T)-7
b(ranMap)26 b(is)h(referred)f(to,)h(the)g(transformation)e(actually)i
-(used)227 5394 y(is)k(the)g(forw)n(ard)e(transformation)h(of)g(the)i
+(used)227 4629 y(is)k(the)g(forw)n(ard)e(transformation)h(of)g(the)i
(\014rst)e(Mapping)h(supplied)g(when)g(the)g(T)-7 b(ranMap)30
-b(w)n(as)g(constructed.)227 5494 y(Lik)n(ewise,)j(when)f(the)h(in)n(v)n
+b(w)n(as)g(constructed.)227 4728 y(Lik)n(ewise,)j(when)f(the)h(in)n(v)n
(erse)d(transformation)h(of)h(the)h(T)-7 b(ranMap)31
b(is)h(referred)f(to,)i(the)g(transformation)d(ac-)227
-5593 y(tually)f(used)g(is)g(the)g(in)n(v)n(erse)f(transformation)f(of)i
+4828 y(tually)f(used)g(is)g(the)g(in)n(v)n(erse)f(transformation)f(of)i
(the)h(second)e(Mapping)h(supplied)g(when)g(the)h(T)-7
-b(ranMap)28 b(w)n(as)227 5693 y(constructed.)p eop end
-%%Page: 393 403
-TeXDict begin 393 402 bop 3643 52 a FG(393)0 351 y Fc(In)m(v)m(o)s
-(cation:)123 b Ft(RESULT)41 b(=)i(AST_TRANMAP\()c(MAP1,)i(MAP2,)h
-(OPTIONS,)e(STATUS)h(\))0 497 y Fc(Argumen)m(ts:)259
-630 y(MAP1)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 729 y
-Fj(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f(comp)r(onen)n(t)g(Mapping,)h
-(whic)n(h)f(de\014nes)h(the)g(forw)n(ard)e(transformation.)259
-858 y Fc(MAP2)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 958
-y Fj(P)n(oin)n(ter)26 b(to)i(the)g(second)f(comp)r(onen)n(t)g(Mapping,)
-g(whic)n(h)h(de\014nes)f(the)h(in)n(v)n(erse)f(transformation.)259
-1087 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1187 y Fj(A)22 b(c)n(haracter)e
-(string)h(con)n(taining)g(an)h(optional)f(comma-separated)e(list)j(of)g
-(attribute)g(assignmen)n(ts)f(to)g(b)r(e)427 1286 y(used)j(for)g
-(initialising)g(the)g(new)g(T)-7 b(ranMap.)35 b(The)24
-b(syn)n(tax)f(used)h(is)g(iden)n(tical)g(to)g(that)g(for)g(the)g(AST)p
-Ft(_)p Fj(SET)427 1386 y(routine.)259 1515 y Fc(ST)-8
-b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-1615 y Fj(The)c(global)e(status.)0 1773 y Fc(Returned)32
-b(V)-8 b(alue:)259 1906 y(AST)p Ft(_)p Fc(TRANMAP)32
-b(=)g(INTEGER)427 2005 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(T)-7
-b(ranMap.)0 2164 y Fc(Notes:)340 2442 y Fi(\017)45 b
-Fj(The)36 b(n)n(um)n(b)r(er)g(of)g(output)h(co)r(ordinates)d(generated)
-h(b)n(y)h(the)g(t)n(w)n(o)f(Mappings)h(\(their)g(Nout)g(attribute\))427
-2542 y(m)n(ust)e(b)r(e)g(equal,)h(as)e(m)n(ust)h(the)g(n)n(um)n(b)r(er)
-f(of)h(input)g(co)r(ordinates)e(accepted)i(b)n(y)f(eac)n(h)g(Mapping)g
-(\(their)427 2642 y(Nin)28 b(attribute\).)340 2771 y
-Fi(\017)45 b Fj(The)28 b(forw)n(ard)e(transformation)g(of)h(the)h
-(\014rst)g(Mapping)f(m)n(ust)h(exist.)340 2900 y Fi(\017)45
+b(ranMap)28 b(w)n(as)227 4928 y(constructed.)0 5077 y
+Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_TRANMAP\()c(MAP1,)
+i(MAP2,)h(OPTIONS,)e(STATUS)h(\))0 5226 y Fc(Argumen)m(ts:)259
+5361 y(MAP1)32 b(=)g(INTEGER)f(\(Giv)m(en\))427 5461
+y Fj(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f(comp)r(onen)n(t)g
+(Mapping,)h(whic)n(h)f(de\014nes)h(the)g(forw)n(ard)e(transformation.)
+259 5593 y Fc(MAP2)32 b(=)g(INTEGER)f(\(Giv)m(en\))427
+5693 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(second)f(comp)r(onen)n(t)g
+(Mapping,)g(whic)n(h)h(de\014nes)f(the)h(in)n(v)n(erse)f
+(transformation.)p eop end
+%%Page: 396 406
+TeXDict begin 396 405 bop 0 52 a FG(396)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(OPTIONS)h(=)g(CHARA)m
+(CTER)g Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
+451 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)f
+(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r(e)
+427 551 y(used)j(for)g(initialising)g(the)g(new)g(T)-7
+b(ranMap.)35 b(The)24 b(syn)n(tax)f(used)h(is)g(iden)n(tical)g(to)g
+(that)g(for)g(the)g(AST)p Ft(_)p Fj(SET)427 650 y(routine.)259
+778 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 878 y Fj(The)c(global)e(status.)0 1035
+y Fc(Returned)32 b(V)-8 b(alue:)259 1167 y(AST)p Ft(_)p
+Fc(TRANMAP)32 b(=)g(INTEGER)427 1266 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)
+g(new)g(T)-7 b(ranMap.)0 1424 y Fc(Notes:)340 1701 y
+Fi(\017)45 b Fj(The)36 b(n)n(um)n(b)r(er)g(of)g(output)h(co)r
+(ordinates)d(generated)h(b)n(y)h(the)g(t)n(w)n(o)f(Mappings)h(\(their)g
+(Nout)g(attribute\))427 1801 y(m)n(ust)e(b)r(e)g(equal,)h(as)e(m)n(ust)
+h(the)g(n)n(um)n(b)r(er)f(of)h(input)g(co)r(ordinates)e(accepted)i(b)n
+(y)f(eac)n(h)g(Mapping)g(\(their)427 1901 y(Nin)28 b(attribute\).)340
+2029 y Fi(\017)45 b Fj(The)28 b(forw)n(ard)e(transformation)g(of)h(the)
+h(\014rst)g(Mapping)f(m)n(ust)h(exist.)340 2157 y Fi(\017)45
b Fj(The)28 b(in)n(v)n(erse)e(transformation)g(of)i(the)g(second)f
-(Mapping)g(m)n(ust)g(exist.)340 3029 y Fi(\017)45 b Fj(Note)31
+(Mapping)g(m)n(ust)g(exist.)340 2285 y Fi(\017)45 b Fj(Note)31
b(that)g(the)g(comp)r(onen)n(t)g(Mappings)f(supplied)h(are)e(not)i
(copied)g(b)n(y)f(AST)p Ft(_)p Fj(TRANMAP)h(\(the)h(new)427
-3129 y(T)-7 b(ranMap)40 b(simply)g(retains)g(a)g(reference)g(to)g
+2385 y(T)-7 b(ranMap)40 b(simply)g(retains)g(a)g(reference)g(to)g
(them\).)76 b(They)41 b(ma)n(y)f(con)n(tin)n(ue)g(to)g(b)r(e)h(used)f
-(for)g(other)427 3228 y(purp)r(oses,)i(but)f(should)f(not)g(b)r(e)g
+(for)g(other)427 2484 y(purp)r(oses,)i(but)f(should)f(not)g(b)r(e)g
(deleted.)74 b(If)40 b(a)g(T)-7 b(ranMap)39 b(con)n(taining)f(a)i(cop)n
-(y)f(of)h(its)g(comp)r(onen)n(t)427 3328 y(Mappings)27
+(y)f(of)h(its)g(comp)r(onen)n(t)427 2584 y(Mappings)27
b(is)h(required,)e(then)j(a)e(cop)n(y)f(of)i(the)g(T)-7
b(ranMap)27 b(should)g(b)r(e)h(made)f(using)h(AST)p Ft(_)p
-Fj(COPY.)340 3457 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+Fj(COPY.)340 2712 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 3557 y(set)28 b(to)f(an)h(error)d(v)-5
+b(A)g(TUS)427 2812 y(set)28 b(to)f(an)h(error)d(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)-2
-3715 y Fc(Status)33 b(Handling)n(:)227 3861 y Fj(The)d(protected)g(in)n
+2969 y Fc(Status)33 b(Handling)n(:)227 3115 y Fj(The)d(protected)g(in)n
(terface)f(to)g(this)h(function)h(includes)f(an)f(extra)g(parameter)f
-(at)i(the)g(end)g(of)g(the)g(parameter)227 3961 y(list)37
+(at)i(the)g(end)g(of)g(the)g(parameter)227 3214 y(list)37
b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)
r(oin)n(ter)g(to)h(the)g(in)n(teger)e(inherited)i(status)f(v)-5
-b(ariable:)54 b Ft(")p Fj(in)n(t)227 4060 y Fi(\003)p
-Fj(status)p Ft(")p Fj(.)p 0 4252 3780 12 v 0 4383 a FA(AST)p
-Fe(_)p FA(TRANN)1240 4384 y Fd(T)-10 b(ransform)37 b(N-dimensional)1598
-4483 y(co)s(ordinates)2942 4383 y FA(AST)p Fe(_)p FA(TRANN)0
-4642 y Fc(Description:)44 b Fj(This)39 b(routine)f(applies)h(a)f
+b(ariable:)54 b Ft(")p Fj(in)n(t)227 3314 y Fi(\003)p
+Fj(status)p Ft(")p Fj(.)p 0 3504 3780 12 v 0 3635 a FA(AST)p
+Fe(_)p FA(TRANN)1240 3636 y Fd(T)-10 b(ransform)37 b(N-dimensional)1598
+3735 y(co)s(ordinates)2942 3635 y FA(AST)p Fe(_)p FA(TRANN)0
+3891 y Fc(Description:)44 b Fj(This)39 b(routine)f(applies)h(a)f
(Mapping)h(to)f(transform)g(the)h(co)r(ordinates)e(of)i(a)g(set)f(of)h
-(p)r(oin)n(ts)g(in)g(an)227 4741 y(arbitrary)33 b(n)n(um)n(b)r(er)i(of)
+(p)r(oin)n(ts)g(in)g(an)227 3991 y(arbitrary)33 b(n)n(um)n(b)r(er)i(of)
h(dimensions.)59 b(It)36 b(is)f(the)h(appropriate)d(routine)i(to)g(use)
-g(if)h(the)g(co)r(ordinates)d(are)i(not)227 4841 y(purely)27
+g(if)h(the)g(co)r(ordinates)d(are)i(not)227 4091 y(purely)27
b(1-)g(or)g(2-dimensional)f(and)i(are)e(stored)h(in)h(a)f(single)g
(arra)n(y)e(\(whic)n(h)j(they)g(need)g(not)f(\014ll)h(completely\).)0
-4987 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_TRANN\()d(THIS,)j
+4235 y Fc(In)m(v)m(o)s(cation:)123 b Ft(CALL)42 b(AST_TRANN\()d(THIS,)j
(NPOINT,)e(NCOORD_IN,)g(INDIM,)h(IN,)h(FORWARD,)f(NCOORD_OUT,)e
-(OUTDIM,)227 5086 y(OUT,)j(STATUS)f(\))0 5232 y Fc(Argumen)m(ts:)259
-5365 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 5464
+(OUTDIM,)227 4335 y(OUT,)j(STATUS)f(\))0 4480 y Fc(Argumen)m(ts:)259
+4611 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 4711
y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Mapping)f(to)g(b)r(e)h(applied.)259
-5593 y Fc(NPOINT)k(=)g(INTEGER)f(\(Giv)m(en\))427 5693
+4839 y Fc(NPOINT)k(=)g(INTEGER)f(\(Giv)m(en\))427 4939
y Fj(The)d(n)n(um)n(b)r(er)f(of)h(p)r(oin)n(ts)f(to)h(b)r(e)g
-(transformed.)p eop end
-%%Page: 394 404
-TeXDict begin 394 403 bop 0 52 a FG(394)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(NCOORD)p
-Ft(_)p Fc(IN)f(=)i(INTEGER)g(\(Giv)m(en\))427 451 y Fj(The)22
-b(n)n(um)n(b)r(er)g(of)g(co)r(ordinates)f(b)r(eing)h(supplied)h(for)e
-(eac)n(h)h(input)h(p)r(oin)n(t)f(\(i.e.)35 b(the)23 b(n)n(um)n(b)r(er)f
-(of)g(dimensions)427 551 y(of)28 b(the)g(space)f(in)h(whic)n(h)f(the)h
-(input)g(p)r(oin)n(ts)g(reside\).)259 682 y Fc(INDIM)k(=)g(INTEGER)f
-(\(Giv)m(en\))427 782 y Fj(The)e(n)n(um)n(b)r(er)f(of)g(elemen)n(ts)g
-(along)f(the)i(\014rst)f(dimension)g(of)g(the)h(IN)f(arra)n(y)e(\(whic)
-n(h)j(con)n(tains)e(the)i(input)427 881 y(co)r(ordinates\).)37
+(transformed.)259 5067 y Fc(NCOORD)p Ft(_)p Fc(IN)i(=)i(INTEGER)g
+(\(Giv)m(en\))427 5166 y Fj(The)22 b(n)n(um)n(b)r(er)g(of)g(co)r
+(ordinates)f(b)r(eing)h(supplied)h(for)e(eac)n(h)h(input)h(p)r(oin)n(t)
+f(\(i.e.)35 b(the)23 b(n)n(um)n(b)r(er)f(of)g(dimensions)427
+5266 y(of)28 b(the)g(space)f(in)h(whic)n(h)f(the)h(input)g(p)r(oin)n
+(ts)g(reside\).)259 5394 y Fc(INDIM)k(=)g(INTEGER)f(\(Giv)m(en\))427
+5494 y Fj(The)e(n)n(um)n(b)r(er)f(of)g(elemen)n(ts)g(along)f(the)i
+(\014rst)f(dimension)g(of)g(the)h(IN)f(arra)n(y)e(\(whic)n(h)j(con)n
+(tains)e(the)i(input)427 5593 y(co)r(ordinates\).)37
b(This)28 b(v)-5 b(alue)28 b(is)g(required)f(so)h(that)g(the)g(co)r
(ordinate)f(v)-5 b(alues)28 b(can)f(b)r(e)i(correctly)d(lo)r(cated)i
-(if)427 981 y(they)g(do)f(not)h(en)n(tirely)f(\014ll)h(this)g(arra)n(y)
--7 b(.)34 b(The)28 b(v)-5 b(alue)28 b(giv)n(en)e(should)i(not)f(b)r(e)h
-(less)f(than)h(NPOINT.)259 1113 y Fc(IN\()k(INDIM,)f(NCOORD)p
-Ft(_)p Fc(IN)g(\))h(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427
-1212 y Fj(An)i(arra)n(y)d(con)n(taining)h(the)h(co)r(ordinates)f(of)h
-(the)g(input)h(\(un)n(transformed\))e(p)r(oin)n(ts.)51
-b(These)31 b(should)h(b)r(e)427 1312 y(stored)c(suc)n(h)f(that)i(the)f
-(v)-5 b(alue)28 b(of)g(co)r(ordinate)f(n)n(um)n(b)r(er)h(COORD)g(for)f
-(input)i(p)r(oin)n(t)f(n)n(um)n(b)r(er)g(POINT)g(is)427
-1411 y(found)g(in)g(elemen)n(t)g(IN\(POINT,COORD\).)259
-1543 y Fc(F)m(OR)-11 b(W)g(ARD)32 b(=)g(LOGICAL)h(\(Giv)m(en\))427
-1643 y Fj(A)38 b(.TR)n(UE.)e(v)-5 b(alue)37 b(indicates)g(that)h(the)f
+(if)427 5693 y(they)g(do)f(not)h(en)n(tirely)f(\014ll)h(this)g(arra)n
+(y)-7 b(.)34 b(The)28 b(v)-5 b(alue)28 b(giv)n(en)e(should)i(not)f(b)r
+(e)h(less)f(than)h(NPOINT.)p eop end
+%%Page: 397 407
+TeXDict begin 397 406 bop 3643 52 a FG(397)259 351 y
+Fc(IN\()32 b(INDIM,)f(NCOORD)p Ft(_)p Fc(IN)g(\))h(=)g(DOUBLE)g
+(PRECISION)f(\(Giv)m(en\))427 451 y Fj(An)i(arra)n(y)d(con)n(taining)h
+(the)h(co)r(ordinates)f(of)h(the)g(input)h(\(un)n(transformed\))e(p)r
+(oin)n(ts.)51 b(These)31 b(should)h(b)r(e)427 551 y(stored)c(suc)n(h)f
+(that)i(the)f(v)-5 b(alue)28 b(of)g(co)r(ordinate)f(n)n(um)n(b)r(er)h
+(COORD)g(for)f(input)i(p)r(oin)n(t)f(n)n(um)n(b)r(er)g(POINT)g(is)427
+650 y(found)g(in)g(elemen)n(t)g(IN\(POINT,COORD\).)259
+787 y Fc(F)m(OR)-11 b(W)g(ARD)32 b(=)g(LOGICAL)h(\(Giv)m(en\))427
+886 y Fj(A)38 b(.TR)n(UE.)e(v)-5 b(alue)37 b(indicates)g(that)h(the)f
(Mapping's)g(forw)n(ard)e(co)r(ordinate)h(transformation)f(is)i(to)g(b)
-r(e)427 1742 y(applied,)28 b(while)g(a)f(.F)-9 b(ALSE.)27
+r(e)427 986 y(applied,)28 b(while)g(a)f(.F)-9 b(ALSE.)27
b(v)-5 b(alue)28 b(indicates)f(that)h(the)g(in)n(v)n(erse)e
-(transformation)g(should)i(b)r(e)g(used.)259 1874 y Fc(NCOORD)p
-Ft(_)p Fc(OUT)j(=)h(INTEGER)f(\(Giv)m(en\))427 1974 y
+(transformation)g(should)i(b)r(e)g(used.)259 1123 y Fc(NCOORD)p
+Ft(_)p Fc(OUT)j(=)h(INTEGER)f(\(Giv)m(en\))427 1222 y
Fj(The)g(n)n(um)n(b)r(er)e(of)i(co)r(ordinates)d(b)r(eing)j(generated)e
(b)n(y)h(the)g(Mapping)g(for)g(eac)n(h)f(output)i(p)r(oin)n(t)f(\(i.e.)
-45 b(the)427 2073 y(n)n(um)n(b)r(er)28 b(of)g(dimensions)g(of)h(the)f
+45 b(the)427 1322 y(n)n(um)n(b)r(er)28 b(of)g(dimensions)g(of)h(the)f
(space)g(in)g(whic)n(h)h(the)f(output)h(p)r(oin)n(ts)f(reside\).)39
-b(This)28 b(need)g(not)h(b)r(e)f(the)427 2173 y(same)f(as)g(NCOORD)p
-Ft(_)p Fj(IN.)259 2304 y Fc(OUTDIM)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
-2404 y Fj(The)e(n)n(um)n(b)r(er)f(of)g(elemen)n(ts)h(along)e(the)i
+b(This)28 b(need)g(not)h(b)r(e)f(the)427 1422 y(same)f(as)g(NCOORD)p
+Ft(_)p Fj(IN.)259 1558 y Fc(OUTDIM)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
+1658 y Fj(The)e(n)n(um)n(b)r(er)f(of)g(elemen)n(ts)h(along)e(the)i
(\014rst)f(dimension)g(of)h(the)g(OUT)f(arra)n(y)e(\(whic)n(h)j(will)f
-(con)n(tain)g(the)427 2504 y(output)35 b(co)r(ordinates\).)56
+(con)n(tain)g(the)427 1758 y(output)35 b(co)r(ordinates\).)56
b(This)34 b(v)-5 b(alue)34 b(is)g(required)f(so)h(that)g(the)h(co)r
(ordinate)e(v)-5 b(alues)34 b(can)g(b)r(e)g(correctly)427
-2603 y(lo)r(cated)40 b(if)h(they)f(will)h(not)f(en)n(tirely)g(\014ll)g
+1857 y(lo)r(cated)40 b(if)h(they)f(will)h(not)f(en)n(tirely)g(\014ll)g
(this)h(arra)n(y)-7 b(.)72 b(The)40 b(v)-5 b(alue)41
-b(giv)n(en)e(should)h(not)g(b)r(e)h(less)e(than)427 2703
-y(NPOINT.)259 2835 y Fc(OUT\()33 b(OUTDIM,)f(NCOORD)p
+b(giv)n(en)e(should)h(not)g(b)r(e)h(less)e(than)427 1957
+y(NPOINT.)259 2094 y Fc(OUT\()33 b(OUTDIM,)f(NCOORD)p
Ft(_)p Fc(OUT)f(\))h(=)g(DOUBLE)g(PRECISION)f(\(Returned\))427
-2934 y Fj(An)22 b(arra)n(y)d(in)n(to)i(whic)n(h)g(the)h(co)r(ordinates)
+2193 y Fj(An)22 b(arra)n(y)d(in)n(to)i(whic)n(h)g(the)h(co)r(ordinates)
d(of)j(the)f(output)h(\(transformed\))f(p)r(oin)n(ts)g(will)g(b)r(e)h
-(written.)35 b(These)427 3034 y(will)e(b)r(e)g(stored)f(suc)n(h)g(that)
+(written.)35 b(These)427 2293 y(will)e(b)r(e)g(stored)f(suc)n(h)g(that)
h(the)g(v)-5 b(alue)33 b(of)f(co)r(ordinate)g(n)n(um)n(b)r(er)g(COORD)h
-(for)f(output)h(p)r(oin)n(t)g(n)n(um)n(b)r(er)427 3133
+(for)f(output)h(p)r(oin)n(t)g(n)n(um)n(b)r(er)427 2392
y(POINT)27 b(will)h(b)r(e)g(found)g(in)g(elemen)n(t)g
-(OUT\(POINT,COORD\).)259 3265 y Fc(ST)-8 b(A)g(TUS)34
-b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 3365
-y Fj(The)c(global)e(status.)0 3525 y Fc(Notes:)340 3807
+(OUT\(POINT,COORD\).)259 2529 y Fc(ST)-8 b(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 2629
+y Fj(The)c(global)e(status.)0 2798 y Fc(Notes:)340 3089
y Fi(\017)45 b Fj(If)31 b(the)g(forw)n(ard)e(co)r(ordinate)h
(transformation)f(is)h(b)r(eing)h(applied,)h(the)f(Mapping)f(supplied)h
-(m)n(ust)g(ha)n(v)n(e)427 3906 y(the)24 b(v)-5 b(alue)23
+(m)n(ust)g(ha)n(v)n(e)427 3188 y(the)24 b(v)-5 b(alue)23
b(of)g(NCOORD)p Ft(_)p Fj(IN)h(for)e(its)i(Nin)g(attribute)f(and)g(the)
h(v)-5 b(alue)23 b(of)g(NCOORD)p Ft(_)p Fj(OUT)g(for)g(its)g(Nout)427
-4006 y(attribute.)37 b(If)28 b(the)g(in)n(v)n(erse)e(transformation)g
+3288 y(attribute.)37 b(If)28 b(the)g(in)n(v)n(erse)e(transformation)g
(is)i(b)r(eing)g(applied,)f(these)h(v)-5 b(alues)27 b(should)g(b)r(e)h
-(rev)n(ersed.)p 0 4203 3780 12 v 0 4333 a FA(AST)p Fe(_)p
-FA(TUNE)874 4334 y Fd(Set)37 b(or)g(get)g(an)h(in)m(teger-v)-7
-b(alued)35 b(AST)i(global)1444 4445 y(tuning)h(parameter)3058
-4333 y FA(AST)p Fe(_)p FA(TUNE)0 4632 y Fc(Description:)44
+(rev)n(ersed.)p 0 3495 3780 12 v 0 3625 a FA(AST)p Fe(_)p
+FA(TUNE)874 3626 y Fd(Set)37 b(or)g(get)g(an)h(in)m(teger-v)-7
+b(alued)35 b(AST)i(global)1444 3737 y(tuning)h(parameter)3058
+3625 y FA(AST)p Fe(_)p FA(TUNE)0 3934 y Fc(Description:)44
b Fj(This)23 b(function)g(returns)f(the)g(curren)n(t)g(v)-5
b(alue)22 b(of)h(an)f(in)n(teger-v)-5 b(alued)21 b(AST)i(global)e
-(tuning)i(parameter,)227 4731 y(optionally)37 b(storing)f(a)g(new)i(v)
+(tuning)i(parameter,)227 4034 y(optionally)37 b(storing)f(a)g(new)i(v)
-5 b(alue)37 b(for)f(the)i(parameter.)64 b(F)-7 b(or)37
b(c)n(haracter-v)-5 b(alued)35 b(tuning)i(parameters,)h(see)227
-4831 y(AST)p Ft(_)p Fj(TUNEC.)0 4979 y Fc(In)m(v)m(o)s(cation:)123
+4133 y(AST)p Ft(_)p Fj(TUNEC.)0 4290 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_TUNE\()d(NAME,)h(VALUE,)h(STATUS)f(\))0
-5127 y Fc(Argumen)m(ts:)259 5263 y(NAME)31 b(=)h(CHARA)m(CTER)g
+4447 y Fc(Argumen)m(ts:)259 4592 y(NAME)31 b(=)h(CHARA)m(CTER)g
Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-5362 y Fj(The)c(name)f(of)h(the)g(tuning)g(parameter)e
-(\(case-insensitiv)n(e\).)259 5494 y Fc(V)-11 b(ALUE)33
-b(=)f(INTEGER)g(\(Giv)m(en\))427 5593 y Fj(The)22 b(new)g(v)-5
+4691 y Fj(The)c(name)f(of)h(the)g(tuning)g(parameter)e
+(\(case-insensitiv)n(e\).)259 4828 y Fc(V)-11 b(ALUE)33
+b(=)f(INTEGER)g(\(Giv)m(en\))427 4928 y Fj(The)22 b(new)g(v)-5
b(alue)22 b(for)f(the)h(tuning)g(parameter.)34 b(If)22
b(this)g(is)g(AST)p Ft(__)p Fj(TUNULL,)g(the)g(existing)g(curren)n(t)f
-(v)-5 b(alue)427 5693 y(will)28 b(b)r(e)g(retained.)p
+(v)-5 b(alue)427 5027 y(will)28 b(b)r(e)g(retained.)259
+5164 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 5264 y Fj(The)c(global)e(status.)0 5433
+y Fc(Returned)32 b(V)-8 b(alue:)259 5577 y(AST)p Ft(_)p
+Fc(TUNE)32 b(=)h(INTEGER)427 5677 y Fj(b)r(e)28 b(returned)f(if)i(no)e
+(v)-5 b(alue)27 b(has)g(b)r(een)h(set)g(for)f(the)h(parameter.)p
eop end
-%%Page: 395 405
-TeXDict begin 395 404 bop 3643 52 a FG(395)259 351 y
-Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-451 y Fj(The)c(global)e(status.)0 617 y Fc(Returned)32
-b(V)-8 b(alue:)259 758 y(AST)p Ft(_)p Fc(TUNE)32 b(=)h(INTEGER)427
-858 y Fj(b)r(e)28 b(returned)f(if)i(no)e(v)-5 b(alue)27
-b(has)g(b)r(een)h(set)g(for)f(the)h(parameter.)0 1024
-y Fc(Notes:)340 1311 y Fi(\017)45 b Fj(This)28 b(routine)f(attempts)g
-(to)h(execute)f(ev)n(en)g(if)g(ST)-7 b(A)g(TUS)29 b(is)e(set)g(to)h(an)
-f(error)e(v)-5 b(alue)27 b(on)g(en)n(try)-7 b(,)27 b(although)427
-1411 y(no)h(further)f(error)f(rep)r(ort)h(will)g(b)r(e)h(made)g(if)g
-(it)g(subsequen)n(tly)f(fails)g(under)h(these)g(circumstances.)340
-1546 y Fi(\017)45 b Fj(All)28 b(threads)f(in)h(a)f(pro)r(cess)g(share)f
+%%Page: 398 408
+TeXDict begin 398 407 bop 0 52 a FG(398)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Notes:)340
+637 y Fi(\017)45 b Fj(This)28 b(routine)f(attempts)g(to)h(execute)f(ev)
+n(en)g(if)g(ST)-7 b(A)g(TUS)29 b(is)e(set)g(to)h(an)f(error)e(v)-5
+b(alue)27 b(on)g(en)n(try)-7 b(,)27 b(although)427 737
+y(no)h(further)f(error)f(rep)r(ort)h(will)g(b)r(e)h(made)g(if)g(it)g
+(subsequen)n(tly)f(fails)g(under)h(these)g(circumstances.)340
+871 y Fi(\017)45 b Fj(All)28 b(threads)f(in)h(a)f(pro)r(cess)g(share)f
(the)i(same)f(AST)h(tuning)g(parameters)e(v)-5 b(alues.)32
-1712 y Fc(T)d(uning)31 b(P)m(arameters)i(:)259 1853 y(Ob)5
-b(jectCac)m(hing)427 1953 y Fj(A)38 b(b)r(o)r(olean)f(\015ag)g(whic)n
+1036 y Fc(T)d(uning)31 b(P)m(arameters)i(:)259 1176 y(Ob)5
+b(jectCac)m(hing)427 1276 y Fj(A)38 b(b)r(o)r(olean)f(\015ag)g(whic)n
(h)h(indicates)f(what)h(should)f(happ)r(en)h(to)g(the)g(memory)f(o)r
-(ccupied)g(b)n(y)h(an)f(AST)427 2052 y(Ob)5 b(ject)28
+(ccupied)g(b)n(y)h(an)f(AST)427 1375 y(Ob)5 b(ject)28
b(when)h(the)f(Ob)5 b(ject)29 b(is)f(deleted)g(\(i.e.)40
b(when)28 b(its)g(reference)g(coun)n(t)g(falls)g(to)g(zero)f(or)g(it)i
-(is)f(deleted)427 2152 y(using)k(AST)p Ft(_)p Fj(DELETE\).)f(If)h(this)
+(is)f(deleted)427 1475 y(using)k(AST)p Ft(_)p Fj(DELETE\).)f(If)h(this)
h(is)f(zero,)g(the)g(memory)f(is)h(simply)g(freed)g(using)g(the)g
-(systems)g Ft(")p Fj(free)p Ft(")427 2251 y Fj(function.)37
+(systems)g Ft(")p Fj(free)p Ft(")427 1575 y Fj(function.)37
b(If)26 b(it)g(is)f(non-zero,)g(the)g(memory)g(is)h(not)f(freed.)36
b(Instead)25 b(a)g(p)r(oin)n(ter)h(to)f(it)h(is)f(stored)g(in)h(a)f(p)r
-(o)r(ol)427 2351 y(of)i(suc)n(h)g(p)r(oin)n(ters,)g(all)g(of)g(whic)n
+(o)r(ol)427 1674 y(of)i(suc)n(h)g(p)r(oin)n(ters,)g(all)g(of)g(whic)n
(h)g(refer)f(to)h(allo)r(cated)f(but)i(curren)n(tly)e(un)n(used)h(blo)r
-(c)n(ks)g(of)g(memory)-7 b(.)36 b(This)427 2451 y(allo)n(ws)24
+(c)n(ks)g(of)g(memory)-7 b(.)36 b(This)427 1774 y(allo)n(ws)24
b(AST)h(to)g(sp)r(eed)g(up)g(subsequen)n(t)g(Ob)5 b(ject)25
b(creation)e(b)n(y)i(re-using)f(previously)f(allo)r(cated)h(memory)427
-2550 y(blo)r(c)n(ks)32 b(rather)g(than)h(allo)r(cating)e(new)i(memory)f
+1873 y(blo)r(c)n(ks)32 b(rather)g(than)h(allo)r(cating)e(new)i(memory)f
(using)h(the)g(systems)f(mallo)r(c)g(function.)53 b(The)33
-b(default)427 2650 y(v)-5 b(alue)29 b(for)f(this)h(parameter)e(is)h
+b(default)427 1973 y(v)-5 b(alue)29 b(for)f(this)h(parameter)e(is)h
(zero.)39 b(Setting)28 b(it)h(to)g(a)f(non-zero)f(v)-5
b(alue)28 b(will)h(result)f(in)h(Ob)5 b(ject)28 b(memory)427
-2750 y(b)r(eing)33 b(cac)n(hed)g(in)g(future.)53 b(Setting)33
+2073 y(b)r(eing)33 b(cac)n(hed)g(in)g(future.)53 b(Setting)33
b(it)h(bac)n(k)e(to)h(zero)f(causes)g(an)n(y)g(memory)g(blo)r(c)n(ks)g
-(curren)n(tly)g(in)h(the)427 2849 y(p)r(o)r(ol)e(to)g(b)r(e)g(freed.)47
+(curren)n(tly)g(in)h(the)427 2172 y(p)r(o)r(ol)e(to)g(b)r(e)g(freed.)47
b(Note,)31 b(this)h(tuning)f(parameter)e(only)i(con)n(trols)e(the)i
-(cac)n(hing)f(of)h(memory)f(used)h(to)427 2949 y(store)c(AST)h(Ob)5
+(cac)n(hing)f(of)h(memory)f(used)h(to)427 2272 y(store)c(AST)h(Ob)5
b(jects.)36 b(T)-7 b(o)28 b(cac)n(he)e(other)h(memory)g(blo)r(c)n(ks)g
(allo)r(cated)g(b)n(y)g(AST,)h(use)g(MemoryCac)n(hing.)259
-3084 y Fc(MemoryCac)m(hing)427 3184 y Fj(A)e(b)r(o)r(olean)f(\015ag)f
+2406 y Fc(MemoryCac)m(hing)427 2506 y Fj(A)e(b)r(o)r(olean)f(\015ag)f
(similar)g(to)i(Ob)5 b(jectCac)n(hing)24 b(except)h(that)g(it)h(con)n
(trols)e(cac)n(hing)g(of)h(all)g(memory)f(blo)r(c)n(ks)427
-3283 y(of)40 b(less)f(than)h(300)f(b)n(ytes)g(allo)r(cated)h(b)n(y)f
+2606 y(of)40 b(less)f(than)h(300)f(b)n(ytes)g(allo)r(cated)h(b)n(y)f
(AST)h(\(whether)g(for)g(in)n(ternal)f(or)g(external)g(use\),)k(not)d
-(just)427 3383 y(memory)27 b(used)h(to)f(store)g(AST)h(Ob)5
-b(jects.)p 0 3586 3780 12 v 0 3717 a FA(AST)p Fe(_)p
-FA(TUNEC)1013 3718 y Fd(Set)39 b(or)f(get)g(a)h(c)m(haracter-v)-7
-b(alued)36 b(AST)1272 3833 y(global)h(tuning)g(parameter)2961
-3717 y FA(AST)p Fe(_)p FA(TUNEC)0 4026 y Fc(Description:)44
+(just)427 2705 y(memory)27 b(used)h(to)f(store)g(AST)h(Ob)5
+b(jects.)p 0 2908 3780 12 v 0 3039 a FA(AST)p Fe(_)p
+FA(TUNEC)1013 3040 y Fd(Set)39 b(or)f(get)g(a)h(c)m(haracter-v)-7
+b(alued)36 b(AST)1272 3154 y(global)h(tuning)g(parameter)2961
+3039 y FA(AST)p Fe(_)p FA(TUNEC)0 3346 y Fc(Description:)44
b Fj(This)30 b(function)h(returns)f(the)g(curren)n(t)f(v)-5
b(alue)30 b(of)h(a)e(c)n(haracter-v)-5 b(alued)28 b(AST)j(global)e
-(tuning)h(param-)227 4126 y(eter,)g(optionally)f(storing)g(a)h(new)g(v)
+(tuning)h(param-)227 3446 y(eter,)g(optionally)f(storing)g(a)h(new)g(v)
-5 b(alue)29 b(for)h(the)g(parameter.)42 b(F)-7 b(or)29
b(in)n(teger-v)-5 b(alued)29 b(tuning)h(parameters,)f(see)227
-4225 y(AST)p Ft(_)p Fj(TUNE.)0 4379 y Fc(In)m(v)m(o)s(cation:)123
+3545 y(AST)p Ft(_)p Fj(TUNE.)0 3698 y Fc(In)m(v)m(o)s(cation:)123
b Ft(CALL)42 b(AST_TUNEC\()d(NAME,)j(VALUE,)f(BUFF,)g(STATUS)g(\))0
-4533 y Fc(Argumen)m(ts:)259 4674 y(NAME)31 b(=)h(CHARA)m(CTER)g
+3851 y Fc(Argumen)m(ts:)259 3991 y(NAME)31 b(=)h(CHARA)m(CTER)g
Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-4774 y Fj(The)c(name)f(of)h(the)g(tuning)g(parameter)e
-(\(case-insensitiv)n(e\).)259 4909 y Fc(V)-11 b(ALUE)33
+4090 y Fj(The)c(name)f(of)h(the)g(tuning)g(parameter)e
+(\(case-insensitiv)n(e\).)259 4225 y Fc(V)-11 b(ALUE)33
b(=)f(CHARA)m(CTER)g Fi(\003)f Fc(\()h(\))g(\(Giv)m(en\))427
-5008 y Fj(The)h(new)g(v)-5 b(alue)33 b(for)f(the)h(tuning)g(parameter.)
+4324 y Fj(The)h(new)g(v)-5 b(alue)33 b(for)f(the)h(tuning)g(parameter.)
51 b(If)33 b(this)g(is)g(AST)p Ft(__)p Fj(TUNULLC,)g(the)g(existing)f
-(curren)n(t)427 5108 y(v)-5 b(alue)28 b(will)g(b)r(e)g(retained.)259
-5243 y Fc(BUFF)k(=)h(CHARA)m(CTER)e Fi(\003)g Fc(\()h(\))g(\(Giv)m
-(en\))427 5343 y Fj(A)h(c)n(haracter)d(string)h(in)h(whic)n(h)g(to)g
+(curren)n(t)427 4424 y(v)-5 b(alue)28 b(will)g(b)r(e)g(retained.)259
+4558 y Fc(BUFF)k(=)h(CHARA)m(CTER)e Fi(\003)g Fc(\()h(\))g(\(Giv)m
+(en\))427 4658 y Fj(A)h(c)n(haracter)d(string)h(in)h(whic)n(h)g(to)g
(return)f(the)i(original)d(v)-5 b(alue)32 b(of)g(the)g(tuning)h
-(parameter.)48 b(An)33 b(error)427 5442 y(will)28 b(b)r(e)g(rep)r
+(parameter.)48 b(An)33 b(error)427 4758 y(will)28 b(b)r(e)g(rep)r
(orted)f(if)h(the)g(bu\013er)g(is)f(to)r(o)h(small)f(to)g(hold)h(the)g
-(v)-5 b(alue.)259 5577 y Fc(ST)d(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)
-h(and)g(Returned\))427 5677 y Fj(The)c(global)e(status.)p
-eop end
-%%Page: 396 406
-TeXDict begin 396 405 bop 0 52 a FG(396)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Notes:)340
-637 y Fi(\017)45 b Fj(This)28 b(routine)f(attempts)g(to)h(execute)f(ev)
-n(en)g(if)g(ST)-7 b(A)g(TUS)29 b(is)e(set)g(to)h(an)f(error)e(v)-5
-b(alue)27 b(on)g(en)n(try)-7 b(,)27 b(although)427 737
-y(no)h(further)f(error)f(rep)r(ort)h(will)g(b)r(e)h(made)g(if)g(it)g
-(subsequen)n(tly)f(fails)g(under)h(these)g(circumstances.)340
-871 y Fi(\017)45 b Fj(All)28 b(threads)f(in)h(a)f(pro)r(cess)g(share)f
-(the)i(same)f(AST)h(tuning)g(parameters)e(v)-5 b(alues.)32
-1037 y Fc(T)d(uning)31 b(P)m(arameters)i(:)259 1176 y(HRDel)427
-1276 y Fj(A)26 b(string)f(to)g(b)r(e)h(dra)n(wn)e(follo)n(wing)g(the)i
+(v)-5 b(alue.)259 4892 y Fc(ST)d(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)
+h(and)g(Returned\))427 4992 y Fj(The)c(global)e(status.)0
+5157 y Fc(Notes:)340 5443 y Fi(\017)45 b Fj(This)28 b(routine)f
+(attempts)g(to)h(execute)f(ev)n(en)g(if)g(ST)-7 b(A)g(TUS)29
+b(is)e(set)g(to)h(an)f(error)e(v)-5 b(alue)27 b(on)g(en)n(try)-7
+b(,)27 b(although)427 5542 y(no)h(further)f(error)f(rep)r(ort)h(will)g
+(b)r(e)h(made)g(if)g(it)g(subsequen)n(tly)f(fails)g(under)h(these)g
+(circumstances.)340 5677 y Fi(\017)45 b Fj(All)28 b(threads)f(in)h(a)f
+(pro)r(cess)g(share)f(the)i(same)f(AST)h(tuning)g(parameters)e(v)-5
+b(alues.)p eop end
+%%Page: 399 409
+TeXDict begin 399 408 bop 3643 52 a FG(399)32 351 y Fc(T)-8
+b(uning)31 b(P)m(arameters)i(:)259 487 y(HRDel)427 587
+y Fj(A)26 b(string)f(to)g(b)r(e)h(dra)n(wn)e(follo)n(wing)g(the)i
(hours)f(\014eld)g(in)h(a)f(formatted)g(sky)g(axis)f(v)-5
b(alue)25 b(when)h Ft(")p Fj(g)p Ft(")e Fj(format)427
-1376 y(is)34 b(in)f(use)g(\(see)h(the)f(F)-7 b(ormat)33
+686 y(is)34 b(in)f(use)g(\(see)h(the)f(F)-7 b(ormat)33
b(attribute\).)55 b(This)33 b(string)g(ma)n(y)g(include)g(escap)r(e)g
-(sequences)g(to)g(pro)r(duce)427 1475 y(sup)r(er-scripts,)k(etc.)60
+(sequences)g(to)g(pro)r(duce)427 786 y(sup)r(er-scripts,)k(etc.)60
b(\(see)36 b(the)g(Escap)r(es)e(attribute)i(for)e(details)i(of)f(the)h
-(escap)r(e)f(sequences)g(allo)n(w)n(ed\).)427 1575 y(The)28
+(escap)r(e)f(sequences)g(allo)n(w)n(ed\).)427 886 y(The)28
b(default)g(v)-5 b(alue)27 b(is)h Ft(")p Fj(\045-\045)p
Fi(^)p Fj(50+\045s70+h\045+)p Ft(")c Fj(whic)n(h)k(pro)r(duces)f(a)g
-(sup)r(er-script)g Ft(")p Fj(h)p Ft(")p Fj(.)259 1709
-y Fc(MNDel)427 1809 y Fj(A)37 b(string)f(to)h(b)r(e)g(dra)n(wn)f(follo)
+(sup)r(er-script)g Ft(")p Fj(h)p Ft(")p Fj(.)259 1018
+y Fc(MNDel)427 1118 y Fj(A)37 b(string)f(to)h(b)r(e)g(dra)n(wn)f(follo)
n(wing)g(the)h(min)n(utes)g(\014eld)g(in)g(a)f(formatted)h(sky)f(axis)g
-(v)-5 b(alue)37 b(when)g Ft(")p Fj(g)p Ft(")427 1909
+(v)-5 b(alue)37 b(when)g Ft(")p Fj(g)p Ft(")427 1217
y Fj(format)24 b(is)f(in)i(use.)35 b(The)24 b(default)h(v)-5
b(alue)23 b(is)h Ft(")p Fj(\045-\045)p Fi(^)p Fj(50+\045s70+m\045+)p
Ft(")d Fj(whic)n(h)j(pro)r(duces)f(a)h(sup)r(er-script)427
-2008 y Ft(")p Fj(m)p Ft(")p Fj(.)259 2143 y Fc(SCDel)427
-2242 y Fj(A)e(string)e(to)h(b)r(e)g(dra)n(wn)f(follo)n(wing)g(the)i
+1317 y Ft(")p Fj(m)p Ft(")p Fj(.)259 1449 y Fc(SCDel)427
+1549 y Fj(A)e(string)e(to)h(b)r(e)g(dra)n(wn)f(follo)n(wing)g(the)i
(seconds)e(\014eld)h(in)g(a)g(formatted)g(sky)f(axis)g(v)-5
b(alue)21 b(when)g Ft(")p Fj(g)p Ft(")f Fj(format)427
-2342 y(is)28 b(in)g(use.)36 b(The)28 b(default)g(v)-5
+1649 y(is)28 b(in)g(use.)36 b(The)28 b(default)g(v)-5
b(alue)28 b(is)f Ft(")p Fj(\045-\045)p Fi(^)p Fj(50+\045s70+s\045+)p
Ft(")d Fj(whic)n(h)j(pro)r(duces)g(a)h(sup)r(er-script)e
-Ft(")p Fj(s)p Ft(")p Fj(.)259 2476 y Fc(DGDel)427 2576
+Ft(")p Fj(s)p Ft(")p Fj(.)259 1781 y Fc(DGDel)427 1881
y Fj(A)c(string)f(to)g(b)r(e)h(dra)n(wn)f(follo)n(wing)g(the)g(degrees)
g(\014eld)h(in)f(a)h(formatted)f(sky)g(axis)g(v)-5 b(alue)21
-b(when)h Ft(")p Fj(g)p Ft(")e Fj(format)427 2676 y(is)28
+b(when)h Ft(")p Fj(g)p Ft(")e Fj(format)427 1980 y(is)28
b(in)g(use.)36 b(The)28 b(default)g(v)-5 b(alue)28 b(is)f
Ft(")p Fj(\045-\045)p Fi(^)p Fj(53+\045s60+o\045+)p Ft(")d
Fj(whic)n(h)j(pro)r(duces)g(a)g(sup)r(er-script)g Ft(")p
-Fj(o)p Ft(")p Fj(.)259 2810 y Fc(AMDel)427 2910 y Fj(A)i(string)e(to)h
+Fj(o)p Ft(")p Fj(.)259 2113 y Fc(AMDel)427 2212 y Fj(A)i(string)e(to)h
(b)r(e)h(dra)n(wn)e(follo)n(wing)g(the)h(arc-min)n(utes)f(\014eld)i(in)
f(a)g(formatted)g(sky)f(axis)h(v)-5 b(alue)28 b(when)g
-Ft(")p Fj(g)p Ft(")427 3010 y Fj(format)g(is)f(in)i(use.)37
+Ft(")p Fj(g)p Ft(")427 2312 y Fj(format)g(is)f(in)i(use.)37
b(The)28 b(default)h(v)-5 b(alue)28 b(is)f Ft(")p Fj(\045-\045)p
Fi(^)p Fj(20+\045s85+'\045+)p Ft(")e Fj(whic)n(h)j(pro)r(duces)f(a)h
-(sup)r(er-script)427 3109 y Ft(")p Fj(')p Ft(")f Fj(\(single)h
-(quote\).)259 3244 y Fc(ASDel)427 3343 y Fj(A)h(string)g(to)f(b)r(e)h
+(sup)r(er-script)427 2411 y Ft(")p Fj(')p Ft(")f Fj(\(single)h
+(quote\).)259 2544 y Fc(ASDel)427 2644 y Fj(A)h(string)g(to)f(b)r(e)h
(dra)n(wn)f(follo)n(wing)g(the)h(arc-seconds)e(\014eld)i(in)g(a)f
(formatted)h(sky)f(axis)g(v)-5 b(alue)29 b(when)g Ft(")p
-Fj(g)p Ft(")427 3443 y Fj(format)22 b(is)h(in)f(use.)36
+Fj(g)p Ft(")427 2743 y Fj(format)22 b(is)h(in)f(use.)36
b(The)22 b(default)h(v)-5 b(alue)22 b(is)h Ft(")p Fj(\045-\045)p
Fi(^)p Fj(20+\045s85+)p Fi(n)p Ft(")p Fj(\045+)p Ft(")18
b Fj(whic)n(h)23 b(pro)r(duces)e(a)i(sup)r(er-script)427
-3543 y Ft(""")k Fj(\(double)h(quote\).)259 3677 y Fc(EXDel)427
-3777 y Fj(A)k(string)e(to)h(b)r(e)g(dra)n(wn)f(to)h(in)n(tro)r(duce)f
+2843 y Ft(""")k Fj(\(double)h(quote\).)259 2975 y Fc(EXDel)427
+3075 y Fj(A)k(string)e(to)h(b)r(e)g(dra)n(wn)f(to)h(in)n(tro)r(duce)f
(the)h(exp)r(onen)n(t)g(in)g(a)g(v)-5 b(alue)31 b(when)g
Ft(")p Fj(g)p Ft(")e Fj(format)i(is)g(in)g(use.)47 b(The)427
-3876 y(default)36 b(v)-5 b(alue)36 b(is)f Ft(")p Fj(10\045-\045)p
+3174 y(default)36 b(v)-5 b(alue)36 b(is)f Ft(")p Fj(10\045-\045)p
Fi(^)p Fj(50+\045s70+)p Ft(")c Fj(whic)n(h)36 b(pro)r(duces)f
Ft(")p Fj(10)p Ft(")e Fj(follo)n(w)n(ed)i(b)n(y)g(the)h(exp)r(onen)n(t)
-f(as)g(a)427 3976 y(sup)r(er-script.)p 0 4179 3780 12
-v 0 4309 a FA(AST)p Fe(_)p FA(UINTERP)1435 4310 y Fd(P)m(erform)h
-(sub-pixel)1116 4425 y(in)m(terp)s(olation)d(on)j(a)h(grid)f(of)g(data)
-2816 4309 y FA(AST)p Fe(_)p FA(UINTERP)0 4617 y Fc(Description:)44
+f(as)g(a)427 3274 y(sup)r(er-script.)p 0 3472 3780 12
+v 0 3603 a FA(AST)p Fe(_)p FA(UINTERP)1435 3604 y Fd(P)m(erform)h
+(sub-pixel)1116 3719 y(in)m(terp)s(olation)d(on)j(a)h(grid)f(of)g(data)
+2816 3603 y FA(AST)p Fe(_)p FA(UINTERP)0 3907 y Fc(Description:)44
b Fj(This)33 b(is)g(a)g(\014ctitious)g(routine)g(whic)n(h)g(do)r(es)g
(not)g(actually)g(exist.)53 b(Instead,)34 b(this)g(description)e(con-)
-227 4717 y(stitutes)40 b(a)e(template)i(so)e(that)h(y)n(ou)f(ma)n(y)h
+227 4006 y(stitutes)40 b(a)e(template)i(so)e(that)h(y)n(ou)f(ma)n(y)h
(implemen)n(t)g(a)g(routine)f(with)i(this)f(in)n(terface)f(for)h(y)n
-(ourself)e(\(and)227 4816 y(giv)n(e)d(it)g(an)n(y)g(name)g(y)n(ou)g
+(ourself)e(\(and)227 4106 y(giv)n(e)d(it)g(an)n(y)g(name)g(y)n(ou)g
(wish\).)57 b(Suc)n(h)34 b(a)g(routine)g(ma)n(y)g(b)r(e)h(passed)e(via)
-h(the)h(FINTERP)f(argumen)n(t)f(of)h(the)227 4916 y(AST)p
+h(the)h(FINTERP)f(argumen)n(t)f(of)h(the)227 4205 y(AST)p
Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)24 b Fj(functions)i(\(q.v.\))37
b(in)25 b(order)g(to)g(p)r(erform)g(sub-pixel)g(in)n(terp)r(olation)g
-(during)g(resam-)227 5015 y(pling)i(of)g(gridded)g(data)f(\(y)n(ou)h(m)
+(during)g(resam-)227 4305 y(pling)i(of)g(gridded)g(data)f(\(y)n(ou)h(m)
n(ust)g(also)f(set)h(the)g(INTERP)g(argumen)n(t)f(of)h(AST)p
Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)e Fj(to)i(the)227
-5115 y(v)-5 b(alue)31 b(AST)p Ft(__)p Fj(UINTERP\).)f(This)h(allo)n(ws)
+4405 y(v)-5 b(alue)31 b(AST)p Ft(__)p Fj(UINTERP\).)f(This)h(allo)n(ws)
e(y)n(ou)h(to)g(use)h(y)n(our)e(o)n(wn)h(in)n(terp)r(olation)g
-(algorithm)f(in)i(addition)g(to)227 5215 y(those)d(whic)n(h)f(are)g
-(pre-de\014ned.)227 5341 y(The)38 b(routine)f(in)n(terp)r(olates)f(an)h
+(algorithm)f(in)i(addition)g(to)227 4504 y(those)d(whic)n(h)f(are)g
+(pre-de\014ned.)227 4629 y(The)38 b(routine)f(in)n(terp)r(olates)f(an)h
(input)i(grid)d(of)i(data)f(\(and,)j(optionally)-7 b(,)39
-b(pro)r(cesses)d(asso)r(ciated)g(statistical)227 5441
+b(pro)r(cesses)d(asso)r(ciated)g(statistical)227 4728
y(v)-5 b(ariance)27 b(estimates\))g(at)h(a)f(sp)r(eci\014ed)h(set)f(of)
-h(p)r(oin)n(ts.)0 5593 y Fc(In)m(v)m(o)s(cation:)123
+h(p)r(oin)n(ts.)0 4877 y Fc(In)m(v)m(o)s(cation:)123
b Ft(CALL)42 b(AST_UINTERP\()c(NDIM_IN,)j(LBND_IN,)f(UBND_IN,)g(IN,)i
-(IN_VAR,)f(NPOINT,)g(OFFSET,)g(COORDS,)227 5693 y(PARAMS,)g(FLAGS,)g
-(BADVAL,)g(OUT,)h(OUT_VAR,)e(NBAD,)h(STATUS)h(\))p eop
-end
-%%Page: 397 407
-TeXDict begin 397 406 bop 3643 52 a FG(397)0 351 y Fc(Argumen)m(ts:)259
-494 y(NDIM)p Ft(_)p Fc(IN)31 b(=)h(INTEGER)g(\(Giv)m(en\))427
-593 y Fj(The)c(n)n(um)n(b)r(er)f(of)h(dimensions)f(in)h(the)g(input)g
-(grid.)36 b(This)28 b(will)g(b)r(e)g(at)f(least)h(one.)259
-729 y Fc(LBND)p Ft(_)p Fc(IN\()k(NDIM)p Ft(_)p Fc(IN)f(\))h(=)g
-(INTEGER)f(\(Giv)m(en\))427 829 y Fj(An)j(arra)n(y)d(con)n(taining)h
-(the)i(co)r(ordinates)e(of)h(the)h(cen)n(tre)f(of)g(the)g(\014rst)h
-(pixel)f(in)g(the)h(input)g(grid)f(along)427 929 y(eac)n(h)27
-b(dimension.)259 1064 y Fc(UBND)p Ft(_)p Fc(IN\()32 b(NDIM)p
-Ft(_)p Fc(IN)f(\))h(=)g(INTEGER)f(\(Giv)m(en\))427 1164
-y Fj(An)k(arra)n(y)d(con)n(taining)h(the)h(co)r(ordinates)f(of)h(the)h
-(cen)n(tre)f(of)g(the)g(last)g(pixel)g(in)h(the)f(input)h(grid)f(along)
-427 1264 y(eac)n(h)27 b(dimension.)427 1381 y(Note)e(that)g(LBND)p
+(IN_VAR,)f(NPOINT,)g(OFFSET,)g(COORDS,)227 4977 y(PARAMS,)g(FLAGS,)g
+(BADVAL,)g(OUT,)h(OUT_VAR,)e(NBAD,)h(STATUS)h(\))0 5126
+y Fc(Argumen)m(ts:)259 5262 y(NDIM)p Ft(_)p Fc(IN)31
+b(=)h(INTEGER)g(\(Giv)m(en\))427 5361 y Fj(The)c(n)n(um)n(b)r(er)f(of)h
+(dimensions)f(in)h(the)g(input)g(grid.)36 b(This)28 b(will)g(b)r(e)g
+(at)f(least)h(one.)259 5494 y Fc(LBND)p Ft(_)p Fc(IN\()k(NDIM)p
+Ft(_)p Fc(IN)f(\))h(=)g(INTEGER)f(\(Giv)m(en\))427 5593
+y Fj(An)j(arra)n(y)d(con)n(taining)h(the)i(co)r(ordinates)e(of)h(the)h
+(cen)n(tre)f(of)g(the)g(\014rst)h(pixel)f(in)g(the)h(input)g(grid)f
+(along)427 5693 y(eac)n(h)27 b(dimension.)p eop end
+%%Page: 400 410
+TeXDict begin 400 409 bop 0 52 a FG(400)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(UBND)p
+Ft(_)p Fc(IN\()h(NDIM)p Ft(_)p Fc(IN)f(\))h(=)g(INTEGER)f(\(Giv)m(en\))
+427 451 y Fj(An)k(arra)n(y)d(con)n(taining)h(the)h(co)r(ordinates)f(of)
+h(the)h(cen)n(tre)f(of)g(the)g(last)g(pixel)g(in)h(the)f(input)h(grid)f
+(along)427 551 y(eac)n(h)27 b(dimension.)427 667 y(Note)e(that)g(LBND)p
Ft(_)p Fj(IN)g(and)g(UBND)p Ft(_)p Fj(IN)g(together)f(de\014ne)h(the)g
(shap)r(e,)g(size)g(and)g(co)r(ordinate)e(system)i(of)427
-1481 y(the)j(input)h(grid)e(in)g(the)h(same)f(w)n(a)n(y)g(as)g(they)g
+767 y(the)j(input)h(grid)e(in)g(the)h(same)f(w)n(a)n(y)g(as)g(they)g
(do)h(in)g(AST)p Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p
-Fj(.)259 1617 y Fc(IN\()k Fi(\003)f Fc(\))h(=)g Fl(<)p
-Fc(Xt)m(yp)s(e)p Fl(>)g Fc(\(Giv)m(en\))427 1717 y Fj(An)d(arra)n(y)-7
+Fj(.)259 901 y Fc(IN\()k Fi(\003)f Fc(\))h(=)g Fl(<)p
+Fc(Xt)m(yp)s(e)p Fl(>)g Fc(\(Giv)m(en\))427 1001 y Fj(An)d(arra)n(y)-7
b(,)26 b(with)j(one)f(elemen)n(t)h(for)f(eac)n(h)f(pixel)h(in)h(the)g
(input)g(grid,)f(con)n(taining)f(the)i(input)g(data.)39
-b(This)427 1816 y(will)31 b(b)r(e)g(the)f(same)g(arra)n(y)e(as)i(w)n
+b(This)427 1100 y(will)31 b(b)r(e)g(the)f(same)g(arra)n(y)e(as)i(w)n
(as)f(passed)g(to)i(AST)p Ft(_)p Fj(RESAMPLE)p Fl(<)p
Fj(X)p Fl(>)d Fj(via)i(the)h(IN)g(argumen)n(t.)44 b(The)427
-1916 y(n)n(umerical)27 b(t)n(yp)r(e)h(of)f(this)h(arra)n(y)e(should)h
+1200 y(n)n(umerical)27 b(t)n(yp)r(e)h(of)f(this)h(arra)n(y)e(should)h
(matc)n(h)g(that)h(of)g(the)g(data)f(b)r(eing)g(pro)r(cessed.)259
-2052 y Fc(IN)p Ft(_)p Fc(V)-11 b(AR\()32 b Fi(\003)f
+1334 y Fc(IN)p Ft(_)p Fc(V)-11 b(AR\()32 b Fi(\003)f
Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p Fl(>)g Fc(\(Giv)m(en\))427
-2151 y Fj(An)24 b(optional)e(second)h(arra)n(y)e(with)j(the)f(same)g
+1433 y Fj(An)24 b(optional)e(second)h(arra)n(y)e(with)j(the)f(same)g
(size)g(and)g(t)n(yp)r(e)g(as)g(the)h(IN)f(arra)n(y)-7
b(.)33 b(This)24 b(will)f(only)g(b)r(e)g(giv)n(en)427
-2251 y(if)30 b(the)f(AST)p Ft(__)p Fj(USEV)-9 b(AR)29
+1533 y(if)30 b(the)f(AST)p Ft(__)p Fj(USEV)-9 b(AR)29
b(\015ag)f(is)h(set)g(via)f(the)i(FLA)n(GS)f(argumen)n(t)f(\(b)r(elo)n
(w\).)41 b(If)29 b(giv)n(en,)g(it)g(will)g(con)n(tain)427
-2351 y(the)i(set)f(of)g(v)-5 b(ariance)29 b(v)-5 b(alues)29
+1633 y(the)i(set)f(of)g(v)-5 b(ariance)29 b(v)-5 b(alues)29
b(asso)r(ciated)g(with)h(the)h(input)g(data)e(and)h(will)g(b)r(e)h(the)
-f(same)g(arra)n(y)d(as)j(w)n(as)427 2450 y(passed)d(to)h(AST)p
+f(same)g(arra)n(y)d(as)j(w)n(as)427 1732 y(passed)d(to)h(AST)p
Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)e Fj(via)h(the)h(IN)p
-Ft(_)p Fj(V)-9 b(AR)28 b(argumen)n(t.)427 2568 y(If)33
+Ft(_)p Fj(V)-9 b(AR)28 b(argumen)n(t.)427 1849 y(If)33
b(the)f(AST)p Ft(__)p Fj(USEV)-9 b(AR)33 b(\015ag)e(is)h(not)g(set,)i
(then)e(no)g(v)-5 b(ariance)31 b(v)-5 b(alues)32 b(are)f(b)r(eing)h
-(pro)r(cessed.)50 b(In)32 b(this)427 2668 y(case,)27
+(pro)r(cessed.)50 b(In)32 b(this)427 1949 y(case,)27
b(this)h(arra)n(y)d(of)i(v)-5 b(ariance)27 b(v)-5 b(alues)27
b(ma)n(y)f(b)r(e)i(a)f(dumm)n(y)h(\(e.g.)37 b(one-elemen)n(t\))27
-b(arra)n(y)e(and)i(should)h(not)427 2767 y(b)r(e)g(used.)259
-2903 y Fc(NPOINT)k(=)g(INTEGER)f(\(Giv)m(en\))427 3003
+b(arra)n(y)e(and)i(should)h(not)427 2048 y(b)r(e)g(used.)259
+2182 y Fc(NPOINT)k(=)g(INTEGER)f(\(Giv)m(en\))427 2282
y Fj(The)26 b(n)n(um)n(b)r(er)f(of)g(p)r(oin)n(ts)h(at)f(whic)n(h)g
(the)h(input)g(grid)f(is)g(to)g(b)r(e)h(in)n(terp)r(olated.)36
-b(This)25 b(will)h(b)r(e)g(at)f(least)g(one.)259 3139
+b(This)25 b(will)h(b)r(e)g(at)f(least)g(one.)259 2416
y Fc(OFFSET\()32 b(NPOINT)g(\))g(=)g(INTEGER)f(\(Giv)m(en\))427
-3238 y Fj(F)-7 b(or)23 b(eac)n(h)g(in)n(terp)r(olation)g(p)r(oin)n(t,)h
+2515 y Fj(F)-7 b(or)23 b(eac)n(h)g(in)n(terp)r(olation)g(p)r(oin)n(t,)h
(this)g(arra)n(y)d(will)j(con)n(tain)e(the)i(o\013set)g(from)f(the)h
-(start)f(of)g(the)h(OUT)f(\(and)427 3338 y(OUT)p Ft(_)p
+(start)f(of)g(the)h(OUT)f(\(and)427 2615 y(OUT)p Ft(_)p
Fj(V)-9 b(AR\))35 b(arra)n(y\(s\))d(at)i(whic)n(h)g(the)h(in)n(terp)r
(olated)e(v)-5 b(alue)34 b(\(and)h(its)f(v)-5 b(ariance,)35
-b(if)f(required\))g(should)427 3438 y(b)r(e)28 b(stored.)36
+b(if)f(required\))g(should)427 2715 y(b)r(e)28 b(stored.)36
b(F)-7 b(or)26 b(example,)h(the)h(in)n(terp)r(olated)e(v)-5
b(alue)27 b(for)g(p)r(oin)n(t)g(n)n(um)n(b)r(er)g(POINT)g(should)f(b)r
-(e)i(stored)e(in)427 3537 y(OUT\(1+OFFSET\(POINT\)\).)259
-3673 y Fc(COORDS\()31 b(NPOINT,)h(NDIM)p Ft(_)p Fc(IN)f(\))h(=)g
-(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427 3773 y Fj(A)26
+(e)i(stored)e(in)427 2814 y(OUT\(1+OFFSET\(POINT\)\).)259
+2948 y Fc(COORDS\()31 b(NPOINT,)h(NDIM)p Ft(_)p Fc(IN)f(\))h(=)g
+(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427 3048 y Fj(A)26
b(2-dimensional)e(arra)n(y)g(con)n(taining)g(the)i(co)r(ordinates)e(of)
i(the)g(p)r(oin)n(ts)f(at)h(whic)n(h)f(in)n(terp)r(olation)g(should)427
-3872 y(b)r(e)37 b(p)r(erformed.)63 b(These)36 b(will)g(b)r(e)h(stored)f
+3148 y(b)r(e)37 b(p)r(erformed.)63 b(These)36 b(will)g(b)r(e)h(stored)f
(so)g(that)g(co)r(ordinate)f(n)n(um)n(b)r(er)i(COORD)f(for)f(in)n(terp)
-r(olation)427 3972 y(p)r(oin)n(t)28 b(n)n(um)n(b)r(er)f(POINT)g(is)h
+r(olation)427 3247 y(p)r(oin)n(t)28 b(n)n(um)n(b)r(er)f(POINT)g(is)h
(found)g(in)g(elemen)n(t)f(COORDS\(POINT,COORD\).)427
-4090 y(If)42 b(an)n(y)f(in)n(terp)r(olation)f(p)r(oin)n(t)i(has)f(an)n
+3364 y(If)42 b(an)n(y)f(in)n(terp)r(olation)f(p)r(oin)n(t)i(has)f(an)n
(y)f(of)i(its)f(co)r(ordinates)f(equal)h(to)g(the)h(v)-5
-b(alue)42 b(AST)p Ft(__)p Fj(BAD)f(\(as)427 4189 y(de\014ned)35
+b(alue)42 b(AST)p Ft(__)p Fj(BAD)f(\(as)427 3464 y(de\014ned)35
b(in)g(the)h(AST)p Ft(_)p Fj(P)-7 b(AR)34 b(include)i(\014le\),)h(then)
e(the)g(corresp)r(onding)e(output)i(data)g(\(and)g(v)-5
-b(ariance\))427 4289 y(should)23 b(either)g(b)r(e)g(set)g(to)g(the)g(v)
+b(ariance\))427 3563 y(should)23 b(either)g(b)r(e)g(set)g(to)g(the)g(v)
-5 b(alue)23 b(giv)n(en)g(b)n(y)f(BAD)n(V)-9 b(AL,)24
b(or)e(left)h(unc)n(hanged,)h(dep)r(ending)f(on)g(whether)427
-4389 y(the)28 b(AST)p Ft(__)p Fj(NOBAD)g(\015ag)f(is)g(sp)r(eci\014ed)h
-(b)n(y)f(FLA)n(GS.)259 4525 y Fc(P)-8 b(ARAMS\()32 b
+3663 y(the)28 b(AST)p Ft(__)p Fj(NOBAD)g(\015ag)f(is)g(sp)r(eci\014ed)h
+(b)n(y)f(FLA)n(GS.)259 3797 y Fc(P)-8 b(ARAMS\()32 b
Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m(en\))427
-4624 y Fj(This)19 b(will)f(b)r(e)h(the)g(same)f(arra)n(y)e(as)h(w)n(as)
+3896 y Fj(This)19 b(will)f(b)r(e)h(the)g(same)f(arra)n(y)e(as)h(w)n(as)
h(giv)n(en)f(via)h(the)h(P)-7 b(ARAMS)19 b(argumen)n(t)e(of)h(AST)p
-Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p Fj(.)427 4724
+Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p Fj(.)427 3996
y(Y)-7 b(ou)28 b(ma)n(y)f(use)h(this)g(to)g(pass)f(an)n(y)h(additional)
f(parameter)f(v)-5 b(alues)28 b(required)f(b)n(y)h(y)n(our)e(in)n(terp)
-r(olation)h(al-)427 4823 y(gorithm.)259 4959 y Fc(FLA)m(GS)33
-b(=)f(INTEGER)f(\(Giv)m(en\))427 5059 y Fj(This)21 b(will)g(b)r(e)g
+r(olation)h(al-)427 4096 y(gorithm.)259 4230 y Fc(FLA)m(GS)33
+b(=)f(INTEGER)f(\(Giv)m(en\))427 4329 y Fj(This)21 b(will)g(b)r(e)g
(the)h(same)e(v)-5 b(alue)21 b(as)f(w)n(as)g(giv)n(en)g(via)g(the)h
(FLA)n(GS)h(argumen)n(t)d(of)i(AST)p Ft(_)p Fj(RESAMPLE)p
-Fl(<)p Fj(X)p Fl(>)p Fj(.)427 5159 y(Y)-7 b(ou)30 b(ma)n(y)f(test)g
+Fl(<)p Fj(X)p Fl(>)p Fj(.)427 4429 y(Y)-7 b(ou)30 b(ma)n(y)f(test)g
(this)h(v)-5 b(alue)29 b(to)h(pro)n(vide)e(additional)h(con)n(trol)f(o)
n(v)n(er)g(the)i(op)r(eration)e(of)i(y)n(our)e(resampling)427
-5258 y(algorithm.)52 b(Note)34 b(that)f(the)g(sp)r(ecial)g(\015ag)f(v)
+4528 y(algorithm.)52 b(Note)34 b(that)f(the)g(sp)r(ecial)g(\015ag)f(v)
-5 b(alues)33 b(AST)p Ft(__)p Fj(URESAMP1,)h(2,)g(3)e(&)h(4)g(are)f
-(reserv)n(ed)f(for)427 5358 y(y)n(ou)g(to)h(use)f(for)g(y)n(our)g(o)n
+(reserv)n(ed)f(for)427 4628 y(y)n(ou)g(to)h(use)f(for)g(y)n(our)g(o)n
(wn)g(purp)r(oses)f(and)i(will)g(not)f(clash)g(with)h(other)f
(pre-de\014ned)h(\015ag)e(v)-5 b(alues)32 b(\(see)427
-5457 y(AST)p Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p
-Fj(\).)259 5593 y Fc(BAD)m(V)-11 b(AL)34 b(=)e Fl(<)p
-Fc(Xt)m(yp)s(e)p Fl(>)f Fc(\(Giv)m(en\))427 5693 y Fj(This)19
+4728 y(AST)p Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p
+Fj(\).)259 4862 y Fc(BAD)m(V)-11 b(AL)34 b(=)e Fl(<)p
+Fc(Xt)m(yp)s(e)p Fl(>)f Fc(\(Giv)m(en\))427 4961 y Fj(This)19
b(will)f(b)r(e)h(the)g(same)f(v)-5 b(alue)18 b(as)f(w)n(as)h(giv)n(en)f
(for)h(the)h(BAD)n(V)-9 b(AL)19 b(argumen)n(t)e(of)h(AST)p
-Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p Fj(,)p eop
-end
-%%Page: 398 408
-TeXDict begin 398 407 bop 0 52 a FG(398)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)427 351 y Fj(and)40
-b(will)g(ha)n(v)n(e)f(the)h(same)g(n)n(umerical)f(t)n(yp)r(e)h(as)f
-(the)i(data)e(b)r(eing)h(pro)r(cessed)f(\(i.e.)75 b(as)39
-b(elemen)n(ts)h(of)427 451 y(the)d(IN)f(arra)n(y\).)60
+Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p Fj(,)427 5061
+y(and)40 b(will)g(ha)n(v)n(e)f(the)h(same)g(n)n(umerical)f(t)n(yp)r(e)h
+(as)f(the)i(data)e(b)r(eing)h(pro)r(cessed)f(\(i.e.)75
+b(as)39 b(elemen)n(ts)h(of)427 5161 y(the)d(IN)f(arra)n(y\).)60
b(It)36 b(should)g(b)r(e)g(used)g(to)g(test)h(for)e(bad)h(pixels)g(in)g
-(the)g(input)h(grid)e(\(but)i(only)f(if)g(the)427 551
+(the)g(input)h(grid)e(\(but)i(only)f(if)g(the)427 5260
y(AST)p Ft(__)p Fj(USEBAD)26 b(\015ag)e(is)i(set)f(via)g(the)h(FLA)n
(GS)g(argumen)n(t\))f(and)g(\(unless)h(the)g(AST)p Ft(__)p
-Fj(NOBAD)f(\015ag)g(is)427 650 y(set)j(in)g(FLA)n(GS\))g(for)f(iden)n
+Fj(NOBAD)f(\015ag)g(is)427 5360 y(set)j(in)g(FLA)n(GS\))g(for)f(iden)n
(tifying)h(bad)f(output)h(v)-5 b(alues)28 b(in)g(the)g(OUT)f(\(and)h
(OUT)p Ft(_)p Fj(V)-9 b(AR\))27 b(arra)n(y\(s\).)259
-785 y Fc(OUT\()33 b Fi(\003)e Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p
-Fl(>)f Fc(\(Returned\))427 884 y Fj(An)36 b(arra)n(y)d(with)j(the)f
+5494 y Fc(OUT\()33 b Fi(\003)e Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p
+Fl(>)f Fc(\(Returned\))427 5593 y Fj(An)36 b(arra)n(y)d(with)j(the)f
(same)g(n)n(umerical)f(t)n(yp)r(e)i(as)e(the)i(IN)g(arra)n(y)-7
b(,)35 b(in)n(to)g(whic)n(h)g(the)g(in)n(terp)r(olated)g(data)427
-984 y(v)-5 b(alues)29 b(should)f(b)r(e)h(returned.)40
+5693 y(v)-5 b(alues)29 b(should)f(b)r(e)h(returned.)40
b(Note)29 b(that)g(details)f(of)h(the)g(storage)e(order)g(and)i(n)n(um)
-n(b)r(er)f(of)h(dimensions)427 1084 y(of)34 b(this)h(arra)n(y)c(are)i
-(not)i(required,)f(since)g(the)h(OFFSET)e(arra)n(y)f(con)n(tains)h(all)
-h(necessary)e(information)427 1183 y(ab)r(out)c(where)f(eac)n(h)g
-(returned)g(v)-5 b(alue)27 b(should)h(b)r(e)g(stored.)427
-1301 y(In)e(general,)e(not)h(all)g(elemen)n(ts)g(of)g(this)g(arra)n(y)e
-(\(or)i(the)g(OUT)p Ft(_)p Fj(V)-9 b(AR)25 b(arra)n(y)e(b)r(elo)n(w\))i
-(ma)n(y)f(b)r(e)i(used)f(in)g(an)n(y)427 1400 y(particular)c(in)n(v)n
-(o)r(cation)g(of)h(the)g(routine.)35 b(Those)21 b(whic)n(h)h(are)f(not)
-h(used)g(should)g(b)r(e)h(returned)e(unc)n(hanged.)259
-1535 y Fc(OUT)p Ft(_)p Fc(V)-11 b(AR\()33 b Fi(\003)e
-Fc(\))h(=)g Fl(<)p Fc(Xt)m(yp)s(e)p Fl(>)f Fc(\(Returned\))427
-1634 y Fj(An)k(optional)f(arra)n(y)e(with)i(the)h(same)f(t)n(yp)r(e)g
-(and)g(size)g(as)g(the)h(OUT)f(arra)n(y)-7 b(,)34 b(in)n(to)g(whic)n(h)
-g(v)-5 b(ariance)33 b(es-)427 1734 y(timates)j(for)f(the)h(resampled)e
-(v)-5 b(alues)35 b(should)h(b)r(e)f(returned.)60 b(This)36
+n(b)r(er)f(of)h(dimensions)p eop end
+%%Page: 401 411
+TeXDict begin 401 410 bop 3643 52 a FG(401)427 351 y
+Fj(of)34 b(this)h(arra)n(y)c(are)i(not)i(required,)f(since)g(the)h
+(OFFSET)e(arra)n(y)f(con)n(tains)h(all)h(necessary)e(information)427
+451 y(ab)r(out)c(where)f(eac)n(h)g(returned)g(v)-5 b(alue)27
+b(should)h(b)r(e)g(stored.)427 566 y(In)e(general,)e(not)h(all)g
+(elemen)n(ts)g(of)g(this)g(arra)n(y)e(\(or)i(the)g(OUT)p
+Ft(_)p Fj(V)-9 b(AR)25 b(arra)n(y)e(b)r(elo)n(w\))i(ma)n(y)f(b)r(e)i
+(used)f(in)g(an)n(y)427 666 y(particular)c(in)n(v)n(o)r(cation)g(of)h
+(the)g(routine.)35 b(Those)21 b(whic)n(h)h(are)f(not)h(used)g(should)g
+(b)r(e)h(returned)e(unc)n(hanged.)259 796 y Fc(OUT)p
+Ft(_)p Fc(V)-11 b(AR\()33 b Fi(\003)e Fc(\))h(=)g Fl(<)p
+Fc(Xt)m(yp)s(e)p Fl(>)f Fc(\(Returned\))427 896 y Fj(An)k(optional)f
+(arra)n(y)e(with)i(the)h(same)f(t)n(yp)r(e)g(and)g(size)g(as)g(the)h
+(OUT)f(arra)n(y)-7 b(,)34 b(in)n(to)g(whic)n(h)g(v)-5
+b(ariance)33 b(es-)427 995 y(timates)j(for)f(the)h(resampled)e(v)-5
+b(alues)35 b(should)h(b)r(e)f(returned.)60 b(This)36
b(arra)n(y)d(will)j(only)f(b)r(e)h(giv)n(en)e(if)i(the)427
-1834 y(AST)p Ft(__)p Fj(USEV)-9 b(AR)28 b(\015ag)f(is)g(set)h(via)f
-(the)h(FLA)n(GS)g(argumen)n(t.)427 1951 y(If)g(giv)n(en,)e(it)i(is)f
+1095 y(AST)p Ft(__)p Fj(USEV)-9 b(AR)28 b(\015ag)f(is)g(set)h(via)f
+(the)h(FLA)n(GS)g(argumen)n(t.)427 1210 y(If)g(giv)n(en,)e(it)i(is)f
(addressed)f(in)h(exactly)g(the)g(same)g(w)n(a)n(y)f(\(via)g(the)i
(OFFSET)f(arra)n(y\))e(as)h(the)i(OUT)f(arra)n(y)-7 b(.)427
-2051 y(The)22 b(v)-5 b(alues)21 b(returned)g(should)h(b)r(e)g
+1309 y(The)22 b(v)-5 b(alues)21 b(returned)g(should)h(b)r(e)g
(estimates)f(of)h(the)g(statistical)f(v)-5 b(ariance)21
-b(of)g(the)h(corresp)r(onding)e(v)-5 b(alues)427 2150
+b(of)g(the)h(corresp)r(onding)e(v)-5 b(alues)427 1409
y(in)36 b(the)g(OUT)g(arra)n(y)-7 b(,)36 b(on)f(the)h(assumption)f
(that)h(all)g(errors)d(in)j(input)h(data)e(v)-5 b(alues)35
-b(are)g(statistically)427 2250 y(indep)r(enden)n(t)40
+b(are)g(statistically)427 1509 y(indep)r(enden)n(t)40
b(and)f(that)g(their)f(v)-5 b(ariance)38 b(estimates)g(ma)n(y)h(simply)
-f(b)r(e)i(summed)f(\(with)g(appropriate)427 2349 y(w)n(eigh)n(ting)27
-b(factors\).)427 2467 y(If)k(the)g(AST)p Ft(__)p Fj(USEV)-9
+f(b)r(e)i(summed)f(\(with)g(appropriate)427 1608 y(w)n(eigh)n(ting)27
+b(factors\).)427 1723 y(If)k(the)g(AST)p Ft(__)p Fj(USEV)-9
b(AR)30 b(\015ag)f(is)i(not)f(set,)h(then)g(v)-5 b(ariance)29
b(v)-5 b(alues)30 b(are)f(not)i(b)r(eing)f(pro)r(cessed.)44
-b(In)30 b(this)427 2566 y(case,)d(this)h(arra)n(y)d(ma)n(y)i(b)r(e)h(a)
+b(In)30 b(this)427 1823 y(case,)d(this)h(arra)n(y)d(ma)n(y)i(b)r(e)h(a)
f(dumm)n(y)h(\(e.g.)37 b(one-elemen)n(t\))27 b(arra)n(y)e(and)j(should)
-f(not)h(b)r(e)g(used.)259 2701 y Fc(NBAD)k(=)g(INTEGER)f(\(Returned\))
-427 2800 y Fj(This)h(should)g(return)f(the)h(n)n(um)n(b)r(er)g(of)f(in)
+f(not)h(b)r(e)g(used.)259 1953 y Fc(NBAD)k(=)g(INTEGER)f(\(Returned\))
+427 2053 y Fj(This)h(should)g(return)f(the)h(n)n(um)n(b)r(er)g(of)f(in)
n(terp)r(olation)g(p)r(oin)n(ts)h(at)f(whic)n(h)h(no)g(v)-5
-b(alid)31 b(in)n(terp)r(olated)h(v)-5 b(alue)427 2900
+b(alid)31 b(in)n(terp)r(olated)h(v)-5 b(alue)427 2153
y(could)29 b(b)r(e)g(obtained.)39 b(The)29 b(maxim)n(um)f(v)-5
b(alue)28 b(that)h(should)f(b)r(e)h(returned)f(is)h(NPOINT,)f(and)h
-(the)f(mini-)427 3000 y(m)n(um)g(is)g(zero)e(\(indicating)i(that)g(all)
+(the)f(mini-)427 2252 y(m)n(um)g(is)g(zero)e(\(indicating)i(that)g(all)
f(output)h(v)-5 b(alues)27 b(w)n(ere)g(successfully)g(obtained\).)259
-3134 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 3234 y Fj(The)c(global)e(status.)0 3400
-y Fc(Notes:)340 3686 y Fi(\017)45 b Fj(The)37 b(data)e(t)n(yp)r(e)i
+2383 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 2482 y Fj(The)c(global)e(status.)0 2642
+y Fc(Notes:)340 2922 y Fi(\017)45 b Fj(The)37 b(data)e(t)n(yp)r(e)i
Fl(<)p Fj(Xt)n(yp)r(e)p Fl(>)f Fj(indicates)g(the)g(n)n(umerical)g(t)n
(yp)r(e)g(of)g(the)h(data)f(b)r(eing)g(pro)r(cessed,)i(as)d(for)427
-3786 y(AST)p Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p
-Fj(.)340 3920 y Fi(\017)45 b Fj(This)19 b(routine)f(will)g(t)n
+3021 y(AST)p Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p
+Fj(.)340 3152 y Fi(\017)45 b Fj(This)19 b(routine)f(will)g(t)n
(ypically)g(b)r(e)h(in)n(v)n(ok)n(ed)e(more)g(than)i(once)f(for)f(eac)n
(h)h(in)n(v)n(o)r(cation)f(of)h(AST)p Ft(_)p Fj(RESAMPLE)p
-Fl(<)p Fj(X)p Fl(>)p Fj(.)340 4055 y Fi(\017)45 b Fj(If)29
+Fl(<)p Fj(X)p Fl(>)p Fj(.)340 3282 y Fi(\017)45 b Fj(If)29
b(an)g(error)d(o)r(ccurs)i(within)h(this)g(routine,)f(it)h(should)g
(set)f(the)h(ST)-7 b(A)g(TUS)30 b(argumen)n(t)d(to)i(an)f(error)f(v)-5
-b(alue)427 4155 y(b)r(efore)34 b(returning.)56 b(This)34
+b(alue)427 3382 y(b)r(efore)34 b(returning.)56 b(This)34
b(will)h(cause)e(an)h(immediate)h(return)e(from)h(AST)p
Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p Fj(.)56 b(The)427
-4254 y(error)32 b(v)-5 b(alue)34 b(AST)p Ft(__)p Fj(UINER)g(is)g(a)n(v)
+3481 y(error)32 b(v)-5 b(alue)34 b(AST)p Ft(__)p Fj(UINER)g(is)g(a)n(v)
-5 b(ailable)33 b(for)g(this)i(purp)r(ose,)g(but)g(other)e(v)-5
-b(alues)34 b(ma)n(y)f(also)g(b)r(e)i(used)427 4354 y(\(e.g.)54
+b(alues)34 b(ma)n(y)f(also)g(b)r(e)i(used)427 3581 y(\(e.g.)54
b(if)34 b(y)n(ou)f(wish)g(to)g(distinguish)h(di\013eren)n(t)f(t)n(yp)r
(es)h(of)f(error\).)53 b(The)33 b(AST)p Ft(__)p Fj(UINER)g(error)e(v)-5
-b(alue)34 b(is)427 4453 y(de\014ned)28 b(in)g(the)g(AST)p
-Ft(_)p Fj(ERR)f(include)h(\014le.)p 0 4656 3780 12 v
-0 4787 a FA(AST)p Fe(_)p FA(UKERN1)1289 4788 y Fd(1-dimensional)36
-b(sub-pixel)1389 4903 y(in)m(terp)s(olation)f(k)m(ernel)2879
-4787 y FA(AST)p Fe(_)p FA(UKERN1)0 5095 y Fc(Description:)44
+b(alue)34 b(is)427 3680 y(de\014ned)28 b(in)g(the)g(AST)p
+Ft(_)p Fj(ERR)f(include)h(\014le.)p 0 3875 3780 12 v
+0 4006 a FA(AST)p Fe(_)p FA(UKERN1)1289 4007 y Fd(1-dimensional)36
+b(sub-pixel)1389 4121 y(in)m(terp)s(olation)f(k)m(ernel)2879
+4006 y FA(AST)p Fe(_)p FA(UKERN1)0 4305 y Fc(Description:)44
b Fj(This)33 b(is)g(a)g(\014ctitious)g(routine)g(whic)n(h)g(do)r(es)g
(not)g(actually)g(exist.)53 b(Instead,)34 b(this)g(description)e(con-)
-227 5195 y(stitutes)40 b(a)e(template)i(so)e(that)h(y)n(ou)f(ma)n(y)h
+227 4405 y(stitutes)40 b(a)e(template)i(so)e(that)h(y)n(ou)f(ma)n(y)h
(implemen)n(t)g(a)g(routine)f(with)i(this)f(in)n(terface)f(for)h(y)n
-(ourself)e(\(and)227 5295 y(giv)n(e)d(it)g(an)n(y)g(name)g(y)n(ou)g
+(ourself)e(\(and)227 4504 y(giv)n(e)d(it)g(an)n(y)g(name)g(y)n(ou)g
(wish\).)57 b(Suc)n(h)34 b(a)g(routine)g(ma)n(y)g(b)r(e)h(passed)e(via)
-h(the)h(FINTERP)f(argumen)n(t)f(of)h(the)227 5394 y(AST)p
+h(the)h(FINTERP)f(argumen)n(t)f(of)h(the)227 4604 y(AST)p
Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)24 b Fj(functions)h(\(q.v.\))36
b(in)25 b(order)f(to)h(supply)g(a)f(1-dimensional)g(in)n(terp)r
-(olation)g(k)n(ernel)g(to)227 5494 y(the)h(algorithm)f(whic)n(h)g(p)r
+(olation)g(k)n(ernel)g(to)227 4703 y(the)h(algorithm)f(whic)n(h)g(p)r
(erforms)g(sub-pixel)h(in)n(terp)r(olation)f(during)g(resampling)f(of)i
-(gridded)f(data)g(\(y)n(ou)g(m)n(ust)227 5593 y(also)33
+(gridded)f(data)g(\(y)n(ou)g(m)n(ust)227 4803 y(also)33
b(set)g(the)h(INTERP)f(argumen)n(t)g(of)h(AST)p Ft(_)p
Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)e Fj(to)h(the)h(v)-5
b(alue)34 b(AST)p Ft(__)p Fj(UKERN1\).)54 b(This)227
-5693 y(allo)n(ws)26 b(y)n(ou)h(to)h(use)f(y)n(our)g(o)n(wn)g(in)n(terp)
+4903 y(allo)n(ws)26 b(y)n(ou)h(to)h(use)f(y)n(our)g(o)n(wn)g(in)n(terp)
r(olation)f(k)n(ernel)h(in)h(addition)f(to)h(those)f(whic)n(h)h(are)e
-(pre-de\014ned.)p eop end
-%%Page: 399 409
-TeXDict begin 399 408 bop 3643 52 a FG(399)227 351 y
-Fj(The)25 b(routine)f(calculates)f(the)i(v)-5 b(alue)24
-b(of)g(a)g(1-dimensional)f(sub-pixel)h(in)n(terp)r(olation)g(k)n
-(ernel.)34 b(This)25 b(determines)227 451 y(ho)n(w)31
+(pre-de\014ned.)227 5026 y(The)f(routine)f(calculates)f(the)i(v)-5
+b(alue)24 b(of)g(a)g(1-dimensional)f(sub-pixel)h(in)n(terp)r(olation)g
+(k)n(ernel.)34 b(This)25 b(determines)227 5126 y(ho)n(w)31
b(the)i(w)n(eigh)n(t)e(giv)n(en)g(to)h(neigh)n(b)r(ouring)e(pixels)i
(in)g(calculating)f(an)g(in)n(terp)r(olated)h(v)-5 b(alue)31
-b(dep)r(ends)i(on)e(the)227 551 y(pixel's)f(o\013set)g(from)g(the)h(in)
-n(terp)r(olation)e(p)r(oin)n(t.)45 b(In)30 b(more)f(than)i(one)e
+b(dep)r(ends)i(on)e(the)227 5225 y(pixel's)f(o\013set)g(from)g(the)h
+(in)n(terp)r(olation)e(p)r(oin)n(t.)45 b(In)30 b(more)f(than)i(one)e
(dimension,)i(the)g(w)n(eigh)n(t)e(assigned)g(to)h(a)227
-650 y(pixel)k(is)h(formed)e(b)n(y)h(ev)-5 b(aluating)34
+5325 y(pixel)k(is)h(formed)e(b)n(y)h(ev)-5 b(aluating)34
b(this)g(1-dimensional)f(k)n(ernel)g(using)h(the)h(o\013set)f(along)f
-(eac)n(h)g(dimension)h(in)227 750 y(turn.)j(The)28 b(pro)r(duct)g(of)f
+(eac)n(h)g(dimension)h(in)227 5425 y(turn.)j(The)28 b(pro)r(duct)g(of)f
(the)h(returned)f(v)-5 b(alues)27 b(is)h(then)g(used)g(as)f(the)g
-(pixel)h(w)n(eigh)n(t.)0 898 y Fc(In)m(v)m(o)s(cation:)123
+(pixel)h(w)n(eigh)n(t.)0 5572 y Fc(In)m(v)m(o)s(cation:)123
b Ft(CALL)42 b(AST_UKERN1\()d(OFFSET,)h(PARAMS,)h(FLAGS,)g(VALUE,)g
-(STATUS)g(\))0 1046 y Fc(Argumen)m(ts:)259 1182 y(OFFSET)32
-b(=)g(DOUBLE)g(PRECISION)g(\(Giv)m(en\))427 1281 y Fj(This)22
-b(will)g(b)r(e)g(the)g(o\013set)g(of)f(the)h(pixel)g(from)g(the)g(in)n
-(terp)r(olation)e(p)r(oin)n(t,)k(measured)c(in)i(pixels.)35
-b(This)22 b(v)-5 b(alue)427 1381 y(ma)n(y)29 b(b)r(e)h(p)r(ositiv)n(e)g
-(or)e(negativ)n(e,)h(but)i(for)e(most)g(practical)g(in)n(terp)r
-(olation)g(sc)n(hemes)g(its)h(sign)f(should)g(b)r(e)427
-1481 y(ignored.)259 1612 y Fc(P)-8 b(ARAMS\()32 b Fi(\003)f
-Fc(\))h(=)g(DOUBLE)h(PRECISION)e(\(Giv)m(en\))427 1712
-y Fj(This)19 b(will)f(b)r(e)h(the)g(same)f(arra)n(y)e(as)h(w)n(as)h
-(giv)n(en)f(via)h(the)h(P)-7 b(ARAMS)19 b(argumen)n(t)e(of)h(AST)p
-Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p Fj(.)427 1812
-y(Y)-7 b(ou)29 b(ma)n(y)f(use)g(this)h(to)f(pass)g(an)n(y)g(additional)
-g(parameter)f(v)-5 b(alues)28 b(required)f(b)n(y)h(y)n(our)g(k)n
-(ernel,)g(but)h(note)427 1911 y(that)i(P)-7 b(ARAMS\(1\))31
-b(will)f(already)f(ha)n(v)n(e)g(b)r(een)h(used)h(to)f(sp)r(ecify)g(the)
-h(n)n(um)n(b)r(er)f(of)g(neigh)n(b)r(ouring)f(pixels)427
-2011 y(whic)n(h)f(con)n(tribute)f(to)g(the)h(in)n(terp)r(olated)g(v)-5
-b(alue.)259 2143 y Fc(FLA)m(GS)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
-2242 y Fj(This)21 b(will)g(b)r(e)g(the)h(same)e(v)-5
-b(alue)21 b(as)f(w)n(as)g(giv)n(en)g(via)g(the)h(FLA)n(GS)h(argumen)n
-(t)d(of)i(AST)p Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p
-Fj(.)427 2342 y(Y)-7 b(ou)23 b(ma)n(y)f(test)h(this)f(v)-5
-b(alue)23 b(to)f(pro)n(vide)g(additional)g(con)n(trol)f(o)n(v)n(er)g
-(the)i(op)r(eration)e(of)h(y)n(our)g(routine.)35 b(Note)427
-2442 y(that)27 b(the)g(sp)r(ecial)f(\015ag)g(v)-5 b(alues)27
-b(AST)p Ft(__)p Fj(URESAMP1,)e(2,)i(3)f(&)g(4)h(are)e(reserv)n(ed)g
-(for)h(y)n(ou)g(to)g(use)h(for)f(y)n(our)427 2541 y(o)n(wn)18
-b(purp)r(oses)g(and)g(will)g(not)h(clash)f(with)g(other)g
-(pre-de\014ned)g(\015ag)g(v)-5 b(alues)18 b(\(see)g(AST)p
+(STATUS)g(\))0 5718 y Fc(Argumen)m(ts:)p eop end
+%%Page: 402 412
+TeXDict begin 402 411 bop 0 52 a FG(402)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(OFFSET)h(=)g(DOUBLE)g
+(PRECISION)g(\(Giv)m(en\))427 451 y Fj(This)22 b(will)g(b)r(e)g(the)g
+(o\013set)g(of)f(the)h(pixel)g(from)g(the)g(in)n(terp)r(olation)e(p)r
+(oin)n(t,)k(measured)c(in)i(pixels.)35 b(This)22 b(v)-5
+b(alue)427 551 y(ma)n(y)29 b(b)r(e)h(p)r(ositiv)n(e)g(or)e(negativ)n
+(e,)h(but)i(for)e(most)g(practical)g(in)n(terp)r(olation)g(sc)n(hemes)g
+(its)h(sign)f(should)g(b)r(e)427 650 y(ignored.)259 780
+y Fc(P)-8 b(ARAMS\()32 b Fi(\003)f Fc(\))h(=)g(DOUBLE)h(PRECISION)e
+(\(Giv)m(en\))427 879 y Fj(This)19 b(will)f(b)r(e)h(the)g(same)f(arra)n
+(y)e(as)h(w)n(as)h(giv)n(en)f(via)h(the)h(P)-7 b(ARAMS)19
+b(argumen)n(t)e(of)h(AST)p Ft(_)p Fj(RESAMPLE)p Fl(<)p
+Fj(X)p Fl(>)p Fj(.)427 979 y(Y)-7 b(ou)29 b(ma)n(y)f(use)g(this)h(to)f
+(pass)g(an)n(y)g(additional)g(parameter)f(v)-5 b(alues)28
+b(required)f(b)n(y)h(y)n(our)g(k)n(ernel,)g(but)h(note)427
+1079 y(that)i(P)-7 b(ARAMS\(1\))31 b(will)f(already)f(ha)n(v)n(e)g(b)r
+(een)h(used)h(to)f(sp)r(ecify)g(the)h(n)n(um)n(b)r(er)f(of)g(neigh)n(b)
+r(ouring)f(pixels)427 1178 y(whic)n(h)f(con)n(tribute)f(to)g(the)h(in)n
+(terp)r(olated)g(v)-5 b(alue.)259 1308 y Fc(FLA)m(GS)33
+b(=)f(INTEGER)f(\(Giv)m(en\))427 1408 y Fj(This)21 b(will)g(b)r(e)g
+(the)h(same)e(v)-5 b(alue)21 b(as)f(w)n(as)g(giv)n(en)g(via)g(the)h
+(FLA)n(GS)h(argumen)n(t)d(of)i(AST)p Ft(_)p Fj(RESAMPLE)p
+Fl(<)p Fj(X)p Fl(>)p Fj(.)427 1507 y(Y)-7 b(ou)23 b(ma)n(y)f(test)h
+(this)f(v)-5 b(alue)23 b(to)f(pro)n(vide)g(additional)g(con)n(trol)f(o)
+n(v)n(er)g(the)i(op)r(eration)e(of)h(y)n(our)g(routine.)35
+b(Note)427 1607 y(that)27 b(the)g(sp)r(ecial)f(\015ag)g(v)-5
+b(alues)27 b(AST)p Ft(__)p Fj(URESAMP1,)e(2,)i(3)f(&)g(4)h(are)e
+(reserv)n(ed)g(for)h(y)n(ou)g(to)g(use)h(for)f(y)n(our)427
+1706 y(o)n(wn)18 b(purp)r(oses)g(and)g(will)g(not)h(clash)f(with)g
+(other)g(pre-de\014ned)g(\015ag)g(v)-5 b(alues)18 b(\(see)g(AST)p
Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p Fj(\).)259
-2673 y Fc(V)-11 b(ALUE)33 b(=)f(DOUBLE)h(PRECISION)e(\(Returned\))427
-2773 y Fj(The)d(calculated)f(k)n(ernel)g(v)-5 b(alue,)27
+1836 y Fc(V)-11 b(ALUE)33 b(=)f(DOUBLE)h(PRECISION)e(\(Returned\))427
+1936 y Fj(The)d(calculated)f(k)n(ernel)g(v)-5 b(alue,)27
b(whic)n(h)h(ma)n(y)f(b)r(e)h(p)r(ositiv)n(e)f(or)g(negativ)n(e.)259
-2904 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 3004 y Fj(The)c(global)e(status.)0 3165
-y Fc(Notes:)340 3446 y Fi(\017)45 b Fj(Not)29 b(all)g(functions)g(mak)n
+2065 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 2165 y Fj(The)c(global)e(status.)0 2324
+y Fc(Notes:)340 2603 y Fi(\017)45 b Fj(Not)29 b(all)g(functions)g(mak)n
(e)f(go)r(o)r(d)g(in)n(terp)r(olation)h(k)n(ernels.)39
b(In)29 b(general,)f(acceptable)g(k)n(ernels)g(tend)h(to)g(b)r(e)427
-3546 y(symmetrical)h(ab)r(out)h(zero,)g(to)g(ha)n(v)n(e)f(a)g(p)r
+2703 y(symmetrical)h(ab)r(out)h(zero,)g(to)g(ha)n(v)n(e)f(a)g(p)r
(ositiv)n(e)h(p)r(eak)g(\(usually)f(unit)n(y\))i(at)f(zero,)g(and)f(to)
-h(ev)-5 b(aluate)31 b(to)427 3645 y(zero)24 b(whenev)n(er)g(the)h
+h(ev)-5 b(aluate)31 b(to)427 2802 y(zero)24 b(whenev)n(er)g(the)h
(pixel)g(o\013set)g(has)g(an)n(y)f(other)g(in)n(tegral)g(v)-5
b(alue)25 b(\(this)g(ensures)g(that)g(the)g(in)n(terp)r(olated)427
-3745 y(v)-5 b(alues)26 b(pass)g(through)g(the)g(original)f(data\).)37
+2902 y(v)-5 b(alues)26 b(pass)g(through)g(the)g(original)f(data\).)37
b(An)26 b(in)n(terp)r(olation)g(k)n(ernel)g(ma)n(y)f(or)h(ma)n(y)g(not)
-g(ha)n(v)n(e)f(regions)427 3845 y(with)j(negativ)n(e)f(v)-5
+g(ha)n(v)n(e)f(regions)427 3002 y(with)j(negativ)n(e)f(v)-5
b(alues.)36 b(Y)-7 b(ou)28 b(should)f(consult)h(a)f(go)r(o)r(d)g(b)r(o)
r(ok)g(on)g(image)g(pro)r(cessing)f(for)i(more)e(details.)340
-3976 y Fi(\017)45 b Fj(If)29 b(an)g(error)d(o)r(ccurs)i(within)h(this)g
+3131 y Fi(\017)45 b Fj(If)29 b(an)g(error)d(o)r(ccurs)i(within)h(this)g
(routine,)f(it)h(should)g(set)f(the)h(ST)-7 b(A)g(TUS)30
-b(argumen)n(t)d(to)i(an)f(error)f(v)-5 b(alue)427 4076
+b(argumen)n(t)d(to)i(an)f(error)f(v)-5 b(alue)427 3231
y(b)r(efore)34 b(returning.)56 b(This)34 b(will)h(cause)e(an)h
(immediate)h(return)e(from)h(AST)p Ft(_)p Fj(RESAMPLE)p
-Fl(<)p Fj(X)p Fl(>)p Fj(.)56 b(The)427 4176 y(error)31
+Fl(<)p Fj(X)p Fl(>)p Fj(.)56 b(The)427 3331 y(error)31
b(v)-5 b(alue)33 b(AST)p Ft(__)p Fj(UK1ER)f(is)h(a)n(v)-5
b(ailable)32 b(for)g(this)i(purp)r(ose,)g(but)f(other)g(v)-5
-b(alues)33 b(ma)n(y)f(also)g(b)r(e)i(used)427 4275 y(\(e.g.)52
+b(alues)33 b(ma)n(y)f(also)g(b)r(e)i(used)427 3430 y(\(e.g.)52
b(if)33 b(y)n(ou)f(wish)h(to)f(distinguish)h(di\013eren)n(t)f(t)n(yp)r
(es)h(of)g(error\).)50 b(The)32 b(AST)p Ft(__)p Fj(UK1ER)g(error)e(v)-5
-b(alue)33 b(is)427 4375 y(de\014ned)28 b(in)g(the)g(AST)p
-Ft(_)p Fj(ERR)f(include)h(\014le.)p 0 4572 3780 12 v
-0 4703 a FA(AST)p Fe(_)p FA(UNF)l(ORMA)-11 b(T)1439 4704
-y Fd(Read)38 b(a)h(formatted)1332 4803 y(co)s(ordinate)e(v)-7
-b(alue)38 b(for)g(a)1611 4903 y(F)-10 b(rame)38 b(axis)2646
-4703 y FA(AST)p Fe(_)p FA(UNF)l(ORMA)-11 b(T)0 5071 y
+b(alue)33 b(is)427 3530 y(de\014ned)28 b(in)g(the)g(AST)p
+Ft(_)p Fj(ERR)f(include)h(\014le.)p 0 3723 3780 12 v
+0 3853 a FA(AST)p Fe(_)p FA(UNF)l(ORMA)-11 b(T)1439 3854
+y Fd(Read)38 b(a)h(formatted)1332 3954 y(co)s(ordinate)e(v)-7
+b(alue)38 b(for)g(a)1611 4054 y(F)-10 b(rame)38 b(axis)2646
+3853 y FA(AST)p Fe(_)p FA(UNF)l(ORMA)-11 b(T)0 4218 y
Fc(Description:)44 b Fj(This)24 b(function)g(reads)e(a)h(formatted)h
(co)r(ordinate)e(v)-5 b(alue)23 b(\(giv)n(en)g(as)g(a)g(c)n(haracter)f
-(string\))h(for)g(a)g(F)-7 b(rame)227 5171 y(axis)29
+(string\))h(for)g(a)g(F)-7 b(rame)227 4317 y(axis)29
b(and)h(returns)f(the)h(equiv)-5 b(alen)n(t)30 b(n)n(umerical)f
(\(double)h(precision\))f(v)-5 b(alue.)44 b(It)30 b(also)f(returns)g
-(the)h(n)n(um)n(b)r(er)g(of)227 5270 y(c)n(haracters)c(read)g(from)i
-(the)g(string.)227 5394 y(The)39 b(principle)f(use)g(of)h(this)f
+(the)h(n)n(um)n(b)r(er)g(of)227 4417 y(c)n(haracters)c(read)g(from)i
+(the)g(string.)227 4540 y(The)39 b(principle)f(use)g(of)h(this)f
(function)h(is)g(in)f(deco)r(ding)g(user-supplied)g(input)h(whic)n(h)f
-(con)n(tains)g(formatted)227 5494 y(co)r(ordinate)31
+(con)n(tains)g(formatted)227 4639 y(co)r(ordinate)31
b(v)-5 b(alues.)49 b(F)-7 b(ree-format)30 b(input)j(is)e(supp)r(orted)h
(as)f(far)g(as)g(p)r(ossible.)49 b(If)32 b(input)h(is)e(am)n(biguous,)h
-(it)g(is)227 5593 y(in)n(terpreted)h(with)i(reference)d(to)i(the)g(F)-7
+(it)g(is)227 4739 y(in)n(terpreted)h(with)i(reference)d(to)i(the)g(F)-7
b(rame's)33 b(attributes)h(\(in)g(particular,)g(the)g(F)-7
-b(ormat)33 b(string)g(asso)r(ciated)227 5693 y(with)28
+b(ormat)33 b(string)g(asso)r(ciated)227 4839 y(with)28
b(the)g(F)-7 b(rame's)27 b(axis\).)37 b(This)27 b(function)h(is,)g(in)g
(essence,)f(the)h(in)n(v)n(erse)e(of)h(AST)p Ft(_)p Fj(F)n(ORMA)-7
-b(T.)p eop end
-%%Page: 400 410
-TeXDict begin 400 409 bop 0 52 a FG(400)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(In)m(v)m(o)s(cation:)
-123 b Ft(RESULT)41 b(=)i(AST_UNFORMAT\()38 b(THIS,)k(AXIS,)f(STRING,)g
-(VALUE,)g(STATUS)g(\))0 511 y Fc(Argumen)m(ts:)259 658
-y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427 757 y Fj(P)n(oin)n(ter)26
-b(to)i(the)g(F)-7 b(rame.)259 895 y Fc(AXIS)33 b(=)f(INTEGER)f(\(Giv)m
-(en\))427 995 y Fj(The)j(n)n(um)n(b)r(er)f(of)g(the)h(F)-7
-b(rame)33 b(axis)f(for)h(whic)n(h)g(a)g(co)r(ordinate)f(v)-5
-b(alue)34 b(is)f(to)g(b)r(e)h(read)e(\(axis)h(n)n(um)n(b)r(ering)427
-1095 y(starts)27 b(at)h(1)f(for)g(the)h(\014rst)f(axis\).)259
-1233 y Fc(STRING)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
-Fi(\003)f Fc(\))h(\(Giv)m(en\))427 1332 y Fj(A)h(c)n(haracter)d(string)
-h(con)n(taining)g(the)i(formatted)f(co)r(ordinate)f(v)-5
-b(alue.)50 b(This)32 b(string)f(ma)n(y)h(con)n(tain)f(ad-)427
-1432 y(ditional)h(information)f(follo)n(wing)f(the)i(v)-5
+b(T.)0 4985 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
+b(=)i(AST_UNFORMAT\()38 b(THIS,)k(AXIS,)f(STRING,)g(VALUE,)g(STATUS)g
+(\))0 5131 y Fc(Argumen)m(ts:)259 5264 y(THIS)32 b(=)g(INTEGER)g(\(Giv)
+m(en\))427 5364 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rame.)259 5494 y Fc(AXIS)33 b(=)f(INTEGER)f(\(Giv)m(en\))427
+5593 y Fj(The)j(n)n(um)n(b)r(er)f(of)g(the)h(F)-7 b(rame)33
+b(axis)f(for)h(whic)n(h)g(a)g(co)r(ordinate)f(v)-5 b(alue)34
+b(is)f(to)g(b)r(e)h(read)e(\(axis)h(n)n(um)n(b)r(ering)427
+5693 y(starts)27 b(at)h(1)f(for)g(the)h(\014rst)f(axis\).)p
+eop end
+%%Page: 403 413
+TeXDict begin 403 412 bop 3643 52 a FG(403)259 351 y
+Fc(STRING)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h Fi(\003)f
+Fc(\))h(\(Giv)m(en\))427 451 y Fj(A)h(c)n(haracter)d(string)h(con)n
+(taining)g(the)i(formatted)f(co)r(ordinate)f(v)-5 b(alue.)50
+b(This)32 b(string)f(ma)n(y)h(con)n(tain)f(ad-)427 551
+y(ditional)h(information)f(follo)n(wing)f(the)i(v)-5
b(alue)32 b(to)f(b)r(e)h(read,)g(in)g(whic)n(h)f(case)g(reading)f
-(stops)h(at)h(the)g(\014rst)427 1532 y(c)n(haracter)27
+(stops)h(at)h(the)g(\014rst)427 650 y(c)n(haracter)27
b(whic)n(h)j(cannot)f(b)r(e)g(in)n(terpreted)g(as)g(part)f(of)i(the)f
(v)-5 b(alue.)42 b(An)n(y)29 b(white)h(space)f(b)r(efore)g(or)f(after)
-427 1631 y(the)g(v)-5 b(alue)28 b(is)f(discarded.)259
-1769 y Fc(V)-11 b(ALUE)33 b(=)f(DOUBLE)h(PRECISION)e(\(Returned\))427
-1869 y Fj(The)d(co)r(ordinate)e(v)-5 b(alue)28 b(read.)259
-2007 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 2107 y Fj(The)c(global)e(status.)0 2279
-y Fc(Class)31 b(Applicabilit)m(y:)259 2426 y(F)-8 b(rame)427
-2525 y Fj(This)27 b(function)h(applies)f(to)g(all)g(F)-7
+427 750 y(the)g(v)-5 b(alue)28 b(is)f(discarded.)259
+885 y Fc(V)-11 b(ALUE)33 b(=)f(DOUBLE)h(PRECISION)e(\(Returned\))427
+985 y Fj(The)d(co)r(ordinate)e(v)-5 b(alue)28 b(read.)259
+1121 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 1220 y Fj(The)c(global)e(status.)0 1388
+y Fc(Class)31 b(Applicabilit)m(y:)259 1530 y(F)-8 b(rame)427
+1630 y Fj(This)27 b(function)h(applies)f(to)g(all)g(F)-7
b(rames.)36 b(See)27 b(the)h Ft(")p Fj(F)-7 b(rame)26
b(Input)i(F)-7 b(ormat)p Ft(")26 b Fj(section)h(b)r(elo)n(w)g(for)g
-(details)427 2625 y(of)h(the)g(input)g(formats)f(accepted)g(b)n(y)h(a)f
-(basic)g(F)-7 b(rame.)259 2763 y Fc(SkyF)f(rame)427 2862
+(details)427 1729 y(of)h(the)g(input)g(formats)f(accepted)g(b)n(y)h(a)f
+(basic)g(F)-7 b(rame.)259 1865 y Fc(SkyF)f(rame)427 1964
y Fj(The)35 b(SkyF)-7 b(rame)34 b(class)f(re-de\014nes)h(the)h(input)g
(format)f(to)h(b)r(e)g(suitable)f(for)g(represen)n(ting)f(angles)h(and)
-427 2962 y(times,)40 b(with)d(the)g(resulting)f(co)r(ordinate)f(v)-5
+427 2064 y(times,)40 b(with)d(the)g(resulting)f(co)r(ordinate)f(v)-5
b(alue)37 b(returned)f(in)h(radians.)63 b(See)36 b(the)h
-Ft(")p Fj(SkyF)-7 b(rame)36 b(Input)427 3062 y(F)-7 b(ormat)p
+Ft(")p Fj(SkyF)-7 b(rame)36 b(Input)427 2164 y(F)-7 b(ormat)p
Ft(")27 b Fj(section)g(b)r(elo)n(w)g(for)g(details)h(of)f(the)h
-(formats)f(accepted.)259 3200 y Fc(F)-8 b(rameSet)427
-3299 y Fj(The)26 b(input)g(formats)f(accepted)h(b)n(y)f(a)g(F)-7
+(formats)f(accepted.)259 2299 y Fc(F)-8 b(rameSet)427
+2399 y Fj(The)26 b(input)g(formats)f(accepted)h(b)n(y)f(a)g(F)-7
b(rameSet)26 b(are)e(determined)i(b)n(y)f(its)h(curren)n(t)f(F)-7
-b(rame)25 b(\(as)g(sp)r(eci\014ed)427 3399 y(b)n(y)j(the)g(Curren)n(t)e
-(attribute\).)0 3571 y Fc(Returned)32 b(V)-8 b(alue:)259
-3718 y(AST)p Ft(_)p Fc(UNF)m(ORMA)g(T)32 b(=)g(INTEGER)427
-3818 y Fj(The)c(n)n(um)n(b)r(er)f(of)g(c)n(haracters)e(read)h(from)h
+b(rame)25 b(\(as)g(sp)r(eci\014ed)427 2499 y(b)n(y)j(the)g(Curren)n(t)e
+(attribute\).)0 2666 y Fc(Returned)32 b(V)-8 b(alue:)259
+2808 y(AST)p Ft(_)p Fc(UNF)m(ORMA)g(T)32 b(=)g(INTEGER)427
+2908 y Fj(The)c(n)n(um)n(b)r(er)f(of)g(c)n(haracters)e(read)h(from)h
(the)h(string)f(in)g(order)f(to)h(obtain)g(the)h(co)r(ordinate)e(v)-5
-b(alue.)37 b(This)427 3917 y(will)28 b(include)g(an)n(y)f(white)h
+b(alue.)37 b(This)427 3007 y(will)28 b(include)g(an)n(y)f(white)h
(space)f(whic)n(h)g(o)r(ccurs)g(b)r(efore)g(or)g(after)g(the)h(v)-5
-b(alue.)0 4089 y Fc(Notes:)340 4382 y Fi(\017)45 b Fj(A)37
+b(alue.)0 3175 y Fc(Notes:)340 3463 y Fi(\017)45 b Fj(A)37
b(function)f(v)-5 b(alue)36 b(of)g(zero)f(\(and)h(no)g(co)r(ordinate)f
(v)-5 b(alue\))36 b(will)h(b)r(e)f(returned,)i(without)e(error,)h(if)f
-(the)427 4482 y(string)27 b(supplied)h(do)r(es)f(not)h(con)n(tain)f(a)g
-(suitably)g(formatted)h(v)-5 b(alue.)340 4620 y Fi(\017)45
+(the)427 3563 y(string)27 b(supplied)h(do)r(es)f(not)h(con)n(tain)f(a)g
+(suitably)g(formatted)h(v)-5 b(alue.)340 3698 y Fi(\017)45
b Fj(Bew)n(are)20 b(that)h(it)g(is)g(p)r(ossible)g(for)g(a)f
(formatting)h(error)e(part-w)n(a)n(y)g(through)h(an)h(input)g(string)g
-(to)g(terminate)427 4720 y(input)29 b(b)r(efore)e(it)h(has)f(b)r(een)h
+(to)g(terminate)427 3798 y(input)29 b(b)r(efore)e(it)h(has)f(b)r(een)h
(completely)f(read,)g(but)h(to)g(yield)f(a)g(co)r(ordinate)g(v)-5
-b(alue)27 b(that)h(app)r(ears)f(v)-5 b(alid.)427 4819
+b(alue)27 b(that)h(app)r(ears)f(v)-5 b(alid.)427 3898
y(F)e(or)24 b(example,)g(if)h(a)f(user)f(t)n(yp)r(es)h
Ft(")p Fj(1.5R6)p Ft(")e Fj(instead)i(of)g Ft(")p Fj(1.5E6)p
Ft(")p Fj(,)e(the)j Ft(")p Fj(R)p Ft(")e Fj(will)i(terminate)f(input,)h
-(giving)427 4919 y(an)h(incorrect)f(co)r(ordinate)g(v)-5
+(giving)427 3997 y(an)h(incorrect)f(co)r(ordinate)g(v)-5
b(alue)26 b(of)h(1.5.)35 b(It)27 b(is)f(therefore)f(most)h(imp)r(ortan)
n(t)g(to)g(c)n(hec)n(k)f(the)i(return)f(v)-5 b(alue)427
-5018 y(of)28 b(this)g(function)g(to)f(ensure)g(that)h(the)g(correct)e
+4097 y(of)28 b(this)g(function)g(to)f(ensure)g(that)h(the)g(correct)e
(n)n(um)n(b)r(er)i(of)f(c)n(haracters)f(ha)n(v)n(e)g(b)r(een)i(read.)
-340 5156 y Fi(\017)45 b Fj(An)33 b(error)e(will)h(result)g(if)h(a)f(v)
+340 4233 y Fi(\017)45 b Fj(An)33 b(error)e(will)h(result)g(if)h(a)f(v)
-5 b(alue)33 b(is)f(read)g(whic)n(h)g(app)r(ears)f(to)h(ha)n(v)n(e)g
-(the)g(correct)f(format,)j(but)f(whic)n(h)427 5256 y(cannot)d(b)r(e)g
+(the)g(correct)f(format,)j(but)f(whic)n(h)427 4332 y(cannot)d(b)r(e)g
(con)n(v)n(erted)f(in)n(to)h(a)g(v)-5 b(alid)30 b(co)r(ordinate)f(v)-5
b(alue)30 b(\(for)g(instance,)g(b)r(ecause)g(the)h(v)-5
-b(alue)30 b(of)g(one)f(or)427 5356 y(more)e(of)h(its)f(\014elds)h(is)f
-(in)n(v)-5 b(alid\).)340 5494 y Fi(\017)45 b Fj(The)e(string)f
+b(alue)30 b(of)g(one)f(or)427 4432 y(more)e(of)h(its)f(\014elds)h(is)f
+(in)n(v)-5 b(alid\).)340 4568 y Fi(\017)45 b Fj(The)e(string)f
Ft(")p Fl(<)p Fj(bad)p Fl(>)p Ft(")e Fj(is)j(recognised)d(as)i(a)g(sp)r
(ecial)g(case)g(and)g(will)h(yield)g(the)f(co)r(ordinate)g(v)-5
-b(alue)427 5593 y(AST)p Ft(__)p Fj(BAD)32 b(without)f(error.)47
+b(alue)427 4667 y(AST)p Ft(__)p Fj(BAD)32 b(without)f(error.)47
b(The)31 b(test)h(for)f(this)g(string)g(is)g(case-insensitiv)n(e)f(and)
-h(also)f(p)r(ermits)i(em-)427 5693 y(b)r(edded)d(white)f(space.)p
-eop end
-%%Page: 401 411
-TeXDict begin 401 410 bop 3643 52 a FG(401)340 351 y
-Fi(\017)45 b Fj(A)33 b(function)f(result)g(of)g(zero)f(will)h(b)r(e)h
-(returned)e(and)h(no)g(co)r(ordinate)f(v)-5 b(alue)31
-b(will)i(b)r(e)f(returned)g(via)f(the)427 451 y(V)-9
+h(also)f(p)r(ermits)i(em-)427 4767 y(b)r(edded)d(white)f(space.)340
+4902 y Fi(\017)45 b Fj(A)33 b(function)f(result)g(of)g(zero)f(will)h(b)
+r(e)h(returned)e(and)h(no)g(co)r(ordinate)f(v)-5 b(alue)31
+b(will)i(b)r(e)f(returned)g(via)f(the)427 5002 y(V)-9
b(ALUE)25 b(argumen)n(t)f(if)h(this)g(function)g(is)g(in)n(v)n(ok)n(ed)
e(with)i(the)g(AST)g(error)e(status)i(set,)g(or)f(if)h(it)g(should)g
-(fail)427 551 y(for)i(an)n(y)g(reason.)-2 713 y Fc(F)-8
-b(rame)32 b(Input)h(F)-8 b(ormat)n(:)227 859 y Fj(The)28
+(fail)427 5102 y(for)i(an)n(y)g(reason.)-2 5269 y Fc(F)-8
+b(rame)32 b(Input)h(F)-8 b(ormat)n(:)227 5415 y Fj(The)28
b(input)g(format)f(accepted)h(for)f(a)g(basic)g(F)-7
-b(rame)27 b(axis)g(is)g(as)g(follo)n(ws:)340 995 y Fi(\017)45
+b(rame)27 b(axis)g(is)g(as)g(follo)n(ws:)340 5557 y Fi(\017)45
b Fj(An)28 b(optional)f(sign,)g(follo)n(w)n(ed)g(b)n(y:)340
-1128 y Fi(\017)45 b Fj(A)28 b(sequence)f(of)h(one)f(or)g(more)g(digits)
+5693 y Fi(\017)45 b Fj(A)28 b(sequence)f(of)h(one)f(or)g(more)g(digits)
g(p)r(ossibly)g(con)n(taining)g(a)g(decimal)g(p)r(oin)n(t,)h(follo)n(w)
-n(ed)f(b)n(y:)340 1261 y Fi(\017)45 b Fj(An)28 b(optional)f(exp)r(onen)
-n(t)h(\014eld.)340 1394 y Fi(\017)45 b Fj(The)28 b(exp)r(onen)n(t)f
-(\014eld,)h(if)g(presen)n(t,)f(consists)g(of)h Ft(")p
-Fj(E)p Ft(")e Fj(or)h Ft(")p Fj(e)p Ft(")g Fj(follo)n(w)n(ed)f(b)n(y)h
-(a)h(p)r(ossibly)f(signed)g(in)n(teger.)227 1557 y(Examples)g(of)g
-(acceptable)g(F)-7 b(rame)27 b(input)i(formats)d(include:)340
-1693 y Fi(\017)45 b Fj(99)340 1826 y Fi(\017)g Fj(1.25)340
-1959 y Fi(\017)g Fj(-1.6)340 2092 y Fi(\017)g Fj(1E8)340
-2225 y Fi(\017)g Fj(-.99e-17)340 2358 y Fi(\017)g Fl(<)p
-Fj(bad)p Fl(>)-2 2520 y Fc(SkyF)-8 b(rame)33 b(Input)g(F)-8
-b(ormat)n(:)227 2666 y Fj(The)28 b(input)g(format)f(accepted)h(for)f(a)
-g(SkyF)-7 b(rame)27 b(axis)g(is)g(as)g(follo)n(ws:)340
-2803 y Fi(\017)45 b Fj(An)32 b(optional)e(sign,)i(follo)n(w)n(ed)e(b)n
-(y)g(b)r(et)n(w)n(een)h(one)g(and)g(three)g(\014elds)g(represen)n(ting)
-e(either)i(degrees,)g(arc-)427 2903 y(min)n(utes,)d(arc-seconds)d(or)i
-(hours,)g(min)n(utes,)h(seconds)e(\(e.g.)37 b Ft(")p
-Fj(-12)26 b(42)h(03)p Ft(")p Fj(\).)340 3036 y Fi(\017)45
-b Fj(Eac)n(h)22 b(\014eld)h(should)f(consist)g(of)h(a)f(sequence)h(of)f
-(one)h(or)f(more)f(digits,)j(whic)n(h)f(ma)n(y)f(include)h(leading)f
-(zeros.)427 3135 y(A)n(t)29 b(most)f(one)g(\014eld)h(ma)n(y)e(con)n
-(tain)h(a)g(decimal)g(p)r(oin)n(t,)h(in)f(whic)n(h)g(case)g(it)h(is)f
-(tak)n(en)f(to)i(b)r(e)f(the)h(\014nal)f(\014eld)427
-3235 y(\(e.g.)55 b(decimal)34 b(degrees)e(migh)n(t)i(b)r(e)g(giv)n(en)f
-(as)g Ft(")p Fj(124.707)p Ft(")p Fj(,)f(while)h(degrees)g(and)g
-(decimal)h(arc-min)n(utes)427 3335 y(migh)n(t)28 b(b)r(e)g(giv)n(en)f
-(as)g Ft(")p Fj(-13)e(33.8)p Ft(")p Fj(\).)340 3467 y
-Fi(\017)45 b Fj(The)29 b(\014rst)g(\014eld)g(giv)n(en)g(ma)n(y)f(tak)n
-(e)g(an)n(y)g(v)-5 b(alue,)30 b(allo)n(wing)d(angles)h(and)h(times)g
-(outside)g(the)h(con)n(v)n(en)n(tional)427 3567 y(ranges)g(to)h(b)r(e)g
-(represen)n(ted.)46 b(Ho)n(w)n(ev)n(er,)30 b(subsequen)n(t)h(\014elds)g
-(m)n(ust)g(ha)n(v)n(e)f(v)-5 b(alues)31 b(of)g(less)f(than)i(60)e
-(\(e.g.)427 3667 y Ft(")p Fj(720)c(45)h(31)p Ft(")f Fj(is)i(v)-5
+n(ed)f(b)n(y:)p eop end
+%%Page: 404 414
+TeXDict begin 404 413 bop 0 52 a FG(404)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(An)28 b(optional)f(exp)r(onen)n(t)h(\014eld.)340
+481 y Fi(\017)45 b Fj(The)28 b(exp)r(onen)n(t)f(\014eld,)h(if)g(presen)
+n(t,)f(consists)g(of)h Ft(")p Fj(E)p Ft(")e Fj(or)h Ft(")p
+Fj(e)p Ft(")g Fj(follo)n(w)n(ed)f(b)n(y)h(a)h(p)r(ossibly)f(signed)g
+(in)n(teger.)227 640 y(Examples)g(of)g(acceptable)g(F)-7
+b(rame)27 b(input)i(formats)d(include:)340 774 y Fi(\017)45
+b Fj(99)340 904 y Fi(\017)g Fj(1.25)340 1034 y Fi(\017)g
+Fj(-1.6)340 1164 y Fi(\017)g Fj(1E8)340 1294 y Fi(\017)g
+Fj(-.99e-17)340 1424 y Fi(\017)g Fl(<)p Fj(bad)p Fl(>)-2
+1583 y Fc(SkyF)-8 b(rame)33 b(Input)g(F)-8 b(ormat)n(:)227
+1729 y Fj(The)28 b(input)g(format)f(accepted)h(for)f(a)g(SkyF)-7
+b(rame)27 b(axis)g(is)g(as)g(follo)n(ws:)340 1863 y Fi(\017)45
+b Fj(An)32 b(optional)e(sign,)i(follo)n(w)n(ed)e(b)n(y)g(b)r(et)n(w)n
+(een)h(one)g(and)g(three)g(\014elds)g(represen)n(ting)e(either)i
+(degrees,)g(arc-)427 1963 y(min)n(utes,)d(arc-seconds)d(or)i(hours,)g
+(min)n(utes,)h(seconds)e(\(e.g.)37 b Ft(")p Fj(-12)26
+b(42)h(03)p Ft(")p Fj(\).)340 2093 y Fi(\017)45 b Fj(Eac)n(h)22
+b(\014eld)h(should)f(consist)g(of)h(a)f(sequence)h(of)f(one)h(or)f
+(more)f(digits,)j(whic)n(h)f(ma)n(y)f(include)h(leading)f(zeros.)427
+2192 y(A)n(t)29 b(most)f(one)g(\014eld)h(ma)n(y)e(con)n(tain)h(a)g
+(decimal)g(p)r(oin)n(t,)h(in)f(whic)n(h)g(case)g(it)h(is)f(tak)n(en)f
+(to)i(b)r(e)f(the)h(\014nal)f(\014eld)427 2292 y(\(e.g.)55
+b(decimal)34 b(degrees)e(migh)n(t)i(b)r(e)g(giv)n(en)f(as)g
+Ft(")p Fj(124.707)p Ft(")p Fj(,)f(while)h(degrees)g(and)g(decimal)h
+(arc-min)n(utes)427 2392 y(migh)n(t)28 b(b)r(e)g(giv)n(en)f(as)g
+Ft(")p Fj(-13)e(33.8)p Ft(")p Fj(\).)340 2522 y Fi(\017)45
+b Fj(The)29 b(\014rst)g(\014eld)g(giv)n(en)g(ma)n(y)f(tak)n(e)g(an)n(y)
+g(v)-5 b(alue,)30 b(allo)n(wing)d(angles)h(and)h(times)g(outside)g(the)
+h(con)n(v)n(en)n(tional)427 2621 y(ranges)g(to)h(b)r(e)g(represen)n
+(ted.)46 b(Ho)n(w)n(ev)n(er,)30 b(subsequen)n(t)h(\014elds)g(m)n(ust)g
+(ha)n(v)n(e)f(v)-5 b(alues)31 b(of)g(less)f(than)i(60)e(\(e.g.)427
+2721 y Ft(")p Fj(720)c(45)h(31)p Ft(")f Fj(is)i(v)-5
b(alid,)27 b(whereas)g Ft(")p Fj(11)f(45)h(61)p Ft(")f
-Fj(is)h(not\).)340 3800 y Fi(\017)45 b Fj(Fields)30 b(ma)n(y)g(b)r(e)g
+Fj(is)h(not\).)340 2851 y Fi(\017)45 b Fj(Fields)30 b(ma)n(y)g(b)r(e)g
(separated)f(b)n(y)h(white)g(space)f(or)g(b)n(y)h Ft(")p
Fj(:)p Ft(")f Fj(\(colon\),)i(but)f(the)h(c)n(hoice)e(of)h(separator)d
-(m)n(ust)427 3899 y(b)r(e)34 b(used)f(consisten)n(tly)f(throughout)h
+(m)n(ust)427 2951 y(b)r(e)34 b(used)f(consisten)n(tly)f(throughout)h
(the)g(v)-5 b(alue.)53 b(Additional)33 b(white)h(space)e(ma)n(y)h(b)r
-(e)g(presen)n(t)g(around)427 3999 y(\014elds)28 b(and)f(separators)e
+(e)g(presen)n(t)g(around)427 3050 y(\014elds)28 b(and)f(separators)e
(\(e.g.)37 b Ft(")p Fj(-)27 b(2:)37 b(04)26 b(:)37 b(7.1)p
-Ft(")p Fj(\).)340 4132 y Fi(\017)45 b Fj(The)35 b(follo)n(wing)e
+Ft(")p Fj(\).)340 3180 y Fi(\017)45 b Fj(The)35 b(follo)n(wing)e
(\014eld)i(iden)n(ti\014cation)f(c)n(haracters)e(ma)n(y)h(b)r(e)i(used)
-f(as)g(separators)e(to)i(replace)f(either)i(of)427 4232
+f(as)g(separators)e(to)i(replace)f(either)i(of)427 3280
y(those)d(ab)r(o)n(v)n(e)f(\(or)h(ma)n(y)f(b)r(e)i(app)r(ended)g(to)f
(the)h(\014nal)f(\014eld\),)i(in)e(order)f(to)h(iden)n(tify)h(the)g
-(\014eld)g(to)f(whic)n(h)427 4331 y(they)g(are)e(app)r(ended:)45
+(\014eld)g(to)f(whic)n(h)427 3380 y(they)g(are)e(app)r(ended:)45
b Ft(")p Fj(d)p Ft(")p Fj(|degrees;)32 b Ft(")p Fj(h)p
Ft(")p Fj(|hours;)f Ft(")p Fj(m)p Ft(")p Fj(|min)n(utes)g(of)h(arc)e
-(or)h(time;)j Ft(")p Fj(s)p Ft(")p Fj(|seconds)427 4431
+(or)h(time;)j Ft(")p Fj(s)p Ft(")p Fj(|seconds)427 3479
y(of)24 b(arc)f(or)g(time;)i Ft(")p Fj(')p Ft(")f Fj(\(single)f
(quote\)|min)n(utes)h(of)g(arc;)g Ft(""")f Fj(\(double)h
-(quote\)|seconds)f(of)h(arc.)34 b(Either)427 4530 y(lo)n(w)n(er)e(or)h
+(quote\)|seconds)f(of)h(arc.)34 b(Either)427 3579 y(lo)n(w)n(er)e(or)h
(upp)r(er)h(case)f(ma)n(y)g(b)r(e)h(used.)56 b(Fields)33
b(m)n(ust)h(b)r(e)g(giv)n(en)f(in)h(order)f(of)g(decreasing)g
-(signi\014cance)427 4630 y(\(e.g.)k Ft(")p Fj(-11D)26
+(signi\014cance)427 3678 y(\(e.g.)k Ft(")p Fj(-11D)26
b(3')i(14.4)p Ft("")d Fj(or)i Ft(")p Fj(22h14m11.2s)p
-Ft(")p Fj(\).)340 4763 y Fi(\017)45 b Fj(The)22 b(presence)e(of)h(an)n
+Ft(")p Fj(\).)340 3808 y Fi(\017)45 b Fj(The)22 b(presence)e(of)h(an)n
(y)g(of)g(the)h(\014eld)f(iden)n(ti\014cation)g(c)n(haracters)e
Ft(")p Fj(d)p Ft(")p Fj(,)j Ft(")p Fj(')p Ft(")f Fj(\(single)g(quote\))
-g(or)f Ft(""")g Fj(\(double)427 4863 y(quote\))g(indicates)f(that)h
+g(or)f Ft(""")g Fj(\(double)427 3908 y(quote\))g(indicates)f(that)h
(the)f(v)-5 b(alue)20 b(is)f(to)g(b)r(e)h(in)n(terpreted)f(as)g(an)g
(angle.)33 b(Con)n(v)n(ersely)-7 b(,)19 b(the)h(presence)f(of)g
-Ft(")p Fj(h)p Ft(")427 4962 y Fj(indicates)27 b(that)h(it)f(is)g(to)g
+Ft(")p Fj(h)p Ft(")427 4008 y Fj(indicates)27 b(that)h(it)f(is)g(to)g
(b)r(e)h(in)n(terpreted)e(as)h(a)g(time)g(\(with)h(24)e(hours)h
-(corresp)r(onding)e(to)i(360)f(degrees\).)427 5062 y(Incompatible)j
+(corresp)r(onding)e(to)i(360)f(degrees\).)427 4107 y(Incompatible)j
(angle/time)f(iden)n(ti\014cation)h(c)n(haracters)d(ma)n(y)j(not)f(b)r
(e)i(mixed)f(\(e.g.)40 b Ft(")p Fj(10h14'3)p Ft("")26
-b Fj(is)j(not)427 5162 y(v)-5 b(alid\).)35 b(The)21 b(remaining)e
+b Fj(is)j(not)427 4207 y(v)-5 b(alid\).)35 b(The)21 b(remaining)e
(\014eld)i(iden)n(ti\014cation)f(c)n(haracters)f(and)h(separators)e(do)
-i(not)h(sp)r(ecify)f(a)g(preference)427 5261 y(for)27
+i(not)h(sp)r(ecify)f(a)g(preference)427 4307 y(for)27
b(an)h(angle)e(or)h(a)g(time)h(and)g(ma)n(y)f(b)r(e)h(used)f(with)h
-(either.)340 5394 y Fi(\017)45 b Fj(If)23 b(no)f(preference)f(for)h(an)
+(either.)340 4437 y Fi(\017)45 b Fj(If)23 b(no)f(preference)f(for)h(an)
g(angle)f(or)h(a)g(time)g(is)h(expressed)e(an)n(ywhere)f(within)j(the)g
-(v)-5 b(alue,)23 b(it)g(is)f(in)n(terpreted)427 5494
+(v)-5 b(alue,)23 b(it)g(is)f(in)n(terpreted)427 4536
y(as)33 b(an)g(angle)g(if)h(the)g(F)-7 b(ormat)33 b(attribute)h(string)
e(asso)r(ciated)h(with)h(the)f(SkyF)-7 b(rame)33 b(axis)g(generates)f
-(an)427 5593 y(angle)i(and)h(as)f(a)g(time)h(otherwise.)57
+(an)427 4636 y(angle)i(and)h(as)f(a)g(time)h(otherwise.)57
b(This)35 b(ensures)f(that)h(v)-5 b(alues)34 b(pro)r(duced)h(b)n(y)f
-(AST)p Ft(_)p Fj(F)n(ORMA)-7 b(T)35 b(are)427 5693 y(correctly)26
+(AST)p Ft(_)p Fj(F)n(ORMA)-7 b(T)35 b(are)427 4736 y(correctly)26
b(in)n(terpreted)h(b)n(y)h(AST)p Ft(_)p Fj(UNF)n(ORMA)-7
-b(T.)p eop end
-%%Page: 402 412
-TeXDict begin 402 411 bop 0 52 a FG(402)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)340 351 y Fi(\017)45
-b Fj(Fields)37 b(ma)n(y)g(b)r(e)g(omitted,)j(in)d(whic)n(h)g(case)f
-(they)h(default)h(to)f(zero.)64 b(The)37 b(remaining)f(\014elds)h(ma)n
-(y)f(b)r(e)427 451 y(iden)n(ti\014ed)e(b)n(y)f(using)g(appropriate)f
-(\014eld)h(iden)n(ti\014cation)h(c)n(haracters)d(\(see)i(ab)r(o)n(v)n
-(e\))f(and/or)g(b)n(y)h(adding)427 551 y(extra)28 b(colon)g(separators)
-f(\(e.g.)40 b Ft(")p Fj(-05m13s)p Ft(")26 b Fj(is)i(equiv)-5
-b(alen)n(t)29 b(to)g Ft(")p Fj(-:05:13)p Ft(")p Fj(\).)38
-b(If)29 b(a)f(\014eld)i(is)e(not)h(iden)n(ti\014ed)427
-650 y(explicitly)-7 b(,)40 b(it)e(is)g(assumed)e(that)i(adjacen)n(t)f
-(\014elds)g(ha)n(v)n(e)g(b)r(een)h(giv)n(en,)h(after)e(taking)f(accoun)
-n(t)h(of)g(an)n(y)427 750 y(extra)31 b(separator)e(c)n(haracters)h
-(\(e.g.)49 b Ft(")p Fj(14:25.4s)p Ft(")28 b Fj(sp)r(eci\014es)k(min)n
-(utes)g(and)f(seconds,)h(while)g Ft(")p Fj(14::25.4s)p
-Ft(")427 849 y Fj(sp)r(eci\014es)c(degrees)e(and)h(seconds\).)340
-976 y Fi(\017)45 b Fj(If)37 b(\014elds)g(are)f(omitted)h(in)g(suc)n(h)f
-(a)g(w)n(a)n(y)g(that)g(the)h(remaining)f(ones)g(cannot)g(b)r(e)h(iden)
-n(ti\014ed)h(uniquely)427 1076 y(\(e.g.)69 b Ft(")p Fj(01:02)p
-Ft(")p Fj(\),)38 b(then)h(the)f(\014rst)g(\014eld)g(\(either)h(giv)n
-(en)e(explicitly)h(or)g(implied)g(b)n(y)g(an)g(extra)f(leading)427
-1176 y(colon)25 b(separator\))f(is)h(tak)n(en)g(to)g(b)r(e)h(the)g
-(most)g(signi\014can)n(t)f(\014eld)g(that)h(AST)p Ft(_)p
-Fj(F)n(ORMA)-7 b(T)26 b(w)n(ould)f(pro)r(duce)427 1275
-y(when)36 b(formatting)e(a)h(v)-5 b(alue)35 b(\(using)g(the)h(F)-7
+b(T.)340 4866 y Fi(\017)45 b Fj(Fields)37 b(ma)n(y)g(b)r(e)g(omitted,)j
+(in)d(whic)n(h)g(case)f(they)h(default)h(to)f(zero.)64
+b(The)37 b(remaining)f(\014elds)h(ma)n(y)f(b)r(e)427
+4965 y(iden)n(ti\014ed)e(b)n(y)f(using)g(appropriate)f(\014eld)h(iden)n
+(ti\014cation)h(c)n(haracters)d(\(see)i(ab)r(o)n(v)n(e\))f(and/or)g(b)n
+(y)h(adding)427 5065 y(extra)28 b(colon)g(separators)f(\(e.g.)40
+b Ft(")p Fj(-05m13s)p Ft(")26 b Fj(is)i(equiv)-5 b(alen)n(t)29
+b(to)g Ft(")p Fj(-:05:13)p Ft(")p Fj(\).)38 b(If)29 b(a)f(\014eld)i(is)
+e(not)h(iden)n(ti\014ed)427 5164 y(explicitly)-7 b(,)40
+b(it)e(is)g(assumed)e(that)i(adjacen)n(t)f(\014elds)g(ha)n(v)n(e)g(b)r
+(een)h(giv)n(en,)h(after)e(taking)f(accoun)n(t)h(of)g(an)n(y)427
+5264 y(extra)31 b(separator)e(c)n(haracters)h(\(e.g.)49
+b Ft(")p Fj(14:25.4s)p Ft(")28 b Fj(sp)r(eci\014es)k(min)n(utes)g(and)f
+(seconds,)h(while)g Ft(")p Fj(14::25.4s)p Ft(")427 5364
+y Fj(sp)r(eci\014es)c(degrees)e(and)h(seconds\).)340
+5494 y Fi(\017)45 b Fj(If)37 b(\014elds)g(are)f(omitted)h(in)g(suc)n(h)
+f(a)g(w)n(a)n(y)g(that)g(the)h(remaining)f(ones)g(cannot)g(b)r(e)h
+(iden)n(ti\014ed)h(uniquely)427 5593 y(\(e.g.)69 b Ft(")p
+Fj(01:02)p Ft(")p Fj(\),)38 b(then)h(the)f(\014rst)g(\014eld)g
+(\(either)h(giv)n(en)e(explicitly)h(or)g(implied)g(b)n(y)g(an)g(extra)f
+(leading)427 5693 y(colon)25 b(separator\))f(is)h(tak)n(en)g(to)g(b)r
+(e)h(the)g(most)g(signi\014can)n(t)f(\014eld)g(that)h(AST)p
+Ft(_)p Fj(F)n(ORMA)-7 b(T)26 b(w)n(ould)f(pro)r(duce)p
+eop end
+%%Page: 405 415
+TeXDict begin 405 414 bop 3643 52 a FG(405)427 351 y
+Fj(when)36 b(formatting)e(a)h(v)-5 b(alue)35 b(\(using)g(the)h(F)-7
b(ormat)34 b(attribute)i(asso)r(ciated)d(with)j(the)g(SkyF)-7
-b(rame)34 b(axis\).)427 1375 y(By)e(default,)i(this)e(means)f(that)i
+b(rame)34 b(axis\).)427 451 y(By)e(default,)i(this)e(means)f(that)i
(the)f(\014rst)g(\014eld)g(will)g(normally)f(b)r(e)i(in)n(terpreted)e
-(as)h(degrees)e(or)h(hours.)427 1475 y(Ho)n(w)n(ev)n(er,)j(if)h(this)f
+(as)h(degrees)e(or)h(hours.)427 551 y(Ho)n(w)n(ev)n(er,)j(if)h(this)f
(do)r(es)g(not)g(result)g(in)g(consisten)n(t)g(\014eld)g(iden)n
(ti\014cation,)i(then)f(the)f(last)g(\014eld)g(\(either)427
-1574 y(giv)n(en)f(explicitly)g(or)g(implied)h(b)n(y)f(an)g(extra)g
+650 y(giv)n(en)f(explicitly)g(or)g(implied)h(b)n(y)f(an)g(extra)g
(trailing)g(colon)f(separator\))g(is)h(tak)n(en)g(to)g(to)g(b)r(e)h
-(the)g(least)427 1674 y(signi\014can)n(t)27 b(\014eld)h(that)g(AST)p
+(the)g(least)427 750 y(signi\014can)n(t)27 b(\014eld)h(that)g(AST)p
Ft(_)p Fj(F)n(ORMA)-7 b(T)27 b(w)n(ould)h(pro)r(duce.)227
-1830 y(This)23 b(\014nal)g(con)n(v)n(en)n(tion)f(is)h(in)n(tended)g(to)
-g(ensure)g(that)g(v)-5 b(alues)23 b(formatted)f(b)n(y)h(AST)p
+896 y(This)23 b(\014nal)g(con)n(v)n(en)n(tion)f(is)h(in)n(tended)g(to)g
+(ensure)g(that)g(v)-5 b(alues)23 b(formatted)f(b)n(y)h(AST)p
Ft(_)p Fj(F)n(ORMA)-7 b(T)23 b(whic)n(h)g(con)n(tain)227
-1929 y(less)33 b(than)g(three)f(\014elds)h(will)g(b)r(e)h(correctly)d
+996 y(less)33 b(than)g(three)f(\014elds)h(will)g(b)r(e)h(correctly)d
(in)n(terpreted)h(if)i(read)e(bac)n(k)g(using)g(AST)p
-Ft(_)p Fj(UNF)n(ORMA)-7 b(T,)34 b(ev)n(en)e(if)227 2029
+Ft(_)p Fj(UNF)n(ORMA)-7 b(T,)34 b(ev)n(en)e(if)227 1095
y(they)c(do)f(not)h(con)n(tain)f(\014eld)h(iden)n(ti\014cation)f(c)n
-(haracters.)227 2151 y(Examples)g(of)g(acceptable)g(SkyF)-7
+(haracters.)227 1212 y(Examples)g(of)g(acceptable)g(SkyF)-7
b(rame)27 b(input)h(formats)f(\(with)i(in)n(terpretation)d(in)i(paren)n
-(theses\))f(include:)340 2281 y Fi(\017)45 b Fj(-14d)27
+(theses\))f(include:)340 1333 y Fi(\017)45 b Fj(-14d)27
b(13m)g(22.2s)f(\(-14d)g(13')h(22.2)p Ft(")p Fj(\))340
-2408 y Fi(\017)45 b Fj(+)28 b(12:34:56.7)c(\(12d)j(34')g(56.7)p
-Ft(")f Fj(or)g(12h)h(34m)g(56.7s\))340 2535 y Fi(\017)45
+1450 y Fi(\017)45 b Fj(+)28 b(12:34:56.7)c(\(12d)j(34')g(56.7)p
+Ft(")f Fj(or)g(12h)h(34m)g(56.7s\))340 1568 y Fi(\017)45
b Fj(001)26 b(:)37 b(02)27 b(:)37 b(03.4)26 b(\(1d)i(02')f(03.4)p
-Ft(")f Fj(or)g(1h)i(02m)e(03.4s\))340 2662 y Fi(\017)45
-b Fj(22h)27 b(30)g(\(22h)g(30m)g(00s\))340 2789 y Fi(\017)45
+Ft(")f Fj(or)g(1h)i(02m)e(03.4s\))340 1685 y Fi(\017)45
+b Fj(22h)27 b(30)g(\(22h)g(30m)g(00s\))340 1802 y Fi(\017)45
b Fj(136::10)p Ft(")25 b Fj(\(136d)i(00')g(10)p Ft(")f
-Fj(or)h(136h)f(00m)h(10s\))340 2916 y Fi(\017)45 b Fj(-14M)27
+Fj(or)h(136h)f(00m)h(10s\))340 1919 y Fi(\017)45 b Fj(-14M)27
b(27S)g(\(-0d)g(14')g(27)p Ft(")f Fj(or)h(-0h)g(14m)f(27s\))340
-3043 y Fi(\017)45 b Fj(-:14:)36 b(\(-0d)27 b(14')g(00)p
-Ft(")f Fj(or)h(-0h)g(14m)g(00s\))340 3170 y Fi(\017)45
+2037 y Fi(\017)45 b Fj(-:14:)36 b(\(-0d)27 b(14')g(00)p
+Ft(")f Fj(or)h(-0h)g(14m)g(00s\))340 2154 y Fi(\017)45
b Fj(-::4.1)27 b(\(-0d)g(00')g(04.1)p Ft(")f Fj(or)g(-0h)h(00m)g
-(04.1s\))340 3297 y Fi(\017)45 b Fj(.9)p Ft(")27 b Fj(\(0d)h(00')e
-(00.9)p Ft(")p Fj(\))340 3424 y Fi(\017)45 b Fj(d12m)27
-b(\(0d)h(12')f(00)p Ft(")p Fj(\))340 3551 y Fi(\017)45
-b Fj(H)28 b(12:22.3s)d(\(0h)j(12m)f(22.3s\))340 3678
+(04.1s\))340 2271 y Fi(\017)45 b Fj(.9)p Ft(")27 b Fj(\(0d)h(00')e
+(00.9)p Ft(")p Fj(\))340 2389 y Fi(\017)45 b Fj(d12m)27
+b(\(0d)h(12')f(00)p Ft(")p Fj(\))340 2506 y Fi(\017)45
+b Fj(H)28 b(12:22.3s)d(\(0h)j(12m)f(22.3s\))340 2623
y Fi(\017)45 b Fl(<)p Fj(bad)p Fl(>)27 b Fj(\(AST)p Ft(__)p
-Fj(BAD\))227 3834 y(Where)e(alternativ)n(e)e(in)n(terpretations)g(are)h
+Fj(BAD\))227 2770 y(Where)e(alternativ)n(e)e(in)n(terpretations)g(are)h
(sho)n(wn,)g(the)h(c)n(hoice)f(of)g(angle)g(or)g(time)h(dep)r(ends)g
-(on)f(the)h(asso)r(ciated)227 3934 y(F)-7 b(ormat\(axis\))27
-b(attribute.)p 0 4121 3780 12 v 0 4252 a FA(AST)p Fe(_)p
+(on)f(the)h(asso)r(ciated)227 2869 y(F)-7 b(ormat\(axis\))27
+b(attribute.)p 0 3037 3780 12 v 0 3168 a FA(AST)p Fe(_)p
FA(UNITMAP)415 b Fd(Create)37 b(a)h(UnitMap)416 b FA(AST)p
-Fe(_)p FA(UNITMAP)0 4429 y Fc(Description:)44 b Fj(This)28
+Fe(_)p FA(UNITMAP)0 3325 y Fc(Description:)44 b Fj(This)28
b(function)g(creates)f(a)g(new)g(UnitMap)i(and)e(optionally)g
-(initialises)g(its)h(attributes.)227 4551 y(A)f(UnitMap)f(is)g(a)f
+(initialises)g(its)h(attributes.)227 3442 y(A)f(UnitMap)f(is)g(a)f
(unit)i(\(n)n(ull\))f(Mapping)g(that)g(has)g(no)f(e\013ect)i(on)e(the)i
(co)r(ordinates)d(supplied)i(to)g(it.)37 b(They)26 b(are)227
-4650 y(simply)32 b(copied.)47 b(This)31 b(can)g(b)r(e)g(useful)h(if)g
+3542 y(simply)32 b(copied.)47 b(This)31 b(can)g(b)r(e)g(useful)h(if)g
(a)f(Mapping)f(is)h(required)g(\(e.g.)47 b(to)31 b(pass)g(to)g(another)
-f(routine\))h(but)227 4750 y(y)n(ou)c(do)g(not)h(w)n(an)n(t)f(it)h(to)f
-(ha)n(v)n(e)g(an)n(y)g(e\013ect.)0 4893 y Fc(In)m(v)m(o)s(cation:)123
+f(routine\))h(but)227 3641 y(y)n(ou)c(do)g(not)h(w)n(an)n(t)f(it)h(to)f
+(ha)n(v)n(e)g(an)n(y)g(e\013ect.)0 3775 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_UNITMAP\()c(NCOORD,)h(OPTIONS,)h(STATUS)g(\))0
-5037 y Fc(Argumen)m(ts:)259 5168 y(NCOORD)31 b(=)h(INTEGER)f(\(Giv)m
-(en\))427 5267 y Fj(The)d(n)n(um)n(b)r(er)f(of)h(input)g(and)g(output)g
+3909 y Fc(Argumen)m(ts:)259 4030 y(NCOORD)31 b(=)h(INTEGER)f(\(Giv)m
+(en\))427 4130 y Fj(The)d(n)n(um)n(b)r(er)f(of)h(input)g(and)g(output)g
(co)r(ordinates)e(\(these)i(n)n(um)n(b)r(ers)f(are)g(necessarily)f(the)
-h(same\).)259 5394 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g
+h(same\).)259 4247 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g
Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-5494 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)
+4347 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)
f(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r
-(e)427 5593 y(used)k(for)f(initialising)h(the)g(new)f(UnitMap.)37
+(e)427 4446 y(used)k(for)f(initialising)h(the)g(new)f(UnitMap.)37
b(The)25 b(syn)n(tax)e(used)i(is)g(iden)n(tical)f(to)h(that)g(for)f
-(the)h(AST)p Ft(_)p Fj(SET)427 5693 y(routine.)p eop
-end
-%%Page: 403 413
-TeXDict begin 403 412 bop 3643 52 a FG(403)259 351 y
-Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-451 y Fj(The)c(global)e(status.)0 618 y Fc(Returned)32
-b(V)-8 b(alue:)259 760 y(AST)p Ft(_)p Fc(UNITMAP)33 b(=)f(INTEGER)427
-860 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(UnitMap.)0
-1027 y Fc(Notes:)340 1315 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
-b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
-(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 1415 y(set)28 b(to)f(an)h(error)d(v)-5
-b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-0 1619 3780 12 v 0 1750 a FA(AST)p Fe(_)p FA(VERSION)1105
-1751 y Fd(Return)38 b(the)h(v)m(ersion)e(of)i(the)f(AST)1428
-1851 y(library)e(b)s(eing)j(used)2827 1750 y FA(AST)p
-Fe(_)p FA(VERSION)0 2045 y Fc(Description:)44 b Fj(This)30
-b(function)h(returns)e(an)g(in)n(teger)g(represen)n(ting)f(the)j(v)n
-(ersion)d(of)i(the)g(AST)g(library)f(b)r(eing)h(used.)227
-2145 y(The)i(library)f(v)n(ersion)g(is)g(formatted)h(as)g(a)f(string)h
+(the)h(AST)p Ft(_)p Fj(SET)427 4546 y(routine.)259 4663
+y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
+427 4763 y Fj(The)c(global)e(status.)0 4909 y Fc(Returned)32
+b(V)-8 b(alue:)259 5030 y(AST)p Ft(_)p Fc(UNITMAP)33
+b(=)f(INTEGER)427 5130 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
+(UnitMap.)0 5276 y Fc(Notes:)340 5543 y Fi(\017)45 b
+Fj(A)21 b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
+Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
+(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 5643
+y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p eop end
+%%Page: 406 416
+TeXDict begin 406 415 bop 0 52 a FG(406)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p 0 351 3780 12
+v 0 482 a FA(AST)p Fe(_)p FA(VERSION)1105 483 y Fd(Return)38
+b(the)h(v)m(ersion)e(of)i(the)f(AST)1428 583 y(library)e(b)s(eing)j
+(used)2827 482 y FA(AST)p Fe(_)p FA(VERSION)0 771 y Fc(Description:)44
+b Fj(This)30 b(function)h(returns)e(an)g(in)n(teger)g(represen)n(ting)f
+(the)j(v)n(ersion)d(of)i(the)g(AST)g(library)f(b)r(eing)h(used.)227
+870 y(The)i(library)f(v)n(ersion)g(is)g(formatted)h(as)g(a)f(string)h
(suc)n(h)f(as)h Ft(")p Fj(2.0-7)p Ft(")d Fj(whic)n(h)j(con)n(tains)f
-(in)n(tegers)g(represen)n(ting)227 2244 y(the)h Ft(")p
+(in)n(tegers)g(represen)n(ting)227 970 y(the)h Ft(")p
Fj(ma)5 b(jor)29 b(v)n(ersion)p Ft(")g Fj(\(2\),)j(the)g
Ft(")p Fj(minor)e(v)n(ersion)p Ft(")f Fj(\(0\))i(and)g(the)g
Ft(")p Fj(release)p Ft(")e Fj(\(7\).)47 b(The)31 b(in)n(teger)f
-(returned)h(b)n(y)227 2344 y(this)d(function)g(com)n(bines)f(all)h
+(returned)h(b)n(y)227 1069 y(this)d(function)g(com)n(bines)f(all)h
(three)f(in)n(tegers)f(together)h(in)n(to)g(a)h(single)f(in)n(teger)f
-(using)i(the)g(expresion:)227 2471 y(\(ma)5 b(jor)27
+(using)i(the)g(expresion:)227 1194 y(\(ma)5 b(jor)27
b(v)n(ersion\))p Fi(\003)p Fj(1E6)d(+)k(\(minor)f(v)n(ersion\))p
-Fi(\003)p Fj(1E3)d(+)k(\(release\))0 2626 y Fc(In)m(v)m(o)s(cation:)123
-b Ft(RESULT)41 b(=)i(AST_VERSION\(\))0 2781 y Fc(Class)31
-b(Applicabilit)m(y:)259 2923 y(Ob)5 b(ject)427 3022 y
+Fi(\003)p Fj(1E3)d(+)k(\(release\))0 1343 y Fc(In)m(v)m(o)s(cation:)123
+b Ft(RESULT)41 b(=)i(AST_VERSION\(\))0 1492 y Fc(Class)31
+b(Applicabilit)m(y:)259 1628 y(Ob)5 b(ject)427 1727 y
Fj(This)28 b(routine)f(applies)g(to)h(all)f(Ob)5 b(jects.)0
-3190 y Fc(Returned)32 b(V)-8 b(alue:)259 3332 y(AST)p
-Ft(_)p Fc(VERSION)31 b(=)h(INTEGER)427 3431 y Fj(The)37
+1889 y Fc(Returned)32 b(V)-8 b(alue:)259 2025 y(AST)p
+Ft(_)p Fc(VERSION)31 b(=)h(INTEGER)427 2125 y Fj(The)37
b(ma)5 b(jor)35 b(v)n(ersion,)j(minor)e(v)n(ersion)f(and)h(release)g(n)
n(um)n(b)r(ers)g(for)g(the)h(AST)g(library)-7 b(,)37
-b(enco)r(ded)g(as)f(a)427 3531 y(single)27 b(in)n(teger.)p
-0 3736 V 0 3866 a FA(AST)p Fe(_)p FA(W)-15 b(ARNINGS)231
-b Fd(Returns)38 b(an)m(y)g(w)m(arnings)1321 3981 y(issued)h(b)m(y)g
-(the)g(previous)1296 4095 y(read)f(or)h(write)e(op)s(eration)2681
-3866 y FA(AST)p Fe(_)p FA(W)-15 b(ARNINGS)0 4289 y Fc(Description:)44
+b(enco)r(ded)g(as)f(a)427 2224 y(single)27 b(in)n(teger.)p
+0 2423 V 0 2553 a FA(AST)p Fe(_)p FA(W)-15 b(ARNINGS)231
+b Fd(Returns)38 b(an)m(y)g(w)m(arnings)1321 2667 y(issued)h(b)m(y)g
+(the)g(previous)1296 2782 y(read)f(or)h(write)e(op)s(eration)2681
+2553 y FA(AST)p Fe(_)p FA(W)-15 b(ARNINGS)0 2970 y Fc(Description:)44
b Fj(This)28 b(function)f(returns)g(an)g(AST)h(KeyMap)e(ob)5
b(ject)27 b(holding)g(the)g(text)h(of)f(an)n(y)g(w)n(arnings)e(issued)i
-(as)227 4389 y(a)i(result)g(of)g(the)g(previous)f(in)n(v)n(o)r(cation)g
+(as)227 3070 y(a)i(result)g(of)g(the)g(previous)f(in)n(v)n(o)r(cation)g
(of)h(the)h(AST)p Ft(_)p Fj(READ)f(or)g(AST)p Ft(_)p
-Fj(WRITE)g(function)g(on)g(the)h(Channel.)227 4489 y(If)e(no)g(w)n
+Fj(WRITE)g(function)g(on)g(the)h(Channel.)227 3169 y(If)e(no)g(w)n
(arnings)e(w)n(ere)g(issued,)i(a)f(AST)p Ft(__)p Fj(NULL)g(will)h(b)r
-(e)g(returned.)227 4616 y(Suc)n(h)d(w)n(arnings)e(are)h(non-fatal)g
+(e)g(returned.)227 3294 y(Suc)n(h)d(w)n(arnings)e(are)h(non-fatal)g
(and)g(will)h(not)g(prev)n(en)n(t)f(the)h(read)e(or)h(write)h(op)r
-(eration)e(succeeding.)36 b(Ho)n(w)n(ev)n(er,)227 4716
+(eration)e(succeeding.)36 b(Ho)n(w)n(ev)n(er,)227 3393
y(the)29 b(con)n(v)n(erted)f(ob)5 b(ject)28 b(ma)n(y)g(not)h(b)r(e)g
(iden)n(tical)f(to)h(the)g(original)e(ob)5 b(ject)28
b(in)h(all)f(resp)r(ects.)40 b(Di\013erences)29 b(whic)n(h)227
-4815 y(w)n(ould)23 b(usually)f(b)r(e)h(deemed)g(as)f(insigni\014can)n
+3493 y(w)n(ould)23 b(usually)f(b)r(e)h(deemed)g(as)f(insigni\014can)n
(t)h(in)g(most)f(usual)h(cases)e(will)j(generate)d(a)h(w)n(arning,)h
-(whereas)e(more)227 4915 y(signi\014can)n(t)27 b(di\013erences)g(will)h
-(generate)e(an)i(error.)227 5042 y(The)d Ft(")p Fj(Strict)p
+(whereas)e(more)227 3592 y(signi\014can)n(t)27 b(di\013erences)g(will)h
+(generate)e(an)i(error.)227 3717 y(The)d Ft(")p Fj(Strict)p
Ft(")f Fj(attribute)h(allo)n(ws)e(this)i(w)n(arning)e(facilit)n(y)i(to)
g(b)r(e)g(switc)n(hed)f(o\013,)i(so)e(that)g(a)h(fatal)f(error)f(is)i
-(alw)n(a)n(ys)227 5142 y(rep)r(orted)i(for)g(an)n(y)g(con)n(v)n(ersion)
-e(error.)0 5297 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
-b(=)i(AST_WARNINGS\()38 b(THIS,)k(STATUS)f(\))0 5452
-y Fc(Argumen)m(ts:)259 5593 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
-5693 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Channel.)p eop
-end
-%%Page: 404 414
-TeXDict begin 404 413 bop 0 52 a FG(404)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(ST)-8
-b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
-451 y Fj(The)c(global)e(status.)0 616 y Fc(Class)31 b(Applicabilit)m
-(y:)259 755 y(Channel)427 854 y Fj(The)25 b(basic)f(Channel)h(class)f
-(generates)f(a)h(w)n(arning)g(when)g(ev)n(er)g(an)h(un-recognised)e
-(item)i(is)f(encoun)n(tered)427 954 y(whilst)32 b(reading)f(an)g(Ob)5
-b(ject)32 b(from)f(an)g(external)g(data)g(source.)48
-b(If)32 b(Strict)g(is)g(zero)e(\(the)j(default\),)g(then)427
-1054 y(unexp)r(ected)28 b(items)f(in)g(the)g(Ob)5 b(ject)27
-b(description)g(are)f(simply)h(ignored,)e(and)i(an)n(y)f(remaining)g
-(items)i(are)427 1153 y(used)h(to)g(construct)g(the)g(returned)f(Ob)5
+(alw)n(a)n(ys)227 3816 y(rep)r(orted)i(for)g(an)n(y)g(con)n(v)n(ersion)
+e(error.)0 3965 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
+b(=)i(AST_WARNINGS\()38 b(THIS,)k(STATUS)f(\))0 4114
+y Fc(Argumen)m(ts:)259 4250 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m(en\))427
+4350 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Channel.)259
+4483 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 4582 y Fj(The)c(global)e(status.)0 4744
+y Fc(Class)31 b(Applicabilit)m(y:)259 4880 y(Channel)427
+4979 y Fj(The)25 b(basic)f(Channel)h(class)f(generates)f(a)h(w)n
+(arning)g(when)g(ev)n(er)g(an)h(un-recognised)e(item)i(is)f(encoun)n
+(tered)427 5079 y(whilst)32 b(reading)f(an)g(Ob)5 b(ject)32
+b(from)f(an)g(external)g(data)g(source.)48 b(If)32 b(Strict)g(is)g
+(zero)e(\(the)j(default\),)g(then)427 5178 y(unexp)r(ected)28
+b(items)f(in)g(the)g(Ob)5 b(ject)27 b(description)g(are)f(simply)h
+(ignored,)e(and)i(an)n(y)f(remaining)g(items)i(are)427
+5278 y(used)h(to)g(construct)g(the)g(returned)f(Ob)5
b(ject.)41 b(If)30 b(Strict)f(is)g(non-zero,)f(an)g(error)f(will)j(b)r
-(e)f(rep)r(orted)f(and)h(a)427 1253 y(NULL)f(Ob)5 b(ject)28
+(e)f(rep)r(orted)f(and)h(a)427 5378 y(NULL)f(Ob)5 b(ject)28
b(p)r(oin)n(ter)f(returned)g(if)h(an)n(y)f(unexp)r(ected)h(items)g(are)
-f(encoun)n(tered.)427 1370 y(As)f(AST)g(con)n(tin)n(ues)f(to)h(b)r(e)g
+f(encoun)n(tered.)427 5494 y(As)f(AST)g(con)n(tin)n(ues)f(to)h(b)r(e)g
(dev)n(elop)r(ed,)g(new)g(attributes)f(are)g(added)h(o)r(ccasionally)e
-(to)h(selected)h(classes.)427 1469 y(If)35 b(an)f(older)f(v)n(ersion)g
+(to)h(selected)h(classes.)427 5593 y(If)35 b(an)f(older)f(v)n(ersion)g
(of)h(AST)h(is)f(used)g(to)g(read)f(external)h(Ob)5 b(ject)34
-b(descriptions)f(created)h(b)n(y)g(a)f(more)427 1569
+b(descriptions)f(created)h(b)n(y)g(a)f(more)427 5693
y(recen)n(t)20 b(v)n(ersion)f(of)i(AST,)g(then)g(the)g(Channel)f(class)
-g(will,)i(b)n(y)f(default,)h(ignore)d(the)i(new)g(attributes,)h(using)
-427 1669 y(the)35 b(remaining)e(attributes)h(to)h(construct)e(the)i(Ob)
-5 b(ject.)57 b(This)34 b(is)g(usually)g(a)g(go)r(o)r(d)f(thing.)58
-b(Ho)n(w)n(ev)n(er,)427 1768 y(since)32 b(external)f(Ob)5
+g(will,)i(b)n(y)f(default,)h(ignore)d(the)i(new)g(attributes,)h(using)p
+eop end
+%%Page: 407 417
+TeXDict begin 407 416 bop 3643 52 a FG(407)427 351 y
+Fj(the)35 b(remaining)e(attributes)h(to)h(construct)e(the)i(Ob)5
+b(ject.)57 b(This)34 b(is)g(usually)g(a)g(go)r(o)r(d)f(thing.)58
+b(Ho)n(w)n(ev)n(er,)427 451 y(since)32 b(external)f(Ob)5
b(ject)32 b(descriptions)f(are)g(often)h(stored)f(in)i(plain)f(text,)h
-(it)f(is)g(p)r(ossible)g(to)g(edit)g(them)427 1868 y(using)37
+(it)f(is)g(p)r(ossible)g(to)g(edit)g(them)427 551 y(using)37
b(a)g(text)h(editor.)65 b(This)37 b(giv)n(es)f(rise)h(to)g(the)h(p)r
(ossibilit)n(y)f(of)g(gen)n(uine)g(errors)e(in)j(the)f(description)427
-1968 y(due)25 b(to)g(\014nger-slips,)f(t)n(yp)r(os,)i(or)e(simple)h
+650 y(due)25 b(to)g(\014nger-slips,)f(t)n(yp)r(os,)i(or)e(simple)h
(mis-understanding.)35 b(Suc)n(h)25 b(inappropriate)e(attributes)i
-(will)g(b)r(e)427 2067 y(ignored)k(if)h(Strict)g(is)g(left)g(at)g(its)g
+(will)g(b)r(e)427 750 y(ignored)k(if)h(Strict)g(is)g(left)g(at)g(its)g
(default)g(zero)f(v)-5 b(alue.)43 b(This)30 b(will)g(cause)f(the)h
-(mis-sp)r(elled)g(attribute)g(to)427 2167 y(rev)n(ert)c(to)h(its)g
+(mis-sp)r(elled)g(attribute)g(to)427 849 y(rev)n(ert)c(to)h(its)g
(default)g(v)-5 b(alue,)27 b(p)r(oten)n(tially)g(causing)f(subtle)h(c)n
(hanges)f(in)h(the)h(b)r(eha)n(viour)d(of)i(application)427
-2266 y(soft)n(w)n(are.)38 b(If)29 b(suc)n(h)f(an)g(e\013ect)h(is)g
-(susp)r(ected,)g(the)g(Strict)f(attribute)h(can)f(b)r(e)h(set)f
-(non-zero,)f(resulting)h(in)427 2366 y(the)g(erroneous)e(attribute)i(b)
-r(eing)f(iden)n(ti\014ed)h(in)g(an)f(error)f(message.)259
-2500 y Fc(FitsChan)427 2600 y Fj(The)20 b(returned)e(KeyMap)h(will)g
-(con)n(tain)g(w)n(arnings)f(for)g(all)h(conditions)g(listed)h(in)f(the)
-h(W)-7 b(arnings)18 b(attribute.)259 2734 y Fc(XmlChan)427
-2834 y Fj(Rep)r(orts)27 b(con)n(v)n(ersion)f(errors)f(that)j(result)f
-(in)h(what)g(are)e(usally)h(insigni\014can)n(t)g(c)n(hanges.)0
-2998 y Fc(Returned)32 b(V)-8 b(alue:)259 3138 y(AST)p
-Ft(_)p Fc(W)d(ARNINGS)32 b(=)g(INTEGER)427 3237 y Fj(A)24
+949 y(soft)n(w)n(are.)38 b(If)29 b(suc)n(h)f(an)g(e\013ect)h(is)g(susp)
+r(ected,)g(the)g(Strict)f(attribute)h(can)f(b)r(e)h(set)f(non-zero,)f
+(resulting)h(in)427 1049 y(the)g(erroneous)e(attribute)i(b)r(eing)f
+(iden)n(ti\014ed)h(in)g(an)f(error)f(message.)259 1181
+y Fc(FitsChan)427 1281 y Fj(The)20 b(returned)e(KeyMap)h(will)g(con)n
+(tain)g(w)n(arnings)f(for)g(all)h(conditions)g(listed)h(in)f(the)h(W)-7
+b(arnings)18 b(attribute.)259 1413 y Fc(XmlChan)427 1513
+y Fj(Rep)r(orts)27 b(con)n(v)n(ersion)f(errors)f(that)j(result)f(in)h
+(what)g(are)e(usally)h(insigni\014can)n(t)g(c)n(hanges.)0
+1675 y Fc(Returned)32 b(V)-8 b(alue:)259 1811 y(AST)p
+Ft(_)p Fc(W)d(ARNINGS)32 b(=)g(INTEGER)427 1910 y Fj(A)24
b(p)r(oin)n(ter)g(to)g(the)g(KeyMap)f(holding)g(the)h(w)n(arning)f
(messages,)g(or)g(AST)p Ft(__)p Fj(NULL)h(if)g(no)f(w)n(arnings)g(w)n
-(ere)427 3337 y(issued)28 b(during)f(the)h(previous)e(read)h(op)r
-(eration.)0 3501 y Fc(Notes:)340 3787 y Fi(\017)45 b
+(ere)427 2010 y(issued)28 b(during)f(the)h(previous)e(read)h(op)r
+(eration.)0 2171 y Fc(Notes:)340 2454 y Fi(\017)45 b
Fj(The)28 b(returned)f(KeyMap)g(uses)g(k)n(eys)g(of)g(the)h(form)f
Ft(")p Fj(W)-7 b(arning)p Ft(_)p Fj(1)p Ft(")p Fj(,)26
b Ft(")p Fj(W)-7 b(arning)p Ft(_)p Fj(2)p Ft(")p Fj(,)25
-b(etc.)340 3921 y Fi(\017)45 b Fj(A)30 b(v)-5 b(alue)29
+b(etc.)340 2586 y Fi(\017)45 b Fj(A)30 b(v)-5 b(alue)29
b(of)g(AST)p Ft(__)p Fj(NULL)h(will)f(b)r(e)h(returned)f(if)h(this)f
(function)h(is)f(in)n(v)n(ok)n(ed)f(with)i(ST)-7 b(A)g(TUS)30
-b(set)g(to)f(an)427 4021 y(error)d(v)-5 b(alue,)27 b(or)g(if)h(it)g
-(should)g(fail)f(for)g(an)n(y)g(reason.)p 0 4223 3780
-12 v 0 4353 a FA(AST)p Fe(_)p FA(W)l(CSMAP)466 b Fd(Create)37
-b(a)h(WcsMap)469 b FA(AST)p Fe(_)p FA(W)l(CSMAP)0 4545
+b(set)g(to)f(an)427 2686 y(error)d(v)-5 b(alue,)27 b(or)g(if)h(it)g
+(should)g(fail)f(for)g(an)n(y)g(reason.)p 0 2884 3780
+12 v 0 3015 a FA(AST)p Fe(_)p FA(W)l(CSMAP)466 b Fd(Create)37
+b(a)h(WcsMap)469 b FA(AST)p Fe(_)p FA(W)l(CSMAP)0 3203
y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
(WcsMap)h(and)f(optionally)g(initialises)g(its)h(attributes.)227
-4670 y(A)g(WcsMap)g(is)f(used)h(to)g(represen)n(t)e(sky)h(co)r
+3327 y(A)g(WcsMap)g(is)f(used)h(to)g(represen)n(t)e(sky)h(co)r
(ordinate)g(pro)5 b(jections)26 b(as)h(describ)r(ed)h(in)f(the)i
-(\(draft\))f(FITS)g(w)n(orld)227 4770 y(co)r(ordinate)20
+(\(draft\))f(FITS)g(w)n(orld)227 3427 y(co)r(ordinate)20
b(system)g(\(FITS-W)n(CS\))h(pap)r(er)f(b)n(y)g(E.W.)h(Griesen)f(and)g
(M.)h(Calabretta)e(\(A)i(&)f(A,)h(in)g(preparation\).)227
-4870 y(This)29 b(pap)r(er)f(de\014nes)h(a)f(set)h(of)f(functions,)h(or)
+3527 y(This)29 b(pap)r(er)f(de\014nes)h(a)f(set)h(of)f(functions,)h(or)
f(sky)g(pro)5 b(jections,)28 b(whic)n(h)h(transform)e
-(longitude-latitude)i(pairs)227 4969 y(represen)n(ting)d(spherical)h
+(longitude-latitude)i(pairs)227 3626 y(represen)n(ting)d(spherical)h
(celestial)g(co)r(ordinates)f(in)n(to)h(corresp)r(onding)f(pairs)h(of)g
-(Cartesian)f(co)r(ordinates)g(\(and)227 5069 y(vice)i(v)n(ersa\).)227
-5195 y(A)j(WcsMap)f(is)g(a)g(sp)r(ecialised)g(form)g(of)g(Mapping)g
+(Cartesian)f(co)r(ordinates)g(\(and)227 3726 y(vice)i(v)n(ersa\).)227
+3850 y(A)j(WcsMap)f(is)g(a)g(sp)r(ecialised)g(form)g(of)g(Mapping)g
(whic)n(h)g(implemen)n(ts)h(these)f(sky)g(pro)5 b(jections)29
-b(and)h(applies)227 5295 y(them)25 b(to)g(a)f(sp)r(eci\014ed)h(pair)f
+b(and)h(applies)227 3950 y(them)25 b(to)g(a)f(sp)r(eci\014ed)h(pair)f
(of)g(co)r(ordinates.)35 b(All)25 b(the)g(pro)5 b(jections)23
b(in)i(the)g(FITS-W)n(CS)g(pap)r(er)f(are)g(supp)r(orted,)227
-5394 y(plus)32 b(the)f(no)n(w)g(deprecated)f Ft(")p Fj(T)-7
+4049 y(plus)32 b(the)f(no)n(w)g(deprecated)f Ft(")p Fj(T)-7
b(AN)32 b(with)f(p)r(olynomial)g(correction)e(terms)p
Ft(")i Fj(pro)5 b(jection)30 b(whic)n(h)h(is)g(refered)g(to)227
-5494 y(here)22 b(b)n(y)g(the)g(co)r(de)g Ft(")p Fj(TPN)p
+4149 y(here)22 b(b)n(y)g(the)g(co)r(de)g Ft(")p Fj(TPN)p
Ft(")p Fj(.)34 b(Using)22 b(the)g(FITS-W)n(CS)g(terminology)-7
b(,)22 b(the)g(transformation)f(is)h(b)r(et)n(w)n(een)g
-Ft(")p Fj(nativ)n(e)227 5593 y(spherical)p Ft(")32 b
+Ft(")p Fj(nativ)n(e)227 4249 y(spherical)p Ft(")32 b
Fj(and)g Ft(")p Fj(pro)5 b(jection)31 b(plane)p Ft(")h
Fj(co)r(ordinates.)51 b(These)32 b(co)r(ordinates)g(ma)n(y)-7
b(,)33 b(optionally)-7 b(,)33 b(b)r(e)g(em)n(b)r(edded)227
-5693 y(in)j(a)f(space)g(with)h(more)f(than)h(t)n(w)n(o)f(dimensions,)i
-(the)f(remaining)f(co)r(ordinates)f(b)r(eing)i(copied)f(unc)n(hanged.)p
-eop end
-%%Page: 405 415
-TeXDict begin 405 414 bop 3643 52 a FG(405)227 351 y
-Fj(Note,)27 b(ho)n(w)n(ev)n(er,)d(that)j(for)f(consistency)f(with)i
-(other)e(AST)i(facilities,)g(a)f(WcsMap)g(handles)g(co)r(ordinates)e
-(that)227 451 y(represen)n(t)j(angles)f(in)i(radians)e(\(rather)h(than)
-h(the)g(degrees)e(used)i(b)n(y)f(FITS-W)n(CS\).)227 588
-y(The)32 b(t)n(yp)r(e)g(of)f(FITS-W)n(CS)h(pro)5 b(jection)31
-b(to)g(b)r(e)h(used)g(and)f(the)h(co)r(ordinates)e(\(axes\))h(to)h
-(whic)n(h)f(it)h(applies)g(are)227 688 y(sp)r(eci\014ed)g(when)g(a)g
-(WcsMap)g(is)f(\014rst)h(created.)49 b(The)32 b(pro)5
-b(jection)31 b(t)n(yp)r(e)h(ma)n(y)f(subsequen)n(tly)g(b)r(e)h
-(determined)227 788 y(using)g(the)f(WcsT)n(yp)r(e)h(attribute)g(and)f
-(the)h(co)r(ordinates)e(on)i(whic)n(h)f(it)h(acts)f(ma)n(y)g(b)r(e)h
-(determined)g(using)f(the)227 887 y(WcsAxis\(lonlat\))d(attribute.)227
-1025 y(Eac)n(h)37 b(WcsMap)i(also)e(allo)n(ws)g(up)i(to)f(100)f
-Ft(")p Fj(pro)5 b(jection)37 b(parameters)p Ft(")f Fj(to)i(b)r(e)h
-(asso)r(ciated)e(with)i(eac)n(h)e(axis.)227 1125 y(These)31
-b(sp)r(ecify)h(the)g(precise)f(form)g(of)g(the)h(pro)5
+4348 y(in)j(a)f(space)g(with)h(more)f(than)h(t)n(w)n(o)f(dimensions,)i
+(the)f(remaining)f(co)r(ordinates)f(b)r(eing)i(copied)f(unc)n(hanged.)
+227 4448 y(Note,)27 b(ho)n(w)n(ev)n(er,)d(that)j(for)f(consistency)f
+(with)i(other)e(AST)i(facilities,)g(a)f(WcsMap)g(handles)g(co)r
+(ordinates)e(that)227 4548 y(represen)n(t)j(angles)f(in)i(radians)e
+(\(rather)h(than)h(the)g(degrees)e(used)i(b)n(y)f(FITS-W)n(CS\).)227
+4672 y(The)32 b(t)n(yp)r(e)g(of)f(FITS-W)n(CS)h(pro)5
+b(jection)31 b(to)g(b)r(e)h(used)g(and)f(the)h(co)r(ordinates)e
+(\(axes\))h(to)h(whic)n(h)f(it)h(applies)g(are)227 4772
+y(sp)r(eci\014ed)g(when)g(a)g(WcsMap)g(is)f(\014rst)h(created.)49
+b(The)32 b(pro)5 b(jection)31 b(t)n(yp)r(e)h(ma)n(y)f(subsequen)n(tly)g
+(b)r(e)h(determined)227 4871 y(using)g(the)f(WcsT)n(yp)r(e)h(attribute)
+g(and)f(the)h(co)r(ordinates)e(on)i(whic)n(h)f(it)h(acts)f(ma)n(y)g(b)r
+(e)h(determined)g(using)f(the)227 4971 y(WcsAxis\(lonlat\))d
+(attribute.)227 5095 y(Eac)n(h)37 b(WcsMap)i(also)e(allo)n(ws)g(up)i
+(to)f(100)f Ft(")p Fj(pro)5 b(jection)37 b(parameters)p
+Ft(")f Fj(to)i(b)r(e)h(asso)r(ciated)e(with)i(eac)n(h)e(axis.)227
+5195 y(These)31 b(sp)r(ecify)h(the)g(precise)f(form)g(of)g(the)h(pro)5
b(jection,)31 b(and)h(are)e(accessed)g(using)h(PVi)p
-Ft(_)p Fj(m)h(attribute,)g(where)227 1224 y Ft(")p Fj(i)p
+Ft(_)p Fj(m)h(attribute,)g(where)227 5295 y Ft(")p Fj(i)p
Ft(")27 b Fj(is)h(the)g(in)n(teger)f(axis)h(index)f(\(starting)h(at)g
(1\),)f(and)h(m)g(is)g(an)g(in)n(teger)f Ft(")p Fj(parameter)f(index)p
-Ft(")h Fj(in)h(the)h(range)d(0)227 1324 y(to)i(99.)39
+Ft(")h Fj(in)h(the)h(range)d(0)227 5394 y(to)i(99.)39
b(The)28 b(n)n(um)n(b)r(er)g(of)g(pro)5 b(jection)27
b(parameters)g(required)g(b)n(y)h(eac)n(h)g(pro)5 b(jection,)27
-b(and)i(their)f(meanings,)g(are)227 1423 y(dep)r(enden)n(t)c(up)r(on)e
+b(and)i(their)f(meanings,)g(are)227 5494 y(dep)r(enden)n(t)c(up)r(on)e
(the)h(pro)5 b(jection)22 b(t)n(yp)r(e)h(\(most)g(pro)5
b(jections)21 b(either)h(do)h(not)f(use)h(an)n(y)f(pro)5
-b(jection)21 b(parameters,)227 1523 y(or)h(use)g(parameters)f(1)h(and)g
+b(jection)21 b(parameters,)227 5593 y(or)h(use)g(parameters)f(1)h(and)g
(2)g(asso)r(ciated)f(with)i(the)g(latitude)g(axis\).)35
b(Before)21 b(creating)h(a)g(WcsMap)g(y)n(ou)g(should)227
-1623 y(consult)31 b(the)h(FITS-W)n(CS)g(pap)r(er)e(for)h(details)g(of)h
+5693 y(consult)31 b(the)h(FITS-W)n(CS)g(pap)r(er)e(for)h(details)g(of)h
(whic)n(h)f(pro)5 b(jection)30 b(parameters)g(are)g(required,)i(and)f
-(whic)n(h)227 1722 y(ha)n(v)n(e)h(defaults.)53 b(When)34
-b(creating)e(the)h(WcsMap,)h(y)n(ou)e(m)n(ust)h(explicitly)g(set)g(v)-5
-b(alues)33 b(for)f(all)h(those)g(required)227 1822 y(pro)5
-b(jection)27 b(parameters)f(whic)n(h)h(do)h(not)f(ha)n(v)n(e)g
-(defaults)g(de\014ned)h(in)g(this)g(pap)r(er.)0 1997
+(whic)n(h)p eop end
+%%Page: 408 418
+TeXDict begin 408 417 bop 0 52 a FG(408)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)227 351 y Fj(ha)n(v)n(e)h
+(defaults.)53 b(When)34 b(creating)e(the)h(WcsMap,)h(y)n(ou)e(m)n(ust)h
+(explicitly)g(set)g(v)-5 b(alues)33 b(for)f(all)h(those)g(required)227
+451 y(pro)5 b(jection)27 b(parameters)f(whic)n(h)h(do)h(not)f(ha)n(v)n
+(e)g(defaults)g(de\014ned)h(in)g(this)g(pap)r(er.)0 611
y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_WCSMAP\()c
(NCOORD,)i(TYPE,)g(LONAX,)g(LATAX,)g(OPTIONS,)g(STATUS)g(\))0
-2173 y Fc(Argumen)m(ts:)259 2335 y(NCOORD)31 b(=)h(INTEGER)f(\(Giv)m
-(en\))427 2435 y Fj(The)25 b(n)n(um)n(b)r(er)f(of)g(co)r(ordinate)g(v)
+772 y Fc(Argumen)m(ts:)259 920 y(NCOORD)31 b(=)h(INTEGER)f(\(Giv)m
+(en\))427 1019 y Fj(The)25 b(n)n(um)n(b)r(er)f(of)g(co)r(ordinate)g(v)
-5 b(alues)24 b(for)g(eac)n(h)f(p)r(oin)n(t)i(to)f(b)r(e)h(transformed)
f(\(i.e.)36 b(the)25 b(n)n(um)n(b)r(er)f(of)g(dimen-)427
-2535 y(sions)g(of)g(the)h(space)f(in)g(whic)n(h)g(the)h(p)r(oin)n(ts)g
+1119 y(sions)g(of)g(the)h(space)f(in)g(whic)n(h)g(the)h(p)r(oin)n(ts)g
(will)f(reside\).)36 b(This)24 b(m)n(ust)g(b)r(e)h(at)f(least)g(2.)36
-b(The)24 b(same)g(n)n(um)n(b)r(er)427 2634 y(is)k(applicable)f(to)g(b)r
-(oth)h(input)h(and)e(output)h(p)r(oin)n(ts.)259 2780
-y Fc(TYPE)33 b(=)f(INTEGER)f(\(Giv)m(en\))427 2880 y
+b(The)24 b(same)g(n)n(um)n(b)r(er)427 1218 y(is)k(applicable)f(to)g(b)r
+(oth)h(input)h(and)e(output)h(p)r(oin)n(ts.)259 1357
+y Fc(TYPE)33 b(=)f(INTEGER)f(\(Giv)m(en\))427 1457 y
Fj(The)g(t)n(yp)r(e)f(of)g(FITS-W)n(CS)g(pro)5 b(jection)29
b(to)i(apply)-7 b(.)44 b(This)30 b(should)g(b)r(e)h(giv)n(en)e(as)g(a)h
-(sym)n(b)r(olic)g(v)-5 b(alue)30 b(suc)n(h)427 2979 y(as)j(AST)p
+(sym)n(b)r(olic)g(v)-5 b(alue)30 b(suc)n(h)427 1556 y(as)j(AST)p
Ft(__)p Fj(T)-7 b(AN)34 b(\(for)g(a)f(tangen)n(t)h(plane)f(pro)5
b(jection\),)35 b(where)e(the)h(c)n(haracters)e(follo)n(wing)h(the)h
-(double)427 3079 y(underscore)19 b(giv)n(e)h(the)h(pro)5
+(double)427 1656 y(underscore)19 b(giv)n(e)h(the)h(pro)5
b(jection)20 b(t)n(yp)r(e)h(co)r(de)f(\(in)i(upp)r(er)e(case\))h(as)f
(used)g(in)h(the)g(FITS-W)n(CS)g Ft(")p Fj(CTYPEi)p Ft(")427
-3179 y Fj(k)n(eyw)n(ord.)34 b(Y)-7 b(ou)23 b(should)g(consult)g(the)h
+1755 y Fj(k)n(eyw)n(ord.)34 b(Y)-7 b(ou)23 b(should)g(consult)g(the)h
(FITS-W)n(CS)f(pap)r(er)g(for)f(a)h(list)h(of)f(the)g(a)n(v)-5
-b(ailable)22 b(pro)5 b(jections.)35 b(The)427 3278 y(additional)41
+b(ailable)22 b(pro)5 b(jections.)35 b(The)427 1855 y(additional)41
b(co)r(de)f(of)h(AST)p Ft(__)p Fj(TPN)g(can)f(b)r(e)h(supplied)h(whic)n
(h)f(represen)n(ts)e(a)i(T)-7 b(AN)41 b(pro)5 b(jection)40
-b(with)427 3378 y(p)r(olynomial)27 b(correction)f(terms)h(as)g
+b(with)427 1955 y(p)r(olynomial)27 b(correction)f(terms)h(as)g
(de\014ned)h(in)g(an)f(early)g(draft)g(of)h(the)g(FITS-W)n(CS)g(pap)r
-(er.)259 3524 y Fc(LONAX)k(=)g(INTEGER)g(\(Giv)m(en\))427
-3623 y Fj(The)c(index)g(of)f(the)h(longitude)g(axis.)36
+(er.)259 2093 y Fc(LONAX)k(=)g(INTEGER)g(\(Giv)m(en\))427
+2193 y Fj(The)c(index)g(of)f(the)h(longitude)g(axis.)36
b(This)27 b(should)h(lie)f(in)h(the)g(range)e(1)i(to)f(NCOORD.)259
-3769 y Fc(LA)-8 b(T)g(AX)33 b(=)f(INTEGER)g(\(Giv)m(en\))427
-3869 y Fj(The)f(index)g(of)g(the)g(latitude)g(axis.)45
+2331 y Fc(LA)-8 b(T)g(AX)33 b(=)f(INTEGER)g(\(Giv)m(en\))427
+2431 y Fj(The)f(index)g(of)g(the)g(latitude)g(axis.)45
b(This)31 b(should)f(lie)h(in)g(the)g(range)f(1)g(to)h(NCOORD)f(and)h
-(b)r(e)g(distinct)427 3969 y(from)d(LONAX.)259 4114 y
+(b)r(e)g(distinct)427 2530 y(from)d(LONAX.)259 2669 y
Fc(OPTIONS)k(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h Fi(\003)f
-Fc(\))h(\(Giv)m(en\))427 4214 y Fj(A)22 b(c)n(haracter)e(string)h(con)n
+Fc(\))h(\(Giv)m(en\))427 2768 y Fj(A)22 b(c)n(haracter)e(string)h(con)n
(taining)g(an)h(optional)f(comma-separated)e(list)j(of)g(attribute)g
-(assignmen)n(ts)f(to)g(b)r(e)427 4314 y(used)26 b(for)e(initialising)h
+(assignmen)n(ts)f(to)g(b)r(e)427 2868 y(used)26 b(for)e(initialising)h
(the)h(new)f(WcsMap.)36 b(The)26 b(syn)n(tax)e(used)h(is)h(iden)n
(tical)f(to)g(that)h(for)e(the)i(AST)p Ft(_)p Fj(SET)427
-4413 y(routine.)427 4536 y(If)i(the)g(sky)f(pro)5 b(jection)26
+2968 y(routine.)427 3087 y(If)i(the)g(sky)f(pro)5 b(jection)26
b(to)i(b)r(e)g(implemen)n(ted)g(requires)e(pro)5 b(jection)26
b(parameter)g(v)-5 b(alues)27 b(to)h(b)r(e)g(set,)f(then)427
-4636 y(this)36 b(should)e(normally)g(b)r(e)i(done)e(here)h(via)f(the)i
+3186 y(this)36 b(should)e(normally)g(b)r(e)i(done)e(here)h(via)f(the)i
(PVi)p Ft(_)p Fj(m)e(attribute)h(\(see)g(the)h Ft(")p
-Fj(Examples)p Ft(")d Fj(section\).)427 4735 y(Setting)22
+Fj(Examples)p Ft(")d Fj(section\).)427 3286 y(Setting)22
b(v)-5 b(alues)21 b(for)g(these)h(parameters)d(is)j(mandatory)e(if)i
(they)f(do)g(not)h(ha)n(v)n(e)e(default)i(v)-5 b(alues)21
-b(\(as)g(de\014ned)427 4835 y(in)28 b(the)g(FITS-W)n(CS)g(pap)r(er\).)
-259 4981 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 5080 y Fj(The)c(global)e(status.)0 5268
-y Fc(Returned)32 b(V)-8 b(alue:)259 5431 y(AST)p Ft(_)p
-Fc(W)m(CSMAP)32 b(=)g(INTEGER)427 5531 y Fj(A)c(p)r(oin)n(ter)f(to)h
-(the)g(new)g(WcsMap.)0 5718 y Fc(Examples:)p eop end
-%%Page: 406 416
-TeXDict begin 406 415 bop 0 52 a FG(406)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)227 355 y Fy(WCSMAP)46
-b(=)i(AST)p Ft(_)p Fy(WCSMAP\()c(2,)k(AST)p Ft(__)p Fy(MER,)d(1,)i(2,)g
-(')g(',)h(STATUS)e(\))427 451 y Fj(Creates)19 b(a)h(WcsMap)g(that)g
-(implemen)n(ts)g(a)g(FITS-W)n(CS)g(Mercator)e(pro)5 b(jection)19
-b(on)h(pairs)f(of)h(co)r(ordinates,)427 551 y(with)28
-b(co)r(ordinates)f(1)g(and)h(2)f(represen)n(ting)f(the)i(longitude)g
-(and)f(latitude)h(resp)r(ectiv)n(ely)-7 b(.)37 b(Note)27
-b(that)h(the)427 650 y(FITS-W)n(CS)g(Mercator)e(pro)5
-b(jection)26 b(do)r(es)i(not)f(require)g(an)n(y)g(pro)5
-b(jection)26 b(parameters.)227 781 y Fy(WCSMAP)46 b(=)i(AST)p
-Ft(_)p Fy(WCSMAP\()c(3,)k(AST)p Ft(__)p Fy(COE,)d(2,)i(3,)g('PV3)p
-Ft(_)p Fy(1=40.0',)d(STATUS)i(\))427 877 y Fj(Creates)20
+b(\(as)g(de\014ned)427 3386 y(in)28 b(the)g(FITS-W)n(CS)g(pap)r(er\).)
+259 3524 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 3624 y Fj(The)c(global)e(status.)0 3797
+y Fc(Returned)32 b(V)-8 b(alue:)259 3944 y(AST)p Ft(_)p
+Fc(W)m(CSMAP)32 b(=)g(INTEGER)427 4044 y Fj(A)c(p)r(oin)n(ter)f(to)h
+(the)g(new)g(WcsMap.)0 4217 y Fc(Examples:)227 4368 y
+Fy(WCSMAP)46 b(=)i(AST)p Ft(_)p Fy(WCSMAP\()c(2,)k(AST)p
+Ft(__)p Fy(MER,)d(1,)i(2,)g(')g(',)h(STATUS)e(\))427
+4464 y Fj(Creates)19 b(a)h(WcsMap)g(that)g(implemen)n(ts)g(a)g(FITS-W)n
+(CS)g(Mercator)e(pro)5 b(jection)19 b(on)h(pairs)f(of)h(co)r
+(ordinates,)427 4564 y(with)28 b(co)r(ordinates)f(1)g(and)h(2)f
+(represen)n(ting)f(the)i(longitude)g(and)f(latitude)h(resp)r(ectiv)n
+(ely)-7 b(.)37 b(Note)27 b(that)h(the)427 4663 y(FITS-W)n(CS)g
+(Mercator)e(pro)5 b(jection)26 b(do)r(es)i(not)f(require)g(an)n(y)g
+(pro)5 b(jection)26 b(parameters.)227 4806 y Fy(WCSMAP)46
+b(=)i(AST)p Ft(_)p Fy(WCSMAP\()c(3,)k(AST)p Ft(__)p Fy(COE,)d(2,)i(3,)g
+('PV3)p Ft(_)p Fy(1=40.0',)d(STATUS)i(\))427 4901 y Fj(Creates)20
b(a)g(WcsMap)g(that)h(implemen)n(ts)g(a)f(FITS-W)n(CS)g(conical)g
(equal)g(area)f(pro)5 b(jection.)33 b(The)21 b(WcsMap)427
-976 y(acts)k(on)h(p)r(oin)n(ts)f(in)h(a)f(3-dimensional)f(space;)i(co)r
-(ordinates)e(2)h(and)h(3)f(represen)n(t)f(longitude)i(and)f(latitude)
-427 1076 y(resp)r(ectiv)n(ely)-7 b(,)29 b(while)g(the)g(v)-5
+5001 y(acts)k(on)h(p)r(oin)n(ts)f(in)h(a)f(3-dimensional)f(space;)i(co)
+r(ordinates)e(2)h(and)h(3)f(represen)n(t)f(longitude)i(and)f(latitude)
+427 5100 y(resp)r(ectiv)n(ely)-7 b(,)29 b(while)g(the)g(v)-5
b(alues)29 b(of)g(co)r(ordinate)e(1)i(are)f(copied)g(unc)n(hanged.)40
-b(Pro)5 b(jection)28 b(parameter)f(1)427 1176 y(asso)r(ciat)n(y)n(ed)22
+b(Pro)5 b(jection)28 b(parameter)f(1)427 5200 y(asso)r(ciat)n(y)n(ed)22
b(with)j(the)g(latitude)f(axis)g(\(corresp)r(onding)e(to)i(FITS)h(k)n
(eyw)n(ord)d Ft(")p Fj(PV3)p Ft(_)p Fj(1)p Ft(")p Fj(\))g(is)j
-(required)e(and)427 1275 y(has)k(no)h(default,)g(so)f(is)g(set)h
+(required)e(and)427 5300 y(has)k(no)h(default,)g(so)f(is)g(set)h
(explicitly)g(to)f(40.0)g(degrees.)35 b(Pro)5 b(jection)26
-b(parameter)h(2)g(\(corresp)r(onding)f(to)427 1375 y(FITS)i(k)n(eyw)n
+b(parameter)h(2)g(\(corresp)r(onding)f(to)427 5399 y(FITS)i(k)n(eyw)n
(ord)e Ft(")p Fj(PV3)p Ft(_)p Fj(2)p Ft(")p Fj(\))f(is)j(required)f
(but)h(has)f(a)g(default)h(of)g(zero,)e(so)h(need)h(not)f(b)r(e)h(sp)r
-(eci\014ed.)0 1531 y Fc(Notes:)340 1807 y Fi(\017)45
-b Fj(The)34 b(forw)n(ard)f(transformation)f(of)i(a)g(WcsMap)f(con)n(v)n
-(erts)g(b)r(et)n(w)n(een)h(FITS-W)n(CS)g Ft(")p Fj(nativ)n(e)f
-(spherical)p Ft(")427 1907 y Fj(and)24 b Ft(")p Fj(relativ)n(e)e(ph)n
-(ysical)p Ft(")g Fj(co)r(ordinates,)h(while)h(the)f(in)n(v)n(erse)g
-(transformation)e(con)n(v)n(erts)h(in)i(the)g(opp)r(osite)427
-2007 y(direction.)68 b(This)38 b(arrangemen)n(t)e(ma)n(y)h(b)r(e)h(rev)
-n(ersed,)h(if)g(required,)g(b)n(y)f(using)g(AST)p Ft(_)p
-Fj(INVER)-7 b(T)38 b(or)f(b)n(y)427 2106 y(setting)28
-b(the)g(In)n(v)n(ert)f(attribute)g(to)h(a)f(non-zero)f(v)-5
-b(alue.)340 2233 y Fi(\017)45 b Fj(If)27 b(an)n(y)f(set)h(of)f(co)r
-(ordinates)g(cannot)g(b)r(e)h(transformed)e(\(for)i(example,)f(man)n(y)
-g(pro)5 b(jections)26 b(do)g(not)g(co)n(v)n(er)427 2333
-y(the)i(en)n(tire)f(celestial)h(sphere\),)f(then)h(a)f(WcsMap)h(will)f
-(yield)h(co)r(ordinate)e(v)-5 b(alues)28 b(of)f(AST)p
-Ft(__)p Fj(BAD.)340 2460 y Fi(\017)45 b Fj(The)29 b(v)-5
+(eci\014ed.)0 5572 y Fc(Notes:)p eop end
+%%Page: 409 419
+TeXDict begin 409 418 bop 3643 52 a FG(409)340 351 y
+Fi(\017)45 b Fj(The)34 b(forw)n(ard)f(transformation)f(of)i(a)g(WcsMap)
+f(con)n(v)n(erts)g(b)r(et)n(w)n(een)h(FITS-W)n(CS)g Ft(")p
+Fj(nativ)n(e)f(spherical)p Ft(")427 451 y Fj(and)24 b
+Ft(")p Fj(relativ)n(e)e(ph)n(ysical)p Ft(")g Fj(co)r(ordinates,)h
+(while)h(the)f(in)n(v)n(erse)g(transformation)e(con)n(v)n(erts)h(in)i
+(the)g(opp)r(osite)427 551 y(direction.)68 b(This)38
+b(arrangemen)n(t)e(ma)n(y)h(b)r(e)h(rev)n(ersed,)h(if)g(required,)g(b)n
+(y)f(using)g(AST)p Ft(_)p Fj(INVER)-7 b(T)38 b(or)f(b)n(y)427
+650 y(setting)28 b(the)g(In)n(v)n(ert)f(attribute)g(to)h(a)f(non-zero)f
+(v)-5 b(alue.)340 784 y Fi(\017)45 b Fj(If)27 b(an)n(y)f(set)h(of)f(co)
+r(ordinates)g(cannot)g(b)r(e)h(transformed)e(\(for)i(example,)f(man)n
+(y)g(pro)5 b(jections)26 b(do)g(not)g(co)n(v)n(er)427
+884 y(the)i(en)n(tire)f(celestial)h(sphere\),)f(then)h(a)f(WcsMap)h
+(will)f(yield)h(co)r(ordinate)e(v)-5 b(alues)28 b(of)f(AST)p
+Ft(__)p Fj(BAD.)340 1018 y Fi(\017)45 b Fj(The)29 b(v)-5
b(alidit)n(y)28 b(of)g(an)n(y)g(pro)5 b(jection)27 b(parameters)g(giv)n
(en)g(via)h(the)g(PVi)p Ft(_)p Fj(m)g(parameter)f(in)i(the)g(OPTIONS)
-427 2559 y(string)g(is)g(not)h(c)n(hec)n(k)n(ed)e(b)n(y)h(this)h
+427 1118 y(string)g(is)g(not)h(c)n(hec)n(k)n(ed)e(b)n(y)h(this)h
(function.)43 b(Ho)n(w)n(ev)n(er,)28 b(their)i(v)-5 b(alidit)n(y)29
b(is)g(c)n(hec)n(k)n(ed)g(when)g(the)h(resulting)427
-2659 y(WcsMap)21 b(is)f(used)g(to)h(transform)e(co)r(ordinates,)h(and)h
+1217 y(WcsMap)21 b(is)f(used)g(to)h(transform)e(co)r(ordinates,)h(and)h
(an)f(error)e(will)j(result)f(if)h(the)g(pro)5 b(jection)19
-b(parameters)427 2759 y(do)28 b(not)f(satisfy)g(all)h(the)g(required)e
+b(parameters)427 1317 y(do)28 b(not)f(satisfy)g(all)h(the)g(required)e
(constrain)n(ts)g(\(as)i(de\014ned)g(in)g(the)g(FITS-W)n(CS)f(pap)r
-(er\).)340 2886 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+(er\).)340 1451 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 2985 y(set)28 b(to)f(an)h(error)d(v)-5
+b(A)g(TUS)427 1551 y(set)28 b(to)f(an)h(error)d(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)-2
-3141 y Fc(Status)33 b(Handling)n(:)227 3287 y Fj(The)d(protected)g(in)n
+1715 y Fc(Status)33 b(Handling)n(:)227 1861 y Fj(The)d(protected)g(in)n
(terface)f(to)g(this)h(function)h(includes)f(an)f(extra)g(parameter)f
-(at)i(the)g(end)g(of)g(the)g(parameter)227 3387 y(list)37
+(at)i(the)g(end)g(of)g(the)g(parameter)227 1961 y(list)37
b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)
r(oin)n(ter)g(to)h(the)g(in)n(teger)e(inherited)i(status)f(v)-5
-b(ariable:)54 b Ft(")p Fj(in)n(t)227 3487 y Fi(\003)p
-Fj(status)p Ft(")p Fj(.)p 0 3674 3780 12 v 0 3805 a FA(AST)p
-Fe(_)p FA(WINMAP)1428 3804 y Fd(Create)37 b(a)i(WinMap)2833
-3805 y FA(AST)p Fe(_)p FA(WINMAP)0 3981 y Fc(Description:)44
+b(ariable:)54 b Ft(")p Fj(in)n(t)227 2060 y Fi(\003)p
+Fj(status)p Ft(")p Fj(.)p 0 2262 3780 12 v 0 2393 a FA(AST)p
+Fe(_)p FA(WINMAP)1428 2392 y Fd(Create)37 b(a)i(WinMap)2833
+2393 y FA(AST)p Fe(_)p FA(WINMAP)0 2584 y Fc(Description:)44
b Fj(This)28 b(function)g(creates)f(a)g(new)g(WinMap)h(and)g
-(optionally)e(initialises)i(its)g(attributes.)227 4103
+(optionally)e(initialises)i(its)g(attributes.)227 2710
y(A)i(Winmap)g(is)f(a)g(linear)g(Mapping)g(whic)n(h)g(transforms)f(a)h
(rectangular)e(windo)n(w)i(in)h(one)f(co)r(ordinate)f(system)227
-4203 y(in)n(to)g(a)f(similar)g(windo)n(w)g(in)h(another)f(co)r
+2809 y(in)n(to)g(a)f(similar)g(windo)n(w)g(in)h(another)f(co)r
(ordinate)g(system)g(b)n(y)g(scaling)g(and)h(shifting)g(eac)n(h)f(axis)
-g(\(the)h(windo)n(w)227 4302 y(edges)f(b)r(eing)h(parallel)e(to)i(the)g
-(co)r(ordinate)e(axes\).)227 4424 y(A)g(WinMap)g(is)g(sp)r(eci\014ed)g
+g(\(the)h(windo)n(w)227 2909 y(edges)f(b)r(eing)h(parallel)e(to)i(the)g
+(co)r(ordinate)e(axes\).)227 3035 y(A)g(WinMap)g(is)g(sp)r(eci\014ed)g
(b)n(y)g(giving)f(the)h(co)r(ordinates)e(of)i(t)n(w)n(o)f(opp)r(osite)g
(corners)f(\(A)j(and)e(B\))h(of)g(the)g(windo)n(w)227
-4523 y(in)i(b)r(oth)g(the)g(input)h(and)e(output)h(co)r(ordinate)f
-(systems.)0 4667 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
+3134 y(in)i(b)r(oth)g(the)g(input)h(and)e(output)h(co)r(ordinate)f
+(systems.)0 3286 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41
b(=)i(AST_WINMAP\()c(NCOORD,)i(INA,)h(INB,)g(OUTA,)f(OUTB,)h(OPTIONS,)e
-(STATUS)h(\))0 4811 y Fc(Argumen)m(ts:)259 4941 y(NCOORD)31
-b(=)h(INTEGER)f(\(Giv)m(en\))427 5041 y Fj(The)25 b(n)n(um)n(b)r(er)f
+(STATUS)h(\))0 3438 y Fc(Argumen)m(ts:)259 3577 y(NCOORD)31
+b(=)h(INTEGER)f(\(Giv)m(en\))427 3677 y Fj(The)25 b(n)n(um)n(b)r(er)f
(of)g(co)r(ordinate)g(v)-5 b(alues)24 b(for)g(eac)n(h)f(p)r(oin)n(t)i
(to)f(b)r(e)h(transformed)f(\(i.e.)36 b(the)25 b(n)n(um)n(b)r(er)f(of)g
-(dimen-)427 5140 y(sions)31 b(of)h(the)h(space)e(in)h(whic)n(h)g(the)g
+(dimen-)427 3776 y(sions)31 b(of)h(the)h(space)e(in)h(whic)n(h)g(the)g
(p)r(oin)n(ts)g(will)g(reside\).)50 b(The)32 b(same)f(n)n(um)n(b)r(er)h
-(is)g(applicable)f(to)h(b)r(oth)427 5240 y(input)d(and)e(output)h(p)r
-(oin)n(ts.)259 5367 y Fc(INA\()k(NCOORD)f(\))h(=)g(DOUBLE)g(PRECISION)g
-(\(Giv)m(en\))427 5466 y Fj(An)21 b(arra)n(y)d(con)n(taining)i(the)g
+(is)g(applicable)f(to)h(b)r(oth)427 3876 y(input)d(and)e(output)h(p)r
+(oin)n(ts.)259 4010 y Fc(INA\()k(NCOORD)f(\))h(=)g(DOUBLE)g(PRECISION)g
+(\(Giv)m(en\))427 4110 y Fj(An)21 b(arra)n(y)d(con)n(taining)i(the)g
(co)r(ordinates)f(of)i(corner)e(A)i(of)f(the)h(windo)n(w)f(in)g(the)h
-(input)h(co)r(ordinate)d(system.)259 5593 y Fc(INB\()32
+(input)h(co)r(ordinate)d(system.)259 4244 y Fc(INB\()32
b(NCOORD)f(\))h(=)g(DOUBLE)g(PRECISION)f(\(Giv)m(en\))427
-5693 y Fj(An)21 b(arra)n(y)e(con)n(taining)g(the)i(co)r(ordinates)f(of)
+4343 y Fj(An)21 b(arra)n(y)e(con)n(taining)g(the)i(co)r(ordinates)f(of)
g(corner)f(B)i(of)g(the)g(windo)n(w)f(in)h(the)g(input)g(co)r(ordinate)
-f(system.)p eop end
-%%Page: 407 417
-TeXDict begin 407 416 bop 3643 52 a FG(407)259 351 y
-Fc(OUT)-8 b(A\()33 b(NCOORD)e(\))h(=)g(DOUBLE)g(PRECISION)f(\(Giv)m
-(en\))427 451 y Fj(An)38 b(arra)n(y)e(con)n(taining)g(the)i(co)r
-(ordinates)e(of)i(corner)e(A)i(of)g(the)g(windo)n(w)f(in)h(the)g
-(output)g(co)r(ordinate)427 551 y(system.)259 682 y Fc(OUTB\()33
-b(NCOORD)d(\))i(=)g(DOUBLE)h(PRECISION)e(\(Giv)m(en\))427
-781 y Fj(An)39 b(arra)n(y)c(con)n(taining)i(the)h(co)r(ordinates)f(of)g
-(corner)g(B)h(of)f(the)i(windo)n(w)e(in)h(the)g(output)h(co)r(ordinate)
-427 881 y(system.)259 1012 y Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g
-Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-1111 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)
-f(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r
-(e)427 1211 y(used)26 b(for)e(initialising)i(the)f(new)h(WinMap.)36
-b(The)26 b(syn)n(tax)e(used)h(is)g(iden)n(tical)h(to)f(that)g(for)g
-(the)h(AST)p Ft(_)p Fj(SET)427 1311 y(routine.)259 1442
-y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 1541 y Fj(The)c(global)e(status.)0 1701 y Fc(Returned)32
-b(V)-8 b(alue:)259 1836 y(AST)p Ft(_)p Fc(WINMAP)32 b(=)g(INTEGER)427
-1936 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(WinMap.)0
-2096 y Fc(Notes:)340 2377 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+f(system.)259 4478 y Fc(OUT)-8 b(A\()33 b(NCOORD)e(\))h(=)g(DOUBLE)g
+(PRECISION)f(\(Giv)m(en\))427 4577 y Fj(An)38 b(arra)n(y)e(con)n
+(taining)g(the)i(co)r(ordinates)e(of)i(corner)e(A)i(of)g(the)g(windo)n
+(w)f(in)h(the)g(output)g(co)r(ordinate)427 4677 y(system.)259
+4811 y Fc(OUTB\()33 b(NCOORD)d(\))i(=)g(DOUBLE)h(PRECISION)e(\(Giv)m
+(en\))427 4911 y Fj(An)39 b(arra)n(y)c(con)n(taining)i(the)h(co)r
+(ordinates)f(of)g(corner)g(B)h(of)f(the)i(windo)n(w)e(in)h(the)g
+(output)h(co)r(ordinate)427 5010 y(system.)259 5144 y
+Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 5244 y Fj(A)22 b(c)n(haracter)e
+(string)h(con)n(taining)g(an)h(optional)f(comma-separated)e(list)j(of)g
+(attribute)g(assignmen)n(ts)f(to)g(b)r(e)427 5344 y(used)26
+b(for)e(initialising)i(the)f(new)h(WinMap.)36 b(The)26
+b(syn)n(tax)e(used)h(is)g(iden)n(tical)h(to)f(that)g(for)g(the)h(AST)p
+Ft(_)p Fj(SET)427 5443 y(routine.)259 5577 y Fc(ST)-8
+b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427
+5677 y Fj(The)c(global)e(status.)p eop end
+%%Page: 410 420
+TeXDict begin 410 419 bop 0 52 a FG(410)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Returned)h(V)-8
+b(alue:)259 494 y(AST)p Ft(_)p Fc(WINMAP)32 b(=)g(INTEGER)427
+594 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(WinMap.)0
+763 y Fc(Notes:)340 1052 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
-b(A)g(TUS)427 2476 y(set)28 b(to)f(an)h(error)d(v)-5
+b(A)g(TUS)427 1152 y(set)28 b(to)f(an)h(error)d(v)-5
b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)-2
-2636 y Fc(Status)33 b(Handling)n(:)227 2782 y Fj(The)d(protected)g(in)n
+1320 y Fc(Status)33 b(Handling)n(:)227 1467 y Fj(The)d(protected)g(in)n
(terface)f(to)g(this)h(function)h(includes)f(an)f(extra)g(parameter)f
-(at)i(the)g(end)g(of)g(the)g(parameter)227 2882 y(list)37
+(at)i(the)g(end)g(of)g(the)g(parameter)227 1566 y(list)37
b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)
r(oin)n(ter)g(to)h(the)g(in)n(teger)e(inherited)i(status)f(v)-5
-b(ariable:)54 b Ft(")p Fj(in)n(t)227 2982 y Fi(\003)p
-Fj(status)p Ft(")p Fj(.)p 0 3177 3780 12 v 0 3308 a FA(AST)p
-Fe(_)p FA(WRITE)1121 3309 y Fd(W)-10 b(rite)38 b(an)g(Ob)7
-b(ject)38 b(to)g(a)h(Channel)2977 3308 y FA(AST)p Fe(_)p
-FA(WRITE)0 3494 y Fc(Description:)44 b Fj(This)21 b(function)h(writes)f
+b(ariable:)54 b Ft(")p Fj(in)n(t)227 1666 y Fi(\003)p
+Fj(status)p Ft(")p Fj(.)p 0 1872 3780 12 v 0 2003 a FA(AST)p
+Fe(_)p FA(WRITE)1121 2004 y Fd(W)-10 b(rite)38 b(an)g(Ob)7
+b(ject)38 b(to)g(a)h(Channel)2977 2003 y FA(AST)p Fe(_)p
+FA(WRITE)0 2199 y Fc(Description:)44 b Fj(This)21 b(function)h(writes)f
(an)g(Ob)5 b(ject)21 b(to)g(a)f(Channel,)j(app)r(ending)e(it)g(to)g(an)
-n(y)g(previous)f(Ob)5 b(jects)20 b(written)227 3594 y(to)28
-b(that)g(Channel.)0 3741 y Fc(In)m(v)m(o)s(cation:)123
+n(y)g(previous)f(Ob)5 b(jects)20 b(written)227 2299 y(to)28
+b(that)g(Channel.)0 2455 y Fc(In)m(v)m(o)s(cation:)123
b Ft(RESULT)41 b(=)i(AST_WRITE\()c(THIS,)j(OBJECT,)f(STATUS)g(\))0
-3889 y Fc(Argumen)m(ts:)259 4024 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 4123 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Channel.)259
-4254 y Fc(OBJECT)k(=)g(INTEGER)f(\(Giv)m(en\))427 4354
+2611 y Fc(Argumen)m(ts:)259 2754 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 2854 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Channel.)259
+2990 y Fc(OBJECT)k(=)g(INTEGER)f(\(Giv)m(en\))427 3090
y Fj(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5 b(ject)27 b(whic)n(h)h(is)f(to)
-h(b)r(e)g(written.)259 4485 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f
-(\(Giv)m(en)h(and)g(Returned\))427 4585 y Fj(The)c(global)e(status.)0
-4745 y Fc(Class)31 b(Applicabilit)m(y:)259 4879 y(FitsChan)427
-4979 y Fj(If)26 b(the)f(FitsChan)g(uses)g(a)f(foreign)g(enco)r(ding)h
+h(b)r(e)g(written.)259 3226 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f
+(\(Giv)m(en)h(and)g(Returned\))427 3326 y Fj(The)c(global)e(status.)0
+3495 y Fc(Class)31 b(Applicabilit)m(y:)259 3638 y(FitsChan)427
+3737 y Fj(If)26 b(the)f(FitsChan)g(uses)g(a)f(foreign)g(enco)r(ding)h
(\(e.g.)36 b(FITS-W)n(CS\))25 b(rather)f(than)h(the)g(nativ)n(e)g(AST)g
-(enco)r(d-)427 5079 y(ing,)f(then)f(storing)f(v)-5 b(alues)22
+(enco)r(d-)427 3837 y(ing,)f(then)f(storing)f(v)-5 b(alues)22
b(in)i(the)f(FitsChan)g(for)f(k)n(eyw)n(ords)f(NAXIS1,)j(NAXIS2,)g
-(etc.,)h(b)r(efore)d(in)n(v)n(oking)427 5178 y(AST)p
+(etc.,)h(b)r(efore)d(in)n(v)n(oking)427 3937 y(AST)p
Ft(_)p Fj(WRITE)28 b(can)f(help)h(to)f(pro)r(duce)h(a)f(successful)g
-(write.)0 5338 y Fc(Returned)32 b(V)-8 b(alue:)259 5473
-y(AST)p Ft(_)p Fc(WRITE)32 b(=)g(INTEGER)427 5573 y Fj(The)23
+(write.)0 4105 y Fc(Returned)32 b(V)-8 b(alue:)259 4249
+y(AST)p Ft(_)p Fc(WRITE)32 b(=)g(INTEGER)427 4348 y Fj(The)23
b(n)n(um)n(b)r(er)g(of)g(Ob)5 b(jects)23 b(written)g(to)g(the)g
(Channel)g(b)n(y)g(this)g(in)n(v)n(o)r(cation)e(of)i(AST)p
-Ft(_)p Fj(WRITE)g(\(normally)-7 b(,)427 5672 y(this)28
-b(will)g(b)r(e)g(one\).)p eop end
-%%Page: 408 418
-TeXDict begin 408 417 bop 0 52 a FG(408)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(Notes:)340
-643 y Fi(\017)45 b Fj(A)24 b(v)-5 b(alue)23 b(of)g(zero)g(will)g(b)r(e)
-h(returned)f(if)g(this)h(function)g(is)f(in)n(v)n(ok)n(ed)f(with)i(ST)
--7 b(A)g(TUS)24 b(set)f(to)g(an)g(error)f(v)-5 b(alue,)427
-743 y(or)27 b(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)340
-880 y Fi(\017)45 b Fj(In)n(v)n(oking)27 b(this)h(function)h(will)f
+Ft(_)p Fj(WRITE)g(\(normally)-7 b(,)427 4448 y(this)28
+b(will)g(b)r(e)g(one\).)0 4616 y Fc(Notes:)340 4906 y
+Fi(\017)45 b Fj(A)24 b(v)-5 b(alue)23 b(of)g(zero)g(will)g(b)r(e)h
+(returned)f(if)g(this)h(function)g(is)f(in)n(v)n(ok)n(ed)f(with)i(ST)-7
+b(A)g(TUS)24 b(set)f(to)g(an)g(error)f(v)-5 b(alue,)427
+5005 y(or)27 b(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)340
+5142 y Fi(\017)45 b Fj(In)n(v)n(oking)27 b(this)h(function)h(will)f
(usually)f(cause)h(the)g(sink)g(function)g(asso)r(ciated)f(with)h(the)h
-(c)n(hannel)e(to)h(b)r(e)427 980 y(called)g(in)g(order)f(to)h(transfer)
-f(a)h(textual)g(description)g(of)g(the)g(supplied)g(ob)5
-b(ject)28 b(to)g(some)g(external)f(data)427 1079 y(store.)36
+(c)n(hannel)e(to)h(b)r(e)427 5241 y(called)g(in)g(order)f(to)h
+(transfer)f(a)h(textual)g(description)g(of)g(the)g(supplied)g(ob)5
+b(ject)28 b(to)g(some)g(external)f(data)427 5341 y(store.)36
b(Ho)n(w)n(ev)n(er,)24 b(the)i(FitsChan)g(class)f(b)r(eha)n(v)n(es)g
(di\013eren)n(tly)-7 b(.)36 b(In)n(v)n(oking)24 b(this)i(function)h(on)
-e(a)h(FitsChan)427 1179 y(causes)35 b(new)g(FITS)h(header)f(cards)f(to)
+e(a)h(FitsChan)427 5441 y(causes)35 b(new)g(FITS)h(header)f(cards)f(to)
h(b)r(e)h(added)g(to)f(an)g(in)n(ternal)g(bu\013er)h(\(the)g(sink)f
-(function)h(is)g(not)427 1279 y(in)n(v)n(ok)n(ed\).)58
+(function)h(is)g(not)427 5540 y(in)n(v)n(ok)n(ed\).)58
b(This)35 b(bu\013er)h(is)f(written)g(out)g(through)f(the)i(sink)f
-(function)g(only)g(when)g(the)h(FitsChan)f(is)427 1378
-y(deleted.)p 0 1587 3780 12 v 0 1717 a FA(AST)p Fe(_)p
-FA(WRITEFITS)1291 1718 y Fd(W)-10 b(rite)38 b(out)g(all)g(cards)g(in)h
-(a)1358 1818 y(FitsChan)f(to)g(the)h(sink)1680 1918 y(function)2674
-1717 y FA(AST)p Fe(_)p FA(WRITEFITS)0 2092 y Fc(Description:)44
+(function)g(only)g(when)g(the)h(FitsChan)f(is)427 5640
+y(deleted.)p eop end
+%%Page: 411 421
+TeXDict begin 411 420 bop 3643 52 a FG(411)p 0 351 3780
+12 v 0 482 a FA(AST)p Fe(_)p FA(WRITEFITS)1291 483 y
+Fd(W)-10 b(rite)38 b(out)g(all)g(cards)g(in)h(a)1358
+583 y(FitsChan)f(to)g(the)h(sink)1680 682 y(function)2674
+482 y FA(AST)p Fe(_)p FA(WRITEFITS)0 868 y Fc(Description:)44
b Fj(This)33 b(routine)f(writes)g(out)g(all)h(cards)e(curren)n(tly)g
(in)i(the)g(FitsChan.)51 b(If)33 b(the)g(SinkFile)g(attribute)g(is)227
-2192 y(set,)g(they)g(will)f(b)r(e)g(written)g(out)g(to)g(the)h(sp)r
+967 y(set,)g(they)g(will)f(b)r(e)g(written)g(out)g(to)g(the)h(sp)r
(eci\014ed)f(sink)g(\014le.)50 b(Otherwise,)32 b(they)g(will)g(b)r(e)h
-(written)f(out)g(using)227 2292 y(the)i(sink)e(function)i(sp)r
+(written)f(out)g(using)227 1067 y(the)i(sink)e(function)i(sp)r
(eci\014ed)f(when)g(the)h(FitsChan)f(w)n(as)f(created.)52
b(All)33 b(cards)f(are)g(then)h(deleted)h(from)e(the)227
-2391 y(FitsChan.)0 2550 y Fc(In)m(v)m(o)s(cation:)123
+1167 y(FitsChan.)0 1336 y Fc(In)m(v)m(o)s(cation:)123
b Ft(CALL)42 b(AST_WRITEFITS\()37 b(THIS,)42 b(STATUS)f(\))0
-2709 y Fc(Argumen)m(ts:)259 2854 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
-(en\))427 2954 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
-3091 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
-(Returned\))427 3191 y Fj(The)c(global)e(status.)0 3362
-y Fc(Notes:)340 3654 y Fi(\017)45 b Fj(If)35 b(the)f(SinkFile)h(is)f
+1506 y Fc(Argumen)m(ts:)259 1662 y(THIS)32 b(=)g(INTEGER)g(\(Giv)m
+(en\))427 1762 y Fj(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
+1905 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g
+(Returned\))427 2004 y Fj(The)c(global)e(status.)0 2186
+y Fc(Notes:)340 2489 y Fi(\017)45 b Fj(If)35 b(the)f(SinkFile)h(is)f
(unset,)i(and)e(no)g(sink)g(function)g(is)g(a)n(v)-5
b(ailable,)35 b(this)f(metho)r(d)h(simply)f(empties)g(the)427
-3753 y(FitsChan,)28 b(and)f(is)h(then)g(equiv)-5 b(alen)n(t)27
-b(to)h(AST)p Ft(_)p Fj(EMPTYFITS.)340 3891 y Fi(\017)45
+2588 y(FitsChan,)28 b(and)f(is)h(then)g(equiv)-5 b(alen)n(t)27
+b(to)h(AST)p Ft(_)p Fj(EMPTYFITS.)340 2731 y Fi(\017)45
b Fj(This)28 b(metho)r(d)g(attempt)g(to)g(execute)f(ev)n(en)g(if)h(an)g
-(error)d(has)i(o)r(ccurred)g(previously)-7 b(.)p 0 4099
-V 0 4230 a FA(AST)p Fe(_)p FA(XMLCHAN)1374 4231 y Fd(Create)38
-b(an)g(XmlChan)2729 4230 y FA(AST)p Fe(_)p FA(XMLCHAN)0
-4416 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+(error)d(has)i(o)r(ccurred)g(previously)-7 b(.)p 0 2951
+V 0 3081 a FA(AST)p Fe(_)p FA(XMLCHAN)1374 3082 y Fd(Create)38
+b(an)g(XmlChan)2729 3081 y FA(AST)p Fe(_)p FA(XMLCHAN)0
+3278 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
(XmlChan)h(and)g(optionally)e(initialises)i(its)g(attributes.)227
-4545 y(A)36 b(XmlChan)f(is)g(a)f(sp)r(ecialised)h(form)f(of)h(Channel)g
+3412 y(A)36 b(XmlChan)f(is)g(a)f(sp)r(ecialised)h(form)f(of)h(Channel)g
(whic)n(h)g(supp)r(orts)g(XML)g(I/O)f(op)r(erations.)58
-b(W)-7 b(riting)35 b(an)227 4645 y(Ob)5 b(ject)38 b(to)f(an)g(XmlChan)h
+b(W)-7 b(riting)35 b(an)227 3512 y(Ob)5 b(ject)38 b(to)f(an)g(XmlChan)h
(\(using)f(AST)p Ft(_)p Fj(WRITE\))h(will,)i(if)e(the)g(Ob)5
b(ject)38 b(is)f(suitable,)j(generate)c(an)h(XML)227
-4744 y(description)27 b(of)g(that)g(Ob)5 b(ject,)28 b(and)f(reading)e
+3612 y(description)27 b(of)g(that)g(Ob)5 b(ject,)28 b(and)f(reading)e
(from)i(an)g(XmlChan)h(will)f(create)f(a)h(new)g(Ob)5
-b(ject)27 b(from)g(its)g(XML)227 4844 y(description.)227
-4973 y(Normally)-7 b(,)39 b(when)f(y)n(ou)e(use)i(an)f(XmlChan,)j(y)n
+b(ject)27 b(from)g(its)g(XML)227 3711 y(description.)227
+3846 y(Normally)-7 b(,)39 b(when)f(y)n(ou)e(use)i(an)f(XmlChan,)j(y)n
(ou)d(should)g(pro)n(vide)f Ft(")p Fj(source)p Ft(")f
Fj(and)j Ft(")p Fj(sink)p Ft(")e Fj(routines)h(whic)n(h)227
-5073 y(connect)31 b(it)h(to)f(an)g(external)f(data)g(store)h(b)n(y)f
+3946 y(connect)31 b(it)h(to)f(an)g(external)f(data)g(store)h(b)n(y)f
(reading)g(and)h(writing)g(the)h(resulting)e(XML)h(text.)48
-b(By)31 b(default,)227 5172 y(ho)n(w)n(ev)n(er,)26 b(an)h(XmlChan)h
+b(By)31 b(default,)227 4045 y(ho)n(w)n(ev)n(er,)26 b(an)h(XmlChan)h
(will)g(read)f(from)g(standard)f(input)j(and)e(write)h(to)f(standard)g
-(output.)227 5302 y(Alternativ)n(ely)-7 b(,)29 b(an)g(XmlChan)h(can)e
+(output.)227 4180 y(Alternativ)n(ely)-7 b(,)29 b(an)g(XmlChan)h(can)e
(b)r(e)i(told)f(to)g(read)f(or)g(write)h(from)g(sp)r(eci\014c)g(text)h
-(\014les)f(using)g(the)g(SinkFile)227 5401 y(and)f(SourceFile)f
+(\014les)f(using)g(the)g(SinkFile)227 4279 y(and)f(SourceFile)f
(attributes,)g(in)h(whic)n(h)g(case)e(no)i(sink)f(or)g(source)f
-(function)i(need)g(b)r(e)g(supplied.)0 5560 y Fc(In)m(v)m(o)s(cation:)
+(function)i(need)g(b)r(e)g(supplied.)0 4449 y Fc(In)m(v)m(o)s(cation:)
123 b Ft(RESULT)41 b(=)i(AST_XMLCHAN\()c(SOURCE,)h(SINK,)i(OPTIONS,)e
-(STATUS)h(\))0 5718 y Fc(Argumen)m(ts:)p eop end
-%%Page: 409 419
-TeXDict begin 409 418 bop 3643 52 a FG(409)259 351 y
-Fc(SOUR)m(CE)32 b(=)g(SUBR)m(OUTINE)g(\(Giv)m(en\))427
-451 y Fj(A)26 b(source)d(routine,)j(whic)n(h)f(is)g(a)f(subroutine)h
-(whic)n(h)g(tak)n(es)f(a)h(single)f(in)n(teger)g(error)f(status)i
-(argumen)n(t.)35 b(If)427 551 y(no)27 b(v)-5 b(alue)26
-b(has)g(b)r(een)i(set)e(for)g(the)i(SourceFile)e(attribute,)h(this)g
-(routine)f(will)h(b)r(e)g(used)g(b)n(y)f(the)h(XmlChan)427
-650 y(to)35 b(obtain)f(lines)g(of)g(input)i(text.)57
-b(On)35 b(eac)n(h)e(in)n(v)n(o)r(cation,)i(it)g(should)f(read)g(the)g
-(next)h(input)g(line)g(from)427 750 y(some)e(external)f(data)h(store,)g
-(and)g(then)h(return)e(the)i(resulting)e(text)i(to)f(the)g(AST)h
-(library)d(b)n(y)i(calling)427 849 y(AST)p Ft(_)p Fj(PUTLINE.)k(It)g
-(should)f(supply)h(a)g(negativ)n(e)f(line)h(length)g(when)g(there)f
-(are)g(no)h(more)f(lines)h(to)427 949 y(read.)h(If)29
-b(an)f(error)e(o)r(ccurs,)h(it)i(should)f(set)g(its)h(o)n(wn)e(error)f
-(status)i(argumen)n(t)g(to)g(an)g(error)e(v)-5 b(alue)28
-b(b)r(efore)427 1049 y(returning.)427 1166 y(If)i(the)f(n)n(ull)h
-(routine)e(AST)p Ft(_)p Fj(NULL)i(is)f(suppied)g(as)f(the)i(SOUR)n(CE)e
-(v)-5 b(alue,)30 b(and)f(no)g(v)-5 b(alue)29 b(has)f(b)r(een)i(set)427
-1265 y(for)d(the)h(SourceFile)f(attribute,)h(the)g(XmlChan)g(will)g
-(read)f(from)g(standard)f(input)j(instead.)259 1400 y
-Fc(SINK)j(=)g(SUBR)m(OUTINE)g(\(Giv)m(en\))427 1500 y
-Fj(A)f(sink)f(routine,)g(whic)n(h)h(is)f(a)f(subroutine)h(whic)n(h)g
-(tak)n(es)g(a)f(single)h(in)n(teger)f(error)g(status)h(argumen)n(t.)43
-b(If)427 1599 y(no)32 b(v)-5 b(alue)31 b(has)g(b)r(een)i(set)e(for)h
-(the)g(SinkFile)g(attribute,)h(this)f(routine)f(will)h(b)r(e)g(used)g
-(b)n(y)f(the)h(XmlChan)427 1699 y(to)k(deliv)n(er)e(lines)i(of)f
-(output)h(text.)61 b(On)35 b(eac)n(h)g(in)n(v)n(o)r(cation,)h(it)g
-(should)g(obtain)f(the)h(next)f(output)h(line)427 1799
-y(from)25 b(the)h(AST)f(library)f(b)n(y)h(calling)f(AST)p
-Ft(_)p Fj(GETLINE,)h(and)g(then)g(deliv)n(er)g(the)g(resulting)g(text)g
-(to)g(some)427 1898 y(external)f(data)g(store.)34 b(If)25
-b(an)f(error)e(o)r(ccurs,)j(it)f(should)g(set)h(its)f(o)n(wn)g(error)e
-(status)i(argumen)n(t)f(to)i(an)f(error)427 1998 y(v)-5
-b(alue)28 b(b)r(efore)f(returning.)427 2115 y(If)k(the)f(n)n(ull)g
-(routine)g(AST)p Ft(_)p Fj(NULL)h(is)e(suppied)i(as)e(the)i(SINK)f(v)-5
-b(alue,)30 b(and)g(no)g(v)-5 b(alue)30 b(has)g(b)r(een)g(set)g(for)427
-2215 y(the)e(SinkFile)g(attribute,)g(the)g(XmlChan)g(will)g(write)f(to)
-h(standard)e(output)i(instead.)259 2349 y Fc(OPTIONS)k(=)g(CHARA)m
-(CTER)g Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-2449 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)
-f(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r
-(e)427 2549 y(used)i(for)g(initialising)g(the)h(new)f(XmlChan.)36
-b(The)23 b(syn)n(tax)g(used)g(is)g(iden)n(tical)g(to)g(that)h(for)e
-(the)i(AST)p Ft(_)p Fj(SET)427 2648 y(routine.)259 2783
-y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 2883 y Fj(The)c(global)e(status.)0 3048 y Fc(Returned)32
-b(V)-8 b(alue:)259 3188 y(AST)p Ft(_)p Fc(XMLCHAN)32
-b(=)g(INTEGER)427 3288 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g
-(XmlChan.)0 3454 y Fc(Notes:)340 3740 y Fi(\017)45 b
-Fj(The)27 b(names)g(of)g(the)h(routines)e(supplied)i(for)e(the)i(SOUR)n
-(CE)e(and)h(SINK)g(argumen)n(ts)f(should)h(app)r(ear)f(in)427
-3840 y(EXTERNAL)33 b(statemen)n(ts)g(in)h(the)f(F)-7
+(STATUS)h(\))0 4618 y Fc(Argumen)m(ts:)259 4775 y(SOUR)m(CE)32
+b(=)g(SUBR)m(OUTINE)g(\(Giv)m(en\))427 4874 y Fj(A)26
+b(source)d(routine,)j(whic)n(h)f(is)g(a)f(subroutine)h(whic)n(h)g(tak)n
+(es)f(a)h(single)f(in)n(teger)g(error)f(status)i(argumen)n(t.)35
+b(If)427 4974 y(no)27 b(v)-5 b(alue)26 b(has)g(b)r(een)i(set)e(for)g
+(the)i(SourceFile)e(attribute,)h(this)g(routine)f(will)h(b)r(e)g(used)g
+(b)n(y)f(the)h(XmlChan)427 5074 y(to)35 b(obtain)f(lines)g(of)g(input)i
+(text.)57 b(On)35 b(eac)n(h)e(in)n(v)n(o)r(cation,)i(it)g(should)f
+(read)g(the)g(next)h(input)g(line)g(from)427 5173 y(some)e(external)f
+(data)h(store,)g(and)g(then)h(return)e(the)i(resulting)e(text)i(to)f
+(the)g(AST)h(library)d(b)n(y)i(calling)427 5273 y(AST)p
+Ft(_)p Fj(PUTLINE.)k(It)g(should)f(supply)h(a)g(negativ)n(e)f(line)h
+(length)g(when)g(there)f(are)g(no)h(more)f(lines)h(to)427
+5373 y(read.)h(If)29 b(an)f(error)e(o)r(ccurs,)h(it)i(should)f(set)g
+(its)h(o)n(wn)e(error)f(status)i(argumen)n(t)g(to)g(an)g(error)e(v)-5
+b(alue)28 b(b)r(efore)427 5472 y(returning.)427 5593
+y(If)i(the)f(n)n(ull)h(routine)e(AST)p Ft(_)p Fj(NULL)i(is)f(suppied)g
+(as)f(the)i(SOUR)n(CE)e(v)-5 b(alue,)30 b(and)f(no)g(v)-5
+b(alue)29 b(has)f(b)r(een)i(set)427 5693 y(for)d(the)h(SourceFile)f
+(attribute,)h(the)g(XmlChan)g(will)g(read)f(from)g(standard)f(input)j
+(instead.)p eop end
+%%Page: 412 422
+TeXDict begin 412 421 bop 0 52 a FG(412)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)259 351 y Fc(SINK)h(=)g(SUBR)m
+(OUTINE)g(\(Giv)m(en\))427 451 y Fj(A)f(sink)f(routine,)g(whic)n(h)h
+(is)f(a)f(subroutine)h(whic)n(h)g(tak)n(es)g(a)f(single)h(in)n(teger)f
+(error)g(status)h(argumen)n(t.)43 b(If)427 551 y(no)32
+b(v)-5 b(alue)31 b(has)g(b)r(een)i(set)e(for)h(the)g(SinkFile)g
+(attribute,)h(this)f(routine)f(will)h(b)r(e)g(used)g(b)n(y)f(the)h
+(XmlChan)427 650 y(to)k(deliv)n(er)e(lines)i(of)f(output)h(text.)61
+b(On)35 b(eac)n(h)g(in)n(v)n(o)r(cation,)h(it)g(should)g(obtain)f(the)h
+(next)f(output)h(line)427 750 y(from)25 b(the)h(AST)f(library)f(b)n(y)h
+(calling)f(AST)p Ft(_)p Fj(GETLINE,)h(and)g(then)g(deliv)n(er)g(the)g
+(resulting)g(text)g(to)g(some)427 849 y(external)f(data)g(store.)34
+b(If)25 b(an)f(error)e(o)r(ccurs,)j(it)f(should)g(set)h(its)f(o)n(wn)g
+(error)e(status)i(argumen)n(t)f(to)i(an)f(error)427 949
+y(v)-5 b(alue)28 b(b)r(efore)f(returning.)427 1063 y(If)k(the)f(n)n
+(ull)g(routine)g(AST)p Ft(_)p Fj(NULL)h(is)e(suppied)i(as)e(the)i(SINK)
+f(v)-5 b(alue,)30 b(and)g(no)g(v)-5 b(alue)30 b(has)g(b)r(een)g(set)g
+(for)427 1163 y(the)e(SinkFile)g(attribute,)g(the)g(XmlChan)g(will)g
+(write)f(to)h(standard)e(output)i(instead.)259 1291 y
+Fc(OPTIONS)k(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h Fi(\003)f
+Fc(\))h(\(Giv)m(en\))427 1390 y Fj(A)22 b(c)n(haracter)e(string)h(con)n
+(taining)g(an)h(optional)f(comma-separated)e(list)j(of)g(attribute)g
+(assignmen)n(ts)f(to)g(b)r(e)427 1490 y(used)i(for)g(initialising)g
+(the)h(new)f(XmlChan.)36 b(The)23 b(syn)n(tax)g(used)g(is)g(iden)n
+(tical)g(to)g(that)h(for)e(the)i(AST)p Ft(_)p Fj(SET)427
+1590 y(routine.)259 1718 y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)
+m(en)h(and)g(Returned\))427 1818 y Fj(The)c(global)e(status.)0
+1975 y Fc(Returned)32 b(V)-8 b(alue:)259 2107 y(AST)p
+Ft(_)p Fc(XMLCHAN)32 b(=)g(INTEGER)427 2206 y Fj(A)c(p)r(oin)n(ter)f
+(to)h(the)g(new)g(XmlChan.)0 2364 y Fc(Notes:)340 2642
+y Fi(\017)45 b Fj(The)27 b(names)g(of)g(the)h(routines)e(supplied)i
+(for)e(the)i(SOUR)n(CE)e(and)h(SINK)g(argumen)n(ts)f(should)h(app)r
+(ear)f(in)427 2741 y(EXTERNAL)33 b(statemen)n(ts)g(in)h(the)f(F)-7
b(ortran)32 b(routine)h(whic)n(h)g(in)n(v)n(ok)n(es)e(AST)p
-Ft(_)p Fj(XMLCHAN.)k(Ho)n(w)n(ev)n(er,)427 3939 y(this)h(is)f(not)g
+Ft(_)p Fj(XMLCHAN.)k(Ho)n(w)n(ev)n(er,)427 2841 y(this)h(is)f(not)g
(generally)f(necessary)f(for)i(the)g(n)n(ull)h(routine)f(AST)p
Ft(_)p Fj(NULL)g(\(so)g(long)f(as)h(the)h(AST)p Ft(_)p
-Fj(P)-7 b(AR)427 4039 y(include)28 b(\014le)g(has)f(b)r(een)h(used\).)
-340 4174 y Fi(\017)45 b Fj(If)28 b(the)g(external)e(data)h(source)f(or)
+Fj(P)-7 b(AR)427 2941 y(include)28 b(\014le)g(has)f(b)r(een)h(used\).)
+340 3069 y Fi(\017)45 b Fj(If)28 b(the)g(external)e(data)h(source)f(or)
g(sink)i(uses)e(a)h(c)n(haracter)f(enco)r(ding)g(other)h(than)h(ASCI)r
-(I,)g(the)f(supplied)427 4273 y(source)i(and)g(sink)g(functions)h
+(I,)g(the)f(supplied)427 3168 y(source)i(and)g(sink)g(functions)h
(should)f(translate)g(b)r(et)n(w)n(een)h(the)f(external)g(c)n(haracter)
-f(enco)r(ding)h(and)g(the)427 4373 y(in)n(ternal)e(ASCI)r(I)i(enco)r
-(ding)e(used)g(b)n(y)h(AST.)340 4507 y Fi(\017)45 b Fj(A)35
+f(enco)r(ding)h(and)g(the)427 3268 y(in)n(ternal)e(ASCI)r(I)i(enco)r
+(ding)e(used)g(b)n(y)h(AST.)340 3396 y Fi(\017)45 b Fj(A)35
b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
Ft(__)p Fj(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
-(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 4607 y(AST)28
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 3496 y(AST)28
b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)340 4742 y Fi(\017)45 b Fj(Note)36 b(that)f(the)h(n)n(ull)f
+(reason.)340 3624 y Fi(\017)45 b Fj(Note)36 b(that)f(the)h(n)n(ull)f
(routine)g(AST)p Ft(_)p Fj(NULL)h(\(one)f(underscore\))f(is)h
(di\013eren)n(t)h(to)f(AST)p Ft(__)p Fj(NULL)g(\(t)n(w)n(o)427
-4841 y(underscores\),)26 b(whic)n(h)i(is)f(the)h(n)n(ull)g(Ob)5
-b(ject)28 b(p)r(oin)n(ter.)p 0 5044 3780 12 v 0 5175
-a FA(AST)p Fe(_)p FA(ZOOMMAP)325 b Fd(Create)37 b(a)i(Zo)s(omMap)326
-b FA(AST)p Fe(_)p FA(ZOOMMAP)0 5367 y Fc(Description:)44
-b Fj(This)28 b(function)g(creates)f(a)g(new)g(Zo)r(omMap)g(and)g
-(optionally)g(initialises)h(its)f(attributes.)227 5494
-y(A)40 b(Zo)r(omMap)e(is)h(a)f(Mapping)h(whic)n(h)g Ft(")p
-Fj(zo)r(oms)p Ft(")f Fj(a)g(set)h(of)g(p)r(oin)n(ts)g(ab)r(out)g(the)h
-(origin)e(b)n(y)h(m)n(ultiplying)g(all)227 5593 y(co)r(ordinate)25
-b(v)-5 b(alues)25 b(b)n(y)h(the)g(same)f(scale)g(factor)f(\(the)j(in)n
-(v)n(erse)d(transformation)g(is)i(p)r(erformed)f(b)n(y)g(dividing)h(b)n
-(y)227 5693 y(this)i(scale)f(factor\).)p eop end
-%%Page: 410 420
-TeXDict begin 410 419 bop 0 52 a FG(410)2115 b Fz(B)92
-b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)0 351 y Fc(In)m(v)m(o)s(cation:)
-123 b Ft(RESULT)41 b(=)i(AST_ZOOMMAP\()c(NCOORD,)h(ZOOM,)i(OPTIONS,)e
-(STATUS)h(\))0 501 y Fc(Argumen)m(ts:)259 637 y(NCOORD)31
-b(=)h(INTEGER)f(\(Giv)m(en\))427 737 y Fj(The)25 b(n)n(um)n(b)r(er)f
-(of)g(co)r(ordinate)g(v)-5 b(alues)24 b(for)g(eac)n(h)f(p)r(oin)n(t)i
-(to)f(b)r(e)h(transformed)f(\(i.e.)36 b(the)25 b(n)n(um)n(b)r(er)f(of)g
-(dimen-)427 836 y(sions)31 b(of)h(the)h(space)e(in)h(whic)n(h)g(the)g
-(p)r(oin)n(ts)g(will)g(reside\).)50 b(The)32 b(same)f(n)n(um)n(b)r(er)h
-(is)g(applicable)f(to)h(b)r(oth)427 936 y(input)d(and)e(output)h(p)r
-(oin)n(ts.)259 1069 y Fc(ZOOM)j(=)h(DOUBLE)h(PRECISION)e(\(Giv)m(en\))
-427 1168 y Fj(Initial)c(scale)e(factor)g(b)n(y)h(whic)n(h)h(co)r
-(ordinate)e(v)-5 b(alues)25 b(should)h(b)r(e)h(m)n(ultiplied)g(\(b)n(y)
-f(the)h(forw)n(ard)d(transfor-)427 1268 y(mation\))f(or)e(divided)i
-(\(b)n(y)g(the)g(in)n(v)n(erse)e(transformation\).)34
-b(This)22 b(factor)g(ma)n(y)g(subsequen)n(tly)g(b)r(e)h(c)n(hanged)427
-1368 y(via)k(the)h(Zo)r(omMap's)f(Zo)r(om)g(attribute.)37
+3724 y(underscores\),)26 b(whic)n(h)i(is)f(the)h(n)n(ull)g(Ob)5
+b(ject)28 b(p)r(oin)n(ter.)p 0 3914 3780 12 v 0 4045
+a FA(AST)p Fe(_)p FA(ZOOMMAP)1392 4044 y Fd(Create)37
+b(a)i(Zo)s(omMap)2715 4045 y FA(AST)p Fe(_)p FA(ZOOMMAP)0
+4224 y Fc(Description:)44 b Fj(This)28 b(function)g(creates)f(a)g(new)g
+(Zo)r(omMap)g(and)g(optionally)g(initialises)h(its)f(attributes.)227
+4346 y(A)40 b(Zo)r(omMap)e(is)h(a)f(Mapping)h(whic)n(h)g
+Ft(")p Fj(zo)r(oms)p Ft(")f Fj(a)g(set)h(of)g(p)r(oin)n(ts)g(ab)r(out)g
+(the)h(origin)e(b)n(y)h(m)n(ultiplying)g(all)227 4446
+y(co)r(ordinate)25 b(v)-5 b(alues)25 b(b)n(y)h(the)g(same)f(scale)g
+(factor)f(\(the)j(in)n(v)n(erse)d(transformation)g(is)i(p)r(erformed)f
+(b)n(y)g(dividing)h(b)n(y)227 4545 y(this)i(scale)f(factor\).)0
+4690 y Fc(In)m(v)m(o)s(cation:)123 b Ft(RESULT)41 b(=)i(AST_ZOOMMAP\()c
+(NCOORD,)h(ZOOM,)i(OPTIONS,)e(STATUS)h(\))0 4835 y Fc(Argumen)m(ts:)259
+4967 y(NCOORD)31 b(=)h(INTEGER)f(\(Giv)m(en\))427 5067
+y Fj(The)25 b(n)n(um)n(b)r(er)f(of)g(co)r(ordinate)g(v)-5
+b(alues)24 b(for)g(eac)n(h)f(p)r(oin)n(t)i(to)f(b)r(e)h(transformed)f
+(\(i.e.)36 b(the)25 b(n)n(um)n(b)r(er)f(of)g(dimen-)427
+5166 y(sions)31 b(of)h(the)h(space)e(in)h(whic)n(h)g(the)g(p)r(oin)n
+(ts)g(will)g(reside\).)50 b(The)32 b(same)f(n)n(um)n(b)r(er)h(is)g
+(applicable)f(to)h(b)r(oth)427 5266 y(input)d(and)e(output)h(p)r(oin)n
+(ts.)259 5394 y Fc(ZOOM)j(=)h(DOUBLE)h(PRECISION)e(\(Giv)m(en\))427
+5494 y Fj(Initial)c(scale)e(factor)g(b)n(y)h(whic)n(h)h(co)r(ordinate)e
+(v)-5 b(alues)25 b(should)h(b)r(e)h(m)n(ultiplied)g(\(b)n(y)f(the)h
+(forw)n(ard)d(transfor-)427 5593 y(mation\))f(or)e(divided)i(\(b)n(y)g
+(the)g(in)n(v)n(erse)e(transformation\).)34 b(This)22
+b(factor)g(ma)n(y)g(subsequen)n(tly)g(b)r(e)h(c)n(hanged)427
+5693 y(via)k(the)h(Zo)r(omMap's)f(Zo)r(om)g(attribute.)37
b(It)28 b(ma)n(y)f(b)r(e)h(p)r(ositiv)n(e)f(or)f(negativ)n(e,)h(but)h
-(should)g(not)f(b)r(e)h(zero.)259 1501 y Fc(OPTIONS)k(=)g(CHARA)m(CTER)
-g Fi(\003)f Fc(\()h Fi(\003)f Fc(\))h(\(Giv)m(en\))427
-1600 y Fj(A)22 b(c)n(haracter)e(string)h(con)n(taining)g(an)h(optional)
-f(comma-separated)e(list)j(of)g(attribute)g(assignmen)n(ts)f(to)g(b)r
-(e)427 1700 y(used)h(for)f(initialising)h(the)g(new)g(Zo)r(omMap.)34
-b(The)22 b(syn)n(tax)f(used)g(is)h(iden)n(tical)g(to)f(that)i(for)e
-(the)h(AST)p Ft(_)p Fj(SET)427 1799 y(routine.)259 1932
-y Fc(ST)-8 b(A)g(TUS)34 b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))
-427 2032 y Fj(The)c(global)e(status.)0 2194 y Fc(Returned)32
-b(V)-8 b(alue:)259 2330 y(AST)p Ft(_)p Fc(ZOOMMAP)32
-b(=)g(INTEGER)427 2430 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(Zo)r
-(omMap.)0 2592 y Fc(Notes:)340 2874 y Fi(\017)45 b Fj(A)21
-b(n)n(ull)f(Ob)5 b(ject)20 b(p)r(oin)n(ter)f(\(AST)p
-Ft(__)p Fj(NULL\))i(will)f(b)r(e)h(returned)e(if)i(this)f(function)h
-(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7 b(A)g(TUS)427 2974
-y(set)28 b(to)f(an)h(error)d(v)-5 b(alue,)28 b(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)-2 3136 y Fc(Status)33
-b(Handling)n(:)227 3282 y Fj(The)d(protected)g(in)n(terface)f(to)g
-(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
-(of)g(the)g(parameter)227 3381 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
-(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
-(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
-Fj(in)n(t)227 3481 y Fi(\003)p Fj(status)p Ft(")p Fj(.)p
-eop end
-%%Page: 411 421
-TeXDict begin 411 420 bop 3643 52 a FG(411)0 351 y FA(C)135
+(should)g(not)f(b)r(e)h(zero.)p eop end
+%%Page: 413 423
+TeXDict begin 413 422 bop 3643 52 a FG(413)259 351 y
+Fc(OPTIONS)32 b(=)g(CHARA)m(CTER)g Fi(\003)f Fc(\()h
+Fi(\003)f Fc(\))h(\(Giv)m(en\))427 451 y Fj(A)22 b(c)n(haracter)e
+(string)h(con)n(taining)g(an)h(optional)f(comma-separated)e(list)j(of)g
+(attribute)g(assignmen)n(ts)f(to)g(b)r(e)427 551 y(used)h(for)f
+(initialising)h(the)g(new)g(Zo)r(omMap.)34 b(The)22 b(syn)n(tax)f(used)
+g(is)h(iden)n(tical)g(to)f(that)i(for)e(the)h(AST)p Ft(_)p
+Fj(SET)427 650 y(routine.)259 783 y Fc(ST)-8 b(A)g(TUS)34
+b(=)e(INTEGER)f(\(Giv)m(en)h(and)g(Returned\))427 883
+y Fj(The)c(global)e(status.)0 1044 y Fc(Returned)32 b(V)-8
+b(alue:)259 1181 y(AST)p Ft(_)p Fc(ZOOMMAP)32 b(=)g(INTEGER)427
+1281 y Fj(A)c(p)r(oin)n(ter)f(to)h(the)g(new)g(Zo)r(omMap.)0
+1442 y Fc(Notes:)340 1725 y Fi(\017)45 b Fj(A)21 b(n)n(ull)f(Ob)5
+b(ject)20 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fj(NULL\))i(will)f(b)r(e)h
+(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(ST)-7
+b(A)g(TUS)427 1825 y(set)28 b(to)f(an)h(error)d(v)-5
+b(alue,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)-2
+1986 y Fc(Status)33 b(Handling)n(:)227 2133 y Fj(The)d(protected)g(in)n
+(terface)f(to)g(this)h(function)h(includes)f(an)f(extra)g(parameter)f
+(at)i(the)g(end)g(of)g(the)g(parameter)227 2232 y(list)37
+b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)
+r(oin)n(ter)g(to)h(the)g(in)n(teger)e(inherited)i(status)f(v)-5
+b(ariable:)54 b Ft(")p Fj(in)n(t)227 2332 y Fi(\003)p
+Fj(status)p Ft(")p Fj(.)p eop end
+%%Page: 414 424
+TeXDict begin 414 423 bop 0 52 a FG(414)2115 b Fz(B)92
+b(AST)29 b(R)m(OUTINE)i(DESCRIPTIONS)p eop end
+%%Page: 415 425
+TeXDict begin 415 424 bop 3643 52 a FG(415)0 351 y FA(C)135
b(AST)43 b(A)l(ttribute)j(Descriptions)p 0 596 3780 12
v 0 735 a(Abbrev\(axis\))1073 728 y Fd(Abbreviate)37
b(leading)g(\014elds)i(within)1330 843 y(n)m(umerical)d(axis)i(lab)s
@@ -128891,8 +129035,8 @@ b(Ho)n(w)n(ev)n(er,)25 b(if)227 5593 y(Adaptiv)n(e)j(had)g(b)r(een)g
b(w)n(ould)f(not)h(ha)n(v)n(e)f(b)r(een)h(c)n(hanged,)f(resulting)g(in)
h(the)227 5693 y(\014nal)g(Region)f(represen)n(ting)f(2000)f(nm)j(to)g
(4000)e(nm.)p eop end
-%%Page: 412 422
-TeXDict begin 412 421 bop 0 52 a FG(412)1994 b Fz(C)91
+%%Page: 416 426
+TeXDict begin 416 425 bop 0 52 a FG(416)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)227 351
y Fj(Setting)g(Adaptiv)n(e)g(to)f(zero)f(can)h(b)r(e)h(necessary)e(if)i
(y)n(ou)f(w)n(an)n(t)g(correct)f(inaccurate)g(attribute)i(settings)f
@@ -128981,8 +129125,8 @@ b(In)25 b(other)g(w)n(ords,)f(if)h(either)g(AlignSideBand)g(attribute)g
b(rames)28 b(aligns)e(lik)n(e)i(basic)f(Sp)r(ecF)-7 b(rames.)36
b(The)28 b(default)g(v)-5 b(alue)27 b(for)g(AlignSideBand)h(is)f(zero.)
p eop end
-%%Page: 413 423
-TeXDict begin 413 422 bop 3643 52 a FG(413)227 351 y
+%%Page: 417 427
+TeXDict begin 417 426 bop 3643 52 a FG(417)227 351 y
Fj(When)34 b(AST)p Ft(_)p Fj(FINDFRAME)h(or)e(AST)p Ft(_)p
Fj(CONVER)-7 b(T)33 b(is)g(used)h(on)f(t)n(w)n(o)g(DSBSp)r(ecF)-7
b(rames)33 b(\(p)r(oten)n(tially)h(de-)227 451 y(scribing)29
@@ -129062,8 +129206,8 @@ b(T\))31 b(as)g(a)g(template)h(to)f(matc)n(h)g(another)g(\(target\))g
5693 y(dard)g(of)h(rest)g(in)g(whic)n(h)g(alignmen)n(t)f(is)h(to)g(o)r
(ccur.)52 b(See)32 b(the)i(StdOfRest)f(attribute)g(for)g(a)f
(desription)g(of)h(the)p eop end
-%%Page: 414 424
-TeXDict begin 414 423 bop 0 52 a FG(414)1994 b Fz(C)91
+%%Page: 418 428
+TeXDict begin 418 427 bop 0 52 a FG(418)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)227 351
y Fj(v)-5 b(alues)39 b(whic)n(h)h(ma)n(y)e(b)r(e)i(assigned)e(to)i
(this)f(attribute.)73 b(The)39 b(default)h(AlignStdOfRest)g(v)-5
@@ -129143,864 +129287,882 @@ y Fj(The)35 b(AlignSystem)h(attribute)f(for)f(a)h(CmpF)-7
b(rame)35 b(alw)n(a)n(ys)e(equals)h Ft(")p Fj(Comp)r(ound)p
Ft(")p Fj(,)i(and)f(ma)n(y)f(not)h(b)r(e)427 5693 y(altered.)p
eop end
-%%Page: 415 425
-TeXDict begin 415 424 bop 3643 52 a FG(415)259 351 y
+%%Page: 419 429
+TeXDict begin 419 428 bop 3643 52 a FG(419)259 351 y
Fc(F)-8 b(rameSet)427 451 y Fj(The)22 b(AlignSystem)f(attribute)h(of)f
(a)g(F)-7 b(rameSet)21 b(is)g(the)h(same)f(as)g(that)g(of)h(its)f
(curren)n(t)g(F)-7 b(rame)20 b(\(as)h(sp)r(eci\014ed)427
551 y(b)n(y)28 b(the)g(Curren)n(t)e(attribute\).)259
-688 y Fc(SkyF)-8 b(rame)427 787 y Fj(The)28 b(default)g(AlignSystem)g
+671 y Fc(SkyF)-8 b(rame)427 770 y Fj(The)28 b(default)g(AlignSystem)g
(attribute)g(for)f(a)g(SkyF)-7 b(rame)27 b(is)g Ft(")p
-Fj(ICRS)p Ft(")p Fj(.)259 924 y Fc(Sp)s(ecF)-8 b(rame)427
-1024 y Fj(The)28 b(default)g(AlignSystem)g(attribute)g(for)f(a)g(Sp)r
+Fj(ICRS)p Ft(")p Fj(.)259 891 y Fc(Sp)s(ecF)-8 b(rame)427
+990 y Fj(The)28 b(default)g(AlignSystem)g(attribute)g(for)f(a)g(Sp)r
(ecF)-7 b(rame)27 b(is)h Ft(")p Fj(W)-7 b(a)n(v)n(e)p
-Ft(")26 b Fj(\(w)n(a)n(v)n(elength\).)259 1161 y Fc(TimeF)-8
-b(rame)427 1261 y Fj(The)28 b(default)g(AlignSystem)g(attribute)g(for)f
+Ft(")26 b Fj(\(w)n(a)n(v)n(elength\).)259 1110 y Fc(TimeF)-8
+b(rame)427 1210 y Fj(The)28 b(default)g(AlignSystem)g(attribute)g(for)f
(a)g(TimeF)-7 b(rame)27 b(is)g Ft(")p Fj(MJD)p Ft(")p
-Fj(.)p 0 1469 3780 12 v 0 1600 a FA(AlignTimeScale)153
+Fj(.)p 0 1384 3780 12 v 0 1516 a FA(AlignTimeScale)153
b Fd(Time)36 b(scale)h(to)g(use)h(when)f(aligning)1573
-1714 y(TimeF)-10 b(rames)2858 1600 y FA(AlignTimeScale)0
-1892 y Fc(Description:)44 b Fj(This)22 b(attribute)f(con)n(trols)f(ho)n
+1629 y(TimeF)-10 b(rames)2858 1516 y FA(AlignTimeScale)0
+1774 y Fc(Description:)44 b Fj(This)22 b(attribute)f(con)n(trols)f(ho)n
(w)h(a)g(TimeF)-7 b(rame)21 b(b)r(eha)n(v)n(es)g(when)g(it)h(is)g(used)
-f(\(b)n(y)h(AST)p Ft(_)p Fj(FINDFRAME)227 1992 y(or)31
+f(\(b)n(y)h(AST)p Ft(_)p Fj(FINDFRAME)227 1873 y(or)31
b(AST)p Ft(_)p Fj(CONVER)-7 b(T\))31 b(as)g(a)g(template)g(to)g(matc)n
(h)g(another)g(\(target\))g(TimeF)-7 b(rame.)47 b(It)32
-b(iden)n(ti\014es)f(the)h(time)227 2092 y(scale)h(in)h(whic)n(h)g
+b(iden)n(ti\014es)f(the)h(time)227 1973 y(scale)h(in)h(whic)n(h)g
(alignmen)n(t)f(is)g(to)h(o)r(ccur.)54 b(See)34 b(the)g(TimeScale)f
(attribute)h(for)f(a)g(desription)g(of)h(the)g(v)-5 b(alues)227
-2191 y(whic)n(h)24 b(ma)n(y)e(b)r(e)i(assigned)f(to)g(this)h
+2073 y(whic)n(h)24 b(ma)n(y)e(b)r(e)i(assigned)f(to)g(this)h
(attribute.)35 b(The)24 b(default)g(AlignTimeScale)f(v)-5
-b(alue)23 b(dep)r(ends)h(on)g(the)f(curren)n(t)227 2291
+b(alue)23 b(dep)r(ends)h(on)g(the)f(curren)n(t)227 2172
y(v)-5 b(alue)26 b(of)h(TimeScale:)36 b(if)27 b(TimeScale)f(is)g(UT1,)g
(GMST,)h(LMST)f(or)g(LAST,)h(the)f(default)h(for)f(AlignTimeScale)227
-2391 y(is)i(UT1,)f(for)g(all)h(other)f(TimeScales)g(the)h(default)g(is)
-f(T)-7 b(AI.)227 2519 y(When)36 b(AST)p Ft(_)p Fj(FindF)-7
+2272 y(is)i(UT1,)f(for)g(all)h(other)f(TimeScales)g(the)h(default)g(is)
+f(T)-7 b(AI.)227 2390 y(When)36 b(AST)p Ft(_)p Fj(FindF)-7
b(rame)35 b(or)f(AST)p Ft(_)p Fj(CONVER)-7 b(T)35 b(is)g(used)g(on)g(t)
n(w)n(o)g(TimeF)-7 b(rames)34 b(\(p)r(oten)n(tially)h(describing)227
-2619 y(di\013eren)n(t)24 b(time)g(co)r(ordinate)f(systems\),)h(it)h
+2490 y(di\013eren)n(t)24 b(time)g(co)r(ordinate)f(systems\),)h(it)h
(returns)e(a)g(Mapping)g(whic)n(h)h(can)f(b)r(e)i(used)e(to)h
-(transform)e(a)i(p)r(osition)227 2719 y(in)31 b(one)f(TimeF)-7
+(transform)e(a)i(p)r(osition)227 2589 y(in)31 b(one)f(TimeF)-7
b(rame)31 b(in)n(to)f(the)h(corresp)r(onding)e(p)r(osition)h(in)h(the)g
(other.)46 b(The)30 b(Mapping)h(is)f(made)h(up)g(of)f(the)227
-2818 y(follo)n(wing)d(steps)g(in)h(the)g(indicated)g(order:)340
-3092 y Fi(\017)45 b Fj(Map)32 b(v)-5 b(alues)32 b(from)g(the)h(system)f
+2689 y(follo)n(wing)d(steps)g(in)h(the)g(indicated)g(order:)340
+2931 y Fi(\017)45 b Fj(Map)32 b(v)-5 b(alues)32 b(from)g(the)h(system)f
(used)h(b)n(y)f(the)g(target)g(\(MJD,)h(JD,)f(etc\))h(to)f(the)h
-(system)f(sp)r(eci\014ed)h(b)n(y)427 3192 y(the)28 b(AlignSystem)g
-(attribute.)340 3329 y Fi(\017)45 b Fj(Map)20 b(these)f(v)-5
+(system)f(sp)r(eci\014ed)h(b)n(y)427 3031 y(the)28 b(AlignSystem)g
+(attribute.)340 3151 y Fi(\017)45 b Fj(Map)20 b(these)f(v)-5
b(alues)19 b(from)g(the)h(target's)f(time)h(scale)e(to)i(the)f(time)h
(scale)f(sp)r(eci\014ed)h(b)n(y)f(the)h(AlignTimeScale)427
-3428 y(attribute.)340 3566 y Fi(\017)45 b Fj(Map)28 b(these)f(v)-5
+3251 y(attribute.)340 3371 y Fi(\017)45 b Fj(Map)28 b(these)f(v)-5
b(alues)27 b(from)h(the)f(time)h(scale)f(sp)r(eci\014ed)h(b)n(y)f(the)h
-(AlignTimeScale)f(attribute,)h(to)g(the)f(tem-)427 3665
-y(plate's)h(time)g(scale.)340 3802 y Fi(\017)45 b Fj(Map)24
+(AlignTimeScale)f(attribute,)h(to)g(the)f(tem-)427 3470
+y(plate's)h(time)g(scale.)340 3591 y Fi(\017)45 b Fj(Map)24
b(these)g(v)-5 b(alues)24 b(from)g(the)h(system)f(sp)r(eci\014ed)g(b)n
(y)g(the)h(AlignSystem)f(attribute,)h(to)f(the)h(system)f(used)427
-3902 y(b)n(y)k(the)g(template.)0 4073 y Fc(T)m(yp)s(e:)227
-4172 y Fj(String.)0 4330 y Fc(Class)j(Applicabilit)m(y:)259
-4475 y(TimeF)-8 b(rame)427 4575 y Fj(All)28 b(TimeF)-7
-b(rames)27 b(ha)n(v)n(e)g(this)h(attribute.)p 0 4783
-V 0 4914 a FA(AllW)-11 b(arnings)378 b Fd(A)39 b(list)f(of)g(all)f
-(curren)m(tly)g(a)m(v)-7 b(ailable)1473 5029 y(condition)37
-b(names)3048 4914 y FA(AllW)-11 b(arnings)0 5203 y Fc(Description:)44
-b Fj(This)32 b(read-only)d(attribute)j(is)f(a)g(space)g(separated)f
-(list)i(of)f(all)g(the)h(conditions)f(names)g(recognized)227
-5303 y(b)n(y)d(the)g(W)-7 b(arnings)26 b(attribute.)37
-b(The)28 b(names)f(are)g(listed)h(b)r(elo)n(w.)0 5461
-y Fc(T)m(yp)s(e:)227 5560 y Fj(String,)g(read-only)0
-5718 y Fc(Class)j(Applicabilit)m(y:)p eop end
-%%Page: 416 426
-TeXDict begin 416 425 bop 0 52 a FG(416)1994 b Fz(C)91
-b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)259 351
-y Fc(FitsChan)427 451 y Fj(All)d(FitsChans)g(ha)n(v)n(e)e(this)i
-(attribute.)-2 604 y Fc(Conditions)n(:)227 750 y Fj(The)g(follo)n(wing)
-e(conditions)i(are)e(curren)n(tly)h(recognised)f(\(all)h(are)227
-870 y(case-insensitiv)n(e\):)340 1118 y Fi(\017)45 b
-Ft(")p Fj(BadCel)p Ft(")p Fj(:)31 b(This)18 b(condition)h(arises)e
-(when)h(reading)f(a)h(F)-7 b(rameSet)18 b(from)g(a)g(non-Nativ)n(e)g
-(enco)r(ded)g(FitsChan)427 1217 y(if)28 b(an)g(unkno)n(wn)f(celestial)g
+3690 y(b)n(y)k(the)g(template.)0 3839 y Fc(T)m(yp)s(e:)227
+3939 y Fj(String.)0 4076 y Fc(Class)j(Applicabilit)m(y:)259
+4200 y(TimeF)-8 b(rame)427 4299 y Fj(All)28 b(TimeF)-7
+b(rames)27 b(ha)n(v)n(e)g(this)h(attribute.)p 0 4473
+V 0 4605 a FA(AllV)-11 b(arian)l(ts)170 b Fd(A)39 b(list)e(of)i(the)f
+(v)-7 b(arian)m(t)37 b(Mappings)h(asso)s(ciated)1292
+4720 y(with)g(the)h(curren)m(t)e(F)-10 b(rame)3113 4605
+y FA(AllV)f(arian)l(ts)0 4860 y Fc(Description:)44 b
+Fj(This)34 b(attrbute)g(giv)n(es)f(a)g(space)g(separated)g(list)h(of)g
+(the)g(names)f(of)h(all)f(the)i(v)-5 b(arian)n(t)32 b(Mappings)i(as-)
+227 4960 y(so)r(ciated)g(with)g(the)g(curren)n(t)f(F)-7
+b(rame)34 b(\(see)g(attribute)g Ft(")p Fj(V)-7 b(arian)n(t)p
+Ft(")p Fj(\).)54 b(If)35 b(the)f(curren)n(t)f(F)-7 b(rame)34
+b(has)f(no)h(v)-5 b(arian)n(t)227 5059 y(Mappings,)27
+b(then)h(the)g(list)g(will)g(hold)g(a)f(single)g(en)n(try)g(equal)g(to)
+g(the)h(Domain)g(name)f(of)h(the)g(curren)n(t)f(F)-7
+b(rame.)0 5196 y Fc(T)m(yp)s(e:)227 5296 y Fj(String,)28
+b(read-only)-7 b(.)0 5432 y Fc(Class)31 b(Applicabilit)m(y:)259
+5556 y(F)-8 b(rameSet)427 5656 y Fj(All)28 b(F)-7 b(rameSets)27
+b(ha)n(v)n(e)g(this)h(attribute.)p eop end
+%%Page: 420 430
+TeXDict begin 420 429 bop 0 52 a FG(420)1994 b Fz(C)91
+b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
+3780 12 v 0 483 a FA(AllW)-11 b(arnings)378 b Fd(A)39
+b(list)f(of)g(all)f(curren)m(tly)g(a)m(v)-7 b(ailable)1473
+598 y(condition)37 b(names)3048 483 y FA(AllW)-11 b(arnings)0
+777 y Fc(Description:)44 b Fj(This)32 b(read-only)d(attribute)j(is)f(a)
+g(space)g(separated)f(list)i(of)f(all)g(the)h(conditions)f(names)g
+(recognized)227 876 y(b)n(y)d(the)g(W)-7 b(arnings)26
+b(attribute.)37 b(The)28 b(names)f(are)g(listed)h(b)r(elo)n(w.)0
+1039 y Fc(T)m(yp)s(e:)227 1139 y Fj(String,)g(read-only)0
+1302 y Fc(Class)j(Applicabilit)m(y:)259 1452 y(FitsChan)427
+1551 y Fj(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)-2
+1727 y Fc(Conditions)n(:)227 1873 y Fj(The)g(follo)n(wing)e(conditions)
+i(are)e(curren)n(tly)h(recognised)f(\(all)h(are)227 2004
+y(case-insensitiv)n(e\):)340 2285 y Fi(\017)45 b Ft(")p
+Fj(BadCel)p Ft(")p Fj(:)31 b(This)18 b(condition)h(arises)e(when)h
+(reading)f(a)h(F)-7 b(rameSet)18 b(from)g(a)g(non-Nativ)n(e)g(enco)r
+(ded)g(FitsChan)427 2385 y(if)28 b(an)g(unkno)n(wn)f(celestial)g
(co-ordinate)f(system)h(is)h(sp)r(eci\014ed)f(b)n(y)h(the)g(CTYPE)f(k)n
-(eyw)n(ords.)340 1341 y Fi(\017)45 b Ft(")p Fj(BadCTYPE)p
+(eyw)n(ords.)340 2524 y Fi(\017)45 b Ft(")p Fj(BadCTYPE)p
Ft(")p Fj(:)e(This)31 b(condition)g(arises)f(when)i(reading)e(a)h(F)-7
b(rameSet)31 b(from)g(a)g(non-Nativ)n(e)g(enco)r(ded)427
-1441 y(FitsChan)d(if)g(an)g(illegal)f(algorithm)g(co)r(de)g(is)h(sp)r
+2624 y(FitsChan)d(if)g(an)g(illegal)f(algorithm)g(co)r(de)g(is)h(sp)r
(eci\014ed)g(b)n(y)f(a)h(CTYPE)f(k)n(eyw)n(ord,)f(and)i(the)g(illegal)f
-(co)r(de)427 1540 y(can)g(b)r(e)h(con)n(v)n(erted)f(to)g(an)g(equiv)-5
-b(alen)n(t)28 b(legal)e(co)r(de.)340 1664 y Fi(\017)45
+(co)r(de)427 2723 y(can)g(b)r(e)h(con)n(v)n(erted)f(to)g(an)g(equiv)-5
+b(alen)n(t)28 b(legal)e(co)r(de.)340 2863 y Fi(\017)45
b Ft(")p Fj(BadLat)p Ft(")p Fj(:)31 b(This)18 b(condition)g(arises)f
(when)i(reading)e(a)h(F)-7 b(rameSet)18 b(from)g(a)g(non-Nativ)n(e)g
-(enco)r(ded)g(FitsChan)427 1764 y(if)23 b(the)f(latitude)g(of)g(the)h
+(enco)r(ded)g(FitsChan)427 2963 y(if)23 b(the)f(latitude)g(of)g(the)h
(reference)e(p)r(oin)n(t)h(has)f(an)h(absolute)f(v)-5
b(alue)22 b(greater)e(than)i(90)f(degrees.)34 b(The)22
-b(actual)427 1864 y(absolute)27 b(v)-5 b(alue)28 b(used)f(is)h(set)f
+b(actual)427 3062 y(absolute)27 b(v)-5 b(alue)28 b(used)f(is)h(set)f
(to)h(exactly)f(90)f(degrees)h(in)h(these)f(cases.)340
-1987 y Fi(\017)45 b Ft(")p Fj(BadMat)p Ft(")p Fj(:)32
+3202 y Fi(\017)45 b Ft(")p Fj(BadMat)p Ft(")p Fj(:)32
b(This)20 b(condition)g(arises)f(if)i(the)f(matrix)g(describing)g(the)g
-(transformation)f(from)h(pixel)g(o\013sets)427 2087 y(to)38
+(transformation)f(from)h(pixel)g(o\013sets)427 3302 y(to)38
b(in)n(termediate)g(w)n(orld)f(co)r(ordinates)g(cannot)g(b)r(e)i(in)n
(v)n(erted.)67 b(This)38 b(matrix)g(describ)r(es)f(the)i(scaling,)427
-2187 y(rotation,)32 b(shear,)h(etc.,)g(applied)f(to)g(the)h(pixel)f
+3401 y(rotation,)32 b(shear,)h(etc.,)g(applied)f(to)g(the)h(pixel)f
(axes,)g(and)g(is)g(sp)r(eci\014ed)h(b)n(y)f(k)n(eyw)n(ords)e(suc)n(h)i
-(as)f(PCi)p Ft(_)p Fj(j,)427 2286 y(CDi)p Ft(_)p Fj(j,)g(CR)n(OT)-7
+(as)f(PCi)p Ft(_)p Fj(j,)427 3501 y(CDi)p Ft(_)p Fj(j,)g(CR)n(OT)-7
b(A,)29 b(etc.)43 b(F)-7 b(or)29 b(example,)h(the)g(matrix)f(will)h
(not)g(b)r(e)g(in)n(v)n(ertable)e(if)i(an)n(y)f(ro)n(ws)f(or)h(columns)
-427 2386 y(consist)i(en)n(tirely)f(of)h(zeros.)46 b(The)31
+427 3600 y(consist)i(en)n(tirely)f(of)h(zeros.)46 b(The)31
b(FITS-W)n(CS)g(P)n(ap)r(er)f(I)h Ft(")p Fj(Represen)n(tation)e(of)i(W)
--7 b(orld)31 b(Co)r(ordinates)e(in)427 2486 y(FITS)p
+-7 b(orld)31 b(Co)r(ordinates)e(in)427 3700 y(FITS)p
Ft(")35 b Fj(b)n(y)g(Greisen)f(&)h(Calabretta)e(requires)h(that)h(this)
g(matrix)g(b)r(e)g(in)n(v)n(ertable.)58 b(Man)n(y)34
-b(op)r(erations)427 2585 y(\(suc)n(h)28 b(as)f(grid)g(plotting\))h
+b(op)r(erations)427 3800 y(\(suc)n(h)28 b(as)f(grid)g(plotting\))h
(will)f(not)h(b)r(e)g(p)r(ossible)f(if)h(the)g(matrix)f(cannot)h(b)r(e)
-g(in)n(v)n(erted.)340 2709 y Fi(\017)45 b Ft(")p Fj(BadPV)p
+g(in)n(v)n(erted.)340 3939 y Fi(\017)45 b Ft(")p Fj(BadPV)p
Ft(")p Fj(:)31 b(This)18 b(condition)g(arises)f(when)i(reading)e(a)h(F)
-7 b(rameSet)18 b(from)g(a)g(non-Nativ)n(e)g(enco)r(ded)g(FitsChan.)427
-2809 y(It)27 b(is)g(issued)f(if)h(a)f(PVi)p Ft(_)p Fj(m)h(header)e(is)i
+4039 y(It)27 b(is)g(issued)f(if)h(a)f(PVi)p Ft(_)p Fj(m)h(header)e(is)i
(found)g(that)g(refers)e(to)i(a)f(pro)5 b(jection)26
-b(parameter)f(that)i(is)f(not)h(used)427 2908 y(b)n(y)d(the)h(pro)5
+b(parameter)f(that)i(is)f(not)h(used)427 4138 y(b)n(y)d(the)h(pro)5
b(jection)23 b(t)n(yp)r(e)i(sp)r(eci\014ed)f(b)n(y)g(CTYPE,)g(or)f(the)
i(PV)f(v)-5 b(alues)24 b(are)f(otherwise)g(inappropriate)g(for)427
-3008 y(the)28 b(pro)5 b(jection)27 b(t)n(yp)r(e.)340
-3132 y Fi(\017)45 b Ft(")p Fj(BadV)-7 b(al)p Ft(")p Fj(:)31
+4238 y(the)28 b(pro)5 b(jection)27 b(t)n(yp)r(e.)340
+4378 y Fi(\017)45 b Ft(")p Fj(BadV)-7 b(al)p Ft(")p Fj(:)31
b(This)18 b(condition)h(arises)e(when)h(reading)f(a)h(F)-7
b(rameSet)18 b(from)g(a)g(non-Nativ)n(e)g(enco)r(ded)g(FitsChan)427
-3232 y(if)33 b(it)g(is)g(not)g(p)r(ossible)f(to)g(con)n(v)n(ert)f(the)i
+4477 y(if)33 b(it)g(is)g(not)g(p)r(ossible)f(to)g(con)n(v)n(ert)f(the)i
(v)-5 b(alue)33 b(of)f(a)h(FITS)g(k)n(eyw)n(ords)d(to)j(the)g(exp)r
-(ected)g(t)n(yp)r(e.)52 b(F)-7 b(or)32 b(in-)427 3331
+(ected)g(t)n(yp)r(e.)52 b(F)-7 b(or)32 b(in-)427 4577
y(stance,)27 b(this)g(can)g(o)r(ccur)f(if)i(the)f(FITS)g(header)f(con)n
(tains)g(a)h(string)f(v)-5 b(alue)27 b(for)f(a)h(k)n(eyw)n(ord)e(whic)n
-(h)i(should)427 3431 y(ha)n(v)n(e)g(a)g(\015oating)g(p)r(oin)n(t)g(v)-5
+(h)i(should)427 4677 y(ha)n(v)n(e)g(a)g(\015oating)g(p)r(oin)n(t)g(v)-5
b(alue,)28 b(or)f(if)h(the)g(k)n(eyw)n(ord)d(has)j(no)f(v)-5
b(alue)27 b(at)h(all)f(\(i.e.)37 b(is)28 b(a)f(commen)n(t)g(card\).)340
-3555 y Fi(\017)45 b Ft(")p Fj(Distortion)p Ft(")p Fj(:)56
+4816 y Fi(\017)45 b Ft(")p Fj(Distortion)p Ft(")p Fj(:)56
b(This)37 b(condition)g(arises)g(when)g(reading)g(a)g(F)-7
b(rameSet)37 b(from)g(a)g(non-Nativ)n(e)g(enco)r(ded)427
-3654 y(FitsChan)32 b(if)h(an)n(y)f(of)g(the)g(CTYPE)g(k)n(eyw)n(ords)e
+4916 y(FitsChan)32 b(if)h(an)n(y)f(of)g(the)g(CTYPE)g(k)n(eyw)n(ords)e
(sp)r(ecify)i(an)g(unsupp)r(orted)g(distortion)f(co)r(de)h(using)g(the)
-427 3754 y Ft(")p Fj(4-3-3)p Ft(")25 b Fj(format)i(sp)r(eci\014ed)h(in)
+427 5015 y Ft(")p Fj(4-3-3)p Ft(")25 b Fj(format)i(sp)r(eci\014ed)h(in)
g(FITS-W)n(CS)f(pap)r(er)h(IV.)g(Suc)n(h)f(distortion)g(co)r(des)g(are)
-g(ignored.)340 3878 y Fi(\017)45 b Ft(")p Fj(NoCTYPE)p
+g(ignored.)340 5155 y Fi(\017)45 b Ft(")p Fj(NoCTYPE)p
Ft(")p Fj(:)f(This)31 b(condition)h(arises)e(if)i(a)g(default)g(CTYPE)f
(v)-5 b(alue)31 b(is)h(used)g(within)g(AST)p Ft(_)p Fj(READ,)427
-3978 y(due)j(to)g(no)g(v)-5 b(alue)34 b(b)r(eing)h(presen)n(t)g(in)g
+5255 y(due)j(to)g(no)g(v)-5 b(alue)34 b(b)r(eing)h(presen)n(t)g(in)g
(the)g(supplied)g(FitsChan.)59 b(This)35 b(condition)g(is)f(only)h
-(tested)g(for)427 4077 y(when)28 b(using)f(non-Nativ)n(e)g(enco)r
-(dings.)340 4201 y Fi(\017)45 b Ft(")p Fj(NoEquino)n(x)p
+(tested)g(for)427 5354 y(when)28 b(using)f(non-Nativ)n(e)g(enco)r
+(dings.)340 5494 y Fi(\017)45 b Ft(")p Fj(NoEquino)n(x)p
Ft(")p Fj(:)g(This)33 b(condition)f(arises)f(if)j(a)e(default)h(equino)
n(x)f(v)-5 b(alue)33 b(is)f(used)h(within)g(AST)p Ft(_)p
-Fj(READ,)427 4301 y(due)i(to)g(no)g(v)-5 b(alue)34 b(b)r(eing)h(presen)
+Fj(READ,)427 5593 y(due)i(to)g(no)g(v)-5 b(alue)34 b(b)r(eing)h(presen)
n(t)g(in)g(the)g(supplied)g(FitsChan.)59 b(This)35 b(condition)g(is)f
-(only)h(tested)g(for)427 4400 y(when)28 b(using)f(non-Nativ)n(e)g(enco)
-r(dings.)340 4524 y Fi(\017)45 b Ft(")p Fj(NoRadesys)p
-Ft(")p Fj(:)36 b(This)28 b(condition)g(arises)f(if)h(a)g(default)h
-(reference)e(frame)h(is)f(used)i(for)e(an)h(equatorial)e(co-)427
-4624 y(ordinate)e(system)g(within)h(AST)p Ft(_)p Fj(READ,)f(due)h(to)f
-(no)g(v)-5 b(alue)24 b(b)r(eing)h(presen)n(t)f(in)g(the)h(supplied)f
-(FitsChan.)427 4724 y(This)k(condition)f(is)h(only)f(tested)h(for)f
-(when)h(using)f(non-Nativ)n(e)g(enco)r(dings.)340 4847
-y Fi(\017)45 b Ft(")p Fj(NoLonp)r(ole)p Ft(")p Fj(:)52
-b(This)35 b(condition)h(arises)e(if)i(a)g(default)g(v)-5
-b(alue)35 b(is)h(used)f(for)h(the)g(LONPOLE)d(k)n(eyw)n(ord)427
-4947 y(within)28 b(AST)p Ft(_)p Fj(READ,)g(due)g(to)f(no)g(v)-5
-b(alue)27 b(b)r(eing)h(presen)n(t)e(in)i(the)g(supplied)g(FitsChan.)36
-b(This)28 b(condition)427 5047 y(is)g(only)f(tested)h(for)f(when)h
-(using)f(non-Nativ)n(e)g(enco)r(dings.)340 5171 y Fi(\017)45
-b Ft(")p Fj(NoLatp)r(ole)p Ft(")p Fj(:)56 b(This)37 b(condition)g
-(arises)f(if)i(a)f(default)h(v)-5 b(alue)38 b(is)f(used)g(for)g(the)h
-(LA)-7 b(TPOLE)36 b(k)n(eyw)n(ord)427 5270 y(within)28
-b(AST)p Ft(_)p Fj(READ,)g(due)g(to)f(no)g(v)-5 b(alue)27
-b(b)r(eing)h(presen)n(t)e(in)i(the)g(supplied)g(FitsChan.)36
-b(This)28 b(condition)427 5370 y(is)g(only)f(tested)h(for)f(when)h
-(using)f(non-Nativ)n(e)g(enco)r(dings.)340 5494 y Fi(\017)45
-b Ft(")p Fj(NoMjd-obs)p Ft(")p Fj(:)56 b(This)37 b(condition)h(arises)e
-(if)i(a)f(default)h(v)-5 b(alue)38 b(is)f(used)h(for)f(the)h(date)f(of)
-h(observ)-5 b(ation)427 5593 y(within)28 b(AST)p Ft(_)p
-Fj(READ,)g(due)g(to)f(no)g(v)-5 b(alue)27 b(b)r(eing)h(presen)n(t)e(in)
-i(the)g(supplied)g(FitsChan.)36 b(This)28 b(condition)427
-5693 y(is)g(only)f(tested)h(for)f(when)h(using)f(non-Nativ)n(e)g(enco)r
-(dings.)p eop end
-%%Page: 417 427
-TeXDict begin 417 426 bop 3643 52 a FG(417)340 351 y
-Fi(\017)45 b Ft(")p Fj(Tnx)p Ft(")p Fj(:)38 b(This)28
+(only)h(tested)g(for)427 5693 y(when)28 b(using)f(non-Nativ)n(e)g(enco)
+r(dings.)p eop end
+%%Page: 421 431
+TeXDict begin 421 430 bop 3643 52 a FG(421)340 351 y
+Fi(\017)45 b Ft(")p Fj(NoRadesys)p Ft(")p Fj(:)36 b(This)28
+b(condition)g(arises)f(if)h(a)g(default)h(reference)e(frame)h(is)f
+(used)i(for)e(an)h(equatorial)e(co-)427 451 y(ordinate)e(system)g
+(within)h(AST)p Ft(_)p Fj(READ,)f(due)h(to)f(no)g(v)-5
+b(alue)24 b(b)r(eing)h(presen)n(t)f(in)g(the)h(supplied)f(FitsChan.)427
+551 y(This)k(condition)f(is)h(only)f(tested)h(for)f(when)h(using)f
+(non-Nativ)n(e)g(enco)r(dings.)340 703 y Fi(\017)45 b
+Ft(")p Fj(NoLonp)r(ole)p Ft(")p Fj(:)52 b(This)35 b(condition)h(arises)
+e(if)i(a)g(default)g(v)-5 b(alue)35 b(is)h(used)f(for)h(the)g(LONPOLE)d
+(k)n(eyw)n(ord)427 803 y(within)28 b(AST)p Ft(_)p Fj(READ,)g(due)g(to)f
+(no)g(v)-5 b(alue)27 b(b)r(eing)h(presen)n(t)e(in)i(the)g(supplied)g
+(FitsChan.)36 b(This)28 b(condition)427 902 y(is)g(only)f(tested)h(for)
+f(when)h(using)f(non-Nativ)n(e)g(enco)r(dings.)340 1055
+y Fi(\017)45 b Ft(")p Fj(NoLatp)r(ole)p Ft(")p Fj(:)56
+b(This)37 b(condition)g(arises)f(if)i(a)f(default)h(v)-5
+b(alue)38 b(is)f(used)g(for)g(the)h(LA)-7 b(TPOLE)36
+b(k)n(eyw)n(ord)427 1154 y(within)28 b(AST)p Ft(_)p Fj(READ,)g(due)g
+(to)f(no)g(v)-5 b(alue)27 b(b)r(eing)h(presen)n(t)e(in)i(the)g
+(supplied)g(FitsChan.)36 b(This)28 b(condition)427 1254
+y(is)g(only)f(tested)h(for)f(when)h(using)f(non-Nativ)n(e)g(enco)r
+(dings.)340 1407 y Fi(\017)45 b Ft(")p Fj(NoMjd-obs)p
+Ft(")p Fj(:)56 b(This)37 b(condition)h(arises)e(if)i(a)f(default)h(v)-5
+b(alue)38 b(is)f(used)h(for)f(the)h(date)f(of)h(observ)-5
+b(ation)427 1506 y(within)28 b(AST)p Ft(_)p Fj(READ,)g(due)g(to)f(no)g
+(v)-5 b(alue)27 b(b)r(eing)h(presen)n(t)e(in)i(the)g(supplied)g
+(FitsChan.)36 b(This)28 b(condition)427 1606 y(is)g(only)f(tested)h
+(for)f(when)h(using)f(non-Nativ)n(e)g(enco)r(dings.)340
+1758 y Fi(\017)45 b Ft(")p Fj(Tnx)p Ft(")p Fj(:)38 b(This)28
b(condition)g(arises)f(if)i(a)f(F)-7 b(rameSet)28 b(is)h(read)e(from)h
-(a)g(FITS)h(header)e(con)n(taining)h(an)g(IRAF)427 451
+(a)g(FITS)h(header)e(con)n(taining)h(an)g(IRAF)427 1858
y Ft(")p Fj(TNX)p Ft(")g Fj(pro)5 b(jection)26 b(whic)n(h)i(includes)g
(terms)f(not)h(supproted)f(b)n(y)g(AST.)i(Suc)n(h)e(terms)h(are)e
-(ignored)h(and)427 551 y(so)g(the)h(resulting)f(F)-7
-b(rameSet)28 b(ma)n(y)e(b)r(e)i(inaccurate.)340 679 y
-Fi(\017)45 b Ft(")p Fj(Zp)n(x)p Ft(")p Fj(:)39 b(This)29
+(ignored)h(and)427 1958 y(so)g(the)h(resulting)f(F)-7
+b(rameSet)28 b(ma)n(y)e(b)r(e)i(inaccurate.)340 2110
+y Fi(\017)45 b Ft(")p Fj(Zp)n(x)p Ft(")p Fj(:)39 b(This)29
b(condition)g(arises)e(if)j(a)f(F)-7 b(rameSet)29 b(is)g(read)f(from)h
-(a)f(FITS)i(header)e(con)n(taining)g(an)h(IRAF)427 779
+(a)f(FITS)i(header)e(con)n(taining)g(an)h(IRAF)427 2210
y Ft(")p Fj(ZPX)p Ft(")24 b Fj(pro)5 b(jection)25 b(whic)n(h)g
(includes)h Ft(")p Fj(lngcor)p Ft(")d Fj(or)h Ft(")p
Fj(latcor)p Ft(")g Fj(correction)f(terms.)36 b(These)25
-b(terms)g(are)g(not)427 878 y(supp)r(orted)j(b)n(y)f(AST)h(and)f(are)g
+b(terms)g(are)g(not)427 2309 y(supp)r(orted)j(b)n(y)f(AST)h(and)f(are)g
(ignored.)36 b(The)27 b(resulting)g(F)-7 b(rameSet)28
-b(ma)n(y)f(therefore)f(b)r(e)i(inaccurate.)p 0 1069 3780
-12 v 0 1208 a FA(AsTime\(axis\))1116 1201 y Fd(F)-10
-b(ormat)37 b(celestal)g(co)s(ordinates)g(as)1725 1301
-y(times?)2989 1208 y FA(AsTime\(axis\))0 1462 y Fc(Description:)44
+b(ma)n(y)f(therefore)f(b)r(e)i(inaccurate.)p 0 2548 3780
+12 v 0 2686 a FA(AsTime\(axis\))1116 2680 y Fd(F)-10
+b(ormat)37 b(celestal)g(co)s(ordinates)g(as)1725 2779
+y(times?)2989 2686 y FA(AsTime\(axis\))0 2989 y Fc(Description:)44
b Fj(This)21 b(attribute)g(sp)r(eci\014es)g(the)g(default)g(st)n(yle)f
(of)h(formatting)f(to)h(b)r(e)g(used)f(\(e.g.)35 b(b)n(y)20
-b(AST)p Ft(_)p Fj(F)n(ORMA)-7 b(T\))227 1562 y(for)36
+b(AST)p Ft(_)p Fj(F)n(ORMA)-7 b(T\))227 3089 y(for)36
b(the)h(celestial)f(co)r(ordinate)g(v)-5 b(alues)36 b(describ)r(ed)g(b)
n(y)h(a)f(SkyF)-7 b(rame.)63 b(It)37 b(tak)n(es)e(a)i(separate)e(b)r(o)
-r(olean)h(v)-5 b(alue)227 1662 y(for)39 b(eac)n(h)g(SkyF)-7
+r(olean)h(v)-5 b(alue)227 3188 y(for)39 b(eac)n(h)g(SkyF)-7
b(rame)38 b(axis)h(so)g(that,)k(for)c(instance,)j(the)e(setting)f
Ft(")p Fj(AsTime\(2\)=0)p Ft(")f Fj(sp)r(eci\014es)h(the)h(default)227
-1761 y(formatting)27 b(st)n(yle)g(for)h(celestial)f(latitude)h(v)-5
-b(alues.)227 1884 y(If)23 b(the)f(AsTime)g(attribute)g(for)g(a)g(SkyF)
+3288 y(formatting)27 b(st)n(yle)g(for)h(celestial)f(latitude)h(v)-5
+b(alues.)227 3432 y(If)23 b(the)f(AsTime)g(attribute)g(for)g(a)g(SkyF)
-7 b(rame)21 b(axis)g(is)h(zero,)g(then)g(co)r(ordinates)f(on)h(that)g
-(axis)f(will)h(b)r(e)h(formatted)227 1983 y(as)e(angles)f(b)n(y)h
+(axis)f(will)h(b)r(e)h(formatted)227 3532 y(as)e(angles)f(b)n(y)h
(default)g(\(using)g(degrees,)g(min)n(utes)h(and)f(seconds\),)h
(otherwise)e(they)h(will)g(b)r(e)h(formatted)f(as)f(times)227
-2083 y(\(using)28 b(hours,)f(min)n(utes)g(and)h(seconds\).)227
-2205 y(The)h(default)h(v)-5 b(alue)29 b(of)g(AsTime)h(is)f(c)n(hosen)f
+3631 y(\(using)28 b(hours,)f(min)n(utes)g(and)h(seconds\).)227
+3776 y(The)h(default)h(v)-5 b(alue)29 b(of)g(AsTime)h(is)f(c)n(hosen)f
(according)f(to)i(the)h(sky)f(co)r(ordinate)f(system)g(b)r(eing)i
-(represen)n(ted,)227 2305 y(as)22 b(determined)i(b)n(y)e(the)h(SkyF)-7
+(represen)n(ted,)227 3875 y(as)22 b(determined)i(b)n(y)e(the)h(SkyF)-7
b(rame's)22 b(System)h(attribute.)36 b(This)23 b(ensures,)g(for)f
-(example,)i(that)f(righ)n(t)f(ascension)227 2405 y(v)-5
+(example,)i(that)f(righ)n(t)f(ascension)227 3975 y(v)-5
b(alues)27 b(will)h(b)r(e)g(formatted)g(as)f(times)g(b)n(y)h(default,)g
-(follo)n(wing)e(normal)h(con)n(v)n(en)n(tions.)0 2550
-y Fc(T)m(yp)s(e:)227 2649 y Fj(In)n(teger)g(\(b)r(o)r(olean\).)0
-2795 y Fc(Class)k(Applicabilit)m(y:)259 2927 y(SkyF)-8
-b(rame)427 3026 y Fj(All)28 b(SkyF)-7 b(rames)27 b(ha)n(v)n(e)f(this)i
-(attribute.)0 3184 y Fc(Notes:)340 3462 y Fi(\017)45
+(follo)n(wing)e(normal)h(con)n(v)n(en)n(tions.)0 4164
+y Fc(T)m(yp)s(e:)227 4263 y Fj(In)n(teger)g(\(b)r(o)r(olean\).)0
+4452 y Fc(Class)k(Applicabilit)m(y:)259 4628 y(SkyF)-8
+b(rame)427 4728 y Fj(All)28 b(SkyF)-7 b(rames)27 b(ha)n(v)n(e)f(this)i
+(attribute.)0 4929 y Fc(Notes:)340 5251 y Fi(\017)45
b Fj(The)d(AsTime)g(attribute)g(op)r(erates)e(b)n(y)h(c)n(hanging)g
(the)h(default)g(v)-5 b(alue)41 b(of)h(the)g(corresp)r(onding)e(F)-7
-b(or-)427 3562 y(mat\(axis\))28 b(attribute.)37 b(This,)27
+b(or-)427 5351 y(mat\(axis\))28 b(attribute.)37 b(This,)27
b(in)h(turn,)g(ma)n(y)f(also)f(a\013ect)i(the)g(v)-5
b(alue)28 b(of)f(the)h(Unit\(axis\))g(attribute.)340
-3691 y Fi(\017)45 b Fj(Only)38 b(the)g(default)h(st)n(yle)e(of)h
+5503 y Fi(\017)45 b Fj(Only)38 b(the)g(default)h(st)n(yle)e(of)h
(formatting)f(is)h(a\013ected)g(b)n(y)g(the)g(AsTime)g(v)-5
-b(alue.)68 b(If)39 b(an)e(explicit)i(F)-7 b(or-)427 3790
+b(alue.)68 b(If)39 b(an)e(explicit)i(F)-7 b(or-)427 5603
y(mat\(axis\))28 b(v)-5 b(alue)27 b(is)h(set,)f(it)h(will)g(o)n(v)n
(er-ride)d(an)n(y)i(e\013ect)h(from)f(the)h(AsTime)g(attribute.)p
-0 3981 V 0 4112 a FA(Base)1181 4113 y Fd(F)-10 b(rameSet)37
-b(base)i(F)-10 b(rame)39 b(index)3504 4112 y FA(Base)0
-4270 y Fc(Description:)44 b Fj(This)28 b(attribute)g(giv)n(es)f(the)h
+eop end
+%%Page: 422 432
+TeXDict begin 422 431 bop 0 52 a FG(422)1994 b Fz(C)91
+b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
+3780 12 v 0 482 a FA(Base)1181 483 y Fd(F)-10 b(rameSet)37
+b(base)i(F)-10 b(rame)39 b(index)3504 482 y FA(Base)0
+640 y Fc(Description:)44 b Fj(This)28 b(attribute)g(giv)n(es)f(the)h
(index)g(of)f(the)h(F)-7 b(rame)28 b(whic)n(h)f(is)h(to)g(b)r(e)g
(regarded)e(as)h(the)h Ft(")p Fj(base)p Ft(")e Fj(F)-7
-b(rame)227 4370 y(within)30 b(a)e(F)-7 b(rameSet.)40
-b(The)28 b(default)h(is)g(the)g(\014rst)f(F)-7 b(rame)28
-b(added)h(to)f(the)h(F)-7 b(rameSet)29 b(when)g(it)g(is)f(created)g
-(\(this)227 4469 y(F)-7 b(rame)27 b(alw)n(a)n(ys)f(has)h(an)g(index)h
-(of)g(1\).)0 4614 y Fc(T)m(yp)s(e:)227 4714 y Fj(In)n(teger.)0
-4859 y Fc(Class)j(Applicabilit)m(y:)259 4991 y(F)-8 b(rameSet)427
-5091 y Fj(All)28 b(F)-7 b(rameSets)27 b(ha)n(v)n(e)g(this)h(attribute.)
-0 5249 y Fc(Notes:)340 5527 y Fi(\017)45 b Fj(In)n(v)n(erting)17
+b(rame)227 740 y(within)30 b(a)e(F)-7 b(rameSet.)40 b(The)28
+b(default)h(is)g(the)g(\014rst)f(F)-7 b(rame)28 b(added)h(to)f(the)h(F)
+-7 b(rameSet)29 b(when)g(it)g(is)f(created)g(\(this)227
+839 y(F)-7 b(rame)27 b(alw)n(a)n(ys)f(has)h(an)g(index)h(of)g(1\).)0
+984 y Fc(T)m(yp)s(e:)227 1084 y Fj(In)n(teger.)0 1229
+y Fc(Class)j(Applicabilit)m(y:)259 1361 y(F)-8 b(rameSet)427
+1461 y Fj(All)28 b(F)-7 b(rameSets)27 b(ha)n(v)n(e)g(this)h(attribute.)
+0 1618 y Fc(Notes:)340 1897 y Fi(\017)45 b Fj(In)n(v)n(erting)17
b(a)h(F)-7 b(rameSet)19 b(\(in)n(v)n(erting)e(the)i(b)r(o)r(olean)f
(sense)f(of)i(its)f(In)n(v)n(ert)g(attribute,)i(with)f(the)g(AST)p
-Ft(_)p Fj(INVER)-7 b(T)427 5627 y(routine)27 b(for)h(example\))f(will)h
+Ft(_)p Fj(INVER)-7 b(T)427 1996 y(routine)27 b(for)h(example\))f(will)h
(in)n(terc)n(hange)e(the)i(v)-5 b(alues)27 b(of)h(its)f(Base)g(and)g
-(Curren)n(t)g(attributes.)p eop end
-%%Page: 418 428
-TeXDict begin 418 427 bop 0 52 a FG(418)1994 b Fz(C)91
-b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
-3780 12 v 0 483 a FA(Border)298 b Fd(Dra)m(w)38 b(a)h(b)s(order)f
-(around)f(v)-7 b(alid)38 b(regions)g(of)g(a)h(Plot?)297
-b FA(Border)0 687 y Fc(Description:)44 b Fj(This)30 b(attribute)g(con)n
-(trols)e(the)i(app)r(earance)f(of)g(an)h(annotated)f(co)r(ordinate)g
-(grid)g(\(dra)n(wn)g(with)h(the)227 787 y(AST)p Ft(_)p
-Fj(GRID)i(routine\))e(b)n(y)h(determining)g(whether)f(a)h(b)r(order)e
-(is)i(dra)n(wn)f(around)g(regions)f(corresp)r(onding)g(to)227
-887 y(the)f(v)-5 b(alid)28 b(ph)n(ysical)f(co)r(ordinates)f(of)h(a)h
-(Plot)f(\(c.f.)37 b(AST)p Ft(_)p Fj(BORDER\).)227 1017
-y(If)j(the)g(Border)d(v)-5 b(alue)39 b(of)g(a)g(Plot)g(is)g(non-zero,)h
-(then)g(this)g(b)r(order)e(will)h(b)r(e)h(dra)n(wn)e(as)h(part)f(of)i
-(the)f(grid.)227 1116 y(Otherwise,)32 b(the)g(b)r(order)e(is)i(not)f
-(dra)n(wn)g(\(although)g(axis)g(lab)r(els)g(and)g(tic)n(k)g(marks)g
-(will)g(still)h(app)r(ear,)g(unless)227 1216 y(other)25
-b(relev)-5 b(an)n(t)24 b(Plot)g(attributes)h(indicate)f(that)i(they)f
-(should)f(not\).)36 b(The)25 b(default)h(b)r(eha)n(viour)d(is)i(to)g
-(dra)n(w)e(the)227 1316 y(b)r(order)j(if)i(tic)n(k)e(marks)g(and)h(n)n
-(umerical)f(lab)r(els)h(will)g(b)r(e)g(dra)n(wn)f(around)g(the)h(edges)
-f(of)h(the)g(plotting)g(area)f(\(see)227 1415 y(the)i(Lab)r(elling)f
-(attribute\),)i(but)f(to)f(omit)h(it)g(otherwise.)0 1576
-y Fc(T)m(yp)s(e:)227 1675 y Fj(In)n(teger)f(\(b)r(o)r(olean\).)0
-1836 y Fc(Class)k(Applicabilit)m(y:)259 1983 y(Plot)427
-2083 y Fj(All)d(Plots)f(ha)n(v)n(e)g(this)g(attribute.)p
-0 2293 V 0 2431 a FA(Bottom\(axis\))1173 2424 y Fd(Lo)m(w)m(est)37
-b(axis)h(v)-7 b(alue)39 b(to)f(displa)m(y)3001 2431 y
-FA(Bottom\(axis\))0 2642 y Fc(Description:)44 b Fj(This)23
-b(attribute)g(giv)n(es)f(the)h(lo)n(w)n(est)f(axis)g(v)-5
+(Curren)n(t)g(attributes.)p 0 2187 V 0 2319 a FA(Border)298
+b Fd(Dra)m(w)38 b(a)h(b)s(order)f(around)f(v)-7 b(alid)38
+b(regions)g(of)g(a)h(Plot?)297 b FA(Border)0 2503 y Fc(Description:)44
+b Fj(This)30 b(attribute)g(con)n(trols)e(the)i(app)r(earance)f(of)g(an)
+h(annotated)f(co)r(ordinate)g(grid)g(\(dra)n(wn)g(with)h(the)227
+2603 y(AST)p Ft(_)p Fj(GRID)i(routine\))e(b)n(y)h(determining)g
+(whether)f(a)h(b)r(order)e(is)i(dra)n(wn)f(around)g(regions)f(corresp)r
+(onding)g(to)227 2703 y(the)f(v)-5 b(alid)28 b(ph)n(ysical)f(co)r
+(ordinates)f(of)h(a)h(Plot)f(\(c.f.)37 b(AST)p Ft(_)p
+Fj(BORDER\).)227 2825 y(If)j(the)g(Border)d(v)-5 b(alue)39
+b(of)g(a)g(Plot)g(is)g(non-zero,)h(then)g(this)g(b)r(order)e(will)h(b)r
+(e)h(dra)n(wn)e(as)h(part)f(of)i(the)f(grid.)227 2925
+y(Otherwise,)32 b(the)g(b)r(order)e(is)i(not)f(dra)n(wn)g(\(although)g
+(axis)g(lab)r(els)g(and)g(tic)n(k)g(marks)g(will)g(still)h(app)r(ear,)g
+(unless)227 3024 y(other)25 b(relev)-5 b(an)n(t)24 b(Plot)g(attributes)
+h(indicate)f(that)i(they)f(should)f(not\).)36 b(The)25
+b(default)h(b)r(eha)n(viour)d(is)i(to)g(dra)n(w)e(the)227
+3124 y(b)r(order)j(if)i(tic)n(k)e(marks)g(and)h(n)n(umerical)f(lab)r
+(els)h(will)g(b)r(e)g(dra)n(wn)f(around)g(the)h(edges)f(of)h(the)g
+(plotting)g(area)f(\(see)227 3224 y(the)i(Lab)r(elling)f(attribute\),)i
+(but)f(to)f(omit)h(it)g(otherwise.)0 3369 y Fc(T)m(yp)s(e:)227
+3468 y Fj(In)n(teger)f(\(b)r(o)r(olean\).)0 3614 y Fc(Class)k
+(Applicabilit)m(y:)259 3746 y(Plot)427 3845 y Fj(All)d(Plots)f(ha)n(v)n
+(e)g(this)g(attribute.)p 0 4036 V 0 4174 a FA(Bottom\(axis\))1173
+4168 y Fd(Lo)m(w)m(est)37 b(axis)h(v)-7 b(alue)39 b(to)f(displa)m(y)
+3001 4174 y FA(Bottom\(axis\))0 4366 y Fc(Description:)44
+b Fj(This)23 b(attribute)g(giv)n(es)f(the)h(lo)n(w)n(est)f(axis)g(v)-5
b(alue)23 b(to)g(b)r(e)g(displa)n(y)n(ed)f(\(for)g(instance,)i(b)n(y)f
-(the)g(AST)p Ft(_)p Fj(GRID)227 2742 y(metho)r(d\).)0
-2902 y Fc(T)m(yp)s(e:)227 3002 y Fj(Floating)k(p)r(oin)n(t.)0
-3162 y Fc(Class)k(Applicabilit)m(y:)259 3310 y(F)-8 b(rame)427
-3409 y Fj(The)28 b(default)g(supplied)g(b)n(y)f(the)h(F)-7
+(the)g(AST)p Ft(_)p Fj(GRID)227 4465 y(metho)r(d\).)0
+4610 y Fc(T)m(yp)s(e:)227 4710 y Fj(Floating)k(p)r(oin)n(t.)0
+4855 y Fc(Class)k(Applicabilit)m(y:)259 4987 y(F)-8 b(rame)427
+5087 y Fj(The)28 b(default)g(supplied)g(b)n(y)f(the)h(F)-7
b(rame)27 b(class)g(is)g(to)h(displa)n(y)f(all)g(axis)g(v)-5
-b(alues,)27 b(without)h(an)n(y)f(limit.)259 3548 y Fc(SkyF)-8
-b(rame)427 3647 y Fj(The)27 b(SkyF)-7 b(rame)25 b(class)g(re-de\014nes)
+b(alues,)27 b(without)h(an)n(y)f(limit.)259 5216 y Fc(SkyF)-8
+b(rame)427 5315 y Fj(The)27 b(SkyF)-7 b(rame)25 b(class)g(re-de\014nes)
h(the)h(default)f(Bottom)g(v)-5 b(alue)26 b(to)h(-90)e(degrees)g(for)g
-(latitude)i(axes,)f(and)427 3747 y(0)h(degrees)g(for)g(co-latitude)g
+(latitude)i(axes,)f(and)427 5415 y(0)h(degrees)g(for)g(co-latitude)g
(axes.)36 b(The)27 b(default)i(for)e(longitude)g(axes)g(is)g(to)h
-(displa)n(y)e(all)i(axis)f(v)-5 b(alues.)0 3920 y Fc(Notes:)340
-4213 y Fi(\017)45 b Fj(When)36 b(sp)r(ecifying)f(this)h(attribute)f(b)n
-(y)g(name,)i(it)f(should)f(b)r(e)h(subscripted)f(with)g(the)h(n)n(um)n
-(b)r(er)f(of)g(the)427 4313 y(F)-7 b(rame)27 b(axis)g(to)h(whic)n(h)f
-(it)h(applies.)p 0 4523 V 0 4655 a FA(Bounded)758 b Fd(Is)40
-b(the)e(Region)g(b)s(ounded?)759 b FA(Bounded)0 4854
-y Fc(Description:)44 b Fj(This)27 b(is)g(a)f(read-only)g(attribute)h
-(indicating)f(if)i(the)f(Region)f(is)h(b)r(ounded.)37
-b(A)27 b(Region)f(is)h(b)r(ounded)g(if)227 4954 y(it)h(is)g(con)n
+(displa)n(y)e(all)i(axis)f(v)-5 b(alues.)0 5572 y Fc(Notes:)p
+eop end
+%%Page: 423 433
+TeXDict begin 423 432 bop 3643 52 a FG(423)340 351 y
+Fi(\017)45 b Fj(When)36 b(sp)r(ecifying)f(this)h(attribute)f(b)n(y)g
+(name,)i(it)f(should)f(b)r(e)h(subscripted)f(with)g(the)h(n)n(um)n(b)r
+(er)f(of)g(the)427 451 y(F)-7 b(rame)27 b(axis)g(to)h(whic)n(h)f(it)h
+(applies.)p 0 654 3780 12 v 0 786 a FA(Bounded)758 b
+Fd(Is)40 b(the)e(Region)g(b)s(ounded?)759 b FA(Bounded)0
+979 y Fc(Description:)44 b Fj(This)27 b(is)g(a)f(read-only)g(attribute)
+h(indicating)f(if)i(the)f(Region)f(is)h(b)r(ounded.)37
+b(A)27 b(Region)f(is)h(b)r(ounded)g(if)227 1078 y(it)h(is)g(con)n
(tained)f(en)n(tirely)g(within)h(some)f(\014nite-size)g(b)r(ounding)h
-(b)r(o)n(x.)0 5115 y Fc(T)m(yp)s(e:)227 5214 y Fj(In)n(teger)f(\(b)r(o)
-r(olean\),)h(read-only)-7 b(.)0 5375 y Fc(Class)31 b(Applicabilit)m(y:)
-259 5522 y(Region)427 5622 y Fj(All)d(Regions)f(ha)n(v)n(e)f(this)i
-(attribute.)p eop end
-%%Page: 419 429
-TeXDict begin 419 428 bop 3643 52 a FG(419)p 0 351 3780
-12 v 0 483 a FA(CDMatrix)298 b Fd(Use)39 b(CDi)p Fe(_)p
-Fd(j)f(k)m(eyw)m(ords)f(to)h(represen)m(t)g(pixel)1338
-598 y(scaling,)f(rotation,)e(etc?)3171 483 y FA(CDMatrix)0
-791 y Fc(Description:)44 b Fj(This)26 b(attribute)f(is)g(a)g(b)r(o)r
+(b)r(o)n(x.)0 1232 y Fc(T)m(yp)s(e:)227 1332 y Fj(In)n(teger)f(\(b)r(o)
+r(olean\),)h(read-only)-7 b(.)0 1485 y Fc(Class)31 b(Applicabilit)m(y:)
+259 1626 y(Region)427 1725 y Fj(All)d(Regions)f(ha)n(v)n(e)f(this)i
+(attribute.)p 0 1929 V 0 2060 a FA(CDMatrix)298 b Fd(Use)39
+b(CDi)p Fe(_)p Fd(j)f(k)m(eyw)m(ords)f(to)h(represen)m(t)g(pixel)1338
+2175 y(scaling,)f(rotation,)e(etc?)3171 2060 y FA(CDMatrix)0
+2368 y Fc(Description:)44 b Fj(This)26 b(attribute)f(is)g(a)g(b)r(o)r
(olean)g(v)-5 b(alue)25 b(whic)n(h)g(sp)r(eci\014es)g(ho)n(w)g(the)h
-(linear)e(transformation)g(from)h(pixel)227 890 y(co)r(ordinates)d(to)g
-(in)n(termediate)h(w)n(orld)e(co)r(ordinates)h(should)g(b)r(e)i
+(linear)e(transformation)g(from)h(pixel)227 2467 y(co)r(ordinates)d(to)
+g(in)n(termediate)h(w)n(orld)e(co)r(ordinates)h(should)g(b)r(e)i
(represen)n(ted)d(within)j(a)e(FitsChan)h(when)g(using)227
-990 y(FITS-W)n(CS)29 b(enco)r(ding.)40 b(This)29 b(transformation)e
+2567 y(FITS-W)n(CS)29 b(enco)r(ding.)40 b(This)29 b(transformation)e
(describ)r(es)h(the)h(scaling,)f(rotation,)g(shear,)g(etc.,)h(of)f(the)
-i(pixel)227 1090 y(axes.)227 1216 y(If)38 b(the)g(attribute)g(has)f(a)g
+i(pixel)227 2667 y(axes.)227 2793 y(If)38 b(the)g(attribute)g(has)f(a)g
(non-zero)f(v)-5 b(alue)38 b(then)g(the)g(transformation)e(is)h
(represen)n(ted)g(b)n(y)g(a)g(set)h(of)f(CDi)p Ft(_)p
-Fj(j)227 1316 y(k)n(eyw)n(ords)23 b(represen)n(ting)g(a)i(square)e
+Fj(j)227 2893 y(k)n(eyw)n(ords)23 b(represen)n(ting)g(a)i(square)e
(matrix)h(\(where)h Ft(")p Fj(i)p Ft(")f Fj(is)g(the)i(index)e(of)h(an)
-g(in)n(termediate)f(w)n(orld)g(co)r(ordinate)227 1415
+g(in)n(termediate)f(w)n(orld)g(co)r(ordinate)227 2992
y(axis)36 b(and)f Ft(")p Fj(j)p Ft(")h Fj(is)g(the)g(index)g(of)g(a)g
(pixel)g(axis\).)62 b(If)36 b(the)h(attribute)f(has)f(a)h(zero)f(v)-5
-b(alue)36 b(the)g(transformation)227 1515 y(is)f(represen)n(ted)e(b)n
+b(alue)36 b(the)g(transformation)227 3092 y(is)f(represen)n(ted)e(b)n
(y)i(a)f(set)g(of)h(PCi)p Ft(_)p Fj(j)f(k)n(eyw)n(ords)f(\(whic)n(h)i
(also)e(represen)n(t)g(a)i(square)e(matrix\))h(together)g(with)227
-1615 y(a)i(corresp)r(onding)f(set)h(of)g(CDEL)-7 b(Ti)37
+3192 y(a)i(corresp)r(onding)f(set)h(of)g(CDEL)-7 b(Ti)37
b(k)n(eyw)n(ords)d(represen)n(ting)h(the)i(axis)e(scalings.)62
-b(See)37 b(FITS-W)n(CS)f(pap)r(er)227 1714 y(I)r(I)i
+b(See)37 b(FITS-W)n(CS)f(pap)r(er)227 3291 y(I)r(I)i
Ft(")p Fj(Represen)n(tation)d(of)i(Celestial)g(Co)r(ordinates)f(in)h
(FITS)p Ft(")g Fj(b)n(y)g(M.)g(Calabretta)f(&)g(E.W.)i(Greisen,)g(for)f
-(a)227 1814 y(complete)28 b(description)f(of)g(these)h(t)n(w)n(o)f(sc)n
-(hemes.)227 1941 y(The)g(default)f(v)-5 b(alue)26 b(of)g(the)h
+(a)227 3391 y(complete)28 b(description)f(of)g(these)h(t)n(w)n(o)f(sc)n
+(hemes.)227 3517 y(The)g(default)f(v)-5 b(alue)26 b(of)g(the)h
(CDMatrix)f(attribute)g(is)h(determined)f(b)n(y)g(the)g(con)n(ten)n(ts)
-g(of)g(the)h(FitsChan)f(at)g(the)227 2040 y(time)f(the)g(attribute)f
+g(of)g(the)h(FitsChan)f(at)g(the)227 3617 y(time)f(the)g(attribute)f
(is)g(accessed.)35 b(If)24 b(the)h(FitsChan)f(con)n(tains)f(an)n(y)h
(CDi)p Ft(_)p Fj(j)h(k)n(eyw)n(ords)d(then)i(the)h(default)g(v)-5
-b(alue)227 2140 y(is)21 b(non-zero.)32 b(Otherwise)20
+b(alue)227 3717 y(is)21 b(non-zero.)32 b(Otherwise)20
b(it)h(is)f(zero.)33 b(Note,)22 b(reading)d(a)h(F)-7
b(rameSet)20 b(from)g(a)g(FitsChan)h(will)f(in)h(general)e(consume)227
-2240 y(an)n(y)33 b(CDi)p Ft(_)p Fj(j)i(k)n(eyw)n(ords)d(presen)n(t)h
+3816 y(an)n(y)33 b(CDi)p Ft(_)p Fj(j)i(k)n(eyw)n(ords)d(presen)n(t)h
(in)h(the)g(FitsChan.)56 b(Th)n(us)34 b(the)g(default)g(v)-5
-b(alue)34 b(for)g(CDMatrix)f(follo)n(wing)g(a)227 2339
+b(alue)34 b(for)g(CDMatrix)f(follo)n(wing)g(a)227 3916
y(read)g(will)g(usually)g(b)r(e)h(zero,)g(ev)n(en)f(if)h(the)g
(FitsChan)f(originally)f(con)n(tained)h(some)g(CDi)p
-Ft(_)p Fj(j)g(k)n(eyw)n(ords.)53 b(This)227 2439 y(b)r(eha)n(viour)31
+Ft(_)p Fj(j)g(k)n(eyw)n(ords.)53 b(This)227 4016 y(b)r(eha)n(viour)31
b(is)g(similar)g(to)g(that)h(of)f(the)h(Enco)r(ding)f(attribute,)h(the)
g(default)g(v)-5 b(alue)32 b(for)f(whic)n(h)g(is)g(determined)227
-2538 y(b)n(y)i(the)g(con)n(ten)n(ts)g(of)f(the)i(FitsChan)f(at)g(the)g
+4115 y(b)n(y)i(the)g(con)n(ten)n(ts)g(of)f(the)i(FitsChan)f(at)g(the)g
(time)g(the)h(attribute)f(is)g(accessed.)51 b(If)34 b(y)n(ou)e(wish)h
-(to)g(retain)f(the)227 2638 y(original)24 b(v)-5 b(alue)25
+(to)g(retain)f(the)227 4215 y(original)24 b(v)-5 b(alue)25
b(of)g(the)h(CDMatrix)f(attribute)g(\(that)h(is,)f(the)h(v)-5
b(alue)25 b(b)r(efore)g(reading)f(the)h(F)-7 b(rameSet\))26
-b(then)f(y)n(ou)227 2738 y(should)j(enquire)f(the)h(default)g(v)-5
+b(then)f(y)n(ou)227 4314 y(should)j(enquire)f(the)h(default)g(v)-5
b(alue)27 b(b)r(efore)h(doing)f(the)h(read,)e(and)i(then)g(set)f(that)h
-(v)-5 b(alue)28 b(explicitly)-7 b(.)0 2891 y Fc(T)m(yp)s(e:)227
-2991 y Fj(In)n(teger)27 b(\(b)r(o)r(olean\).)0 3145 y
-Fc(Class)k(Applicabilit)m(y:)259 3286 y(FitsChan)427
-3385 y Fj(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)p
-0 3589 V 0 3720 a FA(CarLin)268 b Fd(Ignore)38 b(spherical)g(rotations)
-e(on)i(CAR)h(pro)7 b(jections?)265 b FA(CarLin)0 3918
+(v)-5 b(alue)28 b(explicitly)-7 b(.)0 4468 y Fc(T)m(yp)s(e:)227
+4568 y Fj(In)n(teger)27 b(\(b)r(o)r(olean\).)0 4721 y
+Fc(Class)k(Applicabilit)m(y:)259 4862 y(FitsChan)427
+4961 y Fj(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)p
+0 5165 V 0 5296 a FA(CarLin)268 b Fd(Ignore)38 b(spherical)g(rotations)
+e(on)i(CAR)h(pro)7 b(jections?)265 b FA(CarLin)0 5494
y Fc(Description:)44 b Fj(This)e(attribute)f(is)g(a)g(b)r(o)r(olean)g
(v)-5 b(alue)41 b(whic)n(h)g(sp)r(eci\014es)g(ho)n(w)g(FITS)g
Ft(")p Fj(CAR)p Ft(")g Fj(\(plate)g(carree,)i(or)227
-4018 y Ft(")p Fj(Cartesian)p Ft(")p Fj(\))23 b(pro)5
+5593 y Ft(")p Fj(Cartesian)p Ft(")p Fj(\))23 b(pro)5
b(jections)24 b(should)h(b)r(e)g(treated)g(when)g(reading)f(a)g(F)-7
b(rameSet)25 b(from)g(a)f(foreign)g(enco)r(ded)h(FITS)227
-4117 y(header.)43 b(If)30 b(zero)f(\(the)h(default\),)h(it)g(is)e
+5693 y(header.)43 b(If)30 b(zero)f(\(the)h(default\),)h(it)g(is)e
(assumed)h(that)g(the)g(CAR)g(pro)5 b(jection)29 b(conforms)f(to)i(the)
-g(con)n(v)n(en)n(tions)227 4217 y(describ)r(ed)j(in)g(the)h(FITS)f(w)n
-(orld)f(co)r(ordinate)g(system)h(\(FITS-W)n(CS\))h(pap)r(er)e(I)r(I)i
-Ft(")p Fj(Represen)n(tation)d(of)i(Celes-)227 4317 y(tial)h(Co)r
-(ordinates)e(in)h(FITS)p Ft(")h Fj(b)n(y)f(M.)g(Calabretta)g(&)g(E.W.)g
-(Greisen.)54 b(If)34 b(CarLin)e(is)h(non-zero,)h(then)g(these)227
-4416 y(con)n(v)n(en)n(tions)f(are)g(ignored,)i(and)f(it)h(is)f(assumed)
-g(that)h(the)f(mapping)h(from)f(pixel)g(co)r(ordinates)f(to)h
-(celestial)227 4516 y(co)r(ordinates)25 b(is)h(a)g(simple)g(linear)f
+g(con)n(v)n(en)n(tions)p eop end
+%%Page: 424 434
+TeXDict begin 424 433 bop 0 52 a FG(424)1994 b Fz(C)91
+b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)227 351
+y Fj(describ)r(ed)i(in)g(the)h(FITS)f(w)n(orld)f(co)r(ordinate)g
+(system)h(\(FITS-W)n(CS\))h(pap)r(er)e(I)r(I)i Ft(")p
+Fj(Represen)n(tation)d(of)i(Celes-)227 451 y(tial)h(Co)r(ordinates)e
+(in)h(FITS)p Ft(")h Fj(b)n(y)f(M.)g(Calabretta)g(&)g(E.W.)g(Greisen.)54
+b(If)34 b(CarLin)e(is)h(non-zero,)h(then)g(these)227
+551 y(con)n(v)n(en)n(tions)f(are)g(ignored,)i(and)f(it)h(is)f(assumed)g
+(that)h(the)f(mapping)h(from)f(pixel)g(co)r(ordinates)f(to)h(celestial)
+227 650 y(co)r(ordinates)25 b(is)h(a)g(simple)g(linear)f
(transformation)g(\(hence)h(the)h(attribute)f(name)g
Ft(")p Fj(CarLin)p Ft(")p Fj(\).)35 b(This)26 b(is)g(appro-)227
-4616 y(priate)31 b(for)f(some)g(older)g(FITS)h(data)f(whic)n(h)h
-(claims)f(to)h(ha)n(v)n(e)f(a)g Ft(")p Fj(CAR)p Ft(")g
-Fj(pro)5 b(jection,)31 b(but)g(whic)n(h)g(in)g(fact)g(do)227
-4715 y(not)d(conform)g(to)g(the)g(con)n(v)n(en)n(tions)e(of)i(the)h
-(FITS-W)n(CS)f(pap)r(er.)38 b(F)-7 b(urthermore,)27 b(if)i(CarLin)e(is)
-h(non-zero,)e(it)j(is)227 4815 y(assumed)i(that)h(CDEL)-7
+750 y(priate)31 b(for)f(some)g(older)g(FITS)h(data)f(whic)n(h)h(claims)
+f(to)h(ha)n(v)n(e)f(a)g Ft(")p Fj(CAR)p Ft(")g Fj(pro)5
+b(jection,)31 b(but)g(whic)n(h)g(in)g(fact)g(do)227 849
+y(not)d(conform)g(to)g(the)g(con)n(v)n(en)n(tions)e(of)i(the)h(FITS-W)n
+(CS)f(pap)r(er.)38 b(F)-7 b(urthermore,)27 b(if)i(CarLin)e(is)h
+(non-zero,)e(it)j(is)227 949 y(assumed)i(that)h(CDEL)-7
b(T)31 b(and)h(CD)f(k)n(eyw)n(ords)f(are)g(in)i(units)g(of)f(degrees)f
-(rather)h(than)g(radians)f(\(as)i(required)227 4914 y(b)n(y)c(the)g
-(FITS-W)n(CS)f(pap)r(ers\).)227 5041 y(The)34 b(FITS-W)n(CS)g(pap)r(er)
+(rather)h(than)g(radians)f(\(as)i(required)227 1049 y(b)n(y)c(the)g
+(FITS-W)n(CS)f(pap)r(ers\).)227 1166 y(The)34 b(FITS-W)n(CS)g(pap)r(er)
g(sp)r(eci\014es)g(that)g(headers)f(whic)n(h)h(include)g(a)g(CAR)g(pro)
-5 b(jection)33 b(represen)n(t)g(a)g(linear)227 5141 y(mapping)c(from)f
+5 b(jection)33 b(represen)n(t)g(a)g(linear)227 1266 y(mapping)c(from)f
(pixel)h(co)r(ordinates)e(to)h Ft(")p Fj(nativ)n(e)g(spherical)g(co)r
(ordinates)p Ft(")p Fj(,)f(NOT)h(celestial)h(co)r(ordinates.)38
-b(An)227 5240 y(extra)30 b(mapping)g(is)h(then)g(required)f(from)g
+b(An)227 1365 y(extra)30 b(mapping)g(is)h(then)g(required)f(from)g
(nativ)n(e)g(spherical)g(to)g(celestial.)45 b(This)31
-b(mapping)f(is)h(a)f(3D)h(rotation)227 5340 y(and)e(so)f(the)h(o)n(v)n
+b(mapping)f(is)h(a)f(3D)h(rotation)227 1465 y(and)e(so)f(the)h(o)n(v)n
(erall)e(Mapping)h(from)h(pixel)f(to)h(celestial)f(co)r(ordinates)g(is)
-g(NOT)h(linear.)40 b(See)28 b(the)h(FITS-W)n(CS)227 5440
-y(pap)r(ers)e(for)g(further)h(details.)0 5593 y Fc(T)m(yp)s(e:)227
-5693 y Fj(In)n(teger)f(\(b)r(o)r(olean\).)p eop end
-%%Page: 420 430
-TeXDict begin 420 429 bop 0 52 a FG(420)1994 b Fz(C)91
-b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)0 351 y
-Fc(Class)g(Applicabilit)m(y:)259 497 y(FitsChan)427 597
-y Fj(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)p
-0 805 3780 12 v 0 937 a FA(Card)528 b Fd(Index)39 b(of)f(curren)m(t)g
-(FITS)h(card)f(in)h(a)f(FitsChan)526 b FA(Card)0 1112
-y Fc(Description:)44 b Fj(This)28 b(attribute)g(giv)n(es)f(the)h(index)
-g(of)g(the)g Ft(")p Fj(curren)n(t)p Ft(")e Fj(FITS)i(header)f(card)g
-(within)i(a)e(FitsChan,)h(the)227 1212 y(\014rst)23 b(card)g(ha)n(ving)
-f(an)h(index)g(of)g(1.)35 b(The)23 b(c)n(hoice)g(of)g(curren)n(t)f
-(card)h(a\013ects)g(the)g(b)r(eha)n(viour)f(of)h(routines)g(that)g(ac-)
-227 1311 y(cess)i(the)g(con)n(ten)n(ts)f(of)h(the)g(FitsChan,)h(suc)n
-(h)e(as)h(AST)p Ft(_)p Fj(DELFITS,)g(AST)p Ft(_)p Fj(FINDFITS)h(and)f
-(AST)p Ft(_)p Fj(PUTFITS.)227 1440 y(A)h(v)-5 b(alue)25
-b(assigned)f(to)h(Card)f(will)h(p)r(osition)g(the)h(FitsChan)f(at)g(an)
-n(y)g(desired)f(p)r(oin)n(t,)i(so)e(that)i(a)f(particular)e(card)227
-1540 y(within)28 b(it)g(can)f(b)r(e)h(accessed.)36 b(Alternativ)n(ely)
+g(NOT)h(linear.)40 b(See)28 b(the)h(FITS-W)n(CS)227 1564
+y(pap)r(ers)e(for)g(further)h(details.)0 1699 y Fc(T)m(yp)s(e:)227
+1799 y Fj(In)n(teger)f(\(b)r(o)r(olean\).)0 1934 y Fc(Class)k
+(Applicabilit)m(y:)259 2056 y(FitsChan)427 2155 y Fj(All)d(FitsChans)g
+(ha)n(v)n(e)e(this)i(attribute.)p 0 2325 3780 12 v 0
+2457 a FA(Card)528 b Fd(Index)39 b(of)f(curren)m(t)g(FITS)h(card)f(in)h
+(a)f(FitsChan)526 b FA(Card)0 2593 y Fc(Description:)44
+b Fj(This)28 b(attribute)g(giv)n(es)f(the)h(index)g(of)g(the)g
+Ft(")p Fj(curren)n(t)p Ft(")e Fj(FITS)i(header)f(card)g(within)i(a)e
+(FitsChan,)h(the)227 2693 y(\014rst)23 b(card)g(ha)n(ving)f(an)h(index)
+g(of)g(1.)35 b(The)23 b(c)n(hoice)g(of)g(curren)n(t)f(card)h(a\013ects)
+g(the)g(b)r(eha)n(viour)f(of)h(routines)g(that)g(ac-)227
+2793 y(cess)i(the)g(con)n(ten)n(ts)f(of)h(the)g(FitsChan,)h(suc)n(h)e
+(as)h(AST)p Ft(_)p Fj(DELFITS,)g(AST)p Ft(_)p Fj(FINDFITS)h(and)f(AST)p
+Ft(_)p Fj(PUTFITS.)227 2910 y(A)h(v)-5 b(alue)25 b(assigned)f(to)h
+(Card)f(will)h(p)r(osition)g(the)h(FitsChan)f(at)g(an)n(y)g(desired)f
+(p)r(oin)n(t,)i(so)e(that)i(a)f(particular)e(card)227
+3009 y(within)28 b(it)g(can)f(b)r(e)h(accessed.)36 b(Alternativ)n(ely)
-7 b(,)27 b(the)h(v)-5 b(alue)27 b(of)h(Card)e(ma)n(y)h(b)r(e)h
-(enquired)f(in)h(order)e(to)i(determine)227 1640 y(the)g(curren)n(t)f
-(p)r(osition)g(of)h(a)f(FitsChan.)227 1769 y(The)39 b(default)f(v)-5
+(enquired)f(in)h(order)e(to)i(determine)227 3109 y(the)g(curren)n(t)f
+(p)r(osition)g(of)h(a)f(FitsChan.)227 3226 y(The)39 b(default)f(v)-5
b(alue)38 b(of)g(Card)g(is)g(1.)68 b(This)38 b(means)g(that)h(clearing)
e(this)h(attribute)g(\(using)h(AST)p Ft(_)p Fj(CLEAR\))227
-1868 y(e\013ectiv)n(ely)26 b Ft(")p Fj(rewinds)p Ft(")e
+3326 y(e\013ectiv)n(ely)26 b Ft(")p Fj(rewinds)p Ft(")e
Fj(the)j(FitsChan,)f(so)f(that)h(the)g(\014rst)g(card)f(is)h(accessed)e
(next.)37 b(If)26 b(Card)f(is)h(set)g(to)f(a)h(v)-5 b(alue)227
-1968 y(whic)n(h)33 b(exceeds)e(the)i(total)f(n)n(um)n(b)r(er)h(of)f
+3425 y(whic)n(h)33 b(exceeds)e(the)i(total)f(n)n(um)n(b)r(er)h(of)f
(cards)f(in)i(the)g(FitsChan)f(\(as)g(giv)n(en)g(b)n(y)g(its)h(Ncard)f
-(attribute\),)i(it)f(is)227 2068 y(regarded)23 b(as)h(p)r(oin)n(ting)g
+(attribute\),)i(it)f(is)227 3525 y(regarded)23 b(as)h(p)r(oin)n(ting)g
(at)g(the)h Ft(")p Fj(end-of-\014le)p Ft(")p Fj(.)34
b(In)25 b(this)g(case,)f(the)h(v)-5 b(alue)24 b(returned)g(in)g(resp)r
-(onse)g(to)g(an)g(enquiry)227 2167 y(is)k(alw)n(a)n(ys)d(one)j(more)e
+(onse)g(to)g(an)g(enquiry)227 3625 y(is)k(alw)n(a)n(ys)d(one)j(more)e
(than)i(the)g(n)n(um)n(b)r(er)f(of)h(cards)e(in)i(the)g(FitsChan.)0
-2326 y Fc(T)m(yp)s(e:)227 2426 y Fj(In)n(teger.)0 2585
-y Fc(Class)j(Applicabilit)m(y:)259 2730 y(FitsChan)427
-2830 y Fj(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)p
-0 3039 V 0 3170 a FA(CardT)l(yp)t(e)313 b Fd(The)39 b(data)e(t)m(yp)s
-(e)i(of)f(the)h(curren)m(t)e(card)h(in)h(a)1653 3285
-y(FitsChan)3187 3170 y FA(CardT)l(yp)t(e)0 3460 y Fc(Description:)44
+3760 y Fc(T)m(yp)s(e:)227 3859 y Fj(In)n(teger.)0 3994
+y Fc(Class)j(Applicabilit)m(y:)259 4116 y(FitsChan)427
+4215 y Fj(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)p
+0 4386 V 0 4517 a FA(CardT)l(yp)t(e)313 b Fd(The)39 b(data)e(t)m(yp)s
+(e)i(of)f(the)h(curren)m(t)e(card)h(in)h(a)1653 4632
+y(FitsChan)3187 4517 y FA(CardT)l(yp)t(e)0 4768 y Fc(Description:)44
b Fj(This)f(attribute)h(giv)n(es)d(the)j(data)e(t)n(yp)r(e)i(of)f(the)g
(k)n(eyw)n(ord)e(v)-5 b(alue)43 b(for)g(the)g(curren)n(t)f(card)g(of)h
-(the)227 3559 y(FitsChan.)37 b(It)25 b(will)h(b)r(e)g(one)f(of)h(the)f
+(the)227 4868 y(FitsChan.)37 b(It)25 b(will)h(b)r(e)g(one)f(of)h(the)f
(follo)n(wing)g(in)n(teger)f(constan)n(ts:)35 b(AST)p
Ft(__)p Fj(NOTYPE,)24 b(AST)p Ft(__)p Fj(COMMENT,)227
-3659 y(AST)p Ft(__)p Fj(INT,)19 b(AST)p Ft(__)p Fj(FLO)n(A)-7
+4967 y(AST)p Ft(__)p Fj(INT,)19 b(AST)p Ft(__)p Fj(FLO)n(A)-7
b(T,)17 b(AST)p Ft(__)p Fj(STRING,)i(AST)p Ft(__)p Fj(COMPLEXF,)e(AST)p
Ft(__)p Fj(COMPLEXI,)g(AST)p Ft(__)p Fj(LOGICAL,)227
-3759 y(AST)p Ft(__)p Fj(CONTINUE,)27 b(AST)p Ft(__)p
-Fj(UNDEF.)0 3917 y Fc(T)m(yp)s(e:)227 4017 y Fj(In)n(teger,)g
-(read-only)-7 b(.)0 4176 y Fc(Class)31 b(Applicabilit)m(y:)259
-4322 y(FitsChan)427 4421 y Fj(All)d(FitsChans)g(ha)n(v)n(e)e(this)i
-(attribute.)p 0 4630 V 0 4762 a FA(Class)1118 b Fd(Ob)7
-b(ject)37 b(class)i(name)1116 b FA(Class)0 4960 y Fc(Description:)44
-b Fj(This)28 b(attribute)g(giv)n(es)e(the)i(name)f(of)h(the)g(class)f
-(to)g(whic)n(h)h(an)f(Ob)5 b(ject)27 b(b)r(elongs.)0
-5119 y Fc(T)m(yp)s(e:)227 5218 y Fj(Character)f(string,)h(read-only)-7
-b(.)0 5377 y Fc(Class)31 b(Applicabilit)m(y:)259 5523
-y(Ob)5 b(ject)427 5622 y Fj(All)28 b(Ob)5 b(jects)28
-b(ha)n(v)n(e)e(this)i(attribute.)p eop end
-%%Page: 421 431
-TeXDict begin 421 430 bop 3643 52 a FG(421)p 0 351 3780
-12 v 0 483 a FA(Clean)275 b Fd(Remo)m(v)m(e)38 b(cards)g(used)h(whilst)
-f(reading)f(ev)m(en)h(if)h(an)f(error)1701 598 y(o)s(ccurs?)3444
-483 y FA(Clean)0 764 y Fc(Description:)44 b Fj(This)27
-b(attribute)f(indicates)g(whether)g(or)g(not)g(cards)f(should)i(b)r(e)f
-(remo)n(v)n(ed)f(from)h(the)h(FitsChan)f(if)h(an)227
-864 y(error)g(o)r(ccurs)h(within)h(AST)p Ft(_)p Fj(READ.)g(A)g
+5067 y(AST)p Ft(__)p Fj(CONTINUE,)27 b(AST)p Ft(__)p
+Fj(UNDEF.)0 5202 y Fc(T)m(yp)s(e:)227 5302 y Fj(In)n(teger,)g
+(read-only)-7 b(.)0 5436 y Fc(Class)31 b(Applicabilit)m(y:)259
+5558 y(FitsChan)427 5658 y Fj(All)d(FitsChans)g(ha)n(v)n(e)e(this)i
+(attribute.)p eop end
+%%Page: 425 435
+TeXDict begin 425 434 bop 3643 52 a FG(425)p 0 351 3780
+12 v 0 483 a FA(Class)1118 b Fd(Ob)7 b(ject)37 b(class)i(name)1116
+b FA(Class)0 683 y Fc(Description:)44 b Fj(This)28 b(attribute)g(giv)n
+(es)e(the)i(name)f(of)h(the)g(class)f(to)g(whic)n(h)h(an)f(Ob)5
+b(ject)27 b(b)r(elongs.)0 844 y Fc(T)m(yp)s(e:)227 944
+y Fj(Character)f(string,)h(read-only)-7 b(.)0 1105 y
+Fc(Class)31 b(Applicabilit)m(y:)259 1253 y(Ob)5 b(ject)427
+1353 y Fj(All)28 b(Ob)5 b(jects)28 b(ha)n(v)n(e)e(this)i(attribute.)p
+0 1564 V 0 1695 a FA(Clean)275 b Fd(Remo)m(v)m(e)38 b(cards)g(used)h
+(whilst)f(reading)f(ev)m(en)h(if)h(an)f(error)1701 1810
+y(o)s(ccurs?)3444 1695 y FA(Clean)0 1987 y Fc(Description:)44
+b Fj(This)27 b(attribute)f(indicates)g(whether)g(or)g(not)g(cards)f
+(should)i(b)r(e)f(remo)n(v)n(ed)f(from)h(the)h(FitsChan)f(if)h(an)227
+2087 y(error)g(o)r(ccurs)h(within)h(AST)p Ft(_)p Fj(READ.)g(A)g
(succesful)f(read)g(on)g(a)g(FitsChan)h(alw)n(a)n(ys)e(results)h(in)g
-(the)h(remo)n(v)-5 b(al)28 b(of)227 963 y(the)h(cards)e(whic)n(h)h(w)n
+(the)h(remo)n(v)-5 b(al)28 b(of)227 2186 y(the)h(cards)e(whic)n(h)h(w)n
(ere)f(in)n(v)n(olv)n(ed)f(in)i(the)h(description)e(of)h(the)h
(returned)e(Ob)5 b(ject.)38 b(Ho)n(w)n(ev)n(er,)26 b(in)j(the)f(ev)n
-(en)n(t)g(of)227 1063 y(an)j(error)e(during)h(the)h(read)g(\(for)f
+(en)n(t)g(of)227 2286 y(an)j(error)e(during)h(the)h(read)g(\(for)f
(instance)h(if)g(the)g(cards)f(in)h(the)h(FitsChan)f(ha)n(v)n(e)e
-(illegal)h(v)-5 b(alues,)32 b(or)e(if)h(some)227 1163
+(illegal)h(v)-5 b(alues,)32 b(or)e(if)h(some)227 2386
y(required)f(cards)f(are)h(missing\))g(no)g(cards)f(will)i(b)r(e)g
(remo)n(v)n(ed)e(from)h(the)h(FitsChan)f(if)h(the)g(Clean)f(attribute)h
-(is)227 1262 y(zero)c(\(the)h(default\).)37 b(If)28 b(Clean)f(is)h
+(is)227 2485 y(zero)c(\(the)h(default\).)37 b(If)28 b(Clean)f(is)h
(non-zero)e(then)i(an)n(y)e(cards)h(whic)n(h)g(w)n(ere)g(used)g(in)h
-(the)g(ab)r(orted)f(attempt)h(to)227 1362 y(read)f(an)g(ob)5
-b(ject)28 b(will)f(b)r(e)i(remo)n(v)n(ed.)227 1487 y(This)34
+(the)g(ab)r(orted)f(attempt)h(to)227 2585 y(read)f(an)g(ob)5
+b(ject)28 b(will)f(b)r(e)i(remo)n(v)n(ed.)227 2715 y(This)34
b(pro)n(vides)e(a)h(means)g(of)g Ft(")p Fj(cleaning)p
Ft(")f Fj(a)h(FitsChan)g(of)h(W)n(CS)f(related)g(cards)f(whic)n(h)i(w)n
-(orks)e(ev)n(en)h(in)g(the)227 1587 y(ev)n(en)n(t)27
+(orks)e(ev)n(en)h(in)g(the)227 2815 y(ev)n(en)n(t)27
b(of)h(the)g(cards)e(not)i(forming)f(a)g(legal)g(W)n(CS)h(description.)
-0 1737 y Fc(T)m(yp)s(e:)227 1837 y Fj(In)n(teger)f(\(b)r(o)r(olean\).)0
-1987 y Fc(Class)k(Applicabilit)m(y:)259 2124 y(FitsChan)427
-2224 y Fj(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)p
-0 2424 V 0 2556 a FA(Clip)641 2563 y Fd(Clip)38 b(lines)g(and/or)f
-(mark)m(ers)g(at)h(the)h(Plot)e(b)s(oundary?)3533 2556
-y FA(Clip)0 2759 y Fc(Description:)44 b Fj(This)33 b(attribute)h(con)n
+0 2976 y Fc(T)m(yp)s(e:)227 3076 y Fj(In)n(teger)f(\(b)r(o)r(olean\).)0
+3237 y Fc(Class)k(Applicabilit)m(y:)259 3385 y(FitsChan)427
+3484 y Fj(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)p
+0 3695 V 0 3827 a FA(Clip)641 3834 y Fd(Clip)38 b(lines)g(and/or)f
+(mark)m(ers)g(at)h(the)h(Plot)e(b)s(oundary?)3533 3827
+y FA(Clip)0 4041 y Fc(Description:)44 b Fj(This)33 b(attribute)h(con)n
(trols)d(whether)i(curv)n(es)f(and)h(mark)n(ers)e(are)h(clipp)r(ed)i
-(at)e(the)i(b)r(oundary)e(of)h(the)227 2859 y(graphics)22
+(at)e(the)i(b)r(oundary)e(of)h(the)227 4140 y(graphics)22
b(b)r(o)n(x)g(sp)r(eci\014ed)h(when)f(the)h(Plot)g(w)n(as)e(created.)35
b(A)23 b(v)-5 b(alue)22 b(of)h(3)f(implies)h(b)r(oth)g(mark)n(ers)e
-(and)h(curv)n(es)g(are)227 2958 y(clipp)r(ed)27 b(at)e(the)h(Plot)f(b)r
+(and)h(curv)n(es)g(are)227 4240 y(clipp)r(ed)27 b(at)e(the)h(Plot)f(b)r
(oundary)-7 b(.)36 b(A)26 b(v)-5 b(alue)25 b(of)h(2)f(implies)h(mark)n
(ers)d(are)i(clipp)r(ed,)h(but)h(not)e(curv)n(es.)35
-b(A)26 b(v)-5 b(alue)26 b(of)227 3058 y(1)j(implies)g(curv)n(es)e(are)h
+b(A)26 b(v)-5 b(alue)26 b(of)227 4339 y(1)j(implies)g(curv)n(es)e(are)h
(clipp)r(ed,)i(but)g(not)f(mark)n(ers.)38 b(A)30 b(v)-5
b(alue)28 b(of)h(zero)f(implies)h(neither)g(curv)n(es)f(nor)g(mark)n
-(ers)227 3158 y(are)35 b(clipp)r(ed.)63 b(The)36 b(default)h(v)-5
+(ers)227 4439 y(are)35 b(clipp)r(ed.)63 b(The)36 b(default)h(v)-5
b(alue)36 b(is)g(1.)62 b(Note,)38 b(this)e(attributes)g(con)n(trols)f
-(only)h(the)g(clipping)g(p)r(erformed)227 3257 y(in)n(ternally)e
+(only)h(the)g(clipping)g(p)r(erformed)227 4539 y(in)n(ternally)e
(within)h(AST.)f(The)g(underlying)g(graphics)f(system)h(ma)n(y)f(also)g
(apply)h(clipping.)57 b(In)34 b(suc)n(h)g(cases,)227
-3357 y(remo)n(ving)e(clipping)h(using)g(this)h(attribute)f(do)r(es)g
+4638 y(remo)n(ving)e(clipping)h(using)g(this)h(attribute)f(do)r(es)g
(not)h(guaran)n(tee)d(that)j(no)f(clipping)g(will)h(b)r(e)f(visible)h
-(in)f(the)227 3457 y(\014nal)28 b(plot.)227 3582 y(The)33
+(in)f(the)227 4738 y(\014nal)28 b(plot.)227 4868 y(The)33
b(AST)p Ft(_)p Fj(CLIP)e(routine)h(can)g(b)r(e)g(used)g(to)g(establish)
g(generalised)f(clipping)h(within)h(arbitrary)d(regions)h(of)227
-3681 y(the)d(Plot.)0 3832 y Fc(T)m(yp)s(e:)227 3931 y
-Fj(In)n(teger.)0 4082 y Fc(Class)j(Applicabilit)m(y:)259
-4219 y(Plot)427 4319 y Fj(All)d(Plots)f(ha)n(v)n(e)g(this)g(attribute.)
-p 0 4519 V 0 4651 a FA(ClipOp)175 b Fd(Com)m(bine)37
-b(Plot)g(clipping)g(limits)g(using)h(a)h(b)s(o)s(olean)e(OR?)175
-b FA(ClipOp)0 4845 y Fc(Description:)44 b Fj(This)27
-b(attribute)g(con)n(trols)e(ho)n(w)h(the)h(clipping)g(limits)g(sp)r
-(eci\014ed)g(for)g(eac)n(h)e(axis)h(of)h(a)f(Plot)h(\(using)f(the)227
-4945 y(AST)p Ft(_)p Fj(CLIP)j(routine\))g(are)f(com)n(bined.)41
-b(This,)30 b(in)f(turn,)h(determines)f(whic)n(h)g(parts)f(of)h(the)h
-(graphical)d(output)227 5044 y(will)h(b)r(e)g(visible.)227
-5169 y(If)f(the)g(ClipOp)f(attribute)h(of)g(a)f(Plot)g(is)g(zero)f
-(\(the)i(default\),)h(graphical)d(output)i(is)f(visible)g(only)h(if)g
-(it)f(satis\014es)227 5269 y(the)h(clipping)g(limits)g(on)f(all)g(the)h
-(axes)f(of)g(the)h(clipping)g(F)-7 b(rame)26 b(\(a)g(b)r(o)r(olean)g
-(AND\).)i(Otherwise,)e(if)h(ClipOp)g(is)227 5369 y(non-zero,)f(output)i
-(is)g(visible)f(if)h(it)g(satis\014es)f(the)h(clipping)g(limits)g(on)f
-(one)g(or)g(more)g(axes)g(\(a)g(b)r(o)r(olean)g(OR\).)227
-5494 y(An)g(imp)r(ortan)n(t)f(use)g(of)g(this)h(attribute)f(is)g(to)g
-(allo)n(w)f(areas)g(of)h(a)g(Plot)f(to)h(b)r(e)h(left)g(clear)e(\(e.g.)
-36 b(as)26 b(a)g(bac)n(kground)227 5593 y(for)c(some)f(text\).)36
+4968 y(the)d(Plot.)0 5129 y Fc(T)m(yp)s(e:)227 5229 y
+Fj(In)n(teger.)0 5390 y Fc(Class)j(Applicabilit)m(y:)259
+5538 y(Plot)427 5637 y Fj(All)d(Plots)f(ha)n(v)n(e)g(this)g(attribute.)
+p eop end
+%%Page: 426 436
+TeXDict begin 426 435 bop 0 52 a FG(426)1994 b Fz(C)91
+b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
+3780 12 v 0 483 a FA(ClipOp)175 b Fd(Com)m(bine)37 b(Plot)g(clipping)g
+(limits)g(using)h(a)h(b)s(o)s(olean)e(OR?)175 b FA(ClipOp)0
+682 y Fc(Description:)44 b Fj(This)27 b(attribute)g(con)n(trols)e(ho)n
+(w)h(the)h(clipping)g(limits)g(sp)r(eci\014ed)g(for)g(eac)n(h)e(axis)h
+(of)h(a)f(Plot)h(\(using)f(the)227 782 y(AST)p Ft(_)p
+Fj(CLIP)j(routine\))g(are)f(com)n(bined.)41 b(This,)30
+b(in)f(turn,)h(determines)f(whic)n(h)g(parts)f(of)h(the)h(graphical)d
+(output)227 881 y(will)h(b)r(e)g(visible.)227 1009 y(If)f(the)g(ClipOp)
+f(attribute)h(of)g(a)f(Plot)g(is)g(zero)f(\(the)i(default\),)h
+(graphical)d(output)i(is)f(visible)g(only)h(if)g(it)f(satis\014es)227
+1108 y(the)h(clipping)g(limits)g(on)f(all)g(the)h(axes)f(of)g(the)h
+(clipping)g(F)-7 b(rame)26 b(\(a)g(b)r(o)r(olean)g(AND\).)i(Otherwise,)
+e(if)h(ClipOp)g(is)227 1208 y(non-zero,)f(output)i(is)g(visible)f(if)h
+(it)g(satis\014es)f(the)h(clipping)g(limits)g(on)f(one)g(or)g(more)g
+(axes)g(\(a)g(b)r(o)r(olean)g(OR\).)227 1335 y(An)g(imp)r(ortan)n(t)f
+(use)g(of)g(this)h(attribute)f(is)g(to)g(allo)n(w)f(areas)g(of)h(a)g
+(Plot)f(to)h(b)r(e)h(left)g(clear)e(\(e.g.)36 b(as)26
+b(a)g(bac)n(kground)227 1435 y(for)c(some)f(text\).)36
b(T)-7 b(o)21 b(ac)n(hiev)n(e)g(this,)i(the)f(lo)n(w)n(er)f(and)g(upp)r
(er)i(clipping)f(b)r(ounds)g(supplied)g(to)g(AST)p Ft(_)p
-Fj(CLIP)f(should)227 5693 y(b)r(e)28 b(rev)n(ersed,)e(and)i(the)g
+Fj(CLIP)f(should)227 1535 y(b)r(e)28 b(rev)n(ersed,)e(and)i(the)g
(ClipOp)f(attribute)h(of)f(the)h(Plot)f(should)h(b)r(e)g(set)f(to)h(a)f
-(non-zero)f(v)-5 b(alue.)p eop end
-%%Page: 422 432
-TeXDict begin 422 431 bop 0 52 a FG(422)1994 b Fz(C)91
-b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)0 351 y
-Fc(T)m(yp)s(e:)227 451 y Fj(In)n(teger)c(\(b)r(o)r(olean\).)0
-604 y Fc(Class)k(Applicabilit)m(y:)259 744 y(Plot)427
-844 y Fj(All)d(Plots)f(ha)n(v)n(e)g(this)g(attribute.)p
-0 1047 3780 12 v 0 1179 a FA(Closed)176 b Fd(Should)38
-b(the)g(b)s(oundary)g(b)s(e)i(considered)e(to)g(b)s(e)h(inside)f(the)
-1706 1293 y(region?)3389 1179 y FA(Closed)0 1486 y Fc(Description:)44
+(non-zero)f(v)-5 b(alue.)0 1690 y Fc(T)m(yp)s(e:)227
+1789 y Fj(In)n(teger)27 b(\(b)r(o)r(olean\).)0 1944 y
+Fc(Class)k(Applicabilit)m(y:)259 2086 y(Plot)427 2186
+y Fj(All)d(Plots)f(ha)n(v)n(e)g(this)g(attribute.)p 0
+2391 V 0 2523 a FA(Closed)176 b Fd(Should)38 b(the)g(b)s(oundary)g(b)s
+(e)i(considered)e(to)g(b)s(e)h(inside)f(the)1706 2637
+y(region?)3389 2523 y FA(Closed)0 2832 y Fc(Description:)44
b Fj(This)28 b(attribute)g(con)n(trols)e(whether)i(p)r(oin)n(ts)f(on)g
(the)i(b)r(oundary)d(of)i(a)f(Region)g(are)g(considered)g(to)g(b)r(e)
-227 1586 y(inside)c(or)f(outside)h(the)g(region.)34 b(If)24
+227 2931 y(inside)c(or)f(outside)h(the)g(region.)34 b(If)24
b(the)f(attribute)g(v)-5 b(alue)23 b(is)f(non-zero)g(\(the)h
(default\),)i(p)r(oin)n(ts)e(on)f(the)h(b)r(oundary)227
-1685 y(are)29 b(considered)g(to)h(b)r(e)h(inside)f(the)g(region)f
+3031 y(are)29 b(considered)g(to)h(b)r(e)h(inside)f(the)g(region)f
(\(that)i(is,)f(the)h(Region)e(is)h Ft(")p Fj(closed)p
Ft(")p Fj(\).)43 b(Ho)n(w)n(ev)n(er,)28 b(if)j(the)f(attribute)227
-1785 y(v)-5 b(alue)28 b(is)f(zero,)g(p)r(oin)n(ts)g(on)h(the)g(b)r
+3130 y(v)-5 b(alue)28 b(is)f(zero,)g(p)r(oin)n(ts)g(on)h(the)g(b)r
(ounary)e(are)h(considered)f(to)i(b)r(e)g(outside)f(the)h(region.)0
-1938 y Fc(T)m(yp)s(e:)227 2038 y Fj(In)n(teger)f(\(b)r(o)r(olean\).)0
-2191 y Fc(Class)k(Applicabilit)m(y:)259 2331 y(Region)427
-2431 y Fj(All)d(Regions)f(ha)n(v)n(e)f(this)i(attribute.)259
-2566 y Fc(P)m(oin)m(tList)427 2665 y Fj(The)f(v)-5 b(alue)26
+3286 y Fc(T)m(yp)s(e:)227 3385 y Fj(In)n(teger)f(\(b)r(o)r(olean\).)0
+3540 y Fc(Class)k(Applicabilit)m(y:)259 3682 y(Region)427
+3782 y Fj(All)d(Regions)f(ha)n(v)n(e)f(this)i(attribute.)259
+3918 y Fc(P)m(oin)m(tList)427 4017 y Fj(The)f(v)-5 b(alue)26
b(of)g(the)h(Closed)e(attribute)i(is)f(ignored)f(b)n(y)h(P)n(oin)n
(tList)g(regions.)34 b(If)27 b(the)g(P)n(oin)n(tList)e(region)g(has)427
-2765 y(not)32 b(b)r(een)g(negated,)h(then)f(it)g(is)g(alw)n(a)n(ys)e
+4117 y(not)32 b(b)r(een)g(negated,)h(then)f(it)g(is)g(alw)n(a)n(ys)e
(assumed)h(to)g(b)r(e)i(closed.)48 b(If)33 b(the)f(P)n(oin)n(tList)e
-(region)h(has)g(b)r(een)427 2864 y(negated,)24 b(then)h(it)f(is)f(alw)n
+(region)h(has)g(b)r(een)427 4216 y(negated,)24 b(then)h(it)f(is)f(alw)n
(a)n(ys)f(assumed)h(to)h(b)r(e)g(op)r(en.)36 b(This)23
b(is)h(required)f(since)g(p)r(oin)n(ts)h(ha)n(v)n(e)f(zero)f(v)n(olume)
-427 2964 y(and)28 b(therefore)e(consist)h(en)n(tirely)g(of)h(b)r
-(oundary)-7 b(.)259 3099 y Fc(CmpRegion)427 3198 y Fj(The)27
+427 4316 y(and)28 b(therefore)e(consist)h(en)n(tirely)g(of)h(b)r
+(oundary)-7 b(.)259 4452 y Fc(CmpRegion)427 4551 y Fj(The)27
b(default)g(Closed)e(v)-5 b(alue)27 b(for)f(a)g(CmpRegion)g(is)g(the)h
(Closed)f(v)-5 b(alue)26 b(of)g(its)h(\014rst)f(comp)r(onen)n(t)g
-(Region.)259 3333 y Fc(Stc)427 3433 y Fj(The)i(default)g(Closed)f(v)-5
+(Region.)259 4687 y Fc(Stc)427 4787 y Fj(The)i(default)g(Closed)f(v)-5
b(alue)27 b(for)g(an)h(Stc)g(is)f(the)h(Closed)f(v)-5
-b(alue)28 b(of)f(its)h(encapsulated)f(Region.)p 0 3636
-V 0 3774 a FA(Colour\(elemen)l(t\))1294 3768 y Fd(Colour)37
-b(index)h(for)g(a)g(Plot)1693 3867 y(elemen)m(t)2819
-3774 y FA(Colour\(elemen)l(t\))0 4037 y Fc(Description:)44
+b(alue)28 b(of)f(its)h(encapsulated)f(Region.)p 0 4992
+V 0 5130 a FA(Colour\(elemen)l(t\))1294 5123 y Fd(Colour)37
+b(index)h(for)g(a)g(Plot)1693 5223 y(elemen)m(t)2819
+5130 y FA(Colour\(elemen)l(t\))0 5394 y Fc(Description:)44
b Fj(This)29 b(attribute)f(determines)g(the)h(colour)e(index)h(used)g
(when)g(dra)n(wing)f(eac)n(h)h(elemen)n(t)g(of)g(graphical)227
-4136 y(output)21 b(pro)r(duced)e(b)n(y)h(a)f(Plot.)34
+5494 y(output)21 b(pro)r(duced)e(b)n(y)h(a)f(Plot.)34
b(It)20 b(tak)n(es)f(a)g(separate)g(v)-5 b(alue)19 b(for)h(eac)n(h)f
(graphical)f(elemen)n(t)i(so)f(that,)j(for)d(instance,)227
-4236 y(the)25 b(setting)g Ft(")p Fj(Colour\(title\)=2)p
+5593 y(the)25 b(setting)g Ft(")p Fj(Colour\(title\)=2)p
Ft(")d Fj(causes)i(the)h(Plot)f(title)h(to)f(b)r(e)h(dra)n(wn)f(using)g
-(colour)f(index)i(2.)35 b(The)25 b(synon)n(ym)227 4335
-y Ft(")p Fj(Color)p Ft(")h Fj(ma)n(y)h(also)f(b)r(e)i(used.)227
-4462 y(The)d(range)f(of)h(in)n(teger)g(colour)f(indices)h(a)n(v)-5
+(colour)f(index)i(2.)35 b(The)25 b(synon)n(ym)227 5693
+y Ft(")p Fj(Color)p Ft(")h Fj(ma)n(y)h(also)f(b)r(e)i(used.)p
+eop end
+%%Page: 427 437
+TeXDict begin 427 436 bop 3643 52 a FG(427)227 351 y
+Fj(The)25 b(range)f(of)h(in)n(teger)g(colour)f(indices)h(a)n(v)-5
b(ailable)24 b(and)h(their)g(app)r(earance)e(is)i(determined)h(b)n(y)f
-(the)g(underlying)227 4561 y(graphics)g(system.)36 b(The)26
+(the)g(underlying)227 451 y(graphics)g(system.)36 b(The)26
b(default)h(b)r(eha)n(viour)e(is)h(for)f(all)h(graphical)e(elemen)n(ts)
-i(to)g(b)r(e)h(dra)n(wn)e(using)h(the)g(default)227 4661
+i(to)g(b)r(e)h(dra)n(wn)e(using)h(the)g(default)227 551
y(colour)e(index)g(supplied)h(b)n(y)f(this)h(graphics)e(system)i
(\(normally)-7 b(,)24 b(this)h(is)g(lik)n(ely)f(to)g(result)g(in)h
-(white)g(plotting)g(on)227 4761 y(a)i(blac)n(k)g(bac)n(kground,)f(or)h
-(vice)g(v)n(ersa\).)0 4914 y Fc(T)m(yp)s(e:)227 5014
-y Fj(In)n(teger.)0 5167 y Fc(Class)k(Applicabilit)m(y:)259
-5307 y(Plot)427 5407 y Fj(All)d(Plots)f(ha)n(v)n(e)g(this)g(attribute.)
-0 5572 y Fc(Notes:)p eop end
-%%Page: 423 433
-TeXDict begin 423 432 bop 3643 52 a FG(423)340 351 y
-Fi(\017)45 b Fj(F)-7 b(or)27 b(a)g(list)h(of)g(the)g(graphical)e
-(elemen)n(ts)h(a)n(v)-5 b(ailable,)27 b(see)g(the)h(description)f(of)g
-(the)h(Plot)f(class.)340 493 y Fi(\017)45 b Fj(If)31
-b(no)e(graphical)g(elemen)n(t)h(is)g(sp)r(eci\014ed,)h(\(e.g.)44
-b Ft(")p Fj(Colour)p Ft(")28 b Fj(instead)h(of)h Ft(")p
-Fj(Colour\(title\))p Ft(")p Fj(\),)g(then)h(a)e Ft(")p
-Fj(set)p Ft(")427 593 y Fj(or)d Ft(")p Fj(clear)p Ft(")f
-Fj(op)r(eration)h(will)g(a\013ect)h(the)g(attribute)g(v)-5
-b(alue)27 b(of)f(all)h(graphical)e(elemen)n(ts,)i(while)g(a)f
-Ft(")p Fj(get)p Ft(")f Fj(or)427 693 y Ft(")p Fj(test)p
-Ft(")i Fj(op)r(eration)g(will)h(use)f(just)h(the)g(Colour\(T)-7
-b(extLab\))27 b(v)-5 b(alue.)p 0 910 3780 12 v 0 1049
-a FA(ColumnLenC\(column\))1600 1042 y Fd(The)39 b(largest)1498
-1157 y(string)e(length)h(of)1530 1271 y(an)m(y)h(v)-7
-b(alue)38 b(in)h(a)1704 1386 y(column)2472 1049 y FA
-(ColumnLenC\(column\))0 1570 y Fc(Description:)44 b Fj(This)31
-b(attribute)f(holds)h(the)f(minim)n(um)i(length)e(whic)n(h)g(a)h(c)n
-(haracter)d(v)-5 b(ariable)29 b(m)n(ust)i(ha)n(v)n(e)e(in)i(order)227
-1669 y(to)i(b)r(e)g(able)f(to)g(store)g(the)h(longest)f(v)-5
+(white)g(plotting)g(on)227 650 y(a)i(blac)n(k)g(bac)n(kground,)f(or)h
+(vice)g(v)n(ersa\).)0 808 y Fc(T)m(yp)s(e:)227 908 y
+Fj(In)n(teger.)0 1065 y Fc(Class)k(Applicabilit)m(y:)259
+1210 y(Plot)427 1310 y Fj(All)d(Plots)f(ha)n(v)n(e)g(this)g(attribute.)
+0 1480 y Fc(Notes:)340 1771 y Fi(\017)45 b Fj(F)-7 b(or)27
+b(a)g(list)h(of)g(the)g(graphical)e(elemen)n(ts)h(a)n(v)-5
+b(ailable,)27 b(see)g(the)h(description)f(of)g(the)h(Plot)f(class.)340
+1908 y Fi(\017)45 b Fj(If)31 b(no)e(graphical)g(elemen)n(t)h(is)g(sp)r
+(eci\014ed,)h(\(e.g.)44 b Ft(")p Fj(Colour)p Ft(")28
+b Fj(instead)h(of)h Ft(")p Fj(Colour\(title\))p Ft(")p
+Fj(\),)g(then)h(a)e Ft(")p Fj(set)p Ft(")427 2007 y Fj(or)d
+Ft(")p Fj(clear)p Ft(")f Fj(op)r(eration)h(will)g(a\013ect)h(the)g
+(attribute)g(v)-5 b(alue)27 b(of)f(all)h(graphical)e(elemen)n(ts,)i
+(while)g(a)f Ft(")p Fj(get)p Ft(")f Fj(or)427 2107 y
+Ft(")p Fj(test)p Ft(")i Fj(op)r(eration)g(will)h(use)f(just)h(the)g
+(Colour\(T)-7 b(extLab\))27 b(v)-5 b(alue.)p 0 2314 3780
+12 v 0 2453 a FA(ColumnLenC\(column\))1600 2446 y Fd(The)39
+b(largest)1498 2561 y(string)e(length)h(of)1530 2675
+y(an)m(y)h(v)-7 b(alue)38 b(in)h(a)1704 2790 y(column)2472
+2453 y FA(ColumnLenC\(column\))0 2964 y Fc(Description:)44
+b Fj(This)31 b(attribute)f(holds)h(the)f(minim)n(um)i(length)e(whic)n
+(h)g(a)h(c)n(haracter)d(v)-5 b(ariable)29 b(m)n(ust)i(ha)n(v)n(e)e(in)i
+(order)227 3063 y(to)i(b)r(e)g(able)f(to)g(store)g(the)h(longest)f(v)-5
b(alue)32 b(curren)n(tly)g(presen)n(t)g(\(at)h(an)n(y)f(ro)n(w\))f(in)i
-(a)f(sp)r(eci\014ed)h(column)g(of)f(the)227 1769 y(supplied)23
+(a)f(sp)r(eci\014ed)h(column)g(of)f(the)227 3163 y(supplied)23
b(T)-7 b(able.)35 b(The)23 b(required)e(column)i(name)f(should)h(b)r(e)
g(placed)f(inside)g(the)h(paren)n(theses)f(in)g(the)h(attribute)227
-1869 y(name.)35 b(If)22 b(the)h(named)f(column)f(holds)h(v)n(ector)f(v)
+3262 y(name.)35 b(If)22 b(the)h(named)f(column)f(holds)h(v)n(ector)f(v)
-5 b(alues,)22 b(then)h(the)f(attribute)g(v)-5 b(alue)22
-b(is)g(the)g(length)g(of)g(the)g(longest)227 1968 y(elemen)n(t)28
-b(of)g(the)g(v)n(ector)e(v)-5 b(alue.)0 2136 y Fc(T)m(yp)s(e:)227
-2236 y Fj(In)n(teger,)27 b(read-only)-7 b(.)0 2404 y
-Fc(Class)31 b(Applicabilit)m(y:)259 2559 y(T)-8 b(able)427
-2658 y Fj(All)28 b(T)-7 b(ables)27 b(ha)n(v)n(e)g(this)h(attribute.)0
-2839 y Fc(Notes:)340 3140 y Fi(\017)45 b Fj(If)29 b(the)f(named)g
+b(is)g(the)g(length)g(of)g(the)g(longest)227 3362 y(elemen)n(t)28
+b(of)g(the)g(v)n(ector)e(v)-5 b(alue.)0 3520 y Fc(T)m(yp)s(e:)227
+3619 y Fj(In)n(teger,)27 b(read-only)-7 b(.)0 3777 y
+Fc(Class)31 b(Applicabilit)m(y:)259 3922 y(T)-8 b(able)427
+4022 y Fj(All)28 b(T)-7 b(ables)27 b(ha)n(v)n(e)g(this)h(attribute.)0
+4192 y Fc(Notes:)340 4483 y Fi(\017)45 b Fj(If)29 b(the)f(named)g
(column)g(holds)g(n)n(umerical)f(v)-5 b(alues,)28 b(the)h(length)f
(returned)g(is)g(the)g(length)g(of)g(the)h(largest)427
-3239 y(string)e(that)h(w)n(ould)f(b)r(e)h(generated)f(if)h(the)g
+4582 y(string)e(that)h(w)n(ould)f(b)r(e)h(generated)f(if)h(the)g
(column)f(v)-5 b(alues)28 b(w)n(ere)e(accessed)h(as)g(strings.)p
-0 3457 V 0 3595 a FA(ColumnLength\(column\))1576 3589
-y Fd(The)39 b(n)m(um)m(b)s(er)1603 3688 y(of)g(elemen)m(ts)1558
-3788 y(in)g(eac)m(h)f(v)-7 b(alue)1587 3888 y(in)39 b(a)f(column)2375
-3595 y FA(ColumnLength\(column\))0 4072 y Fc(Description:)44
+0 4790 V 0 4928 a FA(ColumnLength\(column\))1576 4921
+y Fd(The)39 b(n)m(um)m(b)s(er)1603 5021 y(of)g(elemen)m(ts)1558
+5121 y(in)g(eac)m(h)f(v)-7 b(alue)1587 5220 y(in)39 b(a)f(column)2375
+4928 y FA(ColumnLength\(column\))0 5394 y Fc(Description:)44
b Fj(This)37 b(attribute)f(holds)g(the)h(n)n(um)n(b)r(er)f(of)g(elemen)
n(ts)h(in)f(eac)n(h)g(v)-5 b(alue)36 b(stored)g(in)g(a)g(named)h
-(column.)227 4171 y(Eac)n(h)f(v)-5 b(alue)36 b(can)g(b)r(e)h(a)f
+(column.)227 5494 y(Eac)n(h)f(v)-5 b(alue)36 b(can)g(b)r(e)h(a)f
(scalar)f(\(in)i(whic)n(h)f(case)g(the)h(ColumnLength)f(attribute)h
-(has)f(a)g(v)-5 b(alue)36 b(of)h(1\),)h(or)e(a)227 4271
+(has)f(a)g(v)-5 b(alue)36 b(of)h(1\),)h(or)e(a)227 5593
y(m)n(ulti-dimensional)e(arra)n(y)d(\()k(in)f(whic)n(h)f(case)h(the)g
(ColumnLength)g(v)-5 b(alue)33 b(is)h(equal)f(to)h(the)h(pro)r(duct)e
-(of)h(the)227 4371 y(arra)n(y)26 b(dimensions\).)0 4538
-y Fc(T)m(yp)s(e:)227 4638 y Fj(In)n(teger,)h(read-only)-7
-b(.)0 4806 y Fc(Class)31 b(Applicabilit)m(y:)259 4961
-y(T)-8 b(able)427 5060 y Fj(All)28 b(T)-7 b(ables)27
-b(ha)n(v)n(e)g(this)h(attribute.)p 0 5278 V 0 5417 a
-FA(ColumnNdim\(column\))1509 5410 y Fd(The)39 b(n)m(um)m(b)s(er)f(of)
-1553 5510 y(axes)g(spanned)1477 5624 y(b)m(y)g(eac)m(h)h(v)-7
-b(alue)38 b(in)1656 5739 y(a)g(column)2456 5417 y FA
-(ColumnNdim\(column\))p eop end
-%%Page: 424 434
-TeXDict begin 424 433 bop 0 52 a FG(424)1994 b Fz(C)91
+(of)h(the)227 5693 y(arra)n(y)26 b(dimensions\).)p eop
+end
+%%Page: 428 438
+TeXDict begin 428 437 bop 0 52 a FG(428)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)0 351 y
-Fc(Description:)44 b Fj(This)30 b(attribute)f(holds)g(the)g(n)n(um)n(b)
-r(er)g(of)g(axes)g(spanned)f(b)n(y)h(eac)n(h)g(v)-5 b(alue)29
-b(in)g(a)g(column.)42 b(If)29 b(eac)n(h)g(cell)227 451
-y(in)g(the)h(column)f(is)f(a)h(scalar,)e(ColumnNdim)j(will)f(b)r(e)g
-(zero.)40 b(If)29 b(eac)n(h)f(cell)h(in)g(the)g(column)g(is)g(a)g(1D)f
-(sp)r(ectrum,)227 551 y(ColumnNdim)g(will)g(b)r(e)f(one.)37
+Fc(T)m(yp)s(e:)227 451 y Fj(In)n(teger,)c(read-only)-7
+b(.)0 597 y Fc(Class)31 b(Applicabilit)m(y:)259 731 y(T)-8
+b(able)427 831 y Fj(All)28 b(T)-7 b(ables)27 b(ha)n(v)n(e)g(this)h
+(attribute.)p 0 1024 3780 12 v 0 1163 a FA(ColumnNdim\(column\))1509
+1156 y Fd(The)39 b(n)m(um)m(b)s(er)f(of)1553 1256 y(axes)g(spanned)1477
+1370 y(b)m(y)g(eac)m(h)h(v)-7 b(alue)38 b(in)1656 1485
+y(a)g(column)2456 1163 y FA(ColumnNdim\(column\))0 1645
+y Fc(Description:)44 b Fj(This)30 b(attribute)f(holds)g(the)g(n)n(um)n
+(b)r(er)g(of)g(axes)g(spanned)f(b)n(y)h(eac)n(h)g(v)-5
+b(alue)29 b(in)g(a)g(column.)42 b(If)29 b(eac)n(h)g(cell)227
+1744 y(in)g(the)h(column)f(is)f(a)h(scalar,)e(ColumnNdim)j(will)f(b)r
+(e)g(zero.)40 b(If)29 b(eac)n(h)f(cell)h(in)g(the)g(column)g(is)g(a)g
+(1D)f(sp)r(ectrum,)227 1844 y(ColumnNdim)g(will)g(b)r(e)f(one.)37
b(If)27 b(eac)n(h)g(cell)g(in)h(the)f(column)h(is)f(a)g(2D)g(image,)g
-(ColumnNdim)h(will)f(b)r(e)h(t)n(w)n(o,)e(etc.)227 650
+(ColumnNdim)h(will)f(b)r(e)h(t)n(w)n(o,)e(etc.)227 1944
y(The)i(required)f(column)g(name)h(should)f(b)r(e)h(placed)f(inside)h
(the)g(paren)n(theses)e(in)i(the)g(attribute)g(name.)0
-822 y Fc(T)m(yp)s(e:)227 922 y Fj(In)n(teger,)f(read-only)-7
-b(.)0 1094 y Fc(Class)31 b(Applicabilit)m(y:)259 1252
-y(T)-8 b(able)427 1352 y Fj(All)28 b(T)-7 b(ables)27
-b(ha)n(v)n(e)g(this)h(attribute.)p 0 1574 3780 12 v 0
-1712 a FA(ColumnT)l(yp)t(e\(column\))1457 1705 y Fd(The)39
-b(data)f(t)m(yp)s(e)g(of)1509 1820 y(eac)m(h)h(v)-7 b(alue)38
-b(in)h(a)1704 1920 y(column)2485 1712 y FA(ColumnT)l(yp)t(e\(column\))0
-2108 y Fc(Description:)44 b Fj(This)21 b(attribute)g(holds)g(a)f(in)n
+2090 y Fc(T)m(yp)s(e:)227 2190 y Fj(In)n(teger,)f(read-only)-7
+b(.)0 2336 y Fc(Class)31 b(Applicabilit)m(y:)259 2470
+y(T)-8 b(able)427 2570 y Fj(All)28 b(T)-7 b(ables)27
+b(ha)n(v)n(e)g(this)h(attribute.)p 0 2763 V 0 2902 a
+FA(ColumnT)l(yp)t(e\(column\))1457 2895 y Fd(The)39 b(data)f(t)m(yp)s
+(e)g(of)1509 3009 y(eac)m(h)h(v)-7 b(alue)38 b(in)h(a)1704
+3109 y(column)2485 2902 y FA(ColumnT)l(yp)t(e\(column\))0
+3269 y Fc(Description:)44 b Fj(This)21 b(attribute)g(holds)g(a)f(in)n
(teger)g(v)-5 b(alue)21 b(indicating)g(the)g(data)g(t)n(yp)r(e)g(of)g
-(a)f(named)h(column)g(in)g(a)g(T)-7 b(able.)227 2207
+(a)f(named)h(column)g(in)g(a)g(T)-7 b(able.)227 3369
y(This)20 b(is)f(the)g(data)g(t)n(yp)r(e)h(whic)n(h)f(w)n(as)f(used)i
(when)f(the)h(column)f(w)n(as)f(added)i(to)f(the)g(T)-7
-b(able)19 b(using)g(astAddColumn.)227 2307 y(The)28 b(required)f
+b(able)19 b(using)g(astAddColumn.)227 3468 y(The)28 b(required)f
(column)g(name)h(should)f(b)r(e)h(placed)f(inside)h(the)g(paren)n
-(theses)e(in)i(the)g(attribute)g(name.)227 2443 y(The)19
+(theses)e(in)i(the)g(attribute)g(name.)227 3591 y(The)19
b(attribute)f(v)-5 b(alue)18 b(will)h(b)r(e)g(one)f(of)g(AST)p
Ft(__)p Fj(INTTYPE)g(\(for)g(in)n(teger\),)h(AST)p Ft(__)p
Fj(SINTTYPE)f(\(for)g(INTEGER)p Fi(\003)p Fj(2\),)227
-2542 y(AST)p Ft(__)p Fj(BYTETYPE)f(\(for)h(b)n(ytes\),)i(AST)p
+3691 y(AST)p Ft(__)p Fj(BYTETYPE)f(\(for)h(b)n(ytes\),)i(AST)p
Ft(__)p Fj(DOUBLETYPE)d(\(for)h(double)g(precision)g(\015oating)f(p)r
(oin)n(t\),)k(AST)p Ft(__)p Fj(FLO)n(A)-7 b(TTYPE)227
-2642 y(\(for)18 b(single)g(precision)g(\015oating)f(p)r(oin)n(t\),)k
+3791 y(\(for)18 b(single)g(precision)g(\015oating)f(p)r(oin)n(t\),)k
(AST)p Ft(__)p Fj(STRINGTYPE)d(\(for)g(c)n(haracter)e(string\),)k(AST)p
-Ft(__)p Fj(OBJECTTYPE)227 2742 y(\(for)e(AST)h(Ob)5 b(ject)18
+Ft(__)p Fj(OBJECTTYPE)227 3890 y(\(for)e(AST)h(Ob)5 b(ject)18
b(p)r(oin)n(ter\),)j(AST)p Ft(__)p Fj(POINTER)-7 b(TYPE)16
b(\(for)i(arbitrary)e(C)j(p)r(oin)n(ter\))f(or)f(AST)p
-Ft(__)p Fj(UNDEFTYPE)227 2841 y(\(for)28 b(unde\014ned)g(v)-5
+Ft(__)p Fj(UNDEFTYPE)227 3990 y(\(for)28 b(unde\014ned)g(v)-5
b(alues)27 b(created)g(b)n(y)g(AST)p Ft(_)p Fj(MAPPUTU\).)0
-3013 y Fc(T)m(yp)s(e:)227 3113 y Fj(In)n(teger,)g(read-only)-7
-b(.)0 3285 y Fc(Class)31 b(Applicabilit)m(y:)259 3443
-y(T)-8 b(able)427 3543 y Fj(All)28 b(T)-7 b(ables)27
-b(ha)n(v)n(e)g(this)h(attribute.)p 0 3765 V 0 3895 a
-FA(Commen)l(t)940 3896 y Fd(Include)39 b(textual)e(commen)m(ts)g(in)i
-(output?)3206 3895 y FA(Commen)l(t)0 4108 y Fc(Description:)44
+4137 y Fc(T)m(yp)s(e:)227 4236 y Fj(In)n(teger,)g(read-only)-7
+b(.)0 4383 y Fc(Class)31 b(Applicabilit)m(y:)259 4516
+y(T)-8 b(able)427 4616 y Fj(All)28 b(T)-7 b(ables)27
+b(ha)n(v)n(e)g(this)h(attribute.)p 0 4810 V 0 4940 a
+FA(Commen)l(t)940 4941 y Fd(Include)39 b(textual)e(commen)m(ts)g(in)i
+(output?)3206 4940 y FA(Commen)l(t)0 5124 y Fc(Description:)44
b Fj(This)30 b(is)f(a)h(b)r(o)r(olean)f(attribute)g(whic)n(h)h(con)n
(trols)e(whether)h(textual)h(commen)n(ts)f(are)g(to)g(b)r(e)h(included)
-227 4207 y(in)j(the)g(output)g(generated)f(b)n(y)g(a)g(Channel.)52
+227 5224 y(in)j(the)g(output)g(generated)f(b)n(y)g(a)g(Channel.)52
b(If)33 b(included,)i(they)e(will)g(describ)r(e)f(what)g(eac)n(h)g
-(item)h(of)g(output)227 4307 y(represen)n(ts.)227 4443
+(item)h(of)g(output)227 5324 y(represen)n(ts.)227 5447
y(If)28 b(Commen)n(t)g(is)f(non-zero,)f(then)i(commen)n(ts)g(will)f(b)r
(e)h(included.)38 b(If)28 b(it)g(is)f(zero,)g(commen)n(ts)g(will)h(b)r
-(e)g(omitted.)0 4615 y Fc(T)m(yp)s(e:)227 4714 y Fj(In)n(teger)f(\(b)r
-(o)r(olean\).)0 4886 y Fc(Class)k(Applicabilit)m(y:)259
-5045 y(Channel)427 5145 y Fj(The)d(default)g(v)-5 b(alue)27
-b(is)h(non-zero)e(for)h(a)g(normal)g(Channel.)259 5289
-y Fc(FitsChan)427 5388 y Fj(The)h(default)g(v)-5 b(alue)27
-b(is)h(non-zero)e(for)h(a)g(FitsChan.)259 5532 y Fc(XmlChan)427
-5632 y Fj(The)h(default)g(v)-5 b(alue)27 b(is)h(zero)e(for)i(an)f
-(XmlChan.)p eop end
-%%Page: 425 435
-TeXDict begin 425 434 bop 3643 52 a FG(425)p 0 351 3780
-12 v 0 482 a FA(Curren)l(t)1108 483 y Fd(F)-10 b(rameSet)38
-b(curren)m(t)f(F)-10 b(rame)38 b(index)3313 482 y FA(Curren)l(t)0
-658 y Fc(Description:)44 b Fj(This)38 b(attribute)g(giv)n(es)f(the)h
-(index)g(of)g(the)g(F)-7 b(rame)37 b(whic)n(h)h(is)g(to)g(b)r(e)g
-(regarded)e(as)h(the)h Ft(")p Fj(curren)n(t)p Ft(")227
-758 y Fj(F)-7 b(rame)37 b(within)g(a)g(F)-7 b(rameSet.)65
-b(The)37 b(default)g(is)g(the)h(most)e(recen)n(t)h(F)-7
-b(rame)36 b(added)h(to)g(the)g(F)-7 b(rameSet)37 b(\(this)227
-858 y(F)-7 b(rame)27 b(alw)n(a)n(ys)f(has)h(an)g(index)h(equal)f(to)h
-(the)g(F)-7 b(rameSet's)27 b(Nframe)g(attribute\).)0
-1017 y Fc(T)m(yp)s(e:)227 1117 y Fj(In)n(teger.)0 1276
-y Fc(Class)k(Applicabilit)m(y:)259 1422 y(F)-8 b(rameSet)427
-1522 y Fj(All)28 b(F)-7 b(rameSets)27 b(ha)n(v)n(e)g(this)h(attribute.)
-0 1694 y Fc(Notes:)340 1986 y Fi(\017)45 b Fj(In)n(v)n(erting)17
-b(a)h(F)-7 b(rameSet)19 b(\(in)n(v)n(erting)e(the)i(b)r(o)r(olean)f
-(sense)f(of)i(its)f(In)n(v)n(ert)g(attribute,)i(with)f(the)g(AST)p
-Ft(_)p Fj(INVER)-7 b(T)427 2086 y(routine)27 b(for)h(example\))f(will)h
+(e)g(omitted.)0 5593 y Fc(T)m(yp)s(e:)227 5693 y Fj(In)n(teger)f(\(b)r
+(o)r(olean\).)p eop end
+%%Page: 429 439
+TeXDict begin 429 438 bop 3643 52 a FG(429)0 351 y Fc(Class)31
+b(Applicabilit)m(y:)259 485 y(Channel)427 585 y Fj(The)d(default)g(v)-5
+b(alue)27 b(is)h(non-zero)e(for)h(a)g(normal)g(Channel.)259
+715 y Fc(FitsChan)427 815 y Fj(The)h(default)g(v)-5 b(alue)27
+b(is)h(non-zero)e(for)h(a)g(FitsChan.)259 946 y Fc(XmlChan)427
+1045 y Fj(The)h(default)g(v)-5 b(alue)27 b(is)h(zero)e(for)i(an)f
+(XmlChan.)p 0 1240 3780 12 v 0 1371 a FA(Curren)l(t)642
+b Fd(F)-10 b(rameSet)38 b(curren)m(t)f(F)-10 b(rame)38
+b(index)641 b FA(Curren)l(t)0 1532 y Fc(Description:)44
+b Fj(This)38 b(attribute)g(giv)n(es)f(the)h(index)g(of)g(the)g(F)-7
+b(rame)37 b(whic)n(h)h(is)g(to)g(b)r(e)g(regarded)e(as)h(the)h
+Ft(")p Fj(curren)n(t)p Ft(")227 1632 y Fj(F)-7 b(rame)37
+b(within)g(a)g(F)-7 b(rameSet.)65 b(The)37 b(default)g(is)g(the)h(most)
+e(recen)n(t)h(F)-7 b(rame)36 b(added)h(to)g(the)g(F)-7
+b(rameSet)37 b(\(this)227 1732 y(F)-7 b(rame)27 b(alw)n(a)n(ys)f(has)h
+(an)g(index)h(equal)f(to)h(the)g(F)-7 b(rameSet's)27
+b(Nframe)g(attribute\).)0 1879 y Fc(T)m(yp)s(e:)227 1978
+y Fj(In)n(teger.)0 2126 y Fc(Class)k(Applicabilit)m(y:)259
+2260 y(F)-8 b(rameSet)427 2359 y Fj(All)28 b(F)-7 b(rameSets)27
+b(ha)n(v)n(e)g(this)h(attribute.)0 2519 y Fc(Notes:)340
+2799 y Fi(\017)45 b Fj(In)n(v)n(erting)17 b(a)h(F)-7
+b(rameSet)19 b(\(in)n(v)n(erting)e(the)i(b)r(o)r(olean)f(sense)f(of)i
+(its)f(In)n(v)n(ert)g(attribute,)i(with)f(the)g(AST)p
+Ft(_)p Fj(INVER)-7 b(T)427 2899 y(routine)27 b(for)h(example\))f(will)h
(in)n(terc)n(hange)e(the)i(v)-5 b(alues)27 b(of)h(its)f(Base)g(and)g
-(Curren)n(t)g(attributes.)p 0 2295 V 0 2426 a FA(DSBCen)l(tre)849
-2427 y Fd(The)38 b(cen)m(tral)f(p)s(osition)g(of)i(in)m(terest)e(in)h
-(a)h(dual)1409 2541 y(sideband)g(sp)s(ectrum)3108 2426
-y FA(DSBCen)l(tre)0 2740 y Fc(Description:)44 b Fj(This)31
+(Curren)n(t)g(attributes.)p 0 3093 V 0 3224 a FA(DSBCen)l(tre)849
+3225 y Fd(The)38 b(cen)m(tral)f(p)s(osition)g(of)i(in)m(terest)e(in)h
+(a)h(dual)1409 3339 y(sideband)g(sp)s(ectrum)3108 3224
+y FA(DSBCen)l(tre)0 3524 y Fc(Description:)44 b Fj(This)31
b(attribute)h(sp)r(eci\014es)e(the)i(cen)n(tral)e(p)r(osition)h(of)g
(in)n(terest)f(in)i(a)e(dual)h(sideband)g(sp)r(ectrum.)48
-b(Its)227 2840 y(sole)33 b(use)g(is)g(to)g(determine)g(the)h(lo)r(cal)e
+b(Its)227 3623 y(sole)33 b(use)g(is)g(to)g(determine)g(the)h(lo)r(cal)e
(oscillator)g(frequency)g(\(the)i(frequency)f(whic)n(h)g(marks)f(the)h
-(b)r(oundary)227 2939 y(b)r(et)n(w)n(een)f(the)h(lo)n(w)n(er)e(and)h
+(b)r(oundary)227 3723 y(b)r(et)n(w)n(een)f(the)h(lo)n(w)n(er)e(and)h
(upp)r(er)g(sidebands\).)50 b(See)32 b(the)h(description)f(of)g(the)g
-(IF)h(\(in)n(termediate)f(frequency\))227 3039 y(attribute)21
+(IF)h(\(in)n(termediate)f(frequency\))227 3822 y(attribute)21
b(for)g(details)f(of)h(ho)n(w)f(the)h(lo)r(cal)g(oscillator)e
(frequency)h(is)h(calculated.)34 b(The)21 b(sideband)f(con)n(taining)g
-(this)227 3139 y(cen)n(tral)28 b(p)r(osition)g(is)g(referred)g(to)g(as)
+(this)227 3922 y(cen)n(tral)28 b(p)r(osition)g(is)g(referred)g(to)g(as)
g(the)h Ft(")p Fj(observ)n(ed)p Ft(")d Fj(sideband,)i(and)h(the)f
(other)g(sideband)h(as)e(the)i Ft(")p Fj(image)p Ft(")227
-3238 y Fj(sideband.)227 3368 y(The)c(v)-5 b(alue)25 b(is)g(accessed)f
+4022 y Fj(sideband.)227 4145 y(The)c(v)-5 b(alue)25 b(is)g(accessed)f
(as)g(a)h(p)r(osition)g(in)g(the)h(sp)r(ectral)e(system)h(represen)n
(ted)f(b)n(y)g(the)i(Sp)r(ecF)-7 b(rame)25 b(attributes)227
-3467 y(inherited)40 b(b)n(y)f(this)h(class,)h(but)f(is)f(stored)g(in)n
+4245 y(inherited)40 b(b)n(y)f(this)h(class,)h(but)f(is)f(stored)g(in)n
(ternally)f(as)h(top)r(o)r(cen)n(tric)g(frequency)-7
-b(.)72 b(Th)n(us,)42 b(if)e(the)f(System)227 3567 y(attribute)30
+b(.)72 b(Th)n(us,)42 b(if)e(the)f(System)227 4344 y(attribute)30
b(of)g(the)h(DSBSp)r(ecF)-7 b(rame)30 b(is)g(set)g(to)g
Ft(")p Fj(VRAD)p Ft(")p Fj(,)h(the)f(Unit)h(attribute)f(set)g(to)g
-Ft(")p Fj(m/s)p Ft(")f Fj(and)h(the)g(Std-)227 3667 y(OfRest)i
+Ft(")p Fj(m/s)p Ft(")f Fj(and)h(the)g(Std-)227 4444 y(OfRest)i
(attribute)f(set)h(to)f Ft(")p Fj(LSRK)p Ft(")p Fj(,)g(then)h(v)-5
b(alues)31 b(for)g(the)h(DSBCen)n(tre)f(attribute)h(should)f(b)r(e)h
-(supplied)f(as)227 3766 y(radio)e(v)n(elo)r(cit)n(y)h(in)g(units)h(of)f
+(supplied)f(as)227 4544 y(radio)e(v)n(elo)r(cit)n(y)h(in)g(units)h(of)f
Ft(")p Fj(m/s)p Ft(")f Fj(relativ)n(e)g(to)h(the)h(kinematic)f(LSR)h
(\(alternativ)n(e)e(units)h(ma)n(y)g(b)r(e)h(used)f(b)n(y)227
-3866 y(app)r(ending)24 b(a)g(suitable)g(units)g(string)f(to)h(the)g
+4643 y(app)r(ending)24 b(a)g(suitable)g(units)g(string)f(to)h(the)g
(end)h(of)e(the)i(v)-5 b(alue\).)36 b(This)23 b(v)-5
b(alue)24 b(is)g(then)h(con)n(v)n(erted)d(to)i(top)r(o)r(cen-)227
-3965 y(tric)33 b(frequency)f(and)h(stored.)51 b(If)33
+4743 y(tric)33 b(frequency)f(and)h(stored.)51 b(If)33
b(\(sa)n(y\))g(the)g(Unit)g(attribute)g(is)g(subsequen)n(tly)f(c)n
(hanged)g(to)h Ft(")p Fj(km/s)p Ft(")e Fj(b)r(efore)227
-4065 y(retrieving)e(the)i(curren)n(t)e(v)-5 b(alue)30
+4842 y(retrieving)e(the)i(curren)n(t)e(v)-5 b(alue)30
b(of)g(the)g(DSBCen)n(tre)g(attribute,)h(the)f(stored)g(top)r(o)r(cen)n
-(tric)f(frequency)h(will)g(b)r(e)227 4165 y(con)n(v)n(erted)c(bac)n(k)h
+(tric)f(frequency)h(will)g(b)r(e)227 4942 y(con)n(v)n(erted)c(bac)n(k)h
(to)h(LSRK)f(radio)f(v)n(elo)r(cit)n(y)-7 b(,)27 b(this)h(time)g(in)g
(units)g(of)g Ft(")p Fj(km/s)p Ft(")p Fj(,)e(b)r(efore)h(b)r(eing)h
-(returned.)227 4294 y(The)g(default)g(v)-5 b(alue)27
-b(for)h(this)f(attribute)h(is)g(30)e(GHz.)0 4454 y Fc(T)m(yp)s(e:)227
-4553 y Fj(Floating)h(p)r(oin)n(t.)0 4713 y Fc(Class)k(Applicabilit)m
-(y:)259 4859 y(DSBSp)s(ecF)-8 b(rame)427 4959 y Fj(All)28
-b(DSBSp)r(ecF)-7 b(rames)28 b(ha)n(v)n(e)e(this)i(attribute.)-2
-5130 y Fc(Note)n(:)340 5423 y Fi(\017)45 b Fj(The)32
-b(attributes)g(whic)n(h)g(de\014ne)g(the)g(transformation)e(to)i(or)f
-(from)h(top)r(o)r(cen)n(tric)f(frequency)h(should)f(b)r(e)427
-5522 y(assigned)19 b(their)h(correct)f(v)-5 b(alues)20
-b(b)r(efore)g(accessing)e(this)j(attribute.)34 b(These)20
-b(p)r(oten)n(tially)g(include)g(System,)427 5622 y(Unit,)29
-b(StdOfRest,)f(ObsLon,)f(ObsLat,)g(ObsAlt,)g(Ep)r(o)r(c)n(h,)h(RefRA,)g
-(RefDec)g(and)g(RestF)-7 b(req.)p eop end
-%%Page: 426 436
-TeXDict begin 426 435 bop 0 52 a FG(426)1994 b Fz(C)91
-b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
-3780 12 v 0 483 a FA(DefB1950)598 b Fd(Use)39 b(FK4)g(B1950)e(as)i
-(defaults?)595 b FA(DefB1950)0 697 y Fc(Description:)44
+(returned.)227 5065 y(The)g(default)g(v)-5 b(alue)27
+b(for)h(this)f(attribute)h(is)g(30)e(GHz.)0 5213 y Fc(T)m(yp)s(e:)227
+5312 y Fj(Floating)h(p)r(oin)n(t.)0 5459 y Fc(Class)k(Applicabilit)m
+(y:)259 5593 y(DSBSp)s(ecF)-8 b(rame)427 5693 y Fj(All)28
+b(DSBSp)r(ecF)-7 b(rames)28 b(ha)n(v)n(e)e(this)i(attribute.)p
+eop end
+%%Page: 430 440
+TeXDict begin 430 439 bop 0 52 a FG(430)1994 b Fz(C)91
+b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)-2 351 y
+Fc(Note)n(:)340 627 y Fi(\017)45 b Fj(The)32 b(attributes)g(whic)n(h)g
+(de\014ne)g(the)g(transformation)e(to)i(or)f(from)h(top)r(o)r(cen)n
+(tric)f(frequency)h(should)f(b)r(e)427 727 y(assigned)19
+b(their)h(correct)f(v)-5 b(alues)20 b(b)r(efore)g(accessing)e(this)j
+(attribute.)34 b(These)20 b(p)r(oten)n(tially)g(include)g(System,)427
+827 y(Unit,)29 b(StdOfRest,)f(ObsLon,)f(ObsLat,)g(ObsAlt,)g(Ep)r(o)r(c)
+n(h,)h(RefRA,)g(RefDec)g(and)g(RestF)-7 b(req.)p 0 1013
+3780 12 v 0 1145 a FA(DefB1950)598 b Fd(Use)39 b(FK4)g(B1950)e(as)i
+(defaults?)595 b FA(DefB1950)0 1298 y Fc(Description:)44
b Fj(This)34 b(attribute)g(is)g(a)f(b)r(o)r(olean)h(v)-5
b(alue)33 b(whic)n(h)h(sp)r(eci\014es)g(a)f(default)h(equino)n(x)f(and)
-h(reference)f(frame)227 797 y(to)d(use)g(when)g(reading)f(a)h(F)-7
+h(reference)f(frame)227 1398 y(to)d(use)g(when)g(reading)f(a)h(F)-7
b(rameSet)30 b(from)f(a)h(FitsChan)g(with)h(a)e(foreign)h(\(i.e.)44
b(non-nativ)n(e\))29 b(enco)r(ding.)44 b(It)31 b(is)227
-896 y(only)g(used)f(if)i(the)f(FITS)g(header)f(con)n(tains)g(RA)h(and)g
-(DEC)g(axes)f(but)h(con)n(tains)f(no)g(information)g(ab)r(out)h(the)227
-996 y(reference)f(frame)g(or)g(equino)n(x.)46 b(If)31
+1497 y(only)g(used)f(if)i(the)f(FITS)g(header)f(con)n(tains)g(RA)h(and)
+g(DEC)g(axes)f(but)h(con)n(tains)f(no)g(information)g(ab)r(out)h(the)
+227 1597 y(reference)f(frame)g(or)g(equino)n(x.)46 b(If)31
b(this)g(is)g(the)g(case,)f(then)i(v)-5 b(alues)30 b(of)h(FK4)f(and)g
-(B1950)f(are)h(assumed)g(if)h(the)227 1096 y(DefB1950)g(attribute)i
+(B1950)f(are)h(assumed)g(if)h(the)227 1697 y(DefB1950)g(attribute)i
(has)f(a)g(non-zero)f(v)-5 b(alue)33 b(and)f(ICRS)h(is)f(assumed)g(if)h
-(DefB1950)e(is)i(zero.)51 b(The)32 b(default)227 1195
+(DefB1950)e(is)i(zero.)51 b(The)32 b(default)227 1796
y(v)-5 b(alue)29 b(for)g(DefB1950)f(dep)r(ends)i(on)f(the)g(v)-5
b(alue)29 b(of)h(the)f(Enco)r(ding)g(attribute:)40 b(for)29
-b(FITS-W)n(CS)g(enco)r(ding)g(the)227 1295 y(default)f(is)g(zero,)e
+b(FITS-W)n(CS)g(enco)r(ding)g(the)227 1896 y(default)f(is)g(zero,)e
(and)i(for)f(all)g(other)g(enco)r(dings)g(it)h(is)g(one.)0
-1493 y Fc(T)m(yp)s(e:)227 1592 y Fj(In)n(teger)f(\(b)r(o)r(olean\).)0
-1791 y Fc(Class)k(Applicabilit)m(y:)259 1975 y(FitsChan)427
-2075 y Fj(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)p
-0 2323 V 0 2461 a FA(Digits/Digits\(axis\))1390 2455
-y Fd(Num)m(b)s(er)38 b(of)h(digits)e(of)1665 2566 y(precision)2680
-2461 y FA(Digits/Digits\(axis\))0 2803 y Fc(Description:)44
+2039 y Fc(T)m(yp)s(e:)227 2139 y Fj(In)n(teger)f(\(b)r(o)r(olean\).)0
+2282 y Fc(Class)k(Applicabilit)m(y:)259 2412 y(FitsChan)427
+2512 y Fj(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)p
+0 2698 V 0 2837 a FA(Digits/Digits\(axis\))1390 2830
+y Fd(Num)m(b)s(er)38 b(of)h(digits)e(of)1665 2941 y(precision)2680
+2837 y FA(Digits/Digits\(axis\))0 3117 y Fc(Description:)44
b Fj(This)26 b(attribute)g(sp)r(eci\014es)f(ho)n(w)g(man)n(y)g(digits)h
(of)f(precision)g(are)f(required)h(b)n(y)g(default)h(when)g(a)f(co)r
-(or-)227 2903 y(dinate)g(v)-5 b(alue)24 b(is)h(formatted)f(for)g(a)g(F)
+(or-)227 3217 y(dinate)g(v)-5 b(alue)24 b(is)h(formatted)f(for)g(a)g(F)
-7 b(rame)24 b(axis)g(\(e.g.)35 b(using)25 b(AST)p Ft(_)p
Fj(F)n(ORMA)-7 b(T\).)24 b(Its)h(v)-5 b(alue)24 b(ma)n(y)g(b)r(e)h(set)
-g(either)227 3002 y(for)33 b(a)f(F)-7 b(rame)32 b(as)g(a)h(whole,)h(or)
+g(either)227 3316 y(for)33 b(a)f(F)-7 b(rame)32 b(as)g(a)h(whole,)h(or)
e(\(b)n(y)g(subscripting)h(the)g(attribute)g(name)f(with)i(the)f(n)n
-(um)n(b)r(er)g(of)f(an)h(axis\))f(for)227 3102 y(eac)n(h)d(axis)g
+(um)n(b)r(er)g(of)f(an)h(axis\))f(for)227 3416 y(eac)n(h)d(axis)g
(individually)-7 b(.)43 b(An)n(y)30 b(v)-5 b(alue)29
b(set)h(for)f(an)g(individual)h(axis)f(will)g(o)n(v)n(er-ride)f(the)i
-(v)-5 b(alue)29 b(for)g(the)h(F)-7 b(rame)227 3201 y(as)27
-b(a)g(whole.)227 3350 y(Note)g(that)f(the)h(Digits)g(v)-5
+(v)-5 b(alue)29 b(for)g(the)h(F)-7 b(rame)227 3516 y(as)27
+b(a)g(whole.)227 3637 y(Note)g(that)f(the)h(Digits)g(v)-5
b(alue)26 b(acts)g(only)g(as)g(a)g(means)g(of)g(determining)g(a)g
(default)h(F)-7 b(ormat)26 b(string.)36 b(Its)26 b(e\013ects)227
-3450 y(are)32 b(o)n(v)n(er-ridden)f(if)i(a)g(F)-7 b(ormat)32
+3737 y(are)32 b(o)n(v)n(er-ridden)f(if)i(a)g(F)-7 b(ormat)32
b(string)g(is)h(set)g(explicitly)g(for)f(an)g(axis.)52
b(Ho)n(w)n(ev)n(er,)33 b(if)g(the)g(F)-7 b(ormat)32 b(attribute)227
-3550 y(sp)r(eci\014es)37 b(the)g(precision)f(using)g(the)h(string)f
+3836 y(sp)r(eci\014es)37 b(the)g(precision)f(using)g(the)h(string)f
Ft(")p Fj(.)p Fi(\003)p Ft(")p Fj(,)i(then)f(the)g(Digits)g(attribute)g
-(is)f(used)h(to)f(determine)h(the)227 3649 y(n)n(um)n(b)r(er)28
-b(of)f(decimal)h(places)e(to)i(pro)r(duce.)0 3847 y Fc(T)m(yp)s(e:)227
-3947 y Fj(In)n(teger.)0 4145 y Fc(Class)j(Applicabilit)m(y:)259
-4330 y(F)-8 b(rame)427 4429 y Fj(The)30 b(default)f(Digits)h(v)-5
+(is)f(used)h(to)f(determine)h(the)227 3936 y(n)n(um)n(b)r(er)28
+b(of)f(decimal)h(places)e(to)i(pro)r(duce.)0 4079 y Fc(T)m(yp)s(e:)227
+4179 y Fj(In)n(teger.)0 4322 y Fc(Class)j(Applicabilit)m(y:)259
+4452 y(F)-8 b(rame)427 4552 y Fj(The)30 b(default)f(Digits)h(v)-5
b(alue)29 b(supplied)h(b)n(y)f(the)g(F)-7 b(rame)29 b(class)f(is)i(7.)
41 b(If)30 b(a)f(v)-5 b(alue)29 b(less)g(than)g(1)g(is)g(supplied,)427
-4529 y(then)f(1)g(is)f(used)h(instead.)259 4686 y Fc(F)-8
-b(rameSet)427 4786 y Fj(The)23 b(Digits)f(attribute)g(of)h(a)f(F)-7
+4651 y(then)f(1)g(is)f(used)h(instead.)259 4778 y Fc(F)-8
+b(rameSet)427 4877 y Fj(The)23 b(Digits)f(attribute)g(of)h(a)f(F)-7
b(rameSet)22 b(\(or)f(one)h(of)g(its)h(axes\))e(is)i(the)f(same)g(as)g
-(that)g(of)g(its)h(curren)n(t)e(F)-7 b(rame)427 4885
+(that)g(of)g(its)h(curren)n(t)e(F)-7 b(rame)427 4977
y(\(as)27 b(sp)r(eci\014ed)h(b)n(y)g(the)g(Curren)n(t)e(attribute\).)
-259 5043 y Fc(Plot)427 5142 y Fj(The)34 b(default)h(Digits)f(v)-5
+259 5104 y Fc(Plot)427 5203 y Fj(The)34 b(default)h(Digits)f(v)-5
b(alue)33 b(used)h(b)n(y)g(the)g(Plot)g(class)f(when)h(dra)n(wing)e
-(annotated)i(axis)f(lab)r(els)g(is)h(the)427 5242 y(smallest)27
+(annotated)i(axis)f(lab)r(els)g(is)h(the)427 5303 y(smallest)27
b(v)-5 b(alue)28 b(whic)n(h)f(results)h(in)f(all)h(adjacen)n(t)f(lab)r
-(els)g(b)r(eing)h(distinct.)259 5399 y Fc(TimeF)-8 b(rame)427
-5499 y Fj(The)27 b(Digits)f(attribute)g(is)g(ignored)f(when)i(a)e
+(els)g(b)r(eing)h(distinct.)259 5429 y Fc(TimeF)-8 b(rame)427
+5529 y Fj(The)27 b(Digits)f(attribute)g(is)g(ignored)f(when)i(a)e
(TimeF)-7 b(rame)26 b(formats)f(a)h(v)-5 b(alue)26 b(as)g(a)g(date)g
-(and)g(time)g(string)427 5598 y(\(see)i(the)g(F)-7 b(ormat)27
+(and)g(time)g(string)427 5629 y(\(see)i(the)g(F)-7 b(ormat)27
b(attribute\).)p eop end
-%%Page: 427 437
-TeXDict begin 427 436 bop 3643 52 a FG(427)p 0 351 3780
+%%Page: 431 441
+TeXDict begin 431 440 bop 3643 52 a FG(431)p 0 351 3780
12 v 0 490 a FA(Direction\(axis\))1173 483 y Fd(Displa)m(y)38
b(axis)g(in)g(con)m(v)m(en)m(tional)1638 598 y(direction?)2900
490 y FA(Direction\(axis\))0 749 y Fc(Description:)44
@@ -130073,8 +130235,8 @@ b(of)f(Disco.)0 5163 y Fc(T)m(yp)s(e:)227 5262 y Fj(Double)h
(precision.)0 5405 y Fc(Class)j(Applicabilit)m(y:)259
5534 y(PcdMap)427 5634 y Fj(All)d(PcdMaps)f(ha)n(v)n(e)f(this)i
(attribute.)p eop end
-%%Page: 428 438
-TeXDict begin 428 437 bop 0 52 a FG(428)1994 b Fz(C)91
+%%Page: 432 442
+TeXDict begin 432 441 bop 0 52 a FG(432)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
3780 12 v 0 483 a FA(Domain)744 b Fd(Co)s(ordinate)36
b(system)i(domain)742 b FA(Domain)0 662 y Fc(Description:)44
@@ -130151,8 +130313,8 @@ b(alues)27 b(on)f(the)h(axes.)36 b(The)27 b(lo)r(cation)f(of)h(these)g
(tic)n(k)g(marks)f(and)g(lab)r(els)h(\(and)g(hence)g(the)g(axis)f
(lines\))227 5693 y(is)i(determined)g(b)n(y)f(the)h(Plot's)f(Lab)r(elA)
n(t\(axis\))g(attribute.)p eop end
-%%Page: 429 439
-TeXDict begin 429 438 bop 3643 52 a FG(429)227 351 y
+%%Page: 433 443
+TeXDict begin 433 442 bop 3643 52 a FG(433)227 351 y
Fj(If)29 b(the)f(Dra)n(wAxes)f(v)-5 b(alue)27 b(of)h(a)g(Plot)f(is)h
(non-zero)e(\(the)i(default\),)h(then)f(axis)f(lines)h(will)g(b)r(e)h
(dra)n(wn,)e(otherwise)227 451 y(they)h(will)g(b)r(e)g(omitted.)0
@@ -130218,8 +130380,8 @@ b(This)19 b(is)g(ensured)g(b)n(y)g(the)g(o)r(ccasional)f(in)n(tro)r
(duction)227 5693 y(of)29 b(leap)g(seconds)f(in)n(to)h(the)g(UTC)g
(timescale.)41 b(Therefore)28 b(no)g(great)g(error)f(will)i(usually)g
(result)g(if)g(no)g(v)-5 b(alue)29 b(is)p eop end
-%%Page: 430 440
-TeXDict begin 430 439 bop 0 52 a FG(430)1994 b Fz(C)91
+%%Page: 434 444
+TeXDict begin 434 443 bop 0 52 a FG(434)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)227 351
y Fj(assigned)21 b(to)h(this)h(attribute)f(\(in)h(whic)n(h)f(case)g(a)g
(default)g(v)-5 b(alue)22 b(of)h(zero)e(is)h(used\).)35
@@ -130295,8 +130457,8 @@ y(in)j(the)g(form)f(of)h(FITS)g(headers)e(and)i(the)f(Enco)r(ding)g
Ft(")p Fj(Enco)r(dings)d(Av)-5 b(ailable)p Ft(")27 b
Fj(section)h(b)r(elo)n(w,)227 5693 y(and)g(in)g(more)e(detail)i(in)g
(the)g(sections)f(whic)n(h)g(follo)n(w.)p eop end
-%%Page: 431 441
-TeXDict begin 431 440 bop 3643 52 a FG(431)227 351 y
+%%Page: 435 445
+TeXDict begin 435 444 bop 3643 52 a FG(435)227 351 y
Fj(Enco)r(ding)31 b(systems)f(di\013er)h(in)g(the)h(range)d(of)i(p)r
(ossible)g(Ob)5 b(jects)31 b(\(e.g.)46 b(classes\))30
b(they)i(can)e(represen)n(t,)h(in)g(the)227 451 y(restrictions)20
@@ -130397,8 +130559,8 @@ b(,)37 b(so)e(its)h(use)f(will)g(facilitate)h(data)f(exc)n(hange)f
(with)h(IRAF.)i(Its)427 5693 y(main)f(adv)-5 b(an)n(tages)34
b(are)h(that)h(it)h(is)f(a)f(stable)h(con)n(v)n(en)n(tion)e(whic)n(h)i
(appro)n(ximates)e(to)i(a)f(subset)h(of)g(the)p eop end
-%%Page: 432 442
-TeXDict begin 432 441 bop 0 52 a FG(432)1994 b Fz(C)91
+%%Page: 436 446
+TeXDict begin 436 445 bop 0 52 a FG(436)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)427 351
y Fj(propsed)c(FITS-W)n(CS)g(enco)r(ding)g(\(ab)r(o)n(v)n(e\).)35
b(This)28 b(mak)n(es)e(it)h(suitable)g(as)g(an)g(in)n(terim)g(metho)r
@@ -130468,32 +130630,33 @@ b(FITS-CLASS)h(is)f(used)g(if)g(the)h(FitsChan)f(con)n(tains)f(a)g(DEL)
-7 b(T)g(A)e(V)25 b(k)n(eyw)n(ord)d(and)i(a)f(k)n(eyw)n(ord)427
3801 y(of)f(the)g(form)f(VELO-xxx,)h(where)f(xxx)g(indicates)g(one)h
(of)f(the)h(rest)g(frames)f(used)g(b)n(y)h(class)e(\(e.g.)35
-b Ft(")p Fj(VELO-)427 3900 y(LSR)p Ft(")p Fj(\).)340
-4033 y Fi(\017)45 b Fj(Otherwise,)e(if)e(the)g(FitsChan)f(con)n(tains)g
-(a)g(CTYPE)g(k)n(eyw)n(ord)e(whic)n(h)j(represen)n(ts)d(a)j(sp)r
-(ectral)e(axis)427 4133 y(using)f(the)h(con)n(v)n(en)n(tions)e(of)i
-(the)f(AIPS)h(and)f(AIPS++)g(pro)5 b(jects)37 b(\(e.g.)70
-b Ft(")p Fj(FELO-LSR)p Ft(")p Fj(,)39 b(etc\),)j(then)427
-4232 y(one)31 b(of)g(FITS-AIPS)g(or)f(FITS-AIPS++)g(enco)r(ding)h(is)f
-(used.)48 b(FITS-AIPS++)30 b(is)h(used)f(if)i(an)n(y)e(of)h(the)427
-4332 y(k)n(eyw)n(ords)g(CDi)p Ft(_)p Fj(j,)j(PR)n(OJP)-7
-b(,)32 b(LONPOLE)f(or)g(LA)-7 b(TPOLE)32 b(are)g(found)h(in)g(the)g
-(FitsChan.)52 b(Otherwise)427 4431 y(FITS-AIPS)28 b(is)f(used.)340
-4564 y Fi(\017)45 b Fj(Otherwise,)28 b(if)g(the)h(FitsChan)f(con)n
-(tains)f(a)h(k)n(eyw)n(ord)e(of)i(the)g(form)g Ft(")p
-Fj(PCiiijjj)p Ft(")p Fj(,)g(where)g Ft(")p Fj(i)p Ft(")f
-Fj(and)h Ft(")p Fj(j)p Ft(")g Fj(are)427 4664 y(single)f(digits,)h
-(then)g(FITS-PC)f(enco)r(ding)g(is)h(used,)340 4797 y
-Fi(\017)45 b Fj(Otherwise,)27 b(if)h(the)g(FitsChan)g(con)n(tains)f(a)g
-(k)n(eyw)n(ord)e(of)j(the)g(form)f Ft(")p Fj(CDiiijjj)p
-Ft(")p Fj(,)i(where)e Ft(")p Fj(i)p Ft(")g Fj(and)g Ft(")p
-Fj(j)p Ft(")h Fj(are)427 4896 y(single)f(digits,)h(then)g(FITS-IRAF)g
-(enco)r(ding)f(is)h(used,)340 5029 y Fi(\017)45 b Fj(Otherwise,)c(if)e
-(the)f(FitsChan)h(con)n(tains)e(a)h(k)n(eyw)n(ord)f(of)h(the)h(form)f
-Ft(")p Fj(CDi)p Ft(_)p Fj(j)p Ft(")p Fj(,)j(and)d(at)h(least)f(one)g
-(of)427 5129 y(RADECSYS,)43 b(PR)n(OJPi,)g(or)d(CjV)-9
-b(ALi)42 b(where)f Ft(")p Fj(i)p Ft(")g Fj(and)g Ft(")p
-Fj(j)p Ft(")g Fj(are)f(single)h(digits,)k(then)d(FITS-IRAF)427
+b Ft(")p Fj(VELO-)427 3900 y(LSR)p Ft(")p Fj(\),)28 b(or)f
+Ft(")p Fj(VLSR)p Ft(")p Fj(.)340 4033 y Fi(\017)45 b
+Fj(Otherwise,)e(if)e(the)g(FitsChan)f(con)n(tains)g(a)g(CTYPE)g(k)n
+(eyw)n(ord)e(whic)n(h)j(represen)n(ts)d(a)j(sp)r(ectral)e(axis)427
+4133 y(using)f(the)h(con)n(v)n(en)n(tions)e(of)i(the)f(AIPS)h(and)f
+(AIPS++)g(pro)5 b(jects)37 b(\(e.g.)70 b Ft(")p Fj(FELO-LSR)p
+Ft(")p Fj(,)39 b(etc\),)j(then)427 4232 y(one)31 b(of)g(FITS-AIPS)g(or)
+f(FITS-AIPS++)g(enco)r(ding)h(is)f(used.)48 b(FITS-AIPS++)30
+b(is)h(used)f(if)i(an)n(y)e(of)h(the)427 4332 y(k)n(eyw)n(ords)g(CDi)p
+Ft(_)p Fj(j,)j(PR)n(OJP)-7 b(,)32 b(LONPOLE)f(or)g(LA)-7
+b(TPOLE)32 b(are)g(found)h(in)g(the)g(FitsChan.)52 b(Otherwise)427
+4431 y(FITS-AIPS)28 b(is)f(used.)340 4564 y Fi(\017)45
+b Fj(Otherwise,)28 b(if)g(the)h(FitsChan)f(con)n(tains)f(a)h(k)n(eyw)n
+(ord)e(of)i(the)g(form)g Ft(")p Fj(PCiiijjj)p Ft(")p
+Fj(,)g(where)g Ft(")p Fj(i)p Ft(")f Fj(and)h Ft(")p Fj(j)p
+Ft(")g Fj(are)427 4664 y(single)f(digits,)h(then)g(FITS-PC)f(enco)r
+(ding)g(is)h(used,)340 4797 y Fi(\017)45 b Fj(Otherwise,)27
+b(if)h(the)g(FitsChan)g(con)n(tains)f(a)g(k)n(eyw)n(ord)e(of)j(the)g
+(form)f Ft(")p Fj(CDiiijjj)p Ft(")p Fj(,)i(where)e Ft(")p
+Fj(i)p Ft(")g Fj(and)g Ft(")p Fj(j)p Ft(")h Fj(are)427
+4896 y(single)f(digits,)h(then)g(FITS-IRAF)g(enco)r(ding)f(is)h(used,)
+340 5029 y Fi(\017)45 b Fj(Otherwise,)c(if)e(the)f(FitsChan)h(con)n
+(tains)e(a)h(k)n(eyw)n(ord)f(of)h(the)h(form)f Ft(")p
+Fj(CDi)p Ft(_)p Fj(j)p Ft(")p Fj(,)j(and)d(at)h(least)f(one)g(of)427
+5129 y(RADECSYS,)43 b(PR)n(OJPi,)g(or)d(CjV)-9 b(ALi)42
+b(where)f Ft(")p Fj(i)p Ft(")g Fj(and)g Ft(")p Fj(j)p
+Ft(")g Fj(are)f(single)h(digits,)k(then)d(FITS-IRAF)427
5228 y(enco)r(ding)28 b(is)f(used.)340 5361 y Fi(\017)45
b Fj(Otherwise,)26 b(if)i(the)f(FitsChan)f(con)n(tains)g(an)n(y)g(k)n
(eyw)n(ords)e(of)j(the)g(form)f(PR)n(OJPi,)f(CjV)-9 b(ALi)28
@@ -130504,8 +130667,8 @@ b Fj(Otherwise,)34 b(if)g(the)g(FitsChan)g(con)n(tains)e(a)h(k)n(eyw)n
(ord)f(of)h(the)h(form)f(CR)n(OT)-7 b(Ai,)35 b(where)e
Ft(")p Fj(i)p Ft(")g Fj(is)g(a)g(single)427 5693 y(digit,)28
b(then)g(FITS-AIPS)g(enco)r(ding)f(is)g(used.)p eop end
-%%Page: 433 443
-TeXDict begin 433 442 bop 3643 52 a FG(433)340 351 y
+%%Page: 437 447
+TeXDict begin 437 446 bop 3643 52 a FG(437)340 351 y
Fi(\017)45 b Fj(Otherwise,)36 b(if)f(the)g(FitsChan)g(con)n(tains)f(a)g
(k)n(eyw)n(ord)f(of)i(the)g(form)f(CR)-9 b(V)g(ALi,)37
b(where)d Ft(")p Fj(i)p Ft(")g Fj(is)h(a)f(single)427
@@ -130615,8 +130778,8 @@ b(rames)26 b(whic)n(h)h(will)g(b)r(e)h(result)f(in)g(m)n(ultiple)g
Ft(")p Fj(\).)40 b(Details)29 b(of)g(the)g(use)g(made)g(b)n(y)g(this)g
(Enco)r(ding)f(of)h(the)h(con)n(v)n(en)n(tions)d(describ)r(ed)i(in)g
(the)p eop end
-%%Page: 434 444
-TeXDict begin 434 443 bop 0 52 a FG(434)1994 b Fz(C)91
+%%Page: 438 448
+TeXDict begin 438 447 bop 0 52 a FG(438)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)227 351
y Fj(FITS-W)n(CS)22 b(pap)r(ers)g(are)f(giv)n(en)g(in)h(the)h(app)r
(endix)f Ft(")p Fj(FITS-W)n(CS)g(Co)n(v)n(erage)p Ft(")c
@@ -130744,8 +130907,8 @@ b(of)227 5394 y(the)27 b(F)-7 b(rameSet)26 b(is)h(used)f(to)g(form)g
b(rameSet)32 b(ma)n(y)g(b)r(e)h(used)f(to)h(construct)f(secondary)e
(axis)i(descriptions,)h(where)227 5693 y(appropriate.)p
eop end
-%%Page: 435 445
-TeXDict begin 435 444 bop 3643 52 a FG(435)227 351 y
+%%Page: 439 449
+TeXDict begin 439 448 bop 3643 52 a FG(439)227 351 y
Fj(A)24 b(successful)f(write)h(op)r(eration)e(will)i(o)n(v)n(er-write)d
(an)n(y)i(existing)g(FITS-W)n(CS)g(enco)r(ded)h(data)f(in)h(the)f
(FitsChan,)227 451 y(but)37 b(will)g(not)g(a\013ect)g(other)f
@@ -130846,8 +131009,8 @@ y(the)k(same)f(w)n(a)n(y)g(and)g(has)g(the)h(same)f(restrictions.)-2
y Fj(The)e(FITS-AIPS)f(enco)r(ding)g(can,)h(for)f(most)g(purp)r(oses,)h
(b)r(e)g(considered)e(as)h(equiv)-5 b(alen)n(t)31 b(to)h(the)f(FITS-W)n
(CS)p eop end
-%%Page: 436 446
-TeXDict begin 436 445 bop 0 52 a FG(436)1994 b Fz(C)91
+%%Page: 440 450
+TeXDict begin 440 449 bop 0 52 a FG(440)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)227 351
y Fj(enco)r(ding)24 b(\(ab)r(o)n(v)n(e\),)g(although)g(it)h(di\013ers)f
(in)g(the)h(details)f(of)g(the)g(FITS)h(k)n(eyw)n(ords)d(used.)36
@@ -130938,8 +131101,8 @@ b(jection)26 b(parameters)g(m)n(ust)i(b)r(oth)g(b)r(e)g(zero.)340
(is)h(allo)n(w)n(ed,)g(unless)g(the)g(spatial)g(axes)f(are)g
(degenerate)g(\(i.e.)39 b(co)n(v)n(er)427 5693 y(only)27
b(a)h(single)f(pixel\).)p eop end
-%%Page: 437 447
-TeXDict begin 437 446 bop 3643 52 a FG(437)340 351 y
+%%Page: 441 451
+TeXDict begin 441 450 bop 3643 52 a FG(441)340 351 y
Fi(\017)45 b Fj(The)34 b(frequency)g(axis)f(in)h(the)h(created)e
(header)g(will)h(alw)n(a)n(ys)e(describ)r(e)i(frequency)g(in)g(the)g
(source)f(rest)427 451 y(frame.)53 b(If)34 b(the)f(supplied)h(F)-7
@@ -131049,8 +131212,8 @@ b(,)32 b(the)f(Ep)r(o)r(c)n(h)227 5693 y(v)-5 b(alue)25
b(should)g(b)r(e)g(supplied)g(in)g(the)g(TDB)g(timescale,)g(but)h(for)e
(some)g(purp)r(oses)g(\(for)h(instance,)g(for)f(con)n(v)n(erting)p
eop end
-%%Page: 438 448
-TeXDict begin 438 447 bop 0 52 a FG(438)1994 b Fz(C)91
+%%Page: 442 452
+TeXDict begin 442 451 bop 0 52 a FG(442)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)227 351
y Fj(sky)36 b(p)r(ositions)f(b)r(et)n(w)n(een)h(di\013eren)n(t)g(t)n
(yp)r(es)f(of)h(equatorial)e(system\))i(the)h(timescale)e(is)h(not)g
@@ -131145,8 +131308,8 @@ b(Expressed)32 b(in)i(decimal)f(y)n(ears,)h(with)g(or)e(without)i
(decimal)g(places)f(\()p Ft(")p Fj(B1950)p Ft(")d Fj(or)427
5693 y Ft(")p Fj(B1976.13)p Ft(")24 b Fj(for)j(example\).)p
eop end
-%%Page: 439 449
-TeXDict begin 439 448 bop 3643 52 a FG(439)340 351 y
+%%Page: 443 453
+TeXDict begin 443 452 bop 3643 52 a FG(443)340 351 y
Fi(\017)45 b Fj(Julian)e(Ep)r(o)r(c)n(h:)67 b(Expressed)42
b(in)h(decimal)g(y)n(ears,)i(with)e(or)g(without)g(decimal)g(places)f
(\()p Ft(")p Fj(J2000)p Ft(")e Fj(or)427 451 y Ft(")p
@@ -131234,8 +131397,8 @@ i(\(see)227 4726 y(the)c(System)g(attribute\))g(and)f(J2000.0)e
(y:)259 5298 y(SkyF)-8 b(rame)427 5398 y Fj(All)28 b(SkyF)-7
b(rames)27 b(ha)n(v)n(e)f(this)i(attribute.)0 5572 y
Fc(Notes:)p eop end
-%%Page: 440 450
-TeXDict begin 440 449 bop 0 52 a FG(440)1994 b Fz(C)91
+%%Page: 444 454
+TeXDict begin 444 453 bop 0 52 a FG(444)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)340 351
y Fi(\017)45 b Fj(Care)21 b(m)n(ust)h(b)r(e)h(tak)n(en)e(to)h
(distinguish)g(the)h(Equino)n(x)e(v)-5 b(alue,)23 b(whic)n(h)f(relates)
@@ -131330,8 +131493,8 @@ Fj(giv)n(e)g(the)i(new)227 5567 y(width)29 b(as)d(a)i(fraction)f(of)g
(1.0;)227 5693 y(\045w+)h(-)f(Reset)h(the)g(Size)f(attribute)h(to)g
(its)f Ft(")p Fj(normal)p Ft(")f Fj(v)-5 b(alue.)p eop
end
-%%Page: 441 451
-TeXDict begin 441 450 bop 3643 52 a FG(441)227 351 y
+%%Page: 445 455
+TeXDict begin 445 454 bop 3643 52 a FG(445)227 351 y
Fj(\045f...+)31 b(-)f(Change)f(the)i(F)-7 b(on)n(t)30
b(attribute)g(for)g(subsequen)n(t)g(c)n(haracters.)42
b(The)31 b(digits)f Ft(")p Fj(...)p Ft(")f Fj(giv)n(e)h(the)g(new)h(F)
@@ -131407,8 +131570,8 @@ b(alue)30 b(\(including)g(sign,)h(decimal)f(p)r(oin)n(t)g(and)g(exp)r
(to)h(use,)f(but)h(the)227 5693 y(actual)23 b(n)n(um)n(b)r(er)f(used)h
(ma)n(y)g(b)r(e)g(few)n(er)g(than)g(this)g(to)g(ensure)f(that)i(the)f
(FITS)g(recommendations)f(are)g(satis\014ed.)p eop end
-%%Page: 442 452
-TeXDict begin 442 451 bop 0 52 a FG(442)1994 b Fz(C)91
+%%Page: 446 456
+TeXDict begin 446 455 bop 0 52 a FG(446)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)227 351
y Fj(When)22 b(using)g(this)f(approac)n(h,)g(the)h(resulting)f(n)n(um)n
(b)r(er)g(of)h(signi\014can)n(t)f(digits)g(ma)n(y)g(dep)r(end)h(on)f
@@ -131480,8 +131643,8 @@ Ft(")e Fj(function)i(\(e.g.)37 b Ft(")p Fj(\0451.7G)p
Ft(")p Fj(\))26 b(in)i(order)e(to)h(format)g(a)g(single)g(co)r
(ordinate)f(v)-5 b(alue)27 b(\(supplied)h(as)427 5693
y(a)f(double)h(precision)f(n)n(um)n(b)r(er\).)p eop end
-%%Page: 443 453
-TeXDict begin 443 452 bop 3643 52 a FG(443)259 351 y
+%%Page: 447 457
+TeXDict begin 447 456 bop 3643 52 a FG(447)259 351 y
Fc(SkyF)-8 b(rame)427 451 y Fj(The)36 b(SkyF)-7 b(rame)35
b(class)f(re-de\014nes)h(the)h(syn)n(tax)e(and)i(default)g(v)-5
b(alue)35 b(of)h(the)g(F)-7 b(ormat)34 b(string)h(to)h(allo)n(w)427
@@ -131586,8 +131749,8 @@ b(The)21 b Ft(")p Fj(.)p Ft(")e Fj(should)i(b)r(e)f(follo)n(w)n(ed)g
(is)h(supplied,)h(a)427 5693 y(default)c(n)n(um)n(b)r(er)g(of)f
(decimal)h(places)f(is)g(used)h(whic)n(h)f(is)h(based)f(on)g(the)h(v)-5
b(alue)27 b(of)h(the)g(Digits)g(attribute.)p eop end
-%%Page: 444 454
-TeXDict begin 444 453 bop 0 52 a FG(444)1994 b Fz(C)91
+%%Page: 448 458
+TeXDict begin 448 457 bop 0 52 a FG(448)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)227 351
y Fj(All)21 b(of)f(the)g(ab)r(o)n(v)n(e)f(format)h(sp)r(eci\014ers)f
(are)g(case-insensitiv)n(e.)33 b(If)20 b(sev)n(eral)f(c)n(haracters)e
@@ -131684,8 +131847,8 @@ b(alue)28 b(is)g(zero)f(for)h(an)g(StcsChan.)39 b(Set)29
b(a)f(p)r(ositiv)n(e)g(v)-5 b(alue)28 b(to)g(cause)g(default)h(v)-5
b(alues)28 b(to)g(b)r(e)427 5693 y(included)g(in)g(STC-S)g
(descriptions.)p eop end
-%%Page: 445 455
-TeXDict begin 445 454 bop 3643 52 a FG(445)0 351 y Fc(Notes:)340
+%%Page: 449 459
+TeXDict begin 449 458 bop 3643 52 a FG(449)0 351 y Fc(Notes:)340
636 y Fi(\017)45 b Fj(All)27 b(p)r(ositiv)n(e)f(v)-5
b(alues)26 b(supplied)h(for)f(this)g(attribute)h(are)e(con)n(v)n(erted)
g(to)h(+1)g(and)g(all)g(negativ)n(e)g(v)-5 b(alues)26
@@ -131759,8 +131922,8 @@ b(In)34 b(this)h(case,)g(if)f(a)g(routine)227 4826 y(is)k(needed)g
5303 y Fj(In)n(teger)g(\(b)r(o)r(olean\).)0 5455 y Fc(Class)k
(Applicabilit)m(y:)259 5593 y(Plot)427 5693 y Fj(All)d(Plots)f(ha)n(v)n
(e)g(this)g(attribute.)p eop end
-%%Page: 446 456
-TeXDict begin 446 455 bop 0 52 a FG(446)1994 b Fz(C)91
+%%Page: 450 460
+TeXDict begin 450 459 bop 0 52 a FG(450)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)259 351
y Fc(Plot3D)427 451 y Fj(The)d(Plot3D)f(class)g(ignores)f(this)h
(attributes,)h(assuming)f(a)g(v)-5 b(alue)27 b(of)h(zero.)0
@@ -131815,8 +131978,8 @@ g(grating)e(or)h(exit)h(prism)227 5348 y(face,)36 b(and)e(the)g(disp)r
y(outgoing)27 b(ra)n(y)-7 b(.)35 b(The)28 b(default)g(v)-5
b(alue)27 b(is)h(0.0.)0 5593 y Fc(T)m(yp)s(e:)227 5693
y Fj(Double)g(precision.)p eop end
-%%Page: 447 457
-TeXDict begin 447 456 bop 3643 52 a FG(447)0 351 y Fc(Class)31
+%%Page: 451 461
+TeXDict begin 451 460 bop 3643 52 a FG(451)0 351 y Fc(Class)31
b(Applicabilit)m(y:)259 475 y(GrismMap)427 575 y Fj(All)d(GrismMaps)f
(ha)n(v)n(e)g(this)g(attribute.)p 0 750 3780 12 v 0 882
a FA(GrismG)747 b Fd(The)39 b(grating)d(ruling)h(densit)m(y)747
@@ -131864,8 +132027,8 @@ b(and)i(GrismG.)0 5179 y Fc(T)m(yp)s(e:)227 5278 y Fj(Double)g
(precision.)0 5415 y Fc(Class)j(Applicabilit)m(y:)259
5540 y(GrismMap)427 5639 y Fj(All)d(GrismMaps)f(ha)n(v)n(e)g(this)g
(attribute.)p eop end
-%%Page: 448 458
-TeXDict begin 448 457 bop 0 52 a FG(448)1994 b Fz(C)91
+%%Page: 452 462
+TeXDict begin 452 461 bop 0 52 a FG(452)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
3780 12 v 0 483 a FA(GrismTheta)152 b Fd(Angle)38 b(b)s(et)m(w)m(een)g
(normal)f(to)h(detector)f(plane)1449 598 y(and)i(reference)f(ra)m(y)
@@ -131925,8 +132088,8 @@ b(Instead,)31 b(its)g(v)-5 b(alue)30 b(is)h(unde\014ned)g(\(and)g
(in)i(an)n(y)e(external)h(represen)n(tation)e(of)i(an)g(Ob)5
b(ject)33 b(pro)r(duced)g(b)n(y)g(the)427 5644 y(AST)p
Ft(_)p Fj(WRITE)28 b(routine.)p eop end
-%%Page: 449 459
-TeXDict begin 449 458 bop 3643 52 a FG(449)p 0 351 3780
+%%Page: 453 463
+TeXDict begin 453 462 bop 3643 52 a FG(453)p 0 351 3780
12 v 0 482 a FA(IF)437 483 y Fd(The)39 b(in)m(termediate)c(frequency)j
(in)h(a)g(dual)f(sideband)g(sp)s(ectrum)3645 482 y FA(IF)0
687 y Fc(Description:)44 b Fj(This)26 b(attribute)h(sp)r(eci\014es)f
@@ -132005,8 +132168,8 @@ b(The)227 5593 y(new)32 b(frequency)f(is)h(con)n(v)n(erted)f(bac)n(k)f
(resulting)f(v)-5 b(alue)32 b(is)227 5693 y(returned)27
b(as)g(the)h(attribute)g(v)-5 b(alue,)28 b(in)g(units)g(of)f(GHz.)p
eop end
-%%Page: 450 460
-TeXDict begin 450 459 bop 0 52 a FG(450)1994 b Fz(C)91
+%%Page: 454 464
+TeXDict begin 454 463 bop 0 52 a FG(454)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)0 351 y
Fc(T)m(yp)s(e:)227 451 y Fj(Floating)c(p)r(oin)n(t,)h(read-only)-7
b(.)0 621 y Fc(Class)31 b(Applicabilit)m(y:)259 778 y(DSBSp)s(ecF)-8
@@ -132080,8 +132243,8 @@ i(then)f(extra)f(linefeed)427 5417 y(and)35 b(space)g(c)n(haracters)d
(spaces)g(to)g(sho)n(w)g(its)h(depth)g(in)g(the)427 5617
y(con)n(tainmen)n(t)27 b(hierarc)n(h)n(y)-7 b(.)p eop
end
-%%Page: 451 461
-TeXDict begin 451 460 bop 3643 52 a FG(451)p 0 351 3780
+%%Page: 455 465
+TeXDict begin 455 464 bop 3643 52 a FG(455)p 0 351 3780
12 v 0 483 a FA(In)l(traFlag)582 b Fd(In)m(traMap)37
b(iden)m(ti\014cation)f(string)578 b FA(In)l(traFlag)0
674 y Fc(Description:)44 b Fj(This)32 b(attribute)g(allo)n(ws)e(an)h
@@ -132155,8 +132318,8 @@ b(etc.\).)37 b(The)24 b(In)n(v)n(ert)g(attribute)g(of)h(a)f(F)-7
b(rameSet)24 b(is)h(not)f(itself)h(a\013ected)g(b)n(y)f(selecting)427
5642 y(a)j(new)h(base)f(or)g(curren)n(t)g(F)-7 b(rame.)p
eop end
-%%Page: 452 462
-TeXDict begin 452 461 bop 0 52 a FG(452)1994 b Fz(C)91
+%%Page: 456 466
+TeXDict begin 456 465 bop 0 52 a FG(456)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
3780 12 v 0 483 a FA(In)l(visible)521 b Fd(Dra)m(w)38
b(graphics)f(using)i(in)m(visible)e(ink?)519 b FA(In)l(visible)0
@@ -132213,8 +132376,8 @@ y(Sp)r(eci\014c)33 b(instances)g(of)f(suc)n(h)h(classes)e(can)h(b)r(e)h
(read-only)-7 b(.)0 5450 y Fc(Class)31 b(Applicabilit)m(y:)259
5593 y(Mapping)427 5693 y Fj(All)d(Mappings)f(ha)n(v)n(e)g(this)h
(attribute.)p eop end
-%%Page: 453 463
-TeXDict begin 453 462 bop 3643 52 a FG(453)259 351 y
+%%Page: 457 467
+TeXDict begin 457 466 bop 3643 52 a FG(457)259 351 y
Fc(CmpMap)427 451 y Fj(The)23 b(IsLinear)f(v)-5 b(alue)23
b(for)f(a)h(CmpMap)f(is)h(determined)g(b)n(y)g(the)g(classes)f(of)h
(the)g(encapsulated)f(Mappings.)427 551 y(F)-7 b(or)34
@@ -132273,8 +132436,8 @@ b(Most)27 b(non-F)-7 b(rame)25 b(Mappings,)i(on)427 5523
y(the)32 b(other)e(hand,)i(are)e(imm)n(utable)i(and)f(so)f(when)h(they)
h(are)e(simpli\014ed)h(it)h(is)f(certain)f(that)h(they)h(w)n(eill)427
5623 y(remain)27 b(in)h(a)f(simple)h(state.)p eop end
-%%Page: 454 464
-TeXDict begin 454 463 bop 0 52 a FG(454)1994 b Fz(C)91
+%%Page: 458 468
+TeXDict begin 458 467 bop 0 52 a FG(458)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
3780 12 v 0 482 a FA(IterIn)l(v)l(erse)1188 483 y Fd(Pro)m(vide)37
b(an)h(iterativ)m(e)e(in)m(v)m(erse)1483 583 y(transformation?)3142
@@ -132347,8 +132510,8 @@ b(If)32 b(KeyCase)d(is)j(zero,)227 5593 y(then)h(k)n(ey)e(strings)f
5693 y(used.)j(If)23 b(KeyCase)d(is)i(non-zero)f(\(the)i(default\),)h
(then)e(supplied)h(k)n(ey)e(strings)g(are)g(used)h(without)h(mo)r
(di\014cation.)p eop end
-%%Page: 455 465
-TeXDict begin 455 464 bop 3643 52 a FG(455)227 351 y
+%%Page: 459 469
+TeXDict begin 459 468 bop 3643 52 a FG(459)227 351 y
Fj(The)36 b(v)-5 b(alue)36 b(of)g(this)h(attribute)f(can)g(only)f(b)r
(e)i(c)n(hanged)e(if)h(the)h(KeyMap)e(is)h(empt)n(y)-7
b(.)62 b(Its)37 b(v)-5 b(alue)35 b(can)h(b)r(e)h(set)227
@@ -132400,8 +132563,8 @@ y Fc(T)m(yp)s(e:)227 5194 y Fj(Floating)f(p)r(oin)n(t.)0
5369 y Fc(Class)k(Applicabilit)m(y:)259 5531 y(TimeF)-8
b(rame)427 5630 y Fj(All)28 b(TimeF)-7 b(rames)27 b(ha)n(v)n(e)g(this)h
(attribute.)p eop end
-%%Page: 456 466
-TeXDict begin 456 465 bop 0 52 a FG(456)1994 b Fz(C)91
+%%Page: 460 470
+TeXDict begin 460 469 bop 0 52 a FG(460)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
3780 12 v 0 490 a FA(Lab)t(el\(axis\))1634 483 y Fd(Axis)38
b(lab)s(el)3125 490 y FA(Lab)t(el\(axis\))0 696 y Fc(Description:)44
@@ -132470,8 +132633,8 @@ h(o)n(wn)g(p)r(osition)g(for)g(n)n(umerical)f(lab)r(els)h(and)g(tic)n
(k)227 5299 y(marks.)0 5459 y Fc(T)m(yp)s(e:)227 5558
y Fj(Floating)27 b(p)r(oin)n(t.)0 5718 y Fc(Class)k(Applicabilit)m(y:)p
eop end
-%%Page: 457 467
-TeXDict begin 457 466 bop 3643 52 a FG(457)259 351 y
+%%Page: 461 471
+TeXDict begin 461 470 bop 3643 52 a FG(461)259 351 y
Fc(Plot)427 451 y Fj(All)28 b(Plots)f(ha)n(v)n(e)g(this)g(attribute.)0
615 y Fc(Notes:)340 900 y Fi(\017)45 b Fj(The)34 b(Lab)r(elA)n(t)h(v)-5
b(alue)33 b(should)h(use)g(the)h(same)e(units)i(as)e(are)g(used)h(in)n
@@ -132545,8 +132708,8 @@ h(annotated)f(co)r(ordinate)g(grid)g(\(dra)n(wn)g(with)h(the)227
(not.)57 b(It)35 b(tak)n(es)f(a)g(separate)f(v)-5 b(alue)35
b(for)f(eac)n(h)f(ph)n(ysical)h(axis)g(of)g(a)h(Plot)f(so)f(that,)k
(for)p eop end
-%%Page: 458 468
-TeXDict begin 458 467 bop 0 52 a FG(458)1994 b Fz(C)91
+%%Page: 462 472
+TeXDict begin 462 471 bop 0 52 a FG(462)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)227 351
y Fj(instance,)c(the)f(setting)g Ft(")p Fj(Lab)r(elUp\(2\)=1)p
Ft(")f Fj(sp)r(eci\014es)h(that)h(n)n(umerical)e(lab)r(els)h(for)g(the)
@@ -132603,8 +132766,8 @@ y Fc(Notes:)340 5504 y Fi(\017)45 b Fj(The)25 b(Lab)r(elA)n(t\(axis\))f
(placemen)n(t)g(of)g(lab)r(els)g(and)g(tic)n(k)427 5603
y(marks)j(that)h(are)e(dra)n(wn)h(inside)h(the)f(plotting)h(area.)p
eop end
-%%Page: 459 469
-TeXDict begin 459 468 bop 3643 52 a FG(459)p 0 351 3780
+%%Page: 463 473
+TeXDict begin 463 472 bop 3643 52 a FG(463)p 0 351 3780
12 v 0 483 a FA(LatAxis)781 b Fd(Index)40 b(of)e(the)g(latitude)f(axis)
780 b FA(LatAxis)0 639 y Fc(Description:)44 b Fj(This)26
b(read-only)d(attribute)j(giv)n(es)e(the)i(index)g(\(1)f(or)f(2\))i(of)
@@ -132671,8 +132834,8 @@ b(alue)24 b(of)g(all)g(the)h(Plot)e(axes,)h(while)h(a)f
Ft(")p Fj(get)p Ft(")f Fj(or)g Ft(")p Fj(test)p Ft(")h
Fj(op)r(eration)427 5630 y(will)k(use)g(just)g(the)g(LogGap\(1\))e(v)-5
b(alue.)p eop end
-%%Page: 460 470
-TeXDict begin 460 469 bop 0 52 a FG(460)1994 b Fz(C)91
+%%Page: 464 474
+TeXDict begin 464 473 bop 0 52 a FG(464)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
3780 12 v 0 490 a FA(LogLab)t(el\(axis\))1203 483 y Fd(Use)39
b(exp)s(onen)m(tial)e(format)f(for)1330 598 y(n)m(umerical)g(axis)i
@@ -132744,8 +132907,8 @@ b(whic)n(h)g(are)f(ev)n(enly)h(spaced)g(in)h(v)-5 b(alue)22
b(but)h(whic)n(h)f(are)g(mapp)r(ed)g(logarithmically)f(on)n(to)h(the)g
(screen)427 5693 y(\(and)28 b(vice-v)n(ersa\).)p eop
end
-%%Page: 461 471
-TeXDict begin 461 470 bop 3643 52 a FG(461)340 351 y
+%%Page: 465 475
+TeXDict begin 465 474 bop 3643 52 a FG(465)340 351 y
Fi(\017)45 b Fj(An)22 b(axis)e(ma)n(y)g(only)h(b)r(e)g(mapp)r(ed)h
(logarithmically)d(if)j(the)f(visible)g(part)f(of)h(the)h(axis)e(do)r
(es)h(not)g(include)g(the)427 451 y(v)-5 b(alue)29 b(zero.)38
@@ -132834,8 +132997,8 @@ y Fc(Description:)44 b Fj(This)22 b(read-only)e(attribute)i(giv)n(es)f
(the)g(SkyF)-7 b(rame)227 5693 y(\(taking)28 b(in)n(to)f(accoun)n(t)g
(an)n(y)f(curren)n(t)h(axis)g(p)r(erm)n(utations\).)p
eop end
-%%Page: 462 472
-TeXDict begin 462 471 bop 0 52 a FG(462)1994 b Fz(C)91
+%%Page: 466 476
+TeXDict begin 466 475 bop 0 52 a FG(466)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)0 351 y
Fc(T)m(yp)s(e:)227 451 y Fj(In)n(teger.)0 611 y Fc(Class)g
(Applicabilit)m(y:)259 758 y(SkyF)-8 b(rame)427 857 y
@@ -132901,8 +133064,8 @@ Ft(")p Fj(clear)p Ft(")28 b Fj(op)r(eration)g(will)i(a\013ect)g(the)g
(a)f Ft(")p Fj(get)p Ft(")f Fj(or)h Ft(")p Fj(test)p
Ft(")427 5617 y Fj(op)r(eration)e(will)h(use)f(just)h(the)g(Ma)5
b(jTic)n(kLen\(1\))27 b(v)-5 b(alue.)p eop end
-%%Page: 463 473
-TeXDict begin 463 472 bop 3643 52 a FG(463)p 0 351 3780
+%%Page: 467 477
+TeXDict begin 467 476 bop 3643 52 a FG(467)p 0 351 3780
12 v 0 483 a FA(MapLo)t(c)l(k)l(ed)255 b Fd(Prev)m(en)m(t)37
b(new)i(en)m(tries)f(b)s(eing)g(added)h(to)f(a)1644 598
y(KeyMap?)3101 483 y FA(MapLo)t(c)l(k)l(ed)0 790 y Fc(Description:)44
@@ -132971,8 +133134,8 @@ b(alue,)31 b(ho)n(w)n(ev)n(er,)d(the)227 5693 y(matc)n(hing)f(pro)r
(cess)g(ma)n(y)g(b)r(e)h(used)f(to)h(iden)n(tify)g(F)-7
b(rames)27 b(with)h(sp)r(eci\014ed)g(n)n(um)n(b)r(ers)f(of)g(axes.)p
eop end
-%%Page: 464 474
-TeXDict begin 464 473 bop 0 52 a FG(464)1994 b Fz(C)91
+%%Page: 468 478
+TeXDict begin 468 477 bop 0 52 a FG(468)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)0 351 y
Fc(T)m(yp)s(e:)227 451 y Fj(In)n(teger.)0 596 y Fc(Class)g
(Applicabilit)m(y:)259 728 y(F)-8 b(rame)427 827 y Fj(The)35
@@ -133049,8 +133212,8 @@ y Fc(Class)k(Applicabilit)m(y:)259 5076 y(Region)427
(t)f(Region.)259 5532 y Fc(Stc)427 5632 y Fj(The)h(default)g(MeshSize)g
(for)f(an)g(Stc)h(is)f(the)h(MeshSize)g(of)f(its)h(encapsulated)f
(Region.)p eop end
-%%Page: 465 475
-TeXDict begin 465 474 bop 3643 52 a FG(465)p 0 351 3780
+%%Page: 469 479
+TeXDict begin 469 478 bop 3643 52 a FG(469)p 0 351 3780
12 v 0 483 a FA(MinAxes)279 b Fd(Minim)m(um)37 b(n)m(um)m(b)s(er)h(of)g
(F)-10 b(rame)39 b(axes)f(to)g(matc)m(h)278 b FA(MinAxes)0
656 y Fc(Description:)44 b Fj(This)27 b(attribute)f(con)n(trols)e(ho)n
@@ -133129,8 +133292,8 @@ b(alue)28 b(is)f(c)n(hosen)g(that)h(dep)r(ends)g(on)f(the)h(gap)f(b)r
b(and)g(the)h(nature)f(of)h(the)g(axis.)0 5467 y Fc(T)m(yp)s(e:)227
5566 y Fj(In)n(teger.)0 5718 y Fc(Class)j(Applicabilit)m(y:)p
eop end
-%%Page: 466 476
-TeXDict begin 466 475 bop 0 52 a FG(466)1994 b Fz(C)91
+%%Page: 470 480
+TeXDict begin 470 479 bop 0 52 a FG(470)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)259 351
y Fc(Plot)427 451 y Fj(All)d(Plots)f(ha)n(v)n(e)g(this)g(attribute.)0
618 y Fc(Notes:)340 906 y Fi(\017)45 b Fj(If)36 b(no)f(axis)g(is)g(sp)r
@@ -133211,8 +133374,8 @@ b(V)g(AL)33 b(k)n(eyw)n(ords)227 5693 y(will)j(b)n(y)e(default)i(giv)n
(e)e(the)h(celestial)g(co)r(ordinates)f(of)h(the)g(pro)5
b(jection)34 b(reference)g(p)r(oin)n(t,)j(but)f(ma)n(y)e(refer)h(to)p
eop end
-%%Page: 467 477
-TeXDict begin 467 476 bop 3643 52 a FG(467)227 351 y
+%%Page: 471 481
+TeXDict begin 471 480 bop 3643 52 a FG(471)227 351 y
Fj(some)23 b(other)g(p)r(oin)n(t)g(if)h(alternativ)n(e)e(nativ)n(e)h
(longitude)g(and)g(latitude)h(v)-5 b(alues)23 b(are)f(pro)n(vided)g
(through)h(the)h(PVi)p Ft(_)p Fj(j)227 451 y(k)n(eyw)n(ords.)227
@@ -133258,8 +133421,8 @@ b(rame)427 5517 y Fj(The)40 b(Naxes)e(attribute)i(of)f(a)g(CmpF)-7
b(rame)39 b(is)g(equal)g(to)h(the)f(sum)h(of)f(the)h(Naxes)f(v)-5
b(alues)39 b(of)g(its)g(t)n(w)n(o)427 5616 y(comp)r(onen)n(t)28
b(F)-7 b(rames.)p eop end
-%%Page: 468 478
-TeXDict begin 468 477 bop 0 52 a FG(468)1994 b Fz(C)91
+%%Page: 472 482
+TeXDict begin 472 481 bop 0 52 a FG(472)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
3780 12 v 0 483 a FA(Ncard)388 b Fd(Num)m(b)s(er)38 b(of)g(FITS)h
(header)g(cards)f(in)g(a)h(FitsChan)387 b FA(Ncard)0
@@ -133320,8 +133483,8 @@ b(Changing)32 b(the)g(v)-5 b(alue)33 b(of)f(the)h(Negated)e(attribute)i
(then)g(the)g(b)r(oundary)e(of)i(the)f(Region)g(will)g(b)r(e)h(inside)g
(the)f(Region,)227 5693 y(whatev)n(er)27 b(the)h(setting)f(of)h(the)g
(Negated)f(attribute.)p eop end
-%%Page: 469 479
-TeXDict begin 469 478 bop 3643 52 a FG(469)0 351 y Fc(T)m(yp)s(e:)227
+%%Page: 473 483
+TeXDict begin 473 482 bop 3643 52 a FG(473)0 351 y Fc(T)m(yp)s(e:)227
451 y Fj(In)n(teger)27 b(\(b)r(o)r(olean\).)0 598 y Fc(Class)k
(Applicabilit)m(y:)259 732 y(Region)427 831 y Fj(All)d(Regions)f(ha)n
(v)n(e)f(this)i(attribute.)p 0 1026 3780 12 v 0 1157
@@ -133379,8 +133542,8 @@ b(v)-5 b(alue)33 b(giv)n(es)e(the)j(maxim)n(um)e(n)n(um)n(b)r(er)h(of)g
(used)227 5693 y(for)27 b(eac)n(h)g(transformed)g(p)r(osition.)36
b(The)28 b(default)g(v)-5 b(alue)27 b(is)h(4.)36 b(See)28
b(also)f(attribute)g(T)-7 b(olIn)n(v)n(erse.)p eop end
-%%Page: 470 480
-TeXDict begin 470 479 bop 0 52 a FG(470)1994 b Fz(C)91
+%%Page: 474 484
+TeXDict begin 474 483 bop 0 52 a FG(474)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)0 351 y
Fc(T)m(yp)s(e:)227 451 y Fj(In)n(teger.)0 597 y Fc(Class)g
(Applicabilit)m(y:)259 730 y(P)m(olyMap)427 829 y Fj(All)d(P)n(olyMaps)
@@ -133445,8 +133608,8 @@ b(The)26 b(length)f(of)g(the)h(v)n(ector)e(is)h(insigni\014can)n(t,)g
(attempting)h(to)g(dra)n(w)e(text)i(or)f(mark)n(ers)e(if)k(the)f(v)n
(ector)e(has)h(zero)f(length.)0 5593 y Fc(T)m(yp)s(e:)227
5693 y Fj(Floating)h(p)r(oin)n(t.)p eop end
-%%Page: 471 481
-TeXDict begin 471 480 bop 3643 52 a FG(471)0 351 y Fc(Class)31
+%%Page: 475 485
+TeXDict begin 475 484 bop 3643 52 a FG(475)0 351 y Fc(Class)31
b(Applicabilit)m(y:)259 493 y(Plot)427 593 y Fj(All)d(Plot3Ds)f(ha)n(v)
n(e)f(this)i(attribute.)p 0 797 3780 12 v 0 936 a FA(NormUnit\(axis\))
1097 929 y Fd(Normalised)36 b(Axis)i(ph)m(ysical)g(units)2841
@@ -133504,8 +133667,8 @@ b(rame)26 b(\(as)h(sp)r(eci\014ed)427 5541 y(b)n(y)j(the)h(Curren)n(t)e
(attribute\).)45 b(The)30 b(Nout)h(attribute)f(v)-5 b(alue)30
b(ma)n(y)g(therefore)f(c)n(hange)g(if)h(a)g(new)g(curren)n(t)427
5641 y(F)-7 b(rame)27 b(is)h(selected.)p eop end
-%%Page: 472 482
-TeXDict begin 472 481 bop 0 52 a FG(472)1994 b Fz(C)91
+%%Page: 476 486
+TeXDict begin 476 485 bop 0 52 a FG(476)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
3780 12 v 0 482 a FA(Nparameter)865 483 y Fd(The)39 b(n)m(um)m(b)s(er)f
(of)g(global)f(parameters)f(in)j(the)1763 598 y(table)3072
@@ -133563,8 +133726,8 @@ b(of)g(all)g(the)h(Plot)e(axes,)h(while)h(a)f Ft(")p
Fj(get)p Ft(")f Fj(or)g Ft(")p Fj(test)p Ft(")h Fj(op)r(eration)427
5621 y(will)k(use)g(just)g(the)g(NumLab\(1\))g(v)-5 b(alue.)p
eop end
-%%Page: 473 483
-TeXDict begin 473 482 bop 3643 52 a FG(473)p 0 351 3780
+%%Page: 477 487
+TeXDict begin 477 486 bop 3643 52 a FG(477)p 0 351 3780
12 v 0 490 a FA(NumLabGap\(axis\))1356 483 y Fd(Spacing)38
b(of)h(n)m(umerical)1479 598 y(lab)s(els)f(for)g(a)g(Plot)2689
490 y FA(NumLabGap\(axis\))0 758 y Fc(Description:)44
@@ -133628,8 +133791,8 @@ y(use)d(it.)37 b(The)28 b(default)g(v)-5 b(alue)27 b(is)h(zero.)0
Fc(Class)j(Applicabilit)m(y:)259 5593 y(F)-8 b(rame)427
5693 y Fj(All)28 b(F)-7 b(rames)27 b(ha)n(v)n(e)g(this)g(attribute.)p
eop end
-%%Page: 474 484
-TeXDict begin 474 483 bop 0 52 a FG(474)1994 b Fz(C)91
+%%Page: 478 488
+TeXDict begin 478 487 bop 0 52 a FG(478)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)259 351
y Fc(Sp)s(ecF)-8 b(rame)427 451 y Fj(T)h(ogether)23 b(with)h(the)g
(ObsLon,)g(Ep)r(o)r(c)n(h,)g(RefRA)g(and)g(RefDec)g(attributes,)h(it)f
@@ -133722,8 +133885,8 @@ Ft(")p Fj(W)p Ft(")g Fj(and)227 5326 y(the)f(n)n(umerical)f(v)-5
b(alue)27 b(is)h(c)n(hosen)f(to)g(b)r(e)h(less)f(than)h(180)e(degrees.)
0 5472 y Fc(T)m(yp)s(e:)227 5572 y Fj(String.)0 5718
y Fc(Class)31 b(Applicabilit)m(y:)p eop end
-%%Page: 475 485
-TeXDict begin 475 484 bop 3643 52 a FG(475)259 351 y
+%%Page: 479 489
+TeXDict begin 479 488 bop 3643 52 a FG(479)259 351 y
Fc(F)-8 b(rame)427 451 y Fj(All)28 b(F)-7 b(rames)27
b(ha)n(v)n(e)g(this)g(attribute.)259 578 y Fc(Sp)s(ecF)-8
b(rame)427 678 y Fj(T)h(ogether)23 b(with)h(the)g(ObsLon,)g(Ep)r(o)r(c)
@@ -133816,8 +133979,8 @@ g(not)g(b)r(een)h(assigned)e(a)h(v)-5 b(alue)36 b(will)f(return)g(the)h
b(A)31 b(default)g(v)-5 b(alue)31 b(of)g(zero)f(is)h(returned)f(for)h
(parameters)e(whic)n(h)i(are)f(not)h(accessed)f(b)n(y)g(the)227
5693 y(pro)5 b(jection.)p eop end
-%%Page: 476 486
-TeXDict begin 476 485 bop 0 52 a FG(476)1994 b Fz(C)91
+%%Page: 480 490
+TeXDict begin 480 489 bop 0 52 a FG(480)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)227 351
y Fj(Note,)g(the)f(FITS-W)n(CS)g(pap)r(er)f(reserv)n(es)f(parameters)g
(1)h(and)h(2)f(on)h(the)g(longitude)g(axis)f(to)g(hold)h(the)g(nativ)n
@@ -133886,8 +134049,8 @@ y(the)j(order)e(of)i(its)g(axes.)36 b(Otherwise,)27 b(it)h(will)f
-7 b(.)227 5693 y(The)28 b(default)g(v)-5 b(alue)27 b(is)h(1,)f(so)g
(that)h(axis)f(p)r(erm)n(utation)g(will)h(b)r(e)g(attempted.)p
eop end
-%%Page: 477 487
-TeXDict begin 477 486 bop 3643 52 a FG(477)0 351 y Fc(T)m(yp)s(e:)227
+%%Page: 481 491
+TeXDict begin 481 490 bop 3643 52 a FG(481)0 351 y Fc(T)m(yp)s(e:)227
451 y Fj(String.)0 600 y Fc(Class)31 b(Applicabilit)m(y:)259
737 y(F)-8 b(rame)427 836 y Fj(All)34 b(F)-7 b(rames)33
b(ha)n(v)n(e)g(this)h(attribute.)55 b(Ho)n(w)n(ev)n(er,)34
@@ -133959,8 +134122,8 @@ y(then)28 b(the)g(distorted)g(T)-7 b(AN)28 b(con)n(v)n(en)n(tion)e(is)h
5407 y Fc(Class)k(Applicabilit)m(y:)259 5544 y(FitsChan)427
5643 y Fj(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)p
eop end
-%%Page: 478 488
-TeXDict begin 478 487 bop 0 52 a FG(478)1994 b Fz(C)91
+%%Page: 482 492
+TeXDict begin 482 491 bop 0 52 a FG(482)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
3780 12 v 0 482 a FA(Preserv)l(eAxes)1518 483 y Fd(Preserv)m(e)37
b(axes?)2986 482 y FA(Preserv)l(eAxes)0 626 y Fc(Description:)44
@@ -134034,8 +134197,8 @@ b(rame's)27 b(Title)i(attribute)g(\(so)f(that)h(t)n(ypically)227
5418 y Fc(Class)k(Applicabilit)m(y:)259 5541 y(SkyF)-8
b(rame)427 5640 y Fj(All)28 b(SkyF)-7 b(rames)27 b(ha)n(v)n(e)f(this)i
(attribute.)p eop end
-%%Page: 479 489
-TeXDict begin 479 488 bop 3643 52 a FG(479)p 0 351 3780
+%%Page: 483 493
+TeXDict begin 483 492 bop 3643 52 a FG(483)p 0 351 3780
12 v 0 483 a FA(RefCoun)l(t)514 b Fd(Coun)m(t)38 b(of)g(activ)m(e)f(Ob)
7 b(ject)38 b(p)s(oin)m(ters)511 b FA(RefCoun)l(t)0 681
y Fc(Description:)44 b Fj(This)20 b(attribute)g(giv)n(es)e(the)i(n)n
@@ -134115,8 +134278,8 @@ Ft(_)p Fj(GETREFPOS)e(ma)n(y)h(b)r(e)h(used)g(to)g(access)e(the)227
(unformatted)g(v)-5 b(alues)28 b(in)f(radians.)227 5693
y(The)h(default)g(for)f(RefRA)h(is)g Ft(")p Fj(0:0:0)p
Ft(")p Fj(.)p eop end
-%%Page: 480 490
-TeXDict begin 480 489 bop 0 52 a FG(480)1994 b Fz(C)91
+%%Page: 484 494
+TeXDict begin 484 493 bop 0 52 a FG(484)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)0 351 y
Fc(T)m(yp)s(e:)227 451 y Fj(String.)0 587 y Fc(Class)g(Applicabilit)m
(y:)259 711 y(Sp)s(ecF)-8 b(rame)427 810 y Fj(All)28
@@ -134179,8 +134342,8 @@ b(,)28 b(it)h(b)r(ecomes)f(unde\014ned)g(in)h(an)n(y)e(external)h
(represen)n(tation)e(of)i(a)g(Mapping)g(pro)r(duced)427
5640 y(b)n(y)g(the)g(AST)p Ft(_)p Fj(WRITE)f(routine.)p
eop end
-%%Page: 481 491
-TeXDict begin 481 490 bop 3643 52 a FG(481)p 0 351 3780
+%%Page: 485 495
+TeXDict begin 485 494 bop 3643 52 a FG(485)p 0 351 3780
12 v 0 483 a FA(Rep)t(ortLev)l(el)1144 490 y Fd(Determines)38
b(whic)m(h)g(read/write)1296 611 y(conditions)f(are)h(rep)s(orted)3057
483 y FA(Rep)t(ortLev)l(el)0 785 y Fc(Description:)44
@@ -134276,8 +134439,8 @@ b(alue)25 b(of)g(this)h(attribute,)g(the)g(returned)f(v)-5
b(alue)26 b(is)f(alw)n(a)n(ys)f(a)h(frequency)g(in)h(units)g(of)f(GHz.)
0 5593 y Fc(T)m(yp)s(e:)227 5693 y Fj(Floating)i(p)r(oin)n(t.)p
eop end
-%%Page: 482 492
-TeXDict begin 482 491 bop 0 52 a FG(482)1994 b Fz(C)91
+%%Page: 486 496
+TeXDict begin 486 495 bop 0 52 a FG(486)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)0 351 y
Fc(Class)g(Applicabilit)m(y:)259 518 y(Sp)s(ecF)-8 b(rame)427
617 y Fj(All)28 b(Sp)r(ecF)-7 b(rames)27 b(ha)n(v)n(e)g(this)h
@@ -134347,8 +134510,8 @@ b(alue)30 b(has)f(b)r(een)h(used\))g(and)f(then)h(use)g(it)g(to)f
y Fc(Class)31 b(Applicabilit)m(y:)259 5512 y(MathMap)427
5612 y Fj(All)d(MathMaps)g(ha)n(v)n(e)e(this)i(attribute.)p
eop end
-%%Page: 483 493
-TeXDict begin 483 492 bop 3643 52 a FG(483)p 0 351 3780
+%%Page: 487 497
+TeXDict begin 487 496 bop 3643 52 a FG(487)p 0 351 3780
12 v 0 483 a FA(SideBand)267 b Fd(Indicates)38 b(whic)m(h)g(sideband)g
(a)g(dual)h(sideband)1378 583 y(sp)s(ectrum)f(represen)m(ts)3221
483 y FA(SideBand)0 772 y Fc(Description:)44 b Fj(This)d(attribute)g
@@ -134425,8 +134588,8 @@ b(If)24 b(the)427 5527 y(MathMap)30 b(is)f(in)n(v)n(erted)g(\(i.e.)44
b(its)30 b(In)n(v)n(ert)f(attribute)h(is)f(non-zero\),)g(then)i(the)f
(role)e(of)i(the)g(SimpFI)h(and)427 5627 y(SimpIF)e(attributes)e(will)h
(b)r(e)g(in)n(terc)n(hanged.)p eop end
-%%Page: 484 494
-TeXDict begin 484 493 bop 0 52 a FG(484)1994 b Fz(C)91
+%%Page: 488 498
+TeXDict begin 488 497 bop 0 52 a FG(488)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
3780 12 v 0 483 a FA(SimpIF)396 b Fd(In)m(v)m(erse-forw)m(ard)36
b(MathMap)i(pairs)g(simplify?)395 b FA(SimpIF)0 684 y
@@ -134500,8 +134663,8 @@ y(the)i(sink)f(function)h(sp)r(eci\014ed)g(when)f(the)h(Channel)f(w)n
(attempt)h(is)g(made)f(to)227 5296 y(get)e(the)g(attribute)f(v)-5
b(alue.)0 5458 y Fc(T)m(yp)s(e:)227 5557 y Fj(String.)0
5718 y Fc(Class)31 b(Applicabilit)m(y:)p eop end
-%%Page: 485 495
-TeXDict begin 485 494 bop 3643 52 a FG(485)259 351 y
+%%Page: 489 499
+TeXDict begin 489 498 bop 3643 52 a FG(489)259 351 y
Fc(FitsChan)427 451 y Fj(When)26 b(the)g(FitsChan)g(is)f(destro)n(y)n
(ed,)f(an)n(y)h(headers)f(in)i(the)g(FitsChan)f(will)h(b)r(e)g(written)
f(out)h(to)f(the)h(sink)427 551 y(\014le,)g(if)g(one)f(is)h(sp)r
@@ -134575,8 +134738,8 @@ b(when)i(creating)e(the)i(KeyMap.)35 b(An)26 b(error)d(will)j(b)r(e)g
5445 y(clear)i(the)h(attribute)g(when)f(the)h(KeyMap)f(con)n(tains)g
(an)n(y)g(en)n(tries.)0 5593 y Fc(T)m(yp)s(e:)227 5693
y Fj(In)n(teger.)p eop end
-%%Page: 486 496
-TeXDict begin 486 495 bop 0 52 a FG(486)1994 b Fz(C)91
+%%Page: 490 500
+TeXDict begin 490 499 bop 0 52 a FG(490)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)0 351 y
Fc(Class)g(Applicabilit)m(y:)259 482 y(KeyMap)427 582
y Fj(All)d(KeyMaps)f(ha)n(v)n(e)f(this)i(attribute.)p
@@ -134647,8 +134810,8 @@ b(alue\).)38 b(The)28 b(same)f(form)g(will)i(b)r(e)f(used)g(when)g
(y:)259 5317 y(SkyF)-8 b(rame)427 5416 y Fj(All)28 b(SkyF)-7
b(rames)27 b(ha)n(v)n(e)f(this)i(attribute.)0 5572 y
Fc(Notes:)p eop end
-%%Page: 487 497
-TeXDict begin 487 496 bop 3643 52 a FG(487)340 351 y
+%%Page: 491 501
+TeXDict begin 491 500 bop 3643 52 a FG(491)340 351 y
Fi(\017)45 b Fj(If)31 b(the)f(System)g(attribute)g(of)g(the)g(SkyF)-7
b(rame)29 b(is)h(c)n(hanged,)g(an)n(y)f(p)r(osition)g(giv)n(en)g(for)h
(SkyRef)g(is)g(trans-)427 451 y(formed)e(in)n(to)f(the)h(new)g(System.)
@@ -134739,8 +134902,8 @@ b(If)34 b(used,)h(it)f(should)f(b)r(e)h(set)f(to)h(hold)f(the)h
(the)f(co)r(ordinate)f(system)g(sp)r(eci\014ed)h(b)n(y)g(the)g(System)g
(attribute.)46 b(The)31 b(o\013set)g(co)r(ordinate)p
eop end
-%%Page: 488 498
-TeXDict begin 488 497 bop 0 52 a FG(488)1994 b Fz(C)91
+%%Page: 492 502
+TeXDict begin 492 501 bop 0 52 a FG(492)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)227 351
y Fj(system)c(represen)n(ted)e(b)n(y)h(the)h(SkyF)-7
b(rame)26 b(will)h(then)g(b)r(e)g(rotated)f(in)h(order)e(to)i(put)g
@@ -134830,8 +134993,8 @@ Fj(:)35 b(The)24 b(k)n(eys)f(are)g(returned)h(in)g(the)h(order)d(in)j
Ft(")p Fj(:)35 b(The)28 b(k)n(eys)f(are)f(returned)h(in)h(alphab)r
(etical)f(order,)g(with)h Ft(")p Fj(A...)p Ft(")f Fj(b)r(eing)h
(returned)f(last.)p eop end
-%%Page: 489 499
-TeXDict begin 489 498 bop 3643 52 a FG(489)340 351 y
+%%Page: 493 503
+TeXDict begin 493 502 bop 3643 52 a FG(493)340 351 y
Fi(\017)45 b Ft(")p Fj(KeyUp)p Ft(")p Fj(:)36 b(The)28
b(k)n(eys)e(are)h(returned)g(in)h(alphab)r(etical)f(order,)f(with)j
Ft(")p Fj(A...)p Ft(")e Fj(b)r(eing)h(returned)f(\014rst.)0
@@ -134893,8 +135056,8 @@ Fj(COPY)g(or)f(AST)p Ft(_)p Fj(SHO)n(W\))i(the)f(SourceFile)427
(output)h(Channel)f(\(i.e.)59 b(the)36 b(v)-5 b(alue)35
b(of)g(the)g(SourceFile)427 5606 y(attribute)28 b(is)g(not)f(copied\).)
p eop end
-%%Page: 490 500
-TeXDict begin 490 499 bop 0 52 a FG(490)1994 b Fz(C)91
+%%Page: 494 504
+TeXDict begin 494 503 bop 0 52 a FG(494)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
3780 12 v 0 482 a FA(SourceSys)754 483 y Fd(Sp)s(ectral)37
b(system)i(in)f(whic)m(h)g(the)h(source)f(v)m(elo)s(cit)m(y)1675
@@ -134959,8 +135122,8 @@ y Fc(T)m(yp)s(e:)227 5159 y Fj(String.)0 5341 y Fc(Class)j
(Applicabilit)m(y:)259 5511 y(Sp)s(ecF)-8 b(rame)427
5610 y Fj(All)28 b(Sp)r(ecF)-7 b(rames)27 b(ha)n(v)n(e)g(this)h
(attribute.)p eop end
-%%Page: 491 501
-TeXDict begin 491 500 bop 3643 52 a FG(491)p 0 351 3780
+%%Page: 495 505
+TeXDict begin 495 504 bop 3643 52 a FG(495)p 0 351 3780
12 v 0 483 a FA(SourceV)-11 b(el)812 b Fd(The)38 b(source)h(v)m(elo)s
(cit)m(y)809 b FA(SourceV)-11 b(el)0 688 y Fc(Description:)44
b Fj(This)39 b(attribute)f(\(together)g(with)h(SourceSys,)h(SourceVRF,)
@@ -135040,8 +135203,8 @@ y(so)e(that)h(refers)f(to)g(the)h(new)g(system,)f(units)h(or)f
y Fj(Floating)g(p)r(oin)n(t.)0 5373 y Fc(Class)k(Applicabilit)m(y:)259
5522 y(Sp)s(ecF)-8 b(rame)427 5621 y Fj(All)28 b(Sp)r(ecF)-7
b(rames)27 b(ha)n(v)n(e)g(this)h(attribute.)p eop end
-%%Page: 492 502
-TeXDict begin 492 501 bop 0 52 a FG(492)1994 b Fz(C)91
+%%Page: 496 506
+TeXDict begin 496 505 bop 0 52 a FG(496)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
3780 12 v 0 483 a FA(Sp)t(ecV)-11 b(al)252 b Fd(The)38
b(sp)s(ectral)g(p)s(osition)f(at)h(whic)m(h)g(\015ux)h(v)-7
@@ -135120,8 +135283,8 @@ b(rame)27 b(to)g(reprsen)n(t)g(absolute)g(times.)340
(returned)f(Region)g(is)g(set)h(in)g(the)f(same)g(w)n(a)n(y)g(as)g(the)
h(TimeOrigin)427 5630 y(attribute)28 b(\(see)g(ab)r(o)n(v)n(e\).)p
eop end
-%%Page: 493 503
-TeXDict begin 493 502 bop 3643 52 a FG(493)p 0 351 3780
+%%Page: 497 507
+TeXDict begin 497 506 bop 3643 52 a FG(497)p 0 351 3780
12 v 0 483 a FA(StcsCo)t(ords)172 b Fd(Return)39 b(the)f(Co)s
(ordinates)e(comp)s(onen)m(t)i(when)1134 598 y(reading)f(an)i(STC-S)f
(do)s(cumen)m(t?)3122 483 y FA(StcsCo)t(ords)0 779 y
@@ -135211,8 +135374,8 @@ f(when)h(an)g(StcsChan)g(is)g(used)g(within)h(F)-7 b(ortran)227
5693 y(co)r(de.)36 b(In)25 b(this)g(case,)g(StcsLength)g(should)g
(usually)f(b)r(e)i(set)f(to)f(the)i(size)e(of)h(the)h(CHARA)n(CTER)f(v)
-5 b(ariable)24 b(used)p eop end
-%%Page: 494 504
-TeXDict begin 494 503 bop 0 52 a FG(494)1994 b Fz(C)91
+%%Page: 498 508
+TeXDict begin 498 507 bop 0 52 a FG(498)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)227 351
y Fj(to)e(receiv)n(e)f(the)h(text)h(returned)e(b)n(y)h(AST)p
Ft(_)p Fj(GETLINE)f(within)i(the)g(sink)f(function.)41
@@ -135274,8 +135437,8 @@ Fj(Helio)p Ft(")p Fj(.)0 5165 y Fc(T)m(yp)s(e:)227 5264
y Fj(String.)0 5427 y Fc(Class)k(Applicabilit)m(y:)259
5577 y(Sp)s(ecF)-8 b(rame)427 5677 y Fj(All)28 b(Sp)r(ecF)-7
b(rames)27 b(ha)n(v)n(e)g(this)h(attribute.)p eop end
-%%Page: 495 505
-TeXDict begin 495 504 bop 3643 52 a FG(495)-2 351 y Fc(Standards)33
+%%Page: 499 509
+TeXDict begin 499 508 bop 3643 52 a FG(499)-2 351 y Fc(Standards)33
b(of)f(Rest)n(:)227 497 y Fj(The)c(Sp)r(ecF)-7 b(rame)27
b(class)g(supp)r(orts)g(the)h(follo)n(wing)f(StdOfRest)h(v)-5
b(alues)27 b(\(all)h(are)e(case-insensitiv)n(e\):)340
@@ -135376,8 +135539,8 @@ f(problems,)j(and)f(a)f(w)n(arning)g(mes-)227 5593 y(sage)d(is)g(added)
h(to)g(the)g(Channel)f(structure.)34 b(Suc)n(h)19 b(messages)e(can)h(b)
r(e)h(retriev)n(ed)f(using)g(the)h(AST)p Ft(_)p Fj(W)-9
b(ARNINGS)227 5693 y(function.)p eop end
-%%Page: 496 506
-TeXDict begin 496 505 bop 0 52 a FG(496)1994 b Fz(C)91
+%%Page: 500 510
+TeXDict begin 500 509 bop 0 52 a FG(500)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)0 351 y
Fc(T)m(yp)s(e:)227 451 y Fj(In)n(teger)c(\(b)r(o)r(olean\).)0
613 y Fc(Class)k(Applicabilit)m(y:)259 763 y(Channel)427
@@ -135440,8 +135603,8 @@ r(ol)h(v)-5 b(alue)27 b(has)h(not)f(b)r(een)h(set)g(for)f(a)g(F)-7
b(rame)27 b(axis,)g(then)h(a)f(suitable)h(default)g(is)f(supplied.)0
5456 y Fc(T)m(yp)s(e:)227 5556 y Fj(String.)0 5718 y
Fc(Class)k(Applicabilit)m(y:)p eop end
-%%Page: 497 507
-TeXDict begin 497 506 bop 3643 52 a FG(497)259 351 y
+%%Page: 501 511
+TeXDict begin 501 510 bop 3643 52 a FG(501)259 351 y
Fc(F)-8 b(rame)427 451 y Fj(The)24 b(default)h(Sym)n(b)r(ol)e(v)-5
b(alue)24 b(supplied)g(b)n(y)g(the)g(F)-7 b(rame)24 b(class)f(is)g(the)
i(string)e Ft(")p Fl(<)p Fj(Domain)p Fl(><)p Fj(n)p Fl(>)p
@@ -135520,8 +135683,8 @@ b(rame)427 5503 y Fj(The)26 b(SkyF)-7 b(rame)25 b(class)f(supp)r(orts)h
(the)h(follo)n(wing)e(System)i(v)-5 b(alues)25 b(and)h(asso)r(ciated)e
(celestial)h(co)r(ordinate)427 5603 y(systems:)p eop
end
-%%Page: 498 508
-TeXDict begin 498 507 bop 0 52 a FG(498)1994 b Fz(C)91
+%%Page: 502 512
+TeXDict begin 502 511 bop 0 52 a FG(502)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)510 351
y Fi(\017)45 b Ft(")p Fj(AZEL)p Ft(")p Fj(:)33 b(Horizon)20
b(co)r(ordinates.)34 b(The)21 b(longitude)g(axis)g(is)g(azim)n(uth)h
@@ -135641,8 +135804,8 @@ Ft(")p Fj(J2000)p Ft(")d Fj(SkyF)-7 b(rame)40 b(will)g(di\013er)h
(x=J2000\))p Ft(")26 b Fj(SkyF)-7 b(rame.)47 b(The)32
b(J2000)d(System)i(need)g(not)g(b)r(e)h(quali\014ed)f(b)n(y)g(an)p
eop end
-%%Page: 499 509
-TeXDict begin 499 508 bop 3643 52 a FG(499)597 351 y
+%%Page: 503 513
+TeXDict begin 503 512 bop 3643 52 a FG(503)597 351 y
Fj(Equino)n(x)27 b(v)-5 b(alue)510 464 y Fi(\017)45 b
Ft(")p Fj(SUPER)n(GALA)n(CTIC)p Ft(")p Fj(:)36 b(De)28
b(V)-7 b(aucouleurs)26 b(Sup)r(ergalactic)h(co)r(ordinates.)510
@@ -135748,8 +135911,8 @@ b(will)h(result)f(in)g(the)h(TimeF)-7 b(rame)35 b(b)r(e-)427
b(rameSet)40 b(in)g(order)f(to)h(re\015ect)f(the)i(c)n(hange)e(in)h
(units)h(\(see)427 5693 y(AST)p Ft(_)p Fj(SET)-7 b(A)n(CTIVEUNIT)28
b(routine)f(for)g(further)g(information\).)p eop end
-%%Page: 500 510
-TeXDict begin 500 509 bop 0 52 a FG(500)1994 b Fz(C)91
+%%Page: 504 514
+TeXDict begin 504 513 bop 0 52 a FG(504)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)259 351
y Fc(FluxF)-8 b(rame)427 451 y Fj(The)30 b(FluxF)-7 b(rame)30
b(class)f(supp)r(orts)g(the)i(follo)n(wing)d(System)j(v)-5
@@ -135868,8 +136031,8 @@ Ft(_)p Fj(READ.)g(Note,)h(curren)n(tly)d(AST)p Ft(_)p
Fj(READ)i(can)f(only)h(handle)227 5693 y(-T)-7 b(AB)28
b(headers)e(that)i(describ)r(e)f(1-dimensional)g(\(i.e.)37
b(separable\))26 b(axes.)p eop end
-%%Page: 501 511
-TeXDict begin 501 510 bop 3643 52 a FG(501)0 351 y Fc(T)m(yp)s(e:)227
+%%Page: 505 515
+TeXDict begin 505 514 bop 3643 52 a FG(505)0 351 y Fc(T)m(yp)s(e:)227
451 y Fj(In)n(teger.)0 596 y Fc(Class)31 b(Applicabilit)m(y:)259
727 y(FitsChan)427 827 y Fj(All)d(FitsChans)g(ha)n(v)n(e)e(this)i
(attribute.)p 0 1017 3780 12 v 0 1155 a FA(T)-11 b(extLab\(axis\))1038
@@ -135944,8 +136107,8 @@ b(v)-5 b(alue)33 b(should)g(b)r(e)h(giv)n(en)f(as)f(a)h(fraction)g(of)g
(the)h(minim)n(um)g(dimension)f(of)g(the)h(plotting)227
5693 y(area,)26 b(the)i(default)g(v)-5 b(alue)28 b(b)r(eing)g(+0.01.)p
eop end
-%%Page: 502 512
-TeXDict begin 502 511 bop 0 52 a FG(502)1994 b Fz(C)91
+%%Page: 506 516
+TeXDict begin 506 515 bop 0 52 a FG(506)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)0 351 y
Fc(T)m(yp)s(e:)227 451 y Fj(Floating)c(p)r(oin)n(t.)0
600 y Fc(Class)k(Applicabilit)m(y:)259 737 y(Plot)427
@@ -136008,8 +136171,8 @@ b(rame)18 b(attribute)227 5058 y(v)-5 b(alues)27 b(are)g(c)n(hanged)g
5457 y Fc(Class)k(Applicabilit)m(y:)259 5593 y(TimeF)-8
b(rame)427 5693 y Fj(All)28 b(TimeF)-7 b(rames)27 b(ha)n(v)n(e)g(this)h
(attribute.)p eop end
-%%Page: 503 513
-TeXDict begin 503 512 bop 3643 52 a FG(503)-2 351 y Fc(Input)33
+%%Page: 507 517
+TeXDict begin 507 516 bop 3643 52 a FG(507)-2 351 y Fc(Input)33
b(F)-8 b(ormats)n(:)227 497 y Fj(The)43 b(formats)f(accepted)h(when)g
(setting)g(a)f(TimeOrigin)g(v)-5 b(alue)43 b(are)f(listed)h(b)r(elo)n
(w.)83 b(They)42 b(are)g(all)h(case-)227 597 y(insensitiv)n(e)27
@@ -136101,8 +136264,8 @@ b(See)27 b(the)h(do)r(cumen)n(tation)f(for)g(the)h(Dut1)g(attribute)g
5280 y Fj(String.)0 5443 y Fc(Class)j(Applicabilit)m(y:)259
5593 y(TimeF)-8 b(rame)427 5693 y Fj(All)28 b(TimeF)-7
b(rames)27 b(ha)n(v)n(e)g(this)h(attribute.)p eop end
-%%Page: 504 514
-TeXDict begin 504 513 bop 0 52 a FG(504)1994 b Fz(C)91
+%%Page: 508 518
+TeXDict begin 508 517 bop 0 52 a FG(508)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)-2 351 y
Fc(Time)g(Scales)n(:)227 497 y Fj(The)d(TimeF)-7 b(rame)27
b(class)g(supp)r(orts)g(the)h(follo)n(wing)e(TimeScale)i(v)-5
@@ -136180,8 +136343,8 @@ Ft(")p Fj(,)d(where)g Fl(<)p Fj(n)p Fl(>)g Fj(is)h(the)g(n)n(um)n(b)r
h(a)f(F)-7 b(rameSet)31 b(is)h(the)g(same)f(as)f(that)i(of)g(its)f
(curren)n(t)g(F)-7 b(rame)31 b(\(as)g(sp)r(eci\014ed)h(b)n(y)427
5672 y(the)c(Curren)n(t)f(attribute\).)p eop end
-%%Page: 505 515
-TeXDict begin 505 514 bop 3643 52 a FG(505)0 351 y Fc(Notes:)340
+%%Page: 509 519
+TeXDict begin 509 518 bop 3643 52 a FG(509)0 351 y Fc(Notes:)340
688 y Fi(\017)45 b Fj(A)28 b(F)-7 b(rame's)26 b(Title)h(is)g(in)n
(tended)h(purely)e(for)h(in)n(terpretation)f(b)n(y)h(h)n(uman)f
(readers)g(and)h(not)g(b)n(y)f(soft)n(w)n(are.)p 0 942
@@ -136228,8 +136391,8 @@ b(alue)28 b(of)f(0.01)g(is)g(used.)0 5022 y Fc(T)m(yp)s(e:)227
5122 y Fj(Floating)g(p)r(oin)n(t.)0 5325 y Fc(Class)k(Applicabilit)m
(y:)259 5516 y(Plot)427 5616 y Fj(All)d(Plots)f(ha)n(v)n(e)g(this)g
(attribute.)p eop end
-%%Page: 506 516
-TeXDict begin 506 515 bop 0 52 a FG(506)1994 b Fz(C)91
+%%Page: 510 520
+TeXDict begin 510 519 bop 0 52 a FG(510)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
3780 12 v 0 483 a FA(T)-11 b(olIn)l(v)l(erse)153 b Fd(T)-10
b(arget)36 b(relativ)m(e)g(error)h(for)g(the)h(iterativ)m(e)d(in)m(v)m
@@ -136286,8 +136449,8 @@ b(ranF)g(orw)n(ard)28 b(attribute)j(v)-5 b(alue)30 b(for)h(a)f(CmpMap)h
(is)f(giv)n(en)g(b)n(y)g(the)h(b)r(o)r(olean)f(AND)i(of)f(the)g(v)-5
b(alue)427 5693 y(for)27 b(eac)n(h)g(comp)r(onen)n(t)g(Mapping.)p
eop end
-%%Page: 507 517
-TeXDict begin 507 516 bop 3643 52 a FG(507)259 351 y
+%%Page: 511 521
+TeXDict begin 511 520 bop 3643 52 a FG(511)259 351 y
Fc(F)-8 b(rameSet)427 451 y Fj(The)31 b(T)-7 b(ranF)g(orw)n(ard)27
b(attribute)k(of)f(a)g(F)-7 b(rameSet)30 b(applies)g(to)g(the)h
(transformation)e(whic)n(h)h(con)n(v)n(erts)f(b)r(e-)427
@@ -136355,8 +136518,8 @@ b(A)n(CTIVEUNIT)30 b(routine)f(con)n(trols)227 5074 y(ho)n(w)e(the)h
5593 y(F)-8 b(rame)427 5693 y Fj(The)28 b(default)g(supplied)g(b)n(y)f
(the)h(F)-7 b(rame)27 b(class)g(is)g(an)h(empt)n(y)f(string.)p
eop end
-%%Page: 508 518
-TeXDict begin 508 517 bop 0 52 a FG(508)1994 b Fz(C)91
+%%Page: 512 522
+TeXDict begin 512 521 bop 0 52 a FG(512)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)259 351
y Fc(SkyF)-8 b(rame)427 451 y Fj(The)35 b(SkyF)-7 b(rame)34
b(class)g(re-de\014nes)g(the)h(default)g(Unit)g(v)-5
@@ -136430,8 +136593,8 @@ b(This)28 b(often)g(considerably)e(impro)n(v)n(es)f(p)r(erformance.)340
(when)i(in)n(terpreting)f(FITS)i(data)e(and)h(is)g(handled)g
(automatically)f(b)n(y)427 5693 y(the)g(FitsChan)g(class.)p
eop end
-%%Page: 509 519
-TeXDict begin 509 518 bop 3643 52 a FG(509)340 351 y
+%%Page: 513 523
+TeXDict begin 513 522 bop 3643 52 a FG(513)340 351 y
Fi(\017)45 b Fj(The)28 b(v)-5 b(alue)27 b(of)g(the)h(UnitRadius)g
(attribute)g(is)f(used)g(only)g(to)h(con)n(trol)e(the)i
(simpli\014cation)f(of)g(Mappings)427 451 y(and)i(has)f(no)h(e\013ect)g
@@ -136511,388 +136674,517 @@ y(ImagF)-7 b(req)25 b(attribute)h(if)g(an)n(y)f(of)h(the)g(follo)n
(wing)f(attributes)g(are)g(required)g(but)h(ha)n(v)n(e)f(not)h(b)r(een)
g(assigned)427 5624 y(a)h(v)-5 b(alue)28 b(explicitly:)37
b(Ep)r(o)r(c)n(h,)27 b(DSBCen)n(tre,)h(IF.)p eop end
-%%Page: 510 520
-TeXDict begin 510 519 bop 0 52 a FG(510)1994 b Fz(C)91
+%%Page: 514 524
+TeXDict begin 514 523 bop 0 52 a FG(514)1994 b Fz(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
-3780 12 v 0 483 a FA(W)-11 b(arnings)345 b Fd(Con)m(trols)36
-b(the)j(issuing)f(of)g(w)m(arnings)f(ab)s(out)1429 598
-y(v)-7 b(arious)38 b(conditions)3224 483 y FA(W)-11 b(arnings)0
-745 y Fc(Description:)44 b Fj(This)27 b(attribute)g(con)n(trols)f(the)h
+3780 12 v 0 483 a FA(V)-11 b(arian)l(t)178 b Fd(Indicates)38
+b(whic)m(h)g(v)-7 b(arian)m(t)36 b(of)j(the)f(curren)m(t)g(F)-10
+b(rame)38 b(is)h(to)1696 583 y(b)s(e)g(used)3343 483
+y FA(V)-11 b(arian)l(t)0 767 y Fc(Description:)44 b Fj(This)24
+b(attribute)g(can)g(b)r(e)g(used)g(to)g(c)n(hange)e(the)j(Mapping)e
+(that)h(connects)g(the)g(curren)n(t)f(F)-7 b(rame)23
+b(to)h(the)227 867 y(other)32 b(F)-7 b(rames)32 b(in)h(the)g(F)-7
+b(rameSet.)51 b(By)32 b(default,)i(eac)n(h)e(F)-7 b(rame)32
+b(in)h(a)f(F)-7 b(rameSet)32 b(is)h(connected)f(to)g(the)h(other)227
+966 y(F)-7 b(rames)21 b(b)n(y)h(a)f(single)g(Mapping)g(that)h(can)g
+(only)f(b)r(e)h(c)n(hanged)f(b)n(y)g(using)h(the)g(AST)p
+Ft(_)p Fj(REMAPFRAME)f(metho)r(d.)227 1066 y(Ho)n(w)n(ev)n(er,)j(it)i
+(is)f(also)f(p)r(ossible)h(to)g(asso)r(ciate)f(m)n(ultiple)i(Mappings)e
+(with)i(a)f(F)-7 b(rame,)25 b(eac)n(h)g(Mapping)g(ha)n(ving)f(an)227
+1165 y(iden)n(tifying)32 b(name.)48 b(If)32 b(this)f(is)h(done,)g(the)g
+Ft(")p Fj(V)-7 b(arian)n(t)p Ft(")29 b Fj(attribute)j(can)f(b)r(e)h
+(set)f(to)g(indicate)h(the)g(name)f(of)g(the)227 1265
+y(Mapping)d(that)f(is)h(to)f(b)r(e)h(used)g(with)g(the)g(curren)n(t)f
+(F)-7 b(rame.)227 1399 y(A)30 b(p)r(ossible)e(\(if)i(unlik)n(ely\))f
+(use-case)f(is)h(to)g(create)f(a)g(F)-7 b(rameSet)29
+b(that)g(can)g(b)r(e)g(used)g(to)g(describ)r(e)g(the)g(W)n(CS)h(of)227
+1499 y(an)k(image)f(formed)g(b)n(y)h(co-adding)f(images)f(of)i(t)n(w)n
+(o)f(di\013eren)n(t)h(parts)f(of)h(the)g(sky)-7 b(.)56
+b(In)34 b(suc)n(h)f(an)h(image,)g(eac)n(h)227 1598 y(pixel)24
+b(con)n(tains)f(\015ux)h(from)g(t)n(w)n(o)f(p)r(oin)n(ts)h(on)g(the)g
+(sky)-7 b(.and)23 b(so)h(the)g(W)n(CS)g(for)g(the)g(image)f(should)h
+(ideally)f(con)n(tain)227 1698 y(one)31 b(pixel)h(F)-7
+b(rame)31 b(and)h(t)n(w)n(o)e(SkyF)-7 b(rames)31 b(-)g(one)g
+(describing)g(eac)n(h)g(of)h(the)f(t)n(w)n(o)g(co-added)g(images.)48
+b(There)31 b(is)227 1798 y(nothing)d(to)h(prev)n(en)n(t)e(a)h(F)-7
+b(rameSet)28 b(con)n(taining)f(t)n(w)n(o)h(explicit)g(SkyF)-7
+b(rames,)28 b(but)h(the)f(problem)g(then)h(arises)e(of)227
+1897 y(ho)n(w)j(to)h(distinguish)f(b)r(et)n(w)n(een)h(them.)46
+b(The)30 b(t)n(w)n(o)g(primary)f(c)n(haracteristics)g(of)h(a)g(F)-7
+b(rame)30 b(that)h(distinguishes)227 1997 y(it)j(from)e(other)h(F)-7
+b(rames)32 b(ar)g(eits)h(class)f(and)h(its)h(Domain)e(attribute)i(v)-5
+b(alue.)53 b(The)33 b(class)f(of)h(a)g(F)-7 b(rame)32
+b(cannot)227 2096 y(b)r(e)40 b(c)n(hanged,)h(but)f(w)n(e)f(could)h(in)f
+(principle)g(use)h(t)n(w)n(o)e(di\013eren)n(t)i(Domain)f(v)-5
+b(alues)39 b(to)g(distinguish)h(the)f(t)n(w)n(o)227 2196
+y(SkyF)-7 b(rames.)69 b(Ho)n(w)n(ev)n(er,)40 b(in)f(practice)f(it)h(is)
+g(not)f(uncommon)h(for)f(application)g(soft)n(w)n(are)f(to)h(assume)g
+(that)227 2296 y(SkyF)-7 b(rames)25 b(will)h(ha)n(v)n(e)f(the)h
+(default)g(Domain)f(v)-5 b(alue)26 b(of)g Ft(")p Fj(SKY)p
+Ft(")p Fj(.)35 b(That)26 b(is,)g(instead)g(of)f(searc)n(hing)f(for)h(F)
+-7 b(rames)227 2395 y(that)25 b(ha)n(v)n(e)d(a)i(class)f(of)h
+Ft(")p Fj(SkyF)-7 b(rame)p Ft(")p Fj(,)23 b(suc)n(h)h(soft)n(w)n(are)e
+(searc)n(hes)g(for)i(F)-7 b(rames)23 b(that)h(ha)n(v)n(e)f(a)g(Domain)h
+(of)g Ft(")p Fj(SKY)p Ft(")p Fj(.)227 2495 y(T)-7 b(o)28
+b(alleviate)g(this)h(problem,)f(it)h(is)f(p)r(ossible)g(to)g(add)h(a)f
+(single)f(SkyF)-7 b(rame)28 b(to)g(the)h(F)-7 b(rameSet,)29
+b(but)g(sp)r(ecifying)227 2595 y(t)n(w)n(o)c(alternate)f(Mappings)h(to)
+g(use)h(with)g(the)f(SkyF)-7 b(rame.)36 b(Setting)25
+b(the)h Ft(")p Fj(V)-7 b(arian)n(t)p Ft(")24 b Fj(attribute)h(to)h(the)
+f(name)h(of)227 2694 y(one)i(or)g(the)h(other)f(of)h(these)f(alternate)
+g(Mappings)g(will)h(cause)e(the)i(SkyF)-7 b(rame)28 b(to)h(b)r(e)g
+(remapp)r(ed)f(within)h(the)227 2794 y(F)-7 b(rameSet)31
+b(so)g(that)g(it)h(uses)e(the)i(sp)r(eci\014ed)f(Mapping.)47
+b(The)32 b(same)e(facilit)n(y)h(can)g(b)r(e)g(used)g(with)h(an)n(y)e
+(class)h(of)227 2893 y(F)-7 b(rame,)27 b(not)h(just)g(SkyF)-7
+b(rames.)227 3027 y(T)g(o)32 b(use)g(this)h(facilit)n(y)-7
+b(,)34 b(the)e(F)-7 b(rame)32 b(should)g(\014rst)h(b)r(e)f(added)h(to)f
+(the)h(F)-7 b(rameSet)32 b(in)g(the)h(usual)f(manner)g(using)227
+3127 y(the)37 b(AST)p Ft(_)p Fj(ADDFRAME)h(metho)r(d.)64
+b(By)37 b(default,)i(the)e(Mapping)f(supplied)h(to)f(AST)p
+Ft(_)p Fj(ADD)n(V)-9 b(ARIANT)39 b(is)227 3227 y(assigned)32
+b(a)g(name)g(equal)h(to)f(the)h(Domain)g(name)f(of)h(the)g(F)-7
+b(rame.)51 b(T)-7 b(o)32 b(assign)g(a)g(di\013eren)n(t)h(name)f(to)h
+(it,)h(the)227 3326 y(AST)p Ft(_)p Fj(ADD)n(V)-9 b(ARIANT)38
+b(metho)r(d)e(should)f(then)i(b)r(e)f(called)f(sp)r(ecifying)h(the)g
+(required)f(name)g(and)h(a)f(NULL)227 3426 y(Mapping.)j(The)28
+b(AST)p Ft(_)p Fj(ADDFRAME)h(metho)r(d)g(should)f(then)g(b)r(e)h
+(called)e(rep)r(eatedly)h(to)g(add)f(eac)n(h)h(required)227
+3526 y(extra)f(Mapping)g(to)h(the)g(curren)n(t)e(F)-7
+b(rame,)28 b(supplying)f(a)g(unique)h(name)f(for)g(eac)n(h)g(one.)227
+3659 y(Eac)n(h)g(F)-7 b(rame)28 b(in)g(a)g(F)-7 b(rameSet)27
+b(can)h(ha)n(v)n(e)f(its)h(o)n(wn)f(set)i(of)f(v)-5 b(arian)n(t)27
+b(Mappings.)37 b(T)-7 b(o)28 b(con)n(trol)e(the)j(Mappings)e(in)227
+3759 y(use)h(with)g(a)f(sp)r(eci\014c)h(F)-7 b(rame,)27
+b(y)n(ou)g(need)g(\014rst)h(to)f(mak)n(e)g(it)h(the)g(curren)n(t)f(F)-7
+b(rame)27 b(in)h(the)g(F)-7 b(rameSet.)227 3893 y(The)33
+b(AST)p Ft(_)p Fj(MIRR)n(OR)-9 b(V)g(ARIANTS)32 b(routine)g(allo)n(ws)f
+(the)i(e\013ects)f(of)g(v)-5 b(arian)n(t)32 b(Mappings)f(asso)r(ciated)
+g(with)i(a)227 3993 y(nominated)28 b(F)-7 b(rame)27 b(to)g(b)r(e)h
+(propagated)e(to)i(other)f(F)-7 b(rames)26 b(in)i(the)g(F)-7
+b(rameSet.)227 4127 y(Once)27 b(this)h(has)e(b)r(een)i(done,)f(setting)
+h(a)f(new)g(v)-5 b(alue)27 b(for)g(the)h Ft(")p Fj(V)-7
+b(arian)n(t)p Ft(")25 b Fj(attribute)j(of)f(a)g(F)-7
+b(rameSet)27 b(will)g(cause)227 4226 y(the)f(curren)n(t)e(F)-7
+b(rame)24 b(in)h(the)g(F)-7 b(rameSet)25 b(to)g(b)r(e)g(remapp)r(ed)g
+(to)g(use)f(the)i(sp)r(eci\014ed)f(v)-5 b(arian)n(t)24
+b(Mapping.)35 b(An)26 b(error)227 4326 y(will)i(b)r(e)g(rep)r(orted)f
+(if)h(the)g(curren)n(t)f(F)-7 b(rame)27 b(has)g(no)g(v)-5
+b(arian)n(t)27 b(Mapping)g(with)h(the)g(supplied)g(name.)227
+4460 y(Getting)d(the)f(v)-5 b(alue)24 b(of)g(the)g Ft(")p
+Fj(V)-7 b(arian)n(t)p Ft(")23 b Fj(attribute)h(will)g(return)f(the)i
+(name)f(of)g(the)g(v)-5 b(arian)n(t)23 b(Mapping)h(curren)n(tly)227
+4559 y(in)i(use)f(with)h(the)g(curren)n(t)f(F)-7 b(rame.)35
+b(If)26 b(the)g(F)-7 b(rame)25 b(has)g(no)g(v)-5 b(arian)n(t)25
+b(Mappings,)g(the)h(v)-5 b(alue)25 b(will)h(default)g(to)f(the)227
+4659 y(Domain)j(name)f(of)h(the)g(curren)n(t)e(F)-7 b(rame.)227
+4793 y(Clearing)27 b(the)h Ft(")p Fj(V)-7 b(arian)n(t)p
+Ft(")27 b Fj(attribute)h(will)g(ha)n(v)n(e)f(the)i(e\013ect)f(of)g
+(remo)n(ving)f(all)g(v)-5 b(arian)n(t)27 b(Mappings)h(\(except)g(for)
+227 4893 y(the)g(curren)n(tly)f(selected)g(Mapping\))h(from)f(the)h
+(curren)n(t)f(F)-7 b(rame.)227 5027 y(T)g(esting)40 b(the)g
+Ft(")p Fj(V)-7 b(arian)n(t)p Ft(")38 b Fj(attribute)i(will)g(return)f
+(.TR)n(UE.)h(if)g(the)h(curren)n(t)d(F)-7 b(rame)40 b(con)n(tains)f(an)
+n(y)g(v)-5 b(arian)n(t)227 5126 y(Mappings,)27 b(and)h(.F)-9
+b(ALSE.)27 b(otherwise.)227 5260 y(A)37 b(complete)g(list)f(of)h(the)g
+(names)f(asso)r(ciated)f(with)i(all)f(the)h(a)n(v)-5
+b(ailable)35 b(v)-5 b(arian)n(t)36 b(Mappings)g(in)h(the)f(curren)n(t)
+227 5360 y(F)-7 b(rame)27 b(can)h(b)r(e)g(obtained)f(from)g(the)h(AllV)
+-7 b(arian)n(ts)27 b(attribute.)227 5494 y(If)h(a)e(F)-7
+b(rame)26 b(with)i(v)-5 b(arian)n(t)26 b(Mappings)g(is)h(remapp)r(ed)f
+(using)h(the)g(AST)p Ft(_)p Fj(REMAPFRAME)f(metho)r(d,)i(the)f(cur-)227
+5593 y(ren)n(tly)e(selected)f(v)-5 b(arian)n(t)24 b(Mapping)g(is)h
+(used)g(b)n(y)f(AST)p Ft(_)p Fj(REMAPFRAME)h(and)f(the)h(other)f(v)-5
+b(arian)n(t)24 b(Mappings)227 5693 y(are)j(remo)n(v)n(ed)f(from)h(the)h
+(F)-7 b(rame.)p eop end
+%%Page: 515 525
+TeXDict begin 515 524 bop 3643 52 a FG(515)0 351 y Fc(T)m(yp)s(e:)227
+451 y Fj(String.)0 630 y Fc(Class)31 b(Applicabilit)m(y:)259
+795 y(F)-8 b(rameSet)427 895 y Fj(All)28 b(F)-7 b(rameSets)27
+b(ha)n(v)n(e)g(this)h(attribute.)p 0 1124 3780 12 v 0
+1255 a FA(W)-11 b(arnings)345 b Fd(Con)m(trols)36 b(the)j(issuing)f(of)
+g(w)m(arnings)f(ab)s(out)1429 1370 y(v)-7 b(arious)38
+b(conditions)3224 1255 y FA(W)-11 b(arnings)0 1565 y
+Fc(Description:)44 b Fj(This)27 b(attribute)g(con)n(trols)f(the)h
(issuing)g(of)f(w)n(arnings)g(ab)r(out)h(selected)f(conditions)h(when)g
-(an)g(Ob)5 b(ject)227 845 y(or)28 b(k)n(eyw)n(ord)f(is)i(read)f(from)h
+(an)g(Ob)5 b(ject)227 1664 y(or)28 b(k)n(eyw)n(ord)f(is)i(read)f(from)h
(or)f(written)h(to)g(a)f(FitsChan.)41 b(The)29 b(v)-5
b(alue)29 b(supplied)g(for)f(the)h(W)-7 b(arnings)28
-b(attribute)227 945 y(should)d(consist)f(of)h(a)g(space)f(separated)g
+b(attribute)227 1764 y(should)d(consist)f(of)h(a)g(space)f(separated)g
(list)h(of)g(condition)g(names)f(\(see)h(the)h(AllW)-7
-b(arnings)24 b(attribute)h(for)g(a)f(list)227 1044 y(of)29
+b(arnings)24 b(attribute)h(for)g(a)f(list)227 1864 y(of)29
b(the)g(curren)n(tly)f(de\014ned)h(names\).)41 b(Eac)n(h)28
b(name)g(indicates)h(a)f(condition)h(whic)n(h)g(should)f(b)r(e)i(rep)r
-(orted.)40 b(The)227 1144 y(default)28 b(v)-5 b(alue)28
+(orted.)40 b(The)227 1963 y(default)28 b(v)-5 b(alue)28
b(for)f(W)-7 b(arnings)27 b(is)g(the)h(string)f Ft(")p
Fj(Tnx)g(Zp)n(x)g(BadCel)g(BadMat)g(BadPV)g(BadCTYPE)p
-Ft(")p Fj(.)227 1264 y(The)e(text)h(of)f(an)n(y)f(w)n(arning)g(will)i
+Ft(")p Fj(.)227 2103 y(The)e(text)h(of)f(an)n(y)f(w)n(arning)g(will)i
(b)r(e)f(stored)f(within)i(the)g(FitsChan)f(in)g(the)h(form)f(of)g(one)
-g(or)f(more)g(new)h(header)227 1364 y(cards)i(with)i(k)n(eyw)n(ord)d
+g(or)f(more)g(new)h(header)227 2202 y(cards)i(with)i(k)n(eyw)n(ord)d
(ASTW)-9 b(ARN.)29 b(If)f(required,)f(applications)g(can)h(c)n(hec)n(k)
-f(the)h(FitsChan)g(for)f(ASTW)-9 b(ARN)227 1463 y(cards)24
+f(the)h(FitsChan)g(for)f(ASTW)-9 b(ARN)227 2302 y(cards)24
b(\(using)h(AST)p Ft(_)p Fj(FINDFITS\))h(after)e(the)i(call)e(to)h(AST)
p Ft(_)p Fj(READ)g(or)f(AST)p Ft(_)p Fj(WRITE)g(has)h(b)r(een)g(p)r
-(erformed,)227 1563 y(and)33 b(rep)r(ort)g(the)g(text)h(of)f(an)n(y)f
+(erformed,)227 2401 y(and)33 b(rep)r(ort)g(the)g(text)h(of)f(an)n(y)f
(suc)n(h)h(cards)f(to)h(the)g(user.)53 b(ASTW)-9 b(ARN)34
b(cards)e(will)i(b)r(e)f(propagated)e(to)i(an)n(y)227
-1662 y(output)28 b(header)f(unless)h(they)f(are)g(deleted)h(from)f(the)
-h(FitsChan)g(using)f(astDelFits.)0 1803 y Fc(T)m(yp)s(e:)227
-1903 y Fj(String)0 2043 y Fc(Class)k(Applicabilit)m(y:)259
-2171 y(FitsChan)427 2270 y Fj(All)d(FitsChans)g(ha)n(v)n(e)e(this)i
-(attribute.)0 2423 y Fc(Notes:)227 2569 y Fj(This)36
+2501 y(output)28 b(header)f(unless)h(they)f(are)g(deleted)h(from)f(the)
+h(FitsChan)g(using)f(astDelFits.)0 2680 y Fc(T)m(yp)s(e:)227
+2780 y Fj(String)0 2958 y Fc(Class)k(Applicabilit)m(y:)259
+3124 y(FitsChan)427 3224 y Fj(All)d(FitsChans)g(ha)n(v)n(e)e(this)i
+(attribute.)0 3415 y Fc(Notes:)227 3561 y Fj(This)36
b(attribute)g(only)g(con)n(trols)e(the)j(w)n(arnings)d(that)i(are)f(to)
h(b)r(e)g(stored)f(as)h(a)f(set)h(of)g(header)f(cards)g(in)h(the)227
-2669 y(FitsChan)d(as)f(describ)r(ed)g(ab)r(o)n(v)n(e.)51
+3661 y(FitsChan)d(as)f(describ)r(ed)g(ab)r(o)n(v)n(e.)51
b(It)33 b(has)f(no)g(e\013ect)h(on)g(the)g(storage)d(of)j(w)n(arnings)e
-(in)i(the)g(paren)n(t)f(Channel)227 2769 y(structure.)i(All)19
+(in)i(the)g(paren)n(t)f(Channel)227 3760 y(structure.)i(All)19
b(w)n(arnings)e(are)h(stored)g(in)h(the)g(paren)n(t)f(Channel)h
(structure,)h(from)f(where)f(they)h(can)g(b)r(e)g(retriev)n(ed)227
-2868 y(using)28 b(the)f(AST)p Ft(_)p Fj(W)-9 b(ARNINGS)29
-b(function.)p 0 3050 V 0 3188 a FA(WcsAxis\(lonlat\))1196
-3180 y Fd(FITS-W)m(CS)39 b(pro)7 b(jection)36 b(axes)2826
-3188 y FA(WcsAxis\(lonlat\))0 3366 y Fc(Description:)44
+3860 y(using)28 b(the)f(AST)p Ft(_)p Fj(W)-9 b(ARNINGS)29
+b(function.)p 0 4089 V 0 4227 a FA(WcsAxis\(lonlat\))1196
+4219 y Fd(FITS-W)m(CS)39 b(pro)7 b(jection)36 b(axes)2826
+4227 y FA(WcsAxis\(lonlat\))0 4452 y Fc(Description:)44
b Fj(This)21 b(attribute)g(giv)n(es)e(the)i(indices)g(of)g(the)g
(longitude)f(and)h(latitude)g(co)r(ordinates)e(of)h(the)h(FITS-W)n(CS)
-227 3465 y(pro)5 b(jection)33 b(within)i(the)g(co)r(ordinate)e(space)g
+227 4551 y(pro)5 b(jection)33 b(within)i(the)g(co)r(ordinate)e(space)g
(used)h(b)n(y)g(a)f(WcsMap.)57 b(These)33 b(indices)h(are)f(de\014ned)i
-(when)f(the)227 3565 y(WcsMap)28 b(is)f(\014rst)g(created)g(using)h
+(when)f(the)227 4651 y(WcsMap)28 b(is)f(\014rst)g(created)g(using)h
(AST)p Ft(_)p Fj(W)n(CSMAP)f(and)h(cannot)f(subsequen)n(tly)g(b)r(e)h
-(altered.)227 3685 y(If)j Ft(")p Fj(lonlat)p Ft(")d Fj(is)i(1,)g(the)h
+(altered.)227 4790 y(If)j Ft(")p Fj(lonlat)p Ft(")d Fj(is)i(1,)g(the)h
(index)f(of)g(the)g(longitude)g(axis)f(is)h(returned.)43
b(Otherwise,)30 b(if)h(it)f(is)g(2,)g(the)g(index)g(of)g(the)227
-3785 y(latitude)e(axis)f(is)h(returned.)0 3925 y Fc(T)m(yp)s(e:)227
-4025 y Fj(In)n(teger,)f(read-only)-7 b(.)0 4165 y Fc(Class)31
-b(Applicabilit)m(y:)259 4293 y(WcsMap)427 4392 y Fj(All)d(WcsMaps)f(ha)
-n(v)n(e)g(this)h(attribute.)p 0 4574 V 0 4705 a FA(WcsT)l(yp)t(e)1193
-4704 y Fd(FITS-W)m(CS)39 b(pro)7 b(jection)36 b(t)m(yp)s(e)3227
-4705 y FA(WcsT)l(yp)t(e)0 4876 y Fc(Description:)44 b
-Fj(This)29 b(attribute)g(sp)r(eci\014es)g(whic)n(h)g(t)n(yp)r(e)g(of)f
-(FITS-W)n(CS)h(pro)5 b(jection)28 b(will)h(b)r(e)g(p)r(erformed)g(b)n
-(y)f(a)h(Wc-)227 4975 y(sMap.)49 b(The)32 b(v)-5 b(alue)32
-b(is)g(sp)r(eci\014ed)g(when)g(a)f(WcsMap)h(is)g(\014rst)f(created)g
-(using)h(AST)p Ft(_)p Fj(W)n(CSMAP)f(and)h(cannot)227
-5075 y(subsequen)n(tly)27 b(b)r(e)h(c)n(hanged.)227 5195
-y(The)36 b(v)-5 b(alues)36 b(used)g(are)f(represen)n(ted)f(b)n(y)i(sym)
-n(b)r(olic)f(constan)n(ts)g(with)i(names)e(of)h(the)g(form)g
-Ft(")p Fj(AST)p Ft(__)p Fj(XXX)p Ft(")p Fj(,)227 5295
-y(where)d Ft(")p Fj(XXX)p Ft(")f Fj(is)h(the)g(\(upp)r(er)g(case\))g
-(3-c)n(haracter)c(co)r(de)k(used)g(b)n(y)f(the)h(FITS-W)n(CS)g
-Ft(")p Fj(CTYPEi)p Ft(")e Fj(k)n(eyw)n(ord)227 5394 y(to)36
-b(iden)n(tify)g(the)g(pro)5 b(jection.)61 b(F)-7 b(or)35
-b(example,)i(p)r(ossible)f(v)-5 b(alues)35 b(are)g(AST)p
-Ft(__)p Fj(T)-7 b(AN)36 b(\(for)f(the)i(tangen)n(t)e(plane)227
-5494 y(or)e(gnomonic)h(pro)5 b(jection\))33 b(and)h(AST)p
-Ft(__)p Fj(AIT)g(\(for)g(the)g(Hammer-Aito\013)g(pro)5
-b(jection\).)56 b(AST)p Ft(__)p Fj(TPN)33 b(is)h(an)227
-5593 y(exception)d(in)g(that)g(it)h(is)f(not)g(part)f(of)h(the)h
-(FITS-W)n(CS)f(standard)f(\(it)h(represen)n(ts)f(a)g(T)-7
-b(AN)32 b(pro)5 b(jection)30 b(with)227 5693 y(p)r(olynomial)d
+4890 y(latitude)e(axis)f(is)h(returned.)0 5069 y Fc(T)m(yp)s(e:)227
+5168 y Fj(In)n(teger,)f(read-only)-7 b(.)0 5347 y Fc(Class)31
+b(Applicabilit)m(y:)259 5513 y(WcsMap)427 5612 y Fj(All)d(WcsMaps)f(ha)
+n(v)n(e)g(this)h(attribute.)p eop end
+%%Page: 516 526
+TeXDict begin 516 525 bop 0 52 a FG(516)1994 b Fz(C)91
+b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
+3780 12 v 0 482 a FA(WcsT)l(yp)t(e)640 b Fd(FITS-W)m(CS)39
+b(pro)7 b(jection)36 b(t)m(yp)s(e)640 b FA(WcsT)l(yp)t(e)0
+690 y Fc(Description:)44 b Fj(This)29 b(attribute)g(sp)r(eci\014es)g
+(whic)n(h)g(t)n(yp)r(e)g(of)f(FITS-W)n(CS)h(pro)5 b(jection)28
+b(will)h(b)r(e)g(p)r(erformed)g(b)n(y)f(a)h(Wc-)227 789
+y(sMap.)49 b(The)32 b(v)-5 b(alue)32 b(is)g(sp)r(eci\014ed)g(when)g(a)f
+(WcsMap)h(is)g(\014rst)f(created)g(using)h(AST)p Ft(_)p
+Fj(W)n(CSMAP)f(and)h(cannot)227 889 y(subsequen)n(tly)27
+b(b)r(e)h(c)n(hanged.)227 1023 y(The)36 b(v)-5 b(alues)36
+b(used)g(are)f(represen)n(ted)f(b)n(y)i(sym)n(b)r(olic)f(constan)n(ts)g
+(with)i(names)e(of)h(the)g(form)g Ft(")p Fj(AST)p Ft(__)p
+Fj(XXX)p Ft(")p Fj(,)227 1123 y(where)d Ft(")p Fj(XXX)p
+Ft(")f Fj(is)h(the)g(\(upp)r(er)g(case\))g(3-c)n(haracter)c(co)r(de)k
+(used)g(b)n(y)f(the)h(FITS-W)n(CS)g Ft(")p Fj(CTYPEi)p
+Ft(")e Fj(k)n(eyw)n(ord)227 1222 y(to)36 b(iden)n(tify)g(the)g(pro)5
+b(jection.)61 b(F)-7 b(or)35 b(example,)i(p)r(ossible)f(v)-5
+b(alues)35 b(are)g(AST)p Ft(__)p Fj(T)-7 b(AN)36 b(\(for)f(the)i
+(tangen)n(t)e(plane)227 1322 y(or)e(gnomonic)h(pro)5
+b(jection\))33 b(and)h(AST)p Ft(__)p Fj(AIT)g(\(for)g(the)g
+(Hammer-Aito\013)g(pro)5 b(jection\).)56 b(AST)p Ft(__)p
+Fj(TPN)33 b(is)h(an)227 1422 y(exception)d(in)g(that)g(it)h(is)f(not)g
+(part)f(of)h(the)h(FITS-W)n(CS)f(standard)f(\(it)h(represen)n(ts)f(a)g
+(T)-7 b(AN)32 b(pro)5 b(jection)30 b(with)227 1521 y(p)r(olynomial)d
(correction)f(terms)h(as)g(de\014ned)h(in)g(an)f(early)g(draft)g(of)h
-(the)g(FITS-W)n(CS)g(pap)r(er\).)p eop end
-%%Page: 511 521
-TeXDict begin 511 520 bop 3643 52 a FG(511)0 351 y Fc(T)m(yp)s(e:)227
-451 y Fj(In)n(teger,)27 b(read-only)-7 b(.)0 599 y Fc(Class)31
-b(Applicabilit)m(y:)259 735 y(WcsMap)427 834 y Fj(All)d(WcsMaps)f(ha)n
-(v)n(e)g(this)h(attribute.)0 995 y Fc(Notes:)340 1277
+(the)g(FITS-W)n(CS)g(pap)r(er\).)0 1690 y Fc(T)m(yp)s(e:)227
+1789 y Fj(In)n(teger,)f(read-only)-7 b(.)0 1958 y Fc(Class)31
+b(Applicabilit)m(y:)259 2113 y(WcsMap)427 2213 y Fj(All)d(WcsMaps)f(ha)
+n(v)n(e)g(this)h(attribute.)0 2394 y Fc(Notes:)340 2695
y Fi(\017)45 b Fj(F)-7 b(or)27 b(a)g(list)h(of)g(a)n(v)-5
b(ailable)26 b(pro)5 b(jections,)27 b(see)g(the)h(FITS-W)n(CS)f(pap)r
-(er.)p 0 1474 3780 12 v 0 1612 a FA(Width\(elemen)l(t\))1131
-1606 y Fd(Line)38 b(width)g(for)g(a)g(Plot)g(elemen)m(t)2840
-1612 y FA(Width\(elemen)l(t\))0 1806 y Fc(Description:)44
+(er.)p 0 2913 V 0 3052 a FA(Width\(elemen)l(t\))1131
+3045 y Fd(Line)38 b(width)g(for)g(a)g(Plot)g(elemen)m(t)2840
+3052 y FA(Width\(elemen)l(t\))0 3266 y Fc(Description:)44
b Fj(This)35 b(attribute)g(determines)g(the)h(line)f(width)g(used)g
(when)g(dra)n(wing)f(eac)n(h)g(elemen)n(t)h(of)g(graphical)227
-1906 y(output)40 b(pro)r(duced)g(b)n(y)f(a)h(Plot.)72
+3366 y(output)40 b(pro)r(duced)g(b)n(y)f(a)h(Plot.)72
b(It)40 b(tak)n(es)f(a)g(separate)f(v)-5 b(alue)40 b(for)f(eac)n(h)g
-(graphical)f(elemen)n(t)i(so)f(that,)k(for)227 2005 y(instance,)28
+(graphical)f(elemen)n(t)i(so)f(that,)k(for)227 3465 y(instance,)28
b(the)h(setting)f Ft(")p Fj(Width\(b)r(order\)=2.0)p
Ft(")f Fj(causes)g(the)h(Plot)g(b)r(order)f(to)h(b)r(e)h(dra)n(wn)e
-(using)h(a)g(line)g(width)227 2105 y(of)g(2.0.)37 b(A)28
+(using)h(a)g(line)g(width)227 3565 y(of)g(2.0.)37 b(A)28
b(v)-5 b(alue)28 b(of)f(1.0)g(results)h(in)g(a)f(line)h(thic)n(kness)f
(whic)n(h)h(is)g(appro)n(ximately)e(0.0005)f(times)k(the)f(length)g(of)
-227 2204 y(the)g(diagonal)e(of)i(the)g(en)n(tire)f(displa)n(y)g
-(surface.)227 2328 y(The)d(actual)f(app)r(earance)g(of)g(lines)h(dra)n
+227 3665 y(the)g(diagonal)e(of)i(the)g(en)n(tire)f(displa)n(y)g
+(surface.)227 3799 y(The)d(actual)f(app)r(earance)g(of)g(lines)h(dra)n
(wn)f(with)h(an)n(y)f(particular)g(width,)i(and)e(the)i(range)d(of)i(a)
-n(v)-5 b(ailable)22 b(widths,)227 2428 y(is)e(determined)g(b)n(y)f(the)
+n(v)-5 b(ailable)22 b(widths,)227 3898 y(is)e(determined)g(b)n(y)f(the)
h(underlying)g(graphics)e(system.)34 b(The)20 b(default)g(b)r(eha)n
(viour)e(is)i(for)f(all)h(graphical)e(elemen)n(ts)227
-2528 y(to)23 b(b)r(e)h(dra)n(wn)e(using)h(the)h(default)g(line)f(width)
+3998 y(to)23 b(b)r(e)h(dra)n(wn)e(using)h(the)h(default)g(line)f(width)
h(supplied)g(b)n(y)f(this)g(graphics)f(system.)35 b(This)23
-b(will)h(not)f(necessarily)227 2627 y(corresp)r(ond)j(to)i(a)f(Width)h
-(v)-5 b(alue)28 b(of)g(1.0.)0 2776 y Fc(T)m(yp)s(e:)227
-2875 y Fj(Floating)f(p)r(oin)n(t.)0 3024 y Fc(Class)k(Applicabilit)m
-(y:)259 3159 y(Plot)427 3259 y Fj(All)d(Plots)f(ha)n(v)n(e)g(this)g
-(attribute.)0 3420 y Fc(Notes:)340 3701 y Fi(\017)45
+b(will)h(not)f(necessarily)227 4097 y(corresp)r(ond)j(to)i(a)f(Width)h
+(v)-5 b(alue)28 b(of)g(1.0.)0 4266 y Fc(T)m(yp)s(e:)227
+4366 y Fj(Floating)f(p)r(oin)n(t.)0 4534 y Fc(Class)k(Applicabilit)m
+(y:)259 4689 y(Plot)427 4789 y Fj(All)d(Plots)f(ha)n(v)n(e)g(this)g
+(attribute.)0 4970 y Fc(Notes:)340 5271 y Fi(\017)45
b Fj(F)-7 b(or)27 b(a)g(list)h(of)g(the)g(graphical)e(elemen)n(ts)h(a)n
(v)-5 b(ailable,)27 b(see)g(the)h(description)f(of)g(the)h(Plot)f
-(class.)340 3833 y Fi(\017)45 b Fj(If)26 b(no)f(graphical)e(elemen)n(t)
+(class.)340 5414 y Fi(\017)45 b Fj(If)26 b(no)f(graphical)e(elemen)n(t)
i(is)g(sp)r(eci\014ed,)h(\(e.g.)36 b Ft(")p Fj(Width)p
Ft(")25 b Fj(instead)g(of)g Ft(")p Fj(Width\(b)r(order\))p
-Ft(")p Fj(\),)h(then)g(a)e Ft(")p Fj(set)p Ft(")427 3933
+Ft(")p Fj(\),)h(then)g(a)e Ft(")p Fj(set)p Ft(")427 5513
y Fj(or)i Ft(")p Fj(clear)p Ft(")f Fj(op)r(eration)h(will)g(a\013ect)h
(the)g(attribute)g(v)-5 b(alue)27 b(of)f(all)h(graphical)e(elemen)n
-(ts,)i(while)g(a)f Ft(")p Fj(get)p Ft(")f Fj(or)427 4032
+(ts,)i(while)g(a)f Ft(")p Fj(get)p Ft(")f Fj(or)427 5613
y Ft(")p Fj(test)p Ft(")i Fj(op)r(eration)g(will)h(use)f(just)h(the)g
-(Width\(Border\))g(v)-5 b(alue.)p 0 4230 V 0 4361 a FA(XmlF)-11
-b(ormat)207 b Fd(System)38 b(for)g(formatting)d(Ob)7
-b(jects)38 b(as)h(XML)207 b FA(XmlF)-11 b(ormat)0 4548
-y Fc(Description:)44 b Fj(This)29 b(attribute)h(sp)r(eci\014es)f(the)g
-(formatting)g(system)g(to)g(use)g(when)g(AST)g(Ob)5 b(jects)29
-b(are)f(written)i(out)227 4648 y(as)24 b(XML)g(through)f(an)h(XmlChan.)
-36 b(It)25 b(a\013ects)f(the)g(b)r(eha)n(viour)f(of)h(the)g(AST)p
-Ft(_)p Fj(WRITE)g(routine)g(when)g(they)h(are)227 4748
-y(used)j(to)f(transfer)g(an)n(y)g(AST)h(Ob)5 b(ject)27
+(Width\(Border\))g(v)-5 b(alue.)p eop end
+%%Page: 517 527
+TeXDict begin 517 526 bop 3643 52 a FG(517)p 0 351 3780
+12 v 0 483 a FA(XmlF)-11 b(ormat)207 b Fd(System)38 b(for)g(formatting)
+d(Ob)7 b(jects)38 b(as)h(XML)207 b FA(XmlF)-11 b(ormat)0
+669 y Fc(Description:)44 b Fj(This)29 b(attribute)h(sp)r(eci\014es)f
+(the)g(formatting)g(system)g(to)g(use)g(when)g(AST)g(Ob)5
+b(jects)29 b(are)f(written)i(out)227 768 y(as)24 b(XML)g(through)f(an)h
+(XmlChan.)36 b(It)25 b(a\013ects)f(the)g(b)r(eha)n(viour)f(of)h(the)g
+(AST)p Ft(_)p Fj(WRITE)g(routine)g(when)g(they)h(are)227
+868 y(used)j(to)f(transfer)g(an)n(y)g(AST)h(Ob)5 b(ject)27
b(to)h(or)e(from)i(an)f(external)g(XML)h(represen)n(tation.)227
-4872 y(The)36 b(XmlChan)h(class)e(allo)n(ws)g(AST)h(ob)5
+992 y(The)36 b(XmlChan)h(class)e(allo)n(ws)g(AST)h(ob)5
b(jects)36 b(to)g(b)r(e)g(represen)n(ted)f(in)i(the)f(form)g(of)g(XML)g
-(in)h(sev)n(eral)d(w)n(a)n(ys)227 4971 y(\(con)n(v)n(en)n(tions\))27
+(in)h(sev)n(eral)d(w)n(a)n(ys)227 1091 y(\(con)n(v)n(en)n(tions\))27
b(and)g(the)i(XmlF)-7 b(ormat)27 b(attribute)h(is)g(used)g(to)f(sp)r
(ecify)h(whic)n(h)g(of)g(these)f(should)h(b)r(e)g(used.)38
-b(The)227 5071 y(formatting)27 b(options)g(a)n(v)-5 b(ailable)27
+b(The)227 1191 y(formatting)27 b(options)g(a)n(v)-5 b(ailable)27
b(are)f(outlined)i(in)g(the)g Ft(")p Fj(F)-7 b(ormats)26
b(Av)-5 b(ailable)p Ft(")27 b Fj(section)g(b)r(elo)n(w.)227
-5195 y(By)35 b(default,)h(an)f(XmlChan)f(will)h(attempt)g(to)g
+1315 y(By)35 b(default,)h(an)f(XmlChan)f(will)h(attempt)g(to)g
(determine)f(whic)n(h)h(format)f(system)g(is)h(already)e(in)i(use,)h
-(and)227 5295 y(will)f(set)f(the)g(default)h(XmlF)-7
+(and)227 1415 y(will)f(set)f(the)g(default)h(XmlF)-7
b(ormat)34 b(v)-5 b(alue)34 b(accordingly)e(\(so)h(that)i(subsequen)n
-(t)f(I/O)f(op)r(erations)g(adopt)g(the)227 5394 y(same)26
+(t)f(I/O)f(op)r(erations)g(adopt)g(the)227 1514 y(same)26
b(con)n(v)n(en)n(tions\).)36 b(It)27 b(do)r(es)f(this)h(b)n(y)g(lo)r
(oking)e(for)i(certain)f(critical)g(items)h(whic)n(h)f(only)h(o)r(ccur)
-f(in)h(particular)227 5494 y(formats.)42 b(F)-7 b(or)29
+f(in)h(particular)227 1614 y(formats.)42 b(F)-7 b(or)29
b(details)h(of)f(ho)n(w)g(this)h(w)n(orks,)e(see)i(the)g
Ft(")p Fj(Choice)e(of)i(Default)g(F)-7 b(ormat)p Ft(")29
-b Fj(section)g(b)r(elo)n(w.)42 b(If)30 b(y)n(ou)227 5593
+b Fj(section)g(b)r(elo)n(w.)42 b(If)30 b(y)n(ou)227 1713
y(wish)h(to)g(ensure)f(that)h(a)f(particular)g(format)g(system)g(is)h
(used,)h(indep)r(enden)n(tly)f(of)g(an)n(y)f(XML)h(already)e(read,)227
-5693 y(y)n(ou)e(should)g(set)h(an)f(explicit)h(XmlF)-7
-b(ormat)28 b(v)-5 b(alue)27 b(y)n(ourself.)p eop end
-%%Page: 512 522
-TeXDict begin 512 521 bop 0 52 a FG(512)1994 b Fz(C)91
-b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)0 351 y
-Fc(T)m(yp)s(e:)227 451 y Fj(String.)0 602 y Fc(Class)g(Applicabilit)m
-(y:)259 740 y(XmlChan)427 839 y Fj(All)d(XmlChans)g(ha)n(v)n(e)e(this)i
-(attribute.)-2 1003 y Fc(F)-8 b(ormats)32 b(Av)-5 b(ailable)n(:)227
-1149 y Fj(The)34 b(XmlF)-7 b(ormat)33 b(attribute)h(can)f(tak)n(e)f(an)
+1813 y(y)n(ou)e(should)g(set)h(an)f(explicit)h(XmlF)-7
+b(ormat)28 b(v)-5 b(alue)27 b(y)n(ourself.)0 1961 y Fc(T)m(yp)s(e:)227
+2061 y Fj(String.)0 2209 y Fc(Class)k(Applicabilit)m(y:)259
+2343 y(XmlChan)427 2443 y Fj(All)d(XmlChans)g(ha)n(v)n(e)e(this)i
+(attribute.)-2 2604 y Fc(F)-8 b(ormats)32 b(Av)-5 b(ailable)n(:)227
+2750 y Fj(The)34 b(XmlF)-7 b(ormat)33 b(attribute)h(can)f(tak)n(e)f(an)
n(y)h(of)g(the)h(follo)n(wing)f(\(case)f(insensitiv)n(e\))i(string)e(v)
--5 b(alues)33 b(to)h(select)227 1248 y(the)28 b(corresp)r(onding)e
-(formatting)h(system:)340 1512 y Fi(\017)45 b Ft(")p
+-5 b(alues)33 b(to)h(select)227 2849 y(the)28 b(corresp)r(onding)e
+(formatting)h(system:)340 3108 y Fi(\017)45 b Ft(")p
Fj(NA)-7 b(TIVE)p Ft(")p Fj(:)34 b(This)23 b(is)g(a)f(direct)h(con)n(v)
n(ersion)e(to)h(XML)i(of)e(the)i(heirarc)n(hical)c(format)j(used)g(b)n
-(y)f(a)h(standard)427 1611 y(XML)28 b(c)n(hannel)f(\(and)h(also)f(b)n
+(y)f(a)h(standard)427 3208 y(XML)28 b(c)n(hannel)f(\(and)h(also)f(b)n
(y)g(the)h(NA)-7 b(TIVE)28 b(enco)r(ding)f(of)h(a)f(FitsChan\).)340
-1745 y Fi(\017)45 b Ft(")p Fj(QUOTED)p Ft(")p Fj(:)35
+3339 y Fi(\017)45 b Ft(")p Fj(QUOTED)p Ft(")p Fj(:)35
b(This)27 b(is)g(the)g(same)f(as)h(NA)-7 b(TIVE)27 b(format)f(except)h
-(that)g(extra)f(information)g(is)h(included)427 1844
+(that)g(extra)f(information)g(is)h(included)427 3439
y(whic)n(h)21 b(allo)n(ws)e(clien)n(t)i(co)r(de)g(to)f(con)n(v)n(ert)f
(the)j(XML)f(in)n(to)f(a)g(form)h(whic)n(h)f(can)h(b)r(e)g(read)f(b)n
-(y)g(a)g(standard)g(AST)427 1944 y(Channel.)37 b(This)26
+(y)g(a)g(standard)g(AST)427 3538 y(Channel.)37 b(This)26
b(extra)g(information)f(indicates)i(whic)n(h)f(AST)h(attribute)f(v)-5
-b(alues)27 b(should)f(b)r(e)h(enclosed)e(in)427 2044
+b(alues)27 b(should)f(b)r(e)h(enclosed)e(in)427 3638
y(quotes)i(b)r(efore)h(b)r(eing)f(passed)g(to)h(a)f(Channel.)340
-2177 y Fi(\017)45 b Ft(")p Fj(IV)n(O)n(A)p Ft(")p Fj(:)63
+3769 y Fi(\017)45 b Ft(")p Fj(IV)n(O)n(A)p Ft(")p Fj(:)63
b(This)40 b(is)h(a)g(format)f(that)h(uses)g(an)g(early)e(draft)i(of)g
(the)g(STC-X)g(sc)n(hema)f(dev)n(elop)r(ed)h(b)n(y)427
-2277 y(the)30 b(In)n(ternational)e(Virtual)h(Observ)-5
+3869 y(the)30 b(In)n(ternational)e(Virtual)h(Observ)-5
b(atory)27 b(Alliance)i(\(IV)n(O)n(A)g(-)g(see)g Ft(")p
Fj(h)n(ttp://www.iv)n(oa.net/)p Ft(")p Fj(\))e(to)i(de-)427
-2376 y(scrib)r(e)38 b(co)r(ordinate)f(systems,)j(regions,)f(mappings,)h
+3968 y(scrib)r(e)38 b(co)r(ordinate)f(systems,)j(regions,)f(mappings,)h
(etc.)68 b(Supp)r(ort)38 b(is)g(limited)g(to)g(V1.20)f(describ)r(ed)427
-2476 y(at)d Ft(")p Fj(h)n(ttp://www.iv)n(oa.net/Do)r(cumen)n
+4068 y(at)d Ft(")p Fj(h)n(ttp://www.iv)n(oa.net/Do)r(cumen)n
(ts/WD/STC/STC-2005022)o(5.h)n(tml)p Ft(")p Fj(.)49 b(Since)34
-b(the)g(v)n(ersion)e(of)427 2576 y(STC-X)i(\014nally)f(adopted)g(b)n(y)
+b(the)g(v)n(ersion)e(of)427 4168 y(STC-X)i(\014nally)f(adopted)g(b)n(y)
h(the)f(IV)n(O)n(A)g(di\013ers)h(in)g(sev)n(eral)d(signi\014can)n(t)i
-(resp)r(ects)g(from)g(V1.20,)h(this)427 2675 y(format)27
+(resp)r(ects)g(from)g(V1.20,)h(this)427 4267 y(format)27
b(is)g(no)n(w)f(mainly)h(of)g(historical)f(in)n(terest.)37
b(Note,)27 b(the)g(alternativ)n(e)f Ft(")p Fj(STC-S)p
-Ft(")g Fj(format)h(\(a)g(simpler)427 2775 y(non-XML)h(enco)r(ding)f(of)
+Ft(")g Fj(format)h(\(a)g(simpler)427 4367 y(non-XML)h(enco)r(ding)f(of)
g(the)h(STC)g(metadata\))f(is)h(supp)r(orted)f(b)n(y)h(the)g(StcsChan)f
-(class.)-2 2938 y Fc(Choice)32 b(of)f(Default)h(F)-8
-b(ormat;)n(:)227 3084 y Fj(If)30 b(the)f(XmlF)-7 b(ormat)29
+(class.)-2 4527 y Fc(Choice)32 b(of)f(Default)h(F)-8
+b(ormat;)n(:)227 4673 y Fj(If)30 b(the)f(XmlF)-7 b(ormat)29
b(attribute)g(of)g(an)f(XmlChan)h(is)g(not)g(set,)g(the)h(default)f(v)
-5 b(alue)29 b(it)g(tak)n(es)f(is)h(determined)g(b)n(y)227
-3184 y(the)h(presence)f(of)g(certain)g(critical)g(items)h(within)g(the)
+4773 y(the)h(presence)f(of)g(certain)g(critical)g(items)h(within)g(the)
g(do)r(cumen)n(t)f(most)h(recen)n(tly)e(read)h(using)g(AST)p
-Ft(_)p Fj(READ.)227 3284 y(The)f(sequence)f(of)h(decision)f(used)g(to)h
+Ft(_)p Fj(READ.)227 4873 y(The)f(sequence)f(of)h(decision)f(used)g(to)h
(arriv)n(e)d(at)j(the)g(default)g(v)-5 b(alue)27 b(is)h(as)f(follo)n
-(ws:)340 3547 y Fi(\017)45 b Fj(If)19 b(the)g(previous)e(do)r(cumen)n
+(ws:)340 5131 y Fi(\017)45 b Fj(If)19 b(the)g(previous)e(do)r(cumen)n
(t)i(read)e(con)n(tained)h(an)n(y)f(elemen)n(ts)i(in)f(an)n(y)g(of)g
(the)h(STC)f(namespaces)g(\()p Ft(")p Fj(urn:n)n(v)n(o-)427
-3646 y(stc)p Ft(")p Fj(,)28 b Ft(")p Fj(urn:n)n(v)n(o-co)r(ords)p
+5231 y(stc)p Ft(")p Fj(,)28 b Ft(")p Fj(urn:n)n(v)n(o-co)r(ords)p
Ft(")23 b Fj(or)k Ft(")p Fj(urn:n)n(v)n(o-region)p Ft(")p
Fj(\),)d(then)k(the)g(default)g(v)-5 b(alue)28 b(is)f(IV)n(O)n(A.)340
-3780 y Fi(\017)45 b Fj(If)30 b(the)f(previous)f(do)r(cumen)n(t)h(read)f
+5362 y Fi(\017)45 b Fj(If)30 b(the)f(previous)f(do)r(cumen)n(t)h(read)f
(con)n(tained)g(an)n(y)g(elemen)n(ts)h(in)g(the)g(AST)g(namespace)f
-(whic)n(h)h(had)g(an)427 3880 y(asso)r(ciated)e(XML)g(attribute)h
+(whic)n(h)h(had)g(an)427 5462 y(asso)r(ciated)e(XML)g(attribute)h
(called)f Ft(")p Fj(quoted)p Ft(")p Fj(,)g(then)h(the)g(default)g(v)-5
-b(alue)28 b(is)f(QUOTED.)340 4013 y Fi(\017)45 b Fj(Otherwise,)31
+b(alue)28 b(is)f(QUOTED.)340 5593 y Fi(\017)45 b Fj(Otherwise,)31
b(if)g(none)g(of)f(these)h(conditions)f(is)h(met)g(\(as)f(w)n(ould)h(b)
r(e)g(the)g(case)f(if)h(no)f(do)r(cumen)n(t)h(had)g(y)n(et)427
-4113 y(b)r(een)d(read\),)f(then)h(NA)-7 b(TIVE)28 b(format)g(is)f
-(used.)227 4276 y(Setting)h(an)g(explicit)f(v)-5 b(alue)28
-b(for)f(the)h(XmlF)-7 b(ormat)27 b(attribute)h(alw)n(a)n(ys)e(o)n(v)n
-(er-rides)f(this)j(default)g(b)r(eha)n(viour.)-2 4427
-y Fc(The)k(IV)m(O)m(A)h(F)-8 b(ormat)n(:)227 4573 y Fj(The)39
-b(IV)n(O)n(A)g(supp)r(ort)g(caters)f(only)h(for)f(certain)h(parts)f(of)
-h(V1.20)g(of)g(the)g(draft)g(Space-Time)g(Co)r(ordinate)227
-4673 y(\(STC\))33 b(sc)n(hema)f(\(see)h(h)n(ttp://www.iv)n(oa.net/Do)r
-(cumen)n(ts/WD/STC/STC-2005022)o(5.h)n(tml\).)46 b(Note,)34
-b(this)227 4773 y(draft)f(has)g(no)n(w)f(b)r(een)i(sup)r(erceded)f(b)n
-(y)g(an)g(o\016cially)f(adopted)h(v)n(ersion)e(that)j(di\013ers)f(in)g
-(sev)n(eral)e(signi\014can)n(t)227 4872 y(resp)r(ects)c(from)h(V1.20.)
-35 b(Consequen)n(tly)-7 b(,)27 b(the)h Ft(")p Fj(IV)n(O)n(A)p
-Ft(")f Fj(XmlChan)h(format)f(is)g(of)h(historical)e(in)n(terest)h(only)
--7 b(.)227 4997 y(The)30 b(follo)n(wing)f(p)r(oin)n(ts)h(should)f(b)r
-(e)h(noted)g(when)g(using)g(an)f(XmlChan)h(to)g(read)f(or)g(write)g
-(STC)h(information)227 5097 y(\(note,)e(this)g(list)g(is)f(curren)n
-(tly)g(incomplete\):)340 5360 y Fi(\017)45 b Fj(Ob)5
-b(jects)27 b(can)h(curren)n(tly)e(only)h(b)r(e)h(read)f(using)g(this)h
-(format,)f(not)h(written.)340 5494 y Fi(\017)45 b Fj(The)23
-b(AST)f(ob)5 b(ject)22 b(generated)f(b)n(y)h(reading)f(an)h
-Fl(<)p Fj(STCMetadata)p Fl(>)f Fj(elemen)n(t)h(will)g(b)r(e)h(an)f
-(instance)g(of)g(one)427 5593 y(of)27 b(the)h(AST)g Ft(")p
-Fj(Stc)p Ft(")f Fj(classes:)35 b(StcResourcePro\014le,)25
-b(StcSearc)n(hLo)r(cation,)h(StcCatalogEn)n(tryLo)r(cation,)427
-5693 y(StcObsDataLo)r(cation.)p eop end
-%%Page: 513 523
-TeXDict begin 513 522 bop 3643 52 a FG(513)340 351 y
-Fi(\017)45 b Fj(When)27 b(reading)f(an)g Fl(<)p Fj(STCMetadata)p
-Fl(>)f Fj(elemen)n(t,)i(the)g(axes)f(in)h(the)g(returned)f(AST)h(Ob)5
-b(ject)26 b(will)h(b)r(e)g(in)427 451 y(the)j(order)e(space,)g(time,)j
-(sp)r(ectral,)e(redshift,)g(irresp)r(ectiv)n(e)f(of)h(the)h(order)e(in)
-h(whic)n(h)g(the)h(axes)e(o)r(ccur)g(in)427 551 y(the)34
-b Fl(<)p Fj(STCMetadata)p Fl(>)e Fj(elemen)n(t.)53 b(If)34
-b(the)g(supplied)f Fl(<)p Fj(STCMetadata)p Fl(>)f Fj(elemen)n(t)h(do)r
-(es)g(not)g(con)n(tain)427 650 y(all)h(of)h(these)f(axes,)i(the)f
-(returned)f(AST)h(Ob)5 b(ject)34 b(will)h(also)e(omit)i(them,)i(but)e
-(the)g(ordering)e(of)h(those)427 750 y(axes)h(whic)n(h)h(are)f(presen)n
-(t)g(will)i(b)r(e)f(as)f(stated)h(ab)r(o)n(v)n(e.)61
-b(If)36 b(the)g(spatial)g(frame)f(represen)n(ts)g(a)g(celestial)427
-849 y(co)r(ordinate)27 b(system)g(the)h(spatial)f(axes)g(will)g(b)r(e)h
-(in)g(the)g(order)f(\(longitude,)g(latitude\).)340 971
-y Fi(\017)45 b Fj(Un)n(til)25 b(suc)n(h)g(time)g(as)f(the)h(AST)g
-(TimeF)-7 b(rame)24 b(is)g(complete,)h(a)g(simple)f(1-dimensional)g(F)
--7 b(rame)24 b(\(with)h(Do-)427 1070 y(main)g(set)f(to)g(TIME\))g(will)
-h(b)r(e)g(used)f(to)g(represen)n(t)f(the)i(STC)f Fl(<)p
+5693 y(b)r(een)d(read\),)f(then)h(NA)-7 b(TIVE)28 b(format)g(is)f
+(used.)p eop end
+%%Page: 518 528
+TeXDict begin 518 527 bop 0 52 a FG(518)1994 b Fz(C)91
+b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)227 351
+y Fj(Setting)d(an)g(explicit)f(v)-5 b(alue)28 b(for)f(the)h(XmlF)-7
+b(ormat)27 b(attribute)h(alw)n(a)n(ys)e(o)n(v)n(er-rides)f(this)j
+(default)g(b)r(eha)n(viour.)-2 516 y Fc(The)k(IV)m(O)m(A)h(F)-8
+b(ormat)n(:)227 662 y Fj(The)39 b(IV)n(O)n(A)g(supp)r(ort)g(caters)f
+(only)h(for)f(certain)h(parts)f(of)h(V1.20)g(of)g(the)g(draft)g
+(Space-Time)g(Co)r(ordinate)227 762 y(\(STC\))33 b(sc)n(hema)f(\(see)h
+(h)n(ttp://www.iv)n(oa.net/Do)r(cumen)n(ts/WD/STC/STC-2005022)o(5.h)n
+(tml\).)46 b(Note,)34 b(this)227 861 y(draft)f(has)g(no)n(w)f(b)r(een)i
+(sup)r(erceded)f(b)n(y)g(an)g(o\016cially)f(adopted)h(v)n(ersion)e
+(that)j(di\013ers)f(in)g(sev)n(eral)e(signi\014can)n(t)227
+961 y(resp)r(ects)c(from)h(V1.20.)35 b(Consequen)n(tly)-7
+b(,)27 b(the)h Ft(")p Fj(IV)n(O)n(A)p Ft(")f Fj(XmlChan)h(format)f(is)g
+(of)h(historical)e(in)n(terest)h(only)-7 b(.)227 1093
+y(The)30 b(follo)n(wing)f(p)r(oin)n(ts)h(should)f(b)r(e)h(noted)g(when)
+g(using)g(an)f(XmlChan)h(to)g(read)f(or)g(write)g(STC)h(information)227
+1192 y(\(note,)e(this)g(list)g(is)f(curren)n(tly)g(incomplete\):)340
+1476 y Fi(\017)45 b Fj(Ob)5 b(jects)27 b(can)h(curren)n(tly)e(only)h(b)
+r(e)h(read)f(using)g(this)h(format,)f(not)h(written.)340
+1616 y Fi(\017)45 b Fj(The)23 b(AST)f(ob)5 b(ject)22
+b(generated)f(b)n(y)h(reading)f(an)h Fl(<)p Fj(STCMetadata)p
+Fl(>)f Fj(elemen)n(t)h(will)g(b)r(e)h(an)f(instance)g(of)g(one)427
+1716 y(of)27 b(the)h(AST)g Ft(")p Fj(Stc)p Ft(")f Fj(classes:)35
+b(StcResourcePro\014le,)25 b(StcSearc)n(hLo)r(cation,)h(StcCatalogEn)n
+(tryLo)r(cation,)427 1816 y(StcObsDataLo)r(cation.)340
+1956 y Fi(\017)45 b Fj(When)27 b(reading)f(an)g Fl(<)p
+Fj(STCMetadata)p Fl(>)f Fj(elemen)n(t,)i(the)g(axes)f(in)h(the)g
+(returned)f(AST)h(Ob)5 b(ject)26 b(will)h(b)r(e)g(in)427
+2056 y(the)j(order)e(space,)g(time,)j(sp)r(ectral,)e(redshift,)g
+(irresp)r(ectiv)n(e)f(of)h(the)h(order)e(in)h(whic)n(h)g(the)h(axes)e
+(o)r(ccur)g(in)427 2155 y(the)34 b Fl(<)p Fj(STCMetadata)p
+Fl(>)e Fj(elemen)n(t.)53 b(If)34 b(the)g(supplied)f Fl(<)p
+Fj(STCMetadata)p Fl(>)f Fj(elemen)n(t)h(do)r(es)g(not)g(con)n(tain)427
+2255 y(all)h(of)h(these)f(axes,)i(the)f(returned)f(AST)h(Ob)5
+b(ject)34 b(will)h(also)e(omit)i(them,)i(but)e(the)g(ordering)e(of)h
+(those)427 2355 y(axes)h(whic)n(h)h(are)f(presen)n(t)g(will)i(b)r(e)f
+(as)f(stated)h(ab)r(o)n(v)n(e.)61 b(If)36 b(the)g(spatial)g(frame)f
+(represen)n(ts)g(a)g(celestial)427 2454 y(co)r(ordinate)27
+b(system)g(the)h(spatial)f(axes)g(will)g(b)r(e)h(in)g(the)g(order)f
+(\(longitude,)g(latitude\).)340 2595 y Fi(\017)45 b Fj(Un)n(til)25
+b(suc)n(h)g(time)g(as)f(the)h(AST)g(TimeF)-7 b(rame)24
+b(is)g(complete,)h(a)g(simple)f(1-dimensional)g(F)-7
+b(rame)24 b(\(with)h(Do-)427 2694 y(main)g(set)f(to)g(TIME\))g(will)h
+(b)r(e)g(used)f(to)g(represen)n(t)f(the)i(STC)f Fl(<)p
Fj(TimeF)-7 b(rame)p Fl(>)23 b Fj(elemen)n(t.)36 b(Consequen)n(tly)-7
-b(,)427 1170 y(most)28 b(of)f(the)h(information)f(within)h(a)g
+b(,)427 2794 y(most)28 b(of)f(the)h(information)f(within)h(a)g
Fl(<)p Fj(TimeF)-7 b(rame)p Fl(>)26 b Fj(elemen)n(t)i(is)f(curren)n
-(tly)g(ignored.)340 1291 y Fi(\017)45 b Fl(<)p Fj(SpaceF)-7
+(tly)g(ignored.)340 2934 y Fi(\017)45 b Fl(<)p Fj(SpaceF)-7
b(rame)p Fl(>)27 b Fj(elemen)n(ts)i(can)f(only)g(b)r(e)h(read)f(if)h
(they)g(describ)r(e)g(a)f(celestial)g(longitude)h(and)f(latitude)427
-1391 y(axes)33 b(supp)r(orted)g(b)n(y)g(the)h(AST)f(SkyF)-7
+3034 y(axes)33 b(supp)r(orted)g(b)n(y)g(the)h(AST)f(SkyF)-7
b(rame)33 b(class.)53 b(The)33 b(space)g(axes)f(will)i(b)r(e)g
-(returned)f(in)g(the)h(order)427 1491 y(\(longitude,)28
-b(latitude\).)340 1612 y Fi(\017)45 b Fj(V)-7 b(elo)r(cities)28
+(returned)f(in)g(the)h(order)427 3133 y(\(longitude,)28
+b(latitude\).)340 3274 y Fi(\017)45 b Fj(V)-7 b(elo)r(cities)28
b(asso)r(ciated)e(with)i(SpaceF)-7 b(rames)27 b(cannot)g(b)r(e)h(read.)
-340 1734 y Fi(\017)45 b Fj(An)n(y)23 b Fl(<)p Fj(GenericCo)r(ordF)-7
+340 3414 y Fi(\017)45 b Fj(An)n(y)23 b Fl(<)p Fj(GenericCo)r(ordF)-7
b(rame)p Fl(>)19 b Fj(elemen)n(ts)k(within)g(an)f Fl(<)p
Fj(AstroCo)r(ordSystem)p Fl(>)e Fj(elemen)n(t)j(are)f(curren)n(tly)427
-1833 y(ignored.)340 1955 y Fi(\017)45 b Fj(An)n(y)29
+3514 y(ignored.)340 3654 y Fi(\017)45 b Fj(An)n(y)29
b(second)e(or)h(subsequen)n(t)g Fl(<)p Fj(AstroCo)r(ordSystem)p
Fl(>)e Fj(found)j(within)g(an)f(STCMetaData)g(elemen)n(t)h(is)427
-2054 y(ignored.)340 2176 y Fi(\017)45 b Fj(An)n(y)37
+3754 y(ignored.)340 3894 y Fi(\017)45 b Fj(An)n(y)37
b(second)g(or)f(subsequen)n(t)h Fl(<)p Fj(AstroCo)r(ordArea)p
Fl(>)d Fj(found)k(within)g(an)f(STCMetaData)f(elemen)n(t)i(is)427
-2275 y(ignored.)340 2397 y Fi(\017)45 b Fj(An)n(y)28
+3994 y(ignored.)340 4134 y Fi(\017)45 b Fj(An)n(y)28
b Fl(<)p Fj(O\013setCen)n(ter)p Fl(>)e Fj(found)i(within)g(a)f
Fl(<)p Fj(SpaceF)-7 b(rame)p Fl(>)26 b Fj(is)i(ignored.)340
-2518 y Fi(\017)45 b Fj(An)n(y)28 b(Co)r(ordFla)n(v)n(or)c(elemen)n(t)k
+4275 y Fi(\017)45 b Fj(An)n(y)28 b(Co)r(ordFla)n(v)n(or)c(elemen)n(t)k
(found)g(within)g(a)g Fl(<)p Fj(SpaceF)-7 b(rame)p Fl(>)25
-b Fj(is)j(ignored.)340 2640 y Fi(\017)45 b Fl(<)p Fj(SpaceF)-7
+b Fj(is)j(ignored.)340 4415 y Fi(\017)45 b Fl(<)p Fj(SpaceF)-7
b(rame)p Fl(>)23 b Fj(elemen)n(ts)h(can)g(only)f(b)r(e)i(read)e(if)i
(they)g(refer)e(to)h(one)g(of)g(the)h(follo)n(wing)e(space)h(reference)
-427 2739 y(frames:)36 b(ICRS,)28 b(GALA)n(CTIC)p Ft(_)p
+427 4515 y(frames:)36 b(ICRS,)28 b(GALA)n(CTIC)p Ft(_)p
Fj(I)r(I,)g(SUPER)p Ft(_)p Fj(GALA)n(CTIC,)f(HEE,)g(FK4,)g(FK5,)g
-(ECLIPTIC.)340 2861 y Fi(\017)45 b Fl(<)p Fj(SpaceF)-7
+(ECLIPTIC.)340 4655 y Fi(\017)45 b Fl(<)p Fj(SpaceF)-7
b(rame)p Fl(>)25 b Fj(elemen)n(ts)h(can)g(only)g(b)r(e)h(read)f(if)h
(the)f(reference)g(p)r(osition)g(is)g(TOPOCENTER.)f(Also,)427
-2960 y(an)n(y)i(planetary)g(ephemeris)g(is)g(ignored.)340
-3082 y Fi(\017)45 b Fj(Regions:)36 b(there)26 b(is)g(curren)n(tly)g(no)
+4755 y(an)n(y)i(planetary)g(ephemeris)g(is)g(ignored.)340
+4895 y Fi(\017)45 b Fj(Regions:)36 b(there)26 b(is)g(curren)n(tly)g(no)
g(supp)r(ort)g(for)g(STC)h(regions)e(of)h(t)n(yp)r(e)h(Sector,)f(Con)n
-(v)n(exHull)f(or)h(SkyIn-)427 3181 y(dex.)340 3303 y
+(v)n(exHull)f(or)h(SkyIn-)427 4995 y(dex.)340 5135 y
Fi(\017)45 b Fj(The)34 b(AST)g(Region)e(read)h(from)g(a)g(Co)r(ordIn)n
(terv)-5 b(al)32 b(elemen)n(t)h(is)h(considered)e(to)i(b)r(e)f(op)r(en)
-h(if)g(either)f(the)427 3402 y(lo)p Ft(_)p Fj(include)27
+h(if)g(either)f(the)427 5235 y(lo)p Ft(_)p Fj(include)27
b(or)g(the)h(hi)p Ft(_)p Fj(include)g(attribute)g(is)f(set)h(to)f
-(false.)340 3524 y Fi(\017)45 b Fl(<)p Fj(RegionFile)p
+(false.)340 5375 y Fi(\017)45 b Fl(<)p Fj(RegionFile)p
Fl(>)27 b Fj(elemen)n(ts)g(are)g(not)g(supp)r(orted.)340
-3645 y Fi(\017)45 b Fj(V)-7 b(ertices)33 b(within)h Fl(<)p
+5515 y Fi(\017)45 b Fj(V)-7 b(ertices)33 b(within)h Fl(<)p
Fj(P)n(olygon)p Fl(>)c Fj(elemen)n(ts)k(are)e(alw)n(a)n(ys)f
(considered)h(to)h(b)r(e)h(joined)g(using)e(great)g(circles)427
-3745 y(\(that)c(is,)g Fl(<)p Fj(SmallCircle)p Fl(>)e
-Fj(elemen)n(ts)i(are)e(ignored\).)p 0 3921 3780 12 v
-0 4053 a FA(XmlLength)473 b Fd(Con)m(trols)36 b(output)i(bu\013er)h
-(length)471 b FA(XmlLength)0 4219 y Fc(Description:)44
+5615 y(\(that)c(is,)g Fl(<)p Fj(SmallCircle)p Fl(>)e
+Fj(elemen)n(ts)i(are)e(ignored\).)p eop end
+%%Page: 519 529
+TeXDict begin 519 528 bop 3643 52 a FG(519)p 0 351 3780
+12 v 0 483 a FA(XmlLength)473 b Fd(Con)m(trols)36 b(output)i(bu\013er)h
+(length)471 b FA(XmlLength)0 653 y Fc(Description:)44
b Fj(This)34 b(attribute)h(sp)r(eci\014es)e(the)i(maxim)n(um)f(length)g
(to)g(use)g(when)g(writing)f(out)i(text)f(through)f(the)227
-4319 y(sink)28 b(function)g(supplied)g(when)g(the)g(XmlChan)f(w)n(as)g
-(created.)227 4437 y(The)h(n)n(um)n(b)r(er)g(of)g(c)n(haracters)d(in)j
+753 y(sink)28 b(function)g(supplied)g(when)g(the)g(XmlChan)f(w)n(as)g
+(created.)227 872 y(The)h(n)n(um)n(b)r(er)g(of)g(c)n(haracters)d(in)j
(eac)n(h)f(string)h(written)g(out)g(through)f(the)h(sink)g(function)g
-(will)g(not)g(b)r(e)g(greater)227 4537 y(than)g(the)g(v)-5
+(will)g(not)g(b)r(e)g(greater)227 972 y(than)g(the)g(v)-5
b(alue)27 b(of)h(this)g(attribute)g(\(but)g(ma)n(y)f(b)r(e)h(less\).)37
b(A)28 b(v)-5 b(alue)27 b(of)h(zero)e(\(the)j(default\))f(means)f
-(there)g(is)h(no)227 4637 y(limit)h(-)e(eac)n(h)g(string)g(can)g(b)r(e)
-h(of)f(an)n(y)g(length.)227 4755 y(Note,)40 b(the)d(default)h(v)-5
+(there)g(is)h(no)227 1072 y(limit)h(-)e(eac)n(h)g(string)g(can)g(b)r(e)
+h(of)f(an)n(y)g(length.)227 1192 y(Note,)40 b(the)d(default)h(v)-5
b(alue)37 b(of)g(zero)e(is)i(unlik)n(ely)g(to)g(b)r(e)g(appropriate)f
-(when)h(an)g(XmlChan)g(is)g(used)g(within)227 4855 y(F)-7
+(when)h(an)g(XmlChan)g(is)g(used)g(within)227 1291 y(F)-7
b(ortran)36 b(co)r(de.)63 b(In)37 b(this)f(case,)i(XmlLength)f(should)f
(usually)g(b)r(e)h(set)g(to)f(the)h(size)f(of)h(the)f(CHARA)n(CTER)227
-4955 y(v)-5 b(ariable)22 b(used)i(to)f(receiv)n(e)f(the)h(text)h
+1391 y(v)-5 b(ariable)22 b(used)i(to)f(receiv)n(e)f(the)h(text)h
(returned)e(b)n(y)h(AST)p Ft(_)p Fj(GETLINE)g(within)h(the)f(sink)g
-(function.)36 b(This)23 b(a)n(v)n(oids)227 5054 y(the)28
+(function.)36 b(This)23 b(a)n(v)n(oids)227 1490 y(the)28
b(p)r(ossibilit)n(y)g(of)f(long)g(lines)h(b)r(eing)f(truncated)h(in)n
-(visibly)f(within)h(AST)p Ft(_)p Fj(GETLINE.)0 5192 y
-Fc(T)m(yp)s(e:)227 5292 y Fj(In)n(teger.)0 5430 y Fc(Class)j
-(Applicabilit)m(y:)259 5555 y(XmlChan)427 5655 y Fj(All)d(XmlChans)g
-(ha)n(v)n(e)e(this)i(attribute.)p eop end
-%%Page: 514 524
-TeXDict begin 514 523 bop 0 52 a FG(514)1994 b Fz(C)91
-b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
-3780 12 v 0 483 a FA(XmlPre\014x)200 b Fd(The)38 b(namespace)g
-(pre\014x)h(to)f(use)h(when)g(writing)197 b FA(XmlPre\014x)0
-672 y Fc(Description:)44 b Fj(This)22 b(attribute)h(is)f(a)g(string)f
-(whic)n(h)h(is)g(to)g(b)r(e)h(used)f(as)f(the)i(namespace)e(pre\014x)h
-(for)f(all)h(XML)h(elemen)n(ts)227 771 y(created)k(as)g(a)g(result)g
-(of)h(writing)f(an)g(AST)h(Ob)5 b(ject)28 b(out)f(through)g(an)g
-(XmlChan.)37 b(The)28 b(URI)g(asso)r(ciated)e(with)227
-871 y(the)33 b(namespace)e(pre\014x)h(is)g(giv)n(en)g(b)n(y)f(the)i
-(sym)n(b)r(olic)f(constan)n(t)f(AST)p Ft(__)p Fj(XMLNS)i(de\014ned)f
-(in)h(AST)p Ft(_)p Fj(P)-7 b(AR.)32 b(A)227 971 y(de\014nition)26
-b(of)e(the)i(namespace)e(pre\014x)g(is)h(included)g(in)h(eac)n(h)e
-(top-lev)n(el)g(elemen)n(t)h(pro)r(duced)f(b)n(y)h(the)g(XmlChan.)227
-1095 y(The)31 b(default)g(v)-5 b(alue)30 b(is)g(a)g(blank)h(string)e
-(whic)n(h)i(causes)e(no)h(pre\014x)g(to)h(b)r(e)f(used.)46
-b(In)31 b(this)f(case)g(eac)n(h)g(top-lev)n(el)227 1195
-y(elemen)n(t)e(will)g(set)f(the)h(default)g(namespace)f(to)g(b)r(e)h
-(the)g(v)-5 b(alue)28 b(of)g(AST)p Ft(__)p Fj(XMLNS.)0
-1344 y Fc(T)m(yp)s(e:)227 1444 y Fj(String.)0 1593 y
-Fc(Class)j(Applicabilit)m(y:)259 1730 y(Ob)5 b(ject)427
-1829 y Fj(All)28 b(Ob)5 b(jects)28 b(ha)n(v)n(e)e(this)i(attribute.)p
-0 2029 V 0 2159 a FA(Zo)t(om)1322 2160 y Fd(Zo)s(omMap)37
-b(scale)i(factor)3447 2159 y FA(Zo)t(om)0 2349 y Fc(Description:)44
-b Fj(This)24 b(attribute)g(holds)g(the)g(Zo)r(omMap)f(scale)g(factor,)h
-(b)n(y)g(whic)n(h)g(co)r(ordinate)e(v)-5 b(alues)24 b(are)f(m)n
-(ultiplied)227 2449 y(\(b)n(y)g(the)h(forw)n(ard)d(transformation\))g
-(or)h(divided)i(\(b)n(y)f(the)g(in)n(v)n(erse)f(transformation\).)34
-b(This)22 b(factor)h(is)f(set)h(when)227 2548 y(a)k(Zo)r(omMap)g(is)h
+(visibly)f(within)h(AST)p Ft(_)p Fj(GETLINE.)0 1630 y
+Fc(T)m(yp)s(e:)227 1730 y Fj(In)n(teger.)0 1870 y Fc(Class)j
+(Applicabilit)m(y:)259 1997 y(XmlChan)427 2097 y Fj(All)d(XmlChans)g
+(ha)n(v)n(e)e(this)i(attribute.)p 0 2277 V 0 2409 a FA(XmlPre\014x)200
+b Fd(The)38 b(namespace)g(pre\014x)h(to)f(use)h(when)g(writing)197
+b FA(XmlPre\014x)0 2579 y Fc(Description:)44 b Fj(This)22
+b(attribute)h(is)f(a)g(string)f(whic)n(h)h(is)g(to)g(b)r(e)h(used)f(as)
+f(the)i(namespace)e(pre\014x)h(for)f(all)h(XML)h(elemen)n(ts)227
+2679 y(created)k(as)g(a)g(result)g(of)h(writing)f(an)g(AST)h(Ob)5
+b(ject)28 b(out)f(through)g(an)g(XmlChan.)37 b(The)28
+b(URI)g(asso)r(ciated)e(with)227 2778 y(the)33 b(namespace)e(pre\014x)h
+(is)g(giv)n(en)g(b)n(y)f(the)i(sym)n(b)r(olic)f(constan)n(t)f(AST)p
+Ft(__)p Fj(XMLNS)i(de\014ned)f(in)h(AST)p Ft(_)p Fj(P)-7
+b(AR.)32 b(A)227 2878 y(de\014nition)26 b(of)e(the)i(namespace)e
+(pre\014x)g(is)h(included)g(in)h(eac)n(h)e(top-lev)n(el)g(elemen)n(t)h
+(pro)r(duced)f(b)n(y)h(the)g(XmlChan.)227 2998 y(The)31
+b(default)g(v)-5 b(alue)30 b(is)g(a)g(blank)h(string)e(whic)n(h)i
+(causes)e(no)h(pre\014x)g(to)h(b)r(e)f(used.)46 b(In)31
+b(this)f(case)g(eac)n(h)g(top-lev)n(el)227 3097 y(elemen)n(t)e(will)g
+(set)f(the)h(default)g(namespace)f(to)g(b)r(e)h(the)g(v)-5
+b(alue)28 b(of)g(AST)p Ft(__)p Fj(XMLNS.)0 3237 y Fc(T)m(yp)s(e:)227
+3337 y Fj(String.)0 3477 y Fc(Class)j(Applicabilit)m(y:)259
+3604 y(Ob)5 b(ject)427 3704 y Fj(All)28 b(Ob)5 b(jects)28
+b(ha)n(v)n(e)e(this)i(attribute.)p 0 3884 V 0 4015 a
+FA(Zo)t(om)1322 4016 y Fd(Zo)s(omMap)37 b(scale)i(factor)3447
+4015 y FA(Zo)t(om)0 4186 y Fc(Description:)44 b Fj(This)24
+b(attribute)g(holds)g(the)g(Zo)r(omMap)f(scale)g(factor,)h(b)n(y)g
+(whic)n(h)g(co)r(ordinate)e(v)-5 b(alues)24 b(are)f(m)n(ultiplied)227
+4285 y(\(b)n(y)g(the)h(forw)n(ard)d(transformation\))g(or)h(divided)i
+(\(b)n(y)f(the)g(in)n(v)n(erse)f(transformation\).)34
+b(This)22 b(factor)h(is)f(set)h(when)227 4385 y(a)k(Zo)r(omMap)g(is)h
(created,)e(but)j(ma)n(y)e(later)g(b)r(e)h(mo)r(di\014ed.)37
b(The)27 b(default)i(v)-5 b(alue)27 b(is)g(unit)n(y)-7
-b(.)227 2673 y(Note)23 b(that)f(if)h(a)f(Zo)r(omMap)f(is)h(in)n(v)n
+b(.)227 4505 y(Note)23 b(that)f(if)h(a)f(Zo)r(omMap)f(is)h(in)n(v)n
(erted)g(\(e.g.)35 b(b)n(y)22 b(using)f(AST)p Ft(_)p
Fj(INVER)-7 b(T\),)23 b(then)g(the)g(recipro)r(cal)d(of)j(this)f(zo)r
-(om)227 2773 y(factor)27 b(will,)h(in)g(e\013ect,)g(b)r(e)g(used.)0
-2922 y Fc(T)m(yp)s(e:)227 3022 y Fj(Double)g(precision.)0
-3171 y Fc(Class)j(Applicabilit)m(y:)259 3307 y(Zo)s(omMap)427
-3407 y Fj(All)d(Zo)r(omMaps)f(ha)n(v)n(e)f(this)i(attribute.)0
-3569 y Fc(Notes:)340 3851 y Fi(\017)45 b Fj(The)28 b(Zo)r(om)f
+(om)227 4604 y(factor)27 b(will,)h(in)g(e\013ect,)g(b)r(e)g(used.)0
+4745 y Fc(T)m(yp)s(e:)227 4844 y Fj(Double)g(precision.)0
+4984 y Fc(Class)j(Applicabilit)m(y:)259 5111 y(Zo)s(omMap)427
+5211 y Fj(All)d(Zo)r(omMaps)f(ha)n(v)n(e)f(this)i(attribute.)0
+5363 y Fc(Notes:)340 5636 y Fi(\017)45 b Fj(The)28 b(Zo)r(om)f
(attribute)h(ma)n(y)f(not)g(b)r(e)h(set)g(to)f(zero.)p
eop end
-%%Page: 515 525
-TeXDict begin 515 524 bop 3643 52 a FG(515)0 351 y FA(D)135
+%%Page: 520 530
+TeXDict begin 520 529 bop 0 52 a FG(520)1994 b Fz(C)91
+b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p eop end
+%%Page: 521 531
+TeXDict begin 521 530 bop 3643 52 a FG(521)0 351 y FA(D)135
b(AST)43 b(Class)j(Descriptions)p 0 596 3780 12 v 0 728
a(Axis)1057 b Fd(Store)38 b(axis)g(information)1054 b
FA(Axis)0 901 y Fc(Description:)44 b Fj(The)30 b(Axis)f(class)f(is)h
@@ -136956,8 +137248,8 @@ y(whic)n(h)i(case)f(no)g(sink)g(or)g(source)f(function)j(need)e(b)r(e)h
5390 y Fj(AST)p Ft(_)p Fj(CHANNEL)-2 5547 y Fc(Inheritance)n(:)227
5693 y Fj(The)28 b(Channel)f(class)g(inherits)h(from)f(the)h(Ob)5
b(ject)27 b(class.)p eop end
-%%Page: 516 526
-TeXDict begin 516 525 bop 0 52 a FG(516)2251 b Fz(D)91
+%%Page: 522 532
+TeXDict begin 522 531 bop 0 52 a FG(522)2251 b Fz(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)-2 351 y Fc(A)m(ttributes)n(:)227
497 y Fj(In)34 b(addition)e(to)h(those)g(attributes)g(common)g(to)g
(all)f(Ob)5 b(jects,)34 b(ev)n(ery)e(Channel)h(also)f(has)h(the)g
@@ -137021,8 +137313,8 @@ b(Normally)-7 b(,)41 b(a)227 5693 y(CmpF)-7 b(rame)35
b(is)g(simply)h(equiv)-5 b(alen)n(t)35 b(to)g(a)g(UnitMap,)i(but)f(if)g
(either)f(of)g(the)h(comp)r(onen)n(t)f(F)-7 b(rames)34
b(within)i(a)p eop end
-%%Page: 517 527
-TeXDict begin 517 526 bop 3643 52 a FG(517)227 351 y
+%%Page: 523 533
+TeXDict begin 523 532 bop 3643 52 a FG(523)227 351 y
Fj(CmpF)-7 b(rame)41 b(is)f(a)g(Region)g(\(a)g(sub-class)g(of)g(F)-7
b(rame\),)44 b(then)d(the)g(CmpF)-7 b(rame)40 b(will)h(use)f(the)h
(Region)f(as)g(a)227 451 y(Mapping)g(when)g(transforming)e(v)-5
@@ -137086,8 +137378,8 @@ b(CmpMap)f(class)g(do)r(es)g(not)g(de\014ne)h(an)n(y)e(new)i
5502 y Fj(The)37 b(CmpMap)g(class)f(do)r(es)g(not)h(de\014ne)f(an)n(y)g
(new)h(routines)f(b)r(ey)n(ond)h(those)f(whic)n(h)h(are)e(applicable)h
(to)h(all)227 5601 y(Mappings.)p eop end
-%%Page: 518 528
-TeXDict begin 518 527 bop 0 52 a FG(518)2251 b Fz(D)91
+%%Page: 524 534
+TeXDict begin 524 533 bop 0 52 a FG(524)2251 b Fz(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 483
a FA(CmpRegion)215 b Fd(A)39 b(com)m(bination)c(of)k(t)m(w)m(o)e
(regions)g(within)g(a)1567 598 y(single)h(F)-10 b(rame)3087
@@ -137178,8 +137470,8 @@ y(In)32 b(practice,)f(the)h(LO)f(frequency)g(is)g(sp)r(eci\014ed)g(b)n
(osition.)69 b(T)n(ypically)37 b(this)i(cen)n(tral)e(p)r(osition)h(is)h
(that)f(of)h(some)f(in)n(teresting)f(sp)r(ectral)p eop
end
-%%Page: 519 529
-TeXDict begin 519 528 bop 3643 52 a FG(519)227 351 y
+%%Page: 525 535
+TeXDict begin 525 534 bop 3643 52 a FG(525)227 351 y
Fj(feature.)36 b(The)23 b(distance)h(from)f(this)h(cen)n(tral)f(p)r
(osition)g(to)h(the)g(LO)f(frequency)g(is)g(kno)n(wn)g(as)g(the)h
Ft(")p Fj(in)n(termediate)227 451 y(frequency)p Ft(")k
@@ -137246,8 +137538,8 @@ Fc(F)-8 b(unctions)n(:)227 5530 y Fj(The)40 b(DssMap)g(class)e(do)r(es)
i(not)g(de\014ne)g(an)n(y)f(new)h(routines)f(b)r(ey)n(ond)g(those)h
(whic)n(h)f(are)g(applicable)g(to)h(all)227 5630 y(Mappings.)p
eop end
-%%Page: 520 530
-TeXDict begin 520 529 bop 0 52 a FG(520)2251 b Fz(D)91
+%%Page: 526 536
+TeXDict begin 526 535 bop 0 52 a FG(526)2251 b Fz(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 483
a FA(Ellipse)231 b Fd(An)39 b(elliptical)c(region)j(within)f(a)h
(2-dimensional)e(F)-10 b(rame)229 b FA(Ellipse)0 667
@@ -137340,8 +137632,8 @@ b(In)32 b(general,)f(di\013eren)n(t)h(enco)r(dings)f(will)g(result)h
(describ)r(e)h(the)g(same)f(Ob)5 b(ject.)35 b(Examples)23
b(of)g(enco)r(dings)g(include)h(the)h(DSS)f(enco)r(ding)p
eop end
-%%Page: 521 531
-TeXDict begin 521 530 bop 3643 52 a FG(521)227 351 y
+%%Page: 527 537
+TeXDict begin 527 536 bop 3643 52 a FG(527)227 351 y
Fj(\(based)35 b(on)g(con)n(v)n(en)n(tions)f(used)h(b)n(y)g(the)h(STScI)
g(Digitised)f(Sky)g(Surv)n(ey)g(data\),)i(the)f(FITS-W)n(CS)f(enco)r
(ding)227 451 y(\(based)30 b(on)g(a)g(prop)r(osed)f(FITS)h(standard\))g
@@ -137423,8 +137715,8 @@ b(arnings:)36 b(Pro)r(duces)27 b(w)n(arnings)e(ab)r(out)j(selected)f
y Fj(In)25 b(addition)g(to)f(those)g(routines)g(applicable)h(to)f(all)g
(Channels,)h(the)g(follo)n(wing)f(routines)g(ma)n(y)g(also)g(b)r(e)h
(applied)227 5599 y(to)j(all)f(FitsChans:)p eop end
-%%Page: 522 532
-TeXDict begin 522 531 bop 0 52 a FG(522)2251 b Fz(D)91
+%%Page: 528 538
+TeXDict begin 528 537 bop 0 52 a FG(528)2251 b Fz(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)340 351 y Fi(\017)45
b Fj(AST)p Ft(_)p Fj(DELFITS:)28 b(Delete)g(the)g(curren)n(t)f(FITS)h
(card)f(in)g(a)h(FitsChan)340 485 y Fi(\017)45 b Fj(AST)p
@@ -137501,8 +137793,8 @@ b(Get/set)g(the)g(n)n(ull)f(v)-5 b(alue)28 b(for)f(a)g(column)h(of)f(a)
h(FitsT)-7 b(able)340 5693 y Fi(\017)45 b Fj(AST)p Ft(_)p
Fj(COLUMNSIZE:)27 b(Get)h(n)n(um)n(b)r(er)g(of)f(b)n(ytes)g(needed)h
(to)g(hold)f(a)g(full)i(column)e(of)h(data)p eop end
-%%Page: 523 533
-TeXDict begin 523 532 bop 3643 52 a FG(523)340 351 y
+%%Page: 529 539
+TeXDict begin 529 538 bop 3643 52 a FG(529)340 351 y
Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GETCOLUMND)n(A)-7 b(T)g(A:)28
b(Retriev)n(e)f(all)h(the)g(data)f(v)-5 b(alues)27 b(stored)g(in)g(a)h
(column)340 488 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GETT)-7
@@ -137572,8 +137864,8 @@ b(alen)n(t)23 b(to)g(a)g(UnitMap\).)36 b(The)23 b(Nin)h(and)f(Nout)g
(attribute)g(v)-5 b(alues)427 5677 y(are)27 b(b)r(oth)h(equal)f(to)g
(the)h(n)n(um)n(b)r(er)g(of)f(F)-7 b(rame)27 b(axes.)p
eop end
-%%Page: 524 534
-TeXDict begin 524 533 bop 0 52 a FG(524)2251 b Fz(D)91
+%%Page: 530 540
+TeXDict begin 530 539 bop 0 52 a FG(530)2251 b Fz(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)-2 351 y Fc(Inheritance)n(:)227
497 y Fj(The)f(F)-7 b(rame)27 b(class)g(inherits)g(from)g(the)h
(Mapping)g(class.)-2 644 y Fc(A)m(ttributes)n(:)227 791
@@ -137639,8 +137931,8 @@ b Fj(AST)p Ft(_)p Fj(DIST)-7 b(ANCE:)29 b(Calculate)d(the)i(distance)g
b(rame)340 5693 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(FINDFRAME:)29
b(Find)f(a)f(co)r(ordinate)g(system)g(with)h(sp)r(eci\014ed)g(c)n
(haracteristics)p eop end
-%%Page: 525 535
-TeXDict begin 525 534 bop 3643 52 a FG(525)340 351 y
+%%Page: 531 541
+TeXDict begin 531 540 bop 3643 52 a FG(531)340 351 y
Fi(\017)45 b Fj(AST)p Ft(_)p Fj(F)n(ORMA)-7 b(T:)28 b(F)-7
b(ormat)27 b(a)g(co)r(ordinate)g(v)-5 b(alue)27 b(for)g(a)g(F)-7
b(rame)27 b(axis)340 488 y Fi(\017)45 b Fj(AST)p Ft(_)p
@@ -137741,2496 +138033,2504 @@ y Fc(Constructor)32 b(F)-8 b(unction:)227 5389 y Fj(AST)p
Ft(_)p Fj(FRAMESET)-2 5547 y Fc(Inheritance)n(:)227 5693
y Fj(The)28 b(F)-7 b(rameSet)27 b(class)g(inherits)g(from)h(the)g(F)-7
b(rame)27 b(class.)p eop end
-%%Page: 526 536
-TeXDict begin 526 535 bop 0 52 a FG(526)2251 b Fz(D)91
+%%Page: 532 542
+TeXDict begin 532 541 bop 0 52 a FG(532)2251 b Fz(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)-2 351 y Fc(A)m(ttributes)n(:)227
497 y Fj(In)41 b(addition)g(to)g(those)f(attributes)h(common)f(to)h
(all)g(F)-7 b(rames,)43 b(ev)n(ery)d(F)-7 b(rameSet)40
b(also)g(has)g(the)i(follo)n(wing)227 597 y(attributes:)340
-861 y Fi(\017)j Fj(Base:)36 b(F)-7 b(rameSet)28 b(base)f(F)-7
-b(rame)27 b(index)340 995 y Fi(\017)45 b Fj(Curren)n(t:)36
-b(F)-7 b(rameSet)28 b(curren)n(t)e(F)-7 b(rame)28 b(index)340
-1129 y Fi(\017)45 b Fj(Nframe:)37 b(Num)n(b)r(er)28 b(of)f(F)-7
-b(rames)27 b(in)h(a)f(F)-7 b(rameSet)227 1293 y(Ev)n(ery)32
-b(F)-7 b(rameSet)32 b(also)g(inherits)h(an)n(y)f(further)h(attributes)g
-(that)g(b)r(elong)f(to)h(its)g(curren)n(t)f(F)-7 b(rame,)34
-b(regardless)227 1392 y(of)j(that)h(F)-7 b(rame's)36
+878 y Fi(\017)j Fj(AllV)-7 b(arian)n(ts:)36 b(List)28
+b(of)g(all)f(v)-5 b(arian)n(t)27 b(mappings)g(store)f(with)i(curren)n
+(t)f(F)-7 b(rame)340 1017 y Fi(\017)45 b Fj(Base:)36
+b(F)-7 b(rameSet)28 b(base)f(F)-7 b(rame)27 b(index)340
+1156 y Fi(\017)45 b Fj(Curren)n(t:)36 b(F)-7 b(rameSet)28
+b(curren)n(t)e(F)-7 b(rame)28 b(index)340 1296 y Fi(\017)45
+b Fj(Nframe:)37 b(Num)n(b)r(er)28 b(of)f(F)-7 b(rames)27
+b(in)h(a)f(F)-7 b(rameSet)340 1435 y Fi(\017)45 b Fj(V)-7
+b(arian)n(t:)36 b(Name)28 b(of)f(v)-5 b(arian)n(t)27
+b(mapping)g(in)h(use)g(b)n(y)f(curren)n(t)g(F)-7 b(rame)227
+1610 y(Ev)n(ery)32 b(F)-7 b(rameSet)32 b(also)g(inherits)h(an)n(y)f
+(further)h(attributes)g(that)g(b)r(elong)f(to)h(its)g(curren)n(t)f(F)-7
+b(rame,)34 b(regardless)227 1710 y(of)j(that)h(F)-7 b(rame's)36
b(class.)65 b(\(F)-7 b(or)37 b(example,)i(the)f(Equino)n(x)e
(attribute,)k(de\014ned)d(b)n(y)g(the)h(SkyF)-7 b(rame)36
-b(class,)j(is)227 1492 y(inherited)d(b)n(y)g(an)n(y)f(F)-7
+b(class,)j(is)227 1809 y(inherited)d(b)n(y)g(an)n(y)f(F)-7
b(rameSet)35 b(whic)n(h)h(has)f(a)g(SkyF)-7 b(rame)35
b(as)g(its)h(curren)n(t)f(F)-7 b(rame.\))61 b(The)36
-b(set)g(of)g(attributes)227 1592 y(b)r(elonging)27 b(to)h(a)f(F)-7
+b(set)g(of)g(attributes)227 1909 y(b)r(elonging)27 b(to)h(a)f(F)-7
b(rameSet)27 b(ma)n(y)g(therefore)g(c)n(hange)f(when)i(a)f(new)h
-(curren)n(t)f(F)-7 b(rame)27 b(is)g(selected.)-2 1743
-y Fc(F)-8 b(unctions)n(:)227 1889 y Fj(In)30 b(addition)f(to)h(those)f
+(curren)n(t)f(F)-7 b(rame)27 b(is)g(selected.)-2 2071
+y Fc(F)-8 b(unctions)n(:)227 2218 y Fj(In)30 b(addition)f(to)h(those)f
(routines)g(applicable)g(to)g(all)g(F)-7 b(rames,)29
b(the)h(follo)n(wing)f(routines)g(ma)n(y)f(also)h(b)r(e)h(applied)227
-1989 y(to)e(all)f(F)-7 b(rameSets:)340 2253 y Fi(\017)45
+2317 y(to)e(all)f(F)-7 b(rameSets:)340 2598 y Fi(\017)45
b Fj(AST)p Ft(_)p Fj(ADDFRAME:)29 b(Add)f(a)g(F)-7 b(rame)27
b(to)g(a)g(F)-7 b(rameSet)28 b(to)f(de\014ne)h(a)f(new)h(co)r(ordinate)
-e(system)340 2387 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GETFRAME:)28
-b(Obtain)f(a)g(p)r(oin)n(ter)g(to)h(a)f(sp)r(eci\014ed)h(F)-7
-b(rame)27 b(in)h(a)f(F)-7 b(rameSet)340 2520 y Fi(\017)45
-b Fj(AST)p Ft(_)p Fj(GETMAPPING:)27 b(Obtain)h(a)f(Mapping)g(b)r(et)n
-(w)n(een)h(t)n(w)n(o)e(F)-7 b(rames)27 b(in)h(a)f(F)-7
-b(rameSet)340 2654 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(REMAPFRAME:)28
+e(system)340 2737 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(ADD)n(V)-9
+b(ARIANT:)30 b(Add)e(a)f(v)-5 b(arian)n(t)27 b(Mapping)g(to)g(the)h
+(curren)n(t)f(F)-7 b(rame)340 2877 y Fi(\017)45 b Fj(AST)p
+Ft(_)p Fj(GETFRAME:)28 b(Obtain)f(a)g(p)r(oin)n(ter)g(to)h(a)f(sp)r
+(eci\014ed)h(F)-7 b(rame)27 b(in)h(a)f(F)-7 b(rameSet)340
+3016 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GETMAPPING:)27
+b(Obtain)h(a)f(Mapping)g(b)r(et)n(w)n(een)h(t)n(w)n(o)e(F)-7
+b(rames)27 b(in)h(a)f(F)-7 b(rameSet)340 3155 y Fi(\017)45
+b Fj(AST)p Ft(_)p Fj(MIRR)n(OR)-9 b(V)g(ARIANTS:)40 b(Mak)n(e)e(the)i
+(curren)n(t)e(F)-7 b(rame)39 b(mirror)e(v)-5 b(arian)n(t)39
+b(Mappings)f(in)i(another)427 3255 y(F)-7 b(rame)340
+3394 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(REMAPFRAME:)28
b(Mo)r(dify)g(a)f(F)-7 b(rame's)27 b(relationship)f(to)i(the)g(other)f
-(F)-7 b(rames)27 b(in)g(a)h(F)-7 b(rameSet)340 2788 y
+(F)-7 b(rames)27 b(in)g(a)h(F)-7 b(rameSet)340 3534 y
Fi(\017)45 b Fj(AST)p Ft(_)p Fj(REMO)n(VEFRAME:)27 b(Remo)n(v)n(e)f(a)i
-(F)-7 b(rame)27 b(from)g(a)g(F)-7 b(rameSet)p 0 2990
-3780 12 v 0 3121 a FA(GrismMap)160 b Fd(T)-10 b(ransform)36
-b(1-dimensional)g(co)s(ordinates)h(using)1186 3236 y(a)i(grism)e(disp)s
-(ersion)h(equation)3149 3121 y FA(GrismMap)0 3427 y Fc(Description:)44
+(F)-7 b(rame)27 b(from)g(a)g(F)-7 b(rameSet)p 0 3746
+3780 12 v 0 3878 a FA(GrismMap)160 b Fd(T)-10 b(ransform)36
+b(1-dimensional)g(co)s(ordinates)h(using)1186 3992 y(a)i(grism)e(disp)s
+(ersion)h(equation)3149 3878 y FA(GrismMap)0 4194 y Fc(Description:)44
b Fj(A)22 b(GrismMap)f(is)g(a)g(sp)r(ecialised)g(form)g(of)g(Mapping)g
(whic)n(h)g(transforms)f(1-dimensional)g(co)r(ordinates)227
-3526 y(using)f(the)h(sp)r(ectral)f(disp)r(ersion)g(equation)g(describ)r
+4294 y(using)f(the)h(sp)r(ectral)f(disp)r(ersion)g(equation)g(describ)r
(ed)g(in)g(FITS-W)n(CS)h(pap)r(er)f(I)r(I)r(I)h Ft(")p
-Fj(Represen)n(tation)e(of)h(sp)r(ectral)227 3626 y(co)r(ordinates)26
+Fj(Represen)n(tation)e(of)h(sp)r(ectral)227 4393 y(co)r(ordinates)26
b(in)i(FITS)p Ft(")p Fj(.)37 b(This)28 b(describ)r(es)f(the)h(disp)r
(ersion)f(pro)r(duced)g(b)n(y)g(gratings,)f(prisms)h(and)h(grisms.)227
-3751 y(When)23 b(initially)f(created,)g(the)h(forw)n(ard)d
+4524 y(When)23 b(initially)f(created,)g(the)h(forw)n(ard)d
(transformation)g(of)i(a)g(GrismMap)f(transforms)g(input)h
-Ft(")p Fj(grism)f(param-)227 3851 y(eter)p Ft(")k Fj(v)-5
+Ft(")p Fj(grism)f(param-)227 4624 y(eter)p Ft(")k Fj(v)-5
b(alues)24 b(in)n(to)h(output)h(w)n(a)n(v)n(elength)d(v)-5
b(alues.)36 b(The)25 b Ft(")p Fj(grism)f(parameter)p
Ft(")f Fj(is)i(a)g(dimensionless)g(v)-5 b(alue)25 b(whic)n(h)227
-3951 y(is)30 b(linearly)e(related)h(to)g(p)r(osition)h(on)f(the)h
+4724 y(is)30 b(linearly)e(related)h(to)g(p)r(osition)h(on)f(the)h
(detector.)42 b(It)30 b(is)f(de\014ned)h(in)g(FITS-W)n(CS)f(pap)r(er)g
-(I)r(I)r(I)h(as)f Ft(")p Fj(the)h(o\013set)227 4050 y(on)25
+(I)r(I)r(I)h(as)f Ft(")p Fj(the)h(o\013set)227 4823 y(on)25
b(the)g(detector)f(from)h(the)g(p)r(oin)n(t)g(of)g(in)n(tersection)f
(of)h(the)g(camera)f(axis,)g(measured)g(in)h(units)h(of)e(the)i
-(e\013ectiv)n(e)227 4150 y(lo)r(cal)f(length)p Ft(")p
+(e\013ectiv)n(e)227 4923 y(lo)r(cal)f(length)p Ft(")p
Fj(.)36 b(The)25 b(units)h(in)f(whic)n(h)g(w)n(a)n(v)n(elength)f(v)-5
b(alues)25 b(are)f(exp)r(ected)i(or)e(returned)h(is)g(determined)g(b)n
-(y)g(the)227 4250 y(v)-5 b(alues)29 b(supplied)h(for)f(the)g(GrismW)-7
+(y)g(the)227 5023 y(v)-5 b(alues)29 b(supplied)h(for)f(the)g(GrismW)-7
b(a)n(v)n(eR,)29 b(GrismNRP)g(and)g(GrismG)g(attribute:)40
-b(whatev)n(er)29 b(units)g(are)g(used)227 4349 y(for)e(these)h
+b(whatev)n(er)29 b(units)g(are)g(used)227 5122 y(for)e(these)h
(attributes)f(will)h(also)f(b)r(e)h(used)f(for)g(the)h(w)n(a)n(v)n
-(elength)e(v)-5 b(alues.)0 4501 y Fc(Constructor)32 b(F)-8
-b(unction:)227 4600 y Fj(AST)p Ft(_)p Fj(GRISMMAP)-2
-4752 y Fc(Inheritance)n(:)227 4898 y Fj(The)28 b(GrismMap)f(class)g
-(inherits)g(from)g(the)h(Mapping)g(class.)-2 5049 y Fc(A)m(ttributes)n
-(:)227 5196 y Fj(In)k(addition)f(to)g(those)g(attributes)g(common)g(to)
-g(all)g(Mappings,)g(ev)n(ery)f(GrismMap)h(also)f(has)h(the)h(follo)n
-(wing)227 5295 y(attributes:)340 5559 y Fi(\017)45 b
-Fj(GrismNR:)28 b(The)g(refractiv)n(e)e(index)i(at)f(the)h(reference)f
-(w)n(a)n(v)n(elength)340 5693 y Fi(\017)45 b Fj(GrismNRP:)28
-b(Rate)f(of)h(c)n(hange)e(of)i(refractiv)n(e)e(index)h(with)i(w)n(a)n
-(v)n(elength)p eop end
-%%Page: 527 537
-TeXDict begin 527 536 bop 3643 52 a FG(527)340 351 y
-Fi(\017)45 b Fj(GrismW)-7 b(a)n(v)n(eR:)27 b(The)g(reference)g(w)n(a)n
-(v)n(elength)340 476 y Fi(\017)45 b Fj(GrismAlpha:)37
+(elength)e(v)-5 b(alues.)0 5285 y Fc(Constructor)32 b(F)-8
+b(unction:)227 5384 y Fj(AST)p Ft(_)p Fj(GRISMMAP)-2
+5547 y Fc(Inheritance)n(:)227 5693 y Fj(The)28 b(GrismMap)f(class)g
+(inherits)g(from)g(the)h(Mapping)g(class.)p eop end
+%%Page: 533 543
+TeXDict begin 533 542 bop 3643 52 a FG(533)-2 351 y Fc(A)m(ttributes)n
+(:)227 497 y Fj(In)32 b(addition)f(to)g(those)g(attributes)g(common)g
+(to)g(all)g(Mappings,)g(ev)n(ery)f(GrismMap)h(also)f(has)h(the)h(follo)
+n(wing)227 597 y(attributes:)340 934 y Fi(\017)45 b Fj(GrismNR:)28
+b(The)g(refractiv)n(e)e(index)i(at)f(the)h(reference)f(w)n(a)n(v)n
+(elength)340 1092 y Fi(\017)45 b Fj(GrismNRP:)28 b(Rate)f(of)h(c)n
+(hange)e(of)i(refractiv)n(e)e(index)h(with)i(w)n(a)n(v)n(elength)340
+1250 y Fi(\017)45 b Fj(GrismW)-7 b(a)n(v)n(eR:)27 b(The)g(reference)g
+(w)n(a)n(v)n(elength)340 1409 y Fi(\017)45 b Fj(GrismAlpha:)37
b(The)28 b(angle)e(of)i(incidence)g(of)f(the)h(incoming)f(ligh)n(t)340
-601 y Fi(\017)45 b Fj(GrismG:)28 b(The)f(grating)g(ruling)g(densit)n(y)
-340 726 y Fi(\017)45 b Fj(GrismM:)28 b(The)f(in)n(terference)g(order)
-340 851 y Fi(\017)45 b Fj(GrismEps:)36 b(The)28 b(angle)f(b)r(et)n(w)n
-(een)g(the)h(normal)f(and)g(the)h(disp)r(ersion)f(plane)340
-975 y Fi(\017)45 b Fj(GrismTheta:)37 b(Angle)27 b(b)r(et)n(w)n(een)h
-(normal)e(to)i(detector)f(plane)g(and)h(reference)e(ra)n(y)-2
-1129 y Fc(F)-8 b(unctions)n(:)227 1275 y Fj(The)34 b(GrismMap)f(class)f
-(do)r(es)i(not)f(de\014ne)h(an)n(y)f(new)g(routines)g(b)r(ey)n(ond)g
-(those)h(whic)n(h)f(are)g(applicable)f(to)i(all)227 1375
-y(Mappings.)p 0 1558 3780 12 v 0 1690 a FA(In)l(terv)-7
-b(al)186 b Fd(A)39 b(region)e(represen)m(ting)g(an)h(in)m(terv)-7
-b(al)37 b(on)h(one)h(or)f(more)1485 1805 y(axes)h(of)f(a)h(F)-10
-b(rame)3324 1690 y FA(In)l(terv)j(al)0 1959 y Fc(Description:)44
-b Fj(The)23 b(In)n(terv)-5 b(al)22 b(class)g(implemen)n(ts)h(a)f
-(Region)g(whic)n(h)g(represen)n(ts)g(upp)r(er)g(and/or)f(lo)n(w)n(er)h
-(limits)h(on)f(one)227 2058 y(or)i(more)g(axes)g(of)g(a)h(F)-7
-b(rame.)35 b(F)-7 b(or)24 b(a)g(p)r(oin)n(t)h(to)g(b)r(e)g(within)g
-(the)g(region)f(represen)n(ted)f(b)n(y)i(the)g(In)n(terv)-5
-b(al,)24 b(the)h(p)r(oin)n(t)227 2158 y(m)n(ust)j(satisfy)f(all)g(the)h
+1567 y Fi(\017)45 b Fj(GrismG:)28 b(The)f(grating)g(ruling)g(densit)n
+(y)340 1725 y Fi(\017)45 b Fj(GrismM:)28 b(The)f(in)n(terference)g
+(order)340 1883 y Fi(\017)45 b Fj(GrismEps:)36 b(The)28
+b(angle)f(b)r(et)n(w)n(een)g(the)h(normal)f(and)g(the)h(disp)r(ersion)f
+(plane)340 2041 y Fi(\017)45 b Fj(GrismTheta:)37 b(Angle)27
+b(b)r(et)n(w)n(een)h(normal)e(to)i(detector)f(plane)g(and)h(reference)e
+(ra)n(y)-2 2254 y Fc(F)-8 b(unctions)n(:)227 2400 y Fj(The)34
+b(GrismMap)f(class)f(do)r(es)i(not)f(de\014ne)h(an)n(y)f(new)g
+(routines)g(b)r(ey)n(ond)g(those)h(whic)n(h)f(are)g(applicable)f(to)i
+(all)227 2500 y(Mappings.)p 0 2750 3780 12 v 0 2881 a
+FA(In)l(terv)-7 b(al)186 b Fd(A)39 b(region)e(represen)m(ting)g(an)h
+(in)m(terv)-7 b(al)37 b(on)h(one)h(or)f(more)1485 2996
+y(axes)h(of)f(a)h(F)-10 b(rame)3324 2881 y FA(In)l(terv)j(al)0
+3217 y Fc(Description:)44 b Fj(The)23 b(In)n(terv)-5
+b(al)22 b(class)g(implemen)n(ts)h(a)f(Region)g(whic)n(h)g(represen)n
+(ts)g(upp)r(er)g(and/or)f(lo)n(w)n(er)h(limits)h(on)f(one)227
+3316 y(or)i(more)g(axes)g(of)g(a)h(F)-7 b(rame.)35 b(F)-7
+b(or)24 b(a)g(p)r(oin)n(t)h(to)g(b)r(e)g(within)g(the)g(region)f
+(represen)n(ted)f(b)n(y)i(the)g(In)n(terv)-5 b(al,)24
+b(the)h(p)r(oin)n(t)227 3416 y(m)n(ust)j(satisfy)f(all)g(the)h
(restrictions)e(placed)h(on)g(all)g(the)h(axes.)36 b(The)27
b(p)r(oin)n(t)h(is)f(outside)g(the)h(region)e(if)i(it)g(fails)f(to)227
-2258 y(satisfy)j(an)n(y)g(one)f(of)i(the)f(restrictions.)44
+3516 y(satisfy)j(an)n(y)g(one)f(of)i(the)f(restrictions.)44
b(Eac)n(h)29 b(axis)g(ma)n(y)h(ha)n(v)n(e)f(either)h(an)g(upp)r(er)g
-(limit,)i(a)e(lo)n(w)n(er)e(limit,)k(b)r(oth)227 2357
+(limit,)i(a)e(lo)n(w)n(er)e(limit,)k(b)r(oth)227 3615
y(or)e(neither.)47 b(If)32 b(b)r(oth)f(limits)h(are)e(supplied)h(but)g
(are)f(in)i(rev)n(erse)d(order)g(\(so)i(that)g(the)g(lo)n(w)n(er)f
-(limit)i(is)e(greater)227 2457 y(than)e(the)g(upp)r(er)g(limit\),)g
+(limit)i(is)e(greater)227 3715 y(than)e(the)g(upp)r(er)g(limit\),)g
(then)h(the)f(in)n(terv)-5 b(al)27 b(is)g(an)g(excluded)h(in)n(terv)-5
b(al,)27 b(rather)g(than)g(an)h(included)g(in)n(terv)-5
-b(al.)227 2577 y(Note,)33 b(The)e(In)n(terv)-5 b(al)31
+b(al.)227 3865 y(Note,)33 b(The)e(In)n(terv)-5 b(al)31
b(class)g(mak)n(es)f(no)h(allo)n(w)n(ances)f(for)h(cyclic)g(nature)g
(of)g(some)g(co)r(ordinate)g(systems)g(\(suc)n(h)227
-2677 y(as)25 b(SkyF)-7 b(rame)24 b(co)r(ordinates\).)35
+3964 y(as)25 b(SkyF)-7 b(rame)24 b(co)r(ordinates\).)35
b(A)25 b(Bo)n(x)f(should)g(usually)h(b)r(e)g(used)g(in)g(these)g(cases)
-f(since)h(this)g(requires)f(the)h(user)227 2777 y(to)j(think)g(ab)r
+f(since)h(this)g(requires)f(the)h(user)227 4064 y(to)j(think)g(ab)r
(out)f(suitable)h(upp)r(er)g(and)f(lo)n(w)n(er)f(limits,)0
-2918 y Fc(Constructor)32 b(F)-8 b(unction:)227 3018 y
-Fj(AST)p Ft(_)p Fj(INTER)f(V)g(AL)-2 3159 y Fc(Inheritance)n(:)227
-3305 y Fj(The)28 b(In)n(terv)-5 b(al)27 b(class)g(inherits)g(from)g
-(the)h(Region)f(class.)-2 3447 y Fc(A)m(ttributes)n(:)227
-3593 y Fj(The)37 b(In)n(terv)-5 b(al)35 b(class)h(do)r(es)g(not)g
+4264 y Fc(Constructor)32 b(F)-8 b(unction:)227 4364 y
+Fj(AST)p Ft(_)p Fj(INTER)f(V)g(AL)-2 4564 y Fc(Inheritance)n(:)227
+4710 y Fj(The)28 b(In)n(terv)-5 b(al)27 b(class)g(inherits)g(from)g
+(the)h(Region)f(class.)-2 4910 y Fc(A)m(ttributes)n(:)227
+5056 y Fj(The)37 b(In)n(terv)-5 b(al)35 b(class)h(do)r(es)g(not)g
(de\014ne)h(an)n(y)e(new)i(attributes)f(b)r(ey)n(ond)g(those)g(whic)n
-(h)g(are)g(applicable)g(to)g(all)227 3692 y(Regions.)-2
-3834 y Fc(F)-8 b(unctions)n(:)227 3980 y Fj(The)41 b(In)n(terv)-5
+(h)g(are)g(applicable)g(to)g(all)227 5156 y(Regions.)-2
+5356 y Fc(F)-8 b(unctions)n(:)227 5502 y Fj(The)41 b(In)n(terv)-5
b(al)40 b(class)g(do)r(es)g(not)h(de\014ne)g(an)n(y)f(new)g(routines)g
(b)r(ey)n(ond)h(those)f(whic)n(h)h(are)e(applicable)h(to)h(all)227
-4080 y(Regions.)p 0 4263 V 0 4393 a FA(In)l(traMap)801
-4394 y Fd(Map)e(p)s(oin)m(ts)f(using)g(a)h(priv)-7 b(ate)37
-b(transformation)1708 4505 y(routine)3218 4393 y FA(In)l(traMap)0
-4655 y Fc(Description:)44 b Fj(The)21 b(In)n(traMap)e(class)g(pro)n
-(vides)g(a)h(sp)r(ecialised)f(form)h(of)g(Mapping)g(whic)n(h)g
-(encapsulates)g(a)f(priv)-5 b(ately-)227 4755 y(de\014ned)26
-b(co)r(ordinate)d(transformation)h(routine)g(\(e.g.)36
-b(written)25 b(in)g(F)-7 b(ortran\))24 b(so)h(that)g(it)g(ma)n(y)g(b)r
-(e)g(used)g(lik)n(e)f(an)n(y)227 4854 y(other)h(AST)h(Mapping.)35
+5602 y(Regions.)p eop end
+%%Page: 534 544
+TeXDict begin 534 543 bop 0 52 a FG(534)2251 b Fz(D)91
+b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 482
+a FA(In)l(traMap)801 483 y Fd(Map)39 b(p)s(oin)m(ts)f(using)g(a)h(priv)
+-7 b(ate)37 b(transformation)1708 594 y(routine)3218
+482 y FA(In)l(traMap)0 748 y Fc(Description:)44 b Fj(The)21
+b(In)n(traMap)e(class)g(pro)n(vides)g(a)h(sp)r(ecialised)f(form)h(of)g
+(Mapping)g(whic)n(h)g(encapsulates)g(a)f(priv)-5 b(ately-)227
+848 y(de\014ned)26 b(co)r(ordinate)d(transformation)h(routine)g(\(e.g.)
+36 b(written)25 b(in)g(F)-7 b(ortran\))24 b(so)h(that)g(it)g(ma)n(y)g
+(b)r(e)g(used)g(lik)n(e)f(an)n(y)227 947 y(other)h(AST)h(Mapping.)35
b(This)25 b(allo)n(ws)f(y)n(ou)h(to)g(create)f(Mappings)h(that)g(p)r
(erform)g(an)n(y)f(conceiv)-5 b(able)25 b(co)r(ordinate)227
-4954 y(transformation.)227 5074 y(Ho)n(w)n(ev)n(er,)30
+1047 y(transformation.)227 1169 y(Ho)n(w)n(ev)n(er,)30
b(an)h(In)n(traMap)g(is)g(in)n(tended)g(for)g(use)g(within)h(a)f
(single)f(program)g(or)g(a)h(priv)-5 b(ate)31 b(suite)g(of)g(soft)n(w)n
-(are,)227 5174 y(where)24 b(all)g(programs)d(ha)n(v)n(e)i(access)g(to)h
+(are,)227 1268 y(where)24 b(all)g(programs)d(ha)n(v)n(e)i(access)g(to)h
(the)g(same)g(co)r(ordinate)f(transformation)f(functions)j(\(i.e.)36
-b(can)23 b(b)r(e)i(link)n(ed)227 5274 y(against)40 b(them\).)76
+b(can)23 b(b)r(e)i(link)n(ed)227 1368 y(against)40 b(them\).)76
b(In)n(traMaps)39 b(should)h(not)h(normally)e(b)r(e)i(stored)f(in)g
(datasets)g(whic)n(h)g(ma)n(y)g(b)r(e)h(exp)r(orted)227
-5373 y(for)34 b(pro)r(cessing)f(b)n(y)h(other)g(soft)n(w)n(are,)g
+1468 y(for)34 b(pro)r(cessing)f(b)n(y)h(other)g(soft)n(w)n(are,)g
(since)g(that)h(soft)n(w)n(are)e(will)h(not)h(ha)n(v)n(e)e(the)i
-(necessary)d(transformation)227 5473 y(functions)c(a)n(v)-5
-b(ailable,)27 b(resulting)g(in)g(an)h(error.)227 5593
+(necessary)d(transformation)227 1567 y(functions)c(a)n(v)-5
+b(ailable,)27 b(resulting)g(in)g(an)h(error.)227 1689
y(Y)-7 b(ou)37 b(m)n(ust)g(register)e(an)n(y)h(co)r(ordinate)f
(transformation)g(functions)i(to)f(b)r(e)h(used)g(using)f(AST)p
-Ft(_)p Fj(INTRAREG)227 5693 y(b)r(efore)28 b(creating)e(an)h(In)n
-(traMap.)p eop end
-%%Page: 528 538
-TeXDict begin 528 537 bop 0 52 a FG(528)2251 b Fz(D)91
-b(AST)30 b(CLASS)f(DESCRIPTIONS)0 351 y Fc(Constructor)j(F)-8
-b(unction:)227 451 y Fj(AST)p Ft(_)p Fj(INTRAMAP)28 b(\(also)f(see)g
-(AST)p Ft(_)p Fj(INTRAREG\))-2 602 y Fc(Inheritance)n(:)227
-748 y Fj(The)h(In)n(traMap)e(class)h(inherits)h(from)f(the)h(Mapping)f
-(class.)-2 898 y Fc(A)m(ttributes)n(:)227 1044 y Fj(In)35
+Ft(_)p Fj(INTRAREG)227 1789 y(b)r(efore)28 b(creating)e(an)h(In)n
+(traMap.)0 1933 y Fc(Constructor)32 b(F)-8 b(unction:)227
+2032 y Fj(AST)p Ft(_)p Fj(INTRAMAP)28 b(\(also)f(see)g(AST)p
+Ft(_)p Fj(INTRAREG\))-2 2176 y Fc(Inheritance)n(:)227
+2322 y Fj(The)h(In)n(traMap)e(class)h(inherits)h(from)f(the)h(Mapping)f
+(class.)-2 2466 y Fc(A)m(ttributes)n(:)227 2612 y Fj(In)35
b(addition)f(to)g(those)g(attributes)g(common)g(to)g(all)g(Mappings,)h
(ev)n(ery)e(In)n(traMap)g(also)g(has)h(the)h(follo)n(wing)227
-1144 y(attributes:)340 1407 y Fi(\017)45 b Fj(In)n(traFlag:)36
-b(In)n(traMap)26 b(iden)n(ti\014cation)i(string)-2 1570
-y Fc(F)-8 b(unctions)n(:)227 1716 y Fj(The)37 b(In)n(traMap)e(class)g
+2712 y(attributes:)340 2964 y Fi(\017)45 b Fj(In)n(traFlag:)36
+b(In)n(traMap)26 b(iden)n(ti\014cation)i(string)-2 3120
+y Fc(F)-8 b(unctions)n(:)227 3267 y Fj(The)37 b(In)n(traMap)e(class)g
(do)r(es)h(not)h(de\014ne)f(an)n(y)g(new)g(routines)g(b)r(ey)n(ond)g
-(those)g(whic)n(h)g(are)g(applicable)g(to)g(all)227 1816
-y(Mappings.)p 0 2016 3780 12 v 0 2147 a FA(KeyMap)1140
-2154 y Fd(Store)h(a)i(set)g(of)f(k)m(ey/v)-7 b(alue)37
-b(pairs)3274 2147 y FA(KeyMap)0 2351 y Fc(Description:)44
-b Fj(The)37 b(KeyMap)e(class)g(is)h(used)g(to)g(store)f(a)h(set)g(of)g
-(v)-5 b(alues)36 b(with)g(asso)r(ciated)f(k)n(eys)g(whic)n(h)h(iden)n
-(tify)227 2451 y(the)g(v)-5 b(alues.)59 b(The)35 b(k)n(eys)f(are)g
-(strings.)58 b(These)35 b(ma)n(y)f(b)r(e)i(case)e(sensitiv)n(e)g(or)g
-(insensitiv)n(e)h(as)g(selected)f(b)n(y)h(the)227 2550
-y(KeyCase)24 b(attribute,)h(and)g(trailing)f(spaces)g(are)f(ignored.)35
+(those)g(whic)n(h)g(are)g(applicable)g(to)g(all)227 3366
+y(Mappings.)p 0 3554 V 0 3685 a FA(KeyMap)1140 3693 y
+Fd(Store)h(a)i(set)g(of)f(k)m(ey/v)-7 b(alue)37 b(pairs)3274
+3685 y FA(KeyMap)0 3877 y Fc(Description:)44 b Fj(The)37
+b(KeyMap)e(class)g(is)h(used)g(to)g(store)f(a)h(set)g(of)g(v)-5
+b(alues)36 b(with)g(asso)r(ciated)f(k)n(eys)g(whic)n(h)h(iden)n(tify)
+227 3976 y(the)g(v)-5 b(alues.)59 b(The)35 b(k)n(eys)f(are)g(strings.)
+58 b(These)35 b(ma)n(y)f(b)r(e)i(case)e(sensitiv)n(e)g(or)g(insensitiv)
+n(e)h(as)g(selected)f(b)n(y)h(the)227 4076 y(KeyCase)24
+b(attribute,)h(and)g(trailing)f(spaces)g(are)f(ignored.)35
b(The)25 b(v)-5 b(alue)25 b(asso)r(ciated)e(with)i(a)g(k)n(ey)f(can)g
-(b)r(e)i(in)n(teger)227 2650 y(\(signed)35 b(4)g(and)f(2)h(b)n(yte,)i
+(b)r(e)i(in)n(teger)227 4176 y(\(signed)35 b(4)g(and)f(2)h(b)n(yte,)i
(or)d(unsigned)g(1)h(b)n(yte\),)i(\015oating)d(p)r(oin)n(t)h(\(single)g
-(or)f(double)h(precision\),)h(c)n(haracter)227 2750 y(string)25
+(or)f(double)h(precision\),)h(c)n(haracter)227 4275 y(string)25
b(or)g(AST)i(Ob)5 b(ject)25 b(p)r(oin)n(ter.)36 b(Eac)n(h)25
b(v)-5 b(alue)25 b(can)h(b)r(e)g(a)f(scalar)g(or)f(a)i(one-dimensional)
-e(v)n(ector.)35 b(A)27 b(KeyMap)227 2849 y(is)j(conceptually)f(similar)
+e(v)n(ector.)35 b(A)27 b(KeyMap)227 4375 y(is)j(conceptually)f(similar)
g(to)g(a)h(Mapping)f(in)h(that)g(a)f(KeyMap)g(transforms)f(an)h(input)i
-(in)n(to)e(an)h(output)g(-)f(the)227 2949 y(input)38
+(in)n(to)e(an)h(output)g(-)f(the)227 4475 y(input)38
b(is)f(the)g(k)n(ey)-7 b(,)39 b(and)e(the)g(output)g(is)g(the)h(v)-5
b(alue)36 b(asso)r(ciated)g(with)h(the)h(k)n(ey)-7 b(.)64
-b(Ho)n(w)n(ev)n(er,)37 b(this)h(is)e(only)h(a)227 3048
+b(Ho)n(w)n(ev)n(er,)37 b(this)h(is)e(only)h(a)227 4574
y(conceptual)25 b(similarit)n(y)-7 b(,)25 b(and)g(it)h(should)f(b)r(e)g
(noted)g(that)h(the)f(KeyMap)g(class)f(inherits)h(from)g(the)h(Ob)5
-b(ject)25 b(class)227 3148 y(rather)e(than)h(the)g(Mapping)f(class.)35
+b(ject)25 b(class)227 4674 y(rather)e(than)h(the)g(Mapping)f(class.)35
b(The)23 b(metho)r(ds)h(of)g(the)g(Mapping)f(class)g(cannot)g(b)r(e)h
-(used)g(with)g(a)f(KeyMap.)0 3299 y Fc(Constructor)32
-b(F)-8 b(unction:)227 3398 y Fj(AST)p Ft(_)p Fj(KEYMAP)-2
-3549 y Fc(Inheritance)n(:)227 3695 y Fj(The)28 b(KeyMap)f(class)f
-(inherits)i(from)f(the)h(Ob)5 b(ject)27 b(class.)-2 3846
-y Fc(A)m(ttributes)n(:)227 3992 y Fj(In)33 b(addition)f(to)h(those)f
+(used)g(with)g(a)f(KeyMap.)0 4818 y Fc(Constructor)32
+b(F)-8 b(unction:)227 4917 y Fj(AST)p Ft(_)p Fj(KEYMAP)-2
+5061 y Fc(Inheritance)n(:)227 5207 y Fj(The)28 b(KeyMap)f(class)f
+(inherits)i(from)f(the)h(Ob)5 b(ject)27 b(class.)-2 5351
+y Fc(A)m(ttributes)n(:)227 5497 y Fj(In)33 b(addition)f(to)h(those)f
(attributes)g(common)g(to)g(all)g(Ob)5 b(jects,)34 b(ev)n(ery)d(KeyMap)
-h(also)f(has)h(the)h(follo)n(wing)e(at-)227 4091 y(tributes:)340
-4354 y Fi(\017)45 b Fj(KeyCase:)36 b(Sets)27 b(the)h(case)f(in)h(whic)n
-(h)f(k)n(eys)g(are)g(stored)340 4488 y Fi(\017)45 b Fj(KeyError:)34
+h(also)f(has)h(the)h(follo)n(wing)e(at-)227 5597 y(tributes:)p
+eop end
+%%Page: 535 545
+TeXDict begin 535 544 bop 3643 52 a FG(535)340 351 y
+Fi(\017)45 b Fj(KeyCase:)36 b(Sets)27 b(the)h(case)f(in)h(whic)n(h)f(k)
+n(eys)g(are)g(stored)340 483 y Fi(\017)45 b Fj(KeyError:)34
b(Rep)r(ort)28 b(an)f(error)e(if)k(the)f(requested)f(k)n(ey)f(do)r(es)i
-(not)f(exist?)340 4621 y Fi(\017)45 b Fj(SizeGuess:)37
+(not)f(exist?)340 614 y Fi(\017)45 b Fj(SizeGuess:)37
b(The)28 b(exp)r(ected)f(size)h(of)f(the)h(KeyMap.)340
-4755 y Fi(\017)45 b Fj(SortBy:)36 b(Determines)28 b(ho)n(w)f(k)n(eys)g
-(are)f(sorted)h(in)h(a)f(KeyMap.)340 4888 y Fi(\017)45
+746 y Fi(\017)45 b Fj(SortBy:)36 b(Determines)28 b(ho)n(w)f(k)n(eys)g
+(are)f(sorted)h(in)h(a)f(KeyMap.)340 877 y Fi(\017)45
b Fj(MapLo)r(c)n(k)n(ed:)36 b(Prev)n(en)n(t)26 b(new)i(en)n(tries)e(b)r
-(eing)i(added)g(to)f(the)h(KeyMap?)-2 5051 y Fc(F)-8
-b(unctions)n(:)227 5197 y Fj(In)29 b(addition)f(to)g(those)g(routines)f
+(eing)i(added)g(to)f(the)h(KeyMap?)-2 1038 y Fc(F)-8
+b(unctions)n(:)227 1184 y Fj(In)29 b(addition)f(to)g(those)g(routines)f
(applicable)h(to)g(all)g(Ob)5 b(jects,)28 b(the)h(follo)n(wing)e
-(routines)g(ma)n(y)h(also)f(b)r(e)i(applied)227 5297
-y(to)f(all)f(KeyMaps:)340 5560 y Fi(\017)45 b Fj(AST)p
+(routines)g(ma)n(y)h(also)f(b)r(e)i(applied)227 1284
+y(to)f(all)f(KeyMaps:)340 1543 y Fi(\017)45 b Fj(AST)p
Ft(_)p Fj(MAPDEFINED:)28 b(Do)r(es)g(a)f(KeyMap)g(con)n(tain)f(a)i
-(de\014ned)g(v)-5 b(alue)27 b(for)g(a)g(k)n(ey?)340 5693
+(de\014ned)g(v)-5 b(alue)27 b(for)g(a)g(k)n(ey?)340 1674
y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPGET0)p Fl(<)p Fj(X)p
Fl(>)p Fj(:)36 b(Get)28 b(a)f(named)g(scalar)f(en)n(try)h(from)g(a)h
-(KeyMap)p eop end
-%%Page: 529 539
-TeXDict begin 529 538 bop 3643 52 a FG(529)340 351 y
-Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPGET1)p Fl(<)p Fj(X)p
-Fl(>)p Fj(:)36 b(Get)28 b(a)f(named)g(v)n(ector)g(en)n(try)g(from)g(a)g
-(KeyMap)340 484 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPGETELEM)p
-Fl(<)p Fj(X)p Fl(>)p Fj(:)35 b(Get)28 b(an)f(elemen)n(t)h(of)g(a)f
-(named)g(v)n(ector)g(en)n(try)g(from)g(a)g(KeyMap)340
-617 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPHASKEY:)28 b(Do)r(es)f(the)h
-(KeyMap)f(con)n(tain)g(a)g(named)h(en)n(try?)340 750
-y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPKEY:)27 b(Return)h(the)g(k)n(ey)f
-(name)g(at)h(a)f(giv)n(en)g(index)g(in)h(the)g(KeyMap)340
-883 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPLENC:)27 b(Get)h(the)g(length)
-g(of)g(a)f(named)g(c)n(haracter)f(en)n(try)h(in)h(a)f(KeyMap)340
-1016 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPLENGTH:)28
+(KeyMap)340 1806 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPGET1)p
+Fl(<)p Fj(X)p Fl(>)p Fj(:)36 b(Get)28 b(a)f(named)g(v)n(ector)g(en)n
+(try)g(from)g(a)g(KeyMap)340 1937 y Fi(\017)45 b Fj(AST)p
+Ft(_)p Fj(MAPGETELEM)p Fl(<)p Fj(X)p Fl(>)p Fj(:)35 b(Get)28
+b(an)f(elemen)n(t)h(of)g(a)f(named)g(v)n(ector)g(en)n(try)g(from)g(a)g
+(KeyMap)340 2069 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPHASKEY:)28
+b(Do)r(es)f(the)h(KeyMap)f(con)n(tain)g(a)g(named)h(en)n(try?)340
+2200 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPKEY:)27 b(Return)h(the)g(k)n
+(ey)f(name)g(at)h(a)f(giv)n(en)g(index)g(in)h(the)g(KeyMap)340
+2332 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPLENC:)27 b(Get)h(the)g
+(length)g(of)g(a)f(named)g(c)n(haracter)f(en)n(try)h(in)h(a)f(KeyMap)
+340 2464 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPLENGTH:)28
b(Get)g(the)g(length)g(of)f(a)g(named)h(en)n(try)f(in)h(a)f(KeyMap)340
-1149 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPCOPY:)27 b(Cop)n(y)g(en)n
+2595 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPCOPY:)27 b(Cop)n(y)g(en)n
(tries)g(from)g(one)g(KeyMap)g(in)n(to)g(another)340
-1282 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPPUT0)p Fl(<)p
+2727 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPPUT0)p Fl(<)p
Fj(X)p Fl(>)p Fj(:)36 b(Add)28 b(a)f(new)h(scalar)e(en)n(try)h(to)g(a)g
-(KeyMap)340 1415 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPPUT1)p
+(KeyMap)340 2858 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPPUT1)p
Fl(<)p Fj(X)p Fl(>)p Fj(:)36 b(Add)28 b(a)f(new)h(v)n(ector)e(en)n(try)
-h(to)h(a)f(KeyMap)340 1548 y Fi(\017)45 b Fj(AST)p Ft(_)p
+h(to)h(a)f(KeyMap)340 2990 y Fi(\017)45 b Fj(AST)p Ft(_)p
Fj(MAPPUTELEM)p Fl(<)p Fj(X)p Fl(>)p Fj(:)35 b(Puts)28
b(a)f(v)-5 b(alue)27 b(in)n(to)h(a)f(v)n(ector)f(en)n(try)h(in)h(a)f
-(KeyMap)340 1680 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPPUTU:)28
+(KeyMap)340 3121 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPPUTU:)28
b(Add)g(a)f(new)h(en)n(try)f(to)g(a)h(KeyMap)e(with)i(an)g(unde\014ned)
-g(v)-5 b(alue)340 1813 y Fi(\017)45 b Fj(AST)p Ft(_)p
+g(v)-5 b(alue)340 3253 y Fi(\017)45 b Fj(AST)p Ft(_)p
Fj(MAPREMO)n(VE:)27 b(Remo)n(v)n(ed)f(a)h(named)h(en)n(try)f(from)g(a)g
-(KeyMap)340 1946 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPRENAME:)28
+(KeyMap)340 3384 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPRENAME:)28
b(Rename)f(an)g(existing)g(en)n(try)g(in)h(a)g(KeyMap)340
-2079 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPSIZE:)27 b(Get)h(the)g(n)n
+3516 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPSIZE:)27 b(Get)h(the)g(n)n
(um)n(b)r(er)f(of)h(en)n(tries)f(in)h(a)f(KeyMap)340
-2212 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPTYPE:)27 b(Return)h(the)g
+3647 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPTYPE:)27 b(Return)h(the)g
(data)f(t)n(yp)r(e)h(of)f(a)g(named)h(en)n(try)f(in)h(a)f(map)p
-0 2412 3780 12 v 0 2542 a FA(LutMap)742 2543 y Fd(T)-10
+0 3844 3780 12 v 0 3975 a FA(LutMap)742 3976 y Fd(T)-10
b(ransform)37 b(1-dimensional)f(co)s(ordinates)g(using)j(a)1571
-2658 y(lo)s(okup)f(table)3304 2542 y FA(LutMap)0 2847
+4090 y(lo)s(okup)f(table)3304 3975 y FA(LutMap)0 4277
y Fc(Description:)44 b Fj(A)30 b(LutMap)g(is)g(a)f(sp)r(ecialised)g
(form)h(of)f(Mapping)h(whic)n(h)f(transforms)g(1-dimensional)f(co)r
-(ordinates)227 2946 y(b)n(y)g(using)f(linear)g(in)n(terp)r(olation)f
-(in)i(a)f(lo)r(okup)h(table.)227 3071 y(Eac)n(h)d(input)h(co)r
+(ordinates)227 4376 y(b)n(y)g(using)f(linear)g(in)n(terp)r(olation)f
+(in)i(a)f(lo)r(okup)h(table.)227 4500 y(Eac)n(h)d(input)h(co)r
(ordinate)e(v)-5 b(alue)26 b(is)f(\014rst)g(scaled)g(to)g(giv)n(e)g
(the)h(index)f(of)h(an)f(en)n(try)g(in)h(the)g(table)f(b)n(y)g
-(subtracting)227 3171 y(a)32 b(starting)f(v)-5 b(alue)31
+(subtracting)227 4600 y(a)32 b(starting)f(v)-5 b(alue)31
b(\(the)i(input)f(co)r(ordinate)f(corresp)r(onding)f(to)h(the)h
(\014rst)g(table)g(en)n(try\))f(and)h(dividing)f(b)n(y)h(an)227
-3270 y(incremen)n(t)c(\(the)g(di\013erence)f(in)h(input)h(co)r
+4699 y(incremen)n(t)c(\(the)g(di\013erence)f(in)h(input)h(co)r
(ordinate)d(v)-5 b(alue)28 b(b)r(et)n(w)n(een)f(adjacen)n(t)g(table)h
-(en)n(tries\).)227 3395 y(The)j(resulting)g(index)g(will)g(usually)g
+(en)n(tries\).)227 4823 y(The)j(resulting)g(index)g(will)g(usually)g
(con)n(tain)f(a)h(fractional)f(part,)i(so)e(the)i(output)f(co)r
-(ordinate)f(v)-5 b(alue)31 b(is)g(then)227 3495 y(generated)f(b)n(y)g
+(ordinate)f(v)-5 b(alue)31 b(is)g(then)227 4923 y(generated)f(b)n(y)g
(in)n(terp)r(olating)f(linearly)h(b)r(et)n(w)n(een)g(the)h(appropriate)
d(en)n(tries)i(in)h(the)f(table.)46 b(If)31 b(the)f(index)h(lies)227
-3594 y(outside)h(the)h(range)e(of)h(the)h(table,)g(linear)e(extrap)r
+5022 y(outside)h(the)h(range)e(of)h(the)h(table,)g(linear)e(extrap)r
(olation)g(is)h(used)h(based)e(on)h(the)h(t)n(w)n(o)e(nearest)h(en)n
-(tries)f(\(i.e.)227 3694 y(the)26 b(t)n(w)n(o)e(en)n(tries)g(at)h(the)g
+(tries)f(\(i.e.)227 5122 y(the)26 b(t)n(w)n(o)e(en)n(tries)g(at)h(the)g
(start)f(or)g(end)h(of)g(the)g(table,)h(as)e(appropriate\).)35
b(If)25 b(either)g(of)g(the)g(en)n(tries)f(used)h(for)f(the)227
-3793 y(in)n(terplation)j(has)g(a)g(v)-5 b(alue)28 b(of)f(AST)p
+5222 y(in)n(terplation)j(has)g(a)g(v)-5 b(alue)28 b(of)f(AST)p
Ft(__)p Fj(BAD,)h(then)g(the)g(in)n(terp)r(olated)f(v)-5
b(alue)28 b(is)f(returned)h(as)e(AST)p Ft(__)p Fj(BAD.)227
-3918 y(If)g(the)g(lo)r(okup)f(table)g(en)n(tries)g(increase)f(or)g
+5346 y(If)g(the)g(lo)r(okup)f(table)g(en)n(tries)g(increase)f(or)g
(decrease)g(monotonically)h(\(ignoring)f(an)n(y)g(\015at)i(sections\),)
-f(then)h(the)227 4018 y(in)n(v)n(erse)g(transformation)g(ma)n(y)h(also)
-g(b)r(e)h(p)r(erformed.)0 4167 y Fc(Constructor)k(F)-8
-b(unction:)227 4267 y Fj(AST)p Ft(_)p Fj(LUTMAP)-2 4417
-y Fc(Inheritance)n(:)227 4563 y Fj(The)28 b(LutMap)g(class)e(inherits)i
-(from)f(the)h(Mapping)f(class.)-2 4712 y Fc(A)m(ttributes)n(:)227
-4858 y Fj(In)38 b(addition)g(to)f(those)h(attributes)f(common)h(to)f
-(all)h(Mappings,)h(ev)n(ery)e(LutMap)h(also)e(has)i(the)g(follo)n(wing)
-227 4958 y(attributes:)340 5219 y Fi(\017)45 b Fj(LutIn)n(terp:)37
+f(then)h(the)227 5445 y(in)n(v)n(erse)g(transformation)g(ma)n(y)h(also)
+g(b)r(e)h(p)r(erformed.)0 5593 y Fc(Constructor)k(F)-8
+b(unction:)227 5693 y Fj(AST)p Ft(_)p Fj(LUTMAP)p eop
+end
+%%Page: 536 546
+TeXDict begin 536 545 bop 0 52 a FG(536)2251 b Fz(D)91
+b(AST)30 b(CLASS)f(DESCRIPTIONS)-2 351 y Fc(Inheritance)n(:)227
+497 y Fj(The)f(LutMap)g(class)e(inherits)i(from)f(the)h(Mapping)f
+(class.)-2 644 y Fc(A)m(ttributes)n(:)227 791 y Fj(In)38
+b(addition)g(to)f(those)h(attributes)f(common)h(to)f(all)h(Mappings,)h
+(ev)n(ery)e(LutMap)h(also)e(has)i(the)g(follo)n(wing)227
+890 y(attributes:)340 1148 y Fi(\017)45 b Fj(LutIn)n(terp:)37
b(The)28 b(in)n(terp)r(olation)f(metho)r(d)h(to)f(use)h(b)r(et)n(w)n
-(een)f(table)h(en)n(tries.)-2 5381 y Fc(F)-8 b(unctions)n(:)227
-5527 y Fj(The)40 b(LutMap)g(class)f(do)r(es)g(not)h(de\014ne)g(an)n(y)e
+(een)f(table)h(en)n(tries.)-2 1307 y Fc(F)-8 b(unctions)n(:)227
+1453 y Fj(The)40 b(LutMap)g(class)f(do)r(es)g(not)h(de\014ne)g(an)n(y)e
(new)i(routines)f(b)r(ey)n(ond)h(those)f(whic)n(h)h(are)e(applicable)h
-(to)h(all)227 5627 y(Mappings.)p eop end
-%%Page: 530 540
-TeXDict begin 530 539 bop 0 52 a FG(530)2251 b Fz(D)91
-b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 483
+(to)h(all)227 1553 y(Mappings.)p 0 1747 3780 12 v 0 1879
a FA(Mapping)466 b Fd(In)m(ter-relate)36 b(t)m(w)m(o)h(co)s(ordinate)g
-(systems)466 b FA(Mapping)0 678 y Fc(Description:)44
+(systems)466 b FA(Mapping)0 2068 y Fc(Description:)44
b Fj(This)29 b(class)e(pro)n(vides)g(the)i(basic)f(facilities)h(for)f
(transforming)f(a)h(set)g(of)h(co)r(ordinates)e(\(represen)n(ting)227
-777 y Ft(")p Fj(input)p Ft(")38 b Fj(p)r(oin)n(ts\))g(to)g(giv)n(e)e(a)
-i(new)g(set)f(of)h(co)r(ordinates)f(\(represen)n(ting)f
+2168 y Ft(")p Fj(input)p Ft(")38 b Fj(p)r(oin)n(ts\))g(to)g(giv)n(e)e
+(a)i(new)g(set)f(of)h(co)r(ordinates)f(\(represen)n(ting)f
Ft(")p Fj(output)p Ft(")i Fj(p)r(oin)n(ts\).)67 b(It)38
-b(is)g(used)g(to)227 877 y(describ)r(e)28 b(the)g(relationship)f(whic)n
-(h)h(exists)f(b)r(et)n(w)n(een)h(t)n(w)n(o)f(di\013eren)n(t)h(co)r
-(ordinate)f(systems)h(and)f(to)h(implemen)n(t)227 977
+b(is)g(used)g(to)227 2267 y(describ)r(e)28 b(the)g(relationship)f(whic)
+n(h)h(exists)f(b)r(et)n(w)n(een)h(t)n(w)n(o)f(di\013eren)n(t)h(co)r
+(ordinate)f(systems)h(and)f(to)h(implemen)n(t)227 2367
y(op)r(erations)22 b(whic)n(h)i(mak)n(e)e(use)i(of)f(this)h(\(suc)n(h)f
(as)g(transforming)f(co)r(ordinates)g(and)i(resampling)e(grids)g(of)i
-(data\).)227 1076 y(Ho)n(w)n(ev)n(er,)38 b(the)f(Mapping)g(class)f(do)r
+(data\).)227 2466 y(Ho)n(w)n(ev)n(er,)38 b(the)f(Mapping)g(class)f(do)r
(es)h(not)g(ha)n(v)n(e)f(a)h(constructor)f(function)h(of)g(its)h(o)n
-(wn,)h(as)d(it)i(is)f(simply)g(a)227 1176 y(con)n(tainer)22
+(wn,)h(as)d(it)i(is)f(simply)g(a)227 2566 y(con)n(tainer)22
b(class)g(for)g(a)g(family)h(of)g(sp)r(ecialised)f(Mappings)g(whic)n(h)
h(implemen)n(t)g(particular)e(t)n(yp)r(es)i(of)g(co)r(ordinate)227
-1276 y(transformation.)0 1427 y Fc(Constructor)32 b(F)-8
-b(unction:)227 1526 y Fj(None.)-2 1677 y Fc(Inheritance)n(:)227
-1823 y Fj(The)28 b(Mapping)f(class)g(inherits)g(from)h(the)g(Ob)5
-b(ject)27 b(class.)-2 1974 y Fc(A)m(ttributes)n(:)227
-2120 y Fj(In)42 b(addition)e(to)h(those)g(attributes)g(common)g(to)f
+2666 y(transformation.)0 2813 y Fc(Constructor)32 b(F)-8
+b(unction:)227 2912 y Fj(None.)-2 3059 y Fc(Inheritance)n(:)227
+3206 y Fj(The)28 b(Mapping)f(class)g(inherits)g(from)h(the)g(Ob)5
+b(ject)27 b(class.)-2 3353 y Fc(A)m(ttributes)n(:)227
+3499 y Fj(In)42 b(addition)e(to)h(those)g(attributes)g(common)g(to)f
(all)h(Ob)5 b(jects,)44 b(ev)n(ery)c(Mapping)h(also)f(has)g(the)i
-(follo)n(wing)227 2220 y(attributes:)340 2483 y Fi(\017)j
+(follo)n(wing)227 3598 y(attributes:)340 3856 y Fi(\017)j
Fj(In)n(v)n(ert:)36 b(Mapping)27 b(in)n(v)n(ersion)f(\015ag)340
-2617 y Fi(\017)45 b Fj(IsLinear:)36 b(Is)27 b(the)h(Mapping)g(linear?)
-340 2750 y Fi(\017)45 b Fj(IsSimple:)37 b(Has)28 b(the)g(Mapping)f(b)r
-(een)h(simpli\014ed?)340 2884 y Fi(\017)45 b Fj(Nin:)38
+3986 y Fi(\017)45 b Fj(IsLinear:)36 b(Is)27 b(the)h(Mapping)g(linear?)
+340 4117 y Fi(\017)45 b Fj(IsSimple:)37 b(Has)28 b(the)g(Mapping)f(b)r
+(een)h(simpli\014ed?)340 4247 y Fi(\017)45 b Fj(Nin:)38
b(Num)n(b)r(er)27 b(of)h(input)g(co)r(ordinates)f(for)g(a)g(Mapping)340
-3017 y Fi(\017)45 b Fj(Nout:)37 b(Num)n(b)r(er)28 b(of)g(output)g(co)r
-(ordinates)e(for)h(a)g(Mapping)340 3151 y Fi(\017)45
+4378 y Fi(\017)45 b Fj(Nout:)37 b(Num)n(b)r(er)28 b(of)g(output)g(co)r
+(ordinates)e(for)h(a)g(Mapping)340 4508 y Fi(\017)45
b Fj(Rep)r(ort:)37 b(Rep)r(ort)27 b(transformed)g(co)r(ordinates?)340
-3284 y Fi(\017)45 b Fj(T)-7 b(ranF)g(orw)n(ard:)35 b(F)-7
-b(orw)n(ard)25 b(transformation)h(de\014ned?)340 3418
+4639 y Fi(\017)45 b Fj(T)-7 b(ranF)g(orw)n(ard:)35 b(F)-7
+b(orw)n(ard)25 b(transformation)h(de\014ned?)340 4769
y Fi(\017)45 b Fj(T)-7 b(ranIn)n(v)n(erse:)35 b(In)n(v)n(erse)26
-b(transformation)g(de\014ned?)-2 3581 y Fc(F)-8 b(unctions)n(:)227
-3727 y Fj(In)29 b(addition)f(to)g(those)g(routines)f(applicable)h(to)g
+b(transformation)g(de\014ned?)-2 4929 y Fc(F)-8 b(unctions)n(:)227
+5075 y Fj(In)29 b(addition)f(to)g(those)g(routines)f(applicable)h(to)g
(all)g(Ob)5 b(jects,)28 b(the)h(follo)n(wing)e(routines)g(ma)n(y)h
-(also)f(b)r(e)i(applied)227 3827 y(to)f(all)f(Mappings:)340
-4090 y Fi(\017)45 b Fj(astRebinSeq)p Fl(<)p Fj(X)p Fl(>)p
+(also)f(b)r(e)i(applied)227 5175 y(to)f(all)f(Mappings:)340
+5432 y Fi(\017)45 b Fj(astRebinSeq)p Fl(<)p Fj(X)p Fl(>)p
Fj(:)36 b(Rebin)28 b(a)g(region)e(of)h(a)h(sequence)f(of)g(data)g
-(grids)340 4224 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(DECOMPOSE:)26
+(grids)340 5563 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(DECOMPOSE:)26
b(Decomp)r(ose)h(a)h(Mapping)f(in)n(to)g(t)n(w)n(o)g(comp)r(onen)n(t)g
-(Mappings)340 4357 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(TRANGRID:)29
-b(T)-7 b(ransform)26 b(a)i(grid)e(of)i(p)r(ositions)340
-4491 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(INVER)-7 b(T:)28
-b(In)n(v)n(ert)f(a)g(Mapping)340 4624 y Fi(\017)45 b
-Fj(AST)p Ft(_)p Fj(LINEARAPPR)n(O)n(X:)27 b(Calculate)g(a)g(linear)g
-(appro)n(ximation)e(to)j(a)f(Mapping)340 4758 y Fi(\017)45
-b Fj(AST)p Ft(_)p Fj(QUAD)n(APPR)n(O)n(X:)27 b(Calculate)g(a)g
-(quadratic)f(appro)n(ximation)g(to)i(a)f(2D)g(Mapping)340
-4892 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPBO)n(X:)27
+(Mappings)340 5693 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(TRANGRID:)29
+b(T)-7 b(ransform)26 b(a)i(grid)e(of)i(p)r(ositions)p
+eop end
+%%Page: 537 547
+TeXDict begin 537 546 bop 3643 52 a FG(537)340 351 y
+Fi(\017)45 b Fj(AST)p Ft(_)p Fj(INVER)-7 b(T:)28 b(In)n(v)n(ert)f(a)g
+(Mapping)340 503 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(LINEARAPPR)n(O)n(X:)
+27 b(Calculate)g(a)g(linear)g(appro)n(ximation)e(to)j(a)f(Mapping)340
+655 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(QUAD)n(APPR)n(O)n(X:)27
+b(Calculate)g(a)g(quadratic)f(appro)n(ximation)g(to)i(a)f(2D)g(Mapping)
+340 806 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPBO)n(X:)27
b(Find)h(a)g(b)r(ounding)f(b)r(o)n(x)g(for)g(a)h(Mapping)340
-5025 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPSPLIT:)27 b(Split)i(a)e
+958 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MAPSPLIT:)27 b(Split)i(a)e
(Mapping)g(up)h(in)n(to)f(parallel)g(comp)r(onen)n(t)g(Mappings)340
-5159 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(RA)-7 b(TE:)28
+1110 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(RA)-7 b(TE:)28
b(Calculate)f(the)h(rate)f(of)g(c)n(hange)g(of)g(a)g(Mapping)h(output)
-340 5292 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(REBIN)p Fl(<)p
+340 1262 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(REBIN)p Fl(<)p
Fj(X)p Fl(>)p Fj(:)36 b(Rebin)28 b(a)f(region)g(of)g(a)g(data)h(grid)
-340 5426 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(REBINSEQ)p
+340 1413 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(REBINSEQ)p
Fl(<)p Fj(X)p Fl(>)p Fj(:)35 b(Rebin)28 b(a)g(region)e(of)h(a)h
-(sequence)f(of)g(data)g(grids)340 5559 y Fi(\017)45 b
+(sequence)f(of)g(data)g(grids)340 1565 y Fi(\017)45 b
Fj(AST)p Ft(_)p Fj(REMO)n(VEREGIONS:)26 b(Remo)n(v)n(e)h(an)n(y)g
-(Regions)f(from)i(a)f(Mapping)340 5693 y Fi(\017)45 b
+(Regions)f(from)i(a)f(Mapping)340 1717 y Fi(\017)45 b
Fj(AST)p Ft(_)p Fj(RESAMPLE)p Fl(<)p Fj(X)p Fl(>)p Fj(:)36
-b(Resample)27 b(a)g(region)f(of)i(a)f(data)g(grid)p eop
-end
-%%Page: 531 541
-TeXDict begin 531 540 bop 3643 52 a FG(531)340 351 y
-Fi(\017)45 b Fj(AST)p Ft(_)p Fj(SIMPLIFY:)28 b(Simplify)g(a)g(Mapping)
-340 469 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(TRAN1:)37 b(T)-7
-b(ransform)26 b(1-dimensional)h(co)r(ordinates)340 587
-y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(TRAN2:)37 b(T)-7 b(ransform)26
-b(2-dimensional)h(co)r(ordinates)340 705 y Fi(\017)45
-b Fj(AST)p Ft(_)p Fj(TRANN:)29 b(T)-7 b(ransform)26 b(N-dimensional)h
-(co)r(ordinates)p 0 874 3780 12 v 0 1005 a FA(MathMap)207
-b Fd(T)-10 b(ransform)36 b(co)s(ordinates)h(using)h(mathematical)1604
-1116 y(expressions)3192 1005 y FA(MathMap)0 1280 y Fc(Description:)44
-b Fj(A)36 b(MathMap)e(is)h(a)f(Mapping)h(whic)n(h)f(allo)n(ws)g(y)n(ou)
-g(to)h(sp)r(ecify)g(a)f(set)h(of)g(forw)n(ard)e(and/or)g(in)n(v)n(erse)
-227 1379 y(transformation)26 b(functions)i(using)g(arithmetic)f(op)r
-(erations)g(and)g(mathematical)g(functions)h(similar)f(to)h(those)227
-1479 y(a)n(v)-5 b(ailable)30 b(in)i(F)-7 b(ortran.)46
-b(The)31 b(MathMap)g(in)n(terprets)g(these)g(functions)h(at)f
-(run-time,)h(whenev)n(er)e(its)h(forw)n(ard)227 1578
-y(or)c(in)n(v)n(erse)g(transformation)f(is)i(required.)37
-b(Because)27 b(the)h(functions)h(are)e(not)h(compiled)g(in)g(the)g
-(normal)f(sense)227 1678 y(\(unlik)n(e)g(an)e(In)n(traMap\),)h(they)g
-(ma)n(y)g(b)r(e)g(used)g(to)g(describ)r(e)g(co)r(ordinate)f
-(transformations)f(in)i(a)g(transp)r(ortable)227 1778
-y(manner.)53 b(A)33 b(MathMap)g(therefore)f(pro)n(vides)f(a)i
+b(Resample)27 b(a)g(region)f(of)i(a)f(data)g(grid)340
+1868 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(SIMPLIFY:)28 b(Simplify)g(a)g
+(Mapping)340 2020 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(TRAN1:)37
+b(T)-7 b(ransform)26 b(1-dimensional)h(co)r(ordinates)340
+2172 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(TRAN2:)37 b(T)-7
+b(ransform)26 b(2-dimensional)h(co)r(ordinates)340 2324
+y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(TRANN:)29 b(T)-7 b(ransform)26
+b(N-dimensional)h(co)r(ordinates)p 0 2561 3780 12 v 0
+2692 a FA(MathMap)207 b Fd(T)-10 b(ransform)36 b(co)s(ordinates)h
+(using)h(mathematical)1604 2803 y(expressions)3192 2692
+y FA(MathMap)0 3034 y Fc(Description:)44 b Fj(A)36 b(MathMap)e(is)h(a)f
+(Mapping)h(whic)n(h)f(allo)n(ws)g(y)n(ou)g(to)h(sp)r(ecify)g(a)f(set)h
+(of)g(forw)n(ard)e(and/or)g(in)n(v)n(erse)227 3134 y(transformation)26
+b(functions)i(using)g(arithmetic)f(op)r(erations)g(and)g(mathematical)g
+(functions)h(similar)f(to)h(those)227 3234 y(a)n(v)-5
+b(ailable)30 b(in)i(F)-7 b(ortran.)46 b(The)31 b(MathMap)g(in)n
+(terprets)g(these)g(functions)h(at)f(run-time,)h(whenev)n(er)e(its)h
+(forw)n(ard)227 3333 y(or)c(in)n(v)n(erse)g(transformation)f(is)i
+(required.)37 b(Because)27 b(the)h(functions)h(are)e(not)h(compiled)g
+(in)g(the)g(normal)f(sense)227 3433 y(\(unlik)n(e)g(an)e(In)n
+(traMap\),)h(they)g(ma)n(y)g(b)r(e)g(used)g(to)g(describ)r(e)g(co)r
+(ordinate)f(transformations)f(in)i(a)g(transp)r(ortable)227
+3533 y(manner.)53 b(A)33 b(MathMap)g(therefore)f(pro)n(vides)f(a)i
(\015exible)g(w)n(a)n(y)f(of)h(de\014ning)g(new)g(t)n(yp)r(es)g(of)g
-(Mapping)f(whose)227 1877 y(descriptions)27 b(ma)n(y)g(b)r(e)h(stored)f
+(Mapping)f(whose)227 3632 y(descriptions)27 b(ma)n(y)g(b)r(e)h(stored)f
(as)g(part)g(of)g(a)g(dataset)h(and)f(in)n(terpreted)g(b)n(y)g(other)g
-(programs.)0 2012 y Fc(Constructor)32 b(F)-8 b(unction:)227
-2111 y Fj(AST)p Ft(_)p Fj(MA)h(THMAP)-2 2246 y Fc(Inheritance)n(:)227
-2392 y Fj(The)28 b(MathMap)f(class)g(inherits)h(from)f(the)h(Mapping)f
-(class.)-2 2526 y Fc(A)m(ttributes)n(:)227 2672 y Fj(In)34
+(programs.)0 3819 y Fc(Constructor)32 b(F)-8 b(unction:)227
+3919 y Fj(AST)p Ft(_)p Fj(MA)h(THMAP)-2 4106 y Fc(Inheritance)n(:)227
+4252 y Fj(The)28 b(MathMap)f(class)g(inherits)h(from)f(the)h(Mapping)f
+(class.)-2 4439 y Fc(A)m(ttributes)n(:)227 4586 y Fj(In)34
b(addition)f(to)g(those)f(attributes)h(common)g(to)g(all)g(Mappings,)h
(ev)n(ery)e(MathMap)h(also)f(has)g(the)i(follo)n(wing)227
-2772 y(attributes:)340 2893 y Fi(\017)45 b Fj(Seed:)37
-b(Random)28 b(n)n(um)n(b)r(er)f(seed)340 3011 y Fi(\017)45
+4685 y(attributes:)340 4859 y Fi(\017)45 b Fj(Seed:)37
+b(Random)28 b(n)n(um)n(b)r(er)f(seed)340 5011 y Fi(\017)45
b Fj(SimpFI:)29 b(F)-7 b(orw)n(ard-in)n(v)n(erse)24 b(MathMap)j(pairs)g
-(simplify?)340 3129 y Fi(\017)45 b Fj(SimpIF:)29 b(In)n(v)n(erse-forw)n
-(ard)24 b(MathMap)j(pairs)g(simplify?)-2 3276 y Fc(F)-8
-b(unctions)n(:)227 3422 y Fj(The)36 b(MathMap)f(class)f(do)r(es)h(not)g
+(simplify?)340 5163 y Fi(\017)45 b Fj(SimpIF:)29 b(In)n(v)n(erse-forw)n
+(ard)24 b(MathMap)j(pairs)g(simplify?)-2 5362 y Fc(F)-8
+b(unctions)n(:)227 5509 y Fj(The)36 b(MathMap)f(class)f(do)r(es)h(not)g
(de\014ne)h(an)n(y)e(new)i(routines)e(b)r(ey)n(ond)h(those)g(whic)n(h)h
-(are)e(applicable)h(to)g(all)227 3521 y(Mappings.)p 0
-3691 V 0 3822 a FA(MatrixMap)264 b Fd(Map)39 b(co)s(ordinates)e(b)m(y)h
-(m)m(ultiplying)d(b)m(y)k(a)1719 3933 y(matrix)3103 3822
-y FA(MatrixMap)0 4069 y Fc(Description:)44 b Fj(A)20
-b(MatrixMap)e(is)h(form)g(of)g(Mapping)g(whic)n(h)h(p)r(erforms)e(a)h
-(general)f(linear)g(transformation.)33 b(Eac)n(h)18 b(set)227
-4168 y(of)26 b(input)g(co)r(ordinates,)f(regarded)f(as)h(a)h(column-v)n
-(ector,)e(are)h(pre-m)n(ultiplied)g(b)n(y)h(a)f(matrix)g(\(whose)h
-(elemen)n(ts)227 4268 y(are)j(sp)r(eci\014ed)h(when)g(the)g(MatrixMap)f
-(is)g(created\))g(to)h(giv)n(e)e(a)i(new)f(column-v)n(ector)f(con)n
-(taining)h(the)h(output)227 4367 y(co)r(ordinates.)36
-b(If)28 b(appropriate,)e(the)i(in)n(v)n(erse)e(transformation)g(ma)n(y)
-h(also)f(b)r(e)i(p)r(erformed.)0 4502 y Fc(Constructor)k(F)-8
-b(unction:)227 4601 y Fj(AST)p Ft(_)p Fj(MA)h(TRIXMAP)-2
-4736 y Fc(Inheritance)n(:)227 4882 y Fj(The)28 b(MatrixMap)f(class)f
-(inherits)i(from)f(the)h(Mapping)f(class.)-2 5016 y Fc(A)m(ttributes)n
-(:)227 5162 y Fj(The)h(MatrixMap)e(class)h(do)r(es)g(not)g(de\014ne)h
+(are)e(applicable)h(to)g(all)227 5608 y(Mappings.)p eop
+end
+%%Page: 538 548
+TeXDict begin 538 547 bop 0 52 a FG(538)2251 b Fz(D)91
+b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 483
+a FA(MatrixMap)264 b Fd(Map)39 b(co)s(ordinates)e(b)m(y)h(m)m
+(ultiplying)d(b)m(y)k(a)1719 594 y(matrix)3103 483 y
+FA(MatrixMap)0 750 y Fc(Description:)44 b Fj(A)20 b(MatrixMap)e(is)h
+(form)g(of)g(Mapping)g(whic)n(h)h(p)r(erforms)e(a)h(general)f(linear)g
+(transformation.)33 b(Eac)n(h)18 b(set)227 850 y(of)26
+b(input)g(co)r(ordinates,)f(regarded)f(as)h(a)h(column-v)n(ector,)e
+(are)h(pre-m)n(ultiplied)g(b)n(y)h(a)f(matrix)g(\(whose)h(elemen)n(ts)
+227 949 y(are)j(sp)r(eci\014ed)h(when)g(the)g(MatrixMap)f(is)g
+(created\))g(to)h(giv)n(e)e(a)i(new)f(column-v)n(ector)f(con)n(taining)
+h(the)h(output)227 1049 y(co)r(ordinates.)36 b(If)28
+b(appropriate,)e(the)i(in)n(v)n(erse)e(transformation)g(ma)n(y)h(also)f
+(b)r(e)i(p)r(erformed.)0 1194 y Fc(Constructor)k(F)-8
+b(unction:)227 1293 y Fj(AST)p Ft(_)p Fj(MA)h(TRIXMAP)-2
+1438 y Fc(Inheritance)n(:)227 1584 y Fj(The)28 b(MatrixMap)f(class)f
+(inherits)i(from)f(the)h(Mapping)f(class.)-2 1729 y Fc(A)m(ttributes)n
+(:)227 1875 y Fj(The)h(MatrixMap)e(class)h(do)r(es)g(not)g(de\014ne)h
(an)n(y)f(new)g(attributes)h(b)r(ey)n(ond)f(those)g(whic)n(h)g(are)g
-(applicable)g(to)g(all)227 5262 y(Mappings.)-2 5396 y
-Fc(F)-8 b(unctions)n(:)227 5542 y Fj(The)32 b(MatrixMap)f(class)g(do)r
+(applicable)g(to)g(all)227 1975 y(Mappings.)-2 2120 y
+Fc(F)-8 b(unctions)n(:)227 2266 y Fj(The)32 b(MatrixMap)f(class)g(do)r
(es)g(not)h(de\014ne)g(an)n(y)f(new)h(routines)f(b)r(ey)n(ond)g(those)h
-(whic)n(h)f(are)g(applicable)g(to)h(all)227 5642 y(Mappings.)p
+(whic)n(h)f(are)g(applicable)g(to)h(all)227 2365 y(Mappings.)p
+0 2555 V 0 2686 a FA(NormMap)890 2687 y Fd(Normalise)k(co)s(ordinates)h
+(using)h(a)h(supplied)1730 2800 y(F)-10 b(rame)3172 2686
+y FA(NormMap)0 2956 y Fc(Description:)44 b Fj(The)26
+b(NormMap)e(class)g(implemen)n(ts)i(a)f(Mapping)g(whic)n(h)g
+(normalises)e(co)r(ordinate)i(v)-5 b(alues)24 b(using)h(the)227
+3056 y(AST)p Ft(_)p Fj(NORM)k(routine)g(of)g(a)f(supplied)i(F)-7
+b(rame.)40 b(The)29 b(n)n(um)n(b)r(er)g(of)g(inputs)h(and)e(outputs)i
+(of)f(a)f(NormMap)h(are)227 3156 y(b)r(oth)f(equal)f(to)h(the)g(n)n(um)
+n(b)r(er)f(of)h(axes)e(in)i(the)g(supplied)g(F)-7 b(rame.)227
+3278 y(The)26 b(forw)n(ard)f(and)h(in)n(v)n(erse)e(transformation)h(of)
+h(a)f(NormMap)h(are)f(b)r(oth)h(de\014ned)g(but)h(are)e(iden)n(tical)h
+(\(that)h(is,)227 3377 y(they)h(do)g(not)f(form)h(a)f(real)g(in)n(v)n
+(erse)f(pair)h(in)h(that)g(the)g(in)n(v)n(erse)e(transformation)g(do)r
+(es)i(not)f(undo)h(the)g(normal-)227 3477 y(isation,)h(instead)f(it)i
+(reapplies)d(it\).)42 b(Ho)n(w)n(ev)n(er,)27 b(the)i(AST)p
+Ft(_)p Fj(SIMPLIFY)g(function)g(will)g(replace)f(neigh)n(b)r(ouring)227
+3577 y(pairs)f(of)g(forw)n(ard)f(and)i(in)n(v)n(erse)e(NormMaps)h(b)n
+(y)g(a)g(single)g(UnitMap.)0 3721 y Fc(Constructor)32
+b(F)-8 b(unction:)227 3821 y Fj(AST)p Ft(_)p Fj(NORMMAP)-2
+3966 y Fc(Inheritance)n(:)227 4112 y Fj(The)28 b(NormMap)f(class)f
+(inherits)i(from)f(the)h(Mapping)f(class.)-2 4257 y Fc(A)m(ttributes)n
+(:)227 4403 y Fj(The)k(NormMap)e(class)h(do)r(es)g(not)g(de\014ne)h(an)
+n(y)e(new)i(attributes)f(b)r(ey)n(ond)g(those)g(whic)n(h)g(are)g
+(applicable)g(to)g(all)227 4503 y(Mappings.)-2 4647 y
+Fc(F)-8 b(unctions)n(:)227 4793 y Fj(The)35 b(NormMap)f(class)g(do)r
+(es)g(not)h(de\014ne)g(an)n(y)f(new)g(routines)g(b)r(ey)n(ond)h(those)f
+(whic)n(h)h(are)e(applicable)h(to)h(all)227 4893 y(Mappings.)p
+0 5083 V 0 5215 a FA(NullRegion)330 b Fd(A)39 b(b)s(oundless)f(region)g
+(within)f(a)h(F)-10 b(rame)328 b FA(NullRegion)0 5394
+y Fc(Description:)44 b Fj(The)21 b(NullRegion)g(class)f(implemen)n(ts)h
+(a)f(Region)h(with)g(no)f(b)r(ounds)h(within)h(a)e(F)-7
+b(rame.)35 b(If)21 b(the)g(Negated)227 5494 y(attribute)28
+b(of)f(a)h(NullRegion)f(is)g(false,)h(the)f(NullRegion)h(represen)n(ts)
+e(a)h(Region)g(con)n(taining)f(no)h(p)r(oin)n(ts.)37
+b(If)28 b(the)227 5593 y(Negated)k(attribute)g(of)h(a)e(NullRegion)i
+(is)f(true,)h(the)g(NullRegion)f(represen)n(ts)e(an)i(in\014nite)h
+(Region)f(\(that)h(is,)227 5693 y(all)28 b(p)r(oin)n(ts)f(in)h(the)g
+(co)r(ordinate)e(system)i(are)e(inside)i(the)g(NullRegion\).)p
eop end
-%%Page: 532 542
-TeXDict begin 532 541 bop 0 52 a FG(532)2251 b Fz(D)91
-b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 482
-a FA(NormMap)890 483 y Fd(Normalise)36 b(co)s(ordinates)h(using)h(a)h
-(supplied)1730 596 y(F)-10 b(rame)3172 482 y FA(NormMap)0
-769 y Fc(Description:)44 b Fj(The)26 b(NormMap)e(class)g(implemen)n(ts)
-i(a)f(Mapping)g(whic)n(h)g(normalises)e(co)r(ordinate)i(v)-5
-b(alues)24 b(using)h(the)227 869 y(AST)p Ft(_)p Fj(NORM)k(routine)g(of)
-g(a)f(supplied)i(F)-7 b(rame.)40 b(The)29 b(n)n(um)n(b)r(er)g(of)g
-(inputs)h(and)e(outputs)i(of)f(a)f(NormMap)h(are)227
-969 y(b)r(oth)f(equal)f(to)h(the)g(n)n(um)n(b)r(er)f(of)h(axes)e(in)i
-(the)g(supplied)g(F)-7 b(rame.)227 1097 y(The)26 b(forw)n(ard)f(and)h
-(in)n(v)n(erse)e(transformation)h(of)h(a)f(NormMap)h(are)f(b)r(oth)h
-(de\014ned)g(but)h(are)e(iden)n(tical)h(\(that)h(is,)227
-1196 y(they)h(do)g(not)f(form)h(a)f(real)g(in)n(v)n(erse)f(pair)h(in)h
-(that)g(the)g(in)n(v)n(erse)e(transformation)g(do)r(es)i(not)f(undo)h
-(the)g(normal-)227 1296 y(isation,)h(instead)f(it)i(reapplies)d(it\).)
-42 b(Ho)n(w)n(ev)n(er,)27 b(the)i(AST)p Ft(_)p Fj(SIMPLIFY)g(function)g
-(will)g(replace)f(neigh)n(b)r(ouring)227 1396 y(pairs)f(of)g(forw)n
-(ard)f(and)i(in)n(v)n(erse)e(NormMaps)h(b)n(y)g(a)g(single)g(UnitMap.)0
-1553 y Fc(Constructor)32 b(F)-8 b(unction:)227 1652 y
-Fj(AST)p Ft(_)p Fj(NORMMAP)-2 1809 y Fc(Inheritance)n(:)227
-1955 y Fj(The)28 b(NormMap)f(class)f(inherits)i(from)f(the)h(Mapping)f
-(class.)-2 2112 y Fc(A)m(ttributes)n(:)227 2258 y Fj(The)k(NormMap)e
-(class)h(do)r(es)g(not)g(de\014ne)h(an)n(y)e(new)i(attributes)f(b)r(ey)
-n(ond)g(those)g(whic)n(h)g(are)g(applicable)g(to)g(all)227
-2358 y(Mappings.)-2 2515 y Fc(F)-8 b(unctions)n(:)227
-2661 y Fj(The)35 b(NormMap)f(class)g(do)r(es)g(not)h(de\014ne)g(an)n(y)
-f(new)g(routines)g(b)r(ey)n(ond)h(those)f(whic)n(h)h(are)e(applicable)h
-(to)h(all)227 2761 y(Mappings.)p 0 2967 V 0 3099 a FA(NullRegion)330
-b Fd(A)39 b(b)s(oundless)f(region)g(within)f(a)h(F)-10
-b(rame)328 b FA(NullRegion)0 3295 y Fc(Description:)44
-b Fj(The)21 b(NullRegion)g(class)f(implemen)n(ts)h(a)f(Region)h(with)g
-(no)f(b)r(ounds)h(within)h(a)e(F)-7 b(rame.)35 b(If)21
-b(the)g(Negated)227 3395 y(attribute)28 b(of)f(a)h(NullRegion)f(is)g
-(false,)h(the)f(NullRegion)h(represen)n(ts)e(a)h(Region)g(con)n
-(taining)f(no)h(p)r(oin)n(ts.)37 b(If)28 b(the)227 3495
-y(Negated)k(attribute)g(of)h(a)e(NullRegion)i(is)f(true,)h(the)g
-(NullRegion)f(represen)n(ts)e(an)i(in\014nite)h(Region)f(\(that)h(is,)
-227 3594 y(all)28 b(p)r(oin)n(ts)f(in)h(the)g(co)r(ordinate)e(system)i
-(are)e(inside)i(the)g(NullRegion\).)0 3751 y Fc(Constructor)k(F)-8
-b(unction:)227 3851 y Fj(AST)p Ft(_)p Fj(NULLREGION)-2
-4008 y Fc(Inheritance)n(:)227 4154 y Fj(The)28 b(NullRegion)f(class)g
-(inherits)g(from)h(the)g(Region)f(class.)-2 4311 y Fc(A)m(ttributes)n
-(:)227 4457 y Fj(The)h(NullRegion)g(class)f(do)r(es)h(not)g(de\014ne)g
-(an)n(y)f(new)h(attributes)g(b)r(ey)n(ond)g(those)g(whic)n(h)g(are)f
-(applicable)g(to)h(all)227 4556 y(Regions.)-2 4713 y
-Fc(F)-8 b(unctions)n(:)227 4859 y Fj(The)33 b(NullRegion)f(class)f(do)r
+%%Page: 539 549
+TeXDict begin 539 548 bop 3643 52 a FG(539)0 351 y Fc(Constructor)32
+b(F)-8 b(unction:)227 451 y Fj(AST)p Ft(_)p Fj(NULLREGION)-2
+603 y Fc(Inheritance)n(:)227 749 y Fj(The)28 b(NullRegion)f(class)g
+(inherits)g(from)h(the)g(Region)f(class.)-2 900 y Fc(A)m(ttributes)n(:)
+227 1046 y Fj(The)h(NullRegion)g(class)f(do)r(es)h(not)g(de\014ne)g(an)
+n(y)f(new)h(attributes)g(b)r(ey)n(ond)g(those)g(whic)n(h)g(are)f
+(applicable)g(to)h(all)227 1146 y(Regions.)-2 1298 y
+Fc(F)-8 b(unctions)n(:)227 1444 y Fj(The)33 b(NullRegion)f(class)f(do)r
(es)h(not)g(de\014ne)h(an)n(y)e(new)i(routines)e(b)r(ey)n(ond)h(those)g
-(whic)n(h)h(are)e(applicable)h(to)g(all)227 4959 y(Regions.)p
-0 5166 V 0 5297 a FA(Ob)7 b(ject)710 b Fd(Base)39 b(class)f(for)g(all)g
-(AST)g(Ob)7 b(jects)709 b FA(Ob)7 b(ject)0 5494 y Fc(Description:)44
-b Fj(This)33 b(class)e(is)h(the)h(base)f(class)f(from)h(whic)n(h)g(all)
-g(other)g(classes)f(in)i(the)f(AST)h(library)e(are)g(deriv)n(ed.)227
-5593 y(It)e(pro)n(vides)e(all)h(the)g(basic)g(Ob)5 b(ject)28
-b(b)r(eha)n(viour)f(and)h(Ob)5 b(ject)28 b(manipulation)g(facilities)g
-(required)f(throughout)227 5693 y(the)h(library)-7 b(.)36
-b(There)27 b(is)g(no)h(Ob)5 b(ject)27 b(constructor,)f(ho)n(w)n(ev)n
-(er,)g(as)h(Ob)5 b(jects)27 b(on)g(their)h(o)n(wn)f(are)f(not)i
-(useful.)p eop end
-%%Page: 533 543
-TeXDict begin 533 542 bop 3643 52 a FG(533)0 351 y Fc(Constructor)32
-b(F)-8 b(unction:)227 451 y Fj(None.)-2 609 y Fc(Inheritance)n(:)227
-755 y Fj(The)28 b(Ob)5 b(ject)27 b(base)g(class)g(do)r(es)g(not)h
-(inherit)g(from)f(an)n(y)g(other)g(class.)-2 913 y Fc(A)m(ttributes)n
-(:)227 1059 y Fj(All)h(Ob)5 b(jects)28 b(ha)n(v)n(e)e(the)i(follo)n
-(wing)e(attributes:)340 1332 y Fi(\017)45 b Fj(Class:)36
-b(Ob)5 b(ject)28 b(class)e(name)340 1469 y Fi(\017)45
-b Fj(ID:)28 b(Ob)5 b(ject)28 b(iden)n(ti\014cation)f(string)340
-1607 y Fi(\017)45 b Fj(Iden)n(t:)37 b(P)n(ermanen)n(t)26
-b(Ob)5 b(ject)28 b(iden)n(ti\014cation)f(string)340 1744
-y Fi(\017)45 b Fj(Nob)5 b(ject:)37 b(Num)n(b)r(er)28
-b(of)g(Ob)5 b(jects)27 b(in)h(class)340 1881 y Fi(\017)45
-b Fj(Ob)5 b(jSize:)37 b(The)28 b(in-memory)e(size)h(of)h(the)g(Ob)5
-b(ject)27 b(in)h(b)n(ytes)340 2018 y Fi(\017)45 b Fj(RefCoun)n(t:)37
+(whic)n(h)h(are)e(applicable)h(to)g(all)227 1543 y(Regions.)p
+0 1745 3780 12 v 0 1876 a FA(Ob)7 b(ject)710 b Fd(Base)39
+b(class)f(for)g(all)g(AST)g(Ob)7 b(jects)709 b FA(Ob)7
+b(ject)0 2067 y Fc(Description:)44 b Fj(This)33 b(class)e(is)h(the)h
+(base)f(class)f(from)h(whic)n(h)g(all)g(other)g(classes)f(in)i(the)f
+(AST)h(library)e(are)g(deriv)n(ed.)227 2167 y(It)e(pro)n(vides)e(all)h
+(the)g(basic)g(Ob)5 b(ject)28 b(b)r(eha)n(viour)f(and)h(Ob)5
+b(ject)28 b(manipulation)g(facilities)g(required)f(throughout)227
+2267 y(the)h(library)-7 b(.)36 b(There)27 b(is)g(no)h(Ob)5
+b(ject)27 b(constructor,)f(ho)n(w)n(ev)n(er,)g(as)h(Ob)5
+b(jects)27 b(on)g(their)h(o)n(wn)f(are)f(not)i(useful.)0
+2418 y Fc(Constructor)k(F)-8 b(unction:)227 2518 y Fj(None.)-2
+2670 y Fc(Inheritance)n(:)227 2816 y Fj(The)28 b(Ob)5
+b(ject)27 b(base)g(class)g(do)r(es)g(not)h(inherit)g(from)f(an)n(y)g
+(other)g(class.)-2 2967 y Fc(A)m(ttributes)n(:)227 3113
+y Fj(All)h(Ob)5 b(jects)28 b(ha)n(v)n(e)e(the)i(follo)n(wing)e
+(attributes:)340 3378 y Fi(\017)45 b Fj(Class:)36 b(Ob)5
+b(ject)28 b(class)e(name)340 3512 y Fi(\017)45 b Fj(ID:)28
+b(Ob)5 b(ject)28 b(iden)n(ti\014cation)f(string)340 3645
+y Fi(\017)45 b Fj(Iden)n(t:)37 b(P)n(ermanen)n(t)26 b(Ob)5
+b(ject)28 b(iden)n(ti\014cation)f(string)340 3779 y Fi(\017)45
+b Fj(Nob)5 b(ject:)37 b(Num)n(b)r(er)28 b(of)g(Ob)5 b(jects)27
+b(in)h(class)340 3913 y Fi(\017)45 b Fj(Ob)5 b(jSize:)37
+b(The)28 b(in-memory)e(size)h(of)h(the)g(Ob)5 b(ject)27
+b(in)h(b)n(ytes)340 4047 y Fi(\017)45 b Fj(RefCoun)n(t:)37
b(Coun)n(t)28 b(of)f(activ)n(e)g(Ob)5 b(ject)28 b(p)r(oin)n(ters)340
-2155 y Fi(\017)45 b Fj(UseDefs:)38 b(Allo)n(w)27 b(use)g(of)h(default)g
+4181 y Fi(\017)45 b Fj(UseDefs:)38 b(Allo)n(w)27 b(use)g(of)h(default)g
(v)-5 b(alues)27 b(for)g(Ob)5 b(ject)28 b(attributes?)-2
-2325 y Fc(F)-8 b(unctions)n(:)227 2471 y Fj(The)28 b(follo)n(wing)e
+4345 y Fc(F)-8 b(unctions)n(:)227 4491 y Fj(The)28 b(follo)n(wing)e
(routines)h(ma)n(y)g(b)r(e)h(applied)g(to)f(all)h(Ob)5
-b(jects:)340 2745 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(ANNUL:)29
+b(jects:)340 4756 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(ANNUL:)29
b(Ann)n(ul)f(a)f(p)r(oin)n(ter)g(to)h(an)f(Ob)5 b(ject)340
-2882 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(BEGIN:)28 b(Begin)f(a)g(new)h
-(AST)g(con)n(text)340 3019 y Fi(\017)45 b Fj(AST)p Ft(_)p
+4889 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(BEGIN:)28 b(Begin)f(a)g(new)h
+(AST)g(con)n(text)340 5023 y Fi(\017)45 b Fj(AST)p Ft(_)p
Fj(CLEAR:)28 b(Clear)e(attribute)i(v)-5 b(alues)27 b(for)g(an)h(Ob)5
-b(ject)340 3156 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(CLONE:)27
+b(ject)340 5157 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(CLONE:)27
b(Clone)g(a)h(p)r(oin)n(ter)f(to)g(an)h(Ob)5 b(ject)340
-3293 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(COPY:)27 b(Cop)n(y)g(an)g(Ob)5
-b(ject)340 3430 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(DELETE:)27
-b(Delete)h(an)f(Ob)5 b(ject)340 3567 y Fi(\017)45 b Fj(AST)p
-Ft(_)p Fj(END:)28 b(End)g(an)f(AST)h(con)n(text)340 3704
+5291 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(COPY:)27 b(Cop)n(y)g(an)g(Ob)5
+b(ject)340 5425 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(DELETE:)27
+b(Delete)h(an)f(Ob)5 b(ject)340 5559 y Fi(\017)45 b Fj(AST)p
+Ft(_)p Fj(END:)28 b(End)g(an)f(AST)h(con)n(text)340 5693
y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(ESCAPES:)27 b(Con)n(trol)f(whether)i
-(graphical)e(escap)r(e)h(sequences)g(are)f(remo)n(v)n(ed)340
-3841 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(EXEMPT:)27 b(Exempt)g(an)h(Ob)5
+(graphical)e(escap)r(e)h(sequences)g(are)f(remo)n(v)n(ed)p
+eop end
+%%Page: 540 550
+TeXDict begin 540 549 bop 0 52 a FG(540)2251 b Fz(D)91
+b(AST)30 b(CLASS)f(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(AST)p Ft(_)p Fj(EXEMPT:)27 b(Exempt)g(an)h(Ob)5
b(ject)27 b(p)r(oin)n(ter)g(from)g(AST)h(con)n(text)g(handling)340
-3978 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(EXPOR)-7 b(T:)27
+484 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(EXPOR)-7 b(T:)27
b(Exp)r(ort)g(an)g(Ob)5 b(ject)27 b(p)r(oin)n(ter)h(to)f(an)g(outer)g
-(con)n(text)340 4115 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GET)p
+(con)n(text)340 616 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GET)p
Fl(<)p Fj(X)p Fl(>)p Fj(:)36 b(Get)28 b(an)g(attribute)f(v)-5
-b(alue)28 b(for)f(an)g(Ob)5 b(ject)340 4252 y Fi(\017)45
+b(alue)28 b(for)f(an)g(Ob)5 b(ject)340 748 y Fi(\017)45
b Fj(AST)p Ft(_)p Fj(HASA)-7 b(TTRIBUTE:)29 b(T)-7 b(est)27
b(if)h(an)g(Ob)5 b(ject)27 b(has)g(a)g(named)h(attribute)340
-4389 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(IMPOR)-7 b(T:)27
+881 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(IMPOR)-7 b(T:)27
b(Imp)r(ort)h(an)f(Ob)5 b(ject)28 b(p)r(oin)n(ter)f(to)g(the)h(curren)n
-(t)f(con)n(text)340 4526 y Fi(\017)45 b Fj(AST)p Ft(_)p
+(t)f(con)n(text)340 1013 y Fi(\017)45 b Fj(AST)p Ft(_)p
Fj(ISA)p Fl(<)p Fj(CLASS)p Fl(>)p Fj(:)37 b(T)-7 b(est)28
-b(class)e(mem)n(b)r(ership)340 4663 y Fi(\017)45 b Fj(AST)p
+b(class)e(mem)n(b)r(ership)340 1146 y Fi(\017)45 b Fj(AST)p
Ft(_)p Fj(SAME:)28 b(Do)g(t)n(w)n(o)e(AST)i(p)r(oin)n(ters)f(refer)g
-(to)h(the)g(same)f(Ob)5 b(ject?)340 4801 y Fi(\017)45
+(to)h(the)g(same)f(Ob)5 b(ject?)340 1278 y Fi(\017)45
b Fj(AST)p Ft(_)p Fj(SET:)28 b(Set)g(attribute)f(v)-5
-b(alues)28 b(for)f(an)g(Ob)5 b(ject)340 4938 y Fi(\017)45
+b(alues)28 b(for)f(an)g(Ob)5 b(ject)340 1410 y Fi(\017)45
b Fj(AST)p Ft(_)p Fj(SET)p Fl(<)p Fj(X)p Fl(>)p Fj(:)36
b(Set)28 b(an)f(attribute)h(v)-5 b(alue)28 b(for)f(an)g(Ob)5
-b(ject)340 5075 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(SHO)n(W:)28
+b(ject)340 1543 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(SHO)n(W:)28
b(Displa)n(y)f(a)g(textual)h(represen)n(tation)e(of)h(an)h(Ob)5
-b(ject)27 b(on)g(standard)g(output)340 5212 y Fi(\017)45
+b(ject)27 b(on)g(standard)g(output)340 1675 y Fi(\017)45
b Fj(AST)p Ft(_)p Fj(TEST:)27 b(T)-7 b(est)28 b(if)g(an)g(attribute)f
(v)-5 b(alue)28 b(is)f(set)h(for)f(an)g(Ob)5 b(ject)340
-5349 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(TUNE:)28 b(Set)g(or)f(get)g(an)g
-(in)n(teger)g(AST)h(tuning)g(parameter)340 5486 y Fi(\017)45
+1807 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(TUNE:)28 b(Set)g(or)f(get)g(an)g
+(in)n(teger)g(AST)h(tuning)g(parameter)340 1940 y Fi(\017)45
b Fj(AST)p Ft(_)p Fj(TUNEC:)28 b(Set)g(or)f(get)g(a)g(c)n(haracter)f
-(AST)i(tuning)g(parameter)340 5623 y Fi(\017)45 b Fj(AST)p
+(AST)i(tuning)g(parameter)340 2072 y Fi(\017)45 b Fj(AST)p
Ft(_)p Fj(VERSION:)28 b(Return)g(the)f(v)n(erson)f(of)i(the)g(AST)g
-(library)e(b)r(eing)i(used.)p eop end
-%%Page: 534 544
-TeXDict begin 534 543 bop 0 52 a FG(534)2251 b Fz(D)91
-b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 483
-a FA(PcdMap)891 490 y Fd(Apply)38 b(2-dimensional)e(pincushion/barrel)
-1642 611 y(distortion)3285 483 y FA(PcdMap)0 783 y Fc(Description:)44
-b Fj(A)31 b(PcdMap)g(is)f(a)h(non-linear)e(Mapping)h(whic)n(h)h
-(transforms)f(2-dimensional)f(p)r(ositions)h(to)h(correct)227
-883 y(for)25 b(the)g(radial)f(distortion)g(in)n(tro)r(duced)h(b)n(y)f
-(some)h(cameras)e(and)i(telescop)r(es.)35 b(This)25 b(can)g(tak)n(e)f
-(the)h(form)g(either)227 982 y(of)j(pincushion)f(or)g(barrel)f
-(distortion,)h(and)h(is)f(c)n(haracterized)f(b)n(y)h(a)g(single)g
-(distortion)g(co)r(e\016cien)n(t.)227 1110 y(A)g(PcdMap)f(is)g(sp)r
-(eci\014ed)h(b)n(y)f(giving)g(this)h(distortion)f(co)r(e\016cien)n(t)g
-(and)g(the)h(co)r(ordinates)e(of)i(the)g(cen)n(tre)f(of)g(the)227
-1210 y(radial)h(distortion.)36 b(The)28 b(forw)n(ard)d(transformation)h
-(of)i(a)f(PcdMap)g(applies)g(the)h(distortion:)227 1338
+(library)e(b)r(eing)i(used.)p 0 2271 3780 12 v 0 2402
+a FA(PcdMap)891 2409 y Fd(Apply)38 b(2-dimensional)e(pincushion/barrel)
+1642 2530 y(distortion)3285 2402 y FA(PcdMap)0 2695 y
+Fc(Description:)44 b Fj(A)31 b(PcdMap)g(is)f(a)h(non-linear)e(Mapping)h
+(whic)n(h)h(transforms)f(2-dimensional)f(p)r(ositions)h(to)h(correct)
+227 2794 y(for)25 b(the)g(radial)f(distortion)g(in)n(tro)r(duced)h(b)n
+(y)f(some)h(cameras)e(and)i(telescop)r(es.)35 b(This)25
+b(can)g(tak)n(e)f(the)h(form)g(either)227 2894 y(of)j(pincushion)f(or)g
+(barrel)f(distortion,)h(and)h(is)f(c)n(haracterized)f(b)n(y)h(a)g
+(single)g(distortion)g(co)r(e\016cien)n(t.)227 3018 y(A)g(PcdMap)f(is)g
+(sp)r(eci\014ed)h(b)n(y)f(giving)g(this)h(distortion)f(co)r(e\016cien)n
+(t)g(and)g(the)h(co)r(ordinates)e(of)i(the)g(cen)n(tre)f(of)g(the)227
+3118 y(radial)h(distortion.)36 b(The)28 b(forw)n(ard)d(transformation)h
+(of)i(a)f(PcdMap)g(applies)g(the)h(distortion:)227 3242
y(RD)g(=)g(R)g Fi(\003)f Fj(\()h(1)f(+)g(C)h Fi(\003)f
-Fj(R)h Fi(\003)f Fj(R)h(\))227 1466 y(where)h(R)h(is)g(the)g
+Fj(R)h Fi(\003)f Fj(R)h(\))227 3367 y(where)h(R)h(is)g(the)g
(undistorted)f(radial)g(distance)g(from)h(the)g(distortion)f(cen)n(tre)
-g(\(sp)r(eci\014ed)h(b)n(y)f(attribute)h(Pcd-)227 1565
+g(\(sp)r(eci\014ed)h(b)n(y)f(attribute)h(Pcd-)227 3466
y(Cen\),)k(RD)e(is)g(the)g(radial)e(distance)i(from)f(the)i(same)e(cen)
n(tre)g(in)h(the)g(presence)f(of)h(distortion,)g(and)g(C)g(is)f(the)227
-1665 y(distortion)c(co)r(e\016cien)n(t)h(\(giv)n(en)f(b)n(y)g
-(attribute)h(Disco\).)227 1793 y(The)33 b(in)n(v)n(erse)f
+3566 y(distortion)c(co)r(e\016cien)n(t)h(\(giv)n(en)f(b)n(y)g
+(attribute)h(Disco\).)227 3690 y(The)33 b(in)n(v)n(erse)f
(transformation)f(of)i(a)f(PcdMap)h(remo)n(v)n(es)d(the)k(distortion)e
(pro)r(duced)h(b)n(y)f(the)h(forw)n(ard)f(trans-)227
-1892 y(formation.)42 b(The)29 b(expression)f(used)i(to)f(deriv)n(e)g(R)
+3790 y(formation.)42 b(The)29 b(expression)f(used)i(to)f(deriv)n(e)g(R)
g(from)g(RD)i(is)e(an)g(appro)n(ximate)f(in)n(v)n(erse)g(of)h(the)h
-(expression)227 1992 y(ab)r(o)n(v)n(e.)0 2148 y Fc(Constructor)i(F)-8
-b(unction:)227 2248 y Fj(AST)p Ft(_)p Fj(PCDMAP)-2 2404
-y Fc(Inheritance)n(:)227 2550 y Fj(The)28 b(PcdMap)f(class)g(inherits)g
-(from)g(the)h(Mapping)f(class.)-2 2706 y Fc(A)m(ttributes)n(:)227
-2852 y Fj(In)38 b(addition)f(to)f(those)h(attributes)g(common)g(to)g
+(expression)227 3889 y(ab)r(o)n(v)n(e.)0 4038 y Fc(Constructor)i(F)-8
+b(unction:)227 4138 y Fj(AST)p Ft(_)p Fj(PCDMAP)-2 4287
+y Fc(Inheritance)n(:)227 4433 y Fj(The)28 b(PcdMap)f(class)g(inherits)g
+(from)g(the)h(Mapping)f(class.)-2 4582 y Fc(A)m(ttributes)n(:)227
+4728 y Fj(In)38 b(addition)f(to)f(those)h(attributes)g(common)g(to)g
(all)g(Mappings,)h(ev)n(ery)e(PcdMap)h(also)f(has)g(the)i(follo)n(wing)
-227 2952 y(attributes:)340 3223 y Fi(\017)45 b Fj(Disco:)37
+227 4828 y(attributes:)340 5088 y Fi(\017)45 b Fj(Disco:)37
b(PcdMap)27 b(pincushion/barrel)f(distortion)g(co)r(e\016cien)n(t)340
-3359 y Fi(\017)45 b Fj(PcdCen\(axis\):)36 b(Cen)n(tre)28
+5220 y Fi(\017)45 b Fj(PcdCen\(axis\):)36 b(Cen)n(tre)28
b(co)r(ordinates)e(of)h(pincushion/barrel)f(distortion)-2
-3528 y Fc(F)-8 b(unctions)n(:)227 3674 y Fj(The)39 b(PcdMap)g(class)f
+5382 y Fc(F)-8 b(unctions)n(:)227 5528 y Fj(The)39 b(PcdMap)g(class)f
(do)r(es)h(not)g(de\014ne)g(an)n(y)f(new)h(routines)g(b)r(ey)n(ond)g
-(those)f(whic)n(h)h(are)f(applicable)h(to)g(all)227 3773
-y(Mappings.)p 0 3979 V 0 4110 a FA(P)l(ermMap)1025 4111
-y Fd(Co)s(ordinate)d(p)s(erm)m(utation)g(Mapping)3195
-4110 y FA(P)l(ermMap)0 4306 y Fc(Description:)44 b Fj(A)37
-b(P)n(ermMap)e(is)h(a)g(Mapping)g(whic)n(h)g(p)r(erm)n(utes)h(the)f
-(order)f(of)h(co)r(ordinates,)i(and)e(p)r(ossibly)g(also)227
-4406 y(c)n(hanges)26 b(the)i(n)n(um)n(b)r(er)g(of)f(co)r(ordinates,)g
-(b)r(et)n(w)n(een)g(its)h(input)g(and)g(output.)227 4534
-y(In)37 b(addition)f(to)g(p)r(erm)n(uting)h(the)f(co)r(ordinate)g
-(order,)h(a)f(P)n(ermMap)f(ma)n(y)h(also)f(assign)g(constan)n(t)h(v)-5
-b(alues)36 b(to)227 4634 y(co)r(ordinates.)53 b(This)33
-b(is)g(useful)h(when)g(the)f(n)n(um)n(b)r(er)g(of)h(co)r(ordinates)d
-(is)j(b)r(eing)f(increased)f(as)h(it)h(allo)n(ws)e(\014xed)227
-4733 y(v)-5 b(alues)27 b(to)h(b)r(e)g(assigned)e(to)i(an)n(y)f(new)g
-(ones.)0 4889 y Fc(Constructor)32 b(F)-8 b(unction:)227
-4989 y Fj(AST)p Ft(_)p Fj(PERMMAP)-2 5145 y Fc(Inheritance)n(:)227
-5291 y Fj(The)28 b(P)n(ermMap)e(class)h(inherits)g(from)h(the)g
-(Mapping)f(class.)-2 5447 y Fc(A)m(ttributes)n(:)227
-5593 y Fj(The)32 b(P)n(ermMap)d(class)i(do)r(es)g(not)g(de\014ne)g(an)n
+(those)f(whic)n(h)h(are)f(applicable)h(to)g(all)227 5628
+y(Mappings.)p eop end
+%%Page: 541 551
+TeXDict begin 541 550 bop 3643 52 a FG(541)p 0 351 3780
+12 v 0 482 a FA(P)l(ermMap)1025 483 y Fd(Co)s(ordinate)36
+b(p)s(erm)m(utation)g(Mapping)3195 482 y FA(P)l(ermMap)0
+685 y Fc(Description:)44 b Fj(A)37 b(P)n(ermMap)e(is)h(a)g(Mapping)g
+(whic)n(h)g(p)r(erm)n(utes)h(the)f(order)f(of)h(co)r(ordinates,)i(and)e
+(p)r(ossibly)g(also)227 784 y(c)n(hanges)26 b(the)i(n)n(um)n(b)r(er)g
+(of)f(co)r(ordinates,)g(b)r(et)n(w)n(een)g(its)h(input)g(and)g(output.)
+227 915 y(In)37 b(addition)f(to)g(p)r(erm)n(uting)h(the)f(co)r
+(ordinate)g(order,)h(a)f(P)n(ermMap)f(ma)n(y)h(also)f(assign)g(constan)
+n(t)h(v)-5 b(alues)36 b(to)227 1015 y(co)r(ordinates.)53
+b(This)33 b(is)g(useful)h(when)g(the)f(n)n(um)n(b)r(er)g(of)h(co)r
+(ordinates)d(is)j(b)r(eing)f(increased)f(as)h(it)h(allo)n(ws)e(\014xed)
+227 1114 y(v)-5 b(alues)27 b(to)h(b)r(e)g(assigned)e(to)i(an)n(y)f(new)
+g(ones.)0 1277 y Fc(Constructor)32 b(F)-8 b(unction:)227
+1376 y Fj(AST)p Ft(_)p Fj(PERMMAP)-2 1538 y Fc(Inheritance)n(:)227
+1685 y Fj(The)28 b(P)n(ermMap)e(class)h(inherits)g(from)h(the)g
+(Mapping)f(class.)-2 1847 y Fc(A)m(ttributes)n(:)227
+1993 y Fj(The)32 b(P)n(ermMap)d(class)i(do)r(es)g(not)g(de\014ne)g(an)n
(y)g(new)g(attributes)g(b)r(ey)n(ond)g(those)g(whic)n(h)g(are)f
-(applicable)h(to)g(all)227 5693 y(Mappings.)p eop end
-%%Page: 535 545
-TeXDict begin 535 544 bop 3643 52 a FG(535)-2 351 y Fc(F)-8
-b(unctions)n(:)227 497 y Fj(The)36 b(P)n(ermMap)e(class)h(do)r(es)g
-(not)g(de\014ne)h(an)n(y)f(new)g(routines)g(b)r(ey)n(ond)g(those)h
-(whic)n(h)f(are)g(applicable)f(to)i(all)227 597 y(Mappings.)p
-0 792 3780 12 v 0 924 a FA(Plot)588 b Fd(Pro)m(vide)37
-b(facilities)f(for)i(2D)h(graphical)d(output)586 b FA(Plot)0
-1108 y Fc(Description:)44 b Fj(This)33 b(class)e(pro)n(vides)g
-(facilities)h(for)g(pro)r(ducing)f(2D)i(graphical)d(output.)52
-b(A)32 b(Plot)g(is)g(a)g(sp)r(ecialised)227 1208 y(form)40
-b(of)g(F)-7 b(rameSet,)43 b(in)e(whic)n(h)f(the)h(base)e(F)-7
-b(rame)40 b(describ)r(es)f(a)h Ft(")p Fj(graphical)p
-Ft(")e Fj(co)r(ordinate)h(system)h(and)g(is)227 1307
+(applicable)h(to)g(all)227 2093 y(Mappings.)-2 2255 y
+Fc(F)-8 b(unctions)n(:)227 2401 y Fj(The)36 b(P)n(ermMap)e(class)h(do)r
+(es)g(not)g(de\014ne)h(an)n(y)f(new)g(routines)g(b)r(ey)n(ond)g(those)h
+(whic)n(h)f(are)g(applicable)f(to)i(all)227 2500 y(Mappings.)p
+0 2713 V 0 2844 a FA(Plot)588 b Fd(Pro)m(vide)37 b(facilities)f(for)i
+(2D)h(graphical)d(output)586 b FA(Plot)0 3046 y Fc(Description:)44
+b Fj(This)33 b(class)e(pro)n(vides)g(facilities)h(for)g(pro)r(ducing)f
+(2D)i(graphical)d(output.)52 b(A)32 b(Plot)g(is)g(a)g(sp)r(ecialised)
+227 3145 y(form)40 b(of)g(F)-7 b(rameSet,)43 b(in)e(whic)n(h)f(the)h
+(base)e(F)-7 b(rame)40 b(describ)r(es)f(a)h Ft(")p Fj(graphical)p
+Ft(")e Fj(co)r(ordinate)h(system)h(and)g(is)227 3245
y(asso)r(ciated)28 b(with)i(a)e(rectangular)f(plotting)i(area)f(in)h
(the)h(underlying)e(graphics)g(system.)41 b(This)29 b(plotting)g(area)
-227 1407 y(is)f(where)f(graphical)f(output)i(app)r(ears.)36
+227 3345 y(is)f(where)f(graphical)f(output)i(app)r(ears.)36
b(It)28 b(is)f(de\014ned)h(when)g(the)g(Plot)f(is)g(created.)227
-1530 y(The)36 b(curren)n(t)e(F)-7 b(rame)35 b(of)h(a)f(Plot)g(describ)r
+3476 y(The)36 b(curren)n(t)e(F)-7 b(rame)35 b(of)h(a)f(Plot)g(describ)r
(es)g(a)g Ft(")p Fj(ph)n(ysical)p Ft(")f Fj(co)r(ordinate)g(system,)j
-(whic)n(h)f(is)f(the)h(co)r(ordinate)227 1630 y(system)41
+(whic)n(h)f(is)f(the)h(co)r(ordinate)227 3575 y(system)41
b(in)h(whic)n(h)f(plotting)h(op)r(erations)e(are)g(sp)r(eci\014ed.)79
b(The)41 b(results)g(of)g(eac)n(h)g(plotting)g(op)r(eration)g(are)227
-1730 y(automatically)26 b(transformed)f(in)n(to)i(graphical)e(co)r
+3675 y(automatically)26 b(transformed)f(in)n(to)i(graphical)e(co)r
(ordinates)g(so)h(as)g(to)h(app)r(ear)e(in)i(the)g(plotting)g(area)e
-(\(sub)5 b(ject)227 1829 y(to)28 b(an)n(y)f(clipping)g(whic)n(h)h(ma)n
-(y)f(b)r(e)h(in)f(e\013ect\).)227 1953 y(Because)d(the)h(Mapping)f(b)r
+(\(sub)5 b(ject)227 3775 y(to)28 b(an)n(y)f(clipping)g(whic)n(h)h(ma)n
+(y)f(b)r(e)h(in)f(e\013ect\).)227 3905 y(Because)d(the)h(Mapping)f(b)r
(et)n(w)n(een)g(ph)n(ysical)g(and)g(graphical)f(co)r(ordinates)g(ma)n
-(y)h(often)h(b)r(e)g(non-linear,)e(or)h(ev)n(en)227 2052
+(y)h(often)h(b)r(e)g(non-linear,)e(or)h(ev)n(en)227 4005
y(discon)n(tin)n(uous,)33 b(most)f(plotting)g(do)r(es)g(not)h(result)f
(in)g(simple)h(straigh)n(t)e(lines.)51 b(The)32 b(basic)g(plotting)g
-(elemen)n(t)227 2152 y(is)h(therefore)g(not)g(a)g(straigh)n(t)f(line,)j
+(elemen)n(t)227 4105 y(is)h(therefore)g(not)g(a)g(straigh)n(t)f(line,)j
(but)f(a)f(geo)r(desic)f(curv)n(e)g(\(see)h(AST)p Ft(_)p
Fj(CUR)-9 b(VE,)34 b(AST)p Ft(_)p Fj(GENCUR)-9 b(VE)33
-b(and)227 2252 y(AST)p Ft(_)p Fj(POL)-7 b(YCUR)e(VE\).)19
+b(and)227 4204 y(AST)p Ft(_)p Fj(POL)-7 b(YCUR)e(VE\).)19
b(A)g(Plot)f(also)g(pro)n(vides)g(facilities)h(for)f(dra)n(wing)g(mark)
n(ers)f(or)h(sym)n(b)r(ols)g(\(AST)p Ft(_)p Fj(MARK\),)227
-2351 y(text)31 b(\(AST)p Ft(_)p Fj(TEXT\))g(and)g(grid)f(lines)g(\(AST)
+4304 y(text)31 b(\(AST)p Ft(_)p Fj(TEXT\))g(and)g(grid)f(lines)g(\(AST)
p Ft(_)p Fj(GRIDLINE\).)i(It)f(is)f(also)g(p)r(ossible)g(to)h(dra)n(w)e
-(curvilinear)h(axes)227 2451 y(with)23 b(optional)e(co)r(ordinate)g
+(curvilinear)h(axes)227 4404 y(with)23 b(optional)e(co)r(ordinate)g
(grids)f(\(AST)p Ft(_)p Fj(GRID\).)k(A)e(range)e(of)i(Plot)g
(attributes)f(is)h(a)n(v)-5 b(ailable)21 b(to)h(allo)n(w)e(precise)227
-2551 y(con)n(trol)27 b(o)n(v)n(er)e(the)j(app)r(earance)e(of)i
+4503 y(con)n(trol)27 b(o)n(v)n(er)e(the)j(app)r(earance)e(of)i
(graphical)e(output)i(pro)r(duced)f(b)n(y)h(these)f(routines.)227
-2674 y(Y)-7 b(ou)20 b(ma)n(y)f(select)h(di\013eren)n(t)f(ph)n(ysical)g
+4634 y(Y)-7 b(ou)20 b(ma)n(y)f(select)h(di\013eren)n(t)f(ph)n(ysical)g
(co)r(ordinate)g(systems)g(in)h(whic)n(h)f(to)h(plot)g(\(including)g
-(the)g(nativ)n(e)f(graphical)227 2774 y(co)r(ordinate)33
+(the)g(nativ)n(e)f(graphical)227 4734 y(co)r(ordinate)33
b(system)h(itself)6 b(\))35 b(b)n(y)f(selecting)g(di\013eren)n(t)g(F)-7
b(rames)33 b(as)h(the)g(curren)n(t)f(F)-7 b(rame)34 b(of)g(a)g(Plot,)h
-(using)e(its)227 2873 y(Curren)n(t)21 b(attribute.)35
+(using)e(its)227 4833 y(Curren)n(t)21 b(attribute.)35
b(Y)-7 b(ou)22 b(ma)n(y)e(also)h(set)g(up)h(clipping)g(\(see)f(AST)p
Ft(_)p Fj(CLIP\))g(to)h(limit)g(the)g(exten)n(t)f(of)h(an)n(y)f
-(plotting)227 2973 y(y)n(ou)26 b(p)r(erform,)h(and)f(this)h(ma)n(y)f(b)
+(plotting)227 4933 y(y)n(ou)26 b(p)r(erform,)h(and)f(this)h(ma)n(y)f(b)
r(e)h(done)f(in)h(an)n(y)f(of)h(the)g(co)r(ordinate)e(systems)i(asso)r
-(ciated)e(with)i(the)g(Plot,)g(not)227 3073 y(necessarily)f(the)i(one)f
-(y)n(ou)g(are)g(plotting)g(in.)227 3196 y(Lik)n(e)k(an)n(y)f(F)-7
+(ciated)e(with)i(the)g(Plot,)g(not)227 5033 y(necessarily)f(the)i(one)f
+(y)n(ou)g(are)g(plotting)g(in.)227 5164 y(Lik)n(e)k(an)n(y)f(F)-7
b(rameSet,)32 b(a)f(Plot)g(ma)n(y)f(also)g(b)r(e)i(used)f(as)g(a)f(F)-7
b(rame.)47 b(In)32 b(this)f(case,)h(it)f(b)r(eha)n(v)n(es)f(lik)n(e)h
-(its)g(curren)n(t)227 3296 y(F)-7 b(rame,)27 b(whic)n(h)h(describ)r(es)
-f(the)h(ph)n(ysical)f(co)r(ordinate)f(system.)227 3419
+(its)g(curren)n(t)227 5263 y(F)-7 b(rame,)27 b(whic)n(h)h(describ)r(es)
+f(the)h(ph)n(ysical)f(co)r(ordinate)f(system.)227 5394
y(When)35 b(used)f(as)g(a)g(Mapping,)h(a)f(Plot)g(describ)r(es)f(the)i
(in)n(ter-relation)e(b)r(et)n(w)n(een)h(graphical)e(co)r(ordinates)h
-(\(its)227 3519 y(base)k(F)-7 b(rame\))38 b(and)f(ph)n(ysical)g(co)r
+(\(its)227 5494 y(base)k(F)-7 b(rame\))38 b(and)f(ph)n(ysical)g(co)r
(ordinates)g(\(its)h(curren)n(t)f(F)-7 b(rame\).)67 b(It)38
b(di\013ers)f(from)h(a)f(normal)g(F)-7 b(rameSet,)227
-3618 y(ho)n(w)n(ev)n(er,)29 b(in)h(that)h(an)e(attempt)i(to)f
+5593 y(ho)n(w)n(ev)n(er,)29 b(in)h(that)h(an)e(attempt)i(to)f
(transform)f(p)r(oin)n(ts)h(whic)n(h)g(lie)g(in)h(clipp)r(ed)f(areas)f
-(of)h(the)g(Plot)g(will)g(result)227 3718 y(in)e(bad)g(co)r(ordinate)e
-(v)-5 b(alues)27 b(\(AST)p Ft(__)p Fj(BAD\).)0 3865 y
-Fc(Constructor)32 b(F)-8 b(unction:)227 3965 y Fj(AST)p
-Ft(_)p Fj(PLOT)-2 4112 y Fc(Inheritance)n(:)227 4258
-y Fj(The)28 b(Plot)f(class)g(inherits)g(from)g(the)h(F)-7
-b(rameSet)28 b(class.)-2 4406 y Fc(A)m(ttributes)n(:)227
-4552 y Fj(In)37 b(addition)f(to)g(those)g(attributes)h(common)e(to)i
-(all)f(F)-7 b(rameSets,)38 b(ev)n(ery)d(Plot)h(also)f(has)h(the)h
-(follo)n(wing)e(at-)227 4651 y(tributes:)340 4909 y Fi(\017)45
+(of)h(the)g(Plot)g(will)g(result)227 5693 y(in)e(bad)g(co)r(ordinate)e
+(v)-5 b(alues)27 b(\(AST)p Ft(__)p Fj(BAD\).)p eop end
+%%Page: 542 552
+TeXDict begin 542 551 bop 0 52 a FG(542)2251 b Fz(D)91
+b(AST)30 b(CLASS)f(DESCRIPTIONS)0 351 y Fc(Constructor)j(F)-8
+b(unction:)227 451 y Fj(AST)p Ft(_)p Fj(PLOT)-2 598 y
+Fc(Inheritance)n(:)227 744 y Fj(The)28 b(Plot)f(class)g(inherits)g
+(from)g(the)h(F)-7 b(rameSet)28 b(class.)-2 891 y Fc(A)m(ttributes)n(:)
+227 1037 y Fj(In)37 b(addition)f(to)g(those)g(attributes)h(common)e(to)
+i(all)f(F)-7 b(rameSets,)38 b(ev)n(ery)d(Plot)h(also)f(has)h(the)h
+(follo)n(wing)e(at-)227 1136 y(tributes:)340 1394 y Fi(\017)45
b Fj(Abbrev:)37 b(Abbreviate)27 b(leading)g(\014elds?)340
-5040 y Fi(\017)45 b Fj(Border:)36 b(Dra)n(w)26 b(a)i(b)r(order)e
+1524 y Fi(\017)45 b Fj(Border:)36 b(Dra)n(w)26 b(a)i(b)r(order)e
(around)h(v)-5 b(alid)27 b(regions)g(of)g(a)g(Plot?)340
-5170 y Fi(\017)45 b Fj(Clip:)37 b(Clip)28 b(lines)g(and/or)e(mark)n
-(ers)f(at)j(the)g(Plot)f(b)r(oundary?)340 5301 y Fi(\017)45
+1654 y Fi(\017)45 b Fj(Clip:)37 b(Clip)28 b(lines)g(and/or)e(mark)n
+(ers)f(at)j(the)g(Plot)f(b)r(oundary?)340 1784 y Fi(\017)45
b Fj(ClipOp:)37 b(Com)n(bine)27 b(Plot)g(clipping)h(limits)g(using)f(a)
-h(b)r(o)r(olean)f(OR?)340 5432 y Fi(\017)45 b Fj(Colour\(elemen)n(t\):)
+h(b)r(o)r(olean)f(OR?)340 1915 y Fi(\017)45 b Fj(Colour\(elemen)n(t\):)
37 b(Colour)26 b(index)i(for)f(a)g(Plot)g(elemen)n(t)340
-5562 y Fi(\017)45 b Fj(Dra)n(wAxes\(axis\):)36 b(Dra)n(w)27
-b(axes)f(for)h(a)g(Plot?)340 5693 y Fi(\017)45 b Fj(Dra)n(wTitle:)37
-b(Dra)n(w)26 b(a)i(title)g(for)f(a)g(Plot?)p eop end
-%%Page: 536 546
-TeXDict begin 536 545 bop 0 52 a FG(536)2251 b Fz(D)91
-b(AST)30 b(CLASS)f(DESCRIPTIONS)340 351 y Fi(\017)45
-b Fj(Escap)r(e:)36 b(Allo)n(w)27 b(c)n(hanges)g(of)g(c)n(haracter)f
-(attributes)h(within)i(strings?)340 481 y Fi(\017)45
-b Fj(Edge\(axis\):)36 b(Whic)n(h)28 b(edges)f(to)g(lab)r(el)h(in)g(a)f
-(Plot)340 611 y Fi(\017)45 b Fj(F)-7 b(on)n(t\(elemen)n(t\):)38
-b(Character)26 b(fon)n(t)h(for)g(a)h(Plot)f(elemen)n(t)340
-741 y Fi(\017)45 b Fj(Gap\(axis\):)37 b(In)n(terv)-5
+2045 y Fi(\017)45 b Fj(Dra)n(wAxes\(axis\):)36 b(Dra)n(w)27
+b(axes)f(for)h(a)g(Plot?)340 2175 y Fi(\017)45 b Fj(Dra)n(wTitle:)37
+b(Dra)n(w)26 b(a)i(title)g(for)f(a)g(Plot?)340 2306 y
+Fi(\017)45 b Fj(Escap)r(e:)36 b(Allo)n(w)27 b(c)n(hanges)g(of)g(c)n
+(haracter)f(attributes)h(within)i(strings?)340 2436 y
+Fi(\017)45 b Fj(Edge\(axis\):)36 b(Whic)n(h)28 b(edges)f(to)g(lab)r(el)
+h(in)g(a)f(Plot)340 2566 y Fi(\017)45 b Fj(F)-7 b(on)n(t\(elemen)n
+(t\):)38 b(Character)26 b(fon)n(t)h(for)g(a)h(Plot)f(elemen)n(t)340
+2696 y Fi(\017)45 b Fj(Gap\(axis\):)37 b(In)n(terv)-5
b(al)27 b(b)r(et)n(w)n(een)g(linearly)g(spaced)g(ma)5
-b(jor)26 b(axis)h(v)-5 b(alues)340 871 y Fi(\017)45 b
-Fj(Grf:)37 b(Select)28 b(the)g(graphics)e(in)n(terface)h(to)h(use.)340
-1001 y Fi(\017)45 b Fj(Grid:)37 b(Dra)n(w)27 b(grid)g(lines)g(for)g(a)h
-(Plot?)340 1131 y Fi(\017)45 b Fj(In)n(visible:)37 b(Dra)n(w)27
-b(graphics)f(in)i(in)n(visible)f(ink?)340 1261 y Fi(\017)45
-b Fj(Lab)r(elA)n(t\(axis\):)37 b(Where)27 b(to)h(place)f(n)n(umerical)g
-(lab)r(els)g(for)g(a)g(Plot)340 1391 y Fi(\017)45 b Fj(Lab)r
-(elUnits\(axis\):)37 b(Use)28 b(axis)f(unit)h(descriptions)f(in)h(a)f
-(Plot?)340 1521 y Fi(\017)45 b Fj(Lab)r(elUp\(axis\):)37
-b(Dra)n(w)27 b(n)n(umerical)g(Plot)g(lab)r(els)g(uprigh)n(t?)340
-1651 y Fi(\017)45 b Fj(Lab)r(elling:)37 b(Lab)r(el)27
-b(and)h(tic)n(k)f(placemen)n(t)g(option)h(for)f(a)g(Plot)340
-1781 y Fi(\017)45 b Fj(LogGap\(axis\):)36 b(In)n(terv)-5
-b(al)27 b(b)r(et)n(w)n(een)g(logarithmically)f(spaced)h(ma)5
-b(jor)26 b(axis)h(v)-5 b(alues)340 1911 y Fi(\017)45
-b Fj(LogPlot\(axis\):)35 b(Map)28 b(the)g(plot)f(on)n(to)g(the)h
-(screen)f(logarithmically?)340 2041 y Fi(\017)45 b Fj(LogTic)n
-(ks\(axis\):)35 b(Space)27 b(the)h(ma)5 b(jor)27 b(tic)n(k)g(marks)g
-(logarithmically?)340 2171 y Fi(\017)45 b Fj(Ma)5 b(jTic)n
-(kLen\(axis\):)36 b(Length)27 b(of)h(ma)5 b(jor)26 b(tic)n(k)i(marks)e
-(for)h(a)g(Plot)340 2301 y Fi(\017)45 b Fj(MinTic)n(kLen\(axis\):)37
-b(Length)27 b(of)h(minor)f(tic)n(k)g(marks)g(for)g(a)g(Plot)340
-2431 y Fi(\017)45 b Fj(MinTic)n(k\(axis\):)37 b(Densit)n(y)27
-b(of)h(minor)f(tic)n(k)g(marks)g(for)g(a)g(Plot)340 2561
+b(jor)26 b(axis)h(v)-5 b(alues)340 2827 y Fi(\017)45
+b Fj(Grf:)37 b(Select)28 b(the)g(graphics)e(in)n(terface)h(to)h(use.)
+340 2957 y Fi(\017)45 b Fj(Grid:)37 b(Dra)n(w)27 b(grid)g(lines)g(for)g
+(a)h(Plot?)340 3087 y Fi(\017)45 b Fj(In)n(visible:)37
+b(Dra)n(w)27 b(graphics)f(in)i(in)n(visible)f(ink?)340
+3218 y Fi(\017)45 b Fj(Lab)r(elA)n(t\(axis\):)37 b(Where)27
+b(to)h(place)f(n)n(umerical)g(lab)r(els)g(for)g(a)g(Plot)340
+3348 y Fi(\017)45 b Fj(Lab)r(elUnits\(axis\):)37 b(Use)28
+b(axis)f(unit)h(descriptions)f(in)h(a)f(Plot?)340 3478
+y Fi(\017)45 b Fj(Lab)r(elUp\(axis\):)37 b(Dra)n(w)27
+b(n)n(umerical)g(Plot)g(lab)r(els)g(uprigh)n(t?)340 3608
+y Fi(\017)45 b Fj(Lab)r(elling:)37 b(Lab)r(el)27 b(and)h(tic)n(k)f
+(placemen)n(t)g(option)h(for)f(a)g(Plot)340 3739 y Fi(\017)45
+b Fj(LogGap\(axis\):)36 b(In)n(terv)-5 b(al)27 b(b)r(et)n(w)n(een)g
+(logarithmically)f(spaced)h(ma)5 b(jor)26 b(axis)h(v)-5
+b(alues)340 3869 y Fi(\017)45 b Fj(LogPlot\(axis\):)35
+b(Map)28 b(the)g(plot)f(on)n(to)g(the)h(screen)f(logarithmically?)340
+3999 y Fi(\017)45 b Fj(LogTic)n(ks\(axis\):)35 b(Space)27
+b(the)h(ma)5 b(jor)27 b(tic)n(k)g(marks)g(logarithmically?)340
+4130 y Fi(\017)45 b Fj(Ma)5 b(jTic)n(kLen\(axis\):)36
+b(Length)27 b(of)h(ma)5 b(jor)26 b(tic)n(k)i(marks)e(for)h(a)g(Plot)340
+4260 y Fi(\017)45 b Fj(MinTic)n(kLen\(axis\):)37 b(Length)27
+b(of)h(minor)f(tic)n(k)g(marks)g(for)g(a)g(Plot)340 4390
+y Fi(\017)45 b Fj(MinTic)n(k\(axis\):)37 b(Densit)n(y)27
+b(of)h(minor)f(tic)n(k)g(marks)g(for)g(a)g(Plot)340 4520
y Fi(\017)45 b Fj(NumLab\(axis\):)37 b(Dra)n(w)27 b(n)n(umerical)g
-(axis)f(lab)r(els)i(for)f(a)g(Plot?)340 2691 y Fi(\017)45
+(axis)f(lab)r(els)i(for)f(a)g(Plot?)340 4651 y Fi(\017)45
b Fj(NumLabGap\(axis\):)37 b(Spacing)27 b(of)g(n)n(umerical)g(axis)g
-(lab)r(els)g(for)g(a)h(Plot)340 2821 y Fi(\017)45 b Fj(Size\(elemen)n
+(lab)r(els)g(for)g(a)h(Plot)340 4781 y Fi(\017)45 b Fj(Size\(elemen)n
(t\):)38 b(Character)26 b(size)h(for)g(a)g(Plot)g(elemen)n(t)340
-2951 y Fi(\017)45 b Fj(St)n(yle\(elemen)n(t\):)38 b(Line)27
-b(st)n(yle)h(for)f(a)g(Plot)g(elemen)n(t)340 3081 y Fi(\017)45
+4911 y Fi(\017)45 b Fj(St)n(yle\(elemen)n(t\):)38 b(Line)27
+b(st)n(yle)h(for)f(a)g(Plot)g(elemen)n(t)340 5042 y Fi(\017)45
b Fj(T)-7 b(extLab\(axis\):)37 b(Dra)n(w)26 b(descriptiv)n(e)h(axis)g
-(lab)r(els)g(for)g(a)h(Plot?)340 3211 y Fi(\017)45 b
+(lab)r(els)g(for)g(a)h(Plot?)340 5172 y Fi(\017)45 b
Fj(T)-7 b(extLabGap\(axis\):)36 b(Spacing)27 b(of)h(descriptiv)n(e)f
-(axis)f(lab)r(els)i(for)f(a)g(Plot)340 3341 y Fi(\017)45
+(axis)f(lab)r(els)i(for)f(a)g(Plot)340 5302 y Fi(\017)45
b Fj(Tic)n(kAll:)37 b(Dra)n(w)27 b(tic)n(k)g(marks)g(on)g(all)g(edges)g
-(of)h(a)f(Plot?)340 3471 y Fi(\017)45 b Fj(TitleGap:)37
+(of)h(a)f(Plot?)340 5432 y Fi(\017)45 b Fj(TitleGap:)37
b(V)-7 b(ertical)28 b(spacing)e(for)h(a)g(Plot)g(title)340
-3601 y Fi(\017)45 b Fj(T)-7 b(ol:)37 b(Plotting)27 b(tolerance)340
-3731 y Fi(\017)45 b Fj(Width\(elemen)n(t\):)39 b(Line)27
-b(width)i(for)e(a)g(Plot)g(elemen)n(t)-2 3891 y Fc(F)-8
-b(unctions)n(:)227 4037 y Fj(In)22 b(addition)g(to)f(those)h(routines)f
+5563 y Fi(\017)45 b Fj(T)-7 b(ol:)37 b(Plotting)27 b(tolerance)340
+5693 y Fi(\017)45 b Fj(Width\(elemen)n(t\):)39 b(Line)27
+b(width)i(for)e(a)g(Plot)g(elemen)n(t)p eop end
+%%Page: 543 553
+TeXDict begin 543 552 bop 3643 52 a FG(543)-2 351 y Fc(F)-8
+b(unctions)n(:)227 497 y Fj(In)22 b(addition)g(to)f(those)h(routines)f
(applicable)g(to)h(all)f(F)-7 b(rameSets,)23 b(the)f(follo)n(wing)f
-(routines)g(ma)n(y)g(also)f(b)r(e)j(applied)227 4136
-y(to)28 b(all)f(Plots:)340 4393 y Fi(\017)45 b Fj(AST)p
-Ft(_)p Fj(BBUF:)28 b(Begin)f(a)g(new)h(graphical)e(bu\013ering)h(con)n
-(text)340 4523 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(BORDER:)27
+(routines)g(ma)n(y)g(also)f(b)r(e)j(applied)227 597 y(to)28
+b(all)f(Plots:)340 856 y Fi(\017)45 b Fj(AST)p Ft(_)p
+Fj(BBUF:)28 b(Begin)f(a)g(new)h(graphical)e(bu\013ering)h(con)n(text)
+340 987 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(BORDER:)27
b(Dra)n(w)g(a)g(b)r(order)g(around)g(v)-5 b(alid)27 b(regions)f(of)i(a)
-f(Plot)340 4653 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(BOUNDINGBO)n(X:)28
+f(Plot)340 1118 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(BOUNDINGBO)n(X:)28
b(Returns)f(a)h(b)r(ounding)f(b)r(o)n(x)g(for)h(previously)e(dra)n(wn)h
-(graphics)340 4783 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(CLIP:)27
+(graphics)340 1249 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(CLIP:)27
b(Set)h(up)g(or)f(remo)n(v)n(e)f(clipping)h(for)g(a)h(Plot)340
-4913 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(CUR)-9 b(VE:)28
-b(Dra)n(w)f(a)g(geo)r(desic)f(curv)n(e)340 5043 y Fi(\017)45
+1381 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(CUR)-9 b(VE:)28
+b(Dra)n(w)f(a)g(geo)r(desic)f(curv)n(e)340 1512 y Fi(\017)45
b Fj(AST)p Ft(_)p Fj(EBUF:)28 b(End)f(the)h(curren)n(t)f(graphical)f
-(bu\013ering)h(con)n(text)340 5173 y Fi(\017)45 b Fj(AST)p
+(bu\013ering)h(con)n(text)340 1643 y Fi(\017)45 b Fj(AST)p
Ft(_)p Fj(GENCUR)-9 b(VE:)28 b(Dra)n(w)f(a)g(generalized)f(curv)n(e)340
-5303 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GETGRF)n(CONTEXT:)27
+1774 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GETGRF)n(CONTEXT:)27
b(Get)h(the)g(graphics)e(con)n(text)i(for)f(a)g(Plot)340
-5433 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GRFPOP:)27 b(Retriev)n(e)g
+1905 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GRFPOP:)27 b(Retriev)n(e)g
(previously)f(sa)n(v)n(ed)g(graphics)h(functions)340
-5563 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GRFPUSH:)29 b(Sa)n(v)n(e)d(the)i
-(curren)n(t)f(graphics)f(functions)340 5693 y Fi(\017)45
+2037 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GRFPUSH:)29 b(Sa)n(v)n(e)d(the)i
+(curren)n(t)f(graphics)f(functions)340 2168 y Fi(\017)45
b Fj(AST)p Ft(_)p Fj(GRFSET:)28 b(Register)f(a)g(graphics)f(routine)h
-(for)g(use)h(b)n(y)f(the)h(Plot)f(class)p eop end
-%%Page: 537 547
-TeXDict begin 537 546 bop 3643 52 a FG(537)340 351 y
-Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GRID:)29 b(Dra)n(w)d(a)i(set)f(of)h
-(lab)r(elled)f(co)r(ordinate)g(axes)340 481 y Fi(\017)45
-b Fj(AST)p Ft(_)p Fj(GRIDLINE:)28 b(Dra)n(w)f(a)g(grid)g(line)h(\(or)f
-(axis\))g(for)g(a)g(Plot)340 610 y Fi(\017)45 b Fj(AST)p
-Ft(_)p Fj(MARK:)28 b(Dra)n(w)f(a)g(set)h(of)f(mark)n(ers)f(for)h(a)g
-(Plot)340 740 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(POL)-7
-b(YCUR)e(VE:)27 b(Dra)n(w)g(a)g(series)g(of)g(connected)h(geo)r(desic)e
-(curv)n(es)340 869 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(TEXT:)28
-b(Dra)n(w)e(a)i(text)g(string)e(for)i(a)f(Plot)-2 1028
-y Fc(Graphical)33 b(Elemen)m(ts)n(:)227 1174 y Fj(The)21
-b(colour)e(index,)j(c)n(haracter)d(fon)n(t,)j(c)n(haracter)c(size,)k
-(line)f(st)n(yle)f(and)g(line)h(width)g(used)g(for)f(plotting)g(can)h
-(b)r(e)g(set)227 1274 y(indep)r(enden)n(tly)g(for)f(v)-5
-b(arious)19 b(elemen)n(ts)h(of)g(the)g(graphical)f(output)h(pro)r
+(for)g(use)h(b)n(y)f(the)h(Plot)f(class)340 2299 y Fi(\017)45
+b Fj(AST)p Ft(_)p Fj(GRID:)29 b(Dra)n(w)d(a)i(set)f(of)h(lab)r(elled)f
+(co)r(ordinate)g(axes)340 2430 y Fi(\017)45 b Fj(AST)p
+Ft(_)p Fj(GRIDLINE:)28 b(Dra)n(w)f(a)g(grid)g(line)h(\(or)f(axis\))g
+(for)g(a)g(Plot)340 2562 y Fi(\017)45 b Fj(AST)p Ft(_)p
+Fj(MARK:)28 b(Dra)n(w)f(a)g(set)h(of)f(mark)n(ers)f(for)h(a)g(Plot)340
+2693 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(POL)-7 b(YCUR)e(VE:)27
+b(Dra)n(w)g(a)g(series)g(of)g(connected)h(geo)r(desic)e(curv)n(es)340
+2824 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(TEXT:)28 b(Dra)n(w)e(a)i(text)g
+(string)e(for)i(a)f(Plot)-2 2984 y Fc(Graphical)33 b(Elemen)m(ts)n(:)
+227 3131 y Fj(The)21 b(colour)e(index,)j(c)n(haracter)d(fon)n(t,)j(c)n
+(haracter)c(size,)k(line)f(st)n(yle)f(and)g(line)h(width)g(used)g(for)f
+(plotting)g(can)h(b)r(e)g(set)227 3230 y(indep)r(enden)n(tly)g(for)f(v)
+-5 b(arious)19 b(elemen)n(ts)h(of)g(the)g(graphical)f(output)h(pro)r
(duced)g(b)n(y)g(a)g(Plot.)34 b(The)20 b(di\013eren)n(t)g(graph-)227
-1373 y(ical)h(elemen)n(ts)g(are)f(iden)n(ti\014ed)h(b)n(y)g(app)r
+3330 y(ical)h(elemen)n(ts)g(are)f(iden)n(ti\014ed)h(b)n(y)g(app)r
(ending)f(the)i(strings)e(listed)h(b)r(elo)n(w)g(as)f(subscripts)g(to)h
-(the)g(Plot)g(attributes)227 1473 y(Colour\(elemen)n(t\),)k(F)-7
+(the)g(Plot)g(attributes)227 3429 y(Colour\(elemen)n(t\),)k(F)-7
b(on)n(t\(elemen)n(t\),)27 b(Size\(elemen)n(t\),)f(St)n(yle\(elemen)n
(t\))g(and)f(Width\(elemen)n(t\).)38 b(These)25 b(strings)227
-1573 y(are)k(case-insensitiv)n(e)g(and)h(unam)n(biguous)f
+3529 y(are)k(case-insensitiv)n(e)g(and)h(unam)n(biguous)f
(abbreviations)f(ma)n(y)i(b)r(e)g(used.)44 b(Elemen)n(ts)30
-b(of)g(the)g(graphical)f(out-)227 1672 y(put)34 b(whic)n(h)g(relate)f
+b(of)g(the)g(graphical)f(out-)227 3629 y(put)34 b(whic)n(h)g(relate)f
(to)g(individual)h(axes)f(can)g(b)r(e)h(referred)e(to)i(either)f(indep)
r(enden)n(tly)h(\(e.g.)55 b Ft(")p Fj(\(Grid1\))p Ft(")33
-b Fj(and)227 1772 y Ft(")p Fj(\(Grid2\))p Ft(")27 b Fj(\))h(or)f
+b Fj(and)227 3728 y Ft(")p Fj(\(Grid2\))p Ft(")27 b Fj(\))h(or)f
(together)f(\(e.g.)37 b Ft(")p Fj(\(Grid\))p Ft(")p Fj(\):)340
-2028 y Fi(\017)45 b Fj(Axes:)37 b(Axis)28 b(lines)f(dra)n(wn)g(through)
+3987 y Fi(\017)45 b Fj(Axes:)37 b(Axis)28 b(lines)f(dra)n(wn)g(through)
g(tic)n(k)g(marks)f(using)i(AST)p Ft(_)p Fj(GRID)340
-2157 y Fi(\017)45 b Fj(Axis1:)37 b(Axis)27 b(line)h(dra)n(wn)f(through)
+4118 y Fi(\017)45 b Fj(Axis1:)37 b(Axis)27 b(line)h(dra)n(wn)f(through)
f(tic)n(k)i(marks)e(on)i(axis)f(1)g(using)g(AST)p Ft(_)p
-Fj(GRID)340 2287 y Fi(\017)45 b Fj(Axis2:)37 b(Axis)27
+Fj(GRID)340 4249 y Fi(\017)45 b Fj(Axis2:)37 b(Axis)27
b(line)h(dra)n(wn)f(through)f(tic)n(k)i(marks)e(on)i(axis)f(2)g(using)g
-(AST)p Ft(_)p Fj(GRID)340 2416 y Fi(\017)45 b Fj(Border:)36
+(AST)p Ft(_)p Fj(GRID)340 4381 y Fi(\017)45 b Fj(Border:)36
b(The)27 b(Plot)g(b)r(order)g(dra)n(wn)g(using)g(AST)p
-Ft(_)p Fj(BORDER)g(or)g(AST)p Ft(_)p Fj(GRID)340 2546
+Ft(_)p Fj(BORDER)g(or)g(AST)p Ft(_)p Fj(GRID)340 4512
y Fi(\017)45 b Fj(Curv)n(es:)31 b(Geo)r(desic)18 b(curv)n(es)g(dra)n
(wn)f(using)h(AST)p Ft(_)p Fj(CUR)-9 b(VE,)18 b(AST)p
Ft(_)p Fj(GENCUR)-9 b(VE)18 b(or)g(AST)p Ft(_)p Fj(POL)-7
-b(YCUR)e(VE)340 2676 y Fi(\017)45 b Fj(Grid:)37 b(Grid)28
+b(YCUR)e(VE)340 4643 y Fi(\017)45 b Fj(Grid:)37 b(Grid)28
b(lines)f(dra)n(wn)g(using)g(AST)p Ft(_)p Fj(GRIDLINE)h(or)f(AST)p
-Ft(_)p Fj(GRID)340 2805 y Fi(\017)45 b Fj(Grid1:)37 b(Grid)27
+Ft(_)p Fj(GRID)340 4774 y Fi(\017)45 b Fj(Grid1:)37 b(Grid)27
b(lines)h(whic)n(h)f(cross)f(axis)h(1,)g(dra)n(wn)g(using)g(AST)p
-Ft(_)p Fj(GRIDLINE)h(or)f(AST)p Ft(_)p Fj(GRID)340 2935
+Ft(_)p Fj(GRIDLINE)h(or)f(AST)p Ft(_)p Fj(GRID)340 4906
y Fi(\017)45 b Fj(Grid2:)37 b(Grid)27 b(lines)h(whic)n(h)f(cross)f
(axis)h(2,)g(dra)n(wn)g(using)g(AST)p Ft(_)p Fj(GRIDLINE)h(or)f(AST)p
-Ft(_)p Fj(GRID)340 3064 y Fi(\017)45 b Fj(Mark)n(ers:)35
+Ft(_)p Fj(GRID)340 5037 y Fi(\017)45 b Fj(Mark)n(ers:)35
b(Graphical)27 b(mark)n(ers)e(\(sym)n(b)r(ols\))j(dra)n(wn)e(using)i
-(AST)p Ft(_)p Fj(MARK)340 3194 y Fi(\017)45 b Fj(NumLab:)37
+(AST)p Ft(_)p Fj(MARK)340 5168 y Fi(\017)45 b Fj(NumLab:)37
b(Numerical)28 b(axis)e(lab)r(els)i(dra)n(wn)e(using)i(AST)p
-Ft(_)p Fj(GRID)340 3323 y Fi(\017)45 b Fj(NumLab1:)37
+Ft(_)p Fj(GRID)340 5299 y Fi(\017)45 b Fj(NumLab1:)37
b(Numerical)27 b(lab)r(els)g(for)g(axis)g(1)g(dra)n(wn)g(using)g(AST)p
-Ft(_)p Fj(GRID)340 3453 y Fi(\017)45 b Fj(NumLab2:)37
+Ft(_)p Fj(GRID)340 5431 y Fi(\017)45 b Fj(NumLab2:)37
b(Numerical)27 b(lab)r(els)g(for)g(axis)g(2)g(dra)n(wn)g(using)g(AST)p
-Ft(_)p Fj(GRID)340 3582 y Fi(\017)45 b Fj(Strings:)37
+Ft(_)p Fj(GRID)340 5562 y Fi(\017)45 b Fj(Strings:)37
b(T)-7 b(ext)27 b(strings)g(dra)n(wn)g(using)g(AST)p
-Ft(_)p Fj(TEXT)340 3712 y Fi(\017)45 b Fj(T)-7 b(extLab:)37
+Ft(_)p Fj(TEXT)340 5693 y Fi(\017)45 b Fj(T)-7 b(extLab:)37
b(Descriptiv)n(e)27 b(axis)g(lab)r(els)g(dra)n(wn)g(using)g(AST)p
-Ft(_)p Fj(GRID)340 3841 y Fi(\017)45 b Fj(T)-7 b(extLab1:)36
-b(Descriptiv)n(e)27 b(lab)r(el)h(for)f(axis)g(1)g(dra)n(wn)g(using)g
-(AST)p Ft(_)p Fj(GRID)340 3971 y Fi(\017)45 b Fj(T)-7
-b(extLab2:)36 b(Descriptiv)n(e)27 b(lab)r(el)h(for)f(axis)g(2)g(dra)n
-(wn)g(using)g(AST)p Ft(_)p Fj(GRID)340 4100 y Fi(\017)45
-b Fj(Tic)n(ks:)36 b(Tic)n(k)28 b(marks)e(\(b)r(oth)i(ma)5
-b(jor)27 b(and)g(minor\))g(dra)n(wn)g(using)g(AST)p Ft(_)p
-Fj(GRID)340 4230 y Fi(\017)45 b Fj(Tic)n(ks1:)36 b(Tic)n(k)27
-b(marks)f(\(b)r(oth)j(ma)5 b(jor)26 b(and)i(minor\))f(for)g(axis)g(1)g
-(dra)n(wn)g(using)g(AST)p Ft(_)p Fj(GRID)340 4360 y Fi(\017)45
-b Fj(Tic)n(ks2:)36 b(Tic)n(k)27 b(marks)f(\(b)r(oth)j(ma)5
-b(jor)26 b(and)i(minor\))f(for)g(axis)g(2)g(dra)n(wn)g(using)g(AST)p
-Ft(_)p Fj(GRID)340 4489 y Fi(\017)45 b Fj(Title:)38 b(The)27
-b(Plot)g(title)h(dra)n(wn)f(using)g(AST)p Ft(_)p Fj(GRID)p
-0 4682 3780 12 v 0 4813 a FA(Plot3D)418 b Fd(Pro)m(vide)37
-b(facilities)f(for)i(3D)h(graphical)d(output)415 b FA(Plot3D)0
-4996 y Fc(Description:)44 b Fj(A)28 b(Plot3D)g(is)f(a)h(sp)r(ecialised)
-f(form)g(of)h(Plot)f(that)h(pro)n(vides)e(facilities)i(for)f(pro)r
-(ducing)g(3D)h(graphical)227 5095 y(output,)35 b(including)d(fully)i
-(annotated)e(3D)g(co)r(ordinate)g(grids.)50 b(The)33
-b(base)f(F)-7 b(rame)32 b(in)h(a)f(Plot3D)g(describ)r(es)g(a)227
-5195 y(3-dimensional)c Ft(")p Fj(graphical)p Ft(")f Fj(co)r(ordinate)h
-(system.)42 b(The)29 b(axes)g(of)g(this)h(co)r(ordinate)e(system)h(are)
-f(assumed)h(to)227 5295 y(b)r(e)d(righ)n(t-handed)f(\(that)h(is,)f(if)h
-(X)g(app)r(ears)f(horizon)n(tally)e(to)j(the)g(righ)n(t)e(and)i(Y)g(v)n
-(ertically)e(up)n(w)n(ards,)g(then)i(Z)g(is)227 5394
-y(out)d(of)h(the)f(screen)g(to)n(w)n(ards)e(the)i(view)n(er\),)h(and)f
-(are)f(assumed)h(to)g(b)r(e)g(equally)g(scaled)f(\(that)i(is,)g(the)g
-(same)e(units)227 5494 y(are)32 b(used)g(to)g(measure)g(p)r(ositions)g
-(on)g(eac)n(h)f(of)i(the)g(3)f(axes\).)50 b(The)33 b(upp)r(er)f(and)h
-(lo)n(w)n(er)d(b)r(ounds)j(of)f(a)g(v)n(olume)227 5593
-y(within)25 b(this)g(graphical)d(co)r(ordinate)h(system)h(is)g(sp)r
-(eci\014ed)h(when)f(the)g(Plot3D)g(is)g(created,)g(and)g(all)g
-(subsequen)n(t)227 5693 y(graphics)i(are)h Ft(")p Fj(dra)n(wn)p
-Ft(")f Fj(in)i(this)g(v)n(olume.)p eop end
-%%Page: 538 548
-TeXDict begin 538 547 bop 0 52 a FG(538)2251 b Fz(D)91
-b(AST)30 b(CLASS)f(DESCRIPTIONS)227 351 y Fj(The)g(Plot3D)g(class)f(do)
-r(es)g(not)i(itself)f(include)g(an)n(y)g(abilit)n(y)f(to)h(dra)n(w)f
-(on)h(a)g(graphics)e(device.)41 b(Instead)29 b(it)g(calls)227
-451 y(up)r(on)21 b(function)g(in)g(an)f(externally)g(supplied)g(mo)r
-(dule)h(\(the)g Ft(")p Fj(grf3d)p Ft(")e Fj(mo)r(dule\))i(to)g(do)f
-(the)h(required)e(dra)n(wing.)33 b(A)227 551 y(mo)r(dule)23
-b(should)g(b)r(e)g(written)g(that)g(implemen)n(ts)h(the)f(functions)g
-(of)g(the)g(grf3d)f(in)n(terface)g(using)h(the)g(facilities)g(of)227
-650 y(a)d(sp)r(eci\014c)g(graphics)e(system)h(This)h(mo)r(dule)g
-(should)g(then)g(b)r(e)g(link)n(ed)g(in)n(to)g(the)g(application)f(so)g
-(that)h(the)g(Plot3D)227 750 y(class)30 b(can)f(use)h(its)h(functions)f
-(\(see)g(the)h(description)f(of)g(the)g(ast)p Ft(_)p
-Fj(link)g(commands)f(for)h(details)g(of)g(ho)n(w)g(to)g(do)227
-849 y(this\).)35 b(The)19 b(grf3d)g(in)n(terface)g(de\014nes)g(a)g(few)
-h(simple)f(functions)h(for)f(dra)n(wing)f(primitiv)n(es)h(suc)n(h)g(as)
-f(straigh)n(t)h(lines,)227 949 y(mark)n(ers)27 b(and)h(c)n(haracter)e
-(strings.)38 b(These)28 b(functions)h(all)f(accept)g(p)r(ositions)f(in)
-i(the)g(3D)f(graphics)f(co)r(ordinate)227 1049 y(system)21
-b(\(the)h(base)e(F)-7 b(rame)21 b(of)f(the)i(Plot3D\),)f(and)f(so)h
-(the)g(grf3d)f(mo)r(dule)h(m)n(ust)h(also)d(manage)h(the)i(pro)5
-b(jection)20 b(of)227 1148 y(these)i(3D)g(co)r(ordinates)e(on)n(to)h
-(the)h(2D)g(viewing)f(surface,)h(including)g(the)h(c)n(hoice)d(of)i
+Ft(_)p Fj(GRID)p eop end
+%%Page: 544 554
+TeXDict begin 544 553 bop 0 52 a FG(544)2251 b Fz(D)91
+b(AST)30 b(CLASS)f(DESCRIPTIONS)340 351 y Fi(\017)45
+b Fj(T)-7 b(extLab1:)36 b(Descriptiv)n(e)27 b(lab)r(el)h(for)f(axis)g
+(1)g(dra)n(wn)g(using)g(AST)p Ft(_)p Fj(GRID)340 482
+y Fi(\017)45 b Fj(T)-7 b(extLab2:)36 b(Descriptiv)n(e)27
+b(lab)r(el)h(for)f(axis)g(2)g(dra)n(wn)g(using)g(AST)p
+Ft(_)p Fj(GRID)340 613 y Fi(\017)45 b Fj(Tic)n(ks:)36
+b(Tic)n(k)28 b(marks)e(\(b)r(oth)i(ma)5 b(jor)27 b(and)g(minor\))g(dra)
+n(wn)g(using)g(AST)p Ft(_)p Fj(GRID)340 744 y Fi(\017)45
+b Fj(Tic)n(ks1:)36 b(Tic)n(k)27 b(marks)f(\(b)r(oth)j(ma)5
+b(jor)26 b(and)i(minor\))f(for)g(axis)g(1)g(dra)n(wn)g(using)g(AST)p
+Ft(_)p Fj(GRID)340 874 y Fi(\017)45 b Fj(Tic)n(ks2:)36
+b(Tic)n(k)27 b(marks)f(\(b)r(oth)j(ma)5 b(jor)26 b(and)i(minor\))f(for)
+g(axis)g(2)g(dra)n(wn)g(using)g(AST)p Ft(_)p Fj(GRID)340
+1005 y Fi(\017)45 b Fj(Title:)38 b(The)27 b(Plot)g(title)h(dra)n(wn)f
+(using)g(AST)p Ft(_)p Fj(GRID)p 0 1200 3780 12 v 0 1332
+a FA(Plot3D)418 b Fd(Pro)m(vide)37 b(facilities)f(for)i(3D)h(graphical)
+d(output)415 b FA(Plot3D)0 1517 y Fc(Description:)44
+b Fj(A)28 b(Plot3D)g(is)f(a)h(sp)r(ecialised)f(form)g(of)h(Plot)f(that)
+h(pro)n(vides)e(facilities)i(for)f(pro)r(ducing)g(3D)h(graphical)227
+1616 y(output,)35 b(including)d(fully)i(annotated)e(3D)g(co)r(ordinate)
+g(grids.)50 b(The)33 b(base)f(F)-7 b(rame)32 b(in)h(a)f(Plot3D)g
+(describ)r(es)g(a)227 1716 y(3-dimensional)c Ft(")p Fj(graphical)p
+Ft(")f Fj(co)r(ordinate)h(system.)42 b(The)29 b(axes)g(of)g(this)h(co)r
+(ordinate)e(system)h(are)f(assumed)h(to)227 1816 y(b)r(e)d(righ)n
+(t-handed)f(\(that)h(is,)f(if)h(X)g(app)r(ears)f(horizon)n(tally)e(to)j
+(the)g(righ)n(t)e(and)i(Y)g(v)n(ertically)e(up)n(w)n(ards,)g(then)i(Z)g
+(is)227 1915 y(out)d(of)h(the)f(screen)g(to)n(w)n(ards)e(the)i(view)n
+(er\),)h(and)f(are)f(assumed)h(to)g(b)r(e)g(equally)g(scaled)f(\(that)i
+(is,)g(the)g(same)e(units)227 2015 y(are)32 b(used)g(to)g(measure)g(p)r
+(ositions)g(on)g(eac)n(h)f(of)i(the)g(3)f(axes\).)50
+b(The)33 b(upp)r(er)f(and)h(lo)n(w)n(er)d(b)r(ounds)j(of)f(a)g(v)n
+(olume)227 2115 y(within)25 b(this)g(graphical)d(co)r(ordinate)h
+(system)h(is)g(sp)r(eci\014ed)h(when)f(the)g(Plot3D)g(is)g(created,)g
+(and)g(all)g(subsequen)n(t)227 2214 y(graphics)i(are)h
+Ft(")p Fj(dra)n(wn)p Ft(")f Fj(in)i(this)g(v)n(olume.)227
+2338 y(The)h(Plot3D)g(class)f(do)r(es)g(not)i(itself)f(include)g(an)n
+(y)g(abilit)n(y)f(to)h(dra)n(w)f(on)h(a)g(graphics)e(device.)41
+b(Instead)29 b(it)g(calls)227 2437 y(up)r(on)21 b(function)g(in)g(an)f
+(externally)g(supplied)g(mo)r(dule)h(\(the)g Ft(")p Fj(grf3d)p
+Ft(")e Fj(mo)r(dule\))i(to)g(do)f(the)h(required)e(dra)n(wing.)33
+b(A)227 2537 y(mo)r(dule)23 b(should)g(b)r(e)g(written)g(that)g
+(implemen)n(ts)h(the)f(functions)g(of)g(the)g(grf3d)f(in)n(terface)g
+(using)h(the)g(facilities)g(of)227 2637 y(a)d(sp)r(eci\014c)g(graphics)
+e(system)h(This)h(mo)r(dule)g(should)g(then)g(b)r(e)g(link)n(ed)g(in)n
+(to)g(the)g(application)f(so)g(that)h(the)g(Plot3D)227
+2736 y(class)30 b(can)f(use)h(its)h(functions)f(\(see)g(the)h
+(description)f(of)g(the)g(ast)p Ft(_)p Fj(link)g(commands)f(for)h
+(details)g(of)g(ho)n(w)g(to)g(do)227 2836 y(this\).)35
+b(The)19 b(grf3d)g(in)n(terface)g(de\014nes)g(a)g(few)h(simple)f
+(functions)h(for)f(dra)n(wing)f(primitiv)n(es)h(suc)n(h)g(as)f(straigh)
+n(t)h(lines,)227 2936 y(mark)n(ers)27 b(and)h(c)n(haracter)e(strings.)
+38 b(These)28 b(functions)h(all)f(accept)g(p)r(ositions)f(in)i(the)g
+(3D)f(graphics)f(co)r(ordinate)227 3035 y(system)21 b(\(the)h(base)e(F)
+-7 b(rame)21 b(of)f(the)i(Plot3D\),)f(and)f(so)h(the)g(grf3d)f(mo)r
+(dule)h(m)n(ust)h(also)d(manage)h(the)i(pro)5 b(jection)20
+b(of)227 3135 y(these)i(3D)g(co)r(ordinates)e(on)n(to)h(the)h(2D)g
+(viewing)f(surface,)h(including)g(the)h(c)n(hoice)d(of)i
Ft(")p Fj(ey)n(e)p Ft(")p Fj(/)p Ft(")p Fj(camera)p Ft(")c
-Fj(p)r(osition,)227 1248 y(direction)25 b(of)g(viewing,)f(etc.)37
+Fj(p)r(osition,)227 3234 y(direction)25 b(of)g(viewing,)f(etc.)37
b(The)25 b(AST)g(library)e(includes)i(a)g(sample)f(implemen)n(tation)h
-(of)g(the)g(grf3d)f(in)n(terface)227 1348 y(based)j(on)h(the)g(PGPLOT)e
+(of)g(the)g(grf3d)f(in)n(terface)227 3334 y(based)j(on)h(the)g(PGPLOT)e
(graphics)h(system)g(\(see)h(\014le)f(grf3d)p Ft(_)p
Fj(pgplot.c\).)36 b(This)28 b(implemen)n(tation)g(also)e(serv)n(es)227
-1447 y(to)36 b(do)r(cumen)n(t)g(the)h(grf3d)e(in)n(terface)g(itself)i
+3434 y(to)36 b(do)r(cumen)n(t)g(the)h(grf3d)e(in)n(terface)g(itself)i
(and)f(should)g(b)r(e)g(consulted)g(for)g(details)f(b)r(efore)h
-(writing)g(a)g(new)227 1547 y(implemen)n(tation.)227
-1672 y(The)30 b(curren)n(t)g(F)-7 b(rame)29 b(of)h(a)g(Plot3D)f
+(writing)g(a)g(new)227 3533 y(implemen)n(tation.)227
+3657 y(The)30 b(curren)n(t)g(F)-7 b(rame)29 b(of)h(a)g(Plot3D)f
(describ)r(es)h(a)f Ft(")p Fj(ph)n(ysical)p Ft(")g Fj(3-dimensional)f
-(co)r(ordinate)h(system,)i(whic)n(h)f(is)227 1772 y(the)36
+(co)r(ordinate)h(system,)i(whic)n(h)f(is)227 3756 y(the)36
b(co)r(ordinate)f(system)h(in)g(whic)n(h)f(plotting)h(op)r(erations)e
(are)h(sp)r(eci\014ed)h(when)g(in)n(v)n(oking)e(the)j(metho)r(ds)f(of)
-227 1871 y(the)f(Plot3D)e(class.)55 b(The)34 b(results)f(of)h(eac)n(h)f
+227 3856 y(the)f(Plot3D)e(class.)55 b(The)34 b(results)f(of)h(eac)n(h)f
(plotting)h(op)r(eration)f(are)g(automatically)g(transformed)g(in)n(to)
-h(3D)227 1971 y(graphical)29 b(co)r(ordinates)f(b)r(efore)i(b)r(eing)g
+h(3D)227 3956 y(graphical)29 b(co)r(ordinates)f(b)r(efore)i(b)r(eing)g
(plotted)g(using)g(the)g(facilities)g(of)g(the)g(grf3d)f(mo)r(dule)i
-(link)n(ed)f(in)n(to)f(the)227 2071 y(application.)38
+(link)n(ed)f(in)n(to)f(the)227 4055 y(application.)38
b(Note,)28 b(at)f(least)h(one)g(of)f(the)i(three)e(axes)g(of)h(the)h
(curren)n(t)e(F)-7 b(rame)27 b(m)n(ust)h(b)r(e)h(indep)r(enden)n(t)f
-(of)g(the)227 2170 y(other)f(t)n(w)n(o)g(curren)n(t)g(F)-7
-b(rame)27 b(axes.)227 2295 y(Y)-7 b(ou)20 b(ma)n(y)f(select)h
+(of)g(the)227 4155 y(other)f(t)n(w)n(o)g(curren)n(t)g(F)-7
+b(rame)27 b(axes.)227 4278 y(Y)-7 b(ou)20 b(ma)n(y)f(select)h
(di\013eren)n(t)f(ph)n(ysical)g(co)r(ordinate)g(systems)g(in)h(whic)n
(h)f(to)h(plot)g(\(including)g(the)g(nativ)n(e)f(graphical)227
-2395 y(co)r(ordinate)26 b(system)h(itself)6 b(\))29 b(b)n(y)e
+4378 y(co)r(ordinate)26 b(system)h(itself)6 b(\))29 b(b)n(y)e
(selecting)f(di\013eren)n(t)i(F)-7 b(rames)26 b(as)h(the)g(curren)n(t)f
(F)-7 b(rame)27 b(of)g(a)g(Plot3D,)g(using)f(its)227
-2495 y(Curren)n(t)h(attribute.)227 2620 y(Lik)n(e)f(an)n(y)f(F)-7
+4478 y(Curren)n(t)h(attribute.)227 4601 y(Lik)n(e)f(an)n(y)f(F)-7
b(rameSet,)26 b(a)g(Plot3D)f(ma)n(y)h(also)f(b)r(e)h(used)g(as)g(a)f(F)
-7 b(rame.)36 b(In)26 b(this)h(case,)e(it)i(b)r(eha)n(v)n(es)e(lik)n(e)
-g(its)h(curren)n(t)227 2719 y(F)-7 b(rame,)27 b(whic)n(h)h(describ)r
+g(its)h(curren)n(t)227 4701 y(F)-7 b(rame,)27 b(whic)n(h)h(describ)r
(es)f(the)h(ph)n(ysical)f(co)r(ordinate)f(system.)227
-2845 y(When)i(used)g(as)f(a)g(Mapping,)g(a)g(Plot3D)g(describ)r(es)g
+4824 y(When)i(used)g(as)f(a)g(Mapping,)g(a)g(Plot3D)g(describ)r(es)g
(the)g(in)n(ter-relation)f(b)r(et)n(w)n(een)i(3D)f(graphical)f(co)r
-(ordinates)227 2944 y(\(its)i(base)f(F)-7 b(rame\))28
+(ordinates)227 4924 y(\(its)i(base)f(F)-7 b(rame\))28
b(and)f(3D)h(ph)n(ysical)e(co)r(ordinates)h(\(its)h(curren)n(t)e(F)-7
-b(rame\).)227 3070 y(Although)26 b(the)g(Plot3D)e(class)h(inherits)g
+b(rame\).)227 5047 y(Although)26 b(the)g(Plot3D)e(class)h(inherits)g
(from)g(the)h(Plot)f(class,)g(sev)n(eral)e(of)j(the)g(facilities)f(of)g
-(the)h(Plot)f(class)g(are)227 3169 y(not)f(a)n(v)-5 b(ailable)22
+(the)h(Plot)f(class)g(are)227 5147 y(not)f(a)n(v)-5 b(ailable)22
b(in)i(the)g(Plot3D)f(class,)h(and)f(an)h(error)e(will)h(b)r(e)i(rep)r
(orted)d(if)j(an)n(y)e(attempt)h(is)f(made)h(to)f(use)h(them.)227
-3269 y(Sp)r(eci\014cally)-7 b(,)38 b(the)d(Plot3D)g(class)f(do)r(es)h
+5247 y(Sp)r(eci\014cally)-7 b(,)38 b(the)d(Plot3D)g(class)f(do)r(es)h
(not)g(supp)r(ort)g(clipping)g(using)g(the)h(astClip)f(function.)60
-b(AST)p Ft(_)p Fj(CLIP)227 3368 y(routine.)36 b(Nor)24
+b(AST)p Ft(_)p Fj(CLIP)227 5346 y(routine.)36 b(Nor)24
b(do)r(es)h(it)g(supp)r(ort)g(the)g(sp)r(eci\014cation)g(of)g(graphics)
e(primitiv)n(e)i(functions)g(at)g(run-time)g(using)f(the)227
-3468 y(AST)p Ft(_)p Fj(GRFSET,)k(AST)p Ft(_)p Fj(GRFPOP)-7
+5446 y(AST)p Ft(_)p Fj(GRFSET,)k(AST)p Ft(_)p Fj(GRFPOP)-7
b(,)27 b(AST)p Ft(_)p Fj(GRFPUSH,)h(and)f(AST)p Ft(_)p
-Fj(GETGRF)n(CONTEXT)g(routines.)0 3619 y Fc(Constructor)32
-b(F)-8 b(unction:)227 3719 y Fj(AST)p Ft(_)p Fj(PLOT3D)-2
-3869 y Fc(Inheritance)n(:)227 4016 y Fj(The)28 b(Plot3D)f(class)g
-(inherits)g(from)g(the)h(Plot)f(class.)-2 4166 y Fc(A)m(ttributes)n(:)
-227 4312 y Fj(In)d(addition)g(to)f(those)g(attributes)h(common)f(to)g
-(all)h(Plots,)f(ev)n(ery)g(Plot3D)g(also)f(has)h(the)h(follo)n(wing)f
-(attributes:)340 4575 y Fi(\017)45 b Fj(Norm:)37 b(Normal)26
-b(v)n(ector)h(de\014ning)g(the)h(2D)g(plane)f(used)h(for)f(text)h(and)f
-(mark)n(ers)340 4709 y Fi(\017)45 b Fj(Ro)r(otCorner:)35
-b(Sp)r(eci\014es)28 b(whic)n(h)g(edges)f(of)g(the)h(3D)g(b)r(o)n(x)f
-(should)g(b)r(e)h(annotated.)227 4872 y(Some)35 b(attributes)f(of)g
-(the)h(Plot)f(class)g(refer)f(to)i(sp)r(eci\014c)f(ph)n(ysical)g(co)r
-(ordinate)f(axes)h(\(e.g.)57 b(Gap,)36 b(Lab)r(elUp,)227
-4972 y(Dra)n(wAxes,)29 b(etc\).)43 b(F)-7 b(or)29 b(a)g(basic)g(Plot,)g
-(the)h(axis)f(index)g(m)n(ust)h(b)r(e)g(1)f(or)f(2,)i(but)g(for)f(a)g
-(Plot3D)g(the)h(axis)f(index)227 5072 y(can)e(b)r(e)h(1,)g(2)f(or)g(3.)
-227 5197 y(Certain)35 b(Plot)h(attributes)f(are)g(ignored)f(b)n(y)i
-(the)g(Plot3D)f(class)g(\(e.g.)61 b(Edge,)37 b(Dra)n(wTitle,)g
-(TitleGap,)h(etc\).)227 5296 y(Consult)28 b(the)g(Plot)f(attribute)h
-(do)r(cumen)n(tation)f(for)g(details.)-2 5447 y Fc(F)-8
-b(unctions)n(:)227 5593 y Fj(The)27 b(Plot3D)e(class)h(do)r(es)g(not)g
-(de\014ne)h(an)n(y)e(new)i(routines)f(b)r(ey)n(ond)g(those)g(whic)n(h)g
-(are)f(applicable)h(to)g(all)g(Plots.)227 5693 y(Note,)37
-b(ho)n(w)n(ev)n(er,)d(that)h(the)g(follo)n(wing)e(metho)r(ds)i
-(inherited)g(from)f(the)h(Plot)f(class)f(cannot)h(b)r(e)h(used)g(with)g
-(a)p eop end
-%%Page: 539 549
-TeXDict begin 539 548 bop 3643 52 a FG(539)227 351 y
-Fj(Plot3D)27 b(and)h(will)f(rep)r(ort)g(an)h(error)d(if)j(called:)340
-482 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(BOUNDINGBO)n(X,)19
+Fj(GETGRF)n(CONTEXT)g(routines.)0 5593 y Fc(Constructor)32
+b(F)-8 b(unction:)227 5693 y Fj(AST)p Ft(_)p Fj(PLOT3D)p
+eop end
+%%Page: 545 555
+TeXDict begin 545 554 bop 3643 52 a FG(545)-2 351 y Fc(Inheritance)n(:)
+227 497 y Fj(The)28 b(Plot3D)f(class)g(inherits)g(from)g(the)h(Plot)f
+(class.)-2 656 y Fc(A)m(ttributes)n(:)227 802 y Fj(In)d(addition)g(to)f
+(those)g(attributes)h(common)f(to)g(all)h(Plots,)f(ev)n(ery)g(Plot3D)g
+(also)f(has)h(the)h(follo)n(wing)f(attributes:)340 1076
+y Fi(\017)45 b Fj(Norm:)37 b(Normal)26 b(v)n(ector)h(de\014ning)g(the)h
+(2D)g(plane)f(used)h(for)f(text)h(and)f(mark)n(ers)340
+1214 y Fi(\017)45 b Fj(Ro)r(otCorner:)35 b(Sp)r(eci\014es)28
+b(whic)n(h)g(edges)f(of)g(the)h(3D)g(b)r(o)n(x)f(should)g(b)r(e)h
+(annotated.)227 1385 y(Some)35 b(attributes)f(of)g(the)h(Plot)f(class)g
+(refer)f(to)i(sp)r(eci\014c)f(ph)n(ysical)g(co)r(ordinate)f(axes)h
+(\(e.g.)57 b(Gap,)36 b(Lab)r(elUp,)227 1484 y(Dra)n(wAxes,)29
+b(etc\).)43 b(F)-7 b(or)29 b(a)g(basic)g(Plot,)g(the)h(axis)f(index)g
+(m)n(ust)h(b)r(e)g(1)f(or)f(2,)i(but)g(for)f(a)g(Plot3D)g(the)h(axis)f
+(index)227 1584 y(can)e(b)r(e)h(1,)g(2)f(or)g(3.)227
+1713 y(Certain)35 b(Plot)h(attributes)f(are)g(ignored)f(b)n(y)i(the)g
+(Plot3D)f(class)g(\(e.g.)61 b(Edge,)37 b(Dra)n(wTitle,)g(TitleGap,)h
+(etc\).)227 1812 y(Consult)28 b(the)g(Plot)f(attribute)h(do)r(cumen)n
+(tation)f(for)g(details.)-2 1971 y Fc(F)-8 b(unctions)n(:)227
+2117 y Fj(The)27 b(Plot3D)e(class)h(do)r(es)g(not)g(de\014ne)h(an)n(y)e
+(new)i(routines)f(b)r(ey)n(ond)g(those)g(whic)n(h)g(are)f(applicable)h
+(to)g(all)g(Plots.)227 2217 y(Note,)37 b(ho)n(w)n(ev)n(er,)d(that)h
+(the)g(follo)n(wing)e(metho)r(ds)i(inherited)g(from)f(the)h(Plot)f
+(class)f(cannot)h(b)r(e)h(used)g(with)g(a)227 2316 y(Plot3D)27
+b(and)h(will)f(rep)r(ort)g(an)h(error)d(if)j(called:)340
+2462 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(BOUNDINGBO)n(X,)19
b(AST)p Ft(_)p Fj(CLIP)-7 b(,)18 b(AST)p Ft(_)p Fj(CUR)-9
b(VE,)18 b(AST)p Ft(_)p Fj(GENCUR)-9 b(VE,)18 b(AST)p
-Ft(_)p Fj(GETGRF)n(CONTEXT,)427 582 y(AST)p Ft(_)p Fj(GRFPOP)-7
+Ft(_)p Fj(GETGRF)n(CONTEXT,)427 2561 y(AST)p Ft(_)p Fj(GRFPOP)-7
b(,)27 b(AST)p Ft(_)p Fj(GRFPUSH,)h(AST)p Ft(_)p Fj(GRFSET,)g(AST)p
Ft(_)p Fj(GRIDLINE,)g(AST)p Ft(_)p Fj(POL)-7 b(YCUR)e(VE.)p
-0 769 3780 12 v 0 901 a FA(P)l(oin)l(tList)508 b Fd(A)39
+0 2769 3780 12 v 0 2901 a FA(P)l(oin)l(tList)508 b Fd(A)39
b(collection)e(of)h(p)s(oin)m(ts)g(in)g(a)h(F)-10 b(rame)506
-b FA(P)l(oin)l(tList)0 1078 y Fc(Description:)44 b Fj(The)20
+b FA(P)l(oin)l(tList)0 3099 y Fc(Description:)44 b Fj(The)20
b(P)n(oin)n(tList)e(class)g(implemen)n(ts)i(a)f(Region)f(whic)n(h)i
(represen)n(ts)e(a)g(collection)h(of)g(p)r(oin)n(ts)h(in)f(a)g(F)-7
-b(rame.)0 1222 y Fc(Constructor)32 b(F)-8 b(unction:)227
-1321 y Fj(AST)p Ft(_)p Fj(POINTLIST)-2 1465 y Fc(Inheritance)n(:)227
-1611 y Fj(The)28 b(P)n(oin)n(tList)e(class)h(inherits)h(from)f(the)h
-(Region)f(class.)-2 1755 y Fc(A)m(ttributes)n(:)227 1901
+b(rame.)0 3257 y Fc(Constructor)32 b(F)-8 b(unction:)227
+3357 y Fj(AST)p Ft(_)p Fj(POINTLIST)-2 3515 y Fc(Inheritance)n(:)227
+3662 y Fj(The)28 b(P)n(oin)n(tList)e(class)h(inherits)h(from)f(the)h
+(Region)f(class.)-2 3820 y Fc(A)m(ttributes)n(:)227 3966
y Fj(In)40 b(addition)g(to)g(those)f(attributes)h(common)f(to)h(all)f
(Regions,)j(ev)n(ery)d(P)n(oin)n(tList)f(also)h(has)g(the)i(follo)n
-(wing)227 2001 y(attributes:)340 2253 y Fi(\017)k Fj(ListSize:)37
+(wing)227 4066 y(attributes:)340 4340 y Fi(\017)k Fj(ListSize:)37
b(The)28 b(n)n(um)n(b)r(er)f(of)h(p)r(ositions)f(stored)g(in)h(the)g(P)
-n(oin)n(tList)-2 2409 y Fc(F)-8 b(unctions)n(:)227 2555
+n(oin)n(tList)-2 4511 y Fc(F)-8 b(unctions)n(:)227 4657
y Fj(The)37 b(P)n(oin)n(tList)f(class)g(do)r(es)h(not)g(de\014ne)g(an)n
(y)f(new)h(routines)g(b)r(ey)n(ond)f(those)h(whic)n(h)g(are)f
-(applicable)g(to)h(all)227 2655 y(Regions.)p 0 2842 V
-0 2974 a FA(P)l(olyMap)225 b Fd(Map)38 b(co)s(ordinates)f(using)h(p)s
-(olynomial)e(functions)223 b FA(P)l(olyMap)0 3151 y Fc(Description:)44
+(applicable)g(to)h(all)227 4757 y(Regions.)p 0 4965 V
+0 5097 a FA(P)l(olyMap)225 b Fd(Map)38 b(co)s(ordinates)f(using)h(p)s
+(olynomial)e(functions)223 b FA(P)l(olyMap)0 5295 y Fc(Description:)44
b Fj(A)33 b(P)n(olyMap)f(is)g(a)g(form)h(of)g(Mapping)f(whic)n(h)h(p)r
(erforms)f(a)g(general)f(p)r(olynomial)h(transformation.)227
-3251 y(Eac)n(h)37 b(output)g(co)r(ordinate)g(is)g(a)g(p)r(olynomial)g
+5394 y(Eac)n(h)37 b(output)g(co)r(ordinate)g(is)g(a)g(p)r(olynomial)g
(function)h(of)f(all)g(the)h(input)h(co)r(ordinates.)65
-b(The)37 b(co)r(e\016cien)n(ts)227 3351 y(are)29 b(sp)r(eci\014ed)i
+b(The)37 b(co)r(e\016cien)n(ts)227 5494 y(are)29 b(sp)r(eci\014ed)i
(separately)d(for)i(eac)n(h)f(output)i(co)r(ordinate.)43
b(The)30 b(forw)n(ard)f(and)h(in)n(v)n(erse)e(transformations)h(are)227
-3450 y(de\014ned)g(indep)r(endan)n(tly)f(b)n(y)g(separate)f(sets)h(of)g
+5593 y(de\014ned)g(indep)r(endan)n(tly)f(b)n(y)g(separate)f(sets)h(of)g
(co)r(e\016cien)n(ts.)39 b(If)29 b(no)f(in)n(v)n(erse)e(transformation)
-h(is)h(supplied,)h(an)227 3550 y(iterativ)n(e)e(metho)r(d)h(can)f(b)r
+h(is)h(supplied,)h(an)227 5693 y(iterativ)n(e)e(metho)r(d)h(can)f(b)r
(e)h(used)g(to)f(ev)-5 b(aluate)28 b(the)f(in)n(v)n(erse)g(based)g
-(only)g(on)g(the)h(forw)n(ard)e(transformation.)0 3694
-y Fc(Constructor)32 b(F)-8 b(unction:)227 3793 y Fj(AST)p
-Ft(_)p Fj(POL)h(YMAP)-2 3937 y Fc(Inheritance)n(:)227
-4083 y Fj(The)28 b(P)n(olyMap)e(class)h(inherits)g(from)g(the)h
-(Mapping)g(class.)-2 4227 y Fc(A)m(ttributes)n(:)227
-4373 y Fj(In)36 b(addition)f(to)h(those)f(attributes)g(common)g(to)g
-(all)h(Mappings,)g(ev)n(ery)f(P)n(olyMap)f(also)g(has)h(the)h(follo)n
-(wing)227 4472 y(attributes:)340 4725 y Fi(\017)45 b
-Fj(IterIn)n(v)n(erse:)35 b(Pro)n(vide)26 b(an)h(iterativ)n(e)g(in)n(v)n
-(erse)f(transformation?)340 4852 y Fi(\017)45 b Fj(NiterIn)n(v)n(erse:)
-36 b(Maxim)n(um)27 b(n)n(um)n(b)r(er)g(of)h(iterations)f(for)g
-(iterativ)n(e)f(in)n(v)n(erse)340 4979 y Fi(\017)45 b
+(only)g(on)g(the)h(forw)n(ard)e(transformation.)p eop
+end
+%%Page: 546 556
+TeXDict begin 546 555 bop 0 52 a FG(546)2251 b Fz(D)91
+b(AST)30 b(CLASS)f(DESCRIPTIONS)0 351 y Fc(Constructor)j(F)-8
+b(unction:)227 451 y Fj(AST)p Ft(_)p Fj(POL)h(YMAP)-2
+586 y Fc(Inheritance)n(:)227 733 y Fj(The)28 b(P)n(olyMap)e(class)h
+(inherits)g(from)g(the)h(Mapping)g(class.)-2 868 y Fc(A)m(ttributes)n
+(:)227 1014 y Fj(In)36 b(addition)f(to)h(those)f(attributes)g(common)g
+(to)g(all)h(Mappings,)g(ev)n(ery)f(P)n(olyMap)f(also)g(has)h(the)h
+(follo)n(wing)227 1114 y(attributes:)340 1354 y Fi(\017)45
+b Fj(IterIn)n(v)n(erse:)35 b(Pro)n(vide)26 b(an)h(iterativ)n(e)g(in)n
+(v)n(erse)f(transformation?)340 1473 y Fi(\017)45 b Fj(NiterIn)n(v)n
+(erse:)36 b(Maxim)n(um)27 b(n)n(um)n(b)r(er)g(of)h(iterations)f(for)g
+(iterativ)n(e)f(in)n(v)n(erse)340 1592 y Fi(\017)45 b
Fj(T)-7 b(olIn)n(v)n(erse:)35 b(T)-7 b(arget)27 b(relativ)n(e)f(error)g
-(for)h(iterativ)n(e)f(in)n(v)n(erse)-2 5135 y Fc(F)-8
-b(unctions)n(:)227 5281 y Fj(In)29 b(addition)f(to)g(those)g(routines)f
+(for)h(iterativ)n(e)f(in)n(v)n(erse)-2 1740 y Fc(F)-8
+b(unctions)n(:)227 1886 y Fj(In)29 b(addition)f(to)g(those)g(routines)f
(applicable)h(to)g(all)g(Ob)5 b(jects,)28 b(the)h(follo)n(wing)e
-(routines)g(ma)n(y)h(also)f(b)r(e)i(applied)227 5381
-y(to)f(all)f(Mappings:)340 5633 y Fi(\017)45 b Fj(AST)p
+(routines)g(ma)n(y)h(also)f(b)r(e)i(applied)227 1985
+y(to)f(all)f(Mappings:)340 2225 y Fi(\017)45 b Fj(AST)p
Ft(_)p Fj(POL)-7 b(YTRAN:)28 b(Fit)g(a)f(P)n(olyMap)f(in)n(v)n(erse)g
-(or)h(forw)n(ard)f(transformation)p eop end
-%%Page: 540 550
-TeXDict begin 540 549 bop 0 52 a FG(540)2251 b Fz(D)91
-b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 483
-a FA(P)l(olygon)153 b Fd(A)38 b(p)s(olygonal)d(region)h(within)h(a)g
-(2-dimensional)e(F)-10 b(rame)152 b FA(P)l(olygon)0 679
-y Fc(Description:)44 b Fj(The)25 b(P)n(olygon)e(class)g(implemen)n(ts)i
-(a)f(p)r(olygonal)g(area,)f(de\014ned)i(b)n(y)g(a)f(collection)g(of)h
-(v)n(ertices,)f(within)227 779 y(a)k(2-dimensional)f(F)-7
+(or)h(forw)n(ard)f(transformation)p 0 2397 3780 12 v
+0 2529 a FA(P)l(olygon)153 b Fd(A)38 b(p)s(olygonal)d(region)h(within)h
+(a)g(2-dimensional)e(F)-10 b(rame)152 b FA(P)l(olygon)0
+2690 y Fc(Description:)44 b Fj(The)25 b(P)n(olygon)e(class)g(implemen)n
+(ts)i(a)f(p)r(olygonal)g(area,)f(de\014ned)i(b)n(y)g(a)f(collection)g
+(of)h(v)n(ertices,)f(within)227 2789 y(a)k(2-dimensional)f(F)-7
b(rame.)39 b(The)29 b(v)n(ertices)e(are)h(connected)g(together)f(b)n(y)
i(geo)r(desic)e(curv)n(es)g(within)i(the)g(encap-)227
-878 y(sulated)g(F)-7 b(rame.)42 b(F)-7 b(or)28 b(instance,)i(if)g(the)f
-(encapsulated)g(F)-7 b(rame)29 b(is)g(a)g(simple)g(F)-7
-b(rame)29 b(then)h(the)f(geo)r(desics)f(will)227 978
+2889 y(sulated)g(F)-7 b(rame.)42 b(F)-7 b(or)28 b(instance,)i(if)g(the)
+f(encapsulated)g(F)-7 b(rame)29 b(is)g(a)g(simple)g(F)-7
+b(rame)29 b(then)h(the)f(geo)r(desics)f(will)227 2988
y(b)r(e)34 b(straigh)n(t)d(lines,)j(but)g(if)f(the)g(F)-7
b(rame)33 b(is)f(a)h(SkyF)-7 b(rame)32 b(then)h(the)g(geo)r(desics)f
-(will)h(b)r(e)g(great)f(circles.)52 b(Note,)227 1077
+(will)h(b)r(e)g(great)f(circles.)52 b(Note,)227 3088
y(the)31 b(v)n(ertices)e(m)n(ust)h(b)r(e)h(supplied)g(in)f(an)g(order)f
(suc)n(h)h(that)g(the)h(inside)f(of)g(the)h(p)r(olygon)e(is)h(to)g(the)
-h(left)g(of)f(the)227 1177 y(b)r(oundary)c(as)g(the)h(v)n(ertices)f
+h(left)g(of)f(the)227 3188 y(b)r(oundary)c(as)g(the)h(v)n(ertices)f
(are)f(tra)n(v)n(ersed.)35 b(Supplying)27 b(them)g(in)g(the)g(rev)n
(erse)e(order)g(will)i(e\013ectiv)n(ely)f(negate)227
-1277 y(the)i(p)r(olygon.)227 1405 y(Within)33 b(a)e(SkyF)-7
+3287 y(the)i(p)r(olygon.)227 3405 y(Within)33 b(a)e(SkyF)-7
b(rame,)32 b(neigh)n(b)r(ouring)e(v)n(ertices)g(are)h(alw)n(a)n(ys)e
(joined)j(using)f(the)h(shortest)e(path.)49 b(Th)n(us)31
-b(if)h(an)227 1504 y(edge)f(of)g(180)f(degrees)g(or)g(more)g(in)i
+b(if)h(an)227 3505 y(edge)f(of)g(180)f(degrees)g(or)g(more)g(in)i
(length)f(is)g(required,)g(it)h(should)e(b)r(e)i(split)g(in)n(to)e
-(section)h(eac)n(h)g(of)g(whic)n(h)g(is)227 1604 y(less)k(than)h(180)e
+(section)h(eac)n(h)g(of)g(whic)n(h)g(is)227 3604 y(less)k(than)h(180)e
(degrees.)59 b(The)35 b(closed)g(path)g(joining)g(all)h(the)f(v)n
(ertices)g(in)g(order)f(will)i(divide)f(the)h(celestial)227
-1704 y(sphere)f(in)n(to)h(t)n(w)n(o)f(disjoin)n(t)h(regions.)60
+3704 y(sphere)f(in)n(to)h(t)n(w)n(o)f(disjoin)n(t)h(regions.)60
b(The)36 b(inside)g(of)g(the)g(p)r(olygon)f(is)g(the)h(region)f(whic)n
-(h)h(is)f(circled)h(in)g(an)227 1803 y(an)n(ti-clo)r(c)n(kwise)25
+(h)h(is)f(circled)h(in)g(an)227 3803 y(an)n(ti-clo)r(c)n(kwise)25
b(manner)h(\(when)i(view)n(ed)e(from)g(the)h(inside)g(of)g(the)g
(celestial)f(sphere\))h(when)g(mo)n(ving)e(through)227
-1903 y(the)h(list)f(of)g(v)n(ertices)f(in)i(the)f(order)f(in)h(whic)n
+3903 y(the)h(list)f(of)g(v)n(ertices)f(in)i(the)f(order)f(in)h(whic)n
(h)g(they)h(w)n(ere)e(supplied)h(when)h(the)f(P)n(olygon)e(w)n(as)h
-(created)h(\(i.e.)36 b(the)227 2003 y(inside)28 b(is)f(to)h(the)g(left)
+(created)h(\(i.e.)36 b(the)227 4003 y(inside)28 b(is)f(to)h(the)g(left)
g(of)g(the)g(b)r(oundary)f(when)g(mo)n(ving)g(through)g(the)h(v)n
-(ertices)e(in)i(the)g(order)e(supplied\).)0 2159 y Fc(Constructor)32
-b(F)-8 b(unction:)227 2259 y Fj(AST)p Ft(_)p Fj(POL)h(YGON)-2
-2415 y Fc(Inheritance)n(:)227 2562 y Fj(The)28 b(P)n(olygon)d(class)i
-(inherits)g(from)h(the)g(Region)f(class.)-2 2718 y Fc(A)m(ttributes)n
-(:)227 2864 y Fj(The)36 b(P)n(olygon)d(class)i(do)r(es)g(not)h
+(ertices)e(in)i(the)g(order)e(supplied\).)0 4138 y Fc(Constructor)32
+b(F)-8 b(unction:)227 4238 y Fj(AST)p Ft(_)p Fj(POL)h(YGON)-2
+4373 y Fc(Inheritance)n(:)227 4519 y Fj(The)28 b(P)n(olygon)d(class)i
+(inherits)g(from)h(the)g(Region)f(class.)-2 4655 y Fc(A)m(ttributes)n
+(:)227 4801 y Fj(The)36 b(P)n(olygon)d(class)i(do)r(es)g(not)h
(de\014ne)f(an)n(y)g(new)h(attributes)f(b)r(ey)n(ond)g(those)g(whic)n
-(h)h(are)e(applicable)h(to)h(all)227 2964 y(Regions.)-2
-3121 y Fc(F)-8 b(unctions)n(:)227 3267 y Fj(In)28 b(addition)g(to)g
+(h)h(are)e(applicable)h(to)h(all)227 4901 y(Regions.)-2
+5036 y Fc(F)-8 b(unctions)n(:)227 5182 y Fj(In)28 b(addition)g(to)g
(those)g(routines)f(applicable)h(to)f(all)h(Regions,)f(the)i(follo)n
(wing)e(routines)g(ma)n(y)g(also)g(b)r(e)i(applied)227
-3366 y(to)f(all)f(P)n(olygons:)340 3638 y Fi(\017)45
+5282 y(to)f(all)f(P)n(olygons:)340 5522 y Fi(\017)45
b Fj(AST)p Ft(_)p Fj(DO)n(WNSIZE:)28 b(Reduce)f(the)h(n)n(um)n(b)r(er)g
-(of)f(v)n(ertices)g(in)h(a)f(P)n(olygon.)340 3774 y Fi(\017)45
+(of)f(v)n(ertices)g(in)h(a)f(P)n(olygon.)340 5641 y Fi(\017)45
b Fj(AST)p Ft(_)p Fj(OUTLINE)p Fl(<)p Fj(X)p Fl(>)p Fj(:)36
b(Create)27 b(a)g(P)n(olygon)e(outlining)j(v)-5 b(alues)27
-b(in)h(a)f(pixel)h(arra)n(y)p 0 3981 V 0 4113 a FA(Prism)320
-b Fd(An)39 b(extrusion)e(of)i(a)f(region)f(in)m(to)h(higher)g
-(dimensions)318 b FA(Prism)0 4309 y Fc(Description:)44
-b Fj(A)26 b(Prism)e(is)h(a)g(Region)f(whic)n(h)h(represen)n(ts)f(an)h
-(extrusion)f(of)h(an)g(existing)g(Region)f(in)n(to)h(one)g(or)f(more)
-227 4408 y(orthogonal)32 b(dimensions)h(\(sp)r(eci\014ed)i(b)n(y)e
-(another)g(Region\).)55 b(If)34 b(the)g(Region)g(to)f(b)r(e)h(extruded)
-g(has)f(N)h(axes,)227 4508 y(and)25 b(the)g(Region)f(de\014ning)h(the)g
-(extrusion)f(has)g(M)h(axes,)g(then)g(the)g(resulting)g(Prism)e(will)i
-(ha)n(v)n(e)f(\(M+N\))h(axes.)227 4607 y(A)i(p)r(oin)n(t)g(is)g(inside)
-f(the)h(Prism)f(if)h(the)g(\014rst)g(N)g(axis)f(v)-5
-b(alues)26 b(corresp)r(ond)f(to)i(a)f(p)r(oin)n(t)h(inside)f(the)i
-(Region)e(b)r(eing)227 4707 y(extruded,)34 b(and)e(the)h(remaining)e(M)
-i(axis)e(v)-5 b(alues)32 b(corresp)r(ond)f(to)h(a)g(p)r(oin)n(t)h
-(inside)f(the)h(Region)f(de\014ning)g(the)227 4807 y(extrusion.)227
-4935 y(As)h(an)g(example,)h(a)f(cylinder)g(can)f(b)r(e)i(represen)n
-(ted)e(b)n(y)h(extruding)f(an)h(existing)g(Circle,)h(using)e(an)h(In)n
-(terv)-5 b(al)227 5034 y(to)31 b(de\014ne)g(the)g(extrusion.)46
-b(Ih)31 b(this)g(case,)g(the)g(In)n(terv)-5 b(al)30 b(w)n(ould)h(ha)n
-(v)n(e)e(a)i(single)f(axis)g(and)h(w)n(ould)f(sp)r(ecify)h(the)227
-5134 y(upp)r(er)d(and)f(lo)n(w)n(er)f(limits)j(of)e(the)h(cylinder)f
-(along)g(its)g(length.)0 5291 y Fc(Constructor)32 b(F)-8
-b(unction:)227 5390 y Fj(AST)p Ft(_)p Fj(PRISM)-2 5547
-y Fc(Inheritance)n(:)227 5693 y Fj(The)28 b(Prism)f(class)f(inherits)i
-(from)f(the)h(Region)f(class.)p eop end
-%%Page: 541 551
-TeXDict begin 541 550 bop 3643 52 a FG(541)-2 351 y Fc(A)m(ttributes)n
-(:)227 497 y Fj(The)19 b(Prism)g(class)f(do)r(es)g(not)h(de\014ne)h(an)
-n(y)e(new)h(attributes)g(b)r(ey)n(ond)g(those)f(whic)n(h)h(are)f
-(applicable)h(to)g(all)f(Regions.)-2 648 y Fc(F)-8 b(unctions)n(:)227
-794 y Fj(The)21 b(Prism)f(class)g(do)r(es)h(not)g(de\014ne)g(an)n(y)f
+b(in)h(a)f(pixel)h(arra)n(y)p eop end
+%%Page: 547 557
+TeXDict begin 547 556 bop 3643 52 a FG(547)p 0 351 3780
+12 v 0 483 a FA(Prism)320 b Fd(An)39 b(extrusion)e(of)i(a)f(region)f
+(in)m(to)h(higher)g(dimensions)318 b FA(Prism)0 695 y
+Fc(Description:)44 b Fj(A)26 b(Prism)e(is)h(a)g(Region)f(whic)n(h)h
+(represen)n(ts)f(an)h(extrusion)f(of)h(an)g(existing)g(Region)f(in)n
+(to)h(one)g(or)f(more)227 794 y(orthogonal)32 b(dimensions)h(\(sp)r
+(eci\014ed)i(b)n(y)e(another)g(Region\).)55 b(If)34 b(the)g(Region)g
+(to)f(b)r(e)h(extruded)g(has)f(N)h(axes,)227 894 y(and)25
+b(the)g(Region)f(de\014ning)h(the)g(extrusion)f(has)g(M)h(axes,)g(then)
+g(the)g(resulting)g(Prism)e(will)i(ha)n(v)n(e)f(\(M+N\))h(axes.)227
+993 y(A)i(p)r(oin)n(t)g(is)g(inside)f(the)h(Prism)f(if)h(the)g(\014rst)
+g(N)g(axis)f(v)-5 b(alues)26 b(corresp)r(ond)f(to)i(a)f(p)r(oin)n(t)h
+(inside)f(the)i(Region)e(b)r(eing)227 1093 y(extruded,)34
+b(and)e(the)h(remaining)e(M)i(axis)e(v)-5 b(alues)32
+b(corresp)r(ond)f(to)h(a)g(p)r(oin)n(t)h(inside)f(the)h(Region)f
+(de\014ning)g(the)227 1193 y(extrusion.)227 1329 y(As)h(an)g(example,)h
+(a)f(cylinder)g(can)f(b)r(e)i(represen)n(ted)e(b)n(y)h(extruding)f(an)h
+(existing)g(Circle,)h(using)e(an)h(In)n(terv)-5 b(al)227
+1428 y(to)31 b(de\014ne)g(the)g(extrusion.)46 b(Ih)31
+b(this)g(case,)g(the)g(In)n(terv)-5 b(al)30 b(w)n(ould)h(ha)n(v)n(e)e
+(a)i(single)f(axis)g(and)h(w)n(ould)f(sp)r(ecify)h(the)227
+1528 y(upp)r(er)d(and)f(lo)n(w)n(er)f(limits)j(of)e(the)h(cylinder)f
+(along)g(its)g(length.)0 1700 y Fc(Constructor)32 b(F)-8
+b(unction:)227 1800 y Fj(AST)p Ft(_)p Fj(PRISM)-2 1972
+y Fc(Inheritance)n(:)227 2118 y Fj(The)28 b(Prism)f(class)f(inherits)i
+(from)f(the)h(Region)f(class.)-2 2290 y Fc(A)m(ttributes)n(:)227
+2436 y Fj(The)19 b(Prism)g(class)f(do)r(es)g(not)h(de\014ne)h(an)n(y)e
+(new)h(attributes)g(b)r(ey)n(ond)g(those)f(whic)n(h)h(are)f(applicable)
+h(to)g(all)f(Regions.)-2 2609 y Fc(F)-8 b(unctions)n(:)227
+2755 y Fj(The)21 b(Prism)f(class)g(do)r(es)h(not)g(de\014ne)g(an)n(y)f
(new)h(routines)f(b)r(ey)n(ond)h(those)f(whic)n(h)h(are)f(applicable)g
-(to)h(all)g(Regions.)p 0 994 3780 12 v 0 1125 a FA(RateMap)844
-1126 y Fd(Mapping)38 b(whic)m(h)g(represen)m(ts)f(di\013eren)m(tiation)
-3232 1125 y FA(RateMap)0 1315 y Fc(Description:)44 b
+(to)h(all)g(Regions.)p 0 2977 V 0 3107 a FA(RateMap)844
+3108 y Fd(Mapping)38 b(whic)m(h)g(represen)m(ts)f(di\013eren)m(tiation)
+3232 3107 y FA(RateMap)0 3320 y Fc(Description:)44 b
Fj(A)37 b(RateMap)e(is)h(a)f(Mapping)h(whic)n(h)g(represen)n(ts)e(a)i
(single)f(elemen)n(t)h(of)g(the)g(Jacobian)e(matrix)i(of)227
-1415 y(another)h(Mapping.)67 b(The)38 b(Mapping)g(for)f(whic)n(h)h(the)
+3420 y(another)h(Mapping.)67 b(The)38 b(Mapping)g(for)f(whic)n(h)h(the)
g(Jacobian)e(is)i(required)f(is)g(sp)r(eci\014ed)h(when)g(the)h(new)227
-1515 y(RateMap)27 b(is)h(created,)f(and)g(is)h(referred)e(to)i(as)f
+3519 y(RateMap)27 b(is)h(created,)f(and)g(is)h(referred)e(to)i(as)f
(the)h Ft(")p Fj(encapsulated)e(Mapping)p Ft(")h Fj(b)r(elo)n(w.)227
-1640 y(The)39 b(n)n(um)n(b)r(er)f(of)g(inputs)h(to)f(a)g(RateMap)g(is)g
+3655 y(The)39 b(n)n(um)n(b)r(er)f(of)g(inputs)h(to)f(a)g(RateMap)g(is)g
(the)h(same)f(as)f(the)i(n)n(um)n(b)r(er)f(of)h(inputs)f(to)h(its)f
-(encapsulated)227 1739 y(Mapping.)e(The)27 b(n)n(um)n(b)r(er)f(of)h
+(encapsulated)227 3755 y(Mapping.)e(The)27 b(n)n(um)n(b)r(er)f(of)h
(outputs)g(from)f(a)g(RateMap)g(is)h(alw)n(a)n(ys)e(one.)36
-b(This)26 b(one)g(output)i(equals)d(the)i(rate)227 1839
+b(This)26 b(one)g(output)i(equals)d(the)i(rate)227 3854
y(of)c(c)n(hange)f(of)h(a)g(sp)r(eci\014ed)g(output)h(of)f(the)g
(encapsulated)g(Mapping)f(with)i(resp)r(ect)f(to)f(a)h(sp)r(eci\014ed)g
-(input)h(of)f(the)227 1938 y(encapsulated)k(Mapping)g(\(the)i(input)f
+(input)h(of)f(the)227 3954 y(encapsulated)k(Mapping)g(\(the)i(input)f
(and)g(output)g(to)f(use)h(are)e(sp)r(eci\014ed)i(when)g(the)g(RateMap)
-f(is)h(created\).)227 2063 y(A)g(RateMap)f(whic)n(h)h(has)e(not)i(b)r
+f(is)h(created\).)227 4090 y(A)g(RateMap)f(whic)n(h)h(has)e(not)i(b)r
(een)g(in)n(v)n(erted)e(do)r(es)i(not)f(de\014ne)h(an)f(in)n(v)n(erse)f
-(transformation.)35 b(If)28 b(a)f(RateMap)227 2163 y(has)g(b)r(een)h
+(transformation.)35 b(If)28 b(a)f(RateMap)227 4190 y(has)g(b)r(een)h
(in)n(v)n(erted)f(then)h(it)g(will)g(de\014ne)g(an)f(in)n(v)n(erse)f
(transformation)g(but)j(not)e(a)g(forw)n(ard)f(transformation.)0
-2313 y Fc(Constructor)32 b(F)-8 b(unction:)227 2413 y
-Fj(AST)p Ft(_)p Fj(RA)h(TEMAP)-2 2563 y Fc(Inheritance)n(:)227
-2709 y Fj(The)28 b(RateMap)f(class)g(inherits)g(from)h(the)g(Mapping)f
-(class.)-2 2860 y Fc(A)m(ttributes)n(:)227 3006 y Fj(The)33
+4362 y Fc(Constructor)32 b(F)-8 b(unction:)227 4461 y
+Fj(AST)p Ft(_)p Fj(RA)h(TEMAP)-2 4634 y Fc(Inheritance)n(:)227
+4780 y Fj(The)28 b(RateMap)f(class)g(inherits)g(from)h(the)g(Mapping)f
+(class.)-2 4952 y Fc(A)m(ttributes)n(:)227 5098 y Fj(The)33
b(RateMap)f(class)g(do)r(es)g(not)h(de\014ne)g(an)n(y)e(new)i
(attributes)g(b)r(ey)n(ond)f(those)g(whic)n(h)h(are)e(applicable)h(to)h
-(all)227 3105 y(Mappings.)-2 3256 y Fc(F)-8 b(unctions)n(:)227
-3402 y Fj(The)37 b(RateMap)g(class)f(do)r(es)g(not)h(de\014ne)g(an)n(y)
+(all)227 5198 y(Mappings.)-2 5370 y Fc(F)-8 b(unctions)n(:)227
+5516 y Fj(The)37 b(RateMap)g(class)f(do)r(es)g(not)h(de\014ne)g(an)n(y)
g(new)g(routines)f(b)r(ey)n(ond)g(those)h(whic)n(h)g(are)f(applicable)g
-(to)h(all)227 3501 y(Mappings.)p 0 3702 V 0 3833 a FA(Region)269
-b Fd(Represen)m(ts)39 b(a)f(region)g(within)f(a)h(co)s(ordinate)f
-(system)267 b FA(Region)0 4023 y Fc(Description:)44 b
-Fj(This)25 b(class)e(pro)n(vides)g(the)h(basic)g(facilities)g(for)g
+(to)h(all)227 5616 y(Mappings.)p eop end
+%%Page: 548 558
+TeXDict begin 548 557 bop 0 52 a FG(548)2251 b Fz(D)91
+b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 483
+a FA(Region)269 b Fd(Represen)m(ts)39 b(a)f(region)g(within)f(a)h(co)s
+(ordinate)f(system)267 b FA(Region)0 675 y Fc(Description:)44
+b Fj(This)25 b(class)e(pro)n(vides)g(the)h(basic)g(facilities)g(for)g
(describing)g(a)f(region)g(within)i(a)f(sp)r(eci\014ed)h(co)r(ordinate)
-227 4123 y(system.)37 b(Ho)n(w)n(ev)n(er,)26 b(the)h(Region)g(class)g
+227 774 y(system.)37 b(Ho)n(w)n(ev)n(er,)26 b(the)h(Region)g(class)g
(do)r(es)g(not)h(ha)n(v)n(e)e(a)h(constructor)f(function)i(of)g(its)f
-(o)n(wn,)g(as)g(it)h(is)g(simply)227 4222 y(a)i(con)n(tainer)e(class)h
+(o)n(wn,)g(as)g(it)h(is)g(simply)227 874 y(a)i(con)n(tainer)e(class)h
(for)h(a)f(family)h(of)g(sp)r(ecialised)f(sub-classes)f(suc)n(h)i(as)f
(Circle,)h(Bo)n(x,)g(etc,)g(whic)n(h)g(implemen)n(t)227
-4322 y(Regions)d(with)h(particular)e(shap)r(es.)227 4447
+973 y(Regions)d(with)h(particular)e(shap)r(es.)227 1099
y(All)j(sub-classes)e(of)i(Region)f(require)g(a)g(F)-7
b(rame)28 b(to)h(b)r(e)g(supplied)g(when)g(the)g(Region)f(is)g
-(created.)39 b(This)29 b(F)-7 b(rame)227 4546 y(describ)r(es)25
+(created.)39 b(This)29 b(F)-7 b(rame)227 1199 y(describ)r(es)25
b(the)h(co)r(ordinate)e(system)i(in)g(whic)n(h)f(the)h(Region)f(is)g
(de\014ned,)i(and)e(is)g(referred)g(to)g(as)g(the)h Ft(")p
-Fj(encapsu-)227 4646 y(lated)g(F)-7 b(rame)p Ft(")24
+Fj(encapsu-)227 1299 y(lated)g(F)-7 b(rame)p Ft(")24
b Fj(b)r(elo)n(w.)36 b(Constructors)23 b(will)j(also)e(t)n(ypically)h
(required)f(one)h(or)g(more)f(p)r(ositions)h(to)h(b)r(e)f(supplied)227
-4746 y(whic)n(h)32 b(de\014ne)g(the)g(lo)r(cation)g(and)f(exten)n(t)h
+1398 y(whic)n(h)32 b(de\014ne)g(the)g(lo)r(cation)g(and)f(exten)n(t)h
(of)g(the)g(region.)48 b(These)32 b(p)r(ositions)f(m)n(ust)h(b)r(e)h
-(supplied)f(within)g(the)227 4845 y(encapsulated)27 b(F)-7
-b(rame.)227 4970 y(The)36 b(Region)g(class)f(inherits)g(from)h(the)g(F)
+(supplied)f(within)g(the)227 1498 y(encapsulated)27 b(F)-7
+b(rame.)227 1624 y(The)36 b(Region)g(class)f(inherits)g(from)h(the)g(F)
-7 b(rame)36 b(class,)h(and)f(so)f(a)h(Region)f(can)g(b)r(e)i(supplied)
-f(where-ev)n(er)e(a)227 5070 y(F)-7 b(rame)27 b(is)h(exp)r(ected.)37
+f(where-ev)n(er)e(a)227 1723 y(F)-7 b(rame)27 b(is)h(exp)r(ected.)37
b(In)28 b(these)g(cases,)e(supplying)i(a)f(Region)g(is)h(equiv)-5
b(alen)n(t)27 b(to)g(supplying)h(a)f(reference)g(to)g(its)227
-5170 y(encapsulated)33 b(F)-7 b(rame.)53 b(Th)n(us)32
+1823 y(encapsulated)33 b(F)-7 b(rame.)53 b(Th)n(us)32
b(all)h(the)h(metho)r(ds)f(of)g(the)h(F)-7 b(rame)32
b(class)g(can)h(b)r(e)h(used)f(on)g(the)g(Region)f(class.)227
-5269 y(F)-7 b(or)27 b(instance,)h(the)g(AST)p Ft(_)p
+1923 y(F)-7 b(or)27 b(instance,)h(the)g(AST)p Ft(_)p
Fj(F)n(ORMA)-7 b(T)27 b(routine)g(ma)n(y)g(b)r(e)h(used)g(on)f(a)g
(Region)g(to)h(format)f(an)g(axis)g(v)-5 b(alue.)227
-5394 y(In)26 b(addition,)h(since)f(F)-7 b(rame)25 b(inherits)h(from)g
+2049 y(In)26 b(addition,)h(since)f(F)-7 b(rame)25 b(inherits)h(from)g
(Mapping,)g(a)f(Region)h(is)g(also)f(a)g(sort)g(of)h(Mapping.)36
-b(T)-7 b(ransforming)227 5494 y(p)r(ositions)24 b(b)n(y)g(supplying)g
+b(T)-7 b(ransforming)227 2148 y(p)r(ositions)24 b(b)n(y)g(supplying)g
(a)g(Region)f(to)h(one)g(of)g(the)h(AST)p Ft(_)p Fj(TRAN)p
Fl(<)p Fj(X)p Fl(>)f Fj(routines)f(is)h(the)h(w)n(a)n(y)e(to)h
-(determine)g(if)227 5593 y(a)d(giv)n(en)f(p)r(osition)h(is)g(inside)g
+(determine)g(if)227 2248 y(a)d(giv)n(en)f(p)r(osition)h(is)g(inside)g
(or)f(outside)h(the)g(Region.)34 b(When)22 b(used)f(as)f(a)h(Mapping,)h
-(most)e(classes)g(of)h(F)-7 b(rame)21 b(are)227 5693
+(most)e(classes)g(of)h(F)-7 b(rame)21 b(are)227 2348
y(equiv)-5 b(alen)n(t)26 b(to)g(a)g(UnitMap.)37 b(Ho)n(w)n(ev)n(er,)25
b(the)i(Region)e(class)h(mo)r(di\014es)g(this)g(b)r(eha)n(viour)f(so)h
-(that)h(a)f(Region)f(acts)p eop end
-%%Page: 542 552
-TeXDict begin 542 551 bop 0 52 a FG(542)2251 b Fz(D)91
-b(AST)30 b(CLASS)f(DESCRIPTIONS)227 351 y Fj(lik)n(e)23
-b(a)f(UnitMap)i(only)e(for)h(input)g(p)r(ositions)g(whic)n(h)g(are)e
-(within)j(the)f(area)f(represen)n(ted)f(b)n(y)i(the)g(Region.)35
-b(Input)227 451 y(p)r(ositions)24 b(whic)n(h)h(are)e(outside)h(the)h
-(area)e(pro)r(duce)h(bad)g(output)h(v)-5 b(alues)24 b(\(i.e.)37
-b(the)24 b(output)h(v)-5 b(alues)24 b(are)g(equal)g(to)227
-551 y(AST)p Ft(__)p Fj(BAD\).)k(This)f(b)r(eha)n(viour)f(is)h(the)h
-(same)e(for)h(b)r(oth)h(the)f(forw)n(ard)f(and)h(the)h(in)n(v)n(erse)d
-(transformation.)35 b(In)227 650 y(this)d(sense)e(the)h
+(that)h(a)f(Region)f(acts)227 2447 y(lik)n(e)e(a)f(UnitMap)i(only)e
+(for)h(input)g(p)r(ositions)g(whic)n(h)g(are)e(within)j(the)f(area)f
+(represen)n(ted)f(b)n(y)i(the)g(Region.)35 b(Input)227
+2547 y(p)r(ositions)24 b(whic)n(h)h(are)e(outside)h(the)h(area)e(pro)r
+(duce)h(bad)g(output)h(v)-5 b(alues)24 b(\(i.e.)37 b(the)24
+b(output)h(v)-5 b(alues)24 b(are)g(equal)g(to)227 2646
+y(AST)p Ft(__)p Fj(BAD\).)k(This)f(b)r(eha)n(viour)f(is)h(the)h(same)e
+(for)h(b)r(oth)h(the)f(forw)n(ard)f(and)h(the)h(in)n(v)n(erse)d
+(transformation.)35 b(In)227 2746 y(this)d(sense)e(the)h
Ft(")p Fj(in)n(v)n(erse)e(transformation)p Ft(")g Fj(is)i(not)g(a)g
(true)g(in)n(v)n(erse)e(of)i(the)g(forw)n(ard)f(transformation,)g
-(since)227 750 y(applying)d(the)h(forw)n(ard)e(transformation)h(to)g(a)
-g(p)r(oin)n(t)h(outside)g(the)g(Region,)f(and)h(then)g(applying)f(the)h
-(in)n(v)n(erse)227 849 y(transformation)g(results,)i(in)g(a)f(set)h(of)
-f(AST)p Ft(__)p Fj(BAD)h(axis)f(v)-5 b(alues)29 b(rather)g(than)h(the)g
-(original)e(axis)h(v)-5 b(alues.)42 b(If)227 949 y(required,)32
-b(the)h(AST)p Ft(_)p Fj(REMO)n(VEREGIONS)d(function)j(can)e(b)r(e)i
-(used)f(to)f(remo)n(v)n(e)g(the)h Ft(")p Fj(masking)p
-Ft(")e Fj(e\013ect)j(of)227 1049 y(an)n(y)e(Regions)f(con)n(tained)g
-(within)i(a)f(comp)r(ound)g(Mapping)g(or)f(F)-7 b(rameSet.)47
-b(It)31 b(do)r(es)g(this)h(b)n(y)f(replacing)e(eac)n(h)227
-1148 y(Region)35 b(with)g(a)g(UnitMap)h(or)e(equiv)-5
+(since)227 2846 y(applying)d(the)h(forw)n(ard)e(transformation)h(to)g
+(a)g(p)r(oin)n(t)h(outside)g(the)g(Region,)f(and)h(then)g(applying)f
+(the)h(in)n(v)n(erse)227 2945 y(transformation)g(results,)i(in)g(a)f
+(set)h(of)f(AST)p Ft(__)p Fj(BAD)h(axis)f(v)-5 b(alues)29
+b(rather)g(than)h(the)g(original)e(axis)h(v)-5 b(alues.)42
+b(If)227 3045 y(required,)32 b(the)h(AST)p Ft(_)p Fj(REMO)n(VEREGIONS)d
+(function)j(can)e(b)r(e)i(used)f(to)f(remo)n(v)n(e)g(the)h
+Ft(")p Fj(masking)p Ft(")e Fj(e\013ect)j(of)227 3145
+y(an)n(y)e(Regions)f(con)n(tained)g(within)i(a)f(comp)r(ound)g(Mapping)
+g(or)f(F)-7 b(rameSet.)47 b(It)31 b(do)r(es)g(this)h(b)n(y)f(replacing)
+e(eac)n(h)227 3244 y(Region)35 b(with)g(a)g(UnitMap)h(or)e(equiv)-5
b(alen)n(t)35 b(F)-7 b(rame)35 b(\(dep)r(ending)h(on)f(the)g(con)n
-(text)g(in)h(whic)n(h)f(the)g(Region)g(is)227 1248 y(used\).)227
-1373 y(If)d(the)f(co)r(ordinate)f(system)h(represen)n(ted)e(b)n(y)i
+(text)g(in)h(whic)n(h)f(the)g(Region)g(is)227 3344 y(used\).)227
+3470 y(If)d(the)f(co)r(ordinate)f(system)h(represen)n(ted)e(b)n(y)i
(the)g(Region)g(is)g(c)n(hanged)e(\(b)n(y)i(c)n(hanging)f(the)h(v)-5
-b(alues)31 b(of)g(one)f(or)227 1473 y(more)23 b(of)g(the)h(attribute)g
+b(alues)31 b(of)g(one)f(or)227 3569 y(more)23 b(of)g(the)h(attribute)g
(whic)n(h)g(the)g(Region)e(inherits)i(from)f(its)h(encapsulated)f(F)-7
-b(rame\),)24 b(the)g(area)e(represen)n(ted)227 1573 y(b)n(y)f(the)h
+b(rame\),)24 b(the)g(area)e(represen)n(ted)227 3669 y(b)n(y)f(the)h
(Region)f(is)g(mapp)r(ed)h(in)n(to)f(the)g(new)h(co)r(ordinate)e
(system.)35 b(F)-7 b(or)20 b(instance,)j(let's)e(sa)n(y)f(a)h(Circle)g
-(\(a)g(sub)r(class)227 1672 y(of)32 b(Region\))g(is)f(created,)i(a)e
+(\(a)g(sub)r(class)227 3769 y(of)32 b(Region\))g(is)f(created,)i(a)e
(SkyF)-7 b(rame)31 b(b)r(eing)h(supplied)h(to)e(the)i(constructor)d(so)
-h(that)i(the)f(Circle)f(describ)r(es)227 1772 y(a)g(circular)f(area)g
+h(that)i(the)f(Circle)f(describ)r(es)227 3868 y(a)g(circular)f(area)g
(on)h(the)g(sky)g(in)h(FK4)e(equatorial)g(co)r(ordinates.)46
b(Since)32 b(Region)e(inherits)i(from)f(F)-7 b(rame,)31
-b(the)227 1871 y(Circle)23 b(will)h(ha)n(v)n(e)f(a)g(System)h
+b(the)227 3968 y(Circle)23 b(will)h(ha)n(v)n(e)f(a)g(System)h
(attribute)f(and)h(this)g(attribute)g(will)f(b)r(e)h(set)g(to)g
Ft(")p Fj(FK4)p Ft(")p Fj(.)34 b(If)24 b(the)g(System)f(attribute)227
-1971 y(of)29 b(the)g(Region)f(is)g(then)h(c)n(hanged)f(from)g(FK4)g(to)
+4068 y(of)29 b(the)g(Region)f(is)g(then)h(c)n(hanged)f(from)g(FK4)g(to)
g(FK5,)h(the)g(circular)e(area)g(represen)n(ted)g(b)n(y)i(the)g(Region)
-e(will)227 2071 y(automatically)34 b(b)r(e)h(mapp)r(ed)g(from)f(the)h
+e(will)227 4167 y(automatically)34 b(b)r(e)h(mapp)r(ed)g(from)f(the)h
(FK4)f(system)g(in)n(to)h(the)g(FK5)f(system.)57 b(In)35
-b(general,)g(c)n(hanging)e(the)227 2170 y(co)r(ordinate)26
+b(general,)g(c)n(hanging)e(the)227 4267 y(co)r(ordinate)26
b(system)h(in)h(this)f(w)n(a)n(y)f(ma)n(y)g(result)h(in)g(the)h(region)
e(c)n(hanging)g(shap)r(e)h(-)f(for)h(instance,)g(a)g(circle)f(ma)n(y)
-227 2270 y(c)n(hange)33 b(in)n(to)g(an)g(ellipse)h(if)g(the)g
+227 4366 y(c)n(hange)33 b(in)n(to)g(an)g(ellipse)h(if)g(the)g
(transformation)e(from)h(the)h(old)g(to)f(the)h(new)g(co)r(ordinate)e
-(system)i(is)f(linear)227 2370 y(but)j(with)g(di\013eren)n(t)f(scales)f
+(system)i(is)f(linear)227 4466 y(but)j(with)g(di\013eren)n(t)f(scales)f
(on)h(eac)n(h)g(axis.)58 b(Th)n(us)35 b(the)h(sp)r(eci\014c)f(class)g
(of)g(a)f(Region)h(cannot)g(b)r(e)g(used)g(as)g(a)227
-2469 y(guaran)n(tee)22 b(of)h(the)h(shap)r(e)f(in)h(an)n(y)e
+4566 y(guaran)n(tee)22 b(of)h(the)h(shap)r(e)f(in)h(an)n(y)e
(particular)g(co)r(ordinate)g(system.)36 b(If)23 b(the)h(AST)p
-Ft(_)p Fj(SIMPLIFY)f(routine)g(is)h(used)227 2569 y(on)g(a)g(Region,)g
+Ft(_)p Fj(SIMPLIFY)f(routine)g(is)h(used)227 4665 y(on)g(a)g(Region,)g
(it)h(will)f(endea)n(v)n(our)e(to)i(return)g(a)g(new)g(Region)f(of)h(a)
g(sub-class)f(whic)n(h)h(accurately)f(describ)r(es)g(the)227
-2668 y(shap)r(e)28 b(in)g(the)f(curren)n(t)g(co)r(ordinate)g(system)g
+4765 y(shap)r(e)28 b(in)g(the)f(curren)n(t)g(co)r(ordinate)g(system)g
(of)h(the)g(Region)e(\(but)j(this)f(ma)n(y)f(not)g(alw)n(a)n(ys)f(b)r
-(e)i(p)r(ossible\).)227 2794 y(It)e(is)f(p)r(ossible)g(to)g(negate)f
+(e)i(p)r(ossible\).)227 4891 y(It)e(is)f(p)r(ossible)g(to)g(negate)f
(an)h(existing)g(Region)f(so)h(that)g(it)h(represen)n(ts)e(all)g(areas)
-g(of)h(the)h(encapsulated)e(F)-7 b(rame)227 2893 y(except)28
+g(of)h(the)h(encapsulated)e(F)-7 b(rame)227 4990 y(except)28
b(for)f(the)h(area)e(sp)r(eci\014ed)i(when)g(the)g(Region)f(w)n(as)f
-(created.)0 3044 y Fc(Constructor)32 b(F)-8 b(unction:)227
-3144 y Fj(None.)-2 3295 y Fc(Inheritance)n(:)227 3441
+(created.)0 5143 y Fc(Constructor)32 b(F)-8 b(unction:)227
+5242 y Fj(None.)-2 5395 y Fc(Inheritance)n(:)227 5541
y Fj(The)28 b(Region)f(class)f(inherits)i(from)f(the)h(F)-7
-b(rame)27 b(class.)-2 3592 y Fc(A)m(ttributes)n(:)227
-3738 y Fj(In)20 b(addition)f(to)g(those)f(attributes)h(common)g(to)g
-(all)g(F)-7 b(rames,)20 b(ev)n(ery)e(Region)g(also)g(has)h(the)h(follo)
-n(wing)e(attributes:)340 4002 y Fi(\017)45 b Fj(Adaptiv)n(e:)37
+b(rame)27 b(class.)-2 5693 y Fc(A)m(ttributes)n(:)p eop
+end
+%%Page: 549 559
+TeXDict begin 549 558 bop 3643 52 a FG(549)227 351 y
+Fj(In)20 b(addition)f(to)g(those)f(attributes)h(common)g(to)g(all)g(F)
+-7 b(rames,)20 b(ev)n(ery)e(Region)g(also)g(has)h(the)h(follo)n(wing)e
+(attributes:)340 609 y Fi(\017)45 b Fj(Adaptiv)n(e:)37
b(Should)28 b(the)g(area)e(adapt)h(to)h(c)n(hanges)e(in)i(the)g(co)r
-(ordinate)e(system?)340 4135 y Fi(\017)45 b Fj(Negated:)37
+(ordinate)e(system?)340 739 y Fi(\017)45 b Fj(Negated:)37
b(Has)27 b(the)h(original)e(region)g(b)r(een)i(negated?)340
-4269 y Fi(\017)45 b Fj(Closed:)37 b(Should)27 b(the)h(b)r(oundary)f(b)r
+870 y Fi(\017)45 b Fj(Closed:)37 b(Should)27 b(the)h(b)r(oundary)f(b)r
(e)h(considered)f(to)g(b)r(e)h(inside)g(the)g(region?)340
-4403 y Fi(\017)45 b Fj(MeshSize:)37 b(Num)n(b)r(er)28
+1001 y Fi(\017)45 b Fj(MeshSize:)37 b(Num)n(b)r(er)28
b(of)f(p)r(oin)n(ts)h(used)g(to)f(create)g(a)g(mesh)g(co)n(v)n(ering)f
-(the)i(Region)340 4536 y Fi(\017)45 b Fj(FillF)-7 b(actor:)37
+(the)i(Region)340 1131 y Fi(\017)45 b Fj(FillF)-7 b(actor:)37
b(F)-7 b(raction)26 b(of)i(the)g(Region)f(whic)n(h)g(is)h(of)f(in)n
-(terest)340 4670 y Fi(\017)45 b Fj(Bounded:)37 b(Is)27
-b(the)h(Region)f(b)r(ounded?)227 4834 y(Ev)n(ery)21 b(Region)g(also)g
+(terest)340 1262 y Fi(\017)45 b Fj(Bounded:)37 b(Is)27
+b(the)h(Region)f(b)r(ounded?)227 1422 y(Ev)n(ery)21 b(Region)g(also)g
(inherits)h(an)n(y)g(further)g(attributes)g(that)g(b)r(elong)g(to)g
(the)h(encapsulated)e(F)-7 b(rame,)23 b(regardless)227
-4933 y(of)37 b(that)h(F)-7 b(rame's)36 b(class.)65 b(\(F)-7
+1521 y(of)37 b(that)h(F)-7 b(rame's)36 b(class.)65 b(\(F)-7
b(or)37 b(example,)i(the)f(Equino)n(x)e(attribute,)k(de\014ned)d(b)n(y)
-g(the)h(SkyF)-7 b(rame)36 b(class,)j(is)227 5033 y(inherited)28
+g(the)h(SkyF)-7 b(rame)36 b(class,)j(is)227 1621 y(inherited)28
b(b)n(y)f(an)n(y)g(Region)g(whic)n(h)h(represen)n(ts)e(a)h(SkyF)-7
-b(rame.\))-2 5184 y Fc(F)f(unctions)n(:)227 5330 y Fj(In)30
+b(rame.\))-2 1768 y Fc(F)f(unctions)n(:)227 1914 y Fj(In)30
b(addition)f(to)h(those)f(routines)g(applicable)g(to)g(all)g(F)-7
b(rames,)29 b(the)h(follo)n(wing)f(routines)g(ma)n(y)f(also)h(b)r(e)h
-(applied)227 5430 y(to)e(all)f(Regions:)340 5693 y Fi(\017)45
+(applied)227 2014 y(to)e(all)f(Regions:)340 2271 y Fi(\017)45
b Fj(AST)p Ft(_)p Fj(GETREGIONBOUNDS:)28 b(Get)g(the)g(b)r(ounds)f(of)h
-(a)f(Region)p eop end
-%%Page: 543 553
-TeXDict begin 543 552 bop 3643 52 a FG(543)340 351 y
-Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GETREGIONFRAME:)27 b(Get)h(a)g(cop)n(y)
-e(of)i(the)g(F)-7 b(rame)27 b(represen)n(t)f(b)n(y)i(a)f(Region)340
-508 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GETREGIONMESH:)27
-b(Get)h(a)f(mesh)h(of)g(p)r(oin)n(ts)f(co)n(v)n(ering)e(a)j(Region)340
-664 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GETREGIONPOINTS:)27
-b(Get)h(the)g(p)r(ositions)f(that)h(de\014ne)f(a)h(Region)340
-821 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GETUNC:)28 b(Obtain)f(uncertain)n
-(t)n(y)g(information)g(from)g(a)g(Region)340 977 y Fi(\017)45
-b Fj(AST)p Ft(_)p Fj(MAPREGION:)27 b(T)-7 b(ransform)27
-b(a)g(Region)g(in)n(to)g(a)g(new)h(co)r(ordinate)e(system)340
-1134 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(NEGA)-7 b(TE:)28
-b(T)-7 b(oggle)26 b(the)i(v)-5 b(alue)27 b(of)h(the)g(Negated)f
-(attribute)340 1291 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(O)n(VERLAP:)27
-b(Determines)g(the)h(nature)g(of)f(the)h(o)n(v)n(erlap)e(b)r(et)n(w)n
-(een)h(t)n(w)n(o)g(Regions)340 1447 y Fi(\017)45 b Fj(AST)p
-Ft(_)p Fj(MASK)p Fl(<)p Fj(X)p Fl(>)p Fj(:)37 b(Mask)27
-b(a)g(region)f(of)i(a)f(data)g(grid)340 1604 y Fi(\017)45
-b Fj(AST)p Ft(_)p Fj(SETUNC:)28 b(Asso)r(ciate)f(a)g(new)h(uncertain)n
-(t)n(y)e(with)j(a)e(Region)340 1760 y Fi(\017)45 b Fj(AST)p
-Ft(_)p Fj(SHO)n(WMESH:)28 b(Displa)n(y)f(a)g(mesh)h(of)f(p)r(oin)n(ts)h
-(on)f(the)h(surface)f(of)h(a)f(Region)p 0 2007 3780 12
-v 0 2139 a FA(SelectorMap)298 b Fd(A)38 b(Mapping)g(that)g(lo)s(cates)g
-(p)s(ositions)889 2253 y(within)c(one)j(of)f(a)g(set)g(of)g(alternate)e
-(Regions)3043 2139 y FA(SelectorMap)0 2489 y Fc(Description:)44
-b Fj(A)26 b(SelectorMap)e(is)h(a)g(Mapping)g(that)h(iden)n(ti\014es)f
-(whic)n(h)g(Region)g(con)n(tains)f(a)h(giv)n(en)g(input)h(p)r(osition.)
-227 2638 y(A)40 b(SelectorMap)e(encapsulates)h(a)g(n)n(um)n(b)r(er)g
-(of)g(Regions)f(that)i(all)f(ha)n(v)n(e)f(the)i(same)f(n)n(um)n(b)r(er)
-g(of)g(axes)g(and)227 2737 y(represen)n(t)31 b(the)h(same)f(co)r
-(ordinate)g(F)-7 b(rame.)49 b(The)32 b(n)n(um)n(b)r(er)g(of)f(inputs)i
-(\(Nin)f(attribute\))h(of)e(the)i(SelectorMap)227 2837
-y(equals)24 b(the)h(n)n(um)n(b)r(er)f(of)g(axes)f(spanned)h(b)n(y)g
-(one)g(of)h(the)f(encapsulated)g(Region.)35 b(All)25
-b(SelectorMaps)e(ha)n(v)n(e)g(only)227 2937 y(a)k(single)h(output.)37
-b(SelectorMaps)26 b(do)i(not)f(de\014ne)h(an)f(in)n(v)n(erse)f
-(transformation.)227 3085 y(F)-7 b(or)36 b(eac)n(h)f(input)i(p)r
-(osition,)h(the)e(forw)n(ard)e(transformation)h(of)h(a)f(SelectorMap)g
-(searc)n(hes)f(through)h(the)i(en-)227 3184 y(capsulated)d(Regions)f
-(\(in)i(the)g(order)e(supplied)i(when)f(the)h(SelectorMap)e(w)n(as)h
-(created\))f(un)n(til)i(a)f(Region)g(is)227 3284 y(found)27
-b(whic)n(h)g(con)n(tains)f(the)h(input)g(p)r(osition.)36
-b(The)27 b(index)g(asso)r(ciated)e(with)i(this)g(Region)f(is)h
-(returned)f(as)g(the)227 3384 y(SelectorMap)h(output)h(v)-5
-b(alue)27 b(\(the)h(index)g(v)-5 b(alue)27 b(is)h(the)g(p)r(osition)f
-(of)h(the)f(Region)g(within)h(the)g(list)g(of)g(Regions)227
-3483 y(supplied)c(when)g(the)g(SelectorMap)f(w)n(as)g(created,)g
-(starting)g(at)h(1)f(for)g(the)h(\014rst)g(Region\).)35
-b(If)24 b(an)f(input)i(p)r(osition)227 3583 y(is)j(not)f(con)n(tained)g
+(a)f(Region)340 2402 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GETREGIONFRAME:)
+27 b(Get)h(a)g(cop)n(y)e(of)i(the)g(F)-7 b(rame)27 b(represen)n(t)f(b)n
+(y)i(a)f(Region)340 2533 y Fi(\017)45 b Fj(AST)p Ft(_)p
+Fj(GETREGIONMESH:)27 b(Get)h(a)f(mesh)h(of)g(p)r(oin)n(ts)f(co)n(v)n
+(ering)e(a)j(Region)340 2663 y Fi(\017)45 b Fj(AST)p
+Ft(_)p Fj(GETREGIONPOINTS:)27 b(Get)h(the)g(p)r(ositions)f(that)h
+(de\014ne)f(a)h(Region)340 2794 y Fi(\017)45 b Fj(AST)p
+Ft(_)p Fj(GETUNC:)28 b(Obtain)f(uncertain)n(t)n(y)g(information)g(from)
+g(a)g(Region)340 2925 y Fi(\017)45 b Fj(AST)p Ft(_)p
+Fj(MAPREGION:)27 b(T)-7 b(ransform)27 b(a)g(Region)g(in)n(to)g(a)g(new)
+h(co)r(ordinate)e(system)340 3055 y Fi(\017)45 b Fj(AST)p
+Ft(_)p Fj(NEGA)-7 b(TE:)28 b(T)-7 b(oggle)26 b(the)i(v)-5
+b(alue)27 b(of)h(the)g(Negated)f(attribute)340 3186 y
+Fi(\017)45 b Fj(AST)p Ft(_)p Fj(O)n(VERLAP:)27 b(Determines)g(the)h
+(nature)g(of)f(the)h(o)n(v)n(erlap)e(b)r(et)n(w)n(een)h(t)n(w)n(o)g
+(Regions)340 3316 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(MASK)p
+Fl(<)p Fj(X)p Fl(>)p Fj(:)37 b(Mask)27 b(a)g(region)f(of)i(a)f(data)g
+(grid)340 3447 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(SETUNC:)28
+b(Asso)r(ciate)f(a)g(new)h(uncertain)n(t)n(y)e(with)j(a)e(Region)340
+3578 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(SHO)n(WMESH:)28
+b(Displa)n(y)f(a)g(mesh)h(of)f(p)r(oin)n(ts)h(on)f(the)h(surface)f(of)h
+(a)f(Region)p 0 3772 3780 12 v 0 3904 a FA(SelectorMap)298
+b Fd(A)38 b(Mapping)g(that)g(lo)s(cates)g(p)s(ositions)889
+4019 y(within)c(one)j(of)f(a)g(set)g(of)g(alternate)e(Regions)3043
+3904 y FA(SelectorMap)0 4203 y Fc(Description:)44 b Fj(A)26
+b(SelectorMap)e(is)h(a)g(Mapping)g(that)h(iden)n(ti\014es)f(whic)n(h)g
+(Region)g(con)n(tains)f(a)h(giv)n(en)g(input)h(p)r(osition.)227
+4326 y(A)40 b(SelectorMap)e(encapsulates)h(a)g(n)n(um)n(b)r(er)g(of)g
+(Regions)f(that)i(all)f(ha)n(v)n(e)f(the)i(same)f(n)n(um)n(b)r(er)g(of)
+g(axes)g(and)227 4426 y(represen)n(t)31 b(the)h(same)f(co)r(ordinate)g
+(F)-7 b(rame.)49 b(The)32 b(n)n(um)n(b)r(er)g(of)f(inputs)i(\(Nin)f
+(attribute\))h(of)e(the)i(SelectorMap)227 4526 y(equals)24
+b(the)h(n)n(um)n(b)r(er)f(of)g(axes)f(spanned)h(b)n(y)g(one)g(of)h(the)
+f(encapsulated)g(Region.)35 b(All)25 b(SelectorMaps)e(ha)n(v)n(e)g
+(only)227 4625 y(a)k(single)h(output.)37 b(SelectorMaps)26
+b(do)i(not)f(de\014ne)h(an)f(in)n(v)n(erse)f(transformation.)227
+4749 y(F)-7 b(or)36 b(eac)n(h)f(input)i(p)r(osition,)h(the)e(forw)n
+(ard)e(transformation)h(of)h(a)f(SelectorMap)g(searc)n(hes)f(through)h
+(the)i(en-)227 4848 y(capsulated)d(Regions)f(\(in)i(the)g(order)e
+(supplied)i(when)f(the)h(SelectorMap)e(w)n(as)h(created\))f(un)n(til)i
+(a)f(Region)g(is)227 4948 y(found)27 b(whic)n(h)g(con)n(tains)f(the)h
+(input)g(p)r(osition.)36 b(The)27 b(index)g(asso)r(ciated)e(with)i
+(this)g(Region)f(is)h(returned)f(as)g(the)227 5048 y(SelectorMap)h
+(output)h(v)-5 b(alue)27 b(\(the)h(index)g(v)-5 b(alue)27
+b(is)h(the)g(p)r(osition)f(of)h(the)f(Region)g(within)h(the)g(list)g
+(of)g(Regions)227 5147 y(supplied)c(when)g(the)g(SelectorMap)f(w)n(as)g
+(created,)g(starting)g(at)h(1)f(for)g(the)h(\014rst)g(Region\).)35
+b(If)24 b(an)f(input)i(p)r(osition)227 5247 y(is)j(not)f(con)n(tained)g
(within)i(an)n(y)d(Region,)h(a)h(v)-5 b(alue)27 b(of)h(zero)e(is)i
(returned)f(b)n(y)g(the)h(forw)n(ard)e(transformation.)227
-3731 y(If)35 b(a)e(comp)r(ound)h(Mapping)g(con)n(tains)f(a)h
+5370 y(If)35 b(a)e(comp)r(ound)h(Mapping)g(con)n(tains)f(a)h
(SelectorMap)f(in)h(series)f(with)i(its)f(o)n(wn)g(in)n(v)n(erse,)g
-(the)g(com)n(bination)227 3831 y(of)29 b(the)f(t)n(w)n(o)g(adjacen)n(t)
+(the)g(com)n(bination)227 5470 y(of)29 b(the)f(t)n(w)n(o)g(adjacen)n(t)
g(SelectorMaps)f(will)h(b)r(e)h(replaced)e(b)n(y)h(a)g(UnitMap)h(when)g
-(the)f(comp)r(ound)h(Mapping)f(is)227 3930 y(simpli\014ed)g(using)g
-(AST)p Ft(_)p Fj(SIMPLIFY.)227 4079 y(In)g(practice,)f(SelectorMaps)f
-(are)h(often)h(used)f(in)h(conjunction)g(with)g(Switc)n(hMaps.)0
-4276 y Fc(Constructor)k(F)-8 b(unction:)227 4375 y Fj(AST)p
-Ft(_)p Fj(SELECTORMAP)-2 4572 y Fc(Inheritance)n(:)227
-4718 y Fj(The)28 b(SelectorMap)f(class)f(inherits)i(from)f(the)h
-(Mapping)f(class.)-2 4915 y Fc(A)m(ttributes)n(:)227
-5061 y Fj(The)e(SelectorMap)f(class)g(do)r(es)h(not)g(de\014ne)g(an)n
-(y)f(new)h(attributes)g(b)r(ey)n(ond)g(those)g(whic)n(h)g(are)f
-(applicable)g(to)h(all)227 5161 y(Mappings.)-2 5358 y
-Fc(F)-8 b(unctions)n(:)227 5504 y Fj(The)30 b(SelectorMap)e(class)g(do)
-r(es)h(not)h(de\014ne)f(an)n(y)g(new)g(routines)g(b)r(ey)n(ond)g(those)
-f(whic)n(h)i(are)e(applicable)h(to)g(all)227 5603 y(Mappings.)p
+(the)f(comp)r(ound)h(Mapping)f(is)227 5570 y(simpli\014ed)g(using)g
+(AST)p Ft(_)p Fj(SIMPLIFY.)227 5693 y(In)g(practice,)f(SelectorMaps)f
+(are)h(often)h(used)f(in)h(conjunction)g(with)g(Switc)n(hMaps.)p
eop end
-%%Page: 544 554
-TeXDict begin 544 553 bop 0 52 a FG(544)2251 b Fz(D)91
-b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 483
-a FA(ShiftMap)306 b Fd(Add)39 b(a)f(constan)m(t)f(v)-7
-b(alue)39 b(to)f(eac)m(h)g(co)s(ordinate)304 b FA(ShiftMap)0
-663 y Fc(Description:)44 b Fj(A)28 b(ShiftMap)h(is)e(a)g(linear)g
-(Mapping)g(whic)n(h)h(shifts)g(eac)n(h)f(axis)g(b)n(y)g(a)g(sp)r
-(eci\014ed)h(constan)n(t)f(v)-5 b(alue.)0 808 y Fc(Constructor)32
-b(F)-8 b(unction:)227 908 y Fj(AST)p Ft(_)p Fj(SHIFTMAP)-2
-1053 y Fc(Inheritance)n(:)227 1199 y Fj(The)28 b(ShiftMap)g(class)f
-(inherits)g(from)h(the)g(Mapping)f(class.)-2 1345 y Fc(A)m(ttributes)n
-(:)227 1491 y Fj(The)33 b(ShiftMap)g(class)f(do)r(es)g(not)g(de\014ne)h
-(an)n(y)f(new)h(attributes)f(b)r(ey)n(ond)g(those)g(whic)n(h)h(are)e
-(applicable)h(to)h(all)227 1590 y(Mappings.)-2 1736 y
-Fc(F)-8 b(unctions)n(:)227 1882 y Fj(The)37 b(ShiftMap)h(class)e(do)r
-(es)g(not)h(de\014ne)g(an)n(y)f(new)h(routines)f(b)r(ey)n(ond)h(those)f
-(whic)n(h)h(are)f(applicable)g(to)h(all)227 1981 y(Mappings.)p
-0 2172 V 0 2304 a FA(SkyAxis)619 b Fd(Store)38 b(celestial)e(axis)j
-(information)615 b FA(SkyAxis)0 2484 y Fc(Description:)44
+%%Page: 550 560
+TeXDict begin 550 559 bop 0 52 a FG(550)2251 b Fz(D)91
+b(AST)30 b(CLASS)f(DESCRIPTIONS)0 351 y Fc(Constructor)j(F)-8
+b(unction:)227 451 y Fj(AST)p Ft(_)p Fj(SELECTORMAP)-2
+600 y Fc(Inheritance)n(:)227 746 y Fj(The)28 b(SelectorMap)f(class)f
+(inherits)i(from)f(the)h(Mapping)f(class.)-2 895 y Fc(A)m(ttributes)n
+(:)227 1041 y Fj(The)e(SelectorMap)f(class)g(do)r(es)h(not)g(de\014ne)g
+(an)n(y)f(new)h(attributes)g(b)r(ey)n(ond)g(those)g(whic)n(h)g(are)f
+(applicable)g(to)h(all)227 1141 y(Mappings.)-2 1290 y
+Fc(F)-8 b(unctions)n(:)227 1436 y Fj(The)30 b(SelectorMap)e(class)g(do)
+r(es)h(not)h(de\014ne)f(an)n(y)g(new)g(routines)g(b)r(ey)n(ond)g(those)
+f(whic)n(h)i(are)e(applicable)h(to)g(all)227 1535 y(Mappings.)p
+0 1734 3780 12 v 0 1865 a FA(ShiftMap)306 b Fd(Add)39
+b(a)f(constan)m(t)f(v)-7 b(alue)39 b(to)f(eac)m(h)g(co)s(ordinate)304
+b FA(ShiftMap)0 2053 y Fc(Description:)44 b Fj(A)28 b(ShiftMap)h(is)e
+(a)g(linear)g(Mapping)g(whic)n(h)h(shifts)g(eac)n(h)f(axis)g(b)n(y)g(a)
+g(sp)r(eci\014ed)h(constan)n(t)f(v)-5 b(alue.)0 2202
+y Fc(Constructor)32 b(F)-8 b(unction:)227 2302 y Fj(AST)p
+Ft(_)p Fj(SHIFTMAP)-2 2451 y Fc(Inheritance)n(:)227 2597
+y Fj(The)28 b(ShiftMap)g(class)f(inherits)g(from)h(the)g(Mapping)f
+(class.)-2 2746 y Fc(A)m(ttributes)n(:)227 2892 y Fj(The)33
+b(ShiftMap)g(class)f(do)r(es)g(not)g(de\014ne)h(an)n(y)f(new)h
+(attributes)f(b)r(ey)n(ond)g(those)g(whic)n(h)h(are)e(applicable)h(to)h
+(all)227 2992 y(Mappings.)-2 3141 y Fc(F)-8 b(unctions)n(:)227
+3287 y Fj(The)37 b(ShiftMap)h(class)e(do)r(es)g(not)h(de\014ne)g(an)n
+(y)f(new)h(routines)f(b)r(ey)n(ond)h(those)f(whic)n(h)h(are)f
+(applicable)g(to)h(all)227 3387 y(Mappings.)p 0 3585
+V 0 3717 a FA(SkyAxis)619 b Fd(Store)38 b(celestial)e(axis)j
+(information)615 b FA(SkyAxis)0 3905 y Fc(Description:)44
b Fj(The)c(SkyAxis)f(class)g(is)h(used)f(to)h(store)f(information)f
(asso)r(ciated)h(with)h(a)f(particular)g(axis)f(of)i(a)227
-2584 y(SkyF)-7 b(rame.)43 b(It)30 b(is)g(used)g(in)n(ternally)f(b)n(y)g
+4004 y(SkyF)-7 b(rame.)43 b(It)30 b(is)g(used)g(in)n(ternally)f(b)n(y)g
(the)h(AST)h(library)d(and)i(has)f(no)h(constructor)e(function.)44
-b(Y)-7 b(ou)30 b(should)227 2683 y(encoun)n(ter)d(it)h(only)f(within)i
+b(Y)-7 b(ou)30 b(should)227 4104 y(encoun)n(ter)d(it)h(only)f(within)i
(textual)e(output)h(\(e.g.)37 b(from)27 b(AST)p Ft(_)p
-Fj(WRITE\).)0 2828 y Fc(Constructor)32 b(F)-8 b(unction:)227
-2928 y Fj(None.)-2 3073 y Fc(Inheritance)n(:)227 3219
+Fj(WRITE\).)0 4253 y Fc(Constructor)32 b(F)-8 b(unction:)227
+4352 y Fj(None.)-2 4501 y Fc(Inheritance)n(:)227 4648
y Fj(The)28 b(SkyAxis)f(class)g(inherits)g(from)h(the)g(Axis)f(class.)p
-0 3410 V 0 3542 a FA(SkyF)-11 b(rame)306 b Fd(Celestial)37
+0 4846 V 0 4978 a FA(SkyF)-11 b(rame)306 b Fd(Celestial)37
b(co)s(ordinate)f(system)i(description)305 b FA(SkyF)-11
-b(rame)0 3727 y Fc(Description:)44 b Fj(A)35 b(SkyF)-7
+b(rame)0 5170 y Fc(Description:)44 b Fj(A)35 b(SkyF)-7
b(rame)34 b(is)g(a)g(sp)r(ecialised)g(form)g(of)h(F)-7
b(rame)34 b(whic)n(h)g(describ)r(es)g(celestial)g(longitude/latitude)
-227 3826 y(co)r(ordinate)f(systems.)56 b(The)34 b(particular)f
+227 5270 y(co)r(ordinate)f(systems.)56 b(The)34 b(particular)f
(celestial)g(co)r(ordinate)g(system)h(to)g(b)r(e)g(represen)n(ted)f(is)
-h(sp)r(eci\014ed)g(b)n(y)227 3926 y(setting)24 b(the)h(SkyF)-7
+h(sp)r(eci\014ed)g(b)n(y)227 5369 y(setting)24 b(the)h(SkyF)-7
b(rame's)23 b(System)h(attribute)g(\(curren)n(tly)-7
b(,)24 b(the)g(default)h(is)e(ICRS\))i(quali\014ed,)g(as)e(necessary)-7
-b(,)23 b(b)n(y)227 4026 y(a)k(mean)h(Equino)n(x)e(v)-5
-b(alue)28 b(and/or)e(an)h(Ep)r(o)r(c)n(h.)227 4148 y(F)-7
+b(,)23 b(b)n(y)227 5469 y(a)k(mean)h(Equino)n(x)e(v)-5
+b(alue)28 b(and/or)e(an)h(Ep)r(o)r(c)n(h.)227 5593 y(F)-7
b(or)34 b(eac)n(h)g(of)g(the)h(supp)r(orted)g(celestial)f(co)r
(ordinate)f(systems,)j(a)e(SkyF)-7 b(rame)34 b(can)g(apply)g(an)g
-(optional)g(shift)227 4248 y(of)c(origin)f(to)h(create)f(a)g(co)r
+(optional)g(shift)227 5693 y(of)c(origin)f(to)h(create)f(a)g(co)r
(ordinate)g(system)h(represen)n(ting)e(o\013sets)i(within)g(the)h
-(celestial)e(co)r(ordinate)g(system)227 4347 y(from)k(some)f(sp)r
-(eci\014ed)i(reference)e(p)r(oin)n(t.)53 b(This)33 b(o\013set)g(co)r
-(ordinate)f(system)g(can)h(also)f(b)r(e)h(rotated)f(to)h(de\014ne)227
-4447 y(new)28 b(longitude)f(and)h(latitude)g(axes.)36
-b(See)27 b(attributes)h(SkyRef,)g(SkyRefIs,)f(SkyRefP)h(and)f
-(AlignO\013set.)227 4569 y(All)34 b(the)f(co)r(ordinate)f(v)-5
+(celestial)e(co)r(ordinate)g(system)p eop end
+%%Page: 551 561
+TeXDict begin 551 560 bop 3643 52 a FG(551)227 351 y
+Fj(from)33 b(some)f(sp)r(eci\014ed)i(reference)e(p)r(oin)n(t.)53
+b(This)33 b(o\013set)g(co)r(ordinate)f(system)g(can)h(also)f(b)r(e)h
+(rotated)f(to)h(de\014ne)227 451 y(new)28 b(longitude)f(and)h(latitude)
+g(axes.)36 b(See)27 b(attributes)h(SkyRef,)g(SkyRefIs,)f(SkyRefP)h(and)
+f(AlignO\013set.)227 578 y(All)34 b(the)f(co)r(ordinate)f(v)-5
b(alues)33 b(used)g(b)n(y)g(a)g(SkyF)-7 b(rame)32 b(are)h(in)g
(radians.)52 b(These)33 b(ma)n(y)g(b)r(e)g(formatted)g(in)g(more)227
-4669 y(con)n(v)n(en)n(tional)26 b(w)n(a)n(ys)g(for)h(displa)n(y)g(b)n
-(y)g(using)g(AST)p Ft(_)p Fj(F)n(ORMA)-7 b(T.)0 4814
-y Fc(Constructor)32 b(F)-8 b(unction:)227 4914 y Fj(AST)p
-Ft(_)p Fj(SKYFRAME)-2 5059 y Fc(Inheritance)n(:)227 5205
-y Fj(The)28 b(SkyF)-7 b(rame)27 b(class)f(inherits)i(from)f(the)h(F)-7
-b(rame)27 b(class.)-2 5350 y Fc(A)m(ttributes)n(:)227
-5496 y Fj(In)40 b(addition)f(to)h(those)f(attributes)h(common)f(to)g
-(all)g(F)-7 b(rames,)42 b(ev)n(ery)c(SkyF)-7 b(rame)39
-b(also)g(has)g(the)h(follo)n(wing)227 5596 y(attributes:)p
-eop end
-%%Page: 545 555
-TeXDict begin 545 554 bop 3643 52 a FG(545)340 351 y
-Fi(\017)45 b Fj(AlignO\013set:)37 b(Align)28 b(SkyF)-7
-b(rames)26 b(using)i(the)g(o\013set)f(co)r(ordinate)g(system?)340
-489 y Fi(\017)45 b Fj(AsTime\(axis\):)37 b(F)-7 b(ormat)27
-b(celestial)g(co)r(ordinates)f(as)h(times?)340 628 y
+677 y(con)n(v)n(en)n(tional)26 b(w)n(a)n(ys)g(for)h(displa)n(y)g(b)n(y)
+g(using)g(AST)p Ft(_)p Fj(F)n(ORMA)-7 b(T.)0 831 y Fc(Constructor)32
+b(F)-8 b(unction:)227 930 y Fj(AST)p Ft(_)p Fj(SKYFRAME)-2
+1084 y Fc(Inheritance)n(:)227 1230 y Fj(The)28 b(SkyF)-7
+b(rame)27 b(class)f(inherits)i(from)f(the)h(F)-7 b(rame)27
+b(class.)-2 1384 y Fc(A)m(ttributes)n(:)227 1530 y Fj(In)40
+b(addition)f(to)h(those)f(attributes)h(common)f(to)g(all)g(F)-7
+b(rames,)42 b(ev)n(ery)c(SkyF)-7 b(rame)39 b(also)g(has)g(the)h(follo)n
+(wing)227 1630 y(attributes:)340 1897 y Fi(\017)45 b
+Fj(AlignO\013set:)37 b(Align)28 b(SkyF)-7 b(rames)26
+b(using)i(the)g(o\013set)f(co)r(ordinate)g(system?)340
+2032 y Fi(\017)45 b Fj(AsTime\(axis\):)37 b(F)-7 b(ormat)27
+b(celestial)g(co)r(ordinates)f(as)h(times?)340 2167 y
Fi(\017)45 b Fj(Equino)n(x:)36 b(Ep)r(o)r(c)n(h)27 b(of)h(the)g(mean)f
-(equino)n(x)340 766 y Fi(\017)45 b Fj(IsLatAxis:)37 b(Is)27
-b(the)h(sp)r(eci\014ed)g(axis)f(the)h(latitude)g(axis?)340
-904 y Fi(\017)45 b Fj(IsLonAxis:)36 b(Is)28 b(the)g(sp)r(eci\014ed)g
-(axis)e(the)i(longitude)g(axis?)340 1042 y Fi(\017)45
+(equino)n(x)340 2302 y Fi(\017)45 b Fj(IsLatAxis:)37
+b(Is)27 b(the)h(sp)r(eci\014ed)g(axis)f(the)h(latitude)g(axis?)340
+2437 y Fi(\017)45 b Fj(IsLonAxis:)36 b(Is)28 b(the)g(sp)r(eci\014ed)g
+(axis)e(the)i(longitude)g(axis?)340 2572 y Fi(\017)45
b Fj(LatAxis:)37 b(Index)27 b(of)h(the)g(latitude)g(axis)340
-1181 y Fi(\017)45 b Fj(LonAxis:)37 b(Index)27 b(of)h(the)g(longitude)f
-(axis)340 1319 y Fi(\017)45 b Fj(NegLon:)36 b(Displa)n(y)28
+2707 y Fi(\017)45 b Fj(LonAxis:)37 b(Index)27 b(of)h(the)g(longitude)f
+(axis)340 2842 y Fi(\017)45 b Fj(NegLon:)36 b(Displa)n(y)28
b(longitude)f(v)-5 b(alues)27 b(in)h(the)g(range)e([-pi,pi]?)340
-1457 y Fi(\017)45 b Fj(Pro)5 b(jection:)36 b(Sky)27 b(pro)5
-b(jection)27 b(description.)340 1595 y Fi(\017)45 b Fj(SkyRef:)37
+2976 y Fi(\017)45 b Fj(Pro)5 b(jection:)36 b(Sky)27 b(pro)5
+b(jection)27 b(description.)340 3111 y Fi(\017)45 b Fj(SkyRef:)37
b(P)n(osition)27 b(de\014ning)g(lo)r(cation)g(of)h(the)g(o\013set)f(co)
-r(ordinate)g(system)340 1734 y Fi(\017)45 b Fj(SkyRefIs:)37
+r(ordinate)g(system)340 3246 y Fi(\017)45 b Fj(SkyRefIs:)37
b(Selects)28 b(the)g(nature)f(of)g(the)h(o\013set)g(co)r(ordinate)e
-(system)340 1872 y Fi(\017)45 b Fj(SkyRefP:)28 b(P)n(osition)e
+(system)340 3381 y Fi(\017)45 b Fj(SkyRefP:)28 b(P)n(osition)e
(de\014ning)h(orien)n(tation)g(of)g(the)h(o\013set)g(co)r(ordinate)e
-(system)-2 2045 y Fc(F)-8 b(unctions)n(:)227 2191 y Fj(In)30
+(system)-2 3547 y Fc(F)-8 b(unctions)n(:)227 3694 y Fj(In)30
b(addition)f(to)h(those)f(routines)g(applicable)g(to)g(all)g(F)-7
b(rames,)29 b(the)h(follo)n(wing)f(routines)g(ma)n(y)f(also)h(b)r(e)h
-(applied)227 2290 y(to)e(all)f(SkyF)-7 b(rames:)340 2567
+(applied)227 3793 y(to)e(all)f(SkyF)-7 b(rames:)340 4060
y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(SKYOFFSETMAP:)27 b(Obtain)h(a)f
(Mapping)g(from)g(absolute)g(to)h(o\013set)f(co)r(ordinates)p
-0 2777 3780 12 v 0 2909 a FA(SlaMap)328 b Fd(Sequence)39
+0 4264 3780 12 v 0 4396 a FA(SlaMap)328 b Fd(Sequence)39
b(of)g(celestial)e(co)s(ordinate)f(con)m(v)m(ersions)326
-b FA(SlaMap)0 3109 y Fc(Description:)44 b Fj(An)32 b(SlaMap)e(is)h(a)g
+b FA(SlaMap)0 4589 y Fc(Description:)44 b Fj(An)32 b(SlaMap)e(is)h(a)g
(sp)r(ecialised)f(form)h(of)g(Mapping)f(whic)n(h)h(can)g(b)r(e)g(used)g
-(to)g(represen)n(t)f(a)g(sequence)227 3208 y(of)e(con)n(v)n(ersions)d
+(to)g(represen)n(t)f(a)g(sequence)227 4688 y(of)e(con)n(v)n(ersions)d
(b)r(et)n(w)n(een)i(standard)g(celestial)g(\(longitude,)h(latitude\))g
-(co)r(ordinate)f(systems.)227 3338 y(When)d(an)e(SlaMap)h(is)g(\014rst)
+(co)r(ordinate)f(systems.)227 4815 y(When)d(an)e(SlaMap)h(is)g(\014rst)
f(created,)h(it)h(simply)f(p)r(erforms)f(a)g(unit)i(\(n)n(ull\))f
-(Mapping)g(on)f(a)h(pair)f(of)h(co)r(ordinates.)227 3438
+(Mapping)g(on)f(a)h(pair)f(of)h(co)r(ordinates.)227 4915
y(Using)39 b(the)g(AST)p Ft(_)p Fj(SLAADD)h(routine,)h(a)e(series)f(of)
g(co)r(ordinate)g(con)n(v)n(ersion)e(steps)j(ma)n(y)f(then)h(b)r(e)h
-(added,)227 3538 y(selected)34 b(from)f(those)h(pro)n(vided)e(b)n(y)i
+(added,)227 5014 y(selected)34 b(from)f(those)h(pro)n(vided)e(b)n(y)i
(the)g(SLALIB)g(P)n(ositional)e(Astronom)n(y)g(Library)h(\(Starlink)g
-(User)h(Note)227 3637 y(SUN/67\).)44 b(This)30 b(allo)n(ws)e(m)n
+(User)h(Note)227 5114 y(SUN/67\).)44 b(This)30 b(allo)n(ws)e(m)n
(ulti-step)i(con)n(v)n(ersions)e(b)r(et)n(w)n(een)i(a)f(v)-5
b(ariet)n(y)29 b(of)h(celestial)g(co)r(ordinate)e(systems)i(to)227
-3737 y(b)r(e)e(assem)n(bled)f(out)h(of)f(the)h(building)g(blo)r(c)n(ks)
-f(pro)n(vided)f(b)n(y)i(SLALIB.)227 3867 y(F)-7 b(or)18
+5213 y(b)r(e)e(assem)n(bled)f(out)h(of)f(the)h(building)g(blo)r(c)n(ks)
+f(pro)n(vided)f(b)n(y)i(SLALIB.)227 5340 y(F)-7 b(or)18
b(details)g(of)g(the)h(individual)g(co)r(ordinate)e(con)n(v)n(ersions)f
(a)n(v)-5 b(ailable,)19 b(see)f(the)h(description)e(of)i(the)f(AST)p
-Ft(_)p Fj(SLAADD)227 3966 y(routine.)0 4127 y Fc(Constructor)32
-b(F)-8 b(unction:)227 4226 y Fj(AST)p Ft(_)p Fj(SLAMAP)28
-b(\(also)f(see)g(AST)p Ft(_)p Fj(SLAADD\))-2 4386 y Fc(Inheritance)n(:)
-227 4533 y Fj(The)h(SlaMap)f(class)g(inherits)g(from)g(the)h(Mapping)g
-(class.)-2 4693 y Fc(A)m(ttributes)n(:)227 4839 y Fj(The)37
+Ft(_)p Fj(SLAADD)227 5440 y(routine.)0 5593 y Fc(Constructor)32
+b(F)-8 b(unction:)227 5693 y Fj(AST)p Ft(_)p Fj(SLAMAP)28
+b(\(also)f(see)g(AST)p Ft(_)p Fj(SLAADD\))p eop end
+%%Page: 552 562
+TeXDict begin 552 561 bop 0 52 a FG(552)2251 b Fz(D)91
+b(AST)30 b(CLASS)f(DESCRIPTIONS)-2 351 y Fc(Inheritance)n(:)227
+497 y Fj(The)f(SlaMap)f(class)g(inherits)g(from)g(the)h(Mapping)g
+(class.)-2 641 y Fc(A)m(ttributes)n(:)227 787 y Fj(The)37
b(SlaMap)f(class)g(do)r(es)g(not)h(de\014ne)g(an)n(y)f(new)h
(attributes)f(b)r(ey)n(ond)h(those)f(whic)n(h)h(are)e(applicable)h(to)h
-(all)227 4939 y(Mappings.)-2 5099 y Fc(F)-8 b(unctions)n(:)227
-5245 y Fj(In)26 b(addition)f(to)h(those)f(routines)g(applicable)f(to)i
+(all)227 887 y(Mappings.)-2 1031 y Fc(F)-8 b(unctions)n(:)227
+1177 y Fj(In)26 b(addition)f(to)h(those)f(routines)g(applicable)f(to)i
(all)f(Mappings,)g(the)h(follo)n(wing)f(routine)g(ma)n(y)f(also)h(b)r
-(e)h(applied)227 5345 y(to)i(all)f(SlaMaps:)340 5622
+(e)h(applied)227 1277 y(to)i(all)f(SlaMaps:)340 1529
y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(SLAADD:)29 b(Add)g(a)e(celestial)g
(co)r(ordinate)f(con)n(v)n(ersion)f(to)j(an)f(SlaMap)p
-eop end
-%%Page: 546 556
-TeXDict begin 546 555 bop 0 52 a FG(546)2251 b Fz(D)91
-b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 483
-a FA(Sp)t(ecFluxF)-11 b(rame)1228 490 y Fd(Comp)s(ound)37
-b(sp)s(ectrum/\015ux)1730 609 y(F)-10 b(rame)2871 483
-y FA(Sp)t(ecFluxF)f(rame)0 773 y Fc(Description:)44 b
-Fj(A)35 b(Sp)r(ecFluxF)-7 b(rame)35 b(com)n(bines)f(a)g(Sp)r(ecF)-7
-b(rame)34 b(and)g(a)g(FluxF)-7 b(rame)35 b(in)n(to)f(a)g(single)g
-(2-dimensional)227 872 y(comp)r(ound)24 b(F)-7 b(rame.)34
-b(Suc)n(h)24 b(a)f(F)-7 b(rame)22 b(can)h(for)g(instance)g(b)r(e)h
-(used)f(to)g(describ)r(e)g(a)g(Plot)g(of)g(a)g(sp)r(ectrum)g(in)h(whic)
-n(h)227 972 y(the)k(\014rst)g(axis)e(represen)n(ts)h(sp)r(ectral)g(p)r
+0 1718 3780 12 v 0 1850 a FA(Sp)t(ecFluxF)-11 b(rame)1228
+1856 y Fd(Comp)s(ound)37 b(sp)s(ectrum/\015ux)1730 1976
+y(F)-10 b(rame)2871 1850 y FA(Sp)t(ecFluxF)f(rame)0 2131
+y Fc(Description:)44 b Fj(A)35 b(Sp)r(ecFluxF)-7 b(rame)35
+b(com)n(bines)f(a)g(Sp)r(ecF)-7 b(rame)34 b(and)g(a)g(FluxF)-7
+b(rame)35 b(in)n(to)f(a)g(single)g(2-dimensional)227
+2230 y(comp)r(ound)24 b(F)-7 b(rame.)34 b(Suc)n(h)24
+b(a)f(F)-7 b(rame)22 b(can)h(for)g(instance)g(b)r(e)h(used)f(to)g
+(describ)r(e)g(a)g(Plot)g(of)g(a)g(sp)r(ectrum)g(in)h(whic)n(h)227
+2330 y(the)k(\014rst)g(axis)e(represen)n(ts)h(sp)r(ectral)g(p)r
(osition)g(and)g(the)h(second)f(axis)g(represen)n(ts)f(\015ux.)0
-1120 y Fc(Constructor)32 b(F)-8 b(unction:)227 1220 y
-Fj(AST)p Ft(_)p Fj(SPECFLUXFRAME)-2 1368 y Fc(Inheritance)n(:)227
-1514 y Fj(The)28 b(Sp)r(ecFluxF)-7 b(rame)28 b(class)e(inherits)i(from)
-f(the)h(CmpF)-7 b(rame)27 b(class.)-2 1663 y Fc(A)m(ttributes)n(:)227
-1809 y Fj(The)e(Sp)r(ecFluxF)-7 b(rame)25 b(class)f(do)r(es)h(not)g
+2474 y Fc(Constructor)32 b(F)-8 b(unction:)227 2574 y
+Fj(AST)p Ft(_)p Fj(SPECFLUXFRAME)-2 2718 y Fc(Inheritance)n(:)227
+2864 y Fj(The)28 b(Sp)r(ecFluxF)-7 b(rame)28 b(class)e(inherits)i(from)
+f(the)h(CmpF)-7 b(rame)27 b(class.)-2 3008 y Fc(A)m(ttributes)n(:)227
+3154 y Fj(The)e(Sp)r(ecFluxF)-7 b(rame)25 b(class)f(do)r(es)h(not)g
(de\014ne)g(an)n(y)f(new)h(attributes)g(b)r(ey)n(ond)g(those)f(whic)n
-(h)h(are)f(applicable)h(to)227 1909 y(all)i(CmpF)-7 b(rames.)36
+(h)h(are)f(applicable)h(to)227 3253 y(all)i(CmpF)-7 b(rames.)36
b(Ho)n(w)n(ev)n(er,)24 b(the)j(attributes)g(of)f(the)h(comp)r(onen)n(t)
g(F)-7 b(rames)25 b(can)i(b)r(e)f(accessed)g(as)g(if)h(they)g(w)n(ere)
-227 2008 y(attributes)d(of)f(the)h(Sp)r(ecFluxF)-7 b(rame.)36
+227 3353 y(attributes)d(of)f(the)h(Sp)r(ecFluxF)-7 b(rame.)36
b(F)-7 b(or)23 b(instance,)h(the)g(Sp)r(ecFluxF)-7 b(rame)23
b(will)h(recognise)e(the)i Ft(")p Fj(StdOfRest)p Ft(")227
-2108 y Fj(attribute)k(and)g(forw)n(ard)e(access)g(requests)h(to)g(the)h
+3453 y Fj(attribute)k(and)g(forw)n(ard)e(access)g(requests)h(to)g(the)h
(comp)r(onen)n(t)g(Sp)r(ecF)-7 b(rame.)36 b(An)29 b(axis)d(index)i(can)
-f(optionally)227 2207 y(b)r(e)32 b(app)r(ended)f(to)g(the)h(end)f(of)g
+f(optionally)227 3552 y(b)r(e)32 b(app)r(ended)f(to)g(the)h(end)f(of)g
(an)n(y)f(attribute)i(name,)f(in)h(whic)n(h)f(case)f(the)i(request)e
-(to)h(access)f(the)h(attribute)227 2307 y(will)d(b)r(e)g(forw)n(arded)e
+(to)h(access)f(the)h(attribute)227 3652 y(will)d(b)r(e)g(forw)n(arded)e
(to)h(the)h(primary)f(F)-7 b(rame)27 b(de\014ning)h(the)g(sp)r
-(eci\014ed)f(axis.)-2 2455 y Fc(F)-8 b(unctions)n(:)227
-2601 y Fj(The)30 b(Sp)r(ecFluxF)-7 b(rame)30 b(class)e(do)r(es)h(not)h
+(eci\014ed)f(axis.)-2 3796 y Fc(F)-8 b(unctions)n(:)227
+3942 y Fj(The)30 b(Sp)r(ecFluxF)-7 b(rame)30 b(class)e(do)r(es)h(not)h
(de\014ne)g(an)n(y)f(new)g(routines)g(b)r(ey)n(ond)g(those)h(whic)n(h)f
-(are)g(applicable)g(to)227 2701 y(all)f(CmpF)-7 b(rames.)p
-0 2898 V 0 3029 a FA(Sp)t(ecF)c(rame)899 3030 y Fd(Sp)s(ectral)37
-b(co)s(ordinate)g(system)h(description)3138 3029 y FA(Sp)t(ecF)-11
-b(rame)0 3216 y Fc(Description:)44 b Fj(A)38 b(Sp)r(ecF)-7
+(are)g(applicable)g(to)227 4042 y(all)f(CmpF)-7 b(rames.)p
+0 4230 V 0 4361 a FA(Sp)t(ecF)c(rame)899 4362 y Fd(Sp)s(ectral)37
+b(co)s(ordinate)g(system)h(description)3138 4361 y FA(Sp)t(ecF)-11
+b(rame)0 4539 y Fc(Description:)44 b Fj(A)38 b(Sp)r(ecF)-7
b(rame)38 b(is)g(a)f(sp)r(ecialised)g(form)h(of)f(one-dimensional)g(F)
-7 b(rame)37 b(whic)n(h)h(represen)n(ts)e(v)-5 b(arious)227
-3316 y(co)r(ordinate)22 b(systems)h(used)h(to)f(describ)r(e)g(p)r
+4639 y(co)r(ordinate)22 b(systems)h(used)h(to)f(describ)r(e)g(p)r
(ositions)g(within)h(an)f(electro-magnetic)f(sp)r(ectrum.)35
-b(The)24 b(particular)227 3416 y(co)r(ordinate)h(system)g(to)g(b)r(e)h
+b(The)24 b(particular)227 4739 y(co)r(ordinate)h(system)g(to)g(b)r(e)h
(used)f(is)h(sp)r(eci\014ed)f(b)n(y)h(setting)f(the)h(Sp)r(ecF)-7
b(rame's)25 b(System)g(attribute)h(\(the)g(default)227
-3515 y(is)i(w)n(a)n(v)n(elength\))e(quali\014ed,)h(as)g(necessary)-7
+4838 y(is)i(w)n(a)n(v)n(elength\))e(quali\014ed,)h(as)g(necessary)-7
b(,)26 b(b)n(y)i(other)f(attributes)g(suc)n(h)g(as)g(the)h(rest)f
-(frequency)-7 b(,)28 b(the)g(standard)227 3615 y(of)c(rest,)g(the)g(ep)
+(frequency)-7 b(,)28 b(the)g(standard)227 4938 y(of)c(rest,)g(the)g(ep)
r(o)r(c)n(h)f(of)h(observ)-5 b(ation,)23 b(units,)i(etc)f(\(see)f(the)h
(description)f(of)h(the)g(System)g(attribute)f(for)g(details\).)227
-3739 y(By)h(setting)f(a)h(v)-5 b(alue)23 b(for)h(thr)f(Sp)r(ecOrigin)h
+5060 y(By)h(setting)f(a)h(v)-5 b(alue)23 b(for)h(thr)f(Sp)r(ecOrigin)h
(attribute,)g(a)g(Sp)r(ecF)-7 b(rame)23 b(can)h(b)r(e)g(made)f(to)h
-(represen)n(t)e(o\013sets)i(from)227 3839 y(a)j(giv)n(en)g(sp)r(ectral)
+(represen)n(t)e(o\013sets)i(from)227 5159 y(a)j(giv)n(en)g(sp)r(ectral)
g(p)r(osition,)h(rather)e(than)i(absolute)f(sp)r(ectral)g(v)-5
-b(alues.)0 3987 y Fc(Constructor)32 b(F)-8 b(unction:)227
-4087 y Fj(AST)p Ft(_)p Fj(SPECFRAME)-2 4235 y Fc(Inheritance)n(:)227
-4381 y Fj(The)28 b(Sp)r(ecF)-7 b(rame)27 b(class)g(inherits)g(from)h
-(the)g(F)-7 b(rame)27 b(class.)-2 4529 y Fc(A)m(ttributes)n(:)227
-4675 y Fj(In)38 b(addition)f(to)g(those)f(attributes)h(common)g(to)g
-(all)g(F)-7 b(rames,)39 b(ev)n(ery)d(Sp)r(ecF)-7 b(rame)37
-b(also)f(has)g(the)i(follo)n(wing)227 4775 y(attributes:)340
-5034 y Fi(\017)45 b Fj(AlignSp)r(ecO\013set:)38 b(Align)27
+b(alues.)0 5303 y Fc(Constructor)32 b(F)-8 b(unction:)227
+5403 y Fj(AST)p Ft(_)p Fj(SPECFRAME)-2 5547 y Fc(Inheritance)n(:)227
+5693 y Fj(The)28 b(Sp)r(ecF)-7 b(rame)27 b(class)g(inherits)g(from)h
+(the)g(F)-7 b(rame)27 b(class.)p eop end
+%%Page: 553 563
+TeXDict begin 553 562 bop 3643 52 a FG(553)-2 351 y Fc(A)m(ttributes)n
+(:)227 497 y Fj(In)38 b(addition)f(to)g(those)f(attributes)h(common)g
+(to)g(all)g(F)-7 b(rames,)39 b(ev)n(ery)d(Sp)r(ecF)-7
+b(rame)37 b(also)f(has)g(the)i(follo)n(wing)227 597 y(attributes:)340
+855 y Fi(\017)45 b Fj(AlignSp)r(ecO\013set:)38 b(Align)27
b(Sp)r(ecF)-7 b(rames)27 b(using)h(the)g(o\013set)f(co)r(ordinate)g
-(system?)340 5166 y Fi(\017)45 b Fj(AlignStdOfRest:)38
+(system?)340 985 y Fi(\017)45 b Fj(AlignStdOfRest:)38
b(Standard)27 b(of)g(rest)g(in)h(whic)n(h)g(to)f(align)g(Sp)r(ecF)-7
-b(rames)340 5298 y Fi(\017)45 b Fj(RefDec:)38 b(Declination)27
-b(of)h(the)g(source)e(\(FK5)i(J2000\))340 5430 y Fi(\017)45
+b(rames)340 1116 y Fi(\017)45 b Fj(RefDec:)38 b(Declination)27
+b(of)h(the)g(source)e(\(FK5)i(J2000\))340 1246 y Fi(\017)45
b Fj(RefRA:)29 b(Righ)n(t)e(ascension)g(of)g(the)h(source)e(\(FK5)i
-(J2000\))340 5561 y Fi(\017)45 b Fj(RestF)-7 b(req:)37
-b(Rest)28 b(frequency)340 5693 y Fi(\017)45 b Fj(SourceSys:)36
-b(Source)27 b(v)n(elo)r(cit)n(y)f(sp)r(ectral)h(system)p
-eop end
-%%Page: 547 557
-TeXDict begin 547 556 bop 3643 52 a FG(547)340 351 y
-Fi(\017)45 b Fj(SourceV)-7 b(el:)37 b(Source)26 b(v)n(elo)r(cit)n(y)340
-476 y Fi(\017)45 b Fj(SourceVRF:)28 b(Source)e(v)n(elo)r(cit)n(y)h
-(rest)g(frame)340 601 y Fi(\017)45 b Fj(Sp)r(ecOrigin:)36
-b(The)28 b(zero)f(p)r(oin)n(t)g(for)g(Sp)r(ecF)-7 b(rame)28
-b(axis)f(v)-5 b(alues)340 726 y Fi(\017)45 b Fj(StdOfRest:)38
-b(Standard)27 b(of)g(rest)227 879 y(Sev)n(eral)35 b(of)h(the)g(F)-7
-b(rame)35 b(attributes)h(inherited)g(b)n(y)g(the)g(Sp)r(ecF)-7
-b(rame)36 b(class)f(refer)g(to)h(a)f(sp)r(eci\014c)h(axis)f(of)h(the)
-227 979 y(F)-7 b(rame)25 b(\(for)g(instance)f(Unit\(axis\),)j(Lab)r
-(el\(axis\),)e(etc\).)36 b(Since)26 b(a)e(Sp)r(ecF)-7
-b(rame)25 b(is)g(strictly)g(one-dimensional,)f(it)227
-1079 y(allo)n(ws)i(these)h(attributes)h(to)f(b)r(e)h(sp)r(eci\014ed)f
-(without)h(an)f(axis)f(index.)37 b(So)27 b(for)g(instance,)g
-Ft(")p Fj(Unit)p Ft(")g Fj(is)g(allo)n(w)n(ed)f(in)227
-1178 y(place)h(of)h Ft(")p Fj(Unit\(1\))p Ft(")p Fj(.)-2
-1320 y Fc(F)-8 b(unctions)n(:)227 1466 y Fj(In)30 b(addition)f(to)h
-(those)f(routines)g(applicable)g(to)g(all)g(F)-7 b(rames,)29
-b(the)h(follo)n(wing)f(routines)g(ma)n(y)f(also)h(b)r(e)h(applied)227
-1565 y(to)e(all)f(Sp)r(ecF)-7 b(rames:)340 1814 y Fi(\017)45
-b Fj(AST)p Ft(_)p Fj(SETREFPOS:)27 b(Set)h(reference)e(p)r(osition)i
-(in)f(an)n(y)g(celestial)g(system)340 1939 y Fi(\017)45
-b Fj(AST)p Ft(_)p Fj(GETREFPOS:)27 b(Get)h(reference)e(p)r(osition)i
-(in)g(an)n(y)e(celestial)h(system)p 0 2122 3780 12 v
-0 2253 a FA(Sp)t(ecMap)775 2254 y Fd(Sequence)39 b(of)f(sp)s(ectral)g
-(co)s(ordinate)f(con)m(v)m(ersions)3238 2253 y FA(Sp)t(ecMap)0
-2427 y Fc(Description:)44 b Fj(A)31 b(Sp)r(ecMap)f(is)g(a)g(sp)r
-(ecialised)g(form)g(of)g(Mapping)g(whic)n(h)g(can)g(b)r(e)g(used)g(to)g
-(represen)n(t)f(a)h(sequence)227 2526 y(of)e(con)n(v)n(ersions)d(b)r
-(et)n(w)n(een)i(standard)g(sp)r(ectral)g(co)r(ordinate)f(systems.)227
-2647 y(When)19 b(an)f(Sp)r(ecMap)h(is)f(\014rst)g(created,)i(it)e
-(simply)h(p)r(erforms)f(a)g(unit)h(\(n)n(ull\))g(Mapping.)33
-b(Using)18 b(the)h(AST)p Ft(_)p Fj(SPECADD)227 2747 y(routine,)35
+(J2000\))340 1377 y Fi(\017)45 b Fj(RestF)-7 b(req:)37
+b(Rest)28 b(frequency)340 1508 y Fi(\017)45 b Fj(SourceSys:)36
+b(Source)27 b(v)n(elo)r(cit)n(y)f(sp)r(ectral)h(system)340
+1638 y Fi(\017)45 b Fj(SourceV)-7 b(el:)37 b(Source)26
+b(v)n(elo)r(cit)n(y)340 1769 y Fi(\017)45 b Fj(SourceVRF:)28
+b(Source)e(v)n(elo)r(cit)n(y)h(rest)g(frame)340 1900
+y Fi(\017)45 b Fj(Sp)r(ecOrigin:)36 b(The)28 b(zero)f(p)r(oin)n(t)g
+(for)g(Sp)r(ecF)-7 b(rame)28 b(axis)f(v)-5 b(alues)340
+2030 y Fi(\017)45 b Fj(StdOfRest:)38 b(Standard)27 b(of)g(rest)227
+2190 y(Sev)n(eral)35 b(of)h(the)g(F)-7 b(rame)35 b(attributes)h
+(inherited)g(b)n(y)g(the)g(Sp)r(ecF)-7 b(rame)36 b(class)f(refer)g(to)h
+(a)f(sp)r(eci\014c)h(axis)f(of)h(the)227 2289 y(F)-7
+b(rame)25 b(\(for)g(instance)f(Unit\(axis\),)j(Lab)r(el\(axis\),)e
+(etc\).)36 b(Since)26 b(a)e(Sp)r(ecF)-7 b(rame)25 b(is)g(strictly)g
+(one-dimensional,)f(it)227 2389 y(allo)n(ws)i(these)h(attributes)h(to)f
+(b)r(e)h(sp)r(eci\014ed)f(without)h(an)f(axis)f(index.)37
+b(So)27 b(for)g(instance,)g Ft(")p Fj(Unit)p Ft(")g Fj(is)g(allo)n(w)n
+(ed)f(in)227 2489 y(place)h(of)h Ft(")p Fj(Unit\(1\))p
+Ft(")p Fj(.)-2 2636 y Fc(F)-8 b(unctions)n(:)227 2782
+y Fj(In)30 b(addition)f(to)h(those)f(routines)g(applicable)g(to)g(all)g
+(F)-7 b(rames,)29 b(the)h(follo)n(wing)f(routines)g(ma)n(y)f(also)h(b)r
+(e)h(applied)227 2882 y(to)e(all)f(Sp)r(ecF)-7 b(rames:)340
+3139 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(SETREFPOS:)27
+b(Set)h(reference)e(p)r(osition)i(in)f(an)n(y)g(celestial)g(system)340
+3270 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GETREFPOS:)27
+b(Get)h(reference)e(p)r(osition)i(in)g(an)n(y)e(celestial)h(system)p
+0 3465 3780 12 v 0 3595 a FA(Sp)t(ecMap)775 3596 y Fd(Sequence)39
+b(of)f(sp)s(ectral)g(co)s(ordinate)f(con)m(v)m(ersions)3238
+3595 y FA(Sp)t(ecMap)0 3781 y Fc(Description:)44 b Fj(A)31
+b(Sp)r(ecMap)f(is)g(a)g(sp)r(ecialised)g(form)g(of)g(Mapping)g(whic)n
+(h)g(can)g(b)r(e)g(used)g(to)g(represen)n(t)f(a)h(sequence)227
+3880 y(of)e(con)n(v)n(ersions)d(b)r(et)n(w)n(een)i(standard)g(sp)r
+(ectral)g(co)r(ordinate)f(systems.)227 4004 y(When)19
+b(an)f(Sp)r(ecMap)h(is)f(\014rst)g(created,)i(it)e(simply)h(p)r
+(erforms)f(a)g(unit)h(\(n)n(ull\))g(Mapping.)33 b(Using)18
+b(the)h(AST)p Ft(_)p Fj(SPECADD)227 4103 y(routine,)35
b(a)e(series)f(of)h(co)r(ordinate)f(con)n(v)n(ersion)f(steps)i(ma)n(y)g
(then)h(b)r(e)g(added.)54 b(This)33 b(allo)n(ws)f(m)n(ulti-step)h(con-)
-227 2846 y(v)n(ersions)27 b(b)r(et)n(w)n(een)h(a)g(v)-5
+227 4203 y(v)n(ersions)27 b(b)r(et)n(w)n(een)h(a)g(v)-5
b(ariet)n(y)28 b(of)g(sp)r(ectral)g(co)r(ordinate)g(systems)g(to)g(b)r
(e)h(assem)n(bled)e(out)i(of)f(a)g(set)h(of)f(building)227
-2946 y(blo)r(c)n(ks.)227 3066 y(Con)n(v)n(ersions)f(are)g(a)n(v)-5
+4303 y(blo)r(c)n(ks.)227 4426 y(Con)n(v)n(ersions)f(are)g(a)n(v)-5
b(ailable)28 b(to)h(transform)e(b)r(et)n(w)n(een)i(standards)f(of)h
(rest.)40 b(Suc)n(h)29 b(con)n(v)n(ersions)d(need)j(to)f(kno)n(w)227
-3166 y(the)23 b(source)e(p)r(osition)i(as)e(an)i(RA)f(and)h(DEC.)f
+4526 y(the)23 b(source)e(p)r(osition)i(as)e(an)i(RA)f(and)h(DEC.)f
(This)h(information)e(can)i(b)r(e)f(supplied)h(in)g(the)g(form)f(of)g
-(parameters)227 3266 y(for)27 b(the)g(relev)-5 b(an)n(t)26
+(parameters)227 4625 y(for)27 b(the)g(relev)-5 b(an)n(t)26
b(con)n(v)n(ersions,)e(in)j(whic)n(h)g(case)f(the)h(Sp)r(ecMap)g(is)f
-(1-dimensional,)g(simply)h(transforming)e(the)227 3365
+(1-dimensional,)g(simply)h(transforming)e(the)227 4725
y(sp)r(ectral)c(axis)g(v)-5 b(alues.)35 b(This)21 b(means)g(that)h(the)
g(same)f(source)g(p)r(osition)g(will)h(alw)n(a)n(ys)e(b)r(e)i(used)f(b)
-n(y)g(the)h(Sp)r(ecMap.)227 3465 y(Ho)n(w)n(ev)n(er,)32
+n(y)g(the)h(Sp)r(ecMap.)227 4825 y(Ho)n(w)n(ev)n(er,)32
b(this)h(ma)n(y)f(not)g(b)r(e)h(appropriate)e(for)h(an)h(accurate)e
(description)h(of)g(a)h(3-D)f(sp)r(ectral)g(cub)r(e,)i(where)227
-3564 y(c)n(hanges)c(of)h(spatial)g(p)r(osition)g(can)g(pro)r(duce)f
+4924 y(c)n(hanges)c(of)h(spatial)g(p)r(osition)g(can)g(pro)r(duce)f
(signi\014can)n(t)h(c)n(hanges)f(in)h(the)h(Doppler)f(shift)g(in)n(tro)
-r(duced)g(when)227 3664 y(transforming)19 b(b)r(et)n(w)n(een)h
+r(duced)g(when)227 5024 y(transforming)19 b(b)r(et)n(w)n(een)h
(standards)e(of)i(rest.)34 b(F)-7 b(or)20 b(this)g(situation,)h(a)f
(3-dimensional)e(Sp)r(ecMap)i(can)g(b)r(e)g(created)227
-3764 y(in)30 b(whic)n(h)g(axes)e(2)h(and)h(3)f(corresp)r(ond)f(to)h
+5123 y(in)30 b(whic)n(h)g(axes)e(2)h(and)h(3)f(corresp)r(ond)f(to)h
(the)h(source)e(RA)i(and)g(DEC)f(The)h(Sp)r(ecMap)g(simply)f(copies)g
-(v)-5 b(alues)227 3863 y(for)24 b(axes)f(2)h(and)g(3)f(from)h(input)h
+(v)-5 b(alues)227 5223 y(for)24 b(axes)f(2)h(and)g(3)f(from)h(input)h
(to)f(output\),)i(but)e(mo)r(di\014es)h(axis)e(1)h(v)-5
b(alues)23 b(\(the)i(sp)r(ectral)f(axis\))f(appropriately)-7
-b(.)227 3984 y(F)g(or)18 b(details)g(of)g(the)h(individual)g(co)r
+b(.)227 5347 y(F)g(or)18 b(details)g(of)g(the)h(individual)g(co)r
(ordinate)e(con)n(v)n(ersions)f(a)n(v)-5 b(ailable,)19
b(see)f(the)h(description)e(of)i(the)f(AST)p Ft(_)p Fj(SPECADD)227
-4083 y(routine.)0 4225 y Fc(Constructor)32 b(F)-8 b(unction:)227
-4324 y Fj(AST)p Ft(_)p Fj(SPECMAP)27 b(\(also)g(see)g(AST)p
-Ft(_)p Fj(SPECADD\))-2 4466 y Fc(Inheritance)n(:)227
-4612 y Fj(The)h(Sp)r(ecMap)g(class)e(inherits)i(from)f(the)h(Mapping)f
-(class.)-2 4753 y Fc(A)m(ttributes)n(:)227 4899 y Fj(The)33
+5446 y(routine.)0 5593 y Fc(Constructor)32 b(F)-8 b(unction:)227
+5693 y Fj(AST)p Ft(_)p Fj(SPECMAP)27 b(\(also)g(see)g(AST)p
+Ft(_)p Fj(SPECADD\))p eop end
+%%Page: 554 564
+TeXDict begin 554 563 bop 0 52 a FG(554)2251 b Fz(D)91
+b(AST)30 b(CLASS)f(DESCRIPTIONS)-2 351 y Fc(Inheritance)n(:)227
+497 y Fj(The)f(Sp)r(ecMap)g(class)e(inherits)i(from)f(the)h(Mapping)f
+(class.)-2 658 y Fc(A)m(ttributes)n(:)227 804 y Fj(The)33
b(Sp)r(ecMap)g(class)f(do)r(es)h(not)f(de\014ne)i(an)n(y)e(new)g
(attributes)h(b)r(ey)n(ond)g(those)f(whic)n(h)h(are)f(applicable)g(to)h
-(all)227 4999 y(Mappings.)-2 5140 y Fc(F)-8 b(unctions)n(:)227
-5287 y Fj(In)26 b(addition)f(to)h(those)f(routines)g(applicable)f(to)i
+(all)227 903 y(Mappings.)-2 1064 y Fc(F)-8 b(unctions)n(:)227
+1210 y Fj(In)26 b(addition)f(to)h(those)f(routines)g(applicable)f(to)i
(all)f(Mappings,)g(the)h(follo)n(wing)f(routine)g(ma)n(y)f(also)h(b)r
-(e)h(applied)227 5386 y(to)i(all)f(Sp)r(ecMaps:)340 5635
+(e)h(applied)227 1309 y(to)i(all)f(Sp)r(ecMaps:)340 1587
y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(SPECADD:)28 b(Add)g(a)g(sp)r(ectral)f
(co)r(ordinate)f(con)n(v)n(ersion)f(to)j(an)f(Sp)r(ecMap)p
-eop end
-%%Page: 548 558
-TeXDict begin 548 557 bop 0 52 a FG(548)2251 b Fz(D)91
-b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 483
-a FA(SphMap)189 b Fd(Map)39 b(3-d)g(Cartesian)d(to)i(2-d)h(spherical)e
-(co)s(ordinates)189 b FA(SphMap)0 648 y Fc(Description:)44
-b Fj(A)33 b(SphMap)g(is)f(a)g(Mapping)g(whic)n(h)g(transforms)f(p)r
-(oin)n(ts)h(from)g(a)g(3-dimensional)f(Cartesian)g(co)r(or-)227
-748 y(dinate)f(system)g(in)n(to)g(a)f(2-dimensional)g(spherical)f(co)r
-(ordinate)h(system)h(\(longitude)g(and)g(latitude)g(on)f(a)h(unit)227
-847 y(sphere)e(cen)n(tred)f(at)h(the)g(origin\).)37 b(It)28
-b(w)n(orks)f(b)n(y)g(regarding)f(the)i(input)h(co)r(ordinates)d(as)i(p)
-r(osition)f(v)n(ectors)g(and)227 947 y(\014nding)38 b(their)f(in)n
-(tersection)g(with)h(the)g(sphere)f(surface.)66 b(The)38
-b(in)n(v)n(erse)e(transformation)g(alw)n(a)n(ys)f(pro)r(duces)227
-1047 y(p)r(oin)n(ts)28 b(whic)n(h)f(are)g(a)g(unit)h(distance)g(from)f
-(the)h(origin)e(\(i.e.)38 b(unit)28 b(v)n(ectors\).)0
-1184 y Fc(Constructor)k(F)-8 b(unction:)227 1284 y Fj(AST)p
-Ft(_)p Fj(SPHMAP)-2 1421 y Fc(Inheritance)n(:)227 1567
+0 1797 3780 12 v 0 1928 a FA(SphMap)189 b Fd(Map)39 b(3-d)g(Cartesian)d
+(to)i(2-d)h(spherical)e(co)s(ordinates)189 b FA(SphMap)0
+2128 y Fc(Description:)44 b Fj(A)33 b(SphMap)g(is)f(a)g(Mapping)g(whic)
+n(h)g(transforms)f(p)r(oin)n(ts)h(from)g(a)g(3-dimensional)f(Cartesian)
+g(co)r(or-)227 2228 y(dinate)f(system)g(in)n(to)g(a)f(2-dimensional)g
+(spherical)f(co)r(ordinate)h(system)h(\(longitude)g(and)g(latitude)g
+(on)f(a)h(unit)227 2327 y(sphere)e(cen)n(tred)f(at)h(the)g(origin\).)37
+b(It)28 b(w)n(orks)f(b)n(y)g(regarding)f(the)i(input)h(co)r(ordinates)d
+(as)i(p)r(osition)f(v)n(ectors)g(and)227 2427 y(\014nding)38
+b(their)f(in)n(tersection)g(with)h(the)g(sphere)f(surface.)66
+b(The)38 b(in)n(v)n(erse)e(transformation)g(alw)n(a)n(ys)f(pro)r(duces)
+227 2527 y(p)r(oin)n(ts)28 b(whic)n(h)f(are)g(a)g(unit)h(distance)g
+(from)f(the)h(origin)e(\(i.e.)38 b(unit)28 b(v)n(ectors\).)0
+2687 y Fc(Constructor)k(F)-8 b(unction:)227 2786 y Fj(AST)p
+Ft(_)p Fj(SPHMAP)-2 2947 y Fc(Inheritance)n(:)227 3093
y Fj(The)28 b(SphMap)g(class)e(inherits)i(from)f(the)h(Mapping)f
-(class.)-2 1705 y Fc(A)m(ttributes)n(:)227 1851 y Fj(In)38
+(class.)-2 3253 y Fc(A)m(ttributes)n(:)227 3399 y Fj(In)38
b(addition)f(to)g(those)g(attributes)g(common)f(to)h(all)g(Mappings,)i
(ev)n(ery)d(SphMap)h(also)f(has)h(the)h(follo)n(wing)227
-1951 y(attributes:)340 2194 y Fi(\017)45 b Fj(UnitRadius:)38
+3499 y(attributes:)340 3776 y Fi(\017)45 b Fj(UnitRadius:)38
b(SphMap)27 b(input)i(v)n(ectors)d(lie)i(on)f(a)g(unit)h(sphere?)340
-2315 y Fi(\017)45 b Fj(P)n(olarLong:)34 b(The)28 b(longitude)f(v)-5
-b(alue)28 b(to)f(assign)f(to)i(either)f(p)r(ole)-2 2465
-y Fc(F)-8 b(unctions)n(:)227 2611 y Fj(The)39 b(SphMap)h(class)e(do)r
+3914 y Fi(\017)45 b Fj(P)n(olarLong:)34 b(The)28 b(longitude)f(v)-5
+b(alue)28 b(to)f(assign)f(to)i(either)f(p)r(ole)-2 4087
+y Fc(F)-8 b(unctions)n(:)227 4233 y Fj(The)39 b(SphMap)h(class)e(do)r
(es)h(not)g(de\014ne)g(an)n(y)g(new)g(routines)f(b)r(ey)n(ond)h(those)g
-(whic)n(h)g(are)f(applicable)h(to)g(all)227 2710 y(Mappings.)p
-0 2886 V 0 3017 a FA(Stc)692 3018 y Fd(Represen)m(ts)g(an)f(instance)g
-(of)h(the)f(IV)m(O)m(A)h(STC)f(class)3593 3017 y FA(Stc)0
-3183 y Fc(Description:)44 b Fj(The)26 b(Stc)f(class)f(is)h(an)g
+(whic)n(h)g(are)f(applicable)h(to)g(all)227 4333 y(Mappings.)p
+0 4543 V 0 4674 a FA(Stc)692 4675 y Fd(Represen)m(ts)g(an)f(instance)g
+(of)h(the)f(IV)m(O)m(A)h(STC)f(class)3593 4674 y FA(Stc)0
+4874 y Fc(Description:)44 b Fj(The)26 b(Stc)f(class)f(is)h(an)g
(implemen)n(tation)g(of)g(the)h(IV)n(O)n(A)f(STC)g(class)f(whic)n(h)h
-(forms)g(part)f(of)i(the)f(IV)n(O)n(A)227 3282 y(Space-Time)i(Co)r
-(ordinate)g(Metadata)g(system.)36 b(See:)227 3401 y(h)n
+(forms)g(part)f(of)i(the)f(IV)n(O)n(A)227 4974 y(Space-Time)i(Co)r
+(ordinate)g(Metadata)g(system.)36 b(See:)227 5104 y(h)n
(ttp://hea-www.harv)-5 b(ard.edu/)p Fi(\030)p Fj(arots/n)n(v)n(ometa/)o
-(STC.h)n(tml)227 3520 y(The)36 b(Stc)g(class)e(do)r(es)i(not)f(ha)n(v)n
+(STC.h)n(tml)227 5234 y(The)36 b(Stc)g(class)e(do)r(es)i(not)f(ha)n(v)n
(e)g(a)g(constructor)f(function)i(of)f(its)h(o)n(wn,)h(as)e(it)h(is)g
-(simply)f(a)g(con)n(tainer)g(class)227 3619 y(for)25
+(simply)f(a)g(con)n(tainer)g(class)227 5333 y(for)25
b(a)f(family)i(of)f(sp)r(ecialised)f(sub-classes)g(including)h
(StcCatalogEn)n(tryLo)r(cation,)d(StcResourcePro\014le,)i(Stc-)227
-3719 y(Searc)n(hLo)r(cation)i(and)h(StcObsDataLo)r(cation.)0
-3856 y Fc(Constructor)32 b(F)-8 b(unction:)227 3956 y
-Fj(AST)p Ft(_)p Fj(STC)-2 4094 y Fc(Inheritance)n(:)227
-4240 y Fj(The)28 b(Stc)g(class)f(inherits)g(from)g(the)h(Region)f
-(class.)-2 4377 y Fc(A)m(ttributes)n(:)227 4523 y Fj(In)g(addition)g
-(to)f(those)h(attributes)f(common)h(to)f(all)h(Regions,)f(ev)n(ery)f
-(Stc)i(also)f(has)g(the)h(follo)n(wing)f(attributes:)340
-4766 y Fi(\017)45 b Fj(RegionClass:)35 b(The)28 b(class)f(name)g(of)h
-(the)g(encapsulated)f(Region.)-2 4916 y Fc(F)-8 b(unctions)n(:)227
-5063 y Fj(In)28 b(addition)g(to)g(those)g(routines)f(applicable)h(to)f
+5433 y(Searc)n(hLo)r(cation)i(and)h(StcObsDataLo)r(cation.)0
+5593 y Fc(Constructor)32 b(F)-8 b(unction:)227 5693 y
+Fj(AST)p Ft(_)p Fj(STC)p eop end
+%%Page: 555 565
+TeXDict begin 555 564 bop 3643 52 a FG(555)-2 351 y Fc(Inheritance)n(:)
+227 497 y Fj(The)28 b(Stc)g(class)f(inherits)g(from)g(the)h(Region)f
+(class.)-2 669 y Fc(A)m(ttributes)n(:)227 815 y Fj(In)g(addition)g(to)f
+(those)h(attributes)f(common)h(to)f(all)h(Regions,)f(ev)n(ery)f(Stc)i
+(also)f(has)g(the)h(follo)n(wing)f(attributes:)340 1109
+y Fi(\017)45 b Fj(RegionClass:)35 b(The)28 b(class)f(name)g(of)h(the)g
+(encapsulated)f(Region.)-2 1293 y Fc(F)-8 b(unctions)n(:)227
+1439 y Fj(In)28 b(addition)g(to)g(those)g(routines)f(applicable)h(to)f
(all)h(Regions,)f(the)i(follo)n(wing)e(routines)g(ma)n(y)g(also)g(b)r
-(e)i(applied)227 5162 y(to)f(all)f(Stc's:)340 5405 y
+(e)i(applied)227 1539 y(to)f(all)f(Stc's:)340 1833 y
Fi(\017)45 b Fj(AST)p Ft(_)p Fj(GETSTCREGION:)27 b(Get)h(a)f(p)r(oin)n
-(ter)h(to)f(the)h(encapsulated)f(Region)340 5526 y Fi(\017)45
+(ter)h(to)f(the)h(encapsulated)f(Region)340 1977 y Fi(\017)45
b Fj(AST)p Ft(_)p Fj(GETSTCCOORD:)27 b(Get)h(information)f(ab)r(out)h
-(an)f(AstroCo)r(ords)f(elemen)n(t)340 5647 y Fi(\017)45
+(an)f(AstroCo)r(ords)f(elemen)n(t)340 2120 y Fi(\017)45
b Fj(AST)p Ft(_)p Fj(GETSTCNCOORD:)28 b(Returns)f(the)h(n)n(um)n(b)r
(er)f(of)h(AstroCo)r(ords)e(elemen)n(ts)h(in)h(an)f(Stc)p
-eop end
-%%Page: 549 559
-TeXDict begin 549 558 bop 3643 52 a FG(549)p 0 351 3780
-12 v 0 483 a FA(StcCatalogEn)l(tryLo)t(cation)1637 500
-y Fd(Corresp)s(ond)1737 614 y(to)38 b(the)1739 714 y(IV)m(O)m(A)1659
-813 y(STCCat-)1694 913 y(alogEn-)1671 1026 y(tryLo)s(ca-)1789
-1137 y(tion)1772 1237 y(class)2295 483 y FA(StcCatalogEn)l(tryLo)t
-(cation)0 1400 y Fc(Description:)44 b Fj(The)29 b(StcCatalogEn)n(tryLo)
-r(cation)d(class)i(is)h(a)f(sub-class)g(of)h(Stc)g(used)g(to)g(describ)
-r(e)f(the)i(co)n(v)n(erage)c(of)227 1500 y(the)i(datasets)f(con)n
-(tained)g(in)h(some)f(V)n(O)g(resource.)227 1624 y(See)h(h)n
-(ttp://hea-www.harv)-5 b(ard.edu/)p Fi(\030)p Fj(arots/n)n(v)n(o)o
-(meta/STC.h)n(tml)0 1772 y Fc(Constructor)32 b(F)-8 b(unction:)227
-1872 y Fj(AST)p Ft(_)p Fj(STCCA)h(T)g(ALOGENTR)g(YLOCA)g(TION)-2
-2020 y Fc(Inheritance)n(:)227 2166 y Fj(The)28 b(StcCatalogEn)n(tryLo)r
+0 2342 3780 12 v 0 2473 a FA(StcCatalogEn)l(tryLo)t(cation)1637
+2490 y Fd(Corresp)s(ond)1737 2605 y(to)38 b(the)1739
+2704 y(IV)m(O)m(A)1659 2804 y(STCCat-)1694 2903 y(alogEn-)1671
+3017 y(tryLo)s(ca-)1789 3128 y(tion)1772 3227 y(class)2295
+2473 y FA(StcCatalogEn)l(tryLo)t(cation)0 3415 y Fc(Description:)44
+b Fj(The)29 b(StcCatalogEn)n(tryLo)r(cation)d(class)i(is)h(a)f
+(sub-class)g(of)h(Stc)g(used)g(to)g(describ)r(e)f(the)i(co)n(v)n(erage)
+c(of)227 3514 y(the)i(datasets)f(con)n(tained)g(in)h(some)f(V)n(O)g
+(resource.)227 3650 y(See)h(h)n(ttp://hea-www.harv)-5
+b(ard.edu/)p Fi(\030)p Fj(arots/n)n(v)n(o)o(meta/STC.h)n(tml)0
+3822 y Fc(Constructor)32 b(F)-8 b(unction:)227 3921 y
+Fj(AST)p Ft(_)p Fj(STCCA)h(T)g(ALOGENTR)g(YLOCA)g(TION)-2
+4093 y Fc(Inheritance)n(:)227 4239 y Fj(The)28 b(StcCatalogEn)n(tryLo)r
(cation)c(class)j(inherits)g(from)h(the)g(Stc)g(class.)-2
-2314 y Fc(A)m(ttributes)n(:)227 2460 y Fj(The)36 b(StcCatalogEn)n
+4410 y Fc(A)m(ttributes)n(:)227 4556 y Fj(The)36 b(StcCatalogEn)n
(tryLo)r(cation)c(class)j(do)r(es)h(not)f(de\014ne)h(an)n(y)f(new)h
(attributes)f(b)r(ey)n(ond)h(those)f(whic)n(h)h(are)227
-2560 y(applicable)27 b(to)h(all)f(Stcs.)-2 2708 y Fc(F)-8
-b(unctions)n(:)227 2854 y Fj(The)41 b(StcCatalogEn)n(tryLo)r(cation)d
+4656 y(applicable)27 b(to)h(all)f(Stcs.)-2 4827 y Fc(F)-8
+b(unctions)n(:)227 4974 y Fj(The)41 b(StcCatalogEn)n(tryLo)r(cation)d
(class)i(do)r(es)h(not)g(de\014ne)g(an)n(y)g(new)g(routines)f(b)r(ey)n
-(ond)h(those)g(whic)n(h)g(are)227 2954 y(applicable)27
-b(to)h(all)f(Stcs.)p 0 3151 V 0 3283 a FA(StcObsDataLo)t(cation)214
-b Fd(Corresp)s(ond)37 b(to)h(the)1739 3396 y(IV)m(O)m(A)1439
-3495 y(ObsDataLo)s(cation)1772 3595 y(class)2569 3283
-y FA(StcObsDataLo)t(cation)0 3758 y Fc(Description:)44
+(ond)h(those)g(whic)n(h)g(are)227 5073 y(applicable)27
+b(to)h(all)f(Stcs.)p 0 5294 V 0 5426 a FA(StcObsDataLo)t(cation)214
+b Fd(Corresp)s(ond)37 b(to)h(the)1739 5539 y(IV)m(O)m(A)1439
+5639 y(ObsDataLo)s(cation)1772 5739 y(class)2569 5426
+y FA(StcObsDataLo)t(cation)p eop end
+%%Page: 556 566
+TeXDict begin 556 565 bop 0 52 a FG(556)2251 b Fz(D)91
+b(AST)30 b(CLASS)f(DESCRIPTIONS)0 351 y Fc(Description:)44
b Fj(The)27 b(StcObsDataLo)r(cation)e(class)g(is)i(a)f(sub-class)f(of)h
(Stc)h(used)f(to)g(describ)r(e)g(the)h(co)r(ordinate)e(space)227
-3858 y(o)r(ccupied)j(b)n(y)f(a)g(particular)g(observ)-5
-b(ational)25 b(dataset.)227 3982 y(See)j(h)n(ttp://hea-www.harv)-5
+451 y(o)r(ccupied)j(b)n(y)f(a)g(particular)g(observ)-5
+b(ational)25 b(dataset.)227 587 y(See)j(h)n(ttp://hea-www.harv)-5
b(ard.edu/)p Fi(\030)p Fj(arots/n)n(v)n(o)o(meta/STC.h)n(tml)227
-4106 y(An)29 b(STC)f(ObsDataLo)r(cation)f(elemen)n(t)h(sp)r(eci\014es)g
+722 y(An)29 b(STC)f(ObsDataLo)r(cation)f(elemen)n(t)h(sp)r(eci\014es)g
(the)h(exten)n(t)f(of)g(the)g(observ)-5 b(ation)27 b(within)i(a)f(sp)r
-(eci\014ed)g(co)r(or-)227 4205 y(dinate)g(system,)f(and)h(also)e(sp)r
+(eci\014ed)g(co)r(or-)227 822 y(dinate)g(system,)f(and)h(also)e(sp)r
(eci\014es)i(the)g(observ)-5 b(atory)25 b(lo)r(cation)i(within)h(a)g
-(second)e(co)r(ordinate)h(system.)227 4329 y(The)i(AST)g(StcObsDataLo)r
+(second)e(co)r(ordinate)h(system.)227 958 y(The)i(AST)g(StcObsDataLo)r
(cation)f(class)g(inherits)g(from)h(Stc,)g(and)g(therefore)f(an)h
-(StcObsDataLo)r(cation)e(can)227 4429 y(b)r(e)f(used)g(directly)f(as)f
+(StcObsDataLo)r(cation)e(can)227 1057 y(b)r(e)f(used)g(directly)f(as)f
(an)i(Stc.)36 b(When)26 b(used)g(in)f(this)h(w)n(a)n(y)-7
b(,)25 b(the)h(StcObsDataLo)r(cation)e(describ)r(es)g(the)i(lo)r
-(cation)227 4529 y(of)i(the)g(observ)-5 b(ation)26 b(\(not)i(the)g
-(observ)-5 b(atory\).)227 4653 y(Ev)n(en)n(tually)e(,)27
+(cation)227 1157 y(of)i(the)g(observ)-5 b(ation)26 b(\(not)i(the)g
+(observ)-5 b(atory\).)227 1293 y(Ev)n(en)n(tually)e(,)27
b(this)g(class)g(will)h(ha)n(v)n(e)e(a)h(metho)r(d)h(for)f(returning)g
(an)g(Stc)h(describing)e(the)i(observ)-5 b(atory)25 b(lo)r(cation.)227
-4752 y(Ho)n(w)n(ev)n(er,)32 b(AST)i(curren)n(tly)e(do)r(es)g(not)h
+1393 y(Ho)n(w)n(ev)n(er,)32 b(AST)i(curren)n(tly)e(do)r(es)g(not)h
(include)g(an)n(y)f(classes)g(of)g(F)-7 b(rame)33 b(for)f(describing)g
-(terrestrial)f(or)h(solar)227 4852 y(system)e(p)r(ositions.)44
+(terrestrial)f(or)h(solar)227 1492 y(system)e(p)r(ositions.)44
b(Therefore,)29 b(the)h(pro)n(vision)f(for)g(returning)g(observ)-5
b(atory)28 b(lo)r(cation)i(as)f(an)h(Stc)g(is)g(not)g(y)n(et)227
-4951 y(a)n(v)-5 b(ailable.)34 b(Ho)n(w)n(ev)n(er,)21
+1592 y(a)n(v)-5 b(ailable.)34 b(Ho)n(w)n(ev)n(er,)21
b(for)g(terrestrial)g(observ)-5 b(ations,)21 b(the)h(p)r(osition)g(of)g
(the)g(observ)-5 b(atory)19 b(can)j(still)g(b)r(e)g(recorded)227
-5051 y(using)33 b(the)g(ObsLon)f(and)g(ObsLat)g(attributes)h(of)g(the)g
+1691 y(using)33 b(the)g(ObsLon)f(and)g(ObsLat)g(attributes)h(of)g(the)g
(F)-7 b(rame)32 b(encapsulated)g(within)i(the)f(Stc)g(represen)n(ting)
-227 5151 y(the)28 b(observ)-5 b(ation)26 b(lo)r(cation)h(\(this)i
+227 1791 y(the)28 b(observ)-5 b(ation)26 b(lo)r(cation)h(\(this)i
(assumes)d(the)i(observ)-5 b(atory)25 b(is)j(lo)r(cated)f(at)h(sea)f
-(lev)n(el\).)0 5299 y Fc(Constructor)32 b(F)-8 b(unction:)227
-5399 y Fj(AST)p Ft(_)p Fj(STCOBSD)n(A)h(T)g(ALOCA)g(TION)-2
-5547 y Fc(Inheritance)n(:)227 5693 y Fj(The)28 b(StcObsDataLo)r(cation)
-e(class)h(inherits)g(from)h(the)g(Stc)g(class.)p eop
-end
-%%Page: 550 560
-TeXDict begin 550 559 bop 0 52 a FG(550)2251 b Fz(D)91
-b(AST)30 b(CLASS)f(DESCRIPTIONS)-2 351 y Fc(A)m(ttributes)n(:)227
-497 y Fj(The)h(StcObsDataLo)r(cation)f(class)g(do)r(es)g(not)h
-(de\014ne)g(an)n(y)f(new)h(attributes)g(b)r(ey)n(ond)g(those)f(whic)n
-(h)h(are)f(appli-)227 597 y(cable)e(to)h(all)f(Stcs.)-2
-768 y Fc(F)-8 b(unctions)n(:)227 914 y Fj(The)23 b(StcObsDataLo)r
-(cation)f(class)f(do)r(es)i(not)g(de\014ne)g(an)n(y)f(new)h(routines)f
-(b)r(ey)n(ond)g(those)h(whic)n(h)f(are)g(applicable)227
-1014 y(to)28 b(all)f(Stcs.)p 0 1234 3780 12 v 0 1366
+(lev)n(el\).)0 1963 y Fc(Constructor)32 b(F)-8 b(unction:)227
+2063 y Fj(AST)p Ft(_)p Fj(STCOBSD)n(A)h(T)g(ALOCA)g(TION)-2
+2235 y Fc(Inheritance)n(:)227 2381 y Fj(The)28 b(StcObsDataLo)r(cation)
+e(class)h(inherits)g(from)h(the)g(Stc)g(class.)-2 2553
+y Fc(A)m(ttributes)n(:)227 2699 y Fj(The)i(StcObsDataLo)r(cation)f
+(class)g(do)r(es)g(not)h(de\014ne)g(an)n(y)f(new)h(attributes)g(b)r(ey)
+n(ond)g(those)f(whic)n(h)h(are)f(appli-)227 2798 y(cable)e(to)h(all)f
+(Stcs.)-2 2970 y Fc(F)-8 b(unctions)n(:)227 3116 y Fj(The)23
+b(StcObsDataLo)r(cation)f(class)f(do)r(es)i(not)g(de\014ne)g(an)n(y)f
+(new)h(routines)f(b)r(ey)n(ond)g(those)h(whic)n(h)f(are)g(applicable)
+227 3216 y(to)28 b(all)f(Stcs.)p 0 3438 3780 12 v 0 3569
a FA(StcResourcePro\014le)153 b Fd(Corresp)s(ond)33 b(to)g(the)h(IV)m
-(O)m(A)1377 1481 y(STCResourcePro\014le)1772 1580 y(class)2672
-1366 y FA(StcResourcePro\014le)0 1767 y Fc(Description:)44
+(O)m(A)1377 3684 y(STCResourcePro\014le)1772 3784 y(class)2672
+3569 y FA(StcResourcePro\014le)0 3972 y Fc(Description:)44
b Fj(The)37 b(StcResourcePro\014le)d(class)h(is)h(a)g(sub-class)e(of)j
(Stc)f(used)g(to)g(describ)r(e)g(the)h(co)n(v)n(erage)c(of)j(the)227
-1867 y(datasets)27 b(con)n(tained)g(in)h(some)f(V)n(O)g(resource.)227
-2002 y(See)h(h)n(ttp://hea-www.harv)-5 b(ard.edu/)p Fi(\030)p
-Fj(arots/n)n(v)n(o)o(meta/STC.h)n(tml)0 2173 y Fc(Constructor)32
-b(F)-8 b(unction:)227 2273 y Fj(AST)p Ft(_)p Fj(STCRESOUR)n(CEPR)n
-(OFILE)-2 2443 y Fc(Inheritance)n(:)227 2589 y Fj(The)28
+4071 y(datasets)27 b(con)n(tained)g(in)h(some)f(V)n(O)g(resource.)227
+4207 y(See)h(h)n(ttp://hea-www.harv)-5 b(ard.edu/)p Fi(\030)p
+Fj(arots/n)n(v)n(o)o(meta/STC.h)n(tml)0 4379 y Fc(Constructor)32
+b(F)-8 b(unction:)227 4479 y Fj(AST)p Ft(_)p Fj(STCRESOUR)n(CEPR)n
+(OFILE)-2 4651 y Fc(Inheritance)n(:)227 4797 y Fj(The)28
b(StcResourcePro\014le)d(class)i(inherits)g(from)h(the)g(Stc)g(class.)
--2 2760 y Fc(A)m(ttributes)n(:)227 2906 y Fj(The)c
+-2 4969 y Fc(A)m(ttributes)n(:)227 5115 y Fj(The)c
(StcResourcePro\014le)e(class)h(do)r(es)g(not)h(de\014ne)g(an)n(y)f
(new)h(attributes)g(b)r(ey)n(ond)f(those)h(whic)n(h)f(are)g(applicable)
-227 3006 y(to)28 b(all)f(Stcs.)-2 3177 y Fc(F)-8 b(unctions)n(:)227
-3323 y Fj(The)29 b(StcResourcePro\014le)e(class)g(do)r(es)i(not)g
+227 5214 y(to)28 b(all)f(Stcs.)-2 5386 y Fc(F)-8 b(unctions)n(:)227
+5532 y Fj(The)29 b(StcResourcePro\014le)e(class)g(do)r(es)i(not)g
(de\014ne)g(an)n(y)f(new)h(routines)f(b)r(ey)n(ond)g(those)h(whic)n(h)f
-(are)g(applicable)227 3423 y(to)g(all)f(Stcs.)p 0 3643
-V 0 3775 a FA(StcSearc)l(hLo)t(cation)170 b Fd(Corresp)s(ond)37
-b(to)h(the)h(IV)m(O)m(A)1362 3890 y(Searc)m(hLo)s(cation)d(class)2697
-3775 y FA(StcSearc)l(hLo)t(cation)0 4077 y Fc(Description:)44
+(are)g(applicable)227 5632 y(to)g(all)f(Stcs.)p eop end
+%%Page: 557 567
+TeXDict begin 557 566 bop 3643 52 a FG(557)p 0 351 3780
+12 v 0 483 a FA(StcSearc)l(hLo)t(cation)170 b Fd(Corresp)s(ond)37
+b(to)h(the)h(IV)m(O)m(A)1362 598 y(Searc)m(hLo)s(cation)d(class)2697
+483 y FA(StcSearc)l(hLo)t(cation)0 766 y Fc(Description:)44
b Fj(The)25 b(StcSearc)n(hLo)r(cation)e(class)g(is)i(a)f(sub-class)f
(of)h(Stc)h(used)g(to)f(describ)r(e)g(the)h(co)n(v)n(erage)d(of)i(a)g
-(query)-7 b(.)227 4212 y(See)28 b(h)n(ttp://hea-www.harv)-5
+(query)-7 b(.)227 892 y(See)28 b(h)n(ttp://hea-www.harv)-5
b(ard.edu/)p Fi(\030)p Fj(arots/n)n(v)n(o)o(meta/STC.h)n(tml)0
-4383 y Fc(Constructor)32 b(F)-8 b(unction:)227 4482 y
-Fj(AST)p Ft(_)p Fj(STCSEAR)n(CHLOCA)h(TION)-2 4653 y
-Fc(Inheritance)n(:)227 4799 y Fj(The)28 b(StcSearc)n(hLo)r(cation)e
-(class)g(inherits)i(from)f(the)h(Stc)g(class.)-2 4970
-y Fc(A)m(ttributes)n(:)227 5116 y Fj(The)d(StcSearc)n(hLo)r(cation)d
+1045 y Fc(Constructor)32 b(F)-8 b(unction:)227 1144 y
+Fj(AST)p Ft(_)p Fj(STCSEAR)n(CHLOCA)h(TION)-2 1297 y
+Fc(Inheritance)n(:)227 1443 y Fj(The)28 b(StcSearc)n(hLo)r(cation)e
+(class)g(inherits)i(from)f(the)h(Stc)g(class.)-2 1595
+y Fc(A)m(ttributes)n(:)227 1741 y Fj(The)d(StcSearc)n(hLo)r(cation)d
(class)i(do)r(es)g(not)g(de\014ne)g(an)n(y)g(new)g(attributes)h(b)r(ey)
-n(ond)f(those)g(whic)n(h)g(are)f(applicable)227 5216
-y(to)28 b(all)f(Stcs.)-2 5387 y Fc(F)-8 b(unctions)n(:)227
-5533 y Fj(The)30 b(StcSearc)n(hLo)r(cation)d(class)h(do)r(es)h(not)h
+n(ond)f(those)g(whic)n(h)g(are)f(applicable)227 1841
+y(to)28 b(all)f(Stcs.)-2 1993 y Fc(F)-8 b(unctions)n(:)227
+2140 y Fj(The)30 b(StcSearc)n(hLo)r(cation)d(class)h(do)r(es)h(not)h
(de\014ne)f(an)n(y)g(new)g(routines)g(b)r(ey)n(ond)g(those)g(whic)n(h)g
-(are)f(applicable)227 5632 y(to)g(all)f(Stcs.)p eop end
-%%Page: 551 561
-TeXDict begin 551 560 bop 3643 52 a FG(551)p 0 351 3780
-12 v 0 483 a FA(StcsChan)897 490 y Fd(I/O)39 b(Channel)f(using)g(STC-S)
-g(to)h(represen)m(t)1693 611 y(Ob)7 b(jects)3228 483
-y FA(StcsChan)0 805 y Fc(Description:)44 b Fj(A)24 b(StcsChan)f(is)h(a)
-f(sp)r(ecialised)g(form)g(of)g(Channel)g(whic)n(h)h(supp)r(orts)f
-(STC-S)g(I/O)f(op)r(erations.)35 b(W)-7 b(rit-)227 904
+(are)f(applicable)227 2239 y(to)g(all)f(Stcs.)p 0 2441
+V 0 2573 a FA(StcsChan)897 2580 y Fd(I/O)39 b(Channel)f(using)g(STC-S)g
+(to)h(represen)m(t)1693 2701 y(Ob)7 b(jects)3228 2573
+y FA(StcsChan)0 2897 y Fc(Description:)44 b Fj(A)24 b(StcsChan)f(is)h
+(a)f(sp)r(ecialised)g(form)g(of)g(Channel)g(whic)n(h)h(supp)r(orts)f
+(STC-S)g(I/O)f(op)r(erations.)35 b(W)-7 b(rit-)227 2997
y(ing)35 b(an)g(Ob)5 b(ject)34 b(to)h(an)g(StcsChan)g(\(using)g(AST)p
Ft(_)p Fj(WRITE\))g(will,)i(if)e(the)h(Ob)5 b(ject)35
-b(is)f(suitable,)j(generate)d(an)227 1004 y(STC-S)e(description)f(of)h
+b(is)f(suitable,)j(generate)d(an)227 3097 y(STC-S)e(description)f(of)h
(that)g(Ob)5 b(ject,)33 b(and)f(reading)f(from)g(an)h(StcsChan)g(will)g
-(create)f(a)g(new)h(Ob)5 b(ject)32 b(from)227 1104 y(its)c(STC-S)g
-(description.)227 1228 y(When)37 b(an)e(STC-S)h(description)f(is)h
+(create)f(a)g(new)h(Ob)5 b(ject)32 b(from)227 3196 y(its)c(STC-S)g
+(description.)227 3322 y(When)37 b(an)e(STC-S)h(description)f(is)h
(read)f(using)h(AST)p Ft(_)p Fj(READ,)g(the)g(returned)g(AST)g(Ob)5
-b(ject)36 b(ma)n(y)f(b)r(e)h(1\))g(a)227 1328 y(P)n(oin)n(tList)e
+b(ject)36 b(ma)n(y)f(b)r(e)h(1\))g(a)227 3422 y(P)n(oin)n(tList)e
(describing)g(the)h(STC)g(AstroCo)r(ords)e(\(i.e.)59
b(a)34 b(single)g(p)r(oin)n(t)h(of)g(in)n(terest)f(within)i(the)f(co)r
-(ordinate)227 1428 y(frame)e(describ)r(ed)g(b)n(y)g(the)h(STC-S)f
+(ordinate)227 3522 y(frame)e(describ)r(ed)g(b)n(y)g(the)h(STC-S)f
(description\),)i(or)d(2\))i(a)f(Region)f(describing)h(the)g(STC)h
-(AstrCo)r(ordsArea)227 1527 y(\(i.e.)i(an)21 b(area)f(or)g(v)n(olume)h
+(AstrCo)r(ordsArea)227 3621 y(\(i.e.)i(an)21 b(area)f(or)g(v)n(olume)h
(of)h(in)n(terest)f(within)h(the)g(co)r(ordinate)e(frame)h(describ)r
-(ed)g(b)n(y)h(the)f(STC-S)h(description\),)227 1627 y(or)d(3\))g(a)f
+(ed)g(b)n(y)h(the)f(STC-S)h(description\),)227 3721 y(or)d(3\))g(a)f
(KeyMap)h(con)n(taining)f(the)h(unin)n(terpreted)g(prop)r(ert)n(y)f(v)
-5 b(alues)19 b(read)g(form)f(the)i(STC-S)f(description,)h(or)f(4\))227
-1726 y(a)26 b(KeyMap)f(con)n(taining)g(an)n(y)g(com)n(bination)g(of)h
+3820 y(a)26 b(KeyMap)f(con)n(taining)g(an)n(y)g(com)n(bination)g(of)h
(the)h(\014rst)f(3)f(options.)36 b(The)26 b(attributes)g(StcsArea,)g
-(StcsCo)r(ords)227 1826 y(and)i(StcsProps)e(con)n(trol)g(whic)n(h)i(of)
+(StcsCo)r(ords)227 3920 y(and)i(StcsProps)e(con)n(trol)g(whic)n(h)i(of)
f(the)h(ab)r(o)n(v)n(e)e(is)i(returned)f(b)n(y)g(AST)p
-Ft(_)p Fj(READ.)227 1951 y(When)h(an)e(STC-S)h(description)f(is)g
+Ft(_)p Fj(READ.)227 4046 y(When)h(an)e(STC-S)h(description)f(is)g
(created)g(from)h(an)f(AST)h(Ob)5 b(ject)27 b(using)f(AST)p
-Ft(_)p Fj(WRITE,)h(the)g(AST)g(Ob)5 b(ject)227 2050 y(m)n(ust)21
+Ft(_)p Fj(WRITE,)h(the)g(AST)g(Ob)5 b(ject)227 4146 y(m)n(ust)21
b(b)r(e)g(either)g(a)f(Region)g(or)g(a)h(KeyMap.)33 b(If)22
b(it)f(is)g(a)f(Region,)h(it)h(is)e(assumed)g(to)h(de\014ne)g(the)g
-(AstroCo)r(ordsArea)227 2150 y(or)g(\(if)i(the)g(Region)e(is)h(a)g
+(AstroCo)r(ordsArea)227 4245 y(or)g(\(if)i(the)g(Region)e(is)h(a)g
(single)f(p)r(oin)n(t\))i(the)f(AstroCo)r(ords)e(to)i(write)g(to)g(the)
g(STC-S)g(description.)35 b(If)22 b(the)h(Ob)5 b(ject)227
-2250 y(is)24 b(a)f(KeyMap,)h(it)g(ma)n(y)f(con)n(tain)h(an)f(en)n(try)g
+4345 y(is)24 b(a)f(KeyMap,)h(it)g(ma)n(y)f(con)n(tain)h(an)f(en)n(try)g
(with)i(the)f(k)n(ey)f Ft(")p Fj(AREA)p Ft(")p Fj(,)h(holding)f(a)h
-(Region)f(to)h(b)r(e)g(used)g(to)f(de\014ne)227 2349
+(Region)f(to)h(b)r(e)g(used)g(to)f(de\014ne)227 4445
y(the)i(AstroCo)r(ordsArea.)34 b(It)25 b(ma)n(y)f(also)g(con)n(tain)g
(an)g(en)n(try)h(with)g(the)g(k)n(ey)f Ft(")p Fj(COORDS)p
-Ft(")p Fj(,)h(holding)f(a)h(Region)f(\(a)227 2449 y(P)n(oin)n(tList\))g
+Ft(")p Fj(,)h(holding)f(a)h(Region)f(\(a)227 4544 y(P)n(oin)n(tList\))g
(to)g(b)r(e)h(used)g(to)f(create)g(the)h(AstroCo)r(ords.)34
b(It)25 b(ma)n(y)e(also)h(con)n(tain)g(an)g(en)n(try)g(with)h(k)n(ey)f
-Ft(")p Fj(PR)n(OPS)p Ft(")p Fj(,)227 2549 y(holding)d(a)f(KeyMap)g
+Ft(")p Fj(PR)n(OPS)p Ft(")p Fj(,)227 4644 y(holding)d(a)f(KeyMap)g
(that)h(con)n(tains)f(unin)n(terpreted)g(prop)r(ert)n(y)g(v)-5
b(alues)21 b(to)f(b)r(e)h(used)g(as)f(defaults)h(for)g(an)n(y)f(STC-S)
-227 2648 y(prop)r(erties)k(that)g(are)f(not)h(determined)h(b)n(y)f(the)
+227 4744 y(prop)r(erties)k(that)g(are)f(not)h(determined)h(b)n(y)f(the)
g(other)g(supplied)g(Regions.)35 b(In)24 b(addition,)h(a)f(KeyMap)f
-(supplied)227 2748 y(to)29 b(AST)p Ft(_)p Fj(WRITE)f(ma)n(y)g(itself)h
+(supplied)227 4843 y(to)29 b(AST)p Ft(_)p Fj(WRITE)f(ma)n(y)g(itself)h
(hold)f(the)h(default)g(STC-S)f(prop)r(erties)g(\(rather)g(than)g
-(defaults)h(b)r(eing)g(held)f(in)227 2847 y(a)f(secondary)f(KeyMap,)h
+(defaults)h(b)r(eing)g(held)f(in)227 4943 y(a)f(secondary)f(KeyMap,)h
(stored)g(as)g(the)h Ft(")p Fj(PR)n(OPS)p Ft(")d Fj(en)n(try)i(in)h
-(the)g(supplied)g(KeyMap\).)227 2972 y(The)43 b(AST)p
+(the)g(supplied)g(KeyMap\).)227 5069 y(The)43 b(AST)p
Ft(_)p Fj(READ)g(and)f(AST)p Ft(_)p Fj(WRITE)g(functions)h(w)n(ork)e
(together)g(so)h(that)h(an)n(y)f(Ob)5 b(ject)42 b(returned)g(b)n(y)227
-3072 y(AST)p Ft(_)p Fj(READ)28 b(can)f(immediately)h(b)r(e)g
-(re-written)f(using)g(AST)p Ft(_)p Fj(WRITE.)227 3197
+5168 y(AST)p Ft(_)p Fj(READ)28 b(can)f(immediately)h(b)r(e)g
+(re-written)f(using)g(AST)p Ft(_)p Fj(WRITE.)227 5295
y(Normally)-7 b(,)40 b(when)e(y)n(ou)f(use)h(an)f(StcsChan,)k(y)n(ou)c
(should)g(pro)n(vide)g Ft(")p Fj(source)p Ft(")f Fj(and)i
-Ft(")p Fj(sink)p Ft(")e Fj(routines)i(whic)n(h)227 3296
+Ft(")p Fj(sink)p Ft(")e Fj(routines)i(whic)n(h)227 5394
y(connect)f(it)g(to)f(an)h(external)f(data)g(store)g(b)n(y)g(reading)f
(and)i(writing)f(the)h(resulting)f(text.)65 b(These)36
-b(routines)227 3396 y(should)k(p)r(erform)f(an)n(y)h(con)n(v)n(ersions)
+b(routines)227 5494 y(should)k(p)r(erform)f(an)n(y)h(con)n(v)n(ersions)
d(needed)j(b)r(et)n(w)n(een)g(external)f(c)n(haracter)f(enco)r(dings)h
-(and)h(the)g(in)n(ternal)227 3495 y(ASCI)r(I)33 b(enco)r(ding.)51
+(and)h(the)g(in)n(ternal)227 5593 y(ASCI)r(I)33 b(enco)r(ding.)51
b(If)33 b(no)f(suc)n(h)g(routines)g(are)g(supplied,)i(a)e(Channel)g
-(will)h(read)e(from)h(standard)g(input)h(and)227 3595
-y(write)28 b(to)f(standard)g(output.)227 3720 y(Alternativ)n(ely)-7
+(will)h(read)e(from)h(standard)g(input)h(and)227 5693
+y(write)28 b(to)f(standard)g(output.)p eop end
+%%Page: 558 568
+TeXDict begin 558 567 bop 0 52 a FG(558)2251 b Fz(D)91
+b(AST)30 b(CLASS)f(DESCRIPTIONS)227 351 y Fj(Alternativ)n(ely)-7
b(,)29 b(an)g(XmlChan)h(can)e(b)r(e)i(told)f(to)g(read)f(or)g(write)h
(from)g(sp)r(eci\014c)g(text)h(\014les)f(using)g(the)g(SinkFile)227
-3819 y(and)f(SourceFile)f(attributes,)g(in)h(whic)n(h)g(case)e(no)i
+451 y(and)f(SourceFile)f(attributes,)g(in)h(whic)n(h)g(case)e(no)i
(sink)f(or)g(source)f(function)i(need)g(b)r(e)g(supplied.)227
-3944 y(Supp)r(ort)36 b(for)f(STC-S)g(is)g(curren)n(tly)g(based)g(on)g
+572 y(Supp)r(ort)36 b(for)f(STC-S)g(is)g(curren)n(tly)g(based)g(on)g
(the)g(IV)n(O)n(A)g(do)r(cumen)n(t)h Ft(")p Fj(STC-S:)f(Space-Time)g
-(Co)r(ordinate)227 4044 y(\(STC\))22 b(Metadata)d(Linear)h(String)g
+(Co)r(ordinate)227 672 y(\(STC\))22 b(Metadata)d(Linear)h(String)g
(Implemen)n(tation)p Ft(")p Fj(,)i(v)n(ersion)d(1.30)g(\(dated)i(5th)g
-(Decem)n(b)r(er)f(2007\),)h(a)n(v)-5 b(ailable)227 4143
+(Decem)n(b)r(er)f(2007\),)h(a)n(v)-5 b(ailable)227 771
y(at)21 b(h)n(ttp://www.iv)n(oa.net/Do)r(cumen)n(ts/latest/STC-S.h)n
(tml.)32 b(Note,)23 b(this)e(do)r(cumen)n(t)h(is)f(a)g(recommednation)
-227 4243 y(only)27 b(and)h(do)r(es)f(not)h(constitute)g(an)f(accepted)g
-(IV)n(O)n(A)g(standard.)227 4368 y(The)f(full)h(text)f(of)g(v)n(ersion)
-e(1.30)g(is)i(supp)r(orted)g(b)n(y)f(the)h(StcsChan)g(class,)f(with)i
-(the)f(follo)n(wing)f(exceptions)g(and)227 4467 y(pro)n(visos:)340
-4729 y Fi(\017)45 b Fj(When)28 b(reading)f(an)g(STC-S)h(phrase,)e(case)
+227 871 y(only)27 b(and)h(do)r(es)f(not)h(constitute)g(an)f(accepted)g
+(IV)n(O)n(A)g(standard.)227 992 y(The)f(full)h(text)f(of)g(v)n(ersion)e
+(1.30)g(is)i(supp)r(orted)g(b)n(y)f(the)h(StcsChan)g(class,)f(with)i
+(the)f(follo)n(wing)f(exceptions)g(and)227 1092 y(pro)n(visos:)340
+1343 y Fi(\017)45 b Fj(When)28 b(reading)f(an)g(STC-S)h(phrase,)e(case)
h(is)h(ignored)e(except)i(when)f(reading)g(units)h(strings.)340
-4862 y Fi(\017)45 b Fj(There)31 b(is)g(no)h(supp)r(ort)f(for)g(m)n
+1470 y Fi(\017)45 b Fj(There)31 b(is)g(no)h(supp)r(ort)f(for)g(m)n
(ultiple)h(in)n(terv)-5 b(als)30 b(sp)r(eci\014ed)i(within)g(a)f
(TimeIn)n(terv)-5 b(al,)32 b(P)n(ositionIn)n(terv)-5
-b(al,)427 4962 y(Sp)r(ectralIn)n(terv)g(al)27 b(or)g(RedshiftIn)n(terv)
--5 b(al.)340 5095 y Fi(\017)45 b Fj(If)28 b(the)g(ET)f(timescale)h(is)f
-(sp)r(eci\014ed,)h(TT)g(is)f(used)h(instead.)340 5228
+b(al,)427 1570 y(Sp)r(ectralIn)n(terv)g(al)27 b(or)g(RedshiftIn)n(terv)
+-5 b(al.)340 1696 y Fi(\017)45 b Fj(If)28 b(the)g(ET)f(timescale)h(is)f
+(sp)r(eci\014ed,)h(TT)g(is)f(used)h(instead.)340 1822
y Fi(\017)45 b Fj(If)28 b(the)g(TEB)f(timescale)g(is)h(sp)r(eci\014ed,)
-g(TDB)g(is)f(used)h(instead.)340 5361 y Fi(\017)45 b
+g(TDB)g(is)f(used)h(instead.)340 1949 y Fi(\017)45 b
Fj(The)28 b(LOCAL)f(timescale)g(is)h(not)f(supp)r(orted.)340
-5494 y Fi(\017)45 b Fj(The)26 b(AST)g(TimeF)-7 b(rame)25
+2075 y Fi(\017)45 b Fj(The)26 b(AST)g(TimeF)-7 b(rame)25
b(and)h(SkyF)-7 b(rame)25 b(classes)f(do)h(not)h(curren)n(tly)f(allo)n
-(w)f(a)h(reference)g(p)r(osition)h(to)f(b)r(e)427 5593
+(w)f(a)h(reference)g(p)r(osition)h(to)f(b)r(e)427 2175
y(sp)r(eci\014ed.)45 b(Consequen)n(tly)-7 b(,)30 b(an)n(y)f
Fl(<)p Fj(refp)r(os)p Fl(>)g Fj(sp)r(eci\014ed)h(within)h(the)f(Time)g
-(or)g(Space)f(sub-phrase)g(of)h(an)427 5693 y(STC-S)e(do)r(cumen)n(t)g
-(is)f(ignored.)p eop end
-%%Page: 552 562
-TeXDict begin 552 561 bop 0 52 a FG(552)2251 b Fz(D)91
-b(AST)30 b(CLASS)f(DESCRIPTIONS)340 351 y Fi(\017)45
-b Fj(The)28 b(Con)n(v)n(ex)e(iden)n(ti\014er)i(for)f(the)h(space)e
-(sub-phrase)h(is)g(not)h(supp)r(orted.)340 486 y Fi(\017)45
-b Fj(The)28 b(GEO)p Ft(_)p Fj(C)e(and)i(GEO)p Ft(_)p
-Fj(D)f(space)g(frames)f(are)h(not)h(supp)r(orted.)340
-620 y Fi(\017)45 b Fj(The)28 b(UNITSPHERE)f(and)h(SPHER3)e(space)h
-(\015a)n(v)n(ours)e(are)i(not)h(supp)r(orted.)340 754
+(or)g(Space)f(sub-phrase)g(of)h(an)427 2275 y(STC-S)e(do)r(cumen)n(t)g
+(is)f(ignored.)340 2401 y Fi(\017)45 b Fj(The)28 b(Con)n(v)n(ex)e(iden)
+n(ti\014er)i(for)f(the)h(space)e(sub-phrase)h(is)g(not)h(supp)r(orted.)
+340 2527 y Fi(\017)45 b Fj(The)28 b(GEO)p Ft(_)p Fj(C)e(and)i(GEO)p
+Ft(_)p Fj(D)f(space)g(frames)f(are)h(not)h(supp)r(orted.)340
+2654 y Fi(\017)45 b Fj(The)28 b(UNITSPHERE)f(and)h(SPHER3)e(space)h
+(\015a)n(v)n(ours)e(are)i(not)h(supp)r(orted.)340 2780
y Fi(\017)45 b Fj(If)33 b(an)n(y)f(Error)d(v)-5 b(alues)32
b(are)g(supplied)g(in)h(a)f(space)f(sub-phrase,)i(then)f(the)h(n)n(um)n
-(b)r(er)f(of)g(v)-5 b(alues)32 b(supplied)427 854 y(should)c(equal)f
+(b)r(er)f(of)g(v)-5 b(alues)32 b(supplied)427 2880 y(should)c(equal)f
(the)i(n)n(um)n(b)r(er)f(of)g(spatial)f(axes,)g(and)h(the)g(v)-5
b(alues)28 b(are)f(assumed)g(to)h(sp)r(ecify)g(an)g(error)e(b)r(o)n(x)
-427 954 y(\(i.e.)38 b(error)25 b(circles,)i(ellipses,)g(etc,)h(are)f
-(not)g(supp)r(orted\).)340 1088 y Fi(\017)45 b Fj(The)35
+427 2980 y(\(i.e.)38 b(error)25 b(circles,)i(ellipses,)g(etc,)h(are)f
+(not)g(supp)r(orted\).)340 3106 y Fi(\017)45 b Fj(The)35
b(sp)r(ectral)g(and)f(redshift)h(sub-phrases)f(do)g(not)h(supp)r(ort)g
(the)g(follo)n(wing)f Fl(<)p Fj(refp)r(os)p Fl(>)f Fj(v)-5
-b(alues:)51 b(LO-)427 1188 y(CAL)p Ft(_)p Fj(GR)n(OUP)p
+b(alues:)51 b(LO-)427 3206 y(CAL)p Ft(_)p Fj(GR)n(OUP)p
Ft(_)p Fj(CENTER,)41 b(UNKNO)n(WNRefP)n(os,)46 b(EMBAR)-7
-b(YCENTER,)42 b(MOON,)g(MER)n(CUR)-7 b(Y,)427 1287 y(VENUS,)28
+b(YCENTER,)42 b(MOON,)g(MER)n(CUR)-7 b(Y,)427 3305 y(VENUS,)28
b(MARS,)h(JUPITER,)d(SA)-7 b(TURN,)29 b(URANUS,)g(NEPTUNE,)e(PLUTO.)340
-1422 y Fi(\017)45 b Fj(Error)26 b(v)-5 b(alues)27 b(are)f(supp)r(orted)
-i(but)g(error)e(ranges)g(are)g(not.)340 1556 y Fi(\017)45
+3432 y Fi(\017)45 b Fj(Error)26 b(v)-5 b(alues)27 b(are)f(supp)r(orted)
+i(but)g(error)e(ranges)g(are)g(not.)340 3558 y Fi(\017)45
b Fj(Resolution,)27 b(PixSize)g(and)h(Size)g(v)-5 b(alues)27
-b(are)f(ignored.)340 1690 y Fi(\017)45 b Fj(Space)28
+b(are)f(ignored.)340 3685 y Fi(\017)45 b Fj(Space)28
b(v)n(elo)r(cit)n(y)e(sub-phrases)g(are)h(ignored.)0
-1855 y Fc(Constructor)32 b(F)-8 b(unction:)227 1955 y
-Fj(AST)p Ft(_)p Fj(STCSCHAN)-2 2107 y Fc(Inheritance)n(:)227
-2253 y Fj(The)28 b(StcsChan)f(class)g(inherits)h(from)f(the)h(Channel)f
-(class.)-2 2406 y Fc(A)m(ttributes)n(:)227 2552 y Fj(In)36
+3840 y Fc(Constructor)32 b(F)-8 b(unction:)227 3940 y
+Fj(AST)p Ft(_)p Fj(STCSCHAN)-2 4083 y Fc(Inheritance)n(:)227
+4229 y Fj(The)28 b(StcsChan)f(class)g(inherits)h(from)f(the)h(Channel)f
+(class.)-2 4372 y Fc(A)m(ttributes)n(:)227 4518 y Fj(In)36
b(addition)g(to)g(those)f(attributes)h(common)f(to)h(all)g(Channels,)h
(ev)n(ery)e(StcsChan)g(also)g(has)g(the)i(follo)n(wing)227
-2652 y(attributes:)340 2917 y Fi(\017)45 b Fj(StcsArea:)36
+4618 y(attributes:)340 4869 y Fi(\017)45 b Fj(StcsArea:)36
b(Return)28 b(the)g(Co)r(ordinateArea)e(comp)r(onen)n(t)h(after)g
-(reading)g(an)g(STC-S?)340 3052 y Fi(\017)45 b Fj(StcsCo)r(ords:)36
+(reading)g(an)g(STC-S?)340 4995 y Fi(\017)45 b Fj(StcsCo)r(ords:)36
b(Return)28 b(the)g(Co)r(ordinates)e(comp)r(onen)n(t)h(after)h(reading)
-e(an)h(STC-S?)340 3186 y Fi(\017)45 b Fj(StcsLength:)37
-b(Con)n(trols)26 b(output)i(bu\013er)g(length)340 3320
+e(an)h(STC-S?)340 5122 y Fi(\017)45 b Fj(StcsLength:)37
+b(Con)n(trols)26 b(output)i(bu\013er)g(length)340 5248
y Fi(\017)45 b Fj(StcsProps:)36 b(Return)27 b(the)h(STC-S)g(prop)r
-(erties)f(after)g(reading)f(an)i(STC-S?)-2 3485 y Fc(F)-8
-b(unctions)n(:)227 3631 y Fj(The)37 b(StcsChan)f(class)g(do)r(es)g(not)
+(erties)f(after)g(reading)f(an)i(STC-S?)-2 5404 y Fc(F)-8
+b(unctions)n(:)227 5550 y Fj(The)37 b(StcsChan)f(class)g(do)r(es)g(not)
g(de\014ne)h(an)n(y)f(new)g(routines)g(b)r(ey)n(ond)g(those)h(whic)n(h)
-f(are)g(applicable)g(to)g(all)227 3731 y(Channels.)p
-0 3933 3780 12 v 0 4065 a FA(Switc)l(hMap)268 b Fd(A)39
-b(Mapping)f(that)f(encapsulates)h(a)h(set)f(of)1394 4180
-y(alternate)e(Mappings)3120 4065 y FA(Switc)l(hMap)0
-4371 y Fc(Description:)44 b Fj(A)31 b(Switc)n(hMap)f(is)g(a)f(Mapping)h
-(whic)n(h)g(represen)n(ts)e(a)i(set)g(of)g(alternate)f(Mappings,)h(eac)
-n(h)g(of)g(whic)n(h)227 4471 y(is)e(used)f(to)g(transform)g(p)r
-(ositions)g(within)h(a)f(particular)f(region)g(of)i(the)g(input)g(or)f
-(output)h(co)r(ordinate)e(system)227 4571 y(of)i(the)g(Switc)n(hMap.)
-227 4697 y(A)34 b(Switc)n(hMap)e(can)h(encapsulate)f(an)n(y)g(n)n(um)n
-(b)r(er)h(of)g(Mappings,)h(but)f(they)h(m)n(ust)f(all)f(ha)n(v)n(e)g
-(the)h(same)g(n)n(um-)227 4796 y(b)r(er)d(of)g(inputs)h(\(Nin)f
-(attribute)g(v)-5 b(alue\))31 b(and)e(the)i(same)e(n)n(um)n(b)r(er)h
-(of)g(outputs)g(\(Nout)g(attribute)g(v)-5 b(alue\).)45
-b(The)227 4896 y(Switc)n(hMap)20 b(itself)h(inherits)f(these)g(same)g
-(v)-5 b(alues)20 b(for)f(its)i(Nin)f(and)g(Nout)h(attributes.)34
-b(Eac)n(h)19 b(of)h(these)g(Mappings)227 4996 y(represen)n(ts)33
+f(are)g(applicable)g(to)g(all)227 5650 y(Channels.)p
+eop end
+%%Page: 559 569
+TeXDict begin 559 568 bop 3643 52 a FG(559)p 0 351 3780
+12 v 0 483 a FA(Switc)l(hMap)268 b Fd(A)39 b(Mapping)f(that)f
+(encapsulates)h(a)h(set)f(of)1394 598 y(alternate)e(Mappings)3120
+483 y FA(Switc)l(hMap)0 775 y Fc(Description:)44 b Fj(A)31
+b(Switc)n(hMap)f(is)g(a)f(Mapping)h(whic)n(h)g(represen)n(ts)e(a)i(set)
+g(of)g(alternate)f(Mappings,)h(eac)n(h)g(of)g(whic)n(h)227
+874 y(is)e(used)f(to)g(transform)g(p)r(ositions)g(within)h(a)f
+(particular)f(region)g(of)i(the)g(input)g(or)f(output)h(co)r(ordinate)e
+(system)227 974 y(of)i(the)g(Switc)n(hMap.)227 1096 y(A)34
+b(Switc)n(hMap)e(can)h(encapsulate)f(an)n(y)g(n)n(um)n(b)r(er)h(of)g
+(Mappings,)h(but)f(they)h(m)n(ust)f(all)f(ha)n(v)n(e)g(the)h(same)g(n)n
+(um-)227 1195 y(b)r(er)d(of)g(inputs)h(\(Nin)f(attribute)g(v)-5
+b(alue\))31 b(and)e(the)i(same)e(n)n(um)n(b)r(er)h(of)g(outputs)g
+(\(Nout)g(attribute)g(v)-5 b(alue\).)45 b(The)227 1295
+y(Switc)n(hMap)20 b(itself)h(inherits)f(these)g(same)g(v)-5
+b(alues)20 b(for)f(its)i(Nin)f(and)g(Nout)h(attributes.)34
+b(Eac)n(h)19 b(of)h(these)g(Mappings)227 1395 y(represen)n(ts)33
b(a)h Ft(")p Fj(route)p Ft(")f Fj(through)h(the)g(switc)n(h,)i(and)e
(are)g(referred)f(to)h(as)g Ft(")p Fj(route)p Ft(")e
-Fj(Mappings)i(b)r(elo)n(w.)57 b(Eac)n(h)227 5095 y(route)30
+Fj(Mappings)i(b)r(elo)n(w.)57 b(Eac)n(h)227 1494 y(route)30
b(Mapping)f(transforms)g(p)r(ositions)h(b)r(et)n(w)n(een)g(the)g(input)
h(and)f(output)g(co)r(ordinate)f(space)h(of)g(the)g(en)n(tire)227
-5195 y(Switc)n(hMap,)f(but)h(only)e(one)h(Mapping)f(will)h(b)r(e)h
+1594 y(Switc)n(hMap,)f(but)h(only)e(one)h(Mapping)f(will)h(b)r(e)h
(used)e(to)h(transform)f(an)n(y)g(giv)n(en)g(p)r(osition.)40
-b(The)29 b(selection)g(of)227 5295 y(the)e(appropriate)e(route)h
+b(The)29 b(selection)g(of)227 1694 y(the)e(appropriate)e(route)h
(Mapping)g(to)g(use)g(with)h(an)n(y)f(giv)n(en)f(input)j(p)r(osition)e
-(is)g(made)g(b)n(y)g(another)g(Mapping,)227 5394 y(called)31
+(is)g(made)g(b)n(y)g(another)g(Mapping,)227 1793 y(called)31
b(the)h Ft(")p Fj(selector)p Ft(")e Fj(Mapping.)48 b(Eac)n(h)30
b(Switc)n(hMap)i(encapsulates)e(t)n(w)n(o)h(selector)f(Mappings)h(in)h
-(addition)227 5494 y(to)d(its)g(route)f(Mappings;)h(one)g(for)f(use)h
+(addition)227 1893 y(to)d(its)g(route)f(Mappings;)h(one)g(for)f(use)h
(with)g(the)g(Switc)n(hMap's)g(forw)n(ard)e(transformation)g(\(called)i
-(the)g Ft(")p Fj(for-)227 5593 y(w)n(ard)24 b(selector)g(Mapping)p
+(the)g Ft(")p Fj(for-)227 1992 y(w)n(ard)24 b(selector)g(Mapping)p
Ft(")p Fj(\),)i(and)f(one)g(for)f(use)h(with)h(the)g(Switc)n(hMap's)f
(in)n(v)n(erse)f(transformation)f(\(called)i(the)227
-5693 y Ft(")p Fj(in)n(v)n(erse)f(selector)h(Mapping)p
+2092 y Ft(")p Fj(in)n(v)n(erse)f(selector)h(Mapping)p
Ft(")p Fj(\).)36 b(The)26 b(forw)n(ard)f(selector)g(Mapping)g(m)n(ust)h
-(ha)n(v)n(e)f(the)i(same)e(n)n(um)n(b)r(er)h(of)g(inputs)p
-eop end
-%%Page: 553 563
-TeXDict begin 553 562 bop 3643 52 a FG(553)227 351 y
-Fj(as)30 b(the)h(route)e(Mappings,)i(but)g(should)f(ha)n(v)n(e)f(only)h
-(one)g(output.)45 b(Lik)n(ewise,)30 b(the)h(in)n(v)n(erse)e(selector)g
-(Mapping)227 451 y(m)n(ust)f(ha)n(v)n(e)e(the)i(same)f(n)n(um)n(b)r(er)
-h(of)f(outputs)h(as)f(the)h(route)f(Mappings,)g(but)h(should)g(ha)n(v)n
-(e)e(only)h(one)h(input.)227 575 y(When)40 b(the)g(Switc)n(hMap)f(is)h
-(used)f(to)g(transform)g(a)g(p)r(osition)g(in)h(the)f(forw)n(ard)f
-(direction)h(\(from)h(input)g(to)227 675 y(output\),)g(eac)n(h)35
+(ha)n(v)n(e)f(the)i(same)e(n)n(um)n(b)r(er)h(of)g(inputs)227
+2192 y(as)k(the)h(route)e(Mappings,)i(but)g(should)f(ha)n(v)n(e)f(only)
+h(one)g(output.)45 b(Lik)n(ewise,)30 b(the)h(in)n(v)n(erse)e(selector)g
+(Mapping)227 2291 y(m)n(ust)f(ha)n(v)n(e)e(the)i(same)f(n)n(um)n(b)r
+(er)h(of)f(outputs)h(as)f(the)h(route)f(Mappings,)g(but)h(should)g(ha)n
+(v)n(e)e(only)h(one)h(input.)227 2413 y(When)40 b(the)g(Switc)n(hMap)f
+(is)h(used)f(to)g(transform)g(a)g(p)r(osition)g(in)h(the)f(forw)n(ard)f
+(direction)h(\(from)h(input)g(to)227 2513 y(output\),)g(eac)n(h)35
b(supplied)h(input)h(p)r(osition)f(is)h(\014rst)e(transformed)h(b)n(y)f
-(the)i(forw)n(ard)e(transformation)f(of)i(the)227 775
+(the)i(forw)n(ard)e(transformation)f(of)i(the)227 2612
y(forw)n(ard)27 b(selector)g(Mapping.)38 b(This)28 b(pro)r(duces)f(a)h
(single)f(output)i(v)-5 b(alue)28 b(for)g(eac)n(h)f(input)i(p)r
-(osition)f(referred)f(to)227 874 y(as)j(the)h(selector)e(v)-5
+(osition)f(referred)f(to)227 2712 y(as)j(the)h(selector)e(v)-5
b(alue.)45 b(The)30 b(nearest)f(in)n(teger)h(to)g(the)g(selector)g(v)-5
b(alue)30 b(is)g(found,)h(and)f(is)g(used)h(to)f(index)g(the)227
-974 y(arra)n(y)25 b(of)i(route)f(Mappings)g(\(the)i(\014rst)f(supplied)
-g(route)f(Mapping)h(has)f(index)h(1,)g(the)g(second)g(route)f(Mapping)
-227 1073 y(has)34 b(index)h(2,)h(etc\).)59 b(If)35 b(the)g(nearest)f
-(in)n(teger)g(to)g(the)h(selector)f(v)-5 b(alue)35 b(is)f(less)h(than)f
-(1)h(or)e(greater)g(than)i(the)227 1173 y(n)n(um)n(b)r(er)c(of)f(route)
-g(Mappings,)h(then)h(the)f(Switc)n(hMap)f(output)i(p)r(osition)e(is)h
-(set)f(to)h(a)f(v)-5 b(alue)31 b(of)g(AST)p Ft(__)p Fj(BAD)227
-1273 y(on)k(ev)n(ery)g(axis.)59 b(Otherwise,)37 b(the)f(forw)n(ard)e
-(transformation)f(of)j(the)g(selected)f(route)g(Mapping)g(is)g(used)h
-(to)227 1372 y(transform)27 b(the)h(supplied)g(input)g(p)r(osition)f
-(to)h(pro)r(duce)f(the)h(Switc)n(hMap)g(output)g(p)r(osition.)227
-1497 y(When)33 b(the)g(Switc)n(hMap)f(is)g(used)g(to)g(transform)f(a)h
+2811 y(arra)n(y)25 b(of)i(route)f(Mappings)g(\(the)i(\014rst)f
+(supplied)g(route)f(Mapping)h(has)f(index)h(1,)g(the)g(second)g(route)f
+(Mapping)227 2911 y(has)34 b(index)h(2,)h(etc\).)59 b(If)35
+b(the)g(nearest)f(in)n(teger)g(to)g(the)h(selector)f(v)-5
+b(alue)35 b(is)f(less)h(than)f(1)h(or)e(greater)g(than)i(the)227
+3011 y(n)n(um)n(b)r(er)c(of)f(route)g(Mappings,)h(then)h(the)f(Switc)n
+(hMap)f(output)i(p)r(osition)e(is)h(set)f(to)h(a)f(v)-5
+b(alue)31 b(of)g(AST)p Ft(__)p Fj(BAD)227 3110 y(on)k(ev)n(ery)g(axis.)
+59 b(Otherwise,)37 b(the)f(forw)n(ard)e(transformation)f(of)j(the)g
+(selected)f(route)g(Mapping)g(is)g(used)h(to)227 3210
+y(transform)27 b(the)h(supplied)g(input)g(p)r(osition)f(to)h(pro)r
+(duce)f(the)h(Switc)n(hMap)g(output)g(p)r(osition.)227
+3332 y(When)33 b(the)g(Switc)n(hMap)f(is)g(used)g(to)g(transform)f(a)h
(p)r(osition)g(in)h(the)f(in)n(v)n(erse)f(direction)h(\(from)g
-Ft(")p Fj(output)p Ft(")g Fj(to)227 1596 y Ft(")p Fj(input)p
+Ft(")p Fj(output)p Ft(")g Fj(to)227 3431 y Ft(")p Fj(input)p
Ft(")p Fj(\),)26 b(eac)n(h)f(supplied)g Ft(")p Fj(output)p
Ft(")g Fj(p)r(osition)g(is)g(\014rst)g(transformed)f(b)n(y)h(the)h(in)n
-(v)n(erse)e(transformation)f(of)i(the)227 1696 y(in)n(v)n(erse)31
+(v)n(erse)e(transformation)f(of)i(the)227 3531 y(in)n(v)n(erse)31
b(selector)f(Mapping.)49 b(This)32 b(pro)r(duces)f(a)g(selector)g(v)-5
b(alue)31 b(for)g(eac)n(h)g Ft(")p Fj(output)p Ft(")h
-Fj(p)r(osition.)49 b(Again,)32 b(the)227 1796 y(nearest)g(in)n(teger)f
+Fj(p)r(osition.)49 b(Again,)32 b(the)227 3631 y(nearest)g(in)n(teger)f
(to)i(the)g(selector)e(v)-5 b(alue)32 b(is)h(found,)h(and)e(is)g(used)h
(to)f(index)h(the)g(arra)n(y)d(of)i(route)g(Mappings.)227
-1895 y(If)f(this)f(selector)g(index)g(v)-5 b(alue)30
+3730 y(If)f(this)f(selector)g(index)g(v)-5 b(alue)30
b(is)g(within)h(the)g(b)r(ounds)f(of)g(the)h(arra)n(y)d(of)i(route)f
-(Mappings,)i(then)f(the)h(in)n(v)n(erse)227 1995 y(transformation)26
+(Mappings,)i(then)f(the)h(in)n(v)n(erse)227 3830 y(transformation)26
b(of)i(the)g(selected)f(route)g(Mapping)g(is)g(used)h(to)f(transform)g
(the)h(supplied)g Ft(")p Fj(output)p Ft(")f Fj(p)r(osition)227
-2095 y(to)32 b(pro)r(duce)f(the)h(Switc)n(hMap)f Ft(")p
+3929 y(to)32 b(pro)r(duce)f(the)h(Switc)n(hMap)f Ft(")p
Fj(input)p Ft(")h Fj(p)r(osition.)49 b(If)32 b(the)g(selector)e(index)i
(v)-5 b(alue)31 b(is)h(outside)f(the)h(b)r(ounds)g(of)227
-2194 y(the)25 b(arra)n(y)e(of)h(route)g(Mappings,)h(then)g(the)g(Switc)
+4029 y(the)25 b(arra)n(y)e(of)h(route)g(Mappings,)h(then)g(the)g(Switc)
n(hMap)g Ft(")p Fj(input)p Ft(")f Fj(p)r(osition)h(is)f(set)h(to)f(a)g
-(v)-5 b(alue)25 b(of)g(AST)p Ft(__)p Fj(BAD)227 2294
-y(on)j(ev)n(ery)e(axis.)227 2418 y(In)f(practice,)f(appropriate)e
+(v)-5 b(alue)25 b(of)g(AST)p Ft(__)p Fj(BAD)227 4129
+y(on)j(ev)n(ery)e(axis.)227 4250 y(In)f(practice,)f(appropriate)e
(selector)h(Mappings)g(should)h(b)r(e)h(c)n(hosen)e(to)h(asso)r(ciate)f
-(a)g(di\013eren)n(t)h(route)g(Mapping)227 2518 y(with)30
+(a)g(di\013eren)n(t)h(route)g(Mapping)227 4350 y(with)30
b(eac)n(h)e(region)g(of)h(co)r(ordinate)f(space.)41 b(Note)30
b(that)f(the)h(SelectorMap)e(class)g(of)h(Mapping)g(is)g(particularly)
-227 2618 y(appropriate)d(for)h(this)h(purp)r(ose.)227
-2742 y(If)38 b(a)f(comp)r(ound)g(Mapping)g(con)n(tains)f(a)h(Switc)n
+227 4450 y(appropriate)d(for)h(this)h(purp)r(ose.)227
+4571 y(If)38 b(a)f(comp)r(ound)g(Mapping)g(con)n(tains)f(a)h(Switc)n
(hMap)g(in)g(series)f(with)i(its)f(o)n(wn)g(in)n(v)n(erse,)h(the)f(com)
-n(bination)227 2842 y(of)31 b(the)h(t)n(w)n(o)f(adjacen)n(t)f(Switc)n
+n(bination)227 4671 y(of)31 b(the)h(t)n(w)n(o)f(adjacen)n(t)f(Switc)n
(hMaps)h(will)h(b)r(e)f(replaced)g(b)n(y)g(a)g(UnitMap)g(when)h(the)g
-(comp)r(ound)f(Mapping)g(is)227 2941 y(simpli\014ed)d(using)g(AST)p
-Ft(_)p Fj(SIMPLIFY.)0 3091 y Fc(Constructor)k(F)-8 b(unction:)227
-3190 y Fj(AST)p Ft(_)p Fj(SWITCHMAP)-2 3339 y Fc(Inheritance)n(:)227
-3486 y Fj(The)28 b(Switc)n(hMap)f(class)g(inherits)h(from)f(the)h
-(Mapping)f(class.)-2 3635 y Fc(A)m(ttributes)n(:)227
-3781 y Fj(The)h(Switc)n(hMap)g(class)f(do)r(es)h(not)g(de\014ne)g(an)n
+(comp)r(ound)f(Mapping)g(is)227 4770 y(simpli\014ed)d(using)g(AST)p
+Ft(_)p Fj(SIMPLIFY.)0 4914 y Fc(Constructor)k(F)-8 b(unction:)227
+5014 y Fj(AST)p Ft(_)p Fj(SWITCHMAP)-2 5157 y Fc(Inheritance)n(:)227
+5304 y Fj(The)28 b(Switc)n(hMap)f(class)g(inherits)h(from)f(the)h
+(Mapping)f(class.)-2 5447 y Fc(A)m(ttributes)n(:)227
+5593 y Fj(The)h(Switc)n(hMap)g(class)f(do)r(es)h(not)g(de\014ne)g(an)n
(y)f(new)h(attributes)g(b)r(ey)n(ond)f(those)h(whic)n(h)g(are)f
-(applicable)g(to)h(all)227 3881 y(Mappings.)-2 4030 y
-Fc(F)-8 b(unctions)n(:)227 4176 y Fj(The)33 b(Switc)n(hMap)f(class)f
-(do)r(es)h(not)g(de\014ne)h(an)n(y)e(new)h(routines)g(b)r(ey)n(ond)g
-(those)g(whic)n(h)g(are)f(applicable)h(to)g(all)227 4276
-y(Mappings.)p 0 4475 3780 12 v 0 4606 a FA(T)-11 b(able)767
-b Fd(A)38 b(2-dimensional)e(table)i(of)g(v)-7 b(alues)766
-b FA(T)-11 b(able)0 4772 y Fc(Description:)44 b Fj(The)33
-b(T)-7 b(able)31 b(class)h(is)g(a)g(t)n(yp)r(e)g(of)g(KeyMap)f(that)i
-(represen)n(ts)d(a)i(t)n(w)n(o-dimensional)f(table)h(of)g(v)-5
-b(alues.)227 4871 y(The)37 b(AST)p Ft(_)p Fj(MAPGET...)65
-b(and)37 b(AST)p Ft(_)p Fj(MAPPUT...)65 b(metho)r(ds)37
-b(pro)n(vided)f(b)n(y)h(the)h(KeyMap)e(class)g(should)227
-4971 y(b)r(e)c(used)g(for)f(storing)f(and)h(retrieving)g(v)-5
+(applicable)g(to)h(all)227 5693 y(Mappings.)p eop end
+%%Page: 560 570
+TeXDict begin 560 569 bop 0 52 a FG(560)2251 b Fz(D)91
+b(AST)30 b(CLASS)f(DESCRIPTIONS)-2 351 y Fc(F)-8 b(unctions)n(:)227
+497 y Fj(The)33 b(Switc)n(hMap)f(class)f(do)r(es)h(not)g(de\014ne)h(an)
+n(y)e(new)h(routines)g(b)r(ey)n(ond)g(those)g(whic)n(h)g(are)f
+(applicable)h(to)g(all)227 597 y(Mappings.)p 0 789 3780
+12 v 0 921 a FA(T)-11 b(able)767 b Fd(A)38 b(2-dimensional)e(table)i
+(of)g(v)-7 b(alues)766 b FA(T)-11 b(able)0 1080 y Fc(Description:)44
+b Fj(The)33 b(T)-7 b(able)31 b(class)h(is)g(a)g(t)n(yp)r(e)g(of)g
+(KeyMap)f(that)i(represen)n(ts)d(a)i(t)n(w)n(o-dimensional)f(table)h
+(of)g(v)-5 b(alues.)227 1179 y(The)37 b(AST)p Ft(_)p
+Fj(MAPGET...)65 b(and)37 b(AST)p Ft(_)p Fj(MAPPUT...)65
+b(metho)r(ds)37 b(pro)n(vided)f(b)n(y)h(the)h(KeyMap)e(class)g(should)
+227 1279 y(b)r(e)c(used)g(for)f(storing)f(and)h(retrieving)g(v)-5
b(alues)31 b(from)g(individual)g(cells)h(within)g(a)f(T)-7
-b(able.)48 b(Eac)n(h)31 b(en)n(try)f(in)i(the)227 5070
+b(able.)48 b(Eac)n(h)31 b(en)n(try)f(in)i(the)227 1379
y(KeyMap)e(represen)n(ts)f(a)h(single)g(cell)h(of)f(the)h(table)g(and)f
(has)g(an)g(asso)r(ciated)g(k)n(ey)f(of)i(the)g(form)f
-Ft(")p Fl(<)p Fj(COL)p Fl(>)p Fj(\(i\))p Ft(")227 5170
+Ft(")p Fl(<)p Fj(COL)p Fl(>)p Fj(\(i\))p Ft(")227 1478
y Fj(where)c Ft(")p Fl(<)p Fj(COL)p Fl(>)p Ft(")f Fj(is)h(the)h(upp)r
(er-case)f(name)g(of)g(a)h(table)f(column)h(and)f Ft(")p
Fj(i)p Ft(")g Fj(is)g(the)h(ro)n(w)f(index)g(\(the)i(\014rst)e(ro)n(w)
-227 5270 y(is)h(ro)n(w)f(1\).)37 b(Keys)27 b(of)g(this)g(form)g(should)
+227 1578 y(is)h(ro)n(w)f(1\).)37 b(Keys)27 b(of)g(this)g(form)g(should)
g(alw)n(a)n(ys)f(b)r(e)h(used)h(when)f(using)g(KeyMap)g(metho)r(ds)g
-(to)g(access)f(en)n(tries)227 5369 y(within)j(a)e(T)-7
-b(able.)227 5494 y(Columns)37 b(m)n(ust)f(b)r(e)h(declared)f(using)g
+(to)g(access)f(en)n(tries)227 1677 y(within)j(a)e(T)-7
+b(able.)227 1800 y(Columns)37 b(m)n(ust)f(b)r(e)h(declared)f(using)g
(the)h(AST)p Ft(_)p Fj(ADDCOLUMN)h(metho)r(d)f(b)r(efore)f(v)-5
-b(alues)36 b(can)g(b)r(e)h(stored)227 5593 y(within)d(them.)52
+b(alues)36 b(can)g(b)r(e)h(stored)227 1900 y(within)d(them.)52
b(This)33 b(also)e(\014xes)i(the)g(t)n(yp)r(e)g(and)f(shap)r(e)h(of)f
(the)h(v)-5 b(alues)32 b(that)h(ma)n(y)f(b)r(e)h(stored)f(in)h(an)n(y)f
-(cell)h(of)227 5693 y(the)28 b(column.)36 b(Cells)27
+(cell)h(of)227 1999 y(the)28 b(column.)36 b(Cells)27
b(ma)n(y)f(con)n(tain)h(scalar)e(or)h(v)n(ector)g(v)-5
b(alues)27 b(of)g(an)n(y)f(data)g(t)n(yp)r(e)i(supp)r(orted)e(b)n(y)h
-(the)h(KeyMap)p eop end
-%%Page: 554 564
-TeXDict begin 554 563 bop 0 52 a FG(554)2251 b Fz(D)91
-b(AST)30 b(CLASS)f(DESCRIPTIONS)227 351 y Fj(class.)35
-b(Multi-dimensional)24 b(arra)n(ys)e(ma)n(y)i(also)f(b)r(e)i(stored,)f
-(but)h(these)g(m)n(ust)f(b)r(e)h(v)n(ectorised)e(when)i(storing)e(and)
-227 451 y(retrieving)k(them)i(within)g(a)f(table)h(cell.)39
-b(All)29 b(cells)f(within)h(a)f(single)g(column)g(m)n(ust)g(ha)n(v)n(e)
-g(the)g(same)g(t)n(yp)r(e)h(and)227 551 y(shap)r(e,)f(as)f(sp)r
-(eci\014ed)h(when)f(the)h(column)g(is)f(added)h(to)f(the)h(T)-7
-b(able.)227 684 y(T)g(ables)30 b(ma)n(y)f(ha)n(v)n(e)h(parameters)e
-(that)j(describ)r(e)e(global)h(prop)r(erties)f(of)h(the)h(en)n(tire)e
-(table.)45 b(These)30 b(are)f(stored)227 784 y(as)g(en)n(tries)g(in)h
-(the)g(paren)n(t)f(KeyMap)g(and)g(can)g(b)r(e)h(access)f(using)g(the)h
-(get)g(and)f(set)h(metho)r(d)g(of)f(the)i(KeyMap)227
-883 y(class.)44 b(Ho)n(w)n(ev)n(er,)29 b(parameters)g(m)n(ust)h(b)r(e)h
-(declared)f(using)g(the)g(AST)p Ft(_)p Fj(ADDP)-7 b(ARAMETER)31
-b(metho)r(d)g(b)r(efore)227 983 y(b)r(eing)d(accessed.)227
-1117 y(Note)f(-)f(since)h(accessing)e(en)n(tries)h(within)h(a)f(KeyMap)
+(the)h(KeyMap)227 2099 y(class.)35 b(Multi-dimensional)24
+b(arra)n(ys)e(ma)n(y)i(also)f(b)r(e)i(stored,)f(but)h(these)g(m)n(ust)f
+(b)r(e)h(v)n(ectorised)e(when)i(storing)e(and)227 2199
+y(retrieving)k(them)i(within)g(a)f(table)h(cell.)39 b(All)29
+b(cells)f(within)h(a)f(single)g(column)g(m)n(ust)g(ha)n(v)n(e)g(the)g
+(same)g(t)n(yp)r(e)h(and)227 2298 y(shap)r(e,)f(as)f(sp)r(eci\014ed)h
+(when)f(the)h(column)g(is)f(added)h(to)f(the)h(T)-7 b(able.)227
+2421 y(T)g(ables)30 b(ma)n(y)f(ha)n(v)n(e)h(parameters)e(that)j
+(describ)r(e)e(global)h(prop)r(erties)f(of)h(the)h(en)n(tire)e(table.)
+45 b(These)30 b(are)f(stored)227 2521 y(as)g(en)n(tries)g(in)h(the)g
+(paren)n(t)f(KeyMap)g(and)g(can)g(b)r(e)h(access)f(using)g(the)h(get)g
+(and)f(set)h(metho)r(d)g(of)f(the)i(KeyMap)227 2620 y(class.)44
+b(Ho)n(w)n(ev)n(er,)29 b(parameters)g(m)n(ust)h(b)r(e)h(declared)f
+(using)g(the)g(AST)p Ft(_)p Fj(ADDP)-7 b(ARAMETER)31
+b(metho)r(d)g(b)r(efore)227 2720 y(b)r(eing)d(accessed.)227
+2843 y(Note)f(-)f(since)h(accessing)e(en)n(tries)h(within)h(a)f(KeyMap)
g(is)g(a)g(relativ)n(ely)g(slo)n(w)f(pro)r(cess,)h(it)h(is)g(not)f
-(recommended)227 1216 y(to)i(use)f(the)h(T)-7 b(able)27
-b(class)g(to)h(store)e(v)n(ery)h(large)f(tables.)0 1384
-y Fc(Constructor)32 b(F)-8 b(unction:)227 1484 y Fj(AST)p
-Ft(_)p Fj(T)h(ABLE)-2 1651 y Fc(Inheritance)n(:)227 1797
+(recommended)227 2942 y(to)i(use)f(the)h(T)-7 b(able)27
+b(class)g(to)h(store)e(v)n(ery)h(large)f(tables.)0 3088
+y Fc(Constructor)32 b(F)-8 b(unction:)227 3188 y Fj(AST)p
+Ft(_)p Fj(T)h(ABLE)-2 3334 y Fc(Inheritance)n(:)227 3480
y Fj(The)28 b(T)-7 b(able)27 b(class)g(inherits)g(from)h(the)g(KeyMap)e
-(class.)-2 1965 y Fc(A)m(ttributes)n(:)227 2111 y Fj(In)36
+(class.)-2 3626 y Fc(A)m(ttributes)n(:)227 3772 y Fj(In)36
b(addition)f(to)h(those)f(attributes)g(common)g(to)g(all)h(KeyMaps,)g
(ev)n(ery)e(T)-7 b(able)35 b(also)g(has)g(the)h(follo)n(wing)e(at-)227
-2211 y(tributes:)340 2499 y Fi(\017)45 b Fj(ColumnLenC\(column\):)38
+3872 y(tributes:)340 4128 y Fi(\017)45 b Fj(ColumnLenC\(column\):)38
b(The)27 b(largest)f(string)h(length)h(of)g(an)n(y)e(v)-5
-b(alue)28 b(in)g(a)f(column)340 2641 y Fi(\017)45 b Fj
+b(alue)28 b(in)g(a)f(column)340 4257 y Fi(\017)45 b Fj
(ColumnLength\(column\):)38 b(The)27 b(n)n(um)n(b)r(er)h(of)f(elemen)n
(ts)h(in)f(eac)n(h)g(v)-5 b(alue)28 b(in)g(a)f(column)340
-2783 y Fi(\017)45 b Fj(ColumnNdim\(column\):)38 b(The)28
+4386 y Fi(\017)45 b Fj(ColumnNdim\(column\):)38 b(The)28
b(n)n(um)n(b)r(er)f(of)h(axes)f(spanned)g(b)n(y)g(eac)n(h)g(v)-5
-b(alue)27 b(in)h(a)f(column)340 2925 y Fi(\017)45 b Fj(ColumnT)n(yp)r
+b(alue)27 b(in)h(a)f(column)340 4516 y Fi(\017)45 b Fj(ColumnT)n(yp)r
(e\(column\):)37 b(The)28 b(data)f(t)n(yp)r(e)h(of)g(eac)n(h)e(v)-5
-b(alue)28 b(in)g(a)f(column)340 3067 y Fi(\017)45 b Fj
+b(alue)28 b(in)g(a)f(column)340 4645 y Fi(\017)45 b Fj
(ColumnUnit\(column\):)38 b(The)28 b(unit)g(string)f(describing)g(eac)n
-(h)g(v)-5 b(alue)27 b(in)h(a)f(column)340 3209 y Fi(\017)45
+(h)g(v)-5 b(alue)27 b(in)h(a)f(column)340 4774 y Fi(\017)45
b Fj(Ncolumn:)37 b(The)28 b(n)n(um)n(b)r(er)f(of)h(columns)f(curren)n
-(tly)g(in)h(the)g(T)-7 b(able)340 3351 y Fi(\017)45 b
+(tly)g(in)h(the)g(T)-7 b(able)340 4904 y Fi(\017)45 b
Fj(Nro)n(w:)36 b(The)28 b(n)n(um)n(b)r(er)f(of)h(ro)n(ws)e(curren)n
-(tly)g(in)i(the)g(T)-7 b(able)340 3493 y Fi(\017)45 b
+(tly)g(in)i(the)g(T)-7 b(able)340 5033 y Fi(\017)45 b
Fj(Nparameter:)36 b(The)28 b(n)n(um)n(b)r(er)f(of)g(global)g
(parameters)f(curren)n(tly)g(in)i(the)g(T)-7 b(able)-2
-3673 y Fc(F)f(unctions)n(:)227 3819 y Fj(In)24 b(addition)g(to)g(those)
+5192 y Fc(F)f(unctions)n(:)227 5338 y Fj(In)24 b(addition)g(to)g(those)
g(routines)f(applicable)h(to)g(all)f(KeyMaps,)h(the)h(follo)n(wing)e
-(routines)g(ma)n(y)g(also)g(b)r(e)i(applied)227 3918
-y(to)j(all)f(T)-7 b(ables:)340 4207 y Fi(\017)45 b Fj(AST)p
+(routines)g(ma)n(y)g(also)g(b)r(e)i(applied)227 5437
+y(to)j(all)f(T)-7 b(ables:)340 5693 y Fi(\017)45 b Fj(AST)p
Ft(_)p Fj(ADDCOLUMN:)29 b(Add)f(a)f(new)h(column)g(de\014nition)g(to)f
-(a)g(T)-7 b(able)340 4349 y Fi(\017)45 b Fj(AST)p Ft(_)p
-Fj(ADDP)-7 b(ARAMETER:)28 b(Add)h(a)e(new)g(global)g(parameter)f
-(de\014nition)i(to)g(a)f(T)-7 b(able)340 4491 y Fi(\017)45
-b Fj(AST)p Ft(_)p Fj(COLUMNNAME:)28 b(Return)g(the)g(name)f(of)h(the)g
-(column)f(with)h(a)g(giv)n(en)e(index)340 4633 y Fi(\017)45
-b Fj(AST)p Ft(_)p Fj(COLUMNSHAPE:)28 b(Return)f(the)h(shap)r(e)g(of)f
-(the)h(v)-5 b(alues)28 b(in)f(a)h(named)f(column)340
-4775 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(HASCOLUMN:)29
-b(Chec)n(ks)d(if)j(a)e(column)g(exists)h(in)f(a)h(T)-7
-b(able)340 4916 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(HASP)-7
-b(ARAMETER:)28 b(Chec)n(ks)f(if)h(a)f(global)g(parameter)f(exists)h(in)
-h(a)f(T)-7 b(able)340 5058 y Fi(\017)45 b Fj(AST)p Ft(_)p
-Fj(P)-7 b(ARAMETERNAME:)27 b(Return)h(the)g(name)g(of)f(the)h
-(parameter)e(with)i(a)g(giv)n(en)e(index)340 5200 y Fi(\017)45
-b Fj(AST)p Ft(_)p Fj(PUR)n(GER)n(O)n(WS:)27 b(Remo)n(v)n(e)f(all)h
-(empt)n(y)h(ro)n(ws)e(from)i(a)f(T)-7 b(able)340 5342
-y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(REMO)n(VECOLUMN:)27
+(a)g(T)-7 b(able)p eop end
+%%Page: 561 571
+TeXDict begin 561 570 bop 3643 52 a FG(561)340 351 y
+Fi(\017)45 b Fj(AST)p Ft(_)p Fj(ADDP)-7 b(ARAMETER:)28
+b(Add)h(a)e(new)g(global)g(parameter)f(de\014nition)i(to)g(a)f(T)-7
+b(able)340 489 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(COLUMNNAME:)28
+b(Return)g(the)g(name)f(of)h(the)g(column)f(with)h(a)g(giv)n(en)e
+(index)340 626 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(COLUMNSHAPE:)28
+b(Return)f(the)h(shap)r(e)g(of)f(the)h(v)-5 b(alues)28
+b(in)f(a)h(named)f(column)340 764 y Fi(\017)45 b Fj(AST)p
+Ft(_)p Fj(HASCOLUMN:)29 b(Chec)n(ks)d(if)j(a)e(column)g(exists)h(in)f
+(a)h(T)-7 b(able)340 901 y Fi(\017)45 b Fj(AST)p Ft(_)p
+Fj(HASP)-7 b(ARAMETER:)28 b(Chec)n(ks)f(if)h(a)f(global)g(parameter)f
+(exists)h(in)h(a)f(T)-7 b(able)340 1039 y Fi(\017)45
+b Fj(AST)p Ft(_)p Fj(P)-7 b(ARAMETERNAME:)27 b(Return)h(the)g(name)g
+(of)f(the)h(parameter)e(with)i(a)g(giv)n(en)e(index)340
+1176 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(PUR)n(GER)n(O)n(WS:)27
+b(Remo)n(v)n(e)f(all)h(empt)n(y)h(ro)n(ws)e(from)i(a)f(T)-7
+b(able)340 1314 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(REMO)n(VECOLUMN:)27
b(Remo)n(v)n(e)f(a)h(column)h(from)f(a)g(T)-7 b(able)340
-5484 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(REMO)n(VEP)-7
+1451 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(REMO)n(VEP)-7
b(ARAMETER:)26 b(Remo)n(v)n(e)h(a)g(global)f(parameter)g(from)i(a)f(T)
--7 b(able)340 5626 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(REMO)n(VER)n(O)n
+-7 b(able)340 1588 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(REMO)n(VER)n(O)n
(W:)26 b(Remo)n(v)n(e)h(a)g(ro)n(w)f(from)h(a)h(T)-7
-b(able)p eop end
-%%Page: 555 565
-TeXDict begin 555 564 bop 3643 52 a FG(555)p 0 351 3780
-12 v 0 483 a FA(TimeF)-11 b(rame)304 b Fd(Time)38 b(co)s(ordinate)e
-(system)j(description)301 b FA(TimeF)-11 b(rame)0 698
-y Fc(Description:)44 b Fj(A)37 b(TimeF)-7 b(rame)35 b(is)h(a)f(sp)r
-(ecialised)h(form)f(of)h(one-dimensional)e(F)-7 b(rame)36
-b(whic)n(h)f(represen)n(ts)g(v)-5 b(arious)227 798 y(co)r(ordinate)27
-b(systems)g(used)g(to)h(describ)r(e)f(p)r(ositions)g(in)h(time.)227
-936 y(A)23 b(TimeF)-7 b(rame)21 b(represen)n(ts)g(a)g(momen)n(t)h(in)g
-(time)h(as)e(either)h(an)f(Mo)r(di\014ed)i(Julian)e(Date)h(\(MJD\),)h
-(a)f(Julian)f(Date)227 1036 y(\(JD\),)f(a)f(Besselian)e(ep)r(o)r(c)n(h)
-i(or)f(a)h(Julian)g(ep)r(o)r(c)n(h,)h(as)f(determined)g(b)n(y)f(the)i
-(System)f(attribute.)34 b(Optionally)-7 b(,)20 b(a)f(zero)227
-1135 y(p)r(oin)n(t)30 b(can)g(b)r(e)g(sp)r(eci\014ed)h(\(using)e
-(attribute)i(TimeOrigin\))e(whic)n(h)h(results)f(in)h(the)h(TimeF)-7
-b(rame)29 b(represen)n(ting)227 1235 y(time)f(o\013sets)g(from)f(the)h
-(sp)r(eci\014ed)g(zero)e(p)r(oin)n(t.)227 1373 y(Ev)n(en)g(though)g(JD)
-g(and)g(MJD)g(are)g(de\014ned)g(as)g(b)r(eing)g(in)g(units)h(of)f(da)n
-(ys,)g(the)g(TimeF)-7 b(rame)26 b(class)f(allo)n(ws)g(other)227
-1472 y(units)31 b(to)g(b)r(e)g(used)f(\(via)h(the)g(Unit)g(attribute\))
-g(on)f(the)h(basis)f(of)h(simple)g(scalings)e(\(60)h(seconds)g(=)g(1)g
-(min)n(ute,)227 1572 y(60)i(min)n(utes)h(=)f(1)h(hour,)g(24)f(hours)g
-(=)g(1)g(da)n(y)-7 b(,)33 b(365.25)e(da)n(ys)h(=)g(1)g(y)n(ear\).)51
+b(able)p 0 1797 3780 12 v 0 1929 a FA(TimeF)c(rame)304
+b Fd(Time)38 b(co)s(ordinate)e(system)j(description)301
+b FA(TimeF)-11 b(rame)0 2127 y Fc(Description:)44 b Fj(A)37
+b(TimeF)-7 b(rame)35 b(is)h(a)f(sp)r(ecialised)h(form)f(of)h
+(one-dimensional)e(F)-7 b(rame)36 b(whic)n(h)f(represen)n(ts)g(v)-5
+b(arious)227 2226 y(co)r(ordinate)27 b(systems)g(used)g(to)h(describ)r
+(e)f(p)r(ositions)g(in)h(time.)227 2356 y(A)23 b(TimeF)-7
+b(rame)21 b(represen)n(ts)g(a)g(momen)n(t)h(in)g(time)h(as)e(either)h
+(an)f(Mo)r(di\014ed)i(Julian)e(Date)h(\(MJD\),)h(a)f(Julian)f(Date)227
+2455 y(\(JD\),)f(a)f(Besselian)e(ep)r(o)r(c)n(h)i(or)f(a)h(Julian)g(ep)
+r(o)r(c)n(h,)h(as)f(determined)g(b)n(y)f(the)i(System)f(attribute.)34
+b(Optionally)-7 b(,)20 b(a)f(zero)227 2555 y(p)r(oin)n(t)30
+b(can)g(b)r(e)g(sp)r(eci\014ed)h(\(using)e(attribute)i(TimeOrigin\))e
+(whic)n(h)h(results)f(in)h(the)h(TimeF)-7 b(rame)29 b(represen)n(ting)
+227 2654 y(time)f(o\013sets)g(from)f(the)h(sp)r(eci\014ed)g(zero)e(p)r
+(oin)n(t.)227 2784 y(Ev)n(en)g(though)g(JD)g(and)g(MJD)g(are)g
+(de\014ned)g(as)g(b)r(eing)g(in)g(units)h(of)f(da)n(ys,)g(the)g(TimeF)
+-7 b(rame)26 b(class)f(allo)n(ws)g(other)227 2883 y(units)31
+b(to)g(b)r(e)g(used)f(\(via)h(the)g(Unit)g(attribute\))g(on)f(the)h
+(basis)f(of)h(simple)g(scalings)e(\(60)h(seconds)g(=)g(1)g(min)n(ute,)
+227 2983 y(60)i(min)n(utes)h(=)f(1)h(hour,)g(24)f(hours)g(=)g(1)g(da)n
+(y)-7 b(,)33 b(365.25)e(da)n(ys)h(=)g(1)g(y)n(ear\).)51
b(Lik)n(ewise,)33 b(Julian)g(ep)r(o)r(c)n(hs)f(can)g(b)r(e)227
-1671 y(describ)r(ed)f(in)f(units)h(other)f(than)h(the)g(usual)f(y)n
+3082 y(describ)r(ed)f(in)f(units)h(other)f(than)h(the)g(usual)f(y)n
(ears.)44 b(Besselian)29 b(ep)r(o)r(c)n(h)i(are)e(alw)n(a)n(ys)g
-(represen)n(ted)g(in)i(units)g(of)227 1771 y(\(tropical\))c(y)n(ears.)
-227 1909 y(The)33 b(TimeScale)e(attribute)i(allo)n(ws)e(the)h(time)h
+(represen)n(ted)g(in)i(units)g(of)227 3182 y(\(tropical\))c(y)n(ears.)
+227 3311 y(The)33 b(TimeScale)e(attribute)i(allo)n(ws)e(the)h(time)h
(scale)e(to)h(b)r(e)h(sp)r(eci\014ed)g(\(that)f(is,)i(the)e(ph)n
-(ysical)g(pro)r(cess)f(used)227 2009 y(to)e(de\014ne)g(the)g(rate)f(of)
+(ysical)g(pro)r(cess)f(used)227 3411 y(to)e(de\014ne)g(the)g(rate)f(of)
g(\015o)n(w)g(of)h(time\).)41 b(MJD,)29 b(JD)g(and)f(Julian)g(ep)r(o)r
(c)n(h)h(can)f(b)r(e)h(used)g(to)f(represen)n(t)g(a)g(time)h(in)227
-2108 y(an)n(y)d(supp)r(orted)h(time)g(scale.)36 b(Ho)n(w)n(ev)n(er,)25
+3511 y(an)n(y)d(supp)r(orted)h(time)g(scale.)36 b(Ho)n(w)n(ev)n(er,)25
b(Besselian)h(ep)r(o)r(c)n(h)g(ma)n(y)g(only)h(b)r(e)g(used)g(with)g
(the)g Ft(")p Fj(TT)p Ft(")f Fj(\(T)-7 b(errestrial)227
-2208 y(Time\))39 b(time)g(scale.)70 b(The)38 b(list)h(of)g(supp)r
+3610 y(Time\))39 b(time)g(scale.)70 b(The)38 b(list)h(of)g(supp)r
(orted)f(time)h(scales)f(includes)h(univ)n(ersal)e(time)i(and)f
-(siderial)g(time.)227 2307 y(Strictly)-7 b(,)30 b(these)g(represen)n(t)
+(siderial)g(time.)227 3710 y(Strictly)-7 b(,)30 b(these)g(represen)n(t)
e(angles)g(rather)g(than)i(time)f(scales,)g(but)h(are)e(included)i(in)g
-(the)f(list)h(since)f(they)h(are)227 2407 y(in)e(common)f(use)h(and)f
+(the)f(list)h(since)f(they)h(are)227 3809 y(in)e(common)f(use)h(and)f
(are)g(often)h(though)n(t)f(of)g(as)g(time)h(scales.)227
-2545 y(When)h(a)e(time)h(v)-5 b(alue)28 b(is)f(formatted)h(it)g(can)f
+3939 y(When)h(a)e(time)h(v)-5 b(alue)28 b(is)f(formatted)h(it)g(can)f
(b)r(e)h(formated)g(either)f(as)g(a)h(simple)g(\015oating)e(p)r(oin)n
-(t)i(v)-5 b(alue,)28 b(or)f(as)g(a)227 2645 y(Gregorian)f(date)h(\(see)
-h(the)g(F)-7 b(ormat)27 b(attribute\).)0 2821 y Fc(Constructor)32
-b(F)-8 b(unction:)227 2920 y Fj(AST)p Ft(_)p Fj(TIMEFRAME)-2
-3096 y Fc(Inheritance)n(:)227 3242 y Fj(The)28 b(TimeF)-7
+(t)i(v)-5 b(alue,)28 b(or)f(as)g(a)227 4038 y(Gregorian)f(date)h(\(see)
+h(the)g(F)-7 b(ormat)27 b(attribute\).)0 4197 y Fc(Constructor)32
+b(F)-8 b(unction:)227 4297 y Fj(AST)p Ft(_)p Fj(TIMEFRAME)-2
+4455 y Fc(Inheritance)n(:)227 4601 y Fj(The)28 b(TimeF)-7
b(rame)27 b(class)g(inherits)g(from)g(the)h(F)-7 b(rame)28
-b(class.)-2 3419 y Fc(A)m(ttributes)n(:)227 3565 y Fj(In)36
+b(class.)-2 4760 y Fc(A)m(ttributes)n(:)227 4906 y Fj(In)36
b(addition)g(to)f(those)h(attributes)f(common)g(to)h(all)f(F)-7
b(rames,)37 b(ev)n(ery)e(TimeF)-7 b(rame)35 b(also)f(has)i(the)g(follo)
-n(wing)227 3664 y(attributes:)340 3965 y Fi(\017)45 b
+n(wing)227 5006 y(attributes:)340 5281 y Fi(\017)45 b
Fj(AlignTimeScale:)37 b(Time)28 b(scale)e(in)i(whic)n(h)g(to)f(align)g
-(TimeF)-7 b(rames)340 4111 y Fi(\017)45 b Fj(L)-7 b(TO\013set:)37
+(TimeF)-7 b(rames)340 5418 y Fi(\017)45 b Fj(L)-7 b(TO\013set:)37
b(The)28 b(o\013set)f(of)h(Lo)r(cal)f(Time)g(from)h(UTC,)g(in)g(hours.)
-340 4257 y Fi(\017)45 b Fj(TimeOrigin:)36 b(The)28 b(zero)e(p)r(oin)n
+340 5556 y Fi(\017)45 b Fj(TimeOrigin:)36 b(The)28 b(zero)e(p)r(oin)n
(t)i(for)f(TimeF)-7 b(rame)27 b(axis)g(v)-5 b(alues)340
-4404 y Fi(\017)45 b Fj(TimeScale:)37 b(The)27 b(timescale)h(used)f(b)n
-(y)h(the)g(TimeF)-7 b(rame)227 4592 y(Sev)n(eral)33 b(of)i(the)g(F)-7
-b(rame)34 b(attributes)h(inherited)f(b)n(y)h(the)g(TimeF)-7
+5693 y Fi(\017)45 b Fj(TimeScale:)37 b(The)27 b(timescale)h(used)f(b)n
+(y)h(the)g(TimeF)-7 b(rame)p eop end
+%%Page: 562 572
+TeXDict begin 562 571 bop 0 52 a FG(562)2251 b Fz(D)91
+b(AST)30 b(CLASS)f(DESCRIPTIONS)227 351 y Fj(Sev)n(eral)k(of)i(the)g(F)
+-7 b(rame)34 b(attributes)h(inherited)f(b)n(y)h(the)g(TimeF)-7
b(rame)34 b(class)g(refer)f(to)i(a)f(sp)r(eci\014c)h(axis)f(of)g(the)
-227 4692 y(F)-7 b(rame)30 b(\(for)g(instance)g(Unit\(axis\),)h(Lab)r
+227 451 y(F)-7 b(rame)30 b(\(for)g(instance)g(Unit\(axis\),)h(Lab)r
(el\(axis\),)g(etc\).)45 b(Since)30 b(a)g(TimeF)-7 b(rame)30
-b(is)g(strictly)g(one-dimensional,)227 4791 y(it)f(allo)n(ws)e(these)h
+b(is)g(strictly)g(one-dimensional,)227 551 y(it)f(allo)n(ws)e(these)h
(attributes)g(to)g(b)r(e)g(sp)r(eci\014ed)g(without)h(an)f(axis)f
(index.)39 b(So)27 b(for)h(instance,)g Ft(")p Fj(Unit)p
-Ft(")g Fj(is)g(allo)n(w)n(ed)227 4891 y(in)g(place)f(of)h
-Ft(")p Fj(Unit\(1\))p Ft(")p Fj(.)-2 5067 y Fc(F)-8 b(unctions)n(:)227
-5213 y Fj(In)30 b(addition)f(to)h(those)f(routines)g(applicable)g(to)g
+Ft(")g Fj(is)g(allo)n(w)n(ed)227 650 y(in)g(place)f(of)h
+Ft(")p Fj(Unit\(1\))p Ft(")p Fj(.)-2 796 y Fc(F)-8 b(unctions)n(:)227
+943 y Fj(In)30 b(addition)f(to)h(those)f(routines)g(applicable)g(to)g
(all)g(F)-7 b(rames,)29 b(the)h(follo)n(wing)f(routines)g(ma)n(y)f
-(also)h(b)r(e)h(applied)227 5313 y(to)e(all)f(TimeF)-7
-b(rames:)340 5614 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(CURRENTTIME:)28
-b(Return)f(the)h(curren)n(t)f(system)g(time)p eop end
-%%Page: 556 566
-TeXDict begin 556 565 bop 0 52 a FG(556)2251 b Fz(D)91
-b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 483
-a FA(TimeMap)290 b Fd(Sequence)39 b(of)f(time)g(co)s(ordinate)e(con)m
-(v)m(ersions)288 b FA(TimeMap)0 666 y Fc(Description:)44
-b Fj(A)22 b(TimeMap)e(is)h(a)f(sp)r(ecialised)h(form)f(of)h
-(1-dimensional)e(Mapping)i(whic)n(h)g(can)f(b)r(e)h(used)g(to)g
-(represen)n(t)227 765 y(a)27 b(sequence)h(of)f(con)n(v)n(ersions)e(b)r
-(et)n(w)n(een)j(standard)e(time)i(co)r(ordinate)f(systems.)227
-888 y(When)19 b(a)f(TimeMap)g(is)h(\014rst)f(created,)h(it)g(simply)g
+(also)h(b)r(e)h(applied)227 1042 y(to)e(all)f(TimeF)-7
+b(rames:)340 1298 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(CURRENTTIME:)28
+b(Return)f(the)h(curren)n(t)f(system)g(time)p 0 1491
+3780 12 v 0 1623 a FA(TimeMap)290 b Fd(Sequence)39 b(of)f(time)g(co)s
+(ordinate)e(con)m(v)m(ersions)288 b FA(TimeMap)0 1805
+y Fc(Description:)44 b Fj(A)22 b(TimeMap)e(is)h(a)f(sp)r(ecialised)h
+(form)f(of)h(1-dimensional)e(Mapping)i(whic)n(h)g(can)f(b)r(e)h(used)g
+(to)g(represen)n(t)227 1905 y(a)27 b(sequence)h(of)f(con)n(v)n(ersions)
+e(b)r(et)n(w)n(een)j(standard)e(time)i(co)r(ordinate)f(systems.)227
+2028 y(When)19 b(a)f(TimeMap)g(is)h(\014rst)f(created,)h(it)g(simply)g
(p)r(erforms)e(a)h(unit)h(\(n)n(ull\))g(Mapping.)34 b(Using)18
-b(the)h(AST)p Ft(_)p Fj(TIMEADD)227 988 y(routine,)35
+b(the)h(AST)p Ft(_)p Fj(TIMEADD)227 2128 y(routine,)35
b(a)e(series)f(of)h(co)r(ordinate)f(con)n(v)n(ersion)f(steps)i(ma)n(y)g
(then)h(b)r(e)g(added.)54 b(This)33 b(allo)n(ws)f(m)n(ulti-step)h(con-)
-227 1087 y(v)n(ersions)i(b)r(et)n(w)n(een)h(a)g(v)-5
+227 2227 y(v)n(ersions)i(b)r(et)n(w)n(een)h(a)g(v)-5
b(ariet)n(y)35 b(of)h(time)h(co)r(ordinate)e(systems)g(to)h(b)r(e)h
(assem)n(bled)e(out)h(of)g(a)g(set)g(of)g(building)227
-1187 y(blo)r(c)n(ks.)227 1310 y(F)-7 b(or)18 b(details)g(of)g(the)h
+2327 y(blo)r(c)n(ks.)227 2450 y(F)-7 b(or)18 b(details)g(of)g(the)h
(individual)g(co)r(ordinate)e(con)n(v)n(ersions)f(a)n(v)-5
b(ailable,)19 b(see)f(the)h(description)e(of)i(the)f(AST)p
-Ft(_)p Fj(TIMEADD)227 1410 y(routine.)0 1556 y Fc(Constructor)32
-b(F)-8 b(unction:)227 1656 y Fj(AST)p Ft(_)p Fj(TIMEMAP)27
-b(\(also)g(see)g(AST)p Ft(_)p Fj(TIMEADD\))-2 1802 y
-Fc(Inheritance)n(:)227 1948 y Fj(The)h(TimeMap)f(class)g(inherits)h
-(from)f(the)h(Mapping)f(class.)-2 2094 y Fc(A)m(ttributes)n(:)227
-2240 y Fj(The)32 b(TimeMap)f(class)g(do)r(es)g(not)g(de\014ne)h(an)n(y)
+Ft(_)p Fj(TIMEADD)227 2549 y(routine.)0 2696 y Fc(Constructor)32
+b(F)-8 b(unction:)227 2795 y Fj(AST)p Ft(_)p Fj(TIMEMAP)27
+b(\(also)g(see)g(AST)p Ft(_)p Fj(TIMEADD\))-2 2942 y
+Fc(Inheritance)n(:)227 3088 y Fj(The)h(TimeMap)f(class)g(inherits)h
+(from)f(the)h(Mapping)f(class.)-2 3234 y Fc(A)m(ttributes)n(:)227
+3380 y Fj(The)32 b(TimeMap)f(class)g(do)r(es)g(not)g(de\014ne)h(an)n(y)
f(new)g(attributes)h(b)r(ey)n(ond)f(those)g(whic)n(h)g(are)g
-(applicable)g(to)g(all)227 2340 y(Mappings.)-2 2486 y
-Fc(F)-8 b(unctions)n(:)227 2632 y Fj(In)26 b(addition)f(to)h(those)f
+(applicable)g(to)g(all)227 3480 y(Mappings.)-2 3626 y
+Fc(F)-8 b(unctions)n(:)227 3772 y Fj(In)26 b(addition)f(to)h(those)f
(routines)g(applicable)f(to)i(all)f(Mappings,)g(the)h(follo)n(wing)f
-(routine)g(ma)n(y)f(also)h(b)r(e)h(applied)227 2732 y(to)i(all)f
-(TimeMaps:)340 2988 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(TIMEADD:)29
+(routine)g(ma)n(y)f(also)h(b)r(e)h(applied)227 3872 y(to)i(all)f
+(TimeMaps:)340 4128 y Fi(\017)45 b Fj(AST)p Ft(_)p Fj(TIMEADD:)29
b(Add)f(a)f(time)h(co)r(ordinate)e(con)n(v)n(ersion)g(to)h(an)h
-(TimeMap)p 0 3181 V 0 3312 a FA(T)-11 b(ranMap)772 3313
+(TimeMap)p 0 4321 V 0 4452 a FA(T)-11 b(ranMap)772 4453
y Fd(Mapping)38 b(with)g(sp)s(eci\014ed)h(forw)m(ard)d(and)j(in)m(v)m
-(erse)1488 3428 y(transformations)3234 3312 y FA(T)-11
-b(ranMap)0 3587 y Fc(Description:)44 b Fj(A)27 b(T)-7
+(erse)1488 4567 y(transformations)3234 4452 y FA(T)-11
+b(ranMap)0 4726 y Fc(Description:)44 b Fj(A)27 b(T)-7
b(ranMap)25 b(is)h(a)f(Mapping)h(whic)n(h)g(com)n(bines)f(the)i(forw)n
(ard)d(transformation)g(of)i(a)g(supplied)g(Map-)227
-3687 y(ping)i(with)h(the)g(in)n(v)n(erse)e(transformation)f(of)j
+4826 y(ping)i(with)h(the)g(in)n(v)n(erse)e(transformation)f(of)j
(another)e(supplied)i(Mapping,)f(ignoring)e(the)j(un-used)f(transfor-)
-227 3786 y(mation)g(in)f(eac)n(h)g(Mapping)h(\(indeed)g(the)g(un-used)f
-(transformation)f(need)i(not)f(exist\).)227 3909 y(When)h(the)f(forw)n
+227 4926 y(mation)g(in)f(eac)n(h)g(Mapping)h(\(indeed)g(the)g(un-used)f
+(transformation)f(need)i(not)f(exist\).)227 5049 y(When)h(the)f(forw)n
(ard)e(transformation)h(of)h(the)g(T)-7 b(ranMap)26 b(is)h(referred)f
-(to,)h(the)g(transformation)e(actually)i(used)227 4009
+(to,)h(the)g(transformation)e(actually)i(used)227 5148
y(is)k(the)g(forw)n(ard)e(transformation)h(of)g(the)i(\014rst)e
(Mapping)h(supplied)g(when)g(the)g(T)-7 b(ranMap)30 b(w)n(as)g
-(constructed.)227 4108 y(Lik)n(ewise,)j(when)f(the)h(in)n(v)n(erse)d
+(constructed.)227 5248 y(Lik)n(ewise,)j(when)f(the)h(in)n(v)n(erse)d
(transformation)h(of)h(the)h(T)-7 b(ranMap)31 b(is)h(referred)f(to,)i
-(the)g(transformation)d(ac-)227 4208 y(tually)f(used)g(is)g(the)g(in)n
+(the)g(transformation)d(ac-)227 5347 y(tually)f(used)g(is)g(the)g(in)n
(v)n(erse)f(transformation)f(of)i(the)h(second)e(Mapping)h(supplied)g
-(when)g(the)h(T)-7 b(ranMap)28 b(w)n(as)227 4308 y(constructed.)0
-4454 y Fc(Constructor)k(F)-8 b(unction:)227 4554 y Fj(AST)p
-Ft(_)p Fj(TRANMAP)-2 4700 y Fc(Inheritance)n(:)227 4846
-y Fj(The)28 b(T)-7 b(ranMap)27 b(class)f(inherits)i(from)f(the)h
-(Mapping)f(class.)-2 4992 y Fc(A)m(ttributes)n(:)227
-5138 y Fj(The)33 b(T)-7 b(ranMap)31 b(class)h(do)r(es)g(not)h(de\014ne)
-f(an)n(y)g(new)h(attributes)f(b)r(ey)n(ond)g(those)h(whic)n(h)f(are)g
-(applicable)f(to)i(all)227 5238 y(Mappings.)-2 5384 y
-Fc(F)-8 b(unctions)n(:)227 5531 y Fj(The)37 b(T)-7 b(ranMap)36
+(when)g(the)h(T)-7 b(ranMap)28 b(w)n(as)227 5447 y(constructed.)0
+5593 y Fc(Constructor)k(F)-8 b(unction:)227 5693 y Fj(AST)p
+Ft(_)p Fj(TRANMAP)p eop end
+%%Page: 563 573
+TeXDict begin 563 572 bop 3643 52 a FG(563)-2 351 y Fc(Inheritance)n(:)
+227 497 y Fj(The)28 b(T)-7 b(ranMap)27 b(class)f(inherits)i(from)f(the)
+h(Mapping)f(class.)-2 645 y Fc(A)m(ttributes)n(:)227
+791 y Fj(The)33 b(T)-7 b(ranMap)31 b(class)h(do)r(es)g(not)h(de\014ne)f
+(an)n(y)g(new)h(attributes)f(b)r(ey)n(ond)g(those)h(whic)n(h)f(are)g
+(applicable)f(to)i(all)227 891 y(Mappings.)-2 1038 y
+Fc(F)-8 b(unctions)n(:)227 1184 y Fj(The)37 b(T)-7 b(ranMap)36
b(class)g(do)r(es)g(not)h(de\014ne)g(an)n(y)f(new)h(routines)f(b)r(ey)n
(ond)h(those)f(whic)n(h)h(are)f(applicable)g(to)h(all)227
-5630 y(Mappings.)p eop end
-%%Page: 557 567
-TeXDict begin 557 566 bop 3643 52 a FG(557)p 0 351 3780
-12 v 0 483 a FA(UnitMap)1368 490 y Fd(Unit)38 b(\(n)m(ull\))f(Mapping)
-3244 483 y FA(UnitMap)0 679 y Fc(Description:)44 b Fj(A)36
-b(UnitMap)g(is)f(a)g(unit)g(\(n)n(ull\))h(Mapping)f(that)h(has)e(no)h
-(e\013ect)h(on)f(the)g(co)r(ordinates)f(supplied)i(to)227
-779 y(it.)47 b(They)31 b(are)f(simply)h(copied.)46 b(This)31
-b(can)f(b)r(e)i(useful)f(if)g(a)g(Mapping)f(is)h(required)f(\(e.g.)46
-b(to)31 b(pass)f(to)h(another)227 879 y(routine\))26
-b(but)g(y)n(ou)e(do)h(not)h(w)n(an)n(t)f(it)h(to)f(ha)n(v)n(e)f(an)n(y)
-h(e\013ect.)36 b(The)26 b(Nin)g(and)f(Nout)h(attributes)f(of)h(a)f
-(UnitMap)h(are)227 978 y(alw)n(a)n(ys)g(equal)h(and)g(are)g(sp)r
-(eci\014ed)h(when)g(it)g(is)f(created.)0 1123 y Fc(Constructor)32
-b(F)-8 b(unction:)227 1222 y Fj(AST)p Ft(_)p Fj(UNITMAP)-2
-1366 y Fc(Inheritance)n(:)227 1513 y Fj(The)28 b(UnitMap)g(class)f
-(inherits)g(from)g(the)h(Mapping)g(class.)-2 1657 y Fc(A)m(ttributes)n
-(:)227 1803 y Fj(The)33 b(UnitMap)h(class)e(do)r(es)h(not)g(de\014ne)h
-(an)n(y)e(new)h(attributes)g(b)r(ey)n(ond)g(those)g(whic)n(h)g(are)f
-(applicable)h(to)g(all)227 1903 y(Mappings.)-2 2047 y
-Fc(F)-8 b(unctions)n(:)227 2193 y Fj(The)38 b(UnitMap)g(class)e(do)r
-(es)h(not)h(de\014ne)g(an)n(y)e(new)i(routines)f(b)r(ey)n(ond)g(those)g
-(whic)n(h)g(are)g(applicable)g(to)g(all)227 2293 y(Mappings.)p
-0 2482 V 0 2612 a FA(WcsMap)879 2613 y Fd(Implemen)m(t)g(a)i(FITS-W)m
-(CS)g(sky)f(pro)7 b(jection)3260 2612 y FA(WcsMap)0 2792
-y Fc(Description:)44 b Fj(This)28 b(class)e(is)i(used)f(to)g(represen)n
-(t)g(sky)g(co)r(ordinate)f(pro)5 b(jections)26 b(as)h(describ)r(ed)g
-(in)h(the)g(FITS)g(w)n(orld)227 2891 y(co)r(ordinate)k(system)g
-(\(FITS-W)n(CS\))i(pap)r(er)e(I)r(I)h Ft(")p Fj(Represen)n(tations)e
-(of)i(Celestial)f(Co)r(ordinates)f(in)i(FITS)p Ft(")g
-Fj(b)n(y)227 2991 y(M.)c(Calabretta)f(and)g(E.W.)h(Griesen.)40
-b(This)29 b(pap)r(er)f(de\014nes)h(a)f(set)h(of)f(functions,)i(or)e
-(sky)g(pro)5 b(jections,)28 b(whic)n(h)227 3091 y(transform)33
-b(longitude-latitude)g(pairs)g(represen)n(ting)f(spherical)h(celestial)
-g(co)r(ordinates)f(in)n(to)i(corresp)r(onding)227 3190
-y(pairs)27 b(of)g(Cartesian)g(co)r(ordinates)f(\(and)i(vice)f(v)n
-(ersa\).)227 3312 y(A)k(WcsMap)f(is)g(a)g(sp)r(ecialised)g(form)g(of)g
-(Mapping)g(whic)n(h)g(implemen)n(ts)h(these)f(sky)g(pro)5
-b(jections)29 b(and)h(applies)227 3412 y(them)25 b(to)g(a)f(sp)r
+1284 y(Mappings.)p 0 1479 3780 12 v 0 1611 a FA(UnitMap)1368
+1617 y Fd(Unit)h(\(n)m(ull\))f(Mapping)3244 1611 y FA(UnitMap)0
+1814 y Fc(Description:)44 b Fj(A)36 b(UnitMap)g(is)f(a)g(unit)g(\(n)n
+(ull\))h(Mapping)f(that)h(has)e(no)h(e\013ect)h(on)f(the)g(co)r
+(ordinates)f(supplied)i(to)227 1913 y(it.)47 b(They)31
+b(are)f(simply)h(copied.)46 b(This)31 b(can)f(b)r(e)i(useful)f(if)g(a)g
+(Mapping)f(is)h(required)f(\(e.g.)46 b(to)31 b(pass)f(to)h(another)227
+2013 y(routine\))26 b(but)g(y)n(ou)e(do)h(not)h(w)n(an)n(t)f(it)h(to)f
+(ha)n(v)n(e)f(an)n(y)h(e\013ect.)36 b(The)26 b(Nin)g(and)f(Nout)h
+(attributes)f(of)h(a)f(UnitMap)h(are)227 2112 y(alw)n(a)n(ys)g(equal)h
+(and)g(are)g(sp)r(eci\014ed)h(when)g(it)g(is)f(created.)0
+2260 y Fc(Constructor)32 b(F)-8 b(unction:)227 2360 y
+Fj(AST)p Ft(_)p Fj(UNITMAP)-2 2507 y Fc(Inheritance)n(:)227
+2653 y Fj(The)28 b(UnitMap)g(class)f(inherits)g(from)g(the)h(Mapping)g
+(class.)-2 2801 y Fc(A)m(ttributes)n(:)227 2947 y Fj(The)33
+b(UnitMap)h(class)e(do)r(es)h(not)g(de\014ne)h(an)n(y)e(new)h
+(attributes)g(b)r(ey)n(ond)g(those)g(whic)n(h)g(are)f(applicable)h(to)g
+(all)227 3046 y(Mappings.)-2 3194 y Fc(F)-8 b(unctions)n(:)227
+3340 y Fj(The)38 b(UnitMap)g(class)e(do)r(es)h(not)h(de\014ne)g(an)n(y)
+e(new)i(routines)f(b)r(ey)n(ond)g(those)g(whic)n(h)g(are)g(applicable)g
+(to)g(all)227 3440 y(Mappings.)p 0 3635 V 0 3766 a FA(WcsMap)879
+3767 y Fd(Implemen)m(t)g(a)i(FITS-W)m(CS)g(sky)f(pro)7
+b(jection)3260 3766 y FA(WcsMap)0 3952 y Fc(Description:)44
+b Fj(This)28 b(class)e(is)i(used)f(to)g(represen)n(t)g(sky)g(co)r
+(ordinate)f(pro)5 b(jections)26 b(as)h(describ)r(ed)g(in)h(the)g(FITS)g
+(w)n(orld)227 4051 y(co)r(ordinate)k(system)g(\(FITS-W)n(CS\))i(pap)r
+(er)e(I)r(I)h Ft(")p Fj(Represen)n(tations)e(of)i(Celestial)f(Co)r
+(ordinates)f(in)i(FITS)p Ft(")g Fj(b)n(y)227 4151 y(M.)c(Calabretta)f
+(and)g(E.W.)h(Griesen.)40 b(This)29 b(pap)r(er)f(de\014nes)h(a)f(set)h
+(of)f(functions,)i(or)e(sky)g(pro)5 b(jections,)28 b(whic)n(h)227
+4250 y(transform)33 b(longitude-latitude)g(pairs)g(represen)n(ting)f
+(spherical)h(celestial)g(co)r(ordinates)f(in)n(to)i(corresp)r(onding)
+227 4350 y(pairs)27 b(of)g(Cartesian)g(co)r(ordinates)f(\(and)i(vice)f
+(v)n(ersa\).)227 4474 y(A)k(WcsMap)f(is)g(a)g(sp)r(ecialised)g(form)g
+(of)g(Mapping)g(whic)n(h)g(implemen)n(ts)h(these)f(sky)g(pro)5
+b(jections)29 b(and)h(applies)227 4573 y(them)25 b(to)g(a)f(sp)r
(eci\014ed)h(pair)f(of)g(co)r(ordinates.)35 b(All)25
b(the)g(pro)5 b(jections)23 b(in)i(the)g(FITS-W)n(CS)g(pap)r(er)f(are)g
-(supp)r(orted,)227 3512 y(plus)32 b(the)f(no)n(w)g(deprecated)f
+(supp)r(orted,)227 4673 y(plus)32 b(the)f(no)n(w)g(deprecated)f
Ft(")p Fj(T)-7 b(AN)32 b(with)f(p)r(olynomial)g(correction)e(terms)p
Ft(")i Fj(pro)5 b(jection)30 b(whic)n(h)h(is)g(refered)g(to)227
-3611 y(here)22 b(b)n(y)g(the)g(co)r(de)g Ft(")p Fj(TPN)p
+4772 y(here)22 b(b)n(y)g(the)g(co)r(de)g Ft(")p Fj(TPN)p
Ft(")p Fj(.)34 b(Using)22 b(the)g(FITS-W)n(CS)g(terminology)-7
b(,)22 b(the)g(transformation)f(is)h(b)r(et)n(w)n(een)g
-Ft(")p Fj(nativ)n(e)227 3711 y(spherical)p Ft(")e Fj(and)h
+Ft(")p Fj(nativ)n(e)227 4872 y(spherical)p Ft(")e Fj(and)h
Ft(")p Fj(pro)5 b(jection)19 b(plane)p Ft(")i Fj(co)r(ordinates)e
(\(also)h(called)h Ft(")p Fj(in)n(termediate)f(w)n(orld)g(co)r
-(ordinates)p Ft(")p Fj(.)33 b(These)227 3810 y(co)r(ordinates)20
+(ordinates)p Ft(")p Fj(.)33 b(These)227 4972 y(co)r(ordinates)20
b(ma)n(y)-7 b(,)22 b(optionally)-7 b(,)22 b(b)r(e)g(em)n(b)r(edded)g
(in)g(a)f(space)g(with)g(more)g(than)h(t)n(w)n(o)e(dimensions,)j(the)f
-(remaining)227 3910 y(co)r(ordinates)g(b)r(eing)h(copied)g(unc)n
+(remaining)227 5071 y(co)r(ordinates)g(b)r(eing)h(copied)g(unc)n
(hanged.)35 b(Note,)24 b(ho)n(w)n(ev)n(er,)e(that)i(for)e(consistency)h
-(with)g(other)g(AST)h(facilities,)227 4010 y(a)30 b(WcsMap)f(handles)h
+(with)g(other)g(AST)h(facilities,)227 5171 y(a)30 b(WcsMap)f(handles)h
(co)r(ordinates)f(that)h(represen)n(t)e(angles)h(in)h(radians)f
-(\(rather)g(than)h(the)g(degrees)f(used)h(b)n(y)227 4109
-y(FITS-W)n(CS\).)227 4231 y(The)i(t)n(yp)r(e)g(of)f(FITS-W)n(CS)h(pro)5
+(\(rather)g(than)h(the)g(degrees)f(used)h(b)n(y)227 5271
+y(FITS-W)n(CS\).)227 5394 y(The)i(t)n(yp)r(e)g(of)f(FITS-W)n(CS)h(pro)5
b(jection)31 b(to)g(b)r(e)h(used)g(and)f(the)h(co)r(ordinates)e
-(\(axes\))h(to)h(whic)n(h)f(it)h(applies)g(are)227 4331
+(\(axes\))h(to)h(whic)n(h)f(it)h(applies)g(are)227 5494
y(sp)r(eci\014ed)g(when)g(a)g(WcsMap)g(is)f(\014rst)h(created.)49
b(The)32 b(pro)5 b(jection)31 b(t)n(yp)r(e)h(ma)n(y)f(subsequen)n(tly)g
-(b)r(e)h(determined)227 4430 y(using)g(the)f(WcsT)n(yp)r(e)h(attribute)
+(b)r(e)h(determined)227 5593 y(using)g(the)f(WcsT)n(yp)r(e)h(attribute)
g(and)f(the)h(co)r(ordinates)e(on)i(whic)n(h)f(it)h(acts)f(ma)n(y)g(b)r
-(e)h(determined)g(using)f(the)227 4530 y(WcsAxis\(lonlat\))d
-(attribute.)227 4652 y(Eac)n(h)37 b(WcsMap)i(also)e(allo)n(ws)g(up)i
-(to)f(100)f Ft(")p Fj(pro)5 b(jection)37 b(parameters)p
-Ft(")f Fj(to)i(b)r(e)h(asso)r(ciated)e(with)i(eac)n(h)e(axis.)227
-4752 y(These)31 b(sp)r(ecify)h(the)g(precise)f(form)g(of)g(the)h(pro)5
-b(jection,)31 b(and)h(are)e(accessed)g(using)h(PVi)p
-Ft(_)p Fj(m)h(attribute,)g(where)227 4851 y Ft(")p Fj(i)p
-Ft(")27 b Fj(is)h(the)g(in)n(teger)f(axis)h(index)f(\(starting)h(at)g
-(1\),)f(and)h(m)g(is)g(an)g(in)n(teger)f Ft(")p Fj(parameter)f(index)p
-Ft(")h Fj(in)h(the)h(range)d(0)227 4951 y(to)i(99.)39
-b(The)28 b(n)n(um)n(b)r(er)g(of)g(pro)5 b(jection)27
-b(parameters)g(required)g(b)n(y)h(eac)n(h)g(pro)5 b(jection,)27
-b(and)i(their)f(meanings,)g(are)227 5051 y(dep)r(enden)n(t)c(up)r(on)e
-(the)h(pro)5 b(jection)22 b(t)n(yp)r(e)h(\(most)g(pro)5
-b(jections)21 b(either)h(do)h(not)f(use)h(an)n(y)f(pro)5
-b(jection)21 b(parameters,)227 5150 y(or)h(use)g(parameters)f(1)h(and)g
-(2)g(asso)r(ciated)f(with)i(the)g(latitude)g(axis\).)35
-b(Before)21 b(creating)h(a)g(WcsMap)g(y)n(ou)g(should)227
-5250 y(consult)31 b(the)h(FITS-W)n(CS)g(pap)r(er)e(for)h(details)g(of)h
+(e)h(determined)g(using)f(the)227 5693 y(WcsAxis\(lonlat\))d
+(attribute.)p eop end
+%%Page: 564 574
+TeXDict begin 564 573 bop 0 52 a FG(564)2251 b Fz(D)91
+b(AST)30 b(CLASS)f(DESCRIPTIONS)227 351 y Fj(Eac)n(h)37
+b(WcsMap)i(also)e(allo)n(ws)g(up)i(to)f(100)f Ft(")p
+Fj(pro)5 b(jection)37 b(parameters)p Ft(")f Fj(to)i(b)r(e)h(asso)r
+(ciated)e(with)i(eac)n(h)e(axis.)227 451 y(These)31 b(sp)r(ecify)h(the)
+g(precise)f(form)g(of)g(the)h(pro)5 b(jection,)31 b(and)h(are)e
+(accessed)g(using)h(PVi)p Ft(_)p Fj(m)h(attribute,)g(where)227
+551 y Ft(")p Fj(i)p Ft(")27 b Fj(is)h(the)g(in)n(teger)f(axis)h(index)f
+(\(starting)h(at)g(1\),)f(and)h(m)g(is)g(an)g(in)n(teger)f
+Ft(")p Fj(parameter)f(index)p Ft(")h Fj(in)h(the)h(range)d(0)227
+650 y(to)i(99.)39 b(The)28 b(n)n(um)n(b)r(er)g(of)g(pro)5
+b(jection)27 b(parameters)g(required)g(b)n(y)h(eac)n(h)g(pro)5
+b(jection,)27 b(and)i(their)f(meanings,)g(are)227 750
+y(dep)r(enden)n(t)c(up)r(on)e(the)h(pro)5 b(jection)22
+b(t)n(yp)r(e)h(\(most)g(pro)5 b(jections)21 b(either)h(do)h(not)f(use)h
+(an)n(y)f(pro)5 b(jection)21 b(parameters,)227 849 y(or)h(use)g
+(parameters)f(1)h(and)g(2)g(asso)r(ciated)f(with)i(the)g(latitude)g
+(axis\).)35 b(Before)21 b(creating)h(a)g(WcsMap)g(y)n(ou)g(should)227
+949 y(consult)31 b(the)h(FITS-W)n(CS)g(pap)r(er)e(for)h(details)g(of)h
(whic)n(h)f(pro)5 b(jection)30 b(parameters)g(are)g(required,)i(and)f
-(whic)n(h)227 5349 y(ha)n(v)n(e)h(defaults.)53 b(When)34
+(whic)n(h)227 1049 y(ha)n(v)n(e)h(defaults.)53 b(When)34
b(creating)e(the)h(WcsMap,)h(y)n(ou)e(m)n(ust)h(explicitly)g(set)g(v)-5
-b(alues)33 b(for)f(all)h(those)g(required)227 5449 y(pro)5
+b(alues)33 b(for)f(all)h(those)g(required)227 1148 y(pro)5
b(jection)27 b(parameters)f(whic)n(h)h(do)h(not)f(ha)n(v)n(e)g
-(defaults)g(de\014ned)h(in)g(this)g(pap)r(er.)0 5593
-y Fc(Constructor)k(F)-8 b(unction:)227 5693 y Fj(AST)p
-Ft(_)p Fj(W)n(CSMAP)p eop end
-%%Page: 558 568
-TeXDict begin 558 567 bop 0 52 a FG(558)2251 b Fz(D)91
-b(AST)30 b(CLASS)f(DESCRIPTIONS)-2 351 y Fc(Inheritance)n(:)227
-497 y Fj(The)f(WcsMap)f(class)g(inherits)g(from)h(the)g(Mapping)f
-(class.)-2 648 y Fc(A)m(ttributes)n(:)227 794 y Fj(In)36
+(defaults)g(de\014ned)h(in)g(this)g(pap)r(er.)0 1288
+y Fc(Constructor)k(F)-8 b(unction:)227 1388 y Fj(AST)p
+Ft(_)p Fj(W)n(CSMAP)-2 1528 y Fc(Inheritance)n(:)227
+1674 y Fj(The)28 b(WcsMap)f(class)g(inherits)g(from)h(the)g(Mapping)f
+(class.)-2 1814 y Fc(A)m(ttributes)n(:)227 1960 y Fj(In)36
b(addition)g(to)g(those)g(attributes)g(common)f(to)h(all)g(Mappings,)h
(ev)n(ery)e(WcsMap)h(also)f(has)g(the)i(follo)n(wing)227
-893 y(attributes:)340 1156 y Fi(\017)45 b Fj(NatLat:)37
+2060 y(attributes:)340 2307 y Fi(\017)45 b Fj(NatLat:)37
b(Nativ)n(e)27 b(latitude)h(of)g(the)g(reference)e(p)r(oin)n(t)i(of)g
-(a)f(FITS-W)n(CS)h(pro)5 b(jection)340 1289 y Fi(\017)45
+(a)f(FITS-W)n(CS)h(pro)5 b(jection)340 2431 y Fi(\017)45
b Fj(NatLon:)37 b(Nativ)n(e)27 b(longitude)g(of)h(the)g(reference)f(p)r
(oin)n(t)g(of)h(a)f(FITS-W)n(CS)h(pro)5 b(jection)340
-1422 y Fi(\017)45 b Fj(PVi)p Ft(_)p Fj(m:)37 b(FITS-W)n(CS)28
-b(pro)5 b(jection)26 b(parameters)340 1556 y Fi(\017)45
+2554 y Fi(\017)45 b Fj(PVi)p Ft(_)p Fj(m:)37 b(FITS-W)n(CS)28
+b(pro)5 b(jection)26 b(parameters)340 2678 y Fi(\017)45
b Fj(PVMax:)36 b(Maxim)n(um)28 b(n)n(um)n(b)r(er)f(of)h(FITS-W)n(CS)f
-(pro)5 b(jection)27 b(parameters)340 1689 y Fi(\017)45
+(pro)5 b(jection)27 b(parameters)340 2801 y Fi(\017)45
b Fj(WcsAxis\(lonlat\):)37 b(FITS-W)n(CS)28 b(pro)5 b(jection)27
-b(axes)340 1822 y Fi(\017)45 b Fj(WcsT)n(yp)r(e:)37 b(FITS-W)n(CS)28
-b(pro)5 b(jection)26 b(t)n(yp)r(e)-2 1985 y Fc(F)-8 b(unctions)n(:)227
-2131 y Fj(The)38 b(WcsMap)g(class)f(do)r(es)h(not)g(de\014ne)g(an)n(y)g
+b(axes)340 2925 y Fi(\017)45 b Fj(WcsT)n(yp)r(e:)37 b(FITS-W)n(CS)28
+b(pro)5 b(jection)26 b(t)n(yp)r(e)-2 3077 y Fc(F)-8 b(unctions)n(:)227
+3223 y Fj(The)38 b(WcsMap)g(class)f(do)r(es)h(not)g(de\014ne)g(an)n(y)g
(new)g(routines)f(b)r(ey)n(ond)h(those)f(whic)n(h)h(are)f(applicable)h
-(to)g(all)227 2231 y(Mappings.)p 0 2431 3780 12 v 0 2563
+(to)g(all)227 3323 y(Mappings.)p 0 3504 3780 12 v 0 3635
a FA(WinMap)180 b Fd(Map)39 b(one)g(windo)m(w)e(on)h(to)g(another)g(b)m
-(y)g(scaling)g(and)1449 2677 y(shifting)f(eac)m(h)h(axis)3261
-2563 y FA(WinMap)0 2867 y Fc(Description:)44 b Fj(A)26
+(y)g(scaling)g(and)1449 3750 y(shifting)f(eac)m(h)h(axis)3261
+3635 y FA(WinMap)0 3920 y Fc(Description:)44 b Fj(A)26
b(Winmap)g(is)g(a)f(linear)g(Mapping)h(whic)n(h)f(transforms)f(a)i
(rectangular)d(windo)n(w)j(in)f(one)h(co)r(ordinate)227
-2967 y(system)k(in)n(to)f(a)g(similar)g(windo)n(w)g(in)g(another)g(co)r
+4020 y(system)k(in)n(to)f(a)g(similar)g(windo)n(w)g(in)g(another)g(co)r
(ordinate)f(system)i(b)n(y)f(scaling)f(and)i(shifting)g(eac)n(h)e(axis)
-h(\(the)227 3067 y(windo)n(w)e(edges)g(b)r(eing)h(parallel)e(to)i(the)g
-(co)r(ordinate)e(axes\).)227 3192 y(A)g(WinMap)g(is)g(sp)r(eci\014ed)g
+h(\(the)227 4119 y(windo)n(w)e(edges)g(b)r(eing)h(parallel)e(to)i(the)g
+(co)r(ordinate)e(axes\).)227 4239 y(A)g(WinMap)g(is)g(sp)r(eci\014ed)g
(b)n(y)g(giving)f(the)h(co)r(ordinates)e(of)i(t)n(w)n(o)f(opp)r(osite)g
(corners)f(\(A)j(and)e(B\))h(of)g(the)g(windo)n(w)227
-3291 y(in)i(b)r(oth)g(the)g(input)h(and)e(output)h(co)r(ordinate)f
-(systems.)0 3442 y Fc(Constructor)32 b(F)-8 b(unction:)227
-3541 y Fj(AST)p Ft(_)p Fj(WINMAP)-2 3692 y Fc(Inheritance)n(:)227
-3838 y Fj(The)28 b(WinMap)g(class)e(inherits)i(from)f(the)h(Mapping)f
-(class.)-2 3988 y Fc(A)m(ttributes)n(:)227 4134 y Fj(The)34
+4339 y(in)i(b)r(oth)g(the)g(input)h(and)e(output)h(co)r(ordinate)f
+(systems.)0 4479 y Fc(Constructor)32 b(F)-8 b(unction:)227
+4578 y Fj(AST)p Ft(_)p Fj(WINMAP)-2 4719 y Fc(Inheritance)n(:)227
+4865 y Fj(The)28 b(WinMap)g(class)e(inherits)i(from)f(the)h(Mapping)f
+(class.)-2 5005 y Fc(A)m(ttributes)n(:)227 5151 y Fj(The)34
b(WinMap)g(class)f(do)r(es)g(not)h(de\014ne)g(an)n(y)f(new)h
(attributes)g(b)r(ey)n(ond)f(those)h(whic)n(h)f(are)g(applicable)g(to)h
-(all)227 4234 y(Mappings.)-2 4384 y Fc(F)-8 b(unctions)n(:)227
-4530 y Fj(The)38 b(WinMap)h(class)e(do)r(es)h(not)g(de\014ne)g(an)n(y)f
+(all)227 5251 y(Mappings.)-2 5391 y Fc(F)-8 b(unctions)n(:)227
+5537 y Fj(The)38 b(WinMap)h(class)e(do)r(es)h(not)g(de\014ne)g(an)n(y)f
(new)h(routines)g(b)r(ey)n(ond)g(those)f(whic)n(h)h(are)f(applicable)h
-(to)g(all)227 4630 y(Mappings.)p 0 4830 V 0 4962 a FA(XmlChan)716
-4968 y Fd(I/O)h(Channel)e(using)i(XML)g(to)f(represen)m(t)g(Ob)7
-b(jects)3217 4962 y FA(XmlChan)0 5169 y Fc(Description:)44
-b Fj(A)21 b(XmlChan)f(is)g(a)g(sp)r(ecialised)g(form)g(of)g(Channel)g
-(whic)n(h)g(supp)r(orts)g(XML)g(I/O)f(op)r(erations.)34
-b(W)-7 b(riting)227 5269 y(an)29 b(Ob)5 b(ject)30 b(to)f(an)g(XmlChan)h
-(\(using)f(AST)p Ft(_)p Fj(WRITE\))h(will,)g(if)g(the)g(Ob)5
-b(ject)29 b(is)g(suitable,)h(generate)e(an)h(XML)227
-5369 y(description)e(of)g(that)g(Ob)5 b(ject,)28 b(and)f(reading)e
-(from)i(an)g(XmlChan)h(will)f(create)f(a)h(new)g(Ob)5
-b(ject)27 b(from)g(its)g(XML)227 5468 y(description.)227
-5593 y(Normally)-7 b(,)39 b(when)f(y)n(ou)e(use)i(an)f(XmlChan,)j(y)n
+(to)g(all)227 5636 y(Mappings.)p eop end
+%%Page: 565 575
+TeXDict begin 565 574 bop 3643 52 a FG(565)p 0 351 3780
+12 v 0 483 a FA(XmlChan)716 490 y Fd(I/O)39 b(Channel)e(using)i(XML)g
+(to)f(represen)m(t)g(Ob)7 b(jects)3217 483 y FA(XmlChan)0
+693 y Fc(Description:)44 b Fj(A)21 b(XmlChan)f(is)g(a)g(sp)r(ecialised)
+g(form)g(of)g(Channel)g(whic)n(h)g(supp)r(orts)g(XML)g(I/O)f(op)r
+(erations.)34 b(W)-7 b(riting)227 792 y(an)29 b(Ob)5
+b(ject)30 b(to)f(an)g(XmlChan)h(\(using)f(AST)p Ft(_)p
+Fj(WRITE\))h(will,)g(if)g(the)g(Ob)5 b(ject)29 b(is)g(suitable,)h
+(generate)e(an)h(XML)227 892 y(description)e(of)g(that)g(Ob)5
+b(ject,)28 b(and)f(reading)e(from)i(an)g(XmlChan)h(will)f(create)f(a)h
+(new)g(Ob)5 b(ject)27 b(from)g(its)g(XML)227 992 y(description.)227
+1118 y(Normally)-7 b(,)39 b(when)f(y)n(ou)e(use)i(an)f(XmlChan,)j(y)n
(ou)d(should)g(pro)n(vide)f Ft(")p Fj(source)p Ft(")f
Fj(and)j Ft(")p Fj(sink)p Ft(")e Fj(routines)h(whic)n(h)227
-5693 y(connect)24 b(it)f(to)h(an)f(external)g(data)g(store)f(b)n(y)h
+1217 y(connect)24 b(it)f(to)h(an)f(external)g(data)g(store)f(b)n(y)h
(reading)f(and)i(writing)f(the)h(resulting)e(XML)i(text.)36
-b(These)23 b(routines)p eop end
-%%Page: 559 569
-TeXDict begin 559 568 bop 3643 52 a FG(559)227 351 y
-Fj(should)40 b(p)r(erform)f(an)n(y)h(con)n(v)n(ersions)d(needed)j(b)r
-(et)n(w)n(een)g(external)f(c)n(haracter)f(enco)r(dings)h(and)h(the)g
-(in)n(ternal)227 451 y(ASCI)r(I)33 b(enco)r(ding.)51
-b(If)33 b(no)f(suc)n(h)g(routines)g(are)g(supplied,)i(a)e(Channel)g
-(will)h(read)e(from)h(standard)g(input)h(and)227 551
-y(write)28 b(to)f(standard)g(output.)227 675 y(Alternativ)n(ely)-7
-b(,)29 b(an)g(XmlChan)h(can)e(b)r(e)i(told)f(to)g(read)f(or)g(write)h
-(from)g(sp)r(eci\014c)g(text)h(\014les)f(using)g(the)g(SinkFile)227
-775 y(and)f(SourceFile)f(attributes,)g(in)h(whic)n(h)g(case)e(no)i
+b(These)23 b(routines)227 1317 y(should)40 b(p)r(erform)f(an)n(y)h(con)
+n(v)n(ersions)d(needed)j(b)r(et)n(w)n(een)g(external)f(c)n(haracter)f
+(enco)r(dings)h(and)h(the)g(in)n(ternal)227 1417 y(ASCI)r(I)33
+b(enco)r(ding.)51 b(If)33 b(no)f(suc)n(h)g(routines)g(are)g(supplied,)i
+(a)e(Channel)g(will)h(read)e(from)h(standard)g(input)h(and)227
+1516 y(write)28 b(to)f(standard)g(output.)227 1642 y(Alternativ)n(ely)
+-7 b(,)29 b(an)g(XmlChan)h(can)e(b)r(e)i(told)f(to)g(read)f(or)g(write)
+h(from)g(sp)r(eci\014c)g(text)h(\014les)f(using)g(the)g(SinkFile)227
+1742 y(and)f(SourceFile)f(attributes,)g(in)h(whic)n(h)g(case)e(no)i
(sink)f(or)g(source)f(function)i(need)g(b)r(e)g(supplied.)0
-924 y Fc(Constructor)k(F)-8 b(unction:)227 1024 y Fj(AST)p
-Ft(_)p Fj(XMLCHAN)-2 1173 y Fc(Inheritance)n(:)227 1319
+1895 y Fc(Constructor)k(F)-8 b(unction:)227 1994 y Fj(AST)p
+Ft(_)p Fj(XMLCHAN)-2 2147 y Fc(Inheritance)n(:)227 2293
y Fj(The)28 b(XmlChan)g(class)e(inherits)i(from)f(the)h(Channel)g
-(class.)-2 1469 y Fc(A)m(ttributes)n(:)227 1615 y Fj(In)36
+(class.)-2 2446 y Fc(A)m(ttributes)n(:)227 2592 y Fj(In)36
b(addition)f(to)g(those)g(attributes)h(common)f(to)g(all)g(Channels,)i
(ev)n(ery)d(XmlChan)i(also)e(has)h(the)h(follo)n(wing)227
-1714 y(attributes:)340 1975 y Fi(\017)45 b Fj(XmlF)-7
+2691 y(attributes:)340 2957 y Fi(\017)45 b Fj(XmlF)-7
b(ormat:)37 b(System)28 b(for)f(formatting)g(Ob)5 b(jects)27
-b(as)g(XML)340 2108 y Fi(\017)45 b Fj(XmlLength:)38 b(Con)n(trols)26
-b(output)i(bu\013er)g(length)340 2241 y Fi(\017)45 b
+b(as)g(XML)340 3092 y Fi(\017)45 b Fj(XmlLength:)38 b(Con)n(trols)26
+b(output)i(bu\013er)g(length)340 3226 y Fi(\017)45 b
Fj(XmlPre\014x:)37 b(The)27 b(namespace)g(pre\014x)g(to)g(use)h(when)g
-(writing)-2 2403 y Fc(F)-8 b(unctions)n(:)227 2549 y
+(writing)-2 3391 y Fc(F)-8 b(unctions)n(:)227 3537 y
Fj(The)36 b(XmlChan)h(class)e(do)r(es)h(not)g(de\014ne)g(an)n(y)f(new)h
(routines)g(b)r(ey)n(ond)g(those)f(whic)n(h)h(are)f(applicable)h(to)g
-(all)227 2649 y(Mappings.)p 0 2848 3780 12 v 0 2979 a
-FA(Zo)t(omMap)1000 2980 y Fd(Zo)s(om)i(co)s(ordinates)e(ab)s(out)i(the)
-h(origin)3179 2979 y FA(Zo)t(omMap)0 3168 y Fc(Description:)44
-b Fj(The)27 b(Zo)r(omMap)f(class)h(implemen)n(ts)g(a)f(Mapping)h(whic)n
-(h)g(p)r(erforms)f(a)h Ft(")p Fj(zo)r(om)p Ft(")f Fj(transformation)f
-(b)n(y)227 3268 y(m)n(ultiplying)g(all)g(co)r(ordinate)f(v)-5
-b(alues)25 b(b)n(y)f(the)i(same)e(scale)g(factor)h(\(the)g(in)n(v)n
-(erse)f(transformation)f(is)i(p)r(erformed)227 3368 y(b)n(y)39
+(all)227 3637 y(Mappings.)p 0 3839 V 0 3970 a FA(Zo)t(omMap)1000
+3971 y Fd(Zo)s(om)i(co)s(ordinates)e(ab)s(out)i(the)h(origin)3179
+3970 y FA(Zo)t(omMap)0 4163 y Fc(Description:)44 b Fj(The)27
+b(Zo)r(omMap)f(class)h(implemen)n(ts)g(a)f(Mapping)h(whic)n(h)g(p)r
+(erforms)f(a)h Ft(")p Fj(zo)r(om)p Ft(")f Fj(transformation)f(b)n(y)227
+4263 y(m)n(ultiplying)g(all)g(co)r(ordinate)f(v)-5 b(alues)25
+b(b)n(y)f(the)i(same)e(scale)g(factor)h(\(the)g(in)n(v)n(erse)f
+(transformation)f(is)i(p)r(erformed)227 4362 y(b)n(y)39
b(dividing)g(b)n(y)g(this)h(scale)e(factor\).)72 b(The)39
b(n)n(um)n(b)r(er)g(of)g(co)r(ordinate)f(v)-5 b(alues)39
-b(represen)n(ting)f(eac)n(h)g(p)r(oin)n(t)i(is)227 3467
-y(unc)n(hanged.)0 3617 y Fc(Constructor)32 b(F)-8 b(unction:)227
-3716 y Fj(AST)p Ft(_)p Fj(ZOOMMAP)-2 3866 y Fc(Inheritance)n(:)227
-4012 y Fj(The)28 b(Zo)r(omMap)f(class)f(inherits)i(from)f(the)h
-(Mapping)f(class.)-2 4161 y Fc(A)m(ttributes)n(:)227
-4307 y Fj(In)33 b(addition)f(to)h(those)f(attributes)g(common)g(to)g
+b(represen)n(ting)f(eac)n(h)g(p)r(oin)n(t)i(is)227 4462
+y(unc)n(hanged.)0 4614 y Fc(Constructor)32 b(F)-8 b(unction:)227
+4714 y Fj(AST)p Ft(_)p Fj(ZOOMMAP)-2 4867 y Fc(Inheritance)n(:)227
+5013 y Fj(The)28 b(Zo)r(omMap)f(class)f(inherits)i(from)f(the)h
+(Mapping)f(class.)-2 5165 y Fc(A)m(ttributes)n(:)227
+5312 y Fj(In)33 b(addition)f(to)h(those)f(attributes)g(common)g(to)g
(all)h(Mappings,)g(ev)n(ery)e(Zo)r(omMap)g(also)h(has)g(the)h(follo)n
-(wing)227 4407 y(attributes:)340 4668 y Fi(\017)45 b
-Fj(Zo)r(om:)36 b(Zo)r(omMap)27 b(scale)g(factor)-2 4830
-y Fc(F)-8 b(unctions)n(:)227 4976 y Fj(The)35 b(Zo)r(omMap)f(class)g
-(do)r(es)g(not)h(de\014ne)f(an)n(y)g(new)h(routines)f(b)r(ey)n(ond)h
-(those)f(whic)n(h)g(are)g(applicable)g(to)h(all)227 5076
-y(Mappings.)p eop end
-%%Page: 560 570
-TeXDict begin 560 569 bop 0 52 a FG(560)2251 b Fz(D)91
-b(AST)30 b(CLASS)f(DESCRIPTIONS)p eop end
-%%Page: 561 571
-TeXDict begin 561 570 bop 3643 52 a FG(561)0 351 y FA(E)135
+(wing)227 5411 y(attributes:)340 5677 y Fi(\017)45 b
+Fj(Zo)r(om:)36 b(Zo)r(omMap)27 b(scale)g(factor)p eop
+end
+%%Page: 566 576
+TeXDict begin 566 575 bop 0 52 a FG(566)2251 b Fz(D)91
+b(AST)30 b(CLASS)f(DESCRIPTIONS)-2 351 y Fc(F)-8 b(unctions)n(:)227
+497 y Fj(The)35 b(Zo)r(omMap)f(class)g(do)r(es)g(not)h(de\014ne)f(an)n
+(y)g(new)h(routines)f(b)r(ey)n(ond)h(those)f(whic)n(h)g(are)g
+(applicable)g(to)h(all)227 597 y(Mappings.)p eop end
+%%Page: 567 577
+TeXDict begin 567 576 bop 3643 52 a FG(567)0 351 y FA(E)135
b(UNIX)45 b(Command)g(Descriptions)0 594 y FG(The)35
b(commands)h(describ)s(ed)e(here)i(are)g(pro)m(vided)f(for)h(use)f
(from)g(the)h(UNIX)g(shell)g(to)h(assist)f(with)f(dev)m(el-)0
@@ -140318,8 +140618,8 @@ h(to)g(pro)n(vide)f(y)n(our)f(o)n(wn)427 5326 y(argumen)n(ts)i(for)h
5693 y Fr(Or)f(the)f(equiv)l(alen)n(t)g(directory)g(if)i(AST)e(is)h
(installed)h(in)f(a)g(non-standard)f(lo)r(cation.)p eop
end
-%%Page: 562 572
-TeXDict begin 562 571 bop 0 52 a FG(562)1988 b Fz(E)91
+%%Page: 568 578
+TeXDict begin 568 577 bop 0 52 a FG(568)1988 b Fz(E)91
b(UNIX)30 b(COMMAND)i(DESCRIPTIONS)427 351 y Fj(this)e(switc)n(h)g
(will)g(cause)f(\\unresolv)n(ed)f(sym)n(b)r(ol")h(errors)e(to)j(o)r
(ccur)f(during)h(linking,)g(w)n(arning)e(y)n(ou)h(that)427
@@ -140423,8 +140723,8 @@ b(AL\).)p 0 5469 3780 12 v 0 5601 a FA(ast)p Fe(_)p FA(link)p
Fe(_)p FA(adam)189 b Fd(Link)39 b(an)f(AD)m(AM)h(program)d(with)i(the)
1581 5715 y(AST)g(library)2948 5601 y FA(ast)p Fe(_)p
FA(link)p Fe(_)p FA(adam)p eop end
-%%Page: 563 573
-TeXDict begin 563 572 bop 3643 52 a FG(563)0 351 y Fc(Description:)44
+%%Page: 569 579
+TeXDict begin 569 578 bop 3643 52 a FG(569)0 351 y Fc(Description:)44
b Fj(This)21 b(command)e(should)h(only)g(b)r(e)h(used)f(when)h
(building)f(Starlink)g(AD)n(AM)h(programs)d(whic)n(h)i(use)g(the)227
451 y(AST)29 b(library)-7 b(,)27 b(in)h(order)f(to)h(generate)f(the)i
@@ -140523,8 +140823,8 @@ r(ecify)g(ho)n(w)f(error)f(messages)g(pro)r(duced)427
(ha)n(v)n(e)g(imple-)427 5693 y(men)n(ted)34 b(an)f(in)n(terface)f(to)i
(a)e(new)i(error)d(deliv)n(ery)h(system)h(y)n(ourself)g(and)g(wish)g
(to)g(pro)n(vide)f(y)n(our)g(o)n(wn)p eop end
-%%Page: 564 574
-TeXDict begin 564 573 bop 0 52 a FG(564)1988 b Fz(E)91
+%%Page: 570 580
+TeXDict begin 570 579 bop 0 52 a FG(570)1988 b Fz(E)91
b(UNIX)30 b(COMMAND)i(DESCRIPTIONS)427 351 y Fj(argumen)n(ts)20
b(for)h(linking)g(with)h(it.)35 b(By)21 b(default,)i(error)c(messages)h
(are)g(deliv)n(ered)g(in)i(the)g(standard)e(AD)n(AM)427
@@ -140602,8 +140902,8 @@ Fj(-fsla)p Ft(")e Fj(and)h Ft(")p Fj(-csla)p Ft(")f Fj(\015ags)h
(\(previously)f(used)i(for)227 3947 y(selecting)h(whic)n(h)h(v)n
(ersion)e(of)i(SLALIB)f(to)h(use\))f(to)h(b)r(e)g(sp)r(eci\014ed,)g
(but)g(they)g(will)g(b)r(e)g(ignored.)p eop end
-%%Page: 565 575
-TeXDict begin 565 574 bop 3643 52 a FG(565)0 351 y FA(F)134
+%%Page: 571 581
+TeXDict begin 571 580 bop 3643 52 a FG(571)0 351 y FA(F)134
b(FITS-W)l(CS)44 b(Co)l(v)l(erage)0 605 y FG(This)32
b(app)s(endix)f(giv)m(es)i(details)h(of)e(the)h(FitsChan)f(class)h
(implemen)m(tation)h(of)f(the)f(con)m(v)m(en)m(tions)j(describ)s(ed)0
@@ -140690,8 +140990,8 @@ b(alue)27 b(has)f(b)s(een)g(set)h(explicitly)0 5693 y(for)i(the)g(axis)
h(Lab)s(el)f(attribute,)h(it)g(is)f(used)g(as)g(the)h(axis)f(commen)m
(t)i(\(except)f(that)g(an)m(y)f(existing)i(commen)m(ts)p
eop end
-%%Page: 566 576
-TeXDict begin 566 575 bop 0 52 a FG(566)2489 b Fz(F)91
+%%Page: 572 582
+TeXDict begin 572 581 bop 0 52 a FG(572)2489 b Fz(F)91
b(FITS-W)m(CS)30 b(CO)m(VERA)m(GE)p 0 853 3841 4 v -2
965 4 113 v 115 932 a FE(Keyw)m(ord)p 640 965 V 798 w(Read)p
2240 965 V 1352 w(W)-9 b(rite)p 3839 965 V 0 969 3841
@@ -140766,9 +141066,9 @@ Fx(ia)p 640 4808 V 254 w FG(Ignored.)p 2240 4808 V 1273
w(Not)g(used.)p 3839 4808 V 0 4811 3841 4 v 986 5086
a(T)-8 b(able)31 b(1:)41 b(Use)31 b(of)g(FITS-W)m(CS)f(P)m(ap)s(er)g(I)
g(k)m(eyw)m(ords)p eop end
-%%Page: 567 577
-TeXDict begin 567 576 bop 0 52 a Fz(F.1)92 b(P)m(ap)s(er)30
-b(I)g(-)h(General)g(Linear)f(Co)s(ordinates)1933 b FG(567)0
+%%Page: 573 583
+TeXDict begin 573 582 bop 0 52 a Fz(F.1)92 b(P)m(ap)s(er)30
+b(I)g(-)h(General)g(Linear)f(Co)s(ordinates)1933 b FG(573)0
351 y(in)33 b(the)g(FitsChan)h(tak)m(e)g(precedence)g(if)f(the)h(k)m
(eyw)m(ord)g(v)-5 b(alue)33 b(has)g(not)h(c)m(hanged\).)50
b(The)33 b(ab)s(o)m(v)m(e)i(pro)s(cedure)0 464 y(is)d(o)m(v)m
@@ -140846,8 +141146,8 @@ b(If)34 b(there)i(are)f(an)m(y)0 5693 y(other)23 b(F)-8
b(rames)24 b(presen)m(t)e(in)h(the)g(F)-8 b(rameSet,)25
b(an)e(attempt)h(is)f(made)f(to)i(create)g(a)f(complete)i(set)e(of)g
(\\alternate")p eop end
-%%Page: 568 578
-TeXDict begin 568 577 bop 0 52 a FG(568)2489 b Fz(F)91
+%%Page: 574 584
+TeXDict begin 574 583 bop 0 52 a FG(574)2489 b Fz(F)91
b(FITS-W)m(CS)30 b(CO)m(VERA)m(GE)0 351 y FG(set)j(of)f(k)m(eyw)m(ords)
h(describing)f(eac)m(h)i(additional)f(F)-8 b(rame.)48
b(The)32 b(\014rst)f(c)m(haracter)j(in)e(the)h(Iden)m(t)f(attribute)h
@@ -140918,9 +141218,9 @@ b(Consequen)m(tly)-8 b(,)29 b(if)f(a)g(F)-8 b(rameSet)29
b(is)f(read)g(from)f(a)h(FITS-)227 5693 y(W)m(CS)k(header)g(and)f(it)h
(is)g(subsequen)m(tly)g(written)f(out)h(to)h(a)f(new)g(FITS-W)m(CS)f
(header,)h(the)g(original)p eop end
-%%Page: 569 579
-TeXDict begin 569 578 bop 0 52 a Fz(F.2)92 b(P)m(ap)s(er)30
-b(I)s(I)g(-)g(Celestial)i(Co)s(ordinates)2152 b FG(569)p
+%%Page: 575 585
+TeXDict begin 575 584 bop 0 52 a Fz(F.2)92 b(P)m(ap)s(er)30
+b(I)s(I)g(-)g(Celestial)i(Co)s(ordinates)2152 b FG(575)p
0 853 3800 4 v -2 965 4 113 v 94 932 a FE(Keyw)m(ord)p
598 965 V 777 w(Read)p 2198 965 V 1352 w(W)-9 b(rite)p
3798 965 V 0 969 3800 4 v -2 1533 4 565 v 50 1048 a FG(CTYPE)p
@@ -140995,8 +141295,8 @@ b(TE-OBS)53 b(is)2249 4661 y(also)32 b(written\).)p 3798
4808 V 0 4811 3800 4 v 969 5086 a(T)-8 b(able)31 b(2:)41
b(Use)30 b(of)h(FITS-W)m(CS)f(P)m(ap)s(er)g(I)s(I)g(k)m(eyw)m(ords)p
eop end
-%%Page: 570 580
-TeXDict begin 570 579 bop 0 52 a FG(570)2489 b Fz(F)91
+%%Page: 576 586
+TeXDict begin 576 585 bop 0 52 a FG(576)2489 b Fz(F)91
b(FITS-W)m(CS)30 b(CO)m(VERA)m(GE)227 351 y FG(LONPOLE)i(and)h(LA)-8
b(TPOLE)33 b(v)-5 b(alues)33 b(will)h(usually)f(b)s(e)g(used)f(in)h
(the)h(new)e(header)h(\(the)h(exception)227 464 y(b)s(eing)h(if)g(the)g
@@ -141089,10 +141389,10 @@ b(basic)g(ZPN)f(pro)5 b(jection)31 b(b)m(y)e(including)h(\\lngcor")h
(or)f(\\latcor")i(terms.)40 b(These)30 b(are)g(supp)s(orted)d(if)227
5693 y(they)k(use)f(half)g(cross-terms,)h(in)f(either)h(simple)f(or)h
(Cheb)m(yshev)e(represen)m(tation.)p eop end
-%%Page: 571 581
-TeXDict begin 571 580 bop 0 52 a Fz(F.3)92 b(P)m(ap)s(er)30
+%%Page: 577 587
+TeXDict begin 577 586 bop 0 52 a Fz(F.3)92 b(P)m(ap)s(er)30
b(I)s(I)s(I)f(-)i(Sp)s(ectral)f(Co)s(ordinates)2129 b
-FG(571)136 351 y Fu(\017)46 b FG(The)37 b(IRAF)h(\\TNX")h(pro)5
+FG(577)136 351 y Fu(\017)46 b FG(The)37 b(IRAF)h(\\TNX")h(pro)5
b(jection)38 b(is)g(represen)m(ted)f(b)m(y)h(a)g(WcsMap)h(with)e(t)m
(yp)s(e)h(of)g(AST)p Fy(__)p FG(TPN)e(\(a)227 464 y(distorted)j(T)-8
b(AN)39 b(pro)5 b(jection)39 b(retained)g(within)e(the)i(WcsMap)g
@@ -141165,8 +141465,8 @@ s(ositiv)m(e)h(non-zero)g(v)-5 b(alue)39 b(then)f(an)m(y)i(Mapping)e
b(describ)s(ed)f(in)g(FITS-W)m(CS)g(pap)s(er)f(I)s(I)s(I.)g(If)h(the)h
(T)-8 b(abOK)30 b(attribute)h(is)f(to)h(zero)h(\(the)f(default\))f(or)p
eop end
-%%Page: 572 582
-TeXDict begin 572 581 bop 0 52 a FG(572)2489 b Fz(F)91
+%%Page: 578 588
+TeXDict begin 578 587 bop 0 52 a FG(578)2489 b Fz(F)91
b(FITS-W)m(CS)30 b(CO)m(VERA)m(GE)p 0 263 4002 4 v -2
376 4 113 v 196 342 a FE(Keyw)m(ord)p 801 376 V 877 w(Read)p
2400 376 V 1353 w(W)-9 b(rite)p 4000 376 V 0 379 4002
@@ -141274,9 +141574,9 @@ m(e)i(b)s(een)d(set)i(ex-)2452 6330 y(plicitly)-8 b(.)p
4000 6364 V 0 6367 4002 4 v 951 6642 a(T)g(able)31 b(3:)41
b(Use)31 b(of)f(FITS-W)m(CS)g(P)m(ap)s(er)g(I)s(I)s(I)f(k)m(eyw)m(ords)
p eop end
-%%Page: 573 583
-TeXDict begin 573 582 bop 0 52 a Fz(F.4)92 b(P)m(ap)s(er)30
-b(IV)g(-)h(Co)s(ordinate)f(Distortions)2056 b FG(573)0
+%%Page: 579 589
+TeXDict begin 579 588 bop 0 52 a Fz(F.4)92 b(P)m(ap)s(er)30
+b(IV)g(-)h(Co)s(ordinate)f(Distortions)2056 b FG(579)0
351 y(negativ)m(e)28 b(in)e(the)h(FitsChan,)g(then)f(the)g(write)h(op)s
(eration)f(will)h(b)s(e)e(unsuccessful)g(unless)h(one)g(of)h(the)f
(eaerlier)0 464 y(conditions)31 b(is)f(met.)702 431 y
@@ -141351,8 +141651,8 @@ b(algorithm)h(is)g(used,)g(the)f(p)r(ositiv)n(e)h(v)l(alue)f(of)h(the)f
(T)-6 b(abOK)24 b(attribute)g(is)h(used)f(as)h(the)f(table)h(v)n
(ersion)f(n)n(um)n(b)r(er)0 5693 y(\(the)h(EXTVER)g(header\))h(in)g
(the)f(asso)r(ciated)j(FITS)d(binary)g(table.)p eop end
-%%Page: 574 584
-TeXDict begin 574 583 bop 0 52 a FG(574)2013 b Fz(G)91
+%%Page: 580 590
+TeXDict begin 580 589 bop 0 52 a FG(580)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)0 351 y FA(G)134
b(Changes)46 b(and)e(New)i(F)-11 b(eatures)0 626 y Fw(G.1)112
b(Changes)39 b(In)m(tro)s(duced)f(in)f(V1.1)0 866 y FG(The)26
@@ -141433,9 +141733,9 @@ b(Some)39 b(impro)m(v)m(emen)m(ts)g(ha)m(v)m(e)h(b)s(een)d(made)i(to)g
(written)g(to)h(a)f(Channel\))227 5693 y(has)30 b(c)m(hanged)h(sligh)m
(tly)-8 b(,)33 b(but)c(remains)i(compatible)g(with)f(earlier)i(v)m
(ersions)e(of)h(AST.)p eop end
-%%Page: 575 585
-TeXDict begin 575 584 bop 0 52 a Fz(G.2)92 b(Changes)30
-b(In)m(tro)s(duced)f(in)i(V1.2)2294 b FG(575)66 351 y(10.)46
+%%Page: 581 591
+TeXDict begin 581 590 bop 0 52 a Fz(G.2)92 b(Changes)30
+b(In)m(tro)s(duced)f(in)i(V1.2)2294 b FG(581)66 351 y(10.)46
b(A)23 b(problem)f(has)h(b)s(een)f(\014xed)g(whic)m(h)g(could)h(result)
g(when)e(using)i(AST)p Fy(_)p FG(READ)f(to)h(read)g(FITS)f(headers)227
464 y(in)h(whic)m(h)g(the)h(CDEL)-8 b(T)23 b(v)-5 b(alue)24
@@ -141510,8 +141810,8 @@ b(,)41 b(this)d(Domain)227 5493 y(v)-5 b(alue)31 b(w)m(as)g(not)f(set.)
111 5693 y(7.)46 b(AST)p Fy(_)p FG(FINDFITS)30 b(no)m(w)g(ignores)h
(trailing)g(spaces)g(in)f(its)h(k)m(eyw)m(ord)g(template.)p
eop end
-%%Page: 576 586
-TeXDict begin 576 585 bop 0 52 a FG(576)2013 b Fz(G)91
+%%Page: 582 592
+TeXDict begin 582 591 bop 0 52 a FG(582)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FG(8.)46
b(AST)p Fy(_)p FG(PUTFITS)23 b(no)m(w)i(recognises)h(\\D")h(and)d(\\d")
h(as)g(v)-5 b(alid)26 b(exp)s(onen)m(t)f(c)m(haracters)h(in)f
@@ -141582,9 +141882,9 @@ y(4.)46 b(A)32 b(bug)f(has)g(b)s(een)f(\014xed)h(whic)m(h)g(could)h
b(\(previously)-8 b(,)44 b(this)d(w)m(as)g(accepted)h(without)f(error)g
(and)f(a)h(Cartesian)h(pro)5 b(jection)227 5693 y(used)30
b(instead\).)p eop end
-%%Page: 577 587
-TeXDict begin 577 586 bop 0 52 a Fz(G.4)92 b(Changes)30
-b(In)m(tro)s(duced)f(in)i(V1.4)2294 b FG(577)111 351
+%%Page: 583 593
+TeXDict begin 583 592 bop 0 52 a Fz(G.4)92 b(Changes)30
+b(In)m(tro)s(duced)f(in)i(V1.4)2294 b FG(583)111 351
y(6.)46 b(A)d(bug)f(has)h(b)s(een)e(\014xed)h(whic)m(h)h(could)g(prev)m
(en)m(t)g(con)m(v)m(ersion)h(b)s(et)m(w)m(een)f(the)g(co)s(ordinate)g
(systems)227 464 y(represen)m(ted)d(b)m(y)f(t)m(w)m(o)i(CmpF)-8
@@ -141658,8 +141958,8 @@ b(FITS)e(\\ZPN")h(pro)5 b(jection)28 b(\(see)f(the)227
(\(exceedingly)j(small\))e(di\013erence)g(b)s(et)m(w)m(een)g(ICRS)f
(and)g(FK5)h(will)f(b)s(e)g(added)g(at)h(a)g(future)227
5693 y(release.)p eop end
-%%Page: 578 588
-TeXDict begin 578 587 bop 0 52 a FG(578)2013 b Fz(G)91
+%%Page: 584 594
+TeXDict begin 584 593 bop 0 52 a FG(584)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)227 351 y FG(Note)37
b(that)f(\\ICRS")g(is)f(not)h(y)m(et)h(recognised)f(as)g(a)g(co)s
(ordinate)g(system)g(b)m(y)g(other)f(classes)i(suc)m(h)e(as)227
@@ -141734,9 +142034,9 @@ Fy(CDELTj)e FG(and)g Fy(PCjjjiii)g FG(to)427 5693 y(describ)s(e)27
b(axis)h(scaling)h(and)e(rotation.)41 b(These)27 b(are)h(the)g(con)m(v)
m(en)m(tions)h(whic)m(h)e(w)m(ere)h(used)f(b)m(y)g(the)p
eop end
-%%Page: 579 589
-TeXDict begin 579 588 bop 0 52 a Fz(G.6)92 b(Changes)30
-b(In)m(tro)s(duced)f(in)i(V1.6)2294 b FG(579)427 351
+%%Page: 585 595
+TeXDict begin 585 594 bop 0 52 a Fz(G.6)92 b(Changes)30
+b(In)m(tro)s(duced)f(in)i(V1.6)2294 b FG(585)427 351
y(FITS-W)m(CS)30 b(enco)s(ding)f(prior)h(to)g(v)m(ersion)g(1.5)h(of)f
(AST.)f(This)g(enco)s(ding)h(is)g(pro)m(vided)f(to)i(allo)m(w)427
464 y(existing)c(data)f(whic)m(h)f(use)g(these)g(con)m(v)m(en)m(tions)j
@@ -141818,8 +142118,8 @@ Fy(__)p FG(SFL.)0 5366 y Fw(G.6)112 b(Changes)39 b(In)m(tro)s(duced)f
(signi\014can)m(t)g(c)m(hanges)g(whic)m(h)f(ha)m(v)m(e)i(o)s(ccurred)d
(in)h(the)g(AST)g(library)0 5693 y(b)s(et)m(w)m(een)31
b(v)m(ersions)g(V1.5)g(and)f(V1.6:)p eop end
-%%Page: 580 590
-TeXDict begin 580 589 bop 0 52 a FG(580)2013 b Fz(G)91
+%%Page: 586 596
+TeXDict begin 586 595 bop 0 52 a FG(586)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FG(1.)46
b(A)24 b(bug)f(has)g(b)s(een)g(\014xed)g(in)g(the)h(Plot)h(class)f
(whic)m(h)f(could)h(cause)g(groups)f(of)h(tic)m(k)h(marks)e(to)h(b)s(e)
@@ -141903,9 +142203,9 @@ FG(BLOCKA)-10 b(VE)23 b(has)227 5467 y(b)s(een)36 b(added)f(to)i(the)g
(the)h(mean)g(of)g(the)g(input)f(pixels)i(in)e(a)i(b)s(o)m(x)f(cen)m
(tred)g(on)g(the)227 5693 y(output)30 b(pixel.)p eop
end
-%%Page: 581 591
-TeXDict begin 581 590 bop 0 52 a Fz(G.7)92 b(Changes)30
-b(In)m(tro)s(duced)f(in)i(V1.7)2294 b FG(581)66 351 y(12.)46
+%%Page: 587 597
+TeXDict begin 587 596 bop 0 52 a Fz(G.7)92 b(Changes)30
+b(In)m(tro)s(duced)f(in)i(V1.7)2294 b FG(587)66 351 y(12.)46
b(The)24 b(SkyF)-8 b(rame)25 b(class)h(can)e(no)m(w)h(b)s(e)f(used)g
(to)h(represen)m(t)f(an)h(arbitrary)f(spherical)h(co)s(ordinate)g
(system)227 464 y(b)m(y)31 b(setting)g(its)g(System)f(attribute)h(to)g
@@ -141987,8 +142287,8 @@ g(to)g(b)s(e)f(sa)m(v)m(ed)i(and)e(restore)i(on)e(a)h
(\014rst-in-last-out)h(stac)m(k,)h(allo)m(wing)g(temp)s(orary)227
5693 y(c)m(hanges)d(to)f(b)s(e)e(made)i(to)g(the)g(set)g(of)f
(registered)h(graphics)g(routines.)p eop end
-%%Page: 582 592
-TeXDict begin 582 591 bop 0 52 a FG(582)2013 b Fz(G)91
+%%Page: 588 598
+TeXDict begin 588 597 bop 0 52 a FG(588)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FG(7.)46
b(The)39 b(Dra)m(wAxes)i(attribute)f(of)g(the)g(Plot)g(class)h(can)f
(no)m(w)f(b)s(e)g(sp)s(eci\014ed)g(indep)s(endan)m(tly)g(for)g(eac)m(h)
@@ -142052,9 +142352,9 @@ b(unctions)46 b(within)e(pro)5 b(j.c)44 b(and)g(w)m(cstrig.c)j(ha)m(v)m
(e)f(b)s(een)e(renamed)g(to)h(a)m(v)m(oid)i(name)d(clashes)i(with)227
5675 y(functions)30 b(in)g(more)h(recen)m(t)g(v)m(ersions)g(of)f(Mark)h
(Calabretta's)h(w)m(cslib)f(library)-8 b(.)p eop end
-%%Page: 583 593
-TeXDict begin 583 592 bop 0 52 a Fz(G.10)92 b(Changes)31
-b(In)m(tro)s(duced)e(in)h(V1.8-4)2174 b FG(583)0 351
+%%Page: 589 599
+TeXDict begin 589 598 bop 0 52 a Fz(G.10)92 b(Changes)31
+b(In)m(tro)s(duced)e(in)h(V1.8-4)2174 b FG(589)0 351
y Fw(G.10)112 b(Changes)39 b(In)m(tro)s(duced)f(in)f(V1.8-4)0
560 y FG(The)26 b(follo)m(wing)i(describ)s(es)d(the)i(most)f
(signi\014can)m(t)i(c)m(hanges)f(whic)m(h)f(o)s(ccurred)g(in)g(the)g
@@ -142126,8 +142426,8 @@ e(the)g(Mapping)g(represen)m(ted)g(b)m(y)f(the)h(Plot)h(w)m(as)f(a)g
b(In)31 b(this)i(example,)g(the)g(bug)f(caused)g(tic)m(k)i(marks)e(to)h
(b)s(e)f(dra)m(wn)g(at)227 5693 y(negativ)m(e)h(radius)c(v)-5
b(alues.)p eop end
-%%Page: 584 594
-TeXDict begin 584 593 bop 0 52 a FG(584)2013 b Fz(G)91
+%%Page: 590 600
+TeXDict begin 590 599 bop 0 52 a FG(590)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FG(4.)46
b(A)31 b(bug)e(has)h(b)s(een)g(\014xed)g(whic)m(h)g(could)g(prev)m(en)m
(t)h(attribute)g(settings)g(from)f(b)s(eing)g(read)g(correctly)i(b)m(y)
@@ -142197,9 +142497,9 @@ b(FitsChan)g(class)h(has)f(b)s(een)g(mo)s(di\014ed)f(to)i(only)f(use)g
(di\014ed)g(so)h(that)h(it)g(do)s(es)f(not)g(app)s(end)f(a)h(trailing)h
(\\Z")g(c)m(haracter)227 5693 y(to)h(the)g(end)f(of)g(D)m(A)-8
b(TE-OBS)31 b(k)m(eyw)m(ord)g(v)-5 b(alues.)p eop end
-%%Page: 585 595
-TeXDict begin 585 594 bop 0 52 a Fz(G.15)92 b(Changes)31
-b(In)m(tro)s(duced)e(in)h(V2.0)2249 b FG(585)111 351
+%%Page: 591 601
+TeXDict begin 591 600 bop 0 52 a Fz(G.15)92 b(Changes)31
+b(In)m(tro)s(duced)e(in)h(V2.0)2249 b FG(591)111 351
y(5.)46 b(The)e(FitsChan)g(class)h(has)f(b)s(een)g(mo)s(di\014ed)f(to)i
(use)f(latest)i(list)e(of)h(FITS-W)m(CS)f(pro)5 b(jections,)48
b(as)227 464 y(describ)s(ed)33 b(in)g(the)h(FITS-W)m(CS)f(pap)s(er)f(I)
@@ -142275,8 +142575,8 @@ b(enco)s(ding,)g(but)f(has)h(not)g(previously)f(b)s(een)g(p)s(ossible)h
(for)f(foreign)h(enco)s(dings.)45 b(The)227 5693 y(W)m(CSAXES)30
b(k)m(eyw)m(ord)h(is)g(used)e(to)i(store)g(the)g(n)m(um)m(b)s(er)e(of)h
(W)m(CS)h(axes)g(in)f(the)g(FITS)g(header.)p eop end
-%%Page: 586 596
-TeXDict begin 586 595 bop 0 52 a FG(586)2013 b Fz(G)91
+%%Page: 592 602
+TeXDict begin 592 601 bop 0 52 a FG(592)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FG(3.)46
b(Another)23 b(c)m(hange)i(to)f(the)f(AST)p Fy(_)p FG(WRITE)f(routine)h
(within)g(the)g(FitsChan)g(class)h(is)g(that)f(the)h(ordering)227
@@ -142383,9 +142683,9 @@ y(attribute)i(of)g(the)g(Sp)s(ecF)-8 b(rame,)36 b(whereas)e(the)g
(attribute)227 5693 y(without)33 b(an)f(axis)h(sp)s(eci\014er)f(will)g
(refer)g(to)h(the)g(System)f(attribute)h(of)g(the)f(CmpF)-8
b(rame)33 b(as)f(a)h(whole,)p eop end
-%%Page: 587 597
-TeXDict begin 587 596 bop 0 52 a Fz(G.16)92 b(Changes)31
-b(In)m(tro)s(duced)e(in)h(V3.0)2249 b FG(587)227 351
+%%Page: 593 603
+TeXDict begin 593 602 bop 0 52 a Fz(G.16)92 b(Changes)31
+b(In)m(tro)s(duced)e(in)h(V3.0)2249 b FG(593)227 351
y(since)27 b(System)g(is)g(an)f(attribute)i(of)e(all)i(F)-8
b(rames,)29 b(and)d(a)h(CmpF)-8 b(rame)26 b(is)h(a)g(F)-8
b(rame)28 b(and)e(so)h(has)f(its)h(o)m(wn)227 464 y(System)j(v)-5
@@ -142459,8 +142759,8 @@ y Fu(\017)46 b FG(The)31 b(n)m(um)m(b)s(er)g(of)g(W)m(CS)h(axes)g(is)f
(stored)h(in)f(the)h(W)m(CSAXES)f(k)m(eyw)m(ord)h(if)g(its)g(v)-5
b(alue)32 b(w)m(ould)f(b)s(e)427 5693 y(di\013eren)m(t)g(to)g(that)g
(of)g(the)f(NAXIS)g(k)m(eyw)m(ord.)p eop end
-%%Page: 588 598
-TeXDict begin 588 597 bop 0 52 a FG(588)2013 b Fz(G)91
+%%Page: 594 604
+TeXDict begin 594 603 bop 0 52 a FG(594)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)336 351 y Fu(\017)46
b FG(Helio-ecliptic)j(co)s(ordinates)c(are)g(no)m(w)g(supp)s(orted)e(b)
m(y)h(FitsChans)h(whic)m(h)f(use)h(FITS-W)m(CS)427 464
@@ -142553,9 +142853,9 @@ b(rames)37 b(of)g(an)m(y)g(class)g(ma)m(y)g(no)m(w)g(include)f(an)h
b(includes)f(those)i(attributes)f(whic)m(h)g(describ)s(e)f(a)i(prop)s
(ert)m(y)e(of)h(the)h(whole)f(F)-8 b(rame.)40 b(F)-8
b(or)26 b(instance,)p eop end
-%%Page: 589 599
-TeXDict begin 589 598 bop 0 52 a Fz(G.17)92 b(Changes)31
-b(In)m(tro)s(duced)e(in)h(V3.1)2249 b FG(589)227 351
+%%Page: 595 605
+TeXDict begin 595 604 bop 0 52 a Fz(G.17)92 b(Changes)31
+b(In)m(tro)s(duced)e(in)h(V3.1)2249 b FG(595)227 351
y(the)39 b(Domain)h(attribute)g(ma)m(y)f(no)m(w)g(b)s(e)f(sp)s
(eci\014ed)h(as)g(\\Domain\(1\)")i(in)e(addition)g(to)h(the)f(simpler)
227 464 y(\\Domain".)61 b(In)35 b(cases)i(suc)m(h)f(as)h(this,)h(where)
@@ -142628,8 +142928,8 @@ b(v)m(ersions)g(V3.0)g(and)f(V3.1)i(\(the)f(curren)m(t)f(v)m(ersion\):)
(XmlChan)e(-)h(a)g(Channel)e(whic)m(h)i(reads)f(and)g(writes)h(AST)f
(ob)5 b(jects)227 5693 y(in)30 b(the)h(form)f(of)g(XML.)p
eop end
-%%Page: 590 600
-TeXDict begin 590 599 bop 0 52 a FG(590)2013 b Fz(G)91
+%%Page: 596 606
+TeXDict begin 596 605 bop 0 52 a FG(596)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FG(2.)46
b(A)30 b(bug)f(has)g(b)s(een)g(\014xed)g(in)g(the)g(Plot)i(class)f
(whic)m(h)f(could)h(cause)g(incorrect)g(graphical)h(attributes)f(to)227
@@ -142707,9 +143007,9 @@ g(graphics)f(escap)s(e)i(sequences)e(in)h(the)g(returned)227
(delimiter)g(c)m(haracters)i(b)s(eing)d(dra)m(wn)g(as)h(sup)s
(er-scripts)227 5693 y(when)k(plotted)h(as)f(n)m(umerical)h(axis)g(v)-5
b(alues)31 b(b)m(y)f(a)h(Plot.)p eop end
-%%Page: 591 601
-TeXDict begin 591 600 bop 0 52 a Fz(G.19)92 b(Changes)31
-b(In)m(tro)s(duced)e(in)h(V3.3)2249 b FG(591)66 351 y(10.)46
+%%Page: 597 607
+TeXDict begin 597 606 bop 0 52 a Fz(G.19)92 b(Changes)31
+b(In)m(tro)s(duced)e(in)h(V3.3)2249 b FG(597)66 351 y(10.)46
b(The)30 b(Plot)h(class)g(has)f(b)s(een)f(extended)h(to)h(include)f
(facilities)i(for)e(pro)s(ducing)f(logarithmic)j(axes.)41
b(See)227 464 y(attributes)31 b(LogPlot,)h(LogTic)m(ks,)g(LogGap)g(and)
@@ -142783,8 +143083,8 @@ b(FitsChan)f(class)i(whic)m(h)e(b)s(een)g(mo)s(di\014ed)g(to)h(in)m
(terpret)g(FITS-W)m(CS)g(CAR)f(pro)5 b(jection)30 b(headers)227
5693 y(correctly)i(if)e(the)h(longitude)g(reference)g(pixel)f
(\(CRPIX\))h(is)f(v)m(ery)h(large.)p eop end
-%%Page: 592 602
-TeXDict begin 592 601 bop 0 52 a FG(592)2013 b Fz(G)91
+%%Page: 598 608
+TeXDict begin 598 607 bop 0 52 a FG(598)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FG(4.)46
b(The)35 b(FITS-AIPS++)e(enco)s(ding)j(in)e(the)i(FitsChan)f(class)h
(no)m(w)f(recognised)h(sp)s(ectral)f(axes)h(if)f(they)227
@@ -142870,9 +143170,9 @@ b(This)33 b(is)h(a)g(sub-class)g(of)g(Sp)s(ecF)-8 b(rame)34
b(whic)m(h)227 5693 y(can)d(b)s(e)f(used)f(to)i(describ)s(e)f(sp)s
(ectral)h(axes)g(asso)s(ciated)h(with)e(dual)g(sideband)f(sp)s(ectral)i
(data.)p eop end
-%%Page: 593 603
-TeXDict begin 593 602 bop 0 52 a Fz(G.21)92 b(Changes)31
-b(In)m(tro)s(duced)e(in)h(V3.5)2249 b FG(593)111 351
+%%Page: 599 609
+TeXDict begin 599 608 bop 0 52 a Fz(G.21)92 b(Changes)31
+b(In)m(tro)s(duced)e(in)h(V3.5)2249 b FG(599)111 351
y(5.)46 b(The)d(FitsChan)g(class)i(will)e(no)m(w)h(read)f(headers)g
(whic)m(h)g(use)g(the)h(old)g(\\-GLS")g(pro)5 b(jection)44
b(co)s(de,)227 464 y(con)m(v)m(erting)d(them)f(to)g(the)f(corresp)s
@@ -142942,8 +143242,8 @@ b(Metho)s(ds)33 b(\(AST)p Fy(_)p FG(SETFITS<X>\))e(ha)m(v)m(e)i(b)s
(een)f(added)g(to)h(the)g(FitsChan)f(class)i(to)f(allo)m(w)h(v)-5
b(alues)33 b(for)227 5675 y(named)d(k)m(eyw)m(ords)h(to)g(b)s(e)f(c)m
(hanged)h(or)f(added.)p eop end
-%%Page: 594 604
-TeXDict begin 594 603 bop 0 52 a FG(594)2013 b Fz(G)91
+%%Page: 600 610
+TeXDict begin 600 609 bop 0 52 a FG(600)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)0 351 y Fw(G.22)112
b(Changes)39 b(In)m(tro)s(duced)f(in)f(V3.6)0 574 y FG(The)26
b(follo)m(wing)i(describ)s(es)d(the)i(most)f(signi\014can)m(t)i(c)m
@@ -143016,9 +143316,9 @@ b(supp)s(ort)d(for)i(reading)g(IV)m(O)m(A)h(Space-Time-Co)s(ordinates)g
(has)e(b)s(een)h(added.)39 b(Supp)s(ort)25 b(is)j(included)f(for)h(a)g
(subset)f(of)h(V1.20)h(of)f(the)227 5693 y(draft)i(STC)f(sp)s
(eci\014cation.)p eop end
-%%Page: 595 605
-TeXDict begin 595 604 bop 0 52 a Fz(G.25)92 b(Changes)31
-b(In)m(tro)s(duced)e(in)h(V4.1)2249 b FG(595)111 351
+%%Page: 601 611
+TeXDict begin 601 610 bop 0 52 a Fz(G.25)92 b(Changes)31
+b(In)m(tro)s(duced)e(in)h(V4.1)2249 b FG(601)111 351
y(2.)46 b(A)39 b(new)g(set)h(of)f(metho)s(ds)f(\(AST)p
Fy(_)p FG(REBIN<X>/astRebin<X>\))j(has)e(b)s(een)f(added)g(to)i(the)g
(Mapping)227 464 y(class.)e(These)20 b(are)h(\015ux-conserving)f
@@ -143088,8 +143388,8 @@ FG(The)26 b(follo)m(wing)i(describ)s(es)d(the)i(most)f(signi\014can)m
227 5693 y(the)31 b(o\013set)g(from)f(the)h(lo)s(cal)g(oscillator)i
(frequency)-8 b(,)31 b(rather)f(than)g(either)h(of)f(the)h(t)m(w)m(o)h
(sidebands.)p eop end
-%%Page: 596 606
-TeXDict begin 596 605 bop 0 52 a FG(596)2013 b Fz(G)91
+%%Page: 602 612
+TeXDict begin 602 611 bop 0 52 a FG(602)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FG(2.)46
b(The)37 b(FitsChan)g(class)h(has)g(b)s(een)e(c)m(hanged)i(so)g(that)g
(it)g(writes)f(out)h(a)g(VELOSYS)e(k)m(eyw)m(ord)h(when)227
@@ -143172,9 +143472,9 @@ f(in)f(V4.3)0 5580 y FG(The)26 b(follo)m(wing)i(describ)s(es)d(the)i
(most)f(signi\014can)m(t)i(c)m(hanges)f(whic)m(h)f(o)s(ccurred)g(in)g
(the)g(AST)g(library)g(b)s(et)m(w)m(een)0 5693 y(v)m(ersions)31
b(V4.2)g(and)f(V4.3:)p eop end
-%%Page: 597 607
-TeXDict begin 597 606 bop 0 52 a Fz(G.28)92 b(Changes)31
-b(In)m(tro)s(duced)e(in)h(V4.4)2249 b FG(597)111 351
+%%Page: 603 613
+TeXDict begin 603 612 bop 0 52 a Fz(G.28)92 b(Changes)31
+b(In)m(tro)s(duced)e(in)h(V4.4)2249 b FG(603)111 351
y(1.)46 b(The)35 b(AST)p Fy(_)p FG(GETFITSS)d(function)i(no)m(w)h
(strips)f(trailing)i(white)f(space)g(from)g(the)g(returned)e(string,)
227 464 y(if)e(the)f(original)i(string)e(con)m(tains)i(8)e(or)h(few)m
@@ -143259,8 +143559,8 @@ b(that)e(can)f(b)s(e)g(used)g(to)h(force)f(exterior)227
(orts)d(con)m(v)m(ersion)42 b(b)s(et)m(w)m(een)e(angle)h(based)e
(timescales)j(suc)m(h)d(as)227 5693 y(UT1)31 b(and)f(atomic)i(based)e
(timescales)i(suc)m(h)e(as)h(UTC.)p eop end
-%%Page: 598 608
-TeXDict begin 598 607 bop 0 52 a FG(598)2013 b Fz(G)91
+%%Page: 604 614
+TeXDict begin 604 613 bop 0 52 a FG(604)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)0 351 y Fw(G.29)112
b(Changes)39 b(In)m(tro)s(duced)f(in)f(V4.5)0 570 y FG(The)31
b(follo)m(wing)h(describ)s(es)f(the)g(most)h(signi\014can)m(t)g(c)m
@@ -143339,9 +143639,9 @@ h(of)g(the)f(Plot.)47 b(Previously)32 b(Lab)s(elUp)g(w)m(as)g(only)h
b(A)31 b(bug)f(has)g(b)s(een)f(\014xed)h(that)h(could)f(segmen)m
(tation)j(violations)f(when)d(setting)j(attribute)f(v)-5
b(alues.)p eop end
-%%Page: 599 609
-TeXDict begin 599 608 bop 0 52 a Fz(G.30)92 b(Changes)31
-b(In)m(tro)s(duced)e(in)h(V4.6)2249 b FG(599)0 351 y
+%%Page: 605 615
+TeXDict begin 605 614 bop 0 52 a Fz(G.30)92 b(Changes)31
+b(In)m(tro)s(duced)e(in)h(V4.6)2249 b FG(605)0 351 y
Fw(G.30)112 b(Changes)39 b(In)m(tro)s(duced)f(in)f(V4.6)0
566 y FG(The)g(follo)m(wing)h(describ)s(es)f(the)g(most)h(signi\014can)
m(t)g(c)m(hanges)g(whic)m(h)f(ha)m(v)m(e)i(o)s(ccurred)d(in)h(the)g
@@ -143408,8 +143708,8 @@ b(al)31 b(could)g(b)s(e)e(used)h(for)g(this)g(purp)s(ose.)111
b(The)36 b(c)m(hanges)j(mean)e(that)h(more)f(t)m(yp)s(es)g(of)g(Prism)g
(will)g(no)m(w)g(simplify)g(in)m(to)h(a)g(simpler)227
5693 y(class)31 b(of)g(Region.)p eop end
-%%Page: 600 610
-TeXDict begin 600 609 bop 0 52 a FG(600)2013 b Fz(G)91
+%%Page: 606 616
+TeXDict begin 606 615 bop 0 52 a FG(606)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FG(3.)46
b(The)36 b(P)m(oin)m(tList)h(class)g(has)f(a)h(new)e(metho)s(d,)i(AST)p
Fy(_)p FG(POINTS,)d(that)j(copies)g(the)f(axis)h(v)-5
@@ -143490,9 +143790,9 @@ i(when)d(creating)i(a)g(set)g(of)f(v)-5 b(alues)25 b(for)g(the)h
(a)f(v)-5 b(alue)31 b(to)f(it)g(when)e(reading)i(a)g(set)g(of)g
(OBSGEO-X/Y/Z)g(k)m(eyw)m(ord)g(v)-5 b(alues)30 b(from)227
5693 y(a)h(FITS)f(header.)p eop end
-%%Page: 601 611
-TeXDict begin 601 610 bop 0 52 a Fz(G.34)92 b(Changes)31
-b(In)m(tro)s(duced)e(in)h(V5.3)2249 b FG(601)111 351
+%%Page: 607 617
+TeXDict begin 607 616 bop 0 52 a Fz(G.34)92 b(Changes)31
+b(In)m(tro)s(duced)e(in)h(V5.3)2249 b FG(607)111 351
y(3.)46 b(The)21 b(TimeMap)g(con)m(v)m(ersions)h(\\TTTOTDB")f(and)g
(\\TDBTOTT",)g(and)f(the)i(Sp)s(ecMap)e(con)m(v)m(ersions)227
464 y(\\TPF2HL")38 b(and)e(\\HLF2TP",)i(no)m(w)f(ha)m(v)m(e)g(an)g
@@ -143573,8 +143873,8 @@ b(TCHAXES)21 b(to)h(the)g(F)-8 b(rame)22 b(class.)39
b(This)21 b(metho)s(d)g(allo)m(ws)h(corresp)s(onding)227
5693 y(axes)31 b(within)f(t)m(w)m(o)i(F)-8 b(rames)31
b(to)g(b)s(e)f(iden)m(ti\014ed.)p eop end
-%%Page: 602 612
-TeXDict begin 602 611 bop 0 52 a FG(602)2013 b Fz(G)91
+%%Page: 608 618
+TeXDict begin 608 617 bop 0 52 a FG(608)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FG(3.)46
b(The)22 b(AST)p Fy(_)p FG(ADDFRAME)h(metho)s(d)f(can)g(no)m(w)h(b)s(e)
e(used)h(to)h(app)s(end)d(one)j(or)f(more)h(axes)g(to)g(all)g(F)-8
@@ -143646,9 +143946,9 @@ g(the)g(string)h(\\<bad>")g(to)g(represen)m(t)f(the)g(\015oating)i(p)s
b(rather)g(than)f(the)h(literal)h(formatted)g(v)-5 b(alue)27
b(\(t)m(ypically)i(\\-1.797693134862)q(32)q(e+30)q(8")227
5693 y(\).)p eop end
-%%Page: 603 613
-TeXDict begin 603 612 bop 0 52 a Fz(G.36)92 b(Changes)31
-b(In)m(tro)s(duced)e(in)h(V5.3-2)2174 b FG(603)66 351
+%%Page: 609 619
+TeXDict begin 609 618 bop 0 52 a Fz(G.36)92 b(Changes)31
+b(In)m(tro)s(duced)e(in)h(V5.3-2)2174 b FG(609)66 351
y(14.)46 b(The)26 b(KeyMap)h(class)g(has)f(a)g(new)g(metho)s(d)g
(called)h(AST)p Fy(_)p FG(MAPPUTELEM<X>)f(that)h(allo)m(ws)g(a)g(v)-5
b(alue)227 464 y(to)25 b(b)s(e)d(put)h(in)m(to)i(a)f(single)g(elemen)m
@@ -143713,8 +144013,8 @@ b(are)h(held)f(in)g(v)-5 b(ariables)31 b(of)f(t)m(yp)s(e)h(BYTE.)111
(KeyCase)f(that)g(can)g(b)s(e)f(set)i(to)f(zero)g(to)h(mak)m(e)f(the)g
(handling)227 5693 y(of)31 b(k)m(eys)g(case)g(insensitiv)m(e.)p
eop end
-%%Page: 604 614
-TeXDict begin 604 613 bop 0 52 a FG(604)2013 b Fz(G)91
+%%Page: 610 620
+TeXDict begin 610 619 bop 0 52 a FG(610)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FG(6.)46
b(a)24 b(memory)f(leak)h(asso)s(ciated)g(with)f(the)g(use)g(of)g(the)g
(AST)p Fy(_)p FG(MAPPUTELEM<X>)g(functions)f(has)h(b)s(een)227
@@ -143783,9 +144083,9 @@ b(V5.6-0)h(and)e(V5.6-1:)111 5580 y(1.)46 b(T)-8 b(ables)40
b(can)f(no)m(w)g(ha)m(v)m(e)h(an)m(y)g(n)m(um)m(b)s(er)d(of)i
(parameters)h(describing)e(the)h(global)i(prop)s(erties)d(of)h(the)227
5693 y(T)-8 b(able.)p eop end
-%%Page: 605 615
-TeXDict begin 605 614 bop 0 52 a Fz(G.41)92 b(Changes)31
-b(In)m(tro)s(duced)e(in)h(V5.7-0)2174 b FG(605)111 351
+%%Page: 611 621
+TeXDict begin 611 620 bop 0 52 a Fz(G.41)92 b(Changes)31
+b(In)m(tro)s(duced)e(in)h(V5.7-0)2174 b FG(611)111 351
y(2.)46 b(F)-8 b(rames)29 b(no)m(w)f(in)m(terpret)g(the)h(unit)e
(string)h(\\A")h(as)f(meaning)g(\\Amp)s(ere")h(rather)e(than)h
(\\Angstrom",)227 464 y(as)j(sp)s(eci\014ed)f(b)m(y)g(FITS-W)m(CS)g
@@ -143856,8 +144156,8 @@ b(alues,)29 b(but)e(whic)m(h)g(do)s(es)h(not)g(pro)m(vide)g(an)f(in)m
b(metho)s(d)f(of)h(the)g(P)m(olyMap)g(class)h(to)227
5675 y(create)h(an)e(estimate)j(of)d(the)h(in)m(v)m(erse)g(p)s
(olynomial)g(correction.)p eop end
-%%Page: 606 616
-TeXDict begin 606 615 bop 0 52 a FG(606)2013 b Fz(G)91
+%%Page: 612 622
+TeXDict begin 612 621 bop 0 52 a FG(612)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)0 351 y Fw(G.43)112
b(Changes)39 b(In)m(tro)s(duced)f(in)f(V5.7-2)0 580 y
FG(The)26 b(follo)m(wing)i(describ)s(es)d(the)i(most)f(signi\014can)m
@@ -143924,9 +144224,9 @@ h(on)f(the)h(X)f(and)f(Y)i(axes.)227 5562 y(-)41 b(The)e(graphics)h
(axis)g(lab)s(els)h(can)f(no)m(w)g(b)s(e)227 5675 y(c)m(hanged)31
b(using)f(the)h(new)f(routine)g(AST)p Fy(_)p FG(TUNEC.)p
eop end
-%%Page: 607 617
-TeXDict begin 607 616 bop 0 52 a Fz(G.45)92 b(Changes)31
-b(In)m(tro)s(duced)e(in)h(V6.0-1)2174 b FG(607)0 351
+%%Page: 613 623
+TeXDict begin 613 622 bop 0 52 a Fz(G.45)92 b(Changes)31
+b(In)m(tro)s(duced)e(in)h(V6.0-1)2174 b FG(613)0 351
y Fw(G.45)112 b(Changes)39 b(In)m(tro)s(duced)f(in)f(V6.0-1)0
598 y FG(The)26 b(follo)m(wing)i(describ)s(es)d(the)i(most)f
(signi\014can)m(t)i(c)m(hanges)f(whic)m(h)f(o)s(ccurred)g(in)g(the)g
@@ -143976,8 +144276,8 @@ b(V7.0.1)h(and)e(V7.0.2:)111 5562 y(1.)46 b(The)34 b(libast)p
Fy(_)p FG(pal)h(library)f(is)h(no)f(longer)h(built)f(if)g(the)h
(\\{with-external)p Fy(_)p FG(pal")i(option)d(is)h(used)e(when)227
5675 y(AST)d(is)g(con\014gured.)p eop end
-%%Page: 608 618
-TeXDict begin 608 617 bop 0 52 a FG(608)2013 b Fz(G)91
+%%Page: 614 624
+TeXDict begin 614 623 bop 0 52 a FG(614)2013 b Fz(G)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)0 351 y Fw(G.49)112
b(Changes)39 b(In)m(tro)s(duced)f(in)f(V7.0.3)0 569 y
FG(The)26 b(follo)m(wing)i(describ)s(es)d(the)i(most)f(signi\014can)m
@@ -144034,66 +144334,97 @@ y(2.)46 b(When)30 b(reading)f(a)h(F)-8 b(rameSet)31 b(from)e(a)h
5675 y(no)m(w)i(default)f(to)h(zero)h(if)e(absen)m(t.)41
b(Previously)31 b(an)f(error)g(w)m(as)h(rep)s(orted.)p
eop end
-%%Page: 609 619
-TeXDict begin 609 618 bop 0 52 a Fz(G.53)92 b(Changes)31
-b(In)m(tro)s(duced)e(in)h(V7.1.0)2179 b FG(609)0 351
+%%Page: 615 625
+TeXDict begin 615 624 bop 0 52 a Fz(G.53)92 b(Changes)31
+b(In)m(tro)s(duced)e(in)h(V7.1.0)2179 b FG(615)0 351
y Fw(G.53)112 b(Changes)39 b(In)m(tro)s(duced)f(in)f(V7.1.0)0
-573 y FG(The)26 b(follo)m(wing)i(describ)s(es)d(the)i(most)f
+588 y FG(The)26 b(follo)m(wing)i(describ)s(es)d(the)i(most)f
(signi\014can)m(t)i(c)m(hanges)f(whic)m(h)f(o)s(ccurred)g(in)g(the)g
-(AST)g(library)g(b)s(et)m(w)m(een)0 686 y(v)m(ersions)31
-b(V7.0.6)h(and)e(V7.1.0:)111 948 y(1.)46 b(IMPOR)-8 b(T)g(ANT!)22
+(AST)g(library)g(b)s(et)m(w)m(een)0 701 y(v)m(ersions)31
+b(V7.0.6)h(and)e(V7.1.0:)111 995 y(1.)46 b(IMPOR)-8 b(T)g(ANT!)22
b(The)e(default)h(b)s(eha)m(viour)g(of)g(astRebinSeq)g(is)g(no)m(w)g
(NOT)g(to)h(conserv)m(e)g(\015ux.)36 b(T)-8 b(o)22 b(con-)227
-1061 y(serv)m(e)f(\015ux,)h(the)e(AST)p Fy(__)p FG(CONSER)-10
+1108 y(serv)m(e)f(\015ux,)h(the)e(AST)p Fy(__)p FG(CONSER)-10
b(VEFLUX)18 b(\015ag)j(should)e(b)s(e)h(supplied)f(when)g(calling)j
-(AST)p Fy(_)p FG(REBINSEQ<X>.)227 1174 y(Without)29 b(this)g(\015ag,)g
+(AST)p Fy(_)p FG(REBINSEQ<X>.)227 1221 y(Without)29 b(this)g(\015ag,)g
(eac)m(h)h(output)e(v)-5 b(alue)28 b(is)h(a)g(w)m(eigh)m(ted)g(mean)g
(of)f(the)h(neigh)m(b)s(ouring)e(input)h(v)-5 b(alues.)111
-1361 y(2.)46 b(A)32 b(new)e(\015ag)i(AST)p Fy(__)p FG(NONORM)e(can)i(b)
+1429 y(2.)46 b(A)32 b(new)e(\015ag)i(AST)p Fy(__)p FG(NONORM)e(can)i(b)
s(e)e(used)h(with)g(astRebinSeq<X>)h(to)g(indicate)g(that)g(normali-)
-227 1474 y(sation)c(of)f(the)g(output)f(arra)m(ys)i(is)f(not)g
+227 1542 y(sation)c(of)f(the)g(output)f(arra)m(ys)i(is)f(not)g
(required.)38 b(In)27 b(this)f(case)i(no)f(w)m(eigh)m(ts)h(arra)m(y)g
-(need)e(b)s(e)g(supplied.)111 1662 y(3.)46 b(A)c(bug)f(has)h(b)s(een)f
+(need)e(b)s(e)g(supplied.)111 1751 y(3.)46 b(A)c(bug)f(has)h(b)s(een)f
(\014xed)g(in)g(AST)p Fy(_)p FG(ADDFRAME)i(routine)e(that)i(could)f
-(result)f(in)h(the)g(incorrect)227 1775 y(in)m(v)m(ersion)26
+(result)f(in)h(the)g(incorrect)227 1864 y(in)m(v)m(ersion)26
b(of)e(Mappings)h(within)f(the)h(F)-8 b(rameSet)25 b(when)f(the)h(AST)p
-Fy(__)p FG(ALLFRAMES)e(\015ag)i(is)g(supplied)227 1888
-y(for)30 b(the)h(IFRAME)g(argumen)m(t.)111 2075 y(4.)46
+Fy(__)p FG(ALLFRAMES)e(\015ag)i(is)g(supplied)227 1976
+y(for)30 b(the)h(IFRAME)g(argumen)m(t.)111 2185 y(4.)46
b(The)30 b(AST)p Fy(_)p FG(RA)-8 b(TE)30 b(function)g(has)g(b)s(een)f
(re-written)i(to)g(mak)m(e)h(it)f(faster)f(and)g(more)h(reliable.)0
-2369 y Fw(G.54)112 b(Changes)39 b(In)m(tro)s(duced)f(in)f(V7.1.1)0
-2590 y FG(The)26 b(follo)m(wing)i(describ)s(es)d(the)i(most)f
+2513 y Fw(G.54)112 b(Changes)39 b(In)m(tro)s(duced)f(in)f(V7.1.1)0
+2750 y FG(The)26 b(follo)m(wing)i(describ)s(es)d(the)i(most)f
(signi\014can)m(t)i(c)m(hanges)f(whic)m(h)f(o)s(ccurred)g(in)g(the)g
-(AST)g(library)g(b)s(et)m(w)m(een)0 2703 y(v)m(ersions)31
-b(V7.1.0)h(and)e(V7.1.1:)111 2965 y(1.)46 b(When)41 b(a)g(FitsChan)g
+(AST)g(library)g(b)s(et)m(w)m(een)0 2863 y(v)m(ersions)31
+b(V7.1.0)h(and)e(V7.1.1:)111 3157 y(1.)46 b(When)41 b(a)g(FitsChan)g
(is)g(used)f(to)i(write)f(an)g(\\o\013set")i(SkyF)-8
b(rame)41 b(\(see)h(attribute)g(SkyRefIs\))e(to)i(a)227
-3078 y(FITS-W)m(CS)31 b(enco)s(ded)g(header,)h(t)m(w)m(o)g(alternate)i
+3270 y(FITS-W)m(CS)31 b(enco)s(ded)g(header,)h(t)m(w)m(o)g(alternate)i
(axis)d(descriptions)h(are)f(no)m(w)h(created)g(-)g(one)f(for)g(the)227
-3191 y(o\013set)k(co)s(ordinates)f(and)f(one)h(for)f(the)h(absolute)g
+3383 y(o\013set)k(co)s(ordinates)f(and)f(one)h(for)f(the)h(absolute)g
(co)s(ordinates.)51 b(If)33 b(suc)m(h)g(a)h(header)f(is)h(subsequen)m
-(tly)227 3304 y(read)d(bac)m(k)g(in)m(to)g(AST,)f(the)g(original)i
-(o\013set)f(SkyF)-8 b(rame)31 b(is)g(recreated.)111 3492
+(tly)227 3496 y(read)d(bac)m(k)g(in)m(to)g(AST,)f(the)g(original)i
+(o\013set)f(SkyF)-8 b(rame)31 b(is)g(recreated.)111 3704
y(2.)46 b(A)22 b(bug)f(has)g(b)s(een)g(\014xed)g(in)g(FitsChan)h(that)g
(caused)f(inappropriate)h(CTYPE)e(v)-5 b(alues)22 b(to)h(b)s(e)d
-(generated)227 3605 y(when)25 b(writing)h(a)g(F)-8 b(rameSet)27
+(generated)227 3817 y(when)25 b(writing)h(a)g(F)-8 b(rameSet)27
b(to)g(FITS-W)m(CS)e(headers)h(if)g(the)g(curren)m(t)g(F)-8
-b(rame)26 b(describ)s(es)f(generalised)227 3718 y(spherical)31
+b(rame)26 b(describ)s(es)f(generalised)227 3930 y(spherical)31
b(co)s(ordinates)g(\(i.e.)42 b(a)31 b(SkyF)-8 b(rame)30
-b(with)g(System=Unkno)m(wn\).)0 4011 y Fw(G.55)112 b(Changes)39
-b(In)m(tro)s(duced)f(in)f(V7.2.0)0 4232 y FG(The)g(follo)m(wing)h
-(describ)s(es)f(the)g(most)h(signi\014can)m(t)g(c)m(hanges)g(whic)m(h)f
-(ha)m(v)m(e)i(o)s(ccurred)d(in)h(the)g(AST)g(library)0
-4345 y(b)s(et)m(w)m(een)31 b(v)m(ersions)g(V7.1.1)h(and)e(V7.2.0)i
-(\(the)f(curren)m(t)f(v)m(ersion\):)111 4607 y(1.)46
-b(A)30 b(new)f(metho)s(d)h(call)h(AST)p Fy(_)p FG(MAPDEFINED)f(has)f(b)
-s(een)g(added)g(to)i(the)f(KeyMap)g(class.)41 b(It)30
-b(c)m(hec)m(ks)227 4720 y(if)h(a)f(gtiv)m(en)i(k)m(ey)f(name)g(has)f(a)
-h(de\014ned)e(v)-5 b(alue)31 b(in)f(a)g(giv)m(en)i(KeyMap.)0
-4983 y(Programs)25 b(whic)m(h)g(are)h(statically)h(link)m(ed)f(will)f
-(need)g(to)h(b)s(e)f(re-link)m(ed)g(in)g(order)g(to)h(tak)m(e)h(adv)-5
-b(an)m(tage)27 b(of)e(these)0 5096 y(new)30 b(facilities.)p
-eop end
+b(with)g(System=Unkno)m(wn\).)0 4258 y Fw(G.55)112 b(Changes)39
+b(In)m(tro)s(duced)f(in)f(V7.2.0)0 4495 y FG(The)26 b(follo)m(wing)i
+(describ)s(es)d(the)i(most)f(signi\014can)m(t)i(c)m(hanges)f(whic)m(h)f
+(o)s(ccurred)g(in)g(the)g(AST)g(library)g(b)s(et)m(w)m(een)0
+4608 y(v)m(ersions)31 b(V7.1.1)h(and)e(V7.2.0:)111 4902
+y(1.)46 b(A)30 b(new)f(metho)s(d)h(call)h(AST)p Fy(_)p
+FG(MAPDEFINED)f(has)f(b)s(een)g(added)g(to)i(the)f(KeyMap)g(class.)41
+b(It)30 b(c)m(hec)m(ks)227 5015 y(if)h(a)f(gtiv)m(en)i(k)m(ey)f(name)g
+(has)f(a)h(de\014ned)e(v)-5 b(alue)31 b(in)f(a)g(giv)m(en)i(KeyMap.)0
+5343 y Fw(G.56)112 b(Changes)39 b(In)m(tro)s(duced)f(in)f(V7.3.0)0
+5580 y FG(The)g(follo)m(wing)h(describ)s(es)f(the)g(most)h
+(signi\014can)m(t)g(c)m(hanges)g(whic)m(h)f(ha)m(v)m(e)i(o)s(ccurred)d
+(in)h(the)g(AST)g(library)0 5693 y(b)s(et)m(w)m(een)31
+b(v)m(ersions)g(V7.2.0)h(and)e(V7.3.0)i(\(the)f(curren)m(t)f(v)m
+(ersion\):)p eop end
+%%Page: 616 626
+TeXDict begin 616 625 bop 0 52 a FG(616)2013 b Fz(G)91
+b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FG(1.)46
+b(The)26 b(in)m(terface)h(for)f(the)g(AST)p Fy(_)p FG(REBINSEQ<X>)e
+(family)j(of)f(routines)f(has)h(b)s(een)f(c)m(hanged)i(in)e(order)h(to)
+227 464 y(allo)m(w)j(a)f(greater)g(n)m(um)m(b)s(er)e(of)i(pixels)f(to)h
+(b)s(e)f(pasted)g(in)m(to)i(the)e(output)g(arra)m(y)-8
+b(.)41 b(The)27 b(NUSED)g(parame-)227 577 y(ter)41 b(is)g(no)m(w)g(an)f
+(INTEGER*8)i(v)-5 b(ariable,)44 b(instead)d(of)g(an)f(INTEGER.)h
+(APPLICA)-8 b(TION)40 b(CODE)227 690 y(SHOULD)49 b(BE)g(CHANGED)g(A)m
+(CCORDINGL)-8 b(Y)50 b(TO)e(A)-10 b(V)m(OID)49 b(SEGMENT)-8
+b(A)g(TION)49 b(F)-10 b(A)m(UL)i(TS)227 803 y(AND)31
+b(OTHER)f(ERRA)-8 b(TIC)30 b(BEHA)-10 b(VIOUR.)111 991
+y(2.)46 b(Added)39 b(a)h(new)f(facilit)m(y)j(to)e(the)g(F)-8
+b(rameSet)40 b(class)h(to)f(allo)m(w)h(eac)m(h)g(F)-8
+b(rame)40 b(to)h(b)s(e)e(asso)s(ciated)i(with)227 1103
+y(m)m(ultiple)j(Mappings,)j(an)m(y)d(one)f(of)h(whic)m(h)f(can)h(b)s(e)
+f(used)f(to)i(connect)h(the)e(F)-8 b(rame)44 b(to)h(the)e(other)227
+1216 y(F)-8 b(rames)38 b(in)e(the)i(F)-8 b(rameSet.)61
+b(The)36 b(c)m(hoice)j(of)e(whic)m(h)g(Mapping)g(to)g(use)g(is)g(con)m
+(trolled)h(b)m(y)f(the)g(new)227 1329 y(\\V)-8 b(arian)m(t")33
+b(attribute)e(of)g(the)f(F)-8 b(rameSet)32 b(class.)111
+1517 y(3.)46 b(Mappings)38 b(\(but)g(not)g(F)-8 b(rames\))39
+b(that)g(ha)m(v)m(e)g(a)f(v)-5 b(alue)38 b(set)h(for)f(their)g(Iden)m
+(t)g(attribute)g(are)h(no)m(w)f(left)227 1630 y(unc)m(hanged)30
+b(b)m(y)h(the)f(c)h(astSimplify)f(function.)40 b(f)31
+b(AST)p Fy(_)p FG(SIMPLIFY)e(routine.)0 1892 y(Programs)c(whic)m(h)g
+(are)h(statically)h(link)m(ed)f(will)f(need)g(to)h(b)s(e)f(re-link)m
+(ed)g(in)g(order)g(to)h(tak)m(e)h(adv)-5 b(an)m(tage)27
+b(of)e(these)0 2005 y(new)30 b(facilities.)p eop end
%%Trailer
userdict /end-hook known{end-hook}if
diff --git a/sun210.tex b/sun210.tex
index b54701d..97249a8 100644
--- a/sun210.tex
+++ b/sun210.tex
@@ -19,15 +19,15 @@
% Variable part - replace [xxx] as appropriate.
\newcommand{\stardocnumber} {210.27}
\newcommand{\stardocauthors} {R.F. Warren-Smith \& D.S. Berry}
-\newcommand{\stardocdate} {7th December 2012}
+\newcommand{\stardocdate} {29th April 2013}
\newcommand{\stardoctitle} {AST\\
A Library for Handling\\
World Coordinate Systems\\
in Astronomy}
-\newcommand{\stardoccopyright} {Copyright (C) 2012 Science \& Technology Facilities Council}
+\newcommand{\stardoccopyright} {Copyright (C) 2013 Science \& Technology Facilities Council}
\newcommand{\stardoctitlehtml} {AST - A Library for Handling World Coordinate
Systems in Astronomy}
-\newcommand{\stardocversion} {V7.2}
+\newcommand{\stardocversion} {V7.3}
\newcommand{\stardocmanual} {Programmer's Guide\\(Fortran Version)}
\newcommand{\stardocmanualhtml}{Programmer's Guide (Fortran Version)}
\newcommand{\stardocabstract} {
@@ -12124,6 +12124,70 @@ Object - Base class for all AST Objects
}
}
\sstroutine{
+ AST\_ADDVARIANT\sstlabel{AST_ADDVARIANT}
+}{
+ Store a new variant Mapping for the current Frame in a FrameSet
+}{
+ \sstdescription{
+ This routine
+ allows a new variant \htmlref{Mapping}{Mapping} to be stored with the current \htmlref{Frame}{Frame}
+ in a \htmlref{FrameSet}{FrameSet}. See the {\tt{"}}\htmlref{Variant}{Variant}{\tt{"}} attribute for more details. It can
+ also be used to rename the currently selected variant Mapping.
+ }
+ \sstinvocation{
+ CALL AST\_ADDVARIANT( THIS, MAP, NAME, STATUS )
+ }
+ \sstarguments{
+ \sstsubsection{
+ THIS = INTEGER (Given)
+ }{
+ Pointer to the FrameSet.
+ }
+ \sstsubsection{
+ MAP = INTEGER (Given)
+ }{
+ Pointer to a Mapping which describes how to convert
+ coordinates from the current Frame to the new variant of the
+ current Frame. If
+ AST\_\_NULL
+ is supplied, then the name associated with the currently selected
+ variant of the current Frame is set to the value supplied for
+ NAME, but no new variant is added.
+ }
+ \sstsubsection{
+ NAME = CHARACTER $*$ ( $*$ ) (Given)
+ }{
+ The name to associate with the new variant Mapping (or the currently
+ selected variant Mapping if
+ MAP is AST\_\_NULL).
+ }
+ \sstsubsection{
+ STATUS = INTEGER (Given and Returned)
+ }{
+ The global status.
+ }
+ }
+ \sstnotes{
+ \sstitemlist{
+
+ \sstitem
+ The newly added Variant becomes the current variant on exit (this is
+ equivalent to setting the Variant attribute to the value supplied for
+ NAME).
+
+ \sstitem
+ An error is reported if a variant with the supplied name already
+ exists in the current Frame.
+
+ \sstitem
+ An error is reported if the current Frame is a mirror for the
+ variant Mappings in another Frame. This is only the case if the
+ \htmlref{AST\_MIRRORVARIANTS}{AST_MIRRORVARIANTS} routine
+ has been called to make the current Frame act as a mirror.
+ }
+ }
+}
+\sstroutine{
AST\_ANGLE\sstlabel{AST_ANGLE}
}{
Calculate the angle subtended by two points at a third point
@@ -22383,6 +22447,84 @@ Object - Base class for all AST Objects
}
}
\sstroutine{
+ AST\_MIRRORVARIANTS\sstlabel{AST_MIRRORVARIANTS}
+}{
+ Make the current Frame mirror the variant Mappings in another Frame
+}{
+ \sstdescription{
+ This routine
+ indicates that all access to the \htmlref{Variant}{Variant} attribute of the current
+ \htmlref{Frame}{Frame} should should be forwarded to some other nominated Frame in
+ the \htmlref{FrameSet}{FrameSet}. For instance, if a value is set subsequently for the
+ Variant attribute of the current Frame, the current Frame will be left
+ unchanged and the setting is instead applied to the nominated Frame.
+ Likewise, if the value of the Variant attribute is requested, the
+ value returned is the value stored for the nominated Frame rather
+ than the current Frame itself.
+
+ This provides a mechanism for propagating the effects of variant
+ Mappings around a FrameSet. If a new Frame is added to a FrameSet
+ by connecting it to an pre-existing Frame that has two or more variant
+ Mappings, then it may be appropriate to set the new Frame so that it
+ mirrors the variants Mappings of the pre-existing Frame. If this is
+ done, then it will be possible to select a specific variant \htmlref{Mapping}{Mapping}
+ using either the pre-existing Frame or the new Frame.
+ }
+ \sstinvocation{
+ CALL AST\_MIRRORVARIANTS( THIS, IFRAME, STATUS )
+ }
+ \sstarguments{
+ \sstsubsection{
+ THIS = INTEGER (Given)
+ }{
+ Pointer to the FrameSet.
+ }
+ \sstsubsection{
+ IFRAME = INTEGER (Given)
+ }{
+ The index of the Frame within the FrameSet which is to be
+ mirrored by the current Frame. This value should lie in the range
+ from 1 to the number of Frames in the FrameSet (as given by its
+ \htmlref{Nframe}{Nframe} attribute). If AST\_\_NOFRAME is supplied (or the current
+ Frame is specified), then any mirroring established by a previous
+ call to this
+ routine
+ is disabled.
+ }
+ \sstsubsection{
+ STATUS = INTEGER (Given and Returned)
+ }{
+ The global status.
+ }
+ }
+ \sstnotes{
+ \sstitemlist{
+
+ \sstitem
+ Mirrors can be chained. That is, if Frame B is set to be a mirror
+ of Frame A, and Frame C is set to be a mirror of Frame B, then
+ Frame C will act as a mirror of Frame A.
+
+ \sstitem
+ Variant Mappings cannot be added to the current Frame if it is
+ mirroring another Frame. So calls to the
+ \htmlref{AST\_ADDVARIANT}{AST_ADDVARIANT} routine
+ will cause an error to be reported if the current Frame is
+ mirroring another Frame.
+
+ \sstitem
+ A value of AST\_\_BASE may be given for the
+ IFRAME argument
+ to specify the base Frame.
+
+ \sstitem
+ Any variant Mappings explicitly added to the current Frame using
+ AST\_ADDVARIANT
+ will be ignored if the current Frame is mirroring another Frame.
+ }
+ }
+}
+\sstroutine{
AST\_NEGATE\sstlabel{AST_NEGATE}
}{
Negate the area represented by a Region
@@ -26244,7 +26386,7 @@ Object - Base class for all AST Objects
(i.e. normal Fortran array storage order).
}
\sstsubsection{
- NUSED = INTEGER (Given and Returned)
+ NUSED = INTEGER$*$8 (Given and Returned)
}{
The
number of input data values that have been added into the output
@@ -26517,6 +26659,11 @@ Object - Base class for all AST Objects
axes. To achieve this, a new Frame must be added to the FrameSet
(\htmlref{AST\_ADDFRAME}{AST_ADDFRAME}) and the original one removed if necessary
(\htmlref{AST\_REMOVEFRAME}{AST_REMOVEFRAME}).
+
+ \sstitem
+ Any variant Mappings associated with the remapped Frame (except
+ for the current variant) will be lost as a consequence of calling this
+ method (see attribute {\tt{"}}\htmlref{Variant}{Variant}{\tt{"}}).
}
}
}
@@ -28812,6 +28959,12 @@ Object - Base class for all AST Objects
\sstitemlist{
\sstitem
+ Mappings that have a set value for their \htmlref{Ident}{Ident} attribute are
+ left unchanged after simplification. This is so that their
+ individual identity is preserved. This restriction does not
+ apply to the simplification of Frames.
+
+ \sstitem
This function can safely be applied even to Mappings which
cannot be simplified. If no simplification is possible, it
behaves exactly like \htmlref{AST\_CLONE}{AST_CLONE} and returns a pointer to the
@@ -33855,6 +34008,29 @@ Object - Base class for all AST Objects
}
}
\sstroutine{
+ AllVariants\sstlabel{AllVariants}
+}{
+ A list of the variant Mappings associated with the current Frame
+}{
+ \sstdescription{
+ This attrbute gives a space separated list of the names of all the
+ variant Mappings associated with the current \htmlref{Frame}{Frame} (see attribute
+ {\tt{"}}\htmlref{Variant}{Variant}{\tt{"}}). If the current Frame has no variant Mappings, then the
+ list will hold a single entry equal to the \htmlref{Domain}{Domain} name of the
+ current Frame.
+ }
+ \sstattributetype{
+ String, read-only.
+ }
+ \sstapplicability{
+ \sstsubsection{
+ \htmlref{FrameSet}{FrameSet}
+ }{
+ All FrameSets have this attribute.
+ }
+ }
+}
+\sstroutine{
AllWarnings\sstlabel{AllWarnings}
}{
A list of all currently available condition names
@@ -35360,7 +35536,7 @@ Object - Base class for all AST Objects
\sstitem
Otherwise, FITS-CLASS is used if the FitsChan contains a DELTAV
keyword and a keyword of the form VELO-xxx, where xxx indicates one
- of the rest frames used by class (e.g. {\tt{"}}VELO-LSR{\tt{"}}).
+ of the rest frames used by class (e.g. {\tt{"}}VELO-LSR{\tt{"}}), or {\tt{"}}VLSR{\tt{"}}.
\sstitem
Otherwise, if the FitsChan contains a CTYPE keyword which
@@ -42306,6 +42482,108 @@ Object - Base class for all AST Objects
}
}
\sstroutine{
+ Variant\sstlabel{Variant}
+}{
+ Indicates which variant of the current Frame is to be used
+}{
+ \sstdescription{
+ This attribute can be used to change the \htmlref{Mapping}{Mapping} that connects the
+ current \htmlref{Frame}{Frame} to the other Frames in the \htmlref{FrameSet}{FrameSet}. By default, each
+ Frame in a FrameSet is connected to the other Frames by a single
+ Mapping that can only be changed by using the
+ \htmlref{AST\_REMAPFRAME}{AST_REMAPFRAME}
+ method. However, it is also possible to associate multiple Mappings
+ with a Frame, each Mapping having an identifying name. If this is
+ done, the {\tt{"}}Variant{\tt{"}} attribute can be set to indicate the name of
+ the Mapping that is to be used with the current Frame.
+
+ A possible (if unlikely) use-case is to create a FrameSet that can
+ be used to describe the WCS of an image formed by co-adding images
+ of two different parts of the sky. In such an image, each pixel contains
+ flux from two points on the sky.and so the WCS for the image should
+ ideally contain one pixel Frame and two SkyFrames - one describing
+ each of the two co-added images. There is nothing to prevent a
+ FrameSet containing two explicit SkyFrames, but the problem then arises
+ of how to distinguish between them. The two primary characteristics of
+ a Frame that distinguishes it from other Frames ar eits class and its
+ \htmlref{Domain}{Domain} attribute value. The class of a Frame cannot be changed, but we
+ could in principle use two different Domain values to distinguish the
+ two SkyFrames. However, in practice it is not uncommon for application
+ software to assume that SkyFrames will have the default Domain value
+ of {\tt{"}}SKY{\tt{"}}. That is, instead of searching for Frames that have a class
+ of {\tt{"}}\htmlref{SkyFrame}{SkyFrame}{\tt{"}}, such software searches for Frames that have a Domain
+ of {\tt{"}}SKY{\tt{"}}. To alleviate this problem, it is possible to add a single
+ SkyFrame to the FrameSet, but specifying two alternate Mappings to
+ use with the SkyFrame. Setting the {\tt{"}}Variant{\tt{"}} attribute to the name
+ of one or the other of these alternate Mappings will cause the
+ SkyFrame to be remapped within the FrameSet so that it uses the
+ specified Mapping. The same facility can be used with any class of
+ Frame, not just SkyFrames.
+
+ To use this facility, the Frame should first be added to the
+ FrameSet in the usual manner using the
+ \htmlref{AST\_ADDFRAME}{AST_ADDFRAME} method. By default, the Mapping supplied to \htmlref{AST\_ADDVARIANT}{AST_ADDVARIANT}
+ is assigned a name equal to the Domain name of the Frame. To assign a
+ different name to it, the
+ AST\_ADDVARIANT
+ method should then be called specifying the required name and a NULL
+ Mapping. The
+ AST\_ADDFRAME
+ method should then be called repeatedly to add each required extra
+ Mapping to the current Frame, supplying a unique name for each one.
+
+ Each Frame in a FrameSet can have its own set of variant Mappings.
+ To control the Mappings in use with a specific Frame, you need first
+ to make it the current Frame in the FrameSet.
+
+ The
+ \htmlref{AST\_MIRRORVARIANTS}{AST_MIRRORVARIANTS} routine
+ allows the effects of variant Mappings associated with a nominated
+ Frame to be propagated to other Frames in the FrameSet.
+
+ Once this has been done, setting a new value for the {\tt{"}}Variant{\tt{"}}
+ attribute of a FrameSet will cause the current Frame in the
+ FrameSet to be remapped to use the specified variant Mapping. An
+ error will be reported if the current Frame has no variant Mapping
+ with the supplied name.
+
+ Getting the value of the {\tt{"}}Variant{\tt{"}} attribute will return the name
+ of the variant Mapping currently in use with the current Frame. If
+ the Frame has no variant Mappings, the value will default to the
+ Domain name of the current Frame.
+
+ Clearing the {\tt{"}}Variant{\tt{"}} attribute will have the effect of removing
+ all variant Mappings (except for the currently selected Mapping) from
+ the current Frame.
+
+ Testing the {\tt{"}}Variant{\tt{"}} attribute will return
+ .TRUE.
+ if the current Frame contains any variant Mappings, and
+ .FALSE.
+ otherwise.
+
+ A complete list of the names associated with all the available
+ variant Mappings in the current Frame can be obtained from the
+ \htmlref{AllVariants}{AllVariants} attribute.
+
+ If a Frame with variant Mappings is remapped using the
+ AST\_REMAPFRAME
+ method, the currently selected variant Mapping is used by
+ AST\_REMAPFRAME
+ and the other variant Mappings are removed from the Frame.
+ }
+ \sstattributetype{
+ String.
+ }
+ \sstapplicability{
+ \sstsubsection{
+ FrameSet
+ }{
+ All FrameSets have this attribute.
+ }
+ }
+}
+\sstroutine{
Warnings\sstlabel{Warnings}
}{
Controls the issuing of warnings about various conditions
@@ -43801,6 +44079,9 @@ Object - Base class for all AST Objects
\sstitemlist{
\sstitem
+ \htmlref{AllVariants}{AllVariants}: List of all variant mappings store with current Frame
+
+ \sstitem
\htmlref{Base}{Base}: FrameSet base Frame index
\sstitem
@@ -43809,6 +44090,9 @@ Object - Base class for all AST Objects
\sstitem
\htmlref{Nframe}{Nframe}: Number of Frames in a FrameSet
+ \sstitem
+ \htmlref{Variant}{Variant}: Name of variant mapping in use by current Frame
+
}
Every FrameSet also inherits any further attributes that belong
to its current Frame, regardless of that Frame's class. (For
@@ -43830,12 +44114,18 @@ Object - Base class for all AST Objects
system
\sstitem
+ \htmlref{AST\_ADDVARIANT}{AST_ADDVARIANT}: Add a variant Mapping to the current Frame
+
+ \sstitem
\htmlref{AST\_GETFRAME}{AST_GETFRAME}: Obtain a pointer to a specified Frame in a FrameSet
\sstitem
\htmlref{AST\_GETMAPPING}{AST_GETMAPPING}: Obtain a Mapping between two Frames in a FrameSet
\sstitem
+ \htmlref{AST\_MIRRORVARIANTS}{AST_MIRRORVARIANTS}: Make the current Frame mirror variant Mappings in another Frame
+
+ \sstitem
\htmlref{AST\_REMAPFRAME}{AST_REMAPFRAME}: Modify a Frame's relationship to the other Frames in a
FrameSet
@@ -50281,12 +50571,10 @@ SkyFrame with \htmlref{System}{System}=Unknown).
\end{enumerate}
-\subsection{\xlabel{changes}\xlabel{list_of_most_recent_changes}Changes
-Introduced in V7.2.0}
+\subsection{Changes Introduced in V7.2.0}
-The following describes the most significant changes which have
-occurred in the AST library between versions V7.1.1 and V7.2.0 (the
-current version):
+The following describes the most significant changes which
+occurred in the AST library between versions V7.1.1 and V7.2.0:
\begin{enumerate}
@@ -50297,6 +50585,34 @@ a defined value in a given KeyMap.
\end{enumerate}
+\subsection{\xlabel{changes}\xlabel{list_of_most_recent_changes}Changes
+Introduced in V7.3.0}
+
+The following describes the most significant changes which have
+occurred in the AST library between versions V7.2.0 and V7.3.0 (the
+current version):
+
+\begin{enumerate}
+
+\item The interface for the AST\_REBINSEQ<X> family of routines has
+been changed in order to allow a greater number of pixels to be pasted
+into the output array. The NUSED parameter is now an INTEGER*8 variable,
+instead of an INTEGER. APPLICATION CODE SHOULD BE CHANGED ACCORDINGLY TO
+AVOID SEGMENTATION FAULTS AND OTHER ERRATIC BEHAVIOUR.
+
+\item Added a new facility to the \htmlref{FrameSet}{FrameSet} class to allow each \htmlref{Frame}{Frame} to be
+associated with multiple Mappings, any one of which can be used to
+connect the Frame to the other Frames in the FrameSet. The choice of
+which \htmlref{Mapping}{Mapping} to use is controlled by the new ``\htmlref{Variant}{Variant}'' attribute of the
+FrameSet class.
+
+\item Mappings (but not Frames) that have a value set for their \htmlref{Ident}{Ident}
+attribute are now left unchanged by the
+c astSimplify function.
+f \htmlref{AST\_SIMPLIFY}{AST_SIMPLIFY} routine.
+
+\end{enumerate}
+
Programs which are statically linked will need to be re-linked in
order to take advantage of these new facilities.
diff --git a/sun211.htx_tar b/sun211.htx_tar
index 6765d24..bebcde3 100644
Binary files a/sun211.htx_tar and b/sun211.htx_tar differ
diff --git a/sun211.ps b/sun211.ps
index 3dbd728..480c01e 100644
--- a/sun211.ps
+++ b/sun211.ps
@@ -1,8 +1,8 @@
%!PS-Adobe-2.0
%%Creator: dvips(k) 5.96.1 Copyright 2007 Radical Eye Software
%%Title: sun211.dvi
-%%CreationDate: Mon Apr 15 12:41:12 2013
-%%Pages: 640
+%%CreationDate: Thu May 30 12:03:20 2013
+%%Pages: 642
%%PageOrder: Ascend
%%BoundingBox: 0 0 595 842
%%DocumentFonts: CMR10 CMCSC10 CMBX10 CMR12 CMBX12 CMSL10 CMTI10 CMR8
@@ -13,7 +13,7 @@
%DVIPSWebPage: (www.radicaleye.com)
%DVIPSCommandLine: dvips -f sun211
%DVIPSParameters: dpi=600
-%DVIPSSource: TeX output 2013.04.15:1241
+%DVIPSSource: TeX output 2013.05.30:1203
%%BeginProcSet: tex.pro 0 0
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -6229,7 +6229,7 @@ rf /Fy 131[91 2[48 48 66 48 51 35 36 36 1[51 45 51 76
101 92 101 105 128 81 105 1[50 105 106 85 88 103 97 96
102 7[67 67 67 67 67 67 67 67 67 67 67 37 45 3[52 52
27[75 78 11[{}68 119.552 /CMBX12 rf /FA 169[122 30[81
-4[81 3[45 46[{}4 143.462 /CMBX12 rf /FB 134[123 3[129
+3[81 4[45 46[{}4 143.462 /CMBX12 rf /FB 134[123 3[129
90 92 95 2[116 129 194 65 2[65 1[116 71 106 129 1[129
113 9[240 175 1[162 129 2[159 3[140 3[182 183 3[168 1[175
23[90 90 65 39[{}29 206.559 /CMBX12 rf /FC 134[51 51
@@ -6263,11 +6263,11 @@ h(Appleton)h(Labora)-6 b(tor)g(y)1176 b FD(SUN/211.27)0
464 y FC(P)m(article)34 b(Ph)m(ysics)h(&)d(Astronom)m(y)i(Researc)m(h)g
(Council)0 577 y(Starlink)f(Pro)5 b(ject)0 690 y(Starlink)33
b(User)h(Note)e(211.27)2455 927 y FF(R.F.)f(W)-8 b(arren-Smith)31
-b(&)f(D.S.)h(Berry)3013 1040 y(7th)f(Decem)m(b)s(er)i(2012)p
+b(&)f(D.S.)h(Berry)3156 1040 y(29th)g(April)f(2013)p
0 1183 3780 12 v 1657 1504 a FB(AST)702 1754 y(A)78 b(Library)e(for)h
(Handling)520 2003 y(W)-19 b(orld)77 b(Co)6 b(ordinate)78
b(Systems)1192 2252 y(in)f(Astronom)-6 b(y)1726 2618
-y FA(V7.2)826 2931 y FB(Programmer's)76 b(Guide)1297
+y FA(V7.3)826 2931 y FB(Programmer's)76 b(Guide)1297
3134 y(\(C)i(V)-19 b(ersion\))245 3396 y
gsave currentpoint currentpoint translate -90 neg rotate neg exch neg exch translate
245 3396 a @beginspecial
@@ -48406,7 +48406,7 @@ g(and)g(for)g(generating)i(graphical)f(output)f(based)g(on)g(it.)0
(t-indep)s(enden)m(t.)p eop end
%%Page: 2 2
TeXDict begin 2 1 bop 0 52 a FF(ii)3245 b Fy(SUN/211.27)0
-5670 y FF(Cop)m(yrigh)m(t)31 b(\(C\))g(2012)h(Science)f(&)f(T)-8
+5670 y FF(Cop)m(yrigh)m(t)31 b(\(C\))g(2013)h(Science)f(&)f(T)-8
b(ec)m(hnology)32 b(F)-8 b(acilities)34 b(Council)p eop
end
%%Page: 3 3
@@ -49018,227 +49018,230 @@ b(AST)g(Class)f(Hierarc)m(h)m(y)2307 b(189)0 5058 y(B)62
b(AST)35 b(F)-9 b(unction)36 b(Descriptions)2241 b(191)0
5269 y(C)60 b(AST)35 b(A)m(ttribute)f(Descriptions)2207
b(417)0 5481 y(D)56 b(AST)35 b(Class)g(Descriptions)2403
-b(521)0 5693 y(E)67 b(UNIX)35 b(Command)g(Descriptions)2101
-b(567)p eop end
+b(523)0 5693 y(E)67 b(UNIX)35 b(Command)g(Descriptions)2101
+b(569)p eop end
%%Page: 8 8
TeXDict begin 8 7 bop 0 52 a FF(viii)3140 b Fy(CONTENTS)0
351 y FD(F)70 b(AST)35 b(Memory)h(Managemen)m(t)f(and)f(Utilit)m(y)h(F)
--9 b(unctions)1220 b(571)0 563 y(G)54 b(FITS-W)m(CS)34
-b(Co)m(v)m(erage)2523 b(585)136 677 y FF(G.1)68 b(P)m(ap)s(er)31
+-9 b(unctions)1220 b(573)0 563 y(G)54 b(FITS-W)m(CS)34
+b(Co)m(v)m(erage)2523 b(587)136 677 y FF(G.1)68 b(P)m(ap)s(er)31
b(I)f(-)g(General)i(Linear)e(Co)s(ordinates)c(.)46 b(.)f(.)h(.)g(.)g(.)
f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f
-(.)h(.)60 b(585)345 791 y(G.1.1)80 b(Requiremen)m(ts)31
+(.)h(.)60 b(587)345 791 y(G.1.1)80 b(Requiremen)m(ts)31
b(for)f(a)h(Successful)f(W)-8 b(rite)32 b(Op)s(eration)61
b(.)46 b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(585)345 906 y(G.1.2)80 b(Use)31 b(and)f(Choice)h(of)f(CTYPE)p
+b(587)345 906 y(G.1.2)80 b(Use)31 b(and)f(Choice)h(of)f(CTYPE)p
Fx(i)39 b FF(k)m(eyw)m(ords)71 b(.)45 b(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h
-(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(585)345
+(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(587)345
1020 y(G.1.3)80 b(Choice)31 b(of)g(Reference)g(P)m(oin)m(t)57
b(.)45 b(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)
-g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(587)345
+g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(589)345
1135 y(G.1.4)80 b(Choice)31 b(of)g(Axis)f(Ordering)49
b(.)d(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h
-(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(587)345
+(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(589)345
1249 y(G.1.5)80 b(Alternate)32 b(Axis)f(Descriptions)50
b(.)c(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f
-(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(587)136 1363
+(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(589)136 1363
y(G.2)68 b(P)m(ap)s(er)31 b(I)s(I)e(-)i(Celestial)h(Co)s(ordinates)h(.)
46 b(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)
-g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(588)345
+g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(590)345
1478 y(G.2.1)80 b(Requiremen)m(ts)31 b(for)f(a)h(Successful)f(W)-8
b(rite)32 b(Op)s(eration)61 b(.)46 b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)
-f(.)h(.)g(.)f(.)h(.)60 b(588)345 1592 y(G.2.2)80 b(Choice)31
+f(.)h(.)g(.)f(.)h(.)60 b(590)345 1592 y(G.2.2)80 b(Choice)31
b(of)g(LONPOLE/LA)-8 b(TPOLE)36 b(.)46 b(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)
g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(588)345 1707 y(G.2.3)80 b(User)31 b(De\014ned)f(Fiducial)h(P)m(oin)m
+b(590)345 1707 y(G.2.3)80 b(User)31 b(De\014ned)f(Fiducial)h(P)m(oin)m
(ts)82 b(.)46 b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g
-(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(590)345 1821
+(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(592)345 1821
y(G.2.4)80 b(Common)30 b(Non-Standard)g(F)-8 b(eatures)54
b(.)46 b(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)
-g(.)f(.)h(.)g(.)f(.)h(.)60 b(590)136 1935 y(G.3)68 b(P)m(ap)s(er)31
+g(.)f(.)h(.)g(.)f(.)h(.)60 b(592)136 1935 y(G.3)68 b(P)m(ap)s(er)31
b(I)s(I)s(I)d(-)j(Sp)s(ectral)f(Co)s(ordinates)82 b(.)45
b(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f
-(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(591)345 2050
+(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(593)345 2050
y(G.3.1)80 b(Requiremen)m(ts)31 b(for)f(a)h(Successful)f(W)-8
b(rite)32 b(Op)s(eration)61 b(.)46 b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)
-f(.)h(.)g(.)f(.)h(.)60 b(591)345 2164 y(G.3.2)80 b(Common)30
+f(.)h(.)g(.)f(.)h(.)60 b(593)345 2164 y(G.3.2)80 b(Common)30
b(Non-Standard)g(F)-8 b(eatures)54 b(.)46 b(.)g(.)g(.)f(.)h(.)g(.)f(.)h
(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(593)136 2279 y(G.4)68 b(P)m(ap)s(er)31 b(IV)f(-)h(Co)s(ordinate)f
+b(595)136 2279 y(G.4)68 b(P)m(ap)s(er)31 b(IV)f(-)h(Co)s(ordinate)f
(Distortions)78 b(.)46 b(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)
g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(593)345 2393 y(G.4.1)80 b(The)30 b(\\-SIP")h(distortion)g(co)s(de)76
+b(595)345 2393 y(G.4.1)80 b(The)30 b(\\-SIP")h(distortion)g(co)s(de)76
b(.)46 b(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
-f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(593)0 2604 y
+f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(595)0 2604 y
FD(H)54 b(Changes)35 b(and)g(New)f(F)-9 b(eatures)2239
-b(594)136 2719 y FF(H.1)71 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.1)
+b(596)136 2719 y FF(H.1)71 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.1)
47 b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)
g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(594)136 2833 y(H.2)71 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.2)47
+b(596)136 2833 y(H.2)71 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.2)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(595)136 2947 y(H.3)71 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.3)47
+b(597)136 2947 y(H.3)71 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.3)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(596)136 3062 y(H.4)71 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.4)47
+b(598)136 3062 y(H.4)71 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.4)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(597)136 3176 y(H.5)71 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.5)47
+b(599)136 3176 y(H.5)71 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.5)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(598)136 3291 y(H.6)71 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.6)47
+b(600)136 3291 y(H.6)71 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.6)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(599)136 3405 y(H.7)71 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.7)47
+b(601)136 3405 y(H.7)71 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.7)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(601)136 3519 y(H.8)71 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.8-2)
+b(603)136 3519 y(H.8)71 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.8-2)
42 b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)
-f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(602)136
+f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(604)136
3634 y(H.9)71 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.8-3)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(602)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(604)136
3748 y(H.10)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.8-4)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(603)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(605)136
3863 y(H.11)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.8-5)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(603)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(605)136
3977 y(H.12)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.8-7)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(603)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(605)136
4091 y(H.13)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.8-8)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(604)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(606)136
4206 y(H.14)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V1.8-13)68
b(.)46 b(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)
-h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(604)136
+h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(606)136
4320 y(H.15)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V2.0)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(605)136 4435 y(H.16)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.0)47
+b(607)136 4435 y(H.16)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.0)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(607)136 4549 y(H.17)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.1)47
+b(609)136 4549 y(H.17)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.1)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(609)136 4663 y(H.18)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.2)47
+b(611)136 4663 y(H.18)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.2)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(610)136 4778 y(H.19)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.3)47
+b(612)136 4778 y(H.19)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.3)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(611)136 4892 y(H.20)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.4)47
+b(613)136 4892 y(H.20)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.4)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(612)136 5007 y(H.21)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.5)47
+b(614)136 5007 y(H.21)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.5)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(613)136 5121 y(H.22)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.6)47
+b(615)136 5121 y(H.22)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.6)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(614)136 5235 y(H.23)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.7)47
+b(616)136 5235 y(H.23)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V3.7)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(614)136 5350 y(H.24)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.0)47
+b(616)136 5350 y(H.24)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.0)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(614)136 5464 y(H.25)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.1)47
+b(616)136 5464 y(H.25)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.1)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(615)136 5579 y(H.26)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.2)47
+b(617)136 5579 y(H.26)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.2)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(615)136 5693 y(H.27)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.3)47
+b(617)136 5693 y(H.27)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.3)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(616)p eop end
+b(618)p eop end
%%Page: 9 9
TeXDict begin 9 8 bop 0 52 a Fy(SUN/211.27)3224 b FF(ix)136
351 y(H.28)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.4)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(617)136 464 y(H.29)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.5)47
+b(619)136 464 y(H.29)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.5)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(618)136 577 y(H.30)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.6)47
+b(620)136 577 y(H.30)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V4.6)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(619)136 690 y(H.31)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.0)47
+b(621)136 690 y(H.31)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.0)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(619)136 803 y(H.32)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.1)47
+b(621)136 803 y(H.32)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.1)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(619)136 916 y(H.33)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.2)47
+b(621)136 916 y(H.33)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.2)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(620)136 1029 y(H.34)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.3)47
+b(622)136 1029 y(H.34)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.3)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(621)136 1142 y(H.35)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.3-1)
+b(623)136 1142 y(H.35)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.3-1)
42 b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)
-f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(622)136
+f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(624)136
1255 y(H.36)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.3-2)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(623)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(625)136
1367 y(H.37)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.4-0)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(624)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(626)136
1480 y(H.38)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.5-0)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(624)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(626)136
1593 y(H.39)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.6-0)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(624)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(626)136
1706 y(H.40)26 b(ChangesIn)m(tro)s(duced)k(in)g(V5.6-1)72
b(.)46 b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)
-f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(625)136
+f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(627)136
1819 y(H.41)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.7-0)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(625)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(627)136
1932 y(H.42)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.7-1)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(626)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(628)136
2045 y(H.43)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V5.7-2)42
b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(626)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(628)136
2158 y(H.44)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V6.0)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60
-b(627)136 2271 y(H.45)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V6.0-1)
+b(629)136 2271 y(H.45)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V6.0-1)
42 b(.)k(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)
-f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(627)136
+f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(629)136
2384 y(H.46)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.0.0)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(627)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(629)136
2497 y(H.47)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.0.1)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(628)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(630)136
2609 y(H.48)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.0.2)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(628)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(630)136
2722 y(H.49)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.0.3)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(628)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(630)136
2835 y(H.50)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.0.4)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(629)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(631)136
2948 y(H.51)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.0.5)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(629)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(631)136
3061 y(H.52)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.0.6)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(629)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(631)136
3174 y(H.53)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.1.0)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(629)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(631)136
3287 y(H.54)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.1.1)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(630)136
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(632)136
3400 y(H.55)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.2.0)47
b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
-(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(630)p
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(632)136
+3513 y(H.56)26 b(Changes)31 b(In)m(tro)s(duced)e(in)h(V7.3.0)47
+b(.)f(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
+(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)60 b(632)p
eop end
%%Page: 10 10
TeXDict begin 10 9 bop 0 52 a FF(x)3247 b Fy(SUN/211.27)p
@@ -49247,7 +49250,7 @@ eop end
TeXDict begin 1 10 bop 3734 52 a FF(1)p 945 709 1890
12 v 1755 898 a Fz(AST)1202 1047 y(A)45 b(Library)g(for)g(Handling)1097
1196 y(W)-11 b(orld)45 b(Co)t(ordinate)h(Systems)1486
-1346 y(in)f(Astronom)l(y)1753 1592 y(V7.2)p 945 1783
+1346 y(in)f(Astronom)l(y)1753 1592 y(V7.3)p 945 1783
V 1111 2176 a Fx(This)33 b(is)g(the)g(C)f(version)h(of)g(this)g(do)-5
b(cument.)985 2289 y(F)e(or)33 b(the)g(F)-7 b(ortr)i(an)35
b(version,)e(ple)-5 b(ase)34 b(se)-5 b(e)33 b(SUN/210.)0
@@ -111463,4936 +111466,4929 @@ TeXDict begin 194 203 bop 0 52 a FF(194)2049 b Fy(B)91
b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
0 483 a Fz(astAddP)l(arameter)403 b Fe(Add)39 b(a)g(new)f(global)1249
598 y(parameter)e(de\014nition)i(to)g(a)1763 712 y(table)2742
-483 y Fz(astAddP)l(arameter)0 886 y Fd(Description:)44
+483 y Fz(astAddP)l(arameter)0 872 y Fd(Description:)44
b Fi(Adds)29 b(the)h(de\014nition)f(of)f(a)h(new)f(global)g(parameter)f
(to)i(the)g(supplied)g(table.)40 b(Note,)29 b(this)g(do)r(es)g(not)227
-985 y(store)k(a)h(v)-5 b(alue)34 b(for)f(the)i(parameter.)55
+972 y(store)k(a)h(v)-5 b(alue)34 b(for)f(the)i(parameter.)55
b(T)-7 b(o)33 b(get)h(or)f(set)h(the)h(parameter)d(v)-5
b(alue,)36 b(the)f(metho)r(ds)f(of)g(the)g(parem)n(t)227
-1085 y(KeyMap)27 b(class)g(should)g(b)r(e)h(used,)g(using)f(the)h(name)
-f(of)h(the)g(parameter)e(as)h(the)h(k)n(ey)-7 b(.)0 1243
+1071 y(KeyMap)27 b(class)g(should)g(b)r(e)h(used,)g(using)f(the)h(name)
+f(of)h(the)g(parameter)e(as)h(the)h(k)n(ey)-7 b(.)0 1218
y Fd(Synopsis:)121 b Ft(void)42 b(astAddParameter\()37
b(AstTable)j Fh(\003)p Ft(this,)h(const)h(char)g Fh(\003)p
-Ft(name)f(\))0 1400 y Fd(P)m(arameters:)259 1545 y(this)427
-1645 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(T)-7 b(able.)259
-1781 y Fd(name)427 1881 y Fi(The)39 b(parameter)d(name.)69
+Ft(name)f(\))0 1364 y Fd(P)m(arameters:)259 1498 y(this)427
+1598 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(T)-7 b(able.)259
+1728 y Fd(name)427 1827 y Fi(The)39 b(parameter)d(name.)69
b(T)-7 b(railing)37 b(spaces)g(are)h(ignored)f(\(all)h(other)g(spaces)f
-(are)g(signi\014can)n(t\).)69 b(The)427 1981 y(supplied)28
+(are)g(signi\014can)n(t\).)69 b(The)427 1927 y(supplied)28
b(string)f(is)h(con)n(v)n(erted)e(to)h(upp)r(er)h(case.)0
-2151 y Fd(Notes:)340 2442 y Fh(\017)45 b Fi(Unlik)n(e)23
+2086 y Fd(Notes:)340 2366 y Fh(\017)45 b Fi(Unlik)n(e)23
b(columns,)h(the)f(de\014nition)g(of)g(a)g(parameter)e(do)r(es)h(not)h
(sp)r(ecify)g(its)h(t)n(yp)r(e,)g(size)e(or)g(dimensionalit)n(y)-7
-b(.)p 0 2649 V 0 2781 a Fz(astAngle)164 b Fe(Calculate)37
-b(the)h(angle)g(subtended)h(b)m(y)f(t)m(w)m(o)f(p)s(oin)m(ts)h(at)1561
-2895 y(a)h(third)f(p)s(oin)m(t)3267 2781 y Fz(astAngle)0
-3092 y Fd(Description:)44 b Fi(This)26 b(function)g(\014nds)g(the)g
+b(.)p 0 2559 V 0 2691 a Fz(astAddV)c(arian)l(t)196 b
+Fe(Store)38 b(a)g(new)h(v)-7 b(arian)m(t)37 b(Mapping)h(for)1048
+2805 y(the)g(curren)m(t)g(F)-10 b(rame)38 b(in)h(a)f(F)-10
+b(rameSet)2921 2691 y Fz(astAddV)f(arian)l(t)0 2965 y
+Fd(Description:)44 b Fi(This)36 b(function)g(allo)n(ws)e(a)h(new)g(v)-5
+b(arian)n(t)35 b(Mapping)g(to)g(b)r(e)h(stored)e(with)i(the)g(curren)n
+(t)e(F)-7 b(rame)35 b(in)h(a)227 3065 y(F)-7 b(rameSet.)35
+b(See)22 b(the)h Ft(")p Fi(V)-7 b(arian)n(t)p Ft(")20
+b Fi(attribute)i(for)g(more)f(details.)35 b(It)22 b(can)g(also)f(b)r(e)
+h(used)g(to)g(rename)f(the)i(curren)n(tly)227 3165 y(selected)28
+b(v)-5 b(arian)n(t)26 b(Mapping.)0 3311 y Fd(Synopsis:)121
+b Ft(void)42 b(astAddVariant\()c(AstFrameSet)h Fh(\003)p
+Ft(this,)i(AstMapping)e Fh(\003)p Ft(map,)j(const)f(char)h
+Fh(\003)p Ft(name,)f(int)227 3411 y Fh(\003)p Ft(status)g(\))0
+3557 y Fd(P)m(arameters:)259 3691 y(this)427 3791 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(F)-7 b(rameSet.)259 3921 y Fd(map)427 4020
+y Fi(P)n(oin)n(ter)25 b(to)h(a)h(Mapping)f(whic)n(h)g(describ)r(es)g
+(ho)n(w)g(to)g(con)n(v)n(ert)f(co)r(ordinates)g(from)h(the)h(curren)n
+(t)f(F)-7 b(rame)26 b(to)427 4120 y(the)32 b(new)f(v)-5
+b(arian)n(t)30 b(of)h(the)g(curren)n(t)g(F)-7 b(rame.)46
+b(If)32 b(NULL)f(is)g(supplied,)h(then)g(the)f(name)g(asso)r(ciated)f
+(with)427 4220 y(the)i(curren)n(tly)e(selected)g(v)-5
+b(arian)n(t)30 b(of)h(the)h(curren)n(t)e(F)-7 b(rame)30
+b(is)h(set)g(to)g(the)g(v)-5 b(alue)31 b(supplied)g(for)g
+Ft(")p Fi(name)p Ft(")p Fi(,)427 4319 y(but)d(no)g(new)f(v)-5
+b(arian)n(t)27 b(is)h(added.)259 4449 y Fd(name)427 4549
+y Fi(The)d(name)g(to)g(asso)r(ciate)e(with)i(the)h(new)f(v)-5
+b(arian)n(t)24 b(Mapping)g(\(or)g(the)i(curren)n(tly)d(selected)i(v)-5
+b(arian)n(t)24 b(Map-)427 4648 y(ping)k(if)g Ft(")p Fi(map)p
+Ft(")f Fi(is)g(NULL\).)0 4807 y Fd(Notes:)340 5087 y
+Fh(\017)45 b Fi(The)32 b(newly)g(added)g(V)-7 b(arian)n(t)31
+b(b)r(ecomes)h(the)g(curren)n(t)f(v)-5 b(arian)n(t)31
+b(on)h(exit)g(\(this)g(is)g(equiv)-5 b(alen)n(t)32 b(to)g(setting)427
+5187 y(the)c(V)-7 b(arian)n(t)27 b(attribute)h(to)f(the)h(v)-5
+b(alue)28 b(supplied)g(for)f Ft(")p Fi(name\).)340 5317
+y Fh(\017)45 b Fi(An)27 b(error)e(is)i(rep)r(orted)e(if)j(a)e(v)-5
+b(arian)n(t)25 b(with)j(the)f(supplied)g(name)f(already)f(exists)h(in)h
+(the)g(curren)n(t)f(F)-7 b(rame.)340 5447 y Fh(\017)45
+b Fi(An)35 b(error)e(is)i(rep)r(orted)f(if)h(the)g(curren)n(t)f(F)-7
+b(rame)34 b(is)g(a)h(mirror)e(for)h(the)h(v)-5 b(arian)n(t)34
+b(Mappings)g(in)h(another)427 5546 y(F)-7 b(rame.)47
+b(This)31 b(is)g(only)g(the)g(case)f(if)i(the)f(astMirrorV)-7
+b(arian)n(ts)28 b(function)j(has)g(b)r(een)g(called)g(to)g(mak)n(e)f
+(the)427 5646 y(curren)n(t)d(F)-7 b(rame)27 b(act)g(as)g(a)h(mirror.)p
+eop end
+%%Page: 195 205
+TeXDict begin 195 204 bop 3643 52 a FF(195)p 0 351 3780
+12 v 0 483 a Fz(astAngle)164 b Fe(Calculate)37 b(the)h(angle)g
+(subtended)h(b)m(y)f(t)m(w)m(o)f(p)s(oin)m(ts)h(at)1561
+598 y(a)h(third)f(p)s(oin)m(t)3267 483 y Fz(astAngle)0
+785 y Fd(Description:)44 b Fi(This)26 b(function)g(\014nds)g(the)g
(angle)f(at)h(p)r(oin)n(t)f(B)h(b)r(et)n(w)n(een)g(the)g(line)f
(joining)h(p)r(oin)n(ts)g(A)g(and)f(B,)h(and)f(the)227
-3192 y(line)31 b(joining)g(p)r(oin)n(ts)f(C)h(and)g(B.)f(These)h(lines)
-f(will)h(in)g(fact)g(b)r(e)g(geo)r(desic)f(curv)n(es)f(appropriate)g
-(to)i(the)g(F)-7 b(rame)227 3291 y(in)28 b(use.)37 b(F)-7
+885 y(line)31 b(joining)g(p)r(oin)n(ts)f(C)h(and)g(B.)f(These)h(lines)f
+(will)h(in)g(fact)g(b)r(e)g(geo)r(desic)f(curv)n(es)f(appropriate)g(to)
+i(the)g(F)-7 b(rame)227 985 y(in)28 b(use.)37 b(F)-7
b(or)27 b(instance,)g(in)h(SkyF)-7 b(rame,)27 b(they)h(will)g(b)r(e)g
-(great)e(circles.)0 3449 y Fd(Synopsis:)121 b Ft(double)41
+(great)e(circles.)0 1133 y Fd(Synopsis:)121 b Ft(double)41
b(astAngle\()f(AstFrame)g Fh(\003)p Ft(this,)h(const)h(double)f(a[],)h
-(const)f(double)g(b[],)h(const)g(double)227 3549 y(c[])h(\))0
-3706 y Fd(P)m(arameters:)259 3851 y(this)427 3951 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(F)-7 b(rame.)259 4087 y Fd(a)427 4187 y
+(const)f(double)g(b[],)h(const)g(double)227 1233 y(c[])h(\))0
+1382 y Fd(P)m(arameters:)259 1518 y(this)427 1618 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(F)-7 b(rame.)259 1750 y Fd(a)427 1849 y
Fi(An)32 b(arra)n(y)c(of)j(double,)h(with)g(one)e(elemen)n(t)i(for)e
(eac)n(h)g(F)-7 b(rame)31 b(axis)f(\(Naxes)h(attribute\))g(con)n
-(taining)f(the)427 4287 y(co)r(ordinates)c(of)i(the)g(\014rst)f(p)r
-(oin)n(t.)259 4424 y Fd(b)427 4523 y Fi(An)32 b(arra)n(y)c(of)j
+(taining)f(the)427 1949 y(co)r(ordinates)c(of)i(the)g(\014rst)f(p)r
+(oin)n(t.)259 2081 y Fd(b)427 2181 y Fi(An)32 b(arra)n(y)c(of)j
(double,)h(with)g(one)e(elemen)n(t)i(for)e(eac)n(h)g(F)-7
b(rame)31 b(axis)f(\(Naxes)h(attribute\))g(con)n(taining)f(the)427
-4623 y(co)r(ordinates)c(of)i(the)g(second)f(p)r(oin)n(t.)259
-4760 y Fd(c)427 4859 y Fi(An)32 b(arra)n(y)c(of)j(double,)h(with)g(one)
+2281 y(co)r(ordinates)c(of)i(the)g(second)f(p)r(oin)n(t.)259
+2413 y Fd(c)427 2513 y Fi(An)32 b(arra)n(y)c(of)j(double,)h(with)g(one)
e(elemen)n(t)i(for)e(eac)n(h)g(F)-7 b(rame)31 b(axis)f(\(Naxes)h
-(attribute\))g(con)n(taining)f(the)427 4959 y(co)r(ordinates)c(of)i
-(the)g(third)g(p)r(oin)n(t.)0 5129 y Fd(Returned)k(V)-8
-b(alue:)259 5274 y(astAngle)427 5373 y Fi(The)29 b(angle)e(in)i
+(attribute\))g(con)n(taining)f(the)427 2612 y(co)r(ordinates)c(of)i
+(the)g(third)g(p)r(oin)n(t.)0 2774 y Fd(Returned)k(V)-8
+b(alue:)259 2909 y(astAngle)427 3009 y Fi(The)29 b(angle)e(in)i
(radians,)e(from)h(the)g(line)h(AB)f(to)g(the)h(line)f(CB.)g(If)h(the)g
(F)-7 b(rame)27 b(is)i(2-dimensional,)e(it)h(will)427
-5473 y(b)r(e)33 b(in)f(the)h(range)e($)p Fh(n)p Fi(pm)h
+3109 y(b)r(e)33 b(in)f(the)h(range)e($)p Fh(n)p Fi(pm)h
Fh(n)p Fi(pi$,)h(and)f(p)r(ositiv)n(e)g(rotation)f(is)h(in)g(the)h
-(same)f(sense)g(as)f(rotation)g(from)h(the)427 5573 y(p)r(ositiv)n(e)d
+(same)f(sense)g(as)f(rotation)g(from)h(the)427 3208 y(p)r(ositiv)n(e)d
(direction)g(of)g(axis)f(2)h(to)g(the)h(p)r(ositiv)n(e)e(direction)h
(of)g(axis)g(1.)41 b(If)30 b(the)f(F)-7 b(rame)29 b(has)f(more)h(than)g
-(2)427 5672 y(axes,)e(a)g(p)r(ositiv)n(e)g(v)-5 b(alue)28
+(2)427 3308 y(axes,)e(a)g(p)r(ositiv)n(e)g(v)-5 b(alue)28
b(will)g(alw)n(a)n(ys)d(b)r(e)j(returned)f(in)h(the)g(range)f(zero)f
-(to)i($)p Fh(n)p Fi(pi$.)p eop end
-%%Page: 195 205
-TeXDict begin 195 204 bop 3643 52 a FF(195)0 351 y Fd(Notes:)340
-640 y Fh(\017)45 b Fi(A)27 b(v)-5 b(alue)26 b(of)h(AST)p
+(to)i($)p Fh(n)p Fi(pi$.)0 3469 y Fd(Notes:)340 3751
+y Fh(\017)45 b Fi(A)27 b(v)-5 b(alue)26 b(of)h(AST)p
Ft(__)p Fi(BAD)f(will)h(also)e(b)r(e)i(returned)f(if)h(p)r(oin)n(ts)f
(A)h(and)f(B)g(are)g(co-inciden)n(t,)g(or)f(if)i(p)r(oin)n(ts)g(B)427
-739 y(and)h(C)f(are)g(co-inciden)n(t.)340 875 y Fh(\017)45
+3851 y(and)h(C)f(are)g(co-inciden)n(t.)340 3983 y Fh(\017)45
b Fi(A)32 b(v)-5 b(alue)31 b(of)g(AST)p Ft(__)p Fi(BAD)h(will)f(also)f
(b)r(e)i(returned)f(if)h(this)f(function)h(is)g(in)n(v)n(ok)n(ed)d
-(with)j(the)g(AST)g(error)427 975 y(status)c(set,)f(or)g(if)h(it)g
-(should)g(fail)f(for)g(an)n(y)g(reason.)p 0 1180 3780
-12 v 0 1312 a Fz(astAnn)l(ul)607 b Fe(Ann)m(ul)38 b(a)h(p)s(oin)m(ter)e
-(to)h(an)h(Ob)7 b(ject)605 b Fz(astAnn)l(ul)0 1506 y
-Fd(Description:)44 b Fi(This)31 b(function)f(ann)n(uls)g(a)g(p)r(oin)n
-(ter)g(to)g(an)g(Ob)5 b(ject)30 b(so)g(that)h(it)f(is)g(no)g(longer)f
-(recognised)g(as)h(a)g(v)-5 b(alid)227 1606 y(p)r(oin)n(ter)37
-b(b)n(y)h(the)g(AST)g(library)-7 b(.)66 b(An)n(y)37 b(resources)f(asso)
-r(ciated)g(with)i(the)g(p)r(oin)n(ter)f(are)g(released)f(and)i(made)227
-1705 y(a)n(v)-5 b(ailable)27 b(for)g(re-use.)227 1833
-y(This)33 b(function)h(also)e(decremen)n(ts)h(the)g(Ob)5
-b(ject's)33 b(RefCoun)n(t)g(attribute)h(b)n(y)f(one.)53
-b(If)33 b(this)h(attribute)f(reac)n(hes)227 1933 y(zero)27
-b(\(whic)n(h)h(happ)r(ens)f(when)h(the)g(last)f(p)r(oin)n(ter)g(to)h
-(the)g(Ob)5 b(ject)27 b(is)h(ann)n(ulled\),)g(then)g(the)g(Ob)5
-b(ject)27 b(is)h(deleted.)0 2088 y Fd(Synopsis:)121 b
-Ft(AstObject)40 b Fh(\003)p Ft(astAnnul\()f(AstObject)h
-Fh(\003)p Ft(this)h(\))0 2243 y Fd(P)m(arameters:)259
-2386 y(this)427 2485 y Fi(The)28 b(Ob)5 b(ject)27 b(p)r(oin)n(ter)h(to)
-f(b)r(e)h(ann)n(ulled.)0 2653 y Fd(Class)j(Applicabilit)m(y:)259
-2795 y(Ob)5 b(ject)427 2895 y Fi(This)28 b(function)g(applies)f(to)h
-(all)f(Ob)5 b(jects.)0 3063 y Fd(Returned)32 b(V)-8 b(alue:)259
-3205 y(astAnn)m(ul\(\))427 3305 y Fi(A)28 b(n)n(ull)g(Ob)5
+(with)j(the)g(AST)g(error)427 4083 y(status)c(set,)f(or)g(if)h(it)g
+(should)g(fail)f(for)g(an)n(y)g(reason.)p 0 4281 V 0
+4413 a Fz(astAnn)l(ul)607 b Fe(Ann)m(ul)38 b(a)h(p)s(oin)m(ter)e(to)h
+(an)h(Ob)7 b(ject)605 b Fz(astAnn)l(ul)0 4601 y Fd(Description:)44
+b Fi(This)31 b(function)f(ann)n(uls)g(a)g(p)r(oin)n(ter)g(to)g(an)g(Ob)
+5 b(ject)30 b(so)g(that)h(it)f(is)g(no)g(longer)f(recognised)g(as)h(a)g
+(v)-5 b(alid)227 4700 y(p)r(oin)n(ter)37 b(b)n(y)h(the)g(AST)g(library)
+-7 b(.)66 b(An)n(y)37 b(resources)f(asso)r(ciated)g(with)i(the)g(p)r
+(oin)n(ter)f(are)g(released)f(and)i(made)227 4800 y(a)n(v)-5
+b(ailable)27 b(for)g(re-use.)227 4924 y(This)33 b(function)h(also)e
+(decremen)n(ts)h(the)g(Ob)5 b(ject's)33 b(RefCoun)n(t)g(attribute)h(b)n
+(y)f(one.)53 b(If)33 b(this)h(attribute)f(reac)n(hes)227
+5024 y(zero)27 b(\(whic)n(h)h(happ)r(ens)f(when)h(the)g(last)f(p)r(oin)
+n(ter)g(to)h(the)g(Ob)5 b(ject)27 b(is)h(ann)n(ulled\),)g(then)g(the)g
+(Ob)5 b(ject)27 b(is)h(deleted.)0 5173 y Fd(Synopsis:)121
+b Ft(AstObject)40 b Fh(\003)p Ft(astAnnul\()f(AstObject)h
+Fh(\003)p Ft(this)h(\))0 5322 y Fd(P)m(arameters:)259
+5457 y(this)427 5557 y Fi(The)28 b(Ob)5 b(ject)27 b(p)r(oin)n(ter)h(to)
+f(b)r(e)h(ann)n(ulled.)0 5718 y Fd(Class)j(Applicabilit)m(y:)p
+eop end
+%%Page: 196 206
+TeXDict begin 196 205 bop 0 52 a FF(196)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(Ob)5
+b(ject)427 451 y Fi(This)28 b(function)g(applies)f(to)h(all)f(Ob)5
+b(jects.)0 606 y Fd(Returned)32 b(V)-8 b(alue:)259 736
+y(astAnn)m(ul\(\))427 836 y Fi(A)28 b(n)n(ull)g(Ob)5
b(ject)27 b(p)r(oin)n(ter)h(\(AST)p Ft(__)p Fi(NULL\))g(is)f(alw)n(a)n
-(ys)f(returned.)0 3472 y Fd(Notes:)340 3761 y Fh(\017)45
+(ys)f(returned.)0 991 y Fd(Notes:)340 1267 y Fh(\017)45
b Fi(This)27 b(function)h(will)f(attempt)h(to)f(ann)n(ul)g(the)h(p)r
(oin)n(ter)e(ev)n(en)h(if)h(the)f(Ob)5 b(ject)27 b(is)g(not)g(curren)n
-(tly)g(lo)r(c)n(k)n(ed)f(b)n(y)427 3860 y(the)i(calling)f(thread)g
-(\(see)h(astLo)r(c)n(k\).)340 3996 y Fh(\017)45 b Fi(This)38
+(tly)g(lo)r(c)n(k)n(ed)f(b)n(y)427 1367 y(the)i(calling)f(thread)g
+(\(see)h(astLo)r(c)n(k\).)340 1493 y Fh(\017)45 b Fi(This)38
b(function)g(attempts)g(to)g(execute)g(ev)n(en)f(if)h(the)g(AST)g
(error)e(status)i(is)f(set)h(on)f(en)n(try)-7 b(,)40
-b(although)427 4096 y(no)34 b(further)f(error)f(rep)r(ort)h(will)h(b)r
+b(although)427 1593 y(no)34 b(further)f(error)f(rep)r(ort)h(will)h(b)r
(e)g(made)g(if)g(it)g(subsequen)n(tly)f(fails)h(under)f(these)h
-(circumstances.)54 b(In)427 4195 y(particular,)27 b(it)i(will)f(fail)g
+(circumstances.)54 b(In)427 1693 y(particular,)27 b(it)i(will)f(fail)g
(if)h(the)f(p)r(oin)n(ter)g(suppled)g(is)g(not)g(v)-5
b(alid,)28 b(but)h(this)f(will)g(only)g(b)r(e)g(rep)r(orted)g(if)g(the)
-427 4295 y(error)e(status)h(is)h(clear)e(on)i(en)n(try)-7
-b(.)p 0 4500 V 0 4632 a Fz(astAxAngle)163 b Fe(Returns)38
+427 1792 y(error)e(status)h(is)h(clear)e(on)i(en)n(try)-7
+b(.)p 0 1979 3780 12 v 0 2110 a Fz(astAxAngle)163 b Fe(Returns)38
b(the)h(angle)f(from)f(an)h(axis,)g(to)g(a)h(line)1402
-4746 y(through)e(t)m(w)m(o)g(p)s(oin)m(ts)3094 4632 y
-Fz(astAxAngle)0 4941 y Fd(Description:)44 b Fi(This)32
+2225 y(through)e(t)m(w)m(o)g(p)s(oin)m(ts)3094 2110 y
+Fz(astAxAngle)0 2401 y Fd(Description:)44 b Fi(This)32
b(function)h(\014nds)g(the)f(angle,)h(as)e(seen)h(from)g(p)r(oin)n(t)g
(A,)h(b)r(et)n(w)n(een)f(the)g(p)r(ositiv)n(e)g(direction)g(of)g(a)227
-5041 y(sp)r(eci\014ed)c(axis,)f(and)g(the)h(geo)r(desic)f(curv)n(e)g
+2501 y(sp)r(eci\014ed)c(axis,)f(and)g(the)h(geo)r(desic)f(curv)n(e)g
(joining)g(p)r(oin)n(t)h(A)g(to)f(p)r(oin)n(t)h(B.)0
-5196 y Fd(Synopsis:)121 b Ft(double)41 b(astAxAngle\()e(AstFrame)h
+2644 y Fd(Synopsis:)121 b Ft(double)41 b(astAxAngle\()e(AstFrame)h
Fh(\003)p Ft(this,)h(const)h(double)f(a[],)h(const)f(double)g(b[],)h
-(int)h(axis)227 5296 y(\))0 5451 y Fd(P)m(arameters:)259
-5593 y(this)427 5693 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
-b(rame.)p eop end
-%%Page: 196 206
-TeXDict begin 196 205 bop 0 52 a FF(196)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(a)427
-451 y Fi(An)i(arra)n(y)c(of)j(double,)h(with)g(one)e(elemen)n(t)i(for)e
-(eac)n(h)g(F)-7 b(rame)31 b(axis)f(\(Naxes)h(attribute\))g(con)n
-(taining)f(the)427 551 y(co)r(ordinates)c(of)i(the)g(\014rst)f(p)r(oin)
-n(t.)259 686 y Fd(b)427 785 y Fi(An)32 b(arra)n(y)c(of)j(double,)h
+(int)h(axis)227 2743 y(\))0 2886 y Fd(P)m(arameters:)259
+3016 y(this)427 3116 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rame.)259 3242 y Fd(a)427 3342 y Fi(An)32 b(arra)n(y)c(of)j(double,)h
(with)g(one)e(elemen)n(t)i(for)e(eac)n(h)g(F)-7 b(rame)31
b(axis)f(\(Naxes)h(attribute\))g(con)n(taining)f(the)427
-885 y(co)r(ordinates)c(of)i(the)g(second)f(p)r(oin)n(t.)259
-1020 y Fd(axis)427 1120 y Fi(The)d(n)n(um)n(b)r(er)g(of)f(the)h(F)-7
-b(rame)24 b(axis)f(from)g(whic)n(h)h(the)g(angle)f(is)g(to)h(b)r(e)g
-(measured)f(\(axis)g(n)n(um)n(b)r(ering)g(starts)427
-1219 y(at)28 b(1)f(for)g(the)h(\014rst)f(axis\).)0 1386
-y Fd(Returned)32 b(V)-8 b(alue:)259 1527 y(astAxAngle)427
-1627 y Fi(The)29 b(angle)g(in)g(radians,)f(from)h(the)g(p)r(ositiv)n(e)
-g(direction)f(of)h(the)h(sp)r(eci\014ed)f(axis,)g(to)g(the)g(line)g
-(AB.)h(If)f(the)427 1726 y(F)-7 b(rame)28 b(is)g(2-dimensional,)g(it)g
-(will)h(b)r(e)g(in)f(the)h(range)e([-PI/2,+PI/2],)e(and)j(p)r(ositiv)n
-(e)g(rotation)f(is)i(in)f(the)427 1826 y(same)j(sense)f(as)g(rotation)g
-(from)g(the)i(p)r(ositiv)n(e)e(direction)g(of)h(axis)f(2)h(to)f(the)i
-(p)r(ositiv)n(e)e(direction)h(of)f(axis)427 1926 y(1.)43
-b(If)30 b(the)g(F)-7 b(rame)30 b(has)f(more)g(than)h(2)f(axes,)g(a)h(p)
-r(ositiv)n(e)f(v)-5 b(alue)30 b(will)g(alw)n(a)n(ys)d(b)r(e)k(returned)
-e(in)h(the)g(range)427 2025 y(zero)d(to)g(PI.)0 2192
-y Fd(Notes:)340 2479 y Fh(\017)45 b Fi(The)26 b(geo)r(desic)e(curv)n(e)
-h(used)g(b)n(y)g(this)h(function)g(is)f(the)h(path)f(of)h(shortest)e
-(distance)i(b)r(et)n(w)n(een)f(t)n(w)n(o)g(p)r(oin)n(ts,)427
-2579 y(as)i(de\014ned)h(b)n(y)f(the)h(astDistance)g(function.)340
-2714 y Fh(\017)45 b Fi(This)19 b(function)g(will)g(return)f
-Ft(")p Fi(bad)p Ft(")g Fi(co)r(ordinate)g(v)-5 b(alues)18
-b(\(AST)p Ft(__)p Fi(BAD\))i(if)f(an)n(y)f(of)g(the)i(input)f(co)r
-(ordinates)427 2813 y(has)27 b(this)h(v)-5 b(alue,)28
-b(or)e(if)j(the)f(require)e(p)r(osition)h(angle)g(is)h(unde\014ned.)p
-0 3017 3780 12 v 0 3149 a Fz(astAxDistance)256 b Fe(Find)39
-b(the)g(distance)e(b)s(et)m(w)m(een)h(t)m(w)m(o)1616
-3249 y(axis)g(v)-7 b(alues)2929 3149 y Fz(astAxDistance)0
-3419 y Fd(Description:)44 b Fi(This)32 b(function)h(returns)e(a)h
-(signed)f(v)-5 b(alue)32 b(represen)n(ting)e(the)j(axis)e(incremen)n(t)
-h(from)f(axis)g(v)-5 b(alue)32 b(v1)227 3519 y(to)c(axis)f(v)-5
-b(alue)27 b(v2.)227 3645 y(F)-7 b(or)24 b(a)g(simple)h(F)-7
-b(rame,)25 b(this)g(is)f(a)h(trivial)f(op)r(eration)f(returning)h(the)h
-(di\013erence)g(b)r(et)n(w)n(een)f(the)h(t)n(w)n(o)f(axis)g(v)-5
-b(alues.)227 3745 y(But)28 b(for)f(other)g(deriv)n(ed)g(classes)f(of)i
-(F)-7 b(rame)27 b(\(suc)n(h)h(as)e(a)i(SkyF)-7 b(rame\))27
-b(this)h(is)f(not)h(the)g(case.)0 3899 y Fd(Synopsis:)121
+3441 y(co)r(ordinates)c(of)i(the)g(\014rst)f(p)r(oin)n(t.)259
+3568 y Fd(b)427 3667 y Fi(An)32 b(arra)n(y)c(of)j(double,)h(with)g(one)
+e(elemen)n(t)i(for)e(eac)n(h)g(F)-7 b(rame)31 b(axis)f(\(Naxes)h
+(attribute\))g(con)n(taining)f(the)427 3767 y(co)r(ordinates)c(of)i
+(the)g(second)f(p)r(oin)n(t.)259 3894 y Fd(axis)427 3993
+y Fi(The)d(n)n(um)n(b)r(er)g(of)f(the)h(F)-7 b(rame)24
+b(axis)f(from)g(whic)n(h)h(the)g(angle)f(is)g(to)h(b)r(e)g(measured)f
+(\(axis)g(n)n(um)n(b)r(ering)g(starts)427 4093 y(at)28
+b(1)f(for)g(the)h(\014rst)f(axis\).)0 4248 y Fd(Returned)32
+b(V)-8 b(alue:)259 4378 y(astAxAngle)427 4478 y Fi(The)29
+b(angle)g(in)g(radians,)f(from)h(the)g(p)r(ositiv)n(e)g(direction)f(of)
+h(the)h(sp)r(eci\014ed)f(axis,)g(to)g(the)g(line)g(AB.)h(If)f(the)427
+4577 y(F)-7 b(rame)28 b(is)g(2-dimensional,)g(it)g(will)h(b)r(e)g(in)f
+(the)h(range)e([-PI/2,+PI/2],)e(and)j(p)r(ositiv)n(e)g(rotation)f(is)i
+(in)f(the)427 4677 y(same)j(sense)f(as)g(rotation)g(from)g(the)i(p)r
+(ositiv)n(e)e(direction)g(of)h(axis)f(2)h(to)f(the)i(p)r(ositiv)n(e)e
+(direction)h(of)f(axis)427 4777 y(1.)43 b(If)30 b(the)g(F)-7
+b(rame)30 b(has)f(more)g(than)h(2)f(axes,)g(a)h(p)r(ositiv)n(e)f(v)-5
+b(alue)30 b(will)g(alw)n(a)n(ys)d(b)r(e)k(returned)e(in)h(the)g(range)
+427 4876 y(zero)d(to)g(PI.)0 5032 y Fd(Notes:)340 5308
+y Fh(\017)45 b Fi(The)26 b(geo)r(desic)e(curv)n(e)h(used)g(b)n(y)g
+(this)h(function)g(is)f(the)h(path)f(of)h(shortest)e(distance)i(b)r(et)
+n(w)n(een)f(t)n(w)n(o)g(p)r(oin)n(ts,)427 5407 y(as)i(de\014ned)h(b)n
+(y)f(the)h(astDistance)g(function.)340 5534 y Fh(\017)45
+b Fi(This)19 b(function)g(will)g(return)f Ft(")p Fi(bad)p
+Ft(")g Fi(co)r(ordinate)g(v)-5 b(alues)18 b(\(AST)p Ft(__)p
+Fi(BAD\))i(if)f(an)n(y)f(of)g(the)i(input)f(co)r(ordinates)427
+5633 y(has)27 b(this)h(v)-5 b(alue,)28 b(or)e(if)j(the)f(require)e(p)r
+(osition)h(angle)g(is)h(unde\014ned.)p eop end
+%%Page: 197 207
+TeXDict begin 197 206 bop 3643 52 a FF(197)p 0 351 3780
+12 v 0 483 a Fz(astAxDistance)256 b Fe(Find)39 b(the)g(distance)e(b)s
+(et)m(w)m(een)h(t)m(w)m(o)1616 583 y(axis)g(v)-7 b(alues)2929
+483 y Fz(astAxDistance)0 750 y Fd(Description:)44 b Fi(This)32
+b(function)h(returns)e(a)h(signed)f(v)-5 b(alue)32 b(represen)n(ting)e
+(the)j(axis)e(incremen)n(t)h(from)f(axis)g(v)-5 b(alue)32
+b(v1)227 850 y(to)c(axis)f(v)-5 b(alue)27 b(v2.)227 975
+y(F)-7 b(or)24 b(a)g(simple)h(F)-7 b(rame,)25 b(this)g(is)f(a)h
+(trivial)f(op)r(eration)f(returning)h(the)h(di\013erence)g(b)r(et)n(w)n
+(een)f(the)h(t)n(w)n(o)f(axis)g(v)-5 b(alues.)227 1075
+y(But)28 b(for)f(other)g(deriv)n(ed)g(classes)f(of)i(F)-7
+b(rame)27 b(\(suc)n(h)h(as)e(a)i(SkyF)-7 b(rame\))27
+b(this)h(is)f(not)h(the)g(case.)0 1226 y Fd(Synopsis:)121
b Ft(double)41 b(astAxDistance\()d(AstFrame)i Fh(\003)p
Ft(this,)h(int)h(axis,)g(double)f(v1,)h(double)f(v2)i(\))0
-4053 y Fd(P)m(arameters:)259 4194 y(this)427 4294 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(F)-7 b(rame.)259 4429 y Fd(axis)427 4529
+1377 y Fd(P)m(arameters:)259 1515 y(this)427 1615 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(F)-7 b(rame.)259 1749 y Fd(axis)427 1848
y Fi(The)28 b(index)g(of)f(the)h(axis)f(to)g(whic)n(h)h(the)g(supplied)
g(v)-5 b(alues)27 b(refer.)36 b(The)28 b(\014rst)f(axis)g(has)g(index)h
-(1.)259 4664 y Fd(v1)427 4764 y Fi(The)g(\014rst)f(axis)g(v)-5
-b(alue.)259 4899 y Fd(v2)427 4998 y Fi(The)28 b(second)f(axis)g(v)-5
-b(alue.)0 5165 y Fd(Returned)32 b(V)-8 b(alue:)259 5306
-y(astAxDistance)427 5406 y Fi(The)28 b(distance)f(from)h(the)f(\014rst)
-h(to)f(the)h(second)f(axis)g(v)-5 b(alue.)0 5572 y Fd(Notes:)p
-eop end
-%%Page: 197 207
-TeXDict begin 197 206 bop 3643 52 a FF(197)340 351 y
-Fh(\017)45 b Fi(This)33 b(function)g(will)f(return)g(a)g
+(1.)259 1982 y Fd(v1)427 2082 y Fi(The)g(\014rst)f(axis)g(v)-5
+b(alue.)259 2215 y Fd(v2)427 2315 y Fi(The)28 b(second)f(axis)g(v)-5
+b(alue.)0 2479 y Fd(Returned)32 b(V)-8 b(alue:)259 2617
+y(astAxDistance)427 2716 y Fi(The)28 b(distance)f(from)h(the)f(\014rst)
+h(to)f(the)h(second)f(axis)g(v)-5 b(alue.)0 2880 y Fd(Notes:)340
+3164 y Fh(\017)45 b Fi(This)33 b(function)g(will)f(return)g(a)g
Ft(")p Fi(bad)p Ft(")f Fi(result)h(v)-5 b(alue)33 b(\(AST)p
Ft(__)p Fi(BAD\))g(if)f(an)n(y)g(of)g(the)h(input)g(v)-5
-b(alues)32 b(has)427 451 y(this)c(v)-5 b(alue.)340 576
+b(alues)32 b(has)427 3264 y(this)c(v)-5 b(alue.)340 3398
y Fh(\017)45 b Fi(A)27 b Ft(")p Fi(bad)p Ft(")e Fi(v)-5
b(alue)26 b(will)g(also)f(b)r(e)i(returned)e(if)i(this)f(function)h(is)
f(in)n(v)n(ok)n(ed)f(with)h(the)h(AST)f(error)f(status)h(set,)427
-676 y(or)h(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
-0 860 3780 12 v 0 992 a Fz(astAxO\013set)209 b Fe(Add)39
-b(an)g(incremen)m(t)e(on)m(to)g(a)i(supplied)f(axis)1758
-1107 y(v)-7 b(alue)3090 992 y Fz(astAxO\013set)0 1257
-y Fd(Description:)44 b Fi(This)39 b(function)g(returns)f(an)g(axis)g(v)
--5 b(alue)39 b(formed)f(b)n(y)g(adding)h(a)f(signed)g(axis)g(incremen)n
-(t)g(on)n(to)g(a)227 1357 y(supplied)28 b(axis)f(v)-5
-b(alue.)227 1478 y(F)e(or)29 b(a)h(simple)g(F)-7 b(rame,)29
-b(this)i(is)e(a)h(trivial)f(op)r(eration)f(returning)h(the)i(sum)e(of)h
-(the)g(t)n(w)n(o)f(supplied)h(v)-5 b(alues.)43 b(But)227
-1578 y(for)27 b(other)g(deriv)n(ed)g(classes)f(of)i(F)-7
-b(rame)27 b(\(suc)n(h)h(as)f(a)g(SkyF)-7 b(rame\))27
-b(this)h(is)f(not)h(the)g(case.)0 1720 y Fd(Synopsis:)121
-b Ft(double)41 b(astAxOffset\()e(AstFrame)h Fh(\003)p
-Ft(this,)h(int)h(axis,)g(double)f(v1,)h(double)f(dist)h(\))0
-1862 y Fd(P)m(arameters:)259 1991 y(this)427 2090 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(F)-7 b(rame.)259 2216 y Fd(axis)427 2315
-y Fi(The)28 b(index)g(of)f(the)h(axis)f(to)g(whic)n(h)h(the)g(supplied)
-g(v)-5 b(alues)27 b(refer.)36 b(The)28 b(\014rst)f(axis)g(has)g(index)h
-(1.)259 2441 y Fd(v1)427 2540 y Fi(The)g(original)e(axis)h(v)-5
-b(alue.)259 2666 y Fd(dist)427 2766 y Fi(The)28 b(axis)f(incremen)n(t)g
-(to)h(add)f(to)g(the)h(original)e(axis)h(v)-5 b(alue.)0
-2920 y Fd(Returned)32 b(V)-8 b(alue:)259 3049 y(astAxO\013set)427
-3149 y Fi(The)28 b(incremen)n(ted)f(axis)g(v)-5 b(alue.)0
-3303 y Fd(Notes:)340 3578 y Fh(\017)45 b Fi(This)33 b(function)g(will)f
-(return)g(a)g Ft(")p Fi(bad)p Ft(")f Fi(result)h(v)-5
-b(alue)33 b(\(AST)p Ft(__)p Fi(BAD\))g(if)f(an)n(y)g(of)g(the)h(input)g
-(v)-5 b(alues)32 b(has)427 3678 y(this)c(v)-5 b(alue.)340
-3803 y Fh(\017)45 b Fi(A)27 b Ft(")p Fi(bad)p Ft(")e
-Fi(v)-5 b(alue)26 b(will)g(also)f(b)r(e)i(returned)e(if)i(this)f
-(function)h(is)f(in)n(v)n(ok)n(ed)f(with)h(the)h(AST)f(error)f(status)h
-(set,)427 3903 y(or)h(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)
-p 0 4087 V 0 4219 a Fz(astBBuf)390 b Fe(Begin)38 b(a)h(new)f(graphical)
-e(bu\013ering)i(con)m(text)389 b Fz(astBBuf)0 4393 y
-Fd(Description:)44 b Fi(This)34 b(function)g(starts)f(a)g(new)h
-(graphics)e(bu\013ering)i(con)n(text.)54 b(A)34 b(matc)n(hing)f(call)h
-(to)f(the)h(function)227 4493 y(astEBuf)27 b(should)h(b)r(e)g(used)f
-(to)h(end)g(the)g(con)n(text.)0 4635 y Fd(Synopsis:)121
-b Ft(void)42 b(astBBuf\()e(AstPlot)h Fh(\003)p Ft(this)g(\))0
-4777 y Fd(P)m(arameters:)259 4906 y(this)427 5006 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(Plot.)0 5160 y Fd(Notes:)340 5435 y Fh(\017)45
-b Fi(The)21 b(nature)e(of)i(the)f(bu\013ering)g(is)g(determined)h(b)n
-(y)f(the)g(underlying)g(graphics)f(system)h(\(as)g(de\014ned)g(b)n(y)g
-(the)427 5535 y(curren)n(t)26 b(grf)g(mo)r(dule\).)37
-b(Eac)n(h)25 b(call)h(to)h(this)f(function)h(to)g(this)g(function)g
-(simply)f(in)n(v)n(ok)n(es)f(the)i(astGBBuf)427 5634
-y(function)h(in)g(the)g(grf)f(mo)r(dule.)p eop end
+3497 y(or)h(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
+0 3698 V 0 3830 a Fz(astAxO\013set)209 b Fe(Add)39 b(an)g(incremen)m(t)
+e(on)m(to)g(a)i(supplied)f(axis)1758 3945 y(v)-7 b(alue)3090
+3830 y Fz(astAxO\013set)0 4112 y Fd(Description:)44 b
+Fi(This)39 b(function)g(returns)f(an)g(axis)g(v)-5 b(alue)39
+b(formed)f(b)n(y)g(adding)h(a)f(signed)g(axis)g(incremen)n(t)g(on)n(to)
+g(a)227 4212 y(supplied)28 b(axis)f(v)-5 b(alue.)227
+4337 y(F)e(or)29 b(a)h(simple)g(F)-7 b(rame,)29 b(this)i(is)e(a)h
+(trivial)f(op)r(eration)f(returning)h(the)i(sum)e(of)h(the)g(t)n(w)n(o)
+f(supplied)h(v)-5 b(alues.)43 b(But)227 4437 y(for)27
+b(other)g(deriv)n(ed)g(classes)f(of)i(F)-7 b(rame)27
+b(\(suc)n(h)h(as)f(a)g(SkyF)-7 b(rame\))27 b(this)h(is)f(not)h(the)g
+(case.)0 4588 y Fd(Synopsis:)121 b Ft(double)41 b(astAxOffset\()e
+(AstFrame)h Fh(\003)p Ft(this,)h(int)h(axis,)g(double)f(v1,)h(double)f
+(dist)h(\))0 4739 y Fd(P)m(arameters:)259 4877 y(this)427
+4977 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7 b(rame.)259
+5111 y Fd(axis)427 5210 y Fi(The)28 b(index)g(of)f(the)h(axis)f(to)g
+(whic)n(h)h(the)g(supplied)g(v)-5 b(alues)27 b(refer.)36
+b(The)28 b(\014rst)f(axis)g(has)g(index)h(1.)259 5344
+y Fd(v1)427 5444 y Fi(The)g(original)e(axis)h(v)-5 b(alue.)259
+5577 y Fd(dist)427 5677 y Fi(The)28 b(axis)f(incremen)n(t)g(to)h(add)f
+(to)g(the)h(original)e(axis)h(v)-5 b(alue.)p eop end
%%Page: 198 208
TeXDict begin 198 207 bop 0 52 a FF(198)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 483 a Fz(astBegin)1229 482 y Fe(Begin)38 b(a)g(new)h(AST)f(con)m
-(text)3272 483 y Fz(astBegin)0 648 y Fd(Description:)44
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Returned)i(V)-8
+b(alue:)259 511 y(astAxO\013set)427 611 y Fi(The)28 b(incremen)n(ted)f
+(axis)g(v)-5 b(alue.)0 796 y Fd(Notes:)340 1102 y Fh(\017)45
+b Fi(This)33 b(function)g(will)f(return)g(a)g Ft(")p
+Fi(bad)p Ft(")f Fi(result)h(v)-5 b(alue)33 b(\(AST)p
+Ft(__)p Fi(BAD\))g(if)f(an)n(y)g(of)g(the)h(input)g(v)-5
+b(alues)32 b(has)427 1202 y(this)c(v)-5 b(alue.)340 1346
+y Fh(\017)45 b Fi(A)27 b Ft(")p Fi(bad)p Ft(")e Fi(v)-5
+b(alue)26 b(will)g(also)f(b)r(e)i(returned)e(if)i(this)f(function)h(is)
+f(in)n(v)n(ok)n(ed)f(with)h(the)h(AST)f(error)f(status)h(set,)427
+1446 y(or)h(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
+0 1669 3780 12 v 0 1801 a Fz(astBBuf)390 b Fe(Begin)38
+b(a)h(new)f(graphical)e(bu\013ering)i(con)m(text)389
+b Fz(astBBuf)0 2013 y Fd(Description:)44 b Fi(This)34
+b(function)g(starts)f(a)g(new)h(graphics)e(bu\013ering)i(con)n(text.)54
+b(A)34 b(matc)n(hing)f(call)h(to)f(the)h(function)227
+2112 y(astEBuf)27 b(should)h(b)r(e)g(used)f(to)h(end)g(the)g(con)n
+(text.)0 2285 y Fd(Synopsis:)121 b Ft(void)42 b(astBBuf\()e(AstPlot)h
+Fh(\003)p Ft(this)g(\))0 2458 y Fd(P)m(arameters:)259
+2618 y(this)427 2718 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)0
+2903 y Fd(Notes:)340 3209 y Fh(\017)45 b Fi(The)21 b(nature)e(of)i(the)
+f(bu\013ering)g(is)g(determined)h(b)n(y)f(the)g(underlying)g(graphics)f
+(system)h(\(as)g(de\014ned)g(b)n(y)g(the)427 3309 y(curren)n(t)26
+b(grf)g(mo)r(dule\).)37 b(Eac)n(h)25 b(call)h(to)h(this)f(function)h
+(to)g(this)g(function)g(simply)f(in)n(v)n(ok)n(es)f(the)i(astGBBuf)427
+3409 y(function)h(in)g(the)g(grf)f(mo)r(dule.)p 0 3631
+V 0 3763 a Fz(astBegin)1229 3762 y Fe(Begin)38 b(a)g(new)h(AST)f(con)m
+(text)3272 3763 y Fz(astBegin)0 3975 y Fd(Description:)44
b Fi(This)27 b(macro)e(in)n(v)n(ok)n(es)f(a)i(function)h(to)f(b)r(egin)
g(a)g(new)h(AST)f(con)n(text.)36 b(An)n(y)27 b(Ob)5 b(ject)26
-b(p)r(oin)n(ters)f(created)227 748 y(within)32 b(this)f(con)n(text)f
+b(p)r(oin)n(ters)f(created)227 4075 y(within)32 b(this)f(con)n(text)f
(will)h(b)r(e)g(ann)n(ulled)f(when)h(it)g(is)f(later)g(ended)h(using)g
-(astEnd)f(\(just)h(as)f(if)h(astAnn)n(ul)g(had)227 847
+(astEnd)f(\(just)h(as)f(if)h(astAnn)n(ul)g(had)227 4175
y(b)r(een)38 b(in)n(v)n(ok)n(ed\),)h(unless)e(they)g(ha)n(v)n(e)g
(\014rst)g(b)r(een)g(exp)r(orted)g(using)g(astExp)r(ort)f(or)h
-(rendered)f(exempt)i(using)227 947 y(astExempt.)58 b(If)35
+(rendered)f(exempt)i(using)227 4274 y(astExempt.)58 b(If)35
b(ann)n(ulling)f(a)g(p)r(oin)n(ter)h(causes)e(an)i(Ob)5
b(ject's)34 b(RefCoun)n(t)h(attribute)g(to)f(fall)h(to)g(zero)e(\(whic)
-n(h)227 1047 y(happ)r(ens)28 b(when)g(the)g(last)f(p)r(oin)n(ter)g(to)h
+n(h)227 4374 y(happ)r(ens)28 b(when)g(the)g(last)f(p)r(oin)n(ter)g(to)h
(it)g(is)f(ann)n(ulled\),)h(then)g(the)g(Ob)5 b(ject)27
-b(will)h(b)r(e)g(deleted.)0 1184 y Fd(Synopsis:)121 b
-Ft(void)42 b(astBegin)0 1322 y Fd(Class)31 b(Applicabilit)m(y:)259
-1447 y(Ob)5 b(ject)427 1546 y Fi(This)28 b(macro)e(applies)h(to)h(all)f
-(Ob)5 b(jects.)0 1696 y Fd(Notes:)340 1967 y Fh(\017)45
+b(will)h(b)r(e)g(deleted.)0 4547 y Fd(Synopsis:)121 b
+Ft(void)42 b(astBegin)0 4720 y Fd(Class)31 b(Applicabilit)m(y:)259
+4880 y(Ob)5 b(ject)427 4979 y Fi(This)28 b(macro)e(applies)h(to)h(all)f
+(Ob)5 b(jects.)0 5165 y Fd(Notes:)340 5471 y Fh(\017)45
b Fi(astBegin)27 b(attempts)h(to)f(execute)h(ev)n(en)f(if)h(the)g(AST)g
(error)e(status)h(is)h(set)f(on)g(en)n(try)-7 b(.)340
-2088 y Fh(\017)45 b Fi(Con)n(texts)27 b(delimited)i(b)n(y)e(astBegin)g
+5615 y Fh(\017)45 b Fi(Con)n(texts)27 b(delimited)i(b)n(y)e(astBegin)g
(and)g(astEnd)g(ma)n(y)g(b)r(e)h(nested)g(to)f(an)n(y)g(depth.)p
-0 2264 V 0 2395 a Fz(astBorder)156 b Fe(Dra)m(w)38 b(a)g(b)s(order)g
-(around)g(v)-7 b(alid)38 b(regions)f(of)i(a)f(Plot)154
-b Fz(astBorder)0 2565 y Fd(Description:)44 b Fi(This)32
-b(function)h(dra)n(ws)e(a)h(\(line\))h(b)r(order)e(around)g(regions)g
-(of)h(the)g(plotting)h(area)d(of)i(a)g(Plot)g(whic)n(h)227
-2665 y(corresp)r(ond)d(to)h(v)-5 b(alid,)30 b(unclipp)r(ed)h(ph)n
-(ysical)f(co)r(ordinates.)42 b(F)-7 b(or)30 b(example,)g(when)g
-(plotting)g(using)g(an)g(all-sky)227 2764 y(map)g(pro)5
-b(jection,)29 b(this)h(function)g(could)f(b)r(e)h(used)g(to)f(dra)n(w)g
-(the)h(b)r(oundary)f(of)g(the)h(celestial)f(sphere)g(when)h(it)227
-2864 y(is)e(pro)5 b(jected)27 b(on)g(to)g(the)h(plotting)g(surface.)227
-2983 y(If)k(the)g(en)n(tire)f(plotting)g(area)f(con)n(tains)h(v)-5
-b(alid,)32 b(unclipp)r(ed)g(ph)n(ysical)f(co)r(ordinates,)g(then)h(the)
-g(b)r(oundary)e(will)227 3082 y(just)e(b)r(e)g(a)g(rectangular)d(b)r(o)
-n(x)i(around)g(the)h(edges)f(of)g(the)h(plotting)g(area.)227
-3201 y(If)19 b(the)g(Plot)f(is)h(a)f(Plot3D,)g(this)h(metho)r(d)g(is)f
-(applied)h(individually)g(to)f(eac)n(h)g(of)g(the)h(three)g(2D)f(Plots)
-g(encapsulated)227 3301 y(within)23 b(the)g(Plot3D)f(\(eac)n(h)f(of)i
+eop end
+%%Page: 199 209
+TeXDict begin 199 208 bop 3643 52 a FF(199)p 0 351 3780
+12 v 0 483 a Fz(astBorder)156 b Fe(Dra)m(w)38 b(a)g(b)s(order)g(around)
+g(v)-7 b(alid)38 b(regions)f(of)i(a)f(Plot)154 b Fz(astBorder)0
+678 y Fd(Description:)44 b Fi(This)32 b(function)h(dra)n(ws)e(a)h
+(\(line\))h(b)r(order)e(around)g(regions)g(of)h(the)g(plotting)h(area)d
+(of)i(a)g(Plot)g(whic)n(h)227 778 y(corresp)r(ond)d(to)h(v)-5
+b(alid,)30 b(unclipp)r(ed)h(ph)n(ysical)f(co)r(ordinates.)42
+b(F)-7 b(or)30 b(example,)g(when)g(plotting)g(using)g(an)g(all-sky)227
+878 y(map)g(pro)5 b(jection,)29 b(this)h(function)g(could)f(b)r(e)h
+(used)g(to)f(dra)n(w)g(the)h(b)r(oundary)f(of)g(the)h(celestial)f
+(sphere)g(when)h(it)227 977 y(is)e(pro)5 b(jected)27
+b(on)g(to)g(the)h(plotting)g(surface.)227 1103 y(If)k(the)g(en)n(tire)f
+(plotting)g(area)f(con)n(tains)h(v)-5 b(alid,)32 b(unclipp)r(ed)g(ph)n
+(ysical)f(co)r(ordinates,)g(then)h(the)g(b)r(oundary)e(will)227
+1202 y(just)e(b)r(e)g(a)g(rectangular)d(b)r(o)n(x)i(around)g(the)h
+(edges)f(of)g(the)h(plotting)g(area.)227 1328 y(If)19
+b(the)g(Plot)f(is)h(a)f(Plot3D,)g(this)h(metho)r(d)g(is)f(applied)h
+(individually)g(to)f(eac)n(h)g(of)g(the)h(three)g(2D)f(Plots)g
+(encapsulated)227 1427 y(within)23 b(the)g(Plot3D)f(\(eac)n(h)f(of)i
(these)f(Plots)f(corresp)r(onds)g(to)h(a)g(single)g(2D)g(plane)g(in)h
-(the)f(3D)h(graphics)d(system\).)227 3400 y(In)36 b(addition,)i(if)e
+(the)f(3D)h(graphics)d(system\).)227 1527 y(In)36 b(addition,)i(if)e
(the)g(en)n(tire)f(plotting)h(v)n(olume)e(has)i(v)-5
b(alid)35 b(co)r(ordinates)f(in)i(the)g(3D)g(curren)n(t)f(F)-7
-b(rame)35 b(of)g(the)227 3500 y(Plot3D,)g(then)i(additional)e(lines)g
+b(rame)35 b(of)g(the)227 1627 y(Plot3D,)g(then)i(additional)e(lines)g
(are)g(dra)n(wn)g(along)f(the)i(edges)f(of)h(the)g(3D)f(plotting)h(v)n
-(olume)f(so)g(that)h(the)227 3599 y(en)n(tire)27 b(plotting)h(v)n
+(olume)f(so)g(that)h(the)227 1726 y(en)n(tire)27 b(plotting)h(v)n
(olume)f(is)h(enclosed)e(within)j(a)e(cub)r(oid)h(grid.)0
-3737 y Fd(Synopsis:)121 b Ft(int)42 b(astBorder\()e(AstPlot)g
-Fh(\003)p Ft(this)i(\))0 3875 y Fd(P)m(arameters:)259
-3999 y(this)427 4099 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)0
-4249 y Fd(Returned)k(V)-8 b(alue:)259 4374 y(astBorder\(\))427
-4473 y Fi(Zero)36 b(is)i(returned)f(if)h(the)f(plotting)h(space)e(is)i
+1878 y Fd(Synopsis:)121 b Ft(int)42 b(astBorder\()e(AstPlot)g
+Fh(\003)p Ft(this)i(\))0 2029 y Fd(P)m(arameters:)259
+2167 y(this)427 2267 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)0
+2431 y Fd(Returned)k(V)-8 b(alue:)259 2569 y(astBorder\(\))427
+2669 y Fi(Zero)36 b(is)i(returned)f(if)h(the)f(plotting)h(space)e(is)i
(completely)f(\014lled)h(b)n(y)f(v)-5 b(alid,)40 b(unclipp)r(ed)e(ph)n
-(ysical)e(co-)427 4573 y(ordinates)e(\(so)g(that)h(only)f(a)h
+(ysical)e(co-)427 2768 y(ordinates)e(\(so)g(that)h(only)f(a)h
(rectangular)d(b)r(o)n(x)j(w)n(as)e(dra)n(wn)h(around)g(the)h(edge\).)
-58 b(Otherwise,)35 b(one)g(is)427 4673 y(returned.)0
-4823 y Fd(Notes:)340 5093 y Fh(\017)45 b Fi(A)29 b(v)-5
+58 b(Otherwise,)35 b(one)g(is)427 2868 y(returned.)0
+3032 y Fd(Notes:)340 3316 y Fh(\017)45 b Fi(A)29 b(v)-5
b(alue)29 b(of)f(zero)g(will)h(b)r(e)g(returned)f(if)h(this)g(function)
g(is)f(in)n(v)n(ok)n(ed)f(with)j(the)f(AST)g(error)d(status)j(set,)f
-(or)427 5193 y(if)g(it)g(should)g(fail)f(for)h(an)n(y)e(reason.)340
-5314 y Fh(\017)45 b Fi(An)23 b(error)e(results)h(if)i(either)e(the)h
+(or)427 3416 y(if)g(it)g(should)g(fail)f(for)h(an)n(y)e(reason.)340
+3549 y Fh(\017)45 b Fi(An)23 b(error)e(results)h(if)i(either)e(the)h
(curren)n(t)f(F)-7 b(rame)22 b(or)g(the)h(base)f(F)-7
b(rame)23 b(of)f(the)h(Plot)g(is)f(not)h(2-dimensional)427
-5414 y(or)k(\(for)g(a)h(Plot3D\))f(3-dimensional.)340
-5535 y Fh(\017)45 b Fi(An)30 b(error)d(also)g(results)i(if)g(the)g
+3649 y(or)k(\(for)g(a)h(Plot3D\))f(3-dimensional.)340
+3783 y Fh(\017)45 b Fi(An)30 b(error)d(also)g(results)i(if)g(the)g
(transformation)f(b)r(et)n(w)n(een)h(the)g(base)f(and)h(curren)n(t)f(F)
--7 b(rames)28 b(of)h(the)g(Plot)427 5634 y(is)f(not)f(de\014ned)h
+-7 b(rames)28 b(of)h(the)g(Plot)427 3882 y(is)f(not)f(de\014ned)h
(\(i.e.)38 b(the)28 b(Plot's)e(T)-7 b(ranF)g(orw)n(ard)25
-b(attribute)j(is)g(zero\).)p eop end
-%%Page: 199 209
-TeXDict begin 199 208 bop 3643 52 a FF(199)p 0 351 3780
-12 v 0 483 a Fz(astBoundingBo)l(x)234 b Fe(Return)39
-b(a)f(b)s(ounding)g(b)s(o)m(x)g(for)1221 598 y(previously)f(dra)m(wn)g
-(graphics)2812 483 y Fz(astBoundingBo)l(x)0 790 y Fd(Description:)44
-b Fi(This)27 b(function)f(returns)g(the)h(b)r(ounds)f(of)g(a)g(b)r(o)n
-(x)g(whic)n(h)g(just)h(encompasess)d(the)j(graphics)e(pro)r(duced)227
-890 y(b)n(y)c(the)g(previous)f(call)h(to)g(an)n(y)f(of)h(the)h(Plot)e
-(metho)r(ds)h(whic)n(h)g(pro)r(duce)g(graphical)f(output.)35
-b(If)21 b(no)g(suc)n(h)g(previous)227 989 y(call)26 b(has)f(y)n(et)g(b)
-r(een)i(made,)f(or)e(if)j(the)f(call)f(failed)h(for)f(an)n(y)g(reason,)
-g(then)h(the)g(b)r(ounding)g(b)r(o)n(x)g(returned)f(b)n(y)g(this)227
-1089 y(function)j(is)g(unde\014ned.)0 1242 y Fd(Synopsis:)121
-b Ft(void)42 b(astBoundingBox\()37 b(AstPlot)k Fh(\003)p
-Ft(this,)g(float)g(lbnd[2],)g(float)g(ubnd[2])g(\))0
-1395 y Fd(P)m(arameters:)259 1535 y(this)427 1635 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(Plot.)259 1769 y Fd(lbnd)427 1869 y Fi(A)e(t)n(w)n(o)f
-(elemen)n(t)g(arra)n(y)e(in)j(whic)n(h)f(is)g(returned)g(the)h(lo)n(w)n
-(er)e(limits)i(of)f(the)h(b)r(ounding)f(b)r(o)n(x)g(on)g(eac)n(h)g(of)g
-(the)427 1969 y(t)n(w)n(o)i(axes)g(of)g(the)h(graphics)e(co)r(ordinate)
-h(system)g(\(the)h(base)f(F)-7 b(rame)28 b(of)f(the)h(Plot\).)259
-2103 y Fd(ubnd)427 2203 y Fi(A)33 b(t)n(w)n(o)f(elemen)n(t)g(arra)n(y)e
-(in)j(whic)n(h)f(is)h(returned)f(the)h(upp)r(er)f(limits)h(of)g(the)f
-(b)r(ounding)h(b)r(o)n(x)f(on)g(eac)n(h)g(of)427 2303
-y(the)c(t)n(w)n(o)f(axes)g(of)g(the)h(graphics)e(co)r(ordinate)h
-(system)g(\(the)h(base)f(F)-7 b(rame)27 b(of)h(the)g(Plot\).)0
-2468 y Fd(Notes:)340 2754 y Fh(\017)45 b Fi(An)28 b(error)e(results)h
-(if)h(the)g(base)f(F)-7 b(rame)27 b(of)h(the)g(Plot)f(is)g(not)h
-(2-dimensional.)p 0 2957 V 0 3088 a Fz(astBo)l(x)1152
-b Fe(Create)38 b(a)g(Bo)m(x)1151 b Fz(astBo)l(x)0 3257
-y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g(Bo)n
-(x)g(and)g(optionally)g(initialises)g(its)h(attributes.)227
-3383 y(The)35 b(Bo)n(x)f(class)g(implemen)n(ts)i(a)e(Region)g(whic)n(h)
-h(represen)n(ts)f(a)g(b)r(o)n(x)h(with)g(sides)g(parallel)f(to)h(the)g
-(axes)f(of)h(a)227 3483 y(F)-7 b(rame)36 b(\(i.e.)64
+b(attribute)j(is)g(zero\).)p 0 4084 V 0 4215 a Fz(astBoundingBo)l(x)234
+b Fe(Return)39 b(a)f(b)s(ounding)g(b)s(o)m(x)g(for)1221
+4330 y(previously)f(dra)m(wn)g(graphics)2812 4215 y Fz(astBoundingBo)l
+(x)0 4521 y Fd(Description:)44 b Fi(This)27 b(function)f(returns)g(the)
+h(b)r(ounds)f(of)g(a)g(b)r(o)n(x)g(whic)n(h)g(just)h(encompasess)d(the)
+j(graphics)e(pro)r(duced)227 4620 y(b)n(y)c(the)g(previous)f(call)h(to)
+g(an)n(y)f(of)h(the)h(Plot)e(metho)r(ds)h(whic)n(h)g(pro)r(duce)g
+(graphical)f(output.)35 b(If)21 b(no)g(suc)n(h)g(previous)227
+4720 y(call)26 b(has)f(y)n(et)g(b)r(een)i(made,)f(or)e(if)j(the)f(call)
+f(failed)h(for)f(an)n(y)g(reason,)g(then)h(the)g(b)r(ounding)g(b)r(o)n
+(x)g(returned)f(b)n(y)g(this)227 4819 y(function)j(is)g(unde\014ned.)0
+4971 y Fd(Synopsis:)121 b Ft(void)42 b(astBoundingBox\()37
+b(AstPlot)k Fh(\003)p Ft(this,)g(float)g(lbnd[2],)g(float)g(ubnd[2])g
+(\))0 5122 y Fd(P)m(arameters:)259 5260 y(this)427 5360
+y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259 5494 y Fd(lbnd)427
+5593 y Fi(A)e(t)n(w)n(o)f(elemen)n(t)g(arra)n(y)e(in)j(whic)n(h)f(is)g
+(returned)g(the)h(lo)n(w)n(er)e(limits)i(of)f(the)h(b)r(ounding)f(b)r
+(o)n(x)g(on)g(eac)n(h)g(of)g(the)427 5693 y(t)n(w)n(o)i(axes)g(of)g
+(the)h(graphics)e(co)r(ordinate)h(system)g(\(the)h(base)f(F)-7
+b(rame)28 b(of)f(the)h(Plot\).)p eop end
+%%Page: 200 210
+TeXDict begin 200 209 bop 0 52 a FF(200)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(ubnd)427
+451 y Fi(A)j(t)n(w)n(o)f(elemen)n(t)g(arra)n(y)e(in)j(whic)n(h)f(is)h
+(returned)f(the)h(upp)r(er)f(limits)h(of)g(the)f(b)r(ounding)h(b)r(o)n
+(x)f(on)g(eac)n(h)g(of)427 551 y(the)c(t)n(w)n(o)f(axes)g(of)g(the)h
+(graphics)e(co)r(ordinate)h(system)g(\(the)h(base)f(F)-7
+b(rame)27 b(of)h(the)g(Plot\).)0 723 y Fd(Notes:)340
+1017 y Fh(\017)45 b Fi(An)28 b(error)e(results)h(if)h(the)g(base)f(F)-7
+b(rame)27 b(of)h(the)g(Plot)f(is)g(not)h(2-dimensional.)p
+0 1227 3780 12 v 0 1357 a Fz(astBo)l(x)1152 b Fe(Create)38
+b(a)g(Bo)m(x)1151 b Fz(astBo)l(x)0 1534 y Fd(Description:)44
+b Fi(This)28 b(function)g(creates)f(a)g(new)g(Bo)n(x)g(and)g
+(optionally)g(initialises)g(its)h(attributes.)227 1664
+y(The)35 b(Bo)n(x)f(class)g(implemen)n(ts)i(a)e(Region)g(whic)n(h)h
+(represen)n(ts)f(a)g(b)r(o)n(x)h(with)g(sides)g(parallel)f(to)h(the)g
+(axes)f(of)h(a)227 1764 y(F)-7 b(rame)36 b(\(i.e.)64
b(an)36 b(area)f(whic)n(h)i(encloses)e(a)h(giv)n(en)g(range)f(of)h(v)-5
b(alues)37 b(on)f(eac)n(h)f(axis\).)63 b(A)37 b(Bo)n(x)f(is)g(similar)g
-(to)227 3583 y(an)h(In)n(terv)-5 b(al,)40 b(the)d(only)g(real)g
+(to)227 1863 y(an)h(In)n(terv)-5 b(al,)40 b(the)d(only)g(real)g
(di\013erence)g(b)r(eing)g(that)h(the)g(In)n(terv)-5
b(al)36 b(class)h(allo)n(ws)f(some)h(axis)f(limits)i(to)f(b)r(e)227
-3682 y(unsp)r(eci\014ed.)g(Note,)26 b(a)e(Bo)n(x)h(will)g(only)g(lo)r
+1963 y(unsp)r(eci\014ed.)g(Note,)26 b(a)e(Bo)n(x)h(will)g(only)g(lo)r
(ok)f(lik)n(e)h(a)g(b)r(o)n(x)g(if)g(the)h(F)-7 b(rame)25
b(geometry)f(is)h(appro)n(ximately)e(\015at.)36 b(F)-7
-b(or)227 3782 y(instance,)34 b(a)e(Bo)n(x)f(cen)n(tred)h(close)f(to)h
+b(or)227 2062 y(instance,)34 b(a)e(Bo)n(x)f(cen)n(tred)h(close)f(to)h
(a)g(p)r(ole)h(in)f(a)g(SkyF)-7 b(rame)32 b(will)g(lo)r(ok)g(more)f
(lik)n(e)h(a)g(fan)h(than)f(a)g(b)r(o)n(x)g(\(the)227
-3882 y(P)n(olygon)26 b(class)g(can)i(b)r(e)g(used)f(to)h(create)e(a)h
+2162 y(P)n(olygon)26 b(class)g(can)i(b)r(e)g(used)f(to)h(create)e(a)h
(b)r(o)n(x-lik)n(e)g(region)f(close)h(to)g(a)h(p)r(ole\).)0
-4035 y Fd(Synopsis:)121 b Ft(AstBox)41 b Fh(\003)p Ft(astBox\()f
+2322 y Fd(Synopsis:)121 b Ft(AstBox)41 b Fh(\003)p Ft(astBox\()f
(AstFrame)g Fh(\003)p Ft(frame,)h(int)h(form,)g(const)f(double)h
-(point1[],)d(const)j(double)227 4134 y(point2[],)e(AstRegion)g
+(point1[],)d(const)j(double)227 2422 y(point2[],)e(AstRegion)g
Fh(\003)p Ft(unc,)h(const)h(char)g Fh(\003)p Ft(options,)e(...)86
-b(\))0 4287 y Fd(P)m(arameters:)259 4427 y(frame)427
-4527 y Fi(A)29 b(p)r(oin)n(ter)g(to)f(the)i(F)-7 b(rame)28
+b(\))0 2582 y Fd(P)m(arameters:)259 2730 y(frame)427
+2829 y Fi(A)29 b(p)r(oin)n(ter)g(to)f(the)i(F)-7 b(rame)28
b(in)h(whic)n(h)g(the)g(region)e(is)i(de\014ned.)41 b(A)29
b(deep)g(cop)n(y)f(is)g(tak)n(en)g(of)h(the)g(supplied)427
-4627 y(F)-7 b(rame.)71 b(This)39 b(means)f(that)h(an)n(y)g(subsequen)n
+2929 y(F)-7 b(rame.)71 b(This)39 b(means)f(that)h(an)n(y)g(subsequen)n
(t)f(c)n(hanges)g(made)h(to)f(the)i(F)-7 b(rame)38 b(using)h(the)g
-(supplied)427 4726 y(p)r(oin)n(ter)27 b(will)h(ha)n(v)n(e)f(no)g
-(e\013ect)h(the)g(Region.)259 4861 y Fd(form)427 4961
+(supplied)427 3028 y(p)r(oin)n(ter)27 b(will)h(ha)n(v)n(e)f(no)g
+(e\013ect)h(the)g(Region.)259 3167 y Fd(form)427 3266
y Fi(Indicates)k(ho)n(w)g(the)g(b)r(o)n(x)g(is)g(describ)r(ed)f(b)n(y)h
(the)h(remaining)e(parameters.)48 b(A)33 b(v)-5 b(alue)32
-b(of)g(zero)f(indicates)427 5060 y(that)d(the)g(b)r(o)n(x)f(is)h(sp)r
+b(of)g(zero)f(indicates)427 3366 y(that)d(the)g(b)r(o)n(x)f(is)h(sp)r
(eci\014ed)g(b)n(y)f(a)g(cen)n(tre)g(p)r(osition)h(and)f(a)h(corner)e
(p)r(osition.)36 b(A)28 b(v)-5 b(alue)28 b(of)g(one)f(indicates)427
-5160 y(that)h(the)g(b)r(o)n(x)f(is)h(sp)r(eci\014ed)g(b)n(y)f(a)g(t)n
-(w)n(o)g(opp)r(osite)g(corner)f(p)r(ositions.)259 5295
-y Fd(p)s(oin)m(t1)427 5394 y Fi(An)35 b(arra)n(y)d(of)i(double,)i(with)
+3466 y(that)h(the)g(b)r(o)n(x)f(is)h(sp)r(eci\014ed)g(b)n(y)f(a)g(t)n
+(w)n(o)g(opp)r(osite)g(corner)f(p)r(ositions.)259 3604
+y Fd(p)s(oin)m(t1)427 3703 y Fi(An)35 b(arra)n(y)d(of)i(double,)i(with)
e(one)g(elemen)n(t)g(for)g(eac)n(h)f(F)-7 b(rame)34 b(axis)f(\(Naxes)h
(attribute\).)57 b(If)35 b Ft(")p Fi(form)p Ft(")e Fi(is)427
-5494 y(zero,)i(this)f(arra)n(y)e(should)h(con)n(tain)h(the)g(co)r
+3803 y(zero,)i(this)f(arra)n(y)e(should)h(con)n(tain)h(the)g(co)r
(ordinates)f(at)g(the)i(cen)n(tre)e(of)h(the)g(b)r(o)n(x.)56
-b(If)34 b Ft(")p Fi(form)p Ft(")f Fi(is)h(one,)427 5593
+b(If)34 b Ft(")p Fi(form)p Ft(")f Fi(is)h(one,)427 3903
y(it)f(should)f(con)n(tain)f(the)i(co)r(ordinates)d(at)i(the)h(corner)e
(of)h(the)g(b)r(o)n(x)g(whic)n(h)g(is)g(diagonally)e(opp)r(osite)i(the)
-427 5693 y(corner)26 b(sp)r(eci\014ed)i(b)n(y)g Ft(")p
-Fi(p)r(oin)n(t2)p Ft(")p Fi(.)p eop end
-%%Page: 200 210
-TeXDict begin 200 209 bop 0 52 a FF(200)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(p)s(oin)m(t2)427
-451 y Fi(An)i(arra)n(y)c(of)j(double,)h(with)g(one)e(elemen)n(t)i(for)e
-(eac)n(h)g(F)-7 b(rame)31 b(axis)f(\(Naxes)h(attribute\))g(con)n
-(taining)f(the)427 551 y(co)r(ordinates)c(at)i(an)n(y)f(corner)f(of)h
-(the)h(b)r(o)n(x.)259 680 y Fd(unc)427 779 y Fi(An)33
+427 4002 y(corner)26 b(sp)r(eci\014ed)i(b)n(y)g Ft(")p
+Fi(p)r(oin)n(t2)p Ft(")p Fi(.)259 4141 y Fd(p)s(oin)m(t2)427
+4240 y Fi(An)k(arra)n(y)c(of)j(double,)h(with)g(one)e(elemen)n(t)i(for)
+e(eac)n(h)g(F)-7 b(rame)31 b(axis)f(\(Naxes)h(attribute\))g(con)n
+(taining)f(the)427 4340 y(co)r(ordinates)c(at)i(an)n(y)f(corner)f(of)h
+(the)h(b)r(o)n(x.)259 4478 y Fd(unc)427 4578 y Fi(An)33
b(optional)e(p)r(oin)n(ter)h(to)g(an)g(existing)g(Region)f(whic)n(h)h
(sp)r(eci\014es)g(the)h(uncertain)n(ties)e(asso)r(ciated)g(with)427
-879 y(the)j(b)r(oundary)f(of)g(the)h(Bo)n(x)f(b)r(eing)g(created.)54
+4677 y(the)j(b)r(oundary)f(of)g(the)h(Bo)n(x)f(b)r(eing)g(created.)54
b(The)34 b(uncertain)n(t)n(y)e(in)i(an)n(y)f(p)r(oin)n(t)h(on)f(the)h
-(b)r(oundary)f(of)427 979 y(the)g(Bo)n(x)e(is)h(found)h(b)n(y)f
+(b)r(oundary)f(of)427 4777 y(the)g(Bo)n(x)e(is)h(found)h(b)n(y)f
(shifting)h(the)f(supplied)h Ft(")p Fi(uncertain)n(t)n(y)p
Ft(")e Fi(Region)g(so)h(that)g(it)h(is)f(cen)n(tred)g(at)g(the)427
-1078 y(b)r(oundary)e(p)r(oin)n(t)h(b)r(eing)g(considered.)44
+4877 y(b)r(oundary)e(p)r(oin)n(t)h(b)r(eing)g(considered.)44
b(The)31 b(area)e(co)n(v)n(ered)g(b)n(y)h(the)h(shifted)g(uncertain)n
-(t)n(y)f(Region)g(then)427 1178 y(represen)n(ts)g(the)i(uncertain)n(t)n
+(t)n(y)f(Region)g(then)427 4976 y(represen)n(ts)g(the)i(uncertain)n(t)n
(y)f(in)g(the)h(b)r(oundary)f(p)r(osition.)48 b(The)31
b(uncertain)n(t)n(y)g(is)g(assumed)g(to)g(b)r(e)h(the)427
-1277 y(same)27 b(for)g(all)h(p)r(oin)n(ts.)427 1392 y(If)38
+5076 y(same)27 b(for)g(all)h(p)r(oin)n(ts.)427 5195 y(If)38
b(supplied,)j(the)d(uncertain)n(t)n(y)f(Region)g(m)n(ust)g(b)r(e)i(of)e
(a)g(class)g(for)g(whic)n(h)h(all)f(instances)g(are)g(cen)n(tro-)427
-1491 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24 b(Circle,)g(Ellipse,)h
+5295 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24 b(Circle,)g(Ellipse,)h
(etc.\))36 b(or)23 b(b)r(e)i(a)e(Prism)h(con)n(taining)f(cen)n
-(tro-symetric)f(comp)r(onen)n(t)427 1591 y(Regions.)57
+(tro-symetric)f(comp)r(onen)n(t)427 5394 y(Regions.)57
b(A)35 b(deep)f(cop)n(y)g(of)g(the)h(supplied)g(Region)f(will)g(b)r(e)h
(tak)n(en,)h(so)e(subsequen)n(t)g(c)n(hanges)f(to)h(the)427
-1691 y(uncertain)n(t)n(y)28 b(Region)f(using)h(the)h(supplied)f(p)r
+5494 y(uncertain)n(t)n(y)28 b(Region)f(using)h(the)h(supplied)f(p)r
(oin)n(ter)g(will)h(ha)n(v)n(e)e(no)h(e\013ect)h(on)f(the)g(created)g
-(Bo)n(x.)38 b(Alter-)427 1790 y(nativ)n(ely)-7 b(,)24
+(Bo)n(x.)38 b(Alter-)427 5593 y(nativ)n(ely)-7 b(,)24
b(a)g(NULL)g(Ob)5 b(ject)24 b(p)r(oin)n(ter)f(ma)n(y)h(b)r(e)g
(supplied,)h(in)f(whic)n(h)g(case)f(a)g(default)i(uncertain)n(t)n(y)e
-(is)h(used)427 1890 y(equiv)-5 b(alen)n(t)28 b(to)f(a)g(b)r(o)n(x)g
-(1.0E-6)f(of)h(the)h(size)g(of)f(the)h(Bo)n(x)f(b)r(eing)g(created.)427
-2004 y(The)c(uncertain)n(t)n(y)f(Region)g(has)g(t)n(w)n(o)g(uses:)34
+(is)h(used)427 5693 y(equiv)-5 b(alen)n(t)28 b(to)f(a)g(b)r(o)n(x)g
+(1.0E-6)f(of)h(the)h(size)g(of)f(the)h(Bo)n(x)f(b)r(eing)g(created.)p
+eop end
+%%Page: 201 211
+TeXDict begin 201 210 bop 3643 52 a FF(201)427 351 y
+Fi(The)23 b(uncertain)n(t)n(y)f(Region)g(has)g(t)n(w)n(o)g(uses:)34
b(1\))22 b(when)h(the)g(astOv)n(erlap)d(function)k(compares)d(t)n(w)n
-(o)h(Regions)427 2104 y(for)g(equalit)n(y)h(the)g(uncertain)n(t)n(y)f
+(o)h(Regions)427 451 y(for)g(equalit)n(y)h(the)g(uncertain)n(t)n(y)f
(Region)g(is)g(used)h(to)g(determine)f(the)i(tolerance)d(on)i(the)g
-(comparison,)f(and)427 2204 y(2\))31 b(when)f(a)h(Region)e(is)i(mapp)r
+(comparison,)f(and)427 551 y(2\))31 b(when)f(a)h(Region)e(is)i(mapp)r
(ed)g(in)n(to)f(a)g(di\013eren)n(t)h(co)r(ordinate)e(system)i(and)f
-(subsequen)n(tly)g(simpli\014ed)427 2303 y(\(using)c(astSimplify\),)h
+(subsequen)n(tly)g(simpli\014ed)427 650 y(\(using)c(astSimplify\),)h
(the)f(uncertain)n(ties)f(are)g(used)h(to)g(determine)g(if)g(the)g
-(transformed)f(b)r(oundary)g(can)427 2403 y(b)r(e)j(accurately)e
+(transformed)f(b)r(oundary)g(can)427 750 y(b)r(e)j(accurately)e
(represen)n(ted)h(b)n(y)g(a)g(sp)r(eci\014c)h(shap)r(e)f(of)h(Region.)
-259 2532 y Fd(options)427 2632 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n
+259 872 y Fd(options)427 972 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n
(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 2731 y(assignmen)n(ts)f
+(comma-separated)e(list)i(of)g(attribute)427 1071 y(assignmen)n(ts)f
(to)i(b)r(e)f(used)h(for)f(initialising)g(the)h(new)f(Bo)n(x.)38
b(The)29 b(syn)n(tax)e(used)i(is)f(iden)n(tical)g(to)g(that)h(for)427
-2831 y(the)h(astSet)f(function)g(and)g(ma)n(y)f(include)h
+1171 y(the)h(astSet)f(function)g(and)g(ma)n(y)f(include)h
Ft(")p Fi(prin)n(tf)p Ft(")g Fi(format)f(sp)r(eci\014ers)h(iden)n
(ti\014ed)g(b)n(y)g Ft(")p Fi(\045)p Ft(")f Fi(sym)n(b)r(ols)g(in)427
-2931 y(the)g(normal)f(w)n(a)n(y)-7 b(.)259 3060 y Fd(...)427
-3159 y Fi(If)38 b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n
+1271 y(the)g(normal)f(w)n(a)n(y)-7 b(.)259 1393 y Fd(...)427
+1493 y Fi(If)38 b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n
(tains)f Ft(")p Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f
-(an)f(optional)g(list)h(of)f(additional)427 3259 y(argumen)n(ts)26
+(an)f(optional)g(list)h(of)f(additional)427 1592 y(argumen)n(ts)26
b(ma)n(y)h(follo)n(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5
b(alues)27 b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)
-37 b(The)427 3359 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+37 b(The)427 1692 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 3458 y Fi(function\).)0
-3616 y Fd(Returned)32 b(V)-8 b(alue:)259 3749 y(astBo)m(x\(\))427
-3849 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Bo)n(x.)0
-4007 y Fd(Notes:)340 4286 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 1792 y Fi(function\).)0
+1943 y Fd(Returned)32 b(V)-8 b(alue:)259 2069 y(astBo)m(x\(\))427
+2169 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Bo)n(x.)0
+2320 y Fd(Notes:)340 2592 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 4386 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)-2 4544 y Fd(Status)33
-b(Handling)n(:)227 4690 y Fi(The)d(protected)g(in)n(terface)f(to)g
+427 2692 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)-2 2844 y Fd(Status)33
+b(Handling)n(:)227 2990 y Fi(The)d(protected)g(in)n(terface)f(to)g
(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
-(of)g(the)g(parameter)227 4790 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
+(of)g(the)g(parameter)227 3089 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
-Fi(in)n(t)227 4889 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p
-0 5081 3780 12 v 0 5213 a Fz(astChannel)786 b Fe(Create)37
-b(a)i(Channel)783 b Fz(astChannel)0 5371 y Fd(Description:)44
+Fi(in)n(t)227 3189 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p
+0 3367 3780 12 v 0 3499 a Fz(astChannel)786 b Fe(Create)37
+b(a)i(Channel)783 b Fz(astChannel)0 3644 y Fd(Description:)44
b Fi(This)28 b(function)g(creates)f(a)g(new)g(Channel)h(and)f
-(optionally)g(initialises)g(its)h(attributes.)227 5494
+(optionally)g(initialises)g(its)h(attributes.)227 3763
y(A)22 b(Channel)g(implemen)n(ts)g(lo)n(w-lev)n(el)e(input/output)i
(for)f(the)i(AST)f(library)-7 b(.)33 b(W)-7 b(riting)22
-b(an)f(Ob)5 b(ject)22 b(to)f(a)h(Channel)227 5593 y(\(using)i(astW)-7
+b(an)f(Ob)5 b(ject)22 b(to)f(a)h(Channel)227 3863 y(\(using)i(astW)-7
b(rite\))25 b(will)f(generate)f(a)h(textual)h(represen)n(tation)d(of)i
(that)h(Ob)5 b(ject,)25 b(and)f(reading)f(from)h(a)g(Channel)227
-5693 y(\(using)k(astRead\))f(will)h(create)e(a)i(new)f(Ob)5
-b(ject)28 b(from)f(its)h(textual)f(represen)n(tation.)p
-eop end
-%%Page: 201 211
-TeXDict begin 201 210 bop 3643 52 a FF(201)227 351 y
-Fi(Normally)-7 b(,)20 b(when)f(y)n(ou)g(use)f(a)h(Channel,)i(y)n(ou)d
-(should)h(pro)n(vide)f Ft(")p Fi(source)p Ft(")f Fi(and)h
-Ft(")p Fi(sink)p Ft(")g Fi(functions)i(whic)n(h)f(connect)227
-451 y(it)38 b(to)f(an)f(external)h(data)f(store)g(b)n(y)h(reading)f
+3963 y(\(using)k(astRead\))f(will)h(create)e(a)i(new)f(Ob)5
+b(ject)28 b(from)f(its)h(textual)f(represen)n(tation.)227
+4082 y(Normally)-7 b(,)20 b(when)f(y)n(ou)g(use)f(a)h(Channel,)i(y)n
+(ou)d(should)h(pro)n(vide)f Ft(")p Fi(source)p Ft(")f
+Fi(and)h Ft(")p Fi(sink)p Ft(")g Fi(functions)i(whic)n(h)f(connect)227
+4182 y(it)38 b(to)f(an)f(external)h(data)f(store)g(b)n(y)h(reading)f
(and)h(writing)f(the)i(resulting)e(text.)66 b(By)37 b(default,)j(ho)n
-(w)n(ev)n(er,)d(a)227 551 y(Channel)e(will)f(read)g(from)g(standard)f
+(w)n(ev)n(er,)d(a)227 4281 y(Channel)e(will)f(read)g(from)g(standard)f
(input)j(and)e(write)g(to)h(standard)e(output.)58 b(Alternativ)n(ely)-7
-b(,)36 b(a)e(Channel)227 650 y(can)25 b(b)r(e)h(told)g(to)f(read)g(or)g
-(write)g(from)g(sp)r(eci\014c)h(text)g(\014les)f(using)g(the)h
-(SinkFile)g(and)g(SourceFile)e(attributes,)i(in)227 750
+b(,)36 b(a)e(Channel)227 4381 y(can)25 b(b)r(e)h(told)g(to)f(read)g(or)
+g(write)g(from)g(sp)r(eci\014c)h(text)g(\014les)f(using)g(the)h
+(SinkFile)g(and)g(SourceFile)e(attributes,)i(in)227 4480
y(whic)n(h)i(case)f(no)g(sink)g(or)g(source)f(function)j(need)e(b)r(e)h
-(supplied.)0 954 y Fd(Synopsis:)121 b Ft(AstChannel)39
+(supplied.)0 4619 y Fd(Synopsis:)121 b Ft(AstChannel)39
b Fh(\003)p Ft(astChannel\()g(const)i(char)h Fh(\003)p
Ft(\()p Fh(\003)g Ft(source\)\()f(void)h(\),)g(void)g(\()p
-Fh(\003)h Ft(sink\)\()e(const)227 1053 y(char)h Fh(\003)h
+Fh(\003)h Ft(sink\)\()e(const)227 4719 y(char)h Fh(\003)h
Ft(\),)g(const)f(char)g Fh(\003)p Ft(options,)d(...)86
-b(\))0 1257 y Fd(P)m(arameters:)259 1448 y(source)427
-1548 y Fi(P)n(oin)n(ter)17 b(to)h(a)g(source)g(function)h(that)g(tak)n
+b(\))0 4858 y Fd(P)m(arameters:)259 4984 y(source)427
+5084 y Fi(P)n(oin)n(ter)17 b(to)h(a)g(source)g(function)h(that)g(tak)n
(es)e(no)h(argumen)n(ts)f(and)i(returns)e(a)h(p)r(oin)n(ter)h(to)f(a)g
-(n)n(ull-terminated)427 1647 y(string.)36 b(If)26 b(no)g(v)-5
+(n)n(ull-terminated)427 5183 y(string.)36 b(If)26 b(no)g(v)-5
b(alue)25 b(has)h(b)r(een)g(set)g(for)f(the)h(SourceFile)g(attribute,)g
(this)g(function)h(will)f(b)r(e)g(used)g(b)n(y)f(the)427
-1747 y(Channel)30 b(to)f(obtain)g(lines)g(of)g(input)i(text.)42
+5283 y(Channel)30 b(to)f(obtain)g(lines)g(of)g(input)i(text.)42
b(On)29 b(eac)n(h)g(in)n(v)n(o)r(cation,)f(it)i(should)f(return)g(a)g
-(p)r(oin)n(ter)g(to)g(the)427 1847 y(next)h(input)h(line)e(read)g(from)
+(p)r(oin)n(ter)g(to)g(the)427 5383 y(next)h(input)h(line)e(read)g(from)
h(some)f(external)f(data)i(store,)f(and)g(a)h(NULL)g(p)r(oin)n(ter)f
-(when)h(there)f(are)g(no)427 1946 y(more)e(lines)h(to)f(read.)427
-2076 y(If)g Ft(")p Fi(source)p Ft(")d Fi(is)i(NULL)g(and)g(no)g(v)-5
+(when)h(there)f(are)g(no)427 5482 y(more)e(lines)h(to)f(read.)427
+5593 y(If)g Ft(")p Fi(source)p Ft(")d Fi(is)i(NULL)g(and)g(no)g(v)-5
b(alue)25 b(has)h(b)r(een)g(set)g(for)g(the)g(SourceFile)g(attribute,)g
-(the)g(Channel)g(will)427 2176 y(read)h(from)g(standard)g(input)h
-(instead.)259 2336 y Fd(sink)427 2435 y Fi(P)n(oin)n(ter)k(to)h(a)g
-(sink)h(function)g(that)f(tak)n(es)g(a)g(p)r(oin)n(ter)g(to)g(a)g(n)n
-(ull-terminated)g(string)g(as)g(an)g(argumen)n(t)427
-2535 y(and)h(returns)e(v)n(oid.)54 b(If)34 b(no)g(v)-5
-b(alue)33 b(has)g(b)r(een)h(set)f(for)g(the)h(SinkFile)g(attribute,)i
-(this)d(function)h(will)g(b)r(e)427 2635 y(used)26 b(b)n(y)f(the)h
-(Channel)f(to)g(deliv)n(er)g(lines)g(of)h(output)g(text.)36
-b(On)25 b(eac)n(h)g(in)n(v)n(o)r(cation,)g(it)g(should)h(deliv)n(er)e
-(the)427 2734 y(con)n(ten)n(ts)j(of)h(the)g(string)f(supplied)h(to)f
-(some)g(external)g(data)g(store.)427 2864 y(If)35 b Ft(")p
-Fi(sink)p Ft(")f Fi(is)g(NULL,)h(and)g(no)f(v)-5 b(alue)35
-b(has)f(b)r(een)h(set)f(for)g(the)h(SinkFile)g(attribute,)i(the)e
-(Channel)f(will)427 2964 y(write)28 b(to)f(standard)g(output)h
-(instead.)259 3124 y Fd(options)427 3223 y Fi(P)n(oin)n(ter)f(to)h(a)g
+(the)g(Channel)g(will)427 5693 y(read)h(from)g(standard)g(input)h
+(instead.)p eop end
+%%Page: 202 212
+TeXDict begin 202 211 bop 0 52 a FF(202)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(sink)427
+451 y Fi(P)n(oin)n(ter)i(to)h(a)g(sink)h(function)g(that)f(tak)n(es)g
+(a)g(p)r(oin)n(ter)g(to)g(a)g(n)n(ull-terminated)g(string)g(as)g(an)g
+(argumen)n(t)427 551 y(and)h(returns)e(v)n(oid.)54 b(If)34
+b(no)g(v)-5 b(alue)33 b(has)g(b)r(een)h(set)f(for)g(the)h(SinkFile)g
+(attribute,)i(this)d(function)h(will)g(b)r(e)427 650
+y(used)26 b(b)n(y)f(the)h(Channel)f(to)g(deliv)n(er)g(lines)g(of)h
+(output)g(text.)36 b(On)25 b(eac)n(h)g(in)n(v)n(o)r(cation,)g(it)g
+(should)h(deliv)n(er)e(the)427 750 y(con)n(ten)n(ts)j(of)h(the)g
+(string)f(supplied)h(to)f(some)g(external)g(data)g(store.)427
+859 y(If)35 b Ft(")p Fi(sink)p Ft(")f Fi(is)g(NULL,)h(and)g(no)f(v)-5
+b(alue)35 b(has)f(b)r(een)h(set)f(for)g(the)h(SinkFile)g(attribute,)i
+(the)e(Channel)f(will)427 958 y(write)28 b(to)f(standard)g(output)h
+(instead.)259 1076 y Fd(options)427 1176 y Fi(P)n(oin)n(ter)f(to)h(a)g
(n)n(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 3323 y(assignmen)n(ts)d
+(comma-separated)e(list)i(of)g(attribute)427 1275 y(assignmen)n(ts)d
(to)i(b)r(e)g(used)f(for)g(initialising)g(the)h(new)g(Channel.)36
b(The)26 b(syn)n(tax)g(used)g(is)h(iden)n(tical)f(to)g(that)427
-3423 y(for)g(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
+1375 y(for)g(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n
(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-3522 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 3682
-y Fd(...)427 3782 y Fi(If)38 b(the)g Ft(")p Fi(options)p
+1474 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 1592
+y Fd(...)427 1692 y Fi(If)38 b(the)g Ft(")p Fi(options)p
Ft(")e Fi(string)h(con)n(tains)f Ft(")p Fi(\045)p Ft(")h
Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g(list)h(of)f
-(additional)427 3882 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
+(additional)427 1792 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
(order)e(to)h(supply)h(v)-5 b(alues)27 b(to)g(b)r(e)h(substituted)h
-(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 3981 y(rules)25
+(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 1891 y(rules)25
b(for)f(supplying)h(these)g(are)f(iden)n(tical)h(to)g(those)g(for)f
(the)h(astSet)g(function)h(\(and)f(for)g(the)g(C)g Ft(")p
-Fi(prin)n(tf)p Ft(")427 4081 y Fi(function\).)0 4297
-y Fd(Returned)32 b(V)-8 b(alue:)259 4488 y(astChannel\(\))427
-4588 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Channel.)0
-4804 y Fd(Notes:)340 5141 y Fh(\017)45 b Fi(Application)35
+Fi(prin)n(tf)p Ft(")427 1991 y Fi(function\).)0 2138
+y Fd(Returned)32 b(V)-8 b(alue:)259 2259 y(astChannel\(\))427
+2359 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Channel.)0
+2506 y Fd(Notes:)340 2773 y Fh(\017)45 b Fi(Application)35
b(co)r(de)g(can)g(pass)f(arbitrary)f(data)i(\(suc)n(h)g(as)g(\014le)g
(descriptors,)g(etc\))h(to)f(source)f(and)h(sink)427
-5241 y(functions)27 b(using)e(the)i(astPutChannelData)e(function.)36
+2873 y(functions)27 b(using)e(the)i(astPutChannelData)e(function.)36
b(The)27 b(source)d(or)h(sink)h(function)h(should)e(use)h(the)427
-5340 y(astChannelData)h(macro)f(to)i(retriev)n(e)e(this)i(data.)340
-5500 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
+2972 y(astChannelData)h(macro)f(to)i(retriev)n(e)e(this)i(data.)340
+3090 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g
(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427
-5600 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
-(for)f(an)n(y)g(reason.)p eop end
-%%Page: 202 212
-TeXDict begin 202 211 bop 0 52 a FF(202)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 483 a Fz(astChannelData)1388 482 y Fe(Return)39 b(a)f(p)s(oin)m(ter)f
-(to)1112 596 y(user-supplied)h(data)f(stored)h(with)1630
-711 y(a)g(Channel)2837 483 y Fz(astChannelData)0 881
-y Fd(Description:)44 b Fi(This)31 b(macro)f(is)g(in)n(tended)h(to)g(b)r
+3190 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
+(for)f(an)n(y)g(reason.)p 0 3359 3780 12 v 0 3491 a Fz(astChannelData)
+1388 3489 y Fe(Return)39 b(a)f(p)s(oin)m(ter)f(to)1112
+3604 y(user-supplied)h(data)f(stored)h(with)1630 3719
+y(a)g(Channel)2837 3491 y Fz(astChannelData)0 3854 y
+Fd(Description:)44 b Fi(This)31 b(macro)f(is)g(in)n(tended)h(to)g(b)r
(e)g(used)g(within)g(the)g(source)f(or)g(sink)g(functions)h(asso)r
-(ciated)f(with)h(a)227 980 y(Channel.)49 b(It)32 b(returns)f(an)n(y)g
+(ciated)f(with)h(a)227 3954 y(Channel.)49 b(It)32 b(returns)f(an)n(y)g
(p)r(oin)n(ter)g(previously)f(stored)h(in)h(the)g(Channel)f(\(that)h
-(is,)h(the)f(Channel)f(that)h(has)227 1080 y(in)n(v)n(ok)n(ed)26
+(is,)h(the)f(Channel)f(that)h(has)227 4053 y(in)n(v)n(ok)n(ed)26
b(the)i(source)f(or)f(sink)i(function\))g(using)g(astPutChannelData.)
-227 1207 y(This)j(mec)n(hanism)f(is)g(a)g(thread-safe)f(alternativ)n(e)
+227 4171 y(This)j(mec)n(hanism)f(is)g(a)g(thread-safe)f(alternativ)n(e)
g(to)i(passing)e(\014le)i(descriptors,)f(etc,)h(via)f(static)g(global)g
-(v)-5 b(ari-)227 1306 y(ables.)0 1460 y Fd(Synopsis:)121
-b Ft(void)42 b Fh(\003)p Ft(astChannelData)0 1614 y Fd(Class)31
-b(Applicabilit)m(y:)259 1754 y(Channel)427 1854 y Fi(This)d(macro)e
-(applies)h(to)h(all)f(Channels.)0 2020 y Fd(Returned)32
-b(V)-8 b(alue:)259 2161 y(astChannelData)427 2261 y Fi(The)27
+(v)-5 b(ari-)227 4270 y(ables.)0 4405 y Fd(Synopsis:)121
+b Ft(void)42 b Fh(\003)p Ft(astChannelData)0 4539 y Fd(Class)31
+b(Applicabilit)m(y:)259 4660 y(Channel)427 4760 y Fi(This)d(macro)e
+(applies)h(to)h(all)f(Channels.)0 4907 y Fd(Returned)32
+b(V)-8 b(alue:)259 5028 y(astChannelData)427 5128 y Fi(The)27
b(p)r(oin)n(ter)f(previously)f(stored)g(with)i(the)g(Channel)f(using)g
(astPutChannelData.)36 b(A)26 b(NULL)h(p)r(oin)n(ter)427
-2360 y(will)h(b)r(e)g(returned)f(if)h(no)g(suc)n(h)f(p)r(oin)n(ter)g
-(has)g(b)r(een)h(stored)f(with)h(the)g(Channel.)0 2526
-y Fd(Notes:)340 2813 y Fh(\017)45 b Fi(This)28 b(routine)f(is)h(not)f
+5228 y(will)h(b)r(e)g(returned)f(if)h(no)g(suc)n(h)f(p)r(oin)n(ter)g
+(has)g(b)r(een)h(stored)f(with)h(the)g(Channel.)0 5375
+y Fd(Notes:)340 5642 y Fh(\017)45 b Fi(This)28 b(routine)f(is)h(not)f
(a)n(v)-5 b(ailable)26 b(in)i(the)g(F)-7 b(ortran)27
b(77)f(in)n(terface)h(to)h(the)g(AST)g(library)-7 b(.)p
-0 3017 V 0 3148 a Fz(astCircle)986 b Fe(Create)37 b(a)i(Circle)982
-b Fz(astCircle)0 3318 y Fd(Description:)44 b Fi(This)28
+eop end
+%%Page: 203 213
+TeXDict begin 203 212 bop 3643 52 a FF(203)p 0 351 3780
+12 v 0 483 a Fz(astCircle)986 b Fe(Create)37 b(a)i(Circle)982
+b Fz(astCircle)0 643 y Fd(Description:)44 b Fi(This)28
b(function)g(creates)f(a)g(new)g(Circle)g(and)h(optionally)f
-(initialises)g(its)h(attributes.)227 3445 y(A)g(Circle)f(is)h(a)f
+(initialises)g(its)h(attributes.)227 767 y(A)g(Circle)f(is)h(a)f
(Region)g(whic)n(h)g(represen)n(ts)g(a)g(circle)g(or)f(sphere)h(within)
-i(the)f(supplied)g(F)-7 b(rame.)0 3599 y Fd(Synopsis:)121
+i(the)f(supplied)g(F)-7 b(rame.)0 914 y Fd(Synopsis:)121
b Ft(AstCircle)40 b Fh(\003)p Ft(astCircle\()f(AstFrame)h
Fh(\003)p Ft(frame,)h(int)h(form,)f(const)h(double)f(centre[],)f(const)
-227 3698 y(double)h(point[],)g(AstRegion)f Fh(\003)p
+227 1013 y(double)h(point[],)g(AstRegion)f Fh(\003)p
Ft(unc,)h(const)g(char)h Fh(\003)p Ft(options,)e(...)86
-b(\))0 3852 y Fd(P)m(arameters:)259 3993 y(frame)427
-4093 y Fi(A)29 b(p)r(oin)n(ter)g(to)f(the)i(F)-7 b(rame)28
+b(\))0 1160 y Fd(P)m(arameters:)259 1294 y(frame)427
+1394 y Fi(A)29 b(p)r(oin)n(ter)g(to)f(the)i(F)-7 b(rame)28
b(in)h(whic)n(h)g(the)g(region)e(is)i(de\014ned.)41 b(A)29
b(deep)g(cop)n(y)f(is)g(tak)n(en)g(of)h(the)g(supplied)427
-4192 y(F)-7 b(rame.)71 b(This)39 b(means)f(that)h(an)n(y)g(subsequen)n
+1493 y(F)-7 b(rame.)71 b(This)39 b(means)f(that)h(an)n(y)g(subsequen)n
(t)f(c)n(hanges)g(made)h(to)f(the)i(F)-7 b(rame)38 b(using)h(the)g
-(supplied)427 4292 y(p)r(oin)n(ter)27 b(will)h(ha)n(v)n(e)f(no)g
-(e\013ect)h(the)g(Region.)259 4427 y Fd(form)427 4526
+(supplied)427 1593 y(p)r(oin)n(ter)27 b(will)h(ha)n(v)n(e)f(no)g
+(e\013ect)h(the)g(Region.)259 1723 y Fd(form)427 1823
y Fi(Indicates)g(ho)n(w)g(the)h(circle)f(is)g(describ)r(ed)h(b)n(y)f
(the)h(remaining)e(parameters.)38 b(A)29 b(v)-5 b(alue)28
-b(of)g(zero)g(indicates)427 4626 y(that)h(the)f(circle)f(is)h(sp)r
+b(of)g(zero)g(indicates)427 1922 y(that)h(the)f(circle)f(is)h(sp)r
(eci\014ed)h(b)n(y)e(a)h(cen)n(tre)f(p)r(osition)h(and)g(a)g(p)r
(osition)g(on)f(the)i(circumference.)37 b(A)29 b(v)-5
-b(alue)427 4726 y(of)28 b(one)f(indicates)g(that)h(the)g(circle)f(is)h
+b(alue)427 2022 y(of)28 b(one)f(indicates)g(that)h(the)g(circle)f(is)h
(sp)r(eci\014ed)g(b)n(y)f(a)g(cen)n(tre)g(p)r(osition)h(and)f(a)g
-(scalar)f(radius.)259 4861 y Fd(cen)m(tre)427 4960 y
+(scalar)f(radius.)259 2152 y Fd(cen)m(tre)427 2252 y
Fi(An)32 b(arra)n(y)c(of)j(double,)h(with)g(one)e(elemen)n(t)i(for)e
(eac)n(h)g(F)-7 b(rame)31 b(axis)f(\(Naxes)h(attribute\))g(con)n
-(taining)f(the)427 5060 y(co)r(ordinates)c(at)i(the)g(cen)n(tre)f(of)g
-(the)h(circle)f(or)g(sphere.)259 5195 y Fd(p)s(oin)m(t)427
-5295 y Fi(If)35 b Ft(")p Fi(form)p Ft(")e Fi(is)h(zero,)g(then)h(this)f
+(taining)f(the)427 2352 y(co)r(ordinates)c(at)i(the)g(cen)n(tre)f(of)g
+(the)h(circle)f(or)g(sphere.)259 2482 y Fd(p)s(oin)m(t)427
+2582 y Fi(If)35 b Ft(")p Fi(form)p Ft(")e Fi(is)h(zero,)g(then)h(this)f
(arra)n(y)e(should)i(ha)n(v)n(e)f(one)g(elemen)n(t)i(for)e(eac)n(h)h(F)
--7 b(rame)33 b(axis)g(\(Naxes)h(at-)427 5394 y(tribute\),)e(and)e
+-7 b(rame)33 b(axis)g(\(Naxes)h(at-)427 2681 y(tribute\),)e(and)e
(should)g(b)r(e)h(supplied)f(holding)g(the)h(co)r(ordinates)e(at)h(a)g
-(p)r(oin)n(t)g(on)g(the)h(circumference)f(of)427 5494
+(p)r(oin)n(t)g(on)g(the)h(circumference)f(of)427 2781
y(the)k(circle)e(or)g(sphere.)53 b(If)34 b Ft(")p Fi(form)p
Ft(")e Fi(is)h(one,)h(then)f(this)h(arra)n(y)c(should)j(ha)n(v)n(e)f
-(one)h(elemen)n(t)g(only)g(whic)n(h)427 5593 y(should)h(b)r(e)g
+(one)h(elemen)n(t)g(only)g(whic)n(h)427 2880 y(should)h(b)r(e)g
(supplied)g(holding)f(the)h(scalar)e(radius)h(of)h(the)g(circle)f(or)g
-(sphere,)i(as)e(a)g(geo)r(desic)g(distance)427 5693 y(within)c(the)f(F)
--7 b(rame.)p eop end
-%%Page: 203 213
-TeXDict begin 203 212 bop 3643 52 a FF(203)259 351 y
-Fd(unc)427 451 y Fi(An)33 b(optional)e(p)r(oin)n(ter)h(to)g(an)g
-(existing)g(Region)f(whic)n(h)h(sp)r(eci\014es)g(the)h(uncertain)n
-(ties)e(asso)r(ciated)g(with)427 551 y(the)f(b)r(oundary)f(of)g(the)h
-(Circle)f(b)r(eing)g(created.)41 b(The)30 b(uncertain)n(t)n(y)e(in)i
-(an)n(y)f(p)r(oin)n(t)g(on)g(the)h(b)r(oundary)f(of)427
-650 y(the)g(Circle)e(is)h(found)g(b)n(y)f(shifting)i(the)f(supplied)g
-Ft(")p Fi(uncertain)n(t)n(y)p Ft(")e Fi(Region)i(so)f(that)h(it)g(is)g
-(cen)n(tred)f(at)h(the)427 750 y(b)r(oundary)i(p)r(oin)n(t)h(b)r(eing)g
-(considered.)44 b(The)31 b(area)e(co)n(v)n(ered)g(b)n(y)h(the)h
-(shifted)g(uncertain)n(t)n(y)f(Region)g(then)427 849
-y(represen)n(ts)g(the)i(uncertain)n(t)n(y)f(in)g(the)h(b)r(oundary)f(p)
-r(osition.)48 b(The)31 b(uncertain)n(t)n(y)g(is)g(assumed)g(to)g(b)r(e)
-h(the)427 949 y(same)27 b(for)g(all)h(p)r(oin)n(ts.)427
-1066 y(If)38 b(supplied,)j(the)d(uncertain)n(t)n(y)f(Region)g(m)n(ust)g
-(b)r(e)i(of)e(a)g(class)g(for)g(whic)n(h)h(all)f(instances)g(are)g(cen)
-n(tro-)427 1166 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24
-b(Circle,)g(Ellipse,)h(etc.\))36 b(or)23 b(b)r(e)i(a)e(Prism)h(con)n
-(taining)f(cen)n(tro-symetric)f(comp)r(onen)n(t)427 1265
-y(Regions.)57 b(A)35 b(deep)f(cop)n(y)g(of)g(the)h(supplied)g(Region)f
-(will)g(b)r(e)h(tak)n(en,)h(so)e(subsequen)n(t)g(c)n(hanges)f(to)h(the)
-427 1365 y(uncertain)n(t)n(y)c(Region)f(using)h(the)h(supplied)f(p)r
-(oin)n(ter)g(will)h(ha)n(v)n(e)e(no)h(e\013ect)g(on)g(the)h(created)e
-(Circle.)45 b(Al-)427 1464 y(ternativ)n(ely)-7 b(,)30
+(sphere,)i(as)e(a)g(geo)r(desic)g(distance)427 2980 y(within)c(the)f(F)
+-7 b(rame.)259 3110 y Fd(unc)427 3210 y Fi(An)33 b(optional)e(p)r(oin)n
+(ter)h(to)g(an)g(existing)g(Region)f(whic)n(h)h(sp)r(eci\014es)g(the)h
+(uncertain)n(ties)e(asso)r(ciated)g(with)427 3310 y(the)f(b)r(oundary)f
+(of)g(the)h(Circle)f(b)r(eing)g(created.)41 b(The)30
+b(uncertain)n(t)n(y)e(in)i(an)n(y)f(p)r(oin)n(t)g(on)g(the)h(b)r
+(oundary)f(of)427 3409 y(the)g(Circle)e(is)h(found)g(b)n(y)f(shifting)i
+(the)f(supplied)g Ft(")p Fi(uncertain)n(t)n(y)p Ft(")e
+Fi(Region)i(so)f(that)h(it)g(is)g(cen)n(tred)f(at)h(the)427
+3509 y(b)r(oundary)i(p)r(oin)n(t)h(b)r(eing)g(considered.)44
+b(The)31 b(area)e(co)n(v)n(ered)g(b)n(y)h(the)h(shifted)g(uncertain)n
+(t)n(y)f(Region)g(then)427 3608 y(represen)n(ts)g(the)i(uncertain)n(t)n
+(y)f(in)g(the)h(b)r(oundary)f(p)r(osition.)48 b(The)31
+b(uncertain)n(t)n(y)g(is)g(assumed)g(to)g(b)r(e)h(the)427
+3708 y(same)27 b(for)g(all)h(p)r(oin)n(ts.)427 3823 y(If)38
+b(supplied,)j(the)d(uncertain)n(t)n(y)f(Region)g(m)n(ust)g(b)r(e)i(of)e
+(a)g(class)g(for)g(whic)n(h)h(all)f(instances)g(are)g(cen)n(tro-)427
+3923 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24 b(Circle,)g(Ellipse,)h
+(etc.\))36 b(or)23 b(b)r(e)i(a)e(Prism)h(con)n(taining)f(cen)n
+(tro-symetric)f(comp)r(onen)n(t)427 4022 y(Regions.)57
+b(A)35 b(deep)f(cop)n(y)g(of)g(the)h(supplied)g(Region)f(will)g(b)r(e)h
+(tak)n(en,)h(so)e(subsequen)n(t)g(c)n(hanges)f(to)h(the)427
+4122 y(uncertain)n(t)n(y)c(Region)f(using)h(the)h(supplied)f(p)r(oin)n
+(ter)g(will)h(ha)n(v)n(e)e(no)h(e\013ect)g(on)g(the)h(created)e
+(Circle.)45 b(Al-)427 4222 y(ternativ)n(ely)-7 b(,)30
b(a)g(NULL)g(Ob)5 b(ject)30 b(p)r(oin)n(ter)f(ma)n(y)g(b)r(e)i
(supplied,)g(in)f(whic)n(h)g(case)f(a)g(default)i(uncertain)n(t)n(y)e
-(is)427 1564 y(used)f(equiv)-5 b(alen)n(t)27 b(to)h(a)f(b)r(o)n(x)g
+(is)427 4321 y(used)f(equiv)-5 b(alen)n(t)27 b(to)h(a)f(b)r(o)n(x)g
(1.0E-6)e(of)j(the)g(size)f(of)h(the)g(Circle)f(b)r(eing)h(created.)427
-1681 y(The)23 b(uncertain)n(t)n(y)f(Region)g(has)g(t)n(w)n(o)g(uses:)34
+4436 y(The)23 b(uncertain)n(t)n(y)f(Region)g(has)g(t)n(w)n(o)g(uses:)34
b(1\))22 b(when)h(the)g(astOv)n(erlap)d(function)k(compares)d(t)n(w)n
-(o)h(Regions)427 1781 y(for)g(equalit)n(y)h(the)g(uncertain)n(t)n(y)f
+(o)h(Regions)427 4536 y(for)g(equalit)n(y)h(the)g(uncertain)n(t)n(y)f
(Region)g(is)g(used)h(to)g(determine)f(the)i(tolerance)d(on)i(the)g
-(comparison,)f(and)427 1880 y(2\))31 b(when)f(a)h(Region)e(is)i(mapp)r
+(comparison,)f(and)427 4635 y(2\))31 b(when)f(a)h(Region)e(is)i(mapp)r
(ed)g(in)n(to)f(a)g(di\013eren)n(t)h(co)r(ordinate)e(system)i(and)f
-(subsequen)n(tly)g(simpli\014ed)427 1980 y(\(using)c(astSimplify\),)h
+(subsequen)n(tly)g(simpli\014ed)427 4735 y(\(using)c(astSimplify\),)h
(the)f(uncertain)n(ties)f(are)g(used)h(to)g(determine)g(if)g(the)g
-(transformed)f(b)r(oundary)g(can)427 2080 y(b)r(e)j(accurately)e
+(transformed)f(b)r(oundary)g(can)427 4835 y(b)r(e)j(accurately)e
(represen)n(ted)h(b)n(y)g(a)g(sp)r(eci\014c)h(shap)r(e)f(of)h(Region.)
-259 2214 y Fd(options)427 2314 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n
+259 4965 y Fd(options)427 5065 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n
(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 2413 y(assignmen)n(ts)j
+(comma-separated)e(list)i(of)g(attribute)427 5164 y(assignmen)n(ts)j
(to)g(b)r(e)i(used)e(for)h(initialising)f(the)h(new)g(Circle.)49
b(The)32 b(syn)n(tax)f(used)g(is)h(iden)n(tical)g(to)f(that)427
-2513 y(for)26 b(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
+5264 y(for)26 b(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n
(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-2612 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 2747
-y Fd(...)427 2846 y Fi(If)38 b(the)g Ft(")p Fi(options)p
+5363 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 5494
+y Fd(...)427 5593 y Fi(If)38 b(the)g Ft(")p Fi(options)p
Ft(")e Fi(string)h(con)n(tains)f Ft(")p Fi(\045)p Ft(")h
Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g(list)h(of)f
-(additional)427 2946 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
+(additional)427 5693 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
(order)e(to)h(supply)h(v)-5 b(alues)27 b(to)g(b)r(e)h(substituted)h
-(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 3046 y(rules)25
+(for)e(these)g(sp)r(eci\014ers.)37 b(The)p eop end
+%%Page: 204 214
+TeXDict begin 204 213 bop 0 52 a FF(204)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)427 351 y Fi(rules)25
b(for)f(supplying)h(these)g(are)f(iden)n(tical)h(to)g(those)g(for)f
(the)h(astSet)g(function)h(\(and)f(for)g(the)g(C)g Ft(")p
-Fi(prin)n(tf)p Ft(")427 3145 y Fi(function\).)0 3310
-y Fd(Returned)32 b(V)-8 b(alue:)259 3449 y(astCircle\(\))427
-3549 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Circle.)0
-3714 y Fd(Notes:)340 3999 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+Fi(prin)n(tf)p Ft(")427 451 y Fi(function\).)0 616 y
+Fd(Returned)32 b(V)-8 b(alue:)259 755 y(astCircle\(\))427
+855 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Circle.)0
+1020 y Fd(Notes:)340 1306 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 4099 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 4301 3780 12 v 0 4433
+427 1405 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 1608 3780 12 v 0 1739
a Fz(astCircleP)l(ars)172 b Fe(Returns)39 b(the)f(geometric)f
-(parameters)f(of)1659 4547 y(an)i(Circle)2999 4433 y
-Fz(astCircleP)l(ars)0 4716 y Fd(Description:)44 b Fi(This)28
+(parameters)f(of)1659 1854 y(an)i(Circle)2999 1739 y
+Fz(astCircleP)l(ars)0 2023 y Fd(Description:)44 b Fi(This)28
b(function)g(returns)f(the)h(geometric)e(parameters)g(describing)h(the)
-h(supplied)g(Circle.)0 4868 y Fd(Synopsis:)121 b Ft(void)42
+h(supplied)g(Circle.)0 2175 y Fd(Synopsis:)121 b Ft(void)42
b(astCirclePars\()c(AstCircle)h Fh(\003)p Ft(this,)i(double)h
Fh(\003)p Ft(centre,)e(double)h Fh(\003)p Ft(radius,)f(double)h
-Fh(\003)p Ft(p1)227 4968 y(\))0 5120 y Fd(P)m(arameters:)259
-5260 y(this)427 5359 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Region.)259
-5494 y Fd(cen)m(tre)427 5593 y Fi(P)n(oin)n(ter)23 b(to)h(an)f(arra)n
+Fh(\003)p Ft(p1)227 2275 y(\))0 2427 y Fd(P)m(arameters:)259
+2567 y(this)427 2666 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Region.)259
+2801 y Fd(cen)m(tre)427 2900 y Fi(P)n(oin)n(ter)23 b(to)h(an)f(arra)n
(y)f(in)i(whic)n(h)g(to)g(return)g(the)g(co)r(ordinates)f(of)h(the)g
(Circle)g(cen)n(tre.)35 b(The)24 b(length)g(of)g(this)427
-5693 y(arra)n(y)i(should)h(b)r(e)h(no)f(less)g(than)h(the)g(n)n(um)n(b)
-r(er)f(of)h(axes)f(in)g(the)h(asso)r(ciated)f(co)r(ordinate)f(system.)p
-eop end
-%%Page: 204 214
-TeXDict begin 204 213 bop 0 52 a FF(204)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(radius)427
-451 y Fi(Returned)22 b(holding)f(the)h(radius)f(of)g(the)h(Circle,)g
-(as)f(an)g(geo)r(desic)g(distance)g(in)h(the)g(asso)r(ciated)e(co)r
-(ordinate)427 551 y(system.)259 682 y Fd(p1)427 781 y
-Fi(P)n(oin)n(ter)25 b(to)h(an)g(arra)n(y)e(in)j(whic)n(h)f(to)h(return)
-f(the)g(co)r(ordinates)f(of)i(a)f(p)r(oin)n(t)g(on)g(the)h
-(circumference)f(of)g(the)427 881 y(Circle.)39 b(The)28
-b(length)g(of)h(this)f(arra)n(y)e(should)i(b)r(e)h(no)f(less)g(than)g
-(the)h(n)n(um)n(b)r(er)f(of)g(axes)g(in)g(the)h(asso)r(ciated)427
-980 y(co)r(ordinate)37 b(system.)66 b(A)38 b(NULL)f(p)r(oin)n(ter)h
-(can)f(b)r(e)g(supplied)h(if)g(the)g(circumference)f(p)r(osition)g(is)h
-(not)427 1080 y(needed.)0 1240 y Fd(Notes:)340 1521 y
-Fh(\017)45 b Fi(If)24 b(the)g(co)r(ordinate)e(system)h(represen)n(ted)f
-(b)n(y)h(the)g(Circle)g(has)g(b)r(een)g(c)n(hanged)f(since)h(it)h(w)n
-(as)e(\014rst)h(created,)427 1621 y(the)c(returned)f(parameters)f
+3000 y(arra)n(y)i(should)h(b)r(e)h(no)f(less)g(than)h(the)g(n)n(um)n(b)
+r(er)f(of)h(axes)f(in)g(the)h(asso)r(ciated)f(co)r(ordinate)f(system.)
+259 3134 y Fd(radius)427 3234 y Fi(Returned)c(holding)f(the)h(radius)f
+(of)g(the)h(Circle,)g(as)f(an)g(geo)r(desic)g(distance)g(in)h(the)g
+(asso)r(ciated)e(co)r(ordinate)427 3334 y(system.)259
+3468 y Fd(p1)427 3568 y Fi(P)n(oin)n(ter)25 b(to)h(an)g(arra)n(y)e(in)j
+(whic)n(h)f(to)h(return)f(the)g(co)r(ordinates)f(of)i(a)f(p)r(oin)n(t)g
+(on)g(the)h(circumference)f(of)g(the)427 3667 y(Circle.)39
+b(The)28 b(length)g(of)h(this)f(arra)n(y)e(should)i(b)r(e)h(no)f(less)g
+(than)g(the)h(n)n(um)n(b)r(er)f(of)g(axes)g(in)g(the)h(asso)r(ciated)
+427 3767 y(co)r(ordinate)37 b(system.)66 b(A)38 b(NULL)f(p)r(oin)n(ter)
+h(can)f(b)r(e)g(supplied)h(if)g(the)g(circumference)f(p)r(osition)g(is)
+h(not)427 3867 y(needed.)0 4032 y Fd(Notes:)340 4317
+y Fh(\017)45 b Fi(If)24 b(the)g(co)r(ordinate)e(system)h(represen)n
+(ted)f(b)n(y)h(the)g(Circle)g(has)g(b)r(een)g(c)n(hanged)f(since)h(it)h
+(w)n(as)e(\014rst)h(created,)427 4417 y(the)c(returned)f(parameters)f
(refer)h(to)h(the)g(new)f(\(c)n(hanged\))g(co)r(ordinate)g(system,)i
-(rather)d(than)i(the)g(original)427 1720 y(co)r(ordinate)27
+(rather)d(than)i(the)g(original)427 4516 y(co)r(ordinate)27
b(system.)37 b(Note)28 b(ho)n(w)n(ev)n(er)e(that)i(if)g(the)g
(transformation)f(from)g(original)f(to)i(new)g(co)r(ordinate)427
-1820 y(system)38 b(is)h(non-linear,)h(the)f(shap)r(e)f(represen)n(ted)f
+4616 y(system)38 b(is)h(non-linear,)h(the)f(shap)r(e)f(represen)n(ted)f
(b)n(y)h(the)h(supplied)g(Circle)f(ob)5 b(ject)38 b(ma)n(y)g(not)g(b)r
-(e)h(an)427 1919 y(accurate)27 b(circle.)p 0 2115 3780
-12 v 0 2247 a Fz(astClear)483 b Fe(Clear)37 b(attribute)f(v)-7
+(e)h(an)427 4716 y(accurate)27 b(circle.)p 0 4918 V 0
+5050 a Fz(astClear)483 b Fe(Clear)37 b(attribute)f(v)-7
b(alues)39 b(for)e(an)i(Ob)7 b(ject)480 b Fz(astClear)0
-2432 y Fd(Description:)44 b Fi(This)36 b(function)g(clears)f(the)h(v)-5
+5242 y Fd(Description:)44 b Fi(This)36 b(function)g(clears)f(the)h(v)-5
b(alues)36 b(of)f(a)h(sp)r(eci\014ed)g(set)f(of)h(attributes)g(for)f
-(an)h(Ob)5 b(ject.)61 b(Clearing)227 2532 y(an)30 b(attribute)h
+(an)h(Ob)5 b(ject.)61 b(Clearing)227 5341 y(an)30 b(attribute)h
(cancels)f(an)n(y)f(v)-5 b(alue)30 b(that)h(has)f(previously)f(b)r(een)
i(explicitly)g(set)f(for)g(it,)h(so)f(that)h(the)g(standard)227
-2631 y(default)d(attribute)f(v)-5 b(alue)28 b(will)f(subsequen)n(tly)g
+5441 y(default)d(attribute)f(v)-5 b(alue)28 b(will)f(subsequen)n(tly)g
(b)r(e)h(used)f(instead.)37 b(This)27 b(also)f(causes)g(the)i(astT)-7
-b(est)27 b(function)h(to)227 2731 y(return)f(the)h(v)-5
+b(est)27 b(function)h(to)227 5540 y(return)f(the)h(v)-5
b(alue)28 b(zero)e(for)h(the)h(attribute,)g(indicating)g(that)g(no)f(v)
--5 b(alue)27 b(has)g(b)r(een)h(set.)0 2879 y Fd(Synopsis:)121
+-5 b(alue)27 b(has)g(b)r(een)h(set.)0 5693 y Fd(Synopsis:)121
b Ft(void)42 b(astClear\()e(AstObject)g Fh(\003)p Ft(this,)h(const)g
-(char)h Fh(\003)p Ft(attrib)f(\))0 3026 y Fd(P)m(arameters:)259
-3161 y(this)427 3260 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5
-b(ject.)259 3392 y Fd(attrib)427 3491 y Fi(P)n(oin)n(ter)23
+(char)h Fh(\003)p Ft(attrib)f(\))p eop end
+%%Page: 205 215
+TeXDict begin 205 214 bop 3643 52 a FF(205)0 351 y Fd(P)m(arameters:)
+259 483 y(this)427 583 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5
+b(ject.)259 711 y Fd(attrib)427 810 y Fi(P)n(oin)n(ter)23
b(to)i(a)g(n)n(ull-terminated)f(c)n(haracter)f(string)h(con)n(taining)g
-(a)g(comma-separated)f(list)i(of)g(the)g(names)427 3591
-y(of)j(the)g(attributes)f(to)h(b)r(e)g(cleared.)0 3751
-y Fd(Class)j(Applicabilit)m(y:)259 3886 y(Ob)5 b(ject)427
-3985 y Fi(This)28 b(function)g(applies)f(to)h(all)f(Ob)5
-b(jects.)0 4145 y Fd(Notes:)340 4426 y Fh(\017)45 b Fi(A)n(ttribute)28
+(a)g(comma-separated)f(list)i(of)g(the)g(names)427 910
+y(of)j(the)g(attributes)f(to)h(b)r(e)g(cleared.)0 1067
+y Fd(Class)j(Applicabilit)m(y:)259 1199 y(Ob)5 b(ject)427
+1298 y Fi(This)28 b(function)g(applies)f(to)h(all)f(Ob)5
+b(jects.)0 1456 y Fd(Notes:)340 1733 y Fh(\017)45 b Fi(A)n(ttribute)28
b(names)g(are)e(not)i(case)f(sensitiv)n(e)g(and)g(ma)n(y)g(b)r(e)h
-(surrounded)e(b)n(y)i(white)g(space.)340 4557 y Fh(\017)45
+(surrounded)e(b)n(y)i(white)g(space.)340 1862 y Fh(\017)45
b Fi(It)28 b(do)r(es)f(no)h(harm)f(to)g(clear)g(an)g(attribute)h(whose)
-f(v)-5 b(alue)27 b(has)g(not)h(b)r(een)g(set.)340 4688
+f(v)-5 b(alue)27 b(has)g(not)h(b)r(een)g(set.)340 1990
y Fh(\017)45 b Fi(An)28 b(error)e(will)i(result)f(if)h(an)g(attempt)g
(is)f(made)h(to)f(clear)g(the)h(v)-5 b(alue)27 b(of)h(a)f(read-only)f
-(attribute.)p 0 4884 V 0 5015 a Fz(astClearStatus)341
+(attribute.)p 0 2179 3780 12 v 0 2311 a Fz(astClearStatus)341
b Fe(Clear)37 b(the)i(AST)f(error)f(status)338 b Fz(astClearStatus)0
-5177 y Fd(Description:)44 b Fi(This)23 b(macro)f(resets)h(the)g(AST)h
+2467 y Fd(Description:)44 b Fi(This)23 b(macro)f(resets)h(the)g(AST)h
(error)d(status)i(to)g(an)g(OK)f(v)-5 b(alue,)24 b(indicating)f(that)h
-(an)f(error)e(condition)227 5277 y(\(if)29 b(an)n(y\))e(has)g(b)r(een)h
-(cleared.)0 5425 y Fd(Synopsis:)121 b Ft(void)42 b(astClearStatus)0
-5572 y Fd(Notes:)p eop end
-%%Page: 205 215
-TeXDict begin 205 214 bop 3643 52 a FF(205)340 351 y
-Fh(\017)45 b Fi(If)37 b(the)f(AST)g(error)e(status)i(is)g(set)g(to)g
-(an)f(error)f(v)-5 b(alue)36 b(\(after)g(an)g(error\),)g(most)g(AST)g
-(functions)g(will)427 451 y(not)28 b(execute)g(and)f(will)h(simply)g
-(return)f(without)i(action.)36 b(Using)28 b(astClearStatus)e(will)i
-(restore)f(normal)427 551 y(b)r(eha)n(viour.)p 0 742
-3780 12 v 0 874 a Fz(astClip)549 b Fe(Set)39 b(up)g(or)f(remo)m(v)m(e)f
-(clipping)g(for)h(a)h(Plot)546 b Fz(astClip)0 1055 y
-Fd(Description:)44 b Fi(This)25 b(function)h(de\014nes)f(regions)f(of)h
-(a)f(Plot)h(whic)n(h)g(are)f(to)h(b)r(e)h(clipp)r(ed.)36
-b(An)n(y)25 b(subsequen)n(t)g(graphical)227 1155 y(output)h(created)f
-(using)g(the)g(Plot)g(will)g(then)h(b)r(e)g(visible)f(only)g(within)h
-(the)g(unclipp)r(ed)g(regions)e(of)h(the)h(plotting)227
-1254 y(area.)36 b(See)27 b(also)g(the)h(Clip)g(attribute.)0
-1400 y Fd(Synopsis:)121 b Ft(void)42 b(astClip\()e(AstPlot)h
-Fh(\003)p Ft(this,)g(int)h(iframe,)f(const)g(double)g(lbnd[],)g(const)h
-(double)f(ubnd[])227 1499 y(\))0 1645 y Fd(P)m(arameters:)259
-1778 y(this)427 1877 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259
-2006 y Fd(iframe)427 2106 y Fi(The)h(index)g(of)g(the)h(F)-7
-b(rame)28 b(within)i(the)f(Plot)f(to)h(whic)n(h)g(the)g(clipping)g
-(limits)h(supplied)f(in)g Ft(")p Fi(lbnd)p Ft(")g Fi(and)427
-2206 y Ft(")p Fi(ubnd)p Ft(")h Fi(\(b)r(elo)n(w\))f(refer.)42
-b(Clipping)30 b(ma)n(y)f(b)r(e)h(applied)f(to)g(an)n(y)g(of)h(the)g(co)
-r(ordinate)e(systems)h(asso)r(ciated)427 2305 y(with)24
-b(a)g(Plot)f(\(as)g(de\014ned)h(b)n(y)f(the)h(F)-7 b(rames)23
-b(it)h(con)n(tains\),)g(so)f(this)h(index)f(ma)n(y)g(tak)n(e)g(an)n(y)g
-(v)-5 b(alue)23 b(from)h(1)f(to)427 2405 y(the)31 b(n)n(um)n(b)r(er)e
-(of)h(F)-7 b(rames)30 b(in)g(the)g(Plot)g(\(Nframe)g(attribute\).)45
-b(In)30 b(addition,)g(the)h(v)-5 b(alues)29 b(AST)p Ft(__)p
-Fi(BASE)427 2504 y(and)f(AST)p Ft(__)p Fi(CURRENT)f(ma)n(y)g(b)r(e)h
-(used)g(to)f(sp)r(ecify)h(the)g(base)f(and)g(curren)n(t)g(F)-7
-b(rames)27 b(resp)r(ectiv)n(ely)-7 b(.)427 2619 y(F)g(or)32
-b(example,)i(a)f(v)-5 b(alue)32 b(of)h(AST)p Ft(__)p
-Fi(CURRENT)g(causes)e(clipping)i(to)g(b)r(e)g(p)r(erformed)f(in)i(ph)n
-(ysical)d(co-)427 2718 y(ordinates,)g(while)g(a)g(v)-5
-b(alue)31 b(of)g(AST)p Ft(__)p Fi(BASE)f(w)n(ould)h(clip)g(in)g
+(an)f(error)e(condition)227 2567 y(\(if)29 b(an)n(y\))e(has)g(b)r(een)h
+(cleared.)0 2712 y Fd(Synopsis:)121 b Ft(void)42 b(astClearStatus)0
+2856 y Fd(Notes:)340 3134 y Fh(\017)j Fi(If)37 b(the)f(AST)g(error)e
+(status)i(is)g(set)g(to)g(an)f(error)f(v)-5 b(alue)36
+b(\(after)g(an)g(error\),)g(most)g(AST)g(functions)g(will)427
+3234 y(not)28 b(execute)g(and)f(will)h(simply)g(return)f(without)i
+(action.)36 b(Using)28 b(astClearStatus)e(will)i(restore)f(normal)427
+3333 y(b)r(eha)n(viour.)p 0 3523 V 0 3655 a Fz(astClip)549
+b Fe(Set)39 b(up)g(or)f(remo)m(v)m(e)f(clipping)g(for)h(a)h(Plot)546
+b Fz(astClip)0 3834 y Fd(Description:)44 b Fi(This)25
+b(function)h(de\014nes)f(regions)f(of)h(a)f(Plot)h(whic)n(h)g(are)f(to)
+h(b)r(e)h(clipp)r(ed.)36 b(An)n(y)25 b(subsequen)n(t)g(graphical)227
+3934 y(output)h(created)f(using)g(the)g(Plot)g(will)g(then)h(b)r(e)g
+(visible)f(only)g(within)h(the)g(unclipp)r(ed)g(regions)e(of)h(the)h
+(plotting)227 4034 y(area.)36 b(See)27 b(also)g(the)h(Clip)g
+(attribute.)0 4178 y Fd(Synopsis:)121 b Ft(void)42 b(astClip\()e
+(AstPlot)h Fh(\003)p Ft(this,)g(int)h(iframe,)f(const)g(double)g
+(lbnd[],)g(const)h(double)f(ubnd[])227 4278 y(\))0 4423
+y Fd(P)m(arameters:)259 4554 y(this)427 4654 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(Plot.)259 4782 y Fd(iframe)427 4882 y Fi(The)h(index)g(of)
+g(the)h(F)-7 b(rame)28 b(within)i(the)f(Plot)f(to)h(whic)n(h)g(the)g
+(clipping)g(limits)h(supplied)f(in)g Ft(")p Fi(lbnd)p
+Ft(")g Fi(and)427 4981 y Ft(")p Fi(ubnd)p Ft(")h Fi(\(b)r(elo)n(w\))f
+(refer.)42 b(Clipping)30 b(ma)n(y)f(b)r(e)h(applied)f(to)g(an)n(y)g(of)
+h(the)g(co)r(ordinate)e(systems)h(asso)r(ciated)427 5081
+y(with)24 b(a)g(Plot)f(\(as)g(de\014ned)h(b)n(y)f(the)h(F)-7
+b(rames)23 b(it)h(con)n(tains\),)g(so)f(this)h(index)f(ma)n(y)g(tak)n
+(e)g(an)n(y)g(v)-5 b(alue)23 b(from)h(1)f(to)427 5181
+y(the)31 b(n)n(um)n(b)r(er)e(of)h(F)-7 b(rames)30 b(in)g(the)g(Plot)g
+(\(Nframe)g(attribute\).)45 b(In)30 b(addition,)g(the)h(v)-5
+b(alues)29 b(AST)p Ft(__)p Fi(BASE)427 5280 y(and)f(AST)p
+Ft(__)p Fi(CURRENT)f(ma)n(y)g(b)r(e)h(used)g(to)f(sp)r(ecify)h(the)g
+(base)f(and)g(curren)n(t)g(F)-7 b(rames)27 b(resp)r(ectiv)n(ely)-7
+b(.)427 5394 y(F)g(or)32 b(example,)i(a)f(v)-5 b(alue)32
+b(of)h(AST)p Ft(__)p Fi(CURRENT)g(causes)e(clipping)i(to)g(b)r(e)g(p)r
+(erformed)f(in)i(ph)n(ysical)d(co-)427 5494 y(ordinates,)g(while)g(a)g
+(v)-5 b(alue)31 b(of)g(AST)p Ft(__)p Fi(BASE)f(w)n(ould)h(clip)g(in)g
(graphical)f(co)r(ordinates.)45 b(Clipping)31 b(ma)n(y)427
-2818 y(also)24 b(b)r(e)h(remo)n(v)n(ed)e(completely)h(b)n(y)g(giving)g
+5593 y(also)24 b(b)r(e)h(remo)n(v)n(ed)e(completely)h(b)n(y)g(giving)g
(a)g(v)-5 b(alue)25 b(of)f(AST)p Ft(__)p Fi(NOFRAME.)g(In)h(this)g
-(case)f(an)n(y)g(clipping)427 2918 y(b)r(ounds)k(supplied)g(\(b)r(elo)n
-(w\))g(are)e(ignored.)259 3047 y Fd(lbnd)427 3146 y Fi(An)43
-b(arra)n(y)c(with)j(one)g(elemen)n(t)g(for)f(eac)n(h)g(axis)g(of)h(the)
-g(clipping)g(F)-7 b(rame)41 b(\(iden)n(ti\014ed)i(b)n(y)e(the)i(index)
-427 3246 y Ft(")p Fi(iframe)p Ft(")p Fi(\).)68 b(This)38
-b(should)g(con)n(tain)f(the)i(lo)n(w)n(er)d(b)r(ound,)41
-b(on)d(eac)n(h)f(axis,)j(of)e(the)h(region)e(whic)n(h)h(is)g(to)427
-3345 y(remain)27 b(visible)h(\(unclipp)r(ed\).)259 3474
-y Fd(ubnd)427 3574 y Fi(An)43 b(arra)n(y)c(with)j(one)g(elemen)n(t)g
+(case)f(an)n(y)g(clipping)427 5693 y(b)r(ounds)k(supplied)g(\(b)r(elo)n
+(w\))g(are)e(ignored.)p eop end
+%%Page: 206 216
+TeXDict begin 206 215 bop 0 52 a FF(206)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(lbnd)427
+451 y Fi(An)43 b(arra)n(y)c(with)j(one)g(elemen)n(t)g(for)f(eac)n(h)g
+(axis)g(of)h(the)g(clipping)g(F)-7 b(rame)41 b(\(iden)n(ti\014ed)i(b)n
+(y)e(the)i(index)427 551 y Ft(")p Fi(iframe)p Ft(")p
+Fi(\).)68 b(This)38 b(should)g(con)n(tain)f(the)i(lo)n(w)n(er)d(b)r
+(ound,)41 b(on)d(eac)n(h)f(axis,)j(of)e(the)h(region)e(whic)n(h)h(is)g
+(to)427 650 y(remain)27 b(visible)h(\(unclipp)r(ed\).)259
+781 y Fd(ubnd)427 880 y Fi(An)43 b(arra)n(y)c(with)j(one)g(elemen)n(t)g
(for)f(eac)n(h)g(axis)g(of)h(the)g(clipping)g(F)-7 b(rame)41
-b(\(iden)n(ti\014ed)i(b)n(y)e(the)i(index)427 3674 y
-Ft(")p Fi(iframe)p Ft(")p Fi(\).)64 b(This)37 b(should)g(con)n(tain)f
-(the)h(upp)r(er)g(b)r(ound,)j(on)d(eac)n(h)f(axis,)i(of)f(the)g(region)
-f(whic)n(h)h(is)g(to)427 3773 y(remain)27 b(visible)h(\(unclipp)r
-(ed\).)0 3931 y Fd(Notes:)340 4210 y Fh(\017)45 b Fi(Only)19
+b(\(iden)n(ti\014ed)i(b)n(y)e(the)i(index)427 980 y Ft(")p
+Fi(iframe)p Ft(")p Fi(\).)64 b(This)37 b(should)g(con)n(tain)f(the)h
+(upp)r(er)g(b)r(ound,)j(on)d(eac)n(h)f(axis,)i(of)f(the)g(region)f
+(whic)n(h)h(is)g(to)427 1079 y(remain)27 b(visible)h(\(unclipp)r(ed\).)
+0 1239 y Fd(Notes:)340 1519 y Fh(\017)45 b Fi(Only)19
b(one)g(clipping)h(F)-7 b(rame)18 b(ma)n(y)h(b)r(e)h(activ)n(e)e(at)h
(a)g(time.)35 b(This)19 b(function)h(will)g(deactiv)-5
-b(ate)19 b(an)n(y)f(previously-)427 4310 y(established)28
+b(ate)19 b(an)n(y)f(previously-)427 1619 y(established)28
b(clipping)f(F)-7 b(rame)27 b(b)r(efore)h(setting)f(up)h(new)g
-(clipping)f(limits.)340 4439 y Fh(\017)45 b Fi(The)29
+(clipping)f(limits.)340 1749 y Fh(\017)45 b Fi(The)29
b(clipping)g(pro)r(duced)f(b)n(y)h(this)g(function)g(is)g(in)g
(addition)g(to)g(that)g(sp)r(eci\014ed)g(b)n(y)f(the)h(Clip)g
-(attribute)427 4538 y(whic)n(h)40 b(o)r(ccurs)f(at)g(the)h(edges)f(of)h
+(attribute)427 1849 y(whic)n(h)40 b(o)r(ccurs)f(at)g(the)h(edges)f(of)h
(the)g(plotting)g(area)e(established)h(when)h(the)g(Plot)f(is)h
-(created)f(\(see)427 4638 y(astPlot\).)d(The)28 b(underlying)f
+(created)f(\(see)427 1948 y(astPlot\).)d(The)28 b(underlying)f
(graphics)f(system)i(ma)n(y)f(also)f(imp)r(ose)i(further)f(clipping.)
-340 4767 y Fh(\017)45 b Fi(When)25 b(testing)f(a)f(graphical)g(p)r
+340 2079 y Fh(\017)45 b Fi(When)25 b(testing)f(a)f(graphical)g(p)r
(osition)h(for)f(clipping,)i(it)f(is)g(\014rst)g(transformed)f(in)n(to)
-h(the)g(clipping)g(F)-7 b(rame.)427 4867 y(The)33 b(resulting)f(co)r
+h(the)g(clipping)g(F)-7 b(rame.)427 2178 y(The)33 b(resulting)f(co)r
(ordinate)g(on)g(eac)n(h)g(axis)g(is)h(then)g(c)n(hec)n(k)n(ed)f
(against)f(the)j(clipping)e(limits)i(\(giv)n(en)e(b)n(y)427
-4966 y Ft(")p Fi(lbnd)p Ft(")i Fi(and)g Ft(")p Fi(ubnd)p
+2278 y Ft(")p Fi(lbnd)p Ft(")i Fi(and)g Ft(")p Fi(ubnd)p
Ft(")p Fi(\).)56 b(By)34 b(default,)i(a)e(p)r(osition)f(is)h(clipp)r
(ed)h(if)g(an)n(y)e(co)r(ordinate)g(lies)h(outside)g(these)427
-5066 y(limits.)i(Ho)n(w)n(ev)n(er,)22 b(if)h(a)f(non-zero)f(v)-5
+2378 y(limits.)i(Ho)n(w)n(ev)n(er,)22 b(if)h(a)f(non-zero)f(v)-5
b(alue)22 b(is)h(assigned)e(to)h(the)h(Plot's)f(ClipOp)h(attribute,)h
-(then)f(a)f(p)r(osition)427 5165 y(is)28 b(only)f(clipp)r(ed)h(if)g
+(then)f(a)f(p)r(osition)427 2477 y(is)28 b(only)f(clipp)r(ed)h(if)g
(the)g(co)r(ordinates)e(on)i(all)f(axes)g(lie)g(outside)h(their)f
-(clipping)h(limits.)340 5295 y Fh(\017)45 b Fi(If)28
+(clipping)h(limits.)340 2608 y Fh(\017)45 b Fi(If)28
b(the)f(lo)n(w)n(er)f(clipping)h(limit)h(exceeds)e(the)i(upp)r(er)f
(limit)h(for)e(an)n(y)h(axis,)f(then)i(the)f(sense)g(of)g(clipping)g
-(for)427 5394 y(that)k(axis)f(is)g(rev)n(ersed)f(\(so)h(that)h(co)r
+(for)427 2707 y(that)k(axis)f(is)g(rev)n(ersed)f(\(so)h(that)h(co)r
(ordinate)e(v)-5 b(alues)30 b(lying)h(b)r(et)n(w)n(een)f(the)h(limits)g
-(are)f(clipp)r(ed)h(instead)427 5494 y(of)k(those)g(lying)g(outside)g
+(are)f(clipp)r(ed)h(instead)427 2807 y(of)k(those)g(lying)g(outside)g
(the)g(limits\).)61 b(T)-7 b(o)34 b(pro)r(duce)h(a)g
Ft(")p Fi(hole)p Ft(")f Fi(in)h(a)g(co)r(ordinate)f(space)g(\(that)i
-(is,)h(an)427 5593 y(in)n(ternal)24 b(region)g(where)g(nothing)h(is)f
+(is,)h(an)427 2907 y(in)n(ternal)24 b(region)g(where)g(nothing)h(is)f
(plotted\),)i(y)n(ou)e(should)h(supply)g(all)f(the)h(b)r(ounds)g(in)g
-(rev)n(ersed)e(order,)427 5693 y(and)28 b(set)f(the)h(ClipOp)g
+(rev)n(ersed)e(order,)427 3006 y(and)28 b(set)f(the)h(ClipOp)g
(attribute)g(for)f(the)h(Plot)f(to)g(a)g(non-zero)f(v)-5
-b(alue.)p eop end
-%%Page: 206 216
-TeXDict begin 206 215 bop 0 52 a FF(206)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
-b Fi(Either)25 b(clipping)h(limit)g(ma)n(y)f(b)r(e)h(set)f(to)h(the)g
-(v)-5 b(alue)25 b(AST)p Ft(__)p Fi(BAD,)h(whic)n(h)f(is)h(equiv)-5
-b(alen)n(t)25 b(to)g(setting)h(it)g(to)427 451 y(in\014nit)n(y)i(\(or)f
-(min)n(us)h(in\014nit)n(y)g(for)f(a)g(lo)n(w)n(er)f(b)r(ound\))i(so)f
-(that)h(it)g(is)g(not)f(used.)340 587 y Fh(\017)45 b
-Fi(If)29 b(a)e(graphical)f(p)r(osition)i(results)f(in)h(an)n(y)f(bad)h
-(co)r(ordinate)f(v)-5 b(alues)27 b(\(AST)p Ft(__)p Fi(BAD\))i(when)f
-(transformed)427 687 y(in)n(to)i(the)h(clipping)f(F)-7
-b(rame,)31 b(then)g(it)g(is)f(treated)g(\(for)g(the)h(purp)r(oses)e(of)
-h(pro)r(ducing)g(graphical)f(output\))427 787 y(as)e(if)h(it)g(w)n(ere)
-f(clipp)r(ed.)340 923 y Fh(\017)45 b Fi(When)34 b(a)f(Plot)g(is)h(used)
-f(as)g(a)g(Mapping)h(to)f(transform)f(p)r(oin)n(ts)i(\(e.g.)54
+b(alue.)340 3137 y Fh(\017)45 b Fi(Either)25 b(clipping)h(limit)g(ma)n
+(y)f(b)r(e)h(set)f(to)h(the)g(v)-5 b(alue)25 b(AST)p
+Ft(__)p Fi(BAD,)h(whic)n(h)f(is)h(equiv)-5 b(alen)n(t)25
+b(to)g(setting)h(it)g(to)427 3236 y(in\014nit)n(y)i(\(or)f(min)n(us)h
+(in\014nit)n(y)g(for)f(a)g(lo)n(w)n(er)f(b)r(ound\))i(so)f(that)h(it)g
+(is)g(not)f(used.)340 3367 y Fh(\017)45 b Fi(If)29 b(a)e(graphical)f(p)
+r(osition)i(results)f(in)h(an)n(y)f(bad)h(co)r(ordinate)f(v)-5
+b(alues)27 b(\(AST)p Ft(__)p Fi(BAD\))i(when)f(transformed)427
+3466 y(in)n(to)i(the)h(clipping)f(F)-7 b(rame,)31 b(then)g(it)g(is)f
+(treated)g(\(for)g(the)h(purp)r(oses)e(of)h(pro)r(ducing)g(graphical)f
+(output\))427 3566 y(as)e(if)h(it)g(w)n(ere)f(clipp)r(ed.)340
+3696 y Fh(\017)45 b Fi(When)34 b(a)f(Plot)g(is)h(used)f(as)g(a)g
+(Mapping)h(to)f(transform)f(p)r(oin)n(ts)i(\(e.g.)54
b(using)33 b(astT)-7 b(ran2\),)34 b(an)n(y)f(clipp)r(ed)427
-1023 y(output)28 b(p)r(oin)n(ts)g(are)f(assigned)f(co)r(ordinate)g(v)-5
-b(alues)28 b(of)f(AST)p Ft(__)p Fi(BAD.)340 1160 y Fh(\017)45
+3796 y(output)28 b(p)r(oin)n(ts)g(are)f(assigned)f(co)r(ordinate)g(v)-5
+b(alues)28 b(of)f(AST)p Ft(__)p Fi(BAD.)340 3926 y Fh(\017)45
b Fi(An)28 b(error)e(results)h(if)h(the)g(base)f(F)-7
b(rame)27 b(of)h(the)g(Plot)f(is)g(not)h(2-dimensional.)p
-0 1366 3780 12 v 0 1498 a Fz(astClone)968 1505 y Fe(Clone)38
+0 4121 3780 12 v 0 4252 a Fz(astClone)968 4259 y Fe(Clone)38
b(\(duplicate\))e(an)i(Ob)7 b(ject)38 b(p)s(oin)m(ter)3271
-1498 y Fz(astClone)0 1708 y Fd(Description:)44 b Fi(This)34
+4252 y Fz(astClone)0 4450 y Fd(Description:)44 b Fi(This)34
b(function)g(returns)f(a)g(duplicate)h(p)r(oin)n(ter)f(to)h(an)f
(existing)g(Ob)5 b(ject.)55 b(It)34 b(also)e(incremen)n(ts)h(the)227
-1807 y(Ob)5 b(ject's)28 b(RefCoun)n(t)f(attribute)h(to)g(k)n(eep)f
+4549 y(Ob)5 b(ject's)28 b(RefCoun)n(t)f(attribute)h(to)g(k)n(eep)f
(trac)n(k)f(of)i(ho)n(w)f(man)n(y)g(p)r(oin)n(ters)f(ha)n(v)n(e)h(b)r
-(een)h(issued.)227 1935 y(Note)40 b(that)g(this)g(function)g(is)f(NOT)h
+(een)h(issued.)227 4673 y(Note)40 b(that)g(this)g(function)g(is)f(NOT)h
(equiv)-5 b(alen)n(t)39 b(to)g(an)g(assignmen)n(t)g(statemen)n(t,)k(as)
-38 b(in)i(general)e(the)i(t)n(w)n(o)227 2035 y(p)r(oin)n(ters)27
+38 b(in)i(general)e(the)i(t)n(w)n(o)227 4772 y(p)r(oin)n(ters)27
b(will)h(not)g(ha)n(v)n(e)e(the)i(same)f(v)-5 b(alue.)0
-2192 y Fd(Synopsis:)121 b Ft(AstObject)40 b Fh(\003)p
+4919 y Fd(Synopsis:)121 b Ft(AstObject)40 b Fh(\003)p
Ft(astClone\()f(AstObject)h Fh(\003)p Ft(this)h(\))0
-2349 y Fd(P)m(arameters:)259 2493 y(this)427 2593 y Fi(Original)26
-b(p)r(oin)n(ter)i(to)f(the)h(Ob)5 b(ject.)0 2762 y Fd(Class)31
-b(Applicabilit)m(y:)259 2906 y(Ob)5 b(ject)427 3005 y
-Fi(This)28 b(function)g(applies)f(to)h(all)f(Ob)5 b(jects.)0
-3175 y Fd(Returned)32 b(V)-8 b(alue:)259 3319 y(astClone\(\))427
-3418 y Fi(A)28 b(duplicate)g(p)r(oin)n(ter)f(to)h(the)g(same)f(Ob)5
-b(ject.)0 3588 y Fd(Notes:)340 3878 y Fh(\017)45 b Fi(A)35
+5066 y Fd(P)m(arameters:)259 5200 y(this)427 5300 y Fi(Original)26
+b(p)r(oin)n(ter)i(to)f(the)h(Ob)5 b(ject.)0 5459 y Fd(Class)31
+b(Applicabilit)m(y:)259 5593 y(Ob)5 b(ject)427 5693 y
+Fi(This)28 b(function)g(applies)f(to)h(all)f(Ob)5 b(jects.)p
+eop end
+%%Page: 207 217
+TeXDict begin 207 216 bop 3643 52 a FF(207)0 351 y Fd(Returned)32
+b(V)-8 b(alue:)259 487 y(astClone\(\))427 586 y Fi(A)28
+b(duplicate)g(p)r(oin)n(ter)f(to)h(the)g(same)f(Ob)5
+b(ject.)0 748 y Fd(Notes:)340 1029 y Fh(\017)45 b Fi(A)35
b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
-(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 3977 y(AST)28
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 1129 y(AST)28
b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)p 0 4184 V 0 4315 a Fz(astCmpF)-11 b(rame)1369
-4314 y Fe(Create)37 b(a)h(CmpF)-10 b(rame)2958 4315 y
-Fz(astCmpF)f(rame)0 4511 y Fd(Description:)44 b Fi(This)28
-b(function)g(creates)f(a)g(new)g(CmpF)-7 b(rame)28 b(and)f(optionally)g
-(initialises)g(its)h(attributes.)227 4639 y(A)40 b(CmpF)-7
-b(rame)38 b(is)h(a)f(comp)r(ound)h(F)-7 b(rame)39 b(whic)n(h)g(allo)n
-(ws)e(t)n(w)n(o)h(comp)r(onen)n(t)h(F)-7 b(rames)38 b(\(of)h(an)n(y)f
-(class\))g(to)h(b)r(e)227 4739 y(merged)34 b(together)h(to)f(form)h(a)g
-(more)f(complex)g(F)-7 b(rame.)59 b(The)35 b(axes)f(of)h(the)g(t)n(w)n
-(o)f(comp)r(onen)n(t)h(F)-7 b(rames)34 b(then)227 4839
-y(app)r(ear)i(together)g(in)h(the)g(resulting)f(CmpF)-7
-b(rame)36 b(\(those)h(of)f(the)h(\014rst)g(F)-7 b(rame,)38
-b(follo)n(w)n(ed)e(b)n(y)g(those)h(of)f(the)227 4938
-y(second)27 b(F)-7 b(rame\).)227 5067 y(Since)24 b(a)f(CmpF)-7
-b(rame)23 b(is)g(itself)h(a)f(F)-7 b(rame,)24 b(it)g(can)f(b)r(e)g
-(used)h(as)e(a)h(comp)r(onen)n(t)g(in)h(forming)f(further)g(CmpF)-7
-b(rames.)227 5166 y(F)g(rames)27 b(of)h(arbitrary)d(complexit)n(y)i(ma)
-n(y)g(b)r(e)h(built)g(from)g(simple)f(individual)h(F)-7
-b(rames)27 b(in)h(this)g(w)n(a)n(y)-7 b(.)227 5295 y(Also)39
-b(since)f(a)h(F)-7 b(rame)38 b(is)h(a)f(Mapping,)j(a)e(CmpF)-7
-b(rame)38 b(can)h(also)f(b)r(e)h(used)g(as)f(a)g(Mapping.)70
-b(Normally)-7 b(,)41 b(a)227 5394 y(CmpF)-7 b(rame)35
+(reason.)p 0 1326 3780 12 v 0 1457 a Fz(astCmpF)-11 b(rame)548
+b Fe(Create)37 b(a)h(CmpF)-10 b(rame)546 b Fz(astCmpF)-11
+b(rame)0 1644 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f
+(a)g(new)g(CmpF)-7 b(rame)28 b(and)f(optionally)g(initialises)g(its)h
+(attributes.)227 1768 y(A)40 b(CmpF)-7 b(rame)38 b(is)h(a)f(comp)r
+(ound)h(F)-7 b(rame)39 b(whic)n(h)g(allo)n(ws)e(t)n(w)n(o)h(comp)r
+(onen)n(t)h(F)-7 b(rames)38 b(\(of)h(an)n(y)f(class\))g(to)h(b)r(e)227
+1868 y(merged)34 b(together)h(to)f(form)h(a)g(more)f(complex)g(F)-7
+b(rame.)59 b(The)35 b(axes)f(of)h(the)g(t)n(w)n(o)f(comp)r(onen)n(t)h
+(F)-7 b(rames)34 b(then)227 1968 y(app)r(ear)i(together)g(in)h(the)g
+(resulting)f(CmpF)-7 b(rame)36 b(\(those)h(of)f(the)h(\014rst)g(F)-7
+b(rame,)38 b(follo)n(w)n(ed)e(b)n(y)g(those)h(of)f(the)227
+2067 y(second)27 b(F)-7 b(rame\).)227 2191 y(Since)24
+b(a)f(CmpF)-7 b(rame)23 b(is)g(itself)h(a)f(F)-7 b(rame,)24
+b(it)g(can)f(b)r(e)g(used)h(as)e(a)h(comp)r(onen)n(t)g(in)h(forming)f
+(further)g(CmpF)-7 b(rames.)227 2291 y(F)g(rames)27 b(of)h(arbitrary)d
+(complexit)n(y)i(ma)n(y)g(b)r(e)h(built)g(from)g(simple)f(individual)h
+(F)-7 b(rames)27 b(in)h(this)g(w)n(a)n(y)-7 b(.)227 2415
+y(Also)39 b(since)f(a)h(F)-7 b(rame)38 b(is)h(a)f(Mapping,)j(a)e(CmpF)
+-7 b(rame)38 b(can)h(also)f(b)r(e)h(used)g(as)f(a)g(Mapping.)70
+b(Normally)-7 b(,)41 b(a)227 2515 y(CmpF)-7 b(rame)35
b(is)g(simply)h(equiv)-5 b(alen)n(t)35 b(to)g(a)g(UnitMap,)i(but)f(if)g
(either)f(of)g(the)h(comp)r(onen)n(t)f(F)-7 b(rames)34
-b(within)i(a)227 5494 y(CmpF)-7 b(rame)41 b(is)f(a)g(Region)g(\(a)g
+b(within)i(a)227 2614 y(CmpF)-7 b(rame)41 b(is)f(a)g(Region)g(\(a)g
(sub-class)g(of)g(F)-7 b(rame\),)44 b(then)d(the)g(CmpF)-7
-b(rame)40 b(will)h(use)f(the)h(Region)f(as)g(a)227 5593
+b(rame)40 b(will)h(use)f(the)h(Region)f(as)g(a)227 2714
y(Mapping)g(when)g(transforming)e(v)-5 b(alues)39 b(for)g(axes)g
(describ)r(ed)h(b)n(y)f(the)h(Region.)73 b(Th)n(us)39
-b(input)i(axis)e(v)-5 b(alues)227 5693 y(corresp)r(onding)26
+b(input)i(axis)e(v)-5 b(alues)227 2814 y(corresp)r(onding)26
b(to)h(p)r(ositions)h(whic)n(h)f(are)g(outside)g(the)h(Region)f(will)h
-(result)f(in)h(bad)f(output)i(axis)d(v)-5 b(alues.)p
-eop end
-%%Page: 207 217
-TeXDict begin 207 216 bop 3643 52 a FF(207)0 351 y Fd(Synopsis:)121
-b Ft(AstCmpFrame)39 b Fh(\003)p Ft(astCmpFrame\()f(AstFrame)i
-Fh(\003)p Ft(frame1,)h(AstFrame)f Fh(\003)p Ft(frame2,)g(const)h(char)h
-Fh(\003)p Ft(options,)227 451 y(...)86 b(\))0 599 y Fd(P)m(arameters:)
-259 735 y(frame1)427 834 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f
-(comp)r(onen)n(t)g(F)-7 b(rame.)259 966 y Fd(frame2)427
-1066 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(second)f(comp)r(onen)n(t)g(F)-7
-b(rame.)259 1197 y Fd(options)427 1297 y Fi(P)n(oin)n(ter)27
+(result)f(in)h(bad)f(output)i(axis)d(v)-5 b(alues.)0
+2962 y Fd(Synopsis:)121 b Ft(AstCmpFrame)39 b Fh(\003)p
+Ft(astCmpFrame\()f(AstFrame)i Fh(\003)p Ft(frame1,)h(AstFrame)f
+Fh(\003)p Ft(frame2,)g(const)h(char)h Fh(\003)p Ft(options,)227
+3062 y(...)86 b(\))0 3210 y Fd(P)m(arameters:)259 3346
+y(frame1)427 3446 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f(comp)r
+(onen)n(t)g(F)-7 b(rame.)259 3578 y Fd(frame2)427 3677
+y Fi(P)n(oin)n(ter)26 b(to)i(the)g(second)f(comp)r(onen)n(t)g(F)-7
+b(rame.)259 3809 y Fd(options)427 3909 y Fi(P)n(oin)n(ter)27
b(to)h(a)g(n)n(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)
-g(comma-separated)e(list)i(of)g(attribute)427 1397 y(assignmen)n(ts)i
+g(comma-separated)e(list)i(of)g(attribute)427 4008 y(assignmen)n(ts)i
(to)i(b)r(e)f(used)h(for)f(initialising)g(the)h(new)f(CmpF)-7
b(rame.)48 b(The)31 b(syn)n(tax)g(used)g(is)h(iden)n(tical)f(to)427
-1496 y(that)38 b(for)e(the)i(astSet)f(function)h(and)f(ma)n(y)f
+4108 y(that)38 b(for)e(the)i(astSet)f(function)h(and)f(ma)n(y)f
(include)i Ft(")p Fi(prin)n(tf)p Ft(")e Fi(format)h(sp)r(eci\014ers)g
(iden)n(ti\014ed)g(b)n(y)g Ft(")p Fi(\045)p Ft(")427
-1596 y Fi(sym)n(b)r(ols)27 b(in)h(the)g(normal)f(w)n(a)n(y)-7
-b(.)259 1728 y Fd(...)427 1827 y Fi(If)38 b(the)g Ft(")p
+4208 y Fi(sym)n(b)r(ols)27 b(in)h(the)g(normal)f(w)n(a)n(y)-7
+b(.)259 4340 y Fd(...)427 4439 y Fi(If)38 b(the)g Ft(")p
Fi(options)p Ft(")e Fi(string)h(con)n(tains)f Ft(")p
Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g
-(list)h(of)f(additional)427 1927 y(argumen)n(ts)26 b(ma)n(y)h(follo)n
+(list)h(of)f(additional)427 4539 y(argumen)n(ts)26 b(ma)n(y)h(follo)n
(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5 b(alues)27
b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)37
-b(The)427 2026 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+b(The)427 4639 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 2126 y Fi(function\).)0
-2287 y Fd(Returned)32 b(V)-8 b(alue:)259 2422 y(astCmpF)g(rame\(\))427
-2522 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(CmpF)-7
-b(rame.)0 2683 y Fd(Notes:)340 2964 y Fh(\017)45 b Fi(A)35
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 4738 y Fi(function\).)0
+4899 y Fd(Returned)32 b(V)-8 b(alue:)259 5035 y(astCmpF)g(rame\(\))427
+5135 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(CmpF)-7
+b(rame.)0 5296 y Fd(Notes:)340 5577 y Fh(\017)45 b Fi(A)35
b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
-(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 3064 y(AST)28
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 5677 y(AST)28
b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)-2 3224 y Fd(Status)33 b(Handling)n(:)227 3371
-y Fi(The)d(protected)g(in)n(terface)f(to)g(this)h(function)h(includes)f
-(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g(the)g(parameter)227
-3470 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37
-b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)e
-(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fi(in)n(t)227
-3570 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p 0 3767 3780
-12 v 0 3898 a Fz(astCmpMap)1413 3897 y Fe(Create)38 b(a)g(CmpMap)3057
-3898 y Fz(astCmpMap)0 4084 y Fd(Description:)44 b Fi(This)28
+(reason.)p eop end
+%%Page: 208 218
+TeXDict begin 208 217 bop 0 52 a FF(208)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)-2 351 y Fd(Status)j(Handling)n(:)
+227 497 y Fi(The)d(protected)g(in)n(terface)f(to)g(this)h(function)h
+(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g(the)g
+(parameter)227 597 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62
+b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)
+e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fi(in)n(t)227
+697 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p 0 895 3780
+12 v 0 1026 a Fz(astCmpMap)691 b Fe(Create)38 b(a)g(CmpMap)690
+b Fz(astCmpMap)0 1214 y Fd(Description:)44 b Fi(This)28
b(function)g(creates)f(a)g(new)g(CmpMap)h(and)f(optionally)g
-(initialises)h(its)f(attributes.)227 4208 y(A)k(CmpMap)g(is)g(a)f(comp)
+(initialises)h(its)f(attributes.)227 1339 y(A)k(CmpMap)g(is)g(a)f(comp)
r(ound)h(Mapping)f(whic)n(h)h(allo)n(ws)e(t)n(w)n(o)h(comp)r(onen)n(t)h
(Mappings)f(\(of)h(an)n(y)f(class\))g(to)g(b)r(e)227
-4308 y(connected)h(together)e(to)h(form)g(a)g(more)g(complex)g
+1438 y(connected)h(together)e(to)h(form)g(a)g(more)g(complex)g
(Mapping.)45 b(This)30 b(connection)g(ma)n(y)g(either)g(b)r(e)h
-Ft(")p Fi(in)f(series)p Ft(")227 4407 y Fi(\(where)21
+Ft(")p Fi(in)f(series)p Ft(")227 1538 y Fi(\(where)21
b(the)g(\014rst)g(Mapping)f(is)h(used)g(to)g(transform)f(the)h(co)r
(ordinates)e(of)i(eac)n(h)f(p)r(oin)n(t)i(and)e(the)i(second)e(mapping)
-227 4507 y(is)g(then)g(applied)f(to)g(the)h(result\),)h(or)e
+227 1638 y(is)g(then)g(applied)f(to)g(the)h(result\),)h(or)e
Ft(")p Fi(in)g(parallel)p Ft(")f Fi(\(where)h(one)g(Mapping)g
-(transforms)f(the)i(earlier)e(co)r(ordinates)227 4607
+(transforms)f(the)i(earlier)e(co)r(ordinates)227 1737
y(for)27 b(eac)n(h)g(p)r(oin)n(t)h(and)f(the)h(second)f(Mapping)h(sim)n
(ultaneously)e(transforms)g(the)i(later)f(co)r(ordinates\).)227
-4731 y(Since)f(a)f(CmpMap)g(is)h(itself)g(a)f(Mapping,)g(it)h(can)f(b)r
+1862 y(Since)f(a)f(CmpMap)g(is)h(itself)g(a)f(Mapping,)g(it)h(can)f(b)r
(e)h(used)f(as)g(a)g(comp)r(onen)n(t)g(in)h(forming)e(further)i
-(CmpMaps.)227 4830 y(Mappings)h(of)h(arbitrary)d(complexit)n(y)i(ma)n
+(CmpMaps.)227 1961 y(Mappings)h(of)h(arbitrary)d(complexit)n(y)i(ma)n
(y)g(b)r(e)h(built)h(from)e(simple)h(individual)f(Mappings)g(in)h(this)
-g(w)n(a)n(y)-7 b(.)0 4979 y Fd(Synopsis:)121 b Ft(AstCmpMap)40
+g(w)n(a)n(y)-7 b(.)0 2110 y Fd(Synopsis:)121 b Ft(AstCmpMap)40
b Fh(\003)p Ft(astCmpMap\()f(AstMapping)g Fh(\003)p Ft(map1,)i
(AstMapping)f Fh(\003)p Ft(map2,)h(int)h(series,)f(const)g(char)227
-5078 y Fh(\003)p Ft(options,)f(...)86 b(\))0 5227 y Fd(P)m(arameters:)
-259 5362 y(map1)427 5462 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f
-(comp)r(onen)n(t)g(Mapping.)259 5593 y Fd(map2)427 5693
-y Fi(P)n(oin)n(ter)f(to)i(the)g(second)f(comp)r(onen)n(t)g(Mapping.)p
-eop end
-%%Page: 208 218
-TeXDict begin 208 217 bop 0 52 a FF(208)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(series)427
-451 y Fi(If)22 b(a)f(non-zero)e(v)-5 b(alue)21 b(is)g(giv)n(en)f(for)h
-(this)h(parameter,)f(the)g(t)n(w)n(o)f(comp)r(onen)n(t)h(Mappings)g
-(will)g(b)r(e)h(connected)427 551 y(in)28 b(series.)36
-b(A)28 b(zero)e(v)-5 b(alue)28 b(requests)f(that)g(they)h(are)f
-(connected)g(in)h(parallel.)259 685 y Fd(options)427
-785 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n(ull-terminated)g(string)f(con)n
-(taining)g(an)h(optional)g(comma-separated)e(list)i(of)g(attribute)427
-884 y(assignmen)n(ts)23 b(to)g(b)r(e)h(used)g(for)f(initialising)h(the)
-g(new)g(CmpMap.)35 b(The)24 b(syn)n(tax)f(used)h(is)f(iden)n(tical)h
-(to)f(that)427 984 y(for)j(the)h(astSet)g(function)g(and)g(ma)n(y)f
-(include)h Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g
-(iden)n(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-1084 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 1218
-y Fd(...)427 1318 y Fi(If)38 b(the)g Ft(")p Fi(options)p
+2210 y Fh(\003)p Ft(options,)f(...)86 b(\))0 2359 y Fd(P)m(arameters:)
+259 2495 y(map1)427 2595 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f
+(comp)r(onen)n(t)g(Mapping.)259 2727 y Fd(map2)427 2827
+y Fi(P)n(oin)n(ter)f(to)i(the)g(second)f(comp)r(onen)n(t)g(Mapping.)259
+2960 y Fd(series)427 3059 y Fi(If)22 b(a)f(non-zero)e(v)-5
+b(alue)21 b(is)g(giv)n(en)f(for)h(this)h(parameter,)f(the)g(t)n(w)n(o)f
+(comp)r(onen)n(t)h(Mappings)g(will)g(b)r(e)h(connected)427
+3159 y(in)28 b(series.)36 b(A)28 b(zero)e(v)-5 b(alue)28
+b(requests)f(that)g(they)h(are)f(connected)g(in)h(parallel.)259
+3292 y Fd(options)427 3391 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n
+(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
+(comma-separated)e(list)i(of)g(attribute)427 3491 y(assignmen)n(ts)23
+b(to)g(b)r(e)h(used)g(for)f(initialising)h(the)g(new)g(CmpMap.)35
+b(The)24 b(syn)n(tax)f(used)h(is)f(iden)n(tical)h(to)f(that)427
+3590 y(for)j(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
+Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n
+(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
+3690 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 3823
+y Fd(...)427 3922 y Fi(If)38 b(the)g Ft(")p Fi(options)p
Ft(")e Fi(string)h(con)n(tains)f Ft(")p Fi(\045)p Ft(")h
Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g(list)h(of)f
-(additional)427 1418 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
+(additional)427 4022 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
(order)e(to)h(supply)h(v)-5 b(alues)27 b(to)g(b)r(e)h(substituted)h
-(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 1517 y(rules)25
+(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 4121 y(rules)25
b(for)f(supplying)h(these)g(are)f(iden)n(tical)h(to)g(those)g(for)f
(the)h(astSet)g(function)h(\(and)f(for)g(the)g(C)g Ft(")p
-Fi(prin)n(tf)p Ft(")427 1617 y Fi(function\).)0 1782
-y Fd(Returned)32 b(V)-8 b(alue:)259 1922 y(astCmpMap\(\))427
-2022 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(CmpMap.)0
-2187 y Fd(Notes:)340 2474 y Fh(\017)45 b Fi(If)37 b(the)g(comp)r(onen)n
+Fi(prin)n(tf)p Ft(")427 4221 y Fi(function\).)0 4383
+y Fd(Returned)32 b(V)-8 b(alue:)259 4519 y(astCmpMap\(\))427
+4618 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(CmpMap.)0
+4780 y Fd(Notes:)340 5062 y Fh(\017)45 b Fi(If)37 b(the)g(comp)r(onen)n
(t)g(Mappings)f(are)g(connected)g(in)h(series,)h(then)f(using)g(the)g
-(resulting)f(CmpMap)h(to)427 2573 y(transform)g(co)r(ordinates)g(will)i
+(resulting)f(CmpMap)h(to)427 5162 y(transform)g(co)r(ordinates)g(will)i
(cause)e(the)i(\014rst)f(Mapping)g(to)g(b)r(e)g(applied,)j(follo)n(w)n
-(ed)d(b)n(y)g(the)g(second)427 2673 y(Mapping.)e(If)26
+(ed)d(b)n(y)g(the)g(second)427 5262 y(Mapping.)e(If)26
b(the)h(in)n(v)n(erse)d(CmpMap)i(transformation)e(is)i(requested,)f
-(the)i(t)n(w)n(o)e(comp)r(onen)n(t)g(Mappings)427 2772
+(the)i(t)n(w)n(o)e(comp)r(onen)n(t)g(Mappings)427 5361
y(will)j(b)r(e)g(applied)g(in)g(b)r(oth)g(the)g(rev)n(erse)d(order)h
-(and)i(the)g(rev)n(erse)e(direction.)340 2907 y Fh(\017)45
+(and)i(the)g(rev)n(erse)e(direction.)340 5494 y Fh(\017)45
b Fi(When)27 b(connecting)f(t)n(w)n(o)g(comp)r(onen)n(t)g(Mappings)f
(in)i(series,)e(the)i(n)n(um)n(b)r(er)f(of)h(output)f(co)r(ordinates)f
-(gen-)427 3007 y(erated)h(b)n(y)g(the)g(\014rst)g(Mapping)g(\(its)h
+(gen-)427 5593 y(erated)h(b)n(y)g(the)g(\014rst)g(Mapping)g(\(its)h
(Nout)f(attribute\))h(m)n(ust)f(equal)f(the)i(n)n(um)n(b)r(er)f(of)g
-(input)h(co)r(ordinates)427 3106 y(accepted)h(b)n(y)f(the)h(second)f
-(Mapping)g(\(its)h(Nin)g(attribute\).)340 3241 y Fh(\017)45
-b Fi(If)19 b(the)g(comp)r(onen)n(t)g(Mappings)f(of)h(a)f(CmpMap)h(are)e
-(connected)i(in)g(parallel,)g(then)h(the)f(\014rst)f(Mapping)g(will)427
-3341 y(b)r(e)28 b(used)f(to)g(transform)g(the)g(earlier)f(input)i(co)r
-(ordinates)e(for)h(eac)n(h)f(p)r(oin)n(t)i(\(and)f(to)g(pro)r(duce)g
-(the)h(earlier)427 3440 y(output)34 b(co)r(ordinates\))e(and)g(the)i
-(second)e(Mapping)h(will)g(b)r(e)h(used)e(sim)n(ultaneously)h(to)f
-(transform)g(the)427 3540 y(remaining)f(input)i(co)r(ordinates)e(\(to)h
-(pro)r(duce)g(the)h(remaining)e(output)h(co)r(ordinates)f(for)h(eac)n
-(h)f(p)r(oin)n(t\).)427 3639 y(If)37 b(the)g(in)n(v)n(erse)e
-(transformation)f(is)j(requested,)g(eac)n(h)f(Mapping)g(will)h(still)f
-(b)r(e)h(applied)f(to)g(the)h(same)427 3739 y(co)r(ordinates,)27
-b(but)h(in)g(the)g(rev)n(erse)d(direction.)340 3874 y
-Fh(\017)45 b Fi(When)27 b(connecting)e(t)n(w)n(o)g(comp)r(onen)n(t)g
-(Mappings)g(in)h(parallel,)f(there)h(is)f(no)h(restriction)e(on)i(the)g
-(n)n(um)n(b)r(er)427 3973 y(of)i(input)g(and)g(output)g(co)r(ordinates)
-e(for)h(eac)n(h)g(Mapping.)340 4108 y Fh(\017)45 b Fi(Note)19
-b(that)f(the)h(comp)r(onen)n(t)f(Mappings)g(supplied)h(are)e(not)h
-(copied)g(b)n(y)h(astCmpMap)f(\(the)h(new)f(CmpMap)427
-4208 y(simply)31 b(retains)f(a)g(reference)f(to)i(them\).)46
-b(They)31 b(ma)n(y)f(con)n(tin)n(ue)g(to)g(b)r(e)h(used)g(for)f(other)f
-(purp)r(oses,)i(but)427 4307 y(should)21 b(not)g(b)r(e)g(deleted.)35
-b(If)22 b(a)e(CmpMap)h(con)n(taining)f(a)h(cop)n(y)f(of)h(its)g(comp)r
-(onen)n(t)f(Mappings)h(is)g(required,)427 4407 y(then)28
-b(a)g(cop)n(y)e(of)i(the)g(CmpMap)f(should)h(b)r(e)g(made)f(using)h
-(astCop)n(y)-7 b(.)340 4542 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
-b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
-(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 4641 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 4844 3780 12 v 0 4976
-a Fz(astCmpRegion)1352 4974 y Fe(Create)38 b(a)g(CmpRegion)2917
-4976 y Fz(astCmpRegion)0 5168 y Fd(Description:)44 b
-Fi(This)28 b(function)g(creates)f(a)g(new)g(CmpRegion)h(and)f
-(optionally)g(initialises)g(its)h(attributes.)227 5295
-y(A)i(CmpRegion)f(is)h(a)f(Region)g(whic)n(h)g(allo)n(ws)g(t)n(w)n(o)f
-(comp)r(onen)n(t)i(Regions)e(\(of)i(an)n(y)f(class\))g(to)g(b)r(e)h
-(com)n(bined)g(to)227 5394 y(form)g(a)f(more)f(complex)i(Region.)42
+(input)h(co)r(ordinates)427 5693 y(accepted)h(b)n(y)f(the)h(second)f
+(Mapping)g(\(its)h(Nin)g(attribute\).)p eop end
+%%Page: 209 219
+TeXDict begin 209 218 bop 3643 52 a FF(209)340 351 y
+Fh(\017)45 b Fi(If)19 b(the)g(comp)r(onen)n(t)g(Mappings)f(of)h(a)f
+(CmpMap)h(are)e(connected)i(in)g(parallel,)g(then)h(the)f(\014rst)f
+(Mapping)g(will)427 451 y(b)r(e)28 b(used)f(to)g(transform)g(the)g
+(earlier)f(input)i(co)r(ordinates)e(for)h(eac)n(h)f(p)r(oin)n(t)i
+(\(and)f(to)g(pro)r(duce)g(the)h(earlier)427 551 y(output)34
+b(co)r(ordinates\))e(and)g(the)i(second)e(Mapping)h(will)g(b)r(e)h
+(used)e(sim)n(ultaneously)h(to)f(transform)g(the)427
+650 y(remaining)f(input)i(co)r(ordinates)e(\(to)h(pro)r(duce)g(the)h
+(remaining)e(output)h(co)r(ordinates)f(for)h(eac)n(h)f(p)r(oin)n(t\).)
+427 750 y(If)37 b(the)g(in)n(v)n(erse)e(transformation)f(is)j
+(requested,)g(eac)n(h)f(Mapping)g(will)h(still)f(b)r(e)h(applied)f(to)g
+(the)h(same)427 849 y(co)r(ordinates,)27 b(but)h(in)g(the)g(rev)n(erse)
+d(direction.)340 991 y Fh(\017)45 b Fi(When)27 b(connecting)e(t)n(w)n
+(o)g(comp)r(onen)n(t)g(Mappings)g(in)h(parallel,)f(there)h(is)f(no)h
+(restriction)e(on)i(the)g(n)n(um)n(b)r(er)427 1091 y(of)i(input)g(and)g
+(output)g(co)r(ordinates)e(for)h(eac)n(h)g(Mapping.)340
+1233 y Fh(\017)45 b Fi(Note)19 b(that)f(the)h(comp)r(onen)n(t)f
+(Mappings)g(supplied)h(are)e(not)h(copied)g(b)n(y)h(astCmpMap)f(\(the)h
+(new)f(CmpMap)427 1332 y(simply)31 b(retains)f(a)g(reference)f(to)i
+(them\).)46 b(They)31 b(ma)n(y)f(con)n(tin)n(ue)g(to)g(b)r(e)h(used)g
+(for)f(other)f(purp)r(oses,)i(but)427 1432 y(should)21
+b(not)g(b)r(e)g(deleted.)35 b(If)22 b(a)e(CmpMap)h(con)n(taining)f(a)h
+(cop)n(y)f(of)h(its)g(comp)r(onen)n(t)f(Mappings)h(is)g(required,)427
+1531 y(then)28 b(a)g(cop)n(y)e(of)i(the)g(CmpMap)f(should)h(b)r(e)g
+(made)f(using)h(astCop)n(y)-7 b(.)340 1673 y Fh(\017)45
+b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
+Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 1773 y(AST)28
+b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
+(reason.)p 0 1990 3780 12 v 0 2122 a Fz(astCmpRegion)1352
+2120 y Fe(Create)38 b(a)g(CmpRegion)2917 2122 y Fz(astCmpRegion)0
+2328 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g
+(CmpRegion)h(and)f(optionally)g(initialises)g(its)h(attributes.)227
+2462 y(A)i(CmpRegion)f(is)h(a)f(Region)g(whic)n(h)g(allo)n(ws)g(t)n(w)n
+(o)f(comp)r(onen)n(t)i(Regions)e(\(of)i(an)n(y)f(class\))g(to)g(b)r(e)h
+(com)n(bined)g(to)227 2561 y(form)g(a)f(more)f(complex)i(Region.)42
b(This)29 b(com)n(bination)g(ma)n(y)g(b)r(e)h(p)r(erformed)f(a)g(b)r(o)
-r(olean)g(AND,)i(OR)e(or)g(X)n(OR)227 5494 y(\(exclusiv)n(e)j(OR\))h
+r(olean)g(AND,)i(OR)e(or)g(X)n(OR)227 2661 y(\(exclusiv)n(e)j(OR\))h
(op)r(erator.)49 b(If)33 b(the)g(AND)g(op)r(erator)e(is)h(used,)i(then)
f(a)f(p)r(osition)g(is)h(inside)f(the)h(CmpRegion)227
-5593 y(only)28 b(if)g(it)g(is)g(inside)g(b)r(oth)g(of)g(its)g(t)n(w)n
+2761 y(only)28 b(if)g(it)g(is)g(inside)g(b)r(oth)g(of)g(its)g(t)n(w)n
(o)f(comp)r(onen)n(t)g(Regions.)37 b(If)28 b(the)g(OR)g(op)r(erator)e
-(is)h(used,)h(then)g(a)g(p)r(osition)227 5693 y(is)g(inside)h(the)g
+(is)h(used,)h(then)g(a)g(p)r(osition)227 2860 y(is)g(inside)h(the)g
(CmpRegion)f(if)g(it)h(is)f(inside)h(either)f(\(or)g(b)r(oth\))h(of)f
(its)h(t)n(w)n(o)e(comp)r(onen)n(t)h(Regions.)38 b(If)29
-b(the)g(X)n(OR)p eop end
-%%Page: 209 219
-TeXDict begin 209 218 bop 3643 52 a FF(209)227 351 y
-Fi(op)r(erator)24 b(is)i(used,)g(then)h(a)e(p)r(osition)h(is)g(inside)g
-(the)g(CmpRegion)f(if)i(it)f(is)g(inside)f(one)h(but)g(not)g(b)r(oth)h
-(of)e(its)h(t)n(w)n(o)227 451 y(comp)r(onen)n(t)j(Regions.)41
-b(Other)28 b(op)r(erators)g(can)g(b)r(e)i(formed)f(b)n(y)g(negating)f
-(one)h(or)f(b)r(oth)i(comp)r(onen)n(t)f(Regions)227 551
-y(b)r(efore)f(using)f(them)h(to)f(construct)h(a)f(new)g(CmpRegion.)227
-678 y(The)i(t)n(w)n(o)e(comp)r(onen)n(t)h(Region)g(need)g(not)h(refer)e
-(to)h(the)h(same)f(co)r(ordinate)f(F)-7 b(rame,)28 b(but)h(it)g(m)n
-(ust)f(b)r(e)h(p)r(ossible)227 777 y(for)39 b(the)h(astCon)n(v)n(ert)e
-(function)i(to)f(determine)h(a)f(Mapping)g(b)r(et)n(w)n(een)h(them)g
-(\(an)f(error)f(will)h(b)r(e)h(rep)r(orted)227 877 y(otherwise)33
-b(when)g(the)h(CmpRegion)f(is)g(created\).)54 b(F)-7
-b(or)33 b(instance,)i(a)e(CmpRegion)g(ma)n(y)f(com)n(bine)h(a)g(Region)
-227 977 y(de\014ned)k(within)f(an)g(ICRS)g(SkyF)-7 b(rame)36
-b(with)g(a)g(Region)f(de\014ned)i(within)f(a)g(Galactic)f(SkyF)-7
-b(rame.)62 b(This)36 b(is)227 1076 y(acceptable)i(b)r(ecause)g(the)g
-(SkyF)-7 b(rame)38 b(class)f(kno)n(ws)g(ho)n(w)h(to)g(con)n(v)n(ert)e
-(b)r(et)n(w)n(een)j(these)f(t)n(w)n(o)f(systems,)k(and)227
-1176 y(consequen)n(tly)33 b(the)i(astCon)n(v)n(ert)d(function)j(will)f
-(also)f(b)r(e)h(able)g(to)g(con)n(v)n(ert)f(b)r(et)n(w)n(een)h(them.)57
-b(In)34 b(suc)n(h)g(cases,)227 1276 y(the)f(second)g(comp)r(onen)n(t)f
-(Region)g(will)h(b)r(e)h(mapp)r(ed)f(in)n(to)f(the)h(co)r(ordinate)f(F)
--7 b(rame)32 b(of)h(the)g(\014rst)g(comp)r(onen)n(t)227
-1375 y(Region,)g(and)g(the)f(F)-7 b(rame)32 b(represen)n(ted)g(b)n(y)g
-(the)h(CmpRegion)f(as)f(a)h(whole)g(will)h(b)r(e)g(the)g(F)-7
-b(rame)32 b(of)g(the)h(\014rst)227 1475 y(comp)r(onen)n(t)28
-b(Region.)227 1602 y(Since)20 b(a)f(CmpRegion)f(is)i(itself)f(a)g
-(Region,)i(it)e(can)g(b)r(e)h(used)f(as)g(a)g(comp)r(onen)n(t)g(in)g
-(forming)g(further)g(CmpRegions.)227 1702 y(Regions)27
-b(of)g(arbitrary)f(complexit)n(y)h(ma)n(y)g(b)r(e)h(built)g(from)g
-(simple)f(individual)h(Regions)f(in)g(this)h(w)n(a)n(y)-7
-b(.)0 1857 y Fd(Synopsis:)121 b Ft(AstCmpRegion)38 b
-Fh(\003)p Ft(astCmpRegion\()g(AstRegion)i Fh(\003)p Ft(region1,)g
-(AstRegion)g Fh(\003)p Ft(region2,)f(int)k(oper,)227
-1956 y(const)f(char)g Fh(\003)p Ft(options,)e(...)85
-b(\))0 2111 y Fd(P)m(arameters:)259 2253 y(region1)427
-2353 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f(comp)r(onen)n(t)g
-(Region.)259 2488 y Fd(region2)427 2588 y Fi(P)n(oin)n(ter)20
+b(the)g(X)n(OR)227 2960 y(op)r(erator)24 b(is)i(used,)g(then)h(a)e(p)r
+(osition)h(is)g(inside)g(the)g(CmpRegion)f(if)i(it)f(is)g(inside)f(one)
+h(but)g(not)g(b)r(oth)h(of)e(its)h(t)n(w)n(o)227 3060
+y(comp)r(onen)n(t)j(Regions.)41 b(Other)28 b(op)r(erators)g(can)g(b)r
+(e)i(formed)f(b)n(y)g(negating)f(one)h(or)f(b)r(oth)i(comp)r(onen)n(t)f
+(Regions)227 3159 y(b)r(efore)f(using)f(them)h(to)f(construct)h(a)f
+(new)g(CmpRegion.)227 3293 y(The)i(t)n(w)n(o)e(comp)r(onen)n(t)h
+(Region)g(need)g(not)h(refer)e(to)h(the)h(same)f(co)r(ordinate)f(F)-7
+b(rame,)28 b(but)h(it)g(m)n(ust)f(b)r(e)h(p)r(ossible)227
+3392 y(for)39 b(the)h(astCon)n(v)n(ert)e(function)i(to)f(determine)h(a)
+f(Mapping)g(b)r(et)n(w)n(een)h(them)g(\(an)f(error)f(will)h(b)r(e)h
+(rep)r(orted)227 3492 y(otherwise)33 b(when)g(the)h(CmpRegion)f(is)g
+(created\).)54 b(F)-7 b(or)33 b(instance,)i(a)e(CmpRegion)g(ma)n(y)f
+(com)n(bine)h(a)g(Region)227 3592 y(de\014ned)k(within)f(an)g(ICRS)g
+(SkyF)-7 b(rame)36 b(with)g(a)g(Region)f(de\014ned)i(within)f(a)g
+(Galactic)f(SkyF)-7 b(rame.)62 b(This)36 b(is)227 3691
+y(acceptable)i(b)r(ecause)g(the)g(SkyF)-7 b(rame)38 b(class)f(kno)n(ws)
+g(ho)n(w)h(to)g(con)n(v)n(ert)e(b)r(et)n(w)n(een)j(these)f(t)n(w)n(o)f
+(systems,)k(and)227 3791 y(consequen)n(tly)33 b(the)i(astCon)n(v)n(ert)
+d(function)j(will)f(also)f(b)r(e)h(able)g(to)g(con)n(v)n(ert)f(b)r(et)n
+(w)n(een)h(them.)57 b(In)34 b(suc)n(h)g(cases,)227 3890
+y(the)f(second)g(comp)r(onen)n(t)f(Region)g(will)h(b)r(e)h(mapp)r(ed)f
+(in)n(to)f(the)h(co)r(ordinate)f(F)-7 b(rame)32 b(of)h(the)g(\014rst)g
+(comp)r(onen)n(t)227 3990 y(Region,)g(and)g(the)f(F)-7
+b(rame)32 b(represen)n(ted)g(b)n(y)g(the)h(CmpRegion)f(as)f(a)h(whole)g
+(will)h(b)r(e)g(the)g(F)-7 b(rame)32 b(of)g(the)h(\014rst)227
+4090 y(comp)r(onen)n(t)28 b(Region.)227 4223 y(Since)20
+b(a)f(CmpRegion)f(is)i(itself)f(a)g(Region,)i(it)e(can)g(b)r(e)h(used)f
+(as)g(a)g(comp)r(onen)n(t)g(in)g(forming)g(further)g(CmpRegions.)227
+4323 y(Regions)27 b(of)g(arbitrary)f(complexit)n(y)h(ma)n(y)g(b)r(e)h
+(built)g(from)g(simple)f(individual)h(Regions)f(in)g(this)h(w)n(a)n(y)
+-7 b(.)0 4490 y Fd(Synopsis:)121 b Ft(AstCmpRegion)38
+b Fh(\003)p Ft(astCmpRegion\()g(AstRegion)i Fh(\003)p
+Ft(region1,)g(AstRegion)g Fh(\003)p Ft(region2,)f(int)k(oper,)227
+4590 y(const)f(char)g Fh(\003)p Ft(options,)e(...)85
+b(\))0 4757 y Fd(P)m(arameters:)259 4911 y(region1)427
+5011 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f(comp)r(onen)n(t)g
+(Region.)259 5153 y Fd(region2)427 5252 y Fi(P)n(oin)n(ter)20
b(to)h(the)g(second)g(comp)r(onen)n(t)f(Region.)34 b(This)21
b(Region)g(will)g(b)r(e)h(transformed)d(in)n(to)i(the)h(co)r(ordinate)
-427 2687 y(F)-7 b(rame)27 b(of)h(the)g(\014rst)f(region)g(b)r(efore)g
+427 5352 y(F)-7 b(rame)27 b(of)h(the)g(\014rst)f(region)g(b)r(efore)g
(use.)37 b(An)28 b(error)d(will)j(b)r(e)g(rep)r(orted)f(if)h(this)g(is)
-f(not)h(p)r(ossible.)259 2823 y Fd(op)s(er)427 2923 y
+f(not)h(p)r(ossible.)259 5494 y Fd(op)s(er)427 5593 y
Fi(The)38 b(b)r(o)r(olean)f(op)r(erator)f(with)i(whic)n(h)g(to)f(com)n
(bine)h(the)g(t)n(w)n(o)f(Regions.)66 b(This)37 b(m)n(ust)h(b)r(e)g
-(one)g(of)f(the)427 3022 y(sym)n(b)r(olic)27 b(constan)n(ts)g(AST)p
+(one)g(of)f(the)427 5693 y(sym)n(b)r(olic)27 b(constan)n(ts)g(AST)p
Ft(__)p Fi(AND,)h(AST)p Ft(__)p Fi(OR)f(or)g(AST)p Ft(__)p
-Fi(X)n(OR.)259 3158 y Fd(options)427 3257 y Fi(P)n(oin)n(ter)g(to)h(a)g
-(n)n(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 3357 y(assignmen)n(ts)36
-b(to)h(b)r(e)g(used)g(for)f(initialising)h(the)g(new)g(CmpRegion.)64
-b(The)37 b(syn)n(tax)f(used)h(is)g(iden)n(tical)427 3457
-y(to)29 b(that)h(for)f(the)g(astSet)g(function)h(and)f(ma)n(y)g
+Fi(X)n(OR.)p eop end
+%%Page: 210 220
+TeXDict begin 210 219 bop 0 52 a FF(210)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(options)427
+451 y Fi(P)n(oin)n(ter)d(to)h(a)g(n)n(ull-terminated)g(string)f(con)n
+(taining)g(an)h(optional)g(comma-separated)e(list)i(of)g(attribute)427
+551 y(assignmen)n(ts)36 b(to)h(b)r(e)g(used)g(for)f(initialising)h(the)
+g(new)g(CmpRegion.)64 b(The)37 b(syn)n(tax)f(used)h(is)g(iden)n(tical)
+427 650 y(to)29 b(that)h(for)f(the)g(astSet)g(function)h(and)f(ma)n(y)g
(include)g Ft(")p Fi(prin)n(tf)p Ft(")g Fi(format)g(sp)r(eci\014ers)f
(iden)n(ti\014ed)i(b)n(y)f Ft(")p Fi(\045)p Ft(")427
-3556 y Fi(sym)n(b)r(ols)e(in)h(the)g(normal)f(w)n(a)n(y)-7
-b(.)259 3692 y Fd(...)427 3792 y Fi(If)38 b(the)g Ft(")p
+750 y Fi(sym)n(b)r(ols)e(in)h(the)g(normal)f(w)n(a)n(y)-7
+b(.)259 885 y Fd(...)427 985 y Fi(If)38 b(the)g Ft(")p
Fi(options)p Ft(")e Fi(string)h(con)n(tains)f Ft(")p
Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g
-(list)h(of)f(additional)427 3891 y(argumen)n(ts)26 b(ma)n(y)h(follo)n
+(list)h(of)f(additional)427 1084 y(argumen)n(ts)26 b(ma)n(y)h(follo)n
(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5 b(alues)27
b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)37
-b(The)427 3991 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+b(The)427 1184 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 4090 y Fi(function\).)0
-4258 y Fd(Returned)32 b(V)-8 b(alue:)259 4400 y(astCmpRegion\(\))427
-4499 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(CmpRegion.)0
-4667 y Fd(Notes:)340 4955 y Fh(\017)45 b Fi(If)35 b(one)f(of)g(the)h
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 1283 y Fi(function\).)0
+1450 y Fd(Returned)32 b(V)-8 b(alue:)259 1591 y(astCmpRegion\(\))427
+1691 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(CmpRegion.)0
+1858 y Fd(Notes:)340 2145 y Fh(\017)45 b Fi(If)35 b(one)f(of)g(the)h
(supplied)g(Regions)e(has)h(an)g(asso)r(ciated)f(uncertain)n(t)n(y)-7
b(,)35 b(that)g(uncertain)n(t)n(y)e(will)i(also)e(b)r(e)427
-5054 y(used)h(for)f(the)h(returned)f(CmpRegion.)55 b(If)34
+2245 y(used)h(for)f(the)h(returned)f(CmpRegion.)55 b(If)34
b(b)r(oth)g(supplied)g(Regions)e(ha)n(v)n(e)h(asso)r(ciated)f
-(uncertain)n(ties,)427 5154 y(the)c(uncertain)n(t)n(y)f(asso)r(ciated)f
+(uncertain)n(ties,)427 2344 y(the)c(uncertain)n(t)n(y)f(asso)r(ciated)f
(with)i(the)g(\014rst)g(Region)f(will)g(b)r(e)h(used)g(for)f(the)h
-(returned)f(CmpRegion.)340 5289 y Fh(\017)45 b Fi(Deep)22
+(returned)f(CmpRegion.)340 2479 y Fh(\017)45 b Fi(Deep)22
b(copies)f(are)f(tak)n(en)h(of)g(the)h(supplied)g(Regions.)33
b(This)22 b(means)f(that)g(an)n(y)g(subsequen)n(t)g(c)n(hanges)f(made)
-427 5389 y(to)26 b(the)g(comp)r(onen)n(t)g(Regions)f(using)g(the)i
+427 2579 y(to)26 b(the)g(comp)r(onen)n(t)g(Regions)f(using)g(the)i
(supplied)f(p)r(oin)n(ters)f(will)h(ha)n(v)n(e)f(no)h(e\013ect)g(on)g
-(the)g(CmpRegion.)340 5525 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+(the)g(CmpRegion.)340 2714 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 5624 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p eop end
-%%Page: 210 220
-TeXDict begin 210 219 bop 0 52 a FF(210)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 483 a Fz(astColumnName)190 b Fe(Get)38 b(the)h(name)f(of)g(the)h
-(column)1196 583 y(at)f(a)g(giv)m(en)g(index)g(within)f(the)1748
-697 y(T)-10 b(able)2802 483 y Fz(astColumnName)0 871
+427 2814 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 3018 3780 12 v 0 3150
+a Fz(astColumnName)190 b Fe(Get)38 b(the)h(name)f(of)g(the)h(column)
+1196 3249 y(at)f(a)g(giv)m(en)g(index)g(within)f(the)1748
+3364 y(T)-10 b(able)2802 3150 y Fz(astColumnName)0 3534
y Fd(Description:)44 b Fi(This)23 b(function)h(returns)e(a)g(string)h
(holding)f(the)h(name)g(of)g(the)g(column)g(with)h(the)f(giv)n(en)f
-(index)h(within)227 971 y(the)28 b(T)-7 b(able.)227 1099
-y(This)29 b(function)h(is)f(in)n(tended)g(primarily)f(as)g(a)h(means)f
-(of)h(iterating)g(round)f(all)h(the)g(columns)g(in)g(a)g(T)-7
-b(able.)40 b(F)-7 b(or)227 1199 y(this)28 b(purp)r(ose,)f(the)h(n)n(um)
+(index)h(within)227 3634 y(the)28 b(T)-7 b(able.)227
+3761 y(This)29 b(function)h(is)f(in)n(tended)g(primarily)f(as)g(a)h
+(means)f(of)h(iterating)g(round)f(all)h(the)g(columns)g(in)g(a)g(T)-7
+b(able.)40 b(F)-7 b(or)227 3860 y(this)28 b(purp)r(ose,)f(the)h(n)n(um)
n(b)r(er)g(of)f(columns)h(in)g(the)g(T)-7 b(able)27 b(is)g(giv)n(en)g
(b)n(y)h(the)g(Ncolumn)f(attribute)h(of)g(the)g(T)-7
-b(able.)227 1298 y(This)26 b(function)h(could)f(then)g(b)r(e)h(called)f
+b(able.)227 3960 y(This)26 b(function)h(could)f(then)g(b)r(e)h(called)f
(in)g(a)g(lo)r(op,)g(with)g(the)h(index)f(v)-5 b(alue)26
-b(going)f(from)g(zero)g(to)h(one)g(less)f(than)227 1398
-y(Ncolumn.)227 1527 y(Note,)h(the)f(index)h(asso)r(ciated)d(with)j(a)f
+b(going)f(from)g(zero)g(to)h(one)g(less)f(than)227 4060
+y(Ncolumn.)227 4186 y(Note,)h(the)f(index)h(asso)r(ciated)d(with)j(a)f
(column)g(decreases)e(monotonically)h(with)i(the)f(age)f(of)h(the)h
-(column:)35 b(the)227 1626 y(oldest)25 b(Column)g(in)h(the)f(T)-7
+(column:)35 b(the)227 4286 y(oldest)25 b(Column)g(in)h(the)f(T)-7
b(able)25 b(will)g(ha)n(v)n(e)f(index)h(one,)h(and)f(the)g(Column)g
(added)g(most)g(recen)n(tly)f(to)h(the)h(T)-7 b(able)227
-1726 y(will)28 b(ha)n(v)n(e)f(the)g(largest)g(index.)0
-1884 y Fd(Synopsis:)121 b Ft(const)41 b(char)h Fh(\003)p
+4386 y(will)28 b(ha)n(v)n(e)f(the)g(largest)g(index.)0
+4540 y Fd(Synopsis:)121 b Ft(const)41 b(char)h Fh(\003)p
Ft(astColumnName\()c(AstTable)i Fh(\003)p Ft(this,)h(int)h(index)g(\))0
-2041 y Fd(P)m(arameters:)259 2186 y(this)427 2285 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(T)-7 b(able.)259 2422 y Fd(index)427 2522
+4694 y Fd(P)m(arameters:)259 4835 y(this)427 4935 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(T)-7 b(able.)259 5070 y Fd(index)427 5170
y Fi(The)32 b(index)f(in)n(to)g(the)h(list)g(of)f(columns.)48
b(The)31 b(\014rst)g(column)h(has)e(index)i(one,)g(and)f(the)h(last)f
-(has)g(index)427 2622 y Ft(")p Fi(Ncolumn)p Ft(")p Fi(.)0
-2792 y Fd(Returned)h(V)-8 b(alue:)259 2936 y(astColumnName\(\))427
-3036 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(a)f(n)n(ull-terminated)g(string)g
-(con)n(taining)g(the)h(upp)r(er)g(case)e(column)i(name.)0
-3206 y Fd(Notes:)340 3497 y Fh(\017)45 b Fi(The)36 b(returned)g(p)r
-(oin)n(ter)g(is)g(guaran)n(teed)e(to)i(remain)g(v)-5
-b(alid)36 b(and)g(the)g(string)g(to)g(whic)n(h)g(it)g(p)r(oin)n(ts)g
-(will)427 3596 y(not)c(b)r(e)g(o)n(v)n(er-written)e(for)i(a)f(total)h
-(of)g(50)f(successiv)n(e)f(in)n(v)n(o)r(cations)g(of)i(this)g
-(function.)51 b(After)32 b(this,)h(the)427 3696 y(memory)27
-b(con)n(taining)f(the)i(string)f(ma)n(y)f(b)r(e)i(re-used,)e(so)h(a)g
-(cop)n(y)f(of)i(the)f(string)g(should)g(b)r(e)h(made)f(if)h(it)g(is)427
-3795 y(needed)g(for)f(longer)f(than)i(this.)340 3932
-y Fh(\017)45 b Fi(A)26 b(NULL)g(p)r(oin)n(ter)e(will)i(b)r(e)f
+(has)g(index)427 5269 y Ft(")p Fi(Ncolumn)p Ft(")p Fi(.)0
+5436 y Fd(Returned)h(V)-8 b(alue:)259 5577 y(astColumnName\(\))427
+5677 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(a)f(n)n(ull-terminated)g(string)g
+(con)n(taining)g(the)h(upp)r(er)g(case)e(column)i(name.)p
+eop end
+%%Page: 211 221
+TeXDict begin 211 220 bop 3643 52 a FF(211)0 351 y Fd(Notes:)340
+638 y Fh(\017)45 b Fi(The)36 b(returned)g(p)r(oin)n(ter)g(is)g(guaran)n
+(teed)e(to)i(remain)g(v)-5 b(alid)36 b(and)g(the)g(string)g(to)g(whic)n
+(h)g(it)g(p)r(oin)n(ts)g(will)427 738 y(not)c(b)r(e)g(o)n(v)n
+(er-written)e(for)i(a)f(total)h(of)g(50)f(successiv)n(e)f(in)n(v)n(o)r
+(cations)g(of)i(this)g(function.)51 b(After)32 b(this,)h(the)427
+837 y(memory)27 b(con)n(taining)f(the)i(string)f(ma)n(y)f(b)r(e)i
+(re-used,)e(so)h(a)g(cop)n(y)f(of)i(the)f(string)g(should)g(b)r(e)h
+(made)f(if)h(it)g(is)427 937 y(needed)g(for)f(longer)f(than)i(this.)340
+1072 y Fh(\017)45 b Fi(A)26 b(NULL)g(p)r(oin)n(ter)e(will)i(b)r(e)f
(returned)g(if)h(this)g(function)f(is)h(in)n(v)n(ok)n(ed)d(with)j(the)g
-(AST)f(error)f(status)h(set,)g(or)427 4032 y(if)j(it)g(should)g(fail)f
-(for)h(an)n(y)e(reason.)p 0 4239 V 0 4371 a Fz(astColumnNull)207
-b Fe(Get)38 b(or)g(set)h(the)g(n)m(ull)f(v)-7 b(alue)38
-b(for)g(an)1096 4471 y(in)m(teger)f(column)g(of)i(a)f(FITS)h(table)2891
-4371 y Fz(astColumnNull)0 4668 y Fd(Description:)44 b
+(AST)f(error)f(status)h(set,)g(or)427 1171 y(if)j(it)g(should)g(fail)f
+(for)h(an)n(y)e(reason.)p 0 1375 3780 12 v 0 1507 a Fz(astColumnNull)
+207 b Fe(Get)38 b(or)g(set)h(the)g(n)m(ull)f(v)-7 b(alue)38
+b(for)g(an)1096 1606 y(in)m(teger)f(column)g(of)i(a)f(FITS)h(table)2891
+1507 y Fz(astColumnNull)0 1799 y Fd(Description:)44 b
Fi(This)37 b(function)h(allo)n(ws)e(a)g(n)n(ull)i(v)-5
b(alue)37 b(to)g(b)r(e)g(stored)f(with)i(a)f(named)g(in)n(teger-v)-5
-b(alued)35 b(column)i(in)227 4767 y(a)g(FitsT)-7 b(able.)65
+b(alued)35 b(column)i(in)227 1899 y(a)g(FitsT)-7 b(able.)65
b(The)37 b(supplied)g(n)n(ull)g(v)-5 b(alue)37 b(is)g(assigned)f(to)h
(the)g(TNULLn)g(k)n(eyw)n(ord)f(in)h(the)g(FITS)g(header)227
-4867 y(asso)r(ciated)28 b(with)i(the)f(FitsT)-7 b(able.)41
+1999 y(asso)r(ciated)28 b(with)i(the)f(FitsT)-7 b(able.)41
b(A)30 b(v)-5 b(alue)29 b(in)g(the)g(named)g(column)g(is)g(then)h
(considered)e(to)h(b)r(e)g(n)n(ull)h(if)f(1\))g(it)227
-4967 y(equals)e(the)h(n)n(ull)g(v)-5 b(alue)27 b(supplied)h(to)g(this)g
+2098 y(equals)e(the)h(n)n(ull)g(v)-5 b(alue)27 b(supplied)h(to)g(this)g
(function,)g(or)f(2\))g(no)g(v)-5 b(alue)28 b(has)f(y)n(et)g(b)r(een)h
-(stored)f(in)h(the)g(cell.)227 5095 y(As)k(w)n(ell)g(as)f(setting)h(a)f
+(stored)f(in)h(the)g(cell.)227 2225 y(As)k(w)n(ell)g(as)f(setting)h(a)f
(new)h(n)n(ull)g(v)-5 b(alue,)33 b(this)f(function)h(also)e(returns)g
(the)h(previous)f(n)n(ull)h(v)-5 b(alue.)50 b(If)32 b(no)f(n)n(ull)227
-5195 y(v)-5 b(alue)24 b(has)f(b)r(een)g(set)h(previously)-7
+2324 y(v)-5 b(alue)24 b(has)f(b)r(een)g(set)h(previously)-7
b(,)23 b(a)g(default)h(v)-5 b(alue)23 b(will)h(b)r(e)g(returned.)35
b(This)24 b(default)f(will)h(b)r(e)g(an)f(in)n(teger)g(v)-5
-b(alue)227 5295 y(that)28 b(do)r(es)g(not)g(curren)n(tly)e(o)r(ccur)i
+b(alue)227 2424 y(that)28 b(do)r(es)g(not)g(curren)n(tly)e(o)r(ccur)i
(an)n(ywhere)e(within)i(the)h(named)e(column.)38 b(If)28
b(no)f(suc)n(h)h(v)-5 b(alue)28 b(can)f(b)r(e)h(found,)227
-5394 y(what)e(happ)r(ens)g(dep)r(ends)g(on)g(whether)g(the)g(column)g
+2524 y(what)e(happ)r(ens)g(dep)r(ends)g(on)g(whether)g(the)g(column)g
(con)n(tains)f(an)n(y)g(cells)h(in)g(whic)n(h)g(no)f(v)-5
-b(alues)26 b(ha)n(v)n(e)f(y)n(et)g(b)r(een)227 5494 y(stored.)40
+b(alues)26 b(ha)n(v)n(e)f(y)n(et)g(b)r(een)227 2623 y(stored.)40
b(If)29 b(so,)f(an)h(error)d(will)j(b)r(e)g(rep)r(orted.)40
b(Otherwise)28 b(\(i.e.)40 b(if)29 b(there)g(are)f(no)g(n)n(ull)h(v)-5
-b(alues)28 b(in)h(the)g(column\),)227 5593 y(an)d(arbitrary)e(v)-5
+b(alues)28 b(in)h(the)g(column\),)227 2723 y(an)d(arbitrary)e(v)-5
b(alue)26 b(of)g(zero)f(will)i(b)r(e)f(returned)g(as)f(the)i(function)g
(v)-5 b(alue,)26 b(and)g(no)g(TNULLn)h(k)n(eyw)n(ord)d(will)i(b)r(e)227
-5693 y(stored)h(in)h(the)g(FITS)g(header.)p eop end
-%%Page: 211 221
-TeXDict begin 211 220 bop 3643 52 a FF(211)227 351 y
-Fi(A)29 b(\015ag)e(is)h(returned)g(indicating)g(if)h(the)g(returned)e
-(n)n(ull)i(v)-5 b(alue)28 b(w)n(as)f(set)h(explicitly)h(b)n(y)e(a)h
-(previous)f(call)h(to)g(this)227 451 y(function,)h(or)d(is)i(a)f
-(default)h(v)-5 b(alue.)227 572 y(A)25 b(second)e(\015ag)g(is)h
-(returned)g(indicating)g(if)g(the)g(named)g(column)g(con)n(tains)f(an)n
-(y)h(n)n(ull)g(v)-5 b(alues)23 b(\(i.e.)36 b(v)-5 b(alues)24
-b(equal)227 671 y(to)k(the)g(supplied)g(n)n(ull)f(v)-5
-b(alue,)28 b(or)f(cells)g(to)g(whic)n(h)h(no)f(v)-5 b(alue)28
-b(has)f(y)n(et)g(b)r(een)h(assigned\).)0 813 y Fd(Synopsis:)121
-b Ft(int)42 b(astColumnNull\()c(AstFitsTable)h Fh(\003)p
-Ft(this,)i(const)g(char)h Fh(\003)p Ft(column,)e(int)j(set,)f(int)g
-(newval,)227 913 y(int)h Fh(\003)p Ft(wasset,)d(int)i
-Fh(\003)p Ft(hasnull)e(\))0 1055 y Fd(P)m(arameters:)259
-1183 y(this)427 1283 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(T)-7
-b(able.)259 1408 y Fd(column)427 1508 y Fi(The)28 b(c)n(haracter)d
-(string)i(holding)h(the)g(name)f(of)g(the)h(column.)37
-b(T)-7 b(railing)27 b(spaces)g(are)f(ignored.)259 1633
-y Fd(set)427 1733 y Fi(If)39 b(non-zero,)g(the)f(v)-5
+2823 y(stored)h(in)h(the)g(FITS)g(header.)227 2949 y(A)h(\015ag)e(is)h
+(returned)g(indicating)g(if)h(the)g(returned)e(n)n(ull)i(v)-5
+b(alue)28 b(w)n(as)f(set)h(explicitly)h(b)n(y)e(a)h(previous)f(call)h
+(to)g(this)227 3049 y(function,)h(or)d(is)i(a)f(default)h(v)-5
+b(alue.)227 3176 y(A)25 b(second)e(\015ag)g(is)h(returned)g(indicating)
+g(if)g(the)g(named)g(column)g(con)n(tains)f(an)n(y)h(n)n(ull)g(v)-5
+b(alues)23 b(\(i.e.)36 b(v)-5 b(alues)24 b(equal)227
+3275 y(to)k(the)g(supplied)g(n)n(ull)f(v)-5 b(alue,)28
+b(or)f(cells)g(to)g(whic)n(h)h(no)f(v)-5 b(alue)28 b(has)f(y)n(et)g(b)r
+(een)h(assigned\).)0 3429 y Fd(Synopsis:)121 b Ft(int)42
+b(astColumnNull\()c(AstFitsTable)h Fh(\003)p Ft(this,)i(const)g(char)h
+Fh(\003)p Ft(column,)e(int)j(set,)f(int)g(newval,)227
+3528 y(int)h Fh(\003)p Ft(wasset,)d(int)i Fh(\003)p Ft(hasnull)e(\))0
+3682 y Fd(P)m(arameters:)259 3823 y(this)427 3922 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(T)-7 b(able.)259 4057 y Fd(column)427 4157
+y Fi(The)28 b(c)n(haracter)d(string)i(holding)h(the)g(name)f(of)g(the)h
+(column.)37 b(T)-7 b(railing)27 b(spaces)g(are)f(ignored.)259
+4292 y Fd(set)427 4392 y Fi(If)39 b(non-zero,)g(the)f(v)-5
b(alue)38 b(supplied)g(for)g(parameter)f Ft(")p Fi(newv)-5
b(al)p Ft(")37 b Fi(will)h(b)r(e)g(stored)f(as)h(the)g(curren)n(t)f(n)n
-(ull)427 1832 y(v)-5 b(alue,)30 b(replacing)e(an)n(y)g(v)-5
+(ull)427 4491 y(v)-5 b(alue,)30 b(replacing)e(an)n(y)g(v)-5
b(alue)30 b(set)f(b)n(y)g(a)g(previous)f(call)h(to)g(this)h(function.)
42 b(If)30 b(zero,)e(the)i(v)-5 b(alue)29 b(supplied)427
-1932 y(for)e(parameter)f Ft(")p Fi(newv)-5 b(al)p Ft(")27
+4591 y(for)e(parameter)f Ft(")p Fi(newv)-5 b(al)p Ft(")27
b Fi(is)h(ignored)e(and)h(the)h(curren)n(t)f(n)n(ull)h(v)-5
-b(alue)27 b(is)h(left)g(unc)n(hanged.)259 2057 y Fd(newv)-5
-b(al)427 2157 y Fi(The)28 b(new)g(n)n(ull)g(v)-5 b(alue)28
+b(alue)27 b(is)h(left)g(unc)n(hanged.)259 4726 y Fd(newv)-5
+b(al)427 4825 y Fi(The)28 b(new)g(n)n(ull)g(v)-5 b(alue)28
b(to)f(use.)38 b(Ignored)27 b(if)h Ft(")p Fi(set)p Ft(")f
Fi(is)h(zero.)36 b(An)28 b(error)e(will)i(b)r(e)h(rep)r(orted)e(if)h
-(the)g(supplied)427 2257 y(v)-5 b(alue)34 b(is)g(outside)g(the)h(range)
+(the)g(supplied)427 4925 y(v)-5 b(alue)34 b(is)g(outside)g(the)h(range)
d(of)i(v)-5 b(alues)34 b(that)h(can)e(b)r(e)i(stored)e(in)h(the)h(in)n
-(teger)e(data)h(t)n(yp)r(e)g(asso)r(ciated)427 2356 y(with)28
-b(the)g(column.)259 2481 y Fd(w)m(asset)427 2581 y Fi(P)n(oin)n(ter)e
+(teger)e(data)h(t)n(yp)r(e)g(asso)r(ciated)427 5025 y(with)28
+b(the)g(column.)259 5160 y Fd(w)m(asset)427 5259 y Fi(P)n(oin)n(ter)e
(to)i(an)f(in)n(t)h(that)g(will)f(b)r(e)h(returned)f(non-zero)f(if)i
(the)g(returned)g(n)n(ull)f(v)-5 b(alue)28 b(w)n(as)e(set)i(previously)
-427 2681 y(via)j(an)g(earlier)e(in)n(v)n(o)r(cation)h(of)h(this)h
+427 5359 y(via)j(an)g(earlier)e(in)n(v)n(o)r(cation)h(of)h(this)h
(function.)48 b(Zero)29 b(is)i(returned)g(otherwise.)47
-b(If)31 b(the)h(named)f(column)427 2780 y(do)r(es)d(not)f(exist,)h(or)e
+b(If)31 b(the)h(named)f(column)427 5458 y(do)r(es)d(not)f(exist,)h(or)e
(an)i(error)d(o)r(ccurs,)i(a)g(v)-5 b(alue)28 b(of)f(zero)g(is)g
-(returned.)259 2906 y Fd(hasn)m(ull)427 3005 y Fi(P)n(oin)n(ter)j(to)i
+(returned.)259 5593 y Fd(hasn)m(ull)427 5693 y Fi(P)n(oin)n(ter)j(to)i
(an)g(in)n(t)g(that)g(will)g(b)r(e)g(returned)g(non-zero)e(if)i(and)g
-(only)f(if)i(the)f(named)g(column)g(curren)n(tly)427
-3105 y(con)n(tains)c(an)n(y)f(v)-5 b(alues)28 b(equal)f(to)i(the)f(n)n
-(ull)g(v)-5 b(alue)28 b(on)g(exit)h(\(i.e.)39 b Ft(")p
-Fi(newv)-5 b(al)p Ft(")27 b Fi(if)i Ft(")p Fi(set)p Ft(")e
-Fi(is)h(non-zero,)f(or)g(the)427 3204 y(returned)k(function)h(v)-5
-b(alue)31 b(otherwise\),)h(or)e(con)n(tains)h(an)n(y)f(empt)n(y)h
-(cells.)48 b(If)32 b(the)f(named)h(column)f(do)r(es)427
-3304 y(not)g(exist,)h(or)f(an)g(error)e(o)r(ccurs,)i(a)g(v)-5
-b(alue)31 b(of)g(zero)f(is)h(returned.)47 b(If)32 b(a)e(NULL)i(p)r(oin)
-n(ter)f(is)g(supplied)g(for)427 3404 y Ft(")p Fi(hasn)n(ull)p
-Ft(")p Fi(,)c(no)g(c)n(hec)n(k)g(on)g(the)h(presence)f(of)g(n)n(ull)h
-(v)-5 b(alues)27 b(will)h(b)r(e)g(p)r(erformed.)0 3558
-y Fd(Returned)k(V)-8 b(alue:)259 3687 y(astColumnNull\(\))427
-3786 y Fi(The)33 b(n)n(ull)g(v)-5 b(alue)32 b(that)h(w)n(as)f(in)g(use)
-h(on)f(en)n(try)g(to)g(this)h(function.)53 b(If)33 b(a)f(n)n(ull)h(v)-5
-b(alue)32 b(has)g(b)r(een)h(set)g(b)n(y)f(a)427 3886
-y(previous)c(in)n(v)n(o)r(cation)g(of)h(this)h(function,)g(it)f(will)h
-(b)r(e)f(returned.)41 b(Otherwise,)29 b(if)h Ft(")p Fi(set)p
-Ft(")e Fi(is)h(non-zero,)f(the)427 3986 y(supplied)k
-Ft(")p Fi(newv)-5 b(al)p Ft(")31 b Fi(v)-5 b(alue)32
-b(is)f(returned.)49 b(Otherwise,)32 b(a)f(default)h(v)-5
-b(alue)32 b(is)f(c)n(hosen)g(\(if)i(p)r(ossible\))e(that)427
-4085 y(do)r(es)22 b(not)h(curren)n(tly)e(o)r(ccur)h(in)h(the)g(named)f
-(column.)35 b(If)23 b(all)f(a)n(v)-5 b(ailable)21 b(v)-5
-b(alues)23 b(are)e(in)i(use)f(in)h(the)g(column,)427
-4185 y(an)j(error)e(is)h(rep)r(orted)g(if)i(and)e(only)g(if)i(the)f
+(only)f(if)i(the)f(named)g(column)g(curren)n(tly)p eop
+end
+%%Page: 212 222
+TeXDict begin 212 221 bop 0 52 a FF(212)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)427 351 y Fi(con)n(tains)e(an)n(y)f
+(v)-5 b(alues)28 b(equal)f(to)i(the)f(n)n(ull)g(v)-5
+b(alue)28 b(on)g(exit)h(\(i.e.)39 b Ft(")p Fi(newv)-5
+b(al)p Ft(")27 b Fi(if)i Ft(")p Fi(set)p Ft(")e Fi(is)h(non-zero,)f(or)
+g(the)427 451 y(returned)k(function)h(v)-5 b(alue)31
+b(otherwise\),)h(or)e(con)n(tains)h(an)n(y)f(empt)n(y)h(cells.)48
+b(If)32 b(the)f(named)h(column)f(do)r(es)427 551 y(not)g(exist,)h(or)f
+(an)g(error)e(o)r(ccurs,)i(a)g(v)-5 b(alue)31 b(of)g(zero)f(is)h
+(returned.)47 b(If)32 b(a)e(NULL)i(p)r(oin)n(ter)f(is)g(supplied)g(for)
+427 650 y Ft(")p Fi(hasn)n(ull)p Ft(")p Fi(,)c(no)g(c)n(hec)n(k)g(on)g
+(the)h(presence)f(of)g(n)n(ull)h(v)-5 b(alues)27 b(will)h(b)r(e)g(p)r
+(erformed.)0 826 y Fd(Returned)k(V)-8 b(alue:)259 977
+y(astColumnNull\(\))427 1077 y Fi(The)33 b(n)n(ull)g(v)-5
+b(alue)32 b(that)h(w)n(as)f(in)g(use)h(on)f(en)n(try)g(to)g(this)h
+(function.)53 b(If)33 b(a)f(n)n(ull)h(v)-5 b(alue)32
+b(has)g(b)r(een)h(set)g(b)n(y)f(a)427 1177 y(previous)c(in)n(v)n(o)r
+(cation)g(of)h(this)h(function,)g(it)f(will)h(b)r(e)f(returned.)41
+b(Otherwise,)29 b(if)h Ft(")p Fi(set)p Ft(")e Fi(is)h(non-zero,)f(the)
+427 1276 y(supplied)k Ft(")p Fi(newv)-5 b(al)p Ft(")31
+b Fi(v)-5 b(alue)32 b(is)f(returned.)49 b(Otherwise,)32
+b(a)f(default)h(v)-5 b(alue)32 b(is)f(c)n(hosen)g(\(if)i(p)r(ossible\))
+e(that)427 1376 y(do)r(es)22 b(not)h(curren)n(tly)e(o)r(ccur)h(in)h
+(the)g(named)f(column.)35 b(If)23 b(all)f(a)n(v)-5 b(ailable)21
+b(v)-5 b(alues)23 b(are)e(in)i(use)f(in)h(the)g(column,)427
+1476 y(an)j(error)e(is)h(rep)r(orted)g(if)i(and)e(only)g(if)i(the)f
(column)g(con)n(tains)e(an)n(y)h(empt)n(y)h(cells.)36
-b(Otherwise,)26 b(a)f(v)-5 b(alue)26 b(of)427 4285 y(zero)j(is)g
+b(Otherwise,)26 b(a)f(v)-5 b(alue)26 b(of)427 1575 y(zero)j(is)g
(returned.)43 b(A)30 b(v)-5 b(alue)29 b(of)h(zero)f(is)g(also)g
(returned)g(if)h(the)g(named)g(column)f(do)r(es)g(not)h(exist,)g(or)f
-(an)427 4384 y(error)d(o)r(ccurs.)0 4538 y Fd(Notes:)340
-4813 y Fh(\017)45 b Fi(The)33 b(FITS)g(binary)f(table)h(de\014nition)g
+(an)427 1675 y(error)d(o)r(ccurs.)0 1851 y Fd(Notes:)340
+2148 y Fh(\017)45 b Fi(The)33 b(FITS)g(binary)f(table)h(de\014nition)g
(allo)n(ws)f(only)g(in)n(teger-v)-5 b(alued)32 b(columns)g(to)h(ha)n(v)
-n(e)e(an)i(asso)r(ciated)427 4913 y(n)n(ull)28 b(v)-5
+n(e)e(an)i(asso)r(ciated)427 2248 y(n)n(ull)28 b(v)-5
b(alue.)37 b(This)27 b(routine)h(will)f(return)g(without)i(action)e(if)
h(the)g(column)f(is)h(not)f(in)n(teger-v)-5 b(alued.)p
-0 5097 3780 12 v 0 5229 a Fz(astColumnShap)t(e)266 b
-Fe(Returns)39 b(the)f(shap)s(e)h(of)g(the)1224 5343 y(v)-7
-b(alues)39 b(in)g(a)f(named)g(column)2791 5229 y Fz(astColumnShap)t(e)0
-5494 y Fd(Description:)44 b Fi(This)26 b(function)g(returns)f(the)g(n)n
+0 2461 3780 12 v 0 2593 a Fz(astColumnShap)t(e)266 b
+Fe(Returns)39 b(the)f(shap)s(e)h(of)g(the)1224 2708 y(v)-7
+b(alues)39 b(in)g(a)f(named)g(column)2791 2593 y Fz(astColumnShap)t(e)0
+2888 y Fd(Description:)44 b Fi(This)26 b(function)g(returns)f(the)g(n)n
(um)n(b)r(er)h(of)f(dimensions)g(spaned)g(b)n(y)g(eac)n(h)g(v)-5
-b(alue)25 b(in)h(a)f(named)h(column)227 5593 y(of)33
+b(alue)25 b(in)h(a)f(named)h(column)227 2987 y(of)33
b(a)f(T)-7 b(able,)33 b(together)f(with)h(the)f(length)h(of)f(eac)n(h)g
(dimension.)51 b(These)32 b(are)g(the)h(v)-5 b(alues)32
-b(supplied)h(when)f(the)227 5693 y(column)c(w)n(as)e(created)h(using)g
-(astAddColumn.)p eop end
-%%Page: 212 222
-TeXDict begin 212 221 bop 0 52 a FF(212)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Synopsis:)121
-b Ft(void)42 b(astColumnShape\()37 b(AstTable)j Fh(\003)p
-Ft(this,)h(const)h(char)g Fh(\003)p Ft(column,)e(int)i(mxdim,)g(int)g
-Fh(\003)p Ft(ndim,)227 451 y(int)h Fh(\003)p Ft(dims)e(\))0
-633 y Fd(P)m(arameters:)259 801 y(this)427 901 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(T)-7 b(able.)259 1050 y Fd(column)427 1149
+b(supplied)h(when)f(the)227 3087 y(column)c(w)n(as)e(created)h(using)g
+(astAddColumn.)0 3251 y Fd(Synopsis:)121 b Ft(void)42
+b(astColumnShape\()37 b(AstTable)j Fh(\003)p Ft(this,)h(const)h(char)g
+Fh(\003)p Ft(column,)e(int)i(mxdim,)g(int)g Fh(\003)p
+Ft(ndim,)227 3351 y(int)h Fh(\003)p Ft(dims)e(\))0 3514
+y Fd(P)m(arameters:)259 3665 y(this)427 3765 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(T)-7 b(able.)259 3905 y Fd(column)427 4005
y Fi(The)24 b(c)n(haracter)f(string)g(holding)h(the)g(upp)r(er)h(case)e
(name)h(of)g(the)h(column.)35 b(T)-7 b(railing)23 b(spaces)h(are)f
-(ignored.)259 1298 y Fd(mxdim)427 1398 y Fi(The)28 b(length)g(of)f(the)
-h Ft(")p Fi(dims)p Ft(")f Fi(arra)n(y)-7 b(.)259 1547
-y Fd(ndim)427 1646 y Fi(P)n(oin)n(ter)20 b(to)h(an)h(in)n(t)f(in)h
+(ignored.)259 4145 y Fd(mxdim)427 4244 y Fi(The)28 b(length)g(of)f(the)
+h Ft(")p Fi(dims)p Ft(")f Fi(arra)n(y)-7 b(.)259 4384
+y Fd(ndim)427 4484 y Fi(P)n(oin)n(ter)20 b(to)h(an)h(in)n(t)f(in)h
(whic)n(h)g(to)f(return)g(the)h(n)n(um)n(b)r(er)f(of)g(dimensions)h
(spanned)f(b)n(y)g(v)-5 b(alues)21 b(in)h(the)g(named)427
-1746 y(column.)37 b(This)28 b(will)g(b)r(e)g(zero)e(if)i(the)g(column)g
-(con)n(tains)e(scalar)g(v)-5 b(alues.)259 1895 y Fd(dims)427
-1995 y Fi(P)n(oin)n(ter)35 b(to)h(an)g(arra)n(y)d(in)k(whic)n(h)f(to)g
+4584 y(column.)37 b(This)28 b(will)g(b)r(e)g(zero)e(if)i(the)g(column)g
+(con)n(tains)e(scalar)g(v)-5 b(alues.)259 4724 y Fd(dims)427
+4823 y Fi(P)n(oin)n(ter)35 b(to)h(an)g(arra)n(y)d(in)k(whic)n(h)f(to)g
(return)g(the)g(length)g(of)g(eac)n(h)g(dimension.)62
-b(An)n(y)36 b(excess)f(trailing)427 2094 y(elemen)n(ts)28
+b(An)n(y)36 b(excess)f(trailing)427 4923 y(elemen)n(ts)28
b(will)g(b)r(e)g(\014lled)g(with)g(the)g(v)-5 b(alue)27
-b(1.)0 2288 y Fd(Notes:)340 2603 y Fh(\017)45 b Fi(No)28
+b(1.)0 5099 y Fd(Notes:)340 5396 y Fh(\017)45 b Fi(No)28
b(error)e(is)j(rep)r(orted)e(if)i(the)f(requested)g(column)g(cannot)g
(b)r(e)g(found)h(in)f(the)h(giv)n(en)e(T)-7 b(able.)38
-b(A)29 b(v)-5 b(alue)28 b(of)427 2703 y(zero)f(is)g(returned)g(for)g
+b(A)29 b(v)-5 b(alue)28 b(of)427 5496 y(zero)f(is)g(returned)g(for)g
Ft(")p Fi(ndim)p Ft(")h Fi(and)f(the)h(supplied)g(v)-5
b(alues)27 b(in)h Ft(")p Fi(dims)p Ft(")f Fi(are)g(left)h(unc)n
-(hanged.)340 2852 y Fh(\017)45 b Fi(A)28 b(v)-5 b(alue)28
+(hanged.)340 5636 y Fh(\017)45 b Fi(A)28 b(v)-5 b(alue)28
b(of)f(zero)g(is)g(returned)g(for)g Ft(")p Fi(ndim)p
-Ft(")h Fi(if)g(an)f(error)f(o)r(ccurs.)p 0 3083 3780
-12 v 0 3215 a Fz(astColumnSize)200 b Fe(Get)39 b(the)f(n)m(um)m(b)s(er)
-g(of)h(b)m(ytes)f(needed)1152 3329 y(to)g(hold)g(a)g(full)g(column)g
-(of)g(data)2912 3215 y Fz(astColumnSize)0 3527 y Fd(Description:)44
+Ft(")h Fi(if)g(an)f(error)f(o)r(ccurs.)p eop end
+%%Page: 213 223
+TeXDict begin 213 222 bop 3643 52 a FF(213)p 0 351 3780
+12 v 0 483 a Fz(astColumnSize)200 b Fe(Get)39 b(the)f(n)m(um)m(b)s(er)g
+(of)h(b)m(ytes)f(needed)1152 598 y(to)g(hold)g(a)g(full)g(column)g(of)g
+(data)2912 483 y Fz(astColumnSize)0 769 y Fd(Description:)44
b Fi(This)37 b(function)g(returns)f(the)h(n)n(um)n(b)r(er)f(of)g(b)n
(ytes)g(of)h(memory)e(that)i(m)n(ust)g(b)r(e)g(allo)r(cated)e(prior)h
-(to)227 3627 y(retrieving)27 b(the)h(data)f(from)g(a)g(column)h(using)f
-(astGetColumnData.)0 3808 y Fd(Synopsis:)121 b Ft(size_t)41
+(to)227 869 y(retrieving)27 b(the)h(data)f(from)g(a)g(column)h(using)f
+(astGetColumnData.)0 1024 y Fd(Synopsis:)121 b Ft(size_t)41
b(astColumnSize\()d(AstFitsTable)g Fh(\003)p Ft(this,)j(const)h(char)g
Fh(\003)p Ft(column,)e(int)i Fh(\003)p Ft(hasnull)f(\))0
-3990 y Fd(P)m(arameters:)259 4159 y(this)427 4258 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(T)-7 b(able.)259 4407 y Fd(column)427 4507
+1180 y Fd(P)m(arameters:)259 1322 y(this)427 1422 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(T)-7 b(able.)259 1558 y Fd(column)427 1657
y Fi(The)28 b(c)n(haracter)d(string)i(holding)h(the)g(name)f(of)g(the)h
(column.)37 b(T)-7 b(railing)27 b(spaces)g(are)f(ignored.)0
-4701 y Fd(Returned)32 b(V)-8 b(alue:)259 4870 y(astColumnNull\(\))427
-4969 y Fi(The)28 b(n)n(um)n(b)r(er)f(of)h(b)n(ytes)f(required)g(to)g
-(store)g(the)h(column)f(data.)0 5163 y Fd(Notes:)340
-5478 y Fh(\017)45 b Fi(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)
+1825 y Fd(Returned)32 b(V)-8 b(alue:)259 1968 y(astColumnNull\(\))427
+2067 y Fi(The)28 b(n)n(um)n(b)r(er)f(of)h(b)n(ytes)f(required)g(to)g
+(store)g(the)h(column)f(data.)0 2235 y Fd(Notes:)340
+2524 y Fh(\017)45 b Fi(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)
h(the)g(named)f(column)h(do)r(es)f(not)h(exist)f(in)h(the)g(FitsT)-7
-b(able.)340 5627 y Fh(\017)45 b Fi(Zero)27 b(will)g(b)r(e)h(returned)g
+b(able.)340 2659 y Fh(\017)45 b Fi(Zero)27 b(will)g(b)r(e)h(returned)g
(as)f(the)h(function)g(v)-5 b(alue)27 b(in)h(an)f(error)f(o)r(ccurs.)p
-eop end
-%%Page: 213 223
-TeXDict begin 213 222 bop 3643 52 a FF(213)p 0 351 3780
-12 v 0 482 a Fz(astCon)l(v)l(ert)887 483 y Fe(Determine)38
+0 2865 V 0 2995 a Fz(astCon)l(v)l(ert)887 2996 y Fe(Determine)38
b(ho)m(w)g(to)g(con)m(v)m(ert)f(b)s(et)m(w)m(een)h(t)m(w)m(o)1404
-583 y(co)s(ordinate)f(systems)3138 482 y Fz(astCon)l(v)l(ert)0
-755 y Fd(Description:)44 b Fi(This)29 b(function)h(compares)d(t)n(w)n
+3096 y(co)s(ordinate)f(systems)3138 2995 y Fz(astCon)l(v)l(ert)0
+3291 y Fd(Description:)44 b Fi(This)29 b(function)h(compares)d(t)n(w)n
(o)h(F)-7 b(rames)28 b(and)h(determines)f(whether)h(it)g(is)g(p)r
-(ossible)f(to)h(con)n(v)n(ert)f(b)r(e-)227 855 y(t)n(w)n(een)c(the)h
+(ossible)f(to)h(con)n(v)n(ert)f(b)r(e-)227 3391 y(t)n(w)n(een)c(the)h
(co)r(ordinate)e(systems)g(whic)n(h)h(they)h(represen)n(t.)34
b(If)25 b(con)n(v)n(ersion)d(is)i(p)r(ossible,)g(it)h(returns)e(a)h(F)
--7 b(rameSet)227 955 y(whic)n(h)34 b(describ)r(es)f(the)h(con)n(v)n
+-7 b(rameSet)227 3490 y(whic)n(h)34 b(describ)r(es)f(the)h(con)n(v)n
(ersion)d(and)j(whic)n(h)f(ma)n(y)g(b)r(e)h(used)g(\(as)f(a)g
-(Mapping\))h(to)f(transform)g(co)r(ordinate)227 1054
-y(v)-5 b(alues)27 b(in)h(either)g(direction.)227 1175
+(Mapping\))h(to)f(transform)g(co)r(ordinate)227 3590
+y(v)-5 b(alues)27 b(in)h(either)g(direction.)227 3717
y(The)38 b(same)g(function)g(ma)n(y)g(also)e(b)r(e)j(used)f(to)g
(determine)g(ho)n(w)f(to)h(con)n(v)n(ert)f(b)r(et)n(w)n(een)g(t)n(w)n
-(o)h(F)-7 b(rameSets)37 b(\(or)227 1274 y(b)r(et)n(w)n(een)23
+(o)h(F)-7 b(rameSets)37 b(\(or)227 3817 y(b)r(et)n(w)n(een)23
b(a)g(F)-7 b(rame)22 b(and)h(a)f(F)-7 b(rameSet,)24 b(or)e(vice)g(v)n
(ersa\).)34 b(This)23 b(mo)r(de)g(is)g(in)n(tended)g(for)f(use)h(when)g
-(\(for)g(example\))227 1374 y(t)n(w)n(o)j(images)f(ha)n(v)n(e)g(b)r
+(\(for)g(example\))227 3917 y(t)n(w)n(o)j(images)f(ha)n(v)n(e)g(b)r
(een)i(calibrated)e(b)n(y)h(attac)n(hing)g(a)g(F)-7 b(rameSet)26
b(to)g(eac)n(h.)35 b(astCon)n(v)n(ert)25 b(migh)n(t)h(then)h(b)r(e)g
-(used)227 1474 y(to)g(searc)n(h)e(for)h(a)g(celestial)g(co)r(ordinate)f
+(used)227 4016 y(to)g(searc)n(h)e(for)h(a)g(celestial)g(co)r(ordinate)f
(system)i(that)f(b)r(oth)h(images)f(ha)n(v)n(e)f(in)i(common,)f(and)h
-(the)g(result)f(could)227 1573 y(then)36 b(b)r(e)f(used)g(to)g(con)n(v)
+(the)g(result)f(could)227 4116 y(then)36 b(b)r(e)f(used)g(to)g(con)n(v)
n(ert)f(b)r(et)n(w)n(een)h(the)g(pixel)g(co)r(ordinates)f(of)h(b)r(oth)
g(images)f({)h(ha)n(ving)f(e\013ectiv)n(ely)h(used)227
-1673 y(their)28 b(celestial)f(co)r(ordinate)f(systems)h(to)h(align)f
-(them.)227 1794 y(When)33 b(using)f(F)-7 b(rameSets,)33
+4215 y(their)28 b(celestial)f(co)r(ordinate)f(systems)h(to)h(align)f
+(them.)227 4343 y(When)33 b(using)f(F)-7 b(rameSets,)33
b(there)f(ma)n(y)f(b)r(e)i(more)e(than)h(one)g(p)r(ossible)g(in)n
-(termediate)f(co)r(ordinate)g(system)h(in)227 1893 y(whic)n(h)j(to)g(p)
+(termediate)f(co)r(ordinate)g(system)h(in)227 4443 y(whic)n(h)j(to)g(p)
r(erform)f(the)h(con)n(v)n(ersion)e(\(for)h(instance,)j(t)n(w)n(o)d(F)
-7 b(rameSets)34 b(migh)n(t)h(b)r(oth)g(ha)n(v)n(e)f(celestial)g(co)r
-(ordi-)227 1993 y(nates,)27 b(detector)g(co)r(ordinates,)g(pixel)g(co)r
+(ordi-)227 4542 y(nates,)27 b(detector)g(co)r(ordinates,)g(pixel)g(co)r
(ordinates,)f(etc.\).)38 b(A)27 b(comma-separated)e(list)j(of)g(co)r
-(ordinate)e(system)227 2092 y(domains)e(ma)n(y)g(therefore)g(b)r(e)h
+(ordinate)e(system)227 4642 y(domains)e(ma)n(y)g(therefore)g(b)r(e)h
(giv)n(en)f(whic)n(h)g(de\014nes)h(a)f(priorit)n(y)g(order)f(to)h(use)h
-(when)g(selecting)f(the)h(in)n(termedi-)227 2192 y(ate)c(co)r(ordinate)
+(when)g(selecting)f(the)h(in)n(termedi-)227 4742 y(ate)c(co)r(ordinate)
e(system.)34 b(The)21 b(path)g(used)f(for)g(con)n(v)n(ersion)f(m)n(ust)
h(go)g(via)g(an)g(in)n(termediate)g(co)r(ordinate)g(system)227
-2292 y(whose)k(Domain)h(attribute)f(matc)n(hes)g(one)h(of)f(the)h
+4841 y(whose)k(Domain)h(attribute)f(matc)n(hes)g(one)h(of)f(the)h
(domains)f(giv)n(en.)35 b(If)25 b(con)n(v)n(ersion)d(cannot)j(b)r(e)g
-(ac)n(hiev)n(ed)e(using)227 2391 y(the)28 b(\014rst)g(domain,)f(the)h
+(ac)n(hiev)n(ed)e(using)227 4941 y(the)28 b(\014rst)g(domain,)f(the)h
(next)g(one)f(is)g(considered,)g(and)g(so)g(on,)h(un)n(til)g(success)e
-(is)i(ac)n(hiev)n(ed.)0 2533 y Fd(Synopsis:)121 b Ft(AstFrameSet)39
+(is)i(ac)n(hiev)n(ed.)0 5096 y Fd(Synopsis:)121 b Ft(AstFrameSet)39
b Fh(\003)p Ft(astConvert\()f(AstFrame)j Fh(\003)p Ft(from,)g(AstFrame)
f Fh(\003)p Ft(to,)i(const)f(char)h Fh(\003)p Ft(domainlist)227
-2632 y(\))0 2774 y Fd(P)m(arameters:)259 2902 y(from)427
-3002 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(F)-7 b(rame)27
+5196 y(\))0 5351 y Fd(P)m(arameters:)259 5494 y(from)427
+5593 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(F)-7 b(rame)27
b(whic)n(h)h(represen)n(ts)f(the)i Ft(")p Fi(source)p
Ft(")d Fi(co)r(ordinate)h(system.)38 b(This)28 b(is)g(the)h(co)r
-(ordinate)427 3101 y(system)f(in)f(whic)n(h)h(y)n(ou)f(already)f(ha)n
-(v)n(e)g(co)r(ordinates)h(a)n(v)-5 b(ailable.)427 3214
-y(If)26 b(a)g(F)-7 b(rameSet)25 b(is)h(giv)n(en,)f(its)h(curren)n(t)f
-(F)-7 b(rame)25 b(\(as)g(determined)h(b)n(y)f(its)h(Curren)n(t)f
-(attribute\))h(is)g(tak)n(en)f(to)427 3313 y(describ)r(e)32
-b(the)g(source)f(co)r(ordinate)g(system.)50 b(Note)32
-b(that)g(the)h(Base)e(attribute)h(of)g(this)h(F)-7 b(rameSet)31
-b(ma)n(y)427 3413 y(b)r(e)d(mo)r(di\014ed)f(b)n(y)g(this)g(function)g
-(to)g(indicate)g(whic)n(h)g(in)n(termediate)f(co)r(ordinate)g(system)h
-(w)n(as)f(used)h(\(see)427 3513 y(under)h Ft(")p Fi(F)-7
-b(rameSets)p Ft(")26 b Fi(in)i(the)g Ft(")p Fi(Applicabilit)n(y)p
-Ft(")f Fi(section)g(for)g(details\).)259 3637 y Fd(to)427
-3737 y Fi(P)n(oin)n(ter)h(to)i(a)f(F)-7 b(rame)29 b(whic)n(h)h
-(represen)n(ts)e(the)i Ft(")p Fi(destination)p Ft(")f
-Fi(co)r(ordinate)g(system.)43 b(This)29 b(is)h(the)g(co)r(or-)427
-3837 y(dinate)e(system)f(in)n(to)h(whic)n(h)f(y)n(ou)g(wish)h(to)f(con)
-n(v)n(ert)f(y)n(our)h(co)r(ordinates.)427 3949 y(If)33
+(ordinate)427 5693 y(system)f(in)f(whic)n(h)h(y)n(ou)f(already)f(ha)n
+(v)n(e)g(co)r(ordinates)h(a)n(v)-5 b(ailable.)p eop end
+%%Page: 214 224
+TeXDict begin 214 223 bop 0 52 a FF(214)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)427 351 y Fi(If)c(a)g(F)-7
+b(rameSet)25 b(is)h(giv)n(en,)f(its)h(curren)n(t)f(F)-7
+b(rame)25 b(\(as)g(determined)h(b)n(y)f(its)h(Curren)n(t)f(attribute\))
+h(is)g(tak)n(en)f(to)427 451 y(describ)r(e)32 b(the)g(source)f(co)r
+(ordinate)g(system.)50 b(Note)32 b(that)g(the)h(Base)e(attribute)h(of)g
+(this)h(F)-7 b(rameSet)31 b(ma)n(y)427 551 y(b)r(e)d(mo)r(di\014ed)f(b)
+n(y)g(this)g(function)g(to)g(indicate)g(whic)n(h)g(in)n(termediate)f
+(co)r(ordinate)g(system)h(w)n(as)f(used)h(\(see)427 650
+y(under)h Ft(")p Fi(F)-7 b(rameSets)p Ft(")26 b Fi(in)i(the)g
+Ft(")p Fi(Applicabilit)n(y)p Ft(")f Fi(section)g(for)g(details\).)259
+776 y Fd(to)427 876 y Fi(P)n(oin)n(ter)h(to)i(a)f(F)-7
+b(rame)29 b(whic)n(h)h(represen)n(ts)e(the)i Ft(")p Fi(destination)p
+Ft(")f Fi(co)r(ordinate)g(system.)43 b(This)29 b(is)h(the)g(co)r(or-)
+427 976 y(dinate)e(system)f(in)n(to)h(whic)n(h)f(y)n(ou)g(wish)h(to)f
+(con)n(v)n(ert)f(y)n(our)h(co)r(ordinates.)427 1089 y(If)33
b(a)f(F)-7 b(rameSet)32 b(is)g(giv)n(en,)h(its)f(curren)n(t)f(F)-7
b(rame)32 b(\(as)g(determined)g(b)n(y)g(its)h(Curren)n(t)e(attribute\))
-i(is)f(tak)n(en)427 4049 y(to)25 b(describ)r(e)g(the)h(destination)f
+i(is)f(tak)n(en)427 1188 y(to)25 b(describ)r(e)g(the)h(destination)f
(co)r(ordinate)f(system.)35 b(Note)26 b(that)f(the)h(Base)e(attribute)h
-(of)g(this)h(F)-7 b(rameSet)427 4148 y(ma)n(y)25 b(b)r(e)i(mo)r
+(of)g(this)h(F)-7 b(rameSet)427 1288 y(ma)n(y)25 b(b)r(e)i(mo)r
(di\014ed)f(b)n(y)g(this)g(function)g(to)g(indicate)g(whic)n(h)g(in)n
(termediate)f(co)r(ordinate)g(system)h(w)n(as)f(used)427
-4248 y(\(see)j(under)f Ft(")p Fi(F)-7 b(rameSets)p Ft(")27
+1388 y(\(see)j(under)f Ft(")p Fi(F)-7 b(rameSets)p Ft(")27
b Fi(in)g(the)h Ft(")p Fi(Applicabilit)n(y)p Ft(")f Fi(section)h(for)f
-(details\).)259 4373 y Fd(domainlist)427 4472 y Fi(P)n(oin)n(ter)36
+(details\).)259 1514 y Fd(domainlist)427 1614 y Fi(P)n(oin)n(ter)36
b(to)i(a)f(n)n(ull-terminated)g(c)n(haracter)e(string)i(con)n(taining)g
-(a)g(comma-separated)e(list)j(of)f(F)-7 b(rame)427 4572
+(a)g(comma-separated)e(list)j(of)f(F)-7 b(rame)427 1713
y(domains.)35 b(This)22 b(ma)n(y)g(b)r(e)h(used)f(to)g(de\014ne)h(a)f
(priorit)n(y)f(order)g(for)h(the)h(di\013eren)n(t)g(in)n(termediate)f
-(co)r(ordinate)427 4672 y(systems)27 b(that)h(migh)n(t)g(b)r(e)g(used)f
-(to)h(p)r(erform)f(the)h(con)n(v)n(ersion.)427 4784 y(The)39
+(co)r(ordinate)427 1813 y(systems)27 b(that)h(migh)n(t)g(b)r(e)g(used)f
+(to)h(p)r(erform)f(the)h(con)n(v)n(ersion.)427 1926 y(The)39
b(function)g(will)f(\014rst)g(try)g(to)g(obtain)g(a)g(con)n(v)n(ersion)
e(b)n(y)i(making)g(use)g(only)g(of)g(an)g(in)n(termediate)427
-4883 y(co)r(ordinate)h(system)g(whose)g(Domain)h(attribute)g(matc)n
+2025 y(co)r(ordinate)h(system)g(whose)g(Domain)h(attribute)g(matc)n
(hes)f(the)h(\014rst)g(domain)f(in)h(this)g(list.)74
-b(If)40 b(this)427 4983 y(fails,)32 b(the)g(second)f(domain)g(in)g(the)
+b(If)40 b(this)427 2125 y(fails,)32 b(the)g(second)f(domain)g(in)g(the)
h(list)g(will)f(b)r(e)h(used,)g(and)g(so)e(on,)i(un)n(til)g(con)n(v)n
-(ersion)d(is)i(ac)n(hiev)n(ed.)47 b(A)427 5083 y(blank)26
+(ersion)d(is)i(ac)n(hiev)n(ed.)47 b(A)427 2225 y(blank)26
b(domain)g(\(e.g.)36 b(t)n(w)n(o)25 b(consecutiv)n(e)g(commas\))g
(indicates)h(that)g(all)g(co)r(ordinate)f(systems)g(should)h(b)r(e)427
-5182 y(considered,)h(regardless)e(of)j(their)f(domains.)427
-5295 y(This)37 b(list)h(is)f(case-insensitiv)n(e)f(and)h(all)g(white)g
+2324 y(considered,)h(regardless)e(of)j(their)f(domains.)427
+2437 y(This)37 b(list)h(is)f(case-insensitiv)n(e)f(and)h(all)g(white)g
(space)g(is)g(ignored.)65 b(If)37 b(y)n(ou)g(do)g(not)g(wish)g(to)g
-(restrict)427 5394 y(the)30 b(domain)f(in)h(this)f(w)n(a)n(y)-7
+(restrict)427 2537 y(the)30 b(domain)f(in)h(this)f(w)n(a)n(y)-7
b(,)29 b(y)n(ou)f(should)h(supply)h(an)f(empt)n(y)g(string.)42
-b(This)29 b(is)g(normally)g(appropriate)e(if)427 5494
+b(This)29 b(is)g(normally)g(appropriate)e(if)427 2636
y(either)i(of)g(the)h(source)e(or)g(destination)h(co)r(ordinate)f
(systems)h(are)f(describ)r(ed)h(b)n(y)g(F)-7 b(rames)28
-b(\(rather)g(than)427 5593 y(F)-7 b(rameSets\),)35 b(since)e(there)g
+b(\(rather)g(than)427 2736 y(F)-7 b(rameSets\),)35 b(since)e(there)g
(is)g(then)h(usually)f(only)g(one)g(p)r(ossible)g(c)n(hoice)g(of)g(in)n
-(termediate)g(co)r(ordinate)427 5693 y(system.)p eop
-end
-%%Page: 214 224
-TeXDict begin 214 223 bop 0 52 a FF(214)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Class)h(Applicabilit)m
-(y:)259 483 y(DSBSp)s(ecF)-8 b(rame)427 582 y Fi(If)24
-b(the)g(AlignSideBand)g(attribute)g(is)f(non-zero,)g(alignmen)n(t)g(o)r
-(ccurs)g(in)h(the)g(upp)r(er)f(sideband)h(expressed)427
-682 y(within)30 b(the)f(sp)r(ectral)f(system)g(and)h(standard)e(of)i
-(rest)f(giv)n(en)g(b)n(y)g(attributes)h(AlignSystem)f(and)h(Align-)427
-782 y(StdOfRest.)58 b(If)35 b(AlignSideBand)f(is)g(zero,)i(the)e(t)n(w)
-n(o)g(DSBSp)r(ecF)-7 b(rames)34 b(are)g(aligned)f(as)h(if)h(they)g(w)n
-(ere)427 881 y(simple)28 b(Sp)r(ecF)-7 b(rames)27 b(\(i.e.)37
-b(the)28 b(SideBand)g(is)f(ignored\).)259 1009 y Fd(F)-8
-b(rame)427 1109 y Fi(This)26 b(function)f(applies)g(to)g(all)g(F)-7
-b(rames.)36 b(Alignmen)n(t)25 b(o)r(ccurs)g(within)h(the)f(co)r
-(ordinate)f(system)h(giv)n(en)g(b)n(y)427 1208 y(attribute)j
-(AlignSystem.)259 1336 y Fd(F)-8 b(rameSet)427 1436 y
-Fi(If)31 b(either)g(of)f(the)h Ft(")p Fi(from)p Ft(")f
-Fi(or)f Ft(")p Fi(to)p Ft(")h Fi(parameters)f(is)h(a)h(p)r(oin)n(ter)f
-(to)g(a)g(F)-7 b(rameSet,)32 b(then)f(astCon)n(v)n(ert)d(will)427
-1536 y(attempt)d(to)f(con)n(v)n(ert)f(from)h(the)h(co)r(ordinate)e
-(system)h(describ)r(ed)g(b)n(y)g(the)h(curren)n(t)e(F)-7
-b(rame)24 b(of)g(the)h Ft(")p Fi(from)p Ft(")427 1635
+(termediate)g(co)r(ordinate)427 2836 y(system.)0 2991
+y Fd(Class)e(Applicabilit)m(y:)259 3121 y(DSBSp)s(ecF)-8
+b(rame)427 3221 y Fi(If)24 b(the)g(AlignSideBand)g(attribute)g(is)f
+(non-zero,)g(alignmen)n(t)g(o)r(ccurs)g(in)h(the)g(upp)r(er)f(sideband)
+h(expressed)427 3320 y(within)30 b(the)f(sp)r(ectral)f(system)g(and)h
+(standard)e(of)i(rest)f(giv)n(en)g(b)n(y)g(attributes)h(AlignSystem)f
+(and)h(Align-)427 3420 y(StdOfRest.)58 b(If)35 b(AlignSideBand)f(is)g
+(zero,)i(the)e(t)n(w)n(o)g(DSBSp)r(ecF)-7 b(rames)34
+b(are)g(aligned)f(as)h(if)h(they)g(w)n(ere)427 3520 y(simple)28
+b(Sp)r(ecF)-7 b(rames)27 b(\(i.e.)37 b(the)28 b(SideBand)g(is)f
+(ignored\).)259 3646 y Fd(F)-8 b(rame)427 3745 y Fi(This)26
+b(function)f(applies)g(to)g(all)g(F)-7 b(rames.)36 b(Alignmen)n(t)25
+b(o)r(ccurs)g(within)h(the)f(co)r(ordinate)f(system)h(giv)n(en)g(b)n(y)
+427 3845 y(attribute)j(AlignSystem.)259 3971 y Fd(F)-8
+b(rameSet)427 4071 y Fi(If)31 b(either)g(of)f(the)h Ft(")p
+Fi(from)p Ft(")f Fi(or)f Ft(")p Fi(to)p Ft(")h Fi(parameters)f(is)h(a)h
+(p)r(oin)n(ter)f(to)g(a)g(F)-7 b(rameSet,)32 b(then)f(astCon)n(v)n(ert)
+d(will)427 4171 y(attempt)d(to)f(con)n(v)n(ert)f(from)h(the)h(co)r
+(ordinate)e(system)h(describ)r(ed)g(b)n(y)g(the)h(curren)n(t)e(F)-7
+b(rame)24 b(of)g(the)h Ft(")p Fi(from)p Ft(")427 4270
y Fi(F)-7 b(rameSet)28 b(to)f(that)h(describ)r(ed)f(b)n(y)h(the)g
(curren)n(t)e(F)-7 b(rame)27 b(of)h(the)g Ft(")p Fi(to)p
-Ft(")f Fi(F)-7 b(rameSet.)427 1749 y(T)g(o)34 b(ac)n(hiev)n(e)g(this,)i
+Ft(")f Fi(F)-7 b(rameSet.)427 4383 y(T)g(o)34 b(ac)n(hiev)n(e)g(this,)i
(it)f(will)g(consider)f(all)g(of)g(the)h(F)-7 b(rames)34
b(within)h(eac)n(h)f(F)-7 b(rameSet)35 b(as)e(a)i(p)r(ossible)f(w)n(a)n
-(y)427 1849 y(of)g(reac)n(hing)e(an)i(in)n(termediate)f(co)r(ordinate)g
+(y)427 4483 y(of)g(reac)n(hing)e(an)i(in)n(termediate)f(co)r(ordinate)g
(system)g(that)h(can)g(b)r(e)g(used)g(for)f(the)h(con)n(v)n(ersion.)53
-b(There)427 1948 y(is)30 b(then)h(the)g(p)r(ossibilit)n(y)f(that)h
+b(There)427 4583 y(is)30 b(then)h(the)g(p)r(ossibilit)n(y)f(that)h
(more)e(than)i(one)e(con)n(v)n(ersion)f(path)j(ma)n(y)f(exist)g(and,)h
-(unless)f(the)g(c)n(hoice)427 2048 y(is)36 b(su\016cien)n(tly)g
+(unless)f(the)g(c)n(hoice)427 4682 y(is)36 b(su\016cien)n(tly)g
(restricted)f(b)n(y)h(the)g Ft(")p Fi(domainlist)p Ft(")f
Fi(string,)i(the)f(sequence)f(in)i(whic)n(h)e(the)i(F)-7
-b(rames)35 b(are)427 2147 y(considered)j(can)h(b)r(e)h(imp)r(ortan)n
+b(rames)35 b(are)427 4782 y(considered)j(can)h(b)r(e)h(imp)r(ortan)n
(t.)71 b(In)39 b(this)h(case,)h(the)f(searc)n(h)d(for)i(a)g(con)n(v)n
-(ersion)e(path)i(pro)r(ceeds)f(as)427 2247 y(follo)n(ws:)510
-2350 y Fh(\017)45 b Fi(Eac)n(h)27 b(\014eld)h(in)f(the)h
+(ersion)e(path)i(pro)r(ceeds)f(as)427 4881 y(follo)n(ws:)510
+4982 y Fh(\017)45 b Fi(Eac)n(h)27 b(\014eld)h(in)f(the)h
Ft(")p Fi(domainlist)p Ft(")f Fi(string)g(is)g(considered)g(in)h(turn.)
-510 2463 y Fh(\017)45 b Fi(The)26 b(F)-7 b(rames)24 b(within)i(eac)n(h)
+510 5095 y Fh(\017)45 b Fi(The)26 b(F)-7 b(rames)24 b(within)i(eac)n(h)
f(F)-7 b(rameSet)25 b(are)f(considered)h(in)g(a)g(sp)r(eci\014c)h
(order:)34 b(\(1\))26 b(the)f(base)g(F)-7 b(rame)597
-2563 y(is)28 b(alw)n(a)n(ys)d(considered)i(\014rst,)g(\(2\))h(after)f
+5195 y(is)28 b(alw)n(a)n(ys)d(considered)i(\014rst,)g(\(2\))h(after)f
(this)h(come)f(all)h(the)g(other)f(F)-7 b(rames)26 b(in)i(F)-7
-b(rame-index)27 b(order)597 2662 y(\(but)h(omitting)f(the)g(base)g(and)
+b(rame-index)27 b(order)597 5295 y(\(but)h(omitting)f(the)g(base)g(and)
f(curren)n(t)g(F)-7 b(rames\),)27 b(\(3\))g(the)g(curren)n(t)f(F)-7
-b(rame)27 b(is)g(alw)n(a)n(ys)e(considered)597 2762 y(last.)35
+b(rame)27 b(is)g(alw)n(a)n(ys)e(considered)597 5394 y(last.)35
b(Ho)n(w)n(ev)n(er,)22 b(if)i(either)f(F)-7 b(rameSet's)23
b(In)n(v)n(ert)f(attribute)h(is)h(set)f(to)g(a)f(non-zero)g(v)-5
-b(alue)23 b(\(so)g(that)g(the)597 2862 y(F)-7 b(rameSet)30
+b(alue)23 b(\(so)g(that)g(the)597 5494 y(F)-7 b(rameSet)30
b(is)h(in)n(v)n(erted\),)f(then)h(its)g(F)-7 b(rames)30
b(are)f(considered)h(in)g(rev)n(erse)f(order.)44 b(\(Note)31
-b(that)f(this)597 2961 y(still)h(means)e(that)h(the)h(base)e(F)-7
+b(that)f(this)597 5593 y(still)h(means)e(that)h(the)h(base)e(F)-7
b(rame)29 b(is)h(considered)f(\014rst)h(and)g(the)g(curren)n(t)f(F)-7
-b(rame)30 b(last,)g(b)r(ecause)597 3061 y(the)e(In)n(v)n(ert)f(v)-5
+b(rame)30 b(last,)g(b)r(ecause)597 5693 y(the)e(In)n(v)n(ert)f(v)-5
b(alue)27 b(will)h(also)f(cause)g(these)g(F)-7 b(rames)27
-b(to)h(sw)n(ap)e(places.\))510 3175 y Fh(\017)45 b Fi(All)34
-b(source)d(F)-7 b(rames)33 b(are)f(\014rst)g(considered)g(\(in)i(the)f
-(appropriate)e(order\))h(for)h(con)n(v)n(ersion)d(to)j(the)597
-3274 y(\014rst)26 b(destination)g(F)-7 b(rame.)36 b(If)27
-b(no)e(suitable)h(in)n(termediate)g(co)r(ordinate)f(system)h(emerges,)f
-(they)i(are)597 3374 y(then)d(considered)e(again)g(for)g(con)n(v)n
-(ersion)f(to)h(the)i(second)e(destination)h(F)-7 b(rame)22
-b(\(in)i(the)f(appropriate)597 3474 y(order\),)k(and)g(so)g(on.)510
-3587 y Fh(\017)45 b Fi(Generally)-7 b(,)26 b(the)h(\014rst)f(suitable)g
-(in)n(termediate)h(co)r(ordinate)e(system)h(found)h(is)f(used.)36
-b(Ho)n(w)n(ev)n(er,)25 b(the)597 3687 y(o)n(v)n(erall)32
+b(to)h(sw)n(ap)e(places.\))p eop end
+%%Page: 215 225
+TeXDict begin 215 224 bop 3643 52 a FF(215)510 351 y
+Fh(\017)45 b Fi(All)34 b(source)d(F)-7 b(rames)33 b(are)f(\014rst)g
+(considered)g(\(in)i(the)f(appropriate)e(order\))h(for)h(con)n(v)n
+(ersion)d(to)j(the)597 451 y(\014rst)26 b(destination)g(F)-7
+b(rame.)36 b(If)27 b(no)e(suitable)h(in)n(termediate)g(co)r(ordinate)f
+(system)h(emerges,)f(they)i(are)597 551 y(then)d(considered)e(again)g
+(for)g(con)n(v)n(ersion)f(to)h(the)i(second)e(destination)h(F)-7
+b(rame)22 b(\(in)i(the)f(appropriate)597 650 y(order\),)k(and)g(so)g
+(on.)510 768 y Fh(\017)45 b Fi(Generally)-7 b(,)26 b(the)h(\014rst)f
+(suitable)g(in)n(termediate)h(co)r(ordinate)e(system)h(found)h(is)f
+(used.)36 b(Ho)n(w)n(ev)n(er,)25 b(the)597 868 y(o)n(v)n(erall)32
b(Mapping)i(b)r(et)n(w)n(een)h(the)f(source)g(and)g(destination)g(co)r
-(ordinate)f(systems)h(is)g(also)f(exam-)597 3787 y(ined.)51
+(ordinate)f(systems)h(is)g(also)f(exam-)597 967 y(ined.)51
b(Preference)31 b(is)h(giv)n(en)f(to)h(cases)f(where)h(b)r(oth)g(the)h
(forw)n(ard)d(and)i(in)n(v)n(erse)f(transformations)597
-3886 y(are)g(de\014ned)g(\(as)g(indicated)g(b)n(y)g(the)h(T)-7
+1067 y(are)g(de\014ned)g(\(as)g(indicated)g(b)n(y)g(the)h(T)-7
b(ranF)g(orw)n(ard)29 b(and)i(T)-7 b(ranIn)n(v)n(erse)29
-b(attributes\).)48 b(If)31 b(only)g(one)597 3986 y(transformation)26
+b(attributes\).)48 b(If)31 b(only)g(one)597 1166 y(transformation)26
b(is)i(de\014ned,)g(the)g(forw)n(ard)e(one)h(is)g(preferred.)510
-4100 y Fh(\017)45 b Fi(If)32 b(the)f(domain)g(of)g(the)h(in)n
+1284 y Fh(\017)45 b Fi(If)32 b(the)f(domain)g(of)g(the)h(in)n
(termediate)e(co)r(ordinate)g(system)h(matc)n(hes)g(the)g(curren)n(t)g
-Ft(")p Fi(domainlist)p Ft(")597 4199 y Fi(\014eld,)21
+Ft(")p Fi(domainlist)p Ft(")597 1384 y Fi(\014eld,)21
b(the)e(con)n(v)n(ersion)d(path)i(is)h(accepted.)33 b(Otherwise,)20
b(the)f(next)f Ft(")p Fi(domainlist)p Ft(")g Fi(\014eld)g(is)h
-(considered)597 4299 y(and)28 b(the)g(pro)r(cess)e(rep)r(eated.)427
-4427 y(If)33 b(con)n(v)n(ersion)c(is)j(p)r(ossible,)g(the)h(Base)d
+(considered)597 1484 y(and)28 b(the)g(pro)r(cess)e(rep)r(eated.)427
+1620 y(If)33 b(con)n(v)n(ersion)c(is)j(p)r(ossible,)g(the)h(Base)d
(attributes)i(of)g(the)g(t)n(w)n(o)f(F)-7 b(rameSets)31
-b(will)h(b)r(e)h(mo)r(di\014ed)f(on)f(exit)427 4526 y(to)h(iden)n(tify)
+b(will)h(b)r(e)h(mo)r(di\014ed)f(on)f(exit)427 1719 y(to)h(iden)n(tify)
g(the)g(F)-7 b(rames)31 b(used)g(to)h(access)e(the)i(in)n(termediate)f
(co)r(ordinate)f(system)i(whic)n(h)f(w)n(as)g(\014nally)427
-4626 y(accepted.)427 4740 y(Note)26 b(that)f(it)h(is)f(p)r(ossible)g
+1819 y(accepted.)427 1937 y(Note)26 b(that)f(it)h(is)f(p)r(ossible)g
(to)h(force)e(a)h(particular)f(F)-7 b(rame)25 b(within)h(a)f(F)-7
b(rameSet)25 b(to)h(b)r(e)g(used)f(as)g(the)g(basis)427
-4839 y(for)32 b(the)g(in)n(termediate)g(co)r(ordinate)f(system,)i(if)f
+2036 y(for)32 b(the)g(in)n(termediate)g(co)r(ordinate)f(system,)i(if)f
(it)h(is)f(suitable,)h(b)n(y)f(\(a\))g(fo)r(cussing)g(atten)n(tion)g
-(on)f(it)i(b)n(y)427 4939 y(sp)r(ecifying)28 b(its)g(domain)g(in)g(the)
+(on)f(it)i(b)n(y)427 2136 y(sp)r(ecifying)28 b(its)g(domain)g(in)g(the)
g Ft(")p Fi(domainlist)p Ft(")f Fi(string,)g(or)g(\(b\))h(making)g(it)g
-(the)g(base)f(F)-7 b(rame,)28 b(since)f(this)427 5039
-y(is)h(alw)n(a)n(ys)d(considered)i(\014rst.)259 5167
-y Fd(Sp)s(ecF)-8 b(rame)427 5266 y Fi(Alignmen)n(t)28
+(the)g(base)f(F)-7 b(rame,)28 b(since)f(this)427 2236
+y(is)h(alw)n(a)n(ys)d(considered)i(\014rst.)259 2372
+y Fd(Sp)s(ecF)-8 b(rame)427 2471 y Fi(Alignmen)n(t)28
b(o)r(ccurs)e(within)i(the)g(sp)r(ectral)f(system)g(and)g(standard)g
(of)g(rest)g(giv)n(en)f(b)n(y)i(attributes)f(Align-)427
-5366 y(System)h(and)f(AlignStdOfRest.)259 5494 y Fd(TimeF)-8
-b(rame)427 5593 y Fi(Alignmen)n(t)24 b(o)r(ccurs)e(within)h(the)h(time)
+2571 y(System)h(and)f(AlignStdOfRest.)259 2707 y Fd(TimeF)-8
+b(rame)427 2806 y Fi(Alignmen)n(t)24 b(o)r(ccurs)e(within)h(the)h(time)
f(system)g(and)g(time)g(scale)g(giv)n(en)f(b)n(y)h(attributes)g
-(AlignSystem)g(and)427 5693 y(AlignTimeScale.)p eop end
-%%Page: 215 225
-TeXDict begin 215 224 bop 3643 52 a FF(215)0 351 y Fd(Returned)32
-b(V)-8 b(alue:)259 503 y(astCon)m(v)m(ert\(\))427 602
-y Fi(If)21 b(the)g(requested)e(co)r(ordinate)g(con)n(v)n(ersion)f(is)j
-(p)r(ossible,)g(the)g(function)g(returns)e(a)h(p)r(oin)n(ter)g(to)g(a)g
-(F)-7 b(rameSet)427 702 y(whic)n(h)28 b(describ)r(es)f(the)h(con)n(v)n
-(ersion.)36 b(Otherwise,)27 b(a)g(n)n(ull)h(Ob)5 b(ject)28
-b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fi(NULL\))h(is)g(returned)427
-802 y(without)g(error.)427 921 y(If)37 b(a)g(F)-7 b(rameSet)36
-b(is)h(returned,)h(it)f(will)g(con)n(tain)f(t)n(w)n(o)g(F)-7
-b(rames.)64 b(F)-7 b(rame)36 b(n)n(um)n(b)r(er)g(1)h(\(its)g(base)f(F)
--7 b(rame\))427 1021 y(will)32 b(describ)r(e)f(the)h(source)e(co)r
+(AlignSystem)g(and)427 2906 y(AlignTimeScale.)0 3074
+y Fd(Returned)32 b(V)-8 b(alue:)259 3217 y(astCon)m(v)m(ert\(\))427
+3317 y Fi(If)21 b(the)g(requested)e(co)r(ordinate)g(con)n(v)n(ersion)f
+(is)j(p)r(ossible,)g(the)g(function)g(returns)e(a)h(p)r(oin)n(ter)g(to)
+g(a)g(F)-7 b(rameSet)427 3416 y(whic)n(h)28 b(describ)r(es)f(the)h(con)
+n(v)n(ersion.)36 b(Otherwise,)27 b(a)g(n)n(ull)h(Ob)5
+b(ject)28 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fi(NULL\))h(is)g(returned)
+427 3516 y(without)g(error.)427 3634 y(If)37 b(a)g(F)-7
+b(rameSet)36 b(is)h(returned,)h(it)f(will)g(con)n(tain)f(t)n(w)n(o)g(F)
+-7 b(rames.)64 b(F)-7 b(rame)36 b(n)n(um)n(b)r(er)g(1)h(\(its)g(base)f
+(F)-7 b(rame\))427 3733 y(will)32 b(describ)r(e)f(the)h(source)e(co)r
(ordinate)h(system,)h(corresp)r(onding)d(to)j(the)g Ft(")p
-Fi(from)p Ft(")e Fi(parameter.)47 b(F)-7 b(rame)427 1121
+Fi(from)p Ft(")e Fi(parameter.)47 b(F)-7 b(rame)427 3833
y(n)n(um)n(b)r(er)27 b(2)g(\(its)g(curren)n(t)f(F)-7
b(rame\))27 b(will)g(describ)r(e)g(the)g(destination)g(co)r(ordinate)f
-(system,)h(corresp)r(onding)427 1220 y(to)j(the)g Ft(")p
+(system,)h(corresp)r(onding)427 3933 y(to)j(the)g Ft(")p
Fi(to)p Ft(")e Fi(parameter.)42 b(The)29 b(Mapping)h(whic)n(h)f(in)n
(ter-relates)f(these)i(t)n(w)n(o)e(F)-7 b(rames)29 b(will)h(p)r(erform)
-f(the)427 1320 y(required)e(con)n(v)n(ersion)e(b)r(et)n(w)n(een)j
+f(the)427 4032 y(required)e(con)n(v)n(ersion)e(b)r(et)n(w)n(een)j
(their)f(resp)r(ectiv)n(e)g(co)r(ordinate)g(systems.)427
-1440 y(Note)h(that)h(a)f(F)-7 b(rameSet)28 b(ma)n(y)f(b)r(e)i(used)f(b)
+4150 y(Note)h(that)h(a)f(F)-7 b(rameSet)28 b(ma)n(y)f(b)r(e)i(used)f(b)
r(oth)g(as)g(a)g(Mapping)f(and)h(as)g(a)g(F)-7 b(rame.)38
-b(If)28 b(the)h(result)f(is)g(used)427 1540 y(as)g(a)g(Mapping)g
+b(If)28 b(the)h(result)f(is)g(used)427 4250 y(as)g(a)g(Mapping)g
(\(e.g.)40 b(with)29 b(astT)-7 b(ran2\),)27 b(then)i(it)g(pro)n(vides)e
(a)h(means)g(of)g(con)n(v)n(erting)f(co)r(ordinates)g(from)427
-1639 y(the)34 b(source)e(to)i(the)g(destination)f(co)r(ordinate)f
+4349 y(the)34 b(source)e(to)i(the)g(destination)f(co)r(ordinate)f
(system)i(\(or)f(vice)g(v)n(ersa)f(if)i(its)f(in)n(v)n(erse)f
-(transformation)427 1739 y(is)g(selected\).)50 b(If)33
+(transformation)427 4449 y(is)g(selected\).)50 b(If)33
b(it)f(is)g(used)g(as)f(a)h(F)-7 b(rame,)33 b(its)f(attributes)g(will)g
(describ)r(e)g(the)g(destination)g(co)r(ordinate)427
-1838 y(system.)0 2015 y Fd(Examples:)227 2171 y Fp(cvt)47
-b(=)h(astConvert\()c(a,)k(b,)f Ft("")g Fp(\);)427 2266
+4549 y(system.)0 4717 y Fd(Examples:)227 4864 y Fp(cvt)47
+b(=)h(astConvert\()c(a,)k(b,)f Ft("")g Fp(\);)427 4959
y Fi(A)n(ttempts)32 b(to)e(con)n(v)n(ert)f(b)r(et)n(w)n(een)i(the)f(co)
r(ordinate)g(systems)g(represen)n(ted)f(b)n(y)h Ft(")p
Fi(a)p Ft(")g Fi(and)g Ft(")p Fi(b)p Ft(")g Fi(\(assumed)427
-2366 y(to)25 b(b)r(e)g(F)-7 b(rames\).)35 b(If)26 b(successful,)f(a)f
+5059 y(to)25 b(b)r(e)g(F)-7 b(rames\).)35 b(If)26 b(successful,)f(a)f
(F)-7 b(rameSet)24 b(is)h(returned)f(via)g(the)i Ft(")p
Fi(cvt)p Ft(")e Fi(p)r(oin)n(ter)g(whic)n(h)h(ma)n(y)f(b)r(e)h(used)427
-2466 y(to)j(apply)f(the)h(con)n(v)n(ersion)d(to)j(sets)f(of)h(co)r
+5158 y(to)j(apply)f(the)h(con)n(v)n(ersion)d(to)j(sets)f(of)h(co)r
(ordinates)e(\(e.g.)37 b(using)27 b(astT)-7 b(ran2\).)227
-2607 y Fp(cvt)47 b(=)h(astConvert\()c(astSkyFrame\()p
+5296 y Fp(cvt)47 b(=)h(astConvert\()c(astSkyFrame\()p
Ft("")p Fp(\),)f(astSkyFrame\()p Ft(")p Fp(Equinox=2005)o
-Ft(")p Fp(\),)e Ft("")47 b Fp(\);)427 2706 y Fi(Creates)23
+Ft(")p Fp(\),)e Ft("")47 b Fp(\);)427 5394 y Fi(Creates)23
b(a)g(F)-7 b(rameSet)23 b(whic)n(h)g(describ)r(es)g(precession)f(in)i
(the)g(default)g(FK5)f(celestial)g(co)r(ordinate)f(system)427
-2805 y(b)r(et)n(w)n(een)k(equino)n(xes)e(J2000)f(\(also)h(the)i
+5494 y(b)r(et)n(w)n(een)k(equino)n(xes)e(J2000)f(\(also)h(the)i
(default\))g(and)g(J2005.)33 b(The)26 b(returned)f Ft(")p
Fi(cvt)p Ft(")f Fi(p)r(oin)n(ter)h(ma)n(y)g(then)427
-2905 y(b)r(e)h(passed)f(to)g(astT)-7 b(ran2)24 b(to)h(apply)g(this)h
+5593 y(b)r(e)h(passed)f(to)g(astT)-7 b(ran2)24 b(to)h(apply)g(this)h
(precession)e(correction)f(to)j(an)n(y)e(n)n(um)n(b)r(er)h(of)h(co)r
-(ordinate)e(v)-5 b(alues)427 3004 y(giv)n(en)27 b(in)h(radians.)427
-3124 y(Note)h(that)h(the)f(returned)f(F)-7 b(rameSet)29
-b(also)f(con)n(tains)g(information)g(ab)r(out)h(ho)n(w)g(to)f(format)h
-(co)r(ordinate)427 3224 y(v)-5 b(alues.)47 b(This)30
-b(means)h(that)g(setting)g(its)g(Rep)r(ort)f(attribute)h(to)g(1)g(is)f
-(a)h(simple)g(w)n(a)n(y)e(to)i(obtain)g(prin)n(ted)427
-3324 y(output)j(\(formatted)f(in)g(sexagesimal)e(notation\))i(to)g(sho)
-n(w)f(the)i(co)r(ordinate)e(v)-5 b(alues)32 b(b)r(efore)h(and)g(after)
-427 3423 y(con)n(v)n(ersion.)227 3565 y Fp(cvt)47 b(=)h(astConvert\()c
-(a,)k(b,)f Ft(")p Fp(sky,detector,)p Ft(")c Fp(\);)427
-3663 y Fi(A)n(ttempts)34 b(to)f(con)n(v)n(ert)f(b)r(et)n(w)n(een)h(the)
-g(co)r(ordinate)f(systems)g(represen)n(ted)g(b)n(y)h(the)g(curren)n(t)f
-(F)-7 b(rames)33 b(of)427 3763 y Ft(")p Fi(a)p Ft(")21
-b Fi(and)i Ft(")p Fi(b)p Ft(")f Fi(\(no)n(w)g(assumed)g(to)g(b)r(e)h(F)
--7 b(rameSets\),)23 b(via)f(the)h(in)n(termediate)f Ft(")p
-Fi(SKY)p Ft(")g Fi(co)r(ordinate)f(system.)427 3862 y(This,)28
+(ordinate)e(v)-5 b(alues)427 5693 y(giv)n(en)27 b(in)h(radians.)p
+eop end
+%%Page: 216 226
+TeXDict begin 216 225 bop 0 52 a FF(216)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)427 351 y Fi(Note)f(that)h(the)f
+(returned)f(F)-7 b(rameSet)29 b(also)f(con)n(tains)g(information)g(ab)r
+(out)h(ho)n(w)g(to)f(format)h(co)r(ordinate)427 451 y(v)-5
+b(alues.)47 b(This)30 b(means)h(that)g(setting)g(its)g(Rep)r(ort)f
+(attribute)h(to)g(1)g(is)f(a)h(simple)g(w)n(a)n(y)e(to)i(obtain)g(prin)
+n(ted)427 551 y(output)j(\(formatted)f(in)g(sexagesimal)e(notation\))i
+(to)g(sho)n(w)f(the)i(co)r(ordinate)e(v)-5 b(alues)32
+b(b)r(efore)h(and)g(after)427 650 y(con)n(v)n(ersion.)227
+779 y Fp(cvt)47 b(=)h(astConvert\()c(a,)k(b,)f Ft(")p
+Fp(sky,detector,)p Ft(")c Fp(\);)427 877 y Fi(A)n(ttempts)34
+b(to)f(con)n(v)n(ert)f(b)r(et)n(w)n(een)h(the)g(co)r(ordinate)f
+(systems)g(represen)n(ted)g(b)n(y)h(the)g(curren)n(t)f(F)-7
+b(rames)33 b(of)427 977 y Ft(")p Fi(a)p Ft(")21 b Fi(and)i
+Ft(")p Fi(b)p Ft(")f Fi(\(no)n(w)g(assumed)g(to)g(b)r(e)h(F)-7
+b(rameSets\),)23 b(via)f(the)h(in)n(termediate)f Ft(")p
+Fi(SKY)p Ft(")g Fi(co)r(ordinate)f(system.)427 1077 y(This,)28
b(b)n(y)g(default,)g(is)g(the)g(Domain)g(asso)r(ciated)e(with)i(a)g
(celestial)f(co)r(ordinate)g(system)g(represen)n(ted)g(b)n(y)427
-3962 y(a)g(SkyF)-7 b(rame.)427 4082 y(If)21 b(this)h(fails)e(\(for)h
+1176 y(a)g(SkyF)-7 b(rame.)427 1290 y(If)21 b(this)h(fails)e(\(for)h
(example,)g(b)r(ecause)g(either)f(F)-7 b(rameSet)21 b(lac)n(ks)e
(celestial)i(co)r(ordinate)e(information\),)j(then)427
-4182 y(the)27 b(user-de\014ned)g Ft(")p Fi(DETECTOR)p
+1390 y(the)27 b(user-de\014ned)g Ft(")p Fi(DETECTOR)p
Ft(")e Fi(co)r(ordinate)g(system)i(is)f(used)h(instead.)37
-b(If)27 b(this)g(also)f(fails,)h(then)g(all)427 4281
+b(If)27 b(this)g(also)f(fails,)h(then)g(all)427 1489
y(other)g(p)r(ossible)h(w)n(a)n(ys)e(of)h(ac)n(hieving)g(con)n(v)n
(ersion)e(are)h(considered)h(b)r(efore)g(giving)g(up.)427
-4401 y(The)d(returned)f(p)r(oin)n(ter)h Ft(")p Fi(cvt)p
+1603 y(The)d(returned)f(p)r(oin)n(ter)h Ft(")p Fi(cvt)p
Ft(")f Fi(indicates)g(whether)h(con)n(v)n(ersion)d(w)n(as)i(p)r
(ossible)g(and)h(will)g(ha)n(v)n(e)f(the)h(v)-5 b(alue)427
-4501 y(AST)p Ft(__)p Fi(NULL)32 b(if)h(it)f(w)n(as)f(not.)50
+1702 y(AST)p Ft(__)p Fi(NULL)32 b(if)h(it)f(w)n(as)f(not.)50
b(If)32 b(con)n(v)n(ersion)e(w)n(as)g(p)r(ossible,)j
Ft(")p Fi(cvt)p Ft(")e Fi(will)h(p)r(oin)n(t)h(at)e(a)h(new)g(F)-7
-b(rameSet)427 4601 y(describing)27 b(the)h(con)n(v)n(ersion.)427
-4721 y(The)38 b(Base)e(attributes)h(of)h(the)f(t)n(w)n(o)g(F)-7
+b(rameSet)427 1802 y(describing)27 b(the)h(con)n(v)n(ersion.)427
+1916 y(The)38 b(Base)e(attributes)h(of)h(the)f(t)n(w)n(o)g(F)-7
b(rameSets)37 b(will)g(b)r(e)h(set)f(b)n(y)g(astCon)n(v)n(ert)f(to)h
-(indicate)g(whic)n(h)h(of)427 4820 y(their)f(F)-7 b(rames)37
+(indicate)g(whic)n(h)h(of)427 2015 y(their)f(F)-7 b(rames)37
b(w)n(as)f(used)h(for)g(the)g(in)n(termediate)g(co)r(ordinate)f
(system.)65 b(This)37 b(means)g(that)h(y)n(ou)e(can)427
-4920 y(subsequen)n(tly)22 b(determine)g(whic)n(h)h(co)r(ordinate)e
+2115 y(subsequen)n(tly)22 b(determine)g(whic)n(h)h(co)r(ordinate)e
(system)h(w)n(as)f(used)h(b)n(y)g(enquiring)g(the)g(Domain)g(attribute)
-427 5019 y(of)28 b(either)f(base)g(F)-7 b(rame.)0 5196
-y Fd(Notes:)340 5494 y Fh(\017)45 b Fi(The)40 b(Mapping)f(represen)n
+427 2214 y(of)28 b(either)f(base)g(F)-7 b(rame.)0 2371
+y Fd(Notes:)340 2648 y Fh(\017)45 b Fi(The)40 b(Mapping)f(represen)n
(ted)f(b)n(y)h(the)h(returned)f(F)-7 b(rameSet)40 b(results)f(in)g
-(alignmen)n(t)g(taking)g(place)g(in)427 5593 y(the)d(co)r(ordinate)f
+(alignmen)n(t)g(taking)g(place)g(in)427 2748 y(the)d(co)r(ordinate)f
(system)g(sp)r(eci\014ed)h(b)n(y)f(the)h(AlignSystem)g(attribute)g(of)f
(the)i Ft(")p Fi(to)p Ft(")d Fi(F)-7 b(rame.)61 b(See)35
-b(the)427 5693 y(description)27 b(of)h(the)g(AlignSystem)g(attribute)f
-(for)g(further)h(details.)p eop end
-%%Page: 216 226
-TeXDict begin 216 225 bop 0 52 a FF(216)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
-b Fi(When)d(aligning)e(\(sa)n(y\))g(t)n(w)n(o)h(images,)i(whic)n(h)e
-(ha)n(v)n(e)f(b)r(een)h(calibrated)f(b)n(y)h(attac)n(hing)f(F)-7
-b(rameSets)41 b(to)427 451 y(them,)26 b(it)e(is)h(usually)e(necessary)g
-(to)h(con)n(v)n(ert)f(b)r(et)n(w)n(een)h(the)h(base)e(F)-7
-b(rames)24 b(\(represen)n(ting)f Ft(")p Fi(nativ)n(e)p
-Ft(")g Fi(pixel)427 551 y(co)r(ordinates\))f(of)g(b)r(oth)i(F)-7
-b(rameSets.)34 b(This)23 b(ma)n(y)f(b)r(e)h(ac)n(hiev)n(ed)f(b)n(y)g
-(in)n(v)n(erting)g(the)h(F)-7 b(rameSets)22 b(\(e.g.)35
-b(using)427 650 y(astIn)n(v)n(ert\))27 b(so)g(as)g(to)g(in)n(terc)n
-(hange)f(their)i(base)f(and)g(curren)n(t)g(F)-7 b(rames)27
-b(b)r(efore)g(using)g(astCon)n(v)n(ert.)340 779 y Fh(\017)45
-b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
-Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
-(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 878 y(AST)28
-b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)p 0 1069 3780 12 v 0 1200 a Fz(astCop)l(y)1006
-b Fe(Cop)m(y)37 b(an)i(Ob)7 b(ject)1003 b Fz(astCop)l(y)0
-1381 y Fd(Description:)44 b Fi(This)38 b(function)h(creates)d(a)i(cop)n
-(y)f(of)h(an)f(Ob)5 b(ject)38 b(and)g(returns)f(a)h(p)r(oin)n(ter)f(to)
-h(the)g(resulting)g(new)227 1480 y(Ob)5 b(ject.)62 b(It)36
-b(mak)n(es)f(a)h Ft(")p Fi(deep)p Ft(")f Fi(cop)n(y)-7
-b(,)38 b(whic)n(h)d(con)n(tains)h(no)f(references)g(to)h(an)n(y)f
-(other)g(Ob)5 b(ject)36 b(\(i.e.)63 b(if)36 b(the)227
-1580 y(original)29 b(Ob)5 b(ject)31 b(con)n(tains)f(references)g(to)g
-(other)g(Ob)5 b(jects,)32 b(then)f(the)g(actual)f(data)h(are)e(copied,)
-j(not)f(simply)227 1680 y(the)d(references\).)36 b(This)27
-b(means)f(that)i(mo)r(di\014cations)e(ma)n(y)h(safely)f(b)r(e)i(made)f
-(to)f(the)i(cop)n(y)e(without)i(indirectly)227 1779 y(a\013ecting)g(an)
-n(y)e(other)h(Ob)5 b(ject.)0 1924 y Fd(Synopsis:)121
-b Ft(AstObject)40 b Fh(\003)p Ft(astCopy\()g(const)h(AstObject)f
-Fh(\003)p Ft(this)h(\))0 2069 y Fd(P)m(arameters:)259
-2201 y(this)427 2301 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5
-b(ject)27 b(to)h(b)r(e)g(copied.)0 2459 y Fd(Class)j(Applicabilit)m(y:)
-259 2591 y(Ob)5 b(ject)427 2690 y Fi(This)28 b(function)g(applies)f(to)
-h(all)f(Ob)5 b(jects.)0 2848 y Fd(Returned)32 b(V)-8
-b(alue:)259 2980 y(astCop)m(y\(\))427 3079 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(new)f(Ob)5 b(ject.)0 3237 y Fd(Notes:)340
-3515 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
+b(the)427 2848 y(description)27 b(of)h(the)g(AlignSystem)g(attribute)f
+(for)g(further)h(details.)340 2975 y Fh(\017)45 b Fi(When)d(aligning)e
+(\(sa)n(y\))g(t)n(w)n(o)h(images,)i(whic)n(h)e(ha)n(v)n(e)f(b)r(een)h
+(calibrated)f(b)n(y)h(attac)n(hing)f(F)-7 b(rameSets)41
+b(to)427 3075 y(them,)26 b(it)e(is)h(usually)e(necessary)g(to)h(con)n
+(v)n(ert)f(b)r(et)n(w)n(een)h(the)h(base)e(F)-7 b(rames)24
+b(\(represen)n(ting)f Ft(")p Fi(nativ)n(e)p Ft(")g Fi(pixel)427
+3175 y(co)r(ordinates\))f(of)g(b)r(oth)i(F)-7 b(rameSets.)34
+b(This)23 b(ma)n(y)f(b)r(e)h(ac)n(hiev)n(ed)f(b)n(y)g(in)n(v)n(erting)g
+(the)h(F)-7 b(rameSets)22 b(\(e.g.)35 b(using)427 3274
+y(astIn)n(v)n(ert\))27 b(so)g(as)g(to)g(in)n(terc)n(hange)f(their)i
+(base)f(and)g(curren)n(t)g(F)-7 b(rames)27 b(b)r(efore)g(using)g
+(astCon)n(v)n(ert.)340 3402 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
+(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
+427 3501 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 3690 3780 12 v 0 3821
+a Fz(astCop)l(y)1482 3822 y Fe(Cop)m(y)37 b(an)i(Ob)7
+b(ject)3302 3821 y Fz(astCop)l(y)0 4000 y Fd(Description:)44
+b Fi(This)38 b(function)h(creates)d(a)i(cop)n(y)f(of)h(an)f(Ob)5
+b(ject)38 b(and)g(returns)f(a)h(p)r(oin)n(ter)f(to)h(the)g(resulting)g
+(new)227 4100 y(Ob)5 b(ject.)62 b(It)36 b(mak)n(es)f(a)h
+Ft(")p Fi(deep)p Ft(")f Fi(cop)n(y)-7 b(,)38 b(whic)n(h)d(con)n(tains)h
+(no)f(references)g(to)h(an)n(y)f(other)g(Ob)5 b(ject)36
+b(\(i.e.)63 b(if)36 b(the)227 4200 y(original)29 b(Ob)5
+b(ject)31 b(con)n(tains)f(references)g(to)g(other)g(Ob)5
+b(jects,)32 b(then)f(the)g(actual)f(data)h(are)e(copied,)j(not)f
+(simply)227 4299 y(the)d(references\).)36 b(This)27 b(means)f(that)i
+(mo)r(di\014cations)e(ma)n(y)h(safely)f(b)r(e)i(made)f(to)f(the)i(cop)n
+(y)e(without)i(indirectly)227 4399 y(a\013ecting)g(an)n(y)e(other)h(Ob)
+5 b(ject.)0 4543 y Fd(Synopsis:)121 b Ft(AstObject)40
+b Fh(\003)p Ft(astCopy\()g(const)h(AstObject)f Fh(\003)p
+Ft(this)h(\))0 4687 y Fd(P)m(arameters:)259 4818 y(this)427
+4918 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5 b(ject)27
+b(to)h(b)r(e)g(copied.)0 5075 y Fd(Class)j(Applicabilit)m(y:)259
+5206 y(Ob)5 b(ject)427 5306 y Fi(This)28 b(function)g(applies)f(to)h
+(all)f(Ob)5 b(jects.)0 5462 y Fd(Returned)32 b(V)-8 b(alue:)259
+5593 y(astCop)m(y\(\))427 5693 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(new)f(Ob)5 b(ject.)p eop end
+%%Page: 217 227
+TeXDict begin 217 226 bop 3643 52 a FF(217)0 351 y Fd(Notes:)340
+628 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g
(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427
-3615 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
-(for)f(an)n(y)g(reason.)p 0 3805 V 0 3937 a Fz(astCurren)l(tTime)272
-b Fe(Return)38 b(the)h(curren)m(t)e(system)1776 4048
-y(time)2838 3937 y Fz(astCurren)l(tTime)0 4205 y Fd(Description:)44
-b Fi(This)33 b(function)g(returns)e(the)i(curren)n(t)f(system)g(time,)i
-(represen)n(ted)d(in)i(the)f(form)g(sp)r(eci\014ed)h(b)n(y)f(the)227
-4304 y(supplied)i(TimeF)-7 b(rame.)53 b(That)34 b(is,)g(the)g(returned)
-f(\015oating)f(p)r(oin)n(t)i(v)-5 b(alue)33 b(should)g(b)r(e)h(in)n
-(terpreted)e(using)h(the)227 4404 y(attribute)d(v)-5
-b(alues)28 b(of)h(the)h(TimeF)-7 b(rame.)41 b(This)29
-b(includes)g(System,)h(TimeOrigin,)e(L)-7 b(TO\013set,)30
-b(TimeScale,)f(and)227 4504 y(Unit.)0 4649 y Fd(Synopsis:)121
-b Ft(double)41 b(astCurrentTime\()c(AstTimeFrame)i Fh(\003)p
-Ft(this)i(\))0 4794 y Fd(P)m(arameters:)259 4926 y(this)427
-5026 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(TimeF)-7 b(rame.)0
-5183 y Fd(Returned)32 b(V)-8 b(alue:)259 5315 y(astCurren)m(tTime\(\))
-427 5415 y Fi(A)28 b(TimeF)-7 b(rame)27 b(axis)g(v)-5
-b(alue)28 b(represen)n(ting)e(the)i(curren)n(t)e(system)i(time.)0
-5572 y Fd(Notes:)p eop end
-%%Page: 217 227
-TeXDict begin 217 226 bop 3643 52 a FF(217)340 351 y
-Fh(\017)45 b Fi(V)-7 b(alues)29 b(of)g(AST)p Ft(__)p
-Fi(BAD)g(will)g(b)r(e)h(returned)e(if)i(this)f(function)h(is)f(in)n(v)n
-(ok)n(ed)e(with)j(the)f(AST)h(error)d(status)427 451
-y(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)340
-599 y Fh(\017)45 b Fi(It)33 b(is)f(assumes)f(that)i(the)g(system)f
-(time)g(\(returned)h(b)n(y)f(the)g(C)h(time\(\))g(function\))g(follo)n
-(ws)e(the)i(POSIX)427 698 y(standard,)24 b(represen)n(ting)e(a)h(con)n
-(tin)n(uous)f(monotonic)h(increasing)f(coun)n(t)h(of)g(SI)h(seconds)f
-(since)g(the)h(ep)r(o)r(c)n(h)427 798 y(00:00:00)j(UTC)k(1)e(Jan)n
-(uary)f(1970)g(AD)j(\(equiv)-5 b(alen)n(t)30 b(to)g(T)-7
-b(AI)30 b(with)g(a)g(constan)n(t)f(o\013set\).)44 b(Resolution)30
-b(is)427 898 y(one)d(second.)340 1046 y Fh(\017)45 b
-Fi(An)24 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)h(the)g(TimeF)-7
-b(rame)23 b(has)g(a)g(TimeScale)h(v)-5 b(alue)23 b(whic)n(h)h(cannot)f
-(b)r(e)h(con)n(v)n(erted)427 1145 y(to)k(T)-7 b(AI)28
-b(\(e.g.)36 b Ft(")p Fi(angular)p Ft(")26 b Fi(systems)h(suc)n(h)g(as)g
-(UT1,)g(GMST,)h(LMST)g(and)g(LAST\).)340 1293 y Fh(\017)45
-b Fi(An)n(y)28 b(inaccuracy)e(in)i(the)g(system)f(clo)r(c)n(k)g(will)h
-(b)r(e)g(re\015ected)f(in)h(the)g(v)-5 b(alue)27 b(returned)h(b)n(y)f
-(this)h(function.)p 0 1522 3780 12 v 0 1653 a Fz(astCurv)l(e)1318
-1654 y Fe(Dra)m(w)38 b(a)g(geo)s(desic)g(curv)m(e)3253
-1653 y Fz(astCurv)l(e)0 1873 y Fd(Description:)44 b Fi(This)21
-b(function)h(dra)n(ws)e(a)h(geo)r(desic)f(curv)n(e)g(b)r(et)n(w)n(een)h
-(t)n(w)n(o)g(p)r(oin)n(ts)g(in)g(the)h(ph)n(ysical)e(co)r(ordinate)g
-(system)227 1973 y(of)30 b(a)g(Plot.)43 b(The)30 b(curv)n(e)f(dra)n(wn)
-g(is)h(the)g(path)g(of)g(shortest)f(distance)h(joining)g(the)g(t)n(w)n
-(o)f(p)r(oin)n(ts)h(\(as)g(de\014ned)g(b)n(y)227 2072
-y(the)g(astDistance)e(function)i(for)e(the)h(curren)n(t)f(F)-7
+728 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
+(for)f(an)n(y)g(reason.)p 0 917 3780 12 v 0 1048 a Fz(astCurren)l
+(tTime)272 b Fe(Return)38 b(the)h(curren)m(t)e(system)1776
+1159 y(time)2838 1048 y Fz(astCurren)l(tTime)0 1314 y
+Fd(Description:)44 b Fi(This)33 b(function)g(returns)e(the)i(curren)n
+(t)f(system)g(time,)i(represen)n(ted)d(in)i(the)f(form)g(sp)r
+(eci\014ed)h(b)n(y)f(the)227 1414 y(supplied)i(TimeF)-7
+b(rame.)53 b(That)34 b(is,)g(the)g(returned)f(\015oating)f(p)r(oin)n(t)
+i(v)-5 b(alue)33 b(should)g(b)r(e)h(in)n(terpreted)e(using)h(the)227
+1513 y(attribute)d(v)-5 b(alues)28 b(of)h(the)h(TimeF)-7
+b(rame.)41 b(This)29 b(includes)g(System,)h(TimeOrigin,)e(L)-7
+b(TO\013set,)30 b(TimeScale,)f(and)227 1613 y(Unit.)0
+1757 y Fd(Synopsis:)121 b Ft(double)41 b(astCurrentTime\()c
+(AstTimeFrame)i Fh(\003)p Ft(this)i(\))0 1901 y Fd(P)m(arameters:)259
+2032 y(this)427 2132 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(TimeF)-7
+b(rame.)0 2288 y Fd(Returned)32 b(V)-8 b(alue:)259 2419
+y(astCurren)m(tTime\(\))427 2519 y Fi(A)28 b(TimeF)-7
+b(rame)27 b(axis)g(v)-5 b(alue)28 b(represen)n(ting)e(the)i(curren)n(t)
+e(system)i(time.)0 2675 y Fd(Notes:)340 2952 y Fh(\017)45
+b Fi(V)-7 b(alues)29 b(of)g(AST)p Ft(__)p Fi(BAD)g(will)g(b)r(e)h
+(returned)e(if)i(this)f(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(the)f
+(AST)h(error)d(status)427 3052 y(set,)h(or)f(if)h(it)g(should)f(fail)h
+(for)f(an)n(y)g(reason.)340 3180 y Fh(\017)45 b Fi(It)33
+b(is)f(assumes)f(that)i(the)g(system)f(time)g(\(returned)h(b)n(y)f(the)
+g(C)h(time\(\))g(function\))g(follo)n(ws)e(the)i(POSIX)427
+3279 y(standard,)24 b(represen)n(ting)e(a)h(con)n(tin)n(uous)f
+(monotonic)h(increasing)f(coun)n(t)h(of)g(SI)h(seconds)f(since)g(the)h
+(ep)r(o)r(c)n(h)427 3379 y(00:00:00)j(UTC)k(1)e(Jan)n(uary)f(1970)g(AD)
+j(\(equiv)-5 b(alen)n(t)30 b(to)g(T)-7 b(AI)30 b(with)g(a)g(constan)n
+(t)f(o\013set\).)44 b(Resolution)30 b(is)427 3478 y(one)d(second.)340
+3606 y Fh(\017)45 b Fi(An)24 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)
+h(the)g(TimeF)-7 b(rame)23 b(has)g(a)g(TimeScale)h(v)-5
+b(alue)23 b(whic)n(h)h(cannot)f(b)r(e)h(con)n(v)n(erted)427
+3705 y(to)k(T)-7 b(AI)28 b(\(e.g.)36 b Ft(")p Fi(angular)p
+Ft(")26 b Fi(systems)h(suc)n(h)g(as)g(UT1,)g(GMST,)h(LMST)g(and)g
+(LAST\).)340 3833 y Fh(\017)45 b Fi(An)n(y)28 b(inaccuracy)e(in)i(the)g
+(system)f(clo)r(c)n(k)g(will)h(b)r(e)g(re\015ected)f(in)h(the)g(v)-5
+b(alue)27 b(returned)h(b)n(y)f(this)h(function.)p 0 4021
+V 0 4152 a Fz(astCurv)l(e)1318 4153 y Fe(Dra)m(w)38 b(a)g(geo)s(desic)g
+(curv)m(e)3253 4152 y Fz(astCurv)l(e)0 4331 y Fd(Description:)44
+b Fi(This)21 b(function)h(dra)n(ws)e(a)h(geo)r(desic)f(curv)n(e)g(b)r
+(et)n(w)n(een)h(t)n(w)n(o)g(p)r(oin)n(ts)g(in)g(the)h(ph)n(ysical)e(co)
+r(ordinate)g(system)227 4431 y(of)30 b(a)g(Plot.)43 b(The)30
+b(curv)n(e)f(dra)n(wn)g(is)h(the)g(path)g(of)g(shortest)f(distance)h
+(joining)g(the)g(t)n(w)n(o)f(p)r(oin)n(ts)h(\(as)g(de\014ned)g(b)n(y)
+227 4530 y(the)g(astDistance)e(function)i(for)e(the)h(curren)n(t)f(F)-7
b(rame)29 b(of)g(the)g(Plot\).)40 b(F)-7 b(or)29 b(example,)g(if)g(the)
-g(curren)n(t)f(F)-7 b(rame)29 b(is)227 2172 y(a)g(basic)f(F)-7
+g(curren)n(t)f(F)-7 b(rame)29 b(is)227 4630 y(a)g(basic)f(F)-7
b(rame,)28 b(then)i(the)f(curv)n(e)f(joining)g(the)h(t)n(w)n(o)f(p)r
(oin)n(ts)h(will)g(b)r(e)g(a)f(straigh)n(t)g(line)h(in)g(ph)n(ysical)f
-(co)r(ordinate)227 2272 y(space.)34 b(If)23 b(the)f(curren)n(t)f(F)-7
+(co)r(ordinate)227 4730 y(space.)34 b(If)23 b(the)f(curren)n(t)f(F)-7
b(rame)21 b(is)h(more)f(sp)r(ecialised)g(and)h(describ)r(es,)g(for)g
-(instance,)g(a)g(sky)f(co)r(ordinate)g(system,)227 2371
+(instance,)g(a)g(sky)f(co)r(ordinate)g(system,)227 4829
y(then)32 b(the)f(geo)r(desic)g(curv)n(e)f(w)n(ould)g(b)r(e)i(a)f
(great)e(circle)i(in)g(ph)n(ysical)g(co)r(ordinate)e(space)i(passing)f
-(through)g(the)227 2471 y(t)n(w)n(o)d(sky)g(p)r(ositions)g(giv)n(en.)
-227 2610 y(Note)g(that)g(the)g(geo)r(desic)f(curv)n(e)g(is)h
+(through)g(the)227 4929 y(t)n(w)n(o)d(sky)g(p)r(ositions)g(giv)n(en.)
+227 5051 y(Note)g(that)g(the)g(geo)r(desic)f(curv)n(e)g(is)h
(transformed)e(in)n(to)i(graphical)e(co)r(ordinate)h(space)g(for)g
-(plotting,)h(so)f(that)h(a)227 2710 y(straigh)n(t)20
+(plotting,)h(so)f(that)h(a)227 5150 y(straigh)n(t)20
b(line)h(in)g(ph)n(ysical)e(co)r(ordinates)h(ma)n(y)g(result)g(in)h(a)f
(curv)n(ed)g(line)h(b)r(eing)g(dra)n(wn)e(if)j(the)f(Mapping)f(in)n(v)n
-(olv)n(ed)227 2810 y(is)29 b(non-linear.)40 b(An)n(y)29
+(olv)n(ed)227 5250 y(is)29 b(non-linear.)40 b(An)n(y)29
b(discon)n(tin)n(uities)g(in)g(the)h(Mapping)e(b)r(et)n(w)n(een)h(ph)n
(ysical)g(and)f(graphical)g(co)r(ordinates)g(are)227
-2909 y(catered)f(for,)g(as)g(is)h(an)n(y)e(clipping)i(established)f
-(using)h(astClip.)227 3049 y(If)c(y)n(ou)f(need)h(to)g(dra)n(w)e(man)n
+5350 y(catered)f(for,)g(as)g(is)h(an)n(y)e(clipping)i(established)f
+(using)h(astClip.)227 5472 y(If)c(y)n(ou)f(need)h(to)g(dra)n(w)e(man)n
(y)h(geo)r(desic)g(curv)n(es)g(end-to-end,)h(then)g(the)g(astP)n
(olyCurv)n(e)d(function)j(is)g(equiv)-5 b(alen)n(t)227
-3149 y(to)28 b(rep)r(eatedly)f(using)g(astCurv)n(e,)f(but)j(will)e
-(usually)h(b)r(e)g(more)e(e\016cien)n(t.)227 3288 y(If)i(y)n(ou)f(need)
+5571 y(to)28 b(rep)r(eatedly)f(using)g(astCurv)n(e,)f(but)j(will)e
+(usually)h(b)r(e)g(more)e(e\016cien)n(t.)227 5693 y(If)i(y)n(ou)f(need)
h(to)f(dra)n(w)g(curv)n(es)f(whic)n(h)i(are)e(not)i(geo)r(desics,)e
-(see)i(astGenCurv)n(e)e(or)h(astGridLine.)0 3468 y Fd(Synopsis:)121
+(see)i(astGenCurv)n(e)e(or)h(astGridLine.)p eop end
+%%Page: 218 228
+TeXDict begin 218 227 bop 0 52 a FF(218)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Synopsis:)121
b Ft(void)42 b(astCurve\()e(AstPlot)g Fh(\003)p Ft(this,)h(const)h
(double)f(start[],)f(const)i(double)f(finish[])f(\))0
-3647 y Fd(P)m(arameters:)259 3814 y(this)427 3913 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(Plot.)259 4061 y Fd(start)427 4161 y Fi(An)j(arra)n(y)-7
+497 y Fd(P)m(arameters:)259 629 y(this)427 729 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(Plot.)259 858 y Fd(start)427 957 y Fi(An)j(arra)n(y)-7
b(,)30 b(with)h(one)f(elemen)n(t)h(for)f(eac)n(h)g(axis)g(of)h(the)g
(Plot,)g(giving)e(the)j(ph)n(ysical)d(co)r(ordinates)h(of)g(the)427
-4261 y(\014rst)e(p)r(oin)n(t)f(on)h(the)g(geo)r(desic)e(curv)n(e.)259
-4408 y Fd(\014nish)427 4508 y Fi(An)31 b(arra)n(y)-7
+1057 y(\014rst)e(p)r(oin)n(t)f(on)h(the)g(geo)r(desic)e(curv)n(e.)259
+1186 y Fd(\014nish)427 1285 y Fi(An)31 b(arra)n(y)-7
b(,)30 b(with)h(one)f(elemen)n(t)h(for)f(eac)n(h)g(axis)g(of)h(the)g
(Plot,)g(giving)e(the)j(ph)n(ysical)d(co)r(ordinates)h(of)g(the)427
-4608 y(second)d(p)r(oin)n(t)h(on)f(the)h(geo)r(desic)f(curv)n(e.)0
-4800 y Fd(Notes:)340 5112 y Fh(\017)45 b Fi(No)33 b(curv)n(e)f(is)h
+1385 y(second)d(p)r(oin)n(t)h(on)f(the)h(geo)r(desic)f(curv)n(e.)0
+1543 y Fd(Notes:)340 1821 y Fh(\017)45 b Fi(No)33 b(curv)n(e)f(is)h
(dra)n(wn)g(if)g(either)g(of)g(the)h Ft(")p Fi(start)p
Ft(")e Fi(or)g Ft(")p Fi(\014nish)p Ft(")g Fi(arra)n(ys)f(con)n(tains)h
-(an)n(y)g(co)r(ordinates)g(with)427 5212 y(the)c(v)-5
-b(alue)28 b(AST)p Ft(__)p Fi(BAD.)340 5360 y Fh(\017)45
+(an)n(y)g(co)r(ordinates)g(with)427 1921 y(the)c(v)-5
+b(alue)28 b(AST)p Ft(__)p Fi(BAD.)340 2050 y Fh(\017)45
b Fi(An)28 b(error)e(results)h(if)h(the)g(base)f(F)-7
b(rame)27 b(of)h(the)g(Plot)f(is)g(not)h(2-dimensional.)340
-5508 y Fh(\017)45 b Fi(An)30 b(error)d(also)g(results)i(if)g(the)g
+2178 y Fh(\017)45 b Fi(An)30 b(error)d(also)g(results)i(if)g(the)g
(transformation)f(b)r(et)n(w)n(een)h(the)g(curren)n(t)f(and)h(base)f(F)
--7 b(rames)28 b(of)h(the)g(Plot)427 5607 y(is)f(not)f(de\014ned)h
+-7 b(rames)28 b(of)h(the)g(Plot)427 2278 y(is)f(not)f(de\014ned)h
(\(i.e.)38 b(the)28 b(Plot's)e(T)-7 b(ranIn)n(v)n(erse)26
-b(attribute)h(is)h(zero\).)p eop end
-%%Page: 218 228
-TeXDict begin 218 227 bop 0 52 a FF(218)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 482 a Fz(astDSBSp)t(ecF)-11 b(rame)169 b Fe(Create)37
-b(a)i(DSBSp)s(ecF)-10 b(rame)169 b Fz(astDSBSp)t(ecF)-11
-b(rame)0 664 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f
-(a)g(new)g(DSBSp)r(ecF)-7 b(rame)28 b(and)g(optionally)e(initialises)i
-(its)f(attributes.)227 787 y(A)37 b(DSBSp)r(ecF)-7 b(rame)37
-b(is)f(a)g(sp)r(ecialised)g(form)g(of)h(Sp)r(ecF)-7 b(rame)36
-b(whic)n(h)h(represen)n(ts)e(p)r(ositions)h(in)g(a)g(sp)r(ectrum)227
-886 y(obtained)f(using)g(a)f(dual)h(sideband)g(instrumen)n(t.)60
-b(Suc)n(h)35 b(an)g(instrumen)n(t)g(pro)r(duces)f(a)h(sp)r(ectrum)g(in)
-h(whic)n(h)227 986 y(eac)n(h)f(p)r(oin)n(t)h(con)n(tains)e(con)n
-(tributions)h(from)g(t)n(w)n(o)g(distinctly)h(di\013eren)n(t)f
-(frequencies,)i(one)f(from)f(the)h Ft(")p Fi(lo)n(w)n(er)227
-1086 y(side)41 b(band)p Ft(")f Fi(\(LSB\))h(and)f(one)g(from)h(the)g
-Ft(")p Fi(upp)r(er)f(side)g(band)p Ft(")g Fi(\(USB\).)i(Corresp)r
-(onding)d(LSB)h(and)g(USB)227 1185 y(frequencies)d(are)f(connected)h(b)
-n(y)g(the)g(fact)h(that)f(they)g(are)g(an)f(equal)h(distance)g(on)g
-(either)g(side)g(of)g(a)g(\014xed)227 1285 y(cen)n(tral)27
-b(frequency)g(kno)n(wn)g(as)g(the)h Ft(")p Fi(Lo)r(cal)e(Oscillator)p
-Ft(")g Fi(\(LO\))i(frequency)-7 b(.)227 1408 y(When)33
-b(quoting)e(a)g(p)r(osition)h(within)g(suc)n(h)g(a)f(sp)r(ectrum,)i(it)
-g(is)e(necessary)f(to)i(indicate)g(whether)g(the)g(quoted)227
-1507 y(p)r(osition)27 b(is)g(the)g(USB)g(p)r(osition)g(or)f(the)i
-(corresp)r(onding)d(LSB)i(p)r(osition.)36 b(The)27 b(SideBand)g
-(attribute)g(pro)n(vides)227 1607 y(this)36 b(indication.)60
-b(Another)35 b(option)g(that)h(the)f(SideBand)g(attribute)h(pro)n
-(vides)e(is)h(to)g(represen)n(t)f(a)h(sp)r(ectral)227
-1707 y(p)r(osition)28 b(b)n(y)f(its)h(top)r(o)r(cen)n(tric)f(o\013set)g
-(from)h(the)g(LO)f(frequency)-7 b(.)227 1829 y(In)32
-b(practice,)f(the)h(LO)f(frequency)g(is)g(sp)r(eci\014ed)g(b)n(y)g
-(giving)g(the)h(distance)f(from)g(the)g(LO)g(frequency)g(to)g(some)227
-1929 y Ft(")p Fi(cen)n(tral)p Ft(")37 b Fi(sp)r(ectral)h(p)r(osition.)
-69 b(T)n(ypically)37 b(this)i(cen)n(tral)e(p)r(osition)h(is)h(that)f
-(of)h(some)f(in)n(teresting)f(sp)r(ectral)227 2029 y(feature.)f(The)23
-b(distance)h(from)f(this)h(cen)n(tral)f(p)r(osition)g(to)h(the)g(LO)f
-(frequency)g(is)g(kno)n(wn)g(as)g(the)h Ft(")p Fi(in)n(termediate)227
-2128 y(frequency)p Ft(")k Fi(\(IF\).)h(The)g(v)-5 b(alue)28
-b(supplied)h(for)f(IF)h(can)f(b)r(e)h(a)f(signed)g(v)-5
-b(alue)28 b(in)h(order)e(to)h(indicate)h(whether)f(the)227
-2228 y(LO)f(frequency)h(is)f(ab)r(o)n(v)n(e)f(or)h(b)r(elo)n(w)g(the)h
-(cen)n(tral)f(p)r(osition.)0 2374 y Fd(Synopsis:)121
+b(attribute)h(is)h(zero\).)p 0 2469 3780 12 v 0 2600
+a Fz(astDSBSp)t(ecF)-11 b(rame)169 b Fe(Create)37 b(a)i(DSBSp)s(ecF)-10
+b(rame)169 b Fz(astDSBSp)t(ecF)-11 b(rame)0 2781 y Fd(Description:)44
+b Fi(This)28 b(function)g(creates)f(a)g(new)g(DSBSp)r(ecF)-7
+b(rame)28 b(and)g(optionally)e(initialises)i(its)f(attributes.)227
+2903 y(A)37 b(DSBSp)r(ecF)-7 b(rame)37 b(is)f(a)g(sp)r(ecialised)g
+(form)g(of)h(Sp)r(ecF)-7 b(rame)36 b(whic)n(h)h(represen)n(ts)e(p)r
+(ositions)h(in)g(a)g(sp)r(ectrum)227 3003 y(obtained)f(using)g(a)f
+(dual)h(sideband)g(instrumen)n(t.)60 b(Suc)n(h)35 b(an)g(instrumen)n(t)
+g(pro)r(duces)f(a)h(sp)r(ectrum)g(in)h(whic)n(h)227 3103
+y(eac)n(h)f(p)r(oin)n(t)h(con)n(tains)e(con)n(tributions)h(from)g(t)n
+(w)n(o)g(distinctly)h(di\013eren)n(t)f(frequencies,)i(one)f(from)f(the)
+h Ft(")p Fi(lo)n(w)n(er)227 3202 y(side)41 b(band)p Ft(")f
+Fi(\(LSB\))h(and)f(one)g(from)h(the)g Ft(")p Fi(upp)r(er)f(side)g(band)
+p Ft(")g Fi(\(USB\).)i(Corresp)r(onding)d(LSB)h(and)g(USB)227
+3302 y(frequencies)d(are)f(connected)h(b)n(y)g(the)g(fact)h(that)f
+(they)g(are)g(an)f(equal)h(distance)g(on)g(either)g(side)g(of)g(a)g
+(\014xed)227 3401 y(cen)n(tral)27 b(frequency)g(kno)n(wn)g(as)g(the)h
+Ft(")p Fi(Lo)r(cal)e(Oscillator)p Ft(")g Fi(\(LO\))i(frequency)-7
+b(.)227 3524 y(When)33 b(quoting)e(a)g(p)r(osition)h(within)g(suc)n(h)g
+(a)f(sp)r(ectrum,)i(it)g(is)e(necessary)f(to)i(indicate)g(whether)g
+(the)g(quoted)227 3624 y(p)r(osition)27 b(is)g(the)g(USB)g(p)r(osition)
+g(or)f(the)i(corresp)r(onding)d(LSB)i(p)r(osition.)36
+b(The)27 b(SideBand)g(attribute)g(pro)n(vides)227 3723
+y(this)36 b(indication.)60 b(Another)35 b(option)g(that)h(the)f
+(SideBand)g(attribute)h(pro)n(vides)e(is)h(to)g(represen)n(t)f(a)h(sp)r
+(ectral)227 3823 y(p)r(osition)28 b(b)n(y)f(its)h(top)r(o)r(cen)n(tric)
+f(o\013set)g(from)h(the)g(LO)f(frequency)-7 b(.)227 3945
+y(In)32 b(practice,)f(the)h(LO)f(frequency)g(is)g(sp)r(eci\014ed)g(b)n
+(y)g(giving)g(the)h(distance)f(from)g(the)g(LO)g(frequency)g(to)g(some)
+227 4045 y Ft(")p Fi(cen)n(tral)p Ft(")37 b Fi(sp)r(ectral)h(p)r
+(osition.)69 b(T)n(ypically)37 b(this)i(cen)n(tral)e(p)r(osition)h(is)h
+(that)f(of)h(some)f(in)n(teresting)f(sp)r(ectral)227
+4145 y(feature.)f(The)23 b(distance)h(from)f(this)h(cen)n(tral)f(p)r
+(osition)g(to)h(the)g(LO)f(frequency)g(is)g(kno)n(wn)g(as)g(the)h
+Ft(")p Fi(in)n(termediate)227 4244 y(frequency)p Ft(")k
+Fi(\(IF\).)h(The)g(v)-5 b(alue)28 b(supplied)h(for)f(IF)h(can)f(b)r(e)h
+(a)f(signed)g(v)-5 b(alue)28 b(in)h(order)e(to)h(indicate)h(whether)f
+(the)227 4344 y(LO)f(frequency)h(is)f(ab)r(o)n(v)n(e)f(or)h(b)r(elo)n
+(w)g(the)h(cen)n(tral)f(p)r(osition.)0 4489 y Fd(Synopsis:)121
b Ft(AstDSBSpecFrame)37 b Fh(\003)p Ft(astDSBSpecFrame\()g(const)k
-(char)h Fh(\003)p Ft(options,)e(...)86 b(\))0 2520 y
-Fd(P)m(arameters:)259 2653 y(options)427 2752 y Fi(P)n(oin)n(ter)27
+(char)h Fh(\003)p Ft(options,)e(...)86 b(\))0 4635 y
+Fd(P)m(arameters:)259 4767 y(options)427 4867 y Fi(P)n(oin)n(ter)27
b(to)h(a)g(n)n(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)
-g(comma-separated)e(list)i(of)g(attribute)427 2852 y(assignmen)n(ts)f
+g(comma-separated)e(list)i(of)g(attribute)427 4966 y(assignmen)n(ts)f
(to)g(b)r(e)h(used)g(for)f(initialising)g(the)h(new)g(DSBSp)r(ecF)-7
b(rame.)37 b(The)28 b(syn)n(tax)f(used)g(is)h(iden)n(tical)427
-2952 y(to)h(that)h(for)f(the)g(astSet)g(function)h(and)f(ma)n(y)g
+5066 y(to)h(that)h(for)f(the)g(astSet)g(function)h(and)f(ma)n(y)g
(include)g Ft(")p Fi(prin)n(tf)p Ft(")g Fi(format)g(sp)r(eci\014ers)f
(iden)n(ti\014ed)i(b)n(y)f Ft(")p Fi(\045)p Ft(")427
-3051 y Fi(sym)n(b)r(ols)e(in)h(the)g(normal)f(w)n(a)n(y)-7
-b(.)259 3181 y Fd(...)427 3280 y Fi(If)38 b(the)g Ft(")p
+5166 y Fi(sym)n(b)r(ols)e(in)h(the)g(normal)f(w)n(a)n(y)-7
+b(.)259 5295 y Fd(...)427 5394 y Fi(If)38 b(the)g Ft(")p
Fi(options)p Ft(")e Fi(string)h(con)n(tains)f Ft(")p
Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g
-(list)h(of)f(additional)427 3380 y(argumen)n(ts)26 b(ma)n(y)h(follo)n
+(list)h(of)f(additional)427 5494 y(argumen)n(ts)26 b(ma)n(y)h(follo)n
(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5 b(alues)27
b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)37
-b(The)427 3480 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+b(The)427 5593 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 3579 y Fi(function\).)0
-3738 y Fd(Returned)32 b(V)-8 b(alue:)259 3871 y(astDSBSp)s(ecF)g
-(rame\(\))427 3970 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(DSBSp)r
-(ecF)-7 b(rame.)0 4129 y Fd(Notes:)340 4408 y Fh(\017)45
-b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 5693 y Fi(function\).)p
+eop end
+%%Page: 219 229
+TeXDict begin 219 228 bop 3643 52 a FF(219)0 351 y Fd(Returned)32
+b(V)-8 b(alue:)259 487 y(astDSBSp)s(ecF)g(rame\(\))427
+586 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(DSBSp)r(ecF)-7
+b(rame.)0 747 y Fd(Notes:)340 1029 y Fh(\017)45 b Fi(A)35
+b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
-(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 4507 y(AST)28
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 1129 y(AST)28
b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)p 0 4700 V 0 4830 a Fz(astDecomp)t(ose)246 b
-Fe(Decomp)s(ose)39 b(a)f(Mapping)g(in)m(to)f(t)m(w)m(o)1342
-4943 y(comp)s(onen)m(t)g(Mappings)2945 4830 y Fz(astDecomp)t(ose)0
-5125 y Fd(Description:)44 b Fi(This)33 b(function)h(returns)e(p)r(oin)n
+(reason.)p 0 1326 3780 12 v 0 1457 a Fz(astDecomp)t(ose)1079
+1456 y Fe(Decomp)s(ose)39 b(a)f(Mapping)g(in)m(to)f(t)m(w)m(o)1342
+1570 y(comp)s(onen)m(t)g(Mappings)2945 1457 y Fz(astDecomp)t(ose)0
+1757 y Fd(Description:)44 b Fi(This)33 b(function)h(returns)e(p)r(oin)n
(ters)g(to)h(t)n(w)n(o)f(Mappings)g(whic)n(h,)j(when)e(applied)g
-(either)f(in)i(series)d(or)227 5225 y(parallel,)c(are)f(equiv)-5
-b(alen)n(t)28 b(to)f(the)h(supplied)g(Mapping.)227 5348
+(either)f(in)i(series)d(or)227 1856 y(parallel,)c(are)f(equiv)-5
+b(alen)n(t)28 b(to)f(the)h(supplied)g(Mapping.)227 1980
y(Since)h(the)g(F)-7 b(rame)28 b(class)f(inherits)i(from)f(the)h
(Mapping)f(class,)g(F)-7 b(rames)27 b(can)h(b)r(e)h(considered)f(as)f
-(sp)r(ecial)i(t)n(yp)r(es)227 5447 y(of)f(Mappings)f(and)g(so)g(this)h
+(sp)r(ecial)i(t)n(yp)r(es)227 2080 y(of)f(Mappings)f(and)g(so)g(this)h
(metho)r(d)g(can)f(b)r(e)h(used)g(to)f(decomp)r(ose)g(either)h(CmpMaps)
-f(or)g(CmpF)-7 b(rames.)0 5593 y Fd(Synopsis:)121 b Ft(void)42
+f(or)g(CmpF)-7 b(rames.)0 2229 y Fd(Synopsis:)121 b Ft(void)42
b(astDecompose\()c(AstMapping)h Fh(\003)p Ft(this,)i(AstMapping)f
Fh(\003\003)p Ft(map1,)g(AstMapping)g Fh(\003\003)p Ft(map2,)g(int)227
-5693 y Fh(\003)p Ft(series,)g(int)j Fh(\003)p Ft(invert1,)d(int)i
-Fh(\003)p Ft(invert2)e(\))p eop end
-%%Page: 219 229
-TeXDict begin 219 228 bop 3643 52 a FF(219)0 351 y Fd(P)m(arameters:)
-259 504 y(this)427 604 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Mapping.)259
-745 y Fd(map1)427 845 y Fi(Address)f(of)h(a)f(lo)r(cation)g(to)h
+2328 y Fh(\003)p Ft(series,)g(int)j Fh(\003)p Ft(invert1,)d(int)i
+Fh(\003)p Ft(invert2)e(\))0 2477 y Fd(P)m(arameters:)259
+2612 y(this)427 2712 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Mapping.)259
+2844 y Fd(map1)427 2944 y Fi(Address)f(of)h(a)f(lo)r(cation)g(to)h
(receiv)n(e)e(a)h(p)r(oin)n(ter)g(to)h(\014rst)f(comp)r(onen)n(t)g
-(Mapping.)259 986 y Fd(map2)427 1085 y Fi(Address)g(of)h(a)f(lo)r
+(Mapping.)259 3075 y Fd(map2)427 3175 y Fi(Address)g(of)h(a)f(lo)r
(cation)g(to)h(receiv)n(e)e(a)h(p)r(oin)n(ter)g(to)h(second)f(comp)r
-(onen)n(t)g(Mapping.)259 1227 y Fd(series)427 1326 y
+(onen)n(t)g(Mapping.)259 3307 y Fd(series)427 3407 y
Fi(Address)33 b(of)h(a)f(lo)r(cation)g(to)h(receiv)n(e)e(a)h(v)-5
b(alue)34 b(indicating)f(if)i(the)f(comp)r(onen)n(t)f(Mappings)g(are)g
-(applied)427 1426 y(in)38 b(series)e(or)h(parallel.)65
+(applied)427 3506 y(in)38 b(series)e(or)h(parallel.)65
b(A)38 b(non-zero)e(v)-5 b(alue)37 b(means)g(that)h(the)f(supplied)h
-(Mapping)f(is)h(equiv)-5 b(alen)n(t)37 b(to)427 1526
+(Mapping)f(is)h(equiv)-5 b(alen)n(t)37 b(to)427 3606
y(applying)26 b(map1)g(follo)n(w)n(ed)g(b)n(y)g(map2)g(in)h(series.)35
b(A)27 b(zero)e(v)-5 b(alue)27 b(means)f(that)h(the)g(supplied)g
-(Mapping)f(is)427 1625 y(equiv)-5 b(alen)n(t)29 b(to)g(applying)f(map1)
+(Mapping)f(is)427 3706 y(equiv)-5 b(alen)n(t)29 b(to)g(applying)f(map1)
g(to)h(the)g(lo)n(w)n(er)f(n)n(um)n(b)r(ered)g(axes)g(and)h(map2)g(to)f
-(the)i(higher)e(n)n(um)n(b)r(ered)427 1725 y(axes,)f(in)h(parallel.)259
-1866 y Fd(in)m(v)m(ert1)427 1966 y Fi(The)g(v)-5 b(alue)27
+(the)i(higher)e(n)n(um)n(b)r(ered)427 3805 y(axes,)f(in)h(parallel.)259
+3937 y Fd(in)m(v)m(ert1)427 4037 y Fi(The)g(v)-5 b(alue)27
b(of)h(the)g(In)n(v)n(ert)f(attribute)g(to)h(b)r(e)g(used)f(with)i
-(map1.)259 2107 y Fd(in)m(v)m(ert2)427 2206 y Fi(The)f(v)-5
+(map1.)259 4169 y Fd(in)m(v)m(ert2)427 4268 y Fi(The)f(v)-5
b(alue)27 b(of)h(the)g(In)n(v)n(ert)f(attribute)g(to)h(b)r(e)g(used)f
-(with)i(map2.)0 2385 y Fd(Class)i(Applicabilit)m(y:)259
-2538 y(CmpMap)427 2637 y Fi(If)22 b(the)g(supplied)g(Mapping)g(is)f(a)g
+(with)i(map2.)0 4429 y Fd(Class)i(Applicabilit)m(y:)259
+4565 y(CmpMap)427 4664 y Fi(If)22 b(the)g(supplied)g(Mapping)g(is)f(a)g
(CmpMap,)i(then)f(map1)f(and)h(map2)f(will)h(b)r(e)g(returned)f
-(holding)g(p)r(oin)n(ters)427 2737 y(to)31 b(the)g(comp)r(onen)n(t)g
+(holding)g(p)r(oin)n(ters)427 4764 y(to)31 b(the)g(comp)r(onen)n(t)g
(Mappings)f(used)h(to)g(create)f(the)h(CmpMap,)h(either)f(in)g(series)f
-(or)g(parallel.)46 b(Note,)427 2837 y(c)n(hanging)19
+(or)g(parallel.)46 b(Note,)427 4864 y(c)n(hanging)19
b(the)i(In)n(v)n(ert)e(attribute)h(of)h(either)f(of)g(the)g(comp)r
(onen)n(t)g(Mappings)g(using)g(the)g(returned)g(p)r(oin)n(ters)427
-2936 y(will)31 b(ha)n(v)n(e)e(no)g(e\013ect)i(on)f(the)g(supplied)h
+4963 y(will)31 b(ha)n(v)n(e)e(no)g(e\013ect)i(on)f(the)g(supplied)h
(CmpMap.)44 b(This)30 b(is)g(b)r(ecause)g(the)g(CmpMap)h(remem)n(b)r
-(ers)e(and)427 3036 y(uses)f(the)h(original)e(settings)i(of)f(the)h(In)
+(ers)e(and)427 5063 y(uses)f(the)h(original)e(settings)i(of)f(the)h(In)
n(v)n(ert)f(attributes)g(\(that)i(is,)e(the)h(v)-5 b(alues)29
-b(of)f(the)h(In)n(v)n(ert)f(attributes)427 3136 y(when)37
+b(of)f(the)h(In)n(v)n(ert)f(attributes)427 5163 y(when)37
b(the)g(CmpMap)g(w)n(as)e(\014rst)h(created\).)64 b(These)36
b(are)f(the)i(In)n(v)n(ert)f(v)-5 b(alues)36 b(whic)n(h)h(are)e
-(returned)h(in)427 3235 y(in)n(v)n(ert1)27 b(and)g(in)n(v)n(ert2.)259
-3376 y Fd(T)-8 b(ranMap)427 3476 y Fi(If)22 b(the)h(supplied)f(Mapping)
+(returned)h(in)427 5262 y(in)n(v)n(ert1)27 b(and)g(in)n(v)n(ert2.)259
+5394 y Fd(T)-8 b(ranMap)427 5494 y Fi(If)22 b(the)h(supplied)f(Mapping)
f(is)h(a)f(T)-7 b(ranMap,)22 b(then)g(map1)g(and)f(map2)g(will)h(b)r(e)
-h(returned)e(holding)g(p)r(oin)n(ters)427 3576 y(to)28
+h(returned)e(holding)g(p)r(oin)n(ters)427 5593 y(to)28
b(the)h(forw)n(ard)d(and)i(in)n(v)n(erse)f(Mappings)g(represen)n(ted)g
(b)n(y)h(the)g(T)-7 b(ranMap)27 b(\(zero)h(will)g(b)r(e)g(returned)g
-(for)427 3675 y(series\).)46 b(Note,)32 b(c)n(hanging)d(the)j(In)n(v)n
+(for)427 5693 y(series\).)46 b(Note,)32 b(c)n(hanging)d(the)j(In)n(v)n
(ert)d(attribute)i(of)g(either)g(of)g(the)g(comp)r(onen)n(t)g(Mappings)
-f(using)g(the)427 3775 y(returned)25 b(p)r(oin)n(ters)g(will)h(ha)n(v)n
-(e)e(no)h(e\013ect)h(on)f(the)g(supplied)h(T)-7 b(ranMap.)35
-b(This)26 b(is)f(b)r(ecause)g(the)h(T)-7 b(ranMap)427
-3875 y(remem)n(b)r(ers)31 b(and)g(uses)h(the)g(original)e(settings)h
-(of)h(the)f(In)n(v)n(ert)g(attributes)h(\(that)g(is,)g(the)g(v)-5
-b(alues)32 b(of)f(the)427 3974 y(In)n(v)n(ert)23 b(attributes)h(when)g
-(the)h(T)-7 b(ranMap)23 b(w)n(as)f(\014rst)i(created\).)35
-b(These)24 b(are)f(the)h(In)n(v)n(ert)f(v)-5 b(alues)24
-b(whic)n(h)g(are)427 4074 y(returned)j(in)h(in)n(v)n(ert1)f(and)g(in)n
-(v)n(ert2.)259 4215 y Fd(Mapping)427 4315 y Fi(F)-7 b(or)31
-b(an)n(y)g(class)f(of)i(Mapping)f(other)g(than)g(a)g(CmpMap,)i(map1)e
-(will)h(b)r(e)f(returned)g(holding)h(a)f(clone)g(of)427
-4414 y(the)f(supplied)g(Mapping)g(p)r(oin)n(ter,)g(and)f(map2)g(will)h
-(b)r(e)g(returned)g(holding)f(a)g(NULL)h(p)r(oin)n(ter.)43
-b(In)n(v)n(ert1)427 4514 y(will)30 b(b)r(e)g(returned)g(holding)f(the)h
+f(using)g(the)p eop end
+%%Page: 220 230
+TeXDict begin 220 229 bop 0 52 a FF(220)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)427 351 y Fi(returned)25
+b(p)r(oin)n(ters)g(will)h(ha)n(v)n(e)e(no)h(e\013ect)h(on)f(the)g
+(supplied)h(T)-7 b(ranMap.)35 b(This)26 b(is)f(b)r(ecause)g(the)h(T)-7
+b(ranMap)427 451 y(remem)n(b)r(ers)31 b(and)g(uses)h(the)g(original)e
+(settings)h(of)h(the)f(In)n(v)n(ert)g(attributes)h(\(that)g(is,)g(the)g
+(v)-5 b(alues)32 b(of)f(the)427 551 y(In)n(v)n(ert)23
+b(attributes)h(when)g(the)h(T)-7 b(ranMap)23 b(w)n(as)f(\014rst)i
+(created\).)35 b(These)24 b(are)f(the)h(In)n(v)n(ert)f(v)-5
+b(alues)24 b(whic)n(h)g(are)427 650 y(returned)j(in)h(in)n(v)n(ert1)f
+(and)g(in)n(v)n(ert2.)259 806 y Fd(Mapping)427 905 y
+Fi(F)-7 b(or)31 b(an)n(y)g(class)f(of)i(Mapping)f(other)g(than)g(a)g
+(CmpMap,)i(map1)e(will)h(b)r(e)f(returned)g(holding)h(a)f(clone)g(of)
+427 1005 y(the)f(supplied)g(Mapping)g(p)r(oin)n(ter,)g(and)f(map2)g
+(will)h(b)r(e)g(returned)g(holding)f(a)g(NULL)h(p)r(oin)n(ter.)43
+b(In)n(v)n(ert1)427 1105 y(will)30 b(b)r(e)g(returned)g(holding)f(the)h
(curren)n(t)f(v)-5 b(alue)29 b(of)h(the)g(In)n(v)n(ert)f(attribute)h
-(for)f(the)h(supplied)g(Mapping,)427 4613 y(and)e(in)n(v)n(ert2)e(will)
-i(b)r(e)g(returned)f(holding)g(zero.)259 4755 y Fd(CmpF)-8
-b(rame)427 4854 y Fi(If)40 b(the)g(supplied)f(Mapping)g(is)h(a)e(CmpF)
+(for)f(the)h(supplied)g(Mapping,)427 1204 y(and)e(in)n(v)n(ert2)e(will)
+i(b)r(e)g(returned)f(holding)g(zero.)259 1360 y Fd(CmpF)-8
+b(rame)427 1460 y Fi(If)40 b(the)g(supplied)f(Mapping)g(is)h(a)e(CmpF)
-7 b(rame,)42 b(then)e(map1)f(and)g(map2)g(will)g(b)r(e)h(returned)f
-(holding)427 4954 y(p)r(oin)n(ters)33 b(to)g(the)h(comp)r(onen)n(t)f(F)
+(holding)427 1559 y(p)r(oin)n(ters)33 b(to)g(the)h(comp)r(onen)n(t)f(F)
-7 b(rames)32 b(used)i(to)f(create)f(the)i(CmpF)-7 b(rame.)54
-b(The)33 b(comp)r(onen)n(t)g(F)-7 b(rames)427 5053 y(are)27
+b(The)33 b(comp)r(onen)n(t)g(F)-7 b(rames)427 1659 y(are)27
b(considered)f(to)i(b)r(e)g(in)g(applied)f(in)h(parallel.)259
-5195 y Fd(F)-8 b(rame)427 5294 y Fi(F)h(or)24 b(an)n(y)g(class)g(of)g
+1814 y Fd(F)-8 b(rame)427 1914 y Fi(F)h(or)24 b(an)n(y)g(class)g(of)g
(F)-7 b(rame)24 b(other)g(than)h(a)f(CmpF)-7 b(rame,)25
b(map1)f(will)h(b)r(e)g(returned)f(holding)g(a)h(clone)f(of)g(the)427
-5394 y(supplied)k(F)-7 b(rame)27 b(p)r(oin)n(ter,)h(and)f(map2)g(will)h
+2014 y(supplied)k(F)-7 b(rame)27 b(p)r(oin)n(ter,)h(and)f(map2)g(will)h
(b)r(e)g(returned)f(holding)g(a)g(NULL)h(p)r(oin)n(ter.)0
-5572 y Fd(Notes:)p eop end
-%%Page: 220 230
-TeXDict begin 220 229 bop 0 52 a FF(220)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
-b Fi(The)32 b(returned)f(In)n(v)n(ert)g(v)-5 b(alues)31
-b(should)g(b)r(e)h(used)g(in)g(preference)f(to)g(the)h(curren)n(t)f(v)
--5 b(alues)31 b(of)h(the)g(In)n(v)n(ert)427 451 y(attribute)g(in)h
-(map1)e(and)h(map2.)49 b(This)32 b(is)g(b)r(ecause)g(the)g(attributes)g
-(ma)n(y)f(ha)n(v)n(e)g(c)n(hanged)g(v)-5 b(alue)32 b(since)427
-551 y(the)c(Mappings)f(w)n(ere)g(com)n(bined.)340 675
-y Fh(\017)45 b Fi(An)n(y)28 b(c)n(hanges)f(made)h(to)g(the)g(comp)r
-(onen)n(t)g(Mappings)f(using)h(the)g(returned)g(p)r(oin)n(ters)f(will)h
-(b)r(e)h(re\015ected)427 775 y(in)f(the)g(supplied)g(Mapping.)p
-0 959 3780 12 v 0 1090 a Fz(astDelFits)169 b Fe(Delete)38
-b(the)h(curren)m(t)e(FITS)j(card)e(in)g(a)h(FitsChan)166
-b Fz(astDelFits)0 1240 y Fd(Description:)44 b Fi(This)30
+2221 y Fd(Notes:)340 2549 y Fh(\017)45 b Fi(The)32 b(returned)f(In)n(v)
+n(ert)g(v)-5 b(alues)31 b(should)g(b)r(e)h(used)g(in)g(preference)f(to)
+g(the)h(curren)n(t)f(v)-5 b(alues)31 b(of)h(the)g(In)n(v)n(ert)427
+2649 y(attribute)g(in)h(map1)e(and)h(map2.)49 b(This)32
+b(is)g(b)r(ecause)g(the)g(attributes)g(ma)n(y)f(ha)n(v)n(e)g(c)n
+(hanged)g(v)-5 b(alue)32 b(since)427 2748 y(the)c(Mappings)f(w)n(ere)g
+(com)n(bined.)340 2904 y Fh(\017)45 b Fi(An)n(y)28 b(c)n(hanges)f(made)
+h(to)g(the)g(comp)r(onen)n(t)g(Mappings)f(using)h(the)g(returned)g(p)r
+(oin)n(ters)f(will)h(b)r(e)h(re\015ected)427 3004 y(in)f(the)g
+(supplied)g(Mapping.)p 0 3249 3780 12 v 0 3380 a Fz(astDelFits)169
+b Fe(Delete)38 b(the)h(curren)m(t)e(FITS)j(card)e(in)g(a)h(FitsChan)166
+b Fz(astDelFits)0 3591 y Fd(Description:)44 b Fi(This)30
b(function)g(deletes)g(the)g(curren)n(t)f(FITS)h(card)f(from)h(a)f
(FitsChan.)44 b(The)29 b(curren)n(t)g(card)g(ma)n(y)g(b)r(e)227
-1340 y(selected)e(using)g(the)h(Card)e(attribute)i(\(if)g(its)f(index)g
+3691 y(selected)e(using)g(the)h(Card)e(attribute)i(\(if)g(its)f(index)g
(is)g(kno)n(wn\))g(or)f(b)n(y)h(using)g(astFindFits)h(\(if)g(only)f
-(the)g(FITS)227 1439 y(k)n(eyw)n(ord)f(is)h(kno)n(wn\).)227
-1560 y(After)h(deletion,)g(the)g(follo)n(wing)f(card)f(b)r(ecomes)h
-(the)h(curren)n(t)f(card.)0 1701 y Fd(Synopsis:)121 b
+(the)g(FITS)227 3791 y(k)n(eyw)n(ord)f(is)h(kno)n(wn\).)227
+3938 y(After)h(deletion,)g(the)g(follo)n(wing)f(card)f(b)r(ecomes)h
+(the)h(curren)n(t)f(card.)0 4133 y Fd(Synopsis:)121 b
Ft(void)42 b(astDelFits\()d(AstFitsChan)g Fh(\003)p Ft(this)i(\))0
-1843 y Fd(P)m(arameters:)259 1971 y(this)427 2071 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(FitsChan.)0 2225 y Fd(Notes:)340 2500 y
+4328 y Fd(P)m(arameters:)259 4510 y(this)427 4610 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(FitsChan.)0 4817 y Fd(Notes:)340 5145 y
Fh(\017)45 b Fi(This)23 b(function)f(returns)g(without)h(action)e(if)i
(the)g(FitsChan)f(is)h(initially)f(p)r(ositioned)g(at)g(the)h
-Ft(")p Fi(end-of-\014le)p Ft(")427 2599 y Fi(\(i.e.)38
+Ft(")p Fi(end-of-\014le)p Ft(")427 5245 y Fi(\(i.e.)38
b(if)28 b(the)g(Card)e(attribute)i(exceeds)f(the)h(n)n(um)n(b)r(er)f
-(of)h(cards)e(in)i(the)g(FitsChan\).)340 2724 y Fh(\017)45
+(of)h(cards)e(in)i(the)g(FitsChan\).)340 5400 y Fh(\017)45
b Fi(If)36 b(there)f(are)f(no)h(subsequen)n(t)f(cards)g(in)i(the)f
(FitsChan,)i(then)f(the)f(Card)g(attribute)g(is)g(left)h(p)r(oin)n
-(ting)427 2824 y(at)e(the)g Ft(")p Fi(end-of-\014le)p
+(ting)427 5500 y(at)e(the)g Ft(")p Fi(end-of-\014le)p
Ft(")e Fi(after)h(deletion)h(\(i.e.)55 b(is)33 b(set)h(to)f(one)g(more)
g(than)g(the)h(n)n(um)n(b)r(er)g(of)f(cards)f(in)i(the)427
-2924 y(FitsChan\).)p 0 3107 V 0 3239 a Fz(astDelete)908
-b Fe(Delete)39 b(an)f(Ob)7 b(ject)905 b Fz(astDelete)0
-3412 y Fd(Description:)44 b Fi(This)25 b(function)f(deletes)h(an)f(Ob)5
-b(ject,)25 b(freeing)e(all)h(resources)f(asso)r(ciated)g(with)h(it)h
-(and)f(rendering)f(an)n(y)227 3511 y(remaining)k(p)r(oin)n(ters)g(to)g
-(the)h(Ob)5 b(ject)28 b(in)n(v)-5 b(alid.)227 3632 y(Note)28
+5600 y(FitsChan\).)p eop end
+%%Page: 221 231
+TeXDict begin 221 230 bop 3643 52 a FF(221)p 0 351 3780
+12 v 0 483 a Fz(astDelete)908 b Fe(Delete)39 b(an)f(Ob)7
+b(ject)905 b Fz(astDelete)0 669 y Fd(Description:)44
+b Fi(This)25 b(function)f(deletes)h(an)f(Ob)5 b(ject,)25
+b(freeing)e(all)h(resources)f(asso)r(ciated)g(with)h(it)h(and)f
+(rendering)f(an)n(y)227 769 y(remaining)k(p)r(oin)n(ters)g(to)g(the)h
+(Ob)5 b(ject)28 b(in)n(v)-5 b(alid.)227 892 y(Note)28
b(that)h(deletion)f(is)g(unconditional,)g(regardless)e(of)i(whether)g
(other)g(p)r(oin)n(ters)f(to)h(the)h(Ob)5 b(ject)28 b(are)f(still)h(in)
-227 3732 y(use)d(\(p)r(ossibly)f(within)i(other)e(Ob)5
+227 992 y(use)d(\(p)r(ossibly)f(within)i(other)e(Ob)5
b(jects\).)36 b(A)25 b(safer)f(approac)n(h)f(is)h(to)h(defer)g
(deletion,)g(un)n(til)g(all)g(references)e(to)i(an)227
-3831 y(Ob)5 b(ject)21 b(ha)n(v)n(e)f(expired,)h(b)n(y)g(using)g
+1092 y(Ob)5 b(ject)21 b(ha)n(v)n(e)f(expired,)h(b)n(y)g(using)g
(astBegin/astEnd)d(\(together)j(with)g(astClone)f(and)h(astAnn)n(ul)g
-(if)g(necessary\).)0 3973 y Fd(Synopsis:)121 b Ft(AstObject)40
+(if)g(necessary\).)0 1240 y Fd(Synopsis:)121 b Ft(AstObject)40
b Fh(\003)p Ft(astDelete\()f(AstObject)h Fh(\003)p Ft(this)h(\))0
-4114 y Fd(P)m(arameters:)259 4243 y(this)427 4342 y Fi(P)n(oin)n(ter)26
+1388 y Fd(P)m(arameters:)259 1523 y(this)427 1622 y Fi(P)n(oin)n(ter)26
b(to)i(the)g(Ob)5 b(ject)27 b(to)h(b)r(e)g(deleted.)0
-4496 y Fd(Class)j(Applicabilit)m(y:)259 4625 y(Ob)5 b(ject)427
-4725 y Fi(This)28 b(function)g(applies)f(to)h(all)f(Ob)5
-b(jects.)0 4879 y Fd(Returned)32 b(V)-8 b(alue:)259 5007
-y(astDelete\(\))427 5107 y Fi(A)28 b(n)n(ull)g(Ob)5 b(ject)27
+1783 y Fd(Class)j(Applicabilit)m(y:)259 1918 y(Ob)5 b(ject)427
+2017 y Fi(This)28 b(function)g(applies)f(to)h(all)f(Ob)5
+b(jects.)0 2178 y Fd(Returned)32 b(V)-8 b(alue:)259 2313
+y(astDelete\(\))427 2413 y Fi(A)28 b(n)n(ull)g(Ob)5 b(ject)27
b(p)r(oin)n(ter)h(\(AST)p Ft(__)p Fi(NULL\))g(is)f(alw)n(a)n(ys)f
-(returned.)0 5261 y Fd(Notes:)340 5535 y Fh(\017)45 b
+(returned.)0 2573 y Fd(Notes:)340 2854 y Fh(\017)45 b
Fi(This)30 b(function)h(attempts)f(to)g(execute)g(ev)n(en)g(if)g(the)g
(AST)h(error)d(status)i(is)g(set)g(on)f(en)n(try)-7 b(,)31
-b(although)e(no)427 5635 y(further)f(error)d(rep)r(ort)i(will)h(b)r(e)g
+b(although)e(no)427 2954 y(further)f(error)d(rep)r(ort)i(will)h(b)r(e)g
(made)f(if)i(it)f(subsequen)n(tly)f(fails)g(under)h(these)f
-(circumstances.)p eop end
-%%Page: 221 231
-TeXDict begin 221 230 bop 3643 52 a FF(221)p 0 351 3780
-12 v 0 483 a Fz(astDistance)308 b Fe(Calculate)36 b(the)j(distance)f(b)
-s(et)m(w)m(een)g(t)m(w)m(o)1437 583 y(p)s(oin)m(ts)f(in)i(a)g(F)-10
-b(rame)3102 483 y Fz(astDistance)0 774 y Fd(Description:)44
-b Fi(This)30 b(function)h(\014nds)f(the)g(distance)g(b)r(et)n(w)n(een)g
-(t)n(w)n(o)f(p)r(oin)n(ts)h(whose)f(F)-7 b(rame)30 b(co)r(ordinates)e
-(are)h(giv)n(en.)227 874 y(The)f(distance)f(calculated)g(is)h(that)g
-(along)e(the)i(geo)r(desic)f(curv)n(e)f(that)i(joins)g(the)g(t)n(w)n(o)
-e(p)r(oin)n(ts.)227 999 y(F)-7 b(or)34 b(example,)h(in)f(a)f(basic)h(F)
--7 b(rame,)35 b(the)f(distance)f(calculated)h(will)g(b)r(e)g(the)g
-(Cartesian)f(distance)h(along)e(the)227 1099 y(straigh)n(t)k(line)h
+(circumstances.)p 0 3150 V 0 3282 a Fz(astDistance)308
+b Fe(Calculate)36 b(the)j(distance)f(b)s(et)m(w)m(een)g(t)m(w)m(o)1437
+3381 y(p)s(oin)m(ts)f(in)i(a)g(F)-10 b(rame)3102 3282
+y Fz(astDistance)0 3567 y Fd(Description:)44 b Fi(This)30
+b(function)h(\014nds)f(the)g(distance)g(b)r(et)n(w)n(een)g(t)n(w)n(o)f
+(p)r(oin)n(ts)h(whose)f(F)-7 b(rame)30 b(co)r(ordinates)e(are)h(giv)n
+(en.)227 3667 y(The)f(distance)f(calculated)g(is)h(that)g(along)e(the)i
+(geo)r(desic)f(curv)n(e)f(that)i(joins)g(the)g(t)n(w)n(o)e(p)r(oin)n
+(ts.)227 3791 y(F)-7 b(or)34 b(example,)h(in)f(a)f(basic)h(F)-7
+b(rame,)35 b(the)f(distance)f(calculated)h(will)g(b)r(e)g(the)g
+(Cartesian)f(distance)h(along)e(the)227 3891 y(straigh)n(t)k(line)h
(joining)g(the)h(t)n(w)n(o)e(p)r(oin)n(ts.)65 b(F)-7
b(or)37 b(a)f(more)g(sp)r(ecialised)h(F)-7 b(rame)36
-b(describing)h(a)f(sky)h(co)r(ordinate)227 1199 y(system,)25
+b(describing)h(a)f(sky)h(co)r(ordinate)227 3990 y(system,)25
b(ho)n(w)n(ev)n(er,)f(it)h(w)n(ould)f(b)r(e)i(the)f(distance)f(along)g
(the)h(great)f(circle)g(passing)g(through)g(t)n(w)n(o)g(sky)g(p)r
-(ositions.)0 1351 y Fd(Synopsis:)121 b Ft(double)41 b(astDistance\()e
+(ositions.)0 4138 y Fd(Synopsis:)121 b Ft(double)41 b(astDistance\()e
(AstFrame)h Fh(\003)p Ft(this,)h(const)g(double)h(point1[],)d(const)j
-(double)f(point2[])227 1450 y(\))0 1602 y Fd(P)m(arameters:)259
-1741 y(this)427 1841 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
-b(rame.)259 1975 y Fd(p)s(oin)m(t1)427 2075 y Fi(An)32
+(double)f(point2[])227 4238 y(\))0 4386 y Fd(P)m(arameters:)259
+4521 y(this)427 4620 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rame.)259 4752 y Fd(p)s(oin)m(t1)427 4851 y Fi(An)32
b(arra)n(y)c(of)j(double,)h(with)g(one)e(elemen)n(t)i(for)e(eac)n(h)g
(F)-7 b(rame)31 b(axis)f(\(Naxes)h(attribute\))g(con)n(taining)f(the)
-427 2175 y(co)r(ordinates)c(of)i(the)g(\014rst)f(p)r(oin)n(t.)259
-2309 y Fd(p)s(oin)m(t2)427 2408 y Fi(An)j(arra)n(y)e(of)h(double,)h
+427 4951 y(co)r(ordinates)c(of)i(the)g(\014rst)f(p)r(oin)n(t.)259
+5083 y Fd(p)s(oin)m(t2)427 5182 y Fi(An)j(arra)n(y)e(of)h(double,)h
(with)g(one)g(elemen)n(t)f(for)g(eac)n(h)g(F)-7 b(rame)29
b(axis)g(con)n(taining)g(the)h(co)r(ordinates)e(of)h(the)427
-2508 y(second)e(p)r(oin)n(t.)0 2672 y Fd(Returned)32
-b(V)-8 b(alue:)259 2811 y(astDistance)427 2911 y Fi(The)28
-b(distance)f(b)r(et)n(w)n(een)h(the)g(t)n(w)n(o)f(p)r(oin)n(ts.)0
-3076 y Fd(Notes:)340 3361 y Fh(\017)45 b Fi(This)30 b(function)g(will)f
-(return)g(a)g Ft(")p Fi(bad)p Ft(")g Fi(result)g(v)-5
-b(alue)29 b(\(AST)p Ft(__)p Fi(BAD\))h(if)g(an)n(y)f(of)g(the)h(input)g
-(co)r(ordinates)427 3460 y(has)d(this)h(v)-5 b(alue.)340
-3594 y Fh(\017)45 b Fi(A)27 b Ft(")p Fi(bad)p Ft(")e
-Fi(v)-5 b(alue)26 b(will)g(also)f(b)r(e)i(returned)e(if)i(this)f
-(function)h(is)f(in)n(v)n(ok)n(ed)f(with)h(the)h(AST)f(error)f(status)h
-(set,)427 3694 y(or)h(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)
-p 0 3896 V 0 4028 a Fz(astDo)l(wnsize)275 b Fe(Reduce)40
+5282 y(second)e(p)r(oin)n(t.)0 5442 y Fd(Returned)32
+b(V)-8 b(alue:)259 5577 y(astDistance)427 5677 y Fi(The)28
+b(distance)f(b)r(et)n(w)n(een)h(the)g(t)n(w)n(o)f(p)r(oin)n(ts.)p
+eop end
+%%Page: 222 232
+TeXDict begin 222 231 bop 0 52 a FF(222)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Notes:)340
+631 y Fh(\017)45 b Fi(This)30 b(function)g(will)f(return)g(a)g
+Ft(")p Fi(bad)p Ft(")g Fi(result)g(v)-5 b(alue)29 b(\(AST)p
+Ft(__)p Fi(BAD\))h(if)g(an)n(y)f(of)g(the)h(input)g(co)r(ordinates)427
+730 y(has)d(this)h(v)-5 b(alue.)340 860 y Fh(\017)45
+b Fi(A)27 b Ft(")p Fi(bad)p Ft(")e Fi(v)-5 b(alue)26
+b(will)g(also)f(b)r(e)i(returned)e(if)i(this)f(function)h(is)f(in)n(v)n
+(ok)n(ed)f(with)h(the)h(AST)f(error)f(status)h(set,)427
+960 y(or)h(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)p
+0 1153 3780 12 v 0 1285 a Fz(astDo)l(wnsize)275 b Fe(Reduce)40
b(the)e(n)m(um)m(b)s(er)g(of)h(v)m(ertices)e(in)i(a)1684
-4127 y(P)m(olygon)3059 4028 y Fz(astDo)l(wnsize)0 4319
+1385 y(P)m(olygon)3059 1285 y Fz(astDo)l(wnsize)0 1568
y Fd(Description:)44 b Fi(This)26 b(function)h(returns)e(a)g(p)r(oin)n
(ter)h(to)g(a)f(new)h(P)n(olygon)e(that)i(con)n(tains)f(a)g(subset)h
-(of)g(the)h(v)n(ertices)d(in)227 4418 y(the)k(supplied)f(P)n(olygon.)35
+(of)g(the)h(v)n(ertices)d(in)227 1667 y(the)k(supplied)f(P)n(olygon.)35
b(The)27 b(subset)g(is)g(c)n(hosen)f(so)g(that)i(the)f(returned)g(P)n
(olygon)e(is)h(a)h(go)r(o)r(d)f(appro)n(ximation)227
-4518 y(to)g(the)h(supplied)f(P)n(olygon,)e(within)j(the)f(limits)h(sp)r
+1767 y(to)g(the)h(supplied)f(P)n(olygon,)e(within)j(the)f(limits)h(sp)r
(eci\014ed)f(b)n(y)g(the)g(supplied)g(parameter)f(v)-5
-b(alues.)36 b(That)26 b(is,)g(the)227 4618 y(densit)n(y)g(of)g(p)r(oin)
+b(alues.)36 b(That)26 b(is,)g(the)227 1866 y(densit)n(y)g(of)g(p)r(oin)
n(ts)f(in)h(the)g(returned)g(P)n(olygon)d(is)j(greater)e(at)i(p)r(oin)n
(ts)f(where)g(the)i(curv)-5 b(ature)25 b(of)g(the)h(b)r(oundary)227
-4717 y(of)i(the)g(supplied)g(P)n(olygon)d(is)j(greater.)0
-4869 y Fd(Synopsis:)121 b Ft(AstPolygon)39 b Fh(\003)p
+1966 y(of)i(the)g(supplied)g(P)n(olygon)d(is)j(greater.)0
+2113 y Fd(Synopsis:)121 b Ft(AstPolygon)39 b Fh(\003)p
Ft(astDownsize\()f(AstPolygon)i Fh(\003)p Ft(this,)h(double)g(maxerr,)g
-(int)h(maxvert)f(\))0 5021 y Fd(P)m(arameters:)259 5160
-y(this)427 5260 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(P)n(olygon.)259
-5394 y Fd(maxerr)427 5494 y Fi(The)22 b(maxim)n(um)g(allo)n(w)n(ed)e
+(int)h(maxvert)f(\))0 2259 y Fd(P)m(arameters:)259 2392
+y(this)427 2492 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(P)n(olygon.)259
+2622 y Fd(maxerr)427 2722 y Fi(The)22 b(maxim)n(um)g(allo)n(w)n(ed)e
(discrepancy)g(b)r(et)n(w)n(een)i(the)g(supplied)g(and)g(returned)f(P)n
-(olygons,)g(expressed)f(as)427 5593 y(a)k(geo)r(desic)f(distance)h
+(olygons,)g(expressed)f(as)427 2821 y(a)k(geo)r(desic)f(distance)h
(within)g(the)h(P)n(olygon's)c(co)r(ordinate)i(frame.)36
b(If)24 b(this)g(is)g(zero)f(or)g(less,)i(the)f(returned)427
-5693 y(P)n(olygon)i(will)h(ha)n(v)n(e)g(the)h(n)n(um)n(b)r(er)f(of)h(v)
-n(ertices)e(sp)r(eci\014ed)i(b)n(y)f(maxv)n(ert.)p eop
-end
-%%Page: 222 232
-TeXDict begin 222 231 bop 0 52 a FF(222)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(maxv)m(ert)427
-451 y Fi(The)36 b(maxim)n(um)f(allo)n(w)n(ed)f(n)n(um)n(b)r(er)h(of)h
-(v)n(ertices)e(in)i(the)f(returned)g(P)n(olygon.)59 b(If)35
-b(this)h(is)f(less)g(than)h(3,)427 551 y(the)c(n)n(um)n(b)r(er)e(of)h
-(v)n(ertices)f(in)h(the)g(returned)g(P)n(olygon)d(will)k(b)r(e)f(the)g
-(minim)n(um)h(needed)f(to)g(ac)n(hiev)n(e)e(the)427 650
-y(maxim)n(um)f(discrepancy)e(sp)r(eci\014ed)i(b)n(y)f(maxerr.)0
-810 y Fd(Returned)32 b(V)-8 b(alue:)259 945 y(astDo)m(wnsize\(\))427
-1045 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(new)f(P)n(olygon.)0
-1205 y Fd(Notes:)340 1486 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
-b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
-(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 1585 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 1781 3780 12 v 0 1913
-a Fz(astEBuf)304 b Fe(End)38 b(the)h(curren)m(t)e(graphical)g
-(bu\013ering)h(con)m(text)301 b Fz(astEBuf)0 2098 y Fd(Description:)44
-b Fi(This)20 b(function)g(ends)f(the)h(curren)n(t)e(graphics)g
-(bu\013ering)i(con)n(text.)33 b(It)20 b(should)f(matc)n(h)h(a)f
-(corresp)r(onding)227 2198 y(call)27 b(to)h(the)g(astBBuf)f(function.)0
-2345 y Fd(Synopsis:)121 b Ft(void)42 b(astEBuf\()e(AstPlot)h
-Fh(\003)p Ft(this)g(\))0 2493 y Fd(P)m(arameters:)259
-2628 y(this)427 2728 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)0
-2888 y Fd(Notes:)340 3169 y Fh(\017)45 b Fi(The)30 b(nature)g(of)g(the)
-g(bu\013ering)g(is)f(determined)i(b)n(y)e(the)i(underlying)e(graphics)f
-(system)i(\(as)g(de\014ned)g(b)n(y)427 3268 y(the)f(curren)n(t)e(grf)h
-(mo)r(dule\).)40 b(Eac)n(h)27 b(call)h(to)g(this)g(function)h(simply)g
-(in)n(v)n(ok)n(es)d(the)j(astGEBuf)e(function)i(in)427
-3368 y(the)f(grf)f(mo)r(dule.)p 0 3564 V 0 3695 a Fz(astEllipse)924
-b Fe(Create)37 b(a)i(Ellipse)920 b Fz(astEllipse)0 3881
-y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g
-(Ellipse)g(and)h(optionally)f(initialises)g(its)h(attributes.)227
-4004 y(A)g(Ellipse)f(is)h(a)f(Region)g(whic)n(h)g(represen)n(ts)g(a)g
+2921 y(P)n(olygon)i(will)h(ha)n(v)n(e)g(the)h(n)n(um)n(b)r(er)f(of)h(v)
+n(ertices)e(sp)r(eci\014ed)i(b)n(y)f(maxv)n(ert.)259
+3051 y Fd(maxv)m(ert)427 3150 y Fi(The)36 b(maxim)n(um)f(allo)n(w)n(ed)
+f(n)n(um)n(b)r(er)h(of)h(v)n(ertices)e(in)i(the)f(returned)g(P)n
+(olygon.)59 b(If)35 b(this)h(is)f(less)g(than)h(3,)427
+3250 y(the)c(n)n(um)n(b)r(er)e(of)h(v)n(ertices)f(in)h(the)g(returned)g
+(P)n(olygon)d(will)k(b)r(e)f(the)g(minim)n(um)h(needed)f(to)g(ac)n
+(hiev)n(e)e(the)427 3350 y(maxim)n(um)f(discrepancy)e(sp)r(eci\014ed)i
+(b)n(y)f(maxerr.)0 3509 y Fd(Returned)32 b(V)-8 b(alue:)259
+3642 y(astDo)m(wnsize\(\))427 3742 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(new)f(P)n(olygon.)0 3901 y Fd(Notes:)340
+4180 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
+b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g
+(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427
+4280 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
+(for)f(an)n(y)g(reason.)p 0 4473 V 0 4605 a Fz(astEBuf)304
+b Fe(End)38 b(the)h(curren)m(t)e(graphical)g(bu\013ering)h(con)m(text)
+301 b Fz(astEBuf)0 4788 y Fd(Description:)44 b Fi(This)20
+b(function)g(ends)f(the)h(curren)n(t)e(graphics)g(bu\013ering)i(con)n
+(text.)33 b(It)20 b(should)f(matc)n(h)h(a)f(corresp)r(onding)227
+4887 y(call)27 b(to)h(the)g(astBBuf)f(function.)0 5034
+y Fd(Synopsis:)121 b Ft(void)42 b(astEBuf\()e(AstPlot)h
+Fh(\003)p Ft(this)g(\))0 5180 y Fd(P)m(arameters:)259
+5314 y(this)427 5413 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)0
+5572 y Fd(Notes:)p eop end
+%%Page: 223 233
+TeXDict begin 223 232 bop 3643 52 a FF(223)340 351 y
+Fh(\017)45 b Fi(The)30 b(nature)g(of)g(the)g(bu\013ering)g(is)f
+(determined)i(b)n(y)e(the)i(underlying)e(graphics)f(system)i(\(as)g
+(de\014ned)g(b)n(y)427 451 y(the)f(curren)n(t)e(grf)h(mo)r(dule\).)40
+b(Eac)n(h)27 b(call)h(to)g(this)g(function)h(simply)g(in)n(v)n(ok)n(es)
+d(the)j(astGEBuf)e(function)i(in)427 551 y(the)f(grf)f(mo)r(dule.)p
+0 761 3780 12 v 0 893 a Fz(astEllipse)924 b Fe(Create)37
+b(a)i(Ellipse)920 b Fz(astEllipse)0 1093 y Fd(Description:)44
+b Fi(This)28 b(function)g(creates)f(a)g(new)g(Ellipse)g(and)h
+(optionally)f(initialises)g(its)h(attributes.)227 1223
+y(A)g(Ellipse)f(is)h(a)f(Region)g(whic)n(h)g(represen)n(ts)g(a)g
(elliptical)g(area)g(within)h(the)g(supplied)g(2-dimensional)e(F)-7
-b(rame.)0 4152 y Fd(Synopsis:)121 b Ft(AstEllipse)39
+b(rame.)0 1384 y Fd(Synopsis:)121 b Ft(AstEllipse)39
b Fh(\003)p Ft(astEllipse\()g(AstFrame)h Fh(\003)p Ft(frame,)h(int)h
-(form,)g(const)f(double)g(centre[2],)f(const)227 4252
+(form,)g(const)f(double)g(centre[2],)f(const)227 1484
y(double)h(point1[2],)f(const)h(double)g(point2[2],)f(AstRegion)g
Fh(\003)p Ft(unc,)h(const)h(char)g Fh(\003)p Ft(options,)d(...)227
-4351 y(\))0 4499 y Fd(P)m(arameters:)259 4634 y(frame)427
-4733 y Fi(A)30 b(p)r(oin)n(ter)f(to)g(the)g(F)-7 b(rame)29
+1584 y(\))0 1744 y Fd(P)m(arameters:)259 1892 y(frame)427
+1992 y Fi(A)30 b(p)r(oin)n(ter)f(to)g(the)g(F)-7 b(rame)29
b(in)g(whic)n(h)g(the)h(region)e(is)h(de\014ned.)42 b(It)30
b(m)n(ust)f(ha)n(v)n(e)f(exactly)g(2)h(axes.)41 b(A)29
-b(deep)427 4833 y(cop)n(y)h(is)g(tak)n(en)f(of)i(the)f(supplied)h(F)-7
+b(deep)427 2092 y(cop)n(y)h(is)g(tak)n(en)f(of)i(the)f(supplied)h(F)-7
b(rame.)44 b(This)30 b(means)g(that)h(an)n(y)e(subsequen)n(t)h(c)n
-(hanges)f(made)h(to)g(the)427 4933 y(F)-7 b(rame)27 b(using)h(the)g
+(hanges)f(made)h(to)g(the)427 2191 y(F)-7 b(rame)27 b(using)h(the)g
(supplied)f(p)r(oin)n(ter)h(will)g(ha)n(v)n(e)e(no)h(e\013ect)h(the)g
-(Region.)259 5064 y Fd(form)427 5163 y Fi(Indicates)e(ho)n(w)g(the)g
+(Region.)259 2330 y Fd(form)427 2429 y Fi(Indicates)e(ho)n(w)g(the)g
(ellipse)g(is)h(describ)r(ed)f(b)n(y)f(the)i(remaining)e(parameters.)35
-b(A)26 b(v)-5 b(alue)27 b(of)f(zero)f(indicates)427 5263
+b(A)26 b(v)-5 b(alue)27 b(of)f(zero)f(indicates)427 2529
y(that)32 b(the)g(ellipse)g(is)f(sp)r(eci\014ed)h(b)n(y)g(a)f(cen)n
(tre)g(p)r(osition)h(and)f(t)n(w)n(o)g(p)r(ositions)g(on)h(the)g
-(circumference.)48 b(A)427 5363 y(v)-5 b(alue)25 b(of)g(one)g
+(circumference.)48 b(A)427 2629 y(v)-5 b(alue)25 b(of)g(one)g
(indicates)g(that)g(the)h(ellipse)f(is)g(sp)r(eci\014ed)g(b)n(y)g(its)g
(cen)n(tre)g(p)r(osition,)g(the)h(half-lengths)e(of)h(its)427
-5462 y(t)n(w)n(o)i(axes,)g(and)g(the)h(orien)n(tation)e(of)i(its)g
-(\014rst)f(axis.)259 5593 y Fd(cen)m(tre)427 5693 y Fi(An)h(arra)n(y)e
+2728 y(t)n(w)n(o)i(axes,)g(and)g(the)h(orien)n(tation)e(of)i(its)g
+(\014rst)f(axis.)259 2867 y Fd(cen)m(tre)427 2966 y Fi(An)h(arra)n(y)e
(of)h(2)g(doubles,)h(con)n(taining)e(the)i(co)r(ordinates)e(at)i(the)g
-(cen)n(tre)f(of)g(the)h(ellipse.)p eop end
-%%Page: 223 233
-TeXDict begin 223 232 bop 3643 52 a FF(223)259 351 y
-Fd(p)s(oin)m(t1)427 451 y Fi(An)29 b(arra)n(y)e(of)h(2)h(doubles.)39
-b(If)30 b Ft(")p Fi(form)p Ft(")d Fi(is)i(zero,)f(this)h(arra)n(y)d
-(should)i(con)n(tain)g(the)h(co)r(ordinates)f(of)g(one)h(of)427
-551 y(the)e(four)e(p)r(oin)n(ts)h(where)g(an)g(axis)f(of)h(the)g
+(cen)n(tre)f(of)g(the)h(ellipse.)259 3105 y Fd(p)s(oin)m(t1)427
+3205 y Fi(An)h(arra)n(y)e(of)h(2)h(doubles.)39 b(If)30
+b Ft(")p Fi(form)p Ft(")d Fi(is)i(zero,)f(this)h(arra)n(y)d(should)i
+(con)n(tain)g(the)h(co)r(ordinates)f(of)g(one)h(of)427
+3304 y(the)e(four)e(p)r(oin)n(ts)h(where)g(an)g(axis)f(of)h(the)g
(ellipse)g(crosses)f(the)h(circumference)g(of)g(the)g(ellipse.)36
-b(If)27 b Ft(")p Fi(form)p Ft(")427 650 y Fi(is)i(one,)h(it)f(should)g
+b(If)27 b Ft(")p Fi(form)p Ft(")427 3404 y Fi(is)i(one,)h(it)f(should)g
(con)n(tain)g(the)h(lengths)f(of)g(semi-ma)5 b(jor)27
b(and)i(semi-minor)g(axes)f(of)h(the)h(ellipse,)f(giv)n(en)427
-750 y(as)e(geo)r(desic)g(distances)g(within)h(the)g(F)-7
-b(rame.)259 896 y Fd(p)s(oin)m(t2)427 995 y Fi(An)25
+3504 y(as)e(geo)r(desic)g(distances)g(within)h(the)g(F)-7
+b(rame.)259 3642 y Fd(p)s(oin)m(t2)427 3742 y Fi(An)25
b(arra)n(y)c(of)j(2)f(doubles.)35 b(If)24 b Ft(")p Fi(form)p
Ft(")f Fi(is)h(zero,)f(this)h(arra)n(y)e(should)h(con)n(taining)g(the)h
-(co)r(ordinates)f(at)g(some)427 1095 y(other)28 b(p)r(oin)n(t)g(on)g
+(co)r(ordinates)f(at)g(some)427 3841 y(other)28 b(p)r(oin)n(t)g(on)g
(the)h(circumference)f(of)g(the)g(ellipse,)h(distinct)g(from)f
Ft(")p Fi(p)r(oin)n(t1)p Ft(")p Fi(.)37 b(If)29 b Ft(")p
-Fi(form)p Ft(")e Fi(is)h(one,)g(the)427 1195 y(\014rst)23
+Fi(form)p Ft(")e Fi(is)h(one,)g(the)427 3941 y(\014rst)23
b(elemen)n(t)g(of)g(this)h(arra)n(y)c(should)j(hold)g(the)h(angle)e(b)r
(et)n(w)n(een)h(the)h(second)e(axis)g(of)h(the)h(F)-7
-b(rame)22 b(and)h(the)427 1294 y(\014rst)31 b(ellipse)g(axis)g(\(i.e.)
+b(rame)22 b(and)h(the)427 4041 y(\014rst)31 b(ellipse)g(axis)g(\(i.e.)
47 b(the)32 b(ellipse)f(axis)f(whic)n(h)h(is)g(sp)r(eci\014ed)h
(\014rst)e(in)i(the)f Ft(")p Fi(p)r(oin)n(t1)p Ft(")f
-Fi(arra)n(y\),)g(and)h(the)427 1394 y(second)f(elemen)n(t)g(will)h(b)r
+Fi(arra)n(y\),)g(and)h(the)427 4140 y(second)f(elemen)n(t)g(will)h(b)r
(e)f(ignored.)44 b(The)30 b(angle)f(should)h(b)r(e)h(giv)n(en)e(in)i
-(radians,)e(measured)h(p)r(ositiv)n(e)f(in)427 1493 y(the)23
+(radians,)e(measured)h(p)r(ositiv)n(e)f(in)427 4240 y(the)23
b(same)g(sense)f(as)g(rotation)f(from)i(the)g(p)r(ositiv)n(e)f
(direction)g(of)h(the)g(second)f(F)-7 b(rame)22 b(axis)g(to)h(the)g(p)r
-(ositiv)n(e)427 1593 y(direction)k(of)h(the)g(\014rst)f(F)-7
-b(rame)27 b(axis.)259 1739 y Fd(unc)427 1839 y Fi(An)33
+(ositiv)n(e)427 4339 y(direction)k(of)h(the)g(\014rst)f(F)-7
+b(rame)27 b(axis.)259 4478 y Fd(unc)427 4578 y Fi(An)33
b(optional)e(p)r(oin)n(ter)h(to)g(an)g(existing)g(Region)f(whic)n(h)h
(sp)r(eci\014es)g(the)h(uncertain)n(ties)e(asso)r(ciated)g(with)427
-1938 y(the)j(b)r(oundary)f(of)g(the)h(Bo)n(x)f(b)r(eing)g(created.)54
+4677 y(the)j(b)r(oundary)f(of)g(the)h(Bo)n(x)f(b)r(eing)g(created.)54
b(The)34 b(uncertain)n(t)n(y)e(in)i(an)n(y)f(p)r(oin)n(t)h(on)f(the)h
-(b)r(oundary)f(of)427 2038 y(the)g(Bo)n(x)e(is)h(found)h(b)n(y)f
+(b)r(oundary)f(of)427 4777 y(the)g(Bo)n(x)e(is)h(found)h(b)n(y)f
(shifting)h(the)f(supplied)h Ft(")p Fi(uncertain)n(t)n(y)p
Ft(")e Fi(Region)g(so)h(that)g(it)h(is)f(cen)n(tred)g(at)g(the)427
-2137 y(b)r(oundary)e(p)r(oin)n(t)h(b)r(eing)g(considered.)44
+4877 y(b)r(oundary)e(p)r(oin)n(t)h(b)r(eing)g(considered.)44
b(The)31 b(area)e(co)n(v)n(ered)g(b)n(y)h(the)h(shifted)g(uncertain)n
-(t)n(y)f(Region)g(then)427 2237 y(represen)n(ts)g(the)i(uncertain)n(t)n
+(t)n(y)f(Region)g(then)427 4976 y(represen)n(ts)g(the)i(uncertain)n(t)n
(y)f(in)g(the)h(b)r(oundary)f(p)r(osition.)48 b(The)31
b(uncertain)n(t)n(y)g(is)g(assumed)g(to)g(b)r(e)h(the)427
-2337 y(same)27 b(for)g(all)h(p)r(oin)n(ts.)427 2459 y(If)38
+5076 y(same)27 b(for)g(all)h(p)r(oin)n(ts.)427 5195 y(If)38
b(supplied,)j(the)d(uncertain)n(t)n(y)f(Region)g(m)n(ust)g(b)r(e)i(of)e
(a)g(class)g(for)g(whic)n(h)h(all)f(instances)g(are)g(cen)n(tro-)427
-2559 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24 b(Circle,)g(Ellipse,)h
+5295 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24 b(Circle,)g(Ellipse,)h
(etc.\))36 b(or)23 b(b)r(e)i(a)e(Prism)h(con)n(taining)f(cen)n
-(tro-symetric)f(comp)r(onen)n(t)427 2659 y(Regions.)57
+(tro-symetric)f(comp)r(onen)n(t)427 5394 y(Regions.)57
b(A)35 b(deep)f(cop)n(y)g(of)g(the)h(supplied)g(Region)f(will)g(b)r(e)h
(tak)n(en,)h(so)e(subsequen)n(t)g(c)n(hanges)f(to)h(the)427
-2758 y(uncertain)n(t)n(y)28 b(Region)f(using)h(the)h(supplied)f(p)r
+5494 y(uncertain)n(t)n(y)28 b(Region)f(using)h(the)h(supplied)f(p)r
(oin)n(ter)g(will)h(ha)n(v)n(e)e(no)h(e\013ect)h(on)f(the)g(created)g
-(Bo)n(x.)38 b(Alter-)427 2858 y(nativ)n(ely)-7 b(,)24
+(Bo)n(x.)38 b(Alter-)427 5593 y(nativ)n(ely)-7 b(,)24
b(a)g(NULL)g(Ob)5 b(ject)24 b(p)r(oin)n(ter)f(ma)n(y)h(b)r(e)g
(supplied,)h(in)f(whic)n(h)g(case)f(a)g(default)i(uncertain)n(t)n(y)e
-(is)h(used)427 2958 y(equiv)-5 b(alen)n(t)28 b(to)f(a)g(b)r(o)n(x)g
-(1.0E-6)f(of)h(the)h(size)g(of)f(the)h(Bo)n(x)f(b)r(eing)g(created.)427
-3080 y(The)c(uncertain)n(t)n(y)f(Region)g(has)g(t)n(w)n(o)g(uses:)34
+(is)h(used)427 5693 y(equiv)-5 b(alen)n(t)28 b(to)f(a)g(b)r(o)n(x)g
+(1.0E-6)f(of)h(the)h(size)g(of)f(the)h(Bo)n(x)f(b)r(eing)g(created.)p
+eop end
+%%Page: 224 234
+TeXDict begin 224 233 bop 0 52 a FF(224)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)427 351 y Fi(The)23
+b(uncertain)n(t)n(y)f(Region)g(has)g(t)n(w)n(o)g(uses:)34
b(1\))22 b(when)h(the)g(astOv)n(erlap)d(function)k(compares)d(t)n(w)n
-(o)h(Regions)427 3180 y(for)g(equalit)n(y)h(the)g(uncertain)n(t)n(y)f
+(o)h(Regions)427 451 y(for)g(equalit)n(y)h(the)g(uncertain)n(t)n(y)f
(Region)g(is)g(used)h(to)g(determine)f(the)i(tolerance)d(on)i(the)g
-(comparison,)f(and)427 3280 y(2\))31 b(when)f(a)h(Region)e(is)i(mapp)r
+(comparison,)f(and)427 551 y(2\))31 b(when)f(a)h(Region)e(is)i(mapp)r
(ed)g(in)n(to)f(a)g(di\013eren)n(t)h(co)r(ordinate)e(system)i(and)f
-(subsequen)n(tly)g(simpli\014ed)427 3379 y(\(using)c(astSimplify\),)h
+(subsequen)n(tly)g(simpli\014ed)427 650 y(\(using)c(astSimplify\),)h
(the)f(uncertain)n(ties)f(are)g(used)h(to)g(determine)g(if)g(the)g
-(transformed)f(b)r(oundary)g(can)427 3479 y(b)r(e)j(accurately)e
+(transformed)f(b)r(oundary)g(can)427 750 y(b)r(e)j(accurately)e
(represen)n(ted)h(b)n(y)g(a)g(sp)r(eci\014c)h(shap)r(e)f(of)h(Region.)
-259 3625 y Fd(options)427 3724 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n
+259 887 y Fd(options)427 987 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n
(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 3824 y(assignmen)n(ts)h
+(comma-separated)e(list)i(of)g(attribute)427 1086 y(assignmen)n(ts)h
(to)h(b)r(e)g(used)h(for)e(initialising)h(the)g(new)g(Ellipse.)44
b(The)30 b(syn)n(tax)g(used)g(is)g(iden)n(tical)f(to)h(that)427
-3924 y(for)c(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
+1186 y(for)c(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n
(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-4023 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 4169
-y Fd(...)427 4269 y Fi(If)38 b(the)g Ft(")p Fi(options)p
+1285 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 1423
+y Fd(...)427 1522 y Fi(If)38 b(the)g Ft(")p Fi(options)p
Ft(")e Fi(string)h(con)n(tains)f Ft(")p Fi(\045)p Ft(")h
Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g(list)h(of)f
-(additional)427 4368 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
+(additional)427 1622 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
(order)e(to)h(supply)h(v)-5 b(alues)27 b(to)g(b)r(e)h(substituted)h
-(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 4468 y(rules)25
+(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 1722 y(rules)25
b(for)f(supplying)h(these)g(are)f(iden)n(tical)h(to)g(those)g(for)f
(the)h(astSet)g(function)h(\(and)f(for)g(the)g(C)g Ft(")p
-Fi(prin)n(tf)p Ft(")427 4568 y Fi(function\).)0 4756
-y Fd(Returned)32 b(V)-8 b(alue:)259 4918 y(astEllipse\(\))427
-5018 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Ellipse.)0
-5206 y Fd(Notes:)340 5514 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+Fi(prin)n(tf)p Ft(")427 1821 y Fi(function\).)0 1992
+y Fd(Returned)32 b(V)-8 b(alue:)259 2137 y(astEllipse\(\))427
+2237 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Ellipse.)0
+2407 y Fd(Notes:)340 2698 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 5614 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p eop end
-%%Page: 224 234
-TeXDict begin 224 233 bop 0 52 a FF(224)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 483 a Fz(astEllipseP)l(ars)198 b Fe(Returns)38 b(the)h(geometric)d
-(parameters)1572 598 y(of)i(an)h(Ellipse)2958 483 y Fz(astEllipseP)l
-(ars)0 783 y Fd(Description:)44 b Fi(This)28 b(function)g(returns)f
-(the)h(geometric)e(parameters)g(describing)h(the)h(supplied)g(ellipse.)
-0 931 y Fd(Synopsis:)121 b Ft(void)42 b(astEllipsePars\()37
-b(AstEllipse)j Fh(\003)p Ft(this,)h(double)g(centre[2],)e(double)i
-Fh(\003)p Ft(a,)i(double)e Fh(\003)p Ft(b,)227 1031 y(double)g
-Fh(\003)p Ft(angle,)g(double)g(p1[2],)g(double)g(p2[2])h(\))0
-1179 y Fd(P)m(arameters:)259 1314 y(this)427 1413 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(Region.)259 1545 y Fd(cen)m(tre)427 1644
-y Fi(The)g(co)r(ordinates)e(of)i(the)g(Ellipse)f(cen)n(tre)g(are)f
-(returned)i(in)f(this)h(arra)n(ys.)259 1776 y Fd(a)427
-1875 y Fi(Returned)g(holding)f(the)h(half-length)g(of)f(the)h(\014rst)g
-(axis)e(of)i(the)g(ellipse.)259 2007 y Fd(b)427 2106
-y Fi(Returned)g(holding)f(the)h(half-length)g(of)f(the)h(second)f(axis)
-g(of)g(the)h(ellipse.)259 2237 y Fd(angle)427 2337 y
-Fi(If)38 b(the)f(co)r(ordinate)f(system)h(in)g(whic)n(h)g(the)h
+427 2798 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 3006 3780 12 v 0 3138
+a Fz(astEllipseP)l(ars)198 b Fe(Returns)38 b(the)h(geometric)d
+(parameters)1572 3252 y(of)i(an)h(Ellipse)2958 3138 y
+Fz(astEllipseP)l(ars)0 3450 y Fd(Description:)44 b Fi(This)28
+b(function)g(returns)f(the)h(geometric)e(parameters)g(describing)h(the)
+h(supplied)g(ellipse.)0 3608 y Fd(Synopsis:)121 b Ft(void)42
+b(astEllipsePars\()37 b(AstEllipse)j Fh(\003)p Ft(this,)h(double)g
+(centre[2],)e(double)i Fh(\003)p Ft(a,)i(double)e Fh(\003)p
+Ft(b,)227 3708 y(double)g Fh(\003)p Ft(angle,)g(double)g(p1[2],)g
+(double)g(p2[2])h(\))0 3866 y Fd(P)m(arameters:)259 4011
+y(this)427 4110 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Region.)259
+4248 y Fd(cen)m(tre)427 4347 y Fi(The)g(co)r(ordinates)e(of)i(the)g
+(Ellipse)f(cen)n(tre)g(are)f(returned)i(in)f(this)h(arra)n(ys.)259
+4484 y Fd(a)427 4584 y Fi(Returned)g(holding)f(the)h(half-length)g(of)f
+(the)h(\014rst)g(axis)e(of)i(the)g(ellipse.)259 4721
+y Fd(b)427 4821 y Fi(Returned)g(holding)f(the)h(half-length)g(of)f(the)
+h(second)f(axis)g(of)g(the)h(ellipse.)259 4958 y Fd(angle)427
+5058 y Fi(If)38 b(the)f(co)r(ordinate)f(system)h(in)g(whic)n(h)g(the)h
(Ellipse)f(is)g(de\014ned)g(has)g(axes)f(\(X,Y\),)i(then)g
-Ft(")p Fh(\003)p Fi(angle)p Ft(")d Fi(is)427 2437 y(returned)d(holding)
+Ft(")p Fh(\003)p Fi(angle)p Ft(")d Fi(is)427 5157 y(returned)d(holding)
g(the)g(angle)f(from)h(the)h(p)r(ositiv)n(e)e(direction)h(of)g(the)h(Y)
-f(axis)f(to)h(the)h(\014rst)f(axis)f(of)h(the)427 2536
+f(axis)f(to)h(the)h(\014rst)f(axis)f(of)h(the)427 5257
y(ellipse,)22 b(in)f(radians.)33 b(P)n(ositiv)n(e)19
b(rotation)g(is)h(in)h(the)g(same)e(sense)h(as)g(rotation)f(from)h(the)
-h(p)r(ositiv)n(e)f(direction)427 2636 y(of)28 b(Y)g(to)f(the)h(p)r
-(ositiv)n(e)f(direction)h(of)f(X.)259 2767 y Fd(p1)427
-2867 y Fi(An)34 b(arra)n(y)c(in)j(whic)n(h)g(to)g(return)f(the)h(co)r
+h(p)r(ositiv)n(e)f(direction)427 5357 y(of)28 b(Y)g(to)f(the)h(p)r
+(ositiv)n(e)f(direction)h(of)f(X.)259 5494 y Fd(p1)427
+5593 y Fi(An)34 b(arra)n(y)c(in)j(whic)n(h)g(to)g(return)f(the)h(co)r
(ordinates)f(at)g(one)h(of)g(the)g(t)n(w)n(o)f(ends)h(of)g(the)g
-(\014rst)f(axis)g(of)h(the)427 2967 y(ellipse.)k(A)28
+(\014rst)f(axis)g(of)h(the)427 5693 y(ellipse.)k(A)28
b(NULL)g(p)r(oin)n(ter)f(can)g(b)r(e)h(supplied)g(if)g(these)g(co)r
-(ordinates)e(are)h(not)g(needed.)259 3098 y Fd(p2)427
-3197 y Fi(An)h(arra)n(y)e(in)i(whic)n(h)g(to)f(return)h(the)g(co)r
-(ordinates)e(at)i(one)f(of)h(the)g(t)n(w)n(o)f(ends)h(of)f(the)h
-(second)g(axis)f(of)g(the)427 3297 y(ellipse.)37 b(A)28
-b(NULL)g(p)r(oin)n(ter)f(can)g(b)r(e)h(supplied)g(if)g(these)g(co)r
-(ordinates)e(are)h(not)g(needed.)0 3457 y Fd(Notes:)340
-3738 y Fh(\017)45 b Fi(If)22 b(the)g(co)r(ordinate)e(system)h(represen)
-n(ted)f(b)n(y)h(the)h(Ellipse)e(has)h(b)r(een)h(c)n(hanged)e(since)h
-(it)h(w)n(as)e(\014rst)h(created,)427 3838 y(the)e(returned)f
-(parameters)f(refer)h(to)h(the)g(new)f(\(c)n(hanged\))g(co)r(ordinate)g
-(system,)i(rather)d(than)i(the)g(original)427 3938 y(co)r(ordinate)27
+(ordinates)e(are)h(not)g(needed.)p eop end
+%%Page: 225 235
+TeXDict begin 225 234 bop 3643 52 a FF(225)259 351 y
+Fd(p2)427 451 y Fi(An)28 b(arra)n(y)e(in)i(whic)n(h)g(to)f(return)h
+(the)g(co)r(ordinates)e(at)i(one)f(of)h(the)g(t)n(w)n(o)f(ends)h(of)f
+(the)h(second)g(axis)f(of)g(the)427 551 y(ellipse.)37
+b(A)28 b(NULL)g(p)r(oin)n(ter)f(can)g(b)r(e)h(supplied)g(if)g(these)g
+(co)r(ordinates)e(are)h(not)g(needed.)0 714 y Fd(Notes:)340
+998 y Fh(\017)45 b Fi(If)22 b(the)g(co)r(ordinate)e(system)h(represen)n
+(ted)f(b)n(y)h(the)h(Ellipse)e(has)h(b)r(een)h(c)n(hanged)e(since)h(it)
+h(w)n(as)e(\014rst)h(created,)427 1098 y(the)e(returned)f(parameters)f
+(refer)h(to)h(the)g(new)f(\(c)n(hanged\))g(co)r(ordinate)g(system,)i
+(rather)d(than)i(the)g(original)427 1197 y(co)r(ordinate)27
b(system.)37 b(Note)28 b(ho)n(w)n(ev)n(er)e(that)i(if)g(the)g
(transformation)f(from)g(original)f(to)i(new)g(co)r(ordinate)427
-4037 y(system)36 b(is)h(non-linear,)g(the)g(shap)r(e)f(represen)n(ted)f
+1297 y(system)36 b(is)h(non-linear,)g(the)g(shap)r(e)f(represen)n(ted)f
(b)n(y)h(the)h(supplied)g(Ellipse)f(ob)5 b(ject)36 b(ma)n(y)g(not)g(b)r
-(e)h(an)427 4137 y(accurate)27 b(ellipse.)340 4268 y
+(e)h(an)427 1397 y(accurate)27 b(ellipse.)340 1530 y
Fh(\017)45 b Fi(V)-7 b(alues)20 b(of)h(AST)p Ft(__)p
Fi(BAD)f(are)f(returned)h(for)g(the)h(parameters)e(without)h(error)f
-(if)i(the)f(ellipse)h(is)f(degenerate)427 4368 y(or)27
-b(unde\014ned.)p 0 4564 V 0 4696 a Fz(astEmpt)l(yFits)329
+(if)i(the)f(ellipse)h(is)f(degenerate)427 1630 y(or)27
+b(unde\014ned.)p 0 1831 3780 12 v 0 1962 a Fz(astEmpt)l(yFits)329
b Fe(Delete)39 b(all)e(cards)i(in)f(a)h(FitsChan)326
-b Fz(astEmpt)l(yFits)0 4882 y Fd(Description:)44 b Fi(This)28
+b Fz(astEmpt)l(yFits)0 2153 y Fd(Description:)44 b Fi(This)28
b(function)g(deletes)g(all)f(cards)f(and)i(asso)r(ciated)e(information)
-h(from)g(a)h(FitsChan.)0 5030 y Fd(Synopsis:)121 b Ft(void)42
+h(from)g(a)h(FitsChan.)0 2304 y Fd(Synopsis:)121 b Ft(void)42
b(astEmptyFits\()c(AstFitsChan)h Fh(\003)p Ft(this)i(\))0
-5177 y Fd(P)m(arameters:)259 5312 y(this)427 5412 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(FitsChan.)0 5572 y Fd(Notes:)p eop end
-%%Page: 225 235
-TeXDict begin 225 234 bop 3643 52 a FF(225)340 351 y
+2455 y Fd(P)m(arameters:)259 2593 y(this)427 2693 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(FitsChan.)0 2856 y Fd(Notes:)340 3140 y
Fh(\017)45 b Fi(This)31 b(metho)r(d)h(simply)f(deletes)g(the)g(cards)f
(curren)n(tly)g(in)h(the)g(FitsChan.)47 b(Unlik)n(e)31
-b(astW)-7 b(riteFits,)32 b(they)427 451 y(are)27 b(not)g(\014rst)h
+b(astW)-7 b(riteFits,)32 b(they)427 3240 y(are)27 b(not)g(\014rst)h
(written)g(out)f(to)h(the)g(sink)f(function)h(or)f(sink)g(\014le.)340
-580 y Fh(\017)45 b Fi(An)n(y)28 b(T)-7 b(ables)27 b(or)g(w)n(arnings)f
+3374 y Fh(\017)45 b Fi(An)n(y)28 b(T)-7 b(ables)27 b(or)g(w)n(arnings)f
(stored)g(in)i(the)g(FitsChan)g(are)e(also)h(deleted.)340
-709 y Fh(\017)45 b Fi(This)28 b(metho)r(d)g(attempt)g(to)g(execute)f
+3507 y Fh(\017)45 b Fi(This)28 b(metho)r(d)g(attempt)g(to)g(execute)f
(ev)n(en)g(if)h(an)g(error)d(has)i(o)r(ccurred)g(previously)-7
-b(.)p 0 900 3780 12 v 0 1032 a Fz(astEnd)949 b Fe(End)39
-b(an)g(AST)f(con)m(text)947 b Fz(astEnd)0 1189 y Fd(Description:)44
-b Fi(This)28 b(macro)f(in)n(v)n(ok)n(es)f(a)h(function)i(to)e(end)h(an)
-g(AST)g(con)n(text)g(whic)n(h)f(w)n(as)g(b)r(egun)h(with)h(a)e(matc)n
-(hing)227 1289 y(in)n(v)n(o)r(cation)c(of)i(astBegin.)35
-b(An)n(y)24 b(Ob)5 b(ject)25 b(p)r(oin)n(ters)e(created)h(within)h
-(this)g(con)n(text)f(will)h(b)r(e)g(ann)n(ulled)f(\(just)h(as)f(if)227
-1388 y(astAnn)n(ul)g(had)f(b)r(een)h(in)n(v)n(ok)n(ed\))e(and)i(will)g
+b(.)p 0 3708 V 0 3840 a Fz(astEnd)949 b Fe(End)39 b(an)g(AST)f(con)m
+(text)947 b Fz(astEnd)0 4007 y Fd(Description:)44 b Fi(This)28
+b(macro)f(in)n(v)n(ok)n(es)f(a)h(function)i(to)e(end)h(an)g(AST)g(con)n
+(text)g(whic)n(h)f(w)n(as)g(b)r(egun)h(with)h(a)e(matc)n(hing)227
+4107 y(in)n(v)n(o)r(cation)c(of)i(astBegin.)35 b(An)n(y)24
+b(Ob)5 b(ject)25 b(p)r(oin)n(ters)e(created)h(within)h(this)g(con)n
+(text)f(will)h(b)r(e)g(ann)n(ulled)f(\(just)h(as)f(if)227
+4206 y(astAnn)n(ul)g(had)f(b)r(een)h(in)n(v)n(ok)n(ed\))e(and)i(will)g
(cease)e(to)h(b)r(e)h(v)-5 b(alid)24 b(afterw)n(ards,)f(unless)g(they)h
-(ha)n(v)n(e)e(previously)g(b)r(een)227 1488 y(exp)r(orted)31
+(ha)n(v)n(e)e(previously)g(b)r(een)227 4306 y(exp)r(orted)31
b(using)g(astExp)r(ort)e(or)i(rendered)f(exempt)h(using)g(astExempt.)47
b(If)31 b(ann)n(ulling)g(a)f(p)r(oin)n(ter)h(causes)f(an)227
-1588 y(Ob)5 b(ject's)24 b(RefCoun)n(t)h(attribute)f(to)h(fall)f(to)g
+4406 y(Ob)5 b(ject's)24 b(RefCoun)n(t)h(attribute)f(to)h(fall)f(to)g
(zero)g(\(whic)n(h)g(happ)r(ens)h(when)f(the)h(last)f(p)r(oin)n(ter)g
-(to)g(it)h(is)f(ann)n(ulled\),)227 1687 y(then)k(the)g(Ob)5
-b(ject)28 b(will)g(b)r(e)g(deleted.)0 1833 y Fd(Synopsis:)121
-b Ft(void)42 b(astEnd)0 1978 y Fd(Class)31 b(Applicabilit)m(y:)259
-2111 y(Ob)5 b(ject)427 2210 y Fi(This)28 b(macro)e(applies)h(to)h(all)f
-(Ob)5 b(jects.)0 2368 y Fd(Notes:)340 2647 y Fh(\017)45
+(to)g(it)h(is)f(ann)n(ulled\),)227 4505 y(then)k(the)g(Ob)5
+b(ject)28 b(will)g(b)r(e)g(deleted.)0 4656 y Fd(Synopsis:)121
+b Ft(void)42 b(astEnd)0 4807 y Fd(Class)31 b(Applicabilit)m(y:)259
+4945 y(Ob)5 b(ject)427 5045 y Fi(This)28 b(macro)e(applies)h(to)h(all)f
+(Ob)5 b(jects.)0 5208 y Fd(Notes:)340 5493 y Fh(\017)45
b Fi(astEnd)27 b(attempts)h(to)g(execute)f(ev)n(en)g(if)h(the)g(AST)g
-(error)e(status)h(is)h(set.)340 2776 y Fh(\017)45 b Fi(Con)n(texts)27
+(error)e(status)h(is)h(set.)340 5626 y Fh(\017)45 b Fi(Con)n(texts)27
b(delimited)i(b)n(y)e(astBegin)g(and)g(astEnd)g(ma)n(y)g(b)r(e)h
-(nested)g(to)f(an)n(y)g(depth.)p 0 2967 V 0 3097 a Fz(astEscap)t(es)
-1034 3098 y Fe(Con)m(trol)36 b(whether)i(graphical)e(escap)s(e)1054
-3213 y(sequences)k(are)e(included)g(in)h(strings)3149
-3097 y Fz(astEscap)t(es)0 3394 y Fd(Description:)44 b
-Fi(The)39 b(Plot)g(class)f(de\014nes)g(a)h(set)g(of)g(escap)r(e)f
-(sequences)g(whic)n(h)h(can)f(b)r(e)i(included)f(within)h(a)e(text)227
-3494 y(string)29 b(in)g(order)f(to)h(con)n(trol)f(the)h(app)r(earance)f
-(of)h(sub-strings)f(within)h(the)h(text.)42 b(See)29
-b(the)g(Escap)r(e)f(attribute)227 3593 y(for)j(a)g(description)f(of)h
-(these)g(escap)r(e)g(sequences.)46 b(It)32 b(is)f(usually)f
+(nested)g(to)f(an)n(y)g(depth.)p eop end
+%%Page: 226 236
+TeXDict begin 226 235 bop 0 52 a FF(226)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 482 a Fz(astEscap)t(es)1034 483 y Fe(Con)m(trol)36
+b(whether)i(graphical)e(escap)s(e)1054 598 y(sequences)k(are)e
+(included)g(in)h(strings)3149 482 y Fz(astEscap)t(es)0
+764 y Fd(Description:)44 b Fi(The)39 b(Plot)g(class)f(de\014nes)g(a)h
+(set)g(of)g(escap)r(e)f(sequences)g(whic)n(h)h(can)f(b)r(e)i(included)f
+(within)h(a)e(text)227 863 y(string)29 b(in)g(order)f(to)h(con)n(trol)f
+(the)h(app)r(earance)f(of)h(sub-strings)f(within)h(the)h(text.)42
+b(See)29 b(the)g(Escap)r(e)f(attribute)227 963 y(for)j(a)g(description)
+f(of)h(these)g(escap)r(e)g(sequences.)46 b(It)32 b(is)f(usually)f
(inappropriate)g(for)g(AST)i(to)f(return)g(strings)227
-3693 y(con)n(taining)i(suc)n(h)h(escap)r(e)f(sequences)h(when)g(called)
+1063 y(con)n(taining)i(suc)n(h)h(escap)r(e)f(sequences)h(when)g(called)
g(b)n(y)f(application)h(co)r(de.)56 b(F)-7 b(or)33 b(instance,)j(an)d
-(application)227 3792 y(whic)n(h)22 b(displa)n(ys)e(the)i(v)-5
+(application)227 1162 y(whic)n(h)22 b(displa)n(ys)e(the)i(v)-5
b(alue)22 b(of)f(the)h(Title)g(attribute)g(of)f(a)g(F)-7
b(rame)21 b(usually)g(do)r(es)g(not)h(w)n(an)n(t)f(the)h(displa)n(y)n
-(ed)e(string)227 3892 y(to)25 b(include)g(p)r(oten)n(tially)g(long)f
+(ed)e(string)227 1262 y(to)25 b(include)g(p)r(oten)n(tially)g(long)f
(escap)r(e)g(sequences)g(whic)n(h)h(a)g(h)n(uman)f(read)g(w)n(ould)h
-(ha)n(v)n(e)e(di\016culy)i(in)n(terpreting.)227 3992
+(ha)n(v)n(e)e(di\016culy)i(in)n(terpreting.)227 1362
y(Therefore)37 b(the)h(default)g(b)r(eha)n(viour)f(is)h(for)f(AST)h(to)
g(strip)g(out)g(suc)n(h)f(escap)r(e)g(sequences)g(when)h(called)g(b)n
-(y)227 4091 y(application)27 b(co)r(de.)37 b(This)27
+(y)227 1461 y(application)27 b(co)r(de.)37 b(This)27
b(default)i(b)r(eha)n(viour)d(can)h(b)r(e)h(c)n(hanged)f(using)g(this)h
-(function.)0 4237 y Fd(Synopsis:)121 b Ft(int)42 b(astEscapes\()d(int)k
-(new_value)c(\))0 4382 y Fd(P)m(arameters:)259 4515 y(new)p
-Ft(_)p Fd(v)-5 b(alue)427 4614 y Fi(A)29 b(\015ag)f(whic)n(h)h
+(function.)0 1599 y Fd(Synopsis:)121 b Ft(int)42 b(astEscapes\()d(int)k
+(new_value)c(\))0 1738 y Fd(P)m(arameters:)259 1863 y(new)p
+Ft(_)p Fd(v)-5 b(alue)427 1962 y Fi(A)29 b(\015ag)f(whic)n(h)h
(indicates)f(if)h(escap)r(es)f(sequences)g(should)g(b)r(e)h(included)g
(in)g(returned)f(strings.)39 b(If)29 b(zero)f(is)427
-4714 y(supplied,)c(escap)r(e)e(sequences)f(will)h(b)r(e)h(stripp)r(ed)f
+2062 y(supplied,)c(escap)r(e)e(sequences)f(will)h(b)r(e)h(stripp)r(ed)f
(out)h(of)f(all)g(strings)f(returned)h(b)n(y)g(an)n(y)f(AST)i
-(function.)35 b(If)427 4813 y(a)20 b(p)r(ositiv)n(e)g(v)-5
+(function.)35 b(If)427 2162 y(a)20 b(p)r(ositiv)n(e)g(v)-5
b(alue)20 b(is)g(supplied,)j(then)d(an)n(y)g(escap)r(e)g(sequences)f
(will)i(b)r(e)g(retained)e(in)i(the)g(v)-5 b(alue)20
-b(returned)g(to)427 4913 y(the)k(caller.)34 b(If)24 b(a)e(negativ)n(e)g
+b(returned)g(to)427 2261 y(the)k(caller.)34 b(If)24 b(a)e(negativ)n(e)g
(v)-5 b(alue)23 b(is)g(supplied,)i(the)e(curren)n(t)f(v)-5
b(alue)23 b(of)g(the)h(\015ag)e(will)i(b)r(e)f(left)h(unc)n(hanged.)0
-5071 y Fd(Class)31 b(Applicabilit)m(y:)259 5203 y(Ob)5
-b(ject)427 5303 y Fi(This)28 b(macro)e(applies)h(to)h(all)f(Ob)5
-b(jects.)0 5461 y Fd(Returned)32 b(V)-8 b(alue:)259 5593
-y(astEscap)s(es)427 5693 y Fi(The)28 b(v)-5 b(alue)27
-b(of)h(the)g(\015ag)f(on)g(en)n(try)g(to)h(this)f(function.)p
-eop end
-%%Page: 226 236
-TeXDict begin 226 235 bop 0 52 a FF(226)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Notes:)340
-654 y Fh(\017)45 b Fi(This)32 b(function)h(also)e(con)n(trols)g
-(whether)h(the)g(astStripEscap)r(es)f(function)i(remo)n(v)n(es)d(escap)
-r(e)h(sequences)427 754 y(from)d(the)g(supplied)f(string,)g(or)g
-(returns)g(the)h(supplied)g(string)f(without)h(c)n(hange.)340
-897 y Fh(\017)45 b Fi(This)28 b(function)g(attempts)g(to)f(execute)h
-(ev)n(en)f(if)h(an)f(error)f(has)h(already)f(o)r(ccurred.)p
-0 1116 3780 12 v 0 1247 a Fz(astExempt)936 1248 y Fe(Exempt)38
+2412 y Fd(Class)31 b(Applicabilit)m(y:)259 2537 y(Ob)5
+b(ject)427 2637 y Fi(This)28 b(macro)e(applies)h(to)h(all)f(Ob)5
+b(jects.)0 2787 y Fd(Returned)32 b(V)-8 b(alue:)259 2912
+y(astEscap)s(es)427 3012 y Fi(The)28 b(v)-5 b(alue)27
+b(of)h(the)g(\015ag)f(on)g(en)n(try)g(to)h(this)f(function.)0
+3163 y Fd(Notes:)340 3434 y Fh(\017)45 b Fi(This)32 b(function)h(also)e
+(con)n(trols)g(whether)h(the)g(astStripEscap)r(es)f(function)i(remo)n
+(v)n(es)d(escap)r(e)h(sequences)427 3534 y(from)d(the)g(supplied)f
+(string,)g(or)g(returns)g(the)h(supplied)g(string)f(without)h(c)n
+(hange.)340 3655 y Fh(\017)45 b Fi(This)28 b(function)g(attempts)g(to)f
+(execute)h(ev)n(en)f(if)h(an)f(error)f(has)h(already)f(o)r(ccurred.)p
+0 3832 V 0 3963 a Fz(astExempt)936 3964 y Fe(Exempt)38
b(an)g(Ob)7 b(ject)38 b(p)s(oin)m(ter)g(from)f(AST)1461
-1362 y(con)m(text)g(handling)3149 1247 y Fz(astExempt)0
-1572 y Fd(Description:)44 b Fi(This)26 b(function)g(exempts)g(an)g(Ob)5
+4078 y(con)m(text)g(handling)3149 3963 y Fz(astExempt)0
+4244 y Fd(Description:)44 b Fi(This)26 b(function)g(exempts)g(an)g(Ob)5
b(ject)25 b(p)r(oin)n(ter)h(from)f(AST)h(con)n(text)g(handling,)f(as)h
-(implemen)n(ted)g(b)n(y)227 1671 y(astBegin)d(and)g(astEnd.)35
+(implemen)n(ted)g(b)n(y)227 4344 y(astBegin)d(and)g(astEnd.)35
b(This)24 b(means)f(that)h(the)g(p)r(oin)n(ter)f(will)h(not)g(b)r(e)g
(a\013ected)f(when)h(astEnd)f(is)h(in)n(v)n(ok)n(ed)e(and)227
-1771 y(will)28 b(remain)f(activ)n(e)g(un)n(til)h(the)g(end)g(of)f(the)h
+4444 y(will)28 b(remain)f(activ)n(e)g(un)n(til)h(the)g(end)g(of)f(the)h
(program,)e(or)h(un)n(til)h(explicitly)f(ann)n(ulled)h(using)f(astAnn)n
-(ul.)227 1905 y(If)j(p)r(ossible,)g(y)n(ou)f(should)g(a)n(v)n(oid)f
+(ul.)227 4563 y(If)j(p)r(ossible,)g(y)n(ou)f(should)g(a)n(v)n(oid)f
(using)h(this)h(function)g(when)g(writing)f(applications.)42
-b(It)30 b(is)f(pro)n(vided)g(mainly)227 2005 y(for)23
+b(It)30 b(is)f(pro)n(vided)g(mainly)227 4662 y(for)23
b(dev)n(elop)r(ers)f(of)h(other)f(libraries,)h(who)g(ma)n(y)f(wish)h
(to)g(retain)g(references)f(to)h(AST)g(Ob)5 b(jects)23
-b(in)h(in)n(ternal)e(data)227 2105 y(structures,)27 b(and)h(who)f
+b(in)h(in)n(ternal)e(data)227 4762 y(structures,)27 b(and)h(who)f
(therefore)g(need)g(to)h(a)n(v)n(oid)e(the)i(e\013ects)g(of)f(astBegin)
-g(and)g(astEnd.)0 2274 y Fd(Synopsis:)121 b Ft(void)42
+g(and)g(astEnd.)0 4900 y Fd(Synopsis:)121 b Ft(void)42
b(astExempt\()d(AstObject)h Fh(\003)p Ft(this)i(\))0
-2444 y Fd(P)m(arameters:)259 2601 y(this)427 2700 y Fi(Ob)5
+5038 y Fd(P)m(arameters:)259 5163 y(this)427 5263 y Fi(Ob)5
b(ject)28 b(p)r(oin)n(ter)f(to)g(b)r(e)h(exempted)g(from)g(con)n(text)f
-(handling.)0 2883 y Fd(Class)k(Applicabilit)m(y:)259
-3039 y(Ob)5 b(ject)427 3139 y Fi(This)28 b(function)g(applies)f(to)h
-(all)f(Ob)5 b(jects.)p 0 3358 V 0 3489 a Fz(astExp)t(ort)735
-3490 y Fe(Exp)s(ort)33 b(an)h(Ob)7 b(ject)34 b(p)s(oin)m(ter)f(to)h(an)
-g(outer)f(con)m(text)3197 3489 y Fz(astExp)t(ort)0 3699
-y Fd(Description:)44 b Fi(This)31 b(function)h(exp)r(orts)e(an)g(Ob)5
-b(ject)31 b(p)r(oin)n(ter)g(from)f(the)h(curren)n(t)f(AST)i(con)n(text)
-e(in)n(to)h(the)g(con)n(text)227 3799 y(that)i(encloses)e(the)i(curren)
-n(t)f(one.)51 b(This)33 b(means)f(that)g(the)h(p)r(oin)n(ter)f(will)h
-(no)f(longer)f(b)r(e)i(ann)n(ulled)g(when)f(the)227 3898
-y(curren)n(t)27 b(con)n(text)g(is)h(ended)g(\(with)g(astEnd\),)f(but)h
-(only)g(when)f(the)h(next)g(outer)f(con)n(text)g(\(if)i(an)n(y\))e
-(ends.)0 4068 y Fd(Synopsis:)121 b Ft(void)42 b(astExport\()d
-(AstObject)h Fh(\003)p Ft(this)i(\))0 4238 y Fd(P)m(arameters:)259
-4395 y(this)427 4494 y Fi(Ob)5 b(ject)28 b(p)r(oin)n(ter)f(to)g(b)r(e)h
-(exp)r(orted.)0 4676 y Fd(Class)j(Applicabilit)m(y:)259
-4833 y(Ob)5 b(ject)427 4933 y Fi(This)28 b(function)g(applies)f(to)h
-(all)f(Ob)5 b(jects.)0 5115 y Fd(Notes:)340 5418 y Fh(\017)45
+(handling.)0 5414 y Fd(Class)k(Applicabilit)m(y:)259
+5539 y(Ob)5 b(ject)427 5638 y Fi(This)28 b(function)g(applies)f(to)h
+(all)f(Ob)5 b(jects.)p eop end
+%%Page: 227 237
+TeXDict begin 227 236 bop 3643 52 a FF(227)p 0 351 3780
+12 v 0 482 a Fz(astExp)t(ort)735 483 y Fe(Exp)s(ort)33
+b(an)h(Ob)7 b(ject)34 b(p)s(oin)m(ter)f(to)h(an)g(outer)f(con)m(text)
+3197 482 y Fz(astExp)t(ort)0 678 y Fd(Description:)44
+b Fi(This)31 b(function)h(exp)r(orts)e(an)g(Ob)5 b(ject)31
+b(p)r(oin)n(ter)g(from)f(the)h(curren)n(t)f(AST)i(con)n(text)e(in)n(to)
+h(the)g(con)n(text)227 778 y(that)i(encloses)e(the)i(curren)n(t)f(one.)
+51 b(This)33 b(means)f(that)g(the)h(p)r(oin)n(ter)f(will)h(no)f(longer)
+f(b)r(e)i(ann)n(ulled)g(when)f(the)227 877 y(curren)n(t)27
+b(con)n(text)g(is)h(ended)g(\(with)g(astEnd\),)f(but)h(only)g(when)f
+(the)h(next)g(outer)f(con)n(text)g(\(if)i(an)n(y\))e(ends.)0
+1033 y Fd(Synopsis:)121 b Ft(void)42 b(astExport\()d(AstObject)h
+Fh(\003)p Ft(this)i(\))0 1189 y Fd(P)m(arameters:)259
+1332 y(this)427 1431 y Fi(Ob)5 b(ject)28 b(p)r(oin)n(ter)f(to)g(b)r(e)h
+(exp)r(orted.)0 1600 y Fd(Class)j(Applicabilit)m(y:)259
+1742 y(Ob)5 b(ject)427 1842 y Fi(This)28 b(function)g(applies)f(to)h
+(all)f(Ob)5 b(jects.)0 2010 y Fd(Notes:)340 2299 y Fh(\017)45
b Fi(It)21 b(is)f(only)g(sensible)h(to)f(apply)g(this)h(function)g(to)f
(p)r(oin)n(ters)g(that)g(ha)n(v)n(e)g(b)r(een)g(created)g(within)h
-(\(or)f(exp)r(orted)427 5517 y(to\))26 b(the)g(curren)n(t)f(con)n(text)
+(\(or)f(exp)r(orted)427 2399 y(to\))26 b(the)g(curren)n(t)f(con)n(text)
h(and)f(ha)n(v)n(e)g(not)g(b)r(een)i(rendered)e(exempt)h(using)f
-(astExempt.)36 b(Applying)26 b(it)g(to)427 5617 y(an)i(unsuitable)f(Ob)
+(astExempt.)36 b(Applying)26 b(it)g(to)427 2498 y(an)i(unsuitable)f(Ob)
5 b(ject)28 b(p)r(oin)n(ter)f(has)g(no)g(e\013ect.)p
-eop end
-%%Page: 227 237
-TeXDict begin 227 236 bop 3643 52 a FF(227)p 0 351 3780
-12 v 0 483 a Fz(astFindFits)314 b Fe(Find)39 b(a)g(FITS)g(card)f(in)h
-(a)f(FitsChan)g(b)m(y)1678 598 y(k)m(eyw)m(ord)3110 483
-y Fz(astFindFits)0 769 y Fd(Description:)44 b Fi(This)33
+0 2704 V 0 2836 a Fz(astFindFits)314 b Fe(Find)39 b(a)g(FITS)g(card)f
+(in)h(a)f(FitsChan)g(b)m(y)1678 2950 y(k)m(eyw)m(ord)3110
+2836 y Fz(astFindFits)0 3145 y Fd(Description:)44 b Fi(This)33
b(function)f(searc)n(hes)f(for)g(a)h(card)g(in)g(a)g(FitsChan)g(b)n(y)g
(k)n(eyw)n(ord.)49 b(The)32 b(searc)n(h)f(commences)h(at)227
-869 y(the)k(curren)n(t)e(card)g(\(iden)n(ti\014ed)i(b)n(y)f(the)g(Card)
-f(attribute\))i(and)f(ends)g(when)g(a)f(card)h(is)g(found)g(whose)f
-(FITS)227 968 y(k)n(eyw)n(ord)25 b(matc)n(hes)h(the)g(template)h
-(supplied,)g(or)f(when)g(the)h(last)f(card)g(in)g(the)h(FitsChan)f(has)
-g(b)r(een)h(searc)n(hed.)227 1088 y(If)33 b(the)f(searc)n(h)e(is)i
-(successful)g(\(i.e.)50 b(a)32 b(card)f(is)h(found)g(whic)n(h)g(matc)n
-(hes)g(the)g(template\),)i(the)e(con)n(ten)n(ts)f(of)h(the)227
-1188 y(card)h(are)g(\(optionally\))h(returned)f(and)h(the)g(Card)g
-(attribute)g(is)f(adjusted)i(to)e(iden)n(tify)i(the)f(card)f(found)h
-(or,)227 1288 y(if)d(required,)f(the)g(one)g(follo)n(wing)f(it.)45
-b(If)31 b(the)f(searc)n(h)f(is)h(not)g(successful,)h(the)f(function)h
-(returns)e(zero)g(and)h(the)227 1387 y(Card)d(attribute)h(is)f(set)h
-(to)f(the)h Ft(")p Fi(end-of-\014le)p Ft(")p Fi(.)0 1528
-y Fd(Synopsis:)121 b Ft(int)42 b(astFindFits\()d(AstFitsChan)g
-Fh(\003)p Ft(this,)i(const)g(char)h Fh(\003)p Ft(name,)f(char)h(card[)g
-(81)h(],)f(int)h(inc)227 1628 y(\))0 1768 y Fd(P)m(arameters:)259
-1896 y(this)427 1996 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
-2120 y Fd(name)427 2219 y Fi(P)n(oin)n(ter)34 b(to)h(a)g(n)n
+3245 y(the)k(curren)n(t)e(card)g(\(iden)n(ti\014ed)i(b)n(y)f(the)g
+(Card)f(attribute\))i(and)f(ends)g(when)g(a)f(card)h(is)g(found)g
+(whose)f(FITS)227 3345 y(k)n(eyw)n(ord)25 b(matc)n(hes)h(the)g
+(template)h(supplied,)g(or)f(when)g(the)h(last)f(card)g(in)g(the)h
+(FitsChan)f(has)g(b)r(een)h(searc)n(hed.)227 3472 y(If)33
+b(the)f(searc)n(h)e(is)i(successful)g(\(i.e.)50 b(a)32
+b(card)f(is)h(found)g(whic)n(h)g(matc)n(hes)g(the)g(template\),)i(the)e
+(con)n(ten)n(ts)f(of)h(the)227 3572 y(card)h(are)g(\(optionally\))h
+(returned)f(and)h(the)g(Card)g(attribute)g(is)f(adjusted)i(to)e(iden)n
+(tify)i(the)f(card)f(found)h(or,)227 3672 y(if)d(required,)f(the)g(one)
+g(follo)n(wing)f(it.)45 b(If)31 b(the)f(searc)n(h)f(is)h(not)g
+(successful,)h(the)f(function)h(returns)e(zero)g(and)h(the)227
+3771 y(Card)d(attribute)h(is)f(set)h(to)f(the)h Ft(")p
+Fi(end-of-\014le)p Ft(")p Fi(.)0 3927 y Fd(Synopsis:)121
+b Ft(int)42 b(astFindFits\()d(AstFitsChan)g Fh(\003)p
+Ft(this,)i(const)g(char)h Fh(\003)p Ft(name,)f(char)h(card[)g(81)h(],)f
+(int)h(inc)227 4027 y(\))0 4182 y Fd(P)m(arameters:)259
+4325 y(this)427 4425 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
+4561 y Fd(name)427 4660 y Fi(P)n(oin)n(ter)34 b(to)h(a)g(n)n
(ull-terminated)g(c)n(haracter)e(string)i(con)n(taining)f(a)h(template)
-g(for)g(the)h(k)n(eyw)n(ord)d(to)i(b)r(e)427 2319 y(found.)66
+g(for)g(the)h(k)n(eyw)n(ord)d(to)i(b)r(e)427 4760 y(found.)66
b(In)37 b(the)g(simplest)h(case,)g(this)g(should)e(simply)h(b)r(e)h
(the)f(k)n(eyw)n(ord)f(name)g(\(the)i(searc)n(h)e(is)g(case)427
-2419 y(insensitiv)n(e)31 b(and)f(trailing)g(spaces)g(are)f(ignored\).)
+4860 y(insensitiv)n(e)31 b(and)f(trailing)g(spaces)g(are)f(ignored\).)
46 b(Ho)n(w)n(ev)n(er,)29 b(this)i(template)g(ma)n(y)f(also)g(con)n
-(tain)g Ft(")p Fi(\014eld)427 2518 y(sp)r(eci\014ers)p
+(tain)g Ft(")p Fi(\014eld)427 4959 y(sp)r(eci\014ers)p
Ft(")21 b Fi(whic)n(h)g(are)f(capable)g(of)i(matc)n(hing)e(a)h(range)f
(of)h(c)n(haracters)e(\(see)j(the)f Ft(")p Fi(Keyw)n(ord)e(T)-7
-b(emplates)p Ft(")427 2618 y Fi(section)30 b(for)g(details\).)46
+b(emplates)p Ft(")427 5059 y Fi(section)30 b(for)g(details\).)46
b(In)31 b(this)g(case,)f(the)h(\014rst)f(card)g(with)h(a)f(k)n(eyw)n
-(ord)f(whic)n(h)h(matc)n(hes)g(the)h(template)427 2717
+(ord)f(whic)n(h)h(matc)n(hes)g(the)h(template)427 5158
y(will)38 b(b)r(e)f(found.)66 b(T)-7 b(o)36 b(\014nd)i(the)f(next)g
(FITS)h(card)e(regardless)e(of)j(its)h(k)n(eyw)n(ord,)f(y)n(ou)g
-(should)f(use)h(the)427 2817 y(template)28 b Ft(")p Fi(\045f)p
-Ft(")p Fi(.)259 2941 y Fd(card)427 3041 y Fi(An)i(arra)n(y)d(of)i(at)g
+(should)f(use)h(the)427 5258 y(template)28 b Ft(")p Fi(\045f)p
+Ft(")p Fi(.)259 5394 y Fd(card)427 5494 y Fi(An)i(arra)n(y)d(of)i(at)g
(least)g(81)f(c)n(haracters)f(\(to)j(allo)n(w)e(ro)r(om)g(for)h(a)f
(terminating)h(n)n(ull\))h(in)f(whic)n(h)h(the)f(FITS)427
-3140 y(card)j(whic)n(h)g(is)g(found)g(will)h(b)r(e)f(returned.)50
+5593 y(card)j(whic)n(h)g(is)g(found)g(will)h(b)r(e)f(returned.)50
b(If)33 b(the)f(searc)n(h)f(is)h(not)g(successful)g(\(or)g(a)f(NULL)i
-(p)r(oin)n(ter)f(is)427 3240 y(giv)n(en\),)27 b(a)h(card)e(will)i(not)g
-(b)r(e)g(returned.)259 3364 y Fd(inc)427 3464 y Fi(If)j(this)f(v)-5
-b(alue)29 b(is)h(zero)f(\(and)h(the)g(searc)n(h)e(is)i(successful\),)g
-(the)h(FitsChan's)e(Card)g(attribute)h(will)g(b)r(e)h(set)427
-3563 y(to)26 b(the)f(index)h(of)f(the)h(card)e(that)i(w)n(as)e(found.)
-37 b(If)26 b(it)f(is)h(non-zero,)e(ho)n(w)n(ev)n(er,)g(the)h(Card)g
-(attribute)h(will)f(b)r(e)427 3663 y(incremen)n(ted)j(to)f(iden)n(tify)
-h(the)g(card)f(whic)n(h)g(follo)n(ws)g(the)h(one)f(found.)0
-3816 y Fd(Returned)32 b(V)-8 b(alue:)259 3944 y(astFindFits\(\))427
-4044 y Fi(One)28 b(if)g(the)g(searc)n(h)e(w)n(as)g(successful,)i
-(otherwise)e(zero.)0 4197 y Fd(Examples:)227 4328 y Fp(result)46
+(p)r(oin)n(ter)f(is)427 5693 y(giv)n(en\),)27 b(a)h(card)e(will)i(not)g
+(b)r(e)g(returned.)p eop end
+%%Page: 228 238
+TeXDict begin 228 237 bop 0 52 a FF(228)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(inc)427
+451 y Fi(If)h(this)f(v)-5 b(alue)29 b(is)h(zero)f(\(and)h(the)g(searc)n
+(h)e(is)i(successful\),)g(the)h(FitsChan's)e(Card)g(attribute)h(will)g
+(b)r(e)h(set)427 551 y(to)26 b(the)f(index)h(of)f(the)h(card)e(that)i
+(w)n(as)e(found.)37 b(If)26 b(it)f(is)h(non-zero,)e(ho)n(w)n(ev)n(er,)g
+(the)h(Card)g(attribute)h(will)f(b)r(e)427 650 y(incremen)n(ted)j(to)f
+(iden)n(tify)h(the)g(card)f(whic)n(h)g(follo)n(ws)g(the)h(one)f(found.)
+0 824 y Fd(Returned)32 b(V)-8 b(alue:)259 973 y(astFindFits\(\))427
+1073 y Fi(One)28 b(if)g(the)g(searc)n(h)e(w)n(as)g(successful,)i
+(otherwise)e(zero.)0 1247 y Fd(Examples:)227 1400 y Fp(result)46
b(=)i(astFindFits\()c(fitschan,)i Ft(")p Fp(\045f)p Ft(")p
-Fp(,)g(card,)g(1)h(\);)427 4424 y Fi(Returns)26 b(the)g(curren)n(t)g
+Fp(,)g(card,)g(1)h(\);)427 1496 y Fi(Returns)26 b(the)g(curren)n(t)g
(card)f(in)h(a)f(FitsChan)h(and)g(adv)-5 b(ances)25 b(the)i(Card)e
-(attribute)h(to)g(iden)n(tify)g(the)g(card)427 4524 y(that)i(follo)n
+(attribute)h(to)g(iden)n(tify)g(the)g(card)427 1595 y(that)i(follo)n
(ws)f(\(the)h Ft(")p Fi(\045f)p Ft(")f Fi(template)h(matc)n(hes)f(an)n
-(y)g(k)n(eyw)n(ord\).)227 4652 y Fp(result)46 b(=)i(astFindFits\()c
+(y)g(k)n(eyw)n(ord\).)227 1738 y Fp(result)46 b(=)i(astFindFits\()c
(fitschan,)i Ft(")p Fp(BITPIX)p Ft(")p Fp(,)f(card,)h(1)h(\);)427
-4747 y Fi(Searc)n(hes)34 b(a)h(FitsChan)g(for)f(a)h(FITS)g(card)g(with)
+1834 y Fi(Searc)n(hes)34 b(a)h(FitsChan)g(for)f(a)h(FITS)g(card)g(with)
g(the)h Ft(")p Fi(BITPIX)p Ft(")e Fi(k)n(eyw)n(ord)f(and)i(returns)f
-(that)h(card.)427 4847 y(The)28 b(Card)f(attribute)g(is)h(then)g
+(that)h(card.)427 1934 y(The)28 b(Card)f(attribute)g(is)h(then)g
(incremen)n(ted)f(to)h(iden)n(tify)g(the)g(card)f(that)h(follo)n(ws)e
-(it.)227 4975 y Fp(result)46 b(=)i(astFindFits\()c(fitschan,)i
+(it.)227 2077 y Fp(result)46 b(=)i(astFindFits\()c(fitschan,)i
Ft(")p Fp(COMMENT)p Ft(")p Fp(,)e(NULL,)j(0)g(\);)427
-5071 y Fi(Sets)32 b(the)h(Card)e(attribute)h(of)g(a)f(FitsChan)h(to)g
+2172 y Fi(Sets)32 b(the)h(Card)e(attribute)h(of)g(a)f(FitsChan)h(to)g
(iden)n(tify)g(the)h(next)f(COMMENT)f(card)g(\(if)i(an)n(y\).)50
-b(The)427 5170 y(card)27 b(itself)h(is)g(not)f(returned.)227
-5299 y Fp(result)46 b(=)i(astFindFits\()c(fitschan,)i
+b(The)427 2272 y(card)27 b(itself)h(is)g(not)f(returned.)227
+2415 y Fp(result)46 b(=)i(astFindFits\()c(fitschan,)i
Ft(")p Fp(CRVAL\0451d)p Ft(")p Fp(,)e(card,)i(1)i(\);)427
-5394 y Fi(Searc)n(hes)28 b(a)h(FitsChan)g(for)g(the)h(next)g(card)e
+2511 y Fi(Searc)n(hes)28 b(a)h(FitsChan)g(for)g(the)h(next)g(card)e
(with)i(a)f(k)n(eyw)n(ord)e(of)i(the)h(form)f Ft(")p
Fi(CR)-9 b(V)g(ALi)p Ft(")29 b Fi(\(for)g(example,)427
-5494 y(an)n(y)k(of)h(the)f(k)n(eyw)n(ords)f Ft(")p Fi(CR)-9
+2610 y(an)n(y)k(of)h(the)f(k)n(eyw)n(ords)f Ft(")p Fi(CR)-9
b(V)g(AL1)p Ft(")p Fi(,)34 b Ft(")p Fi(CR)-9 b(V)g(AL2)p
Ft(")32 b Fi(or)h Ft(")p Fi(CR)-9 b(V)g(AL3)p Ft(")32
b Fi(w)n(ould)h(b)r(e)h(matc)n(hed\).)55 b(The)33 b(card)427
-5593 y(found)22 b(\(if)g(an)n(y\))e(is)h(returned,)i(and)e(the)g(Card)f
+2710 y(found)22 b(\(if)g(an)n(y\))e(is)h(returned,)i(and)e(the)g(Card)f
(attribute)i(is)f(then)g(incremen)n(ted)g(to)g(iden)n(tify)h(the)g
-(follo)n(wing)427 5693 y(card)27 b(\(ready)g(to)g(searc)n(h)f(for)h
-(another)g(k)n(eyw)n(ord)f(with)i(the)g(same)f(form,)g(p)r(erhaps\).)p
-eop end
-%%Page: 228 238
-TeXDict begin 228 237 bop 0 52 a FF(228)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Notes:)340
-674 y Fh(\017)45 b Fi(The)23 b(searc)n(h)f(alw)n(a)n(ys)f(starts)i
-(with)g(the)h(curren)n(t)e(card,)h(as)g(iden)n(ti\014ed)g(b)n(y)g(the)h
-(Card)e(attribute.)35 b(T)-7 b(o)23 b(ensure)427 774
-y(y)n(ou)i(searc)n(h)g(the)h(en)n(tire)g(con)n(ten)n(ts)f(of)h(a)f
-(FitsChan,)i(y)n(ou)e(should)h(\014rst)f(clear)g(the)h(Card)g
-(attribute)g(\(using)427 874 y(astClear\).)36 b(This)28
-b(e\013ectiv)n(ely)f Ft(")p Fi(rewinds)p Ft(")f Fi(the)i(FitsChan.)340
-1027 y Fh(\017)45 b Fi(If)24 b(a)g(searc)n(h)e(is)i(unsuccessful,)g
-(the)g(Card)f(attribute)h(is)g(set)f(to)h(the)g Ft(")p
-Fi(end-of-\014le)p Ft(")f Fi(\(i.e.)36 b(to)23 b(one)h(more)e(than)427
-1127 y(the)28 b(n)n(um)n(b)r(er)g(of)f(cards)g(in)g(the)h(FitsChan\).)
-38 b(No)27 b(error)f(o)r(ccurs.)340 1280 y Fh(\017)45
-b Fi(A)29 b(v)-5 b(alue)29 b(of)f(zero)g(will)h(b)r(e)g(returned)f(if)h
-(this)g(function)g(is)f(in)n(v)n(ok)n(ed)f(with)j(the)f(AST)g(error)d
-(status)j(set,)f(or)427 1379 y(if)g(it)g(should)g(fail)f(for)h(an)n(y)e
-(reason.)-2 1582 y Fd(Keyw)m(ord)33 b(T)-8 b(emplates)n(:)227
-1728 y Fi(The)32 b(templates)f(used)h(to)f(matc)n(h)g(FITS)h(k)n(eyw)n
-(ords)d(are)i(normally)f(comp)r(osed)h(of)h(literal)e(c)n(haracters,)h
-(whic)n(h)227 1828 y(m)n(ust)f(matc)n(h)g(the)h(k)n(eyw)n(ord)d
-(exactly)h(\(apart)h(from)f(case\).)44 b(Ho)n(w)n(ev)n(er,)29
-b(a)h(template)g(ma)n(y)f(also)g(con)n(tain)h Ft(")p
-Fi(\014eld)227 1927 y(sp)r(eci\014ers)p Ft(")25 b Fi(whic)n(h)h(can)g
-(matc)n(h)f(a)h(range)f(of)h(p)r(ossible)f(c)n(haracters.)34
-b(This)26 b(allo)n(ws)f(y)n(ou)g(to)h(searc)n(h)e(for)i(k)n(eyw)n(ords)
-227 2027 y(that)36 b(con)n(tain)f(\(for)g(example\))g(n)n(um)n(b)r
-(ers,)i(where)e(the)h(digits)f(comprising)f(the)i(n)n(um)n(b)r(er)f
-(are)f(not)i(kno)n(wn)e(in)227 2126 y(adv)-5 b(ance.)227
-2271 y(A)30 b(\014eld)g(sp)r(eci\014er)g(starts)f(with)h(a)f
-Ft(")p Fi(\045)p Ft(")h Fi(c)n(haracter.)41 b(This)30
+(follo)n(wing)427 2810 y(card)27 b(\(ready)g(to)g(searc)n(h)f(for)h
+(another)g(k)n(eyw)n(ord)f(with)i(the)g(same)f(form,)g(p)r(erhaps\).)0
+2984 y Fd(Notes:)340 3279 y Fh(\017)45 b Fi(The)23 b(searc)n(h)f(alw)n
+(a)n(ys)f(starts)i(with)g(the)h(curren)n(t)e(card,)h(as)g(iden)n
+(ti\014ed)g(b)n(y)g(the)h(Card)e(attribute.)35 b(T)-7
+b(o)23 b(ensure)427 3379 y(y)n(ou)i(searc)n(h)g(the)h(en)n(tire)g(con)n
+(ten)n(ts)f(of)h(a)f(FitsChan,)i(y)n(ou)e(should)h(\014rst)f(clear)g
+(the)h(Card)g(attribute)g(\(using)427 3478 y(astClear\).)36
+b(This)28 b(e\013ectiv)n(ely)f Ft(")p Fi(rewinds)p Ft(")f
+Fi(the)i(FitsChan.)340 3617 y Fh(\017)45 b Fi(If)24 b(a)g(searc)n(h)e
+(is)i(unsuccessful,)g(the)g(Card)f(attribute)h(is)g(set)f(to)h(the)g
+Ft(")p Fi(end-of-\014le)p Ft(")f Fi(\(i.e.)36 b(to)23
+b(one)h(more)e(than)427 3717 y(the)28 b(n)n(um)n(b)r(er)g(of)f(cards)g
+(in)g(the)h(FitsChan\).)38 b(No)27 b(error)f(o)r(ccurs.)340
+3856 y Fh(\017)45 b Fi(A)29 b(v)-5 b(alue)29 b(of)f(zero)g(will)h(b)r
+(e)g(returned)f(if)h(this)g(function)g(is)f(in)n(v)n(ok)n(ed)f(with)j
+(the)f(AST)g(error)d(status)j(set,)f(or)427 3956 y(if)g(it)g(should)g
+(fail)f(for)h(an)n(y)e(reason.)-2 4130 y Fd(Keyw)m(ord)33
+b(T)-8 b(emplates)n(:)227 4276 y Fi(The)32 b(templates)f(used)h(to)f
+(matc)n(h)g(FITS)h(k)n(eyw)n(ords)d(are)i(normally)f(comp)r(osed)h(of)h
+(literal)e(c)n(haracters,)h(whic)n(h)227 4376 y(m)n(ust)f(matc)n(h)g
+(the)h(k)n(eyw)n(ord)d(exactly)h(\(apart)h(from)f(case\).)44
+b(Ho)n(w)n(ev)n(er,)29 b(a)h(template)g(ma)n(y)f(also)g(con)n(tain)h
+Ft(")p Fi(\014eld)227 4475 y(sp)r(eci\014ers)p Ft(")25
+b Fi(whic)n(h)h(can)g(matc)n(h)f(a)h(range)f(of)h(p)r(ossible)f(c)n
+(haracters.)34 b(This)26 b(allo)n(ws)f(y)n(ou)g(to)h(searc)n(h)e(for)i
+(k)n(eyw)n(ords)227 4575 y(that)36 b(con)n(tain)f(\(for)g(example\))g
+(n)n(um)n(b)r(ers,)i(where)e(the)h(digits)f(comprising)f(the)i(n)n(um)n
+(b)r(er)f(are)f(not)i(kno)n(wn)e(in)227 4674 y(adv)-5
+b(ance.)227 4805 y(A)30 b(\014eld)g(sp)r(eci\014er)g(starts)f(with)h(a)
+f Ft(")p Fi(\045)p Ft(")h Fi(c)n(haracter.)41 b(This)30
b(is)f(follo)n(w)n(ed)g(b)n(y)h(an)f(optional)g(single)h(digit)f(\(0)h
-(to)g(9\))227 2371 y(sp)r(ecifying)e(a)f(\014eld)h(width.)37
+(to)g(9\))227 4905 y(sp)r(ecifying)e(a)f(\014eld)h(width.)37
b(Finally)-7 b(,)28 b(there)f(is)h(a)f(single)g(c)n(haracter)f(whic)n
-(h)h(sp)r(eci\014es)h(the)227 2516 y(t)n(yp)r(e)g(of)g(c)n(haracter)d
-(to)j(b)r(e)g(matc)n(hed,)f(as)g(follo)n(ws:)340 2838
+(h)h(sp)r(eci\014es)h(the)227 5036 y(t)n(yp)r(e)g(of)g(c)n(haracter)d
+(to)j(b)r(e)g(matc)n(hed,)f(as)g(follo)n(ws:)340 5315
y Fh(\017)45 b Ft(")p Fi(c)p Ft(")p Fi(:)36 b(matc)n(hes)27
-b(all)h(upp)r(er)f(case)g(letters,)340 2991 y Fh(\017)45
+b(all)h(upp)r(er)f(case)g(letters,)340 5454 y Fh(\017)45
b Ft(")p Fi(d)p Ft(")p Fi(:)37 b(matc)n(hes)27 b(all)g(decimal)g
-(digits,)340 3144 y Fh(\017)45 b Ft(")p Fi(f)p Ft(")p
+(digits,)340 5593 y Fh(\017)45 b Ft(")p Fi(f)p Ft(")p
Fi(:)39 b(matc)n(hes)29 b(all)f(c)n(haracters)f(whic)n(h)i(are)f(p)r
(ermitted)h(within)h(a)e(FITS)h(k)n(eyw)n(ord)e(\(upp)r(er)j(case)e
-(letters,)427 3244 y(digits,)g(underscores)e(and)h(h)n(yphens\).)227
-3446 y(If)j(the)f(\014eld)g(width)h(is)f(omitted,)h(the)f(\014eld)h(sp)
-r(eci\014er)e(matc)n(hes)h(one)g(or)f(more)g(c)n(haracters.)39
-b(If)29 b(the)h(\014eld)f(width)227 3546 y(is)f(zero,)e(it)i(matc)n
-(hes)f(zero)g(or)g(more)f(c)n(haracters.)35 b(Otherwise,)27
+(letters,)427 5693 y(digits,)g(underscores)e(and)h(h)n(yphens\).)p
+eop end
+%%Page: 229 239
+TeXDict begin 229 238 bop 3643 52 a FF(229)227 351 y
+Fi(If)30 b(the)f(\014eld)g(width)h(is)f(omitted,)h(the)f(\014eld)h(sp)r
+(eci\014er)e(matc)n(hes)h(one)g(or)f(more)g(c)n(haracters.)39
+b(If)29 b(the)h(\014eld)f(width)227 451 y(is)f(zero,)e(it)i(matc)n(hes)
+f(zero)g(or)g(more)f(c)n(haracters.)35 b(Otherwise,)27
b(it)h(matc)n(hes)f(exactly)g(the)h(n)n(um)n(b)r(er)f(of)227
-3691 y(c)n(haracters)f(sp)r(eci\014ed.)37 b(In)27 b(addition)h(to)f
-(this:)340 4013 y Fh(\017)45 b Fi(The)c(template)g Ft(")p
+574 y(c)n(haracters)f(sp)r(eci\014ed.)37 b(In)27 b(addition)h(to)f
+(this:)340 831 y Fh(\017)45 b Fi(The)c(template)g Ft(")p
Fi(\045f)p Ft(")f Fi(will)h(matc)n(h)g(a)f(blank)g(FITS)h(k)n(eyw)n
(ord)e(consisting)h(of)h(8)f(spaces)g(\(as)g(w)n(ell)g(as)427
-4112 y(matc)n(hing)27 b(all)h(other)f(k)n(eyw)n(ords\).)340
-4266 y Fh(\017)45 b Fi(A)28 b(template)g(consisting)f(of)g(8)h(spaces)e
+930 y(matc)n(hing)27 b(all)h(other)f(k)n(eyw)n(ords\).)340
+1061 y Fh(\017)45 b Fi(A)28 b(template)g(consisting)f(of)g(8)h(spaces)e
(will)i(matc)n(h)f(a)h(blank)f(k)n(eyw)n(ord)f(\(only\).)227
-4468 y(F)-7 b(or)27 b(example:)340 4790 y Fh(\017)45
+1220 y(F)-7 b(or)27 b(example:)340 1476 y Fh(\017)45
b Fi(The)28 b(template)g Ft(")p Fi(BitPix)p Ft(")e Fi(will)i(matc)n(h)f
(the)h(k)n(eyw)n(ord)e Ft(")p Fi(BITPIX)p Ft(")g Fi(only)-7
-b(.)340 4943 y Fh(\017)45 b Fi(The)27 b(template)g Ft(")p
+b(.)340 1606 y Fh(\017)45 b Fi(The)27 b(template)g Ft(")p
Fi(crpix\0451d)p Ft(")f Fi(will)h(matc)n(h)f(k)n(eyw)n(ords)f
(consisting)h(of)h Ft(")p Fi(CRPIX)p Ft(")f Fi(follo)n(w)n(ed)g(b)n(y)g
-(one)h(deci-)427 5043 y(mal)h(digit.)340 5196 y Fh(\017)45
+(one)h(deci-)427 1706 y(mal)h(digit.)340 1836 y Fh(\017)45
b Fi(The)26 b(template)f Ft(")p Fi(P\045c)p Ft(")f Fi(will)i(matc)n(h)e
(an)n(y)h(k)n(eyw)n(ord)e(starting)i(with)g Ft(")p Fi(P)p
Ft(")f Fi(and)h(follo)n(w)n(ed)f(b)n(y)h(one)g(or)f(more)427
-5296 y(letters.)340 5449 y Fh(\017)45 b Fi(The)28 b(template)g
+1936 y(letters.)340 2066 y Fh(\017)45 b Fi(The)28 b(template)g
Ft(")p Fi(E\0450f)p Ft(")e Fi(will)i(matc)n(h)f(an)n(y)g(k)n(eyw)n(ord)
f(b)r(eginning)i(with)g Ft(")p Fi(E)p Ft(")p Fi(.)340
-5602 y Fh(\017)45 b Fi(The)28 b(template)g Ft(")p Fi(\045f)p
+2196 y Fh(\017)45 b Fi(The)28 b(template)g Ft(")p Fi(\045f)p
Ft(")f Fi(will)h(matc)n(h)f(an)n(y)g(k)n(eyw)n(ord)f(at)h(all)h
-(\(including)g(a)f(blank)g(one\).)p eop end
-%%Page: 229 239
-TeXDict begin 229 238 bop 3643 52 a FF(229)p 0 351 3780
-12 v 0 483 a Fz(astFindF)-11 b(rame)297 b Fe(Find)39
-b(a)g(co)s(ordinate)d(system)j(with)1290 598 y(sp)s(eci\014ed)h(c)m
-(haracteristics)2970 483 y Fz(astFindF)-11 b(rame)0 795
-y Fd(Description:)44 b Fi(This)24 b(function)h(uses)e(a)h
-Ft(")p Fi(template)p Ft(")g Fi(F)-7 b(rame)23 b(to)h(searc)n(h)e
-(another)h(F)-7 b(rame)24 b(\(or)f(F)-7 b(rameSet\))24
-b(to)g(iden)n(tify)227 895 y(a)33 b(co)r(ordinate)f(system)i(whic)n(h)f
-(has)g(a)g(sp)r(eci\014ed)g(set)h(of)f(c)n(haracteristics.)52
-b(If)33 b(a)g(suitable)h(co)r(ordinate)e(system)227 994
-y(can)23 b(b)r(e)h(found,)h(the)f(function)g(returns)e(a)i(p)r(oin)n
-(ter)f(to)g(a)g(F)-7 b(rameSet)23 b(whic)n(h)h(describ)r(es)e(the)i
-(required)f(co)r(ordinate)227 1094 y(system)28 b(and)f(ho)n(w)g(to)g
-(con)n(v)n(ert)g(co)r(ordinates)f(to)h(and)h(from)f(it.)227
-1221 y(This)41 b(function)f(is)h(pro)n(vided)e(to)h(help)h(answ)n(er)d
-(general)h(questions)h(ab)r(out)g(co)r(ordinate)f(systems,)k(suc)n(h)d
-(as)227 1320 y(t)n(ypically)f(arise)f(when)h(co)r(ordinate)f
-(information)h(is)g(imp)r(orted)g(in)n(to)g(a)f(program)f(as)i(part)g
-(of)g(an)f(initially)227 1420 y(unkno)n(wn)27 b(dataset.)37
-b(F)-7 b(or)27 b(example:)340 1560 y Fh(\017)45 b Fi(Is)28
-b(there)f(a)g(w)n(a)n(v)n(elength)f(scale?)340 1695 y
-Fh(\017)45 b Fi(Is)28 b(there)f(a)g(2-dimensional)g(co)r(ordinate)f
-(system?)340 1830 y Fh(\017)45 b Fi(Is)28 b(there)f(a)g(celestial)g(co)
-r(ordinate)g(system?)340 1965 y Fh(\017)45 b Fi(Can)28
-b(I)f(plot)h(the)g(data)f(in)h(ecliptic)g(co)r(ordinates?)227
-2131 y(Y)-7 b(ou)30 b(can)g(also)f(use)g(this)i(function)f(as)f(a)h
-(means)f(of)h(reconciling)f(a)g(user's)g(preference)h(for)f(a)h
-(particular)e(co)r(or-)227 2231 y(dinate)k(system)f(\(for)h(example,)g
-(what)f(t)n(yp)r(e)h(of)g(axes)e(to)i(dra)n(w\))e(with)i(what)g(is)f
-(actually)g(p)r(ossible)g(giv)n(en)g(the)227 2330 y(co)r(ordinate)c
-(information)g(a)n(v)-5 b(ailable.)227 2457 y(T)e(o)40
-b(p)r(erform)f(a)h(searc)n(h,)h(y)n(ou)f(supply)g(a)f
-Ft(")p Fi(target)p Ft(")f Fi(F)-7 b(rame)40 b(\(or)f(F)-7
-b(rameSet\))40 b(whic)n(h)g(represen)n(ts)e(the)j(set)f(of)227
-2557 y(co)r(ordinate)30 b(systems)g(to)g(b)r(e)i(searc)n(hed.)44
-b(If)31 b(a)f(basic)g(F)-7 b(rame)31 b(is)f(giv)n(en)g(as)g(the)h
-(target,)g(this)g(set)f(of)h(co)r(ordinate)227 2656 y(systems)h
+(\(including)g(a)f(blank)g(one\).)p 0 2390 3780 12 v
+0 2521 a Fz(astFindF)-11 b(rame)297 b Fe(Find)39 b(a)g(co)s(ordinate)d
+(system)j(with)1290 2636 y(sp)s(eci\014ed)h(c)m(haracteristics)2970
+2521 y Fz(astFindF)-11 b(rame)0 2824 y Fd(Description:)44
+b Fi(This)24 b(function)h(uses)e(a)h Ft(")p Fi(template)p
+Ft(")g Fi(F)-7 b(rame)23 b(to)h(searc)n(h)e(another)h(F)-7
+b(rame)24 b(\(or)f(F)-7 b(rameSet\))24 b(to)g(iden)n(tify)227
+2923 y(a)33 b(co)r(ordinate)f(system)i(whic)n(h)f(has)g(a)g(sp)r
+(eci\014ed)g(set)h(of)f(c)n(haracteristics.)52 b(If)33
+b(a)g(suitable)h(co)r(ordinate)e(system)227 3023 y(can)23
+b(b)r(e)h(found,)h(the)f(function)g(returns)e(a)i(p)r(oin)n(ter)f(to)g
+(a)g(F)-7 b(rameSet)23 b(whic)n(h)h(describ)r(es)e(the)i(required)f(co)
+r(ordinate)227 3123 y(system)28 b(and)f(ho)n(w)g(to)g(con)n(v)n(ert)g
+(co)r(ordinates)f(to)h(and)h(from)f(it.)227 3246 y(This)41
+b(function)f(is)h(pro)n(vided)e(to)h(help)h(answ)n(er)d(general)h
+(questions)h(ab)r(out)g(co)r(ordinate)f(systems,)k(suc)n(h)d(as)227
+3345 y(t)n(ypically)f(arise)f(when)h(co)r(ordinate)f(information)h(is)g
+(imp)r(orted)g(in)n(to)g(a)f(program)f(as)i(part)g(of)g(an)f(initially)
+227 3445 y(unkno)n(wn)27 b(dataset.)37 b(F)-7 b(or)27
+b(example:)340 3579 y Fh(\017)45 b Fi(Is)28 b(there)f(a)g(w)n(a)n(v)n
+(elength)f(scale?)340 3709 y Fh(\017)45 b Fi(Is)28 b(there)f(a)g
+(2-dimensional)g(co)r(ordinate)f(system?)340 3839 y Fh(\017)45
+b Fi(Is)28 b(there)f(a)g(celestial)g(co)r(ordinate)g(system?)340
+3969 y Fh(\017)45 b Fi(Can)28 b(I)f(plot)h(the)g(data)f(in)h(ecliptic)g
+(co)r(ordinates?)227 4128 y(Y)-7 b(ou)30 b(can)g(also)f(use)g(this)i
+(function)f(as)f(a)h(means)f(of)h(reconciling)f(a)g(user's)g
+(preference)h(for)f(a)h(particular)e(co)r(or-)227 4228
+y(dinate)k(system)f(\(for)h(example,)g(what)f(t)n(yp)r(e)h(of)g(axes)e
+(to)i(dra)n(w\))e(with)i(what)g(is)f(actually)g(p)r(ossible)g(giv)n(en)
+g(the)227 4327 y(co)r(ordinate)c(information)g(a)n(v)-5
+b(ailable.)227 4450 y(T)e(o)40 b(p)r(erform)f(a)h(searc)n(h,)h(y)n(ou)f
+(supply)g(a)f Ft(")p Fi(target)p Ft(")f Fi(F)-7 b(rame)40
+b(\(or)f(F)-7 b(rameSet\))40 b(whic)n(h)g(represen)n(ts)e(the)j(set)f
+(of)227 4550 y(co)r(ordinate)30 b(systems)g(to)g(b)r(e)i(searc)n(hed.)
+44 b(If)31 b(a)f(basic)g(F)-7 b(rame)31 b(is)f(giv)n(en)g(as)g(the)h
+(target,)g(this)g(set)f(of)h(co)r(ordinate)227 4650 y(systems)h
(consists)g(of)h(the)g(one)f(describ)r(ed)h(b)n(y)f(this)h(F)-7
b(rame,)33 b(plus)g(all)f(other)g Ft(")p Fi(virtual)p
-Ft(")g Fi(co)r(ordinate)f(systems)227 2756 y(whic)n(h)c(can)g(p)r(oten)
+Ft(")g Fi(co)r(ordinate)f(systems)227 4749 y(whic)n(h)c(can)g(p)r(oten)
n(tially)f(b)r(e)i(reac)n(hed)d(from)i(it)g(b)n(y)g(applying)f
(built-in)i(con)n(v)n(ersions)c(\(for)j(example,)f(an)n(y)g(of)h(the)
-227 2855 y(celestial)19 b(co)r(ordinate)g(con)n(v)n(ersions)e(kno)n(wn)
+227 4849 y(celestial)19 b(co)r(ordinate)g(con)n(v)n(ersions)e(kno)n(wn)
i(to)h(the)g(AST)g(library)e(w)n(ould)i(constitute)g(a)f
Ft(")p Fi(built-in)p Ft(")h Fi(con)n(v)n(ersion\).)227
-2955 y(If)32 b(a)f(F)-7 b(rameSet)31 b(is)g(giv)n(en)g(as)f(the)i
+4949 y(If)32 b(a)f(F)-7 b(rameSet)31 b(is)g(giv)n(en)g(as)f(the)i
(target,)f(the)h(set)f(of)h(co)r(ordinate)e(systems)h(to)g(b)r(e)h
-(searc)n(hed)d(consists)i(of)g(the)227 3055 y(union)d(of)f(those)h
+(searc)n(hed)d(consists)i(of)g(the)227 5048 y(union)d(of)f(those)h
(represen)n(ted)e(b)n(y)h(all)h(the)g(individual)f(F)-7
-b(rames)27 b(within)i(it.)227 3181 y(T)-7 b(o)26 b(select)g(from)f
+b(rames)27 b(within)i(it.)227 5171 y(T)-7 b(o)26 b(select)g(from)f
(this)i(large)d(set)i(of)g(p)r(ossible)g(co)r(ordinate)f(systems,)h(y)n
(ou)f(supply)h(a)g Ft(")p Fi(template)p Ft(")f Fi(F)-7
-b(rame)26 b(whic)n(h)227 3281 y(is)k(an)g(instance)g(of)h(the)f(t)n(yp)
+b(rame)26 b(whic)n(h)227 5271 y(is)k(an)g(instance)g(of)h(the)f(t)n(yp)
r(e)h(of)f(F)-7 b(rame)30 b(y)n(ou)f(are)g(lo)r(oking)h(for.)44
b(E\013ectiv)n(ely)-7 b(,)31 b(y)n(ou)e(then)i(ask)e(the)i(function)g
-(to)227 3381 y Ft(")p Fi(\014nd)d(a)f(co)r(ordinate)g(system)g(that)h
-(lo)r(oks)e(lik)n(e)i(this)p Ft(")p Fi(.)227 3507 y(Y)-7
+(to)227 5371 y Ft(")p Fi(\014nd)d(a)f(co)r(ordinate)g(system)g(that)h
+(lo)r(oks)e(lik)n(e)i(this)p Ft(")p Fi(.)227 5494 y(Y)-7
b(ou)24 b(can)e(mak)n(e)h(y)n(our)f(request)h(more)f(or)g(less)h(sp)r
(eci\014c)h(b)n(y)f(setting)g(attribute)g(v)-5 b(alues)23
-b(for)g(the)g(template)h(F)-7 b(rame.)227 3607 y(If)28
+b(for)g(the)g(template)h(F)-7 b(rame.)227 5593 y(If)28
b(a)f(particular)e(attribute)j(is)f(set)g(in)g(the)h(template,)g(then)f
(the)h(function)f(will)h(only)f(\014nd)g(co)r(ordinate)f(systems)227
-3706 y(whic)n(h)35 b(ha)n(v)n(e)f(exactly)g(the)i(same)e(v)-5
+5693 y(whic)n(h)35 b(ha)n(v)n(e)f(exactly)g(the)i(same)e(v)-5
b(alue)35 b(for)g(that)g(attribute.)59 b(If)36 b(y)n(ou)e(lea)n(v)n(e)g
-(a)g(template)h(attribute)h(un-set,)227 3806 y(ho)n(w)n(ev)n(er,)30
-b(then)h(the)g(function)g(has)f(discretion)g(ab)r(out)h(the)g(v)-5
+(a)g(template)h(attribute)h(un-set,)p eop end
+%%Page: 230 240
+TeXDict begin 230 239 bop 0 52 a FF(230)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)227 351 y Fi(ho)n(w)n(ev)n(er,)g
+(then)h(the)g(function)g(has)f(discretion)g(ab)r(out)h(the)g(v)-5
b(alue)30 b(the)i(attribute)e(should)h(ha)n(v)n(e)e(in)i(an)n(y)f(co)r
-(or-)227 3906 y(dinate)h(system)e(it)i(\014nds.)45 b(The)30
+(or-)227 451 y(dinate)h(system)e(it)i(\014nds.)45 b(The)30
b(attribute)g(will)h(then)f(tak)n(e)g(its)g(v)-5 b(alue)30
b(from)g(one)g(of)g(the)g(actual)g(\(rather)f(than)227
-4005 y(virtual\))d(co)r(ordinate)f(systems)h(in)h(the)f(target.)36
+551 y(virtual\))d(co)r(ordinate)f(systems)h(in)h(the)f(target.)36
b(If)26 b(the)h(target)e(is)h(a)g(F)-7 b(rameSet,)27
-b(its)f(Curren)n(t)f(attribute)i(will)f(b)r(e)227 4105
+b(its)f(Curren)n(t)f(attribute)i(will)f(b)r(e)227 650
y(mo)r(di\014ed)i(to)g(indicate)f(whic)n(h)h(of)f(its)h(F)-7
b(rames)27 b(w)n(as)g(used)g(for)g(this)h(purp)r(ose.)227
-4231 y(The)34 b(result)g(of)f(this)h(pro)r(cess)f(is)h(a)f(co)r
+781 y(The)34 b(result)g(of)f(this)h(pro)r(cess)f(is)h(a)f(co)r
(ordinate)g(system)g(represen)n(ted)g(b)n(y)g(a)h(h)n(ybrid)f(F)-7
-b(rame)33 b(whic)n(h)h(acquires)227 4331 y(some)28 b(attributes)h(from)
-f(the)h(template)g(\(but)h(only)e(if)h(they)g(w)n(ere)e(set\))i(and)g
-(the)g(remainder)e(from)h(the)h(target.)227 4431 y(This)34
+b(rame)33 b(whic)n(h)h(acquires)227 881 y(some)28 b(attributes)h(from)f
+(the)h(template)g(\(but)h(only)e(if)h(they)g(w)n(ere)e(set\))i(and)g
+(the)g(remainder)e(from)h(the)h(target.)227 980 y(This)34
b(represen)n(ts)f(the)h Ft(")p Fi(b)r(est)g(compromise)p
Ft(")f Fi(b)r(et)n(w)n(een)h(what)g(y)n(ou)f(ask)n(ed)g(for)g(and)h
-(what)g(w)n(as)f(a)n(v)-5 b(ailable.)55 b(A)227 4530
+(what)g(w)n(as)f(a)n(v)-5 b(ailable.)55 b(A)227 1080
y(Mapping)31 b(is)g(then)g(generated)f(whic)n(h)h(con)n(v)n(erts)e
(from)i(the)g(target)g(co)r(ordinate)e(system)i(to)g(this)g(h)n(ybrid)g
-(one,)227 4630 y(and)d(the)g(returned)f(F)-7 b(rameSet)27
-b(encapsulates)g(all)g(of)h(this)g(information.)0 4784
+(one,)227 1179 y(and)d(the)g(returned)f(F)-7 b(rameSet)27
+b(encapsulates)g(all)g(of)h(this)g(information.)0 1341
y Fd(Synopsis:)121 b Ft(AstFrameSet)39 b Fh(\003)p Ft(astFindFrame\()f
(AstFrame)i Fh(\003)p Ft(target,)g(AstFrame)g Fh(\003)p
Ft(template,)g(const)h(char)h Fh(\003)p Ft(domainlist)227
-4883 y(\))0 5037 y Fd(P)m(arameters:)259 5177 y(target)427
-5277 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(target)e(F)-7
-b(rame)27 b(\(or)g(F)-7 b(rameSet\).)427 5394 y(Note)37
+1441 y(\))0 1603 y Fd(P)m(arameters:)259 1752 y(target)427
+1851 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(target)e(F)-7
+b(rame)27 b(\(or)g(F)-7 b(rameSet\).)427 1971 y(Note)37
b(that)g(if)g(a)g(F)-7 b(rameSet)36 b(is)h(supplied)g(\(and)g(a)f
(suitable)h(co)r(ordinate)e(system)i(is)f(found\),)k(then)d(its)427
-5494 y(Curren)n(t)h(attribute)h(will)f(b)r(e)h(mo)r(di\014ed)g(to)f
+2070 y(Curren)n(t)h(attribute)h(will)f(b)r(e)h(mo)r(di\014ed)g(to)f
(indicate)h(whic)n(h)f(F)-7 b(rame)38 b(w)n(as)g(used)g(to)g(obtain)g
-(attribute)427 5593 y(v)-5 b(alues)31 b(whic)n(h)g(w)n(ere)g(not)g(sp)r
+(attribute)427 2170 y(v)-5 b(alues)31 b(whic)n(h)g(w)n(ere)g(not)g(sp)r
(eci\014ed)h(b)n(y)e(the)i(template.)48 b(This)32 b(F)-7
b(rame)30 b(will,)j(in)e(some)g(sense,)h(represen)n(t)427
-5693 y(the)c Ft(")p Fi(closest)p Ft(")e Fi(non-virtual)h(co)r(ordinate)
-f(system)i(to)f(the)h(one)f(y)n(ou)g(requested.)p eop
-end
-%%Page: 230 240
-TeXDict begin 230 239 bop 0 52 a FF(230)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(template)427
-451 y Fi(P)n(oin)n(ter)f(to)h(the)h(template)g(F)-7 b(rame,)31
-b(whic)n(h)f(should)g(b)r(e)h(an)f(instance)h(of)f(the)h(t)n(yp)r(e)g
-(of)f(F)-7 b(rame)30 b(y)n(ou)g(wish)427 551 y(to)e(\014nd.)38
-b(If)28 b(y)n(ou)f(w)n(an)n(ted)h(to)f(\014nd)i(a)e(F)-7
-b(rame)27 b(describing)g(a)h(celestial)f(co)r(ordinate)g(system,)h(for)
-f(example,)427 650 y(then)h(y)n(ou)f(migh)n(t)h(use)f(a)g(SkyF)-7
-b(rame)27 b(here.)37 b(See)27 b(the)h Ft(")p Fi(Examples)p
-Ft(")e Fi(section)h(for)g(more)g(ideas.)259 778 y Fd(domainlist)427
-877 y Fi(P)n(oin)n(ter)36 b(to)i(a)f(n)n(ull-terminated)g(c)n(haracter)
-e(string)i(con)n(taining)g(a)g(comma-separated)e(list)j(of)f(F)-7
-b(rame)427 977 y(domains.)36 b(This)28 b(ma)n(y)e(b)r(e)i(used)g(to)f
-(establish)g(a)g(priorit)n(y)f(order)g(for)h(the)h(di\013eren)n(t)f(t)n
-(yp)r(es)g(of)h(co)r(ordinate)427 1077 y(system)g(that)g(migh)n(t)f(b)r
-(e)h(found.)427 1190 y(The)23 b(function)g(will)g(\014rst)f(try)g(to)h
-(\014nd)g(a)f(suitable)h(co)r(ordinate)e(system)h(whose)g(Domain)h
-(attribute)f(equals)427 1290 y(the)31 b(\014rst)g(domain)f(in)h(this)g
+2270 y(the)c Ft(")p Fi(closest)p Ft(")e Fi(non-virtual)h(co)r(ordinate)
+f(system)i(to)f(the)h(one)f(y)n(ou)g(requested.)259 2409
+y Fd(template)427 2508 y Fi(P)n(oin)n(ter)i(to)h(the)h(template)g(F)-7
+b(rame,)31 b(whic)n(h)f(should)g(b)r(e)h(an)f(instance)h(of)f(the)h(t)n
+(yp)r(e)g(of)f(F)-7 b(rame)30 b(y)n(ou)g(wish)427 2608
+y(to)e(\014nd.)38 b(If)28 b(y)n(ou)f(w)n(an)n(ted)h(to)f(\014nd)i(a)e
+(F)-7 b(rame)27 b(describing)g(a)h(celestial)f(co)r(ordinate)g(system,)
+h(for)f(example,)427 2707 y(then)h(y)n(ou)f(migh)n(t)h(use)f(a)g(SkyF)
+-7 b(rame)27 b(here.)37 b(See)27 b(the)h Ft(")p Fi(Examples)p
+Ft(")e Fi(section)h(for)g(more)g(ideas.)259 2847 y Fd(domainlist)427
+2946 y Fi(P)n(oin)n(ter)36 b(to)i(a)f(n)n(ull-terminated)g(c)n
+(haracter)e(string)i(con)n(taining)g(a)g(comma-separated)e(list)j(of)f
+(F)-7 b(rame)427 3046 y(domains.)36 b(This)28 b(ma)n(y)e(b)r(e)i(used)g
+(to)f(establish)g(a)g(priorit)n(y)f(order)g(for)h(the)h(di\013eren)n(t)
+f(t)n(yp)r(es)g(of)h(co)r(ordinate)427 3145 y(system)g(that)g(migh)n(t)
+f(b)r(e)h(found.)427 3265 y(The)23 b(function)g(will)g(\014rst)f(try)g
+(to)h(\014nd)g(a)f(suitable)h(co)r(ordinate)e(system)h(whose)g(Domain)h
+(attribute)f(equals)427 3364 y(the)31 b(\014rst)g(domain)f(in)h(this)g
(list.)47 b(If)31 b(this)g(fails,)h(the)f(second)f(domain)h(in)g(the)g
-(list)g(will)g(b)r(e)g(used,)h(and)e(so)427 1389 y(on,)e(un)n(til)h(a)e
+(list)g(will)g(b)r(e)g(used,)h(and)e(so)427 3464 y(on,)e(un)n(til)h(a)e
(result)h(is)g(obtained.)38 b(A)28 b(blank)g(domain)g(\(e.g.)38
b(t)n(w)n(o)27 b(consecutiv)n(e)g(commas\))g(indicates)h(that)427
-1489 y(an)n(y)f(co)r(ordinate)g(system)g(is)g(acceptable)g(\(sub)5
+3564 y(an)n(y)f(co)r(ordinate)g(system)g(is)g(acceptable)g(\(sub)5
b(ject)28 b(to)g(the)g(template\))g(regardless)d(of)j(its)f(domain.)427
-1603 y(This)i(list)h(is)f(case-insensitiv)n(e)f(and)h(all)g(white)g
+3683 y(This)i(list)h(is)f(case-insensitiv)n(e)f(and)h(all)g(white)g
(space)g(is)g(ignored.)40 b(If)30 b(y)n(ou)e(do)h(not)g(wish)h(to)f
-(restrict)f(the)427 1702 y(domain)f(in)h(this)g(w)n(a)n(y)-7
+(restrict)f(the)427 3783 y(domain)f(in)h(this)g(w)n(a)n(y)-7
b(,)27 b(y)n(ou)g(should)g(supply)h(an)f(empt)n(y)h(string.)0
-1859 y Fd(Class)j(Applicabilit)m(y:)259 1990 y(F)-8 b(rame)427
-2089 y Fi(This)28 b(function)g(applies)f(to)h(all)f(F)-7
-b(rames.)259 2217 y Fd(F)f(rameSet)427 2317 y Fi(If)31
+3957 y Fd(Class)j(Applicabilit)m(y:)259 4106 y(F)-8 b(rame)427
+4205 y Fi(This)28 b(function)g(applies)f(to)h(all)f(F)-7
+b(rames.)259 4344 y Fd(F)f(rameSet)427 4444 y Fi(If)31
b(the)f(target)f(is)h(a)g(F)-7 b(rameSet,)30 b(the)g(p)r(ossibilit)n(y)
g(exists)g(that)g(sev)n(eral)e(of)i(the)g(F)-7 b(rames)30
-b(within)g(it)h(migh)n(t)427 2416 y(b)r(e)f(matc)n(hed)f(b)n(y)g(the)g
+b(within)g(it)h(migh)n(t)427 4544 y(b)r(e)f(matc)n(hed)f(b)n(y)g(the)g
(template.)42 b(Unless)29 b(the)h(c)n(hoice)e(is)i(su\016cien)n(tly)f
(restricted)f(b)n(y)h(the)h Ft(")p Fi(domainlist)p Ft(")427
-2516 y Fi(string,)e(the)h(sequence)e(in)i(whic)n(h)f(F)-7
+4643 y Fi(string,)e(the)h(sequence)e(in)i(whic)n(h)f(F)-7
b(rames)27 b(are)h(searc)n(hed)e(can)i(then)h(b)r(ecome)f(imp)r(ortan)n
-(t.)38 b(In)29 b(this)f(case,)427 2615 y(the)g(searc)n(h)e(pro)r(ceeds)
-h(as)g(follo)n(ws:)510 2717 y Fh(\017)45 b Fi(Eac)n(h)27
+(t.)38 b(In)29 b(this)f(case,)427 4743 y(the)g(searc)n(h)e(pro)r(ceeds)
+h(as)g(follo)n(ws:)510 4857 y Fh(\017)45 b Fi(Eac)n(h)27
b(\014eld)h(in)f(the)h Ft(")p Fi(domainlist)p Ft(")f
-Fi(string)g(is)g(considered)g(in)h(turn.)510 2831 y Fh(\017)45
+Fi(string)g(is)g(considered)g(in)h(turn.)510 4976 y Fh(\017)45
b Fi(An)29 b(attempt)g(is)g(made)f(to)h(matc)n(h)f(the)h(template)g(to)
f(eac)n(h)g(of)g(the)h(target's)e(F)-7 b(rames)28 b(in)h(the)g(order:)
-597 2931 y(\(1\))35 b(the)g(curren)n(t)f(F)-7 b(rame,)36
+597 5076 y(\(1\))35 b(the)g(curren)n(t)f(F)-7 b(rame,)36
b(\(2\))f(the)h(base)e(F)-7 b(rame,)36 b(\(3\))f(eac)n(h)f(remaining)g
-(F)-7 b(rame)34 b(in)h(the)g(order)f(of)597 3030 y(b)r(eing)28
-b(added)f(to)h(the)g(target)f(F)-7 b(rameSet.)510 3144
+(F)-7 b(rame)34 b(in)h(the)g(order)f(of)597 5175 y(b)r(eing)28
+b(added)f(to)h(the)g(target)f(F)-7 b(rameSet.)510 5295
y Fh(\017)45 b Fi(Generally)-7 b(,)41 b(the)d(\014rst)g(matc)n(h)h
(found)f(is)g(used.)70 b(Ho)n(w)n(ev)n(er,)39 b(the)f(Mapping)g(b)r(et)
-n(w)n(een)h(the)g(target)597 3243 y(co)r(ordinate)23
+n(w)n(een)h(the)g(target)597 5394 y(co)r(ordinate)23
b(system)h(and)g(the)g(resulting)g(F)-7 b(rame)23 b(is)h(also)f
(examined.)35 b(Preference)23 b(is)h(giv)n(en)f(to)h(cases)597
-3343 y(where)37 b(b)r(oth)g(the)h(forw)n(ard)d(and)i(in)n(v)n(erse)f
+5494 y(where)37 b(b)r(oth)g(the)h(forw)n(ard)d(and)i(in)n(v)n(erse)f
(transformations)f(are)h(de\014ned)h(\(as)g(indicated)g(b)n(y)g(the)597
-3443 y(T)-7 b(ranF)g(orw)n(ard)36 b(and)h(T)-7 b(ranIn)n(v)n(erse)36
+5593 y(T)-7 b(ranF)g(orw)n(ard)36 b(and)h(T)-7 b(ranIn)n(v)n(erse)36
b(attributes\).)68 b(If)38 b(only)g(one)f(transformation)g(is)g
-(de\014ned,)k(the)597 3542 y(forw)n(ard)26 b(one)h(is)h(preferred.)510
-3656 y Fh(\017)45 b Fi(If)37 b(a)g(matc)n(h)f(is)h(found)g(and)f(the)h
-(domain)g(of)f(the)h(resulting)g(F)-7 b(rame)36 b(also)f(matc)n(hes)h
-(the)h(curren)n(t)597 3756 y Ft(")p Fi(domainlist)p Ft(")32
+(de\014ned,)k(the)597 5693 y(forw)n(ard)26 b(one)h(is)h(preferred.)p
+eop end
+%%Page: 231 241
+TeXDict begin 231 240 bop 3643 52 a FF(231)510 351 y
+Fh(\017)45 b Fi(If)37 b(a)g(matc)n(h)f(is)h(found)g(and)f(the)h(domain)
+g(of)f(the)h(resulting)g(F)-7 b(rame)36 b(also)f(matc)n(hes)h(the)h
+(curren)n(t)597 451 y Ft(")p Fi(domainlist)p Ft(")32
b Fi(\014eld,)h(it)g(is)f(accepted.)51 b(Otherwise,)33
b(the)g(next)f Ft(")p Fi(domainlist)p Ft(")g Fi(\014eld)g(is)h
-(considered)597 3855 y(and)28 b(the)g(pro)r(cess)e(rep)r(eated.)427
-3983 y(If)g(a)f(suitable)g(co)r(ordinate)f(system)i(is)f(found,)h(the)g
+(considered)597 551 y(and)28 b(the)g(pro)r(cess)e(rep)r(eated.)427
+677 y(If)g(a)f(suitable)g(co)r(ordinate)f(system)i(is)f(found,)h(the)g
(Curren)n(t)e(attribute)i(of)f(the)h(target)e(F)-7 b(rameSet)26
-b(will)f(b)r(e)427 4082 y(mo)r(di\014ed)e(on)g(exit)g(to)f(iden)n(tify)
-h(the)g(F)-7 b(rame)23 b(whose)f(matc)n(h)g(with)h(the)g(target)f(w)n
-(as)g(ev)n(en)n(tually)g(accepted.)0 4239 y Fd(Returned)32
-b(V)-8 b(alue:)259 4370 y(astFindF)g(rame\(\))427 4470
+b(will)f(b)r(e)427 777 y(mo)r(di\014ed)e(on)g(exit)g(to)f(iden)n(tify)h
+(the)g(F)-7 b(rame)23 b(whose)f(matc)n(h)g(with)h(the)g(target)f(w)n
+(as)g(ev)n(en)n(tually)g(accepted.)0 932 y Fd(Returned)32
+b(V)-8 b(alue:)259 1062 y(astFindF)g(rame\(\))427 1162
y Fi(If)32 b(the)g(searc)n(h)e(is)i(successful,)g(the)g(function)g
(returns)f(a)g(p)r(oin)n(ter)g(to)h(a)f(F)-7 b(rameSet)31
-b(whic)n(h)h(con)n(tains)e(the)427 4569 y(F)-7 b(rame)37
+b(whic)n(h)h(con)n(tains)e(the)427 1261 y(F)-7 b(rame)37
b(found)g(and)g(a)f(description)h(of)g(ho)n(w)f(to)h(con)n(v)n(ert)e
(to)i(\(and)g(from\))g(the)h(co)r(ordinate)d(system)i(it)427
-4669 y(represen)n(ts.)f(Otherwise,)26 b(a)i(n)n(ull)f(Ob)5
+1361 y(represen)n(ts.)f(Otherwise,)26 b(a)i(n)n(ull)f(Ob)5
b(ject)28 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fi(NULL\))h(is)g(returned)f
-(without)h(error.)427 4782 y(If)37 b(a)g(F)-7 b(rameSet)36
+(without)h(error.)427 1474 y(If)37 b(a)g(F)-7 b(rameSet)36
b(is)h(returned,)h(it)f(will)g(con)n(tain)f(t)n(w)n(o)g(F)-7
b(rames.)64 b(F)-7 b(rame)36 b(n)n(um)n(b)r(er)g(1)h(\(its)g(base)f(F)
--7 b(rame\))427 4882 y(represen)n(ts)36 b(the)i(target)f(co)r(ordinate)
+-7 b(rame\))427 1574 y(represen)n(ts)36 b(the)i(target)f(co)r(ordinate)
f(system)h(and)h(will)f(b)r(e)h(the)g(same)f(as)g(the)g(\(base)h(F)-7
-b(rame)37 b(of)g(the\))427 4982 y(target.)64 b(F)-7 b(rame)36
+b(rame)37 b(of)g(the\))427 1673 y(target.)64 b(F)-7 b(rame)36
b(n)n(um)n(b)r(er)h(2)f(\(its)h(curren)n(t)f(F)-7 b(rame\))37
b(will)g(b)r(e)g(a)f(F)-7 b(rame)36 b(represen)n(ting)g(the)h(co)r
-(ordinate)427 5081 y(system)e(whic)n(h)g(the)g(function)h(found.)59
+(ordinate)427 1773 y(system)e(whic)n(h)g(the)g(function)h(found.)59
b(The)35 b(Mapping)g(whic)n(h)g(in)n(ter-relates)e(these)i(t)n(w)n(o)f
-(F)-7 b(rames)34 b(will)427 5181 y(describ)r(e)28 b(ho)n(w)e(to)i(con)n
+(F)-7 b(rames)34 b(will)427 1873 y(describ)r(e)28 b(ho)n(w)e(to)i(con)n
(v)n(ert)e(b)r(et)n(w)n(een)i(their)f(resp)r(ectiv)n(e)g(co)r(ordinate)
-f(systems.)427 5295 y(Note)i(that)h(a)f(F)-7 b(rameSet)28
+f(systems.)427 1986 y(Note)i(that)h(a)f(F)-7 b(rameSet)28
b(ma)n(y)f(b)r(e)i(used)f(b)r(oth)g(as)g(a)g(Mapping)f(and)h(as)g(a)g
(F)-7 b(rame.)38 b(If)28 b(the)h(result)f(is)g(used)427
-5394 y(as)g(a)g(Mapping)g(\(e.g.)40 b(with)29 b(astT)-7
+2085 y(as)g(a)g(Mapping)g(\(e.g.)40 b(with)29 b(astT)-7
b(ran2\),)27 b(then)i(it)g(pro)n(vides)e(a)h(means)g(of)g(con)n(v)n
-(erting)f(co)r(ordinates)g(from)427 5494 y(the)h(target)e(co)r
+(erting)f(co)r(ordinates)g(from)427 2185 y(the)h(target)e(co)r
(ordinate)g(system)h(in)n(to)g(the)h(new)f(co)r(ordinate)f(system)i
(that)f(w)n(as)f(found)i(\(and)f(vice)g(v)n(ersa)427
-5593 y(if)j(its)f(in)n(v)n(erse)e(transformation)g(is)i(selected\).)41
+2285 y(if)j(its)f(in)n(v)n(erse)e(transformation)g(is)i(selected\).)41
b(If)29 b(it)h(is)f(used)f(as)h(a)f(F)-7 b(rame,)29 b(its)g(attributes)
-g(will)g(describ)r(e)427 5693 y(the)f(new)g(co)r(ordinate)e(system.)p
-eop end
-%%Page: 231 241
-TeXDict begin 231 240 bop 3643 52 a FF(231)0 351 y Fd(Examples:)227
-489 y Fp(result)46 b(=)i(astFindFrame\()c(target,)i(astFrame\()f(3,)i
-Ft("")g Fp(\),)g Ft("")g Fp(\);)427 588 y Fi(Searc)n(hes)31
-b(for)h(a)f(3-dimensional)g(co)r(ordinate)g(system)h(in)h(the)g(target)
-e(F)-7 b(rame)32 b(\(or)f(F)-7 b(rameSet\).)51 b(No)32
-b(at-)427 688 y(tributes)j(ha)n(v)n(e)e(b)r(een)h(set)g(in)h(the)f
-(template)h(F)-7 b(rame)34 b(\(created)f(b)n(y)h(astF)-7
-b(rame\),)36 b(so)d(no)h(restriction)f(has)427 787 y(b)r(een)27
-b(placed)g(on)f(the)i(required)e(co)r(ordinate)f(system,)i(other)f
-(than)h(that)g(it)g(should)g(ha)n(v)n(e)e(3)i(dimensions.)427
-887 y(The)h(\014rst)f(suitable)h(F)-7 b(rame)27 b(found)h(will)g(b)r(e)
-g(returned)f(as)g(part)g(of)g(the)h Ft(")p Fi(result)p
-Ft(")f Fi(F)-7 b(rameSet.)227 1021 y Fp(result)46 b(=)i(astFindFrame\()
-c(target,)i(astSkyFrame\()e Ft("")j Fp(\),)g Ft("")g
-Fp(\);)427 1120 y Fi(Searc)n(hes)32 b(for)h(a)g(celestial)f(co)r
-(ordinate)g(system)h(in)h(the)f(target)g(F)-7 b(rame)32
-b(\(or)h(F)-7 b(rameSet\).)54 b(The)33 b(t)n(yp)r(e)h(of)427
-1219 y(celestial)28 b(co)r(ordinate)e(system)i(is)g(unsp)r(eci\014ed,)g
-(so)f(astFindF)-7 b(rame)27 b(will)i(return)e(the)h(\014rst)g(one)f
-(found)h(as)427 1319 y(part)f(of)f(the)h Ft(")p Fi(result)p
-Ft(")f Fi(F)-7 b(rameSet.)36 b(If)28 b(the)f(target)e(is)i(a)f(F)-7
+g(will)g(describ)r(e)427 2384 y(the)f(new)g(co)r(ordinate)e(system.)0
+2540 y Fd(Examples:)227 2671 y Fp(result)46 b(=)i(astFindFrame\()c
+(target,)i(astFrame\()f(3,)i Ft("")g Fp(\),)g Ft("")g
+Fp(\);)427 2769 y Fi(Searc)n(hes)31 b(for)h(a)f(3-dimensional)g(co)r
+(ordinate)g(system)h(in)h(the)g(target)e(F)-7 b(rame)32
+b(\(or)f(F)-7 b(rameSet\).)51 b(No)32 b(at-)427 2869
+y(tributes)j(ha)n(v)n(e)e(b)r(een)h(set)g(in)h(the)f(template)h(F)-7
+b(rame)34 b(\(created)f(b)n(y)h(astF)-7 b(rame\),)36
+b(so)d(no)h(restriction)f(has)427 2969 y(b)r(een)27 b(placed)g(on)f
+(the)i(required)e(co)r(ordinate)f(system,)i(other)f(than)h(that)g(it)g
+(should)g(ha)n(v)n(e)e(3)i(dimensions.)427 3068 y(The)h(\014rst)f
+(suitable)h(F)-7 b(rame)27 b(found)h(will)g(b)r(e)g(returned)f(as)g
+(part)g(of)g(the)h Ft(")p Fi(result)p Ft(")f Fi(F)-7
+b(rameSet.)227 3196 y Fp(result)46 b(=)i(astFindFrame\()c(target,)i
+(astSkyFrame\()e Ft("")j Fp(\),)g Ft("")g Fp(\);)427
+3294 y Fi(Searc)n(hes)32 b(for)h(a)g(celestial)f(co)r(ordinate)g
+(system)h(in)h(the)f(target)g(F)-7 b(rame)32 b(\(or)h(F)-7
+b(rameSet\).)54 b(The)33 b(t)n(yp)r(e)h(of)427 3394 y(celestial)28
+b(co)r(ordinate)e(system)i(is)g(unsp)r(eci\014ed,)g(so)f(astFindF)-7
+b(rame)27 b(will)i(return)e(the)h(\014rst)g(one)f(found)h(as)427
+3494 y(part)f(of)f(the)h Ft(")p Fi(result)p Ft(")f Fi(F)-7
+b(rameSet.)36 b(If)28 b(the)f(target)e(is)i(a)f(F)-7
b(rameSet,)27 b(then)g(its)g(Curren)n(t)f(attribute)h(will)g(b)r(e)427
-1418 y(up)r(dated)h(to)g(iden)n(tify)g(the)g(F)-7 b(rame)27
-b(that)h(w)n(as)f(used.)427 1535 y(If)40 b(no)f(celestial)g(co)r
+3593 y(up)r(dated)h(to)g(iden)n(tify)g(the)g(F)-7 b(rame)27
+b(that)h(w)n(as)f(used.)427 3706 y(If)40 b(no)f(celestial)g(co)r
(ordinate)f(system)h(can)g(b)r(e)g(found,)k(a)c(v)-5
b(alue)39 b(of)g(AST)p Ft(__)p Fi(NULL)g(will)g(b)r(e)h(returned)427
-1635 y(without)28 b(error.)227 1769 y Fp(result)46 b(=)i
+3806 y(without)28 b(error.)227 3933 y Fp(result)46 b(=)i
(astFindFrame\()c(target,)i(astSkyFrame\()e Ft(")p Fp(MaxAxes=100)p
-Ft(")g Fp(\),)j Ft("")g Fp(\);)427 1867 y Fi(This)39
+Ft(")g Fp(\),)j Ft("")g Fp(\);)427 4032 y Fi(This)39
b(is)f(lik)n(e)g(the)h(last)g(example,)i(except)d(that)h(in)g(the)g(ev)
n(en)n(t)f(of)g(the)h(target)f(b)r(eing)h(a)f(CmpF)-7
-b(rame,)427 1967 y(the)31 b(comp)r(onen)n(t)f(F)-7 b(rames)29
+b(rame,)427 4132 y(the)31 b(comp)r(onen)n(t)f(F)-7 b(rames)29
b(encapsulated)g(b)n(y)h(the)g(CmpF)-7 b(rame)30 b(will)h(b)r(e)f
(searc)n(hed)f(for)g(a)h(SkyF)-7 b(rame.)43 b(If)427
-2067 y(found,)29 b(the)g(returned)f(Mapping)g(will)g(included)h(a)f(P)n
+4231 y(found,)29 b(the)g(returned)f(Mapping)g(will)g(included)h(a)f(P)n
(ermMap)f(whic)n(h)h(selects)g(the)g(required)g(axes)f(from)427
-2166 y(the)h(target)f(CmpF)-7 b(rame.)427 2283 y(This)31
+4331 y(the)h(target)f(CmpF)-7 b(rame.)427 4444 y(This)31
b(is)g(acomplished)f(b)n(y)g(setting)h(the)g(MaxAxes)f(attribute)h(of)f
(the)h(template)g(SkyF)-7 b(rame)30 b(to)h(a)f(large)427
-2382 y(n)n(um)n(b)r(er)h(\(larger)e(than)i(or)f(equal)g(to)h(the)g(n)n
+4543 y(n)n(um)n(b)r(er)h(\(larger)e(than)i(or)f(equal)g(to)h(the)g(n)n
(um)n(b)r(er)g(of)g(axes)e(in)i(the)h(target)e(CmpF)-7
-b(rame\).)46 b(This)31 b(allo)n(ws)427 2482 y(the)d(SkyF)-7
+b(rame\).)46 b(This)31 b(allo)n(ws)427 4643 y(the)d(SkyF)-7
b(rame)27 b(to)h(b)r(e)g(used)f(as)g(a)g(matc)n(h)h(for)f(F)-7
b(rames)26 b(con)n(taining)h(from)g(2)h(to)f(100)f(axes.)227
-2616 y Fp(result)46 b(=)i(astFindFrame\()c(target,)i(astSkyFrame\()e
+4771 y Fp(result)46 b(=)i(astFindFrame\()c(target,)i(astSkyFrame\()e
Ft(")p Fp(System=FK5)p Ft(")g Fp(\),)k Ft("")e Fp(\);)427
-2715 y Fi(Searc)n(hes)25 b(for)g(an)h(equatorial)e(\(FK5\))i(co)r
+4869 y Fi(Searc)n(hes)25 b(for)g(an)h(equatorial)e(\(FK5\))i(co)r
(ordinate)f(system)g(in)i(the)f(target.)35 b(The)26 b(Equino)n(x)f(v)-5
-b(alue)26 b(for)f(the)427 2814 y(co)r(ordinate)k(system)h(has)g(not)h
+b(alue)26 b(for)f(the)427 4969 y(co)r(ordinate)k(system)h(has)g(not)h
(b)r(een)f(sp)r(eci\014ed,)i(so)d(will)i(b)r(e)f(obtained)g(from)g(the)
-h(target.)44 b(If)31 b(the)g(target)427 2914 y(is)26
+h(target.)44 b(If)31 b(the)g(target)427 5068 y(is)26
b(a)f(F)-7 b(rameSet,)25 b(its)h(Curren)n(t)f(attribute)g(will)h(b)r(e)
g(up)r(dated)g(to)f(indicate)h(whic)n(h)f(SkyF)-7 b(rame)25
-b(w)n(as)f(used)i(to)427 3013 y(obtain)i(this)f(v)-5
-b(alue.)227 3148 y Fp(result)46 b(=)i(astFindFrame\()c(target,)i
+b(w)n(as)f(used)i(to)427 5168 y(obtain)i(this)f(v)-5
+b(alue.)227 5296 y Fp(result)46 b(=)i(astFindFrame\()c(target,)i
(astFrame\()f(2,)i Ft("")g Fp(\),)g Ft(")p Fp(sky,pixel,)p
-Ft(")d Fp(\);)427 3246 y Fi(Searc)n(hes)29 b(for)g(a)h(2-dimensional)e
+Ft(")d Fp(\);)427 5394 y Fi(Searc)n(hes)29 b(for)g(a)h(2-dimensional)e
(co)r(ordinate)h(system)h(in)g(the)h(target.)43 b(Initially)-7
-b(,)30 b(a)g(searc)n(h)e(is)i(made)g(for)427 3346 y(a)j(suitable)h(co)r
+b(,)30 b(a)g(searc)n(h)e(is)i(made)g(for)427 5494 y(a)j(suitable)h(co)r
(ordinate)e(system)h(whose)g(Domain)g(attribute)g(has)g(the)h(v)-5
b(alue)33 b Ft(")p Fi(SKY)p Ft(")p Fi(.)54 b(If)33 b(this)h(searc)n(h)
-427 3446 y(fails,)g(a)f(searc)n(h)e(is)i(then)g(made)g(for)g(one)f
+427 5593 y(fails,)g(a)f(searc)n(h)e(is)i(then)g(made)g(for)g(one)f
(with)h(the)h(domain)e Ft(")p Fi(PIXEL)p Ft(")p Fi(.)51
-b(If)34 b(this)f(also)f(fails,)i(then)f(an)n(y)427 3545
+b(If)34 b(this)f(also)f(fails,)i(then)f(an)n(y)427 5693
y(2-dimensional)27 b(co)r(ordinate)f(system)h(is)h(returned)f(as)g
(part)g(of)h(the)g Ft(")p Fi(result)p Ft(")e Fi(F)-7
-b(rameSet.)427 3662 y(Only)26 b(if)h(no)g(2-dimensional)e(co)r
-(ordinate)g(systems)h(can)g(b)r(e)h(reac)n(hed)e(b)n(y)h(applying)g
-(built-in)h(con)n(v)n(ersions)427 3761 y(to)h(an)n(y)f(of)g(the)h(F)-7
-b(rames)27 b(in)h(the)g(target)e(will)i(a)f(v)-5 b(alue)28
-b(of)f(AST)p Ft(__)p Fi(NULL)h(b)r(e)g(returned.)227
-3882 y Fp(result)46 b(=)i(astFindFrame\()c(target,)i(astFrame\()f(1,)i
-Ft(")p Fp(Domain=WAVELENGTH)p Ft(")c Fp(\),)k Ft("")227
-3982 y Fp(\);)427 4060 y Fi(Searc)n(hes)18 b(for)h(an)n(y)g
-(1-dimensional)f(co)r(ordinate)h(system)g(in)h(the)g(target)f(whic)n(h)
-g(has)g(the)h(domain)f Ft(")p Fi(W)-9 b(A)g(VE-)427 4160
-y(LENGTH)p Ft(")p Fi(.)227 4294 y Fp(result)46 b(=)i(astFindFrame\()c
-(target,)i(astFrame\()f(1,)i Ft("")g Fp(\),)g Ft(")p
-Fp(wavelength)p Ft(")d Fp(\);)427 4393 y Fi(This)29 b(example)f(has)g
-(exactly)h(the)g(same)f(e\013ect)h(as)f(that)h(ab)r(o)n(v)n(e.)39
-b(It)29 b(illustrates)f(the)h(equiv)-5 b(alence)29 b(of)f(the)427
-4493 y(template's)g(Domain)f(attribute)h(and)g(the)g(\014elds)f(in)h
-(the)g Ft(")p Fi(domainlist)p Ft(")f Fi(string.)227 4627
-y Fp(result)46 b(=)i(astFindFrame\()c(target,)i(astFrame\()f(1,)i
-Ft(")p Fp(MaxAxes=3)p Ft(")e Fp(\),)i Ft("")g Fp(\);)427
-4725 y Fi(This)31 b(is)f(a)g(more)g(adv)-5 b(anced)30
-b(example)g(whic)n(h)h(will)f(searc)n(h)f(for)h(an)n(y)g(co)r(ordinate)
-g(system)g(in)h(the)g(target)427 4825 y(ha)n(ving)j(1,)j(2)e(or)f(3)h
-(dimensions.)59 b(The)35 b(F)-7 b(rame)35 b(returned)f(\(as)h(part)g
-(of)g(the)g Ft(")p Fi(result)p Ft(")f Fi(F)-7 b(rameSet\))35
-b(will)427 4925 y(alw)n(a)n(ys)30 b(b)r(e)j(1-dimensional,)f(but)g
-(will)h(b)r(e)f(related)g(to)f(the)i(co)r(ordinate)e(system)h(that)g(w)
-n(as)f(found)h(b)n(y)g(a)427 5024 y(suitable)c(Mapping)f(\(e.g.)37
-b(a)27 b(P)n(ermMap\))f(whic)n(h)i(simply)g(extracts)e(the)i(\014rst)g
-(axis.)427 5141 y(If)h(w)n(e)e(had)h(w)n(an)n(ted)f(a)h(F)-7
-b(rame)27 b(represen)n(ting)f(the)j(actual)e(\(1,)h(2)f(or)g
-(3-dimensional\))g(co)r(ordinate)g(system)427 5240 y(found,)h(w)n(e)f
-(could)h(set)f(the)h(Preserv)n(eAxes)d(attribute)j(to)g(a)f(non-zero)f
-(v)-5 b(alue)27 b(in)h(the)g(template.)227 5374 y Fp(result)46
+b(rameSet.)p eop end
+%%Page: 232 242
+TeXDict begin 232 241 bop 0 52 a FF(232)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)427 351 y Fi(Only)c(if)h(no)g
+(2-dimensional)e(co)r(ordinate)g(systems)h(can)g(b)r(e)h(reac)n(hed)e
+(b)n(y)h(applying)g(built-in)h(con)n(v)n(ersions)427
+451 y(to)h(an)n(y)f(of)g(the)h(F)-7 b(rames)27 b(in)h(the)g(target)e
+(will)i(a)f(v)-5 b(alue)28 b(of)f(AST)p Ft(__)p Fi(NULL)h(b)r(e)g
+(returned.)227 565 y Fp(result)46 b(=)i(astFindFrame\()c(target,)i
+(astFrame\()f(1,)i Ft(")p Fp(Domain=WAVELENGTH)p Ft(")c
+Fp(\),)k Ft("")227 665 y Fp(\);)427 743 y Fi(Searc)n(hes)18
+b(for)h(an)n(y)g(1-dimensional)f(co)r(ordinate)h(system)g(in)h(the)g
+(target)f(whic)n(h)g(has)g(the)h(domain)f Ft(")p Fi(W)-9
+b(A)g(VE-)427 843 y(LENGTH)p Ft(")p Fi(.)227 971 y Fp(result)46
+b(=)i(astFindFrame\()c(target,)i(astFrame\()f(1,)i Ft("")g
+Fp(\),)g Ft(")p Fp(wavelength)p Ft(")d Fp(\);)427 1069
+y Fi(This)29 b(example)f(has)g(exactly)h(the)g(same)f(e\013ect)h(as)f
+(that)h(ab)r(o)n(v)n(e.)39 b(It)29 b(illustrates)f(the)h(equiv)-5
+b(alence)29 b(of)f(the)427 1169 y(template's)g(Domain)f(attribute)h
+(and)g(the)g(\014elds)f(in)h(the)g Ft(")p Fi(domainlist)p
+Ft(")f Fi(string.)227 1296 y Fp(result)46 b(=)i(astFindFrame\()c
+(target,)i(astFrame\()f(1,)i Ft(")p Fp(MaxAxes=3)p Ft(")e
+Fp(\),)i Ft("")g Fp(\);)427 1395 y Fi(This)31 b(is)f(a)g(more)g(adv)-5
+b(anced)30 b(example)g(whic)n(h)h(will)f(searc)n(h)f(for)h(an)n(y)g(co)
+r(ordinate)g(system)g(in)h(the)g(target)427 1494 y(ha)n(ving)j(1,)j(2)e
+(or)f(3)h(dimensions.)59 b(The)35 b(F)-7 b(rame)35 b(returned)f(\(as)h
+(part)g(of)g(the)g Ft(")p Fi(result)p Ft(")f Fi(F)-7
+b(rameSet\))35 b(will)427 1594 y(alw)n(a)n(ys)30 b(b)r(e)j
+(1-dimensional,)f(but)g(will)h(b)r(e)f(related)g(to)f(the)i(co)r
+(ordinate)e(system)h(that)g(w)n(as)f(found)h(b)n(y)g(a)427
+1694 y(suitable)c(Mapping)f(\(e.g.)37 b(a)27 b(P)n(ermMap\))f(whic)n(h)
+i(simply)g(extracts)e(the)i(\014rst)g(axis.)427 1807
+y(If)h(w)n(e)e(had)h(w)n(an)n(ted)f(a)h(F)-7 b(rame)27
+b(represen)n(ting)f(the)j(actual)e(\(1,)h(2)f(or)g(3-dimensional\))g
+(co)r(ordinate)g(system)427 1906 y(found,)h(w)n(e)f(could)h(set)f(the)h
+(Preserv)n(eAxes)d(attribute)j(to)g(a)f(non-zero)f(v)-5
+b(alue)27 b(in)h(the)g(template.)227 2034 y Fp(result)46
b(=)i(astFindFrame\()c(target,)i(astSkyFrame\()e Ft(")p
-Fp(Permute=0)p Ft(")h Fp(\),)i Ft("")g Fp(\);)427 5473
+Fp(Permute=0)p Ft(")h Fp(\),)i Ft("")g Fp(\);)427 2132
y Fi(Searc)n(hes)39 b(for)h(an)n(y)g(celestial)g(co)r(ordinate)f
(system)h(in)h(the)g(target,)h(but)f(only)f(\014nds)h(one)f(if)h(its)g
-(axes)427 5573 y(are)35 b(in)i(the)f(con)n(v)n(en)n(tional)e
+(axes)427 2232 y(are)35 b(in)i(the)f(con)n(v)n(en)n(tional)e
(\(longitude,latitude\))j(order)e(and)g(ha)n(v)n(e)g(not)h(b)r(een)h(p)
-r(erm)n(uted)f(\(e.g.)62 b(with)427 5672 y(astP)n(ermAxes\).)p
-eop end
-%%Page: 232 242
-TeXDict begin 232 241 bop 0 52 a FF(232)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Notes:)340
-634 y Fh(\017)45 b Fi(The)28 b(Mapping)f(represen)n(ted)g(b)n(y)g(the)h
-(returned)f(F)-7 b(rameSet)27 b(results)g(in)h(alignmen)n(t)f(taking)g
-(place)g(in)h(the)427 733 y(co)r(ordinate)g(system)h(sp)r(eci\014ed)g
-(b)n(y)g(the)g(AlignSystem)g(attribute)g(of)g(the)g Ft(")p
-Fi(template)p Ft(")g Fi(F)-7 b(rame.)40 b(See)29 b(the)427
-833 y(description)e(of)h(the)g(AlignSystem)g(attribute)f(for)g(further)
-h(details.)340 966 y Fh(\017)45 b Fi(Bew)n(are)24 b(of)h(setting)g(the)
-g(Domain)g(attribute)g(of)h(the)f(template)g(and)g(then)h(using)f(a)f
-Ft(")p Fi(domainlist)p Ft(")g Fi(string)427 1065 y(whic)n(h)k(do)r(es)f
+r(erm)n(uted)f(\(e.g.)62 b(with)427 2332 y(astP)n(ermAxes\).)0
+2487 y Fd(Notes:)340 2763 y Fh(\017)45 b Fi(The)28 b(Mapping)f
+(represen)n(ted)g(b)n(y)g(the)h(returned)f(F)-7 b(rameSet)27
+b(results)g(in)h(alignmen)n(t)f(taking)g(place)g(in)h(the)427
+2863 y(co)r(ordinate)g(system)h(sp)r(eci\014ed)g(b)n(y)g(the)g
+(AlignSystem)g(attribute)g(of)g(the)g Ft(")p Fi(template)p
+Ft(")g Fi(F)-7 b(rame.)40 b(See)29 b(the)427 2962 y(description)e(of)h
+(the)g(AlignSystem)g(attribute)f(for)g(further)h(details.)340
+3089 y Fh(\017)45 b Fi(Bew)n(are)24 b(of)h(setting)g(the)g(Domain)g
+(attribute)g(of)h(the)f(template)g(and)g(then)h(using)f(a)f
+Ft(")p Fi(domainlist)p Ft(")g Fi(string)427 3189 y(whic)n(h)k(do)r(es)f
(not)h(include)g(the)g(template's)g(domain)f(\(or)g(a)h(blank)f
(\014eld\).)38 b(If)28 b(y)n(ou)f(do)g(so,)g(no)h(co)r(ordinate)427
-1165 y(system)g(will)f(b)r(e)h(found.)340 1298 y Fh(\017)45
+3288 y(system)g(will)f(b)r(e)h(found.)340 3415 y Fh(\017)45
b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
-(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 1397 y(AST)28
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 3514 y(AST)28
b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)-2 1559 y Fd(More)32 b(on)f(Using)h(T)-8 b(emplates)n(:)227
-1705 y Fi(A)29 b(F)-7 b(rame)27 b(\(describing)g(a)h(co)r(ordinate)f
+(reason.)-2 3670 y Fd(More)32 b(on)f(Using)h(T)-8 b(emplates)n(:)227
+3816 y Fi(A)29 b(F)-7 b(rame)27 b(\(describing)g(a)h(co)r(ordinate)f
(system\))h(will)g(b)r(e)g(found)h(b)n(y)e(this)i(function)f(if)h
(\(a\))f(it)g(is)g Ft(")p Fi(matc)n(hed)p Ft(")f Fi(b)n(y)227
-1805 y(the)34 b(template)f(y)n(ou)f(supply)-7 b(,)34
+3915 y(the)34 b(template)f(y)n(ou)f(supply)-7 b(,)34
b(and)f(\(b\))h(the)f(v)-5 b(alue)33 b(of)g(its)g(Domain)f(attribute)i
(app)r(ears)d(in)i(the)h Ft(")p Fi(domainlist)p Ft(")227
-1904 y Fi(string)f(\(except)h(that)f(a)g(blank)g(\014eld)h(in)f(this)h
+4015 y Fi(string)f(\(except)h(that)f(a)g(blank)g(\014eld)h(in)f(this)h
(string)e(p)r(ermits)i(an)n(y)f(domain\).)53 b(A)34 b(successful)f
-(matc)n(h)g(b)n(y)g(the)227 2004 y(template)28 b(dep)r(ends)g(on)g(a)f
+(matc)n(h)g(b)n(y)g(the)227 4115 y(template)28 b(dep)r(ends)g(on)g(a)f
(n)n(um)n(b)r(er)g(of)h(criteria,)e(as)h(outlined)h(b)r(elo)n(w:)340
-2140 y Fh(\017)45 b Fi(In)26 b(general,)f(a)h(template)g(will)g(only)g
+4245 y Fh(\017)45 b Fi(In)26 b(general,)f(a)h(template)g(will)g(only)g
(matc)n(h)g(another)f(F)-7 b(rame)25 b(whic)n(h)h(b)r(elongs)f(to)h
-(the)h(same)e(class)g(as)g(the)427 2240 y(template,)35
+(the)h(same)e(class)g(as)g(the)427 4344 y(template,)35
b(or)d(to)h(a)f(deriv)n(ed)g(\(more)g(sp)r(ecialised\))h(class.)52
b(F)-7 b(or)32 b(example,)i(a)e(SkyF)-7 b(rame)32 b(template)h(will)427
-2340 y(matc)n(h)h(an)n(y)f(other)g(SkyF)-7 b(rame,)34
+4444 y(matc)n(h)h(an)n(y)f(other)g(SkyF)-7 b(rame,)34
b(but)h(will)f(not)g(matc)n(h)f(a)g(basic)h(F)-7 b(rame.)54
b(Con)n(v)n(ersely)-7 b(,)34 b(a)f(basic)g(F)-7 b(rame)427
-2439 y(template)28 b(will)g(matc)n(h)f(an)n(y)g(class)g(of)g(F)-7
-b(rame.)340 2572 y Fh(\017)45 b Fi(The)26 b(exception)e(to)h(this)h(is)
+4544 y(template)28 b(will)g(matc)n(h)f(an)n(y)g(class)g(of)g(F)-7
+b(rame.)340 4670 y Fh(\017)45 b Fi(The)26 b(exception)e(to)h(this)h(is)
f(that)h(a)e(F)-7 b(rame)25 b(of)g(an)n(y)g(class)f(can)h(b)r(e)g(used)
g(to)g(matc)n(h)g(a)g(CmpF)-7 b(rame,)26 b(if)f(that)427
-2671 y(CmpF)-7 b(rame)27 b(con)n(tains)e(a)h(F)-7 b(rame)26
+4770 y(CmpF)-7 b(rame)27 b(con)n(tains)e(a)h(F)-7 b(rame)26
b(of)h(the)g(same)f(class)f(as)h(the)h(template.)37 b(Note)27
-b(ho)n(w)n(ev)n(er,)d(the)j(MaxAxes)427 2771 y(and)j(MinAxes)h
+b(ho)n(w)n(ev)n(er,)d(the)j(MaxAxes)427 4869 y(and)j(MinAxes)h
(attributes)f(of)h(the)f(template)h(m)n(ust)g(b)r(e)f(set)h(to)f
(suitable)g(v)-5 b(alues)30 b(to)h(allo)n(w)e(it)i(to)f(matc)n(h)427
-2871 y(the)e(CmpF)-7 b(rame.)36 b(That)27 b(is,)g(the)g(MinAxes)g
+4969 y(the)e(CmpF)-7 b(rame.)36 b(That)27 b(is,)g(the)g(MinAxes)g
(attribute)g(m)n(ust)g(b)r(e)h(less)e(than)h(or)f(equal)h(to)g(the)g(n)
-n(um)n(b)r(er)g(of)427 2970 y(axes)g(in)i(the)f(target,)g(and)f(the)i
+n(um)n(b)r(er)g(of)427 5068 y(axes)g(in)i(the)f(target,)g(and)f(the)i
(MaxAxes)e(attribute)i(m)n(ust)f(b)r(e)g(greater)e(than)j(or)e(equal)g
-(to)h(the)h(n)n(um)n(b)r(er)427 3070 y(of)f(axes)e(in)i(the)g(target.)
-340 3203 y Fh(\017)45 b Fi(If)40 b(using)g(a)f(CmpF)-7
+(to)h(the)h(n)n(um)n(b)r(er)427 5168 y(of)f(axes)e(in)i(the)g(target.)
+340 5295 y Fh(\017)45 b Fi(If)40 b(using)g(a)f(CmpF)-7
b(rame)40 b(as)f(a)g(template)h(frame,)i(the)f(MinAxes)e(and)h(MaxAxes)
-f(for)g(the)h(template)427 3302 y(are)33 b(determined)g(b)n(y)h(the)f
+f(for)g(the)h(template)427 5394 y(are)33 b(determined)g(b)n(y)h(the)f
(MinAxes)h(and)f(MaxAxes)g(v)-5 b(alues)33 b(of)g(the)h(comp)r(onen)n
-(t)f(F)-7 b(rames)33 b(within)h(the)427 3402 y(template.)48
+(t)f(F)-7 b(rames)33 b(within)h(the)427 5494 y(template.)48
b(So)30 b(if)i(y)n(ou)e(w)n(an)n(t)g(a)h(template)g(CmpF)-7
b(rame)31 b(to)g(b)r(e)g(able)g(to)g(matc)n(h)g(F)-7
-b(rames)30 b(with)h(di\013eren)n(t)427 3502 y(n)n(um)n(b)r(ers)19
+b(rames)30 b(with)h(di\013eren)n(t)427 5593 y(n)n(um)n(b)r(ers)19
b(of)g(axes,)h(then)f(y)n(ou)g(m)n(ust)g(set)g(the)g(MaxAxes)g(and/or)e
(MinAxes)i(attributes)g(in)g(the)h(comp)r(onen)n(t)427
-3601 y(template)28 b(F)-7 b(rames,)27 b(b)r(efore)g(com)n(bining)g
+5693 y(template)28 b(F)-7 b(rames,)27 b(b)r(efore)g(com)n(bining)g
(them)i(together)d(in)n(to)i(the)g(template)f(CmpF)-7
-b(rame.)340 3734 y Fh(\017)45 b Fi(If)32 b(a)e(template)i(has)e(a)h(v)
--5 b(alue)30 b(set)h(for)g(an)n(y)f(of)h(its)g(main)g(attributes,)h
-(then)f(it)h(will)f(only)g(matc)n(h)f(F)-7 b(rames)427
-3834 y(whic)n(h)23 b(ha)n(v)n(e)e(an)h(iden)n(tical)g(v)-5
-b(alue)22 b(for)g(that)h(attribute)g(\(or)e(whic)n(h)i(can)f(b)r(e)h
-(transformed,)f(using)g(a)g(built-in)427 3933 y(con)n(v)n(ersion,)30
-b(so)g(that)h(they)g(ha)n(v)n(e)f(the)h(required)f(v)-5
-b(alue)31 b(for)f(that)h(attribute\).)48 b(If)31 b(an)n(y)f(attribute)h
-(in)g(the)427 4033 y(template)d(is)f(un-set,)g(ho)n(w)n(ev)n(er,)e
-(then)i(F)-7 b(rames)27 b(are)f(matc)n(hed)g(regardless)f(of)i(the)g(v)
--5 b(alue)27 b(they)g(ma)n(y)g(ha)n(v)n(e)427 4132 y(for)37
-b(that)h(attribute.)66 b(Y)-7 b(ou)37 b(ma)n(y)g(therefore)f(mak)n(e)g
-(a)h(template)h(more)e(or)h(less)g(sp)r(eci\014c)g(b)n(y)g(c)n(ho)r
-(osing)427 4232 y(the)h(attributes)f(for)g(whic)n(h)g(y)n(ou)g(set)g(v)
--5 b(alues.)65 b(This)38 b(requiremen)n(t)e(do)r(es)h(not)g(apply)g(to)
-g('descriptiv)n(e')427 4332 y(attributes)28 b(suc)n(h)f(as)g(titles,)h
-(lab)r(els,)g(sym)n(b)r(ols,)e(etc.)340 4464 y Fh(\017)45
+b(rame.)p eop end
+%%Page: 233 243
+TeXDict begin 233 242 bop 3643 52 a FF(233)340 351 y
+Fh(\017)45 b Fi(If)32 b(a)e(template)i(has)e(a)h(v)-5
+b(alue)30 b(set)h(for)g(an)n(y)f(of)h(its)g(main)g(attributes,)h(then)f
+(it)h(will)f(only)g(matc)n(h)f(F)-7 b(rames)427 451 y(whic)n(h)23
+b(ha)n(v)n(e)e(an)h(iden)n(tical)g(v)-5 b(alue)22 b(for)g(that)h
+(attribute)g(\(or)e(whic)n(h)i(can)f(b)r(e)h(transformed,)f(using)g(a)g
+(built-in)427 551 y(con)n(v)n(ersion,)30 b(so)g(that)h(they)g(ha)n(v)n
+(e)f(the)h(required)f(v)-5 b(alue)31 b(for)f(that)h(attribute\).)48
+b(If)31 b(an)n(y)f(attribute)h(in)g(the)427 650 y(template)d(is)f
+(un-set,)g(ho)n(w)n(ev)n(er,)e(then)i(F)-7 b(rames)27
+b(are)f(matc)n(hed)g(regardless)f(of)i(the)g(v)-5 b(alue)27
+b(they)g(ma)n(y)g(ha)n(v)n(e)427 750 y(for)37 b(that)h(attribute.)66
+b(Y)-7 b(ou)37 b(ma)n(y)g(therefore)f(mak)n(e)g(a)h(template)h(more)e
+(or)h(less)g(sp)r(eci\014c)g(b)n(y)g(c)n(ho)r(osing)427
+849 y(the)h(attributes)f(for)g(whic)n(h)g(y)n(ou)g(set)g(v)-5
+b(alues.)65 b(This)38 b(requiremen)n(t)e(do)r(es)h(not)g(apply)g(to)g
+('descriptiv)n(e')427 949 y(attributes)28 b(suc)n(h)f(as)g(titles,)h
+(lab)r(els,)g(sym)n(b)r(ols,)e(etc.)340 1081 y Fh(\017)45
b Fi(An)22 b(imp)r(ortan)n(t)g(application)f(of)g(this)h(principle)g
(in)n(v)n(olv)n(es)e(the)i(Domain)g(attribute.)35 b(Setting)22
-b(the)g(Domain)427 4564 y(attribute)j(of)g(the)h(template)f(has)f(the)i
+b(the)g(Domain)427 1181 y(attribute)j(of)g(the)h(template)f(has)f(the)i
(e\013ect)f(of)g(restricting)f(the)i(searc)n(h)d(to)i(a)f(particular)g
-(t)n(yp)r(e)h(of)g(F)-7 b(rame)427 4664 y(\(with)24 b(the)g(domain)e(y)
+(t)n(yp)r(e)h(of)g(F)-7 b(rame)427 1281 y(\(with)24 b(the)g(domain)e(y)
n(ou)g(sp)r(ecify\).)36 b(Con)n(v)n(ersely)-7 b(,)22
b(if)i(the)f(Domain)g(attribute)g(is)g(not)g(set)g(in)h(the)f
-(template,)427 4763 y(then)h(the)f(domain)g(of)f(the)i(F)-7
+(template,)427 1380 y(then)h(the)f(domain)g(of)f(the)i(F)-7
b(rame)22 b(found)h(is)g(not)g(relev)-5 b(an)n(t,)23
b(so)g(all)f(F)-7 b(rames)22 b(are)g(searc)n(hed.)34
-b(Note)23 b(that)g(the)427 4863 y Ft(")p Fi(domainlist)p
+b(Note)23 b(that)g(the)427 1480 y Ft(")p Fi(domainlist)p
Ft(")h Fi(string)g(pro)n(vides)g(an)g(alternativ)n(e)g(w)n(a)n(y)g(of)h
(restricting)f(the)h(searc)n(h)e(in)i(the)h(same)e(manner,)427
-4963 y(but)30 b(is)e(a)h(more)f(con)n(v)n(enien)n(t)f(in)n(terface)h
+1580 y(but)30 b(is)e(a)h(more)f(con)n(v)n(enien)n(t)f(in)n(terface)h
(if)i(y)n(ou)e(wish)g(to)h(searc)n(h)e(automatically)h(for)g(another)g
-(domain)g(if)427 5062 y(the)g(\014rst)g(searc)n(h)e(fails.)340
-5195 y Fh(\017)45 b Fi(Normally)-7 b(,)29 b(a)g(template)h(will)f(only)
+(domain)g(if)427 1679 y(the)g(\014rst)g(searc)n(h)e(fails.)340
+1812 y Fh(\017)45 b Fi(Normally)-7 b(,)29 b(a)g(template)h(will)f(only)
g(matc)n(h)g(a)g(F)-7 b(rame)29 b(whic)n(h)g(has)g(the)g(same)g(n)n(um)
-n(b)r(er)g(of)g(axes)f(as)h(itself.)427 5295 y(Ho)n(w)n(ev)n(er,)i(for)
+n(b)r(er)g(of)g(axes)f(as)h(itself.)427 1911 y(Ho)n(w)n(ev)n(er,)i(for)
g(some)g(classes)f(of)h(template,)i(this)f(default)f(b)r(eha)n(viour)g
(ma)n(y)f(b)r(e)i(c)n(hanged)f(b)n(y)g(means)g(of)427
-5394 y(the)f(MinAxes,)g(MaxAxes)e(and)h(Matc)n(hEnd)g(attributes.)42
+2011 y(the)f(MinAxes,)g(MaxAxes)e(and)h(Matc)n(hEnd)g(attributes.)42
b(In)29 b(addition,)h(the)f(b)r(eha)n(viour)f(of)h(a)g(template)427
-5494 y(ma)n(y)38 b(b)r(e)h(in\015uenced)g(b)n(y)f(its)h(P)n(erm)n(ute)e
+2111 y(ma)n(y)38 b(b)r(e)h(in\015uenced)g(b)n(y)f(its)h(P)n(erm)n(ute)e
(and)i(Preserv)n(eAxes)d(attributes,)41 b(whic)n(h)e(con)n(trol)e
-(whether)h(it)427 5593 y(matc)n(hes)30 b(F)-7 b(rames)30
+(whether)h(it)427 2210 y(matc)n(hes)30 b(F)-7 b(rames)30
b(whose)g(axes)f(ha)n(v)n(e)h(b)r(een)g(p)r(erm)n(uted,)i(and)e
(whether)h(this)g(p)r(erm)n(utation)f(is)g(retained)427
-5693 y(in)k(the)f(F)-7 b(rame)33 b(whic)n(h)g(is)h(returned)e(\(as)h
+2310 y(in)k(the)f(F)-7 b(rame)33 b(whic)n(h)g(is)h(returned)e(\(as)h
(opp)r(osed)g(to)g(returning)g(the)g(axes)g(in)g(the)h(order)e(sp)r
-(eci\014ed)h(in)p eop end
-%%Page: 233 243
-TeXDict begin 233 242 bop 3643 52 a FF(233)427 351 y
-Fi(the)31 b(template,)h(whic)n(h)f(is)f(the)h(default)g(b)r(eha)n
-(viour\).)45 b(Y)-7 b(ou)31 b(should)g(consult)f(the)h(descriptions)f
-(of)h(these)427 451 y(attributes)d(for)f(details)g(of)h(this)g(more)e
-(adv)-5 b(anced)28 b(use)f(of)h(templates.)p 0 647 3780
-12 v 0 779 a Fz(astFitsChan)707 b Fe(Create)37 b(a)h(FitsChan)705
-b Fz(astFitsChan)0 941 y Fd(Description:)44 b Fi(This)28
-b(function)g(creates)f(a)g(new)g(FitsChan)h(and)f(optionally)g
-(initialises)h(its)f(attributes.)227 1065 y(A)33 b(FitsChan)e(is)h(a)g
-(sp)r(ecialised)f(form)h(of)g(Channel)f(whic)n(h)h(supp)r(orts)g(I/O)f
-(op)r(erations)f(in)n(v)n(olving)h(the)h(use)g(of)227
-1165 y(FITS)g(\(Flexible)h(Image)e(T)-7 b(ransp)r(ort)30
-b(System\))i(header)f(cards.)49 b(W)-7 b(riting)32 b(an)f(Ob)5
-b(ject)32 b(to)f(a)h(FitsChan)g(\(using)227 1264 y(astW)-7
-b(rite\))31 b(will,)h(if)g(the)f(Ob)5 b(ject)31 b(is)g(suitable,)h
-(generate)d(a)i(description)f(of)h(that)g(Ob)5 b(ject)31
-b(comp)r(osed)f(of)h(FITS)227 1364 y(header)h(cards,)i(and)e(reading)g
-(from)h(a)f(FitsChan)i(will)f(create)f(a)g(new)h(Ob)5
-b(ject)33 b(from)g(its)g(FITS)g(header)f(card)227 1464
-y(description.)227 1587 y(While)k(a)e(FitsChan)h(is)f(activ)n(e,)i(it)f
+(eci\014ed)h(in)427 2409 y(the)e(template,)h(whic)n(h)f(is)f(the)h
+(default)g(b)r(eha)n(viour\).)45 b(Y)-7 b(ou)31 b(should)g(consult)f
+(the)h(descriptions)f(of)h(these)427 2509 y(attributes)d(for)f(details)
+g(of)h(this)g(more)e(adv)-5 b(anced)28 b(use)f(of)h(templates.)p
+0 2707 3780 12 v 0 2839 a Fz(astFitsChan)707 b Fe(Create)37
+b(a)h(FitsChan)705 b Fz(astFitsChan)0 3004 y Fd(Description:)44
+b Fi(This)28 b(function)g(creates)f(a)g(new)g(FitsChan)h(and)f
+(optionally)g(initialises)h(its)f(attributes.)227 3128
+y(A)33 b(FitsChan)e(is)h(a)g(sp)r(ecialised)f(form)h(of)g(Channel)f
+(whic)n(h)h(supp)r(orts)g(I/O)f(op)r(erations)f(in)n(v)n(olving)h(the)h
+(use)g(of)227 3228 y(FITS)g(\(Flexible)h(Image)e(T)-7
+b(ransp)r(ort)30 b(System\))i(header)f(cards.)49 b(W)-7
+b(riting)32 b(an)f(Ob)5 b(ject)32 b(to)f(a)h(FitsChan)g(\(using)227
+3327 y(astW)-7 b(rite\))31 b(will,)h(if)g(the)f(Ob)5
+b(ject)31 b(is)g(suitable,)h(generate)d(a)i(description)f(of)h(that)g
+(Ob)5 b(ject)31 b(comp)r(osed)f(of)h(FITS)227 3427 y(header)h(cards,)i
+(and)e(reading)g(from)h(a)f(FitsChan)i(will)f(create)f(a)g(new)h(Ob)5
+b(ject)33 b(from)g(its)g(FITS)g(header)f(card)227 3527
+y(description.)227 3651 y(While)k(a)e(FitsChan)h(is)f(activ)n(e,)i(it)f
(represen)n(ts)f(a)g(bu\013er)h(whic)n(h)g(ma)n(y)f(con)n(tain)g(zero)f
-(or)h(more)g(80-c)n(haracter)227 1687 y Ft(")p Fi(header)29
+(or)h(more)g(80-c)n(haracter)227 3751 y Ft(")p Fi(header)29
b(cards)p Ft(")f Fi(conforming)g(to)i(FITS)f(con)n(v)n(en)n(tions.)41
b(An)n(y)30 b(sequence)f(of)h(FITS-conforming)e(header)h(cards)227
-1787 y(ma)n(y)f(b)r(e)g(stored,)g(apart)f(from)h(the)h
+3850 y(ma)n(y)f(b)r(e)g(stored,)g(apart)f(from)h(the)h
Ft(")p Fi(END)p Ft(")e Fi(card)h(whose)f(existence)h(is)g(merely)g
-(implied.)39 b(The)29 b(cards)e(ma)n(y)g(b)r(e)227 1886
+(implied.)39 b(The)29 b(cards)e(ma)n(y)g(b)r(e)227 3950
y(accessed)g(in)g(an)n(y)g(order)f(b)n(y)h(using)g(the)h(FitsChan's)f
(in)n(teger)g(Card)g(attribute,)g(whic)n(h)h(iden)n(ti\014es)f(a)g
-Ft(")p Fi(curren)n(t)p Ft(")227 1986 y Fi(card,)g(to)h(whic)n(h)f
+Ft(")p Fi(curren)n(t)p Ft(")227 4050 y Fi(card,)g(to)h(whic)n(h)f
(subsequen)n(t)h(op)r(erations)e(apply)-7 b(.)37 b(Searc)n(hes)26
b(based)h(on)h(k)n(eyw)n(ord)d(ma)n(y)i(b)r(e)h(p)r(erformed)g(\(using)
-227 2085 y(astFindFits\),)k(new)e(cards)f(ma)n(y)g(b)r(e)i(inserted)f
+227 4149 y(astFindFits\),)k(new)e(cards)f(ma)n(y)g(b)r(e)i(inserted)f
(\(astPutFits,)h(astPutCards,)e(astSetFits)p Fk(<)p Fi(X)p
-Fk(>)p Fi(\))h(and)g(existing)227 2185 y(ones)d(ma)n(y)g(b)r(e)h
+Fk(>)p Fi(\))h(and)g(existing)227 4249 y(ones)d(ma)n(y)g(b)r(e)h
(deleted)g(\(astDelFits\))h(or)d(c)n(hanged)h(\(astSetFits)p
-Fk(<)p Fi(X)p Fk(>)p Fi(\).)227 2309 y(When)37 b(y)n(ou)f(create)g(a)g
+Fk(<)p Fi(X)p Fk(>)p Fi(\).)227 4373 y(When)37 b(y)n(ou)f(create)g(a)g
(FitsChan,)j(y)n(ou)d(ha)n(v)n(e)g(the)h(option)f(of)h(sp)r(ecifying)g
Ft(")p Fi(source)p Ft(")d Fi(and)j Ft(")p Fi(sink)p Ft(")e
-Fi(functions)227 2408 y(whic)n(h)26 b(connect)g(it)h(to)f(external)f
+Fi(functions)227 4473 y(whic)n(h)26 b(connect)g(it)h(to)f(external)f
(data)h(stores)f(b)n(y)h(reading)f(and)h(writing)g(FITS)g(header)g
-(cards.)35 b(If)26 b(y)n(ou)g(pro)n(vide)227 2508 y(a)h(source)f
+(cards.)35 b(If)26 b(y)n(ou)g(pro)n(vide)227 4572 y(a)h(source)f
(function,)j(it)e(is)h(used)f(to)g(\014ll)h(the)g(FitsChan)f(with)h
(header)f(cards)f(when)i(it)g(is)f(accessed)f(for)h(the)h(\014rst)227
-2608 y(time.)56 b(If)34 b(y)n(ou)f(do)h(not)f(pro)n(vide)g(a)g(source)g
+4672 y(time.)56 b(If)34 b(y)n(ou)f(do)h(not)f(pro)n(vide)g(a)g(source)g
(function,)j(the)e(FitsChan)g(remains)e(empt)n(y)i(un)n(til)g(y)n(ou)f
-(explicitly)227 2707 y(en)n(ter)20 b(data)g(in)n(to)h(it)g(\(e.g.)34
+(explicitly)227 4772 y(en)n(ter)20 b(data)g(in)n(to)h(it)g(\(e.g.)34
b(using)20 b(astPutFits,)i(astPutCards,)e(astW)-7 b(rite)21
b(or)e(b)n(y)h(using)h(the)g(SourceFile)e(attribute)227
-2807 y(to)31 b(sp)r(ecifying)g(a)f(text)h(\014le)g(from)g(whic)n(h)g
+4871 y(to)31 b(sp)r(ecifying)g(a)f(text)h(\014le)g(from)g(whic)n(h)g
(headers)e(should)i(b)r(e)g(read\).)46 b(When)31 b(the)h(FitsChan)f(is)
-f(deleted,)i(an)n(y)227 2907 y(remaining)i(header)g(cards)f(in)i(the)g
+f(deleted,)i(an)n(y)227 4971 y(remaining)i(header)g(cards)f(in)i(the)g
(FitsChan)g(can)f(b)r(e)h(sa)n(v)n(ed)e(in)i(either)f(of)h(t)n(w)n(o)e
(w)n(a)n(ys:)50 b(1\))34 b(b)n(y)g(sp)r(ecifying)h(a)227
-3006 y(v)-5 b(alue)28 b(for)g(the)g(SinkFile)g(attribute)h(\(the)f
+5071 y(v)-5 b(alue)28 b(for)g(the)g(SinkFile)g(attribute)h(\(the)f
(name)g(of)g(a)g(text)g(\014le)g(to)g(whic)n(h)g(header)f(cards)g
-(should)h(b)r(e)g(written\),)227 3106 y(or)i(2\))h(b)n(y)g(pro)n
+(should)h(b)r(e)g(written\),)227 5170 y(or)i(2\))h(b)n(y)g(pro)n
(viding)f(a)g(sink)h(function)h(\(used)f(to)g(to)g(deliv)n(er)f(header)
g(cards)g(to)h(an)g(external)f(data)h(store\).)46 b(If)227
-3205 y(y)n(ou)30 b(do)g(not)g(pro)n(vide)g(a)g(sink)g(function)h(or)e
+5270 y(y)n(ou)30 b(do)g(not)g(pro)n(vide)g(a)g(sink)g(function)h(or)e
(a)h(v)-5 b(alue)30 b(for)g(SinkFile,)i(an)n(y)d(header)h(cards)f
-(remaining)h(when)g(the)227 3305 y(FitsChan)25 b(is)f(deleted)h(will)g
+(remaining)h(when)g(the)227 5369 y(FitsChan)25 b(is)f(deleted)h(will)g
(b)r(e)g(lost,)g(so)f(y)n(ou)f(should)i(arrange)d(to)i(extract)g(them)h
-(\014rst)f(if)i(necessary)c(\(e.g.)36 b(using)227 3405
-y(astFindFits)28 b(or)f(astRead\).)227 3528 y(Co)r(ordinate)i(system)g
+(\014rst)f(if)i(necessary)c(\(e.g.)36 b(using)227 5469
+y(astFindFits)28 b(or)f(astRead\).)227 5593 y(Co)r(ordinate)i(system)g
(information)g(ma)n(y)g(b)r(e)h(describ)r(ed)g(using)f(FITS)h(header)f
-(cards)f(using)i(sev)n(eral)d(di\013eren)n(t)227 3628
+(cards)f(using)i(sev)n(eral)d(di\013eren)n(t)227 5693
y(con)n(v)n(en)n(tions,)h(termed)h Ft(")p Fi(enco)r(dings)p
Ft(")p Fi(.)39 b(When)29 b(an)g(AST)g(Ob)5 b(ject)29
-b(is)f(written)h(to)g(\(or)f(read)g(from\))h(a)f(FitsChan,)227
-3728 y(the)22 b(v)-5 b(alue)22 b(of)g(the)g(FitsChan's)g(Enco)r(ding)f
-(attribute)g(determines)h(ho)n(w)f(the)h(Ob)5 b(ject)22
-b(is)g(con)n(v)n(erted)e(to)i(\(or)f(from\))227 3827
-y(a)31 b(description)g(in)n(v)n(olving)g(FITS)g(header)g(cards.)48
-b(In)32 b(general,)f(di\013eren)n(t)h(enco)r(dings)f(will)g(result)h
-(in)f(di\013eren)n(t)227 3927 y(sets)24 b(of)f(header)g(cards)g(to)g
-(describ)r(e)h(the)g(same)f(Ob)5 b(ject.)35 b(Examples)23
-b(of)g(enco)r(dings)g(include)h(the)h(DSS)f(enco)r(ding)227
-4027 y(\(based)35 b(on)g(con)n(v)n(en)n(tions)f(used)h(b)n(y)g(the)h
-(STScI)g(Digitised)f(Sky)g(Surv)n(ey)g(data\),)i(the)f(FITS-W)n(CS)f
-(enco)r(ding)227 4126 y(\(based)30 b(on)g(a)g(prop)r(osed)f(FITS)h
-(standard\))g(and)g(the)g(NA)-7 b(TIVE)31 b(enco)r(ding)e(\(a)h(near)f
-(loss-less)g(w)n(a)n(y)g(of)h(storing)227 4226 y(AST)e(Ob)5
-b(jects)27 b(in)h(FITS)g(headers\).)227 4350 y(The)e(a)n(v)-5
-b(ailable)25 b(enco)r(dings)g(di\013er)h(in)g(the)g(range)f(of)h(Ob)5
-b(jects)25 b(they)h(can)g(represen)n(t,)f(in)h(the)g(n)n(um)n(b)r(er)g
-(of)g(Ob)5 b(ject)227 4449 y(descriptions)31 b(that)h(can)g(co)r(exist)
-f(in)h(the)g(same)g(FitsChan,)h(and)e(in)h(their)g(accessibilit)n(y)f
-(to)h(other)f(\(external\))227 4549 y(astronom)n(y)36
-b(applications)g(\(see)i(the)f(Enco)r(ding)g(attribute)h(for)f
-(details\).)66 b(Enco)r(dings)36 b(are)h(not)g(necessarily)227
-4648 y(m)n(utually)28 b(exclusiv)n(e)g(and)g(it)h(ma)n(y)e(sometimes)h
-(b)r(e)h(p)r(ossible)f(to)g(describ)r(e)g(the)g(same)g(Ob)5
-b(ject)28 b(in)h(sev)n(eral)d(w)n(a)n(ys)227 4748 y(within)j(a)e
-(particular)f(set)i(of)f(FITS)h(header)f(cards)f(b)n(y)i(using)f(sev)n
-(eral)f(di\013eren)n(t)h(enco)r(dings.)227 4872 y(The)38
-b(detailed)f(b)r(eha)n(viour)g(of)g(astRead)g(and)g(astW)-7
-b(rite,)40 b(when)e(used)f(with)h(a)f(FitsChan,)j(dep)r(ends)e(on)f
-(the)227 4971 y(enco)r(ding)28 b(in)h(use.)39 b(In)29
+b(is)f(written)h(to)g(\(or)f(read)g(from\))h(a)f(FitsChan,)p
+eop end
+%%Page: 234 244
+TeXDict begin 234 243 bop 0 52 a FF(234)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)227 351 y Fi(the)22
+b(v)-5 b(alue)22 b(of)g(the)g(FitsChan's)g(Enco)r(ding)f(attribute)g
+(determines)h(ho)n(w)f(the)h(Ob)5 b(ject)22 b(is)g(con)n(v)n(erted)e
+(to)i(\(or)f(from\))227 451 y(a)31 b(description)g(in)n(v)n(olving)g
+(FITS)g(header)g(cards.)48 b(In)32 b(general,)f(di\013eren)n(t)h(enco)r
+(dings)f(will)g(result)h(in)f(di\013eren)n(t)227 551
+y(sets)24 b(of)f(header)g(cards)g(to)g(describ)r(e)h(the)g(same)f(Ob)5
+b(ject.)35 b(Examples)23 b(of)g(enco)r(dings)g(include)h(the)h(DSS)f
+(enco)r(ding)227 650 y(\(based)35 b(on)g(con)n(v)n(en)n(tions)f(used)h
+(b)n(y)g(the)h(STScI)g(Digitised)f(Sky)g(Surv)n(ey)g(data\),)i(the)f
+(FITS-W)n(CS)f(enco)r(ding)227 750 y(\(based)30 b(on)g(a)g(prop)r(osed)
+f(FITS)h(standard\))g(and)g(the)g(NA)-7 b(TIVE)31 b(enco)r(ding)e(\(a)h
+(near)f(loss-less)g(w)n(a)n(y)g(of)h(storing)227 849
+y(AST)e(Ob)5 b(jects)27 b(in)h(FITS)g(headers\).)227
+979 y(The)e(a)n(v)-5 b(ailable)25 b(enco)r(dings)g(di\013er)h(in)g(the)
+g(range)f(of)h(Ob)5 b(jects)25 b(they)h(can)g(represen)n(t,)f(in)h(the)
+g(n)n(um)n(b)r(er)g(of)g(Ob)5 b(ject)227 1079 y(descriptions)31
+b(that)h(can)g(co)r(exist)f(in)h(the)g(same)g(FitsChan,)h(and)e(in)h
+(their)g(accessibilit)n(y)f(to)h(other)f(\(external\))227
+1178 y(astronom)n(y)36 b(applications)g(\(see)i(the)f(Enco)r(ding)g
+(attribute)h(for)f(details\).)66 b(Enco)r(dings)36 b(are)h(not)g
+(necessarily)227 1278 y(m)n(utually)28 b(exclusiv)n(e)g(and)g(it)h(ma)n
+(y)e(sometimes)h(b)r(e)h(p)r(ossible)f(to)g(describ)r(e)g(the)g(same)g
+(Ob)5 b(ject)28 b(in)h(sev)n(eral)d(w)n(a)n(ys)227 1378
+y(within)j(a)e(particular)f(set)i(of)f(FITS)h(header)f(cards)f(b)n(y)i
+(using)f(sev)n(eral)f(di\013eren)n(t)h(enco)r(dings.)227
+1508 y(The)38 b(detailed)f(b)r(eha)n(viour)g(of)g(astRead)g(and)g(astW)
+-7 b(rite,)40 b(when)e(used)f(with)h(a)f(FitsChan,)j(dep)r(ends)e(on)f
+(the)227 1607 y(enco)r(ding)28 b(in)h(use.)39 b(In)29
b(general,)e(ho)n(w)n(ev)n(er,)f(all)i(use)h(of)f(astRead)g(is)g
(destructiv)n(e,)g(so)g(that)g(FITS)h(header)f(cards)227
-5071 y(are)20 b(consumed)g(in)g(the)h(pro)r(cess)e(of)h(reading)g(an)g
+1707 y(are)20 b(consumed)g(in)g(the)h(pro)r(cess)e(of)h(reading)g(an)g
(Ob)5 b(ject,)21 b(and)f(are)g(remo)n(v)n(ed)f(from)h(the)g(FitsChan)h
-(\(this)g(deletion)227 5171 y(can)27 b(b)r(e)h(prev)n(en)n(ted)f(for)g
+(\(this)g(deletion)227 1806 y(can)27 b(b)r(e)h(prev)n(en)n(ted)f(for)g
(sp)r(eci\014c)h(cards)f(b)n(y)g(calling)g(the)h(astRetainFits)f
-(function\).)227 5295 y(If)i(the)f(enco)r(ding)f(in)h(use)g(allo)n(ws)f
+(function\).)227 1936 y(If)i(the)f(enco)r(ding)f(in)h(use)g(allo)n(ws)f
(only)g(a)h(single)f(Ob)5 b(ject)28 b(description)f(to)h(b)r(e)g
-(stored)f(in)h(a)g(FitsChan)g(\(e.g.)37 b(the)227 5394
+(stored)f(in)h(a)g(FitsChan)g(\(e.g.)37 b(the)227 2036
y(DSS,)27 b(FITS-W)n(CS)f(and)f(FITS-IRAF)i(enco)r(dings\),)f(then)g
(write)g(op)r(erations)e(using)h(astW)-7 b(rite)26 b(will)g(o)n(v)n
-(er-write)227 5494 y(an)n(y)37 b(existing)h(Ob)5 b(ject)37
+(er-write)227 2135 y(an)n(y)37 b(existing)h(Ob)5 b(ject)37
b(description)g(using)h(that)g(enco)r(ding.)66 b(Otherwise)37
b(\(e.g.)67 b(the)39 b(NA)-7 b(TIVE)38 b(enco)r(ding\),)227
-5593 y(m)n(ultiple)i(Ob)5 b(ject)39 b(descriptions)g(are)f(written)i
+2235 y(m)n(ultiple)i(Ob)5 b(ject)39 b(descriptions)g(are)f(written)i
(sequen)n(tially)e(and)h(ma)n(y)g(later)f(b)r(e)i(read)f(bac)n(k)f(in)i
-(the)f(same)227 5693 y(sequence.)p eop end
-%%Page: 234 244
-TeXDict begin 234 243 bop 0 52 a FF(234)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Synopsis:)121
+(the)f(same)227 2335 y(sequence.)0 2495 y Fd(Synopsis:)121
b Ft(AstFitsChan)39 b Fh(\003)p Ft(astFitsChan\()f(const)k(char)f
Fh(\003)p Ft(\()p Fh(\003)i Ft(source\)\()d(void)i(\),)h(void)f(\()p
-Fh(\003)g Ft(sink\)\()f(const)227 451 y(char)h Fh(\003)h
+Fh(\003)g Ft(sink\)\()f(const)227 2594 y(char)h Fh(\003)h
Ft(\),)g(const)f(char)g Fh(\003)p Ft(options,)d(...)86
-b(\))0 596 y Fd(P)m(arameters:)259 728 y(source)427 828
-y Fi(P)n(oin)n(ter)40 b(to)h(a)f(source)g(function)i(whic)n(h)f(tak)n
-(es)f(no)h(argumen)n(ts)f(and)g(returns)h(a)f(p)r(oin)n(ter)h(to)g(a)g
-(n)n(ull-)427 928 y(terminated)29 b(string.)41 b(This)29
-b(function)h(will)f(b)r(e)h(used)f(b)n(y)g(the)g(FitsChan)g(to)g
-(obtain)g(input)h(FITS)f(header)427 1027 y(cards.)61
+b(\))0 2754 y Fd(P)m(arameters:)259 2901 y(source)427
+3001 y Fi(P)n(oin)n(ter)40 b(to)h(a)f(source)g(function)i(whic)n(h)f
+(tak)n(es)f(no)h(argumen)n(ts)f(and)g(returns)h(a)f(p)r(oin)n(ter)h(to)
+g(a)g(n)n(ull-)427 3101 y(terminated)29 b(string.)41
+b(This)29 b(function)h(will)f(b)r(e)h(used)f(b)n(y)g(the)g(FitsChan)g
+(to)g(obtain)g(input)h(FITS)f(header)427 3200 y(cards.)61
b(On)35 b(eac)n(h)h(in)n(v)n(o)r(cation,)g(it)g(should)g(read)f(the)h
(next)g(input)h(card)e(from)h(some)f(external)g(source)427
-1127 y(\(suc)n(h)30 b(as)f(a)h(FITS)g(\014le\),)h(and)f(return)f(a)h(p)
+3300 y(\(suc)n(h)30 b(as)f(a)h(FITS)g(\014le\),)h(and)f(return)f(a)h(p)
r(oin)n(ter)f(to)h(the)g(\(n)n(ull-terminated\))g(con)n(ten)n(ts)f(of)h
-(the)g(card.)43 b(It)427 1226 y(should)28 b(return)f(a)g(NULL)h(p)r
+(the)g(card.)43 b(It)427 3400 y(should)28 b(return)f(a)g(NULL)h(p)r
(oin)n(ter)f(when)h(there)f(are)g(no)g(more)g(cards)f(to)i(b)r(e)g
-(read.)427 1341 y(If)k Ft(")p Fi(source)p Ft(")d Fi(is)j(NULL,)g(the)f
+(read.)427 3518 y(If)k Ft(")p Fi(source)p Ft(")d Fi(is)j(NULL,)g(the)f
(FitsChan)h(will)g(remain)e(empt)n(y)i(un)n(til)g(cards)e(are)g
-(explicitly)i(stored)f(in)g(it)427 1440 y(\(e.g.)37 b(using)27
+(explicitly)i(stored)f(in)g(it)427 3618 y(\(e.g.)37 b(using)27
b(astPutCards,)f(astPutFits)i(or)e(via)h(the)h(SourceFile)f
-(attribute\).)259 1569 y Fd(sink)427 1668 y Fi(P)n(oin)n(ter)22
+(attribute\).)259 3756 y Fd(sink)427 3856 y Fi(P)n(oin)n(ter)22
b(to)g(a)h(sink)g(function)g(that)h(tak)n(es)e(a)g(p)r(oin)n(ter)h(to)f
(a)h(n)n(ull-terminated)g(string)f(as)g(an)h(argumen)n(t)f(and)427
-1768 y(returns)32 b(v)n(oid.)49 b(If)32 b(no)g(v)-5 b(alue)32
+3955 y(returns)32 b(v)n(oid.)49 b(If)32 b(no)g(v)-5 b(alue)32
b(has)f(b)r(een)i(set)f(for)f(the)h(SinkFile)h(attribute,)g(this)f
-(function)h(will)f(b)r(e)h(used)427 1868 y(b)n(y)c(the)h(FitsChan)f(to)
+(function)h(will)f(b)r(e)h(used)427 4055 y(b)n(y)c(the)h(FitsChan)f(to)
g(deliv)n(er)f(an)n(y)h(FITS)g(header)g(cards)f(it)h(con)n(tains)g
-(when)g(it)h(is)f(\014nally)g(deleted.)42 b(On)427 1967
+(when)g(it)h(is)f(\014nally)g(deleted.)42 b(On)427 4155
y(eac)n(h)28 b(in)n(v)n(o)r(cation,)f(it)i(should)f(deliv)n(er)f(the)i
(con)n(ten)n(ts)e(of)h(the)h(c)n(haracter)d(string)i(passed)f(to)h(it)h
-(as)e(a)h(FITS)427 2067 y(header)f(card)g(to)g(some)g(external)g(data)g
-(store)g(\(suc)n(h)g(as)g(a)g(FITS)h(\014le\).)427 2181
+(as)e(a)h(FITS)427 4254 y(header)f(card)g(to)g(some)g(external)g(data)g
+(store)g(\(suc)n(h)g(as)g(a)g(FITS)h(\014le\).)427 4373
y(If)i Ft(")p Fi(sink)p Ft(")f Fi(is)g(NULL,)h(and)f(no)g(v)-5
b(alue)30 b(has)f(b)r(een)h(set)f(for)g(the)h(SinkFile)g(attribute,)g
-(the)g(con)n(ten)n(ts)f(of)g(the)427 2281 y(FitsChan)f(will)g(b)r(e)g
-(lost)f(when)h(it)g(is)f(deleted.)259 2409 y Fd(options)427
-2509 y Fi(P)n(oin)n(ter)g(to)h(a)g(n)n(ull-terminated)g(string)f(con)n
+(the)g(con)n(ten)n(ts)f(of)g(the)427 4473 y(FitsChan)f(will)g(b)r(e)g
+(lost)f(when)h(it)g(is)f(deleted.)259 4611 y Fd(options)427
+4711 y Fi(P)n(oin)n(ter)g(to)h(a)g(n)n(ull-terminated)g(string)f(con)n
(taining)g(an)h(optional)g(comma-separated)e(list)i(of)g(attribute)427
-2609 y(assignmen)n(ts)23 b(to)h(b)r(e)g(used)g(for)f(initialising)h
+4810 y(assignmen)n(ts)23 b(to)h(b)r(e)g(used)g(for)f(initialising)h
(the)g(new)g(FitsChan.)36 b(The)24 b(syn)n(tax)f(used)h(is)g(iden)n
-(tical)g(to)f(that)427 2708 y(for)j(the)h(astSet)g(function)g(and)g(ma)
+(tical)g(to)f(that)427 4910 y(for)j(the)h(astSet)g(function)g(and)g(ma)
n(y)f(include)h Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r
(eci\014ers)g(iden)n(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p
-Ft(")g Fi(sym)n(b)r(ols)427 2808 y(in)i(the)g(normal)f(w)n(a)n(y)-7
-b(.)259 2936 y Fd(...)427 3036 y Fi(If)38 b(the)g Ft(")p
+Ft(")g Fi(sym)n(b)r(ols)427 5009 y(in)i(the)g(normal)f(w)n(a)n(y)-7
+b(.)259 5148 y Fd(...)427 5247 y Fi(If)38 b(the)g Ft(")p
Fi(options)p Ft(")e Fi(string)h(con)n(tains)f Ft(")p
Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g
-(list)h(of)f(additional)427 3136 y(argumen)n(ts)26 b(ma)n(y)h(follo)n
+(list)h(of)f(additional)427 5347 y(argumen)n(ts)26 b(ma)n(y)h(follo)n
(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5 b(alues)27
b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)37
-b(The)427 3235 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+b(The)427 5446 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 3335 y Fi(function\).)0
-3493 y Fd(Returned)32 b(V)-8 b(alue:)259 3625 y(astFitsChan\(\))427
-3724 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(FitsChan.)0
-3882 y Fd(Notes:)340 4160 y Fh(\017)45 b Fi(No)23 b(FITS)g
-Ft(")p Fi(END)p Ft(")g Fi(card)f(will)h(b)r(e)g(written)h(via)e(the)h
-(sink)g(function.)36 b(Y)-7 b(ou)23 b(should)g(add)f(this)i(card)e(y)n
-(ourself)427 4260 y(after)28 b(the)g(FitsChan)f(has)g(b)r(een)h
-(deleted.)340 4389 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 5546 y Fi(function\).)0
+5718 y Fd(Returned)32 b(V)-8 b(alue:)p eop end
+%%Page: 235 245
+TeXDict begin 235 244 bop 3643 52 a FF(235)259 351 y
+Fd(astFitsChan\(\))427 451 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g
+(FitsChan.)0 617 y Fd(Notes:)340 903 y Fh(\017)45 b Fi(No)23
+b(FITS)g Ft(")p Fi(END)p Ft(")g Fi(card)f(will)h(b)r(e)g(written)h(via)
+e(the)h(sink)g(function.)36 b(Y)-7 b(ou)23 b(should)g(add)f(this)i
+(card)e(y)n(ourself)427 1003 y(after)28 b(the)g(FitsChan)f(has)g(b)r
+(een)h(deleted.)340 1138 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 4488 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)-2 4646 y Fd(Status)33
-b(Handling)n(:)227 4792 y Fi(The)d(protected)g(in)n(terface)f(to)g
+427 1238 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)-2 1404 y Fd(Status)33
+b(Handling)n(:)227 1550 y Fi(The)d(protected)g(in)n(terface)f(to)g
(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
-(of)g(the)g(parameter)227 4892 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
+(of)g(the)g(parameter)227 1649 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
-Fi(in)n(t)227 4991 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p
-0 5182 3780 12 v 0 5314 a Fz(astFitsT)-11 b(able)693
+Fi(in)n(t)227 1749 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p
+0 1952 3780 12 v 0 2084 a Fz(astFitsT)-11 b(able)693
b Fe(Create)37 b(a)h(FitsT)-10 b(able)690 b Fz(astFitsT)-11
-b(able)0 5471 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f
+b(able)0 2254 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f
(a)g(new)g(FitsT)-7 b(able)28 b(and)f(optionally)g(initialises)g(its)h
-(attributes.)227 5593 y(The)33 b(FitsT)-7 b(able)33 b(class)e(is)i(a)f
+(attributes.)227 2380 y(The)33 b(FitsT)-7 b(able)33 b(class)e(is)i(a)f
(represen)n(tation)f(of)h(a)h(FITS)g(binary)e(table.)52
b(It)33 b(inherits)g(from)f(the)h(T)-7 b(able)32 b(class.)227
-5693 y(The)25 b(paren)n(t)f(T)-7 b(able)24 b(is)g(used)h(to)f(hold)h
+2480 y(The)25 b(paren)n(t)f(T)-7 b(able)24 b(is)g(used)h(to)f(hold)h
(the)f(binary)g(data)g(of)h(the)g(main)f(table,)h(and)g(a)f(FitsChan)g
-(is)h(used)f(to)h(hold)p eop end
-%%Page: 235 245
-TeXDict begin 235 244 bop 3643 52 a FF(235)227 351 y
-Fi(the)30 b(FITS)g(header.)42 b(Note,)30 b(there)f(is)g(no)g(pro)n
-(vision)f(for)h(binary)g(data)g(follo)n(wing)f(the)i(main)f(table)h
-(\(suc)n(h)f(data)227 451 y(is)f(referred)e(to)i(as)f(a)g
-Ft(")p Fi(heap)p Ft(")f Fi(in)i(the)g(FITS)g(standard\).)227
-584 y(Note)g(-)f(it)h(is)g(not)f(recommended)g(to)h(use)f(the)h(FitsT)
--7 b(able)28 b(class)f(to)g(store)g(v)n(ery)f(large)g(tables.)0
-751 y Fd(Synopsis:)121 b Ft(AstFitsTable)38 b Fh(\003)p
-Ft(astFitsTable\()g(AstFitsChan)h Fh(\003)p Ft(header,)h(const)i(char)g
-Fh(\003)p Ft(options,)e(...)86 b(\))0 918 y Fd(P)m(arameters:)259
-1072 y(header)427 1172 y Fi(P)n(oin)n(ter)22 b(to)g(an)h(optional)f
+(is)h(used)f(to)h(hold)227 2579 y(the)30 b(FITS)g(header.)42
+b(Note,)30 b(there)f(is)g(no)g(pro)n(vision)f(for)h(binary)g(data)g
+(follo)n(wing)f(the)i(main)f(table)h(\(suc)n(h)f(data)227
+2679 y(is)f(referred)e(to)i(as)f(a)g Ft(")p Fi(heap)p
+Ft(")f Fi(in)i(the)g(FITS)g(standard\).)227 2806 y(Note)g(-)f(it)h(is)g
+(not)f(recommended)g(to)h(use)f(the)h(FitsT)-7 b(able)28
+b(class)f(to)g(store)g(v)n(ery)f(large)g(tables.)0 2959
+y Fd(Synopsis:)121 b Ft(AstFitsTable)38 b Fh(\003)p Ft(astFitsTable\()g
+(AstFitsChan)h Fh(\003)p Ft(header,)h(const)i(char)g
+Fh(\003)p Ft(options,)e(...)86 b(\))0 3113 y Fd(P)m(arameters:)259
+3253 y(header)427 3353 y Fi(P)n(oin)n(ter)22 b(to)g(an)h(optional)f
(FitsChan)h(con)n(taining)f(headers)g(to)h(b)r(e)g(stored)f(in)h(the)h
-(FitsT)-7 b(able.)35 b(NULL)23 b(ma)n(y)427 1271 y(b)r(e)29
+(FitsT)-7 b(able.)35 b(NULL)23 b(ma)n(y)427 3453 y(b)r(e)29
b(supplied)g(if)g(the)g(new)g(FitsT)-7 b(able)29 b(is)f(to)h(b)r(e)g
(left)g(empt)n(y)-7 b(.)40 b(If)29 b(supplied,)h(and)e(if)h(the)g
-(headers)f(describ)r(e)427 1371 y(columns)23 b(of)g(a)g(FITS)g(binary)f
+(headers)f(describ)r(e)427 3552 y(columns)23 b(of)g(a)g(FITS)g(binary)f
(table,)i(then)g(equiv)-5 b(alen)n(t)23 b(\(empt)n(y\))g(columns)g(are)
-f(added)h(to)g(the)h(FitsT)-7 b(able.)427 1471 y(Eac)n(h)27
+f(added)h(to)g(the)h(FitsT)-7 b(able.)427 3652 y(Eac)n(h)27
b(column)g(has)g(the)h(same)f(index)h(in)g(the)g(FitsT)-7
b(able)27 b(that)h(it)g(has)f(in)h(the)g(supplied)g(header.)259
-1612 y Fd(options)427 1712 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n
+3787 y Fd(options)427 3886 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n
(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 1812 y(assignmen)n(ts)22
+(comma-separated)e(list)i(of)g(attribute)427 3986 y(assignmen)n(ts)22
b(to)i(b)r(e)g(used)f(for)g(initialising)g(the)h(new)f(FitsT)-7
b(able.)36 b(The)23 b(syn)n(tax)g(used)g(is)h(iden)n(tical)f(to)g(that)
-427 1911 y(for)j(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
+427 4086 y(for)j(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n
(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-2011 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 2152
-y Fd(...)427 2252 y Fi(If)38 b(the)g Ft(")p Fi(options)p
+4185 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 4320
+y Fd(...)427 4420 y Fi(If)38 b(the)g Ft(")p Fi(options)p
Ft(")e Fi(string)h(con)n(tains)f Ft(")p Fi(\045)p Ft(")h
Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g(list)h(of)f
-(additional)427 2352 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
+(additional)427 4519 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
(order)e(to)h(supply)h(v)-5 b(alues)27 b(to)g(b)r(e)h(substituted)h
-(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 2451 y(rules)25
+(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 4619 y(rules)25
b(for)f(supplying)h(these)g(are)f(iden)n(tical)h(to)g(those)g(for)f
(the)h(astSet)g(function)h(\(and)f(for)g(the)g(C)g Ft(")p
-Fi(prin)n(tf)p Ft(")427 2551 y Fi(function\).)0 2730
-y Fd(Returned)32 b(V)-8 b(alue:)259 2884 y(astFitsT)g(able\(\))427
-2984 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(FitsT)-7
-b(able.)0 3164 y Fd(Notes:)340 3464 y Fh(\017)45 b Fi(A)35
+Fi(prin)n(tf)p Ft(")427 4719 y Fi(function\).)0 4885
+y Fd(Returned)32 b(V)-8 b(alue:)259 5025 y(astFitsT)g(able\(\))427
+5125 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(FitsT)-7
+b(able.)0 5291 y Fd(Notes:)340 5577 y Fh(\017)45 b Fi(A)35
b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
-(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 3563 y(AST)28
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 5677 y(AST)28
b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)-2 3743 y Fd(Status)33 b(Handling)n(:)227 3889
-y Fi(The)d(protected)g(in)n(terface)f(to)g(this)h(function)h(includes)f
-(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g(the)g(parameter)227
-3988 y(list)37 b(describ)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37
-b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)e
-(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fi(in)n(t)227
-4088 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p 0 4305 3780
-12 v 0 4437 a Fz(astFluxF)-11 b(rame)569 b Fe(Create)38
+(reason.)p eop end
+%%Page: 236 246
+TeXDict begin 236 245 bop 0 52 a FF(236)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)-2 351 y Fd(Status)j(Handling)n(:)
+227 497 y Fi(The)d(protected)g(in)n(terface)f(to)g(this)h(function)h
+(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g(the)g
+(parameter)227 597 y(list)37 b(describ)r(ed)f(ab)r(o)n(v)n(e.)62
+b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)
+e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fi(in)n(t)227
+697 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p 0 880 3780
+12 v 0 1012 a Fz(astFluxF)-11 b(rame)569 b Fe(Create)38
b(a)g(FluxF)-10 b(rame)568 b Fz(astFluxF)-11 b(rame)0
-4620 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g
+1162 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g
(FluxF)-7 b(rame)28 b(and)f(optionally)g(initialises)g(its)h
-(attributes.)227 4753 y(A)c(FluxF)-7 b(rame)22 b(is)h(a)g(sp)r
+(attributes.)227 1283 y(A)c(FluxF)-7 b(rame)22 b(is)h(a)g(sp)r
(ecialised)f(form)h(of)g(one-dimensional)e(F)-7 b(rame)23
b(whic)n(h)g(represen)n(ts)e(v)-5 b(arious)22 b(systems)h(used)227
-4853 y(to)36 b(represen)n(t)f(the)h(signal)f(lev)n(el)g(in)i(an)e
+1383 y(to)36 b(represen)n(t)f(the)h(signal)f(lev)n(el)g(in)i(an)e
(observ)-5 b(ation.)61 b(The)36 b(particular)e(co)r(ordinate)h(system)h
-(to)g(b)r(e)g(used)g(is)227 4952 y(sp)r(eci\014ed)31
+(to)g(b)r(e)g(used)g(is)227 1482 y(sp)r(eci\014ed)31
b(b)n(y)f(setting)h(the)g(FluxF)-7 b(rame's)30 b(System)h(attribute)g
(quali\014ed,)g(as)f(necessary)-7 b(,)29 b(b)n(y)i(other)f(attributes)
-227 5052 y(suc)n(h)e(as)e(the)i(units,)h(etc)e(\(see)h(the)g
+227 1582 y(suc)n(h)e(as)e(the)i(units,)h(etc)e(\(see)h(the)g
(description)f(of)g(the)h(System)g(attribute)g(for)f(details\).)227
-5185 y(All)i(\015ux)f(v)-5 b(alues)28 b(are)f(assumed)g(to)h(b)r(e)h
+1703 y(All)i(\015ux)f(v)-5 b(alues)28 b(are)f(assumed)g(to)h(b)r(e)h
(measured)e(at)h(the)h(same)e(frequency)h(or)f(w)n(a)n(v)n(elength)f
-(\(as)i(giv)n(en)f(b)n(y)h(the)227 5285 y(Sp)r(ecV)-7
+(\(as)i(giv)n(en)f(b)n(y)h(the)227 1802 y(Sp)r(ecV)-7
b(al)28 b(attribute\).)38 b(Th)n(us)27 b(this)h(class)e(is)i(more)f
(appropriate)f(for)h(use)g(with)h(images)f(rather)f(than)i(sp)r(ectra.)
-0 5452 y Fd(Synopsis:)121 b Ft(AstFluxFrame)38 b Fh(\003)p
+0 1944 y Fd(Synopsis:)121 b Ft(AstFluxFrame)38 b Fh(\003)p
Ft(astFluxFrame\()g(double)j(specval,)g(AstSpecFrame)d
-Fh(\003)p Ft(specfrm,)i(const)i(char)227 5551 y Fh(\003)p
-Ft(options,)e(...)86 b(\))0 5718 y Fd(P)m(arameters:)p
-eop end
-%%Page: 236 246
-TeXDict begin 236 245 bop 0 52 a FF(236)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(sp)s(ecv)-5
-b(al)427 451 y Fi(The)37 b(sp)r(ectral)e(v)-5 b(alue)36
-b(to)g(whic)n(h)g(the)h(\015ux)f(v)-5 b(alues)36 b(refer,)i(giv)n(en)d
-(in)i(the)f(sp)r(ectral)g(co)r(ordinate)f(system)427
-551 y(sp)r(eci\014ed)28 b(b)n(y)e Ft(")p Fi(sp)r(ecfrm)p
+Fh(\003)p Ft(specfrm,)i(const)i(char)227 2044 y Fh(\003)p
+Ft(options,)e(...)86 b(\))0 2185 y Fd(P)m(arameters:)259
+2314 y(sp)s(ecv)-5 b(al)427 2414 y Fi(The)37 b(sp)r(ectral)e(v)-5
+b(alue)36 b(to)g(whic)n(h)g(the)h(\015ux)f(v)-5 b(alues)36
+b(refer,)i(giv)n(en)d(in)i(the)f(sp)r(ectral)g(co)r(ordinate)f(system)
+427 2513 y(sp)r(eci\014ed)28 b(b)n(y)e Ft(")p Fi(sp)r(ecfrm)p
Ft(")p Fi(.)36 b(The)28 b(v)-5 b(alue)27 b(supplied)g(for)g(the)g
Ft(")p Fi(sp)r(ecv)-5 b(al)p Ft(")26 b Fi(parameter)g(b)r(ecomes)h(the)
-g(default)427 650 y(v)-5 b(alue)39 b(for)f(the)h(Sp)r(ecV)-7
+g(default)427 2613 y(v)-5 b(alue)39 b(for)f(the)h(Sp)r(ecV)-7
b(al)39 b(attribute.)71 b(A)39 b(v)-5 b(alue)38 b(of)h(AST)p
Ft(__)p Fi(BAD)g(ma)n(y)f(b)r(e)h(supplied)g(if)g(the)g(sp)r(ectral)427
-750 y(p)r(osition)27 b(is)h(unkno)n(wn,)e(but)i(this)g(ma)n(y)e(result)
-h(in)h(it)g(not)f(b)r(eing)g(p)r(ossible)g(for)g(the)h(astCon)n(v)n
-(ert)d(function)427 849 y(to)j(determine)f(a)h(Mapping)f(b)r(et)n(w)n
-(een)g(the)h(new)g(FluxF)-7 b(rame)27 b(and)h(some)f(other)g(FluxF)-7
-b(rame.)259 983 y Fd(sp)s(ecfrm)427 1082 y Fi(A)30 b(p)r(oin)n(ter)g
-(to)f(a)g(Sp)r(ecF)-7 b(rame)30 b(describing)f(the)h(sp)r(ectral)f(co)r
-(ordinate)f(system)i(in)g(whic)n(h)g(the)g Ft(")p Fi(sp)r(ecv)-5
-b(al)p Ft(")427 1182 y Fi(parameter)32 b(is)g(giv)n(en.)52
-b(A)34 b(deep)f(cop)n(y)f(of)h(this)g(ob)5 b(ject)33
-b(is)f(tak)n(en,)i(so)e(an)n(y)g(subsequen)n(t)h(c)n(hanges)e(to)i(the)
-427 1282 y(Sp)r(ecF)-7 b(rame)32 b(using)g(the)g(supplied)g(p)r(oin)n
-(ter)g(will)g(ha)n(v)n(e)f(no)h(e\013ect)g(on)g(the)g(new)g(FluxF)-7
-b(rame.)50 b(A)32 b(NULL)427 1381 y(p)r(oin)n(ter)27
+2713 y(p)r(osition)27 b(is)h(unkno)n(wn,)e(but)i(this)g(ma)n(y)e
+(result)h(in)h(it)g(not)f(b)r(eing)g(p)r(ossible)g(for)g(the)h(astCon)n
+(v)n(ert)d(function)427 2812 y(to)j(determine)f(a)h(Mapping)f(b)r(et)n
+(w)n(een)g(the)h(new)g(FluxF)-7 b(rame)27 b(and)h(some)f(other)g(FluxF)
+-7 b(rame.)259 2937 y Fd(sp)s(ecfrm)427 3037 y Fi(A)30
+b(p)r(oin)n(ter)g(to)f(a)g(Sp)r(ecF)-7 b(rame)30 b(describing)f(the)h
+(sp)r(ectral)f(co)r(ordinate)f(system)i(in)g(whic)n(h)g(the)g
+Ft(")p Fi(sp)r(ecv)-5 b(al)p Ft(")427 3137 y Fi(parameter)32
+b(is)g(giv)n(en.)52 b(A)34 b(deep)f(cop)n(y)f(of)h(this)g(ob)5
+b(ject)33 b(is)f(tak)n(en,)i(so)e(an)n(y)g(subsequen)n(t)h(c)n(hanges)e
+(to)i(the)427 3236 y(Sp)r(ecF)-7 b(rame)32 b(using)g(the)g(supplied)g
+(p)r(oin)n(ter)g(will)g(ha)n(v)n(e)f(no)h(e\013ect)g(on)g(the)g(new)g
+(FluxF)-7 b(rame.)50 b(A)32 b(NULL)427 3336 y(p)r(oin)n(ter)27
b(can)h(b)r(e)g(supplied)g(if)g(AST)p Ft(__)p Fi(BAD)f(is)h(supplied)g
-(for)f Ft(")p Fi(sp)r(ecv)-5 b(al)p Ft(")p Fi(.)259 1514
-y Fd(options)427 1614 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n
+(for)f Ft(")p Fi(sp)r(ecv)-5 b(al)p Ft(")p Fi(.)259 3461
+y Fd(options)427 3561 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n
(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 1714 y(assignmen)n(ts)19
+(comma-separated)e(list)i(of)g(attribute)427 3660 y(assignmen)n(ts)19
b(to)h(b)r(e)g(used)g(for)f(initialising)h(the)g(new)g(FluxF)-7
b(rame.)34 b(The)20 b(syn)n(tax)e(used)i(is)g(iden)n(tical)g(to)f(that)
-427 1813 y(for)26 b(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
+427 3760 y(for)26 b(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n
(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-1913 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)35 b(If)28
+3860 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)35 b(If)28
b(no)g(initialisation)f(is)g(required,)g(a)g(zero-length)f(string)h(ma)
-n(y)g(b)r(e)h(supplied.)259 2046 y Fd(...)427 2146 y
+n(y)g(b)r(e)h(supplied.)259 3985 y Fd(...)427 4084 y
Fi(If)38 b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n(tains)f
Ft(")p Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f
-(optional)g(list)h(of)f(additional)427 2245 y(argumen)n(ts)26
+(optional)g(list)h(of)f(additional)427 4184 y(argumen)n(ts)26
b(ma)n(y)h(follo)n(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5
b(alues)27 b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)
-37 b(The)427 2345 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+37 b(The)427 4284 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 2445 y Fi(function\).)0
-2607 y Fd(Returned)32 b(V)-8 b(alue:)259 2745 y(astFluxF)g(rame\(\))427
-2844 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(FluxF)-7
-b(rame.)0 3007 y Fd(Notes:)340 3290 y Fh(\017)45 b Fi(When)34
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 4383 y Fi(function\).)0
+4537 y Fd(Returned)32 b(V)-8 b(alue:)259 4666 y(astFluxF)g(rame\(\))427
+4766 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(FluxF)-7
+b(rame.)0 4920 y Fd(Notes:)340 5195 y Fh(\017)45 b Fi(When)34
b(con)n(v)n(ersion)d(b)r(et)n(w)n(een)i(t)n(w)n(o)g(FluxF)-7
b(rames)32 b(is)h(requested)g(\(as)g(when)g(supplying)g(FluxF)-7
-b(rames)33 b(to)427 3390 y(astCon)n(v)n(ert\),)21 b(accoun)n(t)g(will)g
+b(rames)33 b(to)427 5295 y(astCon)n(v)n(ert\),)21 b(accoun)n(t)g(will)g
(b)r(e)h(tak)n(en)e(of)i(the)f(nature)g(of)g(the)h(\015ux)f(co)r
-(ordinate)g(systems)f(they)i(represen)n(t,)427 3490 y(together)40
+(ordinate)g(systems)f(they)i(represen)n(t,)427 5394 y(together)40
b(with)h(an)n(y)f(qualifying)g(attribute)h(v)-5 b(alues,)43
b(including)e(the)g(AlignSystem)g(attribute.)76 b(The)427
-3589 y(results)39 b(will)h(therefore)e(fully)i(re\015ect)f(the)g
+5494 y(results)39 b(will)h(therefore)e(fully)i(re\015ect)f(the)g
(relationship)g(b)r(et)n(w)n(een)g(p)r(ositions)g(measured)f(in)i(the)f
-(t)n(w)n(o)427 3689 y(systems.)55 b(In)33 b(addition,)i(an)n(y)e
+(t)n(w)n(o)427 5593 y(systems.)55 b(In)33 b(addition,)i(an)n(y)e
(di\013erence)h(in)g(the)g(Unit)g(attributes)f(of)h(the)g(t)n(w)n(o)f
-(systems)g(will)h(also)e(b)r(e)427 3788 y(tak)n(en)27
-b(in)n(to)h(accoun)n(t.)340 3922 y Fh(\017)45 b Fi(A)35
-b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
-Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
-(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 4021 y(AST)28
-b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)p 0 4221 3780 12 v 0 4352 a Fz(astF)-11 b(ormat)779
-4353 y Fe(F)h(ormat)37 b(a)i(co)s(ordinate)d(v)-7 b(alue)39
-b(for)f(a)g(F)-10 b(rame)39 b(axis)3184 4352 y Fz(astF)-11
-b(ormat)0 4524 y Fd(Description:)44 b Fi(This)32 b(function)g(returns)g
-(a)f(p)r(oin)n(ter)g(to)h(a)f(string)g(con)n(taining)g(the)h(formatted)
-g(\(c)n(haracter\))e(v)n(ersion)227 4624 y(of)38 b(a)g(co)r(ordinate)f
-(v)-5 b(alue)38 b(for)g(a)g(F)-7 b(rame)37 b(axis.)68
-b(The)39 b(formatting)e(applied)h(is)g(determined)h(b)n(y)f(the)g(F)-7
-b(rame's)227 4723 y(attributes)36 b(and,)h(in)e(particular,)h(b)n(y)f
-(an)n(y)g(F)-7 b(ormat)35 b(attribute)g(string)g(that)g(has)g(b)r(een)h
-(set)f(for)g(the)h(axis.)59 b(A)227 4823 y(suitable)28
-b(default)g(format)f(\(based)g(on)h(the)g(Digits)f(attribute)h(v)-5
-b(alue\))28 b(will)g(b)r(e)g(applied)f(if)h(necessary)-7
-b(.)0 4973 y Fd(Synopsis:)121 b Ft(const)41 b(char)h
-Fh(\003)p Ft(astFormat\()d(AstFrame)i Fh(\003)p Ft(this,)g(int)h(axis,)
-f(double)h(value)f(\))0 5124 y Fd(P)m(arameters:)259
-5261 y(this)427 5361 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
-b(rame.)259 5494 y Fd(axis)427 5593 y Fi(The)23 b(n)n(um)n(b)r(er)g(of)
-f(the)h(F)-7 b(rame)22 b(axis)g(for)h(whic)n(h)f(formatting)g(is)h(to)g
-(b)r(e)g(p)r(erformed)f(\(axis)g(n)n(um)n(b)r(ering)g(starts)427
-5693 y(at)28 b(1)f(for)g(the)h(\014rst)f(axis\).)p eop
-end
+(systems)g(will)h(also)e(b)r(e)427 5693 y(tak)n(en)27
+b(in)n(to)h(accoun)n(t.)p eop end
%%Page: 237 247
-TeXDict begin 237 246 bop 3643 52 a FF(237)259 351 y
-Fd(v)-5 b(alue)427 451 y Fi(The)28 b(co)r(ordinate)e(v)-5
-b(alue)28 b(to)f(b)r(e)h(formatted.)0 622 y Fd(Returned)k(V)-8
-b(alue:)259 767 y(astF)g(ormat\(\))427 866 y Fi(A)28
+TeXDict begin 237 246 bop 3643 52 a FF(237)340 351 y
+Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g
+(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g
+(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 451
+y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f
+(an)n(y)g(reason.)p 0 662 3780 12 v 0 793 a Fz(astF)-11
+b(ormat)779 794 y Fe(F)h(ormat)37 b(a)i(co)s(ordinate)d(v)-7
+b(alue)39 b(for)f(a)g(F)-10 b(rame)39 b(axis)3184 793
+y Fz(astF)-11 b(ormat)0 976 y Fd(Description:)44 b Fi(This)32
+b(function)g(returns)g(a)f(p)r(oin)n(ter)g(to)h(a)f(string)g(con)n
+(taining)g(the)h(formatted)g(\(c)n(haracter\))e(v)n(ersion)227
+1075 y(of)38 b(a)g(co)r(ordinate)f(v)-5 b(alue)38 b(for)g(a)g(F)-7
+b(rame)37 b(axis.)68 b(The)39 b(formatting)e(applied)h(is)g(determined)
+h(b)n(y)f(the)g(F)-7 b(rame's)227 1175 y(attributes)36
+b(and,)h(in)e(particular,)h(b)n(y)f(an)n(y)g(F)-7 b(ormat)35
+b(attribute)g(string)g(that)g(has)g(b)r(een)h(set)f(for)g(the)h(axis.)
+59 b(A)227 1275 y(suitable)28 b(default)g(format)f(\(based)g(on)h(the)g
+(Digits)f(attribute)h(v)-5 b(alue\))28 b(will)g(b)r(e)g(applied)f(if)h
+(necessary)-7 b(.)0 1436 y Fd(Synopsis:)121 b Ft(const)41
+b(char)h Fh(\003)p Ft(astFormat\()d(AstFrame)i Fh(\003)p
+Ft(this,)g(int)h(axis,)f(double)h(value)f(\))0 1597 y
+Fd(P)m(arameters:)259 1745 y(this)427 1845 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(F)-7 b(rame.)259 1984 y Fd(axis)427 2083
+y Fi(The)23 b(n)n(um)n(b)r(er)g(of)f(the)h(F)-7 b(rame)22
+b(axis)g(for)h(whic)n(h)f(formatting)g(is)h(to)g(b)r(e)g(p)r(erformed)f
+(\(axis)g(n)n(um)n(b)r(ering)g(starts)427 2183 y(at)28
+b(1)f(for)g(the)h(\014rst)f(axis\).)259 2322 y Fd(v)-5
+b(alue)427 2421 y Fi(The)28 b(co)r(ordinate)e(v)-5 b(alue)28
+b(to)f(b)r(e)h(formatted.)0 2595 y Fd(Returned)k(V)-8
+b(alue:)259 2743 y(astF)g(ormat\(\))427 2843 y Fi(A)28
b(p)r(oin)n(ter)f(to)h(a)f(n)n(ull-terminated)g(string)g(con)n(taining)
-g(the)h(formatted)f(v)-5 b(alue.)0 1037 y Fd(Notes:)340
-1329 y Fh(\017)45 b Fi(The)36 b(returned)g(p)r(oin)n(ter)g(is)g(guaran)
+g(the)h(formatted)f(v)-5 b(alue.)0 3017 y Fd(Notes:)340
+3311 y Fh(\017)45 b Fi(The)36 b(returned)g(p)r(oin)n(ter)g(is)g(guaran)
n(teed)e(to)i(remain)g(v)-5 b(alid)36 b(and)g(the)g(string)g(to)g(whic)
-n(h)g(it)g(p)r(oin)n(ts)g(will)427 1428 y(not)c(b)r(e)g(o)n(v)n
+n(h)g(it)g(p)r(oin)n(ts)g(will)427 3411 y(not)c(b)r(e)g(o)n(v)n
(er-written)e(for)i(a)f(total)h(of)g(50)f(successiv)n(e)f(in)n(v)n(o)r
(cations)g(of)i(this)g(function.)51 b(After)32 b(this,)h(the)427
-1528 y(memory)27 b(con)n(taining)f(the)i(string)f(ma)n(y)f(b)r(e)i
+3510 y(memory)27 b(con)n(taining)f(the)i(string)f(ma)n(y)f(b)r(e)i
(re-used,)e(so)h(a)g(cop)n(y)f(of)i(the)f(string)g(should)g(b)r(e)h
-(made)f(if)h(it)g(is)427 1627 y(needed)g(for)f(longer)f(than)i(this.)
-340 1765 y Fh(\017)45 b Fi(A)23 b(formatted)g(v)-5 b(alue)23
+(made)f(if)h(it)g(is)427 3610 y(needed)g(for)f(longer)f(than)i(this.)
+340 3749 y Fh(\017)45 b Fi(A)23 b(formatted)g(v)-5 b(alue)23
b(ma)n(y)f(b)r(e)h(con)n(v)n(erted)e(bac)n(k)h(in)n(to)h(a)f(n)n
(umerical)g(\(double\))h(v)-5 b(alue)23 b(using)f(astUnformat.)340
-1902 y Fh(\017)45 b Fi(A)26 b(NULL)g(p)r(oin)n(ter)e(will)i(b)r(e)f
+3888 y Fh(\017)45 b Fi(A)26 b(NULL)g(p)r(oin)n(ter)e(will)i(b)r(e)f
(returned)g(if)h(this)g(function)f(is)h(in)n(v)n(ok)n(ed)d(with)j(the)g
-(AST)f(error)f(status)h(set,)g(or)427 2002 y(if)j(it)g(should)g(fail)f
-(for)h(an)n(y)e(reason.)p 0 2210 3780 12 v 0 2340 a Fz(astF)-11
+(AST)f(error)f(status)h(set,)g(or)427 3987 y(if)j(it)g(should)g(fail)f
+(for)h(an)n(y)e(reason.)p 0 4198 V 0 4329 a Fz(astF)-11
b(rame)955 b Fe(Create)37 b(a)i(F)-10 b(rame)954 b Fz(astF)-11
-b(rame)0 2515 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f
+b(rame)0 4506 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f
(a)g(new)g(F)-7 b(rame)27 b(and)h(optionally)f(initialises)g(its)h
-(attributes.)227 2644 y(A)c(F)-7 b(rame)24 b(is)f(used)h(to)g(represen)
+(attributes.)227 4637 y(A)c(F)-7 b(rame)24 b(is)f(used)h(to)g(represen)
n(t)e(a)i(co)r(ordinate)e(system.)35 b(It)25 b(do)r(es)e(this)h(in)g
(rather)f(the)h(same)f(w)n(a)n(y)g(that)h(a)f(frame)227
-2743 y(around)29 b(a)g(graph)f(describ)r(es)h(the)h(co)r(ordinate)e
+4736 y(around)29 b(a)g(graph)f(describ)r(es)h(the)h(co)r(ordinate)e
(space)h(in)h(whic)n(h)f(data)g(are)g(plotted.)43 b(Consequen)n(tly)-7
-b(,)29 b(a)g(F)-7 b(rame)227 2843 y(has)34 b(a)f(Title)i(\(string\))f
+b(,)29 b(a)g(F)-7 b(rame)227 4836 y(has)34 b(a)f(Title)i(\(string\))f
(attribute,)i(whic)n(h)e(describ)r(es)f(the)h(co)r(ordinate)f(space,)i
-(and)f(con)n(tains)f(axes)g(whic)n(h)h(in)227 2943 y(turn)26
+(and)f(con)n(tains)f(axes)g(whic)n(h)h(in)227 4936 y(turn)26
b(hold)g(information)f(suc)n(h)h(as)f(Lab)r(el)g(and)h(Units)h(strings)
d(whic)n(h)i(are)f(used)h(for)f(lab)r(elling)h(\(e.g.\))36
-b(graphical)227 3042 y(output.)i(In)27 b(general,)g(ho)n(w)n(ev)n(er,)e
+b(graphical)227 5035 y(output.)i(In)27 b(general,)g(ho)n(w)n(ev)n(er,)e
(the)j(n)n(um)n(b)r(er)g(of)f(axes)g(is)g(not)h(restricted)f(to)g(t)n
-(w)n(o.)227 3171 y(F)-7 b(unctions)24 b(are)f(a)n(v)-5
+(w)n(o.)227 5166 y(F)-7 b(unctions)24 b(are)f(a)n(v)-5
b(ailable)23 b(for)g(con)n(v)n(erting)f(F)-7 b(rame)24
b(co)r(ordinate)e(v)-5 b(alues)24 b(in)n(to)g(a)f(form)h(suitable)f
-(for)h(displa)n(y)-7 b(,)24 b(and)227 3271 y(also)j(for)g(calculating)g
+(for)h(displa)n(y)-7 b(,)24 b(and)227 5265 y(also)j(for)g(calculating)g
(distances)g(and)g(o\013sets)g(b)r(et)n(w)n(een)h(p)r(ositions)f
-(within)h(the)g(F)-7 b(rame.)227 3400 y(F)g(rames)27
+(within)h(the)g(F)-7 b(rame.)227 5396 y(F)g(rames)27
b(ma)n(y)g(also)f(con)n(tain)h(kno)n(wledge)g(of)g(ho)n(w)g(to)h
(transform)e(to)i(and)f(from)g(related)g(co)r(ordinate)g(systems.)0
-3558 y Fd(Synopsis:)121 b Ft(AstFrame)40 b Fh(\003)p
+5557 y Fd(Synopsis:)121 b Ft(AstFrame)40 b Fh(\003)p
Ft(astFrame\()g(int)i(naxes,)f(const)g(char)h Fh(\003)p
-Ft(options,)e(...)86 b(\))0 3716 y Fd(P)m(arameters:)259
-3861 y(naxes)427 3961 y Fi(The)27 b(n)n(um)n(b)r(er)f(of)h(F)-7
-b(rame)26 b(axes)g(\(i.e.)37 b(the)27 b(n)n(um)n(b)r(er)f(of)h
-(dimensions)f(of)g(the)h(co)r(ordinate)f(space)g(whic)n(h)g(the)427
-4061 y(F)-7 b(rame)27 b(describ)r(es\).)259 4198 y Fd(options)427
-4298 y Fi(P)n(oin)n(ter)g(to)h(a)g(n)n(ull-terminated)g(string)f(con)n
+Ft(options,)e(...)86 b(\))0 5718 y Fd(P)m(arameters:)p
+eop end
+%%Page: 238 248
+TeXDict begin 238 247 bop 0 52 a FF(238)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(naxes)427
+451 y Fi(The)d(n)n(um)n(b)r(er)f(of)h(F)-7 b(rame)26
+b(axes)g(\(i.e.)37 b(the)27 b(n)n(um)n(b)r(er)f(of)h(dimensions)f(of)g
+(the)h(co)r(ordinate)f(space)g(whic)n(h)g(the)427 551
+y(F)-7 b(rame)27 b(describ)r(es\).)259 678 y Fd(options)427
+778 y Fi(P)n(oin)n(ter)g(to)h(a)g(n)n(ull-terminated)g(string)f(con)n
(taining)g(an)h(optional)g(comma-separated)e(list)i(of)g(attribute)427
-4397 y(assignmen)n(ts)i(to)h(b)r(e)g(used)g(for)f(initialising)h(the)g
+877 y(assignmen)n(ts)i(to)h(b)r(e)g(used)g(for)f(initialising)h(the)g
(new)g(F)-7 b(rame.)46 b(The)31 b(syn)n(tax)f(used)h(is)g(iden)n(tical)
-g(to)f(that)427 4497 y(for)c(the)h(astSet)g(function)g(and)g(ma)n(y)f
+g(to)f(that)427 977 y(for)c(the)h(astSet)g(function)g(and)g(ma)n(y)f
(include)h Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g
(iden)n(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-4596 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)35 b(If)28
+1077 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)35 b(If)28
b(no)g(initialisation)f(is)g(required,)g(a)g(zero-length)f(string)h(ma)
-n(y)g(b)r(e)h(supplied.)259 4734 y Fd(...)427 4833 y
+n(y)g(b)r(e)h(supplied.)259 1204 y Fd(...)427 1304 y
Fi(If)38 b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n(tains)f
Ft(")p Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f
-(optional)g(list)h(of)f(additional)427 4933 y(argumen)n(ts)26
+(optional)g(list)h(of)f(additional)427 1403 y(argumen)n(ts)26
b(ma)n(y)h(follo)n(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5
b(alues)27 b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)
-37 b(The)427 5033 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+37 b(The)427 1503 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 5132 y Fi(function\).)0
-5303 y Fd(Returned)32 b(V)-8 b(alue:)259 5448 y(astF)g(rame\(\))427
-5548 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(F)-7
-b(rame.)0 5718 y Fd(Examples:)p eop end
-%%Page: 238 248
-TeXDict begin 238 247 bop 0 52 a FF(238)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)227 352 y Fp(frame)47
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 1603 y Fi(function\).)0
+1759 y Fd(Returned)32 b(V)-8 b(alue:)259 1890 y(astF)g(rame\(\))427
+1990 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(F)-7
+b(rame.)0 2146 y Fd(Examples:)227 2278 y Fp(frame)47
b(=)g(astFrame\()e(2,)j Ft(")p Fp(Title=Energy)c(Spectrum:)93
-b(Plot)46 b(\045d)p Ft(")p Fp(,)h(n)g(\);)427 451 y Fi(Creates)31
-b(a)g(new)h(2-dimensional)e(F)-7 b(rame)31 b(and)h(initialises)f(its)h
-(Title)g(attribute)g(to)g(the)g(string)f Ft(")p Fi(Energy)427
-551 y(Sp)r(ectrum:)38 b(Plot)27 b Fk(<)p Fi(n)p Fk(>)p
-Ft(")p Fi(,)f(where)h Fk(<)p Fi(n)p Fk(>)g Fi(tak)n(es)g(the)h(v)-5
-b(alue)27 b(of)h(the)g(in)n(t)g(v)-5 b(ariable)26 b Ft(")p
-Fi(n)p Ft(")p Fi(.)227 694 y Fp(frame)47 b(=)g(astFrame\()e(2,)j
-Ft(")p Fp(Label\(1\)=Energy,)42 b(Label\(2\)=Response)p
-Ft(")h Fp(\);)427 792 y Fi(Creates)26 b(a)g(new)h(2-dimensional)e(F)-7
-b(rame)26 b(and)g(initialises)h(its)f(axis)g(Lab)r(el)h(attributes)f
-(to)h(suitable)f(string)427 892 y(v)-5 b(alues.)0 1073
-y Fd(Notes:)340 1374 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
-b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
-(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 1474 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 1692 3780 12 v 0 1822
-a Fz(astF)-11 b(rameSet)686 b Fe(Create)37 b(a)i(F)-10
-b(rameSet)683 b Fz(astF)-11 b(rameSet)0 2007 y Fd(Description:)44
-b Fi(This)28 b(function)g(creates)f(a)g(new)g(F)-7 b(rameSet)28
-b(and)f(optionally)g(initialises)g(its)h(attributes.)227
-2141 y(A)23 b(F)-7 b(rameSet)23 b(consists)e(of)i(a)f(set)h(of)f(one)h
-(or)e(more)h(F)-7 b(rames)22 b(\(whic)n(h)h(describ)r(e)f(co)r
-(ordinate)f(systems\),)j(connected)227 2240 y(together)j(b)n(y)g
-(Mappings)f(\(whic)n(h)i(describ)r(e)e(ho)n(w)h(the)h(co)r(ordinate)e
-(systems)g(are)h(in)n(ter-related\).)35 b(A)28 b(F)-7
-b(rameSet)227 2340 y(mak)n(es)28 b(it)i(p)r(ossible)e(to)h(obtain)g(a)f
-(Mapping)h(b)r(et)n(w)n(een)g(an)n(y)f(pair)g(of)h(these)g(F)-7
-b(rames)28 b(\(i.e.)41 b(to)29 b(con)n(v)n(ert)f(b)r(et)n(w)n(een)227
-2440 y(an)n(y)e(of)g(the)g(co)r(ordinate)f(systems)h(whic)n(h)g(it)g
-(describ)r(es\).)36 b(The)26 b(individual)h(F)-7 b(rames)25
-b(are)g(iden)n(ti\014ed)h(within)h(the)227 2539 y(F)-7
-b(rameSet)34 b(b)n(y)g(an)f(in)n(teger)g(index,)j(with)e(F)-7
-b(rames)34 b(b)r(eing)g(n)n(um)n(b)r(ered)f(consecutiv)n(ely)g(from)h
-(one)f(as)g(they)i(are)227 2639 y(added)28 b(to)f(the)h(F)-7
-b(rameSet.)227 2773 y(Ev)n(ery)29 b(F)-7 b(rameSet)30
-b(has)f(a)h Ft(")p Fi(base)p Ft(")e Fi(F)-7 b(rame)30
-b(and)g(a)g Ft(")p Fi(curren)n(t)p Ft(")e Fi(F)-7 b(rame)30
-b(\(whic)n(h)g(are)f(allo)n(w)n(ed)g(to)h(b)r(e)g(the)h(same\).)227
-2872 y(An)n(y)k(of)g(the)g(F)-7 b(rames)35 b(ma)n(y)f(b)r(e)h
-(nominated)g(to)g(hold)f(these)h(p)r(ositions,)i(and)e(the)g(c)n(hoice)
-f(is)h(determined)g(b)n(y)227 2972 y(the)d(v)-5 b(alues)31
-b(of)h(the)g(F)-7 b(rameSet's)31 b(Base)f(and)i(Curren)n(t)e
-(attributes,)j(whic)n(h)e(hold)h(the)f(indices)h(of)f(the)h(relev)-5
-b(an)n(t)227 3072 y(F)e(rames.)35 b(By)25 b(default,)h(the)f(\014rst)f
-(F)-7 b(rame)25 b(added)f(to)h(a)f(F)-7 b(rameSet)25
-b(is)f(its)h(base)f(F)-7 b(rame,)25 b(and)g(the)g(last)f(one)h(added)
-227 3171 y(is)j(its)g(curren)n(t)e(F)-7 b(rame.)227 3305
-y(The)36 b(base)f(F)-7 b(rame)35 b(describ)r(es)h(the)g
-Ft(")p Fi(nativ)n(e)p Ft(")e Fi(co)r(ordinate)h(system)g(of)h(whatev)n
-(er)f(the)h(F)-7 b(rameSet)35 b(is)h(used)g(to)227 3405
-y(calibrate)27 b(\(e.g.)36 b(the)28 b(pixel)f(co)r(ordinates)f(of)i(an)
-f(image\))g(and)g(the)h(curren)n(t)e(F)-7 b(rame)27 b(describ)r(es)g
-(the)h Ft(")p Fi(apparen)n(t)p Ft(")227 3504 y Fi(co)r(ordinate)21
+b(Plot)46 b(\045d)p Ft(")p Fp(,)h(n)g(\);)427 2377 y
+Fi(Creates)31 b(a)g(new)h(2-dimensional)e(F)-7 b(rame)31
+b(and)h(initialises)f(its)h(Title)g(attribute)g(to)g(the)g(string)f
+Ft(")p Fi(Energy)427 2477 y(Sp)r(ectrum:)38 b(Plot)27
+b Fk(<)p Fi(n)p Fk(>)p Ft(")p Fi(,)f(where)h Fk(<)p Fi(n)p
+Fk(>)g Fi(tak)n(es)g(the)h(v)-5 b(alue)27 b(of)h(the)g(in)n(t)g(v)-5
+b(ariable)26 b Ft(")p Fi(n)p Ft(")p Fi(.)227 2605 y Fp(frame)47
+b(=)g(astFrame\()e(2,)j Ft(")p Fp(Label\(1\)=Energy,)42
+b(Label\(2\)=Response)p Ft(")h Fp(\);)427 2704 y Fi(Creates)26
+b(a)g(new)h(2-dimensional)e(F)-7 b(rame)26 b(and)g(initialises)h(its)f
+(axis)g(Lab)r(el)h(attributes)f(to)h(suitable)f(string)427
+2803 y(v)-5 b(alues.)0 2960 y Fd(Notes:)340 3237 y Fh(\017)45
+b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
+Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 3337 y(AST)28
+b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
+(reason.)p 0 3525 3780 12 v 0 3656 a Fz(astF)-11 b(rameSet)686
+b Fe(Create)37 b(a)i(F)-10 b(rameSet)683 b Fz(astF)-11
+b(rameSet)0 3811 y Fd(Description:)44 b Fi(This)28 b(function)g
+(creates)f(a)g(new)g(F)-7 b(rameSet)28 b(and)f(optionally)g
+(initialises)g(its)h(attributes.)227 3933 y(A)23 b(F)-7
+b(rameSet)23 b(consists)e(of)i(a)f(set)h(of)f(one)h(or)e(more)h(F)-7
+b(rames)22 b(\(whic)n(h)h(describ)r(e)f(co)r(ordinate)f(systems\),)j
+(connected)227 4032 y(together)j(b)n(y)g(Mappings)f(\(whic)n(h)i
+(describ)r(e)e(ho)n(w)h(the)h(co)r(ordinate)e(systems)g(are)h(in)n
+(ter-related\).)35 b(A)28 b(F)-7 b(rameSet)227 4132 y(mak)n(es)28
+b(it)i(p)r(ossible)e(to)h(obtain)g(a)f(Mapping)h(b)r(et)n(w)n(een)g(an)
+n(y)f(pair)g(of)h(these)g(F)-7 b(rames)28 b(\(i.e.)41
+b(to)29 b(con)n(v)n(ert)f(b)r(et)n(w)n(een)227 4232 y(an)n(y)e(of)g
+(the)g(co)r(ordinate)f(systems)h(whic)n(h)g(it)g(describ)r(es\).)36
+b(The)26 b(individual)h(F)-7 b(rames)25 b(are)g(iden)n(ti\014ed)h
+(within)h(the)227 4331 y(F)-7 b(rameSet)34 b(b)n(y)g(an)f(in)n(teger)g
+(index,)j(with)e(F)-7 b(rames)34 b(b)r(eing)g(n)n(um)n(b)r(ered)f
+(consecutiv)n(ely)g(from)h(one)f(as)g(they)i(are)227
+4431 y(added)28 b(to)f(the)h(F)-7 b(rameSet.)227 4553
+y(Ev)n(ery)29 b(F)-7 b(rameSet)30 b(has)f(a)h Ft(")p
+Fi(base)p Ft(")e Fi(F)-7 b(rame)30 b(and)g(a)g Ft(")p
+Fi(curren)n(t)p Ft(")e Fi(F)-7 b(rame)30 b(\(whic)n(h)g(are)f(allo)n(w)
+n(ed)g(to)h(b)r(e)g(the)h(same\).)227 4652 y(An)n(y)k(of)g(the)g(F)-7
+b(rames)35 b(ma)n(y)f(b)r(e)h(nominated)g(to)g(hold)f(these)h(p)r
+(ositions,)i(and)e(the)g(c)n(hoice)f(is)h(determined)g(b)n(y)227
+4752 y(the)d(v)-5 b(alues)31 b(of)h(the)g(F)-7 b(rameSet's)31
+b(Base)f(and)i(Curren)n(t)e(attributes,)j(whic)n(h)e(hold)h(the)f
+(indices)h(of)f(the)h(relev)-5 b(an)n(t)227 4852 y(F)e(rames.)35
+b(By)25 b(default,)h(the)f(\014rst)f(F)-7 b(rame)25 b(added)f(to)h(a)f
+(F)-7 b(rameSet)25 b(is)f(its)h(base)f(F)-7 b(rame,)25
+b(and)g(the)g(last)f(one)h(added)227 4951 y(is)j(its)g(curren)n(t)e(F)
+-7 b(rame.)227 5073 y(The)36 b(base)f(F)-7 b(rame)35
+b(describ)r(es)h(the)g Ft(")p Fi(nativ)n(e)p Ft(")e Fi(co)r(ordinate)h
+(system)g(of)h(whatev)n(er)f(the)h(F)-7 b(rameSet)35
+b(is)h(used)g(to)227 5173 y(calibrate)27 b(\(e.g.)36
+b(the)28 b(pixel)f(co)r(ordinates)f(of)i(an)f(image\))g(and)g(the)h
+(curren)n(t)e(F)-7 b(rame)27 b(describ)r(es)g(the)h Ft(")p
+Fi(apparen)n(t)p Ft(")227 5272 y Fi(co)r(ordinate)21
b(system)g(in)h(whic)n(h)g(it)g(should)f(b)r(e)h(view)n(ed)g(\(e.g.)34
b(displa)n(y)n(ed,)22 b(etc.\).)36 b(An)n(y)21 b(further)h(F)-7
-b(rames)21 b(represen)n(t)227 3604 y(a)27 b(library)g(of)g(alternativ)n
+b(rames)21 b(represen)n(t)227 5372 y(a)27 b(library)g(of)g(alternativ)n
(e)g(co)r(ordinate)f(systems,)h(whic)n(h)h(ma)n(y)f(b)r(e)h(selected)f
-(b)n(y)g(making)g(them)h(curren)n(t.)227 3738 y(When)34
+(b)n(y)g(making)g(them)h(curren)n(t.)227 5494 y(When)34
b(a)e(F)-7 b(rameSet)33 b(is)g(used)g(in)g(a)f(con)n(text)h(that)g
(requires)f(a)g(F)-7 b(rame,)34 b(\(e.g.)53 b(obtaining)32
-b(its)h(Title)g(v)-5 b(alue,)34 b(or)227 3838 y(n)n(um)n(b)r(er)h(of)g
+b(its)h(Title)g(v)-5 b(alue,)34 b(or)227 5593 y(n)n(um)n(b)r(er)h(of)g
(axes\),)h(the)g(curren)n(t)e(F)-7 b(rame)34 b(is)h(used.)59
b(A)35 b(F)-7 b(rameSet)35 b(ma)n(y)f(therefore)g(b)r(e)i(used)f(in)g
-(place)f(of)h(its)227 3937 y(curren)n(t)27 b(F)-7 b(rame)27
-b(in)h(most)f(situations.)227 4071 y(When)38 b(a)g(F)-7
-b(rameSet)37 b(is)g(used)h(in)g(a)f(con)n(text)g(that)h(requires)e(a)h
-(Mapping,)j(the)e(Mapping)f(used)h(is)f(the)h(one)227
-4171 y(b)r(et)n(w)n(een)25 b(its)h(base)e(F)-7 b(rame)25
-b(and)g(its)h(curren)n(t)e(F)-7 b(rame.)35 b(Th)n(us,)26
-b(a)f(F)-7 b(rameSet)25 b(ma)n(y)f(b)r(e)i(used)f(to)g(con)n(v)n(ert)f
-Ft(")p Fi(nativ)n(e)p Ft(")227 4270 y Fi(co)r(ordinates)35
-b(in)n(to)h Ft(")p Fi(apparen)n(t)p Ft(")f Fi(ones,)i(and)g(vice)f(v)n
-(ersa.)61 b(Lik)n(e)36 b(an)n(y)f(Mapping,)j(a)e(F)-7
-b(rameSet)36 b(ma)n(y)g(also)f(b)r(e)227 4370 y(in)n(v)n(erted)h(\(see)
-g(astIn)n(v)n(ert\),)i(whic)n(h)f(has)e(the)i(e\013ect)g(of)g(in)n
-(terc)n(hanging)e(its)h(base)g(and)g(curren)n(t)g(F)-7
-b(rames)36 b(and)227 4470 y(hence)28 b(of)f(rev)n(ersing)f(the)i
-(Mapping)f(b)r(et)n(w)n(een)h(them.)227 4604 y(Regions)33
+(place)f(of)h(its)227 5693 y(curren)n(t)27 b(F)-7 b(rame)27
+b(in)h(most)f(situations.)p eop end
+%%Page: 239 249
+TeXDict begin 239 248 bop 3643 52 a FF(239)227 351 y
+Fi(When)38 b(a)g(F)-7 b(rameSet)37 b(is)g(used)h(in)g(a)f(con)n(text)g
+(that)h(requires)e(a)h(Mapping,)j(the)e(Mapping)f(used)h(is)f(the)h
+(one)227 451 y(b)r(et)n(w)n(een)25 b(its)h(base)e(F)-7
+b(rame)25 b(and)g(its)h(curren)n(t)e(F)-7 b(rame.)35
+b(Th)n(us,)26 b(a)f(F)-7 b(rameSet)25 b(ma)n(y)f(b)r(e)i(used)f(to)g
+(con)n(v)n(ert)f Ft(")p Fi(nativ)n(e)p Ft(")227 551 y
+Fi(co)r(ordinates)35 b(in)n(to)h Ft(")p Fi(apparen)n(t)p
+Ft(")f Fi(ones,)i(and)g(vice)f(v)n(ersa.)61 b(Lik)n(e)36
+b(an)n(y)f(Mapping,)j(a)e(F)-7 b(rameSet)36 b(ma)n(y)g(also)f(b)r(e)227
+650 y(in)n(v)n(erted)h(\(see)g(astIn)n(v)n(ert\),)i(whic)n(h)f(has)e
+(the)i(e\013ect)g(of)g(in)n(terc)n(hanging)e(its)h(base)g(and)g(curren)
+n(t)g(F)-7 b(rames)36 b(and)227 750 y(hence)28 b(of)f(rev)n(ersing)f
+(the)i(Mapping)f(b)r(et)n(w)n(een)h(them.)227 873 y(Regions)33
b(ma)n(y)f(b)r(e)i(added)f(in)n(to)h(a)f(F)-7 b(rameSet)33
b(\(since)g(a)g(Region)g(is)g(a)g(t)n(yp)r(e)h(of)f(F)-7
-b(rame\),)35 b(either)e(explicitly)g(or)227 4703 y(as)e(comp)r(onen)n
+b(rame\),)35 b(either)e(explicitly)g(or)227 973 y(as)e(comp)r(onen)n
(ts)g(within)h(CmpF)-7 b(rames.)48 b(In)31 b(this)h(case)e(the)i
(Mapping)f(b)r(et)n(w)n(een)g(a)g(pair)g(of)g(F)-7 b(rames)31
-b(within)h(a)227 4803 y(F)-7 b(rameSet)35 b(will)g(include)g(the)h
+b(within)h(a)227 1073 y(F)-7 b(rameSet)35 b(will)g(include)g(the)h
(e\013ects)f(of)g(the)g(clipping)g(pro)r(duced)g(b)n(y)f(an)n(y)h
-(Regions)f(included)h(in)g(the)g(path)227 4902 y(b)r(et)n(w)n(een)28
-b(the)g(F)-7 b(rames.)0 5071 y Fd(Synopsis:)121 b Ft(AstFrameSet)39
+(Regions)f(included)h(in)g(the)g(path)227 1172 y(b)r(et)n(w)n(een)28
+b(the)g(F)-7 b(rames.)0 1320 y Fd(Synopsis:)121 b Ft(AstFrameSet)39
b Fh(\003)p Ft(astFrameSet\()f(AstFrame)i Fh(\003)p Ft(frame,)h(const)g
-(char)h Fh(\003)p Ft(options,)e(...)86 b(\))0 5239 y
-Fd(P)m(arameters:)259 5394 y(frame)427 5494 y Fi(P)n(oin)n(ter)36
+(char)h Fh(\003)p Ft(options,)e(...)86 b(\))0 1467 y
+Fd(P)m(arameters:)259 1601 y(frame)427 1701 y Fi(P)n(oin)n(ter)36
b(to)h(the)g(\014rst)g(F)-7 b(rame)37 b(to)f(b)r(e)i(inserted)f(in)n
(to)g(the)g(F)-7 b(rameSet.)65 b(This)37 b(initially)g(b)r(ecomes)g(b)r
-(oth)427 5593 y(the)g(base)f(and)h(the)g(curren)n(t)f(F)-7
+(oth)427 1801 y(the)g(base)f(and)h(the)g(curren)n(t)f(F)-7
b(rame.)63 b(\(F)-7 b(urther)37 b(F)-7 b(rames)36 b(ma)n(y)g(b)r(e)h
-(added)g(using)f(the)h(astAddF)-7 b(rame)427 5693 y(function.\))p
-eop end
-%%Page: 239 249
-TeXDict begin 239 248 bop 3643 52 a FF(239)259 351 y
-Fd(options)427 451 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n(ull-terminated)
-g(string)f(con)n(taining)g(an)h(optional)g(comma-separated)e(list)i(of)
-g(attribute)427 551 y(assignmen)n(ts)22 b(to)i(b)r(e)g(used)f(for)g
-(initialising)g(the)h(new)g(F)-7 b(rameSet.)35 b(The)23
-b(syn)n(tax)g(used)g(is)h(iden)n(tical)f(to)g(that)427
-650 y(for)j(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
-Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n
-(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-750 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)35 b(If)28
+(added)g(using)f(the)h(astAddF)-7 b(rame)427 1900 y(function.\))259
+2031 y Fd(options)427 2131 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n
+(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
+(comma-separated)e(list)i(of)g(attribute)427 2230 y(assignmen)n(ts)22
+b(to)i(b)r(e)g(used)f(for)g(initialising)g(the)h(new)g(F)-7
+b(rameSet.)35 b(The)23 b(syn)n(tax)g(used)g(is)h(iden)n(tical)f(to)g
+(that)427 2330 y(for)j(the)h(astSet)g(function)g(and)g(ma)n(y)f
+(include)h Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g
+(iden)n(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
+2430 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)35 b(If)28
b(no)g(initialisation)f(is)g(required,)g(a)g(zero-length)f(string)h(ma)
-n(y)g(b)r(e)h(supplied.)259 884 y Fd(...)427 983 y Fi(If)38
-b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n(tains)f
+n(y)g(b)r(e)h(supplied.)259 2560 y Fd(...)427 2660 y
+Fi(If)38 b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n(tains)f
Ft(")p Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f
-(optional)g(list)h(of)f(additional)427 1083 y(argumen)n(ts)26
+(optional)g(list)h(of)f(additional)427 2760 y(argumen)n(ts)26
b(ma)n(y)h(follo)n(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5
b(alues)27 b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)
-37 b(The)427 1183 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+37 b(The)427 2859 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 1282 y Fi(function\).)0
-1446 y Fd(Returned)32 b(V)-8 b(alue:)259 1585 y(astF)g(rameSet\(\))427
-1684 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(F)-7
-b(rameSet.)0 1848 y Fd(Notes:)340 2133 y Fh(\017)45 b
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 2959 y Fi(function\).)0
+3119 y Fd(Returned)32 b(V)-8 b(alue:)259 3253 y(astF)g(rameSet\(\))427
+3353 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(F)-7
+b(rameSet.)0 3513 y Fd(Notes:)340 3793 y Fh(\017)45 b
Fi(If)20 b(a)e(p)r(oin)n(ter)h(to)g(an)f(existing)h(F)-7
b(rameSet)18 b(is)h(giv)n(en)f(for)h(the)g Ft(")p Fi(frame)p
Ft(")f Fi(parameter,)h(then)h(the)f(new)g(F)-7 b(rameSet)427
-2232 y(will)28 b(\(as)f(a)g(sp)r(ecial)g(case\))g(b)r(e)h(initialised)f
+3893 y(will)28 b(\(as)f(a)g(sp)r(ecial)g(case\))g(b)r(e)h(initialised)f
(to)g(con)n(tain)g(the)h(same)f(F)-7 b(rames)26 b(and)h(Mappings,)g
-(and)h(to)f(ha)n(v)n(e)427 2332 y(the)h(same)f(attribute)g(v)-5
+(and)h(to)f(ha)n(v)n(e)427 3992 y(the)h(same)f(attribute)g(v)-5
b(alues,)27 b(as)g(the)g(one)g(supplied.)37 b(This)27
b(pro)r(cess)f(is)i(similar)e(to)h(making)g(a)f(cop)n(y)h(of)g(a)427
-2432 y(F)-7 b(rameSet)27 b(\(see)h(astCop)n(y\),)e(except)h(that)h(the)
+4092 y(F)-7 b(rameSet)27 b(\(see)h(astCop)n(y\),)e(except)h(that)h(the)
g(F)-7 b(rames)26 b(and)h(Mappings)g(con)n(tained)g(in)g(the)h
-(original)e(are)427 2531 y(not)i(themselv)n(es)f(copied,)g(but)h(are)f
-(shared)g(b)n(y)g(b)r(oth)h(F)-7 b(rameSets.)340 2665
+(original)e(are)427 4192 y(not)i(themselv)n(es)f(copied,)g(but)h(are)f
+(shared)g(b)n(y)g(b)r(oth)h(F)-7 b(rameSets.)340 4322
y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g
(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g
-(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 2765
+(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 4422
y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f
-(an)n(y)g(reason.)p 0 2966 3780 12 v 0 3098 a Fz(astF)-11
+(an)n(y)g(reason.)p 0 4617 3780 12 v 0 4749 a Fz(astF)-11
b(romString)315 b Fe(Re-create)38 b(an)h(Ob)7 b(ject)37
-b(from)h(an)1292 3212 y(in-memory)f(serialisation)2940
-3098 y Fz(astF)-11 b(romString)0 3403 y Fd(Description:)44
+b(from)h(an)1292 4864 y(in-memory)f(serialisation)2940
+4749 y Fz(astF)-11 b(romString)0 5048 y Fd(Description:)44
b Fi(This)35 b(function)f(returns)g(a)g(p)r(oin)n(ter)f(to)h(a)g(new)g
(Ob)5 b(ject)34 b(created)g(from)g(the)g(supplied)h(text)f(string,)227
-3503 y(whic)n(h)28 b(should)f(ha)n(v)n(e)g(b)r(een)h(created)e(b)n(y)i
-(astT)-7 b(oString.)0 3654 y Fd(Synopsis:)121 b Ft(AstObject)40
+5148 y(whic)n(h)28 b(should)f(ha)n(v)n(e)g(b)r(een)h(created)e(b)n(y)i
+(astT)-7 b(oString.)0 5295 y Fd(Synopsis:)121 b Ft(AstObject)40
b Fh(\003)p Ft(astFromString\()d(const)42 b(char)f Fh(\003)p
-Ft(string)g(\))0 3806 y Fd(P)m(arameters:)259 3944 y(string)427
-4044 y Fi(P)n(oin)n(ter)26 b(to)i(a)f(text)h(string)f(holding)g(an)g
+Ft(string)g(\))0 5443 y Fd(P)m(arameters:)259 5577 y(string)427
+5677 y Fi(P)n(oin)n(ter)26 b(to)i(a)f(text)h(string)f(holding)g(an)g
(Ob)5 b(ject)28 b(serialisation)d(created)i(previously)g(b)n(y)g(astT)
--7 b(oString.)0 4208 y Fd(Returned)32 b(V)-8 b(alue:)259
-4346 y(astF)g(romString\(\))427 4446 y Fi(P)n(oin)n(ter)26
-b(to)i(a)f(new)g(Ob)5 b(ject)28 b(created)e(from)h(the)h(supplied)g
-(serialisation,)e(or)h(NULL)h(if)g(the)f(serialisation)427
-4545 y(w)n(as)g(in)n(v)-5 b(alid,)27 b(or)g(an)g(error)f(o)r(ccurred.)p
-0 4747 V 0 4877 a Fz(astGenCurv)l(e)1245 4878 y Fe(Dra)m(w)38
-b(a)g(generalized)f(curv)m(e)3012 4877 y Fz(astGenCurv)l(e)0
-5069 y Fd(Description:)44 b Fi(This)29 b(function)f(dra)n(ws)f(a)h
-(general)f(user-de\014ned)h(curv)n(e)f(de\014ned)i(b)n(y)f(the)g
-(supplied)h(Mapping.)39 b(Note)227 5169 y(that)25 b(the)g(curv)n(e)f
-(is)g(transformed)g(in)n(to)g(graphical)f(co)r(ordinate)h(space)g(for)g
-(plotting,)h(so)f(that)h(a)f(straigh)n(t)f(line)i(in)227
-5269 y(ph)n(ysical)f(co)r(ordinates)f(ma)n(y)g(result)h(in)h(a)f(curv)n
-(ed)g(line)g(b)r(eing)h(dra)n(wn)e(if)i(the)g(Mapping)f(in)n(v)n(olv)n
-(ed)f(is)h(non-linear.)227 5368 y(An)n(y)j(discon)n(tin)n(uities)f(in)h
-(the)f(Mapping)h(b)r(et)n(w)n(een)f(ph)n(ysical)g(and)g(graphical)f(co)
-r(ordinates)g(are)g(catered)h(for,)g(as)227 5468 y(is)i(an)n(y)f
-(clipping)g(established)g(using)h(astClip.)227 5593 y(If)37
-b(y)n(ou)e(need)g(to)h(dra)n(w)f(simple)h(straigh)n(t)e(lines)i(\(geo)r
-(desics\),)h(astCurv)n(e)e(or)g(astP)n(olyCurv)n(e)e(will)j(usually)f
-(b)r(e)227 5693 y(easier)27 b(to)g(use)g(and)h(faster.)p
-eop end
+-7 b(oString.)p eop end
%%Page: 240 250
TeXDict begin 240 249 bop 0 52 a FF(240)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Synopsis:)121
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Returned)i(V)-8
+b(alue:)259 483 y(astF)g(romString\(\))427 583 y Fi(P)n(oin)n(ter)26
+b(to)i(a)f(new)g(Ob)5 b(ject)28 b(created)e(from)h(the)h(supplied)g
+(serialisation,)e(or)h(NULL)h(if)g(the)f(serialisation)427
+683 y(w)n(as)g(in)n(v)-5 b(alid,)27 b(or)g(an)g(error)f(o)r(ccurred.)p
+0 874 3780 12 v 0 1004 a Fz(astGenCurv)l(e)1245 1005
+y Fe(Dra)m(w)38 b(a)g(generalized)f(curv)m(e)3012 1004
+y Fz(astGenCurv)l(e)0 1186 y Fd(Description:)44 b Fi(This)29
+b(function)f(dra)n(ws)f(a)h(general)f(user-de\014ned)h(curv)n(e)f
+(de\014ned)i(b)n(y)f(the)g(supplied)h(Mapping.)39 b(Note)227
+1285 y(that)25 b(the)g(curv)n(e)f(is)g(transformed)g(in)n(to)g
+(graphical)f(co)r(ordinate)h(space)g(for)g(plotting,)h(so)f(that)h(a)f
+(straigh)n(t)f(line)i(in)227 1385 y(ph)n(ysical)f(co)r(ordinates)f(ma)n
+(y)g(result)h(in)h(a)f(curv)n(ed)g(line)g(b)r(eing)h(dra)n(wn)e(if)i
+(the)g(Mapping)f(in)n(v)n(olv)n(ed)f(is)h(non-linear.)227
+1485 y(An)n(y)j(discon)n(tin)n(uities)f(in)h(the)f(Mapping)h(b)r(et)n
+(w)n(een)f(ph)n(ysical)g(and)g(graphical)f(co)r(ordinates)g(are)g
+(catered)h(for,)g(as)227 1584 y(is)i(an)n(y)f(clipping)g(established)g
+(using)h(astClip.)227 1707 y(If)37 b(y)n(ou)e(need)g(to)h(dra)n(w)f
+(simple)h(straigh)n(t)e(lines)i(\(geo)r(desics\),)h(astCurv)n(e)e(or)g
+(astP)n(olyCurv)n(e)e(will)j(usually)f(b)r(e)227 1806
+y(easier)27 b(to)g(use)g(and)h(faster.)0 1952 y Fd(Synopsis:)121
b Ft(void)42 b(astGenCurve\()c(AstPlot)j Fh(\003)p Ft(this,)g
-(astMapping)f Fh(\003)p Ft(map)h(\))0 497 y Fd(P)m(arameters:)259
-629 y(this)427 729 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259
-858 y Fd(map)427 957 y Fi(P)n(oin)n(ter)21 b(to)h(a)g(Mapping.)35
+(astMapping)f Fh(\003)p Ft(map)h(\))0 2097 y Fd(P)m(arameters:)259
+2229 y(this)427 2329 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259
+2457 y Fd(map)427 2557 y Fi(P)n(oin)n(ter)21 b(to)h(a)g(Mapping.)35
b(This)22 b(Mapping)g(should)g(ha)n(v)n(e)f(1)h(input)i(co)r(ordinate)d
-(represen)n(ting)g(o\013set)h(along)427 1057 y(the)31
+(represen)n(ting)g(o\013set)h(along)427 2656 y(the)31
b(required)d(curv)n(e,)i(normalized)f(so)g(that)h(the)g(start)g(of)f
(the)i(curv)n(e)e(is)g(at)h(o\013set)g(0.0,)g(and)f(the)i(end)f(of)427
-1156 y(the)j(curv)n(e)f(is)g(at)h(o\013set)g(1.0.)51
+2756 y(the)j(curv)n(e)f(is)g(at)h(o\013set)g(1.0.)51
b(Note,)34 b(this)f(o\013set)f(do)r(es)h(not)f(need)h(to)g(b)r(e)g
-(linearly)e(related)h(to)h(distance)427 1256 y(along)c(the)h(curv)n(e.)
+(linearly)e(related)h(to)h(distance)427 2856 y(along)c(the)h(curv)n(e.)
42 b(The)30 b(n)n(um)n(b)r(er)f(of)h(output)g(co)r(ordinates)f(should)g
(equal)g(the)h(n)n(um)n(b)r(er)g(of)f(axes)g(in)h(the)427
-1356 y(curren)n(t)e(F)-7 b(rame)28 b(of)h(the)g(Plot.)39
+2955 y(curren)n(t)e(F)-7 b(rame)28 b(of)h(the)g(Plot.)39
b(The)29 b(Mapping)f(should)g(map)h(a)f(sp)r(eci\014ed)h(o\013set)f
-(along)g(the)h(curv)n(e,)f(in)n(to)427 1455 y(the)h(corresp)r(onding)e
+(along)g(the)h(curv)n(e,)f(in)n(to)427 3055 y(the)h(corresp)r(onding)e
(co)r(ordinates)g(in)i(the)h(curren)n(t)d(F)-7 b(rame)29
b(of)f(the)h(Plot.)40 b(The)29 b(in)n(v)n(erse)e(transformation)427
-1555 y(need)h(not)g(b)r(e)g(de\014ned.)0 1713 y Fd(Notes:)340
-1991 y Fh(\017)45 b Fi(An)28 b(error)e(results)h(if)h(the)g(base)f(F)-7
+3155 y(need)h(not)g(b)r(e)g(de\014ned.)0 3312 y Fd(Notes:)340
+3591 y Fh(\017)45 b Fi(An)28 b(error)e(results)h(if)h(the)g(base)f(F)-7
b(rame)27 b(of)h(the)g(Plot)f(is)g(not)h(2-dimensional.)340
-2120 y Fh(\017)45 b Fi(An)30 b(error)d(also)g(results)i(if)g(the)g
+3719 y Fh(\017)45 b Fi(An)30 b(error)d(also)g(results)i(if)g(the)g
(transformation)f(b)r(et)n(w)n(een)h(the)g(curren)n(t)f(and)h(base)f(F)
--7 b(rames)28 b(of)h(the)g(Plot)427 2220 y(is)f(not)f(de\014ned)h
+-7 b(rames)28 b(of)h(the)g(Plot)427 3819 y(is)f(not)f(de\014ned)h
(\(i.e.)38 b(the)28 b(Plot's)e(T)-7 b(ranIn)n(v)n(erse)26
-b(attribute)h(is)h(zero\).)p 0 2411 3780 12 v 0 2542
-a Fz(astGet)p Fc(<)p Fz(X)p Fc(>)951 2543 y Fe(Get)39
-b(an)f(attribute)f(v)-7 b(alue)38 b(for)g(an)g(Ob)7 b(ject)3106
-2542 y Fz(astGet)p Fc(<)p Fz(X)p Fc(>)0 2724 y Fd(Description:)44
-b Fi(This)29 b(is)f(a)g(family)g(of)h(functions)f(whic)n(h)h(return)f
-(a)f(sp)r(eci\014ed)i(attribute)g(v)-5 b(alue)28 b(for)g(an)g(Ob)5
-b(ject)28 b(using)227 2823 y(one)j(of)g(sev)n(eral)f(di\013eren)n(t)h
+b(attribute)h(is)h(zero\).)p 0 4010 V 0 4140 a Fz(astGet)p
+Fc(<)p Fz(X)p Fc(>)951 4141 y Fe(Get)39 b(an)f(attribute)f(v)-7
+b(alue)38 b(for)g(an)g(Ob)7 b(ject)3106 4140 y Fz(astGet)p
+Fc(<)p Fz(X)p Fc(>)0 4322 y Fd(Description:)44 b Fi(This)29
+b(is)f(a)g(family)g(of)h(functions)f(whic)n(h)h(return)f(a)f(sp)r
+(eci\014ed)i(attribute)g(v)-5 b(alue)28 b(for)g(an)g(Ob)5
+b(ject)28 b(using)227 4421 y(one)j(of)g(sev)n(eral)f(di\013eren)n(t)h
(data)g(t)n(yp)r(es.)47 b(The)32 b(t)n(yp)r(e)f(is)g(selected)g(b)n(y)g
(replacing)f Fk(<)p Fi(X)p Fk(>)h Fi(in)g(the)h(function)g(name)227
-2923 y(b)n(y)27 b(C,)f(D,)h(F,)g(I)g(or)f(L,)g(to)h(obtain)f(a)g
+4521 y(b)n(y)27 b(C,)f(D,)h(F,)g(I)g(or)f(L,)g(to)h(obtain)f(a)g
(result)h(in)g(const)f(c)n(har)p Fh(\003)f Fi(\(i.e.)37
b(string\),)26 b(double,)h(\015oat,)f(in)n(t,)h(or)f(long)g(format,)227
-3022 y(resp)r(ectiv)n(ely)-7 b(.)227 3145 y(If)30 b(p)r(ossible,)f(the)
+4621 y(resp)r(ectiv)n(ely)-7 b(.)227 4743 y(If)30 b(p)r(ossible,)f(the)
h(attribute)g(v)-5 b(alue)29 b(is)g(con)n(v)n(erted)f(to)h(the)g(t)n
(yp)r(e)h(y)n(ou)e(request.)42 b(If)29 b(con)n(v)n(ersion)e(is)j(not)f
-(p)r(ossible,)227 3245 y(an)f(error)d(will)j(result.)0
-3390 y Fd(Synopsis:)121 b Fk(<)p Ft(X)p Fk(>)p Ft(type)41
+(p)r(ossible,)227 4843 y(an)f(error)d(will)j(result.)0
+4988 y Fd(Synopsis:)121 b Fk(<)p Ft(X)p Fk(>)p Ft(type)41
b(astGet)p Fk(<)p Ft(X)p Fk(>)p Ft(\()e(AstObject)h Fh(\003)p
Ft(this,)h(const)g(char)h Fh(\003)p Ft(attrib)f(\))0
-3535 y Fd(P)m(arameters:)259 3668 y(this)427 3767 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(Ob)5 b(ject.)259 3896 y Fd(attrib)427 3996
+5133 y Fd(P)m(arameters:)259 5265 y(this)427 5365 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(Ob)5 b(ject.)259 5494 y Fd(attrib)427 5593
y Fi(P)n(oin)n(ter)31 b(to)i(a)f(n)n(ull-terminated)g(string)g(con)n
(taining)f(the)i(name)g(of)f(the)h(attribute)g(whose)f(v)-5
-b(alue)32 b(is)g(re-)427 4096 y(quired.)0 4253 y Fd(Class)f
-(Applicabilit)m(y:)259 4386 y(Ob)5 b(ject)427 4485 y
-Fi(These)28 b(functions)f(apply)h(to)f(all)h(Ob)5 b(jects.)0
-4643 y Fd(Returned)32 b(V)-8 b(alue:)259 4776 y(astGet)p
-Fk(<)p Fd(X)p Fk(>)p Fd(\(\))427 4875 y Fi(The)32 b(attribute)f(v)-5
+b(alue)32 b(is)g(re-)427 5693 y(quired.)p eop end
+%%Page: 241 251
+TeXDict begin 241 250 bop 3643 52 a FF(241)0 351 y Fd(Class)31
+b(Applicabilit)m(y:)259 512 y(Ob)5 b(ject)427 611 y Fi(These)28
+b(functions)f(apply)h(to)f(all)h(Ob)5 b(jects.)0 797
+y Fd(Returned)32 b(V)-8 b(alue:)259 957 y(astGet)p Fk(<)p
+Fd(X)p Fk(>)p Fd(\(\))427 1057 y Fi(The)32 b(attribute)f(v)-5
b(alue,)33 b(in)e(the)h(data)f(t)n(yp)r(e)h(corresp)r(onding)d(to)i
Fk(<)p Fi(X)p Fk(>)g Fi(\(or,)h(in)g(the)g(case)e(of)i(astGetC,)f(a)427
-4975 y(p)r(oin)n(ter)c(to)h(a)f(constan)n(t)g(n)n(ull-terminated)g(c)n
+1157 y(p)r(oin)n(ter)c(to)h(a)f(constan)n(t)g(n)n(ull-terminated)g(c)n
(haracter)f(string)h(con)n(taining)f(this)i(v)-5 b(alue\).)0
-5133 y Fd(Examples:)227 5265 y Fp(printf\()46 b Ft(")p
+1343 y Fd(Examples:)227 1503 y Fp(printf\()46 b Ft(")p
Fp(RefCount)f(=)j(\045d)p Fh(n)p Fp(n)p Ft(")p Fp(,)d(astGetI\()h(z,)h
-Ft(")p Fp(RefCount)p Ft(")e Fp(\))i(\);)427 5365 y Fi(Prin)n(ts)27
+Ft(")p Fp(RefCount)p Ft(")e Fp(\))i(\);)427 1603 y Fi(Prin)n(ts)27
b(the)h(RefCoun)n(t)g(attribute)f(v)-5 b(alue)28 b(for)f(Ob)5
b(ject)27 b Ft(")p Fi(z)p Ft(")g Fi(as)g(an)g(in)n(t.)227
-5498 y Fp(title)47 b(=)g(astGetC\()f(axis,)g Ft(")p Fp(Title)p
-Ft(")g Fp(\);)427 5593 y Fi(Obtains)41 b(a)f(p)r(oin)n(ter)g(to)h(a)f
+1751 y Fp(title)47 b(=)g(astGetC\()f(axis,)g Ft(")p Fp(Title)p
+Ft(")g Fp(\);)427 1847 y Fi(Obtains)41 b(a)f(p)r(oin)n(ter)g(to)h(a)f
(n)n(ull-terminated)h(c)n(haracter)e(string)h(con)n(taining)f(the)j
-(Title)f(attribute)g(of)427 5693 y(Ob)5 b(ject)28 b Ft(")p
-Fi(axis)p Ft(")p Fi(.)p eop end
-%%Page: 241 251
-TeXDict begin 241 250 bop 3643 52 a FF(241)0 351 y Fd(Notes:)340
-641 y Fh(\017)45 b Fi(A)n(ttribute)28 b(names)g(are)e(not)i(case)f
-(sensitiv)n(e)g(and)g(ma)n(y)g(b)r(e)h(surrounded)e(b)n(y)i(white)g
-(space.)340 778 y Fh(\017)45 b Fi(An)31 b(appropriate)e
-Ft(")p Fi(n)n(ull)p Ft(")h Fi(v)-5 b(alue)30 b(will)h(b)r(e)g(returned)
-f(if)h(this)f(function)h(is)g(in)n(v)n(ok)n(ed)e(with)i(the)g(AST)g
-(error)427 878 y(status)g(set,)g(or)f(if)h(it)h(should)e(fail)h(for)f
-(an)n(y)g(reason.)45 b(This)30 b(n)n(ull)h(v)-5 b(alue)31
-b(is)f(zero)g(for)g(n)n(umeric)g(v)-5 b(alues)31 b(and)427
-977 y(NULL)d(for)f(p)r(oin)n(ter)h(v)-5 b(alues.)340
-1114 y Fh(\017)45 b Fi(The)34 b(p)r(oin)n(ter)f(returned)g(b)n(y)h
-(astGetC)f(is)h(guaran)n(teed)e(to)h(remain)g(v)-5 b(alid)34
-b(and)f(the)h(string)f(to)h(whic)n(h)f(it)427 1213 y(p)r(oin)n(ts)27
-b(will)h(not)f(b)r(e)h(o)n(v)n(er-written)d(for)i(a)g(total)g(of)g(50)f
-(successiv)n(e)g(in)n(v)n(o)r(cations)g(of)h(this)h(function.)37
-b(After)427 1313 y(this,)h(the)e(memory)f(con)n(taining)f(the)i(string)
-f(ma)n(y)g(b)r(e)h(re-used,)h(so)e(a)g(cop)n(y)g(of)g(the)h(string)f
-(should)g(b)r(e)427 1413 y(made)28 b(if)g(it)g(is)f(needed)h(for)f
-(longer)f(than)i(this.)p 0 1619 3780 12 v 0 1751 a Fz(astGetActiv)l
-(eUnit)208 b Fe(Determines)38 b(ho)m(w)g(the)g(Unit)1338
-1851 y(attribute)f(will)g(b)s(e)i(used)2742 1751 y Fz(astGetActiv)l
-(eUnit)0 2024 y Fd(Description:)44 b Fi(This)d(function)h(returns)e
-(the)i(curren)n(t)e(v)-5 b(alue)40 b(of)h(the)h(Activ)n(eUnit)g(\015ag)
-e(for)g(a)h(F)-7 b(rame.)76 b(See)41 b(the)227 2124 y(description)27
-b(of)h(the)g(astSetActiv)n(eUnit)g(function)g(for)f(a)g(description)g
-(of)h(the)g(Activ)n(eUnit)g(\015ag.)0 2281 y Fd(Synopsis:)121
-b Ft(int)42 b(astGetActiveUnit\()37 b(AstFrame)j Fh(\003)p
-Ft(this)h(\))0 2438 y Fd(P)m(arameters:)259 2581 y(this)427
-2681 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7 b(rame.)0
-2851 y Fd(Returned)32 b(V)-8 b(alue:)259 2994 y(astGetActiv)m(eUnit)427
-3094 y Fi(The)28 b(curren)n(t)f(v)-5 b(alue)27 b(of)h(the)g(Activ)n
-(eUnit)g(\015ag.)0 3264 y Fd(Notes:)340 3554 y Fh(\017)45
+(Title)f(attribute)g(of)427 1947 y(Ob)5 b(ject)28 b Ft(")p
+Fi(axis)p Ft(")p Fi(.)0 2133 y Fd(Notes:)340 2439 y Fh(\017)45
+b Fi(A)n(ttribute)28 b(names)g(are)e(not)i(case)f(sensitiv)n(e)g(and)g
+(ma)n(y)g(b)r(e)h(surrounded)e(b)n(y)i(white)g(space.)340
+2584 y Fh(\017)45 b Fi(An)31 b(appropriate)e Ft(")p Fi(n)n(ull)p
+Ft(")h Fi(v)-5 b(alue)30 b(will)h(b)r(e)g(returned)f(if)h(this)f
+(function)h(is)g(in)n(v)n(ok)n(ed)e(with)i(the)g(AST)g(error)427
+2683 y(status)g(set,)g(or)f(if)h(it)h(should)e(fail)h(for)f(an)n(y)g
+(reason.)45 b(This)30 b(n)n(ull)h(v)-5 b(alue)31 b(is)f(zero)g(for)g(n)
+n(umeric)g(v)-5 b(alues)31 b(and)427 2783 y(NULL)d(for)f(p)r(oin)n(ter)
+h(v)-5 b(alues.)340 2928 y Fh(\017)45 b Fi(The)34 b(p)r(oin)n(ter)f
+(returned)g(b)n(y)h(astGetC)f(is)h(guaran)n(teed)e(to)h(remain)g(v)-5
+b(alid)34 b(and)f(the)h(string)f(to)h(whic)n(h)f(it)427
+3028 y(p)r(oin)n(ts)27 b(will)h(not)f(b)r(e)h(o)n(v)n(er-written)d(for)
+i(a)g(total)g(of)g(50)f(successiv)n(e)g(in)n(v)n(o)r(cations)g(of)h
+(this)h(function.)37 b(After)427 3127 y(this,)h(the)e(memory)f(con)n
+(taining)f(the)i(string)f(ma)n(y)g(b)r(e)h(re-used,)h(so)e(a)g(cop)n(y)
+g(of)g(the)h(string)f(should)g(b)r(e)427 3227 y(made)28
+b(if)g(it)g(is)f(needed)h(for)f(longer)f(than)i(this.)p
+0 3450 3780 12 v 0 3582 a Fz(astGetActiv)l(eUnit)208
+b Fe(Determines)38 b(ho)m(w)g(the)g(Unit)1338 3681 y(attribute)f(will)g
+(b)s(e)i(used)2742 3582 y Fz(astGetActiv)l(eUnit)0 3871
+y Fd(Description:)44 b Fi(This)d(function)h(returns)e(the)i(curren)n(t)
+e(v)-5 b(alue)40 b(of)h(the)h(Activ)n(eUnit)g(\015ag)e(for)g(a)h(F)-7
+b(rame.)76 b(See)41 b(the)227 3970 y(description)27 b(of)h(the)g
+(astSetActiv)n(eUnit)g(function)g(for)f(a)g(description)g(of)h(the)g
+(Activ)n(eUnit)g(\015ag.)0 4144 y Fd(Synopsis:)121 b
+Ft(int)42 b(astGetActiveUnit\()37 b(AstFrame)j Fh(\003)p
+Ft(this)h(\))0 4317 y Fd(P)m(arameters:)259 4478 y(this)427
+4577 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7 b(rame.)0
+4763 y Fd(Returned)32 b(V)-8 b(alue:)259 4923 y(astGetActiv)m(eUnit)427
+5023 y Fi(The)28 b(curren)n(t)f(v)-5 b(alue)27 b(of)h(the)g(Activ)n
+(eUnit)g(\015ag.)0 5209 y Fd(Notes:)340 5515 y Fh(\017)45
b Fi(A)30 b(zero)f(v)-5 b(alue)29 b(will)h(b)r(e)g(returned)f(if)h
(this)g(function)g(is)g(in)n(v)n(ok)n(ed)e(with)i(the)g(AST)g(error)e
-(status)h(set,)h(or)f(if)427 3653 y(it)f(should)g(fail)f(for)g(an)n(y)g
-(reason.)p 0 3860 V 0 3992 a Fz(astGetColumnData)225
-b Fe(Retriev)m(e)38 b(all)f(the)i(data)1442 4091 y(v)-7
-b(alues)39 b(stored)e(in)i(a)1704 4191 y(column)2640
-3992 y Fz(astGetColumnData)0 4364 y Fd(Description:)44
+(status)h(set,)h(or)f(if)427 5615 y(it)f(should)g(fail)f(for)g(an)n(y)g
+(reason.)p eop end
+%%Page: 242 252
+TeXDict begin 242 251 bop 0 52 a FF(242)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 483 a Fz(astGetColumnData)225 b Fe(Retriev)m(e)38 b(all)f(the)i(data)
+1442 583 y(v)-7 b(alues)39 b(stored)e(in)i(a)1704 682
+y(column)2640 483 y Fz(astGetColumnData)0 854 y Fd(Description:)44
b Fi(This)28 b(function)g(copies)f(all)g(data)g(v)-5
b(alues)28 b(from)f(a)g(named)h(column)f(in)n(to)h(a)f(supplied)h
-(bu\013er)0 4521 y Fd(Synopsis:)121 b Ft(void)42 b(astGetColumnData)o
+(bu\013er)0 1009 y Fd(Synopsis:)121 b Ft(void)42 b(astGetColumnData)o
(\()37 b(AstFitsTable)i Fh(\003)p Ft(this,)i(const)h(char)f
-Fh(\003)p Ft(column,)g(float)g(fnull,)g(double)227 4621
+Fh(\003)p Ft(column,)g(float)g(fnull,)g(double)227 1109
y(dnull,)g(size_t)g(mxsize,)g(void)h Fh(\003)p Ft(coldata,)e(int)i
-Fh(\003)p Ft(nelem)f(\))0 4778 y Fd(P)m(arameters:)259
-4922 y(this)427 5021 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(FitsT)-7
-b(able.)259 5158 y Fd(column)427 5258 y Fi(The)28 b(c)n(haracter)d
+Fh(\003)p Ft(nelem)f(\))0 1264 y Fd(P)m(arameters:)259
+1407 y(this)427 1507 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(FitsT)-7
+b(able.)259 1642 y Fd(column)427 1742 y Fi(The)28 b(c)n(haracter)d
(string)i(holding)h(the)g(name)f(of)g(the)h(column.)37
-b(T)-7 b(railing)27 b(spaces)g(are)f(ignored.)259 5394
-y Fd(fn)m(ull)427 5494 y Fi(The)i(v)-5 b(alue)28 b(to)g(return)g(in)g
+b(T)-7 b(railing)27 b(spaces)g(are)f(ignored.)259 1878
+y Fd(fn)m(ull)427 1978 y Fi(The)i(v)-5 b(alue)28 b(to)g(return)g(in)g
Ft(")p Fi(coldata)p Ft(")e Fi(for)i(an)n(y)f(cells)h(for)f(whic)n(h)h
(no)g(v)-5 b(alue)28 b(has)f(b)r(een)h(stored)g(in)g(the)g(Fit-)427
-5593 y(sT)-7 b(able.)34 b(Ignored)17 b(if)i(the)f(column's)g(data)g(t)n
+2077 y(sT)-7 b(able.)34 b(Ignored)17 b(if)i(the)f(column's)g(data)g(t)n
(yp)r(e)h(is)f(not)h(AST)p Ft(__)p Fi(FLO)n(A)-7 b(TTYPE.)16
-b(Supplying)j(AST)p Ft(__)p Fi(NANF)427 5693 y(will)28
+b(Supplying)j(AST)p Ft(__)p Fi(NANF)427 2177 y(will)28
b(cause)f(a)g(single)g(precision)g(IEEE)f(NaN)i(v)-5
-b(alue)27 b(to)h(b)r(e)g(used.)p eop end
-%%Page: 242 252
-TeXDict begin 242 251 bop 0 52 a FF(242)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(dn)m(ull)427
-451 y Fi(The)e(v)-5 b(alue)28 b(to)g(return)g(in)g Ft(")p
+b(alue)27 b(to)h(b)r(e)g(used.)259 2313 y Fd(dn)m(ull)427
+2412 y Fi(The)g(v)-5 b(alue)28 b(to)g(return)g(in)g Ft(")p
Fi(coldata)p Ft(")e Fi(for)i(an)n(y)f(cells)h(for)f(whic)n(h)h(no)g(v)
-5 b(alue)28 b(has)f(b)r(een)h(stored)g(in)g(the)g(Fit-)427
-551 y(sT)-7 b(able.)34 b(Ignored)17 b(if)i(the)f(column's)g(data)g(t)n
+2512 y(sT)-7 b(able.)34 b(Ignored)17 b(if)i(the)f(column's)g(data)g(t)n
(yp)r(e)h(is)f(not)h(AST)p Ft(__)p Fi(DOUBLETYPE.)d(Supplying)j(AST)p
-Ft(__)p Fi(NAN)427 650 y(will)28 b(cause)f(a)g(double)h(precision)e
+Ft(__)p Fi(NAN)427 2612 y(will)28 b(cause)f(a)g(double)h(precision)e
(IEEE)g(NaN)i(v)-5 b(alue)28 b(to)f(b)r(e)h(used.)259
-783 y Fd(mxsize)427 882 y Fi(The)k(size)f(of)h(the)g
+2747 y Fd(mxsize)427 2847 y Fi(The)k(size)f(of)h(the)g
Ft(")p Fi(coldata)p Ft(")e Fi(arra)n(y)-7 b(,)30 b(in)i(b)n(ytes.)49
b(The)32 b(amoun)n(t)f(of)g(memory)g(needed)h(to)g(hold)f(the)h(data)
-427 982 y(from)g(a)f(column)h(ma)n(y)f(b)r(e)h(determined)g(using)g
+427 2947 y(from)g(a)f(column)h(ma)n(y)f(b)r(e)h(determined)g(using)g
(astColumnSize.)49 b(If)32 b(the)g(supplied)g(arra)n(y)e(is)h(to)r(o)h
-(small)427 1081 y(to)d(hold)f(all)h(the)g(column)f(data,)h(trailing)f
+(small)427 3046 y(to)d(hold)f(all)h(the)g(column)f(data,)h(trailing)f
(column)g(v)-5 b(alues)28 b(will)h(b)r(e)g(omitted)g(from)g(the)g
-(returned)f(arra)n(y)-7 b(,)427 1181 y(but)28 b(no)g(error)d(will)j(b)r
-(e)g(rep)r(orted.)259 1313 y Fd(coldata)427 1413 y Fi(A)33
+(returned)f(arra)n(y)-7 b(,)427 3146 y(but)28 b(no)g(error)d(will)j(b)r
+(e)g(rep)r(orted.)259 3282 y Fd(coldata)427 3381 y Fi(A)33
b(p)r(oin)n(ter)e(to)h(an)g(area)f(of)h(memory)f(in)i(whic)n(h)f(to)g
(return)f(the)i(data)f(v)-5 b(alues)31 b(curren)n(tly)h(stored)f(in)h
-(the)427 1513 y(column.)70 b(The)39 b(v)-5 b(alues)38
+(the)427 3481 y(column.)70 b(The)39 b(v)-5 b(alues)38
b(are)g(stored)f(in)i(ro)n(w)f(order.)68 b(If)39 b(the)g(column)g
-(holds)f(non-scalar)e(v)-5 b(alues,)41 b(the)427 1612
+(holds)f(non-scalar)e(v)-5 b(alues,)41 b(the)427 3581
y(elemen)n(ts)30 b(of)f(eac)n(h)g(v)-5 b(alue)29 b(are)f(stored)h(in)h
Ft(")p Fi(F)-7 b(ortran)p Ft(")27 b Fi(order.)41 b(No)29
b(data)g(t)n(yp)r(e)h(con)n(v)n(ersion)d(is)i(p)r(erformed)427
-1712 y(-)e(the)h(data)e(t)n(yp)r(e)i(of)f(eac)n(h)f(returned)h(v)-5
+3680 y(-)e(the)h(data)e(t)n(yp)r(e)i(of)f(eac)n(h)f(returned)h(v)-5
b(alue)27 b(is)g(the)h(data)e(t)n(yp)r(e)i(asso)r(ciated)e(with)h(the)h
-(column)f(when)g(the)427 1812 y(column)g(w)n(as)g(added)g(to)g(the)g
+(column)f(when)g(the)427 3780 y(column)g(w)n(as)g(added)g(to)g(the)g
(table.)37 b(If)27 b(the)h(column)f(holds)g(strings,)f(the)i(returned)e
-(strings)h(will)g(b)r(e)g(n)n(ull)427 1911 y(terminated.)37
+(strings)h(will)g(b)r(e)g(n)n(ull)427 3880 y(terminated.)37
b(An)n(y)28 b(excess)e(ro)r(om)h(at)h(the)g(end)f(of)h(the)g(arra)n(y)d
-(will)j(b)r(e)g(left)g(unc)n(hanged.)259 2044 y Fd(nelem)427
-2143 y Fi(The)g(n)n(um)n(b)r(er)g(of)g(elemen)n(ts)g(returned)g(in)g
+(will)j(b)r(e)g(left)g(unc)n(hanged.)259 4015 y Fd(nelem)427
+4115 y Fi(The)g(n)n(um)n(b)r(er)g(of)g(elemen)n(ts)g(returned)g(in)g
(the)h Ft(")p Fi(coldata)p Ft(")d Fi(arra)n(y)-7 b(.)36
b(This)28 b(is)g(the)g(pro)r(duct)g(of)g(the)h(n)n(um)n(b)r(er)427
-2243 y(of)f(ro)n(ws)e(returned)h(and)h(the)g(n)n(um)n(b)r(er)f(of)g
+4215 y(of)f(ro)n(ws)e(returned)h(and)h(the)g(n)n(um)n(b)r(er)f(of)g
(elemen)n(ts)h(in)g(eac)n(h)f(column)g(v)-5 b(alue.)0
-2404 y Fd(Notes:)340 2686 y Fh(\017)45 b Fi(The)38 b
+4383 y Fd(Notes:)340 4671 y Fh(\017)45 b Fi(The)38 b
Ft(")p Fi(fn)n(ull)p Ft(")g Fi(and)f Ft(")p Fi(dn)n(ull)p
Ft(")g Fi(parameters)g(sp)r(ecify)h(the)g(v)-5 b(alue)37
b(to)h(b)r(e)g(returned)g(for)f(an)n(y)g(empt)n(y)h(cells)427
-2786 y(within)31 b(columns)f(holding)g(\015oating)f(p)r(oin)n(t)i(v)-5
+4771 y(within)31 b(columns)f(holding)g(\015oating)f(p)r(oin)n(t)i(v)-5
b(alues.)44 b(F)-7 b(or)30 b(columns)g(holding)f(in)n(teger)h(v)-5
-b(alues,)30 b(the)h(v)-5 b(alue)427 2886 y(returned)33
+b(alues,)30 b(the)h(v)-5 b(alue)427 4871 y(returned)33
b(for)g(empt)n(y)h(cells)f(is)g(the)h(v)-5 b(alue)33
b(returned)g(b)n(y)g(the)h(astColumNull)f(function.)55
-b(F)-7 b(or)33 b(columns)427 2985 y(holding)27 b(string)g(v)-5
+b(F)-7 b(or)33 b(columns)427 4970 y(holding)27 b(string)g(v)-5
b(alues,)28 b(the)g(ASCI)r(I)g(NULL)g(c)n(haracter)d(is)j(returned)f
-(for)g(empt)n(y)h(cells.)p 0 3183 3780 12 v 0 3315 a
-Fz(astGetFits)p Fc(<)p Fz(X)p Fc(>)276 b Fe(Get)38 b(a)h(named)f(k)m
-(eyw)m(ord)f(v)-7 b(alue)1466 3430 y(from)37 b(a)i(FitsChan)2878
-3315 y Fz(astGetFits)p Fc(<)p Fz(X)p Fc(>)0 3594 y Fd(Description:)44
+(for)g(empt)n(y)h(cells.)p 0 5175 V 0 5307 a Fz(astGetFits)p
+Fc(<)p Fz(X)p Fc(>)276 b Fe(Get)38 b(a)h(named)f(k)m(eyw)m(ord)f(v)-7
+b(alue)1466 5422 y(from)37 b(a)i(FitsChan)2878 5307 y
+Fz(astGetFits)p Fc(<)p Fz(X)p Fc(>)0 5593 y Fd(Description:)44
b Fi(This)36 b(is)g(a)g(family)g(of)g(functions)g(whic)n(h)g(gets)g(a)g
(v)-5 b(alue)36 b(for)f(a)h(named)g(k)n(eyw)n(ord,)g(or)f(the)i(v)-5
-b(alue)36 b(of)227 3694 y(the)29 b(curren)n(t)f(card,)g(from)h(a)f
+b(alue)36 b(of)227 5693 y(the)29 b(curren)n(t)f(card,)g(from)h(a)f
(FitsChan)h(using)f(one)h(of)f(sev)n(eral)f(di\013eren)n(t)i(data)f(t)n
-(yp)r(es.)41 b(The)28 b(data)h(t)n(yp)r(e)g(of)f(the)227
-3794 y(returned)i(v)-5 b(alue)29 b(is)h(selected)g(b)n(y)f(replacing)g
+(yp)r(es.)41 b(The)28 b(data)h(t)n(yp)r(e)g(of)f(the)p
+eop end
+%%Page: 243 253
+TeXDict begin 243 252 bop 3643 52 a FF(243)227 351 y
+Fi(returned)30 b(v)-5 b(alue)29 b(is)h(selected)g(b)n(y)f(replacing)g
Fk(<)p Fi(X)p Fk(>)g Fi(in)h(the)g(function)g(name)g(b)n(y)g(one)f(of)h
-(the)g(follo)n(wing)f(strings)227 3893 y(represen)n(ting)d(the)i
-(recognised)e(FITS)i(data)f(t)n(yp)r(es:)340 4154 y Fh(\017)45
+(the)g(follo)n(wing)f(strings)227 451 y(represen)n(ting)d(the)i
+(recognised)e(FITS)i(data)f(t)n(yp)r(es:)340 716 y Fh(\017)45
b Fi(CF)28 b(-)f(Complex)h(\015oating)e(p)r(oin)n(t)i(v)-5
-b(alues.)340 4286 y Fh(\017)45 b Fi(CI)28 b(-)f(Complex)g(in)n(teger)g
-(v)-5 b(alues.)340 4418 y Fh(\017)45 b Fi(F)28 b(-)f(Floating)g(p)r
-(oin)n(t)h(v)-5 b(alues.)340 4551 y Fh(\017)45 b Fi(I)28
-b(-)f(In)n(teger)g(v)-5 b(alues.)340 4683 y Fh(\017)45
-b Fi(L)28 b(-)f(Logical)f(\(i.e.)38 b(b)r(o)r(olean\))27
-b(v)-5 b(alues.)340 4815 y Fh(\017)45 b Fi(S)28 b(-)f(String)h(v)-5
-b(alues.)340 4948 y Fh(\017)45 b Fi(CN)32 b(-)g(A)g Ft(")p
-Fi(CONTINUE)p Ft(")e Fi(v)-5 b(alue,)33 b(these)e(are)g(treated)g(lik)n
-(e)g(string)g(v)-5 b(alues,)33 b(but)f(are)f(enco)r(ded)g(without)427
-5047 y(an)d(equals)e(sign.)227 5209 y(The)i(data)f(t)n(yp)r(e)h(of)f
-(the)h Ft(")p Fi(v)-5 b(alue)p Ft(")27 b Fi(parameter)227
-5333 y(dep)r(ends)h(on)g Fk(<)p Fi(X)p Fk(>)f Fi(as)g(follo)n(ws:)340
-5593 y Fh(\017)45 b Fi(CF)29 b(-)f Ft(")p Fi(double)g
+b(alues.)340 851 y Fh(\017)45 b Fi(CI)28 b(-)f(Complex)g(in)n(teger)g
+(v)-5 b(alues.)340 985 y Fh(\017)45 b Fi(F)28 b(-)f(Floating)g(p)r(oin)
+n(t)h(v)-5 b(alues.)340 1119 y Fh(\017)45 b Fi(I)28 b(-)f(In)n(teger)g
+(v)-5 b(alues.)340 1253 y Fh(\017)45 b Fi(L)28 b(-)f(Logical)f(\(i.e.)
+38 b(b)r(o)r(olean\))27 b(v)-5 b(alues.)340 1388 y Fh(\017)45
+b Fi(S)28 b(-)f(String)h(v)-5 b(alues.)340 1522 y Fh(\017)45
+b Fi(CN)32 b(-)g(A)g Ft(")p Fi(CONTINUE)p Ft(")e Fi(v)-5
+b(alue,)33 b(these)e(are)g(treated)g(lik)n(e)g(string)g(v)-5
+b(alues,)33 b(but)f(are)f(enco)r(ded)g(without)427 1622
+y(an)d(equals)e(sign.)227 1786 y(The)i(data)f(t)n(yp)r(e)h(of)f(the)h
+Ft(")p Fi(v)-5 b(alue)p Ft(")27 b Fi(parameter)227 1912
+y(dep)r(ends)h(on)g Fk(<)p Fi(X)p Fk(>)f Fi(as)g(follo)n(ws:)340
+2178 y Fh(\017)45 b Fi(CF)29 b(-)f Ft(")p Fi(double)g
Fh(\003)p Ft(")f Fi(\(a)i(p)r(oin)n(ter)f(to)g(a)g(2)g(elemen)n(t)g
(arra)n(y)e(to)j(hold)f(the)h(real)e(and)h(imaginary)f(parts)h(of)g
-(the)427 5693 y(complex)f(v)-5 b(alue\).)p eop end
-%%Page: 243 253
-TeXDict begin 243 252 bop 3643 52 a FF(243)340 351 y
-Fh(\017)45 b Fi(CI)37 b(-)g Ft(")p Fi(in)n(t)g Fh(\003)p
-Ft(")f Fi(\(a)h(p)r(oin)n(ter)g(to)g(a)f(2)h(elemen)n(t)g(arra)n(y)e
-(to)i(hold)g(the)g(real)g(and)f(imaginary)g(parts)g(of)h(the)427
-451 y(complex)27 b(v)-5 b(alue\).)340 576 y Fh(\017)45
+(the)427 2277 y(complex)f(v)-5 b(alue\).)340 2412 y Fh(\017)45
+b Fi(CI)37 b(-)g Ft(")p Fi(in)n(t)g Fh(\003)p Ft(")f
+Fi(\(a)h(p)r(oin)n(ter)g(to)g(a)f(2)h(elemen)n(t)g(arra)n(y)e(to)i
+(hold)g(the)g(real)g(and)f(imaginary)g(parts)g(of)h(the)427
+2511 y(complex)27 b(v)-5 b(alue\).)340 2646 y Fh(\017)45
b Fi(F)28 b(-)f Ft(")p Fi(double)h Fh(\003)p Ft(")p Fi(.)340
-702 y Fh(\017)45 b Fi(I)28 b(-)f Ft(")p Fi(in)n(t)h Fh(\003)p
-Ft(")p Fi(.)340 827 y Fh(\017)45 b Fi(L)28 b(-)f Ft(")p
-Fi(in)n(t)h Fh(\003)p Ft(")p Fi(.)340 952 y Fh(\017)45
-b Fi(S)20 b(-)f Ft(")p Fi(c)n(har)e Fh(\003\003)p Ft(")h
-Fi(\(a)h(p)r(oin)n(ter)g(to)g(a)g(static)g Ft(")p Fi(c)n(har)p
-Ft(")e Fi(arra)n(y)g(is)i(returned)g(at)g(the)h(lo)r(cation)f(giv)n(en)
-f(b)n(y)h(the)h Ft(")p Fi(v)-5 b(alue)p Ft(")427 1052
-y Fi(parameter,)29 b(Note,)h(the)g(stored)f(string)g(ma)n(y)g(c)n
-(hange)f(on)h(subsequen)n(t)h(in)n(v)n(o)r(cations)e(of)h(astGetFitsS)h
-(so)427 1151 y(a)d(p)r(ermanen)n(t)h(cop)n(y)f(should)g(b)r(e)h(tak)n
-(en)f(of)g(the)h(string)f(if)h(necessary\).)340 1277
-y Fh(\017)45 b Fi(CN)28 b(-)g(Lik)n(e)p Ft(")p Fi(S)p
-Ft(")p Fi(.)0 1431 y Fd(Synopsis:)121 b Ft(int)42 b(astGetFits)p
+2780 y Fh(\017)45 b Fi(I)28 b(-)f Ft(")p Fi(in)n(t)h
+Fh(\003)p Ft(")p Fi(.)340 2914 y Fh(\017)45 b Fi(L)28
+b(-)f Ft(")p Fi(in)n(t)h Fh(\003)p Ft(")p Fi(.)340 3049
+y Fh(\017)45 b Fi(S)20 b(-)f Ft(")p Fi(c)n(har)e Fh(\003\003)p
+Ft(")h Fi(\(a)h(p)r(oin)n(ter)g(to)g(a)g(static)g Ft(")p
+Fi(c)n(har)p Ft(")e Fi(arra)n(y)g(is)i(returned)g(at)g(the)h(lo)r
+(cation)f(giv)n(en)f(b)n(y)h(the)h Ft(")p Fi(v)-5 b(alue)p
+Ft(")427 3148 y Fi(parameter,)29 b(Note,)h(the)g(stored)f(string)g(ma)n
+(y)g(c)n(hange)f(on)h(subsequen)n(t)h(in)n(v)n(o)r(cations)e(of)h
+(astGetFitsS)h(so)427 3248 y(a)d(p)r(ermanen)n(t)h(cop)n(y)f(should)g
+(b)r(e)h(tak)n(en)f(of)g(the)h(string)f(if)h(necessary\).)340
+3382 y Fh(\017)45 b Fi(CN)28 b(-)g(Lik)n(e)p Ft(")p Fi(S)p
+Ft(")p Fi(.)0 3547 y Fd(Synopsis:)121 b Ft(int)42 b(astGetFits)p
Fk(<)p Ft(X)p Fk(>)p Ft(\()c(AstFitsChan)h Fh(\003)p
Ft(this,)i(const)h(char)f Fh(\003)p Ft(name,)h Fk(<)p
-Ft(X)p Fk(>)p Ft(type)e Fh(\003)p Ft(value)h(\))0 1573
-y Fd(P)m(arameters:)259 1702 y(this)427 1802 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(FitsChan.)259 1927 y Fd(name)427 2026 y
+Ft(X)p Fk(>)p Ft(type)e Fh(\003)p Ft(value)h(\))0 3699
+y Fd(P)m(arameters:)259 3839 y(this)427 3938 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(FitsChan.)259 4072 y Fd(name)427 4172 y
Fi(P)n(oin)n(ter)f(to)i(a)f(n)n(ull-terminated)h(c)n(haracter)d(string)
i(con)n(taining)g(the)h(FITS)g(k)n(eyw)n(ord)e(name.)40
-b(This)28 b(ma)n(y)427 2126 y(b)r(e)i(a)f(complete)g(FITS)h(header)f
+b(This)28 b(ma)n(y)427 4272 y(b)r(e)i(a)f(complete)g(FITS)h(header)f
(card,)g(in)g(whic)n(h)h(case)e(the)i(k)n(eyw)n(ord)d(to)j(use)f(is)g
-(extracted)g(from)g(it.)43 b(No)427 2226 y(more)36 b(than)g(80)f(c)n
+(extracted)g(from)g(it.)43 b(No)427 4371 y(more)36 b(than)g(80)f(c)n
(haracters)f(are)h(read)g(from)h(this)g(string.)61 b(If)37
b(NULL)f(is)g(supplied,)j(the)d(v)-5 b(alue)36 b(of)g(the)427
-2325 y(curren)n(t)27 b(card)g(is)g(returned.)259 2451
-y Fd(v)-5 b(alue)427 2550 y Fi(A)39 b(p)r(oin)n(ter)g(to)f(a)h
+4471 y(curren)n(t)27 b(card)g(is)g(returned.)259 4605
+y Fd(v)-5 b(alue)427 4705 y Fi(A)39 b(p)r(oin)n(ter)g(to)f(a)h
(bu\013er)f(to)h(receiv)n(e)f(the)h(k)n(eyw)n(ord)d(v)-5
b(alue.)71 b(The)38 b(data)h(t)n(yp)r(e)f(dep)r(ends)i(on)e
-Fk(<)p Fi(X)p Fk(>)g Fi(as)427 2650 y(describ)r(ed)27
+Fk(<)p Fi(X)p Fk(>)g Fi(as)427 4805 y(describ)r(ed)27
b(ab)r(o)n(v)n(e.)36 b(The)27 b(conen)n(ts)g(of)g(the)g(bu\013er)h(on)f
(en)n(try)f(are)g(left)i(unc)n(hanged)f(if)h(the)f(k)n(eyw)n(ord)e(is)j
-(not)427 2750 y(found.)0 2904 y Fd(Returned)k(V)-8 b(alue:)259
-3033 y(astGetFits)p Fk(<)p Fd(X)p Fk(><)p Fd(X)p Fk(>)p
-Fd(\(\))427 3132 y Fi(A)21 b(v)-5 b(alue)20 b(of)g(zero)g(is)g
+(not)427 4904 y(found.)0 5069 y Fd(Returned)k(V)-8 b(alue:)259
+5208 y(astGetFits)p Fk(<)p Fd(X)p Fk(><)p Fd(X)p Fk(>)p
+Fd(\(\))427 5308 y Fi(A)21 b(v)-5 b(alue)20 b(of)g(zero)g(is)g
(returned)g(if)h(the)f(k)n(eyw)n(ord)f(w)n(as)g(not)i(found)f(in)h(the)
-g(FitsChan)f(\(no)g(error)f(is)h(rep)r(orted\).)427 3232
+g(FitsChan)f(\(no)g(error)f(is)h(rep)r(orted\).)427 5408
y(Otherwise,)27 b(a)g(v)-5 b(alue)28 b(of)f(one)g(is)h(returned.)0
-3386 y Fd(Notes:)340 3661 y Fh(\017)45 b Fi(If)32 b(a)e(name)h(is)g
-(supplied,)h(the)f(card)f(follo)n(wing)g(the)h(curren)n(t)f(card)g(is)h
-(c)n(hec)n(k)n(ed)f(\014rst.)46 b(If)31 b(this)h(is)e(not)h(the)427
-3761 y(required)25 b(card,)g(then)h(the)f(rest)g(of)h(the)f(FitsChan)h
-(is)f(searc)n(hed,)g(starting)f(with)i(the)g(\014rst)f(card)f(added)i
-(to)427 3861 y(the)c(FitsChan.)35 b(Therefore)19 b(cards)h(should)h(b)r
-(e)h(accessed)e(in)h(the)g(order)f(they)h(are)f(stored)h(in)g(the)h
-(FitsChan)427 3960 y(\(if)29 b(p)r(ossible\))e(as)g(this)h(will)g
+5572 y Fd(Notes:)p eop end
+%%Page: 244 254
+TeXDict begin 244 253 bop 0 52 a FF(244)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Fi(If)32 b(a)e(name)h(is)g(supplied,)h(the)f(card)f(follo)n(wing)g
+(the)h(curren)n(t)f(card)g(is)h(c)n(hec)n(k)n(ed)f(\014rst.)46
+b(If)31 b(this)h(is)e(not)h(the)427 451 y(required)25
+b(card,)g(then)h(the)f(rest)g(of)h(the)f(FitsChan)h(is)f(searc)n(hed,)g
+(starting)f(with)i(the)g(\014rst)f(card)f(added)i(to)427
+551 y(the)c(FitsChan.)35 b(Therefore)19 b(cards)h(should)h(b)r(e)h
+(accessed)e(in)h(the)g(order)f(they)h(are)f(stored)h(in)g(the)h
+(FitsChan)427 650 y(\(if)29 b(p)r(ossible\))e(as)g(this)h(will)g
(minimise)g(the)g(time)g(sp)r(en)n(t)g(searc)n(hing)e(for)h(cards.)340
-4086 y Fh(\017)45 b Fi(If)28 b(the)f(requested)f(card)g(is)h(found,)h
+799 y Fh(\017)45 b Fi(If)28 b(the)f(requested)f(card)g(is)h(found,)h
(it)f(b)r(ecomes)g(the)g(curren)n(t)f(card,)g(otherwise)h(the)g(curren)
-n(t)f(card)g(is)h(left)427 4185 y(p)r(oin)n(ting)h(at)f(the)h
-Ft(")p Fi(end-of-\014le)p Ft(")p Fi(.)340 4311 y Fh(\017)45
+n(t)f(card)g(is)h(left)427 899 y(p)r(oin)n(ting)h(at)f(the)h
+Ft(")p Fi(end-of-\014le)p Ft(")p Fi(.)340 1048 y Fh(\017)45
b Fi(If)34 b(the)f(stored)f(k)n(eyw)n(ord)f(v)-5 b(alue)33
b(is)f(not)h(of)g(the)g(requested)f(t)n(yp)r(e,)j(it)e(is)g(con)n(v)n
-(erted)e(in)n(to)i(the)g(requested)427 4410 y(t)n(yp)r(e.)340
-4536 y Fh(\017)45 b Fi(If)33 b(the)f(k)n(eyw)n(ord)f(is)h(found)g(in)g
+(erted)e(in)n(to)i(the)g(requested)427 1147 y(t)n(yp)r(e.)340
+1296 y Fh(\017)45 b Fi(If)33 b(the)f(k)n(eyw)n(ord)f(is)h(found)g(in)g
(the)h(FitsChan,)g(but)g(has)f(no)f(asso)r(ciated)g(v)-5
-b(alue,)33 b(an)f(error)e(is)i(rep)r(orted.)427 4635
+b(alue,)33 b(an)f(error)e(is)i(rep)r(orted.)427 1396
y(If)e(necessary)-7 b(,)27 b(the)i(astT)-7 b(estFits)29
b(function)h(can)e(b)r(e)h(used)g(to)g(determine)g(if)g(the)g(k)n(eyw)n
-(ord)e(has)i(a)f(de\014ned)427 4735 y(v)-5 b(alue)28
+(ord)e(has)i(a)f(de\014ned)427 1495 y(v)-5 b(alue)28
b(in)g(the)g(FitsChan)f(prior)g(to)g(calling)g(this)h(function.)340
-4860 y Fh(\017)45 b Fi(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)
+1644 y Fh(\017)45 b Fi(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)
h(the)g(k)n(eyw)n(ord)d(name)j(do)r(es)f(not)h(conform)e(to)i(FITS)g
-(requiremen)n(ts.)340 4985 y Fh(\017)45 b Fi(Zero)340
-5111 y Fh(\017)g Fi(.F)-9 b(ALSE.)26 b(is)g(returned)g(as)f(the)i
+(requiremen)n(ts.)340 1793 y Fh(\017)45 b Fi(Zero)340
+1942 y Fh(\017)g Fi(.F)-9 b(ALSE.)26 b(is)g(returned)g(as)f(the)i
(function)f(v)-5 b(alue)26 b(if)h(an)f(error)e(has)h(already)g(o)r
-(ccurred,)g(or)g(if)i(this)f(function)427 5210 y(should)i(fail)f(for)g
-(an)n(y)g(reason.)340 5336 y Fh(\017)45 b Fi(The)34 b(FITS)g(standard)e
+(ccurred,)g(or)g(if)i(this)f(function)427 2042 y(should)i(fail)f(for)g
+(an)n(y)g(reason.)340 2191 y Fh(\017)45 b Fi(The)34 b(FITS)g(standard)e
(sa)n(ys)g(that)i(string)f(k)n(eyw)n(ord)e(v)-5 b(alues)33
b(should)h(b)r(e)f(padded)h(with)g(trailing)f(spaces)427
-5435 y(if)f(they)f(are)f(shorter)g(than)h(8)g(c)n(haracters.)45
+2290 y(if)f(they)f(are)f(shorter)g(than)h(8)g(c)n(haracters.)45
b(F)-7 b(or)30 b(this)h(reason,)g(trailing)f(spaces)g(are)g(remo)n(v)n
-(ed)g(from)g(the)427 5535 y(string)f(returned)h(b)n(y)f(astGetFitsS)i
+(ed)g(from)g(the)427 2390 y(string)f(returned)h(b)n(y)f(astGetFitsS)i
(if)f(the)g(original)f(string)g(\(including)h(an)n(y)f(trailing)g
-(spaces\))h(con)n(tains)427 5635 y(8)d(or)g(few)n(er)g(c)n(haracters.)
+(spaces\))h(con)n(tains)427 2489 y(8)d(or)g(few)n(er)g(c)n(haracters.)
35 b(T)-7 b(railing)26 b(spaces)h(are)g(not)g(remo)n(v)n(ed)f(from)h
-(longer)g(strings.)p eop end
-%%Page: 244 254
-TeXDict begin 244 253 bop 0 52 a FF(244)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 482 a Fz(astGetF)-11 b(rame)925 483 y Fe(Obtain)37
-b(a)i(p)s(oin)m(ter)e(to)h(a)h(sp)s(eci\014ed)g(F)-10
-b(rame)1531 596 y(in)39 b(a)f(F)-10 b(rameSet)3022 482
-y Fz(astGetF)f(rame)0 800 y Fd(Description:)44 b Fi(This)28
-b(function)g(returns)f(a)g(p)r(oin)n(ter)g(to)h(a)f(sp)r(eci\014ed)h(F)
--7 b(rame)27 b(in)h(a)f(F)-7 b(rameSet.)0 988 y Fd(Synopsis:)121
-b Ft(AstFrame)40 b Fh(\003)p Ft(astGetFrame\()e(AstFrameSet)h
-Fh(\003)p Ft(this,)i(int)i(iframe)e(\))0 1175 y Fd(P)m(arameters:)259
-1350 y(this)427 1449 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
-b(rameSet.)259 1601 y Fd(iframe)427 1701 y Fi(The)35
-b(index)g(of)f(the)h(required)f(F)-7 b(rame)34 b(within)h(the)g(F)-7
-b(rameSet.)58 b(This)35 b(v)-5 b(alue)34 b(should)g(lie)h(in)g(the)g
-(range)427 1801 y(from)28 b(1)f(to)g(the)h(n)n(um)n(b)r(er)g(of)f(F)-7
+(longer)g(strings.)p 0 2721 3780 12 v 0 2852 a Fz(astGetF)-11
+b(rame)925 2853 y Fe(Obtain)37 b(a)i(p)s(oin)m(ter)e(to)h(a)h(sp)s
+(eci\014ed)g(F)-10 b(rame)1531 2966 y(in)39 b(a)f(F)-10
+b(rameSet)3022 2852 y Fz(astGetF)f(rame)0 3164 y Fd(Description:)44
+b Fi(This)28 b(function)g(returns)f(a)g(p)r(oin)n(ter)g(to)h(a)f(sp)r
+(eci\014ed)h(F)-7 b(rame)27 b(in)h(a)f(F)-7 b(rameSet.)0
+3345 y Fd(Synopsis:)121 b Ft(AstFrame)40 b Fh(\003)p
+Ft(astGetFrame\()e(AstFrameSet)h Fh(\003)p Ft(this,)i(int)i(iframe)e
+(\))0 3527 y Fd(P)m(arameters:)259 3695 y(this)427 3795
+y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7 b(rameSet.)259
+3944 y Fd(iframe)427 4043 y Fi(The)35 b(index)g(of)f(the)h(required)f
+(F)-7 b(rame)34 b(within)h(the)g(F)-7 b(rameSet.)58 b(This)35
+b(v)-5 b(alue)34 b(should)g(lie)h(in)g(the)g(range)427
+4143 y(from)28 b(1)f(to)g(the)h(n)n(um)n(b)r(er)g(of)f(F)-7
b(rames)27 b(in)h(the)g(F)-7 b(rameSet)27 b(\(as)g(giv)n(en)g(b)n(y)g
-(its)h(Nframe)g(attribute\).)0 2001 y Fd(Returned)k(V)-8
-b(alue:)259 2175 y(astGetF)g(rame\(\))427 2275 y Fi(A)28
+(its)h(Nframe)g(attribute\).)0 4337 y Fd(Returned)k(V)-8
+b(alue:)259 4506 y(astGetF)g(rame\(\))427 4605 y Fi(A)28
b(p)r(oin)n(ter)f(to)h(the)g(requested)f(F)-7 b(rame.)0
-2475 y Fd(Notes:)340 2796 y Fh(\017)45 b Fi(A)32 b(v)-5
+4799 y Fd(Notes:)340 5114 y Fh(\017)45 b Fi(A)32 b(v)-5
b(alue)30 b(of)h(AST)p Ft(__)p Fi(BASE)g(or)f(AST)p Ft(__)p
Fi(CURRENT)h(ma)n(y)f(b)r(e)h(giv)n(en)g(for)f(the)h
-Ft(")p Fi(iframe)p Ft(")f Fi(parameter)g(to)427 2895
+Ft(")p Fi(iframe)p Ft(")f Fi(parameter)g(to)427 5214
y(sp)r(ecify)e(the)g(base)f(F)-7 b(rame)27 b(or)g(the)h(curren)n(t)f(F)
--7 b(rame)27 b(resp)r(ectiv)n(ely)-7 b(.)340 3047 y Fh(\017)45
+-7 b(rame)27 b(resp)r(ectiv)n(ely)-7 b(.)340 5362 y Fh(\017)45
b Fi(This)28 b(function)g(incremen)n(ts)f(the)h(RefCoun)n(t)g
(attribute)g(of)f(the)h(selected)g(F)-7 b(rame)27 b(b)n(y)g(one.)340
-3199 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
+5511 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g
(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427
-3299 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
-(for)f(an)n(y)g(reason.)p 0 3536 V 0 3668 a Fz(astGetGrfCon)l(text)183
-b Fe(Return)38 b(the)h(KeyMap)g(that)1216 3782 y(describ)s(es)e(a)f
-(Plot's)f(graphics)1701 3882 y(con)m(text)2715 3668 y
-Fz(astGetGrfCon)l(text)0 4086 y Fd(Description:)44 b
-Fi(This)20 b(function)g(returns)f(a)h(reference)f(to)g(a)g(KeyMap)g
-(that)h(will)g(b)r(e)g(passed)f(to)h(an)n(y)f(dra)n(wing)f(functions)
-227 4185 y(registered)24 b(using)g(astGrfSet.)36 b(This)25
-b(KeyMap)f(can)h(b)r(e)g(used)g(b)n(y)f(an)h(application)f(to)h(pass)f
-(information)g(to)h(the)227 4285 y(dra)n(wing)i(functions)h(ab)r(out)g
-(the)g(con)n(text)g(in)g(whic)n(h)g(they)g(are)f(b)r(eing)h(called.)38
-b(The)28 b(con)n(ten)n(ts)f(of)h(the)h(KeyMap)227 4385
-y(are)e(nev)n(er)f(accessed)h(b)n(yt)g(the)h(Plot)g(class)e(itself.)0
-4572 y Fd(Synopsis:)121 b Ft(AstKeyMap)40 b Fh(\003)p
-Ft(astGetGrfConte)o(xt\()d(AstPlot)j Fh(\003)p Ft(this)i(\))0
-4760 y Fd(P)m(arameters:)259 4934 y(this)427 5034 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(Plot.)0 5234 y Fd(Returned)k(V)-8 b(alue:)259
-5409 y(astGetGrfCon)m(text\(\))427 5508 y Fi(A)31 b(p)r(oin)n(ter)f(to)
-h(the)g(graphics)e(con)n(text)h(KeyMap.)45 b(The)31 b(returned)f(p)r
-(oin)n(ter)h(should)f(b)r(e)h(ann)n(ulled)f(when)427
-5608 y(it)e(is)g(no)f(longer)f(needed.)p eop end
+5611 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
+(for)f(an)n(y)g(reason.)p eop end
%%Page: 245 255
TeXDict begin 245 254 bop 3643 52 a FF(245)p 0 351 3780
-12 v 0 483 a Fz(astGetMapping)153 b Fe(Obtain)36 b(a)h(Mapping)f(that)g
-(con)m(v)m(erts)1253 598 y(b)s(et)m(w)m(een)i(t)m(w)m(o)f(F)-10
-b(rames)38 b(in)h(a)1648 697 y(F)-10 b(rameSet)2868 483
-y Fz(astGetMapping)0 861 y Fd(Description:)44 b Fi(This)31
-b(function)h(returns)e(a)h(p)r(oin)n(ter)f(to)h(a)g(Mapping)g(that)g
-(will)g(con)n(v)n(ert)f(co)r(ordinates)f(b)r(et)n(w)n(een)i(the)227
-961 y(co)r(ordinate)c(systems)g(represen)n(ted)f(b)n(y)i(t)n(w)n(o)e(F)
--7 b(rames)27 b(in)h(a)f(F)-7 b(rameSet.)0 1109 y Fd(Synopsis:)121
-b Ft(AstMapping)39 b Fh(\003)p Ft(astGetMapping\()f(AstFrameSet)h
-Fh(\003)p Ft(this,)i(int)h(iframe1,)e(int)j(iframe2)d(\))0
-1258 y Fd(P)m(arameters:)259 1394 y(this)427 1493 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(F)-7 b(rameSet.)259 1625 y Fd(iframe1)427
-1725 y Fi(The)31 b(index)g(of)g(the)h(\014rst)e(F)-7
-b(rame)31 b(in)g(the)g(F)-7 b(rameSet.)47 b(This)31 b(F)-7
-b(rame)30 b(describ)r(es)h(the)g(co)r(ordinate)f(system)427
-1824 y(for)d(the)h Ft(")p Fi(input)p Ft(")g Fi(end)g(of)f(the)h
-(Mapping.)259 1956 y Fd(iframe2)427 2056 y Fi(The)d(index)f(of)h(the)f
-(second)g(F)-7 b(rame)24 b(in)h(the)f(F)-7 b(rameSet.)36
-b(This)24 b(F)-7 b(rame)24 b(describ)r(es)g(the)h(co)r(ordinate)e
-(system)427 2156 y(for)k(the)h Ft(")p Fi(output)p Ft(")g
-Fi(end)f(of)h(the)g(Mapping.)0 2317 y Fd(Returned)k(V)-8
-b(alue:)259 2452 y(astGetMapping\(\))427 2552 y Fi(P)n(oin)n(ter)30
-b(to)h(a)f(Mapping)h(whose)g(forw)n(ard)e(transformation)g(con)n(v)n
-(erts)h(co)r(ordinates)f(from)i(the)h(\014rst)e(co-)427
-2652 y(ordinate)25 b(system)h(to)f(the)h(second)f(one,)h(and)g(whose)f
-(in)n(v)n(erse)f(transformation)g(con)n(v)n(erts)g(co)r(ordinates)g(in)
-427 2751 y(the)k(opp)r(osite)f(direction.)0 2912 y Fd(Notes:)340
-3194 y Fh(\017)45 b Fi(The)23 b(returned)g(Mapping)f(will)h(include)h
-(the)f(clipping)g(e\013ect)g(of)g(an)n(y)f(Regions)g(whic)n(h)h(o)r
-(ccur)g(on)f(the)h(path)427 3294 y(b)r(et)n(w)n(een)28
-b(the)g(t)n(w)n(o)f(supplied)h(F)-7 b(rames)26 b(\(this)j(includes)e
-(the)h(t)n(w)n(o)f(supplied)h(F)-7 b(rames)27 b(themselv)n(es\).)340
-3426 y Fh(\017)45 b Fi(The)33 b(v)-5 b(alues)33 b(giv)n(en)g(for)f(the)
-i Ft(")p Fi(iframe1)p Ft(")d Fi(and)i Ft(")p Fi(iframe2)p
+12 v 0 483 a Fz(astGetGrfCon)l(text)183 b Fe(Return)38
+b(the)h(KeyMap)g(that)1216 598 y(describ)s(es)e(a)f(Plot's)f(graphics)
+1701 697 y(con)m(text)2715 483 y Fz(astGetGrfCon)l(text)0
+845 y Fd(Description:)44 b Fi(This)20 b(function)g(returns)f(a)h
+(reference)f(to)g(a)g(KeyMap)g(that)h(will)g(b)r(e)g(passed)f(to)h(an)n
+(y)f(dra)n(wing)f(functions)227 945 y(registered)24 b(using)g
+(astGrfSet.)36 b(This)25 b(KeyMap)f(can)h(b)r(e)g(used)g(b)n(y)f(an)h
+(application)f(to)h(pass)f(information)g(to)h(the)227
+1045 y(dra)n(wing)i(functions)h(ab)r(out)g(the)g(con)n(text)g(in)g
+(whic)n(h)g(they)g(are)f(b)r(eing)h(called.)38 b(The)28
+b(con)n(ten)n(ts)f(of)h(the)h(KeyMap)227 1144 y(are)e(nev)n(er)f
+(accessed)h(b)n(yt)g(the)h(Plot)g(class)e(itself.)0 1285
+y Fd(Synopsis:)121 b Ft(AstKeyMap)40 b Fh(\003)p Ft(astGetGrfConte)o
+(xt\()d(AstPlot)j Fh(\003)p Ft(this)i(\))0 1426 y Fd(P)m(arameters:)259
+1553 y(this)427 1653 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)0
+1806 y Fd(Returned)k(V)-8 b(alue:)259 1934 y(astGetGrfCon)m(text\(\))
+427 2033 y Fi(A)31 b(p)r(oin)n(ter)f(to)h(the)g(graphics)e(con)n(text)h
+(KeyMap.)45 b(The)31 b(returned)f(p)r(oin)n(ter)h(should)f(b)r(e)h(ann)
+n(ulled)f(when)427 2133 y(it)e(is)g(no)f(longer)f(needed.)p
+0 2315 V 0 2447 a Fz(astGetMapping)153 b Fe(Obtain)36
+b(a)h(Mapping)f(that)g(con)m(v)m(erts)1253 2561 y(b)s(et)m(w)m(een)i(t)
+m(w)m(o)f(F)-10 b(rames)38 b(in)h(a)1648 2661 y(F)-10
+b(rameSet)2868 2447 y Fz(astGetMapping)0 2809 y Fd(Description:)44
+b Fi(This)31 b(function)h(returns)e(a)h(p)r(oin)n(ter)f(to)h(a)g
+(Mapping)g(that)g(will)g(con)n(v)n(ert)f(co)r(ordinates)f(b)r(et)n(w)n
+(een)i(the)227 2909 y(co)r(ordinate)c(systems)g(represen)n(ted)f(b)n(y)
+i(t)n(w)n(o)e(F)-7 b(rames)27 b(in)h(a)f(F)-7 b(rameSet.)0
+3049 y Fd(Synopsis:)121 b Ft(AstMapping)39 b Fh(\003)p
+Ft(astGetMapping\()f(AstFrameSet)h Fh(\003)p Ft(this,)i(int)h(iframe1,)
+e(int)j(iframe2)d(\))0 3190 y Fd(P)m(arameters:)259 3318
+y(this)427 3417 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rameSet.)259 3541 y Fd(iframe1)427 3641 y Fi(The)31
+b(index)g(of)g(the)h(\014rst)e(F)-7 b(rame)31 b(in)g(the)g(F)-7
+b(rameSet.)47 b(This)31 b(F)-7 b(rame)30 b(describ)r(es)h(the)g(co)r
+(ordinate)f(system)427 3741 y(for)d(the)h Ft(")p Fi(input)p
+Ft(")g Fi(end)g(of)f(the)h(Mapping.)259 3865 y Fd(iframe2)427
+3964 y Fi(The)d(index)f(of)h(the)f(second)g(F)-7 b(rame)24
+b(in)h(the)f(F)-7 b(rameSet.)36 b(This)24 b(F)-7 b(rame)24
+b(describ)r(es)g(the)h(co)r(ordinate)e(system)427 4064
+y(for)k(the)h Ft(")p Fi(output)p Ft(")g Fi(end)f(of)h(the)g(Mapping.)0
+4217 y Fd(Returned)k(V)-8 b(alue:)259 4345 y(astGetMapping\(\))427
+4445 y Fi(P)n(oin)n(ter)30 b(to)h(a)f(Mapping)h(whose)g(forw)n(ard)e
+(transformation)g(con)n(v)n(erts)h(co)r(ordinates)f(from)i(the)h
+(\014rst)e(co-)427 4544 y(ordinate)25 b(system)h(to)f(the)h(second)f
+(one,)h(and)g(whose)f(in)n(v)n(erse)f(transformation)g(con)n(v)n(erts)g
+(co)r(ordinates)g(in)427 4644 y(the)k(opp)r(osite)f(direction.)0
+4797 y Fd(Notes:)340 5071 y Fh(\017)45 b Fi(The)23 b(returned)g
+(Mapping)f(will)h(include)h(the)f(clipping)g(e\013ect)g(of)g(an)n(y)f
+(Regions)g(whic)n(h)h(o)r(ccur)g(on)f(the)h(path)427
+5170 y(b)r(et)n(w)n(een)28 b(the)g(t)n(w)n(o)f(supplied)h(F)-7
+b(rames)26 b(\(this)j(includes)e(the)h(t)n(w)n(o)f(supplied)h(F)-7
+b(rames)27 b(themselv)n(es\).)340 5295 y Fh(\017)45 b
+Fi(The)33 b(v)-5 b(alues)33 b(giv)n(en)g(for)f(the)i
+Ft(")p Fi(iframe1)p Ft(")d Fi(and)i Ft(")p Fi(iframe2)p
Ft(")f Fi(parameters)f(should)i(lie)g(in)h(the)f(range)f(from)427
-3525 y(1)g(to)f(the)h(n)n(um)n(b)r(er)g(of)g(F)-7 b(rames)31
+5394 y(1)g(to)f(the)h(n)n(um)n(b)r(er)g(of)g(F)-7 b(rames)31
b(in)h(the)g(F)-7 b(rameSet)32 b(\(as)f(giv)n(en)g(b)n(y)g(its)h
(Nframe)g(attribute\).)50 b(A)32 b(v)-5 b(alue)32 b(of)427
-3625 y(AST)p Ft(__)p Fi(BASE)25 b(or)g(AST)p Ft(__)p
+5494 y(AST)p Ft(__)p Fi(BASE)25 b(or)g(AST)p Ft(__)p
Fi(CURRENT)g(ma)n(y)g(also)g(b)r(e)h(giv)n(en)e(to)i(iden)n(tify)g(the)
-g(F)-7 b(rameSet's)25 b(base)g(F)-7 b(rame)427 3725 y(or)30
+g(F)-7 b(rameSet's)25 b(base)g(F)-7 b(rame)427 5593 y(or)30
b(curren)n(t)f(F)-7 b(rame)29 b(resp)r(ectiv)n(ely)-7
b(.)44 b(It)31 b(is)f(p)r(ermissible)g(for)f(b)r(oth)i(these)f
-(parameters)f(to)h(ha)n(v)n(e)f(the)h(same)427 3824 y(v)-5
+(parameters)f(to)h(ha)n(v)n(e)f(the)h(same)427 5693 y(v)-5
b(alue,)28 b(in)g(whic)n(h)f(case)g(a)g(unit)h(Mapping)g(\(UnitMap\))g
-(is)g(returned.)340 3956 y Fh(\017)45 b Fi(It)36 b(should)f(alw)n(a)n
-(ys)e(b)r(e)j(p)r(ossible)e(to)h(generate)f(the)i(Mapping)f(requested,)
-h(but)g(this)f(do)r(es)g(necessarily)427 4056 y(guaran)n(tee)d(that)j
-(it)f(will)g(b)r(e)g(able)g(to)g(p)r(erform)f(the)i(required)e(co)r
-(ordinate)f(con)n(v)n(ersion.)54 b(If)34 b(necessary)-7
-b(,)427 4155 y(the)26 b(T)-7 b(ranF)g(orw)n(ard)22 b(and)j(T)-7
-b(ranIn)n(v)n(erse)23 b(attributes)h(of)h(the)h(returned)e(Mapping)h
-(should)g(b)r(e)g(insp)r(ected)h(to)427 4255 y(determine)i(if)g(the)g
-(required)f(transformation)f(is)h(a)n(v)-5 b(ailable.)340
-4387 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
-b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g
-(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427
-4487 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
-(for)f(an)n(y)g(reason.)p 0 4684 V 0 4816 a Fz(astGetRefP)l(os)225
+(is)g(returned.)p eop end
+%%Page: 246 256
+TeXDict begin 246 255 bop 0 52 a FF(246)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Fi(It)36 b(should)f(alw)n(a)n(ys)e(b)r(e)j(p)r(ossible)e(to)h
+(generate)f(the)i(Mapping)f(requested,)h(but)g(this)f(do)r(es)g
+(necessarily)427 451 y(guaran)n(tee)d(that)j(it)f(will)g(b)r(e)g(able)g
+(to)g(p)r(erform)f(the)i(required)e(co)r(ordinate)f(con)n(v)n(ersion.)
+54 b(If)34 b(necessary)-7 b(,)427 551 y(the)26 b(T)-7
+b(ranF)g(orw)n(ard)22 b(and)j(T)-7 b(ranIn)n(v)n(erse)23
+b(attributes)h(of)h(the)h(returned)e(Mapping)h(should)g(b)r(e)g(insp)r
+(ected)h(to)427 650 y(determine)i(if)g(the)g(required)f(transformation)
+f(is)h(a)n(v)-5 b(ailable.)340 788 y Fh(\017)45 b Fi(A)35
+b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
+Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 887 y(AST)28
+b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
+(reason.)p 0 1096 3780 12 v 0 1228 a Fz(astGetRefP)l(os)225
b Fe(Return)38 b(the)h(reference)f(p)s(osition)f(in)h(a)970
-4931 y(sp)s(eci\014ed)h(celestial)e(co)s(ordinate)f(system)2978
-4816 y Fz(astGetRefP)l(os)0 5122 y Fd(Description:)44
+1342 y(sp)s(eci\014ed)h(celestial)e(co)s(ordinate)f(system)2978
+1228 y Fz(astGetRefP)l(os)0 1545 y Fd(Description:)44
b Fi(This)30 b(function)g(returns)f(the)h(reference)f(p)r(osition)g
(\(sp)r(eci\014ed)i(b)n(y)e(attributes)h(RefRA)g(and)g(RefDec\))227
-5222 y(con)n(v)n(erted)k(to)g(the)i(celestial)e(co)r(ordinate)g(system)
+1645 y(con)n(v)n(erted)k(to)g(the)i(celestial)e(co)r(ordinate)g(system)
g(represen)n(ted)g(b)n(y)h(a)f(supplied)h(SkyF)-7 b(rame.)58
-b(The)35 b(celestial)227 5322 y(longitude)28 b(and)f(latitude)h(v)-5
-b(alues)27 b(are)g(returned)g(in)h(radians.)0 5470 y
+b(The)35 b(celestial)227 1744 y(longitude)28 b(and)f(latitude)h(v)-5
+b(alues)27 b(are)g(returned)g(in)h(radians.)0 1903 y
Fd(Synopsis:)121 b Ft(void)42 b(astGetRefPos\()c(AstSpecFrame)h
Fh(\003)p Ft(this,)i(AstSkyFrame)e Fh(\003)p Ft(frm,)i(double)g
-Fh(\003)p Ft(lon,)h(double)227 5570 y Fh(\003)p Ft(lat)g(\))0
-5718 y Fd(P)m(arameters:)p eop end
-%%Page: 246 256
-TeXDict begin 246 255 bop 0 52 a FF(246)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(this)427
-451 y Fi(P)n(oin)n(ter)c(to)i(the)g(Sp)r(ecF)-7 b(rame.)259
-584 y Fd(frm)427 684 y Fi(P)n(oin)n(ter)34 b(to)h(the)h(SkyF)-7
-b(rame)34 b(whic)n(h)h(de\014nes)g(the)h(required)e(celestial)h(co)r
-(ordinate)f(system.)60 b(If)35 b(NULL)427 784 y(is)c(supplied,)h(then)g
-(the)f(longitude)g(and)g(latitude)g(v)-5 b(alues)31 b(are)f(returned)h
-(as)f(FK5)g(J2000)f(RA)i(and)g(Dec)427 883 y(v)-5 b(alues.)259
-1017 y Fd(lon)427 1116 y Fi(A)25 b(p)r(oin)n(ter)f(to)g(a)g(double)g
+Fh(\003)p Ft(lon,)h(double)227 2003 y Fh(\003)p Ft(lat)g(\))0
+2162 y Fd(P)m(arameters:)259 2307 y(this)427 2407 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(Sp)r(ecF)-7 b(rame.)259 2544 y Fd(frm)427
+2644 y Fi(P)n(oin)n(ter)34 b(to)h(the)h(SkyF)-7 b(rame)34
+b(whic)n(h)h(de\014nes)g(the)h(required)e(celestial)h(co)r(ordinate)f
+(system.)60 b(If)35 b(NULL)427 2744 y(is)c(supplied,)h(then)g(the)f
+(longitude)g(and)g(latitude)g(v)-5 b(alues)31 b(are)f(returned)h(as)f
+(FK5)g(J2000)f(RA)i(and)g(Dec)427 2843 y(v)-5 b(alues.)259
+2981 y Fd(lon)427 3080 y Fi(A)25 b(p)r(oin)n(ter)f(to)g(a)g(double)g
(in)h(whic)n(h)f(to)g(store)f(the)i(longitude)f(of)g(the)h(reference)e
-(p)r(oin)n(t,)j(in)e(the)h(co)r(ordinate)427 1216 y(system)j(represen)n
+(p)r(oin)n(t,)j(in)e(the)h(co)r(ordinate)427 3180 y(system)j(represen)n
(ted)e(b)n(y)h(the)h(supplied)g(SkyF)-7 b(rame)27 b(\(radians\).)259
-1349 y Fd(lat)427 1449 y Fi(A)h(p)r(oin)n(ter)f(to)h(a)f(double)h(in)f
+3318 y Fd(lat)427 3417 y Fi(A)h(p)r(oin)n(ter)f(to)h(a)f(double)h(in)f
(whic)n(h)h(to)f(store)g(the)h(latitude)g(of)f(the)h(reference)f(p)r
-(oin)n(t,)h(in)g(the)g(co)r(ordinate)427 1548 y(system)g(represen)n
+(oin)n(t,)h(in)g(the)g(co)r(ordinate)427 3517 y(system)g(represen)n
(ted)e(b)n(y)h(the)h(supplied)g(SkyF)-7 b(rame)27 b(\(radians\).)0
-1711 y Fd(Notes:)340 1995 y Fh(\017)45 b Fi(V)-7 b(alues)29
+3688 y Fd(Notes:)340 3980 y Fh(\017)45 b Fi(V)-7 b(alues)29
b(of)g(AST)p Ft(__)p Fi(BAD)g(will)g(b)r(e)h(returned)e(if)i(this)f
(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(the)f(AST)h(error)d(status)
-427 2095 y(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)p 0 2295 3780 12 v 0 2427 a Fz(astGetRegionBounds)349
-b Fe(Returns)39 b(the)1472 2526 y(b)s(ounding)f(b)s(o)m(x)g(of)1713
-2639 y(Region)2541 2427 y Fz(astGetRegionBounds)0 2829
+427 4080 y(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
+(reason.)p 0 4288 V 0 4420 a Fz(astGetRegionBounds)349
+b Fe(Returns)39 b(the)1472 4520 y(b)s(ounding)f(b)s(o)m(x)g(of)1713
+4633 y(Region)2541 4420 y Fz(astGetRegionBounds)0 4831
y Fd(Description:)44 b Fi(This)36 b(function)g(returns)f(the)i(upp)r
(er)f(and)f(lo)n(w)n(er)f(limits)j(of)e(a)h(b)r(o)n(x)f(whic)n(h)h
-(just)g(encompasses)e(the)227 2929 y(supplied)40 b(Region.)72
+(just)g(encompasses)e(the)227 4931 y(supplied)40 b(Region.)72
b(The)40 b(limits)f(are)g(returned)g(as)g(axis)g(v)-5
b(alues)39 b(within)h(the)g(F)-7 b(rame)39 b(represen)n(ted)f(b)n(y)h
-(the)227 3029 y(Region.)g(The)29 b(v)-5 b(alue)29 b(of)f(the)h(Negated)
+(the)227 5030 y(Region.)g(The)29 b(v)-5 b(alue)29 b(of)f(the)h(Negated)
f(attribute)h(is)g(ignored)e(\(i.e.)40 b(it)29 b(is)g(assumed)f(that)h
-(the)g(Region)f(has)g(not)227 3128 y(b)r(een)g(negated\).)0
-3279 y Fd(Synopsis:)121 b Ft(void)42 b(astGetRegionBoun)o(ds)o(\()c
+(the)g(Region)f(has)g(not)227 5130 y(b)r(een)g(negated\).)0
+5289 y Fd(Synopsis:)121 b Ft(void)42 b(astGetRegionBoun)o(ds)o(\()c
(AstRegion)h Fh(\003)p Ft(this,)i(double)h Fh(\003)p
-Ft(lbnd,)f(double)g Fh(\003)p Ft(ubnd)g(\))0 3429 y Fd(P)m(arameters:)
-259 3567 y(this)427 3666 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Region.)259
-3800 y Fd(lbnd)427 3899 y Fi(P)n(oin)n(ter)22 b(to)h(an)g(arra)n(y)d
-(in)k(whic)n(h)f(to)g(return)f(the)i(lo)n(w)n(er)d(axis)i(b)r(ounds)g
-(co)n(v)n(ered)e(b)n(y)i(the)h(Region.)34 b(It)24 b(should)427
-3999 y(ha)n(v)n(e)h(at)h(least)g(as)f(man)n(y)g(elemen)n(ts)h(as)g
+Ft(lbnd,)f(double)g Fh(\003)p Ft(ubnd)g(\))0 5448 y Fd(P)m(arameters:)
+259 5593 y(this)427 5693 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Region.)p
+eop end
+%%Page: 247 257
+TeXDict begin 247 256 bop 3643 52 a FF(247)259 351 y
+Fd(lbnd)427 451 y Fi(P)n(oin)n(ter)22 b(to)h(an)g(arra)n(y)d(in)k(whic)
+n(h)f(to)g(return)f(the)i(lo)n(w)n(er)d(axis)i(b)r(ounds)g(co)n(v)n
+(ered)e(b)n(y)i(the)h(Region.)34 b(It)24 b(should)427
+551 y(ha)n(v)n(e)h(at)h(least)g(as)f(man)n(y)g(elemen)n(ts)h(as)g
(there)f(are)g(axes)g(in)i(the)f(Region.)36 b(If)26 b(an)g(axis)f(has)h
-(no)f(lo)n(w)n(er)g(limit,)427 4099 y(the)j(returned)f(v)-5
+(no)f(lo)n(w)n(er)g(limit,)427 650 y(the)j(returned)f(v)-5
b(alue)28 b(will)g(b)r(e)g(the)g(largest)e(p)r(ossible)h(negativ)n(e)g
-(v)-5 b(alue.)259 4232 y Fd(ubnd)427 4332 y Fi(P)n(oin)n(ter)20
+(v)-5 b(alue.)259 784 y Fd(ubnd)427 883 y Fi(P)n(oin)n(ter)20
b(to)i(an)g(arra)n(y)d(in)j(whic)n(h)g(to)g(return)f(the)i(upp)r(er)f
(axis)f(b)r(ounds)h(co)n(v)n(ered)e(b)n(y)h(the)h(Region.)35
-b(It)22 b(should)427 4431 y(ha)n(v)n(e)i(at)h(least)f(as)g(man)n(y)h
+b(It)22 b(should)427 983 y(ha)n(v)n(e)i(at)h(least)f(as)g(man)n(y)h
(elemen)n(ts)f(as)h(there)f(are)g(axes)g(in)h(the)h(Region.)35
b(If)25 b(an)g(axis)f(has)g(no)h(upp)r(er)g(limit,)427
-4531 y(the)j(returned)f(v)-5 b(alue)28 b(will)g(b)r(e)g(the)g(largest)e
-(p)r(ossible)h(p)r(ositiv)n(e)g(v)-5 b(alue.)0 4694 y
-Fd(Notes:)340 4977 y Fh(\017)45 b Fi(The)24 b(v)-5 b(alue)23
+1083 y(the)j(returned)f(v)-5 b(alue)28 b(will)g(b)r(e)g(the)g(largest)e
+(p)r(ossible)h(p)r(ositiv)n(e)g(v)-5 b(alue.)0 1246 y
+Fd(Notes:)340 1531 y Fh(\017)45 b Fi(The)24 b(v)-5 b(alue)23
b(of)h(the)g(Negated)f(attribute)h(is)g(ignored)e(\(i.e.)36
b(it)24 b(is)g(assumed)f(that)h(the)g(Region)e(has)i(not)f(b)r(een)427
-5077 y(negated\).)340 5210 y Fh(\017)45 b Fi(If)25 b(an)e(axis)h(has)f
+1630 y(negated\).)340 1764 y Fh(\017)45 b Fi(If)25 b(an)e(axis)h(has)f
(no)h(exten)n(t)g(on)g(an)f(axis)h(then)g(the)g(lo)n(w)n(er)f(limit)i
(will)f(b)r(e)g(returned)g(larger)e(than)i(the)g(upp)r(er)427
-5310 y(limit.)39 b(Note,)28 b(this)g(is)g(di\013eren)n(t)g(to)g(an)g
+1864 y(limit.)39 b(Note,)28 b(this)g(is)g(di\013eren)n(t)g(to)g(an)g
(axis)f(whic)n(h)h(has)g(a)f(constan)n(t)g(v)-5 b(alue)28
b(\(in)h(whic)n(h)f(case)f(b)r(oth)h(lo)n(w)n(er)427
-5410 y(and)g(upp)r(er)f(limit)i(will)f(b)r(e)g(returned)f(set)g(to)h
-(the)g(constan)n(t)f(v)-5 b(alue\).)340 5543 y Fh(\017)45
+1963 y(and)g(upp)r(er)f(limit)i(will)f(b)r(e)g(returned)f(set)g(to)h
+(the)g(constan)n(t)f(v)-5 b(alue\).)340 2097 y Fh(\017)45
b Fi(If)29 b(the)g(b)r(ounds)g(on)f(an)g(axis)g(cannot)g(b)r(e)g
(determined,)h(AST)p Ft(__)p Fi(BAD)g(is)f(returned)g(for)g(b)r(oth)h
-(upp)r(er)g(and)427 5643 y(lo)n(w)n(er)d(b)r(ounds)p
-eop end
-%%Page: 247 257
-TeXDict begin 247 256 bop 3643 52 a FF(247)p 0 351 3780
-12 v 0 483 a Fz(astGetRegionF)-11 b(rame)226 b Fe(Obtain)38
-b(a)g(p)s(oin)m(ter)f(to)1460 598 y(the)i(encapsulated)1499
-712 y(F)-10 b(rame)38 b(within)f(a)1713 812 y(Region)2614
-483 y Fz(astGetRegionF)-11 b(rame)0 1001 y Fd(Description:)44
+(upp)r(er)g(and)427 2197 y(lo)n(w)n(er)d(b)r(ounds)p
+0 2397 3780 12 v 0 2529 a Fz(astGetRegionF)-11 b(rame)226
+b Fe(Obtain)38 b(a)g(p)s(oin)m(ter)f(to)1460 2644 y(the)i(encapsulated)
+1499 2758 y(F)-10 b(rame)38 b(within)f(a)1713 2858 y(Region)2614
+2529 y Fz(astGetRegionF)-11 b(rame)0 3049 y Fd(Description:)44
b Fi(This)28 b(function)g(returns)f(a)g(p)r(oin)n(ter)g(to)h(the)g(F)-7
-b(rame)27 b(represen)n(ted)f(b)n(y)i(a)f(Region.)0 1150
+b(rame)27 b(represen)n(ted)f(b)n(y)i(a)f(Region.)0 3200
y Fd(Synopsis:)121 b Ft(AstFrame)40 b Fh(\003)p Ft(astGetRegionFra)o
-(me\()d(AstRegion)j Fh(\003)p Ft(this)h(\))0 1300 y Fd(P)m(arameters:)
-259 1436 y(this)427 1536 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Region.)0
-1698 y Fd(Returned)k(V)-8 b(alue:)259 1834 y(astGetRegionF)g(rame\(\))
-427 1934 y Fi(A)37 b(p)r(oin)n(ter)f(to)h(a)f(deep)g(cop)n(y)g(of)g
+(me\()d(AstRegion)j Fh(\003)p Ft(this)h(\))0 3351 y Fd(P)m(arameters:)
+259 3489 y(this)427 3589 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Region.)0
+3752 y Fd(Returned)k(V)-8 b(alue:)259 3890 y(astGetRegionF)g(rame\(\))
+427 3990 y Fi(A)37 b(p)r(oin)n(ter)f(to)h(a)f(deep)g(cop)n(y)g(of)g
(the)h(F)-7 b(rame)36 b(represen)n(ted)g(b)n(y)g(the)h(Region.)63
-b(Using)36 b(this)h(p)r(oin)n(ter)f(to)427 2033 y(mo)r(dify)31
+b(Using)36 b(this)h(p)r(oin)n(ter)f(to)427 4090 y(mo)r(dify)31
b(the)f(F)-7 b(rame)29 b(will)h(ha)n(v)n(e)f(no)h(e\013ect)g(on)g(the)g
(Region.)43 b(T)-7 b(o)30 b(mo)r(dify)g(the)g(Region,)g(use)g(the)g
-(Region)427 2133 y(p)r(oin)n(ter)d(directly)-7 b(.)0
-2295 y Fd(Notes:)340 2578 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+(Region)427 4189 y(p)r(oin)n(ter)d(directly)-7 b(.)0
+4353 y Fd(Notes:)340 4637 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 2677 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 2877 V 0 3008 a Fz(astGetRegionMesh)
+427 4737 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 4938 V 0 5069 a Fz(astGetRegionMesh)
156 b Fe(Return)38 b(a)h(mesh)g(of)f(p)s(oin)m(ts)1311
-3123 y(co)m(v)m(ering)e(the)j(surface)f(or)1396 3237
-y(v)m(olume)g(of)g(a)g(Region)2664 3008 y Fz(astGetRegionMesh)0
-3431 y Fd(Description:)44 b Fi(This)29 b(function)g(returns)f(the)i
+5184 y(co)m(v)m(ering)e(the)j(surface)f(or)1396 5299
+y(v)m(olume)g(of)g(a)g(Region)2664 5069 y Fz(astGetRegionMesh)0
+5494 y Fd(Description:)44 b Fi(This)29 b(function)g(returns)f(the)i
(axis)e(v)-5 b(alues)28 b(at)h(a)f(mesh)h(of)f(p)r(oin)n(ts)h(either)g
-(co)n(v)n(ering)d(the)j(surface)f(\(i.e.)227 3531 y(b)r(oundary\))h(of)
+(co)n(v)n(ering)d(the)j(surface)f(\(i.e.)227 5593 y(b)r(oundary\))h(of)
f(the)i(supplied)f(Region,)g(or)e(\014lling)i(the)h(in)n(terior)d
(\(i.e.)41 b(v)n(olume\))29 b(of)g(the)g(Region.)40 b(The)29
-b(n)n(um)n(b)r(er)227 3630 y(of)f(p)r(oin)n(ts)f(in)h(the)g(mesh)g(is)f
-(appro)n(ximately)f(equal)h(to)h(the)g(MeshSize)f(attribute.)0
-3780 y Fd(Synopsis:)121 b Ft(void)42 b(astGetRegionMesh)o(\()37
-b(AstRegion)j Fh(\003)p Ft(this,)h(int)i(surface,)d(int)i(maxpoint,)e
-(int)i(maxcoord,)227 3879 y(int)h Fh(\003)p Ft(npoint,)d(double)h
-Fh(\003)p Ft(points)g(\))0 4029 y Fd(P)m(arameters:)259
-4165 y(this)427 4265 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Region.)259
-4398 y Fd(surface)427 4497 y Fi(If)f(non-zero,)e(the)h(returned)g(p)r
+b(n)n(um)n(b)r(er)227 5693 y(of)f(p)r(oin)n(ts)f(in)h(the)g(mesh)g(is)f
+(appro)n(ximately)f(equal)h(to)h(the)g(MeshSize)f(attribute.)p
+eop end
+%%Page: 248 258
+TeXDict begin 248 257 bop 0 52 a FF(248)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Synopsis:)121
+b Ft(void)42 b(astGetRegionMesh)o(\()37 b(AstRegion)j
+Fh(\003)p Ft(this,)h(int)i(surface,)d(int)i(maxpoint,)e(int)i
+(maxcoord,)227 451 y(int)h Fh(\003)p Ft(npoint,)d(double)h
+Fh(\003)p Ft(points)g(\))0 597 y Fd(P)m(arameters:)259
+730 y(this)427 830 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Region.)259
+959 y Fd(surface)427 1059 y Fi(If)f(non-zero,)e(the)h(returned)g(p)r
(oin)n(ts)g(will)g(co)n(v)n(er)e(the)j(surface)e(or)g(the)h(Region.)36
-b(Otherwise,)26 b(they)g(will)g(\014ll)427 4597 y(the)i(in)n(terior)f
-(of)g(the)h(Region.)259 4730 y Fd(maxp)s(oin)m(t)427
-4830 y Fi(If)34 b(zero,)g(the)g(n)n(um)n(b)r(er)f(of)g(p)r(oin)n(ts)h
+b(Otherwise,)26 b(they)g(will)g(\014ll)427 1158 y(the)i(in)n(terior)f
+(of)g(the)h(Region.)259 1288 y Fd(maxp)s(oin)m(t)427
+1387 y Fi(If)34 b(zero,)g(the)g(n)n(um)n(b)r(er)f(of)g(p)r(oin)n(ts)h
(in)f(the)h(mesh)g(is)f(returned)g(in)h Ft(")p Fh(\003)p
Fi(np)r(oin)n(t)p Ft(")p Fi(,)g(but)g(no)f(axis)g(v)-5
-b(alues)33 b(are)427 4929 y(returned)c(and)f(all)g(other)h(parameters)e
+b(alues)33 b(are)427 1487 y(returned)c(and)f(all)g(other)h(parameters)e
(are)g(ignored.)39 b(If)29 b(not)g(zero,)f(the)h(supplied)g(v)-5
-b(alue)29 b(should)f(b)r(e)h(the)427 5029 y(length)h(of)g(the)g(second)
+b(alue)29 b(should)f(b)r(e)h(the)427 1586 y(length)h(of)g(the)g(second)
f(dimension)g(of)h(the)g Ft(")p Fi(p)r(oin)n(ts)p Ft(")f
Fi(arra)n(y)-7 b(.)41 b(An)30 b(error)e(is)h(rep)r(orted)g(if)h(the)g
-(n)n(um)n(b)r(er)g(of)427 5128 y(p)r(oin)n(ts)e(in)g(the)g(mesh)f
-(exceeds)g(this)h(n)n(um)n(b)r(er.)259 5261 y Fd(maxco)s(ord)427
-5361 y Fi(The)e(length)f(of)g(the)h(\014rst)f(dimension)h(of)f(the)h
+(n)n(um)n(b)r(er)g(of)427 1686 y(p)r(oin)n(ts)e(in)g(the)g(mesh)f
+(exceeds)g(this)h(n)n(um)n(b)r(er.)259 1815 y Fd(maxco)s(ord)427
+1915 y Fi(The)e(length)f(of)g(the)h(\014rst)f(dimension)h(of)f(the)h
Ft(")p Fi(p)r(oin)n(ts)p Ft(")e Fi(arra)n(y)-7 b(.)34
b(An)26 b(error)d(is)i(rep)r(orted)g(if)h(the)g(n)n(um)n(b)r(er)f(of)
-427 5461 y(axes)i(in)h(the)g(supplied)g(Region)f(exceeds)g(this)g(n)n
-(um)n(b)r(er.)259 5593 y Fd(np)s(oin)m(t)427 5693 y Fi(A)h(p)r(oin)n
+427 2015 y(axes)i(in)h(the)g(supplied)g(Region)f(exceeds)g(this)g(n)n
+(um)n(b)r(er.)259 2144 y Fd(np)s(oin)m(t)427 2244 y Fi(A)h(p)r(oin)n
(ter)f(to)h(an)f(in)n(teger)g(in)h(whic)n(h)f(to)h(return)f(the)h(n)n
-(um)n(b)r(er)f(of)h(p)r(oin)n(ts)f(in)h(the)g(returned)f(mesh.)p
-eop end
-%%Page: 248 258
-TeXDict begin 248 257 bop 0 52 a FF(248)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(p)s(oin)m(ts)427
-451 y Fi(The)g(address)f(of)h(the)h(\014rst)f(elemen)n(t)g(in)h(a)e
-(2-dimensional)g(arra)n(y)f(of)i(shap)r(e)g Ft(")p Fi([maxco)r
-(ord][maxp)r(oin)n(t])p Ft(")p Fi(,)427 551 y(in)43 b(whic)n(h)f(to)h
-(return)e(the)i(co)r(ordinate)f(v)-5 b(alues)42 b(at)g(the)h(mesh)f(p)r
-(ositions.)81 b(These)42 b(are)f(stored)h(suc)n(h)427
-650 y(that)32 b(the)f(v)-5 b(alue)32 b(of)f(co)r(ordinate)f(n)n(um)n(b)
-r(er)h Ft(")p Fi(co)r(ord)p Ft(")e Fi(for)i(p)r(oin)n(t)h(n)n(um)n(b)r
-(er)f Ft(")p Fi(p)r(oin)n(t)p Ft(")f Fi(is)h(found)h(in)f(elemen)n(t)
-427 750 y Ft(")p Fi(p)r(oin)n(ts[co)r(ord][p)r(oin)n(t])p
-Ft(")p Fi(.)0 914 y Fd(Notes:)340 1199 y Fh(\017)45 b
-Fi(If)21 b(the)h(co)r(ordinate)d(system)i(represen)n(ted)e(b)n(y)h(the)
-i(Region)e(has)g(b)r(een)h(c)n(hanged)f(since)g(it)h(w)n(as)f(\014rst)g
-(created,)427 1299 y(the)h(returned)f(axis)f(v)-5 b(alues)20
-b(refer)g(to)g(the)g(new)h(\(c)n(hanged\))e(co)r(ordinate)g(system,)j
-(rather)d(than)i(the)f(original)427 1398 y(co)r(ordinate)27
+(um)n(b)r(er)f(of)h(p)r(oin)n(ts)f(in)h(the)g(returned)f(mesh.)259
+2373 y Fd(p)s(oin)m(ts)427 2473 y Fi(The)j(address)f(of)h(the)h
+(\014rst)f(elemen)n(t)g(in)h(a)e(2-dimensional)g(arra)n(y)f(of)i(shap)r
+(e)g Ft(")p Fi([maxco)r(ord][maxp)r(oin)n(t])p Ft(")p
+Fi(,)427 2572 y(in)43 b(whic)n(h)f(to)h(return)e(the)i(co)r(ordinate)f
+(v)-5 b(alues)42 b(at)g(the)h(mesh)f(p)r(ositions.)81
+b(These)42 b(are)f(stored)h(suc)n(h)427 2672 y(that)32
+b(the)f(v)-5 b(alue)32 b(of)f(co)r(ordinate)f(n)n(um)n(b)r(er)h
+Ft(")p Fi(co)r(ord)p Ft(")e Fi(for)i(p)r(oin)n(t)h(n)n(um)n(b)r(er)f
+Ft(")p Fi(p)r(oin)n(t)p Ft(")f Fi(is)h(found)h(in)f(elemen)n(t)427
+2772 y Ft(")p Fi(p)r(oin)n(ts[co)r(ord][p)r(oin)n(t])p
+Ft(")p Fi(.)0 2930 y Fd(Notes:)340 3209 y Fh(\017)45
+b Fi(If)21 b(the)h(co)r(ordinate)d(system)i(represen)n(ted)e(b)n(y)h
+(the)i(Region)e(has)g(b)r(een)h(c)n(hanged)f(since)g(it)h(w)n(as)f
+(\014rst)g(created,)427 3309 y(the)h(returned)f(axis)f(v)-5
+b(alues)20 b(refer)g(to)g(the)g(new)h(\(c)n(hanged\))e(co)r(ordinate)g
+(system,)j(rather)d(than)i(the)f(original)427 3408 y(co)r(ordinate)27
b(system.)37 b(Note)28 b(ho)n(w)n(ev)n(er)e(that)i(if)g(the)g
(transformation)f(from)g(original)f(to)i(new)g(co)r(ordinate)427
-1498 y(system)j(is)f(non-linear,)g(the)h(shap)r(e)f(within)i(the)f(new)
+3508 y(system)j(is)f(non-linear,)g(the)h(shap)r(e)f(within)i(the)f(new)
f(co)r(ordinate)g(system)g(ma)n(y)g(b)r(e)h(distorted,)g(and)f(so)427
-1597 y(ma)n(y)d(not)h(matc)n(h)f(that)h(implied)g(b)n(y)g(the)f(name)h
+3608 y(ma)n(y)d(not)h(matc)n(h)f(that)h(implied)g(b)n(y)g(the)f(name)h
(of)f(the)h(Region)f(sub)r(class)g(\(Circle,)h(Bo)n(x,)e(etc\).)p
-0 1799 3780 12 v 0 1931 a Fz(astGetRegionP)l(oin)l(ts)176
-b Fe(Returns)39 b(the)f(p)s(ositions)1360 2045 y(that)f(de\014ne)j(the)
-e(giv)m(en)1713 2159 y(Region)2612 1931 y Fz(astGetRegionP)l(oin)l(ts)0
-2350 y Fd(Description:)44 b Fi(This)30 b(function)g(returns)e(the)i
+0 3800 3780 12 v 0 3932 a Fz(astGetRegionP)l(oin)l(ts)176
+b Fe(Returns)39 b(the)f(p)s(ositions)1360 4046 y(that)f(de\014ne)j(the)
+e(giv)m(en)1713 4160 y(Region)2612 3932 y Fz(astGetRegionP)l(oin)l(ts)0
+4342 y Fd(Description:)44 b Fi(This)30 b(function)g(returns)e(the)i
(axis)f(v)-5 b(alues)29 b(at)g(the)h(p)r(oin)n(ts)f(that)h(de\014ne)f
-(the)h(supplied)g(Region.)42 b(The)227 2450 y(particular)25
+(the)h(supplied)g(Region.)42 b(The)227 4441 y(particular)25
b(meaning)h(of)h(these)g(p)r(oin)n(ts)f(will)h(dep)r(end)g(on)f(the)h
(t)n(yp)r(e)g(of)f(class)g(supplied,)h(as)f(listed)h(b)r(elo)n(w)f
-(under)227 2549 y Ft(")p Fi(Applicabilit)n(y:)p Ft(")p
-Fi(.)0 2701 y Fd(Synopsis:)121 b Ft(void)42 b(astGetRegionPoin)o(ts)o
+(under)227 4541 y Ft(")p Fi(Applicabilit)n(y:)p Ft(")p
+Fi(.)0 4687 y Fd(Synopsis:)121 b Ft(void)42 b(astGetRegionPoin)o(ts)o
(\()c(AstRegion)h Fh(\003)p Ft(this,)i(int)i(maxpoint,)d(int)i
-(maxcoord,)e(int)i Fh(\003)p Ft(npoint,)227 2801 y(double)f
-Fh(\003)p Ft(points)g(\))0 2952 y Fd(P)m(arameters:)259
-3091 y(this)427 3191 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Region.)259
-3325 y Fd(maxp)s(oin)m(t)427 3425 y Fi(If)33 b(zero,)e(the)i(n)n(um)n
+(maxcoord,)e(int)i Fh(\003)p Ft(npoint,)227 4786 y(double)f
+Fh(\003)p Ft(points)g(\))0 4932 y Fd(P)m(arameters:)259
+5065 y(this)427 5165 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Region.)259
+5295 y Fd(maxp)s(oin)m(t)427 5394 y Fi(If)33 b(zero,)e(the)i(n)n(um)n
(b)r(er)e(of)h(p)r(oin)n(ts)g(needed)g(to)g(de\014ne)g(the)g(Region)f
(is)h(returned)f(in)h Ft(")p Fh(\003)p Fi(np)r(oin)n(t)p
-Ft(")p Fi(,)g(but)h(no)427 3524 y(axis)26 b(v)-5 b(alues)26
+Ft(")p Fi(,)g(but)h(no)427 5494 y(axis)26 b(v)-5 b(alues)26
b(are)f(returned)h(and)h(all)f(other)g(parameters)e(are)i(ignored.)35
b(If)27 b(not)f(zero,)g(the)h(supplied)g(v)-5 b(alue)427
-3624 y(should)31 b(b)r(e)g(the)g(length)g(of)g(the)g(second)f
+5593 y(should)31 b(b)r(e)g(the)g(length)g(of)g(the)g(second)f
(dimension)h(of)g(the)g Ft(")p Fi(p)r(oin)n(ts)p Ft(")f
Fi(arra)n(y)-7 b(.)44 b(An)31 b(error)e(is)i(rep)r(orted)f(if)427
-3723 y(the)e(n)n(um)n(b)r(er)g(of)f(p)r(oin)n(ts)h(needed)f(to)h
-(de\014ne)g(the)g(Region)f(exceeds)g(this)g(n)n(um)n(b)r(er.)259
-3857 y Fd(maxco)s(ord)427 3957 y Fi(The)f(length)f(of)g(the)h(\014rst)f
+5693 y(the)e(n)n(um)n(b)r(er)g(of)f(p)r(oin)n(ts)h(needed)f(to)h
+(de\014ne)g(the)g(Region)f(exceeds)g(this)g(n)n(um)n(b)r(er.)p
+eop end
+%%Page: 249 259
+TeXDict begin 249 258 bop 3643 52 a FF(249)259 351 y
+Fd(maxco)s(ord)427 451 y Fi(The)26 b(length)f(of)g(the)h(\014rst)f
(dimension)h(of)f(the)h Ft(")p Fi(p)r(oin)n(ts)p Ft(")e
Fi(arra)n(y)-7 b(.)34 b(An)26 b(error)d(is)i(rep)r(orted)g(if)h(the)g
-(n)n(um)n(b)r(er)f(of)427 4057 y(axes)i(in)h(the)g(supplied)g(Region)f
-(exceeds)g(this)g(n)n(um)n(b)r(er.)259 4191 y Fd(np)s(oin)m(t)427
-4290 y Fi(A)h(p)r(oin)n(ter)f(to)h(an)f(in)n(teger)g(in)h(whic)n(h)f
-(to)h(return)f(the)h(n)n(um)n(b)r(er)f(of)h(p)r(oin)n(ts)f(de\014ning)h
-(the)g(Region.)259 4424 y Fd(p)s(oin)m(ts)427 4524 y
-Fi(The)i(address)f(of)h(the)h(\014rst)f(elemen)n(t)g(in)h(a)e
-(2-dimensional)g(arra)n(y)f(of)i(shap)r(e)g Ft(")p Fi([maxco)r
-(ord][maxp)r(oin)n(t])p Ft(")p Fi(,)427 4624 y(in)h(whic)n(h)f(to)g
-(return)g(the)h(co)r(ordinate)e(v)-5 b(alues)30 b(at)g(the)h(p)r
-(ositions)f(that)g(de\014ne)h(the)f(Region.)45 b(These)30
-b(are)427 4723 y(stored)e(suc)n(h)h(that)g(the)g(v)-5
-b(alue)29 b(of)g(co)r(ordinate)f(n)n(um)n(b)r(er)g Ft(")p
-Fi(co)r(ord)p Ft(")f Fi(for)i(p)r(oin)n(t)g(n)n(um)n(b)r(er)f
-Ft(")p Fi(p)r(oin)n(t)p Ft(")h Fi(is)f(found)427 4823
-y(in)g(elemen)n(t)g Ft(")p Fi(p)r(oin)n(ts[co)r(ord][p)r(oin)n(t])p
-Ft(")p Fi(.)0 4987 y Fd(Class)j(Applicabilit)m(y:)259
-5126 y(Region)427 5226 y Fi(All)d(Regions)f(ha)n(v)n(e)f(this)i
-(attribute.)259 5360 y Fd(Bo)m(x)427 5459 y Fi(The)g(\014rst)f
+(n)n(um)n(b)r(er)f(of)427 551 y(axes)i(in)h(the)g(supplied)g(Region)f
+(exceeds)g(this)g(n)n(um)n(b)r(er.)259 687 y Fd(np)s(oin)m(t)427
+787 y Fi(A)h(p)r(oin)n(ter)f(to)h(an)f(in)n(teger)g(in)h(whic)n(h)f(to)
+h(return)f(the)h(n)n(um)n(b)r(er)f(of)h(p)r(oin)n(ts)f(de\014ning)h
+(the)g(Region.)259 924 y Fd(p)s(oin)m(ts)427 1023 y Fi(The)i(address)f
+(of)h(the)h(\014rst)f(elemen)n(t)g(in)h(a)e(2-dimensional)g(arra)n(y)f
+(of)i(shap)r(e)g Ft(")p Fi([maxco)r(ord][maxp)r(oin)n(t])p
+Ft(")p Fi(,)427 1123 y(in)h(whic)n(h)f(to)g(return)g(the)h(co)r
+(ordinate)e(v)-5 b(alues)30 b(at)g(the)h(p)r(ositions)f(that)g
+(de\014ne)h(the)f(Region.)45 b(These)30 b(are)427 1223
+y(stored)e(suc)n(h)h(that)g(the)g(v)-5 b(alue)29 b(of)g(co)r(ordinate)f
+(n)n(um)n(b)r(er)g Ft(")p Fi(co)r(ord)p Ft(")f Fi(for)i(p)r(oin)n(t)g
+(n)n(um)n(b)r(er)f Ft(")p Fi(p)r(oin)n(t)p Ft(")h Fi(is)f(found)427
+1322 y(in)g(elemen)n(t)g Ft(")p Fi(p)r(oin)n(ts[co)r(ord][p)r(oin)n(t])
+p Ft(")p Fi(.)0 1492 y Fd(Class)j(Applicabilit)m(y:)259
+1636 y(Region)427 1736 y Fi(All)d(Regions)f(ha)n(v)n(e)f(this)i
+(attribute.)259 1873 y Fd(Bo)m(x)427 1972 y Fi(The)g(\014rst)f
(returned)g(p)r(osition)h(is)f(the)h(Bo)n(x)f(cen)n(tre,)g(and)g(the)h
-(second)f(is)h(a)f(Bo)n(x)f(corner.)259 5593 y Fd(Circle)427
-5693 y Fi(The)c(\014rst)f(returned)g(p)r(osition)g(is)g(the)h(Circle)e
+(second)f(is)h(a)f(Bo)n(x)f(corner.)259 2109 y Fd(Circle)427
+2209 y Fi(The)c(\014rst)f(returned)g(p)r(osition)g(is)g(the)h(Circle)e
(cen)n(tre,)i(and)g(the)f(second)g(is)g(a)g(p)r(oin)n(t)g(on)g(the)h
-(circumference.)p eop end
-%%Page: 249 259
-TeXDict begin 249 258 bop 3643 52 a FF(249)259 351 y
-Fd(CmpRegion)427 451 y Fi(Returns)28 b(a)g(v)-5 b(alue)28
-b(of)g(zero)f(for)h Ft(")p Fh(\003)p Fi(np)r(oin)n(t)p
-Ft(")f Fi(and)h(lea)n(v)n(es)f(the)h(supplied)h(arra)n(y)d(con)n(ten)n
-(ts)h(unc)n(hanged.)38 b(T)-7 b(o)427 551 y(\014nd)25
-b(the)f(p)r(oin)n(ts)g(de\014ning)f(a)h(CmpRegion,)g(use)g(this)g
-(metho)r(d)g(on)g(the)g(comp)r(onen)n(t)g(Regions,)f(whic)n(h)h(can)427
-650 y(b)r(e)k(accessed)f(b)n(y)g(in)n(v)n(oking)f(astDecomp)r(ose)h(on)
-g(the)h(CmpRegion.)259 780 y Fd(Ellipse)427 880 y Fi(The)h(\014rst)g
-(returned)f(p)r(osition)h(is)g(the)g(Ellipse)g(cen)n(tre.)40
-b(The)29 b(second)f(is)h(the)g(end)g(of)g(one)g(of)f(the)i(axes)e(of)
-427 979 y(the)k(ellipse.)48 b(The)31 b(third)g(is)g(some)g(other)g(p)r
-(oin)n(t)g(on)g(the)h(circumference)e(of)h(the)h(ellipse,)g(distinct)g
-(from)427 1079 y(the)c(second)f(p)r(oin)n(t.)259 1209
-y Fd(In)m(terv)-5 b(al)427 1309 y Fi(The)30 b(\014rst)g(p)r(oin)n(t)g
-(corresp)r(onds)e(to)i(the)g(lo)n(w)n(er)f(b)r(ounds)h(p)r(osition,)g
-(and)g(the)g(second)f(p)r(oin)n(t)i(corresp)r(onds)427
-1408 y(to)k(the)f(upp)r(er)h(b)r(ounds)f(p)r(osition.)57
-b(These)34 b(are)g(rev)n(ersed)e(to)j(indicate)f(an)g(extcluded)h(in)n
-(terv)-5 b(al)34 b(rather)427 1508 y(than)28 b(an)f(included)h(in)n
-(terv)-5 b(al.)37 b(See)27 b(the)h(In)n(terv)-5 b(al)27
-b(constructor)f(for)h(more)g(information.)259 1638 y
-Fd(NullRegion)427 1737 y Fi(Returns)h(a)f(v)-5 b(alue)27
-b(of)h(zero)e(for)i Ft(")p Fh(\003)p Fi(np)r(oin)n(t)p
+(circumference.)259 2345 y Fd(CmpRegion)427 2445 y Fi(Returns)28
+b(a)g(v)-5 b(alue)28 b(of)g(zero)f(for)h Ft(")p Fh(\003)p
+Fi(np)r(oin)n(t)p Ft(")f Fi(and)h(lea)n(v)n(es)f(the)h(supplied)h(arra)
+n(y)d(con)n(ten)n(ts)h(unc)n(hanged.)38 b(T)-7 b(o)427
+2545 y(\014nd)25 b(the)f(p)r(oin)n(ts)g(de\014ning)f(a)h(CmpRegion,)g
+(use)g(this)g(metho)r(d)g(on)g(the)g(comp)r(onen)n(t)g(Regions,)f(whic)
+n(h)h(can)427 2644 y(b)r(e)k(accessed)f(b)n(y)g(in)n(v)n(oking)f
+(astDecomp)r(ose)h(on)g(the)h(CmpRegion.)259 2781 y Fd(Ellipse)427
+2881 y Fi(The)h(\014rst)g(returned)f(p)r(osition)h(is)g(the)g(Ellipse)g
+(cen)n(tre.)40 b(The)29 b(second)f(is)h(the)g(end)g(of)g(one)g(of)f
+(the)i(axes)e(of)427 2980 y(the)k(ellipse.)48 b(The)31
+b(third)g(is)g(some)g(other)g(p)r(oin)n(t)g(on)g(the)h(circumference)e
+(of)h(the)h(ellipse,)g(distinct)g(from)427 3080 y(the)c(second)f(p)r
+(oin)n(t.)259 3217 y Fd(In)m(terv)-5 b(al)427 3316 y
+Fi(The)30 b(\014rst)g(p)r(oin)n(t)g(corresp)r(onds)e(to)i(the)g(lo)n(w)
+n(er)f(b)r(ounds)h(p)r(osition,)g(and)g(the)g(second)f(p)r(oin)n(t)i
+(corresp)r(onds)427 3416 y(to)k(the)f(upp)r(er)h(b)r(ounds)f(p)r
+(osition.)57 b(These)34 b(are)g(rev)n(ersed)e(to)j(indicate)f(an)g
+(extcluded)h(in)n(terv)-5 b(al)34 b(rather)427 3515 y(than)28
+b(an)f(included)h(in)n(terv)-5 b(al.)37 b(See)27 b(the)h(In)n(terv)-5
+b(al)27 b(constructor)f(for)h(more)g(information.)259
+3652 y Fd(NullRegion)427 3752 y Fi(Returns)h(a)f(v)-5
+b(alue)27 b(of)h(zero)e(for)i Ft(")p Fh(\003)p Fi(np)r(oin)n(t)p
Ft(")e Fi(and)i(lea)n(v)n(es)e(the)i(supplied)f(arra)n(y)f(con)n(ten)n
-(ts)h(unc)n(hanged.)259 1867 y Fd(P)m(oin)m(tList)427
-1967 y Fi(The)h(p)r(ositions)f(returned)g(are)g(those)g(that)h(w)n(ere)
+(ts)h(unc)n(hanged.)259 3889 y Fd(P)m(oin)m(tList)427
+3988 y Fi(The)h(p)r(ositions)f(returned)g(are)g(those)g(that)h(w)n(ere)
f(supplied)h(when)f(the)h(P)n(oin)n(tList)f(w)n(as)f(constructed.)259
-2097 y Fd(P)m(olygon)427 2197 y Fi(The)36 b(p)r(ositions)f(returned)g
+4125 y Fd(P)m(olygon)427 4225 y Fi(The)36 b(p)r(ositions)f(returned)g
(are)f(the)i(v)n(ertex)f(p)r(ositions)g(that)g(w)n(ere)g(supplied)h
-(when)f(the)h(P)n(olygon)e(w)n(as)427 2296 y(constructed.)259
-2426 y Fd(Prism)427 2526 y Fi(Returns)28 b(a)g(v)-5 b(alue)28
+(when)f(the)h(P)n(olygon)e(w)n(as)427 4324 y(constructed.)259
+4461 y Fd(Prism)427 4561 y Fi(Returns)28 b(a)g(v)-5 b(alue)28
b(of)g(zero)f(for)h Ft(")p Fh(\003)p Fi(np)r(oin)n(t)p
Ft(")f Fi(and)h(lea)n(v)n(es)f(the)h(supplied)h(arra)n(y)d(con)n(ten)n
-(ts)h(unc)n(hanged.)38 b(T)-7 b(o)427 2625 y(\014nd)31
+(ts)h(unc)n(hanged.)38 b(T)-7 b(o)427 4660 y(\014nd)31
b(the)g(p)r(oin)n(ts)g(de\014ning)g(a)f(Prism,)g(use)h(this)g(metho)r
(d)g(on)f(the)h(comp)r(onen)n(t)g(Regions,)f(whic)n(h)h(can)f(b)r(e)427
-2725 y(accessed)d(b)n(y)g(in)n(v)n(oking)f(astDecomp)r(ose)h(on)g(the)h
-(CmpRegion.)0 2884 y Fd(Notes:)340 3164 y Fh(\017)45
+4760 y(accessed)d(b)n(y)g(in)n(v)n(oking)f(astDecomp)r(ose)h(on)g(the)h
+(CmpRegion.)0 4930 y Fd(Notes:)340 5220 y Fh(\017)45
b Fi(If)21 b(the)h(co)r(ordinate)d(system)i(represen)n(ted)e(b)n(y)h
(the)i(Region)e(has)g(b)r(een)h(c)n(hanged)f(since)g(it)h(w)n(as)f
-(\014rst)g(created,)427 3263 y(the)h(returned)f(axis)f(v)-5
+(\014rst)g(created,)427 5320 y(the)h(returned)f(axis)f(v)-5
b(alues)20 b(refer)g(to)g(the)g(new)h(\(c)n(hanged\))e(co)r(ordinate)g
-(system,)j(rather)d(than)i(the)f(original)427 3363 y(co)r(ordinate)27
+(system,)j(rather)d(than)i(the)f(original)427 5419 y(co)r(ordinate)27
b(system.)37 b(Note)28 b(ho)n(w)n(ev)n(er)e(that)i(if)g(the)g
(transformation)f(from)g(original)f(to)i(new)g(co)r(ordinate)427
-3463 y(system)j(is)f(non-linear,)g(the)h(shap)r(e)f(within)i(the)f(new)
+5519 y(system)j(is)f(non-linear,)g(the)h(shap)r(e)f(within)i(the)f(new)
f(co)r(ordinate)g(system)g(ma)n(y)g(b)r(e)h(distorted,)g(and)f(so)427
-3562 y(ma)n(y)d(not)h(matc)n(h)f(that)h(implied)g(b)n(y)g(the)f(name)h
+5619 y(ma)n(y)d(not)h(matc)n(h)f(that)h(implied)g(b)n(y)g(the)f(name)h
(of)f(the)h(Region)f(sub)r(class)g(\(Circle,)h(Bo)n(x,)e(etc\).)p
-0 3756 3780 12 v 0 3887 a Fz(astGetStcCo)t(ord)203 b
-Fe(Return)39 b(information)c(ab)s(out)j(an)1107 3987
-y(AstroCo)s(ords)e(elemen)m(t)h(stored)h(in)1727 4087
-y(an)h(Stc)2838 3887 y Fz(astGetStcCo)t(ord)0 4247 y
-Fd(Description:)44 b Fi(When)29 b(an)n(y)d(sub-class)h(of)g(Stc)h(is)g
-(created,)f(the)h(constructor)e(function)i(allo)n(ws)f(one)g(or)g(more)
-g(Astro-)227 4346 y(Co)r(ords)j(elemen)n(ts)g(to)h(b)r(e)g(stored)e
-(within)j(the)f(Stc.)46 b(This)31 b(function)g(allo)n(ws)e(an)n(y)h
-(one)g(of)h(these)g(AstroCo)r(ords)227 4446 y(elemen)n(ts)37
+eop end
+%%Page: 250 260
+TeXDict begin 250 259 bop 0 52 a FF(250)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 483 a Fz(astGetStcCo)t(ord)203 b Fe(Return)39 b(information)c(ab)s
+(out)j(an)1107 583 y(AstroCo)s(ords)e(elemen)m(t)h(stored)h(in)1727
+682 y(an)h(Stc)2838 483 y Fz(astGetStcCo)t(ord)0 837
+y Fd(Description:)44 b Fi(When)29 b(an)n(y)d(sub-class)h(of)g(Stc)h(is)
+g(created,)f(the)h(constructor)e(function)i(allo)n(ws)f(one)g(or)g
+(more)g(Astro-)227 936 y(Co)r(ords)j(elemen)n(ts)g(to)h(b)r(e)g(stored)
+e(within)j(the)f(Stc.)46 b(This)31 b(function)g(allo)n(ws)e(an)n(y)h
+(one)g(of)h(these)g(AstroCo)r(ords)227 1036 y(elemen)n(ts)37
b(to)h(b)r(e)f(retriev)n(ed.)65 b(The)37 b(format)g(of)g(the)h
(returned)f(information)g(is)g(the)h(same)e(as)h(that)g(used)h(to)227
-4545 y(pass)e(the)h(original)e(information)h(to)g(the)h(Stc)g
+1136 y(pass)e(the)h(original)e(information)h(to)g(the)h(Stc)g
(constructor.)62 b(That)36 b(is,)j(the)e(information)f(is)g(returned)g
-(in)h(a)227 4645 y(KeyMap)29 b(structure)g(con)n(taining)g(elemen)n(ts)
+(in)h(a)227 1235 y(KeyMap)29 b(structure)g(con)n(taining)g(elemen)n(ts)
g(with)i(one)e(or)g(more)g(of)g(the)h(k)n(eys)f(giv)n(en)g(b)n(y)g(sym)
-n(b)r(olic)h(constan)n(ts)227 4745 y(AST)p Ft(__)p Fi(STCNAME,)40
+n(b)r(olic)h(constan)n(ts)227 1335 y(AST)p Ft(__)p Fi(STCNAME,)40
b(AST)p Ft(__)p Fi(STCV)-9 b(ALUE,)40 b(AST)p Ft(__)p
Fi(STCERR)n(OR,)e(AST)p Ft(__)p Fi(STCRES,)i(AST)p Ft(__)p
-Fi(STCSIZE)227 4844 y(and)28 b(AST)p Ft(__)p Fi(STCPIXSZ.)227
-4967 y(If)23 b(the)g(co)r(ordinate)f(system)g(represen)n(ted)g(b)n(y)g
+Fi(STCSIZE)227 1435 y(and)28 b(AST)p Ft(__)p Fi(STCPIXSZ.)227
+1556 y(If)23 b(the)g(co)r(ordinate)f(system)g(represen)n(ted)g(b)n(y)g
(the)h(Stc)g(has)f(b)r(een)h(c)n(hanged)f(since)g(it)h(w)n(as)f
-(created)f(\(for)i(instance,)227 5067 y(b)n(y)h(c)n(hanging)f(its)i
+(created)f(\(for)i(instance,)227 1656 y(b)n(y)h(c)n(hanging)f(its)i
(System)g(attribute\),)g(then)g(the)g(sizes)f(and)g(p)r(ositions)g(in)h
-(the)g(returned)f(KeyMap)f(will)i(re\015ect)227 5167
-y(the)j(c)n(hange)f(in)h(co)r(ordinate)e(system.)0 5313
+(the)g(returned)f(KeyMap)f(will)i(re\015ect)227 1756
+y(the)j(c)n(hange)f(in)h(co)r(ordinate)e(system.)0 1899
y Fd(Synopsis:)121 b Ft(AstKeyMap)40 b Fh(\003)p Ft(astGetStcCoord)o
(\()e(AstStc)j Fh(\003)p Ft(this,)g(int)h(icoord)f(\))0
-5460 y Fd(P)m(arameters:)259 5593 y(this)427 5693 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(Stc.)p eop end
-%%Page: 250 260
-TeXDict begin 250 259 bop 0 52 a FF(250)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(ico)s(ord)427
-451 y Fi(The)35 b(index)g(of)g(the)g(AstroCo)r(ords)e(elemen)n(t)j
-(required.)57 b(The)35 b(\014rst)g(has)f(index)i(one.)58
-b(The)35 b(n)n(um)n(b)r(er)g(of)427 551 y(AstroCo)r(ords)26
-b(elemen)n(ts)h(in)h(the)g(Stc)g(can)f(b)r(e)h(found)g(using)g
-(function)g(astGetStcNco)r(ord.)0 700 y Fd(Returned)k(V)-8
-b(alue:)259 824 y(astGetStcCo)s(ord\(\))427 923 y Fi(A)28
-b(p)r(oin)n(ter)f(to)h(a)f(new)h(KeyMap)e(con)n(taining)h(the)h
-(required)f(information.)0 1073 y Fd(Notes:)340 1343
-y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g
-(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g
-(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 1442
-y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f
-(an)n(y)g(reason.)p 0 1616 3780 12 v 0 1748 a Fz(astGetStcNCo)t(ord)284
-b Fe(Return)38 b(the)h(n)m(um)m(b)s(er)f(of)1328 1848
-y(AstroCo)s(ords)e(elemen)m(ts)1483 1947 y(stored)i(in)g(an)h(Stc)2732
-1748 y Fz(astGetStcNCo)t(ord)0 2088 y Fd(Description:)44
+2043 y Fd(P)m(arameters:)259 2174 y(this)427 2274 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(Stc.)259 2401 y Fd(ico)s(ord)427 2501 y
+Fi(The)35 b(index)g(of)g(the)g(AstroCo)r(ords)e(elemen)n(t)j(required.)
+57 b(The)35 b(\014rst)g(has)f(index)i(one.)58 b(The)35
+b(n)n(um)n(b)r(er)g(of)427 2601 y(AstroCo)r(ords)26 b(elemen)n(ts)h(in)
+h(the)g(Stc)g(can)f(b)r(e)h(found)g(using)g(function)g(astGetStcNco)r
+(ord.)0 2757 y Fd(Returned)k(V)-8 b(alue:)259 2888 y(astGetStcCo)s
+(ord\(\))427 2987 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(a)f(new)h(KeyMap)e
+(con)n(taining)h(the)h(required)f(information.)0 3144
+y Fd(Notes:)340 3421 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
+(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
+427 3520 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 3709 V 0 3840 a Fz(astGetStcNCo)t
+(ord)284 b Fe(Return)38 b(the)h(n)m(um)m(b)s(er)f(of)1328
+3940 y(AstroCo)s(ords)e(elemen)m(ts)1483 4040 y(stored)i(in)g(an)h(Stc)
+2732 3840 y Fz(astGetStcNCo)t(ord)0 4194 y Fd(Description:)44
b Fi(This)28 b(function)g(returns)f(the)h(n)n(um)n(b)r(er)f(of)h
(AstroCo)r(ords)e(elemen)n(ts)h(stored)g(in)h(an)f(Stc.)0
-2225 y Fd(Synopsis:)121 b Ft(int)42 b(astGetStcNCoord\()37
-b(AstStc)k Fh(\003)p Ft(this)h(\))0 2362 y Fd(P)m(arameters:)259
-2485 y(this)427 2585 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Stc.)0
-2734 y Fd(Returned)k(V)-8 b(alue:)259 2858 y(astGetStcNCo)s(ord\(\))427
-2958 y Fi(The)28 b(n)n(um)n(b)r(er)f(of)h(AstroCo)r(ords)e(elemen)n(ts)
-h(stored)g(in)h(the)g(Stc.)0 3107 y Fd(Notes:)340 3377
+4338 y Fd(Synopsis:)121 b Ft(int)42 b(astGetStcNCoord\()37
+b(AstStc)k Fh(\003)p Ft(this)h(\))0 4482 y Fd(P)m(arameters:)259
+4613 y(this)427 4713 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Stc.)0
+4869 y Fd(Returned)k(V)-8 b(alue:)259 5000 y(astGetStcNCo)s(ord\(\))427
+5100 y Fi(The)28 b(n)n(um)n(b)r(er)f(of)h(AstroCo)r(ords)e(elemen)n(ts)
+h(stored)g(in)h(the)g(Stc.)0 5256 y Fd(Notes:)340 5533
y Fh(\017)45 b Fi(Zero)26 b(will)g(b)r(e)h(returned)f(if)h(this)g
(function)g(is)g(in)n(v)n(ok)n(ed)e(with)i(the)g(AST)g(error)d(status)i
-(set,)h(or)f(if)h(it)g(should)427 3477 y(fail)h(for)f(an)n(y)g(reason.)
-p 0 3651 V 0 3783 a Fz(astGetStcRegion)375 b Fe(Obtain)38
-b(a)g(cop)m(y)h(of)f(the)1137 3897 y(encapsulated)e(Region)g(within)f
-(a)1808 4010 y(Stc)2794 3783 y Fz(astGetStcRegion)0 4151
-y Fd(Description:)44 b Fi(This)30 b(function)g(returns)f(a)h(p)r(oin)n
-(ter)f(to)h(a)f(deep)h(cop)n(y)f(of)g(the)h(Region)f(supplied)h(when)g
-(the)h(Stc)f(w)n(as)227 4251 y(created.)0 4387 y Fd(Synopsis:)121
-b Ft(AstRegion)40 b Fh(\003)p Ft(astGetStcRegio)o(n\()d(AstStc)k
-Fh(\003)p Ft(this)h(\))0 4524 y Fd(P)m(arameters:)259
-4648 y(this)427 4748 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Stc.)0
-4897 y Fd(Returned)k(V)-8 b(alue:)259 5021 y(astGetStcRegion\(\))427
-5121 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(a)f(deep)h(cop)n(y)f(of)g(the)h
+(set,)h(or)f(if)h(it)g(should)427 5633 y(fail)h(for)f(an)n(y)g(reason.)
+p eop end
+%%Page: 251 261
+TeXDict begin 251 260 bop 3643 52 a FF(251)p 0 351 3780
+12 v 0 483 a Fz(astGetStcRegion)375 b Fe(Obtain)38 b(a)g(cop)m(y)h(of)f
+(the)1137 598 y(encapsulated)e(Region)g(within)f(a)1808
+711 y(Stc)2794 483 y Fz(astGetStcRegion)0 920 y Fd(Description:)44
+b Fi(This)30 b(function)g(returns)f(a)h(p)r(oin)n(ter)f(to)h(a)f(deep)h
+(cop)n(y)f(of)g(the)h(Region)f(supplied)h(when)g(the)h(Stc)f(w)n(as)227
+1020 y(created.)0 1213 y Fd(Synopsis:)121 b Ft(AstRegion)40
+b Fh(\003)p Ft(astGetStcRegio)o(n\()d(AstStc)k Fh(\003)p
+Ft(this)h(\))0 1406 y Fd(P)m(arameters:)259 1586 y(this)427
+1685 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Stc.)0 1891 y
+Fd(Returned)k(V)-8 b(alue:)259 2071 y(astGetStcRegion\(\))427
+2171 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(a)f(deep)h(cop)n(y)f(of)g(the)h
(Region)f(encapsulated)g(within)h(the)g(supplied)g(Stc.)0
-5270 y Fd(Notes:)340 5540 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+2376 y Fd(Notes:)340 2702 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 5640 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p eop end
-%%Page: 251 261
-TeXDict begin 251 260 bop 3643 52 a FF(251)p 0 351 3780
-12 v 0 483 a Fz(astGetT)-11 b(ableHeader)197 b Fe(Get)38
-b(the)h(FITS)g(headers)1461 583 y(from)e(a)i(FitsT)-10
-b(able)2645 483 y Fz(astGetT)f(ableHeader)0 736 y Fd(Description:)44
-b Fi(This)19 b(function)g(returns)f(a)g(p)r(oin)n(ter)g(to)g(a)g
-(FitsChan)h(holding)f(copies)f(of)i(the)g(FITS)g(headers)e(asso)r
-(ciated)227 835 y(with)28 b(a)g(FitsT)-7 b(able.)0 979
-y Fd(Synopsis:)121 b Ft(AstFitsChan)39 b Fh(\003)p Ft(astGetTableHead)o
-(er)o(\()f(AstFitsTable)g Fh(\003)p Ft(this)k(\))0 1122
-y Fd(P)m(arameters:)259 1252 y(this)427 1352 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(FitsT)-7 b(able.)0 1508 y Fd(Returned)32
-b(V)-8 b(alue:)259 1638 y(astGetT)g(ableHeader\(\))427
-1737 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(a)f(deep)h(cop)n(y)f(of)g(the)h
-(FitsChan)g(stored)e(within)j(the)f(FitsT)-7 b(able.)0
-1893 y Fd(Notes:)340 2169 y Fh(\017)45 b Fi(The)28 b(returned)f(p)r
-(oin)n(ter)g(should)h(b)r(e)g(ann)n(ulled)f(using)g(astAnn)n(ul)h(when)
-g(it)g(is)f(no)g(longer)g(needed.)340 2296 y Fh(\017)45
-b Fi(Changing)35 b(the)h(con)n(ten)n(ts)f(of)h(the)g(returned)g
-(FitsChan)f(will)h(ha)n(v)n(e)f(no)h(e\013ect)g(on)f(the)i(FitsT)-7
-b(able.)61 b(T)-7 b(o)427 2396 y(mo)r(dify)30 b(the)g(FitsT)-7
-b(able,)30 b(the)g(mo)r(di\014ed)g(FitsChan)g(m)n(ust)f(b)r(e)h(stored)
-f(in)h(the)g(FitsT)-7 b(able)29 b(using)g(astPut-)427
-2495 y(T)-7 b(ableHeader.)p 0 2682 V 0 2814 a Fz(astGetT)c(ables)153
-b Fe(Retriev)m(e)37 b(an)m(y)h(FitsT)-10 b(ables)37 b(curren)m(tly)g
-(in)h(a)1653 2929 y(FitsChan)3015 2814 y Fz(astGetT)-11
-b(ables)0 3082 y Fd(Description:)44 b Fi(If)22 b(the)f(supplied)h
-(FitsChan)f(curren)n(tly)f(con)n(tains)g(an)n(y)h(tables,)h(then)g
-(this)f(function)h(returns)e(a)h(p)r(oin)n(ter)227 3181
-y(to)29 b(a)f(KeyMap.)38 b(Eac)n(h)28 b(en)n(try)g(in)g(the)h(KeyMap)f
-(is)g(a)g(p)r(oin)n(ter)g(to)h(a)f(FitsT)-7 b(able)28
-b(holding)g(the)h(data)f(for)g(a)g(FITS)227 3281 y(binary)k(table.)53
-b(The)33 b(k)n(ey)f(used)h(to)g(access)f(eac)n(h)g(en)n(try)g(is)h(the)
-g(FITS)g(extension)g(name)f(in)i(whic)n(h)e(the)i(table)227
-3381 y(should)28 b(b)r(e)g(stored.)227 3502 y(T)-7 b(ables)28
-b(can)f(b)r(e)h(presen)n(t)f(in)i(a)e(FitsChan)h(as)f(a)g(result)h
-(either)g(of)f(using)h(the)g(astPutT)-7 b(able)27 b(\(or)g(astPutT)-7
-b(ables\))227 3602 y(metho)r(d)42 b(to)f(store)f(existing)h(tables)g
-(in)g(the)g(FitsChan,)k(or)40 b(of)h(using)g(the)h(astW)-7
-b(rite)40 b(metho)r(d)i(to)f(write)g(a)227 3701 y(F)-7
-b(rameSet)28 b(to)h(the)g(FitsChan.)39 b(F)-7 b(or)28
-b(the)h(later)e(case,)h(if)h(the)g(FitsChan)f Ft(")p
-Fi(T)-7 b(abOK)p Ft(")27 b Fi(attribute)h(is)h(p)r(ositiv)n(e)f(and)227
-3801 y(the)k(F)-7 b(rameSet)32 b(requires)e(a)h(lo)r(ok-up)g(table)g
-(to)h(describ)r(e)f(one)g(or)g(more)f(axes,)i(then)g(the)g
-Ft(")p Fi(-T)-7 b(AB)p Ft(")31 b Fi(algorithm)227 3901
+427 2802 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 3045 V 0 3176 a Fz(astGetT)-11
+b(ableHeader)197 b Fe(Get)38 b(the)h(FITS)g(headers)1461
+3276 y(from)e(a)i(FitsT)-10 b(able)2645 3176 y Fz(astGetT)f(ableHeader)
+0 3485 y Fd(Description:)44 b Fi(This)19 b(function)g(returns)f(a)g(p)r
+(oin)n(ter)g(to)g(a)g(FitsChan)h(holding)f(copies)f(of)i(the)g(FITS)g
+(headers)e(asso)r(ciated)227 3585 y(with)28 b(a)g(FitsT)-7
+b(able.)0 3778 y Fd(Synopsis:)121 b Ft(AstFitsChan)39
+b Fh(\003)p Ft(astGetTableHead)o(er)o(\()f(AstFitsTable)g
+Fh(\003)p Ft(this)k(\))0 3971 y Fd(P)m(arameters:)259
+4151 y(this)427 4251 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(FitsT)-7
+b(able.)0 4456 y Fd(Returned)32 b(V)-8 b(alue:)259 4636
+y(astGetT)g(ableHeader\(\))427 4736 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(a)
+f(deep)h(cop)n(y)f(of)g(the)h(FitsChan)g(stored)e(within)j(the)f(FitsT)
+-7 b(able.)0 4941 y Fd(Notes:)340 5267 y Fh(\017)45 b
+Fi(The)28 b(returned)f(p)r(oin)n(ter)g(should)h(b)r(e)g(ann)n(ulled)f
+(using)g(astAnn)n(ul)h(when)g(it)g(is)f(no)g(longer)g(needed.)340
+5422 y Fh(\017)45 b Fi(Changing)35 b(the)h(con)n(ten)n(ts)f(of)h(the)g
+(returned)g(FitsChan)f(will)h(ha)n(v)n(e)f(no)h(e\013ect)g(on)f(the)i
+(FitsT)-7 b(able.)61 b(T)-7 b(o)427 5522 y(mo)r(dify)30
+b(the)g(FitsT)-7 b(able,)30 b(the)g(mo)r(di\014ed)g(FitsChan)g(m)n(ust)
+f(b)r(e)h(stored)f(in)h(the)g(FitsT)-7 b(able)29 b(using)g(astPut-)427
+5621 y(T)-7 b(ableHeader.)p eop end
+%%Page: 252 262
+TeXDict begin 252 261 bop 0 52 a FF(252)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 483 a Fz(astGetT)-11 b(ables)153 b Fe(Retriev)m(e)37
+b(an)m(y)h(FitsT)-10 b(ables)37 b(curren)m(tly)g(in)h(a)1653
+598 y(FitsChan)3015 483 y Fz(astGetT)-11 b(ables)0 783
+y Fd(Description:)44 b Fi(If)22 b(the)f(supplied)h(FitsChan)f(curren)n
+(tly)f(con)n(tains)g(an)n(y)h(tables,)h(then)g(this)f(function)h
+(returns)e(a)h(p)r(oin)n(ter)227 883 y(to)29 b(a)f(KeyMap.)38
+b(Eac)n(h)28 b(en)n(try)g(in)g(the)h(KeyMap)f(is)g(a)g(p)r(oin)n(ter)g
+(to)h(a)f(FitsT)-7 b(able)28 b(holding)g(the)h(data)f(for)g(a)g(FITS)
+227 982 y(binary)k(table.)53 b(The)33 b(k)n(ey)f(used)h(to)g(access)f
+(eac)n(h)g(en)n(try)g(is)h(the)g(FITS)g(extension)g(name)f(in)i(whic)n
+(h)e(the)i(table)227 1082 y(should)28 b(b)r(e)g(stored.)227
+1216 y(T)-7 b(ables)28 b(can)f(b)r(e)h(presen)n(t)f(in)i(a)e(FitsChan)h
+(as)f(a)g(result)h(either)g(of)f(using)h(the)g(astPutT)-7
+b(able)27 b(\(or)g(astPutT)-7 b(ables\))227 1316 y(metho)r(d)42
+b(to)f(store)f(existing)h(tables)g(in)g(the)g(FitsChan,)k(or)40
+b(of)h(using)g(the)h(astW)-7 b(rite)40 b(metho)r(d)i(to)f(write)g(a)227
+1415 y(F)-7 b(rameSet)28 b(to)h(the)g(FitsChan.)39 b(F)-7
+b(or)28 b(the)h(later)e(case,)h(if)h(the)g(FitsChan)f
+Ft(")p Fi(T)-7 b(abOK)p Ft(")27 b Fi(attribute)h(is)h(p)r(ositiv)n(e)f
+(and)227 1515 y(the)k(F)-7 b(rameSet)32 b(requires)e(a)h(lo)r(ok-up)g
+(table)g(to)h(describ)r(e)f(one)g(or)g(more)f(axes,)i(then)g(the)g
+Ft(")p Fi(-T)-7 b(AB)p Ft(")31 b Fi(algorithm)227 1615
y(co)r(de)d(describ)r(ed)h(in)f(FITS-W)n(CS)h(pap)r(er)f(I)r(I)r(I)h
(is)f(used)g(and)g(the)h(table)g(v)-5 b(alues)28 b(are)f(stored)g(in)i
-(the)g(FitsChan)f(in)227 4000 y(the)g(form)g(of)f(a)g(FitsT)-7
+(the)g(FitsChan)f(in)227 1714 y(the)g(form)g(of)f(a)g(FitsT)-7
b(able)28 b(ob)5 b(ject)27 b(\(see)h(the)g(do)r(cumen)n(tation)f(for)g
(the)h Ft(")p Fi(T)-7 b(abOK)p Ft(")26 b Fi(attribute\).)0
-4144 y Fd(Synopsis:)121 b Ft(AstKeyMap)40 b Fh(\003)p
+1884 y Fd(Synopsis:)121 b Ft(AstKeyMap)40 b Fh(\003)p
Ft(astGetTables\()d(AstFitsChan)i Fh(\003)p Ft(this)j(\))0
-4287 y Fd(P)m(arameters:)259 4417 y(this)427 4517 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(FitsChan.)0 4672 y Fd(Returned)k(V)-8 b(alue:)259
-4803 y(astGetT)g(ables\(\))427 4902 y Fi(A)35 b(p)r(oin)n(ter)f(to)g(a)
+2053 y Fd(P)m(arameters:)259 2209 y(this)427 2309 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(FitsChan.)0 2490 y Fd(Returned)k(V)-8 b(alue:)259
+2647 y(astGetT)g(ables\(\))427 2746 y Fi(A)35 b(p)r(oin)n(ter)f(to)g(a)
g(deep)g(cop)n(y)g(of)g(the)h(KeyMap)e(holding)h(the)h(tables)f(curren)
-n(tly)f(in)i(the)f(FitsChan,)i(or)427 5002 y(NULL)27
+n(tly)f(in)i(the)f(FitsChan,)i(or)427 2846 y(NULL)27
b(if)f(the)h(FitsChan)f(do)r(es)g(not)g(con)n(tain)f(an)n(y)g(tables.)
36 b(The)26 b(returned)g(p)r(oin)n(ter)g(should)f(b)r(e)i(ann)n(ulled)
-427 5102 y(using)h(astAnn)n(ul)f(when)h(no)f(longer)g(needed.)0
-5257 y Fd(Notes:)340 5534 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+427 2946 y(using)h(astAnn)n(ul)f(when)h(no)f(longer)g(needed.)0
+3127 y Fd(Notes:)340 3430 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 5633 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p eop end
-%%Page: 252 262
-TeXDict begin 252 261 bop 0 52 a FF(252)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 482 a Fz(astGetUnc)896 483 y Fe(Obtain)38 b(uncertain)m(t)m(y)e
-(information)f(from)j(a)1713 596 y(Region)3152 482 y
-Fz(astGetUnc)0 813 y Fd(Description:)44 b Fi(This)24
-b(function)h(returns)e(a)h(Region)f(whic)n(h)h(represen)n(ts)e(the)j
-(uncertain)n(t)n(y)e(asso)r(ciated)g(with)h(p)r(ositions)227
-912 y(within)32 b(the)f(supplied)g(Region.)46 b(See)31
+427 3529 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 3748 V 0 3879 a Fz(astGetUnc)896
+3880 y Fe(Obtain)38 b(uncertain)m(t)m(y)e(information)f(from)j(a)1713
+3993 y(Region)3152 3879 y Fz(astGetUnc)0 4202 y Fd(Description:)44
+b Fi(This)24 b(function)h(returns)e(a)h(Region)f(whic)n(h)h(represen)n
+(ts)e(the)j(uncertain)n(t)n(y)e(asso)r(ciated)g(with)h(p)r(ositions)227
+4302 y(within)32 b(the)f(supplied)g(Region.)46 b(See)31
b(astSetUnc)g(for)f(more)g(information)g(ab)r(out)h(Region)f(uncertain)
-n(ties)g(and)227 1012 y(their)e(use.)0 1189 y Fd(Synopsis:)121
+n(ties)g(and)227 4401 y(their)e(use.)0 4570 y Fd(Synopsis:)121
b Ft(AstRegion)40 b Fh(\003)p Ft(astGetUnc\()f(AstRegion)h
-Fh(\003)p Ft(this,)h(int)h(def)g(\))0 1366 y Fd(P)m(arameters:)259
-1530 y(this)427 1629 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Region.)259
-1776 y Fd(def)427 1875 y Fi(Con)n(trols)i(what)i(is)f(returned)g(if)h
+Fh(\003)p Ft(this,)h(int)h(def)g(\))0 4740 y Fd(P)m(arameters:)259
+4896 y(this)427 4996 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Region.)259
+5138 y Fd(def)427 5238 y Fi(Con)n(trols)i(what)i(is)f(returned)g(if)h
(no)f(uncertain)n(t)n(y)g(information)g(has)f(b)r(een)i(asso)r(ciated)e
-(explicitly)i(with)427 1975 y(the)24 b(supplied)f(Region.)35
+(explicitly)i(with)427 5338 y(the)24 b(supplied)f(Region.)35
b(If)24 b(a)e(non-zero)g(v)-5 b(alue)23 b(is)g(supplied,)h(then)g(the)f
-(default)h(uncertain)n(t)n(y)e(Region)h(used)427 2075
+(default)h(uncertain)n(t)n(y)e(Region)h(used)427 5437
y(in)n(ternally)f(within)i(AST)g(is)e(returned)h(\(see)g
Ft(")p Fi(Applicabilit)n(y)p Ft(")f Fi(b)r(elo)n(w\).)35
-b(If)24 b(zero)e(is)g(supplied,)j(then)e(NULL)427 2174
+b(If)24 b(zero)e(is)g(supplied,)j(then)e(NULL)427 5537
y(will)28 b(b)r(e)g(returned)f(\(without)i(error\).)0
-2364 y Fd(Class)i(Applicabilit)m(y:)259 2528 y(CmpRegion)427
-2627 y Fi(The)f(default)g(uncertain)n(t)n(y)f(for)g(a)h(CmpRegion)f(is)
-g(tak)n(en)h(from)f(one)g(of)h(the)g(t)n(w)n(o)f(comp)r(onen)n(t)g
-(Regions.)427 2727 y(If)35 b(the)f(\014rst)g(comp)r(onen)n(t)f(Region)h
-(has)f(a)g(non-default)h(uncertain)n(t)n(y)-7 b(,)35
-b(then)f(it)h(is)f(used)g(as)f(the)h(default)427 2826
-y(uncertain)n(t)n(y)g(for)g(the)h(paren)n(t)f(CmpRegion.)58
+5718 y Fd(Class)i(Applicabilit)m(y:)p eop end
+%%Page: 253 263
+TeXDict begin 253 262 bop 3643 52 a FF(253)259 351 y
+Fd(CmpRegion)427 451 y Fi(The)30 b(default)g(uncertain)n(t)n(y)f(for)g
+(a)h(CmpRegion)f(is)g(tak)n(en)h(from)f(one)g(of)h(the)g(t)n(w)n(o)f
+(comp)r(onen)n(t)g(Regions.)427 551 y(If)35 b(the)f(\014rst)g(comp)r
+(onen)n(t)f(Region)h(has)f(a)g(non-default)h(uncertain)n(t)n(y)-7
+b(,)35 b(then)f(it)h(is)f(used)g(as)f(the)h(default)427
+650 y(uncertain)n(t)n(y)g(for)g(the)h(paren)n(t)f(CmpRegion.)58
b(Otherwise,)35 b(if)g(the)h(second)e(comp)r(onen)n(t)g(Region)g(has)g
-(a)427 2926 y(non-default)25 b(uncertain)n(t)n(y)-7 b(,)25
+(a)427 750 y(non-default)25 b(uncertain)n(t)n(y)-7 b(,)25
b(then)g(it)h(is)e(used)h(as)f(the)i(default)f(uncertain)n(t)n(y)f(for)
-h(the)g(paren)n(t)f(CmpRegion.)427 3026 y(If)g(neither)f(of)g(the)g
+h(the)g(paren)n(t)f(CmpRegion.)427 849 y(If)g(neither)f(of)g(the)g
(comp)r(onen)n(t)g(Regions)f(has)g(non-default)h(uncertain)n(t)n(y)-7
b(,)23 b(then)h(the)f(default)g(uncertain)n(t)n(y)427
-3125 y(for)k(the)h(CmpRegion)f(is)h(1.0E-6)d(of)j(the)g(b)r(ounding)g
-(b)r(o)n(x)f(of)g(the)h(CmpRegion.)259 3272 y Fd(Prism)427
-3372 y Fi(The)j(default)g(uncertain)n(t)n(y)f(for)g(a)h(Prism)e(is)i
+949 y(for)k(the)h(CmpRegion)f(is)h(1.0E-6)d(of)j(the)g(b)r(ounding)g(b)
+r(o)n(x)f(of)g(the)h(CmpRegion.)259 1077 y Fd(Prism)427
+1177 y Fi(The)j(default)g(uncertain)n(t)n(y)f(for)g(a)h(Prism)e(is)i
(formed)f(b)n(y)h(com)n(bining)f(the)h(uncertain)n(ties)f(from)g(the)h
-(t)n(w)n(o)427 3471 y(comp)r(onen)n(t)24 b(Regions.)35
+(t)n(w)n(o)427 1277 y(comp)r(onen)n(t)24 b(Regions.)35
b(If)25 b(a)f(comp)r(onen)n(t)g(Region)g(do)r(es)g(not)g(ha)n(v)n(e)f
(a)h(non-default)g(uncertain)n(t)n(y)-7 b(,)25 b(then)f(its)427
-3571 y(default)k(uncertain)n(t)n(y)f(will)h(b)r(e)g(used)f(to)h(form)f
+1376 y(default)k(uncertain)n(t)n(y)f(will)h(b)r(e)g(used)f(to)h(form)f
(the)h(default)g(uncertain)n(t)n(y)f(of)g(the)h(paren)n(t)f(Prism.)259
-3717 y Fd(Region)427 3817 y Fi(F)-7 b(or)37 b(other)g(classes)f(of)h
+1505 y Fd(Region)427 1604 y Fi(F)-7 b(or)37 b(other)g(classes)f(of)h
(Region,)i(the)f(default)f(uncertain)n(t)n(y)g(is)g(1.0E-6)e(of)i(the)h
-(b)r(ounding)f(b)r(o)n(x)g(of)g(the)427 3917 y(Region.)f(If)28
+(b)r(ounding)f(b)r(o)n(x)g(of)g(the)427 1704 y(Region.)f(If)28
b(the)f(b)r(ounding)h(b)r(o)n(x)e(has)h(zero)f(width)i(on)f(an)n(y)f
(axis,)g(then)i(the)g(uncertain)n(t)n(y)e(will)h(b)r(e)h(1.0E-6)427
-4016 y(of)g(the)g(axis)f(v)-5 b(alue.)0 4206 y Fd(Returned)32
-b(V)-8 b(alue:)259 4370 y(astGetUnc\(\))427 4469 y Fi(A)28
+1804 y(of)g(the)g(axis)f(v)-5 b(alue.)0 1961 y Fd(Returned)32
+b(V)-8 b(alue:)259 2093 y(astGetUnc\(\))427 2193 y Fi(A)28
b(p)r(oin)n(ter)f(to)h(a)f(Region)g(describing)g(the)h(uncertain)n(t)n
-(y)e(in)i(the)g(supplied)g(Region.)0 4659 y Fd(Notes:)340
-4969 y Fh(\017)45 b Fi(If)29 b(uncertain)n(t)n(y)f(information)g(is)h
+(y)e(in)i(the)g(supplied)g(Region.)0 2350 y Fd(Notes:)340
+2628 y Fh(\017)45 b Fi(If)29 b(uncertain)n(t)n(y)f(information)g(is)h
(asso)r(ciated)e(with)i(a)f(Region,)g(and)h(the)g(co)r(ordinate)e
-(system)i(describ)r(ed)427 5068 y(b)n(y)c(the)g(Region)f(is)g
+(system)i(describ)r(ed)427 2728 y(b)n(y)c(the)g(Region)f(is)g
(subsequen)n(tly)g(c)n(hanged)g(\(e.g.)36 b(b)n(y)24
b(c)n(hanging)f(the)i(v)-5 b(alue)25 b(of)f(its)h(System)g(attribute,)g
-(or)427 5168 y(using)c(the)g(astMapRegion)f(function\),)j(then)f(the)f
+(or)427 2827 y(using)c(the)g(astMapRegion)f(function\),)j(then)f(the)f
(uncertain)n(t)n(y)f(information)g(returned)h(b)n(y)g(this)g(function)
-427 5267 y(will)j(b)r(e)h(mo)r(di\014ed)f(so)f(that)h(it)h(refers)e(to)
+427 2927 y(will)j(b)r(e)h(mo)r(di\014ed)f(so)f(that)h(it)h(refers)e(to)
g(the)i(co)r(ordinate)d(system)i(curren)n(tly)f(describ)r(ed)g(b)n(y)h
-(the)g(supplied)427 5367 y(Region.)340 5514 y Fh(\017)45
+(the)g(supplied)427 3026 y(Region.)340 3155 y Fh(\017)45
b Fi(A)26 b(n)n(ull)f(Ob)5 b(ject)24 b(p)r(oin)n(ter)h(\(NULL\))h(will)
f(b)r(e)g(returned)g(if)g(this)h(function)f(is)g(in)n(v)n(ok)n(ed)e
-(with)j(the)f(AST)h(error)427 5613 y(status)i(set,)f(or)g(if)h(it)g
-(should)g(fail)f(for)g(an)n(y)g(reason.)p eop end
-%%Page: 253 263
-TeXDict begin 253 262 bop 3643 52 a FF(253)p 0 351 3780
-12 v 0 483 a Fz(astGrfP)l(op)173 b Fe(Restore)38 b(previously)f(sa)m(v)
-m(ed)h(graphics)g(functions)1518 598 y(used)h(b)m(y)g(a)f(Plot)3177
-483 y Fz(astGrfP)l(op)0 789 y Fd(Description:)44 b Fi(This)34
-b(function)g(restores)d(a)i(snapshot)g(of)g(the)h(graphics)e(functions)
-i(stored)e(previously)g(b)n(y)h(calling)227 889 y(astGrfPush.)51
-b(The)33 b(restored)e(graphics)g(functions)i(b)r(ecome)g(the)g(curren)n
-(t)e(graphics)g(functions)i(used)g(b)n(y)f(the)227 989
-y(Plot.)227 1115 y(The)26 b(astGrfPush)f(and)h(astGrfP)n(op)e
+(with)j(the)f(AST)h(error)427 3254 y(status)i(set,)f(or)g(if)h(it)g
+(should)g(fail)f(for)g(an)n(y)g(reason.)p 0 3445 3780
+12 v 0 3577 a Fz(astGrfP)l(op)173 b Fe(Restore)38 b(previously)f(sa)m
+(v)m(ed)h(graphics)g(functions)1518 3691 y(used)h(b)m(y)g(a)f(Plot)3177
+3577 y Fz(astGrfP)l(op)0 3871 y Fd(Description:)44 b
+Fi(This)34 b(function)g(restores)d(a)i(snapshot)g(of)g(the)h(graphics)e
+(functions)i(stored)e(previously)g(b)n(y)h(calling)227
+3971 y(astGrfPush.)51 b(The)33 b(restored)e(graphics)g(functions)i(b)r
+(ecome)g(the)g(curren)n(t)e(graphics)g(functions)i(used)g(b)n(y)f(the)
+227 4070 y(Plot.)227 4193 y(The)26 b(astGrfPush)f(and)h(astGrfP)n(op)e
(functions)i(are)f(in)n(tended)i(for)e(situations)g(where)h(it)g(is)g
-(necessary)e(to)h(mak)n(e)227 1214 y(temp)r(orary)j(c)n(hanges)g(to)h
+(necessary)e(to)h(mak)n(e)227 4292 y(temp)r(orary)j(c)n(hanges)g(to)h
(the)g(graphics)f(functions)h(used)g(b)n(y)g(the)g(Plot.)41
b(The)29 b(curren)n(t)f(functions)h(should)g(\014rst)227
-1314 y(b)r(e)35 b(sa)n(v)n(ed)e(b)n(y)g(calling)h(astGrfPush.)56
+4392 y(b)r(e)35 b(sa)n(v)n(ed)e(b)n(y)g(calling)h(astGrfPush.)56
b(New)34 b(functions)g(should)g(then)h(b)r(e)g(registered)d(using)i
-(astGrfSet.)57 b(The)227 1414 y(required)36 b(graphics)f(should)i(then)
+(astGrfSet.)57 b(The)227 4491 y(required)36 b(graphics)f(should)i(then)
g(b)r(e)g(pro)r(duced.)64 b(Finally)-7 b(,)39 b(astGrfP)n(op)c(should)i
-(b)r(e)g(called)f(to)h(restore)e(the)227 1513 y(original)26
-b(graphics)g(functions.)0 1666 y Fd(Synopsis:)121 b Ft(void)42
-b(astGrfPop\()d(AstPlot)i Fh(\003)p Ft(this)g(\))0 1818
-y Fd(P)m(arameters:)259 1958 y(this)427 2058 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(Plot.)0 2223 y Fd(Notes:)340 2508 y Fh(\017)45
+(b)r(e)g(called)f(to)h(restore)e(the)227 4591 y(original)26
+b(graphics)g(functions.)0 4736 y Fd(Synopsis:)121 b Ft(void)42
+b(astGrfPop\()d(AstPlot)i Fh(\003)p Ft(this)g(\))0 4881
+y Fd(P)m(arameters:)259 5013 y(this)427 5113 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(Plot.)0 5270 y Fd(Notes:)340 5548 y Fh(\017)45
b Fi(This)24 b(function)f(returns)g(without)h(action)e(if)i(there)f
(are)f(no)h(snapshots)g(to)g(restore.)34 b(No)23 b(error)e(is)i(rep)r
-(orted)427 2608 y(in)28 b(this)g(case.)p 0 2810 V 0 2942
-a Fz(astGrfPush)186 b Fe(Sa)m(v)m(e)38 b(the)h(curren)m(t)e(graphics)g
-(functions)h(used)1652 3056 y(b)m(y)g(a)h(Plot)3113 2942
-y Fz(astGrfPush)0 3248 y Fd(Description:)44 b Fi(This)34
+(orted)427 5648 y(in)28 b(this)g(case.)p eop end
+%%Page: 254 264
+TeXDict begin 254 263 bop 0 52 a FF(254)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 483 a Fz(astGrfPush)186 b Fe(Sa)m(v)m(e)38 b(the)h(curren)m(t)e
+(graphics)g(functions)h(used)1652 598 y(b)m(y)g(a)h(Plot)3113
+483 y Fz(astGrfPush)0 792 y Fd(Description:)44 b Fi(This)34
b(function)h(tak)n(es)e(a)h(snapshot)f(of)h(the)g(graphics)f(functions)
-h(whic)n(h)g(are)f(curren)n(tly)g(registered)227 3348
+h(whic)n(h)g(are)f(curren)n(tly)g(registered)227 892
y(with)h(the)g(supplied)f(Plot,)i(and)e(sa)n(v)n(es)e(the)j(snapshot)e
(on)h(a)g(\014rst-in-last-out)f(stac)n(k)g(within)i(the)g(Plot.)54
-b(The)227 3448 y(snapshot)27 b(can)g(b)r(e)h(restored)f(later)f(using)i
-(function)g(astGrfP)n(op.)227 3574 y(The)e(astGrfPush)f(and)h(astGrfP)n
+b(The)227 992 y(snapshot)27 b(can)g(b)r(e)h(restored)f(later)f(using)i
+(function)g(astGrfP)n(op.)227 1119 y(The)e(astGrfPush)f(and)h(astGrfP)n
(op)e(functions)i(are)f(in)n(tended)i(for)e(situations)g(where)h(it)g
-(is)g(necessary)e(to)h(mak)n(e)227 3673 y(temp)r(orary)j(c)n(hanges)g
+(is)g(necessary)e(to)h(mak)n(e)227 1219 y(temp)r(orary)j(c)n(hanges)g
(to)h(the)g(graphics)f(functions)h(used)g(b)n(y)g(the)g(Plot.)41
b(The)29 b(curren)n(t)f(functions)h(should)g(\014rst)227
-3773 y(b)r(e)35 b(sa)n(v)n(ed)e(b)n(y)g(calling)h(astGrfPush.)56
+1318 y(b)r(e)35 b(sa)n(v)n(ed)e(b)n(y)g(calling)h(astGrfPush.)56
b(New)34 b(functions)g(should)g(then)h(b)r(e)g(registered)d(using)i
-(astGrfSet.)57 b(The)227 3873 y(required)36 b(graphics)f(should)i(then)
+(astGrfSet.)57 b(The)227 1418 y(required)36 b(graphics)f(should)i(then)
g(b)r(e)g(pro)r(duced.)64 b(Finally)-7 b(,)39 b(astGrfP)n(op)c(should)i
-(b)r(e)g(called)f(to)h(restore)e(the)227 3972 y(original)26
-b(graphics)g(functions.)0 4125 y Fd(Synopsis:)121 b Ft(void)42
-b(astGrfPush\()d(AstPlot)i Fh(\003)p Ft(this)g(\))0 4277
-y Fd(P)m(arameters:)259 4417 y(this)427 4516 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(Plot.)p 0 4719 V 0 4850 a Fz(astGrfSet)163
+(b)r(e)g(called)f(to)h(restore)e(the)227 1518 y(original)26
+b(graphics)g(functions.)0 1673 y Fd(Synopsis:)121 b Ft(void)42
+b(astGrfPush\()d(AstPlot)i Fh(\003)p Ft(this)g(\))0 1829
+y Fd(P)m(arameters:)259 1971 y(this)427 2071 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(Plot.)p 0 2276 V 0 2408 a Fz(astGrfSet)163
b Fe(Register)38 b(a)g(graphics)g(function)f(for)h(use)h(b)m(y)g(a)f
-(Plot)161 b Fz(astGrfSet)0 5042 y Fd(Description:)44
+(Plot)161 b Fz(astGrfSet)0 2602 y Fd(Description:)44
b Fi(This)25 b(function)g(can)f(b)r(e)g(used)h(to)f(select)g(the)h
(underlying)f(graphics)f(functions)h(to)h(b)r(e)f(used)h(when)f(the)227
-5142 y(supplied)i(Plot)e(pro)r(duces)h(graphical)e(output.)37
+2702 y(supplied)i(Plot)e(pro)r(duces)h(graphical)e(output.)37
b(If)25 b(this)h(function)f(is)g(not)g(called)g(prior)f(to)h(pro)r
-(ducing)f(graphical)227 5242 y(output,)j(then)e(the)h(underlying)f
+(ducing)f(graphical)227 2802 y(output,)j(then)e(the)h(underlying)f
(graphics)f(functions)h(selected)h(at)f(link-time)g(\(using)g(the)h
-(ast)p Ft(_)p Fi(link)f(command\))227 5341 y(will)30
+(ast)p Ft(_)p Fi(link)f(command\))227 2901 y(will)30
b(b)r(e)g(used.)44 b(T)-7 b(o)29 b(use)g(alternativ)n(e)g(graphics)f
(functions,)j(call)e(this)h(function)g(b)r(efore)g(the)g(graphical)e
-(output)227 5441 y(is)i(created,)h(sp)r(ecifying)f(the)h(graphics)e
+(output)227 3001 y(is)i(created,)h(sp)r(ecifying)f(the)h(graphics)e
(functions)h(to)g(b)r(e)h(used.)45 b(This)30 b(will)h(register)e(the)i
-(function)f(for)g(future)227 5540 y(use,)e(but)g(the)g(function)g(will)
+(function)f(for)g(future)227 3101 y(use,)e(but)g(the)g(function)g(will)
g(not)g(actually)e(b)r(e)j(used)e(un)n(til)h(the)g(Grf)g(attribute)g
-(is)f(giv)n(en)g(a)g(non-zero)f(v)-5 b(alue.)0 5693 y
+(is)f(giv)n(en)g(a)g(non-zero)f(v)-5 b(alue.)0 3256 y
Fd(Synopsis:)121 b Ft(void)42 b(astGrfSet\()d(AstPlot)i
Fh(\003)p Ft(this,)g(const)g(char)h Fh(\003)p Ft(name,)f(AstGrfFun)f
-(fun)j(\))p eop end
-%%Page: 254 264
-TeXDict begin 254 263 bop 0 52 a FF(254)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(P)m(arameters:)259
-497 y(this)427 597 y Fi(P)n(oin)n(ter)c(to)i(the)g(Plot.)259
-734 y Fd(name)427 834 y Fi(A)g(name)f(indicating)g(the)h(graphics)d
+(fun)j(\))0 3412 y Fd(P)m(arameters:)259 3554 y(this)427
+3654 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259 3789
+y Fd(name)427 3889 y Fi(A)g(name)f(indicating)g(the)h(graphics)d
(function)j(to)f(b)r(e)h(replaced.)36 b(V)-7 b(arious)26
-b(graphics)g(functions)h(are)g(used)427 934 y(b)n(y)d(the)h(Plot)f
+b(graphics)g(functions)h(are)g(used)427 3989 y(b)n(y)d(the)h(Plot)f
(class,)g(and)h(an)n(y)e(com)n(bination)h(of)g(them)h(ma)n(y)f(b)r(e)h
(supplied)f(b)n(y)h(calling)e(this)i(function)g(once)427
-1033 y(for)f(eac)n(h)g(function)g(to)h(b)r(e)f(replaced.)35
+4088 y(for)f(eac)n(h)g(function)g(to)h(b)r(e)f(replaced.)35
b(If)25 b(an)n(y)e(of)i(the)f(graphics)f(functions)i(are)e(not)h
-(replaced)g(in)g(this)h(w)n(a)n(y)-7 b(,)427 1133 y(the)26
+(replaced)g(in)g(this)h(w)n(a)n(y)-7 b(,)427 4188 y(the)26
b(corresp)r(onding)d(functions)i(in)h(the)f(graphics)f(in)n(terface)g
(selected)h(at)g(link-time)h(\(using)f(the)g(ast)p Ft(_)p
-Fi(link)427 1232 y(command\))j(are)e(used.)37 b(The)28
-b(allo)n(w)n(ed)e(names)h(are:)510 1463 y Fh(\017)45
+Fi(link)427 4288 y(command\))j(are)e(used.)37 b(The)28
+b(allo)n(w)n(ed)e(names)h(are:)510 4516 y Fh(\017)45
b Fi(A)n(ttr)28 b(-)f(Enquire)g(or)g(set)g(a)h(graphics)e(attribute)h
-(v)-5 b(alue)510 1582 y Fh(\017)45 b Fi(BBuf)28 b(-)f(Start)h(a)f(new)h
-(graphics)e(bu\013ering)h(con)n(text)510 1700 y Fh(\017)45
-b Fi(Cap)28 b(-)f(Inquire)g(a)g(capabilit)n(y)510 1819
+(v)-5 b(alue)510 4633 y Fh(\017)45 b Fi(BBuf)28 b(-)f(Start)h(a)f(new)h
+(graphics)e(bu\013ering)h(con)n(text)510 4751 y Fh(\017)45
+b Fi(Cap)28 b(-)f(Inquire)g(a)g(capabilit)n(y)510 4869
y Fh(\017)45 b Fi(EBuf)28 b(-)f(End)h(the)g(curren)n(t)e(graphics)g
-(bu\013ering)i(con)n(text)510 1937 y Fh(\017)45 b Fi(Flush)28
+(bu\013ering)i(con)n(text)510 4987 y Fh(\017)45 b Fi(Flush)28
b(-)g(Flush)f(all)h(p)r(ending)g(graphics)e(to)h(the)h(output)g(device)
-510 2056 y Fh(\017)45 b Fi(Line)28 b(-)f(Dra)n(w)g(a)g(p)r(olyline)h
+510 5104 y Fh(\017)45 b Fi(Line)28 b(-)f(Dra)n(w)g(a)g(p)r(olyline)h
(\(i.e.)37 b(a)27 b(set)h(of)f(connected)h(lines\))510
-2175 y Fh(\017)45 b Fi(Mark)27 b(-)g(Dra)n(w)g(a)g(set)h(of)f(mark)n
-(ers)510 2293 y Fh(\017)45 b Fi(Qc)n(h)27 b(-)h(Return)f(the)h(c)n
+5222 y Fh(\017)45 b Fi(Mark)27 b(-)g(Dra)n(w)g(a)g(set)h(of)f(mark)n
+(ers)510 5340 y Fh(\017)45 b Fi(Qc)n(h)27 b(-)h(Return)f(the)h(c)n
(haracter)e(heigh)n(t)h(in)h(w)n(orld)f(co)r(ordinates)510
-2412 y Fh(\017)45 b Fi(Scales)27 b(-)h(Get)g(the)g(axis)e(scales)510
-2530 y Fh(\017)45 b Fi(T)-7 b(ext)28 b(-)f(Dra)n(w)g(a)g(c)n(haracter)f
-(string)510 2649 y Fh(\017)45 b Fi(TxExt)27 b(-)h(Get)g(the)g(exten)n
-(t)f(of)h(a)f(c)n(haracter)f(string)427 2787 y(The)k(string)g(is)g
-(case)f(insensitiv)n(e.)44 b(F)-7 b(or)30 b(details)f(of)h(the)h(in)n
-(terface)e(required)g(for)h(eac)n(h,)g(see)g(the)g(sections)427
-2886 y(b)r(elo)n(w.)259 3024 y Fd(fun)427 3123 y Fi(A)37
-b(P)n(oin)n(ter)e(to)i(the)g(function)g(to)f(b)r(e)h(used)g(to)f(pro)n
-(vide)g(the)g(functionalit)n(y)h(indicated)g(b)n(y)f(parameter)427
-3223 y(name.)h(The)26 b(in)n(terface)g(for)g(eac)n(h)g(function)i(is)e
-(describ)r(ed)g(b)r(elo)n(w,)h(but)g(the)g(function)h(p)r(oin)n(ter)e
-(should)g(b)r(e)427 3323 y(cast)h(to)h(a)f(t)n(yp)r(e)h(of)f(AstGrfF)-7
-b(un)29 b(when)f(calling)f(astGrfSet.)427 3441 y(Once)34
-b(a)g(function)h(has)e(b)r(een)i(pro)n(vided,)g(a)f(n)n(ull)g(p)r(oin)n
-(ter)g(can)g(b)r(e)g(supplied)h(in)f(a)g(subsequen)n(t)g(call)g(to)427
-3541 y(astGrfSet)22 b(to)f(reset)g(the)h(function)g(to)g(the)f(corresp)
-r(onding)f(function)i(in)g(the)g(graphics)e(in)n(terface)h(selected)427
-3640 y(at)28 b(link-time.)-2 3812 y Fd(F)-8 b(unction)32
-b(In)m(terfaces)n(:)227 3958 y Fi(All)i(the)f(functions)g(listed)g(b)r
+5458 y Fh(\017)45 b Fi(Scales)27 b(-)h(Get)g(the)g(axis)e(scales)510
+5575 y Fh(\017)45 b Fi(T)-7 b(ext)28 b(-)f(Dra)n(w)g(a)g(c)n(haracter)f
+(string)510 5693 y Fh(\017)45 b Fi(TxExt)27 b(-)h(Get)g(the)g(exten)n
+(t)f(of)h(a)f(c)n(haracter)f(string)p eop end
+%%Page: 255 265
+TeXDict begin 255 264 bop 3643 52 a FF(255)427 351 y
+Fi(The)30 b(string)g(is)g(case)f(insensitiv)n(e.)44 b(F)-7
+b(or)30 b(details)f(of)h(the)h(in)n(terface)e(required)g(for)h(eac)n
+(h,)g(see)g(the)g(sections)427 451 y(b)r(elo)n(w.)259
+579 y Fd(fun)427 679 y Fi(A)37 b(P)n(oin)n(ter)e(to)i(the)g(function)g
+(to)f(b)r(e)h(used)g(to)f(pro)n(vide)g(the)g(functionalit)n(y)h
+(indicated)g(b)n(y)f(parameter)427 778 y(name.)h(The)26
+b(in)n(terface)g(for)g(eac)n(h)g(function)i(is)e(describ)r(ed)g(b)r
+(elo)n(w,)h(but)g(the)g(function)h(p)r(oin)n(ter)e(should)g(b)r(e)427
+878 y(cast)h(to)h(a)f(t)n(yp)r(e)h(of)f(AstGrfF)-7 b(un)29
+b(when)f(calling)f(astGrfSet.)427 992 y(Once)34 b(a)g(function)h(has)e
+(b)r(een)i(pro)n(vided,)g(a)f(n)n(ull)g(p)r(oin)n(ter)g(can)g(b)r(e)g
+(supplied)h(in)f(a)g(subsequen)n(t)g(call)g(to)427 1092
+y(astGrfSet)22 b(to)f(reset)g(the)h(function)g(to)g(the)f(corresp)r
+(onding)f(function)i(in)g(the)g(graphics)e(in)n(terface)h(selected)427
+1191 y(at)28 b(link-time.)-2 1349 y Fd(F)-8 b(unction)32
+b(In)m(terfaces)n(:)227 1495 y Fi(All)i(the)f(functions)g(listed)g(b)r
(elo)n(w)g(\(except)g(for)g Ft(")p Fi(Cap)p Ft(")p Fi(\))f(should)g
(return)h(an)f(in)n(teger)g(v)-5 b(alue)33 b(of)g(0)g(if)g(an)g(error)
-227 4057 y(o)r(ccurs,)43 b(and)d(1)f(otherwise.)74 b(All)40
+227 1594 y(o)r(ccurs,)43 b(and)d(1)f(otherwise.)74 b(All)40
b(x)g(and)g(y)g(v)-5 b(alues)40 b(refer)f(to)h Ft(")p
Fi(graphics)e(cordinates)p Ft(")h Fi(as)g(de\014ned)h(b)n(y)g(the)227
-4157 y(graph)n(b)r(o)n(x)26 b(parameter)g(of)i(the)g(astPlot)e(call)h
-(whic)n(h)h(created)f(the)h(Plot.)227 4286 y(The)i(\014rst)f(parameter)
+1694 y(graph)n(b)r(o)n(x)26 b(parameter)g(of)i(the)g(astPlot)e(call)h
+(whic)n(h)h(created)f(the)h(Plot.)227 1816 y(The)i(\014rst)f(parameter)
f(\()p Ft(")p Fi(grfcon)p Ft(")p Fi(\))g(for)h(eac)n(h)g(function)h(is)
g(an)f(AST)h(KeyMap)e(p)r(oin)n(ter)i(that)f(can)g(b)r(e)h(used)g(b)n
-(y)227 4386 y(the)24 b(called)f(function)h(to)f(establish)g(the)h(con)n
+(y)227 1916 y(the)24 b(called)f(function)h(to)f(establish)g(the)h(con)n
(text)e(in)i(whic)n(h)f(it)h(is)f(b)r(eing)h(called.)35
-b(The)23 b(con)n(ten)n(ts)g(of)g(the)h(KeyMap)227 4486
+b(The)23 b(con)n(ten)n(ts)g(of)g(the)h(KeyMap)227 2015
y(are)h(determined)i(b)n(y)f(the)g(calling)g(application,)f(whic)n(h)h
(should)g(obtain)g(a)g(p)r(oin)n(ter)g(to)g(the)g(KeyMap)f(using)h(the)
-227 4585 y(astGetGrfCon)n(text)34 b(function,)j(and)d(then)h(store)f
+227 2115 y(astGetGrfCon)n(text)34 b(function,)j(and)d(then)h(store)f
(an)n(y)g(necessary)e(information)i(in)h(the)g(KeyMap)e(using)h(the)227
-4685 y(metho)r(ds)e(of)f(the)h(KeyMap)e(class.)47 b(Note,)33
+2215 y(metho)r(ds)e(of)f(the)h(KeyMap)e(class.)47 b(Note,)33
b(the)f(functions)f(listed)h(b)r(elo)n(w)f(should)g(nev)n(er)f(ann)n
-(ul)h(or)g(delete)g(the)227 4784 y(supplied)d(KeyMap)f(p)r(oin)n(ter.)
--2 4943 y Fd(A)m(ttr)n(:)227 5089 y Fi(The)38 b Ft(")p
+(ul)h(or)g(delete)g(the)227 2314 y(supplied)d(KeyMap)f(p)r(oin)n(ter.)
+-2 2459 y Fd(A)m(ttr)n(:)227 2605 y Fi(The)38 b Ft(")p
Fi(A)n(ttr)p Ft(")e Fi(function)i(returns)e(the)i(curren)n(t)e(v)-5
b(alue)37 b(of)h(a)e(sp)r(eci\014ed)i(graphics)e(attribute,)j(and)e
-(optionally)227 5189 y(establishes)23 b(a)h(new)g(v)-5
+(optionally)227 2705 y(establishes)23 b(a)h(new)g(v)-5
b(alue.)35 b(The)24 b(supplied)h(v)-5 b(alue)23 b(is)h(con)n(v)n(erted)
f(to)g(an)h(in)n(teger)f(v)-5 b(alue)24 b(if)g(necessary)e(b)r(efore)i
-(use.)227 5289 y(It)k(requires)e(the)i(follo)n(wing)f(in)n(terface:)227
-5418 y(in)n(t)h(A)n(ttr\()g(AstOb)5 b(ject)28 b Fh(\003)p
+(use.)227 2804 y(It)k(requires)e(the)i(follo)n(wing)f(in)n(terface:)227
+2927 y(in)n(t)h(A)n(ttr\()g(AstOb)5 b(ject)28 b Fh(\003)p
Fi(grfcon,)e(in)n(t)i(attr,)f(double)h(v)-5 b(alue,)27
b(double)h Fh(\003)p Fi(old)p Ft(_)p Fi(v)-5 b(alue,)26
-b(in)n(t)i(prim)g(\))340 5693 y Fh(\017)45 b Fi(grfcon)27
+b(in)n(t)i(prim)g(\))340 3181 y Fh(\017)45 b Fi(grfcon)27
b(-)g(A)h(KeyMap)f(con)n(taining)f(information)h(passed)g(from)g(the)h
-(calling)f(application.)p eop end
-%%Page: 255 265
-TeXDict begin 255 264 bop 3643 52 a FF(255)340 351 y
-Fh(\017)45 b Fi(attr)39 b(-)f(An)h(in)n(teger)f(v)-5
-b(alue)39 b(iden)n(tifying)g(the)g(required)f(attribute.)70
-b(The)39 b(follo)n(wing)f(sym)n(b)r(olic)g(v)-5 b(alues)427
-451 y(are)27 b(de\014ned)i(in)g(grf.h:)37 b(GRF)p Ft(__)p
-Fi(STYLE)28 b(\(Line)h(st)n(yle\),)f(GRF)p Ft(__)p Fi(WIDTH)h(\(Line)f
-(width\),)i(GRF)p Ft(__)p Fi(SIZE)427 551 y(\(Character)f(and)i(mark)n
-(er)d(size)j(scale)e(factor\),)i(GRF)p Ft(__)p Fi(F)n(ONT)f
-(\(Character)f(fon)n(t\),)j(GRF)p Ft(__)p Fi(COLOUR)427
-650 y(\(Colour)27 b(index\).)340 788 y Fh(\017)45 b Fi(v)-5
-b(alue)28 b(-)f(A)h(new)g(v)-5 b(alue)27 b(to)h(store)e(for)h(the)h
-(attribute.)37 b(If)28 b(this)g(is)g(AST)p Ft(__)p Fi(BAD)f(no)h(v)-5
-b(alue)27 b(is)h(stored.)340 925 y Fh(\017)45 b Fi(old)p
-Ft(_)p Fi(v)-5 b(alue)26 b(-)h(A)g(p)r(oin)n(ter)g(to)g(a)f(double)h
-(in)g(whic)n(h)g(to)g(return)f(the)i(attribute)f(v)-5
-b(alue.)36 b(If)28 b(this)f(is)g(NULL,)g(no)427 1025
-y(v)-5 b(alue)28 b(is)f(returned.)340 1162 y Fh(\017)45
-b Fi(prim)30 b(-)f(The)g(sort)g(of)g(graphics)f(primitiv)n(e)h(to)g(b)r
-(e)h(dra)n(wn)e(with)i(the)g(new)f(attribute.)42 b(Iden)n(ti\014ed)30
-b(b)n(y)f(the)427 1262 y(follo)n(wing)e(v)-5 b(alues)27
-b(de\014ned)h(in)g(grf.h:)36 b(GRF)p Ft(__)p Fi(LINE,)27
-b(GRF)p Ft(__)p Fi(MARK,)h(GRF)p Ft(__)p Fi(TEXT.)-2
-1433 y Fd(BBuf)n(:)227 1579 y Fi(The)21 b Ft(")p Fi(BBuf)p
-Ft(")f Fi(function)h(should)g(start)f(a)g(new)g(graphics)g(bu\013ering)
-g(con)n(text.)34 b(A)21 b(matc)n(hing)f(call)h(to)f(the)h(function)227
-1679 y Ft(")p Fi(EBuf)p Ft(")37 b Fi(should)h(b)r(e)h(used)f(to)g(end)g
-(the)g(con)n(text.)68 b(The)38 b(nature)g(of)g(the)g(bu\013ering)g(is)g
-(determined)g(b)n(y)g(the)227 1778 y(underlying)27 b(graphics)f
-(system.)227 1908 y(in)n(t)i(BBuf\()g(AstOb)5 b(ject)28
-b Fh(\003)p Fi(grfcon)e(\))340 2183 y Fh(\017)45 b Fi(grfcon)27
-b(-)g(A)h(KeyMap)f(con)n(taining)f(information)h(passed)g(from)g(the)h
-(calling)f(application.)-2 2354 y Fd(Cap)n(:)227 2500
-y Fi(The)f Ft(")p Fi(Cap)p Ft(")e Fi(function)i(is)g(called)f(to)g
-(determine)h(if)g(the)g(grf)f(mo)r(dule)g(has)g(a)g(giv)n(en)g
-(capabilit)n(y)-7 b(,)25 b(as)g(indicated)h(b)n(y)227
-2600 y(the)i Ft(")p Fi(cap)p Ft(")f Fi(argumen)n(t:)227
-2729 y(in)n(t)h(Cap\()g(AstOb)5 b(ject)27 b Fh(\003)p
-Fi(grfcon,)g(in)n(t)g(cap,)h(in)n(t)g(v)-5 b(alue)27
-b(\))340 3004 y Fh(\017)45 b Fi(grfcon)27 b(-)g(A)h(KeyMap)f(con)n
-(taining)f(information)h(passed)g(from)g(the)h(calling)f(application.)
-340 3141 y Fh(\017)45 b Fi(cap)24 b(-)f(The)h(capabilit)n(y)f(b)r(eing)
-h(inquired)g(ab)r(out.)36 b(This)24 b(will)g(b)r(e)g(one)f(of)h(the)h
-(follo)n(wing)d(constan)n(ts)h(de\014ned)427 3241 y(in)28
-b(grf.h:)227 3412 y(GRF)p Ft(__)p Fi(SCALES:)33 b(This)g(function)h
-(should)f(return)g(a)f(non-zero)g(v)-5 b(alue)33 b(if)h(the)f
-Ft(")p Fi(Scales)p Ft(")f Fi(function)h(is)h(imple-)227
-3512 y(men)n(ted,)28 b(and)g(zero)e(otherwise.)36 b(The)28
-b(supplied)g Ft(")p Fi(v)-5 b(alue)p Ft(")26 b Fi(argumen)n(t)h(should)
-g(b)r(e)h(ignored.)227 3641 y(GRF)p Ft(__)p Fi(MJUST:)c(This)g
-(function)g(should)g(return)f(a)h(non-zero)e(v)-5 b(alue)23
-b(if)i(the)f Ft(")p Fi(T)-7 b(ext)p Ft(")23 b Fi(and)h
-Ft(")p Fi(TxExt)p Ft(")e Fi(functions)227 3740 y(recognise)35
-b Ft(")p Fi(M)p Ft(")i Fi(as)f(a)g(c)n(haracter)f(in)i(the)h
-(justi\014cation)f(string.)64 b(If)37 b(the)h(\014rst)e(c)n(haracter)f
-(of)i(a)f(justi\014cation)227 3840 y(string)d(is)h Ft(")p
-Fi(M)p Ft(")p Fi(,)g(then)g(the)g(text)g(should)f(b)r(e)h(justi\014ed)g
-(with)g(the)g(giv)n(en)f(reference)g(p)r(oin)n(t)g(at)h(the)g(b)r
-(ottom)g(of)227 3940 y(the)f(b)r(ounding)f(b)r(o)n(x.)51
+(calling)f(application.)340 3309 y Fh(\017)45 b Fi(attr)39
+b(-)f(An)h(in)n(teger)f(v)-5 b(alue)39 b(iden)n(tifying)g(the)g
+(required)f(attribute.)70 b(The)39 b(follo)n(wing)f(sym)n(b)r(olic)g(v)
+-5 b(alues)427 3409 y(are)27 b(de\014ned)i(in)g(grf.h:)37
+b(GRF)p Ft(__)p Fi(STYLE)28 b(\(Line)h(st)n(yle\),)f(GRF)p
+Ft(__)p Fi(WIDTH)h(\(Line)f(width\),)i(GRF)p Ft(__)p
+Fi(SIZE)427 3508 y(\(Character)f(and)i(mark)n(er)d(size)j(scale)e
+(factor\),)i(GRF)p Ft(__)p Fi(F)n(ONT)f(\(Character)f(fon)n(t\),)j(GRF)
+p Ft(__)p Fi(COLOUR)427 3608 y(\(Colour)27 b(index\).)340
+3736 y Fh(\017)45 b Fi(v)-5 b(alue)28 b(-)f(A)h(new)g(v)-5
+b(alue)27 b(to)h(store)e(for)h(the)h(attribute.)37 b(If)28
+b(this)g(is)g(AST)p Ft(__)p Fi(BAD)f(no)h(v)-5 b(alue)27
+b(is)h(stored.)340 3864 y Fh(\017)45 b Fi(old)p Ft(_)p
+Fi(v)-5 b(alue)26 b(-)h(A)g(p)r(oin)n(ter)g(to)g(a)f(double)h(in)g
+(whic)n(h)g(to)g(return)f(the)i(attribute)f(v)-5 b(alue.)36
+b(If)28 b(this)f(is)g(NULL,)g(no)427 3964 y(v)-5 b(alue)28
+b(is)f(returned.)340 4092 y Fh(\017)45 b Fi(prim)30 b(-)f(The)g(sort)g
+(of)g(graphics)f(primitiv)n(e)h(to)g(b)r(e)h(dra)n(wn)e(with)i(the)g
+(new)f(attribute.)42 b(Iden)n(ti\014ed)30 b(b)n(y)f(the)427
+4192 y(follo)n(wing)e(v)-5 b(alues)27 b(de\014ned)h(in)g(grf.h:)36
+b(GRF)p Ft(__)p Fi(LINE,)27 b(GRF)p Ft(__)p Fi(MARK,)h(GRF)p
+Ft(__)p Fi(TEXT.)-2 4349 y Fd(BBuf)n(:)227 4495 y Fi(The)21
+b Ft(")p Fi(BBuf)p Ft(")f Fi(function)h(should)g(start)f(a)g(new)g
+(graphics)g(bu\013ering)g(con)n(text.)34 b(A)21 b(matc)n(hing)f(call)h
+(to)f(the)h(function)227 4595 y Ft(")p Fi(EBuf)p Ft(")37
+b Fi(should)h(b)r(e)h(used)f(to)g(end)g(the)g(con)n(text.)68
+b(The)38 b(nature)g(of)g(the)g(bu\013ering)g(is)g(determined)g(b)n(y)g
+(the)227 4695 y(underlying)27 b(graphics)f(system.)227
+4817 y(in)n(t)i(BBuf\()g(AstOb)5 b(ject)28 b Fh(\003)p
+Fi(grfcon)e(\))340 5071 y Fh(\017)45 b Fi(grfcon)27 b(-)g(A)h(KeyMap)f
+(con)n(taining)f(information)h(passed)g(from)g(the)h(calling)f
+(application.)-2 5228 y Fd(Cap)n(:)227 5374 y Fi(The)f
+Ft(")p Fi(Cap)p Ft(")e Fi(function)i(is)g(called)f(to)g(determine)h(if)
+g(the)g(grf)f(mo)r(dule)g(has)g(a)g(giv)n(en)g(capabilit)n(y)-7
+b(,)25 b(as)g(indicated)h(b)n(y)227 5474 y(the)i Ft(")p
+Fi(cap)p Ft(")f Fi(argumen)n(t:)227 5596 y(in)n(t)h(Cap\()g(AstOb)5
+b(ject)27 b Fh(\003)p Fi(grfcon,)g(in)n(t)g(cap,)h(in)n(t)g(v)-5
+b(alue)27 b(\))p eop end
+%%Page: 256 266
+TeXDict begin 256 265 bop 0 52 a FF(256)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Fi(grfcon)27 b(-)g(A)h(KeyMap)f(con)n(taining)f(information)h(passed)
+g(from)g(the)h(calling)f(application.)340 485 y Fh(\017)45
+b Fi(cap)24 b(-)f(The)h(capabilit)n(y)f(b)r(eing)h(inquired)g(ab)r
+(out.)36 b(This)24 b(will)g(b)r(e)g(one)f(of)h(the)h(follo)n(wing)d
+(constan)n(ts)h(de\014ned)427 584 y(in)28 b(grf.h:)227
+747 y(GRF)p Ft(__)p Fi(SCALES:)33 b(This)g(function)h(should)f(return)g
+(a)f(non-zero)g(v)-5 b(alue)33 b(if)h(the)f Ft(")p Fi(Scales)p
+Ft(")f Fi(function)h(is)h(imple-)227 847 y(men)n(ted,)28
+b(and)g(zero)e(otherwise.)36 b(The)28 b(supplied)g Ft(")p
+Fi(v)-5 b(alue)p Ft(")26 b Fi(argumen)n(t)h(should)g(b)r(e)h(ignored.)
+227 972 y(GRF)p Ft(__)p Fi(MJUST:)c(This)g(function)g(should)g(return)f
+(a)h(non-zero)e(v)-5 b(alue)23 b(if)i(the)f Ft(")p Fi(T)-7
+b(ext)p Ft(")23 b Fi(and)h Ft(")p Fi(TxExt)p Ft(")e Fi(functions)227
+1072 y(recognise)35 b Ft(")p Fi(M)p Ft(")i Fi(as)f(a)g(c)n(haracter)f
+(in)i(the)h(justi\014cation)f(string.)64 b(If)37 b(the)h(\014rst)e(c)n
+(haracter)f(of)i(a)f(justi\014cation)227 1171 y(string)d(is)h
+Ft(")p Fi(M)p Ft(")p Fi(,)g(then)g(the)g(text)g(should)f(b)r(e)h
+(justi\014ed)g(with)g(the)g(giv)n(en)f(reference)g(p)r(oin)n(t)g(at)h
+(the)g(b)r(ottom)g(of)227 1271 y(the)f(b)r(ounding)f(b)r(o)n(x.)51
b(This)33 b(is)f(di\013eren)n(t)g(to)h Ft(")p Fi(B)p
Ft(")e Fi(justi\014cation,)j(whic)n(h)e(requests)g(that)g(the)h
-(reference)e(p)r(oin)n(t)227 4039 y(b)r(e)k(put)g(on)f(the)h(baseline)e
+(reference)e(p)r(oin)n(t)227 1370 y(b)r(e)k(put)g(on)f(the)h(baseline)e
(of)i(the)f(text,)j(since)d(some)g(c)n(haracters)e(hang)h(do)n(wn)h(b)r
-(elo)n(w)g(the)h(baseline.)56 b(If)35 b(the)227 4139
+(elo)n(w)g(the)h(baseline.)56 b(If)35 b(the)227 1470
y Ft(")p Fi(T)-7 b(ext)p Ft(")25 b Fi(or)g Ft(")p Fi(TxExt)p
Ft(")g Fi(function)h(cannot)g(di\013eren)n(tiate)g(b)r(et)n(w)n(een)f
Ft(")p Fi(M)p Ft(")h Fi(and)f Ft(")p Fi(B)p Ft(")p Fi(,)h(then)g(this)g
-(function)h(should)227 4239 y(return)f(zero,)f(in)i(whic)n(h)f(case)f
+(function)h(should)227 1570 y(return)f(zero,)f(in)i(whic)n(h)f(case)f
Ft(")p Fi(M)p Ft(")g Fi(justi\014cation)i(will)f(nev)n(er)f(b)r(e)i
(requested)e(b)n(y)h(Plot.)36 b(The)26 b(supplied)h Ft(")p
-Fi(v)-5 b(alue)p Ft(")227 4338 y Fi(argumen)n(t)27 b(should)g(b)r(e)h
-(ignored.)227 4467 y(GRF)p Ft(__)p Fi(ESC:)22 b(This)g(function)h
+Fi(v)-5 b(alue)p Ft(")227 1669 y Fi(argumen)n(t)27 b(should)g(b)r(e)h
+(ignored.)227 1794 y(GRF)p Ft(__)p Fi(ESC:)22 b(This)g(function)h
(should)e(return)h(a)g(non-zero)e(v)-5 b(alue)22 b(if)h(the)f
Ft(")p Fi(T)-7 b(ext)p Ft(")22 b Fi(and)g Ft(")p Fi(TxExt)p
-Ft(")f Fi(functions)h(can)227 4567 y(recognise)f(and)h(in)n(terpret)f
+Ft(")f Fi(functions)h(can)227 1894 y(recognise)f(and)h(in)n(terpret)f
(graphics)g(escap)r(e)g(sequences)h(within)h(the)f(supplied)g(string)g
-(\(see)g(attribute)g(Escap)r(e\).)227 4667 y(Zero)g(should)i(b)r(e)f
+(\(see)g(attribute)g(Escap)r(e\).)227 1994 y(Zero)g(should)i(b)r(e)f
(returned)g(if)h(escap)r(e)f(sequences)g(cannot)g(b)r(e)h(in)n
(terpreted)e(\(in)i(whic)n(h)g(case)e(the)i(Plot)f(class)f(will)227
-4766 y(in)n(terpret)30 b(them)h(itself)g(if)f(needed\).)46
+2093 y(in)n(terpret)30 b(them)h(itself)g(if)f(needed\).)46
b(The)30 b(supplied)g Ft(")p Fi(v)-5 b(alue)p Ft(")30
b Fi(argumen)n(t)f(should)h(b)r(e)h(ignored)e(only)g(if)i(escap)r(e)227
-4866 y(sequences)h(cannot)g(b)r(e)h(in)n(terpreted)g(b)n(y)f
+2193 y(sequences)h(cannot)g(b)r(e)h(in)n(terpreted)g(b)n(y)f
Ft(")p Fi(T)-7 b(ext)p Ft(")32 b Fi(and)h Ft(")p Fi(TxExt)p
Ft(")p Fi(.)50 b(Otherwise,)34 b Ft(")p Fi(v)-5 b(alue)p
-Ft(")31 b Fi(indicates)i(whether)227 4966 y Ft(")p Fi(T)-7
+Ft(")31 b Fi(indicates)i(whether)227 2293 y Ft(")p Fi(T)-7
b(ext)p Ft(")27 b Fi(and)g Ft(")p Fi(TxExt)p Ft(")f Fi(should)h(in)n
(terpret)g(escap)r(e)g(sequences)f(in)i(subsequen)n(t)f(calls.)36
b(If)28 b Ft(")p Fi(v)-5 b(alue)p Ft(")26 b Fi(is)h(non-zero)227
-5065 y(then)j(escap)r(e)f(sequences)g(should)g(b)r(e)h(in)n(terpreted)f
+2392 y(then)j(escap)r(e)f(sequences)g(should)g(b)r(e)h(in)n(terpreted)f
(b)n(y)h Ft(")p Fi(T)-7 b(ext)p Ft(")28 b Fi(and)i Ft(")p
Fi(TxExt)p Ft(")p Fi(.)41 b(Otherwise,)29 b(they)h(should)f(b)r(e)227
-5165 y(dra)n(wn)e(as)g(literal)g(text.)340 5440 y Fh(\017)45
+2492 y(dra)n(wn)e(as)g(literal)g(text.)340 2754 y Fh(\017)45
b Fi(v)-5 b(alue)28 b(-)f(The)h(use)f(of)h(this)g(parameter)e(dep)r
(ends)i(on)f(the)h(v)-5 b(alue)28 b(of)f Ft(")p Fi(cap)p
-Ft(")f Fi(as)h(describ)r(ed)h(ab)r(o)n(v)n(e.)340 5577
+Ft(")f Fi(as)h(describ)r(ed)h(ab)r(o)n(v)n(e.)340 2888
y Fh(\017)45 b Fi(Returned)26 b(F)-7 b(unction)26 b(V)-7
b(alue:)36 b(The)25 b(v)-5 b(alue)25 b(returned)g(b)n(y)h(the)f
(function)h(dep)r(ends)g(on)f(the)h(v)-5 b(alue)25 b(of)h
-Ft(")p Fi(cap)p Ft(")427 5677 y Fi(as)h(describ)r(ed)h(ab)r(o)n(v)n(e.)
+Ft(")p Fi(cap)p Ft(")427 2987 y Fi(as)h(describ)r(ed)h(ab)r(o)n(v)n(e.)
35 b(Zero)26 b(should)i(b)r(e)g(returned)f(if)h(the)g(supplied)g
-(capabilit)n(y)f(is)g(not)h(recognised.)p eop end
-%%Page: 256 266
-TeXDict begin 256 265 bop 0 52 a FF(256)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)-2 351 y Fd(EBuf)n(:)227
-497 y Fi(The)36 b Ft(")p Fi(EBuf)p Ft(")e Fi(function)i(should)f(end)h
+(capabilit)n(y)f(is)g(not)h(recognised.)-2 3150 y Fd(EBuf)n(:)227
+3296 y Fi(The)36 b Ft(")p Fi(EBuf)p Ft(")e Fi(function)i(should)f(end)h
(the)f(curren)n(t)g(graphics)f(bu\013ering)h(con)n(text.)60
-b(See)35 b(the)h(description)f(of)227 597 y Ft(")p Fi(BBuf)p
+b(See)35 b(the)h(description)f(of)227 3396 y Ft(")p Fi(BBuf)p
Ft(")27 b Fi(ab)r(o)n(v)n(e)f(for)i(further)f(details.)37
b(It)28 b(requires)e(the)i(follo)n(wing)e(in)n(terface:)227
-731 y(in)n(t)i(EBuf\()g(AstOb)5 b(ject)28 b Fh(\003)p
-Fi(grfcon)e(\))340 1020 y Fh(\017)45 b Fi(grfcon)27 b(-)g(A)h(KeyMap)f
+3521 y(in)n(t)i(EBuf\()g(AstOb)5 b(ject)28 b Fh(\003)p
+Fi(grfcon)e(\))340 3784 y Fh(\017)45 b Fi(grfcon)27 b(-)g(A)h(KeyMap)f
(con)n(taining)f(information)h(passed)g(from)g(the)h(calling)f
-(application.)-2 1200 y Fd(Flush)n(:)227 1346 y Fi(The)19
+(application.)-2 3947 y Fd(Flush)n(:)227 4093 y Fi(The)19
b Ft(")p Fi(Flush)p Ft(")g Fi(function)g(ensures)f(that)i(the)f(displa)
n(y)f(device)h(is)g(up-to-date,)h(b)n(y)f(\015ushing)g(an)n(y)f(p)r
-(ending)h(graphics)227 1446 y(to)28 b(the)g(output)g(device.)37
+(ending)h(graphics)227 4192 y(to)28 b(the)g(output)g(device.)37
b(It)27 b(requires)g(the)h(follo)n(wing)e(in)n(terface:)227
-1579 y(in)n(t)i(Flush\()g(AstOb)5 b(ject)28 b Fh(\003)p
-Fi(grfcon)e(\))340 1868 y Fh(\017)45 b Fi(grfcon)27 b(-)g(A)h(KeyMap)f
+4317 y(in)n(t)i(Flush\()g(AstOb)5 b(ject)28 b Fh(\003)p
+Fi(grfcon)e(\))340 4580 y Fh(\017)45 b Fi(grfcon)27 b(-)g(A)h(KeyMap)f
(con)n(taining)f(information)h(passed)g(from)g(the)h(calling)f
-(application.)-2 2049 y Fd(Line)n(:)227 2195 y Fi(The)h
+(application.)-2 4743 y Fd(Line)n(:)227 4889 y Fi(The)h
Ft(")p Fi(Line)p Ft(")e Fi(function)i(displa)n(ys)e(lines)i(joining)f
(the)h(giv)n(en)e(p)r(ositions)h(and)g(requires)f(the)i(follo)n(wing)e
-(in)n(terface:)227 2328 y(in)n(t)i(Line\()g(AstOb)5 b(ject)28
+(in)n(terface:)227 5014 y(in)n(t)i(Line\()g(AstOb)5 b(ject)28
b Fh(\003)p Fi(grfcon,)e(in)n(t)i(n,)g(const)f(\015oat)g
Fh(\003)p Fi(x,)g(const)g(\015oat)g Fh(\003)p Fi(y)g(\))340
-2617 y Fh(\017)45 b Fi(grfcon)27 b(-)g(A)h(KeyMap)f(con)n(taining)f
+5277 y Fh(\017)45 b Fi(grfcon)27 b(-)g(A)h(KeyMap)f(con)n(taining)f
(information)h(passed)g(from)g(the)h(calling)f(application.)340
-2759 y Fh(\017)45 b Fi(n)28 b(-)f(The)h(n)n(um)n(b)r(er)f(of)h(p)r
-(ositions)f(to)h(b)r(e)g(joined)f(together.)340 2901
+5410 y Fh(\017)45 b Fi(n)28 b(-)f(The)h(n)n(um)n(b)r(er)f(of)h(p)r
+(ositions)f(to)h(b)r(e)g(joined)f(together.)340 5543
y Fh(\017)45 b Fi(x)28 b(-)f(A)h(p)r(oin)n(ter)f(to)h(an)f(arra)n(y)e
(holding)i(the)h Ft(")p Fi(n)p Ft(")f Fi(x)h(v)-5 b(alues.)340
-3043 y Fh(\017)45 b Fi(y)28 b(-)f(A)h(p)r(oin)n(ter)f(to)h(an)f(arra)n
+5677 y Fh(\017)45 b Fi(y)28 b(-)f(A)h(p)r(oin)n(ter)f(to)h(an)f(arra)n
(y)e(holding)i(the)h Ft(")p Fi(n)p Ft(")f Fi(y)h(v)-5
-b(alues.)-2 3224 y Fd(Mark)n(:)227 3370 y Fi(The)28 b
-Ft(")p Fi(Mark)p Ft(")e Fi(function)i(displa)n(ys)e(mark)n(ers)g(at)h
-(the)h(giv)n(en)f(p)r(ositions.)37 b(It)28 b(requires)e(the)i(follo)n
-(wing)e(in)n(terface:)227 3504 y(in)n(t)i(Mark\()f(AstOb)5
-b(ject)28 b Fh(\003)p Fi(grfcon,)e(in)n(t)i(n,)g(const)f(\015oat)g
-Fh(\003)p Fi(x,)g(const)g(\015oat)g Fh(\003)p Fi(y)-7
-b(,)28 b(in)n(t)f(t)n(yp)r(e)h(\))340 3793 y Fh(\017)45
-b Fi(grfcon)27 b(-)g(A)h(KeyMap)f(con)n(taining)f(information)h(passed)
-g(from)g(the)h(calling)f(application.)340 3935 y Fh(\017)45
-b Fi(n)28 b(-)f(The)h(n)n(um)n(b)r(er)f(of)h(p)r(ositions)f(to)h(b)r(e)
-g(mark)n(ed.)340 4077 y Fh(\017)45 b Fi(x)28 b(-)f(A)h(p)r(oin)n(ter)f
-(to)h(an)f(arra)n(y)e(holding)i(the)h Ft(")p Fi(n)p Ft(")f
-Fi(x)h(v)-5 b(alues.)340 4219 y Fh(\017)45 b Fi(y)28
-b(-)f(A)h(p)r(oin)n(ter)f(to)h(an)f(arra)n(y)e(holding)i(the)h
-Ft(")p Fi(n)p Ft(")f Fi(y)h(v)-5 b(alues.)340 4361 y
-Fh(\017)45 b Fi(t)n(yp)r(e)28 b(-)f(An)h(in)n(teger)f(whic)n(h)h(can)f
-(b)r(e)h(used)f(to)h(indicate)g(the)g(t)n(yp)r(e)f(of)h(mark)n(er)e
-(sym)n(b)r(ol)h(required.)-2 4541 y Fd(Qc)m(h)n(:)227
-4687 y Fi(The)e Ft(")p Fi(Qc)n(h)p Ft(")e Fi(function)j(returns)e(the)h
+b(alues.)p eop end
+%%Page: 257 267
+TeXDict begin 257 266 bop 3643 52 a FF(257)-2 351 y Fd(Mark)n(:)227
+497 y Fi(The)28 b Ft(")p Fi(Mark)p Ft(")e Fi(function)i(displa)n(ys)e
+(mark)n(ers)g(at)h(the)h(giv)n(en)f(p)r(ositions.)37
+b(It)28 b(requires)e(the)i(follo)n(wing)e(in)n(terface:)227
+630 y(in)n(t)i(Mark\()f(AstOb)5 b(ject)28 b Fh(\003)p
+Fi(grfcon,)e(in)n(t)i(n,)g(const)f(\015oat)g Fh(\003)p
+Fi(x,)g(const)g(\015oat)g Fh(\003)p Fi(y)-7 b(,)28 b(in)n(t)f(t)n(yp)r
+(e)h(\))340 916 y Fh(\017)45 b Fi(grfcon)27 b(-)g(A)h(KeyMap)f(con)n
+(taining)f(information)h(passed)g(from)g(the)h(calling)f(application.)
+340 1057 y Fh(\017)45 b Fi(n)28 b(-)f(The)h(n)n(um)n(b)r(er)f(of)h(p)r
+(ositions)f(to)h(b)r(e)g(mark)n(ed.)340 1198 y Fh(\017)45
+b Fi(x)28 b(-)f(A)h(p)r(oin)n(ter)f(to)h(an)f(arra)n(y)e(holding)i(the)
+h Ft(")p Fi(n)p Ft(")f Fi(x)h(v)-5 b(alues.)340 1339
+y Fh(\017)45 b Fi(y)28 b(-)f(A)h(p)r(oin)n(ter)f(to)h(an)f(arra)n(y)e
+(holding)i(the)h Ft(")p Fi(n)p Ft(")f Fi(y)h(v)-5 b(alues.)340
+1480 y Fh(\017)45 b Fi(t)n(yp)r(e)28 b(-)f(An)h(in)n(teger)f(whic)n(h)h
+(can)f(b)r(e)h(used)f(to)h(indicate)g(the)g(t)n(yp)r(e)f(of)h(mark)n
+(er)e(sym)n(b)r(ol)h(required.)-2 1659 y Fd(Qc)m(h)n(:)227
+1805 y Fi(The)e Ft(")p Fi(Qc)n(h)p Ft(")e Fi(function)j(returns)e(the)h
(heigh)n(ts)f(of)h(c)n(haracters)d(dra)n(wn)i(v)n(ertically)f(and)i
-(horizon)n(tally)e(in)i(graphics)227 4787 y(co)r(ordinates.)36
+(horizon)n(tally)e(in)i(graphics)227 1904 y(co)r(ordinates.)36
b(It)28 b(requires)e(the)i(follo)n(wing)e(in)n(terface:)227
-4921 y(in)n(t)i(Qc)n(h\()f(AstOb)5 b(ject)28 b Fh(\003)p
+2037 y(in)n(t)i(Qc)n(h\()f(AstOb)5 b(ject)28 b Fh(\003)p
Fi(grfcon,)e(\015oat)h Fh(\003)p Fi(c)n(h)n(v,)g(\015oat)g
-Fh(\003)p Fi(c)n(hh)g(\))340 5210 y Fh(\017)45 b Fi(grfcon)27
+Fh(\003)p Fi(c)n(hh)g(\))340 2323 y Fh(\017)45 b Fi(grfcon)27
b(-)g(A)h(KeyMap)f(con)n(taining)f(information)h(passed)g(from)g(the)h
-(calling)f(application.)340 5352 y Fh(\017)45 b Fi(c)n(h)n(v)26
+(calling)f(application.)340 2464 y Fh(\017)45 b Fi(c)n(h)n(v)26
b(-)g(A)h(p)r(oin)n(ter)f(to)h(the)g(\015oat)f(whic)n(h)g(is)h(to)f
(receiv)n(e)f(the)i(heigh)n(t)f(of)h(c)n(haracters)d(dra)n(wn)i(with)h
-(a)f(v)n(ertical)427 5451 y(baseline.)37 b(This)27 b(will)h(b)r(e)g(an)
-f(incremen)n(t)h(in)g(the)g(X)g(axis.)340 5593 y Fh(\017)45
+(a)f(v)n(ertical)427 2564 y(baseline.)37 b(This)27 b(will)h(b)r(e)g(an)
+f(incremen)n(t)h(in)g(the)g(X)g(axis.)340 2705 y Fh(\017)45
b Fi(c)n(hh)21 b(-)g(A)g(p)r(oin)n(ter)g(to)g(the)g(\015oat)g(whic)n(h)
g(is)g(to)f(receiv)n(e)g(the)i(heigh)n(t)e(of)h(c)n(haracters)e(dra)n
-(wn)h(with)i(a)e(horizon)n(tal)427 5693 y(baseline.)37
-b(This)27 b(will)h(b)r(e)g(an)f(incremen)n(t)h(in)g(the)g(Y)g(axis.)p
-eop end
-%%Page: 257 267
-TeXDict begin 257 266 bop 3643 52 a FF(257)-2 351 y Fd(Scales)n(:)227
-497 y Fi(The)29 b Ft(")p Fi(Scales)p Ft(")e Fi(function)i(returns)f(t)n
-(w)n(o)f(v)-5 b(alues)28 b(\(one)h(for)f(eac)n(h)f(axis\))h(whic)n(h)h
-(scale)e(incremen)n(ts)h(on)h(the)g(corre-)227 597 y(sp)r(onding)h
-(axis)f(in)n(to)g(a)h Ft(")p Fi(normal)p Ft(")d Fi(co)r(ordinate)i
-(system)g(in)h(whic)n(h:)42 b(1\))29 b(the)h(axes)f(ha)n(v)n(e)g(equal)
-g(scale)g(in)h(terms)227 697 y(of)k(\(for)f(instance\))g(millimetres)g
-(p)r(er)h(unit)g(distance,)g(2\))g(X)f(v)-5 b(alues)33
-b(increase)f(from)h(left)h(to)g(righ)n(t,)g(and)f(3\))g(Y)227
-796 y(v)-5 b(alues)27 b(increase)g(from)g(b)r(ottom)h(to)f(top.)37
-b(It)28 b(requires)f(the)g(follo)n(wing)g(in)n(terface:)227
-920 y(in)n(t)h(Scales\()f(AstOb)5 b(ject)28 b Fh(\003)p
-Fi(grfcon,)e(\015oat)h Fh(\003)p Fi(alpha,)g(\015oat)g
-Fh(\003)p Fi(b)r(eta)g(\))340 1179 y Fh(\017)45 b Fi(grfcon)27
+(wn)h(with)i(a)e(horizon)n(tal)427 2804 y(baseline.)37
+b(This)27 b(will)h(b)r(e)g(an)f(incremen)n(t)h(in)g(the)g(Y)g(axis.)-2
+2983 y Fd(Scales)n(:)227 3129 y Fi(The)h Ft(")p Fi(Scales)p
+Ft(")e Fi(function)i(returns)f(t)n(w)n(o)f(v)-5 b(alues)28
+b(\(one)h(for)f(eac)n(h)f(axis\))h(whic)n(h)h(scale)e(incremen)n(ts)h
+(on)h(the)g(corre-)227 3228 y(sp)r(onding)h(axis)f(in)n(to)g(a)h
+Ft(")p Fi(normal)p Ft(")d Fi(co)r(ordinate)i(system)g(in)h(whic)n(h:)42
+b(1\))29 b(the)h(axes)f(ha)n(v)n(e)g(equal)g(scale)g(in)h(terms)227
+3328 y(of)k(\(for)f(instance\))g(millimetres)g(p)r(er)h(unit)g
+(distance,)g(2\))g(X)f(v)-5 b(alues)33 b(increase)f(from)h(left)h(to)g
+(righ)n(t,)g(and)f(3\))g(Y)227 3428 y(v)-5 b(alues)27
+b(increase)g(from)g(b)r(ottom)h(to)f(top.)37 b(It)28
+b(requires)f(the)g(follo)n(wing)g(in)n(terface:)227 3560
+y(in)n(t)h(Scales\()f(AstOb)5 b(ject)28 b Fh(\003)p Fi(grfcon,)e
+(\015oat)h Fh(\003)p Fi(alpha,)g(\015oat)g Fh(\003)p
+Fi(b)r(eta)g(\))340 3846 y Fh(\017)45 b Fi(grfcon)27
b(-)g(A)h(KeyMap)f(con)n(taining)f(information)h(passed)g(from)g(the)h
-(calling)f(application.)340 1310 y Fh(\017)45 b Fi(alpha)36
+(calling)f(application.)340 3987 y Fh(\017)45 b Fi(alpha)36
b(-)f(A)i(p)r(oin)n(ter)e(to)h(the)h(\015oat)e(whic)n(h)h(is)g(to)g
(receiv)n(e)f(the)h(scale)f(for)h(the)g(X)h(axis)e(\(i.e.)62
-b(Xnorm)36 b(=)427 1409 y(alpha)p Fh(\003)p Fi(Xw)n(orld\).)340
-1541 y Fh(\017)45 b Fi(b)r(eta)38 b(-)g(A)g(p)r(oin)n(ter)g(to)f(the)i
+b(Xnorm)36 b(=)427 4087 y(alpha)p Fh(\003)p Fi(Xw)n(orld\).)340
+4228 y Fh(\017)45 b Fi(b)r(eta)38 b(-)g(A)g(p)r(oin)n(ter)g(to)f(the)i
(\015oat)e(whic)n(h)h(is)g(to)f(receiv)n(e)g(the)h(scale)f(for)h(the)g
-(Y)g(axis)f(\(i.e.)68 b(Ynorm)38 b(=)427 1640 y(b)r(eta)p
-Fh(\003)p Fi(Yw)n(orld\).)-2 1801 y Fd(T)-8 b(ext)n(:)227
-1947 y Fi(The)31 b Ft(")p Fi(T)-7 b(ext)p Ft(")30 b Fi(function)h
+(Y)g(axis)f(\(i.e.)68 b(Ynorm)38 b(=)427 4328 y(b)r(eta)p
+Fh(\003)p Fi(Yw)n(orld\).)-2 4506 y Fd(T)-8 b(ext)n(:)227
+4652 y Fi(The)31 b Ft(")p Fi(T)-7 b(ext)p Ft(")30 b Fi(function)h
(displa)n(ys)e(a)h(c)n(haracter)f(string)h(at)g(a)g(giv)n(en)g(p)r
(osition)g(using)h(a)f(sp)r(eci\014ed)g(justi\014cation)227
-2046 y(and)e(up-v)n(ector.)35 b(It)28 b(requires)e(the)i(follo)n(wing)f
-(in)n(terface:)227 2170 y(in)n(t)f(T)-7 b(ext\()25 b(AstOb)5
+4752 y(and)e(up-v)n(ector.)35 b(It)28 b(requires)e(the)i(follo)n(wing)f
+(in)n(terface:)227 4884 y(in)n(t)f(T)-7 b(ext\()25 b(AstOb)5
b(ject)25 b Fh(\003)p Fi(grfcon,)f(const)h(c)n(har)f
Fh(\003)p Fi(text,)h(\015oat)g(x,)g(\015oat)g(y)-7 b(,)25
b(const)g(c)n(har)f Fh(\003)p Fi(just,)h(\015oat)g(up)n(x,)g(\015oat)g
-(up)n(y)227 2270 y(\))340 2528 y Fh(\017)45 b Fi(grfcon)27
+(up)n(y)227 4984 y(\))340 5270 y Fh(\017)45 b Fi(grfcon)27
b(-)g(A)h(KeyMap)f(con)n(taining)f(information)h(passed)g(from)g(the)h
-(calling)f(application.)340 2659 y Fh(\017)45 b Fi(text)28
+(calling)f(application.)340 5411 y Fh(\017)45 b Fi(text)28
b(-)g(P)n(oin)n(ter)e(to)h(a)g(n)n(ull-terminated)h(c)n(haracter)d
-(string)i(to)g(b)r(e)h(displa)n(y)n(ed.)340 2791 y Fh(\017)45
-b Fi(x)28 b(-)f(The)h(reference)e(x)i(co)r(ordinate.)340
-2922 y Fh(\017)45 b Fi(y)28 b(-)f(The)h(reference)e(y)i(co)r(ordinate.)
-340 3053 y Fh(\017)45 b Fi(just)35 b(-)f(A)h(c)n(haracter)d(string)i
-(whic)n(h)g(sp)r(eci\014es)h(the)f(lo)r(cation)g(within)h(the)g(text)g
-(string)e(whic)n(h)i(is)f(to)g(b)r(e)427 3153 y(placed)22
-b(at)f(the)i(reference)d(p)r(osition)i(giv)n(en)f(b)n(y)h(x)f(and)h(y)
--7 b(.)35 b(The)22 b(\014rst)f(c)n(haracter)f(ma)n(y)h(b)r(e)h('T')g
-(for)f Ft(")p Fi(top)p Ft(")p Fi(,)h('C')427 3252 y(for)j
-Ft(")p Fi(cen)n(tre)p Ft(")p Fi(,)f(or)h('B')g(for)g
-Ft(")p Fi(b)r(ottom)p Ft(")p Fi(,)g(and)g(sp)r(eci\014es)g(the)h(v)n
-(ertical)e(lo)r(cation)h(of)g(the)g(reference)g(p)r(osition.)427
-3352 y(Note,)31 b Ft(")p Fi(b)r(ottom)p Ft(")e Fi(corresp)r(onds)f(to)i
-(the)h(base-line)e(of)h(normal)f(text.)44 b(Some)30 b(c)n(haracters)d
-(\(eg)j Ft(")p Fi(y)p Ft(")p Fi(,)g Ft(")p Fi(g)p Ft(")p
-Fi(,)427 3452 y Ft(")p Fi(p)p Ft(")p Fi(,)35 b(etc\))f(descend)f(b)r
-(elo)n(w)h(the)g(base-line.)54 b(The)33 b(second)g(c)n(haracter)f(ma)n
-(y)h(b)r(e)h('L')f(for)g Ft(")p Fi(left)p Ft(")p Fi(,)i('C')f(for)427
-3551 y Ft(")p Fi(cen)n(tre)p Ft(")p Fi(,)26 b(or)h('R')h(for)f
-Ft(")p Fi(righ)n(t)p Ft(")p Fi(,)f(and)h(sp)r(eci\014es)g(the)h
-(horizon)n(tal)e(lo)r(cation)h(of)g(the)h(reference)f(p)r(osition.)36
-b(If)427 3651 y(the)28 b(string)f(has)g(less)g(than)h(2)f(c)n
-(haracters)f(then)i('C')f(is)h(used)f(for)h(the)g(missing)f(c)n
-(haracters.)340 3782 y Fh(\017)45 b Fi(up)n(x)29 b(-)f(The)g(x)h(comp)r
-(onen)n(t)f(of)g(the)h(up-v)n(ector)e(for)h(the)h(text.)39
-b(If)29 b(necessary)e(the)i(supplied)g(v)-5 b(alue)28
-b(should)427 3882 y(b)r(e)h(negated)f(to)h(ensure)f(that)h(p)r(ositiv)n
-(e)f(v)-5 b(alues)28 b(alw)n(a)n(ys)f(refer)h(to)h(displacemen)n(ts)f
-(from)g(left)h(to)g(righ)n(t)f(on)427 3981 y(the)g(screen.)340
-4113 y Fh(\017)45 b Fi(up)n(y)29 b(-)f(The)g(y)h(comp)r(onen)n(t)f(of)g
-(the)h(up-v)n(ector)e(for)h(the)h(text.)39 b(If)29 b(necessary)e(the)i
-(supplied)g(v)-5 b(alue)28 b(should)427 4212 y(b)r(e)j(negated)f(to)g
-(ensure)f(that)i(p)r(ositiv)n(e)f(v)-5 b(alues)29 b(alw)n(a)n(ys)g
-(refer)g(to)h(displacemen)n(ts)g(from)g(b)r(ottom)g(to)h(top)427
-4312 y(on)d(the)g(screen.)-2 4472 y Fd(TxExt)n(:)227
-4618 y Fi(The)35 b Ft(")p Fi(TxExt)p Ft(")e Fi(function)i(returns)f
-(the)h(corners)e(of)i(a)f(b)r(o)n(x)g(whic)n(h)h(w)n(ould)f(enclose)g
-(the)h(supplied)g(c)n(haracter)227 4718 y(string)25 b(if)i(it)f(w)n
-(ere)f(displa)n(y)n(ed)g(using)g(the)h(T)-7 b(ext)26
-b(function)g(describ)r(ed)g(ab)r(o)n(v)n(e.)35 b(The)26
-b(returned)f(b)r(o)n(x)g(includes)h(an)n(y)227 4817 y(leading)h(or)g
-(trailing)g(spaces.)36 b(It)28 b(requires)e(the)i(follo)n(wing)e(in)n
-(terface:)227 4941 y(in)n(t)31 b(TxExt\()f(AstOb)5 b(ject)31
-b Fh(\003)p Fi(grfcon,)f(const)g(c)n(har)f Fh(\003)p
-Fi(text,)i(\015oat)f(x,)h(\015oat)f(y)-7 b(,)31 b(const)f(c)n(har)g
-Fh(\003)p Fi(just,)h(\015oat)f(up)n(x,)h(\015oat)227
-5041 y(up)n(y)-7 b(,)28 b(\015oat)f Fh(\003)p Fi(xb,)g(\015oat)g
-Fh(\003)p Fi(yb)g(\))340 5299 y Fh(\017)45 b Fi(grfcon)27
-b(-)g(A)h(KeyMap)f(con)n(taining)f(information)h(passed)g(from)g(the)h
-(calling)f(application.)340 5431 y Fh(\017)45 b Fi(text)28
-b(-)g(P)n(oin)n(ter)e(to)h(a)g(n)n(ull-terminated)h(c)n(haracter)d
-(string)i(to)g(b)r(e)h(displa)n(y)n(ed.)340 5562 y Fh(\017)45
+(string)i(to)g(b)r(e)h(displa)n(y)n(ed.)340 5552 y Fh(\017)45
b Fi(x)28 b(-)f(The)h(reference)e(x)i(co)r(ordinate.)340
5693 y Fh(\017)45 b Fi(y)28 b(-)f(The)h(reference)e(y)i(co)r(ordinate.)
p eop end
@@ -116401,4233 +116397,4343 @@ TeXDict begin 258 267 bop 0 52 a FF(258)2049 b Fy(B)91
b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
b Fi(just)35 b(-)f(A)h(c)n(haracter)d(string)i(whic)n(h)g(sp)r
(eci\014es)h(the)f(lo)r(cation)g(within)h(the)g(text)g(string)e(whic)n
-(h)i(is)f(to)g(b)r(e)427 451 y(placed)28 b(at)f(the)h(reference)f(p)r
-(osition)g(giv)n(en)g(b)n(y)g(x)h(and)f(y)-7 b(.)37 b(See)28
-b Ft(")p Fi(T)-7 b(ext)p Ft(")26 b Fi(ab)r(o)n(v)n(e.)340
-589 y Fh(\017)45 b Fi(up)n(x)28 b(-)f(The)h(x)f(comp)r(onen)n(t)h(of)f
-(the)h(up-v)n(ector)e(for)h(the)h(text.)38 b(See)27 b
-Ft(")p Fi(T)-7 b(ext)p Ft(")27 b Fi(ab)r(o)n(v)n(e.)340
-728 y Fh(\017)45 b Fi(up)n(y)28 b(-)f(The)h(y)f(comp)r(onen)n(t)h(of)f
-(the)h(up-v)n(ector)e(for)h(the)h(text.)38 b(See)27 b
-Ft(")p Fi(T)-7 b(ext)p Ft(")27 b Fi(ab)r(o)n(v)n(e.)340
-867 y Fh(\017)45 b Fi(xb)23 b(-)e(An)i(arra)n(y)d(of)i(4)g(elemen)n(ts)
-g(in)h(whic)n(h)f(to)g(return)g(the)g(x)g(co)r(ordinate)f(of)i(eac)n(h)
-e(corner)g(of)h(the)h(b)r(ounding)427 966 y(b)r(o)n(x.)340
-1105 y Fh(\017)45 b Fi(yb)23 b(-)e(An)i(arra)n(y)d(of)i(4)g(elemen)n
-(ts)g(in)h(whic)n(h)f(to)g(return)g(the)g(y)g(co)r(ordinate)f(of)i(eac)
-n(h)e(corner)g(of)h(the)h(b)r(ounding)427 1204 y(b)r(o)n(x.)p
-0 1415 3780 12 v 0 1547 a Fz(astGrid)470 b Fe(Dra)m(w)38
-b(a)g(set)h(of)f(lab)s(elled)g(co)s(ordinate)e(axes)469
-b Fz(astGrid)0 1729 y Fd(Description:)44 b Fi(This)27
-b(function)h(dra)n(ws)d(a)i(complete)g(annotated)f(set)h(of)g(co)r
-(ordinate)e(axes)h(for)h(a)f(Plot)h(with)g(\(option-)227
-1828 y(ally\))34 b(a)g(co)r(ordinate)f(grid)h(sup)r(erimp)r(osed.)57
-b(Details)34 b(of)g(the)h(axes)e(and)h(grid)g(can)g(b)r(e)h(con)n
-(trolled)e(b)n(y)h(setting)227 1928 y(v)-5 b(alues)27
-b(for)h(the)g(v)-5 b(arious)26 b(attributes)h(de\014ned)h(b)n(y)g(the)g
-(Plot)f(class)f(\(q.v.\).)0 2089 y Fd(Synopsis:)121 b
-Ft(void)42 b(astGrid\()e(AstPlot)h Fh(\003)p Ft(this)g(\))0
-2250 y Fd(P)m(arameters:)259 2398 y(this)427 2497 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(Plot.)0 2671 y Fd(Notes:)340 2965 y Fh(\017)45
-b Fi(If)28 b(the)h(supplied)f(Plot)f(is)h(a)f(Plot3D,)g(the)i(axes)d
-(will)i(b)r(e)h(annotated)e(using)g(three)h(2-dimensional)e(Plots,)427
-3064 y(one)i(for)f(eac)n(h)g(2D)g(plane)h(in)g(the)g(3D)f(curren)n(t)g
-(co)r(ordinate)g(system.)37 b(The)27 b(plots)h(will)g(b)r(e)g
-Ft(")p Fi(pasted)p Ft(")e Fi(on)n(to)427 3164 y(3)h(faces)g(of)g(the)h
-(cub)r(oid)f(graphics)f(v)n(olume)h(sp)r(eci\014ed)g(when)h(the)g
+(h)i(is)f(to)g(b)r(e)427 451 y(placed)22 b(at)f(the)i(reference)d(p)r
+(osition)i(giv)n(en)f(b)n(y)h(x)f(and)h(y)-7 b(.)35 b(The)22
+b(\014rst)f(c)n(haracter)f(ma)n(y)h(b)r(e)h('T')g(for)f
+Ft(")p Fi(top)p Ft(")p Fi(,)h('C')427 551 y(for)j Ft(")p
+Fi(cen)n(tre)p Ft(")p Fi(,)f(or)h('B')g(for)g Ft(")p
+Fi(b)r(ottom)p Ft(")p Fi(,)g(and)g(sp)r(eci\014es)g(the)h(v)n(ertical)e
+(lo)r(cation)h(of)g(the)g(reference)g(p)r(osition.)427
+650 y(Note,)31 b Ft(")p Fi(b)r(ottom)p Ft(")e Fi(corresp)r(onds)f(to)i
+(the)h(base-line)e(of)h(normal)f(text.)44 b(Some)30 b(c)n(haracters)d
+(\(eg)j Ft(")p Fi(y)p Ft(")p Fi(,)g Ft(")p Fi(g)p Ft(")p
+Fi(,)427 750 y Ft(")p Fi(p)p Ft(")p Fi(,)35 b(etc\))f(descend)f(b)r
+(elo)n(w)h(the)g(base-line.)54 b(The)33 b(second)g(c)n(haracter)f(ma)n
+(y)h(b)r(e)h('L')f(for)g Ft(")p Fi(left)p Ft(")p Fi(,)i('C')f(for)427
+849 y Ft(")p Fi(cen)n(tre)p Ft(")p Fi(,)26 b(or)h('R')h(for)f
+Ft(")p Fi(righ)n(t)p Ft(")p Fi(,)f(and)h(sp)r(eci\014es)g(the)h
+(horizon)n(tal)e(lo)r(cation)h(of)g(the)h(reference)f(p)r(osition.)36
+b(If)427 949 y(the)28 b(string)f(has)g(less)g(than)h(2)f(c)n(haracters)
+f(then)i('C')f(is)h(used)f(for)h(the)g(missing)f(c)n(haracters.)340
+1089 y Fh(\017)45 b Fi(up)n(x)29 b(-)f(The)g(x)h(comp)r(onen)n(t)f(of)g
+(the)h(up-v)n(ector)e(for)h(the)h(text.)39 b(If)29 b(necessary)e(the)i
+(supplied)g(v)-5 b(alue)28 b(should)427 1189 y(b)r(e)h(negated)f(to)h
+(ensure)f(that)h(p)r(ositiv)n(e)f(v)-5 b(alues)28 b(alw)n(a)n(ys)f
+(refer)h(to)h(displacemen)n(ts)f(from)g(left)h(to)g(righ)n(t)f(on)427
+1289 y(the)g(screen.)340 1429 y Fh(\017)45 b Fi(up)n(y)29
+b(-)f(The)g(y)h(comp)r(onen)n(t)f(of)g(the)h(up-v)n(ector)e(for)h(the)h
+(text.)39 b(If)29 b(necessary)e(the)i(supplied)g(v)-5
+b(alue)28 b(should)427 1528 y(b)r(e)j(negated)f(to)g(ensure)f(that)i(p)
+r(ositiv)n(e)f(v)-5 b(alues)29 b(alw)n(a)n(ys)g(refer)g(to)h
+(displacemen)n(ts)g(from)g(b)r(ottom)g(to)h(top)427 1628
+y(on)d(the)g(screen.)-2 1805 y Fd(TxExt)n(:)227 1951
+y Fi(The)35 b Ft(")p Fi(TxExt)p Ft(")e Fi(function)i(returns)f(the)h
+(corners)e(of)i(a)f(b)r(o)n(x)g(whic)n(h)h(w)n(ould)f(enclose)g(the)h
+(supplied)g(c)n(haracter)227 2051 y(string)25 b(if)i(it)f(w)n(ere)f
+(displa)n(y)n(ed)g(using)g(the)h(T)-7 b(ext)26 b(function)g(describ)r
+(ed)g(ab)r(o)n(v)n(e.)35 b(The)26 b(returned)f(b)r(o)n(x)g(includes)h
+(an)n(y)227 2150 y(leading)h(or)g(trailing)g(spaces.)36
+b(It)28 b(requires)e(the)i(follo)n(wing)e(in)n(terface:)227
+2282 y(in)n(t)31 b(TxExt\()f(AstOb)5 b(ject)31 b Fh(\003)p
+Fi(grfcon,)f(const)g(c)n(har)f Fh(\003)p Fi(text,)i(\015oat)f(x,)h
+(\015oat)f(y)-7 b(,)31 b(const)f(c)n(har)g Fh(\003)p
+Fi(just,)h(\015oat)f(up)n(x,)h(\015oat)227 2382 y(up)n(y)-7
+b(,)28 b(\015oat)f Fh(\003)p Fi(xb,)g(\015oat)g Fh(\003)p
+Fi(yb)g(\))340 2665 y Fh(\017)45 b Fi(grfcon)27 b(-)g(A)h(KeyMap)f(con)
+n(taining)f(information)h(passed)g(from)g(the)h(calling)f(application.)
+340 2805 y Fh(\017)45 b Fi(text)28 b(-)g(P)n(oin)n(ter)e(to)h(a)g(n)n
+(ull-terminated)h(c)n(haracter)d(string)i(to)g(b)r(e)h(displa)n(y)n
+(ed.)340 2946 y Fh(\017)45 b Fi(x)28 b(-)f(The)h(reference)e(x)i(co)r
+(ordinate.)340 3086 y Fh(\017)45 b Fi(y)28 b(-)f(The)h(reference)e(y)i
+(co)r(ordinate.)340 3226 y Fh(\017)45 b Fi(just)35 b(-)f(A)h(c)n
+(haracter)d(string)i(whic)n(h)g(sp)r(eci\014es)h(the)f(lo)r(cation)g
+(within)h(the)g(text)g(string)e(whic)n(h)i(is)f(to)g(b)r(e)427
+3326 y(placed)28 b(at)f(the)h(reference)f(p)r(osition)g(giv)n(en)g(b)n
+(y)g(x)h(and)f(y)-7 b(.)37 b(See)28 b Ft(")p Fi(T)-7
+b(ext)p Ft(")26 b Fi(ab)r(o)n(v)n(e.)340 3466 y Fh(\017)45
+b Fi(up)n(x)28 b(-)f(The)h(x)f(comp)r(onen)n(t)h(of)f(the)h(up-v)n
+(ector)e(for)h(the)h(text.)38 b(See)27 b Ft(")p Fi(T)-7
+b(ext)p Ft(")27 b Fi(ab)r(o)n(v)n(e.)340 3606 y Fh(\017)45
+b Fi(up)n(y)28 b(-)f(The)h(y)f(comp)r(onen)n(t)h(of)f(the)h(up-v)n
+(ector)e(for)h(the)h(text.)38 b(See)27 b Ft(")p Fi(T)-7
+b(ext)p Ft(")27 b Fi(ab)r(o)n(v)n(e.)340 3746 y Fh(\017)45
+b Fi(xb)23 b(-)e(An)i(arra)n(y)d(of)i(4)g(elemen)n(ts)g(in)h(whic)n(h)f
+(to)g(return)g(the)g(x)g(co)r(ordinate)f(of)i(eac)n(h)e(corner)g(of)h
+(the)h(b)r(ounding)427 3846 y(b)r(o)n(x.)340 3986 y Fh(\017)45
+b Fi(yb)23 b(-)e(An)i(arra)n(y)d(of)i(4)g(elemen)n(ts)g(in)h(whic)n(h)f
+(to)g(return)g(the)g(y)g(co)r(ordinate)f(of)i(eac)n(h)e(corner)g(of)h
+(the)h(b)r(ounding)427 4086 y(b)r(o)n(x.)p 0 4300 3780
+12 v 0 4432 a Fz(astGrid)470 b Fe(Dra)m(w)38 b(a)g(set)h(of)f(lab)s
+(elled)g(co)s(ordinate)e(axes)469 b Fz(astGrid)0 4617
+y Fd(Description:)44 b Fi(This)27 b(function)h(dra)n(ws)d(a)i(complete)
+g(annotated)f(set)h(of)g(co)r(ordinate)e(axes)h(for)h(a)f(Plot)h(with)g
+(\(option-)227 4717 y(ally\))34 b(a)g(co)r(ordinate)f(grid)h(sup)r
+(erimp)r(osed.)57 b(Details)34 b(of)g(the)h(axes)e(and)h(grid)g(can)g
+(b)r(e)h(con)n(trolled)e(b)n(y)h(setting)227 4816 y(v)-5
+b(alues)27 b(for)h(the)g(v)-5 b(arious)26 b(attributes)h(de\014ned)h(b)
+n(y)g(the)g(Plot)f(class)f(\(q.v.\).)0 4980 y Fd(Synopsis:)121
+b Ft(void)42 b(astGrid\()e(AstPlot)h Fh(\003)p Ft(this)g(\))0
+5145 y Fd(P)m(arameters:)259 5296 y(this)427 5396 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(Plot.)0 5572 y Fd(Notes:)p eop end
+%%Page: 259 269
+TeXDict begin 259 268 bop 3643 52 a FF(259)340 351 y
+Fh(\017)45 b Fi(If)28 b(the)h(supplied)f(Plot)f(is)h(a)f(Plot3D,)g(the)
+i(axes)d(will)i(b)r(e)h(annotated)e(using)g(three)h(2-dimensional)e
+(Plots,)427 451 y(one)i(for)f(eac)n(h)g(2D)g(plane)h(in)g(the)g(3D)f
+(curren)n(t)g(co)r(ordinate)g(system.)37 b(The)27 b(plots)h(will)g(b)r
+(e)g Ft(")p Fi(pasted)p Ft(")e Fi(on)n(to)427 551 y(3)h(faces)g(of)g
+(the)h(cub)r(oid)f(graphics)f(v)n(olume)h(sp)r(eci\014ed)g(when)h(the)g
(Plot3D)e(w)n(as)g(constructed.)37 b(The)27 b(faces)427
-3263 y(to)h(b)r(e)g(used)f(can)h(b)r(e)g(con)n(trolled)e(b)n(y)h(the)h
-Ft(")p Fi(Ro)r(otCorner)p Ft(")d Fi(attribute.)340 3402
+650 y(to)h(b)r(e)g(used)f(can)h(b)r(e)g(con)n(trolled)e(b)n(y)h(the)h
+Ft(")p Fi(Ro)r(otCorner)p Ft(")d Fi(attribute.)340 810
y Fh(\017)45 b Fi(An)23 b(error)e(results)h(if)i(either)e(the)h(curren)
n(t)f(F)-7 b(rame)22 b(or)g(the)h(base)f(F)-7 b(rame)23
-b(of)f(the)h(Plot)g(is)f(not)h(2-dimensional)427 3502
-y(or)k(\(for)g(a)h(Plot3D\))f(3-dimensional.)340 3640
+b(of)f(the)h(Plot)g(is)f(not)h(2-dimensional)427 909
+y(or)k(\(for)g(a)h(Plot3D\))f(3-dimensional.)340 1069
y Fh(\017)45 b Fi(An)24 b(error)e(also)h(results)g(if)h(the)g
(transformation)e(b)r(et)n(w)n(een)h(the)h(base)f(and)h(curren)n(t)e(F)
--7 b(rames)23 b(of)h(the)g(Plot)f(is)427 3740 y(not)k(de\014ned)g(in)g
+-7 b(rames)23 b(of)h(the)g(Plot)f(is)427 1168 y(not)k(de\014ned)g(in)g
(either)g(direction)g(\(i.e.)37 b(the)27 b(Plot's)f(T)-7
b(ranF)g(orw)n(ard)24 b(or)i(T)-7 b(ranIn)n(v)n(erse)25
-b(attribute)i(is)f(zero\).)p 0 3951 V 0 4082 a Fz(astGridLine)971
-4089 y Fe(Dra)m(w)38 b(a)g(grid)g(line)g(\(or)g(axis\))f(for)h(a)g
-(Plot)3082 4082 y Fz(astGridLine)0 4296 y Fd(Description:)44
-b Fi(This)30 b(function)g(dra)n(ws)f(a)g(curv)n(e)f(in)i(the)g(ph)n
-(ysical)f(co)r(ordinate)g(system)g(of)h(a)f(Plot)g(b)n(y)h(v)-5
-b(arying)28 b(only)227 4396 y(one)j(of)h(the)g(co)r(ordinates)e(along)g
-(the)i(length)f(of)h(the)g(curv)n(e.)47 b(It)32 b(is)f(in)n(tended)h
-(for)f(dra)n(wing)f(co)r(ordinate)g(axes,)227 4495 y(co)r(ordinate)38
-b(grids,)j(and)d(tic)n(k)h(marks)e(on)i(axes)f(\(but)h(note)g(that)g
-(these)g(are)f(also)f(a)n(v)-5 b(ailable)38 b(via)g(the)h(more)227
-4595 y(comprehensiv)n(e)26 b(astGrid)i(function\).)227
-4725 y(The)35 b(curv)n(e)e(is)i(transformed)e(in)n(to)h(graphical)f(co)
-r(ordinate)h(space)f(for)h(plotting,)j(so)c(that)i(a)f(straigh)n(t)g
-(line)g(in)227 4825 y(ph)n(ysical)24 b(co)r(ordinates)f(ma)n(y)g
-(result)h(in)h(a)f(curv)n(ed)g(line)g(b)r(eing)h(dra)n(wn)e(if)i(the)g
-(Mapping)f(in)n(v)n(olv)n(ed)f(is)h(non-linear.)227 4924
-y(An)n(y)j(discon)n(tin)n(uities)f(in)h(the)f(Mapping)h(b)r(et)n(w)n
-(een)f(ph)n(ysical)g(and)g(graphical)f(co)r(ordinates)g(are)g(catered)h
-(for,)g(as)227 5024 y(is)i(an)n(y)f(clipping)g(established)g(using)h
-(astClip.)0 5185 y Fd(Synopsis:)121 b Ft(void)42 b(astGridLine\()c
-(AstPlot)j Fh(\003)p Ft(this,)g(int)h(axis,)g(const)g(double)f
-(start[],)f(double)h(length)227 5285 y(\))0 5445 y Fd(P)m(arameters:)
-259 5593 y(this)427 5693 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)p
-eop end
-%%Page: 259 269
-TeXDict begin 259 268 bop 3643 52 a FF(259)259 351 y
-Fd(axis)427 451 y Fi(The)31 b(index)g(of)f(the)h(Plot)f(axis)g(whose)g
-(ph)n(ysical)g(co)r(ordinate)f(v)-5 b(alue)31 b(is)f(to)h(b)r(e)g(v)-5
-b(aried)30 b(along)f(the)j(length)427 551 y(of)26 b(the)h(curv)n(e)e
-(\(all)h(other)f(co)r(ordinates)g(will)h(remain)f(\014xed\).)37
-b(This)26 b(v)-5 b(alue)26 b(should)g(lie)g(in)g(the)g(range)f(from)427
-650 y(1)i(to)h(the)g(n)n(um)n(b)r(er)f(of)h(Plot)f(axes)f(\(Naxes)i
-(attribute\).)259 788 y Fd(start)427 888 y Fi(An)j(arra)n(y)-7
-b(,)30 b(with)h(one)f(elemen)n(t)h(for)f(eac)n(h)g(axis)g(of)h(the)g
-(Plot,)g(giving)e(the)j(ph)n(ysical)d(co)r(ordinates)h(of)g(the)427
-987 y(start)d(of)h(the)g(curv)n(e.)259 1125 y Fd(length)427
-1225 y Fi(The)c(length)h(of)f(curv)n(e)f(to)h(b)r(e)h(dra)n(wn,)e(giv)n
-(en)h(as)f(an)h(incremen)n(t)g(along)f(the)h(selected)g(ph)n(ysical)g
-(axis.)35 b(This)427 1324 y(ma)n(y)27 b(b)r(e)h(p)r(ositiv)n(e)f(or)g
-(negativ)n(e.)0 1496 y Fd(Notes:)340 1789 y Fh(\017)45
-b Fi(No)28 b(curv)n(e)g(is)g(dra)n(wn)f(if)i(the)f Ft(")p
-Fi(start)p Ft(")f Fi(arra)n(y)f(con)n(tains)h(an)n(y)g(co)r(ordinates)g
-(with)i(the)f(v)-5 b(alue)28 b(AST)p Ft(__)p Fi(BAD,)427
-1888 y(nor)f(if)h Ft(")p Fi(length)p Ft(")f Fi(has)g(this)h(v)-5
-b(alue.)340 2026 y Fh(\017)45 b Fi(An)28 b(error)e(results)h(if)h(the)g
-(base)f(F)-7 b(rame)27 b(of)h(the)g(Plot)f(is)g(not)h(2-dimensional.)
-340 2164 y Fh(\017)45 b Fi(An)30 b(error)d(also)g(results)i(if)g(the)g
+b(attribute)i(is)f(zero\).)p 0 1421 3780 12 v 0 1552
+a Fz(astGridLine)971 1559 y Fe(Dra)m(w)38 b(a)g(grid)g(line)g(\(or)g
+(axis\))f(for)h(a)g(Plot)3082 1552 y Fz(astGridLine)0
+1808 y Fd(Description:)44 b Fi(This)30 b(function)g(dra)n(ws)f(a)g
+(curv)n(e)f(in)i(the)g(ph)n(ysical)f(co)r(ordinate)g(system)g(of)h(a)f
+(Plot)g(b)n(y)h(v)-5 b(arying)28 b(only)227 1907 y(one)j(of)h(the)g(co)
+r(ordinates)e(along)g(the)i(length)f(of)h(the)g(curv)n(e.)47
+b(It)32 b(is)f(in)n(tended)h(for)f(dra)n(wing)f(co)r(ordinate)g(axes,)
+227 2007 y(co)r(ordinate)38 b(grids,)j(and)d(tic)n(k)h(marks)e(on)i
+(axes)f(\(but)h(note)g(that)g(these)g(are)f(also)f(a)n(v)-5
+b(ailable)38 b(via)g(the)h(more)227 2107 y(comprehensiv)n(e)26
+b(astGrid)i(function\).)227 2258 y(The)35 b(curv)n(e)e(is)i
+(transformed)e(in)n(to)h(graphical)f(co)r(ordinate)h(space)f(for)h
+(plotting,)j(so)c(that)i(a)f(straigh)n(t)g(line)g(in)227
+2357 y(ph)n(ysical)24 b(co)r(ordinates)f(ma)n(y)g(result)h(in)h(a)f
+(curv)n(ed)g(line)g(b)r(eing)h(dra)n(wn)e(if)i(the)g(Mapping)f(in)n(v)n
+(olv)n(ed)f(is)h(non-linear.)227 2457 y(An)n(y)j(discon)n(tin)n(uities)
+f(in)h(the)f(Mapping)h(b)r(et)n(w)n(een)f(ph)n(ysical)g(and)g
+(graphical)f(co)r(ordinates)g(are)g(catered)h(for,)g(as)227
+2557 y(is)i(an)n(y)f(clipping)g(established)g(using)h(astClip.)0
+2759 y Fd(Synopsis:)121 b Ft(void)42 b(astGridLine\()c(AstPlot)j
+Fh(\003)p Ft(this,)g(int)h(axis,)g(const)g(double)f(start[],)f(double)h
+(length)227 2859 y(\))0 3062 y Fd(P)m(arameters:)259
+3251 y(this)427 3351 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259
+3510 y Fd(axis)427 3610 y Fi(The)j(index)g(of)f(the)h(Plot)f(axis)g
+(whose)g(ph)n(ysical)g(co)r(ordinate)f(v)-5 b(alue)31
+b(is)f(to)h(b)r(e)g(v)-5 b(aried)30 b(along)f(the)j(length)427
+3710 y(of)26 b(the)h(curv)n(e)e(\(all)h(other)f(co)r(ordinates)g(will)h
+(remain)f(\014xed\).)37 b(This)26 b(v)-5 b(alue)26 b(should)g(lie)g(in)
+g(the)g(range)f(from)427 3809 y(1)i(to)h(the)g(n)n(um)n(b)r(er)f(of)h
+(Plot)f(axes)f(\(Naxes)i(attribute\).)259 3969 y Fd(start)427
+4068 y Fi(An)j(arra)n(y)-7 b(,)30 b(with)h(one)f(elemen)n(t)h(for)f
+(eac)n(h)g(axis)g(of)h(the)g(Plot,)g(giving)e(the)j(ph)n(ysical)d(co)r
+(ordinates)h(of)g(the)427 4168 y(start)d(of)h(the)g(curv)n(e.)259
+4328 y Fd(length)427 4427 y Fi(The)c(length)h(of)f(curv)n(e)f(to)h(b)r
+(e)h(dra)n(wn,)e(giv)n(en)h(as)f(an)h(incremen)n(t)g(along)f(the)h
+(selected)g(ph)n(ysical)g(axis.)35 b(This)427 4527 y(ma)n(y)27
+b(b)r(e)h(p)r(ositiv)n(e)f(or)g(negativ)n(e.)0 4742 y
+Fd(Notes:)340 5078 y Fh(\017)45 b Fi(No)28 b(curv)n(e)g(is)g(dra)n(wn)f
+(if)i(the)f Ft(")p Fi(start)p Ft(")f Fi(arra)n(y)f(con)n(tains)h(an)n
+(y)g(co)r(ordinates)g(with)i(the)f(v)-5 b(alue)28 b(AST)p
+Ft(__)p Fi(BAD,)427 5177 y(nor)f(if)h Ft(")p Fi(length)p
+Ft(")f Fi(has)g(this)h(v)-5 b(alue.)340 5337 y Fh(\017)45
+b Fi(An)28 b(error)e(results)h(if)h(the)g(base)f(F)-7
+b(rame)27 b(of)h(the)g(Plot)f(is)g(not)h(2-dimensional.)340
+5496 y Fh(\017)45 b Fi(An)30 b(error)d(also)g(results)i(if)g(the)g
(transformation)f(b)r(et)n(w)n(een)h(the)g(curren)n(t)f(and)h(base)f(F)
--7 b(rames)28 b(of)h(the)g(Plot)427 2263 y(is)f(not)f(de\014ned)h
+-7 b(rames)28 b(of)h(the)g(Plot)427 5596 y(is)f(not)f(de\014ned)h
(\(i.e.)38 b(the)28 b(Plot's)e(T)-7 b(ranIn)n(v)n(erse)26
-b(attribute)h(is)h(zero\).)p 0 2473 3780 12 v 0 2604
-a Fz(astGrismMap)1380 2603 y Fe(Create)37 b(a)i(GrismMap)2978
-2604 y Fz(astGrismMap)0 2803 y Fd(Description:)44 b Fi(This)28
+b(attribute)h(is)h(zero\).)p eop end
+%%Page: 260 270
+TeXDict begin 260 269 bop 0 52 a FF(260)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 483 a Fz(astGrismMap)1380 482 y Fe(Create)37 b(a)i(GrismMap)2978
+483 y Fz(astGrismMap)0 675 y Fd(Description:)44 b Fi(This)28
b(function)g(creates)f(a)g(new)g(GrismMap)g(and)h(optionally)f
-(initialises)g(its)h(attributes.)227 2933 y(A)j(GrismMap)g(is)f(a)h(sp)
-r(ecialised)f(form)h(of)f(Mapping)h(whic)n(h)g(transforms)e
-(1-dimensional)h(co)r(ordinates)f(using)227 3032 y(the)39
+(initialises)g(its)h(attributes.)227 801 y(A)j(GrismMap)g(is)f(a)h(sp)r
+(ecialised)f(form)h(of)f(Mapping)h(whic)n(h)g(transforms)e
+(1-dimensional)h(co)r(ordinates)f(using)227 901 y(the)39
b(sp)r(ectral)f(disp)r(ersion)g(equation)f(describ)r(ed)i(in)f(FITS-W)n
(CS)h(pap)r(er)f(I)r(I)r(I)h Ft(")p Fi(Represen)n(tation)e(of)h(sp)r
-(ectral)227 3132 y(co)r(ordinates)26 b(in)i(FITS)p Ft(")p
+(ectral)227 1000 y(co)r(ordinates)26 b(in)i(FITS)p Ft(")p
Fi(.)37 b(This)28 b(describ)r(es)f(the)h(disp)r(ersion)f(pro)r(duced)g
-(b)n(y)g(gratings,)f(prisms)h(and)h(grisms.)227 3261
+(b)n(y)g(gratings,)f(prisms)h(and)h(grisms.)227 1126
y(When)23 b(initially)f(created,)g(the)h(forw)n(ard)d(transformation)g
(of)i(a)g(GrismMap)f(transforms)g(input)h Ft(")p Fi(grism)f(param-)227
-3361 y(eter)p Ft(")k Fi(v)-5 b(alues)24 b(in)n(to)h(output)h(w)n(a)n(v)
+1226 y(eter)p Ft(")k Fi(v)-5 b(alues)24 b(in)n(to)h(output)h(w)n(a)n(v)
n(elength)d(v)-5 b(alues.)36 b(The)25 b Ft(")p Fi(grism)f(parameter)p
Ft(")f Fi(is)i(a)g(dimensionless)g(v)-5 b(alue)25 b(whic)n(h)227
-3461 y(is)30 b(linearly)e(related)h(to)g(p)r(osition)h(on)f(the)h
+1325 y(is)30 b(linearly)e(related)h(to)g(p)r(osition)h(on)f(the)h
(detector.)42 b(It)30 b(is)f(de\014ned)h(in)g(FITS-W)n(CS)f(pap)r(er)g
-(I)r(I)r(I)h(as)f Ft(")p Fi(the)h(o\013set)227 3560 y(on)25
+(I)r(I)r(I)h(as)f Ft(")p Fi(the)h(o\013set)227 1425 y(on)25
b(the)g(detector)f(from)h(the)g(p)r(oin)n(t)g(of)g(in)n(tersection)f
(of)h(the)g(camera)f(axis,)g(measured)g(in)h(units)h(of)e(the)i
-(e\013ectiv)n(e)227 3660 y(lo)r(cal)f(length)p Ft(")p
+(e\013ectiv)n(e)227 1525 y(lo)r(cal)f(length)p Ft(")p
Fi(.)36 b(The)25 b(units)h(in)f(whic)n(h)g(w)n(a)n(v)n(elength)f(v)-5
b(alues)25 b(are)f(exp)r(ected)i(or)e(returned)h(is)g(determined)g(b)n
-(y)g(the)227 3759 y(v)-5 b(alues)29 b(supplied)h(for)f(the)g(GrismW)-7
+(y)g(the)227 1624 y(v)-5 b(alues)29 b(supplied)h(for)f(the)g(GrismW)-7
b(a)n(v)n(eR,)29 b(GrismNRP)g(and)g(GrismG)g(attribute:)40
-b(whatev)n(er)29 b(units)g(are)g(used)227 3859 y(for)e(these)h
+b(whatev)n(er)29 b(units)g(are)g(used)227 1724 y(for)e(these)h
(attributes)f(will)h(also)f(b)r(e)h(used)f(for)g(the)h(w)n(a)n(v)n
-(elength)e(v)-5 b(alues.)0 4018 y Fd(Synopsis:)121 b
+(elength)e(v)-5 b(alues.)0 1876 y Fd(Synopsis:)121 b
Ft(AstGrismMap)39 b Fh(\003)p Ft(astGrismMap\()f(const)k(char)f
-Fh(\003)p Ft(options,)f(...)86 b(\))0 4178 y Fd(P)m(arameters:)259
-4324 y(options)427 4424 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n
+Fh(\003)p Ft(options,)f(...)86 b(\))0 2029 y Fd(P)m(arameters:)259
+2168 y(options)427 2268 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n
(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 4523 y(assignmen)n(ts)j
+(comma-separated)e(list)i(of)g(attribute)427 2368 y(assignmen)n(ts)j
(to)i(b)r(e)f(used)h(for)f(initialising)g(the)h(new)f(GrismMap.)51
b(The)32 b(syn)n(tax)g(used)g(is)h(iden)n(tical)f(to)427
-4623 y(that)38 b(for)e(the)i(astSet)f(function)h(and)f(ma)n(y)f
+2467 y(that)38 b(for)e(the)i(astSet)f(function)h(and)f(ma)n(y)f
(include)i Ft(")p Fi(prin)n(tf)p Ft(")e Fi(format)h(sp)r(eci\014ers)g
(iden)n(ti\014ed)g(b)n(y)g Ft(")p Fi(\045)p Ft(")427
-4723 y Fi(sym)n(b)r(ols)27 b(in)h(the)g(normal)f(w)n(a)n(y)-7
-b(.)259 4861 y Fd(...)427 4960 y Fi(If)38 b(the)g Ft(")p
+2567 y Fi(sym)n(b)r(ols)27 b(in)h(the)g(normal)f(w)n(a)n(y)-7
+b(.)259 2701 y Fd(...)427 2801 y Fi(If)38 b(the)g Ft(")p
Fi(options)p Ft(")e Fi(string)h(con)n(tains)f Ft(")p
Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g
-(list)h(of)f(additional)427 5060 y(argumen)n(ts)26 b(ma)n(y)h(follo)n
+(list)h(of)f(additional)427 2901 y(argumen)n(ts)26 b(ma)n(y)h(follo)n
(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5 b(alues)27
b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)37
-b(The)427 5159 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+b(The)427 3000 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 5259 y Fi(function\).)0
-5431 y Fd(Returned)32 b(V)-8 b(alue:)259 5577 y(astGrismMap\(\))427
-5677 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(GrismMap.)p
-eop end
-%%Page: 260 270
-TeXDict begin 260 269 bop 0 52 a FF(260)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Notes:)340
-641 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
-b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g
-(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427
-740 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
-(for)f(an)n(y)g(reason.)p 0 946 3780 12 v 0 1078 a Fz(astHasA)l
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 3100 y Fi(function\).)0
+3265 y Fd(Returned)32 b(V)-8 b(alue:)259 3404 y(astGrismMap\(\))427
+3504 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(GrismMap.)0
+3669 y Fd(Notes:)340 3954 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
+(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
+427 4054 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 4256 V 0 4388 a Fz(astHasA)l
(ttribute)160 b Fe(T)-10 b(est)39 b(if)f(an)h(Ob)7 b(ject)38
-b(has)g(a)h(named)1662 1193 y(attribute)2827 1078 y Fz(astHasA)l
-(ttribute)0 1370 y Fd(Description:)44 b Fi(This)32 b(function)h
+b(has)g(a)h(named)1662 4503 y(attribute)2827 4388 y Fz(astHasA)l
+(ttribute)0 4676 y Fd(Description:)44 b Fi(This)32 b(function)h
(returns)e(a)g(b)r(o)r(olean)h(result)f(\(0)h(or)f(1\))h(to)g(indicate)
-f(whether)h(the)h(supplied)f(Ob)5 b(ject)227 1469 y(has)27
-b(an)h(attribute)f(with)i(the)e(supplied)h(name.)0 1626
+f(whether)h(the)h(supplied)f(Ob)5 b(ject)227 4775 y(has)27
+b(an)h(attribute)f(with)i(the)e(supplied)h(name.)0 4928
y Fd(Synopsis:)121 b Ft(int)42 b(astHasAttribute\()37
b(AstObject)j Fh(\003)p Ft(this,)h(const)h(char)g Fh(\003)p
-Ft(attrib)e(\))0 1782 y Fd(P)m(arameters:)259 1925 y(this)427
-2025 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f(Ob)5
-b(ject.)259 2161 y Fd(attrib)427 2261 y Fi(P)n(oin)n(ter)26
+Ft(attrib)e(\))0 5080 y Fd(P)m(arameters:)259 5220 y(this)427
+5320 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f(Ob)5
+b(ject.)259 5454 y Fd(attrib)427 5554 y Fi(P)n(oin)n(ter)26
b(to)i(a)f(string)g(holding)g(the)h(name)f(of)h(the)g(attribute)g(to)f
-(b)r(e)h(tested.)0 2430 y Fd(Class)j(Applicabilit)m(y:)259
-2573 y(Ob)5 b(ject)427 2673 y Fi(This)28 b(function)g(applies)f(to)h
-(all)f(Ob)5 b(jects.)0 2841 y Fd(Returned)32 b(V)-8 b(alue:)259
-2985 y(astHasA)m(ttribute\(\))427 3084 y Fi(One)28 b(if)g(the)g(Ob)5
+(b)r(e)h(tested.)0 5718 y Fd(Class)j(Applicabilit)m(y:)p
+eop end
+%%Page: 261 271
+TeXDict begin 261 270 bop 3643 52 a FF(261)259 351 y
+Fd(Ob)5 b(ject)427 451 y Fi(This)28 b(function)g(applies)f(to)h(all)f
+(Ob)5 b(jects.)0 620 y Fd(Returned)32 b(V)-8 b(alue:)259
+764 y(astHasA)m(ttribute\(\))427 864 y Fi(One)28 b(if)g(the)g(Ob)5
b(ject)27 b(has)g(the)h(named)g(attribute,)f(otherwise)g(zero.)0
-3253 y Fd(Notes:)340 3543 y Fh(\017)45 b Fi(A)29 b(v)-5
+1033 y Fd(Notes:)340 1323 y Fh(\017)45 b Fi(A)29 b(v)-5
b(alue)29 b(of)f(zero)g(will)h(b)r(e)g(returned)f(if)h(this)g(function)
g(is)f(in)n(v)n(ok)n(ed)f(with)j(the)f(AST)g(error)d(status)j(set,)f
-(or)427 3642 y(if)g(it)g(should)g(fail)f(for)h(an)n(y)e(reason.)p
-0 3848 V 0 3980 a Fz(astHasColumn)296 b Fe(Returns)39
-b(a)f(\015ag)g(indicating)f(if)h(a)1164 4095 y(column)g(is)g(presen)m
-(t)h(in)f(a)h(T)-10 b(able)2922 3980 y Fz(astHasColumn)0
-4290 y Fd(Description:)44 b Fi(This)29 b(function)g(returns)f(a)g
+(or)427 1423 y(if)g(it)g(should)g(fail)f(for)h(an)n(y)e(reason.)p
+0 1629 3780 12 v 0 1761 a Fz(astHasColumn)296 b Fe(Returns)39
+b(a)f(\015ag)g(indicating)f(if)h(a)1164 1875 y(column)g(is)g(presen)m
+(t)h(in)f(a)h(T)-10 b(able)2922 1761 y Fz(astHasColumn)0
+2072 y Fd(Description:)44 b Fi(This)29 b(function)g(returns)f(a)g
(\015ag)g(indicating)h(if)g(a)f(named)h(column)f(exists)h(in)g(a)f(T)-7
-b(able,)29 b(for)f(instance,)227 4390 y(b)n(y)g(ha)n(ving)e(b)r(een)i
+b(able,)29 b(for)f(instance,)227 2171 y(b)n(y)g(ha)n(ving)e(b)r(een)i
(added)g(to)f(to)h(the)g(T)-7 b(able)27 b(using)g(astAddColumn.)0
-4546 y Fd(Synopsis:)121 b Ft(int)42 b(astHasColumn\()c(AstTable)j
+2328 y Fd(Synopsis:)121 b Ft(int)42 b(astHasColumn\()c(AstTable)j
Fh(\003)p Ft(this,)g(const)g(char)h Fh(\003)p Ft(column)f(\))0
-4703 y Fd(P)m(arameters:)259 4846 y(this)427 4946 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(T)-7 b(able.)259 5082 y Fd(column)427 5182
+2485 y Fd(P)m(arameters:)259 2629 y(this)427 2728 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(T)-7 b(able.)259 2865 y Fd(column)427 2965
y Fi(The)22 b(c)n(haracter)d(string)i(holding)g(the)h(upp)r(er)g(case)f
(name)g(of)g(the)h(column.)35 b(T)-7 b(railing)21 b(spaces)f(are)h
-(ignored.)0 5350 y Fd(Notes:)340 5640 y Fh(\017)45 b
+(ignored.)0 3134 y Fd(Notes:)340 3424 y Fh(\017)45 b
Fi(A)28 b(v)-5 b(alue)28 b(of)f(zero)g(is)g(returned)g(for)g(if)i(an)e
-(error)f(o)r(ccurs.)p eop end
-%%Page: 261 271
-TeXDict begin 261 270 bop 3643 52 a FF(261)p 0 351 3780
-12 v 0 482 a Fz(astHasP)l(arameter)1201 483 y Fe(Returns)38
-b(a)h(\015ag)f(indicating)e(if)1162 598 y(a)i(named)g(global)e
-(parameter)g(is)1428 712 y(presen)m(t)i(in)g(a)h(T)-10
-b(able)2769 482 y Fz(astHasP)l(arameter)0 898 y Fd(Description:)44
-b Fi(This)22 b(function)g(returns)f(a)g(\015ag)f(indicating)i(if)g(a)f
-(named)g(parameter)f(exists)i(in)f(a)g(T)-7 b(able,)23
-b(for)e(instance,)227 997 y(b)n(y)28 b(ha)n(ving)e(b)r(een)i(added)g
-(to)f(to)h(the)g(T)-7 b(able)27 b(using)g(astAddP)n(arameter.)0
-1145 y Fd(Synopsis:)121 b Ft(int)42 b(astHasParameter\()37
-b(AstTable)j Fh(\003)p Ft(this,)h(const)h(char)g Fh(\003)p
-Ft(parameter)d(\))0 1293 y Fd(P)m(arameters:)259 1428
-y(this)427 1527 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(T)-7
-b(able.)259 1659 y Fd(parameter)427 1758 y Fi(The)39
-b(c)n(haracter)e(string)h(holding)g(the)h(upp)r(er)g(case)f(name)g(of)h
-(the)g(parameter.)68 b(T)-7 b(railing)38 b(spaces)g(are)427
-1858 y(ignored.)0 2018 y Fd(Notes:)340 2299 y Fh(\017)45
-b Fi(A)28 b(v)-5 b(alue)28 b(of)f(zero)g(is)g(returned)g(for)g(if)i(an)
-e(error)f(o)r(ccurs.)p 0 2495 V 0 2626 a Fz(astImp)t(ort)859
-2627 y Fe(Imp)s(ort)38 b(an)g(Ob)7 b(ject)38 b(p)s(oin)m(ter)f(to)h
-(the)h(curren)m(t)1701 2726 y(con)m(text)3194 2626 y
-Fz(astImp)t(ort)0 2889 y Fd(Description:)44 b Fi(This)20
-b(function)g(imp)r(orts)g(an)f(Ob)5 b(ject)19 b(p)r(oin)n(ter)h(that)g
-(w)n(as)e(created)h(in)h(a)f(higher)g(or)g(lo)n(w)n(er)f(lev)n(el)h
-(con)n(text,)227 2988 y(in)n(to)36 b(the)h(curren)n(t)f(AST)h(con)n
-(text.)63 b(This)36 b(means)g(that)h(the)g(p)r(oin)n(ter)f(will)h(b)r
-(e)g(ann)n(ulled)f(when)h(the)f(curren)n(t)227 3088 y(con)n(text)27
-b(is)h(ended)g(\(with)g(astEnd\).)0 3236 y Fd(Synopsis:)121
-b Ft(void)42 b(astImport\()d(AstObject)h Fh(\003)p Ft(this)i(\))0
-3384 y Fd(P)m(arameters:)259 3518 y(this)427 3618 y Fi(Ob)5
-b(ject)28 b(p)r(oin)n(ter)f(to)g(b)r(e)h(imp)r(orted.)0
-3778 y Fd(Class)j(Applicabilit)m(y:)259 3913 y(Ob)5 b(ject)427
-4013 y Fi(This)28 b(function)g(applies)f(to)h(all)f(Ob)5
-b(jects.)p 0 4209 V 0 4340 a Fz(astIn)l(tersect)910 4341
-y Fe(Find)39 b(the)f(p)s(oin)m(t)g(of)g(in)m(tersection)f(b)s(et)m(w)m
-(een)1390 4455 y(t)m(w)m(o)g(geo)s(desic)h(curv)m(es)3093
-4340 y Fz(astIn)l(tersect)0 4641 y Fd(Description:)44
+(error)f(o)r(ccurs.)p 0 3631 V 0 3761 a Fz(astHasP)l(arameter)1201
+3762 y Fe(Returns)38 b(a)h(\015ag)f(indicating)e(if)1162
+3877 y(a)i(named)g(global)e(parameter)g(is)1428 3991
+y(presen)m(t)i(in)g(a)h(T)-10 b(able)2769 3761 y Fz(astHasP)l(arameter)
+0 4188 y Fd(Description:)44 b Fi(This)22 b(function)g(returns)f(a)g
+(\015ag)f(indicating)i(if)g(a)f(named)g(parameter)f(exists)i(in)f(a)g
+(T)-7 b(able,)23 b(for)e(instance,)227 4287 y(b)n(y)28
+b(ha)n(ving)e(b)r(een)i(added)g(to)f(to)h(the)g(T)-7
+b(able)27 b(using)g(astAddP)n(arameter.)0 4444 y Fd(Synopsis:)121
+b Ft(int)42 b(astHasParameter\()37 b(AstTable)j Fh(\003)p
+Ft(this,)h(const)h(char)g Fh(\003)p Ft(parameter)d(\))0
+4601 y Fd(P)m(arameters:)259 4745 y(this)427 4844 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(T)-7 b(able.)259 4981 y Fd(parameter)427
+5081 y Fi(The)39 b(c)n(haracter)e(string)h(holding)g(the)h(upp)r(er)g
+(case)f(name)g(of)h(the)g(parameter.)68 b(T)-7 b(railing)38
+b(spaces)g(are)427 5180 y(ignored.)0 5350 y Fd(Notes:)340
+5639 y Fh(\017)45 b Fi(A)28 b(v)-5 b(alue)28 b(of)f(zero)g(is)g
+(returned)g(for)g(if)i(an)e(error)f(o)r(ccurs.)p eop
+end
+%%Page: 262 272
+TeXDict begin 262 271 bop 0 52 a FF(262)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 482 a Fz(astImp)t(ort)859 483 y Fe(Imp)s(ort)38 b(an)g(Ob)7
+b(ject)38 b(p)s(oin)m(ter)f(to)h(the)h(curren)m(t)1701
+583 y(con)m(text)3194 482 y Fz(astImp)t(ort)0 746 y Fd(Description:)44
+b Fi(This)20 b(function)g(imp)r(orts)g(an)f(Ob)5 b(ject)19
+b(p)r(oin)n(ter)h(that)g(w)n(as)e(created)h(in)h(a)f(higher)g(or)g(lo)n
+(w)n(er)f(lev)n(el)h(con)n(text,)227 846 y(in)n(to)36
+b(the)h(curren)n(t)f(AST)h(con)n(text.)63 b(This)36 b(means)g(that)h
+(the)g(p)r(oin)n(ter)f(will)h(b)r(e)g(ann)n(ulled)f(when)h(the)f
+(curren)n(t)227 945 y(con)n(text)27 b(is)h(ended)g(\(with)g(astEnd\).)0
+1094 y Fd(Synopsis:)121 b Ft(void)42 b(astImport\()d(AstObject)h
+Fh(\003)p Ft(this)i(\))0 1242 y Fd(P)m(arameters:)259
+1377 y(this)427 1477 y Fi(Ob)5 b(ject)28 b(p)r(oin)n(ter)f(to)g(b)r(e)h
+(imp)r(orted.)0 1638 y Fd(Class)j(Applicabilit)m(y:)259
+1773 y(Ob)5 b(ject)427 1873 y Fi(This)28 b(function)g(applies)f(to)h
+(all)f(Ob)5 b(jects.)p 0 2070 V 0 2201 a Fz(astIn)l(tersect)910
+2202 y Fe(Find)39 b(the)f(p)s(oin)m(t)g(of)g(in)m(tersection)f(b)s(et)m
+(w)m(een)1390 2316 y(t)m(w)m(o)g(geo)s(desic)h(curv)m(es)3093
+2201 y Fz(astIn)l(tersect)0 2503 y Fd(Description:)44
b Fi(This)23 b(function)h(\014nds)f(the)g(co)r(ordinate)e(v)-5
b(alues)23 b(at)g(the)g(p)r(oin)n(t)g(of)g(in)n(tersection)f(b)r(et)n
-(w)n(een)h(t)n(w)n(o)f(geo)r(desic)227 4740 y(curv)n(es.)35
+(w)n(een)h(t)n(w)n(o)f(geo)r(desic)227 2603 y(curv)n(es.)35
b(Eac)n(h)25 b(curv)n(e)g(is)g(sp)r(eci\014ed)h(b)n(y)g(t)n(w)n(o)f(p)r
(oin)n(ts)g(on)h(the)g(curv)n(e.)35 b(It)26 b(can)g(only)f(b)r(e)h
-(used)g(with)g(2-dimensional)227 4840 y(F)-7 b(rames.)227
-4964 y(F)g(or)24 b(example,)h(in)g(a)f(basic)g(F)-7 b(rame,)25
+(used)g(with)g(2-dimensional)227 2702 y(F)-7 b(rames.)227
+2826 y(F)g(or)24 b(example,)h(in)g(a)f(basic)g(F)-7 b(rame,)25
b(it)g(will)g(\014nd)g(the)g(p)r(oin)n(t)g(of)g(in)n(tersection)e(b)r
(et)n(w)n(een)i(t)n(w)n(o)f(straigh)n(t)f(lines.)36 b(But)227
-5063 y(for)27 b(a)h(SkyF)-7 b(rame)26 b(it)i(will)g(\014nd)g(an)g(in)n
-(tersection)e(of)i(t)n(w)n(o)f(great)f(circles.)0 5211
+2926 y(for)27 b(a)h(SkyF)-7 b(rame)26 b(it)i(will)g(\014nd)g(an)g(in)n
+(tersection)e(of)i(t)n(w)n(o)f(great)f(circles.)0 3074
y Fd(Synopsis:)121 b Ft(void)42 b(astIntersect\()c(AstFrame)i
Fh(\003)p Ft(this,)h(const)h(double)f(a1[2],)g(const)h(double)f(a2[2],)
-g(const)227 5311 y(double)g(b1[2],)g(const)h(double)f(b2[2],)g(double)g
-(cross[2])g(\))0 5459 y Fd(P)m(arameters:)259 5593 y(this)427
-5693 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7 b(rame.)p
-eop end
-%%Page: 262 272
-TeXDict begin 262 271 bop 0 52 a FF(262)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(a1)427
-451 y Fi(An)35 b(arra)n(y)d(of)i(double,)j(with)d(one)g(elemen)n(t)h
+g(const)227 3174 y(double)g(b1[2],)g(const)h(double)f(b2[2],)g(double)g
+(cross[2])g(\))0 3322 y Fd(P)m(arameters:)259 3458 y(this)427
+3557 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7 b(rame.)259
+3689 y Fd(a1)427 3789 y Fi(An)35 b(arra)n(y)d(of)i(double,)j(with)d
+(one)g(elemen)n(t)h(for)f(eac)n(h)f(F)-7 b(rame)34 b(axis)g(\(Naxes)g
+(attribute\).)57 b(This)35 b(should)427 3888 y(con)n(tain)27
+b(the)h(co)r(ordinates)e(of)i(the)g(\014rst)f(p)r(oin)n(t)h(on)f(the)h
+(\014rst)g(geo)r(desic)e(curv)n(e.)259 4020 y Fd(a2)427
+4120 y Fi(An)35 b(arra)n(y)d(of)i(double,)j(with)d(one)g(elemen)n(t)h
(for)f(eac)n(h)f(F)-7 b(rame)34 b(axis)g(\(Naxes)g(attribute\).)57
-b(This)35 b(should)427 551 y(con)n(tain)27 b(the)h(co)r(ordinates)e(of)
-i(the)g(\014rst)f(p)r(oin)n(t)h(on)f(the)h(\014rst)g(geo)r(desic)e
-(curv)n(e.)259 676 y Fd(a2)427 776 y Fi(An)35 b(arra)n(y)d(of)i
-(double,)j(with)d(one)g(elemen)n(t)h(for)f(eac)n(h)f(F)-7
-b(rame)34 b(axis)g(\(Naxes)g(attribute\).)57 b(This)35
-b(should)427 875 y(con)n(tain)e(the)g(co)r(ordinates)f(of)h(a)f(second)
-h(p)r(oin)n(t)g(on)f(the)i(\014rst)f(geo)r(desic)f(curv)n(e.)52
-b(It)33 b(should)g(not)g(b)r(e)g(co-)427 975 y(inciden)n(t)28
-b(with)g(the)g(\014rst)g(p)r(oin)n(t.)259 1100 y Fd(b1)427
-1200 y Fi(An)35 b(arra)n(y)d(of)i(double,)j(with)d(one)g(elemen)n(t)h
+b(This)35 b(should)427 4219 y(con)n(tain)e(the)g(co)r(ordinates)f(of)h
+(a)f(second)h(p)r(oin)n(t)g(on)f(the)i(\014rst)f(geo)r(desic)f(curv)n
+(e.)52 b(It)33 b(should)g(not)g(b)r(e)g(co-)427 4319
+y(inciden)n(t)28 b(with)g(the)g(\014rst)g(p)r(oin)n(t.)259
+4451 y Fd(b1)427 4550 y Fi(An)35 b(arra)n(y)d(of)i(double,)j(with)d
+(one)g(elemen)n(t)h(for)f(eac)n(h)f(F)-7 b(rame)34 b(axis)g(\(Naxes)g
+(attribute\).)57 b(This)35 b(should)427 4650 y(con)n(tain)27
+b(the)h(co)r(ordinates)e(of)i(the)g(\014rst)f(p)r(oin)n(t)h(on)f(the)h
+(second)f(geo)r(desic)g(curv)n(e.)259 4782 y Fd(b2)427
+4881 y Fi(An)35 b(arra)n(y)d(of)i(double,)j(with)d(one)g(elemen)n(t)h
(for)f(eac)n(h)f(F)-7 b(rame)34 b(axis)g(\(Naxes)g(attribute\).)57
-b(This)35 b(should)427 1300 y(con)n(tain)27 b(the)h(co)r(ordinates)e
-(of)i(the)g(\014rst)f(p)r(oin)n(t)h(on)f(the)h(second)f(geo)r(desic)g
-(curv)n(e.)259 1425 y Fd(b2)427 1525 y Fi(An)35 b(arra)n(y)d(of)i
-(double,)j(with)d(one)g(elemen)n(t)h(for)f(eac)n(h)f(F)-7
-b(rame)34 b(axis)g(\(Naxes)g(attribute\).)57 b(This)35
-b(should)427 1625 y(con)n(tain)g(the)h(co)r(ordinates)e(of)i(a)f
-(second)g(p)r(oin)n(t)g(on)g(the)h(second)f(geo)r(desic)g(curv)n(e.)60
-b(It)35 b(should)h(not)f(b)r(e)427 1724 y(co-inciden)n(t)27
-b(with)h(the)g(\014rst)g(p)r(oin)n(t.)259 1850 y Fd(cross)427
-1949 y Fi(An)34 b(arra)n(y)e(of)i(double,)h(with)f(one)f(elemen)n(t)h
+b(This)35 b(should)427 4981 y(con)n(tain)g(the)h(co)r(ordinates)e(of)i
+(a)f(second)g(p)r(oin)n(t)g(on)g(the)h(second)f(geo)r(desic)g(curv)n
+(e.)60 b(It)35 b(should)h(not)f(b)r(e)427 5081 y(co-inciden)n(t)27
+b(with)h(the)g(\014rst)g(p)r(oin)n(t.)259 5212 y Fd(cross)427
+5312 y Fi(An)34 b(arra)n(y)e(of)i(double,)h(with)f(one)f(elemen)n(t)h
(for)f(eac)n(h)g(F)-7 b(rame)34 b(axis)e(in)i(whic)n(h)g(the)g(co)r
-(ordinates)f(of)g(the)427 2049 y(required)27 b(in)n(tersection)g(will)h
-(b)r(e)g(returned.)0 2204 y Fd(Notes:)340 2479 y Fh(\017)45
-b Fi(F)-7 b(or)19 b(SkyF)-7 b(rames)19 b(eac)n(h)g(curv)n(e)f(will)i(b)
-r(e)g(a)g(great)e(circle,)j(and)e(in)h(general)e(eac)n(h)h(pair)g(of)h
-(curv)n(es)e(will)i(in)n(tersect)427 2578 y(at)33 b(t)n(w)n(o)f
-(diametrically)f(opp)r(osite)i(p)r(oin)n(ts)f(on)h(the)g(sky)-7
-b(.)51 b(The)33 b(returned)f(p)r(osition)g(is)h(the)g(one)f(whic)n(h)h
-(is)427 2678 y(closest)27 b(to)h(p)r(oin)n(t)f Ft(")p
-Fi(a1)p Ft(")p Fi(.)340 2804 y Fh(\017)45 b Fi(This)19
+(ordinates)f(of)g(the)427 5412 y(required)27 b(in)n(tersection)g(will)h
+(b)r(e)g(returned.)0 5572 y Fd(Notes:)p eop end
+%%Page: 263 273
+TeXDict begin 263 272 bop 3643 52 a FF(263)340 351 y
+Fh(\017)45 b Fi(F)-7 b(or)19 b(SkyF)-7 b(rames)19 b(eac)n(h)g(curv)n(e)
+f(will)i(b)r(e)g(a)g(great)e(circle,)j(and)e(in)h(general)e(eac)n(h)h
+(pair)g(of)h(curv)n(es)e(will)i(in)n(tersect)427 451
+y(at)33 b(t)n(w)n(o)f(diametrically)f(opp)r(osite)i(p)r(oin)n(ts)f(on)h
+(the)g(sky)-7 b(.)51 b(The)33 b(returned)f(p)r(osition)g(is)h(the)g
+(one)f(whic)n(h)h(is)427 551 y(closest)27 b(to)h(p)r(oin)n(t)f
+Ft(")p Fi(a1)p Ft(")p Fi(.)340 690 y Fh(\017)45 b Fi(This)19
b(function)g(will)g(return)f Ft(")p Fi(bad)p Ft(")g Fi(co)r(ordinate)g
(v)-5 b(alues)18 b(\(AST)p Ft(__)p Fi(BAD\))i(if)f(an)n(y)f(of)g(the)i
-(input)f(co)r(ordinates)427 2903 y(has)j(this)h(v)-5
-b(alue,)23 b(or)f(if)h(the)g(t)n(w)n(o)f(p)r(oin)n(ts)g(de\014ning)g
-(either)h(geo)r(desic)e(are)h(co-inciden)n(t,)h(or)e(if)i(the)g(t)n(w)n
-(o)f(curv)n(es)427 3003 y(do)28 b(not)f(in)n(tersect.)340
-3128 y Fh(\017)45 b Fi(The)26 b(geo)r(desic)e(curv)n(e)h(used)g(b)n(y)g
-(this)h(function)g(is)f(the)h(path)f(of)h(shortest)e(distance)i(b)r(et)
-n(w)n(een)f(t)n(w)n(o)g(p)r(oin)n(ts,)427 3228 y(as)i(de\014ned)h(b)n
-(y)f(the)h(astDistance)g(function.)340 3354 y Fh(\017)45
+(input)f(co)r(ordinates)427 790 y(has)j(this)h(v)-5 b(alue,)23
+b(or)f(if)h(the)g(t)n(w)n(o)f(p)r(oin)n(ts)g(de\014ning)g(either)h(geo)
+r(desic)e(are)h(co-inciden)n(t,)h(or)e(if)i(the)g(t)n(w)n(o)f(curv)n
+(es)427 889 y(do)28 b(not)f(in)n(tersect.)340 1029 y
+Fh(\017)45 b Fi(The)26 b(geo)r(desic)e(curv)n(e)h(used)g(b)n(y)g(this)h
+(function)g(is)f(the)h(path)f(of)h(shortest)e(distance)i(b)r(et)n(w)n
+(een)f(t)n(w)n(o)g(p)r(oin)n(ts,)427 1129 y(as)i(de\014ned)h(b)n(y)f
+(the)h(astDistance)g(function.)340 1269 y Fh(\017)45
b Fi(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)h(the)g(F)-7
-b(rame)27 b(is)g(not)h(2-dimensional.)p 0 3538 3780 12
-v 0 3670 a Fz(astIn)l(terv)-7 b(al)831 b Fe(Create)37
+b(rame)27 b(is)g(not)h(2-dimensional.)p 0 1482 3780 12
+v 0 1613 a Fz(astIn)l(terv)-7 b(al)831 b Fe(Create)37
b(a)h(In)m(terv)-7 b(al)828 b Fz(astIn)l(terv)-7 b(al)0
-3821 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g
+1793 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g
(In)n(terv)-5 b(al)27 b(and)h(optionally)e(initialises)i(its)g
-(attributes.)227 3942 y(A)e(In)n(terv)-5 b(al)25 b(is)g(a)g(Region)f
+(attributes.)227 1924 y(A)e(In)n(terv)-5 b(al)25 b(is)g(a)g(Region)f
(whic)n(h)i(represen)n(ts)e(upp)r(er)h(and/or)f(lo)n(w)n(er)g(limits)h
(on)h(one)e(or)h(more)f(axes)h(of)g(a)g(F)-7 b(rame.)227
-4042 y(F)g(or)37 b(a)g(p)r(oin)n(t)g(to)g(b)r(e)h(within)g(the)g
+2024 y(F)g(or)37 b(a)g(p)r(oin)n(t)g(to)g(b)r(e)h(within)g(the)g
(region)e(represen)n(ted)g(b)n(y)h(the)h(In)n(terv)-5
b(al,)39 b(the)e(p)r(oin)n(t)h(m)n(ust)f(satisfy)g(all)g(the)227
-4141 y(restrictions)29 b(placed)h(on)g(all)g(the)h(axes.)44
+2123 y(restrictions)29 b(placed)h(on)g(all)g(the)h(axes.)44
b(The)30 b(p)r(oin)n(t)h(is)f(outside)g(the)h(region)e(if)h(it)h(fails)
-f(to)g(satisfy)g(an)n(y)g(one)g(of)227 4241 y(the)f(restrictions.)39
+f(to)g(satisfy)g(an)n(y)g(one)g(of)227 2223 y(the)f(restrictions.)39
b(Eac)n(h)27 b(axis)h(ma)n(y)f(ha)n(v)n(e)h(either)g(an)g(upp)r(er)h
(limit,)h(a)e(lo)n(w)n(er)f(limit,)i(b)r(oth)g(or)f(neither.)39
-b(If)29 b(b)r(oth)227 4340 y(limits)c(are)e(supplied)h(but)g(are)f(in)i
+b(If)29 b(b)r(oth)227 2323 y(limits)c(are)e(supplied)h(but)g(are)f(in)i
(rev)n(erse)d(order)g(\(so)i(that)g(the)g(lo)n(w)n(er)e(limit)j(is)f
-(greater)e(than)i(the)g(upp)r(er)h(limit\),)227 4440
+(greater)e(than)i(the)g(upp)r(er)h(limit\),)227 2422
y(then)j(the)g(in)n(terv)-5 b(al)27 b(is)h(an)f(excluded)h(in)n(terv)-5
b(al,)27 b(rather)f(than)i(an)f(included)i(in)n(terv)-5
-b(al.)227 4561 y(A)n(t)28 b(least)f(one)h(axis)e(limit)j(m)n(ust)e(b)r
-(e)h(supplied.)227 4682 y(Note,)33 b(The)e(In)n(terv)-5
+b(al.)227 2554 y(A)n(t)28 b(least)f(one)h(axis)e(limit)j(m)n(ust)e(b)r
+(e)h(supplied.)227 2685 y(Note,)33 b(The)e(In)n(terv)-5
b(al)31 b(class)g(mak)n(es)f(no)h(allo)n(w)n(ances)f(for)h(cyclic)g
(nature)g(of)g(some)g(co)r(ordinate)g(systems)g(\(suc)n(h)227
-4781 y(as)25 b(SkyF)-7 b(rame)24 b(co)r(ordinates\).)35
+2785 y(as)25 b(SkyF)-7 b(rame)24 b(co)r(ordinates\).)35
b(A)25 b(Bo)n(x)f(should)g(usually)h(b)r(e)g(used)g(in)g(these)g(cases)
-f(since)h(this)g(requires)f(the)h(user)227 4881 y(to)j(think)g(ab)r
+f(since)h(this)g(requires)f(the)h(user)227 2884 y(to)j(think)g(ab)r
(out)f(suitable)h(upp)r(er)g(and)f(lo)n(w)n(er)f(limits,)0
-5023 y Fd(Synopsis:)121 b Ft(AstInterval)39 b Fh(\003)p
+3047 y Fd(Synopsis:)121 b Ft(AstInterval)39 b Fh(\003)p
Ft(astInterval\()f(AstFrame)i Fh(\003)p Ft(frame,)h(const)g(double)h
-(lbnd[],)e(const)i(double)227 5123 y(ubnd[],)f(AstRegion)f
+(lbnd[],)e(const)i(double)227 3147 y(ubnd[],)f(AstRegion)f
Fh(\003)p Ft(unc,)h(const)h(char)g Fh(\003)p Ft(options,)e(...)85
-b(\))0 5265 y Fd(P)m(arameters:)259 5394 y(frame)427
-5494 y Fi(A)29 b(p)r(oin)n(ter)g(to)f(the)i(F)-7 b(rame)28
+b(\))0 3310 y Fd(P)m(arameters:)259 3461 y(frame)427
+3560 y Fi(A)29 b(p)r(oin)n(ter)g(to)f(the)i(F)-7 b(rame)28
b(in)h(whic)n(h)g(the)g(region)e(is)i(de\014ned.)41 b(A)29
b(deep)g(cop)n(y)f(is)g(tak)n(en)g(of)h(the)g(supplied)427
-5593 y(F)-7 b(rame.)71 b(This)39 b(means)f(that)h(an)n(y)g(subsequen)n
+3660 y(F)-7 b(rame.)71 b(This)39 b(means)f(that)h(an)n(y)g(subsequen)n
(t)f(c)n(hanges)g(made)h(to)f(the)i(F)-7 b(rame)38 b(using)h(the)g
-(supplied)427 5693 y(p)r(oin)n(ter)27 b(will)h(ha)n(v)n(e)f(no)g
-(e\013ect)h(the)g(Region.)p eop end
-%%Page: 263 273
-TeXDict begin 263 272 bop 3643 52 a FF(263)259 351 y
-Fd(lbnd)427 451 y Fi(An)32 b(arra)n(y)c(of)j(double,)h(with)g(one)e
-(elemen)n(t)i(for)e(eac)n(h)g(F)-7 b(rame)31 b(axis)f(\(Naxes)h
-(attribute\))g(con)n(taining)f(the)427 551 y(lo)n(w)n(er)f(limits)h(on)
-g(eac)n(h)f(axis.)43 b(Set)31 b(a)e(v)-5 b(alue)30 b(to)g(AST)p
-Ft(__)p Fi(BAD)g(to)g(indicate)g(that)g(the)h(axis)e(has)g(no)h(lo)n(w)
-n(er)427 650 y(limit.)259 795 y Fd(ubnd)427 894 y Fi(An)i(arra)n(y)c
-(of)j(double,)h(with)g(one)e(elemen)n(t)i(for)e(eac)n(h)g(F)-7
+(supplied)427 3759 y(p)r(oin)n(ter)27 b(will)h(ha)n(v)n(e)f(no)g
+(e\013ect)h(the)g(Region.)259 3899 y Fd(lbnd)427 3999
+y Fi(An)k(arra)n(y)c(of)j(double,)h(with)g(one)e(elemen)n(t)i(for)e
+(eac)n(h)g(F)-7 b(rame)31 b(axis)f(\(Naxes)h(attribute\))g(con)n
+(taining)f(the)427 4098 y(lo)n(w)n(er)f(limits)h(on)g(eac)n(h)f(axis.)
+43 b(Set)31 b(a)e(v)-5 b(alue)30 b(to)g(AST)p Ft(__)p
+Fi(BAD)g(to)g(indicate)g(that)g(the)h(axis)e(has)g(no)h(lo)n(w)n(er)427
+4198 y(limit.)259 4338 y Fd(ubnd)427 4437 y Fi(An)i(arra)n(y)c(of)j
+(double,)h(with)g(one)e(elemen)n(t)i(for)e(eac)n(h)g(F)-7
b(rame)31 b(axis)f(\(Naxes)h(attribute\))g(con)n(taining)f(the)427
-994 y(upp)r(er)e(limits)h(on)e(eac)n(h)g(axis.)37 b(Set)28
+4537 y(upp)r(er)e(limits)h(on)e(eac)n(h)g(axis.)37 b(Set)28
b(a)f(v)-5 b(alue)28 b(to)g(AST)p Ft(__)p Fi(BAD)g(to)f(indicate)h
-(that)g(the)h(axis)e(has)g(no)g(upp)r(er)427 1094 y(limit.)259
-1238 y Fd(unc)427 1338 y Fi(An)33 b(optional)e(p)r(oin)n(ter)h(to)g(an)
+(that)g(the)h(axis)e(has)g(no)g(upp)r(er)427 4637 y(limit.)259
+4776 y Fd(unc)427 4876 y Fi(An)33 b(optional)e(p)r(oin)n(ter)h(to)g(an)
g(existing)g(Region)f(whic)n(h)h(sp)r(eci\014es)g(the)h(uncertain)n
-(ties)e(asso)r(ciated)g(with)427 1438 y(the)j(b)r(oundary)f(of)g(the)h
+(ties)e(asso)r(ciated)g(with)427 4976 y(the)j(b)r(oundary)f(of)g(the)h
(Bo)n(x)f(b)r(eing)g(created.)54 b(The)34 b(uncertain)n(t)n(y)e(in)i
(an)n(y)f(p)r(oin)n(t)h(on)f(the)h(b)r(oundary)f(of)427
-1537 y(the)g(Bo)n(x)e(is)h(found)h(b)n(y)f(shifting)h(the)f(supplied)h
+5075 y(the)g(Bo)n(x)e(is)h(found)h(b)n(y)f(shifting)h(the)f(supplied)h
Ft(")p Fi(uncertain)n(t)n(y)p Ft(")e Fi(Region)g(so)h(that)g(it)h(is)f
-(cen)n(tred)g(at)g(the)427 1637 y(b)r(oundary)e(p)r(oin)n(t)h(b)r(eing)
+(cen)n(tred)g(at)g(the)427 5175 y(b)r(oundary)e(p)r(oin)n(t)h(b)r(eing)
g(considered.)44 b(The)31 b(area)e(co)n(v)n(ered)g(b)n(y)h(the)h
-(shifted)g(uncertain)n(t)n(y)f(Region)g(then)427 1737
+(shifted)g(uncertain)n(t)n(y)f(Region)g(then)427 5274
y(represen)n(ts)g(the)i(uncertain)n(t)n(y)f(in)g(the)h(b)r(oundary)f(p)
r(osition.)48 b(The)31 b(uncertain)n(t)n(y)g(is)g(assumed)g(to)g(b)r(e)
-h(the)427 1836 y(same)27 b(for)g(all)h(p)r(oin)n(ts.)427
-1958 y(If)38 b(supplied,)j(the)d(uncertain)n(t)n(y)f(Region)g(m)n(ust)g
+h(the)427 5374 y(same)27 b(for)g(all)h(p)r(oin)n(ts.)427
+5494 y(If)38 b(supplied,)j(the)d(uncertain)n(t)n(y)f(Region)g(m)n(ust)g
(b)r(e)i(of)e(a)g(class)g(for)g(whic)n(h)h(all)f(instances)g(are)g(cen)
-n(tro-)427 2058 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24
+n(tro-)427 5593 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24
b(Circle,)g(Ellipse,)h(etc.\))36 b(or)23 b(b)r(e)i(a)e(Prism)h(con)n
-(taining)f(cen)n(tro-symetric)f(comp)r(onen)n(t)427 2158
+(taining)f(cen)n(tro-symetric)f(comp)r(onen)n(t)427 5693
y(Regions.)57 b(A)35 b(deep)f(cop)n(y)g(of)g(the)h(supplied)g(Region)f
(will)g(b)r(e)h(tak)n(en,)h(so)e(subsequen)n(t)g(c)n(hanges)f(to)h(the)
-427 2257 y(uncertain)n(t)n(y)28 b(Region)f(using)h(the)h(supplied)f(p)r
-(oin)n(ter)g(will)h(ha)n(v)n(e)e(no)h(e\013ect)h(on)f(the)g(created)g
-(Bo)n(x.)38 b(Alter-)427 2357 y(nativ)n(ely)-7 b(,)24
-b(a)g(NULL)g(Ob)5 b(ject)24 b(p)r(oin)n(ter)f(ma)n(y)h(b)r(e)g
-(supplied,)h(in)f(whic)n(h)g(case)f(a)g(default)i(uncertain)n(t)n(y)e
-(is)h(used)427 2456 y(equiv)-5 b(alen)n(t)28 b(to)f(a)g(b)r(o)n(x)g
-(1.0E-6)f(of)h(the)h(size)g(of)f(the)h(Bo)n(x)f(b)r(eing)g(created.)427
-2579 y(The)c(uncertain)n(t)n(y)f(Region)g(has)g(t)n(w)n(o)g(uses:)34
+p eop end
+%%Page: 264 274
+TeXDict begin 264 273 bop 0 52 a FF(264)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)427 351 y Fi(uncertain)n(t)n(y)e
+(Region)f(using)h(the)h(supplied)f(p)r(oin)n(ter)g(will)h(ha)n(v)n(e)e
+(no)h(e\013ect)h(on)f(the)g(created)g(Bo)n(x.)38 b(Alter-)427
+451 y(nativ)n(ely)-7 b(,)24 b(a)g(NULL)g(Ob)5 b(ject)24
+b(p)r(oin)n(ter)f(ma)n(y)h(b)r(e)g(supplied,)h(in)f(whic)n(h)g(case)f
+(a)g(default)i(uncertain)n(t)n(y)e(is)h(used)427 551
+y(equiv)-5 b(alen)n(t)28 b(to)f(a)g(b)r(o)n(x)g(1.0E-6)f(of)h(the)h
+(size)g(of)f(the)h(Bo)n(x)f(b)r(eing)g(created.)427 670
+y(The)c(uncertain)n(t)n(y)f(Region)g(has)g(t)n(w)n(o)g(uses:)34
b(1\))22 b(when)h(the)g(astOv)n(erlap)d(function)k(compares)d(t)n(w)n
-(o)h(Regions)427 2678 y(for)g(equalit)n(y)h(the)g(uncertain)n(t)n(y)f
+(o)h(Regions)427 770 y(for)g(equalit)n(y)h(the)g(uncertain)n(t)n(y)f
(Region)g(is)g(used)h(to)g(determine)f(the)i(tolerance)d(on)i(the)g
-(comparison,)f(and)427 2778 y(2\))31 b(when)f(a)h(Region)e(is)i(mapp)r
+(comparison,)f(and)427 869 y(2\))31 b(when)f(a)h(Region)e(is)i(mapp)r
(ed)g(in)n(to)f(a)g(di\013eren)n(t)h(co)r(ordinate)e(system)i(and)f
-(subsequen)n(tly)g(simpli\014ed)427 2878 y(\(using)c(astSimplify\),)h
+(subsequen)n(tly)g(simpli\014ed)427 969 y(\(using)c(astSimplify\),)h
(the)f(uncertain)n(ties)f(are)g(used)h(to)g(determine)g(if)g(the)g
-(transformed)f(b)r(oundary)g(can)427 2977 y(b)r(e)j(accurately)e
+(transformed)f(b)r(oundary)g(can)427 1069 y(b)r(e)j(accurately)e
(represen)n(ted)h(b)n(y)g(a)g(sp)r(eci\014c)h(shap)r(e)f(of)h(Region.)
-259 3122 y Fd(options)427 3221 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n
+259 1208 y Fd(options)427 1307 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n
(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 3321 y(assignmen)n(ts)f
+(comma-separated)e(list)i(of)g(attribute)427 1407 y(assignmen)n(ts)f
(to)h(b)r(e)g(used)g(for)f(initialising)h(the)g(new)g(In)n(terv)-5
b(al.)37 b(The)28 b(syn)n(tax)e(used)i(is)g(iden)n(tical)g(to)f(that)
-427 3421 y(for)f(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
+427 1507 y(for)f(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n
(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-3520 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 3665
-y Fd(...)427 3765 y Fi(If)38 b(the)g Ft(")p Fi(options)p
+1606 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 1746
+y Fd(...)427 1845 y Fi(If)38 b(the)g Ft(")p Fi(options)p
Ft(")e Fi(string)h(con)n(tains)f Ft(")p Fi(\045)p Ft(")h
Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g(list)h(of)f
-(additional)427 3864 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
+(additional)427 1945 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
(order)e(to)h(supply)h(v)-5 b(alues)27 b(to)g(b)r(e)h(substituted)h
-(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 3964 y(rules)25
+(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 2045 y(rules)25
b(for)f(supplying)h(these)g(are)f(iden)n(tical)h(to)g(those)g(for)f
(the)h(astSet)g(function)h(\(and)f(for)g(the)g(C)g Ft(")p
-Fi(prin)n(tf)p Ft(")427 4064 y Fi(function\).)0 4249
-y Fd(Returned)32 b(V)-8 b(alue:)259 4409 y(astIn)m(terv)j(al\(\))427
-4509 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(In)n(terv)-5
-b(al.)0 4695 y Fd(Notes:)340 5001 y Fh(\017)45 b Fi(A)35
+Fi(prin)n(tf)p Ft(")427 2144 y Fi(function\).)0 2319
+y Fd(Returned)32 b(V)-8 b(alue:)259 2469 y(astIn)m(terv)j(al\(\))427
+2568 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(In)n(terv)-5
+b(al.)0 2743 y Fd(Notes:)340 3039 y Fh(\017)45 b Fi(A)35
b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
-(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 5100 y(AST)28
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 3138 y(AST)28
b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)-2 5286 y Fd(Status)33 b(Handling)n(:)227 5432
+(reason.)-2 3313 y Fd(Status)33 b(Handling)n(:)227 3459
y Fi(The)d(protected)g(in)n(terface)f(to)g(this)h(function)h(includes)f
(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g(the)g(parameter)227
-5532 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37
+3559 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37
b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)e
(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fi(in)n(t)227
-5631 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p eop end
-%%Page: 264 274
-TeXDict begin 264 273 bop 0 52 a FF(264)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 482 a Fz(astIn)l(traMap)647 b Fe(Create)37 b(an)h(In)m(traMap)644
-b Fz(astIn)l(traMap)0 686 y Fd(Description:)44 b Fi(This)28
-b(function)g(creates)f(a)g(new)g(In)n(traMap)g(and)g(optionally)g
-(initialises)g(its)h(attributes.)227 818 y(An)k(In)n(traMap)e(is)h(a)g
-(sp)r(ecialised)g(form)g(of)g(Mapping)g(whic)n(h)g(encapsulates)f(a)h
-(priv)-5 b(ately-de\014ned)31 b(co)r(ordinate)227 918
-y(transformation)e(function)i(\(e.g.)44 b(written)31
-b(in)f(C\))h(so)e(that)i(it)f(ma)n(y)g(b)r(e)g(used)g(lik)n(e)g(an)n(y)
-g(other)f(AST)i(Mapping.)227 1017 y(This)d(allo)n(ws)e(y)n(ou)h(to)g
-(create)g(Mappings)g(that)h(p)r(erform)f(an)n(y)g(conceiv)-5
-b(able)27 b(co)r(ordinate)f(transformation.)227 1150
+3659 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p 0 3871 3780
+12 v 0 4002 a Fz(astIn)l(traMap)1378 4001 y Fe(Create)37
+b(an)h(In)m(traMap)3047 4002 y Fz(astIn)l(traMap)0 4203
+y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g(In)n
+(traMap)g(and)g(optionally)g(initialises)g(its)h(attributes.)227
+4334 y(An)k(In)n(traMap)e(is)h(a)g(sp)r(ecialised)g(form)g(of)g
+(Mapping)g(whic)n(h)g(encapsulates)f(a)h(priv)-5 b(ately-de\014ned)31
+b(co)r(ordinate)227 4434 y(transformation)e(function)i(\(e.g.)44
+b(written)31 b(in)f(C\))h(so)e(that)i(it)f(ma)n(y)g(b)r(e)g(used)g(lik)
+n(e)g(an)n(y)g(other)f(AST)i(Mapping.)227 4534 y(This)d(allo)n(ws)e(y)n
+(ou)h(to)g(create)g(Mappings)g(that)h(p)r(erform)f(an)n(y)g(conceiv)-5
+b(able)27 b(co)r(ordinate)f(transformation.)227 4665
y(Ho)n(w)n(ev)n(er,)k(an)h(In)n(traMap)g(is)g(in)n(tended)g(for)g(use)g
(within)h(a)f(single)f(program)g(or)g(a)h(priv)-5 b(ate)31
-b(suite)g(of)g(soft)n(w)n(are,)227 1249 y(where)24 b(all)g(programs)d
+b(suite)g(of)g(soft)n(w)n(are,)227 4764 y(where)24 b(all)g(programs)d
(ha)n(v)n(e)i(access)g(to)h(the)g(same)g(co)r(ordinate)f
(transformation)f(functions)j(\(i.e.)36 b(can)23 b(b)r(e)i(link)n(ed)
-227 1349 y(against)40 b(them\).)76 b(In)n(traMaps)39
+227 4864 y(against)40 b(them\).)76 b(In)n(traMaps)39
b(should)h(not)h(normally)e(b)r(e)i(stored)f(in)g(datasets)g(whic)n(h)g
-(ma)n(y)g(b)r(e)h(exp)r(orted)227 1449 y(for)34 b(pro)r(cessing)f(b)n
+(ma)n(y)g(b)r(e)h(exp)r(orted)227 4964 y(for)34 b(pro)r(cessing)f(b)n
(y)h(other)g(soft)n(w)n(are,)g(since)g(that)h(soft)n(w)n(are)e(will)h
(not)h(ha)n(v)n(e)e(the)i(necessary)d(transformation)227
-1548 y(functions)c(a)n(v)-5 b(ailable,)27 b(resulting)g(in)g(an)h
-(error.)227 1680 y(Y)-7 b(ou)36 b(m)n(ust)f(register)f(an)n(y)h(co)r
+5063 y(functions)c(a)n(v)-5 b(ailable,)27 b(resulting)g(in)g(an)h
+(error.)227 5194 y(Y)-7 b(ou)36 b(m)n(ust)f(register)f(an)n(y)h(co)r
(ordinate)f(transformation)g(functions)i(to)f(b)r(e)h(used)f(using)g
-(astIn)n(traReg)f(b)r(efore)227 1780 y(creating)27 b(an)g(In)n(traMap.)
-0 1945 y Fd(Synopsis:)121 b Ft(AstIntraMap)39 b Fh(\003)p
+(astIn)n(traReg)f(b)r(efore)227 5294 y(creating)27 b(an)g(In)n(traMap.)
+0 5456 y Fd(Synopsis:)121 b Ft(AstIntraMap)39 b Fh(\003)p
Ft(astIntraMap\()f(const)k(char)f Fh(\003)p Ft(name,)h(int)g(nin,)g
(int)g(nout,)g(const)f(char)h Fh(\003)p Ft(options,)227
-2044 y(...)86 b(\))0 2209 y Fd(P)m(arameters:)259 2361
-y(name)427 2460 y Fi(P)n(oin)n(ter)34 b(to)i(a)f(n)n(ull-terminated)g
+5556 y(...)86 b(\))0 5718 y Fd(P)m(arameters:)p eop end
+%%Page: 265 275
+TeXDict begin 265 274 bop 3643 52 a FF(265)259 351 y
+Fd(name)427 451 y Fi(P)n(oin)n(ter)34 b(to)i(a)f(n)n(ull-terminated)g
(string)g(con)n(taining)f(the)i(name)f(of)h(the)g(transformation)e
-(function)i(to)427 2560 y(use)h(\(whic)n(h)h(should)f(previously)e(ha)n
+(function)i(to)427 551 y(use)h(\(whic)n(h)h(should)f(previously)e(ha)n
(v)n(e)h(b)r(een)i(registered)e(using)g(astIn)n(traReg\).)64
-b(This)38 b(name)e(is)h(case)427 2660 y(sensitiv)n(e.)g(All)28
+b(This)38 b(name)e(is)h(case)427 650 y(sensitiv)n(e.)g(All)28
b(white)g(space)e(will)i(b)r(e)g(remo)n(v)n(ed)e(b)r(efore)i(use.)259
-2800 y Fd(nin)427 2900 y Fi(The)d(n)n(um)n(b)r(er)f(of)g(input)h(co)r
+782 y Fd(nin)427 882 y Fi(The)d(n)n(um)n(b)r(er)f(of)g(input)h(co)r
(ordinates.)34 b(This)24 b(m)n(ust)h(b)r(e)f(compatible)g(with)h(the)g
-(n)n(um)n(b)r(er)f(of)g(input)h(co)r(ordi-)427 2999 y(nates)f(accepted)
-g(b)n(y)g(the)h(transformation)e(function)h(\(as)g(sp)r(eci\014ed)h
-(when)f(this)h(function)g(w)n(as)e(registered)427 3099
-y(using)28 b(astIn)n(traReg\).)259 3239 y Fd(nout)427
-3339 y Fi(The)37 b(n)n(um)n(b)r(er)f(of)g(output)h(co)r(ordinates.)63
+(n)n(um)n(b)r(er)f(of)g(input)h(co)r(ordi-)427 981 y(nates)f(accepted)g
+(b)n(y)g(the)h(transformation)e(function)h(\(as)g(sp)r(eci\014ed)h
+(when)f(this)h(function)g(w)n(as)e(registered)427 1081
+y(using)28 b(astIn)n(traReg\).)259 1213 y Fd(nout)427
+1312 y Fi(The)37 b(n)n(um)n(b)r(er)f(of)g(output)h(co)r(ordinates.)63
b(This)36 b(m)n(ust)h(b)r(e)f(compatible)h(with)g(the)f(n)n(um)n(b)r
-(er)h(of)f(output)427 3439 y(co)r(ordinates)f(pro)r(duced)h(b)n(y)g
+(er)h(of)f(output)427 1412 y(co)r(ordinates)f(pro)r(duced)h(b)n(y)g
(the)g(transformation)f(function)i(\(as)f(sp)r(eci\014ed)g(when)g(this)
-h(function)g(w)n(as)427 3538 y(registered)26 b(using)i(astIn)n
-(traReg\).)259 3679 y Fd(options)427 3778 y Fi(P)n(oin)n(ter)f(to)h(a)g
+h(function)g(w)n(as)427 1512 y(registered)26 b(using)i(astIn)n
+(traReg\).)259 1643 y Fd(options)427 1743 y Fi(P)n(oin)n(ter)f(to)h(a)g
(n)n(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 3878 y(assignmen)n(ts)22
+(comma-separated)e(list)i(of)g(attribute)427 1843 y(assignmen)n(ts)22
b(to)i(b)r(e)f(used)h(for)f(initialising)g(the)h(new)f(In)n(traMap.)34
b(The)24 b(syn)n(tax)e(used)i(is)f(iden)n(tical)g(to)g(that)427
-3978 y(for)j(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
+1942 y(for)j(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n
(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-4077 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 4218
-y Fd(...)427 4317 y Fi(If)38 b(the)g Ft(")p Fi(options)p
+2042 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 2174
+y Fd(...)427 2273 y Fi(If)38 b(the)g Ft(")p Fi(options)p
Ft(")e Fi(string)h(con)n(tains)f Ft(")p Fi(\045)p Ft(")h
Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g(list)h(of)f
-(additional)427 4417 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
+(additional)427 2373 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
(order)e(to)h(supply)h(v)-5 b(alues)27 b(to)g(b)r(e)h(substituted)h
-(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 4517 y(rules)25
+(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 2473 y(rules)25
b(for)f(supplying)h(these)g(are)f(iden)n(tical)h(to)g(those)g(for)f
(the)h(astSet)g(function)h(\(and)f(for)g(the)g(C)g Ft(")p
-Fi(prin)n(tf)p Ft(")427 4616 y Fi(function\).)0 4793
-y Fd(Returned)32 b(V)-8 b(alue:)259 4945 y(astIn)m(traMap\(\))427
-5045 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(In)n(traMap.)0
-5222 y Fd(Notes:)340 5520 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+Fi(prin)n(tf)p Ft(")427 2572 y Fi(function\).)0 2733
+y Fd(Returned)32 b(V)-8 b(alue:)259 2869 y(astIn)m(traMap\(\))427
+2968 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(In)n(traMap.)0
+3129 y Fd(Notes:)340 3411 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 5619 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p eop end
-%%Page: 265 275
-TeXDict begin 265 274 bop 3643 52 a FF(265)p 0 351 3780
-12 v 0 482 a Fz(astIn)l(traReg)914 483 y Fe(Register)38
-b(a)g(transformation)d(function)i(for)1384 598 y(use)i(b)m(y)g(an)f(In)
-m(traMap)3086 482 y Fz(astIn)l(traReg)0 778 y Fd(Description:)44
+427 3510 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 3707 3780 12 v 0 3838
+a Fz(astIn)l(traReg)914 3839 y Fe(Register)38 b(a)g(transformation)d
+(function)i(for)1384 3954 y(use)i(b)m(y)g(an)f(In)m(traMap)3086
+3838 y Fz(astIn)l(traReg)0 4140 y Fd(Description:)44
b Fi(This)30 b(function)h(registers)e(a)g(priv)-5 b(ately-de\014ned)30
b(co)r(ordinate)f(transformation)f(function)j(written)f(in)227
-878 y(C)h(so)g(that)g(it)h(ma)n(y)e(b)r(e)i(used)f(to)g(create)f(an)h
+4240 y(C)h(so)g(that)g(it)h(ma)n(y)e(b)r(e)i(used)f(to)g(create)f(an)h
(In)n(traMap.)47 b(An)31 b(In)n(traMap)g(is)g(a)f(sp)r(ecialised)h
-(form)g(of)g(Mapping)227 978 y(whic)n(h)23 b(encapsulates)f(the)h(C)f
+(form)g(of)g(Mapping)227 4340 y(whic)n(h)23 b(encapsulates)f(the)h(C)f
(function)i(so)e(that)g(it)i(ma)n(y)d(b)r(e)j(used)e(lik)n(e)g(an)n(y)g
(other)g(AST)h(Mapping.)35 b(This)23 b(allo)n(ws)227
-1077 y(y)n(ou)k(to)h(create)e(Mappings)h(that)h(p)r(erform)f(an)n(y)g
+4439 y(y)n(ou)k(to)h(create)e(Mappings)h(that)h(p)r(erform)f(an)n(y)g
(conceiv)-5 b(able)27 b(co)r(ordinate)f(transformation.)227
-1200 y(Registration)36 b(of)g(relev)-5 b(an)n(t)36 b(transformation)f
+4563 y(Registration)36 b(of)g(relev)-5 b(an)n(t)36 b(transformation)f
(functions)i(is)f(required)g(b)r(efore)g(using)g(the)h(astIn)n(traMap)e
-(con-)227 1299 y(structor)24 b(function)g(to)h(create)e(an)h(In)n
+(con-)227 4663 y(structor)24 b(function)g(to)h(create)e(an)h(In)n
(traMap)f(or)g(reading)h(an)g(external)f(represen)n(tation)g(of)h(an)g
-(In)n(traMap)f(from)227 1399 y(a)k(Channel.)0 1545 y
+(In)n(traMap)f(from)227 4763 y(a)k(Channel.)0 4911 y
Fd(Synopsis:)121 b Ft(astIntraReg\()38 b(const)k(char)g
Fh(\003)p Ft(name,)f(int)h(nin,)g(int)h(nout,)e(void)h(\()p
Fh(\003)h Ft(tran\)\()e(AstMapping)e Fh(\003)p Ft(,)227
-1644 y(int,)j(int,)g(const)g(double)f Fh(\003)p Ft([],)h(int,)g(int,)f
+5011 y(int,)j(int,)g(const)g(double)f Fh(\003)p Ft([],)h(int,)g(int,)f
(double)h Fh(\003)p Ft([])g(\),)h(unsigned)d(int)i(flags,)f(const)h
-(char)227 1744 y Fh(\003)p Ft(purpose,)e(const)i(char)g
+(char)227 5110 y Fh(\003)p Ft(purpose,)e(const)i(char)g
Fh(\003)p Ft(author,)e(const)h(char)h Fh(\003)p Ft(contact)e(\))0
-1889 y Fd(P)m(arameters:)259 2022 y(name)427 2121 y Fi(P)n(oin)n(ter)22
+5259 y Fd(P)m(arameters:)259 5394 y(name)427 5494 y Fi(P)n(oin)n(ter)22
b(to)i(a)f(n)n(ull-terminated)h(string)f(con)n(taining)g(a)g(unique)h
(name)g(to)g(b)r(e)g(asso)r(ciated)e(with)i(the)h(trans-)427
-2221 y(formation)30 b(function)i(in)f(order)f(to)h(iden)n(tify)g(it.)48
+5593 y(formation)30 b(function)i(in)f(order)f(to)h(iden)n(tify)g(it.)48
b(This)31 b(name)g(is)g(case)f(sensitiv)n(e.)46 b(All)32
-b(white)f(space)f(will)427 2321 y(b)r(e)e(remo)n(v)n(ed)e(b)r(efore)i
-(use.)259 2449 y Fd(nin)427 2549 y Fi(The)j(n)n(um)n(b)r(er)f(of)g
-(input)h(co)r(ordinates)e(accepted)h(b)n(y)g(the)h(transformation)e
-(function)i(\(i.e.)45 b(the)31 b(n)n(um)n(b)r(er)427
-2649 y(of)c(dimensions)g(of)g(the)g(space)f(in)h(whic)n(h)g(the)h
-(input)f(p)r(oin)n(ts)g(reside\).)37 b(A)27 b(v)-5 b(alue)27
-b(of)g(AST)p Ft(__)p Fi(ANY)g(ma)n(y)f(b)r(e)427 2748
-y(giv)n(en)h(if)h(the)g(function)g(is)g(able)f(to)h(accommo)r(date)e(a)
-h(v)-5 b(ariable)27 b(n)n(um)n(b)r(er)g(of)h(input)g(co)r(ordinates.)
-259 2877 y Fd(nout)427 2977 y Fi(The)d(n)n(um)n(b)r(er)f(of)h(output)g
-(co)r(ordinates)e(pro)r(duced)i(b)n(y)f(the)h(transformation)e
+b(white)f(space)f(will)427 5693 y(b)r(e)e(remo)n(v)n(ed)e(b)r(efore)i
+(use.)p eop end
+%%Page: 266 276
+TeXDict begin 266 275 bop 0 52 a FF(266)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(nin)427
+451 y Fi(The)h(n)n(um)n(b)r(er)f(of)g(input)h(co)r(ordinates)e
+(accepted)h(b)n(y)g(the)h(transformation)e(function)i(\(i.e.)45
+b(the)31 b(n)n(um)n(b)r(er)427 551 y(of)c(dimensions)g(of)g(the)g
+(space)f(in)h(whic)n(h)g(the)h(input)f(p)r(oin)n(ts)g(reside\).)37
+b(A)27 b(v)-5 b(alue)27 b(of)g(AST)p Ft(__)p Fi(ANY)g(ma)n(y)f(b)r(e)
+427 650 y(giv)n(en)h(if)h(the)g(function)g(is)g(able)f(to)h(accommo)r
+(date)e(a)h(v)-5 b(ariable)27 b(n)n(um)n(b)r(er)g(of)h(input)g(co)r
+(ordinates.)259 794 y Fd(nout)427 893 y Fi(The)d(n)n(um)n(b)r(er)f(of)h
+(output)g(co)r(ordinates)e(pro)r(duced)i(b)n(y)f(the)h(transformation)e
(function)j(\(i.e.)36 b(the)25 b(n)n(um)n(b)r(er)427
-3076 y(of)31 b(dimensions)f(of)h(the)g(space)f(in)h(whic)n(h)f(the)h
+993 y(of)31 b(dimensions)f(of)h(the)g(space)f(in)h(whic)n(h)f(the)h
(output)h(p)r(oin)n(ts)e(reside\).)46 b(A)31 b(v)-5 b(alue)31
-b(of)f(AST)p Ft(__)p Fi(ANY)h(ma)n(y)427 3176 y(b)r(e)d(giv)n(en)f(if)h
+b(of)f(AST)p Ft(__)p Fi(ANY)h(ma)n(y)427 1092 y(b)r(e)d(giv)n(en)f(if)h
(the)g(function)g(is)g(able)f(to)h(pro)r(duce)f(a)g(v)-5
b(ariable)26 b(n)n(um)n(b)r(er)i(of)f(output)h(co)r(ordinates.)259
-3305 y Fd(tran)427 3405 y Fi(P)n(oin)n(ter)e(to)i(the)f(transformation)
+1236 y Fd(tran)427 1336 y Fi(P)n(oin)n(ter)e(to)i(the)f(transformation)
f(function)i(to)g(b)r(e)g(registered.)35 b(This)28 b(function)g(should)
-f(p)r(erform)g(what-)427 3504 y(ev)n(er)40 b(co)r(ordinate)g
+f(p)r(erform)g(what-)427 1435 y(ev)n(er)40 b(co)r(ordinate)g
(transformations)f(are)h(required)h(and)g(should)f(ha)n(v)n(e)g(an)h
-(in)n(terface)g(lik)n(e)f(astT)-7 b(ranP)427 3604 y(\(q.v.\).)259
-3733 y Fd(\015ags)427 3832 y Fi(This)31 b(v)-5 b(alue)31
+(in)n(terface)g(lik)n(e)f(astT)-7 b(ranP)427 1535 y(\(q.v.\).)259
+1678 y Fd(\015ags)427 1778 y Fi(This)31 b(v)-5 b(alue)31
b(ma)n(y)f(b)r(e)i(used)f(to)f(supply)h(a)g(set)g(of)g(\015ags)f(whic)n
(h)h(describ)r(e)f(the)i(transformation)d(function)427
-3932 y(and)j(whic)n(h)h(ma)n(y)e(a\013ect)i(the)g(b)r(eha)n(viour)e(of)
+1878 y(and)j(whic)n(h)h(ma)n(y)e(a\013ect)i(the)g(b)r(eha)n(viour)e(of)
h(an)n(y)g(In)n(traMap)f(whic)n(h)h(uses)g(it.)52 b(Often,)34
-b(a)e(v)-5 b(alue)32 b(of)h(zero)427 4032 y(will)e(b)r(e)f(giv)n(en)g
+b(a)e(v)-5 b(alue)32 b(of)h(zero)427 1977 y(will)e(b)r(e)f(giv)n(en)g
(here,)g(but)h(y)n(ou)e(ma)n(y)h(also)f(supply)h(the)h(bit)n(wise)f(OR)
g(of)g(a)f(set)i(of)f(\015ags)f(as)g(describ)r(ed)h(in)427
-4131 y(the)e Ft(")p Fi(T)-7 b(ransformation)26 b(Flags)p
-Ft(")g Fi(section)h(\(b)r(elo)n(w\).)259 4260 y Fd(purp)s(ose)427
-4360 y Fi(P)n(oin)n(ter)d(to)h(a)g(n)n(ull-terminated)g(string)g(con)n
+2077 y(the)e Ft(")p Fi(T)-7 b(ransformation)26 b(Flags)p
+Ft(")g Fi(section)h(\(b)r(elo)n(w\).)259 2220 y Fd(purp)s(ose)427
+2320 y Fi(P)n(oin)n(ter)d(to)h(a)g(n)n(ull-terminated)g(string)g(con)n
(taining)f(a)h(short)f(\(one)h(line\))h(textual)g(commen)n(t)f(to)g
-(describ)r(e)427 4459 y(the)j(purp)r(ose)f(of)h(the)g(transformation)e
-(function.)259 4588 y Fd(author)427 4688 y Fi(P)n(oin)n(ter)h(to)i(a)g
+(describ)r(e)427 2420 y(the)j(purp)r(ose)f(of)h(the)g(transformation)e
+(function.)259 2563 y Fd(author)427 2663 y Fi(P)n(oin)n(ter)h(to)i(a)g
(n)n(ull-terminated)f(string)g(con)n(taining)g(the)h(name)g(of)g(the)g
-(author)f(of)h(the)g(transformation)427 4787 y(function.)259
-4916 y Fd(con)m(tact)427 5016 y Fi(P)n(oin)n(ter)35 b(to)i(a)f(n)n
+(author)f(of)h(the)g(transformation)427 2762 y(function.)259
+2906 y Fd(con)m(tact)427 3005 y Fi(P)n(oin)n(ter)35 b(to)i(a)f(n)n
(ull-terminated)g(string)g(con)n(taining)g(con)n(tact)g(details)g(for)g
-(the)h(author)f(of)h(the)g(trans-)427 5116 y(formation)h(function)h
+(the)h(author)f(of)h(the)g(trans-)427 3105 y(formation)h(function)h
(\(e.g.)69 b(an)38 b(e-mail)g(or)f(WWW)i(address\).)68
b(If)39 b(an)n(y)f(In)n(traMap)f(whic)n(h)h(uses)g(this)427
-5215 y(transformation)33 b(function)i(is)f(exp)r(orted)f(as)h(part)g
+3205 y(transformation)33 b(function)i(is)f(exp)r(orted)f(as)h(part)g
(of)g(a)f(dataset)h(to)g(an)g(external)f(user)h(who)g(do)r(es)g(not)427
-5315 y(ha)n(v)n(e)28 b(access)g(to)h(the)h(function,)g(then)g(these)f
+3304 y(ha)n(v)n(e)28 b(access)g(to)h(the)h(function,)g(then)g(these)f
(con)n(tact)g(details)g(should)g(allo)n(w)f(them)h(to)g(obtain)g(the)h
-(nec-)427 5414 y(essary)c(co)r(de.)0 5572 y Fd(Notes:)p
-eop end
-%%Page: 266 276
-TeXDict begin 266 275 bop 0 52 a FF(266)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
-b Fi(Bew)n(are)27 b(that)i(an)f(external)f(represen)n(tation)g(of)h(an)
-g(In)n(traMap)f(\(created)h(b)n(y)g(writing)g(it)g(to)h(a)e(Channel\))
-427 451 y(will)e(not)f(include)h(the)f(co)r(ordinate)f(transformation)g
-(function)h(whic)n(h)h(it)f(uses,)h(so)e(will)i(only)f(refer)f(to)h
-(the)427 551 y(function)j(b)n(y)e(its)h(name)g(\(as)f(assigned)g(using)
-g(astIn)n(traReg\).)35 b(Consequen)n(tly)-7 b(,)25 b(the)i(external)e
-(represen)n(ta-)427 650 y(tion)h(cannot)g(b)r(e)g(utilised)h(b)n(y)f
-(another)f(program)f(unless)h(that)i(program)d(has)h(also)g(registered)
-g(the)h(same)427 750 y(transformation)g(function)i(with)f(the)h(same)e
-(name)h(using)g(an)g(iden)n(tical)g(in)n(v)n(o)r(cation)f(of)h(astIn)n
-(traReg.)35 b(If)427 849 y(no)24 b(suc)n(h)g(registration)e(has)i(b)r
-(een)g(p)r(erformed,)g(then)h(attempting)f(to)g(read)g(the)g(external)f
-(represen)n(tation)427 949 y(will)28 b(result)f(in)h(an)g(error.)340
-1082 y Fh(\017)45 b Fi(Y)-7 b(ou)36 b(ma)n(y)f(use)g(astIn)n(traReg)f
+(nec-)427 3404 y(essary)c(co)r(de.)0 3587 y Fd(Notes:)340
+3891 y Fh(\017)45 b Fi(Bew)n(are)27 b(that)i(an)f(external)f(represen)n
+(tation)g(of)h(an)g(In)n(traMap)f(\(created)h(b)n(y)g(writing)g(it)g
+(to)h(a)e(Channel\))427 3991 y(will)e(not)f(include)h(the)f(co)r
+(ordinate)f(transformation)g(function)h(whic)n(h)h(it)f(uses,)h(so)e
+(will)i(only)f(refer)f(to)h(the)427 4090 y(function)j(b)n(y)e(its)h
+(name)g(\(as)f(assigned)g(using)g(astIn)n(traReg\).)35
+b(Consequen)n(tly)-7 b(,)25 b(the)i(external)e(represen)n(ta-)427
+4190 y(tion)h(cannot)g(b)r(e)g(utilised)h(b)n(y)f(another)f(program)f
+(unless)h(that)i(program)d(has)h(also)g(registered)g(the)h(same)427
+4289 y(transformation)g(function)i(with)f(the)h(same)e(name)h(using)g
+(an)g(iden)n(tical)g(in)n(v)n(o)r(cation)f(of)h(astIn)n(traReg.)35
+b(If)427 4389 y(no)24 b(suc)n(h)g(registration)e(has)i(b)r(een)g(p)r
+(erformed,)g(then)h(attempting)f(to)g(read)g(the)g(external)f(represen)
+n(tation)427 4489 y(will)28 b(result)f(in)h(an)g(error.)340
+4632 y Fh(\017)45 b Fi(Y)-7 b(ou)36 b(ma)n(y)f(use)g(astIn)n(traReg)f
(to)i(register)e(a)h(transformation)f(function)j(with)f(the)g(same)f
-(name)g(more)427 1182 y(than)30 b(once,)f(but)h(only)f(if)h(the)g
+(name)g(more)427 4732 y(than)30 b(once,)f(but)h(only)f(if)h(the)g
(argumen)n(ts)e(supplied)h(are)g(iden)n(tical)g(on)g(eac)n(h)g(o)r
-(ccasion)f(\(i.e)h(there)h(is)f(no)427 1281 y(w)n(a)n(y)e(of)h(c)n
+(ccasion)f(\(i.e)h(there)h(is)f(no)427 4831 y(w)n(a)n(y)e(of)h(c)n
(hanging)e(things)i(once)f(a)g(function)i(has)e(b)r(een)h(successfully)
-f(registered)g(under)g(a)h(giv)n(en)f(name,)427 1381
+f(registered)g(under)g(a)h(giv)n(en)f(name,)427 4931
y(and)32 b(attempting)h(to)e(do)h(so)g(will)g(result)g(in)g(an)g
(error\).)48 b(This)32 b(feature)g(simply)g(allo)n(ws)f(registration)f
-(to)427 1481 y(b)r(e)25 b(p)r(erformed)e(indep)r(enden)n(tly)-7
+(to)427 5031 y(b)r(e)25 b(p)r(erformed)e(indep)r(enden)n(tly)-7
b(,)26 b(but)f(consisten)n(tly)-7 b(,)24 b(at)g(sev)n(eral)e(places)i
-(within)h(y)n(our)d(program,)h(without)427 1580 y(ha)n(ving)k(to)g(c)n
+(within)h(y)n(our)d(program,)h(without)427 5130 y(ha)n(ving)k(to)g(c)n
(hec)n(k)g(whether)g(it)h(has)g(already)e(b)r(een)i(done.)340
-1713 y Fh(\017)45 b Fi(If)30 b(an)f(error)e(o)r(ccurs)i(in)g(the)h
+5274 y Fh(\017)45 b Fi(If)30 b(an)f(error)e(o)r(ccurs)i(in)g(the)h
(transformation)e(function,)i(this)f(ma)n(y)g(b)r(e)h(indicated)f(b)n
-(y)g(setting)h(the)f(AST)427 1813 y(error)h(status)i(to)f(an)h(error)e
+(y)g(setting)h(the)f(AST)427 5373 y(error)h(status)i(to)f(an)h(error)e
(v)-5 b(alue)31 b(\(using)h(astSetStatus\))g(b)r(efore)g(it)g(returns.)
-49 b(This)31 b(will)h(immediately)427 1913 y(terminate)k(the)h(curren)n
+49 b(This)31 b(will)h(immediately)427 5473 y(terminate)k(the)h(curren)n
(t)f(AST)g(op)r(eration.)62 b(The)37 b(error)d(v)-5 b(alue)37
b(AST)p Ft(__)p Fi(ITFER)e(is)h(a)n(v)-5 b(ailable)35
-b(for)h(this)427 2012 y(purp)r(ose,)27 b(but)h(other)f(v)-5
+b(for)h(this)427 5573 y(purp)r(ose,)27 b(but)h(other)f(v)-5
b(alues)28 b(ma)n(y)e(also)h(b)r(e)h(used)f(\(e.g.)37
b(if)28 b(y)n(ou)f(wish)g(to)h(distinguish)f(di\013eren)n(t)h(t)n(yp)r
-(es)g(of)427 2112 y(error\).)-2 2274 y Fd(T)-8 b(ransformation)33
-b(Flags)n(:)227 2420 y Fi(The)19 b(follo)n(wing)f(\015ags)f(are)h
-(de\014ned)h(in)g(the)g(\\ast.h")f(header)g(\014le)g(and)h(allo)n(w)f
-(y)n(ou)g(to)g(pro)n(vide)g(further)g(information)227
-2520 y(ab)r(out)27 b(the)g(nature)f(of)h(the)g(transformation)e
+(es)g(of)427 5672 y(error\).)p eop end
+%%Page: 267 277
+TeXDict begin 267 276 bop 3643 52 a FF(267)-2 351 y Fd(T)-8
+b(ransformation)33 b(Flags)n(:)227 497 y Fi(The)19 b(follo)n(wing)f
+(\015ags)f(are)h(de\014ned)h(in)g(the)g(\\ast.h")f(header)g(\014le)g
+(and)h(allo)n(w)f(y)n(ou)g(to)g(pro)n(vide)g(further)g(information)227
+597 y(ab)r(out)27 b(the)g(nature)f(of)h(the)g(transformation)e
(function.)37 b(Ha)n(ving)26 b(selected)g(the)h(set)g(of)f(\015ags)g
-(whic)n(h)h(apply)-7 b(,)26 b(y)n(ou)227 2620 y(should)i(supply)f(the)h
+(whic)n(h)h(apply)-7 b(,)26 b(y)n(ou)227 697 y(should)i(supply)f(the)h
(bit)n(wise)g(OR)f(of)h(their)f(v)-5 b(alues)27 b(as)g(the)h
(\\\015ags")e(argumen)n(t)h(to)g(astIn)n(traReg.)340
-2881 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(NOFWD:)38 b(If)g(this)f(\015ag)
-g(is)g(set,)i(it)f(indicates)f(that)h(the)f(transformation)f(function)i
-(do)r(es)f(not)427 2981 y(implemen)n(t)24 b(a)f(forw)n(ard)e(co)r
+968 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(NOFWD:)38 b(If)g(this)f(\015ag)g
+(is)g(set,)i(it)f(indicates)f(that)h(the)f(transformation)f(function)i
+(do)r(es)f(not)427 1068 y(implemen)n(t)24 b(a)f(forw)n(ard)e(co)r
(ordinate)h(transformation.)33 b(In)24 b(this)f(case,)g(an)n(y)f(In)n
-(traMap)g(whic)n(h)h(uses)g(it)g(will)427 3081 y(ha)n(v)n(e)i(a)g(T)-7
+(traMap)g(whic)n(h)h(uses)g(it)g(will)427 1167 y(ha)n(v)n(e)i(a)g(T)-7
b(ranF)g(orw)n(ard)22 b(attribute)k(v)-5 b(alue)25 b(of)h(zero)e(and)h
(the)h(transformation)e(function)i(itself)g(will)g(not)f(b)r(e)427
-3180 y(in)n(v)n(ok)n(ed)i(with)j(its)e(\\forw)n(ard")e(argumen)n(t)i
+1267 y(in)n(v)n(ok)n(ed)i(with)j(its)e(\\forw)n(ard")e(argumen)n(t)i
(set)g(to)h(a)f(non-zero)f(v)-5 b(alue.)40 b(By)28 b(default,)i(it)f
-(is)f(assumed)g(that)427 3280 y(a)f(forw)n(ard)f(transformation)g(is)i
-(pro)n(vided.)340 3413 y Fh(\017)45 b Fi(AST)p Ft(__)p
+(is)f(assumed)g(that)427 1367 y(a)f(forw)n(ard)f(transformation)g(is)i
+(pro)n(vided.)340 1503 y Fh(\017)45 b Fi(AST)p Ft(__)p
Fi(NOINV:)c(If)h(this)f(\015ag)f(is)h(set,)j(it)d(indicates)g(that)g
(the)g(transformation)f(function)h(do)r(es)g(not)427
-3513 y(implemen)n(t)34 b(an)g(in)n(v)n(erse)e(co)r(ordinate)g
+1603 y(implemen)n(t)34 b(an)g(in)n(v)n(erse)e(co)r(ordinate)g
(transformation.)53 b(In)34 b(this)g(case,)g(an)n(y)f(In)n(traMap)g
-(whic)n(h)g(uses)g(it)427 3612 y(will)26 b(ha)n(v)n(e)e(a)h(T)-7
+(whic)n(h)g(uses)g(it)427 1702 y(will)26 b(ha)n(v)n(e)e(a)h(T)-7
b(ranIn)n(v)n(erse)24 b(attribute)h(v)-5 b(alue)26 b(of)f(zero)g(and)g
(the)h(transformation)e(function)i(itself)g(will)g(not)427
-3712 y(b)r(e)g(in)n(v)n(ok)n(ed)d(with)i(its)h(\\forw)n(ard")c(argumen)
+1802 y(b)r(e)g(in)n(v)n(ok)n(ed)d(with)i(its)h(\\forw)n(ard")c(argumen)
n(t)i(set)h(to)f(zero.)35 b(By)25 b(default,)h(it)f(is)g(assumed)f
-(that)h(an)g(in)n(v)n(erse)427 3811 y(transformation)h(is)i(pro)n
-(vided.)340 3945 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(SIMPFI:)24
+(that)h(an)g(in)n(v)n(erse)427 1901 y(transformation)h(is)i(pro)n
+(vided.)340 2038 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(SIMPFI:)24
b(Y)-7 b(ou)25 b(ma)n(y)e(set)i(this)g(\015ag)e(if)i(applying)f(the)h
(transformation)e(function's)h(forw)n(ard)f(co)r(or-)427
-4044 y(dinate)k(transformation,)f(follo)n(w)n(ed)g(immediately)i(b)n(y)
+2137 y(dinate)k(transformation,)f(follo)n(w)n(ed)g(immediately)i(b)n(y)
e(the)i(matc)n(hing)f(in)n(v)n(erse)e(transformation,)h(should)427
-4144 y(alw)n(a)n(ys)j(restore)f(the)j(original)e(set)h(of)g(co)r
+2237 y(alw)n(a)n(ys)j(restore)f(the)j(original)e(set)h(of)g(co)r
(ordinates.)44 b(It)30 b(indicates)g(that)h(AST)g(ma)n(y)e(replace)g
-(suc)n(h)h(a)g(se-)427 4243 y(quence)19 b(of)h(op)r(erations)e(b)n(y)h
+(suc)n(h)h(a)g(se-)427 2337 y(quence)19 b(of)h(op)r(erations)e(b)n(y)h
(an)g(iden)n(tit)n(y)g(Mapping)g(\(a)g(UnitMap\))i(if)e(it)h(is)f
-(encoun)n(tered)g(while)g(simplifying)427 4343 y(a)26
+(encoun)n(tered)g(while)g(simplifying)427 2436 y(a)26
b(comp)r(ound)g(Mapping)g(\(e.g.)37 b(using)26 b(astSimplify\).)37
b(It)26 b(is)g(not)h(necessary)d(that)j(b)r(oth)g(transformations)427
-4443 y(ha)n(v)n(e)g(actually)g(b)r(een)h(implemen)n(ted.)340
-4576 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(SIMPIF:)27 b(Y)-7
+2536 y(ha)n(v)n(e)g(actually)g(b)r(een)h(implemen)n(ted.)340
+2672 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(SIMPIF:)27 b(Y)-7
b(ou)27 b(ma)n(y)f(set)h(this)g(\015ag)f(if)i(applying)e(the)h
(transformation)e(function's)j(in)n(v)n(erse)d(co)r(or-)427
-4675 y(dinate)f(transformation,)f(follo)n(w)n(ed)g(immediately)g(b)n(y)
+2772 y(dinate)f(transformation,)f(follo)n(w)n(ed)g(immediately)g(b)n(y)
h(the)g(matc)n(hing)f(forw)n(ard)f(transformation,)h(should)427
-4775 y(alw)n(a)n(ys)29 b(restore)f(the)j(original)e(set)h(of)g(co)r
+2872 y(alw)n(a)n(ys)29 b(restore)f(the)j(original)e(set)h(of)g(co)r
(ordinates.)44 b(It)30 b(indicates)g(that)h(AST)g(ma)n(y)e(replace)g
-(suc)n(h)h(a)g(se-)427 4875 y(quence)19 b(of)h(op)r(erations)e(b)n(y)h
+(suc)n(h)h(a)g(se-)427 2971 y(quence)19 b(of)h(op)r(erations)e(b)n(y)h
(an)g(iden)n(tit)n(y)g(Mapping)g(\(a)g(UnitMap\))i(if)e(it)h(is)f
-(encoun)n(tered)g(while)g(simplifying)427 4974 y(a)26
+(encoun)n(tered)g(while)g(simplifying)427 3071 y(a)26
b(comp)r(ound)g(Mapping)g(\(e.g.)37 b(using)26 b(astSimplify\).)37
b(It)26 b(is)g(not)h(necessary)d(that)j(b)r(oth)g(transformations)427
-5074 y(ha)n(v)n(e)g(actually)g(b)r(een)h(implemen)n(ted.)p
-0 5274 3780 12 v 0 5404 a Fz(astIn)l(v)l(ert)917 b Fe(In)m(v)m(ert)37
-b(a)i(Mapping)914 b Fz(astIn)l(v)l(ert)0 5593 y Fd(Description:)44
+3170 y(ha)n(v)n(e)g(actually)g(b)r(een)h(implemen)n(ted.)p
+0 3377 3780 12 v 0 3507 a Fz(astIn)l(v)l(ert)917 b Fe(In)m(v)m(ert)37
+b(a)i(Mapping)914 b Fz(astIn)l(v)l(ert)0 3703 y Fd(Description:)44
b Fi(This)28 b(function)g(in)n(v)n(erts)e(a)i(Mapping)f(b)n(y)g(rev)n
(ersing)e(the)j(b)r(o)r(olean)f(sense)g(of)h(its)g(In)n(v)n(ert)e
-(attribute.)37 b(If)227 5693 y(this)d(attribute)g(is)f(zero)g(\(the)h
+(attribute.)37 b(If)227 3803 y(this)d(attribute)g(is)f(zero)g(\(the)h
(default\),)i(the)e(Mapping)f(will)h(transform)e(co)r(ordinates)g(in)i
-(the)g(w)n(a)n(y)e(sp)r(eci\014ed)p eop end
-%%Page: 267 277
-TeXDict begin 267 276 bop 3643 52 a FF(267)227 351 y
-Fi(when)31 b(it)h(w)n(as)e(created.)46 b(If)31 b(it)g(is)g(non-zero,)f
-(the)h(input)h(and)f(output)g(co)r(ordinates)f(will)h(b)r(e)g(in)n
-(ter-c)n(hanged)e(so)227 451 y(that)24 b(the)f(direction)g(of)g(the)g
-(Mapping)g(is)g(rev)n(ersed.)34 b(This)23 b(will)g(cause)g(it)g(to)g
-(displa)n(y)g(the)g(in)n(v)n(erse)f(of)h(its)g(original)227
-551 y(b)r(eha)n(viour.)0 750 y Fd(Synopsis:)121 b Ft(void)42
-b(astInvert\()d(AstMapping)h Fh(\003)p Ft(this)h(\))0
-949 y Fd(P)m(arameters:)259 1135 y(this)427 1235 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(Mapping.)p 0 1484 3780 12 v 0 1615 a Fz(astIsA)p
-Fc(<)p Fz(Class)p Fc(>)175 b Fe(T)-10 b(est)38 b(mem)m(b)s(ership)g(of)
-g(a)g(class)h(b)m(y)f(an)1716 1730 y(Ob)7 b(ject)2916
-1615 y Fz(astIsA)p Fc(<)p Fz(Class)p Fc(>)0 1969 y Fd(Description:)44
-b Fi(This)26 b(is)f(a)g(family)g(of)g(functions)h(whic)n(h)f(test)g
-(whether)h(an)f(Ob)5 b(ject)25 b(is)g(a)g(mem)n(b)r(er)g(of)g(the)h
-(class)e(called)227 2068 y Fk(<)p Fi(Class)p Fk(>)p Fi(,)i(or)h(of)g
-(an)n(y)g(class)g(deriv)n(ed)g(from)g(it.)0 2267 y Fd(Synopsis:)121
-b Ft(int)42 b(astIsA)p Fk(<)p Ft(Class)p Fk(>)p Ft(\()c(const)j(Ast)p
-Fk(<)p Ft(Class)p Fk(>)f Fh(\003)p Ft(this)h(\))0 2467
-y Fd(P)m(arameters:)259 2653 y(this)427 2752 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(Ob)5 b(ject.)0 2964 y Fd(Class)31 b(Applicabilit)m(y:)259
-3150 y(Ob)5 b(ject)427 3250 y Fi(These)28 b(functions)f(apply)h(to)f
-(all)h(Ob)5 b(jects.)0 3461 y Fd(Returned)32 b(V)-8 b(alue:)259
-3648 y(astIsA)p Fk(<)p Fd(Class)p Fk(>)p Fd(\(\))427
-3747 y Fi(One)21 b(if)h(the)g(Ob)5 b(ject)22 b(b)r(elongs)f(to)g(the)h
+(the)g(w)n(a)n(y)e(sp)r(eci\014ed)227 3902 y(when)f(it)h(w)n(as)e
+(created.)46 b(If)31 b(it)g(is)g(non-zero,)f(the)h(input)h(and)f
+(output)g(co)r(ordinates)f(will)h(b)r(e)g(in)n(ter-c)n(hanged)e(so)227
+4002 y(that)24 b(the)f(direction)g(of)g(the)g(Mapping)g(is)g(rev)n
+(ersed.)34 b(This)23 b(will)g(cause)g(it)g(to)g(displa)n(y)g(the)g(in)n
+(v)n(erse)f(of)h(its)g(original)227 4101 y(b)r(eha)n(viour.)0
+4258 y Fd(Synopsis:)121 b Ft(void)42 b(astInvert\()d(AstMapping)h
+Fh(\003)p Ft(this)h(\))0 4414 y Fd(P)m(arameters:)259
+4558 y(this)427 4657 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Mapping.)p
+0 4864 V 0 4995 a Fz(astIsA)p Fc(<)p Fz(Class)p Fc(>)175
+b Fe(T)-10 b(est)38 b(mem)m(b)s(ership)g(of)g(a)g(class)h(b)m(y)f(an)
+1716 5110 y(Ob)7 b(ject)2916 4995 y Fz(astIsA)p Fc(<)p
+Fz(Class)p Fc(>)0 5306 y Fd(Description:)44 b Fi(This)26
+b(is)f(a)g(family)g(of)g(functions)h(whic)n(h)f(test)g(whether)h(an)f
+(Ob)5 b(ject)25 b(is)g(a)g(mem)n(b)r(er)g(of)g(the)h(class)e(called)227
+5406 y Fk(<)p Fi(Class)p Fk(>)p Fi(,)i(or)h(of)g(an)n(y)g(class)g
+(deriv)n(ed)g(from)g(it.)0 5562 y Fd(Synopsis:)121 b
+Ft(int)42 b(astIsA)p Fk(<)p Ft(Class)p Fk(>)p Ft(\()c(const)j(Ast)p
+Fk(<)p Ft(Class)p Fk(>)f Fh(\003)p Ft(this)h(\))0 5718
+y Fd(P)m(arameters:)p eop end
+%%Page: 268 278
+TeXDict begin 268 277 bop 0 52 a FF(268)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(this)427
+451 y Fi(P)n(oin)n(ter)c(to)i(the)g(Ob)5 b(ject.)0 609
+y Fd(Class)31 b(Applicabilit)m(y:)259 742 y(Ob)5 b(ject)427
+842 y Fi(These)28 b(functions)f(apply)h(to)f(all)h(Ob)5
+b(jects.)0 1000 y Fd(Returned)32 b(V)-8 b(alue:)259 1133
+y(astIsA)p Fk(<)p Fd(Class)p Fk(>)p Fd(\(\))427 1233
+y Fi(One)21 b(if)h(the)g(Ob)5 b(ject)22 b(b)r(elongs)f(to)g(the)h
(class)e(called)h Fk(<)p Fi(Class)p Fk(>)f Fi(\(or)h(to)h(a)f(class)f
-(deriv)n(ed)h(from)g(it\),)j(otherwise)427 3847 y(zero.)0
-4059 y Fd(Examples:)227 4246 y Fp(member)46 b(=)i(astIsAFrame\()c(obj)j
-(\);)427 4344 y Fi(T)-7 b(ests)31 b(whether)f(Ob)5 b(ject)31
+(deriv)n(ed)h(from)g(it\),)j(otherwise)427 1332 y(zero.)0
+1491 y Fd(Examples:)227 1625 y Fp(member)46 b(=)i(astIsAFrame\()c(obj)j
+(\);)427 1723 y Fi(T)-7 b(ests)31 b(whether)f(Ob)5 b(ject)31
b Ft(")p Fi(ob)5 b(j)p Ft(")30 b Fi(is)g(a)g(mem)n(b)r(er)h(of)g(the)g
(F)-7 b(rame)30 b(class,)h(or)e(of)i(an)n(y)f(class)g(deriv)n(ed)g
-(from)g(a)427 4444 y(F)-7 b(rame.)0 4656 y Fd(Notes:)340
-4988 y Fh(\017)45 b Fi(Ev)n(ery)31 b(AST)i(class)e(pro)n(vides)g(a)h
+(from)g(a)427 1823 y(F)-7 b(rame.)0 1981 y Fd(Notes:)340
+2260 y Fh(\017)45 b Fi(Ev)n(ery)31 b(AST)i(class)e(pro)n(vides)g(a)h
(function)h(\(astIsA)p Fk(<)p Fi(Class)p Fk(>)p Fi(\))e(of)h(this)h
(form,)g(where)f Fk(<)p Fi(Class)p Fk(>)f Fi(should)427
-5087 y(b)r(e)d(replaced)f(b)n(y)g(the)h(class)f(name.)340
-5245 y Fh(\017)45 b Fi(This)30 b(function)h(attempts)f(to)g(execute)g
+2360 y(b)r(e)d(replaced)f(b)n(y)g(the)h(class)f(name.)340
+2489 y Fh(\017)45 b Fi(This)30 b(function)h(attempts)f(to)g(execute)g
(ev)n(en)g(if)g(the)g(AST)h(error)d(status)i(is)g(set)g(on)f(en)n(try)
--7 b(,)31 b(although)e(no)427 5345 y(further)f(error)d(rep)r(ort)i
+-7 b(,)31 b(although)e(no)427 2589 y(further)f(error)d(rep)r(ort)i
(will)h(b)r(e)g(made)f(if)i(it)f(subsequen)n(tly)f(fails)g(under)h
-(these)f(circumstances.)340 5503 y Fh(\017)45 b Fi(A)31
+(these)f(circumstances.)340 2718 y Fh(\017)45 b Fi(A)31
b(v)-5 b(alue)31 b(of)g(zero)f(will)h(b)r(e)g(returned)g(if)g(this)g
(function)h(should)e(fail)h(for)g(an)n(y)f(reason.)45
-b(In)31 b(particular,)f(it)427 5602 y(will)e(fail)g(if)g(the)g(p)r(oin)
+b(In)31 b(particular,)f(it)427 2818 y(will)e(fail)g(if)g(the)g(p)r(oin)
n(ter)f(supplied)h(do)r(es)f(not)h(iden)n(tify)g(an)f(Ob)5
-b(ject)28 b(of)f(an)n(y)g(sort.)p eop end
-%%Page: 268 278
-TeXDict begin 268 277 bop 0 52 a FF(268)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 482 a Fz(astKeyMap)760 b Fe(Create)37 b(a)h(KeyMap)758
-b Fz(astKeyMap)0 675 y Fd(Description:)44 b Fi(This)19
+b(ject)28 b(of)f(an)n(y)g(sort.)p 0 3010 3780 12 v 0
+3141 a Fz(astKeyMap)1435 3140 y Fe(Create)37 b(a)h(KeyMap)3103
+3141 y Fz(astKeyMap)0 3322 y Fd(Description:)44 b Fi(This)19
b(function)g(creates)f(a)g(new)h(empt)n(y)g(KeyMap)e(and)i(optionally)f
(initialises)g(its)h(attributes.)34 b(En)n(tries)227
-775 y(can)27 b(then)i(b)r(e)f(added)f(to)h(the)f(KeyMap)g(using)g(the)h
-(astMapPut0)p Fk(<)p Fi(X)p Fk(>)e Fi(and)i(astMapPut1)p
-Fk(<)p Fi(X)p Fk(>)d Fi(functions.)227 902 y(The)20 b(KeyMap)e(class)h
-(is)g(used)h(to)f(store)g(a)g(set)g(of)h(v)-5 b(alues)19
-b(with)h(asso)r(ciated)e(k)n(eys)g(whic)n(h)i(iden)n(tify)g(the)g(v)-5
-b(alues.)34 b(The)227 1001 y(k)n(eys)28 b(are)g(strings.)41
+3422 y(can)27 b(then)i(b)r(e)f(added)f(to)h(the)f(KeyMap)g(using)g(the)
+h(astMapPut0)p Fk(<)p Fi(X)p Fk(>)e Fi(and)i(astMapPut1)p
+Fk(<)p Fi(X)p Fk(>)d Fi(functions.)227 3545 y(The)20
+b(KeyMap)e(class)h(is)g(used)h(to)f(store)g(a)g(set)g(of)h(v)-5
+b(alues)19 b(with)h(asso)r(ciated)e(k)n(eys)g(whic)n(h)i(iden)n(tify)g
+(the)g(v)-5 b(alues.)34 b(The)227 3645 y(k)n(eys)28 b(are)g(strings.)41
b(These)28 b(ma)n(y)h(b)r(e)g(case)f(sensitiv)n(e)h(or)f(insensitiv)n
(e)g(as)h(selected)g(b)n(y)f(the)i(KeyCase)d(attribute,)227
-1101 y(and)33 b(trailing)e(spaces)h(are)f(ignored.)50
+3744 y(and)33 b(trailing)e(spaces)h(are)f(ignored.)50
b(The)33 b(v)-5 b(alue)32 b(asso)r(ciated)f(with)i(a)f(k)n(ey)g(can)g
-(b)r(e)h(in)n(teger)e(\(signed)i(4)f(and)g(2)227 1201
+(b)r(e)h(in)n(teger)e(\(signed)i(4)f(and)g(2)227 3844
y(b)n(yte,)26 b(or)f(unsigned)h(1)f(b)n(yte\),)i(\015oating)e(p)r(oin)n
(t)h(\(single)f(or)g(double)h(precision\),)g(v)n(oid)f(p)r(oin)n(ter,)h
-(c)n(haracter)d(string)227 1300 y(or)33 b(AST)i(Ob)5
+(c)n(haracter)d(string)227 3943 y(or)33 b(AST)i(Ob)5
b(ject)33 b(p)r(oin)n(ter.)56 b(Eac)n(h)32 b(v)-5 b(alue)34
b(can)g(b)r(e)g(a)g(scalar)e(or)h(a)g(one-dimensional)g(v)n(ector.)54
-b(A)35 b(KeyMap)e(is)227 1400 y(conceptually)21 b(similar)g(to)g(a)h
+b(A)35 b(KeyMap)e(is)227 4043 y(conceptually)21 b(similar)g(to)g(a)h
(Mapping)f(in)h(that)f(a)h(KeyMap)e(transforms)g(an)i(input)g(in)n(to)f
-(an)g(output)i(-)e(the)h(input)227 1499 y(is)28 b(the)f(k)n(ey)-7
+(an)g(output)i(-)e(the)h(input)227 4143 y(is)28 b(the)f(k)n(ey)-7
b(,)27 b(and)h(the)g(output)g(is)f(the)h(v)-5 b(alue)27
b(asso)r(ciated)f(with)i(the)g(k)n(ey)-7 b(.)36 b(Ho)n(w)n(ev)n(er,)26
-b(this)i(is)f(only)g(a)g(conceptual)227 1599 y(similarit)n(y)-7
+b(this)i(is)f(only)g(a)g(conceptual)227 4242 y(similarit)n(y)-7
b(,)24 b(and)f(it)h(should)g(b)r(e)g(noted)f(that)h(the)g(KeyMap)f
(class)f(inherits)i(from)f(the)h(Ob)5 b(ject)23 b(class)g(rather)f
-(than)227 1699 y(the)28 b(Mapping)f(class.)36 b(The)28
+(than)227 4342 y(the)28 b(Mapping)f(class.)36 b(The)28
b(metho)r(ds)g(of)f(the)h(Mapping)g(class)e(cannot)h(b)r(e)h(used)g
-(with)g(a)f(KeyMap.)0 1853 y Fd(Synopsis:)121 b Ft(AstKeyMap)40
+(with)g(a)f(KeyMap.)0 4488 y Fd(Synopsis:)121 b Ft(AstKeyMap)40
b Fh(\003)p Ft(astKeyMap\()f(const)i(char)h Fh(\003)p
-Ft(options,)e(...)86 b(\))0 2007 y Fd(P)m(arameters:)259
-2148 y(options)427 2247 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n
+Ft(options,)e(...)86 b(\))0 4634 y Fd(P)m(arameters:)259
+4767 y(options)427 4866 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n
(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 2347 y(assignmen)n(ts)d
+(comma-separated)e(list)i(of)g(attribute)427 4966 y(assignmen)n(ts)d
(to)g(b)r(e)i(used)e(for)h(initialising)f(the)i(new)e(KeyMap.)36
b(The)26 b(syn)n(tax)f(used)g(is)h(iden)n(tical)g(to)f(that)427
-2446 y(for)h(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
+5066 y(for)h(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n
(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-2546 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 2681
-y Fd(...)427 2781 y Fi(If)38 b(the)g Ft(")p Fi(options)p
+5165 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 5295
+y Fd(...)427 5394 y Fi(If)38 b(the)g Ft(")p Fi(options)p
Ft(")e Fi(string)h(con)n(tains)f Ft(")p Fi(\045)p Ft(")h
Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g(list)h(of)f
-(additional)427 2880 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
+(additional)427 5494 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
(order)e(to)h(supply)h(v)-5 b(alues)27 b(to)g(b)r(e)h(substituted)h
-(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 2980 y(rules)25
+(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 5593 y(rules)25
b(for)f(supplying)h(these)g(are)f(iden)n(tical)h(to)g(those)g(for)f
(the)h(astSet)g(function)h(\(and)f(for)g(the)g(C)g Ft(")p
-Fi(prin)n(tf)p Ft(")427 3080 y Fi(function\).)0 3246
-y Fd(Returned)32 b(V)-8 b(alue:)259 3387 y(astKeyMap\(\))427
-3487 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(KeyMap.)0
-3653 y Fd(Notes:)340 3940 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
-b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
-(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 4040 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)-2 4206 y Fd(Status)33
-b(Handling)n(:)227 4352 y Fi(The)d(protected)g(in)n(terface)f(to)g
-(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
-(of)g(the)g(parameter)227 4452 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
-(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
-(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
-Fi(in)n(t)227 4551 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p
-0 4755 V 0 4887 a Fz(astLinearAppro)l(x)515 b Fe(Obtain)37
-b(a)i(linear)1138 4987 y(appro)m(ximation)34 b(to)j(a)h(Mapping,)1540
-5101 y(if)h(appropriate)2794 4887 y Fz(astLinearAppro)l(x)0
-5295 y Fd(Description:)44 b Fi(This)38 b(function)g(tests)g(the)f(forw)
+Fi(prin)n(tf)p Ft(")427 5693 y Fi(function\).)p eop end
+%%Page: 269 279
+TeXDict begin 269 278 bop 3643 52 a FF(269)0 351 y Fd(Returned)32
+b(V)-8 b(alue:)259 482 y(astKeyMap\(\))427 582 y Fi(A)28
+b(p)r(oin)n(ter)f(to)h(the)g(new)g(KeyMap.)0 739 y Fd(Notes:)340
+1016 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
+b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g
+(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427
+1116 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
+(for)f(an)n(y)g(reason.)-2 1272 y Fd(Status)33 b(Handling)n(:)227
+1418 y Fi(The)d(protected)g(in)n(terface)f(to)g(this)h(function)h
+(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g(the)g
+(parameter)227 1518 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62
+b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)
+e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fi(in)n(t)227
+1617 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p 0 1806 3780
+12 v 0 1938 a Fz(astLinearAppro)l(x)515 b Fe(Obtain)37
+b(a)i(linear)1138 2037 y(appro)m(ximation)34 b(to)j(a)h(Mapping,)1540
+2152 y(if)h(appropriate)2794 1938 y Fz(astLinearAppro)l(x)0
+2330 y Fd(Description:)44 b Fi(This)38 b(function)g(tests)g(the)f(forw)
n(ard)f(co)r(ordinate)h(transformation)e(implemen)n(ted)k(b)n(y)e(a)g
-(Mapping)227 5394 y(o)n(v)n(er)28 b(a)i(giv)n(en)f(range)f(of)i(input)g
+(Mapping)227 2430 y(o)n(v)n(er)28 b(a)i(giv)n(en)f(range)f(of)i(input)g
(co)r(ordinates.)42 b(If)30 b(the)h(transformation)d(is)h(found)h(to)g
-(b)r(e)g(linear)f(to)h(a)f(sp)r(eci\014ed)227 5494 y(lev)n(el)g(of)h
+(b)r(e)g(linear)f(to)h(a)f(sp)r(eci\014ed)227 2530 y(lev)n(el)g(of)h
(accuracy)-7 b(,)29 b(then)h(an)f(arra)n(y)e(of)j(\014t)g(co)r
(e\016cien)n(ts)f(is)h(returned.)42 b(These)30 b(ma)n(y)f(b)r(e)h(used)
-f(to)h(implemen)n(t)g(a)227 5593 y(linear)23 b(appro)n(ximation)e(to)i
+f(to)h(implemen)n(t)g(a)227 2629 y(linear)23 b(appro)n(ximation)e(to)i
(the)h(Mapping's)e(forw)n(ard)g(transformation)f(within)j(the)g(sp)r
-(eci\014ed)f(range)f(of)h(output)227 5693 y(co)r(ordinates.)36
+(eci\014ed)f(range)f(of)h(output)227 2729 y(co)r(ordinates.)36
b(If)28 b(the)g(transformation)e(is)h(not)h(su\016cien)n(tly)f(linear,)
-g(no)h(co)r(e\016cien)n(ts)f(are)f(returned.)p eop end
-%%Page: 269 279
-TeXDict begin 269 278 bop 3643 52 a FF(269)0 351 y Fd(Synopsis:)121
-b Ft(int)42 b(astLinearApprox\()37 b(AstMapping)j Fh(\003)p
-Ft(this,)h(const)g(double)g Fh(\003)p Ft(lbnd,)g(const)h(double)f
-Fh(\003)p Ft(ubnd,)227 451 y(double)g(tol,)h(double)f
-Fh(\003)p Ft(fit)h(\))0 593 y Fd(P)m(arameters:)259 722
-y(this)427 822 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Mapping.)259
-947 y Fd(lbnd)427 1047 y Fi(P)n(oin)n(ter)d(to)h(an)f(arra)n(y)f(of)i
+g(no)h(co)r(e\016cien)n(ts)f(are)f(returned.)0 2873 y
+Fd(Synopsis:)121 b Ft(int)42 b(astLinearApprox\()37 b(AstMapping)j
+Fh(\003)p Ft(this,)h(const)g(double)g Fh(\003)p Ft(lbnd,)g(const)h
+(double)f Fh(\003)p Ft(ubnd,)227 2973 y(double)g(tol,)h(double)f
+Fh(\003)p Ft(fit)h(\))0 3117 y Fd(P)m(arameters:)259
+3248 y(this)427 3348 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Mapping.)259
+3475 y Fd(lbnd)427 3575 y Fi(P)n(oin)n(ter)d(to)h(an)f(arra)n(y)f(of)i
(doubles)g(con)n(taining)f(the)h(lo)n(w)n(er)f(b)r(ounds)h(of)g(a)g(b)r
-(o)n(x)f(de\014ned)i(within)f(the)h(input)427 1146 y(co)r(ordinate)k
+(o)n(x)f(de\014ned)i(within)f(the)h(input)427 3674 y(co)r(ordinate)k
(system)h(of)g(the)g(Mapping.)50 b(The)32 b(n)n(um)n(b)r(er)f(of)h
(elemen)n(ts)g(in)g(this)g(arra)n(y)e(should)i(equal)f(the)427
-1246 y(v)-5 b(alue)25 b(of)f(the)h(Mapping's)f(Nin)h(attribute.)36
+3774 y(v)-5 b(alue)25 b(of)f(the)h(Mapping's)f(Nin)h(attribute.)36
b(This)25 b(b)r(o)n(x)f(should)g(sp)r(ecify)h(the)g(region)e(o)n(v)n
-(er)g(whic)n(h)h(linearit)n(y)427 1346 y(is)k(required.)259
-1471 y Fd(ubnd)427 1571 y Fi(P)n(oin)n(ter)f(to)h(an)g(arra)n(y)e(of)j
+(er)g(whic)n(h)h(linearit)n(y)427 3874 y(is)k(required.)259
+4001 y Fd(ubnd)427 4101 y Fi(P)n(oin)n(ter)f(to)h(an)g(arra)n(y)e(of)j
(doubles)f(con)n(taining)f(the)i(upp)r(er)f(b)r(ounds)h(of)f(the)h(b)r
-(o)n(x)f(sp)r(ecifying)g(the)h(region)427 1670 y(o)n(v)n(er)d(whic)n(h)
-i(linearit)n(y)e(is)i(required.)259 1796 y Fd(tol)427
-1895 y Fi(The)d(maxim)n(um)f(p)r(ermitted)i(deviation)e(from)g
+(o)n(x)f(sp)r(ecifying)g(the)h(region)427 4200 y(o)n(v)n(er)d(whic)n(h)
+i(linearit)n(y)e(is)i(required.)259 4328 y Fd(tol)427
+4428 y Fi(The)d(maxim)n(um)f(p)r(ermitted)i(deviation)e(from)g
(linearit)n(y)-7 b(,)24 b(expressed)g(as)g(a)g(p)r(ositiv)n(e)g
-(Cartesian)f(displace-)427 1995 y(men)n(t)30 b(in)f(the)h(output)g(co)r
+(Cartesian)f(displace-)427 4527 y(men)n(t)30 b(in)f(the)h(output)g(co)r
(ordinate)e(space)h(of)g(the)h(Mapping.)42 b(If)29 b(a)g(linear)g
-(\014t)h(to)f(the)h(forw)n(ard)d(transfor-)427 2095 y(mation)j(of)f
+(\014t)h(to)f(the)h(forw)n(ard)d(transfor-)427 4627 y(mation)j(of)f
(the)h(Mapping)g(deviates)f(from)g(the)h(true)g(transformation)e(b)n(y)
-h(more)g(than)h(this)g(amoun)n(t)f(at)427 2194 y(an)n(y)e(p)r(oin)n(t)h
+h(more)g(than)h(this)g(amoun)n(t)f(at)427 4727 y(an)n(y)e(p)r(oin)n(t)h
(whic)n(h)f(is)h(tested,)g(then)g(no)f(\014t)h(co)r(e\016cien)n(ts)g
-(will)f(b)r(e)h(returned.)259 2320 y Fd(\014t)427 2419
+(will)f(b)r(e)h(returned.)259 4854 y Fd(\014t)427 4954
y Fi(P)n(oin)n(ter)23 b(to)i(an)g(arra)n(y)d(of)j(doubles)f(in)i(whic)n
(h)e(to)h(return)f(the)i(co-e\016cien)n(ts)d(of)i(the)g(linear)f(appro)
-n(ximation)427 2519 y(to)40 b(the)g(sp)r(eci\014ed)f(transformation.)72
+n(ximation)427 5053 y(to)40 b(the)g(sp)r(eci\014ed)f(transformation.)72
b(This)39 b(arra)n(y)e(should)j(ha)n(v)n(e)e(at)h(least)h
Ft(")p Fi(\()f(Nin)h(+)f(1)h(\))g Fh(\003)f Fi(Nout)p
-Ft(")p Fi(,)427 2619 y(elemen)n(ts.)45 b(The)31 b(\014rst)f(Nout)g
+Ft(")p Fi(,)427 5153 y(elemen)n(ts.)45 b(The)31 b(\014rst)f(Nout)g
(elemen)n(ts)h(hold)f(the)g(constan)n(t)g(o\013sets)g(for)g(the)h
-(transformation)d(outputs.)427 2718 y(The)k(remaining)f(elemen)n(ts)h
+(transformation)d(outputs.)427 5253 y(The)k(remaining)f(elemen)n(ts)h
(hold)g(the)h(gradien)n(ts.)48 b(So)32 b(if)g(the)h(Mapping)e(has)h(2)f
-(inputs)i(and)f(3)f(outputs)427 2818 y(the)d(linear)f(appro)n(ximation)
-f(to)h(the)h(forw)n(ard)e(transformation)g(is:)427 2930
+(inputs)i(and)f(3)f(outputs)427 5352 y(the)d(linear)f(appro)n(ximation)
+f(to)h(the)h(forw)n(ard)e(transformation)g(is:)427 5466
y(X)p Ft(_)p Fi(out)i(=)f(\014t[0])h(+)f(\014t[3])p Fh(\003)p
Fi(X)p Ft(_)p Fi(in)g(+)g(\014t[4])p Fh(\003)p Fi(Y)p
-Ft(_)p Fi(in)427 3043 y(Y)p Ft(_)p Fi(out)h(=)f(\014t[1])h(+)f
+Ft(_)p Fi(in)427 5579 y(Y)p Ft(_)p Fi(out)h(=)f(\014t[1])h(+)f
(\014t[5])p Fh(\003)p Fi(X)p Ft(_)p Fi(in)g(+)g(\014t[6])p
-Fh(\003)p Fi(Y)p Ft(_)p Fi(in)427 3156 y(Z)p Ft(_)p Fi(out)g(=)g
+Fh(\003)p Fi(Y)p Ft(_)p Fi(in)427 5693 y(Z)p Ft(_)p Fi(out)g(=)g
(\014t[2])h(+)f(\014t[7])p Fh(\003)p Fi(X)p Ft(_)p Fi(in)h(+)f
-(\014t[8])p Fh(\003)p Fi(Y)p Ft(_)p Fi(in)0 3310 y Fd(Returned)32
-b(V)-8 b(alue:)259 3439 y(astLinearAppro)m(x\(\))427
-3539 y Fi(If)33 b(the)f(forw)n(ard)f(transformation)f(is)i(su\016cien)n
-(tly)g(linear,)h(a)e(non-zero)g(v)-5 b(alue)32 b(is)g(returned.)49
-b(Otherwise)427 3638 y(zero)27 b(is)g(returned)g(and)h(the)g(\014t)g
-(co-e\016cien)n(ts)e(are)h(set)h(to)f(AST)p Ft(__)p Fi(BAD.)0
-3793 y Fd(Notes:)340 4068 y Fh(\017)45 b Fi(This)31 b(function)g
-(\014ts)g(the)g(Mapping's)g(forw)n(ard)e(transformation.)44
-b(T)-7 b(o)31 b(\014t)g(the)g(in)n(v)n(erse)e(transformation,)427
-4168 y(the)f(Mapping)f(should)h(b)r(e)g(in)n(v)n(erted)f(using)g(astIn)
-n(v)n(ert)f(b)r(efore)h(in)n(v)n(oking)g(this)g(function.)340
-4293 y Fh(\017)45 b Fi(A)27 b(v)-5 b(alue)25 b(of)h(zero)f(will)h(b)r
-(e)g(returned)g(if)g(this)g(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j
-(the)f(global)f(error)f(status)h(set,)h(or)427 4393 y(if)i(it)g(should)
-g(fail)f(for)h(an)n(y)e(reason.)p 0 4577 3780 12 v 0
-4709 a Fz(astLo)t(c)l(k)239 b Fe(Lo)s(c)m(k)39 b(an)g(Ob)7
-b(ject)37 b(for)h(exclusiv)m(e)g(use)h(b)m(y)g(the)f(calling)1724
-4824 y(thread)3330 4709 y Fz(astLo)t(c)l(k)0 4974 y Fd(Description:)44
-b Fi(The)35 b(thread-safe)e(public)i(in)n(terface)e(to)h(AST)h(is)f
-(designed)g(so)g(that)g(an)g(error)f(is)h(rep)r(orted)g(if)g(an)n(y)227
-5074 y(thread)27 b(attempts)h(to)f(use)g(an)h(Ob)5 b(ject)27
-b(that)g(it)h(has)f(not)g(previously)g(lo)r(c)n(k)n(ed)f(for)h(its)h(o)
-n(wn)e(exclusiv)n(e)h(use)g(using)227 5174 y(this)34
-b(function.)56 b(When)34 b(an)f(Ob)5 b(ject)34 b(is)f(created,)i(it)f
-(is)f(initially)h(lo)r(c)n(k)n(ed)f(b)n(y)g(the)h(thread)f(that)h
-(creates)f(it,)i(so)227 5273 y(newly)27 b(created)g(ob)5
-b(jects)26 b(do)h(not)h(need)f(to)g(b)r(e)g(explicitly)h(lo)r(c)n(k)n
-(ed.)36 b(Ho)n(w)n(ev)n(er,)25 b(if)j(an)f(Ob)5 b(ject)27
-b(p)r(oin)n(ter)f(is)h(passed)227 5373 y(to)k(another)f(thread,)h(the)g
-(original)e(thread)i(m)n(ust)f(\014rst)h(unlo)r(c)n(k)f(it)h(\(using)g
-(astUnlo)r(c)n(k\))g(and)f(the)h(new)g(thread)227 5473
-y(m)n(ust)d(then)g(lo)r(c)n(k)f(it)h(\(using)g(astLo)r(c)n(k\))e(b)r
-(efore)i(the)g(new)f(thread)g(can)h(use)f(the)h(Ob)5
-b(ject.)227 5593 y(The)20 b Ft(")p Fi(w)n(ait)p Ft(")e
-Fi(parameter)g(determines)i(what)f(happ)r(ens)h(if)g(the)g(supplied)g
-(Ob)5 b(ject)19 b(is)h(curen)n(tly)f(lo)r(c)n(k)n(ed)f(b)n(y)i(another)
-227 5693 y(thread)27 b(when)h(this)g(function)g(is)g(in)n(v)n(ok)n(ed.)
-p eop end
+(\014t[8])p Fh(\003)p Fi(Y)p Ft(_)p Fi(in)p eop end
%%Page: 270 280
TeXDict begin 270 279 bop 0 52 a FF(270)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Synopsis:)121
-b Ft(void)42 b(astLock\()e(AstObject)g Fh(\003)p Ft(this,)h(int)h(wait)
-g(\))0 501 y Fd(P)m(arameters:)259 637 y(this)427 736
-y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5 b(ject)27 b(to)h(b)r(e)g(lo)r
-(c)n(k)n(ed.)259 869 y Fd(w)m(ait)427 969 y Fi(If)35
-b(the)g(Ob)5 b(ject)34 b(is)g(curen)n(tly)g(lo)r(c)n(k)n(ed)f(b)n(y)h
-(another)g(thread)f(then)i(this)g(function)g(will)f(either)g(rep)r(ort)
-g(an)427 1068 y(error)c(or)g(blo)r(c)n(k.)47 b(If)32
-b(a)e(non-zero)g(v)-5 b(alue)31 b(is)g(supplied)h(for)e
-Ft(")p Fi(w)n(ait)p Ft(")p Fi(,)h(the)h(calling)e(thread)h(w)n(aits)g
-(un)n(til)g(the)427 1168 y(ob)5 b(ject)36 b(is)g(a)n(v)-5
-b(ailable)35 b(for)h(it)g(to)g(use.)62 b(Otherwise,)38
-b(an)e(error)e(is)i(rep)r(orted)f(and)h(the)h(function)f(returns)427
-1268 y(immediately)28 b(without)g(lo)r(c)n(king)f(the)h(Ob)5
-b(ject.)0 1429 y Fd(Class)31 b(Applicabilit)m(y:)259
-1566 y(Ob)5 b(ject)427 1665 y Fi(This)28 b(function)g(applies)f(to)h
-(all)f(Ob)5 b(jects.)0 1827 y Fd(Notes:)340 2109 y Fh(\017)45
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Returned)i(V)-8
+b(alue:)259 472 y(astLinearAppro)m(x\(\))427 572 y Fi(If)33
+b(the)f(forw)n(ard)f(transformation)f(is)i(su\016cien)n(tly)g(linear,)h
+(a)e(non-zero)g(v)-5 b(alue)32 b(is)g(returned.)49 b(Otherwise)427
+672 y(zero)27 b(is)g(returned)g(and)h(the)g(\014t)g(co-e\016cien)n(ts)e
+(are)h(set)h(to)f(AST)p Ft(__)p Fi(BAD.)0 818 y Fd(Notes:)340
+1085 y Fh(\017)45 b Fi(This)31 b(function)g(\014ts)g(the)g(Mapping's)g
+(forw)n(ard)e(transformation.)44 b(T)-7 b(o)31 b(\014t)g(the)g(in)n(v)n
+(erse)e(transformation,)427 1185 y(the)f(Mapping)f(should)h(b)r(e)g(in)
+n(v)n(erted)f(using)g(astIn)n(v)n(ert)f(b)r(efore)h(in)n(v)n(oking)g
+(this)g(function.)340 1302 y Fh(\017)45 b Fi(A)27 b(v)-5
+b(alue)25 b(of)h(zero)f(will)h(b)r(e)g(returned)g(if)g(this)g(function)
+h(is)f(in)n(v)n(ok)n(ed)e(with)j(the)f(global)f(error)f(status)h(set,)h
+(or)427 1402 y(if)i(it)g(should)g(fail)f(for)h(an)n(y)e(reason.)p
+0 1571 3780 12 v 0 1702 a Fz(astLo)t(c)l(k)239 b Fe(Lo)s(c)m(k)39
+b(an)g(Ob)7 b(ject)37 b(for)h(exclusiv)m(e)g(use)h(b)m(y)g(the)f
+(calling)1724 1817 y(thread)3330 1702 y Fz(astLo)t(c)l(k)0
+1952 y Fd(Description:)44 b Fi(The)35 b(thread-safe)e(public)i(in)n
+(terface)e(to)h(AST)h(is)f(designed)g(so)g(that)g(an)g(error)f(is)h
+(rep)r(orted)g(if)g(an)n(y)227 2052 y(thread)27 b(attempts)h(to)f(use)g
+(an)h(Ob)5 b(ject)27 b(that)g(it)h(has)f(not)g(previously)g(lo)r(c)n(k)
+n(ed)f(for)h(its)h(o)n(wn)e(exclusiv)n(e)h(use)g(using)227
+2151 y(this)34 b(function.)56 b(When)34 b(an)f(Ob)5 b(ject)34
+b(is)f(created,)i(it)f(is)f(initially)h(lo)r(c)n(k)n(ed)f(b)n(y)g(the)h
+(thread)f(that)h(creates)f(it,)i(so)227 2251 y(newly)27
+b(created)g(ob)5 b(jects)26 b(do)h(not)h(need)f(to)g(b)r(e)g
+(explicitly)h(lo)r(c)n(k)n(ed.)36 b(Ho)n(w)n(ev)n(er,)25
+b(if)j(an)f(Ob)5 b(ject)27 b(p)r(oin)n(ter)f(is)h(passed)227
+2350 y(to)k(another)f(thread,)h(the)g(original)e(thread)i(m)n(ust)f
+(\014rst)h(unlo)r(c)n(k)f(it)h(\(using)g(astUnlo)r(c)n(k\))g(and)f(the)
+h(new)g(thread)227 2450 y(m)n(ust)d(then)g(lo)r(c)n(k)f(it)h(\(using)g
+(astLo)r(c)n(k\))e(b)r(efore)i(the)g(new)f(thread)g(can)h(use)f(the)h
+(Ob)5 b(ject.)227 2567 y(The)20 b Ft(")p Fi(w)n(ait)p
+Ft(")e Fi(parameter)g(determines)i(what)f(happ)r(ens)h(if)g(the)g
+(supplied)g(Ob)5 b(ject)19 b(is)h(curen)n(tly)f(lo)r(c)n(k)n(ed)f(b)n
+(y)i(another)227 2667 y(thread)27 b(when)h(this)g(function)g(is)g(in)n
+(v)n(ok)n(ed.)0 2801 y Fd(Synopsis:)121 b Ft(void)42
+b(astLock\()e(AstObject)g Fh(\003)p Ft(this,)h(int)h(wait)g(\))0
+2935 y Fd(P)m(arameters:)259 3056 y(this)427 3155 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(Ob)5 b(ject)27 b(to)h(b)r(e)g(lo)r(c)n(k)n(ed.)259
+3273 y Fd(w)m(ait)427 3373 y Fi(If)35 b(the)g(Ob)5 b(ject)34
+b(is)g(curen)n(tly)g(lo)r(c)n(k)n(ed)f(b)n(y)h(another)g(thread)f(then)
+i(this)g(function)g(will)f(either)g(rep)r(ort)g(an)427
+3472 y(error)c(or)g(blo)r(c)n(k.)47 b(If)32 b(a)e(non-zero)g(v)-5
+b(alue)31 b(is)g(supplied)h(for)e Ft(")p Fi(w)n(ait)p
+Ft(")p Fi(,)h(the)h(calling)e(thread)h(w)n(aits)g(un)n(til)g(the)427
+3572 y(ob)5 b(ject)36 b(is)g(a)n(v)-5 b(ailable)35 b(for)h(it)g(to)g
+(use.)62 b(Otherwise,)38 b(an)e(error)e(is)i(rep)r(orted)f(and)h(the)h
+(function)f(returns)427 3671 y(immediately)28 b(without)g(lo)r(c)n
+(king)f(the)h(Ob)5 b(ject.)0 3818 y Fd(Class)31 b(Applicabilit)m(y:)259
+3939 y(Ob)5 b(ject)427 4039 y Fi(This)28 b(function)g(applies)f(to)h
+(all)f(Ob)5 b(jects.)0 4185 y Fd(Notes:)340 4452 y Fh(\017)45
b Fi(The)28 b(astAnn)n(ul)g(function)h(is)f(exceptional)f(in)i(that)f
(it)h(can)e(b)r(e)i(used)f(on)g(p)r(oin)n(ters)f(for)h(Ob)5
-b(jects)27 b(that)i(are)427 2209 y(not)f(curren)n(tly)e(lo)r(c)n(k)n
+b(jects)27 b(that)i(are)427 4552 y(not)f(curren)n(tly)e(lo)r(c)n(k)n
(ed)h(b)n(y)g(the)h(calling)f(thread.)37 b(All)28 b(other)f(AST)h
-(functions)g(will)g(rep)r(ort)e(an)i(error.)340 2342
+(functions)g(will)g(rep)r(ort)e(an)i(error.)340 4670
y Fh(\017)45 b Fi(The)28 b(Lo)r(c)n(k)n(ed)e(ob)5 b(ject)28
b(will)g(b)r(elong)f(to)g(the)h(curren)n(t)f(AST)h(con)n(text.)340
-2474 y Fh(\017)45 b Fi(This)28 b(function)g(returns)f(without)h(action)
+4787 y Fh(\017)45 b Fi(This)28 b(function)g(returns)f(without)h(action)
f(if)h(the)g(Ob)5 b(ject)28 b(is)f(already)f(lo)r(c)n(k)n(ed)h(b)n(y)g
-(the)h(calling)f(thread.)340 2607 y Fh(\017)45 b Fi(If)32
+(the)h(calling)f(thread.)340 4905 y Fh(\017)45 b Fi(If)32
b(sim)n(ultaneous)f(use)h(of)g(the)g(same)f(ob)5 b(ject)32
b(is)f(required)g(b)n(y)g(t)n(w)n(o)g(or)g(more)g(threads,)h(astCop)n
-(y)f(should)427 2707 y(b)r(e)e(used)f(to)h(to)f(pro)r(duce)g(a)g(deep)g
+(y)f(should)427 5004 y(b)r(e)e(used)f(to)h(to)f(pro)r(duce)g(a)g(deep)g
(cop)n(y)f(of)i(the)g(Ob)5 b(ject)28 b(for)f(eac)n(h)h(thread.)39
-b(Eac)n(h)27 b(cop)n(y)g(should)h(then)h(b)r(e)427 2806
+b(Eac)n(h)27 b(cop)n(y)g(should)h(then)h(b)r(e)427 5104
y(unlo)r(c)n(k)n(ed)j(b)n(y)h(the)g(paren)n(t)f(thread)g(\(i.e.)53
b(the)33 b(thread)f(that)h(created)f(the)h(cop)n(y\),)g(and)g(then)g
-(lo)r(c)n(k)n(ed)f(b)n(y)427 2906 y(the)c(c)n(hild)g(thread)f(\(i.e.)37
+(lo)r(c)n(k)n(ed)f(b)n(y)427 5203 y(the)c(c)n(hild)g(thread)f(\(i.e.)37
b(the)28 b(thread)f(that)h(w)n(an)n(ts)f(to)g(use)h(the)g(cop)n(y\).)
-340 3039 y Fh(\017)45 b Fi(This)28 b(function)g(is)f(only)h(a)n(v)-5
-b(ailable)26 b(in)i(the)g(C)f(in)n(terface.)340 3171
+340 5321 y Fh(\017)45 b Fi(This)28 b(function)g(is)f(only)h(a)n(v)-5
+b(ailable)26 b(in)i(the)g(C)f(in)n(terface.)340 5439
y Fh(\017)45 b Fi(This)23 b(function)g(returns)g(without)g(action)f(if)
h(the)h(AST)f(library)e(has)i(b)r(een)g(built)g(without)h(POSIX)e
-(thread)427 3271 y(supp)r(ort)35 b(\(i.e.)60 b(the)35
+(thread)427 5538 y(supp)r(ort)35 b(\(i.e.)60 b(the)35
b Ft(")p Fi(-with-pthreads)p Ft(")e Fi(option)i(w)n(as)f(not)h(sp)r
(eci\014ed)g(when)h(running)e(the)i Ft(")p Fi(con\014gure)p
-Ft(")427 3370 y Fi(script\).)p 0 3569 3780 12 v 0 3700
-a Fz(astLutMap)799 b Fe(Create)37 b(a)i(LutMap)798 b
-Fz(astLutMap)0 3889 y Fd(Description:)44 b Fi(This)28
+Ft(")427 5638 y Fi(script\).)p eop end
+%%Page: 271 281
+TeXDict begin 271 280 bop 3643 52 a FF(271)p 0 351 3780
+12 v 0 482 a Fz(astLutMap)799 b Fe(Create)37 b(a)i(LutMap)798
+b Fz(astLutMap)0 667 y Fd(Description:)44 b Fi(This)28
b(function)g(creates)f(a)g(new)g(LutMap)h(and)g(optionally)e
-(initialises)i(its)f(attributes.)227 4013 y(A)i(LutMap)g(is)g(a)f(sp)r
+(initialises)i(its)f(attributes.)227 790 y(A)i(LutMap)g(is)g(a)f(sp)r
(ecialised)h(form)f(of)h(Mapping)f(whic)n(h)h(transforms)f
-(1-dimensional)f(co)r(ordinates)g(b)n(y)i(using)227 4113
+(1-dimensional)f(co)r(ordinates)g(b)n(y)i(using)227 890
y(linear)d(in)n(terp)r(olation)g(in)h(a)g(lo)r(okup)f(table.)37
b(Eac)n(h)25 b(input)j(co)r(ordinate)e(v)-5 b(alue)26
b(is)h(\014rst)g(scaled)f(to)g(giv)n(e)g(the)i(index)227
-4212 y(of)e(an)g(en)n(try)f(in)i(the)f(table)g(b)n(y)g(subtracting)f(a)
-h(starting)f(v)-5 b(alue)26 b(\(the)h(input)f(co)r(ordinate)f(corresp)r
-(onding)f(to)i(the)227 4312 y(\014rst)31 b(table)g(en)n(try\))f(and)h
+990 y(of)e(an)g(en)n(try)f(in)i(the)f(table)g(b)n(y)g(subtracting)f(a)h
+(starting)f(v)-5 b(alue)26 b(\(the)h(input)f(co)r(ordinate)f(corresp)r
+(onding)f(to)i(the)227 1089 y(\014rst)31 b(table)g(en)n(try\))f(and)h
(dividing)g(b)n(y)f(an)h(incremen)n(t)f(\(the)i(di\013erence)f(in)g
(input)g(co)r(ordinate)f(v)-5 b(alue)31 b(b)r(et)n(w)n(een)227
-4412 y(adjacen)n(t)c(table)h(en)n(tries\).)227 4536 y(The)j(resulting)g
+1189 y(adjacen)n(t)c(table)h(en)n(tries\).)227 1312 y(The)j(resulting)g
(index)g(will)g(usually)g(con)n(tain)f(a)h(fractional)f(part,)i(so)e
(the)i(output)f(co)r(ordinate)f(v)-5 b(alue)31 b(is)g(then)227
-4636 y(generated)f(b)n(y)g(in)n(terp)r(olating)f(linearly)h(b)r(et)n(w)
+1412 y(generated)f(b)n(y)g(in)n(terp)r(olating)f(linearly)h(b)r(et)n(w)
n(een)g(the)h(appropriate)d(en)n(tries)i(in)h(the)f(table.)46
-b(If)31 b(the)f(index)h(lies)227 4735 y(outside)h(the)h(range)e(of)h
+b(If)31 b(the)f(index)h(lies)227 1512 y(outside)h(the)h(range)e(of)h
(the)h(table,)g(linear)e(extrap)r(olation)g(is)h(used)h(based)e(on)h
(the)h(t)n(w)n(o)e(nearest)h(en)n(tries)f(\(i.e.)227
-4835 y(the)d(t)n(w)n(o)f(en)n(tries)g(at)g(the)h(start)f(or)g(end)h(of)
-g(the)g(table,)f(as)g(appropriate\).)227 4959 y(If)e(the)g(lo)r(okup)e
+1611 y(the)d(t)n(w)n(o)f(en)n(tries)g(at)g(the)h(start)f(or)g(end)h(of)
+g(the)g(table,)f(as)g(appropriate\).)227 1735 y(If)e(the)g(lo)r(okup)e
(table)i(en)n(tries)e(increase)g(or)h(decrease)f(monotonically)-7
b(,)23 b(then)i(the)g(in)n(v)n(erse)e(transformation)f(ma)n(y)227
-5059 y(also)27 b(b)r(e)h(p)r(erformed.)0 5208 y Fd(Synopsis:)121
+1835 y(also)27 b(b)r(e)h(p)r(erformed.)0 1982 y Fd(Synopsis:)121
b Ft(AstLutMap)40 b Fh(\003)p Ft(astLutMap\()f(int)j(nlut,)g(const)f
(double)g(lut[],)g(double)g(start,)g(double)h(inc,)227
-5308 y(const)g(char)g Fh(\003)p Ft(options,)e(...)85
-b(\))0 5457 y Fd(P)m(arameters:)259 5593 y(nlut)427 5693
+2082 y(const)g(char)g Fh(\003)p Ft(options,)e(...)85
+b(\))0 2229 y Fd(P)m(arameters:)259 2364 y(nlut)427 2463
y Fi(The)28 b(n)n(um)n(b)r(er)f(of)h(en)n(tries)f(in)h(the)g(lo)r(okup)
f(table.)37 b(This)27 b(v)-5 b(alue)28 b(m)n(ust)f(b)r(e)h(at)g(least)f
-(2.)p eop end
-%%Page: 271 281
-TeXDict begin 271 280 bop 3643 52 a FF(271)259 351 y
-Fd(lut)427 451 y Fi(An)28 b(arra)n(y)e(con)n(taining)g(the)i
-Ft(")p Fi(nlut)p Ft(")g Fi(lo)r(okup)f(table)g(en)n(tries.)259
-585 y Fd(start)427 684 y Fi(The)h(input)g(co)r(ordinate)f(v)-5
+(2.)259 2594 y Fd(lut)427 2694 y Fi(An)h(arra)n(y)e(con)n(taining)g
+(the)i Ft(")p Fi(nlut)p Ft(")g Fi(lo)r(okup)f(table)g(en)n(tries.)259
+2825 y Fd(start)427 2924 y Fi(The)h(input)g(co)r(ordinate)f(v)-5
b(alue)27 b(whic)n(h)h(corresp)r(onds)d(to)j(the)g(\014rst)f(lo)r(okup)
-g(table)h(en)n(try)-7 b(.)259 818 y Fd(inc)427 917 y
-Fi(The)24 b(lo)r(okup)g(table)f(spacing)g(\(the)i(incremen)n(t)f(in)g
+g(table)h(en)n(try)-7 b(.)259 3055 y Fd(inc)427 3155
+y Fi(The)24 b(lo)r(okup)g(table)f(spacing)g(\(the)i(incremen)n(t)f(in)g
(input)g(co)r(ordinate)f(v)-5 b(alue)24 b(b)r(et)n(w)n(een)g(successiv)
-n(e)e(lo)r(okup)427 1017 y(table)28 b(en)n(tries\).)36
+n(e)e(lo)r(okup)427 3254 y(table)28 b(en)n(tries\).)36
b(This)28 b(v)-5 b(alue)27 b(ma)n(y)g(b)r(e)h(p)r(ositiv)n(e)f(or)g
(negativ)n(e,)g(but)h(m)n(ust)g(not)f(b)r(e)h(zero.)259
-1151 y Fd(options)427 1250 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n
+3385 y Fd(options)427 3485 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n
(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 1350 y(assignmen)n(ts)e
+(comma-separated)e(list)i(of)g(attribute)427 3584 y(assignmen)n(ts)e
(to)h(b)r(e)g(used)g(for)f(initialising)h(the)g(new)g(LutMap.)37
b(The)26 b(syn)n(tax)g(used)h(is)g(iden)n(tical)g(to)f(that)427
-1450 y(for)g(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
+3684 y(for)g(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n
(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-1549 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 1683
-y Fd(...)427 1782 y Fi(If)38 b(the)g Ft(")p Fi(options)p
+3784 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 3915
+y Fd(...)427 4014 y Fi(If)38 b(the)g Ft(")p Fi(options)p
Ft(")e Fi(string)h(con)n(tains)f Ft(")p Fi(\045)p Ft(")h
Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g(list)h(of)f
-(additional)427 1882 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
+(additional)427 4114 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
(order)e(to)h(supply)h(v)-5 b(alues)27 b(to)g(b)r(e)h(substituted)h
-(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 1982 y(rules)25
+(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 4213 y(rules)25
b(for)f(supplying)h(these)g(are)f(iden)n(tical)h(to)g(those)g(for)f
(the)h(astSet)g(function)h(\(and)f(for)g(the)g(C)g Ft(")p
-Fi(prin)n(tf)p Ft(")427 2081 y Fi(function\).)0 2245
-y Fd(Returned)32 b(V)-8 b(alue:)259 2383 y(astLutMap\(\))427
-2482 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(LutMap.)0
-2646 y Fd(Notes:)340 2930 y Fh(\017)45 b Fi(If)38 b(the)f(en)n(tries)f
+Fi(prin)n(tf)p Ft(")427 4313 y Fi(function\).)0 4473
+y Fd(Returned)32 b(V)-8 b(alue:)259 4607 y(astLutMap\(\))427
+4707 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(LutMap.)0
+4867 y Fd(Notes:)340 5147 y Fh(\017)45 b Fi(If)38 b(the)f(en)n(tries)f
(in)h(the)h(lo)r(okup)e(table)h(either)g(increase)e(or)h(decrease)g
-(monotonically)-7 b(,)38 b(then)f(the)h(new)427 3030
+(monotonically)-7 b(,)38 b(then)f(the)h(new)427 5247
y(LutMap's)25 b(T)-7 b(ranIn)n(v)n(erse)23 b(attribute)j(will)f(ha)n(v)
n(e)f(a)h(v)-5 b(alue)25 b(of)g(one,)g(indicating)g(that)h(the)g(in)n
-(v)n(erse)d(transfor-)427 3129 y(mation)j(can)g(b)r(e)h(p)r(erformed.)
+(v)n(erse)d(transfor-)427 5347 y(mation)j(can)g(b)r(e)h(p)r(erformed.)
36 b(Otherwise,)25 b(it)i(will)g(ha)n(v)n(e)e(a)g(v)-5
b(alue)27 b(of)f(zero,)f(so)h(that)g(an)n(y)g(attempt)h(to)f(use)427
-3229 y(the)i(in)n(v)n(erse)e(transformation)g(will)i(result)f(in)h(an)g
-(error.)340 3363 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+5446 y(the)i(in)n(v)n(erse)e(transformation)g(will)i(result)f(in)h(an)g
+(error.)340 5577 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 3462 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)-2 3626 y Fd(Status)33
-b(Handling)n(:)227 3772 y Fi(The)d(protected)g(in)n(terface)f(to)g
-(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
-(of)g(the)g(parameter)227 3871 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
-(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
-(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
-Fi(in)n(t)227 3971 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p
-0 4172 3780 12 v 0 4303 a Fz(astMapBo)l(x)967 4304 y
-Fe(Find)39 b(a)g(b)s(ounding)f(b)s(o)m(x)g(for)g(a)g(Mapping)3111
-4303 y Fz(astMapBo)l(x)0 4494 y Fd(Description:)44 b
-Fi(This)23 b(function)h(allo)n(ws)e(y)n(ou)g(to)h(\014nd)g(the)h
-Ft(")p Fi(b)r(ounding)e(b)r(o)n(x)p Ft(")h Fi(whic)n(h)g(just)g
-(encloses)f(another)g(b)r(o)n(x)h(after)227 4594 y(it)38
-b(has)e(b)r(een)i(transformed)e(b)n(y)h(a)g(Mapping)f(\(using)h(either)
-g(its)h(forw)n(ard)d(or)h(in)n(v)n(erse)g(transformation\).)64
-b(A)227 4693 y(t)n(ypical)27 b(use)h(migh)n(t)f(b)r(e)h(to)g(calculate)
-f(the)h(size)f(of)h(an)f(image)g(after)g(b)r(eing)h(transformed)e(b)n
-(y)h(a)h(Mapping.)227 4819 y(The)f(function)h(w)n(orks)d(on)h(one)h
-(dimension)g(at)f(a)h(time.)37 b(When)28 b(supplied)f(with)g(the)g(lo)n
-(w)n(er)f(and)g(upp)r(er)h(b)r(ounds)227 4918 y(of)39
-b(a)f(rectangular)e(region)h(\(b)r(o)n(x\))i(of)f(input)i(co)r
-(ordinate)d(space,)k(it)d(\014nds)h(the)g(lo)n(w)n(est)e(and)i(highest)
-f(v)-5 b(alues)227 5018 y(tak)n(en)29 b(b)n(y)g(a)g(nominated)g(output)
-h(co)r(ordinate)e(within)j(that)e(region.)41 b(Optionally)-7
-b(,)29 b(it)h(also)e(returns)h(the)h(input)227 5118 y(co)r(ordinates)d
-(where)h(these)g(b)r(ounding)g(v)-5 b(alues)28 b(are)f(attained.)39
-b(It)28 b(should)g(b)r(e)h(used)f(rep)r(eatedly)f(to)h(obtain)g(the)227
-5217 y(exten)n(t)g(of)g(the)f(b)r(ounding)h(b)r(o)n(x)f(in)h(more)f
-(than)h(one)f(dimension.)0 5368 y Fd(Synopsis:)121 b
-Ft(void)42 b(astMapBox\()d(AstMapping)h Fh(\003)p Ft(this,)h(const)g
-(double)g(lbnd_in[],)f(const)h(double)g(ubnd_in[],)227
-5468 y(int)i(forward,)d(int)i(coord_out,)e(double)h Fh(\003)p
-Ft(lbnd_out,)e(double)i Fh(\003)p Ft(ubnd_out,)f(double)h(xl[],)g
-(double)227 5567 y(xu[])h(\);)0 5718 y Fd(P)m(arameters:)p
-eop end
+427 5677 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p eop end
%%Page: 272 282
TeXDict begin 272 281 bop 0 52 a FF(272)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(this)427
-451 y Fi(P)n(oin)n(ter)c(to)i(the)g(Mapping.)259 580
-y Fd(lbnd)p Ft(_)p Fd(in)427 679 y Fi(P)n(oin)n(ter)33
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)-2 351 y Fd(Status)j(Handling)n(:)
+227 497 y Fi(The)d(protected)g(in)n(terface)f(to)g(this)h(function)h
+(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g(the)g
+(parameter)227 597 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62
+b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)
+e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fi(in)n(t)227
+697 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p 0 891 3780
+12 v 0 1022 a Fz(astMapBo)l(x)967 1023 y Fe(Find)39 b(a)g(b)s(ounding)f
+(b)s(o)m(x)g(for)g(a)g(Mapping)3111 1022 y Fz(astMapBo)l(x)0
+1207 y Fd(Description:)44 b Fi(This)23 b(function)h(allo)n(ws)e(y)n(ou)
+g(to)h(\014nd)g(the)h Ft(")p Fi(b)r(ounding)e(b)r(o)n(x)p
+Ft(")h Fi(whic)n(h)g(just)g(encloses)f(another)g(b)r(o)n(x)h(after)227
+1307 y(it)38 b(has)e(b)r(een)i(transformed)e(b)n(y)h(a)g(Mapping)f
+(\(using)h(either)g(its)h(forw)n(ard)d(or)h(in)n(v)n(erse)g
+(transformation\).)64 b(A)227 1407 y(t)n(ypical)27 b(use)h(migh)n(t)f
+(b)r(e)h(to)g(calculate)f(the)h(size)f(of)h(an)f(image)g(after)g(b)r
+(eing)h(transformed)e(b)n(y)h(a)h(Mapping.)227 1530 y(The)f(function)h
+(w)n(orks)d(on)h(one)h(dimension)g(at)f(a)h(time.)37
+b(When)28 b(supplied)f(with)g(the)g(lo)n(w)n(er)f(and)g(upp)r(er)h(b)r
+(ounds)227 1630 y(of)39 b(a)f(rectangular)e(region)h(\(b)r(o)n(x\))i
+(of)f(input)i(co)r(ordinate)d(space,)k(it)d(\014nds)h(the)g(lo)n(w)n
+(est)e(and)i(highest)f(v)-5 b(alues)227 1729 y(tak)n(en)29
+b(b)n(y)g(a)g(nominated)g(output)h(co)r(ordinate)e(within)j(that)e
+(region.)41 b(Optionally)-7 b(,)29 b(it)h(also)e(returns)h(the)h(input)
+227 1829 y(co)r(ordinates)d(where)h(these)g(b)r(ounding)g(v)-5
+b(alues)28 b(are)f(attained.)39 b(It)28 b(should)g(b)r(e)h(used)f(rep)r
+(eatedly)f(to)h(obtain)g(the)227 1928 y(exten)n(t)g(of)g(the)f(b)r
+(ounding)h(b)r(o)n(x)f(in)h(more)f(than)h(one)f(dimension.)0
+2076 y Fd(Synopsis:)121 b Ft(void)42 b(astMapBox\()d(AstMapping)h
+Fh(\003)p Ft(this,)h(const)g(double)g(lbnd_in[],)f(const)h(double)g
+(ubnd_in[],)227 2175 y(int)i(forward,)d(int)i(coord_out,)e(double)h
+Fh(\003)p Ft(lbnd_out,)e(double)i Fh(\003)p Ft(ubnd_out,)f(double)h
+(xl[],)g(double)227 2275 y(xu[])h(\);)0 2422 y Fd(P)m(arameters:)259
+2556 y(this)427 2656 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Mapping.)259
+2786 y Fd(lbnd)p Ft(_)p Fd(in)427 2886 y Fi(P)n(oin)n(ter)33
b(to)h(an)g(arra)n(y)e(of)i(double,)i(with)e(one)g(elemen)n(t)g(for)g
(eac)n(h)f(Mapping)h(input)h(co)r(ordinate.)56 b(This)427
-779 y(should)28 b(con)n(tain)f(the)h(lo)n(w)n(er)e(b)r(ound)i(of)f(the)
-h(input)g(b)r(o)n(x)g(in)f(eac)n(h)g(input)i(dimension.)259
-908 y Fd(ubnd)p Ft(_)p Fd(in)427 1008 y Fi(P)n(oin)n(ter)k(to)h(an)g
+2986 y(should)28 b(con)n(tain)f(the)h(lo)n(w)n(er)e(b)r(ound)i(of)f
+(the)h(input)g(b)r(o)n(x)g(in)f(eac)n(h)g(input)i(dimension.)259
+3116 y Fd(ubnd)p Ft(_)p Fd(in)427 3216 y Fi(P)n(oin)n(ter)k(to)h(an)g
(arra)n(y)e(of)i(double,)i(with)e(one)g(elemen)n(t)g(for)g(eac)n(h)f
-(Mapping)h(input)h(co)r(ordinate.)56 b(This)427 1107
+(Mapping)h(input)h(co)r(ordinate.)56 b(This)427 3316
y(should)28 b(con)n(tain)f(the)h(upp)r(er)f(b)r(ound)h(of)g(the)g
(input)g(b)r(o)n(x)f(in)h(eac)n(h)f(input)h(dimension.)427
-1222 y(Note)22 b(that)g(it)g(is)f(p)r(ermissible)g(for)g(the)h(upp)r
+3431 y(Note)22 b(that)g(it)g(is)f(p)r(ermissible)g(for)g(the)h(upp)r
(er)g(b)r(ound)g(to)f(b)r(e)h(less)f(than)h(the)g(corresp)r(onding)d
-(lo)n(w)n(er)h(b)r(ound,)427 1321 y(as)27 b(the)h(v)-5
+(lo)n(w)n(er)h(b)r(ound,)427 3530 y(as)27 b(the)h(v)-5
b(alues)27 b(will)h(simply)g(b)r(e)g(sw)n(app)r(ed)f(b)r(efore)g(use.)
-259 1450 y Fd(forw)m(ard)427 1550 y Fi(If)c(this)g(v)-5
+259 3661 y Fd(forw)m(ard)427 3760 y Fi(If)c(this)g(v)-5
b(alue)22 b(is)g(non-zero,)g(then)h(the)g(Mapping's)e(forw)n(ard)g
(transformation)g(will)h(b)r(e)h(used)g(to)f(transform)427
-1649 y(the)28 b(input)h(b)r(o)n(x.)36 b(Otherwise,)27
+3860 y(the)28 b(input)h(b)r(o)n(x.)36 b(Otherwise,)27
b(its)h(in)n(v)n(erse)e(transformation)g(will)i(b)r(e)g(used.)427
-1764 y(\(If)35 b(the)g(in)n(v)n(erse)e(transformation)g(is)h(selected,)
+3975 y(\(If)35 b(the)g(in)n(v)n(erse)e(transformation)g(is)h(selected,)
i(then)f(references)f(to)g Ft(")p Fi(input)p Ft(")g Fi(and)h
-Ft(")p Fi(output)p Ft(")f Fi(co)r(ordi-)427 1863 y(nates)e(in)g(this)f
+Ft(")p Fi(output)p Ft(")f Fi(co)r(ordi-)427 4075 y(nates)e(in)g(this)f
(description)h(should)f(b)r(e)h(transp)r(osed.)48 b(F)-7
b(or)31 b(example,)i(the)f(size)f(of)h(the)g Ft(")p Fi(lbnd)p
-Ft(_)p Fi(in)p Ft(")f Fi(and)427 1963 y Ft(")p Fi(ubnd)p
+Ft(_)p Fi(in)p Ft(")f Fi(and)427 4174 y Ft(")p Fi(ubnd)p
Ft(_)p Fi(in)p Ft(")23 b Fi(arra)n(ys)e(should)i(matc)n(h)g(the)h(n)n
(um)n(b)r(er)f(of)g(output)h(co)r(ordinates,)f(as)g(giv)n(en)f(b)n(y)h
-(the)h(Mapping's)427 2062 y(Nout)35 b(attribute.)59 b(Similarly)-7
+(the)h(Mapping's)427 4274 y(Nout)35 b(attribute.)59 b(Similarly)-7
b(,)36 b(the)g Ft(")p Fi(co)r(ord)p Ft(_)p Fi(out)p Ft(")c
Fi(parameter,)j(b)r(elo)n(w,)i(should)d(nominate)h(one)f(of)h(the)427
-2162 y(Mapping's)27 b(input)i(co)r(ordinates.\))259 2291
-y Fd(co)s(ord)p Ft(_)p Fd(out)427 2391 y Fi(The)d(index)f(of)h(the)f
+4374 y(Mapping's)27 b(input)i(co)r(ordinates.\))259 4504
+y Fd(co)s(ord)p Ft(_)p Fd(out)427 4604 y Fi(The)d(index)f(of)h(the)f
(output)h(co)r(ordinate)f(for)g(whic)n(h)g(the)h(lo)n(w)n(er)e(and)h
(upp)r(er)g(b)r(ounds)h(are)e(required.)36 b(This)427
-2490 y(v)-5 b(alue)27 b(should)f(b)r(e)i(at)e(least)h(one,)f(and)h(no)f
+4704 y(v)-5 b(alue)27 b(should)f(b)r(e)i(at)e(least)h(one,)f(and)h(no)f
(larger)f(than)i(the)g(n)n(um)n(b)r(er)g(of)f(Mapping)h(output)g(co)r
-(ordinates.)259 2619 y Fd(lbnd)p Ft(_)p Fd(out)427 2719
+(ordinates.)259 4834 y Fd(lbnd)p Ft(_)p Fd(out)427 4934
y Fi(P)n(oin)n(ter)39 b(to)g(a)h(double)g(in)g(whic)n(h)g(to)g(return)g
(the)g(lo)n(w)n(est)f(v)-5 b(alue)40 b(tak)n(en)f(b)n(y)h(the)g
-(nominated)g(output)427 2818 y(co)r(ordinate)27 b(within)h(the)g(sp)r
+(nominated)g(output)427 5033 y(co)r(ordinate)27 b(within)h(the)g(sp)r
(eci\014ed)g(region)e(of)i(input)g(co)r(ordinate)e(space.)259
-2947 y Fd(ubnd)p Ft(_)p Fd(out)427 3047 y Fi(P)n(oin)n(ter)36
+5164 y Fd(ubnd)p Ft(_)p Fd(out)427 5264 y Fi(P)n(oin)n(ter)36
b(to)i(a)f(double)g(in)h(whic)n(h)f(to)h(return)f(the)h(highest)f(v)-5
b(alue)38 b(tak)n(en)e(b)n(y)i(the)g(nominated)f(output)427
-3147 y(co)r(ordinate)27 b(within)h(the)g(sp)r(eci\014ed)g(region)e(of)i
-(input)g(co)r(ordinate)e(space.)259 3276 y Fd(xl)427
-3375 y Fi(An)j(optional)e(p)r(oin)n(ter)g(to)h(an)g(arra)n(y)d(of)j
+5363 y(co)r(ordinate)27 b(within)h(the)g(sp)r(eci\014ed)g(region)e(of)i
+(input)g(co)r(ordinate)e(space.)259 5494 y Fd(xl)427
+5593 y Fi(An)j(optional)e(p)r(oin)n(ter)g(to)h(an)g(arra)n(y)d(of)j
(double,)g(with)h(one)e(elemen)n(t)h(for)g(eac)n(h)f(Mapping)g(input)i
-(co)r(ordi-)427 3475 y(nate.)44 b(If)30 b(giv)n(en,)g(this)g(arra)n(y)d
+(co)r(ordi-)427 5693 y(nate.)44 b(If)30 b(giv)n(en,)g(this)g(arra)n(y)d
(will)k(b)r(e)f(\014lled)g(with)g(the)h(co)r(ordinates)d(of)i(an)f
-(input)i(p)r(oin)n(t)f(\(although)g(not)427 3574 y(necessarily)22
-b(a)i(unique)g(one\))g(for)f(whic)n(h)h(the)g(nominated)f(output)i(co)r
-(ordinate)d(attains)i(the)g(lo)n(w)n(er)e(b)r(ound)427
-3674 y(v)-5 b(alue)28 b(returned)f(in)h Ft(")p Fh(\003)p
-Fi(lbnd)p Ft(_)p Fi(out)p Ft(")p Fi(.)427 3788 y(If)g(these)g(co)r
-(ordinates)e(are)h(not)g(required,)g(a)g(NULL)h(p)r(oin)n(ter)f(ma)n(y)
-g(b)r(e)h(supplied.)259 3917 y Fd(xu)427 4017 y Fi(An)33
-b(optional)f(p)r(oin)n(ter)g(to)g(an)g(arra)n(y)f(of)h(double,)i(with)f
-(one)f(elemen)n(t)g(for)g(eac)n(h)g(Mapping)g(input)h(co)r(or-)427
-4117 y(dinate.)58 b(If)35 b(giv)n(en,)h(this)e(arra)n(y)f(will)h(b)r(e)
-h(\014lled)g(with)g(the)g(co)r(ordinates)e(of)i(an)f(input)h(p)r(oin)n
-(t)g(\(although)427 4216 y(not)c(necessarily)e(a)h(unique)h(one\))f
-(for)g(whic)n(h)h(the)f(nominated)h(output)g(co)r(ordinate)e(attains)i
-(the)f(upp)r(er)427 4316 y(b)r(ound)e(v)-5 b(alue)28
-b(returned)f(in)h Ft(")p Fh(\003)p Fi(ubnd)p Ft(_)p Fi(out)p
-Ft(")p Fi(.)427 4430 y(If)g(these)g(co)r(ordinates)e(are)h(not)g
-(required,)g(a)g(NULL)h(p)r(oin)n(ter)f(ma)n(y)g(b)r(e)h(supplied.)0
-4588 y Fd(Notes:)340 4867 y Fh(\017)45 b Fi(An)n(y)20
-b(input)g(p)r(oin)n(ts)g(whic)n(h)f(are)g(transformed)f(b)n(y)h(the)h
-(Mapping)f(to)h(giv)n(e)e(output)j(co)r(ordinates)d(con)n(taining)427
-4966 y(the)j(v)-5 b(alue)20 b(AST)p Ft(__)p Fi(BAD)g(are)f(regarded)g
-(as)g(in)n(v)-5 b(alid)20 b(and)g(are)f(ignored.)34 b(They)20
-b(will)g(mak)n(e)f(no)h(con)n(tribution)427 5066 y(to)h(determining)g
-(the)g(output)h(b)r(ounds,)g(ev)n(en)f(although)f(the)h(nominated)g
-(output)h(co)r(ordinate)d(migh)n(t)i(still)427 5166 y(ha)n(v)n(e)27
-b(a)g(v)-5 b(alid)28 b(v)-5 b(alue)27 b(at)g(suc)n(h)h(p)r(oin)n(ts.)
-340 5295 y Fh(\017)45 b Fi(An)36 b(error)d(will)i(o)r(ccur)g(if)g(the)h
+(input)i(p)r(oin)n(t)f(\(although)g(not)p eop end
+%%Page: 273 283
+TeXDict begin 273 282 bop 3643 52 a FF(273)427 351 y
+Fi(necessarily)22 b(a)i(unique)g(one\))g(for)f(whic)n(h)h(the)g
+(nominated)f(output)i(co)r(ordinate)d(attains)i(the)g(lo)n(w)n(er)e(b)r
+(ound)427 451 y(v)-5 b(alue)28 b(returned)f(in)h Ft(")p
+Fh(\003)p Fi(lbnd)p Ft(_)p Fi(out)p Ft(")p Fi(.)427 569
+y(If)g(these)g(co)r(ordinates)e(are)h(not)g(required,)g(a)g(NULL)h(p)r
+(oin)n(ter)f(ma)n(y)g(b)r(e)h(supplied.)259 707 y Fd(xu)427
+806 y Fi(An)33 b(optional)f(p)r(oin)n(ter)g(to)g(an)g(arra)n(y)f(of)h
+(double,)i(with)f(one)f(elemen)n(t)g(for)g(eac)n(h)g(Mapping)g(input)h
+(co)r(or-)427 906 y(dinate.)58 b(If)35 b(giv)n(en,)h(this)e(arra)n(y)f
+(will)h(b)r(e)h(\014lled)g(with)g(the)g(co)r(ordinates)e(of)i(an)f
+(input)h(p)r(oin)n(t)g(\(although)427 1006 y(not)c(necessarily)e(a)h
+(unique)h(one\))f(for)g(whic)n(h)h(the)f(nominated)h(output)g(co)r
+(ordinate)e(attains)i(the)f(upp)r(er)427 1105 y(b)r(ound)e(v)-5
+b(alue)28 b(returned)f(in)h Ft(")p Fh(\003)p Fi(ubnd)p
+Ft(_)p Fi(out)p Ft(")p Fi(.)427 1224 y(If)g(these)g(co)r(ordinates)e
+(are)h(not)g(required,)g(a)g(NULL)h(p)r(oin)n(ter)f(ma)n(y)g(b)r(e)h
+(supplied.)0 1395 y Fd(Notes:)340 1687 y Fh(\017)45 b
+Fi(An)n(y)20 b(input)g(p)r(oin)n(ts)g(whic)n(h)f(are)g(transformed)f(b)
+n(y)h(the)h(Mapping)f(to)h(giv)n(e)e(output)j(co)r(ordinates)d(con)n
+(taining)427 1786 y(the)j(v)-5 b(alue)20 b(AST)p Ft(__)p
+Fi(BAD)g(are)f(regarded)g(as)g(in)n(v)-5 b(alid)20 b(and)g(are)f
+(ignored.)34 b(They)20 b(will)g(mak)n(e)f(no)h(con)n(tribution)427
+1886 y(to)h(determining)g(the)g(output)h(b)r(ounds,)g(ev)n(en)f
+(although)f(the)h(nominated)g(output)h(co)r(ordinate)d(migh)n(t)i
+(still)427 1986 y(ha)n(v)n(e)27 b(a)g(v)-5 b(alid)28
+b(v)-5 b(alue)27 b(at)g(suc)n(h)h(p)r(oin)n(ts.)340 2123
+y Fh(\017)45 b Fi(An)36 b(error)d(will)i(o)r(ccur)g(if)g(the)h
(required)e(output)h(b)r(ounds)g(cannot)g(b)r(e)h(found.)59
-b(T)n(ypically)-7 b(,)36 b(this)g(migh)n(t)427 5394 y(happ)r(en)25
+b(T)n(ypically)-7 b(,)36 b(this)g(migh)n(t)427 2223 y(happ)r(en)25
b(if)g(all)f(the)h(input)g(p)r(oin)n(ts)f(whic)n(h)g(the)h(function)g
(considers)e(turn)i(out)f(to)g(b)r(e)h(in)n(v)-5 b(alid)24
-b(\(see)h(ab)r(o)n(v)n(e\).)427 5494 y(The)36 b(n)n(um)n(b)r(er)g(of)g
+b(\(see)h(ab)r(o)n(v)n(e\).)427 2322 y(The)36 b(n)n(um)n(b)r(er)g(of)g
(p)r(oin)n(ts)g(considered)f(b)r(efore)g(generating)g(suc)n(h)h(an)f
-(error)f(is)i(quite)g(large,)h(so)e(this)i(is)427 5593
+(error)f(is)i(quite)g(large,)h(so)e(this)i(is)427 2422
y(unlik)n(ely)30 b(to)g(o)r(ccur)f(b)n(y)g(acciden)n(t)h(unless)f(v)-5
b(alid)30 b(p)r(oin)n(ts)g(are)f(restricted)g(to)h(a)f(v)n(ery)g(small)
-h(subset)f(of)h(the)427 5693 y(input)f(co)r(ordinate)d(space.)p
-eop end
-%%Page: 273 283
-TeXDict begin 273 282 bop 3643 52 a FF(273)340 351 y
-Fh(\017)45 b Fi(The)37 b(v)-5 b(alues)37 b(returned)f(via)g
+h(subset)f(of)h(the)427 2521 y(input)f(co)r(ordinate)d(space.)340
+2659 y Fh(\017)45 b Fi(The)37 b(v)-5 b(alues)37 b(returned)f(via)g
Ft(")p Fi(lbnd)p Ft(_)p Fi(out)p Ft(")p Fi(,)j Ft(")p
Fi(ubnd)p Ft(_)p Fi(out)p Ft(")p Fi(,)f Ft(")p Fi(xl)p
Ft(")e Fi(and)h Ft(")p Fi(xu)p Ft(")f Fi(will)h(b)r(e)g(set)g(to)g(the)
-g(v)-5 b(alue)427 451 y(AST)p Ft(__)p Fi(BAD)29 b(if)g(this)g(function)
-h(should)e(fail)h(for)f(an)n(y)g(reason.)39 b(Their)29
-b(initial)g(v)-5 b(alues)28 b(on)g(en)n(try)h(will)g(not)427
-551 y(b)r(e)f(altered)f(if)h(the)g(function)h(is)e(in)n(v)n(ok)n(ed)f
-(with)i(the)g(AST)g(error)e(status)h(set.)p 0 750 3780
-12 v 0 881 a Fz(astMapCop)l(y)968 882 y Fe(Cop)m(y)37
-b(en)m(tries)h(from)f(one)i(KeyMap)g(in)m(to)1695 997
-y(another)3035 881 y Fz(astMapCop)l(y)0 1163 y Fd(Description:)44
+g(v)-5 b(alue)427 2758 y(AST)p Ft(__)p Fi(BAD)29 b(if)g(this)g
+(function)h(should)e(fail)h(for)f(an)n(y)g(reason.)39
+b(Their)29 b(initial)g(v)-5 b(alues)28 b(on)g(en)n(try)h(will)g(not)427
+2858 y(b)r(e)f(altered)f(if)h(the)g(function)h(is)e(in)n(v)n(ok)n(ed)f
+(with)i(the)g(AST)g(error)e(status)h(set.)p 0 3067 3780
+12 v 0 3197 a Fz(astMapCop)l(y)968 3198 y Fe(Cop)m(y)37
+b(en)m(tries)h(from)f(one)i(KeyMap)g(in)m(to)1695 3313
+y(another)3035 3197 y Fz(astMapCop)l(y)0 3488 y Fd(Description:)44
b Fi(This)28 b(function)g(copies)f(all)g(en)n(tries)g(from)g(one)h
-(KeyMap)e(in)n(to)i(another.)0 1313 y Fd(Synopsis:)121
+(KeyMap)e(in)n(to)i(another.)0 3646 y Fd(Synopsis:)121
b Ft(void)42 b(astMapCopy\()d(AstKeyMap)h Fh(\003)p Ft(this,)h
-(AstKeyMap)f Fh(\003)p Ft(that)h(\))0 1463 y Fd(P)m(arameters:)259
-1600 y(this)427 1699 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(destination)f
-(KeyMap.)259 1832 y Fd(that)427 1932 y Fi(P)n(oin)n(ter)f(to)i(the)g
-(source)e(KeyMap.)0 2094 y Fd(Notes:)340 2377 y Fh(\017)45
+(AstKeyMap)f Fh(\003)p Ft(that)h(\))0 3805 y Fd(P)m(arameters:)259
+3950 y(this)427 4050 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(destination)f
+(KeyMap.)259 4187 y Fd(that)427 4287 y Fi(P)n(oin)n(ter)f(to)i(the)g
+(source)e(KeyMap.)0 4458 y Fd(Notes:)340 4750 y Fh(\017)45
b Fi(En)n(tries)26 b(from)g(the)i(source)d(KeyMap)h(will)h(replace)f
(an)n(y)g(existing)g(en)n(tries)h(in)g(the)g(destination)g(KeyMap)427
-2477 y(that)h(ha)n(v)n(e)f(the)h(same)f(k)n(ey)-7 b(.)340
-2610 y Fh(\017)45 b Fi(The)26 b(one)e(exception)h(to)g(the)h(ab)r(o)n
+4849 y(that)h(ha)n(v)n(e)f(the)h(same)f(k)n(ey)-7 b(.)340
+4987 y Fh(\017)45 b Fi(The)26 b(one)e(exception)h(to)g(the)h(ab)r(o)n
(v)n(e)e(rule)h(is)g(that)g(if)h(a)f(source)f(en)n(try)g(con)n(tains)g
-(a)h(scalar)f(KeyMap)g(en)n(try)-7 b(,)427 2710 y(and)40
+(a)h(scalar)f(KeyMap)g(en)n(try)-7 b(,)427 5087 y(and)40
b(the)f(destination)h(con)n(tains)e(a)h(scalar)f(KeyMap)h(en)n(try)f
(with)i(the)g(same)f(k)n(ey)-7 b(,)42 b(then)e(the)g(source)427
-2809 y(KeyMap)29 b(en)n(try)g(will)h(b)r(e)g(copied)f(in)n(to)h(the)g
+5186 y(KeyMap)29 b(en)n(try)g(will)h(b)r(e)g(copied)f(in)n(to)h(the)g
(destination)f(KeyMap)g(en)n(try)g(using)g(this)h(function,)h(rather)
-427 2909 y(than)d(simply)g(replacing)e(the)i(destination)f(KeyMap)g(en)
-n(try)-7 b(.)340 3042 y Fh(\017)45 b Fi(If)29 b(the)g(destination)f(en)
+427 5286 y(than)d(simply)g(replacing)e(the)i(destination)f(KeyMap)g(en)
+n(try)-7 b(.)340 5423 y Fh(\017)45 b Fi(If)29 b(the)g(destination)f(en)
n(try)g(has)f(a)h(non-zero)f(v)-5 b(alue)28 b(for)g(its)g(MapLo)r(c)n
-(k)n(ed)f(attribute,)i(then)g(an)f(error)e(will)427 3142
+(k)n(ed)f(attribute,)i(then)g(an)f(error)e(will)427 5523
y(b)r(e)36 b(rep)r(orted)g(if)g(the)g(source)f(KeyMap)g(con)n(tains)f
(an)n(y)h(k)n(eys)g(that)h(do)g(not)g(already)e(exist)i(within)g(the)
-427 3241 y(destination)28 b(KeyMap.)p 0 3441 V 0 3573
-a Fz(astMapDe\014ned)p Fc(<)p Fz(X)p Fc(>)222 b Fe(Chec)m(k)38
-b(if)g(a)h(KeyMap)1429 3687 y(con)m(tains)e(a)i(de\014ned)1514
-3787 y(v)-7 b(alue)39 b(for)e(a)i(k)m(ey)2607 3573 y
-Fz(astMapDe\014ned)p Fc(<)p Fz(X)p Fc(>)0 3976 y Fd(Description:)44
-b Fi(This)31 b(function)g(c)n(hec)n(ks)e(to)i(see)f(if)h(a)f(KeyMap)g
-(con)n(tains)g(a)g(de\014ned)h(v)-5 b(alue)30 b(for)g(a)g(giv)n(en)g(k)
-n(ey)-7 b(.)45 b(If)31 b(the)227 4076 y(k)n(ey)h(is)g(presen)n(t)g(in)g
-(the)h(KeyMap)f(but)g(has)g(an)g(unde\014ned)h(v)-5 b(alue)32
-b(it)h(returns)f(zero)f(\(unlik)n(e)h(astMapHasKey)227
-4176 y(whic)n(h)c(w)n(ould)f(return)g(non-zero\).)0 4326
-y Fd(Synopsis:)121 b Ft(int)42 b(astMapDefined\()c(AstKeyMap)i
-Fh(\003)p Ft(this,)h(const)g(char)h Fh(\003)p Ft(key)g(\);)0
-4476 y Fd(P)m(arameters:)259 4613 y(this)427 4712 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(KeyMap.)259 4845 y Fd(k)m(ey)427 4945 y
-Fi(The)j(c)n(haracter)d(string)h(iden)n(tifying)i(the)f(v)-5
-b(alue)30 b(to)g(b)r(e)h(retriev)n(ed.)43 b(T)-7 b(railing)30
-b(spaces)f(are)g(ignored.)44 b(The)427 5045 y(supplied)26
-b(string)f(is)g(con)n(v)n(erted)f(to)h(upp)r(er)g(case)g(b)r(efore)g
-(use)g(if)h(the)g(KeyCase)e(attribute)h(is)g(curren)n(tly)g(set)427
-5144 y(to)j(zero.)0 5307 y Fd(Returned)k(V)-8 b(alue:)259
-5444 y(astMapDe\014ned\(\))427 5543 y Fi(A)30 b(non-zero)d(v)-5
-b(alue)30 b(is)f(returned)f(if)i(the)g(requested)e(k)n(ey)h(name)g(is)g
-(presen)n(t)g(in)g(the)h(KeyMap)e(and)h(has)g(a)427 5643
-y(de\014ned)f(v)-5 b(alue.)p eop end
+427 5622 y(destination)28 b(KeyMap.)p eop end
%%Page: 274 284
TeXDict begin 274 283 bop 0 52 a FF(274)2049 b Fy(B)91
b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 482 a Fz(astMapGet0)p Fc(<)p Fz(X)p Fc(>)1242 483 y
-Fe(Get)38 b(a)h(scalar)e(v)-7 b(alue)39 b(from)e(a)1672
-583 y(KeyMap)2771 482 y Fz(astMapGet0)p Fc(<)p Fz(X)p
-Fc(>)0 769 y Fd(Description:)44 b Fi(This)25 b(is)g(a)f(set)h(of)g
-(functions)g(for)f(retrieving)g(a)g(scalar)f(v)-5 b(alue)25
-b(from)g(a)f(KeyMap.)35 b(Y)-7 b(ou)25 b(should)g(replace)227
-869 y Fk(<)p Fi(X)p Fk(>)g Fi(in)h(the)g(generic)e(function)i(name)g
+0 483 a Fz(astMapDe\014ned)p Fc(<)p Fz(X)p Fc(>)222 b
+Fe(Chec)m(k)38 b(if)g(a)h(KeyMap)1429 598 y(con)m(tains)e(a)i
+(de\014ned)1514 697 y(v)-7 b(alue)39 b(for)e(a)i(k)m(ey)2607
+483 y Fz(astMapDe\014ned)p Fc(<)p Fz(X)p Fc(>)0 887 y
+Fd(Description:)44 b Fi(This)31 b(function)g(c)n(hec)n(ks)e(to)i(see)f
+(if)h(a)f(KeyMap)g(con)n(tains)g(a)g(de\014ned)h(v)-5
+b(alue)30 b(for)g(a)g(giv)n(en)g(k)n(ey)-7 b(.)45 b(If)31
+b(the)227 986 y(k)n(ey)h(is)g(presen)n(t)g(in)g(the)h(KeyMap)f(but)g
+(has)g(an)g(unde\014ned)h(v)-5 b(alue)32 b(it)h(returns)f(zero)f
+(\(unlik)n(e)h(astMapHasKey)227 1086 y(whic)n(h)c(w)n(ould)f(return)g
+(non-zero\).)0 1236 y Fd(Synopsis:)121 b Ft(int)42 b(astMapDefined\()c
+(AstKeyMap)i Fh(\003)p Ft(this,)h(const)g(char)h Fh(\003)p
+Ft(key)g(\);)0 1386 y Fd(P)m(arameters:)259 1523 y(this)427
+1623 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)259 1756
+y Fd(k)m(ey)427 1856 y Fi(The)j(c)n(haracter)d(string)h(iden)n(tifying)
+i(the)f(v)-5 b(alue)30 b(to)g(b)r(e)h(retriev)n(ed.)43
+b(T)-7 b(railing)30 b(spaces)f(are)g(ignored.)44 b(The)427
+1955 y(supplied)26 b(string)f(is)g(con)n(v)n(erted)f(to)h(upp)r(er)g
+(case)g(b)r(efore)g(use)g(if)h(the)g(KeyCase)e(attribute)h(is)g(curren)
+n(tly)g(set)427 2055 y(to)j(zero.)0 2217 y Fd(Returned)k(V)-8
+b(alue:)259 2355 y(astMapDe\014ned\(\))427 2454 y Fi(A)30
+b(non-zero)d(v)-5 b(alue)30 b(is)f(returned)f(if)i(the)g(requested)e(k)
+n(ey)h(name)g(is)g(presen)n(t)g(in)g(the)h(KeyMap)e(and)h(has)g(a)427
+2554 y(de\014ned)f(v)-5 b(alue.)p 0 2754 V 0 2884 a Fz(astMapGet0)p
+Fc(<)p Fz(X)p Fc(>)1242 2885 y Fe(Get)38 b(a)h(scalar)e(v)-7
+b(alue)39 b(from)e(a)1672 2985 y(KeyMap)2771 2884 y Fz(astMapGet0)p
+Fc(<)p Fz(X)p Fc(>)0 3175 y Fd(Description:)44 b Fi(This)25
+b(is)g(a)f(set)h(of)g(functions)g(for)f(retrieving)g(a)g(scalar)f(v)-5
+b(alue)25 b(from)g(a)f(KeyMap.)35 b(Y)-7 b(ou)25 b(should)g(replace)227
+3274 y Fk(<)p Fi(X)p Fk(>)g Fi(in)h(the)g(generic)e(function)i(name)g
(astMapGet0)p Fk(<)p Fi(X)p Fk(>)e Fi(b)n(y)h(an)g(appropriate)f(1-c)n
-(haracter)f(t)n(yp)r(e)i(co)r(de)h(\(see)227 968 y(the)g
+(haracter)f(t)n(yp)r(e)i(co)r(de)h(\(see)227 3374 y(the)g
Ft(")p Fi(Data)f(T)n(yp)r(e)g(Co)r(des)p Ft(")g Fi(section)g(b)r(elo)n
(w)g(for)g(the)h(co)r(de)g(appropriate)d(to)j(eac)n(h)f(supp)r(orted)g
-(data)g(t)n(yp)r(e\).)37 b(The)227 1068 y(stored)h(v)-5
+(data)g(t)n(yp)r(e\).)37 b(The)227 3473 y(stored)h(v)-5
b(alue)38 b(is)g(con)n(v)n(erted)f(to)h(the)h(data)e(t)n(yp)r(e)i
(indiced)f(b)n(y)g Fk(<)p Fi(X)p Fk(>)g Fi(b)r(efore)g(b)r(eing)g
-(returned)g(\(an)g(error)f(is)227 1167 y(rep)r(orted)27
+(returned)g(\(an)g(error)f(is)227 3573 y(rep)r(orted)27
b(if)h(it)g(is)g(not)f(p)r(ossible)h(to)f(con)n(v)n(ert)f(the)i(stored)
f(v)-5 b(alue)27 b(to)h(the)g(requested)f(data)g(t)n(yp)r(e\).)0
-1316 y Fd(Synopsis:)121 b Ft(int)42 b(astMapGet0)p Fk(<)p
+3723 y Fd(Synopsis:)121 b Ft(int)42 b(astMapGet0)p Fk(<)p
Ft(X)p Fk(>)p Ft(\()c(AstKeyMap)i Fh(\003)p Ft(this,)h(const)g(char)h
Fh(\003)p Ft(key,)g Fk(<)p Ft(X)p Fk(>)p Ft(type)e Fh(\003)p
-Ft(value)h(\);)0 1464 y Fd(P)m(arameters:)259 1599 y(this)427
-1699 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)259 1830
-y Fd(k)m(ey)427 1930 y Fi(The)j(c)n(haracter)d(string)h(iden)n(tifying)
+Ft(value)h(\);)0 3873 y Fd(P)m(arameters:)259 4010 y(this)427
+4110 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)259 4243
+y Fd(k)m(ey)427 4343 y Fi(The)j(c)n(haracter)d(string)h(iden)n(tifying)
i(the)f(v)-5 b(alue)30 b(to)g(b)r(e)h(retriev)n(ed.)43
b(T)-7 b(railing)30 b(spaces)f(are)g(ignored.)44 b(The)427
-2030 y(supplied)26 b(string)f(is)g(con)n(v)n(erted)f(to)h(upp)r(er)g
+4442 y(supplied)26 b(string)f(is)g(con)n(v)n(erted)f(to)h(upp)r(er)g
(case)g(b)r(efore)g(use)g(if)h(the)g(KeyCase)e(attribute)h(is)g(curren)
-n(tly)g(set)427 2129 y(to)j(zero.)259 2261 y Fd(v)-5
-b(alue)427 2361 y Fi(A)23 b(p)r(oin)n(ter)f(to)g(a)g(bu\013er)g(in)h
+n(tly)g(set)427 4542 y(to)j(zero.)259 4675 y Fd(v)-5
+b(alue)427 4775 y Fi(A)23 b(p)r(oin)n(ter)f(to)g(a)g(bu\013er)g(in)h
(whic)n(h)f(to)h(return)e(the)i(requested)f(v)-5 b(alue.)35
b(If)23 b(the)f(requested)g(k)n(ey)g(is)g(not)g(found,)427
-2460 y(or)i(if)g(it)h(is)f(found)g(but)h(has)f(an)g(unde\014ned)h(v)-5
+4874 y(or)i(if)g(it)h(is)f(found)g(but)h(has)f(an)g(unde\014ned)h(v)-5
b(alue)24 b(\(see)g(astMapPutU\),)g(then)h(the)f(con)n(ten)n(ts)g(of)g
-(the)g(bu\013er)427 2560 y(on)31 b(en)n(try)g(to)g(this)h(function)f
+(the)g(bu\013er)427 4974 y(on)31 b(en)n(try)g(to)g(this)h(function)f
(will)h(b)r(e)f(unc)n(hanged)g(on)g(exit.)48 b(F)-7 b(or)30
b(p)r(oin)n(ter)h(t)n(yp)r(es)g(\()p Ft(")p Fi(A)p Ft(")g
-Fi(and)h Ft(")p Fi(C)p Ft(")p Fi(\),)f(the)427 2659 y(bu\013er)c
+Fi(and)h Ft(")p Fi(C)p Ft(")p Fi(\),)f(the)427 5074 y(bu\013er)c
(should)g(b)r(e)g(a)f(suitable)g(p)r(oin)n(ter,)h(and)f(the)h(address)f
(of)g(this)h(p)r(oin)n(ter)g(should)f(b)r(e)h(supplied)g(as)f(the)427
-2759 y Ft(")p Fi(v)-5 b(alue)p Ft(")27 b Fi(parameter.)0
-2920 y Fd(Returned)32 b(V)-8 b(alue:)259 3055 y(astMapGet0)p
-Fk(<)p Fd(X)p Fk(>)p Fd(\(\))427 3155 y Fi(A)37 b(non-zero)d(v)-5
+5173 y Ft(")p Fi(v)-5 b(alue)p Ft(")27 b Fi(parameter.)0
+5336 y Fd(Returned)32 b(V)-8 b(alue:)259 5473 y(astMapGet0)p
+Fk(<)p Fd(X)p Fk(>)p Fd(\(\))427 5573 y Fi(A)37 b(non-zero)d(v)-5
b(alue)36 b(is)g(returned)f(if)i(the)f(requested)g(k)n(ey)f(name)h(w)n
(as)f(found,)j(and)e(do)r(es)g(not)g(ha)n(v)n(e)f(an)427
-3254 y(unde\014ned)28 b(v)-5 b(alue)28 b(\(see)f(astMapPutU\).)h(Zero)e
-(is)i(returned)f(otherwise.)0 3415 y Fd(Notes:)340 3696
-y Fh(\017)45 b Fi(No)31 b(error)e(is)h(rep)r(orted)g(if)i(the)f
+5672 y(unde\014ned)28 b(v)-5 b(alue)28 b(\(see)f(astMapPutU\).)h(Zero)e
+(is)i(returned)f(otherwise.)p eop end
+%%Page: 275 285
+TeXDict begin 275 284 bop 3643 52 a FF(275)0 351 y Fd(Notes:)340
+646 y Fh(\017)45 b Fi(No)31 b(error)e(is)h(rep)r(orted)g(if)i(the)f
(requested)f(k)n(ey)g(cannot)g(b)r(e)h(found)g(in)g(the)g(giv)n(en)f
-(KeyMap,)h(but)g(a)g(zero)427 3796 y(v)-5 b(alue)25 b(will)g(b)r(e)g
+(KeyMap,)h(but)g(a)g(zero)427 746 y(v)-5 b(alue)25 b(will)g(b)r(e)g
(returned)f(as)h(the)g(function)g(v)-5 b(alue.)36 b(The)25
b(supplied)g(bu\013er)g(will)g(b)r(e)g(returned)f(unc)n(hanged.)340
-3927 y Fh(\017)45 b Fi(If)28 b(the)g(stored)f(v)-5 b(alue)28
+885 y Fh(\017)45 b Fi(If)28 b(the)g(stored)f(v)-5 b(alue)28
b(is)f(a)g(v)n(ector)f(v)-5 b(alue,)28 b(then)g(the)g(\014rst)f(v)-5
b(alue)28 b(in)g(the)g(v)n(ector)e(will)i(b)r(e)g(returned.)340
-4059 y Fh(\017)45 b Fi(A)32 b(string)e(p)r(oin)n(ter)h(returned)g(b)n
+1024 y Fh(\017)45 b Fi(A)32 b(string)e(p)r(oin)n(ter)h(returned)g(b)n
(y)g(astMapGet0C)f(is)h(guaran)n(teed)f(to)h(remain)f(v)-5
-b(alid)32 b(and)f(the)g(string)g(to)427 4159 y(whic)n(h)22
+b(alid)32 b(and)f(the)g(string)g(to)427 1124 y(whic)n(h)22
b(it)f(p)r(oin)n(ts)h(will)f(not)h(b)r(e)g(o)n(v)n(er-written)d(for)i
(a)g(total)g(of)h(50)e(successiv)n(e)g(in)n(v)n(o)r(cations)g(of)h
-(this)h(function.)427 4258 y(After)30 b(this,)g(the)g(memory)e(con)n
+(this)h(function.)427 1224 y(After)30 b(this,)g(the)g(memory)e(con)n
(taining)g(the)i(string)f(ma)n(y)f(b)r(e)i(re-used,)f(so)f(a)h(cop)n(y)
-f(of)i(the)f(string)g(should)427 4358 y(b)r(e)f(made)g(if)g(it)g(is)f
-(needed)h(for)f(longer)f(than)i(this.)340 4490 y Fh(\017)45
+f(of)i(the)f(string)g(should)427 1323 y(b)r(e)f(made)g(if)g(it)g(is)f
+(needed)h(for)f(longer)f(than)i(this.)340 1462 y Fh(\017)45
b Fi(If)30 b(the)f(returned)g(v)-5 b(alue)29 b(is)g(an)g(AST)g(Ob)5
b(ject)29 b(p)r(oin)n(ter,)g(the)h(Ob)5 b(ject's)29 b(reference)f(coun)
-n(t)h(is)g(incremen)n(ted)427 4589 y(b)n(y)f(this)h(call.)39
+n(t)h(is)g(incremen)n(ted)427 1562 y(b)n(y)f(this)h(call.)39
b(An)n(y)29 b(subsequen)n(t)f(c)n(hanges)f(made)h(to)g(the)h(Ob)5
b(ject)29 b(using)f(the)g(returned)g(p)r(oin)n(ter)h(will)f(b)r(e)427
-4689 y(re\015ected)35 b(in)g(an)n(y)f(an)n(y)g(other)g(activ)n(e)g(p)r
+1662 y(re\015ected)35 b(in)g(an)n(y)f(an)n(y)g(other)g(activ)n(e)g(p)r
(oin)n(ters)g(for)g(the)h(Ob)5 b(ject.)58 b(The)35 b(returned)f(p)r
-(oin)n(ter)h(should)f(b)r(e)427 4789 y(ann)n(ulled)28
+(oin)n(ter)h(should)f(b)r(e)427 1761 y(ann)n(ulled)28
b(using)f(astAnn)n(ul)h(when)f(it)h(is)g(no)f(longer)f(needed.)-2
-4949 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s(des)n(:)227 5095
+1936 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s(des)n(:)227 2082
y Fi(T)-7 b(o)18 b(select)h(the)f(appropriate)f(function,)k(y)n(ou)c
(should)h(replace)g Fk(<)p Fi(X)p Fk(>)g Fi(in)g(the)h(generic)e
(function)i(name)g(astMapGet0)p Fk(<)p Fi(X)p Fk(>)227
-5195 y Fi(with)35 b(a)f(1-c)n(haracter)e(data)h(t)n(yp)r(e)i(co)r(de,)h
+2182 y Fi(with)35 b(a)f(1-c)n(haracter)e(data)h(t)n(yp)r(e)i(co)r(de,)h
(so)e(as)f(to)i(matc)n(h)f(the)h(data)e(t)n(yp)r(e)i
Fk(<)p Fi(X)p Fk(>)p Fi(t)n(yp)r(e)f(of)g(the)h(data)f(y)n(ou)g(are)227
-5295 y(pro)r(cessing,)26 b(as)h(follo)n(ws:)340 5430
-y Fh(\017)45 b Fi(F:)28 b(\015oat)340 5561 y Fh(\017)45
-b Fi(D:)28 b(double)340 5693 y Fh(\017)45 b Fi(I:)28
-b(in)n(t)p eop end
-%%Page: 275 285
-TeXDict begin 275 284 bop 3643 52 a FF(275)340 351 y
-Fh(\017)45 b Fi(C:)28 b Ft(")p Fi(const)p Ft(")e Fi(p)r(oin)n(ter)i(to)
-f(n)n(ull)h(terminated)f(c)n(haracter)f(string)340 489
-y Fh(\017)45 b Fi(A:)28 b(P)n(oin)n(ter)e(to)i(AstOb)5
-b(ject)340 626 y Fh(\017)45 b Fi(P:)28 b(Generic)f Ft(")p
-Fi(v)n(oid)f Fh(\003)p Ft(")h Fi(p)r(oin)n(ter)340 763
-y Fh(\017)45 b Fi(S:)28 b(short)f(in)n(t)340 901 y Fh(\017)45
+2281 y(pro)r(cessing,)26 b(as)h(follo)n(ws:)340 2430
+y Fh(\017)45 b Fi(F:)28 b(\015oat)340 2569 y Fh(\017)45
+b Fi(D:)28 b(double)340 2709 y Fh(\017)45 b Fi(I:)28
+b(in)n(t)340 2848 y Fh(\017)45 b Fi(C:)28 b Ft(")p Fi(const)p
+Ft(")e Fi(p)r(oin)n(ter)i(to)f(n)n(ull)h(terminated)f(c)n(haracter)f
+(string)340 2987 y Fh(\017)45 b Fi(A:)28 b(P)n(oin)n(ter)e(to)i(AstOb)5
+b(ject)340 3126 y Fh(\017)45 b Fi(P:)28 b(Generic)f Ft(")p
+Fi(v)n(oid)f Fh(\003)p Ft(")h Fi(p)r(oin)n(ter)340 3265
+y Fh(\017)45 b Fi(S:)28 b(short)f(in)n(t)340 3404 y Fh(\017)45
b Fi(B:)28 b(Unsigned)f(b)n(yte)h(\(i.e.)37 b(w)n(ord\))227
-1072 y(F)-7 b(or)29 b(example,)g(astMapGet0D)g(w)n(ould)g(b)r(e)g(used)
+3579 y(F)-7 b(or)29 b(example,)g(astMapGet0D)g(w)n(ould)g(b)r(e)g(used)
h(to)f(get)g(a)g Ft(")p Fi(double)p Ft(")f Fi(v)-5 b(alue,)30
-b(while)f(astMapGet0I)f(w)n(ould)h(b)r(e)227 1172 y(used)f(to)f(get)h
-(an)f Ft(")p Fi(in)n(t)p Ft(")p Fi(,)g(etc.)p 0 1380
-3780 12 v 0 1511 a Fz(astMapGet1)p Fc(<)p Fz(X)p Fc(>)1233
-1512 y Fe(Get)38 b(a)g(v)m(ector)g(v)-7 b(alue)38 b(from)f(a)1672
-1611 y(KeyMap)2771 1511 y Fz(astMapGet1)p Fc(<)p Fz(X)p
-Fc(>)0 1809 y Fd(Description:)44 b Fi(This)24 b(is)g(a)g(set)g(of)g
+b(while)f(astMapGet0I)f(w)n(ould)h(b)r(e)227 3678 y(used)f(to)f(get)h
+(an)f Ft(")p Fi(in)n(t)p Ft(")p Fi(,)g(etc.)p 0 3890
+3780 12 v 0 4021 a Fz(astMapGet1)p Fc(<)p Fz(X)p Fc(>)1233
+4022 y Fe(Get)38 b(a)g(v)m(ector)g(v)-7 b(alue)38 b(from)f(a)1672
+4122 y(KeyMap)2771 4021 y Fz(astMapGet1)p Fc(<)p Fz(X)p
+Fc(>)0 4323 y Fd(Description:)44 b Fi(This)24 b(is)g(a)g(set)g(of)g
(functions)g(for)f(retrieving)g(a)g(v)n(ector)g(v)-5
b(alue)24 b(from)g(a)f(KeyMap.)35 b(Y)-7 b(ou)24 b(should)g(replace)227
-1909 y Fk(<)p Fi(X)p Fk(>)h Fi(in)h(the)g(generic)e(function)i(name)g
+4423 y Fk(<)p Fi(X)p Fk(>)h Fi(in)h(the)g(generic)e(function)i(name)g
(astMapGet1)p Fk(<)p Fi(X)p Fk(>)e Fi(b)n(y)h(an)g(appropriate)f(1-c)n
-(haracter)f(t)n(yp)r(e)i(co)r(de)h(\(see)227 2008 y(the)39
+(haracter)f(t)n(yp)r(e)i(co)r(de)h(\(see)227 4522 y(the)39
b Ft(")p Fi(Data)f(T)n(yp)r(e)g(Co)r(des)p Ft(")f Fi(section)h(b)r(elo)
n(w)g(for)g(the)h(co)r(de)f(appropriate)e(to)j(eac)n(h)e(supp)r(orted)h
-(data)g(t)n(yp)r(e\).)227 2108 y(The)33 b(stored)f(v)-5
+(data)g(t)n(yp)r(e\).)227 4622 y(The)33 b(stored)f(v)-5
b(alue)33 b(is)f(con)n(v)n(erted)g(to)g(the)i(data)e(t)n(yp)r(e)h
(indiced)g(b)n(y)g Fk(<)p Fi(X)p Fk(>)f Fi(b)r(efore)g(b)r(eing)h
-(returned)g(\(an)g(error)227 2208 y(is)c(rep)r(orted)g(if)h(it)f(is)h
+(returned)g(\(an)g(error)227 4722 y(is)c(rep)r(orted)g(if)h(it)f(is)h
(not)f(p)r(ossible)g(to)g(con)n(v)n(ert)f(the)h(stored)g(v)-5
b(alue)29 b(to)g(the)h(requested)e(data)h(t)n(yp)r(e\).)42
-b(Note,)30 b(the)227 2307 y(astMapGet1C)j(function)i(has)f(an)f(extra)g
+b(Note,)30 b(the)227 4821 y(astMapGet1C)j(function)i(has)f(an)f(extra)g
(parameter)g Ft(")p Fi(l)p Ft(")g Fi(whic)n(h)h(sp)r(eci\014es)g(the)g
-(maxim)n(um)g(length)g(of)g(eac)n(h)227 2407 y(string)27
+(maxim)n(um)g(length)g(of)g(eac)n(h)227 4921 y(string)27
b(to)h(b)r(e)g(stored)e(in)i(the)g Ft(")p Fi(v)-5 b(alue)p
Ft(")27 b Fi(bu\013er)h(\(see)f(the)h Ft(")p Fi(astMapGet1C)p
-Ft(")e Fi(section)h(b)r(elo)n(w\).)0 2566 y Fd(Synopsis:)121
+Ft(")e Fi(section)h(b)r(elo)n(w\).)0 5083 y Fd(Synopsis:)121
b Ft(int)42 b(astMapGet1)p Fk(<)p Ft(X)p Fk(>)p Ft(\()c(AstKeyMap)i
Fh(\003)p Ft(this,)h(const)g(char)h Fh(\003)p Ft(key,)g(int)g(mxval,)f
(int)i Fh(\003)p Ft(nval,)e Fk(<)p Ft(X)p Fk(>)p Ft(type)227
-2665 y Fh(\003)p Ft(value)g(\))i(int)g(astMapGet1C\()38
+5183 y Fh(\003)p Ft(value)g(\))i(int)g(astMapGet1C\()38
b(AstKeyMap)i Fh(\003)p Ft(this,)h(const)h(char)g Fh(\003)p
Ft(key,)f(int)i(l,)f(int)h(mxval,)e(int)h Fh(\003)p Ft(nval,)227
-2765 y(const)g(char)g Fh(\003)p Ft(value)f(\))0 2923
-y Fd(P)m(arameters:)259 3069 y(this)427 3169 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(KeyMap.)259 3306 y Fd(k)m(ey)427 3406 y
-Fi(The)j(c)n(haracter)d(string)h(iden)n(tifying)i(the)f(v)-5
+5282 y(const)g(char)g Fh(\003)p Ft(value)f(\))0 5444
+y Fd(P)m(arameters:)259 5593 y(this)427 5693 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(KeyMap.)p eop end
+%%Page: 276 286
+TeXDict begin 276 285 bop 0 52 a FF(276)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(k)m(ey)427
+451 y Fi(The)h(c)n(haracter)d(string)h(iden)n(tifying)i(the)f(v)-5
b(alue)30 b(to)g(b)r(e)h(retriev)n(ed.)43 b(T)-7 b(railing)30
-b(spaces)f(are)g(ignored.)44 b(The)427 3505 y(supplied)26
+b(spaces)f(are)g(ignored.)44 b(The)427 551 y(supplied)26
b(string)f(is)g(con)n(v)n(erted)f(to)h(upp)r(er)g(case)g(b)r(efore)g
(use)g(if)h(the)g(KeyCase)e(attribute)h(is)g(curren)n(tly)g(set)427
-3605 y(to)j(zero.)259 3742 y Fd(mxv)-5 b(al)427 3842
-y Fi(The)28 b(n)n(um)n(b)r(er)f(of)h(elemen)n(ts)f(in)h(the)g
-Ft(")p Fi(v)-5 b(alue)p Ft(")27 b Fi(arra)n(y)-7 b(.)259
-3979 y Fd(n)m(v)i(al)427 4079 y Fi(The)24 b(address)f(of)h(an)f(in)n
-(teger)g(in)h(whic)n(h)g(to)g(put)g(the)g(n)n(um)n(b)r(er)g(of)g
-(elemen)n(ts)g(stored)f(in)h(the)g Ft(")p Fi(v)-5 b(alue)p
-Ft(")23 b Fi(arra)n(y)-7 b(.)427 4179 y(An)n(y)28 b(un)n(used)f(elemen)
-n(ts)h(of)f(the)h(arra)n(y)e(are)g(left)i(unc)n(hanged.)259
-4316 y Fd(v)-5 b(alue)427 4416 y Fi(A)34 b(p)r(oin)n(ter)f(to)g(an)g
+650 y(to)j(zero.)259 782 y Fd(mxv)-5 b(al)427 882 y Fi(The)28
+b(n)n(um)n(b)r(er)f(of)h(elemen)n(ts)f(in)h(the)g Ft(")p
+Fi(v)-5 b(alue)p Ft(")27 b Fi(arra)n(y)-7 b(.)259 1013
+y Fd(n)m(v)i(al)427 1113 y Fi(The)24 b(address)f(of)h(an)f(in)n(teger)g
+(in)h(whic)n(h)g(to)g(put)g(the)g(n)n(um)n(b)r(er)g(of)g(elemen)n(ts)g
+(stored)f(in)h(the)g Ft(")p Fi(v)-5 b(alue)p Ft(")23
+b Fi(arra)n(y)-7 b(.)427 1213 y(An)n(y)28 b(un)n(used)f(elemen)n(ts)h
+(of)f(the)h(arra)n(y)e(are)g(left)i(unc)n(hanged.)259
+1344 y Fd(v)-5 b(alue)427 1444 y Fi(A)34 b(p)r(oin)n(ter)f(to)g(an)g
(arra)n(y)d(in)k(whic)n(h)f(to)g(return)g(the)g(requested)g(v)-5
b(alues.)53 b(If)34 b(the)f(requested)g(k)n(ey)g(is)g(not)427
-4515 y(found,)g(or)e(if)h(it)h(is)e(found)h(but)h(has)e(an)g
+1544 y(found,)g(or)e(if)h(it)h(is)e(found)h(but)h(has)e(an)g
(unde\014ned)h(v)-5 b(alue)32 b(\(see)g(astMapPutU\),)f(then)h(the)h
-(con)n(ten)n(ts)e(of)427 4615 y(the)d(bu\013er)g(on)f(en)n(try)g(to)h
+(con)n(ten)n(ts)e(of)427 1643 y(the)d(bu\013er)g(on)f(en)n(try)g(to)h
(this)g(function)g(will)g(b)r(e)g(unc)n(hanged)f(on)g(exit.)0
-4786 y Fd(Returned)32 b(V)-8 b(alue:)259 4931 y(astMapGet1)p
-Fk(<)p Fd(X)p Fk(>)p Fd(\(\))427 5031 y Fi(A)37 b(non-zero)d(v)-5
+1804 y Fd(Returned)32 b(V)-8 b(alue:)259 1939 y(astMapGet1)p
+Fk(<)p Fd(X)p Fk(>)p Fd(\(\))427 2039 y Fi(A)37 b(non-zero)d(v)-5
b(alue)36 b(is)g(returned)f(if)i(the)f(requested)g(k)n(ey)f(name)h(w)n
(as)f(found,)j(and)e(do)r(es)g(not)g(ha)n(v)n(e)f(an)427
-5131 y(unde\014ned)28 b(v)-5 b(alue)28 b(\(see)f(astMapPutU\).)h(Zero)e
-(is)i(returned)f(otherwise.)0 5302 y Fd(Notes:)340 5593
+2139 y(unde\014ned)28 b(v)-5 b(alue)28 b(\(see)f(astMapPutU\).)h(Zero)e
+(is)i(returned)f(otherwise.)0 2299 y Fd(Notes:)340 2581
y Fh(\017)45 b Fi(No)31 b(error)e(is)h(rep)r(orted)g(if)i(the)f
(requested)f(k)n(ey)g(cannot)g(b)r(e)h(found)g(in)g(the)g(giv)n(en)f
-(KeyMap,)h(but)g(a)g(zero)427 5693 y(v)-5 b(alue)26 b(will)h(b)r(e)g
+(KeyMap,)h(but)g(a)g(zero)427 2680 y(v)-5 b(alue)26 b(will)h(b)r(e)g
(returned)f(as)f(the)i(function)g(v)-5 b(alue.)36 b(The)27
-b(supplied)f(arra)n(y)e(will)j(b)r(e)f(returned)g(unc)n(hanged.)p
-eop end
-%%Page: 276 286
-TeXDict begin 276 285 bop 0 52 a FF(276)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
-b Fi(If)26 b(the)f(stored)g(v)-5 b(alue)25 b(is)g(a)g(scalar)e(v)-5
-b(alue,)26 b(then)f(the)h(v)-5 b(alue)25 b(will)h(b)r(e)f(returned)g
-(in)g(the)h(\014rst)f(elemen)n(t)g(of)g(the)427 451 y(supplied)j(arra)n
-(y)-7 b(,)26 b(and)h Ft(")p Fi(n)n(v)-5 b(al)p Ft(")26
-b Fi(will)i(b)r(e)g(returned)f(set)h(to)g(1.)-2 603 y
-Fd(astMapGet1C)n(:)227 749 y Fi(The)d Ft(")p Fi(v)-5
-b(alue)p Ft(")24 b Fi(bu\013er)h(supplied)g(to)f(the)h(astMapGet1C)f
-(function)h(should)g(b)r(e)g(a)f(p)r(oin)n(ter)h(to)f(a)g(c)n(haracter)
-f(arra)n(y)227 849 y(with)29 b Ft(")p Fi(mxv)-5 b(al)p
-Fh(\003)p Fi(l)p Ft(")28 b Fi(elemen)n(ts,)g(where)g
+b(supplied)f(arra)n(y)e(will)j(b)r(e)f(returned)g(unc)n(hanged.)340
+2812 y Fh(\017)45 b Fi(If)26 b(the)f(stored)g(v)-5 b(alue)25
+b(is)g(a)g(scalar)e(v)-5 b(alue,)26 b(then)f(the)h(v)-5
+b(alue)25 b(will)h(b)r(e)f(returned)g(in)g(the)h(\014rst)f(elemen)n(t)g
+(of)g(the)427 2912 y(supplied)j(arra)n(y)-7 b(,)26 b(and)h
+Ft(")p Fi(n)n(v)-5 b(al)p Ft(")26 b Fi(will)i(b)r(e)g(returned)f(set)h
+(to)g(1.)-2 3073 y Fd(astMapGet1C)n(:)227 3219 y Fi(The)d
+Ft(")p Fi(v)-5 b(alue)p Ft(")24 b Fi(bu\013er)h(supplied)g(to)f(the)h
+(astMapGet1C)f(function)h(should)g(b)r(e)g(a)f(p)r(oin)n(ter)h(to)f(a)g
+(c)n(haracter)f(arra)n(y)227 3318 y(with)29 b Ft(")p
+Fi(mxv)-5 b(al)p Fh(\003)p Fi(l)p Ft(")28 b Fi(elemen)n(ts,)g(where)g
Ft(")p Fi(l)p Ft(")g Fi(is)h(the)g(maxim)n(um)f(length)h(of)f(a)g
(string)g(to)h(b)r(e)g(returned.)39 b(The)29 b(v)-5 b(alue)227
-948 y(of)25 b Ft(")p Fi(l)p Ft(")f Fi(should)g(b)r(e)h(supplied)h(as)e
+3418 y(of)25 b Ft(")p Fi(l)p Ft(")f Fi(should)g(b)r(e)h(supplied)h(as)e
(an)g(extra)g(parameter)f(follo)n(wing)h Ft(")p Fi(k)n(ey)p
Ft(")f Fi(when)i(in)n(v)n(oking)e(astMapGet1C,)h(and)227
-1048 y(should)k(include)g(space)e(for)i(a)f(terminating)g(n)n(ull)h(c)n
-(haracter.)-2 1188 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s(des)n(:)227
-1334 y Fi(T)-7 b(o)18 b(select)h(the)f(appropriate)f(function,)k(y)n
+3518 y(should)k(include)g(space)e(for)i(a)f(terminating)g(n)n(ull)h(c)n
+(haracter.)-2 3666 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s(des)n(:)227
+3812 y Fi(T)-7 b(o)18 b(select)h(the)f(appropriate)f(function,)k(y)n
(ou)c(should)h(replace)g Fk(<)p Fi(X)p Fk(>)g Fi(in)g(the)h(generic)e
(function)i(name)g(astMapGet1)p Fk(<)p Fi(X)p Fk(>)227
-1434 y Fi(with)35 b(a)f(1-c)n(haracter)e(data)h(t)n(yp)r(e)i(co)r(de,)h
+3912 y Fi(with)35 b(a)f(1-c)n(haracter)e(data)h(t)n(yp)r(e)i(co)r(de,)h
(so)e(as)f(to)i(matc)n(h)f(the)h(data)e(t)n(yp)r(e)i
Fk(<)p Fi(X)p Fk(>)p Fi(t)n(yp)r(e)f(of)g(the)h(data)f(y)n(ou)g(are)227
-1533 y(pro)r(cessing,)26 b(as)h(follo)n(ws:)340 1660
-y Fh(\017)45 b Fi(D:)28 b(double)340 1783 y Fh(\017)45
-b Fi(F:)28 b(\015oat)340 1906 y Fh(\017)45 b Fi(I:)28
-b(in)n(t)340 2030 y Fh(\017)45 b Fi(C:)28 b Ft(")p Fi(const)p
+4011 y(pro)r(cessing,)26 b(as)h(follo)n(ws:)340 4147
+y Fh(\017)45 b Fi(D:)28 b(double)340 4278 y Fh(\017)45
+b Fi(F:)28 b(\015oat)340 4410 y Fh(\017)45 b Fi(I:)28
+b(in)n(t)340 4542 y Fh(\017)45 b Fi(C:)28 b Ft(")p Fi(const)p
Ft(")e Fi(p)r(oin)n(ter)i(to)f(n)n(ull)h(terminated)f(c)n(haracter)f
-(string)340 2153 y Fh(\017)45 b Fi(A:)28 b(P)n(oin)n(ter)e(to)i(AstOb)5
-b(ject)340 2276 y Fh(\017)45 b Fi(P:)28 b(Generic)f Ft(")p
-Fi(v)n(oid)f Fh(\003)p Ft(")h Fi(p)r(oin)n(ter)340 2399
-y Fh(\017)45 b Fi(S:)28 b(short)f(in)n(t)340 2522 y Fh(\017)45
+(string)340 4674 y Fh(\017)45 b Fi(A:)28 b(P)n(oin)n(ter)e(to)i(AstOb)5
+b(ject)340 4805 y Fh(\017)45 b Fi(P:)28 b(Generic)f Ft(")p
+Fi(v)n(oid)f Fh(\003)p Ft(")h Fi(p)r(oin)n(ter)340 4937
+y Fh(\017)45 b Fi(S:)28 b(short)f(in)n(t)340 5069 y Fh(\017)45
b Fi(B:)28 b(Unsigned)f(b)n(yte)h(\(i.e.)37 b(c)n(har\))227
-2675 y(F)-7 b(or)32 b(example,)h(astMapGet1D)e(w)n(ould)h(b)r(e)g(used)
+5230 y(F)-7 b(or)32 b(example,)h(astMapGet1D)e(w)n(ould)h(b)r(e)g(used)
g(to)g(get)g Ft(")p Fi(double)p Ft(")f Fi(v)-5 b(alues,)33
-b(while)f(astMapGet1I)g(w)n(ould)f(b)r(e)227 2774 y(used)26
+b(while)f(astMapGet1I)g(w)n(ould)f(b)r(e)227 5329 y(used)26
b(to)f(get)g Ft(")p Fi(in)n(t)p Ft(")g Fi(v)-5 b(alues,)25
b(etc.)37 b(F)-7 b(or)24 b(D)i(or)f(I,)g(the)h(supplied)g
Ft(")p Fi(v)-5 b(alue)p Ft(")24 b Fi(parameter)g(should)h(b)r(e)h(a)f
-(p)r(oin)n(ter)g(to)g(an)227 2874 y(arra)n(y)f(of)j(doubles)f(or)g(in)n
+(p)r(oin)n(ter)g(to)g(an)227 5429 y(arra)n(y)f(of)j(doubles)f(or)g(in)n
(ts,)h(with)g Ft(")p Fi(mxv)-5 b(al)p Ft(")25 b Fi(elemen)n(ts.)37
b(F)-7 b(or)26 b(C,)g(the)h(supplied)g Ft(")p Fi(v)-5
b(alue)p Ft(")26 b Fi(parameter)f(should)h(b)r(e)227
-2974 y(a)32 b(p)r(oin)n(ter)f(to)h(a)f(c)n(haracter)f(string)h(with)h
+5529 y(a)32 b(p)r(oin)n(ter)f(to)h(a)f(c)n(haracter)f(string)h(with)h
Ft(")p Fi(mxv)-5 b(al)p Fh(\003)p Fi(l)p Ft(")30 b Fi(elemen)n(ts.)50
b(F)-7 b(or)31 b(A,)h(the)g(supplied)g Ft(")p Fi(v)-5
-b(alue)p Ft(")31 b Fi(parameter)227 3073 y(should)d(b)r(e)g(a)f(p)r
+b(alue)p Ft(")31 b Fi(parameter)227 5628 y(should)d(b)r(e)g(a)f(p)r
(oin)n(ter)g(to)g(an)h(arra)n(y)d(of)j(AstOb)5 b(ject)27
-b(p)r(oin)n(ters.)p 0 3253 3780 12 v 0 3385 a Fz(astMapGetElem)p
-Fc(<)p Fz(X)p Fc(>)344 b Fe(Get)39 b(a)f(single)1402
-3499 y(elemen)m(t)f(of)i(a)f(v)m(ector)1571 3599 y(v)-7
-b(alue)39 b(from)e(a)1672 3699 y(KeyMap)2539 3385 y Fz(astMapGetElem)p
-Fc(<)p Fz(X)p Fc(>)0 3868 y Fd(Description:)44 b Fi(This)26
-b(is)g(a)f(set)h(of)f(functions)h(for)f(retrieving)g(a)g(single)g
-(elemen)n(t)h(of)g(a)f(v)n(ector)f(v)-5 b(alue)26 b(from)f(a)g(KeyMap.)
-227 3968 y(Y)-7 b(ou)35 b(should)g(replace)f Fk(<)p Fi(X)p
-Fk(>)h Fi(in)g(the)h(generic)e(function)h(name)g(astMapGetElem)p
-Fk(<)p Fi(X)p Fk(>)f Fi(b)n(y)h(an)f(appropriate)227
-4068 y(1-c)n(haracter)25 b(t)n(yp)r(e)i(co)r(de)g(\(see)g(the)h
+b(p)r(oin)n(ters.)p eop end
+%%Page: 277 287
+TeXDict begin 277 286 bop 3643 52 a FF(277)p 0 351 3780
+12 v 0 483 a Fz(astMapGetElem)p Fc(<)p Fz(X)p Fc(>)344
+b Fe(Get)39 b(a)f(single)1402 598 y(elemen)m(t)f(of)i(a)f(v)m(ector)
+1571 697 y(v)-7 b(alue)39 b(from)e(a)1672 797 y(KeyMap)2539
+483 y Fz(astMapGetElem)p Fc(<)p Fz(X)p Fc(>)0 980 y Fd(Description:)44
+b Fi(This)26 b(is)g(a)f(set)h(of)f(functions)h(for)f(retrieving)g(a)g
+(single)g(elemen)n(t)h(of)g(a)f(v)n(ector)f(v)-5 b(alue)26
+b(from)f(a)g(KeyMap.)227 1080 y(Y)-7 b(ou)35 b(should)g(replace)f
+Fk(<)p Fi(X)p Fk(>)h Fi(in)g(the)h(generic)e(function)h(name)g
+(astMapGetElem)p Fk(<)p Fi(X)p Fk(>)f Fi(b)n(y)h(an)f(appropriate)227
+1180 y(1-c)n(haracter)25 b(t)n(yp)r(e)i(co)r(de)g(\(see)g(the)h
Ft(")p Fi(Data)f(T)n(yp)r(e)g(Co)r(des)p Ft(")f Fi(section)h(b)r(elo)n
(w)g(for)g(the)h(co)r(de)f(appropriate)e(to)i(eac)n(h)227
-4167 y(supp)r(orted)d(data)f(t)n(yp)r(e\).)36 b(The)24
+1279 y(supp)r(orted)d(data)f(t)n(yp)r(e\).)36 b(The)24
b(stored)f(v)-5 b(alue)23 b(is)h(con)n(v)n(erted)e(to)i(the)g(data)f(t)
n(yp)r(e)h(indiced)g(b)n(y)g Fk(<)p Fi(X)p Fk(>)f Fi(b)r(efore)h(b)r
-(eing)227 4267 y(returned)36 b(\(an)h(error)e(is)h(rep)r(orted)g(if)h
+(eing)227 1379 y(returned)36 b(\(an)h(error)e(is)h(rep)r(orted)g(if)h
(it)g(is)f(not)h(p)r(ossible)f(to)h(con)n(v)n(ert)e(the)i(stored)e(v)-5
-b(alue)37 b(to)f(the)h(requested)227 4366 y(data)31 b(t)n(yp)r(e\).)48
+b(alue)37 b(to)f(the)h(requested)227 1478 y(data)31 b(t)n(yp)r(e\).)48
b(Note,)32 b(the)g(astMapGetElemC)e(function)i(has)f(an)g(extra)f
(parameter)g Ft(")p Fi(l)p Ft(")g Fi(whic)n(h)h(sp)r(eci\014es)g(the)
-227 4466 y(maxim)n(um)38 b(length)g(of)h(the)f(string)f(to)h(b)r(e)h
+227 1578 y(maxim)n(um)38 b(length)g(of)h(the)f(string)f(to)h(b)r(e)h
(stored)e(in)i(the)f Ft(")p Fi(v)-5 b(alue)p Ft(")37
b Fi(bu\013er)i(\(see)f(the)g Ft(")p Fi(astMapGetElemC)p
-Ft(")227 4566 y Fi(section)27 b(b)r(elo)n(w\).)0 4705
+Ft(")227 1678 y Fi(section)27 b(b)r(elo)n(w\).)0 1824
y Fd(Synopsis:)121 b Ft(int)42 b(astMapGetElem)p Fk(<)p
Ft(X)p Fk(>)p Ft(\()37 b(AstKeyMap)j Fh(\003)p Ft(this,)h(const)g(char)
h Fh(\003)p Ft(key,)g(int)g(elem,)f Fk(<)p Ft(X)p Fk(>)p
-Ft(type)g Fh(\003)p Ft(value)227 4805 y(\))i(int)g(astMapGetElemC\()37
+Ft(type)g Fh(\003)p Ft(value)227 1924 y(\))i(int)g(astMapGetElemC\()37
b(AstKeyMap)j Fh(\003)p Ft(this,)h(const)h(char)g Fh(\003)p
Ft(key,)f(int)h(l,)h(int)f(elem,)g(char)g Fh(\003)p Ft(value)227
-4905 y(\))0 5045 y Fd(P)m(arameters:)259 5171 y(this)427
-5271 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)259 5394
-y Fd(k)m(ey)427 5494 y Fi(The)j(c)n(haracter)d(string)h(iden)n(tifying)
+2024 y(\))0 2170 y Fd(P)m(arameters:)259 2304 y(this)427
+2404 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)259 2534
+y Fd(k)m(ey)427 2634 y Fi(The)j(c)n(haracter)d(string)h(iden)n(tifying)
i(the)f(v)-5 b(alue)30 b(to)g(b)r(e)h(retriev)n(ed.)43
b(T)-7 b(railing)30 b(spaces)f(are)g(ignored.)44 b(The)427
-5593 y(supplied)26 b(string)f(is)g(con)n(v)n(erted)f(to)h(upp)r(er)g
+2733 y(supplied)26 b(string)f(is)g(con)n(v)n(erted)f(to)h(upp)r(er)g
(case)g(b)r(efore)g(use)g(if)h(the)g(KeyCase)e(attribute)h(is)g(curren)
-n(tly)g(set)427 5693 y(to)j(zero.)p eop end
-%%Page: 277 287
-TeXDict begin 277 286 bop 3643 52 a FF(277)259 351 y
-Fd(elem)427 451 y Fi(The)31 b(index)g(of)g(the)h(required)d(v)n(ector)h
-(elemen)n(t,)i(starting)e(at)h(zero.)46 b(An)31 b(error)e(will)i(b)r(e)
-h(rep)r(orted)e(if)h(the)427 551 y(v)-5 b(alue)28 b(is)f(outside)h(the)
-g(range)e(of)h(the)h(v)n(ector.)259 685 y Fd(v)-5 b(alue)427
-785 y Fi(A)23 b(p)r(oin)n(ter)f(to)g(a)g(bu\013er)g(in)h(whic)n(h)f(to)
-h(return)e(the)i(requested)f(v)-5 b(alue.)35 b(If)23
-b(the)f(requested)g(k)n(ey)g(is)g(not)g(found,)427 885
-y(or)i(if)g(it)h(is)f(found)g(but)h(has)f(an)g(unde\014ned)h(v)-5
-b(alue)24 b(\(see)g(astMapPutU\),)g(then)h(the)f(con)n(ten)n(ts)g(of)g
-(the)g(bu\013er)427 984 y(on)k(en)n(try)f(to)g(this)h(function)g(will)g
-(b)r(e)g(unc)n(hanged)f(on)g(exit.)0 1150 y Fd(Returned)32
-b(V)-8 b(alue:)259 1290 y(astMapGetElem)p Fk(<)p Fd(X)p
-Fk(>)p Fd(\(\))427 1390 y Fi(A)37 b(non-zero)d(v)-5 b(alue)36
-b(is)g(returned)f(if)i(the)f(requested)g(k)n(ey)f(name)h(w)n(as)f
-(found,)j(and)e(do)r(es)g(not)g(ha)n(v)n(e)f(an)427 1489
-y(unde\014ned)28 b(v)-5 b(alue)28 b(\(see)f(astMapPutU\).)h(Zero)e(is)i
-(returned)f(otherwise.)0 1655 y Fd(Notes:)340 1941 y
-Fh(\017)45 b Fi(No)30 b(error)e(is)i(rep)r(orted)f(if)h(the)h
-(requested)e(k)n(ey)g(cannot)h(b)r(e)g(found)g(in)g(the)h(giv)n(en)e
-(KeyMap,)g(or)g(if)i(it)f(has)427 2041 y(an)e(unde\014ned)g(v)-5
-b(alue,)27 b(but)i(a)e(zero)f(v)-5 b(alue)28 b(will)g(b)r(e)g(returned)
-f(as)g(the)h(function)g(v)-5 b(alue.)-2 2207 y Fd(astMapGetElemC)n(:)
-227 2353 y Fi(The)30 b Ft(")p Fi(v)-5 b(alue)p Ft(")29
-b Fi(bu\013er)h(supplied)g(to)f(the)h(astMapGetElemC)f(function)i
-(should)e(b)r(e)h(a)g(p)r(oin)n(ter)f(to)g(a)h(c)n(haracter)227
-2453 y(arra)n(y)25 b(with)i Ft(")p Fi(l)p Ft(")f Fi(elemen)n(ts,)h
-(where)f Ft(")p Fi(l)p Ft(")g Fi(is)g(the)h(maxim)n(um)g(length)g(of)f
-(the)h(string)f(to)h(b)r(e)g(returned.)36 b(The)27 b(v)-5
-b(alue)227 2552 y(of)26 b Ft(")p Fi(l)p Ft(")f Fi(should)h(b)r(e)g
-(supplied)g(as)f(an)h(extra)f(parameter)f(follo)n(wing)h
-Ft(")p Fi(k)n(ey)p Ft(")f Fi(when)i(in)n(v)n(oking)e(astMapGetElemC,)
-227 2652 y(and)k(should)f(include)h(space)f(for)g(a)g(terminating)g(n)n
-(ull)h(c)n(haracter.)-2 2805 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s(des)n(:)
-227 2951 y Fi(T)-7 b(o)18 b(select)h(the)f(appropriate)f(function,)k(y)
-n(ou)c(should)h(replace)g Fk(<)p Fi(X)p Fk(>)g Fi(in)g(the)h(generic)e
+n(tly)g(set)427 2833 y(to)j(zero.)259 2963 y Fd(elem)427
+3063 y Fi(The)j(index)g(of)g(the)h(required)d(v)n(ector)h(elemen)n(t,)i
+(starting)e(at)h(zero.)46 b(An)31 b(error)e(will)i(b)r(e)h(rep)r(orted)
+e(if)h(the)427 3162 y(v)-5 b(alue)28 b(is)f(outside)h(the)g(range)e(of)
+h(the)h(v)n(ector.)259 3292 y Fd(v)-5 b(alue)427 3392
+y Fi(A)23 b(p)r(oin)n(ter)f(to)g(a)g(bu\013er)g(in)h(whic)n(h)f(to)h
+(return)e(the)i(requested)f(v)-5 b(alue.)35 b(If)23 b(the)f(requested)g
+(k)n(ey)g(is)g(not)g(found,)427 3492 y(or)i(if)g(it)h(is)f(found)g(but)
+h(has)f(an)g(unde\014ned)h(v)-5 b(alue)24 b(\(see)g(astMapPutU\),)g
+(then)h(the)f(con)n(ten)n(ts)g(of)g(the)g(bu\013er)427
+3591 y(on)k(en)n(try)f(to)g(this)h(function)g(will)g(b)r(e)g(unc)n
+(hanged)f(on)g(exit.)0 3751 y Fd(Returned)32 b(V)-8 b(alue:)259
+3884 y(astMapGetElem)p Fk(<)p Fd(X)p Fk(>)p Fd(\(\))427
+3984 y Fi(A)37 b(non-zero)d(v)-5 b(alue)36 b(is)g(returned)f(if)i(the)f
+(requested)g(k)n(ey)f(name)h(w)n(as)f(found,)j(and)e(do)r(es)g(not)g
+(ha)n(v)n(e)f(an)427 4083 y(unde\014ned)28 b(v)-5 b(alue)28
+b(\(see)f(astMapPutU\).)h(Zero)e(is)i(returned)f(otherwise.)0
+4243 y Fd(Notes:)340 4523 y Fh(\017)45 b Fi(No)30 b(error)e(is)i(rep)r
+(orted)f(if)h(the)h(requested)e(k)n(ey)g(cannot)h(b)r(e)g(found)g(in)g
+(the)h(giv)n(en)e(KeyMap,)g(or)g(if)i(it)f(has)427 4622
+y(an)e(unde\014ned)g(v)-5 b(alue,)27 b(but)i(a)e(zero)f(v)-5
+b(alue)28 b(will)g(b)r(e)g(returned)f(as)g(the)h(function)g(v)-5
+b(alue.)-2 4781 y Fd(astMapGetElemC)n(:)227 4927 y Fi(The)30
+b Ft(")p Fi(v)-5 b(alue)p Ft(")29 b Fi(bu\013er)h(supplied)g(to)f(the)h
+(astMapGetElemC)f(function)i(should)e(b)r(e)h(a)g(p)r(oin)n(ter)f(to)g
+(a)h(c)n(haracter)227 5027 y(arra)n(y)25 b(with)i Ft(")p
+Fi(l)p Ft(")f Fi(elemen)n(ts,)h(where)f Ft(")p Fi(l)p
+Ft(")g Fi(is)g(the)h(maxim)n(um)g(length)g(of)f(the)h(string)f(to)h(b)r
+(e)g(returned.)36 b(The)27 b(v)-5 b(alue)227 5127 y(of)26
+b Ft(")p Fi(l)p Ft(")f Fi(should)h(b)r(e)g(supplied)g(as)f(an)h(extra)f
+(parameter)f(follo)n(wing)h Ft(")p Fi(k)n(ey)p Ft(")f
+Fi(when)i(in)n(v)n(oking)e(astMapGetElemC,)227 5226 y(and)k(should)f
+(include)h(space)f(for)g(a)g(terminating)g(n)n(ull)h(c)n(haracter.)-2
+5373 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s(des)n(:)227 5519
+y Fi(T)-7 b(o)18 b(select)h(the)f(appropriate)f(function,)k(y)n(ou)c
+(should)h(replace)g Fk(<)p Fi(X)p Fk(>)g Fi(in)g(the)h(generic)e
(function)i(name)g(astMapGetElem)p Fk(<)p Fi(X)p Fk(>)227
-3051 y Fi(with)35 b(a)f(1-c)n(haracter)e(data)h(t)n(yp)r(e)i(co)r(de,)h
+5619 y Fi(with)35 b(a)f(1-c)n(haracter)e(data)h(t)n(yp)r(e)i(co)r(de,)h
(so)e(as)f(to)i(matc)n(h)f(the)h(data)e(t)n(yp)r(e)i
Fk(<)p Fi(X)p Fk(>)p Fi(t)n(yp)r(e)f(of)g(the)h(data)f(y)n(ou)g(are)227
-3150 y(pro)r(cessing,)26 b(as)h(follo)n(ws:)340 3291
-y Fh(\017)45 b Fi(D:)28 b(double)340 3425 y Fh(\017)45
-b Fi(F:)28 b(\015oat)340 3560 y Fh(\017)45 b Fi(I:)28
-b(in)n(t)340 3695 y Fh(\017)45 b Fi(C:)28 b Ft(")p Fi(const)p
-Ft(")e Fi(p)r(oin)n(ter)i(to)f(n)n(ull)h(terminated)f(c)n(haracter)f
-(string)340 3830 y Fh(\017)45 b Fi(A:)28 b(P)n(oin)n(ter)e(to)i(AstOb)5
-b(ject)340 3964 y Fh(\017)45 b Fi(P:)28 b(Generic)f Ft(")p
-Fi(v)n(oid)f Fh(\003)p Ft(")h Fi(p)r(oin)n(ter)340 4099
-y Fh(\017)45 b Fi(S:)28 b(short)f(in)n(t)340 4234 y Fh(\017)45
-b Fi(B:)28 b(Unsigned)f(b)n(yte)h(\(i.e.)37 b(c)n(har\))227
-4400 y(F)-7 b(or)35 b(example,)h(astMapGetElemD)e(w)n(ould)h(b)r(e)g
-(used)g(to)g(get)f(a)h Ft(")p Fi(double)p Ft(")f Fi(v)-5
-b(alue,)36 b(while)f(astMapGetElemI)227 4499 y(w)n(ould)d(b)r(e)h(used)
-f(to)g(get)g(an)g Ft(")p Fi(in)n(t)p Ft(")g Fi(v)-5 b(alue,)33
-b(etc.)51 b(F)-7 b(or)32 b(D)g(or)g(I,)g(the)h(supplied)f
-Ft(")p Fi(v)-5 b(alue)p Ft(")31 b Fi(parameter)g(should)h(b)r(e)227
-4599 y(a)37 b(p)r(oin)n(ter)g(to)g(a)g(double)g(or)g(in)n(t.)66
+5718 y(pro)r(cessing,)26 b(as)h(follo)n(ws:)p eop end
+%%Page: 278 288
+TeXDict begin 278 287 bop 0 52 a FF(278)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Fi(D:)28 b(double)340 473 y Fh(\017)45 b Fi(F:)28 b(\015oat)340
+595 y Fh(\017)45 b Fi(I:)28 b(in)n(t)340 717 y Fh(\017)45
+b Fi(C:)28 b Ft(")p Fi(const)p Ft(")e Fi(p)r(oin)n(ter)i(to)f(n)n(ull)h
+(terminated)f(c)n(haracter)f(string)340 839 y Fh(\017)45
+b Fi(A:)28 b(P)n(oin)n(ter)e(to)i(AstOb)5 b(ject)340
+961 y Fh(\017)45 b Fi(P:)28 b(Generic)f Ft(")p Fi(v)n(oid)f
+Fh(\003)p Ft(")h Fi(p)r(oin)n(ter)340 1083 y Fh(\017)45
+b Fi(S:)28 b(short)f(in)n(t)340 1204 y Fh(\017)45 b Fi(B:)28
+b(Unsigned)f(b)n(yte)h(\(i.e.)37 b(c)n(har\))227 1355
+y(F)-7 b(or)35 b(example,)h(astMapGetElemD)e(w)n(ould)h(b)r(e)g(used)g
+(to)g(get)f(a)h Ft(")p Fi(double)p Ft(")f Fi(v)-5 b(alue,)36
+b(while)f(astMapGetElemI)227 1455 y(w)n(ould)d(b)r(e)h(used)f(to)g(get)
+g(an)g Ft(")p Fi(in)n(t)p Ft(")g Fi(v)-5 b(alue,)33 b(etc.)51
+b(F)-7 b(or)32 b(D)g(or)g(I,)g(the)h(supplied)f Ft(")p
+Fi(v)-5 b(alue)p Ft(")31 b Fi(parameter)g(should)h(b)r(e)227
+1555 y(a)37 b(p)r(oin)n(ter)g(to)g(a)g(double)g(or)g(in)n(t.)66
b(F)-7 b(or)37 b(C,)g(the)h(supplied)f Ft(")p Fi(v)-5
b(alue)p Ft(")37 b Fi(parameter)e(should)i(b)r(e)h(a)f(p)r(oin)n(ter)g
-(to)g(a)227 4698 y(c)n(haracter)27 b(string)h(with)h
+(to)g(a)227 1654 y(c)n(haracter)27 b(string)h(with)h
Ft(")p Fi(l)p Ft(")f Fi(elemen)n(ts.)40 b(F)-7 b(or)28
b(A,)h(the)g(supplied)g Ft(")p Fi(v)-5 b(alue)p Ft(")28
b Fi(parameter)f(should)h(b)r(e)h(a)f(p)r(oin)n(ter)h(to)227
-4798 y(an)f(AstOb)5 b(ject)27 b(p)r(oin)n(ter.)p 0 5001
-3780 12 v 0 5132 a Fz(astMapHasKey)1111 5133 y Fe(Chec)m(k)38
-b(if)g(an)h(en)m(try)f(with)f(a)i(giv)m(en)1288 5247
-y(k)m(ey)f(exists)g(in)h(a)f(KeyMap)2880 5132 y Fz(astMapHasKey)0
-5440 y Fd(Description:)44 b Fi(This)33 b(function)h(returns)f(a)f
+1754 y(an)f(AstOb)5 b(ject)27 b(p)r(oin)n(ter.)p 0 1931
+3780 12 v 0 2062 a Fz(astMapHasKey)1111 2063 y Fe(Chec)m(k)38
+b(if)g(an)h(en)m(try)f(with)f(a)i(giv)m(en)1288 2178
+y(k)m(ey)f(exists)g(in)h(a)f(KeyMap)2880 2062 y Fz(astMapHasKey)0
+2344 y Fd(Description:)44 b Fi(This)33 b(function)h(returns)f(a)f
(\015ag)h(indicating)f(if)i(the)g(KeyMap)e(con)n(tains)g(an)h(en)n(try)
-f(with)i(the)f(giv)n(en)227 5540 y(k)n(ey)-7 b(.)0 5693
+f(with)i(the)f(giv)n(en)227 2444 y(k)n(ey)-7 b(.)0 2583
y Fd(Synopsis:)121 b Ft(int)42 b(astMapHasKey\()c(AstKeyMap)i
-Fh(\003)p Ft(this,)h(const)h(char)g Fh(\003)p Ft(key)g(\))p
-eop end
-%%Page: 278 288
-TeXDict begin 278 287 bop 0 52 a FF(278)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(P)m(arameters:)259
-485 y(this)427 584 y Fi(P)n(oin)n(ter)c(to)i(the)g(KeyMap.)259
-714 y Fd(k)m(ey)427 814 y Fi(The)23 b(c)n(haracter)d(string)i(iden)n
-(tifying)h(the)f(KeyMap)g(en)n(try)-7 b(.)35 b(T)-7 b(railing)21
-b(spaces)g(are)h(ignored.)34 b(The)22 b(supplied)427
-914 y(string)j(is)f(con)n(v)n(erted)g(to)h(upp)r(er)g(case)f(b)r(efore)
-h(use)g(if)g(the)g(KeyCase)f(attribute)h(is)g(curren)n(tly)f(set)h(to)g
-(zero.)0 1073 y Fd(Returned)32 b(V)-8 b(alue:)259 1206
-y(astMapHasKey\(\))427 1306 y Fi(Non-zero)26 b(if)i(the)g(k)n(ey)f(w)n
-(as)g(found,)h(and)f(zero)g(otherwise.)0 1465 y Fd(Notes:)340
-1744 y Fh(\017)45 b Fi(A)32 b(non-zero)f(function)h(v)-5
-b(alue)32 b(is)f(returned)h(if)g(the)g(k)n(ey)f(exists)h(but)g(has)g
-(an)f(unde\014ned)i(v)-5 b(alue)31 b(\(that)i(is,)427
-1844 y(the)g(returned)f(v)-5 b(alue)33 b(do)r(es)f(not)h(dep)r(end)g
-(on)f(whether)g(the)h(en)n(try)f(has)g(a)h(de\014ned)f(v)-5
-b(alue)33 b(or)f(not\).)52 b(See)427 1943 y(also)27 b(astMapDe\014ned,)
-g(whic)n(h)h(returns)f(zero)f(in)i(suc)n(h)f(a)h(case.)340
-2073 y Fh(\017)45 b Fi(A)29 b(function)g(v)-5 b(alue)28
-b(of)g(zero)f(will)h(b)r(e)h(returned)e(if)i(an)f(error)e(has)i
-(already)e(o)r(ccurred,)i(or)f(if)i(this)f(function)427
-2173 y(should)g(fail)f(for)g(an)n(y)g(reason.)p 0 2366
-3780 12 v 0 2497 a Fz(astMapKey)875 2498 y Fe(Get)38
-b(the)h(k)m(ey)f(at)g(a)h(giv)m(en)f(index)g(within)f(the)1672
-2611 y(KeyMap)3103 2497 y Fz(astMapKey)0 2794 y Fd(Description:)44
-b Fi(This)31 b(function)g(returns)e(a)h(string)g(holding)g(the)h(k)n
-(ey)f(for)g(the)g(en)n(try)g(with)h(the)g(giv)n(en)e(index)i(within)227
-2894 y(the)d(KeyMap.)227 3017 y(This)k(function)f(is)h(in)n(tended)f
+Fh(\003)p Ft(this,)h(const)h(char)g Fh(\003)p Ft(key)g(\))0
+2721 y Fd(P)m(arameters:)259 2847 y(this)427 2946 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(KeyMap.)259 3068 y Fd(k)m(ey)427 3168 y
+Fi(The)23 b(c)n(haracter)d(string)i(iden)n(tifying)h(the)f(KeyMap)g(en)
+n(try)-7 b(.)35 b(T)-7 b(railing)21 b(spaces)g(are)h(ignored.)34
+b(The)22 b(supplied)427 3267 y(string)j(is)f(con)n(v)n(erted)g(to)h
+(upp)r(er)g(case)f(b)r(efore)h(use)g(if)g(the)g(KeyCase)f(attribute)h
+(is)g(curren)n(tly)f(set)h(to)g(zero.)0 3418 y Fd(Returned)32
+b(V)-8 b(alue:)259 3544 y(astMapHasKey\(\))427 3643 y
+Fi(Non-zero)26 b(if)i(the)g(k)n(ey)f(w)n(as)g(found,)h(and)f(zero)g
+(otherwise.)0 3794 y Fd(Notes:)340 4066 y Fh(\017)45
+b Fi(A)32 b(non-zero)f(function)h(v)-5 b(alue)32 b(is)f(returned)h(if)g
+(the)g(k)n(ey)f(exists)h(but)g(has)g(an)f(unde\014ned)i(v)-5
+b(alue)31 b(\(that)i(is,)427 4165 y(the)g(returned)f(v)-5
+b(alue)33 b(do)r(es)f(not)h(dep)r(end)g(on)f(whether)g(the)h(en)n(try)f
+(has)g(a)h(de\014ned)f(v)-5 b(alue)33 b(or)f(not\).)52
+b(See)427 4265 y(also)27 b(astMapDe\014ned,)g(whic)n(h)h(returns)f
+(zero)f(in)i(suc)n(h)f(a)h(case.)340 4387 y Fh(\017)45
+b Fi(A)29 b(function)g(v)-5 b(alue)28 b(of)g(zero)f(will)h(b)r(e)h
+(returned)e(if)i(an)f(error)e(has)i(already)e(o)r(ccurred,)i(or)f(if)i
+(this)f(function)427 4487 y(should)g(fail)f(for)g(an)n(y)g(reason.)p
+0 4664 V 0 4795 a Fz(astMapKey)875 4796 y Fe(Get)38 b(the)h(k)m(ey)f
+(at)g(a)h(giv)m(en)f(index)g(within)f(the)1672 4909 y(KeyMap)3103
+4795 y Fz(astMapKey)0 5076 y Fd(Description:)44 b Fi(This)31
+b(function)g(returns)e(a)h(string)g(holding)g(the)h(k)n(ey)f(for)g(the)
+g(en)n(try)g(with)h(the)g(giv)n(en)e(index)i(within)227
+5175 y(the)d(KeyMap.)227 5295 y(This)k(function)f(is)h(in)n(tended)f
(primarily)g(as)f(a)h(means)g(of)g(iterating)g(round)g(all)g(the)h
-(elemen)n(ts)f(in)h(a)e(KeyMap.)227 3117 y(F)-7 b(or)24
+(elemen)n(ts)f(in)h(a)e(KeyMap.)227 5394 y(F)-7 b(or)24
b(this)h(purp)r(ose,)g(the)g(n)n(um)n(b)r(er)f(of)g(en)n(tries)g(in)h
(the)g(KeyMap)e(should)i(\014rst)f(b)r(e)h(found)g(using)f(astMapSize)g
-(and)227 3216 y(this)i(function)g(should)f(then)h(b)r(e)f(called)g(in)h
+(and)227 5494 y(this)i(function)g(should)f(then)h(b)r(e)f(called)g(in)h
(a)f(lo)r(op,)g(with)h(the)g(index)f(v)-5 b(alue)25 b(going)f(from)h
-(zero)g(to)g(one)g(less)f(than)227 3316 y(the)36 b(size)e(of)h(the)h
+(zero)g(to)g(one)g(less)f(than)227 5593 y(the)36 b(size)e(of)h(the)h
(KeyMap.)58 b(The)35 b(index)g(asso)r(ciated)f(with)h(a)g(giv)n(en)f
(en)n(try)g(is)h(determined)g(b)n(y)g(the)g(SortBy)227
-3416 y(attribute.)0 3562 y Fd(Synopsis:)121 b Ft(const)41
-b(char)h Fh(\003)p Ft(astMapKey\()d(AstKeyMap)h Fh(\003)p
-Ft(this,)h(int)i(index)e(\))0 3709 y Fd(P)m(arameters:)259
-3842 y(this)427 3942 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)259
-4072 y Fd(index)427 4171 y Fi(The)g(index)g(in)n(to)g(the)g(KeyMap.)37
+5693 y(attribute.)p eop end
+%%Page: 279 289
+TeXDict begin 279 288 bop 3643 52 a FF(279)0 351 y Fd(Synopsis:)121
+b Ft(const)41 b(char)h Fh(\003)p Ft(astMapKey\()d(AstKeyMap)h
+Fh(\003)p Ft(this,)h(int)i(index)e(\))0 514 y Fd(P)m(arameters:)259
+663 y(this)427 762 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)259
+902 y Fd(index)427 1001 y Fi(The)g(index)g(in)n(to)g(the)g(KeyMap.)37
b(The)28 b(\014rst)g(en)n(try)f(has)g(index)i(zero,)d(and)i(the)h(last)
-e(has)g(index)i Ft(")p Fi(size-1)p Ft(")p Fi(,)427 4271
+e(has)g(index)i Ft(")p Fi(size-1)p Ft(")p Fi(,)427 1101
y(where)e Ft(")p Fi(size)p Ft(")g Fi(is)g(the)h(v)-5
b(alue)28 b(returned)f(b)n(y)g(the)h(astMapSize)f(function.)0
-4430 y Fd(Returned)32 b(V)-8 b(alue:)259 4563 y(astMapKey\(\))427
-4663 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(a)f(n)n(ull-terminated)g(string)g
-(con)n(taining)g(the)h(k)n(ey)-7 b(.)0 4822 y Fd(Notes:)340
-5102 y Fh(\017)45 b Fi(The)36 b(returned)g(p)r(oin)n(ter)g(is)g(guaran)
+1276 y Fd(Returned)32 b(V)-8 b(alue:)259 1425 y(astMapKey\(\))427
+1525 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(a)f(n)n(ull-terminated)g(string)g
+(con)n(taining)g(the)h(k)n(ey)-7 b(.)0 1699 y Fd(Notes:)340
+1995 y Fh(\017)45 b Fi(The)36 b(returned)g(p)r(oin)n(ter)g(is)g(guaran)
n(teed)e(to)i(remain)g(v)-5 b(alid)36 b(and)g(the)g(string)g(to)g(whic)
-n(h)g(it)g(p)r(oin)n(ts)g(will)427 5201 y(not)c(b)r(e)g(o)n(v)n
+n(h)g(it)g(p)r(oin)n(ts)g(will)427 2094 y(not)c(b)r(e)g(o)n(v)n
(er-written)e(for)i(a)f(total)h(of)g(50)f(successiv)n(e)f(in)n(v)n(o)r
(cations)g(of)i(this)g(function.)51 b(After)32 b(this,)h(the)427
-5301 y(memory)27 b(con)n(taining)f(the)i(string)f(ma)n(y)f(b)r(e)i
+2194 y(memory)27 b(con)n(taining)f(the)i(string)f(ma)n(y)f(b)r(e)i
(re-used,)e(so)h(a)g(cop)n(y)f(of)i(the)f(string)g(should)g(b)r(e)h
-(made)f(if)h(it)g(is)427 5400 y(needed)g(for)f(longer)f(than)i(this.)
-340 5530 y Fh(\017)45 b Fi(A)26 b(NULL)g(p)r(oin)n(ter)e(will)i(b)r(e)f
+(made)f(if)h(it)g(is)427 2294 y(needed)g(for)f(longer)f(than)i(this.)
+340 2433 y Fh(\017)45 b Fi(A)26 b(NULL)g(p)r(oin)n(ter)e(will)i(b)r(e)f
(returned)g(if)h(this)g(function)f(is)h(in)n(v)n(ok)n(ed)d(with)j(the)g
-(AST)f(error)f(status)h(set,)g(or)427 5630 y(if)j(it)g(should)g(fail)f
-(for)h(an)n(y)e(reason.)p eop end
-%%Page: 279 289
-TeXDict begin 279 288 bop 3643 52 a FF(279)p 0 351 3780
-12 v 0 482 a Fz(astMapLenC)1019 483 y Fe(Get)39 b(the)f(n)m(um)m(b)s
-(er)g(of)h(c)m(haracters)d(in)j(a)1147 583 y(c)m(haracter)d(en)m(try)i
-(in)h(a)f(KeyMap)3027 482 y Fz(astMapLenC)0 761 y Fd(Description:)44
-b Fi(This)26 b(function)g(returns)f(the)h(minim)n(um)g(length)f(whic)n
-(h)h(a)f(c)n(haracter)e(v)-5 b(ariable)25 b(whic)n(h)g(m)n(ust)h(ha)n
-(v)n(e)e(in)227 860 y(order)i(to)i(b)r(e)g(able)f(to)g(store)g(a)g(sp)r
-(eci\014ed)g(en)n(try)g(in)h(the)g(supplied)g(KeyMap.)36
-b(If)27 b(the)h(named)g(en)n(try)f(is)g(a)g(v)n(ector)227
-960 y(en)n(try)-7 b(,)27 b(then)i(the)f(returned)f(v)-5
-b(alue)27 b(is)h(the)g(length)f(of)h(the)g(longest)f(elemen)n(t)g(of)h
-(the)g(v)n(ector)e(v)-5 b(alue.)0 1104 y Fd(Synopsis:)121
-b Ft(int)42 b(astMapLenC\()d(AstKeyMap)h Fh(\003)p Ft(this,)h(const)h
-(char)g Fh(\003)p Ft(key)f(\))0 1248 y Fd(P)m(arameters:)259
-1379 y(this)427 1478 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)259
-1606 y Fd(k)m(ey)427 1705 y Fi(The)23 b(c)n(haracter)d(string)i(iden)n
+(AST)f(error)f(status)h(set,)g(or)427 2532 y(if)j(it)g(should)g(fail)f
+(for)h(an)n(y)e(reason.)p 0 2745 3780 12 v 0 2875 a Fz(astMapLenC)1019
+2876 y Fe(Get)39 b(the)f(n)m(um)m(b)s(er)g(of)h(c)m(haracters)d(in)j(a)
+1147 2976 y(c)m(haracter)d(en)m(try)i(in)h(a)f(KeyMap)3027
+2875 y Fz(astMapLenC)0 3178 y Fd(Description:)44 b Fi(This)26
+b(function)g(returns)f(the)h(minim)n(um)g(length)f(whic)n(h)h(a)f(c)n
+(haracter)e(v)-5 b(ariable)25 b(whic)n(h)g(m)n(ust)h(ha)n(v)n(e)e(in)
+227 3277 y(order)i(to)i(b)r(e)g(able)f(to)g(store)g(a)g(sp)r(eci\014ed)
+g(en)n(try)g(in)h(the)g(supplied)g(KeyMap.)36 b(If)27
+b(the)h(named)g(en)n(try)f(is)g(a)g(v)n(ector)227 3377
+y(en)n(try)-7 b(,)27 b(then)i(the)f(returned)f(v)-5 b(alue)27
+b(is)h(the)g(length)f(of)h(the)g(longest)f(elemen)n(t)g(of)h(the)g(v)n
+(ector)e(v)-5 b(alue.)0 3539 y Fd(Synopsis:)121 b Ft(int)42
+b(astMapLenC\()d(AstKeyMap)h Fh(\003)p Ft(this,)h(const)h(char)g
+Fh(\003)p Ft(key)f(\))0 3701 y Fd(P)m(arameters:)259
+3851 y(this)427 3950 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)259
+4090 y Fd(k)m(ey)427 4189 y Fi(The)23 b(c)n(haracter)d(string)i(iden)n
(tifying)h(the)f(KeyMap)g(en)n(try)-7 b(.)35 b(T)-7 b(railing)21
b(spaces)g(are)h(ignored.)34 b(The)22 b(supplied)427
-1805 y(string)j(is)f(con)n(v)n(erted)g(to)h(upp)r(er)g(case)f(b)r
+4289 y(string)j(is)f(con)n(v)n(erted)g(to)h(upp)r(er)g(case)f(b)r
(efore)h(use)g(if)g(the)g(KeyCase)f(attribute)h(is)g(curren)n(tly)f
-(set)h(to)g(zero.)0 1961 y Fd(Returned)32 b(V)-8 b(alue:)259
-2092 y(astMapLenC\(\))427 2192 y Fi(The)35 b(length)g(\(i.e.)59
+(set)h(to)g(zero.)0 4464 y Fd(Returned)32 b(V)-8 b(alue:)259
+4613 y(astMapLenC\(\))427 4712 y Fi(The)35 b(length)g(\(i.e.)59
b(n)n(um)n(b)r(er)35 b(of)g(c)n(haracters\))e(of)h(the)i(longest)e
(formatted)g(v)-5 b(alue)35 b(asso)r(ciated)f(with)h(the)427
-2292 y(named)28 b(en)n(try)-7 b(.)36 b(This)28 b(do)r(es)f(not)h
+4812 y(named)28 b(en)n(try)-7 b(.)36 b(This)28 b(do)r(es)f(not)h
(include)g(the)g(trailing)e(n)n(ull)i(c)n(haracter.)0
-2448 y Fd(Notes:)340 2725 y Fh(\017)45 b Fi(A)21 b(function)g(v)-5
+4987 y Fd(Notes:)340 5282 y Fh(\017)45 b Fi(A)21 b(function)g(v)-5
b(alue)21 b(of)f(zero)f(will)i(b)r(e)g(returned)f(without)h(error)e(if)
i(the)g(named)f(en)n(try)g(cannot)g(b)r(e)h(formatted)427
-2825 y(as)27 b(a)g(c)n(haracter)f(string.)340 2952 y
+5382 y(as)27 b(a)g(c)n(haracter)f(string.)340 5521 y
Fh(\017)45 b Fi(A)29 b(function)g(v)-5 b(alue)28 b(of)g(zero)f(will)h
(b)r(e)h(returned)e(if)i(an)f(error)e(has)i(already)e(o)r(ccurred,)i
-(or)f(if)i(this)f(function)427 3052 y(should)g(fail)f(for)g(an)n(y)g
-(reason.)p 0 3240 V 0 3372 a Fz(astMapLength)190 b Fe(Get)38
-b(the)h(v)m(ector)e(length)h(of)g(an)h(en)m(try)1555
-3485 y(in)f(a)h(KeyMap)2930 3372 y Fz(astMapLength)0
-3668 y Fd(Description:)44 b Fi(This)23 b(function)f(returns)g(the)g(v)n
-(ector)f(length)h(of)h(a)e(named)h(en)n(try)g(in)g(a)g(KeyMap,)h
-(\(that)f(is,)i(ho)n(w)d(man)n(y)227 3767 y(v)-5 b(alues)27
-b(are)g(asso)r(ciated)f(with)i(the)g(en)n(try\).)0 3911
-y Fd(Synopsis:)121 b Ft(int)42 b(astMapLength\()c(AstKeyMap)i
+(or)f(if)i(this)f(function)427 5621 y(should)g(fail)f(for)g(an)n(y)g
+(reason.)p eop end
+%%Page: 280 290
+TeXDict begin 280 289 bop 0 52 a FF(280)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 483 a Fz(astMapLength)190 b Fe(Get)38 b(the)h(v)m(ector)e(length)h
+(of)g(an)h(en)m(try)1555 596 y(in)f(a)h(KeyMap)2930 483
+y Fz(astMapLength)0 798 y Fd(Description:)44 b Fi(This)23
+b(function)f(returns)g(the)g(v)n(ector)f(length)h(of)h(a)e(named)h(en)n
+(try)g(in)g(a)g(KeyMap,)h(\(that)f(is,)i(ho)n(w)d(man)n(y)227
+898 y(v)-5 b(alues)27 b(are)g(asso)r(ciated)f(with)i(the)g(en)n(try\).)
+0 1056 y Fd(Synopsis:)121 b Ft(int)42 b(astMapLength\()c(AstKeyMap)i
Fh(\003)p Ft(this,)h(const)h(char)g Fh(\003)p Ft(key)g(\))0
-4055 y Fd(P)m(arameters:)259 4186 y(this)427 4286 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(KeyMap.)259 4413 y Fd(k)m(ey)427 4513 y
+1214 y Fd(P)m(arameters:)259 1359 y(this)427 1459 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(KeyMap.)259 1596 y Fd(k)m(ey)427 1696 y
Fi(The)23 b(c)n(haracter)d(string)i(iden)n(tifying)h(the)f(KeyMap)g(en)
n(try)-7 b(.)35 b(T)-7 b(railing)21 b(spaces)g(are)h(ignored.)34
-b(The)22 b(supplied)427 4613 y(string)j(is)f(con)n(v)n(erted)g(to)h
+b(The)22 b(supplied)427 1795 y(string)j(is)f(con)n(v)n(erted)g(to)h
(upp)r(er)g(case)f(b)r(efore)h(use)g(if)g(the)g(KeyCase)f(attribute)h
-(is)g(curren)n(tly)f(set)h(to)g(zero.)0 4769 y Fd(Returned)32
-b(V)-8 b(alue:)259 4900 y(astMapLength\(\))427 5000 y
+(is)g(curren)n(tly)f(set)h(to)g(zero.)0 1966 y Fd(Returned)32
+b(V)-8 b(alue:)259 2111 y(astMapLength\(\))427 2211 y
Fi(The)31 b(length)h(of)f(the)g(en)n(try)-7 b(.)47 b(One)31
b(for)f(a)h(scalar,)g(greater)e(than)i(one)g(for)f(a)h(v)n(ector.)46
-b(A)32 b(v)-5 b(alue)31 b(of)g(zero)f(is)427 5099 y(returned)d(if)i
+b(A)32 b(v)-5 b(alue)31 b(of)g(zero)f(is)427 2310 y(returned)d(if)i
(the)f(KeyMap)e(do)r(es)h(not)h(con)n(tain)f(the)h(named)f(en)n(try)-7
-b(.)0 5256 y Fd(Notes:)340 5533 y Fh(\017)45 b Fi(A)29
+b(.)0 2481 y Fd(Notes:)340 2772 y Fh(\017)45 b Fi(A)29
b(function)g(v)-5 b(alue)28 b(of)g(zero)f(will)h(b)r(e)h(returned)e(if)
i(an)f(error)e(has)i(already)e(o)r(ccurred,)i(or)f(if)i(this)f
-(function)427 5632 y(should)g(fail)f(for)g(an)n(y)g(reason.)p
-eop end
-%%Page: 280 290
-TeXDict begin 280 289 bop 0 52 a FF(280)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 482 a Fz(astMapPut0)p Fc(<)p Fz(X)p Fc(>)1294 483 y
-Fe(Add)39 b(a)g(scalar)e(v)-7 b(alue)39 b(to)f(a)1672
-583 y(KeyMap)2771 482 y Fz(astMapPut0)p Fc(<)p Fz(X)p
-Fc(>)0 744 y Fd(Description:)44 b Fi(This)24 b(is)g(a)f(set)h(of)f
+(function)427 2872 y(should)g(fail)f(for)g(an)n(y)g(reason.)p
+0 3080 V 0 3211 a Fz(astMapPut0)p Fc(<)p Fz(X)p Fc(>)1294
+3212 y Fe(Add)39 b(a)g(scalar)e(v)-7 b(alue)39 b(to)f(a)1672
+3311 y(KeyMap)2771 3211 y Fz(astMapPut0)p Fc(<)p Fz(X)p
+Fc(>)0 3509 y Fd(Description:)44 b Fi(This)24 b(is)g(a)f(set)h(of)f
(functions)h(for)g(adding)f(scalar)f(v)-5 b(alues)23
b(to)h(a)f(KeyMap.)35 b(Y)-7 b(ou)24 b(should)f(use)h(a)f(function)227
-844 y(whic)n(h)i(matc)n(hes)g(the)h(data)f(t)n(yp)r(e)g(of)g(the)h
+3608 y(whic)n(h)i(matc)n(hes)g(the)h(data)f(t)n(yp)r(e)g(of)g(the)h
(data)f(y)n(ou)f(wish)h(to)h(add)f(to)g(the)h(KeyMap)e(b)n(y)h
-(replacing)f Fk(<)p Fi(X)p Fk(>)h Fi(in)g(the)227 943
+(replacing)f Fk(<)p Fi(X)p Fk(>)h Fi(in)g(the)227 3708
y(generic)30 b(function)h(name)g(astMapPut0)p Fk(<)p
Fi(X)p Fk(>)e Fi(b)n(y)h(an)h(appropriate)e(1-c)n(haracter)f(t)n(yp)r
-(e)j(co)r(de)f(\(see)h(the)g Ft(")p Fi(Data)227 1043
+(e)j(co)r(de)f(\(see)h(the)g Ft(")p Fi(Data)227 3808
y(T)n(yp)r(e)d(Co)r(des)p Ft(")f Fi(section)g(b)r(elo)n(w)g(for)g(the)h
(co)r(de)f(appropriate)f(to)i(eac)n(h)f(supp)r(orted)g(data)g(t)n(yp)r
-(e\).)0 1179 y Fd(Synopsis:)121 b Ft(void)42 b(astMapPut0)p
+(e\).)0 3966 y Fd(Synopsis:)121 b Ft(void)42 b(astMapPut0)p
Fk(<)p Ft(X)p Fk(>)p Ft(\()c(AstKeyMap)h Fh(\003)p Ft(this,)i(const)h
(char)g Fh(\003)p Ft(key,)f Fk(<)p Ft(X)p Fk(>)p Ft(type)g(value,)g
-(const)227 1278 y(char)h Fh(\003)p Ft(comment)e(\);)0
-1414 y Fd(P)m(arameters:)259 1537 y(this)427 1636 y Fi(P)n(oin)n(ter)26
+(const)227 4065 y(char)h Fh(\003)p Ft(comment)e(\);)0
+4224 y Fd(P)m(arameters:)259 4369 y(this)427 4468 y Fi(P)n(oin)n(ter)26
b(to)i(the)g(KeyMap)e(in)i(whic)n(h)g(to)f(store)g(the)h(supplied)g(v)
--5 b(alue.)259 1755 y Fd(k)m(ey)427 1855 y Fi(A)27 b(c)n(haracter)e
+-5 b(alue.)259 4605 y Fd(k)m(ey)427 4705 y Fi(A)27 b(c)n(haracter)e
(string)h(to)h(b)r(e)g(stored)f(with)i(the)f(v)-5 b(alue,)27
b(whic)n(h)g(can)f(later)g(b)r(e)i(used)e(to)h(iden)n(tify)g(the)h(v)-5
-b(alue.)427 1955 y(T)e(railing)28 b(spaces)h(are)f(ignored.)40
+b(alue.)427 4805 y(T)e(railing)28 b(spaces)h(are)f(ignored.)40
b(The)29 b(supplied)h(string)e(is)h(con)n(v)n(erted)f(to)h(upp)r(er)g
-(case)g(b)r(efore)g(use)g(if)g(the)427 2054 y(KeyCase)d(attribute)i(is)
-g(curren)n(tly)e(set)i(to)f(zero.)259 2173 y Fd(v)-5
-b(alue)427 2273 y Fi(The)29 b(v)-5 b(alue)28 b(to)g(b)r(e)h(stored.)38
+(case)g(b)r(efore)g(use)g(if)g(the)427 4904 y(KeyCase)d(attribute)i(is)
+g(curren)n(tly)e(set)i(to)f(zero.)259 5042 y Fd(v)-5
+b(alue)427 5141 y Fi(The)29 b(v)-5 b(alue)28 b(to)g(b)r(e)h(stored.)38
b(The)28 b(data)g(t)n(yp)r(e)h(of)f(this)h(v)-5 b(alue)28
b(should)g(matc)n(h)g(the)h(1-c)n(haracter)c(t)n(yp)r(e)k(co)r(de)427
-2373 y(app)r(ended)j(to)g(the)g(function)g(name)g(\(e.g.)49
+5241 y(app)r(ended)j(to)g(the)g(function)g(name)g(\(e.g.)49
b(if)32 b(y)n(ou)f(are)g(using)g(astMapPut0A,)g(the)h(t)n(yp)r(e)g(of)g
-(this)g(v)-5 b(alue)427 2472 y(should)28 b(b)r(e)g Ft(")p
+(this)g(v)-5 b(alue)427 5340 y(should)28 b(b)r(e)g Ft(")p
Fi(p)r(oin)n(ter)e(to)i(AstOb)5 b(ject)p Ft(")p Fi(\).)259
-2592 y Fd(commen)m(t)427 2691 y Fi(A)27 b(p)r(oin)n(ter)e(to)h(a)f(n)n
+5478 y Fd(commen)m(t)427 5577 y Fi(A)27 b(p)r(oin)n(ter)e(to)h(a)f(n)n
(ull-terminated)h(commen)n(t)g(string)f(to)h(b)r(e)g(stored)f(with)i
(the)f(v)-5 b(alue.)36 b(A)27 b(NULL)f(p)r(oin)n(ter)427
-2791 y(ma)n(y)h(b)r(e)h(supplied,)g(in)g(whic)n(h)g(case)e(no)i(commen)
-n(t)f(is)h(stored.)0 2939 y Fd(Notes:)340 3208 y Fh(\017)45
-b Fi(If)27 b(the)f(supplied)h(k)n(ey)e(is)h(already)f(in)h(use)g(in)h
-(the)f(KeyMap,)g(the)g(new)h(v)-5 b(alue)26 b(will)g(replace)f(the)i
-(old)f(v)-5 b(alue.)340 3327 y Fh(\017)45 b Fi(If)36
-b(the)g(stored)e(v)-5 b(alue)35 b(is)g(an)g(AST)h(Ob)5
-b(ject)35 b(p)r(oin)n(ter,)i(the)e(Ob)5 b(ject's)35 b(reference)g(coun)
-n(t)g(is)g(incremen)n(ted)427 3427 y(b)n(y)28 b(this)h(call.)39
-b(An)n(y)29 b(subsequen)n(t)f(c)n(hanges)f(made)h(to)g(the)h(Ob)5
-b(ject)29 b(using)f(the)g(returned)g(p)r(oin)n(ter)h(will)f(b)r(e)427
-3526 y(re\015ected)h(in)h(an)n(y)e(an)n(y)h(other)g(activ)n(e)f(p)r
-(oin)n(ters)h(for)g(the)h(Ob)5 b(ject,)29 b(including)h(an)n(y)e
-(obtained)h(later)g(using)427 3626 y(astMapget0A.)f(The)i(reference)e
-(coun)n(t)h(for)f(the)i(Ob)5 b(ject)29 b(will)g(b)r(e)h(decremen)n(ted)
-f(when)g(the)g(KeyMap)g(is)427 3725 y(destro)n(y)n(ed,)d(or)h(the)h(en)
-n(try)f(is)g(remo)n(v)n(ed)g(or)f(o)n(v)n(er-written)g(with)i(a)f
-(di\013eren)n(t)h(p)r(oin)n(ter.)-2 3874 y Fd(Data)33
-b(T)m(yp)s(e)g(Co)s(des)n(:)227 4020 y Fi(T)-7 b(o)18
-b(select)h(the)f(appropriate)f(function,)k(y)n(ou)c(should)h(replace)g
-Fk(<)p Fi(X)p Fk(>)g Fi(in)g(the)h(generic)e(function)i(name)g
-(astMapPut0)p Fk(<)p Fi(X)p Fk(>)227 4119 y Fi(with)35
-b(a)f(1-c)n(haracter)e(data)h(t)n(yp)r(e)i(co)r(de,)h(so)e(as)f(to)i
-(matc)n(h)f(the)h(data)e(t)n(yp)r(e)i Fk(<)p Fi(X)p Fk(>)p
-Fi(t)n(yp)r(e)f(of)g(the)h(data)f(y)n(ou)g(are)227 4219
-y(pro)r(cessing,)26 b(as)h(follo)n(ws:)340 4342 y Fh(\017)45
-b Fi(D:)28 b(double)340 4461 y Fh(\017)45 b Fi(F:)28
-b(\015oat)340 4580 y Fh(\017)45 b Fi(I:)28 b(in)n(t)340
-4699 y Fh(\017)45 b Fi(C:)28 b Ft(")p Fi(const)p Ft(")e
-Fi(p)r(oin)n(ter)i(to)f(n)n(ull)h(terminated)f(c)n(haracter)f(string)
-340 4818 y Fh(\017)45 b Fi(A:)28 b(P)n(oin)n(ter)e(to)i(AstOb)5
-b(ject)340 4937 y Fh(\017)45 b Fi(P:)28 b(Generic)f Ft(")p
-Fi(v)n(oid)f Fh(\003)p Ft(")h Fi(p)r(oin)n(ter)340 5056
-y Fh(\017)45 b Fi(S:)28 b(short)f(in)n(t)340 5176 y Fh(\017)45
+5677 y(ma)n(y)h(b)r(e)h(supplied,)g(in)g(whic)n(h)g(case)e(no)i(commen)
+n(t)f(is)h(stored.)p eop end
+%%Page: 281 291
+TeXDict begin 281 290 bop 3643 52 a FF(281)0 351 y Fd(Notes:)340
+626 y Fh(\017)45 b Fi(If)27 b(the)f(supplied)h(k)n(ey)e(is)h(already)f
+(in)h(use)g(in)h(the)f(KeyMap,)g(the)g(new)h(v)-5 b(alue)26
+b(will)g(replace)f(the)i(old)f(v)-5 b(alue.)340 751 y
+Fh(\017)45 b Fi(If)36 b(the)g(stored)e(v)-5 b(alue)35
+b(is)g(an)g(AST)h(Ob)5 b(ject)35 b(p)r(oin)n(ter,)i(the)e(Ob)5
+b(ject's)35 b(reference)g(coun)n(t)g(is)g(incremen)n(ted)427
+850 y(b)n(y)28 b(this)h(call.)39 b(An)n(y)29 b(subsequen)n(t)f(c)n
+(hanges)f(made)h(to)g(the)h(Ob)5 b(ject)29 b(using)f(the)g(returned)g
+(p)r(oin)n(ter)h(will)f(b)r(e)427 950 y(re\015ected)h(in)h(an)n(y)e(an)
+n(y)h(other)g(activ)n(e)f(p)r(oin)n(ters)h(for)g(the)h(Ob)5
+b(ject,)29 b(including)h(an)n(y)e(obtained)h(later)g(using)427
+1049 y(astMapget0A.)f(The)i(reference)e(coun)n(t)h(for)f(the)i(Ob)5
+b(ject)29 b(will)g(b)r(e)h(decremen)n(ted)f(when)g(the)g(KeyMap)g(is)
+427 1149 y(destro)n(y)n(ed,)d(or)h(the)h(en)n(try)f(is)g(remo)n(v)n(ed)
+g(or)f(o)n(v)n(er-written)g(with)i(a)f(di\013eren)n(t)h(p)r(oin)n(ter.)
+-2 1303 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s(des)n(:)227
+1449 y Fi(T)-7 b(o)18 b(select)h(the)f(appropriate)f(function,)k(y)n
+(ou)c(should)h(replace)g Fk(<)p Fi(X)p Fk(>)g Fi(in)g(the)h(generic)e
+(function)i(name)g(astMapPut0)p Fk(<)p Fi(X)p Fk(>)227
+1549 y Fi(with)35 b(a)f(1-c)n(haracter)e(data)h(t)n(yp)r(e)i(co)r(de,)h
+(so)e(as)f(to)i(matc)n(h)f(the)h(data)e(t)n(yp)r(e)i
+Fk(<)p Fi(X)p Fk(>)p Fi(t)n(yp)r(e)f(of)g(the)h(data)f(y)n(ou)g(are)227
+1648 y(pro)r(cessing,)26 b(as)h(follo)n(ws:)340 1777
+y Fh(\017)45 b Fi(D:)28 b(double)340 1902 y Fh(\017)45
+b Fi(F:)28 b(\015oat)340 2026 y Fh(\017)45 b Fi(I:)28
+b(in)n(t)340 2151 y Fh(\017)45 b Fi(C:)28 b Ft(")p Fi(const)p
+Ft(")e Fi(p)r(oin)n(ter)i(to)f(n)n(ull)h(terminated)f(c)n(haracter)f
+(string)340 2276 y Fh(\017)45 b Fi(A:)28 b(P)n(oin)n(ter)e(to)i(AstOb)5
+b(ject)340 2401 y Fh(\017)45 b Fi(P:)28 b(Generic)f Ft(")p
+Fi(v)n(oid)f Fh(\003)p Ft(")h Fi(p)r(oin)n(ter)340 2526
+y Fh(\017)45 b Fi(S:)28 b(short)f(in)n(t)340 2651 y Fh(\017)45
b Fi(B:)28 b(unsigned)f(b)n(yte)h(\(i.e.)37 b(unsigned)27
-b(c)n(har\))227 5324 y(F)-7 b(or)24 b(example,)h(astMapPut0D)f(w)n
+b(c)n(har\))227 2805 y(F)-7 b(or)24 b(example,)h(astMapPut0D)f(w)n
(ould)g(b)r(e)g(used)h(to)f(store)g(a)g Ft(")p Fi(double)p
Ft(")f Fi(v)-5 b(alue,)25 b(while)g(astMapPut0I)e(w)n(ould)h(b)r(e)227
-5423 y(used)k(to)f(store)g(an)g Ft(")p Fi(in)n(t)p Ft(")p
-Fi(,)g(etc.)227 5541 y(Note)i(that)h(KeyMaps)e(con)n(taining)g(generic)
+2904 y(used)k(to)f(store)g(an)g Ft(")p Fi(in)n(t)p Ft(")p
+Fi(,)g(etc.)227 3025 y(Note)i(that)h(KeyMaps)e(con)n(taining)g(generic)
g Ft(")p Fi(v)n(oid)g Fh(\003)p Ft(")g Fi(p)r(oin)n(ters)h(cannot)g(b)r
-(e)g(written)g(out)h(using)e(astSho)n(w)g(or)227 5641
+(e)g(written)g(out)h(using)e(astSho)n(w)g(or)227 3124
y(astW)-7 b(rite.)37 b(An)28 b(error)e(will)h(b)r(e)h(rep)r(orted)f(if)
-h(this)g(is)g(attempted.)p eop end
-%%Page: 281 291
-TeXDict begin 281 290 bop 3643 52 a FF(281)p 0 351 3780
-12 v 0 482 a Fz(astMapPut1)p Fc(<)p Fz(X)p Fc(>)1285
-483 y Fe(Add)39 b(a)f(v)m(ector)g(v)-7 b(alue)38 b(to)g(a)1672
-583 y(KeyMap)2771 482 y Fz(astMapPut1)p Fc(<)p Fz(X)p
-Fc(>)0 771 y Fd(Description:)44 b Fi(This)23 b(is)g(a)g(set)f(of)h
-(functions)h(for)e(adding)g(v)n(ector)g(v)-5 b(alues)22
-b(to)h(a)g(KeyMap.)34 b(Y)-7 b(ou)23 b(should)g(use)g(a)f(function)227
-870 y(whic)n(h)j(matc)n(hes)g(the)h(data)f(t)n(yp)r(e)g(of)g(the)h
-(data)f(y)n(ou)f(wish)h(to)h(add)f(to)g(the)h(KeyMap)e(b)n(y)h
-(replacing)f Fk(<)p Fi(X)p Fk(>)h Fi(in)g(the)227 970
-y(generic)30 b(function)h(name)g(astMapPut1)p Fk(<)p
-Fi(X)p Fk(>)e Fi(b)n(y)h(an)h(appropriate)e(1-c)n(haracter)f(t)n(yp)r
-(e)j(co)r(de)f(\(see)h(the)g Ft(")p Fi(Data)227 1069
-y(T)n(yp)r(e)d(Co)r(des)p Ft(")f Fi(section)g(b)r(elo)n(w)g(for)g(the)h
-(co)r(de)f(appropriate)f(to)i(eac)n(h)f(supp)r(orted)g(data)g(t)n(yp)r
-(e\).)0 1218 y Fd(Synopsis:)121 b Ft(void)42 b(astMapPut1)p
-Fk(<)p Ft(X)p Fk(>)p Ft(\()c(AstKeyMap)h Fh(\003)p Ft(this,)i(const)h
-(char)g Fh(\003)p Ft(key,)f(int)i(size,)e(const)h Fk(<)p
-Ft(X)p Fk(>)p Ft(type)227 1318 y(value[],)f(const)g(char)h
-Fh(\003)p Ft(comment)e(\);)0 1467 y Fd(P)m(arameters:)259
-1603 y(this)427 1703 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap)e(in)i
+h(this)g(is)g(attempted.)p 0 3308 3780 12 v 0 3438 a
+Fz(astMapPut1)p Fc(<)p Fz(X)p Fc(>)1285 3439 y Fe(Add)39
+b(a)f(v)m(ector)g(v)-7 b(alue)38 b(to)g(a)1672 3539 y(KeyMap)2771
+3438 y Fz(astMapPut1)p Fc(<)p Fz(X)p Fc(>)0 3712 y Fd(Description:)44
+b Fi(This)23 b(is)g(a)g(set)f(of)h(functions)h(for)e(adding)g(v)n
+(ector)g(v)-5 b(alues)22 b(to)h(a)g(KeyMap.)34 b(Y)-7
+b(ou)23 b(should)g(use)g(a)f(function)227 3811 y(whic)n(h)j(matc)n(hes)
+g(the)h(data)f(t)n(yp)r(e)g(of)g(the)h(data)f(y)n(ou)f(wish)h(to)h(add)
+f(to)g(the)h(KeyMap)e(b)n(y)h(replacing)f Fk(<)p Fi(X)p
+Fk(>)h Fi(in)g(the)227 3911 y(generic)30 b(function)h(name)g
+(astMapPut1)p Fk(<)p Fi(X)p Fk(>)e Fi(b)n(y)h(an)h(appropriate)e(1-c)n
+(haracter)f(t)n(yp)r(e)j(co)r(de)f(\(see)h(the)g Ft(")p
+Fi(Data)227 4011 y(T)n(yp)r(e)d(Co)r(des)p Ft(")f Fi(section)g(b)r(elo)
+n(w)g(for)g(the)h(co)r(de)f(appropriate)f(to)i(eac)n(h)f(supp)r(orted)g
+(data)g(t)n(yp)r(e\).)0 4152 y Fd(Synopsis:)121 b Ft(void)42
+b(astMapPut1)p Fk(<)p Ft(X)p Fk(>)p Ft(\()c(AstKeyMap)h
+Fh(\003)p Ft(this,)i(const)h(char)g Fh(\003)p Ft(key,)f(int)i(size,)e
+(const)h Fk(<)p Ft(X)p Fk(>)p Ft(type)227 4252 y(value[],)f(const)g
+(char)h Fh(\003)p Ft(comment)e(\);)0 4393 y Fd(P)m(arameters:)259
+4521 y(this)427 4621 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap)e(in)i
(whic)n(h)g(to)f(store)g(the)h(supplied)g(v)-5 b(alues.)259
-1835 y Fd(k)m(ey)427 1935 y Fi(A)24 b(c)n(haracter)c(string)j(to)g(b)r
+4746 y Fd(k)m(ey)427 4846 y Fi(A)24 b(c)n(haracter)c(string)j(to)g(b)r
(e)g(stored)f(with)h(the)h(v)-5 b(alues,)23 b(whic)n(h)g(can)g(later)f
(b)r(e)h(used)g(to)g(iden)n(tify)h(the)f(v)-5 b(alues.)427
-2034 y(T)e(railing)28 b(spaces)h(are)f(ignored.)40 b(The)29
+4945 y(T)e(railing)28 b(spaces)h(are)f(ignored.)40 b(The)29
b(supplied)h(string)e(is)h(con)n(v)n(erted)f(to)h(upp)r(er)g(case)g(b)r
-(efore)g(use)g(if)g(the)427 2134 y(KeyCase)d(attribute)i(is)g(curren)n
-(tly)e(set)i(to)f(zero.)259 2266 y Fd(size)427 2366 y
+(efore)g(use)g(if)g(the)427 5045 y(KeyCase)d(attribute)i(is)g(curren)n
+(tly)e(set)i(to)f(zero.)259 5170 y Fd(size)427 5269 y
Fi(The)h(n)n(um)n(b)r(er)f(of)h(elemen)n(ts)f(in)h(the)g(supplied)g
-(arra)n(y)d(of)j(v)-5 b(alues.)259 2499 y Fd(v)g(alue)427
-2598 y Fi(The)31 b(arra)n(y)c(of)k(v)-5 b(alues)29 b(to)h(b)r(e)h
+(arra)n(y)d(of)j(v)-5 b(alues.)259 5394 y Fd(v)g(alue)427
+5494 y Fi(The)31 b(arra)n(y)c(of)k(v)-5 b(alues)29 b(to)h(b)r(e)h
(stored.)44 b(The)30 b(data)g(t)n(yp)r(e)g(of)g(this)h(v)-5
b(alue)30 b(should)g(matc)n(h)g(the)g(1-c)n(haracter)427
-2698 y(t)n(yp)r(e)i(co)r(de)g(app)r(ended)f(to)h(the)g(function)g(name)
+5593 y(t)n(yp)r(e)i(co)r(de)g(app)r(ended)f(to)h(the)g(function)g(name)
g(\(e.g.)48 b(if)32 b(y)n(ou)f(are)g(using)g(astMapPut1A,)g(the)h(t)n
-(yp)r(e)g(of)427 2797 y(this)c(v)-5 b(alue)28 b(should)f(b)r(e)h
+(yp)r(e)g(of)427 5693 y(this)c(v)-5 b(alue)28 b(should)f(b)r(e)h
Ft(")p Fi(arra)n(y)d(of)i(p)r(oin)n(ters)g(to)h(AstOb)5
-b(ject)p Ft(")p Fi(\).)259 2930 y Fd(commen)m(t)427 3029
-y Fi(A)24 b(p)r(oin)n(ter)g(to)f(a)g(n)n(ull-terminated)h(commen)n(t)f
-(string)g(to)h(b)r(e)g(stored)f(with)h(the)g(v)-5 b(alues.)35
-b(A)24 b(NULL)g(p)r(oin)n(ter)427 3129 y(ma)n(y)j(b)r(e)h(supplied,)g
-(in)g(whic)n(h)g(case)e(no)i(commen)n(t)f(is)h(stored.)0
-3291 y Fd(Notes:)340 3573 y Fh(\017)45 b Fi(If)23 b(the)g(supplied)g(k)
-n(ey)f(is)g(already)f(in)i(use)f(in)h(the)g(KeyMap,)f(the)h(new)g(v)-5
+b(ject)p Ft(")p Fi(\).)p eop end
+%%Page: 282 292
+TeXDict begin 282 291 bop 0 52 a FF(282)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(commen)m(t)427
+451 y Fi(A)24 b(p)r(oin)n(ter)g(to)f(a)g(n)n(ull-terminated)h(commen)n
+(t)f(string)g(to)h(b)r(e)g(stored)f(with)h(the)g(v)-5
+b(alues.)35 b(A)24 b(NULL)g(p)r(oin)n(ter)427 551 y(ma)n(y)j(b)r(e)h
+(supplied,)g(in)g(whic)n(h)g(case)e(no)i(commen)n(t)f(is)h(stored.)0
+721 y Fd(Notes:)340 1011 y Fh(\017)45 b Fi(If)23 b(the)g(supplied)g(k)n
+(ey)f(is)g(already)f(in)i(use)f(in)h(the)g(KeyMap,)f(the)h(new)g(v)-5
b(alues)22 b(will)g(replace)g(the)h(old)f(v)-5 b(alues.)-2
-3734 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s(des)n(:)227 3880
+1181 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s(des)n(:)227 1328
y Fi(T)-7 b(o)18 b(select)h(the)f(appropriate)f(function,)k(y)n(ou)c
(should)h(replace)g Fk(<)p Fi(X)p Fk(>)g Fi(in)g(the)h(generic)e
(function)i(name)g(astMapPut1)p Fk(<)p Fi(X)p Fk(>)227
-3980 y Fi(with)35 b(a)f(1-c)n(haracter)e(data)h(t)n(yp)r(e)i(co)r(de,)h
+1427 y Fi(with)35 b(a)f(1-c)n(haracter)e(data)h(t)n(yp)r(e)i(co)r(de,)h
(so)e(as)f(to)i(matc)n(h)f(the)h(data)e(t)n(yp)r(e)i
Fk(<)p Fi(X)p Fk(>)p Fi(t)n(yp)r(e)f(of)g(the)h(data)f(y)n(ou)g(are)227
-4079 y(pro)r(cessing,)26 b(as)h(follo)n(ws:)340 4215
-y Fh(\017)45 b Fi(D:)28 b(double)340 4348 y Fh(\017)45
-b Fi(F:)28 b(\015oat)340 4480 y Fh(\017)45 b Fi(I:)28
-b(in)n(t)340 4613 y Fh(\017)45 b Fi(C:)28 b Ft(")p Fi(const)p
+1527 y(pro)r(cessing,)26 b(as)h(follo)n(ws:)340 1671
+y Fh(\017)45 b Fi(D:)28 b(double)340 1808 y Fh(\017)45
+b Fi(F:)28 b(\015oat)340 1945 y Fh(\017)45 b Fi(I:)28
+b(in)n(t)340 2082 y Fh(\017)45 b Fi(C:)28 b Ft(")p Fi(const)p
Ft(")e Fi(p)r(oin)n(ter)i(to)f(n)n(ull)h(terminated)f(c)n(haracter)f
-(string)340 4745 y Fh(\017)45 b Fi(A:)28 b(P)n(oin)n(ter)e(to)i(AstOb)5
-b(ject)340 4878 y Fh(\017)45 b Fi(P:)28 b(Generic)f Ft(")p
-Fi(v)n(oid)f Fh(\003)p Ft(")h Fi(p)r(oin)n(ter)340 5010
-y Fh(\017)45 b Fi(S:)28 b(short)f(in)n(t)340 5142 y Fh(\017)45
+(string)340 2219 y Fh(\017)45 b Fi(A:)28 b(P)n(oin)n(ter)e(to)i(AstOb)5
+b(ject)340 2356 y Fh(\017)45 b Fi(P:)28 b(Generic)f Ft(")p
+Fi(v)n(oid)f Fh(\003)p Ft(")h Fi(p)r(oin)n(ter)340 2493
+y Fh(\017)45 b Fi(S:)28 b(short)f(in)n(t)340 2630 y Fh(\017)45
b Fi(B:)28 b(Unsigned)f(b)n(yte)h(\(i.e.)37 b(c)n(har\))227
-5304 y(F)-7 b(or)27 b(example,)g(astMapPut1D)f(w)n(ould)h(b)r(e)g(used)
+2800 y(F)-7 b(or)27 b(example,)g(astMapPut1D)f(w)n(ould)h(b)r(e)g(used)
g(to)g(store)f Ft(")p Fi(double)p Ft(")g Fi(v)-5 b(alues,)27
-b(while)h(astMapPut1I)e(w)n(ould)g(b)r(e)227 5404 y(used)i(to)f(store)g
-Ft(")p Fi(in)n(t)p Ft(")p Fi(,)g(etc.)227 5528 y(Note)i(that)h(KeyMaps)
+b(while)h(astMapPut1I)e(w)n(ould)g(b)r(e)227 2900 y(used)i(to)f(store)g
+Ft(")p Fi(in)n(t)p Ft(")p Fi(,)g(etc.)227 3028 y(Note)i(that)h(KeyMaps)
e(con)n(taining)g(generic)g Ft(")p Fi(v)n(oid)g Fh(\003)p
Ft(")g Fi(p)r(oin)n(ters)h(cannot)g(b)r(e)g(written)g(out)h(using)e
-(astSho)n(w)g(or)227 5627 y(astW)-7 b(rite.)37 b(An)28
+(astSho)n(w)g(or)227 3128 y(astW)-7 b(rite.)37 b(An)28
b(error)e(will)h(b)r(e)h(rep)r(orted)f(if)h(this)g(is)g(attempted.)p
-eop end
-%%Page: 282 292
-TeXDict begin 282 291 bop 0 52 a FF(282)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 483 a Fz(astMapPutElem)p Fc(<)p Fz(X)p Fc(>)156 b Fe(Put)38
-b(a)g(v)-7 b(alue)39 b(in)m(to)e(an)1402 583 y(elemen)m(t)g(of)i(a)f(v)
-m(ector)1404 682 y(v)-7 b(alue)38 b(in)h(a)f(KeyMap)2539
-483 y Fz(astMapPutElem)p Fc(<)p Fz(X)p Fc(>)0 874 y Fd(Description:)44
-b Fi(This)36 b(is)f(a)f(set)i(of)f(functions)g(for)g(storing)f(a)h(v)-5
+0 3335 3780 12 v 0 3467 a Fz(astMapPutElem)p Fc(<)p Fz(X)p
+Fc(>)156 b Fe(Put)38 b(a)g(v)-7 b(alue)39 b(in)m(to)e(an)1402
+3567 y(elemen)m(t)g(of)i(a)f(v)m(ector)1404 3666 y(v)-7
+b(alue)38 b(in)h(a)f(KeyMap)2539 3467 y Fz(astMapPutElem)p
+Fc(<)p Fz(X)p Fc(>)0 3863 y Fd(Description:)44 b Fi(This)36
+b(is)f(a)f(set)i(of)f(functions)g(for)g(storing)f(a)h(v)-5
b(alue)35 b(in)h(a)e(single)h(elemen)n(t)g(of)h(a)e(v)n(ector)g(v)-5
-b(alue)36 b(in)f(a)227 974 y(KeyMap.)41 b(Y)-7 b(ou)30
+b(alue)36 b(in)f(a)227 3963 y(KeyMap.)41 b(Y)-7 b(ou)30
b(should)f(replace)f Fk(<)p Fi(X)p Fk(>)g Fi(in)i(the)g(generic)e
(function)i(name)f(astMapPutElem)p Fk(<)p Fi(X)p Fk(>)e
-Fi(b)n(y)i(an)g(ap-)227 1073 y(propriate)21 b(1-c)n(haracter)e(t)n(yp)r
+Fi(b)n(y)i(an)g(ap-)227 4063 y(propriate)21 b(1-c)n(haracter)e(t)n(yp)r
(e)k(co)r(de)e(\(see)i(the)f Ft(")p Fi(Data)g(T)n(yp)r(e)g(Co)r(des)p
Ft(")f Fi(section)h(b)r(elo)n(w)f(for)h(the)g(co)r(de)g(appropriate)227
-1173 y(to)34 b(eac)n(h)e(supp)r(orted)h(data)g(t)n(yp)r(e\).)55
+4162 y(to)34 b(eac)n(h)e(supp)r(orted)h(data)g(t)n(yp)r(e\).)55
b(The)33 b(supplied)h(v)-5 b(alue)33 b(is)g(con)n(v)n(erted)f(from)h
-(the)h(data)f(t)n(yp)r(e)g(indicated)h(b)n(y)227 1273
+(the)h(data)f(t)n(yp)r(e)g(indicated)h(b)n(y)227 4262
y Fk(<)p Fi(X)p Fk(>)d Fi(to)g(the)g(data)g(t)n(yp)r(e)g(of)g(the)h
(KeyMap)e(en)n(try)h(b)r(efore)f(b)r(eing)i(stored)e(\(an)h(error)e(is)
-i(rep)r(orted)f(if)i(it)g(is)f(not)227 1372 y(p)r(ossible)d(to)f(con)n
+i(rep)r(orted)f(if)i(it)g(is)f(not)227 4361 y(p)r(ossible)d(to)f(con)n
(v)n(ert)f(the)i(v)-5 b(alue)28 b(to)f(the)h(required)f(data)g(t)n(yp)r
-(e\).)0 1525 y Fd(Synopsis:)121 b Ft(void)42 b(astMapPutElem)p
+(e\).)0 4519 y Fd(Synopsis:)121 b Ft(void)42 b(astMapPutElem)p
Fk(<)p Ft(X)p Fk(>)o Ft(\()37 b(AstKeyMap)j Fh(\003)p
Ft(this,)h(const)h(char)g Fh(\003)p Ft(key,)f(int)h(elem,)g
-Fk(<)p Ft(X)p Fk(>)p Ft(type)227 1625 y Fh(\003)p Ft(value)f(\))0
-1777 y Fd(P)m(arameters:)259 1917 y(this)427 2016 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(KeyMap.)259 2151 y Fd(k)m(ey)427 2251 y
+Fk(<)p Ft(X)p Fk(>)p Ft(type)227 4619 y Fh(\003)p Ft(value)f(\))0
+4776 y Fd(P)m(arameters:)259 4921 y(this)427 5021 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(KeyMap.)259 5158 y Fd(k)m(ey)427 5257 y
Fi(The)j(c)n(haracter)d(string)h(iden)n(tifying)i(the)f(v)-5
b(alue)30 b(to)g(b)r(e)h(retriev)n(ed.)43 b(T)-7 b(railing)30
-b(spaces)f(are)g(ignored.)44 b(The)427 2350 y(supplied)26
+b(spaces)f(are)g(ignored.)44 b(The)427 5357 y(supplied)26
b(string)f(is)g(con)n(v)n(erted)f(to)h(upp)r(er)g(case)g(b)r(efore)g
(use)g(if)h(the)g(KeyCase)e(attribute)h(is)g(curren)n(tly)g(set)427
-2450 y(to)j(zero.)259 2584 y Fd(elem)427 2684 y Fi(The)g(index)g(of)f
+5456 y(to)j(zero.)259 5593 y Fd(elem)427 5693 y Fi(The)g(index)g(of)f
(the)h(v)n(ector)e(elemen)n(t)i(to)g(mo)r(dify)-7 b(,)28
-b(starting)f(at)g(zero.)259 2818 y Fd(v)-5 b(alue)427
-2918 y Fi(The)28 b(v)-5 b(alue)27 b(to)h(store.)0 3083
-y Fd(Class)j(Applicabilit)m(y:)259 3223 y(KeyMap)427
-3322 y Fi(If)22 b(the)g Ft(")p Fi(elem)p Ft(")e Fi(index)h(is)g
-(outside)h(the)f(range)f(of)h(the)h(v)n(ector,)f(the)h(length)f(of)g
-(the)h(v)n(ector)e(will)h(b)r(e)h(increased)427 3422
-y(b)n(y)35 b(one)g(elemen)n(t)h(and)f(the)h(supplied)g(v)-5
-b(alue)35 b(will)h(b)r(e)f(stored)g(at)g(the)h(end)g(of)f(the)h(v)n
-(ector)e(in)i(the)g(new)427 3521 y(elemen)n(t.)259 3656
-y Fd(T)-8 b(able)427 3756 y Fi(If)21 b(the)g Ft(")p Fi(elem)p
-Ft(")f Fi(index)g(is)g(outside)h(the)f(range)f(of)i(the)g(v)n(ector,)f
-(an)g(error)f(will)h(b)r(e)h(rep)r(orted.)34 b(The)20
-b(n)n(um)n(b)r(er)h(of)427 3855 y(elemen)n(ts)e(in)f(eac)n(h)g(cell)g
-(of)h(a)f(column)g(is)h(sp)r(eci\014ed)f(when)h(the)g(column)f(is)h
-(created)e(using)i(astAddColumn.)0 4020 y Fd(Notes:)340
-4306 y Fh(\017)45 b Fi(If)28 b(the)g(en)n(try)f(originally)f(holds)h(a)
-h(scalar)e(v)-5 b(alue,)27 b(it)h(will)g(b)r(e)g(treated)f(lik)n(e)g(a)
-h(v)n(ector)e(en)n(try)h(of)g(length)h(1.)340 4440 y
-Fh(\017)45 b Fi(If)30 b(the)f(sp)r(eci\014ed)g(k)n(ey)f(cannot)h(b)r(e)
-g(found)g(in)h(the)f(giv)n(en)f(KeyMap,)g(or)g(is)h(found)g(but)h(has)e
-(an)h(unde\014ned)427 4540 y(v)-5 b(alue,)34 b(a)e(new)g(v)n(ector)f
-(en)n(try)h(with)g(the)h(giv)n(en)f(name,)h(and)f(data)g(t)n(yp)r(e)g
+b(starting)f(at)g(zero.)p eop end
+%%Page: 283 293
+TeXDict begin 283 292 bop 3643 52 a FF(283)259 351 y
+Fd(v)-5 b(alue)427 451 y Fi(The)28 b(v)-5 b(alue)27 b(to)h(store.)0
+610 y Fd(Class)j(Applicabilit)m(y:)259 743 y(KeyMap)427
+843 y Fi(If)22 b(the)g Ft(")p Fi(elem)p Ft(")e Fi(index)h(is)g(outside)
+h(the)f(range)f(of)h(the)h(v)n(ector,)f(the)h(length)f(of)g(the)h(v)n
+(ector)e(will)h(b)r(e)h(increased)427 943 y(b)n(y)35
+b(one)g(elemen)n(t)h(and)f(the)h(supplied)g(v)-5 b(alue)35
+b(will)h(b)r(e)f(stored)g(at)g(the)h(end)g(of)f(the)h(v)n(ector)e(in)i
+(the)g(new)427 1042 y(elemen)n(t.)259 1172 y Fd(T)-8
+b(able)427 1272 y Fi(If)21 b(the)g Ft(")p Fi(elem)p Ft(")f
+Fi(index)g(is)g(outside)h(the)f(range)f(of)i(the)g(v)n(ector,)f(an)g
+(error)f(will)h(b)r(e)h(rep)r(orted.)34 b(The)20 b(n)n(um)n(b)r(er)h
+(of)427 1372 y(elemen)n(ts)e(in)f(eac)n(h)g(cell)g(of)h(a)f(column)g
+(is)h(sp)r(eci\014ed)f(when)h(the)g(column)f(is)h(created)e(using)i
+(astAddColumn.)0 1531 y Fd(Notes:)340 1810 y Fh(\017)45
+b Fi(If)28 b(the)g(en)n(try)f(originally)f(holds)h(a)h(scalar)e(v)-5
+b(alue,)27 b(it)h(will)g(b)r(e)g(treated)f(lik)n(e)g(a)h(v)n(ector)e
+(en)n(try)h(of)g(length)h(1.)340 1940 y Fh(\017)45 b
+Fi(If)30 b(the)f(sp)r(eci\014ed)g(k)n(ey)f(cannot)h(b)r(e)g(found)g(in)
+h(the)f(giv)n(en)f(KeyMap,)g(or)g(is)h(found)g(but)h(has)e(an)h
+(unde\014ned)427 2040 y(v)-5 b(alue,)34 b(a)e(new)g(v)n(ector)f(en)n
+(try)h(with)g(the)h(giv)n(en)f(name,)h(and)f(data)g(t)n(yp)r(e)g
(implied)h(b)n(y)f Fk(<)p Fi(X)p Fk(>)p Fi(,)h(is)f(created)427
-4640 y(and)c(the)g(supplied)g(v)-5 b(alue)27 b(is)h(stored)e(in)i(its)g
-(\014rst)f(en)n(try)-7 b(.)-2 4805 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s
-(des)n(:)227 4951 y Fi(T)-7 b(o)18 b(select)h(the)f(appropriate)f
+2139 y(and)c(the)g(supplied)g(v)-5 b(alue)27 b(is)h(stored)e(in)i(its)g
+(\014rst)f(en)n(try)-7 b(.)-2 2298 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s
+(des)n(:)227 2445 y Fi(T)-7 b(o)18 b(select)h(the)f(appropriate)f
(function,)k(y)n(ou)c(should)h(replace)g Fk(<)p Fi(X)p
Fk(>)g Fi(in)g(the)h(generic)e(function)i(name)g(astMapPutElem)p
-Fk(<)p Fi(X)p Fk(>)227 5050 y Fi(with)35 b(a)f(1-c)n(haracter)e(data)h
+Fk(<)p Fi(X)p Fk(>)227 2544 y Fi(with)35 b(a)f(1-c)n(haracter)e(data)h
(t)n(yp)r(e)i(co)r(de,)h(so)e(as)f(to)i(matc)n(h)f(the)h(data)e(t)n(yp)
r(e)i Fk(<)p Fi(X)p Fk(>)p Fi(t)n(yp)r(e)f(of)g(the)h(data)f(y)n(ou)g
-(are)227 5150 y(pro)r(cessing,)26 b(as)h(follo)n(ws:)340
-5290 y Fh(\017)45 b Fi(D:)28 b(double)340 5424 y Fh(\017)45
-b Fi(F:)28 b(\015oat)340 5559 y Fh(\017)45 b Fi(I:)28
-b(in)n(t)340 5693 y Fh(\017)45 b Fi(C:)28 b Ft(")p Fi(const)p
+(are)227 2644 y(pro)r(cessing,)26 b(as)h(follo)n(ws:)340
+2777 y Fh(\017)45 b Fi(D:)28 b(double)340 2907 y Fh(\017)45
+b Fi(F:)28 b(\015oat)340 3037 y Fh(\017)45 b Fi(I:)28
+b(in)n(t)340 3167 y Fh(\017)45 b Fi(C:)28 b Ft(")p Fi(const)p
Ft(")e Fi(p)r(oin)n(ter)i(to)f(n)n(ull)h(terminated)f(c)n(haracter)f
-(string)p eop end
-%%Page: 283 293
-TeXDict begin 283 292 bop 3643 52 a FF(283)340 351 y
-Fh(\017)45 b Fi(A:)28 b(P)n(oin)n(ter)e(to)i(AstOb)5
-b(ject)340 488 y Fh(\017)45 b Fi(P:)28 b(Generic)f Ft(")p
-Fi(v)n(oid)f Fh(\003)p Ft(")h Fi(p)r(oin)n(ter)340 626
-y Fh(\017)45 b Fi(S:)28 b(short)f(in)n(t)340 763 y Fh(\017)45
+(string)340 3297 y Fh(\017)45 b Fi(A:)28 b(P)n(oin)n(ter)e(to)i(AstOb)5
+b(ject)340 3427 y Fh(\017)45 b Fi(P:)28 b(Generic)f Ft(")p
+Fi(v)n(oid)f Fh(\003)p Ft(")h Fi(p)r(oin)n(ter)340 3557
+y Fh(\017)45 b Fi(S:)28 b(short)f(in)n(t)340 3687 y Fh(\017)45
b Fi(B:)28 b(Unsigned)f(b)n(yte)h(\(i.e.)37 b(c)n(har\))227
-933 y(F)-7 b(or)33 b(example,)i(astMapPutElemD)e(w)n(ould)g(b)r(e)h
+3846 y(F)-7 b(or)33 b(example,)i(astMapPutElemD)e(w)n(ould)g(b)r(e)h
(used)g(to)g(put)g(a)f Ft(")p Fi(double)p Ft(")g Fi(v)-5
-b(alue,)35 b(while)f(astMapPutElemI)227 1033 y(w)n(ould)d(b)r(e)h(used)
+b(alue,)35 b(while)f(astMapPutElemI)227 3946 y(w)n(ould)d(b)r(e)h(used)
g(to)f(put)h(an)g Ft(")p Fi(in)n(t)p Ft(")f Fi(v)-5 b(alue,)32
b(etc.)49 b(F)-7 b(or)31 b(D)h(or)f(I,)g(the)h(supplied)g
Ft(")p Fi(v)-5 b(alue)p Ft(")31 b Fi(parameter)f(should)h(b)r(e)227
-1133 y(a)e(double)g(or)f(in)n(t.)42 b(F)-7 b(or)29 b(C,)g(the)g
+4045 y(a)e(double)g(or)f(in)n(t.)42 b(F)-7 b(or)29 b(C,)g(the)g
(supplied)h Ft(")p Fi(v)-5 b(alue)p Ft(")28 b Fi(parameter)g(should)g
(b)r(e)i(a)f(p)r(oin)n(ter)f(to)h(a)g(c)n(haracter)e(string.)227
-1232 y(F)-7 b(or)27 b(A,)h(the)g(supplied)g Ft(")p Fi(v)-5
+4145 y(F)-7 b(or)27 b(A,)h(the)g(supplied)g Ft(")p Fi(v)-5
b(alue)p Ft(")27 b Fi(parameter)f(should)h(b)r(e)h(an)g(AstOb)5
-b(ject)27 b(p)r(oin)n(ter.)p 0 1440 3780 12 v 0 1571
-a Fz(astMapPutU)974 1572 y Fe(Add)39 b(an)g(en)m(try)f(to)g(a)g(KeyMap)
-h(with)e(an)1491 1686 y(unde\014ned)j(v)-7 b(alue)3019
-1571 y Fz(astMapPutU)0 1861 y Fd(Description:)44 b Fi(This)28
+b(ject)27 b(p)r(oin)n(ter.)p 0 4339 3780 12 v 0 4469
+a Fz(astMapPutU)974 4470 y Fe(Add)39 b(an)g(en)m(try)f(to)g(a)g(KeyMap)
+h(with)e(an)1491 4585 y(unde\014ned)j(v)-7 b(alue)3019
+4469 y Fz(astMapPutU)0 4745 y Fd(Description:)44 b Fi(This)28
b(function)g(adds)f(a)g(new)h(en)n(try)e(to)i(a)f(KeyMap,)g(but)h(no)f
(v)-5 b(alue)27 b(is)h(stored)e(with)i(the)g(en)n(try)-7
-b(.)37 b(The)227 1960 y(en)n(try)27 b(therefore)g(has)g(a)g(sp)r(ecial)
+b(.)37 b(The)227 4844 y(en)n(try)27 b(therefore)g(has)g(a)g(sp)r(ecial)
h(data)f(t)n(yp)r(e)g(represen)n(ted)g(b)n(y)g(sym)n(b)r(olic)g
-(constan)n(t)g(AST)p Ft(__)p Fi(UNDEFTYPE.)227 2089 y(An)k(example)g
+(constan)n(t)g(AST)p Ft(__)p Fi(UNDEFTYPE.)227 4967 y(An)k(example)g
(use)f(is)g(to)h(add)f(en)n(tries)g(with)h(unde\014ned)h(v)-5
b(alues)30 b(to)g(a)h(KeyMap)e(prior)h(to)g(lo)r(c)n(king)g(them)h
-(with)227 2189 y(the)26 b(MapLo)r(c)n(k)n(ed)e(attribute.)37
+(with)227 5067 y(the)26 b(MapLo)r(c)n(k)n(ed)e(attribute.)37
b(Suc)n(h)25 b(en)n(tries)g(can)h(act)f(as)g(placeholders)f(for)h(v)-5
b(alues)25 b(that)h(can)f(b)r(e)h(added)g(to)f(the)227
-2288 y(KeyMap)i(later.)0 2446 y Fd(Synopsis:)121 b Ft(void)42
+5167 y(KeyMap)i(later.)0 5313 y Fd(Synopsis:)121 b Ft(void)42
b(astMapPutU\()d(AstKeyMap)h Fh(\003)p Ft(this,)h(const)g(char)h
Fh(\003)p Ft(key,)g(const)f(char)h Fh(\003)p Ft(comment)e(\);)0
-2604 y Fd(P)m(arameters:)259 2750 y(this)427 2849 y Fi(P)n(oin)n(ter)26
+5460 y Fd(P)m(arameters:)259 5593 y(this)427 5693 y Fi(P)n(oin)n(ter)26
b(to)i(the)g(KeyMap)e(in)i(whic)n(h)g(to)f(store)g(the)h(supplied)g(v)
--5 b(alue.)259 2986 y Fd(k)m(ey)427 3086 y Fi(A)27 b(c)n(haracter)e
-(string)h(to)h(b)r(e)g(stored)f(with)i(the)f(v)-5 b(alue,)27
-b(whic)n(h)g(can)f(later)g(b)r(e)i(used)e(to)h(iden)n(tify)g(the)h(v)-5
-b(alue.)427 3186 y(T)e(railing)28 b(spaces)h(are)f(ignored.)40
-b(The)29 b(supplied)h(string)e(is)h(con)n(v)n(erted)f(to)h(upp)r(er)g
-(case)g(b)r(efore)g(use)g(if)g(the)427 3285 y(KeyCase)d(attribute)i(is)
-g(curren)n(tly)e(set)i(to)f(zero.)259 3422 y Fd(commen)m(t)427
-3522 y Fi(A)g(p)r(oin)n(ter)e(to)h(a)f(n)n(ull-terminated)h(commen)n(t)
-g(string)f(to)h(b)r(e)g(stored)f(with)i(the)f(v)-5 b(alue.)36
-b(A)27 b(NULL)f(p)r(oin)n(ter)427 3622 y(ma)n(y)h(b)r(e)h(supplied,)g
-(in)g(whic)n(h)g(case)e(no)i(commen)n(t)f(is)h(stored.)0
-3792 y Fd(Notes:)340 4083 y Fh(\017)45 b Fi(If)26 b(the)f(supplied)h(k)
-n(ey)e(is)h(already)f(in)h(use)g(in)g(the)h(KeyMap,)e(the)i(v)-5
-b(alue)25 b(asso)r(ciated)e(with)j(the)g(k)n(ey)e(will)h(b)r(e)427
-4183 y(remo)n(v)n(ed.)p 0 4391 V 0 4523 a Fz(astMapRegion)249
-b Fe(T)-10 b(ransform)36 b(a)j(Region)e(in)m(to)h(a)g(new)1129
-4636 y(F)-10 b(rame)39 b(using)f(a)h(giv)m(en)e(Mapping)2933
-4523 y Fz(astMapRegion)0 4833 y Fd(Description:)44 b
-Fi(This)34 b(function)g(returns)f(a)g(p)r(oin)n(ter)g(to)h(a)f(new)h
-(Region)f(whic)n(h)g(corresp)r(onds)f(to)h(supplied)h(Region)227
-4933 y(describ)r(ed)i(b)n(y)g(some)g(other)f(sp)r(eci\014ed)i(co)r
-(ordinate)e(system.)62 b(A)37 b(Mapping)e(is)h(supplied)h(whic)n(h)f
-(transforms)227 5033 y(p)r(ositions)30 b(b)r(et)n(w)n(een)g(the)g(old)g
-(and)g(new)g(co)r(ordinate)e(systems.)44 b(The)30 b(new)g(Region)f(ma)n
-(y)h(not)g(b)r(e)g(of)g(the)g(same)227 5132 y(class)d(as)g(the)h
-(original)e(region.)0 5290 y Fd(Synopsis:)121 b Ft(AstRegion)40
-b Fh(\003)p Ft(astMapRegion\()d(AstRegion)j Fh(\003)p
-Ft(this,)h(AstMapping)f Fh(\003)p Ft(map,)h(AstFrame)f
-Fh(\003)p Ft(frame)i(\))0 5448 y Fd(P)m(arameters:)259
-5593 y(this)427 5693 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Region.)p
-eop end
+-5 b(alue.)p eop end
%%Page: 284 294
TeXDict begin 284 293 bop 0 52 a FF(284)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(map)427
-451 y Fi(P)n(oin)n(ter)25 b(to)i(a)f(Mapping)g(whic)n(h)h(transforms)e
-(p)r(ositions)h(from)h(the)g(co)r(ordinate)e(system)h(represen)n(ted)g
-(b)n(y)427 551 y(the)32 b(supplied)g(Region)f(to)g(the)h(co)r(ordinate)
-e(system)h(sp)r(eci\014ed)h(b)n(y)f Ft(")p Fi(frame)p
-Ft(")p Fi(.)47 b(The)31 b(supplied)h(Mapping)427 650
-y(should)k(de\014ne)f(b)r(oth)h(forw)n(ard)e(and)i(in)n(v)n(erse)e
-(transformations,)h(and)h(these)f(transformations)f(should)427
-750 y(form)20 b(a)g(gen)n(uine)g(in)n(v)n(erse)f(pair.)33
-b(That)21 b(is,)g(transforming)e(a)h(p)r(osition)g(using)g(the)h(forw)n
-(ard)d(transformation)427 849 y(and)29 b(then)g(using)f(the)h(in)n(v)n
-(erse)e(transformation)g(should)h(pro)r(duce)h(the)g(original)e(input)i
-(p)r(osition.)40 b(Some)427 949 y(Mapping)31 b(classes)e(\(suc)n(h)i
-(as)f(P)n(ermMap,)g(MathMap,)i(SphMap\))f(can)g(result)f(in)h(Mappings)
-f(for)h(whic)n(h)427 1049 y(this)d(is)g(not)f(true.)259
-1175 y Fd(frame)427 1274 y Fi(P)n(oin)n(ter)f(to)i(a)f(F)-7
-b(rame)27 b(describing)g(the)h(co)r(ordinate)e(system)h(in)h(whic)n(h)g
-(the)g(new)f(Region)g(is)h(required.)0 1430 y Fd(Returned)k(V)-8
-b(alue:)259 1559 y(astMapRegion\(\))427 1659 y Fi(A)26
-b(p)r(oin)n(ter)e(to)h(a)f(new)h(Region.)36 b(This)24
-b(Region)h(will)g(represen)n(t)e(the)j(area)d(within)j(the)f(co)r
-(ordinate)f(system)427 1759 y(sp)r(eci\014ed)k(b)n(y)f
-Ft(")p Fi(frame)p Ft(")g Fi(whic)n(h)g(corresp)r(onds)f(to)h(the)h
-(supplied)g(Region.)0 1914 y Fd(Notes:)340 2190 y Fh(\017)45
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(k)m(ey)427
+451 y Fi(A)d(c)n(haracter)e(string)h(to)h(b)r(e)g(stored)f(with)i(the)f
+(v)-5 b(alue,)27 b(whic)n(h)g(can)f(later)g(b)r(e)i(used)e(to)h(iden)n
+(tify)g(the)h(v)-5 b(alue.)427 551 y(T)e(railing)28 b(spaces)h(are)f
+(ignored.)40 b(The)29 b(supplied)h(string)e(is)h(con)n(v)n(erted)f(to)h
+(upp)r(er)g(case)g(b)r(efore)g(use)g(if)g(the)427 650
+y(KeyCase)d(attribute)i(is)g(curren)n(tly)e(set)i(to)f(zero.)259
+798 y Fd(commen)m(t)427 897 y Fi(A)g(p)r(oin)n(ter)e(to)h(a)f(n)n
+(ull-terminated)h(commen)n(t)g(string)f(to)h(b)r(e)g(stored)f(with)i
+(the)f(v)-5 b(alue.)36 b(A)27 b(NULL)f(p)r(oin)n(ter)427
+997 y(ma)n(y)h(b)r(e)h(supplied,)g(in)g(whic)n(h)g(case)e(no)i(commen)n
+(t)f(is)h(stored.)0 1188 y Fd(Notes:)340 1500 y Fh(\017)45
+b Fi(If)26 b(the)f(supplied)h(k)n(ey)e(is)h(already)f(in)h(use)g(in)g
+(the)h(KeyMap,)e(the)i(v)-5 b(alue)25 b(asso)r(ciated)e(with)j(the)g(k)
+n(ey)e(will)h(b)r(e)427 1600 y(remo)n(v)n(ed.)p 0 1828
+3780 12 v 0 1960 a Fz(astMapRegion)249 b Fe(T)-10 b(ransform)36
+b(a)j(Region)e(in)m(to)h(a)g(new)1129 2073 y(F)-10 b(rame)39
+b(using)f(a)h(giv)m(en)e(Mapping)2933 1960 y Fz(astMapRegion)0
+2292 y Fd(Description:)44 b Fi(This)34 b(function)g(returns)f(a)g(p)r
+(oin)n(ter)g(to)h(a)f(new)h(Region)f(whic)n(h)g(corresp)r(onds)f(to)h
+(supplied)h(Region)227 2391 y(describ)r(ed)i(b)n(y)g(some)g(other)f(sp)
+r(eci\014ed)i(co)r(ordinate)e(system.)62 b(A)37 b(Mapping)e(is)h
+(supplied)h(whic)n(h)f(transforms)227 2491 y(p)r(ositions)30
+b(b)r(et)n(w)n(een)g(the)g(old)g(and)g(new)g(co)r(ordinate)e(systems.)
+44 b(The)30 b(new)g(Region)f(ma)n(y)h(not)g(b)r(e)g(of)g(the)g(same)227
+2590 y(class)d(as)g(the)h(original)e(region.)0 2769 y
+Fd(Synopsis:)121 b Ft(AstRegion)40 b Fh(\003)p Ft(astMapRegion\()d
+(AstRegion)j Fh(\003)p Ft(this,)h(AstMapping)f Fh(\003)p
+Ft(map,)h(AstFrame)f Fh(\003)p Ft(frame)i(\))0 2948 y
+Fd(P)m(arameters:)259 3114 y(this)427 3214 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(Region.)259 3361 y Fd(map)427 3461 y Fi(P)n(oin)n(ter)d
+(to)i(a)f(Mapping)g(whic)n(h)h(transforms)e(p)r(ositions)h(from)h(the)g
+(co)r(ordinate)e(system)h(represen)n(ted)g(b)n(y)427
+3560 y(the)32 b(supplied)g(Region)f(to)g(the)h(co)r(ordinate)e(system)h
+(sp)r(eci\014ed)h(b)n(y)f Ft(")p Fi(frame)p Ft(")p Fi(.)47
+b(The)31 b(supplied)h(Mapping)427 3660 y(should)k(de\014ne)f(b)r(oth)h
+(forw)n(ard)e(and)i(in)n(v)n(erse)e(transformations,)h(and)h(these)f
+(transformations)f(should)427 3760 y(form)20 b(a)g(gen)n(uine)g(in)n(v)
+n(erse)f(pair.)33 b(That)21 b(is,)g(transforming)e(a)h(p)r(osition)g
+(using)g(the)h(forw)n(ard)d(transformation)427 3859 y(and)29
+b(then)g(using)f(the)h(in)n(v)n(erse)e(transformation)g(should)h(pro)r
+(duce)h(the)g(original)e(input)i(p)r(osition.)40 b(Some)427
+3959 y(Mapping)31 b(classes)e(\(suc)n(h)i(as)f(P)n(ermMap,)g(MathMap,)i
+(SphMap\))f(can)g(result)f(in)h(Mappings)f(for)h(whic)n(h)427
+4058 y(this)d(is)g(not)f(true.)259 4206 y Fd(frame)427
+4306 y Fi(P)n(oin)n(ter)f(to)i(a)f(F)-7 b(rame)27 b(describing)g(the)h
+(co)r(ordinate)e(system)h(in)h(whic)n(h)g(the)g(new)f(Region)g(is)h
+(required.)0 4497 y Fd(Returned)k(V)-8 b(alue:)259 4663
+y(astMapRegion\(\))427 4762 y Fi(A)26 b(p)r(oin)n(ter)e(to)h(a)f(new)h
+(Region.)36 b(This)24 b(Region)h(will)g(represen)n(t)e(the)j(area)d
+(within)j(the)f(co)r(ordinate)f(system)427 4862 y(sp)r(eci\014ed)k(b)n
+(y)f Ft(")p Fi(frame)p Ft(")g Fi(whic)n(h)g(corresp)r(onds)f(to)h(the)h
+(supplied)g(Region.)0 5053 y Fd(Notes:)340 5365 y Fh(\017)45
b Fi(The)24 b(uncertain)n(t)n(y)f(asso)r(ciated)f(with)i(the)h
(supplied)f(Region)f(is)g(mo)r(di\014ed)h(using)g(the)g(supplied)g
-(Mapping.)340 2316 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+(Mapping.)340 5513 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 2416 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 2602 3780 12 v 0 2732
-a Fz(astMapRemo)l(v)l(e)1079 2733 y Fe(Remo)m(v)m(ed)38
-b(a)g(named)h(en)m(try)e(from)h(a)1672 2847 y(KeyMap)2875
-2732 y Fz(astMapRemo)l(v)l(e)0 3022 y Fd(Description:)44
+427 5612 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p eop end
+%%Page: 285 295
+TeXDict begin 285 294 bop 3643 52 a FF(285)p 0 351 3780
+12 v 0 482 a Fz(astMapRemo)l(v)l(e)1079 483 y Fe(Remo)m(v)m(ed)38
+b(a)g(named)h(en)m(try)e(from)h(a)1672 596 y(KeyMap)2875
+482 y Fz(astMapRemo)l(v)l(e)0 760 y Fd(Description:)44
b Fi(This)33 b(function)g(remo)n(v)n(es)e(a)h(named)h(en)n(try)f(from)g
(a)h(KeyMap.)51 b(It)33 b(returns)f(without)h(action)f(if)h(the)227
-3122 y(KeyMap)27 b(do)r(es)g(not)h(con)n(tain)f(the)h(sp)r(eci\014ed)g
-(k)n(ey)-7 b(.)0 3265 y Fd(Synopsis:)121 b Ft(void)42
+860 y(KeyMap)27 b(do)r(es)g(not)h(con)n(tain)f(the)h(sp)r(eci\014ed)g
+(k)n(ey)-7 b(.)0 997 y Fd(Synopsis:)121 b Ft(void)42
b(astMapRemove\()c(AstKeyMap)i Fh(\003)p Ft(this,)h(const)g(char)h
-Fh(\003)p Ft(key)g(\))0 3407 y Fd(P)m(arameters:)259
-3537 y(this)427 3637 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)259
-3763 y Fd(k)m(ey)427 3863 y Fi(The)j(c)n(haracter)d(string)h(iden)n
+Fh(\003)p Ft(key)g(\))0 1134 y Fd(P)m(arameters:)259
+1258 y(this)427 1357 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)259
+1478 y Fd(k)m(ey)427 1577 y Fi(The)j(c)n(haracter)d(string)h(iden)n
(tifying)i(the)f(v)-5 b(alue)30 b(to)g(b)r(e)h(retriev)n(ed.)43
b(T)-7 b(railing)30 b(spaces)f(are)g(ignored.)44 b(The)427
-3962 y(supplied)26 b(string)f(is)g(con)n(v)n(erted)f(to)h(upp)r(er)g
+1677 y(supplied)26 b(string)f(is)g(con)n(v)n(erted)f(to)h(upp)r(er)g
(case)g(b)r(efore)g(use)g(if)h(the)g(KeyCase)e(attribute)h(is)g(curren)
-n(tly)g(set)427 4062 y(to)j(zero.)p 0 4248 V 0 4378 a
+n(tly)g(set)427 1776 y(to)j(zero.)p 0 1951 V 0 2081 a
Fz(astMapRename)237 b Fe(Rename)38 b(an)h(existing)e(KeyMap)1756
-4478 y(en)m(try)2866 4378 y Fz(astMapRename)0 4653 y
+2181 y(en)m(try)2866 2081 y Fz(astMapRename)0 2345 y
Fd(Description:)44 b Fi(This)21 b(function)h(asso)r(ciated)e(a)g(new)h
(k)n(ey)g(with)g(an)g(existing)f(en)n(try)h(in)g(a)g(KeyMap.)34
-b(It)21 b(returns)f(without)227 4753 y(action)27 b(if)h(the)g(oldk)n
-(ey)f(do)r(es)g(not)h(exist)f(in)h(the)g(KeyMap.)0 4896
+b(It)21 b(returns)f(without)227 2444 y(action)27 b(if)h(the)g(oldk)n
+(ey)f(do)r(es)g(not)h(exist)f(in)h(the)g(KeyMap.)0 2581
y Fd(Synopsis:)121 b Ft(void)42 b(astMapRename\()c(AstKeyMap)i
Fh(\003)p Ft(this,)h(const)g(char)h Fh(\003)p Ft(oldkey,)f(const)g
-(char)h Fh(\003)p Ft(newkey)f(\))0 5039 y Fd(P)m(arameters:)259
-5168 y(this)427 5268 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)259
-5394 y Fd(oldk)m(ey)427 5494 y Fi(The)j(c)n(haracter)d(string)i(iden)n
+(char)h Fh(\003)p Ft(newkey)f(\))0 2718 y Fd(P)m(arameters:)259
+2842 y(this)427 2942 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)259
+3062 y Fd(oldk)m(ey)427 3162 y Fi(The)j(c)n(haracter)d(string)i(iden)n
(tifying)h(the)g(en)n(try)f(to)h(b)r(e)g(renamed.)45
b(T)-7 b(railing)30 b(spaces)f(are)h(ignored.)45 b(The)427
-5593 y(supplied)26 b(string)f(is)g(con)n(v)n(erted)f(to)h(upp)r(er)g
+3261 y(supplied)26 b(string)f(is)g(con)n(v)n(erted)f(to)h(upp)r(er)g
(case)g(b)r(efore)g(use)g(if)h(the)g(KeyCase)e(attribute)h(is)g(curren)
-n(tly)g(set)427 5693 y(to)j(zero.)p eop end
-%%Page: 285 295
-TeXDict begin 285 294 bop 3643 52 a FF(285)259 351 y
-Fd(newk)m(ey)427 451 y Fi(The)29 b(new)f(c)n(haracter)e(string)h(to)h
-(asso)r(ciated)f(with)i(the)g(renamed)e(en)n(try)-7 b(.)38
-b(T)-7 b(railing)27 b(spaces)h(are)f(ignored.)427 551
-y(The)c(supplied)g(string)f(is)g(con)n(v)n(erted)f(to)i(upp)r(er)g
-(case)e(b)r(efore)i(use)f(if)h(the)g(KeyCase)e(attribute)i(is)g(curren)
-n(tly)427 650 y(set)28 b(to)f(zero.)p 0 848 3780 12 v
-0 980 a Fz(astMapSize)202 b Fe(Get)38 b(the)h(n)m(um)m(b)s(er)f(of)g
-(en)m(tries)g(in)g(a)h(KeyMap)201 b Fz(astMapSize)0 1167
-y Fd(Description:)44 b Fi(This)28 b(function)g(returns)f(the)h(n)n(um)n
-(b)r(er)f(of)h(en)n(tries)f(in)h(a)f(KeyMap.)0 1316 y
-Fd(Synopsis:)121 b Ft(int)42 b(astMapSize\()d(AstKeyMap)h
-Fh(\003)p Ft(this)i(\))0 1465 y Fd(P)m(arameters:)259
-1600 y(this)427 1700 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)0
-1861 y Fd(Returned)k(V)-8 b(alue:)259 1997 y(astMapSize\(\))427
-2096 y Fi(The)28 b(n)n(um)n(b)r(er)f(of)h(en)n(tries)f(in)h(the)g
-(KeyMap.)0 2258 y Fd(Notes:)340 2540 y Fh(\017)45 b Fi(A)29
+n(tly)g(set)427 3361 y(to)j(zero.)259 3481 y Fd(newk)m(ey)427
+3581 y Fi(The)h(new)f(c)n(haracter)e(string)h(to)h(asso)r(ciated)f
+(with)i(the)g(renamed)e(en)n(try)-7 b(.)38 b(T)-7 b(railing)27
+b(spaces)h(are)f(ignored.)427 3681 y(The)c(supplied)g(string)f(is)g
+(con)n(v)n(erted)f(to)i(upp)r(er)g(case)e(b)r(efore)i(use)f(if)h(the)g
+(KeyCase)e(attribute)i(is)g(curren)n(tly)427 3780 y(set)28
+b(to)f(zero.)p 0 3954 V 0 4086 a Fz(astMapSize)202 b
+Fe(Get)38 b(the)h(n)m(um)m(b)s(er)f(of)g(en)m(tries)g(in)g(a)h(KeyMap)
+201 b Fz(astMapSize)0 4250 y Fd(Description:)44 b Fi(This)28
+b(function)g(returns)f(the)h(n)n(um)n(b)r(er)f(of)h(en)n(tries)f(in)h
+(a)f(KeyMap.)0 4387 y Fd(Synopsis:)121 b Ft(int)42 b(astMapSize\()d
+(AstKeyMap)h Fh(\003)p Ft(this)i(\))0 4524 y Fd(P)m(arameters:)259
+4648 y(this)427 4747 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)0
+4897 y Fd(Returned)k(V)-8 b(alue:)259 5021 y(astMapSize\(\))427
+5120 y Fi(The)28 b(n)n(um)n(b)r(er)f(of)h(en)n(tries)f(in)h(the)g
+(KeyMap.)0 5270 y Fd(Notes:)340 5540 y Fh(\017)45 b Fi(A)29
b(function)g(v)-5 b(alue)28 b(of)g(zero)f(will)h(b)r(e)h(returned)e(if)
i(an)f(error)e(has)i(already)e(o)r(ccurred,)i(or)f(if)i(this)f
-(function)427 2639 y(should)g(fail)f(for)g(an)n(y)g(reason.)p
-0 2837 V 0 2969 a Fz(astMapSplit)350 b Fe(Split)38 b(a)g(Mapping)g(up)h
-(in)m(to)e(parallel)1342 3082 y(comp)s(onen)m(t)g(Mappings)3065
-2969 y Fz(astMapSplit)0 3269 y Fd(Description:)44 b Fi(This)33
-b(function)f(creates)f(a)h(new)g(Mapping)g(whic)n(h)h(connects)e(sp)r
-(eci\014ed)i(inputs)g(within)f(a)g(supplied)227 3369
-y(Mapping)19 b(to)g(the)h(corresp)r(onding)d(outputs)j(of)f(the)h
-(supplied)g(Mapping.)33 b(This)20 b(is)f(only)g(p)r(ossible)g(if)h(the)
-f(sp)r(eci\014ed)227 3469 y(inputs)32 b(corresp)r(ond)e(to)h(some)g
-(subset)g(of)h(the)f(Mapping)g(outputs.)49 b(That)31
-b(is,)h(there)g(m)n(ust)f(exist)g(a)g(subset)h(of)227
-3568 y(the)25 b(Mapping)f(outputs)h(for)f(whic)n(h)h(eac)n(h)e(output)j
-(dep)r(ends)f(only)f(on)g(the)h(selected)f(Mapping)g(inputs,)i(and)f
-(not)227 3668 y(on)32 b(an)n(y)e(of)i(the)g(inputs)g(whic)n(h)f(ha)n(v)
-n(e)g(not)g(b)r(een)h(selected.)49 b(Also,)32 b(an)n(y)f(output)h(whic)
-n(h)g(is)f(not)h(in)g(this)g(subset)227 3767 y(m)n(ust)h(not)g(dep)r
-(end)h(on)f(an)n(y)f(of)h(the)g(selected)g(inputs.)53
-b(If)34 b(these)f(conditions)f(are)g(not)h(met)g(b)n(y)g(the)g
-(supplied)227 3867 y(Mapping,)28 b(then)g(a)f(NULL)h(Mapping)f(p)r(oin)
-n(ter)g(is)h(returned.)0 4016 y Fd(Synopsis:)121 b Ft(void)42
-b(astMapSplit\()c(AstMapping)i Fh(\003)p Ft(this,)h(int)h(nin,)g(const)
-g(int)g Fh(\003)p Ft(in,)g(int)g Fh(\003)p Ft(out,)g(AstMapping)227
-4115 y Fh(\003\003)p Ft(map)g(\))0 4264 y Fd(P)m(arameters:)259
-4400 y(this)427 4500 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Mapping)f(to)g
-(b)r(e)h(split.)259 4632 y Fd(nin)427 4731 y Fi(The)g(n)n(um)n(b)r(er)f
-(of)h(inputs)g(to)f(pic)n(k)h(from)f Ft(")p Fi(this)p
-Ft(")p Fi(.)259 4863 y Fd(in)427 4963 y Fi(P)n(oin)n(ter)20
-b(to)h(an)g(arra)n(y)d(holding)j(the)h(indices)f(within)h(the)f
-(supplied)h(Mapping)e(of)h(the)h(inputs)g(whic)n(h)f(are)f(to)427
-5063 y(b)r(e)26 b(pic)n(k)n(ed)f(from)g(the)h(Mapping.)35
-b(This)26 b(arra)n(y)d(should)i(ha)n(v)n(e)f Ft(")p Fi(nin)p
-Ft(")h Fi(elemen)n(ts.)36 b(If)26 b Ft(")p Fi(Nin)p Ft(")f
-Fi(is)g(the)h(n)n(um)n(b)r(er)427 5162 y(of)k(inputs)g(of)g(the)g
-(supplied)g(Mapping,)g(then)g(eac)n(h)f(elemen)n(t)h(should)g(ha)n(v)n
-(e)e(a)h(v)-5 b(alue)30 b(in)g(the)g(range)e(1)i(to)427
-5262 y(Nin.)259 5394 y Fd(out)427 5494 y Fi(P)n(oin)n(ter)i(to)h(an)g
-(arra)n(y)e(in)j(whic)n(h)f(to)g(return)g(the)h(indices)f(of)h(the)g
-(outputs)f(of)h(the)f(supplied)h(Mapping)427 5593 y(whic)n(h)j(are)f
-(fed)h(b)n(y)g(the)g(pic)n(k)n(ed)f(inputs.)66 b(A)37
-b(v)-5 b(alue)37 b(of)f(one)h(is)g(used)f(to)h(refer)f(to)h(the)g
-(\014rst)g(Mapping)427 5693 y(output.)59 b(The)35 b(supplied)g(arra)n
-(y)d(should)j(ha)n(v)n(e)e(a)i(length)f(at)h(least)f(equal)g(to)h(the)g
-(n)n(um)n(b)r(er)g(of)f(outputs)p eop end
+(function)427 5640 y(should)g(fail)f(for)g(an)n(y)g(reason.)p
+eop end
%%Page: 286 296
TeXDict begin 286 295 bop 0 52 a FF(286)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)427 351 y Fi(in)k(the)h(supplied)f
-(Mapping.)55 b(The)34 b(n)n(um)n(b)r(er)f(of)h(v)-5 b(alues)34
-b(stored)f(in)h(the)g(arra)n(y)d(on)j(exit)g(will)g(equal)f(the)427
-451 y(n)n(um)n(b)r(er)g(of)f(outputs)h(in)g(the)g(returned)f(Mapping.)
-51 b(The)33 b(i'th)g(elemen)n(t)g(in)g(the)g(returned)f(arra)n(y)e
-(holds)427 551 y(the)e(index)g(within)g(the)g(supplied)g(Mapping)f
-(whic)n(h)g(corresp)r(onds)f(to)i(the)f(i'th)i(output)f(of)f(the)h
-(returned)427 650 y(Mapping.)259 787 y Fd(map)427 887
-y Fi(Address)h(of)h(a)f(lo)r(cation)g(at)g(whic)n(h)h(to)f(return)g(a)g
-(p)r(oin)n(ter)h(to)f(the)h(returned)f(Mapping.)42 b(This)30
-b(Mapping)427 986 y(will)c(ha)n(v)n(e)f Ft(")p Fi(nin)p
-Ft(")h Fi(inputs)g(\(the)h(n)n(um)n(b)r(er)f(of)g(outputs)g(ma)n(y)f(b)
-r(e)i(di\013eren)n(t)f(to)g Ft(")p Fi(nin)p Ft(")p Fi(\).)36
-b(NULL)26 b(is)g(returned)427 1086 y(if)j(the)g(supplied)g(Mapping)f
-(has)g(no)h(subset)f(of)h(outputs)g(whic)n(h)f(dep)r(end)h(only)f(on)h
-(the)g(selected)f(inputs.)427 1186 y(The)g(returned)f(Mapping)g(is)h(a)
-f(deep)h(cop)n(y)e(of)i(the)g(required)f(parts)f(of)i(the)g(supplied)g
-(Mapping.)0 1356 y Fd(Notes:)340 1647 y Fh(\017)45 b
-Fi(If)29 b(this)g(function)g(is)f(in)n(v)n(ok)n(ed)f(with)i(the)g
-(global)e(error)g(status)h(set,)h(or)e(if)i(it)g(should)f(fail)h(for)f
-(an)n(y)f(reason,)427 1746 y(then)h(a)g(NULL)g(v)-5 b(alue)27
-b(will)h(b)r(e)g(returned)f(for)g(the)h Ft(")p Fi(map)p
-Ft(")f Fi(p)r(oin)n(ter.)p 0 1954 3780 12 v 0 2084 a
-Fz(astMapT)l(yp)t(e)1011 2085 y Fe(Get)39 b(the)f(data)g(t)m(yp)s(e)g
-(of)h(an)f(en)m(try)g(in)h(a)1672 2199 y(KeyMap)3041
-2084 y Fz(astMapT)l(yp)t(e)0 2396 y Fd(Description:)44
-b Fi(This)34 b(function)g(returns)f(a)g(v)-5 b(alue)33
-b(indicating)h(the)g(data)f(t)n(yp)r(e)g(of)h(a)f(named)h(en)n(try)f
-(in)g(a)g(KeyMap.)227 2495 y(This)28 b(is)f(the)h(data)f(t)n(yp)r(e)h
-(whic)n(h)g(w)n(as)e(used)i(when)g(the)g(en)n(try)f(w)n(as)f(added)i
-(to)f(the)h(KeyMap.)0 2653 y Fd(Synopsis:)121 b Ft(int)42
-b(astMapType\()d(AstKeyMap)h Fh(\003)p Ft(this,)h(const)h(char)g
-Fh(\003)p Ft(key)f(\))0 2811 y Fd(P)m(arameters:)259
-2956 y(this)427 3055 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)259
-3192 y Fd(k)m(ey)427 3292 y Fi(The)23 b(c)n(haracter)d(string)i(iden)n
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 483 a Fz(astMapSplit)350 b Fe(Split)38 b(a)g(Mapping)g(up)h(in)m(to)e
+(parallel)1342 596 y(comp)s(onen)m(t)g(Mappings)3065
+483 y Fz(astMapSplit)0 785 y Fd(Description:)44 b Fi(This)33
+b(function)f(creates)f(a)h(new)g(Mapping)g(whic)n(h)h(connects)e(sp)r
+(eci\014ed)i(inputs)g(within)f(a)g(supplied)227 885 y(Mapping)19
+b(to)g(the)h(corresp)r(onding)d(outputs)j(of)f(the)h(supplied)g
+(Mapping.)33 b(This)20 b(is)f(only)g(p)r(ossible)g(if)h(the)f(sp)r
+(eci\014ed)227 984 y(inputs)32 b(corresp)r(ond)e(to)h(some)g(subset)g
+(of)h(the)f(Mapping)g(outputs.)49 b(That)31 b(is,)h(there)g(m)n(ust)f
+(exist)g(a)g(subset)h(of)227 1084 y(the)25 b(Mapping)f(outputs)h(for)f
+(whic)n(h)h(eac)n(h)e(output)j(dep)r(ends)f(only)f(on)g(the)h(selected)
+f(Mapping)g(inputs,)i(and)f(not)227 1184 y(on)32 b(an)n(y)e(of)i(the)g
+(inputs)g(whic)n(h)f(ha)n(v)n(e)g(not)g(b)r(een)h(selected.)49
+b(Also,)32 b(an)n(y)f(output)h(whic)n(h)g(is)f(not)h(in)g(this)g
+(subset)227 1283 y(m)n(ust)h(not)g(dep)r(end)h(on)f(an)n(y)f(of)h(the)g
+(selected)g(inputs.)53 b(If)34 b(these)f(conditions)f(are)g(not)h(met)g
+(b)n(y)g(the)g(supplied)227 1383 y(Mapping,)28 b(then)g(a)f(NULL)h
+(Mapping)f(p)r(oin)n(ter)g(is)h(returned.)0 1532 y Fd(Synopsis:)121
+b Ft(void)42 b(astMapSplit\()c(AstMapping)i Fh(\003)p
+Ft(this,)h(int)h(nin,)g(const)g(int)g Fh(\003)p Ft(in,)g(int)g
+Fh(\003)p Ft(out,)g(AstMapping)227 1632 y Fh(\003\003)p
+Ft(map)g(\))0 1781 y Fd(P)m(arameters:)259 1918 y(this)427
+2017 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Mapping)f(to)g(b)r(e)h(split.)
+259 2150 y Fd(nin)427 2250 y Fi(The)g(n)n(um)n(b)r(er)f(of)h(inputs)g
+(to)f(pic)n(k)h(from)f Ft(")p Fi(this)p Ft(")p Fi(.)259
+2383 y Fd(in)427 2482 y Fi(P)n(oin)n(ter)20 b(to)h(an)g(arra)n(y)d
+(holding)j(the)h(indices)f(within)h(the)f(supplied)h(Mapping)e(of)h
+(the)h(inputs)g(whic)n(h)f(are)f(to)427 2582 y(b)r(e)26
+b(pic)n(k)n(ed)f(from)g(the)h(Mapping.)35 b(This)26 b(arra)n(y)d
+(should)i(ha)n(v)n(e)f Ft(")p Fi(nin)p Ft(")h Fi(elemen)n(ts.)36
+b(If)26 b Ft(")p Fi(Nin)p Ft(")f Fi(is)g(the)h(n)n(um)n(b)r(er)427
+2682 y(of)k(inputs)g(of)g(the)g(supplied)g(Mapping,)g(then)g(eac)n(h)f
+(elemen)n(t)h(should)g(ha)n(v)n(e)e(a)h(v)-5 b(alue)30
+b(in)g(the)g(range)e(1)i(to)427 2781 y(Nin.)259 2914
+y Fd(out)427 3014 y Fi(P)n(oin)n(ter)i(to)h(an)g(arra)n(y)e(in)j(whic)n
+(h)f(to)g(return)g(the)h(indices)f(of)h(the)g(outputs)f(of)h(the)f
+(supplied)h(Mapping)427 3113 y(whic)n(h)j(are)f(fed)h(b)n(y)g(the)g
+(pic)n(k)n(ed)f(inputs.)66 b(A)37 b(v)-5 b(alue)37 b(of)f(one)h(is)g
+(used)f(to)h(refer)f(to)h(the)g(\014rst)g(Mapping)427
+3213 y(output.)59 b(The)35 b(supplied)g(arra)n(y)d(should)j(ha)n(v)n(e)
+e(a)i(length)f(at)h(least)f(equal)g(to)h(the)g(n)n(um)n(b)r(er)g(of)f
+(outputs)427 3313 y(in)g(the)h(supplied)f(Mapping.)55
+b(The)34 b(n)n(um)n(b)r(er)f(of)h(v)-5 b(alues)34 b(stored)f(in)h(the)g
+(arra)n(y)d(on)j(exit)g(will)g(equal)f(the)427 3412 y(n)n(um)n(b)r(er)g
+(of)f(outputs)h(in)g(the)g(returned)f(Mapping.)51 b(The)33
+b(i'th)g(elemen)n(t)g(in)g(the)g(returned)f(arra)n(y)e(holds)427
+3512 y(the)e(index)g(within)g(the)g(supplied)g(Mapping)f(whic)n(h)g
+(corresp)r(onds)f(to)i(the)f(i'th)i(output)f(of)f(the)h(returned)427
+3611 y(Mapping.)259 3744 y Fd(map)427 3844 y Fi(Address)h(of)h(a)f(lo)r
+(cation)g(at)g(whic)n(h)h(to)f(return)g(a)g(p)r(oin)n(ter)h(to)f(the)h
+(returned)f(Mapping.)42 b(This)30 b(Mapping)427 3944
+y(will)c(ha)n(v)n(e)f Ft(")p Fi(nin)p Ft(")h Fi(inputs)g(\(the)h(n)n
+(um)n(b)r(er)f(of)g(outputs)g(ma)n(y)f(b)r(e)i(di\013eren)n(t)f(to)g
+Ft(")p Fi(nin)p Ft(")p Fi(\).)36 b(NULL)26 b(is)g(returned)427
+4043 y(if)j(the)g(supplied)g(Mapping)f(has)g(no)h(subset)f(of)h
+(outputs)g(whic)n(h)f(dep)r(end)h(only)f(on)h(the)g(selected)f(inputs.)
+427 4143 y(The)g(returned)f(Mapping)g(is)h(a)f(deep)h(cop)n(y)e(of)i
+(the)g(required)f(parts)f(of)i(the)g(supplied)g(Mapping.)0
+4305 y Fd(Notes:)340 4587 y Fh(\017)45 b Fi(If)29 b(this)g(function)g
+(is)f(in)n(v)n(ok)n(ed)f(with)i(the)g(global)e(error)g(status)h(set,)h
+(or)e(if)i(it)g(should)f(fail)h(for)f(an)n(y)f(reason,)427
+4687 y(then)h(a)g(NULL)g(v)-5 b(alue)27 b(will)h(b)r(e)g(returned)f
+(for)g(the)h Ft(")p Fi(map)p Ft(")f Fi(p)r(oin)n(ter.)p
+0 4886 V 0 5017 a Fz(astMapT)l(yp)t(e)1011 5018 y Fe(Get)39
+b(the)f(data)g(t)m(yp)s(e)g(of)h(an)f(en)m(try)g(in)h(a)1672
+5131 y(KeyMap)3041 5017 y Fz(astMapT)l(yp)t(e)0 5320
+y Fd(Description:)44 b Fi(This)34 b(function)g(returns)f(a)g(v)-5
+b(alue)33 b(indicating)h(the)g(data)f(t)n(yp)r(e)g(of)h(a)f(named)h(en)
+n(try)f(in)g(a)g(KeyMap.)227 5420 y(This)28 b(is)f(the)h(data)f(t)n(yp)
+r(e)h(whic)n(h)g(w)n(as)e(used)i(when)g(the)g(en)n(try)f(w)n(as)f
+(added)i(to)f(the)h(KeyMap.)0 5569 y Fd(Synopsis:)121
+b Ft(int)42 b(astMapType\()d(AstKeyMap)h Fh(\003)p Ft(this,)h(const)h
+(char)g Fh(\003)p Ft(key)f(\))0 5718 y Fd(P)m(arameters:)p
+eop end
+%%Page: 287 297
+TeXDict begin 287 296 bop 3643 52 a FF(287)259 351 y
+Fd(this)427 451 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(KeyMap.)259
+590 y Fd(k)m(ey)427 689 y Fi(The)23 b(c)n(haracter)d(string)i(iden)n
(tifying)h(the)f(KeyMap)g(en)n(try)-7 b(.)35 b(T)-7 b(railing)21
b(spaces)g(are)h(ignored.)34 b(The)22 b(supplied)427
-3391 y(string)j(is)f(con)n(v)n(erted)g(to)h(upp)r(er)g(case)f(b)r
-(efore)h(use)g(if)g(the)g(KeyCase)f(attribute)h(is)g(curren)n(tly)f
-(set)h(to)g(zero.)0 3562 y Fd(Returned)32 b(V)-8 b(alue:)259
-3706 y(astMapT)m(yp)s(e\(\))427 3806 y Fi(One)19 b(of)f(AST)p
+789 y(string)j(is)f(con)n(v)n(erted)g(to)h(upp)r(er)g(case)f(b)r(efore)
+h(use)g(if)g(the)g(KeyCase)f(attribute)h(is)g(curren)n(tly)f(set)h(to)g
+(zero.)0 963 y Fd(Returned)32 b(V)-8 b(alue:)259 1111
+y(astMapT)m(yp)s(e\(\))427 1210 y Fi(One)19 b(of)f(AST)p
Ft(__)p Fi(INTTYPE)g(\(for)g(in)n(teger\),)i(AST)p Ft(__)p
Fi(SINTTYPE)e(\(for)g(short)g(in)n(t\),)j(AST)p Ft(__)p
-Fi(BYTETYPE)427 3905 y(\(for)28 b(unsigned)f(b)n(ytes)510
-4017 y Fh(\017)45 b Fi(i.e.)34 b(unsigned)18 b(c)n(hars)f(\))i(AST)p
+Fi(BYTETYPE)427 1310 y(\(for)28 b(unsigned)f(b)n(ytes)510
+1424 y Fh(\017)45 b Fi(i.e.)34 b(unsigned)18 b(c)n(hars)f(\))i(AST)p
Ft(__)p Fi(DOUBLETYPE)e(\(for)h(double)g(precision)f(\015oating)h(p)r
(oin)n(t\),)j(AST)p Ft(__)p Fi(FLO)n(A)-7 b(TTYPE)597
-4117 y(\(for)18 b(single)g(precision)g(\015oating)f(p)r(oin)n(t\),)k
+1523 y(\(for)18 b(single)g(precision)g(\015oating)f(p)r(oin)n(t\),)k
(AST)p Ft(__)p Fi(STRINGTYPE)d(\(for)g(c)n(haracter)e(string\),)k(AST)p
-Ft(__)p Fi(OBJECTTYPE)597 4216 y(\(for)e(AST)h(Ob)5 b(ject)18
+Ft(__)p Fi(OBJECTTYPE)597 1622 y(\(for)e(AST)h(Ob)5 b(ject)18
b(p)r(oin)n(ter\),)j(AST)p Ft(__)p Fi(POINTER)-7 b(TYPE)16
b(\(for)i(arbitrary)e(C)j(p)r(oin)n(ter\))f(or)f(AST)p
-Ft(__)p Fi(UNDEFTYPE)597 4316 y(\(for)23 b(unde\014ned)g(v)-5
+Ft(__)p Fi(UNDEFTYPE)597 1722 y(\(for)23 b(unde\014ned)g(v)-5
b(alues)22 b(created)g(b)n(y)g(astMapPutU\).)h(AST)p
Ft(__)p Fi(BADTYPE)f(is)g(returned)h(if)g(the)g(sup-)597
-4415 y(plied)28 b(k)n(ey)f(is)h(not)f(found)h(in)g(the)g(KeyMap.)0
-4586 y Fd(Notes:)340 4876 y Fh(\017)45 b Fi(A)26 b(function)g(v)-5
+1822 y(plied)28 b(k)n(ey)f(is)h(not)f(found)h(in)g(the)g(KeyMap.)0
+1995 y Fd(Notes:)340 2290 y Fh(\017)45 b Fi(A)26 b(function)g(v)-5
b(alue)26 b(of)f(AST)p Ft(__)p Fi(BADTYPE)g(will)h(b)r(e)g(returned)f
(if)h(an)f(error)f(has)h(already)f(o)r(ccurred,)g(or)h(if)427
-4976 y(this)j(function)g(should)g(fail)f(for)g(an)n(y)g(reason.)p
-0 5184 V 0 5315 a Fz(astMark)569 b Fe(Dra)m(w)38 b(a)h(set)f(of)h(mark)
-m(ers)e(for)g(a)i(Plot)567 b Fz(astMark)0 5494 y Fd(Description:)44
-b Fi(This)d(function)g(dra)n(ws)e(a)h(set)h(of)f(mark)n(ers)f(\(sym)n
-(b)r(ols\))h(at)h(p)r(ositions)f(sp)r(eci\014ed)h(in)g(the)f(ph)n
-(ysical)227 5593 y(co)r(ordinate)22 b(system)g(of)g(a)h(Plot.)34
-b(The)23 b(p)r(ositions)f(are)f(transformed)h(in)n(to)g(graphical)f(co)
-r(ordinates)g(to)i(determine)227 5693 y(where)k(the)h(mark)n(ers)e
-(should)h(app)r(ear)g(within)h(the)g(plotting)g(area.)p
-eop end
-%%Page: 287 297
-TeXDict begin 287 296 bop 3643 52 a FF(287)0 351 y Fd(Synopsis:)121
-b Ft(void)42 b(astMark\()e(AstPlot)h Fh(\003)p Ft(this,)g(int)h(nmark,)
-f(int)i(ncoord,)d(int)j(indim,)e(const)g(double)g Fh(\003)p
-Ft(in,)227 451 y(int)i(type)f(\))0 599 y Fd(P)m(arameters:)259
-734 y(this)427 834 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259
-965 y Fd(nmark)427 1065 y Fi(The)g(n)n(um)n(b)r(er)f(of)h(mark)n(ers)d
+2389 y(this)j(function)g(should)g(fail)f(for)g(an)n(y)g(reason.)p
+0 2600 3780 12 v 0 2732 a Fz(astMark)569 b Fe(Dra)m(w)38
+b(a)h(set)f(of)h(mark)m(ers)e(for)g(a)i(Plot)567 b Fz(astMark)0
+2914 y Fd(Description:)44 b Fi(This)d(function)g(dra)n(ws)e(a)h(set)h
+(of)f(mark)n(ers)f(\(sym)n(b)r(ols\))h(at)h(p)r(ositions)f(sp)r
+(eci\014ed)h(in)g(the)f(ph)n(ysical)227 3014 y(co)r(ordinate)22
+b(system)g(of)g(a)h(Plot.)34 b(The)23 b(p)r(ositions)f(are)f
+(transformed)h(in)n(to)g(graphical)f(co)r(ordinates)g(to)i(determine)
+227 3113 y(where)k(the)h(mark)n(ers)e(should)h(app)r(ear)g(within)h
+(the)g(plotting)g(area.)0 3274 y Fd(Synopsis:)121 b Ft(void)42
+b(astMark\()e(AstPlot)h Fh(\003)p Ft(this,)g(int)h(nmark,)f(int)i
+(ncoord,)d(int)j(indim,)e(const)g(double)g Fh(\003)p
+Ft(in,)227 3374 y(int)i(type)f(\))0 3535 y Fd(P)m(arameters:)259
+3683 y(this)427 3783 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Plot.)259
+3922 y Fd(nmark)427 4021 y Fi(The)g(n)n(um)n(b)r(er)f(of)h(mark)n(ers)d
(to)j(dra)n(w.)36 b(This)27 b(ma)n(y)g(b)r(e)h(zero,)f(in)g(whic)n(h)h
-(case)f(nothing)g(will)h(b)r(e)g(dra)n(wn.)259 1196 y
-Fd(nco)s(ord)427 1296 y Fi(The)37 b(n)n(um)n(b)r(er)f(of)h(co)r
+(case)f(nothing)g(will)h(b)r(e)g(dra)n(wn.)259 4160 y
+Fd(nco)s(ord)427 4260 y Fi(The)37 b(n)n(um)n(b)r(er)f(of)h(co)r
(ordinates)e(b)r(eing)i(supplied)g(for)f(eac)n(h)g(mark)f(\(i.e.)65
b(the)37 b(n)n(um)n(b)r(er)f(of)h(axes)e(in)i(the)427
-1396 y(curren)n(t)27 b(F)-7 b(rame)27 b(of)h(the)g(Plot,)f(as)g(giv)n
-(en)f(b)n(y)i(its)f(Naxes)g(attribute\).)259 1527 y Fd(indim)427
-1627 y Fi(The)33 b(n)n(um)n(b)r(er)f(of)h(elemen)n(ts)g(along)e(the)i
+4359 y(curren)n(t)27 b(F)-7 b(rame)27 b(of)h(the)g(Plot,)f(as)g(giv)n
+(en)f(b)n(y)i(its)f(Naxes)g(attribute\).)259 4498 y Fd(indim)427
+4598 y Fi(The)33 b(n)n(um)n(b)r(er)f(of)h(elemen)n(ts)g(along)e(the)i
(second)f(dimension)h(of)f(the)h Ft(")p Fi(in)p Ft(")f
-Fi(arra)n(y)f(\(whic)n(h)i(con)n(tains)e(the)427 1726
+Fi(arra)n(y)f(\(whic)n(h)i(con)n(tains)e(the)427 4697
y(mark)n(er)h(co)r(ordinates\).)54 b(This)33 b(v)-5 b(alue)34
b(is)f(required)g(so)g(that)g(the)h(co)r(ordinate)f(v)-5
-b(alues)33 b(can)g(b)r(e)h(correctly)427 1826 y(lo)r(cated)21
+b(alues)33 b(can)g(b)r(e)h(correctly)427 4797 y(lo)r(cated)21
b(if)h(they)g(do)f(not)g(en)n(tirely)g(\014ll)g(this)h(arra)n(y)-7
b(.)33 b(The)21 b(v)-5 b(alue)21 b(giv)n(en)g(should)g(not)g(b)r(e)h
-(less)f(than)g Ft(")p Fi(nmark)p Ft(")p Fi(.)259 1957
-y Fd(in)427 2057 y Fi(The)32 b(address)f(of)g(the)h(\014rst)g(elemen)n
+(less)f(than)g Ft(")p Fi(nmark)p Ft(")p Fi(.)259 4936
+y Fd(in)427 5035 y Fi(The)32 b(address)f(of)g(the)h(\014rst)g(elemen)n
(t)g(of)f(a)h(2-dimensional)e(arra)n(y)f(of)j(shap)r(e)g
-Ft(")p Fi([nco)r(ord][indim])p Ft(")e Fi(giving)427 2157
+Ft(")p Fi([nco)r(ord][indim])p Ft(")e Fi(giving)427 5135
y(the)24 b(ph)n(ysical)d(co)r(ordinates)h(of)h(the)g(p)r(oin)n(ts)g
(where)f(mark)n(ers)f(are)h(to)g(b)r(e)i(dra)n(wn.)34
-b(These)23 b(should)f(b)r(e)h(stored)427 2256 y(suc)n(h)31
+b(These)23 b(should)f(b)r(e)h(stored)427 5235 y(suc)n(h)31
b(that)h(the)f(v)-5 b(alue)31 b(of)g(co)r(ordinate)f(n)n(um)n(b)r(er)h
Ft(")p Fi(co)r(ord)p Ft(")f Fi(for)g(input)i(mark)f(n)n(um)n(b)r(er)g
-Ft(")p Fi(mark)p Ft(")e Fi(is)i(found)427 2356 y(in)d(elemen)n(t)g
-Ft(")p Fi(in[co)r(ord][mark])p Ft(")p Fi(.)259 2487 y
-Fd(t)m(yp)s(e)427 2587 y Fi(A)e(v)-5 b(alue)25 b(sp)r(ecifying)h(the)g
+Ft(")p Fi(mark)p Ft(")e Fi(is)i(found)427 5334 y(in)d(elemen)n(t)g
+Ft(")p Fi(in[co)r(ord][mark])p Ft(")p Fi(.)259 5473 y
+Fd(t)m(yp)s(e)427 5573 y Fi(A)e(v)-5 b(alue)25 b(sp)r(ecifying)h(the)g
(t)n(yp)r(e)f(\(e.g.)36 b(shap)r(e\))26 b(of)f(mark)n(er)f(to)h(b)r(e)h
(dra)n(wn.)35 b(The)26 b(set)f(of)h(v)-5 b(alues)25 b(whic)n(h)g(ma)n
-(y)427 2687 y(b)r(e)j(used)g(\(and)g(the)g(shap)r(es)f(that)h(will)f
+(y)427 5672 y(b)r(e)j(used)g(\(and)g(the)g(shap)r(es)f(that)h(will)f
(result\))h(is)f(determined)h(b)n(y)g(the)g(underlying)f(graphics)f
-(system.)0 2847 y Fd(Notes:)340 3128 y Fh(\017)45 b Fi(Mark)n(ers)21
-b(are)g(not)i(dra)n(wn)f(at)g(p)r(ositions)g(whic)n(h)h(ha)n(v)n(e)e
-(an)n(y)h(co)r(ordinate)f(equal)i(to)f(the)h(v)-5 b(alue)23
-b(AST)p Ft(__)p Fi(BAD)427 3228 y(\(or)38 b(where)g(the)g
-(transformation)f(in)n(to)h(graphical)e(co)r(ordinates)h(yields)h(co)r
-(ordinates)f(con)n(taining)g(the)427 3328 y(v)-5 b(alue)28
-b(AST)p Ft(__)p Fi(BAD\).)340 3459 y Fh(\017)45 b Fi(If)28
-b(an)n(y)f(mark)n(er)f(p)r(osition)h(is)h(clipp)r(ed)g(\(see)g
-(astClip\),)f(then)h(the)g(en)n(tire)g(mark)n(er)d(is)j(not)g(dra)n
-(wn.)340 3591 y Fh(\017)45 b Fi(An)28 b(error)e(results)h(if)h(the)g
-(base)f(F)-7 b(rame)27 b(of)h(the)g(Plot)f(is)g(not)h(2-dimensional.)
-340 3722 y Fh(\017)45 b Fi(An)30 b(error)d(also)g(results)i(if)g(the)g
+(system.)p eop end
+%%Page: 288 298
+TeXDict begin 288 297 bop 0 52 a FF(288)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Notes:)340
+631 y Fh(\017)45 b Fi(Mark)n(ers)21 b(are)g(not)i(dra)n(wn)f(at)g(p)r
+(ositions)g(whic)n(h)h(ha)n(v)n(e)e(an)n(y)h(co)r(ordinate)f(equal)i
+(to)f(the)h(v)-5 b(alue)23 b(AST)p Ft(__)p Fi(BAD)427
+731 y(\(or)38 b(where)g(the)g(transformation)f(in)n(to)h(graphical)e
+(co)r(ordinates)h(yields)h(co)r(ordinates)f(con)n(taining)g(the)427
+830 y(v)-5 b(alue)28 b(AST)p Ft(__)p Fi(BAD\).)340 960
+y Fh(\017)45 b Fi(If)28 b(an)n(y)f(mark)n(er)f(p)r(osition)h(is)h
+(clipp)r(ed)g(\(see)g(astClip\),)f(then)h(the)g(en)n(tire)g(mark)n(er)d
+(is)j(not)g(dra)n(wn.)340 1090 y Fh(\017)45 b Fi(An)28
+b(error)e(results)h(if)h(the)g(base)f(F)-7 b(rame)27
+b(of)h(the)g(Plot)f(is)g(not)h(2-dimensional.)340 1220
+y Fh(\017)45 b Fi(An)30 b(error)d(also)g(results)i(if)g(the)g
(transformation)f(b)r(et)n(w)n(een)h(the)g(curren)n(t)f(and)h(base)f(F)
--7 b(rames)28 b(of)h(the)g(Plot)427 3822 y(is)f(not)f(de\014ned)h
+-7 b(rames)28 b(of)h(the)g(Plot)427 1320 y(is)f(not)f(de\014ned)h
(\(i.e.)38 b(the)28 b(Plot's)e(T)-7 b(ranIn)n(v)n(erse)26
-b(attribute)h(is)h(zero\).)p 0 4018 3780 12 v 0 4150
+b(attribute)h(is)h(zero\).)p 0 1514 3780 12 v 0 1645
a Fz(astMask)p Fc(<)p Fz(X)p Fc(>)388 b Fe(Mask)39 b(a)g(region)e(of)h
(a)h(data)e(grid)387 b Fz(astMask)p Fc(<)p Fz(X)p Fc(>)0
-4341 y Fd(Description:)44 b Fi(This)34 b(is)f(a)g(set)g(of)g(functions)
+1833 y Fd(Description:)44 b Fi(This)34 b(is)f(a)g(set)g(of)g(functions)
h(for)e(masking)h(out)g(regions)f(within)i(gridded)e(data)h(\(e.g.)54
-b(an)33 b(image\).)227 4440 y(The)g(functions)h(mo)r(di\014es)f(a)f
+b(an)33 b(image\).)227 1933 y(The)g(functions)h(mo)r(di\014es)f(a)f
(giv)n(en)h(data)f(grid)h(b)n(y)f(assigning)g(a)g(sp)r(eci\014ed)i(v)-5
-b(alue)33 b(to)f(all)h(samples)g(whic)n(h)g(are)227 4540
+b(alue)33 b(to)f(all)h(samples)g(whic)n(h)g(are)227 2032
y(inside)28 b(\(or)f(outside)g(if)h Ft(")p Fi(inside)p
Ft(")f Fi(is)h(zero\))f(the)h(sp)r(eci\014ed)f(Region.)227
-4664 y(Y)-7 b(ou)21 b(should)g(use)f(a)h(masking)f(function)h(whic)n(h)
+2156 y(Y)-7 b(ou)21 b(should)g(use)f(a)h(masking)f(function)h(whic)n(h)
g(matc)n(hes)f(the)h(n)n(umerical)f(t)n(yp)r(e)h(of)g(the)g(data)f(y)n
-(ou)g(are)g(pro)r(cessing)227 4764 y(b)n(y)27 b(replacing)f
+(ou)g(are)g(pro)r(cessing)227 2255 y(b)n(y)27 b(replacing)f
Fk(<)p Fi(X)p Fk(>)h Fi(in)g(the)h(generic)e(function)h(name)g(astMask)
p Fk(<)p Fi(X)p Fk(>)f Fi(b)n(y)h(an)f(appropriate)g(1-)g(or)g(2-c)n
-(haracter)227 4863 y(t)n(yp)r(e)32 b(co)r(de.)50 b(F)-7
+(haracter)227 2355 y(t)n(yp)r(e)32 b(co)r(de.)50 b(F)-7
b(or)31 b(example,)i(if)f(y)n(ou)f(are)g(masking)g(data)g(with)i(t)n
(yp)r(e)f Ft(")p Fi(\015oat)p Ft(")p Fi(,)f(y)n(ou)g(should)h(use)g
-(the)g(function)227 4963 y(astMaskF)25 b(\(see)h(the)h
+(the)g(function)227 2454 y(astMaskF)25 b(\(see)h(the)h
Ft(")p Fi(Data)e(T)n(yp)r(e)h(Co)r(des)p Ft(")g Fi(section)f(b)r(elo)n
(w)h(for)g(the)g(co)r(des)g(appropriate)e(to)i(other)f(n)n(umerical)227
-5062 y(t)n(yp)r(es\).)0 5211 y Fd(Synopsis:)121 b Ft(int)42
+2554 y(t)n(yp)r(es\).)0 2701 y Fd(Synopsis:)121 b Ft(int)42
b(astMask)p Fk(<)p Ft(X)p Fk(>)p Ft(\()d(AstRegion)h
Fh(\003)p Ft(this,)h(AstMapping)f Fh(\003)p Ft(map,)h(int)h(inside,)f
-(int)h(ndim,)g(const)227 5310 y(int)h(lbnd[],)d(const)i(int)g(ubnd[],)f
+(int)h(ndim,)g(const)227 2800 y(int)h(lbnd[],)d(const)i(int)g(ubnd[],)f
Fk(<)p Ft(Xtype)p Fk(>)g Ft(in[],)g Fk(<)p Ft(Xtype)p
-Fk(>)g Ft(val)h(\))0 5458 y Fd(P)m(arameters:)259 5593
-y(this)427 5693 y Fi(P)n(oin)n(ter)26 b(to)i(a)f(Region.)p
-eop end
-%%Page: 288 298
-TeXDict begin 288 297 bop 0 52 a FF(288)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(map)427
-451 y Fi(P)n(oin)n(ter)g(to)h(a)g(Mapping.)47 b(The)31
-b(forw)n(ard)f(transformation)f(should)i(map)g(p)r(ositions)g(in)g(the)
-h(co)r(ordinate)427 551 y(system)g(of)h(the)g(supplied)f(Region)g(in)n
-(to)g(pixel)h(co)r(ordinates)e(as)h(de\014ned)g(b)n(y)h(the)f
-Ft(")p Fi(lbnd)p Ft(")h Fi(and)f Ft(")p Fi(ubnd)p Ft(")427
-650 y Fi(parameters.)i(A)24 b(NULL)g(p)r(oin)n(ter)f(can)g(b)r(e)h
-(supplied)g(if)g(the)g(co)r(ordinate)f(system)g(of)g(the)h(supplied)g
-(Region)427 750 y(corresp)r(onds)i(to)h(pixel)h(co)r(ordinates.)36
-b(This)27 b(is)h(equiv)-5 b(alen)n(t)27 b(to)g(supplying)h(a)f
-(UnitMap.)427 869 y(The)37 b(n)n(um)n(b)r(er)g(of)g(inputs)g(for)f
-(this)i(Mapping)e(\(as)h(giv)n(en)f(b)n(y)g(its)h(Nin)h(attribute\))f
-(should)g(matc)n(h)f(the)427 968 y(n)n(um)n(b)r(er)28
-b(of)f(axes)g(in)g(the)h(supplied)g(Region)f(\(as)g(giv)n(en)g(b)n(y)g
-(the)h(Naxes)f(attribute)h(of)f(the)h(Region\).)37 b(The)427
-1068 y(n)n(um)n(b)r(er)23 b(of)f(outputs)h(for)f(the)h(Mapping)f(\(as)g
-(giv)n(en)g(b)n(y)h(its)f(Nout)h(attribute\))g(should)g(matc)n(h)f(the)
-h(n)n(um)n(b)r(er)427 1167 y(of)28 b(grid)f(dimensions)g(giv)n(en)g(b)n
-(y)g(the)h(v)-5 b(alue)28 b(of)f Ft(")p Fi(ndim)p Ft(")g
-Fi(b)r(elo)n(w.)259 1305 y Fd(inside)427 1405 y Fi(A)c(b)r(o)r(olean)f
-(v)-5 b(alue)23 b(whic)n(h)g(indicates)f(whic)n(h)h(pixel)g(are)e(to)i
-(b)r(e)g(mask)n(ed.)34 b(If)24 b(a)e(non-zero)f(v)-5
-b(alue)23 b(is)f(supplied,)427 1504 y(then)32 b(all)g(grid)f(pixels)g
-(with)i(cen)n(tres)d(inside)i(the)g(supplied)g(Region)f(are)g(assigned)
-f(the)i(v)-5 b(alue)32 b(giv)n(en)f(b)n(y)427 1604 y
-Ft(")p Fi(v)-5 b(al)p Ft(")p Fi(,)33 b(and)f(all)h(other)f(pixels)g
-(are)g(left)h(unc)n(hanged.)51 b(If)33 b(zero)e(is)h(supplied,)j(then)e
-(all)f(grid)g(pixels)g(with)427 1704 y(cen)n(tres)g(not)h(inside)f(the)
-h(supplied)g(Region)f(are)g(assigned)f(the)i(v)-5 b(alue)32
-b(giv)n(en)g(b)n(y)h Ft(")p Fi(v)-5 b(al)p Ft(")p Fi(,)32
-b(and)h(all)f(other)427 1803 y(pixels)i(are)e(left)j(unc)n(hanged.)54
-b(Note,)35 b(the)f(Negated)f(attribute)h(of)f(the)h(Region)f(is)h(used)
-f(to)h(determine)427 1903 y(whic)n(h)26 b(pixel)g(are)e(inside)i(the)g
+Fk(>)g Ft(val)h(\))0 2947 y Fd(P)m(arameters:)259 3081
+y(this)427 3180 y Fi(P)n(oin)n(ter)26 b(to)i(a)f(Region.)259
+3310 y Fd(map)427 3410 y Fi(P)n(oin)n(ter)j(to)h(a)g(Mapping.)47
+b(The)31 b(forw)n(ard)f(transformation)f(should)i(map)g(p)r(ositions)g
+(in)g(the)h(co)r(ordinate)427 3510 y(system)g(of)h(the)g(supplied)f
+(Region)g(in)n(to)g(pixel)h(co)r(ordinates)e(as)h(de\014ned)g(b)n(y)h
+(the)f Ft(")p Fi(lbnd)p Ft(")h Fi(and)f Ft(")p Fi(ubnd)p
+Ft(")427 3609 y Fi(parameters.)i(A)24 b(NULL)g(p)r(oin)n(ter)f(can)g(b)
+r(e)h(supplied)g(if)g(the)g(co)r(ordinate)f(system)g(of)g(the)h
+(supplied)g(Region)427 3709 y(corresp)r(onds)i(to)h(pixel)h(co)r
+(ordinates.)36 b(This)27 b(is)h(equiv)-5 b(alen)n(t)27
+b(to)g(supplying)h(a)f(UnitMap.)427 3824 y(The)37 b(n)n(um)n(b)r(er)g
+(of)g(inputs)g(for)f(this)i(Mapping)e(\(as)h(giv)n(en)f(b)n(y)g(its)h
+(Nin)h(attribute\))f(should)g(matc)n(h)f(the)427 3923
+y(n)n(um)n(b)r(er)28 b(of)f(axes)g(in)g(the)h(supplied)g(Region)f(\(as)
+g(giv)n(en)g(b)n(y)g(the)h(Naxes)f(attribute)h(of)f(the)h(Region\).)37
+b(The)427 4023 y(n)n(um)n(b)r(er)23 b(of)f(outputs)h(for)f(the)h
+(Mapping)f(\(as)g(giv)n(en)g(b)n(y)h(its)f(Nout)h(attribute\))g(should)
+g(matc)n(h)f(the)h(n)n(um)n(b)r(er)427 4123 y(of)28 b(grid)f
+(dimensions)g(giv)n(en)g(b)n(y)g(the)h(v)-5 b(alue)28
+b(of)f Ft(")p Fi(ndim)p Ft(")g Fi(b)r(elo)n(w.)259 4253
+y Fd(inside)427 4352 y Fi(A)c(b)r(o)r(olean)f(v)-5 b(alue)23
+b(whic)n(h)g(indicates)f(whic)n(h)h(pixel)g(are)e(to)i(b)r(e)g(mask)n
+(ed.)34 b(If)24 b(a)e(non-zero)f(v)-5 b(alue)23 b(is)f(supplied,)427
+4452 y(then)32 b(all)g(grid)f(pixels)g(with)i(cen)n(tres)d(inside)i
+(the)g(supplied)g(Region)f(are)g(assigned)f(the)i(v)-5
+b(alue)32 b(giv)n(en)f(b)n(y)427 4551 y Ft(")p Fi(v)-5
+b(al)p Ft(")p Fi(,)33 b(and)f(all)h(other)f(pixels)g(are)g(left)h(unc)n
+(hanged.)51 b(If)33 b(zero)e(is)h(supplied,)j(then)e(all)f(grid)g
+(pixels)g(with)427 4651 y(cen)n(tres)g(not)h(inside)f(the)h(supplied)g
+(Region)f(are)g(assigned)f(the)i(v)-5 b(alue)32 b(giv)n(en)g(b)n(y)h
+Ft(")p Fi(v)-5 b(al)p Ft(")p Fi(,)32 b(and)h(all)f(other)427
+4751 y(pixels)i(are)e(left)j(unc)n(hanged.)54 b(Note,)35
+b(the)f(Negated)f(attribute)h(of)f(the)h(Region)f(is)h(used)f(to)h
+(determine)427 4850 y(whic)n(h)26 b(pixel)g(are)e(inside)i(the)g
(Region)f(and)h(whic)n(h)f(are)g(outside.)36 b(So)26
b(the)g(inside)g(of)f(a)g(Region)h(whic)n(h)f(has)427
-2003 y(not)j(b)r(een)g(negated)f(is)g(the)h(same)f(as)g(the)h(outside)g
+4950 y(not)j(b)r(een)g(negated)f(is)g(the)h(same)f(as)g(the)h(outside)g
(of)f(the)h(corresp)r(onding)e(negated)h(Region.)427
-2121 y(F)-7 b(or)31 b(t)n(yp)r(es)g(of)h(Region)e(suc)n(h)h(as)g(P)n
+5065 y(F)-7 b(or)31 b(t)n(yp)r(es)g(of)h(Region)e(suc)n(h)h(as)g(P)n
(oin)n(tList)g(whic)n(h)g(ha)n(v)n(e)f(zero)g(v)n(olume,)i(pixel)g(cen)
-n(tres)e(will)i(rarely)e(fall)427 2221 y(exactly)25 b(within)h(the)g
+n(tres)e(will)i(rarely)e(fall)427 5164 y(exactly)25 b(within)h(the)g
(Region.)36 b(F)-7 b(or)25 b(this)h(reason,)e(the)i(inclusion)f
(criterion)g(is)g(c)n(hanged)g(for)g(zero-v)n(olume)427
-2321 y(Regions)32 b(so)h(that)g(pixels)g(are)f(included)h(\(or)f
+5264 y(Regions)32 b(so)h(that)g(pixels)g(are)f(included)h(\(or)f
(excluded\))i(if)f(an)n(y)f(part)h(of)g(the)g(Region)g(passes)e
-(through)427 2420 y(the)f(pixel.)43 b(F)-7 b(or)29 b(a)g(P)n(oin)n
+(through)427 5364 y(the)f(pixel.)43 b(F)-7 b(or)29 b(a)g(P)n(oin)n
(tList,)g(this)h(means)g(that)f(pixels)h(are)e(included)i(\(or)f
-(excluded\))h(if)h(they)e(con)n(tain)427 2520 y(at)f(least)f(one)g(of)h
+(excluded\))h(if)h(they)e(con)n(tain)427 5463 y(at)f(least)f(one)g(of)h
(the)g(p)r(oin)n(ts)f(listed)h(in)g(the)g(P)n(oin)n(tList.)259
-2658 y Fd(ndim)427 2757 y Fi(The)g(n)n(um)n(b)r(er)f(of)h(dimensions)f
+5593 y Fd(ndim)427 5693 y Fi(The)g(n)n(um)n(b)r(er)f(of)h(dimensions)f
(in)h(the)g(input)g(grid.)36 b(This)28 b(should)f(b)r(e)h(at)g(least)f
-(one.)259 2895 y Fd(lbnd)427 2995 y Fi(P)n(oin)n(ter)19
+(one.)p eop end
+%%Page: 289 299
+TeXDict begin 289 298 bop 3643 52 a FF(289)259 351 y
+Fd(lbnd)427 451 y Fi(P)n(oin)n(ter)19 b(to)i(an)f(arra)n(y)f(of)h(in)n
+(tegers,)h(with)g Ft(")p Fi(ndim)p Ft(")g Fi(elemen)n(ts,)h(con)n
+(taining)d(the)i(co)r(ordinates)f(of)g(the)h(cen)n(tre)427
+551 y(of)28 b(the)g(\014rst)f(pixel)h(in)g(the)g(input)g(grid)f(along)f
+(eac)n(h)h(dimension.)259 673 y Fd(ubnd)427 772 y Fi(P)n(oin)n(ter)19
b(to)i(an)f(arra)n(y)f(of)h(in)n(tegers,)h(with)g Ft(")p
Fi(ndim)p Ft(")g Fi(elemen)n(ts,)h(con)n(taining)d(the)i(co)r
-(ordinates)f(of)g(the)h(cen)n(tre)427 3094 y(of)28 b(the)g(\014rst)f
-(pixel)h(in)g(the)g(input)g(grid)f(along)f(eac)n(h)h(dimension.)259
-3232 y Fd(ubnd)427 3332 y Fi(P)n(oin)n(ter)19 b(to)i(an)f(arra)n(y)f
-(of)h(in)n(tegers,)h(with)g Ft(")p Fi(ndim)p Ft(")g Fi(elemen)n(ts,)h
-(con)n(taining)d(the)i(co)r(ordinates)f(of)g(the)h(cen)n(tre)427
-3432 y(of)28 b(the)g(last)f(pixel)h(in)g(the)g(input)g(grid)f(along)f
-(eac)n(h)h(dimension.)427 3550 y(Note)f(that)h Ft(")p
-Fi(lbnd)p Ft(")f Fi(and)g Ft(")p Fi(ubnd)p Ft(")g Fi(together)f
-(de\014ne)h(the)h(shap)r(e)f(and)g(size)g(of)g(the)g(input)h(grid,)f
-(its)h(exten)n(t)427 3650 y(along)36 b(a)g(particular)f(\(j'th\))j
-(dimension)e(b)r(eing)g(ubnd[j]-lbnd[j]+1)i(\(assuming)d(the)i(index)g
-Ft(")p Fi(j)p Ft(")f Fi(to)g(b)r(e)427 3749 y(zero-based\).)69
+(ordinates)f(of)g(the)h(cen)n(tre)427 872 y(of)28 b(the)g(last)f(pixel)
+h(in)g(the)g(input)g(grid)f(along)f(eac)n(h)h(dimension.)427
+983 y(Note)f(that)h Ft(")p Fi(lbnd)p Ft(")f Fi(and)g
+Ft(")p Fi(ubnd)p Ft(")g Fi(together)f(de\014ne)h(the)h(shap)r(e)f(and)g
+(size)g(of)g(the)g(input)h(grid,)f(its)h(exten)n(t)427
+1082 y(along)36 b(a)g(particular)f(\(j'th\))j(dimension)e(b)r(eing)g
+(ubnd[j]-lbnd[j]+1)i(\(assuming)d(the)i(index)g Ft(")p
+Fi(j)p Ft(")f Fi(to)g(b)r(e)427 1182 y(zero-based\).)69
b(They)39 b(also)e(de\014ne)j(the)f(input)g(grid's)f(co)r(ordinate)g
-(system,)j(eac)n(h)d(pixel)h(ha)n(ving)f(unit)427 3849
+(system,)j(eac)n(h)d(pixel)h(ha)n(ving)f(unit)427 1282
y(exten)n(t)28 b(along)e(eac)n(h)h(dimension)h(with)g(in)n(tegral)e(co)
r(ordinate)h(v)-5 b(alues)27 b(at)g(its)h(cen)n(tre.)259
-3987 y Fd(in)427 4087 y Fi(P)n(oin)n(ter)j(to)i(an)f(arra)n(y)-7
+1404 y Fd(in)427 1503 y Fi(P)n(oin)n(ter)j(to)i(an)f(arra)n(y)-7
b(,)32 b(with)h(one)g(elemen)n(t)g(for)f(eac)n(h)g(pixel)g(in)h(the)g
-(input)h(grid,)f(con)n(taining)f(the)h(data)427 4186
+(input)h(grid,)f(con)n(taining)f(the)h(data)427 1603
y(to)k(b)r(e)f(mask)n(ed.)63 b(The)37 b(n)n(umerical)e(t)n(yp)r(e)i(of)
f(this)h(arra)n(y)d(should)i(matc)n(h)h(the)g(1-)e(or)h(2-c)n(haracter)
-d(t)n(yp)r(e)427 4286 y(co)r(de)28 b(app)r(ended)g(to)g(the)g(function)
+d(t)n(yp)r(e)427 1703 y(co)r(de)28 b(app)r(ended)g(to)g(the)g(function)
h(name)e(\(e.g.)38 b(if)28 b(y)n(ou)f(are)g(using)h(astMaskF,)f(the)h
-(t)n(yp)r(e)g(of)g(eac)n(h)f(arra)n(y)427 4385 y(elemen)n(t)h(should)f
-(b)r(e)h Ft(")p Fi(\015oat)p Ft(")p Fi(\).)427 4504 y(The)33
+(t)n(yp)r(e)g(of)g(eac)n(h)f(arra)n(y)427 1802 y(elemen)n(t)h(should)f
+(b)r(e)h Ft(")p Fi(\015oat)p Ft(")p Fi(\).)427 1913 y(The)33
b(storage)f(order)f(of)j(data)e(within)i(this)g(arra)n(y)c(should)j(b)r
(e)h(suc)n(h)f(that)g(the)h(index)f(of)g(the)g(\014rst)g(grid)427
-4604 y(dimension)23 b(v)-5 b(aries)22 b(most)h(rapidly)f(and)h(that)g
+2013 y(dimension)23 b(v)-5 b(aries)22 b(most)h(rapidly)f(and)h(that)g
(of)g(the)h(\014nal)f(dimension)g(least)f(rapidly)g(\(i.e.)36
-b(F)-7 b(ortran)22 b(arra)n(y)427 4703 y(indexing)28
-b(is)f(used\).)427 4822 y(On)e(exit,)g(the)h(samples)e(sp)r(eci\014ed)h
+b(F)-7 b(ortran)22 b(arra)n(y)427 2112 y(indexing)28
+b(is)f(used\).)427 2223 y(On)e(exit,)g(the)h(samples)e(sp)r(eci\014ed)h
(b)n(y)f Ft(")p Fi(inside)p Ft(")g Fi(are)g(set)h(to)f(the)i(v)-5
b(alue)24 b(of)h Ft(")p Fi(v)-5 b(al)p Ft(")p Fi(.)35
-b(All)25 b(other)f(samples)h(are)427 4922 y(left)k(unc)n(hanged.)259
-5060 y Fd(v)-5 b(al)427 5159 y Fi(This)29 b(argumen)n(t)f(should)h(ha)n
+b(All)25 b(other)f(samples)h(are)427 2323 y(left)k(unc)n(hanged.)259
+2445 y Fd(v)-5 b(al)427 2545 y Fi(This)29 b(argumen)n(t)f(should)h(ha)n
(v)n(e)e(the)j(same)e(t)n(yp)r(e)h(as)f(the)i(elemen)n(ts)e(of)h(the)g
Ft(")p Fi(in)p Ft(")g Fi(arra)n(y)-7 b(.)38 b(It)29 b(sp)r(eci\014es)g
-(the)427 5259 y(v)-5 b(alue)28 b(used)f(to)h(\015ag)f(the)h(mask)n(ed)e
-(data)h(\(see)h Ft(")p Fi(inside)p Ft(")p Fi(\).)0 5431
-y Fd(Returned)k(V)-8 b(alue:)259 5577 y(astMask)p Fk(<)p
-Fd(X)p Fk(>)p Fd(\(\))427 5677 y Fi(The)28 b(n)n(um)n(b)r(er)f(of)h
+(the)427 2644 y(v)-5 b(alue)28 b(used)f(to)h(\015ag)f(the)h(mask)n(ed)e
+(data)h(\(see)h Ft(")p Fi(inside)p Ft(")p Fi(\).)0 2795
+y Fd(Returned)k(V)-8 b(alue:)259 2921 y(astMask)p Fk(<)p
+Fd(X)p Fk(>)p Fd(\(\))427 3021 y Fi(The)28 b(n)n(um)n(b)r(er)f(of)h
(pixels)f(to)h(whic)n(h)f(a)g(v)-5 b(alue)28 b(of)f Ft(")p
-Fi(badv)-5 b(al)p Ft(")27 b Fi(has)g(b)r(een)h(assigned.)p
-eop end
-%%Page: 289 299
-TeXDict begin 289 298 bop 3643 52 a FF(289)0 351 y Fd(Notes:)340
-638 y Fh(\017)45 b Fi(A)27 b(v)-5 b(alue)25 b(of)h(zero)f(will)h(b)r(e)
-g(returned)g(if)g(this)g(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(the)
-f(global)f(error)f(status)h(set,)h(or)427 738 y(if)i(it)g(should)g
-(fail)f(for)h(an)n(y)e(reason.)340 872 y Fh(\017)45 b
-Fi(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)h(the)g(o)n(v)n
-(erlap)d(of)j(the)g(Region)f(and)g(the)h(arra)n(y)d(cannot)i(b)r(e)h
-(determined.)-2 1038 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s(des)n(:)227
-1185 y Fi(T)-7 b(o)26 b(select)g(the)g(appropriate)e(masking)h
-(function,)i(y)n(ou)e(should)h(replace)f Fk(<)p Fi(X)p
-Fk(>)h Fi(in)g(the)g(generic)f(function)i(name)227 1284
-y(astMask)p Fk(<)p Fi(X)p Fk(>)22 b Fi(with)i(a)f(1-)g(or)g(2-c)n
+Fi(badv)-5 b(al)p Ft(")27 b Fi(has)g(b)r(een)h(assigned.)0
+3172 y Fd(Notes:)340 3444 y Fh(\017)45 b Fi(A)27 b(v)-5
+b(alue)25 b(of)h(zero)f(will)h(b)r(e)g(returned)g(if)g(this)g(function)
+h(is)f(in)n(v)n(ok)n(ed)e(with)j(the)f(global)f(error)f(status)h(set,)h
+(or)427 3543 y(if)i(it)g(should)g(fail)f(for)h(an)n(y)e(reason.)340
+3666 y Fh(\017)45 b Fi(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)
+h(the)g(o)n(v)n(erlap)d(of)j(the)g(Region)f(and)g(the)h(arra)n(y)d
+(cannot)i(b)r(e)h(determined.)-2 3817 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s
+(des)n(:)227 3963 y Fi(T)-7 b(o)26 b(select)g(the)g(appropriate)e
+(masking)h(function,)i(y)n(ou)e(should)h(replace)f Fk(<)p
+Fi(X)p Fk(>)h Fi(in)g(the)g(generic)f(function)i(name)227
+4062 y(astMask)p Fk(<)p Fi(X)p Fk(>)22 b Fi(with)i(a)f(1-)g(or)g(2-c)n
(haracter)d(data)j(t)n(yp)r(e)h(co)r(de,)g(so)f(as)g(to)g(matc)n(h)h
(the)g(n)n(umerical)e(t)n(yp)r(e)i Fk(<)p Fi(Xt)n(yp)r(e)p
-Fk(>)227 1384 y Fi(of)k(the)g(data)f(y)n(ou)g(are)f(pro)r(cessing,)h
-(as)f(follo)n(ws:)340 1524 y Fh(\017)45 b Fi(D:)28 b(double)340
-1659 y Fh(\017)45 b Fi(F:)28 b(\015oat)340 1794 y Fh(\017)45
-b Fi(L:)28 b(long)f(in)n(t)340 1929 y Fh(\017)45 b Fi(UL:)28
-b(unsigned)g(long)e(in)n(t)340 2064 y Fh(\017)45 b Fi(I:)28
-b(in)n(t)340 2199 y Fh(\017)45 b Fi(UI:)28 b(unsigned)g(in)n(t)340
-2334 y Fh(\017)45 b Fi(S:)28 b(short)f(in)n(t)340 2469
+Fk(>)227 4162 y Fi(of)k(the)g(data)f(y)n(ou)g(are)f(pro)r(cessing,)h
+(as)f(follo)n(ws:)340 4288 y Fh(\017)45 b Fi(D:)28 b(double)340
+4410 y Fh(\017)45 b Fi(F:)28 b(\015oat)340 4532 y Fh(\017)45
+b Fi(L:)28 b(long)f(in)n(t)340 4654 y Fh(\017)45 b Fi(UL:)28
+b(unsigned)g(long)e(in)n(t)340 4776 y Fh(\017)45 b Fi(I:)28
+b(in)n(t)340 4898 y Fh(\017)45 b Fi(UI:)28 b(unsigned)g(in)n(t)340
+5021 y Fh(\017)45 b Fi(S:)28 b(short)f(in)n(t)340 5143
y Fh(\017)45 b Fi(US:)28 b(unsigned)g(short)f(in)n(t)340
-2603 y Fh(\017)45 b Fi(B:)28 b(b)n(yte)f(\(signed)h(c)n(har\))340
-2738 y Fh(\017)45 b Fi(UB:)28 b(unsigned)f(b)n(yte)h(\(unsigned)g(c)n
-(har\))227 2904 y(F)-7 b(or)31 b(example,)h(astMaskD)e(w)n(ould)h(b)r
+5265 y Fh(\017)45 b Fi(B:)28 b(b)n(yte)f(\(signed)h(c)n(har\))340
+5387 y Fh(\017)45 b Fi(UB:)28 b(unsigned)f(b)n(yte)h(\(unsigned)g(c)n
+(har\))227 5538 y(F)-7 b(or)31 b(example,)h(astMaskD)e(w)n(ould)h(b)r
(e)g(used)h(to)f(pro)r(cess)f Ft(")p Fi(double)p Ft(")g
Fi(data,)i(while)f(astMaskS)f(w)n(ould)h(b)r(e)h(used)227
-3004 y(to)c(pro)r(cess)e Ft(")p Fi(short)h(in)n(t)p Ft(")g
-Fi(data,)g(etc.)p 0 3207 3780 12 v 0 3339 a Fz(astMatc)l(hAxes)254
-b Fe(Find)39 b(an)m(y)f(corresp)s(onding)f(axes)h(in)1596
-3452 y(t)m(w)m(o)f(F)-10 b(rames)2946 3339 y Fz(astMatc)l(hAxes)0
-3622 y Fd(Description:)44 b Fi(This)c(function)h(lo)r(oks)e(for)g
-(corresp)r(onding)f(axes)h(within)i(t)n(w)n(o)e(supplied)h(F)-7
-b(rames.)74 b(An)40 b(arra)n(y)e(of)227 3722 y(in)n(tegers)f(is)i
-(returned)f(that)g(con)n(tains)g(an)g(elemen)n(t)g(for)g(eac)n(h)f
-(axis)h(in)g(the)h(second)f(supplied)h(F)-7 b(rame.)68
-b(An)227 3821 y(elemen)n(t)36 b(in)h(this)f(arra)n(y)d(will)j(b)r(e)h
-(set)f(to)g(zero)e(if)j(the)f(asso)r(ciated)f(axis)g(within)h(the)h
-(second)e(F)-7 b(rame)36 b(has)f(no)227 3921 y(corresp)r(onding)j(axis)
-h(within)i(the)f(\014rst)g(F)-7 b(rame.)73 b(Otherwise,)43
+5638 y(to)c(pro)r(cess)e Ft(")p Fi(short)h(in)n(t)p Ft(")g
+Fi(data,)g(etc.)p eop end
+%%Page: 290 300
+TeXDict begin 290 299 bop 0 52 a FF(290)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 483 a Fz(astMatc)l(hAxes)254 b Fe(Find)39 b(an)m(y)f(corresp)s
+(onding)f(axes)h(in)1596 596 y(t)m(w)m(o)f(F)-10 b(rames)2946
+483 y Fz(astMatc)l(hAxes)0 762 y Fd(Description:)44 b
+Fi(This)c(function)h(lo)r(oks)e(for)g(corresp)r(onding)f(axes)h(within)
+i(t)n(w)n(o)e(supplied)h(F)-7 b(rames.)74 b(An)40 b(arra)n(y)e(of)227
+861 y(in)n(tegers)f(is)i(returned)f(that)g(con)n(tains)g(an)g(elemen)n
+(t)g(for)g(eac)n(h)f(axis)h(in)g(the)h(second)f(supplied)h(F)-7
+b(rame.)68 b(An)227 961 y(elemen)n(t)36 b(in)h(this)f(arra)n(y)d(will)j
+(b)r(e)h(set)f(to)g(zero)e(if)j(the)f(asso)r(ciated)f(axis)g(within)h
+(the)h(second)e(F)-7 b(rame)36 b(has)f(no)227 1061 y(corresp)r(onding)j
+(axis)h(within)i(the)f(\014rst)g(F)-7 b(rame.)73 b(Otherwise,)43
b(it)d(will)g(b)r(e)g(set)g(to)g(the)g(index)g(\(a)g(non-zero)227
-4020 y(p)r(ositiv)n(e)27 b(in)n(teger\))g(of)h(the)g(corresp)r(onding)e
+1160 y(p)r(ositiv)n(e)27 b(in)n(teger\))g(of)h(the)g(corresp)r(onding)e
(axis)g(within)j(the)f(\014rst)f(supplied)h(F)-7 b(rame.)0
-4174 y Fd(Synopsis:)121 b Ft(void)42 b(astMatchAxes\()c(AstFrame)i
+1310 y Fd(Synopsis:)121 b Ft(void)42 b(astMatchAxes\()c(AstFrame)i
Fh(\003)p Ft(frm1,)h(AstFrame)g Fh(\003)p Ft(frm2,)g(int)h
-Fh(\003)p Ft(axes)f(\))0 4328 y Fd(P)m(arameters:)259
-4468 y(frm1)427 4568 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f(F)-7
-b(rame.)259 4703 y Fd(frm2)427 4802 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(second)f(F)-7 b(rame.)259 4937 y Fd(axes)427
-5037 y Fi(P)n(oin)n(ter)24 b(to)h(an)g(in)n(teger)g(arra)n(y)e(in)i
+Fh(\003)p Ft(axes)f(\))0 1459 y Fd(P)m(arameters:)259
+1596 y(frm1)427 1695 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f(F)-7
+b(rame.)259 1828 y Fd(frm2)427 1928 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(second)f(F)-7 b(rame.)259 2061 y Fd(axes)427
+2160 y Fi(P)n(oin)n(ter)24 b(to)h(an)g(in)n(teger)g(arra)n(y)e(in)i
(whic)n(h)g(to)h(return)e(the)i(indices)f(of)h(the)f(axes)g(\(within)h
-(the)g(\014rst)f(F)-7 b(rame\))427 5136 y(that)38 b(corresp)r(ond)f(to)
+(the)g(\014rst)f(F)-7 b(rame\))427 2260 y(that)38 b(corresp)r(ond)f(to)
g(eac)n(h)g(axis)g(within)i(the)f(second)f(F)-7 b(rame.)68
b(Axis)37 b(indices)h(start)g(at)f(1.)68 b(A)38 b(v)-5
-b(alue)427 5236 y(of)34 b(zero)e(will)i(b)r(e)g(stored)f(in)h(the)f
+b(alue)427 2359 y(of)34 b(zero)e(will)i(b)r(e)g(stored)f(in)h(the)f
(returned)h(arra)n(y)d(for)i(eac)n(h)g(axis)f(in)i(the)g(second)f(F)-7
-b(rame)33 b(that)h(has)f(no)427 5336 y(corresp)r(onding)26
-b(axis)h(in)h(the)g(\014rst)f(F)-7 b(rame.)427 5453 y(The)26
+b(rame)33 b(that)h(has)f(no)427 2459 y(corresp)r(onding)26
+b(axis)h(in)h(the)g(\014rst)f(F)-7 b(rame.)427 2575 y(The)26
b(n)n(um)n(b)r(er)f(of)g(elemen)n(ts)h(in)f(this)h(arra)n(y)d(m)n(ust)j
(b)r(e)g(greater)d(than)j(or)e(equal)h(to)g(the)h(n)n(um)n(b)r(er)f(of)
-h(axes)e(in)427 5552 y(the)k(second)f(F)-7 b(rame.)0
-5718 y Fd(Class)31 b(Applicabilit)m(y:)p eop end
-%%Page: 290 300
-TeXDict begin 290 299 bop 0 52 a FF(290)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(F)-8
-b(rame)427 451 y Fi(This)28 b(function)g(applies)f(to)h(all)f(F)-7
-b(rames.)0 608 y Fd(Notes:)340 887 y Fh(\017)45 b Fi(Corresp)r(onding)
-32 b(axes)h(are)g(iden)n(ti\014ed)i(b)n(y)f(the)g(fact)g(that)g(a)g
-(Mapping)g(can)f(b)r(e)i(found)f(b)r(et)n(w)n(een)g(them)427
-986 y(using)25 b(astFindF)-7 b(rame)25 b(or)g(astCon)n(v)n(ert.)34
+h(axes)e(in)427 2675 y(the)k(second)f(F)-7 b(rame.)0
+2837 y Fd(Class)31 b(Applicabilit)m(y:)259 2973 y(F)-8
+b(rame)427 3073 y Fi(This)28 b(function)g(applies)f(to)h(all)f(F)-7
+b(rames.)0 3235 y Fd(Notes:)340 3517 y Fh(\017)45 b Fi(Corresp)r
+(onding)32 b(axes)h(are)g(iden)n(ti\014ed)i(b)n(y)f(the)g(fact)g(that)g
+(a)g(Mapping)g(can)f(b)r(e)i(found)f(b)r(et)n(w)n(een)g(them)427
+3617 y(using)25 b(astFindF)-7 b(rame)25 b(or)g(astCon)n(v)n(ert.)34
b(Th)n(us,)26 b Ft(")p Fi(corresp)r(onding)d(axes)p Ft(")h
-Fi(are)g(not)i(necessarily)e(iden)n(tical.)427 1086 y(F)-7
+Fi(are)g(not)i(necessarily)e(iden)n(tical.)427 3717 y(F)-7
b(or)24 b(instance,)g(SkyF)-7 b(rame)23 b(axes)g(in)h(t)n(w)n(o)f(F)-7
b(rames)23 b(will)h(matc)n(h)g(ev)n(en)f(if)i(they)f(describ)r(e)f
-(di\013eren)n(t)h(celestial)427 1185 y(co)r(ordinate)j(systems)p
-0 1376 3780 12 v 0 1508 a Fz(astMathMap)641 b Fe(Create)37
-b(a)i(MathMap)639 b Fz(astMathMap)0 1688 y Fd(Description:)44
-b Fi(This)28 b(function)g(creates)f(a)g(new)g(MathMap)h(and)f
-(optionally)g(initialises)g(its)h(attributes.)227 1810
-y(A)f(MathMap)f(is)h(a)f(Mapping)g(whic)n(h)h(allo)n(ws)e(y)n(ou)h(to)g
-(sp)r(ecify)h(a)f(set)g(of)h(forw)n(ard)e(and/or)g(in)n(v)n(erse)g
-(transforma-)227 1910 y(tion)33 b(functions)g(using)f(arithmetic)h(op)r
-(erations)e(and)h(mathematical)g(functions)h(similar)f(to)h(those)f(a)n
-(v)-5 b(ailable)227 2009 y(in)28 b(C.)g(The)f(MathMap)g(in)n(terprets)g
+(di\013eren)n(t)h(celestial)427 3816 y(co)r(ordinate)j(systems)p
+0 4016 V 0 4147 a Fz(astMathMap)641 b Fe(Create)37 b(a)i(MathMap)639
+b Fz(astMathMap)0 4336 y Fd(Description:)44 b Fi(This)28
+b(function)g(creates)f(a)g(new)g(MathMap)h(and)f(optionally)g
+(initialises)g(its)h(attributes.)227 4461 y(A)f(MathMap)f(is)h(a)f
+(Mapping)g(whic)n(h)h(allo)n(ws)e(y)n(ou)h(to)g(sp)r(ecify)h(a)f(set)g
+(of)h(forw)n(ard)e(and/or)g(in)n(v)n(erse)g(transforma-)227
+4560 y(tion)33 b(functions)g(using)f(arithmetic)h(op)r(erations)e(and)h
+(mathematical)g(functions)h(similar)f(to)h(those)f(a)n(v)-5
+b(ailable)227 4660 y(in)28 b(C.)g(The)f(MathMap)g(in)n(terprets)g
(these)h(functions)f(at)h(run-time,)f(whenev)n(er)g(its)g(forw)n(ard)f
-(or)h(in)n(v)n(erse)f(trans-)227 2109 y(formation)38
+(or)h(in)n(v)n(erse)f(trans-)227 4760 y(formation)38
b(is)h(required.)68 b(Because)38 b(the)h(functions)g(are)e(not)i
(compiled)g(in)f(the)h(normal)f(sense)g(\(unlik)n(e)h(an)227
-2209 y(In)n(traMap\),)32 b(they)g(ma)n(y)f(b)r(e)h(used)g(to)f(describ)
+4859 y(In)n(traMap\),)32 b(they)g(ma)n(y)f(b)r(e)h(used)g(to)f(describ)
r(e)g(co)r(ordinate)g(transformations)f(in)i(a)f(transp)r(ortable)f
-(manner.)227 2308 y(A)25 b(MathMap)g(therefore)f(pro)n(vides)f(a)i
+(manner.)227 4959 y(A)25 b(MathMap)g(therefore)f(pro)n(vides)f(a)i
(\015exible)f(w)n(a)n(y)g(of)h(de\014ning)g(new)f(t)n(yp)r(es)h(of)g
-(Mapping)f(whose)g(descriptions)227 2408 y(ma)n(y)j(b)r(e)h(stored)f
+(Mapping)f(whose)g(descriptions)227 5058 y(ma)n(y)j(b)r(e)h(stored)f
(as)g(part)g(of)h(a)f(dataset)g(and)g(in)n(terpreted)g(b)n(y)h(other)f
-(programs.)0 2553 y Fd(Synopsis:)121 b Ft(AstMathMap)39
+(programs.)0 5208 y Fd(Synopsis:)121 b Ft(AstMathMap)39
b Fh(\003)p Ft(astMathMap\()g(int)j(nin,)g(int)g(nout,)g(int)g(nfwd,)g
(const)f(char)h Fh(\003)p Ft(fwd[],)f(int)h(ninv,)227
-2653 y(const)g(char)g Fh(\003)p Ft(inv[],)e(const)i(char)g
-Fh(\003)p Ft(options,)e(...)86 b(\))0 2798 y Fd(P)m(arameters:)259
-2930 y(nin)427 3029 y Fi(Num)n(b)r(er)28 b(of)f(input)i(v)-5
+5307 y(const)g(char)g Fh(\003)p Ft(inv[],)e(const)i(char)g
+Fh(\003)p Ft(options,)e(...)86 b(\))0 5457 y Fd(P)m(arameters:)259
+5593 y(nin)427 5693 y Fi(Num)n(b)r(er)28 b(of)f(input)i(v)-5
b(ariables)26 b(for)h(the)h(MathMap.)36 b(This)28 b(determines)f(the)h
-(v)-5 b(alue)27 b(of)h(its)f(Nin)h(attribute.)259 3158
-y Fd(nout)427 3257 y Fi(Num)n(b)r(er)20 b(of)g(output)h(v)-5
+(v)-5 b(alue)27 b(of)h(its)f(Nin)h(attribute.)p eop end
+%%Page: 291 301
+TeXDict begin 291 300 bop 3643 52 a FF(291)259 351 y
+Fd(nout)427 451 y Fi(Num)n(b)r(er)20 b(of)g(output)h(v)-5
b(ariables)18 b(for)h(the)i(MathMap.)34 b(This)20 b(determines)f(the)i
-(v)-5 b(alue)19 b(of)h(its)g(Nout)g(attribute.)259 3386
-y Fd(nfwd)427 3485 y Fi(The)26 b(n)n(um)n(b)r(er)f(of)h(forw)n(ard)e
+(v)-5 b(alue)19 b(of)h(its)g(Nout)g(attribute.)259 586
+y Fd(nfwd)427 686 y Fi(The)26 b(n)n(um)n(b)r(er)f(of)h(forw)n(ard)e
(transformation)g(functions)i(b)r(eing)g(supplied.)37
b(This)25 b(m)n(ust)h(b)r(e)g(at)g(least)f(equal)427
-3585 y(to)35 b Ft(")p Fi(nout)p Ft(")p Fi(,)g(but)g(ma)n(y)f(b)r(e)h
+785 y(to)35 b Ft(")p Fi(nout)p Ft(")p Fi(,)g(but)g(ma)n(y)f(b)r(e)h
(increased)f(to)g(accommo)r(date)f(an)n(y)h(additional)g(expressions)f
-(whic)n(h)h(de\014ne)427 3685 y(in)n(termediate)23 b(v)-5
+(whic)n(h)h(de\014ne)427 885 y(in)n(termediate)23 b(v)-5
b(ariables)21 b(for)i(the)g(forw)n(ard)e(transformation)g(\(see)i(the)g
Ft(")p Fi(Calculating)f(In)n(termediate)g(V)-7 b(al-)427
-3784 y(ues)p Ft(")27 b Fi(section)h(b)r(elo)n(w\).)259
-3913 y Fd(fwd)427 4012 y Fi(An)36 b(arra)n(y)c(\(with)k
+984 y(ues)p Ft(")27 b Fi(section)h(b)r(elo)n(w\).)259
+1120 y Fd(fwd)427 1219 y Fi(An)36 b(arra)n(y)c(\(with)k
Ft(")p Fi(nfwd)p Ft(")f Fi(elemen)n(ts\))g(of)g(p)r(oin)n(ters)f(to)h
(n)n(ull)g(terminated)g(strings)f(whic)n(h)h(con)n(tain)f(the)427
-4112 y(expressions)22 b(de\014ning)i(the)g(forw)n(ard)e
+1319 y(expressions)22 b(de\014ning)i(the)g(forw)n(ard)e
(transformation.)34 b(The)24 b(syn)n(tax)f(of)g(these)h(expressions)e
-(is)i(describ)r(ed)427 4212 y(b)r(elo)n(w.)259 4340 y
-Fd(nin)m(v)427 4440 y Fi(The)k(n)n(um)n(b)r(er)g(of)g(in)n(v)n(erse)f
+(is)i(describ)r(ed)427 1418 y(b)r(elo)n(w.)259 1554 y
+Fd(nin)m(v)427 1653 y Fi(The)k(n)n(um)n(b)r(er)g(of)g(in)n(v)n(erse)f
(transformation)f(functions)i(b)r(eing)h(supplied.)38
b(This)28 b(m)n(ust)g(b)r(e)h(at)f(least)f(equal)427
-4539 y(to)21 b Ft(")p Fi(nin)p Ft(")p Fi(,)h(but)f(ma)n(y)f(b)r(e)h
+1753 y(to)21 b Ft(")p Fi(nin)p Ft(")p Fi(,)h(but)f(ma)n(y)f(b)r(e)h
(increased)e(to)i(accommo)r(date)f(an)n(y)g(additional)g(expressions)f
-(whic)n(h)h(de\014ne)h(in)n(ter-)427 4639 y(mediate)30
+(whic)n(h)h(de\014ne)h(in)n(ter-)427 1852 y(mediate)30
b(v)-5 b(ariables)28 b(for)h(the)h(in)n(v)n(erse)e(transformation)g
(\(see)h(the)h Ft(")p Fi(Calculating)e(In)n(termediate)h(V)-7
-b(alues)p Ft(")427 4739 y Fi(section)27 b(b)r(elo)n(w\).)259
-4867 y Fd(in)m(v)427 4967 y Fi(An)37 b(arra)n(y)d(\(with)k
+b(alues)p Ft(")427 1952 y Fi(section)27 b(b)r(elo)n(w\).)259
+2087 y Fd(in)m(v)427 2187 y Fi(An)37 b(arra)n(y)d(\(with)k
Ft(")p Fi(nin)n(v)p Ft(")d Fi(elemen)n(ts\))i(of)g(p)r(oin)n(ters)f(to)
g(n)n(ull)h(terminated)f(strings)g(whic)n(h)g(con)n(tain)g(the)427
-5066 y(expressions)25 b(de\014ning)i(the)g(in)n(v)n(erse)e
+2286 y(expressions)25 b(de\014ning)i(the)g(in)n(v)n(erse)e
(transformation.)35 b(The)27 b(syn)n(tax)e(of)i(these)f(expressions)f
-(is)i(describ)r(ed)427 5166 y(b)r(elo)n(w.)259 5295 y
-Fd(options)427 5394 y Fi(P)n(oin)n(ter)g(to)h(a)g(n)n(ull-terminated)g
+(is)i(describ)r(ed)427 2386 y(b)r(elo)n(w.)259 2521 y
+Fd(options)427 2621 y Fi(P)n(oin)n(ter)g(to)h(a)g(n)n(ull-terminated)g
(string)f(con)n(taining)g(an)h(optional)g(comma-separated)e(list)i(of)g
-(attribute)427 5494 y(assignmen)n(ts)21 b(to)h(b)r(e)h(used)f(for)g
+(attribute)427 2720 y(assignmen)n(ts)21 b(to)h(b)r(e)h(used)f(for)g
(initialising)g(the)h(new)f(MathMap.)35 b(The)22 b(syn)n(tax)g(used)g
-(is)g(iden)n(tical)g(to)g(that)427 5593 y(for)k(the)h(astSet)g
+(is)g(iden)n(tical)g(to)g(that)427 2820 y(for)k(the)h(astSet)g
(function)g(and)g(ma)n(y)f(include)h Ft(")p Fi(prin)n(tf)p
Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n(ti\014ed)h(b)n(y)f
-Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427 5693 y(in)i(the)g(normal)f
+Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427 2920 y(in)i(the)g(normal)f
(w)n(a)n(y)-7 b(.)35 b(If)28 b(no)g(initialisation)f(is)g(required,)g
-(a)g(zero-length)f(string)h(ma)n(y)g(b)r(e)h(supplied.)p
-eop end
-%%Page: 291 301
-TeXDict begin 291 300 bop 3643 52 a FF(291)259 351 y
-Fd(...)427 451 y Fi(If)38 b(the)g Ft(")p Fi(options)p
+(a)g(zero-length)f(string)h(ma)n(y)g(b)r(e)h(supplied.)259
+3055 y Fd(...)427 3154 y Fi(If)38 b(the)g Ft(")p Fi(options)p
Ft(")e Fi(string)h(con)n(tains)f Ft(")p Fi(\045)p Ft(")h
Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g(list)h(of)f
-(additional)427 551 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
+(additional)427 3254 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
(order)e(to)h(supply)h(v)-5 b(alues)27 b(to)g(b)r(e)h(substituted)h
-(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 650 y(rules)25
+(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 3353 y(rules)25
b(for)f(supplying)h(these)g(are)f(iden)n(tical)h(to)g(those)g(for)f
(the)h(astSet)g(function)h(\(and)f(for)g(the)g(C)g Ft(")p
-Fi(prin)n(tf)p Ft(")427 750 y Fi(function\).)0 923 y
-Fd(Returned)32 b(V)-8 b(alue:)259 1071 y(astMathMap\(\))427
-1171 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(MathMap.)0
-1344 y Fd(Notes:)340 1638 y Fh(\017)45 b Fi(The)e(sequence)f(of)h(n)n
+Fi(prin)n(tf)p Ft(")427 3453 y Fi(function\).)0 3619
+y Fd(Returned)32 b(V)-8 b(alue:)259 3760 y(astMathMap\(\))427
+3860 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(MathMap.)0
+4026 y Fd(Notes:)340 4313 y Fh(\017)45 b Fi(The)e(sequence)f(of)h(n)n
(um)n(b)r(ers)f(pro)r(duced)g(b)n(y)h(the)g(random)f(n)n(um)n(b)r(er)g
-(functions)h(a)n(v)-5 b(ailable)42 b(within)h(a)427 1737
+(functions)h(a)n(v)-5 b(ailable)42 b(within)h(a)427 4413
y(MathMap)c(is)h(normally)e(unpredictable)h(and)g(di\013eren)n(t)h(for)
f(eac)n(h)f(MathMap.)72 b(Ho)n(w)n(ev)n(er,)41 b(this)f(b)r(e-)427
-1837 y(ha)n(viour)26 b(ma)n(y)h(b)r(e)h(con)n(trolled)f(b)n(y)g(means)g
-(of)h(the)g(MathMap's)f(Seed)g(attribute.)340 1976 y
+4513 y(ha)n(viour)26 b(ma)n(y)h(b)r(e)h(con)n(trolled)f(b)n(y)g(means)g
+(of)h(the)g(MathMap's)f(Seed)g(attribute.)340 4648 y
Fh(\017)45 b Fi(Normally)-7 b(,)28 b(comp)r(ound)g(Mappings)f
(\(CmpMaps\))i(whic)n(h)f(in)n(v)n(olv)n(e)f(MathMaps)g(will)i(not)f(b)
-r(e)g(sub)5 b(ject)29 b(to)427 2075 y(simpli\014cation)34
+r(e)g(sub)5 b(ject)29 b(to)427 4747 y(simpli\014cation)34
b(\(e.g.)56 b(using)34 b(astSimplify\))h(b)r(ecause)e(AST)i(cannot)e
-(kno)n(w)g(ho)n(w)h(di\013eren)n(t)g(MathMaps)427 2175
+(kno)n(w)g(ho)n(w)h(di\013eren)n(t)g(MathMaps)427 4847
y(will)f(in)n(teract.)52 b(Ho)n(w)n(ev)n(er,)32 b(in)h(the)h(sp)r
(ecial)e(case)g(where)g(a)h(MathMap)f(o)r(ccurs)g(in)h(series)f(with)h
-(its)g(o)n(wn)427 2274 y(in)n(v)n(erse,)21 b(then)h(simpli\014cation)g
+(its)g(o)n(wn)427 4947 y(in)n(v)n(erse,)21 b(then)h(simpli\014cation)g
(ma)n(y)e(b)r(e)i(p)r(ossible.)34 b(Whether)22 b(simpli\014cation)f(do)
-r(es,)i(in)e(fact,)i(o)r(ccur)e(under)427 2374 y(these)28
+r(es,)i(in)e(fact,)i(o)r(ccur)e(under)427 5046 y(these)28
b(circumstances)e(is)i(con)n(trolled)e(b)n(y)i(the)g(MathMap's)f
-(SimpFI)h(and)g(SimpIF)g(attributes.)340 2513 y Fh(\017)45
+(SimpFI)h(and)g(SimpIF)g(attributes.)340 5181 y Fh(\017)45
b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
-(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 2612 y(AST)28
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 5281 y(AST)28
b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)-2 2786 y Fd(De\014ning)32 b(T)-8 b(ransformation)32
-b(F)-8 b(unctions)n(:)227 2932 y Fi(A)24 b(MathMap's)g(transformation)e
+(reason.)-2 5447 y Fd(De\014ning)32 b(T)-8 b(ransformation)32
+b(F)-8 b(unctions)n(:)227 5593 y Fi(A)24 b(MathMap's)g(transformation)e
(functions)i(are)e(supplied)j(as)e(a)g(set)h(of)f(expressions)f(in)i
-(an)g(arra)n(y)d(of)j(c)n(haracter)227 3031 y(strings.)34
+(an)g(arra)n(y)d(of)j(c)n(haracter)227 5693 y(strings.)34
b(Normally)19 b(y)n(ou)g(w)n(ould)g(supply)h(the)g(same)g(n)n(um)n(b)r
-(er)f(of)h(expressions)e(for)i(the)g(forw)n(ard)e(transformation,)227
-3131 y(via)27 b(the)h Ft(")p Fi(fwd)p Ft(")f Fi(parameter,)f(as)h
-(there)g(are)g(output)h(v)-5 b(ariables)26 b(\(giv)n(en)h(b)n(y)g(the)h
-(MathMap's)f(Nout)h(attribute\).)227 3231 y(F)-7 b(or)27
-b(instance,)h(if)g(Nout)g(is)f(2)g(y)n(ou)g(migh)n(t)h(use:)340
-3378 y Fh(\017)45 b Ft(")p Fi(r)27 b(=)g(sqrt\()h(x)f
-Fh(\003)g Fi(x)h(+)f(y)h Fh(\003)f Fi(y)g(\))p Ft(")340
-3517 y Fh(\017)45 b Ft(")p Fi(theta)28 b(=)f(atan2\()g(y)-7
-b(,)27 b(x)h(\))p Ft(")227 3690 y Fi(whic)n(h)21 b(de\014nes)f(a)g
-(transformation)f(from)h(Cartesian)f(to)i(p)r(olar)e(co)r(ordinates.)33
-b(Here,)22 b(the)f(v)-5 b(ariables)19 b(that)i(app)r(ear)227
-3790 y(on)28 b(the)g(left)g(of)g(eac)n(h)f(expression)f(\()p
-Ft(")p Fi(r)p Ft(")h Fi(and)h Ft(")p Fi(theta)p Ft(")p
-Fi(\))f(pro)n(vide)g(names)g(for)g(the)i(output)f(v)-5
-b(ariables)26 b(and)i(those)227 3889 y(that)g(app)r(ear)f(on)g(the)h
-(righ)n(t)f(\()p Ft(")p Fi(x)p Ft(")g Fi(and)g Ft(")p
-Fi(y)p Ft(")p Fi(\))g(are)g(references)f(to)i(input)g(v)-5
-b(ariables.)227 4020 y(T)e(o)25 b(complemen)n(t)g(this,)h(y)n(ou)e(m)n
+(er)f(of)h(expressions)e(for)i(the)g(forw)n(ard)e(transformation,)p
+eop end
+%%Page: 292 302
+TeXDict begin 292 301 bop 0 52 a FF(292)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)227 351 y Fi(via)d(the)h
+Ft(")p Fi(fwd)p Ft(")f Fi(parameter,)f(as)h(there)g(are)g(output)h(v)-5
+b(ariables)26 b(\(giv)n(en)h(b)n(y)g(the)h(MathMap's)f(Nout)h
+(attribute\).)227 451 y(F)-7 b(or)27 b(instance,)h(if)g(Nout)g(is)f(2)g
+(y)n(ou)g(migh)n(t)h(use:)340 613 y Fh(\017)45 b Ft(")p
+Fi(r)27 b(=)g(sqrt\()h(x)f Fh(\003)g Fi(x)h(+)f(y)h Fh(\003)f
+Fi(y)g(\))p Ft(")340 758 y Fh(\017)45 b Ft(")p Fi(theta)28
+b(=)f(atan2\()g(y)-7 b(,)27 b(x)h(\))p Ft(")227 946 y
+Fi(whic)n(h)21 b(de\014nes)f(a)g(transformation)f(from)h(Cartesian)f
+(to)i(p)r(olar)e(co)r(ordinates.)33 b(Here,)22 b(the)f(v)-5
+b(ariables)19 b(that)i(app)r(ear)227 1046 y(on)28 b(the)g(left)g(of)g
+(eac)n(h)f(expression)f(\()p Ft(")p Fi(r)p Ft(")h Fi(and)h
+Ft(")p Fi(theta)p Ft(")p Fi(\))f(pro)n(vide)g(names)g(for)g(the)i
+(output)f(v)-5 b(ariables)26 b(and)i(those)227 1145 y(that)g(app)r(ear)
+f(on)g(the)h(righ)n(t)f(\()p Ft(")p Fi(x)p Ft(")g Fi(and)g
+Ft(")p Fi(y)p Ft(")p Fi(\))g(are)g(references)f(to)i(input)g(v)-5
+b(ariables.)227 1282 y(T)e(o)25 b(complemen)n(t)g(this,)h(y)n(ou)e(m)n
(ust)i(also)e(supply)h(expressions)e(for)i(the)g(in)n(v)n(erse)f
(transformation)g(via)g(the)i Ft(")p Fi(in)n(v)p Ft(")227
-4119 y Fi(parameter.)57 b(In)35 b(this)g(case,)g(the)g(n)n(um)n(b)r(er)
+1382 y Fi(parameter.)57 b(In)35 b(this)g(case,)g(the)g(n)n(um)n(b)r(er)
g(of)f(expressions)f(giv)n(en)h(w)n(ould)g(normally)g(matc)n(h)g(the)h
-(n)n(um)n(b)r(er)g(of)227 4219 y(MathMap)28 b(input)g(co)r(ordinates)e
+(n)n(um)n(b)r(er)g(of)227 1482 y(MathMap)28 b(input)g(co)r(ordinates)e
(\(giv)n(en)h(b)n(y)h(the)g(Nin)g(attribute\).)37 b(If)28
-b(Nin)g(is)g(2,)f(y)n(ou)g(migh)n(t)g(use:)340 4367 y
+b(Nin)g(is)g(2,)f(y)n(ou)g(migh)n(t)g(use:)340 1644 y
Fh(\017)45 b Ft(")p Fi(x)27 b(=)h(r)f Fh(\003)g Fi(cos\()g(theta)h(\))p
-Ft(")340 4505 y Fh(\017)45 b Ft(")p Fi(y)27 b(=)h(r)f
-Fh(\003)g Fi(sin\()h(theta)g(\))p Ft(")227 4679 y Fi(whic)n(h)f
+Ft(")340 1789 y Fh(\017)45 b Ft(")p Fi(y)27 b(=)h(r)f
+Fh(\003)g Fi(sin\()h(theta)g(\))p Ft(")227 1977 y Fi(whic)n(h)f
(expresses)e(the)i(transformation)e(from)i(p)r(olar)f(to)g(Cartesian)g
(co)r(ordinates.)35 b(Note)26 b(that)h(here)g(the)g(input)227
-4778 y(v)-5 b(ariables)31 b(\()p Ft(")p Fi(x)p Ft(")h
+2076 y(v)-5 b(ariables)31 b(\()p Ft(")p Fi(x)p Ft(")h
Fi(and)g Ft(")p Fi(y)p Ft(")p Fi(\))g(are)f(named)i(on)f(the)h(left)g
(of)f(eac)n(h)f(expression,)i(and)f(the)h(output)f(v)-5
-b(ariables)32 b(\()p Ft(")p Fi(r)p Ft(")227 4878 y Fi(and)c
+b(ariables)32 b(\()p Ft(")p Fi(r)p Ft(")227 2176 y Fi(and)c
Ft(")p Fi(theta)p Ft(")p Fi(\))f(are)g(referenced)f(on)i(the)g(righ)n
-(t.)227 5008 y(Normally)-7 b(,)25 b(y)n(ou)e(cannot)i(refer)f(to)g(a)g
+(t.)227 2313 y(Normally)-7 b(,)25 b(y)n(ou)e(cannot)i(refer)f(to)g(a)g
(v)-5 b(ariable)24 b(on)g(the)h(righ)n(t)f(of)h(an)f(expression)f
-(unless)h(it)i(is)e(named)h(on)f(the)h(left)227 5108
+(unless)h(it)i(is)e(named)h(on)f(the)h(left)227 2413
y(of)j(an)g(expression)f(in)i(the)f(complemen)n(tary)f(set)h(of)h
(functions.)39 b(Therefore)27 b(b)r(oth)h(sets)g(of)g(functions)h
-(\(forw)n(ard)227 5207 y(and)d(in)n(v)n(erse\))e(m)n(ust)i(b)r(e)g
+(\(forw)n(ard)227 2513 y(and)d(in)n(v)n(erse\))e(m)n(ust)i(b)r(e)g
(form)n(ulated)f(using)g(the)i(same)e(consisten)n(t)g(set)g(of)h(v)-5
b(ariable)25 b(names.)35 b(This)26 b(means)f(that)227
-5307 y(if)35 b(y)n(ou)f(wish)h(to)f(lea)n(v)n(e)g(one)g(of)g(the)h
+2612 y(if)35 b(y)n(ou)f(wish)h(to)f(lea)n(v)n(e)g(one)g(of)g(the)h
(transformations)e(unde\014ned,)k(y)n(ou)d(m)n(ust)h(supply)g(dumm)n(y)
-f(expressions)227 5407 y(whic)n(h)28 b(simply)f(name)h(eac)n(h)f(of)g
+f(expressions)227 2712 y(whic)n(h)28 b(simply)f(name)h(eac)n(h)f(of)g
(the)h(output)g(\(or)f(input\))i(v)-5 b(ariables.)36
b(F)-7 b(or)27 b(example,)g(y)n(ou)g(migh)n(t)g(use:)340
-5554 y Fh(\017)45 b Ft(")p Fi(x)p Ft(")340 5693 y Fh(\017)g
-Ft(")p Fi(y)p Ft(")p eop end
-%%Page: 292 302
-TeXDict begin 292 301 bop 0 52 a FF(292)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)227 351 y Fi(for)22
-b(the)h(in)n(v)n(erse)d(transformation)h(ab)r(o)n(v)n(e,)h(whic)n(h)g
-(serv)n(es)f(to)h(name)g(the)g(input)h(v)-5 b(ariables)21
-b(but)i(without)g(de\014ning)227 451 y(an)28 b(in)n(v)n(erse)e
-(transformation.)-2 612 y Fd(Calculating)32 b(In)m(termediate)g(V)-8
-b(alues)n(:)227 758 y Fi(It)23 b(is)g(sometimes)g(useful)g(to)g
-(calculate)f(in)n(termediate)g(v)-5 b(alues)23 b(and)g(then)g(to)g(use)
-f(these)h(in)g(the)h(\014nal)e(expressions)227 858 y(for)28
-b(the)g(output)h(\(or)e(input\))i(v)-5 b(ariables.)37
-b(This)27 b(ma)n(y)h(b)r(e)g(done)g(b)n(y)f(supplying)h(additional)g
-(expressions)e(for)h(the)227 957 y(forw)n(ard)e(\(or)i(in)n(v)n(erse\))
-e(transformation)h(functions.)36 b(F)-7 b(or)27 b(instance,)g(the)g
-(follo)n(wing)f(arra)n(y)e(of)j(\014v)n(e)f(expressions)227
-1057 y(describ)r(es)h(2-dimensional)g(pin-cushion)g(distortion:)340
-1205 y Fh(\017)45 b Ft(")p Fi(r)27 b(=)g(sqrt\()h(xin)f
-Fh(\003)g Fi(xin)h(+)f(yin)h Fh(\003)f Fi(yin)h(\))p
-Ft(")340 1344 y Fh(\017)45 b Ft(")p Fi(rout)27 b(=)g(r)g
-Fh(\003)h Fi(\()g(1)f(+)g(0.1)g Fh(\003)g Fi(r)g Fh(\003)g
-Fi(r)g(\))p Ft(")340 1483 y Fh(\017)45 b Ft(")p Fi(theta)28
-b(=)f(atan2\()g(yin,)h(xin)f(\))p Ft(")340 1621 y Fh(\017)45
-b Ft(")p Fi(xout)27 b(=)h(rout)f Fh(\003)g Fi(cos\()g(theta)h(\))p
-Ft(")340 1760 y Fh(\017)45 b Ft(")p Fi(y)n(out)27 b(=)g(rout)g
-Fh(\003)h Fi(sin\()f(theta)h(\))p Ft(")227 1934 y Fi(Here,)35
+2874 y Fh(\017)45 b Ft(")p Fi(x)p Ft(")340 3019 y Fh(\017)g
+Ft(")p Fi(y)p Ft(")227 3207 y Fi(for)22 b(the)h(in)n(v)n(erse)d
+(transformation)h(ab)r(o)n(v)n(e,)h(whic)n(h)g(serv)n(es)f(to)h(name)g
+(the)g(input)h(v)-5 b(ariables)21 b(but)i(without)g(de\014ning)227
+3306 y(an)28 b(in)n(v)n(erse)e(transformation.)-2 3481
+y Fd(Calculating)32 b(In)m(termediate)g(V)-8 b(alues)n(:)227
+3628 y Fi(It)23 b(is)g(sometimes)g(useful)g(to)g(calculate)f(in)n
+(termediate)g(v)-5 b(alues)23 b(and)g(then)g(to)g(use)f(these)h(in)g
+(the)h(\014nal)e(expressions)227 3727 y(for)28 b(the)g(output)h(\(or)e
+(input\))i(v)-5 b(ariables.)37 b(This)27 b(ma)n(y)h(b)r(e)g(done)g(b)n
+(y)f(supplying)h(additional)g(expressions)e(for)h(the)227
+3827 y(forw)n(ard)e(\(or)i(in)n(v)n(erse\))e(transformation)h
+(functions.)36 b(F)-7 b(or)27 b(instance,)g(the)g(follo)n(wing)f(arra)n
+(y)e(of)j(\014v)n(e)f(expressions)227 3926 y(describ)r(es)h
+(2-dimensional)g(pin-cushion)g(distortion:)340 4088 y
+Fh(\017)45 b Ft(")p Fi(r)27 b(=)g(sqrt\()h(xin)f Fh(\003)g
+Fi(xin)h(+)f(yin)h Fh(\003)f Fi(yin)h(\))p Ft(")340 4234
+y Fh(\017)45 b Ft(")p Fi(rout)27 b(=)g(r)g Fh(\003)h
+Fi(\()g(1)f(+)g(0.1)g Fh(\003)g Fi(r)g Fh(\003)g Fi(r)g(\))p
+Ft(")340 4380 y Fh(\017)45 b Ft(")p Fi(theta)28 b(=)f(atan2\()g(yin,)h
+(xin)f(\))p Ft(")340 4525 y Fh(\017)45 b Ft(")p Fi(xout)27
+b(=)h(rout)f Fh(\003)g Fi(cos\()g(theta)h(\))p Ft(")340
+4671 y Fh(\017)45 b Ft(")p Fi(y)n(out)27 b(=)g(rout)g
+Fh(\003)h Fi(sin\()f(theta)h(\))p Ft(")227 4858 y Fi(Here,)35
b(w)n(e)e(\014rst)h(calculate)f(three)g(in)n(termediate)h(results)f(\()
p Ft(")p Fi(r)p Ft(")p Fi(,)h Ft(")p Fi(rout)p Ft(")f
Fi(and)g Ft(")p Fi(theta)p Ft(")p Fi(\))g(and)h(then)g(use)g(these)227
-2033 y(to)e(calculate)f(the)i(\014nal)f(results)f(\()p
+4958 y(to)e(calculate)f(the)i(\014nal)f(results)f(\()p
Ft(")p Fi(xout)p Ft(")g Fi(and)h Ft(")p Fi(y)n(out)p
Ft(")p Fi(\).)49 b(The)32 b(MathMap)g(kno)n(ws)e(that)j(only)e(the)i
-(\014nal)e(t)n(w)n(o)227 2133 y(results)f(constitute)g(v)-5
+(\014nal)e(t)n(w)n(o)227 5058 y(results)f(constitute)g(v)-5
b(alues)30 b(for)f(the)i(output)f(v)-5 b(ariables)29
b(b)r(ecause)h(its)g(Nout)g(attribute)g(is)g(set)g(to)g(2.)44
-b(Y)-7 b(ou)30 b(ma)n(y)227 2233 y(de\014ne)i(as)g(man)n(y)f(in)n
+b(Y)-7 b(ou)30 b(ma)n(y)227 5157 y(de\014ne)i(as)g(man)n(y)f(in)n
(termediate)g(v)-5 b(ariables)31 b(in)h(this)g(w)n(a)n(y)f(as)g(y)n(ou)
g(c)n(ho)r(ose.)49 b(Ha)n(ving)31 b(de\014ned)h(a)f(v)-5
-b(ariable,)32 b(y)n(ou)227 2332 y(ma)n(y)27 b(then)h(refer)f(to)h(it)g
+b(ariable,)32 b(y)n(ou)227 5257 y(ma)n(y)27 b(then)h(refer)f(to)h(it)g
(on)f(the)h(righ)n(t)f(of)g(an)n(y)g(subsequen)n(t)g(expressions.)227
-2463 y(Note)36 b(that)g(when)g(de\014ning)g(the)g(in)n(v)n(erse)e
+5394 y(Note)36 b(that)g(when)g(de\014ning)g(the)g(in)n(v)n(erse)e
(transformation)g(y)n(ou)h(ma)n(y)g(only)g(refer)g(to)h(the)g(output)g
-(v)-5 b(ariables)227 2562 y Ft(")p Fi(xout)p Ft(")34
+(v)-5 b(ariables)227 5494 y Ft(")p Fi(xout)p Ft(")34
b Fi(and)h Ft(")p Fi(y)n(out)p Ft(")p Fi(.)58 b(The)35
b(in)n(termediate)f(v)-5 b(ariables)34 b Ft(")p Fi(r)p
Ft(")p Fi(,)h Ft(")p Fi(rout)p Ft(")f Fi(and)h Ft(")p
Fi(theta)p Ft(")f Fi(\(ab)r(o)n(v)n(e\))g(are)g(priv)-5
-b(ate)35 b(to)227 2662 y(the)28 b(forw)n(ard)d(transformation)g(and)i
+b(ate)35 b(to)227 5593 y(the)28 b(forw)n(ard)d(transformation)g(and)i
(ma)n(y)f(not)h(b)r(e)g(referenced)g(b)n(y)f(the)i(in)n(v)n(erse)d
-(transformation.)35 b(The)27 b(in)n(v)n(erse)227 2762
+(transformation.)35 b(The)27 b(in)n(v)n(erse)227 5693
y(transformation)f(ma)n(y)-7 b(,)27 b(ho)n(w)n(ev)n(er,)f(de\014ne)i
(its)f(o)n(wn)g(priv)-5 b(ate)28 b(in)n(termediate)f(v)-5
-b(ariables.)-2 2923 y Fd(Expression)31 b(Syn)m(tax)n(:)227
-3069 y Fi(The)39 b(expressions)d(giv)n(en)i(for)g(the)h(forw)n(ard)d
-(and)j(in)n(v)n(erse)e(transformations)f(closely)i(follo)n(w)f(the)i
-(syn)n(tax)f(of)227 3169 y(the)c(C)f(programming)e(language)g(\(with)j
-(some)f(extensions)f(for)h(compatibilit)n(y)g(with)h(F)-7
-b(ortran\).)52 b(They)33 b(ma)n(y)227 3268 y(con)n(tain)c(references)g
-(to)g(v)-5 b(ariables)29 b(and)g(literal)h(constan)n(ts,)f(together)g
-(with)h(arithmetic,)g(b)r(o)r(olean,)g(relational)227
-3368 y(and)23 b(bit)n(wise)g(op)r(erators,)e(and)i(function)g(in)n(v)n
+b(ariables.)p eop end
+%%Page: 293 303
+TeXDict begin 293 302 bop 3643 52 a FF(293)-2 351 y Fd(Expression)31
+b(Syn)m(tax)n(:)227 497 y Fi(The)39 b(expressions)d(giv)n(en)i(for)g
+(the)h(forw)n(ard)d(and)j(in)n(v)n(erse)e(transformations)f(closely)i
+(follo)n(w)f(the)i(syn)n(tax)f(of)227 597 y(the)c(C)f(programming)e
+(language)g(\(with)j(some)f(extensions)f(for)h(compatibilit)n(y)g(with)
+h(F)-7 b(ortran\).)52 b(They)33 b(ma)n(y)227 697 y(con)n(tain)c
+(references)g(to)g(v)-5 b(ariables)29 b(and)g(literal)h(constan)n(ts,)f
+(together)g(with)h(arithmetic,)g(b)r(o)r(olean,)g(relational)227
+796 y(and)23 b(bit)n(wise)g(op)r(erators,)e(and)i(function)g(in)n(v)n
(o)r(cations.)34 b(A)23 b(set)g(of)g(sym)n(b)r(olic)f(constan)n(ts)g
-(is)g(also)g(a)n(v)-5 b(ailable.)34 b(Eac)n(h)227 3467
+(is)g(also)g(a)n(v)-5 b(ailable.)34 b(Eac)n(h)227 896
y(of)g(these)f(is)h(describ)r(ed)f(in)h(detail)g(b)r(elo)n(w.)54
b(P)n(aren)n(theses)32 b(ma)n(y)h(b)r(e)h(used)f(to)h(o)n(v)n(er-ride)d
-(the)j(normal)e(order)h(of)227 3567 y(ev)-5 b(aluation.)41
+(the)j(normal)e(order)h(of)227 995 y(ev)-5 b(aluation.)41
b(There)28 b(is)h(no)g(built-in)g(limit)h(to)f(the)g(length)g(of)g
(expressions)e(and)i(they)g(are)f(insensitiv)n(e)h(to)f(case)227
-3667 y(or)f(the)h(presence)f(of)g(additional)g(white)h(space.)-2
-3828 y Fd(V)-8 b(ariables)n(:)227 3974 y Fi(V)h(ariable)26
+1095 y(or)f(the)h(presence)f(of)g(additional)g(white)h(space.)-2
+1259 y Fd(V)-8 b(ariables)n(:)227 1405 y Fi(V)h(ariable)26
b(names)h(m)n(ust)f(b)r(egin)h(with)h(an)e(alphab)r(etic)h(c)n
(haracter)e(and)h(ma)n(y)g(con)n(tain)h(only)f(alphab)r(etic)h(c)n
-(harac-)227 4074 y(ters,)j(digits,)g(and)f(the)h(underscore)e(c)n
+(harac-)227 1505 y(ters,)j(digits,)g(and)f(the)h(underscore)e(c)n
(haracter)f Ft("_")p Fi(.)42 b(There)29 b(is)g(no)g(built-in)h(limit)g
-(to)g(the)g(length)f(of)h(v)-5 b(ariable)227 4173 y(names.)-2
-4335 y Fd(Literal)32 b(Constan)m(ts)n(:)227 4481 y Fi(Literal)g
+(to)g(the)g(length)f(of)h(v)-5 b(ariable)227 1605 y(names.)-2
+1769 y Fd(Literal)32 b(Constan)m(ts)n(:)227 1915 y Fi(Literal)g
(constan)n(ts,)h(suc)n(h)g(as)e Ft(")p Fi(0)p Ft(")p
Fi(,)i Ft(")p Fi(1)p Ft(")p Fi(,)g Ft(")p Fi(0.007)p
Ft(")d Fi(or)i Ft(")p Fi(2.505e-16)p Ft(")c Fi(ma)n(y)k(app)r(ear)g(in)
-h(expressions,)f(with)h(the)227 4580 y(decimal)28 b(p)r(oin)n(t)g(and)f
+h(expressions,)f(with)h(the)227 2014 y(decimal)28 b(p)r(oin)n(t)g(and)f
(exp)r(onen)n(t)g(b)r(eing)h(optional)f(\(a)h Ft(")p
Fi(D)p Ft(")f Fi(ma)n(y)g(also)f(b)r(e)i(used)g(as)f(an)g(exp)r(onen)n
-(t)h(c)n(haracter)d(for)227 4680 y(compatibilit)n(y)j(with)g(F)-7
+(t)h(c)n(haracter)d(for)227 2114 y(compatibilit)n(y)j(with)g(F)-7
b(ortran\).)36 b(A)28 b(unary)e(min)n(us)i Ft(")p Fi(-)p
Ft(")f Fi(ma)n(y)f(b)r(e)i(used)g(as)f(a)g(pre\014x.)-2
-4841 y Fd(Arithmetic)32 b(Precision)n(:)227 4987 y Fi(All)c(arithmetic)
+2278 y Fd(Arithmetic)32 b(Precision)n(:)227 2424 y Fi(All)c(arithmetic)
g(is)f(\015oating)g(p)r(oin)n(t,)h(p)r(erformed)f(in)h(double)f
-(precision.)-2 5148 y Fd(Propagation)33 b(of)e(Missing)f(Data)n(:)227
-5295 y Fi(Unless)i(indicated)g(otherwise,)h(if)f(an)n(y)f(argumen)n(t)g
+(precision.)-2 2588 y Fd(Propagation)33 b(of)e(Missing)f(Data)n(:)227
+2734 y Fi(Unless)i(indicated)g(otherwise,)h(if)f(an)n(y)f(argumen)n(t)g
(of)h(a)g(function)g(or)g(op)r(erator)e(has)h(the)i(v)-5
-b(alue)32 b(AST)p Ft(__)p Fi(BAD)227 5394 y(\(indicating)38
+b(alue)32 b(AST)p Ft(__)p Fi(BAD)227 2834 y(\(indicating)38
b(missing)f(data\),)j(then)e(the)g(result)f(of)g(that)h(function)g(or)e
(op)r(eration)h(is)g(also)g(AST)p Ft(__)p Fi(BAD,)g(so)227
-5494 y(that)k(suc)n(h)e(v)-5 b(alues)40 b(are)f(propagated)f
+2933 y(that)k(suc)n(h)e(v)-5 b(alues)40 b(are)f(propagated)f
(automatically)h(through)g(all)h(op)r(erations)f(p)r(erformed)g(b)n(y)h
-(MathMap)227 5593 y(transformations.)35 b(The)26 b(sp)r(ecial)h(v)-5
+(MathMap)227 3033 y(transformations.)35 b(The)26 b(sp)r(ecial)h(v)-5
b(alue)26 b(AST)p Ft(__)p Fi(BAD)g(can)h(b)r(e)f(represen)n(ted)g(in)g
-(expressions)f(b)n(y)h(the)h(sym)n(b)r(olic)227 5693
+(expressions)f(b)n(y)h(the)h(sym)n(b)r(olic)227 3133
y(constan)n(t)g Ft(")p Fk(<)p Fi(bad)p Fk(>)p Ft(")p
-Fi(.)p eop end
-%%Page: 293 303
-TeXDict begin 293 302 bop 3643 52 a FF(293)227 351 y
-Fi(A)33 b Fk(<)p Fi(bad)p Fk(>)f Fi(result)g(\(i.e.)52
+Fi(.)227 3265 y(A)33 b Fk(<)p Fi(bad)p Fk(>)f Fi(result)g(\(i.e.)52
b(equal)32 b(to)h(AST)p Ft(__)p Fi(BAD\))g(is)f(also)g(pro)r(duced)g
(in)h(resp)r(onse)f(to)g(an)n(y)g(n)n(umerical)g(error)227
-451 y(\(suc)n(h)f(as)f(division)h(b)n(y)g(zero)e(or)h(n)n(umerical)g(o)
-n(v)n(er\015o)n(w\),)g(or)g(if)h(an)g(in)n(v)-5 b(alid)31
+3364 y(\(suc)n(h)f(as)f(division)h(b)n(y)g(zero)e(or)h(n)n(umerical)g
+(o)n(v)n(er\015o)n(w\),)g(or)g(if)h(an)g(in)n(v)-5 b(alid)31
b(argumen)n(t)f(v)-5 b(alue)31 b(is)f(pro)n(vided)g(to)h(a)227
-551 y(function)d(or)f(op)r(erator.)-2 699 y Fd(Arithmetic)32
-b(Op)s(erators)n(:)227 845 y Fi(The)c(follo)n(wing)e(arithmetic)i(op)r
-(erators)e(are)g(a)n(v)-5 b(ailable:)340 981 y Fh(\017)45
+3464 y(function)d(or)f(op)r(erator.)-2 3628 y Fd(Arithmetic)32
+b(Op)s(erators)n(:)227 3774 y Fi(The)c(follo)n(wing)e(arithmetic)i(op)r
+(erators)e(are)g(a)n(v)-5 b(ailable:)340 3925 y Fh(\017)45
b Fi(x1)27 b(+)h(x2:)36 b(Sum)28 b(of)f Ft(")p Fi(x1)p
-Ft(")g Fi(and)g Ft(")p Fi(x2)p Ft(")p Fi(.)340 1113 y
+Ft(")g Fi(and)g Ft(")p Fi(x2)p Ft(")p Fi(.)340 4065 y
Fh(\017)45 b Fi(x1)27 b(-)h(x2:)36 b(Di\013erence)28
b(of)f Ft(")p Fi(x1)p Ft(")f Fi(and)i Ft(")p Fi(x2)p
-Ft(")p Fi(.)340 1245 y Fh(\017)45 b Fi(x1)27 b Fh(\003)g
+Ft(")p Fi(.)340 4205 y Fh(\017)45 b Fi(x1)27 b Fh(\003)g
Fi(x2:)37 b(Pro)r(duct)27 b(of)g Ft(")p Fi(x1)p Ft(")f
-Fi(and)i Ft(")p Fi(x1)p Ft(")p Fi(.)340 1377 y Fh(\017)45
+Fi(and)i Ft(")p Fi(x1)p Ft(")p Fi(.)340 4345 y Fh(\017)45
b Fi(x1)27 b(/)g(x2:)37 b(Ratio)27 b(of)g Ft(")p Fi(x1)p
-Ft(")g Fi(and)g Ft(")p Fi(x2)p Ft(")p Fi(.)340 1509 y
+Ft(")g Fi(and)g Ft(")p Fi(x2)p Ft(")p Fi(.)340 4486 y
Fh(\017)45 b Fi(x1)27 b Fh(\003\003)g Fi(x2:)36 b Ft(")p
Fi(x1)p Ft(")26 b Fi(raised)h(to)g(the)h(p)r(o)n(w)n(er)f(of)g
-Ft(")p Fi(x2)p Ft(")p Fi(.)340 1642 y Fh(\017)45 b Fi(+)28
+Ft(")p Fi(x2)p Ft(")p Fi(.)340 4626 y Fh(\017)45 b Fi(+)28
b(x:)36 b(Unary)27 b(plus,)h(has)f(no)g(e\013ect)h(on)g(its)g(argumen)n
-(t.)340 1774 y Fh(\017)45 b Fi(-)28 b(x:)36 b(Unary)27
-b(min)n(us,)h(negates)f(its)g(argumen)n(t.)-2 1935 y
-Fd(Bo)s(olean)k(Op)s(erators)n(:)227 2081 y Fi(Bo)r(olean)c(v)-5
+(t.)340 4766 y Fh(\017)45 b Fi(-)28 b(x:)36 b(Unary)27
+b(min)n(us,)h(negates)f(its)g(argumen)n(t.)-2 4942 y
+Fd(Bo)s(olean)k(Op)s(erators)n(:)227 5089 y Fi(Bo)r(olean)c(v)-5
b(alues)27 b(are)g(represen)n(ted)f(using)h(zero)g(to)h(indicate)f
(false)h(and)f(non-zero)f(to)i(indicate)f(true.)37 b(In)28
-b(addi-)227 2181 y(tion,)22 b(the)f(v)-5 b(alue)21 b(AST)p
+b(addi-)227 5188 y(tion,)22 b(the)f(v)-5 b(alue)21 b(AST)p
Ft(__)p Fi(BAD)f(is)h(tak)n(en)f(to)g(mean)g Ft(")p Fi(unkno)n(wn)p
Ft(")p Fi(.)34 b(The)20 b(v)-5 b(alues)20 b(returned)g(b)n(y)h(b)r(o)r
-(olean)f(op)r(erators)227 2280 y(ma)n(y)33 b(therefore)g(b)r(e)h(0,)g
+(olean)f(op)r(erators)227 5288 y(ma)n(y)33 b(therefore)g(b)r(e)h(0,)g
(1)g(or)e(AST)p Ft(__)p Fi(BAD.)i(Where)f(appropriate,)h
Ft(")p Fi(tri-state)p Ft(")e Fi(logic)g(is)i(implemen)n(ted.)55
-b(F)-7 b(or)227 2380 y(example,)29 b Ft(")p Fi(a)p Fh(jj)p
+b(F)-7 b(or)227 5387 y(example,)29 b Ft(")p Fi(a)p Fh(jj)p
Fi(b)p Ft(")f Fi(ma)n(y)g(ev)-5 b(aluate)28 b(to)g(1)h(if)g
Ft(")p Fi(a)p Ft(")e Fi(is)i(non-zero,)e(ev)n(en)i(if)g
Ft(")p Fi(b)p Ft(")f Fi(has)g(the)h(v)-5 b(alue)29 b(AST)p
-Ft(__)p Fi(BAD.)g(This)227 2479 y(is)g(b)r(ecause)f(the)h(result)f(of)h
+Ft(__)p Fi(BAD.)g(This)227 5487 y(is)g(b)r(ecause)f(the)h(result)f(of)h
(the)g(op)r(eration)f(w)n(ould)g(not)h(b)r(e)g(a\013ected)f(b)n(y)h
(the)g(v)-5 b(alue)28 b(of)h Ft(")p Fi(b)p Ft(")p Fi(,)f(so)g(long)g
-(as)g Ft(")p Fi(a)p Ft(")g Fi(is)227 2579 y(non-zero.)227
-2703 y(The)g(follo)n(wing)e(b)r(o)r(olean)h(op)r(erators)f(are)h(a)n(v)
--5 b(ailable:)340 2839 y Fh(\017)45 b Fi(x1)34 b(&&)g(x2:)50
-b(Bo)r(olean)33 b(AND)i(b)r(et)n(w)n(een)g Ft(")p Fi(x1)p
-Ft(")e Fi(and)h Ft(")p Fi(x2)p Ft(")p Fi(,)h(returning)f(1)g(if)g(b)r
-(oth)h Ft(")p Fi(x1)p Ft(")e Fi(and)i Ft(")p Fi(x2)p
-Ft(")e Fi(are)427 2938 y(non-zero,)c(and)g(0)g(otherwise.)42
-b(This)30 b(op)r(erator)e(implemen)n(ts)i(tri-state)f(logic.)42
-b(\(The)30 b(synon)n(ym)e Ft(")p Fi(.and.)p Ft(")427
-3038 y Fi(is)g(also)e(pro)n(vided)h(for)g(compatibilit)n(y)g(with)h(F)
--7 b(ortran.\))340 3170 y Fh(\017)45 b Fi(x1)32 b Fh(jj)h
-Fi(x2:)47 b(Bo)r(olean)32 b(OR)g(b)r(et)n(w)n(een)h Ft(")p
-Fi(x1)p Ft(")e Fi(and)i Ft(")p Fi(x2)p Ft(")p Fi(,)g(returning)f(1)g
-(if)h(either)g Ft(")p Fi(x1)p Ft(")e Fi(or)h Ft(")p Fi(x2)p
-Ft(")f Fi(are)h(non-)427 3270 y(zero,)27 b(and)h(0)f(otherwise.)36
-b(This)28 b(op)r(erator)e(implemen)n(ts)i(tri-state)f(logic.)36
-b(\(The)28 b(synon)n(ym)f Ft(")p Fi(.or.)p Ft(")f Fi(is)i(also)427
-3369 y(pro)n(vided)f(for)g(compatibilit)n(y)g(with)h(F)-7
-b(ortran.\))340 3502 y Fh(\017)45 b Fi(x1)23 b Fh(^^)h
-Fi(x2:)34 b(Bo)r(olean)23 b(exclusiv)n(e)f(OR)h(\(X)n(OR\))h(b)r(et)n
-(w)n(een)f Ft(")p Fi(x1)p Ft(")f Fi(and)i Ft(")p Fi(x2)p
-Ft(")p Fi(,)e(returning)h(1)g(if)h(exactly)f(one)g(of)427
-3601 y Ft(")p Fi(x1)p Ft(")17 b Fi(and)h Ft(")p Fi(x2)p
-Ft(")f Fi(is)i(non-zero,)f(and)h(0)f(otherwise.)33 b(T)-7
-b(ri-state)17 b(logic)h(is)g(not)g(used)h(with)f(this)h(op)r(erator.)32
-b(\(The)427 3701 y(synon)n(yms)22 b Ft(")p Fi(.neqv.)p
+(as)g Ft(")p Fi(a)p Ft(")g Fi(is)227 5587 y(non-zero.)227
+5718 y(The)g(follo)n(wing)e(b)r(o)r(olean)h(op)r(erators)f(are)h(a)n(v)
+-5 b(ailable:)p eop end
+%%Page: 294 304
+TeXDict begin 294 303 bop 0 52 a FF(294)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Fi(x1)34 b(&&)g(x2:)50 b(Bo)r(olean)33 b(AND)i(b)r(et)n(w)n(een)g
+Ft(")p Fi(x1)p Ft(")e Fi(and)h Ft(")p Fi(x2)p Ft(")p
+Fi(,)h(returning)f(1)g(if)g(b)r(oth)h Ft(")p Fi(x1)p
+Ft(")e Fi(and)i Ft(")p Fi(x2)p Ft(")e Fi(are)427 451
+y(non-zero,)c(and)g(0)g(otherwise.)42 b(This)30 b(op)r(erator)e
+(implemen)n(ts)i(tri-state)f(logic.)42 b(\(The)30 b(synon)n(ym)e
+Ft(")p Fi(.and.)p Ft(")427 551 y Fi(is)g(also)e(pro)n(vided)h(for)g
+(compatibilit)n(y)g(with)h(F)-7 b(ortran.\))340 675 y
+Fh(\017)45 b Fi(x1)32 b Fh(jj)h Fi(x2:)47 b(Bo)r(olean)32
+b(OR)g(b)r(et)n(w)n(een)h Ft(")p Fi(x1)p Ft(")e Fi(and)i
+Ft(")p Fi(x2)p Ft(")p Fi(,)g(returning)f(1)g(if)h(either)g
+Ft(")p Fi(x1)p Ft(")e Fi(or)h Ft(")p Fi(x2)p Ft(")f Fi(are)h(non-)427
+774 y(zero,)27 b(and)h(0)f(otherwise.)36 b(This)28 b(op)r(erator)e
+(implemen)n(ts)i(tri-state)f(logic.)36 b(\(The)28 b(synon)n(ym)f
+Ft(")p Fi(.or.)p Ft(")f Fi(is)i(also)427 874 y(pro)n(vided)f(for)g
+(compatibilit)n(y)g(with)h(F)-7 b(ortran.\))340 998 y
+Fh(\017)45 b Fi(x1)23 b Fh(^^)h Fi(x2:)34 b(Bo)r(olean)23
+b(exclusiv)n(e)f(OR)h(\(X)n(OR\))h(b)r(et)n(w)n(een)f
+Ft(")p Fi(x1)p Ft(")f Fi(and)i Ft(")p Fi(x2)p Ft(")p
+Fi(,)e(returning)h(1)g(if)h(exactly)f(one)g(of)427 1098
+y Ft(")p Fi(x1)p Ft(")17 b Fi(and)h Ft(")p Fi(x2)p Ft(")f
+Fi(is)i(non-zero,)f(and)h(0)f(otherwise.)33 b(T)-7 b(ri-state)17
+b(logic)h(is)g(not)g(used)h(with)f(this)h(op)r(erator.)32
+b(\(The)427 1197 y(synon)n(yms)22 b Ft(")p Fi(.neqv.)p
Ft(")g Fi(and)g Ft(")p Fi(.xor.)p Ft(")f Fi(are)h(also)g(pro)n(vided)f
(for)i(compatibilit)n(y)f(with)i(F)-7 b(ortran,)22 b(although)g(the)427
-3800 y(second)27 b(of)h(these)f(is)h(not)g(standard.\))340
-3933 y Fh(\017)45 b Fi(x1)38 b(.eqv.)67 b(x2:)57 b(This)38
+1297 y(second)27 b(of)h(these)f(is)h(not)g(standard.\))340
+1421 y Fh(\017)45 b Fi(x1)38 b(.eqv.)67 b(x2:)57 b(This)38
b(is)f(pro)n(vided)g(only)h(for)f(compatibilit)n(y)h(with)g(F)-7
-b(ortran)37 b(and)h(tests)f(whether)h(the)427 4032 y(b)r(o)r(olean)26
+b(ortran)37 b(and)h(tests)f(whether)h(the)427 1521 y(b)r(o)r(olean)26
b(states)f(of)h Ft(")p Fi(x1)p Ft(")e Fi(and)i Ft(")p
Fi(x2)p Ft(")e Fi(\(i.e.)37 b(true/false\))25 b(are)g(equal.)36
b(It)26 b(is)g(the)g(negativ)n(e)e(of)i(the)h(exclusiv)n(e)427
-4132 y(OR)h(\(X)n(OR\))g(function.)37 b(T)-7 b(ri-state)27
+1620 y(OR)h(\(X)n(OR\))g(function.)37 b(T)-7 b(ri-state)27
b(logic)f(is)i(not)f(used)h(with)g(this)g(op)r(erator.)340
-4264 y Fh(\017)45 b Fi(!)35 b(x:)f(Bo)r(olean)20 b(unary)h(NOT)g(op)r
+1745 y Fh(\017)45 b Fi(!)35 b(x:)f(Bo)r(olean)20 b(unary)h(NOT)g(op)r
(eration,)h(returning)e(1)h(if)h Ft(")p Fi(x)p Ft(")f
Fi(is)g(zero,)h(and)f(0)g(otherwise.)34 b(\(The)22 b(synon)n(ym)427
-4364 y Ft(")p Fi(.not.)p Ft(")27 b Fi(is)h(also)e(pro)n(vided)h(for)g
-(compatibilit)n(y)g(with)h(F)-7 b(ortran.\))-2 4525 y
-Fd(Relational)31 b(Op)s(erators)n(:)227 4671 y Fi(Relational)22
+1844 y Ft(")p Fi(.not.)p Ft(")27 b Fi(is)h(also)e(pro)n(vided)h(for)g
+(compatibilit)n(y)g(with)h(F)-7 b(ortran.\))-2 1997 y
+Fd(Relational)31 b(Op)s(erators)n(:)227 2144 y Fi(Relational)22
b(op)r(erators)e(return)i(the)g(b)r(o)r(olean)g(result)g(\(0)g(or)f
(1\))h(of)g(comparing)f(the)i(v)-5 b(alues)21 b(of)i(t)n(w)n(o)e
-(\015oating)g(p)r(oin)n(t)227 4770 y(v)-5 b(alues)30
+(\015oating)g(p)r(oin)n(t)227 2243 y(v)-5 b(alues)30
b(for)g(equalit)n(y)g(or)f(inequalit)n(y)-7 b(.)45 b(The)31
b(v)-5 b(alue)30 b(AST)p Ft(__)p Fi(BAD)h(ma)n(y)e(also)h(b)r(e)h
-(returned)e(if)i(either)g(argumen)n(t)227 4870 y(is)d
-Fk(<)p Fi(bad)p Fk(>)p Fi(.)227 4994 y(The)g(follo)n(wing)e(relational)
-h(op)r(erators)e(are)i(a)n(v)-5 b(ailable:)340 5130 y
+(returned)e(if)i(either)g(argumen)n(t)227 2343 y(is)d
+Fk(<)p Fi(bad)p Fk(>)p Fi(.)227 2463 y(The)g(follo)n(wing)e(relational)
+h(op)r(erators)e(are)i(a)n(v)-5 b(ailable:)340 2591 y
Fh(\017)45 b Fi(x1)c(==)g(x2:)64 b(T)-7 b(ests)41 b(whether)g
Ft(")p Fi(x1)p Ft(")f Fi(equals)h Ft(")p Fi(x1)p Ft(")p
Fi(.)76 b(\(The)42 b(synon)n(ym)f Ft(")p Fi(.eq.)p Ft(")f
-Fi(is)h(also)g(pro)n(vided)f(for)427 5230 y(compatibilit)n(y)28
-b(with)g(F)-7 b(ortran.\))340 5362 y Fh(\017)45 b Fi(x1)29
+Fi(is)h(also)g(pro)n(vided)f(for)427 2690 y(compatibilit)n(y)28
+b(with)g(F)-7 b(ortran.\))340 2815 y Fh(\017)45 b Fi(x1)29
b(!=)g(x2:)39 b(T)-7 b(ests)29 b(whether)g Ft(")p Fi(x1)p
Ft(")f Fi(is)h(unequal)g(to)g Ft(")p Fi(x2)p Ft(")p Fi(.)40
b(\(The)29 b(synon)n(ym)f Ft(")p Fi(.ne.)p Ft(")h Fi(is)g(also)f(pro)n
-(vided)g(for)427 5461 y(compatibilit)n(y)g(with)g(F)-7
-b(ortran.\))340 5593 y Fh(\017)45 b Fi(x1)27 b Fk(>)g
+(vided)g(for)427 2914 y(compatibilit)n(y)g(with)g(F)-7
+b(ortran.\))340 3038 y Fh(\017)45 b Fi(x1)27 b Fk(>)g
Fi(x2:)37 b(T)-7 b(ests)27 b(whether)g Ft(")p Fi(x1)p
Ft(")f Fi(is)i(greater)e(than)h Ft(")p Fi(x2)p Ft(")p
Fi(.)36 b(\(The)28 b(synon)n(ym)e Ft(")p Fi(.gt.)p Ft(")h
-Fi(is)g(also)g(pro)n(vided)f(for)427 5693 y(compatibilit)n(y)i(with)g
-(F)-7 b(ortran.\))p eop end
-%%Page: 294 304
-TeXDict begin 294 303 bop 0 52 a FF(294)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
-b Fi(x1)26 b Fk(>)p Fi(=)f(x2:)36 b(T)-7 b(ests)25 b(whether)h
-Ft(")p Fi(x1)p Ft(")f Fi(is)h(greater)e(than)j(or)e(equal)g(to)h
+Fi(is)g(also)g(pro)n(vided)f(for)427 3138 y(compatibilit)n(y)i(with)g
+(F)-7 b(ortran.\))340 3262 y Fh(\017)45 b Fi(x1)26 b
+Fk(>)p Fi(=)f(x2:)36 b(T)-7 b(ests)25 b(whether)h Ft(")p
+Fi(x1)p Ft(")f Fi(is)h(greater)e(than)j(or)e(equal)g(to)h
Ft(")p Fi(x2)p Ft(")p Fi(.)35 b(\(The)27 b(synon)n(ym)e
-Ft(")p Fi(.ge.)p Ft(")g Fi(is)h(also)427 451 y(pro)n(vided)h(for)g
-(compatibilit)n(y)g(with)h(F)-7 b(ortran.\))340 586 y
-Fh(\017)45 b Fi(x1)35 b Fk(<)g Fi(x2:)52 b(T)-7 b(ests)35
+Ft(")p Fi(.ge.)p Ft(")g Fi(is)h(also)427 3362 y(pro)n(vided)h(for)g
+(compatibilit)n(y)g(with)h(F)-7 b(ortran.\))340 3486
+y Fh(\017)45 b Fi(x1)35 b Fk(<)g Fi(x2:)52 b(T)-7 b(ests)35
b(whether)g Ft(")p Fi(x1)p Ft(")f Fi(is)h(less)g(than)g
Ft(")p Fi(x2)p Ft(")p Fi(.)59 b(\(The)35 b(synon)n(ym)g
Ft(")p Fi(.lt.)p Ft(")g Fi(is)g(also)f(pro)n(vided)g(for)427
-685 y(compatibilit)n(y)28 b(with)g(F)-7 b(ortran.\))340
-820 y Fh(\017)45 b Fi(x1)33 b Fk(<)p Fi(=)g(x2:)49 b(T)-7
+3586 y(compatibilit)n(y)28 b(with)g(F)-7 b(ortran.\))340
+3710 y Fh(\017)45 b Fi(x1)33 b Fk(<)p Fi(=)g(x2:)49 b(T)-7
b(ests)34 b(whether)f Ft(")p Fi(x1)p Ft(")g Fi(is)g(less)g(than)h(or)f
(equal)g(to)h Ft(")p Fi(x2)p Ft(")p Fi(.)54 b(\(The)34
b(synon)n(ym)f Ft(")p Fi(.le.)p Ft(")g Fi(is)h(also)427
-919 y(pro)n(vided)27 b(for)g(compatibilit)n(y)g(with)h(F)-7
-b(ortran.\))227 1085 y(Note)33 b(that)f(relational)f(op)r(erators)f
+3809 y(pro)n(vided)27 b(for)g(compatibilit)n(y)g(with)h(F)-7
+b(ortran.\))227 3963 y(Note)33 b(that)f(relational)f(op)r(erators)f
(cannot)i(usefully)g(b)r(e)h(used)f(to)g(compare)f(v)-5
b(alues)32 b(with)h(the)g Fk(<)p Fi(bad)p Fk(>)e Fi(v)-5
-b(alue)227 1184 y(\(represen)n(ting)29 b(missing)g(data\),)h(b)r
+b(alue)227 4062 y(\(represen)n(ting)29 b(missing)g(data\),)h(b)r
(ecause)f(the)h(result)f(is)h(alw)n(a)n(ys)d Fk(<)p Fi(bad)p
Fk(>)p Fi(.)42 b(The)30 b(isbad\(\))g(function)g(should)f(b)r(e)227
-1284 y(used)f(instead.)-2 1437 y Fd(Bit)m(wise)j(Op)s(erators)n(:)227
-1583 y Fi(The)39 b(bit)n(wise)g(op)r(erators)d(pro)n(vided)i(b)n(y)h(C)
+4162 y(used)f(instead.)-2 4303 y Fd(Bit)m(wise)j(Op)s(erators)n(:)227
+4449 y Fi(The)39 b(bit)n(wise)g(op)r(erators)d(pro)n(vided)i(b)n(y)h(C)
f(are)g(often)h(useful)g(when)g(op)r(erating)f(on)g(ra)n(w)g(data)g
-(\(e.g.)70 b(from)227 1683 y(instrumen)n(ts\),)36 b(so)e(they)g(are)f
+(\(e.g.)70 b(from)227 4548 y(instrumen)n(ts\),)36 b(so)e(they)g(are)f
(also)g(pro)n(vided)g(for)h(use)g(in)g(MathMap)g(expressions.)55
-b(In)34 b(this)h(case,)g(ho)n(w)n(ev)n(er,)227 1782 y(the)c(v)-5
+b(In)34 b(this)h(case,)g(ho)n(w)n(ev)n(er,)227 4648 y(the)c(v)-5
b(alues)31 b(on)f(whic)n(h)h(they)f(op)r(erate)g(are)g(\015oating)g(p)r
(oin)n(t)h(v)-5 b(alues)30 b(rather)f(than)i(pure)g(in)n(tegers.)45
-b(In)30 b(order)g(to)227 1882 y(pro)r(duce)24 b(results)f(whic)n(h)h
+b(In)30 b(order)g(to)227 4748 y(pro)r(duce)24 b(results)f(whic)n(h)h
(matc)n(h)g(the)h(pure)f(in)n(teger)f(case,)h(the)g(op)r(erands)f(are)g
-(regarded)g(as)g(\014xed)h(p)r(oin)n(t)g(binary)227 1982
+(regarded)g(as)g(\014xed)h(p)r(oin)n(t)g(binary)227 4847
y(n)n(um)n(b)r(ers)32 b(\(i.e.)52 b(with)33 b(the)g(binary)e(equiv)-5
b(alen)n(t)32 b(of)h(a)f(decimal)g(p)r(oin)n(t\))h(with)g(negativ)n(e)e
-(n)n(um)n(b)r(ers)h(represen)n(ted)227 2081 y(using)c(t)n(w)n
+(n)n(um)n(b)r(ers)h(represen)n(ted)227 4947 y(using)c(t)n(w)n
(os-complemen)n(t)e(notation.)38 b(F)-7 b(or)27 b(in)n(teger)g(v)-5
b(alues,)28 b(the)g(resulting)f(bit)i(pattern)e(corresp)r(onds)g(to)g
-(that)227 2181 y(of)e(the)g(equiv)-5 b(alen)n(t)24 b(signed)g(in)n
+(that)227 5047 y(of)e(the)g(equiv)-5 b(alen)n(t)24 b(signed)g(in)n
(teger)g(\(digits)g(to)h(the)f(righ)n(t)g(of)h(the)g(p)r(oin)n(t)f(b)r
(eing)h(zero\).)35 b(Op)r(erations)23 b(on)h(the)h(bits)227
-2281 y(represen)n(ting)h(the)i(fractional)f(part)g(are)g(also)f(p)r
-(ossible,)h(ho)n(w)n(ev)n(er.)227 2407 y(The)h(follo)n(wing)e(bit)n
+5146 y(represen)n(ting)h(the)i(fractional)f(part)g(are)g(also)f(p)r
+(ossible,)h(ho)n(w)n(ev)n(er.)227 5266 y(The)h(follo)n(wing)e(bit)n
(wise)i(op)r(erators)e(are)g(a)n(v)-5 b(ailable:)340
-2547 y Fh(\017)45 b Fi(x1)30 b Fk(>>)f Fi(x2:)42 b(Righ)n(t)n(w)n(ard)
+5394 y Fh(\017)45 b Fi(x1)30 b Fk(>>)f Fi(x2:)42 b(Righ)n(t)n(w)n(ard)
28 b(bit)j(shift.)45 b(The)31 b(in)n(teger)e(v)-5 b(alue)30
b(of)g Ft(")p Fi(x2)p Ft(")f Fi(is)h(tak)n(en)f(\(rounding)h(to)n(w)n
-(ards)e(zero\))427 2646 y(and)21 b(the)g(bits)g(represen)n(ting)e
+(ards)e(zero\))427 5494 y(and)21 b(the)g(bits)g(represen)n(ting)e
Ft(")p Fi(x1)p Ft(")g Fi(are)g(then)i(shifted)h(this)f(n)n(um)n(b)r(er)
f(of)g(places)g(to)h(the)g(righ)n(t)f(\(or)f(to)i(the)g(left)427
-2746 y(if)26 b(the)f(n)n(um)n(b)r(er)g(of)g(places)f(is)h(negativ)n
+5593 y(if)26 b(the)f(n)n(um)n(b)r(er)g(of)g(places)f(is)h(negativ)n
(e\).)35 b(This)25 b(is)g(equiv)-5 b(alen)n(t)24 b(to)h(dividing)g
Ft(")p Fi(x1)p Ft(")f Fi(b)n(y)g(the)i(corresp)r(onding)427
-2846 y(p)r(o)n(w)n(er)h(of)g(2.)340 2980 y Fh(\017)45
-b Fi(x1)32 b Fk(<<)f Fi(x2:)45 b(Left)n(w)n(ard)31 b(bit)h(shift.)51
-b(The)32 b(in)n(teger)f(v)-5 b(alue)32 b(of)g Ft(")p
-Fi(x2)p Ft(")f Fi(is)g(tak)n(en)h(\(rounding)f(to)n(w)n(ards)f(zero\),)
-427 3080 y(and)i(the)g(bits)h(represen)n(ting)d Ft(")p
-Fi(x1)p Ft(")h Fi(are)g(then)h(shifted)h(this)f(n)n(um)n(b)r(er)g(of)g
-(places)f(to)h(the)g(left)h(\(or)e(to)h(the)427 3180
-y(righ)n(t)37 b(if)i(the)f(n)n(um)n(b)r(er)f(of)h(places)f(is)h
+5693 y(p)r(o)n(w)n(er)h(of)g(2.)p eop end
+%%Page: 295 305
+TeXDict begin 295 304 bop 3643 52 a FF(295)340 351 y
+Fh(\017)45 b Fi(x1)32 b Fk(<<)f Fi(x2:)45 b(Left)n(w)n(ard)31
+b(bit)h(shift.)51 b(The)32 b(in)n(teger)f(v)-5 b(alue)32
+b(of)g Ft(")p Fi(x2)p Ft(")f Fi(is)g(tak)n(en)h(\(rounding)f(to)n(w)n
+(ards)f(zero\),)427 451 y(and)i(the)g(bits)h(represen)n(ting)d
+Ft(")p Fi(x1)p Ft(")h Fi(are)g(then)h(shifted)h(this)f(n)n(um)n(b)r(er)
+g(of)g(places)f(to)h(the)g(left)h(\(or)e(to)h(the)427
+551 y(righ)n(t)37 b(if)i(the)f(n)n(um)n(b)r(er)f(of)h(places)f(is)h
(negativ)n(e\).)66 b(This)38 b(is)f(equiv)-5 b(alen)n(t)38
b(to)g(m)n(ultiplying)f Ft(")p Fi(x1)p Ft(")g Fi(b)n(y)g(the)427
-3279 y(corresp)r(onding)26 b(p)r(o)n(w)n(er)g(of)i(2.)340
-3414 y Fh(\017)45 b Fi(x1)28 b(&)h(x2:)39 b(Bit)n(wise)28
+650 y(corresp)r(onding)26 b(p)r(o)n(w)n(er)g(of)i(2.)340
+783 y Fh(\017)45 b Fi(x1)28 b(&)h(x2:)39 b(Bit)n(wise)28
b(AND)i(b)r(et)n(w)n(een)f(the)g(bits)g(of)g Ft(")p Fi(x1)p
Ft(")e Fi(and)i(those)f(of)h Ft(")p Fi(x2)p Ft(")e Fi(\(equiv)-5
-b(alen)n(t)29 b(to)g(a)f(b)r(o)r(olean)427 3513 y(AND)h(applied)e(at)h
-(eac)n(h)f(bit)h(p)r(osition)f(in)h(turn\).)340 3648
+b(alen)n(t)29 b(to)g(a)f(b)r(o)r(olean)427 883 y(AND)h(applied)e(at)h
+(eac)n(h)f(bit)h(p)r(osition)f(in)h(turn\).)340 1015
y Fh(\017)45 b Fi(x1)26 b Fh(j)g Fi(x2:)35 b(Bit)n(wise)26
b(OR)g(b)r(et)n(w)n(een)g(the)g(bits)g(of)g Ft(")p Fi(x1)p
Ft(")f Fi(and)h(those)f(of)h Ft(")p Fi(x2)p Ft(")f Fi(\(equiv)-5
-b(alen)n(t)26 b(to)g(a)f(b)r(o)r(olean)h(OR)427 3748
+b(alen)n(t)26 b(to)g(a)f(b)r(o)r(olean)h(OR)427 1115
y(applied)i(at)f(eac)n(h)g(bit)h(p)r(osition)g(in)g(turn\).)340
-3882 y Fh(\017)45 b Fi(x1)24 b Fh(^)g Fi(x2:)35 b(Bit)n(wise)24
+1248 y Fh(\017)45 b Fi(x1)24 b Fh(^)g Fi(x2:)35 b(Bit)n(wise)24
b(exclusiv)n(e)f(OR)h(\(X)n(OR\))g(b)r(et)n(w)n(een)g(the)h(bits)f(of)g
Ft(")p Fi(x1)p Ft(")f Fi(and)h(those)g(of)g Ft(")p Fi(x2)p
-Ft(")f Fi(\(equiv)-5 b(alen)n(t)427 3982 y(to)28 b(a)f(b)r(o)r(olean)g
+Ft(")f Fi(\(equiv)-5 b(alen)n(t)427 1347 y(to)28 b(a)f(b)r(o)r(olean)g
(X)n(OR)g(applied)h(at)f(eac)n(h)g(bit)h(p)r(osition)g(in)g(turn\).)227
-4147 y(Note)f(that)g(no)g(bit)g(in)n(v)n(ersion)f(op)r(erator)f(\()p
+1509 y(Note)f(that)g(no)g(bit)g(in)n(v)n(ersion)f(op)r(erator)f(\()p
Ft(")p Fh(\030)p Ft(")h Fi(in)h(C\))g(is)g(pro)n(vided.)36
b(This)27 b(is)f(b)r(ecause)h(in)n(v)n(erting)f(the)h(bits)g(of)g(a)227
-4247 y(t)n(w)n(os-complemen)n(t)g(\014xed)i(p)r(oin)n(t)g(binary)f(n)n
+1609 y(t)n(w)n(os-complemen)n(t)g(\014xed)i(p)r(oin)n(t)g(binary)f(n)n
(um)n(b)r(er)g(is)h(equiv)-5 b(alen)n(t)28 b(to)h(simply)g(negating)e
-(it.)41 b(This)28 b(di\013ers)h(from)227 4347 y(the)d(pure)g(in)n
+(it.)41 b(This)28 b(di\013ers)h(from)227 1709 y(the)d(pure)g(in)n
(teger)f(case)f(b)r(ecause)i(bits)g(to)f(the)h(righ)n(t)f(of)h(the)g
(binary)f(p)r(oin)n(t)h(are)f(also)f(in)n(v)n(erted.)36
-b(T)-7 b(o)25 b(in)n(v)n(ert)g(only)227 4446 y(those)e(bits)h(to)f(the)
+b(T)-7 b(o)25 b(in)n(v)n(ert)g(only)227 1808 y(those)e(bits)h(to)f(the)
h(left)f(of)h(the)f(binary)g(p)r(oin)n(t,)h(use)f(a)g(bit)n(wise)g
(exclusiv)n(e)g(OR)g(with)h(the)f(v)-5 b(alue)23 b(-1)g(\(i.e.)36
-b Ft(")p Fi(x)p Fh(^)p Fi(-1)p Ft(")p Fi(\).)-2 4599
-y Fd(F)-8 b(unctions)n(:)227 4745 y Fi(The)28 b(follo)n(wing)e
-(functions)i(are)f(a)n(v)-5 b(ailable:)340 4885 y Fh(\017)45
+b Ft(")p Fi(x)p Fh(^)p Fi(-1)p Ft(")p Fi(\).)-2 1958
+y Fd(F)-8 b(unctions)n(:)227 2104 y Fi(The)28 b(follo)n(wing)e
+(functions)i(are)f(a)n(v)-5 b(ailable:)340 2240 y Fh(\017)45
b Fi(abs\(x\):)37 b(Absolute)28 b(v)-5 b(alue)27 b(of)h
Ft(")p Fi(x)p Ft(")e Fi(\(sign)i(remo)n(v)-5 b(al\),)26
-b(same)h(as)g(fabs\(x\).)340 5020 y Fh(\017)45 b Fi(acos\(x\):)36
+b(same)h(as)g(fabs\(x\).)340 2373 y Fh(\017)45 b Fi(acos\(x\):)36
b(In)n(v)n(erse)26 b(cosine)h(of)h Ft(")p Fi(x)p Ft(")p
-Fi(,)f(in)g(radians.)340 5155 y Fh(\017)45 b Fi(acosd\(x\):)36
+Fi(,)f(in)g(radians.)340 2506 y Fh(\017)45 b Fi(acosd\(x\):)36
b(In)n(v)n(erse)26 b(cosine)h(of)h Ft(")p Fi(x)p Ft(")p
-Fi(,)f(in)h(degrees.)340 5289 y Fh(\017)45 b Fi(acosh\(x\):)36
+Fi(,)f(in)h(degrees.)340 2638 y Fh(\017)45 b Fi(acosh\(x\):)36
b(In)n(v)n(erse)26 b(h)n(yp)r(erb)r(olic)i(cosine)e(of)i
-Ft(")p Fi(x)p Ft(")p Fi(.)340 5424 y Fh(\017)45 b Fi(acoth\(x\):)37
+Ft(")p Fi(x)p Ft(")p Fi(.)340 2771 y Fh(\017)45 b Fi(acoth\(x\):)37
b(In)n(v)n(erse)26 b(h)n(yp)r(erb)r(olic)h(cotangen)n(t)g(of)g
-Ft(")p Fi(x)p Ft(")p Fi(.)340 5558 y Fh(\017)45 b Fi(acsc)n(h\(x\):)36
+Ft(")p Fi(x)p Ft(")p Fi(.)340 2904 y Fh(\017)45 b Fi(acsc)n(h\(x\):)36
b(In)n(v)n(erse)27 b(h)n(yp)r(erb)r(olic)g(cosecan)n(t)f(of)h
-Ft(")p Fi(x)p Ft(")p Fi(.)340 5693 y Fh(\017)45 b Fi(ain)n(t\(x\):)37
+Ft(")p Fi(x)p Ft(")p Fi(.)340 3037 y Fh(\017)45 b Fi(ain)n(t\(x\):)37
b(In)n(teger)27 b(part)g(of)h Ft(")p Fi(x)p Ft(")e Fi(\(round)i(to)n(w)
-n(ards)d(zero\),)i(same)g(as)g(in)n(t\(x\).)p eop end
-%%Page: 295 305
-TeXDict begin 295 304 bop 3643 52 a FF(295)340 351 y
-Fh(\017)45 b Fi(asec)n(h\(x\):)36 b(In)n(v)n(erse)27
+n(ards)d(zero\),)i(same)g(as)g(in)n(t\(x\).)340 3170
+y Fh(\017)45 b Fi(asec)n(h\(x\):)36 b(In)n(v)n(erse)27
b(h)n(yp)r(erb)r(olic)g(secan)n(t)f(of)i Ft(")p Fi(x)p
-Ft(")p Fi(.)340 482 y Fh(\017)45 b Fi(asin\(x\):)37 b(In)n(v)n(erse)26
-b(sine)i(of)f Ft(")p Fi(x)p Ft(")p Fi(,)g(in)h(radians.)340
-613 y Fh(\017)45 b Fi(asind\(x\):)37 b(In)n(v)n(erse)26
-b(sine)i(of)f Ft(")p Fi(x)p Ft(")p Fi(,)g(in)h(degrees.)340
-744 y Fh(\017)45 b Fi(asinh\(x\):)37 b(In)n(v)n(erse)26
-b(h)n(yp)r(erb)r(olic)h(sine)h(of)f Ft(")p Fi(x)p Ft(")p
-Fi(.)340 875 y Fh(\017)45 b Fi(atan\(x\):)37 b(In)n(v)n(erse)26
-b(tangen)n(t)h(of)h Ft(")p Fi(x)p Ft(")p Fi(,)e(in)i(radians.)340
-1007 y Fh(\017)45 b Fi(atand\(x\):)37 b(In)n(v)n(erse)26
-b(tangen)n(t)h(of)h Ft(")p Fi(x)p Ft(")p Fi(,)f(in)g(degrees.)340
-1138 y Fh(\017)45 b Fi(atanh\(x\):)37 b(In)n(v)n(erse)26
-b(h)n(yp)r(erb)r(olic)h(tangen)n(t)g(of)h Ft(")p Fi(x)p
-Ft(")p Fi(.)340 1269 y Fh(\017)45 b Fi(atan2\(x1,)27
+Ft(")p Fi(.)340 3303 y Fh(\017)45 b Fi(asin\(x\):)37
+b(In)n(v)n(erse)26 b(sine)i(of)f Ft(")p Fi(x)p Ft(")p
+Fi(,)g(in)h(radians.)340 3435 y Fh(\017)45 b Fi(asind\(x\):)37
+b(In)n(v)n(erse)26 b(sine)i(of)f Ft(")p Fi(x)p Ft(")p
+Fi(,)g(in)h(degrees.)340 3568 y Fh(\017)45 b Fi(asinh\(x\):)37
+b(In)n(v)n(erse)26 b(h)n(yp)r(erb)r(olic)h(sine)h(of)f
+Ft(")p Fi(x)p Ft(")p Fi(.)340 3701 y Fh(\017)45 b Fi(atan\(x\):)37
+b(In)n(v)n(erse)26 b(tangen)n(t)h(of)h Ft(")p Fi(x)p
+Ft(")p Fi(,)e(in)i(radians.)340 3834 y Fh(\017)45 b Fi(atand\(x\):)37
+b(In)n(v)n(erse)26 b(tangen)n(t)h(of)h Ft(")p Fi(x)p
+Ft(")p Fi(,)f(in)g(degrees.)340 3967 y Fh(\017)45 b Fi(atanh\(x\):)37
+b(In)n(v)n(erse)26 b(h)n(yp)r(erb)r(olic)h(tangen)n(t)g(of)h
+Ft(")p Fi(x)p Ft(")p Fi(.)340 4099 y Fh(\017)45 b Fi(atan2\(x1,)27
b(x2\):)36 b(In)n(v)n(erse)26 b(tangen)n(t)h(of)h Ft(")p
-Fi(x1/x2)p Ft(")p Fi(,)d(in)j(radians.)340 1400 y Fh(\017)45
+Fi(x1/x2)p Ft(")p Fi(,)d(in)j(radians.)340 4232 y Fh(\017)45
b Fi(atan2d\(x1,)27 b(x2\):)36 b(In)n(v)n(erse)26 b(tangen)n(t)h(of)h
-Ft(")p Fi(x1/x2)p Ft(")p Fi(,)d(in)j(degrees.)340 1531
+Ft(")p Fi(x1/x2)p Ft(")p Fi(,)d(in)j(degrees.)340 4365
y Fh(\017)45 b Fi(ceil\(x\):)38 b(Smallest)27 b(in)n(teger)g(v)-5
b(alue)27 b(not)h(less)f(then)h Ft(")p Fi(x)p Ft(")f
Fi(\(round)g(to)n(w)n(ards)f(plus)i(in\014nit)n(y\).)340
-1662 y Fh(\017)45 b Fi(cos\(x\):)37 b(Cosine)27 b(of)g
-Ft(")p Fi(x)p Ft(")g Fi(in)h(radians.)340 1793 y Fh(\017)45
+4498 y Fh(\017)45 b Fi(cos\(x\):)37 b(Cosine)27 b(of)g
+Ft(")p Fi(x)p Ft(")g Fi(in)h(radians.)340 4631 y Fh(\017)45
b Fi(cosd\(x\):)37 b(Cosine)27 b(of)g Ft(")p Fi(x)p Ft(")g
-Fi(in)h(degrees.)340 1924 y Fh(\017)45 b Fi(cosh\(x\):)37
+Fi(in)h(degrees.)340 4763 y Fh(\017)45 b Fi(cosh\(x\):)37
b(Hyp)r(erb)r(olic)27 b(cosine)g(of)h Ft(")p Fi(x)p Ft(")p
-Fi(.)340 2055 y Fh(\017)45 b Fi(coth\(x\):)37 b(Hyp)r(erb)r(olic)28
-b(cotangen)n(t)f(of)g Ft(")p Fi(x)p Ft(")p Fi(.)340 2186
+Fi(.)340 4896 y Fh(\017)45 b Fi(coth\(x\):)37 b(Hyp)r(erb)r(olic)28
+b(cotangen)n(t)f(of)g Ft(")p Fi(x)p Ft(")p Fi(.)340 5029
y Fh(\017)45 b Fi(csc)n(h\(x\):)37 b(Hyp)r(erb)r(olic)28
-b(cosecan)n(t)e(of)h Ft(")p Fi(x)p Ft(")p Fi(.)340 2317
+b(cosecan)n(t)e(of)h Ft(")p Fi(x)p Ft(")p Fi(.)340 5162
y Fh(\017)45 b Fi(dim\(x1,)28 b(x2\):)37 b(Returns)27
b Ft(")p Fi(x1-x2)p Ft(")e Fi(if)j Ft(")p Fi(x1)p Ft(")f
Fi(is)g(greater)f(than)i Ft(")p Fi(x2)p Ft(")p Fi(,)e(otherwise)g(0.)
-340 2448 y Fh(\017)45 b Fi(exp\(x\):)37 b(Exp)r(onen)n(tial)27
-b(function)h(of)g Ft(")p Fi(x)p Ft(")p Fi(.)340 2579
+340 5295 y Fh(\017)45 b Fi(exp\(x\):)37 b(Exp)r(onen)n(tial)27
+b(function)h(of)g Ft(")p Fi(x)p Ft(")p Fi(.)340 5427
y Fh(\017)45 b Fi(fabs\(x\):)37 b(Absolute)28 b(v)-5
b(alue)28 b(of)f Ft(")p Fi(x)p Ft(")g Fi(\(sign)g(remo)n(v)-5
-b(al\),)27 b(same)g(as)g(abs\(x\).)340 2710 y Fh(\017)45
+b(al\),)27 b(same)g(as)g(abs\(x\).)340 5560 y Fh(\017)45
b Fi(\015o)r(or\(x\):)37 b(Largest)26 b(in)n(teger)g(not)i(greater)e
(than)h Ft(")p Fi(x)p Ft(")g Fi(\(round)g(to)n(w)n(ards)f(min)n(us)i
-(in\014nit)n(y\).)340 2841 y Fh(\017)45 b Fi(fmo)r(d\(x1,)28
+(in\014nit)n(y\).)340 5693 y Fh(\017)45 b Fi(fmo)r(d\(x1,)28
b(x2\):)37 b(Remainder)27 b(when)h Ft(")p Fi(x1)p Ft(")e
Fi(is)h(divided)h(b)n(y)f Ft(")p Fi(x2)p Ft(")p Fi(,)g(same)g(as)g(mo)r
-(d\(x1,)g(x2\).)340 2972 y Fh(\017)45 b Fi(gauss\(x1,)30
-b(x2\):)42 b(Random)29 b(sample)h(from)g(a)g(Gaussian)f(distribution)i
-(with)g(mean)f Ft(")p Fi(x1)p Ft(")e Fi(and)j(standard)427
-3072 y(deviation)c Ft(")p Fi(x2)p Ft(")p Fi(.)340 3203
-y Fh(\017)45 b Fi(in)n(t\(x\):)38 b(In)n(teger)26 b(part)h(of)h
-Ft(")p Fi(x)p Ft(")f Fi(\(round)g(to)n(w)n(ards)f(zero\),)h(same)g(as)g
-(ain)n(t\(x\).)340 3334 y Fh(\017)45 b Fi(isbad\(x\):)37
-b(Returns)28 b(1)f(if)h Ft(")p Fi(x)p Ft(")f Fi(has)g(the)h
-Fk(<)p Fi(bad)p Fk(>)e Fi(v)-5 b(alue)28 b(\(AST)p Ft(__)p
-Fi(BAD\),)g(otherwise)f(0.)340 3465 y Fh(\017)45 b Fi(log\(x\):)37
-b(Natural)27 b(logarithm)f(of)i Ft(")p Fi(x)p Ft(")p
-Fi(.)340 3596 y Fh(\017)45 b Fi(log10\(x\):)36 b(Logarithm)26
-b(of)i Ft(")p Fi(x)p Ft(")e Fi(to)i(base)f(10.)340 3727
-y Fh(\017)45 b Fi(max\(x1,)27 b(x2,)g(...\):)38 b(Maxim)n(um)27
-b(of)h(t)n(w)n(o)e(or)h(more)g(v)-5 b(alues.)340 3858
-y Fh(\017)45 b Fi(min\(x1,)28 b(x2,)f(...\):)37 b(Minim)n(um)29
-b(of)e(t)n(w)n(o)g(or)g(more)g(v)-5 b(alues.)340 3989
-y Fh(\017)45 b Fi(mo)r(d\(x1,)28 b(x2\):)36 b(Remainder)27
+(d\(x1,)g(x2\).)p eop end
+%%Page: 296 306
+TeXDict begin 296 305 bop 0 52 a FF(296)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Fi(gauss\(x1,)30 b(x2\):)42 b(Random)29 b(sample)h(from)g(a)g
+(Gaussian)f(distribution)i(with)g(mean)f Ft(")p Fi(x1)p
+Ft(")e Fi(and)j(standard)427 451 y(deviation)c Ft(")p
+Fi(x2)p Ft(")p Fi(.)340 586 y Fh(\017)45 b Fi(in)n(t\(x\):)38
+b(In)n(teger)26 b(part)h(of)h Ft(")p Fi(x)p Ft(")f Fi(\(round)g(to)n(w)
+n(ards)f(zero\),)h(same)g(as)g(ain)n(t\(x\).)340 721
+y Fh(\017)45 b Fi(isbad\(x\):)37 b(Returns)28 b(1)f(if)h
+Ft(")p Fi(x)p Ft(")f Fi(has)g(the)h Fk(<)p Fi(bad)p Fk(>)e
+Fi(v)-5 b(alue)28 b(\(AST)p Ft(__)p Fi(BAD\),)g(otherwise)f(0.)340
+856 y Fh(\017)45 b Fi(log\(x\):)37 b(Natural)27 b(logarithm)f(of)i
+Ft(")p Fi(x)p Ft(")p Fi(.)340 992 y Fh(\017)45 b Fi(log10\(x\):)36
+b(Logarithm)26 b(of)i Ft(")p Fi(x)p Ft(")e Fi(to)i(base)f(10.)340
+1127 y Fh(\017)45 b Fi(max\(x1,)27 b(x2,)g(...\):)38
+b(Maxim)n(um)27 b(of)h(t)n(w)n(o)e(or)h(more)g(v)-5 b(alues.)340
+1262 y Fh(\017)45 b Fi(min\(x1,)28 b(x2,)f(...\):)37
+b(Minim)n(um)29 b(of)e(t)n(w)n(o)g(or)g(more)g(v)-5 b(alues.)340
+1397 y Fh(\017)45 b Fi(mo)r(d\(x1,)28 b(x2\):)36 b(Remainder)27
b(when)h Ft(")p Fi(x1)p Ft(")e Fi(is)i(divided)g(b)n(y)f
Ft(")p Fi(x2)p Ft(")p Fi(,)f(same)h(as)g(fmo)r(d\(x1,)h(x2\).)340
-4120 y Fh(\017)45 b Fi(nin)n(t\(x\):)38 b(Nearest)27
+1532 y Fh(\017)45 b Fi(nin)n(t\(x\):)38 b(Nearest)27
b(in)n(teger)f(to)i Ft(")p Fi(x)p Ft(")f Fi(\(round)g(to)g(nearest\).)
-340 4251 y Fh(\017)45 b Fi(p)r(oisson\(x\):)37 b(Random)27
+340 1668 y Fh(\017)45 b Fi(p)r(oisson\(x\):)37 b(Random)27
b(in)n(teger-v)-5 b(alued)26 b(sample)h(from)h(a)f(P)n(oisson)e
(distribution)j(with)g(mean)g Ft(")p Fi(x)p Ft(")p Fi(.)340
-4382 y Fh(\017)45 b Fi(p)r(o)n(w\(x1,)27 b(x2\):)37 b
+1803 y Fh(\017)45 b Fi(p)r(o)n(w\(x1,)27 b(x2\):)37 b
Ft(")p Fi(x1)p Ft(")26 b Fi(raised)h(to)g(the)h(p)r(o)n(w)n(er)e(of)i
-Ft(")p Fi(x2)p Ft(")p Fi(.)340 4514 y Fh(\017)45 b Fi(qif\(x1,)28
+Ft(")p Fi(x2)p Ft(")p Fi(.)340 1938 y Fh(\017)45 b Fi(qif\(x1,)28
b(x2,)f(x3\):)37 b(Returns)27 b Ft(")p Fi(x2)p Ft(")f
Fi(if)i Ft(")p Fi(x1)p Ft(")e Fi(is)i(true,)f(and)h Ft(")p
-Fi(x3)p Ft(")e Fi(otherwise.)340 4645 y Fh(\017)45 b
+Fi(x3)p Ft(")e Fi(otherwise.)340 2073 y Fh(\017)45 b
Fi(rand\(x1,)21 b(x2\):)33 b(Random)19 b(sample)h(from)g(a)f(uniform)h
(distribution)g(in)h(the)f(range)f Ft(")p Fi(x1)p Ft(")f
-Fi(to)i Ft(")p Fi(x2)p Ft(")f Fi(inclusiv)n(e.)340 4776
+Fi(to)i Ft(")p Fi(x2)p Ft(")f Fi(inclusiv)n(e.)340 2208
y Fh(\017)45 b Fi(sec)n(h\(x\):)37 b(Hyp)r(erb)r(olic)28
-b(secan)n(t)e(of)i Ft(")p Fi(x)p Ft(")p Fi(.)340 4907
+b(secan)n(t)e(of)i Ft(")p Fi(x)p Ft(")p Fi(.)340 2343
y Fh(\017)45 b Fi(sign\(x1,)27 b(x2\):)37 b(Absolute)27
b(v)-5 b(alue)28 b(of)f Ft(")p Fi(x1)p Ft(")g Fi(with)h(the)g(sign)f
(of)g Ft(")p Fi(x2)p Ft(")f Fi(\(transfer)h(of)h(sign\).)340
-5038 y Fh(\017)45 b Fi(sin\(x\):)38 b(Sine)27 b(of)h
-Ft(")p Fi(x)p Ft(")f Fi(in)h(radians.)340 5169 y Fh(\017)45
+2479 y Fh(\017)45 b Fi(sin\(x\):)38 b(Sine)27 b(of)h
+Ft(")p Fi(x)p Ft(")f Fi(in)h(radians.)340 2614 y Fh(\017)45
b Fi(sinc\(x\):)37 b(Sinc)28 b(function)h(of)e Ft(")p
Fi(x)p Ft(")g Fi([=)g Ft(")p Fi(sin\(x\)/x)p Ft(")p Fi(].)340
-5300 y Fh(\017)45 b Fi(sind\(x\):)38 b(Sine)28 b(of)f
-Ft(")p Fi(x)p Ft(")g Fi(in)h(degrees.)340 5431 y Fh(\017)45
+2749 y Fh(\017)45 b Fi(sind\(x\):)38 b(Sine)28 b(of)f
+Ft(")p Fi(x)p Ft(")g Fi(in)h(degrees.)340 2884 y Fh(\017)45
b Fi(sinh\(x\):)38 b(Hyp)r(erb)r(olic)27 b(sine)h(of)f
-Ft(")p Fi(x)p Ft(")p Fi(.)340 5562 y Fh(\017)45 b Fi(sqr\(x\):)37
+Ft(")p Fi(x)p Ft(")p Fi(.)340 3019 y Fh(\017)45 b Fi(sqr\(x\):)37
b(Square)26 b(of)i Ft(")p Fi(x)p Ft(")f Fi(\(=)g Ft(")p
-Fi(x)p Fh(\003)p Fi(x)p Ft(")p Fi(\).)340 5693 y Fh(\017)45
+Fi(x)p Fh(\003)p Fi(x)p Ft(")p Fi(\).)340 3154 y Fh(\017)45
b Fi(sqrt\(x\):)37 b(Square)27 b(ro)r(ot)f(of)i Ft(")p
-Fi(x)p Ft(")p Fi(.)p eop end
-%%Page: 296 306
-TeXDict begin 296 305 bop 0 52 a FF(296)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
-b Fi(tan\(x\):)38 b(T)-7 b(angen)n(t)26 b(of)i Ft(")p
-Fi(x)p Ft(")f Fi(in)g(radians.)340 485 y Fh(\017)45 b
-Fi(tand\(x\):)38 b(T)-7 b(angen)n(t)27 b(of)g Ft(")p
-Fi(x)p Ft(")g Fi(in)h(degrees.)340 619 y Fh(\017)45 b
-Fi(tanh\(x\):)38 b(Hyp)r(erb)r(olic)27 b(tangen)n(t)g(of)h
-Ft(")p Fi(x)p Ft(")p Fi(.)-2 783 y Fd(Sym)m(b)s(olic)j(Constan)m(ts)n
-(:)227 929 y Fi(The)c(follo)n(wing)e(sym)n(b)r(olic)h(constan)n(ts)g
-(are)g(a)n(v)-5 b(ailable)25 b(\(the)i(enclosing)f Ft(")p
-Fk(<>)p Ft(")f Fi(brac)n(k)n(ets)f(m)n(ust)j(b)r(e)g(included\):)340
-1068 y Fh(\017)45 b Fk(<)p Fi(bad)p Fk(>)p Fi(:)51 b(The)35
+Fi(x)p Ft(")p Fi(.)340 3290 y Fh(\017)45 b Fi(tan\(x\):)38
+b(T)-7 b(angen)n(t)26 b(of)i Ft(")p Fi(x)p Ft(")f Fi(in)g(radians.)340
+3425 y Fh(\017)45 b Fi(tand\(x\):)38 b(T)-7 b(angen)n(t)27
+b(of)g Ft(")p Fi(x)p Ft(")g Fi(in)h(degrees.)340 3560
+y Fh(\017)45 b Fi(tanh\(x\):)38 b(Hyp)r(erb)r(olic)27
+b(tangen)n(t)g(of)h Ft(")p Fi(x)p Ft(")p Fi(.)-2 3727
+y Fd(Sym)m(b)s(olic)j(Constan)m(ts)n(:)227 3873 y Fi(The)c(follo)n
+(wing)e(sym)n(b)r(olic)h(constan)n(ts)g(are)g(a)n(v)-5
+b(ailable)25 b(\(the)i(enclosing)f Ft(")p Fk(<>)p Ft(")f
+Fi(brac)n(k)n(ets)f(m)n(ust)j(b)r(e)g(included\):)340
+4014 y Fh(\017)45 b Fk(<)p Fi(bad)p Fk(>)p Fi(:)51 b(The)35
b Ft(")p Fi(bad)p Ft(")e Fi(v)-5 b(alue)35 b(\(AST)p
Ft(__)p Fi(BAD\))h(used)f(to)f(\015ag)g(missing)h(data.)58
-b(Note)35 b(that)g(y)n(ou)f(cannot)427 1168 y(usefully)28
+b(Note)35 b(that)g(y)n(ou)f(cannot)427 4113 y(usefully)28
b(compare)f(v)-5 b(alues)27 b(with)i(this)f(constan)n(t)f(b)r(ecause)g
(the)i(result)e(is)h(alw)n(a)n(ys)e Fk(<)p Fi(bad)p Fk(>)p
-Fi(.)36 b(The)28 b(isbad\(\))427 1267 y(function)g(should)g(b)r(e)g
-(used)f(instead.)340 1401 y Fh(\017)45 b Fk(<)p Fi(dig)p
+Fi(.)36 b(The)28 b(isbad\(\))427 4213 y(function)g(should)g(b)r(e)g
+(used)f(instead.)340 4348 y Fh(\017)45 b Fk(<)p Fi(dig)p
Fk(>)p Fi(:)36 b(Num)n(b)r(er)28 b(of)f(decimal)h(digits)f(of)h
(precision)e(a)n(v)-5 b(ailable)27 b(in)h(a)f(\015oating)g(p)r(oin)n(t)
-g(\(double\))h(v)-5 b(alue.)340 1535 y Fh(\017)45 b Fk(<)p
+g(\(double\))h(v)-5 b(alue.)340 4483 y Fh(\017)45 b Fk(<)p
Fi(e)p Fk(>)p Fi(:)36 b(Base)27 b(of)g(natural)g(logarithms.)340
-1669 y Fh(\017)45 b Fk(<)p Fi(epsilon)p Fk(>)p Fi(:)35
+4619 y Fh(\017)45 b Fk(<)p Fi(epsilon)p Fk(>)p Fi(:)35
b(Smallest)24 b(p)r(ositiv)n(e)h(n)n(um)n(b)r(er)f(suc)n(h)h(that)g
(1.0+)p Fk(<)p Fi(epsilon)p Fk(>)d Fi(is)j(distinguishable)g(from)f
-(unit)n(y)-7 b(.)340 1803 y Fh(\017)45 b Fk(<)p Fi(man)n(t)p
+(unit)n(y)-7 b(.)340 4754 y Fh(\017)45 b Fk(<)p Fi(man)n(t)p
Ft(_)p Fi(dig)p Fk(>)p Fi(:)37 b(The)29 b(n)n(um)n(b)r(er)f(of)g(base)g
Fk(<)p Fi(radix)p Fk(>)f Fi(digits)h(stored)g(in)g(the)h(man)n(tissa)e
-(of)i(a)f(\015oating)f(p)r(oin)n(t)427 1903 y(\(double\))h(v)-5
-b(alue.)340 2036 y Fh(\017)45 b Fk(<)p Fi(max)p Fk(>)p
+(of)i(a)f(\015oating)f(p)r(oin)n(t)427 4853 y(\(double\))h(v)-5
+b(alue.)340 4989 y Fh(\017)45 b Fk(<)p Fi(max)p Fk(>)p
Fi(:)36 b(Maxim)n(um)27 b(represen)n(table)f(\015oating)h(p)r(oin)n(t)h
-(\(double\))g(v)-5 b(alue.)340 2170 y Fh(\017)45 b Fk(<)p
+(\(double\))g(v)-5 b(alue.)340 5124 y Fh(\017)45 b Fk(<)p
Fi(max)p Ft(_)p Fi(10)p Ft(_)p Fi(exp)p Fk(>)p Fi(:)37
b(Maxim)n(um)28 b(in)n(teger)h(suc)n(h)f(that)h(10)g(raised)f(to)g
(that)i(p)r(o)n(w)n(er)d(can)i(b)r(e)g(represen)n(ted)f(as)427
-2270 y(a)f(\015oating)g(p)r(oin)n(t)h(\(double\))g(v)-5
-b(alue.)340 2404 y Fh(\017)45 b Fk(<)p Fi(max)p Ft(_)p
+5223 y(a)f(\015oating)g(p)r(oin)n(t)h(\(double\))g(v)-5
+b(alue.)340 5359 y Fh(\017)45 b Fk(<)p Fi(max)p Ft(_)p
Fi(exp)p Fk(>)p Fi(:)56 b(Maxim)n(um)38 b(in)n(teger)f(suc)n(h)g(that)h
Fk(<)p Fi(radix)p Fk(>)f Fi(raised)f(to)i(that)h(p)r(o)n(w)n(er)d(min)n
-(us)i(1)g(can)f(b)r(e)427 2504 y(represen)n(ted)27 b(as)g(a)g
+(us)i(1)g(can)f(b)r(e)427 5458 y(represen)n(ted)27 b(as)g(a)g
(\015oating)g(p)r(oin)n(t)g(\(double\))h(v)-5 b(alue.)340
-2637 y Fh(\017)45 b Fk(<)p Fi(min)p Fk(>)p Fi(:)h(Smallest)32
+5593 y Fh(\017)45 b Fk(<)p Fi(min)p Fk(>)p Fi(:)h(Smallest)32
b(p)r(ositiv)n(e)f(n)n(um)n(b)r(er)h(whic)n(h)g(can)g(b)r(e)g(represen)
n(ted)f(as)h(a)f(normalised)g(\015oating)g(p)r(oin)n(t)427
-2737 y(\(double\))d(v)-5 b(alue.)340 2871 y Fh(\017)45
-b Fk(<)p Fi(min)p Ft(_)p Fi(10)p Ft(_)p Fi(exp)p Fk(>)p
-Fi(:)39 b(Minim)n(um)30 b(negativ)n(e)e(in)n(teger)h(suc)n(h)g(that)h
-(10)f(raised)f(to)i(that)f(p)r(o)n(w)n(er)g(can)g(b)r(e)h(repre-)427
-2971 y(sen)n(ted)e(as)f(a)g(normalised)f(\015oating)h(p)r(oin)n(t)h
-(\(double\))g(v)-5 b(alue.)340 3105 y Fh(\017)45 b Fk(<)p
-Fi(min)p Ft(_)p Fi(exp)p Fk(>)p Fi(:)35 b(Minim)n(um)25
+5693 y(\(double\))d(v)-5 b(alue.)p eop end
+%%Page: 297 307
+TeXDict begin 297 306 bop 3643 52 a FF(297)340 351 y
+Fh(\017)45 b Fk(<)p Fi(min)p Ft(_)p Fi(10)p Ft(_)p Fi(exp)p
+Fk(>)p Fi(:)39 b(Minim)n(um)30 b(negativ)n(e)e(in)n(teger)h(suc)n(h)g
+(that)h(10)f(raised)f(to)i(that)f(p)r(o)n(w)n(er)g(can)g(b)r(e)h
+(repre-)427 451 y(sen)n(ted)e(as)f(a)g(normalised)f(\015oating)h(p)r
+(oin)n(t)h(\(double\))g(v)-5 b(alue.)340 581 y Fh(\017)45
+b Fk(<)p Fi(min)p Ft(_)p Fi(exp)p Fk(>)p Fi(:)35 b(Minim)n(um)25
b(negativ)n(e)e(in)n(teger)h(suc)n(h)g(that)h Fk(<)p
Fi(radix)p Fk(>)e Fi(raised)h(to)g(that)h(p)r(o)n(w)n(er)e(min)n(us)i
-(1)f(can)427 3204 y(b)r(e)k(represen)n(ted)f(as)g(a)g(normalised)f
+(1)f(can)427 680 y(b)r(e)k(represen)n(ted)f(as)g(a)g(normalised)f
(\015oating)h(p)r(oin)n(t)h(\(double\))g(v)-5 b(alue.)340
-3338 y Fh(\017)45 b Fk(<)p Fi(pi)p Fk(>)p Fi(:)37 b(Ratio)27
+810 y Fh(\017)45 b Fk(<)p Fi(pi)p Fk(>)p Fi(:)37 b(Ratio)27
b(of)g(the)h(circumference)f(of)h(a)f(circle)g(to)g(its)h(diameter.)340
-3472 y Fh(\017)45 b Fk(<)p Fi(radix)p Fk(>)p Fi(:)35
-b(The)26 b(radix)g(\(n)n(um)n(b)r(er)h(base\))f(used)g(to)h(represen)n
-(t)e(the)i(man)n(tissa)e(of)i(\015oating)e(p)r(oin)n(t)i(\(double\))427
-3572 y(v)-5 b(alues.)340 3706 y Fh(\017)45 b Fk(<)p Fi(rounds)p
+940 y Fh(\017)45 b Fk(<)p Fi(radix)p Fk(>)p Fi(:)35 b(The)26
+b(radix)g(\(n)n(um)n(b)r(er)h(base\))f(used)g(to)h(represen)n(t)e(the)i
+(man)n(tissa)e(of)i(\015oating)e(p)r(oin)n(t)i(\(double\))427
+1039 y(v)-5 b(alues.)340 1169 y Fh(\017)45 b Fk(<)p Fi(rounds)p
Fk(>)p Fi(:)35 b(The)26 b(mo)r(de)g(used)g(for)f(rounding)g(\015oating)
g(p)r(oin)n(t)h(results)g(after)f(addition.)37 b(P)n(ossible)24
-b(v)-5 b(alues)427 3805 y(include:)49 b(-1)32 b(\(indeterminate\),)k(0)
+b(v)-5 b(alues)427 1268 y(include:)49 b(-1)32 b(\(indeterminate\),)k(0)
d(\(to)n(w)n(ard)f(zero\),)h(1)g(\(to)h(nearest\),)g(2)f(\(to)n(w)n
-(ard)f(plus)h(in\014nit)n(y\))h(and)f(3)427 3905 y(\(to)n(w)n(ard)27
+(ard)f(plus)h(in\014nit)n(y\))h(and)f(3)427 1368 y(\(to)n(w)n(ard)27
b(min)n(us)g(in\014nit)n(y\).)38 b(Other)27 b(v)-5 b(alues)27
b(indicate)h(mac)n(hine-dep)r(enden)n(t)f(b)r(eha)n(viour.)-2
-4069 y Fd(Ev)-5 b(aluation)32 b(Precedence)g(and)h(Asso)s(ciativit)m(y)
-n(:)227 4215 y Fi(Items)28 b(app)r(earing)e(in)i(expressions)e(are)h
+1527 y Fd(Ev)-5 b(aluation)32 b(Precedence)g(and)h(Asso)s(ciativit)m(y)
+n(:)227 1673 y Fi(Items)28 b(app)r(earing)e(in)i(expressions)e(are)h
(ev)-5 b(aluated)27 b(in)h(the)g(follo)n(wing)e(order)h(\(highest)g
-(precedence)g(\014rst\):)340 4354 y Fh(\017)45 b Fi(Constan)n(ts)27
-b(and)g(v)-5 b(ariables)340 4488 y Fh(\017)45 b Fi(F)-7
+(precedence)g(\014rst\):)340 1806 y Fh(\017)45 b Fi(Constan)n(ts)27
+b(and)g(v)-5 b(ariables)340 1936 y Fh(\017)45 b Fi(F)-7
b(unction)28 b(argumen)n(ts)f(and)g(paren)n(thesised)f(expressions)340
-4622 y Fh(\017)45 b Fi(F)-7 b(unction)28 b(in)n(v)n(o)r(cations)340
-4755 y Fh(\017)45 b Fi(Unary)27 b(+)g(-)h(!)37 b(.not.)340
-4889 y Fh(\017)45 b(\003\003)340 5023 y(\017)g(\003)27
-b Fi(/)340 5157 y Fh(\017)45 b Fi(+)28 b(-)340 5291 y
-Fh(\017)45 b Fk(<<)27 b(>>)340 5425 y Fh(\017)45 b Fk(<)28
+2065 y Fh(\017)45 b Fi(F)-7 b(unction)28 b(in)n(v)n(o)r(cations)340
+2195 y Fh(\017)45 b Fi(Unary)27 b(+)g(-)h(!)37 b(.not.)340
+2325 y Fh(\017)45 b(\003\003)340 2454 y(\017)g(\003)27
+b Fi(/)340 2584 y Fh(\017)45 b Fi(+)28 b(-)340 2714 y
+Fh(\017)45 b Fk(<<)27 b(>>)340 2843 y Fh(\017)45 b Fk(<)28
b Fi(.lt.)37 b Fk(<)p Fi(=)27 b(.le.)37 b Fk(>)27 b Fi(.gt.)37
-b Fk(>)p Fi(=)27 b(.ge.)340 5559 y Fh(\017)45 b Fi(==)27
-b(.eq.)37 b(!=)27 b(.ne.)340 5693 y Fh(\017)45 b Fi(&)p
-eop end
-%%Page: 297 307
-TeXDict begin 297 306 bop 3643 52 a FF(297)340 351 y
-Fh(\017)45 b(^)340 484 y(\017)g(j)340 616 y(\017)g Fi(&&)27
-b(.and.)340 749 y Fh(\017)45 b(^^)340 882 y(\017)g(jj)28
-b Fi(.or)340 1014 y Fh(\017)45 b Fi(.eqv.)37 b(.neqv.)g(.xor.)227
-1176 y(All)j(op)r(erators)e(asso)r(ciate)g(from)i(left-to-righ)n(t,)h
-(except)f(for)f(unary)g(+,)j(unary)d(-,)k(!,)f(.not.)73
-b(and)40 b Fh(\003\003)f Fi(whic)n(h)227 1276 y(asso)r(ciate)26
-b(from)i(righ)n(t-to-left.)p 0 1474 3780 12 v 0 1606
-a Fz(astMatrixMap)1361 1605 y Fe(Create)38 b(a)g(MatrixMap)2933
-1606 y Fz(astMatrixMap)0 1795 y Fd(Description:)44 b
-Fi(This)28 b(function)g(creates)f(a)g(new)g(MatrixMap)g(and)h
-(optionally)e(initialises)i(its)f(attributes.)227 1919
-y(A)32 b(MatrixMap)e(is)h(a)f(form)h(of)g(Mapping)g(whic)n(h)g(p)r
+b Fk(>)p Fi(=)27 b(.ge.)340 2973 y Fh(\017)45 b Fi(==)27
+b(.eq.)37 b(!=)27 b(.ne.)340 3103 y Fh(\017)45 b Fi(&)340
+3232 y Fh(\017)g(^)340 3362 y(\017)g(j)340 3492 y(\017)g
+Fi(&&)27 b(.and.)340 3621 y Fh(\017)45 b(^^)340 3751
+y(\017)g(jj)28 b Fi(.or)340 3881 y Fh(\017)45 b Fi(.eqv.)37
+b(.neqv.)g(.xor.)227 4039 y(All)j(op)r(erators)e(asso)r(ciate)g(from)i
+(left-to-righ)n(t,)h(except)f(for)f(unary)g(+,)j(unary)d(-,)k(!,)f
+(.not.)73 b(and)40 b Fh(\003\003)f Fi(whic)n(h)227 4139
+y(asso)r(ciate)26 b(from)i(righ)n(t-to-left.)p 0 4332
+3780 12 v 0 4464 a Fz(astMatrixMap)1361 4462 y Fe(Create)38
+b(a)g(MatrixMap)2933 4464 y Fz(astMatrixMap)0 4646 y
+Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g
+(MatrixMap)g(and)h(optionally)e(initialises)i(its)f(attributes.)227
+4769 y(A)32 b(MatrixMap)e(is)h(a)f(form)h(of)g(Mapping)g(whic)n(h)g(p)r
(erforms)f(a)g(general)g(linear)g(transformation.)46
-b(Eac)n(h)30 b(set)h(of)227 2019 y(input)j(co)r(ordinates,)g(regarded)d
+b(Eac)n(h)30 b(set)h(of)227 4869 y(input)j(co)r(ordinates,)g(regarded)d
(as)i(a)g(column-v)n(ector,)g(are)f(pre-m)n(ultiplied)h(b)n(y)g(a)g
-(matrix)g(\(whose)g(elemen)n(ts)227 2118 y(are)c(sp)r(eci\014ed)h(when)
+(matrix)g(\(whose)g(elemen)n(ts)227 4968 y(are)c(sp)r(eci\014ed)h(when)
g(the)g(MatrixMap)f(is)g(created\))g(to)h(giv)n(e)e(a)i(new)f(column-v)
-n(ector)f(con)n(taining)h(the)h(output)227 2218 y(co)r(ordinates.)36
+n(ector)f(con)n(taining)h(the)h(output)227 5068 y(co)r(ordinates.)36
b(If)28 b(appropriate,)e(the)i(in)n(v)n(erse)e(transformation)g(ma)n(y)
-h(also)f(b)r(e)i(p)r(erformed.)0 2367 y Fd(Synopsis:)121
+h(also)f(b)r(e)i(p)r(erformed.)0 5214 y Fd(Synopsis:)121
b Ft(AstMatrixMap)38 b Fh(\003)p Ft(astMatrixMap\()g(int)43
b(nin,)e(int)i(nout,)e(int)i(form,)e(const)h(double)f(matrix[],)227
-2467 y(const)h(char)g Fh(\003)p Ft(options,)e(...)85
-b(\))0 2616 y Fd(P)m(arameters:)259 2752 y(nin)427 2852
+5314 y(const)h(char)g Fh(\003)p Ft(options,)e(...)85
+b(\))0 5460 y Fd(P)m(arameters:)259 5593 y(nin)427 5693
y Fi(The)28 b(n)n(um)n(b)r(er)f(of)h(input)g(co)r(ordinates,)e(whic)n
(h)i(determines)f(the)h(n)n(um)n(b)r(er)g(of)f(columns)h(in)f(the)h
-(matrix.)259 2984 y Fd(nout)427 3084 y Fi(The)g(n)n(um)n(b)r(er)f(of)h
-(output)g(co)r(ordinates,)e(whic)n(h)i(determines)f(the)h(n)n(um)n(b)r
-(er)f(of)h(ro)n(ws)e(in)i(the)g(matrix.)259 3217 y Fd(form)427
-3316 y Fi(An)g(in)n(teger)f(whic)n(h)h(indicates)f(the)h(form)f(in)h
-(whic)n(h)g(the)g(matrix)f(elemen)n(ts)g(will)h(b)r(e)g(supplied.)427
-3432 y(A)g(v)-5 b(alue)27 b(of)g(zero)f(indicates)h(that)h(a)f(full)h
-Ft(")p Fi(nout)p Ft(")e Fi(x)h Ft(")p Fi(nin)p Ft(")g
-Fi(matrix)g(of)g(v)-5 b(alues)27 b(will)g(b)r(e)h(supplied)g(via)e(the)
-427 3532 y Ft(")p Fi(matrix)p Ft(")33 b Fi(parameter)g(\(b)r(elo)n
-(w\).)56 b(In)34 b(this)g(case,)h(the)g(elemen)n(ts)f(should)f(b)r(e)i
-(giv)n(en)e(in)h(ro)n(w)f(order)g(\(the)427 3632 y(elemen)n(ts)28
+(matrix.)p eop end
+%%Page: 298 308
+TeXDict begin 298 307 bop 0 52 a FF(298)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(nout)427
+451 y Fi(The)e(n)n(um)n(b)r(er)f(of)h(output)g(co)r(ordinates,)e(whic)n
+(h)i(determines)f(the)h(n)n(um)n(b)r(er)f(of)h(ro)n(ws)e(in)i(the)g
+(matrix.)259 611 y Fd(form)427 711 y Fi(An)g(in)n(teger)f(whic)n(h)h
+(indicates)f(the)h(form)f(in)h(whic)n(h)g(the)g(matrix)f(elemen)n(ts)g
+(will)h(b)r(e)g(supplied.)427 841 y(A)g(v)-5 b(alue)27
+b(of)g(zero)f(indicates)h(that)h(a)f(full)h Ft(")p Fi(nout)p
+Ft(")e Fi(x)h Ft(")p Fi(nin)p Ft(")g Fi(matrix)g(of)g(v)-5
+b(alues)27 b(will)g(b)r(e)h(supplied)g(via)e(the)427
+940 y Ft(")p Fi(matrix)p Ft(")33 b Fi(parameter)g(\(b)r(elo)n(w\).)56
+b(In)34 b(this)g(case,)h(the)g(elemen)n(ts)f(should)f(b)r(e)i(giv)n(en)
+e(in)h(ro)n(w)f(order)g(\(the)427 1040 y(elemen)n(ts)28
b(of)f(the)h(\014rst)g(ro)n(w,)e(follo)n(w)n(ed)h(b)n(y)g(the)h(elemen)
-n(ts)f(of)h(the)g(second)f(ro)n(w,)f(etc.\).)427 3748
+n(ts)f(of)h(the)g(second)f(ro)n(w,)f(etc.\).)427 1170
y(A)34 b(v)-5 b(alue)34 b(of)g(1)f(indicates)g(that)h(only)f(the)i
(diagonal)d(elemen)n(ts)h(of)h(the)g(matrix)f(will)h(b)r(e)g(supplied,)
-i(and)427 3847 y(that)26 b(all)g(others)e(should)i(b)r(e)g(zero.)35
+i(and)427 1269 y(that)26 b(all)g(others)e(should)i(b)r(e)g(zero.)35
b(In)26 b(this)g(case,)f(the)h(elemen)n(ts)g(of)f Ft(")p
Fi(matrix)p Ft(")g Fi(should)g(con)n(tain)g(only)g(the)427
-3947 y(diagonal)h(elemen)n(ts,)i(stored)f(consecutiv)n(ely)-7
-b(.)427 4063 y(A)32 b(v)-5 b(alue)32 b(of)f(2)h(indicates)f(that)h(a)f
+1369 y(diagonal)h(elemen)n(ts,)i(stored)f(consecutiv)n(ely)-7
+b(.)427 1499 y(A)32 b(v)-5 b(alue)32 b(of)f(2)h(indicates)f(that)h(a)f
Ft(")p Fi(unit)p Ft(")h Fi(matrix)f(is)g(required,)h(whose)f(diagonal)f
-(elemen)n(ts)h(are)g(set)h(to)427 4163 y(unit)n(y)f(\(with)h(all)f
+(elemen)n(ts)h(are)g(set)h(to)427 1598 y(unit)n(y)f(\(with)h(all)f
(other)f(elemen)n(ts)h(zero\).)46 b(In)32 b(this)f(case,)g(the)g
Ft(")p Fi(matrix)p Ft(")f Fi(parameter)f(is)i(ignored)f(and)h(a)427
-4262 y(NULL)d(p)r(oin)n(ter)f(ma)n(y)g(b)r(e)h(supplied.)259
-4395 y Fd(matrix)427 4495 y Fi(The)g(arra)n(y)d(of)j(matrix)f(elemen)n
+1698 y(NULL)d(p)r(oin)n(ter)f(ma)n(y)g(b)r(e)h(supplied.)259
+1858 y Fd(matrix)427 1958 y Fi(The)g(arra)n(y)d(of)j(matrix)f(elemen)n
(ts)g(to)h(b)r(e)g(used,)f(stored)g(according)f(to)h(the)h(v)-5
-b(alue)28 b(of)f Ft(")p Fi(form)p Ft(")p Fi(.)259 4627
-y Fd(options)427 4727 y Fi(P)n(oin)n(ter)g(to)h(a)g(n)n(ull-terminated)
+b(alue)28 b(of)f Ft(")p Fi(form)p Ft(")p Fi(.)259 2118
+y Fd(options)427 2218 y Fi(P)n(oin)n(ter)g(to)h(a)g(n)n(ull-terminated)
g(string)f(con)n(taining)g(an)h(optional)g(comma-separated)e(list)i(of)
-g(attribute)427 4826 y(assignmen)n(ts)i(to)g(b)r(e)h(used)g(for)f
+g(attribute)427 2317 y(assignmen)n(ts)i(to)g(b)r(e)h(used)g(for)f
(initialising)h(the)g(new)g(MatrixMap.)45 b(The)31 b(syn)n(tax)f(used)h
-(is)f(iden)n(tical)h(to)427 4926 y(that)38 b(for)e(the)i(astSet)f
+(is)f(iden)n(tical)h(to)427 2417 y(that)38 b(for)e(the)i(astSet)f
(function)h(and)f(ma)n(y)f(include)i Ft(")p Fi(prin)n(tf)p
Ft(")e Fi(format)h(sp)r(eci\014ers)g(iden)n(ti\014ed)g(b)n(y)g
-Ft(")p Fi(\045)p Ft(")427 5026 y Fi(sym)n(b)r(ols)27
-b(in)h(the)g(normal)f(w)n(a)n(y)-7 b(.)259 5158 y Fd(...)427
-5258 y Fi(If)38 b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n
+Ft(")p Fi(\045)p Ft(")427 2517 y Fi(sym)n(b)r(ols)27
+b(in)h(the)g(normal)f(w)n(a)n(y)-7 b(.)259 2677 y Fd(...)427
+2776 y Fi(If)38 b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n
(tains)f Ft(")p Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f
-(an)f(optional)g(list)h(of)f(additional)427 5358 y(argumen)n(ts)26
+(an)f(optional)g(list)h(of)f(additional)427 2876 y(argumen)n(ts)26
b(ma)n(y)h(follo)n(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5
b(alues)27 b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)
-37 b(The)427 5457 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+37 b(The)427 2976 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 5557 y Fi(function\).)0
-5718 y Fd(Returned)32 b(V)-8 b(alue:)p eop end
-%%Page: 298 308
-TeXDict begin 298 307 bop 0 52 a FF(298)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(astMatrixMap\(\))427
-451 y Fi(A)e(p)r(oin)n(ter)f(to)h(the)g(new)g(MatrixMap.)0
-628 y Fd(Notes:)340 925 y Fh(\017)45 b Fi(In)32 b(general,)e(a)h
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 3075 y Fi(function\).)0
+3292 y Fd(Returned)32 b(V)-8 b(alue:)259 3483 y(astMatrixMap\(\))427
+3582 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(MatrixMap.)0
+3799 y Fd(Notes:)340 4136 y Fh(\017)45 b Fi(In)32 b(general,)e(a)h
(MatrixMap's)f(forw)n(ard)g(transformation)f(will)j(alw)n(a)n(ys)d(b)r
(e)j(a)n(v)-5 b(ailable)30 b(\(as)h(indicated)g(b)n(y)427
-1024 y(its)h(T)-7 b(ranF)g(orw)n(ard)29 b(attribute\),)k(but)f(its)f
+4236 y(its)h(T)-7 b(ranF)g(orw)n(ard)29 b(attribute\),)k(but)f(its)f
(in)n(v)n(erse)f(transformation)g(\(T)-7 b(ranIn)n(v)n(erse)29
-b(attribute\))j(will)g(only)427 1124 y(b)r(e)c(a)n(v)-5
+b(attribute\))j(will)g(only)427 4335 y(b)r(e)c(a)n(v)-5
b(ailable)27 b(if)h(the)g(asso)r(ciated)e(matrix)h(is)g(square)g(and)g
-(non-singular.)340 1264 y Fh(\017)45 b Fi(As)32 b(an)f(exception)f(to)i
+(non-singular.)340 4495 y Fh(\017)45 b Fi(As)32 b(an)f(exception)f(to)i
(this,)g(the)g(in)n(v)n(erse)d(transformation)h(is)h(alw)n(a)n(ys)e(a)n
(v)-5 b(ailable)30 b(if)i(a)f(unit)h(or)e(diagonal)427
-1364 y(matrix)19 b(is)g(sp)r(eci\014ed.)35 b(In)19 b(this)h(case,)g(if)
+4595 y(matrix)19 b(is)g(sp)r(eci\014ed.)35 b(In)19 b(this)h(case,)g(if)
g(the)g(matrix)f(is)g(not)h(square,)f(one)g(or)g(more)f(of)i(the)g
-(input)g(co)r(ordinate)427 1463 y(v)-5 b(alues)28 b(ma)n(y)f(not)h(b)r
+(input)g(co)r(ordinate)427 4695 y(v)-5 b(alues)28 b(ma)n(y)f(not)h(b)r
(e)g(reco)n(v)n(erable)d(from)i(a)g(set)h(of)g(output)g(co)r
(ordinates.)36 b(An)n(y)28 b(co)r(ordinates)e(a\013ected)i(in)427
-1563 y(this)g(w)n(a)n(y)f(will)g(simply)h(b)r(e)g(set)g(to)f(the)h(v)-5
-b(alue)28 b(zero.)340 1703 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+4794 y(this)g(w)n(a)n(y)f(will)g(simply)h(b)r(e)g(set)g(to)f(the)h(v)-5
+b(alue)28 b(zero.)340 4954 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 1803 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)-2 1980 y Fd(Status)33
-b(Handling)n(:)227 2126 y Fi(The)d(protected)g(in)n(terface)f(to)g
+427 5054 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)-2 5271 y Fd(Status)33
+b(Handling)n(:)227 5417 y Fi(The)d(protected)g(in)n(terface)f(to)g
(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
-(of)g(the)g(parameter)227 2225 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
+(of)g(the)g(parameter)227 5516 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
-Fi(in)n(t)227 2325 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p
-0 2539 3780 12 v 0 2670 a Fz(astNegate)848 2671 y Fe(Negate)38
+Fi(in)n(t)227 5616 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p
+eop end
+%%Page: 299 309
+TeXDict begin 299 308 bop 3643 52 a FF(299)p 0 351 3780
+12 v 0 483 a Fz(astMirrorV)-11 b(arian)l(ts)212 b Fe(Mak)m(e)38
+b(the)h(curren)m(t)e(F)-10 b(rame)1428 583 y(mirror)36
+b(the)j(v)-7 b(arian)m(t)1358 682 y(Mappings)38 b(in)h(another)1730
+795 y(F)-10 b(rame)2722 483 y Fz(astMirrorV)f(arian)l(ts)0
+967 y Fd(Description:)44 b Fi(This)22 b(function)g(indicates)f(that)h
+(all)f(access)g(to)g(the)h(V)-7 b(arian)n(t)21 b(attribute)h(of)f(the)h
+(curren)n(t)f(F)-7 b(rame)21 b(should)227 1067 y(should)30
+b(b)r(e)g(forw)n(arded)f(to)g(some)h(other)f(nominated)h(F)-7
+b(rame)29 b(in)h(the)h(F)-7 b(rameSet.)43 b(F)-7 b(or)30
+b(instance,)g(if)g(a)g(v)-5 b(alue)30 b(is)227 1166 y(set)37
+b(subsequen)n(tly)f(for)f(the)i(V)-7 b(arian)n(t)36 b(attribute)g(of)g
+(the)h(curren)n(t)f(F)-7 b(rame,)38 b(the)e(curren)n(t)g(F)-7
+b(rame)36 b(will)g(b)r(e)h(left)227 1266 y(unc)n(hanged)c(and)g(the)h
+(setting)g(is)f(instead)h(applied)f(to)h(the)f(nominated)h(F)-7
+b(rame.)54 b(Lik)n(ewise,)34 b(if)g(the)g(v)-5 b(alue)34
+b(of)227 1365 y(the)28 b(V)-7 b(arian)n(t)25 b(attribute)j(is)e
+(requested,)h(the)g(v)-5 b(alue)27 b(returned)f(is)h(the)g(v)-5
+b(alue)27 b(stored)f(for)g(the)h(nominated)g(F)-7 b(rame)227
+1465 y(rather)27 b(than)h(the)g(curren)n(t)e(F)-7 b(rame)27
+b(itself.)227 1593 y(This)g(pro)n(vides)e(a)i(mec)n(hanism)f(for)g
+(propagating)f(the)i(e\013ects)g(of)g(v)-5 b(arian)n(t)26
+b(Mappings)g(around)f(a)i(F)-7 b(rameSet.)36 b(If)227
+1692 y(a)d(new)g(F)-7 b(rame)32 b(is)h(added)f(to)h(a)f(F)-7
+b(rameSet)33 b(b)n(y)f(connecting)h(it)g(to)g(an)f(pre-existing)g(F)-7
+b(rame)32 b(that)h(has)f(t)n(w)n(o)g(or)227 1792 y(more)f(v)-5
+b(arian)n(t)31 b(Mappings,)i(then)f(it)g(ma)n(y)g(b)r(e)g(appropriate)e
+(to)i(set)g(the)g(new)g(F)-7 b(rame)31 b(so)h(that)g(it)g(mirrors)e
+(the)227 1891 y(v)-5 b(arian)n(ts)32 b(Mappings)h(of)g(the)h
+(pre-existing)e(F)-7 b(rame.)53 b(If)33 b(this)h(is)f(done,)i(then)e
+(it)h(will)f(b)r(e)h(p)r(ossible)f(to)g(select)g(a)227
+1991 y(sp)r(eci\014c)28 b(v)-5 b(arian)n(t)27 b(Mapping)g(using)g
+(either)h(the)g(pre-existing)e(F)-7 b(rame)27 b(or)g(the)h(new)f(F)-7
+b(rame.)0 2146 y Fd(Synopsis:)121 b Ft(void)42 b(astMirrorVariant)o
+(s\()37 b(AstFrameSet)i Fh(\003)p Ft(this,)i(int)h(iframe,)f(int)h
+Fh(\003)p Ft(status)f(\))0 2302 y Fd(P)m(arameters:)259
+2444 y(this)427 2544 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rameSet.)259 2680 y Fd(iframe)427 2779 y Fi(The)29
+b(index)g(of)g(the)g(F)-7 b(rame)28 b(within)i(the)f(F)-7
+b(rameSet)28 b(whic)n(h)h(is)g(to)f(b)r(e)h(mirrored)f(b)n(y)g(the)h
+(curren)n(t)f(F)-7 b(rame.)427 2879 y(This)27 b(v)-5
+b(alue)26 b(should)g(lie)h(in)g(the)g(range)e(from)h(1)g(to)g(the)h(n)n
+(um)n(b)r(er)f(of)h(F)-7 b(rames)25 b(in)i(the)g(F)-7
+b(rameSet)26 b(\(as)g(giv)n(en)427 2979 y(b)n(y)c(its)g(Nframe)f
+(attribute\).)36 b(If)22 b(AST)p Ft(__)p Fi(NOFRAME)g(is)f(supplied)i
+(\(or)e(the)h(curren)n(t)f(F)-7 b(rame)21 b(is)h(sp)r(eci\014ed\),)427
+3078 y(then)28 b(an)n(y)f(mirroring)f(established)h(b)n(y)g(a)h
+(previous)e(call)h(to)h(this)g(function)g(is)f(disabled.)0
+3246 y Fd(Notes:)340 3534 y Fh(\017)45 b Fi(Mirrors)27
+b(can)i(b)r(e)g(c)n(hained.)40 b(That)29 b(is,)g(if)g(F)-7
+b(rame)28 b(B)h(is)g(set)g(to)f(b)r(e)i(a)e(mirror)f(of)i(F)-7
+b(rame)28 b(A,)i(and)e(F)-7 b(rame)29 b(C)427 3634 y(is)f(set)f(to)h(b)
+r(e)g(a)f(mirror)f(of)i(F)-7 b(rame)27 b(B,)g(then)h(F)-7
+b(rame)27 b(C)h(will)g(act)f(as)g(a)g(mirror)f(of)i(F)-7
+b(rame)27 b(A.)340 3770 y Fh(\017)45 b Fi(V)-7 b(arian)n(t)24
+b(Mappings)h(cannot)g(b)r(e)g(added)g(to)g(the)g(curren)n(t)g(F)-7
+b(rame)24 b(if)i(it)f(is)g(mirroring)e(another)h(F)-7
+b(rame.)36 b(So)427 3870 y(calls)26 b(to)f(the)i(astAddV)-7
+b(arian)n(t)25 b(function)h(will)g(cause)g(an)f(error)f(to)i(b)r(e)g
+(rep)r(orted)g(if)g(the)g(curren)n(t)f(F)-7 b(rame)26
+b(is)427 3969 y(mirroring)g(another)h(F)-7 b(rame.)340
+4105 y Fh(\017)45 b Fi(A)26 b(v)-5 b(alue)26 b(of)g(AST)p
+Ft(__)p Fi(BASE)f(ma)n(y)f(b)r(e)j(giv)n(en)d(for)i(the)g
+Ft(")p Fi(iframe)p Ft(")e Fi(parameter)g(to)i(sp)r(ecify)g(the)g(base)f
+(F)-7 b(rame.)340 4241 y Fh(\017)45 b Fi(An)n(y)36 b(v)-5
+b(arian)n(t)35 b(Mappings)h(explicitly)g(added)g(to)g(the)g(curren)n(t)
+f(F)-7 b(rame)36 b(using)g(astAddV)-7 b(arian)n(t)35
+b(will)h(b)r(e)427 4340 y(ignored)27 b(if)h(the)g(curren)n(t)f(F)-7
+b(rame)27 b(is)g(mirroring)f(another)g(F)-7 b(rame.)p
+0 4546 V 0 4676 a Fz(astNegate)848 4677 y Fe(Negate)38
b(the)g(area)g(represen)m(ted)f(b)m(y)i(a)g(Region)3196
-2670 y Fz(astNegate)0 2874 y Fd(Description:)44 b Fi(This)d(function)f
+4676 y Fz(astNegate)0 4872 y Fd(Description:)44 b Fi(This)d(function)f
(negates)g(the)g(area)f(represen)n(ted)g(b)n(y)h(a)g(Region.)74
b(That)40 b(is,)j(p)r(oin)n(ts)d(whic)n(h)h(w)n(ere)227
-2974 y(previously)22 b(inside)h(the)h(region)e(will)h(then)h(b)r(e)f
+4972 y(previously)22 b(inside)h(the)h(region)e(will)h(then)h(b)r(e)f
(outside,)h(and)f(p)r(oin)n(ts)g(whic)n(h)g(w)n(ere)f(outside)h(will)h
-(b)r(e)f(inside.)36 b(This)227 3073 y(is)28 b(acomplished)f(b)n(y)g
+(b)r(e)f(inside.)36 b(This)227 5071 y(is)28 b(acomplished)f(b)n(y)g
(toggling)f(the)i(state)g(of)f(the)h(Negated)f(attribute)h(for)f(the)h
-(supplied)g(region.)0 3237 y Fd(Synopsis:)121 b Ft(void)42
+(supplied)g(region.)0 5227 y Fd(Synopsis:)121 b Ft(void)42
b(astNegate\()d(AstRegion)h Fh(\003)p Ft(this)i(\))0
-3402 y Fd(P)m(arameters:)259 3553 y(this)427 3652 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(Region.)p 0 3866 V 0 3997 a Fz(astNorm)937
-3998 y Fe(Normalise)36 b(a)j(set)f(of)h(F)-10 b(rame)38
-b(co)s(ordinates)3269 3997 y Fz(astNorm)0 4178 y Fd(Description:)44
-b Fi(This)29 b(function)g(normalises)e(a)h(set)h(of)f(F)-7
-b(rame)28 b(co)r(ordinate)f(v)-5 b(alues)29 b(whic)n(h)f(migh)n(t)h(b)r
-(e)f(unsuitable)h(for)227 4278 y(displa)n(y)23 b(\(e.g.)35
-b(ma)n(y)22 b(lie)h(outside)g(the)h(exp)r(ected)f(range\))f(in)n(to)h
-(a)g(set)g(of)g(acceptable)f(v)-5 b(alues)23 b(suitable)g(for)f(displa)
-n(y)-7 b(.)0 4442 y Fd(Synopsis:)121 b Ft(void)42 b(astNorm\()e
-(AstFrame)g Fh(\003)p Ft(this,)h(double)g(value[])g(\))0
-4606 y Fd(P)m(arameters:)259 4757 y(this)427 4857 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(F)-7 b(rame.)259 4997 y Fd(v)i(alue)427
-5097 y Fi(An)33 b(arra)n(y)c(of)j(double,)h(with)g(one)e(elemen)n(t)h
-(for)g(eac)n(h)f(F)-7 b(rame)31 b(axis)g(\(Naxes)h(attribute\).)50
-b(Initially)-7 b(,)33 b(this)427 5197 y(should)c(con)n(tain)g(a)f(set)h
-(of)g(co)r(ordinate)f(v)-5 b(alues)29 b(represen)n(ting)f(a)g(p)r(oin)n
-(t)h(in)h(the)f(space)g(whic)n(h)g(the)g(F)-7 b(rame)427
-5296 y(describ)r(es.)38 b(If)28 b(these)g(v)-5 b(alues)28
+5382 y Fd(P)m(arameters:)259 5524 y(this)427 5624 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(Region.)p eop end
+%%Page: 300 310
+TeXDict begin 300 309 bop 0 52 a FF(300)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 482 a Fz(astNorm)937 483 y Fe(Normalise)36 b(a)j(set)f(of)h(F)-10
+b(rame)38 b(co)s(ordinates)3269 482 y Fz(astNorm)0 629
+y Fd(Description:)44 b Fi(This)29 b(function)g(normalises)e(a)h(set)h
+(of)f(F)-7 b(rame)28 b(co)r(ordinate)f(v)-5 b(alues)29
+b(whic)n(h)f(migh)n(t)h(b)r(e)f(unsuitable)h(for)227
+729 y(displa)n(y)23 b(\(e.g.)35 b(ma)n(y)22 b(lie)h(outside)g(the)h
+(exp)r(ected)f(range\))f(in)n(to)h(a)g(set)g(of)g(acceptable)f(v)-5
+b(alues)23 b(suitable)g(for)f(displa)n(y)-7 b(.)0 869
+y Fd(Synopsis:)121 b Ft(void)42 b(astNorm\()e(AstFrame)g
+Fh(\003)p Ft(this,)h(double)g(value[])g(\))0 1008 y Fd(P)m(arameters:)
+259 1135 y(this)427 1235 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rame.)259 1358 y Fd(v)i(alue)427 1458 y Fi(An)33 b(arra)n(y)c(of)j
+(double,)h(with)g(one)e(elemen)n(t)h(for)g(eac)n(h)f(F)-7
+b(rame)31 b(axis)g(\(Naxes)h(attribute\).)50 b(Initially)-7
+b(,)33 b(this)427 1557 y(should)c(con)n(tain)g(a)f(set)h(of)g(co)r
+(ordinate)f(v)-5 b(alues)29 b(represen)n(ting)f(a)g(p)r(oin)n(t)h(in)h
+(the)f(space)g(whic)n(h)g(the)g(F)-7 b(rame)427 1657
+y(describ)r(es.)38 b(If)28 b(these)g(v)-5 b(alues)28
b(lie)g(outside)f(the)i(exp)r(ected)f(range)f(for)g(the)h(F)-7
-b(rame,)28 b(they)g(will)g(b)r(e)g(replaced)427 5396
+b(rame,)28 b(they)g(will)g(b)r(e)g(replaced)427 1756
y(with)g(more)f(acceptable)g(\(normalised\))g(v)-5 b(alues.)37
b(Otherwise,)26 b(they)i(will)g(b)r(e)g(returned)f(unc)n(hanged.)0
-5572 y Fd(Notes:)p eop end
-%%Page: 299 309
-TeXDict begin 299 308 bop 3643 52 a FF(299)340 351 y
-Fh(\017)45 b Fi(F)-7 b(or)34 b(some)f(classes)g(of)h(F)-7
-b(rame,)36 b(whose)d(co)r(ordinate)g(v)-5 b(alues)34
-b(are)f(not)h(constrained,)h(this)g(function)f(will)427
-451 y(nev)n(er)d(mo)r(dify)h(the)g(v)-5 b(alues)31 b(supplied.)49
+1909 y Fd(Notes:)340 2182 y Fh(\017)45 b Fi(F)-7 b(or)34
+b(some)f(classes)g(of)h(F)-7 b(rame,)36 b(whose)d(co)r(ordinate)g(v)-5
+b(alues)34 b(are)f(not)h(constrained,)h(this)g(function)f(will)427
+2281 y(nev)n(er)d(mo)r(dify)h(the)g(v)-5 b(alues)31 b(supplied.)49
b(Ho)n(w)n(ev)n(er,)31 b(for)g(F)-7 b(rames)30 b(whose)h(axes)g
-(represen)n(t)f(cyclic)h(quan)n(ti-)427 551 y(ties)i(\(suc)n(h)f(as)f
+(represen)n(t)f(cyclic)h(quan)n(ti-)427 2381 y(ties)i(\(suc)n(h)f(as)f
(angles)h(or)f(p)r(ositions)h(on)g(the)g(sky\),)h(co)r(ordinates)e
(will)i(t)n(ypically)e(b)r(e)i(wrapp)r(ed)f(in)n(to)g(an)427
-650 y(appropriate)26 b(standard)h(range,)f(suc)n(h)h(as)g(zero)g(to)g
-(2)p Fh(\003)p Fi(pi.)340 791 y Fh(\017)45 b Fi(The)31
+2480 y(appropriate)26 b(standard)h(range,)f(suc)n(h)h(as)g(zero)g(to)g
+(2)p Fh(\003)p Fi(pi.)340 2604 y Fh(\017)45 b Fi(The)31
b(NormMap)e(class)h(is)g(a)g(Mapping)f(whic)n(h)i(can)f(b)r(e)g(used)h
(to)f(normalise)f(a)h(set)g(of)g(p)r(oin)n(ts)g(using)g(the)427
-891 y(astNorm)d(function)h(of)g(a)f(sp)r(eci\014ed)h(F)-7
-b(rame.)340 1031 y Fh(\017)45 b Fi(It)28 b(is)f(in)n(tended)h(to)g(b)r
+2703 y(astNorm)d(function)h(of)g(a)f(sp)r(eci\014ed)h(F)-7
+b(rame.)340 2826 y Fh(\017)45 b Fi(It)28 b(is)f(in)n(tended)h(to)g(b)r
(e)f(p)r(ossible)h(to)f(put)h(an)n(y)f(set)g(of)h(co)r(ordinates)e(in)n
(to)h(a)g(form)g(suitable)g(for)g(displa)n(y)g(b)n(y)427
-1131 y(using)d(this)h(function)g(to)f(normalise)f(them,)i(follo)n(w)n
+2926 y(using)d(this)h(function)g(to)f(normalise)f(them,)i(follo)n(w)n
(ed)f(b)n(y)g(appropriate)e(formatting)i(\(using)g(astF)-7
-b(ormat\).)p 0 1346 3780 12 v 0 1477 a Fz(astNormMap)615
-b Fe(Create)37 b(a)i(NormMap)613 b Fz(astNormMap)0 1682
-y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g
+b(ormat\).)p 0 3106 V 0 3237 a Fz(astNormMap)1392 3236
+y Fe(Create)37 b(a)i(NormMap)3002 3237 y Fz(astNormMap)0
+3406 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g
(NormMap)g(and)h(optionally)e(initialises)i(its)g(attributes.)227
-1814 y(A)i(NormMap)f(is)h(a)f(Mapping)g(whic)n(h)h(normalises)e(co)r
+3526 y(A)i(NormMap)f(is)h(a)f(Mapping)g(whic)n(h)h(normalises)e(co)r
(ordinate)h(v)-5 b(alues)29 b(using)g(the)i(astNorm)d(function)j(of)e
-(the)227 1914 y(supplied)g(F)-7 b(rame.)39 b(The)29 b(n)n(um)n(b)r(er)f
+(the)227 3625 y(supplied)g(F)-7 b(rame.)39 b(The)29 b(n)n(um)n(b)r(er)f
(of)g(inputs)h(and)f(outputs)h(of)g(a)f(NormMap)f(are)h(b)r(oth)h
-(equal)f(to)g(the)h(n)n(um)n(b)r(er)227 2013 y(of)f(axes)e(in)i(the)g
-(supplied)g(F)-7 b(rame.)227 2146 y(The)34 b(forw)n(ard)e(and)h(in)n(v)
+(equal)f(to)g(the)h(n)n(um)n(b)r(er)227 3725 y(of)f(axes)e(in)i(the)g
+(supplied)g(F)-7 b(rame.)227 3845 y(The)34 b(forw)n(ard)e(and)h(in)n(v)
n(erse)f(transformation)g(of)i(a)f(NormMap)g(are)f(b)r(oth)i(de\014ned)
-g(but)g(are)f(iden)n(tical)g(\(that)227 2246 y(is,)43
+g(but)g(are)f(iden)n(tical)g(\(that)227 3944 y(is,)43
b(they)c(do)g(not)h(form)f(a)g(real)g(in)n(v)n(erse)f(pair)g(in)i(that)
g(the)g(in)n(v)n(erse)d(transformation)h(do)r(es)h(not)h(undo)f(the)227
-2345 y(normalisation,)24 b(instead)h(it)h(reapplies)e(it\).)36
+4044 y(normalisation,)24 b(instead)h(it)h(reapplies)e(it\).)36
b(Ho)n(w)n(ev)n(er,)24 b(the)h(astSimplify)h(function)g(will)f(replace)
-f(neigh)n(b)r(ouring)227 2445 y(pairs)j(of)g(forw)n(ard)f(and)i(in)n(v)
-n(erse)e(NormMaps)h(b)n(y)g(a)g(single)g(UnitMap.)0 2610
+f(neigh)n(b)r(ouring)227 4144 y(pairs)j(of)g(forw)n(ard)f(and)i(in)n(v)
+n(erse)e(NormMaps)h(b)n(y)g(a)g(single)g(UnitMap.)0 4283
y Fd(Synopsis:)121 b Ft(AstNormMap)39 b Fh(\003)p Ft(astNormMap\()g
(AstFrame)h Fh(\003)p Ft(frame,)h(const)g(char)h Fh(\003)p
-Ft(options,)e(...)86 b(\))0 2776 y Fd(P)m(arameters:)259
-2928 y(frame)427 3028 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(F)-7
+Ft(options,)e(...)86 b(\))0 4423 y Fd(P)m(arameters:)259
+4550 y(frame)427 4650 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(F)-7
b(rame)27 b(whic)n(h)g(is)h(to)f(b)r(e)h(used)g(to)f(normalise)g(the)h
-(supplied)g(axis)e(v)-5 b(alues.)259 3168 y Fd(options)427
-3268 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n(ull-terminated)g(string)f
+(supplied)g(axis)e(v)-5 b(alues.)259 4773 y Fd(options)427
+4872 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n(ull-terminated)g(string)f
(con)n(taining)g(an)h(optional)g(comma-separated)e(list)i(of)g
-(attribute)427 3368 y(assignmen)n(ts)21 b(to)g(b)r(e)h(used)g(for)f
+(attribute)427 4972 y(assignmen)n(ts)21 b(to)g(b)r(e)h(used)g(for)f
(initialising)g(the)h(new)g(NormMap.)34 b(The)22 b(syn)n(tax)e(used)i
-(is)f(iden)n(tical)h(to)f(that)427 3467 y(for)26 b(the)h(astSet)g
+(is)f(iden)n(tical)h(to)f(that)427 5072 y(for)26 b(the)h(astSet)g
(function)g(and)g(ma)n(y)f(include)h Ft(")p Fi(prin)n(tf)p
Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n(ti\014ed)h(b)n(y)f
-Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427 3567 y(in)i(the)g(normal)f
-(w)n(a)n(y)-7 b(.)259 3708 y Fd(...)427 3807 y Fi(If)38
+Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427 5171 y(in)i(the)g(normal)f
+(w)n(a)n(y)-7 b(.)259 5295 y Fd(...)427 5394 y Fi(If)38
b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n(tains)f
Ft(")p Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f
-(optional)g(list)h(of)f(additional)427 3907 y(argumen)n(ts)26
+(optional)g(list)h(of)f(additional)427 5494 y(argumen)n(ts)26
b(ma)n(y)h(follo)n(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5
b(alues)27 b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)
-37 b(The)427 4007 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+37 b(The)427 5593 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 4106 y Fi(function\).)0
-4284 y Fd(Returned)32 b(V)-8 b(alue:)259 4436 y(astNormMap\(\))427
-4536 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(NormMap.)0
-4714 y Fd(Notes:)340 5012 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
-b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
-(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 5112 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)-2 5290 y Fd(Status)33
-b(Handling)n(:)227 5436 y Fi(The)d(protected)g(in)n(terface)f(to)g
-(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
-(of)g(the)g(parameter)227 5536 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
-(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
-(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
-Fi(in)n(t)227 5635 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 5693 y Fi(function\).)p
eop end
-%%Page: 300 310
-TeXDict begin 300 309 bop 0 52 a FF(300)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 483 a Fz(astNullRegion)536 b Fe(Create)37 b(a)i(NullRegion)531
-b Fz(astNullRegion)0 713 y Fd(Description:)44 b Fi(This)28
+%%Page: 301 311
+TeXDict begin 301 310 bop 3643 52 a FF(301)0 351 y Fd(Returned)32
+b(V)-8 b(alue:)259 486 y(astNormMap\(\))427 585 y Fi(A)28
+b(p)r(oin)n(ter)f(to)h(the)g(new)g(NormMap.)0 745 y Fd(Notes:)340
+1026 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
+b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g
+(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427
+1125 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
+(for)f(an)n(y)g(reason.)-2 1285 y Fd(Status)33 b(Handling)n(:)227
+1431 y Fi(The)d(protected)g(in)n(terface)f(to)g(this)h(function)h
+(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g(the)g
+(parameter)227 1531 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62
+b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)
+e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fi(in)n(t)227
+1630 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p 0 1826 3780
+12 v 0 1957 a Fz(astNullRegion)536 b Fe(Create)37 b(a)i(NullRegion)531
+b Fz(astNullRegion)0 2142 y Fd(Description:)44 b Fi(This)28
b(function)g(creates)f(a)g(new)g(NullRegion)h(and)f(optionally)g
-(initialises)g(its)h(attributes.)227 859 y(A)k(NullRegion)f(is)f(a)h
+(initialises)g(its)h(attributes.)227 2266 y(A)k(NullRegion)f(is)f(a)h
(Region)g(with)g(no)g(b)r(ounds.)47 b(If)32 b(the)f(Negated)g
(attribute)g(of)g(a)g(NullRegion)g(is)g(false,)g(the)227
-958 y(NullRegion)k(represen)n(ts)f(a)g(Region)g(con)n(taining)g(no)h(p)
-r(oin)n(ts.)59 b(If)35 b(the)h(Negated)e(attribute)h(of)g(a)g
-(NullRegion)227 1058 y(is)f(true,)h(the)f(NullRegion)f(represen)n(ts)f
+2365 y(NullRegion)k(represen)n(ts)f(a)g(Region)g(con)n(taining)g(no)h
+(p)r(oin)n(ts.)59 b(If)35 b(the)h(Negated)e(attribute)h(of)g(a)g
+(NullRegion)227 2465 y(is)f(true,)h(the)f(NullRegion)f(represen)n(ts)f
(an)h(in\014nite)i(Region)d(con)n(taining)h(all)g(p)r(oin)n(ts)h
-(within)g(the)g(co)r(ordinate)227 1158 y(system.)0 1349
+(within)g(the)g(co)r(ordinate)227 2564 y(system.)0 2712
y Fd(Synopsis:)121 b Ft(AstNullRegion)38 b Fh(\003)p
Ft(astNullRegion\()f(AstFrame)k Fh(\003)p Ft(frame,)f(AstRegion)g
Fh(\003)p Ft(unc,)i(const)f(char)h Fh(\003)p Ft(options,)227
-1448 y(...)86 b(\))0 1640 y Fd(P)m(arameters:)259 1818
-y(frame)427 1917 y Fi(A)29 b(p)r(oin)n(ter)g(to)f(the)i(F)-7
+2811 y(...)86 b(\))0 2959 y Fd(P)m(arameters:)259 3093
+y(frame)427 3193 y Fi(A)29 b(p)r(oin)n(ter)g(to)f(the)i(F)-7
b(rame)28 b(in)h(whic)n(h)g(the)g(region)e(is)i(de\014ned.)41
b(A)29 b(deep)g(cop)n(y)f(is)g(tak)n(en)g(of)h(the)g(supplied)427
-2017 y(F)-7 b(rame.)71 b(This)39 b(means)f(that)h(an)n(y)g(subsequen)n
+3292 y(F)-7 b(rame.)71 b(This)39 b(means)f(that)h(an)n(y)g(subsequen)n
(t)f(c)n(hanges)g(made)h(to)f(the)i(F)-7 b(rame)38 b(using)h(the)g
-(supplied)427 2117 y(p)r(oin)n(ter)27 b(will)h(ha)n(v)n(e)f(no)g
-(e\013ect)h(the)g(Region.)259 2270 y Fd(unc)427 2370
+(supplied)427 3392 y(p)r(oin)n(ter)27 b(will)h(ha)n(v)n(e)f(no)g
+(e\013ect)h(the)g(Region.)259 3523 y Fd(unc)427 3623
y Fi(An)33 b(optional)e(p)r(oin)n(ter)h(to)g(an)g(existing)g(Region)f
(whic)n(h)h(sp)r(eci\014es)g(the)h(uncertain)n(ties)e(asso)r(ciated)g
-(with)427 2469 y(p)r(ositions)37 b(in)h(the)g(supplied)g(F)-7
+(with)427 3722 y(p)r(ositions)37 b(in)h(the)g(supplied)g(F)-7
b(rame.)65 b(The)38 b(uncertain)n(t)n(y)e(in)i(an)n(y)f(p)r(oin)n(t)g
-(in)h(the)g(F)-7 b(rame)37 b(is)g(found)h(b)n(y)427 2569
+(in)h(the)g(F)-7 b(rame)37 b(is)g(found)h(b)n(y)427 3822
y(shifting)25 b(the)f(supplied)g Ft(")p Fi(uncertain)n(t)n(y)p
Ft(")f Fi(Region)g(so)g(that)h(it)h(is)f(cen)n(tred)f(at)h(the)g(p)r
-(oin)n(t)g(b)r(eing)h(considered.)427 2669 y(The)34 b(area)e(co)n(v)n
+(oin)n(t)g(b)r(eing)h(considered.)427 3921 y(The)34 b(area)e(co)n(v)n
(ered)g(b)n(y)i(the)g(shifted)g(uncertain)n(t)n(y)f(Region)g(then)i
(represen)n(ts)d(the)i(uncertain)n(t)n(y)f(in)h(the)427
-2768 y(p)r(osition.)j(The)28 b(uncertain)n(t)n(y)e(is)i(assumed)f(to)g
-(b)r(e)h(the)g(same)f(for)g(all)h(p)r(oin)n(ts.)427 2895
+4021 y(p)r(osition.)j(The)28 b(uncertain)n(t)n(y)e(is)i(assumed)f(to)g
+(b)r(e)h(the)g(same)f(for)g(all)h(p)r(oin)n(ts.)427 4136
y(If)38 b(supplied,)j(the)d(uncertain)n(t)n(y)f(Region)g(m)n(ust)g(b)r
(e)i(of)e(a)g(class)g(for)g(whic)n(h)h(all)f(instances)g(are)g(cen)n
-(tro-)427 2995 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24
+(tro-)427 4236 y(symetric)24 b(\(e.g.)35 b(Bo)n(x,)24
b(Circle,)g(Ellipse,)h(etc.\))36 b(or)23 b(b)r(e)i(a)e(Prism)h(con)n
-(taining)f(cen)n(tro-symetric)f(comp)r(onen)n(t)427 3094
+(taining)f(cen)n(tro-symetric)f(comp)r(onen)n(t)427 4336
y(Regions.)57 b(A)35 b(deep)f(cop)n(y)g(of)g(the)h(supplied)g(Region)f
(will)g(b)r(e)h(tak)n(en,)h(so)e(subsequen)n(t)g(c)n(hanges)f(to)h(the)
-427 3194 y(uncertain)n(t)n(y)28 b(Region)f(using)h(the)h(supplied)f(p)r
+427 4435 y(uncertain)n(t)n(y)28 b(Region)f(using)h(the)h(supplied)f(p)r
(oin)n(ter)g(will)h(ha)n(v)n(e)e(no)h(e\013ect)h(on)f(the)g(created)g
-(Bo)n(x.)38 b(Alter-)427 3294 y(nativ)n(ely)-7 b(,)25
+(Bo)n(x.)38 b(Alter-)427 4535 y(nativ)n(ely)-7 b(,)25
b(a)e(NULL)i(Ob)5 b(ject)24 b(p)r(oin)n(ter)f(ma)n(y)h(b)r(e)g
(supplied,)i(in)e(whic)n(h)g(case)f(a)h(default)g(uncertain)n(t)n(y)g
-(of)g(zero)427 3393 y(is)k(used.)259 3547 y Fd(options)427
-3646 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n(ull-terminated)g(string)f(con)n
+(of)g(zero)427 4634 y(is)k(used.)259 4765 y Fd(options)427
+4865 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n(ull-terminated)g(string)f(con)n
(taining)g(an)h(optional)g(comma-separated)e(list)i(of)g(attribute)427
-3746 y(assignmen)n(ts)i(to)h(b)r(e)h(used)f(for)g(initialising)g(the)h
+4964 y(assignmen)n(ts)i(to)h(b)r(e)h(used)f(for)g(initialising)g(the)h
(new)f(NullRegion.)48 b(The)31 b(syn)n(tax)f(used)i(is)f(iden)n(tical)g
-(to)427 3846 y(that)38 b(for)e(the)i(astSet)f(function)h(and)f(ma)n(y)f
+(to)427 5064 y(that)38 b(for)e(the)i(astSet)f(function)h(and)f(ma)n(y)f
(include)i Ft(")p Fi(prin)n(tf)p Ft(")e Fi(format)h(sp)r(eci\014ers)g
(iden)n(ti\014ed)g(b)n(y)g Ft(")p Fi(\045)p Ft(")427
-3945 y Fi(sym)n(b)r(ols)27 b(in)h(the)g(normal)f(w)n(a)n(y)-7
-b(.)259 4099 y Fd(...)427 4199 y Fi(If)38 b(the)g Ft(")p
+5164 y Fi(sym)n(b)r(ols)27 b(in)h(the)g(normal)f(w)n(a)n(y)-7
+b(.)259 5295 y Fd(...)427 5394 y Fi(If)38 b(the)g Ft(")p
Fi(options)p Ft(")e Fi(string)h(con)n(tains)f Ft(")p
Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g
-(list)h(of)f(additional)427 4298 y(argumen)n(ts)26 b(ma)n(y)h(follo)n
+(list)h(of)f(additional)427 5494 y(argumen)n(ts)26 b(ma)n(y)h(follo)n
(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5 b(alues)27
b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)37
-b(The)427 4398 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+b(The)427 5593 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 4498 y Fi(function\).)0
-4701 y Fd(Returned)32 b(V)-8 b(alue:)259 4879 y(astNullRegion\(\))427
-4979 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(NullRegion.)0
-5182 y Fd(Notes:)340 5507 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 5693 y Fi(function\).)p
+eop end
+%%Page: 302 312
+TeXDict begin 302 311 bop 0 52 a FF(302)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Returned)i(V)-8
+b(alue:)259 484 y(astNullRegion\(\))427 583 y Fi(A)28
+b(p)r(oin)n(ter)f(to)h(the)g(new)g(NullRegion.)0 741
+y Fd(Notes:)340 1020 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 5606 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p eop end
-%%Page: 301 311
-TeXDict begin 301 310 bop 3643 52 a FF(301)p 0 351 3780
-12 v 0 482 a Fz(astOK)627 483 y Fe(T)-10 b(est)38 b(whether)g(AST)g
-(functions)g(ha)m(v)m(e)g(b)s(een)h(successful)3402 482
-y Fz(astOK)0 654 y Fd(Description:)44 b Fi(This)29 b(macro)f(returns)g
-(a)h(b)r(o)r(olean)f(v)-5 b(alue)29 b(\(0)g(or)f(1\))h(to)g(indicate)g
-(if)h(preceding)e(AST)h(functions)h(ha)n(v)n(e)227 754
-y(completed)f(successfully)g(\(i.e.)41 b(without)29 b(setting)g(the)g
-(AST)g(error)e(status\).)41 b(If)29 b(the)g(error)e(status)i(is)f(set)h
-(to)g(an)227 853 y(error)d(v)-5 b(alue,)27 b(a)h(v)-5
-b(alue)27 b(of)h(zero)e(is)i(returned,)f(otherwise)g(the)h(result)f(is)
-g(one.)0 1003 y Fd(Synopsis:)121 b Ft(int)42 b(astOK)0
-1154 y Fd(Returned)32 b(V)-8 b(alue:)259 1291 y(astOK)427
-1391 y Fi(One)28 b(if)g(the)g(AST)g(error)d(status)j(is)f(OK,)g
-(otherwise)g(zero.)0 1553 y Fd(Notes:)340 1837 y Fh(\017)45
-b Fi(If)28 b(the)g(AST)g(error)d(status)i(is)h(set)f(to)g(an)g(error)f
-(v)-5 b(alue)27 b(\(after)g(an)g(error\),)f(most)h(AST)h(functions)g
-(will)g(not)427 1936 y(execute)h(and)g(will)h(simply)f(return)g
-(without)g(action.)41 b(T)-7 b(o)29 b(clear)f(the)i(error)d(status)i
-(and)g(restore)f(normal)427 2036 y(b)r(eha)n(viour,)f(use)g
-(astClearStatus.)p 0 2236 V 0 2368 a Fz(astO\013set)308
-b Fe(Calculate)36 b(an)i(o\013set)h(along)e(a)i(geo)s(desic)f(curv)m(e)
-305 b Fz(astO\013set)0 2557 y Fd(Description:)44 b Fi(This)c(function)f
+427 1119 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 1310 3780 12 v 0 1441
+a Fz(astOK)627 1442 y Fe(T)-10 b(est)38 b(whether)g(AST)g(functions)g
+(ha)m(v)m(e)g(b)s(een)h(successful)3402 1441 y Fz(astOK)0
+1604 y Fd(Description:)44 b Fi(This)29 b(macro)f(returns)g(a)h(b)r(o)r
+(olean)f(v)-5 b(alue)29 b(\(0)g(or)f(1\))h(to)g(indicate)g(if)h
+(preceding)e(AST)h(functions)h(ha)n(v)n(e)227 1704 y(completed)f
+(successfully)g(\(i.e.)41 b(without)29 b(setting)g(the)g(AST)g(error)e
+(status\).)41 b(If)29 b(the)g(error)e(status)i(is)f(set)h(to)g(an)227
+1804 y(error)d(v)-5 b(alue,)27 b(a)h(v)-5 b(alue)27 b(of)h(zero)e(is)i
+(returned,)f(otherwise)g(the)h(result)f(is)g(one.)0 1949
+y Fd(Synopsis:)121 b Ft(int)42 b(astOK)0 2094 y Fd(Returned)32
+b(V)-8 b(alue:)259 2227 y(astOK)427 2326 y Fi(One)28
+b(if)g(the)g(AST)g(error)d(status)j(is)f(OK,)g(otherwise)g(zero.)0
+2484 y Fd(Notes:)340 2763 y Fh(\017)45 b Fi(If)28 b(the)g(AST)g(error)d
+(status)i(is)h(set)f(to)g(an)g(error)f(v)-5 b(alue)27
+b(\(after)g(an)g(error\),)f(most)h(AST)h(functions)g(will)g(not)427
+2862 y(execute)h(and)g(will)h(simply)f(return)g(without)g(action.)41
+b(T)-7 b(o)29 b(clear)f(the)i(error)d(status)i(and)g(restore)f(normal)
+427 2962 y(b)r(eha)n(viour,)f(use)g(astClearStatus.)p
+0 3153 V 0 3285 a Fz(astO\013set)308 b Fe(Calculate)36
+b(an)i(o\013set)h(along)e(a)i(geo)s(desic)f(curv)m(e)305
+b Fz(astO\013set)0 3466 y Fd(Description:)44 b Fi(This)c(function)f
(\014nds)h(the)f(F)-7 b(rame)39 b(co)r(ordinate)f(v)-5
b(alues)39 b(of)g(a)g(p)r(oin)n(t)g(whic)n(h)g(is)g(o\013set)h(a)e(sp)r
-(eci\014ed)227 2657 y(distance)28 b(along)e(the)i(geo)r(desic)f(curv)n
+(eci\014ed)227 3565 y(distance)28 b(along)e(the)i(geo)r(desic)f(curv)n
(e)f(b)r(et)n(w)n(een)i(t)n(w)n(o)f(other)g(p)r(oin)n(ts.)227
-2782 y(F)-7 b(or)28 b(example,)h(in)f(a)h(basic)f(F)-7
+3688 y(F)-7 b(or)28 b(example,)h(in)f(a)h(basic)f(F)-7
b(rame,)28 b(this)h(o\013set)f(will)h(b)r(e)g(along)e(the)i(straigh)n
(t)f(line)g(joining)h(t)n(w)n(o)e(p)r(oin)n(ts.)40 b(F)-7
-b(or)28 b(a)227 2881 y(more)h(sp)r(ecialised)h(F)-7 b(rame)29
+b(or)28 b(a)227 3787 y(more)h(sp)r(ecialised)h(F)-7 b(rame)29
b(describing)h(a)f(sky)h(co)r(ordinate)e(system,)j(ho)n(w)n(ev)n(er,)d
-(it)j(w)n(ould)e(b)r(e)i(along)d(the)j(great)227 2981
+(it)j(w)n(ould)e(b)r(e)i(along)d(the)j(great)227 3887
y(circle)c(passing)g(through)g(t)n(w)n(o)f(sky)i(p)r(ositions.)0
-3131 y Fd(Synopsis:)121 b Ft(void)42 b(astOffset\()d(AstFrame)i
+4033 y Fd(Synopsis:)121 b Ft(void)42 b(astOffset\()d(AstFrame)i
Fh(\003)p Ft(this,)g(const)g(double)g(point1[],)f(const)i(double)f
-(point2[],)227 3231 y(double)g(offset,)g(double)g(point3[])f(\))0
-3381 y Fd(P)m(arameters:)259 3518 y(this)427 3618 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(F)-7 b(rame.)259 3751 y Fd(p)s(oin)m(t1)427
-3851 y Fi(An)35 b(arra)n(y)d(of)i(double,)j(with)d(one)g(elemen)n(t)h
+(point2[],)227 4132 y(double)g(offset,)g(double)g(point3[])f(\))0
+4278 y Fd(P)m(arameters:)259 4410 y(this)427 4510 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(F)-7 b(rame.)259 4638 y Fd(p)s(oin)m(t1)427
+4738 y Fi(An)35 b(arra)n(y)d(of)i(double,)j(with)d(one)g(elemen)n(t)h
(for)f(eac)n(h)f(F)-7 b(rame)34 b(axis)g(\(Naxes)g(attribute\).)57
-b(This)35 b(should)427 3951 y(con)n(tain)27 b(the)h(co)r(ordinates)e
+b(This)35 b(should)427 4838 y(con)n(tain)27 b(the)h(co)r(ordinates)e
(of)i(the)g(p)r(oin)n(t)g(marking)e(the)i(start)f(of)h(the)g(geo)r
-(desic)e(curv)n(e.)259 4084 y Fd(p)s(oin)m(t2)427 4183
+(desic)e(curv)n(e.)259 4966 y Fd(p)s(oin)m(t2)427 5066
y Fi(An)d(arra)n(y)e(of)h(double,)i(with)f(one)f(elemen)n(t)h(for)f
(eac)n(h)f(F)-7 b(rame)23 b(axis)e(This)i(should)f(con)n(tain)g(the)h
-(co)r(ordinates)427 4283 y(of)28 b(the)g(p)r(oin)n(t)g(marking)e(the)i
-(end)g(of)f(the)h(geo)r(desic)f(curv)n(e.)259 4416 y
-Fd(o\013set)427 4516 y Fi(The)g(required)e(o\013set)i(from)f(the)h
+(co)r(ordinates)427 5166 y(of)28 b(the)g(p)r(oin)n(t)g(marking)e(the)i
+(end)g(of)f(the)h(geo)r(desic)f(curv)n(e.)259 5295 y
+Fd(o\013set)427 5394 y Fi(The)g(required)e(o\013set)i(from)f(the)h
(\014rst)f(p)r(oin)n(t)g(along)g(the)g(geo)r(desic)g(curv)n(e.)35
b(If)27 b(this)g(is)f(p)r(ositiv)n(e,)h(it)g(will)f(b)r(e)427
-4616 y(to)n(w)n(ards)20 b(the)i(second)f(p)r(oin)n(t.)35
+5494 y(to)n(w)n(ards)20 b(the)i(second)f(p)r(oin)n(t.)35
b(If)22 b(it)g(is)f(negativ)n(e,)h(it)g(will)f(b)r(e)h(in)g(the)g(opp)r
(osite)f(direction.)35 b(This)21 b(o\013set)g(need)427
-4715 y(not)28 b(imply)g(a)f(p)r(osition)h(lying)f(b)r(et)n(w)n(een)h
+5593 y(not)28 b(imply)g(a)f(p)r(osition)h(lying)f(b)r(et)n(w)n(een)h
(the)g(t)n(w)n(o)f(p)r(oin)n(ts)h(giv)n(en,)f(as)g(the)h(curv)n(e)e
-(will)i(b)r(e)g(extrap)r(olated)f(if)427 4815 y(necessary)-7
-b(.)259 4948 y Fd(p)s(oin)m(t3)427 5048 y Fi(An)34 b(arra)n(y)e(of)i
-(double,)h(with)f(one)f(elemen)n(t)h(for)f(eac)n(h)g(F)-7
-b(rame)34 b(axis)e(in)i(whic)n(h)g(the)g(co)r(ordinates)f(of)g(the)427
-5147 y(required)27 b(p)r(oin)n(t)h(will)g(b)r(e)g(returned.)0
-5310 y Fd(Notes:)340 5593 y Fh(\017)45 b Fi(The)26 b(geo)r(desic)e
-(curv)n(e)h(used)g(b)n(y)g(this)h(function)g(is)f(the)h(path)f(of)h
-(shortest)e(distance)i(b)r(et)n(w)n(een)f(t)n(w)n(o)g(p)r(oin)n(ts,)427
-5693 y(as)i(de\014ned)h(b)n(y)f(the)h(astDistance)g(function.)p
-eop end
-%%Page: 302 312
-TeXDict begin 302 311 bop 0 52 a FF(302)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+(will)i(b)r(e)g(extrap)r(olated)f(if)427 5693 y(necessary)-7
+b(.)p eop end
+%%Page: 303 313
+TeXDict begin 303 312 bop 3643 52 a FF(303)259 351 y
+Fd(p)s(oin)m(t3)427 451 y Fi(An)34 b(arra)n(y)e(of)i(double,)h(with)f
+(one)f(elemen)n(t)h(for)f(eac)n(h)g(F)-7 b(rame)34 b(axis)e(in)i(whic)n
+(h)g(the)g(co)r(ordinates)f(of)g(the)427 551 y(required)27
+b(p)r(oin)n(t)h(will)g(b)r(e)g(returned.)0 710 y Fd(Notes:)340
+990 y Fh(\017)45 b Fi(The)26 b(geo)r(desic)e(curv)n(e)h(used)g(b)n(y)g
+(this)h(function)g(is)f(the)h(path)f(of)h(shortest)e(distance)i(b)r(et)
+n(w)n(een)f(t)n(w)n(o)g(p)r(oin)n(ts,)427 1090 y(as)i(de\014ned)h(b)n
+(y)f(the)h(astDistance)g(function.)340 1221 y Fh(\017)45
b Fi(This)19 b(function)g(will)g(return)f Ft(")p Fi(bad)p
Ft(")g Fi(co)r(ordinate)g(v)-5 b(alues)18 b(\(AST)p Ft(__)p
Fi(BAD\))i(if)f(an)n(y)f(of)g(the)i(input)f(co)r(ordinates)427
-451 y(has)27 b(this)h(v)-5 b(alue.)340 590 y Fh(\017)45
+1320 y(has)27 b(this)h(v)-5 b(alue.)340 1451 y Fh(\017)45
b Ft(")p Fi(Bad)p Ft(")32 b Fi(co)r(ordinate)f(v)-5 b(alues)32
b(will)h(also)e(b)r(e)i(returned)f(if)h(the)g(t)n(w)n(o)f(p)r(oin)n(ts)
-g(supplied)h(are)f(coinciden)n(t)g(\(or)427 689 y(otherwise)27
+g(supplied)h(are)f(coinciden)n(t)g(\(or)427 1551 y(otherwise)27
b(fail)h(to)f(uniquely)h(sp)r(ecify)g(a)f(geo)r(desic)g(curv)n(e\))f
(but)j(the)f(requested)f(o\013set)g(is)h(non-zero.)p
-0 900 3780 12 v 0 1032 a Fz(astO\013set2)172 b Fe(Calculate)37
+0 1745 3780 12 v 0 1877 a Fz(astO\013set2)172 b Fe(Calculate)37
b(an)h(o\013set)h(along)e(a)h(geo)s(desic)h(curv)m(e)f(in)1587
-1145 y(a)h(2D)g(F)-10 b(rame)3195 1032 y Fz(astO\013set2)0
-1322 y Fd(Description:)44 b Fi(This)c(function)f(\014nds)h(the)f(F)-7
+1990 y(a)h(2D)g(F)-10 b(rame)3195 1877 y Fz(astO\013set2)0
+2151 y Fd(Description:)44 b Fi(This)c(function)f(\014nds)h(the)f(F)-7
b(rame)39 b(co)r(ordinate)f(v)-5 b(alues)39 b(of)g(a)g(p)r(oin)n(t)g
-(whic)n(h)g(is)g(o\013set)h(a)e(sp)r(eci\014ed)227 1422
+(whic)n(h)g(is)g(o\013set)h(a)e(sp)r(eci\014ed)227 2251
y(distance)30 b(along)f(the)h(geo)r(desic)f(curv)n(e)g(at)h(a)f(giv)n
(en)g(angle)g(from)h(a)g(sp)r(eci\014ed)g(starting)f(p)r(oin)n(t.)44
-b(It)30 b(can)g(only)f(b)r(e)227 1522 y(used)f(with)g(2-dimensional)e
-(F)-7 b(rames.)227 1652 y(F)g(or)28 b(example,)h(in)f(a)h(basic)f(F)-7
+b(It)30 b(can)g(only)f(b)r(e)227 2351 y(used)f(with)g(2-dimensional)e
+(F)-7 b(rames.)227 2474 y(F)g(or)28 b(example,)h(in)f(a)h(basic)f(F)-7
b(rame,)28 b(this)h(o\013set)f(will)h(b)r(e)g(along)e(the)i(straigh)n
(t)f(line)g(joining)h(t)n(w)n(o)e(p)r(oin)n(ts.)40 b(F)-7
-b(or)28 b(a)227 1752 y(more)h(sp)r(ecialised)h(F)-7 b(rame)29
+b(or)28 b(a)227 2574 y(more)h(sp)r(ecialised)h(F)-7 b(rame)29
b(describing)h(a)f(sky)h(co)r(ordinate)e(system,)j(ho)n(w)n(ev)n(er,)d
-(it)j(w)n(ould)e(b)r(e)i(along)d(the)j(great)227 1851
+(it)j(w)n(ould)e(b)r(e)i(along)d(the)j(great)227 2673
y(circle)c(passing)g(through)g(t)n(w)n(o)f(sky)i(p)r(ositions.)0
-2013 y Fd(Synopsis:)121 b Ft(double)41 b(astOffset2\()e(AstFrame)h
+2821 y Fd(Synopsis:)121 b Ft(double)41 b(astOffset2\()e(AstFrame)h
Fh(\003)p Ft(this,)h(const)h(double)f(point1[2],)e(double)i(angle,)h
-(double)227 2112 y(offset,)f(double)g(point2[2])f(\);)0
-2273 y Fd(P)m(arameters:)259 2421 y(this)427 2521 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(F)-7 b(rame.)259 2660 y Fd(p)s(oin)m(t1)427
-2759 y Fi(An)35 b(arra)n(y)d(of)i(double,)j(with)d(one)g(elemen)n(t)h
+(double)227 2920 y(offset,)f(double)g(point2[2])f(\);)0
+3067 y Fd(P)m(arameters:)259 3202 y(this)427 3301 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(F)-7 b(rame.)259 3432 y Fd(p)s(oin)m(t1)427
+3532 y Fi(An)35 b(arra)n(y)d(of)i(double,)j(with)d(one)g(elemen)n(t)h
(for)f(eac)n(h)f(F)-7 b(rame)34 b(axis)g(\(Naxes)g(attribute\).)57
-b(This)35 b(should)427 2859 y(con)n(tain)27 b(the)h(co)r(ordinates)e
+b(This)35 b(should)427 3631 y(con)n(tain)27 b(the)h(co)r(ordinates)e
(of)i(the)g(p)r(oin)n(t)g(marking)e(the)i(start)f(of)h(the)g(geo)r
-(desic)e(curv)n(e.)259 2998 y Fd(angle)427 3097 y Fi(The)j(angle)f
+(desic)e(curv)n(e.)259 3762 y Fd(angle)427 3861 y Fi(The)j(angle)f
(\(in)i(radians\))e(from)g(the)i(p)r(ositiv)n(e)e(direction)h(of)g(the)
g(second)f(axis,)h(to)g(the)g(direction)f(of)h(the)427
-3197 y(required)38 b(p)r(osition,)i(as)e(seen)g(from)g(the)g(starting)g
+3961 y(required)38 b(p)r(osition,)i(as)e(seen)g(from)g(the)g(starting)g
(p)r(osition.)68 b(P)n(ositiv)n(e)37 b(rotation)g(is)h(in)g(the)h
-(sense)f(of)427 3297 y(rotation)27 b(from)g(the)h(p)r(ositiv)n(e)f
+(sense)f(of)427 4061 y(rotation)27 b(from)g(the)h(p)r(ositiv)n(e)f
(direction)g(of)h(axis)f(2)g(to)g(the)h(p)r(ositiv)n(e)g(direction)f
-(of)g(axis)g(1.)259 3435 y Fd(o\013set)427 3535 y Fi(The)g(required)e
+(of)g(axis)g(1.)259 4191 y Fd(o\013set)427 4291 y Fi(The)g(required)e
(o\013set)i(from)f(the)h(\014rst)f(p)r(oin)n(t)g(along)g(the)g(geo)r
(desic)g(curv)n(e.)35 b(If)27 b(this)g(is)f(p)r(ositiv)n(e,)h(it)g
-(will)f(b)r(e)427 3635 y(in)i(the)g(direction)f(of)h(the)g(giv)n(en)f
+(will)f(b)r(e)427 4390 y(in)i(the)g(direction)f(of)h(the)g(giv)n(en)f
(angle.)36 b(If)28 b(it)g(is)f(negativ)n(e,)g(it)h(will)g(b)r(e)g(in)f
-(the)h(opp)r(osite)g(direction.)259 3773 y Fd(p)s(oin)m(t2)427
-3873 y Fi(An)34 b(arra)n(y)e(of)i(double,)h(with)f(one)f(elemen)n(t)h
+(the)h(opp)r(osite)g(direction.)259 4521 y Fd(p)s(oin)m(t2)427
+4621 y Fi(An)34 b(arra)n(y)e(of)i(double,)h(with)f(one)f(elemen)n(t)h
(for)f(eac)n(h)g(F)-7 b(rame)34 b(axis)e(in)i(whic)n(h)g(the)g(co)r
-(ordinates)f(of)g(the)427 3973 y(required)27 b(p)r(oin)n(t)h(will)g(b)r
-(e)g(returned.)0 4146 y Fd(Returned)k(V)-8 b(alue:)259
-4294 y(astO\013set2)427 4394 y Fi(The)27 b(direction)f(of)g(the)h(geo)r
+(ordinates)f(of)g(the)427 4720 y(required)27 b(p)r(oin)n(t)h(will)g(b)r
+(e)g(returned.)0 4880 y Fd(Returned)k(V)-8 b(alue:)259
+5014 y(astO\013set2)427 5114 y Fi(The)27 b(direction)f(of)g(the)h(geo)r
(desic)e(curv)n(e)g(at)h(the)h(end)g(p)r(oin)n(t.)36
b(That)27 b(is,)f(the)h(angle)e(\(in)i(radians\))f(b)r(et)n(w)n(een)427
-4494 y(the)35 b(p)r(ositiv)n(e)e(direction)h(of)g(the)g(second)f(axis)h
+5213 y(the)35 b(p)r(ositiv)n(e)e(direction)h(of)g(the)g(second)f(axis)h
(and)g(the)g(con)n(tin)n(uation)f(of)h(the)g(geo)r(desic)f(curv)n(e)g
-(at)h(the)427 4593 y(requested)29 b(end)h(p)r(oin)n(t.)42
+(at)h(the)427 5313 y(requested)29 b(end)h(p)r(oin)n(t.)42
b(P)n(ositiv)n(e)28 b(rotation)g(is)h(in)h(the)g(sense)f(of)g(rotation)
-f(from)h(the)h(p)r(ositiv)n(e)f(direction)427 4693 y(of)f(axis)f(2)g
+f(from)h(the)h(p)r(ositiv)n(e)f(direction)427 5413 y(of)f(axis)f(2)g
(to)g(the)h(p)r(ositiv)n(e)f(direction)h(of)f(axis)g(1.)0
-4866 y Fd(Notes:)340 5161 y Fh(\017)45 b Fi(The)26 b(geo)r(desic)e
-(curv)n(e)h(used)g(b)n(y)g(this)h(function)g(is)f(the)h(path)f(of)h
-(shortest)e(distance)i(b)r(et)n(w)n(een)f(t)n(w)n(o)g(p)r(oin)n(ts,)427
-5260 y(as)i(de\014ned)h(b)n(y)f(the)h(astDistance)g(function.)340
-5399 y Fh(\017)45 b Fi(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)
-h(the)g(F)-7 b(rame)27 b(is)g(not)h(2-dimensional.)340
-5538 y Fh(\017)45 b Fi(This)19 b(function)g(will)g(return)f
-Ft(")p Fi(bad)p Ft(")g Fi(co)r(ordinate)g(v)-5 b(alues)18
-b(\(AST)p Ft(__)p Fi(BAD\))i(if)f(an)n(y)f(of)g(the)i(input)f(co)r
-(ordinates)427 5637 y(has)27 b(this)h(v)-5 b(alue.)p
-eop end
-%%Page: 303 313
-TeXDict begin 303 312 bop 3643 52 a FF(303)p 0 351 3780
-12 v 0 483 a Fz(astOutline)p Fc(<)p Fz(X)p Fc(>)236 b
-Fe(Create)37 b(a)i(new)f(P)m(olygon)f(outling)1271 598
-y(v)-7 b(alues)38 b(in)h(a)g(2D)f(data)g(grid)2886 483
-y Fz(astOutline)p Fc(<)p Fz(X)p Fc(>)0 767 y Fd(Description:)44
-b Fi(This)27 b(is)g(a)g(set)g(of)g(functions)g(that)g(create)g(a)f(P)n
-(olygon)f(enclosing)h(a)h(single)f(con)n(tiguous)g(set)h(of)g(pixels)
-227 867 y(that)h(ha)n(v)n(e)f(a)g(sp)r(eci\014ed)h(v)-5
+5572 y Fd(Notes:)p eop end
+%%Page: 304 314
+TeXDict begin 304 313 bop 0 52 a FF(304)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Fi(The)26 b(geo)r(desic)e(curv)n(e)h(used)g(b)n(y)g(this)h(function)g
+(is)f(the)h(path)f(of)h(shortest)e(distance)i(b)r(et)n(w)n(een)f(t)n(w)
+n(o)g(p)r(oin)n(ts,)427 451 y(as)i(de\014ned)h(b)n(y)f(the)h
+(astDistance)g(function.)340 585 y Fh(\017)45 b Fi(An)28
+b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)h(the)g(F)-7
+b(rame)27 b(is)g(not)h(2-dimensional.)340 720 y Fh(\017)45
+b Fi(This)19 b(function)g(will)g(return)f Ft(")p Fi(bad)p
+Ft(")g Fi(co)r(ordinate)g(v)-5 b(alues)18 b(\(AST)p Ft(__)p
+Fi(BAD\))i(if)f(an)n(y)f(of)g(the)i(input)f(co)r(ordinates)427
+820 y(has)27 b(this)h(v)-5 b(alue.)p 0 1022 3780 12 v
+0 1154 a Fz(astOutline)p Fc(<)p Fz(X)p Fc(>)236 b Fe(Create)37
+b(a)i(new)f(P)m(olygon)f(outling)1271 1269 y(v)-7 b(alues)38
+b(in)h(a)g(2D)f(data)g(grid)2886 1154 y Fz(astOutline)p
+Fc(<)p Fz(X)p Fc(>)0 1461 y Fd(Description:)44 b Fi(This)27
+b(is)g(a)g(set)g(of)g(functions)g(that)g(create)g(a)f(P)n(olygon)f
+(enclosing)h(a)h(single)f(con)n(tiguous)g(set)h(of)g(pixels)227
+1561 y(that)h(ha)n(v)n(e)f(a)g(sp)r(eci\014ed)h(v)-5
b(alue)27 b(within)h(a)g(gridded)f(2-dimensional)f(data)h(arra)n(y)e
-(\(e.g.)37 b(an)27 b(image\).)227 986 y(A)40 b(basic)f(2-dimensional)e
+(\(e.g.)37 b(an)27 b(image\).)227 1687 y(A)40 b(basic)f(2-dimensional)e
(F)-7 b(rame)39 b(is)g(used)h(to)f(represen)n(t)f(the)h(pixel)h(co)r
-(ordinate)e(system)h(in)g(the)h(returned)227 1086 y(P)n(olygon.)33
+(ordinate)e(system)h(in)g(the)h(returned)227 1787 y(P)n(olygon.)33
b(The)21 b(Domain)g(attribute)h(is)f(set)g(to)h Ft(")p
Fi(PIXEL)p Ft(")p Fi(,)f(the)g(Title)h(attribute)f(is)h(set)f(to)g
-Ft(")p Fi(Pixel)f(co)r(ordinates)p Ft(")p Fi(,)227 1186
+Ft(")p Fi(Pixel)f(co)r(ordinates)p Ft(")p Fi(,)227 1886
y(and)i(the)h(Unit)f(attribute)h(for)e(eac)n(h)g(axis)h(is)g(set)g(to)g
Ft(")p Fi(pixel)p Ft(")p Fi(.)34 b(All)22 b(other)g(attributes)g(are)f
-(left)i(unset.)35 b(The)22 b(nature)227 1285 y(of)28
+(left)i(unset.)35 b(The)22 b(nature)227 1986 y(of)28
b(the)g(pixel)f(co)r(ordinate)g(system)g(is)h(determined)f(b)n(y)h
-(parameter)e Ft(")p Fi(starpix)p Ft(")p Fi(.)227 1405
+(parameter)e Ft(")p Fi(starpix)p Ft(")p Fi(.)227 2112
y(The)39 b Ft(")p Fi(maxerr)p Ft(")e Fi(and)h Ft(")p
Fi(maxv)n(ert)p Ft(")f Fi(parameters)g(can)i(b)r(e)g(used)g(to)g(con)n
-(trol)e(ho)n(w)h(accurately)g(the)h(returned)227 1505
+(trol)e(ho)n(w)h(accurately)g(the)h(returned)227 2212
y(P)n(olygon)28 b(represen)n(ts)g(the)i(required)f(region)f(in)i(the)g
(data)f(arra)n(y)-7 b(.)41 b(The)30 b(n)n(um)n(b)r(er)f(of)h(v)n
-(ertices)e(in)i(the)g(returned)227 1604 y(P)n(olygon)c(will)h(b)r(e)i
+(ertices)e(in)i(the)g(returned)227 2311 y(P)n(olygon)c(will)h(b)r(e)i
(the)e(minim)n(um)i(needed)f(to)f(ac)n(hiev)n(e)f(the)i(required)f
-(accuracy)-7 b(.)227 1724 y(Y)g(ou)34 b(should)g(use)g(a)f(function)i
+(accuracy)-7 b(.)227 2438 y(Y)g(ou)34 b(should)g(use)g(a)f(function)i
(whic)n(h)f(matc)n(hes)f(the)h(n)n(umerical)f(t)n(yp)r(e)i(of)f(the)g
-(data)f(y)n(ou)g(are)g(pro)r(cessing)g(b)n(y)227 1824
+(data)f(y)n(ou)g(are)g(pro)r(cessing)g(b)n(y)227 2537
y(replacing)c Fk(<)p Fi(X)p Fk(>)h Fi(in)g(the)g(generic)f(function)i
(name)e(astOutline)p Fk(<)p Fi(X)p Fk(>)h Fi(b)n(y)f(an)h(appropriate)e
-(1-)h(or)g(2-c)n(haracter)227 1923 y(t)n(yp)r(e)h(co)r(de.)43
+(1-)h(or)g(2-c)n(haracter)227 2637 y(t)n(yp)r(e)h(co)r(de.)43
b(F)-7 b(or)29 b(example,)h(if)g(y)n(ou)e(are)h(pro)r(cesing)f(data)i
(with)g(t)n(yp)r(e)g Ft(")p Fi(\015oat)p Ft(")p Fi(,)e(y)n(ou)h(should)
-h(use)f(the)h(function)227 2023 y(astOutlineF)21 b(\(see)f(the)h
+h(use)f(the)h(function)227 2737 y(astOutlineF)21 b(\(see)f(the)h
Ft(")p Fi(Data)f(T)n(yp)r(e)g(Co)r(des)p Ft(")g Fi(section)g(b)r(elo)n
(w)g(for)g(the)h(co)r(des)f(appropriate)f(to)i(other)e(n)n(umerical)227
-2123 y(t)n(yp)r(es\).)0 2262 y Fd(Synopsis:)121 b Ft(AstPolygon)39
+2836 y(t)n(yp)r(es\).)0 2989 y Fd(Synopsis:)121 b Ft(AstPolygon)39
b Fh(\003)p Ft(astOutline)p Fk(<)p Ft(X)p Fk(>)p Ft(\()f
Fk(<)p Ft(Xtype)p Fk(>)i Ft(value,)h(int)i(oper,)e(const)h
-Fk(<)p Ft(Xtype)p Fk(>)e Ft(array[],)227 2362 y(const)i(int)g(lbnd[2],)
+Fk(<)p Ft(Xtype)p Fk(>)e Ft(array[],)227 3089 y(const)i(int)g(lbnd[2],)
e(const)i(int)g(ubnd[2],)f(double)g(maxerr,)f(int)j(maxvert,)d(const)h
-(int)i(inside[2],)227 2462 y(int)g(starpix)d(\))0 2602
-y Fd(P)m(arameters:)259 2728 y(v)-5 b(alue)427 2828 y
+(int)i(inside[2],)227 3188 y(int)g(starpix)d(\))0 3341
+y Fd(P)m(arameters:)259 3481 y(v)-5 b(alue)427 3581 y
Fi(A)28 b(data)f(v)-5 b(alue)28 b(that)g(sp)r(eci\014es)f(the)h(pixels)
-g(to)f(b)r(e)h(outlined.)259 2951 y Fd(op)s(er)427 3051
+g(to)f(b)r(e)h(outlined.)259 3715 y Fd(op)s(er)427 3815
y Fi(Indicates)f(ho)n(w)g(the)g Ft(")p Fi(v)-5 b(alue)p
Ft(")27 b Fi(parameter)e(is)j(used)f(to)g(select)g(the)h(outlined)f
(pixels.)37 b(It)27 b(can)g(ha)n(v)n(e)f(an)n(y)h(of)427
-3150 y(the)h(follo)n(wing)f(v)-5 b(alues:)510 3248 y
+3915 y(the)h(follo)n(wing)f(v)-5 b(alues:)510 4023 y
Fh(\017)45 b Fi(AST)p Ft(__)p Fi(L)-7 b(T:)27 b(outline)h(pixels)g
(with)g(v)-5 b(alue)27 b(less)g(than)h Ft(")p Fi(v)-5
-b(alue)p Ft(")p Fi(.)510 3360 y Fh(\017)45 b Fi(AST)p
+b(alue)p Ft(")p Fi(.)510 4141 y Fh(\017)45 b Fi(AST)p
Ft(__)p Fi(LE:)27 b(outline)h(pixels)f(with)h(v)-5 b(alue)28
b(less)f(than)g(or)g(equal)g(to)h Ft(")p Fi(v)-5 b(alue)p
-Ft(")p Fi(.)510 3471 y Fh(\017)45 b Fi(AST)p Ft(__)p
+Ft(")p Fi(.)510 4258 y Fh(\017)45 b Fi(AST)p Ft(__)p
Fi(EQ:)27 b(outline)g(pixels)h(with)g(v)-5 b(alue)27
b(equal)g(to)h Ft(")p Fi(v)-5 b(alue)p Ft(")p Fi(.)510
-3582 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(NE:)27 b(outline)h(pixels)f
+4375 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(NE:)27 b(outline)h(pixels)f
(with)i(v)-5 b(alue)27 b(not)h(equal)f(to)g Ft(")p Fi(v)-5
-b(alue)p Ft(")p Fi(.)510 3694 y Fh(\017)45 b Fi(AST)p
+b(alue)p Ft(")p Fi(.)510 4492 y Fh(\017)45 b Fi(AST)p
Ft(__)p Fi(GE:)27 b(outline)h(pixels)f(with)h(v)-5 b(alue)28
b(greater)e(than)h(or)g(equal)g(to)h Ft(")p Fi(v)-5 b(alue)p
-Ft(")p Fi(.)510 3805 y Fh(\017)45 b Fi(AST)p Ft(__)p
+Ft(")p Fi(.)510 4609 y Fh(\017)45 b Fi(AST)p Ft(__)p
Fi(GT:)28 b(outline)f(pixels)h(with)g(v)-5 b(alue)27
b(greater)f(than)i Ft(")p Fi(v)-5 b(alue)p Ft(")p Fi(.)259
-3929 y Fd(arra)m(y)427 4028 y Fi(P)n(oin)n(ter)25 b(to)i(a)f
+4744 y Fd(arra)m(y)427 4844 y Fi(P)n(oin)n(ter)25 b(to)i(a)f
(2-dimensional)f(arra)n(y)f(con)n(taining)i(the)h(data)f(to)g(b)r(e)h
(pro)r(cessed.)36 b(The)26 b(n)n(umerical)g(t)n(yp)r(e)h(of)427
-4128 y(this)g(arra)n(y)d(should)i(matc)n(h)h(the)g(1-)e(or)h(2-c)n
+4943 y(this)g(arra)n(y)d(should)i(matc)n(h)h(the)g(1-)e(or)h(2-c)n
(haracter)d(t)n(yp)r(e)k(co)r(de)f(app)r(ended)h(to)g(the)f(function)h
-(name)g(\(e.g.)427 4227 y(if)h(y)n(ou)f(are)g(using)g(astOutlineF,)h
+(name)g(\(e.g.)427 5043 y(if)h(y)n(ou)f(are)g(using)g(astOutlineF,)h
(the)g(t)n(yp)r(e)f(of)h(eac)n(h)f(arra)n(y)e(elemen)n(t)j(should)f(b)r
-(e)h Ft(")p Fi(\015oat)p Ft(")p Fi(\).)427 4339 y(The)33
+(e)h Ft(")p Fi(\015oat)p Ft(")p Fi(\).)427 5160 y(The)33
b(storage)f(order)f(of)j(data)e(within)i(this)g(arra)n(y)c(should)j(b)r
(e)h(suc)n(h)f(that)g(the)h(index)f(of)g(the)g(\014rst)g(grid)427
-4438 y(dimension)g(v)-5 b(aries)31 b(most)h(rapidly)g(and)g(that)h(of)f
+5260 y(dimension)g(v)-5 b(aries)31 b(most)h(rapidly)g(and)g(that)h(of)f
(the)h(second)f(dimension)g(least)g(rapidly)g(\(i.e.)52
-b(F)-7 b(ortran)427 4538 y(arra)n(y)26 b(indexing)h(is)g(used\).)259
-4661 y Fd(lbnd)427 4761 y Fi(P)n(oin)n(ter)g(to)h(an)h(arra)n(y)d(of)i
+b(F)-7 b(ortran)427 5359 y(arra)n(y)26 b(indexing)h(is)g(used\).)259
+5494 y Fd(lbnd)427 5593 y Fi(P)n(oin)n(ter)g(to)h(an)h(arra)n(y)d(of)i
(t)n(w)n(o)g(in)n(tegers)f(con)n(taining)g(the)i(co)r(ordinates)e(of)i
-(the)f(cen)n(tre)g(of)h(the)f(\014rst)h(pixel)427 4861
-y(in)f(the)g(input)h(grid)d(along)h(eac)n(h)g(dimension.)259
-4984 y Fd(ubnd)427 5083 y Fi(P)n(oin)n(ter)h(to)h(an)g(arra)n(y)e(of)i
-(t)n(w)n(o)g(in)n(tegers)f(con)n(taining)g(the)i(co)r(ordinates)e(of)h
-(the)h(cen)n(tre)f(of)g(the)h(last)f(pixel)427 5183 y(in)f(the)g(input)
-h(grid)d(along)h(eac)n(h)g(dimension.)427 5295 y(Note)f(that)h
+(the)f(cen)n(tre)g(of)h(the)f(\014rst)h(pixel)427 5693
+y(in)f(the)g(input)h(grid)d(along)h(eac)n(h)g(dimension.)p
+eop end
+%%Page: 305 315
+TeXDict begin 305 314 bop 3643 52 a FF(305)259 351 y
+Fd(ubnd)427 451 y Fi(P)n(oin)n(ter)28 b(to)h(an)g(arra)n(y)e(of)i(t)n
+(w)n(o)g(in)n(tegers)f(con)n(taining)g(the)i(co)r(ordinates)e(of)h(the)
+h(cen)n(tre)f(of)g(the)h(last)f(pixel)427 551 y(in)f(the)g(input)h
+(grid)d(along)h(eac)n(h)g(dimension.)427 667 y(Note)f(that)h
Ft(")p Fi(lbnd)p Ft(")f Fi(and)g Ft(")p Fi(ubnd)p Ft(")g
Fi(together)f(de\014ne)h(the)h(shap)r(e)f(and)g(size)g(of)g(the)g
-(input)h(grid,)f(its)h(exten)n(t)427 5394 y(along)36
-b(a)g(particular)f(\(j'th\))j(dimension)e(b)r(eing)g(ubnd[j]-lbnd[j]+1)
-i(\(assuming)d(the)i(index)g Ft(")p Fi(j)p Ft(")f Fi(to)g(b)r(e)427
-5494 y(zero-based\).)69 b(They)39 b(also)e(de\014ne)j(the)f(input)g
+(input)h(grid,)f(its)h(exten)n(t)427 767 y(along)36 b(a)g(particular)f
+(\(j'th\))j(dimension)e(b)r(eing)g(ubnd[j]-lbnd[j]+1)i(\(assuming)d
+(the)i(index)g Ft(")p Fi(j)p Ft(")f Fi(to)g(b)r(e)427
+867 y(zero-based\).)69 b(They)39 b(also)e(de\014ne)j(the)f(input)g
(grid's)f(co)r(ordinate)g(system,)j(eac)n(h)d(pixel)h(ha)n(ving)f(unit)
-427 5593 y(exten)n(t)28 b(along)e(eac)n(h)g(dimension)h(with)h(in)n
+427 966 y(exten)n(t)28 b(along)e(eac)n(h)g(dimension)h(with)h(in)n
(tegral)e(co)r(ordinate)g(v)-5 b(alues)27 b(at)g(its)h(cen)n(tre)e(or)h
-(upp)r(er)g(corner,)f(as)427 5693 y(selected)i(b)n(y)f(parameter)f
-Ft(")p Fi(starpix)p Ft(")p Fi(.)p eop end
-%%Page: 304 314
-TeXDict begin 304 313 bop 0 52 a FF(304)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(maxerr)427
-451 y Fi(T)-7 b(ogether)19 b(with)i Ft(")p Fi(maxv)n(ert)p
+(upp)r(er)g(corner,)f(as)427 1066 y(selected)i(b)n(y)f(parameter)f
+Ft(")p Fi(starpix)p Ft(")p Fi(.)259 1200 y Fd(maxerr)427
+1300 y Fi(T)-7 b(ogether)19 b(with)i Ft(")p Fi(maxv)n(ert)p
Ft(")p Fi(,)e(this)i(determines)f(ho)n(w)f(accurately)g(the)h(returned)
-g(P)n(olygon)e(represen)n(ts)g(the)427 551 y(required)g(region)g(of)h
+g(P)n(olygon)e(represen)n(ts)g(the)427 1399 y(required)g(region)g(of)h
(the)g(data)f(arra)n(y)-7 b(.)32 b(It)19 b(giv)n(es)f(the)h(target)f
(discrepancy)g(b)r(et)n(w)n(een)h(the)g(returned)g(P)n(olygon)427
-650 y(and)36 b(the)f(accurate)f(outline)i(in)g(the)g(data)e(arra)n(y)-7
-b(,)36 b(expressed)e(as)h(a)g(n)n(um)n(b)r(er)g(of)g(pixels.)60
-b(Insigni\014can)n(t)427 750 y(v)n(ertices)38 b(are)f(remo)n(v)n(ed)h
+1499 y(and)36 b(the)f(accurate)f(outline)i(in)g(the)g(data)e(arra)n(y)
+-7 b(,)36 b(expressed)e(as)h(a)g(n)n(um)n(b)r(er)g(of)g(pixels.)60
+b(Insigni\014can)n(t)427 1599 y(v)n(ertices)38 b(are)f(remo)n(v)n(ed)h
(from)g(the)h(accurate)e(outline,)42 b(one)c(b)n(y)h(one,)i(un)n(til)e
-(the)g(n)n(um)n(b)r(er)f(of)h(v)n(ertices)427 849 y(remaining)25
+(the)g(n)n(um)n(b)r(er)f(of)h(v)n(ertices)427 1698 y(remaining)25
b(in)i(the)f(returned)g(P)n(olygon)e(equals)h Ft(")p
Fi(maxv)n(ert)p Ft(")p Fi(,)f(or)h(the)i(largest)d(discrepancy)h(b)r
-(et)n(w)n(een)h(the)427 949 y(accurate)j(outline)g(and)h(the)g
+(et)n(w)n(een)h(the)427 1798 y(accurate)j(outline)g(and)h(the)g
(returned)f(P)n(olygon)e(is)j(greater)e(than)h Ft(")p
Fi(maxerr)p Ft(")p Fi(.)41 b(If)30 b Ft(")p Fi(maxerr)p
-Ft(")d Fi(is)j(zero)e(or)427 1049 y(less,)g(its)h(v)-5
+Ft(")d Fi(is)j(zero)e(or)427 1898 y(less,)g(its)h(v)-5
b(alue)28 b(is)g(ignored)f(and)h(the)h(returned)f(P)n(olygon)e(will)i
(ha)n(v)n(e)f(the)i(n)n(um)n(b)r(er)f(of)g(v)n(ertices)f(sp)r
-(eci\014ed)427 1148 y(b)n(y)h Ft(")p Fi(maxv)n(ert)p
-Ft(")p Fi(.)259 1285 y Fd(maxv)m(ert)427 1385 y Fi(T)-7
+(eci\014ed)427 1997 y(b)n(y)h Ft(")p Fi(maxv)n(ert)p
+Ft(")p Fi(.)259 2132 y Fd(maxv)m(ert)427 2231 y Fi(T)-7
b(ogether)23 b(with)h Ft(")p Fi(maxerr)p Ft(")p Fi(,)f(this)h
(determines)g(ho)n(w)f(accurately)f(the)j(returned)e(P)n(olygon)f
-(represen)n(ts)g(the)427 1484 y(required)32 b(region)f(of)h(the)g(data)
+(represen)n(ts)g(the)427 2331 y(required)32 b(region)f(of)h(the)g(data)
g(arra)n(y)-7 b(.)49 b(It)33 b(giv)n(es)e(the)h(maxim)n(um)g(allo)n(w)n
(ed)f(n)n(um)n(b)r(er)h(of)h(v)n(ertices)e(in)h(the)427
-1584 y(returned)e(P)n(olygon.)42 b(Insigni\014can)n(t)30
+2430 y(returned)e(P)n(olygon.)42 b(Insigni\014can)n(t)30
b(v)n(ertices)f(are)g(remo)n(v)n(ed)g(from)h(the)g(accurate)f(outline,)
-i(one)f(b)n(y)g(one,)427 1683 y(un)n(til)38 b(the)f(n)n(um)n(b)r(er)g
+i(one)f(b)n(y)g(one,)427 2530 y(un)n(til)38 b(the)f(n)n(um)n(b)r(er)g
(of)h(v)n(ertices)e(remaining)g(in)h(the)h(returned)f(P)n(olygon)e
(equals)h Ft(")p Fi(maxv)n(ert)p Ft(")p Fi(,)i(or)e(the)427
-1783 y(largest)c(discrepancy)g(b)r(et)n(w)n(een)i(the)f(accurate)f
+2630 y(largest)c(discrepancy)g(b)r(et)n(w)n(een)i(the)f(accurate)f
(outline)i(and)f(the)h(returned)f(P)n(olygon)e(is)i(greater)e(than)427
-1883 y Ft(")p Fi(maxerr)p Ft(")p Fi(.)36 b(If)28 b Ft(")p
+2729 y Ft(")p Fi(maxerr)p Ft(")p Fi(.)36 b(If)28 b Ft(")p
Fi(maxv)n(ert)p Ft(")e Fi(is)i(less)g(than)g(3,)g(its)g(v)-5
b(alue)28 b(is)f(ignored)g(and)h(the)g(n)n(um)n(b)r(er)g(of)g(v)n
-(ertices)f(in)h(the)427 1982 y(returned)k(P)n(olygon)f(will)i(b)r(e)g
+(ertices)f(in)h(the)427 2829 y(returned)k(P)n(olygon)f(will)i(b)r(e)g
(the)g(minim)n(um)g(needed)g(to)f(ensure)g(that)h(the)g(discrepancy)f
-(b)r(et)n(w)n(een)g(the)427 2082 y(accurate)27 b(outline)g(and)h(the)g
+(b)r(et)n(w)n(een)g(the)427 2929 y(accurate)27 b(outline)g(and)h(the)g
(returned)f(P)n(olygon)e(is)j(less)f(than)h Ft(")p Fi(maxerr)p
-Ft(")p Fi(.)259 2219 y Fd(inside)427 2318 y Fi(P)n(oin)n(ter)i(to)g(an)
+Ft(")p Fi(.)259 3063 y Fd(inside)427 3162 y Fi(P)n(oin)n(ter)i(to)g(an)
h(arra)n(y)d(of)j(t)n(w)n(o)f(in)n(tegers)g(con)n(taining)g(the)h
(indices)g(of)g(a)f(pixel)h(kno)n(wn)f(to)h(b)r(e)g(inside)g(the)427
-2418 y(required)c(region.)35 b(This)28 b(is)f(needed)g(b)r(ecause)g
+3262 y(required)c(region.)35 b(This)28 b(is)f(needed)g(b)r(ecause)g
(the)h(supplied)g(data)f(arra)n(y)e(ma)n(y)h(con)n(tain)h(sev)n(eral)f
-(disjoin)n(t)427 2517 y(areas)i(of)i(pixels)g(that)g(satisfy)g(the)g
+(disjoin)n(t)427 3362 y(areas)i(of)i(pixels)g(that)g(satisfy)g(the)g
(criterion)f(sp)r(eci\014ed)h(b)n(y)f Ft(")p Fi(v)-5
b(alue)p Ft(")29 b Fi(and)h Ft(")p Fi(op)r(er)p Ft(")p
-Fi(.)42 b(In)30 b(suc)n(h)g(cases,)f(the)427 2617 y(area)h(describ)r
+Fi(.)42 b(In)30 b(suc)n(h)g(cases,)f(the)427 3461 y(area)h(describ)r
(ed)h(b)n(y)g(the)g(returned)g(P)n(olygon)e(will)i(b)r(e)h(the)f(one)g
(that)h(con)n(tains)e(the)h(pixel)g(sp)r(eci\014ed)h(b)n(y)427
-2717 y Ft(")p Fi(inside)p Ft(")p Fi(.)45 b(If)31 b(the)f(sp)r
+3561 y Ft(")p Fi(inside)p Ft(")p Fi(.)45 b(If)31 b(the)f(sp)r
(eci\014ed)h(pixel)f(is)h(outside)f(the)g(b)r(ounds)h(giv)n(en)f(b)n(y)
g Ft(")p Fi(lbnd)p Ft(")g Fi(and)g Ft(")p Fi(ubnd)p Ft(")p
-Fi(,)h(or)e(has)h(a)427 2816 y(v)-5 b(alue)34 b(that)g(do)r(es)f(not)h
+Fi(,)h(or)e(has)h(a)427 3661 y(v)-5 b(alue)34 b(that)g(do)r(es)f(not)h
(meet)f(the)h(criterion)f(sp)r(eci\014ed)h(b)n(y)f Ft(")p
Fi(v)-5 b(alue)p Ft(")33 b Fi(and)g Ft(")p Fi(op)r(er)p
-Ft(")p Fi(,)h(then)g(this)g(function)427 2916 y(will)26
+Ft(")p Fi(,)h(then)g(this)g(function)427 3760 y(will)26
b(searc)n(h)e(for)h(a)g(suitable)g(pixel.)36 b(The)26
b(searc)n(h)d(starts)i(at)g(the)h(cen)n(tral)f(pixel)g(and)g(pro)r
-(ceeds)g(in)h(a)f(spiral)427 3016 y(manner)i(un)n(til)h(a)g(pixel)f(is)
+(ceeds)g(in)h(a)f(spiral)427 3860 y(manner)i(un)n(til)h(a)g(pixel)f(is)
h(found)g(that)f(meets)h(the)g(sp)r(eci\014ed)g(crierion.)259
-3152 y Fd(starpix)427 3252 y Fi(A)19 b(\015ag)f(indicating)g(the)h
+3994 y Fd(starpix)427 4094 y Fi(A)19 b(\015ag)f(indicating)g(the)h
(nature)e(of)i(the)g(pixel)f(co)r(ordinate)f(system)h(used)h(to)f
-(describ)r(e)g(the)h(v)n(ertex)e(p)r(ositions)427 3351
+(describ)r(e)g(the)h(v)n(ertex)e(p)r(ositions)427 4193
y(in)31 b(the)g(returned)f(P)n(olygon.)44 b(If)31 b(non-zero,)f(the)h
(standard)f(Starlink)g(de\014nition)h(of)g(pixel)f(co)r(ordinate)g(is)
-427 3451 y(used)i(in)f(whic)n(h)h(a)f(pixel)g(with)h(in)n(teger)e
+427 4293 y(used)i(in)f(whic)n(h)h(a)f(pixel)g(with)h(in)n(teger)e
(index)i(I)f(spans)g(a)g(range)f(of)h(pixel)h(co)r(ordinate)e(from)h
-(\(I-1\))g(to)h(I)427 3551 y(\(i.e.)41 b(pixel)29 b(corners)e(ha)n(v)n
+(\(I-1\))g(to)h(I)427 4393 y(\(i.e.)41 b(pixel)29 b(corners)e(ha)n(v)n
(e)g(in)n(tegral)h(pixel)h(co)r(ordinates\).)39 b(If)29
b(zero,)f(the)h(de\014nition)g(of)g(pixel)g(co)r(ordinate)427
-3650 y(used)24 b(b)n(y)f(other)g(AST)h(functions)g(suc)n(h)g(as)f
+4492 y(used)24 b(b)n(y)f(other)g(AST)h(functions)g(suc)n(h)g(as)f
(astResample,)g(astMask,)h(etc.,)g(is)g(used.)35 b(In)24
-b(this)g(de\014nition,)h(a)427 3750 y(pixel)i(with)g(in)n(teger)f
+b(this)g(de\014nition,)h(a)427 4592 y(pixel)i(with)g(in)n(teger)f
(index)h(I)f(spans)g(a)h(range)e(of)i(pixel)f(co)r(ordinate)g(from)g
-(\(I-0.5\))g(to)h(\(I+0.5\))f(\(i.e.)37 b(pixel)427 3850
+(\(I-0.5\))g(to)h(\(I+0.5\))f(\(i.e.)37 b(pixel)427 4691
y(cen)n(tres)27 b(ha)n(v)n(e)f(in)n(tegral)h(pixel)g(co)r(ordinates\).)
-259 3986 y Fd(b)s(o)m(xsize)427 4086 y Fi(The)38 b(full)g(width)g(in)g
+259 4826 y Fd(b)s(o)m(xsize)427 4925 y Fi(The)38 b(full)g(width)g(in)g
(pixels)f(of)h(a)f(smo)r(othing)g(b)r(o)n(x)g(to)g(b)r(e)h(applied)g
(to)f(the)h(p)r(olygon)e(v)n(ertices)h(b)r(efore)427
-4185 y(do)n(wnsizing)29 b(the)i(p)r(olygon)e(to)i(a)f(smaller)f(n)n(um)
+5025 y(do)n(wnsizing)29 b(the)i(p)r(olygon)e(to)i(a)f(smaller)f(n)n(um)
n(b)r(er)h(of)g(v)n(ertices.)44 b(If)31 b(an)f(ev)n(en)g(n)n(um)n(b)r
-(er)g(is)g(supplied,)h(the)427 4285 y(next)d(larger)e(o)r(dd)i(n)n(um)n
+(er)g(is)g(supplied,)h(the)427 5125 y(next)d(larger)e(o)r(dd)i(n)n(um)n
(b)r(er)f(is)g(used.)37 b(V)-7 b(alues)28 b(of)f(one)g(or)g(zero)g
-(result)g(in)h(no)f(smo)r(othing.)0 4455 y Fd(Returned)32
-b(V)-8 b(alue:)259 4599 y(astOutline)p Fk(<)p Fd(X)p
-Fk(>)p Fd(\(\))427 4698 y Fi(The)28 b(n)n(um)n(b)r(er)f(of)h(pixels)f
+(result)g(in)h(no)f(smo)r(othing.)0 5289 y Fd(Returned)32
+b(V)-8 b(alue:)259 5429 y(astOutline)p Fk(<)p Fd(X)p
+Fk(>)p Fd(\(\))427 5528 y Fi(The)28 b(n)n(um)n(b)r(er)f(of)h(pixels)f
(to)h(whic)n(h)f(a)g(v)-5 b(alue)28 b(of)f Ft(")p Fi(badv)-5
-b(al)p Ft(")27 b Fi(has)g(b)r(een)h(assigned.)0 4868
-y Fd(Notes:)340 5158 y Fh(\017)45 b Fi(This)27 b(function)h(pro)r
-(ceeds)e(b)n(y)h(\014rst)g(\014nding)g(a)g(v)n(ery)f(accurate)g(p)r
-(olygon,)g(and)h(then)h(remo)n(ving)d(insigni\014-)427
-5257 y(can)n(t)i(v)n(ertices)g(from)g(this)h(\014ne)g(p)r(olygon)f
-(using)g(astDo)n(wnsize.)340 5394 y Fh(\017)45 b Fi(The)27
-b(returned)g(P)n(olygon)d(is)j(the)h(outer)e(b)r(oundary)g(of)h(the)g
-(con)n(tiguous)f(set)h(of)f(pixels)h(that)g(includes)g(ths)427
-5494 y(sp)r(eci\014ed)k Ft(")p Fi(inside)p Ft(")f Fi(p)r(oin)n(t,)i
-(and)f(satisfy)f(the)h(sp)r(eci\014ed)g(v)-5 b(alue)31
-b(requiremen)n(t.)46 b(This)30 b(set)h(of)g(pixels)f(ma)n(y)427
-5593 y(p)r(oten)n(tially)22 b(include)h Ft(")p Fi(holes)p
+b(al)p Ft(")27 b Fi(has)g(b)r(een)h(assigned.)0 5693
+y Fd(Notes:)p eop end
+%%Page: 306 316
+TeXDict begin 306 315 bop 0 52 a FF(306)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 489 y Fh(\017)45
+b Fi(This)27 b(function)h(pro)r(ceeds)e(b)n(y)h(\014rst)g(\014nding)g
+(a)g(v)n(ery)f(accurate)g(p)r(olygon,)g(and)h(then)h(remo)n(ving)d
+(insigni\014-)427 589 y(can)n(t)i(v)n(ertices)g(from)g(this)h(\014ne)g
+(p)r(olygon)f(using)g(astDo)n(wnsize.)340 722 y Fh(\017)45
+b Fi(The)27 b(returned)g(P)n(olygon)d(is)j(the)h(outer)e(b)r(oundary)g
+(of)h(the)g(con)n(tiguous)f(set)h(of)f(pixels)h(that)g(includes)g(ths)
+427 822 y(sp)r(eci\014ed)k Ft(")p Fi(inside)p Ft(")f
+Fi(p)r(oin)n(t,)i(and)f(satisfy)f(the)h(sp)r(eci\014ed)g(v)-5
+b(alue)31 b(requiremen)n(t.)46 b(This)30 b(set)h(of)g(pixels)f(ma)n(y)
+427 922 y(p)r(oten)n(tially)22 b(include)h Ft(")p Fi(holes)p
Ft(")d Fi(where)i(the)g(pixel)g(v)-5 b(alues)22 b(fail)g(to)g(meet)h
(the)f(sp)r(eci\014ed)g(v)-5 b(alue)22 b(requiremen)n(t.)427
-5693 y(Suc)n(h)28 b(holes)f(will)h(b)r(e)g(ignored)e(b)n(y)h(this)h
-(function.)p eop end
-%%Page: 305 315
-TeXDict begin 305 314 bop 3643 52 a FF(305)340 351 y
-Fh(\017)45 b Fi(A)27 b(v)-5 b(alue)25 b(of)h(zero)f(will)h(b)r(e)g
-(returned)g(if)g(this)g(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(the)f
-(global)f(error)f(status)h(set,)h(or)427 451 y(if)i(it)g(should)g(fail)
-f(for)h(an)n(y)e(reason.)-2 611 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s(des)n
-(:)227 757 y Fi(T)-7 b(o)26 b(select)g(the)g(appropriate)e(masking)h
-(function,)i(y)n(ou)e(should)h(replace)f Fk(<)p Fi(X)p
-Fk(>)h Fi(in)g(the)g(generic)f(function)i(name)227 857
-y(astOutline)p Fk(<)p Fi(X)p Fk(>)18 b Fi(with)h(a)f(1-)g(or)g(2-c)n
-(haracter)e(data)i(t)n(yp)r(e)g(co)r(de,)j(so)d(as)g(to)g(matc)n(h)g
-(the)h(n)n(umerical)f(t)n(yp)r(e)h Fk(<)p Fi(Xt)n(yp)r(e)p
-Fk(>)227 957 y Fi(of)28 b(the)g(data)f(y)n(ou)g(are)f(pro)r(cessing,)h
-(as)f(follo)n(ws:)340 1092 y Fh(\017)45 b Fi(D:)28 b(double)340
-1223 y Fh(\017)45 b Fi(F:)28 b(\015oat)340 1354 y Fh(\017)45
-b Fi(L:)28 b(long)f(in)n(t)340 1486 y Fh(\017)45 b Fi(UL:)28
-b(unsigned)g(long)e(in)n(t)340 1617 y Fh(\017)45 b Fi(I:)28
-b(in)n(t)340 1749 y Fh(\017)45 b Fi(UI:)28 b(unsigned)g(in)n(t)340
-1880 y Fh(\017)45 b Fi(S:)28 b(short)f(in)n(t)340 2011
+1021 y(Suc)n(h)28 b(holes)f(will)h(b)r(e)g(ignored)e(b)n(y)h(this)h
+(function.)340 1155 y Fh(\017)45 b Fi(A)27 b(v)-5 b(alue)25
+b(of)h(zero)f(will)h(b)r(e)g(returned)g(if)g(this)g(function)h(is)f(in)
+n(v)n(ok)n(ed)e(with)j(the)f(global)f(error)f(status)h(set,)h(or)427
+1254 y(if)i(it)g(should)g(fail)f(for)h(an)n(y)e(reason.)-2
+1418 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s(des)n(:)227 1564
+y Fi(T)-7 b(o)26 b(select)g(the)g(appropriate)e(masking)h(function,)i
+(y)n(ou)e(should)h(replace)f Fk(<)p Fi(X)p Fk(>)h Fi(in)g(the)g
+(generic)f(function)i(name)227 1663 y(astOutline)p Fk(<)p
+Fi(X)p Fk(>)18 b Fi(with)h(a)f(1-)g(or)g(2-c)n(haracter)e(data)i(t)n
+(yp)r(e)g(co)r(de,)j(so)d(as)g(to)g(matc)n(h)g(the)h(n)n(umerical)f(t)n
+(yp)r(e)h Fk(<)p Fi(Xt)n(yp)r(e)p Fk(>)227 1763 y Fi(of)28
+b(the)g(data)f(y)n(ou)g(are)f(pro)r(cessing,)h(as)f(follo)n(ws:)340
+1901 y Fh(\017)45 b Fi(D:)28 b(double)340 2034 y Fh(\017)45
+b Fi(F:)28 b(\015oat)340 2168 y Fh(\017)45 b Fi(L:)28
+b(long)f(in)n(t)340 2301 y Fh(\017)45 b Fi(UL:)28 b(unsigned)g(long)e
+(in)n(t)340 2435 y Fh(\017)45 b Fi(I:)28 b(in)n(t)340
+2569 y Fh(\017)45 b Fi(UI:)28 b(unsigned)g(in)n(t)340
+2702 y Fh(\017)45 b Fi(S:)28 b(short)f(in)n(t)340 2836
y Fh(\017)45 b Fi(US:)28 b(unsigned)g(short)f(in)n(t)340
-2143 y Fh(\017)45 b Fi(B:)28 b(b)n(yte)f(\(signed)h(c)n(har\))340
-2274 y Fh(\017)45 b Fi(UB:)28 b(unsigned)f(b)n(yte)h(\(unsigned)g(c)n
-(har\))227 2435 y(F)-7 b(or)34 b(example,)h(astOutlineD)f(w)n(ould)f(b)
+2969 y Fh(\017)45 b Fi(B:)28 b(b)n(yte)f(\(signed)h(c)n(har\))340
+3103 y Fh(\017)45 b Fi(UB:)28 b(unsigned)f(b)n(yte)h(\(unsigned)g(c)n
+(har\))227 3266 y(F)-7 b(or)34 b(example,)h(astOutlineD)f(w)n(ould)f(b)
r(e)i(used)f(to)g(pro)r(cess)e Ft(")p Fi(double)p Ft(")i
Fi(data,)h(while)f(astOutlineS)g(w)n(ould)f(b)r(e)227
-2534 y(used)28 b(to)f(pro)r(cess)g Ft(")p Fi(short)f(in)n(t)p
-Ft(")i Fi(data,)f(etc.)p 0 2731 3780 12 v 0 2862 a Fz(astOv)l(erlap)299
+3366 y(used)28 b(to)f(pro)r(cess)g Ft(")p Fi(short)f(in)n(t)p
+Ft(")i Fi(data,)f(etc.)p 0 3566 3780 12 v 0 3698 a Fz(astOv)l(erlap)299
b Fe(T)-10 b(est)38 b(if)h(t)m(w)m(o)e(regions)g(o)m(v)m(erlap)g(eac)m
-(h)h(other)296 b Fz(astOv)l(erlap)0 3048 y Fd(Description:)44
+(h)h(other)296 b Fz(astOv)l(erlap)0 3888 y Fd(Description:)44
b Fi(This)39 b(function)h(returns)e(an)g(in)n(teger)g(v)-5
b(alue)39 b(indicating)g(if)g(the)g(t)n(w)n(o)g(supplied)g(Regions)f(o)
-n(v)n(erlap.)227 3148 y(The)30 b(t)n(w)n(o)g(Regions)f(are)g(con)n(v)n
+n(v)n(erlap.)227 3988 y(The)30 b(t)n(w)n(o)g(Regions)f(are)g(con)n(v)n
(erted)f(to)i(a)g(commnon)f(co)r(ordinate)g(system)h(b)r(efore)f(p)r
-(erforming)h(the)g(c)n(hec)n(k.)43 b(If)227 3247 y(this)33
+(erforming)h(the)g(c)n(hec)n(k.)43 b(If)227 4087 y(this)33
b(con)n(v)n(ersion)e(is)i(not)g(p)r(ossible)f(\(for)h(instance)g(b)r
(ecause)f(the)h(t)n(w)n(o)g(Regions)e(represen)n(t)h(areas)f(in)i
-(di\013eren)n(t)227 3347 y(domains\),)28 b(then)g(the)g(c)n(hec)n(k)e
+(di\013eren)n(t)227 4187 y(domains\),)28 b(then)g(the)g(c)n(hec)n(k)e
(cannot)h(b)r(e)h(p)r(erformed)g(and)f(a)g(zero)g(v)-5
-b(alue)27 b(is)h(returned)f(to)g(indicate)h(this.)0 3495
+b(alue)27 b(is)h(returned)f(to)g(indicate)h(this.)0 4338
y Fd(Synopsis:)121 b Ft(int)42 b(astOverlap\()d(AstRegion)h
Fh(\003)p Ft(this,)h(AstRegion)f Fh(\003)p Ft(that)h(\))0
-3643 y Fd(P)m(arameters:)259 3778 y(this)427 3878 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(\014rst)f(Region.)259 4009 y Fd(that)427
-4109 y Fi(P)n(oin)n(ter)f(to)i(the)g(second)f(Region.)0
-4269 y Fd(Returned)32 b(V)-8 b(alue:)259 4404 y(astOv)m(erlap\(\))427
-4504 y Fi(A)28 b(v)-5 b(alue)28 b(indicating)f(if)h(there)g(is)f(an)n
+4489 y Fd(P)m(arameters:)259 4627 y(this)427 4726 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(\014rst)f(Region.)259 4860 y Fd(that)427
+4959 y Fi(P)n(oin)n(ter)f(to)i(the)g(second)f(Region.)0
+5123 y Fd(Returned)32 b(V)-8 b(alue:)259 5261 y(astOv)m(erlap\(\))427
+5360 y Fi(A)28 b(v)-5 b(alue)28 b(indicating)f(if)h(there)g(is)f(an)n
(y)g(o)n(v)n(erlap)e(b)r(et)n(w)n(een)j(the)g(t)n(w)n(o)f(Regions.)36
-b(P)n(ossible)26 b(v)-5 b(alues)27 b(are:)427 4619 y(0)i(-)f(The)h(c)n
+b(P)n(ossible)26 b(v)-5 b(alues)27 b(are:)427 5477 y(0)i(-)f(The)h(c)n
(hec)n(k)f(could)h(not)g(b)r(e)g(p)r(erformed)f(b)r(ecause)g(the)i
(second)e(Region)g(could)h(not)f(b)r(e)i(mapp)r(ed)f(in)n(to)427
-4719 y(the)f(co)r(ordinate)f(system)g(of)h(the)g(\014rst)f(Region.)427
-4834 y(1)g(-)h(There)f(is)g(no)h(o)n(v)n(erlap)d(b)r(et)n(w)n(een)j
-(the)g(t)n(w)n(o)f(Regions.)427 4950 y(2)g(-)h(The)f(\014rst)h(Region)f
-(is)g(completely)h(inside)f(the)h(second)f(Region.)427
-5065 y(3)g(-)h(The)f(second)g(Region)g(is)h(completely)f(inside)h(the)g
-(\014rst)f(Region.)427 5181 y(4)g(-)h(There)f(is)g(partial)g(o)n(v)n
-(erlap)f(b)r(et)n(w)n(een)h(the)h(t)n(w)n(o)f(Regions.)427
-5296 y(5)g(-)h(The)f(Regions)g(are)g(iden)n(tical)g(to)h(within)g
-(their)f(uncertain)n(ties.)427 5412 y(6)e(-)g(The)g(second)g(Region)f
-(is)h(the)h(exact)e(negation)g(of)h(the)h(\014rst)f(Region)f(to)h
-(within)h(their)f(uncertain)n(ties.)0 5572 y Fd(Notes:)p
-eop end
-%%Page: 306 316
-TeXDict begin 306 315 bop 0 52 a FF(306)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
-b Fi(The)22 b(returned)f(v)-5 b(alues)22 b(5)f(and)h(6)f(do)g(not)h(c)n
-(hec)n(k)f(the)h(v)-5 b(alue)22 b(of)f(the)h(Closed)g(attribute)f(in)h
-(the)h(t)n(w)n(o)d(Regions.)340 484 y Fh(\017)45 b Fi(A)29
-b(v)-5 b(alue)29 b(of)f(zero)g(will)h(b)r(e)g(returned)f(if)h(this)g
-(function)g(is)f(in)n(v)n(ok)n(ed)f(with)j(the)f(AST)g(error)d(status)j
-(set,)f(or)427 584 y(if)g(it)g(should)g(fail)f(for)h(an)n(y)e(reason.)p
-0 783 3780 12 v 0 914 a Fz(astP)l(arameterName)1371 915
-y Fe(Get)38 b(the)h(name)f(of)g(the)1337 1015 y(global)f(parameter)f
-(at)i(a)1316 1129 y(giv)m(en)g(index)g(within)f(the)1748
-1244 y(T)-10 b(able)2649 914 y Fz(astP)l(arameterName)0
-1410 y Fd(Description:)44 b Fi(This)32 b(function)h(returns)e(a)g
+5576 y(the)f(co)r(ordinate)f(system)g(of)h(the)g(\014rst)f(Region.)427
+5693 y(1)g(-)h(There)f(is)g(no)h(o)n(v)n(erlap)d(b)r(et)n(w)n(een)j
+(the)g(t)n(w)n(o)f(Regions.)p eop end
+%%Page: 307 317
+TeXDict begin 307 316 bop 3643 52 a FF(307)427 351 y
+Fi(2)27 b(-)h(The)f(\014rst)h(Region)f(is)g(completely)h(inside)f(the)h
+(second)f(Region.)427 471 y(3)g(-)h(The)f(second)g(Region)g(is)h
+(completely)f(inside)h(the)g(\014rst)f(Region.)427 591
+y(4)g(-)h(There)f(is)g(partial)g(o)n(v)n(erlap)f(b)r(et)n(w)n(een)h
+(the)h(t)n(w)n(o)f(Regions.)427 711 y(5)g(-)h(The)f(Regions)g(are)g
+(iden)n(tical)g(to)h(within)g(their)f(uncertain)n(ties.)427
+831 y(6)e(-)g(The)g(second)g(Region)f(is)h(the)h(exact)e(negation)g(of)
+h(the)h(\014rst)f(Region)f(to)h(within)h(their)f(uncertain)n(ties.)0
+1008 y Fd(Notes:)340 1305 y Fh(\017)45 b Fi(The)22 b(returned)f(v)-5
+b(alues)22 b(5)f(and)h(6)f(do)g(not)h(c)n(hec)n(k)f(the)h(v)-5
+b(alue)22 b(of)f(the)h(Closed)g(attribute)f(in)h(the)h(t)n(w)n(o)d
+(Regions.)340 1445 y Fh(\017)45 b Fi(A)29 b(v)-5 b(alue)29
+b(of)f(zero)g(will)h(b)r(e)g(returned)f(if)h(this)g(function)g(is)f(in)
+n(v)n(ok)n(ed)f(with)j(the)f(AST)g(error)d(status)j(set,)f(or)427
+1545 y(if)g(it)g(should)g(fail)f(for)h(an)n(y)e(reason.)p
+0 1759 3780 12 v 0 1889 a Fz(astP)l(arameterName)1371
+1890 y Fe(Get)38 b(the)h(name)f(of)g(the)1337 1990 y(global)f
+(parameter)f(at)i(a)1316 2105 y(giv)m(en)g(index)g(within)f(the)1748
+2219 y(T)-10 b(able)2649 1889 y Fz(astP)l(arameterName)0
+2399 y Fd(Description:)44 b Fi(This)32 b(function)h(returns)e(a)g
(string)h(holding)f(the)i(name)e(of)h(the)g(global)f(parameter)g(with)h
-(the)g(giv)n(en)227 1509 y(index)c(within)g(the)g(T)-7
-b(able.)227 1634 y(This)33 b(function)g(is)f(in)n(tended)h(primarily)e
+(the)g(giv)n(en)227 2499 y(index)c(within)g(the)g(T)-7
+b(able.)227 2631 y(This)33 b(function)g(is)f(in)n(tended)h(primarily)e
(as)h(a)g(means)g(of)h(iterating)e(round)h(all)g(the)h(parameters)e(in)
-i(a)f(T)-7 b(able.)227 1734 y(F)g(or)29 b(this)h(purp)r(ose,)g(the)g(n)
+i(a)f(T)-7 b(able.)227 2731 y(F)g(or)29 b(this)h(purp)r(ose,)g(the)g(n)
n(um)n(b)r(er)f(of)h(parameters)e(in)h(the)h(T)-7 b(able)30
b(is)f(giv)n(en)g(b)n(y)g(the)h(Nparameter)f(attribute)h(of)227
-1833 y(the)i(T)-7 b(able.)46 b(This)31 b(function)g(could)g(then)g(b)r
+2830 y(the)i(T)-7 b(able.)46 b(This)31 b(function)g(could)g(then)g(b)r
(e)h(called)e(in)h(a)g(lo)r(op,)g(with)h(the)f(index)g(v)-5
-b(alue)31 b(going)e(from)i(zero)f(to)227 1933 y(one)d(less)h(than)f
-(Nparameter.)227 2058 y(Note,)22 b(the)f(index)g(asso)r(ciated)e(with)i
+b(alue)31 b(going)e(from)i(zero)f(to)227 2930 y(one)d(less)h(than)f
+(Nparameter.)227 3062 y(Note,)22 b(the)f(index)g(asso)r(ciated)e(with)i
(a)g(parameter)e(decreases)g(monotonically)g(with)i(the)g(age)f(of)g
-(the)h(parameter:)227 2157 y(the)28 b(oldest)g(P)n(arameter)d(in)j(the)
+(the)h(parameter:)227 3161 y(the)28 b(oldest)g(P)n(arameter)d(in)j(the)
h(T)-7 b(able)27 b(will)h(ha)n(v)n(e)f(index)h(one,)f(and)h(the)g(P)n
-(arameter)d(added)j(most)g(recen)n(tly)f(to)227 2257
+(arameter)d(added)j(most)g(recen)n(tly)f(to)227 3261
y(the)h(T)-7 b(able)28 b(will)f(ha)n(v)n(e)g(the)h(largest)e(index.)0
-2407 y Fd(Synopsis:)121 b Ft(const)41 b(char)h Fh(\003)p
+3425 y Fd(Synopsis:)121 b Ft(const)41 b(char)h Fh(\003)p
Ft(astParameterName)o(\()37 b(AstTable)k Fh(\003)p Ft(this,)g(int)h
-(index)g(\))0 2556 y Fd(P)m(arameters:)259 2693 y(this)427
-2793 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(T)-7 b(able.)259
-2926 y Fd(index)427 3025 y Fi(The)32 b(index)h(in)n(to)f(the)g(list)g
+(index)g(\))0 3589 y Fd(P)m(arameters:)259 3741 y(this)427
+3840 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(T)-7 b(able.)259
+3980 y Fd(index)427 4080 y Fi(The)32 b(index)h(in)n(to)f(the)g(list)g
(of)h(parameters.)48 b(The)33 b(\014rst)e(parameter)g(has)h(index)g
-(one,)h(and)f(the)g(last)g(has)427 3125 y(index)c Ft(")p
-Fi(Nparameter)p Ft(")p Fi(.)0 3287 y Fd(Returned)k(V)-8
-b(alue:)259 3424 y(astP)m(arameterName\(\))427 3523 y
+(one,)h(and)f(the)g(last)g(has)427 4180 y(index)c Ft(")p
+Fi(Nparameter)p Ft(")p Fi(.)0 4356 y Fd(Returned)k(V)-8
+b(alue:)259 4507 y(astP)m(arameterName\(\))427 4607 y
Fi(A)28 b(p)r(oin)n(ter)f(to)h(a)f(n)n(ull-terminated)g(string)g(con)n
(taining)g(the)h(upp)r(er)g(case)e(parameter)g(name.)0
-3685 y Fd(Notes:)340 3968 y Fh(\017)45 b Fi(The)36 b(returned)g(p)r
+4784 y Fd(Notes:)340 5081 y Fh(\017)45 b Fi(The)36 b(returned)g(p)r
(oin)n(ter)g(is)g(guaran)n(teed)e(to)i(remain)g(v)-5
b(alid)36 b(and)g(the)g(string)g(to)g(whic)n(h)g(it)g(p)r(oin)n(ts)g
-(will)427 4068 y(not)c(b)r(e)g(o)n(v)n(er-written)e(for)i(a)f(total)h
+(will)427 5181 y(not)c(b)r(e)g(o)n(v)n(er-written)e(for)i(a)f(total)h
(of)g(50)f(successiv)n(e)f(in)n(v)n(o)r(cations)g(of)i(this)g
-(function.)51 b(After)32 b(this,)h(the)427 4168 y(memory)27
+(function.)51 b(After)32 b(this,)h(the)427 5280 y(memory)27
b(con)n(taining)f(the)i(string)f(ma)n(y)f(b)r(e)i(re-used,)e(so)h(a)g
(cop)n(y)f(of)i(the)f(string)g(should)g(b)r(e)h(made)f(if)h(it)g(is)427
-4267 y(needed)g(for)f(longer)f(than)i(this.)340 4400
+5380 y(needed)g(for)f(longer)f(than)i(this.)340 5520
y Fh(\017)45 b Fi(A)26 b(NULL)g(p)r(oin)n(ter)e(will)i(b)r(e)f
(returned)g(if)h(this)g(function)f(is)h(in)n(v)n(ok)n(ed)d(with)j(the)g
-(AST)f(error)f(status)h(set,)g(or)427 4500 y(if)j(it)g(should)g(fail)f
-(for)h(an)n(y)e(reason.)p 0 4699 V 0 4831 a Fz(astPcdMap)774
-b Fe(Create)37 b(a)h(PcdMap)774 b Fz(astPcdMap)0 5020
-y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g
-(PcdMap)g(and)h(optionally)e(initialises)i(its)g(attributes.)227
-5145 y(A)35 b(PcdMap)f(is)g(a)h(non-linear)e(Mapping)h(whic)n(h)g
-(transforms)f(2-dimensional)h(p)r(ositions)g(to)g(correct)f(for)h(the)
-227 5244 y(radial)h(distortion)h(in)n(tro)r(duced)g(b)n(y)g(some)f
-(cameras)g(and)h(telescop)r(es.)62 b(This)36 b(can)g(tak)n(e)f(the)i
-(form)f(either)g(of)227 5344 y(pincushion)28 b(or)f(barrel)f
-(distortion,)h(and)g(is)h(c)n(haracterized)d(b)n(y)j(a)f(single)g
-(distortion)g(co)r(e\016cien)n(t.)227 5469 y(A)g(PcdMap)f(is)g(sp)r
-(eci\014ed)h(b)n(y)f(giving)g(this)h(distortion)f(co)r(e\016cien)n(t)g
-(and)g(the)h(co)r(ordinates)e(of)i(the)g(cen)n(tre)f(of)g(the)227
-5568 y(radial)h(distortion.)36 b(The)28 b(forw)n(ard)d(transformation)h
-(of)i(a)f(PcdMap)g(applies)g(the)h(distortion:)227 5693
-y(RD)g(=)g(R)g Fh(\003)f Fi(\()h(1)f(+)g(C)h Fh(\003)f
-Fi(R)h Fh(\003)f Fi(R)h(\))p eop end
-%%Page: 307 317
-TeXDict begin 307 316 bop 3643 52 a FF(307)227 351 y
-Fi(where)29 b(R)h(is)g(the)g(undistorted)f(radial)g(distance)g(from)h
+(AST)f(error)f(status)h(set,)g(or)427 5620 y(if)j(it)g(should)g(fail)f
+(for)h(an)n(y)e(reason.)p eop end
+%%Page: 308 318
+TeXDict begin 308 317 bop 0 52 a FF(308)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 483 a Fz(astPcdMap)774 b Fe(Create)37 b(a)h(PcdMap)774
+b Fz(astPcdMap)0 679 y Fd(Description:)44 b Fi(This)28
+b(function)g(creates)f(a)g(new)g(PcdMap)g(and)h(optionally)e
+(initialises)i(its)g(attributes.)227 807 y(A)35 b(PcdMap)f(is)g(a)h
+(non-linear)e(Mapping)h(whic)n(h)g(transforms)f(2-dimensional)h(p)r
+(ositions)g(to)g(correct)f(for)h(the)227 907 y(radial)h(distortion)h
+(in)n(tro)r(duced)g(b)n(y)g(some)f(cameras)g(and)h(telescop)r(es.)62
+b(This)36 b(can)g(tak)n(e)f(the)i(form)f(either)g(of)227
+1006 y(pincushion)28 b(or)f(barrel)f(distortion,)h(and)g(is)h(c)n
+(haracterized)d(b)n(y)j(a)f(single)g(distortion)g(co)r(e\016cien)n(t.)
+227 1135 y(A)g(PcdMap)f(is)g(sp)r(eci\014ed)h(b)n(y)f(giving)g(this)h
+(distortion)f(co)r(e\016cien)n(t)g(and)g(the)h(co)r(ordinates)e(of)i
+(the)g(cen)n(tre)f(of)g(the)227 1234 y(radial)h(distortion.)36
+b(The)28 b(forw)n(ard)d(transformation)h(of)i(a)f(PcdMap)g(applies)g
+(the)h(distortion:)227 1362 y(RD)g(=)g(R)g Fh(\003)f
+Fi(\()h(1)f(+)g(C)h Fh(\003)f Fi(R)h Fh(\003)f Fi(R)h(\))227
+1491 y(where)h(R)h(is)g(the)g(undistorted)f(radial)g(distance)g(from)h
(the)g(distortion)f(cen)n(tre)g(\(sp)r(eci\014ed)h(b)n(y)f(attribute)h
-(Pcd-)227 451 y(Cen\),)k(RD)e(is)g(the)g(radial)e(distance)i(from)f
+(Pcd-)227 1590 y(Cen\),)k(RD)e(is)g(the)g(radial)e(distance)i(from)f
(the)i(same)e(cen)n(tre)g(in)h(the)g(presence)f(of)h(distortion,)g(and)
-g(C)g(is)f(the)227 551 y(distortion)c(co)r(e\016cien)n(t)h(\(giv)n(en)f
-(b)n(y)g(attribute)h(Disco\).)227 678 y(The)33 b(in)n(v)n(erse)f
+g(C)g(is)f(the)227 1690 y(distortion)c(co)r(e\016cien)n(t)h(\(giv)n(en)
+f(b)n(y)g(attribute)h(Disco\).)227 1818 y(The)33 b(in)n(v)n(erse)f
(transformation)f(of)i(a)f(PcdMap)h(remo)n(v)n(es)d(the)k(distortion)e
(pro)r(duced)h(b)n(y)f(the)h(forw)n(ard)f(trans-)227
-777 y(formation.)42 b(The)29 b(expression)f(used)i(to)f(deriv)n(e)g(R)g
-(from)g(RD)i(is)e(an)g(appro)n(ximate)f(in)n(v)n(erse)g(of)h(the)h
-(expression)227 877 y(ab)r(o)n(v)n(e,)f(obtained)g(from)g(t)n(w)n(o)g
+1918 y(formation.)42 b(The)29 b(expression)f(used)i(to)f(deriv)n(e)g(R)
+g(from)g(RD)i(is)e(an)g(appro)n(ximate)f(in)n(v)n(erse)g(of)h(the)h
+(expression)227 2017 y(ab)r(o)n(v)n(e,)f(obtained)g(from)g(t)n(w)n(o)g
(iterations)f(of)h(the)h(Newton-Raphson)f(metho)r(d.)42
-b(The)30 b(mismatc)n(h)f(b)r(et)n(w)n(een)g(the)227 977
+b(The)30 b(mismatc)n(h)f(b)r(et)n(w)n(een)g(the)227 2117
y(forw)n(ard)d(and)h(in)n(v)n(erse)f(expressions)f(is)i(negligible)g
(for)f(astrometric)g(applications)g(\(to)i(reac)n(h)e(1)h(milliarcsec)f
-(at)227 1076 y(the)g(edge)g(of)g(the)g(Anglo-Australian)e(T)-7
+(at)227 2217 y(the)g(edge)g(of)g(the)g(Anglo-Australian)e(T)-7
b(elescop)r(e)25 b(triplet)h(or)f(a)h(Sc)n(hmidt)g(\014eld)g(w)n(ould)f
-(require)g(\014eld)h(diameters)227 1176 y(of)i(2.4)f(and)g(42)g
-(degrees)f(resp)r(ectiv)n(ely\).)227 1303 y(If)37 b(a)e(PcdMap)h(is)g
+(require)g(\014eld)h(diameters)227 2316 y(of)i(2.4)f(and)g(42)g
+(degrees)f(resp)r(ectiv)n(ely\).)227 2444 y(If)37 b(a)e(PcdMap)h(is)g
(in)n(v)n(erted)f(\(e.g.)62 b(using)36 b(astIn)n(v)n(ert\))f(then)h
(the)h(roles)d(of)i(the)h(forw)n(ard)d(and)i(in)n(v)n(erse)f(trans-)227
-1403 y(formations)g(are)f(rev)n(ersed;)k(the)e(forw)n(ard)e
+2544 y(formations)g(are)f(rev)n(ersed;)k(the)e(forw)n(ard)e
(transformation)g(will)i(remo)n(v)n(e)e(the)i(distortion,)h(and)e(the)h
-(in)n(v)n(erse)227 1502 y(transformation)26 b(will)i(apply)f(it.)0
-1657 y Fd(Synopsis:)121 b Ft(AstPcdMap)40 b Fh(\003)p
+(in)n(v)n(erse)227 2644 y(transformation)26 b(will)i(apply)f(it.)0
+2800 y Fd(Synopsis:)121 b Ft(AstPcdMap)40 b Fh(\003)p
Ft(astPcdMap\()f(double)i(disco,)g(const)g(double)h(pcdcen[2],)d(const)
-i(char)h Fh(\003)p Ft(options,)227 1757 y(...)86 b(\))0
-1911 y Fd(P)m(arameters:)259 2053 y(disco)427 2153 y
+i(char)h Fh(\003)p Ft(options,)227 2900 y(...)86 b(\))0
+3057 y Fd(P)m(arameters:)259 3200 y(disco)427 3300 y
Fi(The)23 b(distortion)f(co)r(e\016cien)n(t.)35 b(Negativ)n(e)21
b(v)-5 b(alues)23 b(giv)n(e)e(barrel)h(distortion,)h(p)r(ositiv)n(e)f
-(v)-5 b(alues)22 b(giv)n(e)g(pincush-)427 2252 y(ion)28
+(v)-5 b(alues)22 b(giv)n(e)g(pincush-)427 3400 y(ion)28
b(distortion,)f(and)g(zero)g(giv)n(es)f(no)h(distortion.)259
-2388 y Fd(p)s(cdcen)427 2487 y Fi(A)h(2-elemen)n(t)f(arra)n(y)e(con)n
+3536 y Fd(p)s(cdcen)427 3636 y Fi(A)h(2-elemen)n(t)f(arra)n(y)e(con)n
(taining)i(the)h(co)r(ordinates)e(of)i(the)g(cen)n(tre)f(of)g(the)h
-(distortion.)259 2623 y Fd(options)427 2723 y Fi(P)n(oin)n(ter)f(to)h
+(distortion.)259 3772 y Fd(options)427 3872 y Fi(P)n(oin)n(ter)f(to)h
(a)g(n)n(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 2822 y(assignmen)n(ts)d
+(comma-separated)e(list)i(of)g(attribute)427 3972 y(assignmen)n(ts)d
(to)h(b)r(e)h(used)f(for)g(initialising)g(the)g(new)h(PcdMap.)35
b(The)27 b(syn)n(tax)e(used)h(is)g(iden)n(tical)g(to)g(that)427
-2922 y(for)g(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
+4071 y(for)g(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n
(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-3021 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 3157
-y Fd(...)427 3257 y Fi(If)38 b(the)g Ft(")p Fi(options)p
+4171 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 4307
+y Fd(...)427 4407 y Fi(If)38 b(the)g Ft(")p Fi(options)p
Ft(")e Fi(string)h(con)n(tains)f Ft(")p Fi(\045)p Ft(")h
Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g(list)h(of)f
-(additional)427 3356 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
+(additional)427 4507 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
(order)e(to)h(supply)h(v)-5 b(alues)27 b(to)g(b)r(e)h(substituted)h
-(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 3456 y(rules)25
+(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 4606 y(rules)25
b(for)f(supplying)h(these)g(are)f(iden)n(tical)h(to)g(those)g(for)f
(the)h(astSet)g(function)h(\(and)f(for)g(the)g(C)g Ft(")p
-Fi(prin)n(tf)p Ft(")427 3555 y Fi(function\).)0 3723
-y Fd(Returned)32 b(V)-8 b(alue:)259 3864 y(astPcdMap\(\))427
-3964 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(PcdMap.)0
-4131 y Fd(Notes:)340 4419 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+Fi(prin)n(tf)p Ft(")427 4706 y Fi(function\).)0 4875
+y Fd(Returned)32 b(V)-8 b(alue:)259 5019 y(astPcdMap\(\))427
+5118 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(PcdMap.)0
+5287 y Fd(Notes:)340 5577 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 4519 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)-2 4686 y Fd(Status)33
-b(Handling)n(:)227 4832 y Fi(The)d(protected)g(in)n(terface)f(to)g
-(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
-(of)g(the)g(parameter)227 4932 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
-(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
-(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
-Fi(in)n(t)227 5031 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p
-0 5236 3780 12 v 0 5366 a Fz(astP)l(ermAxes)1005 5367
-y Fe(P)m(erm)m(ute)37 b(the)h(axis)g(order)g(in)h(a)f(F)-10
-b(rame)3005 5366 y Fz(astP)l(ermAxes)0 5538 y Fd(Description:)44
-b Fi(This)28 b(function)g(p)r(erm)n(utes)g(the)g(order)e(in)i(whic)n(h)
-f(a)g(F)-7 b(rame's)27 b(axes)g(o)r(ccur.)0 5693 y Fd(Synopsis:)121
+427 5677 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p eop end
+%%Page: 309 319
+TeXDict begin 309 318 bop 3643 52 a FF(309)-2 351 y Fd(Status)33
+b(Handling)n(:)227 497 y Fi(The)d(protected)g(in)n(terface)f(to)g(this)
+h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g
+(the)g(parameter)227 597 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62
+b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)
+e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fi(in)n(t)227
+697 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p 0 892 3780
+12 v 0 1023 a Fz(astP)l(ermAxes)1005 1024 y Fe(P)m(erm)m(ute)37
+b(the)h(axis)g(order)g(in)h(a)f(F)-10 b(rame)3005 1023
+y Fz(astP)l(ermAxes)0 1186 y Fd(Description:)44 b Fi(This)28
+b(function)g(p)r(erm)n(utes)g(the)g(order)e(in)i(whic)n(h)f(a)g(F)-7
+b(rame's)27 b(axes)g(o)r(ccur.)0 1333 y Fd(Synopsis:)121
b Ft(void)42 b(astPermAxes\()c(AstFrame)j Fh(\003)p Ft(this,)g(const)g
-(int)i(perm[])e(\))p eop end
-%%Page: 308 318
-TeXDict begin 308 317 bop 0 52 a FF(308)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(P)m(arameters:)259
-499 y(this)427 598 y Fi(P)n(oin)n(ter)c(to)i(the)g(F)-7
-b(rame.)259 737 y Fd(p)s(erm)427 836 y Fi(An)35 b(arra)n(y)e(with)i
+(int)i(perm[])e(\))0 1481 y Fd(P)m(arameters:)259 1616
+y(this)427 1715 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rame.)259 1846 y Fd(p)s(erm)427 1946 y Fi(An)35 b(arra)n(y)e(with)i
(one)f(elemen)n(t)h(for)f(eac)n(h)f(axis)h(of)h(the)g(F)-7
b(rame)34 b(\(Naxes)g(attribute\).)58 b(This)35 b(should)f(list)427
-936 y(the)28 b(axes)e(in)h(their)g(new)h(order,)e(using)g(the)i
+2045 y(the)28 b(axes)e(in)h(their)g(new)h(order,)e(using)g(the)i
(original)d(axis)i(n)n(um)n(b)r(ering)f(\(whic)n(h)i(starts)e(at)h(1)g
-(for)f(the)i(\014rst)427 1035 y(axis\).)0 1208 y Fd(Notes:)340
-1502 y Fh(\017)45 b Fi(Only)29 b(gen)n(uine)g(p)r(erm)n(utations)f(of)i
+(for)f(the)i(\014rst)427 2145 y(axis\).)0 2305 y Fd(Notes:)340
+2586 y Fh(\017)45 b Fi(Only)29 b(gen)n(uine)g(p)r(erm)n(utations)f(of)i
(the)f(axis)g(order)e(are)i(p)r(ermitted,)h(so)f(eac)n(h)f(axis)g(m)n
-(ust)i(b)r(e)f(referenced)427 1601 y(exactly)e(once)g(in)h(the)g
-Ft(")p Fi(p)r(erm)p Ft(")f Fi(arra)n(y)-7 b(.)340 1740
+(ust)i(b)r(e)f(referenced)427 2685 y(exactly)e(once)g(in)h(the)g
+Ft(")p Fi(p)r(erm)p Ft(")f Fi(arra)n(y)-7 b(.)340 2816
y Fh(\017)45 b Fi(If)28 b(successiv)n(e)f(axis)f(p)r(erm)n(utations)h
(are)g(applied)h(to)f(a)g(F)-7 b(rame,)27 b(then)h(the)g(e\013ects)g
-(are)f(cum)n(ulativ)n(e.)p 0 1950 3780 12 v 0 2081 a
-Fz(astP)l(ermMap)1401 2080 y Fe(Create)37 b(a)i(P)m(ermMap)3025
-2081 y Fz(astP)l(ermMap)0 2281 y Fd(Description:)44 b
-Fi(This)28 b(function)g(creates)f(a)g(new)g(P)n(ermMap)g(and)g
-(optionally)g(initialises)g(its)h(attributes.)227 2411
-y(A)g(P)n(ermMap)d(is)i(a)g(Mapping)f(whic)n(h)h(p)r(erm)n(utes)g(the)g
-(order)f(of)h(co)r(ordinates,)e(and)i(p)r(ossibly)g(also)f(c)n(hanges)f
-(the)227 2510 y(n)n(um)n(b)r(er)j(of)f(co)r(ordinates,)f(b)r(et)n(w)n
-(een)i(its)g(input)g(and)g(output.)227 2640 y(In)37 b(addition)f(to)g
-(p)r(erm)n(uting)h(the)f(co)r(ordinate)g(order,)h(a)f(P)n(ermMap)f(ma)n
-(y)h(also)f(assign)g(constan)n(t)h(v)-5 b(alues)36 b(to)227
-2740 y(co)r(ordinates.)53 b(This)33 b(is)g(useful)h(when)g(the)f(n)n
-(um)n(b)r(er)g(of)h(co)r(ordinates)d(is)j(b)r(eing)f(increased)f(as)h
-(it)h(allo)n(ws)e(\014xed)227 2839 y(v)-5 b(alues)27
-b(to)h(b)r(e)g(assigned)e(to)i(an)n(y)f(new)g(ones.)0
-3000 y Fd(Synopsis:)121 b Ft(AstPermMap)39 b Fh(\003)p
-Ft(astPermMap\()g(int)j(nin,)g(const)g(int)g(inperm[],)e(int)i(nout,)g
-(const)f(int)i(outperm[],)227 3100 y(double)e(constant[],)e(const)j
-(char)g Fh(\003)p Ft(options,)e(...)86 b(\))0 3260 y
-Fd(P)m(arameters:)259 3407 y(nin)427 3507 y Fi(The)28
+(are)f(cum)n(ulativ)n(e.)p 0 3012 V 0 3143 a Fz(astP)l(ermMap)1401
+3142 y Fe(Create)37 b(a)i(P)m(ermMap)3025 3143 y Fz(astP)l(ermMap)0
+3328 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g
+(P)n(ermMap)g(and)g(optionally)g(initialises)g(its)h(attributes.)227
+3451 y(A)g(P)n(ermMap)d(is)i(a)g(Mapping)f(whic)n(h)h(p)r(erm)n(utes)g
+(the)g(order)f(of)h(co)r(ordinates,)e(and)i(p)r(ossibly)g(also)f(c)n
+(hanges)f(the)227 3551 y(n)n(um)n(b)r(er)j(of)f(co)r(ordinates,)f(b)r
+(et)n(w)n(een)i(its)g(input)g(and)g(output.)227 3675
+y(In)37 b(addition)f(to)g(p)r(erm)n(uting)h(the)f(co)r(ordinate)g
+(order,)h(a)f(P)n(ermMap)f(ma)n(y)h(also)f(assign)g(constan)n(t)h(v)-5
+b(alues)36 b(to)227 3774 y(co)r(ordinates.)53 b(This)33
+b(is)g(useful)h(when)g(the)f(n)n(um)n(b)r(er)g(of)h(co)r(ordinates)d
+(is)j(b)r(eing)f(increased)f(as)h(it)h(allo)n(ws)e(\014xed)227
+3874 y(v)-5 b(alues)27 b(to)h(b)r(e)g(assigned)e(to)i(an)n(y)f(new)g
+(ones.)0 4022 y Fd(Synopsis:)121 b Ft(AstPermMap)39 b
+Fh(\003)p Ft(astPermMap\()g(int)j(nin,)g(const)g(int)g(inperm[],)e(int)
+i(nout,)g(const)f(int)i(outperm[],)227 4121 y(double)e(constant[],)e
+(const)j(char)g Fh(\003)p Ft(options,)e(...)86 b(\))0
+4269 y Fd(P)m(arameters:)259 4403 y(nin)427 4503 y Fi(The)28
b(n)n(um)n(b)r(er)f(of)h(input)g(co)r(ordinates.)259
-3645 y Fd(inp)s(erm)427 3745 y Fi(An)i(optional)e(arra)n(y)f(with)i
+4634 y Fd(inp)s(erm)427 4734 y Fi(An)i(optional)e(arra)n(y)f(with)i
Ft(")p Fi(nin)p Ft(")g Fi(elemen)n(ts)f(whic)n(h,)i(for)e(eac)n(h)g
(input)i(co)r(ordinate,)e(should)h(con)n(tain)f(the)427
-3845 y(n)n(um)n(b)r(er)33 b(of)h(the)g(output)g(co)r(ordinate)e(whose)h
+4833 y(n)n(um)n(b)r(er)33 b(of)h(the)g(output)g(co)r(ordinate)e(whose)h
(v)-5 b(alue)33 b(is)h(to)f(b)r(e)h(used)f(\(note)h(that)g(this)f(arra)
-n(y)f(therefore)427 3944 y(de\014nes)c(the)g(in)n(v)n(erse)e(co)r
+n(y)f(therefore)427 4933 y(de\014nes)c(the)g(in)n(v)n(erse)e(co)r
(ordinate)g(transformation\).)36 b(Co)r(ordinates)26
b(are)h(n)n(um)n(b)r(ered)g(starting)g(from)g(1.)427
-4063 y(F)-7 b(or)28 b(details)g(of)g(additional)g(sp)r(ecial)g(v)-5
+5048 y(F)-7 b(or)28 b(details)g(of)g(additional)g(sp)r(ecial)g(v)-5
b(alues)28 b(that)h(ma)n(y)f(b)r(e)g(used)h(in)f(this)h(arra)n(y)-7
-b(,)26 b(see)i(the)h(description)f(of)427 4163 y(the)g
-Ft(")p Fi(constan)n(t)p Ft(")e Fi(parameter.)427 4282
+b(,)26 b(see)i(the)h(description)f(of)427 5148 y(the)g
+Ft(")p Fi(constan)n(t)p Ft(")e Fi(parameter.)427 5263
y(If)h(a)f(NULL)h(p)r(oin)n(ter)f(is)h(supplied)f(instead)h(of)f(an)g
(arra)n(y)-7 b(,)25 b(eac)n(h)h(input)h(co)r(ordinate)e(will)i(obtain)f
-(its)h(v)-5 b(alue)427 4381 y(from)26 b(the)h(corresp)r(onding)d
+(its)h(v)-5 b(alue)427 5363 y(from)26 b(the)h(corresp)r(onding)d
(output)i(co)r(ordinate)f(\(or)h(will)g(b)r(e)h(assigned)e(the)h(v)-5
-b(alue)26 b(AST)p Ft(__)p Fi(BAD)g(if)h(there)427 4481
+b(alue)26 b(AST)p Ft(__)p Fi(BAD)g(if)h(there)427 5462
y(is)h(no)f(corresp)r(onding)f(output)i(co)r(ordinate\).)259
-4619 y Fd(nout)427 4719 y Fi(The)g(n)n(um)n(b)r(er)f(of)h(output)g(co)r
-(ordinates.)259 4857 y Fd(outp)s(erm)427 4957 y Fi(An)33
-b(optional)f(arra)n(y)e(with)j Ft(")p Fi(nout)p Ft(")e
-Fi(elemen)n(ts)i(whic)n(h,)g(for)f(eac)n(h)g(output)h(co)r(ordinate,)f
-(should)g(con)n(tain)427 5057 y(the)c(n)n(um)n(b)r(er)f(of)g(the)h
-(input)g(co)r(ordinate)e(whose)h(v)-5 b(alue)27 b(is)g(to)h(b)r(e)f
-(used)h(\(note)f(that)h(this)g(arra)n(y)d(therefore)427
-5156 y(de\014nes)j(the)g(forw)n(ard)e(co)r(ordinate)g
+5593 y Fd(nout)427 5693 y Fi(The)g(n)n(um)n(b)r(er)f(of)h(output)g(co)r
+(ordinates.)p eop end
+%%Page: 310 320
+TeXDict begin 310 319 bop 0 52 a FF(310)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(outp)s(erm)427
+451 y Fi(An)j(optional)f(arra)n(y)e(with)j Ft(")p Fi(nout)p
+Ft(")e Fi(elemen)n(ts)i(whic)n(h,)g(for)f(eac)n(h)g(output)h(co)r
+(ordinate,)f(should)g(con)n(tain)427 551 y(the)c(n)n(um)n(b)r(er)f(of)g
+(the)h(input)g(co)r(ordinate)e(whose)h(v)-5 b(alue)27
+b(is)g(to)h(b)r(e)f(used)h(\(note)f(that)h(this)g(arra)n(y)d(therefore)
+427 650 y(de\014nes)j(the)g(forw)n(ard)e(co)r(ordinate)g
(transformation\).)36 b(Co)r(ordinates)26 b(are)g(n)n(um)n(b)r(ered)i
-(starting)f(from)g(1.)427 5275 y(F)-7 b(or)28 b(details)g(of)g
+(starting)f(from)g(1.)427 765 y(F)-7 b(or)28 b(details)g(of)g
(additional)g(sp)r(ecial)g(v)-5 b(alues)28 b(that)h(ma)n(y)f(b)r(e)g
(used)h(in)f(this)h(arra)n(y)-7 b(,)26 b(see)i(the)h(description)f(of)
-427 5375 y(the)g Ft(")p Fi(constan)n(t)p Ft(")e Fi(parameter.)427
-5494 y(If)e(a)f(NULL)h(p)r(oin)n(ter)e(is)i(supplied)f(instead)g(of)g
+427 864 y(the)g Ft(")p Fi(constan)n(t)p Ft(")e Fi(parameter.)427
+979 y(If)e(a)f(NULL)h(p)r(oin)n(ter)e(is)i(supplied)f(instead)g(of)g
(an)g(arra)n(y)-7 b(,)22 b(eac)n(h)h(output)h(co)r(ordinate)e(will)h
-(obtain)g(its)h(v)-5 b(alue)427 5593 y(from)30 b(the)g(corresp)r
+(obtain)g(its)h(v)-5 b(alue)427 1078 y(from)30 b(the)g(corresp)r
(onding)e(input)j(co)r(ordinate)e(\(or)g(will)i(b)r(e)f(assigned)f(the)
h(v)-5 b(alue)30 b(AST)p Ft(__)p Fi(BAD)g(if)h(there)427
-5693 y(is)d(no)f(corresp)r(onding)f(input)i(co)r(ordinate\).)p
-eop end
-%%Page: 309 319
-TeXDict begin 309 318 bop 3643 52 a FF(309)259 351 y
-Fd(constan)m(t)427 451 y Fi(An)19 b(optional)f(arra)n(y)e(con)n
+1178 y(is)d(no)f(corresp)r(onding)f(input)i(co)r(ordinate\).)259
+1307 y Fd(constan)m(t)427 1407 y Fi(An)19 b(optional)f(arra)n(y)e(con)n
(taining)h(v)-5 b(alues)18 b(whic)n(h)h(ma)n(y)f(b)r(e)g(assigned)g(to)
-g(input)h(and/or)e(output)i(co)r(ordinates)427 551 y(instead)i(of)g
+g(input)h(and/or)e(output)i(co)r(ordinates)427 1506 y(instead)i(of)g
(deriving)g(them)g(from)g(other)g(co)r(ordinate)f(v)-5
b(alues.)34 b(If)22 b(either)f(of)g(the)h Ft(")p Fi(inp)r(erm)p
-Ft(")e Fi(or)g Ft(")p Fi(outp)r(erm)p Ft(")427 650 y
+Ft(")e Fi(or)g Ft(")p Fi(outp)r(erm)p Ft(")427 1606 y
Fi(arra)n(ys)33 b(con)n(tains)h(a)h(negativ)n(e)g(v)-5
b(alue,)37 b(it)f(is)f(used)g(to)h(address)e(this)h Ft(")p
Fi(constan)n(t)p Ft(")f Fi(arra)n(y)f(\(suc)n(h)j(that)f(-1)427
-750 y(addresses)28 b(the)h(\014rst)g(elemen)n(t,)h(-2)e(addresses)f
+1706 y(addresses)28 b(the)h(\014rst)g(elemen)n(t,)h(-2)e(addresses)f
(the)j(second)e(elemen)n(t,)i(etc.\))42 b(and)29 b(the)g(v)-5
-b(alue)29 b(obtained)g(is)427 849 y(used)f(as)f(the)h(corresp)r(onding)
-d(co)r(ordinate)i(v)-5 b(alue.)427 968 y(Care)29 b(should)h(b)r(e)h
-(tak)n(en)f(to)g(ensure)f(that)i(lo)r(cations)e(lying)h(outside)g(the)h
-(exten)n(t)f(of)g(this)h(arra)n(y)c(are)j(not)427 1068
-y(acciden)n(tally)e(addressed.)39 b(The)28 b(arra)n(y)f(is)h(not)h
-(used)g(if)g(the)g Ft(")p Fi(inp)r(erm)p Ft(")f Fi(and)g
-Ft(")p Fi(outp)r(erm)p Ft(")g Fi(arra)n(ys)e(do)j(not)427
-1167 y(con)n(tain)e(negativ)n(e)g(v)-5 b(alues.)427 1286
+b(alue)29 b(obtained)g(is)427 1805 y(used)f(as)f(the)h(corresp)r
+(onding)d(co)r(ordinate)i(v)-5 b(alue.)427 1920 y(Care)29
+b(should)h(b)r(e)h(tak)n(en)f(to)g(ensure)f(that)i(lo)r(cations)e
+(lying)h(outside)g(the)h(exten)n(t)f(of)g(this)h(arra)n(y)c(are)j(not)
+427 2019 y(acciden)n(tally)e(addressed.)39 b(The)28 b(arra)n(y)f(is)h
+(not)h(used)g(if)g(the)g Ft(")p Fi(inp)r(erm)p Ft(")f
+Fi(and)g Ft(")p Fi(outp)r(erm)p Ft(")g Fi(arra)n(ys)e(do)j(not)427
+2119 y(con)n(tain)e(negativ)n(e)g(v)-5 b(alues.)427 2233
y(If)34 b(a)f(NULL)h(p)r(oin)n(ter)f(is)h(supplied)g(instead)f(of)g(an)
h(arra)n(y)-7 b(,)33 b(the)g(b)r(eha)n(viour)g(is)g(as)g(if)h(the)g
-(arra)n(y)d(w)n(ere)i(of)427 1386 y(in\014nite)c(length)e(and)h
+(arra)n(y)d(w)n(ere)i(of)427 2333 y(in\014nite)c(length)e(and)h
(\014lled)g(with)g(the)g(v)-5 b(alue)27 b(AST)p Ft(__)p
-Fi(BAD.)259 1524 y Fd(options)427 1623 y Fi(P)n(oin)n(ter)g(to)h(a)g(n)
+Fi(BAD.)259 2462 y Fd(options)427 2562 y Fi(P)n(oin)n(ter)g(to)h(a)g(n)
n(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 1723 y(assignmen)n(ts)21
+(comma-separated)e(list)i(of)g(attribute)427 2662 y(assignmen)n(ts)21
b(to)i(b)r(e)g(used)f(for)g(initialising)g(the)h(new)g(P)n(ermMap.)34
b(The)22 b(syn)n(tax)g(used)g(is)h(iden)n(tical)f(to)g(that)427
-1823 y(for)k(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
+2761 y(for)k(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n
(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-1922 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 2060
-y Fd(...)427 2160 y Fi(If)38 b(the)g Ft(")p Fi(options)p
+2861 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 2990
+y Fd(...)427 3090 y Fi(If)38 b(the)g Ft(")p Fi(options)p
Ft(")e Fi(string)h(con)n(tains)f Ft(")p Fi(\045)p Ft(")h
Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g(list)h(of)f
-(additional)427 2260 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
+(additional)427 3189 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
(order)e(to)h(supply)h(v)-5 b(alues)27 b(to)g(b)r(e)h(substituted)h
-(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 2359 y(rules)25
+(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 3289 y(rules)25
b(for)f(supplying)h(these)g(are)f(iden)n(tical)h(to)g(those)g(for)f
(the)h(astSet)g(function)h(\(and)f(for)g(the)g(C)g Ft(")p
-Fi(prin)n(tf)p Ft(")427 2459 y Fi(function\).)0 2631
-y Fd(Returned)32 b(V)-8 b(alue:)259 2778 y(astP)m(ermMap\(\))427
-2877 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(P)n(ermMap.)0
-3049 y Fd(Notes:)340 3342 y Fh(\017)45 b Fi(If)24 b(either)f(of)h(the)f
+Fi(prin)n(tf)p Ft(")427 3389 y Fi(function\).)0 3547
+y Fd(Returned)32 b(V)-8 b(alue:)259 3680 y(astP)m(ermMap\(\))427
+3779 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(P)n(ermMap.)0
+3938 y Fd(Notes:)340 4217 y Fh(\017)45 b Fi(If)24 b(either)f(of)h(the)f
Ft(")p Fi(inp)r(erm)p Ft(")g Fi(or)g Ft(")p Fi(outp)r(erm)p
Ft(")f Fi(arra)n(ys)f(con)n(tains)h(a)h(zero)g(v)-5 b(alue)23
b(\(or)g(a)f(p)r(ositiv)n(e)h(v)-5 b(alue)24 b(whic)n(h)427
-3442 y(do)r(es)c(not)g(iden)n(tify)h(a)f(v)-5 b(alid)20
+4316 y(do)r(es)c(not)g(iden)n(tify)h(a)f(v)-5 b(alid)20
b(output/input)h(co)r(ordinate,)g(as)f(appropriate\),)g(then)h(the)f(v)
--5 b(alue)21 b(AST)p Ft(__)p Fi(BAD)427 3542 y(is)28
+-5 b(alue)21 b(AST)p Ft(__)p Fi(BAD)427 4416 y(is)28
b(assigned)e(as)h(the)h(new)g(co)r(ordinate)e(v)-5 b(alue.)340
-3680 y Fh(\017)45 b Fi(This)29 b(function)g(do)r(es)g(not)g(attempt)g
+4545 y Fh(\017)45 b Fi(This)29 b(function)g(do)r(es)g(not)g(attempt)g
(to)g(ensure)f(that)h(the)g(forw)n(ard)e(and)i(in)n(v)n(erse)e
-(transformations)g(p)r(er-)427 3779 y(formed)37 b(b)n(y)g(the)h(P)n
+(transformations)g(p)r(er-)427 4645 y(formed)37 b(b)n(y)g(the)h(P)n
(ermMap)e(are)g(self-consisten)n(t)h(in)h(an)n(y)e(w)n(a)n(y)-7
b(.)65 b(Y)-7 b(ou)37 b(are)g(therefore)f(free)h(to)h(supply)427
-3879 y(co)r(ordinate)27 b(p)r(erm)n(utation)g(arra)n(ys)e(that)j(ac)n
+4744 y(co)r(ordinate)27 b(p)r(erm)n(utation)g(arra)n(ys)e(that)j(ac)n
(hiev)n(e)e(whatev)n(er)h(e\013ect)h(is)f(desired.)340
-4017 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
+4874 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g
(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427
-4116 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
-(for)f(an)n(y)g(reason.)p 0 4326 3780 12 v 0 4458 a Fz(astPic)l(kAxes)
+4973 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
+(for)f(an)n(y)g(reason.)p 0 5165 3780 12 v 0 5297 a Fz(astPic)l(kAxes)
247 b Fe(Create)37 b(a)i(new)g(F)-10 b(rame)38 b(b)m(y)h(pic)m(king)e
-(axes)1366 4572 y(from)g(an)i(existing)e(one)3066 4458
-y Fz(astPic)l(kAxes)0 4771 y Fd(Description:)44 b Fi(This)31
+(axes)1366 5412 y(from)g(an)i(existing)e(one)3066 5297
+y Fz(astPic)l(kAxes)0 5593 y Fd(Description:)44 b Fi(This)31
b(function)h(creates)e(a)g(new)i(F)-7 b(rame)30 b(whose)g(axes)g(are)h
(copied)f(from)h(an)g(existing)f(F)-7 b(rame)31 b(along)227
-4871 y(with)d(other)f(F)-7 b(rame)26 b(attributes,)i(suc)n(h)e(as)h
+5693 y(with)d(other)f(F)-7 b(rame)26 b(attributes,)i(suc)n(h)e(as)h
(its)g(Title.)37 b(An)n(y)28 b(n)n(um)n(b)r(er)f(\(zero)f(or)g(more\))h
-(of)g(the)h(original)d(F)-7 b(rame's)227 4971 y(axes)24
-b(ma)n(y)f(b)r(e)i(copied,)g(in)g(an)n(y)e(order,)h(and)g(additional)g
-(axes)f(with)i(default)g(attributes)f(ma)n(y)g(also)f(b)r(e)i(included)
-227 5070 y(in)j(the)g(new)g(F)-7 b(rame.)227 5200 y(Optionally)g(,)26
-b(a)f(Mapping)h(that)g(con)n(v)n(erts)e(b)r(et)n(w)n(een)i(the)g(co)r
-(ordinate)f(systems)g(describ)r(ed)h(b)n(y)f(the)h(t)n(w)n(o)f(F)-7
-b(rames)227 5299 y(will)28 b(also)f(b)r(e)h(returned.)0
-5459 y Fd(Synopsis:)121 b Ft(AstFrame)40 b Fh(\003)p
-Ft(astPickAxes\()e(AstFrame)j Fh(\003)p Ft(this,)g(int)h(naxes,)f
-(const)h(int)g(axes[],)f(AstMapping)227 5559 y Fh(\003\003)p
-Ft(map)h(\))0 5718 y Fd(P)m(arameters:)p eop end
-%%Page: 310 320
-TeXDict begin 310 319 bop 0 52 a FF(310)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(this)427
-451 y Fi(P)n(oin)n(ter)c(to)i(the)g(original)e(F)-7 b(rame.)259
-611 y Fd(naxes)427 711 y Fi(The)28 b(n)n(um)n(b)r(er)f(of)h(axes)e
-(required)h(in)h(the)g(new)g(F)-7 b(rame.)259 871 y Fd(axes)427
-970 y Fi(An)27 b(arra)n(y)-7 b(,)23 b(with)k Ft(")p Fi(naxes)p
-Ft(")d Fi(elemen)n(ts,)i(whic)n(h)g(lists)f(the)i(axes)d(to)i(b)r(e)g
-(copied.)36 b(These)26 b(should)f(b)r(e)h(giv)n(en)f(in)427
-1070 y(the)j(order)e(required)h(in)h(the)g(new)f(F)-7
-b(rame,)27 b(using)g(the)h(axis)f(n)n(um)n(b)r(ering)g(in)h(the)f
-(original)f(F)-7 b(rame)27 b(\(whic)n(h)427 1170 y(starts)g(at)g(1)h
+(of)g(the)h(original)d(F)-7 b(rame's)p eop end
+%%Page: 311 321
+TeXDict begin 311 320 bop 3643 52 a FF(311)227 351 y
+Fi(axes)24 b(ma)n(y)f(b)r(e)i(copied,)g(in)g(an)n(y)e(order,)h(and)g
+(additional)g(axes)f(with)i(default)g(attributes)f(ma)n(y)g(also)f(b)r
+(e)i(included)227 451 y(in)j(the)g(new)g(F)-7 b(rame.)227
+574 y(Optionally)g(,)26 b(a)f(Mapping)h(that)g(con)n(v)n(erts)e(b)r(et)
+n(w)n(een)i(the)g(co)r(ordinate)f(systems)g(describ)r(ed)h(b)n(y)f(the)
+h(t)n(w)n(o)f(F)-7 b(rames)227 674 y(will)28 b(also)f(b)r(e)h
+(returned.)0 822 y Fd(Synopsis:)121 b Ft(AstFrame)40
+b Fh(\003)p Ft(astPickAxes\()e(AstFrame)j Fh(\003)p Ft(this,)g(int)h
+(naxes,)f(const)h(int)g(axes[],)f(AstMapping)227 921
+y Fh(\003\003)p Ft(map)h(\))0 1069 y Fd(P)m(arameters:)259
+1203 y(this)427 1303 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(original)e(F)-7
+b(rame.)259 1434 y Fd(naxes)427 1534 y Fi(The)28 b(n)n(um)n(b)r(er)f
+(of)h(axes)e(required)h(in)h(the)g(new)g(F)-7 b(rame.)259
+1665 y Fd(axes)427 1764 y Fi(An)27 b(arra)n(y)-7 b(,)23
+b(with)k Ft(")p Fi(naxes)p Ft(")d Fi(elemen)n(ts,)i(whic)n(h)g(lists)f
+(the)i(axes)d(to)i(b)r(e)g(copied.)36 b(These)26 b(should)f(b)r(e)h
+(giv)n(en)f(in)427 1864 y(the)j(order)e(required)h(in)h(the)g(new)f(F)
+-7 b(rame,)27 b(using)g(the)h(axis)f(n)n(um)n(b)r(ering)g(in)h(the)f
+(original)f(F)-7 b(rame)27 b(\(whic)n(h)427 1963 y(starts)g(at)g(1)h
(for)f(the)h(\014rst)f(axis\).)36 b(Axes)28 b(ma)n(y)e(b)r(e)i
(selected)g(in)g(an)n(y)e(order,)h(but)h(eac)n(h)f(ma)n(y)g(only)g(b)r
-(e)h(used)427 1269 y(once.)38 b(If)29 b(additional)f(\(default\))h
+(e)h(used)427 2063 y(once.)38 b(If)29 b(additional)f(\(default\))h
(axes)e(are)g(also)h(to)g(b)r(e)g(included,)h(the)g(corresp)r(onding)d
-(elemen)n(ts)i(of)g(this)427 1369 y(arra)n(y)e(should)h(b)r(e)h(set)f
-(to)h(zero.)259 1529 y Fd(map)427 1629 y Fi(Address)22
+(elemen)n(ts)i(of)g(this)427 2163 y(arra)n(y)e(should)h(b)r(e)h(set)f
+(to)h(zero.)259 2294 y Fd(map)427 2393 y Fi(Address)22
b(of)g(a)f(lo)r(cation)h(in)g(whic)n(h)g(to)g(return)f(a)h(p)r(oin)n
(ter)g(to)f(a)h(new)g(Mapping.)35 b(This)22 b(will)g(b)r(e)g(a)g(P)n
-(ermMap)427 1728 y(\(or)33 b(a)g(UnitMap)h(as)e(a)h(sp)r(ecial)g
+(ermMap)427 2493 y(\(or)33 b(a)g(UnitMap)h(as)e(a)h(sp)r(ecial)g
(case\))g(that)g(describ)r(es)g(the)h(axis)e(p)r(erm)n(utation)h(that)h
-(has)e(tak)n(en)h(place)427 1828 y(b)r(et)n(w)n(een)g(the)g(original)f
+(has)e(tak)n(en)h(place)427 2592 y(b)r(et)n(w)n(een)g(the)g(original)f
(and)g(new)h(F)-7 b(rames.)52 b(The)33 b(Mapping's)g(forw)n(ard)e
-(transformation)g(will)i(con)n(v)n(ert)427 1928 y(co)r(ordinates)26
+(transformation)g(will)i(con)n(v)n(ert)427 2692 y(co)r(ordinates)26
b(from)i(the)g(original)e(F)-7 b(rame)27 b(in)n(to)g(the)h(new)g(one,)f
-(and)g(vice)h(v)n(ersa.)427 2057 y(If)g(this)g(Mapping)f(is)h(not)f
+(and)g(vice)h(v)n(ersa.)427 2807 y(If)g(this)g(Mapping)f(is)h(not)f
(required,)g(a)g(NULL)h(v)-5 b(alue)28 b(ma)n(y)f(b)r(e)h(supplied)g
-(for)f(this)h(parameter.)0 2274 y Fd(Class)j(Applicabilit)m(y:)259
-2465 y(F)-8 b(rame)427 2564 y Fi(This)27 b(function)h(applies)e(to)h
+(for)f(this)h(parameter.)0 2967 y Fd(Class)j(Applicabilit)m(y:)259
+3102 y(F)-8 b(rame)427 3202 y Fi(This)27 b(function)h(applies)e(to)h
(all)g(F)-7 b(rames.)36 b(The)27 b(class)f(of)h(F)-7
b(rame)26 b(returned)h(ma)n(y)f(di\013er)h(from)g(that)g(of)g(the)427
-2664 y(original)g(F)-7 b(rame,)27 b(dep)r(ending)h(on)g(whic)n(h)g
+3301 y(original)g(F)-7 b(rame,)27 b(dep)r(ending)h(on)g(whic)n(h)g
(axes)f(are)g(selected.)37 b(F)-7 b(or)28 b(example,)f(if)h(a)g(single)
-f(axis)g(is)h(pic)n(k)n(ed)427 2764 y(from)i(a)g(SkyF)-7
+f(axis)g(is)h(pic)n(k)n(ed)427 3401 y(from)i(a)g(SkyF)-7
b(rame)29 b(\(whic)n(h)h(m)n(ust)h(alw)n(a)n(ys)d(ha)n(v)n(e)h(t)n(w)n
(o)g(axes\))h(then)g(the)h(resulting)e(F)-7 b(rame)30
-b(cannot)f(b)r(e)i(a)427 2863 y(v)-5 b(alid)28 b(SkyF)-7
+b(cannot)f(b)r(e)i(a)427 3500 y(v)-5 b(alid)28 b(SkyF)-7
b(rame,)27 b(so)g(will)h(rev)n(ert)e(to)h(the)h(paren)n(t)f(class)g
-(\(F)-7 b(rame\))27 b(instead.)259 3023 y Fd(F)-8 b(rameSet)427
-3123 y Fi(Using)19 b(this)g(function)g(on)g(a)f(F)-7
+(\(F)-7 b(rame\))27 b(instead.)259 3631 y Fd(F)-8 b(rameSet)427
+3731 y Fi(Using)19 b(this)g(function)g(on)g(a)f(F)-7
b(rameSet)19 b(is)f(iden)n(tical)h(to)f(using)h(it)g(on)f(the)i(curren)
n(t)d(F)-7 b(rame)19 b(in)g(the)g(F)-7 b(rameSet.)427
-3223 y(The)28 b(returned)f(F)-7 b(rame)27 b(will)h(not)g(b)r(e)g(a)f(F)
--7 b(rameSet.)259 3383 y Fd(Region)427 3482 y Fi(If)27
+3831 y(The)28 b(returned)f(F)-7 b(rame)27 b(will)h(not)g(b)r(e)g(a)f(F)
+-7 b(rameSet.)259 3962 y Fd(Region)427 4061 y Fi(If)27
b(this)f(function)h(is)f(used)g(on)g(a)f(Region,)h(an)g(attempt)g(is)g
(made)g(to)g(retain)g(the)g(b)r(ounds)g(information)g(on)427
-3582 y(the)g(selected)e(axes.)36 b(If)25 b(succesful,)g(the)h(returned)
+4161 y(the)g(selected)e(axes.)36 b(If)25 b(succesful,)g(the)h(returned)
e(F)-7 b(rame)25 b(will)g(b)r(e)g(a)g(Region)f(of)h(some)f(class.)35
-b(Otherwise,)427 3682 y(the)j(returned)g(F)-7 b(rame)37
+b(Otherwise,)427 4260 y(the)j(returned)g(F)-7 b(rame)37
b(is)g(obtained)h(b)n(y)f(calling)g(this)h(function)h(on)e(the)h(F)-7
-b(rame)37 b(represen)n(ted)g(b)n(y)g(the)427 3781 y(supplied)c(Region)f
+b(rame)37 b(represen)n(ted)g(b)n(y)g(the)427 4360 y(supplied)c(Region)f
(\(the)h(returned)g(F)-7 b(rame)32 b(will)h(then)g(not)f(b)r(e)h(a)g
(Region\).)51 b(In)33 b(order)e(to)i(b)r(e)g(succesful,)427
-3881 y(the)d(selected)f(axes)g(in)g(the)h(Region)f(m)n(ust)g(b)r(e)h
+4460 y(the)d(selected)f(axes)g(in)g(the)h(Region)f(m)n(ust)g(b)r(e)h
(indep)r(enden)n(t)g(of)f(the)h(others.)41 b(F)-7 b(or)29
-b(instance,)h(a)f(Bo)n(x)f(can)427 3981 y(b)r(e)i(split)g(in)g(this)g
+b(instance,)h(a)f(Bo)n(x)f(can)427 4559 y(b)r(e)i(split)g(in)g(this)g
(w)n(a)n(y)e(but)i(a)f(Circle)g(cannot.)42 b(Another)30
b(requiremen)n(t)e(for)h(success)g(is)g(that)h(no)f(default)427
-4080 y(axes)e(are)g(added)g(\(that)h(is,)g(the)g Ft(")p
+4659 y(axes)e(are)g(added)g(\(that)h(is,)g(the)g Ft(")p
Fi(axes)p Ft(")d Fi(arra)n(y)h(m)n(ust)h(not)h(con)n(tain)f(an)n(y)g
-(zero)f(v)-5 b(alues.)0 4297 y Fd(Returned)32 b(V)-8
-b(alue:)259 4488 y(astPic)m(kAxes\(\))427 4587 y Fi(A)28
-b(p)r(oin)n(ter)f(to)h(the)g(new)g(F)-7 b(rame.)0 4804
-y Fd(Notes:)340 5141 y Fh(\017)45 b Fi(The)32 b(new)f(F)-7
+(zero)f(v)-5 b(alues.)0 4819 y Fd(Returned)32 b(V)-8
+b(alue:)259 4954 y(astPic)m(kAxes\(\))427 5053 y Fi(A)28
+b(p)r(oin)n(ter)f(to)h(the)g(new)g(F)-7 b(rame.)0 5213
+y Fd(Notes:)340 5494 y Fh(\017)45 b Fi(The)32 b(new)f(F)-7
b(rame)31 b(will)g(con)n(tain)g(a)g Ft(")p Fi(deep)p
Ft(")f Fi(cop)n(y)h(\(c.f.)48 b(astCop)n(y\))30 b(of)i(all)f(the)g
-(data)g(selected)g(from)g(the)427 5240 y(original)26
+(data)g(selected)g(from)g(the)427 5593 y(original)26
b(F)-7 b(rame.)37 b(Mo)r(difying)27 b(an)n(y)g(asp)r(ect)g(of)h(the)g
(new)g(F)-7 b(rame)27 b(will)g(therefore)g(not)h(a\013ect)f(the)h
-(original)427 5340 y(one.)340 5500 y Fh(\017)45 b Fi(A)35
-b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
+(original)427 5693 y(one.)p eop end
+%%Page: 312 322
+TeXDict begin 312 321 bop 0 52 a FF(312)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
-(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 5600 y(AST)28
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 451 y(AST)28
b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)p eop end
-%%Page: 311 321
-TeXDict begin 311 320 bop 3643 52 a FF(311)p 0 351 3780
-12 v 0 483 a Fz(astPlot)1126 b Fe(Create)37 b(a)i(Plot)1123
-b Fz(astPlot)0 675 y Fd(Description:)44 b Fi(This)28
-b(function)g(creates)f(a)g(new)g(Plot)g(and)h(optionally)f(initialises)
-g(its)h(attributes.)227 812 y(A)20 b(Plot)e(is)h(a)g(sp)r(ecialised)g
-(form)g(of)g(F)-7 b(rameSet,)20 b(in)g(whic)n(h)f(the)h(base)e(F)-7
-b(rame)19 b(describ)r(es)f(a)h Ft(")p Fi(graphical)p
-Ft(")e Fi(co)r(ordinate)227 912 y(system)27 b(and)g(is)h(asso)r(ciated)
-d(with)j(a)f(rectangular)e(plotting)j(area)d(in)j(the)g(underlying)e
-(graphics)g(system.)37 b(This)227 1012 y(plotting)28
+(reason.)p 0 635 3780 12 v 0 767 a Fz(astPlot)1126 b
+Fe(Create)37 b(a)i(Plot)1123 b Fz(astPlot)0 917 y Fd(Description:)44
+b Fi(This)28 b(function)g(creates)f(a)g(new)g(Plot)g(and)h(optionally)f
+(initialises)g(its)h(attributes.)227 1038 y(A)20 b(Plot)e(is)h(a)g(sp)r
+(ecialised)g(form)g(of)g(F)-7 b(rameSet,)20 b(in)g(whic)n(h)f(the)h
+(base)e(F)-7 b(rame)19 b(describ)r(es)f(a)h Ft(")p Fi(graphical)p
+Ft(")e Fi(co)r(ordinate)227 1138 y(system)27 b(and)g(is)h(asso)r
+(ciated)d(with)j(a)f(rectangular)e(plotting)j(area)d(in)j(the)g
+(underlying)e(graphics)g(system.)37 b(This)227 1237 y(plotting)28
b(area)e(is)i(where)f(graphical)f(output)i(app)r(ears.)35
b(It)28 b(is)g(de\014ned)g(when)g(the)g(Plot)f(is)g(created.)227
-1149 y(The)36 b(curren)n(t)e(F)-7 b(rame)35 b(of)h(a)f(Plot)g(describ)r
+1358 y(The)36 b(curren)n(t)e(F)-7 b(rame)35 b(of)h(a)f(Plot)g(describ)r
(es)g(a)g Ft(")p Fi(ph)n(ysical)p Ft(")f Fi(co)r(ordinate)g(system,)j
-(whic)n(h)f(is)f(the)h(co)r(ordinate)227 1249 y(system)41
+(whic)n(h)f(is)f(the)h(co)r(ordinate)227 1458 y(system)41
b(in)h(whic)n(h)f(plotting)h(op)r(erations)e(are)g(sp)r(eci\014ed.)79
b(The)41 b(results)g(of)g(eac)n(h)g(plotting)g(op)r(eration)g(are)227
-1348 y(automatically)26 b(transformed)f(in)n(to)i(graphical)e(co)r
+1558 y(automatically)26 b(transformed)f(in)n(to)i(graphical)e(co)r
(ordinates)g(so)h(as)g(to)h(app)r(ear)e(in)i(the)g(plotting)g(area)e
-(\(sub)5 b(ject)227 1448 y(to)28 b(an)n(y)f(clipping)g(whic)n(h)h(ma)n
-(y)f(b)r(e)h(in)f(e\013ect\).)227 1586 y(Because)d(the)h(Mapping)f(b)r
+(\(sub)5 b(ject)227 1657 y(to)28 b(an)n(y)f(clipping)g(whic)n(h)h(ma)n
+(y)f(b)r(e)h(in)f(e\013ect\).)227 1778 y(Because)d(the)h(Mapping)f(b)r
(et)n(w)n(een)g(ph)n(ysical)g(and)g(graphical)f(co)r(ordinates)g(ma)n
-(y)h(often)h(b)r(e)g(non-linear,)e(or)h(ev)n(en)227 1685
+(y)h(often)h(b)r(e)g(non-linear,)e(or)h(ev)n(en)227 1878
y(discon)n(tin)n(uous,)i(most)h(plotting)f(do)r(es)h(not)g(result)f(in)
h(simple)g(straigh)n(t)f(lines.)36 b(The)27 b(basic)f(plotting)h
-(elemen)n(t)g(is)227 1785 y(therefore)32 b(not)g(a)h(straigh)n(t)e
+(elemen)n(t)g(is)227 1977 y(therefore)32 b(not)g(a)h(straigh)n(t)e
(line,)j(but)f(a)f(geo)r(desic)g(curv)n(e)f(\(see)i(astCurv)n(e\).)50
-b(A)33 b(Plot)f(also)f(pro)n(vides)h(facilities)227 1884
+b(A)33 b(Plot)f(also)f(pro)n(vides)h(facilities)227 2077
y(for)40 b(dra)n(wing)g(mark)n(ers)e(or)i(sym)n(b)r(ols)g(\(astMark\),)
j(text)e(\(astT)-7 b(ext\))41 b(and)f(grid)g(lines)h(\(astGridLine\).)
-76 b(It)41 b(is)227 1984 y(also)32 b(p)r(ossible)h(to)f(dra)n(w)g
+76 b(It)41 b(is)227 2176 y(also)32 b(p)r(ossible)h(to)f(dra)n(w)g
(curvilinear)g(axes)g(with)h(optional)f(co)r(ordinate)g(grids)g
-(\(astGrid\).)53 b(A)33 b(range)e(of)i(Plot)227 2084
+(\(astGrid\).)53 b(A)33 b(range)e(of)i(Plot)227 2276
y(attributes)f(is)g(a)n(v)-5 b(ailable)31 b(to)h(allo)n(w)f(precise)g
(con)n(trol)g(o)n(v)n(er)f(the)i(app)r(earance)f(of)h(graphical)e
-(output)j(pro)r(duced)227 2183 y(b)n(y)28 b(these)f(functions.)227
-2321 y(Y)-7 b(ou)20 b(ma)n(y)f(select)h(di\013eren)n(t)f(ph)n(ysical)g
+(output)j(pro)r(duced)227 2376 y(b)n(y)28 b(these)f(functions.)227
+2497 y(Y)-7 b(ou)20 b(ma)n(y)f(select)h(di\013eren)n(t)f(ph)n(ysical)g
(co)r(ordinate)g(systems)g(in)h(whic)n(h)f(to)h(plot)g(\(including)g
-(the)g(nativ)n(e)f(graphical)227 2421 y(co)r(ordinate)33
+(the)g(nativ)n(e)f(graphical)227 2596 y(co)r(ordinate)33
b(system)h(itself)6 b(\))35 b(b)n(y)f(selecting)g(di\013eren)n(t)g(F)-7
b(rames)33 b(as)h(the)g(curren)n(t)f(F)-7 b(rame)34 b(of)g(a)g(Plot,)h
-(using)e(its)227 2520 y(Curren)n(t)d(attribute.)47 b(Y)-7
+(using)e(its)227 2696 y(Curren)n(t)d(attribute.)47 b(Y)-7
b(ou)31 b(ma)n(y)f(also)g(set)h(up)g(clipping)g(\(see)f(astClip\))h(to)
g(limit)h(the)f(exten)n(t)g(of)g(an)n(y)f(plotting)227
-2620 y(y)n(ou)c(p)r(erform,)h(and)f(this)h(ma)n(y)f(b)r(e)h(done)f(in)h
+2795 y(y)n(ou)c(p)r(erform,)h(and)f(this)h(ma)n(y)f(b)r(e)h(done)f(in)h
(an)n(y)f(of)h(the)g(co)r(ordinate)e(systems)i(asso)r(ciated)e(with)i
-(the)g(Plot,)g(not)227 2719 y(necessarily)f(the)i(one)f(y)n(ou)g(are)g
-(plotting)g(in.)227 2857 y(Lik)n(e)k(an)n(y)f(F)-7 b(rameSet,)32
+(the)g(Plot,)g(not)227 2895 y(necessarily)f(the)i(one)f(y)n(ou)g(are)g
+(plotting)g(in.)227 3016 y(Lik)n(e)k(an)n(y)f(F)-7 b(rameSet,)32
b(a)f(Plot)g(ma)n(y)f(also)g(b)r(e)i(used)f(as)g(a)f(F)-7
b(rame.)47 b(In)32 b(this)f(case,)h(it)f(b)r(eha)n(v)n(es)f(lik)n(e)h
-(its)g(curren)n(t)227 2957 y(F)-7 b(rame,)27 b(whic)n(h)h(describ)r(es)
-f(the)h(ph)n(ysical)f(co)r(ordinate)f(system.)227 3094
+(its)g(curren)n(t)227 3115 y(F)-7 b(rame,)27 b(whic)n(h)h(describ)r(es)
+f(the)h(ph)n(ysical)f(co)r(ordinate)f(system.)227 3236
y(When)35 b(used)f(as)g(a)g(Mapping,)h(a)f(Plot)g(describ)r(es)f(the)i
(in)n(ter-relation)e(b)r(et)n(w)n(een)h(graphical)e(co)r(ordinates)h
-(\(its)227 3194 y(base)k(F)-7 b(rame\))38 b(and)f(ph)n(ysical)g(co)r
+(\(its)227 3336 y(base)k(F)-7 b(rame\))38 b(and)f(ph)n(ysical)g(co)r
(ordinates)g(\(its)h(curren)n(t)f(F)-7 b(rame\).)67 b(It)38
b(di\013ers)f(from)h(a)f(normal)g(F)-7 b(rameSet,)227
-3294 y(ho)n(w)n(ev)n(er,)29 b(in)h(that)h(an)e(attempt)i(to)f
+3435 y(ho)n(w)n(ev)n(er,)29 b(in)h(that)h(an)e(attempt)i(to)f
(transform)f(p)r(oin)n(ts)h(whic)n(h)g(lie)g(in)h(clipp)r(ed)f(areas)f
-(of)h(the)g(Plot)g(will)g(result)227 3393 y(in)e(bad)g(co)r(ordinate)e
-(v)-5 b(alues)27 b(\(AST)p Ft(__)p Fi(BAD\).)0 3569 y
+(of)h(the)g(Plot)g(will)g(result)227 3535 y(in)e(bad)g(co)r(ordinate)e
+(v)-5 b(alues)27 b(\(AST)p Ft(__)p Fi(BAD\).)0 3677 y
Fd(Synopsis:)121 b Ft(AstPlot)41 b Fh(\003)p Ft(astPlot\()e(AstFrame)i
Fh(\003)p Ft(frame,)f(const)i(float)f(graphbox[)f(4)j(],)g(const)f
-(double)f(basebox[)227 3668 y(4)i(],)g(const)f(char)g
-Fh(\003)p Ft(options,)d(...)86 b(\))0 3844 y Fd(P)m(arameters:)259
-4006 y(frame)427 4106 y Fi(P)n(oin)n(ter)33 b(to)h(a)g(F)-7
+(double)f(basebox[)227 3777 y(4)i(],)g(const)f(char)g
+Fh(\003)p Ft(options,)d(...)86 b(\))0 3919 y Fd(P)m(arameters:)259
+4048 y(frame)427 4147 y Fi(P)n(oin)n(ter)33 b(to)h(a)g(F)-7
b(rame)34 b(describing)g(the)h(ph)n(ysical)e(co)r(ordinate)g(system)i
(in)f(whic)n(h)h(to)f(plot.)57 b(A)35 b(p)r(oin)n(ter)427
-4206 y(to)29 b(a)g(F)-7 b(rameSet)29 b(ma)n(y)f(also)g(b)r(e)h(giv)n
+4247 y(to)29 b(a)g(F)-7 b(rameSet)29 b(ma)n(y)f(also)g(b)r(e)h(giv)n
(en,)g(in)g(whic)n(h)g(case)f(its)i(curren)n(t)e(F)-7
b(rame)28 b(will)i(b)r(e)f(used)g(to)g(de\014ne)g(the)427
-4305 y(ph)n(ysical)i(co)r(ordinate)g(system)h(and)g(its)g(base)f(F)-7
+4346 y(ph)n(ysical)i(co)r(ordinate)g(system)h(and)g(its)g(base)f(F)-7
b(rame)31 b(will)i(b)r(e)f(mapp)r(ed)g(on)g(to)g(graphical)e(co)r
-(ordinates)427 4405 y(\(see)e(b)r(elo)n(w\).)427 4528
+(ordinates)427 4446 y(\(see)e(b)r(elo)n(w\).)427 4559
y(If)h(a)g(n)n(ull)f(Ob)5 b(ject)29 b(p)r(oin)n(ter)f(\(AST)p
Ft(__)p Fi(NULL\))h(is)g(giv)n(en,)f(a)g(default)h(2-dimensional)f(F)-7
-b(rame)28 b(will)h(b)r(e)g(used)427 4627 y(to)35 b(describ)r(e)f(the)h
+b(rame)28 b(will)h(b)r(e)g(used)427 4658 y(to)35 b(describ)r(e)f(the)h
(ph)n(ysical)f(co)r(ordinate)f(system.)58 b(Lab)r(els,)36
b(etc.)58 b(ma)n(y)34 b(then)h(b)r(e)g(attac)n(hed)f(to)h(this)g(b)n(y)
-427 4727 y(setting)28 b(the)g(appropriate)e(F)-7 b(rame)27
+427 4758 y(setting)28 b(the)g(appropriate)e(F)-7 b(rame)27
b(attributes)g(\(e.g.)37 b(Lab)r(el\(axis\)\))27 b(for)h(the)g(Plot.)
-259 4873 y Fd(graph)m(b)s(o)m(x)427 4972 y Fi(An)k(arra)n(y)c(giving)i
+259 4883 y Fd(graph)m(b)s(o)m(x)427 4983 y Fi(An)k(arra)n(y)c(giving)i
(the)h(p)r(osition)g(and)g(exten)n(t)g(of)g(the)g(plotting)g(area)e
-(\(on)i(the)g(plotting)g(surface)f(of)h(the)427 5072
+(\(on)i(the)g(plotting)g(surface)f(of)h(the)427 5082
y(underlying)e(graphics)f(system\))i(in)g(whic)n(h)f(graphical)f
(output)i(is)g(to)f(app)r(ear.)42 b(This)30 b(m)n(ust)f(b)r(e)h(sp)r
-(eci\014ed)427 5172 y(using)e(graphical)e(co)r(ordinates)g(appropriate)
+(eci\014ed)427 5182 y(using)e(graphical)e(co)r(ordinates)g(appropriate)
g(to)h(the)h(underlying)f(graphics)f(system.)427 5295
y(The)k(\014rst)f(pair)f(of)h(v)-5 b(alues)29 b(should)g(giv)n(e)f(the)
i(co)r(ordinates)e(of)h(the)h(b)r(ottom)f(left)h(corner)e(of)h(the)h
@@ -120640,14 +120746,13 @@ y(these)26 b(p)r(oin)n(ts)h(are)e(giv)n(en)g(is)h(imp)r(ortan)n(t)g(b)r
(ecause)g(it)g(de\014nes)g(up,)h(do)n(wn,)f(left)h(and)f(righ)n(t)f
(for)h(subsequen)n(t)427 5693 y(graphical)g(op)r(erations.)p
eop end
-%%Page: 312 322
-TeXDict begin 312 321 bop 0 52 a FF(312)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(baseb)s(o)m(x)427
-451 y Fi(An)d(arra)n(y)d(giving)i(the)h(co)r(ordinates)e(of)i(t)n(w)n
-(o)e(p)r(oin)n(ts)i(in)g(the)g(supplied)g(F)-7 b(rame)26
-b(\(or)f(in)i(the)g(base)f(F)-7 b(rame)26 b(if)427 551
-y(a)k(F)-7 b(rameSet)31 b(w)n(as)e(supplied\))i(whic)n(h)g(corresp)r
-(ond)d(to)j(the)g(b)r(ottom)f(left)i(and)e(top)g(righ)n(t)g(corners)f
+%%Page: 313 323
+TeXDict begin 313 322 bop 3643 52 a FF(313)259 351 y
+Fd(baseb)s(o)m(x)427 451 y Fi(An)27 b(arra)n(y)d(giving)i(the)h(co)r
+(ordinates)e(of)i(t)n(w)n(o)e(p)r(oin)n(ts)i(in)g(the)g(supplied)g(F)-7
+b(rame)26 b(\(or)f(in)i(the)g(base)f(F)-7 b(rame)26 b(if)427
+551 y(a)k(F)-7 b(rameSet)31 b(w)n(as)e(supplied\))i(whic)n(h)g(corresp)
+r(ond)d(to)j(the)g(b)r(ottom)f(left)i(and)e(top)g(righ)n(t)g(corners)f
(of)h(the)427 650 y(plotting)25 b(area,)g(as)f(sp)r(eci\014ed)h(ab)r(o)
n(v)n(e.)35 b(This)25 b(range)f(of)h(co)r(ordinates)e(will)i(b)r(e)h
(mapp)r(ed)f(linearly)g(on)f(to)h(the)427 750 y(plotting)j(area.)35
@@ -120730,21 +120835,21 @@ b Fh(\003)p Ft(astPlot3D\()f(AstFrame)h Fh(\003)p Ft(frame,)h(const)g
(float)h(graphbox[)d(6)44 b(],)e(const)g(double)227 5562
y(basebox[)f(6)i(],)f(const)g(char)g Fh(\003)p Ft(options,)e(...)86
b(\))0 5718 y Fd(P)m(arameters:)p eop end
-%%Page: 313 323
-TeXDict begin 313 322 bop 3643 52 a FF(313)259 351 y
-Fd(frame)427 451 y Fi(P)n(oin)n(ter)33 b(to)h(a)g(F)-7
-b(rame)34 b(describing)g(the)h(ph)n(ysical)e(co)r(ordinate)g(system)i
-(in)f(whic)n(h)h(to)f(plot.)57 b(A)35 b(p)r(oin)n(ter)427
-551 y(to)29 b(a)g(F)-7 b(rameSet)29 b(ma)n(y)f(also)g(b)r(e)h(giv)n
-(en,)g(in)g(whic)n(h)g(case)f(its)i(curren)n(t)e(F)-7
-b(rame)28 b(will)i(b)r(e)f(used)g(to)g(de\014ne)g(the)427
-650 y(ph)n(ysical)i(co)r(ordinate)g(system)h(and)g(its)g(base)f(F)-7
-b(rame)31 b(will)i(b)r(e)f(mapp)r(ed)g(on)g(to)g(graphical)e(co)r
-(ordinates)427 750 y(\(see)e(b)r(elo)n(w\).)427 868 y(If)h(a)g(n)n(ull)
-f(Ob)5 b(ject)29 b(p)r(oin)n(ter)f(\(AST)p Ft(__)p Fi(NULL\))h(is)g
-(giv)n(en,)f(a)g(default)h(3-dimensional)f(F)-7 b(rame)28
-b(will)h(b)r(e)g(used)427 967 y(to)35 b(describ)r(e)f(the)h(ph)n
-(ysical)f(co)r(ordinate)f(system.)58 b(Lab)r(els,)36
+%%Page: 314 324
+TeXDict begin 314 323 bop 0 52 a FF(314)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(frame)427
+451 y Fi(P)n(oin)n(ter)j(to)h(a)g(F)-7 b(rame)34 b(describing)g(the)h
+(ph)n(ysical)e(co)r(ordinate)g(system)i(in)f(whic)n(h)h(to)f(plot.)57
+b(A)35 b(p)r(oin)n(ter)427 551 y(to)29 b(a)g(F)-7 b(rameSet)29
+b(ma)n(y)f(also)g(b)r(e)h(giv)n(en,)g(in)g(whic)n(h)g(case)f(its)i
+(curren)n(t)e(F)-7 b(rame)28 b(will)i(b)r(e)f(used)g(to)g(de\014ne)g
+(the)427 650 y(ph)n(ysical)i(co)r(ordinate)g(system)h(and)g(its)g(base)
+f(F)-7 b(rame)31 b(will)i(b)r(e)f(mapp)r(ed)g(on)g(to)g(graphical)e(co)
+r(ordinates)427 750 y(\(see)e(b)r(elo)n(w\).)427 868
+y(If)h(a)g(n)n(ull)f(Ob)5 b(ject)29 b(p)r(oin)n(ter)f(\(AST)p
+Ft(__)p Fi(NULL\))h(is)g(giv)n(en,)f(a)g(default)h(3-dimensional)f(F)-7
+b(rame)28 b(will)h(b)r(e)g(used)427 967 y(to)35 b(describ)r(e)f(the)h
+(ph)n(ysical)f(co)r(ordinate)f(system.)58 b(Lab)r(els,)36
b(etc.)58 b(ma)n(y)34 b(then)h(b)r(e)g(attac)n(hed)f(to)h(this)g(b)n(y)
427 1067 y(setting)28 b(the)g(appropriate)e(F)-7 b(rame)27
b(attributes)g(\(e.g.)37 b(Lab)r(el\(axis\)\))27 b(for)h(the)g(Plot.)
@@ -120825,13 +120930,12 @@ b(b)r(ecoming)h(the)g(curren)n(t)e(F)-7 b(rame)27 b(of)h(the)g(Plot3D.)
(axes)e(of)h(the)h(curren)n(t)f(F)-7 b(rame)33 b(m)n(ust)g(b)r(e)h
(indep)r(enden)n(t)g(of)g(the)g(other)e(t)n(w)n(o)427
5693 y(curren)n(t)27 b(F)-7 b(rame)27 b(axes.)p eop end
-%%Page: 314 324
-TeXDict begin 314 323 bop 0 52 a FF(314)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
-b Fi(If)19 b(a)f(n)n(ull)h(Ob)5 b(ject)18 b(p)r(oin)n(ter)g(\(AST)p
-Ft(__)p Fi(NULL\))h(is)f(supplied)h(\(via)f(the)h Ft(")p
-Fi(frame)p Ft(")e Fi(p)r(oin)n(ter\),)j(then)f(the)g(returned)427
-451 y(Plot3D)25 b(will)g(con)n(tain)f(t)n(w)n(o)h(F)-7
+%%Page: 315 325
+TeXDict begin 315 324 bop 3643 52 a FF(315)340 351 y
+Fh(\017)45 b Fi(If)19 b(a)f(n)n(ull)h(Ob)5 b(ject)18
+b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))h(is)f(supplied)h(\(via)f
+(the)h Ft(")p Fi(frame)p Ft(")e Fi(p)r(oin)n(ter\),)j(then)f(the)g
+(returned)427 451 y(Plot3D)25 b(will)g(con)n(tain)f(t)n(w)n(o)h(F)-7
b(rames,)24 b(b)r(oth)i(created)e(b)n(y)h(this)g(function.)37
b(The)25 b(base)f(F)-7 b(rame)25 b(will)g(describ)r(e)427
551 y(graphics)18 b(co)r(ordinates)f(\(as)i(ab)r(o)n(v)n(e\))f(and)h
@@ -120927,35 +121031,35 @@ y(equiv)-5 b(alen)n(t)28 b(to)f(a)g(b)r(o)n(x)g(1.0E-6)f(of)h(the)h
5693 y(for)g(equalit)n(y)h(the)g(uncertain)n(t)n(y)f(Region)g(is)g
(used)h(to)g(determine)f(the)i(tolerance)d(on)i(the)g(comparison,)f
(and)p eop end
-%%Page: 315 325
-TeXDict begin 315 324 bop 3643 52 a FF(315)427 351 y
-Fi(2\))31 b(when)f(a)h(Region)e(is)i(mapp)r(ed)g(in)n(to)f(a)g
-(di\013eren)n(t)h(co)r(ordinate)e(system)i(and)f(subsequen)n(tly)g
-(simpli\014ed)427 451 y(\(using)c(astSimplify\),)h(the)f(uncertain)n
-(ties)f(are)g(used)h(to)g(determine)g(if)g(the)g(transformed)f(b)r
-(oundary)g(can)427 551 y(b)r(e)j(accurately)e(represen)n(ted)h(b)n(y)g
-(a)g(sp)r(eci\014c)h(shap)r(e)f(of)h(Region.)259 677
-y Fd(options)427 776 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n(ull-terminated)g
-(string)f(con)n(taining)g(an)h(optional)g(comma-separated)e(list)i(of)g
-(attribute)427 876 y(assignmen)n(ts)23 b(to)h(b)r(e)g(used)g(for)g
-(initialising)g(the)g(new)g(P)n(oin)n(tList.)35 b(The)24
-b(syn)n(tax)f(used)h(is)g(iden)n(tical)f(to)h(that)427
-975 y(for)i(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
-Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n
-(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-1075 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 1201
-y Fd(...)427 1301 y Fi(If)38 b(the)g Ft(")p Fi(options)p
-Ft(")e Fi(string)h(con)n(tains)f Ft(")p Fi(\045)p Ft(")h
-Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g(list)h(of)f
-(additional)427 1400 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
-(order)e(to)h(supply)h(v)-5 b(alues)27 b(to)g(b)r(e)h(substituted)h
-(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 1500 y(rules)25
-b(for)f(supplying)h(these)g(are)f(iden)n(tical)h(to)g(those)g(for)f
-(the)h(astSet)g(function)h(\(and)f(for)g(the)g(C)g Ft(")p
-Fi(prin)n(tf)p Ft(")427 1600 y Fi(function\).)0 1755
-y Fd(Returned)32 b(V)-8 b(alue:)259 1884 y(astP)m(oin)m(tList\(\))427
-1984 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(P)n(oin)n(tList.)0
-2139 y Fd(Notes:)340 2415 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+%%Page: 316 326
+TeXDict begin 316 325 bop 0 52 a FF(316)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)427 351 y Fi(2\))h(when)f(a)h
+(Region)e(is)i(mapp)r(ed)g(in)n(to)f(a)g(di\013eren)n(t)h(co)r
+(ordinate)e(system)i(and)f(subsequen)n(tly)g(simpli\014ed)427
+451 y(\(using)c(astSimplify\),)h(the)f(uncertain)n(ties)f(are)g(used)h
+(to)g(determine)g(if)g(the)g(transformed)f(b)r(oundary)g(can)427
+551 y(b)r(e)j(accurately)e(represen)n(ted)h(b)n(y)g(a)g(sp)r(eci\014c)h
+(shap)r(e)f(of)h(Region.)259 677 y Fd(options)427 776
+y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n(ull-terminated)g(string)f(con)n
+(taining)g(an)h(optional)g(comma-separated)e(list)i(of)g(attribute)427
+876 y(assignmen)n(ts)23 b(to)h(b)r(e)g(used)g(for)g(initialising)g(the)
+g(new)g(P)n(oin)n(tList.)35 b(The)24 b(syn)n(tax)f(used)h(is)g(iden)n
+(tical)f(to)h(that)427 975 y(for)i(the)h(astSet)g(function)g(and)g(ma)n
+(y)f(include)h Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r
+(eci\014ers)g(iden)n(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p
+Ft(")g Fi(sym)n(b)r(ols)427 1075 y(in)i(the)g(normal)f(w)n(a)n(y)-7
+b(.)259 1201 y Fd(...)427 1301 y Fi(If)38 b(the)g Ft(")p
+Fi(options)p Ft(")e Fi(string)h(con)n(tains)f Ft(")p
+Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g
+(list)h(of)f(additional)427 1400 y(argumen)n(ts)26 b(ma)n(y)h(follo)n
+(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5 b(alues)27
+b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)37
+b(The)427 1500 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 1600 y Fi(function\).)0
+1755 y Fd(Returned)32 b(V)-8 b(alue:)259 1884 y(astP)m(oin)m(tList\(\))
+427 1984 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(P)n(oin)n(tList.)
+0 2139 y Fd(Notes:)340 2415 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
427 2514 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
@@ -121005,17 +121109,16 @@ b(if)h(they)f(do)g(not)g(en)n(tirely)g(\014ll)h(this)f(arra)n(y)-7
b(.)33 b(The)21 b(v)-5 b(alue)21 b(giv)n(en)f(should)h(not)g(b)r(e)h
(less)f(than)g Ft(")p Fi(np)r(oin)n(t)p Ft(")p Fi(.)p
eop end
-%%Page: 316 326
-TeXDict begin 316 325 bop 0 52 a FF(316)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(in)427
-451 y Fi(The)i(address)e(of)i(the)g(\014rst)f(elemen)n(t)h(in)f(a)h
-(2-dimensional)e(arra)n(y)f(of)j(shap)r(e)f Ft(")p Fi([nco)r
-(ord][indim])p Ft(")f Fi(giving)427 551 y(the)e(ph)n(ysical)e(co)r
-(ordinates)g(of)h(the)g(p)r(oin)n(ts)h(whic)n(h)f(are)f(to)h(b)r(e)g
-(joined)h(in)f(sequence)g(b)n(y)g(geo)r(desic)f(curv)n(es.)427
-650 y(These)j(should)g(b)r(e)h(stored)e(suc)n(h)h(that)g(the)h(v)-5
-b(alue)29 b(of)g(co)r(ordinate)f(n)n(um)n(b)r(er)h Ft(")p
-Fi(co)r(ord)p Ft(")e Fi(for)i(p)r(oin)n(t)g(n)n(um)n(b)r(er)427
+%%Page: 317 327
+TeXDict begin 317 326 bop 3643 52 a FF(317)259 351 y
+Fd(in)427 451 y Fi(The)32 b(address)e(of)i(the)g(\014rst)f(elemen)n(t)h
+(in)f(a)h(2-dimensional)e(arra)n(y)f(of)j(shap)r(e)f
+Ft(")p Fi([nco)r(ord][indim])p Ft(")f Fi(giving)427 551
+y(the)e(ph)n(ysical)e(co)r(ordinates)g(of)h(the)g(p)r(oin)n(ts)h(whic)n
+(h)f(are)f(to)h(b)r(e)g(joined)h(in)f(sequence)g(b)n(y)g(geo)r(desic)f
+(curv)n(es.)427 650 y(These)j(should)g(b)r(e)h(stored)e(suc)n(h)h(that)
+g(the)h(v)-5 b(alue)29 b(of)g(co)r(ordinate)f(n)n(um)n(b)r(er)h
+Ft(")p Fi(co)r(ord)p Ft(")e Fi(for)i(p)r(oin)n(t)g(n)n(um)n(b)r(er)427
750 y Ft(")p Fi(p)r(oin)n(t)p Ft(")e Fi(is)h(found)g(in)f(elemen)n(t)h
Ft(")p Fi(in[co)r(ord][p)r(oin)n(t])p Ft(")p Fi(.)0 907
y Fd(Notes:)340 1185 y Fh(\017)45 b Fi(No)32 b(curv)n(e)f(is)i(dra)n
@@ -121102,16 +121205,17 @@ Fi(nco)r(e\013)p Ft(_)p Fi(f)p Ft(")g Fi(terms)f(describ)r(ed)h(b)n(y)g
(the)h Ft(")p Fi(nco-)427 5693 y(e\013)p Ft(_)p Fi(f)p
Ft(")h Fi(groups)e(within)i(the)g(supplied)g(arra)n(y)-7
b(.)p eop end
-%%Page: 317 327
-TeXDict begin 317 326 bop 3643 52 a FF(317)259 351 y
-Fd(nco)s(e\013)p Ft(_)p Fd(i)427 451 y Fi(The)38 b(n)n(um)n(b)r(er)g
-(of)g(non-zero)e(co)r(e\016cien)n(ts)i(necessary)e(to)i(de\014ne)g(the)
-g(in)n(v)n(erse)f(transformation)f(of)i(the)427 551 y(P)n(olyMap.)e(If)
-28 b(zero)e(is)i(supplied,)g(the)g(in)n(v)n(erse)e(transformation)g
-(will)h(b)r(e)h(unde\014ned.)259 684 y Fd(co)s(e\013)p
-Ft(_)p Fd(i)427 783 y Fi(An)k(arra)n(y)c(con)n(taining)i
-Ft(")p Fi(nco)r(e\013)p Ft(_)p Fi(i)p Fh(\003)p Fi(\()h(2)f(+)h(nout)g
-(\))p Ft(")g Fi(elemen)n(ts.)47 b(Eac)n(h)30 b(group)g(of)h
+%%Page: 318 328
+TeXDict begin 318 327 bop 0 52 a FF(318)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(nco)s(e\013)p
+Ft(_)p Fd(i)427 451 y Fi(The)38 b(n)n(um)n(b)r(er)g(of)g(non-zero)e(co)
+r(e\016cien)n(ts)i(necessary)e(to)i(de\014ne)g(the)g(in)n(v)n(erse)f
+(transformation)f(of)i(the)427 551 y(P)n(olyMap.)e(If)28
+b(zero)e(is)i(supplied,)g(the)g(in)n(v)n(erse)e(transformation)g(will)h
+(b)r(e)h(unde\014ned.)259 684 y Fd(co)s(e\013)p Ft(_)p
+Fd(i)427 783 y Fi(An)k(arra)n(y)c(con)n(taining)i Ft(")p
+Fi(nco)r(e\013)p Ft(_)p Fi(i)p Fh(\003)p Fi(\()h(2)f(+)h(nout)g(\))p
+Ft(")g Fi(elemen)n(ts.)47 b(Eac)n(h)30 b(group)g(of)h
Ft(")p Fi(2)f(+)g(nout)p Ft(")h Fi(adjacen)n(t)427 883
y(elemen)n(ts)25 b(describ)r(e)g(a)g(single)g(co)r(e\016cien)n(t)g(of)h
(the)f(in)n(v)n(erse)f(transformation,)g(using)h(the)h(same)f(sc)n
@@ -121196,21 +121300,20 @@ g(the)i(most)e(lik)n(ely)h(case\),)h(a)f(new)g(in)n(v)n(erse)e
(the)g(output)h(v)-5 b(alues)37 b(\(Y\))g(using)g(the)g(forw)n(ard)f
(transformation)f(\(whic)n(h)i(m)n(ust)g(b)r(e)h(a)n(v)-5
b(ailable\))p eop end
-%%Page: 318 328
-TeXDict begin 318 327 bop 0 52 a FF(318)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)227 351 y Fi(at)i(a)g(regular)e
-(grid)i(of)g(p)r(oin)n(ts)g(\(X\))h(co)n(v)n(ering)d(a)i(rectangular)e
-(region)h(of)h(the)g(P)n(olyMap's)f(input)i(space.)50
-b(The)227 451 y(co)r(e\016cien)n(ts)24 b(of)g(the)h(required)e(in)n(v)n
-(erse)f(p)r(olynomial,)j(X=P)p Ft(_)p Fi(i\(Y\),)f(are)f(c)n(hosen)g
-(in)i(order)d(to)i(minimise)h(the)f(sum)227 551 y(of)k(the)g(squared)e
-(residuals)h(b)r(et)n(w)n(een)g(the)h(sampled)g(v)-5
-b(alues)27 b(of)g(X)h(and)g(P)p Ft(_)p Fi(i\(Y\).)227
-674 y(This)21 b(\014tting)g(pro)r(cess)e(is)h(p)r(erformed)g(rep)r
-(eatedly)g(with)h(increasing)e(p)r(olynomial)h(orders)f(\(starting)h
-(with)h(linear\))227 773 y(un)n(til)f(the)f(target)f(accuracy)f(is)i
-(ac)n(hiev)n(ed,)g(or)f(a)h(sp)r(eci\014ed)g(maxim)n(um)g(order)e(is)i
-(reac)n(hed.)33 b(If)19 b(the)g(target)f(accuracy)227
+%%Page: 319 329
+TeXDict begin 319 328 bop 3643 52 a FF(319)227 351 y
+Fi(at)32 b(a)g(regular)e(grid)i(of)g(p)r(oin)n(ts)g(\(X\))h(co)n(v)n
+(ering)d(a)i(rectangular)e(region)h(of)h(the)g(P)n(olyMap's)f(input)i
+(space.)50 b(The)227 451 y(co)r(e\016cien)n(ts)24 b(of)g(the)h
+(required)e(in)n(v)n(erse)f(p)r(olynomial,)j(X=P)p Ft(_)p
+Fi(i\(Y\),)f(are)f(c)n(hosen)g(in)i(order)d(to)i(minimise)h(the)f(sum)
+227 551 y(of)k(the)g(squared)e(residuals)h(b)r(et)n(w)n(een)g(the)h
+(sampled)g(v)-5 b(alues)27 b(of)g(X)h(and)g(P)p Ft(_)p
+Fi(i\(Y\).)227 674 y(This)21 b(\014tting)g(pro)r(cess)e(is)h(p)r
+(erformed)g(rep)r(eatedly)g(with)h(increasing)e(p)r(olynomial)h(orders)
+f(\(starting)h(with)h(linear\))227 773 y(un)n(til)f(the)f(target)f
+(accuracy)f(is)i(ac)n(hiev)n(ed,)g(or)f(a)h(sp)r(eci\014ed)g(maxim)n
+(um)g(order)e(is)i(reac)n(hed.)33 b(If)19 b(the)g(target)f(accuracy)227
873 y(cannot)35 b(b)r(e)h(ac)n(hiev)n(ed)e(ev)n(en)h(with)h(this)g
(maxim)n(um-order)e(p)r(olynomial,)j(the)f(b)r(est)g(\014tting)g(maxim)
n(um-order)227 972 y(p)r(olynomial)d(is)h(returned)f(so)g(long)g(as)g
@@ -121282,9 +121385,10 @@ Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 5630 y(AST)28
b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
(reason.)p eop end
-%%Page: 319 329
-TeXDict begin 319 328 bop 3643 52 a FF(319)p 0 351 3780
-12 v 0 483 a Fz(astP)l(olygon)805 b Fe(Create)37 b(a)h(P)m(olygon)801
+%%Page: 320 330
+TeXDict begin 320 329 bop 0 52 a FF(320)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 483 a Fz(astP)l(olygon)805 b Fe(Create)37 b(a)h(P)m(olygon)801
b Fz(astP)l(olygon)0 651 y Fd(Description:)44 b Fi(This)28
b(function)g(creates)f(a)g(new)g(P)n(olygon)f(ob)5 b(ject)27
b(and)h(optionally)e(initialises)i(its)f(attributes.)227
@@ -121391,27 +121495,26 @@ b(1\))22 b(when)h(the)g(astOv)n(erlap)d(function)k(compares)d(t)n(w)n
(transformed)f(b)r(oundary)g(can)427 5693 y(b)r(e)j(accurately)e
(represen)n(ted)h(b)n(y)g(a)g(sp)r(eci\014c)h(shap)r(e)f(of)h(Region.)p
eop end
-%%Page: 320 330
-TeXDict begin 320 329 bop 0 52 a FF(320)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(options)427
-451 y Fi(P)n(oin)n(ter)d(to)h(a)g(n)n(ull-terminated)g(string)f(con)n
-(taining)g(an)h(optional)g(comma-separated)e(list)i(of)g(attribute)427
-551 y(assignmen)n(ts)e(to)h(b)r(e)g(used)g(for)g(initialising)g(the)g
-(new)g(P)n(olygon.)35 b(The)27 b(syn)n(tax)f(used)h(is)g(iden)n(tical)f
-(to)h(that)427 650 y(for)f(the)h(astSet)g(function)g(and)g(ma)n(y)f
-(include)h Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g
-(iden)n(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-750 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 891 y
-Fd(...)427 991 y Fi(If)38 b(the)g Ft(")p Fi(options)p
-Ft(")e Fi(string)h(con)n(tains)f Ft(")p Fi(\045)p Ft(")h
-Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g(list)h(of)f
-(additional)427 1091 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
-(order)e(to)h(supply)h(v)-5 b(alues)27 b(to)g(b)r(e)h(substituted)h
-(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 1190 y(rules)25
-b(for)f(supplying)h(these)g(are)f(iden)n(tical)h(to)g(those)g(for)f
-(the)h(astSet)g(function)h(\(and)f(for)g(the)g(C)g Ft(")p
-Fi(prin)n(tf)p Ft(")427 1290 y Fi(function\).)0 1470
-y Fd(Returned)32 b(V)-8 b(alue:)259 1624 y(astP)m(olygon\(\))427
+%%Page: 321 331
+TeXDict begin 321 330 bop 3643 52 a FF(321)259 351 y
+Fd(options)427 451 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n(ull-terminated)
+g(string)f(con)n(taining)g(an)h(optional)g(comma-separated)e(list)i(of)
+g(attribute)427 551 y(assignmen)n(ts)e(to)h(b)r(e)g(used)g(for)g
+(initialising)g(the)g(new)g(P)n(olygon.)35 b(The)27 b(syn)n(tax)f(used)
+h(is)g(iden)n(tical)f(to)h(that)427 650 y(for)f(the)h(astSet)g
+(function)g(and)g(ma)n(y)f(include)h Ft(")p Fi(prin)n(tf)p
+Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n(ti\014ed)h(b)n(y)f
+Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427 750 y(in)i(the)g(normal)f
+(w)n(a)n(y)-7 b(.)259 891 y Fd(...)427 991 y Fi(If)38
+b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n(tains)f
+Ft(")p Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f
+(optional)g(list)h(of)f(additional)427 1091 y(argumen)n(ts)26
+b(ma)n(y)h(follo)n(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5
+b(alues)27 b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)
+37 b(The)427 1190 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 1290 y Fi(function\).)0
+1470 y Fd(Returned)32 b(V)-8 b(alue:)259 1624 y(astP)m(olygon\(\))427
1723 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(P)n(olygon.)0
1903 y Fd(Notes:)340 2203 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
@@ -121462,18 +121565,18 @@ y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n(ull-terminated)g(string)f(con)n
(include)h Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g
(iden)n(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
5693 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)p eop end
-%%Page: 321 331
-TeXDict begin 321 330 bop 3643 52 a FF(321)259 351 y
-Fd(...)427 451 y Fi(If)38 b(the)g Ft(")p Fi(options)p
-Ft(")e Fi(string)h(con)n(tains)f Ft(")p Fi(\045)p Ft(")h
-Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g(list)h(of)f
-(additional)427 551 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
-(order)e(to)h(supply)h(v)-5 b(alues)27 b(to)g(b)r(e)h(substituted)h
-(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 650 y(rules)25
-b(for)f(supplying)h(these)g(are)f(iden)n(tical)h(to)g(those)g(for)f
-(the)h(astSet)g(function)h(\(and)f(for)g(the)g(C)g Ft(")p
-Fi(prin)n(tf)p Ft(")427 750 y Fi(function\).)0 912 y
-Fd(Returned)32 b(V)-8 b(alue:)259 1048 y(astPrism\(\))427
+%%Page: 322 332
+TeXDict begin 322 331 bop 0 52 a FF(322)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(...)427
+451 y Fi(If)38 b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n
+(tains)f Ft(")p Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f
+(an)f(optional)g(list)h(of)f(additional)427 551 y(argumen)n(ts)26
+b(ma)n(y)h(follo)n(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5
+b(alues)27 b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)
+37 b(The)427 650 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 750 y Fi(function\).)0
+912 y Fd(Returned)32 b(V)-8 b(alue:)259 1048 y(astPrism\(\))427
1148 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Prism.)0
1310 y Fd(Notes:)340 1592 y Fh(\017)45 b Fi(Deep)37 b(copies)g(are)e
(tak)n(en)i(of)f(the)i(supplied)f(Regions.)63 b(This)37
@@ -121521,24 +121624,23 @@ n(v)n(o)r(cation)f(of)h(astRead)g(can)f(b)r(e)i(made)f(immediately)g
(\014rst.)0 5569 y Fd(Synopsis:)121 b Ft(void)42 b(astPutCards\()c
(AstFitsChan)h Fh(\003)p Ft(this,)i(const)h(char)g Fh(\003)p
Ft(cards)f(\))0 5718 y Fd(P)m(arameters:)p eop end
-%%Page: 322 332
-TeXDict begin 322 331 bop 0 52 a FF(322)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(this)427
-451 y Fi(P)n(oin)n(ter)c(to)i(the)g(FitsChan.)259 587
-y Fd(cards)427 686 y Fi(P)n(oin)n(ter)h(to)i(a)f(n)n(ull-terminated)g
-(c)n(haracter)f(string)h(con)n(taining)g(the)h(FITS)g(cards)e(to)i(b)r
-(e)g(stored.)45 b(Eac)n(h)427 786 y(individual)26 b(card)e(should)h(o)r
-(ccup)n(y)g(80)f(c)n(haracters)f(in)i(this)h(string,)f(and)g(there)g
-(should)g(b)r(e)h(no)f(delimiters,)427 886 y(new)31 b(lines,)g(etc,)g
-(b)r(et)n(w)n(een)g(adjacen)n(t)e(cards.)45 b(The)30
-b(\014nal)g(card)g(ma)n(y)f(b)r(e)i(less)f(than)h(80)e(c)n(haracters)f
-(long.)427 985 y(This)g(is)f(the)h(format)f(pro)r(duced)h(b)n(y)f(the)h
-(\014ts)p Ft(_)p Fi(hdr2str)e(function)i(in)g(the)g(CFITSIO)g(library)
--7 b(.)0 1153 y Fd(Notes:)340 1442 y Fh(\017)45 b Fi(An)28
-b(error)e(will)i(result)f(if)h(the)g(supplied)g(string)f(con)n(tains)g
-(an)n(y)f(cards)h(whic)n(h)h(cannot)f(b)r(e)h(in)n(terpreted.)p
-0 1647 3780 12 v 0 1779 a Fz(astPutChannelData)215 b
-Fe(Store)38 b(arbitrary)e(data)1452 1893 y(to)i(b)s(e)h(passed)g(to)f
+%%Page: 323 333
+TeXDict begin 323 332 bop 3643 52 a FF(323)259 351 y
+Fd(this)427 451 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
+587 y Fd(cards)427 686 y Fi(P)n(oin)n(ter)h(to)i(a)f(n)n
+(ull-terminated)g(c)n(haracter)f(string)h(con)n(taining)g(the)h(FITS)g
+(cards)e(to)i(b)r(e)g(stored.)45 b(Eac)n(h)427 786 y(individual)26
+b(card)e(should)h(o)r(ccup)n(y)g(80)f(c)n(haracters)f(in)i(this)h
+(string,)f(and)g(there)g(should)g(b)r(e)h(no)f(delimiters,)427
+886 y(new)31 b(lines,)g(etc,)g(b)r(et)n(w)n(een)g(adjacen)n(t)e(cards.)
+45 b(The)30 b(\014nal)g(card)g(ma)n(y)f(b)r(e)i(less)f(than)h(80)e(c)n
+(haracters)f(long.)427 985 y(This)g(is)f(the)h(format)f(pro)r(duced)h
+(b)n(y)f(the)h(\014ts)p Ft(_)p Fi(hdr2str)e(function)i(in)g(the)g
+(CFITSIO)g(library)-7 b(.)0 1153 y Fd(Notes:)340 1442
+y Fh(\017)45 b Fi(An)28 b(error)e(will)i(result)f(if)h(the)g(supplied)g
+(string)f(con)n(tains)g(an)n(y)f(cards)h(whic)n(h)h(cannot)f(b)r(e)h
+(in)n(terpreted.)p 0 1647 3780 12 v 0 1779 a Fz(astPutChannelData)215
+b Fe(Store)38 b(arbitrary)e(data)1452 1893 y(to)i(b)s(e)h(passed)g(to)f
(a)1313 2008 y(source)c(or)g(sink)h(function)2618 1779
y Fz(astPutChannelData)0 2179 y Fd(Description:)44 b
Fi(This)30 b(function)f(stores)f(a)h(supplied)h(arbitrary)d(p)r(oin)n
@@ -121577,15 +121679,16 @@ Fh(\003)p Ft(column,)g(int)h(clen,)g(size_t)227 5295
y(size,)g(void)g Fh(\003)p Ft(coldata)e(\))0 5451 y Fd(P)m(arameters:)
259 5593 y(this)427 5693 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(FitsT)-7
b(able.)p eop end
-%%Page: 323 333
-TeXDict begin 323 332 bop 3643 52 a FF(323)259 351 y
-Fd(column)427 451 y Fi(The)28 b(c)n(haracter)d(string)i(holding)h(the)g
-(name)f(of)g(the)h(column.)37 b(T)-7 b(railing)27 b(spaces)g(are)f
-(ignored.)259 579 y Fd(clen)427 679 y Fi(If)g(the)f(column)g(holds)g(c)
-n(haracter)e(strings,)i(then)h(this)f(m)n(ust)g(b)r(e)h(set)f(to)g(the)
-h(length)f(of)g(eac)n(h)f(\014xed)i(length)427 778 y(string)h(in)g(the)
-h(supplied)g(arra)n(y)-7 b(.)34 b(This)27 b(is)g(often)h(determined)f
-(b)n(y)g(the)h(appropriate)d(TF)n(ORMn)i(k)n(eyw)n(ord)427
+%%Page: 324 334
+TeXDict begin 324 333 bop 0 52 a FF(324)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(column)427
+451 y Fi(The)e(c)n(haracter)d(string)i(holding)h(the)g(name)f(of)g(the)
+h(column.)37 b(T)-7 b(railing)27 b(spaces)g(are)f(ignored.)259
+579 y Fd(clen)427 679 y Fi(If)g(the)f(column)g(holds)g(c)n(haracter)e
+(strings,)i(then)h(this)f(m)n(ust)g(b)r(e)h(set)f(to)g(the)h(length)f
+(of)g(eac)n(h)f(\014xed)i(length)427 778 y(string)h(in)g(the)h
+(supplied)g(arra)n(y)-7 b(.)34 b(This)27 b(is)g(often)h(determined)f(b)
+n(y)g(the)h(appropriate)d(TF)n(ORMn)i(k)n(eyw)n(ord)427
878 y(in)21 b(the)g(binary)e(table)h(header.)34 b(The)20
b(supplied)h(v)-5 b(alue)20 b(is)g(ignored)f(if)i(the)g(column)f(do)r
(es)g(not)g(hold)h(c)n(haracter)427 978 y(data.)259 1106
@@ -121657,10 +121760,9 @@ y(in)n(v)n(ok)n(ed)e(to)i(store)e(a)i(named)f(table)h(in)g(the)g
(AstFitsChan)h Fh(\003)p Ft(this,)i(AstFitsTable)e Fh(\003)p
Ft(table,)i(const)g(char)h Fh(\003)p Ft(extnam)227 5693
y(\))p eop end
-%%Page: 324 334
-TeXDict begin 324 333 bop 0 52 a FF(324)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(P)m(arameters:)259
-485 y(this)427 584 y Fi(P)n(oin)n(ter)c(to)i(the)g(FitsChan.)259
+%%Page: 325 335
+TeXDict begin 325 334 bop 3643 52 a FF(325)0 351 y Fd(P)m(arameters:)
+259 485 y(this)427 584 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
714 y Fd(table)427 813 y Fi(P)n(oin)n(ter)38 b(to)h(a)g(FitsT)-7
b(able)39 b(to)g(b)r(e)h(added)f(to)g(the)g(FitsChan.)72
b(If)40 b(a)e(FitsT)-7 b(able)40 b(with)f(the)h(asso)r(ciated)427
@@ -121731,8 +121833,9 @@ b(function)i(pro)n(vides)e(an)h(alternativ)n(e)g(mec)n(hanism)g(in)g
(whic)n(h)h(a)f(caller-supplied)g(function)h(is)227 5693
y(in)n(v)n(ok)n(ed)e(to)i(store)e(a)i(named)f(table)h(in)g(the)g
(FitsChan.)p eop end
-%%Page: 325 335
-TeXDict begin 325 334 bop 3643 52 a FF(325)0 351 y Fd(Synopsis:)121
+%%Page: 326 336
+TeXDict begin 326 335 bop 0 52 a FF(326)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Synopsis:)121
b Ft(void)42 b(astPutTables\()c(AstFitsChan)h Fh(\003)p
Ft(this,)i(AstKeyMap)f Fh(\003)p Ft(tables)h(\))0 515
y Fd(P)m(arameters:)259 667 y(this)427 766 y Fi(P)n(oin)n(ter)26
@@ -121807,12 +121910,11 @@ Ft(")427 5593 y Fi(and)33 b(the)h(last)f(is)g(at)g Ft(")p
Fi(ubnd[0])p Ft(")p Fi(.)52 b(If)34 b(a)f(v)-5 b(alue)33
b(less)f(than)i(three)f(is)g(supplied)g(a)g(v)-5 b(alue)33
b(of)g(three)g(will)g(b)r(e)427 5693 y(used.)p eop end
-%%Page: 326 336
-TeXDict begin 326 335 bop 0 52 a FF(326)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(n)m(y)427
-451 y Fi(The)22 b(n)n(um)n(b)r(er)f(of)h(p)r(oin)n(ts)f(to)h(place)f
-(along)f(the)i(second)f(Mapping)g(input.)36 b(The)21
-b(\014rst)h(p)r(oin)n(t)f(is)h(at)f Ft(")p Fi(lbnd[1])p
+%%Page: 327 337
+TeXDict begin 327 336 bop 3643 52 a FF(327)259 351 y
+Fd(n)m(y)427 451 y Fi(The)22 b(n)n(um)n(b)r(er)f(of)h(p)r(oin)n(ts)f
+(to)h(place)f(along)f(the)i(second)f(Mapping)g(input.)36
+b(The)21 b(\014rst)h(p)r(oin)n(t)f(is)h(at)f Ft(")p Fi(lbnd[1])p
Ft(")427 551 y Fi(and)33 b(the)h(last)f(is)g(at)g Ft(")p
Fi(ubnd[1])p Ft(")p Fi(.)52 b(If)34 b(a)f(v)-5 b(alue)33
b(less)f(than)i(three)f(is)g(supplied)g(a)g(v)-5 b(alue)33
@@ -121890,24 +121992,25 @@ h(the)f(Mapping)g(output)h(for)f(whic)n(h)g(the)h(rate)f(of)g(c)n
(hange)f(is)i(to)f(b)r(e)h(found)g(\(output)g(n)n(um-)427
5693 y(b)r(ering)d(starts)g(at)h(1)f(for)g(the)h(\014rst)f(output\).)p
eop end
-%%Page: 327 337
-TeXDict begin 327 336 bop 3643 52 a FF(327)259 351 y
-Fd(ax2)427 451 y Fi(The)35 b(index)g(of)g(the)g(Mapping)g(input)h(whic)
-n(h)e(is)h(to)g(b)r(e)g(v)-5 b(aried)35 b(in)g(order)e(to)i(\014nd)g
-(the)h(rate)e(of)h(c)n(hange)427 551 y(\(input)29 b(n)n(um)n(b)r(ering)
-e(starts)g(at)g(1)g(for)g(the)h(\014rst)g(input\).)0
-715 y Fd(Returned)k(V)-8 b(alue:)259 854 y(astRate\(\))427
-953 y Fi(The)26 b(rate)e(of)i(c)n(hange)e(of)h(Mapping)g(output)h
-Ft(")p Fi(ax1)p Ft(")e Fi(with)i(resp)r(ect)f(to)g(input)h
-Ft(")p Fi(ax2)p Ft(")p Fi(,)e(ev)-5 b(aluated)25 b(at)g
-Ft(")p Fi(at)p Ft(")p Fi(,)427 1053 y(or)i(AST)p Ft(__)p
-Fi(BAD)h(if)g(the)g(v)-5 b(alue)27 b(cannot)g(b)r(e)h(calculated.)0
-1217 y Fd(Notes:)340 1502 y Fh(\017)45 b Fi(A)24 b(v)-5
-b(alue)23 b(of)g(AST)p Ft(__)p Fi(BAD)h(will)f(b)r(e)h(returned)f(if)h
-(this)g(function)g(is)f(in)n(v)n(ok)n(ed)f(with)i(the)f(global)f(error)
-g(status)427 1601 y(set,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n
-(y)g(reason.)p 0 1803 3780 12 v 0 1934 a Fz(astRateMap)1416
-1933 y Fe(Create)37 b(a)i(RateMap)3062 1934 y Fz(astRateMap)0
+%%Page: 328 338
+TeXDict begin 328 337 bop 0 52 a FF(328)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(ax2)427
+451 y Fi(The)35 b(index)g(of)g(the)g(Mapping)g(input)h(whic)n(h)e(is)h
+(to)g(b)r(e)g(v)-5 b(aried)35 b(in)g(order)e(to)i(\014nd)g(the)h(rate)e
+(of)h(c)n(hange)427 551 y(\(input)29 b(n)n(um)n(b)r(ering)e(starts)g
+(at)g(1)g(for)g(the)h(\014rst)g(input\).)0 715 y Fd(Returned)k(V)-8
+b(alue:)259 854 y(astRate\(\))427 953 y Fi(The)26 b(rate)e(of)i(c)n
+(hange)e(of)h(Mapping)g(output)h Ft(")p Fi(ax1)p Ft(")e
+Fi(with)i(resp)r(ect)f(to)g(input)h Ft(")p Fi(ax2)p Ft(")p
+Fi(,)e(ev)-5 b(aluated)25 b(at)g Ft(")p Fi(at)p Ft(")p
+Fi(,)427 1053 y(or)i(AST)p Ft(__)p Fi(BAD)h(if)g(the)g(v)-5
+b(alue)27 b(cannot)g(b)r(e)h(calculated.)0 1217 y Fd(Notes:)340
+1502 y Fh(\017)45 b Fi(A)24 b(v)-5 b(alue)23 b(of)g(AST)p
+Ft(__)p Fi(BAD)h(will)f(b)r(e)h(returned)f(if)h(this)g(function)g(is)f
+(in)n(v)n(ok)n(ed)f(with)i(the)f(global)f(error)g(status)427
+1601 y(set,)28 b(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g(reason.)
+p 0 1803 3780 12 v 0 1934 a Fz(astRateMap)1416 1933 y
+Fe(Create)37 b(a)i(RateMap)3062 1934 y Fz(astRateMap)0
2125 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g
(RateMap)h(and)f(optionally)g(initialises)g(its)h(attributes.)227
2251 y(A)37 b(RateMap)g(is)f(a)g(Mapping)h(whic)n(h)f(represen)n(ts)g
@@ -121965,13 +122068,12 @@ b(alues)27 b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 5672 y Fi(function\).)p
eop end
-%%Page: 328 338
-TeXDict begin 328 337 bop 0 52 a FF(328)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Returned)i(V)-8
-b(alue:)259 498 y(astRateMap\(\))427 598 y Fi(A)28 b(p)r(oin)n(ter)f
-(to)h(the)g(new)g(RateMap.)0 770 y Fd(Notes:)340 1064
-y Fh(\017)45 b Fi(The)28 b(forw)n(ard)e(transformation)g(of)h(the)h
-(encapsulated)f(Mapping)g(m)n(ust)h(b)r(e)g(de\014ned.)340
+%%Page: 329 339
+TeXDict begin 329 338 bop 3643 52 a FF(329)0 351 y Fd(Returned)32
+b(V)-8 b(alue:)259 498 y(astRateMap\(\))427 598 y Fi(A)28
+b(p)r(oin)n(ter)f(to)h(the)g(new)g(RateMap.)0 770 y Fd(Notes:)340
+1064 y Fh(\017)45 b Fi(The)28 b(forw)n(ard)e(transformation)g(of)h(the)
+h(encapsulated)f(Mapping)g(m)n(ust)h(b)r(e)g(de\014ned.)340
1202 y Fh(\017)45 b Fi(Note)19 b(that)g(the)g(comp)r(onen)n(t)g
(Mappings)f(supplied)h(are)e(not)i(copied)g(b)n(y)f(astRateMap)g(\(the)
h(new)g(RateMap)427 1301 y(simply)31 b(retains)f(a)g(reference)f(to)i
@@ -122026,9 +122128,10 @@ b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)34 b(p)r(oin)n(ter)g(will)h(also)f(b)
r(e)h(returned)f(if)h(this)g(function)g(is)f(in)n(v)n(ok)n(ed)g(with)h
(the)g(AST)g(error)427 5622 y(status)28 b(set,)f(or)g(if)h(it)g(should)
g(fail)f(for)g(an)n(y)g(reason.)p eop end
-%%Page: 329 339
-TeXDict begin 329 338 bop 3643 52 a FF(329)p 0 351 3780
-12 v 0 483 a Fz(astReadFits)245 b Fe(Read)39 b(cards)f(in)m(to)f(a)i
+%%Page: 330 340
+TeXDict begin 330 339 bop 0 52 a FF(330)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 483 a Fz(astReadFits)245 b Fe(Read)39 b(cards)f(in)m(to)f(a)i
(FitsChan)f(from)f(the)1501 583 y(source)h(function)3080
483 y Fz(astReadFits)0 748 y Fd(Description:)44 b Fi(This)27
b(function)g(reads)f(cards)g(from)g(the)h(source)f(function)h(that)g(w)
@@ -122121,13 +122224,12 @@ b(jected)31 b(to)g(the)h(Mapping's)e(forw)n(ard)g(transformation)f(as)i
b(if)g(the)h(Mapping)f(in)n(v)n(olv)n(es)e(complicated)i(functions,)j
(suc)n(h)c(as)h(sky)f(pro)5 b(jections.)67 b(T)-7 b(o)38
b(impro)n(v)n(e)p eop end
-%%Page: 330 340
-TeXDict begin 330 339 bop 0 52 a FF(330)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)227 351 y Fi(p)r(erformance,)f(it)g
-(is)g(therefore)f(p)r(ossible)g(to)h(appro)n(ximate)e(non-linear)h
-(Mappings)g(b)n(y)h(a)g(set)g(of)f(linear)h(trans-)227
-451 y(formations)h(whic)n(h)h(are)f(applied)g(piece-wise)h(to)f
-(separate)g(sub-regions)f(of)h(the)i(data.)46 b(This)30
+%%Page: 331 341
+TeXDict begin 331 340 bop 3643 52 a FF(331)227 351 y
+Fi(p)r(erformance,)29 b(it)g(is)g(therefore)f(p)r(ossible)g(to)h(appro)
+n(ximate)e(non-linear)h(Mappings)g(b)n(y)h(a)g(set)g(of)f(linear)h
+(trans-)227 451 y(formations)h(whic)n(h)h(are)f(applied)g(piece-wise)h
+(to)f(separate)g(sub-regions)f(of)h(the)i(data.)46 b(This)30
b(appro)n(ximation)227 551 y(pro)r(cess)37 b(is)h(applied)g
(automatically)f(b)n(y)h(an)g(adaptiv)n(e)f(algorithm,)i(under)f(con)n
(trol)f(of)h(an)g(accuracy)e(crite-)227 650 y(rion)25
@@ -122224,13 +122326,14 @@ b(is)f(used\).)259 5593 y Fd(in)p Ft(_)p Fd(v)-5 b(ar)427
(y)e(with)i(the)h(same)e(size)h(and)g(t)n(yp)r(e)g(as)f(the)i
Ft(")p Fi(in)p Ft(")e Fi(arra)n(y)-7 b(.)34 b(If)24 b(giv)n(en,)p
eop end
-%%Page: 331 341
-TeXDict begin 331 340 bop 3643 52 a FF(331)427 351 y
-Fi(this)32 b(should)g(con)n(tain)f(a)g(set)h(of)g(non-negativ)n(e)e(v)
--5 b(alues)31 b(whic)n(h)h(represen)n(t)f(estimates)g(of)h(the)g
-(statistical)427 451 y(v)-5 b(ariance)32 b(asso)r(ciated)f(with)i(eac)n
-(h)f(elemen)n(t)g(of)h(the)g Ft(")p Fi(in)p Ft(")f Fi(arra)n(y)-7
-b(.)49 b(If)33 b(this)g(arra)n(y)d(is)i(supplied)h(\(together)427
+%%Page: 332 342
+TeXDict begin 332 341 bop 0 52 a FF(332)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)427 351 y Fi(this)i(should)g(con)n
+(tain)f(a)g(set)h(of)g(non-negativ)n(e)e(v)-5 b(alues)31
+b(whic)n(h)h(represen)n(t)f(estimates)g(of)h(the)g(statistical)427
+451 y(v)-5 b(ariance)32 b(asso)r(ciated)f(with)i(eac)n(h)f(elemen)n(t)g
+(of)h(the)g Ft(")p Fi(in)p Ft(")f Fi(arra)n(y)-7 b(.)49
+b(If)33 b(this)g(arra)n(y)d(is)i(supplied)h(\(together)427
551 y(with)23 b(the)f(corresp)r(onding)e Ft(")p Fi(out)p
Ft(_)p Fi(v)-5 b(ar)p Ft(")20 b Fi(arra)n(y\),)h(then)h(estimates)g(of)
g(the)g(v)-5 b(ariance)21 b(of)h(the)g(rebined)g(output)427
@@ -122328,55 +122431,54 @@ b(alue)32 b(is)g(used)g(to)g(test)427 5693 y(for)27 b(bad)h(pixels)f
(in)h(the)g Ft(")p Fi(in)p Ft(")f Fi(\(and)h Ft(")p Fi(in)p
Ft(_)p Fi(v)-5 b(ar)p Ft(")p Fi(\))26 b(arra)n(y\(s\).)p
eop end
-%%Page: 332 342
-TeXDict begin 332 341 bop 0 52 a FF(332)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)427 351 y Fi(In)e(all)f(cases,)f
-(this)i(v)-5 b(alue)27 b(is)g(also)f(used)h(to)g(\015ag)g(an)n(y)f
-(output)i(elemen)n(ts)f(in)h(the)g Ft(")p Fi(out)p Ft(")e
-Fi(\(and)h Ft(")p Fi(out)p Ft(_)p Fi(v)-5 b(ar)p Ft(")p
-Fi(\))427 451 y(arra)n(y\(s\))34 b(for)i(whic)n(h)g(rebined)g(v)-5
-b(alues)36 b(could)g(not)h(b)r(e)f(obtained)g(\(see)g(the)h
-Ft(")p Fi(Propagation)c(of)j(Missing)427 551 y(Data)p
-Ft(")27 b Fi(section)g(b)r(elo)n(w)h(for)f(details)g(of)h(the)g
-(circumstances)e(under)i(whic)n(h)f(this)h(ma)n(y)f(o)r(ccur\).)259
-679 y Fd(ndim)p Ft(_)p Fd(out)427 779 y Fi(The)38 b(n)n(um)n(b)r(er)f
-(of)g(dimensions)g(in)h(the)f(output)h(grid.)66 b(This)37
-b(should)g(b)r(e)h(at)f(least)g(one.)65 b(It)38 b(need)g(not)427
-879 y(necessarily)26 b(b)r(e)i(equal)f(to)h(the)g(n)n(um)n(b)r(er)f(of)
-h(dimensions)f(in)h(the)g(input)g(grid.)259 1008 y Fd(lbnd)p
-Ft(_)p Fd(out)427 1107 y Fi(P)n(oin)n(ter)d(to)i(an)f(arra)n(y)f(of)i
-(in)n(tegers,)e(with)j Ft(")p Fi(ndim)p Ft(_)p Fi(out)p
-Ft(")e Fi(elemen)n(ts,)g(con)n(taining)g(the)h(co)r(ordinates)f(of)g
-(the)427 1207 y(cen)n(tre)h(of)h(the)g(\014rst)f(pixel)h(in)g(the)g
-(output)g(grid)f(along)f(eac)n(h)h(dimension.)259 1336
-y Fd(ubnd)p Ft(_)p Fd(out)427 1435 y Fi(P)n(oin)n(ter)e(to)i(an)f(arra)
-n(y)f(of)i(in)n(tegers,)e(with)j Ft(")p Fi(ndim)p Ft(_)p
-Fi(out)p Ft(")e Fi(elemen)n(ts,)g(con)n(taining)g(the)h(co)r(ordinates)
-f(of)g(the)427 1535 y(cen)n(tre)h(of)h(the)g(last)f(pixel)h(in)g(the)g
-(output)g(grid)f(along)f(eac)n(h)h(dimension.)427 1649
-y(Note)e(that)g Ft(")p Fi(lbnd)p Ft(_)p Fi(out)p Ft(")f
-Fi(and)g Ft(")p Fi(ubnd)p Ft(_)p Fi(out)p Ft(")g Fi(together)g
-(de\014ne)h(the)g(shap)r(e,)g(size)g(and)f(co)r(ordinate)g(system)427
-1749 y(of)32 b(the)f(output)h(grid)f(in)g(the)h(same)f(w)n(a)n(y)f(as)h
-Ft(")p Fi(lbnd)p Ft(_)p Fi(in)p Ft(")f Fi(and)i Ft(")p
-Fi(ubnd)p Ft(_)p Fi(in)p Ft(")e Fi(de\014ne)i(the)g(shap)r(e,)g(size)f
-(and)427 1849 y(co)r(ordinate)c(system)g(of)h(the)g(input)g(grid.)259
-1978 y Fd(lbnd)427 2077 y Fi(P)n(oin)n(ter)h(to)i(an)f(arra)n(y)e(of)j
-(in)n(tegers,)f(with)h Ft(")p Fi(ndim)p Ft(_)p Fi(in)p
-Ft(")f Fi(elemen)n(ts,)h(con)n(taining)f(the)h(co)r(ordinates)e(of)h
-(the)427 2177 y(\014rst)d(pixel)f(in)h(the)g(region)e(of)h(the)h(input)
-h(grid)e(whic)n(h)g(is)g(to)h(b)r(e)g(included)g(in)g(the)f(rebined)h
-(output)g(arra)n(y)-7 b(.)259 2306 y Fd(ubnd)427 2405
-y Fi(P)n(oin)n(ter)29 b(to)i(an)f(arra)n(y)e(of)j(in)n(tegers,)f(with)h
-Ft(")p Fi(ndim)p Ft(_)p Fi(in)p Ft(")f Fi(elemen)n(ts,)h(con)n(taining)
-f(the)h(co)r(ordinates)e(of)h(the)427 2505 y(last)d(pixel)h(in)f(the)h
-(region)e(of)h(the)h(input)g(grid)e(whic)n(h)i(is)f(to)g(b)r(e)h
-(included)g(in)f(the)h(rebined)f(output)h(arra)n(y)-7
-b(.)427 2619 y(Note)23 b(that)h Ft(")p Fi(lbnd)p Ft(")e
-Fi(and)h Ft(")p Fi(ubnd)p Ft(")g Fi(together)f(de\014ne)h(the)h(shap)r
-(e)f(and)f(p)r(osition)h(of)g(a)g(\(h)n(yp)r(er-\)rectangular)427
-2719 y(region)c(of)i(the)f(input)h(grid)f(whic)n(h)g(is)g(to)h(b)r(e)f
-(included)h(in)g(the)f(rebined)h(output)f(arra)n(y)-7
+%%Page: 333 343
+TeXDict begin 333 342 bop 3643 52 a FF(333)427 351 y
+Fi(In)28 b(all)f(cases,)f(this)i(v)-5 b(alue)27 b(is)g(also)f(used)h
+(to)g(\015ag)g(an)n(y)f(output)i(elemen)n(ts)f(in)h(the)g
+Ft(")p Fi(out)p Ft(")e Fi(\(and)h Ft(")p Fi(out)p Ft(_)p
+Fi(v)-5 b(ar)p Ft(")p Fi(\))427 451 y(arra)n(y\(s\))34
+b(for)i(whic)n(h)g(rebined)g(v)-5 b(alues)36 b(could)g(not)h(b)r(e)f
+(obtained)g(\(see)g(the)h Ft(")p Fi(Propagation)c(of)j(Missing)427
+551 y(Data)p Ft(")27 b Fi(section)g(b)r(elo)n(w)h(for)f(details)g(of)h
+(the)g(circumstances)e(under)i(whic)n(h)f(this)h(ma)n(y)f(o)r(ccur\).)
+259 679 y Fd(ndim)p Ft(_)p Fd(out)427 779 y Fi(The)38
+b(n)n(um)n(b)r(er)f(of)g(dimensions)g(in)h(the)f(output)h(grid.)66
+b(This)37 b(should)g(b)r(e)h(at)f(least)g(one.)65 b(It)38
+b(need)g(not)427 879 y(necessarily)26 b(b)r(e)i(equal)f(to)h(the)g(n)n
+(um)n(b)r(er)f(of)h(dimensions)f(in)h(the)g(input)g(grid.)259
+1008 y Fd(lbnd)p Ft(_)p Fd(out)427 1107 y Fi(P)n(oin)n(ter)d(to)i(an)f
+(arra)n(y)f(of)i(in)n(tegers,)e(with)j Ft(")p Fi(ndim)p
+Ft(_)p Fi(out)p Ft(")e Fi(elemen)n(ts,)g(con)n(taining)g(the)h(co)r
+(ordinates)f(of)g(the)427 1207 y(cen)n(tre)h(of)h(the)g(\014rst)f
+(pixel)h(in)g(the)g(output)g(grid)f(along)f(eac)n(h)h(dimension.)259
+1336 y Fd(ubnd)p Ft(_)p Fd(out)427 1435 y Fi(P)n(oin)n(ter)e(to)i(an)f
+(arra)n(y)f(of)i(in)n(tegers,)e(with)j Ft(")p Fi(ndim)p
+Ft(_)p Fi(out)p Ft(")e Fi(elemen)n(ts,)g(con)n(taining)g(the)h(co)r
+(ordinates)f(of)g(the)427 1535 y(cen)n(tre)h(of)h(the)g(last)f(pixel)h
+(in)g(the)g(output)g(grid)f(along)f(eac)n(h)h(dimension.)427
+1649 y(Note)e(that)g Ft(")p Fi(lbnd)p Ft(_)p Fi(out)p
+Ft(")f Fi(and)g Ft(")p Fi(ubnd)p Ft(_)p Fi(out)p Ft(")g
+Fi(together)g(de\014ne)h(the)g(shap)r(e,)g(size)g(and)f(co)r(ordinate)g
+(system)427 1749 y(of)32 b(the)f(output)h(grid)f(in)g(the)h(same)f(w)n
+(a)n(y)f(as)h Ft(")p Fi(lbnd)p Ft(_)p Fi(in)p Ft(")f
+Fi(and)i Ft(")p Fi(ubnd)p Ft(_)p Fi(in)p Ft(")e Fi(de\014ne)i(the)g
+(shap)r(e,)g(size)f(and)427 1849 y(co)r(ordinate)c(system)g(of)h(the)g
+(input)g(grid.)259 1978 y Fd(lbnd)427 2077 y Fi(P)n(oin)n(ter)h(to)i
+(an)f(arra)n(y)e(of)j(in)n(tegers,)f(with)h Ft(")p Fi(ndim)p
+Ft(_)p Fi(in)p Ft(")f Fi(elemen)n(ts,)h(con)n(taining)f(the)h(co)r
+(ordinates)e(of)h(the)427 2177 y(\014rst)d(pixel)f(in)h(the)g(region)e
+(of)h(the)h(input)h(grid)e(whic)n(h)g(is)g(to)h(b)r(e)g(included)g(in)g
+(the)f(rebined)h(output)g(arra)n(y)-7 b(.)259 2306 y
+Fd(ubnd)427 2405 y Fi(P)n(oin)n(ter)29 b(to)i(an)f(arra)n(y)e(of)j(in)n
+(tegers,)f(with)h Ft(")p Fi(ndim)p Ft(_)p Fi(in)p Ft(")f
+Fi(elemen)n(ts,)h(con)n(taining)f(the)h(co)r(ordinates)e(of)h(the)427
+2505 y(last)d(pixel)h(in)f(the)h(region)e(of)h(the)h(input)g(grid)e
+(whic)n(h)i(is)f(to)g(b)r(e)h(included)g(in)f(the)h(rebined)f(output)h
+(arra)n(y)-7 b(.)427 2619 y(Note)23 b(that)h Ft(")p Fi(lbnd)p
+Ft(")e Fi(and)h Ft(")p Fi(ubnd)p Ft(")g Fi(together)f(de\014ne)h(the)h
+(shap)r(e)f(and)f(p)r(osition)h(of)g(a)g(\(h)n(yp)r(er-\)rectangular)
+427 2719 y(region)c(of)i(the)f(input)h(grid)f(whic)n(h)g(is)g(to)h(b)r
+(e)f(included)h(in)g(the)f(rebined)h(output)f(arra)n(y)-7
b(.)33 b(This)20 b(region)f(should)427 2818 y(lie)33
b(wholly)g(within)g(the)g(exten)n(t)g(of)g(the)g(input)h(grid)e(\(as)g
(de\014ned)h(b)n(y)g(the)g Ft(")p Fi(lbnd)p Ft(_)p Fi(in)p
@@ -122431,13 +122533,14 @@ Fk(>)227 5303 y Fi(of)28 b(the)g(data)f(y)n(ou)g(are)f(pro)r(cessing,)h
(as)f(follo)n(ws:)340 5435 y Fh(\017)45 b Fi(D:)28 b(double)340
5564 y Fh(\017)45 b Fi(F:)28 b(\015oat)340 5693 y Fh(\017)45
b Fi(I:)28 b(in)n(t)p eop end
-%%Page: 333 343
-TeXDict begin 333 342 bop 3643 52 a FF(333)227 351 y
-Fi(F)-7 b(or)29 b(example,)h(astRebinD)g(w)n(ould)f(b)r(e)i(used)e(to)h
-(pro)r(cess)e Ft(")p Fi(double)p Ft(")h Fi(data,)h(while)g(astRebinI)f
-(w)n(ould)h(b)r(e)g(used)227 451 y(to)e(pro)r(cess)e
-Ft(")p Fi(in)n(t)p Ft(")h Fi(data,)g(etc.)227 584 y(Note)k(that,)h
-(unlik)n(e)f(astResample)p Fk(<)p Fi(X)p Fk(>)p Fi(,)f(the)h(astRebin)p
+%%Page: 334 344
+TeXDict begin 334 343 bop 0 52 a FF(334)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)227 351 y Fi(F)-7
+b(or)29 b(example,)h(astRebinD)g(w)n(ould)f(b)r(e)i(used)e(to)h(pro)r
+(cess)e Ft(")p Fi(double)p Ft(")h Fi(data,)h(while)g(astRebinI)f(w)n
+(ould)h(b)r(e)g(used)227 451 y(to)e(pro)r(cess)e Ft(")p
+Fi(in)n(t)p Ft(")h Fi(data,)g(etc.)227 584 y(Note)k(that,)h(unlik)n(e)f
+(astResample)p Fk(<)p Fi(X)p Fk(>)p Fi(,)f(the)h(astRebin)p
Fk(<)p Fi(X)p Fk(>)f Fi(set)h(of)g(functions)g(do)r(es)g(not)f(y)n(et)h
(supp)r(ort)g(un-)227 684 y(signed)c(in)n(teger)g(data)g(t)n(yp)r(es)h
(or)e(in)n(tegers)h(of)g(di\013eren)n(t)h(sizes.)-2 851
@@ -122520,29 +122623,29 @@ Ft(")f Fi(header)g(\014le)g(and)h(ma)n(y)f(b)r(e)h(used)f(to)h(pro)n
(\015ags,)h(y)n(ou)f(should)g(supply)g(the)h(bit)n(wise)227
5585 y(OR)28 b(of)f(their)h(v)-5 b(alues)27 b(via)g(the)h
Ft(")p Fi(\015ags)p Ft(")e Fi(parameter:)p eop end
-%%Page: 334 344
-TeXDict begin 334 343 bop 0 52 a FF(334)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
-b Fi(AST)p Ft(__)p Fi(USEBAD:)33 b(Indicates)g(that)h(there)f(ma)n(y)f
-(b)r(e)i(bad)f(pixels)f(in)i(the)f(input)h(arra)n(y\(s\))d(whic)n(h)i
-(m)n(ust)427 451 y(b)r(e)27 b(recognised)f(b)n(y)g(comparing)g(with)h
-(the)g(v)-5 b(alue)27 b(giv)n(en)f(for)g Ft(")p Fi(badv)-5
-b(al)p Ft(")26 b Fi(and)g(propagated)f(to)i(the)g(output)427
-551 y(arra)n(y\(s\).)35 b(If)26 b(this)h(\015ag)e(is)h(not)g(set,)h
-(all)f(input)h(v)-5 b(alues)26 b(are)f(treated)h(literally)f(and)h(the)
-h Ft(")p Fi(badv)-5 b(al)p Ft(")25 b Fi(v)-5 b(alue)26
-b(is)427 650 y(only)h(used)h(for)f(\015agging)f(output)i(arra)n(y)d(v)
--5 b(alues.)-2 823 y Fd(Propagation)33 b(of)e(Missing)f(Data)n(:)227
-970 y Fi(Instances)40 b(of)h(missing)f(data)g(\(bad)h(pixels\))g(in)f
-(the)h(output)h(grid)e(are)f(iden)n(ti\014ed)i(b)n(y)g(o)r(ccurrences)e
-(of)h(the)227 1069 y Ft(")p Fi(badv)-5 b(al)p Ft(")22
-b Fi(v)-5 b(alue)22 b(in)h(the)f Ft(")p Fi(out)p Ft(")g
-Fi(arra)n(y)-7 b(.)33 b(These)22 b(are)g(pro)r(duced)g(if)h(the)g(sum)f
-(of)h(the)f(w)n(eigh)n(ts)g(of)g(the)h(con)n(tributing)227
-1169 y(input)29 b(pixels)e(is)h(less)f(than)g Ft(")p
-Fi(wlim)p Ft(")p Fi(.)227 1299 y(An)d(input)g(pixel)f(is)f(considered)g
-(bad)h(\(and)g(is)g(consequen)n(tly)f(ignored\))g(if)i(its)f(data)g(v)
--5 b(alue)23 b(is)f(equal)h(to)g Ft(")p Fi(badv)-5 b(al)p
+%%Page: 335 345
+TeXDict begin 335 344 bop 3643 52 a FF(335)340 351 y
+Fh(\017)45 b Fi(AST)p Ft(__)p Fi(USEBAD:)33 b(Indicates)g(that)h(there)
+f(ma)n(y)f(b)r(e)i(bad)f(pixels)f(in)i(the)f(input)h(arra)n(y\(s\))d
+(whic)n(h)i(m)n(ust)427 451 y(b)r(e)27 b(recognised)f(b)n(y)g
+(comparing)g(with)h(the)g(v)-5 b(alue)27 b(giv)n(en)f(for)g
+Ft(")p Fi(badv)-5 b(al)p Ft(")26 b Fi(and)g(propagated)f(to)i(the)g
+(output)427 551 y(arra)n(y\(s\).)35 b(If)26 b(this)h(\015ag)e(is)h(not)
+g(set,)h(all)f(input)h(v)-5 b(alues)26 b(are)f(treated)h(literally)f
+(and)h(the)h Ft(")p Fi(badv)-5 b(al)p Ft(")25 b Fi(v)-5
+b(alue)26 b(is)427 650 y(only)h(used)h(for)f(\015agging)f(output)i
+(arra)n(y)d(v)-5 b(alues.)-2 823 y Fd(Propagation)33
+b(of)e(Missing)f(Data)n(:)227 970 y Fi(Instances)40 b(of)h(missing)f
+(data)g(\(bad)h(pixels\))g(in)f(the)h(output)h(grid)e(are)f(iden)n
+(ti\014ed)i(b)n(y)g(o)r(ccurrences)e(of)h(the)227 1069
+y Ft(")p Fi(badv)-5 b(al)p Ft(")22 b Fi(v)-5 b(alue)22
+b(in)h(the)f Ft(")p Fi(out)p Ft(")g Fi(arra)n(y)-7 b(.)33
+b(These)22 b(are)g(pro)r(duced)g(if)h(the)g(sum)f(of)h(the)f(w)n(eigh)n
+(ts)g(of)g(the)h(con)n(tributing)227 1169 y(input)29
+b(pixels)e(is)h(less)f(than)g Ft(")p Fi(wlim)p Ft(")p
+Fi(.)227 1299 y(An)d(input)g(pixel)f(is)f(considered)g(bad)h(\(and)g
+(is)g(consequen)n(tly)f(ignored\))g(if)i(its)f(data)g(v)-5
+b(alue)23 b(is)f(equal)h(to)g Ft(")p Fi(badv)-5 b(al)p
Ft(")227 1399 y Fi(and)28 b(the)g(AST)p Ft(__)p Fi(USEBAD)f(\015ag)g
(is)h(set)f(via)g(the)h Ft(")p Fi(\015ags)p Ft(")e Fi(parameter.)227
1529 y(In)j(addition,)f(asso)r(ciated)f(output)i(v)-5
@@ -122633,16 +122736,17 @@ Fk(<)p Ft(Xtype)p Fk(>)f Ft(badval,)h(int)h(ndim_out,)227
5458 y(const)g(int)g(lbnd_out[],)d(const)j(int)g(ubnd_out[],)d(const)j
(int)g(lbnd[],)f(const)g(int)h(ubnd[],)f Fk(<)p Ft(Xtype)p
Fk(>)227 5558 y Ft(out[],)g Fk(<)p Ft(Xtype)p Fk(>)g
-Ft(out_var[],)e(double)j(weights[],)d(int)j Fh(\003)p
-Ft(nused)f(\);)0 5718 y Fd(P)m(arameters:)p eop end
-%%Page: 335 345
-TeXDict begin 335 344 bop 3643 52 a FF(335)259 351 y
-Fd(this)427 451 y Fi(P)n(oin)n(ter)19 b(to)h(a)f(Mapping,)j(whose)d
-(forw)n(ard)f(transformation)h(will)h(b)r(e)h(used)f(to)g(transform)f
-(the)h(co)r(ordinates)427 551 y(of)28 b(pixels)f(in)h(the)g(input)g
-(grid)f(in)n(to)h(the)g(co)r(ordinate)e(system)h(of)h(the)g(output)g
-(grid.)427 671 y(The)c(n)n(um)n(b)r(er)g(of)g(input)h(co)r(ordinates)e
-(used)h(b)n(y)g(this)g(Mapping)g(\(as)f(giv)n(en)h(b)n(y)f(its)i(Nin)f
+Ft(out_var[],)e(double)j(weights[],)d(int64_t)i Fh(\003)p
+Ft(nused)g(\);)0 5718 y Fd(P)m(arameters:)p eop end
+%%Page: 336 346
+TeXDict begin 336 345 bop 0 52 a FF(336)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(this)427
+451 y Fi(P)n(oin)n(ter)19 b(to)h(a)f(Mapping,)j(whose)d(forw)n(ard)f
+(transformation)h(will)h(b)r(e)h(used)f(to)g(transform)f(the)h(co)r
+(ordinates)427 551 y(of)28 b(pixels)f(in)h(the)g(input)g(grid)f(in)n
+(to)h(the)g(co)r(ordinate)e(system)h(of)h(the)g(output)g(grid.)427
+671 y(The)c(n)n(um)n(b)r(er)g(of)g(input)h(co)r(ordinates)e(used)h(b)n
+(y)g(this)g(Mapping)g(\(as)f(giv)n(en)h(b)n(y)f(its)i(Nin)f
(attribute\))h(should)427 771 y(matc)n(h)e(the)g(n)n(um)n(b)r(er)g(of)g
(input)h(grid)e(dimensions)h(giv)n(en)f(b)n(y)g(the)i(v)-5
b(alue)23 b(of)g Ft(")p Fi(ndim)p Ft(_)p Fi(in)p Ft(")f
@@ -122744,19 +122848,18 @@ b(alue)34 b(of)g(zero)f(is)h(supplied,)i(then)f(the)f(default)427
b(alen)n(t)22 b(to)h(supplying)f(the)h(v)-5 b(alue)22
b(AST)p Ft(__)p Fi(LINEAR\).)h(Not)g(used)427 5693 y(if)28
b Ft(")p Fi(in)p Ft(")f Fi(is)h(NULL.)p eop end
-%%Page: 336 346
-TeXDict begin 336 345 bop 0 52 a FF(336)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(params)427
-451 y Fi(An)36 b(optional)e(p)r(oin)n(ter)h(to)g(an)g(arra)n(y)e(of)i
-(double)g(whic)n(h)h(should)e(con)n(tain)h(an)n(y)f(additional)h
-(parameter)427 551 y(v)-5 b(alues)37 b(required)g(b)n(y)g(the)h(pixel)g
-(spreading)e(sc)n(heme.)66 b(If)38 b(suc)n(h)f(parameters)f(are)g
-(required,)k(this)d(will)427 650 y(b)r(e)c(noted)f(in)h(the)g
-Ft(")p Fi(Pixel)e(Spreading)h(Sc)n(hemes)p Ft(")f Fi(section)h(in)h
-(the)f(description)g(of)h(the)f(astRebin)p Fk(<)p Fi(X)p
-Fk(>)427 750 y Fi(functions.)427 862 y(If)d(no)e(additional)h
-(parameters)e(are)h(required,)g(this)i(arra)n(y)c(is)j(not)g(used)g
-(and)g(a)g(NULL)g(p)r(oin)n(ter)g(ma)n(y)f(b)r(e)427
+%%Page: 337 347
+TeXDict begin 337 346 bop 3643 52 a FF(337)259 351 y
+Fd(params)427 451 y Fi(An)36 b(optional)e(p)r(oin)n(ter)h(to)g(an)g
+(arra)n(y)e(of)i(double)g(whic)n(h)h(should)e(con)n(tain)h(an)n(y)f
+(additional)h(parameter)427 551 y(v)-5 b(alues)37 b(required)g(b)n(y)g
+(the)h(pixel)g(spreading)e(sc)n(heme.)66 b(If)38 b(suc)n(h)f
+(parameters)f(are)g(required,)k(this)d(will)427 650 y(b)r(e)c(noted)f
+(in)h(the)g Ft(")p Fi(Pixel)e(Spreading)h(Sc)n(hemes)p
+Ft(")f Fi(section)h(in)h(the)f(description)g(of)h(the)f(astRebin)p
+Fk(<)p Fi(X)p Fk(>)427 750 y Fi(functions.)427 862 y(If)d(no)e
+(additional)h(parameters)e(are)h(required,)g(this)i(arra)n(y)c(is)j
+(not)g(used)g(and)g(a)g(NULL)g(p)r(oin)n(ter)g(ma)n(y)f(b)r(e)427
962 y(giv)n(en.)36 b(Not)28 b(used)g(if)g Ft(")p Fi(in)p
Ft(")f Fi(is)g(NULL.)259 1088 y Fd(\015ags)427 1187 y
Fi(The)21 b(bit)n(wise)g(OR)f(of)h(a)f(set)h(of)f(\015ag)g(v)-5
@@ -122850,66 +122953,66 @@ Fi(out)p Ft(")e Fi(elemen)n(ts,)g(con)n(taining)g(the)h(co)r(ordinates)
f(of)g(the)427 5693 y(cen)n(tre)h(of)h(the)g(\014rst)f(pixel)h(in)g
(the)g(output)g(grid)f(along)f(eac)n(h)h(dimension.)p
eop end
-%%Page: 337 347
-TeXDict begin 337 346 bop 3643 52 a FF(337)259 351 y
-Fd(ubnd)p Ft(_)p Fd(out)427 451 y Fi(P)n(oin)n(ter)25
-b(to)i(an)f(arra)n(y)f(of)i(in)n(tegers,)e(with)j Ft(")p
-Fi(ndim)p Ft(_)p Fi(out)p Ft(")e Fi(elemen)n(ts,)g(con)n(taining)g(the)
-h(co)r(ordinates)f(of)g(the)427 551 y(cen)n(tre)h(of)h(the)g(last)f
-(pixel)h(in)g(the)g(output)g(grid)f(along)f(eac)n(h)h(dimension.)427
-664 y(Note)e(that)g Ft(")p Fi(lbnd)p Ft(_)p Fi(out)p
-Ft(")f Fi(and)g Ft(")p Fi(ubnd)p Ft(_)p Fi(out)p Ft(")g
-Fi(together)g(de\014ne)h(the)g(shap)r(e,)g(size)g(and)f(co)r(ordinate)g
-(system)427 764 y(of)32 b(the)f(output)h(grid)f(in)g(the)h(same)f(w)n
-(a)n(y)f(as)h Ft(")p Fi(lbnd)p Ft(_)p Fi(in)p Ft(")f
-Fi(and)i Ft(")p Fi(ubnd)p Ft(_)p Fi(in)p Ft(")e Fi(de\014ne)i(the)g
-(shap)r(e,)g(size)f(and)427 863 y(co)r(ordinate)c(system)g(of)h(the)g
-(input)g(grid.)259 991 y Fd(lbnd)427 1091 y Fi(P)n(oin)n(ter)h(to)i(an)
-f(arra)n(y)e(of)j(in)n(tegers,)f(with)h Ft(")p Fi(ndim)p
-Ft(_)p Fi(in)p Ft(")f Fi(elemen)n(ts,)h(con)n(taining)f(the)h(co)r
-(ordinates)e(of)h(the)427 1190 y(\014rst)d(pixel)f(in)h(the)g(region)e
-(of)h(the)h(input)h(grid)e(whic)n(h)g(is)g(to)h(b)r(e)g(included)g(in)g
-(the)f(rebined)h(output)g(arra)n(y)-7 b(.)427 1290 y(Not)28
-b(used)g(if)g Ft(")p Fi(in)p Ft(")f Fi(is)g(NULL.)259
-1418 y Fd(ubnd)427 1517 y Fi(P)n(oin)n(ter)i(to)i(an)f(arra)n(y)e(of)j
+%%Page: 338 348
+TeXDict begin 338 347 bop 0 52 a FF(338)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(ubnd)p
+Ft(_)p Fd(out)427 451 y Fi(P)n(oin)n(ter)25 b(to)i(an)f(arra)n(y)f(of)i
+(in)n(tegers,)e(with)j Ft(")p Fi(ndim)p Ft(_)p Fi(out)p
+Ft(")e Fi(elemen)n(ts,)g(con)n(taining)g(the)h(co)r(ordinates)f(of)g
+(the)427 551 y(cen)n(tre)h(of)h(the)g(last)f(pixel)h(in)g(the)g(output)
+g(grid)f(along)f(eac)n(h)h(dimension.)427 664 y(Note)e(that)g
+Ft(")p Fi(lbnd)p Ft(_)p Fi(out)p Ft(")f Fi(and)g Ft(")p
+Fi(ubnd)p Ft(_)p Fi(out)p Ft(")g Fi(together)g(de\014ne)h(the)g(shap)r
+(e,)g(size)g(and)f(co)r(ordinate)g(system)427 764 y(of)32
+b(the)f(output)h(grid)f(in)g(the)h(same)f(w)n(a)n(y)f(as)h
+Ft(")p Fi(lbnd)p Ft(_)p Fi(in)p Ft(")f Fi(and)i Ft(")p
+Fi(ubnd)p Ft(_)p Fi(in)p Ft(")e Fi(de\014ne)i(the)g(shap)r(e,)g(size)f
+(and)427 863 y(co)r(ordinate)c(system)g(of)h(the)g(input)g(grid.)259
+991 y Fd(lbnd)427 1091 y Fi(P)n(oin)n(ter)h(to)i(an)f(arra)n(y)e(of)j
(in)n(tegers,)f(with)h Ft(")p Fi(ndim)p Ft(_)p Fi(in)p
Ft(")f Fi(elemen)n(ts,)h(con)n(taining)f(the)h(co)r(ordinates)e(of)h
-(the)427 1617 y(last)d(pixel)h(in)f(the)h(region)e(of)h(the)h(input)g
-(grid)e(whic)n(h)i(is)f(to)g(b)r(e)h(included)g(in)f(the)h(rebined)f
-(output)h(arra)n(y)-7 b(.)427 1731 y(Note)23 b(that)h
-Ft(")p Fi(lbnd)p Ft(")e Fi(and)h Ft(")p Fi(ubnd)p Ft(")g
-Fi(together)f(de\014ne)h(the)h(shap)r(e)f(and)f(p)r(osition)h(of)g(a)g
-(\(h)n(yp)r(er-\)rectangular)427 1830 y(region)c(of)i(the)f(input)h
-(grid)f(whic)n(h)g(is)g(to)h(b)r(e)f(included)h(in)g(the)f(rebined)h
-(output)f(arra)n(y)-7 b(.)33 b(This)20 b(region)f(should)427
-1930 y(lie)33 b(wholly)g(within)g(the)g(exten)n(t)g(of)g(the)g(input)h
-(grid)e(\(as)g(de\014ned)h(b)n(y)g(the)g Ft(")p Fi(lbnd)p
-Ft(_)p Fi(in)p Ft(")f Fi(and)h Ft(")p Fi(ubnd)p Ft(_)p
-Fi(in)p Ft(")427 2030 y Fi(arra)n(ys\).)h(Regions)25
-b(of)g(the)h(input)h(grid)e(lying)g(outside)h(this)g(region)e(will)i
-(not)f(b)r(e)h(used.)37 b(Not)25 b(used)h(if)g Ft(")p
-Fi(in)p Ft(")427 2129 y Fi(is)i(NULL.)259 2257 y Fd(out)427
-2357 y Fi(P)n(oin)n(ter)k(to)h(an)g(arra)n(y)-7 b(,)33
-b(with)h(one)f(elemen)n(t)g(for)g(eac)n(h)f(pixel)i(in)f(the)h(output)g
-(grid.)54 b(The)33 b(rebined)g(data)427 2456 y(v)-5 b(alues)25
-b(will)h(b)r(e)g(added)f(in)n(to)h(the)g(original)e(con)n(ten)n(ts)g
-(of)i(this)g(arra)n(y)-7 b(.)34 b(The)25 b(n)n(umerical)g(t)n(yp)r(e)h
-(of)f(this)h(arra)n(y)427 2556 y(should)d(matc)n(h)g(that)g(of)g(the)g
-Ft(")p Fi(in)p Ft(")g Fi(arra)n(y)-7 b(,)22 b(and)g(the)i(data)e
-(storage)f(order)h(should)h(b)r(e)g(suc)n(h)g(that)g(the)h(index)427
-2656 y(of)31 b(the)h(\014rst)f(grid)f(dimension)h(v)-5
-b(aries)30 b(most)h(rapidly)g(and)g(that)g(of)g(the)h(\014nal)f
-(dimension)g(least)f(rapidly)427 2755 y(\(i.e.)38 b(F)-7
-b(ortran)26 b(arra)n(y)f(indexing)j(is)f(used\).)259
-2883 y Fd(out)p Ft(_)p Fd(v)-5 b(ar)427 2983 y Fi(A)27
-b(p)r(oin)n(ter)g(to)g(an)f(arra)n(y)f(with)i(the)g(same)g(t)n(yp)r(e)g
-(and)f(size)h(as)f(the)h Ft(")p Fi(out)p Ft(")f Fi(arra)n(y)-7
-b(.)35 b(This)26 b(p)r(oin)n(ter)h(will)g(only)427 3082
-y(b)r(e)22 b(used)g(if)g(the)g(AST)p Ft(__)p Fi(USEV)-9
-b(AR)22 b(or)f(AST)p Ft(__)p Fi(GENV)-9 b(AR)22 b(\015ag)f(is)g(set)h
-(in)g(whic)n(h)g(case)e(v)-5 b(ariance)21 b(estimates)427
-3182 y(for)29 b(the)g(rebined)f(data)h(v)-5 b(alues)28
-b(will)h(b)r(e)h(added)e(in)n(to)h(the)g(arra)n(y)-7
+(the)427 1190 y(\014rst)d(pixel)f(in)h(the)g(region)e(of)h(the)h(input)
+h(grid)e(whic)n(h)g(is)g(to)h(b)r(e)g(included)g(in)g(the)f(rebined)h
+(output)g(arra)n(y)-7 b(.)427 1290 y(Not)28 b(used)g(if)g
+Ft(")p Fi(in)p Ft(")f Fi(is)g(NULL.)259 1418 y Fd(ubnd)427
+1517 y Fi(P)n(oin)n(ter)i(to)i(an)f(arra)n(y)e(of)j(in)n(tegers,)f
+(with)h Ft(")p Fi(ndim)p Ft(_)p Fi(in)p Ft(")f Fi(elemen)n(ts,)h(con)n
+(taining)f(the)h(co)r(ordinates)e(of)h(the)427 1617 y(last)d(pixel)h
+(in)f(the)h(region)e(of)h(the)h(input)g(grid)e(whic)n(h)i(is)f(to)g(b)r
+(e)h(included)g(in)f(the)h(rebined)f(output)h(arra)n(y)-7
+b(.)427 1731 y(Note)23 b(that)h Ft(")p Fi(lbnd)p Ft(")e
+Fi(and)h Ft(")p Fi(ubnd)p Ft(")g Fi(together)f(de\014ne)h(the)h(shap)r
+(e)f(and)f(p)r(osition)h(of)g(a)g(\(h)n(yp)r(er-\)rectangular)427
+1830 y(region)c(of)i(the)f(input)h(grid)f(whic)n(h)g(is)g(to)h(b)r(e)f
+(included)h(in)g(the)f(rebined)h(output)f(arra)n(y)-7
+b(.)33 b(This)20 b(region)f(should)427 1930 y(lie)33
+b(wholly)g(within)g(the)g(exten)n(t)g(of)g(the)g(input)h(grid)e(\(as)g
+(de\014ned)h(b)n(y)g(the)g Ft(")p Fi(lbnd)p Ft(_)p Fi(in)p
+Ft(")f Fi(and)h Ft(")p Fi(ubnd)p Ft(_)p Fi(in)p Ft(")427
+2030 y Fi(arra)n(ys\).)h(Regions)25 b(of)g(the)h(input)h(grid)e(lying)g
+(outside)h(this)g(region)e(will)i(not)f(b)r(e)h(used.)37
+b(Not)25 b(used)h(if)g Ft(")p Fi(in)p Ft(")427 2129 y
+Fi(is)i(NULL.)259 2257 y Fd(out)427 2357 y Fi(P)n(oin)n(ter)k(to)h(an)g
+(arra)n(y)-7 b(,)33 b(with)h(one)f(elemen)n(t)g(for)g(eac)n(h)f(pixel)i
+(in)f(the)h(output)g(grid.)54 b(The)33 b(rebined)g(data)427
+2456 y(v)-5 b(alues)25 b(will)h(b)r(e)g(added)f(in)n(to)h(the)g
+(original)e(con)n(ten)n(ts)g(of)i(this)g(arra)n(y)-7
+b(.)34 b(The)25 b(n)n(umerical)g(t)n(yp)r(e)h(of)f(this)h(arra)n(y)427
+2556 y(should)d(matc)n(h)g(that)g(of)g(the)g Ft(")p Fi(in)p
+Ft(")g Fi(arra)n(y)-7 b(,)22 b(and)g(the)i(data)e(storage)f(order)h
+(should)h(b)r(e)g(suc)n(h)g(that)g(the)h(index)427 2656
+y(of)31 b(the)h(\014rst)f(grid)f(dimension)h(v)-5 b(aries)30
+b(most)h(rapidly)g(and)g(that)g(of)g(the)h(\014nal)f(dimension)g(least)
+f(rapidly)427 2755 y(\(i.e.)38 b(F)-7 b(ortran)26 b(arra)n(y)f
+(indexing)j(is)f(used\).)259 2883 y Fd(out)p Ft(_)p Fd(v)-5
+b(ar)427 2983 y Fi(A)27 b(p)r(oin)n(ter)g(to)g(an)f(arra)n(y)f(with)i
+(the)g(same)g(t)n(yp)r(e)g(and)f(size)h(as)f(the)h Ft(")p
+Fi(out)p Ft(")f Fi(arra)n(y)-7 b(.)35 b(This)26 b(p)r(oin)n(ter)h(will)
+g(only)427 3082 y(b)r(e)22 b(used)g(if)g(the)g(AST)p
+Ft(__)p Fi(USEV)-9 b(AR)22 b(or)f(AST)p Ft(__)p Fi(GENV)-9
+b(AR)22 b(\015ag)f(is)g(set)h(in)g(whic)n(h)g(case)e(v)-5
+b(ariance)21 b(estimates)427 3182 y(for)29 b(the)g(rebined)f(data)h(v)
+-5 b(alues)28 b(will)h(b)r(e)h(added)e(in)n(to)h(the)g(arra)n(y)-7
b(.)38 b(If)30 b(neither)e(the)i(AST)p Ft(__)p Fi(USEV)-9
b(AR)28 b(\015ag)427 3281 y(nor)e(the)i(AST)p Ft(__)p
Fi(GENV)-9 b(AR)26 b(\015ag)g(is)h(set,)g(no)g(output)g(v)-5
@@ -122939,90 +123042,89 @@ b(The)33 b(\014rst)f(half)h(of)f(the)h(arra)n(y)d(is)i(again)f(used)i
(grid)f(dimension)427 4405 y(v)-5 b(aries)27 b(most)g(rapidly)f(and)i
(that)f(of)h(the)f(\014nal)h(dimension)f(least)g(rapidly)f(\(i.e.)38
b(F)-7 b(ortran)26 b(arra)n(y)f(indexing)427 4505 y(is)j(used\).)259
-4633 y Fd(n)m(used)427 4732 y Fi(A)33 b(p)r(oin)n(ter)f(to)h(an)f(in)n
-(t)h(con)n(taining)e(the)i(n)n(um)n(b)r(er)f(of)h(input)g(data)f(v)-5
-b(alues)32 b(that)h(ha)n(v)n(e)f(b)r(een)g(added)h(in)n(to)427
-4832 y(the)f(output)g(arra)n(y)d(so)h(far.)47 b(The)32
-b(supplied)f(v)-5 b(alue)31 b(is)h(incremen)n(ted)f(on)g(exit)g(b)n(y)g
-(the)h(n)n(um)n(b)r(er)f(of)g(input)427 4932 y(v)-5 b(alues)26
-b(used.)36 b(The)26 b(v)-5 b(alue)26 b(is)f(initially)h(set)g(to)g
-(zero)f(if)h(the)g(AST)p Ft(__)p Fi(REBININIT)f(\015ag)g(is)h(set)g(in)
-g Ft(")p Fi(\015ags)p Ft(")p Fi(.)-2 5089 y Fd(Data)33
-b(T)m(yp)s(e)g(Co)s(des)n(:)227 5235 y Fi(T)-7 b(o)39
-b(select)g(the)h(appropriate)e(rebinning)h(function,)k(y)n(ou)38
-b(should)h(replace)g Fk(<)p Fi(X)p Fk(>)f Fi(in)i(the)g(generic)e
-(function)227 5334 y(name)24 b(astRebinSeq)p Fk(<)p Fi(X)p
-Fk(>)g Fi(with)g(a)g(1-)g(or)f(2-c)n(haracter)e(data)j(t)n(yp)r(e)g(co)
-r(de,)h(so)f(as)f(to)h(matc)n(h)g(the)h(n)n(umerical)e(t)n(yp)r(e)227
-5434 y Fk(<)p Fi(Xt)n(yp)r(e)p Fk(>)k Fi(of)h(the)g(data)f(y)n(ou)g
-(are)g(pro)r(cessing,)f(as)h(follo)n(ws:)340 5565 y Fh(\017)45
-b Fi(D:)28 b(double)340 5693 y Fh(\017)45 b Fi(F:)28
-b(\015oat)p eop end
-%%Page: 338 348
-TeXDict begin 338 347 bop 0 52 a FF(338)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
-b Fi(I:)28 b(in)n(t)227 536 y(F)-7 b(or)25 b(example,)g(astRebinSeqD)g
-(w)n(ould)f(b)r(e)i(used)e(to)h(pro)r(cess)f Ft(")p Fi(double)p
-Ft(")g Fi(data,)h(while)g(astRebinSeqI)g(w)n(ould)f(b)r(e)227
-636 y(used)k(to)f(pro)r(cess)g Ft(")p Fi(in)n(t)p Ft(")g
-Fi(data,)g(etc.)227 772 y(Note)33 b(that,)h(unlik)n(e)f(astResample)p
-Fk(<)p Fi(X)p Fk(>)p Fi(,)g(the)g(astRebinSeq)p Fk(<)p
-Fi(X)p Fk(>)f Fi(set)g(of)h(functions)g(do)r(es)g(not)f(y)n(et)h(supp)r
-(ort)227 871 y(unsigned)28 b(in)n(teger)e(data)h(t)n(yp)r(es)h(or)f(in)
-n(tegers)f(of)i(di\013eren)n(t)f(sizes.)-2 1043 y Fd(Con)m(trol)32
-b(Flags)n(:)227 1190 y Fi(The)h(follo)n(wing)e(\015ags)h(are)g
-(de\014ned)h(in)f(the)h Ft(")p Fi(ast.h)p Ft(")f Fi(header)g(\014le)g
-(and)h(ma)n(y)f(b)r(e)h(used)f(to)h(pro)n(vide)e(additional)227
-1289 y(con)n(trol)g(o)n(v)n(er)g(the)i(rebinning)e(pro)r(cess.)50
-b(Ha)n(ving)32 b(selected)g(a)g(set)g(of)g(\015ags,)h(y)n(ou)f(should)g
-(supply)g(the)h(bit)n(wise)227 1389 y(OR)28 b(of)f(their)h(v)-5
-b(alues)27 b(via)g(the)h Ft(")p Fi(\015ags)p Ft(")e Fi(parameter:)340
-1684 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(REBININIT:)28
-b(Used)g(to)f(mark)g(the)i(\014rst)e(call)h(in)g(a)g(sequence.)37
-b(It)28 b(indicates)g(that)g(the)g(supplied)427 1784
-y Ft(")p Fi(out)p Ft(")p Fi(,)40 b Ft(")p Fi(out)p Ft(_)p
-Fi(v)-5 b(ar)p Ft(")35 b Fi(and)j Ft(")p Fi(w)n(eigh)n(ts)p
-Ft(")e Fi(arra)n(ys)f(should)i(b)r(e)i(\014lled)f(with)g(zeros)e(\(th)n
-(us)i(o)n(v)n(er-writing)d(an)n(y)427 1883 y(supplied)30
-b(v)-5 b(alues\))30 b(b)r(efore)f(adding)g(the)h(rebinned)f(input)i
-(data)e(in)n(to)g(them.)43 b(This)30 b(\015ag)e(should)i(b)r(e)g(used)
-427 1983 y(when)e(rebinning)f(the)h(\014rst)g(input)g(arra)n(y)d(in)j
-(a)f(sequence.)340 2127 y Fh(\017)45 b Fi(AST)p Ft(__)p
-Fi(REBINEND:)34 b(Used)h(to)g(mark)f(the)h(last)f(call)g(in)h(a)g
-(sequence.)57 b(It)35 b(causes)f(eac)n(h)g(v)-5 b(alue)34
-b(in)h(the)427 2227 y Ft(")p Fi(out)p Ft(")c Fi(and)h
-Ft(")p Fi(out)p Ft(_)p Fi(v)-5 b(ar)p Ft(")30 b Fi(arra)n(ys)g(to)i(b)r
-(e)g(divided)g(b)n(y)g(a)g(normalisation)e(factor)h(b)r(efore)h(b)r
-(eing)g(returned.)427 2326 y(The)27 b(normalisation)d(factor)i(for)g
-(eac)n(h)f(output)i(data)f(v)-5 b(alue)26 b(is)g(just)h(the)g(corresp)r
-(onding)d(v)-5 b(alue)26 b(from)g(the)427 2426 y(w)n(eigh)n(ts)31
-b(arra)n(y)-7 b(.)46 b(The)31 b(normalisation)f(factor)g(for)h(eac)n(h)
-g(output)g(v)-5 b(ariance)31 b(v)-5 b(alue)31 b(is)g(the)h(square)e(of)
-h(the)427 2526 y(data)k(v)-5 b(alue)34 b(normalisation)f(factor)h
-(\(see)h(also)e(AST)p Ft(__)p Fi(CONSER)-9 b(VEFLUX\).)35
-b(It)g(also)e(causes)h(output)427 2625 y(data)39 b(v)-5
-b(alues)38 b(to)h(b)r(e)g(set)g(bad)f(if)i(the)f(corresp)r(onding)e(w)n
-(eigh)n(t)h(is)h(less)f(than)h(the)g(v)-5 b(alue)39 b(supplied)g(for)
-427 2725 y(parameter)29 b Ft(")p Fi(wlim)p Ft(")p Fi(.)43
-b(It)30 b(also)f(causes)g(an)n(y)g(temp)r(orary)g(v)-5
-b(alues)29 b(stored)g(in)i(the)f(output)g(v)-5 b(ariance)29
-b(arra)n(y)427 2825 y(\(see)e(\015ag)e(AST)p Ft(__)p
-Fi(GENV)-9 b(AR)26 b(b)r(elo)n(w\))h(to)f(b)r(e)h(con)n(v)n(erted)e(in)
-n(to)h(usable)g(v)-5 b(ariance)25 b(v)-5 b(alues.)36
-b(Note,)27 b(this)f(\015ag)427 2924 y(is)i(ignored)e(if)i(the)g(AST)p
-Ft(__)p Fi(NONORM)f(\015ag)g(is)h(set.)340 3068 y Fh(\017)45
-b Fi(AST)p Ft(__)p Fi(USEBAD:)33 b(Indicates)g(that)h(there)f(ma)n(y)f
-(b)r(e)i(bad)f(pixels)f(in)i(the)f(input)h(arra)n(y\(s\))d(whic)n(h)i
-(m)n(ust)427 3168 y(b)r(e)27 b(recognised)f(b)n(y)g(comparing)g(with)h
-(the)g(v)-5 b(alue)27 b(giv)n(en)f(for)g Ft(")p Fi(badv)-5
-b(al)p Ft(")26 b Fi(and)g(propagated)f(to)i(the)g(output)427
-3268 y(arra)n(y\(s\).)35 b(If)26 b(this)h(\015ag)e(is)h(not)g(set,)h
-(all)f(input)h(v)-5 b(alues)26 b(are)f(treated)h(literally)f(and)h(the)
-h Ft(")p Fi(badv)-5 b(al)p Ft(")25 b Fi(v)-5 b(alue)26
-b(is)427 3367 y(only)h(used)h(for)f(\015agging)f(output)i(arra)n(y)d(v)
--5 b(alues.)340 3512 y Fh(\017)45 b Fi(AST)p Ft(__)p
-Fi(USEV)-9 b(AR:)36 b(Indicates)g(that)g(output)h(v)-5
-b(ariance)35 b(estimates)h(should)f(b)r(e)i(created)e(b)n(y)h
+4633 y Fd(n)m(used)427 4732 y Fi(A)23 b(p)r(oin)n(ter)f(to)h(an)f(in)n
+(t64)p Ft(_)p Fi(t)g(con)n(taining)f(the)i(n)n(um)n(b)r(er)g(of)f
+(input)i(data)e(v)-5 b(alues)22 b(that)h(ha)n(v)n(e)e(b)r(een)i(added)g
+(in)n(to)427 4832 y(the)32 b(output)g(arra)n(y)d(so)h(far.)47
+b(The)32 b(supplied)f(v)-5 b(alue)31 b(is)h(incremen)n(ted)f(on)g(exit)
+g(b)n(y)g(the)h(n)n(um)n(b)r(er)f(of)g(input)427 4932
+y(v)-5 b(alues)26 b(used.)36 b(The)26 b(v)-5 b(alue)26
+b(is)f(initially)h(set)g(to)g(zero)f(if)h(the)g(AST)p
+Ft(__)p Fi(REBININIT)f(\015ag)g(is)h(set)g(in)g Ft(")p
+Fi(\015ags)p Ft(")p Fi(.)-2 5089 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s(des)n
+(:)227 5235 y Fi(T)-7 b(o)39 b(select)g(the)h(appropriate)e(rebinning)h
+(function,)k(y)n(ou)38 b(should)h(replace)g Fk(<)p Fi(X)p
+Fk(>)f Fi(in)i(the)g(generic)e(function)227 5334 y(name)24
+b(astRebinSeq)p Fk(<)p Fi(X)p Fk(>)g Fi(with)g(a)g(1-)g(or)f(2-c)n
+(haracter)e(data)j(t)n(yp)r(e)g(co)r(de,)h(so)f(as)f(to)h(matc)n(h)g
+(the)h(n)n(umerical)e(t)n(yp)r(e)227 5434 y Fk(<)p Fi(Xt)n(yp)r(e)p
+Fk(>)k Fi(of)h(the)g(data)f(y)n(ou)g(are)g(pro)r(cessing,)f(as)h(follo)
+n(ws:)340 5565 y Fh(\017)45 b Fi(D:)28 b(double)340 5693
+y Fh(\017)45 b Fi(F:)28 b(\015oat)p eop end
+%%Page: 339 349
+TeXDict begin 339 348 bop 3643 52 a FF(339)340 351 y
+Fh(\017)45 b Fi(I:)28 b(in)n(t)227 536 y(F)-7 b(or)25
+b(example,)g(astRebinSeqD)g(w)n(ould)f(b)r(e)i(used)e(to)h(pro)r(cess)f
+Ft(")p Fi(double)p Ft(")g Fi(data,)h(while)g(astRebinSeqI)g(w)n(ould)f
+(b)r(e)227 636 y(used)k(to)f(pro)r(cess)g Ft(")p Fi(in)n(t)p
+Ft(")g Fi(data,)g(etc.)227 772 y(Note)33 b(that,)h(unlik)n(e)f
+(astResample)p Fk(<)p Fi(X)p Fk(>)p Fi(,)g(the)g(astRebinSeq)p
+Fk(<)p Fi(X)p Fk(>)f Fi(set)g(of)h(functions)g(do)r(es)g(not)f(y)n(et)h
+(supp)r(ort)227 871 y(unsigned)28 b(in)n(teger)e(data)h(t)n(yp)r(es)h
+(or)f(in)n(tegers)f(of)i(di\013eren)n(t)f(sizes.)-2 1043
+y Fd(Con)m(trol)32 b(Flags)n(:)227 1190 y Fi(The)h(follo)n(wing)e
+(\015ags)h(are)g(de\014ned)h(in)f(the)h Ft(")p Fi(ast.h)p
+Ft(")f Fi(header)g(\014le)g(and)h(ma)n(y)f(b)r(e)h(used)f(to)h(pro)n
+(vide)e(additional)227 1289 y(con)n(trol)g(o)n(v)n(er)g(the)i
+(rebinning)e(pro)r(cess.)50 b(Ha)n(ving)32 b(selected)g(a)g(set)g(of)g
+(\015ags,)h(y)n(ou)f(should)g(supply)g(the)h(bit)n(wise)227
+1389 y(OR)28 b(of)f(their)h(v)-5 b(alues)27 b(via)g(the)h
+Ft(")p Fi(\015ags)p Ft(")e Fi(parameter:)340 1684 y Fh(\017)45
+b Fi(AST)p Ft(__)p Fi(REBININIT:)28 b(Used)g(to)f(mark)g(the)i(\014rst)
+e(call)h(in)g(a)g(sequence.)37 b(It)28 b(indicates)g(that)g(the)g
+(supplied)427 1784 y Ft(")p Fi(out)p Ft(")p Fi(,)40 b
+Ft(")p Fi(out)p Ft(_)p Fi(v)-5 b(ar)p Ft(")35 b Fi(and)j
+Ft(")p Fi(w)n(eigh)n(ts)p Ft(")e Fi(arra)n(ys)f(should)i(b)r(e)i
+(\014lled)f(with)g(zeros)e(\(th)n(us)i(o)n(v)n(er-writing)d(an)n(y)427
+1883 y(supplied)30 b(v)-5 b(alues\))30 b(b)r(efore)f(adding)g(the)h
+(rebinned)f(input)i(data)e(in)n(to)g(them.)43 b(This)30
+b(\015ag)e(should)i(b)r(e)g(used)427 1983 y(when)e(rebinning)f(the)h
+(\014rst)g(input)g(arra)n(y)d(in)j(a)f(sequence.)340
+2127 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(REBINEND:)34
+b(Used)h(to)g(mark)f(the)h(last)f(call)g(in)h(a)g(sequence.)57
+b(It)35 b(causes)f(eac)n(h)g(v)-5 b(alue)34 b(in)h(the)427
+2227 y Ft(")p Fi(out)p Ft(")c Fi(and)h Ft(")p Fi(out)p
+Ft(_)p Fi(v)-5 b(ar)p Ft(")30 b Fi(arra)n(ys)g(to)i(b)r(e)g(divided)g
+(b)n(y)g(a)g(normalisation)e(factor)h(b)r(efore)h(b)r(eing)g(returned.)
+427 2326 y(The)27 b(normalisation)d(factor)i(for)g(eac)n(h)f(output)i
+(data)f(v)-5 b(alue)26 b(is)g(just)h(the)g(corresp)r(onding)d(v)-5
+b(alue)26 b(from)g(the)427 2426 y(w)n(eigh)n(ts)31 b(arra)n(y)-7
+b(.)46 b(The)31 b(normalisation)f(factor)g(for)h(eac)n(h)g(output)g(v)
+-5 b(ariance)31 b(v)-5 b(alue)31 b(is)g(the)h(square)e(of)h(the)427
+2526 y(data)k(v)-5 b(alue)34 b(normalisation)f(factor)h(\(see)h(also)e
+(AST)p Ft(__)p Fi(CONSER)-9 b(VEFLUX\).)35 b(It)g(also)e(causes)h
+(output)427 2625 y(data)39 b(v)-5 b(alues)38 b(to)h(b)r(e)g(set)g(bad)f
+(if)i(the)f(corresp)r(onding)e(w)n(eigh)n(t)h(is)h(less)f(than)h(the)g
+(v)-5 b(alue)39 b(supplied)g(for)427 2725 y(parameter)29
+b Ft(")p Fi(wlim)p Ft(")p Fi(.)43 b(It)30 b(also)f(causes)g(an)n(y)g
+(temp)r(orary)g(v)-5 b(alues)29 b(stored)g(in)i(the)f(output)g(v)-5
+b(ariance)29 b(arra)n(y)427 2825 y(\(see)e(\015ag)e(AST)p
+Ft(__)p Fi(GENV)-9 b(AR)26 b(b)r(elo)n(w\))h(to)f(b)r(e)h(con)n(v)n
+(erted)e(in)n(to)h(usable)g(v)-5 b(ariance)25 b(v)-5
+b(alues.)36 b(Note,)27 b(this)f(\015ag)427 2924 y(is)i(ignored)e(if)i
+(the)g(AST)p Ft(__)p Fi(NONORM)f(\015ag)g(is)h(set.)340
+3068 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(USEBAD:)33 b(Indicates)g(that)h
+(there)f(ma)n(y)f(b)r(e)i(bad)f(pixels)f(in)i(the)f(input)h(arra)n
+(y\(s\))d(whic)n(h)i(m)n(ust)427 3168 y(b)r(e)27 b(recognised)f(b)n(y)g
+(comparing)g(with)h(the)g(v)-5 b(alue)27 b(giv)n(en)f(for)g
+Ft(")p Fi(badv)-5 b(al)p Ft(")26 b Fi(and)g(propagated)f(to)i(the)g
+(output)427 3268 y(arra)n(y\(s\).)35 b(If)26 b(this)h(\015ag)e(is)h
+(not)g(set,)h(all)f(input)h(v)-5 b(alues)26 b(are)f(treated)h
+(literally)f(and)h(the)h Ft(")p Fi(badv)-5 b(al)p Ft(")25
+b Fi(v)-5 b(alue)26 b(is)427 3367 y(only)h(used)h(for)f(\015agging)f
+(output)i(arra)n(y)d(v)-5 b(alues.)340 3512 y Fh(\017)45
+b Fi(AST)p Ft(__)p Fi(USEV)-9 b(AR:)36 b(Indicates)g(that)g(output)h(v)
+-5 b(ariance)35 b(estimates)h(should)f(b)r(e)i(created)e(b)n(y)h
(rebinning)427 3611 y(the)g(supplied)f(input)h(v)-5 b(ariance)33
b(estimates.)59 b(An)35 b(error)e(will)j(b)r(e)f(rep)r(orted)f(if)i(b)r
(oth)f(this)g(\015ag)f(and)h(the)427 3711 y(AST)p Ft(__)p
@@ -123074,17 +123176,18 @@ Ft(__)p Fi(DISV)-9 b(AR)427 5593 y(will)29 b(b)r(e)h(larger)d(than)i
b(AR)30 b(b)n(y)e(a)h(factor)f(equal)g(to)h(the)g(n)n(um)n(b)r(er)g(of)
427 5693 y(input)g(samples)e(that)g(con)n(tribute)h(to)f(the)h(output)g
(sample.)p eop end
-%%Page: 339 349
-TeXDict begin 339 348 bop 3643 52 a FF(339)340 351 y
-Fh(\017)45 b Fi(AST)p Ft(__)p Fi(V)-9 b(AR)g(W)n(GT:)29
-b(Indicates)f(that)h(the)g(input)g(data)f(should)h(b)r(e)g(w)n(eigh)n
-(ted)f(b)n(y)g(the)h(recipro)r(cal)e(of)h(the)427 451
-y(input)e(v)-5 b(ariances.)35 b(Otherwise,)25 b(all)g(input)h(data)f
-(are)g(giv)n(en)f(equal)h(w)n(eigh)n(t.)36 b(If)25 b(this)h(\015ag)f
-(is)g(sp)r(eci\014ed,)h(the)427 551 y(calculation)e(of)h(the)g(output)g
-(v)-5 b(ariances)23 b(\(if)i(an)n(y\))g(is)f(mo)r(di\014ed)h(to)g(tak)n
-(e)f(accoun)n(t)f(of)i(the)g(v)-5 b(arying)24 b(w)n(eigh)n(ts)427
-650 y(assigned)j(to)g(the)h(input)h(data)e(v)-5 b(alues.)340
+%%Page: 340 350
+TeXDict begin 340 349 bop 0 52 a FF(340)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Fi(AST)p Ft(__)p Fi(V)-9 b(AR)g(W)n(GT:)29 b(Indicates)f(that)h(the)g
+(input)g(data)f(should)h(b)r(e)g(w)n(eigh)n(ted)f(b)n(y)g(the)h
+(recipro)r(cal)e(of)h(the)427 451 y(input)e(v)-5 b(ariances.)35
+b(Otherwise,)25 b(all)g(input)h(data)f(are)g(giv)n(en)f(equal)h(w)n
+(eigh)n(t.)36 b(If)25 b(this)h(\015ag)f(is)g(sp)r(eci\014ed,)h(the)427
+551 y(calculation)e(of)h(the)g(output)g(v)-5 b(ariances)23
+b(\(if)i(an)n(y\))g(is)f(mo)r(di\014ed)h(to)g(tak)n(e)f(accoun)n(t)f
+(of)i(the)g(v)-5 b(arying)24 b(w)n(eigh)n(ts)427 650
+y(assigned)j(to)g(the)h(input)h(data)e(v)-5 b(alues.)340
778 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(NONORM:)19 b(If)h(the)f(simple)g
(unnormalised)g(sum)g(of)g(all)g(input)h(data)e(falling)h(in)h(eac)n(h)
e(output)i(pixel)427 878 y(is)f(required,)g(then)g(this)g(\015ag)f
@@ -123186,1251 +123289,1254 @@ y(transformation,)26 b(and)i(this)g(should)f(b)r(e)h(comm)n(unicated)f
(function.)0 5693 y Fd(Synopsis:)121 b Ft(void)42 b(astRemapFrame\()c
(AstFrameSet)h Fh(\003)p Ft(this,)i(int)h(iframe,)f(AstMapping)e
Fh(\003)p Ft(map)j(\))p eop end
-%%Page: 340 350
-TeXDict begin 340 349 bop 0 52 a FF(340)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(P)m(arameters:)259
-490 y(this)427 590 y Fi(P)n(oin)n(ter)c(to)i(the)g(F)-7
-b(rameSet.)259 724 y Fd(iframe)427 823 y Fi(The)34 b(index)h(within)g
+%%Page: 341 351
+TeXDict begin 341 350 bop 3643 52 a FF(341)0 351 y Fd(P)m(arameters:)
+259 493 y(this)427 593 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rameSet.)259 729 y Fd(iframe)427 828 y Fi(The)34 b(index)h(within)g
(the)f(F)-7 b(rameSet)34 b(of)g(the)h(F)-7 b(rame)33
b(to)h(b)r(e)h(mo)r(di\014ed.)57 b(This)34 b(v)-5 b(alue)34
-b(should)g(lie)g(in)g(the)427 923 y(range)27 b(from)g(1)g(to)g(the)h(n)
+b(should)g(lie)g(in)g(the)427 928 y(range)27 b(from)g(1)g(to)g(the)h(n)
n(um)n(b)r(er)g(of)f(F)-7 b(rames)27 b(in)h(the)g(F)-7
b(rameSet)27 b(\(as)h(giv)n(en)e(b)n(y)i(its)f(Nframe)h(attribute\).)
-259 1057 y Fd(map)427 1157 y Fi(P)n(oin)n(ter)38 b(to)i(a)f(Mapping)g
+259 1063 y Fd(map)427 1163 y Fi(P)n(oin)n(ter)38 b(to)i(a)f(Mapping)g
(whose)g(forw)n(ard)f(transformation)g(con)n(v)n(erts)g(co)r(ordinate)h
-(v)-5 b(alues)39 b(from)g(the)427 1256 y(original)27
+(v)-5 b(alues)39 b(from)g(the)427 1263 y(original)27
b(co)r(ordinate)f(system)i(describ)r(ed)f(b)n(y)h(the)g(F)-7
b(rame)27 b(to)h(the)g(new)g(one,)g(and)f(whose)g(in)n(v)n(erse)g
-(trans-)427 1356 y(formation)g(con)n(v)n(erts)f(in)i(the)g(opp)r(osite)
-f(direction.)0 1520 y Fd(Notes:)340 1805 y Fh(\017)45
+(trans-)427 1362 y(formation)g(con)n(v)n(erts)f(in)i(the)g(opp)r(osite)
+f(direction.)0 1530 y Fd(Notes:)340 1818 y Fh(\017)45
b Fi(A)32 b(v)-5 b(alue)30 b(of)h(AST)p Ft(__)p Fi(BASE)g(or)f(AST)p
Ft(__)p Fi(CURRENT)h(ma)n(y)f(b)r(e)h(giv)n(en)g(for)f(the)h
-Ft(")p Fi(iframe)p Ft(")f Fi(parameter)g(to)427 1905
+Ft(")p Fi(iframe)p Ft(")f Fi(parameter)g(to)427 1917
y(sp)r(ecify)e(the)g(base)f(F)-7 b(rame)27 b(or)g(the)h(curren)n(t)f(F)
--7 b(rame)27 b(resp)r(ectiv)n(ely)-7 b(.)340 2039 y Fh(\017)45
+-7 b(rame)27 b(resp)r(ectiv)n(ely)-7 b(.)340 2053 y Fh(\017)45
b Fi(The)29 b(relationship)e(b)r(et)n(w)n(een)h(the)h(selected)f(F)-7
b(rame)28 b(and)g(an)n(y)g(other)g(F)-7 b(rame)28 b(within)h(the)f(F)-7
-b(rameSet)28 b(will)427 2138 y(b)r(e)h(mo)r(di\014ed)f(b)n(y)f(this)i
+b(rameSet)28 b(will)427 2153 y(b)r(e)h(mo)r(di\014ed)f(b)n(y)f(this)i
(function,)f(but)h(the)f(relationship)f(b)r(et)n(w)n(een)h(all)f(other)
-g(F)-7 b(rames)27 b(in)i(the)f(F)-7 b(rameSet)427 2238
-y(remains)27 b(unc)n(hanged.)340 2372 y Fh(\017)45 b
+g(F)-7 b(rames)27 b(in)i(the)f(F)-7 b(rameSet)427 2252
+y(remains)27 b(unc)n(hanged.)340 2388 y Fh(\017)45 b
Fi(The)27 b(n)n(um)n(b)r(er)g(of)g(input)h(co)r(ordinate)e(v)-5
b(alues)27 b(accepted)g(b)n(y)f(the)i(Mapping)f(\(its)g(Nin)h
-(attribute\))f(and)g(the)427 2472 y(n)n(um)n(b)r(er)j(of)g(output)g(co)
+(attribute\))f(and)g(the)427 2488 y(n)n(um)n(b)r(er)j(of)g(output)g(co)
r(ordinate)f(v)-5 b(alues)30 b(generated)f(\(its)h(Nout)g(attribute\))h
-(m)n(ust)f(b)r(e)g(equal)g(and)f(m)n(ust)427 2571 y(matc)n(h)f(the)g(n)
+(m)n(ust)f(b)r(e)g(equal)g(and)f(m)n(ust)427 2587 y(matc)n(h)f(the)g(n)
n(um)n(b)r(er)f(of)h(axes)e(in)i(the)g(F)-7 b(rame)27
-b(b)r(eing)h(mo)r(di\014ed.)340 2705 y Fh(\017)45 b Fi(If)33
+b(b)r(eing)h(mo)r(di\014ed.)340 2723 y Fh(\017)45 b Fi(If)33
b(a)g(simple)f(c)n(hange)g(of)h(axis)e(order)h(is)g(required,)h(then)g
(the)h(astP)n(ermAxes)c(function)k(ma)n(y)e(pro)n(vide)f(a)427
-2805 y(more)c(straigh)n(tforw)n(ard)e(metho)r(d)j(of)f(making)g(the)h
+2822 y(more)c(straigh)n(tforw)n(ard)e(metho)r(d)j(of)f(making)g(the)h
(required)f(c)n(hanges)f(to)h(the)h(F)-7 b(rameSet.)340
-2939 y Fh(\017)45 b Fi(This)32 b(function)g(cannot)f(b)r(e)g(used)h(to)
+2958 y Fh(\017)45 b Fi(This)32 b(function)g(cannot)f(b)r(e)g(used)h(to)
f(c)n(hange)f(the)i(n)n(um)n(b)r(er)f(of)h(F)-7 b(rame)30
b(axes.)48 b(T)-7 b(o)31 b(ac)n(hiev)n(e)f(this,)j(a)e(new)427
-3039 y(F)-7 b(rame)29 b(m)n(ust)h(b)r(e)g(added)g(to)f(the)h(F)-7
+3058 y(F)-7 b(rame)29 b(m)n(ust)h(b)r(e)g(added)g(to)f(the)h(F)-7
b(rameSet)29 b(\(astAddF)-7 b(rame\))30 b(and)g(the)g(original)e(one)h
-(remo)n(v)n(ed)f(if)i(nec-)427 3138 y(essary)c(\(astRemo)n(v)n(eF)-7
-b(rame\).)p 0 3340 3780 12 v 0 3472 a Fz(astRemo)l(v)l(eColumn)155
-b Fe(Remo)m(v)m(e)36 b(a)h(column)f(from)f(a)1763 3571
-y(table)2680 3472 y Fz(astRemo)l(v)l(eColumn)0 3739 y
-Fd(Description:)44 b Fi(This)31 b(function)g(remo)n(v)n(es)d(a)i(sp)r
-(eci\014ed)h(column)f(from)g(the)h(supplied)g(table.)45
-b(The)30 b(function)h(returns)227 3839 y(without)d(action)f(if)h(the)g
-(named)g(column)g(do)r(es)f(not)g(exist)h(in)g(the)g(T)-7
-b(able)27 b(\(no)h(error)d(is)j(rep)r(orted\).)0 3991
-y Fd(Synopsis:)121 b Ft(void)42 b(astRemoveColumn\()37
+(remo)n(v)n(ed)f(if)i(nec-)427 3157 y(essary)c(\(astRemo)n(v)n(eF)-7
+b(rame\).)340 3293 y Fh(\017)45 b Fi(An)n(y)28 b(v)-5
+b(arian)n(t)28 b(Mappings)f(asso)r(ciated)g(with)h(the)h(remapp)r(ed)f
+(F)-7 b(rame)28 b(\(except)g(for)g(the)g(curren)n(t)f(v)-5
+b(arian)n(t\))427 3393 y(will)28 b(b)r(e)g(lost)f(as)g(a)g(consequence)
+g(of)h(calling)f(this)g(metho)r(d)i(\(see)e(attribute)h
+Ft(")p Fi(V)-7 b(arian)n(t)p Ft(")p Fi(\).)p 0 3597 3780
+12 v 0 3729 a Fz(astRemo)l(v)l(eColumn)155 b Fe(Remo)m(v)m(e)36
+b(a)h(column)f(from)f(a)1763 3829 y(table)2680 3729 y
+Fz(astRemo)l(v)l(eColumn)0 4000 y Fd(Description:)44
+b Fi(This)31 b(function)g(remo)n(v)n(es)d(a)i(sp)r(eci\014ed)h(column)f
+(from)g(the)h(supplied)g(table.)45 b(The)30 b(function)h(returns)227
+4100 y(without)d(action)f(if)h(the)g(named)g(column)g(do)r(es)f(not)g
+(exist)h(in)g(the)g(T)-7 b(able)27 b(\(no)h(error)d(is)j(rep)r
+(orted\).)0 4255 y Fd(Synopsis:)121 b Ft(void)42 b(astRemoveColumn\()37
b(AstTable)j Fh(\003)p Ft(this,)h(const)h(char)g Fh(\003)p
-Ft(name)f(\))0 4143 y Fd(P)m(arameters:)259 4281 y(this)427
-4381 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(T)-7 b(able.)259
-4515 y Fd(name)427 4615 y Fi(The)38 b(column)f(name.)66
+Ft(name)f(\))0 4410 y Fd(P)m(arameters:)259 4552 y(this)427
+4651 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(T)-7 b(able.)259
+4787 y Fd(name)427 4886 y Fi(The)38 b(column)f(name.)66
b(T)-7 b(railing)36 b(spaces)g(are)h(ignored)f(\(all)h(other)g(spaces)f
-(are)h(signi\014can)n(t\).)65 b(Case)37 b(is)427 4714
-y(signi\014can)n(t.)p 0 4916 V 0 5047 a Fz(astRemo)l(v)l(eF)-11
-b(rame)1274 5048 y Fe(Remo)m(v)m(e)37 b(a)i(F)-10 b(rame)38
-b(from)f(a)1648 5147 y(F)-10 b(rameSet)2776 5047 y Fz(astRemo)l(v)l(eF)
-f(rame)0 5315 y Fd(Description:)44 b Fi(This)27 b(function)g(remo)n(v)n
+(are)h(signi\014can)n(t\).)65 b(Case)37 b(is)427 4986
+y(signi\014can)n(t.)p 0 5191 V 0 5322 a Fz(astRemo)l(v)l(eF)-11
+b(rame)1274 5323 y Fe(Remo)m(v)m(e)37 b(a)i(F)-10 b(rame)38
+b(from)f(a)1648 5422 y(F)-10 b(rameSet)2776 5322 y Fz(astRemo)l(v)l(eF)
+f(rame)0 5593 y Fd(Description:)44 b Fi(This)27 b(function)g(remo)n(v)n
(es)e(a)i(F)-7 b(rame)26 b(from)g(a)g(F)-7 b(rameSet.)37
b(All)27 b(other)f(F)-7 b(rames)26 b(in)h(the)g(F)-7
-b(rameSet)27 b(ha)n(v)n(e)227 5415 y(their)h(indices)f(re-n)n(um)n(b)r
+b(rameSet)27 b(ha)n(v)n(e)227 5693 y(their)h(indices)f(re-n)n(um)n(b)r
(ered)g(from)g(one)g(\(if)i(necessary\),)d(but)i(are)f(otherwise)f(unc)
-n(hanged.)0 5567 y Fd(Synopsis:)121 b Ft(void)42 b(astRemoveFrame\()37
-b(AstFrameSet)i Fh(\003)p Ft(this,)i(int)i(iframe)e(\))0
-5718 y Fd(P)m(arameters:)p eop end
-%%Page: 341 351
-TeXDict begin 341 350 bop 3643 52 a FF(341)259 351 y
-Fd(this)427 451 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
-b(rameSet.)259 582 y Fd(iframe)427 681 y Fi(The)35 b(index)g(within)g
+n(hanged.)p eop end
+%%Page: 342 352
+TeXDict begin 342 351 bop 0 52 a FF(342)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Synopsis:)121
+b Ft(void)42 b(astRemoveFrame\()37 b(AstFrameSet)i Fh(\003)p
+Ft(this,)i(int)i(iframe)e(\))0 498 y Fd(P)m(arameters:)259
+633 y(this)427 732 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rameSet.)259 863 y Fd(iframe)427 963 y Fi(The)35 b(index)g(within)g
(the)g(F)-7 b(rameSet)34 b(of)h(the)g(F)-7 b(rame)34
b(to)h(b)r(e)g(remo)n(v)n(ed.)56 b(This)35 b(v)-5 b(alue)34
-b(should)h(lie)f(in)h(the)427 781 y(range)27 b(from)g(1)g(to)g(the)h(n)
-n(um)n(b)r(er)g(of)f(F)-7 b(rames)27 b(in)h(the)g(F)-7
+b(should)h(lie)f(in)h(the)427 1062 y(range)27 b(from)g(1)g(to)g(the)h
+(n)n(um)n(b)r(er)g(of)f(F)-7 b(rames)27 b(in)h(the)g(F)-7
b(rameSet)27 b(\(as)h(giv)n(en)e(b)n(y)i(its)f(Nframe)h(attribute\).)0
-941 y Fd(Notes:)340 1222 y Fh(\017)45 b Fi(Remo)n(ving)31
+1222 y Fd(Notes:)340 1502 y Fh(\017)45 b Fi(Remo)n(ving)31
b(a)g(F)-7 b(rame)31 b(from)g(a)g(F)-7 b(rameSet)32 b(do)r(es)f(not)h
(a\013ect)f(the)h(relationship)f(b)r(et)n(w)n(een)g(other)g(F)-7
-b(rames)427 1321 y(in)28 b(the)g(F)-7 b(rameSet,)28 b(ev)n(en)f(if)h
+b(rames)427 1602 y(in)28 b(the)g(F)-7 b(rameSet,)28 b(ev)n(en)f(if)h
(they)g(originally)d(dep)r(ended)k(on)e(the)h(F)-7 b(rame)27
-b(b)r(eing)h(remo)n(v)n(ed.)340 1452 y Fh(\017)45 b Fi(The)31
+b(b)r(eing)h(remo)n(v)n(ed.)340 1732 y Fh(\017)45 b Fi(The)31
b(n)n(um)n(b)r(er)g(of)g(F)-7 b(rames)30 b(in)i(a)e(F)-7
b(rameSet)31 b(cannot)g(b)r(e)g(reduced)g(to)g(zero.)46
-b(An)31 b(error)e(will)j(result)e(if)i(an)427 1552 y(attempt)d(is)e
+b(An)31 b(error)e(will)j(result)e(if)i(an)427 1832 y(attempt)d(is)e
(made)g(to)h(remo)n(v)n(e)e(the)i(only)f(remaining)g(F)-7
-b(rame.)340 1683 y Fh(\017)45 b Fi(A)32 b(v)-5 b(alue)30
+b(rame.)340 1963 y Fh(\017)45 b Fi(A)32 b(v)-5 b(alue)30
b(of)h(AST)p Ft(__)p Fi(BASE)g(or)f(AST)p Ft(__)p Fi(CURRENT)h(ma)n(y)f
(b)r(e)h(giv)n(en)g(for)f(the)h Ft(")p Fi(iframe)p Ft(")f
-Fi(parameter)g(to)427 1782 y(sp)r(ecify)e(the)g(base)f(F)-7
+Fi(parameter)g(to)427 2062 y(sp)r(ecify)e(the)g(base)f(F)-7
b(rame)27 b(or)g(the)h(curren)n(t)f(F)-7 b(rame)27 b(resp)r(ectiv)n
-(ely)-7 b(.)340 1913 y Fh(\017)45 b Fi(If)22 b(a)f(F)-7
+(ely)-7 b(.)340 2193 y Fh(\017)45 b Fi(If)22 b(a)f(F)-7
b(rameSet's)21 b(base)f(or)h(curren)n(t)f(F)-7 b(rame)21
b(is)g(remo)n(v)n(ed,)g(the)g(Base)g(or)f(Curren)n(t)h(attribute)g
-(\(resp)r(ectiv)n(ely\))427 2013 y(of)30 b(the)g(F)-7
+(\(resp)r(ectiv)n(ely\))427 2293 y(of)30 b(the)g(F)-7
b(rameSet)30 b(will)g(ha)n(v)n(e)f(its)h(v)-5 b(alue)30
b(cleared,)f(so)g(that)i(another)d(F)-7 b(rame)30 b(will)g(then)g
-(assume)f(its)i(role)427 2112 y(b)n(y)d(default.)340
-2243 y Fh(\017)45 b Fi(If)26 b(an)n(y)f(other)g(F)-7
+(assume)f(its)i(role)427 2392 y(b)n(y)d(default.)340
+2523 y Fh(\017)45 b Fi(If)26 b(an)n(y)f(other)g(F)-7
b(rame)25 b(is)g(remo)n(v)n(ed,)f(the)i(base)f(and)g(curren)n(t)g(F)-7
b(rames)24 b(will)i(remain)f(the)h(same.)35 b(T)-7 b(o)25
-b(ensure)427 2343 y(this,)37 b(the)d(Base)g(and/or)e(Curren)n(t)i
+b(ensure)427 2622 y(this,)37 b(the)d(Base)g(and/or)e(Curren)n(t)i
(attributes)g(of)g(the)h(F)-7 b(rameSet)34 b(will)h(b)r(e)f(c)n
-(hanged,)i(if)e(necessary)-7 b(,)35 b(to)427 2443 y(re\015ect)28
+(hanged,)i(if)e(necessary)-7 b(,)35 b(to)427 2722 y(re\015ect)28
b(an)n(y)e(c)n(hange)h(in)h(the)g(indices)f(of)h(these)f(F)-7
-b(rames.)p 0 2638 3780 12 v 0 2769 a Fz(astRemo)l(v)l(eP)l(arameter)
-1468 2770 y Fe(Remo)m(v)m(e)37 b(a)i(global)1443 2884
-y(parameter)d(from)h(a)1763 2999 y(table)2527 2769 y
-Fz(astRemo)l(v)l(eP)l(arameter)0 3160 y Fd(Description:)44
+b(rames.)p 0 2917 3780 12 v 0 3048 a Fz(astRemo)l(v)l(eP)l(arameter)
+1468 3049 y Fe(Remo)m(v)m(e)37 b(a)i(global)1443 3163
+y(parameter)d(from)h(a)1763 3278 y(table)2527 3048 y
+Fz(astRemo)l(v)l(eP)l(arameter)0 3439 y Fd(Description:)44
b Fi(This)26 b(function)g(remo)n(v)n(es)d(a)i(sp)r(eci\014ed)h(global)e
(parameter)g(from)h(the)h(supplied)f(table.)37 b(The)25
-b(function)227 3260 y(returns)i(without)h(action)f(if)h(the)g(named)g
+b(function)227 3539 y(returns)i(without)h(action)f(if)h(the)g(named)g
(parameter)e(do)r(es)h(not)h(exist)f(in)h(the)g(T)-7
-b(able)27 b(\(no)h(error)e(is)h(rep)r(orted\).)0 3408
+b(able)27 b(\(no)h(error)e(is)h(rep)r(orted\).)0 3686
y Fd(Synopsis:)121 b Ft(void)42 b(astRemoveParamet)o(er)o(\()c
(AstTable)i Fh(\003)p Ft(this,)h(const)g(char)h Fh(\003)p
-Ft(name)g(\))0 3555 y Fd(P)m(arameters:)259 3690 y(this)427
-3789 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(T)-7 b(able.)259
-3920 y Fd(name)427 4020 y Fi(The)31 b(parameter)f(name.)47
+Ft(name)g(\))0 3833 y Fd(P)m(arameters:)259 3967 y(this)427
+4067 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(T)-7 b(able.)259
+4197 y Fd(name)427 4297 y Fi(The)31 b(parameter)f(name.)47
b(T)-7 b(railing)30 b(spaces)g(are)g(ignored)g(\(all)h(other)g(spaces)f
-(are)g(signi\014can)n(t\).)46 b(Case)31 b(is)427 4119
-y(signi\014can)n(t.)p 0 4315 V 0 4446 a Fz(astRemo)l(v)l(eRegions)1359
-4445 y Fe(Remo)m(v)m(e)38 b(an)m(y)g(Regions)1477 4560
-y(from)f(a)i(Mapping)2682 4446 y Fz(astRemo)l(v)l(eRegions)0
-4749 y Fd(Description:)44 b Fi(This)33 b(function)g(searc)n(hes)e(the)i
+(are)g(signi\014can)n(t\).)46 b(Case)31 b(is)427 4397
+y(signi\014can)n(t.)p 0 4592 V 0 4723 a Fz(astRemo)l(v)l(eRegions)1359
+4722 y Fe(Remo)m(v)m(e)38 b(an)m(y)g(Regions)1477 4836
+y(from)f(a)i(Mapping)2682 4723 y Fz(astRemo)l(v)l(eRegions)0
+5026 y Fd(Description:)44 b Fi(This)33 b(function)g(searc)n(hes)e(the)i
(suppliedMapping)g(\(whic)n(h)g(ma)n(y)f(b)r(e)h(a)f(comp)r(ound)h
-(Mapping)f(suc)n(h)227 4849 y(as)d(a)g(CmpMap\))g(for)g(an)n(y)f(comp)r
+(Mapping)f(suc)n(h)227 5125 y(as)d(a)g(CmpMap\))g(for)g(an)n(y)f(comp)r
(onen)n(t)h(Mappings)g(that)g(are)f(instances)h(of)g(the)h(AST)f
-(Region)g(class.)41 b(It)29 b(then)227 4949 y(creates)f(a)h(new)g
+(Region)g(class.)41 b(It)29 b(then)227 5225 y(creates)f(a)h(new)g
(Mapping)f(from)h(whic)n(h)g(all)f(Regions)g(ha)n(v)n(e)g(b)r(een)h
(remo)n(v)n(ed.)40 b(If)29 b(a)f(Region)h(cannot)f(simply)h(b)r(e)227
-5048 y(remo)n(v)n(ed)34 b(\(for)i(instance,)h(if)f(it)g(is)f(a)g(comp)r
+5324 y(remo)n(v)n(ed)34 b(\(for)i(instance,)h(if)f(it)g(is)f(a)g(comp)r
(onen)n(t)h(of)f(a)g(parallel)g(CmpMap\),)j(then)e(it)g(is)f(replaced)g
-(with)h(an)227 5148 y(equiv)-5 b(alen)n(t)28 b(UnitMap)g(in)g(the)g
-(returned)f(Mapping.)0 5295 y Fd(Synopsis:)121 b Ft(AstMapping)39
+(with)h(an)227 5424 y(equiv)-5 b(alen)n(t)28 b(UnitMap)g(in)g(the)g
+(returned)f(Mapping.)0 5571 y Fd(Synopsis:)121 b Ft(AstMapping)39
b Fh(\003)p Ft(astRemoveRegions)o(\()e(AstMapping)j Fh(\003)p
-Ft(this)h(\))0 5443 y Fd(P)m(arameters:)259 5577 y(this)427
-5677 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(original)e(Mapping.)p
-eop end
-%%Page: 342 352
-TeXDict begin 342 351 bop 0 52 a FF(342)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Class)h(Applicabilit)m
-(y:)259 473 y(CmpF)-8 b(rame)427 573 y Fi(If)35 b(the)f(supplied)g
-(Mapping)g(is)g(a)f(CmpF)-7 b(rame,)36 b(an)n(y)d(comp)r(onen)n(t)g(F)
--7 b(rames)34 b(that)g(are)f(instances)g(of)h(the)427
-672 y(Region)27 b(class)g(are)f(replaced)h(b)n(y)g(the)h(equiv)-5
-b(alen)n(t)28 b(F)-7 b(rame.)259 791 y Fd(F)f(rameSet)427
-890 y Fi(If)29 b(the)f(supplied)g(Mapping)g(is)f(a)h(F)-7
-b(rameSet,)28 b(the)g(returned)g(Mapping)f(will)h(b)r(e)h(a)e(cop)n(y)g
-(of)h(the)g(supplied)427 990 y(F)-7 b(rameSet)29 b(in)g(whic)n(h)g
-(Regions)f(ha)n(v)n(e)g(b)r(een)i(remo)n(v)n(ed)d(from)i(all)g(the)g
-(in)n(ter-F)-7 b(rame)28 b(Mappings,)h(and)f(an)n(y)427
-1089 y(F)-7 b(rames)27 b(whic)n(h)h(are)e(instances)h(of)h(the)g
-(Region)f(class)f(are)h(repalced)g(b)n(y)g(the)h(equiv)-5
-b(alen)n(t)27 b(F)-7 b(rame.)259 1208 y Fd(Mapping)427
-1307 y Fi(This)28 b(function)g(applies)f(to)h(all)f(Mappings.)259
-1426 y Fd(Region)427 1525 y Fi(If)h(the)g(supplied)g(Mapping)f(is)h(a)f
+Ft(this)h(\))0 5718 y Fd(P)m(arameters:)p eop end
+%%Page: 343 353
+TeXDict begin 343 352 bop 3643 52 a FF(343)259 351 y
+Fd(this)427 451 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(original)e(Mapping.)
+0 613 y Fd(Class)31 b(Applicabilit)m(y:)259 750 y(CmpF)-8
+b(rame)427 849 y Fi(If)35 b(the)f(supplied)g(Mapping)g(is)g(a)f(CmpF)-7
+b(rame,)36 b(an)n(y)d(comp)r(onen)n(t)g(F)-7 b(rames)34
+b(that)g(are)f(instances)g(of)h(the)427 949 y(Region)27
+b(class)g(are)f(replaced)h(b)n(y)g(the)h(equiv)-5 b(alen)n(t)28
+b(F)-7 b(rame.)259 1082 y Fd(F)f(rameSet)427 1181 y Fi(If)29
+b(the)f(supplied)g(Mapping)g(is)f(a)h(F)-7 b(rameSet,)28
+b(the)g(returned)g(Mapping)f(will)h(b)r(e)h(a)e(cop)n(y)g(of)h(the)g
+(supplied)427 1281 y(F)-7 b(rameSet)29 b(in)g(whic)n(h)g(Regions)f(ha)n
+(v)n(e)g(b)r(een)i(remo)n(v)n(ed)d(from)i(all)g(the)g(in)n(ter-F)-7
+b(rame)28 b(Mappings,)h(and)f(an)n(y)427 1381 y(F)-7
+b(rames)27 b(whic)n(h)h(are)e(instances)h(of)h(the)g(Region)f(class)f
+(are)h(repalced)g(b)n(y)g(the)h(equiv)-5 b(alen)n(t)27
+b(F)-7 b(rame.)259 1514 y Fd(Mapping)427 1613 y Fi(This)28
+b(function)g(applies)f(to)h(all)f(Mappings.)259 1746
+y Fd(Region)427 1846 y Fi(If)h(the)g(supplied)g(Mapping)f(is)h(a)f
(Region,)g(the)h(returned)f(Mapping)g(will)h(b)r(e)g(the)g(equiv)-5
-b(alen)n(t)28 b(F)-7 b(rame.)0 1673 y Fd(Returned)32
-b(V)-8 b(alue:)259 1794 y(astRemo)m(v)m(eRegions\(\))427
-1894 y Fi(A)28 b(new)g(p)r(oin)n(ter)f(to)h(the)g(\(p)r(ossibly)f(mo)r
-(di\014ed\))h(Mapping.)0 2041 y Fd(Notes:)340 2309 y
+b(alen)n(t)28 b(F)-7 b(rame.)0 2008 y Fd(Returned)32
+b(V)-8 b(alue:)259 2145 y(astRemo)m(v)m(eRegions\(\))427
+2244 y Fi(A)28 b(new)g(p)r(oin)n(ter)f(to)h(the)g(\(p)r(ossibly)f(mo)r
+(di\014ed\))h(Mapping.)0 2406 y Fd(Notes:)340 2689 y
Fh(\017)45 b Fi(This)22 b(function)f(can)g(safely)g(b)r(e)h(applied)f
(ev)n(en)g(to)g(Mappings)f(whic)n(h)i(con)n(tain)e(no)h(Regions.)34
-b(If)22 b(no)f(Regions)427 2409 y(are)27 b(found,)h(it)g(b)r(eha)n(v)n
+b(If)22 b(no)f(Regions)427 2789 y(are)27 b(found,)h(it)g(b)r(eha)n(v)n
(es)e(exactly)h(lik)n(e)h(astClone)e(and)i(returns)f(a)g(p)r(oin)n(ter)
-g(to)g(the)h(original)f(Mapping.)340 2527 y Fh(\017)45
+g(to)g(the)h(original)f(Mapping.)340 2922 y Fh(\017)45
b Fi(The)26 b(Mapping)f(returned)g(b)n(y)g(this)h(function)g(ma)n(y)e
(not)i(b)r(e)g(indep)r(enden)n(t)g(of)f(the)h(original)e(\(ev)n(en)h
-(if)h(some)427 2627 y(Regions)f(w)n(ere)h(remo)n(v)n(ed\),)f(and)h(mo)r
+(if)h(some)427 3021 y(Regions)f(w)n(ere)h(remo)n(v)n(ed\),)f(and)h(mo)r
(difying)g(it)h(ma)n(y)e(therefore)h(result)f(in)i(indirect)f(mo)r
-(di\014cation)g(of)g(the)427 2726 y(original.)34 b(If)22
+(di\014cation)g(of)g(the)427 3121 y(original.)34 b(If)22
b(a)g(completely)g(indep)r(enden)n(t)g(result)g(is)g(required,)g(a)g
(cop)n(y)f(should)h(b)r(e)g(made)g(using)g(astCop)n(y)-7
-b(.)340 2845 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+b(.)340 3254 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 2944 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)p 0 3114 3780 12 v 0 3245
-a Fz(astRemo)l(v)l(eRo)l(w)1195 3246 y Fe(Remo)m(v)m(e)37
-b(a)i(ro)m(w)e(from)h(a)g(table)2882 3245 y Fz(astRemo)l(v)l(eRo)l(w)0
-3382 y Fd(Description:)44 b Fi(This)c(function)g(remo)n(v)n(es)e(a)i
+427 3354 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)p 0 3553 3780 12 v 0 3684
+a Fz(astRemo)l(v)l(eRo)l(w)1195 3685 y Fe(Remo)m(v)m(e)37
+b(a)i(ro)m(w)e(from)h(a)g(table)2882 3684 y Fz(astRemo)l(v)l(eRo)l(w)0
+3851 y Fd(Description:)44 b Fi(This)c(function)g(remo)n(v)n(es)e(a)i
(sp)r(eci\014ed)g(ro)n(w)e(from)i(the)g(supplied)g(table.)73
-b(The)40 b(function)g(returns)227 3482 y(without)28 b(action)f(if)h
+b(The)40 b(function)g(returns)227 3950 y(without)28 b(action)f(if)h
(the)g(ro)n(w)f(do)r(es)g(not)h(exist)f(in)h(the)g(T)-7
-b(able)27 b(\(no)h(error)e(is)h(rep)r(orted\).)0 3617
+b(able)27 b(\(no)h(error)e(is)h(rep)r(orted\).)0 4100
y Fd(Synopsis:)121 b Ft(void)42 b(astRemoveRow\()c(AstTable)i
-Fh(\003)p Ft(this,)h(int)i(index)e(\))0 3752 y Fd(P)m(arameters:)259
-3873 y(this)427 3973 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(T)-7
-b(able.)259 4091 y Fd(index)427 4191 y Fi(The)28 b(index)g(of)f(the)h
+Fh(\003)p Ft(this,)h(int)i(index)e(\))0 4249 y Fd(P)m(arameters:)259
+4386 y(this)427 4486 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(T)-7
+b(able.)259 4619 y Fd(index)427 4718 y Fi(The)28 b(index)g(of)f(the)h
(ro)n(w)f(to)g(b)r(e)h(remo)n(v)n(ed.)35 b(The)28 b(\014rst)f(ro)n(w)g
-(has)g(index)g(1.)p 0 4361 V 0 4493 a Fz(astRemo)l(v)l(eT)-11
+(has)g(index)g(1.)p 0 4918 V 0 5049 a Fz(astRemo)l(v)l(eT)-11
b(ables)186 b Fe(Remo)m(v)m(e)38 b(one)h(or)f(more)f(tables)1466
-4592 y(from)g(a)i(FitsChan)2769 4493 y Fz(astRemo)l(v)l(eT)-11
-b(ables)0 4733 y Fd(Description:)44 b Fi(This)38 b(function)h(remo)n(v)
+5149 y(from)g(a)i(FitsChan)2769 5049 y Fz(astRemo)l(v)l(eT)-11
+b(ables)0 5320 y Fd(Description:)44 b Fi(This)38 b(function)h(remo)n(v)
n(es)c(the)k(named)e(tables)h(from)f(the)i(FitsChan,)h(it)e(they)g
-(exist)g(\(no)g(error)e(is)227 4833 y(rep)r(orted)27
+(exist)g(\(no)g(error)e(is)227 5419 y(rep)r(orted)27
b(if)h(an)n(y)f(the)h(tables)f(do)h(not)f(exist\).)0
-4968 y Fd(Synopsis:)121 b Ft(void)42 b(astRemoveTables\()37
+5569 y Fd(Synopsis:)121 b Ft(void)42 b(astRemoveTables\()37
b(AstFitsChan)i Fh(\003)p Ft(this,)i(const)g(char)h Fh(\003)p
-Ft(key)g(\))0 5103 y Fd(P)m(arameters:)259 5225 y(this)427
-5324 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)259
-5442 y Fd(k)m(ey)427 5542 y Fi(The)g(k)n(ey)e(indicating)h(whic)n(h)g
-(tables)g(to)g(exist.)37 b(A)27 b(single)g(k)n(ey)f(or)h(a)f
-(comma-separated)f(list)j(of)f(k)n(eys)f(can)427 5642
-y(b)r(e)i(supplied.)37 b(If)29 b(a)e(blank)g(string)g(is)g(supplied,)h
-(all)g(tables)f(are)g(remo)n(v)n(ed.)p eop end
-%%Page: 343 353
-TeXDict begin 343 352 bop 3643 52 a FF(343)p 0 351 3780
-12 v 0 483 a Fz(astResample)p Fc(<)p Fz(X)p Fc(>)154
-b Fe(Resample)38 b(a)g(region)f(of)i(a)f(data)1789 598
-y(grid)2759 483 y Fz(astResample)p Fc(<)p Fz(X)p Fc(>)0
-815 y Fd(Description:)44 b Fi(This)31 b(is)g(a)f(set)h(of)g(functions)g
-(for)f(resampling)g(gridded)g(data)h(\(e.g.)46 b(an)31
-b(image\))f(under)h(the)g(con)n(trol)227 915 y(of)c(a)e(geometrical)g
-(transformation,)g(whic)n(h)h(is)g(sp)r(eci\014ed)h(b)n(y)f(a)g
-(Mapping.)36 b(The)26 b(functions)h(op)r(erate)e(on)h(a)g(pair)227
-1014 y(of)i(data)f(grids)f(\(input)j(and)f(output\),)g(eac)n(h)f(of)g
-(whic)n(h)h(ma)n(y)f(ha)n(v)n(e)f(an)n(y)h(n)n(um)n(b)r(er)g(of)h
-(dimensions.)36 b(Resampling)227 1114 y(ma)n(y)c(b)r(e)g(restricted)g
-(to)g(a)g(sp)r(eci\014ed)h(region)d(of)j(the)f(output)h(grid.)50
-b(An)33 b(asso)r(ciated)e(grid)g(of)i(error)d(estimates)227
-1213 y(asso)r(ciated)36 b(with)h(the)g(input)h(data)e(ma)n(y)g(also)g
-(b)r(e)h(supplied)g(\(in)g(the)h(form)e(of)h(v)-5 b(ariance)35
-b(v)-5 b(alues\),)39 b(so)e(as)f(to)227 1313 y(pro)r(duce)29
-b(error)f(estimates)h(for)g(the)h(resampled)e(output)i(data.)42
-b(Propagation)27 b(of)i(missing)g(data)g(\(bad)h(pixels\))227
-1413 y(is)e(supp)r(orted.)227 1549 y(Y)-7 b(ou)41 b(should)g(use)f(a)g
-(resampling)g(function)h(whic)n(h)g(matc)n(hes)f(the)h(n)n(umerical)f
-(t)n(yp)r(e)h(of)f(the)h(data)g(y)n(ou)f(are)227 1649
-y(pro)r(cessing)24 b(b)n(y)i(replacing)e Fk(<)p Fi(X)p
-Fk(>)h Fi(in)h(the)g(generic)e(function)i(name)g(astResample)p
-Fk(<)p Fi(X)p Fk(>)e Fi(b)n(y)h(an)h(appropriate)d(1-)227
-1748 y(or)f(2-c)n(haracter)d(t)n(yp)r(e)j(co)r(de.)35
+Ft(key)g(\))0 5718 y Fd(P)m(arameters:)p eop end
+%%Page: 344 354
+TeXDict begin 344 353 bop 0 52 a FF(344)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(this)427
+451 y Fi(P)n(oin)n(ter)c(to)i(the)g(FitsChan.)259 587
+y Fd(k)m(ey)427 687 y Fi(The)g(k)n(ey)e(indicating)h(whic)n(h)g(tables)
+g(to)g(exist.)37 b(A)27 b(single)g(k)n(ey)f(or)h(a)f(comma-separated)f
+(list)j(of)f(k)n(eys)f(can)427 786 y(b)r(e)i(supplied.)37
+b(If)29 b(a)e(blank)g(string)g(is)g(supplied,)h(all)g(tables)f(are)g
+(remo)n(v)n(ed.)p 0 992 3780 12 v 0 1124 a Fz(astResample)p
+Fc(<)p Fz(X)p Fc(>)154 b Fe(Resample)38 b(a)g(region)f(of)i(a)f(data)
+1789 1239 y(grid)2759 1124 y Fz(astResample)p Fc(<)p
+Fz(X)p Fc(>)0 1439 y Fd(Description:)44 b Fi(This)31
+b(is)g(a)f(set)h(of)g(functions)g(for)f(resampling)g(gridded)g(data)h
+(\(e.g.)46 b(an)31 b(image\))f(under)h(the)g(con)n(trol)227
+1538 y(of)c(a)e(geometrical)g(transformation,)g(whic)n(h)h(is)g(sp)r
+(eci\014ed)h(b)n(y)f(a)g(Mapping.)36 b(The)26 b(functions)h(op)r(erate)
+e(on)h(a)g(pair)227 1638 y(of)i(data)f(grids)f(\(input)j(and)f
+(output\),)g(eac)n(h)f(of)g(whic)n(h)h(ma)n(y)f(ha)n(v)n(e)f(an)n(y)h
+(n)n(um)n(b)r(er)g(of)h(dimensions.)36 b(Resampling)227
+1738 y(ma)n(y)c(b)r(e)g(restricted)g(to)g(a)g(sp)r(eci\014ed)h(region)d
+(of)j(the)f(output)h(grid.)50 b(An)33 b(asso)r(ciated)e(grid)g(of)i
+(error)d(estimates)227 1837 y(asso)r(ciated)36 b(with)h(the)g(input)h
+(data)e(ma)n(y)g(also)g(b)r(e)h(supplied)g(\(in)g(the)h(form)e(of)h(v)
+-5 b(ariance)35 b(v)-5 b(alues\),)39 b(so)e(as)f(to)227
+1937 y(pro)r(duce)29 b(error)f(estimates)h(for)g(the)h(resampled)e
+(output)i(data.)42 b(Propagation)27 b(of)i(missing)g(data)g(\(bad)h
+(pixels\))227 2036 y(is)e(supp)r(orted.)227 2164 y(Y)-7
+b(ou)41 b(should)g(use)f(a)g(resampling)g(function)h(whic)n(h)g(matc)n
+(hes)f(the)h(n)n(umerical)f(t)n(yp)r(e)h(of)f(the)h(data)g(y)n(ou)f
+(are)227 2264 y(pro)r(cessing)24 b(b)n(y)i(replacing)e
+Fk(<)p Fi(X)p Fk(>)h Fi(in)h(the)g(generic)e(function)i(name)g
+(astResample)p Fk(<)p Fi(X)p Fk(>)e Fi(b)n(y)h(an)h(appropriate)d(1-)
+227 2364 y(or)f(2-c)n(haracter)d(t)n(yp)r(e)j(co)r(de.)35
b(F)-7 b(or)22 b(example,)h(if)f(y)n(ou)g(are)f(resampling)g(data)g
(with)i(t)n(yp)r(e)f Ft(")p Fi(\015oat)p Ft(")p Fi(,)g(y)n(ou)g(should)
-g(use)227 1848 y(the)33 b(function)f(astResampleF)f(\(see)h(the)h
+g(use)227 2463 y(the)33 b(function)f(astResampleF)f(\(see)h(the)h
Ft(")p Fi(Data)e(T)n(yp)r(e)h(Co)r(des)p Ft(")f Fi(section)g(b)r(elo)n
-(w)h(for)f(the)i(co)r(des)e(appropriate)227 1948 y(to)d(other)f(n)n
-(umerical)g(t)n(yp)r(es\).)227 2084 y(Resampling)e(of)h(the)f(grid)g
+(w)h(for)f(the)i(co)r(des)e(appropriate)227 2563 y(to)d(other)f(n)n
+(umerical)g(t)n(yp)r(es\).)227 2691 y(Resampling)e(of)h(the)f(grid)g
(of)h(input)g(data)f(is)g(p)r(erformed)g(b)n(y)h(transforming)e(the)h
-(co)r(ordinates)f(of)i(the)g(cen)n(tre)f(of)227 2184
+(co)r(ordinates)f(of)i(the)g(cen)n(tre)f(of)227 2790
y(eac)n(h)d(output)g(grid)g(elemen)n(t)g(\(or)g(pixel\))g(in)n(to)g
(the)h(co)r(ordinate)e(system)h(of)g(the)h(input)g(grid.)34
-b(Since)23 b(the)f(resulting)227 2284 y(co)r(ordinates)27
+b(Since)23 b(the)f(resulting)227 2890 y(co)r(ordinates)27
b(will)h(not,)g(in)g(general,)f(coincide)h(with)g(the)h(cen)n(tre)e(of)
h(an)g(input)h(pixel,)f(sub-pixel)f(in)n(terp)r(olation)227
-2383 y(is)35 b(p)r(erformed)g(b)r(et)n(w)n(een)g(the)h(neigh)n(b)r
+2990 y(is)35 b(p)r(erformed)g(b)r(et)n(w)n(een)g(the)h(neigh)n(b)r
(ouring)e(input)i(pixels.)60 b(This)35 b(pro)r(duces)f(a)h(resampled)f
-(v)-5 b(alue)36 b(whic)n(h)f(is)227 2483 y(then)26 b(assigned)d(to)i
+(v)-5 b(alue)36 b(whic)n(h)f(is)227 3089 y(then)26 b(assigned)d(to)i
(the)g(output)g(pixel.)36 b(A)26 b(c)n(hoice)e(of)g(sub-pixel)h(in)n
(terp)r(olation)f(sc)n(hemes)g(is)h(pro)n(vided,)f(but)h(y)n(ou)227
-2582 y(ma)n(y)i(also)g(implemen)n(t)h(y)n(our)e(o)n(wn.)227
-2719 y(This)g(algorithm)f(samples)h(the)h(input)g(data)e(v)-5
+3189 y(ma)n(y)i(also)g(implemen)n(t)h(y)n(our)e(o)n(wn.)227
+3317 y(This)g(algorithm)f(samples)h(the)h(input)g(data)e(v)-5
b(alue,)27 b(it)f(do)r(es)g(not)g(in)n(tegrate)f(it.)37
b(Th)n(us)26 b(total)g(data)g(v)-5 b(alue)26 b(in)g(the)227
-2819 y(input)31 b(image)f(will)h(not,)g(in)f(general,)g(b)r(e)h
+3416 y(input)31 b(image)f(will)h(not,)g(in)f(general,)g(b)r(e)h
(conserv)n(ed.)43 b(Ho)n(w)n(ev)n(er,)30 b(an)g(option)g(is)g(pro)n
-(vided)f(\(see)i(the)f Ft(")p Fi(Con)n(trol)227 2918
+(vided)f(\(see)i(the)f Ft(")p Fi(Con)n(trol)227 3516
y(Flags)p Ft(")38 b Fi(section)h(b)r(elo)n(w\))g(whic)n(h)h(can)e(pro)r
(duce)h(appro)n(ximate)f(\015ux)h(conserv)-5 b(ation)38
-b(b)n(y)h(scaling)f(the)i(output)227 3018 y(v)-5 b(alues)34
+b(b)n(y)h(scaling)f(the)i(output)227 3616 y(v)-5 b(alues)34
b(using)f(the)h(ratio)f(of)h(the)g(output)h(pixel)f(size)f(to)h(the)g
(input)h(pixel)f(size.)55 b(Ho)n(w)n(ev)n(er,)34 b(if)g(accurate)e
-(\015ux)227 3117 y(conserv)-5 b(ation)29 b(is)h(imp)r(ortan)n(t)f(to)h
+(\015ux)227 3715 y(conserv)-5 b(ation)29 b(is)h(imp)r(ortan)n(t)f(to)h
(y)n(ou,)g(consder)f(using)h(the)g(astRebin)p Fk(<)p
Fi(X)p Fk(>)f Fi(or)g(astRebinSeq)p Fk(<)p Fi(X)p Fk(>)h
-Fi(family)g(of)227 3217 y(functions)e(instead.)227 3354
+Fi(family)g(of)227 3815 y(functions)e(instead.)227 3943
y(Output)k(pixel)g(co)r(ordinates)e(are)h(transformed)f(in)n(to)h(the)h
(co)r(ordinate)e(system)i(of)f(the)h(input)g(grid)f(using)g(the)227
-3453 y(in)n(v)n(erse)i(transformation)g(of)h(the)h(Mapping)e(whic)n(h)i
+4042 y(in)n(v)n(erse)i(transformation)g(of)h(the)h(Mapping)e(whic)n(h)i
(is)f(supplied.)57 b(This)34 b(means)g(that)h(geometrical)d(features)
-227 3553 y(in)g(the)f(input)h(data)f(are)f(sub)5 b(jected)31
+227 4142 y(in)g(the)f(input)h(data)f(are)f(sub)5 b(jected)31
b(to)g(the)h(Mapping's)e(forw)n(ard)g(transformation)f(as)i(they)g(are)
-f(transferred)227 3652 y(from)24 b(the)g(input)g(to)g(the)g(output)g
+f(transferred)227 4242 y(from)24 b(the)g(input)g(to)g(the)g(output)g
(grid)f(\(although)g(the)h(Mapping's)f(forw)n(ard)f(transformation)g
-(is)i(not)f(explicitly)227 3752 y(used\).)227 3889 y(In)h(practice,)f
+(is)i(not)f(explicitly)227 4341 y(used\).)227 4469 y(In)h(practice,)f
(transforming)e(the)j(co)r(ordinates)e(of)h(ev)n(ery)e(pixel)j(of)f(a)f
(large)g(data)h(grid)f(can)h(b)r(e)g(time-consuming,)227
-3988 y(esp)r(ecially)38 b(if)g(the)h(Mapping)f(in)n(v)n(olv)n(es)e
+4569 y(esp)r(ecially)38 b(if)g(the)h(Mapping)f(in)n(v)n(olv)n(es)e
(complicated)i(functions,)j(suc)n(h)c(as)h(sky)f(pro)5
-b(jections.)67 b(T)-7 b(o)38 b(impro)n(v)n(e)227 4088
+b(jections.)67 b(T)-7 b(o)38 b(impro)n(v)n(e)227 4668
y(p)r(erformance,)29 b(it)g(is)g(therefore)f(p)r(ossible)g(to)h(appro)n
(ximate)e(non-linear)h(Mappings)g(b)n(y)h(a)g(set)g(of)f(linear)h
-(trans-)227 4188 y(formations)h(whic)n(h)h(are)f(applied)g(piece-wise)h
+(trans-)227 4768 y(formations)h(whic)n(h)h(are)f(applied)g(piece-wise)h
(to)f(separate)g(sub-regions)f(of)h(the)i(data.)46 b(This)30
-b(appro)n(ximation)227 4287 y(pro)r(cess)37 b(is)h(applied)g
+b(appro)n(ximation)227 4868 y(pro)r(cess)37 b(is)h(applied)g
(automatically)f(b)n(y)h(an)g(adaptiv)n(e)f(algorithm,)i(under)f(con)n
-(trol)f(of)h(an)g(accuracy)e(crite-)227 4387 y(rion)25
+(trol)f(of)h(an)g(accuracy)e(crite-)227 4967 y(rion)25
b(whic)n(h)h(expresses)f(the)h(maxim)n(um)g(tolerable)f(geometrical)f
(distortion)h(whic)n(h)h(ma)n(y)f(b)r(e)i(in)n(tro)r(duced,)f(as)f(a)
-227 4486 y(fraction)i(of)h(a)f(pixel.)227 4623 y(This)34
+227 5067 y(fraction)i(of)h(a)f(pixel.)227 5195 y(This)34
b(algorithm)e(\014rst)h(attempts)h(to)g(appro)n(ximate)e(the)i(Mapping)
-f(with)h(a)f(linear)g(transformation)f(applied)227 4723
+f(with)h(a)f(linear)g(transformation)f(applied)227 5295
y(o)n(v)n(er)h(the)h(whole)g(region)f(of)h(the)h(output)g(grid)e(whic)n
(h)i(is)f(b)r(eing)g(used.)57 b(If)35 b(this)f(pro)n(v)n(es)f(to)h(b)r
-(e)g(insu\016cien)n(tly)227 4822 y(accurate,)29 b(the)h(output)g
+(e)g(insu\016cien)n(tly)227 5394 y(accurate,)29 b(the)h(output)g
(region)f(is)g(sub-divided)h(in)n(to)f(t)n(w)n(o)g(along)f(its)i
(largest)e(dimension)i(and)f(the)h(pro)r(cess)f(is)227
-4922 y(rep)r(eated)k(within)h(eac)n(h)f(of)g(the)h(resulting)e
+5494 y(rep)r(eated)k(within)h(eac)n(h)f(of)g(the)h(resulting)e
(sub-regions.)53 b(This)33 b(pro)r(cess)f(of)h(sub-division)g(con)n
-(tin)n(ues)f(un)n(til)i(a)227 5021 y(su\016cien)n(tly)27
+(tin)n(ues)f(un)n(til)i(a)227 5593 y(su\016cien)n(tly)27
b(go)r(o)r(d)g(linear)f(appro)n(ximation)g(is)h(found,)g(or)f(the)i
(region)e(to)h(whic)n(h)g(it)h(is)f(b)r(eing)g(applied)g(b)r(ecomes)227
-5121 y(to)r(o)h(small)f(\(in)h(whic)n(h)f(case)g(the)h(original)e
-(Mapping)h(is)h(used)g(directly\).)0 5295 y Fd(Synopsis:)121
+5693 y(to)r(o)h(small)f(\(in)h(whic)n(h)f(case)g(the)h(original)e
+(Mapping)h(is)h(used)g(directly\).)p eop end
+%%Page: 345 355
+TeXDict begin 345 354 bop 3643 52 a FF(345)0 351 y Fd(Synopsis:)121
b Ft(int)42 b(astResample)p Fk(<)p Ft(X)p Fk(>)p Ft(\()c(AstMapping)h
Fh(\003)p Ft(this,)i(int)h(ndim_in,)f(const)g(int)i(lbnd_in[],)c(const)
-227 5394 y(int)k(ubnd_in[],)c(const)j Fk(<)p Ft(Xtype)p
+227 451 y(int)k(ubnd_in[],)c(const)j Fk(<)p Ft(Xtype)p
Fk(>)e Ft(in[],)i(const)f Fk(<)p Ft(Xtype)p Fk(>)g Ft(in_var[],)f(int)i
-(interp,)f(void)h(\()p Fh(\003)g Ft(finterp\)\()227 5494
+(interp,)f(void)h(\()p Fh(\003)g Ft(finterp\)\()227 551
y(void)g(\),)h(const)e(double)h(params[],)d(int)k(flags,)e(double)g
(tol,)h(int)g(maxpix,)f Fk(<)p Ft(Xtype)p Fk(>)g Ft(badval,)227
-5593 y(int)i(ndim_out,)c(const)j(int)g(lbnd_out[],)d(const)j(int)g
+650 y(int)i(ndim_out,)c(const)j(int)g(lbnd_out[],)d(const)j(int)g
(ubnd_out[],)d(const)j(int)g(lbnd[],)f(const)g(int)227
-5693 y(ubnd[],)g Fk(<)p Ft(Xtype)p Fk(>)g Ft(out[],)g
-Fk(<)p Ft(Xtype)p Fk(>)f Ft(out_var[])g(\);)p eop end
-%%Page: 344 354
-TeXDict begin 344 353 bop 0 52 a FF(344)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(P)m(arameters:)259
-489 y(this)427 589 y Fi(P)n(oin)n(ter)21 b(to)h(a)g(Mapping,)h(whose)f
-(in)n(v)n(erse)f(transformation)g(will)i(b)r(e)f(used)h(to)f(transform)
-f(the)i(co)r(ordinates)427 688 y(of)36 b(pixels)f(in)h(the)g(output)h
-(grid)e(in)n(to)g(the)h(co)r(ordinate)f(system)g(of)h(the)g(input)h
-(grid.)60 b(This)36 b(yields)f(the)427 788 y(p)r(ositions)h(whic)n(h)g
-(are)f(used)h(to)g(obtain)g(resampled)f(v)-5 b(alues)36
-b(b)n(y)f(sub-pixel)h(in)n(terp)r(olation)f(within)i(the)427
-888 y(input)29 b(grid.)427 1004 y(The)24 b(n)n(um)n(b)r(er)g(of)g
+750 y(ubnd[],)g Fk(<)p Ft(Xtype)p Fk(>)g Ft(out[],)g
+Fk(<)p Ft(Xtype)p Fk(>)f Ft(out_var[])g(\);)0 898 y Fd(P)m(arameters:)
+259 1034 y(this)427 1134 y Fi(P)n(oin)n(ter)21 b(to)h(a)g(Mapping,)h
+(whose)f(in)n(v)n(erse)f(transformation)g(will)i(b)r(e)f(used)h(to)f
+(transform)f(the)i(co)r(ordinates)427 1233 y(of)36 b(pixels)f(in)h(the)
+g(output)h(grid)e(in)n(to)g(the)h(co)r(ordinate)f(system)g(of)h(the)g
+(input)h(grid.)60 b(This)36 b(yields)f(the)427 1333 y(p)r(ositions)h
+(whic)n(h)g(are)f(used)h(to)g(obtain)g(resampled)f(v)-5
+b(alues)36 b(b)n(y)f(sub-pixel)h(in)n(terp)r(olation)f(within)i(the)427
+1433 y(input)29 b(grid.)427 1548 y(The)24 b(n)n(um)n(b)r(er)g(of)g
(input)h(co)r(ordinates)e(used)h(b)n(y)g(this)g(Mapping)g(\(as)f(giv)n
-(en)h(b)n(y)f(its)i(Nin)f(attribute\))h(should)427 1104
+(en)h(b)n(y)f(its)i(Nin)f(attribute\))h(should)427 1648
y(matc)n(h)e(the)g(n)n(um)n(b)r(er)g(of)g(input)h(grid)e(dimensions)h
(giv)n(en)f(b)n(y)g(the)i(v)-5 b(alue)23 b(of)g Ft(")p
Fi(ndim)p Ft(_)p Fi(in)p Ft(")f Fi(b)r(elo)n(w.)35 b(Similarly)-7
-b(,)427 1203 y(the)29 b(n)n(um)n(b)r(er)e(of)h(output)g(co)r(ordinates)
+b(,)427 1748 y(the)29 b(n)n(um)n(b)r(er)e(of)h(output)g(co)r(ordinates)
f(\(Nout)h(attribute\))h(should)e(matc)n(h)h(the)g(n)n(um)n(b)r(er)g
-(of)g(output)g(grid)427 1303 y(dimensions)g(giv)n(en)e(b)n(y)i
-Ft(")p Fi(ndim)p Ft(_)p Fi(out)p Ft(")p Fi(.)259 1437
-y Fd(ndim)p Ft(_)p Fd(in)427 1536 y Fi(The)g(n)n(um)n(b)r(er)f(of)h
+(of)g(output)g(grid)427 1847 y(dimensions)g(giv)n(en)e(b)n(y)i
+Ft(")p Fi(ndim)p Ft(_)p Fi(out)p Ft(")p Fi(.)259 1979
+y Fd(ndim)p Ft(_)p Fd(in)427 2079 y Fi(The)g(n)n(um)n(b)r(er)f(of)h
(dimensions)f(in)h(the)g(input)g(grid.)36 b(This)28 b(should)f(b)r(e)h
-(at)g(least)f(one.)259 1670 y Fd(lbnd)p Ft(_)p Fd(in)427
-1769 y Fi(P)n(oin)n(ter)i(to)i(an)f(arra)n(y)e(of)j(in)n(tegers,)f
+(at)g(least)f(one.)259 2211 y Fd(lbnd)p Ft(_)p Fd(in)427
+2311 y Fi(P)n(oin)n(ter)i(to)i(an)f(arra)n(y)e(of)j(in)n(tegers,)f
(with)h Ft(")p Fi(ndim)p Ft(_)p Fi(in)p Ft(")f Fi(elemen)n(ts,)h(con)n
-(taining)f(the)h(co)r(ordinates)e(of)h(the)427 1869 y(cen)n(tre)d(of)h
+(taining)f(the)h(co)r(ordinates)e(of)h(the)427 2410 y(cen)n(tre)d(of)h
(the)g(\014rst)f(pixel)h(in)g(the)g(input)g(grid)f(along)f(eac)n(h)h
-(dimension.)259 2003 y Fd(ubnd)p Ft(_)p Fd(in)427 2102
+(dimension.)259 2542 y Fd(ubnd)p Ft(_)p Fd(in)427 2642
y Fi(P)n(oin)n(ter)i(to)i(an)f(arra)n(y)e(of)j(in)n(tegers,)f(with)h
Ft(")p Fi(ndim)p Ft(_)p Fi(in)p Ft(")f Fi(elemen)n(ts,)h(con)n(taining)
-f(the)h(co)r(ordinates)e(of)h(the)427 2202 y(cen)n(tre)d(of)h(the)g
+f(the)h(co)r(ordinates)e(of)h(the)427 2741 y(cen)n(tre)d(of)h(the)g
(last)f(pixel)h(in)g(the)g(input)g(grid)f(along)f(eac)n(h)h(dimension.)
-427 2318 y(Note)h(that)h Ft(")p Fi(lbnd)p Ft(_)p Fi(in)p
+427 2857 y(Note)h(that)h Ft(")p Fi(lbnd)p Ft(_)p Fi(in)p
Ft(")e Fi(and)h Ft(")p Fi(ubnd)p Ft(_)p Fi(in)p Ft(")f
Fi(together)g(de\014ne)h(the)h(shap)r(e)f(and)f(size)h(of)g(the)g
-(input)h(grid,)e(its)427 2418 y(exten)n(t)f(along)f(a)g(particular)f
+(input)h(grid,)e(its)427 2957 y(exten)n(t)f(along)f(a)g(particular)f
(\(j'th\))k(dimension)d(b)r(eing)h(ubnd)p Ft(_)p Fi(in[j]-lbnd)p
-Ft(_)p Fi(in[j]+1)g(\(assuming)f(the)i(index)427 2518
+Ft(_)p Fi(in[j]+1)g(\(assuming)f(the)i(index)427 3057
y Ft(")p Fi(j)p Ft(")f Fi(to)g(b)r(e)g(zero-based\).)35
b(They)26 b(also)f(de\014ne)h(the)h(input)g(grid's)e(co)r(ordinate)g
-(system,)h(eac)n(h)g(pixel)g(ha)n(ving)427 2617 y(unit)j(exten)n(t)e
+(system,)h(eac)n(h)g(pixel)g(ha)n(ving)427 3156 y(unit)j(exten)n(t)e
(along)g(eac)n(h)f(dimension)i(with)g(in)n(tegral)e(co)r(ordinate)h(v)
--5 b(alues)27 b(at)g(its)h(cen)n(tre.)259 2751 y Fd(in)427
-2850 y Fi(P)n(oin)n(ter)h(to)i(an)f(arra)n(y)-7 b(,)30
+-5 b(alues)27 b(at)g(its)h(cen)n(tre.)259 3288 y Fd(in)427
+3388 y Fi(P)n(oin)n(ter)h(to)i(an)f(arra)n(y)-7 b(,)30
b(with)h(one)f(elemen)n(t)h(for)g(eac)n(h)f(pixel)g(in)h(the)g(input)h
-(grid,)f(con)n(taining)f(the)h(input)427 2950 y(data)f(to)h(b)r(e)g
+(grid,)f(con)n(taining)f(the)h(input)427 3487 y(data)f(to)h(b)r(e)g
(resampled.)45 b(The)31 b(n)n(umerical)e(t)n(yp)r(e)i(of)g(this)g(arra)
n(y)d(should)i(matc)n(h)h(the)g(1-)f(or)f(2-c)n(haracter)427
-3050 y(t)n(yp)r(e)j(co)r(de)g(app)r(ended)g(to)f(the)h(function)g(name)
+3587 y(t)n(yp)r(e)j(co)r(de)g(app)r(ended)g(to)f(the)h(function)g(name)
g(\(e.g.)49 b(if)32 b(y)n(ou)f(are)f(using)i(astResampleF,)f(the)h(t)n
-(yp)r(e)g(of)427 3149 y(eac)n(h)27 b(arra)n(y)e(elemen)n(t)j(should)f
-(b)r(e)h Ft(")p Fi(\015oat)p Ft(")p Fi(\).)427 3266 y(The)33
+(yp)r(e)g(of)427 3687 y(eac)n(h)27 b(arra)n(y)e(elemen)n(t)j(should)f
+(b)r(e)h Ft(")p Fi(\015oat)p Ft(")p Fi(\).)427 3803 y(The)33
b(storage)f(order)f(of)j(data)e(within)i(this)g(arra)n(y)c(should)j(b)r
(e)h(suc)n(h)f(that)g(the)h(index)f(of)g(the)g(\014rst)g(grid)427
-3366 y(dimension)23 b(v)-5 b(aries)22 b(most)h(rapidly)f(and)h(that)g
+3902 y(dimension)23 b(v)-5 b(aries)22 b(most)h(rapidly)f(and)h(that)g
(of)g(the)h(\014nal)f(dimension)g(least)f(rapidly)g(\(i.e.)36
-b(F)-7 b(ortran)22 b(arra)n(y)427 3465 y(indexing)28
-b(is)f(used\).)259 3599 y Fd(in)p Ft(_)p Fd(v)-5 b(ar)427
-3698 y Fi(An)25 b(optional)e(p)r(oin)n(ter)h(to)g(a)f(second)h(arra)n
+b(F)-7 b(ortran)22 b(arra)n(y)427 4002 y(indexing)28
+b(is)f(used\).)259 4134 y Fd(in)p Ft(_)p Fd(v)-5 b(ar)427
+4233 y Fi(An)25 b(optional)e(p)r(oin)n(ter)h(to)g(a)f(second)h(arra)n
(y)e(with)i(the)h(same)e(size)h(and)g(t)n(yp)r(e)g(as)f(the)i
Ft(")p Fi(in)p Ft(")e Fi(arra)n(y)-7 b(.)34 b(If)24 b(giv)n(en,)427
-3798 y(this)32 b(should)g(con)n(tain)f(a)g(set)h(of)g(non-negativ)n(e)e
+4333 y(this)32 b(should)g(con)n(tain)f(a)g(set)h(of)g(non-negativ)n(e)e
(v)-5 b(alues)31 b(whic)n(h)h(represen)n(t)f(estimates)g(of)h(the)g
-(statistical)427 3898 y(v)-5 b(ariance)32 b(asso)r(ciated)f(with)i(eac)
+(statistical)427 4433 y(v)-5 b(ariance)32 b(asso)r(ciated)f(with)i(eac)
n(h)f(elemen)n(t)g(of)h(the)g Ft(")p Fi(in)p Ft(")f Fi(arra)n(y)-7
b(.)49 b(If)33 b(this)g(arra)n(y)d(is)i(supplied)h(\(together)427
-3997 y(with)k(the)f(corresp)r(onding)e Ft(")p Fi(out)p
+4532 y(with)k(the)f(corresp)r(onding)e Ft(")p Fi(out)p
Ft(_)p Fi(v)-5 b(ar)p Ft(")34 b Fi(arra)n(y\),)i(then)h(estimates)e(of)
h(the)g(v)-5 b(ariance)35 b(of)h(the)g(resampled)427
-4097 y(output)28 b(data)g(will)f(b)r(e)h(calculated.)427
-4213 y(If)g(no)g(input)g(v)-5 b(ariance)26 b(estimates)i(are)e(b)r
+4632 y(output)28 b(data)g(will)f(b)r(e)h(calculated.)427
+4748 y(If)g(no)g(input)g(v)-5 b(ariance)26 b(estimates)i(are)e(b)r
(eing)i(pro)n(vided,)f(a)g(NULL)h(p)r(oin)n(ter)f(should)g(b)r(e)h(giv)
-n(en.)259 4347 y Fd(in)m(terp)427 4447 y Fi(This)j(parameter)f(sp)r
+n(en.)259 4880 y Fd(in)m(terp)427 4979 y Fi(This)j(parameter)f(sp)r
(eci\014es)h(the)g(sc)n(heme)f(to)h(b)r(e)h(used)f(for)f(sub-pixel)h
-(in)n(terp)r(olation)f(within)h(the)h(input)427 4546
+(in)n(terp)r(olation)f(within)h(the)h(input)427 5079
y(grid.)62 b(It)36 b(ma)n(y)f(b)r(e)i(used)f(to)f(select)h(from)g(a)f
(set)h(of)g(pre-de\014ned)g(sc)n(hemes)f(b)n(y)h(supplying)g(one)f(of)h
-(the)427 4646 y(v)-5 b(alues)31 b(describ)r(ed)f(in)i(the)f
+(the)427 5179 y(v)-5 b(alues)31 b(describ)r(ed)f(in)i(the)f
Ft(")p Fi(Sub-Pixel)f(In)n(terp)r(olation)g(Sc)n(hemes)p
Ft(")g Fi(section)g(b)r(elo)n(w.)46 b(If)32 b(a)e(v)-5
-b(alue)31 b(of)g(zero)427 4745 y(is)d(supplied,)h(then)f(the)g(default)
+b(alue)31 b(of)g(zero)427 5278 y(is)d(supplied,)h(then)f(the)g(default)
h(linear)e(in)n(terp)r(olation)g(sc)n(heme)h(is)g(used)g(\(equiv)-5
-b(alen)n(t)28 b(to)f(supplying)h(the)427 4845 y(v)-5
-b(alue)28 b(AST)p Ft(__)p Fi(LINEAR\).)427 4962 y(Alternativ)n(ely)-7
+b(alen)n(t)28 b(to)f(supplying)h(the)427 5378 y(v)-5
+b(alue)28 b(AST)p Ft(__)p Fi(LINEAR\).)427 5494 y(Alternativ)n(ely)-7
b(,)22 b(y)n(ou)f(ma)n(y)g(supply)g(a)g(v)-5 b(alue)21
b(whic)n(h)h(indicates)f(that)h(y)n(ou)e(will)i(pro)n(vide)e(y)n(our)g
-(o)n(wn)h(function)427 5061 y(to)h(p)r(erform)f(sub-pixel)g(in)n(terp)r
+(o)n(wn)h(function)427 5593 y(to)h(p)r(erform)f(sub-pixel)g(in)n(terp)r
(olation)g(b)n(y)g(means)g(of)h(the)g Ft(")p Fi(\014n)n(terp)f
Ft(")g Fi(parameter.)33 b(Again,)23 b(see)e(the)h Ft(")p
-Fi(Sub-)427 5161 y(Pixel)27 b(In)n(terp)r(olation)g(Sc)n(hemes)p
-Ft(")g Fi(section)g(b)r(elo)n(w)g(for)g(details.)259
-5295 y Fd(\014n)m(terp)427 5394 y Fi(If)22 b(the)f(v)-5
-b(alue)21 b(giv)n(en)g(for)f(the)i Ft(")p Fi(in)n(terp)p
-Ft(")e Fi(parameter)g(indicates)h(that)g(y)n(ou)f(will)i(pro)n(vide)e
-(y)n(our)g(o)n(wn)g(function)427 5494 y(for)28 b(sub-pixel)g(in)n(terp)
-r(olation,)g(then)h(a)f(p)r(oin)n(ter)g(to)h(that)f(function)h(should)g
-(b)r(e)f(giv)n(en)g(here.)39 b(F)-7 b(or)28 b(details)427
-5593 y(of)f(the)h(in)n(terface)e(whic)n(h)i(the)f(function)h(should)f
-(ha)n(v)n(e)f(\(sev)n(eral)g(are)g(p)r(ossible,)h(dep)r(ending)g(on)g
-(the)h(v)-5 b(alue)427 5693 y(of)28 b Ft(")p Fi(in)n(terp)p
-Ft(")p Fi(\),)f(see)g(the)h Ft(")p Fi(Sub-Pixel)f(In)n(terp)r(olation)f
-(Sc)n(hemes)p Ft(")h Fi(section)g(b)r(elo)n(w.)p eop
+Fi(Sub-)427 5693 y(Pixel)27 b(In)n(terp)r(olation)g(Sc)n(hemes)p
+Ft(")g Fi(section)g(b)r(elo)n(w)g(for)g(details.)p eop
end
-%%Page: 345 355
-TeXDict begin 345 354 bop 3643 52 a FF(345)427 351 y
-Fi(If)28 b(the)f Ft(")p Fi(in)n(terp)p Ft(")f Fi(parameter)f(has)h(an)n
-(y)g(other)h(v)-5 b(alue,)27 b(corresp)r(onding)e(to)h(one)h(of)g(the)g
-(pre-de\014ned)f(in)n(ter-)427 451 y(p)r(olation)h(sc)n(hemes,)g(then)h
-(this)g(function)h(will)e(not)h(b)r(e)g(used)g(and)f(y)n(ou)g(ma)n(y)g
-(supply)g(a)h(NULL)g(p)r(oin)n(ter.)259 588 y Fd(params)427
-688 y Fi(An)36 b(optional)e(p)r(oin)n(ter)h(to)g(an)g(arra)n(y)e(of)i
+%%Page: 346 356
+TeXDict begin 346 355 bop 0 52 a FF(346)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(\014n)m(terp)427
+451 y Fi(If)22 b(the)f(v)-5 b(alue)21 b(giv)n(en)g(for)f(the)i
+Ft(")p Fi(in)n(terp)p Ft(")e Fi(parameter)g(indicates)h(that)g(y)n(ou)f
+(will)i(pro)n(vide)e(y)n(our)g(o)n(wn)g(function)427
+551 y(for)28 b(sub-pixel)g(in)n(terp)r(olation,)g(then)h(a)f(p)r(oin)n
+(ter)g(to)h(that)f(function)h(should)g(b)r(e)f(giv)n(en)g(here.)39
+b(F)-7 b(or)28 b(details)427 650 y(of)f(the)h(in)n(terface)e(whic)n(h)i
+(the)f(function)h(should)f(ha)n(v)n(e)f(\(sev)n(eral)g(are)g(p)r
+(ossible,)h(dep)r(ending)g(on)g(the)h(v)-5 b(alue)427
+750 y(of)28 b Ft(")p Fi(in)n(terp)p Ft(")p Fi(\),)f(see)g(the)h
+Ft(")p Fi(Sub-Pixel)f(In)n(terp)r(olation)f(Sc)n(hemes)p
+Ft(")h Fi(section)g(b)r(elo)n(w.)427 869 y(If)h(the)f
+Ft(")p Fi(in)n(terp)p Ft(")f Fi(parameter)f(has)h(an)n(y)g(other)h(v)-5
+b(alue,)27 b(corresp)r(onding)e(to)h(one)h(of)g(the)g(pre-de\014ned)f
+(in)n(ter-)427 969 y(p)r(olation)h(sc)n(hemes,)g(then)h(this)g
+(function)h(will)e(not)h(b)r(e)g(used)g(and)f(y)n(ou)g(ma)n(y)g(supply)
+g(a)h(NULL)g(p)r(oin)n(ter.)259 1109 y Fd(params)427
+1208 y Fi(An)36 b(optional)e(p)r(oin)n(ter)h(to)g(an)g(arra)n(y)e(of)i
(double)g(whic)n(h)h(should)e(con)n(tain)h(an)n(y)f(additional)h
-(parameter)427 788 y(v)-5 b(alues)30 b(required)f(b)n(y)h(the)h
+(parameter)427 1308 y(v)-5 b(alues)30 b(required)f(b)n(y)h(the)h
(sub-pixel)e(in)n(terp)r(olation)h(sc)n(heme.)44 b(If)30
-b(suc)n(h)g(parameters)e(are)h(required,)h(this)427 887
+b(suc)n(h)g(parameters)e(are)h(required,)h(this)427 1408
y(will)d(b)r(e)h(noted)f(in)g(the)g Ft(")p Fi(Sub-Pixel)f(In)n(terp)r
(olation)g(Sc)n(hemes)p Ft(")h Fi(section)f(b)r(elo)n(w)h(\(y)n(ou)f
-(ma)n(y)h(also)e(use)i(this)427 987 y(arra)n(y)f(to)h(pass)g(v)-5
+(ma)n(y)h(also)e(use)i(this)427 1507 y(arra)n(y)f(to)h(pass)g(v)-5
b(alues)27 b(to)g(y)n(our)g(o)n(wn)g(in)n(terp)r(olation)g(function\).)
-427 1106 y(If)i(no)e(additional)h(parameters)e(are)h(required,)g(this)i
+427 1627 y(If)i(no)e(additional)h(parameters)e(are)h(required,)g(this)i
(arra)n(y)c(is)j(not)g(used)g(and)g(a)g(NULL)g(p)r(oin)n(ter)g(ma)n(y)f
-(b)r(e)427 1205 y(giv)n(en.)259 1343 y Fd(\015ags)427
-1442 y Fi(The)i(bit)n(wise)g(OR)f(of)h(a)f(set)h(of)f(\015ag)g(v)-5
+(b)r(e)427 1726 y(giv)n(en.)259 1866 y Fd(\015ags)427
+1966 y Fi(The)i(bit)n(wise)g(OR)f(of)h(a)f(set)h(of)f(\015ag)g(v)-5
b(alues)29 b(whic)n(h)f(ma)n(y)g(b)r(e)h(used)g(to)f(pro)n(vide)g
-(additional)g(con)n(trol)f(o)n(v)n(er)427 1542 y(the)38
+(additional)g(con)n(trol)f(o)n(v)n(er)427 2065 y(the)38
b(resampling)d(op)r(eration.)64 b(See)37 b(the)h Ft(")p
Fi(Con)n(trol)d(Flags)p Ft(")h Fi(section)g(b)r(elo)n(w)h(for)f(a)h
-(description)f(of)h(the)427 1642 y(options)27 b(a)n(v)-5
+(description)f(of)h(the)427 2165 y(options)27 b(a)n(v)-5
b(ailable.)36 b(If)28 b(no)f(\015ag)g(v)-5 b(alues)27
b(are)g(to)g(b)r(e)h(set,)g(a)f(v)-5 b(alue)28 b(of)f(zero)g(should)g
-(b)r(e)h(giv)n(en.)259 1779 y Fd(tol)427 1879 y Fi(The)34
+(b)r(e)h(giv)n(en.)259 2305 y Fd(tol)427 2404 y Fi(The)34
b(maxim)n(um)f(tolerable)f(geometrical)f(distortion)i(whic)n(h)g(ma)n
(y)f(b)r(e)i(in)n(tro)r(duced)f(as)f(a)h(result)g(of)g(ap-)427
-1978 y(pro)n(ximating)c(non-linear)f(Mappings)h(b)n(y)h(a)f(set)h(of)g
+2504 y(pro)n(ximating)c(non-linear)f(Mappings)h(b)n(y)h(a)f(set)h(of)g
(piece-wise)f(linear)g(transformations.)42 b(This)30
-b(should)427 2078 y(b)r(e)e(expressed)f(as)g(a)g(displacemen)n(t)g(in)h
+b(should)427 2604 y(b)r(e)e(expressed)f(as)g(a)g(displacemen)n(t)g(in)h
(pixels)f(in)h(the)g(input)h(grid's)d(co)r(ordinate)h(system.)427
-2197 y(If)34 b(piece-wise)f(linear)g(appro)n(ximation)f(is)h(not)h
+2723 y(If)34 b(piece-wise)f(linear)g(appro)n(ximation)f(is)h(not)h
(required,)g(a)f(v)-5 b(alue)33 b(of)h(zero)e(ma)n(y)h(b)r(e)h(giv)n
-(en.)54 b(This)33 b(will)427 2296 y(ensure)k(that)g(the)h(Mapping)e(is)
+(en.)54 b(This)33 b(will)427 2823 y(ensure)k(that)g(the)h(Mapping)e(is)
h(used)g(without)h(an)n(y)e(appro)n(ximation,)i(but)g(ma)n(y)e
-(increase)g(execution)427 2396 y(time.)259 2533 y Fd(maxpix)427
-2633 y Fi(A)42 b(v)-5 b(alue)40 b(whic)n(h)h(sp)r(eci\014es)g(an)g
+(increase)g(execution)427 2923 y(time.)259 3062 y Fd(maxpix)427
+3162 y Fi(A)42 b(v)-5 b(alue)40 b(whic)n(h)h(sp)r(eci\014es)g(an)g
(initial)g(scale)g(size)f(\(in)i(pixels\))f(for)f(the)i(adaptiv)n(e)e
-(algorithm)g(whic)n(h)427 2733 y(appro)n(ximates)d(non-linear)g
+(algorithm)g(whic)n(h)427 3261 y(appro)n(ximates)d(non-linear)g
(Mappings)h(with)h(piece-wise)f(linear)g(transformations.)68
-b(Normally)-7 b(,)40 b(this)427 2832 y(should)35 b(b)r(e)g(a)f(large)g
+b(Normally)-7 b(,)40 b(this)427 3361 y(should)35 b(b)r(e)g(a)f(large)g
(v)-5 b(alue)34 b(\(larger)f(than)i(an)n(y)f(dimension)h(of)g(the)g
-(region)e(of)i(the)g(output)g(grid)g(b)r(eing)427 2932
+(region)e(of)i(the)g(output)g(grid)g(b)r(eing)427 3461
y(used\).)46 b(In)31 b(this)g(case,)g(a)f(\014rst)g(attempt)h(to)g
(appro)n(ximate)e(the)i(Mapping)f(b)n(y)g(a)g(linear)g(transformation)
-427 3032 y(will)e(b)r(e)g(made)f(o)n(v)n(er)f(the)i(en)n(tire)f(output)
-i(region.)427 3150 y(If)h(a)f(smaller)f(v)-5 b(alue)29
+427 3560 y(will)e(b)r(e)g(made)f(o)n(v)n(er)f(the)i(en)n(tire)f(output)
+i(region.)427 3680 y(If)h(a)f(smaller)f(v)-5 b(alue)29
b(is)g(used,)h(the)g(output)f(region)f(will)i(\014rst)f(b)r(e)g
-(divided)h(in)n(to)f(sub-regions)e(whose)i(size)427 3250
+(divided)h(in)n(to)f(sub-regions)e(whose)i(size)427 3780
y(do)r(es)39 b(not)h(exceed)f Ft(")p Fi(maxpix)p Ft(")f
Fi(pixels)i(in)g(an)n(y)e(dimension.)73 b(Only)39 b(at)g(this)h(p)r
-(oin)n(t)g(will)g(attempts)g(at)427 3349 y(appro)n(ximation)26
-b(commence.)427 3468 y(This)38 b(v)-5 b(alue)38 b(ma)n(y)g(o)r
+(oin)n(t)g(will)g(attempts)g(at)427 3879 y(appro)n(ximation)26
+b(commence.)427 3999 y(This)38 b(v)-5 b(alue)38 b(ma)n(y)g(o)r
(ccasionally)e(b)r(e)j(useful)f(in)h(prev)n(en)n(ting)e(false)h(con)n
-(v)n(ergence)d(of)j(the)h(adaptiv)n(e)e(al-)427 3568
+(v)n(ergence)d(of)j(the)h(adaptiv)n(e)e(al-)427 4098
y(gorithm)c(in)g(cases)f(where)g(the)h(Mapping)g(app)r(ears)f(appro)n
(ximately)f(linear)h(on)h(large)e(scales,)j(but)f(has)427
-3667 y(irregularities)27 b(\(e.g.)40 b(holes\))28 b(on)g(smaller)g
+4198 y(irregularities)27 b(\(e.g.)40 b(holes\))28 b(on)g(smaller)g
(scales.)39 b(A)29 b(v)-5 b(alue)28 b(of,)h(sa)n(y)-7
b(,)28 b(50)g(to)g(100)g(pixels)g(can)g(also)g(b)r(e)h(em-)427
-3767 y(plo)n(y)n(ed)23 b(as)f(a)h(safeguard)f(in)i(general-purp)r(ose)d
+4298 y(plo)n(y)n(ed)23 b(as)f(a)h(safeguard)f(in)i(general-purp)r(ose)d
(soft)n(w)n(are,)i(since)g(the)h(e\013ect)f(on)h(p)r(erformance)e(is)h
-(minimal.)427 3886 y(If)e(to)r(o)f(small)g(a)g(v)-5 b(alue)20
+(minimal.)427 4417 y(If)e(to)r(o)f(small)g(a)g(v)-5 b(alue)20
b(is)g(giv)n(en,)h(it)g(will)f(ha)n(v)n(e)f(the)i(e\013ect)g(of)f
(inhibiting)h(linear)f(appro)n(ximation)e(altogether)427
-3985 y(\(equiv)-5 b(alen)n(t)20 b(to)g(setting)g Ft(")p
+4517 y(\(equiv)-5 b(alen)n(t)20 b(to)g(setting)g Ft(")p
Fi(tol)p Ft(")f Fi(to)g(zero\).)34 b(Although)20 b(this)g(ma)n(y)f
-(degrade)f(p)r(erformance,)j(accurate)d(results)427 4085
-y(will)28 b(still)g(b)r(e)g(obtained.)259 4222 y Fd(badv)-5
-b(al)427 4322 y Fi(This)29 b(argumen)n(t)f(should)h(ha)n(v)n(e)e(the)j
+(degrade)f(p)r(erformance,)j(accurate)d(results)427 4617
+y(will)28 b(still)g(b)r(e)g(obtained.)259 4756 y Fd(badv)-5
+b(al)427 4856 y Fi(This)29 b(argumen)n(t)f(should)h(ha)n(v)n(e)e(the)j
(same)e(t)n(yp)r(e)h(as)f(the)i(elemen)n(ts)e(of)h(the)g
Ft(")p Fi(in)p Ft(")g Fi(arra)n(y)-7 b(.)38 b(It)29 b(sp)r(eci\014es)g
-(the)427 4422 y(v)-5 b(alue)28 b(used)f(to)h(\015ag)f(missing)g(data)g
+(the)427 4956 y(v)-5 b(alue)28 b(used)f(to)h(\015ag)f(missing)g(data)g
(\(bad)h(pixels\))f(in)h(the)g(input)g(and)g(output)g(arra)n(ys.)427
-4540 y(If)33 b(the)f(AST)p Ft(__)p Fi(USEBAD)g(\015ag)g(is)g(set)g(via)
+5075 y(If)33 b(the)f(AST)p Ft(__)p Fi(USEBAD)g(\015ag)g(is)g(set)g(via)
g(the)g Ft(")p Fi(\015ags)p Ft(")e Fi(parameter,)i(then)h(this)f(v)-5
-b(alue)32 b(is)g(used)g(to)g(test)427 4640 y(for)27 b(bad)h(pixels)f
+b(alue)32 b(is)g(used)g(to)g(test)427 5175 y(for)27 b(bad)h(pixels)f
(in)h(the)g Ft(")p Fi(in)p Ft(")f Fi(\(and)h Ft(")p Fi(in)p
Ft(_)p Fi(v)-5 b(ar)p Ft(")p Fi(\))26 b(arra)n(y\(s\).)427
-4758 y(Unless)36 b(the)f(AST)p Ft(__)p Fi(NOBAD)g(\015ag)g(is)g(set)g
+5295 y(Unless)36 b(the)f(AST)p Ft(__)p Fi(NOBAD)g(\015ag)g(is)g(set)g
(via)g(the)h Ft(")p Fi(\015ags)p Ft(")d Fi(parameter,)j(this)g(v)-5
-b(alue)35 b(is)g(also)f(used)i(to)427 4858 y(\015ag)30
+b(alue)35 b(is)g(also)f(used)i(to)427 5394 y(\015ag)30
b(an)n(y)h(output)g(elemen)n(ts)g(in)g(the)g Ft(")p Fi(out)p
Ft(")f Fi(\(and)i Ft(")p Fi(out)p Ft(_)p Fi(v)-5 b(ar)p
Ft(")p Fi(\))29 b(arra)n(y\(s\))g(for)h(whic)n(h)h(resampled)f(v)-5
-b(alues)427 4958 y(could)34 b(not)g(b)r(e)g(obtained)f(\(see)h(the)g
+b(alues)427 5494 y(could)34 b(not)g(b)r(e)g(obtained)f(\(see)h(the)g
Ft(")p Fi(Propagation)d(of)j(Missing)f(Data)p Ft(")g
-Fi(section)g(b)r(elo)n(w)h(for)f(details)h(of)427 5057
+Fi(section)g(b)r(elo)n(w)h(for)f(details)h(of)427 5593
y(the)25 b(circumstances)e(under)h(whic)n(h)g(this)h(ma)n(y)e(o)r
(ccur\).)35 b(The)25 b(astResample)p Fk(<)p Fi(X)p Fk(>)d
-Fi(function)j(return)f(v)-5 b(alue)427 5157 y(indicates)36
+Fi(function)j(return)f(v)-5 b(alue)427 5693 y(indicates)36
b(whether)g(an)n(y)g(suc)n(h)f(v)-5 b(alues)36 b(ha)n(v)n(e)f(b)r(een)i
(pro)r(duced.)62 b(If)37 b(the)f(AST)p Ft(__)p Fi(NOBAD)g(\015ag)g(is)g
-(set.)427 5257 y(then)25 b(output)f(arra)n(y)e(elemen)n(ts)i(for)f
-(whic)n(h)h(no)f(resampled)g(v)-5 b(alue)24 b(could)g(b)r(e)g(obtained)
-g(are)f(left)h(set)g(to)g(the)427 5356 y(v)-5 b(alue)28
-b(they)g(had)f(on)g(en)n(try)g(to)h(this)g(function.)259
-5494 y Fd(ndim)p Ft(_)p Fd(out)427 5593 y Fi(The)38 b(n)n(um)n(b)r(er)f
-(of)g(dimensions)g(in)h(the)f(output)h(grid.)66 b(This)37
-b(should)g(b)r(e)h(at)f(least)g(one.)65 b(It)38 b(need)g(not)427
-5693 y(necessarily)26 b(b)r(e)i(equal)f(to)h(the)g(n)n(um)n(b)r(er)f
-(of)h(dimensions)f(in)h(the)g(input)g(grid.)p eop end
-%%Page: 346 356
-TeXDict begin 346 355 bop 0 52 a FF(346)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(lbnd)p
-Ft(_)p Fd(out)427 451 y Fi(P)n(oin)n(ter)25 b(to)i(an)f(arra)n(y)f(of)i
-(in)n(tegers,)e(with)j Ft(")p Fi(ndim)p Ft(_)p Fi(out)p
-Ft(")e Fi(elemen)n(ts,)g(con)n(taining)g(the)h(co)r(ordinates)f(of)g
-(the)427 551 y(cen)n(tre)h(of)h(the)g(\014rst)f(pixel)h(in)g(the)g
-(output)g(grid)f(along)f(eac)n(h)h(dimension.)259 681
-y Fd(ubnd)p Ft(_)p Fd(out)427 781 y Fi(P)n(oin)n(ter)e(to)i(an)f(arra)n
-(y)f(of)i(in)n(tegers,)e(with)j Ft(")p Fi(ndim)p Ft(_)p
-Fi(out)p Ft(")e Fi(elemen)n(ts,)g(con)n(taining)g(the)h(co)r(ordinates)
-f(of)g(the)427 880 y(cen)n(tre)h(of)h(the)g(last)f(pixel)h(in)g(the)g
-(output)g(grid)f(along)f(eac)n(h)h(dimension.)427 996
-y(Note)e(that)g Ft(")p Fi(lbnd)p Ft(_)p Fi(out)p Ft(")f
-Fi(and)g Ft(")p Fi(ubnd)p Ft(_)p Fi(out)p Ft(")g Fi(together)g
-(de\014ne)h(the)g(shap)r(e,)g(size)g(and)f(co)r(ordinate)g(system)427
-1095 y(of)32 b(the)f(output)h(grid)f(in)g(the)h(same)f(w)n(a)n(y)f(as)h
-Ft(")p Fi(lbnd)p Ft(_)p Fi(in)p Ft(")f Fi(and)i Ft(")p
-Fi(ubnd)p Ft(_)p Fi(in)p Ft(")e Fi(de\014ne)i(the)g(shap)r(e,)g(size)f
-(and)427 1195 y(co)r(ordinate)c(system)g(of)h(the)g(input)g(grid.)259
-1325 y Fd(lbnd)427 1425 y Fi(P)n(oin)n(ter)d(to)i(an)f(arra)n(y)f(of)i
-(in)n(tegers,)e(with)j Ft(")p Fi(ndim)p Ft(_)p Fi(out)p
-Ft(")e Fi(elemen)n(ts,)g(con)n(taining)g(the)h(co)r(ordinates)f(of)g
-(the)427 1525 y(\014rst)i(pixel)f(in)h(the)g(region)e(of)i(the)g
-(output)g(grid)f(for)g(whic)n(h)h(a)f(resampled)f(v)-5
-b(alue)28 b(is)f(to)h(b)r(e)g(calculated.)259 1655 y
-Fd(ubnd)427 1755 y Fi(P)n(oin)n(ter)d(to)i(an)f(arra)n(y)f(of)i(in)n
+(set.)p eop end
+%%Page: 347 357
+TeXDict begin 347 356 bop 3643 52 a FF(347)427 351 y
+Fi(then)25 b(output)f(arra)n(y)e(elemen)n(ts)i(for)f(whic)n(h)h(no)f
+(resampled)g(v)-5 b(alue)24 b(could)g(b)r(e)g(obtained)g(are)f(left)h
+(set)g(to)g(the)427 451 y(v)-5 b(alue)28 b(they)g(had)f(on)g(en)n(try)g
+(to)h(this)g(function.)259 582 y Fd(ndim)p Ft(_)p Fd(out)427
+682 y Fi(The)38 b(n)n(um)n(b)r(er)f(of)g(dimensions)g(in)h(the)f
+(output)h(grid.)66 b(This)37 b(should)g(b)r(e)h(at)f(least)g(one.)65
+b(It)38 b(need)g(not)427 781 y(necessarily)26 b(b)r(e)i(equal)f(to)h
+(the)g(n)n(um)n(b)r(er)f(of)h(dimensions)f(in)h(the)g(input)g(grid.)259
+912 y Fd(lbnd)p Ft(_)p Fd(out)427 1012 y Fi(P)n(oin)n(ter)d(to)i(an)f
+(arra)n(y)f(of)i(in)n(tegers,)e(with)j Ft(")p Fi(ndim)p
+Ft(_)p Fi(out)p Ft(")e Fi(elemen)n(ts,)g(con)n(taining)g(the)h(co)r
+(ordinates)f(of)g(the)427 1112 y(cen)n(tre)h(of)h(the)g(\014rst)f
+(pixel)h(in)g(the)g(output)g(grid)f(along)f(eac)n(h)h(dimension.)259
+1243 y Fd(ubnd)p Ft(_)p Fd(out)427 1342 y Fi(P)n(oin)n(ter)e(to)i(an)f
+(arra)n(y)f(of)i(in)n(tegers,)e(with)j Ft(")p Fi(ndim)p
+Ft(_)p Fi(out)p Ft(")e Fi(elemen)n(ts,)g(con)n(taining)g(the)h(co)r
+(ordinates)f(of)g(the)427 1442 y(cen)n(tre)h(of)h(the)g(last)f(pixel)h
+(in)g(the)g(output)g(grid)f(along)f(eac)n(h)h(dimension.)427
+1557 y(Note)e(that)g Ft(")p Fi(lbnd)p Ft(_)p Fi(out)p
+Ft(")f Fi(and)g Ft(")p Fi(ubnd)p Ft(_)p Fi(out)p Ft(")g
+Fi(together)g(de\014ne)h(the)g(shap)r(e,)g(size)g(and)f(co)r(ordinate)g
+(system)427 1657 y(of)32 b(the)f(output)h(grid)f(in)g(the)h(same)f(w)n
+(a)n(y)f(as)h Ft(")p Fi(lbnd)p Ft(_)p Fi(in)p Ft(")f
+Fi(and)i Ft(")p Fi(ubnd)p Ft(_)p Fi(in)p Ft(")e Fi(de\014ne)i(the)g
+(shap)r(e,)g(size)f(and)427 1756 y(co)r(ordinate)c(system)g(of)h(the)g
+(input)g(grid.)259 1888 y Fd(lbnd)427 1987 y Fi(P)n(oin)n(ter)d(to)i
+(an)f(arra)n(y)f(of)i(in)n(tegers,)e(with)j Ft(")p Fi(ndim)p
+Ft(_)p Fi(out)p Ft(")e Fi(elemen)n(ts,)g(con)n(taining)g(the)h(co)r
+(ordinates)f(of)g(the)427 2087 y(\014rst)i(pixel)f(in)h(the)g(region)e
+(of)i(the)g(output)g(grid)f(for)g(whic)n(h)h(a)f(resampled)f(v)-5
+b(alue)28 b(is)f(to)h(b)r(e)g(calculated.)259 2218 y
+Fd(ubnd)427 2318 y Fi(P)n(oin)n(ter)d(to)i(an)f(arra)n(y)f(of)i(in)n
(tegers,)e(with)j Ft(")p Fi(ndim)p Ft(_)p Fi(out)p Ft(")e
Fi(elemen)n(ts,)g(con)n(taining)g(the)h(co)r(ordinates)f(of)g(the)427
-1855 y(last)i(pixel)f(in)h(the)g(region)e(of)i(the)g(output)g(grid)f
+2417 y(last)i(pixel)f(in)h(the)g(region)e(of)i(the)g(output)g(grid)f
(for)g(whic)n(h)g(a)h(resampled)e(v)-5 b(alue)28 b(is)f(to)h(b)r(e)g
-(calculated.)427 1970 y(Note)23 b(that)h Ft(")p Fi(lbnd)p
+(calculated.)427 2532 y(Note)23 b(that)h Ft(")p Fi(lbnd)p
Ft(")e Fi(and)h Ft(")p Fi(ubnd)p Ft(")g Fi(together)f(de\014ne)h(the)h
(shap)r(e)f(and)f(p)r(osition)h(of)g(a)g(\(h)n(yp)r(er-\)rectangular)
-427 2069 y(region)h(of)i(the)g(output)g(grid)f(for)g(whic)n(h)g
+427 2632 y(region)h(of)i(the)g(output)g(grid)f(for)g(whic)n(h)g
(resampled)g(v)-5 b(alues)25 b(should)g(b)r(e)h(pro)r(duced.)36
-b(This)26 b(region)e(should)427 2169 y(lie)f(wholly)f(within)i(the)f
+b(This)26 b(region)e(should)427 2732 y(lie)f(wholly)f(within)i(the)f
(exten)n(t)f(of)h(the)g(output)g(grid)f(\(as)h(de\014ned)g(b)n(y)f(the)
h Ft(")p Fi(lbnd)p Ft(_)p Fi(out)p Ft(")f Fi(and)g Ft(")p
-Fi(ubnd)p Ft(_)p Fi(out)p Ft(")427 2269 y Fi(arra)n(ys\).)35
+Fi(ubnd)p Ft(_)p Fi(out)p Ft(")427 2831 y Fi(arra)n(ys\).)35
b(Regions)26 b(of)i(the)g(output)g(grid)f(lying)g(outside)h(this)g
-(region)e(will)i(not)f(b)r(e)h(mo)r(di\014ed.)259 2399
-y Fd(out)427 2499 y Fi(P)n(oin)n(ter)40 b(to)g(an)h(arra)n(y)-7
+(region)e(will)i(not)f(b)r(e)h(mo)r(di\014ed.)259 2962
+y Fd(out)427 3062 y Fi(P)n(oin)n(ter)40 b(to)g(an)h(arra)n(y)-7
b(,)42 b(with)g(one)e(elemen)n(t)h(for)g(eac)n(h)f(pixel)h(in)g(the)g
-(output)h(grid,)i(in)n(to)c(whic)n(h)h(the)427 2599 y(resampled)27
+(output)h(grid,)i(in)n(to)c(whic)n(h)h(the)427 3162 y(resampled)27
b(data)h(v)-5 b(alues)27 b(will)h(b)r(e)h(returned.)37
b(The)28 b(n)n(umerical)f(t)n(yp)r(e)h(of)g(this)g(arra)n(y)e(should)i
-(matc)n(h)f(that)427 2698 y(of)j(the)g Ft(")p Fi(in)p
+(matc)n(h)f(that)427 3261 y(of)j(the)g Ft(")p Fi(in)p
Ft(")f Fi(arra)n(y)-7 b(,)28 b(and)h(the)i(data)e(storage)e(order)i
(should)g(b)r(e)h(suc)n(h)g(that)f(the)h(index)g(of)g(the)g(\014rst)f
-(grid)427 2798 y(dimension)23 b(v)-5 b(aries)22 b(most)h(rapidly)f(and)
+(grid)427 3361 y(dimension)23 b(v)-5 b(aries)22 b(most)h(rapidly)f(and)
h(that)g(of)g(the)h(\014nal)f(dimension)g(least)f(rapidly)g(\(i.e.)36
-b(F)-7 b(ortran)22 b(arra)n(y)427 2897 y(indexing)28
-b(is)f(used\).)259 3028 y Fd(out)p Ft(_)p Fd(v)-5 b(ar)427
-3128 y Fi(An)25 b(optional)f(p)r(oin)n(ter)g(to)h(an)f(arra)n(y)e(with)
+b(F)-7 b(ortran)22 b(arra)n(y)427 3461 y(indexing)28
+b(is)f(used\).)259 3592 y Fd(out)p Ft(_)p Fd(v)-5 b(ar)427
+3691 y Fi(An)25 b(optional)f(p)r(oin)n(ter)g(to)h(an)f(arra)n(y)e(with)
j(the)g(same)f(t)n(yp)r(e)h(and)f(size)h(as)f(the)h Ft(")p
Fi(out)p Ft(")e Fi(arra)n(y)-7 b(.)34 b(If)25 b(giv)n(en,)f(this)427
-3227 y(arra)n(y)f(will)i(b)r(e)g(used)g(to)g(return)g(v)-5
+3791 y(arra)n(y)f(will)i(b)r(e)g(used)g(to)g(return)g(v)-5
b(ariance)23 b(estimates)i(for)f(the)i(resampled)e(data)g(v)-5
-b(alues.)36 b(This)25 b(arra)n(y)d(will)427 3327 y(only)27
+b(alues.)36 b(This)25 b(arra)n(y)d(will)427 3891 y(only)27
b(b)r(e)h(used)g(if)g(the)g Ft(")p Fi(in)p Ft(_)p Fi(v)-5
b(ar)p Ft(")26 b Fi(arra)n(y)f(has)i(also)g(b)r(een)h(supplied.)427
-3442 y(The)23 b(output)f(v)-5 b(ariance)22 b(v)-5 b(alues)21
+4006 y(The)23 b(output)f(v)-5 b(ariance)22 b(v)-5 b(alues)21
b(will)i(b)r(e)g(calculated)e(on)h(the)h(assumption)f(that)g(errors)e
-(on)i(the)h(input)g(data)427 3542 y(v)-5 b(alues)24 b(are)g
+(on)i(the)h(input)g(data)427 4105 y(v)-5 b(alues)24 b(are)g
(statistically)f(indep)r(enden)n(t)i(and)g(that)f(their)g(v)-5
b(ariance)24 b(estimates)g(ma)n(y)f(simply)i(b)r(e)f(summed)427
-3641 y(\(with)30 b(appropriate)d(w)n(eigh)n(ting)g(factors\))h(when)h
+4205 y(\(with)30 b(appropriate)d(w)n(eigh)n(ting)g(factors\))h(when)h
(sev)n(eral)e(input)i(pixels)g(con)n(tribute)f(to)h(an)f(output)h(data)
-427 3741 y(v)-5 b(alue.)59 b(If)35 b(this)g(assumption)f(is)h(not)g(v)
+427 4305 y(v)-5 b(alue.)59 b(If)35 b(this)g(assumption)f(is)h(not)g(v)
-5 b(alid,)36 b(then)f(the)h(output)f(error)e(estimates)h(ma)n(y)g(b)r
-(e)h(biased.)58 b(In)427 3841 y(addition,)31 b(note)f(that)h(the)f
+(e)h(biased.)58 b(In)427 4404 y(addition,)31 b(note)f(that)h(the)f
(statistical)g(errors)e(on)i(neigh)n(b)r(ouring)f(output)h(data)g(v)-5
-b(alues)30 b(\(as)g(w)n(ell)g(as)f(the)427 3940 y(estimates)j(of)f
+b(alues)30 b(\(as)g(w)n(ell)g(as)f(the)427 4504 y(estimates)j(of)f
(those)g(errors\))f(ma)n(y)h(often)h(b)r(e)g(correlated,)f(ev)n(en)g
(if)h(the)g(ab)r(o)n(v)n(e)f(assumption)g(ab)r(out)g(the)427
-4040 y(input)e(data)e(is)g(correct,)g(b)r(ecause)g(of)g(the)h
+4604 y(input)e(data)e(is)g(correct,)g(b)r(ecause)g(of)g(the)h
(sub-pixel)g(in)n(terp)r(olation)e(sc)n(hemes)h(emplo)n(y)n(ed.)427
-4155 y(If)h(no)g(output)g(v)-5 b(ariance)26 b(estimates)h(are)g
+4719 y(If)h(no)g(output)g(v)-5 b(ariance)26 b(estimates)h(are)g
(required,)g(a)g(NULL)h(p)r(oin)n(ter)f(should)g(b)r(e)h(giv)n(en.)0
-4315 y Fd(Returned)k(V)-8 b(alue:)259 4449 y(astResample)p
-Fk(<)p Fd(X)p Fk(>)p Fd(\(\))427 4549 y Fi(The)33 b(n)n(um)n(b)r(er)f
+4879 y Fd(Returned)k(V)-8 b(alue:)259 5014 y(astResample)p
+Fk(<)p Fd(X)p Fk(>)p Fd(\(\))427 5113 y Fi(The)33 b(n)n(um)n(b)r(er)f
(of)g(output)h(pixels)g(for)f(whic)n(h)g(no)g(v)-5 b(alid)33
b(resampled)e(v)-5 b(alue)33 b(could)f(b)r(e)h(obtained.)51
-b(Th)n(us,)427 4648 y(in)33 b(the)g(absence)f(of)h(an)n(y)f(error,)g(a)
+b(Th)n(us,)427 5213 y(in)33 b(the)g(absence)f(of)h(an)n(y)f(error,)g(a)
h(returned)f(v)-5 b(alue)33 b(of)f(zero)g(indicates)h(that)g(all)f(the)
-h(required)f(output)427 4748 y(pixels)j(receiv)n(ed)f(v)-5
+h(required)f(output)427 5313 y(pixels)j(receiv)n(ed)f(v)-5
b(alid)34 b(resampled)g(data)h(v)-5 b(alues)34 b(\(and)h(v)-5
b(ariances\).)57 b(See)35 b(the)g Ft(")p Fi(badv)-5 b(al)p
-Ft(")34 b Fi(and)g Ft(")p Fi(\015ags)p Ft(")427 4848
-y Fi(parameters.)0 5007 y Fd(Notes:)340 5288 y Fh(\017)45
+Ft(")34 b Fi(and)g Ft(")p Fi(\015ags)p Ft(")427 5412
+y Fi(parameters.)0 5572 y Fd(Notes:)p eop end
+%%Page: 348 358
+TeXDict begin 348 357 bop 0 52 a FF(348)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
b Fi(A)27 b(v)-5 b(alue)25 b(of)h(zero)f(will)h(b)r(e)g(returned)g(if)g
(this)g(function)h(is)f(in)n(v)n(ok)n(ed)e(with)j(the)f(global)f(error)
-f(status)h(set,)h(or)427 5387 y(if)i(it)g(should)g(fail)f(for)h(an)n(y)
-e(reason.)-2 5547 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s(des)n(:)227
-5693 y Fi(T)-7 b(o)35 b(select)h(the)g(appropriate)d(resampling)i
+f(status)h(set,)h(or)427 451 y(if)i(it)g(should)g(fail)f(for)h(an)n(y)e
+(reason.)-2 633 y Fd(Data)33 b(T)m(yp)s(e)g(Co)s(des)n(:)227
+779 y Fi(T)-7 b(o)35 b(select)h(the)g(appropriate)d(resampling)i
(function,)j(y)n(ou)c(should)i(replace)e Fk(<)p Fi(X)p
-Fk(>)h Fi(in)h(the)g(generic)e(function)p eop end
-%%Page: 347 357
-TeXDict begin 347 356 bop 3643 52 a FF(347)227 351 y
-Fi(name)24 b(astResample)p Fk(<)p Fi(X)p Fk(>)e Fi(with)i(a)g(1-)f(or)g
-(2-c)n(haracter)d(data)k(t)n(yp)r(e)g(co)r(de,)g(so)f(as)g(to)h(matc)n
-(h)f(the)i(n)n(umerical)d(t)n(yp)r(e)227 451 y Fk(<)p
-Fi(Xt)n(yp)r(e)p Fk(>)27 b Fi(of)h(the)g(data)f(y)n(ou)g(are)g(pro)r
-(cessing,)f(as)h(follo)n(ws:)340 590 y Fh(\017)45 b Fi(D:)28
-b(double)340 724 y Fh(\017)45 b Fi(F:)28 b(\015oat)340
-858 y Fh(\017)45 b Fi(L:)28 b(long)f(in)n(t)h(\(ma)n(y)f(b)r(e)h(32)e
-(or)h(64)g(bit\))340 992 y Fh(\017)45 b Fi(K:)28 b(64)e(bit)i(in)n(t)
-340 1126 y Fh(\017)45 b Fi(UL:)28 b(unsigned)g(long)e(in)n(t)i(\(ma)n
-(y)f(b)r(e)h(32)f(or)g(64)g(bit\))340 1260 y Fh(\017)45
-b Fi(UK:)28 b(unsigned)f(64)g(bit)h(in)n(t)340 1394 y
-Fh(\017)45 b Fi(I:)28 b(in)n(t)340 1528 y Fh(\017)45
-b Fi(UI:)28 b(unsigned)g(in)n(t)340 1662 y Fh(\017)45
-b Fi(S:)28 b(short)f(in)n(t)340 1796 y Fh(\017)45 b Fi(US:)28
-b(unsigned)g(short)f(in)n(t)340 1930 y Fh(\017)45 b Fi(B:)28
-b(b)n(yte)f(\(signed)h(c)n(har\))340 2064 y Fh(\017)45
-b Fi(UB:)28 b(unsigned)f(b)n(yte)h(\(unsigned)g(c)n(har\))227
-2228 y(F)-7 b(or)31 b(example,)h(astResampleD)f(w)n(ould)g(b)r(e)h
-(used)g(to)f(pro)r(cess)f Ft(")p Fi(double)p Ft(")h Fi(data,)h(while)f
-(astResampleS)g(w)n(ould)227 2328 y(b)r(e)d(used)g(to)f(pro)r(cess)g
-Ft(")p Fi(short)f(in)n(t)p Ft(")i Fi(data,)f(etc.)-2
-2480 y Fd(Sub-Pixel)32 b(In)m(terp)s(olation)f(Sc)m(hemes)n(:)227
-2626 y Fi(There)d(is)f(no)h(suc)n(h)f(thing)h(as)g(a)f(p)r(erfect)h
-(sub-pixel)g(in)n(terp)r(olation)f(sc)n(heme)g(and,)h(in)g(practice,)f
-(all)h(resampling)227 2725 y(will)34 b(result)e(in)i(some)e
-(degradation)f(of)i(gridded)g(data.)52 b(A)34 b(range)d(of)i(sc)n
-(hemes)g(is)f(therefore)h(pro)n(vided,)g(from)227 2825
-y(whic)n(h)28 b(y)n(ou)f(can)g(c)n(ho)r(ose)f(the)i(one)f(whic)n(h)h(b)
-r(est)g(suits)g(y)n(our)e(needs.)227 2951 y(In)h(general,)e(a)g
-(balance)h(m)n(ust)g(b)r(e)g(struc)n(k)f(b)r(et)n(w)n(een)i(sc)n(hemes)
-e(whic)n(h)h(tend)g(to)g(degrade)f(sharp)g(features)h(in)g(the)227
-3050 y(data)d(b)n(y)g(smo)r(othing)g(them,)i(and)f(those)f(whic)n(h)g
-(attempt)h(to)g(preserv)n(e)d(sharp)i(features.)35 b(The)24
-b(latter)f(will)g(often)227 3150 y(tend)32 b(to)g(in)n(tro)r(duce)f(un)
-n(w)n(an)n(ted)g(oscillations,)g(t)n(ypically)g(visible)g(as)g
-Ft(")p Fi(ringing)p Ft(")f Fi(around)g(sharp)h(features)g(and)227
-3250 y(edges,)j(esp)r(ecially)f(if)g(the)h(data)e(are)g(under-sampled)h
-(\(i.e.)54 b(if)33 b(the)h(sharp)r(est)e(features)h(are)f(less)g(than)i
-(ab)r(out)227 3349 y(t)n(w)n(o)27 b(pixels)h(across\).)36
-b(In)28 b(practice,)f(a)g(go)r(o)r(d)h(in)n(terp)r(olation)e(sc)n(heme)
-i(is)g(lik)n(ely)f(to)h(b)r(e)g(a)f(compromise)g(and)g(ma)n(y)227
-3449 y(exhibit)h(some)f(asp)r(ects)h(of)f(b)r(oth)h(these)g(features.)
-227 3575 y(F)-7 b(or)31 b(under-sampled)g(data,)h(some)f(in)n(terp)r
-(olation)g(sc)n(hemes)f(ma)n(y)h(app)r(ear)g(to)g(preserv)n(e)f(data)h
-(resolution)g(b)r(e-)227 3674 y(cause)25 b(they)h(transform)e(single)h
-(input)h(pixels)g(in)n(to)f(single)g(output)h(pixels,)f(rather)g(than)g
-(spreading)g(their)g(data)227 3774 y(b)r(et)n(w)n(een)j(sev)n(eral)e
-(output)j(pixels.)38 b(While)28 b(this)h(ma)n(y)e(lo)r(ok)g(b)r(etter)i
+Fk(>)h Fi(in)h(the)g(generic)e(function)227 879 y(name)24
+b(astResample)p Fk(<)p Fi(X)p Fk(>)e Fi(with)i(a)g(1-)f(or)g(2-c)n
+(haracter)d(data)k(t)n(yp)r(e)g(co)r(de,)g(so)f(as)g(to)h(matc)n(h)f
+(the)i(n)n(umerical)d(t)n(yp)r(e)227 978 y Fk(<)p Fi(Xt)n(yp)r(e)p
+Fk(>)27 b Fi(of)h(the)g(data)f(y)n(ou)g(are)g(pro)r(cessing,)f(as)h
+(follo)n(ws:)340 1135 y Fh(\017)45 b Fi(D:)28 b(double)340
+1278 y Fh(\017)45 b Fi(F:)28 b(\015oat)340 1421 y Fh(\017)45
+b Fi(L:)28 b(long)f(in)n(t)h(\(ma)n(y)f(b)r(e)h(32)e(or)h(64)g(bit\))
+340 1564 y Fh(\017)45 b Fi(K:)28 b(64)e(bit)i(in)n(t)340
+1707 y Fh(\017)45 b Fi(UL:)28 b(unsigned)g(long)e(in)n(t)i(\(ma)n(y)f
+(b)r(e)h(32)f(or)g(64)g(bit\))340 1849 y Fh(\017)45 b
+Fi(UK:)28 b(unsigned)f(64)g(bit)h(in)n(t)340 1992 y Fh(\017)45
+b Fi(I:)28 b(in)n(t)340 2135 y Fh(\017)45 b Fi(UI:)28
+b(unsigned)g(in)n(t)340 2278 y Fh(\017)45 b Fi(S:)28
+b(short)f(in)n(t)340 2421 y Fh(\017)45 b Fi(US:)28 b(unsigned)g(short)f
+(in)n(t)340 2564 y Fh(\017)45 b Fi(B:)28 b(b)n(yte)f(\(signed)h(c)n
+(har\))340 2707 y Fh(\017)45 b Fi(UB:)28 b(unsigned)f(b)n(yte)h
+(\(unsigned)g(c)n(har\))227 2889 y(F)-7 b(or)31 b(example,)h
+(astResampleD)f(w)n(ould)g(b)r(e)h(used)g(to)f(pro)r(cess)f
+Ft(")p Fi(double)p Ft(")h Fi(data,)h(while)f(astResampleS)g(w)n(ould)
+227 2989 y(b)r(e)d(used)g(to)f(pro)r(cess)g Ft(")p Fi(short)f(in)n(t)p
+Ft(")i Fi(data,)f(etc.)-2 3158 y Fd(Sub-Pixel)32 b(In)m(terp)s(olation)
+f(Sc)m(hemes)n(:)227 3304 y Fi(There)d(is)f(no)h(suc)n(h)f(thing)h(as)g
+(a)f(p)r(erfect)h(sub-pixel)g(in)n(terp)r(olation)f(sc)n(heme)g(and,)h
+(in)g(practice,)f(all)h(resampling)227 3404 y(will)34
+b(result)e(in)i(some)e(degradation)f(of)i(gridded)g(data.)52
+b(A)34 b(range)d(of)i(sc)n(hemes)g(is)f(therefore)h(pro)n(vided,)g
+(from)227 3504 y(whic)n(h)28 b(y)n(ou)f(can)g(c)n(ho)r(ose)f(the)i(one)
+f(whic)n(h)h(b)r(est)g(suits)g(y)n(our)e(needs.)227 3638
+y(In)h(general,)e(a)g(balance)h(m)n(ust)g(b)r(e)g(struc)n(k)f(b)r(et)n
+(w)n(een)i(sc)n(hemes)e(whic)n(h)h(tend)g(to)g(degrade)f(sharp)g
+(features)h(in)g(the)227 3738 y(data)d(b)n(y)g(smo)r(othing)g(them,)i
+(and)f(those)f(whic)n(h)g(attempt)h(to)g(preserv)n(e)d(sharp)i
+(features.)35 b(The)24 b(latter)f(will)g(often)227 3837
+y(tend)32 b(to)g(in)n(tro)r(duce)f(un)n(w)n(an)n(ted)g(oscillations,)g
+(t)n(ypically)g(visible)g(as)g Ft(")p Fi(ringing)p Ft(")f
+Fi(around)g(sharp)h(features)g(and)227 3937 y(edges,)j(esp)r(ecially)f
+(if)g(the)h(data)e(are)g(under-sampled)h(\(i.e.)54 b(if)33
+b(the)h(sharp)r(est)e(features)h(are)f(less)g(than)i(ab)r(out)227
+4037 y(t)n(w)n(o)27 b(pixels)h(across\).)36 b(In)28 b(practice,)f(a)g
+(go)r(o)r(d)h(in)n(terp)r(olation)e(sc)n(heme)i(is)g(lik)n(ely)f(to)h
+(b)r(e)g(a)f(compromise)g(and)g(ma)n(y)227 4136 y(exhibit)h(some)f(asp)
+r(ects)h(of)f(b)r(oth)h(these)g(features.)227 4271 y(F)-7
+b(or)31 b(under-sampled)g(data,)h(some)f(in)n(terp)r(olation)g(sc)n
+(hemes)f(ma)n(y)h(app)r(ear)g(to)g(preserv)n(e)f(data)h(resolution)g(b)
+r(e-)227 4371 y(cause)25 b(they)h(transform)e(single)h(input)h(pixels)g
+(in)n(to)f(single)g(output)h(pixels,)f(rather)g(than)g(spreading)g
+(their)g(data)227 4470 y(b)r(et)n(w)n(een)j(sev)n(eral)e(output)j
+(pixels.)38 b(While)28 b(this)h(ma)n(y)e(lo)r(ok)g(b)r(etter)i
(cosmetically)-7 b(,)27 b(it)h(can)g(result)g(in)g(a)g(geomet-)227
-3874 y(rical)e(shift)h(of)g(sharp)e(features)h(in)h(the)g(data.)36
+4570 y(rical)e(shift)h(of)g(sharp)e(features)h(in)h(the)g(data.)36
b(Y)-7 b(ou)26 b(should)g(b)r(ew)n(are)g(of)g(this)h(if)g(y)n(ou)f
-(plan)g(to)h(use)f(suc)n(h)g(features)227 3973 y(\(e.g.\))37
-b(for)27 b(image)g(alignmen)n(t.)227 4099 y(The)j(follo)n(wing)f(are)h
+(plan)g(to)h(use)f(suc)n(h)g(features)227 4669 y(\(e.g.\))37
+b(for)27 b(image)g(alignmen)n(t.)227 4804 y(The)j(follo)n(wing)f(are)h
(t)n(w)n(o)f(easy-to-use)f(sub-pixel)i(in)n(terp)r(olation)f(sc)n
(hemes)g(whic)n(h)h(are)g(generally)e(applicable.)227
-4199 y(They)k(are)e(selected)i(b)n(y)f(supplying)g(the)h(appropriate)e
+4904 y(They)k(are)e(selected)i(b)n(y)f(supplying)g(the)h(appropriate)e
(v)-5 b(alue)31 b(\(de\014ned)h(in)g(the)g Ft(")p Fi(ast.h)p
-Ft(")f Fi(header)f(\014le\))i(via)f(the)227 4298 y Ft(")p
+Ft(")f Fi(header)f(\014le\))i(via)f(the)227 5003 y Ft(")p
Fi(in)n(terp)p Ft(")c Fi(parameter.)35 b(In)28 b(these)g(cases,)e(the)i
Ft(")p Fi(\014n)n(terp)p Ft(")f Fi(and)g Ft(")p Fi(params)p
-Ft(")f Fi(parameters)g(are)g(not)i(used:)340 4563 y Fh(\017)45
+Ft(")f Fi(parameters)g(are)g(not)i(used:)340 5295 y Fh(\017)45
b Fi(AST)p Ft(__)p Fi(NEAREST:)24 b(This)h(is)f(the)h(simplest)g(p)r
(ossible)f(sc)n(heme,)h(in)g(whic)n(h)f(the)h(v)-5 b(alue)25
-b(of)f(the)h(input)h(pixel)427 4662 y(with)j(the)g(nearest)f(cen)n(tre)
+b(of)f(the)h(input)h(pixel)427 5394 y(with)j(the)g(nearest)f(cen)n(tre)
g(to)h(the)g(in)n(terp)r(olation)f(p)r(oin)n(t)g(is)h(used.)40
b(This)29 b(is)f(v)n(ery)g(quic)n(k)g(to)g(execute)h(and)427
-4762 y(will)38 b(preserv)n(e)d(single-pixel)h(features)h(in)g(the)h
+5494 y(will)38 b(preserv)n(e)d(single-pixel)h(features)h(in)g(the)h
(data,)h(but)f(ma)n(y)e(displace)h(them)h(b)n(y)f(up)g(to)g(half)h
-(their)427 4862 y(width)28 b(along)e(eac)n(h)h(dimension.)36
+(their)427 5593 y(width)28 b(along)e(eac)n(h)h(dimension.)36
b(It)28 b(often)g(giv)n(es)e(a)g(go)r(o)r(d)h(cosmetic)g(result,)g(so)g
-(is)g(useful)g(for)g(quic)n(k-lo)r(ok)427 4961 y(pro)r(cessing,)f(but)j
+(is)g(useful)g(for)g(quic)n(k-lo)r(ok)427 5693 y(pro)r(cessing,)f(but)j
(is)e(unsuitable)h(if)g(accurate)e(geometrical)g(transformation)g(is)i
-(required.)340 5095 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(LINEAR:)40
-b(This)h(is)f(the)h(default)g(sc)n(heme,)j(whic)n(h)c(uses)g(linear)g
-(in)n(terp)r(olation)g(b)r(et)n(w)n(een)g(the)427 5195
-y(nearest)35 b(neigh)n(b)r(ouring)f(pixels)i(in)g(the)g(input)g(grid)f
-(\(there)h(are)e(t)n(w)n(o)h(neigh)n(b)r(ours)g(in)g(one)h(dimension,)
-427 5295 y(four)h(neigh)n(b)r(ours)f(in)i(t)n(w)n(o)f(dimensions,)i
-(eigh)n(t)e(in)h(three)f(dimensions,)i(etc.\).)67 b(It)38
-b(is)f(sup)r(erior)f(to)h(the)427 5394 y(nearest-pixel)25
-b(sc)n(heme)h(\(ab)r(o)n(v)n(e\))g(in)g(not)g(displacing)g(features)g
-(in)g(the)h(data,)f(y)n(et)g(it)h(still)f(executes)g(fairly)427
-5494 y(rapidly)-7 b(.)74 b(It)40 b(is)g(generally)e(a)i(safe)f(c)n
-(hoice)g(if)i(y)n(ou)e(do)h(not)g(ha)n(v)n(e)e(an)n(y)h(particular)g
-(reason)f(to)i(fa)n(v)n(our)427 5593 y(another)g(sc)n(heme,)k(since)c
-(it)h(cannot)g(in)n(tro)r(duce)f(oscillations.)75 b(Ho)n(w)n(ev)n(er,)
-42 b(it)f(do)r(es)g(in)n(tro)r(duce)f(some)427 5693 y(spatial)28
-b(smo)r(othing)f(whic)n(h)i(v)-5 b(aries)27 b(according)f(to)i(the)h
-(distance)f(of)g(the)h(in)n(terp)r(olation)e(p)r(oin)n(t)h(from)g(the)p
-eop end
-%%Page: 348 358
-TeXDict begin 348 357 bop 0 52 a FF(348)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)427 351 y Fi(neigh)n(b)r(ouring)e
+(required.)p eop end
+%%Page: 349 359
+TeXDict begin 349 358 bop 3643 52 a FF(349)340 351 y
+Fh(\017)45 b Fi(AST)p Ft(__)p Fi(LINEAR:)40 b(This)h(is)f(the)h
+(default)g(sc)n(heme,)j(whic)n(h)c(uses)g(linear)g(in)n(terp)r(olation)
+g(b)r(et)n(w)n(een)g(the)427 451 y(nearest)35 b(neigh)n(b)r(ouring)f
+(pixels)i(in)g(the)g(input)g(grid)f(\(there)h(are)e(t)n(w)n(o)h(neigh)n
+(b)r(ours)g(in)g(one)h(dimension,)427 551 y(four)h(neigh)n(b)r(ours)f
+(in)i(t)n(w)n(o)f(dimensions,)i(eigh)n(t)e(in)h(three)f(dimensions,)i
+(etc.\).)67 b(It)38 b(is)f(sup)r(erior)f(to)h(the)427
+650 y(nearest-pixel)25 b(sc)n(heme)h(\(ab)r(o)n(v)n(e\))g(in)g(not)g
+(displacing)g(features)g(in)g(the)h(data,)f(y)n(et)g(it)h(still)f
+(executes)g(fairly)427 750 y(rapidly)-7 b(.)74 b(It)40
+b(is)g(generally)e(a)i(safe)f(c)n(hoice)g(if)i(y)n(ou)e(do)h(not)g(ha)n
+(v)n(e)e(an)n(y)h(particular)g(reason)f(to)i(fa)n(v)n(our)427
+849 y(another)g(sc)n(heme,)k(since)c(it)h(cannot)g(in)n(tro)r(duce)f
+(oscillations.)75 b(Ho)n(w)n(ev)n(er,)42 b(it)f(do)r(es)g(in)n(tro)r
+(duce)f(some)427 949 y(spatial)28 b(smo)r(othing)f(whic)n(h)i(v)-5
+b(aries)27 b(according)f(to)i(the)h(distance)f(of)g(the)h(in)n(terp)r
+(olation)e(p)r(oin)n(t)h(from)g(the)427 1049 y(neigh)n(b)r(ouring)g
(pixels.)39 b(This)29 b(can)f(degrade)f(the)i(shap)r(e)f(of)h(sharp)e
(features)h(in)h(the)g(data)f(in)h(a)f(p)r(osition-)427
-451 y(dep)r(enden)n(t)f(w)n(a)n(y)-7 b(.)35 b(It)27 b(ma)n(y)e(also)g
-(sho)n(w)h(in)g(the)h(output)g(v)-5 b(ariance)24 b(grid)i(\(if)h
-(used\))f(as)g(a)g(pattern)g(of)g(strip)r(es)427 551
-y(or)h(fringes.)227 712 y(An)35 b(alternativ)n(e)e(set)h(of)h(in)n
-(terp)r(olation)e(sc)n(hemes)h(is)g(based)g(on)g(forming)g(the)g(in)n
-(terp)r(olated)g(v)-5 b(alue)34 b(from)g(the)227 811
-y(w)n(eigh)n(ted)g(sum)h(of)f(a)g(set)h(of)f(surrounding)f(pixel)i(v)-5
-b(alues)34 b(\(not)h(necessarily)e(just)i(the)g(nearest)e(neigh)n(b)r
-(ours\).)227 911 y(This)27 b(approac)n(h)e(has)h(its)h(origins)e(in)i
-(the)g(theory)f(of)h(digital)f(\014ltering,)h(in)f(whic)n(h)h(in)n
-(terp)r(olated)f(v)-5 b(alues)27 b(are)e(ob-)227 1011
+1148 y(dep)r(enden)n(t)f(w)n(a)n(y)-7 b(.)35 b(It)27
+b(ma)n(y)e(also)g(sho)n(w)h(in)g(the)h(output)g(v)-5
+b(ariance)24 b(grid)i(\(if)h(used\))f(as)g(a)g(pattern)g(of)g(strip)r
+(es)427 1248 y(or)h(fringes.)227 1396 y(An)35 b(alternativ)n(e)e(set)h
+(of)h(in)n(terp)r(olation)e(sc)n(hemes)h(is)g(based)g(on)g(forming)g
+(the)g(in)n(terp)r(olated)g(v)-5 b(alue)34 b(from)g(the)227
+1495 y(w)n(eigh)n(ted)g(sum)h(of)f(a)g(set)h(of)f(surrounding)f(pixel)i
+(v)-5 b(alues)34 b(\(not)h(necessarily)e(just)i(the)g(nearest)e(neigh)n
+(b)r(ours\).)227 1595 y(This)27 b(approac)n(h)e(has)h(its)h(origins)e
+(in)i(the)g(theory)f(of)h(digital)f(\014ltering,)h(in)f(whic)n(h)h(in)n
+(terp)r(olated)f(v)-5 b(alues)27 b(are)e(ob-)227 1695
y(tained)f(b)n(y)g(conceptually)f(passing)g(the)h(sampled)f(data)h
(\(represen)n(ted)e(b)n(y)i(a)f(grid)g(of)h(delta)g(functions\))g
-(through)227 1110 y(a)30 b(linear)g(\014lter)g(whic)n(h)g(implemen)n
+(through)227 1794 y(a)30 b(linear)g(\014lter)g(whic)n(h)g(implemen)n
(ts)h(a)f(con)n(v)n(olution.)43 b(Because)29 b(the)i(con)n(v)n(olution)
-e(k)n(ernel)g(is)h(con)n(tin)n(uous,)g(the)227 1210 y(con)n(v)n
+e(k)n(ernel)g(is)h(con)n(tin)n(uous,)g(the)227 1894 y(con)n(v)n
(olution)23 b(yields)h(a)g(con)n(tin)n(uous)f(function)h(whic)n(h)g(ma)
n(y)g(then)g(b)r(e)h(ev)-5 b(aluated)24 b(at)g(fractional)f(pixel)h(p)r
-(ositions.)227 1309 y(The)33 b(\(p)r(ossibly)g(m)n(ulti-dimensional\))f
+(ositions.)227 1993 y(The)33 b(\(p)r(ossibly)g(m)n(ulti-dimensional\))f
(k)n(ernel)g(is)h(usually)f(regarded)f(as)h Ft(")p Fi(separable)p
-Ft(")e Fi(and)i(formed)h(from)f(the)227 1409 y(pro)r(duct)22
+Ft(")e Fi(and)i(formed)h(from)f(the)227 2093 y(pro)r(duct)22
b(of)g(a)f(set)h(of)g(iden)n(tical)g(1-dimensional)e(k)n(ernel)h
(functions,)i(ev)-5 b(aluated)22 b(along)f(eac)n(h)g(dimension.)35
-b(Di\013er-)227 1509 y(en)n(t)29 b(in)n(terp)r(olation)f(sc)n(hemes)h
+b(Di\013er-)227 2193 y(en)n(t)29 b(in)n(terp)r(olation)f(sc)n(hemes)h
(are)e(then)j(distinguished)f(b)n(y)f(the)i(c)n(hoice)e(of)h(this)g
-(1-dimensional)e(in)n(terp)r(olation)227 1608 y(k)n(ernel.)36
+(1-dimensional)e(in)n(terp)r(olation)227 2292 y(k)n(ernel.)36
b(The)28 b(n)n(um)n(b)r(er)f(of)h(surrounding)e(pixels)h(whic)n(h)h
(con)n(tribute)f(to)h(the)g(result)f(ma)n(y)g(also)f(b)r(e)i(v)-5
-b(aried.)227 1733 y(F)e(rom)29 b(a)f(practical)g(standp)r(oin)n(t,)h
+b(aried.)227 2410 y(F)e(rom)29 b(a)f(practical)g(standp)r(oin)n(t,)h
(it)h(is)f(useful)g(to)g(divide)g(the)g(w)n(eigh)n(ted)f(sum)h(of)g
(pixel)g(v)-5 b(alues)29 b(b)n(y)f(the)i(sum)f(of)227
-1832 y(the)g(w)n(eigh)n(ts)e(when)h(determining)g(the)h(in)n(terp)r
+2509 y(the)g(w)n(eigh)n(ts)e(when)h(determining)g(the)h(in)n(terp)r
(olated)e(v)-5 b(alue.)38 b(Strictly)-7 b(,)29 b(this)f(means)g(that)g
-(a)g(true)g(con)n(v)n(olution)227 1932 y(is)e(no)f(longer)g(b)r(eing)h
+(a)g(true)g(con)n(v)n(olution)227 2609 y(is)e(no)f(longer)g(b)r(eing)h
(p)r(erformed.)36 b(Ho)n(w)n(ev)n(er,)24 b(the)i(distinction)g(is)g
(rarely)e(imp)r(ortan)n(t)h(in)h(practice)f(b)r(ecause)h(\(for)227
-2031 y(sligh)n(tly)e(subtle)h(reasons\))d(the)j(sum)f(of)g(w)n(eigh)n
+2709 y(sligh)n(tly)e(subtle)h(reasons\))d(the)j(sum)f(of)g(w)n(eigh)n
(ts)g(is)g(alw)n(a)n(ys)e(appro)n(ximately)h(constan)n(t)g(for)h(go)r
-(o)r(d)f(in)n(terp)r(olation)227 2131 y(k)n(ernels.)51
+(o)r(d)f(in)n(terp)r(olation)227 2808 y(k)n(ernels.)51
b(The)33 b(adv)-5 b(an)n(tage)31 b(of)i(this)g(tec)n(hnique,)h(whic)n
(h)f(is)f(used)h(here,)h(is)e(that)h(it)g(can)g(easily)f(accommo)r
-(date)227 2231 y(missing)27 b(data)g(and)h(tends)g(to)f(minimise)h(un)n
+(date)227 2908 y(missing)27 b(data)g(and)h(tends)g(to)f(minimise)h(un)n
(w)n(an)n(ted)f(oscillations)f(at)i(the)g(edges)f(of)g(the)h(data)f
-(grid.)227 2355 y(In)d(the)g(follo)n(wing)e(sc)n(hemes,)h(whic)n(h)h
+(grid.)227 3025 y(In)d(the)g(follo)n(wing)e(sc)n(hemes,)h(whic)n(h)h
(are)e(based)h(on)g(a)g(1-dimensional)f(in)n(terp)r(olation)g(k)n
-(ernel,)i(the)f(\014rst)g(elemen)n(t)227 2454 y(of)j(the)h
+(ernel,)i(the)f(\014rst)g(elemen)n(t)227 3125 y(of)j(the)h
Ft(")p Fi(params)p Ft(")d Fi(arra)n(y)f(should)j(b)r(e)h(used)f(to)g
(sp)r(ecify)g(ho)n(w)g(man)n(y)f(pixels)h(are)f(to)h(con)n(tribute)g
-(to)g(the)g(in)n(terp)r(o-)227 2554 y(lated)31 b(result)g(on)f(either)h
+(to)g(the)g(in)n(terp)r(o-)227 3225 y(lated)31 b(result)g(on)f(either)h
(side)g(of)f(the)i(in)n(terp)r(olation)e(p)r(oin)n(t)h(in)g(eac)n(h)f
(dimension)g(\(the)i(nearest)e(in)n(teger)g(v)-5 b(alue)227
-2654 y(is)27 b(used\).)36 b(Execution)26 b(time)h(increases)e(rapidly)h
+3324 y(is)27 b(used\).)36 b(Execution)26 b(time)h(increases)e(rapidly)h
(with)h(this)f(n)n(um)n(b)r(er.)36 b(T)n(ypically)-7
b(,)26 b(a)g(v)-5 b(alue)27 b(of)f(2)g(is)g(appropriate)227
-2753 y(and)k(the)h(minim)n(um)f(v)-5 b(alue)30 b(used)g(will)g(b)r(e)h
+3424 y(and)k(the)h(minim)n(um)f(v)-5 b(alue)30 b(used)g(will)g(b)r(e)h
(1)f(\(i.e.)44 b(t)n(w)n(o)29 b(pixels)h(altogether,)g(one)f(on)h
-(either)g(side)g(of)g(the)g(in)n(ter-)227 2853 y(p)r(olation)h(p)r(oin)
+(either)g(side)g(of)g(the)g(in)n(ter-)227 3523 y(p)r(olation)h(p)r(oin)
n(t\).)48 b(A)32 b(v)-5 b(alue)31 b(of)g(zero)f(or)g(less)h(ma)n(y)f(b)
r(e)i(giv)n(en)e(for)h Ft(")p Fi(params[0])p Ft(")d Fi(to)j(indicate)h
-(that)f(a)g(suitable)227 2953 y(n)n(um)n(b)r(er)d(of)f(pixels)h(should)
-f(b)r(e)h(calculated)f(automatically)-7 b(.)227 3077
+(that)f(a)g(suitable)227 3623 y(n)n(um)n(b)r(er)d(of)f(pixels)h(should)
+f(b)r(e)h(calculated)f(automatically)-7 b(.)227 3741
y(In)28 b(eac)n(h)f(of)g(these)h(cases,)f(the)h Ft(")p
Fi(\014n)n(terp)p Ft(")e Fi(parameter)g(is)i(not)f(used:)340
-3337 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(GA)n(USS:)35
+3980 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(GA)n(USS:)35
b(This)f(sc)n(heme)g(uses)g(a)g(k)n(ernel)f(of)h(the)h(form)f(exp\(-k)p
Fh(\003)p Fi(x)p Fh(\003)p Fi(x\),)h(with)f(k)h(a)e(p)r(ositiv)n(e)h
-(con-)427 3436 y(stan)n(t.)41 b(The)29 b(full-width)h(at)f(half-maxim)n
+(con-)427 4080 y(stan)n(t.)41 b(The)29 b(full-width)h(at)f(half-maxim)n
(um)g(\(FWHM\))h(is)f(giv)n(en)f(b)n(y)h Ft(")p Fi(params[1])p
-Ft(")e Fi(to)i(zero)e(will)j(select)427 3536 y(the)k(n)n(um)n(b)r(er)e
+Ft(")e Fi(to)i(zero)e(will)j(select)427 4180 y(the)k(n)n(um)n(b)r(er)e
(of)h(con)n(tributing)g(pixels)f(so)h(as)f(to)h(utilise)g(the)g(width)h
-(of)f(the)g(k)n(ernel)f(out)h(to)g(where)f(the)427 3635
+(of)f(the)g(k)n(ernel)f(out)h(to)g(where)f(the)427 4279
y(en)n(v)n(elop)r(e)c(declines)h(to)f(1\045)h(of)f(its)h(maxim)n(um)g
(v)-5 b(alue\).)40 b(This)29 b(k)n(ernel)f(suppresses)f(noise)h(at)h
-(the)g(exp)r(ense)427 3735 y(of)f(smo)r(othing)f(the)h(output)g(arra)n
-(y)-7 b(.)340 3867 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(SINC:)27
+(the)g(exp)r(ense)427 4379 y(of)f(smo)r(othing)f(the)h(output)g(arra)n
+(y)-7 b(.)340 4497 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(SINC:)27
b(This)f(sc)n(heme)g(uses)g(a)g(sinc\(pi)p Fh(\003)p
Fi(x\))g(k)n(ernel,)g(where)g(x)g(is)g(the)h(pixel)f(o\013set)h(from)f
-(the)g(in)n(ter-)427 3967 y(p)r(olation)j(p)r(oin)n(t)h(and)g
+(the)g(in)n(ter-)427 4597 y(p)r(olation)j(p)r(oin)n(t)h(and)g
(sinc\(z\)=sin\(z\)/z.)42 b(This)30 b(sometimes)f(features)g(as)g(an)g
Ft(")p Fi(optimal)p Ft(")f Fi(in)n(terp)r(olation)427
-4066 y(k)n(ernel)35 b(in)h(b)r(o)r(oks)f(on)g(image)g(pro)r(cessing.)59
+4697 y(k)n(ernel)35 b(in)h(b)r(o)r(oks)f(on)g(image)g(pro)r(cessing.)59
b(Its)36 b(supp)r(osed)f(optimalit)n(y)h(dep)r(ends)g(on)f(the)h
-(assumption)427 4166 y(that)d(the)g(data)e(are)h(band-limited)g(\(i.e.)
+(assumption)427 4796 y(that)d(the)g(data)e(are)h(band-limited)g(\(i.e.)
52 b(ha)n(v)n(e)31 b(no)h(spatial)g(frequencies)g(ab)r(o)n(v)n(e)f(a)h
-(certain)f(v)-5 b(alue\))33 b(and)427 4266 y(are)e(adequately)g
+(certain)f(v)-5 b(alue\))33 b(and)427 4896 y(are)e(adequately)g
(sampled.)49 b(In)32 b(practice,)g(astronomical)d(data)j(rarely)e(meet)
-i(these)f(requiremen)n(ts.)48 b(In)427 4365 y(addition,)35
+i(these)f(requiremen)n(ts.)48 b(In)427 4996 y(addition,)35
b(high)e(spatial)g(frequencies)f(are)h(often)g(presen)n(t)g(due)g
(\(e.g.\))54 b(to)33 b(image)g(defects)g(and)g(cosmic)427
-4465 y(ra)n(y)22 b(ev)n(en)n(ts.)35 b(Consequen)n(tly)-7
+5095 y(ra)n(y)22 b(ev)n(en)n(ts.)35 b(Consequen)n(tly)-7
b(,)24 b(substan)n(tial)e(ringing)h(can)g(b)r(e)h(exp)r(erienced)f
(with)h(this)f(k)n(ernel.)35 b(The)24 b(k)n(ernel)427
-4565 y(also)33 b(deca)n(ys)g(slo)n(wly)g(with)i(distance,)g(so)e(that)i
+5195 y(also)33 b(deca)n(ys)g(slo)n(wly)g(with)i(distance,)g(so)e(that)i
(man)n(y)e(surrounding)g(pixels)h(are)f(required,)h(leading)g(to)427
-4664 y(p)r(o)r(or)24 b(p)r(erformance.)35 b(Abruptly)25
+5295 y(p)r(o)r(or)24 b(p)r(erformance.)35 b(Abruptly)25
b(truncating)g(it,)g(b)n(y)g(using)f(only)g(a)h(few)g(neigh)n(b)r
-(ouring)e(pixels,)i(impro)n(v)n(es)427 4764 y(p)r(erformance)20
+(ouring)e(pixels,)i(impro)n(v)n(es)427 5394 y(p)r(erformance)20
b(and)i(ma)n(y)e(reduce)h(ringing)f(\(if)i Ft(")p Fi(params[0])p
Ft(")d Fi(is)i(set)g(to)g(zero,)h(then)f(only)g(t)n(w)n(o)g(pixels)g
-(will)g(b)r(e)427 4864 y(used)29 b(on)g(either)f(side\).)41
+(will)g(b)r(e)427 5494 y(used)29 b(on)g(either)f(side\).)41
b(Ho)n(w)n(ev)n(er,)27 b(a)i(more)e(gradual)h(truncation,)g(as)h
-(implemen)n(ted)g(b)n(y)f(other)h(k)n(ernels,)427 4963
+(implemen)n(ted)g(b)n(y)f(other)h(k)n(ernels,)427 5593
y(is)d(generally)e(to)i(b)r(e)g(preferred.)35 b(This)26
b(k)n(ernel)f(is)h(pro)n(vided)f(mainly)g(so)g(that)h(y)n(ou)f(can)h
-(con)n(vince)f(y)n(ourself)427 5063 y(not)j(to)f(use)h(it!)340
-5195 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(SINCSINC:)25
-b(This)g(sc)n(heme)g(uses)f(an)h(impro)n(v)n(ed)e(k)n(ernel,)i(of)g
-(the)g(form)f(sinc\(pi)p Fh(\003)p Fi(x\).sinc\(k)p Fh(\003)p
-Fi(pi)p Fh(\003)p Fi(x\),)427 5295 y(with)32 b(k)f(a)f(constan)n(t,)h
-(out)g(to)g(the)g(p)r(oin)n(t)g(where)g(sinc\(k)p Fh(\003)p
-Fi(pi)p Fh(\003)p Fi(x\))f(go)r(es)g(to)h(zero,)f(and)h(zero)f(b)r(ey)n
-(ond.)47 b(The)427 5394 y(second)32 b(sinc\(\))i(factor)e(pro)n(vides)f
-(an)i Ft(")p Fi(en)n(v)n(elop)r(e)p Ft(")e Fi(whic)n(h)i(gradually)e
-(rolls)h(o\013)h(the)g(normal)f(sinc\(pi)p Fh(\003)p
-Fi(x\))427 5494 y(k)n(ernel)40 b(at)h(large)f(o\013sets.)76
-b(The)41 b(width)h(of)f(this)g(en)n(v)n(elop)r(e)f(is)h(sp)r(eci\014ed)
-g(b)n(y)g(giving)f(the)h(n)n(um)n(b)r(er)g(of)427 5593
-y(pixels)35 b(o\013set)g(at)g(whic)n(h)g(it)g(go)r(es)g(to)f(zero)g(b)n
-(y)h(means)g(of)g(the)g Ft(")p Fi(params[1])p Ft(")e
-Fi(v)-5 b(alue,)36 b(whic)n(h)f(should)g(b)r(e)427 5693
-y(at)d(least)f(1.0)g(\(in)h(addition,)h(setting)f Ft(")p
-Fi(params[0])p Ft(")d Fi(to)j(zero)e(will)i(select)g(the)g(n)n(um)n(b)r
-(er)g(of)f(con)n(tributing)p eop end
-%%Page: 349 359
-TeXDict begin 349 358 bop 3643 52 a FF(349)427 351 y
-Fi(pixels)34 b(so)e(as)h(to)h(utilise)g(the)f(full)i(width)f(of)f(the)h
+(con)n(vince)f(y)n(ourself)427 5693 y(not)j(to)f(use)h(it!)p
+eop end
+%%Page: 350 360
+TeXDict begin 350 359 bop 0 52 a FF(350)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Fi(AST)p Ft(__)p Fi(SINCSINC:)25 b(This)g(sc)n(heme)g(uses)f(an)h
+(impro)n(v)n(ed)e(k)n(ernel,)i(of)g(the)g(form)f(sinc\(pi)p
+Fh(\003)p Fi(x\).sinc\(k)p Fh(\003)p Fi(pi)p Fh(\003)p
+Fi(x\),)427 451 y(with)32 b(k)f(a)f(constan)n(t,)h(out)g(to)g(the)g(p)r
+(oin)n(t)g(where)g(sinc\(k)p Fh(\003)p Fi(pi)p Fh(\003)p
+Fi(x\))f(go)r(es)g(to)h(zero,)f(and)h(zero)f(b)r(ey)n(ond.)47
+b(The)427 551 y(second)32 b(sinc\(\))i(factor)e(pro)n(vides)f(an)i
+Ft(")p Fi(en)n(v)n(elop)r(e)p Ft(")e Fi(whic)n(h)i(gradually)e(rolls)h
+(o\013)h(the)g(normal)f(sinc\(pi)p Fh(\003)p Fi(x\))427
+650 y(k)n(ernel)40 b(at)h(large)f(o\013sets.)76 b(The)41
+b(width)h(of)f(this)g(en)n(v)n(elop)r(e)f(is)h(sp)r(eci\014ed)g(b)n(y)g
+(giving)f(the)h(n)n(um)n(b)r(er)g(of)427 750 y(pixels)35
+b(o\013set)g(at)g(whic)n(h)g(it)g(go)r(es)g(to)f(zero)g(b)n(y)h(means)g
+(of)g(the)g Ft(")p Fi(params[1])p Ft(")e Fi(v)-5 b(alue,)36
+b(whic)n(h)f(should)g(b)r(e)427 849 y(at)d(least)f(1.0)g(\(in)h
+(addition,)h(setting)f Ft(")p Fi(params[0])p Ft(")d Fi(to)j(zero)e
+(will)i(select)g(the)g(n)n(um)n(b)r(er)g(of)f(con)n(tributing)427
+949 y(pixels)j(so)e(as)h(to)h(utilise)g(the)f(full)i(width)f(of)f(the)h
(k)n(ernel,)g(out)g(to)f(where)g(it)h(reac)n(hes)e(zero\).)54
-b(The)33 b(case)427 451 y(giv)n(en)28 b(b)n(y)h Ft(")p
+b(The)33 b(case)427 1049 y(giv)n(en)28 b(b)n(y)h Ft(")p
Fi(params[0]=2,)d(params[1]=2)p Ft(")f Fi(is)k(t)n(ypically)f(a)g(go)r
(o)r(d)g(c)n(hoice)g(and)g(is)h(sometimes)f(kno)n(wn)g(as)427
-551 y(the)36 b(Lanczos)e(k)n(ernel.)60 b(This)35 b(is)g(a)g(v)-5
+1148 y(the)36 b(Lanczos)e(k)n(ernel.)60 b(This)35 b(is)g(a)g(v)-5
b(aluable)35 b(general-purp)r(ose)e(in)n(terp)r(olation)i(sc)n(heme,)i
-(in)n(termediate)427 650 y(in)d(its)f(visual)g(e\013ect)h(on)f(images)f
-(b)r(et)n(w)n(een)h(the)h(AST)p Ft(__)p Fi(NEAREST)e(and)h(AST)p
-Ft(__)p Fi(LINEAR)g(sc)n(hemes.)427 750 y(Although)i(the)f(k)n(ernel)f
+(in)n(termediate)427 1248 y(in)d(its)f(visual)g(e\013ect)h(on)f(images)
+f(b)r(et)n(w)n(een)h(the)h(AST)p Ft(__)p Fi(NEAREST)e(and)h(AST)p
+Ft(__)p Fi(LINEAR)g(sc)n(hemes.)427 1348 y(Although)i(the)f(k)n(ernel)f
(is)h(sligh)n(tly)g(oscillatory)-7 b(,)34 b(ringing)f(is)h(adequately)f
-(suppressed)h(if)g(the)h(data)f(are)427 849 y(w)n(ell)28
-b(sampled.)340 980 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(SINCCOS:)38
+(suppressed)h(if)g(the)h(data)f(are)427 1447 y(w)n(ell)28
+b(sampled.)340 1572 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(SINCCOS:)38
b(This)g(sc)n(heme)g(uses)g(a)g(k)n(ernel)f(of)h(the)h(form)f(sinc\(pi)
p Fh(\003)p Fi(x\).cos\(k)p Fh(\003)p Fi(pi)p Fh(\003)p
-Fi(x\),)h(with)g(k)f(a)427 1080 y(constan)n(t,)32 b(out)f(to)g(the)h(p)
+Fi(x\),)h(with)g(k)f(a)427 1672 y(constan)n(t,)32 b(out)f(to)g(the)h(p)
r(oin)n(t)f(where)g(cos\(k)p Fh(\003)p Fi(pi)p Fh(\003)p
Fi(x\))f(go)r(es)h(to)g(zero,)g(and)g(zero)f(b)r(ey)n(ond.)48
-b(As)31 b(ab)r(o)n(v)n(e,)g(the)427 1179 y(cos\(\))h(factor)f(pro)n
+b(As)31 b(ab)r(o)n(v)n(e,)g(the)427 1771 y(cos\(\))h(factor)f(pro)n
(vides)f(an)h(en)n(v)n(elop)r(e)g(whic)n(h)h(gradually)e(rolls)g(o\013)
i(the)g(sinc\(\))g(k)n(ernel)f(at)h(large)e(o\013sets.)427
-1279 y(The)e(width)h(of)e(this)h(en)n(v)n(elop)r(e)f(is)h(sp)r
+1871 y(The)e(width)h(of)e(this)h(en)n(v)n(elop)r(e)f(is)h(sp)r
(eci\014ed)g(b)n(y)f(giving)g(the)h(n)n(um)n(b)r(er)g(of)g(pixels)f
-(o\013set)h(at)g(whic)n(h)f(it)i(go)r(es)427 1378 y(to)f(zero)e(b)n(y)h
+(o\013set)h(at)g(whic)n(h)f(it)i(go)r(es)427 1971 y(to)f(zero)e(b)n(y)h
(means)g(of)g(the)h Ft(")p Fi(params[1])p Ft(")d Fi(v)-5
b(alue,)27 b(whic)n(h)h(should)f(b)r(e)h(at)f(least)g(1.0)f(\(in)i
-(addition,)g(setting)427 1478 y Ft(")p Fi(params[0])p
+(addition,)g(setting)427 2070 y Ft(")p Fi(params[0])p
Ft(")37 b Fi(to)h(zero)g(will)h(select)g(the)g(n)n(um)n(b)r(er)g(of)g
(con)n(tributing)f(pixels)g(so)h(as)f(to)h(utilise)g(the)g(full)427
-1578 y(width)33 b(of)f(the)g(k)n(ernel,)g(out)g(to)g(where)g(it)g(reac)
+2170 y(width)33 b(of)f(the)g(k)n(ernel,)g(out)g(to)g(where)g(it)g(reac)
n(hes)e(zero\).)50 b(This)31 b(sc)n(heme)h(giv)n(es)f(similar)g
-(results)g(to)h(the)427 1677 y(AST)p Ft(__)p Fi(SINCSINC)c(sc)n(heme,)f
-(whic)n(h)h(it)g(resem)n(bles.)340 1808 y Fh(\017)45
+(results)g(to)h(the)427 2270 y(AST)p Ft(__)p Fi(SINCSINC)c(sc)n(heme,)f
+(whic)n(h)h(it)g(resem)n(bles.)340 2395 y Fh(\017)45
b Fi(AST)p Ft(__)p Fi(SINCGA)n(USS:)35 b(This)f(sc)n(heme)f(uses)h(a)g
(k)n(ernel)f(of)h(the)g(form)g(sinc\(pi)p Fh(\003)p Fi(x\).exp\(-k)p
-Fh(\003)p Fi(x)p Fh(\003)p Fi(x\),)g(with)h(k)427 1908
+Fh(\003)p Fi(x)p Fh(\003)p Fi(x\),)g(with)h(k)427 2494
y(a)c(p)r(ositiv)n(e)g(constan)n(t.)48 b(Here,)32 b(the)g(sinc\(\))g(k)
n(ernel)e(is)h(rolled)g(o\013)g(using)g(a)g(Gaussian)g(en)n(v)n(elop)r
-(e)f(whic)n(h)i(is)427 2007 y(sp)r(eci\014ed)k(b)n(y)f(giving)f(its)h
+(e)f(whic)n(h)i(is)427 2594 y(sp)r(eci\014ed)k(b)n(y)f(giving)f(its)h
(full-width)h(at)f(half-maxim)n(um)g(\(FWHM\))i(b)n(y)e(means)f(of)i
-(the)f Ft(")p Fi(params[1])p Ft(")427 2107 y Fi(v)-5
+(the)f Ft(")p Fi(params[1])p Ft(")427 2694 y Fi(v)-5
b(alue,)34 b(whic)n(h)f(should)f(b)r(e)h(at)f(least)h(0.1)e(\(in)j
(addition,)f(setting)g Ft(")p Fi(params[0])p Ft(")d Fi(to)i(zero)g
-(will)h(select)f(the)427 2206 y(n)n(um)n(b)r(er)22 b(of)f(con)n
+(will)h(select)f(the)427 2793 y(n)n(um)n(b)r(er)22 b(of)f(con)n
(tributing)g(pixels)g(so)g(as)g(to)h(utilise)f(the)h(width)h(of)e(the)h
(k)n(ernel)f(out)g(to)h(where)f(the)h(en)n(v)n(elop)r(e)427
-2306 y(declines)k(to)f(1\045)h(of)f(its)h(maxim)n(um)g(v)-5
+2893 y(declines)k(to)f(1\045)h(of)f(its)h(maxim)n(um)g(v)-5
b(alue\).)36 b(On)25 b(astronomical)f(images)h(and)g(sp)r(ectra,)h(go)r
-(o)r(d)f(results)g(are)427 2406 y(often)36 b(obtained)g(b)n(y)g(appro)n
+(o)r(d)f(results)g(are)427 2992 y(often)36 b(obtained)g(b)n(y)g(appro)n
(ximately)e(matc)n(hing)h(the)h(FWHM)h(of)f(the)g(en)n(v)n(elop)r(e)f
-(function,)k(giv)n(en)c(b)n(y)427 2505 y Ft(")p Fi(params[1])p
+(function,)k(giv)n(en)c(b)n(y)427 3092 y Ft(")p Fi(params[1])p
Ft(")p Fi(,)29 b(to)i(the)g(p)r(oin)n(t)g(spread)f(function)h(of)g(the)
g(input)h(data.)45 b(Ho)n(w)n(ev)n(er,)30 b(there)h(do)r(es)f(not)h
-(seem)427 2605 y(to)d(b)r(e)g(an)n(y)f(theoretical)f(reason)g(for)h
-(this.)340 2736 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(SOMB:)24
+(seem)427 3192 y(to)d(b)r(e)g(an)n(y)f(theoretical)f(reason)g(for)h
+(this.)340 3317 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(SOMB:)24
b(This)h(sc)n(heme)g(uses)f(a)g(som)n(b\(pi)p Fh(\003)p
Fi(x\))h(k)n(ernel)f(\(a)g Ft(")p Fi(som)n(brero)p Ft(")e
-Fi(function\),)k(where)f(x)f(is)h(the)427 2835 y(pixel)32
+Fi(function\),)k(where)f(x)f(is)h(the)427 3416 y(pixel)32
b(o\013set)g(from)f(the)i(in)n(terp)r(olation)e(p)r(oin)n(t)h(and)f
(som)n(b\(z\)=2)p Fh(\003)p Fi(J1\(z\)/z)f(\(J1)h(is)h(a)f(Bessel)g
-(function)i(of)427 2935 y(the)24 b(\014rst)g(kind)f(of)h(order)e(1\).)
+(function)i(of)427 3516 y(the)24 b(\014rst)g(kind)f(of)h(order)e(1\).)
36 b(It)24 b(is)f(similar)g(to)g(the)h(AST)p Ft(__)p
Fi(SINC)g(k)n(ernel,)g(and)f(has)g(the)h(same)f(parameter)427
-3034 y(usage.)340 3165 y Fh(\017)45 b Fi(AST)p Ft(__)p
+3616 y(usage.)340 3741 y Fh(\017)45 b Fi(AST)p Ft(__)p
Fi(SOMBCOS:)30 b(This)g(sc)n(heme)g(uses)g(a)g(k)n(ernel)f(of)i(the)g
(form)f(som)n(b\(pi)p Fh(\003)p Fi(x\).cos\(k)p Fh(\003)p
-Fi(pi)p Fh(\003)p Fi(x\),)f(with)i(k)f(a)427 3265 y(constan)n(t,)g(out)
+Fi(pi)p Fh(\003)p Fi(x\),)f(with)i(k)f(a)427 3840 y(constan)n(t,)g(out)
g(to)g(the)g(p)r(oin)n(t)g(where)f(cos\(k)p Fh(\003)p
Fi(pi)p Fh(\003)p Fi(x\))g(go)r(es)g(to)g(zero,)h(and)g(zero)e(b)r(ey)n
-(ond.)44 b(It)30 b(is)g(similar)f(to)427 3364 y(the)f(AST)p
+(ond.)44 b(It)30 b(is)g(similar)f(to)427 3940 y(the)f(AST)p
Ft(__)p Fi(SINCCOS)f(k)n(ernel,)g(and)h(has)f(the)h(same)f(parameter)f
-(usage.)227 3524 y(In)i(addition,)g(the)g(follo)n(wing)e(sc)n(hemes)h
+(usage.)227 4094 y(In)i(addition,)g(the)g(follo)n(wing)e(sc)n(hemes)h
(are)g(pro)n(vided)f(whic)n(h)i(are)e(not)i(based)f(on)g(a)g
-(1-dimensional)g(k)n(ernel:)340 3781 y Fh(\017)45 b Fi(AST)p
+(1-dimensional)g(k)n(ernel:)340 4343 y Fh(\017)45 b Fi(AST)p
Ft(__)p Fi(BLOCKA)-9 b(VE:)26 b(This)i(sc)n(heme)f(simply)h(tak)n(es)e
(an)i(a)n(v)n(erage)c(of)k(all)f(the)h(pixels)g(on)f(the)h(input)g
-(grid)427 3881 y(in)e(a)f(cub)r(e)h(cen)n(tred)g(on)f(the)h(in)n(terp)r
+(grid)427 4443 y(in)e(a)f(cub)r(e)h(cen)n(tred)g(on)f(the)h(in)n(terp)r
(olation)f(p)r(oin)n(t.)36 b(The)26 b(n)n(um)n(b)r(er)f(of)h(pixels)f
-(in)h(the)g(cub)r(e)g(is)f(determined)427 3981 y(b)n(y)k(the)h(v)-5
+(in)h(the)g(cub)r(e)g(is)f(determined)427 4543 y(b)n(y)k(the)h(v)-5
b(alue)29 b(of)h(the)g(\014rst)f(elemen)n(t)g(of)h(the)f
Ft(")p Fi(params)p Ft(")f Fi(arra)n(y)-7 b(,)27 b(whic)n(h)j(giv)n(es)e
-(the)i(n)n(um)n(b)r(er)f(of)g(pixels)g(in)427 4080 y(eac)n(h)24
+(the)i(n)n(um)n(b)r(er)f(of)g(pixels)g(in)427 4642 y(eac)n(h)24
b(dimension)h(on)f(either)h(side)f(of)h(the)g(cen)n(tral)f(p)r(oin)n
(t.)36 b(Hence)25 b(a)f(blo)r(c)n(k)g(of)h(\(2)f Fh(\003)g
-Fi(params[0]\))p Fh(^)p Fi(ndim)p Ft(_)p Fi(in)427 4180
+Fi(params[0]\))p Fh(^)p Fi(ndim)p Ft(_)p Fi(in)427 4742
y(pixels)31 b(in)g(the)g(input)g(grid)f(will)h(b)r(e)g(examined)f(to)h
(determine)g(the)g(v)-5 b(alue)30 b(of)h(the)g(output)g(pixel.)46
-b(If)31 b(the)427 4280 y(v)-5 b(ariance)36 b(is)g(not)h(b)r(eing)g
+b(If)31 b(the)427 4841 y(v)-5 b(ariance)36 b(is)g(not)h(b)r(eing)g
(used)f(\(v)-5 b(ar)p Ft(_)p Fi(in)36 b(or)g(v)-5 b(ar)p
Ft(_)p Fi(out)35 b(=)i(NULL\))g(then)g(all)f(v)-5 b(alid)37
-b(pixels)f(in)h(this)g(cub)r(e)427 4379 y(will)c(b)r(e)h(a)n(v)n
+b(pixels)f(in)h(this)g(cub)r(e)427 4941 y(will)c(b)r(e)h(a)n(v)n
(eraged)c(in)j(to)g(the)h(result)e(with)i(equal)e(w)n(eigh)n(t.)53
b(If)33 b(v)-5 b(ariances)31 b(are)h(b)r(eing)i(used,)g(then)f(eac)n(h)
-427 4479 y(input)25 b(pixel)f(will)f(b)r(e)i(w)n(eigh)n(ted)e(prop)r
+427 5041 y(input)25 b(pixel)f(will)f(b)r(e)i(w)n(eigh)n(ted)e(prop)r
(ortionally)e(to)j(the)g(recipro)r(cal)e(of)i(its)g(v)-5
-b(ariance;)24 b(an)n(y)e(pixel)i(without)427 4578 y(a)34
+b(ariance;)24 b(an)n(y)e(pixel)i(without)427 5140 y(a)34
b(v)-5 b(alid)35 b(v)-5 b(ariance)33 b(will)h(b)r(e)h(discarded.)57
b(This)34 b(sc)n(heme)g(is)g(suitable)g(where)g(the)h(output)g(grid)f
-(is)g(m)n(uc)n(h)427 4678 y(coarser)26 b(than)j(the)g(input)g(grid;)f
+(is)g(m)n(uc)n(h)427 5240 y(coarser)26 b(than)j(the)g(input)g(grid;)f
(if)h(the)g(ratio)e(of)h(pixel)h(sizes)f(is)g(R)h(then)f(a)g(suitable)h
-(v)-5 b(alue)28 b(of)g(params[0])427 4778 y(ma)n(y)f(b)r(e)h(R/2.)227
-4937 y(Finally)-7 b(,)35 b(supplying)f(the)f(follo)n(wing)g(v)-5
+(v)-5 b(alue)28 b(of)g(params[0])427 5340 y(ma)n(y)f(b)r(e)h(R/2.)227
+5494 y(Finally)-7 b(,)35 b(supplying)f(the)f(follo)n(wing)g(v)-5
b(alues)33 b(for)g Ft(")p Fi(in)n(terp)p Ft(")f Fi(allo)n(ws)h(y)n(ou)f
(to)i(implemen)n(t)g(y)n(our)e(o)n(wn)h(sub-pixel)227
-5037 y(in)n(terp)r(olation)25 b(sc)n(heme)h(b)n(y)f(means)h(of)f(y)n
+5593 y(in)n(terp)r(olation)25 b(sc)n(heme)h(b)n(y)f(means)h(of)f(y)n
(our)g(o)n(wn)g(function.)37 b(Y)-7 b(ou)26 b(should)f(supply)h(a)g(p)r
-(oin)n(ter)f(to)h(this)g(function)227 5137 y(via)h(the)h
-Ft(")p Fi(\014n)n(terp)p Ft(")f Fi(parameter:)340 5394
-y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(UKERN1:)38 b(In)28
-b(this)h(sc)n(heme,)f(y)n(ou)g(supply)h(a)f(function)h(to)f(ev)-5
-b(aluate)28 b(y)n(our)f(o)n(wn)h(1-dimensional)427 5494
+(oin)n(ter)f(to)h(this)g(function)227 5693 y(via)h(the)h
+Ft(")p Fi(\014n)n(terp)p Ft(")f Fi(parameter:)p eop end
+%%Page: 351 361
+TeXDict begin 351 360 bop 3643 52 a FF(351)340 483 y
+Fh(\017)45 b Fi(AST)p Ft(__)p Fi(UKERN1:)38 b(In)28 b(this)h(sc)n
+(heme,)f(y)n(ou)g(supply)h(a)f(function)h(to)f(ev)-5
+b(aluate)28 b(y)n(our)f(o)n(wn)h(1-dimensional)427 582
y(in)n(terp)r(olation)41 b(k)n(ernel,)j(whic)n(h)d(is)g(then)h(used)f
(to)h(p)r(erform)e(sub-pixel)h(in)n(terp)r(olation)g(\(as)g(describ)r
-(ed)427 5593 y(ab)r(o)n(v)n(e\).)j(The)30 b(function)g(y)n(ou)g(supply)
-g(should)g(ha)n(v)n(e)f(the)h(same)g(in)n(terface)f(as)g(the)i
-(\014ctitious)f(astUk)n(ern1)427 5693 y(function)h(\(q.v.\).)45
+(ed)427 682 y(ab)r(o)n(v)n(e\).)j(The)30 b(function)g(y)n(ou)g(supply)g
+(should)g(ha)n(v)n(e)f(the)h(same)g(in)n(terface)f(as)g(the)i
+(\014ctitious)f(astUk)n(ern1)427 782 y(function)h(\(q.v.\).)45
b(In)30 b(addition,)h(a)f(v)-5 b(alue)30 b(should)g(b)r(e)g(giv)n(en)g
(via)f Ft(")p Fi(params[0])p Ft(")f Fi(to)i(sp)r(ecify)g(the)h(n)n(um)n
-(b)r(er)p eop end
-%%Page: 350 360
-TeXDict begin 350 359 bop 0 52 a FF(350)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)427 351 y Fi(of)25
-b(neigh)n(b)r(ouring)f(pixels)g(whic)n(h)h(are)f(to)g(con)n(tribute)h
-(to)f(eac)n(h)g(in)n(terp)r(olated)g(v)-5 b(alue)25 b(\(in)g(the)h
-(same)e(w)n(a)n(y)f(as)427 451 y(for)28 b(the)g(pre-de\014ned)g(in)n
-(terp)r(olation)g(sc)n(hemes)f(describ)r(ed)h(ab)r(o)n(v)n(e\).)37
-b(Other)28 b(elemen)n(ts)g(of)g(the)h Ft(")p Fi(params)p
-Ft(")427 551 y Fi(arra)n(y)d(are)g(a)n(v)-5 b(ailable)26
-b(to)i(pass)f(v)-5 b(alues)27 b(to)g(y)n(our)g(in)n(terp)r(olation)f
-(function.)340 680 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(UINTERP:)26
-b(This)h(is)f(a)g(completely)h(general)e(sc)n(heme,)h(in)h(whic)n(h)g
-(y)n(our)e(in)n(terp)r(olation)h(function)427 780 y(has)35
-b(access)f(to)i(all)f(of)g(the)h(input)g(data.)60 b(This)35
-b(allo)n(ws)f(y)n(ou)h(to)g(implemen)n(t)h(an)n(y)f(in)n(terp)r
-(olation)f(algo-)427 880 y(rithm)i(y)n(ou)e(c)n(ho)r(ose,)h(whic)n(h)g
-(could)g(\(for)g(example\))g(b)r(e)g(non-linear,)h(or)e(adaptiv)n(e.)58
-b(In)35 b(this)g(case,)h(the)427 979 y(astResample)p
-Fk(<)p Fi(X)p Fk(>)e Fi(functions)i(pla)n(y)f(no)h(role)e(in)i(the)g
-(sub-pixel)g(in)n(terp)r(olation)f(pro)r(cess)f(and)i(simply)427
-1079 y(handle)29 b(the)g(geometrical)f(transformation)f(of)i(co)r
-(ordinates)e(and)i(other)f(housek)n(eeping.)39 b(The)29
-b(function)427 1179 y(y)n(ou)c(supply)g(should)g(ha)n(v)n(e)f(the)h
-(same)g(in)n(terface)g(as)f(the)i(\014ctitious)f(astUin)n(terp)g
-(function)g(\(q.v.\).)37 b(In)25 b(this)427 1278 y(case,)e(the)f
+(b)r(er)427 881 y(of)25 b(neigh)n(b)r(ouring)f(pixels)g(whic)n(h)h(are)
+f(to)g(con)n(tribute)h(to)f(eac)n(h)g(in)n(terp)r(olated)g(v)-5
+b(alue)25 b(\(in)g(the)h(same)e(w)n(a)n(y)f(as)427 981
+y(for)28 b(the)g(pre-de\014ned)g(in)n(terp)r(olation)g(sc)n(hemes)f
+(describ)r(ed)h(ab)r(o)n(v)n(e\).)37 b(Other)28 b(elemen)n(ts)g(of)g
+(the)h Ft(")p Fi(params)p Ft(")427 1081 y Fi(arra)n(y)d(are)g(a)n(v)-5
+b(ailable)26 b(to)i(pass)f(v)-5 b(alues)27 b(to)g(y)n(our)g(in)n(terp)r
+(olation)f(function.)340 1208 y Fh(\017)45 b Fi(AST)p
+Ft(__)p Fi(UINTERP:)26 b(This)h(is)f(a)g(completely)h(general)e(sc)n
+(heme,)h(in)h(whic)n(h)g(y)n(our)e(in)n(terp)r(olation)h(function)427
+1308 y(has)35 b(access)f(to)i(all)f(of)g(the)h(input)g(data.)60
+b(This)35 b(allo)n(ws)f(y)n(ou)h(to)g(implemen)n(t)h(an)n(y)f(in)n
+(terp)r(olation)f(algo-)427 1408 y(rithm)i(y)n(ou)e(c)n(ho)r(ose,)h
+(whic)n(h)g(could)g(\(for)g(example\))g(b)r(e)g(non-linear,)h(or)e
+(adaptiv)n(e.)58 b(In)35 b(this)g(case,)h(the)427 1507
+y(astResample)p Fk(<)p Fi(X)p Fk(>)e Fi(functions)i(pla)n(y)f(no)h
+(role)e(in)i(the)g(sub-pixel)g(in)n(terp)r(olation)f(pro)r(cess)f(and)i
+(simply)427 1607 y(handle)29 b(the)g(geometrical)f(transformation)f(of)
+i(co)r(ordinates)e(and)i(other)f(housek)n(eeping.)39
+b(The)29 b(function)427 1707 y(y)n(ou)c(supply)g(should)g(ha)n(v)n(e)f
+(the)h(same)g(in)n(terface)g(as)f(the)i(\014ctitious)f(astUin)n(terp)g
+(function)g(\(q.v.\).)37 b(In)25 b(this)427 1806 y(case,)e(the)f
Ft(")p Fi(params)p Ft(")e Fi(parameter)g(is)i(not)g(used)g(b)n(y)g
(astResample)p Fk(<)p Fi(X)p Fk(>)p Fi(,)g(but)g(is)g(a)n(v)-5
-b(ailable)21 b(to)h(pass)f(v)-5 b(alues)427 1378 y(to)28
-b(y)n(our)e(in)n(terp)r(olation)h(function.)-2 1537 y
-Fd(Con)m(trol)32 b(Flags)n(:)227 1683 y Fi(The)h(follo)n(wing)e
+b(ailable)21 b(to)h(pass)f(v)-5 b(alues)427 1906 y(to)28
+b(y)n(our)e(in)n(terp)r(olation)h(function.)-2 2063 y
+Fd(Con)m(trol)32 b(Flags)n(:)227 2209 y Fi(The)h(follo)n(wing)e
(\015ags)h(are)g(de\014ned)h(in)f(the)h Ft(")p Fi(ast.h)p
Ft(")f Fi(header)g(\014le)g(and)h(ma)n(y)f(b)r(e)h(used)f(to)h(pro)n
-(vide)e(additional)227 1782 y(con)n(trol)d(o)n(v)n(er)g(the)i
+(vide)e(additional)227 2308 y(con)n(trol)d(o)n(v)n(er)g(the)i
(resampling)e(pro)r(cess.)41 b(Ha)n(ving)28 b(selected)h(a)g(set)h(of)f
(\015ags,)g(y)n(ou)f(should)i(supply)f(the)h(bit)n(wise)227
-1882 y(OR)e(of)f(their)h(v)-5 b(alues)27 b(via)g(the)h
-Ft(")p Fi(\015ags)p Ft(")e Fi(parameter:)340 2139 y Fh(\017)45
+2408 y(OR)e(of)f(their)h(v)-5 b(alues)27 b(via)g(the)h
+Ft(")p Fi(\015ags)p Ft(")e Fi(parameter:)340 2662 y Fh(\017)45
b Fi(AST)p Ft(__)p Fi(NOBAD:)22 b(Indicates)g(that)h(an)n(y)e(output)i
(arra)n(y)d(elemen)n(ts)i(for)f(whic)n(h)i(no)e(resampled)h(v)-5
-b(alue)22 b(could)427 2238 y(b)r(e)g(obtained)f(should)h(b)r(e)f(left)i
+b(alue)22 b(could)427 2761 y(b)r(e)g(obtained)f(should)h(b)r(e)f(left)i
(set)e(to)g(the)h(v)-5 b(alue)21 b(they)h(had)f(on)h(en)n(try)e(to)i
(this)g(function.)35 b(If)22 b(this)g(\015ag)e(is)i(not)427
-2338 y(supplied,)34 b(suc)n(h)d(output)i(arra)n(y)d(elemen)n(ts)h(are)g
+2861 y(supplied,)34 b(suc)n(h)d(output)i(arra)n(y)d(elemen)n(ts)h(are)g
(set)h(to)g(the)h(v)-5 b(alue)31 b(supplied)i(for)e(parameter)g
-Ft(")p Fi(badv)-5 b(al)p Ft(")p Fi(.)427 2437 y(Note,)39
+Ft(")p Fi(badv)-5 b(al)p Ft(")p Fi(.)427 2961 y(Note,)39
b(this)d(\015ag)g(cannot)g(b)r(e)g(used)g(in)h(conjunction)f(with)h
(the)g(AST)p Ft(__)p Fi(CONSER)-9 b(VEFLUX)35 b(\015ag)h(\(an)427
-2537 y(error)26 b(will)i(b)r(e)g(rep)r(orted)f(if)h(b)r(oth)g(\015ags)e
-(are)h(sp)r(eci\014ed\).)340 2667 y Fh(\017)45 b Fi(AST)p
+3060 y(error)26 b(will)i(b)r(e)g(rep)r(orted)f(if)h(b)r(oth)g(\015ags)e
+(are)h(sp)r(eci\014ed\).)340 3188 y Fh(\017)45 b Fi(AST)p
Ft(__)p Fi(URESAMP1,)27 b(2,)g(3)g(&)h(4:)36 b(A)28 b(set)g(of)f(four)g
(\015ags)g(whic)n(h)g(are)g(reserv)n(ed)f(for)h(y)n(our)f(o)n(wn)h
-(use.)37 b(They)427 2767 y(ma)n(y)32 b(b)r(e)h(used)f(to)g(pass)g(priv)
+(use.)37 b(They)427 3288 y(ma)n(y)32 b(b)r(e)h(used)f(to)g(pass)g(priv)
-5 b(ate)31 b(information)h(to)g(an)n(y)g(sub-pixel)g(in)n(terp)r
-(olation)f(function)i(whic)n(h)f(y)n(ou)427 2866 y(implemen)n(t)c(y)n
+(olation)f(function)i(whic)n(h)f(y)n(ou)427 3387 y(implemen)n(t)c(y)n
(ourself.)36 b(They)28 b(are)e(ignored)h(b)n(y)g(all)g(the)h
(pre-de\014ned)f(in)n(terp)r(olation)g(sc)n(hemes.)340
-2996 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(USEBAD:)33 b(Indicates)g(that)h
+3515 y Fh(\017)45 b Fi(AST)p Ft(__)p Fi(USEBAD:)33 b(Indicates)g(that)h
(there)f(ma)n(y)f(b)r(e)i(bad)f(pixels)f(in)i(the)f(input)h(arra)n
-(y\(s\))d(whic)n(h)i(m)n(ust)427 3096 y(b)r(e)27 b(recognised)f(b)n(y)g
+(y\(s\))d(whic)n(h)i(m)n(ust)427 3615 y(b)r(e)27 b(recognised)f(b)n(y)g
(comparing)g(with)h(the)g(v)-5 b(alue)27 b(giv)n(en)f(for)g
Ft(")p Fi(badv)-5 b(al)p Ft(")26 b Fi(and)g(propagated)f(to)i(the)g
-(output)427 3195 y(arra)n(y\(s\).)35 b(If)26 b(this)h(\015ag)e(is)h
+(output)427 3714 y(arra)n(y\(s\).)35 b(If)26 b(this)h(\015ag)e(is)h
(not)g(set,)h(all)f(input)h(v)-5 b(alues)26 b(are)f(treated)h
(literally)f(and)h(the)h Ft(")p Fi(badv)-5 b(al)p Ft(")25
-b Fi(v)-5 b(alue)26 b(is)427 3295 y(only)h(used)h(for)f(\015agging)f
-(output)i(arra)n(y)d(v)-5 b(alues.)340 3425 y Fh(\017)45
+b Fi(v)-5 b(alue)26 b(is)427 3814 y(only)h(used)h(for)f(\015agging)f
+(output)i(arra)n(y)d(v)-5 b(alues.)340 3942 y Fh(\017)45
b Fi(AST)p Ft(__)p Fi(CONSER)-9 b(VEFLUX:)28 b(Indicates)h(that)f(the)h
(output)h(pixel)e(v)-5 b(alues)29 b(should)f(b)r(e)h(scaled)f(in)h(suc)
-n(h)f(a)427 3524 y(w)n(a)n(y)c(as)g(to)g(preserv)n(e)f(\(appro)n
+n(h)f(a)427 4042 y(w)n(a)n(y)c(as)g(to)g(preserv)n(e)f(\(appro)n
(ximately\))g(the)i(total)g(data)f(v)-5 b(alue)25 b(in)f(a)h(feature)f
-(on)g(the)h(sky)-7 b(.)36 b(Without)25 b(this)427 3624
+(on)g(the)h(sky)-7 b(.)36 b(Without)25 b(this)427 4141
y(\015ag,)k(eac)n(h)f(output)i(pixel)f(v)-5 b(alue)29
b(represen)n(ts)f(an)g(instan)n(taneous)g(sample)h(of)g(the)h(input)f
-(data)g(v)-5 b(alues)29 b(at)427 3724 y(the)e(corresp)r(onding)d(input)
+(data)g(v)-5 b(alues)29 b(at)427 4241 y(the)e(corresp)r(onding)d(input)
j(p)r(osition.)36 b(This)26 b(is)g(appropriate)e(if)i(the)h(input)g
-(data)e(represen)n(ts)g(the)h(spatial)427 3823 y(densit)n(y)k(of)f
+(data)e(represen)n(ts)g(the)h(spatial)427 4341 y(densit)n(y)k(of)f
(some)g(quan)n(tit)n(y)h(\(e.g.)43 b(surface)28 b(brigh)n(tness)h(in)h
(Janskys)e(p)r(er)i(square)e(arc-second\))g(b)r(ecause)427
-3923 y(the)g(output)f(pixel)g(v)-5 b(alues)26 b(will)h(ha)n(v)n(e)f
+4440 y(the)g(output)f(pixel)g(v)-5 b(alues)26 b(will)h(ha)n(v)n(e)f
(the)h(same)g(normalisation)e(and)i(units)g(as)f(the)h(input)h(pixel)f
-(v)-5 b(alues.)427 4023 y(Ho)n(w)n(ev)n(er,)27 b(if)i(the)g(input)g
+(v)-5 b(alues.)427 4540 y(Ho)n(w)n(ev)n(er,)27 b(if)i(the)g(input)g
(data)f(v)-5 b(alues)28 b(represen)n(t)f(\015ux)i(\(or)f(some)g(other)f
(ph)n(ysical)h(quan)n(tit)n(y\))g(p)r(er)h(pixel,)427
-4122 y(then)i(the)g(AST)p Ft(__)p Fi(CONSER)-9 b(VEFLUX)30
+4639 y(then)i(the)g(AST)p Ft(__)p Fi(CONSER)-9 b(VEFLUX)30
b(\015ag)g(could)h(b)r(e)g(used.)46 b(This)30 b(causes)g(eac)n(h)g
-(output)h(pixel)g(v)-5 b(alue)427 4222 y(to)28 b(b)r(e)g(scaled)f(b)n
+(output)h(pixel)g(v)-5 b(alue)427 4739 y(to)28 b(b)r(e)g(scaled)f(b)n
(y)g(the)h(ratio)f(of)g(the)h(output)g(pixel)g(size)f(to)h(the)g(input)
-g(pixel)g(size.)227 4381 y(This)38 b(\015ag)g(can)f(only)h(b)r(e)g
+g(pixel)g(size.)227 4896 y(This)38 b(\015ag)g(can)f(only)h(b)r(e)g
(used)h(if)f(the)h(Mapping)e(is)h(successfully)g(appro)n(ximated)e(b)n
-(y)i(one)g(or)f(more)g(linear)227 4480 y(transformations.)66
+(y)i(one)g(or)f(more)g(linear)227 4996 y(transformations.)66
b(Th)n(us)37 b(an)h(error)e(will)i(b)r(e)g(rep)r(orted)f(if)h(it)g
(used)g(when)g(the)g Ft(")p Fi(tol)p Ft(")f Fi(parameter)f(is)i(set)g
-(to)227 4580 y(zero)f(\(whic)n(h)h(stops)f(the)h(use)f(of)h(linear)f
+(to)227 5095 y(zero)f(\(whic)n(h)h(stops)f(the)h(use)f(of)h(linear)f
(appro)n(ximations\),)h(or)f(if)h(the)g(Mapping)f(is)h(to)r(o)f
-(non-linear)g(to)g(b)r(e)227 4680 y(appro)n(ximated)f(b)n(y)h(a)f
+(non-linear)g(to)g(b)r(e)227 5195 y(appro)n(ximated)f(b)n(y)h(a)f
(piece-wise)h(linear)f(transformation.)64 b(The)37 b(ratio)f(of)h
-(output)h(to)f(input)h(pixel)f(size)g(is)227 4779 y(ev)-5
+(output)h(to)f(input)h(pixel)f(size)g(is)227 5295 y(ev)-5
b(aluated)19 b(once)h(for)f(eac)n(h)f(panel)i(of)f(the)h(piece-wise)f
(linear)g(appro)n(ximation)e(to)j(the)g(Mapping,)g(and)g(is)f(assumed)
-227 4879 y(to)33 b(b)r(e)h(constan)n(t)f(for)g(all)g(output)g(pixels)g
+227 5394 y(to)33 b(b)r(e)h(constan)n(t)f(for)g(all)g(output)g(pixels)g
(in)h(the)g(panel.)54 b(The)33 b(scaling)f(factors)g(for)h(adjacen)n(t)
-g(panels)g(will)g(in)227 4979 y(general)f(di\013er)h(sligh)n(tly)-7
+g(panels)g(will)g(in)227 5494 y(general)f(di\013er)h(sligh)n(tly)-7
b(,)34 b(and)e(so)h(the)g(join)n(ts)g(b)r(et)n(w)n(een)g(panels)f(ma)n
(y)g(b)r(e)i(visible)e(when)h(viewing)g(the)g(output)227
-5078 y(image)i(at)g(high)h(con)n(trast.)59 b(If)36 b(this)f(is)h(a)f
+5593 y(image)i(at)g(high)h(con)n(trast.)59 b(If)36 b(this)f(is)h(a)f
(problem,)i(reduce)e(the)g(v)-5 b(alue)36 b(of)f(the)h
Ft(")p Fi(tol)p Ft(")e Fi(parameter)g(un)n(til)i(the)227
-5178 y(di\013erence)28 b(b)r(et)n(w)n(een)f(adjacen)n(t)g(panels)h(is)f
-(su\016cien)n(tly)h(small)f(to)g(b)r(e)h(insigni\014can)n(t.)227
-5301 y(Note,)22 b(this)e(\015ag)f(cannot)g(b)r(e)h(used)g(in)g
-(conjunction)g(with)g(the)h(AST)p Ft(__)p Fi(NOBAD)e(\015ag)g(\(an)h
-(error)e(will)i(b)r(e)g(rep)r(orted)227 5400 y(if)28
-b(b)r(oth)g(\015ags)f(are)g(sp)r(eci\014ed\).)-2 5547
-y Fd(Propagation)33 b(of)e(Missing)f(Data)n(:)227 5693
-y Fi(Unless)j(the)g(AST)p Ft(__)p Fi(NOBAD)g(\015ag)f(is)h(sp)r
+5693 y(di\013erence)28 b(b)r(et)n(w)n(een)f(adjacen)n(t)g(panels)h(is)f
+(su\016cien)n(tly)h(small)f(to)g(b)r(e)h(insigni\014can)n(t.)p
+eop end
+%%Page: 352 362
+TeXDict begin 352 361 bop 0 52 a FF(352)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)227 351 y Fi(Note,)22
+b(this)e(\015ag)f(cannot)g(b)r(e)h(used)g(in)g(conjunction)g(with)g
+(the)h(AST)p Ft(__)p Fi(NOBAD)e(\015ag)g(\(an)h(error)e(will)i(b)r(e)g
+(rep)r(orted)227 451 y(if)28 b(b)r(oth)g(\015ags)f(are)g(sp)r
+(eci\014ed\).)-2 610 y Fd(Propagation)33 b(of)e(Missing)f(Data)n(:)227
+756 y Fi(Unless)j(the)g(AST)p Ft(__)p Fi(NOBAD)g(\015ag)f(is)h(sp)r
(eci\014ed,)i(instances)d(of)h(missing)f(data)h(\(bad)g(pixels\))g(in)g
-(the)g(output)p eop end
-%%Page: 351 361
-TeXDict begin 351 360 bop 3643 52 a FF(351)227 351 y
-Fi(grid)23 b(are)f(iden)n(ti\014ed)h(b)n(y)g(o)r(ccurrences)e(of)i(the)
-h Ft(")p Fi(badv)-5 b(al)p Ft(")22 b Fi(v)-5 b(alue)22
-b(in)i(the)f Ft(")p Fi(out)p Ft(")f Fi(arra)n(y)-7 b(.)33
-b(These)23 b(ma)n(y)f(b)r(e)i(pro)r(duced)227 451 y(if)k(an)n(y)f(of)h
-(the)g(follo)n(wing)e(happ)r(en:)340 714 y Fh(\017)45
-b Fi(The)35 b(input)h(p)r(osition)f(\(the)h(transformed)e(p)r(osition)h
-(of)g(the)g(output)h(pixel's)f(cen)n(tre\))f(lies)h(outside)g(the)427
-814 y(b)r(oundary)27 b(of)h(the)g(grid)f(of)g(input)h(pixels.)340
-947 y Fh(\017)45 b Fi(The)32 b(input)h(p)r(osition)e(lies)h(inside)g
-(the)g(b)r(oundary)f(of)g(a)h(bad)f(input)i(pixel.)49
-b(In)32 b(this)g(con)n(text,)g(an)g(input)427 1047 y(pixel)h(is)g
-(considered)f(bad)h(if)h(its)f(data)g(v)-5 b(alue)33
-b(is)g(equal)f(to)h Ft(")p Fi(badv)-5 b(al)p Ft(")32
-b Fi(and)h(the)g(AST)p Ft(__)p Fi(USEBAD)g(\015ag)427
-1147 y(is)f(set)g(via)f(the)h Ft(")p Fi(\015ags)p Ft(")e
+(the)g(output)227 855 y(grid)23 b(are)f(iden)n(ti\014ed)h(b)n(y)g(o)r
+(ccurrences)e(of)i(the)h Ft(")p Fi(badv)-5 b(al)p Ft(")22
+b Fi(v)-5 b(alue)22 b(in)i(the)f Ft(")p Fi(out)p Ft(")f
+Fi(arra)n(y)-7 b(.)33 b(These)23 b(ma)n(y)f(b)r(e)i(pro)r(duced)227
+955 y(if)k(an)n(y)f(of)h(the)g(follo)n(wing)e(happ)r(en:)340
+1230 y Fh(\017)45 b Fi(The)35 b(input)h(p)r(osition)f(\(the)h
+(transformed)e(p)r(osition)h(of)g(the)g(output)h(pixel's)f(cen)n(tre\))
+f(lies)h(outside)g(the)427 1329 y(b)r(oundary)27 b(of)h(the)g(grid)f
+(of)g(input)h(pixels.)340 1467 y Fh(\017)45 b Fi(The)32
+b(input)h(p)r(osition)e(lies)h(inside)g(the)g(b)r(oundary)f(of)g(a)h
+(bad)f(input)i(pixel.)49 b(In)32 b(this)g(con)n(text,)g(an)g(input)427
+1566 y(pixel)h(is)g(considered)f(bad)h(if)h(its)f(data)g(v)-5
+b(alue)33 b(is)g(equal)f(to)h Ft(")p Fi(badv)-5 b(al)p
+Ft(")32 b Fi(and)h(the)g(AST)p Ft(__)p Fi(USEBAD)g(\015ag)427
+1666 y(is)f(set)g(via)f(the)h Ft(")p Fi(\015ags)p Ft(")e
Fi(parameter.)48 b(\(P)n(ositions)30 b(whic)n(h)i(ha)n(v)n(e)e(half-in)
n(tegral)h(co)r(ordinate)f(v)-5 b(alues,)33 b(and)427
-1246 y(therefore)c(lie)g(on)h(a)f(pixel)g(b)r(oundary)-7
+1766 y(therefore)c(lie)g(on)h(a)f(pixel)g(b)r(oundary)-7
b(,)30 b(are)e(regarded)g(as)h(lying)g(within)h(the)g(pixel)f(with)h
-(the)g(larger,)e(i.e.)427 1346 y(more)f(p)r(ositiv)n(e,)g(index.\))340
-1480 y Fh(\017)45 b Fi(The)27 b(set)g(of)g(neigh)n(b)r(ouring)e(input)j
+(the)g(larger,)e(i.e.)427 1865 y(more)f(p)r(ositiv)n(e,)g(index.\))340
+2003 y Fh(\017)45 b Fi(The)27 b(set)g(of)g(neigh)n(b)r(ouring)e(input)j
(pixels)f(\(excluding)f(those)h(whic)n(h)g(are)e(bad\))i(is)g
-(unsuitable)g(for)f(calcu-)427 1579 y(lating)g(an)f(in)n(terp)r(olated)
+(unsuitable)g(for)f(calcu-)427 2102 y(lating)g(an)f(in)n(terp)r(olated)
h(v)-5 b(alue.)36 b(Whether)26 b(this)g(is)g(true)f(ma)n(y)h(dep)r(end)
-g(on)g(the)g(sub-pixel)f(in)n(terp)r(olation)427 1679
-y(sc)n(heme)i(in)h(use.)340 1812 y Fh(\017)45 b Fi(The)31
+g(on)g(the)g(sub-pixel)f(in)n(terp)r(olation)427 2202
+y(sc)n(heme)i(in)h(use.)340 2339 y Fh(\017)45 b Fi(The)31
b(in)n(terp)r(olated)g(v)-5 b(alue)31 b(lies)g(outside)g(the)g(range)f
(whic)n(h)h(can)g(b)r(e)h(represen)n(ted)d(using)i(the)h(data)e(t)n(yp)
-r(e)427 1912 y(of)e(the)g Ft(")p Fi(out)p Ft(")f Fi(arra)n(y)-7
-b(.)227 2075 y(In)29 b(addition,)f(asso)r(ciated)f(output)i(v)-5
+r(e)427 2439 y(of)e(the)g Ft(")p Fi(out)p Ft(")f Fi(arra)n(y)-7
+b(.)227 2610 y(In)29 b(addition,)f(asso)r(ciated)f(output)i(v)-5
b(ariance)27 b(estimates)h(\(if)i(calculated\))e(ma)n(y)f(b)r(e)i
-(declared)e(bad)i(and)f(\015agged)227 2175 y(with)g(the)g
+(declared)e(bad)i(and)f(\015agged)227 2710 y(with)g(the)g
Ft(")p Fi(badv)-5 b(al)p Ft(")27 b Fi(v)-5 b(alue)27
b(in)h(the)g Ft(")p Fi(out)p Ft(_)p Fi(v)-5 b(ar)p Ft(")26
b Fi(arra)n(y)f(under)i(an)n(y)g(of)h(the)g(follo)n(wing)e
-(circumstances:)340 2438 y Fh(\017)45 b Fi(The)28 b(asso)r(ciated)e
+(circumstances:)340 2984 y Fh(\017)45 b Fi(The)28 b(asso)r(ciated)e
(resampled)h(data)g(v)-5 b(alue)28 b(\(in)g(the)g Ft(")p
-Fi(out)p Ft(")e Fi(arra)n(y\))g(is)h(bad.)340 2572 y
+Fi(out)p Ft(")e Fi(arra)n(y\))g(is)h(bad.)340 3122 y
Fh(\017)45 b Fi(The)19 b(set)g(of)g(neigh)n(b)r(ouring)e(input)j
(pixels)e(whic)n(h)h(con)n(tributed)g(to)f(the)i(output)f(data)f(v)-5
-b(alue)19 b(do)f(not)h(all)g(ha)n(v)n(e)427 2672 y(v)-5
+b(alue)19 b(do)f(not)h(all)g(ha)n(v)n(e)427 3222 y(v)-5
b(alid)34 b(v)-5 b(ariance)32 b(estimates)h(asso)r(ciated)f(with)h
(them.)55 b(In)33 b(this)h(con)n(text,)g(an)f(input)i(v)-5
-b(ariance)32 b(estimate)427 2771 y(ma)n(y)d(b)r(e)h(regarded)e(as)h
+b(ariance)32 b(estimate)427 3321 y(ma)n(y)d(b)r(e)h(regarded)e(as)h
(bad)h(either)f(b)r(ecause)g(it)i(has)e(the)h(v)-5 b(alue)29
b Ft(")p Fi(badv)-5 b(al)p Ft(")29 b Fi(\(and)h(the)g(AST)p
-Ft(__)p Fi(USEBAD)427 2871 y(\015ag)d(is)h(set\),)g(or)e(b)r(ecause)h
-(it)h(is)g(negativ)n(e.)340 3004 y Fh(\017)45 b Fi(The)23
+Ft(__)p Fi(USEBAD)427 3421 y(\015ag)d(is)h(set\),)g(or)e(b)r(ecause)h
+(it)h(is)g(negativ)n(e.)340 3558 y Fh(\017)45 b Fi(The)23
b(set)f(of)h(neigh)n(b)r(ouring)e(input)i(pixels)g(for)f(whic)n(h)g(v)
-5 b(alid)23 b(v)-5 b(ariance)21 b(v)-5 b(alues)22 b(are)g(a)n(v)-5
-b(ailable)21 b(is)h(unsuitable)427 3104 y(for)30 b(calculating)f(an)g
+b(ailable)21 b(is)h(unsuitable)427 3658 y(for)30 b(calculating)f(an)g
(o)n(v)n(erall)f(v)-5 b(ariance)28 b(v)-5 b(alue.)44
b(Whether)30 b(this)g(is)g(true)g(ma)n(y)f(dep)r(end)h(on)g(the)g
-(sub-pixel)427 3204 y(in)n(terp)r(olation)d(sc)n(heme)g(in)h(use.)340
-3337 y Fh(\017)45 b Fi(The)25 b(v)-5 b(ariance)23 b(v)-5
+(sub-pixel)427 3757 y(in)n(terp)r(olation)d(sc)n(heme)g(in)h(use.)340
+3895 y Fh(\017)45 b Fi(The)25 b(v)-5 b(ariance)23 b(v)-5
b(alue)25 b(lies)f(outside)h(the)g(range)e(whic)n(h)i(can)f(b)r(e)h
(represen)n(ted)e(using)i(the)g(data)f(t)n(yp)r(e)h(of)f(the)427
-3437 y Ft(")p Fi(out)p Ft(_)p Fi(v)-5 b(ar)p Ft(")26
-b Fi(arra)n(y)-7 b(.)227 3600 y(If)22 b(the)f(AST)p Ft(__)p
+3995 y Ft(")p Fi(out)p Ft(_)p Fi(v)-5 b(ar)p Ft(")26
+b Fi(arra)n(y)-7 b(.)227 4166 y(If)22 b(the)f(AST)p Ft(__)p
Fi(NOBAD)h(\015ag)e(is)h(sp)r(eci\014ed)g(via)g(parameter)f
Ft(")p Fi(\015ags)p Ft(")p Fi(,)g(then)i(output)g(arra)n(y)d(elemen)n
-(ts)i(that)g(w)n(ould)227 3700 y(otherwise)27 b(b)r(e)h(set)f(to)h
+(ts)i(that)g(w)n(ould)227 4265 y(otherwise)27 b(b)r(e)h(set)f(to)h
Ft(")p Fi(badv)-5 b(al)p Ft(")26 b Fi(are)h(instead)g(left)h(holding)f
(the)h(v)-5 b(alue)28 b(they)f(had)h(on)f(en)n(try)g(to)g(this)h
-(function.)227 3800 y(The)g(n)n(um)n(b)r(er)f(of)h(suc)n(h)f(arra)n(y)e
+(function.)227 4365 y(The)g(n)n(um)n(b)r(er)f(of)h(suc)n(h)f(arra)n(y)e
(elemen)n(ts)j(is)f(returned)g(as)g(the)h(function)h(v)-5
-b(alue.)p 0 4000 3780 12 v 0 4132 a Fz(astResolv)l(e)335
+b(alue.)p 0 4573 3780 12 v 0 4705 a Fz(astResolv)l(e)335
b Fe(Resolv)m(e)38 b(a)g(v)m(ector)f(in)m(to)h(t)m(w)m(o)f(orthogonal)
-1587 4232 y(comp)s(onen)m(ts)3161 4132 y Fz(astResolv)l(e)0
-4422 y Fd(Description:)44 b Fi(This)c(function)h(resolv)n(es)c(a)j(v)n
+1587 4805 y(comp)s(onen)m(ts)3161 4705 y Fz(astResolv)l(e)0
+5003 y Fd(Description:)44 b Fi(This)c(function)h(resolv)n(es)c(a)j(v)n
(ector)e(in)n(to)i(t)n(w)n(o)f(p)r(erp)r(endicular)g(comp)r(onen)n(ts.)
-74 b(The)39 b(v)n(ector)g(from)227 4522 y(p)r(oin)n(t)30
+74 b(The)39 b(v)n(ector)g(from)227 5102 y(p)r(oin)n(t)30
b(1)f(to)g(p)r(oin)n(t)h(2)f(is)g(used)h(as)f(the)g(basis)g(v)n(ector.)
41 b(The)30 b(v)n(ector)e(from)h(p)r(oin)n(t)h(1)f(to)g(p)r(oin)n(t)h
-(3)f(is)g(resolv)n(ed)f(in)n(to)227 4621 y(comp)r(onen)n(ts)33
+(3)f(is)g(resolv)n(ed)f(in)n(to)227 5202 y(comp)r(onen)n(ts)33
b(parallel)f(and)h(p)r(erp)r(endicular)f(to)h(this)h(basis)e(v)n
(ector.)52 b(The)33 b(lengths)g(of)g(the)h(t)n(w)n(o)e(comp)r(onen)n
-(ts)227 4721 y(are)27 b(returned,)g(together)g(with)h(the)g(p)r
+(ts)227 5302 y(are)27 b(returned,)g(together)g(with)h(the)g(p)r
(osition)f(of)h(closest)f(aproac)n(h)e(of)j(the)g(basis)f(v)n(ector)f
-(to)h(p)r(oin)n(t)h(3.)0 4872 y Fd(Synopsis:)121 b Ft(void)42
+(to)h(p)r(oin)n(t)h(3.)0 5460 y Fd(Synopsis:)121 b Ft(void)42
b(astResolve\()d(AstFrame)h Fh(\003)p Ft(this,)h(const)h(double)f
-(point1[],)f(const)h(double)g(point2[],)227 4972 y(const)h(double)f
+(point1[],)f(const)h(double)g(point2[],)227 5560 y(const)h(double)f
(point3[],)f(double)h(point4[],)f(double)h Fh(\003)p
-Ft(d1,)h(double)f Fh(\003)p Ft(d2)h(\);)0 5123 y Fd(P)m(arameters:)259
-5261 y(this)427 5360 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
-b(rame.)259 5494 y Fd(p)s(oin)m(t1)427 5593 y Fi(An)27
+Ft(d1,)h(double)f Fh(\003)p Ft(d2)h(\);)0 5718 y Fd(P)m(arameters:)p
+eop end
+%%Page: 353 363
+TeXDict begin 353 362 bop 3643 52 a FF(353)259 351 y
+Fd(this)427 451 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
+b(rame.)259 586 y Fd(p)s(oin)m(t1)427 686 y Fi(An)27
b(arra)n(y)d(of)j(double,)f(with)h(one)f(elemen)n(t)h(for)f(eac)n(h)f
(F)-7 b(rame)26 b(axis)g(\(Naxes)g(attribute\).)37 b(This)26
-b(marks)f(the)427 5693 y(start)i(of)h(the)g(basis)f(v)n(ector,)f(and)h
-(of)h(the)g(v)n(ector)e(to)i(b)r(e)g(resolv)n(ed.)p eop
-end
-%%Page: 352 362
-TeXDict begin 352 361 bop 0 52 a FF(352)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(p)s(oin)m(t2)427
-451 y Fi(An)d(arra)n(y)d(of)j(double,)f(with)h(one)f(elemen)n(t)h(for)f
-(eac)n(h)f(F)-7 b(rame)26 b(axis)g(\(Naxes)g(attribute\).)37
-b(This)26 b(marks)f(the)427 551 y(end)j(of)g(the)g(basis)e(v)n(ector.)
-259 708 y Fd(p)s(oin)m(t3)427 808 y Fi(An)h(arra)n(y)d(of)j(double,)f
+b(marks)f(the)427 786 y(start)i(of)h(the)g(basis)f(v)n(ector,)f(and)h
+(of)h(the)g(v)n(ector)e(to)i(b)r(e)g(resolv)n(ed.)259
+921 y Fd(p)s(oin)m(t2)427 1021 y Fi(An)f(arra)n(y)d(of)j(double,)f
(with)h(one)f(elemen)n(t)h(for)f(eac)n(h)f(F)-7 b(rame)26
b(axis)g(\(Naxes)g(attribute\).)37 b(This)26 b(marks)f(the)427
-907 y(end)j(of)g(the)g(v)n(ector)e(to)h(b)r(e)h(resolv)n(ed.)259
-1065 y Fd(p)s(oin)m(t4)427 1164 y Fi(An)34 b(arra)n(y)e(of)i(double,)h
-(with)f(one)f(elemen)n(t)h(for)f(eac)n(h)g(F)-7 b(rame)34
-b(axis)e(in)i(whic)n(h)g(the)g(co)r(ordinates)f(of)g(the)427
-1264 y(p)r(oin)n(t)28 b(of)g(closest)e(approac)n(h)g(of)i(the)g(basis)f
-(v)n(ector)f(to)h(p)r(oin)n(t)h(3)f(will)h(b)r(e)g(returned.)259
-1421 y Fd(d1)427 1521 y Fi(The)d(address)e(of)h(a)g(lo)r(cation)g(at)h
-(whic)n(h)f(to)g(return)g(the)h(distance)f(from)g(p)r(oin)n(t)h(1)f(to)
-g(p)r(oin)n(t)h(4)f(\(that)h(is,)g(the)427 1621 y(length)31
-b(of)f(the)h(comp)r(onen)n(t)f(parallel)f(to)h(the)h(basis)f(v)n
-(ector\).)44 b(P)n(ositiv)n(e)29 b(v)-5 b(alues)30 b(are)f(in)i(the)f
-(same)g(sense)427 1720 y(as)d(mo)n(v)n(emen)n(t)g(from)g(p)r(oin)n(t)h
-(1)f(to)h(p)r(oin)n(t)f(2.)259 1878 y Fd(d2)427 1977
-y Fi(The)e(address)e(of)h(a)g(lo)r(cation)g(at)h(whic)n(h)f(to)g
-(return)g(the)h(distance)f(from)g(p)r(oin)n(t)h(4)f(to)g(p)r(oin)n(t)h
-(3)f(\(that)h(is,)g(the)427 2077 y(length)j(of)g(the)f(comp)r(onen)n(t)
-h(p)r(erp)r(endicular)f(to)h(the)g(basis)e(v)n(ector\).)36
-b(The)28 b(v)-5 b(alue)27 b(is)h(alw)n(a)n(ys)e(p)r(ositiv)n(e.)0
-2288 y Fd(Notes:)340 2620 y Fh(\017)45 b Fi(Eac)n(h)36
-b(v)n(ector)g(used)h(in)h(this)f(function)h(is)f(the)h(path)f(of)g
-(shortest)f(distance)h(b)r(et)n(w)n(een)g(t)n(w)n(o)g(p)r(oin)n(ts,)i
-(as)427 2720 y(de\014ned)28 b(b)n(y)g(the)g(astDistance)f(function.)340
-2877 y Fh(\017)45 b Fi(This)19 b(function)g(will)g(return)f
-Ft(")p Fi(bad)p Ft(")g Fi(co)r(ordinate)g(v)-5 b(alues)18
-b(\(AST)p Ft(__)p Fi(BAD\))i(if)f(an)n(y)f(of)g(the)i(input)f(co)r
-(ordinates)427 2977 y(has)27 b(this)h(v)-5 b(alue,)28
-b(or)e(if)j(the)f(required)e(output)i(v)-5 b(alues)28
-b(are)e(unde\014ned.)p 0 3225 3780 12 v 0 3357 a Fz(astRetainFits)218
-b Fe(Indicate)38 b(that)g(the)h(curren)m(t)e(card)h(in)h(a)1160
-3457 y(FitsChan)f(should)g(b)s(e)h(retained)2990 3357
-y Fz(astRetainFits)0 3671 y Fd(Description:)44 b Fi(This)26
-b(function)h(stores)d(a)i(\015ag)f(with)h(the)g(curren)n(t)f(card)g(in)
-h(the)h(FitsChan)e(indicating)h(that)g(the)g(card)227
-3771 y(should)20 b(not)h(b)r(e)g(remo)n(v)n(ed)e(from)h(the)g(FitsChan)
-h(when)g(an)f(Ob)5 b(ject)20 b(is)g(read)g(from)g(the)h(FitsChan)f
-(using)g(astRead.)227 3920 y(Cards)j(that)i(ha)n(v)n(e)e(not)h(b)r(een)
-g(\015agged)f(in)i(this)f(w)n(a)n(y)f(are)g(remo)n(v)n(ed)f(when)j(a)e
-(read)h(op)r(eration)f(completes)h(succes-)227 4020 y(fully)-7
-b(,)27 b(but)f(only)g(if)g(the)g(card)f(w)n(as)f(used)i(in)g(the)g(pro)
-r(cess)e(of)i(creating)f(the)h(returned)f(AST)h(Ob)5
-b(ject.)36 b(An)n(y)26 b(cards)227 4120 y(that)g(are)e(irrelev)-5
+1121 y(end)j(of)g(the)g(basis)e(v)n(ector.)259 1256 y
+Fd(p)s(oin)m(t3)427 1356 y Fi(An)h(arra)n(y)d(of)j(double,)f(with)h
+(one)f(elemen)n(t)h(for)f(eac)n(h)f(F)-7 b(rame)26 b(axis)g(\(Naxes)g
+(attribute\).)37 b(This)26 b(marks)f(the)427 1455 y(end)j(of)g(the)g(v)
+n(ector)e(to)h(b)r(e)h(resolv)n(ed.)259 1591 y Fd(p)s(oin)m(t4)427
+1690 y Fi(An)34 b(arra)n(y)e(of)i(double,)h(with)f(one)f(elemen)n(t)h
+(for)f(eac)n(h)g(F)-7 b(rame)34 b(axis)e(in)i(whic)n(h)g(the)g(co)r
+(ordinates)f(of)g(the)427 1790 y(p)r(oin)n(t)28 b(of)g(closest)e
+(approac)n(h)g(of)i(the)g(basis)f(v)n(ector)f(to)h(p)r(oin)n(t)h(3)f
+(will)h(b)r(e)g(returned.)259 1926 y Fd(d1)427 2025 y
+Fi(The)d(address)e(of)h(a)g(lo)r(cation)g(at)h(whic)n(h)f(to)g(return)g
+(the)h(distance)f(from)g(p)r(oin)n(t)h(1)f(to)g(p)r(oin)n(t)h(4)f
+(\(that)h(is,)g(the)427 2125 y(length)31 b(of)f(the)h(comp)r(onen)n(t)f
+(parallel)f(to)h(the)h(basis)f(v)n(ector\).)44 b(P)n(ositiv)n(e)29
+b(v)-5 b(alues)30 b(are)f(in)i(the)f(same)g(sense)427
+2225 y(as)d(mo)n(v)n(emen)n(t)g(from)g(p)r(oin)n(t)h(1)f(to)h(p)r(oin)n
+(t)f(2.)259 2360 y Fd(d2)427 2460 y Fi(The)e(address)e(of)h(a)g(lo)r
+(cation)g(at)h(whic)n(h)f(to)g(return)g(the)h(distance)f(from)g(p)r
+(oin)n(t)h(4)f(to)g(p)r(oin)n(t)h(3)f(\(that)h(is,)g(the)427
+2559 y(length)j(of)g(the)f(comp)r(onen)n(t)h(p)r(erp)r(endicular)f(to)h
+(the)g(basis)e(v)n(ector\).)36 b(The)28 b(v)-5 b(alue)27
+b(is)h(alw)n(a)n(ys)e(p)r(ositiv)n(e.)0 2727 y Fd(Notes:)340
+3015 y Fh(\017)45 b Fi(Eac)n(h)36 b(v)n(ector)g(used)h(in)h(this)f
+(function)h(is)f(the)h(path)f(of)g(shortest)f(distance)h(b)r(et)n(w)n
+(een)g(t)n(w)n(o)g(p)r(oin)n(ts,)i(as)427 3114 y(de\014ned)28
+b(b)n(y)g(the)g(astDistance)f(function.)340 3250 y Fh(\017)45
+b Fi(This)19 b(function)g(will)g(return)f Ft(")p Fi(bad)p
+Ft(")g Fi(co)r(ordinate)g(v)-5 b(alues)18 b(\(AST)p Ft(__)p
+Fi(BAD\))i(if)f(an)n(y)f(of)g(the)i(input)f(co)r(ordinates)427
+3349 y(has)27 b(this)h(v)-5 b(alue,)28 b(or)e(if)j(the)f(required)e
+(output)i(v)-5 b(alues)28 b(are)e(unde\014ned.)p 0 3554
+3780 12 v 0 3686 a Fz(astRetainFits)218 b Fe(Indicate)38
+b(that)g(the)h(curren)m(t)e(card)h(in)h(a)1160 3785 y(FitsChan)f
+(should)g(b)s(e)h(retained)2990 3686 y Fz(astRetainFits)0
+3956 y Fd(Description:)44 b Fi(This)26 b(function)h(stores)d(a)i
+(\015ag)f(with)h(the)g(curren)n(t)f(card)g(in)h(the)h(FitsChan)e
+(indicating)h(that)g(the)g(card)227 4056 y(should)20
+b(not)h(b)r(e)g(remo)n(v)n(ed)e(from)h(the)g(FitsChan)h(when)g(an)f(Ob)
+5 b(ject)20 b(is)g(read)g(from)g(the)h(FitsChan)f(using)g(astRead.)227
+4183 y(Cards)j(that)i(ha)n(v)n(e)e(not)h(b)r(een)g(\015agged)f(in)i
+(this)f(w)n(a)n(y)f(are)g(remo)n(v)n(ed)f(when)j(a)e(read)h(op)r
+(eration)f(completes)h(succes-)227 4283 y(fully)-7 b(,)27
+b(but)f(only)g(if)g(the)g(card)f(w)n(as)f(used)i(in)g(the)g(pro)r(cess)
+e(of)i(creating)f(the)h(returned)f(AST)h(Ob)5 b(ject.)36
+b(An)n(y)26 b(cards)227 4383 y(that)g(are)e(irrelev)-5
b(an)n(t)24 b(to)i(the)f(creation)g(of)g(the)h(AST)f(Ob)5
b(ject)26 b(are)e(retained)h(whether)g(or)g(not)g(they)g(are)g
-(\015agged.)0 4318 y Fd(Synopsis:)121 b Ft(void)42 b(astRetainFits\()c
-(AstFitsChan)h Fh(\003)p Ft(this)i(\))0 4517 y Fd(P)m(arameters:)259
-4703 y(this)427 4802 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)0
-5014 y Fd(Notes:)340 5345 y Fh(\017)45 b Fi(This)23 b(function)f
+(\015agged.)0 4538 y Fd(Synopsis:)121 b Ft(void)42 b(astRetainFits\()c
+(AstFitsChan)h Fh(\003)p Ft(this)i(\))0 4692 y Fd(P)m(arameters:)259
+4834 y(this)427 4934 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(FitsChan.)0
+5101 y Fd(Notes:)340 5389 y Fh(\017)45 b Fi(This)23 b(function)f
(returns)g(without)h(action)e(if)i(the)g(FitsChan)f(is)h(initially)f(p)
r(ositioned)g(at)g(the)h Ft(")p Fi(end-of-\014le)p Ft(")427
-5445 y Fi(\(i.e.)38 b(if)28 b(the)g(Card)e(attribute)i(exceeds)f(the)h
+5489 y Fi(\(i.e.)38 b(if)28 b(the)g(Card)e(attribute)i(exceeds)f(the)h
(n)n(um)n(b)r(er)f(of)h(cards)e(in)i(the)g(FitsChan\).)340
-5602 y Fh(\017)45 b Fi(The)28 b(curren)n(t)f(card)f(is)i(not)f(c)n
+5624 y Fh(\017)45 b Fi(The)28 b(curren)n(t)f(card)f(is)i(not)f(c)n
(hanged)g(b)n(y)g(this)h(function.)p eop end
-%%Page: 353 363
-TeXDict begin 353 362 bop 3643 52 a FF(353)p 0 351 3780
-12 v 0 482 a Fz(astSame)800 483 y Fe(T)-10 b(est)38 b(if)g(t)m(w)m(o)f
-(AST)i(p)s(oin)m(ters)e(refer)h(to)g(the)h(same)1716
-598 y(Ob)7 b(ject)3295 482 y Fz(astSame)0 786 y Fd(Description:)44
+%%Page: 354 364
+TeXDict begin 354 363 bop 0 52 a FF(354)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 482 a Fz(astSame)800 483 y Fe(T)-10 b(est)38 b(if)g(t)m(w)m(o)f(AST)i
+(p)s(oin)m(ters)e(refer)h(to)g(the)h(same)1716 598 y(Ob)7
+b(ject)3295 482 y Fz(astSame)0 786 y Fd(Description:)44
b Fi(This)30 b(function)h(returns)e(a)h(b)r(o)r(olean)f(result)h(\(0)g
(or)f(1\))h(to)g(indicate)g(whether)g(t)n(w)n(o)f(p)r(oin)n(ters)g
(refer)h(to)227 886 y(the)e(same)f(Ob)5 b(ject.)0 1033
@@ -124494,17 +124600,16 @@ Ft(astSelectorMap)o(\()g(int)k(nreg,)f(AstRegion)f Fh(\003)p
Ft(regs[],)g(double)i(badval,)e(const)227 5571 y(char)i
Fh(\003)p Ft(options,)e(...)86 b(\))0 5718 y Fd(P)m(arameters:)p
eop end
-%%Page: 354 364
-TeXDict begin 354 363 bop 0 52 a FF(354)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(nreg)427
-451 y Fi(The)e(n)n(um)n(b)r(er)f(of)h(supplied)g(Regions.)259
-577 y Fd(regs)427 677 y Fi(An)41 b(arra)n(y)d(of)j(p)r(oin)n(ters)f(to)
-g(the)h(Regions.)74 b(All)41 b(the)g(supplied)g(Regions)f(m)n(ust)g
-(relate)g(to)g(the)h(same)427 777 y(co)r(ordinate)23
-b(F)-7 b(rame.)35 b(The)23 b(n)n(um)n(b)r(er)g(of)h(axes)e(in)i(this)g
-(co)r(ordinate)e(F)-7 b(rame)23 b(de\014nes)h(the)f(n)n(um)n(b)r(er)h
-(of)f(inputs)427 876 y(for)k(the)h(SelectorMap.)259 1003
-y Fd(badv)-5 b(al)427 1102 y Fi(The)35 b(v)-5 b(alue)34
+%%Page: 355 365
+TeXDict begin 355 364 bop 3643 52 a FF(355)259 351 y
+Fd(nreg)427 451 y Fi(The)28 b(n)n(um)n(b)r(er)f(of)h(supplied)g
+(Regions.)259 577 y Fd(regs)427 677 y Fi(An)41 b(arra)n(y)d(of)j(p)r
+(oin)n(ters)f(to)g(the)h(Regions.)74 b(All)41 b(the)g(supplied)g
+(Regions)f(m)n(ust)g(relate)g(to)g(the)h(same)427 777
+y(co)r(ordinate)23 b(F)-7 b(rame.)35 b(The)23 b(n)n(um)n(b)r(er)g(of)h
+(axes)e(in)i(this)g(co)r(ordinate)e(F)-7 b(rame)23 b(de\014nes)h(the)f
+(n)n(um)n(b)r(er)h(of)f(inputs)427 876 y(for)k(the)h(SelectorMap.)259
+1003 y Fd(badv)-5 b(al)427 1102 y Fi(The)35 b(v)-5 b(alue)34
b(to)g(b)r(e)h(returned)e(b)n(y)h(the)h(forw)n(ard)e(transformation)f
(of)j(the)f(SelectorMap)g(for)f(an)n(y)h(input)427 1202
y(p)r(ositions)27 b(that)h(ha)n(v)n(e)f(a)g(bad)g(\(AST)p
@@ -124574,10 +124679,11 @@ y Fd(settings)427 5593 y Fi(P)n(oin)n(ter)27 b(to)i(a)g(n)n
(ull-terminated)f(c)n(haracter)f(string)h(con)n(taining)g(a)g
(comma-separated)f(list)i(of)f(attribute)427 5693 y(settings)g(in)f
(the)h(form)g(describ)r(ed)f(ab)r(o)n(v)n(e.)p eop end
-%%Page: 355 365
-TeXDict begin 355 364 bop 3643 52 a FF(355)259 351 y
-Fd(...)427 451 y Fi(Optional)31 b(additional)g(argumen)n(ts)f(whic)n(h)
-h(supply)h(v)-5 b(alues)31 b(to)g(b)r(e)h(substituted)g(for)f(an)n(y)g
+%%Page: 356 366
+TeXDict begin 356 365 bop 0 52 a FF(356)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(...)427
+451 y Fi(Optional)h(additional)g(argumen)n(ts)f(whic)n(h)h(supply)h(v)
+-5 b(alues)31 b(to)g(b)r(e)h(substituted)g(for)f(an)n(y)g
Ft(")p Fi(prin)n(tf)p Ft(")p Fi(-st)n(yle)427 551 y(format)c(sp)r
(eci\014ers)g(that)h(app)r(ear)f(in)h(the)g Ft(")p Fi(settings)p
Ft(")e Fi(string.)0 715 y Fd(Class)31 b(Applicabilit)m(y:)259
@@ -124653,38 +124759,37 @@ r(e)h(corresp)r(onding)e(to)h Fk(<)p Fi(X)p Fk(>)g Fi(\(or,)h(in)g(the)
f(case)427 5672 y(of)j(astSetC,)f(a)h(p)r(oin)n(ter)f(to)g(a)g(n)n
(ull-terminated)h(c)n(haracter)d(string)i(con)n(taining)g(this)h(v)-5
b(alue\).)p eop end
-%%Page: 356 366
-TeXDict begin 356 365 bop 0 52 a FF(356)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Class)h(Applicabilit)m
-(y:)259 486 y(Ob)5 b(ject)427 585 y Fi(These)28 b(functions)f(apply)h
-(to)f(all)h(Ob)5 b(jects.)0 745 y Fd(Examples:)227 884
-y Fp(astSetI\()46 b(frame,)g Ft(")p Fp(Preserve)p Ft(")p
-Fp(,)e(1)k(\);)427 980 y Fi(Sets)28 b(the)g(Preserv)n(e)d(attribute)j
-(v)-5 b(alue)27 b(for)g(Ob)5 b(ject)28 b Ft(")p Fi(frame)p
-Ft(")e Fi(to)i(1.)227 1111 y Fp(astSetC\()46 b(plot,)g
-Ft(")p Fp(Format\(1\))p Ft(")p Fp(,)e Ft(")p Fp(\045.2g)p
-Ft(")i Fp(\);)427 1210 y Fi(Sets)28 b(the)g(F)-7 b(ormat\(1\))27
-b(attribute)h(v)-5 b(alue)27 b(for)g(Ob)5 b(ject)28 b
-Ft(")p Fi(plot)p Ft(")f Fi(to)g(the)h(c)n(haracter)e(string)h
-Ft(")p Fi(\045.2g)p Ft(")p Fi(.)0 1370 y Fd(Notes:)340
-1651 y Fh(\017)45 b Fi(A)n(ttribute)28 b(names)g(are)e(not)i(case)f
-(sensitiv)n(e)g(and)g(ma)n(y)g(b)r(e)h(surrounded)e(b)n(y)i(white)g
-(space.)340 1782 y Fh(\017)45 b Fi(An)28 b(error)e(will)i(result)f(if)h
-(an)g(attempt)g(is)f(made)h(to)f(set)h(a)f(v)-5 b(alue)27
-b(for)g(a)h(read-only)e(attribute.)p 0 1977 3780 12 v
-0 2109 a Fz(astSetActiv)l(eUnit)344 b Fe(Sp)s(ecify)39
-b(ho)m(w)f(the)g(Unit)1263 2223 y(attribute)e(should)j(b)s(e)g(used)
-2773 2109 y Fz(astSetActiv)l(eUnit)0 2385 y Fd(Description:)44
-b Fi(This)22 b(function)h(sets)e(the)i(curren)n(t)e(v)-5
-b(alue)22 b(of)f(the)i(Activ)n(eUnit)f(\015ag)g(for)f(a)g(F)-7
-b(rame,)23 b(whic)n(h)f(con)n(trols)e(ho)n(w)227 2485
-y(the)30 b(F)-7 b(rame)30 b(b)r(eha)n(v)n(es)e(when)i(it)g(is)g(used)g
-(\(b)n(y)f(astFindF)-7 b(rame)30 b(or)e(astCon)n(v)n(ert\))h(to)g(matc)
-n(h)h(another)e(F)-7 b(rame.)43 b(If)227 2584 y(the)23
-b(Activ)n(eUnit)g(\015ag)e(is)h(set)g(in)g(b)r(oth)h(template)f(and)g
-(target)f(F)-7 b(rames)21 b(then)i(the)f(returned)g(Mapping)g(tak)n(es)
-f(in)n(to)227 2684 y(accoun)n(t)26 b(an)n(y)h(di\013erences)f(in)i
-(axis)e(units.)37 b(The)27 b(default)h(v)-5 b(alue)27
+%%Page: 357 367
+TeXDict begin 357 366 bop 3643 52 a FF(357)0 351 y Fd(Class)31
+b(Applicabilit)m(y:)259 486 y(Ob)5 b(ject)427 585 y Fi(These)28
+b(functions)f(apply)h(to)f(all)h(Ob)5 b(jects.)0 745
+y Fd(Examples:)227 884 y Fp(astSetI\()46 b(frame,)g Ft(")p
+Fp(Preserve)p Ft(")p Fp(,)e(1)k(\);)427 980 y Fi(Sets)28
+b(the)g(Preserv)n(e)d(attribute)j(v)-5 b(alue)27 b(for)g(Ob)5
+b(ject)28 b Ft(")p Fi(frame)p Ft(")e Fi(to)i(1.)227 1111
+y Fp(astSetC\()46 b(plot,)g Ft(")p Fp(Format\(1\))p Ft(")p
+Fp(,)e Ft(")p Fp(\045.2g)p Ft(")i Fp(\);)427 1210 y Fi(Sets)28
+b(the)g(F)-7 b(ormat\(1\))27 b(attribute)h(v)-5 b(alue)27
+b(for)g(Ob)5 b(ject)28 b Ft(")p Fi(plot)p Ft(")f Fi(to)g(the)h(c)n
+(haracter)e(string)h Ft(")p Fi(\045.2g)p Ft(")p Fi(.)0
+1370 y Fd(Notes:)340 1651 y Fh(\017)45 b Fi(A)n(ttribute)28
+b(names)g(are)e(not)i(case)f(sensitiv)n(e)g(and)g(ma)n(y)g(b)r(e)h
+(surrounded)e(b)n(y)i(white)g(space.)340 1782 y Fh(\017)45
+b Fi(An)28 b(error)e(will)i(result)f(if)h(an)g(attempt)g(is)f(made)h
+(to)f(set)h(a)f(v)-5 b(alue)27 b(for)g(a)h(read-only)e(attribute.)p
+0 1977 3780 12 v 0 2109 a Fz(astSetActiv)l(eUnit)344
+b Fe(Sp)s(ecify)39 b(ho)m(w)f(the)g(Unit)1263 2223 y(attribute)e
+(should)j(b)s(e)g(used)2773 2109 y Fz(astSetActiv)l(eUnit)0
+2385 y Fd(Description:)44 b Fi(This)22 b(function)h(sets)e(the)i
+(curren)n(t)e(v)-5 b(alue)22 b(of)f(the)i(Activ)n(eUnit)f(\015ag)g(for)
+f(a)g(F)-7 b(rame,)23 b(whic)n(h)f(con)n(trols)e(ho)n(w)227
+2485 y(the)30 b(F)-7 b(rame)30 b(b)r(eha)n(v)n(es)e(when)i(it)g(is)g
+(used)g(\(b)n(y)f(astFindF)-7 b(rame)30 b(or)e(astCon)n(v)n(ert\))h(to)
+g(matc)n(h)h(another)e(F)-7 b(rame.)43 b(If)227 2584
+y(the)23 b(Activ)n(eUnit)g(\015ag)e(is)h(set)g(in)g(b)r(oth)h(template)
+f(and)g(target)f(F)-7 b(rames)21 b(then)i(the)f(returned)g(Mapping)g
+(tak)n(es)f(in)n(to)227 2684 y(accoun)n(t)26 b(an)n(y)h(di\013erences)f
+(in)i(axis)e(units.)37 b(The)27 b(default)h(v)-5 b(alue)27
b(for)f(simple)h(F)-7 b(rames)27 b(is)g(zero,)f(whic)n(h)h(preserv)n
(es)227 2784 y(the)h(b)r(eha)n(viour)f(of)g(v)n(ersions)f(of)i(AST)g
(prior)e(to)h(v)n(ersion)f(2.0.)227 2907 y(If)31 b(the)g(Activ)n(eUnit)
@@ -124757,8 +124862,9 @@ b(rame)29 b(b)r(eing)h(re-mapp)r(ed)e(\(that)i(is,)g(the)g(Mappings)f
i(F)-7 b(rames)24 b(within)i(the)f(F)-7 b(rameSet)25
b(will)h(b)r(e)f(mo)r(di\014ed)h(to)f(tak)n(e)g(in)n(to)f(accoun)n(t)
227 5693 y(the)k(c)n(hange)f(in)h(Units\).)p eop end
-%%Page: 357 367
-TeXDict begin 357 366 bop 3643 52 a FF(357)0 351 y Fd(Synopsis:)121
+%%Page: 358 368
+TeXDict begin 358 367 bop 0 52 a FF(358)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Synopsis:)121
b Ft(void)42 b(astSetActiveUnit)o(\()37 b(AstFrame)k
Fh(\003)p Ft(this,)g(int)h(value)g(\))0 498 y Fd(P)m(arameters:)259
632 y(this)427 731 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(F)-7
@@ -124817,14 +124923,13 @@ y Fh(\017)45 b Fi(I)28 b(-)f(In)n(teger)g(v)-5 b(alues.)340
5563 y Fh(\017)45 b Fi(L)28 b(-)f(Logical)f(\(i.e.)38
b(b)r(o)r(olean\))27 b(v)-5 b(alues.)340 5693 y Fh(\017)45
b Fi(S)28 b(-)f(String)h(v)-5 b(alues.)p eop end
-%%Page: 358 368
-TeXDict begin 358 367 bop 0 52 a FF(358)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
-b Fi(CN)32 b(-)g(A)g Ft(")p Fi(CONTINUE)p Ft(")e Fi(v)-5
-b(alue,)33 b(these)e(are)g(treated)g(lik)n(e)g(string)g(v)-5
-b(alues,)33 b(but)f(are)f(enco)r(ded)g(without)427 451
-y(an)d(equals)e(sign.)227 600 y(The)i(data)f(t)n(yp)r(e)h(of)f(the)h
-Ft(")p Fi(v)-5 b(alue)p Ft(")27 b Fi(parameter)f(dep)r(ends)i(on)f
+%%Page: 359 369
+TeXDict begin 359 368 bop 3643 52 a FF(359)340 351 y
+Fh(\017)45 b Fi(CN)32 b(-)g(A)g Ft(")p Fi(CONTINUE)p
+Ft(")e Fi(v)-5 b(alue,)33 b(these)e(are)g(treated)g(lik)n(e)g(string)g
+(v)-5 b(alues,)33 b(but)f(are)f(enco)r(ded)g(without)427
+451 y(an)d(equals)e(sign.)227 600 y(The)i(data)f(t)n(yp)r(e)h(of)f(the)
+h Ft(")p Fi(v)-5 b(alue)p Ft(")27 b Fi(parameter)f(dep)r(ends)i(on)f
Fk(<)p Fi(X)p Fk(>)h Fi(as)e(follo)n(ws:)340 842 y Fh(\017)45
b Fi(CF)28 b(-)g Ft(")p Fi(double)g Fh(\003)p Ft(")f
Fi(\(a)g(p)r(oin)n(ter)h(to)g(a)f(2)h(elemen)n(t)g(arra)n(y)d(holding)j
@@ -124899,10 +125004,11 @@ Ft(")p Fi(end-of-\014le)p Ft(")p Fi(.)340 5640 y Fh(\017)45
b Fi(An)28 b(error)e(will)i(b)r(e)g(rep)r(orted)f(if)h(the)g(k)n(eyw)n
(ord)d(name)j(do)r(es)f(not)h(conform)e(to)i(FITS)g(requiremen)n(ts.)p
eop end
-%%Page: 359 369
-TeXDict begin 359 368 bop 3643 52 a FF(359)p 0 351 3780
-12 v 0 483 a Fz(astSetFitsCM)153 b Fe(Store)34 b(a)h(commen)m(t)e(card)
-i(in)g(a)g(FitsChan)150 b Fz(astSetFitsCM)0 628 y Fd(Description:)44
+%%Page: 360 370
+TeXDict begin 360 369 bop 0 52 a FF(360)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 483 a Fz(astSetFitsCM)153 b Fe(Store)34 b(a)h(commen)m(t)e(card)i(in)
+g(a)g(FitsChan)150 b Fz(astSetFitsCM)0 628 y Fd(Description:)44
b Fi(This)29 b(function)h(stores)e(a)g(commen)n(t)h(card)f(\()i(i.e.)41
b(a)28 b(card)g(with)i(no)f(k)n(eyw)n(ord)e(name)h(or)h(equals)f
(sign\))227 727 y(within)34 b(a)f(FitsChan)g(at)g(the)h(curren)n(t)e
@@ -124976,9 +125082,8 @@ b(card)f(is)h(left)h(unc)n(hanged.)65 b(In)37 b(either)g(case,)i(if)f
5693 y Ft(")p Fi(end-of-\014le)p Ft(")p Fi(,)27 b(the)h(new)f(card)g
(is)g(app)r(ended)h(to)g(the)g(end)g(of)f(the)h(list.)p
eop end
-%%Page: 360 370
-TeXDict begin 360 369 bop 0 52 a FF(360)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Notes:)340
+%%Page: 361 371
+TeXDict begin 361 370 bop 3643 52 a FF(361)0 351 y Fd(Notes:)340
634 y Fh(\017)45 b Fi(If,)34 b(on)d(exit,)j(there)d(are)g(no)h(cards)f
(follo)n(wing)g(the)h(card)f(written)h(b)n(y)g(this)g(function,)i(then)
e(the)g(curren)n(t)427 733 y(card)27 b(is)g(left)i(p)r(oin)n(ting)e(at)
@@ -125038,9 +125143,10 @@ b(most)g(AST)h(functions)g(will)g(not)f(execute)g(and)g(will)427
b(o)34 b(clear)e(the)i(error)d(status)i(and)h(restore)e(normal)g(b)r
(eha)n(viour,)i(use)427 5643 y(astClearStatus.)p eop
end
-%%Page: 361 371
-TeXDict begin 361 370 bop 3643 52 a FF(361)p 0 351 3780
-12 v 0 482 a Fz(astSetUnc)816 483 y Fe(Store)38 b(uncertain)m(t)m(y)e
+%%Page: 362 372
+TeXDict begin 362 371 bop 0 52 a FF(362)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 482 a Fz(astSetUnc)816 483 y Fe(Store)38 b(uncertain)m(t)m(y)e
(information)f(in)j(a)h(Region)3183 482 y Fz(astSetUnc)0
672 y Fd(Description:)44 b Fi(Eac)n(h)33 b(Region)h(\(of)g(an)n(y)g
(class\))f(can)h(ha)n(v)n(e)f(an)h Ft(")p Fi(uncertain)n(t)n(y)p
@@ -125117,9 +125223,8 @@ Fi(prin)n(tf)p Ft(")427 5300 y Fi(function\).)0 5459
y Fd(Returned)32 b(V)-8 b(alue:)259 5593 y(astShiftMap\(\))427
5693 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(ShiftMap.)p
eop end
-%%Page: 362 372
-TeXDict begin 362 371 bop 0 52 a FF(362)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Notes:)340
+%%Page: 363 373
+TeXDict begin 363 372 bop 3643 52 a FF(363)0 351 y Fd(Notes:)340
656 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g
(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427
@@ -125172,1020 +125277,1025 @@ b(they)g(are)f(displa)n(y)n(ed)g(as)g(simple)427 5372
y(\015oating)e(p)r(oin)n(t)h(v)-5 b(alues.)259 5516 y
Fd(ttl)427 5616 y Fi(A)28 b(title)g(to)g(displa)n(y)f(b)r(efore)g
(displa)n(ying)g(the)h(\014rst)f(p)r(osition.)p eop end
-%%Page: 363 373
-TeXDict begin 363 372 bop 3643 52 a FF(363)p 0 351 3780
-12 v 0 483 a Fz(astSimplify)729 b Fe(Simplify)37 b(a)h(Mapping)727
-b Fz(astSimplify)0 678 y Fd(Description:)44 b Fi(This)h(function)g
+%%Page: 364 374
+TeXDict begin 364 373 bop 0 52 a FF(364)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 483 a Fz(astSimplify)729 b Fe(Simplify)37 b(a)h(Mapping)727
+b Fz(astSimplify)0 669 y Fd(Description:)44 b Fi(This)h(function)g
(simpli\014es)g(a)f(Mapping)g(\(whic)n(h)h(ma)n(y)e(b)r(e)i(a)f(comp)r
-(ound)h(Mapping)f(suc)n(h)g(as)g(a)227 778 y(CmpMap\))32
+(ound)h(Mapping)f(suc)n(h)g(as)g(a)227 769 y(CmpMap\))32
b(to)g(eliminate)f(redundan)n(t)h(computational)e(steps,)j(or)e(to)g
(merge)g(separate)f(steps)h(whic)n(h)h(can)f(b)r(e)227
-878 y(p)r(erformed)c(more)g(e\016cien)n(tly)h(in)g(a)f(single)g(op)r
-(eration.)227 1003 y(As)e(a)g(simple)g(example,)h(a)e(Mapping)h(whic)n
+868 y(p)r(erformed)c(more)g(e\016cien)n(tly)h(in)g(a)f(single)g(op)r
+(eration.)227 991 y(As)e(a)g(simple)g(example,)h(a)e(Mapping)h(whic)n
(h)g(m)n(ultiplied)h(co)r(ordinates)e(b)n(y)h(5,)g(and)g(then)h(m)n
-(ultiplied)f(the)h(result)227 1103 y(b)n(y)35 b(10,)g(could)g(b)r(e)g
+(ultiplied)f(the)h(result)227 1091 y(b)n(y)35 b(10,)g(could)g(b)r(e)g
(simpli\014ed)g(to)f(a)h(single)f(step)h(whic)n(h)f(m)n(ultiplied)i(b)n
(y)e(50.)57 b(Similarly)-7 b(,)36 b(a)e(Mapping)h(whic)n(h)227
-1202 y(m)n(ultiplied)29 b(b)n(y)e(5,)g(and)h(then)g(divided)g(b)n(y)f
+1190 y(m)n(ultiplied)29 b(b)n(y)e(5,)g(and)h(then)g(divided)g(b)n(y)f
(5,)g(could)h(b)r(e)g(reduced)f(to)g(a)g(simple)h(cop)n(ying)f(op)r
-(eration.)227 1328 y(This)21 b(function)h(should)f(t)n(ypically)g(b)r
+(eration.)227 1313 y(This)21 b(function)h(should)f(t)n(ypically)g(b)r
(e)g(applied)h(to)f(Mappings)f(whic)n(h)h(ha)n(v)n(e)f(undergone)h
-(substan)n(tial)f(pro)r(cessing)227 1428 y(or)i(ha)n(v)n(e)f(b)r(een)i
+(substan)n(tial)f(pro)r(cessing)227 1412 y(or)i(ha)n(v)n(e)f(b)r(een)i
(formed)f(b)n(y)g(merging)f(other)h(Mappings.)35 b(It)22
b(is)h(of)f(p)r(oten)n(tial)g(b)r(ene\014t,)j(for)d(example,)h(in)f
-(reducing)227 1527 y(execution)28 b(time)g(if)g(applied)f(b)r(efore)h
+(reducing)227 1512 y(execution)28 b(time)g(if)g(applied)f(b)r(efore)h
(using)f(a)g(Mapping)g(to)h(transform)e(a)h(large)g(n)n(um)n(b)r(er)g
-(of)g(co)r(ordinates.)0 1679 y Fd(Synopsis:)121 b Ft(AstMapping)39
+(of)g(co)r(ordinates.)0 1658 y Fd(Synopsis:)121 b Ft(AstMapping)39
b Fh(\003)p Ft(astSimplify\()f(AstMapping)i Fh(\003)p
-Ft(this)h(\))0 1830 y Fd(P)m(arameters:)259 1969 y(this)427
-2068 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(original)e(Mapping.)0
-2232 y Fd(Class)31 b(Applicabilit)m(y:)259 2371 y(Mapping)427
-2470 y Fi(This)d(function)g(applies)f(to)h(all)f(Mappings.)259
-2604 y Fd(F)-8 b(rameSet)427 2704 y Fi(If)29 b(the)f(supplied)g
+Ft(this)h(\))0 1804 y Fd(P)m(arameters:)259 1936 y(this)427
+2036 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(original)e(Mapping.)0
+2194 y Fd(Class)31 b(Applicabilit)m(y:)259 2327 y(Mapping)427
+2426 y Fi(This)d(function)g(applies)f(to)h(all)f(Mappings.)259
+2555 y Fd(F)-8 b(rameSet)427 2655 y Fi(If)29 b(the)f(supplied)g
(Mapping)g(is)f(a)h(F)-7 b(rameSet,)28 b(the)g(returned)g(Mapping)f
(will)h(b)r(e)h(a)e(cop)n(y)g(of)h(the)g(supplied)427
-2804 y(F)-7 b(rameSet)28 b(in)g(whic)n(h)f(all)g(the)h(in)n(ter-F)-7
+2755 y(F)-7 b(rameSet)28 b(in)g(whic)n(h)f(all)g(the)h(in)n(ter-F)-7
b(rame)27 b(Mappings)g(ha)n(v)n(e)f(b)r(een)i(simpli\014ed.)0
-2967 y Fd(Returned)k(V)-8 b(alue:)259 3106 y(astSimplify\(\))427
-3206 y Fi(A)28 b(new)g(p)r(oin)n(ter)f(to)h(the)g(\(p)r(ossibly)f
-(simpli\014ed\))h(Mapping.)0 3369 y Fd(Notes:)340 3654
+2913 y Fd(Returned)k(V)-8 b(alue:)259 3046 y(astSimplify\(\))427
+3145 y Fi(A)28 b(new)g(p)r(oin)n(ter)f(to)h(the)g(\(p)r(ossibly)f
+(simpli\014ed\))h(Mapping.)0 3303 y Fd(Notes:)340 3582
+y Fh(\017)45 b Fi(Mappings)20 b(that)g(ha)n(v)n(e)f(a)g(set)h(v)-5
+b(alue)20 b(for)f(their)h(Iden)n(t)g(attribute)g(are)f(left)i(unc)n
+(hanged)e(after)h(simpli\014cation.)427 3682 y(This)31
+b(is)f(so)g(that)h(their)f(individual)h(iden)n(tit)n(y)g(is)f(preserv)n
+(ed.)44 b(This)30 b(restriction)g(do)r(es)g(not)h(apply)f(to)g(the)427
+3781 y(simpli\014cation)e(of)f(F)-7 b(rames.)340 3911
y Fh(\017)45 b Fi(This)39 b(function)g(can)g(safely)f(b)r(e)h(applied)g
(ev)n(en)f(to)h(Mappings)f(whic)n(h)h(cannot)f(b)r(e)i(simpli\014ed.)71
-b(If)39 b(no)427 3754 y(simpli\014cation)22 b(is)h(p)r(ossible,)g(it)g
+b(If)39 b(no)427 4010 y(simpli\014cation)22 b(is)h(p)r(ossible,)g(it)g
(b)r(eha)n(v)n(es)e(exactly)h(lik)n(e)g(astClone)f(and)i(returns)e(a)h
-(p)r(oin)n(ter)g(to)g(the)h(original)427 3853 y(Mapping.)340
-3987 y Fh(\017)45 b Fi(The)40 b(Mapping)g(returned)g(b)n(y)g(this)g
+(p)r(oin)n(ter)g(to)g(the)h(original)427 4110 y(Mapping.)340
+4239 y Fh(\017)45 b Fi(The)40 b(Mapping)g(returned)g(b)n(y)g(this)g
(function)h(ma)n(y)e(not)h(b)r(e)h(indep)r(enden)n(t)g(of)f(the)h
-(original)d(\(ev)n(en)i(if)427 4087 y(simpli\014cation)34
+(original)d(\(ev)n(en)i(if)427 4339 y(simpli\014cation)34
b(w)n(as)e(p)r(ossible\),)j(and)f(mo)r(difying)f(it)i(ma)n(y)d
(therefore)h(result)g(in)h(indirect)g(mo)r(di\014cation)427
-4186 y(of)29 b(the)h(original.)40 b(If)30 b(a)f(completely)g(indep)r
+4438 y(of)29 b(the)h(original.)40 b(If)30 b(a)f(completely)g(indep)r
(enden)n(t)h(result)f(is)g(required,)g(a)g(cop)n(y)f(should)h(b)r(e)h
-(made)f(using)427 4286 y(astCop)n(y)-7 b(.)340 4420 y
+(made)f(using)427 4538 y(astCop)n(y)-7 b(.)340 4667 y
Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g
(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g
-(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 4520
+(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 4767
y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f
-(an)n(y)g(reason.)p 0 4721 V 0 4853 a Fz(astSkyF)-11
+(an)n(y)g(reason.)p 0 4958 V 0 5090 a Fz(astSkyF)-11
b(rame)644 b Fe(Create)37 b(a)i(SkyF)-10 b(rame)642 b
-Fz(astSkyF)-11 b(rame)0 5043 y Fd(Description:)44 b Fi(This)28
+Fz(astSkyF)-11 b(rame)0 5271 y Fd(Description:)44 b Fi(This)28
b(function)g(creates)f(a)g(new)g(SkyF)-7 b(rame)27 b(and)h(optionally)e
-(initialises)i(its)f(attributes.)227 5169 y(A)h(SkyF)-7
+(initialises)i(its)f(attributes.)227 5394 y(A)h(SkyF)-7
b(rame)26 b(is)h(a)f(sp)r(ecialised)h(form)f(of)h(F)-7
b(rame)27 b(whic)n(h)f(describ)r(es)h(celestial)f(longitude/latitude)h
-(co)r(ordinate)227 5269 y(systems.)53 b(The)33 b(particular)f
+(co)r(ordinate)227 5494 y(systems.)53 b(The)33 b(particular)f
(celestial)h(co)r(ordinate)f(system)h(to)g(b)r(e)g(represen)n(ted)f(is)
-h(sp)r(eci\014ed)g(b)n(y)g(setting)g(the)227 5368 y(SkyF)-7
+h(sp)r(eci\014ed)g(b)n(y)g(setting)g(the)227 5593 y(SkyF)-7
b(rame's)33 b(System)g(attribute)h(\(curren)n(tly)-7
b(,)34 b(the)g(default)g(is)f(ICRS\))h(quali\014ed,)h(as)d(necessary)-7
-b(,)34 b(b)n(y)f(a)g(mean)227 5468 y(Equino)n(x)27 b(v)-5
-b(alue)27 b(and/or)f(an)h(Ep)r(o)r(c)n(h.)227 5593 y(F)-7
-b(or)28 b(eac)n(h)f(of)g(the)i(supp)r(orted)e(celestial)h(co)r
+b(,)34 b(b)n(y)f(a)g(mean)227 5693 y(Equino)n(x)27 b(v)-5
+b(alue)27 b(and/or)f(an)h(Ep)r(o)r(c)n(h.)p eop end
+%%Page: 365 375
+TeXDict begin 365 374 bop 3643 52 a FF(365)227 351 y
+Fi(F)-7 b(or)28 b(eac)n(h)f(of)g(the)i(supp)r(orted)e(celestial)h(co)r
(ordinate)e(systems,)i(a)f(SkyF)-7 b(rame)27 b(can)h(apply)f(an)h
-(optional)f(shift)i(of)227 5693 y(origin)21 b(to)h(create)f(a)h(co)r
+(optional)f(shift)i(of)227 451 y(origin)21 b(to)h(create)f(a)h(co)r
(ordinate)f(system)h(represen)n(ting)e(o\013sets)i(within)h(the)g
-(celestial)e(co)r(ordinate)g(system)h(from)p eop end
-%%Page: 364 374
-TeXDict begin 364 373 bop 0 52 a FF(364)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)227 351 y Fi(some)j(sp)r(eci\014ed)h
-(p)r(oin)n(t.)55 b(This)34 b(o\013set)f(co)r(ordinate)g(system)g(can)g
-(also)g(b)r(e)h(rotated)f(to)g(de\014ne)h(new)g(longitude)227
-451 y(and)28 b(latitude)g(axes.)36 b(See)27 b(attributes)h(SkyRef,)g
-(SkyRefIs)f(and)h(SkyRefP)227 571 y(All)34 b(the)f(co)r(ordinate)f(v)-5
-b(alues)33 b(used)g(b)n(y)g(a)g(SkyF)-7 b(rame)32 b(are)h(in)g
-(radians.)52 b(These)33 b(ma)n(y)g(b)r(e)g(formatted)g(in)g(more)227
-670 y(con)n(v)n(en)n(tional)26 b(w)n(a)n(ys)g(for)h(displa)n(y)g(b)n(y)
-g(using)g(astF)-7 b(ormat.)0 811 y Fd(Synopsis:)121 b
-Ft(AstSkyFrame)39 b Fh(\003)p Ft(astSkyFrame\()f(const)k(char)f
-Fh(\003)p Ft(options,)f(...)86 b(\))0 951 y Fd(P)m(arameters:)259
-1078 y(options)427 1177 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n
+(celestial)e(co)r(ordinate)g(system)h(from)227 551 y(some)33
+b(sp)r(eci\014ed)h(p)r(oin)n(t.)55 b(This)34 b(o\013set)f(co)r
+(ordinate)g(system)g(can)g(also)g(b)r(e)h(rotated)f(to)g(de\014ne)h
+(new)g(longitude)227 650 y(and)28 b(latitude)g(axes.)36
+b(See)27 b(attributes)h(SkyRef,)g(SkyRefIs)f(and)h(SkyRefP)227
+782 y(All)34 b(the)f(co)r(ordinate)f(v)-5 b(alues)33
+b(used)g(b)n(y)g(a)g(SkyF)-7 b(rame)32 b(are)h(in)g(radians.)52
+b(These)33 b(ma)n(y)g(b)r(e)g(formatted)g(in)g(more)227
+882 y(con)n(v)n(en)n(tional)26 b(w)n(a)n(ys)g(for)h(displa)n(y)g(b)n(y)
+g(using)g(astF)-7 b(ormat.)0 1047 y Fd(Synopsis:)121
+b Ft(AstSkyFrame)39 b Fh(\003)p Ft(astSkyFrame\()f(const)k(char)f
+Fh(\003)p Ft(options,)f(...)86 b(\))0 1212 y Fd(P)m(arameters:)259
+1364 y(options)427 1464 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n
(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 1277 y(assignmen)n(ts)21
+(comma-separated)e(list)i(of)g(attribute)427 1564 y(assignmen)n(ts)21
b(to)h(b)r(e)h(used)f(for)g(initialising)g(the)g(new)g(SkyF)-7
b(rame.)35 b(The)22 b(syn)n(tax)f(used)h(is)g(iden)n(tical)g(to)g(that)
-427 1377 y(for)k(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
+427 1663 y(for)k(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n
(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-1476 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)35 b(If)28
+1763 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)35 b(If)28
b(no)g(initialisation)f(is)g(required,)g(a)g(zero-length)f(string)h(ma)
-n(y)g(b)r(e)h(supplied.)259 1600 y Fd(...)427 1699 y
+n(y)g(b)r(e)h(supplied.)259 1903 y Fd(...)427 2003 y
Fi(If)38 b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n(tains)f
Ft(")p Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f
-(optional)g(list)h(of)f(additional)427 1799 y(argumen)n(ts)26
+(optional)g(list)h(of)f(additional)427 2103 y(argumen)n(ts)26
b(ma)n(y)h(follo)n(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5
b(alues)27 b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)
-37 b(The)427 1899 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+37 b(The)427 2202 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 1998 y Fi(function\).)0
-2151 y Fd(Returned)32 b(V)-8 b(alue:)259 2278 y(astSkyF)g(rame\(\))427
-2378 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(SkyF)-7
-b(rame.)0 2530 y Fd(Examples:)227 2658 y Fp(frame)47
-b(=)g(astSkyFrame\()e Ft("")h Fp(\);)427 2757 y Fi(Creates)27
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 2302 y Fi(function\).)0
+2479 y Fd(Returned)32 b(V)-8 b(alue:)259 2632 y(astSkyF)g(rame\(\))427
+2731 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(SkyF)-7
+b(rame.)0 2909 y Fd(Examples:)227 3062 y Fp(frame)47
+b(=)g(astSkyFrame\()e Ft("")h Fp(\);)427 3160 y Fi(Creates)27
b(a)g(SkyF)-7 b(rame)27 b(to)g(describ)r(e)g(the)h(default)h(ICRS)e
-(celestial)g(co)r(ordinate)g(system.)227 2881 y Fp(frame)47
+(celestial)g(co)r(ordinate)g(system.)227 3302 y Fp(frame)47
b(=)g(astSkyFrame\()e Ft(")p Fp(System)g(=)j(FK5,)e(Equinox)g(=)i
-(J2005,)e(Digits)g(=)h(10)p Ft(")g Fp(\);)427 2980 y
+(J2005,)e(Digits)g(=)h(10)p Ft(")g Fp(\);)427 3401 y
Fi(Creates)23 b(a)g(SkyF)-7 b(rame)23 b(to)h(describ)r(e)f(the)h(FK5)f
(celestial)g(co)r(ordinate)g(system,)h(with)g(a)g(mean)f(Equino)n(x)g
-(of)427 3080 y(J2005.0.)33 b(Because)23 b(esp)r(ecially)g(accurate)f
+(of)427 3500 y(J2005.0.)33 b(Because)23 b(esp)r(ecially)g(accurate)f
(co)r(ordinates)g(will)i(b)r(e)g(used,)g(additional)f(precision)g(\(10)
-f(digits\))427 3179 y(has)27 b(b)r(een)h(requested.)37
+f(digits\))427 3600 y(has)27 b(b)r(een)h(requested.)37
b(This)27 b(will)h(b)r(e)g(used)g(when)f(co)r(ordinate)g(v)-5
b(alues)27 b(are)g(formatted)g(for)g(displa)n(y)-7 b(.)227
-3304 y Fp(frame)47 b(=)g(astSkyFrame\()e Ft(")p Fp(System)g(=)j(FK4,)e
-(Equinox)g(=)i(1955-sep-2)p Ft(")c Fp(\);)427 3402 y
+3742 y Fp(frame)47 b(=)g(astSkyFrame\()e Ft(")p Fp(System)g(=)j(FK4,)e
+(Equinox)g(=)i(1955-sep-2)p Ft(")c Fp(\);)427 3840 y
Fi(Creates)32 b(a)g(SkyF)-7 b(rame)31 b(to)i(describ)r(e)f(the)h(old)f
(FK4)g(celestial)g(co)r(ordinate)f(system.)51 b(A)33
-b(default)g(Ep)r(o)r(c)n(h)427 3502 y(v)-5 b(alue)28
+b(default)g(Ep)r(o)r(c)n(h)427 3940 y(v)-5 b(alue)28
b(\(B1950.0\))d(is)j(used,)g(but)g(the)g(mean)f(Equino)n(x)f(v)-5
b(alue)28 b(is)f(giv)n(en)g(explicitly)h(as)f Ft(")p
-Fi(1955-sep-2)p Ft(")p Fi(.)227 3626 y Fp(frame)47 b(=)g(astSkyFrame\()
+Fi(1955-sep-2)p Ft(")p Fi(.)227 4081 y Fp(frame)47 b(=)g(astSkyFrame\()
e Ft(")p Fp(System)g(=)j(GAPPT,)e(Epoch)g(=)i(\045s)p
-Ft(")p Fp(,)e(date)h(\);)427 3725 y Fi(Creates)32 b(a)h(SkyF)-7
+Ft(")p Fp(,)e(date)h(\);)427 4180 y Fi(Creates)32 b(a)h(SkyF)-7
b(rame)32 b(to)h(describ)r(e)f(the)i(Geo)r(cen)n(tric)e(Apparen)n(t)h
-(celestial)f(co)r(ordinate)g(system.)53 b(The)427 3825
+(celestial)f(co)r(ordinate)g(system.)53 b(The)427 4280
y(Ep)r(o)r(c)n(h)37 b(v)-5 b(alue,)39 b(whic)n(h)e(sp)r(eci\014es)g
(the)g(date)g(of)g(observ)-5 b(ation,)38 b(is)f(obtained)f(from)h(a)f
-(date/time)h(string)427 3924 y(supplied)28 b(via)f(the)h(string)f(p)r
-(oin)n(ter)g Ft(")p Fi(date)p Ft(")p Fi(.)0 4077 y Fd(Notes:)340
-4350 y Fh(\017)45 b Fi(Curren)n(tly)-7 b(,)26 b(the)g(default)h
+(date/time)h(string)427 4379 y(supplied)28 b(via)f(the)h(string)f(p)r
+(oin)n(ter)g Ft(")p Fi(date)p Ft(")p Fi(.)0 4557 y Fd(Notes:)340
+4855 y Fh(\017)45 b Fi(Curren)n(tly)-7 b(,)26 b(the)g(default)h
(celestial)e(co)r(ordinate)g(system)g(is)h(ICRS.)h(Ho)n(w)n(ev)n(er,)d
-(this)i(default)h(ma)n(y)e(c)n(hange)427 4450 y(in)34
+(this)i(default)h(ma)n(y)e(c)n(hange)427 4955 y(in)34
b(future)g(as)f(new)h(astrometric)e(standards)g(ev)n(olv)n(e.)54
b(The)33 b(in)n(ten)n(tion)h(is)g(to)f(trac)n(k)f(the)i(most)g(mo)r
-(dern)427 4549 y(appropriate)e(standard.)55 b(F)-7 b(or)33
+(dern)427 5054 y(appropriate)e(standard.)55 b(F)-7 b(or)33
b(this)h(reason,)g(y)n(ou)f(should)g(use)h(the)g(default)g(only)g(if)g
-(this)g(is)g(what)f(y)n(ou)427 4649 y(in)n(tend)j(\(and)f(can)f
+(this)g(is)g(what)f(y)n(ou)427 5154 y(in)n(tend)j(\(and)f(can)f
(tolerate)g(an)n(y)g(asso)r(ciated)g(sligh)n(t)g(c)n(hange)g(in)h(b)r
-(eha)n(viour)f(with)h(future)h(v)n(ersions)d(of)427 4749
+(eha)n(viour)f(with)h(future)h(v)n(ersions)d(of)427 5253
y(this)d(function\).)43 b(If)30 b(y)n(ou)e(in)n(tend)i(to)f(use)g(the)h
(ICRS)f(system)h(inde\014nitely)-7 b(,)30 b(then)g(y)n(ou)e(should)i
-(sp)r(ecify)f(it)427 4848 y(explicitly)f(using)f(an)h
+(sp)r(ecify)f(it)427 5353 y(explicitly)f(using)f(an)h
Ft(")p Fi(options)p Ft(")e Fi(v)-5 b(alue)27 b(of)h Ft(")p
-Fi(System=ICRS)p Ft(")p Fi(.)340 4972 y Fh(\017)45 b
+Fi(System=ICRS)p Ft(")p Fi(.)340 5494 y Fh(\017)45 b
Fi(Whic)n(hev)n(er)25 b(celestial)g(co)r(ordinate)f(system)h(is)g
(represen)n(ted,)g(it)h(will)g(ha)n(v)n(e)e(t)n(w)n(o)g(axes.)36
-b(The)25 b(\014rst)g(of)h(these)427 5071 y(will)f(b)r(e)f(the)h
+b(The)25 b(\014rst)g(of)h(these)427 5593 y(will)f(b)r(e)f(the)h
(longitude)f(axis)g(and)g(the)h(second)e(will)i(b)r(e)f(the)h(latitude)
g(axis.)35 b(This)24 b(order)f(can)h(b)r(e)h(c)n(hanged)427
-5171 y(using)j(astP)n(ermAxes)d(if)j(required.)340 5295
-y Fh(\017)45 b Fi(When)40 b(con)n(v)n(ersion)d(b)r(et)n(w)n(een)i(t)n
-(w)n(o)g(SkyF)-7 b(rames)38 b(is)h(requested)g(\(as)g(when)g(supplying)
-g(SkyF)-7 b(rames)39 b(to)427 5394 y(astCon)n(v)n(ert\),)h(accoun)n(t)d
-(will)i(b)r(e)g(tak)n(en)f(of)g(the)h(nature)f(of)g(the)h(celestial)f
-(co)r(ordinate)f(systems)h(they)427 5494 y(represen)n(t,)22
+5693 y(using)j(astP)n(ermAxes)d(if)j(required.)p eop
+end
+%%Page: 366 376
+TeXDict begin 366 375 bop 0 52 a FF(366)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Fi(When)40 b(con)n(v)n(ersion)d(b)r(et)n(w)n(een)i(t)n(w)n(o)g(SkyF)
+-7 b(rames)38 b(is)h(requested)g(\(as)g(when)g(supplying)g(SkyF)-7
+b(rames)39 b(to)427 451 y(astCon)n(v)n(ert\),)h(accoun)n(t)d(will)i(b)r
+(e)g(tak)n(en)f(of)g(the)h(nature)f(of)g(the)h(celestial)f(co)r
+(ordinate)f(systems)h(they)427 551 y(represen)n(t,)22
b(together)g(with)h(an)n(y)e(qualifying)h(mean)g(Equino)n(x)f(or)g(Ep)r
(o)r(c)n(h)h(v)-5 b(alues,)23 b(etc.)35 b(The)22 b(AlignSystem)427
-5593 y(attribute)d(will)h(also)e(b)r(e)h(tak)n(en)f(in)n(to)h(accoun)n
+650 y(attribute)d(will)h(also)e(b)r(e)h(tak)n(en)f(in)n(to)h(accoun)n
(t.)33 b(The)19 b(results)g(will)g(therefore)f(fully)h(re\015ect)g(the)
-g(relationship)427 5693 y(b)r(et)n(w)n(een)28 b(p)r(ositions)f(on)g
-(the)h(sky)f(measured)g(in)h(the)g(t)n(w)n(o)f(systems.)p
-eop end
-%%Page: 365 375
-TeXDict begin 365 374 bop 3643 52 a FF(365)340 351 y
-Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g
-(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g
-(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 451
-y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f
-(an)n(y)g(reason.)p 0 649 3780 12 v 0 781 a Fz(astSkyO\013setMap)225
-b Fe(Returns)39 b(a)f(Mapping)g(whic)m(h)1411 896 y(go)s(es)h(from)e
-(absolute)1372 1010 y(co)s(ordinates)g(to)h(o\013set)1598
-1110 y(co)s(ordinates)2778 781 y Fz(astSkyO\013setMap)0
-1275 y Fd(Description:)44 b Fi(This)33 b(function)g(returns)f(a)g
+g(relationship)427 750 y(b)r(et)n(w)n(een)28 b(p)r(ositions)f(on)g(the)
+h(sky)f(measured)g(in)h(the)g(t)n(w)n(o)f(systems.)340
+882 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
+b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g
+(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427
+982 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
+(for)f(an)n(y)g(reason.)p 0 1181 3780 12 v 0 1312 a Fz
+(astSkyO\013setMap)225 b Fe(Returns)39 b(a)f(Mapping)g(whic)m(h)1411
+1427 y(go)s(es)h(from)e(absolute)1372 1542 y(co)s(ordinates)g(to)h
+(o\013set)1598 1641 y(co)s(ordinates)2778 1312 y Fz(astSkyO\013setMap)0
+1806 y Fd(Description:)44 b Fi(This)33 b(function)g(returns)f(a)g
(Mapping)g(in)h(whic)n(h)f(the)h(forw)n(ard)e(transformation)g
-(transforms)g(a)h(p)r(o-)227 1374 y(sition)d(in)h(the)g(co)r(ordinate)e
+(transforms)g(a)h(p)r(o-)227 1906 y(sition)d(in)h(the)g(co)r(ordinate)e
(system)h(giv)n(en)g(b)n(y)g(the)g(System)h(attribute)f(of)h(the)f
-(supplied)h(SkyF)-7 b(rame,)29 b(in)n(to)g(the)227 1474
+(supplied)h(SkyF)-7 b(rame,)29 b(in)n(to)g(the)227 2006
y(o\013set)d(co)r(ordinate)f(system)g(sp)r(eci\014ed)h(b)n(y)g(the)g
(SkyRef,)g(SkyRefP)f(and)h(SkyRefIs)g(attributes)f(of)h(the)g(supplied)
-227 1574 y(SkyF)-7 b(rame.)227 1698 y(A)28 b(UnitMap)g(is)g(returned)f
+227 2105 y(SkyF)-7 b(rame.)227 2230 y(A)28 b(UnitMap)g(is)g(returned)f
(if)h(the)g(SkyF)-7 b(rame)27 b(do)r(es)g(not)h(de\014ne)g(an)f
-(o\013set)g(co)r(ordinate)g(system.)0 1847 y Fd(Synopsis:)121
+(o\013set)g(co)r(ordinate)g(system.)0 2379 y Fd(Synopsis:)121
b Ft(AstMapping)39 b Fh(\003)p Ft(astSkyOffsetMap\()e(AstSkyFrame)i
-Fh(\003)p Ft(this)i(\))0 1996 y Fd(P)m(arameters:)259
-2132 y(this)427 2232 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(SkyF)-7
-b(rame.)0 2393 y Fd(Returned)32 b(V)-8 b(alue:)259 2529
-y(astSkyO\013setMap\(\))427 2629 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(returned)f(Mapping.)0 2790 y Fd(Notes:)340
-3072 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
+Fh(\003)p Ft(this)i(\))0 2528 y Fd(P)m(arameters:)259
+2664 y(this)427 2764 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(SkyF)-7
+b(rame.)0 2926 y Fd(Returned)32 b(V)-8 b(alue:)259 3062
+y(astSkyO\013setMap\(\))427 3161 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(returned)f(Mapping.)0 3323 y Fd(Notes:)340
+3605 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g
(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427
-3172 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
-(for)f(an)n(y)g(reason.)p 0 3371 V 0 3502 a Fz(astSlaAdd)186
+3705 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
+(for)f(an)n(y)g(reason.)p 0 3904 V 0 4035 a Fz(astSlaAdd)186
b Fe(Add)39 b(a)g(celestial)d(co)s(ordinate)h(con)m(v)m(ersion)g(to)h
-(an)1696 3602 y(SlaMap)3180 3502 y Fz(astSlaAdd)0 3790
+(an)1696 4135 y(SlaMap)3180 4035 y Fz(astSlaAdd)0 4323
y Fd(Description:)44 b Fi(This)31 b(function)g(adds)f(one)h(of)f(the)h
(standard)f(celestial)g(co)r(ordinate)f(system)i(con)n(v)n(ersions)d
-(pro)n(vided)227 3890 y(b)n(y)23 b(the)f(SLALIB)h(P)n(ositional)e
+(pro)n(vided)227 4423 y(b)n(y)23 b(the)f(SLALIB)h(P)n(ositional)e
(Astronom)n(y)g(Library)g(\(Starlink)h(User)h(Note)f(SUN/67\))g(to)h
-(an)f(existing)g(SlaMap.)227 4014 y(When)27 b(an)f(SlaMap)g(is)g
+(an)f(existing)g(SlaMap.)227 4548 y(When)27 b(an)f(SlaMap)g(is)g
(\014rst)g(created)g(\(using)g(astSlaMap\),)g(it)h(simply)f(p)r
(erforms)g(a)g(unit)h(\(n)n(ull\))g(Mapping.)36 b(By)227
-4114 y(using)c(astSlaAdd)g(\(rep)r(eatedly)g(if)h(necessary\),)f(one)f
+4647 y(using)c(astSlaAdd)g(\(rep)r(eatedly)g(if)h(necessary\),)f(one)f
(or)h(more)f(co)r(ordinate)g(con)n(v)n(ersion)f(steps)i(ma)n(y)g(then)g
-(b)r(e)227 4213 y(added,)k(whic)n(h)f(the)f(SlaMap)g(will)h(p)r(erform)
+(b)r(e)227 4747 y(added,)k(whic)n(h)f(the)f(SlaMap)g(will)h(p)r(erform)
f(in)g(sequence.)57 b(This)34 b(allo)n(ws)f(m)n(ulti-step)i(con)n(v)n
-(ersions)d(b)r(et)n(w)n(een)227 4313 y(a)h(v)-5 b(ariet)n(y)33
+(ersions)d(b)r(et)n(w)n(een)227 4846 y(a)h(v)-5 b(ariet)n(y)33
b(of)g(celestial)h(co)r(ordinate)e(systems)h(to)g(b)r(e)h(assem)n(bled)
f(out)g(of)h(the)g(building)g(blo)r(c)n(ks)e(pro)n(vided)h(b)n(y)227
-4412 y(SLALIB.)227 4537 y(Normally)-7 b(,)29 b(if)h(an)f(SlaMap's)g(In)
+4946 y(SLALIB.)227 5070 y(Normally)-7 b(,)29 b(if)h(an)f(SlaMap's)g(In)
n(v)n(ert)g(attribute)g(is)h(zero)e(\(the)i(default\),)h(then)f(its)f
-(forw)n(ard)f(transformation)g(is)227 4636 y(p)r(erformed)e(b)n(y)h
+(forw)n(ard)f(transformation)g(is)227 5170 y(p)r(erformed)e(b)n(y)h
(carrying)e(out)h(eac)n(h)g(of)h(the)g(individual)g(co)r(ordinate)e
(con)n(v)n(ersions)f(sp)r(eci\014ed)j(b)n(y)g(astSlaAdd)f(in)227
-4736 y(the)i(order)e(giv)n(en)h(\(i.e.)38 b(with)28 b(the)g(most)f
+5270 y(the)i(order)e(giv)n(en)h(\(i.e.)38 b(with)28 b(the)g(most)f
(recen)n(tly)g(added)g(con)n(v)n(ersion)f(applied)h(last\).)227
-4860 y(This)f(order)f(is)h(rev)n(ersed)f(if)h(the)h(SlaMap's)e(In)n(v)n
+5394 y(This)f(order)f(is)h(rev)n(ersed)f(if)h(the)h(SlaMap's)e(In)n(v)n
(ert)h(attribute)g(is)g(non-zero)f(\(or)g(if)i(the)g(in)n(v)n(erse)d
-(transformation)227 4960 y(is)j(requested)f(b)n(y)h(an)n(y)f(other)g
+(transformation)227 5494 y(is)j(requested)f(b)n(y)h(an)n(y)f(other)g
(means\))h(and)g(eac)n(h)f(individual)h(co)r(ordinate)f(con)n(v)n
-(ersion)e(is)j(also)f(replaced)g(b)n(y)g(its)227 5060
+(ersion)e(is)j(also)f(replaced)g(b)n(y)g(its)227 5593
y(o)n(wn)f(in)n(v)n(erse.)35 b(This)25 b(pro)r(cess)f(in)n(v)n(erts)g
(the)i(o)n(v)n(erall)d(e\013ect)j(of)g(the)f(SlaMap.)36
b(In)25 b(this)h(case,)f(the)h(\014rst)f(con)n(v)n(ersion)227
-5159 y(to)j(b)r(e)g(applied)f(w)n(ould)g(b)r(e)h(the)g(in)n(v)n(erse)f
-(of)g(the)h(one)f(most)h(recen)n(tly)f(added.)0 5308
-y Fd(Synopsis:)121 b Ft(void)42 b(astSlaAdd\()d(AstSlaMap)h
-Fh(\003)p Ft(this,)h(const)h(char)g Fh(\003)p Ft(cvt,)f(const)h(double)
-f(args[])g(\))0 5457 y Fd(P)m(arameters:)259 5593 y(this)427
-5693 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(SlaMap.)p eop
-end
-%%Page: 366 376
-TeXDict begin 366 375 bop 0 52 a FF(366)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(cvt)427
-451 y Fi(P)n(oin)n(ter)e(to)h(a)h(n)n(ull-terminated)f(string)g(whic)n
-(h)g(iden)n(ti\014es)h(the)f(celestial)g(co)r(ordinate)g(con)n(v)n
-(ersion)e(to)i(b)r(e)427 551 y(added)f(to)f(the)h(SlaMap.)37
-b(See)27 b(the)h Ft(")p Fi(SLALIB)f(Con)n(v)n(ersions)p
-Ft(")e Fi(section)i(for)g(details)h(of)f(those)g(a)n(v)-5
-b(ailable.)259 681 y Fd(args)427 781 y Fi(An)29 b(arra)n(y)d(con)n
-(taining)h(argumen)n(t)g(v)-5 b(alues)28 b(for)f(the)i(celestial)e(co)r
-(ordinate)g(con)n(v)n(ersion.)37 b(The)28 b(n)n(um)n(b)r(er)g(of)427
-880 y(argumen)n(ts)22 b(required,)h(and)g(hence)g(the)g(n)n(um)n(b)r
-(er)g(of)g(arra)n(y)e(elemen)n(ts)h(used,)i(dep)r(ends)g(on)f(the)g
-(con)n(v)n(ersion)427 980 y(sp)r(eci\014ed)i(\(see)f(the)h
-Ft(")p Fi(SLALIB)f(Con)n(v)n(ersions)p Ft(")d Fi(section\).)36
+5693 y(to)j(b)r(e)g(applied)f(w)n(ould)g(b)r(e)h(the)g(in)n(v)n(erse)f
+(of)g(the)h(one)f(most)h(recen)n(tly)f(added.)p eop end
+%%Page: 367 377
+TeXDict begin 367 376 bop 3643 52 a FF(367)0 351 y Fd(Synopsis:)121
+b Ft(void)42 b(astSlaAdd\()d(AstSlaMap)h Fh(\003)p Ft(this,)h(const)h
+(char)g Fh(\003)p Ft(cvt,)f(const)h(double)f(args[])g(\))0
+499 y Fd(P)m(arameters:)259 633 y(this)427 733 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(SlaMap.)259 864 y Fd(cvt)427 963 y Fi(P)n(oin)n(ter)g(to)h
+(a)h(n)n(ull-terminated)f(string)g(whic)n(h)g(iden)n(ti\014es)h(the)f
+(celestial)g(co)r(ordinate)g(con)n(v)n(ersion)e(to)i(b)r(e)427
+1063 y(added)f(to)f(the)h(SlaMap.)37 b(See)27 b(the)h
+Ft(")p Fi(SLALIB)f(Con)n(v)n(ersions)p Ft(")e Fi(section)i(for)g
+(details)h(of)f(those)g(a)n(v)-5 b(ailable.)259 1194
+y Fd(args)427 1293 y Fi(An)29 b(arra)n(y)d(con)n(taining)h(argumen)n(t)
+g(v)-5 b(alues)28 b(for)f(the)i(celestial)e(co)r(ordinate)g(con)n(v)n
+(ersion.)37 b(The)28 b(n)n(um)n(b)r(er)g(of)427 1393
+y(argumen)n(ts)22 b(required,)h(and)g(hence)g(the)g(n)n(um)n(b)r(er)g
+(of)g(arra)n(y)e(elemen)n(ts)h(used,)i(dep)r(ends)g(on)f(the)g(con)n(v)
+n(ersion)427 1493 y(sp)r(eci\014ed)i(\(see)f(the)h Ft(")p
+Fi(SLALIB)f(Con)n(v)n(ersions)p Ft(")d Fi(section\).)36
b(This)24 b(arra)n(y)e(is)i(ignored)f(and)h(a)g(NULL)h(p)r(oin)n(ter)
-427 1079 y(ma)n(y)i(b)r(e)h(supplied)g(if)g(no)g(argumen)n(ts)e(are)g
-(needed.)0 1239 y Fd(Notes:)340 1519 y Fh(\017)45 b Fi(All)38
+427 1592 y(ma)n(y)i(b)r(e)h(supplied)g(if)g(no)g(argumen)n(ts)e(are)g
+(needed.)0 1752 y Fd(Notes:)340 2033 y Fh(\017)45 b Fi(All)38
b(co)r(ordinate)d(v)-5 b(alues)37 b(pro)r(cessed)e(b)n(y)i(an)f(SlaMap)
h(are)e(in)i(radians.)64 b(The)36 b(\014rst)h(co)r(ordinate)f(is)g(the)
-427 1619 y(celestial)27 b(longitude)h(and)f(the)h(second)f(co)r
-(ordinate)g(is)g(the)h(celestial)f(latitude.)340 1749
+427 2132 y(celestial)27 b(longitude)h(and)f(the)h(second)f(co)r
+(ordinate)g(is)g(the)h(celestial)f(latitude.)340 2263
y Fh(\017)45 b Fi(When)21 b(assem)n(bling)d(a)i(m)n(ulti-stage)f(con)n
(v)n(ersion,)g(it)h(can)g(sometimes)f(b)r(e)h(di\016cult)h(to)f
-(determine)g(the)g(most)427 1849 y(economical)j(con)n(v)n(ersion)e
+(determine)g(the)g(most)427 2363 y(economical)j(con)n(v)n(ersion)e
(path.)36 b(F)-7 b(or)23 b(example,)h(con)n(v)n(erting)e(to)i(the)g
-(standard)f(FK5)g(co)r(ordinate)g(system)427 1948 y(as)37
+(standard)f(FK5)g(co)r(ordinate)g(system)427 2463 y(as)37
b(an)h(in)n(termediate)f(stage)g(is)g(often)h(sensible)g(in)g(form)n
(ulating)f(the)h(problem,)i(but)e(ma)n(y)f(in)n(tro)r(duce)427
-2048 y(unnecessary)31 b(extra)g(con)n(v)n(ersion)f(steps.)51
+2562 y(unnecessary)31 b(extra)g(con)n(v)n(ersion)f(steps.)51
b(A)33 b(solution)e(to)h(this)h(is)f(to)g(include)h(all)f(the)g(steps)g
-(whic)n(h)h(are)427 2147 y(\(logically\))40 b(necessary)-7
+(whic)n(h)h(are)427 2662 y(\(logically\))40 b(necessary)-7
b(,)41 b(but)g(then)g(to)f(use)g(astSimplify)h(to)f(simplify)h(the)g
-(resulting)e(SlaMap.)75 b(The)427 2247 y(simpli\014cation)28
+(resulting)e(SlaMap.)75 b(The)427 2761 y(simpli\014cation)28
b(pro)r(cess)e(will)i(eliminate)g(an)n(y)f(steps)g(whic)n(h)h(turn)f
-(out)h(not)f(to)h(b)r(e)g(needed.)340 2377 y Fh(\017)45
+(out)h(not)f(to)h(b)r(e)g(needed.)340 2892 y Fh(\017)45
b Fi(This)27 b(function)h(do)r(es)f(not)g(c)n(hec)n(k)f(to)h(ensure)g
(that)g(the)h(sequence)e(of)h(co)r(ordinate)f(con)n(v)n(ersions)f
-(added)i(to)427 2477 y(an)h(SlaMap)f(is)g(ph)n(ysically)g(meaningful.)
--2 2636 y Fd(SLALIB)33 b(Con)m(v)m(ersions)n(:)227 2783
+(added)i(to)427 2992 y(an)h(SlaMap)f(is)g(ph)n(ysically)g(meaningful.)
+-2 3152 y Fd(SLALIB)33 b(Con)m(v)m(ersions)n(:)227 3298
y Fi(The)39 b(follo)n(wing)f(strings)g(\(whic)n(h)h(are)e
(case-insensitiv)n(e\))h(ma)n(y)g(b)r(e)h(supplied)g(via)f(the)h
-Ft(")p Fi(cvt)p Ft(")f Fi(parameter)g(to)227 2882 y(indicate)25
+Ft(")p Fi(cvt)p Ft(")f Fi(parameter)g(to)227 3398 y(indicate)25
b(whic)n(h)g(celestial)g(co)r(ordinate)f(con)n(v)n(ersion)f(is)i(to)g
(b)r(e)g(added)g(to)g(the)h(SlaMap.)35 b(Eac)n(h)24 b(string)g(is)h
-(deriv)n(ed)227 2982 y(from)c(the)g(name)g(of)g(the)g(SLALIB)g(routine)
+(deriv)n(ed)227 3497 y(from)c(the)g(name)g(of)g(the)g(SLALIB)g(routine)
g(that)g(p)r(erforms)f(the)i(con)n(v)n(ersion)c(and)j(the)h(relev)-5
-b(an)n(t)20 b(do)r(cumen)n(tation)227 3081 y(\(SUN/67\))32
+b(an)n(t)20 b(do)r(cumen)n(tation)227 3597 y(\(SUN/67\))32
b(should)g(b)r(e)g(consulted)g(for)f(details.)50 b(Where)32
b(argumen)n(ts)f(are)g(needed)h(b)n(y)f(the)i(con)n(v)n(ersion,)d(they)
-227 3181 y(are)d(listed)h(in)g(paren)n(theses.)37 b(V)-7
+227 3696 y(are)d(listed)h(in)g(paren)n(theses.)37 b(V)-7
b(alues)27 b(for)h(these)g(argumen)n(ts)e(should)i(b)r(e)g(giv)n(en,)f
(via)h(the)g Ft(")p Fi(args)p Ft(")d Fi(arra)n(y)-7 b(,)26
-b(in)i(the)227 3281 y(order)k(indicated.)52 b(The)33
+b(in)i(the)227 3796 y(order)k(indicated.)52 b(The)33
b(argumen)n(t)e(names)h(matc)n(h)h(the)g(corresp)r(onding)d(SLALIB)j
-(routine)f(argumen)n(ts)g(and)227 3380 y(their)f(v)-5
+(routine)f(argumen)n(ts)g(and)227 3896 y(their)f(v)-5
b(alues)30 b(should)h(b)r(e)g(giv)n(en)e(using)i(exactly)f(the)h(same)f
(units,)i(time)f(scale,)f(calendar,)h(etc.)46 b(as)30
-b(describ)r(ed)227 3480 y(in)e(SUN/67:)340 3737 y Fh(\017)45
+b(describ)r(ed)227 3995 y(in)e(SUN/67:)340 4253 y Fh(\017)45
b Ft(")p Fi(ADDET)p Ft(")28 b Fi(\(EQ\):)f(Add)h(E-terms)f(of)g(ab)r
-(erration.)340 3868 y Fh(\017)45 b Ft(")p Fi(SUBET)p
+(erration.)340 4384 y Fh(\017)45 b Ft(")p Fi(SUBET)p
Ft(")27 b Fi(\(EQ\):)g(Subtract)h(E-terms)e(of)i(ab)r(erration.)340
-3998 y Fh(\017)45 b Ft(")p Fi(PREBN)p Ft(")26 b Fi(\(BEP0,BEP1\):)35
+4515 y Fh(\017)45 b Ft(")p Fi(PREBN)p Ft(")26 b Fi(\(BEP0,BEP1\):)35
b(Apply)28 b(Bessel-New)n(com)n(b)d(pre-IA)n(U)i(1976)f(\(FK4\))i
-(precession)e(mo)r(del.)340 4128 y Fh(\017)45 b Ft(")p
+(precession)e(mo)r(del.)340 4646 y Fh(\017)45 b Ft(")p
Fi(PREC)p Ft(")26 b Fi(\(EP0,EP1\):)35 b(Apply)28 b(IA)n(U)g(1975)d
-(\(FK5\))j(precession)e(mo)r(del.)340 4259 y Fh(\017)45
+(\(FK5\))j(precession)e(mo)r(del.)340 4777 y Fh(\017)45
b Ft(")p Fi(FK45Z)p Ft(")26 b Fi(\(BEPOCH\):)h(Con)n(v)n(ert)f(FK4)h
(to)g(FK5)g(\(no)h(prop)r(er)e(motion)i(or)e(parallax\).)340
-4389 y Fh(\017)45 b Ft(")p Fi(FK54Z)p Ft(")26 b Fi(\(BEPOCH\):)h(Con)n
+4908 y Fh(\017)45 b Ft(")p Fi(FK54Z)p Ft(")26 b Fi(\(BEPOCH\):)h(Con)n
(v)n(ert)f(FK5)h(to)g(FK4)g(\(no)h(prop)r(er)e(motion)i(or)e
-(parallax\).)340 4520 y Fh(\017)45 b Ft(")p Fi(AMP)p
+(parallax\).)340 5039 y Fh(\017)45 b Ft(")p Fi(AMP)p
Ft(")27 b Fi(\(D)n(A)-7 b(TE,EQ\):)27 b(Con)n(v)n(ert)g(geo)r(cen)n
-(tric)f(apparen)n(t)g(to)i(mean)f(place.)340 4650 y Fh(\017)45
+(tric)f(apparen)n(t)g(to)i(mean)f(place.)340 5170 y Fh(\017)45
b Ft(")p Fi(MAP)p Ft(")27 b Fi(\(EQ,D)n(A)-7 b(TE\):)27
b(Con)n(v)n(ert)g(mean)g(place)g(to)h(geo)r(cen)n(tric)e(apparen)n(t.)
-340 4780 y Fh(\017)45 b Ft(")p Fi(ECLEQ)p Ft(")26 b Fi(\(D)n(A)-7
+340 5300 y Fh(\017)45 b Ft(")p Fi(ECLEQ)p Ft(")26 b Fi(\(D)n(A)-7
b(TE\):)28 b(Con)n(v)n(ert)e(ecliptic)i(co)r(ordinates)e(to)i(FK5)f
-(J2000.0)d(equatorial.)340 4911 y Fh(\017)45 b Ft(")p
+(J2000.0)d(equatorial.)340 5431 y Fh(\017)45 b Ft(")p
Fi(EQECL)p Ft(")26 b Fi(\(D)n(A)-7 b(TE\):)28 b(Con)n(v)n(ert)e
(equatorial)g(FK5)h(J2000.0)e(to)i(ecliptic)h(co)r(ordinates.)340
-5041 y Fh(\017)45 b Ft(")p Fi(GALEQ)p Ft(")p Fi(:)36
+5562 y Fh(\017)45 b Ft(")p Fi(GALEQ)p Ft(")p Fi(:)36
b(Con)n(v)n(ert)26 b(galactic)g(co)r(ordinates)h(to)g(FK5)g(J2000.0)e
-(equatorial.)340 5171 y Fh(\017)45 b Ft(")p Fi(EQGAL)p
+(equatorial.)340 5693 y Fh(\017)45 b Ft(")p Fi(EQGAL)p
Ft(")p Fi(:)36 b(Con)n(v)n(ert)26 b(FK5)h(J2000.0)e(equatorial)h(to)h
-(galactic)g(co)r(ordinates.)340 5302 y Fh(\017)45 b Ft(")p
-Fi(HFK5Z)p Ft(")26 b Fi(\(JEPOCH\):)h(Con)n(v)n(ert)f(ICRS)i(co)r
-(ordinates)e(to)i(FK5)f(J2000.0)e(equatorial.)340 5432
-y Fh(\017)45 b Ft(")p Fi(FK5HZ)p Ft(")26 b Fi(\(JEPOCH\):)h(Con)n(v)n
-(ert)f(FK5)h(J2000.0)e(equatorial)h(co)r(ordinates)g(to)i(ICRS.)340
-5563 y Fh(\017)45 b Ft(")p Fi(GALSUP)p Ft(")p Fi(:)37
+(galactic)g(co)r(ordinates.)p eop end
+%%Page: 368 378
+TeXDict begin 368 377 bop 0 52 a FF(368)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Ft(")p Fi(HFK5Z)p Ft(")26 b Fi(\(JEPOCH\):)h(Con)n(v)n(ert)f(ICRS)i
+(co)r(ordinates)e(to)i(FK5)f(J2000.0)e(equatorial.)340
+479 y Fh(\017)45 b Ft(")p Fi(FK5HZ)p Ft(")26 b Fi(\(JEPOCH\):)h(Con)n
+(v)n(ert)f(FK5)h(J2000.0)e(equatorial)h(co)r(ordinates)g(to)i(ICRS.)340
+607 y Fh(\017)45 b Ft(")p Fi(GALSUP)p Ft(")p Fi(:)37
b(Con)n(v)n(ert)26 b(galactic)g(to)i(sup)r(ergalactic)e(co)r
-(ordinates.)340 5693 y Fh(\017)45 b Ft(")p Fi(SUPGAL)p
+(ordinates.)340 735 y Fh(\017)45 b Ft(")p Fi(SUPGAL)p
Ft(")p Fi(:)37 b(Con)n(v)n(ert)26 b(sup)r(ergalactic)g(co)r(ordinates)g
-(to)i(galactic.)p eop end
-%%Page: 367 377
-TeXDict begin 367 376 bop 3643 52 a FF(367)340 351 y
-Fh(\017)45 b Ft(")p Fi(J2000H)p Ft(")p Fi(:)34 b(Con)n(v)n(ert)27
-b(dynamical)g(J2000.0)d(to)k(ICRS.)340 479 y Fh(\017)45
-b Ft(")p Fi(HJ2000)p Ft(")p Fi(:)34 b(Con)n(v)n(ert)27
-b(ICRS)g(to)h(dynamical)f(J2000.0.)340 607 y Fh(\017)45
-b Ft(")p Fi(R2H)p Ft(")27 b Fi(\(LAST\):)i(Con)n(v)n(ert)d(RA)i(to)f
-(Hour)g(Angle.)340 734 y Fh(\017)45 b Ft(")p Fi(H2R)p
-Ft(")27 b Fi(\(LAST\):)i(Con)n(v)n(ert)d(Hour)h(Angle)g(to)h(RA.)227
-891 y(F)-7 b(or)36 b(example,)j(to)e(use)f(the)i Ft(")p
-Fi(ADDET)p Ft(")e Fi(con)n(v)n(ersion,)h(whic)n(h)g(tak)n(es)f(a)g
-(single)g(argumen)n(t)g(EQ,)g(y)n(ou)g(should)227 991
-y(consult)c(the)g(do)r(cumen)n(tation)g(for)f(the)i(SLALIB)f(routine)f
-(SLA)p Ft(_)p Fi(ADDET.)h(This)g(describ)r(es)g(the)g(con)n(v)n(ersion)
-227 1090 y(in)e(detail)f(and)h(sho)n(ws)e(that)i(EQ)e(is)i(the)f
-(Besselian)g(ep)r(o)r(c)n(h)g(of)g(the)h(mean)f(equator)g(and)g(equino)
-n(x.)41 b(This)30 b(v)-5 b(alue)227 1190 y(should)28
+(to)i(galactic.)340 863 y Fh(\017)45 b Ft(")p Fi(J2000H)p
+Ft(")p Fi(:)34 b(Con)n(v)n(ert)27 b(dynamical)g(J2000.0)d(to)k(ICRS.)
+340 991 y Fh(\017)45 b Ft(")p Fi(HJ2000)p Ft(")p Fi(:)34
+b(Con)n(v)n(ert)27 b(ICRS)g(to)h(dynamical)f(J2000.0.)340
+1119 y Fh(\017)45 b Ft(")p Fi(R2H)p Ft(")27 b Fi(\(LAST\):)i(Con)n(v)n
+(ert)d(RA)i(to)f(Hour)g(Angle.)340 1247 y Fh(\017)45
+b Ft(")p Fi(H2R)p Ft(")27 b Fi(\(LAST\):)i(Con)n(v)n(ert)d(Hour)h
+(Angle)g(to)h(RA.)227 1404 y(F)-7 b(or)36 b(example,)j(to)e(use)f(the)i
+Ft(")p Fi(ADDET)p Ft(")e Fi(con)n(v)n(ersion,)h(whic)n(h)g(tak)n(es)f
+(a)g(single)g(argumen)n(t)g(EQ,)g(y)n(ou)g(should)227
+1504 y(consult)c(the)g(do)r(cumen)n(tation)g(for)f(the)i(SLALIB)f
+(routine)f(SLA)p Ft(_)p Fi(ADDET.)h(This)g(describ)r(es)g(the)g(con)n
+(v)n(ersion)227 1604 y(in)e(detail)f(and)h(sho)n(ws)e(that)i(EQ)e(is)i
+(the)f(Besselian)g(ep)r(o)r(c)n(h)g(of)g(the)h(mean)f(equator)g(and)g
+(equino)n(x.)41 b(This)30 b(v)-5 b(alue)227 1703 y(should)28
b(then)g(b)r(e)g(supplied)g(to)f(astSlaAdd)h(in)f(args[0].)227
-1312 y(In)40 b(addition)g(the)g(follo)n(wing)e(strings)h(ma)n(y)g(b)r
+1826 y(In)40 b(addition)g(the)g(follo)n(wing)e(strings)h(ma)n(y)g(b)r
(e)h(supplied)g(for)f(more)g(complex)g(con)n(v)n(ersions)e(whic)n(h)i
-(do)h(not)227 1411 y(corresp)r(ond)30 b(to)h(an)n(y)g(one)g(single)g
+(do)h(not)227 1925 y(corresp)r(ond)30 b(to)h(an)n(y)g(one)g(single)g
(SLALIB)g(routine)g(\(DIURAB)i(is)e(the)h(magnitude)f(of)h(the)f
-(diurnal)g(ab)r(erra-)227 1511 y(tion)j(v)n(ector)e(in)h(units)h(of)f
+(diurnal)g(ab)r(erra-)227 2025 y(tion)j(v)n(ector)e(in)h(units)h(of)f
Ft(")p Fi(da)n(y/\(2.PI\))p Ft(")p Fi(,)f(D)n(A)-7 b(TE)34
b(is)f(the)h(Mo)r(di\014ed)f(Julian)g(Date)h(of)f(the)g(observ)-5
-b(ation,)34 b(and)227 1611 y(\(OBSX,OBSY,OBZ\))k(are)f(the)i(Helio)r
+b(ation,)34 b(and)227 2124 y(\(OBSX,OBSY,OBZ\))k(are)f(the)i(Helio)r
(cen)n(tric-Aries-Ecliptic)d(cartesian)h(co)r(ordinates,)j(in)e
-(metres,)j(of)d(the)227 1710 y(observ)n(er\):)340 1963
+(metres,)j(of)d(the)227 2224 y(observ)n(er\):)340 2478
y Fh(\017)45 b Ft(")p Fi(HPCEQ)p Ft(")38 b Fi(\(D)n(A)-7
b(TE,OBSX,OBSY,OBSZ\):)39 b(Con)n(v)n(ert)f(Heliopro)5
-b(jectiv)n(e-Cartesian)36 b(co)r(ordinates)i(to)427 2063
-y(J2000.0)25 b(equatorial.)340 2191 y Fh(\017)45 b Ft(")p
+b(jectiv)n(e-Cartesian)36 b(co)r(ordinates)i(to)427 2577
+y(J2000.0)25 b(equatorial.)340 2705 y Fh(\017)45 b Ft(")p
Fi(EQHPC)p Ft(")17 b Fi(\(D)n(A)-7 b(TE,OBSX,OBSY,OBSZ\):)18
b(Con)n(v)n(ert)f(J2000.0)e(equatorial)i(co)r(ordinates)g(to)h
-(Heliopro)5 b(jectiv)n(e-)427 2290 y(Cartesian.)340 2418
+(Heliopro)5 b(jectiv)n(e-)427 2805 y(Cartesian.)340 2933
y Fh(\017)45 b Ft(")p Fi(HPREQ)p Ft(")17 b Fi(\(D)n(A)-7
b(TE,OBSX,OBSY,OBSZ\):)18 b(Con)n(v)n(ert)f(Heliopro)5
b(jectiv)n(e-Radial)16 b(co)r(ordinates)h(to)h(J2000.0)427
-2518 y(equatorial.)340 2645 y Fh(\017)45 b Ft(")p Fi(EQHPR)p
+3033 y(equatorial.)340 3161 y Fh(\017)45 b Ft(")p Fi(EQHPR)p
Ft(")17 b Fi(\(D)n(A)-7 b(TE,OBSX,OBSY,OBSZ\):)18 b(Con)n(v)n(ert)f
(J2000.0)f(equatorial)g(co)r(ordinates)h(to)h(Heliopro)5
-b(jectiv)n(e-)427 2745 y(Radial.)340 2873 y Fh(\017)45
+b(jectiv)n(e-)427 3260 y(Radial.)340 3388 y Fh(\017)45
b Ft(")p Fi(HEEQ)p Ft(")26 b Fi(\(D)n(A)-7 b(TE\):)28
b(Con)n(v)n(ert)e(helio-ecliptic)i(co)r(ordinates)e(to)h(J2000.0)e
-(equatorial.)340 3000 y Fh(\017)45 b Ft(")p Fi(EQHE)p
+(equatorial.)340 3516 y Fh(\017)45 b Ft(")p Fi(EQHE)p
Ft(")26 b Fi(\(D)n(A)-7 b(TE\):)28 b(Con)n(v)n(ert)e(J2000.0)f
(equatorial)h(co)r(ordinates)g(to)i(helio-ecliptic.)340
-3128 y Fh(\017)45 b Ft(")p Fi(H2E)p Ft(")26 b Fi(\(LA)-7
+3644 y Fh(\017)45 b Ft(")p Fi(H2E)p Ft(")26 b Fi(\(LA)-7
b(T,DIR)n(UAB\):)30 b(Con)n(v)n(ert)c(horizon)g(co)r(ordinates)g(to)i
-(equatorial.)340 3255 y Fh(\017)45 b Ft(")p Fi(E2H)p
+(equatorial.)340 3772 y Fh(\017)45 b Ft(")p Fi(E2H)p
Ft(")26 b Fi(\(LA)-7 b(T,DIURAB\):)30 b(Con)n(v)n(ert)c(equatorial)g
-(co)r(ordinates)g(to)i(horizon.)227 3412 y(Note,)40 b(the)e
+(co)r(ordinates)g(to)i(horizon.)227 3929 y(Note,)40 b(the)e
Ft(")p Fi(H2E)p Ft(")e Fi(and)i Ft(")p Fi(E2H)p Ft(")e
Fi(con)n(v)n(ersions)f(con)n(v)n(ert)h(b)r(et)n(w)n(een)i(top)r(o)r
-(cen)n(tric)f(horizon)f(co)r(ordinates)g(\(az-)227 3512
+(cen)n(tric)f(horizon)f(co)r(ordinates)g(\(az-)227 4029
y(im)n(uth,elev)-5 b(ation\),)39 b(and)d(apparen)n(t)f(lo)r(cal)h
(equatorial)e(co)r(ordinates)h(\(hour)h(angle,declination\).)61
-b(Th)n(us,)38 b(the)227 3611 y(e\013ects)g(of)f(diurnal)g(ab)r
+b(Th)n(us,)38 b(the)227 4129 y(e\013ects)g(of)f(diurnal)g(ab)r
(erration)f(are)g(tak)n(en)h(in)n(to)g(accoun)n(t)f(in)i(the)f(con)n(v)
-n(ersions)e(but)j(the)g(e\013ects)f(of)g(atmo-)227 3711
-y(spheric)27 b(refraction)g(are)f(not.)p 0 3900 3780
-12 v 0 4032 a Fz(astSlaMap)811 b Fe(Create)38 b(an)g(SlaMap)810
-b Fz(astSlaMap)0 4210 y Fd(Description:)44 b Fi(This)28
+n(ersions)e(but)j(the)g(e\013ects)f(of)g(atmo-)227 4228
+y(spheric)27 b(refraction)g(are)f(not.)p 0 4418 3780
+12 v 0 4550 a Fz(astSlaMap)811 b Fe(Create)38 b(an)g(SlaMap)810
+b Fz(astSlaMap)0 4729 y Fd(Description:)44 b Fi(This)28
b(function)g(creates)f(a)g(new)g(SlaMap)g(and)h(optionally)f
-(initialises)g(its)h(attributes.)227 4332 y(An)19 b(SlaMap)f(is)g(a)g
+(initialises)g(its)h(attributes.)227 4851 y(An)19 b(SlaMap)f(is)g(a)g
(sp)r(ecialised)g(form)g(of)h(Mapping)f(whic)n(h)g(can)g(b)r(e)h(used)f
(to)h(represen)n(t)e(a)h(sequence)g(of)g(con)n(v)n(ersions)227
-4432 y(b)r(et)n(w)n(een)28 b(standard)e(celestial)i(\(longitude,)f
-(latitude\))i(co)r(ordinate)d(systems.)227 4554 y(When)e(an)e(SlaMap)h
+4951 y(b)r(et)n(w)n(een)28 b(standard)e(celestial)i(\(longitude,)f
+(latitude\))i(co)r(ordinate)d(systems.)227 5073 y(When)e(an)e(SlaMap)h
(is)g(\014rst)f(created,)h(it)h(simply)f(p)r(erforms)f(a)g(unit)i(\(n)n
(ull\))f(Mapping)g(on)f(a)h(pair)f(of)h(co)r(ordinates.)227
-4653 y(Using)k(the)g(astSlaAdd)g(function,)g(a)g(series)f(of)g(co)r
+5172 y(Using)k(the)g(astSlaAdd)g(function,)g(a)g(series)f(of)g(co)r
(ordinate)g(con)n(v)n(ersion)e(steps)j(ma)n(y)f(then)i(b)r(e)f(added,)g
-(selected)227 4753 y(from)h(those)g(pro)n(vided)f(b)n(y)g(the)i(SLALIB)
+(selected)227 5272 y(from)h(those)g(pro)n(vided)f(b)n(y)g(the)i(SLALIB)
f(P)n(ositional)e(Astronom)n(y)h(Library)f(\(Starlink)i(User)g(Note)g
-(SUN/67\).)227 4852 y(This)21 b(allo)n(ws)f(m)n(ulti-step)i(con)n(v)n
+(SUN/67\).)227 5372 y(This)21 b(allo)n(ws)f(m)n(ulti-step)i(con)n(v)n
(ersions)c(b)r(et)n(w)n(een)j(a)g(v)-5 b(ariet)n(y)20
b(of)i(celestial)e(co)r(ordinate)g(systems)h(to)g(b)r(e)h(assem)n(bled)
-227 4952 y(out)28 b(of)f(the)h(building)g(blo)r(c)n(ks)f(pro)n(vided)g
-(b)n(y)g(SLALIB.)227 5074 y(F)-7 b(or)27 b(details)f(of)h(the)g
+227 5471 y(out)28 b(of)f(the)h(building)g(blo)r(c)n(ks)f(pro)n(vided)g
+(b)n(y)g(SLALIB.)227 5593 y(F)-7 b(or)27 b(details)f(of)h(the)g
(individual)g(co)r(ordinate)f(con)n(v)n(ersions)f(a)n(v)-5
b(ailable,)25 b(see)i(the)g(description)g(of)f(the)i(astSlaAdd)227
-5174 y(function.)0 5318 y Fd(Synopsis:)121 b Ft(AstSlaMap)40
-b Fh(\003)p Ft(astSlaMap\()f(int)j(flags,)f(const)h(char)g
-Fh(\003)p Ft(options,)d(...)86 b(\))0 5462 y Fd(P)m(arameters:)259
-5593 y(\015ags)427 5693 y Fi(This)28 b(parameter)e(is)h(reserv)n(ed)f
+5693 y(function.)p eop end
+%%Page: 369 379
+TeXDict begin 369 378 bop 3643 52 a FF(369)0 351 y Fd(Synopsis:)121
+b Ft(AstSlaMap)40 b Fh(\003)p Ft(astSlaMap\()f(int)j(flags,)f(const)h
+(char)g Fh(\003)p Ft(options,)d(...)86 b(\))0 507 y Fd(P)m(arameters:)
+259 649 y(\015ags)427 748 y Fi(This)28 b(parameter)e(is)h(reserv)n(ed)f
(for)h(future)h(use)g(and)f(should)h(curren)n(tly)e(alw)n(a)n(ys)g(b)r
-(e)i(set)f(to)h(zero.)p eop end
-%%Page: 368 378
-TeXDict begin 368 377 bop 0 52 a FF(368)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(options)427
-451 y Fi(P)n(oin)n(ter)d(to)h(a)g(n)n(ull-terminated)g(string)f(con)n
+(e)i(set)f(to)h(zero.)259 884 y Fd(options)427 984 y
+Fi(P)n(oin)n(ter)f(to)h(a)g(n)n(ull-terminated)g(string)f(con)n
(taining)g(an)h(optional)g(comma-separated)e(list)i(of)g(attribute)427
-551 y(assignmen)n(ts)f(to)h(b)r(e)h(used)f(for)f(initialising)h(the)h
+1083 y(assignmen)n(ts)f(to)h(b)r(e)h(used)f(for)f(initialising)h(the)h
(new)f(SlaMap.)38 b(The)28 b(syn)n(tax)f(used)h(is)g(iden)n(tical)g(to)
-g(that)427 650 y(for)e(the)h(astSet)g(function)g(and)g(ma)n(y)f
+g(that)427 1183 y(for)e(the)h(astSet)g(function)g(and)g(ma)n(y)f
(include)h Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g
(iden)n(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-750 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)35 b(If)28
+1283 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)35 b(If)28
b(no)g(initialisation)f(is)g(required,)g(a)g(zero-length)f(string)h(ma)
-n(y)g(b)r(e)h(supplied.)259 894 y Fd(...)427 993 y Fi(If)38
-b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n(tains)f
+n(y)g(b)r(e)h(supplied.)259 1418 y Fd(...)427 1518 y
+Fi(If)38 b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n(tains)f
Ft(")p Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f
-(optional)g(list)h(of)f(additional)427 1093 y(argumen)n(ts)26
+(optional)g(list)h(of)f(additional)427 1618 y(argumen)n(ts)26
b(ma)n(y)h(follo)n(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5
b(alues)27 b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)
-37 b(The)427 1193 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+37 b(The)427 1717 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 1292 y Fi(function\).)0
-1476 y Fd(Returned)32 b(V)-8 b(alue:)259 1635 y(astSlaMap\(\))427
-1735 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(SlaMap.)0
-1919 y Fd(Notes:)340 2224 y Fh(\017)45 b Fi(The)32 b(Nin)g(and)f(Nout)h
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 1817 y Fi(function\).)0
+1985 y Fd(Returned)32 b(V)-8 b(alue:)259 2127 y(astSlaMap\(\))427
+2227 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(SlaMap.)0
+2394 y Fd(Notes:)340 2683 y Fh(\017)45 b Fi(The)32 b(Nin)g(and)f(Nout)h
(attributes)f(\(n)n(um)n(b)r(er)h(of)f(input)i(and)e(output)h(co)r
-(ordinates\))e(for)h(an)h(SlaMap)f(are)427 2324 y(b)r(oth)g(equal)e(to)
+(ordinates\))e(for)h(an)h(SlaMap)f(are)427 2782 y(b)r(oth)g(equal)e(to)
h(2.)44 b(The)30 b(\014rst)g(co)r(ordinate)f(is)h(the)h(celestial)e
(longitude)h(and)g(the)g(second)g(co)r(ordinate)f(is)427
-2423 y(the)f(celestial)f(latitude.)38 b(All)28 b(co)r(ordinate)e(v)-5
-b(alues)27 b(are)g(in)h(radians.)340 2567 y Fh(\017)45
+2882 y(the)f(celestial)f(latitude.)38 b(All)28 b(co)r(ordinate)e(v)-5
+b(alues)27 b(are)g(in)h(radians.)340 3018 y Fh(\017)45
b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
-(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 2667 y(AST)28
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 3117 y(AST)28
b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)p 0 2888 3780 12 v 0 3020 a Fz(astSp)t(ecAdd)171
+(reason.)p 0 3322 3780 12 v 0 3454 a Fz(astSp)t(ecAdd)171
b Fe(Add)39 b(a)g(sp)s(ectral)e(co)s(ordinate)g(con)m(v)m(ersion)f(to)
-1607 3133 y(a)i(Sp)s(ecMap)3083 3020 y Fz(astSp)t(ecAdd)0
-3344 y Fd(Description:)44 b Fi(This)21 b(function)h(adds)e(one)h(of)g
+1607 3567 y(a)i(Sp)s(ecMap)3083 3454 y Fz(astSp)t(ecAdd)0
+3762 y Fd(Description:)44 b Fi(This)21 b(function)h(adds)e(one)h(of)g
(the)g(standard)f(sp)r(ectral)g(co)r(ordinate)g(system)g(con)n(v)n
-(ersions)f(listed)i(b)r(elo)n(w)227 3444 y(to)28 b(an)f(existing)g(Sp)r
-(ecMap.)227 3580 y(When)22 b(a)f(Sp)r(ecMap)h(is)f(\014rst)g(created)g
+(ersions)f(listed)i(b)r(elo)n(w)227 3862 y(to)28 b(an)f(existing)g(Sp)r
+(ecMap.)227 3989 y(When)22 b(a)f(Sp)r(ecMap)h(is)f(\014rst)g(created)g
(\(using)g(astSp)r(ecMap\),)i(it)f(simply)f(p)r(erforms)g(a)g(unit)h
-(\(n)n(ull\))g(Mapping.)35 b(By)227 3679 y(using)28 b(astSp)r(ecAdd)g
+(\(n)n(ull\))g(Mapping.)35 b(By)227 4089 y(using)28 b(astSp)r(ecAdd)g
(\(rep)r(eatedly)g(if)g(necessary\),)e(one)i(or)f(more)g(co)r(ordinate)
g(con)n(v)n(ersion)e(steps)j(ma)n(y)f(then)h(b)r(e)227
-3779 y(added,)e(whic)n(h)f(the)g(Sp)r(ecMap)h(will)f(p)r(erform)f(in)i
+4188 y(added,)e(whic)n(h)f(the)g(Sp)r(ecMap)h(will)f(p)r(erform)f(in)i
(sequence.)35 b(This)25 b(allo)n(ws)f(m)n(ulti-step)h(con)n(v)n
-(ersions)e(b)r(et)n(w)n(een)i(a)227 3879 y(v)-5 b(ariet)n(y)27
+(ersions)e(b)r(et)n(w)n(een)i(a)227 4288 y(v)-5 b(ariet)n(y)27
b(of)g(sp)r(ectral)g(co)r(ordinate)g(systems)g(to)g(b)r(e)h(assem)n
(bled)e(out)i(of)f(the)h(building)g(blo)r(c)n(ks)f(pro)n(vided)f(b)n(y)
-h(this)227 3978 y(class.)227 4114 y(Normally)-7 b(,)28
+h(this)227 4388 y(class.)227 4515 y(Normally)-7 b(,)28
b(if)h(a)g(Sp)r(ecMap's)f(In)n(v)n(ert)g(attribute)h(is)f(zero)g(\(the)
h(default\),)h(then)f(its)g(forw)n(ard)e(transformation)g(is)227
-4214 y(p)r(erformed)j(b)n(y)f(carrying)f(out)i(eac)n(h)f(of)h(the)g
+4615 y(p)r(erformed)j(b)n(y)f(carrying)f(out)i(eac)n(h)f(of)h(the)g
(individual)g(co)r(ordinate)f(con)n(v)n(ersions)e(sp)r(eci\014ed)k(b)n
-(y)e(astSp)r(ecAdd)227 4313 y(in)f(the)g(order)e(giv)n(en)h(\(i.e.)37
+(y)e(astSp)r(ecAdd)227 4714 y(in)f(the)g(order)e(giv)n(en)h(\(i.e.)37
b(with)29 b(the)e(most)h(recen)n(tly)f(added)g(con)n(v)n(ersion)e
-(applied)j(last\).)227 4449 y(This)23 b(order)e(is)h(rev)n(ersed)e(if)j
+(applied)j(last\).)227 4842 y(This)23 b(order)e(is)h(rev)n(ersed)e(if)j
(the)g(Sp)r(ecMap's)f(In)n(v)n(ert)g(attribute)g(is)g(non-zero)f(\(or)h
-(if)h(the)f(in)n(v)n(erse)f(transformation)227 4549 y(is)27
+(if)h(the)f(in)n(v)n(erse)f(transformation)227 4941 y(is)27
b(requested)f(b)n(y)h(an)n(y)f(other)g(means\))h(and)g(eac)n(h)f
(individual)h(co)r(ordinate)f(con)n(v)n(ersion)e(is)j(also)f(replaced)g
-(b)n(y)g(its)227 4648 y(o)n(wn)21 b(in)n(v)n(erse.)33
+(b)n(y)g(its)227 5041 y(o)n(wn)21 b(in)n(v)n(erse.)33
b(This)22 b(pro)r(cess)e(in)n(v)n(erts)g(the)i(o)n(v)n(erall)d
(e\013ect)j(of)f(the)h(Sp)r(ecMap.)35 b(In)22 b(this)f(case,)h(the)g
-(\014rst)f(con)n(v)n(ersion)227 4748 y(to)28 b(b)r(e)g(applied)f(w)n
+(\014rst)f(con)n(v)n(ersion)227 5141 y(to)28 b(b)r(e)g(applied)f(w)n
(ould)g(b)r(e)h(the)g(in)n(v)n(erse)f(of)g(the)h(one)f(most)h(recen)n
-(tly)f(added.)0 4920 y Fd(Synopsis:)121 b Ft(void)42
+(tly)f(added.)0 5296 y Fd(Synopsis:)121 b Ft(void)42
b(astSpecAdd\()d(AstSpecMap)g Fh(\003)p Ft(this,)i(const)h(char)g
-Fh(\003)p Ft(cvt,)f(const)h(double)f(args[])g(\))0 5091
-y Fd(P)m(arameters:)259 5250 y(this)427 5350 y Fi(P)n(oin)n(ter)26
-b(to)i(the)g(Sp)r(ecMap.)259 5494 y Fd(cvt)427 5593 y
-Fi(P)n(oin)n(ter)g(to)i(a)f(n)n(ull-terminated)g(string)g(whic)n(h)h
-(iden)n(ti\014es)g(the)g(sp)r(ectral)f(co)r(ordinate)f(con)n(v)n
-(ersion)g(to)h(b)r(e)427 5693 y(added)24 b(to)g(the)g(Sp)r(ecMap.)36
+Fh(\003)p Ft(cvt,)f(const)h(double)f(args[])g(\))0 5451
+y Fd(P)m(arameters:)259 5593 y(this)427 5693 y Fi(P)n(oin)n(ter)26
+b(to)i(the)g(Sp)r(ecMap.)p eop end
+%%Page: 370 380
+TeXDict begin 370 379 bop 0 52 a FF(370)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(cvt)427
+451 y Fi(P)n(oin)n(ter)e(to)i(a)f(n)n(ull-terminated)g(string)g(whic)n
+(h)h(iden)n(ti\014es)g(the)g(sp)r(ectral)f(co)r(ordinate)f(con)n(v)n
+(ersion)g(to)h(b)r(e)427 551 y(added)24 b(to)g(the)g(Sp)r(ecMap.)36
b(See)23 b(the)h Ft(")p Fi(Av)-5 b(ailable)24 b(Con)n(v)n(ersions)p
Ft(")c Fi(section)k(for)f(details)h(of)f(those)h(a)n(v)-5
-b(ailable.)p eop end
-%%Page: 369 379
-TeXDict begin 369 378 bop 3643 52 a FF(369)259 351 y
-Fd(args)427 451 y Fi(An)29 b(arra)n(y)d(con)n(taining)h(argumen)n(t)g
-(v)-5 b(alues)28 b(for)g(the)h(sp)r(ectral)f(co)r(ordinate)f(con)n(v)n
-(ersion.)36 b(The)29 b(n)n(um)n(b)r(er)f(of)427 551 y(argumen)n(ts)22
-b(required,)h(and)g(hence)g(the)g(n)n(um)n(b)r(er)g(of)g(arra)n(y)e
-(elemen)n(ts)h(used,)i(dep)r(ends)g(on)f(the)g(con)n(v)n(ersion)427
-650 y(sp)r(eci\014ed)f(\(see)f(the)h Ft(")p Fi(Av)-5
-b(ailable)21 b(Con)n(v)n(ersions)p Ft(")d Fi(section\).)35
-b(This)21 b(arra)n(y)e(is)j(ignored)e(and)h(a)g(NULL)h(p)r(oin)n(ter)
-427 750 y(ma)n(y)27 b(b)r(e)h(supplied)g(if)g(no)g(argumen)n(ts)e(are)g
-(needed.)0 911 y Fd(Notes:)340 1192 y Fh(\017)45 b Fi(When)37
-b(assem)n(bling)e(a)g(m)n(ulti-stage)h(con)n(v)n(ersion,)g(it)g(can)g
-(sometimes)g(b)r(e)g(di\016cult)h(to)f(determine)g(the)427
-1292 y(most)31 b(economical)g(con)n(v)n(ersion)e(path.)48
-b(F)-7 b(or)30 b(example,)i(when)g(con)n(v)n(erting)d(b)r(et)n(w)n(een)
-j(reference)e(frames,)427 1392 y(con)n(v)n(erting)19
+b(ailable.)259 687 y Fd(args)427 787 y Fi(An)29 b(arra)n(y)d(con)n
+(taining)h(argumen)n(t)g(v)-5 b(alues)28 b(for)g(the)h(sp)r(ectral)f
+(co)r(ordinate)f(con)n(v)n(ersion.)36 b(The)29 b(n)n(um)n(b)r(er)f(of)
+427 887 y(argumen)n(ts)22 b(required,)h(and)g(hence)g(the)g(n)n(um)n(b)
+r(er)g(of)g(arra)n(y)e(elemen)n(ts)h(used,)i(dep)r(ends)g(on)f(the)g
+(con)n(v)n(ersion)427 986 y(sp)r(eci\014ed)f(\(see)f(the)h
+Ft(")p Fi(Av)-5 b(ailable)21 b(Con)n(v)n(ersions)p Ft(")d
+Fi(section\).)35 b(This)21 b(arra)n(y)e(is)j(ignored)e(and)h(a)g(NULL)h
+(p)r(oin)n(ter)427 1086 y(ma)n(y)27 b(b)r(e)h(supplied)g(if)g(no)g
+(argumen)n(ts)e(are)g(needed.)0 1256 y Fd(Notes:)340
+1546 y Fh(\017)45 b Fi(When)37 b(assem)n(bling)e(a)g(m)n(ulti-stage)h
+(con)n(v)n(ersion,)g(it)g(can)g(sometimes)g(b)r(e)g(di\016cult)h(to)f
+(determine)g(the)427 1646 y(most)31 b(economical)g(con)n(v)n(ersion)e
+(path.)48 b(F)-7 b(or)30 b(example,)i(when)g(con)n(v)n(erting)d(b)r(et)
+n(w)n(een)j(reference)e(frames,)427 1745 y(con)n(v)n(erting)19
b(\014rst)i(to)f(the)i(heliographic)d(reference)h(frame)g(as)g(an)h(in)
n(termediate)f(stage)g(is)h(often)g(sensible)f(in)427
-1491 y(form)n(ulating)28 b(the)i(problem,)e(but)i(ma)n(y)e(in)n(tro)r
+1845 y(form)n(ulating)28 b(the)i(problem,)e(but)i(ma)n(y)e(in)n(tro)r
(duce)h(unnecessary)e(extra)h(con)n(v)n(ersion)f(steps.)41
-b(A)29 b(solution)427 1591 y(to)f(this)h(is)f(to)g(include)g(all)g(the)
+b(A)29 b(solution)427 1945 y(to)f(this)h(is)f(to)g(include)g(all)g(the)
h(steps)f(whic)n(h)g(are)f(\(logically\))g(necessary)-7
-b(,)27 b(but)i(then)f(to)g(use)g(astSimplify)427 1691
+b(,)27 b(but)i(then)f(to)g(use)g(astSimplify)427 2044
y(to)f(simplify)h(the)g(resulting)e(Sp)r(ecMap.)37 b(The)27
b(simpli\014cation)g(pro)r(cess)f(will)i(eliminate)f(an)n(y)g(steps)g
-(whic)n(h)427 1790 y(turn)h(out)g(not)f(to)h(b)r(e)g(needed.)340
-1922 y Fh(\017)45 b Fi(This)27 b(function)h(do)r(es)f(not)g(c)n(hec)n
+(whic)n(h)427 2144 y(turn)h(out)g(not)f(to)h(b)r(e)g(needed.)340
+2281 y Fh(\017)45 b Fi(This)27 b(function)h(do)r(es)f(not)g(c)n(hec)n
(k)f(to)h(ensure)g(that)g(the)h(sequence)e(of)h(co)r(ordinate)f(con)n
-(v)n(ersions)f(added)i(to)427 2022 y(a)g(Sp)r(ecMap)h(is)g(ph)n
-(ysically)e(meaningful.)-2 2183 y Fd(Av)-5 b(ailable)32
-b(Con)m(v)m(ersions)n(:)227 2329 y Fi(The)39 b(follo)n(wing)f(strings)g
+(v)n(ersions)f(added)i(to)427 2380 y(a)g(Sp)r(ecMap)h(is)g(ph)n
+(ysically)e(meaningful.)-2 2550 y Fd(Av)-5 b(ailable)32
+b(Con)m(v)m(ersions)n(:)227 2696 y Fi(The)39 b(follo)n(wing)f(strings)g
(\(whic)n(h)h(are)e(case-insensitiv)n(e\))h(ma)n(y)g(b)r(e)h(supplied)g
(via)f(the)h Ft(")p Fi(cvt)p Ft(")f Fi(parameter)g(to)227
-2428 y(indicate)32 b(whic)n(h)f(sp)r(ectral)g(co)r(ordinate)f(con)n(v)n
+2796 y(indicate)32 b(whic)n(h)f(sp)r(ectral)g(co)r(ordinate)f(con)n(v)n
(ersion)f(is)i(to)g(b)r(e)h(added)f(to)g(the)h(Sp)r(ecMap.)48
-b(Where)31 b(argumen)n(ts)227 2528 y(are)25 b(needed)h(b)n(y)f(the)h
+b(Where)31 b(argumen)n(ts)227 2895 y(are)25 b(needed)h(b)n(y)f(the)h
(con)n(v)n(ersion,)e(they)i(are)e(listed)i(in)g(paren)n(theses.)35
b(V)-7 b(alues)26 b(for)f(these)g(argumen)n(ts)g(should)g(b)r(e)227
-2628 y(giv)n(en,)g(via)f(the)g Ft(")p Fi(args)p Ft(")f
+2995 y(giv)n(en,)g(via)f(the)g Ft(")p Fi(args)p Ft(")f
Fi(arra)n(y)-7 b(,)22 b(in)j(the)g(order)e(indicated.)36
b(Units)25 b(and)g(argumen)n(t)e(names)h(are)g(describ)r(ed)g(at)g(the)
-227 2727 y(end)k(of)g(the)g(list)f(of)h(con)n(v)n(ersions.)340
-2987 y Fh(\017)45 b Ft(")p Fi(FR)-7 b(TO)n(VL)p Ft(")27
+227 3095 y(end)k(of)g(the)g(list)f(of)h(con)n(v)n(ersions.)340
+3367 y Fh(\017)45 b Ft(")p Fi(FR)-7 b(TO)n(VL)p Ft(")27
b Fi(\(RF\):)i(Con)n(v)n(ert)d(frequency)h(to)g(relativistic)g(v)n(elo)
-r(cit)n(y)-7 b(.)340 3119 y Fh(\017)45 b Ft(")p Fi(VL)-7
+r(cit)n(y)-7 b(.)340 3504 y Fh(\017)45 b Ft(")p Fi(VL)-7
b(TOFR)p Ft(")27 b Fi(\(RF\):)i(Con)n(v)n(ert)d(relativistic)h(v)n(elo)
-r(cit)n(y)g(to)g(F)-7 b(requency)g(.)340 3251 y Fh(\017)45
+r(cit)n(y)g(to)g(F)-7 b(requency)g(.)340 3641 y Fh(\017)45
b Ft(")p Fi(ENTOFR)p Ft(")p Fi(:)36 b(Con)n(v)n(ert)26
-b(energy)h(to)g(frequency)-7 b(.)340 3383 y Fh(\017)45
+b(energy)h(to)g(frequency)-7 b(.)340 3778 y Fh(\017)45
b Ft(")p Fi(FR)-7 b(TOEN)p Ft(")p Fi(:)36 b(Con)n(v)n(ert)26
-b(frequency)h(to)h(energy)-7 b(.)340 3515 y Fh(\017)45
+b(frequency)h(to)h(energy)-7 b(.)340 3915 y Fh(\017)45
b Ft(")p Fi(WNTOFR)p Ft(")p Fi(:)37 b(Con)n(v)n(ert)26
b(w)n(a)n(v)n(e)g(n)n(um)n(b)r(er)h(to)h(frequency)-7
-b(.)340 3647 y Fh(\017)45 b Ft(")p Fi(FR)-7 b(TO)n(WN)p
+b(.)340 4051 y Fh(\017)45 b Ft(")p Fi(FR)-7 b(TO)n(WN)p
Ft(")p Fi(:)37 b(Con)n(v)n(ert)26 b(frequency)h(to)g(w)n(a)n(v)n(e)f(n)
-n(um)n(b)r(er.)340 3779 y Fh(\017)45 b Ft(")p Fi(WVTOFR)p
+n(um)n(b)r(er.)340 4188 y Fh(\017)45 b Ft(")p Fi(WVTOFR)p
Ft(")p Fi(:)37 b(Con)n(v)n(ert)26 b(w)n(a)n(v)n(elength)g(\(v)-5
-b(acuum\))28 b(to)g(frequency)-7 b(.)340 3910 y Fh(\017)45
+b(acuum\))28 b(to)g(frequency)-7 b(.)340 4325 y Fh(\017)45
b Ft(")p Fi(FR)-7 b(TO)n(WV)p Ft(")p Fi(:)37 b(Con)n(v)n(ert)26
b(frequency)h(to)g(w)n(a)n(v)n(elength)f(\(v)-5 b(acuum\).)340
-4042 y Fh(\017)45 b Ft(")p Fi(A)-9 b(WTOFR)p Ft(")p Fi(:)37
+4462 y Fh(\017)45 b Ft(")p Fi(A)-9 b(WTOFR)p Ft(")p Fi(:)37
b(Con)n(v)n(ert)26 b(w)n(a)n(v)n(elength)g(\(air\))h(to)h(frequency)-7
-b(.)340 4174 y Fh(\017)45 b Ft(")p Fi(FR)-7 b(TO)n(A)e(W)p
+b(.)340 4599 y Fh(\017)45 b Ft(")p Fi(FR)-7 b(TO)n(A)e(W)p
Ft(")p Fi(:)36 b(Con)n(v)n(ert)27 b(frequency)g(to)g(w)n(a)n(v)n
-(elength)f(\(air\).)340 4306 y Fh(\017)45 b Ft(")p Fi(VR)-7
+(elength)f(\(air\).)340 4735 y Fh(\017)45 b Ft(")p Fi(VR)-7
b(TO)n(VL)p Ft(")p Fi(:)36 b(Con)n(v)n(ert)26 b(radio)h(to)g
-(relativistic)g(v)n(elo)r(cit)n(y)-7 b(.)340 4438 y Fh(\017)45
+(relativistic)g(v)n(elo)r(cit)n(y)-7 b(.)340 4872 y Fh(\017)45
b Ft(")p Fi(VL)-7 b(TO)n(VR)p Ft(")p Fi(:)36 b(Con)n(v)n(ert)26
b(relativistic)h(to)h(radio)e(v)n(elo)r(cit)n(y)-7 b(.)340
-4570 y Fh(\017)45 b Ft(")p Fi(V)n(OTO)n(VL)p Ft(")p Fi(:)35
+5009 y Fh(\017)45 b Ft(")p Fi(V)n(OTO)n(VL)p Ft(")p Fi(:)35
b(Con)n(v)n(ert)26 b(optical)i(to)f(relativistic)g(v)n(elo)r(cit)n(y)-7
-b(.)340 4702 y Fh(\017)45 b Ft(")p Fi(VL)-7 b(TO)n(V)n(O)p
+b(.)340 5146 y Fh(\017)45 b Ft(")p Fi(VL)-7 b(TO)n(V)n(O)p
Ft(")p Fi(:)35 b(Con)n(v)n(ert)27 b(relativistic)f(to)i(optical)f(v)n
-(elo)r(cit)n(y)-7 b(.)340 4834 y Fh(\017)45 b Ft(")p
+(elo)r(cit)n(y)-7 b(.)340 5283 y Fh(\017)45 b Ft(")p
Fi(ZOTO)n(VL)p Ft(")p Fi(:)35 b(Con)n(v)n(ert)26 b(redshift)i(to)g
-(relativistic)e(v)n(elo)r(cit)n(y)-7 b(.)340 4966 y Fh(\017)45
+(relativistic)e(v)n(elo)r(cit)n(y)-7 b(.)340 5419 y Fh(\017)45
b Ft(")p Fi(VL)-7 b(TOZO)p Ft(")p Fi(:)35 b(Con)n(v)n(ert)27
b(relativistic)g(v)n(elo)r(cit)n(y)f(to)i(redshift.)340
-5098 y Fh(\017)45 b Ft(")p Fi(BTTO)n(VL)p Ft(")p Fi(:)36
+5556 y Fh(\017)45 b Ft(")p Fi(BTTO)n(VL)p Ft(")p Fi(:)36
b(Con)n(v)n(ert)26 b(b)r(eta)i(factor)e(to)i(relativistic)f(v)n(elo)r
-(cit)n(y)-7 b(.)340 5230 y Fh(\017)45 b Ft(")p Fi(VL)-7
+(cit)n(y)-7 b(.)340 5693 y Fh(\017)45 b Ft(")p Fi(VL)-7
b(TOBT)p Ft(")p Fi(:)36 b(Con)n(v)n(ert)26 b(relativistic)h(v)n(elo)r
-(cit)n(y)g(to)g(b)r(eta)h(factor.)340 5362 y Fh(\017)45
-b Ft(")p Fi(USF2HL)p Ft(")28 b Fi(\(V)n(OFF,RA,DEC\):)i(Con)n(v)n(ert)d
-(frequency)g(from)h(a)g(user-de\014ned)g(reference)g(frame)g(to)g(he-)
-427 5461 y(lio)r(cen)n(tric.)340 5593 y Fh(\017)45 b
-Ft(")p Fi(HLF2US)p Ft(")31 b Fi(\(V)n(OFF,RA,DEC\):)h(Con)n(v)n(ert)d
+(cit)n(y)g(to)g(b)r(eta)h(factor.)p eop end
+%%Page: 371 381
+TeXDict begin 371 380 bop 3643 52 a FF(371)340 351 y
+Fh(\017)45 b Ft(")p Fi(USF2HL)p Ft(")28 b Fi(\(V)n(OFF,RA,DEC\):)i(Con)
+n(v)n(ert)d(frequency)g(from)h(a)g(user-de\014ned)g(reference)g(frame)g
+(to)g(he-)427 451 y(lio)r(cen)n(tric.)340 583 y Fh(\017)45
+b Ft(")p Fi(HLF2US)p Ft(")31 b Fi(\(V)n(OFF,RA,DEC\):)h(Con)n(v)n(ert)d
(frequency)i(from)g(helio)r(cen)n(tric)f(reference)g(frame)h(to)g
-(user-)427 5693 y(de\014ned.)p eop end
-%%Page: 370 380
-TeXDict begin 370 379 bop 0 52 a FF(370)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
-b Ft(")p Fi(TPF2HL)p Ft(")17 b Fi(\(OBSLON,OBSLA)-7 b(T,OBSAL)g
+(user-)427 683 y(de\014ned.)340 815 y Fh(\017)45 b Ft(")p
+Fi(TPF2HL)p Ft(")17 b Fi(\(OBSLON,OBSLA)-7 b(T,OBSAL)g
(T,EPOCH,RA,DEC\):)17 b(Con)n(v)n(ert)g(frequency)h(from)g(top)r(o)r
-(cen-)427 451 y(tric)28 b(reference)e(frame)i(to)f(helio)r(cen)n(tric.)
-340 570 y Fh(\017)45 b Ft(")p Fi(HLF2TP)p Ft(")20 b Fi(\(OBSLON,OBSLA)
--7 b(T,OBSAL)g(T,EPOCH,RA,DEC\):)20 b(Con)n(v)n(ert)g(frequency)h(from)
-g(helio-)427 670 y(cen)n(tric)27 b(reference)g(frame)g(to)h(top)r(o)r
-(cen)n(tric.)340 789 y Fh(\017)45 b Ft(")p Fi(GEF2HL)p
-Ft(")24 b Fi(\(EPOCH,RA,DEC\):)h(Con)n(v)n(ert)f(frequency)h(from)g
-(geo)r(cen)n(tric)f(reference)g(frame)h(to)g(helio-)427
-889 y(cen)n(tric.)340 1009 y Fh(\017)45 b Ft(")p Fi(HLF2GE)p
-Ft(")24 b Fi(\(EPOCH,RA,DEC\):)h(Con)n(v)n(ert)f(frequency)h(from)g
-(helio)r(cen)n(tric)g(reference)f(frame)h(to)g(geo-)427
-1108 y(cen)n(tric.)340 1228 y Fh(\017)45 b Ft(")p Fi(BYF2HL)p
-Ft(")30 b Fi(\(EPOCH,RA,DEC\):)g(Con)n(v)n(ert)f(frequency)h(from)g
-(barycen)n(tric)f(reference)h(frame)g(to)g(he-)427 1327
-y(lio)r(cen)n(tric.)340 1447 y Fh(\017)45 b Ft(")p Fi(HLF2BY)p
-Ft(")18 b Fi(\(EPOCH,RA,DEC\):)g(Con)n(v)n(ert)f(frequency)h(from)g
-(helio)r(cen)n(tric)g(reference)f(frame)h(to)g(barycen-)427
-1546 y(tric.)340 1666 y Fh(\017)45 b Ft(")p Fi(LKF2HL)p
+(cen-)427 914 y(tric)28 b(reference)e(frame)i(to)f(helio)r(cen)n(tric.)
+340 1047 y Fh(\017)45 b Ft(")p Fi(HLF2TP)p Ft(")20 b
+Fi(\(OBSLON,OBSLA)-7 b(T,OBSAL)g(T,EPOCH,RA,DEC\):)20
+b(Con)n(v)n(ert)g(frequency)h(from)g(helio-)427 1146
+y(cen)n(tric)27 b(reference)g(frame)g(to)h(top)r(o)r(cen)n(tric.)340
+1278 y Fh(\017)45 b Ft(")p Fi(GEF2HL)p Ft(")24 b Fi(\(EPOCH,RA,DEC\):)h
+(Con)n(v)n(ert)f(frequency)h(from)g(geo)r(cen)n(tric)f(reference)g
+(frame)h(to)g(helio-)427 1378 y(cen)n(tric.)340 1510
+y Fh(\017)45 b Ft(")p Fi(HLF2GE)p Ft(")24 b Fi(\(EPOCH,RA,DEC\):)h(Con)
+n(v)n(ert)f(frequency)h(from)g(helio)r(cen)n(tric)g(reference)f(frame)h
+(to)g(geo-)427 1610 y(cen)n(tric.)340 1742 y Fh(\017)45
+b Ft(")p Fi(BYF2HL)p Ft(")30 b Fi(\(EPOCH,RA,DEC\):)g(Con)n(v)n(ert)f
+(frequency)h(from)g(barycen)n(tric)f(reference)h(frame)g(to)g(he-)427
+1842 y(lio)r(cen)n(tric.)340 1974 y Fh(\017)45 b Ft(")p
+Fi(HLF2BY)p Ft(")18 b Fi(\(EPOCH,RA,DEC\):)g(Con)n(v)n(ert)f(frequency)
+h(from)g(helio)r(cen)n(tric)g(reference)f(frame)h(to)g(barycen-)427
+2073 y(tric.)340 2206 y Fh(\017)45 b Ft(")p Fi(LKF2HL)p
Ft(")27 b Fi(\(RA,DEC\):)j(Con)n(v)n(ert)d(frequency)h(from)g
(kinematic)h(LSR)g(reference)e(frame)i(to)f(helio)r(cen-)427
-1765 y(tric.)340 1885 y Fh(\017)45 b Ft(")p Fi(HLF2LK)p
+2305 y(tric.)340 2437 y Fh(\017)45 b Ft(")p Fi(HLF2LK)p
Ft(")38 b Fi(\(RA,DEC\):)i(Con)n(v)n(ert)d(frequency)i(from)f(helio)r
(cen)n(tric)g(reference)g(frame)h(to)g(kinematic)427
-1985 y(LSR.)340 2104 y Fh(\017)45 b Ft(")p Fi(LDF2HL)p
+2537 y(LSR.)340 2669 y Fh(\017)45 b Ft(")p Fi(LDF2HL)p
Ft(")27 b Fi(\(RA,DEC\):)g(Con)n(v)n(ert)f(frequency)g(from)h
(dynamical)f(LSR)h(reference)f(frame)g(to)h(helio)r(cen-)427
-2204 y(tric.)340 2323 y Fh(\017)45 b Ft(")p Fi(HLF2LD)p
+2769 y(tric.)340 2901 y Fh(\017)45 b Ft(")p Fi(HLF2LD)p
Ft(")37 b Fi(\(RA,DEC\):)h(Con)n(v)n(ert)d(frequency)i(from)f(helio)r
(cen)n(tric)h(reference)f(frame)g(to)h(dynamical)427
-2423 y(LSR.)340 2542 y Fh(\017)45 b Ft(")p Fi(LGF2HL)p
+3001 y(LSR.)340 3133 y Fh(\017)45 b Ft(")p Fi(LGF2HL)p
Ft(")27 b Fi(\(RA,DEC\):)i(Con)n(v)n(ert)d(frequency)h(from)g(lo)r(cal)
g(group)g(reference)f(frame)i(to)f(helio)r(cen)n(tric.)340
-2662 y Fh(\017)45 b Ft(")p Fi(HLF2LG)p Ft(")27 b Fi(\(RA,DEC\):)i(Con)n
+3265 y Fh(\017)45 b Ft(")p Fi(HLF2LG)p Ft(")27 b Fi(\(RA,DEC\):)i(Con)n
(v)n(ert)d(frequency)h(from)g(helio)r(cen)n(tric)g(reference)g(frame)g
-(to)h(lo)r(cal)f(group.)340 2781 y Fh(\017)45 b Ft(")p
+(to)h(lo)r(cal)f(group.)340 3397 y Fh(\017)45 b Ft(")p
Fi(GLF2HL)p Ft(")27 b Fi(\(RA,DEC\):)i(Con)n(v)n(ert)d(frequency)h
(from)g(galactic)g(reference)f(frame)h(to)h(helio)r(cen)n(tric.)340
-2901 y Fh(\017)45 b Ft(")p Fi(HLF2GL)p Ft(")27 b Fi(\(RA,DEC\):)i(Con)n
+3529 y Fh(\017)45 b Ft(")p Fi(HLF2GL)p Ft(")27 b Fi(\(RA,DEC\):)i(Con)n
(v)n(ert)d(frequency)h(from)g(helio)r(cen)n(tric)g(reference)g(frame)g
-(to)h(galactic.)227 3049 y(The)g(units)g(for)f(the)h(v)-5
+(to)h(galactic.)227 3690 y(The)g(units)g(for)f(the)h(v)-5
b(alues)27 b(pro)r(cessed)g(b)n(y)g(the)h(ab)r(o)n(v)n(e)e(con)n(v)n
-(ersions)f(are)i(as)g(follo)n(ws:)340 3290 y Fh(\017)45
+(ersions)f(are)i(as)g(follo)n(ws:)340 3950 y Fh(\017)45
b Fi(all)28 b(v)n(elo)r(cities:)36 b(metres)27 b(p)r(er)h(second)e(\(p)
r(ositiv)n(e)i(if)g(the)g(source)e(receeds)h(from)g(the)h(observ)n
-(er\).)340 3410 y Fh(\017)45 b Fi(frequency:)37 b(Hertz.)340
-3529 y Fh(\017)45 b Fi(all)28 b(w)n(a)n(v)n(elengths:)35
-b(metres.)340 3649 y Fh(\017)45 b Fi(energy:)36 b(Joules.)340
-3768 y Fh(\017)45 b Fi(w)n(a)n(v)n(e)26 b(n)n(um)n(b)r(er:)37
-b(cycles)27 b(p)r(er)g(metre.)227 3917 y(The)h(argumen)n(ts)e(used)i
+(er\).)340 4082 y Fh(\017)45 b Fi(frequency:)37 b(Hertz.)340
+4215 y Fh(\017)45 b Fi(all)28 b(w)n(a)n(v)n(elengths:)35
+b(metres.)340 4347 y Fh(\017)45 b Fi(energy:)36 b(Joules.)340
+4479 y Fh(\017)45 b Fi(w)n(a)n(v)n(e)26 b(n)n(um)n(b)r(er:)37
+b(cycles)27 b(p)r(er)g(metre.)227 4640 y(The)h(argumen)n(ts)e(used)i
(in)g(the)g(ab)r(o)n(v)n(e)e(con)n(v)n(ersions)f(are)h(as)h(follo)n
-(ws:)340 4157 y Fh(\017)45 b Fi(RF:)28 b(Rest)g(frequency)f(\(Hz\).)340
-4277 y Fh(\017)45 b Fi(OBSAL)-7 b(T:)28 b(Geo)r(detic)g(altitude)g(of)f
-(observ)n(er)e(\(IA)n(U)k(1975,)c(metres\).)340 4396
+(ws:)340 4900 y Fh(\017)45 b Fi(RF:)28 b(Rest)g(frequency)f(\(Hz\).)340
+5032 y Fh(\017)45 b Fi(OBSAL)-7 b(T:)28 b(Geo)r(detic)g(altitude)g(of)f
+(observ)n(er)e(\(IA)n(U)k(1975,)c(metres\).)340 5164
y Fh(\017)45 b Fi(OBSLA)-7 b(T:)28 b(Geo)r(detic)g(latitude)g(of)f
-(observ)n(er)e(\(IA)n(U)k(1975,)c(radians\).)340 4516
+(observ)n(er)e(\(IA)n(U)k(1975,)c(radians\).)340 5297
y Fh(\017)45 b Fi(OBSLON:)27 b(Longitude)g(of)h(observ)n(er)d
(\(radians)i(-)g(p)r(ositiv)n(e)g(east)n(w)n(ards\).)340
-4635 y Fh(\017)45 b Fi(EPOCH:)27 b(Ep)r(o)r(c)n(h)g(of)h(observ)-5
+5429 y Fh(\017)45 b Fi(EPOCH:)27 b(Ep)r(o)r(c)n(h)g(of)h(observ)-5
b(ation)26 b(\(UT1)h(expressed)g(as)g(a)g(Mo)r(di\014ed)h(Julian)f
-(Date\).)340 4755 y Fh(\017)45 b Fi(RA:)28 b(Righ)n(t)g(Ascension)f(of)
-g(source)g(\(radians,)f(FK5)h(J2000\).)340 4874 y Fh(\017)45
+(Date\).)340 5561 y Fh(\017)45 b Fi(RA:)28 b(Righ)n(t)g(Ascension)f(of)
+g(source)g(\(radians,)f(FK5)h(J2000\).)340 5693 y Fh(\017)45
b Fi(DEC:)28 b(Declination)g(of)f(source)f(\(radians,)h(FK5)g(J2000\).)
-340 4994 y Fh(\017)45 b Fi(V)n(OFF:)32 b(V)-7 b(elo)r(cit)n(y)32
-b(of)g(the)g(user-de\014ned)g(reference)f(frame,)h(to)n(w)n(ards)e(the)
-j(p)r(osition)f(giv)n(en)f(b)n(y)g(RA)i(and)427 5093
-y(DEC,)28 b(measured)f(in)g(the)h(helio)r(cen)n(tric)f(reference)g
-(frame.)227 5242 y(If)35 b(the)f(Sp)r(ecMap)g(is)f(3-dimensional,)i
-(source)d(p)r(ositions)h(are)g(pro)n(vided)g(b)n(y)h(the)g(v)-5
-b(alues)33 b(supplied)h(to)g(inputs)227 5342 y(2)f(and)g(3)g(of)h(the)f
-(Sp)r(ecMap)h(\(whic)n(h)f(are)g(simply)g(copied)g(to)g(outputs)h(2)f
-(and)g(3\).)54 b(Note,)35 b(usable)e(v)-5 b(alues)33
-b(are)227 5441 y(still)26 b(required)f(for)g(the)h(RA)f(and)h(DEC)f
-(argumen)n(ts)f(in)i(order)e(to)i(de\014ne)g(the)f Ft(")p
-Fi(user-de\014ned)p Ft(")f Fi(reference)h(frame)227 5541
-y(used)35 b(b)n(y)g(USF2HL)g(and)g(HLF2US.)h(Ho)n(w)n(ev)n(er,)f(AST)p
-Ft(__)p Fi(BAD)g(can)g(b)r(e)g(supplied)h(for)e(RA)i(and)f(DEC)g(if)g
-(the)227 5640 y(user-de\014ned)27 b(reference)g(frame)g(is)h(not)f
-(required.)p eop end
-%%Page: 371 381
-TeXDict begin 371 380 bop 3643 52 a FF(371)p 0 351 3780
-12 v 0 483 a Fz(astSp)t(ecFluxF)-11 b(rame)176 b Fe(Create)37
-b(a)h(Sp)s(ecFluxF)-10 b(rame)176 b Fz(astSp)t(ecFluxF)-11
-b(rame)0 675 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f
-(a)g(new)g(Sp)r(ecFluxF)-7 b(rame)28 b(and)f(optionally)g(initialises)g
-(its)h(attributes.)227 801 y(A)g(Sp)r(ecFluxF)-7 b(rame)27
-b(com)n(bines)g(a)g(Sp)r(ecF)-7 b(rame)27 b(and)h(a)f(FluxF)-7
-b(rame)27 b(in)n(to)g(a)g(single)g(2-dimensional)f(comp)r(ound)227
-901 y(F)-7 b(rame.)39 b(Suc)n(h)28 b(a)g(F)-7 b(rame)28
-b(can)f(for)h(instance)g(b)r(e)h(used)f(to)g(describ)r(e)g(a)g(Plot)g
-(of)g(a)g(sp)r(ectrum)g(in)h(whic)n(h)f(the)h(\014rst)227
-1000 y(axis)e(represen)n(ts)f(sp)r(ectral)h(p)r(osition)h(and)f(the)h
-(second)f(axis)g(represen)n(ts)f(\015ux.)0 1153 y Fd(Synopsis:)121
-b Ft(AstSpecFluxFrame)37 b Fh(\003)p Ft(astSpecFluxFram)o(e\()g
-(AstSpecFrame)i Fh(\003)p Ft(frame1,)h(AstFluxFrame)e
-Fh(\003)p Ft(frame2,)227 1253 y(const)k(char)g Fh(\003)p
-Ft(options,)e(...)85 b(\))0 1405 y Fd(P)m(arameters:)259
-1545 y(frame1)427 1644 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Sp)r(ecF)-7
+p eop end
+%%Page: 372 382
+TeXDict begin 372 381 bop 0 52 a FF(372)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Fi(V)n(OFF:)32 b(V)-7 b(elo)r(cit)n(y)32 b(of)g(the)g(user-de\014ned)
+g(reference)f(frame,)h(to)n(w)n(ards)e(the)j(p)r(osition)f(giv)n(en)f
+(b)n(y)g(RA)i(and)427 451 y(DEC,)28 b(measured)f(in)g(the)h(helio)r
+(cen)n(tric)f(reference)g(frame.)227 606 y(If)35 b(the)f(Sp)r(ecMap)g
+(is)f(3-dimensional,)i(source)d(p)r(ositions)h(are)g(pro)n(vided)g(b)n
+(y)h(the)g(v)-5 b(alues)33 b(supplied)h(to)g(inputs)227
+706 y(2)f(and)g(3)g(of)h(the)f(Sp)r(ecMap)h(\(whic)n(h)f(are)g(simply)g
+(copied)g(to)g(outputs)h(2)f(and)g(3\).)54 b(Note,)35
+b(usable)e(v)-5 b(alues)33 b(are)227 805 y(still)26 b(required)f(for)g
+(the)h(RA)f(and)h(DEC)f(argumen)n(ts)f(in)i(order)e(to)i(de\014ne)g
+(the)f Ft(")p Fi(user-de\014ned)p Ft(")f Fi(reference)h(frame)227
+905 y(used)35 b(b)n(y)g(USF2HL)g(and)g(HLF2US.)h(Ho)n(w)n(ev)n(er,)f
+(AST)p Ft(__)p Fi(BAD)g(can)g(b)r(e)g(supplied)h(for)e(RA)i(and)f(DEC)g
+(if)g(the)227 1005 y(user-de\014ned)27 b(reference)g(frame)g(is)h(not)f
+(required.)p 0 1191 3780 12 v 0 1322 a Fz(astSp)t(ecFluxF)-11
+b(rame)176 b Fe(Create)37 b(a)h(Sp)s(ecFluxF)-10 b(rame)176
+b Fz(astSp)t(ecFluxF)-11 b(rame)0 1498 y Fd(Description:)44
+b Fi(This)28 b(function)g(creates)f(a)g(new)g(Sp)r(ecFluxF)-7
+b(rame)28 b(and)f(optionally)g(initialises)g(its)h(attributes.)227
+1619 y(A)g(Sp)r(ecFluxF)-7 b(rame)27 b(com)n(bines)g(a)g(Sp)r(ecF)-7
+b(rame)27 b(and)h(a)f(FluxF)-7 b(rame)27 b(in)n(to)g(a)g(single)g
+(2-dimensional)f(comp)r(ound)227 1719 y(F)-7 b(rame.)39
+b(Suc)n(h)28 b(a)g(F)-7 b(rame)28 b(can)f(for)h(instance)g(b)r(e)h
+(used)f(to)g(describ)r(e)g(a)g(Plot)g(of)g(a)g(sp)r(ectrum)g(in)h(whic)
+n(h)f(the)h(\014rst)227 1819 y(axis)e(represen)n(ts)f(sp)r(ectral)h(p)r
+(osition)h(and)f(the)h(second)f(axis)g(represen)n(ts)f(\015ux.)0
+1961 y Fd(Synopsis:)121 b Ft(AstSpecFluxFrame)37 b Fh(\003)p
+Ft(astSpecFluxFram)o(e\()g(AstSpecFrame)i Fh(\003)p Ft(frame1,)h
+(AstFluxFrame)e Fh(\003)p Ft(frame2,)227 2061 y(const)k(char)g
+Fh(\003)p Ft(options,)e(...)85 b(\))0 2204 y Fd(P)m(arameters:)259
+2334 y(frame1)427 2433 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Sp)r(ecF)-7
b(rame.)36 b(This)28 b(will)g(form)f(the)h(\014rst)f(axis)g(in)h(the)g
-(new)g(Sp)r(ecFluxF)-7 b(rame.)259 1779 y Fd(frame2)427
-1878 y Fi(P)n(oin)n(ter)30 b(to)h(the)g(FluxF)-7 b(rame.)47
+(new)g(Sp)r(ecFluxF)-7 b(rame.)259 2560 y Fd(frame2)427
+2659 y Fi(P)n(oin)n(ter)30 b(to)h(the)g(FluxF)-7 b(rame.)47
b(This)31 b(will)g(form)g(the)h(second)e(axis)g(in)i(the)f(new)g(Sp)r
-(ecFluxF)-7 b(rame.)48 b(The)427 1978 y Ft(")p Fi(Sp)r(ecV)-7
+(ecFluxF)-7 b(rame.)48 b(The)427 2759 y Ft(")p Fi(Sp)r(ecV)-7
b(al)p Ft(")30 b Fi(attribute)h(of)f(this)h(FluxF)-7
b(rame)30 b(is)g(not)h(used)f(b)n(y)g(the)h(Sp)r(ecFluxF)-7
-b(rame)31 b(class)e(and)i(so)e(ma)n(y)427 2078 y(b)r(e)f(set)g(to)f
+b(rame)31 b(class)e(and)i(so)e(ma)n(y)427 2859 y(b)r(e)f(set)g(to)f
(AST)p Ft(__)p Fi(BAD)h(when)g(the)g(FluxF)-7 b(rame)27
-b(is)h(created.)259 2212 y Fd(options)427 2312 y Fi(P)n(oin)n(ter)f(to)
+b(is)h(created.)259 2985 y Fd(options)427 3084 y Fi(P)n(oin)n(ter)f(to)
h(a)g(n)n(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 2411 y(assignmen)n(ts)f
+(comma-separated)e(list)i(of)g(attribute)427 3184 y(assignmen)n(ts)f
(to)g(b)r(e)h(used)g(for)f(initialising)h(the)g(new)g(Sp)r(ecFluxF)-7
b(rame.)37 b(The)28 b(syn)n(tax)f(used)g(is)h(iden)n(tical)427
-2511 y(to)h(that)h(for)f(the)g(astSet)g(function)h(and)f(ma)n(y)g
+3284 y(to)h(that)h(for)f(the)g(astSet)g(function)h(and)f(ma)n(y)g
(include)g Ft(")p Fi(prin)n(tf)p Ft(")g Fi(format)g(sp)r(eci\014ers)f
(iden)n(ti\014ed)i(b)n(y)f Ft(")p Fi(\045)p Ft(")427
-2611 y Fi(sym)n(b)r(ols)e(in)h(the)g(normal)f(w)n(a)n(y)-7
-b(.)259 2745 y Fd(...)427 2845 y Fi(If)38 b(the)g Ft(")p
+3383 y Fi(sym)n(b)r(ols)e(in)h(the)g(normal)f(w)n(a)n(y)-7
+b(.)259 3510 y Fd(...)427 3609 y Fi(If)38 b(the)g Ft(")p
Fi(options)p Ft(")e Fi(string)h(con)n(tains)f Ft(")p
Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g
-(list)h(of)f(additional)427 2944 y(argumen)n(ts)26 b(ma)n(y)h(follo)n
+(list)h(of)f(additional)427 3709 y(argumen)n(ts)26 b(ma)n(y)h(follo)n
(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5 b(alues)27
b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)37
-b(The)427 3044 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+b(The)427 3808 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 3143 y Fi(function\).)0
-3309 y Fd(Returned)32 b(V)-8 b(alue:)259 3448 y(astSp)s(ecFluxF)g
-(rame\(\))427 3548 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Sp)r
-(ecFluxF)-7 b(rame.)0 3713 y Fd(Notes:)340 3998 y Fh(\017)45
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 3908 y Fi(function\).)0
+4063 y Fd(Returned)32 b(V)-8 b(alue:)259 4193 y(astSp)s(ecFluxF)g
+(rame\(\))427 4293 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Sp)r
+(ecFluxF)-7 b(rame.)0 4448 y Fd(Notes:)340 4724 y Fh(\017)45
b Fi(The)25 b(supplied)g(F)-7 b(rame)24 b(p)r(oin)n(ters)g(are)g
(stored)f(directly)-7 b(,)26 b(rather)d(than)i(b)r(eing)g(used)f(to)h
-(create)f(deep)g(copies)427 4098 y(of)g(the)h(supplied)f(F)-7
+(create)f(deep)g(copies)427 4824 y(of)g(the)h(supplied)f(F)-7
b(rames.)35 b(This)24 b(means)g(that)g(an)n(y)f(subsequen)n(t)h(c)n
(hanges)e(made)i(to)g(the)g(F)-7 b(rames)24 b(via)f(the)427
-4198 y(supplied)28 b(p)r(oin)n(ters)f(will)h(result)f(in)h(equiv)-5
+4923 y(supplied)28 b(p)r(oin)n(ters)f(will)h(result)f(in)h(equiv)-5
b(alen)n(t)27 b(c)n(hanges)g(b)r(eing)g(visible)h(in)g(the)g(Sp)r
-(ecFluxF)-7 b(rame.)340 4332 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+(ecFluxF)-7 b(rame.)340 5050 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
-427 4432 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
-(fail)h(for)f(an)n(y)g(reason.)-2 4597 y Fd(Status)33
-b(Handling)n(:)227 4743 y Fi(The)d(protected)g(in)n(terface)f(to)g
+427 5149 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
+(fail)h(for)f(an)n(y)g(reason.)-2 5304 y Fd(Status)33
+b(Handling)n(:)227 5451 y Fi(The)d(protected)g(in)n(terface)f(to)g
(this)h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g
-(of)g(the)g(parameter)227 4843 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
+(of)g(the)g(parameter)227 5550 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n
(e.)62 b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n
(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
-Fi(in)n(t)227 4942 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p
-0 5145 V 0 5275 a Fz(astSp)t(ecF)-11 b(rame)562 b Fe(Create)37
+Fi(in)n(t)227 5650 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p
+eop end
+%%Page: 373 383
+TeXDict begin 373 382 bop 3643 52 a FF(373)p 0 351 3780
+12 v 0 482 a Fz(astSp)t(ecF)-11 b(rame)562 b Fe(Create)37
b(a)h(Sp)s(ecF)-10 b(rame)561 b Fz(astSp)t(ecF)-11 b(rame)0
-5467 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g
+652 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g
(Sp)r(ecF)-7 b(rame)28 b(and)f(optionally)g(initialises)g(its)h
-(attributes.)227 5593 y(A)j(Sp)r(ecF)-7 b(rame)29 b(is)h(a)g(sp)r
+(attributes.)227 772 y(A)j(Sp)r(ecF)-7 b(rame)29 b(is)h(a)g(sp)r
(ecialised)f(form)h(of)g(one-dimensional)e(F)-7 b(rame)30
b(whic)n(h)g(represen)n(ts)e(v)-5 b(arious)29 b(co)r(ordinate)227
-5693 y(systems)23 b(used)h(to)f(describ)r(e)g(p)r(ositions)g(within)h
+872 y(systems)23 b(used)h(to)f(describ)r(e)g(p)r(ositions)g(within)h
(an)f(electro-magnetic)f(sp)r(ectrum.)35 b(The)24 b(particular)e(co)r
-(ordinate)p eop end
-%%Page: 372 382
-TeXDict begin 372 381 bop 0 52 a FF(372)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)227 351 y Fi(system)i(to)g(b)r(e)g
-(used)g(is)g(sp)r(eci\014ed)g(b)n(y)f(setting)h(the)g(Sp)r(ecF)-7
-b(rame's)32 b(System)g(attribute)g(\(the)g(default)h(is)f(w)n(a)n(v)n
-(e-)227 451 y(length\))27 b(quali\014ed,)f(as)g(necessary)-7
+(ordinate)227 972 y(system)32 b(to)g(b)r(e)g(used)g(is)g(sp)r
+(eci\014ed)g(b)n(y)f(setting)h(the)g(Sp)r(ecF)-7 b(rame's)32
+b(System)g(attribute)g(\(the)g(default)h(is)f(w)n(a)n(v)n(e-)227
+1071 y(length\))27 b(quali\014ed,)f(as)g(necessary)-7
b(,)24 b(b)n(y)i(other)g(attributes)g(suc)n(h)g(as)f(the)i(rest)e
(frequency)-7 b(,)26 b(the)h(standard)e(of)h(rest,)227
-551 y(the)i(ep)r(o)r(c)n(h)g(of)f(observ)-5 b(ation,)27
+1171 y(the)i(ep)r(o)r(c)n(h)g(of)f(observ)-5 b(ation,)27
b(etc)g(\(see)h(the)g(description)f(of)g(the)h(System)g(attribute)g
-(for)f(details\).)227 684 y(By)d(setting)f(a)h(v)-5 b(alue)23
-b(for)h(thr)f(Sp)r(ecOrigin)h(attribute,)g(a)g(Sp)r(ecF)-7
+(for)f(details\).)227 1291 y(By)d(setting)f(a)h(v)-5
+b(alue)23 b(for)h(thr)f(Sp)r(ecOrigin)h(attribute,)g(a)g(Sp)r(ecF)-7
b(rame)23 b(can)h(b)r(e)g(made)f(to)h(represen)n(t)e(o\013sets)i(from)
-227 784 y(a)j(giv)n(en)g(sp)r(ectral)g(p)r(osition,)h(rather)e(than)i
-(absolute)0 952 y Fd(Synopsis:)121 b Ft(AstSpecFrame)38
+227 1390 y(a)j(giv)n(en)g(sp)r(ectral)g(p)r(osition,)h(rather)e(than)i
+(absolute)0 1531 y Fd(Synopsis:)121 b Ft(AstSpecFrame)38
b Fh(\003)p Ft(astSpecFrame\()g(const)k(char)g Fh(\003)p
-Ft(options,)d(...)86 b(\))0 1121 y Fd(P)m(arameters:)259
-1276 y(options)427 1375 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n
+Ft(options,)d(...)86 b(\))0 1671 y Fd(P)m(arameters:)259
+1798 y(options)427 1898 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n
(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 1475 y(assignmen)n(ts)19
+(comma-separated)e(list)i(of)g(attribute)427 1998 y(assignmen)n(ts)19
b(to)g(b)r(e)i(used)e(for)h(initialising)f(the)h(new)g(Sp)r(ecF)-7
b(rame.)34 b(The)20 b(syn)n(tax)f(used)g(is)h(iden)n(tical)g(to)f(that)
-427 1575 y(for)26 b(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
+427 2097 y(for)26 b(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n
(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-1674 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)35 b(If)28
+2197 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)35 b(If)28
b(no)g(initialisation)f(is)g(required,)g(a)g(zero-length)f(string)h(ma)
-n(y)g(b)r(e)h(supplied.)259 1817 y Fd(...)427 1916 y
+n(y)g(b)r(e)h(supplied.)259 2320 y Fd(...)427 2420 y
Fi(If)38 b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n(tains)f
Ft(")p Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f
-(optional)g(list)h(of)f(additional)427 2016 y(argumen)n(ts)26
+(optional)g(list)h(of)f(additional)427 2520 y(argumen)n(ts)26
b(ma)n(y)h(follo)n(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5
b(alues)27 b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)
-37 b(The)427 2115 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+37 b(The)427 2619 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 2215 y Fi(function\).)0
-2396 y Fd(Returned)32 b(V)-8 b(alue:)259 2551 y(astSp)s(ecF)g(rame\(\))
-427 2651 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Sp)r(ecF)-7
-b(rame.)0 2831 y Fd(Examples:)227 2988 y Fp(frame)47
-b(=)g(astSpecFrame\()d Ft("")j Fp(\);)427 3086 y Fi(Creates)36
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 2719 y Fi(function\).)0
+2872 y Fd(Returned)32 b(V)-8 b(alue:)259 2999 y(astSp)s(ecF)g(rame\(\))
+427 3099 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Sp)r(ecF)-7
+b(rame.)0 3251 y Fd(Examples:)227 3379 y Fp(frame)47
+b(=)g(astSpecFrame\()d Ft("")j Fp(\);)427 3478 y Fi(Creates)36
b(a)g(Sp)r(ecF)-7 b(rame)36 b(to)g(describ)r(e)g(the)h(default)g(w)n(a)
n(v)n(elength)d(sp)r(ectral)i(co)r(ordinate)g(system.)63
-b(The)427 3186 y(RestF)-7 b(req)39 b(attribute)g(\(rest)f(frequency\))h
+b(The)427 3578 y(RestF)-7 b(req)39 b(attribute)g(\(rest)f(frequency\))h
(is)g(unsp)r(eci\014ed,)j(so)c(it)i(will)f(not)g(b)r(e)g(p)r(ossible)f
-(to)h(align)f(this)427 3286 y(Sp)r(ecF)-7 b(rame)24 b(with)h(another)e
+(to)h(align)f(this)427 3677 y(Sp)r(ecF)-7 b(rame)24 b(with)h(another)e
(Sp)r(ecF)-7 b(rame)24 b(on)f(the)i(basis)e(of)h(a)g(v)n(elo)r(cit)n
-(y-based)e(system.)35 b(The)25 b(standard)e(of)427 3385
+(y-based)e(system.)35 b(The)25 b(standard)e(of)427 3777
y(rest)30 b(is)f(also)g(unsp)r(eci\014ed.)44 b(This)29
b(means)h(that)g(alignmen)n(t)f(will)h(b)r(e)g(p)r(ossible)g(with)g
-(other)f(Sp)r(ecF)-7 b(rames,)427 3485 y(but)31 b(no)g(correction)e
+(other)f(Sp)r(ecF)-7 b(rames,)427 3877 y(but)31 b(no)g(correction)e
(will)h(b)r(e)i(made)e(for)g(Doppler)g(shift)i(caused)e(b)n(y)g(c)n
-(hange)f(of)i(rest)f(frame)g(during)g(the)427 3584 y(alignmen)n(t.)227
-3715 y Fp(frame)47 b(=)g(astSpecFrame\()d Ft(")p Fp(System=VELO,)g
-(RestFreq=1.0E15,)g(StdOfRest=LSRK)p Ft(")227 3814 y
-Fp(\);)427 3897 y Fi(Creates)39 b(a)h(Sp)r(ecF)-7 b(rame)40
+(hange)f(of)i(rest)f(frame)g(during)g(the)427 3976 y(alignmen)n(t.)227
+4088 y Fp(frame)47 b(=)g(astSpecFrame\()d Ft(")p Fp(System=VELO,)g
+(RestFreq=1.0E15,)g(StdOfRest=LSRK)p Ft(")227 4187 y
+Fp(\);)427 4271 y Fi(Creates)39 b(a)h(Sp)r(ecF)-7 b(rame)40
b(describing)f(a)h(apparen)n(t)e(radial)h(v)n(elo)r(cit)n(y)h(\()p
Ft(")p Fi(VELO)p Ft(")p Fi(\))f(axis)g(with)h(rest)g(fre-)427
-3997 y(quency)35 b(1.0E15)e(Hz)i(\(ab)r(out)g(3000)f(Angstroms\),)i
+4370 y(quency)35 b(1.0E15)e(Hz)i(\(ab)r(out)g(3000)f(Angstroms\),)i
(measured)e(in)h(the)h(kinematic)f(Lo)r(cal)f(Standard)h(of)427
-4097 y(Rest)f(\()p Ft(")p Fi(LSRK)p Ft(")p Fi(\).)56
+4470 y(Rest)f(\()p Ft(")p Fi(LSRK)p Ft(")p Fi(\).)56
b(Since)34 b(the)g(source)f(p)r(osition)h(has)f(not)h(b)r(een)h(sp)r
-(eci\014ed)f(\(using)g(attributes)g(RefRA)427 4196 y(and)c(RefDec\),)i
+(eci\014ed)f(\(using)g(attributes)g(RefRA)427 4570 y(and)c(RefDec\),)i
(it)f(will)g(only)e(b)r(e)i(p)r(ossible)f(to)g(align)g(this)g(Sp)r(ecF)
-7 b(rame)30 b(with)h(other)f(Sp)r(ecF)-7 b(rames)30
-b(whic)n(h)427 4296 y(are)d(also)f(measured)h(in)h(the)g(LSRK)f
-(standard)g(of)g(rest.)0 4477 y Fd(Notes:)340 4778 y
+b(whic)n(h)427 4669 y(are)d(also)f(measured)h(in)h(the)g(LSRK)f
+(standard)g(of)g(rest.)0 4822 y Fd(Notes:)340 5095 y
Fh(\017)45 b Fi(When)34 b(con)n(v)n(ersion)d(b)r(et)n(w)n(een)h(t)n(w)n
(o)h(Sp)r(ecF)-7 b(rames)32 b(is)h(requested)g(\(as)f(when)h(supplying)
-g(Sp)r(ecF)-7 b(rames)33 b(to)427 4878 y(astCon)n(v)n(ert\),)40
+g(Sp)r(ecF)-7 b(rames)33 b(to)427 5195 y(astCon)n(v)n(ert\),)40
b(accoun)n(t)e(will)h(b)r(e)g(tak)n(en)f(of)g(the)h(nature)f(of)h(the)g
-(sp)r(ectral)f(co)r(ordinate)f(systems)h(they)427 4977
+(sp)r(ectral)f(co)r(ordinate)f(systems)h(they)427 5295
y(represen)n(t,)e(together)e(with)h(an)n(y)f(qualifying)h(rest)f
(frequency)-7 b(,)36 b(standard)e(of)h(rest,)h(ep)r(o)r(c)n(h)f(v)-5
-b(alues,)36 b(etc.)427 5077 y(The)26 b(AlignSystem)f(and)g
+b(alues,)36 b(etc.)427 5394 y(The)26 b(AlignSystem)f(and)g
(AlignStdOfRest)h(attributes)f(will)h(also)e(b)r(e)i(tak)n(en)e(in)n
-(to)i(accoun)n(t.)35 b(The)25 b(results)427 5177 y(will)34
+(to)i(accoun)n(t.)35 b(The)25 b(results)427 5494 y(will)34
b(therefore)f(fully)h(re\015ect)g(the)g(relationship)e(b)r(et)n(w)n
(een)i(p)r(ositions)f(measured)g(in)h(the)g(t)n(w)n(o)f(systems.)427
-5276 y(In)e(addition,)g(an)n(y)f(di\013erence)h(in)g(the)g(Unit)g
+5593 y(In)e(addition,)g(an)n(y)f(di\013erence)h(in)g(the)g(Unit)g
(attributes)g(of)f(the)h(t)n(w)n(o)f(systems)g(will)h(also)f(b)r(e)h
-(tak)n(en)f(in)n(to)427 5376 y(accoun)n(t.)340 5518 y
-Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g
-(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g
-(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 5618
-y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f
-(an)n(y)g(reason.)p eop end
-%%Page: 373 383
-TeXDict begin 373 382 bop 3643 52 a FF(373)p 0 351 3780
-12 v 0 482 a Fz(astSp)t(ecMap)705 b Fe(Create)37 b(a)i(Sp)s(ecMap)706
-b Fz(astSp)t(ecMap)0 673 y Fd(Description:)44 b Fi(This)28
-b(function)g(creates)f(a)g(new)g(Sp)r(ecMap)h(and)g(optionally)e
-(initialises)i(its)f(attributes.)227 798 y(An)e(Sp)r(ecMap)e(is)h(a)f
-(sp)r(ecialised)h(form)f(of)h(Mapping)f(whic)n(h)h(can)f(b)r(e)h(used)g
-(to)g(represen)n(t)e(a)i(sequence)f(of)h(con)n(v)n(er-)227
-898 y(sions)i(b)r(et)n(w)n(een)h(standard)e(sp)r(ectral)h(co)r
-(ordinate)f(systems.)36 b(This)27 b(includes)g(con)n(v)n(ersions)c(b)r
-(et)n(w)n(een)k(frequency)-7 b(,)227 998 y(w)n(a)n(v)n(elength,)36
-b(and)f(v)-5 b(arious)34 b(forms)h(of)g(v)n(elo)r(cit)n(y)-7
-b(,)37 b(as)d(w)n(ell)h(as)g(con)n(v)n(ersions)e(b)r(et)n(w)n(een)i
-(di\013eren)n(t)h(standards)e(of)227 1097 y(rest.)227
-1223 y(When)25 b(a)g(Sp)r(ecMap)f(is)h(\014rst)f(created,)h(it)g
-(simply)g(p)r(erforms)e(a)i(unit)g(\(n)n(ull\))g(Mapping.)36
-b(Using)24 b(the)h(astSp)r(ecAdd)227 1322 y(function,)44
-b(a)c(series)f(of)h(co)r(ordinate)e(con)n(v)n(ersion)g(steps)i(ma)n(y)f
-(then)i(b)r(e)f(added,)j(selected)d(from)g(the)g(list)h(of)227
-1422 y(supp)r(orted)25 b(con)n(v)n(ersions.)33 b(This)25
-b(allo)n(ws)f(m)n(ulti-step)h(con)n(v)n(ersions)d(b)r(et)n(w)n(een)j(a)
-g(v)-5 b(ariet)n(y)24 b(of)g(sp)r(ectral)h(co)r(ordinate)227
-1522 y(systems)i(to)h(b)r(e)g(assem)n(bled)f(out)g(of)h(the)g(building)
+(tak)n(en)f(in)n(to)427 5693 y(accoun)n(t.)p eop end
+%%Page: 374 384
+TeXDict begin 374 383 bop 0 52 a FF(374)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
+Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 451 y(AST)28
+b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
+(reason.)p 0 649 3780 12 v 0 779 a Fz(astSp)t(ecMap)705
+b Fe(Create)37 b(a)i(Sp)s(ecMap)706 b Fz(astSp)t(ecMap)0
+966 y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g
+(Sp)r(ecMap)h(and)g(optionally)e(initialises)i(its)f(attributes.)227
+1091 y(An)e(Sp)r(ecMap)e(is)h(a)f(sp)r(ecialised)h(form)f(of)h(Mapping)
+f(whic)n(h)h(can)f(b)r(e)h(used)g(to)g(represen)n(t)e(a)i(sequence)f
+(of)h(con)n(v)n(er-)227 1190 y(sions)i(b)r(et)n(w)n(een)h(standard)e
+(sp)r(ectral)h(co)r(ordinate)f(systems.)36 b(This)27
+b(includes)g(con)n(v)n(ersions)c(b)r(et)n(w)n(een)k(frequency)-7
+b(,)227 1290 y(w)n(a)n(v)n(elength,)36 b(and)f(v)-5 b(arious)34
+b(forms)h(of)g(v)n(elo)r(cit)n(y)-7 b(,)37 b(as)d(w)n(ell)h(as)g(con)n
+(v)n(ersions)e(b)r(et)n(w)n(een)i(di\013eren)n(t)h(standards)e(of)227
+1389 y(rest.)227 1514 y(When)25 b(a)g(Sp)r(ecMap)f(is)h(\014rst)f
+(created,)h(it)g(simply)g(p)r(erforms)e(a)i(unit)g(\(n)n(ull\))g
+(Mapping.)36 b(Using)24 b(the)h(astSp)r(ecAdd)227 1613
+y(function,)44 b(a)c(series)f(of)h(co)r(ordinate)e(con)n(v)n(ersion)g
+(steps)i(ma)n(y)f(then)i(b)r(e)f(added,)j(selected)d(from)g(the)g(list)
+h(of)227 1713 y(supp)r(orted)25 b(con)n(v)n(ersions.)33
+b(This)25 b(allo)n(ws)f(m)n(ulti-step)h(con)n(v)n(ersions)d(b)r(et)n(w)
+n(een)j(a)g(v)-5 b(ariet)n(y)24 b(of)g(sp)r(ectral)h(co)r(ordinate)227
+1812 y(systems)i(to)h(b)r(e)g(assem)n(bled)f(out)g(of)h(the)g(building)
g(blo)r(c)n(ks)e(pro)n(vided)h(b)n(y)g(this)h(class.)227
-1647 y(F)-7 b(or)22 b(details)g(of)h(the)f(individual)h(co)r(ordinate)e
+1937 y(F)-7 b(or)22 b(details)g(of)h(the)f(individual)h(co)r(ordinate)e
(con)n(v)n(ersions)f(a)n(v)-5 b(ailable,)22 b(see)g(the)h(description)f
-(of)g(the)h(astSp)r(ecAdd)227 1747 y(function.)227 1872
+(of)g(the)h(astSp)r(ecAdd)227 2036 y(function.)227 2160
y(Con)n(v)n(ersions)k(are)g(a)n(v)-5 b(ailable)28 b(to)h(transform)e(b)
r(et)n(w)n(een)i(standards)f(of)h(rest.)40 b(Suc)n(h)29
-b(con)n(v)n(ersions)d(need)j(to)f(kno)n(w)227 1972 y(the)23
+b(con)n(v)n(ersions)d(need)j(to)f(kno)n(w)227 2260 y(the)23
b(source)e(p)r(osition)i(as)e(an)i(RA)f(and)h(DEC.)f(This)h
(information)e(can)i(b)r(e)f(supplied)h(in)g(the)g(form)f(of)g
-(parameters)227 2072 y(for)27 b(the)g(relev)-5 b(an)n(t)26
+(parameters)227 2360 y(for)27 b(the)g(relev)-5 b(an)n(t)26
b(con)n(v)n(ersions,)e(in)j(whic)n(h)g(case)f(the)h(Sp)r(ecMap)g(is)f
-(1-dimensional,)g(simply)h(transforming)e(the)227 2171
+(1-dimensional,)g(simply)h(transforming)e(the)227 2459
y(sp)r(ectral)c(axis)g(v)-5 b(alues.)35 b(This)21 b(means)g(that)h(the)
g(same)f(source)g(p)r(osition)g(will)h(alw)n(a)n(ys)e(b)r(e)i(used)f(b)
-n(y)g(the)h(Sp)r(ecMap.)227 2271 y(Ho)n(w)n(ev)n(er,)32
+n(y)g(the)h(Sp)r(ecMap.)227 2559 y(Ho)n(w)n(ev)n(er,)32
b(this)h(ma)n(y)f(not)g(b)r(e)h(appropriate)e(for)h(an)h(accurate)e
(description)h(of)g(a)h(3-D)f(sp)r(ectral)g(cub)r(e,)i(where)227
-2370 y(c)n(hanges)c(of)h(spatial)g(p)r(osition)g(can)g(pro)r(duce)f
+2658 y(c)n(hanges)c(of)h(spatial)g(p)r(osition)g(can)g(pro)r(duce)f
(signi\014can)n(t)h(c)n(hanges)f(in)h(the)h(Doppler)f(shift)g(in)n(tro)
-r(duced)g(when)227 2470 y(transforming)19 b(b)r(et)n(w)n(een)h
+r(duced)g(when)227 2758 y(transforming)19 b(b)r(et)n(w)n(een)h
(standards)e(of)i(rest.)34 b(F)-7 b(or)20 b(this)g(situation,)h(a)f
(3-dimensional)e(Sp)r(ecMap)i(can)g(b)r(e)g(created)227
-2570 y(in)30 b(whic)n(h)g(axes)e(2)h(and)h(3)f(corresp)r(ond)f(to)h
+2858 y(in)30 b(whic)n(h)g(axes)e(2)h(and)h(3)f(corresp)r(ond)f(to)h
(the)h(source)e(RA)i(and)g(DEC)f(The)h(Sp)r(ecMap)g(simply)f(copies)g
-(v)-5 b(alues)227 2669 y(for)27 b(axes)g(2)g(and)h(3)f(from)g(input)h
-(to)g(output\).)0 2821 y Fd(Synopsis:)121 b Ft(AstSpecMap)39
+(v)-5 b(alues)227 2957 y(for)27 b(axes)g(2)g(and)h(3)f(from)g(input)h
+(to)g(output\).)0 3106 y Fd(Synopsis:)121 b Ft(AstSpecMap)39
b Fh(\003)p Ft(astSpecMap\()g(int)j(nin,)g(int)g(flags,)g(const)f(char)
-h Fh(\003)p Ft(options,)e(...)86 b(\))0 2972 y Fd(P)m(arameters:)259
-3111 y(nin)427 3210 y Fi(The)22 b(n)n(um)n(b)r(er)g(of)g(inputs)h(to)f
+h Fh(\003)p Ft(options,)e(...)86 b(\))0 3255 y Fd(P)m(arameters:)259
+3390 y(nin)427 3490 y Fi(The)22 b(n)n(um)n(b)r(er)g(of)g(inputs)h(to)f
(the)g(Mapping)g(\(this)h(will)f(also)f(equal)h(the)g(n)n(um)n(b)r(er)g
-(of)g(outputs\).)36 b(This)22 b(v)-5 b(alue)427 3310
+(of)g(outputs\).)36 b(This)22 b(v)-5 b(alue)427 3589
y(m)n(ust)33 b(b)r(e)g(either)f(1)g(or)g(3.)51 b(In)33
b(either)f(case,)h(the)g(\014rst)f(input)h(and)g(output)g(corresp)r
-(oindis)d(the)j(sp)r(ectral)427 3410 y(axis.)45 b(F)-7
+(oindis)d(the)j(sp)r(ectral)427 3689 y(axis.)45 b(F)-7
b(or)30 b(a)g(3-axis)f(Sp)r(ecMap,)j(the)f(second)f(and)g(third)h(axes)
f(giv)n(e)f(the)i(RA)g(and)g(DEC)f(\(J2000)f(FK5\))427
-3509 y(of)k(the)g(source.)51 b(This)32 b(p)r(ositional)g(information)g
+3789 y(of)k(the)g(source.)51 b(This)32 b(p)r(ositional)g(information)g
(is)h(used)f(b)n(y)h(con)n(v)n(ersions)d(whic)n(h)i(transform)g(b)r(et)
-n(w)n(een)427 3609 y(standards)19 b(of)i(rest,)g(and)f(replaces)f(the)i
+n(w)n(een)427 3888 y(standards)19 b(of)i(rest,)g(and)f(replaces)f(the)i
Ft(")p Fi(RA)p Ft(")f Fi(and)g Ft(")p Fi(DEC)p Ft(")f
Fi(argumen)n(ts)g(for)h(the)h(individual)f(con)n(v)n(ersions)427
-3708 y(listed)28 b(in)g(description)f(of)h(the)g Ft(")p
-Fi(Sp)r(ecAdd)p Ft(")f Fi(function.)259 3842 y Fd(\015ags)427
-3942 y Fi(This)h(parameter)e(is)h(reserv)n(ed)f(for)h(future)h(use)g
+3988 y(listed)28 b(in)g(description)f(of)h(the)g Ft(")p
+Fi(Sp)r(ecAdd)p Ft(")f Fi(function.)259 4120 y Fd(\015ags)427
+4220 y Fi(This)h(parameter)e(is)h(reserv)n(ed)f(for)h(future)h(use)g
(and)f(should)h(curren)n(tly)e(alw)n(a)n(ys)g(b)r(e)i(set)f(to)h(zero.)
-259 4076 y Fd(options)427 4175 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n
+259 4352 y Fd(options)427 4451 y Fi(P)n(oin)n(ter)f(to)h(a)g(n)n
(ull-terminated)g(string)f(con)n(taining)g(an)h(optional)g
-(comma-separated)e(list)i(of)g(attribute)427 4275 y(assignmen)n(ts)23
+(comma-separated)e(list)i(of)g(attribute)427 4551 y(assignmen)n(ts)23
b(to)h(b)r(e)h(used)f(for)g(initialising)g(the)g(new)h(Sp)r(ecMap.)35
b(The)25 b(syn)n(tax)e(used)h(is)g(iden)n(tical)g(to)g(that)427
-4375 y(for)i(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
+4650 y(for)i(the)h(astSet)g(function)g(and)g(ma)n(y)f(include)h
Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n
(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-4474 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)35 b(If)28
+4750 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)35 b(If)28
b(no)g(initialisation)f(is)g(required,)g(a)g(zero-length)f(string)h(ma)
-n(y)g(b)r(e)h(supplied.)259 4608 y Fd(...)427 4708 y
+n(y)g(b)r(e)h(supplied.)259 4882 y Fd(...)427 4982 y
Fi(If)38 b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n(tains)f
Ft(")p Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f
-(optional)g(list)h(of)f(additional)427 4807 y(argumen)n(ts)26
+(optional)g(list)h(of)f(additional)427 5081 y(argumen)n(ts)26
b(ma)n(y)h(follo)n(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5
b(alues)27 b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)
-37 b(The)427 4907 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+37 b(The)427 5181 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 5007 y Fi(function\).)0
-5170 y Fd(Returned)32 b(V)-8 b(alue:)259 5309 y(astSp)s(ecMap\(\))427
-5408 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Sp)r(ecMap.)0
-5572 y Fd(Notes:)p eop end
-%%Page: 374 384
-TeXDict begin 374 383 bop 0 52 a FF(374)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
-b Fi(The)32 b(nature)e(and)i(units)f(of)g(the)h(co)r(ordinate)e(v)-5
-b(alues)31 b(supplied)h(for)e(the)i(\014rst)f(input)h(\(i.e.)49
-b(the)31 b(sp)r(ectral)427 451 y(input\))23 b(of)e(a)g(Sp)r(ecMap)h(m)n
-(ust)g(b)r(e)g(appropriate)d(to)j(the)g(\014rst)f(con)n(v)n(ersion)e
-(step)j(applied)f(b)n(y)g(the)h(Sp)r(ecMap.)427 551 y(F)-7
-b(or)19 b(instance,)j(if)e(the)g(\014rst)f(con)n(v)n(ersion)f(step)i
-(is)f Ft(")p Fi(FR)-7 b(TO)n(VL)p Ft(")19 b Fi(\(frequency)h(to)f
-(relativistic)g(v)n(elo)r(cit)n(y\),)i(then)427 650 y(the)34
-b(co)r(ordinate)e(v)-5 b(alues)32 b(for)h(the)h(\014rst)e(input)i
-(should)f(b)r(e)h(frequency)e(in)i(units)f(of)g(Hz.)54
-b(Similarly)-7 b(,)34 b(the)427 750 y(nature)k(and)h(units)g(of)f(the)h
-(co)r(ordinate)f(v)-5 b(alues)38 b(returned)g(b)n(y)g(a)h(Sp)r(ecMap)f
-(will)h(b)r(e)g(determined)g(b)n(y)427 849 y(the)c(last)f(con)n(v)n
-(ersion)e(step)i(applied)g(b)n(y)g(the)h(Sp)r(ecMap.)56
-b(F)-7 b(or)34 b(instance,)h(if)g(the)g(last)f(con)n(v)n(ersion)d(step)
-427 949 y(is)k Ft(")p Fi(VL)-7 b(TO)n(V)n(O)p Ft(")33
-b Fi(\(relativistic)h(v)n(elo)r(cit)n(y)g(to)g(optical)g(v)n(elo)r(cit)
-n(y\),)i(then)f(the)g(co)r(ordinate)f(v)-5 b(alues)34
-b(for)g(the)427 1049 y(\014rst)29 b(output)g(will)g(b)r(e)g(optical)g
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 5281 y Fi(function\).)0
+5442 y Fd(Returned)32 b(V)-8 b(alue:)259 5577 y(astSp)s(ecMap\(\))427
+5677 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Sp)r(ecMap.)p
+eop end
+%%Page: 375 385
+TeXDict begin 375 384 bop 3643 52 a FF(375)0 351 y Fd(Notes:)340
+632 y Fh(\017)45 b Fi(The)32 b(nature)e(and)i(units)f(of)g(the)h(co)r
+(ordinate)e(v)-5 b(alues)31 b(supplied)h(for)e(the)i(\014rst)f(input)h
+(\(i.e.)49 b(the)31 b(sp)r(ectral)427 731 y(input\))23
+b(of)e(a)g(Sp)r(ecMap)h(m)n(ust)g(b)r(e)g(appropriate)d(to)j(the)g
+(\014rst)f(con)n(v)n(ersion)e(step)j(applied)f(b)n(y)g(the)h(Sp)r
+(ecMap.)427 831 y(F)-7 b(or)19 b(instance,)j(if)e(the)g(\014rst)f(con)n
+(v)n(ersion)f(step)i(is)f Ft(")p Fi(FR)-7 b(TO)n(VL)p
+Ft(")19 b Fi(\(frequency)h(to)f(relativistic)g(v)n(elo)r(cit)n(y\),)i
+(then)427 931 y(the)34 b(co)r(ordinate)e(v)-5 b(alues)32
+b(for)h(the)h(\014rst)e(input)i(should)f(b)r(e)h(frequency)e(in)i
+(units)f(of)g(Hz.)54 b(Similarly)-7 b(,)34 b(the)427
+1030 y(nature)k(and)h(units)g(of)f(the)h(co)r(ordinate)f(v)-5
+b(alues)38 b(returned)g(b)n(y)g(a)h(Sp)r(ecMap)f(will)h(b)r(e)g
+(determined)g(b)n(y)427 1130 y(the)c(last)f(con)n(v)n(ersion)e(step)i
+(applied)g(b)n(y)g(the)h(Sp)r(ecMap.)56 b(F)-7 b(or)34
+b(instance,)h(if)g(the)g(last)f(con)n(v)n(ersion)d(step)427
+1230 y(is)k Ft(")p Fi(VL)-7 b(TO)n(V)n(O)p Ft(")33 b
+Fi(\(relativistic)h(v)n(elo)r(cit)n(y)g(to)g(optical)g(v)n(elo)r(cit)n
+(y\),)i(then)f(the)g(co)r(ordinate)f(v)-5 b(alues)34
+b(for)g(the)427 1329 y(\014rst)29 b(output)g(will)g(b)r(e)g(optical)g
(v)n(elo)r(cit)n(y)e(in)j(units)f(of)f(metres)h(p)r(er)g(second.)39
-b(See)29 b(the)g(description)f(of)h(the)427 1148 y(astSp)r(ecAdd)f
+b(See)29 b(the)g(description)f(of)h(the)427 1429 y(astSp)r(ecAdd)f
(function)h(for)e(the)h(units)g(exp)r(ected)g(and)f(returned)g(b)n(y)g
-(eac)n(h)g(con)n(v)n(ersion.)340 1291 y Fh(\017)45 b
+(eac)n(h)g(con)n(v)n(ersion.)340 1560 y Fh(\017)45 b
Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
-(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 1391 y(AST)28
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 1659 y(AST)28
b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
-(reason.)p 0 1611 3780 12 v 0 1743 a Fz(astSphMap)776
-b Fe(Create)38 b(a)g(SphMap)777 b Fz(astSphMap)0 1952
+(reason.)p 0 1855 3780 12 v 0 1986 a Fz(astSphMap)776
+b Fe(Create)38 b(a)g(SphMap)777 b Fz(astSphMap)0 2171
y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g
(SphMap)h(and)g(optionally)e(initialises)i(its)f(attributes.)227
-2087 y(A)21 b(SphMap)g(is)f(a)g(Mapping)h(whic)n(h)f(transforms)f(p)r
+2295 y(A)21 b(SphMap)g(is)f(a)g(Mapping)h(whic)n(h)f(transforms)f(p)r
(oin)n(ts)i(from)f(a)g(3-dimensional)f(Cartesian)g(co)r(ordinate)h
-(system)227 2187 y(in)n(to)28 b(a)g(2-dimensional)f(spherical)g(co)r
+(system)227 2395 y(in)n(to)28 b(a)g(2-dimensional)f(spherical)g(co)r
(ordinate)g(system)h(\(longitude)g(and)g(latitude)g(on)g(a)g(unit)h
-(sphere)e(cen)n(tred)227 2286 y(at)33 b(the)f(origin\).)51
+(sphere)e(cen)n(tred)227 2494 y(at)33 b(the)f(origin\).)51
b(It)33 b(w)n(orks)d(b)n(y)j(regarding)d(the)j(input)g(co)r(ordinates)e
(as)h(p)r(osition)g(v)n(ectors)f(and)h(\014nding)h(their)227
-2386 y(in)n(tersection)25 b(with)h(the)h(sphere)e(surface.)35
+2594 y(in)n(tersection)25 b(with)h(the)h(sphere)e(surface.)35
b(The)26 b(in)n(v)n(erse)e(transformation)g(alw)n(a)n(ys)g(pro)r(duces)
-h(p)r(oin)n(ts)h(whic)n(h)g(are)227 2486 y(a)h(unit)i(distance)e(from)g
+h(p)r(oin)n(ts)h(whic)n(h)g(are)227 2694 y(a)h(unit)i(distance)e(from)g
(the)h(origin)f(\(i.e.)37 b(unit)28 b(v)n(ectors\).)0
-2656 y Fd(Synopsis:)121 b Ft(AstSphMap)40 b Fh(\003)p
+2841 y Fd(Synopsis:)121 b Ft(AstSphMap)40 b Fh(\003)p
Ft(astSphMap\()f(const)i(char)h Fh(\003)p Ft(options,)e(...)86
-b(\))0 2826 y Fd(P)m(arameters:)259 2983 y(options)427
-3083 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n(ull-terminated)g(string)f
+b(\))0 2989 y Fd(P)m(arameters:)259 3123 y(options)427
+3223 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n(ull-terminated)g(string)f
(con)n(taining)g(an)h(optional)g(comma-separated)e(list)i(of)g
-(attribute)427 3183 y(assignmen)n(ts)d(to)h(b)r(e)h(used)f(for)g
+(attribute)427 3322 y(assignmen)n(ts)d(to)h(b)r(e)h(used)f(for)g
(initialising)g(the)h(new)f(SphMap.)37 b(The)26 b(syn)n(tax)g(used)g
-(is)g(iden)n(tical)g(to)g(that)427 3282 y(for)g(the)h(astSet)g
+(is)g(iden)n(tical)g(to)g(that)427 3422 y(for)g(the)h(astSet)g
(function)g(and)g(ma)n(y)f(include)h Ft(")p Fi(prin)n(tf)p
Ft(")f Fi(format)g(sp)r(eci\014ers)g(iden)n(ti\014ed)h(b)n(y)f
-Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427 3382 y(in)i(the)g(normal)f
-(w)n(a)n(y)-7 b(.)259 3525 y Fd(...)427 3625 y Fi(If)38
+Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427 3522 y(in)i(the)g(normal)f
+(w)n(a)n(y)-7 b(.)259 3652 y Fd(...)427 3752 y Fi(If)38
b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n(tains)f
Ft(")p Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f
-(optional)g(list)h(of)f(additional)427 3724 y(argumen)n(ts)26
+(optional)g(list)h(of)f(additional)427 3852 y(argumen)n(ts)26
b(ma)n(y)h(follo)n(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5
b(alues)27 b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)
-37 b(The)427 3824 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+37 b(The)427 3951 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
-(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 3923 y Fi(function\).)0
-4106 y Fd(Returned)32 b(V)-8 b(alue:)259 4263 y(astSphMap\(\))427
-4363 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(SphMap.)0
-4546 y Fd(Notes:)340 4849 y Fh(\017)45 b Fi(The)39 b(spherical)f(co)r
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 4051 y Fi(function\).)0
+4211 y Fd(Returned)32 b(V)-8 b(alue:)259 4345 y(astSphMap\(\))427
+4445 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(SphMap.)0
+4605 y Fd(Notes:)340 4886 y Fh(\017)45 b Fi(The)39 b(spherical)f(co)r
(ordinates)f(are)h(longitude)g(\(p)r(ositiv)n(e)h(an)n(ti-clo)r(c)n
(kwise)e(lo)r(oking)h(from)g(the)h(p)r(ositiv)n(e)427
-4948 y(latitude)24 b(p)r(ole\))f(and)g(latitude.)36 b(The)23
+4985 y(latitude)24 b(p)r(ole\))f(and)g(latitude.)36 b(The)23
b(Cartesian)f(co)r(ordinates)g(are)g(righ)n(t-handed,)h(with)g(the)h(x)
-f(axis)f(\(axis)427 5048 y(1\))28 b(at)f(zero)g(longitude)g(and)h
+f(axis)f(\(axis)427 5085 y(1\))28 b(at)f(zero)g(longitude)g(and)h
(latitude,)g(and)f(the)h(z)g(axis)e(\(axis)i(3\))f(at)g(the)h(p)r
-(ositiv)n(e)g(latitude)g(p)r(ole.)340 5191 y Fh(\017)45
+(ositiv)n(e)g(latitude)g(p)r(ole.)340 5216 y Fh(\017)45
b Fi(A)n(t)28 b(either)g(p)r(ole,)f(the)h(longitude)g(is)f(set)h(to)f
(the)h(v)-5 b(alue)28 b(of)f(the)h(P)n(olarLong)d(attribute.)340
-5334 y Fh(\017)45 b Fi(If)28 b(the)f(Cartesian)f(co)r(ordinates)g(are)g
+5347 y Fh(\017)45 b Fi(If)28 b(the)f(Cartesian)f(co)r(ordinates)g(are)g
(all)h(zero,)f(then)h(the)h(longitude)f(and)g(latitude)g(are)f(set)h
-(to)g(the)h(v)-5 b(alue)427 5434 y(AST)p Ft(__)p Fi(BAD.)340
+(to)g(the)h(v)-5 b(alue)427 5446 y(AST)p Ft(__)p Fi(BAD.)340
5577 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g
(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427
5677 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
(for)f(an)n(y)g(reason.)p eop end
-%%Page: 375 385
-TeXDict begin 375 384 bop 3643 52 a FF(375)-2 351 y Fd(Status)33
-b(Handling)n(:)227 497 y Fi(The)d(protected)g(in)n(terface)f(to)g(this)
-h(function)h(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g
-(the)g(parameter)227 597 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62
+%%Page: 376 386
+TeXDict begin 376 385 bop 0 52 a FF(376)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)-2 351 y Fd(Status)j(Handling)n(:)
+227 497 y Fi(The)d(protected)g(in)n(terface)f(to)g(this)h(function)h
+(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g(the)g
+(parameter)227 597 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62
b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)
e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fi(in)n(t)227
697 y Fh(\003)p Fi(status)p Ft(")p Fi(.)-2 845 y Fd(Status)33
@@ -126232,11 +126342,10 @@ Ft(astStcCatalogE)o(ntr)o(yL)o(oca)o(ti)o(on)o(\()h(AstRegion)h
Fh(\003)p Ft(region,)i(int)227 5570 y(ncoords,)g(AstKeyMap)e
Fh(\003)p Ft(coords[],)h(const)h(char)h Fh(\003)p Ft(options,)e(...)86
b(\))0 5718 y Fd(P)m(arameters:)p eop end
-%%Page: 376 386
-TeXDict begin 376 385 bop 0 52 a FF(376)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(region)427
-451 y Fi(P)n(oin)n(ter)c(to)i(the)g(encapsulated)f(Region.)259
-582 y Fd(nco)s(ords)427 681 y Fi(The)h(length)g(of)f(the)h
+%%Page: 377 387
+TeXDict begin 377 386 bop 3643 52 a FF(377)259 351 y
+Fd(region)427 451 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(encapsulated)f
+(Region.)259 582 y Fd(nco)s(ords)427 681 y Fi(The)h(length)g(of)f(the)h
Ft(")p Fi(co)r(ords)p Ft(")e Fi(arra)n(y)-7 b(.)34 b(Supply)28
b(zero)f(if)h Ft(")p Fi(co)r(ords)p Ft(")d Fi(is)j(NULL.)259
812 y Fd(co)s(ords)427 912 y Fi(P)n(oin)n(ter)k(to)h(an)g(arra)n(y)d
@@ -126312,14 +126421,15 @@ Fh(\003)p Ft(coords[],)g(const)h(char)h Fh(\003)p Ft(options,)e(...)86
b(\))0 5459 y Fd(P)m(arameters:)259 5593 y(region)427
5693 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(encapsulated)f(Region.)p
eop end
-%%Page: 377 387
-TeXDict begin 377 386 bop 3643 52 a FF(377)259 351 y
-Fd(nco)s(ords)427 451 y Fi(The)28 b(length)g(of)f(the)h
-Ft(")p Fi(co)r(ords)p Ft(")e Fi(arra)n(y)-7 b(.)34 b(Supply)28
-b(zero)f(if)h Ft(")p Fi(co)r(ords)p Ft(")d Fi(is)j(NULL.)259
-586 y Fd(co)s(ords)427 686 y Fi(P)n(oin)n(ter)k(to)h(an)g(arra)n(y)d
-(holding)j Ft(")p Fi(nco)r(ords)p Ft(")e Fi(AstKeyMap)i(p)r(oin)n(ters)
-f(\(if)i Ft(")p Fi(nco)r(ords)p Ft(")d Fi(is)i(zero,)g(the)h(sup-)427
+%%Page: 378 388
+TeXDict begin 378 387 bop 0 52 a FF(378)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(nco)s(ords)427
+451 y Fi(The)e(length)g(of)f(the)h Ft(")p Fi(co)r(ords)p
+Ft(")e Fi(arra)n(y)-7 b(.)34 b(Supply)28 b(zero)f(if)h
+Ft(")p Fi(co)r(ords)p Ft(")d Fi(is)j(NULL.)259 586 y
+Fd(co)s(ords)427 686 y Fi(P)n(oin)n(ter)k(to)h(an)g(arra)n(y)d(holding)
+j Ft(")p Fi(nco)r(ords)p Ft(")e Fi(AstKeyMap)i(p)r(oin)n(ters)f(\(if)i
+Ft(")p Fi(nco)r(ords)p Ft(")d Fi(is)i(zero,)g(the)h(sup-)427
786 y(plied)44 b(v)-5 b(alue)43 b(is)g(ignored\).)83
b(Eac)n(h)42 b(supplied)i(KeyMap)e(describ)r(es)h(the)g(con)n(ten)n(ts)
g(of)g(a)g(single)f(STC)427 885 y Fk(<)p Fi(AstroCo)r(ords)p
@@ -126393,12 +126503,11 @@ b(\))0 5217 y Fd(P)m(arameters:)259 5358 y(region)427
Ft(")p Fi(co)r(ords)p Ft(")e Fi(arra)n(y)-7 b(.)34 b(Supply)28
b(zero)f(if)h Ft(")p Fi(co)r(ords)p Ft(")d Fi(is)j(NULL.)p
eop end
-%%Page: 378 388
-TeXDict begin 378 387 bop 0 52 a FF(378)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(co)s(ords)427
-451 y Fi(P)n(oin)n(ter)i(to)h(an)g(arra)n(y)d(holding)j
-Ft(")p Fi(nco)r(ords)p Ft(")e Fi(AstKeyMap)i(p)r(oin)n(ters)f(\(if)i
-Ft(")p Fi(nco)r(ords)p Ft(")d Fi(is)i(zero,)g(the)h(sup-)427
+%%Page: 379 389
+TeXDict begin 379 388 bop 3643 52 a FF(379)259 351 y
+Fd(co)s(ords)427 451 y Fi(P)n(oin)n(ter)32 b(to)h(an)g(arra)n(y)d
+(holding)j Ft(")p Fi(nco)r(ords)p Ft(")e Fi(AstKeyMap)i(p)r(oin)n(ters)
+f(\(if)i Ft(")p Fi(nco)r(ords)p Ft(")d Fi(is)i(zero,)g(the)h(sup-)427
551 y(plied)44 b(v)-5 b(alue)43 b(is)g(ignored\).)83
b(Eac)n(h)42 b(supplied)i(KeyMap)e(describ)r(es)h(the)g(con)n(ten)n(ts)
g(of)g(a)g(single)f(STC)427 650 y Fk(<)p Fi(AstroCo)r(ords)p
@@ -126475,14 +126584,15 @@ Fh(\003)p Ft(coords[],)g(const)h(char)h Fh(\003)p Ft(options,)e(...)86
b(\))0 5447 y Fd(P)m(arameters:)259 5593 y(region)427
5693 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(encapsulated)f(Region.)p
eop end
-%%Page: 379 389
-TeXDict begin 379 388 bop 3643 52 a FF(379)259 351 y
-Fd(nco)s(ords)427 451 y Fi(The)28 b(length)g(of)f(the)h
-Ft(")p Fi(co)r(ords)p Ft(")e Fi(arra)n(y)-7 b(.)34 b(Supply)28
-b(zero)f(if)h Ft(")p Fi(co)r(ords)p Ft(")d Fi(is)j(NULL.)259
-585 y Fd(co)s(ords)427 685 y Fi(P)n(oin)n(ter)k(to)h(an)g(arra)n(y)d
-(holding)j Ft(")p Fi(nco)r(ords)p Ft(")e Fi(AstKeyMap)i(p)r(oin)n(ters)
-f(\(if)i Ft(")p Fi(nco)r(ords)p Ft(")d Fi(is)i(zero,)g(the)h(sup-)427
+%%Page: 380 390
+TeXDict begin 380 389 bop 0 52 a FF(380)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(nco)s(ords)427
+451 y Fi(The)e(length)g(of)f(the)h Ft(")p Fi(co)r(ords)p
+Ft(")e Fi(arra)n(y)-7 b(.)34 b(Supply)28 b(zero)f(if)h
+Ft(")p Fi(co)r(ords)p Ft(")d Fi(is)j(NULL.)259 585 y
+Fd(co)s(ords)427 685 y Fi(P)n(oin)n(ter)k(to)h(an)g(arra)n(y)d(holding)
+j Ft(")p Fi(nco)r(ords)p Ft(")e Fi(AstKeyMap)i(p)r(oin)n(ters)f(\(if)i
+Ft(")p Fi(nco)r(ords)p Ft(")d Fi(is)i(zero,)g(the)h(sup-)427
784 y(plied)44 b(v)-5 b(alue)43 b(is)g(ignored\).)83
b(Eac)n(h)42 b(supplied)i(KeyMap)e(describ)r(es)h(the)g(con)n(ten)n(ts)
g(of)g(a)g(single)f(STC)427 884 y Fk(<)p Fi(AstroCo)r(ords)p
@@ -126566,32 +126676,31 @@ b(These)34 b(functions)227 5494 y(should)40 b(p)r(erform)f(an)n(y)h
(functions)g(are)f(supplied,)i(a)f(Channel)g(will)h(read)e(from)h
(standard)f(input)i(and)227 5693 y(write)d(to)f(standard)g(output.)p
eop end
-%%Page: 380 390
-TeXDict begin 380 389 bop 0 52 a FF(380)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)227 351 y Fi(Alternativ)n(ely)-7
-b(,)29 b(an)g(XmlChan)h(can)e(b)r(e)i(told)f(to)g(read)f(or)g(write)h
-(from)g(sp)r(eci\014c)g(text)h(\014les)f(using)g(the)g(SinkFile)227
-451 y(and)f(SourceFile)f(attributes,)g(in)h(whic)n(h)g(case)e(no)i
-(sink)f(or)g(source)f(function)i(need)g(b)r(e)g(supplied.)0
-599 y Fd(Synopsis:)121 b Ft(AstStcsChan)39 b Fh(\003)p
-Ft(astStcsChan\()f(const)k(char)f Fh(\003)p Ft(\()p Fh(\003)i
-Ft(source\)\()d(void)i(\),)h(void)f(\()p Fh(\003)g Ft(sink\)\()f(const)
-227 699 y(char)h Fh(\003)h Ft(\),)g(const)f(char)g Fh(\003)p
-Ft(options,)d(...)86 b(\))0 847 y Fd(P)m(arameters:)259
-982 y(source)427 1081 y Fi(P)n(oin)n(ter)17 b(to)h(a)g(source)g
-(function)h(that)g(tak)n(es)e(no)h(argumen)n(ts)f(and)i(returns)e(a)h
-(p)r(oin)n(ter)h(to)f(a)g(n)n(ull-terminated)427 1181
-y(string.)36 b(If)26 b(no)g(v)-5 b(alue)25 b(has)h(b)r(een)g(set)g(for)
-f(the)h(SourceFile)g(attribute,)g(this)g(function)h(will)f(b)r(e)g
-(used)g(b)n(y)f(the)427 1280 y(StcsChan)i(to)g(obtain)g(lines)f(of)h
-(input)h(text.)37 b(On)27 b(eac)n(h)f(in)n(v)n(o)r(cation,)g(it)h
-(should)g(return)f(a)h(p)r(oin)n(ter)f(to)h(the)427 1380
-y(next)j(input)h(line)e(read)g(from)h(some)f(external)f(data)i(store,)f
-(and)g(a)h(NULL)g(p)r(oin)n(ter)f(when)h(there)f(are)g(no)427
-1480 y(more)e(lines)h(to)f(read.)427 1595 y(If)34 b Ft(")p
-Fi(source)p Ft(")e Fi(is)h(NULL)h(and)f(no)g(v)-5 b(alue)34
-b(has)f(b)r(een)h(set)f(for)g(the)h(SourceFile)f(attribute,)i(the)f
-(StcsChan)427 1695 y(will)28 b(read)f(from)g(standard)g(input)h
+%%Page: 381 391
+TeXDict begin 381 390 bop 3643 52 a FF(381)227 351 y
+Fi(Alternativ)n(ely)-7 b(,)29 b(an)g(XmlChan)h(can)e(b)r(e)i(told)f(to)
+g(read)f(or)g(write)h(from)g(sp)r(eci\014c)g(text)h(\014les)f(using)g
+(the)g(SinkFile)227 451 y(and)f(SourceFile)f(attributes,)g(in)h(whic)n
+(h)g(case)e(no)i(sink)f(or)g(source)f(function)i(need)g(b)r(e)g
+(supplied.)0 599 y Fd(Synopsis:)121 b Ft(AstStcsChan)39
+b Fh(\003)p Ft(astStcsChan\()f(const)k(char)f Fh(\003)p
+Ft(\()p Fh(\003)i Ft(source\)\()d(void)i(\),)h(void)f(\()p
+Fh(\003)g Ft(sink\)\()f(const)227 699 y(char)h Fh(\003)h
+Ft(\),)g(const)f(char)g Fh(\003)p Ft(options,)d(...)86
+b(\))0 847 y Fd(P)m(arameters:)259 982 y(source)427 1081
+y Fi(P)n(oin)n(ter)17 b(to)h(a)g(source)g(function)h(that)g(tak)n(es)e
+(no)h(argumen)n(ts)f(and)i(returns)e(a)h(p)r(oin)n(ter)h(to)f(a)g(n)n
+(ull-terminated)427 1181 y(string.)36 b(If)26 b(no)g(v)-5
+b(alue)25 b(has)h(b)r(een)g(set)g(for)f(the)h(SourceFile)g(attribute,)g
+(this)g(function)h(will)f(b)r(e)g(used)g(b)n(y)f(the)427
+1280 y(StcsChan)i(to)g(obtain)g(lines)f(of)h(input)h(text.)37
+b(On)27 b(eac)n(h)f(in)n(v)n(o)r(cation,)g(it)h(should)g(return)f(a)h
+(p)r(oin)n(ter)f(to)h(the)427 1380 y(next)j(input)h(line)e(read)g(from)
+h(some)f(external)f(data)i(store,)f(and)g(a)h(NULL)g(p)r(oin)n(ter)f
+(when)h(there)f(are)g(no)427 1480 y(more)e(lines)h(to)f(read.)427
+1595 y(If)34 b Ft(")p Fi(source)p Ft(")e Fi(is)h(NULL)h(and)f(no)g(v)-5
+b(alue)34 b(has)f(b)r(een)h(set)f(for)g(the)h(SourceFile)f(attribute,)i
+(the)f(StcsChan)427 1695 y(will)28 b(read)f(from)g(standard)g(input)h
(instead.)259 1826 y Fd(sink)427 1926 y Fi(P)n(oin)n(ter)k(to)h(a)g
(sink)h(function)g(that)f(tak)n(es)g(a)g(p)r(oin)n(ter)g(to)g(a)g(n)n
(ull-terminated)g(string)g(as)g(an)g(argumen)n(t)427
@@ -126647,11 +126756,12 @@ b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g
(to)f(supress)f(or)g(enable)h(the)h(remo)n(v)-5 b(al)31
b(of)h(escap)r(e)f(sequences)h(b)n(y)227 5693 y(this)c(function.)p
eop end
-%%Page: 381 391
-TeXDict begin 381 390 bop 3643 52 a FF(381)227 351 y
-Fi(AST)33 b(escap)r(e)e(sequences)h(are)f(used)h(b)n(y)f(the)i(Plot)e
-(class)h(to)g(mo)r(dify)g(the)g(app)r(earance)f(and)h(p)r(osition)g(of)
-g(sub-)227 451 y(strings)27 b(within)h(a)f(plotted)h(text)g(string.)37
+%%Page: 382 392
+TeXDict begin 382 391 bop 0 52 a FF(382)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)227 351 y Fi(AST)j(escap)r(e)e
+(sequences)h(are)f(used)h(b)n(y)f(the)i(Plot)e(class)h(to)g(mo)r(dify)g
+(the)g(app)r(earance)f(and)h(p)r(osition)g(of)g(sub-)227
+451 y(strings)27 b(within)h(a)f(plotted)h(text)g(string.)37
b(See)27 b(the)h Ft(")p Fi(Escap)r(e)p Ft(")e Fi(attribute)i(for)f
(further)g(information.)0 612 y Fd(Synopsis:)121 b Ft(const)41
b(char)h Fh(\003)p Ft(astStripEscapes\()37 b(const)k(char)h
@@ -126753,41 +126863,41 @@ b(of)i(the)g(selected)f(route)g(Mapping)g(is)g(used)h(to)f(transform)g
Fi(input)p Ft(")h Fi(p)r(osition.)49 b(If)32 b(the)g(selector)e(index)i
(v)-5 b(alue)31 b(is)h(outside)f(the)h(b)r(ounds)g(of)p
eop end
-%%Page: 382 392
-TeXDict begin 382 391 bop 0 52 a FF(382)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)227 351 y Fi(the)25
-b(arra)n(y)e(of)h(route)g(Mappings,)h(then)g(the)g(Switc)n(hMap)g
-Ft(")p Fi(input)p Ft(")f Fi(p)r(osition)h(is)f(set)h(to)f(a)g(v)-5
-b(alue)25 b(of)g(AST)p Ft(__)p Fi(BAD)227 451 y(on)j(ev)n(ery)e(axis.)
-227 574 y(In)f(practice,)f(appropriate)e(selector)h(Mappings)g(should)h
-(b)r(e)h(c)n(hosen)e(to)h(asso)r(ciate)f(a)g(di\013eren)n(t)h(route)g
-(Mapping)227 674 y(with)30 b(eac)n(h)e(region)g(of)h(co)r(ordinate)f
-(space.)41 b(Note)30 b(that)f(the)h(SelectorMap)e(class)g(of)h(Mapping)
-g(is)g(particularly)227 773 y(appropriate)d(for)h(this)h(purp)r(ose.)
-227 897 y(If)38 b(a)f(comp)r(ound)g(Mapping)g(con)n(tains)f(a)h(Switc)n
-(hMap)g(in)g(series)f(with)i(its)f(o)n(wn)g(in)n(v)n(erse,)h(the)f(com)
-n(bination)227 996 y(of)31 b(the)h(t)n(w)n(o)f(adjacen)n(t)f(Switc)n
-(hMaps)h(will)h(b)r(e)f(replaced)g(b)n(y)g(a)g(UnitMap)g(when)h(the)g
-(comp)r(ound)f(Mapping)g(is)227 1096 y(simpli\014ed)d(using)g
-(astSimplify)-7 b(.)0 1243 y Fd(Synopsis:)121 b Ft(AstSwitchMap)38
-b Fh(\003)p Ft(astSwitchMap\()g(AstMapping)i Fh(\003)p
-Ft(fsmap,)g(AstMapping)g Fh(\003)p Ft(ismap,)g(int)j(nroute,)227
-1343 y(AstMapping)d Fh(\003)p Ft(routemaps[],)e(const)j(char)h
-Fh(\003)p Ft(options,)e(...)86 b(\))0 1490 y Fd(P)m(arameters:)259
-1624 y(fsmap)427 1723 y Fi(P)n(oin)n(ter)28 b(to)h(the)g(forw)n(ard)f
-(selector)g(Mapping.)41 b(This)29 b(m)n(ust)h(ha)n(v)n(e)d(a)i
-(de\014ned)h(forw)n(ard)d(transformation,)427 1823 y(but)c(need)g(not)f
-(ha)n(v)n(e)f(a)h(de\014ned)h(in)n(v)n(erse)d(transformation.)34
-b(It)23 b(m)n(ust)f(ha)n(v)n(e)f(one)h(output,)i(and)e(the)h(n)n(um)n
-(b)r(er)427 1922 y(of)31 b(inputs)g(m)n(ust)f(matc)n(h)g(the)h(n)n(um)n
-(b)r(er)f(of)g(inputs)h(of)g(eac)n(h)e(of)h(the)h(supplied)g(route)f
-(Mappings.)44 b(NULL)427 2022 y(ma)n(y)27 b(b)r(e)h(supplied,)g(in)g
-(whic)n(h)g(case)e(the)i(Switc)n(hMap)g(will)g(ha)n(v)n(e)e(an)h
-(unde\014ned)i(forw)n(ard)c(Mapping.)259 2152 y Fd(ismap)427
-2252 y Fi(P)n(oin)n(ter)32 b(to)h(the)h(in)n(v)n(erse)e(selector)g
-(Mapping.)54 b(This)34 b(m)n(ust)f(ha)n(v)n(e)f(a)h(de\014ned)h(in)n(v)
-n(erse)e(transformation,)427 2352 y(but)25 b(need)f(not)f(ha)n(v)n(e)g
-(a)g(de\014ned)i(forw)n(ard)d(transformation.)34 b(It)24
+%%Page: 383 393
+TeXDict begin 383 392 bop 3643 52 a FF(383)227 351 y
+Fi(the)25 b(arra)n(y)e(of)h(route)g(Mappings,)h(then)g(the)g(Switc)n
+(hMap)g Ft(")p Fi(input)p Ft(")f Fi(p)r(osition)h(is)f(set)h(to)f(a)g
+(v)-5 b(alue)25 b(of)g(AST)p Ft(__)p Fi(BAD)227 451 y(on)j(ev)n(ery)e
+(axis.)227 574 y(In)f(practice,)f(appropriate)e(selector)h(Mappings)g
+(should)h(b)r(e)h(c)n(hosen)e(to)h(asso)r(ciate)f(a)g(di\013eren)n(t)h
+(route)g(Mapping)227 674 y(with)30 b(eac)n(h)e(region)g(of)h(co)r
+(ordinate)f(space.)41 b(Note)30 b(that)f(the)h(SelectorMap)e(class)g
+(of)h(Mapping)g(is)g(particularly)227 773 y(appropriate)d(for)h(this)h
+(purp)r(ose.)227 897 y(If)38 b(a)f(comp)r(ound)g(Mapping)g(con)n(tains)
+f(a)h(Switc)n(hMap)g(in)g(series)f(with)i(its)f(o)n(wn)g(in)n(v)n
+(erse,)h(the)f(com)n(bination)227 996 y(of)31 b(the)h(t)n(w)n(o)f
+(adjacen)n(t)f(Switc)n(hMaps)h(will)h(b)r(e)f(replaced)g(b)n(y)g(a)g
+(UnitMap)g(when)h(the)g(comp)r(ound)f(Mapping)g(is)227
+1096 y(simpli\014ed)d(using)g(astSimplify)-7 b(.)0 1243
+y Fd(Synopsis:)121 b Ft(AstSwitchMap)38 b Fh(\003)p Ft(astSwitchMap\()g
+(AstMapping)i Fh(\003)p Ft(fsmap,)g(AstMapping)g Fh(\003)p
+Ft(ismap,)g(int)j(nroute,)227 1343 y(AstMapping)d Fh(\003)p
+Ft(routemaps[],)e(const)j(char)h Fh(\003)p Ft(options,)e(...)86
+b(\))0 1490 y Fd(P)m(arameters:)259 1624 y(fsmap)427
+1723 y Fi(P)n(oin)n(ter)28 b(to)h(the)g(forw)n(ard)f(selector)g
+(Mapping.)41 b(This)29 b(m)n(ust)h(ha)n(v)n(e)d(a)i(de\014ned)h(forw)n
+(ard)d(transformation,)427 1823 y(but)c(need)g(not)f(ha)n(v)n(e)f(a)h
+(de\014ned)h(in)n(v)n(erse)d(transformation.)34 b(It)23
+b(m)n(ust)f(ha)n(v)n(e)f(one)h(output,)i(and)e(the)h(n)n(um)n(b)r(er)
+427 1922 y(of)31 b(inputs)g(m)n(ust)f(matc)n(h)g(the)h(n)n(um)n(b)r(er)
+f(of)g(inputs)h(of)g(eac)n(h)e(of)h(the)h(supplied)g(route)f(Mappings.)
+44 b(NULL)427 2022 y(ma)n(y)27 b(b)r(e)h(supplied,)g(in)g(whic)n(h)g
+(case)e(the)i(Switc)n(hMap)g(will)g(ha)n(v)n(e)e(an)h(unde\014ned)i
+(forw)n(ard)c(Mapping.)259 2152 y Fd(ismap)427 2252 y
+Fi(P)n(oin)n(ter)32 b(to)h(the)h(in)n(v)n(erse)e(selector)g(Mapping.)54
+b(This)34 b(m)n(ust)f(ha)n(v)n(e)f(a)h(de\014ned)h(in)n(v)n(erse)e
+(transformation,)427 2352 y(but)25 b(need)f(not)f(ha)n(v)n(e)g(a)g
+(de\014ned)i(forw)n(ard)d(transformation.)34 b(It)24
b(m)n(ust)g(ha)n(v)n(e)e(one)i(input,)h(and)f(the)g(n)n(um)n(b)r(er)427
2451 y(of)g(outputs)g(m)n(ust)g(matc)n(h)g(the)g(n)n(um)n(b)r(er)f(of)h
(outputs)g(of)g(eac)n(h)f(of)h(the)g(supplied)g(route)f(Mappings.)35
@@ -126835,9 +126945,10 @@ b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
427 5629 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
(fail)h(for)f(an)n(y)g(reason.)p eop end
-%%Page: 383 393
-TeXDict begin 383 392 bop 3643 52 a FF(383)p 0 351 3780
-12 v 0 483 a Fz(astT)-11 b(able)1020 b Fe(Create)37 b(a)i(T)-10
+%%Page: 384 394
+TeXDict begin 384 393 bop 0 52 a FF(384)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 483 a Fz(astT)-11 b(able)1020 b Fe(Create)37 b(a)i(T)-10
b(able)1018 b Fz(astT)-11 b(able)0 681 y Fd(Description:)44
b Fi(This)28 b(function)g(creates)f(a)g(new)g(empt)n(y)h(T)-7
b(able)27 b(and)h(optionally)f(initialises)g(its)h(attributes.)227
@@ -126916,10 +127027,9 @@ y Fi(The)d(protected)g(in)n(terface)f(to)g(this)h(function)h(includes)f
b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)e
(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fi(in)n(t)227
5627 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p eop end
-%%Page: 384 394
-TeXDict begin 384 393 bop 0 52 a FF(384)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 483 a Fz(astT)-11 b(ableSource)250 b Fe(Register)37
+%%Page: 385 395
+TeXDict begin 385 394 bop 3643 52 a FF(385)p 0 351 3780
+12 v 0 483 a Fz(astT)-11 b(ableSource)250 b Fe(Register)37
b(a)i(source)f(function)g(for)1150 598 y(accessing)g(tables)f(in)i
(FITS)g(\014les)2895 483 y Fz(astT)-11 b(ableSource)0
775 y Fd(Description:)44 b Fi(This)24 b(function)g(can)f(b)r(e)g(used)h
@@ -127004,29 +127114,29 @@ b Ft(int)42 b(astTest\()e(AstObject)g Fh(\003)p Ft(this,)h(const)h
(char)g Fh(\003)p Ft(attrib)e(\))0 5462 y Fd(P)m(arameters:)259
5593 y(this)427 5693 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Ob)5
b(ject.)p eop end
-%%Page: 385 395
-TeXDict begin 385 394 bop 3643 52 a FF(385)259 351 y
-Fd(attrib)427 451 y Fi(P)n(oin)n(ter)39 b(to)g(a)h(n)n(ull-terminated)f
-(c)n(haracter)f(string)h(con)n(taining)g(the)i(name)e(of)h(the)g
-(attribute)g(to)g(b)r(e)427 551 y(tested.)0 718 y Fd(Class)31
-b(Applicabilit)m(y:)259 859 y(Ob)5 b(ject)427 959 y Fi(This)28
-b(function)g(applies)f(to)h(all)f(Ob)5 b(jects.)0 1126
-y Fd(Returned)32 b(V)-8 b(alue:)259 1267 y(astT)g(est\(\))427
-1367 y Fi(One)29 b(if)g(a)f(v)-5 b(alue)29 b(has)f(previously)g(b)r
-(een)h(explicitly)g(set)f(for)h(the)g(attribute)g(\(and)f(hasn't)h(b)r
-(een)g(cleared\),)427 1467 y(otherwise)e(zero.)0 1634
-y Fd(Notes:)340 1921 y Fh(\017)45 b Fi(A)n(ttribute)28
-b(names)g(are)e(not)i(case)f(sensitiv)n(e)g(and)g(ma)n(y)g(b)r(e)h
-(surrounded)e(b)n(y)i(white)g(space.)340 2057 y Fh(\017)45
-b Fi(A)29 b(v)-5 b(alue)29 b(of)f(zero)g(will)h(b)r(e)g(returned)f(if)h
-(this)g(function)g(is)f(in)n(v)n(ok)n(ed)f(with)j(the)f(AST)g(error)d
-(status)j(set,)f(or)427 2156 y(if)g(it)g(should)g(fail)f(for)h(an)n(y)e
-(reason.)340 2292 y Fh(\017)45 b Fi(A)35 b(v)-5 b(alue)35
-b(of)g(zero)f(will)h(also)e(b)r(e)i(returned)g(if)g(this)g(function)h
-(is)e(used)h(to)g(test)g(a)f(read-only)f(attribute,)427
-2391 y(although)27 b(no)h(error)d(will)j(result.)p 0
-2596 3780 12 v 0 2727 a Fz(astT)-11 b(estFits)283 b Fe(See)39
-b(if)f(a)h(named)f(k)m(eyw)m(ord)e(has)j(a)g(de\014ned)1385
+%%Page: 386 396
+TeXDict begin 386 395 bop 0 52 a FF(386)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(attrib)427
+451 y Fi(P)n(oin)n(ter)39 b(to)g(a)h(n)n(ull-terminated)f(c)n(haracter)
+f(string)h(con)n(taining)g(the)i(name)e(of)h(the)g(attribute)g(to)g(b)r
+(e)427 551 y(tested.)0 718 y Fd(Class)31 b(Applicabilit)m(y:)259
+859 y(Ob)5 b(ject)427 959 y Fi(This)28 b(function)g(applies)f(to)h(all)
+f(Ob)5 b(jects.)0 1126 y Fd(Returned)32 b(V)-8 b(alue:)259
+1267 y(astT)g(est\(\))427 1367 y Fi(One)29 b(if)g(a)f(v)-5
+b(alue)29 b(has)f(previously)g(b)r(een)h(explicitly)g(set)f(for)h(the)g
+(attribute)g(\(and)f(hasn't)h(b)r(een)g(cleared\),)427
+1467 y(otherwise)e(zero.)0 1634 y Fd(Notes:)340 1921
+y Fh(\017)45 b Fi(A)n(ttribute)28 b(names)g(are)e(not)i(case)f
+(sensitiv)n(e)g(and)g(ma)n(y)g(b)r(e)h(surrounded)e(b)n(y)i(white)g
+(space.)340 2057 y Fh(\017)45 b Fi(A)29 b(v)-5 b(alue)29
+b(of)f(zero)g(will)h(b)r(e)g(returned)f(if)h(this)g(function)g(is)f(in)
+n(v)n(ok)n(ed)f(with)j(the)f(AST)g(error)d(status)j(set,)f(or)427
+2156 y(if)g(it)g(should)g(fail)f(for)h(an)n(y)e(reason.)340
+2292 y Fh(\017)45 b Fi(A)35 b(v)-5 b(alue)35 b(of)g(zero)f(will)h(also)
+e(b)r(e)i(returned)g(if)g(this)g(function)h(is)e(used)h(to)g(test)g(a)f
+(read-only)f(attribute,)427 2391 y(although)27 b(no)h(error)d(will)j
+(result.)p 0 2596 3780 12 v 0 2727 a Fz(astT)-11 b(estFits)283
+b Fe(See)39 b(if)f(a)h(named)f(k)m(eyw)m(ord)e(has)j(a)g(de\014ned)1385
2842 y(v)-7 b(alue)38 b(in)h(a)f(FitsChan)3132 2727 y
Fz(astT)-11 b(estFits)0 3013 y Fd(Description:)44 b Fi(This)31
b(function)h(serc)n(hes)e(for)g(a)h(named)g(k)n(eyw)n(ord)e(in)i(a)g
@@ -127065,16 +127175,15 @@ b(a)g(v)-5 b(alue)27 b(of)h(one)f(is)h(returned.)0 5405
y Fd(Notes:)340 5693 y Fh(\017)45 b Fi(The)28 b(curren)n(t)f(card)f(is)
i(left)g(unc)n(hanged)f(b)n(y)g(this)h(function.)p eop
end
-%%Page: 386 396
-TeXDict begin 386 395 bop 0 52 a FF(386)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
-b Fi(The)27 b(card)e(follo)n(wing)h(the)h(curren)n(t)e(card)h(is)g(c)n
-(hec)n(k)n(ed)f(\014rst.)37 b(If)27 b(this)f(is)h(not)f(the)h(required)
-e(card,)h(then)h(the)427 451 y(rest)21 b(of)h(the)g(FitsChan)g(is)f
-(searc)n(hed,)h(starting)e(with)j(the)f(\014rst)f(card)g(added)g(to)h
-(the)g(FitsChan.)35 b(Therefore)427 551 y(cards)24 b(should)g(b)r(e)h
-(accessed)e(in)i(the)g(order)e(they)i(are)f(stored)f(in)i(the)g
-(FitsChan)g(\(if)g(p)r(ossible\))g(as)f(this)g(will)427
+%%Page: 387 397
+TeXDict begin 387 396 bop 3643 52 a FF(387)340 351 y
+Fh(\017)45 b Fi(The)27 b(card)e(follo)n(wing)h(the)h(curren)n(t)e(card)
+h(is)g(c)n(hec)n(k)n(ed)f(\014rst.)37 b(If)27 b(this)f(is)h(not)f(the)h
+(required)e(card,)h(then)h(the)427 451 y(rest)21 b(of)h(the)g(FitsChan)
+g(is)f(searc)n(hed,)h(starting)e(with)j(the)f(\014rst)f(card)g(added)g
+(to)h(the)g(FitsChan.)35 b(Therefore)427 551 y(cards)24
+b(should)g(b)r(e)h(accessed)e(in)i(the)g(order)e(they)i(are)f(stored)f
+(in)i(the)g(FitsChan)g(\(if)g(p)r(ossible\))g(as)f(this)g(will)427
650 y(minimise)k(the)g(time)g(sp)r(en)n(t)g(searc)n(hing)e(for)h
(cards.)340 780 y Fh(\017)45 b Fi(An)28 b(error)e(will)i(b)r(e)g(rep)r
(orted)f(if)h(the)g(k)n(eyw)n(ord)d(name)j(do)r(es)f(not)h(conform)e
@@ -127151,15 +127260,16 @@ g(\(see)g(astClip\),)f(then)h(no)g(text)g(is)f(dra)n(wn.)340
5593 y Fh(\017)45 b Fi(An)40 b(error)d(results)i(if)g(the)h(base)e(F)-7
b(rame)39 b(of)g(the)g(Plot)g(is)g(not)g(2-dimensional)f(or)g(\(for)h
(a)g(Plot3D\))f(3-)427 5693 y(dimensional.)p eop end
-%%Page: 387 397
-TeXDict begin 387 396 bop 3643 52 a FF(387)340 351 y
-Fh(\017)45 b Fi(An)30 b(error)d(also)g(results)i(if)g(the)g
-(transformation)f(b)r(et)n(w)n(een)h(the)g(curren)n(t)f(and)h(base)f(F)
--7 b(rames)28 b(of)h(the)g(Plot)427 451 y(is)f(not)f(de\014ned)h
-(\(i.e.)38 b(the)28 b(Plot's)e(T)-7 b(ranIn)n(v)n(erse)26
-b(attribute)h(is)h(zero\).)p 0 637 3780 12 v 0 769 a
-Fz(astThread)196 b Fe(Determine)38 b(the)g(thread)g(that)g(o)m(wns)g
-(an)g(Ob)7 b(ject)195 b Fz(astThread)0 949 y Fd(Description:)44
+%%Page: 388 398
+TeXDict begin 388 397 bop 0 52 a FF(388)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Fi(An)30 b(error)d(also)g(results)i(if)g(the)g(transformation)f(b)r
+(et)n(w)n(een)h(the)g(curren)n(t)f(and)h(base)f(F)-7
+b(rames)28 b(of)h(the)g(Plot)427 451 y(is)f(not)f(de\014ned)h(\(i.e.)38
+b(the)28 b(Plot's)e(T)-7 b(ranIn)n(v)n(erse)26 b(attribute)h(is)h
+(zero\).)p 0 637 3780 12 v 0 769 a Fz(astThread)196 b
+Fe(Determine)38 b(the)g(thread)g(that)g(o)m(wns)g(an)g(Ob)7
+b(ject)195 b Fz(astThread)0 949 y Fd(Description:)44
b Fi(Returns)c(an)g(in)n(teger)f(that)h(indicates)g(whether)g(the)g
(supplied)h(Ob)5 b(ject)40 b(\(or)f(Ob)5 b(ject)40 b(p)r(oin)n(ter\))g
(is)227 1048 y(curren)n(tly)27 b(unlo)r(c)n(k)n(ed,)g(or)g(is)g(curren)
@@ -127244,11 +127354,10 @@ h(for)f(a)g(thread)g(to)g(ha)n(v)n(e)f(activ)n(e)h(p)r(oin)n(ters)g
(ann)n(ulled.)51 b(This)33 b(includes)f(p)r(oin)n(ters)227
5693 y(for)27 b(Ob)5 b(jects)28 b(that)f(are)g(curren)n(tly)g(lo)r(c)n
(k)n(ed)f(b)n(y)i(other)f(threads.)p eop end
-%%Page: 388 398
-TeXDict begin 388 397 bop 0 52 a FF(388)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)227 351 y Fi(If)35
-b(the)g Ft(")p Fi(ptr)p Ft(")f Fi(parameter)f(is)i(zero,)g(then)g(the)g
-(returned)g(v)-5 b(alue)34 b(describ)r(es)g(the)h(Ob)5
+%%Page: 389 399
+TeXDict begin 389 398 bop 3643 52 a FF(389)227 351 y
+Fi(If)35 b(the)g Ft(")p Fi(ptr)p Ft(")f Fi(parameter)f(is)i(zero,)g
+(then)g(the)g(returned)g(v)-5 b(alue)34 b(describ)r(es)g(the)h(Ob)5
b(ject)35 b(structure)f(itself.)58 b(If)227 451 y Ft(")p
Fi(ptr)p Ft(")36 b Fi(is)h(non-zero,)h(then)g(the)f(returned)f(v)-5
b(alue)37 b(describ)r(es)g(the)g(supplied)g(Ob)5 b(ject)37
@@ -127333,9 +127442,10 @@ b(and)g(argumen)n(t)e(names)h(are)g(describ)r(ed)g(at)g(the)227
5595 y(end)k(of)g(the)g(list)f(of)h(con)n(v)n(ersions,)d(and)j
Ft(")p Fi(MJD)p Ft(")f Fi(means)g(Mo)r(di\014ed)h(Julian)f(Date.)p
eop end
-%%Page: 389 399
-TeXDict begin 389 398 bop 3643 52 a FF(389)340 351 y
-Fh(\017)45 b Ft(")p Fi(MJDTOMJD)p Ft(")27 b Fi(\(MJDOFF1,MJDOFF2\):)37
+%%Page: 390 400
+TeXDict begin 390 399 bop 0 52 a FF(390)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Ft(")p Fi(MJDTOMJD)p Ft(")27 b Fi(\(MJDOFF1,MJDOFF2\):)37
b(Con)n(v)n(ert)26 b(MJD)i(from)f(one)g(o\013set)h(to)f(another.)340
483 y Fh(\017)45 b Ft(")p Fi(MJDTOJD)p Ft(")27 b Fi(\(MJDOFF,JDOFF\):)h
(Con)n(v)n(ert)f(MJD)h(to)f(Julian)g(Date.)340 614 y
@@ -127411,12 +127521,11 @@ n(y)h(astT)-7 b(ransform)26 b(are)g(o\013sets)h(a)n(w)n(a)n(y)f(from)h
(these)h(zero-p)r(oin)n(ts:)340 5693 y Fh(\017)45 b Fi(MJDOFF:)28
b(The)g(zero-p)r(oin)n(t)e(b)r(eing)i(used)f(with)h(MJD)g(v)-5
b(alues.)p eop end
-%%Page: 390 400
-TeXDict begin 390 399 bop 0 52 a FF(390)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
-b Fi(JDOFF:)28 b(The)g(zero-p)r(oin)n(t)e(b)r(eing)i(used)f(with)h
-(Julian)g(Date)f(v)-5 b(alues.)340 480 y Fh(\017)45 b
-Fi(BEPOFF:)27 b(The)g(zero-p)r(oin)n(t)g(b)r(eing)g(used)h(with)g
+%%Page: 391 401
+TeXDict begin 391 400 bop 3643 52 a FF(391)340 351 y
+Fh(\017)45 b Fi(JDOFF:)28 b(The)g(zero-p)r(oin)n(t)e(b)r(eing)i(used)f
+(with)h(Julian)g(Date)f(v)-5 b(alues.)340 480 y Fh(\017)45
+b Fi(BEPOFF:)27 b(The)g(zero-p)r(oin)n(t)g(b)r(eing)g(used)h(with)g
(Besselian)f(ep)r(o)r(c)n(h)g(v)-5 b(alues.)340 609 y
Fh(\017)45 b Fi(JEPOFF:)27 b(The)g(zero-p)r(oin)n(t)g(b)r(eing)g(used)h
(with)g(Julian)f(ep)r(o)r(c)n(h)h(v)-5 b(alues.)340 737
@@ -127502,8 +127611,9 @@ Fi(prin)n(tf)p Ft(")427 5287 y Fi(function\).)0 5445
y Fd(Returned)32 b(V)-8 b(alue:)259 5577 y(astTimeF)g(rame\(\))427
5677 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(TimeF)-7
b(rame.)p eop end
-%%Page: 391 401
-TeXDict begin 391 400 bop 3643 52 a FF(391)0 351 y Fd(Notes:)340
+%%Page: 392 402
+TeXDict begin 392 401 bop 0 52 a FF(392)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Notes:)340
628 y Fh(\017)45 b Fi(When)40 b(con)n(v)n(ersion)e(b)r(et)n(w)n(een)h
(t)n(w)n(o)g(TimeF)-7 b(rames)39 b(is)g(requested)g(\(as)g(when)h
(supplying)f(TimeF)-7 b(rames)427 728 y(to)39 b(astCon)n(v)n(ert\),)i
@@ -127581,12 +127691,11 @@ b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g
(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427
5632 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h
(for)f(an)n(y)g(reason.)p eop end
-%%Page: 392 402
-TeXDict begin 392 401 bop 0 52 a FF(392)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 483 a Fz(astT)-11 b(oString)194 b Fe(Create)37 b(an)h(in-memory)f
-(serialisation)e(of)j(an)1716 598 y(Ob)7 b(ject)3098
-483 y Fz(astT)-11 b(oString)0 786 y Fd(Description:)44
+%%Page: 393 403
+TeXDict begin 393 402 bop 3643 52 a FF(393)p 0 351 3780
+12 v 0 483 a Fz(astT)-11 b(oString)194 b Fe(Create)37
+b(an)h(in-memory)f(serialisation)e(of)j(an)1716 598 y(Ob)7
+b(ject)3098 483 y Fz(astT)-11 b(oString)0 786 y Fd(Description:)44
b Fi(This)25 b(function)g(returns)e(a)h(string)g(holding)g(a)g(minimal)
g(textual)h(serialisation)d(of)j(the)f(supplied)h(AST)227
886 y(Ob)5 b(ject.)37 b(The)28 b(Ob)5 b(ject)27 b(can)g(re)g
@@ -127635,59 +127744,60 @@ b(astTran2\()e(AstMapping)f Fh(\003)p Ft(this,)i(int)h(npoint,)f(const)
h(double)f(xin[],)g(const)g(double)227 5569 y(yin[],)g(int)i(forward,)d
(double)h(xout[],)g(double)g(yout[])g(\))0 5718 y Fd(P)m(arameters:)p
eop end
-%%Page: 393 403
-TeXDict begin 393 402 bop 3643 52 a FF(393)259 351 y
-Fd(this)427 451 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Mapping)f(to)g(b)r
-(e)h(applied.)259 575 y Fd(np)s(oin)m(t)427 675 y Fi(The)g(n)n(um)n(b)r
-(er)f(of)h(p)r(oin)n(ts)f(to)h(b)r(e)g(transformed.)259
-799 y Fd(xin)427 899 y Fi(An)g(arra)n(y)e(of)h Ft(")p
-Fi(np)r(oin)n(t)p Ft(")g Fi(X-co)r(ordinate)g(v)-5 b(alues)27
-b(for)g(the)h(input)g(\(un)n(transformed\))f(p)r(oin)n(ts.)259
-1023 y Fd(yin)427 1122 y Fi(An)h(arra)n(y)e(of)h Ft(")p
-Fi(np)r(oin)n(t)p Ft(")g Fi(Y-co)r(ordinate)g(v)-5 b(alues)27
-b(for)g(the)h(input)g(\(un)n(transformed\))f(p)r(oin)n(ts.)259
-1247 y Fd(forw)m(ard)427 1346 y Fi(A)36 b(non-zero)d(v)-5
-b(alue)35 b(indicates)f(that)i(the)f(Mapping's)f(forw)n(ard)g(co)r
-(ordinate)f(transformation)h(is)g(to)h(b)r(e)427 1446
-y(applied,)28 b(while)g(a)f(zero)f(v)-5 b(alue)28 b(indicates)f(that)h
-(the)g(in)n(v)n(erse)e(transformation)g(should)i(b)r(e)g(used.)259
-1570 y Fd(xout)427 1670 y Fi(An)d(arra)n(y)e(\(with)i
-Ft(")p Fi(np)r(oin)n(t)p Ft(")f Fi(elemen)n(ts\))h(in)n(to)g(whic)n(h)f
-(the)h(X-co)r(ordinates)e(of)i(the)g(output)g(\(transformed\))427
-1769 y(p)r(oin)n(ts)j(will)g(b)r(e)g(written.)259 1894
-y Fd(y)m(out)427 1993 y Fi(An)d(arra)n(y)e(\(with)i Ft(")p
-Fi(np)r(oin)n(t)p Ft(")f Fi(elemen)n(ts\))h(in)n(to)g(whic)n(h)f(the)h
-(Y-co)r(ordinates)e(of)i(the)g(output)g(\(transformed\))427
-2093 y(p)r(oin)n(ts)j(will)g(b)r(e)g(written.)0 2246
-y Fd(Notes:)340 2520 y Fh(\017)45 b Fi(The)28 b(Mapping)f(supplied)h(m)
-n(ust)g(ha)n(v)n(e)e(the)i(v)-5 b(alue)28 b(2)f(for)g(b)r(oth)h(its)g
-(Nin)g(and)f(Nout)h(attributes.)p 0 2702 3780 12 v 0
-2834 a Fz(astT)-11 b(ranGrid)423 b Fe(T)-10 b(ransform)37
-b(a)h(grid)g(of)g(p)s(ositions)422 b Fz(astT)-11 b(ranGrid)0
-3006 y Fd(Description:)44 b Fi(This)36 b(function)g(uses)f(the)h
-(supplied)f(Mapping)g(to)h(transforms)e(a)h(regular)e(square)i(grid)f
-(of)i(p)r(oin)n(ts)227 3105 y(co)n(v)n(ering)28 b(a)h(sp)r(eci\014ed)h
-(b)r(o)n(x.)42 b(It)30 b(attempts)g(to)f(do)g(this)h(quic)n(kly)f(b)n
-(y)g(\014rst)g(appro)n(ximating)f(the)i(Mapping)f(with)227
-3205 y(a)35 b(linear)g(transformation)e(applied)j(o)n(v)n(er)d(the)j
-(whole)f(region)f(of)h(the)h(input)g(grid)e(whic)n(h)i(is)f(b)r(eing)g
-(used.)60 b(If)227 3304 y(this)30 b(pro)n(v)n(es)e(to)i(b)r(e)g
-(insu\016cien)n(tly)g(accurate,)f(the)h(input)h(region)d(is)i
-(sub-divided)g(in)n(to)f(t)n(w)n(o)g(along)g(its)h(largest)227
-3404 y(dimension)k(and)g(the)h(pro)r(cess)e(is)h(rep)r(eated)g(within)h
-(eac)n(h)e(of)h(the)h(resulting)f(sub-regions.)54 b(This)35
-b(pro)r(cess)e(of)227 3504 y(sub-division)21 b(con)n(tin)n(ues)g(un)n
-(til)g(a)g(su\016cien)n(tly)h(go)r(o)r(d)f(linear)f(appro)n(ximation)g
-(is)h(found,)i(or)e(the)g(region)f(to)i(whic)n(h)227
-3603 y(it)28 b(is)g(b)r(eing)f(applied)h(b)r(ecomes)f(to)r(o)h(small)f
-(\(in)h(whic)n(h)g(case)e(the)i(original)e(Mapping)h(is)h(used)g
-(directly\).)0 3744 y Fd(Synopsis:)121 b Ft(void)42 b(astTranGrid\()c
-(AstMapping)i Fh(\003)p Ft(this,)h(int)h(ncoord_in,)e(const)h(int)i
-(lbnd[],)d(const)i(int)227 3844 y(ubnd[],)f(double)g(tol,)h(int)g
-(maxpix,)f(int)h(forward,)f(int)h(ncoord_out,)d(int)j(outdim,)f(double)
-g Fh(\003)p Ft(out)227 3943 y(\);)0 4084 y Fd(P)m(arameters:)259
-4212 y(this)427 4312 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Mapping)f(to)g
-(b)r(e)h(applied.)259 4436 y Fd(nco)s(ord)p Ft(_)p Fd(in)427
+%%Page: 394 404
+TeXDict begin 394 403 bop 0 52 a FF(394)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(this)427
+451 y Fi(P)n(oin)n(ter)c(to)i(the)g(Mapping)f(to)g(b)r(e)h(applied.)259
+575 y Fd(np)s(oin)m(t)427 675 y Fi(The)g(n)n(um)n(b)r(er)f(of)h(p)r
+(oin)n(ts)f(to)h(b)r(e)g(transformed.)259 799 y Fd(xin)427
+899 y Fi(An)g(arra)n(y)e(of)h Ft(")p Fi(np)r(oin)n(t)p
+Ft(")g Fi(X-co)r(ordinate)g(v)-5 b(alues)27 b(for)g(the)h(input)g(\(un)
+n(transformed\))f(p)r(oin)n(ts.)259 1023 y Fd(yin)427
+1122 y Fi(An)h(arra)n(y)e(of)h Ft(")p Fi(np)r(oin)n(t)p
+Ft(")g Fi(Y-co)r(ordinate)g(v)-5 b(alues)27 b(for)g(the)h(input)g(\(un)
+n(transformed\))f(p)r(oin)n(ts.)259 1247 y Fd(forw)m(ard)427
+1346 y Fi(A)36 b(non-zero)d(v)-5 b(alue)35 b(indicates)f(that)i(the)f
+(Mapping's)f(forw)n(ard)g(co)r(ordinate)f(transformation)h(is)g(to)h(b)
+r(e)427 1446 y(applied,)28 b(while)g(a)f(zero)f(v)-5
+b(alue)28 b(indicates)f(that)h(the)g(in)n(v)n(erse)e(transformation)g
+(should)i(b)r(e)g(used.)259 1570 y Fd(xout)427 1670 y
+Fi(An)d(arra)n(y)e(\(with)i Ft(")p Fi(np)r(oin)n(t)p
+Ft(")f Fi(elemen)n(ts\))h(in)n(to)g(whic)n(h)f(the)h(X-co)r(ordinates)e
+(of)i(the)g(output)g(\(transformed\))427 1769 y(p)r(oin)n(ts)j(will)g
+(b)r(e)g(written.)259 1894 y Fd(y)m(out)427 1993 y Fi(An)d(arra)n(y)e
+(\(with)i Ft(")p Fi(np)r(oin)n(t)p Ft(")f Fi(elemen)n(ts\))h(in)n(to)g
+(whic)n(h)f(the)h(Y-co)r(ordinates)e(of)i(the)g(output)g
+(\(transformed\))427 2093 y(p)r(oin)n(ts)j(will)g(b)r(e)g(written.)0
+2246 y Fd(Notes:)340 2520 y Fh(\017)45 b Fi(The)28 b(Mapping)f
+(supplied)h(m)n(ust)g(ha)n(v)n(e)e(the)i(v)-5 b(alue)28
+b(2)f(for)g(b)r(oth)h(its)g(Nin)g(and)f(Nout)h(attributes.)p
+0 2702 3780 12 v 0 2834 a Fz(astT)-11 b(ranGrid)423 b
+Fe(T)-10 b(ransform)37 b(a)h(grid)g(of)g(p)s(ositions)422
+b Fz(astT)-11 b(ranGrid)0 3006 y Fd(Description:)44 b
+Fi(This)36 b(function)g(uses)f(the)h(supplied)f(Mapping)g(to)h
+(transforms)e(a)h(regular)e(square)i(grid)f(of)i(p)r(oin)n(ts)227
+3105 y(co)n(v)n(ering)28 b(a)h(sp)r(eci\014ed)h(b)r(o)n(x.)42
+b(It)30 b(attempts)g(to)f(do)g(this)h(quic)n(kly)f(b)n(y)g(\014rst)g
+(appro)n(ximating)f(the)i(Mapping)f(with)227 3205 y(a)35
+b(linear)g(transformation)e(applied)j(o)n(v)n(er)d(the)j(whole)f
+(region)f(of)h(the)h(input)g(grid)e(whic)n(h)i(is)f(b)r(eing)g(used.)60
+b(If)227 3304 y(this)30 b(pro)n(v)n(es)e(to)i(b)r(e)g(insu\016cien)n
+(tly)g(accurate,)f(the)h(input)h(region)d(is)i(sub-divided)g(in)n(to)f
+(t)n(w)n(o)g(along)g(its)h(largest)227 3404 y(dimension)k(and)g(the)h
+(pro)r(cess)e(is)h(rep)r(eated)g(within)h(eac)n(h)e(of)h(the)h
+(resulting)f(sub-regions.)54 b(This)35 b(pro)r(cess)e(of)227
+3504 y(sub-division)21 b(con)n(tin)n(ues)g(un)n(til)g(a)g(su\016cien)n
+(tly)h(go)r(o)r(d)f(linear)f(appro)n(ximation)g(is)h(found,)i(or)e(the)
+g(region)f(to)i(whic)n(h)227 3603 y(it)28 b(is)g(b)r(eing)f(applied)h
+(b)r(ecomes)f(to)r(o)h(small)f(\(in)h(whic)n(h)g(case)e(the)i(original)
+e(Mapping)h(is)h(used)g(directly\).)0 3744 y Fd(Synopsis:)121
+b Ft(void)42 b(astTranGrid\()c(AstMapping)i Fh(\003)p
+Ft(this,)h(int)h(ncoord_in,)e(const)h(int)i(lbnd[],)d(const)i(int)227
+3844 y(ubnd[],)f(double)g(tol,)h(int)g(maxpix,)f(int)h(forward,)f(int)h
+(ncoord_out,)d(int)j(outdim,)f(double)g Fh(\003)p Ft(out)227
+3943 y(\);)0 4084 y Fd(P)m(arameters:)259 4212 y(this)427
+4312 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Mapping)f(to)g(b)r(e)h
+(applied.)259 4436 y Fd(nco)s(ord)p Ft(_)p Fd(in)427
4536 y Fi(The)c(n)n(um)n(b)r(er)g(of)g(co)r(ordinates)f(b)r(eing)h
(supplied)g(for)g(eac)n(h)f(b)r(o)n(x)g(corner)g(\(i.e.)36
b(the)24 b(n)n(um)n(b)r(er)g(of)g(dimensions)427 4635
@@ -127712,13 +127822,12 @@ i(\(assuming)d(the)i(index)g Ft(")p Fi(j)p Ft(")f Fi(to)g(b)r(e)427
427 5693 y(exten)n(t)28 b(along)e(eac)n(h)h(dimension)h(with)g(in)n
(tegral)e(co)r(ordinate)h(v)-5 b(alues)27 b(at)g(its)h(cen)n(tre.)p
eop end
-%%Page: 394 404
-TeXDict begin 394 403 bop 0 52 a FF(394)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(tol)427
-451 y Fi(The)k(maxim)n(um)f(tolerable)f(geometrical)f(distortion)i
-(whic)n(h)g(ma)n(y)f(b)r(e)i(in)n(tro)r(duced)f(as)f(a)h(result)g(of)g
-(ap-)427 551 y(pro)n(ximating)c(non-linear)f(Mappings)h(b)n(y)h(a)f
-(set)h(of)g(piece-wise)f(linear)g(transformations.)42
+%%Page: 395 405
+TeXDict begin 395 404 bop 3643 52 a FF(395)259 351 y
+Fd(tol)427 451 y Fi(The)34 b(maxim)n(um)f(tolerable)f(geometrical)f
+(distortion)i(whic)n(h)g(ma)n(y)f(b)r(e)i(in)n(tro)r(duced)f(as)f(a)h
+(result)g(of)g(ap-)427 551 y(pro)n(ximating)c(non-linear)f(Mappings)h
+(b)n(y)h(a)f(set)h(of)g(piece-wise)f(linear)g(transformations.)42
b(This)30 b(should)427 650 y(b)r(e)e(expressed)f(as)g(a)g(displacemen)n
(t)g(within)h(the)g(output)h(co)r(ordinate)d(system)h(of)h(the)g
(Mapping.)427 766 y(If)34 b(piece-wise)f(linear)g(appro)n(ximation)f
@@ -127808,12 +127917,13 @@ Ft(")f Fi(for)h(its)h(Nout)427 5627 y(attribute.)i(If)28
b(the)g(in)n(v)n(erse)e(transformation)g(is)i(b)r(eing)g(applied,)f
(these)h(v)-5 b(alues)27 b(should)g(b)r(e)h(rev)n(ersed.)p
eop end
-%%Page: 395 405
-TeXDict begin 395 404 bop 3643 52 a FF(395)p 0 351 3780
-12 v 0 482 a Fz(astT)-11 b(ranMap)699 b Fe(Create)37
-b(a)i(T)-10 b(ranMap)698 b Fz(astT)-11 b(ranMap)0 641
-y Fd(Description:)44 b Fi(This)28 b(function)g(creates)f(a)g(new)g(T)-7
-b(ranMap)27 b(and)g(optionally)g(initialises)g(its)h(attributes.)227
+%%Page: 396 406
+TeXDict begin 396 405 bop 0 52 a FF(396)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 482 a Fz(astT)-11 b(ranMap)699 b Fe(Create)37 b(a)i(T)-10
+b(ranMap)698 b Fz(astT)-11 b(ranMap)0 641 y Fd(Description:)44
+b Fi(This)28 b(function)g(creates)f(a)g(new)g(T)-7 b(ranMap)27
+b(and)g(optionally)g(initialises)g(its)h(attributes.)227
758 y(A)f(T)-7 b(ranMap)26 b(is)g(a)h(Mapping)f(whic)n(h)g(com)n(bines)
g(the)h(forw)n(ard)e(transformation)g(of)i(a)f(supplied)h(Mapping)f
(with)227 858 y(the)34 b(in)n(v)n(erse)d(transformation)g(of)i(another)
@@ -127887,10 +127997,9 @@ b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g
b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)
e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fi(in)n(t)227
5658 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p eop end
-%%Page: 396 406
-TeXDict begin 396 405 bop 0 52 a FF(396)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 482 a Fz(astT)-11 b(ranN)930 483 y Fe(T)h(ransform)36
+%%Page: 397 407
+TeXDict begin 397 406 bop 3643 52 a FF(397)p 0 351 3780
+12 v 0 482 a Fz(astT)-11 b(ranN)930 483 y Fe(T)h(ransform)36
b(N-dimensional)g(co)s(ordinates)3226 482 y Fz(astT)-11
b(ranN)0 639 y Fd(Description:)44 b Fi(This)37 b(function)f(applies)g
(a)g(Mapping)g(to)g(transform)f(the)h(co)r(ordinates)f(of)h(a)g(set)g
@@ -127975,9 +128084,10 @@ Ft(")f Fi(for)h(its)h(Nout)427 5632 y(attribute.)i(If)28
b(the)g(in)n(v)n(erse)e(transformation)g(is)i(b)r(eing)g(applied,)f
(these)h(v)-5 b(alues)27 b(should)g(b)r(e)h(rev)n(ersed.)p
eop end
-%%Page: 397 407
-TeXDict begin 397 406 bop 3643 52 a FF(397)p 0 351 3780
-12 v 0 482 a Fz(astT)-11 b(ranP)734 483 y Fe(T)h(ransform)37
+%%Page: 398 408
+TeXDict begin 398 407 bop 0 52 a FF(398)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 482 a Fz(astT)-11 b(ranP)734 483 y Fe(T)h(ransform)37
b(N-dimensional)f(co)s(ordinates)h(held)i(in)1502 583
y(separate)f(arra)m(ys)3240 482 y Fz(astT)-11 b(ranP)0
803 y Fd(Description:)44 b Fi(This)37 b(function)f(applies)g(a)g
@@ -128056,41 +128166,41 @@ Fi(nco)r(ord)p Ft(_)p Fi(out)p Ft(")f Fi(for)h(its)h(Nout)427
(ersed.)340 5611 y Fh(\017)45 b Fi(This)28 b(routine)f(is)h(not)f(a)n
(v)-5 b(ailable)26 b(in)i(the)g(F)-7 b(ortran)27 b(77)f(in)n(terface)h
(to)h(the)g(AST)g(library)-7 b(.)p eop end
-%%Page: 398 408
-TeXDict begin 398 407 bop 0 52 a FF(398)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 482 a Fz(astT)-11 b(une)685 483 y Fe(Set)39 b(or)f(get)g(an)g(in)m
-(teger-v)-7 b(alued)37 b(AST)h(global)f(tuning)1630 583
-y(parameter)3316 482 y Fz(astT)-11 b(une)0 773 y Fd(Description:)44
-b Fi(This)23 b(function)g(returns)f(the)g(curren)n(t)g(v)-5
-b(alue)22 b(of)h(an)f(in)n(teger-v)-5 b(alued)21 b(AST)i(global)e
-(tuning)i(parameter,)227 873 y(optionally)37 b(storing)f(a)g(new)i(v)-5
-b(alue)37 b(for)f(the)i(parameter.)64 b(F)-7 b(or)37
-b(c)n(haracter-v)-5 b(alued)35 b(tuning)i(parameters,)h(see)227
-973 y(astT)-7 b(uneC.)0 1124 y Fd(Synopsis:)121 b Ft(int)42
-b(astTune\()e(const)i(char)g Fh(\003)p Ft(name,)f(int)h(value)g(\))0
-1275 y Fd(P)m(arameters:)259 1413 y(name)427 1513 y Fi(The)28
-b(name)f(of)h(the)g(tuning)g(parameter)e(\(case-insensitiv)n(e\).)259
-1647 y Fd(v)-5 b(alue)427 1746 y Fi(The)22 b(new)g(v)-5
-b(alue)22 b(for)f(the)h(tuning)g(parameter.)34 b(If)22
-b(this)g(is)g(AST)p Ft(__)p Fi(TUNULL,)g(the)g(existing)g(curren)n(t)f
-(v)-5 b(alue)427 1846 y(will)28 b(b)r(e)g(retained.)0
-2010 y Fd(Returned)k(V)-8 b(alue:)259 2148 y(astT)g(une\(\))427
-2248 y Fi(The)29 b(original)e(v)-5 b(alue)29 b(of)g(the)g(tuning)g
-(parameter.)39 b(A)29 b(default)g(v)-5 b(alue)28 b(will)h(b)r(e)h
-(returned)e(if)h(no)g(v)-5 b(alue)28 b(has)427 2347 y(b)r(een)g(set)g
-(for)f(the)h(parameter.)0 2511 y Fd(Notes:)340 2795 y
-Fh(\017)45 b Fi(This)30 b(function)h(attempts)f(to)g(execute)g(ev)n(en)
-g(if)g(the)g(AST)h(error)d(status)i(is)g(set)g(on)f(en)n(try)-7
-b(,)31 b(although)e(no)427 2895 y(further)f(error)d(rep)r(ort)i(will)h
-(b)r(e)g(made)f(if)i(it)f(subsequen)n(tly)f(fails)g(under)h(these)f
-(circumstances.)340 3029 y Fh(\017)45 b Fi(All)28 b(threads)f(in)h(a)f
-(pro)r(cess)g(share)f(the)i(same)f(AST)h(tuning)g(parameters)e(v)-5
-b(alues.)32 3193 y Fd(T)d(uning)31 b(P)m(arameters)i(:)259
-3331 y(Ob)5 b(jectCac)m(hing)427 3430 y Fi(A)38 b(b)r(o)r(olean)f
-(\015ag)g(whic)n(h)h(indicates)f(what)h(should)f(happ)r(en)h(to)g(the)g
-(memory)f(o)r(ccupied)g(b)n(y)h(an)f(AST)427 3530 y(Ob)5
-b(ject)28 b(when)h(the)f(Ob)5 b(ject)29 b(is)f(deleted)g(\(i.e.)40
+%%Page: 399 409
+TeXDict begin 399 408 bop 3643 52 a FF(399)p 0 351 3780
+12 v 0 482 a Fz(astT)-11 b(une)685 483 y Fe(Set)39 b(or)f(get)g(an)g
+(in)m(teger-v)-7 b(alued)37 b(AST)h(global)f(tuning)1630
+583 y(parameter)3316 482 y Fz(astT)-11 b(une)0 773 y
+Fd(Description:)44 b Fi(This)23 b(function)g(returns)f(the)g(curren)n
+(t)g(v)-5 b(alue)22 b(of)h(an)f(in)n(teger-v)-5 b(alued)21
+b(AST)i(global)e(tuning)i(parameter,)227 873 y(optionally)37
+b(storing)f(a)g(new)i(v)-5 b(alue)37 b(for)f(the)i(parameter.)64
+b(F)-7 b(or)37 b(c)n(haracter-v)-5 b(alued)35 b(tuning)i(parameters,)h
+(see)227 973 y(astT)-7 b(uneC.)0 1124 y Fd(Synopsis:)121
+b Ft(int)42 b(astTune\()e(const)i(char)g Fh(\003)p Ft(name,)f(int)h
+(value)g(\))0 1275 y Fd(P)m(arameters:)259 1413 y(name)427
+1513 y Fi(The)28 b(name)f(of)h(the)g(tuning)g(parameter)e
+(\(case-insensitiv)n(e\).)259 1647 y Fd(v)-5 b(alue)427
+1746 y Fi(The)22 b(new)g(v)-5 b(alue)22 b(for)f(the)h(tuning)g
+(parameter.)34 b(If)22 b(this)g(is)g(AST)p Ft(__)p Fi(TUNULL,)g(the)g
+(existing)g(curren)n(t)f(v)-5 b(alue)427 1846 y(will)28
+b(b)r(e)g(retained.)0 2010 y Fd(Returned)k(V)-8 b(alue:)259
+2148 y(astT)g(une\(\))427 2248 y Fi(The)29 b(original)e(v)-5
+b(alue)29 b(of)g(the)g(tuning)g(parameter.)39 b(A)29
+b(default)g(v)-5 b(alue)28 b(will)h(b)r(e)h(returned)e(if)h(no)g(v)-5
+b(alue)28 b(has)427 2347 y(b)r(een)g(set)g(for)f(the)h(parameter.)0
+2511 y Fd(Notes:)340 2795 y Fh(\017)45 b Fi(This)30 b(function)h
+(attempts)f(to)g(execute)g(ev)n(en)g(if)g(the)g(AST)h(error)d(status)i
+(is)g(set)g(on)f(en)n(try)-7 b(,)31 b(although)e(no)427
+2895 y(further)f(error)d(rep)r(ort)i(will)h(b)r(e)g(made)f(if)i(it)f
+(subsequen)n(tly)f(fails)g(under)h(these)f(circumstances.)340
+3029 y Fh(\017)45 b Fi(All)28 b(threads)f(in)h(a)f(pro)r(cess)g(share)f
+(the)i(same)f(AST)h(tuning)g(parameters)e(v)-5 b(alues.)32
+3193 y Fd(T)d(uning)31 b(P)m(arameters)i(:)259 3331 y(Ob)5
+b(jectCac)m(hing)427 3430 y Fi(A)38 b(b)r(o)r(olean)f(\015ag)g(whic)n
+(h)h(indicates)f(what)h(should)f(happ)r(en)h(to)g(the)g(memory)f(o)r
+(ccupied)g(b)n(y)h(an)f(AST)427 3530 y(Ob)5 b(ject)28
+b(when)h(the)f(Ob)5 b(ject)29 b(is)f(deleted)g(\(i.e.)40
b(when)28 b(its)g(reference)g(coun)n(t)g(falls)g(to)g(zero)f(or)g(it)i
(is)f(deleted)427 3630 y(using)22 b(astDelete\).)36 b(If)23
b(this)f(is)g(zero,)h(the)g(memory)e(is)h(simply)h(freed)f(using)g(the)
@@ -128130,8 +128240,9 @@ b(of)h(a)e(c)n(haracter-v)-5 b(alued)28 b(AST)j(global)e(tuning)h
b(alue)29 b(for)h(the)g(parameter.)42 b(F)-7 b(or)29
b(in)n(teger-v)-5 b(alued)29 b(tuning)h(parameters,)f(see)227
5693 y(astT)-7 b(une.)p eop end
-%%Page: 399 409
-TeXDict begin 399 408 bop 3643 52 a FF(399)0 351 y Fd(Synopsis:)121
+%%Page: 400 410
+TeXDict begin 400 409 bop 0 52 a FF(400)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Synopsis:)121
b Ft(void)42 b(astTuneC\()e(const)h(char)h Fh(\003)p
Ft(name,)f(const)h(char)g Fh(\003)p Ft(value,)e(char)i
Fh(\003)p Ft(buff,)f(int)h(bufflen)f(\))0 512 y Fd(P)m(arameters:)259
@@ -128210,68 +128321,67 @@ Ft(")p Fi(g)p Ft(")e Fi(format)i(is)g(in)g(use.)47 b(The)427
Fh(^)p Fi(50+\045s70+)p Ft(")c Fi(whic)n(h)36 b(pro)r(duces)f
Ft(")p Fi(10)p Ft(")e Fi(follo)n(w)n(ed)i(b)n(y)g(the)h(exp)r(onen)n(t)
f(as)g(a)427 5621 y(sup)r(er-script.)p eop end
-%%Page: 400 410
-TeXDict begin 400 409 bop 0 52 a FF(400)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 483 a Fz(astUin)l(terp)213 b Fe(P)m(erform)36 b(sub-pixel)i(in)m
-(terp)s(olation)d(on)k(a)f(grid)1709 598 y(of)h(data)3154
-483 y Fz(astUin)l(terp)0 751 y Fd(Description:)44 b Fi(This)31
-b(is)f(a)h(\014ctitious)f(function)h(whic)n(h)g(do)r(es)f(not)h
-(actually)f(exist.)45 b(Instead,)31 b(this)g(description)f(con-)227
-851 y(stitutes)c(a)f(template)g(so)g(that)g(y)n(ou)f(ma)n(y)h(implemen)
-n(t)h(a)e(function)i(with)g(this)f(in)n(terface)g(for)f(y)n(ourself)g
-(\(and)i(giv)n(e)227 951 y(it)32 b(an)n(y)e(name)g(y)n(ou)h(wish\).)47
-b(A)31 b(p)r(oin)n(ter)f(to)h(suc)n(h)g(a)f(function)i(ma)n(y)e(b)r(e)h
-(passed)f(via)h(the)g Ft(")p Fi(\014n)n(terp)p Ft(")f
-Fi(parameter)227 1050 y(of)25 b(the)g(astResample)p Fk(<)p
-Fi(X)p Fk(>)f Fi(functions)h(\(q.v.\))36 b(in)25 b(order)e(to)i(p)r
-(erform)f(sub-pixel)h(in)n(terp)r(olation)f(during)g(resam-)227
-1150 y(pling)k(of)g(gridded)f(data)g(\(y)n(ou)g(m)n(ust)h(also)f(set)g
-(the)h Ft(")p Fi(in)n(terp)p Ft(")f Fi(parameter)f(of)i(astResample)p
-Fk(<)p Fi(X)p Fk(>)e Fi(to)i(the)g(v)-5 b(alue)227 1249
-y(AST)p Ft(__)p Fi(UINTERP\).)30 b(This)h(allo)n(ws)e(y)n(ou)g(to)i
-(use)f(y)n(our)f(o)n(wn)h(in)n(terp)r(olation)f(algorithm)h(in)g
-(addition)h(to)f(those)227 1349 y(whic)n(h)e(are)e(pre-de\014ned.)227
-1471 y(The)35 b(function)g(in)n(terp)r(olates)e(an)h(input)h(grid)f(of)
-g(data)g(\(and,)i(optionally)-7 b(,)35 b(pro)r(cesses)e(asso)r(ciated)g
-(statistical)227 1570 y(v)-5 b(ariance)27 b(estimates\))g(at)h(a)f(sp)r
-(eci\014ed)h(set)f(of)h(p)r(oin)n(ts.)0 1714 y Fd(Synopsis:)121
-b Ft(void)42 b(astUinterp\()d(int)j(ndim_in,)e(const)i(int)g
-(lbnd_in[],)e(const)h(int)i(ubnd_in[],)c(const)227 1813
-y Fk(<)p Ft(Xtype)p Fk(>)i Ft(in[],)g(const)h Fk(<)p
-Ft(Xtype)p Fk(>)f Ft(in_var[],)e(int)k(npoint,)e(const)g(int)h
-(offset[],)e(const)i(double)227 1913 y Fh(\003)p Ft(const)f(coords[],)f
-(const)i(double)f(params[],)f(int)i(flags,)f Fk(<)p Ft(Xtype)p
-Fk(>)g Ft(badval,)f Fk(<)p Ft(Xtype)p Fk(>)h Ft(out[],)227
-2013 y Fk(<)p Ft(Xtype)p Fk(>)g Ft(out_var[],)e(int)k
-Fh(\003)p Ft(nbad)e(\))0 2156 y Fd(P)m(arameters:)259
-2287 y(ndim)p Ft(_)p Fd(in)427 2386 y Fi(The)28 b(n)n(um)n(b)r(er)f(of)
-h(dimensions)f(in)h(the)g(input)g(grid.)36 b(This)28
-b(will)g(b)r(e)g(at)f(least)h(one.)259 2513 y Fd(lbnd)p
-Ft(_)p Fd(in)427 2613 y Fi(P)n(oin)n(ter)h(to)i(an)f(arra)n(y)e(of)j
-(in)n(tegers,)f(with)h Ft(")p Fi(ndim)p Ft(_)p Fi(in)p
-Ft(")f Fi(elemen)n(ts,)h(con)n(taining)f(the)h(co)r(ordinates)e(of)h
-(the)427 2712 y(cen)n(tre)d(of)h(the)g(\014rst)f(pixel)h(in)g(the)g
-(input)g(grid)f(along)f(eac)n(h)h(dimension.)259 2839
-y Fd(ubnd)p Ft(_)p Fd(in)427 2939 y Fi(P)n(oin)n(ter)i(to)i(an)f(arra)n
-(y)e(of)j(in)n(tegers,)f(with)h Ft(")p Fi(ndim)p Ft(_)p
-Fi(in)p Ft(")f Fi(elemen)n(ts,)h(con)n(taining)f(the)h(co)r(ordinates)e
-(of)h(the)427 3039 y(cen)n(tre)d(of)h(the)g(last)f(pixel)h(in)g(the)g
-(input)g(grid)f(along)f(eac)n(h)h(dimension.)427 3152
-y(Note)f(that)g Ft(")p Fi(lbnd)p Ft(_)p Fi(in)p Ft(")e
-Fi(and)i Ft(")p Fi(ubnd)p Ft(_)p Fi(in)p Ft(")f Fi(together)f(de\014ne)
-i(the)g(shap)r(e,)g(size)f(and)g(co)r(ordinate)f(system)i(of)427
-3252 y(the)i(input)h(grid)e(in)g(the)h(same)f(w)n(a)n(y)g(as)g(they)g
-(do)h(in)g(astResample)p Fk(<)p Fi(X)p Fk(>)p Fi(.)259
-3378 y Fd(in)427 3478 y Fi(P)n(oin)n(ter)h(to)i(an)f(arra)n(y)-7
-b(,)30 b(with)h(one)f(elemen)n(t)h(for)g(eac)n(h)f(pixel)g(in)h(the)g
-(input)h(grid,)f(con)n(taining)f(the)h(input)427 3578
-y(data.)k(This)24 b(will)h(b)r(e)f(the)g(same)g(arra)n(y)d(as)i(w)n(as)
-g(passed)h(to)f(astResample)p Fk(<)p Fi(X)p Fk(>)g Fi(via)g(the)i
-Ft(")p Fi(in)p Ft(")e Fi(parameter.)427 3677 y(The)28
-b(n)n(umerical)f(t)n(yp)r(e)g(of)h(this)g(arra)n(y)d(should)j(matc)n(h)
-f(that)h(of)f(the)h(data)f(b)r(eing)h(pro)r(cessed.)259
-3804 y Fd(in)p Ft(_)p Fd(v)-5 b(ar)427 3904 y Fi(P)n(oin)n(ter)27
+%%Page: 401 411
+TeXDict begin 401 410 bop 3643 52 a FF(401)p 0 351 3780
+12 v 0 483 a Fz(astUin)l(terp)213 b Fe(P)m(erform)36
+b(sub-pixel)i(in)m(terp)s(olation)d(on)k(a)f(grid)1709
+598 y(of)h(data)3154 483 y Fz(astUin)l(terp)0 751 y Fd(Description:)44
+b Fi(This)31 b(is)f(a)h(\014ctitious)f(function)h(whic)n(h)g(do)r(es)f
+(not)h(actually)f(exist.)45 b(Instead,)31 b(this)g(description)f(con-)
+227 851 y(stitutes)c(a)f(template)g(so)g(that)g(y)n(ou)f(ma)n(y)h
+(implemen)n(t)h(a)e(function)i(with)g(this)f(in)n(terface)g(for)f(y)n
+(ourself)g(\(and)i(giv)n(e)227 951 y(it)32 b(an)n(y)e(name)g(y)n(ou)h
+(wish\).)47 b(A)31 b(p)r(oin)n(ter)f(to)h(suc)n(h)g(a)f(function)i(ma)n
+(y)e(b)r(e)h(passed)f(via)h(the)g Ft(")p Fi(\014n)n(terp)p
+Ft(")f Fi(parameter)227 1050 y(of)25 b(the)g(astResample)p
+Fk(<)p Fi(X)p Fk(>)f Fi(functions)h(\(q.v.\))36 b(in)25
+b(order)e(to)i(p)r(erform)f(sub-pixel)h(in)n(terp)r(olation)f(during)g
+(resam-)227 1150 y(pling)k(of)g(gridded)f(data)g(\(y)n(ou)g(m)n(ust)h
+(also)f(set)g(the)h Ft(")p Fi(in)n(terp)p Ft(")f Fi(parameter)f(of)i
+(astResample)p Fk(<)p Fi(X)p Fk(>)e Fi(to)i(the)g(v)-5
+b(alue)227 1249 y(AST)p Ft(__)p Fi(UINTERP\).)30 b(This)h(allo)n(ws)e
+(y)n(ou)g(to)i(use)f(y)n(our)f(o)n(wn)h(in)n(terp)r(olation)f
+(algorithm)h(in)g(addition)h(to)f(those)227 1349 y(whic)n(h)e(are)e
+(pre-de\014ned.)227 1471 y(The)35 b(function)g(in)n(terp)r(olates)e(an)
+h(input)h(grid)f(of)g(data)g(\(and,)i(optionally)-7 b(,)35
+b(pro)r(cesses)e(asso)r(ciated)g(statistical)227 1570
+y(v)-5 b(ariance)27 b(estimates\))g(at)h(a)f(sp)r(eci\014ed)h(set)f(of)
+h(p)r(oin)n(ts.)0 1714 y Fd(Synopsis:)121 b Ft(void)42
+b(astUinterp\()d(int)j(ndim_in,)e(const)i(int)g(lbnd_in[],)e(const)h
+(int)i(ubnd_in[],)c(const)227 1813 y Fk(<)p Ft(Xtype)p
+Fk(>)i Ft(in[],)g(const)h Fk(<)p Ft(Xtype)p Fk(>)f Ft(in_var[],)e(int)k
+(npoint,)e(const)g(int)h(offset[],)e(const)i(double)227
+1913 y Fh(\003)p Ft(const)f(coords[],)f(const)i(double)f(params[],)f
+(int)i(flags,)f Fk(<)p Ft(Xtype)p Fk(>)g Ft(badval,)f
+Fk(<)p Ft(Xtype)p Fk(>)h Ft(out[],)227 2013 y Fk(<)p
+Ft(Xtype)p Fk(>)g Ft(out_var[],)e(int)k Fh(\003)p Ft(nbad)e(\))0
+2156 y Fd(P)m(arameters:)259 2287 y(ndim)p Ft(_)p Fd(in)427
+2386 y Fi(The)28 b(n)n(um)n(b)r(er)f(of)h(dimensions)f(in)h(the)g
+(input)g(grid.)36 b(This)28 b(will)g(b)r(e)g(at)f(least)h(one.)259
+2513 y Fd(lbnd)p Ft(_)p Fd(in)427 2613 y Fi(P)n(oin)n(ter)h(to)i(an)f
+(arra)n(y)e(of)j(in)n(tegers,)f(with)h Ft(")p Fi(ndim)p
+Ft(_)p Fi(in)p Ft(")f Fi(elemen)n(ts,)h(con)n(taining)f(the)h(co)r
+(ordinates)e(of)h(the)427 2712 y(cen)n(tre)d(of)h(the)g(\014rst)f
+(pixel)h(in)g(the)g(input)g(grid)f(along)f(eac)n(h)h(dimension.)259
+2839 y Fd(ubnd)p Ft(_)p Fd(in)427 2939 y Fi(P)n(oin)n(ter)i(to)i(an)f
+(arra)n(y)e(of)j(in)n(tegers,)f(with)h Ft(")p Fi(ndim)p
+Ft(_)p Fi(in)p Ft(")f Fi(elemen)n(ts,)h(con)n(taining)f(the)h(co)r
+(ordinates)e(of)h(the)427 3039 y(cen)n(tre)d(of)h(the)g(last)f(pixel)h
+(in)g(the)g(input)g(grid)f(along)f(eac)n(h)h(dimension.)427
+3152 y(Note)f(that)g Ft(")p Fi(lbnd)p Ft(_)p Fi(in)p
+Ft(")e Fi(and)i Ft(")p Fi(ubnd)p Ft(_)p Fi(in)p Ft(")f
+Fi(together)f(de\014ne)i(the)g(shap)r(e,)g(size)f(and)g(co)r(ordinate)f
+(system)i(of)427 3252 y(the)i(input)h(grid)e(in)g(the)h(same)f(w)n(a)n
+(y)g(as)g(they)g(do)h(in)g(astResample)p Fk(<)p Fi(X)p
+Fk(>)p Fi(.)259 3378 y Fd(in)427 3478 y Fi(P)n(oin)n(ter)h(to)i(an)f
+(arra)n(y)-7 b(,)30 b(with)h(one)f(elemen)n(t)h(for)g(eac)n(h)f(pixel)g
+(in)h(the)g(input)h(grid,)f(con)n(taining)f(the)h(input)427
+3578 y(data.)k(This)24 b(will)h(b)r(e)f(the)g(same)g(arra)n(y)d(as)i(w)
+n(as)g(passed)h(to)f(astResample)p Fk(<)p Fi(X)p Fk(>)g
+Fi(via)g(the)i Ft(")p Fi(in)p Ft(")e Fi(parameter.)427
+3677 y(The)28 b(n)n(umerical)f(t)n(yp)r(e)g(of)h(this)g(arra)n(y)d
+(should)j(matc)n(h)f(that)h(of)f(the)h(data)f(b)r(eing)h(pro)r(cessed.)
+259 3804 y Fd(in)p Ft(_)p Fd(v)-5 b(ar)427 3904 y Fi(P)n(oin)n(ter)27
b(to)i(an)g(optional)f(second)g(arra)n(y)e(with)k(the)f(same)f(size)h
(and)f(t)n(yp)r(e)h(as)f(the)i Ft(")p Fi(in)p Ft(")e
Fi(arra)n(y)-7 b(.)38 b(If)29 b(giv)n(en,)427 4003 y(this)35
@@ -128315,11 +128425,12 @@ Ft(")f Fi(is)h(therefore)f(giv)n(en)h(b)n(y)g Ft(")p
Fi(co)r(ords[co)r(ord][p)r(oin)n(t])p Ft(")427 5693 y
Fi(\(assuming)d(b)r(oth)h(indices)g(are)e(zero-based\).)p
eop end
-%%Page: 401 411
-TeXDict begin 401 410 bop 3643 52 a FF(401)427 351 y
-Fi(If)42 b(an)n(y)f(in)n(terp)r(olation)f(p)r(oin)n(t)i(has)f(an)n(y)f
-(of)i(its)f(co)r(ordinates)f(equal)h(to)g(the)h(v)-5
-b(alue)42 b(AST)p Ft(__)p Fi(BAD)f(\(as)427 451 y(de\014ned)26
+%%Page: 402 412
+TeXDict begin 402 411 bop 0 52 a FF(402)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)427 351 y Fi(If)42
+b(an)n(y)f(in)n(terp)r(olation)f(p)r(oin)n(t)i(has)f(an)n(y)f(of)i(its)
+f(co)r(ordinates)f(equal)h(to)g(the)h(v)-5 b(alue)42
+b(AST)p Ft(__)p Fi(BAD)f(\(as)427 451 y(de\014ned)26
b(in)f(the)g Ft(")p Fi(ast.h)p Ft(")f Fi(header)g(\014le\),)i(then)f
(the)g(corresp)r(onding)e(output)j(data)e(\(and)h(v)-5
b(ariance\))24 b(should)427 551 y(either)33 b(b)r(e)g(set)f(to)h(the)g
@@ -128426,16 +128537,15 @@ b(ailable)28 b(for)g(this)i(purp)r(ose,)f(but)h(other)e(v)-5
b(alues)29 b(ma)n(y)f(also)g(b)r(e)i(used)f(\(e.g.)41
b(if)427 5636 y(y)n(ou)27 b(wish)h(to)f(distinguish)h(di\013eren)n(t)f
(t)n(yp)r(es)h(of)g(error\).)p eop end
-%%Page: 402 412
-TeXDict begin 402 411 bop 0 52 a FF(402)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 483 a Fz(astUk)l(ern1)171 b Fe(1-dimensional)36 b(sub-pixel)i(in)m
-(terp)s(olation)d(k)m(ernel)168 b Fz(astUk)l(ern1)0 719
-y Fd(Description:)44 b Fi(This)31 b(is)f(a)h(\014ctitious)f(function)h
-(whic)n(h)g(do)r(es)f(not)h(actually)f(exist.)45 b(Instead,)31
-b(this)g(description)f(con-)227 819 y(stitutes)c(a)f(template)g(so)g
-(that)g(y)n(ou)f(ma)n(y)h(implemen)n(t)h(a)e(function)i(with)g(this)f
-(in)n(terface)g(for)f(y)n(ourself)g(\(and)i(giv)n(e)227
+%%Page: 403 413
+TeXDict begin 403 412 bop 3643 52 a FF(403)p 0 351 3780
+12 v 0 483 a Fz(astUk)l(ern1)171 b Fe(1-dimensional)36
+b(sub-pixel)i(in)m(terp)s(olation)d(k)m(ernel)168 b Fz(astUk)l(ern1)0
+719 y Fd(Description:)44 b Fi(This)31 b(is)f(a)h(\014ctitious)f
+(function)h(whic)n(h)g(do)r(es)f(not)h(actually)f(exist.)45
+b(Instead,)31 b(this)g(description)f(con-)227 819 y(stitutes)c(a)f
+(template)g(so)g(that)g(y)n(ou)f(ma)n(y)h(implemen)n(t)h(a)e(function)i
+(with)g(this)f(in)n(terface)g(for)f(y)n(ourself)g(\(and)i(giv)n(e)227
918 y(it)g(an)n(y)f(name)h(y)n(ou)f(wish\).)37 b(A)26
b(p)r(oin)n(ter)f(to)h(suc)n(h)f(a)h(function)g(ma)n(y)f(b)r(e)h
(passed)f(via)g(the)i Ft(")p Fi(\014n)n(terp)p Ft(")d
@@ -128519,9 +128629,10 @@ b(error)427 5499 y(v)-5 b(alue)28 b(AST)p Ft(__)p Fi(UK1ER)f(is)i(a)n
b(alues)27 b(ma)n(y)h(also)f(b)r(e)i(used)f(\(e.g.)39
b(if)427 5599 y(y)n(ou)27 b(wish)h(to)f(distinguish)h(di\013eren)n(t)f
(t)n(yp)r(es)h(of)g(error\).)p eop end
-%%Page: 403 413
-TeXDict begin 403 412 bop 3643 52 a FF(403)p 0 351 3780
-12 v 0 483 a Fz(astUnformat)170 b Fe(Read)39 b(a)g(formatted)d(co)s
+%%Page: 404 414
+TeXDict begin 404 413 bop 0 52 a FF(404)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 483 a Fz(astUnformat)170 b Fe(Read)39 b(a)g(formatted)d(co)s
(ordinate)g(v)-7 b(alue)38 b(for)1562 583 y(a)g(F)-10
b(rame)39 b(axis)3038 483 y Fz(astUnformat)0 775 y Fd(Description:)44
b Fi(This)24 b(function)g(reads)e(a)h(formatted)h(co)r(ordinate)e(v)-5
@@ -128588,10 +128699,9 @@ b(alue)36 b(of)g(zero)f(\(and)h(no)g(co)r(ordinate)f(v)-5
b(alue\))36 b(will)h(b)r(e)f(returned,)i(without)e(error,)h(if)f(the)
427 5693 y(string)27 b(supplied)h(do)r(es)f(not)h(con)n(tain)f(a)g
(suitably)g(formatted)h(v)-5 b(alue.)p eop end
-%%Page: 404 414
-TeXDict begin 404 413 bop 0 52 a FF(404)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
-b Fi(Bew)n(are)20 b(that)h(it)g(is)g(p)r(ossible)g(for)g(a)f
+%%Page: 405 415
+TeXDict begin 405 414 bop 3643 52 a FF(405)340 351 y
+Fh(\017)45 b Fi(Bew)n(are)20 b(that)h(it)g(is)g(p)r(ossible)g(for)g(a)f
(formatting)h(error)e(part-w)n(a)n(y)g(through)h(an)h(input)g(string)g
(to)g(terminate)427 451 y(input)29 b(b)r(efore)e(it)h(has)f(b)r(een)h
(completely)f(read,)g(but)h(to)g(yield)f(a)g(co)r(ordinate)g(v)-5
@@ -128685,11 +128795,12 @@ b(m)n(ust)h(b)r(e)g(giv)n(en)f(in)h(order)f(of)g(decreasing)g
(signi\014cance)427 5693 y(\(e.g.)k Ft(")p Fi(-11D)26
b(3')i(14.4)p Ft("")d Fi(or)i Ft(")p Fi(22h14m11.2s)p
Ft(")p Fi(\).)p eop end
-%%Page: 405 415
-TeXDict begin 405 414 bop 3643 52 a FF(405)340 351 y
-Fh(\017)45 b Fi(The)22 b(presence)e(of)h(an)n(y)g(of)g(the)h(\014eld)f
-(iden)n(ti\014cation)g(c)n(haracters)e Ft(")p Fi(d)p
-Ft(")p Fi(,)j Ft(")p Fi(')p Ft(")f Fi(\(single)g(quote\))g(or)f
+%%Page: 406 416
+TeXDict begin 406 415 bop 0 52 a FF(406)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Fi(The)22 b(presence)e(of)h(an)n(y)g(of)g(the)h(\014eld)f(iden)n
+(ti\014cation)g(c)n(haracters)e Ft(")p Fi(d)p Ft(")p
+Fi(,)j Ft(")p Fi(')p Ft(")f Fi(\(single)g(quote\))g(or)f
Ft(""")g Fi(\(double)427 451 y(quote\))g(indicates)f(that)h(the)f(v)-5
b(alue)20 b(is)f(to)g(b)r(e)h(in)n(terpreted)f(as)g(an)g(angle.)33
b(Con)n(v)n(ersely)-7 b(,)19 b(the)h(presence)f(of)g
@@ -128773,10 +128884,9 @@ b Fi(\(AST)p Ft(__)p Fi(BAD\))227 5498 y(Where)e(alternativ)n(e)e(in)n
(terpretations)g(are)h(sho)n(wn,)g(the)h(c)n(hoice)f(of)g(angle)g(or)g
(time)h(dep)r(ends)g(on)f(the)h(asso)r(ciated)227 5598
y(F)-7 b(ormat\(axis\))27 b(attribute.)p eop end
-%%Page: 406 416
-TeXDict begin 406 415 bop 0 52 a FF(406)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
-0 483 a Fz(astUnitMap)1422 482 y Fe(Create)37 b(a)h(UnitMap)3073
+%%Page: 407 417
+TeXDict begin 407 416 bop 3643 52 a FF(407)p 0 351 3780
+12 v 0 483 a Fz(astUnitMap)1422 482 y Fe(Create)37 b(a)h(UnitMap)3073
483 y Fz(astUnitMap)0 662 y Fd(Description:)44 b Fi(This)28
b(function)g(creates)f(a)g(new)g(UnitMap)i(and)e(optionally)g
(initialises)g(its)h(attributes.)227 784 y(A)f(UnitMap)f(is)g(a)f(unit)
@@ -128835,16 +128945,17 @@ b(zero,)f(suc)n(h)h(Ob)5 b(jects)25 b(will)427 5027 y(b)r(e)j(left)h
5184 y Fd(Class)j(Applicabilit)m(y:)259 5316 y(Ob)5 b(ject)427
5415 y Fi(This)28 b(function)g(applies)f(to)h(all)f(Ob)5
b(jects.)0 5572 y Fd(Notes:)p eop end
-%%Page: 407 417
-TeXDict begin 407 416 bop 3643 52 a FF(407)340 351 y
-Fh(\017)45 b Fi(This)29 b(function)h(attempts)g(to)f(execute)g(ev)n(en)
-g(if)h(the)f(global)f(error)g(status)h(is)g(set,)h(but)f(no)g(further)h
-(error)427 451 y(rep)r(ort)d(will)h(b)r(e)g(made)f(if)h(it)g(subsequen)
-n(tly)g(fails)f(under)g(these)h(circumstances.)340 585
-y Fh(\017)45 b Fi(All)28 b(unlo)r(c)n(k)n(ed)e(Ob)5 b(jects)26
-b(are)g(excluded)h(from)f(AST)i(con)n(text)e(handling)h(un)n(til)g
-(they)g(are)f(re-lo)r(c)n(k)n(ed)f(using)427 684 y(astLo)r(c)n(k.)340
-818 y Fh(\017)45 b Fi(This)28 b(function)g(is)f(only)h(a)n(v)-5
+%%Page: 408 418
+TeXDict begin 408 417 bop 0 52 a FF(408)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Fi(This)29 b(function)h(attempts)g(to)f(execute)g(ev)n(en)g(if)h(the)
+f(global)f(error)g(status)h(is)g(set,)h(but)f(no)g(further)h(error)427
+451 y(rep)r(ort)d(will)h(b)r(e)g(made)f(if)h(it)g(subsequen)n(tly)g
+(fails)f(under)g(these)h(circumstances.)340 585 y Fh(\017)45
+b Fi(All)28 b(unlo)r(c)n(k)n(ed)e(Ob)5 b(jects)26 b(are)g(excluded)h
+(from)f(AST)i(con)n(text)e(handling)h(un)n(til)g(they)g(are)f(re-lo)r
+(c)n(k)n(ed)f(using)427 684 y(astLo)r(c)n(k.)340 818
+y Fh(\017)45 b Fi(This)28 b(function)g(is)f(only)h(a)n(v)-5
b(ailable)26 b(in)i(the)g(C)f(in)n(terface.)340 952 y
Fh(\017)45 b Fi(This)30 b(function)g(returns)f(without)h(action)g(if)g
(the)g(Ob)5 b(ject)29 b(is)h(not)g(curren)n(tly)e(lo)r(c)n(k)n(ed)h(b)n
@@ -128909,53 +129020,53 @@ b Ft(AstKeyMap)40 b Fh(\003)p Ft(astWarnings\()e(AstChannel)h
Fh(\003)p Ft(this)j(\))0 5455 y Fd(P)m(arameters:)259
5593 y(this)427 5693 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(Channel.)p
eop end
-%%Page: 408 418
-TeXDict begin 408 417 bop 0 52 a FF(408)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Class)h(Applicabilit)m
-(y:)259 478 y(Channel)427 578 y Fi(The)25 b(basic)f(Channel)h(class)f
-(generates)f(a)h(w)n(arning)g(when)g(ev)n(er)g(an)h(un-recognised)e
-(item)i(is)f(encoun)n(tered)427 677 y(whilst)32 b(reading)f(an)g(Ob)5
-b(ject)32 b(from)f(an)g(external)g(data)g(source.)48
-b(If)32 b(Strict)g(is)g(zero)e(\(the)j(default\),)g(then)427
-777 y(unexp)r(ected)28 b(items)f(in)g(the)g(Ob)5 b(ject)27
-b(description)g(are)f(simply)h(ignored,)e(and)i(an)n(y)f(remaining)g
-(items)i(are)427 876 y(used)h(to)g(construct)g(the)g(returned)f(Ob)5
-b(ject.)41 b(If)30 b(Strict)f(is)g(non-zero,)f(an)g(error)f(will)j(b)r
-(e)f(rep)r(orted)f(and)h(a)427 976 y(NULL)f(Ob)5 b(ject)28
-b(p)r(oin)n(ter)f(returned)g(if)h(an)n(y)f(unexp)r(ected)h(items)g(are)
-f(encoun)n(tered.)427 1087 y(As)f(AST)g(con)n(tin)n(ues)f(to)h(b)r(e)g
-(dev)n(elop)r(ed,)g(new)g(attributes)f(are)g(added)h(o)r(ccasionally)e
-(to)h(selected)h(classes.)427 1187 y(If)35 b(an)f(older)f(v)n(ersion)g
-(of)h(AST)h(is)f(used)g(to)g(read)f(external)h(Ob)5 b(ject)34
-b(descriptions)f(created)h(b)n(y)g(a)f(more)427 1287
-y(recen)n(t)20 b(v)n(ersion)f(of)i(AST,)g(then)g(the)g(Channel)f(class)
-g(will,)i(b)n(y)f(default,)h(ignore)d(the)i(new)g(attributes,)h(using)
-427 1386 y(the)35 b(remaining)e(attributes)h(to)h(construct)e(the)i(Ob)
-5 b(ject.)57 b(This)34 b(is)g(usually)g(a)g(go)r(o)r(d)f(thing.)58
-b(Ho)n(w)n(ev)n(er,)427 1486 y(since)32 b(external)f(Ob)5
-b(ject)32 b(descriptions)f(are)g(often)h(stored)f(in)i(plain)f(text,)h
-(it)f(is)g(p)r(ossible)g(to)g(edit)g(them)427 1586 y(using)37
-b(a)g(text)h(editor.)65 b(This)37 b(giv)n(es)f(rise)h(to)g(the)h(p)r
-(ossibilit)n(y)f(of)g(gen)n(uine)g(errors)e(in)j(the)f(description)427
-1685 y(due)25 b(to)g(\014nger-slips,)f(t)n(yp)r(os,)i(or)e(simple)h
-(mis-understanding.)35 b(Suc)n(h)25 b(inappropriate)e(attributes)i
-(will)g(b)r(e)427 1785 y(ignored)k(if)h(Strict)g(is)g(left)g(at)g(its)g
-(default)g(zero)f(v)-5 b(alue.)43 b(This)30 b(will)g(cause)f(the)h
-(mis-sp)r(elled)g(attribute)g(to)427 1884 y(rev)n(ert)c(to)h(its)g
-(default)g(v)-5 b(alue,)27 b(p)r(oten)n(tially)g(causing)f(subtle)h(c)n
-(hanges)f(in)h(the)h(b)r(eha)n(viour)d(of)i(application)427
-1984 y(soft)n(w)n(are.)38 b(If)29 b(suc)n(h)f(an)g(e\013ect)h(is)g
-(susp)r(ected,)g(the)g(Strict)f(attribute)h(can)f(b)r(e)h(set)f
-(non-zero,)f(resulting)h(in)427 2084 y(the)g(erroneous)e(attribute)i(b)
-r(eing)f(iden)n(ti\014ed)h(in)g(an)f(error)f(message.)259
-2207 y Fd(FitsChan)427 2306 y Fi(The)20 b(returned)e(KeyMap)h(will)g
-(con)n(tain)g(w)n(arnings)f(for)g(all)h(conditions)g(listed)h(in)f(the)
-h(W)-7 b(arnings)18 b(attribute.)259 2430 y Fd(XmlChan)427
-2529 y Fi(Rep)r(orts)27 b(con)n(v)n(ersion)f(errors)f(that)j(result)f
-(in)h(what)g(are)e(usally)h(insigni\014can)n(t)g(c)n(hanges.)0
-2681 y Fd(Returned)32 b(V)-8 b(alue:)259 2808 y(astW)g(arnings\(\))427
-2908 y Fi(A)25 b(p)r(oin)n(ter)g(to)f(the)i(KeyMap)d(holding)i(the)g(w)
-n(arning)e(messages,)h(or)g(NULL)h(if)g(no)g(w)n(arnings)e(w)n(ere)h
+%%Page: 409 419
+TeXDict begin 409 418 bop 3643 52 a FF(409)0 351 y Fd(Class)31
+b(Applicabilit)m(y:)259 478 y(Channel)427 578 y Fi(The)25
+b(basic)f(Channel)h(class)f(generates)f(a)h(w)n(arning)g(when)g(ev)n
+(er)g(an)h(un-recognised)e(item)i(is)f(encoun)n(tered)427
+677 y(whilst)32 b(reading)f(an)g(Ob)5 b(ject)32 b(from)f(an)g(external)
+g(data)g(source.)48 b(If)32 b(Strict)g(is)g(zero)e(\(the)j(default\),)g
+(then)427 777 y(unexp)r(ected)28 b(items)f(in)g(the)g(Ob)5
+b(ject)27 b(description)g(are)f(simply)h(ignored,)e(and)i(an)n(y)f
+(remaining)g(items)i(are)427 876 y(used)h(to)g(construct)g(the)g
+(returned)f(Ob)5 b(ject.)41 b(If)30 b(Strict)f(is)g(non-zero,)f(an)g
+(error)f(will)j(b)r(e)f(rep)r(orted)f(and)h(a)427 976
+y(NULL)f(Ob)5 b(ject)28 b(p)r(oin)n(ter)f(returned)g(if)h(an)n(y)f
+(unexp)r(ected)h(items)g(are)f(encoun)n(tered.)427 1087
+y(As)f(AST)g(con)n(tin)n(ues)f(to)h(b)r(e)g(dev)n(elop)r(ed,)g(new)g
+(attributes)f(are)g(added)h(o)r(ccasionally)e(to)h(selected)h(classes.)
+427 1187 y(If)35 b(an)f(older)f(v)n(ersion)g(of)h(AST)h(is)f(used)g(to)
+g(read)f(external)h(Ob)5 b(ject)34 b(descriptions)f(created)h(b)n(y)g
+(a)f(more)427 1287 y(recen)n(t)20 b(v)n(ersion)f(of)i(AST,)g(then)g
+(the)g(Channel)f(class)g(will,)i(b)n(y)f(default,)h(ignore)d(the)i(new)
+g(attributes,)h(using)427 1386 y(the)35 b(remaining)e(attributes)h(to)h
+(construct)e(the)i(Ob)5 b(ject.)57 b(This)34 b(is)g(usually)g(a)g(go)r
+(o)r(d)f(thing.)58 b(Ho)n(w)n(ev)n(er,)427 1486 y(since)32
+b(external)f(Ob)5 b(ject)32 b(descriptions)f(are)g(often)h(stored)f(in)
+i(plain)f(text,)h(it)f(is)g(p)r(ossible)g(to)g(edit)g(them)427
+1586 y(using)37 b(a)g(text)h(editor.)65 b(This)37 b(giv)n(es)f(rise)h
+(to)g(the)h(p)r(ossibilit)n(y)f(of)g(gen)n(uine)g(errors)e(in)j(the)f
+(description)427 1685 y(due)25 b(to)g(\014nger-slips,)f(t)n(yp)r(os,)i
+(or)e(simple)h(mis-understanding.)35 b(Suc)n(h)25 b(inappropriate)e
+(attributes)i(will)g(b)r(e)427 1785 y(ignored)k(if)h(Strict)g(is)g
+(left)g(at)g(its)g(default)g(zero)f(v)-5 b(alue.)43 b(This)30
+b(will)g(cause)f(the)h(mis-sp)r(elled)g(attribute)g(to)427
+1884 y(rev)n(ert)c(to)h(its)g(default)g(v)-5 b(alue,)27
+b(p)r(oten)n(tially)g(causing)f(subtle)h(c)n(hanges)f(in)h(the)h(b)r
+(eha)n(viour)d(of)i(application)427 1984 y(soft)n(w)n(are.)38
+b(If)29 b(suc)n(h)f(an)g(e\013ect)h(is)g(susp)r(ected,)g(the)g(Strict)f
+(attribute)h(can)f(b)r(e)h(set)f(non-zero,)f(resulting)h(in)427
+2084 y(the)g(erroneous)e(attribute)i(b)r(eing)f(iden)n(ti\014ed)h(in)g
+(an)f(error)f(message.)259 2207 y Fd(FitsChan)427 2306
+y Fi(The)20 b(returned)e(KeyMap)h(will)g(con)n(tain)g(w)n(arnings)f
+(for)g(all)h(conditions)g(listed)h(in)f(the)h(W)-7 b(arnings)18
+b(attribute.)259 2430 y Fd(XmlChan)427 2529 y Fi(Rep)r(orts)27
+b(con)n(v)n(ersion)f(errors)f(that)j(result)f(in)h(what)g(are)e(usally)
+h(insigni\014can)n(t)g(c)n(hanges.)0 2681 y Fd(Returned)32
+b(V)-8 b(alue:)259 2808 y(astW)g(arnings\(\))427 2908
+y Fi(A)25 b(p)r(oin)n(ter)g(to)f(the)i(KeyMap)d(holding)i(the)g(w)n
+(arning)e(messages,)h(or)g(NULL)h(if)g(no)g(w)n(arnings)e(w)n(ere)h
(issued)427 3007 y(during)j(the)h(previous)f(read)g(op)r(eration.)0
3160 y Fd(Notes:)340 3432 y Fh(\017)45 b Fi(The)28 b(returned)f(KeyMap)
g(uses)g(k)n(eys)g(of)g(the)h(form)f Ft(")p Fi(W)-7 b(arning)p
@@ -128992,39 +129103,39 @@ b(to)i(an)f(in)n(t)h(whose)e(v)-5 b(alue)30 b(is)f(to)h(b)r(e)f(used)h
b(alue.)427 5593 y(If)36 b(a)f(NULL)h(p)r(oin)n(ter)f(is)g(supplied,)j
(the)e(AST)f(library)f(will)i(rev)n(ert)e(to)h(using)h(its)f(o)n(wn)g
(in)n(ternal)g(error)427 5693 y(status.)p eop end
-%%Page: 409 419
-TeXDict begin 409 418 bop 3643 52 a FF(409)0 351 y Fd(Returned)32
-b(V)-8 b(alue:)259 487 y(astW)g(atc)m(h\(\))427 586 y
-Fi(Address)27 b(of)h(the)f(previous)g(error)e(status)j(v)-5
-b(ariable.)35 b(This)28 b(ma)n(y)e(later)h(b)r(e)h(passed)f(bac)n(k)f
-(to)i(astW)-7 b(atc)n(h)27 b(to)427 686 y(restore)g(the)h(previous)g(b)
-r(eha)n(viour)f(of)h(the)g(library)-7 b(.)38 b(\(Note)28
-b(that)h(on)f(the)g(\014rst)g(in)n(v)n(o)r(cation)f(of)h(astW)-7
-b(atc)n(h)427 786 y(the)28 b(returned)f(v)-5 b(alue)28
-b(will)g(b)r(e)g(the)g(address)e(of)i(the)g(in)n(ternal)f(error)e
-(status)j(v)-5 b(ariable.\))0 947 y Fd(Notes:)340 1228
-y Fh(\017)45 b Fi(This)28 b(function)g(is)f(not)h(a)n(v)-5
-b(ailable)26 b(in)i(the)g(F)n(OR)-7 b(TRAN)28 b(77)f(in)n(terface)g(to)
-g(the)h(AST)g(library)-7 b(.)p 0 1426 3780 12 v 0 1556
-a Fz(astWcsMap)738 b Fe(Create)37 b(a)h(WcsMap)738 b
-Fz(astWcsMap)0 1743 y Fd(Description:)44 b Fi(This)28
-b(function)g(creates)f(a)g(new)g(WcsMap)h(and)f(optionally)g
-(initialises)g(its)h(attributes.)227 1867 y(A)g(WcsMap)g(is)f(used)h
-(to)g(represen)n(t)e(sky)h(co)r(ordinate)g(pro)5 b(jections)26
-b(as)h(describ)r(ed)h(in)f(the)i(\(draft\))f(FITS)g(w)n(orld)227
-1967 y(co)r(ordinate)20 b(system)g(\(FITS-W)n(CS\))h(pap)r(er)f(b)n(y)g
-(E.W.)h(Griesen)f(and)g(M.)h(Calabretta)e(\(A)i(&)f(A,)h(in)g
-(preparation\).)227 2067 y(This)29 b(pap)r(er)f(de\014nes)h(a)f(set)h
-(of)f(functions,)h(or)f(sky)g(pro)5 b(jections,)28 b(whic)n(h)h
-(transform)e(longitude-latitude)i(pairs)227 2166 y(represen)n(ting)d
-(spherical)h(celestial)g(co)r(ordinates)f(in)n(to)h(corresp)r(onding)f
-(pairs)h(of)g(Cartesian)f(co)r(ordinates)g(\(and)227
-2266 y(vice)i(v)n(ersa\).)227 2390 y(A)j(WcsMap)f(is)g(a)g(sp)r
-(ecialised)g(form)g(of)g(Mapping)g(whic)n(h)g(implemen)n(ts)h(these)f
-(sky)g(pro)5 b(jections)29 b(and)h(applies)227 2489 y(them)25
-b(to)g(a)f(sp)r(eci\014ed)h(pair)f(of)g(co)r(ordinates.)35
-b(All)25 b(the)g(pro)5 b(jections)23 b(in)i(the)g(FITS-W)n(CS)g(pap)r
-(er)f(are)g(supp)r(orted,)227 2589 y(plus)32 b(the)f(no)n(w)g
+%%Page: 410 420
+TeXDict begin 410 419 bop 0 52 a FF(410)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Returned)i(V)-8
+b(alue:)259 487 y(astW)g(atc)m(h\(\))427 586 y Fi(Address)27
+b(of)h(the)f(previous)g(error)e(status)j(v)-5 b(ariable.)35
+b(This)28 b(ma)n(y)e(later)h(b)r(e)h(passed)f(bac)n(k)f(to)i(astW)-7
+b(atc)n(h)27 b(to)427 686 y(restore)g(the)h(previous)g(b)r(eha)n(viour)
+f(of)h(the)g(library)-7 b(.)38 b(\(Note)28 b(that)h(on)f(the)g(\014rst)
+g(in)n(v)n(o)r(cation)f(of)h(astW)-7 b(atc)n(h)427 786
+y(the)28 b(returned)f(v)-5 b(alue)28 b(will)g(b)r(e)g(the)g(address)e
+(of)i(the)g(in)n(ternal)f(error)e(status)j(v)-5 b(ariable.\))0
+947 y Fd(Notes:)340 1228 y Fh(\017)45 b Fi(This)28 b(function)g(is)f
+(not)h(a)n(v)-5 b(ailable)26 b(in)i(the)g(F)n(OR)-7 b(TRAN)28
+b(77)f(in)n(terface)g(to)g(the)h(AST)g(library)-7 b(.)p
+0 1426 3780 12 v 0 1556 a Fz(astWcsMap)738 b Fe(Create)37
+b(a)h(WcsMap)738 b Fz(astWcsMap)0 1743 y Fd(Description:)44
+b Fi(This)28 b(function)g(creates)f(a)g(new)g(WcsMap)h(and)f
+(optionally)g(initialises)g(its)h(attributes.)227 1867
+y(A)g(WcsMap)g(is)f(used)h(to)g(represen)n(t)e(sky)h(co)r(ordinate)g
+(pro)5 b(jections)26 b(as)h(describ)r(ed)h(in)f(the)i(\(draft\))f(FITS)
+g(w)n(orld)227 1967 y(co)r(ordinate)20 b(system)g(\(FITS-W)n(CS\))h
+(pap)r(er)f(b)n(y)g(E.W.)h(Griesen)f(and)g(M.)h(Calabretta)e(\(A)i(&)f
+(A,)h(in)g(preparation\).)227 2067 y(This)29 b(pap)r(er)f(de\014nes)h
+(a)f(set)h(of)f(functions,)h(or)f(sky)g(pro)5 b(jections,)28
+b(whic)n(h)h(transform)e(longitude-latitude)i(pairs)227
+2166 y(represen)n(ting)d(spherical)h(celestial)g(co)r(ordinates)f(in)n
+(to)h(corresp)r(onding)f(pairs)h(of)g(Cartesian)f(co)r(ordinates)g
+(\(and)227 2266 y(vice)i(v)n(ersa\).)227 2390 y(A)j(WcsMap)f(is)g(a)g
+(sp)r(ecialised)g(form)g(of)g(Mapping)g(whic)n(h)g(implemen)n(ts)h
+(these)f(sky)g(pro)5 b(jections)29 b(and)h(applies)227
+2489 y(them)25 b(to)g(a)f(sp)r(eci\014ed)h(pair)f(of)g(co)r(ordinates.)
+35 b(All)25 b(the)g(pro)5 b(jections)23 b(in)i(the)g(FITS-W)n(CS)g(pap)
+r(er)f(are)g(supp)r(orted,)227 2589 y(plus)32 b(the)f(no)n(w)g
(deprecated)f Ft(")p Fi(T)-7 b(AN)32 b(with)f(p)r(olynomial)g
(correction)e(terms)p Ft(")i Fi(pro)5 b(jection)30 b(whic)n(h)h(is)g
(refered)g(to)227 2689 y(here)22 b(b)n(y)g(the)g(co)r(de)g
@@ -129091,19 +129202,18 @@ b(where)e(the)h(c)n(haracters)e(follo)n(wing)h(the)h(double)427
5693 y(underscore)19 b(giv)n(e)h(the)h(pro)5 b(jection)20
b(t)n(yp)r(e)h(co)r(de)f(\(in)i(upp)r(er)e(case\))h(as)f(used)g(in)h
(the)g(FITS-W)n(CS)g Ft(")p Fi(CTYPEi)p Ft(")p eop end
-%%Page: 410 420
-TeXDict begin 410 419 bop 0 52 a FF(410)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)427 351 y Fi(k)n(eyw)n(ord.)k(Y)-7
-b(ou)23 b(should)g(consult)g(the)h(FITS-W)n(CS)f(pap)r(er)g(for)f(a)h
-(list)h(of)f(the)g(a)n(v)-5 b(ailable)22 b(pro)5 b(jections.)35
-b(The)427 451 y(additional)41 b(co)r(de)f(of)h(AST)p
-Ft(__)p Fi(TPN)g(can)f(b)r(e)h(supplied)h(whic)n(h)f(represen)n(ts)e(a)
-i(T)-7 b(AN)41 b(pro)5 b(jection)40 b(with)427 551 y(p)r(olynomial)27
-b(correction)f(terms)h(as)g(de\014ned)h(in)g(an)f(early)g(draft)g(of)h
-(the)g(FITS-W)n(CS)g(pap)r(er.)259 681 y Fd(lonax)427
-781 y Fi(The)g(index)g(of)f(the)h(longitude)g(axis.)36
-b(This)27 b(should)h(lie)f(in)h(the)g(range)e(1)i(to)f
-Ft(")p Fi(nco)r(ord)p Ft(")p Fi(.)259 911 y Fd(latax)427
+%%Page: 411 421
+TeXDict begin 411 420 bop 3643 52 a FF(411)427 351 y
+Fi(k)n(eyw)n(ord.)34 b(Y)-7 b(ou)23 b(should)g(consult)g(the)h(FITS-W)n
+(CS)f(pap)r(er)g(for)f(a)h(list)h(of)f(the)g(a)n(v)-5
+b(ailable)22 b(pro)5 b(jections.)35 b(The)427 451 y(additional)41
+b(co)r(de)f(of)h(AST)p Ft(__)p Fi(TPN)g(can)f(b)r(e)h(supplied)h(whic)n
+(h)f(represen)n(ts)e(a)i(T)-7 b(AN)41 b(pro)5 b(jection)40
+b(with)427 551 y(p)r(olynomial)27 b(correction)f(terms)h(as)g
+(de\014ned)h(in)g(an)f(early)g(draft)g(of)h(the)g(FITS-W)n(CS)g(pap)r
+(er.)259 681 y Fd(lonax)427 781 y Fi(The)g(index)g(of)f(the)h
+(longitude)g(axis.)36 b(This)27 b(should)h(lie)f(in)h(the)g(range)e(1)i
+(to)f Ft(")p Fi(nco)r(ord)p Ft(")p Fi(.)259 911 y Fd(latax)427
1011 y Fi(The)33 b(index)g(of)g(the)g(latitude)h(axis.)52
b(This)33 b(should)f(lie)h(in)h(the)f(range)e(1)i(to)g
Ft(")p Fi(nco)r(ord)p Ft(")e Fi(and)i(b)r(e)g(distinct)427
@@ -129188,18 +129298,19 @@ b(alidit)n(y)29 b(is)g(c)n(hec)n(k)n(ed)g(when)g(the)h(resulting)427
b(parameters)427 5693 y(do)28 b(not)f(satisfy)g(all)h(the)g(required)e
(constrain)n(ts)g(\(as)i(de\014ned)g(in)g(the)g(FITS-W)n(CS)f(pap)r
(er\).)p eop end
-%%Page: 411 421
-TeXDict begin 411 420 bop 3643 52 a FF(411)340 351 y
-Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g
-(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g
-(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 451
-y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f
-(an)n(y)g(reason.)-2 615 y Fd(Status)33 b(Handling)n(:)227
-761 y Fi(The)d(protected)g(in)n(terface)f(to)g(this)h(function)h
-(includes)f(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g(the)g
-(parameter)227 861 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62
-b(This)37 b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)
-e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fi(in)n(t)227
+%%Page: 412 422
+TeXDict begin 412 421 bop 0 52 a FF(412)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)340 351 y Fh(\017)45
+b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35 b(p)r(oin)n(ter)g(\(AST)p
+Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g(if)g(this)g(function)h
+(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427 451 y(AST)28
+b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f(fail)h(for)f(an)n(y)g
+(reason.)-2 615 y Fd(Status)33 b(Handling)n(:)227 761
+y Fi(The)d(protected)g(in)n(terface)f(to)g(this)h(function)h(includes)f
+(an)f(extra)g(parameter)f(at)i(the)g(end)g(of)g(the)g(parameter)227
+861 y(list)37 b(descirb)r(ed)f(ab)r(o)n(v)n(e.)62 b(This)37
+b(parameter)e(is)h(a)g(p)r(oin)n(ter)g(to)h(the)g(in)n(teger)e
+(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p Fi(in)n(t)227
960 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p 0 1162 3780
12 v 0 1294 a Fz(astWinMap)1428 1292 y Fe(Create)37 b(a)i(WinMap)3090
1294 y Fz(astWinMap)0 1485 y Fd(Description:)44 b Fi(This)28
@@ -129258,9 +129369,8 @@ Fi(prin)n(tf)p Ft(")427 5274 y Fi(function\).)0 5438
y Fd(Returned)32 b(V)-8 b(alue:)259 5577 y(astWinMap\(\))427
5677 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(WinMap.)p
eop end
-%%Page: 412 422
-TeXDict begin 412 421 bop 0 52 a FF(412)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Notes:)340
+%%Page: 413 423
+TeXDict begin 413 422 bop 3643 52 a FF(413)0 351 y Fd(Notes:)340
685 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5 b(ject)35
b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g(returned)g
(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)427
@@ -129311,9 +129421,10 @@ b(new)g(FITS)h(header)f(cards)f(to)h(b)r(e)h(added)g(to)f(an)g(in)n
5518 y(in)n(v)n(ok)n(ed\).)58 b(This)35 b(bu\013er)h(is)f(written)g
(out)g(through)f(the)i(sink)f(function)g(only)g(when)g(the)h(FitsChan)f
(is)427 5617 y(deleted.)p eop end
-%%Page: 413 423
-TeXDict begin 413 422 bop 3643 52 a FF(413)p 0 351 3780
-12 v 0 483 a Fz(astW)-11 b(riteFits)233 b Fe(W)-10 b(rite)38
+%%Page: 414 424
+TeXDict begin 414 423 bop 0 52 a FF(414)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p 0 351 3780 12 v
+0 483 a Fz(astW)-11 b(riteFits)233 b Fe(W)-10 b(rite)38
b(out)g(all)g(cards)g(in)h(a)f(FitsChan)g(to)1457 583
y(the)h(sink)f(function)3048 483 y Fz(astW)-11 b(riteFits)0
753 y Fd(Description:)44 b Fi(This)30 b(function)h(writes)f(out)g(all)f
@@ -129389,27 +129500,26 @@ Fi(sink)p Ft(")f Fi(is)g(NULL,)h(and)g(no)f(v)-5 b(alue)32
b(has)f(b)r(een)h(set)f(for)h(the)g(SinkFile)g(attribute,)g(the)g
(XmlChan)g(will)427 5693 y(write)c(to)f(standard)g(output)h(instead.)p
eop end
-%%Page: 414 424
-TeXDict begin 414 423 bop 0 52 a FF(414)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)259 351 y Fd(options)427
-451 y Fi(P)n(oin)n(ter)d(to)h(a)g(n)n(ull-terminated)g(string)f(con)n
-(taining)g(an)h(optional)g(comma-separated)e(list)i(of)g(attribute)427
-551 y(assignmen)n(ts)22 b(to)h(b)r(e)g(used)h(for)e(initialising)h(the)
-g(new)h(XmlChan.)35 b(The)23 b(syn)n(tax)f(used)i(is)e(iden)n(tical)h
-(to)g(that)427 650 y(for)j(the)h(astSet)g(function)g(and)g(ma)n(y)f
-(include)h Ft(")p Fi(prin)n(tf)p Ft(")f Fi(format)g(sp)r(eci\014ers)g
-(iden)n(ti\014ed)h(b)n(y)f Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427
-750 y(in)i(the)g(normal)f(w)n(a)n(y)-7 b(.)259 885 y
-Fd(...)427 984 y Fi(If)38 b(the)g Ft(")p Fi(options)p
-Ft(")e Fi(string)h(con)n(tains)f Ft(")p Fi(\045)p Ft(")h
-Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g(list)h(of)f
-(additional)427 1084 y(argumen)n(ts)26 b(ma)n(y)h(follo)n(w)g(it)h(in)g
-(order)e(to)h(supply)h(v)-5 b(alues)27 b(to)g(b)r(e)h(substituted)h
-(for)e(these)g(sp)r(eci\014ers.)37 b(The)427 1183 y(rules)25
-b(for)f(supplying)h(these)g(are)f(iden)n(tical)h(to)g(those)g(for)f
-(the)h(astSet)g(function)h(\(and)f(for)g(the)g(C)g Ft(")p
-Fi(prin)n(tf)p Ft(")427 1283 y Fi(function\).)0 1449
-y Fd(Returned)32 b(V)-8 b(alue:)259 1589 y(astXmlChan\(\))427
+%%Page: 415 425
+TeXDict begin 415 424 bop 3643 52 a FF(415)259 351 y
+Fd(options)427 451 y Fi(P)n(oin)n(ter)27 b(to)h(a)g(n)n(ull-terminated)
+g(string)f(con)n(taining)g(an)h(optional)g(comma-separated)e(list)i(of)
+g(attribute)427 551 y(assignmen)n(ts)22 b(to)h(b)r(e)g(used)h(for)e
+(initialising)h(the)g(new)h(XmlChan.)35 b(The)23 b(syn)n(tax)f(used)i
+(is)e(iden)n(tical)h(to)g(that)427 650 y(for)j(the)h(astSet)g(function)
+g(and)g(ma)n(y)f(include)h Ft(")p Fi(prin)n(tf)p Ft(")f
+Fi(format)g(sp)r(eci\014ers)g(iden)n(ti\014ed)h(b)n(y)f
+Ft(")p Fi(\045)p Ft(")g Fi(sym)n(b)r(ols)427 750 y(in)i(the)g(normal)f
+(w)n(a)n(y)-7 b(.)259 885 y Fd(...)427 984 y Fi(If)38
+b(the)g Ft(")p Fi(options)p Ft(")e Fi(string)h(con)n(tains)f
+Ft(")p Fi(\045)p Ft(")h Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f
+(optional)g(list)h(of)f(additional)427 1084 y(argumen)n(ts)26
+b(ma)n(y)h(follo)n(w)g(it)h(in)g(order)e(to)h(supply)h(v)-5
+b(alues)27 b(to)g(b)r(e)h(substituted)h(for)e(these)g(sp)r(eci\014ers.)
+37 b(The)427 1183 y(rules)25 b(for)f(supplying)h(these)g(are)f(iden)n
+(tical)h(to)g(those)g(for)f(the)h(astSet)g(function)h(\(and)f(for)g
+(the)g(C)g Ft(")p Fi(prin)n(tf)p Ft(")427 1283 y Fi(function\).)0
+1449 y Fd(Returned)32 b(V)-8 b(alue:)259 1589 y(astXmlChan\(\))427
1689 y Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(XmlChan.)0
1854 y Fd(Notes:)340 2141 y Fh(\017)45 b Fi(If)28 b(the)g(external)e
(data)h(source)f(or)g(sink)i(uses)e(a)h(c)n(haracter)f(enco)r(ding)g
@@ -129466,11 +129576,12 @@ Fi(format)g(sp)r(eci\014ers,)i(then)f(an)f(optional)g(list)h(of)f
b(for)f(supplying)h(these)g(are)f(iden)n(tical)h(to)g(those)g(for)f
(the)h(astSet)g(function)h(\(and)f(for)g(the)g(C)g Ft(")p
Fi(prin)n(tf)p Ft(")427 5672 y Fi(function\).)p eop end
-%%Page: 415 425
-TeXDict begin 415 424 bop 3643 52 a FF(415)0 351 y Fd(Returned)32
-b(V)-8 b(alue:)259 488 y(astZo)s(omMap\(\))427 587 y
-Fi(A)28 b(p)r(oin)n(ter)f(to)h(the)g(new)g(Zo)r(omMap.)0
-749 y Fd(Notes:)340 1032 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
+%%Page: 416 426
+TeXDict begin 416 425 bop 0 52 a FF(416)2049 b Fy(B)91
+b(AST)30 b(FUNCTION)g(DESCRIPTIONS)0 351 y Fd(Returned)i(V)-8
+b(alue:)259 488 y(astZo)s(omMap\(\))427 587 y Fi(A)28
+b(p)r(oin)n(ter)f(to)h(the)g(new)g(Zo)r(omMap.)0 749
+y Fd(Notes:)340 1032 y Fh(\017)45 b Fi(A)35 b(n)n(ull)g(Ob)5
b(ject)35 b(p)r(oin)n(ter)g(\(AST)p Ft(__)p Fi(NULL\))g(will)g(b)r(e)g
(returned)g(if)g(this)g(function)h(is)e(in)n(v)n(ok)n(ed)g(with)h(the)
427 1131 y(AST)28 b(error)e(status)h(set,)h(or)f(if)h(it)g(should)f
@@ -129482,9 +129593,6 @@ b(Handling)n(:)227 1439 y Fi(The)d(protected)g(in)n(terface)f(to)g
(teger)e(inherited)i(status)f(v)-5 b(ariable:)54 b Ft(")p
Fi(in)n(t)227 1639 y Fh(\003)p Fi(status)p Ft(")p Fi(.)p
eop end
-%%Page: 416 426
-TeXDict begin 416 425 bop 0 52 a FF(416)2049 b Fy(B)91
-b(AST)30 b(FUNCTION)g(DESCRIPTIONS)p eop end
%%Page: 417 427
TeXDict begin 417 426 bop 3643 52 a FF(417)0 351 y Fz(C)135
b(AST)43 b(A)l(ttribute)j(Descriptions)p 0 596 3780 12
@@ -129823,852 +129931,867 @@ end
TeXDict begin 421 430 bop 3643 52 a FF(421)259 351 y
Fd(SkyF)-8 b(rame)427 451 y Fi(The)28 b(default)g(AlignSystem)g
(attribute)g(for)f(a)g(SkyF)-7 b(rame)27 b(is)g Ft(")p
-Fi(ICRS)p Ft(")p Fi(.)259 590 y Fd(Sp)s(ecF)-8 b(rame)427
-690 y Fi(The)28 b(default)g(AlignSystem)g(attribute)g(for)f(a)g(Sp)r
+Fi(ICRS)p Ft(")p Fi(.)259 585 y Fd(Sp)s(ecF)-8 b(rame)427
+685 y Fi(The)28 b(default)g(AlignSystem)g(attribute)g(for)f(a)g(Sp)r
(ecF)-7 b(rame)27 b(is)h Ft(")p Fi(W)-7 b(a)n(v)n(e)p
-Ft(")26 b Fi(\(w)n(a)n(v)n(elength\).)259 829 y Fd(TimeF)-8
-b(rame)427 929 y Fi(The)28 b(default)g(AlignSystem)g(attribute)g(for)f
+Ft(")26 b Fi(\(w)n(a)n(v)n(elength\).)259 819 y Fd(TimeF)-8
+b(rame)427 919 y Fi(The)28 b(default)g(AlignSystem)g(attribute)g(for)f
(a)g(TimeF)-7 b(rame)27 b(is)g Ft(")p Fi(MJD)p Ft(")p
-Fi(.)p 0 1141 3780 12 v 0 1273 a Fz(AlignTimeScale)153
+Fi(.)p 0 1121 3780 12 v 0 1252 a Fz(AlignTimeScale)153
b Fe(Time)36 b(scale)h(to)g(use)h(when)f(aligning)1573
-1386 y(TimeF)-10 b(rames)2858 1273 y Fz(AlignTimeScale)0
-1570 y Fd(Description:)44 b Fi(This)32 b(attribute)g(con)n(trols)e(ho)n
+1366 y(TimeF)-10 b(rames)2858 1252 y Fz(AlignTimeScale)0
+1539 y Fd(Description:)44 b Fi(This)32 b(attribute)g(con)n(trols)e(ho)n
(w)h(a)g(TimeF)-7 b(rame)32 b(b)r(eha)n(v)n(es)e(when)i(it)g(is)g(used)
-g(\(b)n(y)f(astFindF)-7 b(rame)31 b(or)227 1669 y(astCon)n(v)n(ert\))h
+g(\(b)n(y)f(astFindF)-7 b(rame)31 b(or)227 1638 y(astCon)n(v)n(ert\))h
(as)i(a)f(template)h(to)g(matc)n(h)f(another)g(\(target\))g(TimeF)-7
b(rame.)55 b(It)34 b(iden)n(ti\014es)g(the)g(time)g(scale)f(in)227
-1769 y(whic)n(h)27 b(alignmen)n(t)f(is)h(to)f(o)r(ccur.)36
+1738 y(whic)n(h)27 b(alignmen)n(t)f(is)h(to)f(o)r(ccur.)36
b(See)27 b(the)g(TimeScale)g(attribute)g(for)f(a)g(desription)g(of)h
-(the)g(v)-5 b(alues)27 b(whic)n(h)f(ma)n(y)227 1869 y(b)r(e)32
+(the)g(v)-5 b(alues)27 b(whic)n(h)f(ma)n(y)227 1837 y(b)r(e)32
b(assigned)d(to)i(this)g(attribute.)48 b(The)31 b(default)g
(AlignTimeScale)g(v)-5 b(alue)30 b(dep)r(ends)i(on)e(the)i(curren)n(t)e
-(v)-5 b(alue)31 b(of)227 1968 y(TimeScale:)37 b(if)27
+(v)-5 b(alue)31 b(of)227 1937 y(TimeScale:)37 b(if)27
b(TimeScale)g(is)g(UT1,)g(GMST,)h(LMST)f(or)f(LAST,)i(the)g(default)f
-(for)g(AlignTimeScale)g(is)g(UT1,)227 2068 y(for)g(all)h(other)f
-(TimeScales)g(the)h(default)g(is)f(T)-7 b(AI.)227 2199
+(for)g(AlignTimeScale)g(is)g(UT1,)227 2037 y(for)g(all)h(other)f
+(TimeScales)g(the)h(default)g(is)f(T)-7 b(AI.)227 2163
y(When)37 b(astFindF)-7 b(rame)35 b(or)g(astCon)n(v)n(ert)f(is)h(used)h
(on)g(t)n(w)n(o)f(TimeF)-7 b(rames)35 b(\(p)r(oten)n(tially)h
-(describing)e(di\013eren)n(t)227 2299 y(time)c(co)r(ordinate)d
+(describing)e(di\013eren)n(t)227 2262 y(time)c(co)r(ordinate)d
(systems\),)j(it)f(returns)f(a)h(Mapping)f(whic)n(h)h(can)g(b)r(e)g
(used)g(to)g(transform)f(a)g(p)r(osition)h(in)g(one)227
-2398 y(TimeF)-7 b(rame)24 b(in)n(to)g(the)h(corresp)r(onding)d(p)r
+2362 y(TimeF)-7 b(rame)24 b(in)n(to)g(the)h(corresp)r(onding)d(p)r
(osition)j(in)f(the)h(other.)35 b(The)25 b(Mapping)f(is)g(made)g(up)h
-(of)f(the)h(follo)n(wing)227 2498 y(steps)j(in)g(the)g(indicated)f
-(order:)340 2779 y Fh(\017)45 b Fi(Map)32 b(v)-5 b(alues)32
+(of)f(the)h(follo)n(wing)227 2461 y(steps)j(in)g(the)g(indicated)f
+(order:)340 2727 y Fh(\017)45 b Fi(Map)32 b(v)-5 b(alues)32
b(from)g(the)h(system)f(used)h(b)n(y)f(the)g(target)g(\(MJD,)h(JD,)f
(etc\))h(to)f(the)h(system)f(sp)r(eci\014ed)h(b)n(y)427
-2878 y(the)28 b(AlignSystem)g(attribute.)340 3018 y Fh(\017)45
+2826 y(the)28 b(AlignSystem)g(attribute.)340 2960 y Fh(\017)45
b Fi(Map)20 b(these)f(v)-5 b(alues)19 b(from)g(the)h(target's)f(time)h
(scale)e(to)i(the)f(time)h(scale)f(sp)r(eci\014ed)h(b)n(y)f(the)h
-(AlignTimeScale)427 3117 y(attribute.)340 3257 y Fh(\017)45
+(AlignTimeScale)427 3060 y(attribute.)340 3194 y Fh(\017)45
b Fi(Map)28 b(these)f(v)-5 b(alues)27 b(from)h(the)f(time)h(scale)f(sp)
r(eci\014ed)h(b)n(y)f(the)h(AlignTimeScale)f(attribute,)h(to)g(the)f
-(tem-)427 3356 y(plate's)h(time)g(scale.)340 3496 y Fh(\017)45
+(tem-)427 3294 y(plate's)h(time)g(scale.)340 3428 y Fh(\017)45
b Fi(Map)24 b(these)g(v)-5 b(alues)24 b(from)g(the)h(system)f(sp)r
(eci\014ed)g(b)n(y)g(the)h(AlignSystem)f(attribute,)h(to)f(the)h
-(system)f(used)427 3595 y(b)n(y)k(the)g(template.)0 3770
-y Fd(T)m(yp)s(e:)227 3870 y Fi(String.)0 4033 y Fd(Class)j
-(Applicabilit)m(y:)259 4182 y(TimeF)-8 b(rame)427 4282
+(system)f(used)427 3528 y(b)n(y)k(the)g(template.)0 3692
+y Fd(T)m(yp)s(e:)227 3792 y Fi(String.)0 3944 y Fd(Class)j
+(Applicabilit)m(y:)259 4083 y(TimeF)-8 b(rame)427 4183
y Fi(All)28 b(TimeF)-7 b(rames)27 b(ha)n(v)n(e)g(this)h(attribute.)p
-0 4494 V 0 4626 a Fz(AllW)-11 b(arnings)378 b Fe(A)39
-b(list)f(of)g(all)f(curren)m(tly)g(a)m(v)-7 b(ailable)1473
-4741 y(condition)37 b(names)3048 4626 y Fz(AllW)-11 b(arnings)0
-4919 y Fd(Description:)44 b Fi(This)32 b(read-only)d(attribute)j(is)f
-(a)g(space)g(separated)f(list)i(of)f(all)g(the)h(conditions)f(names)g
-(recognized)227 5019 y(b)n(y)d(the)g(W)-7 b(arnings)26
-b(attribute.)37 b(The)28 b(names)f(are)g(listed)h(b)r(elo)n(w.)0
-5182 y Fd(T)m(yp)s(e:)227 5281 y Fi(String,)g(read-only)0
-5444 y Fd(Class)j(Applicabilit)m(y:)259 5593 y(FitsChan)427
-5693 y Fi(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)p
-eop end
+0 4385 V 0 4517 a Fz(AllV)-11 b(arian)l(ts)170 b Fe(A)39
+b(list)e(of)i(the)f(v)-7 b(arian)m(t)37 b(Mappings)h(asso)s(ciated)1292
+4631 y(with)g(the)h(curren)m(t)e(F)-10 b(rame)3113 4517
+y Fz(AllV)f(arian)l(ts)0 4800 y Fd(Description:)44 b
+Fi(This)34 b(attrbute)g(giv)n(es)f(a)g(space)g(separated)g(list)h(of)g
+(the)g(names)f(of)h(all)f(the)i(v)-5 b(arian)n(t)32 b(Mappings)i(as-)
+227 4899 y(so)r(ciated)g(with)g(the)g(curren)n(t)f(F)-7
+b(rame)34 b(\(see)g(attribute)g Ft(")p Fi(V)-7 b(arian)n(t)p
+Ft(")p Fi(\).)54 b(If)35 b(the)f(curren)n(t)f(F)-7 b(rame)34
+b(has)f(no)h(v)-5 b(arian)n(t)227 4999 y(Mappings,)27
+b(then)h(the)g(list)g(will)g(hold)g(a)f(single)g(en)n(try)g(equal)g(to)
+g(the)h(Domain)g(name)f(of)h(the)g(curren)n(t)f(F)-7
+b(rame.)0 5151 y Fd(T)m(yp)s(e:)227 5251 y Fi(String,)28
+b(read-only)-7 b(.)0 5403 y Fd(Class)31 b(Applicabilit)m(y:)259
+5542 y(F)-8 b(rameSet)427 5642 y Fi(All)28 b(F)-7 b(rameSets)27
+b(ha)n(v)n(e)g(this)h(attribute.)p eop end
%%Page: 422 432
TeXDict begin 422 431 bop 0 52 a FF(422)1994 b Fy(C)91
-b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)-2 351 y
-Fd(Conditions)n(:)227 497 y Fi(The)d(follo)n(wing)e(conditions)i(are)e
-(curren)n(tly)h(recognised)f(\(all)h(are)227 630 y(case-insensitiv)n
-(e\):)340 915 y Fh(\017)45 b Ft(")p Fi(BadCel)p Ft(")p
-Fi(:)31 b(This)18 b(condition)h(arises)e(when)h(reading)f(a)h(F)-7
-b(rameSet)18 b(from)g(a)g(non-Nativ)n(e)g(enco)r(ded)g(FitsChan)427
-1014 y(if)28 b(an)g(unkno)n(wn)f(celestial)g(co-ordinate)f(system)h(is)
-h(sp)r(eci\014ed)f(b)n(y)h(the)g(CTYPE)f(k)n(eyw)n(ords.)340
-1155 y Fh(\017)45 b Ft(")p Fi(BadCTYPE)p Ft(")p Fi(:)e(This)31
-b(condition)g(arises)f(when)i(reading)e(a)h(F)-7 b(rameSet)31
-b(from)g(a)g(non-Nativ)n(e)g(enco)r(ded)427 1255 y(FitsChan)d(if)g(an)g
-(illegal)f(algorithm)g(co)r(de)g(is)h(sp)r(eci\014ed)g(b)n(y)f(a)h
-(CTYPE)f(k)n(eyw)n(ord,)f(and)i(the)g(illegal)f(co)r(de)427
-1354 y(can)g(b)r(e)h(con)n(v)n(erted)f(to)g(an)g(equiv)-5
-b(alen)n(t)28 b(legal)e(co)r(de.)340 1495 y Fh(\017)45
+b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
+3780 12 v 0 483 a Fz(AllW)-11 b(arnings)378 b Fe(A)39
+b(list)f(of)g(all)f(curren)m(tly)g(a)m(v)-7 b(ailable)1473
+598 y(condition)37 b(names)3048 483 y Fz(AllW)-11 b(arnings)0
+777 y Fd(Description:)44 b Fi(This)32 b(read-only)d(attribute)j(is)f(a)
+g(space)g(separated)f(list)i(of)f(all)g(the)h(conditions)f(names)g
+(recognized)227 876 y(b)n(y)d(the)g(W)-7 b(arnings)26
+b(attribute.)37 b(The)28 b(names)f(are)g(listed)h(b)r(elo)n(w.)0
+1039 y Fd(T)m(yp)s(e:)227 1139 y Fi(String,)g(read-only)0
+1302 y Fd(Class)j(Applicabilit)m(y:)259 1452 y(FitsChan)427
+1551 y Fi(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)-2
+1727 y Fd(Conditions)n(:)227 1873 y Fi(The)g(follo)n(wing)e(conditions)
+i(are)e(curren)n(tly)h(recognised)f(\(all)h(are)227 2004
+y(case-insensitiv)n(e\):)340 2285 y Fh(\017)45 b Ft(")p
+Fi(BadCel)p Ft(")p Fi(:)31 b(This)18 b(condition)h(arises)e(when)h
+(reading)f(a)h(F)-7 b(rameSet)18 b(from)g(a)g(non-Nativ)n(e)g(enco)r
+(ded)g(FitsChan)427 2385 y(if)28 b(an)g(unkno)n(wn)f(celestial)g
+(co-ordinate)f(system)h(is)h(sp)r(eci\014ed)f(b)n(y)h(the)g(CTYPE)f(k)n
+(eyw)n(ords.)340 2524 y Fh(\017)45 b Ft(")p Fi(BadCTYPE)p
+Ft(")p Fi(:)e(This)31 b(condition)g(arises)f(when)i(reading)e(a)h(F)-7
+b(rameSet)31 b(from)g(a)g(non-Nativ)n(e)g(enco)r(ded)427
+2624 y(FitsChan)d(if)g(an)g(illegal)f(algorithm)g(co)r(de)g(is)h(sp)r
+(eci\014ed)g(b)n(y)f(a)h(CTYPE)f(k)n(eyw)n(ord,)f(and)i(the)g(illegal)f
+(co)r(de)427 2723 y(can)g(b)r(e)h(con)n(v)n(erted)f(to)g(an)g(equiv)-5
+b(alen)n(t)28 b(legal)e(co)r(de.)340 2863 y Fh(\017)45
b Ft(")p Fi(BadLat)p Ft(")p Fi(:)31 b(This)18 b(condition)g(arises)f
(when)i(reading)e(a)h(F)-7 b(rameSet)18 b(from)g(a)g(non-Nativ)n(e)g
-(enco)r(ded)g(FitsChan)427 1595 y(if)23 b(the)f(latitude)g(of)g(the)h
+(enco)r(ded)g(FitsChan)427 2963 y(if)23 b(the)f(latitude)g(of)g(the)h
(reference)e(p)r(oin)n(t)h(has)f(an)h(absolute)f(v)-5
b(alue)22 b(greater)e(than)i(90)f(degrees.)34 b(The)22
-b(actual)427 1695 y(absolute)27 b(v)-5 b(alue)28 b(used)f(is)h(set)f
+b(actual)427 3062 y(absolute)27 b(v)-5 b(alue)28 b(used)f(is)h(set)f
(to)h(exactly)f(90)f(degrees)h(in)h(these)f(cases.)340
-1835 y Fh(\017)45 b Ft(")p Fi(BadMat)p Ft(")p Fi(:)32
+3202 y Fh(\017)45 b Ft(")p Fi(BadMat)p Ft(")p Fi(:)32
b(This)20 b(condition)g(arises)f(if)i(the)f(matrix)g(describing)g(the)g
-(transformation)f(from)h(pixel)g(o\013sets)427 1935 y(to)38
+(transformation)f(from)h(pixel)g(o\013sets)427 3302 y(to)38
b(in)n(termediate)g(w)n(orld)f(co)r(ordinates)g(cannot)g(b)r(e)i(in)n
(v)n(erted.)67 b(This)38 b(matrix)g(describ)r(es)f(the)i(scaling,)427
-2035 y(rotation,)32 b(shear,)h(etc.,)g(applied)f(to)g(the)h(pixel)f
+3401 y(rotation,)32 b(shear,)h(etc.,)g(applied)f(to)g(the)h(pixel)f
(axes,)g(and)g(is)g(sp)r(eci\014ed)h(b)n(y)f(k)n(eyw)n(ords)e(suc)n(h)i
-(as)f(PCi)p Ft(_)p Fi(j,)427 2134 y(CDi)p Ft(_)p Fi(j,)g(CR)n(OT)-7
+(as)f(PCi)p Ft(_)p Fi(j,)427 3501 y(CDi)p Ft(_)p Fi(j,)g(CR)n(OT)-7
b(A,)29 b(etc.)43 b(F)-7 b(or)29 b(example,)h(the)g(matrix)f(will)h
(not)g(b)r(e)g(in)n(v)n(ertable)e(if)i(an)n(y)f(ro)n(ws)f(or)h(columns)
-427 2234 y(consist)i(en)n(tirely)f(of)h(zeros.)46 b(The)31
+427 3600 y(consist)i(en)n(tirely)f(of)h(zeros.)46 b(The)31
b(FITS-W)n(CS)g(P)n(ap)r(er)f(I)h Ft(")p Fi(Represen)n(tation)e(of)i(W)
--7 b(orld)31 b(Co)r(ordinates)e(in)427 2333 y(FITS)p
+-7 b(orld)31 b(Co)r(ordinates)e(in)427 3700 y(FITS)p
Ft(")35 b Fi(b)n(y)g(Greisen)f(&)h(Calabretta)e(requires)h(that)h(this)
g(matrix)g(b)r(e)g(in)n(v)n(ertable.)58 b(Man)n(y)34
-b(op)r(erations)427 2433 y(\(suc)n(h)28 b(as)f(grid)g(plotting\))h
+b(op)r(erations)427 3800 y(\(suc)n(h)28 b(as)f(grid)g(plotting\))h
(will)f(not)h(b)r(e)g(p)r(ossible)f(if)h(the)g(matrix)f(cannot)h(b)r(e)
-g(in)n(v)n(erted.)340 2574 y Fh(\017)45 b Ft(")p Fi(BadPV)p
+g(in)n(v)n(erted.)340 3939 y Fh(\017)45 b Ft(")p Fi(BadPV)p
Ft(")p Fi(:)31 b(This)18 b(condition)g(arises)f(when)i(reading)e(a)h(F)
-7 b(rameSet)18 b(from)g(a)g(non-Nativ)n(e)g(enco)r(ded)g(FitsChan.)427
-2674 y(It)27 b(is)g(issued)f(if)h(a)f(PVi)p Ft(_)p Fi(m)h(header)e(is)i
+4039 y(It)27 b(is)g(issued)f(if)h(a)f(PVi)p Ft(_)p Fi(m)h(header)e(is)i
(found)g(that)g(refers)e(to)i(a)f(pro)5 b(jection)26
-b(parameter)f(that)i(is)f(not)h(used)427 2773 y(b)n(y)d(the)h(pro)5
+b(parameter)f(that)i(is)f(not)h(used)427 4138 y(b)n(y)d(the)h(pro)5
b(jection)23 b(t)n(yp)r(e)i(sp)r(eci\014ed)f(b)n(y)g(CTYPE,)g(or)f(the)
i(PV)f(v)-5 b(alues)24 b(are)f(otherwise)g(inappropriate)g(for)427
-2873 y(the)28 b(pro)5 b(jection)27 b(t)n(yp)r(e.)340
-3014 y Fh(\017)45 b Ft(")p Fi(BadV)-7 b(al)p Ft(")p Fi(:)31
+4238 y(the)28 b(pro)5 b(jection)27 b(t)n(yp)r(e.)340
+4378 y Fh(\017)45 b Ft(")p Fi(BadV)-7 b(al)p Ft(")p Fi(:)31
b(This)18 b(condition)h(arises)e(when)h(reading)f(a)h(F)-7
b(rameSet)18 b(from)g(a)g(non-Nativ)n(e)g(enco)r(ded)g(FitsChan)427
-3113 y(if)33 b(it)g(is)g(not)g(p)r(ossible)f(to)g(con)n(v)n(ert)f(the)i
+4477 y(if)33 b(it)g(is)g(not)g(p)r(ossible)f(to)g(con)n(v)n(ert)f(the)i
(v)-5 b(alue)33 b(of)f(a)h(FITS)g(k)n(eyw)n(ords)d(to)j(the)g(exp)r
-(ected)g(t)n(yp)r(e.)52 b(F)-7 b(or)32 b(in-)427 3213
+(ected)g(t)n(yp)r(e.)52 b(F)-7 b(or)32 b(in-)427 4577
y(stance,)27 b(this)g(can)g(o)r(ccur)f(if)i(the)f(FITS)g(header)f(con)n
(tains)g(a)h(string)f(v)-5 b(alue)27 b(for)f(a)h(k)n(eyw)n(ord)e(whic)n
-(h)i(should)427 3313 y(ha)n(v)n(e)g(a)g(\015oating)g(p)r(oin)n(t)g(v)-5
+(h)i(should)427 4677 y(ha)n(v)n(e)g(a)g(\015oating)g(p)r(oin)n(t)g(v)-5
b(alue,)28 b(or)f(if)h(the)g(k)n(eyw)n(ord)d(has)j(no)f(v)-5
b(alue)27 b(at)h(all)f(\(i.e.)37 b(is)28 b(a)f(commen)n(t)g(card\).)340
-3453 y Fh(\017)45 b Ft(")p Fi(Distortion)p Ft(")p Fi(:)56
+4816 y Fh(\017)45 b Ft(")p Fi(Distortion)p Ft(")p Fi(:)56
b(This)37 b(condition)g(arises)g(when)g(reading)g(a)g(F)-7
b(rameSet)37 b(from)g(a)g(non-Nativ)n(e)g(enco)r(ded)427
-3553 y(FitsChan)32 b(if)h(an)n(y)f(of)g(the)g(CTYPE)g(k)n(eyw)n(ords)e
+4916 y(FitsChan)32 b(if)h(an)n(y)f(of)g(the)g(CTYPE)g(k)n(eyw)n(ords)e
(sp)r(ecify)i(an)g(unsupp)r(orted)g(distortion)f(co)r(de)h(using)g(the)
-427 3653 y Ft(")p Fi(4-3-3)p Ft(")25 b Fi(format)i(sp)r(eci\014ed)h(in)
+427 5015 y Ft(")p Fi(4-3-3)p Ft(")25 b Fi(format)i(sp)r(eci\014ed)h(in)
g(FITS-W)n(CS)f(pap)r(er)h(IV.)g(Suc)n(h)f(distortion)g(co)r(des)g(are)
-g(ignored.)340 3793 y Fh(\017)45 b Ft(")p Fi(NoCTYPE)p
+g(ignored.)340 5155 y Fh(\017)45 b Ft(")p Fi(NoCTYPE)p
Ft(")p Fi(:)f(This)32 b(condition)f(arises)g(if)h(a)f(default)h(CTYPE)g
(v)-5 b(alue)31 b(is)h(used)g(within)g(astRead,)g(due)427
-3893 y(to)g(no)f(v)-5 b(alue)31 b(b)r(eing)g(presen)n(t)g(in)h(the)f
+5255 y(to)g(no)f(v)-5 b(alue)31 b(b)r(eing)g(presen)n(t)g(in)h(the)f
(supplied)h(FitsChan.)48 b(This)32 b(condition)f(is)g(only)g(tested)h
-(for)e(when)427 3993 y(using)e(non-Nativ)n(e)e(enco)r(dings.)340
-4133 y Fh(\017)45 b Ft(")p Fi(NoEquino)n(x)p Ft(")p Fi(:)g(This)33
+(for)e(when)427 5354 y(using)e(non-Nativ)n(e)e(enco)r(dings.)340
+5494 y Fh(\017)45 b Ft(")p Fi(NoEquino)n(x)p Ft(")p Fi(:)g(This)33
b(condition)f(arises)f(if)j(a)e(default)h(equino)n(x)f(v)-5
-b(alue)32 b(is)h(used)g(within)g(astRead,)g(due)427 4233
+b(alue)32 b(is)h(used)g(within)g(astRead,)g(due)427 5593
y(to)f(no)f(v)-5 b(alue)31 b(b)r(eing)g(presen)n(t)g(in)h(the)f
(supplied)h(FitsChan.)48 b(This)32 b(condition)f(is)g(only)g(tested)h
-(for)e(when)427 4333 y(using)e(non-Nativ)n(e)e(enco)r(dings.)340
-4474 y Fh(\017)45 b Ft(")p Fi(NoRadesys)p Ft(")p Fi(:)55
-b(This)38 b(condition)f(arises)g(if)h(a)f(default)h(reference)f(frame)g
-(is)h(used)g(for)f(an)g(equatorial)427 4573 y(co-ordinate)27
-b(system)i(within)g(astRead,)f(due)h(to)g(no)f(v)-5 b(alue)29
-b(b)r(eing)f(presen)n(t)g(in)h(the)g(supplied)g(FitsChan.)427
-4673 y(This)f(condition)f(is)h(only)f(tested)h(for)f(when)h(using)f
-(non-Nativ)n(e)g(enco)r(dings.)340 4814 y Fh(\017)45
-b Ft(")p Fi(NoLonp)r(ole)p Ft(")p Fi(:)52 b(This)35 b(condition)h
-(arises)e(if)i(a)g(default)g(v)-5 b(alue)35 b(is)h(used)f(for)h(the)g
-(LONPOLE)d(k)n(eyw)n(ord)427 4913 y(within)g(astRead,)g(due)g(to)f(no)g
-(v)-5 b(alue)32 b(b)r(eing)h(presen)n(t)e(in)i(the)g(supplied)f
-(FitsChan.)51 b(This)33 b(condition)f(is)427 5013 y(only)27
-b(tested)h(for)f(when)h(using)f(non-Nativ)n(e)g(enco)r(dings.)340
-5154 y Fh(\017)45 b Ft(")p Fi(NoLatp)r(ole)p Ft(")p Fi(:)56
-b(This)37 b(condition)g(arises)f(if)i(a)f(default)h(v)-5
-b(alue)38 b(is)f(used)g(for)g(the)h(LA)-7 b(TPOLE)36
-b(k)n(eyw)n(ord)427 5253 y(within)d(astRead,)g(due)g(to)f(no)g(v)-5
-b(alue)32 b(b)r(eing)h(presen)n(t)e(in)i(the)g(supplied)f(FitsChan.)51
-b(This)33 b(condition)f(is)427 5353 y(only)27 b(tested)h(for)f(when)h
-(using)f(non-Nativ)n(e)g(enco)r(dings.)340 5494 y Fh(\017)45
-b Ft(")p Fi(NoMjd-obs)p Ft(")p Fi(:)56 b(This)37 b(condition)h(arises)e
-(if)i(a)f(default)h(v)-5 b(alue)38 b(is)f(used)h(for)f(the)h(date)f(of)
-h(observ)-5 b(ation)427 5593 y(within)33 b(astRead,)g(due)g(to)f(no)g
-(v)-5 b(alue)32 b(b)r(eing)h(presen)n(t)e(in)i(the)g(supplied)f
-(FitsChan.)51 b(This)33 b(condition)f(is)427 5693 y(only)27
-b(tested)h(for)f(when)h(using)f(non-Nativ)n(e)g(enco)r(dings.)p
+(for)e(when)427 5693 y(using)e(non-Nativ)n(e)e(enco)r(dings.)p
eop end
%%Page: 423 433
TeXDict begin 423 432 bop 3643 52 a FF(423)340 351 y
-Fh(\017)45 b Ft(")p Fi(Tnx)p Ft(")p Fi(:)38 b(This)28
-b(condition)g(arises)f(if)i(a)f(F)-7 b(rameSet)28 b(is)h(read)e(from)h
-(a)g(FITS)h(header)e(con)n(taining)h(an)g(IRAF)427 451
-y Ft(")p Fi(TNX)p Ft(")g Fi(pro)5 b(jection)26 b(whic)n(h)i(includes)g
-(terms)f(not)h(supproted)f(b)n(y)g(AST.)i(Suc)n(h)e(terms)h(are)e
-(ignored)h(and)427 551 y(so)g(the)h(resulting)f(F)-7
-b(rameSet)28 b(ma)n(y)e(b)r(e)i(inaccurate.)340 679 y
-Fh(\017)45 b Ft(")p Fi(Zp)n(x)p Ft(")p Fi(:)39 b(This)29
-b(condition)g(arises)e(if)j(a)f(F)-7 b(rameSet)29 b(is)g(read)f(from)h
-(a)f(FITS)i(header)e(con)n(taining)g(an)h(IRAF)427 779
-y Ft(")p Fi(ZPX)p Ft(")24 b Fi(pro)5 b(jection)25 b(whic)n(h)g
-(includes)h Ft(")p Fi(lngcor)p Ft(")d Fi(or)h Ft(")p
-Fi(latcor)p Ft(")g Fi(correction)f(terms.)36 b(These)25
-b(terms)g(are)g(not)427 878 y(supp)r(orted)j(b)n(y)f(AST)h(and)f(are)g
-(ignored.)36 b(The)27 b(resulting)g(F)-7 b(rameSet)28
-b(ma)n(y)f(therefore)f(b)r(e)i(inaccurate.)p 0 1069 3780
-12 v 0 1208 a Fz(AsTime\(axis\))1116 1201 y Fe(F)-10
-b(ormat)37 b(celestal)g(co)s(ordinates)g(as)1725 1301
-y(times?)2989 1208 y Fz(AsTime\(axis\))0 1462 y Fd(Description:)44
-b Fi(This)28 b(attribute)f(sp)r(eci\014es)h(the)g(default)g(st)n(yle)f
-(of)g(formatting)g(to)g(b)r(e)h(used)g(\(e.g.)36 b(b)n(y)27
-b(astF)-7 b(ormat\))27 b(for)227 1562 y(the)e(celestial)f(co)r
-(ordinate)g(v)-5 b(alues)24 b(describ)r(ed)g(b)n(y)h(a)f(SkyF)-7
+Fh(\017)45 b Ft(")p Fi(NoRadesys)p Ft(")p Fi(:)55 b(This)38
+b(condition)f(arises)g(if)h(a)f(default)h(reference)f(frame)g(is)h
+(used)g(for)f(an)g(equatorial)427 451 y(co-ordinate)27
+b(system)i(within)g(astRead,)f(due)h(to)g(no)f(v)-5 b(alue)29
+b(b)r(eing)f(presen)n(t)g(in)h(the)g(supplied)g(FitsChan.)427
+551 y(This)f(condition)f(is)h(only)f(tested)h(for)f(when)h(using)f
+(non-Nativ)n(e)g(enco)r(dings.)340 703 y Fh(\017)45 b
+Ft(")p Fi(NoLonp)r(ole)p Ft(")p Fi(:)52 b(This)35 b(condition)h(arises)
+e(if)i(a)g(default)g(v)-5 b(alue)35 b(is)h(used)f(for)h(the)g(LONPOLE)d
+(k)n(eyw)n(ord)427 803 y(within)g(astRead,)g(due)g(to)f(no)g(v)-5
+b(alue)32 b(b)r(eing)h(presen)n(t)e(in)i(the)g(supplied)f(FitsChan.)51
+b(This)33 b(condition)f(is)427 902 y(only)27 b(tested)h(for)f(when)h
+(using)f(non-Nativ)n(e)g(enco)r(dings.)340 1055 y Fh(\017)45
+b Ft(")p Fi(NoLatp)r(ole)p Ft(")p Fi(:)56 b(This)37 b(condition)g
+(arises)f(if)i(a)f(default)h(v)-5 b(alue)38 b(is)f(used)g(for)g(the)h
+(LA)-7 b(TPOLE)36 b(k)n(eyw)n(ord)427 1154 y(within)d(astRead,)g(due)g
+(to)f(no)g(v)-5 b(alue)32 b(b)r(eing)h(presen)n(t)e(in)i(the)g
+(supplied)f(FitsChan.)51 b(This)33 b(condition)f(is)427
+1254 y(only)27 b(tested)h(for)f(when)h(using)f(non-Nativ)n(e)g(enco)r
+(dings.)340 1407 y Fh(\017)45 b Ft(")p Fi(NoMjd-obs)p
+Ft(")p Fi(:)56 b(This)37 b(condition)h(arises)e(if)i(a)f(default)h(v)-5
+b(alue)38 b(is)f(used)h(for)f(the)h(date)f(of)h(observ)-5
+b(ation)427 1506 y(within)33 b(astRead,)g(due)g(to)f(no)g(v)-5
+b(alue)32 b(b)r(eing)h(presen)n(t)e(in)i(the)g(supplied)f(FitsChan.)51
+b(This)33 b(condition)f(is)427 1606 y(only)27 b(tested)h(for)f(when)h
+(using)f(non-Nativ)n(e)g(enco)r(dings.)340 1758 y Fh(\017)45
+b Ft(")p Fi(Tnx)p Ft(")p Fi(:)38 b(This)28 b(condition)g(arises)f(if)i
+(a)f(F)-7 b(rameSet)28 b(is)h(read)e(from)h(a)g(FITS)h(header)e(con)n
+(taining)h(an)g(IRAF)427 1858 y Ft(")p Fi(TNX)p Ft(")g
+Fi(pro)5 b(jection)26 b(whic)n(h)i(includes)g(terms)f(not)h(supproted)f
+(b)n(y)g(AST.)i(Suc)n(h)e(terms)h(are)e(ignored)h(and)427
+1958 y(so)g(the)h(resulting)f(F)-7 b(rameSet)28 b(ma)n(y)e(b)r(e)i
+(inaccurate.)340 2110 y Fh(\017)45 b Ft(")p Fi(Zp)n(x)p
+Ft(")p Fi(:)39 b(This)29 b(condition)g(arises)e(if)j(a)f(F)-7
+b(rameSet)29 b(is)g(read)f(from)h(a)f(FITS)i(header)e(con)n(taining)g
+(an)h(IRAF)427 2210 y Ft(")p Fi(ZPX)p Ft(")24 b Fi(pro)5
+b(jection)25 b(whic)n(h)g(includes)h Ft(")p Fi(lngcor)p
+Ft(")d Fi(or)h Ft(")p Fi(latcor)p Ft(")g Fi(correction)f(terms.)36
+b(These)25 b(terms)g(are)g(not)427 2309 y(supp)r(orted)j(b)n(y)f(AST)h
+(and)f(are)g(ignored.)36 b(The)27 b(resulting)g(F)-7
+b(rameSet)28 b(ma)n(y)f(therefore)f(b)r(e)i(inaccurate.)p
+0 2548 3780 12 v 0 2686 a Fz(AsTime\(axis\))1116 2680
+y Fe(F)-10 b(ormat)37 b(celestal)g(co)s(ordinates)g(as)1725
+2779 y(times?)2989 2686 y Fz(AsTime\(axis\))0 2989 y
+Fd(Description:)44 b Fi(This)28 b(attribute)f(sp)r(eci\014es)h(the)g
+(default)g(st)n(yle)f(of)g(formatting)g(to)g(b)r(e)h(used)g(\(e.g.)36
+b(b)n(y)27 b(astF)-7 b(ormat\))27 b(for)227 3089 y(the)e(celestial)f
+(co)r(ordinate)g(v)-5 b(alues)24 b(describ)r(ed)g(b)n(y)h(a)f(SkyF)-7
b(rame.)35 b(It)25 b(tak)n(es)f(a)g(separate)f(b)r(o)r(olean)h(v)-5
-b(alue)24 b(for)g(eac)n(h)227 1662 y(SkyF)-7 b(rame)32
+b(alue)24 b(for)g(eac)n(h)227 3188 y(SkyF)-7 b(rame)32
b(axis)g(so)f(that,)j(for)e(instance,)i(the)f(setting)f
Ft(")p Fi(AsTime\(2\)=0)p Ft(")f Fi(sp)r(eci\014es)h(the)h(default)g
-(formatting)227 1761 y(st)n(yle)27 b(for)h(celestial)f(latitude)h(v)-5
-b(alues.)227 1884 y(If)23 b(the)f(AsTime)g(attribute)g(for)g(a)g(SkyF)
+(formatting)227 3288 y(st)n(yle)27 b(for)h(celestial)f(latitude)h(v)-5
+b(alues.)227 3432 y(If)23 b(the)f(AsTime)g(attribute)g(for)g(a)g(SkyF)
-7 b(rame)21 b(axis)g(is)h(zero,)g(then)g(co)r(ordinates)f(on)h(that)g
-(axis)f(will)h(b)r(e)h(formatted)227 1983 y(as)e(angles)f(b)n(y)h
+(axis)f(will)h(b)r(e)h(formatted)227 3532 y(as)e(angles)f(b)n(y)h
(default)g(\(using)g(degrees,)g(min)n(utes)h(and)f(seconds\),)h
(otherwise)e(they)h(will)g(b)r(e)h(formatted)f(as)f(times)227
-2083 y(\(using)28 b(hours,)f(min)n(utes)g(and)h(seconds\).)227
-2205 y(The)h(default)h(v)-5 b(alue)29 b(of)g(AsTime)h(is)f(c)n(hosen)f
+3631 y(\(using)28 b(hours,)f(min)n(utes)g(and)h(seconds\).)227
+3776 y(The)h(default)h(v)-5 b(alue)29 b(of)g(AsTime)h(is)f(c)n(hosen)f
(according)f(to)i(the)h(sky)f(co)r(ordinate)f(system)g(b)r(eing)i
-(represen)n(ted,)227 2305 y(as)22 b(determined)i(b)n(y)e(the)h(SkyF)-7
+(represen)n(ted,)227 3875 y(as)22 b(determined)i(b)n(y)e(the)h(SkyF)-7
b(rame's)22 b(System)h(attribute.)36 b(This)23 b(ensures,)g(for)f
-(example,)i(that)f(righ)n(t)f(ascension)227 2405 y(v)-5
+(example,)i(that)f(righ)n(t)f(ascension)227 3975 y(v)-5
b(alues)27 b(will)h(b)r(e)g(formatted)g(as)f(times)g(b)n(y)h(default,)g
-(follo)n(wing)e(normal)h(con)n(v)n(en)n(tions.)0 2550
-y Fd(T)m(yp)s(e:)227 2649 y Fi(In)n(teger)g(\(b)r(o)r(olean\).)0
-2795 y Fd(Class)k(Applicabilit)m(y:)259 2927 y(SkyF)-8
-b(rame)427 3026 y Fi(All)28 b(SkyF)-7 b(rames)27 b(ha)n(v)n(e)f(this)i
-(attribute.)0 3184 y Fd(Notes:)340 3462 y Fh(\017)45
+(follo)n(wing)e(normal)h(con)n(v)n(en)n(tions.)0 4164
+y Fd(T)m(yp)s(e:)227 4263 y Fi(In)n(teger)g(\(b)r(o)r(olean\).)0
+4452 y Fd(Class)k(Applicabilit)m(y:)259 4628 y(SkyF)-8
+b(rame)427 4728 y Fi(All)28 b(SkyF)-7 b(rames)27 b(ha)n(v)n(e)f(this)i
+(attribute.)0 4929 y Fd(Notes:)340 5251 y Fh(\017)45
b Fi(The)d(AsTime)g(attribute)g(op)r(erates)e(b)n(y)h(c)n(hanging)g
(the)h(default)g(v)-5 b(alue)41 b(of)h(the)g(corresp)r(onding)e(F)-7
-b(or-)427 3562 y(mat\(axis\))28 b(attribute.)37 b(This,)27
+b(or-)427 5351 y(mat\(axis\))28 b(attribute.)37 b(This,)27
b(in)h(turn,)g(ma)n(y)f(also)f(a\013ect)i(the)g(v)-5
b(alue)28 b(of)f(the)h(Unit\(axis\))g(attribute.)340
-3691 y Fh(\017)45 b Fi(Only)38 b(the)g(default)h(st)n(yle)e(of)h
+5503 y Fh(\017)45 b Fi(Only)38 b(the)g(default)h(st)n(yle)e(of)h
(formatting)f(is)h(a\013ected)g(b)n(y)g(the)g(AsTime)g(v)-5
-b(alue.)68 b(If)39 b(an)e(explicit)i(F)-7 b(or-)427 3790
+b(alue.)68 b(If)39 b(an)e(explicit)i(F)-7 b(or-)427 5603
y(mat\(axis\))28 b(v)-5 b(alue)27 b(is)h(set,)f(it)h(will)g(o)n(v)n
(er-ride)d(an)n(y)i(e\013ect)h(from)f(the)h(AsTime)g(attribute.)p
-0 3981 V 0 4112 a Fz(Base)1181 4113 y Fe(F)-10 b(rameSet)37
-b(base)i(F)-10 b(rame)39 b(index)3504 4112 y Fz(Base)0
-4270 y Fd(Description:)44 b Fi(This)28 b(attribute)g(giv)n(es)f(the)h
+eop end
+%%Page: 424 434
+TeXDict begin 424 433 bop 0 52 a FF(424)1994 b Fy(C)91
+b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
+3780 12 v 0 482 a Fz(Base)1181 483 y Fe(F)-10 b(rameSet)37
+b(base)i(F)-10 b(rame)39 b(index)3504 482 y Fz(Base)0
+640 y Fd(Description:)44 b Fi(This)28 b(attribute)g(giv)n(es)f(the)h
(index)g(of)f(the)h(F)-7 b(rame)28 b(whic)n(h)f(is)h(to)g(b)r(e)g
(regarded)e(as)h(the)h Ft(")p Fi(base)p Ft(")e Fi(F)-7
-b(rame)227 4370 y(within)30 b(a)e(F)-7 b(rameSet.)40
-b(The)28 b(default)h(is)g(the)g(\014rst)f(F)-7 b(rame)28
-b(added)h(to)f(the)h(F)-7 b(rameSet)29 b(when)g(it)g(is)f(created)g
-(\(this)227 4469 y(F)-7 b(rame)27 b(alw)n(a)n(ys)f(has)h(an)g(index)h
-(of)g(1\).)0 4614 y Fd(T)m(yp)s(e:)227 4714 y Fi(In)n(teger.)0
-4859 y Fd(Class)j(Applicabilit)m(y:)259 4991 y(F)-8 b(rameSet)427
-5091 y Fi(All)28 b(F)-7 b(rameSets)27 b(ha)n(v)n(e)g(this)h(attribute.)
-0 5249 y Fd(Notes:)340 5527 y Fh(\017)45 b Fi(In)n(v)n(erting)29
+b(rame)227 740 y(within)30 b(a)e(F)-7 b(rameSet.)40 b(The)28
+b(default)h(is)g(the)g(\014rst)f(F)-7 b(rame)28 b(added)h(to)f(the)h(F)
+-7 b(rameSet)29 b(when)g(it)g(is)f(created)g(\(this)227
+839 y(F)-7 b(rame)27 b(alw)n(a)n(ys)f(has)h(an)g(index)h(of)g(1\).)0
+984 y Fd(T)m(yp)s(e:)227 1084 y Fi(In)n(teger.)0 1229
+y Fd(Class)j(Applicabilit)m(y:)259 1361 y(F)-8 b(rameSet)427
+1461 y Fi(All)28 b(F)-7 b(rameSets)27 b(ha)n(v)n(e)g(this)h(attribute.)
+0 1618 y Fd(Notes:)340 1897 y Fh(\017)45 b Fi(In)n(v)n(erting)29
b(a)g(F)-7 b(rameSet)29 b(\(in)n(v)n(erting)g(the)h(b)r(o)r(olean)f
(sense)g(of)h(its)g(In)n(v)n(ert)e(attribute,)j(with)f(the)g(astIn)n(v)
-n(ert)427 5627 y(function)e(for)g(example\))f(will)h(in)n(terc)n(hange)
+n(ert)427 1996 y(function)e(for)g(example\))f(will)h(in)n(terc)n(hange)
e(the)i(v)-5 b(alues)27 b(of)h(its)f(Base)g(and)g(Curren)n(t)g
-(attributes.)p eop end
-%%Page: 424 434
-TeXDict begin 424 433 bop 0 52 a FF(424)1994 b Fy(C)91
-b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
-3780 12 v 0 483 a Fz(Border)298 b Fe(Dra)m(w)38 b(a)h(b)s(order)f
-(around)f(v)-7 b(alid)38 b(regions)g(of)g(a)h(Plot?)297
-b Fz(Border)0 687 y Fd(Description:)44 b Fi(This)30 b(attribute)g(con)n
-(trols)e(the)i(app)r(earance)f(of)g(an)h(annotated)f(co)r(ordinate)g
-(grid)g(\(dra)n(wn)g(with)h(the)227 787 y(astGrid)e(function\))i(b)n(y)
-e(determining)h(whether)g(a)f(b)r(order)g(is)g(dra)n(wn)g(around)g
-(regions)f(corresp)r(onding)g(to)h(the)227 887 y(v)-5
-b(alid)28 b(ph)n(ysical)f(co)r(ordinates)f(of)h(a)h(Plot)f(\(c.f.)37
-b(astBorder\).)227 1017 y(If)j(the)g(Border)d(v)-5 b(alue)39
-b(of)g(a)g(Plot)g(is)g(non-zero,)h(then)g(this)g(b)r(order)e(will)h(b)r
-(e)h(dra)n(wn)e(as)h(part)f(of)i(the)f(grid.)227 1116
-y(Otherwise,)32 b(the)g(b)r(order)e(is)i(not)f(dra)n(wn)g(\(although)g
-(axis)g(lab)r(els)g(and)g(tic)n(k)g(marks)g(will)g(still)h(app)r(ear,)g
-(unless)227 1216 y(other)25 b(relev)-5 b(an)n(t)24 b(Plot)g(attributes)
-h(indicate)f(that)i(they)f(should)f(not\).)36 b(The)25
-b(default)h(b)r(eha)n(viour)d(is)i(to)g(dra)n(w)e(the)227
-1316 y(b)r(order)j(if)i(tic)n(k)e(marks)g(and)h(n)n(umerical)f(lab)r
+(attributes.)p 0 2187 V 0 2319 a Fz(Border)298 b Fe(Dra)m(w)38
+b(a)h(b)s(order)f(around)f(v)-7 b(alid)38 b(regions)g(of)g(a)h(Plot?)
+297 b Fz(Border)0 2503 y Fd(Description:)44 b Fi(This)30
+b(attribute)g(con)n(trols)e(the)i(app)r(earance)f(of)g(an)h(annotated)f
+(co)r(ordinate)g(grid)g(\(dra)n(wn)g(with)h(the)227 2603
+y(astGrid)e(function\))i(b)n(y)e(determining)h(whether)g(a)f(b)r(order)
+g(is)g(dra)n(wn)g(around)g(regions)f(corresp)r(onding)g(to)h(the)227
+2703 y(v)-5 b(alid)28 b(ph)n(ysical)f(co)r(ordinates)f(of)h(a)h(Plot)f
+(\(c.f.)37 b(astBorder\).)227 2825 y(If)j(the)g(Border)d(v)-5
+b(alue)39 b(of)g(a)g(Plot)g(is)g(non-zero,)h(then)g(this)g(b)r(order)e
+(will)h(b)r(e)h(dra)n(wn)e(as)h(part)f(of)i(the)f(grid.)227
+2925 y(Otherwise,)32 b(the)g(b)r(order)e(is)i(not)f(dra)n(wn)g
+(\(although)g(axis)g(lab)r(els)g(and)g(tic)n(k)g(marks)g(will)g(still)h
+(app)r(ear,)g(unless)227 3024 y(other)25 b(relev)-5 b(an)n(t)24
+b(Plot)g(attributes)h(indicate)f(that)i(they)f(should)f(not\).)36
+b(The)25 b(default)h(b)r(eha)n(viour)d(is)i(to)g(dra)n(w)e(the)227
+3124 y(b)r(order)j(if)i(tic)n(k)e(marks)g(and)h(n)n(umerical)f(lab)r
(els)h(will)g(b)r(e)g(dra)n(wn)f(around)g(the)h(edges)f(of)h(the)g
-(plotting)g(area)f(\(see)227 1415 y(the)i(Lab)r(elling)f(attribute\),)i
-(but)f(to)f(omit)h(it)g(otherwise.)0 1576 y Fd(T)m(yp)s(e:)227
-1675 y Fi(In)n(teger)f(\(b)r(o)r(olean\).)0 1836 y Fd(Class)k
-(Applicabilit)m(y:)259 1983 y(Plot)427 2083 y Fi(All)d(Plots)f(ha)n(v)n
-(e)g(this)g(attribute.)p 0 2293 V 0 2431 a Fz(Bottom\(axis\))1173
-2424 y Fe(Lo)m(w)m(est)37 b(axis)h(v)-7 b(alue)39 b(to)f(displa)m(y)
-3001 2431 y Fz(Bottom\(axis\))0 2642 y Fd(Description:)44
+(plotting)g(area)f(\(see)227 3224 y(the)i(Lab)r(elling)f(attribute\),)i
+(but)f(to)f(omit)h(it)g(otherwise.)0 3369 y Fd(T)m(yp)s(e:)227
+3468 y Fi(In)n(teger)f(\(b)r(o)r(olean\).)0 3614 y Fd(Class)k
+(Applicabilit)m(y:)259 3746 y(Plot)427 3845 y Fi(All)d(Plots)f(ha)n(v)n
+(e)g(this)g(attribute.)p 0 4036 V 0 4174 a Fz(Bottom\(axis\))1173
+4168 y Fe(Lo)m(w)m(est)37 b(axis)h(v)-7 b(alue)39 b(to)f(displa)m(y)
+3001 4174 y Fz(Bottom\(axis\))0 4366 y Fd(Description:)44
b Fi(This)34 b(attribute)h(giv)n(es)e(the)h(lo)n(w)n(est)f(axis)h(v)-5
b(alue)34 b(to)g(b)r(e)g(displa)n(y)n(ed)f(\(for)h(instance,)i(b)n(y)e
-(the)g(astGrid)227 2742 y(metho)r(d\).)0 2902 y Fd(T)m(yp)s(e:)227
-3002 y Fi(Floating)27 b(p)r(oin)n(t.)0 3162 y Fd(Class)k(Applicabilit)m
-(y:)259 3310 y(F)-8 b(rame)427 3409 y Fi(The)28 b(default)g(supplied)g
+(the)g(astGrid)227 4465 y(metho)r(d\).)0 4610 y Fd(T)m(yp)s(e:)227
+4710 y Fi(Floating)27 b(p)r(oin)n(t.)0 4855 y Fd(Class)k(Applicabilit)m
+(y:)259 4987 y(F)-8 b(rame)427 5087 y Fi(The)28 b(default)g(supplied)g
(b)n(y)f(the)h(F)-7 b(rame)27 b(class)g(is)g(to)h(displa)n(y)f(all)g
(axis)g(v)-5 b(alues,)27 b(without)h(an)n(y)f(limit.)259
-3548 y Fd(SkyF)-8 b(rame)427 3647 y Fi(The)27 b(SkyF)-7
+5216 y Fd(SkyF)-8 b(rame)427 5315 y Fi(The)27 b(SkyF)-7
b(rame)25 b(class)g(re-de\014nes)h(the)h(default)f(Bottom)g(v)-5
b(alue)26 b(to)h(-90)e(degrees)g(for)g(latitude)i(axes,)f(and)427
-3747 y(0)h(degrees)g(for)g(co-latitude)g(axes.)36 b(The)27
+5415 y(0)h(degrees)g(for)g(co-latitude)g(axes.)36 b(The)27
b(default)i(for)e(longitude)g(axes)g(is)g(to)h(displa)n(y)e(all)i(axis)
-f(v)-5 b(alues.)0 3920 y Fd(Notes:)340 4213 y Fh(\017)45
-b Fi(When)36 b(sp)r(ecifying)f(this)h(attribute)f(b)n(y)g(name,)i(it)f
-(should)f(b)r(e)h(subscripted)f(with)g(the)h(n)n(um)n(b)r(er)f(of)g
-(the)427 4313 y(F)-7 b(rame)27 b(axis)g(to)h(whic)n(h)f(it)h(applies.)p
-0 4523 V 0 4655 a Fz(Bounded)758 b Fe(Is)40 b(the)e(Region)g(b)s
-(ounded?)759 b Fz(Bounded)0 4854 y Fd(Description:)44
-b Fi(This)27 b(is)g(a)f(read-only)g(attribute)h(indicating)f(if)i(the)f
-(Region)f(is)h(b)r(ounded.)37 b(A)27 b(Region)f(is)h(b)r(ounded)g(if)
-227 4954 y(it)h(is)g(con)n(tained)f(en)n(tirely)g(within)h(some)f
-(\014nite-size)g(b)r(ounding)h(b)r(o)n(x.)0 5115 y Fd(T)m(yp)s(e:)227
-5214 y Fi(In)n(teger)f(\(b)r(o)r(olean\),)h(read-only)-7
-b(.)0 5375 y Fd(Class)31 b(Applicabilit)m(y:)259 5522
-y(Region)427 5622 y Fi(All)d(Regions)f(ha)n(v)n(e)f(this)i(attribute.)p
-eop end
+f(v)-5 b(alues.)0 5572 y Fd(Notes:)p eop end
%%Page: 425 435
-TeXDict begin 425 434 bop 3643 52 a FF(425)p 0 351 3780
-12 v 0 483 a Fz(CDMatrix)298 b Fe(Use)39 b(CDi)p Fb(_)p
-Fe(j)f(k)m(eyw)m(ords)f(to)h(represen)m(t)g(pixel)1338
-598 y(scaling,)f(rotation,)e(etc?)3171 483 y Fz(CDMatrix)0
-791 y Fd(Description:)44 b Fi(This)26 b(attribute)f(is)g(a)g(b)r(o)r
+TeXDict begin 425 434 bop 3643 52 a FF(425)340 351 y
+Fh(\017)45 b Fi(When)36 b(sp)r(ecifying)f(this)h(attribute)f(b)n(y)g
+(name,)i(it)f(should)f(b)r(e)h(subscripted)f(with)g(the)h(n)n(um)n(b)r
+(er)f(of)g(the)427 451 y(F)-7 b(rame)27 b(axis)g(to)h(whic)n(h)f(it)h
+(applies.)p 0 654 3780 12 v 0 786 a Fz(Bounded)758 b
+Fe(Is)40 b(the)e(Region)g(b)s(ounded?)759 b Fz(Bounded)0
+979 y Fd(Description:)44 b Fi(This)27 b(is)g(a)f(read-only)g(attribute)
+h(indicating)f(if)i(the)f(Region)f(is)h(b)r(ounded.)37
+b(A)27 b(Region)f(is)h(b)r(ounded)g(if)227 1078 y(it)h(is)g(con)n
+(tained)f(en)n(tirely)g(within)h(some)f(\014nite-size)g(b)r(ounding)h
+(b)r(o)n(x.)0 1232 y Fd(T)m(yp)s(e:)227 1332 y Fi(In)n(teger)f(\(b)r(o)
+r(olean\),)h(read-only)-7 b(.)0 1485 y Fd(Class)31 b(Applicabilit)m(y:)
+259 1626 y(Region)427 1725 y Fi(All)d(Regions)f(ha)n(v)n(e)f(this)i
+(attribute.)p 0 1929 V 0 2060 a Fz(CDMatrix)298 b Fe(Use)39
+b(CDi)p Fb(_)p Fe(j)f(k)m(eyw)m(ords)f(to)h(represen)m(t)g(pixel)1338
+2175 y(scaling,)f(rotation,)e(etc?)3171 2060 y Fz(CDMatrix)0
+2368 y Fd(Description:)44 b Fi(This)26 b(attribute)f(is)g(a)g(b)r(o)r
(olean)g(v)-5 b(alue)25 b(whic)n(h)g(sp)r(eci\014es)g(ho)n(w)g(the)h
-(linear)e(transformation)g(from)h(pixel)227 890 y(co)r(ordinates)d(to)g
-(in)n(termediate)h(w)n(orld)e(co)r(ordinates)h(should)g(b)r(e)i
+(linear)e(transformation)g(from)h(pixel)227 2467 y(co)r(ordinates)d(to)
+g(in)n(termediate)h(w)n(orld)e(co)r(ordinates)h(should)g(b)r(e)i
(represen)n(ted)d(within)j(a)e(FitsChan)h(when)g(using)227
-990 y(FITS-W)n(CS)29 b(enco)r(ding.)40 b(This)29 b(transformation)e
+2567 y(FITS-W)n(CS)29 b(enco)r(ding.)40 b(This)29 b(transformation)e
(describ)r(es)h(the)h(scaling,)f(rotation,)g(shear,)g(etc.,)h(of)f(the)
-i(pixel)227 1090 y(axes.)227 1216 y(If)38 b(the)g(attribute)g(has)f(a)g
+i(pixel)227 2667 y(axes.)227 2793 y(If)38 b(the)g(attribute)g(has)f(a)g
(non-zero)f(v)-5 b(alue)38 b(then)g(the)g(transformation)e(is)h
(represen)n(ted)g(b)n(y)g(a)g(set)h(of)f(CDi)p Ft(_)p
-Fi(j)227 1316 y(k)n(eyw)n(ords)23 b(represen)n(ting)g(a)i(square)e
+Fi(j)227 2893 y(k)n(eyw)n(ords)23 b(represen)n(ting)g(a)i(square)e
(matrix)h(\(where)h Ft(")p Fi(i)p Ft(")f Fi(is)g(the)i(index)e(of)h(an)
-g(in)n(termediate)f(w)n(orld)g(co)r(ordinate)227 1415
+g(in)n(termediate)f(w)n(orld)g(co)r(ordinate)227 2992
y(axis)36 b(and)f Ft(")p Fi(j)p Ft(")h Fi(is)g(the)g(index)g(of)g(a)g
(pixel)g(axis\).)62 b(If)36 b(the)h(attribute)f(has)f(a)h(zero)f(v)-5
-b(alue)36 b(the)g(transformation)227 1515 y(is)f(represen)n(ted)e(b)n
+b(alue)36 b(the)g(transformation)227 3092 y(is)f(represen)n(ted)e(b)n
(y)i(a)f(set)g(of)h(PCi)p Ft(_)p Fi(j)f(k)n(eyw)n(ords)f(\(whic)n(h)i
(also)e(represen)n(t)g(a)i(square)e(matrix\))h(together)g(with)227
-1615 y(a)i(corresp)r(onding)f(set)h(of)g(CDEL)-7 b(Ti)37
+3192 y(a)i(corresp)r(onding)f(set)h(of)g(CDEL)-7 b(Ti)37
b(k)n(eyw)n(ords)d(represen)n(ting)h(the)i(axis)e(scalings.)62
-b(See)37 b(FITS-W)n(CS)f(pap)r(er)227 1714 y(I)r(I)i
+b(See)37 b(FITS-W)n(CS)f(pap)r(er)227 3291 y(I)r(I)i
Ft(")p Fi(Represen)n(tation)d(of)i(Celestial)g(Co)r(ordinates)f(in)h
(FITS)p Ft(")g Fi(b)n(y)g(M.)g(Calabretta)f(&)g(E.W.)i(Greisen,)g(for)f
-(a)227 1814 y(complete)28 b(description)f(of)g(these)h(t)n(w)n(o)f(sc)n
-(hemes.)227 1941 y(The)g(default)f(v)-5 b(alue)26 b(of)g(the)h
+(a)227 3391 y(complete)28 b(description)f(of)g(these)h(t)n(w)n(o)f(sc)n
+(hemes.)227 3517 y(The)g(default)f(v)-5 b(alue)26 b(of)g(the)h
(CDMatrix)f(attribute)g(is)h(determined)f(b)n(y)g(the)g(con)n(ten)n(ts)
-g(of)g(the)h(FitsChan)f(at)g(the)227 2040 y(time)f(the)g(attribute)f
+g(of)g(the)h(FitsChan)f(at)g(the)227 3617 y(time)f(the)g(attribute)f
(is)g(accessed.)35 b(If)24 b(the)h(FitsChan)f(con)n(tains)f(an)n(y)h
(CDi)p Ft(_)p Fi(j)h(k)n(eyw)n(ords)d(then)i(the)h(default)g(v)-5
-b(alue)227 2140 y(is)21 b(non-zero.)32 b(Otherwise)20
+b(alue)227 3717 y(is)21 b(non-zero.)32 b(Otherwise)20
b(it)h(is)f(zero.)33 b(Note,)22 b(reading)d(a)h(F)-7
b(rameSet)20 b(from)g(a)g(FitsChan)h(will)f(in)h(general)e(consume)227
-2240 y(an)n(y)33 b(CDi)p Ft(_)p Fi(j)i(k)n(eyw)n(ords)d(presen)n(t)h
+3816 y(an)n(y)33 b(CDi)p Ft(_)p Fi(j)i(k)n(eyw)n(ords)d(presen)n(t)h
(in)h(the)g(FitsChan.)56 b(Th)n(us)34 b(the)g(default)g(v)-5
-b(alue)34 b(for)g(CDMatrix)f(follo)n(wing)g(a)227 2339
+b(alue)34 b(for)g(CDMatrix)f(follo)n(wing)g(a)227 3916
y(read)g(will)g(usually)g(b)r(e)h(zero,)g(ev)n(en)f(if)h(the)g
(FitsChan)f(originally)f(con)n(tained)h(some)g(CDi)p
-Ft(_)p Fi(j)g(k)n(eyw)n(ords.)53 b(This)227 2439 y(b)r(eha)n(viour)31
+Ft(_)p Fi(j)g(k)n(eyw)n(ords.)53 b(This)227 4016 y(b)r(eha)n(viour)31
b(is)g(similar)g(to)g(that)h(of)f(the)h(Enco)r(ding)f(attribute,)h(the)
g(default)g(v)-5 b(alue)32 b(for)f(whic)n(h)g(is)g(determined)227
-2538 y(b)n(y)i(the)g(con)n(ten)n(ts)g(of)f(the)i(FitsChan)f(at)g(the)g
+4115 y(b)n(y)i(the)g(con)n(ten)n(ts)g(of)f(the)i(FitsChan)f(at)g(the)g
(time)g(the)h(attribute)f(is)g(accessed.)51 b(If)34 b(y)n(ou)e(wish)h
-(to)g(retain)f(the)227 2638 y(original)24 b(v)-5 b(alue)25
+(to)g(retain)f(the)227 4215 y(original)24 b(v)-5 b(alue)25
b(of)g(the)h(CDMatrix)f(attribute)g(\(that)h(is,)f(the)h(v)-5
b(alue)25 b(b)r(efore)g(reading)f(the)h(F)-7 b(rameSet\))26
-b(then)f(y)n(ou)227 2738 y(should)j(enquire)f(the)h(default)g(v)-5
+b(then)f(y)n(ou)227 4314 y(should)j(enquire)f(the)h(default)g(v)-5
b(alue)27 b(b)r(efore)h(doing)f(the)h(read,)e(and)i(then)g(set)f(that)h
-(v)-5 b(alue)28 b(explicitly)-7 b(.)0 2891 y Fd(T)m(yp)s(e:)227
-2991 y Fi(In)n(teger)27 b(\(b)r(o)r(olean\).)0 3145 y
-Fd(Class)k(Applicabilit)m(y:)259 3286 y(FitsChan)427
-3385 y Fi(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)p
-0 3589 V 0 3720 a Fz(CarLin)268 b Fe(Ignore)38 b(spherical)g(rotations)
-e(on)i(CAR)h(pro)7 b(jections?)265 b Fz(CarLin)0 3918
+(v)-5 b(alue)28 b(explicitly)-7 b(.)0 4468 y Fd(T)m(yp)s(e:)227
+4568 y Fi(In)n(teger)27 b(\(b)r(o)r(olean\).)0 4721 y
+Fd(Class)k(Applicabilit)m(y:)259 4862 y(FitsChan)427
+4961 y Fi(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)p
+0 5165 V 0 5296 a Fz(CarLin)268 b Fe(Ignore)38 b(spherical)g(rotations)
+e(on)i(CAR)h(pro)7 b(jections?)265 b Fz(CarLin)0 5494
y Fd(Description:)44 b Fi(This)e(attribute)f(is)g(a)g(b)r(o)r(olean)g
(v)-5 b(alue)41 b(whic)n(h)g(sp)r(eci\014es)g(ho)n(w)g(FITS)g
Ft(")p Fi(CAR)p Ft(")g Fi(\(plate)g(carree,)i(or)227
-4018 y Ft(")p Fi(Cartesian)p Ft(")p Fi(\))23 b(pro)5
+5593 y Ft(")p Fi(Cartesian)p Ft(")p Fi(\))23 b(pro)5
b(jections)24 b(should)h(b)r(e)g(treated)g(when)g(reading)f(a)g(F)-7
b(rameSet)25 b(from)g(a)f(foreign)g(enco)r(ded)h(FITS)227
-4117 y(header.)43 b(If)30 b(zero)f(\(the)h(default\),)h(it)g(is)e
+5693 y(header.)43 b(If)30 b(zero)f(\(the)h(default\),)h(it)g(is)e
(assumed)h(that)g(the)g(CAR)g(pro)5 b(jection)29 b(conforms)f(to)i(the)
-g(con)n(v)n(en)n(tions)227 4217 y(describ)r(ed)j(in)g(the)h(FITS)f(w)n
-(orld)f(co)r(ordinate)g(system)h(\(FITS-W)n(CS\))h(pap)r(er)e(I)r(I)i
-Ft(")p Fi(Represen)n(tation)d(of)i(Celes-)227 4317 y(tial)h(Co)r
-(ordinates)e(in)h(FITS)p Ft(")h Fi(b)n(y)f(M.)g(Calabretta)g(&)g(E.W.)g
-(Greisen.)54 b(If)34 b(CarLin)e(is)h(non-zero,)h(then)g(these)227
-4416 y(con)n(v)n(en)n(tions)f(are)g(ignored,)i(and)f(it)h(is)f(assumed)
-g(that)h(the)f(mapping)h(from)f(pixel)g(co)r(ordinates)f(to)h
-(celestial)227 4516 y(co)r(ordinates)25 b(is)h(a)g(simple)g(linear)f
+g(con)n(v)n(en)n(tions)p eop end
+%%Page: 426 436
+TeXDict begin 426 435 bop 0 52 a FF(426)1994 b Fy(C)91
+b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)227 351
+y Fi(describ)r(ed)i(in)g(the)h(FITS)f(w)n(orld)f(co)r(ordinate)g
+(system)h(\(FITS-W)n(CS\))h(pap)r(er)e(I)r(I)i Ft(")p
+Fi(Represen)n(tation)d(of)i(Celes-)227 451 y(tial)h(Co)r(ordinates)e
+(in)h(FITS)p Ft(")h Fi(b)n(y)f(M.)g(Calabretta)g(&)g(E.W.)g(Greisen.)54
+b(If)34 b(CarLin)e(is)h(non-zero,)h(then)g(these)227
+551 y(con)n(v)n(en)n(tions)f(are)g(ignored,)i(and)f(it)h(is)f(assumed)g
+(that)h(the)f(mapping)h(from)f(pixel)g(co)r(ordinates)f(to)h(celestial)
+227 650 y(co)r(ordinates)25 b(is)h(a)g(simple)g(linear)f
(transformation)g(\(hence)h(the)h(attribute)f(name)g
Ft(")p Fi(CarLin)p Ft(")p Fi(\).)35 b(This)26 b(is)g(appro-)227
-4616 y(priate)31 b(for)f(some)g(older)g(FITS)h(data)f(whic)n(h)h
-(claims)f(to)h(ha)n(v)n(e)f(a)g Ft(")p Fi(CAR)p Ft(")g
-Fi(pro)5 b(jection,)31 b(but)g(whic)n(h)g(in)g(fact)g(do)227
-4715 y(not)d(conform)g(to)g(the)g(con)n(v)n(en)n(tions)e(of)i(the)h
-(FITS-W)n(CS)f(pap)r(er.)38 b(F)-7 b(urthermore,)27 b(if)i(CarLin)e(is)
-h(non-zero,)e(it)j(is)227 4815 y(assumed)i(that)h(CDEL)-7
+750 y(priate)31 b(for)f(some)g(older)g(FITS)h(data)f(whic)n(h)h(claims)
+f(to)h(ha)n(v)n(e)f(a)g Ft(")p Fi(CAR)p Ft(")g Fi(pro)5
+b(jection,)31 b(but)g(whic)n(h)g(in)g(fact)g(do)227 849
+y(not)d(conform)g(to)g(the)g(con)n(v)n(en)n(tions)e(of)i(the)h(FITS-W)n
+(CS)f(pap)r(er.)38 b(F)-7 b(urthermore,)27 b(if)i(CarLin)e(is)h
+(non-zero,)e(it)j(is)227 949 y(assumed)i(that)h(CDEL)-7
b(T)31 b(and)h(CD)f(k)n(eyw)n(ords)f(are)g(in)i(units)g(of)f(degrees)f
-(rather)h(than)g(radians)f(\(as)i(required)227 4914 y(b)n(y)c(the)g
-(FITS-W)n(CS)f(pap)r(ers\).)227 5041 y(The)34 b(FITS-W)n(CS)g(pap)r(er)
+(rather)h(than)g(radians)f(\(as)i(required)227 1049 y(b)n(y)c(the)g
+(FITS-W)n(CS)f(pap)r(ers\).)227 1166 y(The)34 b(FITS-W)n(CS)g(pap)r(er)
g(sp)r(eci\014es)g(that)g(headers)f(whic)n(h)h(include)g(a)g(CAR)g(pro)
-5 b(jection)33 b(represen)n(t)g(a)g(linear)227 5141 y(mapping)c(from)f
+5 b(jection)33 b(represen)n(t)g(a)g(linear)227 1266 y(mapping)c(from)f
(pixel)h(co)r(ordinates)e(to)h Ft(")p Fi(nativ)n(e)g(spherical)g(co)r
(ordinates)p Ft(")p Fi(,)f(NOT)h(celestial)h(co)r(ordinates.)38
-b(An)227 5240 y(extra)30 b(mapping)g(is)h(then)g(required)f(from)g
+b(An)227 1365 y(extra)30 b(mapping)g(is)h(then)g(required)f(from)g
(nativ)n(e)g(spherical)g(to)g(celestial.)45 b(This)31
-b(mapping)f(is)h(a)f(3D)h(rotation)227 5340 y(and)e(so)f(the)h(o)n(v)n
+b(mapping)f(is)h(a)f(3D)h(rotation)227 1465 y(and)e(so)f(the)h(o)n(v)n
(erall)e(Mapping)h(from)h(pixel)f(to)h(celestial)f(co)r(ordinates)g(is)
-g(NOT)h(linear.)40 b(See)28 b(the)h(FITS-W)n(CS)227 5440
-y(pap)r(ers)e(for)g(further)h(details.)0 5593 y Fd(T)m(yp)s(e:)227
-5693 y Fi(In)n(teger)f(\(b)r(o)r(olean\).)p eop end
-%%Page: 426 436
-TeXDict begin 426 435 bop 0 52 a FF(426)1994 b Fy(C)91
-b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)0 351 y
-Fd(Class)g(Applicabilit)m(y:)259 497 y(FitsChan)427 597
-y Fi(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)p
-0 805 3780 12 v 0 937 a Fz(Card)528 b Fe(Index)39 b(of)f(curren)m(t)g
-(FITS)h(card)f(in)h(a)f(FitsChan)526 b Fz(Card)0 1112
-y Fd(Description:)44 b Fi(This)28 b(attribute)g(giv)n(es)f(the)h(index)
-g(of)g(the)g Ft(")p Fi(curren)n(t)p Ft(")e Fi(FITS)i(header)f(card)g
-(within)i(a)e(FitsChan,)h(the)227 1212 y(\014rst)h(card)e(ha)n(ving)h
-(an)g(index)h(of)f(1.)40 b(The)28 b(c)n(hoice)g(of)h(curren)n(t)e(card)
-h(a\013ects)h(the)g(b)r(eha)n(viour)e(of)h(functions)h(that)227
-1311 y(access)e(the)h(con)n(ten)n(ts)f(of)g(the)h(FitsChan,)g(suc)n(h)f
-(as)g(astDelFits,)h(astFindFits)g(and)f(astPutFits.)227
-1440 y(A)f(v)-5 b(alue)25 b(assigned)f(to)h(Card)f(will)h(p)r(osition)g
-(the)h(FitsChan)f(at)g(an)n(y)g(desired)f(p)r(oin)n(t,)i(so)e(that)i(a)
-f(particular)e(card)227 1540 y(within)28 b(it)g(can)f(b)r(e)h
-(accessed.)36 b(Alternativ)n(ely)-7 b(,)27 b(the)h(v)-5
-b(alue)27 b(of)h(Card)e(ma)n(y)h(b)r(e)h(enquired)f(in)h(order)e(to)i
-(determine)227 1640 y(the)g(curren)n(t)f(p)r(osition)g(of)h(a)f
-(FitsChan.)227 1769 y(The)g(default)g(v)-5 b(alue)26
-b(of)h(Card)f(is)g(1.)36 b(This)27 b(means)f(that)h(clearing)e(this)i
-(attribute)g(\(using)f(astClear\))g(e\013ectiv)n(ely)227
-1868 y Ft(")p Fi(rewinds)p Ft(")32 b Fi(the)i(FitsChan,)h(so)e(that)h
-(the)g(\014rst)f(card)g(is)g(accessed)g(next.)54 b(If)34
-b(Card)f(is)g(set)h(to)f(a)g(v)-5 b(alue)34 b(whic)n(h)227
-1968 y(exceeds)26 b(the)h(total)f(n)n(um)n(b)r(er)g(of)g(cards)g(in)g
-(the)h(FitsChan)f(\(as)g(giv)n(en)g(b)n(y)g(its)g(Ncard)g(attribute\),)
-h(it)g(is)f(regarded)227 2068 y(as)e(p)r(oin)n(ting)g(at)g(the)g
-Ft(")p Fi(end-of-\014le)p Ft(")p Fi(.)35 b(In)24 b(this)g(case,)g(the)h
-(v)-5 b(alue)24 b(returned)g(in)g(resp)r(onse)f(to)h(an)g(enquiry)g(is)
-g(alw)n(a)n(ys)227 2167 y(one)j(more)g(than)h(the)g(n)n(um)n(b)r(er)f
-(of)h(cards)e(in)i(the)g(FitsChan.)0 2326 y Fd(T)m(yp)s(e:)227
-2426 y Fi(In)n(teger.)0 2585 y Fd(Class)j(Applicabilit)m(y:)259
-2730 y(FitsChan)427 2830 y Fi(All)d(FitsChans)g(ha)n(v)n(e)e(this)i
-(attribute.)p 0 3039 V 0 3170 a Fz(CardT)l(yp)t(e)313
+g(NOT)h(linear.)40 b(See)28 b(the)h(FITS-W)n(CS)227 1564
+y(pap)r(ers)e(for)g(further)h(details.)0 1699 y Fd(T)m(yp)s(e:)227
+1799 y Fi(In)n(teger)f(\(b)r(o)r(olean\).)0 1934 y Fd(Class)k
+(Applicabilit)m(y:)259 2056 y(FitsChan)427 2155 y Fi(All)d(FitsChans)g
+(ha)n(v)n(e)e(this)i(attribute.)p 0 2325 3780 12 v 0
+2457 a Fz(Card)528 b Fe(Index)39 b(of)f(curren)m(t)g(FITS)h(card)f(in)h
+(a)f(FitsChan)526 b Fz(Card)0 2593 y Fd(Description:)44
+b Fi(This)28 b(attribute)g(giv)n(es)f(the)h(index)g(of)g(the)g
+Ft(")p Fi(curren)n(t)p Ft(")e Fi(FITS)i(header)f(card)g(within)i(a)e
+(FitsChan,)h(the)227 2693 y(\014rst)h(card)e(ha)n(ving)h(an)g(index)h
+(of)f(1.)40 b(The)28 b(c)n(hoice)g(of)h(curren)n(t)e(card)h(a\013ects)h
+(the)g(b)r(eha)n(viour)e(of)h(functions)h(that)227 2793
+y(access)e(the)h(con)n(ten)n(ts)f(of)g(the)h(FitsChan,)g(suc)n(h)f(as)g
+(astDelFits,)h(astFindFits)g(and)f(astPutFits.)227 2910
+y(A)f(v)-5 b(alue)25 b(assigned)f(to)h(Card)f(will)h(p)r(osition)g(the)
+h(FitsChan)f(at)g(an)n(y)g(desired)f(p)r(oin)n(t,)i(so)e(that)i(a)f
+(particular)e(card)227 3009 y(within)28 b(it)g(can)f(b)r(e)h(accessed.)
+36 b(Alternativ)n(ely)-7 b(,)27 b(the)h(v)-5 b(alue)27
+b(of)h(Card)e(ma)n(y)h(b)r(e)h(enquired)f(in)h(order)e(to)i(determine)
+227 3109 y(the)g(curren)n(t)f(p)r(osition)g(of)h(a)f(FitsChan.)227
+3226 y(The)g(default)g(v)-5 b(alue)26 b(of)h(Card)f(is)g(1.)36
+b(This)27 b(means)f(that)h(clearing)e(this)i(attribute)g(\(using)f
+(astClear\))g(e\013ectiv)n(ely)227 3326 y Ft(")p Fi(rewinds)p
+Ft(")32 b Fi(the)i(FitsChan,)h(so)e(that)h(the)g(\014rst)f(card)g(is)g
+(accessed)g(next.)54 b(If)34 b(Card)f(is)g(set)h(to)f(a)g(v)-5
+b(alue)34 b(whic)n(h)227 3425 y(exceeds)26 b(the)h(total)f(n)n(um)n(b)r
+(er)g(of)g(cards)g(in)g(the)h(FitsChan)f(\(as)g(giv)n(en)g(b)n(y)g(its)
+g(Ncard)g(attribute\),)h(it)g(is)f(regarded)227 3525
+y(as)e(p)r(oin)n(ting)g(at)g(the)g Ft(")p Fi(end-of-\014le)p
+Ft(")p Fi(.)35 b(In)24 b(this)g(case,)g(the)h(v)-5 b(alue)24
+b(returned)g(in)g(resp)r(onse)f(to)h(an)g(enquiry)g(is)g(alw)n(a)n(ys)
+227 3625 y(one)j(more)g(than)h(the)g(n)n(um)n(b)r(er)f(of)h(cards)e(in)
+i(the)g(FitsChan.)0 3760 y Fd(T)m(yp)s(e:)227 3859 y
+Fi(In)n(teger.)0 3994 y Fd(Class)j(Applicabilit)m(y:)259
+4116 y(FitsChan)427 4215 y Fi(All)d(FitsChans)g(ha)n(v)n(e)e(this)i
+(attribute.)p 0 4386 V 0 4517 a Fz(CardT)l(yp)t(e)313
b Fe(The)39 b(data)e(t)m(yp)s(e)i(of)f(the)h(curren)m(t)e(card)h(in)h
-(a)1653 3285 y(FitsChan)3187 3170 y Fz(CardT)l(yp)t(e)0
-3460 y Fd(Description:)44 b Fi(This)f(attribute)h(giv)n(es)d(the)j
+(a)1653 4632 y(FitsChan)3187 4517 y Fz(CardT)l(yp)t(e)0
+4768 y Fd(Description:)44 b Fi(This)f(attribute)h(giv)n(es)d(the)j
(data)e(t)n(yp)r(e)i(of)f(the)g(k)n(eyw)n(ord)e(v)-5
b(alue)43 b(for)g(the)g(curren)n(t)f(card)g(of)h(the)227
-3559 y(FitsChan.)37 b(It)25 b(will)h(b)r(e)g(one)f(of)h(the)f(follo)n
+4868 y(FitsChan.)37 b(It)25 b(will)h(b)r(e)g(one)f(of)h(the)f(follo)n
(wing)g(in)n(teger)f(constan)n(ts:)35 b(AST)p Ft(__)p
-Fi(NOTYPE,)24 b(AST)p Ft(__)p Fi(COMMENT,)227 3659 y(AST)p
+Fi(NOTYPE,)24 b(AST)p Ft(__)p Fi(COMMENT,)227 4967 y(AST)p
Ft(__)p Fi(INT,)19 b(AST)p Ft(__)p Fi(FLO)n(A)-7 b(T,)17
b(AST)p Ft(__)p Fi(STRING,)i(AST)p Ft(__)p Fi(COMPLEXF,)e(AST)p
Ft(__)p Fi(COMPLEXI,)g(AST)p Ft(__)p Fi(LOGICAL,)227
-3759 y(AST)p Ft(__)p Fi(CONTINUE,)27 b(AST)p Ft(__)p
-Fi(UNDEF.)0 3917 y Fd(T)m(yp)s(e:)227 4017 y Fi(In)n(teger,)g
-(read-only)-7 b(.)0 4176 y Fd(Class)31 b(Applicabilit)m(y:)259
-4322 y(FitsChan)427 4421 y Fi(All)d(FitsChans)g(ha)n(v)n(e)e(this)i
-(attribute.)p 0 4630 V 0 4762 a Fz(Class)1118 b Fe(Ob)7
-b(ject)37 b(class)i(name)1116 b Fz(Class)0 4960 y Fd(Description:)44
-b Fi(This)28 b(attribute)g(giv)n(es)e(the)i(name)f(of)h(the)g(class)f
-(to)g(whic)n(h)h(an)f(Ob)5 b(ject)27 b(b)r(elongs.)0
-5119 y Fd(T)m(yp)s(e:)227 5218 y Fi(Character)f(string,)h(read-only)-7
-b(.)0 5377 y Fd(Class)31 b(Applicabilit)m(y:)259 5523
-y(Ob)5 b(ject)427 5622 y Fi(All)28 b(Ob)5 b(jects)28
-b(ha)n(v)n(e)e(this)i(attribute.)p eop end
+5067 y(AST)p Ft(__)p Fi(CONTINUE,)27 b(AST)p Ft(__)p
+Fi(UNDEF.)0 5202 y Fd(T)m(yp)s(e:)227 5302 y Fi(In)n(teger,)g
+(read-only)-7 b(.)0 5436 y Fd(Class)31 b(Applicabilit)m(y:)259
+5558 y(FitsChan)427 5658 y Fi(All)d(FitsChans)g(ha)n(v)n(e)e(this)i
+(attribute.)p eop end
%%Page: 427 437
TeXDict begin 427 436 bop 3643 52 a FF(427)p 0 351 3780
-12 v 0 483 a Fz(Clean)275 b Fe(Remo)m(v)m(e)38 b(cards)g(used)h(whilst)
-f(reading)f(ev)m(en)h(if)h(an)f(error)1701 598 y(o)s(ccurs?)3444
-483 y Fz(Clean)0 764 y Fd(Description:)44 b Fi(This)35
-b(attribute)h(indicates)f(whether)g(or)f(not)h(cards)f(should)h(b)r(e)g
-(remo)n(v)n(ed)f(from)g(the)i(FitsChan)f(if)227 864 y(an)c(error)d(o)r
-(ccurs)i(within)h(astRead.)45 b(A)31 b(succesful)f(read)g(on)g(a)g
-(FitsChan)h(alw)n(a)n(ys)e(results)h(in)h(the)f(remo)n(v)-5
-b(al)30 b(of)227 963 y(the)f(cards)e(whic)n(h)h(w)n(ere)f(in)n(v)n(olv)
-n(ed)f(in)i(the)h(description)e(of)h(the)h(returned)e(Ob)5
-b(ject.)38 b(Ho)n(w)n(ev)n(er,)26 b(in)j(the)f(ev)n(en)n(t)g(of)227
-1063 y(an)j(error)e(during)h(the)h(read)g(\(for)f(instance)h(if)g(the)g
-(cards)f(in)h(the)h(FitsChan)f(ha)n(v)n(e)e(illegal)h(v)-5
-b(alues,)32 b(or)e(if)h(some)227 1163 y(required)f(cards)f(are)h
-(missing\))g(no)g(cards)f(will)i(b)r(e)g(remo)n(v)n(ed)e(from)h(the)h
-(FitsChan)f(if)h(the)g(Clean)f(attribute)h(is)227 1262
-y(zero)c(\(the)h(default\).)37 b(If)28 b(Clean)f(is)h(non-zero)e(then)i
-(an)n(y)e(cards)h(whic)n(h)g(w)n(ere)g(used)g(in)h(the)g(ab)r(orted)f
-(attempt)h(to)227 1362 y(read)f(an)g(ob)5 b(ject)28 b(will)f(b)r(e)i
-(remo)n(v)n(ed.)227 1487 y(This)34 b(pro)n(vides)e(a)h(means)g(of)g
-Ft(")p Fi(cleaning)p Ft(")f Fi(a)h(FitsChan)g(of)h(W)n(CS)f(related)g
-(cards)f(whic)n(h)i(w)n(orks)e(ev)n(en)h(in)g(the)227
-1587 y(ev)n(en)n(t)27 b(of)h(the)g(cards)e(not)i(forming)f(a)g(legal)g
-(W)n(CS)h(description.)0 1737 y Fd(T)m(yp)s(e:)227 1837
-y Fi(In)n(teger)f(\(b)r(o)r(olean\).)0 1987 y Fd(Class)k(Applicabilit)m
-(y:)259 2124 y(FitsChan)427 2224 y Fi(All)d(FitsChans)g(ha)n(v)n(e)e
-(this)i(attribute.)p 0 2424 V 0 2556 a Fz(Clip)641 2563
-y Fe(Clip)38 b(lines)g(and/or)f(mark)m(ers)g(at)h(the)h(Plot)e(b)s
-(oundary?)3533 2556 y Fz(Clip)0 2759 y Fd(Description:)44
-b Fi(This)33 b(attribute)h(con)n(trols)d(whether)i(curv)n(es)f(and)h
-(mark)n(ers)e(are)h(clipp)r(ed)i(at)e(the)i(b)r(oundary)e(of)h(the)227
-2859 y(graphics)22 b(b)r(o)n(x)g(sp)r(eci\014ed)h(when)f(the)h(Plot)g
-(w)n(as)e(created.)35 b(A)23 b(v)-5 b(alue)22 b(of)h(3)f(implies)h(b)r
-(oth)g(mark)n(ers)e(and)h(curv)n(es)g(are)227 2958 y(clipp)r(ed)27
-b(at)e(the)h(Plot)f(b)r(oundary)-7 b(.)36 b(A)26 b(v)-5
-b(alue)25 b(of)h(2)f(implies)h(mark)n(ers)d(are)i(clipp)r(ed,)h(but)h
-(not)e(curv)n(es.)35 b(A)26 b(v)-5 b(alue)26 b(of)227
-3058 y(1)j(implies)g(curv)n(es)e(are)h(clipp)r(ed,)i(but)g(not)f(mark)n
-(ers.)38 b(A)30 b(v)-5 b(alue)28 b(of)h(zero)f(implies)h(neither)g
-(curv)n(es)f(nor)g(mark)n(ers)227 3158 y(are)35 b(clipp)r(ed.)63
-b(The)36 b(default)h(v)-5 b(alue)36 b(is)g(1.)62 b(Note,)38
-b(this)e(attributes)g(con)n(trols)f(only)h(the)g(clipping)g(p)r
-(erformed)227 3257 y(in)n(ternally)e(within)h(AST.)f(The)g(underlying)g
-(graphics)f(system)h(ma)n(y)f(also)g(apply)h(clipping.)57
-b(In)34 b(suc)n(h)g(cases,)227 3357 y(remo)n(ving)e(clipping)h(using)g
-(this)h(attribute)f(do)r(es)g(not)h(guaran)n(tee)d(that)j(no)f
-(clipping)g(will)h(b)r(e)f(visible)h(in)f(the)227 3457
-y(\014nal)28 b(plot.)227 3582 y(The)i(astClip)g(function)g(can)f(b)r(e)
-h(used)g(to)f(establish)h(generalised)e(clipping)h(within)i(arbitrary)c
-(regions)i(of)g(the)227 3681 y(Plot.)0 3832 y Fd(T)m(yp)s(e:)227
-3931 y Fi(In)n(teger.)0 4082 y Fd(Class)i(Applicabilit)m(y:)259
-4219 y(Plot)427 4319 y Fi(All)d(Plots)f(ha)n(v)n(e)g(this)g(attribute.)
-p 0 4519 V 0 4651 a Fz(ClipOp)175 b Fe(Com)m(bine)37
-b(Plot)g(clipping)g(limits)g(using)h(a)h(b)s(o)s(olean)e(OR?)175
-b Fz(ClipOp)0 4845 y Fd(Description:)44 b Fi(This)27
-b(attribute)g(con)n(trols)e(ho)n(w)h(the)h(clipping)g(limits)g(sp)r
-(eci\014ed)g(for)g(eac)n(h)e(axis)h(of)h(a)f(Plot)h(\(using)f(the)227
-4945 y(astClip)g(function\))h(are)e(com)n(bined.)36 b(This,)26
-b(in)h(turn,)f(determines)g(whic)n(h)g(parts)f(of)h(the)g(graphical)f
-(output)h(will)227 5044 y(b)r(e)i(visible.)227 5169 y(If)f(the)g
-(ClipOp)f(attribute)h(of)g(a)f(Plot)g(is)g(zero)f(\(the)i(default\),)h
-(graphical)d(output)i(is)f(visible)g(only)h(if)g(it)f(satis\014es)227
-5269 y(the)h(clipping)g(limits)g(on)f(all)g(the)h(axes)f(of)g(the)h
-(clipping)g(F)-7 b(rame)26 b(\(a)g(b)r(o)r(olean)g(AND\).)i(Otherwise,)
-e(if)h(ClipOp)g(is)227 5369 y(non-zero,)f(output)i(is)g(visible)f(if)h
-(it)g(satis\014es)f(the)h(clipping)g(limits)g(on)f(one)g(or)g(more)g
-(axes)g(\(a)g(b)r(o)r(olean)g(OR\).)227 5494 y(An)g(imp)r(ortan)n(t)f
-(use)g(of)g(this)h(attribute)f(is)g(to)g(allo)n(w)f(areas)g(of)h(a)g
-(Plot)f(to)h(b)r(e)h(left)g(clear)e(\(e.g.)36 b(as)26
-b(a)g(bac)n(kground)227 5593 y(for)f(some)f(text\).)36
-b(T)-7 b(o)25 b(ac)n(hiev)n(e)e(this,)j(the)f(lo)n(w)n(er)f(and)g(upp)r
-(er)h(clipping)g(b)r(ounds)g(supplied)g(to)g(astClip)g(should)f(b)r(e)
-227 5693 y(rev)n(ersed,)i(and)i(the)g(ClipOp)f(attribute)h(of)f(the)h
-(Plot)f(should)h(b)r(e)g(set)f(to)h(a)f(non-zero)f(v)-5
-b(alue.)p eop end
+12 v 0 483 a Fz(Class)1118 b Fe(Ob)7 b(ject)37 b(class)i(name)1116
+b Fz(Class)0 683 y Fd(Description:)44 b Fi(This)28 b(attribute)g(giv)n
+(es)e(the)i(name)f(of)h(the)g(class)f(to)g(whic)n(h)h(an)f(Ob)5
+b(ject)27 b(b)r(elongs.)0 844 y Fd(T)m(yp)s(e:)227 944
+y Fi(Character)f(string,)h(read-only)-7 b(.)0 1105 y
+Fd(Class)31 b(Applicabilit)m(y:)259 1253 y(Ob)5 b(ject)427
+1353 y Fi(All)28 b(Ob)5 b(jects)28 b(ha)n(v)n(e)e(this)i(attribute.)p
+0 1564 V 0 1695 a Fz(Clean)275 b Fe(Remo)m(v)m(e)38 b(cards)g(used)h
+(whilst)f(reading)f(ev)m(en)h(if)h(an)f(error)1701 1810
+y(o)s(ccurs?)3444 1695 y Fz(Clean)0 1987 y Fd(Description:)44
+b Fi(This)35 b(attribute)h(indicates)f(whether)g(or)f(not)h(cards)f
+(should)h(b)r(e)g(remo)n(v)n(ed)f(from)g(the)i(FitsChan)f(if)227
+2087 y(an)c(error)d(o)r(ccurs)i(within)h(astRead.)45
+b(A)31 b(succesful)f(read)g(on)g(a)g(FitsChan)h(alw)n(a)n(ys)e(results)
+h(in)h(the)f(remo)n(v)-5 b(al)30 b(of)227 2186 y(the)f(cards)e(whic)n
+(h)h(w)n(ere)f(in)n(v)n(olv)n(ed)f(in)i(the)h(description)e(of)h(the)h
+(returned)e(Ob)5 b(ject.)38 b(Ho)n(w)n(ev)n(er,)26 b(in)j(the)f(ev)n
+(en)n(t)g(of)227 2286 y(an)j(error)e(during)h(the)h(read)g(\(for)f
+(instance)h(if)g(the)g(cards)f(in)h(the)h(FitsChan)f(ha)n(v)n(e)e
+(illegal)h(v)-5 b(alues,)32 b(or)e(if)h(some)227 2386
+y(required)f(cards)f(are)h(missing\))g(no)g(cards)f(will)i(b)r(e)g
+(remo)n(v)n(ed)e(from)h(the)h(FitsChan)f(if)h(the)g(Clean)f(attribute)h
+(is)227 2485 y(zero)c(\(the)h(default\).)37 b(If)28 b(Clean)f(is)h
+(non-zero)e(then)i(an)n(y)e(cards)h(whic)n(h)g(w)n(ere)g(used)g(in)h
+(the)g(ab)r(orted)f(attempt)h(to)227 2585 y(read)f(an)g(ob)5
+b(ject)28 b(will)f(b)r(e)i(remo)n(v)n(ed.)227 2715 y(This)34
+b(pro)n(vides)e(a)h(means)g(of)g Ft(")p Fi(cleaning)p
+Ft(")f Fi(a)h(FitsChan)g(of)h(W)n(CS)f(related)g(cards)f(whic)n(h)i(w)n
+(orks)e(ev)n(en)h(in)g(the)227 2815 y(ev)n(en)n(t)27
+b(of)h(the)g(cards)e(not)i(forming)f(a)g(legal)g(W)n(CS)h(description.)
+0 2976 y Fd(T)m(yp)s(e:)227 3076 y Fi(In)n(teger)f(\(b)r(o)r(olean\).)0
+3237 y Fd(Class)k(Applicabilit)m(y:)259 3385 y(FitsChan)427
+3484 y Fi(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)p
+0 3695 V 0 3827 a Fz(Clip)641 3834 y Fe(Clip)38 b(lines)g(and/or)f
+(mark)m(ers)g(at)h(the)h(Plot)e(b)s(oundary?)3533 3827
+y Fz(Clip)0 4041 y Fd(Description:)44 b Fi(This)33 b(attribute)h(con)n
+(trols)d(whether)i(curv)n(es)f(and)h(mark)n(ers)e(are)h(clipp)r(ed)i
+(at)e(the)i(b)r(oundary)e(of)h(the)227 4140 y(graphics)22
+b(b)r(o)n(x)g(sp)r(eci\014ed)h(when)f(the)h(Plot)g(w)n(as)e(created.)35
+b(A)23 b(v)-5 b(alue)22 b(of)h(3)f(implies)h(b)r(oth)g(mark)n(ers)e
+(and)h(curv)n(es)g(are)227 4240 y(clipp)r(ed)27 b(at)e(the)h(Plot)f(b)r
+(oundary)-7 b(.)36 b(A)26 b(v)-5 b(alue)25 b(of)h(2)f(implies)h(mark)n
+(ers)d(are)i(clipp)r(ed,)h(but)h(not)e(curv)n(es.)35
+b(A)26 b(v)-5 b(alue)26 b(of)227 4339 y(1)j(implies)g(curv)n(es)e(are)h
+(clipp)r(ed,)i(but)g(not)f(mark)n(ers.)38 b(A)30 b(v)-5
+b(alue)28 b(of)h(zero)f(implies)h(neither)g(curv)n(es)f(nor)g(mark)n
+(ers)227 4439 y(are)35 b(clipp)r(ed.)63 b(The)36 b(default)h(v)-5
+b(alue)36 b(is)g(1.)62 b(Note,)38 b(this)e(attributes)g(con)n(trols)f
+(only)h(the)g(clipping)g(p)r(erformed)227 4539 y(in)n(ternally)e
+(within)h(AST.)f(The)g(underlying)g(graphics)f(system)h(ma)n(y)f(also)g
+(apply)h(clipping.)57 b(In)34 b(suc)n(h)g(cases,)227
+4638 y(remo)n(ving)e(clipping)h(using)g(this)h(attribute)f(do)r(es)g
+(not)h(guaran)n(tee)d(that)j(no)f(clipping)g(will)h(b)r(e)f(visible)h
+(in)f(the)227 4738 y(\014nal)28 b(plot.)227 4868 y(The)i(astClip)g
+(function)g(can)f(b)r(e)h(used)g(to)f(establish)h(generalised)e
+(clipping)h(within)i(arbitrary)c(regions)i(of)g(the)227
+4968 y(Plot.)0 5129 y Fd(T)m(yp)s(e:)227 5229 y Fi(In)n(teger.)0
+5390 y Fd(Class)i(Applicabilit)m(y:)259 5538 y(Plot)427
+5637 y Fi(All)d(Plots)f(ha)n(v)n(e)g(this)g(attribute.)p
+eop end
%%Page: 428 438
TeXDict begin 428 437 bop 0 52 a FF(428)1994 b Fy(C)91
-b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)0 351 y
-Fd(T)m(yp)s(e:)227 451 y Fi(In)n(teger)c(\(b)r(o)r(olean\).)0
-604 y Fd(Class)k(Applicabilit)m(y:)259 744 y(Plot)427
-844 y Fi(All)d(Plots)f(ha)n(v)n(e)g(this)g(attribute.)p
-0 1047 3780 12 v 0 1179 a Fz(Closed)176 b Fe(Should)38
-b(the)g(b)s(oundary)g(b)s(e)i(considered)e(to)g(b)s(e)h(inside)f(the)
-1706 1293 y(region?)3389 1179 y Fz(Closed)0 1486 y Fd(Description:)44
+b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
+3780 12 v 0 483 a Fz(ClipOp)175 b Fe(Com)m(bine)37 b(Plot)g(clipping)g
+(limits)g(using)h(a)h(b)s(o)s(olean)e(OR?)175 b Fz(ClipOp)0
+682 y Fd(Description:)44 b Fi(This)27 b(attribute)g(con)n(trols)e(ho)n
+(w)h(the)h(clipping)g(limits)g(sp)r(eci\014ed)g(for)g(eac)n(h)e(axis)h
+(of)h(a)f(Plot)h(\(using)f(the)227 782 y(astClip)g(function\))h(are)e
+(com)n(bined.)36 b(This,)26 b(in)h(turn,)f(determines)g(whic)n(h)g
+(parts)f(of)h(the)g(graphical)f(output)h(will)227 881
+y(b)r(e)i(visible.)227 1009 y(If)f(the)g(ClipOp)f(attribute)h(of)g(a)f
+(Plot)g(is)g(zero)f(\(the)i(default\),)h(graphical)d(output)i(is)f
+(visible)g(only)h(if)g(it)f(satis\014es)227 1108 y(the)h(clipping)g
+(limits)g(on)f(all)g(the)h(axes)f(of)g(the)h(clipping)g(F)-7
+b(rame)26 b(\(a)g(b)r(o)r(olean)g(AND\).)i(Otherwise,)e(if)h(ClipOp)g
+(is)227 1208 y(non-zero,)f(output)i(is)g(visible)f(if)h(it)g
+(satis\014es)f(the)h(clipping)g(limits)g(on)f(one)g(or)g(more)g(axes)g
+(\(a)g(b)r(o)r(olean)g(OR\).)227 1335 y(An)g(imp)r(ortan)n(t)f(use)g
+(of)g(this)h(attribute)f(is)g(to)g(allo)n(w)f(areas)g(of)h(a)g(Plot)f
+(to)h(b)r(e)h(left)g(clear)e(\(e.g.)36 b(as)26 b(a)g(bac)n(kground)227
+1435 y(for)f(some)f(text\).)36 b(T)-7 b(o)25 b(ac)n(hiev)n(e)e(this,)j
+(the)f(lo)n(w)n(er)f(and)g(upp)r(er)h(clipping)g(b)r(ounds)g(supplied)g
+(to)g(astClip)g(should)f(b)r(e)227 1535 y(rev)n(ersed,)i(and)i(the)g
+(ClipOp)f(attribute)h(of)f(the)h(Plot)f(should)h(b)r(e)g(set)f(to)h(a)f
+(non-zero)f(v)-5 b(alue.)0 1690 y Fd(T)m(yp)s(e:)227
+1789 y Fi(In)n(teger)27 b(\(b)r(o)r(olean\).)0 1944 y
+Fd(Class)k(Applicabilit)m(y:)259 2086 y(Plot)427 2186
+y Fi(All)d(Plots)f(ha)n(v)n(e)g(this)g(attribute.)p 0
+2391 V 0 2523 a Fz(Closed)176 b Fe(Should)38 b(the)g(b)s(oundary)g(b)s
+(e)i(considered)e(to)g(b)s(e)h(inside)f(the)1706 2637
+y(region?)3389 2523 y Fz(Closed)0 2832 y Fd(Description:)44
b Fi(This)28 b(attribute)g(con)n(trols)e(whether)i(p)r(oin)n(ts)f(on)g
(the)i(b)r(oundary)d(of)i(a)f(Region)g(are)g(considered)g(to)g(b)r(e)
-227 1586 y(inside)c(or)f(outside)h(the)g(region.)34 b(If)24
+227 2931 y(inside)c(or)f(outside)h(the)g(region.)34 b(If)24
b(the)f(attribute)g(v)-5 b(alue)23 b(is)f(non-zero)g(\(the)h
(default\),)i(p)r(oin)n(ts)e(on)f(the)h(b)r(oundary)227
-1685 y(are)29 b(considered)g(to)h(b)r(e)h(inside)f(the)g(region)f
+3031 y(are)29 b(considered)g(to)h(b)r(e)h(inside)f(the)g(region)f
(\(that)i(is,)f(the)h(Region)e(is)h Ft(")p Fi(closed)p
Ft(")p Fi(\).)43 b(Ho)n(w)n(ev)n(er,)28 b(if)j(the)f(attribute)227
-1785 y(v)-5 b(alue)28 b(is)f(zero,)g(p)r(oin)n(ts)g(on)h(the)g(b)r
+3130 y(v)-5 b(alue)28 b(is)f(zero,)g(p)r(oin)n(ts)g(on)h(the)g(b)r
(ounary)e(are)h(considered)f(to)i(b)r(e)g(outside)f(the)h(region.)0
-1938 y Fd(T)m(yp)s(e:)227 2038 y Fi(In)n(teger)f(\(b)r(o)r(olean\).)0
-2191 y Fd(Class)k(Applicabilit)m(y:)259 2331 y(Region)427
-2431 y Fi(All)d(Regions)f(ha)n(v)n(e)f(this)i(attribute.)259
-2566 y Fd(P)m(oin)m(tList)427 2665 y Fi(The)f(v)-5 b(alue)26
+3286 y Fd(T)m(yp)s(e:)227 3385 y Fi(In)n(teger)f(\(b)r(o)r(olean\).)0
+3540 y Fd(Class)k(Applicabilit)m(y:)259 3682 y(Region)427
+3782 y Fi(All)d(Regions)f(ha)n(v)n(e)f(this)i(attribute.)259
+3918 y Fd(P)m(oin)m(tList)427 4017 y Fi(The)f(v)-5 b(alue)26
b(of)g(the)h(Closed)e(attribute)i(is)f(ignored)f(b)n(y)h(P)n(oin)n
(tList)g(regions.)34 b(If)27 b(the)g(P)n(oin)n(tList)e(region)g(has)427
-2765 y(not)32 b(b)r(een)g(negated,)h(then)f(it)g(is)g(alw)n(a)n(ys)e
+4117 y(not)32 b(b)r(een)g(negated,)h(then)f(it)g(is)g(alw)n(a)n(ys)e
(assumed)h(to)g(b)r(e)i(closed.)48 b(If)33 b(the)f(P)n(oin)n(tList)e
-(region)h(has)g(b)r(een)427 2864 y(negated,)24 b(then)h(it)f(is)f(alw)n
+(region)h(has)g(b)r(een)427 4216 y(negated,)24 b(then)h(it)f(is)f(alw)n
(a)n(ys)f(assumed)h(to)h(b)r(e)g(op)r(en.)36 b(This)23
b(is)h(required)f(since)g(p)r(oin)n(ts)h(ha)n(v)n(e)f(zero)f(v)n(olume)
-427 2964 y(and)28 b(therefore)e(consist)h(en)n(tirely)g(of)h(b)r
-(oundary)-7 b(.)259 3099 y Fd(CmpRegion)427 3198 y Fi(The)27
+427 4316 y(and)28 b(therefore)e(consist)h(en)n(tirely)g(of)h(b)r
+(oundary)-7 b(.)259 4452 y Fd(CmpRegion)427 4551 y Fi(The)27
b(default)g(Closed)e(v)-5 b(alue)27 b(for)f(a)g(CmpRegion)g(is)g(the)h
(Closed)f(v)-5 b(alue)26 b(of)g(its)h(\014rst)f(comp)r(onen)n(t)g
-(Region.)259 3333 y Fd(Stc)427 3433 y Fi(The)i(default)g(Closed)f(v)-5
+(Region.)259 4687 y Fd(Stc)427 4787 y Fi(The)i(default)g(Closed)f(v)-5
b(alue)27 b(for)g(an)h(Stc)g(is)f(the)h(Closed)f(v)-5
-b(alue)28 b(of)f(its)h(encapsulated)f(Region.)p 0 3636
-V 0 3774 a Fz(Colour\(elemen)l(t\))1294 3768 y Fe(Colour)37
-b(index)h(for)g(a)g(Plot)1693 3867 y(elemen)m(t)2819
-3774 y Fz(Colour\(elemen)l(t\))0 4037 y Fd(Description:)44
+b(alue)28 b(of)f(its)h(encapsulated)f(Region.)p 0 4992
+V 0 5130 a Fz(Colour\(elemen)l(t\))1294 5123 y Fe(Colour)37
+b(index)h(for)g(a)g(Plot)1693 5223 y(elemen)m(t)2819
+5130 y Fz(Colour\(elemen)l(t\))0 5394 y Fd(Description:)44
b Fi(This)29 b(attribute)f(determines)g(the)h(colour)e(index)h(used)g
(when)g(dra)n(wing)f(eac)n(h)h(elemen)n(t)g(of)g(graphical)227
-4136 y(output)21 b(pro)r(duced)e(b)n(y)h(a)f(Plot.)34
+5494 y(output)21 b(pro)r(duced)e(b)n(y)h(a)f(Plot.)34
b(It)20 b(tak)n(es)f(a)g(separate)g(v)-5 b(alue)19 b(for)h(eac)n(h)f
(graphical)f(elemen)n(t)i(so)f(that,)j(for)d(instance,)227
-4236 y(the)25 b(setting)g Ft(")p Fi(Colour\(title\)=2)p
+5593 y(the)25 b(setting)g Ft(")p Fi(Colour\(title\)=2)p
Ft(")d Fi(causes)i(the)h(Plot)f(title)h(to)f(b)r(e)h(dra)n(wn)f(using)g
-(colour)f(index)i(2.)35 b(The)25 b(synon)n(ym)227 4335
-y Ft(")p Fi(Color)p Ft(")h Fi(ma)n(y)h(also)f(b)r(e)i(used.)227
-4462 y(The)d(range)f(of)h(in)n(teger)g(colour)f(indices)h(a)n(v)-5
+(colour)f(index)i(2.)35 b(The)25 b(synon)n(ym)227 5693
+y Ft(")p Fi(Color)p Ft(")h Fi(ma)n(y)h(also)f(b)r(e)i(used.)p
+eop end
+%%Page: 429 439
+TeXDict begin 429 438 bop 3643 52 a FF(429)227 351 y
+Fi(The)25 b(range)f(of)h(in)n(teger)g(colour)f(indices)h(a)n(v)-5
b(ailable)24 b(and)h(their)g(app)r(earance)e(is)i(determined)h(b)n(y)f
-(the)g(underlying)227 4561 y(graphics)g(system.)36 b(The)26
+(the)g(underlying)227 451 y(graphics)g(system.)36 b(The)26
b(default)h(b)r(eha)n(viour)e(is)h(for)f(all)h(graphical)e(elemen)n(ts)
-i(to)g(b)r(e)h(dra)n(wn)e(using)h(the)g(default)227 4661
+i(to)g(b)r(e)h(dra)n(wn)e(using)h(the)g(default)227 551
y(colour)e(index)g(supplied)h(b)n(y)f(this)h(graphics)e(system)i
(\(normally)-7 b(,)24 b(this)h(is)g(lik)n(ely)f(to)g(result)g(in)h
-(white)g(plotting)g(on)227 4761 y(a)i(blac)n(k)g(bac)n(kground,)f(or)h
-(vice)g(v)n(ersa\).)0 4914 y Fd(T)m(yp)s(e:)227 5014
-y Fi(In)n(teger.)0 5167 y Fd(Class)k(Applicabilit)m(y:)259
-5307 y(Plot)427 5407 y Fi(All)d(Plots)f(ha)n(v)n(e)g(this)g(attribute.)
-0 5572 y Fd(Notes:)p eop end
-%%Page: 429 439
-TeXDict begin 429 438 bop 3643 52 a FF(429)340 351 y
-Fh(\017)45 b Fi(F)-7 b(or)27 b(a)g(list)h(of)g(the)g(graphical)e
-(elemen)n(ts)h(a)n(v)-5 b(ailable,)27 b(see)g(the)h(description)f(of)g
-(the)h(Plot)f(class.)340 493 y Fh(\017)45 b Fi(If)31
-b(no)e(graphical)g(elemen)n(t)h(is)g(sp)r(eci\014ed,)h(\(e.g.)44
-b Ft(")p Fi(Colour)p Ft(")28 b Fi(instead)h(of)h Ft(")p
-Fi(Colour\(title\))p Ft(")p Fi(\),)g(then)h(a)e Ft(")p
-Fi(set)p Ft(")427 593 y Fi(or)d Ft(")p Fi(clear)p Ft(")f
-Fi(op)r(eration)h(will)g(a\013ect)h(the)g(attribute)g(v)-5
-b(alue)27 b(of)f(all)h(graphical)e(elemen)n(ts,)i(while)g(a)f
-Ft(")p Fi(get)p Ft(")f Fi(or)427 693 y Ft(")p Fi(test)p
-Ft(")i Fi(op)r(eration)g(will)h(use)f(just)h(the)g(Colour\(T)-7
-b(extLab\))27 b(v)-5 b(alue.)p 0 910 3780 12 v 0 1049
-a Fz(ColumnLenC\(column\))1600 1042 y Fe(The)39 b(largest)1498
-1157 y(string)e(length)h(of)1530 1271 y(an)m(y)h(v)-7
-b(alue)38 b(in)h(a)1704 1386 y(column)2472 1049 y Fz
-(ColumnLenC\(column\))0 1570 y Fd(Description:)44 b Fi(This)31
-b(attribute)f(holds)h(the)f(minim)n(um)i(length)e(whic)n(h)g(a)h(c)n
-(haracter)d(v)-5 b(ariable)29 b(m)n(ust)i(ha)n(v)n(e)e(in)i(order)227
-1669 y(to)i(b)r(e)g(able)f(to)g(store)g(the)h(longest)f(v)-5
+(white)g(plotting)g(on)227 650 y(a)i(blac)n(k)g(bac)n(kground,)f(or)h
+(vice)g(v)n(ersa\).)0 808 y Fd(T)m(yp)s(e:)227 908 y
+Fi(In)n(teger.)0 1065 y Fd(Class)k(Applicabilit)m(y:)259
+1210 y(Plot)427 1310 y Fi(All)d(Plots)f(ha)n(v)n(e)g(this)g(attribute.)
+0 1480 y Fd(Notes:)340 1771 y Fh(\017)45 b Fi(F)-7 b(or)27
+b(a)g(list)h(of)g(the)g(graphical)e(elemen)n(ts)h(a)n(v)-5
+b(ailable,)27 b(see)g(the)h(description)f(of)g(the)h(Plot)f(class.)340
+1908 y Fh(\017)45 b Fi(If)31 b(no)e(graphical)g(elemen)n(t)h(is)g(sp)r
+(eci\014ed,)h(\(e.g.)44 b Ft(")p Fi(Colour)p Ft(")28
+b Fi(instead)h(of)h Ft(")p Fi(Colour\(title\))p Ft(")p
+Fi(\),)g(then)h(a)e Ft(")p Fi(set)p Ft(")427 2007 y Fi(or)d
+Ft(")p Fi(clear)p Ft(")f Fi(op)r(eration)h(will)g(a\013ect)h(the)g
+(attribute)g(v)-5 b(alue)27 b(of)f(all)h(graphical)e(elemen)n(ts,)i
+(while)g(a)f Ft(")p Fi(get)p Ft(")f Fi(or)427 2107 y
+Ft(")p Fi(test)p Ft(")i Fi(op)r(eration)g(will)h(use)f(just)h(the)g
+(Colour\(T)-7 b(extLab\))27 b(v)-5 b(alue.)p 0 2314 3780
+12 v 0 2453 a Fz(ColumnLenC\(column\))1600 2446 y Fe(The)39
+b(largest)1498 2561 y(string)e(length)h(of)1530 2675
+y(an)m(y)h(v)-7 b(alue)38 b(in)h(a)1704 2790 y(column)2472
+2453 y Fz(ColumnLenC\(column\))0 2964 y Fd(Description:)44
+b Fi(This)31 b(attribute)f(holds)h(the)f(minim)n(um)i(length)e(whic)n
+(h)g(a)h(c)n(haracter)d(v)-5 b(ariable)29 b(m)n(ust)i(ha)n(v)n(e)e(in)i
+(order)227 3063 y(to)i(b)r(e)g(able)f(to)g(store)g(the)h(longest)f(v)-5
b(alue)32 b(curren)n(tly)g(presen)n(t)g(\(at)h(an)n(y)f(ro)n(w\))f(in)i
-(a)f(sp)r(eci\014ed)h(column)g(of)f(the)227 1769 y(supplied)k(T)-7
+(a)f(sp)r(eci\014ed)h(column)g(of)f(the)227 3163 y(supplied)k(T)-7
b(able.)59 b(This)35 b(do)r(es)f(not)h(include)h(ro)r(om)e(for)g(a)h
(trailing)f(n)n(ull)h(c)n(haracter.)57 b(The)36 b(required)e(column)227
-1869 y(name)d(should)f(b)r(e)h(placed)g(inside)g(the)g(paren)n(theses)e
+3262 y(name)d(should)f(b)r(e)h(placed)g(inside)g(the)g(paren)n(theses)e
(in)i(the)g(attribute)g(name.)46 b(If)31 b(the)h(named)e(column)h
-(holds)227 1968 y(v)n(ector)c(v)-5 b(alues,)27 b(then)h(the)g
+(holds)227 3362 y(v)n(ector)c(v)-5 b(alues,)27 b(then)h(the)g
(attribute)g(v)-5 b(alue)27 b(is)h(the)g(length)f(of)h(the)g(longest)f
-(elemen)n(t)g(of)h(the)g(v)n(ector)e(v)-5 b(alue.)0 2136
-y Fd(T)m(yp)s(e:)227 2236 y Fi(In)n(teger,)27 b(read-only)-7
-b(.)0 2404 y Fd(Class)31 b(Applicabilit)m(y:)259 2559
-y(T)-8 b(able)427 2658 y Fi(All)28 b(T)-7 b(ables)27
-b(ha)n(v)n(e)g(this)h(attribute.)0 2839 y Fd(Notes:)340
-3140 y Fh(\017)45 b Fi(If)29 b(the)f(named)g(column)g(holds)g(n)n
+(elemen)n(t)g(of)h(the)g(v)n(ector)e(v)-5 b(alue.)0 3520
+y Fd(T)m(yp)s(e:)227 3619 y Fi(In)n(teger,)27 b(read-only)-7
+b(.)0 3777 y Fd(Class)31 b(Applicabilit)m(y:)259 3922
+y(T)-8 b(able)427 4022 y Fi(All)28 b(T)-7 b(ables)27
+b(ha)n(v)n(e)g(this)h(attribute.)0 4192 y Fd(Notes:)340
+4483 y Fh(\017)45 b Fi(If)29 b(the)f(named)g(column)g(holds)g(n)n
(umerical)f(v)-5 b(alues,)28 b(the)h(length)f(returned)g(is)g(the)g
-(length)g(of)g(the)h(largest)427 3239 y(string)e(that)h(w)n(ould)f(b)r
+(length)g(of)g(the)h(largest)427 4582 y(string)e(that)h(w)n(ould)f(b)r
(e)h(generated)f(if)h(the)g(column)f(v)-5 b(alues)28
-b(w)n(ere)e(accessed)h(as)g(strings.)p 0 3457 V 0 3595
-a Fz(ColumnLength\(column\))1576 3589 y Fe(The)39 b(n)m(um)m(b)s(er)
-1603 3688 y(of)g(elemen)m(ts)1558 3788 y(in)g(eac)m(h)f(v)-7
-b(alue)1587 3888 y(in)39 b(a)f(column)2375 3595 y Fz
-(ColumnLength\(column\))0 4072 y Fd(Description:)44 b
+b(w)n(ere)e(accessed)h(as)g(strings.)p 0 4790 V 0 4928
+a Fz(ColumnLength\(column\))1576 4921 y Fe(The)39 b(n)m(um)m(b)s(er)
+1603 5021 y(of)g(elemen)m(ts)1558 5121 y(in)g(eac)m(h)f(v)-7
+b(alue)1587 5220 y(in)39 b(a)f(column)2375 4928 y Fz
+(ColumnLength\(column\))0 5394 y Fd(Description:)44 b
Fi(This)37 b(attribute)f(holds)g(the)h(n)n(um)n(b)r(er)f(of)g(elemen)n
(ts)h(in)f(eac)n(h)g(v)-5 b(alue)36 b(stored)g(in)g(a)g(named)h
-(column.)227 4171 y(Eac)n(h)f(v)-5 b(alue)36 b(can)g(b)r(e)h(a)f
+(column.)227 5494 y(Eac)n(h)f(v)-5 b(alue)36 b(can)g(b)r(e)h(a)f
(scalar)f(\(in)i(whic)n(h)f(case)g(the)h(ColumnLength)f(attribute)h
-(has)f(a)g(v)-5 b(alue)36 b(of)h(1\),)h(or)e(a)227 4271
+(has)f(a)g(v)-5 b(alue)36 b(of)h(1\),)h(or)e(a)227 5593
y(m)n(ulti-dimensional)e(arra)n(y)d(\()k(in)f(whic)n(h)f(case)h(the)g
(ColumnLength)g(v)-5 b(alue)33 b(is)h(equal)f(to)h(the)h(pro)r(duct)e
-(of)h(the)227 4371 y(arra)n(y)26 b(dimensions\).)0 4538
-y Fd(T)m(yp)s(e:)227 4638 y Fi(In)n(teger,)h(read-only)-7
-b(.)0 4806 y Fd(Class)31 b(Applicabilit)m(y:)259 4961
-y(T)-8 b(able)427 5060 y Fi(All)28 b(T)-7 b(ables)27
-b(ha)n(v)n(e)g(this)h(attribute.)p 0 5278 V 0 5417 a
-Fz(ColumnNdim\(column\))1509 5410 y Fe(The)39 b(n)m(um)m(b)s(er)f(of)
-1553 5510 y(axes)g(spanned)1477 5624 y(b)m(y)g(eac)m(h)h(v)-7
-b(alue)38 b(in)1656 5739 y(a)g(column)2456 5417 y Fz
-(ColumnNdim\(column\))p eop end
+(of)h(the)227 5693 y(arra)n(y)26 b(dimensions\).)p eop
+end
%%Page: 430 440
TeXDict begin 430 439 bop 0 52 a FF(430)1994 b Fy(C)91
b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)0 351 y
-Fd(Description:)44 b Fi(This)30 b(attribute)f(holds)g(the)g(n)n(um)n(b)
-r(er)g(of)g(axes)g(spanned)f(b)n(y)h(eac)n(h)g(v)-5 b(alue)29
-b(in)g(a)g(column.)42 b(If)29 b(eac)n(h)g(cell)227 451
-y(in)g(the)h(column)f(is)f(a)h(scalar,)e(ColumnNdim)j(will)f(b)r(e)g
-(zero.)40 b(If)29 b(eac)n(h)f(cell)h(in)g(the)g(column)g(is)g(a)g(1D)f
-(sp)r(ectrum,)227 551 y(ColumnNdim)g(will)g(b)r(e)f(one.)37
+Fd(T)m(yp)s(e:)227 451 y Fi(In)n(teger,)c(read-only)-7
+b(.)0 597 y Fd(Class)31 b(Applicabilit)m(y:)259 731 y(T)-8
+b(able)427 831 y Fi(All)28 b(T)-7 b(ables)27 b(ha)n(v)n(e)g(this)h
+(attribute.)p 0 1024 3780 12 v 0 1163 a Fz(ColumnNdim\(column\))1509
+1156 y Fe(The)39 b(n)m(um)m(b)s(er)f(of)1553 1256 y(axes)g(spanned)1477
+1370 y(b)m(y)g(eac)m(h)h(v)-7 b(alue)38 b(in)1656 1485
+y(a)g(column)2456 1163 y Fz(ColumnNdim\(column\))0 1645
+y Fd(Description:)44 b Fi(This)30 b(attribute)f(holds)g(the)g(n)n(um)n
+(b)r(er)g(of)g(axes)g(spanned)f(b)n(y)h(eac)n(h)g(v)-5
+b(alue)29 b(in)g(a)g(column.)42 b(If)29 b(eac)n(h)g(cell)227
+1744 y(in)g(the)h(column)f(is)f(a)h(scalar,)e(ColumnNdim)j(will)f(b)r
+(e)g(zero.)40 b(If)29 b(eac)n(h)f(cell)h(in)g(the)g(column)g(is)g(a)g
+(1D)f(sp)r(ectrum,)227 1844 y(ColumnNdim)g(will)g(b)r(e)f(one.)37
b(If)27 b(eac)n(h)g(cell)g(in)h(the)f(column)h(is)f(a)g(2D)g(image,)g
-(ColumnNdim)h(will)f(b)r(e)h(t)n(w)n(o,)e(etc.)227 650
+(ColumnNdim)h(will)f(b)r(e)h(t)n(w)n(o,)e(etc.)227 1944
y(The)i(required)f(column)g(name)h(should)f(b)r(e)h(placed)f(inside)h
(the)g(paren)n(theses)e(in)i(the)g(attribute)g(name.)0
-822 y Fd(T)m(yp)s(e:)227 922 y Fi(In)n(teger,)f(read-only)-7
-b(.)0 1094 y Fd(Class)31 b(Applicabilit)m(y:)259 1252
-y(T)-8 b(able)427 1352 y Fi(All)28 b(T)-7 b(ables)27
-b(ha)n(v)n(e)g(this)h(attribute.)p 0 1574 3780 12 v 0
-1712 a Fz(ColumnT)l(yp)t(e\(column\))1457 1705 y Fe(The)39
-b(data)f(t)m(yp)s(e)g(of)1509 1820 y(eac)m(h)h(v)-7 b(alue)38
-b(in)h(a)1704 1920 y(column)2485 1712 y Fz(ColumnT)l(yp)t(e\(column\))0
-2108 y Fd(Description:)44 b Fi(This)21 b(attribute)g(holds)g(a)f(in)n
+2090 y Fd(T)m(yp)s(e:)227 2190 y Fi(In)n(teger,)f(read-only)-7
+b(.)0 2336 y Fd(Class)31 b(Applicabilit)m(y:)259 2470
+y(T)-8 b(able)427 2570 y Fi(All)28 b(T)-7 b(ables)27
+b(ha)n(v)n(e)g(this)h(attribute.)p 0 2763 V 0 2902 a
+Fz(ColumnT)l(yp)t(e\(column\))1457 2895 y Fe(The)39 b(data)f(t)m(yp)s
+(e)g(of)1509 3009 y(eac)m(h)h(v)-7 b(alue)38 b(in)h(a)1704
+3109 y(column)2485 2902 y Fz(ColumnT)l(yp)t(e\(column\))0
+3269 y Fd(Description:)44 b Fi(This)21 b(attribute)g(holds)g(a)f(in)n
(teger)g(v)-5 b(alue)21 b(indicating)g(the)g(data)g(t)n(yp)r(e)g(of)g
-(a)f(named)h(column)g(in)g(a)g(T)-7 b(able.)227 2207
+(a)f(named)h(column)g(in)g(a)g(T)-7 b(able.)227 3369
y(This)20 b(is)f(the)g(data)g(t)n(yp)r(e)h(whic)n(h)f(w)n(as)f(used)i
(when)f(the)h(column)f(w)n(as)f(added)i(to)f(the)g(T)-7
-b(able)19 b(using)g(astAddColumn.)227 2307 y(The)28 b(required)f
+b(able)19 b(using)g(astAddColumn.)227 3468 y(The)28 b(required)f
(column)g(name)h(should)f(b)r(e)h(placed)f(inside)h(the)g(paren)n
-(theses)e(in)i(the)g(attribute)g(name.)227 2443 y(The)20
+(theses)e(in)i(the)g(attribute)g(name.)227 3591 y(The)20
b(attribute)f(v)-5 b(alue)20 b(will)g(b)r(e)f(one)h(of)f(AST)p
Ft(__)p Fi(INTTYPE)g(\(for)g(in)n(teger\),)h(AST)p Ft(__)p
-Fi(SINTTYPE)f(\(for)g(short)g(in)n(t\),)227 2542 y(AST)p
+Fi(SINTTYPE)f(\(for)g(short)g(in)n(t\),)227 3691 y(AST)p
Ft(__)p Fi(BYTETYPE)24 b(\(for)i(unsigned)f(b)n(ytes)h(-)f(i.e.)37
b(unsigned)25 b(c)n(hars\),)g(AST)p Ft(__)p Fi(DOUBLETYPE)f(\(for)i
-(double)227 2642 y(precision)18 b(\015oating)f(p)r(oin)n(t\),)k(AST)p
+(double)227 3791 y(precision)18 b(\015oating)f(p)r(oin)n(t\),)k(AST)p
Ft(__)p Fi(FLO)n(A)-7 b(TTYPE)17 b(\(for)h(single)g(precision)f
(\015oating)h(p)r(oin)n(t\),)j(AST)p Ft(__)p Fi(STRINGTYPE)227
-2742 y(\(for)31 b(c)n(haracter)f(string\),)i(AST)p Ft(__)p
+3890 y(\(for)31 b(c)n(haracter)f(string\),)i(AST)p Ft(__)p
Fi(OBJECTTYPE)c(\(for)k(AST)f(Ob)5 b(ject)32 b(p)r(oin)n(ter\),)g(AST)p
-Ft(__)p Fi(POINTER)-7 b(TYPE)227 2841 y(\(for)28 b(arbitrary)d(C)j(p)r
+Ft(__)p Fi(POINTER)-7 b(TYPE)227 3990 y(\(for)28 b(arbitrary)d(C)j(p)r
(oin)n(ter\))f(or)g(AST)p Ft(__)p Fi(UNDEFTYPE)g(\(for)g(unde\014ned)i
(v)-5 b(alues)27 b(created)g(b)n(y)g(astMapPutU\).)0
-3013 y Fd(T)m(yp)s(e:)227 3113 y Fi(In)n(teger,)g(read-only)-7
-b(.)0 3285 y Fd(Class)31 b(Applicabilit)m(y:)259 3443
-y(T)-8 b(able)427 3543 y Fi(All)28 b(T)-7 b(ables)27
-b(ha)n(v)n(e)g(this)h(attribute.)p 0 3765 V 0 3895 a
-Fz(Commen)l(t)940 3896 y Fe(Include)39 b(textual)e(commen)m(ts)g(in)i
-(output?)3206 3895 y Fz(Commen)l(t)0 4108 y Fd(Description:)44
+4137 y Fd(T)m(yp)s(e:)227 4236 y Fi(In)n(teger,)g(read-only)-7
+b(.)0 4383 y Fd(Class)31 b(Applicabilit)m(y:)259 4516
+y(T)-8 b(able)427 4616 y Fi(All)28 b(T)-7 b(ables)27
+b(ha)n(v)n(e)g(this)h(attribute.)p 0 4810 V 0 4940 a
+Fz(Commen)l(t)940 4941 y Fe(Include)39 b(textual)e(commen)m(ts)g(in)i
+(output?)3206 4940 y Fz(Commen)l(t)0 5124 y Fd(Description:)44
b Fi(This)30 b(is)f(a)h(b)r(o)r(olean)f(attribute)g(whic)n(h)h(con)n
(trols)e(whether)h(textual)h(commen)n(ts)f(are)g(to)g(b)r(e)h(included)
-227 4207 y(in)j(the)g(output)g(generated)f(b)n(y)g(a)g(Channel.)52
+227 5224 y(in)j(the)g(output)g(generated)f(b)n(y)g(a)g(Channel.)52
b(If)33 b(included,)i(they)e(will)g(describ)r(e)f(what)g(eac)n(h)g
-(item)h(of)g(output)227 4307 y(represen)n(ts.)227 4443
+(item)h(of)g(output)227 5324 y(represen)n(ts.)227 5447
y(If)28 b(Commen)n(t)g(is)f(non-zero,)f(then)i(commen)n(ts)g(will)f(b)r
(e)h(included.)38 b(If)28 b(it)g(is)f(zero,)g(commen)n(ts)g(will)h(b)r
-(e)g(omitted.)0 4615 y Fd(T)m(yp)s(e:)227 4714 y Fi(In)n(teger)f(\(b)r
-(o)r(olean\).)0 4886 y Fd(Class)k(Applicabilit)m(y:)259
-5045 y(Channel)427 5145 y Fi(The)d(default)g(v)-5 b(alue)27
-b(is)h(non-zero)e(for)h(a)g(normal)g(Channel.)259 5289
-y Fd(FitsChan)427 5388 y Fi(The)h(default)g(v)-5 b(alue)27
-b(is)h(non-zero)e(for)h(a)g(FitsChan.)259 5532 y Fd(XmlChan)427
-5632 y Fi(The)h(default)g(v)-5 b(alue)27 b(is)h(zero)e(for)i(an)f
-(XmlChan.)p eop end
+(e)g(omitted.)0 5593 y Fd(T)m(yp)s(e:)227 5693 y Fi(In)n(teger)f(\(b)r
+(o)r(olean\).)p eop end
%%Page: 431 441
-TeXDict begin 431 440 bop 3643 52 a FF(431)p 0 351 3780
-12 v 0 482 a Fz(Curren)l(t)1108 483 y Fe(F)-10 b(rameSet)38
-b(curren)m(t)f(F)-10 b(rame)38 b(index)3313 482 y Fz(Curren)l(t)0
-658 y Fd(Description:)44 b Fi(This)38 b(attribute)g(giv)n(es)f(the)h
-(index)g(of)g(the)g(F)-7 b(rame)37 b(whic)n(h)h(is)g(to)g(b)r(e)g
-(regarded)e(as)h(the)h Ft(")p Fi(curren)n(t)p Ft(")227
-758 y Fi(F)-7 b(rame)37 b(within)g(a)g(F)-7 b(rameSet.)65
-b(The)37 b(default)g(is)g(the)h(most)e(recen)n(t)h(F)-7
-b(rame)36 b(added)h(to)g(the)g(F)-7 b(rameSet)37 b(\(this)227
-858 y(F)-7 b(rame)27 b(alw)n(a)n(ys)f(has)h(an)g(index)h(equal)f(to)h
-(the)g(F)-7 b(rameSet's)27 b(Nframe)g(attribute\).)0
-1017 y Fd(T)m(yp)s(e:)227 1117 y Fi(In)n(teger.)0 1276
-y Fd(Class)k(Applicabilit)m(y:)259 1422 y(F)-8 b(rameSet)427
-1522 y Fi(All)28 b(F)-7 b(rameSets)27 b(ha)n(v)n(e)g(this)h(attribute.)
-0 1694 y Fd(Notes:)340 1986 y Fh(\017)45 b Fi(In)n(v)n(erting)29
-b(a)g(F)-7 b(rameSet)29 b(\(in)n(v)n(erting)g(the)h(b)r(o)r(olean)f
-(sense)g(of)h(its)g(In)n(v)n(ert)e(attribute,)j(with)f(the)g(astIn)n(v)
-n(ert)427 2086 y(function)e(for)g(example\))f(will)h(in)n(terc)n(hange)
-e(the)i(v)-5 b(alues)27 b(of)h(its)f(Base)g(and)g(Curren)n(t)g
-(attributes.)p 0 2295 V 0 2426 a Fz(DSBCen)l(tre)849
-2427 y Fe(The)38 b(cen)m(tral)f(p)s(osition)g(of)i(in)m(terest)e(in)h
-(a)h(dual)1409 2541 y(sideband)g(sp)s(ectrum)3108 2426
-y Fz(DSBCen)l(tre)0 2740 y Fd(Description:)44 b Fi(This)31
-b(attribute)h(sp)r(eci\014es)e(the)i(cen)n(tral)e(p)r(osition)h(of)g
-(in)n(terest)f(in)i(a)e(dual)h(sideband)g(sp)r(ectrum.)48
-b(Its)227 2840 y(sole)33 b(use)g(is)g(to)g(determine)g(the)h(lo)r(cal)e
-(oscillator)g(frequency)g(\(the)i(frequency)f(whic)n(h)g(marks)f(the)h
-(b)r(oundary)227 2939 y(b)r(et)n(w)n(een)f(the)h(lo)n(w)n(er)e(and)h
-(upp)r(er)g(sidebands\).)50 b(See)32 b(the)h(description)f(of)g(the)g
-(IF)h(\(in)n(termediate)f(frequency\))227 3039 y(attribute)21
-b(for)g(details)f(of)h(ho)n(w)f(the)h(lo)r(cal)g(oscillator)e
-(frequency)h(is)h(calculated.)34 b(The)21 b(sideband)f(con)n(taining)g
-(this)227 3139 y(cen)n(tral)28 b(p)r(osition)g(is)g(referred)g(to)g(as)
-g(the)h Ft(")p Fi(observ)n(ed)p Ft(")d Fi(sideband,)i(and)h(the)f
-(other)g(sideband)h(as)e(the)i Ft(")p Fi(image)p Ft(")227
-3238 y Fi(sideband.)227 3368 y(The)c(v)-5 b(alue)25 b(is)g(accessed)f
-(as)g(a)h(p)r(osition)g(in)g(the)h(sp)r(ectral)e(system)h(represen)n
-(ted)f(b)n(y)g(the)i(Sp)r(ecF)-7 b(rame)25 b(attributes)227
-3467 y(inherited)40 b(b)n(y)f(this)h(class,)h(but)f(is)f(stored)g(in)n
+TeXDict begin 431 440 bop 3643 52 a FF(431)0 351 y Fd(Class)31
+b(Applicabilit)m(y:)259 485 y(Channel)427 585 y Fi(The)d(default)g(v)-5
+b(alue)27 b(is)h(non-zero)e(for)h(a)g(normal)g(Channel.)259
+715 y Fd(FitsChan)427 815 y Fi(The)h(default)g(v)-5 b(alue)27
+b(is)h(non-zero)e(for)h(a)g(FitsChan.)259 946 y Fd(XmlChan)427
+1045 y Fi(The)h(default)g(v)-5 b(alue)27 b(is)h(zero)e(for)i(an)f
+(XmlChan.)p 0 1240 3780 12 v 0 1371 a Fz(Curren)l(t)642
+b Fe(F)-10 b(rameSet)38 b(curren)m(t)f(F)-10 b(rame)38
+b(index)641 b Fz(Curren)l(t)0 1532 y Fd(Description:)44
+b Fi(This)38 b(attribute)g(giv)n(es)f(the)h(index)g(of)g(the)g(F)-7
+b(rame)37 b(whic)n(h)h(is)g(to)g(b)r(e)g(regarded)e(as)h(the)h
+Ft(")p Fi(curren)n(t)p Ft(")227 1632 y Fi(F)-7 b(rame)37
+b(within)g(a)g(F)-7 b(rameSet.)65 b(The)37 b(default)g(is)g(the)h(most)
+e(recen)n(t)h(F)-7 b(rame)36 b(added)h(to)g(the)g(F)-7
+b(rameSet)37 b(\(this)227 1732 y(F)-7 b(rame)27 b(alw)n(a)n(ys)f(has)h
+(an)g(index)h(equal)f(to)h(the)g(F)-7 b(rameSet's)27
+b(Nframe)g(attribute\).)0 1879 y Fd(T)m(yp)s(e:)227 1978
+y Fi(In)n(teger.)0 2126 y Fd(Class)k(Applicabilit)m(y:)259
+2260 y(F)-8 b(rameSet)427 2359 y Fi(All)28 b(F)-7 b(rameSets)27
+b(ha)n(v)n(e)g(this)h(attribute.)0 2519 y Fd(Notes:)340
+2799 y Fh(\017)45 b Fi(In)n(v)n(erting)29 b(a)g(F)-7
+b(rameSet)29 b(\(in)n(v)n(erting)g(the)h(b)r(o)r(olean)f(sense)g(of)h
+(its)g(In)n(v)n(ert)e(attribute,)j(with)f(the)g(astIn)n(v)n(ert)427
+2899 y(function)e(for)g(example\))f(will)h(in)n(terc)n(hange)e(the)i(v)
+-5 b(alues)27 b(of)h(its)f(Base)g(and)g(Curren)n(t)g(attributes.)p
+0 3093 V 0 3224 a Fz(DSBCen)l(tre)849 3225 y Fe(The)38
+b(cen)m(tral)f(p)s(osition)g(of)i(in)m(terest)e(in)h(a)h(dual)1409
+3339 y(sideband)g(sp)s(ectrum)3108 3224 y Fz(DSBCen)l(tre)0
+3524 y Fd(Description:)44 b Fi(This)31 b(attribute)h(sp)r(eci\014es)e
+(the)i(cen)n(tral)e(p)r(osition)h(of)g(in)n(terest)f(in)i(a)e(dual)h
+(sideband)g(sp)r(ectrum.)48 b(Its)227 3623 y(sole)33
+b(use)g(is)g(to)g(determine)g(the)h(lo)r(cal)e(oscillator)g(frequency)g
+(\(the)i(frequency)f(whic)n(h)g(marks)f(the)h(b)r(oundary)227
+3723 y(b)r(et)n(w)n(een)f(the)h(lo)n(w)n(er)e(and)h(upp)r(er)g
+(sidebands\).)50 b(See)32 b(the)h(description)f(of)g(the)g(IF)h(\(in)n
+(termediate)f(frequency\))227 3822 y(attribute)21 b(for)g(details)f(of)
+h(ho)n(w)f(the)h(lo)r(cal)g(oscillator)e(frequency)h(is)h(calculated.)
+34 b(The)21 b(sideband)f(con)n(taining)g(this)227 3922
+y(cen)n(tral)28 b(p)r(osition)g(is)g(referred)g(to)g(as)g(the)h
+Ft(")p Fi(observ)n(ed)p Ft(")d Fi(sideband,)i(and)h(the)f(other)g
+(sideband)h(as)e(the)i Ft(")p Fi(image)p Ft(")227 4022
+y Fi(sideband.)227 4145 y(The)c(v)-5 b(alue)25 b(is)g(accessed)f(as)g
+(a)h(p)r(osition)g(in)g(the)h(sp)r(ectral)e(system)h(represen)n(ted)f
+(b)n(y)g(the)i(Sp)r(ecF)-7 b(rame)25 b(attributes)227
+4245 y(inherited)40 b(b)n(y)f(this)h(class,)h(but)f(is)f(stored)g(in)n
(ternally)f(as)h(top)r(o)r(cen)n(tric)g(frequency)-7
-b(.)72 b(Th)n(us,)42 b(if)e(the)f(System)227 3567 y(attribute)30
+b(.)72 b(Th)n(us,)42 b(if)e(the)f(System)227 4344 y(attribute)30
b(of)g(the)h(DSBSp)r(ecF)-7 b(rame)30 b(is)g(set)g(to)g
Ft(")p Fi(VRAD)p Ft(")p Fi(,)h(the)f(Unit)h(attribute)f(set)g(to)g
-Ft(")p Fi(m/s)p Ft(")f Fi(and)h(the)g(Std-)227 3667 y(OfRest)i
+Ft(")p Fi(m/s)p Ft(")f Fi(and)h(the)g(Std-)227 4444 y(OfRest)i
(attribute)f(set)h(to)f Ft(")p Fi(LSRK)p Ft(")p Fi(,)g(then)h(v)-5
b(alues)31 b(for)g(the)h(DSBCen)n(tre)f(attribute)h(should)f(b)r(e)h
-(supplied)f(as)227 3766 y(radio)e(v)n(elo)r(cit)n(y)h(in)g(units)h(of)f
+(supplied)f(as)227 4544 y(radio)e(v)n(elo)r(cit)n(y)h(in)g(units)h(of)f
Ft(")p Fi(m/s)p Ft(")f Fi(relativ)n(e)g(to)h(the)h(kinematic)f(LSR)h
(\(alternativ)n(e)e(units)h(ma)n(y)g(b)r(e)h(used)f(b)n(y)227
-3866 y(app)r(ending)24 b(a)g(suitable)g(units)g(string)f(to)h(the)g
+4643 y(app)r(ending)24 b(a)g(suitable)g(units)g(string)f(to)h(the)g
(end)h(of)e(the)i(v)-5 b(alue\).)36 b(This)23 b(v)-5
b(alue)24 b(is)g(then)h(con)n(v)n(erted)d(to)i(top)r(o)r(cen-)227
-3965 y(tric)33 b(frequency)f(and)h(stored.)51 b(If)33
+4743 y(tric)33 b(frequency)f(and)h(stored.)51 b(If)33
b(\(sa)n(y\))g(the)g(Unit)g(attribute)g(is)g(subsequen)n(tly)f(c)n
(hanged)g(to)h Ft(")p Fi(km/s)p Ft(")e Fi(b)r(efore)227
-4065 y(retrieving)e(the)i(curren)n(t)e(v)-5 b(alue)30
+4842 y(retrieving)e(the)i(curren)n(t)e(v)-5 b(alue)30
b(of)g(the)g(DSBCen)n(tre)g(attribute,)h(the)f(stored)g(top)r(o)r(cen)n
-(tric)f(frequency)h(will)g(b)r(e)227 4165 y(con)n(v)n(erted)c(bac)n(k)h
+(tric)f(frequency)h(will)g(b)r(e)227 4942 y(con)n(v)n(erted)c(bac)n(k)h
(to)h(LSRK)f(radio)f(v)n(elo)r(cit)n(y)-7 b(,)27 b(this)h(time)g(in)g
(units)g(of)g Ft(")p Fi(km/s)p Ft(")p Fi(,)e(b)r(efore)h(b)r(eing)h
-(returned.)227 4294 y(The)g(default)g(v)-5 b(alue)27
-b(for)h(this)f(attribute)h(is)g(30)e(GHz.)0 4454 y Fd(T)m(yp)s(e:)227
-4553 y Fi(Floating)h(p)r(oin)n(t.)0 4713 y Fd(Class)k(Applicabilit)m
-(y:)259 4859 y(DSBSp)s(ecF)-8 b(rame)427 4959 y Fi(All)28
-b(DSBSp)r(ecF)-7 b(rames)28 b(ha)n(v)n(e)e(this)i(attribute.)-2
-5130 y Fd(Note)n(:)340 5423 y Fh(\017)45 b Fi(The)32
-b(attributes)g(whic)n(h)g(de\014ne)g(the)g(transformation)e(to)i(or)f
-(from)h(top)r(o)r(cen)n(tric)f(frequency)h(should)f(b)r(e)427
-5522 y(assigned)19 b(their)h(correct)f(v)-5 b(alues)20
-b(b)r(efore)g(accessing)e(this)j(attribute.)34 b(These)20
-b(p)r(oten)n(tially)g(include)g(System,)427 5622 y(Unit,)29
-b(StdOfRest,)f(ObsLon,)f(ObsLat,)g(ObsAlt,)g(Ep)r(o)r(c)n(h,)h(RefRA,)g
-(RefDec)g(and)g(RestF)-7 b(req.)p eop end
+(returned.)227 5065 y(The)g(default)g(v)-5 b(alue)27
+b(for)h(this)f(attribute)h(is)g(30)e(GHz.)0 5213 y Fd(T)m(yp)s(e:)227
+5312 y Fi(Floating)h(p)r(oin)n(t.)0 5459 y Fd(Class)k(Applicabilit)m
+(y:)259 5593 y(DSBSp)s(ecF)-8 b(rame)427 5693 y Fi(All)28
+b(DSBSp)r(ecF)-7 b(rames)28 b(ha)n(v)n(e)e(this)i(attribute.)p
+eop end
%%Page: 432 442
TeXDict begin 432 441 bop 0 52 a FF(432)1994 b Fy(C)91
-b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
-3780 12 v 0 483 a Fz(DefB1950)598 b Fe(Use)39 b(FK4)g(B1950)e(as)i
-(defaults?)595 b Fz(DefB1950)0 697 y Fd(Description:)44
+b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)-2 351 y
+Fd(Note)n(:)340 627 y Fh(\017)45 b Fi(The)32 b(attributes)g(whic)n(h)g
+(de\014ne)g(the)g(transformation)e(to)i(or)f(from)h(top)r(o)r(cen)n
+(tric)f(frequency)h(should)f(b)r(e)427 727 y(assigned)19
+b(their)h(correct)f(v)-5 b(alues)20 b(b)r(efore)g(accessing)e(this)j
+(attribute.)34 b(These)20 b(p)r(oten)n(tially)g(include)g(System,)427
+827 y(Unit,)29 b(StdOfRest,)f(ObsLon,)f(ObsLat,)g(ObsAlt,)g(Ep)r(o)r(c)
+n(h,)h(RefRA,)g(RefDec)g(and)g(RestF)-7 b(req.)p 0 1013
+3780 12 v 0 1145 a Fz(DefB1950)598 b Fe(Use)39 b(FK4)g(B1950)e(as)i
+(defaults?)595 b Fz(DefB1950)0 1298 y Fd(Description:)44
b Fi(This)34 b(attribute)g(is)g(a)f(b)r(o)r(olean)h(v)-5
b(alue)33 b(whic)n(h)h(sp)r(eci\014es)g(a)f(default)h(equino)n(x)f(and)
-h(reference)f(frame)227 797 y(to)d(use)g(when)g(reading)f(a)h(F)-7
+h(reference)f(frame)227 1398 y(to)d(use)g(when)g(reading)f(a)h(F)-7
b(rameSet)30 b(from)f(a)h(FitsChan)g(with)h(a)e(foreign)h(\(i.e.)44
b(non-nativ)n(e\))29 b(enco)r(ding.)44 b(It)31 b(is)227
-896 y(only)g(used)f(if)i(the)f(FITS)g(header)f(con)n(tains)g(RA)h(and)g
-(DEC)g(axes)f(but)h(con)n(tains)f(no)g(information)g(ab)r(out)h(the)227
-996 y(reference)f(frame)g(or)g(equino)n(x.)46 b(If)31
+1497 y(only)g(used)f(if)i(the)f(FITS)g(header)f(con)n(tains)g(RA)h(and)
+g(DEC)g(axes)f(but)h(con)n(tains)f(no)g(information)g(ab)r(out)h(the)
+227 1597 y(reference)f(frame)g(or)g(equino)n(x.)46 b(If)31
b(this)g(is)g(the)g(case,)f(then)i(v)-5 b(alues)30 b(of)h(FK4)f(and)g
-(B1950)f(are)h(assumed)g(if)h(the)227 1096 y(DefB1950)g(attribute)i
+(B1950)f(are)h(assumed)g(if)h(the)227 1697 y(DefB1950)g(attribute)i
(has)f(a)g(non-zero)f(v)-5 b(alue)33 b(and)f(ICRS)h(is)f(assumed)g(if)h
-(DefB1950)e(is)i(zero.)51 b(The)32 b(default)227 1195
+(DefB1950)e(is)i(zero.)51 b(The)32 b(default)227 1796
y(v)-5 b(alue)29 b(for)g(DefB1950)f(dep)r(ends)i(on)f(the)g(v)-5
b(alue)29 b(of)h(the)f(Enco)r(ding)g(attribute:)40 b(for)29
-b(FITS-W)n(CS)g(enco)r(ding)g(the)227 1295 y(default)f(is)g(zero,)e
+b(FITS-W)n(CS)g(enco)r(ding)g(the)227 1896 y(default)f(is)g(zero,)e
(and)i(for)f(all)g(other)g(enco)r(dings)g(it)h(is)g(one.)0
-1493 y Fd(T)m(yp)s(e:)227 1592 y Fi(In)n(teger)f(\(b)r(o)r(olean\).)0
-1791 y Fd(Class)k(Applicabilit)m(y:)259 1975 y(FitsChan)427
-2075 y Fi(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)p
-0 2323 V 0 2461 a Fz(Digits/Digits\(axis\))1390 2455
-y Fe(Num)m(b)s(er)38 b(of)h(digits)e(of)1665 2566 y(precision)2680
-2461 y Fz(Digits/Digits\(axis\))0 2803 y Fd(Description:)44
+2039 y Fd(T)m(yp)s(e:)227 2139 y Fi(In)n(teger)f(\(b)r(o)r(olean\).)0
+2282 y Fd(Class)k(Applicabilit)m(y:)259 2412 y(FitsChan)427
+2512 y Fi(All)d(FitsChans)g(ha)n(v)n(e)e(this)i(attribute.)p
+0 2698 V 0 2837 a Fz(Digits/Digits\(axis\))1390 2830
+y Fe(Num)m(b)s(er)38 b(of)h(digits)e(of)1665 2941 y(precision)2680
+2837 y Fz(Digits/Digits\(axis\))0 3117 y Fd(Description:)44
b Fi(This)26 b(attribute)g(sp)r(eci\014es)f(ho)n(w)g(man)n(y)g(digits)h
(of)f(precision)g(are)f(required)h(b)n(y)g(default)h(when)g(a)f(co)r
-(or-)227 2903 y(dinate)k(v)-5 b(alue)29 b(is)g(formatted)f(for)h(a)f(F)
+(or-)227 3217 y(dinate)k(v)-5 b(alue)29 b(is)g(formatted)f(for)h(a)f(F)
-7 b(rame)28 b(axis)h(\(e.g.)40 b(using)29 b(astF)-7
b(ormat\).)39 b(Its)29 b(v)-5 b(alue)29 b(ma)n(y)f(b)r(e)i(set)e
-(either)h(for)227 3002 y(a)g(F)-7 b(rame)29 b(as)g(a)g(whole,)h(or)f
+(either)h(for)227 3316 y(a)g(F)-7 b(rame)29 b(as)g(a)g(whole,)h(or)f
(\(b)n(y)g(subscripting)g(the)h(attribute)g(name)f(with)h(the)g(n)n(um)
-n(b)r(er)g(of)f(an)g(axis\))g(for)g(eac)n(h)227 3102
+n(b)r(er)g(of)f(an)g(axis\))g(for)g(eac)n(h)227 3416
y(axis)h(individually)-7 b(.)45 b(An)n(y)30 b(v)-5 b(alue)31
b(set)f(for)g(an)g(individual)g(axis)g(will)g(o)n(v)n(er-ride)e(the)j
(v)-5 b(alue)30 b(for)g(the)h(F)-7 b(rame)29 b(as)h(a)227
-3201 y(whole.)227 3350 y(Note)d(that)f(the)h(Digits)g(v)-5
+3516 y(whole.)227 3637 y(Note)d(that)f(the)h(Digits)g(v)-5
b(alue)26 b(acts)g(only)g(as)g(a)g(means)g(of)g(determining)g(a)g
(default)h(F)-7 b(ormat)26 b(string.)36 b(Its)26 b(e\013ects)227
-3450 y(are)32 b(o)n(v)n(er-ridden)f(if)i(a)g(F)-7 b(ormat)32
+3737 y(are)32 b(o)n(v)n(er-ridden)f(if)i(a)g(F)-7 b(ormat)32
b(string)g(is)h(set)g(explicitly)g(for)f(an)g(axis.)52
b(Ho)n(w)n(ev)n(er,)33 b(if)g(the)g(F)-7 b(ormat)32 b(attribute)227
-3550 y(sp)r(eci\014es)37 b(the)g(precision)f(using)g(the)h(string)f
+3836 y(sp)r(eci\014es)37 b(the)g(precision)f(using)g(the)h(string)f
Ft(")p Fi(.)p Fh(\003)p Ft(")p Fi(,)i(then)f(the)g(Digits)g(attribute)g
-(is)f(used)h(to)f(determine)h(the)227 3649 y(n)n(um)n(b)r(er)28
-b(of)f(decimal)h(places)e(to)i(pro)r(duce.)0 3847 y Fd(T)m(yp)s(e:)227
-3947 y Fi(In)n(teger.)0 4145 y Fd(Class)j(Applicabilit)m(y:)259
-4330 y(F)-8 b(rame)427 4429 y Fi(The)30 b(default)f(Digits)h(v)-5
+(is)f(used)h(to)f(determine)h(the)227 3936 y(n)n(um)n(b)r(er)28
+b(of)f(decimal)h(places)e(to)i(pro)r(duce.)0 4079 y Fd(T)m(yp)s(e:)227
+4179 y Fi(In)n(teger.)0 4322 y Fd(Class)j(Applicabilit)m(y:)259
+4452 y(F)-8 b(rame)427 4552 y Fi(The)30 b(default)f(Digits)h(v)-5
b(alue)29 b(supplied)h(b)n(y)f(the)g(F)-7 b(rame)29 b(class)f(is)i(7.)
41 b(If)30 b(a)f(v)-5 b(alue)29 b(less)g(than)g(1)g(is)g(supplied,)427
-4529 y(then)f(1)g(is)f(used)h(instead.)259 4686 y Fd(F)-8
-b(rameSet)427 4786 y Fi(The)23 b(Digits)f(attribute)g(of)h(a)f(F)-7
+4651 y(then)f(1)g(is)f(used)h(instead.)259 4778 y Fd(F)-8
+b(rameSet)427 4877 y Fi(The)23 b(Digits)f(attribute)g(of)h(a)f(F)-7
b(rameSet)22 b(\(or)f(one)h(of)g(its)h(axes\))e(is)i(the)f(same)g(as)g
-(that)g(of)g(its)h(curren)n(t)e(F)-7 b(rame)427 4885
+(that)g(of)g(its)h(curren)n(t)e(F)-7 b(rame)427 4977
y(\(as)27 b(sp)r(eci\014ed)h(b)n(y)g(the)g(Curren)n(t)e(attribute\).)
-259 5043 y Fd(Plot)427 5142 y Fi(The)34 b(default)h(Digits)f(v)-5
+259 5104 y Fd(Plot)427 5203 y Fi(The)34 b(default)h(Digits)f(v)-5
b(alue)33 b(used)h(b)n(y)g(the)g(Plot)g(class)f(when)h(dra)n(wing)e
-(annotated)i(axis)f(lab)r(els)g(is)h(the)427 5242 y(smallest)27
+(annotated)i(axis)f(lab)r(els)g(is)h(the)427 5303 y(smallest)27
b(v)-5 b(alue)28 b(whic)n(h)f(results)h(in)f(all)h(adjacen)n(t)f(lab)r
-(els)g(b)r(eing)h(distinct.)259 5399 y Fd(TimeF)-8 b(rame)427
-5499 y Fi(The)27 b(Digits)f(attribute)g(is)g(ignored)f(when)i(a)e
+(els)g(b)r(eing)h(distinct.)259 5429 y Fd(TimeF)-8 b(rame)427
+5529 y Fi(The)27 b(Digits)f(attribute)g(is)g(ignored)f(when)i(a)e
(TimeF)-7 b(rame)26 b(formats)f(a)h(v)-5 b(alue)26 b(as)g(a)g(date)g
-(and)g(time)g(string)427 5598 y(\(see)i(the)g(F)-7 b(ormat)27
+(and)g(time)g(string)427 5629 y(\(see)i(the)g(F)-7 b(ormat)27
b(attribute\).)p eop end
%%Page: 433 443
TeXDict begin 433 442 bop 3643 52 a FF(433)p 0 351 3780
@@ -131140,32 +131263,33 @@ b(FITS-CLASS)h(is)f(used)g(if)g(the)h(FitsChan)f(con)n(tains)f(a)g(DEL)
-7 b(T)g(A)e(V)25 b(k)n(eyw)n(ord)d(and)i(a)f(k)n(eyw)n(ord)427
3801 y(of)f(the)g(form)f(VELO-xxx,)h(where)f(xxx)g(indicates)g(one)h
(of)f(the)h(rest)g(frames)f(used)g(b)n(y)h(class)e(\(e.g.)35
-b Ft(")p Fi(VELO-)427 3900 y(LSR)p Ft(")p Fi(\).)340
-4033 y Fh(\017)45 b Fi(Otherwise,)e(if)e(the)g(FitsChan)f(con)n(tains)g
-(a)g(CTYPE)g(k)n(eyw)n(ord)e(whic)n(h)j(represen)n(ts)d(a)j(sp)r
-(ectral)e(axis)427 4133 y(using)f(the)h(con)n(v)n(en)n(tions)e(of)i
-(the)f(AIPS)h(and)f(AIPS++)g(pro)5 b(jects)37 b(\(e.g.)70
-b Ft(")p Fi(FELO-LSR)p Ft(")p Fi(,)39 b(etc\),)j(then)427
-4232 y(one)31 b(of)g(FITS-AIPS)g(or)f(FITS-AIPS++)g(enco)r(ding)h(is)f
-(used.)48 b(FITS-AIPS++)30 b(is)h(used)f(if)i(an)n(y)e(of)h(the)427
-4332 y(k)n(eyw)n(ords)g(CDi)p Ft(_)p Fi(j,)j(PR)n(OJP)-7
-b(,)32 b(LONPOLE)f(or)g(LA)-7 b(TPOLE)32 b(are)g(found)h(in)g(the)g
-(FitsChan.)52 b(Otherwise)427 4431 y(FITS-AIPS)28 b(is)f(used.)340
-4564 y Fh(\017)45 b Fi(Otherwise,)28 b(if)g(the)h(FitsChan)f(con)n
-(tains)f(a)h(k)n(eyw)n(ord)e(of)i(the)g(form)g Ft(")p
-Fi(PCiiijjj)p Ft(")p Fi(,)g(where)g Ft(")p Fi(i)p Ft(")f
-Fi(and)h Ft(")p Fi(j)p Ft(")g Fi(are)427 4664 y(single)f(digits,)h
-(then)g(FITS-PC)f(enco)r(ding)g(is)h(used,)340 4797 y
-Fh(\017)45 b Fi(Otherwise,)27 b(if)h(the)g(FitsChan)g(con)n(tains)f(a)g
-(k)n(eyw)n(ord)e(of)j(the)g(form)f Ft(")p Fi(CDiiijjj)p
-Ft(")p Fi(,)i(where)e Ft(")p Fi(i)p Ft(")g Fi(and)g Ft(")p
-Fi(j)p Ft(")h Fi(are)427 4896 y(single)f(digits,)h(then)g(FITS-IRAF)g
-(enco)r(ding)f(is)h(used,)340 5029 y Fh(\017)45 b Fi(Otherwise,)c(if)e
-(the)f(FitsChan)h(con)n(tains)e(a)h(k)n(eyw)n(ord)f(of)h(the)h(form)f
-Ft(")p Fi(CDi)p Ft(_)p Fi(j)p Ft(")p Fi(,)j(and)d(at)h(least)f(one)g
-(of)427 5129 y(RADECSYS,)43 b(PR)n(OJPi,)g(or)d(CjV)-9
-b(ALi)42 b(where)f Ft(")p Fi(i)p Ft(")g Fi(and)g Ft(")p
-Fi(j)p Ft(")g Fi(are)f(single)h(digits,)k(then)d(FITS-IRAF)427
+b Ft(")p Fi(VELO-)427 3900 y(LSR)p Ft(")p Fi(\),)28 b(or)f
+Ft(")p Fi(VLSR)p Ft(")p Fi(.)340 4033 y Fh(\017)45 b
+Fi(Otherwise,)e(if)e(the)g(FitsChan)f(con)n(tains)g(a)g(CTYPE)g(k)n
+(eyw)n(ord)e(whic)n(h)j(represen)n(ts)d(a)j(sp)r(ectral)e(axis)427
+4133 y(using)f(the)h(con)n(v)n(en)n(tions)e(of)i(the)f(AIPS)h(and)f
+(AIPS++)g(pro)5 b(jects)37 b(\(e.g.)70 b Ft(")p Fi(FELO-LSR)p
+Ft(")p Fi(,)39 b(etc\),)j(then)427 4232 y(one)31 b(of)g(FITS-AIPS)g(or)
+f(FITS-AIPS++)g(enco)r(ding)h(is)f(used.)48 b(FITS-AIPS++)30
+b(is)h(used)f(if)i(an)n(y)e(of)h(the)427 4332 y(k)n(eyw)n(ords)g(CDi)p
+Ft(_)p Fi(j,)j(PR)n(OJP)-7 b(,)32 b(LONPOLE)f(or)g(LA)-7
+b(TPOLE)32 b(are)g(found)h(in)g(the)g(FitsChan.)52 b(Otherwise)427
+4431 y(FITS-AIPS)28 b(is)f(used.)340 4564 y Fh(\017)45
+b Fi(Otherwise,)28 b(if)g(the)h(FitsChan)f(con)n(tains)f(a)h(k)n(eyw)n
+(ord)e(of)i(the)g(form)g Ft(")p Fi(PCiiijjj)p Ft(")p
+Fi(,)g(where)g Ft(")p Fi(i)p Ft(")f Fi(and)h Ft(")p Fi(j)p
+Ft(")g Fi(are)427 4664 y(single)f(digits,)h(then)g(FITS-PC)f(enco)r
+(ding)g(is)h(used,)340 4797 y Fh(\017)45 b Fi(Otherwise,)27
+b(if)h(the)g(FitsChan)g(con)n(tains)f(a)g(k)n(eyw)n(ord)e(of)j(the)g
+(form)f Ft(")p Fi(CDiiijjj)p Ft(")p Fi(,)i(where)e Ft(")p
+Fi(i)p Ft(")g Fi(and)g Ft(")p Fi(j)p Ft(")h Fi(are)427
+4896 y(single)f(digits,)h(then)g(FITS-IRAF)g(enco)r(ding)f(is)h(used,)
+340 5029 y Fh(\017)45 b Fi(Otherwise,)c(if)e(the)f(FitsChan)h(con)n
+(tains)e(a)h(k)n(eyw)n(ord)f(of)h(the)h(form)f Ft(")p
+Fi(CDi)p Ft(_)p Fi(j)p Ft(")p Fi(,)j(and)d(at)h(least)f(one)g(of)427
+5129 y(RADECSYS,)43 b(PR)n(OJPi,)g(or)d(CjV)-9 b(ALi)42
+b(where)f Ft(")p Fi(i)p Ft(")g Fi(and)g Ft(")p Fi(j)p
+Ft(")g Fi(are)f(single)h(digits,)k(then)d(FITS-IRAF)427
5228 y(enco)r(ding)28 b(is)f(used.)340 5361 y Fh(\017)45
b Fi(Otherwise,)26 b(if)i(the)f(FitsChan)f(con)n(tains)g(an)n(y)g(k)n
(eyw)n(ords)e(of)j(the)g(form)f(PR)n(OJPi,)f(CjV)-9 b(ALi)28
@@ -137131,393 +137255,523 @@ y Fd(F)-8 b(rame)427 451 y Fi(If)24 b(UseDefs)g(is)f(zero,)g(an)g
b(if)i(the)g(Ep)r(o)r(c)n(h,)g(ObsLat)e(or)h(ObsLon)427
551 y(attribute)28 b(is)g(required)e(but)i(has)f(not)h(b)r(een)g
(assigned)e(a)i(v)-5 b(alue)27 b(explicitly)-7 b(.)259
-681 y Fd(SkyF)f(rame)427 781 y Fi(If)41 b(UseDefs)f(is)g(zero,)h(an)f
+698 y Fd(SkyF)f(rame)427 798 y Fi(If)41 b(UseDefs)f(is)g(zero,)h(an)f
(error)e(is)h(rep)r(orted)h(when)g(aligning)e(SkyF)-7
b(rames)39 b(if)i(an)n(y)e(of)g(the)i(follo)n(wing)427
-881 y(attributes)28 b(are)e(required)h(but)h(ha)n(v)n(e)f(not)g(b)r
+897 y(attributes)28 b(are)e(required)h(but)h(ha)n(v)n(e)f(not)g(b)r
(een)h(assigned)f(a)g(v)-5 b(alue)27 b(explicitly:)37
-b(Ep)r(o)r(c)n(h,)28 b(Equino)n(x.)259 1012 y Fd(Sp)s(ecF)-8
-b(rame)427 1111 y Fi(If)38 b(UseDefs)g(is)g(zero,)h(an)e(error)f(is)h
+b(Ep)r(o)r(c)n(h,)28 b(Equino)n(x.)259 1045 y Fd(Sp)s(ecF)-8
+b(rame)427 1145 y Fi(If)38 b(UseDefs)g(is)g(zero,)h(an)e(error)f(is)h
(rep)r(orted)g(when)h(aligning)e(Sp)r(ecF)-7 b(rames)37
-b(if)h(an)n(y)f(of)h(the)g(follo)n(wing)427 1211 y(attributes)24
+b(if)h(an)n(y)f(of)h(the)g(follo)n(wing)427 1244 y(attributes)24
b(are)f(required)f(but)j(ha)n(v)n(e)d(not)i(b)r(een)g(assigned)e(a)i(v)
-5 b(alue)23 b(explicitly:)35 b(Ep)r(o)r(c)n(h,)24 b(RefRA,)h(RefDec,)
-427 1310 y(RestF)-7 b(req,)28 b(SourceV)-7 b(el,)27 b(StdOfRest.)259
-1441 y Fd(DSBSp)s(ecF)-8 b(rame)427 1541 y Fi(If)27 b(UseDefs)g(is)g
+427 1344 y(RestF)-7 b(req,)28 b(SourceV)-7 b(el,)27 b(StdOfRest.)259
+1492 y Fd(DSBSp)s(ecF)-8 b(rame)427 1591 y Fi(If)27 b(UseDefs)g(is)g
(zero,)f(an)g(error)f(is)h(rep)r(orted)g(when)h(aligning)f(DSBSp)r(ecF)
--7 b(rames)26 b(or)g(when)h(accessing)e(the)427 1641
+-7 b(rames)26 b(or)g(when)h(accessing)e(the)427 1691
y(ImagF)-7 b(req)25 b(attribute)h(if)g(an)n(y)f(of)h(the)g(follo)n
(wing)f(attributes)g(are)g(required)g(but)h(ha)n(v)n(e)f(not)h(b)r(een)
-g(assigned)427 1740 y(a)h(v)-5 b(alue)28 b(explicitly:)37
-b(Ep)r(o)r(c)n(h,)27 b(DSBCen)n(tre,)h(IF.)p 0 1936 3780
-12 v 0 2067 a Fz(W)-11 b(arnings)345 b Fe(Con)m(trols)36
-b(the)j(issuing)f(of)g(w)m(arnings)f(ab)s(out)1429 2182
-y(v)-7 b(arious)38 b(conditions)3224 2067 y Fz(W)-11
-b(arnings)0 2344 y Fd(Description:)44 b Fi(This)27 b(attribute)g(con)n
-(trols)f(the)h(issuing)g(of)f(w)n(arnings)g(ab)r(out)h(selected)f
-(conditions)h(when)g(an)g(Ob)5 b(ject)227 2443 y(or)28
-b(k)n(eyw)n(ord)f(is)i(read)f(from)h(or)f(written)h(to)g(a)f(FitsChan.)
-41 b(The)29 b(v)-5 b(alue)29 b(supplied)g(for)f(the)h(W)-7
-b(arnings)28 b(attribute)227 2543 y(should)d(consist)f(of)h(a)g(space)f
-(separated)g(list)h(of)g(condition)g(names)f(\(see)h(the)h(AllW)-7
-b(arnings)24 b(attribute)h(for)g(a)f(list)227 2643 y(of)29
-b(the)g(curren)n(tly)f(de\014ned)h(names\).)41 b(Eac)n(h)28
-b(name)g(indicates)h(a)f(condition)h(whic)n(h)g(should)f(b)r(e)i(rep)r
-(orted.)40 b(The)227 2742 y(default)28 b(v)-5 b(alue)28
-b(for)f(W)-7 b(arnings)27 b(is)g(the)h(string)f Ft(")p
-Fi(Tnx)g(Zp)n(x)g(BadCel)g(BadMat)g(BadPV)g(BadCTYPE)p
-Ft(")p Fi(.)227 2866 y(The)e(text)h(of)f(an)n(y)f(w)n(arning)g(will)i
-(b)r(e)f(stored)f(within)i(the)g(FitsChan)f(in)g(the)h(form)f(of)g(one)
-g(or)f(more)g(new)h(header)227 2965 y(cards)i(with)i(k)n(eyw)n(ord)d
-(ASTW)-9 b(ARN.)29 b(If)f(required,)f(applications)g(can)h(c)n(hec)n(k)
-f(the)h(FitsChan)g(for)f(ASTW)-9 b(ARN)227 3065 y(cards)24
-b(\(using)h(astFindFits\))h(after)f(the)g(call)g(to)g(astRead)f(or)g
-(astW)-7 b(rite)25 b(has)f(b)r(een)i(p)r(erformed,)f(and)g(rep)r(ort)f
-(the)227 3165 y(text)35 b(of)f(an)n(y)g(suc)n(h)g(cards)f(to)h(the)h
-(user.)56 b(ASTW)-9 b(ARN)36 b(cards)d(will)i(b)r(e)f(propagated)f(to)h
-(an)n(y)g(output)g(header)227 3264 y(unless)28 b(they)f(are)g(deleted)h
-(from)f(the)h(FitsChan)g(using)f(astDelFits.)0 3412 y
-Fd(T)m(yp)s(e:)227 3511 y Fi(String)0 3659 y Fd(Class)k(Applicabilit)m
-(y:)259 3793 y(FitsChan)427 3893 y Fi(All)d(FitsChans)g(ha)n(v)n(e)e
-(this)i(attribute.)0 4053 y Fd(Notes:)227 4199 y Fi(This)36
+g(assigned)427 1790 y(a)h(v)-5 b(alue)28 b(explicitly:)37
+b(Ep)r(o)r(c)n(h,)27 b(DSBCen)n(tre,)h(IF.)p 0 2019 3780
+12 v 0 2151 a Fz(V)-11 b(arian)l(t)178 b Fe(Indicates)38
+b(whic)m(h)g(v)-7 b(arian)m(t)36 b(of)j(the)f(curren)m(t)g(F)-10
+b(rame)38 b(is)h(to)1696 2251 y(b)s(e)g(used)3343 2151
+y Fz(V)-11 b(arian)l(t)0 2446 y Fd(Description:)44 b
+Fi(This)34 b(attribute)g(can)g(b)r(e)g(used)g(to)f(c)n(hange)g(the)h
+(Mapping)g(that)g(connects)f(the)h(curren)n(t)f(F)-7
+b(rame)34 b(to)227 2545 y(the)j(other)f(F)-7 b(rames)36
+b(in)h(the)g(F)-7 b(rameSet.)63 b(By)37 b(default,)i(eac)n(h)d(F)-7
+b(rame)36 b(in)g(a)h(F)-7 b(rameSet)36 b(is)g(connected)h(to)f(the)227
+2645 y(other)24 b(F)-7 b(rames)23 b(b)n(y)h(a)f(single)h(Mapping)f
+(that)i(can)e(only)h(b)r(e)g(c)n(hanged)f(b)n(y)h(using)g(the)g
+(astRemapF)-7 b(rame)23 b(metho)r(d.)227 2745 y(Ho)n(w)n(ev)n(er,)h(it)
+i(is)f(also)f(p)r(ossible)h(to)g(asso)r(ciate)f(m)n(ultiple)i(Mappings)
+e(with)i(a)f(F)-7 b(rame,)25 b(eac)n(h)g(Mapping)g(ha)n(ving)f(an)227
+2844 y(iden)n(tifying)32 b(name.)48 b(If)32 b(this)f(is)h(done,)g(the)g
+Ft(")p Fi(V)-7 b(arian)n(t)p Ft(")29 b Fi(attribute)j(can)f(b)r(e)h
+(set)f(to)g(indicate)h(the)g(name)f(of)g(the)227 2944
+y(Mapping)d(that)f(is)h(to)f(b)r(e)h(used)g(with)g(the)g(curren)n(t)f
+(F)-7 b(rame.)227 3083 y(A)30 b(p)r(ossible)e(\(if)i(unlik)n(ely\))f
+(use-case)f(is)h(to)g(create)f(a)g(F)-7 b(rameSet)29
+b(that)g(can)g(b)r(e)g(used)g(to)g(describ)r(e)g(the)g(W)n(CS)h(of)227
+3183 y(an)k(image)f(formed)g(b)n(y)h(co-adding)f(images)f(of)i(t)n(w)n
+(o)f(di\013eren)n(t)h(parts)f(of)h(the)g(sky)-7 b(.)56
+b(In)34 b(suc)n(h)f(an)h(image,)g(eac)n(h)227 3282 y(pixel)24
+b(con)n(tains)f(\015ux)h(from)g(t)n(w)n(o)f(p)r(oin)n(ts)h(on)g(the)g
+(sky)-7 b(.and)23 b(so)h(the)g(W)n(CS)g(for)g(the)g(image)f(should)h
+(ideally)f(con)n(tain)227 3382 y(one)31 b(pixel)h(F)-7
+b(rame)31 b(and)h(t)n(w)n(o)e(SkyF)-7 b(rames)31 b(-)g(one)g
+(describing)g(eac)n(h)g(of)h(the)f(t)n(w)n(o)g(co-added)g(images.)48
+b(There)31 b(is)227 3482 y(nothing)d(to)h(prev)n(en)n(t)e(a)h(F)-7
+b(rameSet)28 b(con)n(taining)f(t)n(w)n(o)h(explicit)g(SkyF)-7
+b(rames,)28 b(but)h(the)f(problem)g(then)h(arises)e(of)227
+3581 y(ho)n(w)j(to)h(distinguish)f(b)r(et)n(w)n(een)h(them.)46
+b(The)30 b(t)n(w)n(o)g(primary)f(c)n(haracteristics)g(of)h(a)g(F)-7
+b(rame)30 b(that)h(distinguishes)227 3681 y(it)j(from)e(other)h(F)-7
+b(rames)32 b(ar)g(eits)h(class)f(and)h(its)h(Domain)e(attribute)i(v)-5
+b(alue.)53 b(The)33 b(class)f(of)h(a)g(F)-7 b(rame)32
+b(cannot)227 3781 y(b)r(e)40 b(c)n(hanged,)h(but)f(w)n(e)f(could)h(in)f
+(principle)g(use)h(t)n(w)n(o)e(di\013eren)n(t)i(Domain)f(v)-5
+b(alues)39 b(to)g(distinguish)h(the)f(t)n(w)n(o)227 3880
+y(SkyF)-7 b(rames.)69 b(Ho)n(w)n(ev)n(er,)40 b(in)f(practice)f(it)h(is)
+g(not)f(uncommon)h(for)f(application)g(soft)n(w)n(are)f(to)h(assume)g
+(that)227 3980 y(SkyF)-7 b(rames)25 b(will)h(ha)n(v)n(e)f(the)h
+(default)g(Domain)f(v)-5 b(alue)26 b(of)g Ft(")p Fi(SKY)p
+Ft(")p Fi(.)35 b(That)26 b(is,)g(instead)g(of)f(searc)n(hing)f(for)h(F)
+-7 b(rames)227 4079 y(that)25 b(ha)n(v)n(e)d(a)i(class)f(of)h
+Ft(")p Fi(SkyF)-7 b(rame)p Ft(")p Fi(,)23 b(suc)n(h)h(soft)n(w)n(are)e
+(searc)n(hes)g(for)i(F)-7 b(rames)23 b(that)h(ha)n(v)n(e)f(a)g(Domain)h
+(of)g Ft(")p Fi(SKY)p Ft(")p Fi(.)227 4179 y(T)-7 b(o)28
+b(alleviate)g(this)h(problem,)f(it)h(is)f(p)r(ossible)g(to)g(add)h(a)f
+(single)f(SkyF)-7 b(rame)28 b(to)g(the)h(F)-7 b(rameSet,)29
+b(but)g(sp)r(ecifying)227 4279 y(t)n(w)n(o)c(alternate)f(Mappings)h(to)
+g(use)h(with)g(the)f(SkyF)-7 b(rame.)36 b(Setting)25
+b(the)h Ft(")p Fi(V)-7 b(arian)n(t)p Ft(")24 b Fi(attribute)h(to)h(the)
+f(name)h(of)227 4378 y(one)i(or)g(the)h(other)f(of)h(these)f(alternate)
+g(Mappings)g(will)h(cause)e(the)i(SkyF)-7 b(rame)28 b(to)h(b)r(e)g
+(remapp)r(ed)f(within)h(the)227 4478 y(F)-7 b(rameSet)31
+b(so)g(that)g(it)h(uses)e(the)i(sp)r(eci\014ed)f(Mapping.)47
+b(The)32 b(same)e(facilit)n(y)h(can)g(b)r(e)g(used)g(with)h(an)n(y)e
+(class)h(of)227 4578 y(F)-7 b(rame,)27 b(not)h(just)g(SkyF)-7
+b(rames.)227 4717 y(T)g(o)24 b(use)g(this)h(facilit)n(y)-7
+b(,)24 b(the)h(F)-7 b(rame)24 b(should)g(\014rst)g(b)r(e)g(added)g(to)g
+(the)h(F)-7 b(rameSet)24 b(in)g(the)h(usual)f(manner)f(using)h(the)227
+4817 y(astAddF)-7 b(rame)22 b(metho)r(d.)36 b(By)22 b(default,)i(the)f
+(Mapping)f(supplied)h(to)g(astAddF)-7 b(rame)22 b(is)g(assigned)g(a)g
+(name)g(equal)227 4916 y(to)32 b(the)g(Domain)g(name)g(of)g(the)g(F)-7
+b(rame.)50 b(T)-7 b(o)31 b(assign)g(a)g(di\013eren)n(t)i(name)e(to)h
+(it,)i(the)e(astAddV)-7 b(arian)n(t)31 b(metho)r(d)227
+5016 y(should)38 b(then)g(b)r(e)g(called)f(sp)r(ecifying)g(the)h
+(required)f(name)g(and)h(a)f(NULL)h(Mapping.)66 b(The)38
+b(astAddF)-7 b(rame)227 5115 y(metho)r(d)23 b(should)f(then)h(b)r(e)g
+(called)f(rep)r(eatedly)g(to)g(add)g(eac)n(h)g(required)f(extra)h
+(Mapping)g(to)g(the)h(curren)n(t)e(F)-7 b(rame,)227 5215
+y(supplying)28 b(a)f(unique)h(name)f(for)g(eac)n(h)g(one.)227
+5354 y(Eac)n(h)g(F)-7 b(rame)28 b(in)g(a)g(F)-7 b(rameSet)27
+b(can)h(ha)n(v)n(e)f(its)h(o)n(wn)f(set)i(of)f(v)-5 b(arian)n(t)27
+b(Mappings.)37 b(T)-7 b(o)28 b(con)n(trol)e(the)j(Mappings)e(in)227
+5454 y(use)h(with)g(a)f(sp)r(eci\014c)h(F)-7 b(rame,)27
+b(y)n(ou)g(need)g(\014rst)h(to)f(mak)n(e)g(it)h(the)g(curren)n(t)f(F)-7
+b(rame)27 b(in)h(the)g(F)-7 b(rameSet.)227 5593 y(The)23
+b(astMirrorV)-7 b(arian)n(ts)20 b(function)k(allo)n(ws)d(the)j
+(e\013ects)f(of)g(v)-5 b(arian)n(t)22 b(Mappings)h(asso)r(ciated)e
+(with)j(a)f(nominated)227 5693 y(F)-7 b(rame)27 b(to)h(b)r(e)g
+(propagated)e(to)h(other)g(F)-7 b(rames)27 b(in)h(the)g(F)-7
+b(rameSet.)p eop end
+%%Page: 517 527
+TeXDict begin 517 526 bop 3643 52 a FF(517)227 351 y
+Fi(Once)27 b(this)h(has)e(b)r(een)i(done,)f(setting)h(a)f(new)g(v)-5
+b(alue)27 b(for)g(the)h Ft(")p Fi(V)-7 b(arian)n(t)p
+Ft(")25 b Fi(attribute)j(of)f(a)g(F)-7 b(rameSet)27 b(will)g(cause)227
+451 y(the)f(curren)n(t)e(F)-7 b(rame)24 b(in)h(the)g(F)-7
+b(rameSet)25 b(to)g(b)r(e)g(remapp)r(ed)g(to)g(use)f(the)i(sp)r
+(eci\014ed)f(v)-5 b(arian)n(t)24 b(Mapping.)35 b(An)26
+b(error)227 551 y(will)i(b)r(e)g(rep)r(orted)f(if)h(the)g(curren)n(t)f
+(F)-7 b(rame)27 b(has)g(no)g(v)-5 b(arian)n(t)27 b(Mapping)g(with)h
+(the)g(supplied)g(name.)227 689 y(Getting)d(the)f(v)-5
+b(alue)24 b(of)g(the)g Ft(")p Fi(V)-7 b(arian)n(t)p Ft(")23
+b Fi(attribute)h(will)g(return)f(the)i(name)f(of)g(the)g(v)-5
+b(arian)n(t)23 b(Mapping)h(curren)n(tly)227 789 y(in)i(use)f(with)h
+(the)g(curren)n(t)f(F)-7 b(rame.)35 b(If)26 b(the)g(F)-7
+b(rame)25 b(has)g(no)g(v)-5 b(arian)n(t)25 b(Mappings,)g(the)h(v)-5
+b(alue)25 b(will)h(default)g(to)f(the)227 888 y(Domain)j(name)f(of)h
+(the)g(curren)n(t)e(F)-7 b(rame.)227 1027 y(Clearing)27
+b(the)h Ft(")p Fi(V)-7 b(arian)n(t)p Ft(")27 b Fi(attribute)h(will)g
+(ha)n(v)n(e)f(the)i(e\013ect)f(of)g(remo)n(ving)f(all)g(v)-5
+b(arian)n(t)27 b(Mappings)h(\(except)g(for)227 1126 y(the)g(curren)n
+(tly)f(selected)g(Mapping\))h(from)f(the)h(curren)n(t)f(F)-7
+b(rame.)227 1265 y(T)g(esting)37 b(the)g Ft(")p Fi(V)-7
+b(arian)n(t)p Ft(")36 b Fi(attribute)h(will)g(return)f(a)h(non-zero)e
+(v)-5 b(alue)37 b(if)h(the)f(curren)n(t)f(F)-7 b(rame)36
+b(con)n(tains)g(an)n(y)227 1364 y(v)-5 b(arian)n(t)27
+b(Mappings,)g(and)g(zero)g(otherwise.)227 1503 y(A)37
+b(complete)g(list)f(of)h(the)g(names)f(asso)r(ciated)f(with)i(all)f
+(the)h(a)n(v)-5 b(ailable)35 b(v)-5 b(arian)n(t)36 b(Mappings)g(in)h
+(the)f(curren)n(t)227 1602 y(F)-7 b(rame)27 b(can)h(b)r(e)g(obtained)f
+(from)g(the)h(AllV)-7 b(arian)n(ts)27 b(attribute.)227
+1741 y(If)32 b(a)f(F)-7 b(rame)31 b(with)h(v)-5 b(arian)n(t)31
+b(Mappings)g(is)g(remapp)r(ed)g(using)g(the)h(astRemapF)-7
+b(rame)31 b(metho)r(d,)i(the)f(curren)n(tly)227 1841
+y(selected)26 b(v)-5 b(arian)n(t)26 b(Mapping)g(is)g(used)g(b)n(y)g
+(astRemapF)-7 b(rame)25 b(and)h(the)h(other)f(v)-5 b(arian)n(t)25
+b(Mappings)h(are)f(remo)n(v)n(ed)227 1940 y(from)j(the)g(F)-7
+b(rame.)0 2117 y Fd(T)m(yp)s(e:)227 2217 y Fi(String.)0
+2394 y Fd(Class)31 b(Applicabilit)m(y:)259 2559 y(F)-8
+b(rameSet)427 2658 y Fi(All)28 b(F)-7 b(rameSets)27 b(ha)n(v)n(e)g
+(this)h(attribute.)p 0 2885 3780 12 v 0 3017 a Fz(W)-11
+b(arnings)345 b Fe(Con)m(trols)36 b(the)j(issuing)f(of)g(w)m(arnings)f
+(ab)s(out)1429 3132 y(v)-7 b(arious)38 b(conditions)3224
+3017 y Fz(W)-11 b(arnings)0 3325 y Fd(Description:)44
+b Fi(This)27 b(attribute)g(con)n(trols)f(the)h(issuing)g(of)f(w)n
+(arnings)g(ab)r(out)h(selected)f(conditions)h(when)g(an)g(Ob)5
+b(ject)227 3425 y(or)28 b(k)n(eyw)n(ord)f(is)i(read)f(from)h(or)f
+(written)h(to)g(a)f(FitsChan.)41 b(The)29 b(v)-5 b(alue)29
+b(supplied)g(for)f(the)h(W)-7 b(arnings)28 b(attribute)227
+3524 y(should)d(consist)f(of)h(a)g(space)f(separated)g(list)h(of)g
+(condition)g(names)f(\(see)h(the)h(AllW)-7 b(arnings)24
+b(attribute)h(for)g(a)f(list)227 3624 y(of)29 b(the)g(curren)n(tly)f
+(de\014ned)h(names\).)41 b(Eac)n(h)28 b(name)g(indicates)h(a)f
+(condition)h(whic)n(h)g(should)f(b)r(e)i(rep)r(orted.)40
+b(The)227 3723 y(default)28 b(v)-5 b(alue)28 b(for)f(W)-7
+b(arnings)27 b(is)g(the)h(string)f Ft(")p Fi(Tnx)g(Zp)n(x)g(BadCel)g
+(BadMat)g(BadPV)g(BadCTYPE)p Ft(")p Fi(.)227 3862 y(The)e(text)h(of)f
+(an)n(y)f(w)n(arning)g(will)i(b)r(e)f(stored)f(within)i(the)g(FitsChan)
+f(in)g(the)h(form)f(of)g(one)g(or)f(more)g(new)h(header)227
+3962 y(cards)i(with)i(k)n(eyw)n(ord)d(ASTW)-9 b(ARN.)29
+b(If)f(required,)f(applications)g(can)h(c)n(hec)n(k)f(the)h(FitsChan)g
+(for)f(ASTW)-9 b(ARN)227 4061 y(cards)24 b(\(using)h(astFindFits\))h
+(after)f(the)g(call)g(to)g(astRead)f(or)g(astW)-7 b(rite)25
+b(has)f(b)r(een)i(p)r(erformed,)f(and)g(rep)r(ort)f(the)227
+4161 y(text)35 b(of)f(an)n(y)g(suc)n(h)g(cards)f(to)h(the)h(user.)56
+b(ASTW)-9 b(ARN)36 b(cards)d(will)i(b)r(e)f(propagated)f(to)h(an)n(y)g
+(output)g(header)227 4260 y(unless)28 b(they)f(are)g(deleted)h(from)f
+(the)h(FitsChan)g(using)f(astDelFits.)0 4438 y Fd(T)m(yp)s(e:)227
+4537 y Fi(String)0 4715 y Fd(Class)k(Applicabilit)m(y:)259
+4879 y(FitsChan)427 4978 y Fi(All)d(FitsChans)g(ha)n(v)n(e)e(this)i
+(attribute.)0 5168 y Fd(Notes:)227 5314 y Fi(This)36
b(attribute)g(only)g(con)n(trols)e(the)j(w)n(arnings)d(that)i(are)f(to)
h(b)r(e)g(stored)f(as)h(a)f(set)h(of)g(header)f(cards)g(in)h(the)227
-4299 y(FitsChan)d(as)f(describ)r(ed)g(ab)r(o)n(v)n(e.)51
+5414 y(FitsChan)d(as)f(describ)r(ed)g(ab)r(o)n(v)n(e.)51
b(It)33 b(has)f(no)g(e\013ect)h(on)g(the)g(storage)d(of)j(w)n(arnings)e
-(in)i(the)g(paren)n(t)f(Channel)227 4398 y(structure.)i(All)19
+(in)i(the)g(paren)n(t)f(Channel)227 5514 y(structure.)i(All)19
b(w)n(arnings)e(are)h(stored)g(in)h(the)g(paren)n(t)f(Channel)h
(structure,)h(from)f(where)f(they)h(can)g(b)r(e)g(retriev)n(ed)227
-4498 y(using)28 b(the)f(astW)-7 b(arnings)27 b(function.)p
-0 4693 V 0 4832 a Fz(WcsAxis\(lonlat\))1196 4824 y Fe(FITS-W)m(CS)39
-b(pro)7 b(jection)36 b(axes)2826 4832 y Fz(WcsAxis\(lonlat\))0
-5023 y Fd(Description:)44 b Fi(This)21 b(attribute)g(giv)n(es)e(the)i
+5613 y(using)28 b(the)f(astW)-7 b(arnings)27 b(function.)p
+eop end
+%%Page: 518 528
+TeXDict begin 518 527 bop 0 52 a FF(518)1994 b Fy(C)91
+b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
+3780 12 v 0 490 a Fz(WcsAxis\(lonlat\))1196 482 y Fe(FITS-W)m(CS)39
+b(pro)7 b(jection)36 b(axes)2826 490 y Fz(WcsAxis\(lonlat\))0
+678 y Fd(Description:)44 b Fi(This)21 b(attribute)g(giv)n(es)e(the)i
(indices)g(of)g(the)g(longitude)f(and)h(latitude)g(co)r(ordinates)e(of)
-h(the)h(FITS-W)n(CS)227 5123 y(pro)5 b(jection)33 b(within)i(the)g(co)r
+h(the)h(FITS-W)n(CS)227 777 y(pro)5 b(jection)33 b(within)i(the)g(co)r
(ordinate)e(space)g(used)h(b)n(y)g(a)f(WcsMap.)57 b(These)33
-b(indices)h(are)f(de\014ned)i(when)f(the)227 5223 y(WcsMap)28
+b(indices)h(are)f(de\014ned)i(when)f(the)227 877 y(WcsMap)28
b(is)f(\014rst)g(created)g(using)h(astWcsMap)e(and)i(cannot)f
-(subsequen)n(tly)g(b)r(e)h(altered.)227 5346 y(If)j Ft(")p
+(subsequen)n(tly)g(b)r(e)h(altered.)227 1000 y(If)j Ft(")p
Fi(lonlat)p Ft(")d Fi(is)i(1,)g(the)h(index)f(of)g(the)g(longitude)g
(axis)f(is)h(returned.)43 b(Otherwise,)30 b(if)h(it)f(is)g(2,)g(the)g
-(index)g(of)g(the)227 5446 y(latitude)e(axis)f(is)h(returned.)0
-5593 y Fd(T)m(yp)s(e:)227 5693 y Fi(In)n(teger,)f(read-only)-7
-b(.)p eop end
-%%Page: 517 527
-TeXDict begin 517 526 bop 3643 52 a FF(517)0 351 y Fd(Class)31
-b(Applicabilit)m(y:)259 481 y(WcsMap)427 580 y Fi(All)d(WcsMaps)f(ha)n
-(v)n(e)g(this)h(attribute.)p 0 766 3780 12 v 0 897 a
-Fz(WcsT)l(yp)t(e)1193 896 y Fe(FITS-W)m(CS)39 b(pro)7
-b(jection)36 b(t)m(yp)s(e)3227 897 y Fz(WcsT)l(yp)t(e)0
-1072 y Fd(Description:)44 b Fi(This)29 b(attribute)g(sp)r(eci\014es)g
+(index)g(of)g(the)227 1099 y(latitude)e(axis)f(is)h(returned.)0
+1245 y Fd(T)m(yp)s(e:)227 1345 y Fi(In)n(teger,)f(read-only)-7
+b(.)0 1491 y Fd(Class)31 b(Applicabilit)m(y:)259 1624
+y(WcsMap)427 1723 y Fi(All)d(WcsMaps)f(ha)n(v)n(e)g(this)h(attribute.)p
+0 1915 V 0 2046 a Fz(WcsT)l(yp)t(e)640 b Fe(FITS-W)m(CS)39
+b(pro)7 b(jection)36 b(t)m(yp)s(e)640 b Fz(WcsT)l(yp)t(e)0
+2228 y Fd(Description:)44 b Fi(This)29 b(attribute)g(sp)r(eci\014es)g
(whic)n(h)g(t)n(yp)r(e)g(of)f(FITS-W)n(CS)h(pro)5 b(jection)28
-b(will)h(b)r(e)g(p)r(erformed)g(b)n(y)f(a)h(Wc-)227 1171
+b(will)h(b)r(e)g(p)r(erformed)g(b)n(y)f(a)h(Wc-)227 2327
y(sMap.)36 b(The)27 b(v)-5 b(alue)27 b(is)g(sp)r(eci\014ed)g(when)g(a)f
(WcsMap)h(is)f(\014rst)h(created)f(using)g(astWcsMap)g(and)h(cannot)f
-(subse-)227 1271 y(quen)n(tly)i(b)r(e)g(c)n(hanged.)227
-1392 y(The)g(v)-5 b(alues)27 b(used)g(are)f(represen)n(ted)g(b)n(y)h
+(subse-)227 2427 y(quen)n(tly)i(b)r(e)g(c)n(hanged.)227
+2550 y(The)g(v)-5 b(alues)27 b(used)g(are)f(represen)n(ted)g(b)n(y)h
(macros)f(with)i(names)f(of)g(the)h(form)f Ft(")p Fi(AST)p
Ft(__)p Fi(XXX)p Ft(")p Fi(,)g(where)g Ft(")p Fi(XXX)p
-Ft(")227 1492 y Fi(is)32 b(the)h(\(upp)r(er)f(case\))g(3-c)n(haracter)d
+Ft(")227 2649 y Fi(is)32 b(the)h(\(upp)r(er)f(case\))g(3-c)n(haracter)d
(co)r(de)j(used)g(b)n(y)f(the)i(FITS-W)n(CS)f Ft(")p
Fi(CTYPEi)p Ft(")f Fi(k)n(eyw)n(ord)f(to)i(iden)n(tify)g(the)227
-1591 y(pro)5 b(jection.)77 b(F)-7 b(or)41 b(example,)k(p)r(ossible)c(v)
+2749 y(pro)5 b(jection.)77 b(F)-7 b(or)41 b(example,)k(p)r(ossible)c(v)
-5 b(alues)40 b(are)h(AST)p Ft(__)p Fi(T)-7 b(AN)41 b(\(for)g(the)h
-(tangen)n(t)f(plane)g(or)g(gnomonic)227 1691 y(pro)5
+(tangen)n(t)f(plane)g(or)g(gnomonic)227 2849 y(pro)5
b(jection\))34 b(and)h(AST)p Ft(__)p Fi(AIT)f(\(for)g(the)h
(Hammer-Aito\013)g(pro)5 b(jection\).)57 b(AST)p Ft(__)p
-Fi(TPN)34 b(is)h(an)f(exception)g(in)227 1791 y(that)g(it)h(is)e(not)h
+Fi(TPN)34 b(is)h(an)f(exception)g(in)227 2948 y(that)g(it)h(is)e(not)h
(part)g(of)f(the)i(FITS-W)n(CS)e(standard)g(\(it)i(represen)n(ts)d(a)i
(T)-7 b(AN)34 b(pro)5 b(jection)33 b(with)h(p)r(olynomial)227
-1890 y(correction)26 b(terms)h(as)g(de\014ned)h(in)g(an)g(early)e
-(draft)i(of)f(the)h(FITS-W)n(CS)g(pap)r(er\).)0 2033
-y Fd(T)m(yp)s(e:)227 2133 y Fi(In)n(teger,)f(read-only)-7
-b(.)0 2275 y Fd(Class)31 b(Applicabilit)m(y:)259 2405
-y(WcsMap)427 2504 y Fi(All)d(WcsMaps)f(ha)n(v)n(e)g(this)h(attribute.)0
-2659 y Fd(Notes:)340 2935 y Fh(\017)45 b Fi(F)-7 b(or)27
+3048 y(correction)26 b(terms)h(as)g(de\014ned)h(in)g(an)g(early)e
+(draft)i(of)f(the)h(FITS-W)n(CS)g(pap)r(er\).)0 3194
+y Fd(T)m(yp)s(e:)227 3293 y Fi(In)n(teger,)f(read-only)-7
+b(.)0 3439 y Fd(Class)31 b(Applicabilit)m(y:)259 3572
+y(WcsMap)427 3672 y Fi(All)d(WcsMaps)f(ha)n(v)n(e)g(this)h(attribute.)0
+3830 y Fd(Notes:)340 4109 y Fh(\017)45 b Fi(F)-7 b(or)27
b(a)g(list)h(of)g(a)n(v)-5 b(ailable)26 b(pro)5 b(jections,)27
-b(see)g(the)h(FITS-W)n(CS)f(pap)r(er.)p 0 3121 V 0 3259
-a Fz(Width\(elemen)l(t\))1131 3252 y Fe(Line)38 b(width)g(for)g(a)g
-(Plot)g(elemen)m(t)2840 3259 y Fz(Width\(elemen)l(t\))0
-3441 y Fd(Description:)44 b Fi(This)35 b(attribute)g(determines)g(the)h
+b(see)g(the)h(FITS-W)n(CS)f(pap)r(er.)p 0 4301 V 0 4439
+a Fz(Width\(elemen)l(t\))1131 4432 y Fe(Line)38 b(width)g(for)g(a)g
+(Plot)g(elemen)m(t)2840 4439 y Fz(Width\(elemen)l(t\))0
+4627 y Fd(Description:)44 b Fi(This)35 b(attribute)g(determines)g(the)h
(line)f(width)g(used)g(when)g(dra)n(wing)f(eac)n(h)g(elemen)n(t)h(of)g
-(graphical)227 3540 y(output)40 b(pro)r(duced)g(b)n(y)f(a)h(Plot.)72
+(graphical)227 4727 y(output)40 b(pro)r(duced)g(b)n(y)f(a)h(Plot.)72
b(It)40 b(tak)n(es)f(a)g(separate)f(v)-5 b(alue)40 b(for)f(eac)n(h)g
-(graphical)f(elemen)n(t)i(so)f(that,)k(for)227 3640 y(instance,)28
+(graphical)f(elemen)n(t)i(so)f(that,)k(for)227 4827 y(instance,)28
b(the)h(setting)f Ft(")p Fi(Width\(b)r(order\)=2.0)p
Ft(")f Fi(causes)g(the)h(Plot)g(b)r(order)f(to)h(b)r(e)h(dra)n(wn)e
-(using)h(a)g(line)g(width)227 3740 y(of)g(2.0.)37 b(A)28
+(using)h(a)g(line)g(width)227 4926 y(of)g(2.0.)37 b(A)28
b(v)-5 b(alue)28 b(of)f(1.0)g(results)h(in)g(a)f(line)h(thic)n(kness)f
(whic)n(h)h(is)g(appro)n(ximately)e(0.0005)f(times)k(the)f(length)g(of)
-227 3839 y(the)g(diagonal)e(of)i(the)g(en)n(tire)f(displa)n(y)g
-(surface.)227 3960 y(The)d(actual)f(app)r(earance)g(of)g(lines)h(dra)n
+227 5026 y(the)g(diagonal)e(of)i(the)g(en)n(tire)f(displa)n(y)g
+(surface.)227 5149 y(The)d(actual)f(app)r(earance)g(of)g(lines)h(dra)n
(wn)f(with)h(an)n(y)f(particular)g(width,)i(and)e(the)i(range)d(of)i(a)
-n(v)-5 b(ailable)22 b(widths,)227 4060 y(is)e(determined)g(b)n(y)f(the)
+n(v)-5 b(ailable)22 b(widths,)227 5248 y(is)e(determined)g(b)n(y)f(the)
h(underlying)g(graphics)e(system.)34 b(The)20 b(default)g(b)r(eha)n
(viour)e(is)i(for)f(all)h(graphical)e(elemen)n(ts)227
-4160 y(to)23 b(b)r(e)h(dra)n(wn)e(using)h(the)h(default)g(line)f(width)
+5348 y(to)23 b(b)r(e)h(dra)n(wn)e(using)h(the)h(default)g(line)f(width)
h(supplied)g(b)n(y)f(this)g(graphics)f(system.)35 b(This)23
-b(will)h(not)f(necessarily)227 4259 y(corresp)r(ond)j(to)i(a)f(Width)h
-(v)-5 b(alue)28 b(of)g(1.0.)0 4402 y Fd(T)m(yp)s(e:)227
-4502 y Fi(Floating)f(p)r(oin)n(t.)0 4644 y Fd(Class)k(Applicabilit)m
-(y:)259 4774 y(Plot)427 4873 y Fi(All)d(Plots)f(ha)n(v)n(e)g(this)g
-(attribute.)0 5028 y Fd(Notes:)340 5304 y Fh(\017)45
+b(will)h(not)f(necessarily)227 5448 y(corresp)r(ond)j(to)i(a)f(Width)h
+(v)-5 b(alue)28 b(of)g(1.0.)0 5593 y Fd(T)m(yp)s(e:)227
+5693 y Fi(Floating)f(p)r(oin)n(t.)p eop end
+%%Page: 519 529
+TeXDict begin 519 528 bop 3643 52 a FF(519)0 351 y Fd(Class)31
+b(Applicabilit)m(y:)259 494 y(Plot)427 593 y Fi(All)d(Plots)f(ha)n(v)n
+(e)g(this)g(attribute.)0 761 y Fd(Notes:)340 1050 y Fh(\017)45
b Fi(F)-7 b(or)27 b(a)g(list)h(of)g(the)g(graphical)e(elemen)n(ts)h(a)n
(v)-5 b(ailable,)27 b(see)g(the)h(description)f(of)g(the)h(Plot)f
-(class.)340 5430 y Fh(\017)45 b Fi(If)26 b(no)f(graphical)e(elemen)n(t)
+(class.)340 1186 y Fh(\017)45 b Fi(If)26 b(no)f(graphical)e(elemen)n(t)
i(is)g(sp)r(eci\014ed,)h(\(e.g.)36 b Ft(")p Fi(Width)p
Ft(")25 b Fi(instead)g(of)g Ft(")p Fi(Width\(b)r(order\))p
-Ft(")p Fi(\),)h(then)g(a)e Ft(")p Fi(set)p Ft(")427 5530
+Ft(")p Fi(\),)h(then)g(a)e Ft(")p Fi(set)p Ft(")427 1285
y Fi(or)i Ft(")p Fi(clear)p Ft(")f Fi(op)r(eration)h(will)g(a\013ect)h
(the)g(attribute)g(v)-5 b(alue)27 b(of)f(all)h(graphical)e(elemen)n
-(ts,)i(while)g(a)f Ft(")p Fi(get)p Ft(")f Fi(or)427 5629
+(ts,)i(while)g(a)f Ft(")p Fi(get)p Ft(")f Fi(or)427 1385
y Ft(")p Fi(test)p Ft(")i Fi(op)r(eration)g(will)h(use)f(just)h(the)g
-(Width\(Border\))g(v)-5 b(alue.)p eop end
-%%Page: 518 528
-TeXDict begin 518 527 bop 0 52 a FF(518)1994 b Fy(C)91
-b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
-3780 12 v 0 483 a Fz(XmlF)-11 b(ormat)207 b Fe(System)38
-b(for)g(formatting)d(Ob)7 b(jects)38 b(as)h(XML)207 b
-Fz(XmlF)-11 b(ormat)0 669 y Fd(Description:)44 b Fi(This)29
-b(attribute)h(sp)r(eci\014es)f(the)g(formatting)g(system)g(to)g(use)g
-(when)g(AST)g(Ob)5 b(jects)29 b(are)f(written)i(out)227
-768 y(as)j(XML)i(through)e(an)g(XmlChan.)56 b(It)34 b(a\013ects)g(the)g
-(b)r(eha)n(viour)f(of)g(the)i(astW)-7 b(rite)33 b(function)i(when)f
-(they)g(are)227 868 y(used)28 b(to)f(transfer)g(an)n(y)g(AST)h(Ob)5
-b(ject)27 b(to)h(or)e(from)i(an)f(external)g(XML)h(represen)n(tation.)
-227 992 y(The)36 b(XmlChan)h(class)e(allo)n(ws)g(AST)h(ob)5
-b(jects)36 b(to)g(b)r(e)g(represen)n(ted)f(in)i(the)f(form)g(of)g(XML)g
-(in)h(sev)n(eral)d(w)n(a)n(ys)227 1091 y(\(con)n(v)n(en)n(tions\))27
+(Width\(Border\))g(v)-5 b(alue.)p 0 1590 3780 12 v 0
+1722 a Fz(XmlF)-11 b(ormat)207 b Fe(System)38 b(for)g(formatting)d(Ob)7
+b(jects)38 b(as)h(XML)207 b Fz(XmlF)-11 b(ormat)0 1917
+y Fd(Description:)44 b Fi(This)29 b(attribute)h(sp)r(eci\014es)f(the)g
+(formatting)g(system)g(to)g(use)g(when)g(AST)g(Ob)5 b(jects)29
+b(are)f(written)i(out)227 2016 y(as)j(XML)i(through)e(an)g(XmlChan.)56
+b(It)34 b(a\013ects)g(the)g(b)r(eha)n(viour)f(of)g(the)i(astW)-7
+b(rite)33 b(function)i(when)f(they)g(are)227 2116 y(used)28
+b(to)f(transfer)g(an)n(y)g(AST)h(Ob)5 b(ject)27 b(to)h(or)e(from)i(an)f
+(external)g(XML)h(represen)n(tation.)227 2243 y(The)36
+b(XmlChan)h(class)e(allo)n(ws)g(AST)h(ob)5 b(jects)36
+b(to)g(b)r(e)g(represen)n(ted)f(in)i(the)f(form)g(of)g(XML)g(in)h(sev)n
+(eral)d(w)n(a)n(ys)227 2343 y(\(con)n(v)n(en)n(tions\))27
b(and)g(the)i(XmlF)-7 b(ormat)27 b(attribute)h(is)g(used)g(to)f(sp)r
(ecify)h(whic)n(h)g(of)g(these)f(should)h(b)r(e)g(used.)38
-b(The)227 1191 y(formatting)27 b(options)g(a)n(v)-5 b(ailable)27
+b(The)227 2443 y(formatting)27 b(options)g(a)n(v)-5 b(ailable)27
b(are)f(outlined)i(in)g(the)g Ft(")p Fi(F)-7 b(ormats)26
b(Av)-5 b(ailable)p Ft(")27 b Fi(section)g(b)r(elo)n(w.)227
-1315 y(By)35 b(default,)h(an)f(XmlChan)f(will)h(attempt)g(to)g
+2570 y(By)35 b(default,)h(an)f(XmlChan)f(will)h(attempt)g(to)g
(determine)f(whic)n(h)h(format)f(system)g(is)h(already)e(in)i(use,)h
-(and)227 1415 y(will)f(set)f(the)g(default)h(XmlF)-7
+(and)227 2670 y(will)f(set)f(the)g(default)h(XmlF)-7
b(ormat)34 b(v)-5 b(alue)34 b(accordingly)e(\(so)h(that)i(subsequen)n
-(t)f(I/O)f(op)r(erations)g(adopt)g(the)227 1514 y(same)26
+(t)f(I/O)f(op)r(erations)g(adopt)g(the)227 2769 y(same)26
b(con)n(v)n(en)n(tions\).)36 b(It)27 b(do)r(es)f(this)h(b)n(y)g(lo)r
(oking)e(for)i(certain)f(critical)g(items)h(whic)n(h)f(only)h(o)r(ccur)
-f(in)h(particular)227 1614 y(formats.)42 b(F)-7 b(or)29
+f(in)h(particular)227 2869 y(formats.)42 b(F)-7 b(or)29
b(details)h(of)f(ho)n(w)g(this)h(w)n(orks,)e(see)i(the)g
Ft(")p Fi(Choice)e(of)i(Default)g(F)-7 b(ormat)p Ft(")29
-b Fi(section)g(b)r(elo)n(w.)42 b(If)30 b(y)n(ou)227 1713
+b Fi(section)g(b)r(elo)n(w.)42 b(If)30 b(y)n(ou)227 2969
y(wish)h(to)g(ensure)f(that)h(a)f(particular)g(format)g(system)g(is)h
(used,)h(indep)r(enden)n(tly)f(of)g(an)n(y)f(XML)h(already)e(read,)227
-1813 y(y)n(ou)e(should)g(set)h(an)f(explicit)h(XmlF)-7
-b(ormat)28 b(v)-5 b(alue)27 b(y)n(ourself.)0 1961 y Fd(T)m(yp)s(e:)227
-2061 y Fi(String.)0 2209 y Fd(Class)k(Applicabilit)m(y:)259
-2343 y(XmlChan)427 2443 y Fi(All)d(XmlChans)g(ha)n(v)n(e)e(this)i
-(attribute.)-2 2604 y Fd(F)-8 b(ormats)32 b(Av)-5 b(ailable)n(:)227
-2750 y Fi(The)34 b(XmlF)-7 b(ormat)33 b(attribute)h(can)f(tak)n(e)f(an)
+3068 y(y)n(ou)e(should)g(set)h(an)f(explicit)h(XmlF)-7
+b(ormat)28 b(v)-5 b(alue)27 b(y)n(ourself.)0 3224 y Fd(T)m(yp)s(e:)227
+3323 y Fi(String.)0 3479 y Fd(Class)k(Applicabilit)m(y:)259
+3621 y(XmlChan)427 3721 y Fi(All)d(XmlChans)g(ha)n(v)n(e)e(this)i
+(attribute.)-2 3889 y Fd(F)-8 b(ormats)32 b(Av)-5 b(ailable)n(:)227
+4035 y Fi(The)34 b(XmlF)-7 b(ormat)33 b(attribute)h(can)f(tak)n(e)f(an)
n(y)h(of)g(the)h(follo)n(wing)f(\(case)f(insensitiv)n(e\))i(string)e(v)
--5 b(alues)33 b(to)h(select)227 2849 y(the)28 b(corresp)r(onding)e
-(formatting)h(system:)340 3108 y Fh(\017)45 b Ft(")p
+-5 b(alues)33 b(to)h(select)227 4134 y(the)28 b(corresp)r(onding)e
+(formatting)h(system:)340 4404 y Fh(\017)45 b Ft(")p
Fi(NA)-7 b(TIVE)p Ft(")p Fi(:)34 b(This)23 b(is)g(a)f(direct)h(con)n(v)
n(ersion)e(to)h(XML)i(of)e(the)i(heirarc)n(hical)c(format)j(used)g(b)n
-(y)f(a)h(standard)427 3208 y(XML)28 b(c)n(hannel)f(\(and)h(also)f(b)n
+(y)f(a)h(standard)427 4504 y(XML)28 b(c)n(hannel)f(\(and)h(also)f(b)n
(y)g(the)h(NA)-7 b(TIVE)28 b(enco)r(ding)f(of)h(a)f(FitsChan\).)340
-3339 y Fh(\017)45 b Ft(")p Fi(QUOTED)p Ft(")p Fi(:)35
+4640 y Fh(\017)45 b Ft(")p Fi(QUOTED)p Ft(")p Fi(:)35
b(This)27 b(is)g(the)g(same)f(as)h(NA)-7 b(TIVE)27 b(format)f(except)h
-(that)g(extra)f(information)g(is)h(included)427 3439
+(that)g(extra)f(information)g(is)h(included)427 4739
y(whic)n(h)21 b(allo)n(ws)e(clien)n(t)i(co)r(de)g(to)f(con)n(v)n(ert)f
(the)j(XML)f(in)n(to)f(a)g(form)h(whic)n(h)f(can)h(b)r(e)g(read)f(b)n
-(y)g(a)g(standard)g(AST)427 3538 y(Channel.)37 b(This)26
+(y)g(a)g(standard)g(AST)427 4839 y(Channel.)37 b(This)26
b(extra)g(information)f(indicates)i(whic)n(h)f(AST)h(attribute)f(v)-5
-b(alues)27 b(should)f(b)r(e)h(enclosed)e(in)427 3638
+b(alues)27 b(should)f(b)r(e)h(enclosed)e(in)427 4939
y(quotes)i(b)r(efore)h(b)r(eing)f(passed)g(to)h(a)f(Channel.)340
-3769 y Fh(\017)45 b Ft(")p Fi(IV)n(O)n(A)p Ft(")p Fi(:)63
+5074 y Fh(\017)45 b Ft(")p Fi(IV)n(O)n(A)p Ft(")p Fi(:)63
b(This)40 b(is)h(a)g(format)f(that)h(uses)g(an)g(early)e(draft)i(of)g
(the)g(STC-X)g(sc)n(hema)f(dev)n(elop)r(ed)h(b)n(y)427
-3869 y(the)30 b(In)n(ternational)e(Virtual)h(Observ)-5
+5174 y(the)30 b(In)n(ternational)e(Virtual)h(Observ)-5
b(atory)27 b(Alliance)i(\(IV)n(O)n(A)g(-)g(see)g Ft(")p
Fi(h)n(ttp://www.iv)n(oa.net/)p Ft(")p Fi(\))e(to)i(de-)427
-3968 y(scrib)r(e)38 b(co)r(ordinate)f(systems,)j(regions,)f(mappings,)h
+5274 y(scrib)r(e)38 b(co)r(ordinate)f(systems,)j(regions,)f(mappings,)h
(etc.)68 b(Supp)r(ort)38 b(is)g(limited)g(to)g(V1.20)f(describ)r(ed)427
-4068 y(at)d Ft(")p Fi(h)n(ttp://www.iv)n(oa.net/Do)r(cumen)n
+5373 y(at)d Ft(")p Fi(h)n(ttp://www.iv)n(oa.net/Do)r(cumen)n
(ts/WD/STC/STC-2005022)o(5.h)n(tml)p Ft(")p Fi(.)49 b(Since)34
-b(the)g(v)n(ersion)e(of)427 4168 y(STC-X)i(\014nally)f(adopted)g(b)n(y)
+b(the)g(v)n(ersion)e(of)427 5473 y(STC-X)i(\014nally)f(adopted)g(b)n(y)
h(the)f(IV)n(O)n(A)g(di\013ers)h(in)g(sev)n(eral)d(signi\014can)n(t)i
-(resp)r(ects)g(from)g(V1.20,)h(this)427 4267 y(format)27
+(resp)r(ects)g(from)g(V1.20,)h(this)427 5573 y(format)27
b(is)g(no)n(w)f(mainly)h(of)g(historical)f(in)n(terest.)37
b(Note,)27 b(the)g(alternativ)n(e)f Ft(")p Fi(STC-S)p
-Ft(")g Fi(format)h(\(a)g(simpler)427 4367 y(non-XML)h(enco)r(ding)f(of)
+Ft(")g Fi(format)h(\(a)g(simpler)427 5672 y(non-XML)h(enco)r(ding)f(of)
g(the)h(STC)g(metadata\))f(is)h(supp)r(orted)f(b)n(y)h(the)g(StcsChan)f
-(class.)-2 4527 y Fd(Choice)32 b(of)f(Default)h(F)-8
-b(ormat;)n(:)227 4673 y Fi(If)30 b(the)f(XmlF)-7 b(ormat)29
-b(attribute)g(of)g(an)f(XmlChan)h(is)g(not)g(set,)g(the)h(default)f(v)
--5 b(alue)29 b(it)g(tak)n(es)f(is)h(determined)g(b)n(y)227
-4773 y(the)g(presence)e(of)h(certain)f(critical)h(items)g(within)h(the)
-f(do)r(cumen)n(t)h(most)f(recen)n(tly)f(read)g(using)h(astRead.)38
-b(The)227 4873 y(sequence)27 b(of)h(decision)f(used)h(to)f(arriv)n(e)f
-(at)h(the)h(default)g(v)-5 b(alue)28 b(is)f(as)g(follo)n(ws:)340
-5131 y Fh(\017)45 b Fi(If)19 b(the)g(previous)e(do)r(cumen)n(t)i(read)e
-(con)n(tained)h(an)n(y)f(elemen)n(ts)i(in)f(an)n(y)g(of)g(the)h(STC)f
-(namespaces)g(\()p Ft(")p Fi(urn:n)n(v)n(o-)427 5231
-y(stc)p Ft(")p Fi(,)28 b Ft(")p Fi(urn:n)n(v)n(o-co)r(ords)p
-Ft(")23 b Fi(or)k Ft(")p Fi(urn:n)n(v)n(o-region)p Ft(")p
-Fi(\),)d(then)k(the)g(default)g(v)-5 b(alue)28 b(is)f(IV)n(O)n(A.)340
-5362 y Fh(\017)45 b Fi(If)30 b(the)f(previous)f(do)r(cumen)n(t)h(read)f
-(con)n(tained)g(an)n(y)g(elemen)n(ts)h(in)g(the)g(AST)g(namespace)f
-(whic)n(h)h(had)g(an)427 5462 y(asso)r(ciated)e(XML)g(attribute)h
-(called)f Ft(")p Fi(quoted)p Ft(")p Fi(,)g(then)h(the)g(default)g(v)-5
-b(alue)28 b(is)f(QUOTED.)340 5593 y Fh(\017)45 b Fi(Otherwise,)31
+(class.)p eop end
+%%Page: 520 530
+TeXDict begin 520 529 bop 0 52 a FF(520)1994 b Fy(C)91
+b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)-2 351 y
+Fd(Choice)h(of)f(Default)h(F)-8 b(ormat;)n(:)227 497
+y Fi(If)30 b(the)f(XmlF)-7 b(ormat)29 b(attribute)g(of)g(an)f(XmlChan)h
+(is)g(not)g(set,)g(the)h(default)f(v)-5 b(alue)29 b(it)g(tak)n(es)f(is)
+h(determined)g(b)n(y)227 597 y(the)g(presence)e(of)h(certain)f
+(critical)h(items)g(within)h(the)f(do)r(cumen)n(t)h(most)f(recen)n(tly)
+f(read)g(using)h(astRead.)38 b(The)227 697 y(sequence)27
+b(of)h(decision)f(used)h(to)f(arriv)n(e)f(at)h(the)h(default)g(v)-5
+b(alue)28 b(is)f(as)g(follo)n(ws:)340 955 y Fh(\017)45
+b Fi(If)19 b(the)g(previous)e(do)r(cumen)n(t)i(read)e(con)n(tained)h
+(an)n(y)f(elemen)n(ts)i(in)f(an)n(y)g(of)g(the)h(STC)f(namespaces)g(\()
+p Ft(")p Fi(urn:n)n(v)n(o-)427 1055 y(stc)p Ft(")p Fi(,)28
+b Ft(")p Fi(urn:n)n(v)n(o-co)r(ords)p Ft(")23 b Fi(or)k
+Ft(")p Fi(urn:n)n(v)n(o-region)p Ft(")p Fi(\),)d(then)k(the)g(default)g
+(v)-5 b(alue)28 b(is)f(IV)n(O)n(A.)340 1186 y Fh(\017)45
+b Fi(If)30 b(the)f(previous)f(do)r(cumen)n(t)h(read)f(con)n(tained)g
+(an)n(y)g(elemen)n(ts)h(in)g(the)g(AST)g(namespace)f(whic)n(h)h(had)g
+(an)427 1286 y(asso)r(ciated)e(XML)g(attribute)h(called)f
+Ft(")p Fi(quoted)p Ft(")p Fi(,)g(then)h(the)g(default)g(v)-5
+b(alue)28 b(is)f(QUOTED.)340 1418 y Fh(\017)45 b Fi(Otherwise,)31
b(if)g(none)g(of)f(these)h(conditions)f(is)h(met)g(\(as)f(w)n(ould)h(b)
r(e)g(the)g(case)f(if)h(no)f(do)r(cumen)n(t)h(had)g(y)n(et)427
-5693 y(b)r(een)d(read\),)f(then)h(NA)-7 b(TIVE)28 b(format)g(is)f
-(used.)p eop end
-%%Page: 519 529
-TeXDict begin 519 528 bop 3643 52 a FF(519)227 351 y
-Fi(Setting)28 b(an)g(explicit)f(v)-5 b(alue)28 b(for)f(the)h(XmlF)-7
-b(ormat)27 b(attribute)h(alw)n(a)n(ys)e(o)n(v)n(er-rides)f(this)j
-(default)g(b)r(eha)n(viour.)-2 516 y Fd(The)k(IV)m(O)m(A)h(F)-8
-b(ormat)n(:)227 662 y Fi(The)39 b(IV)n(O)n(A)g(supp)r(ort)g(caters)f
-(only)h(for)f(certain)h(parts)f(of)h(V1.20)g(of)g(the)g(draft)g
-(Space-Time)g(Co)r(ordinate)227 762 y(\(STC\))33 b(sc)n(hema)f(\(see)h
-(h)n(ttp://www.iv)n(oa.net/Do)r(cumen)n(ts/WD/STC/STC-2005022)o(5.h)n
-(tml\).)46 b(Note,)34 b(this)227 861 y(draft)f(has)g(no)n(w)f(b)r(een)i
-(sup)r(erceded)f(b)n(y)g(an)g(o\016cially)f(adopted)h(v)n(ersion)e
-(that)j(di\013ers)f(in)g(sev)n(eral)e(signi\014can)n(t)227
-961 y(resp)r(ects)c(from)h(V1.20.)35 b(Consequen)n(tly)-7
-b(,)27 b(the)h Ft(")p Fi(IV)n(O)n(A)p Ft(")f Fi(XmlChan)h(format)f(is)g
-(of)h(historical)e(in)n(terest)h(only)-7 b(.)227 1093
-y(The)30 b(follo)n(wing)f(p)r(oin)n(ts)h(should)f(b)r(e)h(noted)g(when)
-g(using)g(an)f(XmlChan)h(to)g(read)f(or)g(write)g(STC)h(information)227
-1192 y(\(note,)e(this)g(list)g(is)f(curren)n(tly)g(incomplete\):)340
-1476 y Fh(\017)45 b Fi(Ob)5 b(jects)27 b(can)h(curren)n(tly)e(only)h(b)
-r(e)h(read)f(using)g(this)h(format,)f(not)h(written.)340
-1616 y Fh(\017)45 b Fi(The)23 b(AST)f(ob)5 b(ject)22
-b(generated)f(b)n(y)h(reading)f(an)h Fk(<)p Fi(STCMetadata)p
-Fk(>)f Fi(elemen)n(t)h(will)g(b)r(e)h(an)f(instance)g(of)g(one)427
-1716 y(of)27 b(the)h(AST)g Ft(")p Fi(Stc)p Ft(")f Fi(classes:)35
-b(StcResourcePro\014le,)25 b(StcSearc)n(hLo)r(cation,)h(StcCatalogEn)n
-(tryLo)r(cation,)427 1816 y(StcObsDataLo)r(cation.)340
-1956 y Fh(\017)45 b Fi(When)27 b(reading)f(an)g Fk(<)p
-Fi(STCMetadata)p Fk(>)f Fi(elemen)n(t,)i(the)g(axes)f(in)h(the)g
-(returned)f(AST)h(Ob)5 b(ject)26 b(will)h(b)r(e)g(in)427
-2056 y(the)j(order)e(space,)g(time,)j(sp)r(ectral,)e(redshift,)g
-(irresp)r(ectiv)n(e)f(of)h(the)h(order)e(in)h(whic)n(h)g(the)h(axes)e
-(o)r(ccur)g(in)427 2155 y(the)34 b Fk(<)p Fi(STCMetadata)p
-Fk(>)e Fi(elemen)n(t.)53 b(If)34 b(the)g(supplied)f Fk(<)p
-Fi(STCMetadata)p Fk(>)f Fi(elemen)n(t)h(do)r(es)g(not)g(con)n(tain)427
-2255 y(all)h(of)h(these)f(axes,)i(the)f(returned)f(AST)h(Ob)5
-b(ject)34 b(will)h(also)e(omit)i(them,)i(but)e(the)g(ordering)e(of)h
-(those)427 2355 y(axes)h(whic)n(h)h(are)f(presen)n(t)g(will)i(b)r(e)f
-(as)f(stated)h(ab)r(o)n(v)n(e.)61 b(If)36 b(the)g(spatial)g(frame)f
-(represen)n(ts)g(a)g(celestial)427 2454 y(co)r(ordinate)27
-b(system)g(the)h(spatial)f(axes)g(will)g(b)r(e)h(in)g(the)g(order)f
-(\(longitude,)g(latitude\).)340 2595 y Fh(\017)45 b Fi(Un)n(til)25
-b(suc)n(h)g(time)g(as)f(the)h(AST)g(TimeF)-7 b(rame)24
-b(is)g(complete,)h(a)g(simple)f(1-dimensional)g(F)-7
-b(rame)24 b(\(with)h(Do-)427 2694 y(main)g(set)f(to)g(TIME\))g(will)h
-(b)r(e)g(used)f(to)g(represen)n(t)f(the)i(STC)f Fk(<)p
+1517 y(b)r(een)d(read\),)f(then)h(NA)-7 b(TIVE)28 b(format)g(is)f
+(used.)227 1678 y(Setting)h(an)g(explicit)f(v)-5 b(alue)28
+b(for)f(the)h(XmlF)-7 b(ormat)27 b(attribute)h(alw)n(a)n(ys)e(o)n(v)n
+(er-rides)f(this)j(default)g(b)r(eha)n(viour.)-2 1826
+y Fd(The)k(IV)m(O)m(A)h(F)-8 b(ormat)n(:)227 1972 y Fi(The)39
+b(IV)n(O)n(A)g(supp)r(ort)g(caters)f(only)h(for)f(certain)h(parts)f(of)
+h(V1.20)g(of)g(the)g(draft)g(Space-Time)g(Co)r(ordinate)227
+2071 y(\(STC\))33 b(sc)n(hema)f(\(see)h(h)n(ttp://www.iv)n(oa.net/Do)r
+(cumen)n(ts/WD/STC/STC-2005022)o(5.h)n(tml\).)46 b(Note,)34
+b(this)227 2171 y(draft)f(has)g(no)n(w)f(b)r(een)i(sup)r(erceded)f(b)n
+(y)g(an)g(o\016cially)f(adopted)h(v)n(ersion)e(that)j(di\013ers)f(in)g
+(sev)n(eral)e(signi\014can)n(t)227 2271 y(resp)r(ects)c(from)h(V1.20.)
+35 b(Consequen)n(tly)-7 b(,)27 b(the)h Ft(")p Fi(IV)n(O)n(A)p
+Ft(")f Fi(XmlChan)h(format)f(is)g(of)h(historical)e(in)n(terest)h(only)
+-7 b(.)227 2394 y(The)30 b(follo)n(wing)f(p)r(oin)n(ts)h(should)f(b)r
+(e)h(noted)g(when)g(using)g(an)f(XmlChan)h(to)g(read)f(or)g(write)g
+(STC)h(information)227 2494 y(\(note,)e(this)g(list)g(is)f(curren)n
+(tly)g(incomplete\):)340 2753 y Fh(\017)45 b Fi(Ob)5
+b(jects)27 b(can)h(curren)n(tly)e(only)h(b)r(e)h(read)f(using)g(this)h
+(format,)f(not)h(written.)340 2884 y Fh(\017)45 b Fi(The)23
+b(AST)f(ob)5 b(ject)22 b(generated)f(b)n(y)h(reading)f(an)h
+Fk(<)p Fi(STCMetadata)p Fk(>)f Fi(elemen)n(t)h(will)g(b)r(e)h(an)f
+(instance)g(of)g(one)427 2984 y(of)27 b(the)h(AST)g Ft(")p
+Fi(Stc)p Ft(")f Fi(classes:)35 b(StcResourcePro\014le,)25
+b(StcSearc)n(hLo)r(cation,)h(StcCatalogEn)n(tryLo)r(cation,)427
+3084 y(StcObsDataLo)r(cation.)340 3215 y Fh(\017)45 b
+Fi(When)27 b(reading)f(an)g Fk(<)p Fi(STCMetadata)p Fk(>)f
+Fi(elemen)n(t,)i(the)g(axes)f(in)h(the)g(returned)f(AST)h(Ob)5
+b(ject)26 b(will)h(b)r(e)g(in)427 3315 y(the)j(order)e(space,)g(time,)j
+(sp)r(ectral,)e(redshift,)g(irresp)r(ectiv)n(e)f(of)h(the)h(order)e(in)
+h(whic)n(h)g(the)h(axes)e(o)r(ccur)g(in)427 3414 y(the)34
+b Fk(<)p Fi(STCMetadata)p Fk(>)e Fi(elemen)n(t.)53 b(If)34
+b(the)g(supplied)f Fk(<)p Fi(STCMetadata)p Fk(>)f Fi(elemen)n(t)h(do)r
+(es)g(not)g(con)n(tain)427 3514 y(all)h(of)h(these)f(axes,)i(the)f
+(returned)f(AST)h(Ob)5 b(ject)34 b(will)h(also)e(omit)i(them,)i(but)e
+(the)g(ordering)e(of)h(those)427 3614 y(axes)h(whic)n(h)h(are)f(presen)
+n(t)g(will)i(b)r(e)f(as)f(stated)h(ab)r(o)n(v)n(e.)61
+b(If)36 b(the)g(spatial)g(frame)f(represen)n(ts)g(a)g(celestial)427
+3713 y(co)r(ordinate)27 b(system)g(the)h(spatial)f(axes)g(will)g(b)r(e)
+h(in)g(the)g(order)f(\(longitude,)g(latitude\).)340 3845
+y Fh(\017)45 b Fi(Un)n(til)25 b(suc)n(h)g(time)g(as)f(the)h(AST)g
+(TimeF)-7 b(rame)24 b(is)g(complete,)h(a)g(simple)f(1-dimensional)g(F)
+-7 b(rame)24 b(\(with)h(Do-)427 3944 y(main)g(set)f(to)g(TIME\))g(will)
+h(b)r(e)g(used)f(to)g(represen)n(t)f(the)i(STC)f Fk(<)p
Fi(TimeF)-7 b(rame)p Fk(>)23 b Fi(elemen)n(t.)36 b(Consequen)n(tly)-7
-b(,)427 2794 y(most)28 b(of)f(the)h(information)f(within)h(a)g
+b(,)427 4044 y(most)28 b(of)f(the)h(information)f(within)h(a)g
Fk(<)p Fi(TimeF)-7 b(rame)p Fk(>)26 b Fi(elemen)n(t)i(is)f(curren)n
-(tly)g(ignored.)340 2934 y Fh(\017)45 b Fk(<)p Fi(SpaceF)-7
+(tly)g(ignored.)340 4175 y Fh(\017)45 b Fk(<)p Fi(SpaceF)-7
b(rame)p Fk(>)27 b Fi(elemen)n(ts)i(can)f(only)g(b)r(e)h(read)f(if)h
(they)g(describ)r(e)g(a)f(celestial)g(longitude)h(and)f(latitude)427
-3034 y(axes)33 b(supp)r(orted)g(b)n(y)g(the)h(AST)f(SkyF)-7
+4275 y(axes)33 b(supp)r(orted)g(b)n(y)g(the)h(AST)f(SkyF)-7
b(rame)33 b(class.)53 b(The)33 b(space)g(axes)f(will)i(b)r(e)g
-(returned)f(in)g(the)h(order)427 3133 y(\(longitude,)28
-b(latitude\).)340 3274 y Fh(\017)45 b Fi(V)-7 b(elo)r(cities)28
+(returned)f(in)g(the)h(order)427 4375 y(\(longitude,)28
+b(latitude\).)340 4506 y Fh(\017)45 b Fi(V)-7 b(elo)r(cities)28
b(asso)r(ciated)e(with)i(SpaceF)-7 b(rames)27 b(cannot)g(b)r(e)h(read.)
-340 3414 y Fh(\017)45 b Fi(An)n(y)23 b Fk(<)p Fi(GenericCo)r(ordF)-7
+340 4637 y Fh(\017)45 b Fi(An)n(y)23 b Fk(<)p Fi(GenericCo)r(ordF)-7
b(rame)p Fk(>)19 b Fi(elemen)n(ts)k(within)g(an)f Fk(<)p
Fi(AstroCo)r(ordSystem)p Fk(>)e Fi(elemen)n(t)j(are)f(curren)n(tly)427
-3514 y(ignored.)340 3654 y Fh(\017)45 b Fi(An)n(y)29
+4737 y(ignored.)340 4868 y Fh(\017)45 b Fi(An)n(y)29
b(second)e(or)h(subsequen)n(t)g Fk(<)p Fi(AstroCo)r(ordSystem)p
Fk(>)e Fi(found)j(within)g(an)f(STCMetaData)g(elemen)n(t)h(is)427
-3754 y(ignored.)340 3894 y Fh(\017)45 b Fi(An)n(y)37
+4968 y(ignored.)340 5099 y Fh(\017)45 b Fi(An)n(y)37
b(second)g(or)f(subsequen)n(t)h Fk(<)p Fi(AstroCo)r(ordArea)p
Fk(>)d Fi(found)k(within)g(an)f(STCMetaData)f(elemen)n(t)i(is)427
-3994 y(ignored.)340 4134 y Fh(\017)45 b Fi(An)n(y)28
+5199 y(ignored.)340 5331 y Fh(\017)45 b Fi(An)n(y)28
b Fk(<)p Fi(O\013setCen)n(ter)p Fk(>)e Fi(found)i(within)g(a)f
Fk(<)p Fi(SpaceF)-7 b(rame)p Fk(>)26 b Fi(is)i(ignored.)340
-4275 y Fh(\017)45 b Fi(An)n(y)28 b(Co)r(ordFla)n(v)n(or)c(elemen)n(t)k
+5462 y Fh(\017)45 b Fi(An)n(y)28 b(Co)r(ordFla)n(v)n(or)c(elemen)n(t)k
(found)g(within)g(a)g Fk(<)p Fi(SpaceF)-7 b(rame)p Fk(>)25
-b Fi(is)j(ignored.)340 4415 y Fh(\017)45 b Fk(<)p Fi(SpaceF)-7
+b Fi(is)j(ignored.)340 5593 y Fh(\017)45 b Fk(<)p Fi(SpaceF)-7
b(rame)p Fk(>)23 b Fi(elemen)n(ts)h(can)g(only)f(b)r(e)i(read)e(if)i
(they)g(refer)e(to)h(one)g(of)g(the)h(follo)n(wing)e(space)h(reference)
-427 4515 y(frames:)36 b(ICRS,)28 b(GALA)n(CTIC)p Ft(_)p
+427 5693 y(frames:)36 b(ICRS,)28 b(GALA)n(CTIC)p Ft(_)p
Fi(I)r(I,)g(SUPER)p Ft(_)p Fi(GALA)n(CTIC,)f(HEE,)g(FK4,)g(FK5,)g
-(ECLIPTIC.)340 4655 y Fh(\017)45 b Fk(<)p Fi(SpaceF)-7
-b(rame)p Fk(>)25 b Fi(elemen)n(ts)h(can)g(only)g(b)r(e)h(read)f(if)h
-(the)f(reference)g(p)r(osition)g(is)g(TOPOCENTER.)f(Also,)427
-4755 y(an)n(y)i(planetary)g(ephemeris)g(is)g(ignored.)340
-4895 y Fh(\017)45 b Fi(Regions:)36 b(there)26 b(is)g(curren)n(tly)g(no)
-g(supp)r(ort)g(for)g(STC)h(regions)e(of)h(t)n(yp)r(e)h(Sector,)f(Con)n
-(v)n(exHull)f(or)h(SkyIn-)427 4995 y(dex.)340 5135 y
-Fh(\017)45 b Fi(The)34 b(AST)g(Region)e(read)h(from)g(a)g(Co)r(ordIn)n
-(terv)-5 b(al)32 b(elemen)n(t)h(is)h(considered)e(to)i(b)r(e)f(op)r(en)
-h(if)g(either)f(the)427 5235 y(lo)p Ft(_)p Fi(include)27
-b(or)g(the)h(hi)p Ft(_)p Fi(include)g(attribute)g(is)f(set)h(to)f
-(false.)340 5375 y Fh(\017)45 b Fk(<)p Fi(RegionFile)p
-Fk(>)27 b Fi(elemen)n(ts)g(are)g(not)g(supp)r(orted.)340
-5515 y Fh(\017)45 b Fi(V)-7 b(ertices)33 b(within)h Fk(<)p
-Fi(P)n(olygon)p Fk(>)c Fi(elemen)n(ts)k(are)e(alw)n(a)n(ys)f
-(considered)h(to)h(b)r(e)h(joined)g(using)e(great)g(circles)427
-5615 y(\(that)c(is,)g Fk(<)p Fi(SmallCircle)p Fk(>)e
-Fi(elemen)n(ts)i(are)e(ignored\).)p eop end
-%%Page: 520 530
-TeXDict begin 520 529 bop 0 52 a FF(520)1994 b Fy(C)91
-b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)p 0 351
-3780 12 v 0 483 a Fz(XmlLength)473 b Fe(Con)m(trols)36
-b(output)i(bu\013er)h(length)471 b Fz(XmlLength)0 672
+(ECLIPTIC.)p eop end
+%%Page: 521 531
+TeXDict begin 521 530 bop 3643 52 a FF(521)340 351 y
+Fh(\017)45 b Fk(<)p Fi(SpaceF)-7 b(rame)p Fk(>)25 b Fi(elemen)n(ts)h
+(can)g(only)g(b)r(e)h(read)f(if)h(the)f(reference)g(p)r(osition)g(is)g
+(TOPOCENTER.)f(Also,)427 451 y(an)n(y)i(planetary)g(ephemeris)g(is)g
+(ignored.)340 582 y Fh(\017)45 b Fi(Regions:)36 b(there)26
+b(is)g(curren)n(tly)g(no)g(supp)r(ort)g(for)g(STC)h(regions)e(of)h(t)n
+(yp)r(e)h(Sector,)f(Con)n(v)n(exHull)f(or)h(SkyIn-)427
+682 y(dex.)340 813 y Fh(\017)45 b Fi(The)34 b(AST)g(Region)e(read)h
+(from)g(a)g(Co)r(ordIn)n(terv)-5 b(al)32 b(elemen)n(t)h(is)h
+(considered)e(to)i(b)r(e)f(op)r(en)h(if)g(either)f(the)427
+913 y(lo)p Ft(_)p Fi(include)27 b(or)g(the)h(hi)p Ft(_)p
+Fi(include)g(attribute)g(is)f(set)h(to)f(false.)340 1044
+y Fh(\017)45 b Fk(<)p Fi(RegionFile)p Fk(>)27 b Fi(elemen)n(ts)g(are)g
+(not)g(supp)r(orted.)340 1176 y Fh(\017)45 b Fi(V)-7
+b(ertices)33 b(within)h Fk(<)p Fi(P)n(olygon)p Fk(>)c
+Fi(elemen)n(ts)k(are)e(alw)n(a)n(ys)f(considered)h(to)h(b)r(e)h(joined)
+g(using)e(great)g(circles)427 1275 y(\(that)c(is,)g Fk(<)p
+Fi(SmallCircle)p Fk(>)e Fi(elemen)n(ts)i(are)e(ignored\).)p
+0 1472 3780 12 v 0 1603 a Fz(XmlLength)473 b Fe(Con)m(trols)36
+b(output)i(bu\013er)h(length)471 b Fz(XmlLength)0 1789
y Fd(Description:)44 b Fi(This)34 b(attribute)h(sp)r(eci\014es)e(the)i
(maxim)n(um)f(length)g(to)g(use)g(when)g(writing)f(out)i(text)f
-(through)f(the)227 771 y(sink)28 b(function)g(supplied)g(when)g(the)g
-(XmlChan)f(w)n(as)g(created.)227 896 y(The)h(n)n(um)n(b)r(er)g(of)g(c)n
-(haracters)d(in)j(eac)n(h)f(string)h(written)g(out)g(through)f(the)h
-(sink)g(function)g(will)g(not)g(b)r(e)g(greater)227 996
+(through)f(the)227 1889 y(sink)28 b(function)g(supplied)g(when)g(the)g
+(XmlChan)f(w)n(as)g(created.)227 2013 y(The)h(n)n(um)n(b)r(er)g(of)g(c)
+n(haracters)d(in)j(eac)n(h)f(string)h(written)g(out)g(through)f(the)h
+(sink)g(function)g(will)g(not)g(b)r(e)g(greater)227 2112
y(than)g(the)g(v)-5 b(alue)27 b(of)h(this)g(attribute)g(\(but)g(ma)n(y)
f(b)r(e)h(less\).)37 b(A)28 b(v)-5 b(alue)27 b(of)h(zero)e(\(the)j
-(default\))f(means)f(there)g(is)h(no)227 1095 y(limit)h(-)e(eac)n(h)g
-(string)g(can)g(b)r(e)h(of)f(an)n(y)g(length.)0 1245
-y Fd(T)m(yp)s(e:)227 1344 y Fi(In)n(teger.)0 1494 y Fd(Class)k
-(Applicabilit)m(y:)259 1630 y(XmlChan)427 1730 y Fi(All)d(XmlChans)g
-(ha)n(v)n(e)e(this)i(attribute.)p 0 1929 V 0 2061 a Fz(XmlPre\014x)200
+(default\))f(means)f(there)g(is)h(no)227 2212 y(limit)h(-)e(eac)n(h)g
+(string)g(can)g(b)r(e)h(of)f(an)n(y)g(length.)0 2360
+y Fd(T)m(yp)s(e:)227 2460 y Fi(In)n(teger.)0 2608 y Fd(Class)k
+(Applicabilit)m(y:)259 2743 y(XmlChan)427 2842 y Fi(All)d(XmlChans)g
+(ha)n(v)n(e)e(this)i(attribute.)p 0 3039 V 0 3170 a Fz(XmlPre\014x)200
b Fe(The)38 b(namespace)g(pre\014x)h(to)f(use)h(when)g(writing)197
-b Fz(XmlPre\014x)0 2249 y Fd(Description:)44 b Fi(This)22
+b Fz(XmlPre\014x)0 3356 y Fd(Description:)44 b Fi(This)22
b(attribute)h(is)f(a)g(string)f(whic)n(h)h(is)g(to)g(b)r(e)h(used)f(as)
f(the)i(namespace)e(pre\014x)h(for)f(all)h(XML)h(elemen)n(ts)227
-2349 y(created)k(as)g(a)g(result)g(of)h(writing)f(an)g(AST)h(Ob)5
+3456 y(created)k(as)g(a)g(result)g(of)h(writing)f(an)g(AST)h(Ob)5
b(ject)28 b(out)f(through)g(an)g(XmlChan.)37 b(The)28
-b(URI)g(asso)r(ciated)e(with)227 2449 y(the)20 b(namespace)f(pre\014x)g
+b(URI)g(asso)r(ciated)e(with)227 3555 y(the)20 b(namespace)f(pre\014x)g
(is)g(giv)n(en)g(b)n(y)g(the)h(sym)n(b)r(olic)e(constan)n(t)h(AST)p
Ft(__)p Fi(XMLNS)h(de\014ned)g(in)f(ast.h.)34 b(A)20
-b(de\014nition)227 2548 y(of)28 b(the)g(namespace)e(pre\014x)i(is)f
+b(de\014nition)227 3655 y(of)28 b(the)g(namespace)e(pre\014x)i(is)f
(included)h(in)g(eac)n(h)f(top-lev)n(el)f(elemen)n(t)i(pro)r(duced)f(b)
-n(y)h(the)g(XmlChan.)227 2673 y(The)j(default)g(v)-5
+n(y)h(the)g(XmlChan.)227 3779 y(The)j(default)g(v)-5
b(alue)30 b(is)g(a)g(blank)h(string)e(whic)n(h)i(causes)e(no)h
(pre\014x)g(to)h(b)r(e)f(used.)46 b(In)31 b(this)f(case)g(eac)n(h)g
-(top-lev)n(el)227 2773 y(elemen)n(t)e(will)g(set)f(the)h(default)g
+(top-lev)n(el)227 3879 y(elemen)n(t)e(will)g(set)f(the)h(default)g
(namespace)f(to)g(b)r(e)h(the)g(v)-5 b(alue)28 b(of)g(AST)p
-Ft(__)p Fi(XMLNS.)0 2922 y Fd(T)m(yp)s(e:)227 3022 y
-Fi(String.)0 3171 y Fd(Class)j(Applicabilit)m(y:)259
-3307 y(Ob)5 b(ject)427 3407 y Fi(All)28 b(Ob)5 b(jects)28
-b(ha)n(v)n(e)e(this)i(attribute.)p 0 3606 V 0 3737 a
-Fz(Zo)t(om)1322 3738 y Fe(Zo)s(omMap)37 b(scale)i(factor)3447
-3737 y Fz(Zo)t(om)0 3927 y Fd(Description:)44 b Fi(This)24
+Ft(__)p Fi(XMLNS.)0 4027 y Fd(T)m(yp)s(e:)227 4126 y
+Fi(String.)0 4274 y Fd(Class)j(Applicabilit)m(y:)259
+4409 y(Ob)5 b(ject)427 4509 y Fi(All)28 b(Ob)5 b(jects)28
+b(ha)n(v)n(e)e(this)i(attribute.)p 0 4705 V 0 4836 a
+Fz(Zo)t(om)1322 4837 y Fe(Zo)s(omMap)37 b(scale)i(factor)3447
+4836 y Fz(Zo)t(om)0 5023 y Fd(Description:)44 b Fi(This)24
b(attribute)g(holds)g(the)g(Zo)r(omMap)f(scale)g(factor,)h(b)n(y)g
(whic)n(h)g(co)r(ordinate)e(v)-5 b(alues)24 b(are)f(m)n(ultiplied)227
-4026 y(\(b)n(y)g(the)h(forw)n(ard)d(transformation\))g(or)h(divided)i
+5122 y(\(b)n(y)g(the)h(forw)n(ard)d(transformation\))g(or)h(divided)i
(\(b)n(y)f(the)g(in)n(v)n(erse)f(transformation\).)34
-b(This)22 b(factor)h(is)f(set)h(when)227 4126 y(a)k(Zo)r(omMap)g(is)h
+b(This)22 b(factor)h(is)f(set)h(when)227 5222 y(a)k(Zo)r(omMap)g(is)h
(created,)e(but)j(ma)n(y)e(later)g(b)r(e)h(mo)r(di\014ed.)37
b(The)27 b(default)i(v)-5 b(alue)27 b(is)g(unit)n(y)-7
-b(.)227 4251 y(Note)35 b(that)g(if)h(a)e(Zo)r(omMap)g(is)h(in)n(v)n
+b(.)227 5346 y(Note)35 b(that)g(if)h(a)e(Zo)r(omMap)g(is)h(in)n(v)n
(erted)f(\(e.g.)58 b(b)n(y)34 b(using)h(astIn)n(v)n(ert\),)h(then)f
-(the)g(recipro)r(cal)e(of)i(this)g(zo)r(om)227 4350 y(factor)27
-b(will,)h(in)g(e\013ect,)g(b)r(e)g(used.)0 4500 y Fd(T)m(yp)s(e:)227
-4599 y Fi(Double)g(precision.)0 4749 y Fd(Class)j(Applicabilit)m(y:)259
-4885 y(Zo)s(omMap)427 4985 y Fi(All)d(Zo)r(omMaps)f(ha)n(v)n(e)f(this)i
-(attribute.)0 5147 y Fd(Notes:)340 5429 y Fh(\017)45
-b Fi(The)28 b(Zo)r(om)f(attribute)h(ma)n(y)f(not)g(b)r(e)h(set)g(to)f
-(zero.)p eop end
-%%Page: 521 531
-TeXDict begin 521 530 bop 3643 52 a FF(521)0 351 y Fz(D)135
+(the)g(recipro)r(cal)e(of)i(this)g(zo)r(om)227 5445 y(factor)27
+b(will,)h(in)g(e\013ect,)g(b)r(e)g(used.)0 5593 y Fd(T)m(yp)s(e:)227
+5693 y Fi(Double)g(precision.)p eop end
+%%Page: 522 532
+TeXDict begin 522 531 bop 0 52 a FF(522)1994 b Fy(C)91
+b(AST)29 b(A)-8 b(TTRIBUTE)31 b(DESCRIPTIONS)0 351 y
+Fd(Class)g(Applicabilit)m(y:)259 488 y(Zo)s(omMap)427
+587 y Fi(All)d(Zo)r(omMaps)f(ha)n(v)n(e)f(this)i(attribute.)0
+749 y Fd(Notes:)340 1032 y Fh(\017)45 b Fi(The)28 b(Zo)r(om)f
+(attribute)h(ma)n(y)f(not)g(b)r(e)h(set)g(to)f(zero.)p
+eop end
+%%Page: 523 533
+TeXDict begin 523 532 bop 3643 52 a FF(523)0 351 y Fz(D)135
b(AST)43 b(Class)j(Descriptions)p 0 596 3780 12 v 0 728
a(Axis)1057 b Fe(Store)38 b(axis)g(information)1054 b
Fz(Axis)0 901 y Fd(Description:)44 b Fi(The)30 b(Axis)f(class)f(is)h
@@ -137580,8 +137834,8 @@ y(whic)n(h)i(case)f(no)g(sink)g(or)g(source)f(function)j(need)e(b)r(e)h
5390 y Fi(astChannel)-2 5547 y Fd(Inheritance)n(:)227
5693 y Fi(The)28 b(Channel)f(class)g(inherits)h(from)f(the)h(Ob)5
b(ject)27 b(class.)p eop end
-%%Page: 522 532
-TeXDict begin 522 531 bop 0 52 a FF(522)2251 b Fy(D)91
+%%Page: 524 534
+TeXDict begin 524 533 bop 0 52 a FF(524)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)-2 351 y Fd(A)m(ttributes)n(:)227
497 y Fi(In)34 b(addition)e(to)h(those)g(attributes)g(common)g(to)g
(all)f(Ob)5 b(jects,)34 b(ev)n(ery)e(Channel)h(also)f(has)h(the)g
@@ -137628,8 +137882,8 @@ y Fh(\017)45 b Fi(astCircleP)n(ars:)34 b(Get)28 b(the)g(geometric)f
(parameters)e(of)j(the)g(Circle)340 5609 y Fh(\017)45
b Fi(AST)p Ft(_)p Fi(CIR)n(CLEP)-7 b(ARS:)27 b(Get)h(the)g(geometric)f
(parameters)e(of)j(the)g(Circle)p eop end
-%%Page: 523 533
-TeXDict begin 523 532 bop 3643 52 a FF(523)p 0 351 3780
+%%Page: 525 535
+TeXDict begin 525 534 bop 3643 52 a FF(525)p 0 351 3780
12 v 0 482 a Fz(CmpF)-11 b(rame)1429 483 y Fe(Comp)s(ound)37
b(F)-10 b(rame)3128 482 y Fz(CmpF)f(rame)0 656 y Fd(Description:)44
b Fi(A)33 b(CmpF)-7 b(rame)32 b(is)g(a)f(comp)r(ound)i(F)-7
@@ -137712,8 +137966,8 @@ b(.)0 4923 y Fd(Constructor)32 b(F)-8 b(unction:)227
b(CmpMap)f(class)g(do)r(es)g(not)g(de\014ne)h(an)n(y)e(new)i
(attributes)f(b)r(ey)n(ond)g(those)g(whic)n(h)g(are)g(applicable)g(to)g
(all)227 5693 y(Mappings.)p eop end
-%%Page: 524 534
-TeXDict begin 524 533 bop 0 52 a FF(524)2251 b Fy(D)91
+%%Page: 526 536
+TeXDict begin 526 535 bop 0 52 a FF(526)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)-2 351 y Fd(F)-8 b(unctions)n(:)227
497 y Fi(The)34 b(CmpMap)h(class)e(do)r(es)g(not)i(de\014ne)f(an)n(y)f
(new)h(functions)h(b)r(ey)n(ond)f(those)f(whic)n(h)h(are)f(applicable)h
@@ -137797,8 +138051,8 @@ b(.)227 5593 y(When)33 b(quoting)e(a)g(p)r(osition)h(within)g(suc)n(h)g
(the)g(quoted)227 5693 y(p)r(osition)27 b(is)g(the)g(USB)g(p)r(osition)
g(or)f(the)i(corresp)r(onding)d(LSB)i(p)r(osition.)36
b(The)27 b(SideBand)g(attribute)g(pro)n(vides)p eop end
-%%Page: 525 535
-TeXDict begin 525 534 bop 3643 52 a FF(525)227 351 y
+%%Page: 527 537
+TeXDict begin 527 536 bop 3643 52 a FF(527)227 351 y
Fi(this)36 b(indication.)60 b(Another)35 b(option)g(that)h(the)f
(SideBand)g(attribute)h(pro)n(vides)e(is)h(to)g(represen)n(t)f(a)h(sp)r
(ectral)227 451 y(p)r(osition)28 b(b)n(y)f(its)h(top)r(o)r(cen)n(tric)f
@@ -137871,8 +138125,8 @@ b(whose)f(base)g(and)g(curren)n(t)g(F)-7 b(rames)27 b(are)f(related)h
b(DssMap)f(class)g(do)r(es)g(not)g(de\014ne)h(an)n(y)f(new)g
(attributes)g(b)r(ey)n(ond)h(those)f(whic)n(h)g(are)g(applicable)g(to)g
(all)227 5693 y(Mappings.)p eop end
-%%Page: 526 536
-TeXDict begin 526 535 bop 0 52 a FF(526)2251 b Fy(D)91
+%%Page: 528 538
+TeXDict begin 528 537 bop 0 52 a FF(528)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)-2 351 y Fd(F)-8 b(unctions)n(:)227
497 y Fi(The)38 b(DssMap)e(class)h(do)r(es)f(not)i(de\014ne)f(an)n(y)f
(new)i(functions)f(b)r(ey)n(ond)g(those)g(whic)n(h)g(are)f(applicable)h
@@ -137950,8 +138204,8 @@ f(deleted,)i(an)n(y)227 5494 y(remaining)i(header)g(cards)f(in)i(the)g
(viding)f(a)g(sink)h(function)h(\(used)f(to)g(to)g(deliv)n(er)f(header)
g(cards)g(to)h(an)g(external)f(data)h(store\).)46 b(If)p
eop end
-%%Page: 527 537
-TeXDict begin 527 536 bop 3643 52 a FF(527)227 351 y
+%%Page: 529 539
+TeXDict begin 529 538 bop 3643 52 a FF(529)227 351 y
Fi(y)n(ou)30 b(do)g(not)g(pro)n(vide)g(a)g(sink)g(function)h(or)e(a)h
(v)-5 b(alue)30 b(for)g(SinkFile,)i(an)n(y)d(header)h(cards)f
(remaining)h(when)g(the)227 451 y(FitsChan)25 b(is)f(deleted)h(will)g
@@ -138042,8 +138296,8 @@ Fh(\017)45 b Fi(Ncard:)37 b(Num)n(b)r(er)27 b(of)h(FITS)g(header)f
(cards)f(in)i(a)f(FitsChan)340 5693 y Fh(\017)45 b Fi(Nk)n(ey:)37
b(Num)n(b)r(er)28 b(of)f(unique)h(k)n(eyw)n(ords)d(in)j(a)f(FitsChan)p
eop end
-%%Page: 528 538
-TeXDict begin 528 537 bop 0 52 a FF(528)2251 b Fy(D)91
+%%Page: 530 540
+TeXDict begin 530 539 bop 0 52 a FF(530)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)340 351 y Fh(\017)45
b Fi(T)-7 b(abOK:)27 b(Should)h(the)g(FITS)f Ft(")p Fi(-T)-7
b(AB)p Ft(")27 b Fi(algorithm)g(b)r(e)h(recognised?)340
@@ -138119,8 +138373,8 @@ b(class.)-2 5447 y Fd(A)m(ttributes)n(:)227 5593 y Fi(The)32
b(FitsT)-7 b(able)33 b(class)e(do)r(es)h(not)g(de\014ne)g(an)n(y)f(new)
i(attributes)f(b)r(ey)n(ond)f(those)h(whic)n(h)g(are)f(applicable)h(to)
g(all)227 5693 y(T)-7 b(ables.)p eop end
-%%Page: 529 539
-TeXDict begin 529 538 bop 3643 52 a FF(529)-2 351 y Fd(F)-8
+%%Page: 531 541
+TeXDict begin 531 540 bop 3643 52 a FF(531)-2 351 y Fd(F)-8
b(unctions)n(:)227 497 y Fi(In)27 b(addition)f(to)f(those)h(functions)h
(applicable)e(to)h(all)g(T)-7 b(ables,)26 b(the)g(follo)n(wing)f
(functions)i(ma)n(y)e(also)g(b)r(e)i(applied)227 597
@@ -138190,8 +138444,8 @@ b(rame.)227 5444 y(F)g(rames)27 b(ma)n(y)g(also)f(con)n(tain)h(kno)n
(wledge)g(of)g(ho)n(w)g(to)h(transform)e(to)i(and)f(from)g(related)g
(co)r(ordinate)g(systems.)0 5593 y Fd(Constructor)32
b(F)-8 b(unction:)227 5693 y Fi(astF)h(rame)p eop end
-%%Page: 530 540
-TeXDict begin 530 539 bop 0 52 a FF(530)2251 b Fy(D)91
+%%Page: 532 542
+TeXDict begin 532 541 bop 0 52 a FF(532)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)0 351 y Fd(Notes:)340
632 y Fh(\017)45 b Fi(When)40 b(used)f(as)g(a)g(Mapping,)j(a)c(F)-7
b(rame)39 b(implemen)n(ts)h(a)f(unit)g(\(n)n(ull\))h(transformation)e
@@ -138253,8 +138507,8 @@ y Fh(\017)45 b Fi(astAngle:)37 b(Calculate)27 b(the)h(angle)e
(oin)n(t)340 5693 y Fh(\017)45 b Fi(astAxAngle:)37 b(Find)28
b(the)g(angle)f(from)g(an)g(axis,)g(to)h(a)f(line)h(through)e(t)n(w)n
(o)h(p)r(oin)n(ts)p eop end
-%%Page: 531 541
-TeXDict begin 531 540 bop 3643 52 a FF(531)340 351 y
+%%Page: 533 543
+TeXDict begin 533 542 bop 3643 52 a FF(533)340 351 y
Fh(\017)45 b Fi(astAxDistance:)37 b(Calculate)27 b(the)h(distance)f(b)r
(et)n(w)n(een)h(t)n(w)n(o)e(axis)h(v)-5 b(alues)340 483
y Fh(\017)45 b Fi(astAxO\013set:)37 b(Calculate)27 b(an)g(o\013set)h
@@ -138359,140 +138613,150 @@ b(within)h(a)227 5593 y(F)-7 b(rameSet)35 b(will)g(include)g(the)h
(e\013ects)f(of)g(the)g(clipping)g(pro)r(duced)g(b)n(y)f(an)n(y)h
(Regions)f(included)h(in)g(the)g(path)227 5693 y(b)r(et)n(w)n(een)28
b(the)g(F)-7 b(rames.)p eop end
-%%Page: 532 542
-TeXDict begin 532 541 bop 0 52 a FF(532)2251 b Fy(D)91
+%%Page: 534 544
+TeXDict begin 534 543 bop 0 52 a FF(534)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)0 351 y Fd(Constructor)j(F)-8
-b(unction:)227 451 y Fi(astF)h(rameSet)-2 619 y Fd(Inheritance)n(:)227
-765 y Fi(The)28 b(F)-7 b(rameSet)27 b(class)g(inherits)g(from)h(the)g
-(F)-7 b(rame)27 b(class.)-2 934 y Fd(A)m(ttributes)n(:)227
-1080 y Fi(In)41 b(addition)g(to)g(those)f(attributes)h(common)f(to)h
+b(unction:)227 451 y Fi(astF)h(rameSet)-2 603 y Fd(Inheritance)n(:)227
+749 y Fi(The)28 b(F)-7 b(rameSet)27 b(class)g(inherits)g(from)h(the)g
+(F)-7 b(rame)27 b(class.)-2 901 y Fd(A)m(ttributes)n(:)227
+1047 y Fi(In)41 b(addition)g(to)g(those)f(attributes)h(common)f(to)h
(all)g(F)-7 b(rames,)43 b(ev)n(ery)d(F)-7 b(rameSet)40
-b(also)g(has)g(the)i(follo)n(wing)227 1180 y(attributes:)340
-1469 y Fh(\017)j Fi(Base:)36 b(F)-7 b(rameSet)28 b(base)f(F)-7
-b(rame)27 b(index)340 1612 y Fh(\017)45 b Fi(Curren)n(t:)36
-b(F)-7 b(rameSet)28 b(curren)n(t)e(F)-7 b(rame)28 b(index)340
-1754 y Fh(\017)45 b Fi(Nframe:)37 b(Num)n(b)r(er)28 b(of)f(F)-7
-b(rames)27 b(in)h(a)f(F)-7 b(rameSet)227 1935 y(Ev)n(ery)32
-b(F)-7 b(rameSet)32 b(also)g(inherits)h(an)n(y)f(further)h(attributes)g
-(that)g(b)r(elong)f(to)h(its)g(curren)n(t)f(F)-7 b(rame,)34
-b(regardless)227 2034 y(of)j(that)h(F)-7 b(rame's)36
+b(also)g(has)g(the)i(follo)n(wing)227 1147 y(attributes:)340
+1412 y Fh(\017)j Fi(AllV)-7 b(arian)n(ts:)36 b(List)28
+b(of)g(all)f(v)-5 b(arian)n(t)27 b(mappings)g(store)f(with)i(curren)n
+(t)f(F)-7 b(rame)340 1546 y Fh(\017)45 b Fi(Base:)36
+b(F)-7 b(rameSet)28 b(base)f(F)-7 b(rame)27 b(index)340
+1680 y Fh(\017)45 b Fi(Curren)n(t:)36 b(F)-7 b(rameSet)28
+b(curren)n(t)e(F)-7 b(rame)28 b(index)340 1814 y Fh(\017)45
+b Fi(Nframe:)37 b(Num)n(b)r(er)28 b(of)f(F)-7 b(rames)27
+b(in)h(a)f(F)-7 b(rameSet)340 1948 y Fh(\017)45 b Fi(V)-7
+b(arian)n(t:)36 b(Name)28 b(of)f(v)-5 b(arian)n(t)27
+b(mapping)g(in)h(use)g(b)n(y)f(curren)n(t)g(F)-7 b(rame)227
+2113 y(Ev)n(ery)32 b(F)-7 b(rameSet)32 b(also)g(inherits)h(an)n(y)f
+(further)h(attributes)g(that)g(b)r(elong)f(to)h(its)g(curren)n(t)f(F)-7
+b(rame,)34 b(regardless)227 2212 y(of)j(that)h(F)-7 b(rame's)36
b(class.)65 b(\(F)-7 b(or)37 b(example,)i(the)f(Equino)n(x)e
(attribute,)k(de\014ned)d(b)n(y)g(the)h(SkyF)-7 b(rame)36
-b(class,)j(is)227 2134 y(inherited)d(b)n(y)g(an)n(y)f(F)-7
+b(class,)j(is)227 2312 y(inherited)d(b)n(y)g(an)n(y)f(F)-7
b(rameSet)35 b(whic)n(h)h(has)f(a)g(SkyF)-7 b(rame)35
b(as)g(its)h(curren)n(t)f(F)-7 b(rame.\))61 b(The)36
-b(set)g(of)g(attributes)227 2234 y(b)r(elonging)27 b(to)h(a)f(F)-7
+b(set)g(of)g(attributes)227 2412 y(b)r(elonging)27 b(to)h(a)f(F)-7
b(rameSet)27 b(ma)n(y)g(therefore)g(c)n(hange)f(when)i(a)f(new)h
-(curren)n(t)f(F)-7 b(rame)27 b(is)g(selected.)-2 2402
-y Fd(F)-8 b(unctions)n(:)227 2548 y Fi(In)25 b(addition)f(to)g(those)g
+(curren)n(t)f(F)-7 b(rame)27 b(is)g(selected.)-2 2564
+y Fd(F)-8 b(unctions)n(:)227 2710 y Fi(In)25 b(addition)f(to)g(those)g
(functions)h(applicable)e(to)h(all)g(F)-7 b(rames,)25
b(the)f(follo)n(wing)g(functions)g(ma)n(y)g(also)f(b)r(e)i(applied)227
-2648 y(to)j(all)f(F)-7 b(rameSets:)340 2937 y Fh(\017)45
+2809 y(to)j(all)f(F)-7 b(rameSets:)340 3074 y Fh(\017)45
b Fi(astAddF)-7 b(rame:)37 b(Add)28 b(a)f(F)-7 b(rame)27
b(to)h(a)f(F)-7 b(rameSet)27 b(to)h(de\014ne)f(a)h(new)f(co)r(ordinate)
-g(system)340 3080 y Fh(\017)45 b Fi(astGetF)-7 b(rame:)37
+g(system)340 3208 y Fh(\017)45 b Fi(astAddV)-7 b(arian)n(t:)36
+b(Add)29 b(a)e(v)-5 b(arian)n(t)26 b(Mapping)i(to)f(the)h(curren)n(t)f
+(F)-7 b(rame)340 3342 y Fh(\017)45 b Fi(astGetF)-7 b(rame:)37
b(Obtain)27 b(a)g(p)r(oin)n(ter)g(to)h(a)f(sp)r(eci\014ed)h(F)-7
-b(rame)27 b(in)h(a)f(F)-7 b(rameSet)340 3222 y Fh(\017)45
+b(rame)27 b(in)h(a)f(F)-7 b(rameSet)340 3477 y Fh(\017)45
b Fi(astGetMapping:)37 b(Obtain)27 b(a)g(Mapping)g(b)r(et)n(w)n(een)h
(t)n(w)n(o)f(F)-7 b(rames)27 b(in)g(a)h(F)-7 b(rameSet)340
-3364 y Fh(\017)45 b Fi(astRemapF)-7 b(rame:)36 b(Mo)r(dify)28
+3611 y Fh(\017)45 b Fi(astMirrorV)-7 b(arian)n(ts:)34
+b(Mak)n(e)27 b(the)g(curren)n(t)g(F)-7 b(rame)27 b(mirror)f(v)-5
+b(arian)n(t)27 b(Mappings)g(in)h(another)e(F)-7 b(rame)340
+3745 y Fh(\017)45 b Fi(astRemapF)-7 b(rame:)36 b(Mo)r(dify)28
b(a)f(F)-7 b(rame's)27 b(relationship)g(to)g(the)h(other)f(F)-7
-b(rames)27 b(in)h(a)f(F)-7 b(rameSet)340 3507 y Fh(\017)45
+b(rames)27 b(in)h(a)f(F)-7 b(rameSet)340 3879 y Fh(\017)45
b Fi(astRemo)n(v)n(eF)-7 b(rame:)35 b(Remo)n(v)n(e)26
b(a)i(F)-7 b(rame)27 b(from)g(a)g(F)-7 b(rameSet)p 0
-3725 3780 12 v 0 3857 a Fz(GrismMap)160 b Fe(T)-10 b(ransform)36
-b(1-dimensional)g(co)s(ordinates)h(using)1186 3971 y(a)i(grism)e(disp)s
-(ersion)h(equation)3149 3857 y Fz(GrismMap)0 4179 y Fd(Description:)44
+4081 3780 12 v 0 4212 a Fz(GrismMap)160 b Fe(T)-10 b(ransform)36
+b(1-dimensional)g(co)s(ordinates)h(using)1186 4327 y(a)i(grism)e(disp)s
+(ersion)h(equation)3149 4212 y Fz(GrismMap)0 4518 y Fd(Description:)44
b Fi(A)22 b(GrismMap)f(is)g(a)g(sp)r(ecialised)g(form)g(of)g(Mapping)g
(whic)n(h)g(transforms)f(1-dimensional)g(co)r(ordinates)227
-4279 y(using)f(the)h(sp)r(ectral)f(disp)r(ersion)g(equation)g(describ)r
+4618 y(using)f(the)h(sp)r(ectral)f(disp)r(ersion)g(equation)g(describ)r
(ed)g(in)g(FITS-W)n(CS)h(pap)r(er)f(I)r(I)r(I)h Ft(")p
-Fi(Represen)n(tation)e(of)h(sp)r(ectral)227 4379 y(co)r(ordinates)26
+Fi(Represen)n(tation)e(of)h(sp)r(ectral)227 4718 y(co)r(ordinates)26
b(in)i(FITS)p Ft(")p Fi(.)37 b(This)28 b(describ)r(es)f(the)h(disp)r
(ersion)f(pro)r(duced)g(b)n(y)g(gratings,)f(prisms)h(and)h(grisms.)227
-4513 y(When)23 b(initially)f(created,)g(the)h(forw)n(ard)d
+4844 y(When)23 b(initially)f(created,)g(the)h(forw)n(ard)d
(transformation)g(of)i(a)g(GrismMap)f(transforms)g(input)h
-Ft(")p Fi(grism)f(param-)227 4612 y(eter)p Ft(")k Fi(v)-5
+Ft(")p Fi(grism)f(param-)227 4943 y(eter)p Ft(")k Fi(v)-5
b(alues)24 b(in)n(to)h(output)h(w)n(a)n(v)n(elength)d(v)-5
b(alues.)36 b(The)25 b Ft(")p Fi(grism)f(parameter)p
Ft(")f Fi(is)i(a)g(dimensionless)g(v)-5 b(alue)25 b(whic)n(h)227
-4712 y(is)30 b(linearly)e(related)h(to)g(p)r(osition)h(on)f(the)h
+5043 y(is)30 b(linearly)e(related)h(to)g(p)r(osition)h(on)f(the)h
(detector.)42 b(It)30 b(is)f(de\014ned)h(in)g(FITS-W)n(CS)f(pap)r(er)g
-(I)r(I)r(I)h(as)f Ft(")p Fi(the)h(o\013set)227 4811 y(on)25
+(I)r(I)r(I)h(as)f Ft(")p Fi(the)h(o\013set)227 5142 y(on)25
b(the)g(detector)f(from)h(the)g(p)r(oin)n(t)g(of)g(in)n(tersection)f
(of)h(the)g(camera)f(axis,)g(measured)g(in)h(units)h(of)e(the)i
-(e\013ectiv)n(e)227 4911 y(lo)r(cal)f(length)p Ft(")p
+(e\013ectiv)n(e)227 5242 y(lo)r(cal)f(length)p Ft(")p
Fi(.)36 b(The)25 b(units)h(in)f(whic)n(h)g(w)n(a)n(v)n(elength)f(v)-5
b(alues)25 b(are)f(exp)r(ected)i(or)e(returned)h(is)g(determined)g(b)n
-(y)g(the)227 5011 y(v)-5 b(alues)29 b(supplied)h(for)f(the)g(GrismW)-7
+(y)g(the)227 5342 y(v)-5 b(alues)29 b(supplied)h(for)f(the)g(GrismW)-7
b(a)n(v)n(eR,)29 b(GrismNRP)g(and)g(GrismG)g(attribute:)40
-b(whatev)n(er)29 b(units)g(are)g(used)227 5110 y(for)e(these)h
+b(whatev)n(er)29 b(units)g(are)g(used)227 5441 y(for)e(these)h
(attributes)f(will)h(also)f(b)r(e)h(used)f(for)g(the)h(w)n(a)n(v)n
-(elength)e(v)-5 b(alues.)0 5279 y Fd(Constructor)32 b(F)-8
-b(unction:)227 5378 y Fi(astGrismMap)-2 5547 y Fd(Inheritance)n(:)227
-5693 y Fi(The)28 b(GrismMap)f(class)g(inherits)g(from)g(the)h(Mapping)g
-(class.)p eop end
-%%Page: 533 543
-TeXDict begin 533 542 bop 3643 52 a FF(533)-2 351 y Fd(A)m(ttributes)n
-(:)227 497 y Fi(In)32 b(addition)f(to)g(those)g(attributes)g(common)g
-(to)g(all)g(Mappings,)g(ev)n(ery)f(GrismMap)h(also)f(has)h(the)h(follo)
-n(wing)227 597 y(attributes:)340 934 y Fh(\017)45 b Fi(GrismNR:)28
+(elength)e(v)-5 b(alues.)0 5593 y Fd(Constructor)32 b(F)-8
+b(unction:)227 5693 y Fi(astGrismMap)p eop end
+%%Page: 535 545
+TeXDict begin 535 544 bop 3643 52 a FF(535)-2 351 y Fd(Inheritance)n(:)
+227 497 y Fi(The)28 b(GrismMap)f(class)g(inherits)g(from)g(the)h
+(Mapping)g(class.)-2 673 y Fd(A)m(ttributes)n(:)227 819
+y Fi(In)k(addition)f(to)g(those)g(attributes)g(common)g(to)g(all)g
+(Mappings,)g(ev)n(ery)f(GrismMap)h(also)f(has)h(the)h(follo)n(wing)227
+918 y(attributes:)340 1218 y Fh(\017)45 b Fi(GrismNR:)28
b(The)g(refractiv)n(e)e(index)i(at)f(the)h(reference)f(w)n(a)n(v)n
-(elength)340 1092 y Fh(\017)45 b Fi(GrismNRP:)28 b(Rate)f(of)h(c)n
+(elength)340 1364 y Fh(\017)45 b Fi(GrismNRP:)28 b(Rate)f(of)h(c)n
(hange)e(of)i(refractiv)n(e)e(index)h(with)i(w)n(a)n(v)n(elength)340
-1250 y Fh(\017)45 b Fi(GrismW)-7 b(a)n(v)n(eR:)27 b(The)g(reference)g
-(w)n(a)n(v)n(elength)340 1409 y Fh(\017)45 b Fi(GrismAlpha:)37
+1510 y Fh(\017)45 b Fi(GrismW)-7 b(a)n(v)n(eR:)27 b(The)g(reference)g
+(w)n(a)n(v)n(elength)340 1656 y Fh(\017)45 b Fi(GrismAlpha:)37
b(The)28 b(angle)e(of)i(incidence)g(of)f(the)h(incoming)f(ligh)n(t)340
-1567 y Fh(\017)45 b Fi(GrismG:)28 b(The)f(grating)g(ruling)g(densit)n
-(y)340 1725 y Fh(\017)45 b Fi(GrismM:)28 b(The)f(in)n(terference)g
-(order)340 1883 y Fh(\017)45 b Fi(GrismEps:)36 b(The)28
+1802 y Fh(\017)45 b Fi(GrismG:)28 b(The)f(grating)g(ruling)g(densit)n
+(y)340 1947 y Fh(\017)45 b Fi(GrismM:)28 b(The)f(in)n(terference)g
+(order)340 2093 y Fh(\017)45 b Fi(GrismEps:)36 b(The)28
b(angle)f(b)r(et)n(w)n(een)g(the)h(normal)f(and)g(the)h(disp)r(ersion)f
-(plane)340 2041 y Fh(\017)45 b Fi(GrismTheta:)37 b(Angle)27
+(plane)340 2239 y Fh(\017)45 b Fi(GrismTheta:)37 b(Angle)27
b(b)r(et)n(w)n(een)h(normal)e(to)i(detector)f(plane)g(and)h(reference)e
-(ra)n(y)-2 2254 y Fd(F)-8 b(unctions)n(:)227 2400 y Fi(The)31
+(ra)n(y)-2 2427 y Fd(F)-8 b(unctions)n(:)227 2573 y Fi(The)31
b(GrismMap)g(class)f(do)r(es)g(not)h(de\014ne)g(an)n(y)f(new)h
(functions)h(b)r(ey)n(ond)e(those)h(whic)n(h)g(are)f(applicable)g(to)h
-(all)227 2500 y(Mappings.)p 0 2750 3780 12 v 0 2881 a
+(all)227 2673 y(Mappings.)p 0 2898 3780 12 v 0 3030 a
Fz(In)l(terv)-7 b(al)186 b Fe(A)39 b(region)e(represen)m(ting)g(an)h
-(in)m(terv)-7 b(al)37 b(on)h(one)h(or)f(more)1485 2996
-y(axes)h(of)f(a)h(F)-10 b(rame)3324 2881 y Fz(In)l(terv)j(al)0
-3217 y Fd(Description:)44 b Fi(The)23 b(In)n(terv)-5
+(in)m(terv)-7 b(al)37 b(on)h(one)h(or)f(more)1485 3144
+y(axes)h(of)f(a)h(F)-10 b(rame)3324 3030 y Fz(In)l(terv)j(al)0
+3340 y Fd(Description:)44 b Fi(The)23 b(In)n(terv)-5
b(al)22 b(class)g(implemen)n(ts)h(a)f(Region)g(whic)n(h)g(represen)n
(ts)g(upp)r(er)g(and/or)f(lo)n(w)n(er)h(limits)h(on)f(one)227
-3316 y(or)i(more)g(axes)g(of)g(a)h(F)-7 b(rame.)35 b(F)-7
+3440 y(or)i(more)g(axes)g(of)g(a)h(F)-7 b(rame.)35 b(F)-7
b(or)24 b(a)g(p)r(oin)n(t)h(to)g(b)r(e)g(within)g(the)g(region)f
(represen)n(ted)f(b)n(y)i(the)g(In)n(terv)-5 b(al,)24
-b(the)h(p)r(oin)n(t)227 3416 y(m)n(ust)j(satisfy)f(all)g(the)h
+b(the)h(p)r(oin)n(t)227 3540 y(m)n(ust)j(satisfy)f(all)g(the)h
(restrictions)e(placed)h(on)g(all)g(the)h(axes.)36 b(The)27
b(p)r(oin)n(t)h(is)f(outside)g(the)h(region)e(if)i(it)g(fails)f(to)227
-3516 y(satisfy)j(an)n(y)g(one)f(of)i(the)f(restrictions.)44
+3639 y(satisfy)j(an)n(y)g(one)f(of)i(the)f(restrictions.)44
b(Eac)n(h)29 b(axis)g(ma)n(y)h(ha)n(v)n(e)f(either)h(an)g(upp)r(er)g
-(limit,)i(a)e(lo)n(w)n(er)e(limit,)k(b)r(oth)227 3615
+(limit,)i(a)e(lo)n(w)n(er)e(limit,)k(b)r(oth)227 3739
y(or)e(neither.)47 b(If)32 b(b)r(oth)f(limits)h(are)e(supplied)h(but)g
(are)f(in)i(rev)n(erse)d(order)g(\(so)i(that)g(the)g(lo)n(w)n(er)f
-(limit)i(is)e(greater)227 3715 y(than)e(the)g(upp)r(er)g(limit\),)g
+(limit)i(is)e(greater)227 3838 y(than)e(the)g(upp)r(er)g(limit\),)g
(then)h(the)f(in)n(terv)-5 b(al)27 b(is)g(an)g(excluded)h(in)n(terv)-5
b(al,)27 b(rather)g(than)g(an)h(included)g(in)n(terv)-5
-b(al.)227 3865 y(Note,)33 b(The)e(In)n(terv)-5 b(al)31
+b(al.)227 3976 y(Note,)33 b(The)e(In)n(terv)-5 b(al)31
b(class)g(mak)n(es)f(no)h(allo)n(w)n(ances)f(for)h(cyclic)g(nature)g
(of)g(some)g(co)r(ordinate)g(systems)g(\(suc)n(h)227
-3964 y(as)25 b(SkyF)-7 b(rame)24 b(co)r(ordinates\).)35
+4076 y(as)25 b(SkyF)-7 b(rame)24 b(co)r(ordinates\).)35
b(A)25 b(Bo)n(x)f(should)g(usually)h(b)r(e)g(used)g(in)g(these)g(cases)
-f(since)h(this)g(requires)f(the)h(user)227 4064 y(to)j(think)g(ab)r
+f(since)h(this)g(requires)f(the)h(user)227 4175 y(to)j(think)g(ab)r
(out)f(suitable)h(upp)r(er)g(and)f(lo)n(w)n(er)f(limits,)0
-4264 y Fd(Constructor)32 b(F)-8 b(unction:)227 4364 y
-Fi(astIn)n(terv)j(al)-2 4564 y Fd(Inheritance)n(:)227
-4710 y Fi(The)28 b(In)n(terv)-5 b(al)27 b(class)g(inherits)g(from)g
-(the)h(Region)f(class.)-2 4910 y Fd(A)m(ttributes)n(:)227
-5056 y Fi(The)37 b(In)n(terv)-5 b(al)35 b(class)h(do)r(es)g(not)g
+4351 y Fd(Constructor)32 b(F)-8 b(unction:)227 4450 y
+Fi(astIn)n(terv)j(al)-2 4626 y Fd(Inheritance)n(:)227
+4772 y Fi(The)28 b(In)n(terv)-5 b(al)27 b(class)g(inherits)g(from)g
+(the)h(Region)f(class.)-2 4947 y Fd(A)m(ttributes)n(:)227
+5093 y Fi(The)37 b(In)n(terv)-5 b(al)35 b(class)h(do)r(es)g(not)g
(de\014ne)h(an)n(y)e(new)i(attributes)f(b)r(ey)n(ond)g(those)g(whic)n
-(h)g(are)g(applicable)g(to)g(all)227 5156 y(Regions.)-2
-5356 y Fd(F)-8 b(unctions)n(:)227 5502 y Fi(The)38 b(In)n(terv)-5
+(h)g(are)g(applicable)g(to)g(all)227 5193 y(Regions.)-2
+5368 y Fd(F)-8 b(unctions)n(:)227 5514 y Fi(The)38 b(In)n(terv)-5
b(al)38 b(class)f(do)r(es)h(not)g(de\014ne)g(an)n(y)f(new)h(functions)h
(b)r(ey)n(ond)f(those)f(whic)n(h)h(are)f(applicable)h(to)g(all)227
-5602 y(Regions.)p eop end
-%%Page: 534 544
-TeXDict begin 534 543 bop 0 52 a FF(534)2251 b Fy(D)91
+5614 y(Regions.)p eop end
+%%Page: 536 546
+TeXDict begin 536 545 bop 0 52 a FF(536)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 482
a Fz(In)l(traMap)801 483 y Fe(Map)39 b(p)s(oin)m(ts)f(using)g(a)h(priv)
-7 b(ate)37 b(transformation)1680 598 y(function)3218
@@ -138560,8 +138824,8 @@ b(ject)27 b(class.)-2 5348 y Fd(A)m(ttributes)n(:)227
5494 y Fi(In)33 b(addition)f(to)h(those)f(attributes)g(common)g(to)g
(all)g(Ob)5 b(jects,)34 b(ev)n(ery)d(KeyMap)h(also)f(has)h(the)h(follo)
n(wing)e(at-)227 5594 y(tributes:)p eop end
-%%Page: 535 545
-TeXDict begin 535 544 bop 3643 52 a FF(535)340 351 y
+%%Page: 537 547
+TeXDict begin 537 546 bop 3643 52 a FF(537)340 351 y
Fh(\017)45 b Fi(KeyCase:)36 b(Sets)27 b(the)h(case)f(in)h(whic)n(h)f(k)
n(eys)g(are)g(stored)340 483 y Fh(\017)45 b Fi(KeyError:)34
b(Rep)r(ort)28 b(an)f(error)e(if)k(the)f(requested)f(k)n(ey)f(do)r(es)i
@@ -138641,8 +138905,8 @@ b(alue)28 b(is)f(returned)h(as)e(AST)p Ft(__)p Fi(BAD.)227
f(then)h(the)227 5445 y(in)n(v)n(erse)g(transformation)g(ma)n(y)h(also)
g(b)r(e)h(p)r(erformed.)0 5593 y Fd(Constructor)k(F)-8
b(unction:)227 5693 y Fi(astLutMap)p eop end
-%%Page: 536 546
-TeXDict begin 536 545 bop 0 52 a FF(536)2251 b Fy(D)91
+%%Page: 538 548
+TeXDict begin 538 547 bop 0 52 a FF(538)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)-2 351 y Fd(Inheritance)n(:)227
497 y Fi(The)f(LutMap)g(class)e(inherits)i(from)f(the)h(Mapping)f
(class.)-2 644 y Fd(A)m(ttributes)n(:)227 791 y Fi(In)38
@@ -138699,8 +138963,8 @@ b(a)h(Mapping)f(in)n(to)g(t)n(w)n(o)g(comp)r(onen)n(t)g(Mappings)340
b(a)h(grid)g(of)h(p)r(ositions)340 5693 y Fh(\017)45
b Fi(astIn)n(v)n(ert:)36 b(In)n(v)n(ert)26 b(a)i(Mapping)p
eop end
-%%Page: 537 547
-TeXDict begin 537 546 bop 3643 52 a FF(537)340 351 y
+%%Page: 539 549
+TeXDict begin 539 548 bop 3643 52 a FF(539)340 351 y
Fh(\017)45 b Fi(astLinearAppro)n(x:)35 b(Calculate)27
b(a)g(linear)g(appro)n(ximation)f(to)h(a)g(Mapping)340
508 y Fh(\017)45 b Fi(astMapBo)n(x:)35 b(Find)29 b(a)e(b)r(ounding)g(b)
@@ -138756,8 +139020,8 @@ b Fi(SimpIF:)29 b(In)n(v)n(erse-forw)n(ard)24 b(MathMap)j(pairs)g
y Fi(The)33 b(MathMap)g(class)e(do)r(es)i(not)f(de\014ne)h(an)n(y)f
(new)h(functions)g(b)r(ey)n(ond)f(those)h(whic)n(h)f(are)g(applicable)g
(to)h(all)227 5603 y(Mappings.)p eop end
-%%Page: 538 548
-TeXDict begin 538 547 bop 0 52 a FF(538)2251 b Fy(D)91
+%%Page: 540 550
+TeXDict begin 540 549 bop 0 52 a FF(540)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 483
a Fz(MatrixMap)264 b Fe(Map)39 b(co)s(ordinates)e(b)m(y)h(m)m
(ultiplying)d(b)m(y)k(a)1719 594 y(matrix)3103 483 y
@@ -138818,8 +139082,8 @@ y(Negated)k(attribute)g(of)h(a)e(NullRegion)i(is)f(true,)h(the)g
(NullRegion)f(represen)n(ts)e(an)i(in\014nite)h(Region)f(\(that)h(is,)
227 5693 y(all)28 b(p)r(oin)n(ts)f(in)h(the)g(co)r(ordinate)e(system)i
(are)e(inside)i(the)g(NullRegion\).)p eop end
-%%Page: 539 549
-TeXDict begin 539 548 bop 3643 52 a FF(539)0 351 y Fd(Constructor)32
+%%Page: 541 551
+TeXDict begin 541 550 bop 3643 52 a FF(541)0 351 y Fd(Constructor)32
b(F)-8 b(unction:)227 451 y Fi(astNullRegion)-2 603 y
Fd(Inheritance)n(:)227 749 y Fi(The)28 b(NullRegion)f(class)g(inherits)
g(from)h(the)g(Region)f(class.)-2 900 y Fd(A)m(ttributes)n(:)227
@@ -138871,8 +139135,8 @@ b Fi(astEnd:)37 b(End)27 b(an)g(AST)h(con)n(text)340
5693 y Fh(\017)45 b Fi(astEscap)r(es:)36 b(Con)n(trol)26
b(whether)h(graphical)f(escap)r(e)h(sequences)g(are)g(remo)n(v)n(ed)p
eop end
-%%Page: 540 550
-TeXDict begin 540 549 bop 0 52 a FF(540)2251 b Fy(D)91
+%%Page: 542 552
+TeXDict begin 542 551 bop 0 52 a FF(542)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)340 351 y Fh(\017)45
b Fi(astExempt:)37 b(Exempt)27 b(an)g(Ob)5 b(ject)28
b(p)r(oin)n(ter)f(from)g(AST)h(con)n(text)f(handling)340
@@ -138947,8 +139211,8 @@ b(PcdMap)27 b(pincushion/barrel)f(distortion)g(co)r(e\016cien)n(t)340
5693 y Fh(\017)45 b Fi(PcdCen\(axis\):)36 b(Cen)n(tre)28
b(co)r(ordinates)e(of)h(pincushion/barrel)f(distortion)p
eop end
-%%Page: 541 551
-TeXDict begin 541 550 bop 3643 52 a FF(541)-2 351 y Fd(F)-8
+%%Page: 543 553
+TeXDict begin 543 552 bop 3643 52 a FF(543)-2 351 y Fd(F)-8
b(unctions)n(:)227 497 y Fi(The)37 b(PcdMap)f(class)f(do)r(es)h(not)h
(de\014ne)f(an)n(y)g(new)h(functions)f(b)r(ey)n(ond)h(those)f(whic)n(h)
g(are)g(applicable)g(to)g(all)227 597 y(Mappings.)p 0
@@ -139025,8 +139289,8 @@ b(a)f(Plot)g(ma)n(y)f(also)g(b)r(e)i(used)f(as)g(a)f(F)-7
b(rame.)47 b(In)32 b(this)f(case,)h(it)f(b)r(eha)n(v)n(es)f(lik)n(e)h
(its)g(curren)n(t)227 5693 y(F)-7 b(rame,)27 b(whic)n(h)h(describ)r(es)
f(the)h(ph)n(ysical)f(co)r(ordinate)f(system.)p eop end
-%%Page: 542 552
-TeXDict begin 542 551 bop 0 52 a FF(542)2251 b Fy(D)91
+%%Page: 544 554
+TeXDict begin 544 553 bop 0 52 a FF(544)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)227 351 y Fi(When)35
b(used)f(as)g(a)g(Mapping,)h(a)f(Plot)g(describ)r(es)f(the)i(in)n
(ter-relation)e(b)r(et)n(w)n(een)h(graphical)e(co)r(ordinates)h(\(its)
@@ -139097,8 +139361,8 @@ b Fi(T)-7 b(extLab\(axis\):)37 b(Dra)n(w)26 b(descriptiv)n(e)h(axis)g
(lab)r(els)g(for)g(a)h(Plot?)340 5693 y Fh(\017)45 b
Fi(T)-7 b(extLabGap\(axis\):)36 b(Spacing)27 b(of)h(descriptiv)n(e)f
(axis)f(lab)r(els)i(for)f(a)g(Plot)p eop end
-%%Page: 543 553
-TeXDict begin 543 552 bop 3643 52 a FF(543)340 351 y
+%%Page: 545 555
+TeXDict begin 545 554 bop 3643 52 a FF(545)340 351 y
Fh(\017)45 b Fi(Tic)n(kAll:)37 b(Dra)n(w)27 b(tic)n(k)g(marks)g(on)g
(all)g(edges)g(of)h(a)f(Plot?)340 482 y Fh(\017)45 b
Fi(TitleGap:)37 b(V)-7 b(ertical)28 b(spacing)e(for)h(a)g(Plot)g(title)
@@ -139173,8 +139437,8 @@ b(Grid)28 b(lines)f(dra)n(wn)g(using)g(astGridLine)g(or)g(astGrid)340
b(mark)n(ers)e(\(sym)n(b)r(ols\))j(dra)n(wn)e(using)i(astMark)340
5693 y Fh(\017)45 b Fi(NumLab:)37 b(Numerical)28 b(axis)e(lab)r(els)i
(dra)n(wn)e(using)i(astGrid)p eop end
-%%Page: 544 554
-TeXDict begin 544 553 bop 0 52 a FF(544)2251 b Fy(D)91
+%%Page: 546 556
+TeXDict begin 546 555 bop 0 52 a FF(546)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)340 351 y Fh(\017)45
b Fi(NumLab1:)37 b(Numerical)27 b(lab)r(els)g(for)g(axis)g(1)g(dra)n
(wn)g(using)g(astGrid)340 483 y Fh(\017)45 b Fi(NumLab2:)37
@@ -139280,8 +139544,8 @@ b(rame\).)227 5593 y(Although)34 b(the)g(Plot3D)g(class)f(inherits)g
b(ailable)27 b(in)i(the)h(Plot3D)e(class,)g(and)h(an)f(error)f(will)i
(b)r(e)g(rep)r(orted)f(if)h(an)n(y)f(attempt)i(is)f(made)f(to)h(use)p
eop end
-%%Page: 545 555
-TeXDict begin 545 554 bop 3643 52 a FF(545)227 351 y
+%%Page: 547 557
+TeXDict begin 547 556 bop 3643 52 a FF(547)227 351 y
Fi(them.)62 b(Sp)r(eci\014cally)-7 b(,)37 b(the)f(Plot3D)f(class)g(do)r
(es)g(not)h(supp)r(ort)f(clipping)h(using)f(the)h(astClip)g(function.)
61 b(Nor)227 451 y(do)r(es)31 b(it)h(supp)r(ort)g(the)g(sp)r
@@ -139333,8 +139597,8 @@ n(oin)n(tList)-2 5369 y Fd(F)-8 b(unctions)n(:)227 5515
y Fi(The)35 b(P)n(oin)n(tList)e(class)g(do)r(es)h(not)h(de\014ne)f(an)n
(y)g(new)g(functions)h(b)r(ey)n(ond)f(those)g(whic)n(h)g(are)g
(applicable)g(to)g(all)227 5615 y(Regions.)p eop end
-%%Page: 546 556
-TeXDict begin 546 555 bop 0 52 a FF(546)2251 b Fy(D)91
+%%Page: 548 558
+TeXDict begin 548 557 bop 0 52 a FF(548)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 483
a Fz(P)l(olyMap)225 b Fe(Map)38 b(co)s(ordinates)f(using)h(p)s
(olynomial)e(functions)223 b Fz(P)l(olyMap)0 679 y Fd(Description:)44
@@ -139406,8 +139670,8 @@ g(of)g(the)g(b)r(oundary)f(when)g(mo)n(ving)g(through)g(the)h(v)n
b(F)-8 b(unction:)227 5390 y Fi(astP)n(olygon)-2 5547
y Fd(Inheritance)n(:)227 5693 y Fi(The)28 b(P)n(olygon)d(class)i
(inherits)g(from)h(the)g(Region)f(class.)p eop end
-%%Page: 547 557
-TeXDict begin 547 556 bop 3643 52 a FF(547)-2 351 y Fd(A)m(ttributes)n
+%%Page: 549 559
+TeXDict begin 549 558 bop 3643 52 a FF(549)-2 351 y Fd(A)m(ttributes)n
(:)227 497 y Fi(The)36 b(P)n(olygon)d(class)i(do)r(es)g(not)h(de\014ne)
f(an)n(y)g(new)h(attributes)f(b)r(ey)n(ond)g(those)g(whic)n(h)h(are)e
(applicable)h(to)h(all)227 597 y(Regions.)-2 742 y Fd(F)-8
@@ -139476,8 +139740,8 @@ f(is)h(created\).)227 5057 y(A)g(RateMap)f(whic)n(h)h(has)e(not)i(b)r
Fi(astRateMap)-2 5547 y Fd(Inheritance)n(:)227 5693 y
Fi(The)28 b(RateMap)f(class)g(inherits)g(from)h(the)g(Mapping)f(class.)
p eop end
-%%Page: 548 558
-TeXDict begin 548 557 bop 0 52 a FF(548)2251 b Fy(D)91
+%%Page: 550 560
+TeXDict begin 550 559 bop 0 52 a FF(550)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)-2 351 y Fd(A)m(ttributes)n(:)227
497 y Fi(The)k(RateMap)f(class)g(do)r(es)g(not)h(de\014ne)g(an)n(y)e
(new)i(attributes)g(b)r(ey)n(ond)f(those)g(whic)n(h)h(are)e(applicable)
@@ -139585,8 +139849,8 @@ e(c)n(hanging)g(shap)r(e)h(-)f(for)h(instance,)g(a)g(circle)f(ma)n(y)
5693 y(curren)n(t)i(co)r(ordinate)f(system)i(of)f(the)h(Region)f(\(but)
i(this)f(ma)n(y)e(not)i(alw)n(a)n(ys)e(b)r(e)i(p)r(ossible\).)p
eop end
-%%Page: 549 559
-TeXDict begin 549 558 bop 3643 52 a FF(549)227 351 y
+%%Page: 551 561
+TeXDict begin 551 560 bop 3643 52 a FF(551)227 351 y
Fi(It)26 b(is)f(p)r(ossible)g(to)g(negate)f(an)h(existing)g(Region)f
(so)h(that)g(it)h(represen)n(ts)e(all)g(areas)g(of)h(the)h
(encapsulated)e(F)-7 b(rame)227 451 y(except)28 b(for)f(the)h(area)e
@@ -139656,8 +139920,8 @@ f(encapsulated)g(Region.)35 b(All)25 b(SelectorMaps)e(ha)n(v)n(e)g
(only)227 5693 y(a)k(single)h(output.)37 b(SelectorMaps)26
b(do)i(not)f(de\014ne)h(an)f(in)n(v)n(erse)f(transformation.)p
eop end
-%%Page: 550 560
-TeXDict begin 550 559 bop 0 52 a FF(550)2251 b Fy(D)91
+%%Page: 552 562
+TeXDict begin 552 561 bop 0 52 a FF(552)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)227 351 y Fi(F)-7 b(or)36
b(eac)n(h)f(input)i(p)r(osition,)h(the)e(forw)n(ard)e(transformation)h
(of)h(a)f(SelectorMap)g(searc)n(hes)f(through)h(the)i(en-)227
@@ -139716,8 +139980,8 @@ b(Y)-7 b(ou)30 b(should)227 5101 y(encoun)n(ter)d(it)h(only)f(within)i
Fi(None.)-2 5487 y Fd(Inheritance)n(:)227 5633 y Fi(The)28
b(SkyAxis)f(class)g(inherits)g(from)h(the)g(Axis)f(class.)p
eop end
-%%Page: 551 561
-TeXDict begin 551 560 bop 3643 52 a FF(551)p 0 351 3780
+%%Page: 553 563
+TeXDict begin 553 562 bop 3643 52 a FF(553)p 0 351 3780
12 v 0 483 a Fz(SkyF)-11 b(rame)306 b Fe(Celestial)37
b(co)s(ordinate)f(system)i(description)305 b Fz(SkyF)-11
b(rame)0 721 y Fd(Description:)44 b Fi(A)35 b(SkyF)-7
@@ -139778,8 +140042,8 @@ b(rames,)25 b(the)f(follo)n(wing)g(functions)g(ma)n(y)g(also)f(b)r(e)i
y Fh(\017)45 b Fi(astSkyO\013setMap:)36 b(Obtain)28 b(a)f(Mapping)g
(from)g(absolute)g(to)h(o\013set)f(co)r(ordinates)p eop
end
-%%Page: 552 562
-TeXDict begin 552 561 bop 0 52 a FF(552)2251 b Fy(D)91
+%%Page: 554 564
+TeXDict begin 554 563 bop 0 52 a FF(554)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 483
a Fz(SlaMap)328 b Fe(Sequence)39 b(of)g(celestial)e(co)s(ordinate)f
(con)m(v)m(ersions)326 b Fz(SlaMap)0 667 y Fd(Description:)44
@@ -139846,8 +140110,8 @@ f(optionally)227 5137 y(b)r(e)32 b(app)r(ended)f(to)g(the)h(end)f(of)g
(de\014ne)g(an)n(y)f(new)h(functions)g(b)r(ey)n(ond)g(those)f(whic)n(h)
h(are)e(applicable)i(to)227 5630 y(all)h(CmpF)-7 b(rames.)p
eop end
-%%Page: 553 563
-TeXDict begin 553 562 bop 3643 52 a FF(553)p 0 351 3780
+%%Page: 555 565
+TeXDict begin 555 564 bop 3643 52 a FF(555)p 0 351 3780
12 v 0 482 a Fz(Sp)t(ecF)-11 b(rame)899 483 y Fe(Sp)s(ectral)37
b(co)s(ordinate)g(system)h(description)3138 482 y Fz(Sp)t(ecF)-11
b(rame)0 718 y Fd(Description:)44 b Fi(A)38 b(Sp)r(ecF)-7
@@ -139907,8 +140171,8 @@ g(F)-7 b(rames,)25 b(the)f(follo)n(wing)g(functions)g(ma)n(y)g(also)f
(osition)g(in)h(an)n(y)f(celestial)g(system)340 5604
y Fh(\017)45 b Fi(astGetRefP)n(os:)36 b(Get)28 b(reference)f(p)r
(osition)g(in)h(an)n(y)f(celestial)g(system)p eop end
-%%Page: 554 564
-TeXDict begin 554 563 bop 0 52 a FF(554)2251 b Fy(D)91
+%%Page: 556 566
+TeXDict begin 556 565 bop 0 52 a FF(556)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)p 0 351 3780 12 v 0 482
a Fz(Sp)t(ecMap)775 483 y Fe(Sequence)39 b(of)f(sp)s(ectral)g(co)s
(ordinate)f(con)m(v)m(ersions)3238 482 y Fz(Sp)t(ecMap)0
@@ -139979,8 +140243,8 @@ b(The)38 b(in)n(v)n(erse)e(transformation)g(alw)n(a)n(ys)f(pro)r(duces)
5273 y Fd(Constructor)k(F)-8 b(unction:)227 5373 y Fi(astSphMap)-2
5547 y Fd(Inheritance)n(:)227 5693 y Fi(The)28 b(SphMap)g(class)e
(inherits)i(from)f(the)h(Mapping)f(class.)p eop end
-%%Page: 555 565
-TeXDict begin 555 564 bop 3643 52 a FF(555)-2 351 y Fd(A)m(ttributes)n
+%%Page: 557 567
+TeXDict begin 557 566 bop 3643 52 a FF(557)-2 351 y Fd(A)m(ttributes)n
(:)227 497 y Fi(In)38 b(addition)f(to)g(those)g(attributes)g(common)f
(to)h(all)g(Mappings,)i(ev)n(ery)d(SphMap)h(also)f(has)h(the)h(follo)n
(wing)227 597 y(attributes:)340 873 y Fh(\017)45 b Fi(UnitRadius:)38
@@ -140025,8 +140289,8 @@ y Fe(Corresp)s(ond)1737 5116 y(to)38 b(the)1739 5216
y(IV)m(O)m(A)1659 5315 y(STCCat-)1694 5415 y(alogEn-)1671
5528 y(tryLo)s(ca-)1789 5639 y(tion)1772 5739 y(class)2295
4985 y Fz(StcCatalogEn)l(tryLo)t(cation)p eop end
-%%Page: 556 566
-TeXDict begin 556 565 bop 0 52 a FF(556)2251 b Fy(D)91
+%%Page: 558 568
+TeXDict begin 558 567 bop 0 52 a FF(558)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)0 351 y Fd(Description:)44
b Fi(The)29 b(StcCatalogEn)n(tryLo)r(cation)d(class)i(is)h(a)f
(sub-class)g(of)h(Stc)g(used)g(to)g(describ)r(e)f(the)i(co)n(v)n(erage)
@@ -140089,8 +140353,8 @@ b(for)g(terrestrial)g(observ)-5 b(ations,)21 b(the)h(p)r(osition)g(of)g
(cation)f(class)f(do)r(es)i(not)g(de\014ne)g(an)n(y)f(new)h(functions)g
(b)r(ey)n(ond)f(those)h(whic)n(h)f(are)g(applicable)227
5636 y(to)28 b(all)f(Stcs.)p eop end
-%%Page: 557 567
-TeXDict begin 557 566 bop 3643 52 a FF(557)p 0 351 3780
+%%Page: 559 569
+TeXDict begin 559 568 bop 3643 52 a FF(559)p 0 351 3780
12 v 0 483 a Fz(StcResourcePro\014le)153 b Fe(Corresp)s(ond)33
b(to)g(the)h(IV)m(O)m(A)1377 598 y(STCResourcePro\014le)1772
697 y(class)2672 483 y Fz(StcResourcePro\014le)0 855
@@ -140144,8 +140408,8 @@ b(ject,)25 b(and)f(reading)g(from)g(an)g(StcsChan)g(will)h(create)e(a)h
(the)f(co)r(ordinate)f(frame)g(de-)227 5693 y(scrib)r(ed)h(b)n(y)f(the)
i(STC-S)e(description\),)j(or)d(2\))g(a)h(Region)f(describing)g(the)h
(STC)g(AstrCo)r(ordsArea)e(\(i.e.)56 b(an)p eop end
-%%Page: 558 568
-TeXDict begin 558 567 bop 0 52 a FF(558)2251 b Fy(D)91
+%%Page: 560 570
+TeXDict begin 560 569 bop 0 52 a FF(560)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)227 351 y Fi(area)d(or)h(v)n(olume)g
(of)h(in)n(terest)f(within)h(the)g(co)r(ordinate)e(frame)i(describ)r
(ed)f(b)n(y)g(the)h(STC-S)g(description\),)f(or)g(3\))227
@@ -140249,8 +140513,8 @@ b(YCENTER,)42 b(MOON,)g(MER)n(CUR)-7 b(Y,)427 5561 y(VENUS,)28
b(MARS,)h(JUPITER,)d(SA)-7 b(TURN,)29 b(URANUS,)g(NEPTUNE,)e(PLUTO.)340
5693 y Fh(\017)45 b Fi(Error)26 b(v)-5 b(alues)27 b(are)f(supp)r(orted)
i(but)g(error)e(ranges)g(are)g(not.)p eop end
-%%Page: 559 569
-TeXDict begin 559 568 bop 3643 52 a FF(559)340 351 y
+%%Page: 561 571
+TeXDict begin 561 570 bop 3643 52 a FF(561)340 351 y
Fh(\017)45 b Fi(Resolution,)27 b(PixSize)g(and)h(Size)g(v)-5
b(alues)27 b(are)f(ignored.)340 490 y Fh(\017)45 b Fi(Space)28
b(v)n(elo)r(cit)n(y)e(sub-phrases)g(are)h(ignored.)0
@@ -140333,8 +140597,8 @@ b(alue)31 b(of)g(AST)p Ft(__)p Fi(BAD)227 5593 y(on)k(ev)n(ery)g(axis.)
y(transform)27 b(the)h(supplied)g(input)g(p)r(osition)f(to)h(pro)r
(duce)f(the)h(Switc)n(hMap)g(output)g(p)r(osition.)p
eop end
-%%Page: 560 570
-TeXDict begin 560 569 bop 0 52 a FF(560)2251 b Fy(D)91
+%%Page: 562 572
+TeXDict begin 562 571 bop 0 52 a FF(562)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)227 351 y Fi(When)k(the)g(Switc)n(hMap)
f(is)g(used)g(to)g(transform)f(a)h(p)r(osition)g(in)h(the)f(in)n(v)n
(erse)f(direction)h(\(from)g Ft(")p Fi(output)p Ft(")g
@@ -140424,8 +140688,8 @@ f(the)i(same)e(t)n(yp)r(e)i(and)f(shap)r(e,)g(as)227
(T)-7 b(able)27 b(class)g(to)h(store)e(v)n(ery)h(large)f(tables.)0
5593 y Fd(Constructor)32 b(F)-8 b(unction:)227 5693 y
Fi(astT)h(able)p eop end
-%%Page: 561 571
-TeXDict begin 561 570 bop 3643 52 a FF(561)-2 351 y Fd(Inheritance)n(:)
+%%Page: 563 573
+TeXDict begin 563 572 bop 3643 52 a FF(563)-2 351 y Fd(Inheritance)n(:)
227 497 y Fi(The)28 b(T)-7 b(able)27 b(class)g(inherits)g(from)h(the)g
(KeyMap)e(class.)-2 650 y Fd(A)m(ttributes)n(:)227 796
y Fi(In)36 b(addition)f(to)h(those)f(attributes)g(common)g(to)g(all)h
@@ -140500,8 +140764,8 @@ b(Lik)n(ewise,)33 b(Julian)g(ep)r(o)r(c)n(hs)f(can)g(b)r(e)227
(ears.)44 b(Besselian)29 b(ep)r(o)r(c)n(h)i(are)e(alw)n(a)n(ys)g
(represen)n(ted)g(in)i(units)g(of)227 5693 y(\(tropical\))c(y)n(ears.)p
eop end
-%%Page: 562 572
-TeXDict begin 562 571 bop 0 52 a FF(562)2251 b Fy(D)91
+%%Page: 564 574
+TeXDict begin 564 573 bop 0 52 a FF(564)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)227 351 y Fi(The)k(TimeScale)e
(attribute)i(allo)n(ws)e(the)h(time)h(scale)e(to)h(b)r(e)h(sp)r
(eci\014ed)g(\(that)f(is,)i(the)e(ph)n(ysical)g(pro)r(cess)f(used)227
@@ -140570,8 +140834,8 @@ Fd(Constructor)32 b(F)-8 b(unction:)227 5391 y Fi(astTimeMap)27
b(\(also)g(see)g(astTimeAdd\))-2 5547 y Fd(Inheritance)n(:)227
5693 y Fi(The)h(TimeMap)f(class)g(inherits)h(from)f(the)h(Mapping)f
(class.)p eop end
-%%Page: 563 573
-TeXDict begin 563 572 bop 3643 52 a FF(563)-2 351 y Fd(A)m(ttributes)n
+%%Page: 565 575
+TeXDict begin 565 574 bop 3643 52 a FF(565)-2 351 y Fd(A)m(ttributes)n
(:)227 497 y Fi(The)32 b(TimeMap)f(class)g(do)r(es)g(not)g(de\014ne)h
(an)n(y)f(new)g(attributes)h(b)r(ey)n(ond)f(those)g(whic)n(h)g(are)g
(applicable)g(to)g(all)227 597 y(Mappings.)-2 746 y Fd(F)-8
@@ -140626,8 +140890,8 @@ b(The)30 b(Nin)h(and)g(Nout)g(attributes)f(of)h(a)f(UnitMap)227
b(UnitMap)h(class)e(do)r(es)h(not)g(de\014ne)h(an)n(y)e(new)h
(attributes)g(b)r(ey)n(ond)g(those)g(whic)n(h)g(are)f(applicable)h(to)g
(all)227 5693 y(Mappings.)p eop end
-%%Page: 564 574
-TeXDict begin 564 573 bop 0 52 a FF(564)2251 b Fy(D)91
+%%Page: 566 576
+TeXDict begin 566 575 bop 0 52 a FF(566)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)-2 351 y Fd(F)-8 b(unctions)n(:)227
497 y Fi(The)35 b(UnitMap)h(class)e(do)r(es)g(not)h(de\014ne)g(an)n(y)f
(new)h(functions)g(b)r(ey)n(ond)g(those)f(whic)n(h)h(are)f(applicable)g
@@ -140716,8 +140980,8 @@ b(FITS-W)n(CS)28 b(pro)5 b(jection)26 b(parameters)340
b(pro)5 b(jection)27 b(axes)340 5677 y Fh(\017)45 b Fi(WcsT)n(yp)r(e:)
37 b(FITS-W)n(CS)28 b(pro)5 b(jection)26 b(t)n(yp)r(e)p
eop end
-%%Page: 565 575
-TeXDict begin 565 574 bop 3643 52 a FF(565)-2 351 y Fd(F)-8
+%%Page: 567 577
+TeXDict begin 567 576 bop 3643 52 a FF(567)-2 351 y Fd(F)-8
b(unctions)n(:)227 497 y Fi(The)36 b(WcsMap)f(class)f(do)r(es)i(not)f
(de\014ne)h(an)n(y)e(new)i(functions)g(b)r(ey)n(ond)f(those)g(whic)n(h)
g(are)g(applicable)g(to)g(all)227 597 y(Mappings.)p 0
@@ -140775,8 +141039,8 @@ h(whic)n(h)g(case)e(no)i(sink)f(or)g(source)f(function)i(need)g(b)r(e)g
b(addition)f(to)g(those)g(attributes)h(common)f(to)g(all)g(Channels,)i
(ev)n(ery)d(XmlChan)i(also)e(has)h(the)h(follo)n(wing)227
5591 y(attributes:)p eop end
-%%Page: 566 576
-TeXDict begin 566 575 bop 0 52 a FF(566)2251 b Fy(D)91
+%%Page: 568 578
+TeXDict begin 568 577 bop 0 52 a FF(568)2251 b Fy(D)91
b(AST)30 b(CLASS)f(DESCRIPTIONS)340 351 y Fh(\017)45
b Fi(XmlF)-7 b(ormat:)37 b(System)28 b(for)f(formatting)g(Ob)5
b(jects)27 b(as)g(XML)340 484 y Fh(\017)45 b Fi(XmlLength:)38
@@ -140808,8 +141072,8 @@ y Fd(F)-8 b(unctions)n(:)227 3352 y Fi(The)32 b(Zo)r(omMap)g(class)f
(do)r(es)g(not)i(de\014ne)f(an)n(y)f(new)h(functions)h(b)r(ey)n(ond)f
(those)f(whic)n(h)h(are)f(applicable)h(to)g(all)227 3452
y(Mappings.)p eop end
-%%Page: 567 577
-TeXDict begin 567 576 bop 3643 52 a FF(567)0 351 y Fz(E)135
+%%Page: 569 579
+TeXDict begin 569 578 bop 3643 52 a FF(569)0 351 y Fz(E)135
b(UNIX)45 b(Command)g(Descriptions)0 594 y FF(The)35
b(commands)h(describ)s(ed)e(here)i(are)g(pro)m(vided)f(for)h(use)f
(from)g(the)h(UNIX)g(shell)g(to)h(assist)f(with)f(dev)m(el-)0
@@ -140896,8 +141160,8 @@ b(that)g(y)n(our)g(graphics)f(mo)r(dule)h(implemen)n(ts)h(the)g
y Fr(Or)f(the)f(equiv)l(alen)n(t)g(directory)g(if)i(AST)e(is)h
(installed)h(in)f(a)g(non-standard)f(lo)r(cation.)p eop
end
-%%Page: 568 578
-TeXDict begin 568 577 bop 0 52 a FF(568)1988 b Fy(E)91
+%%Page: 570 580
+TeXDict begin 570 579 bop 0 52 a FF(570)1988 b Fy(E)91
b(UNIX)30 b(COMMAND)i(DESCRIPTIONS)427 351 y Fi(this)e(switc)n(h)g
(will)g(cause)f(\\unresolv)n(ed)f(sym)n(b)r(ol")h(errors)e(to)j(o)r
(ccur)f(during)h(linking,)g(w)n(arning)e(y)n(ou)h(that)427
@@ -141001,8 +141265,8 @@ b(AL\).)p 0 5469 3780 12 v 0 5601 a Fz(ast)p Fb(_)p Fz(link)p
Fb(_)p Fz(adam)189 b Fe(Link)39 b(an)f(AD)m(AM)h(program)d(with)i(the)
1581 5715 y(AST)g(library)2948 5601 y Fz(ast)p Fb(_)p
Fz(link)p Fb(_)p Fz(adam)p eop end
-%%Page: 569 579
-TeXDict begin 569 578 bop 3643 52 a FF(569)0 351 y Fd(Description:)44
+%%Page: 571 581
+TeXDict begin 571 580 bop 3643 52 a FF(571)0 351 y Fd(Description:)44
b Fi(This)21 b(command)e(should)h(only)g(b)r(e)h(used)f(when)h
(building)f(Starlink)g(AD)n(AM)h(programs)d(whic)n(h)i(use)g(the)227
451 y(AST)29 b(library)-7 b(,)27 b(in)h(order)f(to)h(generate)f(the)i
@@ -141100,8 +141364,8 @@ r(ecify)g(ho)n(w)f(error)f(messages)g(pro)r(duced)427
(ha)n(v)n(e)g(imple-)427 5693 y(men)n(ted)34 b(an)f(in)n(terface)f(to)i
(a)e(new)i(error)d(deliv)n(ery)h(system)h(y)n(ourself)g(and)g(wish)g
(to)g(pro)n(vide)f(y)n(our)g(o)n(wn)p eop end
-%%Page: 570 580
-TeXDict begin 570 579 bop 0 52 a FF(570)1988 b Fy(E)91
+%%Page: 572 582
+TeXDict begin 572 581 bop 0 52 a FF(572)1988 b Fy(E)91
b(UNIX)30 b(COMMAND)i(DESCRIPTIONS)427 351 y Fi(argumen)n(ts)20
b(for)h(linking)g(with)h(it.)35 b(By)21 b(default,)i(error)c(messages)h
(are)g(deliv)n(ered)g(in)i(the)g(standard)e(AD)n(AM)427
@@ -141179,8 +141443,8 @@ Fi(-fsla)p Ft(")e Fi(and)h Ft(")p Fi(-csla)p Ft(")f Fi(\015ags)h
(\(previously)f(used)i(for)227 3947 y(selecting)h(whic)n(h)h(v)n
(ersion)e(of)i(SLALIB)f(to)h(use\))f(to)h(b)r(e)g(sp)r(eci\014ed,)g
(but)g(they)g(will)g(b)r(e)g(ignored.)p eop end
-%%Page: 571 581
-TeXDict begin 571 580 bop 3643 52 a FF(571)0 351 y Fz(F)134
+%%Page: 573 583
+TeXDict begin 573 582 bop 3643 52 a FF(573)0 351 y Fz(F)134
b(AST)44 b(Memory)h(Managemen)l(t)h(and)f(Utilit)l(y)i(F)-11
b(unctions)0 631 y FF(AST)24 b(pro)m(vides)h(a)g(memory)f(managemen)m
(t)i(la)m(y)m(er)h(that)e(can)g(b)s(e)f(used)g(in)g(place)i(of)f
@@ -141249,8 +141513,8 @@ b(alues)30 b(for)h(this)f(v)-5 b(ariable)31 b(are:)0
f(the)f(default)0 5313 y FD(DL)46 b FF(-)30 b(Doug)h(Lea's)g(mallo)s
(c/free)0 5538 y FD(GC)45 b FF(-)31 b(Hans-Bo)s(ehm)f(Garbage)i
(Collection)p eop end
-%%Page: 572 582
-TeXDict begin 572 581 bop 0 52 a FF(572)889 b Fy(F)91
+%%Page: 574 584
+TeXDict begin 574 583 bop 0 52 a FF(574)889 b Fy(F)91
b(AST)30 b(MEMOR)-8 b(Y)31 b(MANA)m(GEMENT)h(AND)f(UTILITY)e(FUNCTIONS)
p 0 351 3780 12 v 0 483 a Fz(astApp)t(endString)189 b
Fe(App)s(end)39 b(a)g(string)e(to)h(another)1411 598
@@ -141317,8 +141581,8 @@ y Fi(The)28 b(n)n(um)n(b)r(er)f(of)h(arra)n(y)d(elemen)n(ts)j(for)f
(whic)n(h)g(memory)g(is)g(to)h(b)r(e)g(allo)r(cated.)259
5577 y Fd(size)427 5677 y Fi(The)g(size)f(of)h(eac)n(h)f(arra)n(y)e
(elemen)n(t,)j(in)f(b)n(ytes.)p eop end
-%%Page: 573 583
-TeXDict begin 573 582 bop 3643 52 a FF(573)0 351 y Fd(Returned)32
+%%Page: 575 585
+TeXDict begin 575 584 bop 3643 52 a FF(575)0 351 y Fd(Returned)32
b(V)-8 b(alue:)259 478 y(astCallo)s(c\(\))427 577 y Fi(If)32
b(successful,)g(the)g(function)g(returns)f(a)g(p)r(oin)n(ter)g(to)h
(the)f(start)g(of)h(the)g(allo)r(cated)e(memory)h(region.)47
@@ -141379,8 +141643,8 @@ Ft(")g Fi(c)n(haracters)427 5637 y(will)28 b(b)r(e)g(copied)f(from)h
Ft(")p Fi(in)p Ft(")f Fi(to)g Ft(")p Fi(out)p Ft(")p
Fi(,)g(and)g(a)h(terminating)f(n)n(ull)h(c)n(haracter)d(will)j(then)g
(b)r(e)g(added.)p eop end
-%%Page: 574 584
-TeXDict begin 574 583 bop 0 52 a FF(574)889 b Fy(F)91
+%%Page: 576 586
+TeXDict begin 576 585 bop 0 52 a FF(576)889 b Fy(F)91
b(AST)30 b(MEMOR)-8 b(Y)31 b(MANA)m(GEMENT)h(AND)f(UTILITY)e(FUNCTIONS)
p 0 351 3780 12 v 0 483 a Fz(astChrLen)315 b Fe(Determine)38
b(the)g(used)i(length)d(of)i(a)f(string)313 b Fz(astChrLen)0
@@ -141429,8 +141693,8 @@ Fh(\003)p Ft(str1,)f(const)g(char)h Fh(\003)p Ft(str2,)f(size_t)g(n)j
y Fi(P)n(oin)n(ter)26 b(to)i(the)g(\014rst)f(string.)259
5593 y Fd(str2)427 5693 y Fi(P)n(oin)n(ter)f(to)i(the)g(second)f
(string.)p eop end
-%%Page: 575 585
-TeXDict begin 575 584 bop 3643 52 a FF(575)259 351 y
+%%Page: 577 587
+TeXDict begin 577 586 bop 3643 52 a FF(577)259 351 y
Fd(n)427 451 y Fi(Maxim)n(um)28 b(n)n(um)n(b)r(er)f(of)h(c)n(haracters)
d(to)i(compare.)0 612 y Fd(Returned)32 b(V)-8 b(alue:)259
747 y(astChrMatc)m(hN\(\))427 846 y Fi(Non-zero)26 b(if)i(the)g(t)n(w)n
@@ -141483,8 +141747,8 @@ Ft(n)h(\))0 5227 y Fd(P)m(arameters:)259 5362 y(str)427
5462 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(string)f(to)g(b)r(e)h(split.)
259 5593 y Fd(c)427 5693 y Fi(The)g(delimiter)g(c)n(haracter.)p
eop end
-%%Page: 576 586
-TeXDict begin 576 585 bop 0 52 a FF(576)889 b Fy(F)91
+%%Page: 578 588
+TeXDict begin 578 587 bop 0 52 a FF(578)889 b Fy(F)91
b(AST)30 b(MEMOR)-8 b(Y)31 b(MANA)m(GEMENT)h(AND)f(UTILITY)e(FUNCTIONS)
259 351 y Fd(n)427 451 y Fi(Address)e(of)h(an)f(in)n(t)h(in)g(whic)n(h)
f(to)h(return)f(the)h(n)n(um)n(b)r(er)f(of)h(w)n(ords)e(returned.)0
@@ -141555,8 +141819,8 @@ Fi(if)h(the)g(in)n(terv)n(ening)e(string)h(is)h(immaterial\).)340
(error)g(status)h(set)h(or)e(if)i(it)427 5642 y(should)i(fail)f(for)g
(an)n(y)g(reason,)f(or)h(if)h(the)g(supplied)g(string)f(con)n(tains)g
(no)g(w)n(ords.)p eop end
-%%Page: 577 587
-TeXDict begin 577 586 bop 3643 52 a FF(577)p 0 351 3780
+%%Page: 579 589
+TeXDict begin 579 588 bop 3643 52 a FF(579)p 0 351 3780
12 v 0 483 a Fz(astChrSub)163 b Fe(P)m(erforms)36 b(substitutions)h(on)
i(a)f(supplied)h(string)161 b Fz(astChrSub)0 669 y Fd(Description:)44
b Fi(This)30 b(function)g(c)n(hec)n(ks)e(a)h(supplied)g(test)h(string)f
@@ -141629,8 +141893,8 @@ h(\(except)h(for)f([dDsSwW]\).)340 5562 y Fh(\017)45
b(n)p Fi(d:)37 b(Matc)n(hes)27 b(a)g(single)g(digit.)340
5693 y Fh(\017)45 b(n)p Fi(D:)28 b(Matc)n(hes)f(an)n(ything)g(but)h(a)f
(single)g(digit.)p eop end
-%%Page: 578 588
-TeXDict begin 578 587 bop 0 52 a FF(578)889 b Fy(F)91
+%%Page: 580 590
+TeXDict begin 580 589 bop 0 52 a FF(580)889 b Fy(F)91
b(AST)30 b(MEMOR)-8 b(Y)31 b(MANA)m(GEMENT)h(AND)f(UTILITY)e(FUNCTIONS)
340 351 y Fh(\017)45 b(n)p Fi(w:)37 b(Matc)n(hes)27 b(an)n(y)f(alphan)n
(umeric)h(c)n(haracter,)f(and)h Ft("_")p Fi(.)340 483
@@ -141707,8 +141971,8 @@ b(alue)19 b(is)h(accepted)427 5577 y(\(without)36 b(error\))d(as)h
(indicating)h(that)g(no)f(memory)g(has)g(y)n(et)h(b)r(een)g(allo)r
(cated,)h(so)e(that)h(no)f(action)h(is)427 5677 y(required.)p
eop end
-%%Page: 579 589
-TeXDict begin 579 588 bop 3643 52 a FF(579)0 351 y Fd(Returned)32
+%%Page: 581 591
+TeXDict begin 581 590 bop 3643 52 a FF(581)0 351 y Fd(Returned)32
b(V)-8 b(alue:)259 487 y(astF)g(reeDouble\(\))427 586
y Fi(Alw)n(a)n(ys)27 b(returns)g(a)g(NULL)h(p)r(oin)n(ter.)p
0 784 3780 12 v 0 914 a Fz(astGro)l(w)847 915 y Fe(Allo)s(cate)37
@@ -141769,8 +142033,8 @@ Fd(Synopsis:)121 b Ft(int)42 b(astIsDynamic_\()c(const)k(void)f
Fh(\003)p Ft(ptr)h(\))0 5322 y Fd(P)m(arameters:)259
5458 y(ptr)427 5558 y Fi(P)n(oin)n(ter)26 b(to)i(test.)0
5718 y Fd(Returned)k(V)-8 b(alue:)p eop end
-%%Page: 580 590
-TeXDict begin 580 589 bop 0 52 a FF(580)889 b Fy(F)91
+%%Page: 582 592
+TeXDict begin 582 591 bop 0 52 a FF(582)889 b Fy(F)91
b(AST)30 b(MEMOR)-8 b(Y)31 b(MANA)m(GEMENT)h(AND)f(UTILITY)e(FUNCTIONS)
259 351 y Fd(astIsDynamic\(\))427 451 y Fi(Non-zero)g(if)i(the)f
(memory)g(w)n(as)f(allo)r(cated)h(dynamically)-7 b(.)44
@@ -141824,8 +142088,8 @@ b(is)f(left)h(unc)n(hanged.)0 5396 y Fd(Returned)k(V)-8
b(alue:)259 5530 y(astMemCac)m(hing\(\))427 5629 y Fi(The)28
b(original)e(v)-5 b(alue)27 b(of)h(the)g(MemoryCac)n(hing)e(tuning)h
(parameter.)p eop end
-%%Page: 581 591
-TeXDict begin 581 590 bop 3643 52 a FF(581)p 0 351 3780
+%%Page: 583 593
+TeXDict begin 583 592 bop 3643 52 a FF(583)p 0 351 3780
12 v 0 483 a Fz(astReallo)t(c)193 b Fe(Change)37 b(the)i(size)g(of)f(a)
h(dynamically)c(allo)s(cated)1441 598 y(region)i(of)i(memory)3176
483 y Fz(astReallo)t(c)0 808 y Fd(Description:)44 b Fi(This)24
@@ -141877,8 +142141,8 @@ b Ft(void)42 b(astRemoveLeading)o(Bl)o(ank)o(s\()37 b(char)42
b Fh(\003)p Ft(string)e(\))0 5358 y Fd(P)m(arameters:)259
5517 y(string)427 5616 y Fi(P)n(oin)n(ter)26 b(to)i(the)g(string.)p
eop end
-%%Page: 582 592
-TeXDict begin 582 591 bop 0 52 a FF(582)889 b Fy(F)91
+%%Page: 584 594
+TeXDict begin 584 593 bop 0 52 a FF(584)889 b Fy(F)91
b(AST)30 b(MEMOR)-8 b(Y)31 b(MANA)m(GEMENT)h(AND)f(UTILITY)e(FUNCTIONS)
p 0 351 3780 12 v 0 483 a Fz(astSizeOf)175 b Fe(Determine)37
b(the)i(size)g(of)f(a)h(dynamically)c(allo)s(cated)1441
@@ -141941,8 +142205,8 @@ b Fi(If)31 b(this)f(function)h(is)f(in)n(v)n(ok)n(ed)f(with)h(the)h
h(the)g(original)427 5641 y(p)r(oin)n(ter)d(v)-5 b(alue)28
b(is)f(returned)h(and)f(the)h(memory)f(con)n(ten)n(ts)g(are)f(unc)n
(hanged.)p eop end
-%%Page: 583 593
-TeXDict begin 583 592 bop 3643 52 a FF(583)p 0 351 3780
+%%Page: 585 595
+TeXDict begin 585 594 bop 3643 52 a FF(585)p 0 351 3780
12 v 0 483 a Fz(astString)196 b Fe(Create)37 b(a)h(C)h(string)e(from)h
(an)g(arra)m(y)f(of)h(c)m(haracters)193 b Fz(astString)0
676 y Fd(Description:)44 b Fi(This)30 b(function)g(allo)r(cates)f
@@ -142010,8 +142274,8 @@ b(ma)n(y)g(b)r(e)g(zero)f(but)i(should)427 5218 y(not)j(b)r(e)g
35 b(This)26 b(ma)n(y)e(b)r(e)i(zero)e(but)i(should)g(not)427
5552 y(b)r(e)i(negativ)n(e.)0 5718 y Fd(Returned)k(V)-8
b(alue:)p eop end
-%%Page: 584 594
-TeXDict begin 584 593 bop 0 52 a FF(584)889 b Fy(F)91
+%%Page: 586 596
+TeXDict begin 586 595 bop 0 52 a FF(586)889 b Fy(F)91
b(AST)30 b(MEMOR)-8 b(Y)31 b(MANA)m(GEMENT)h(AND)f(UTILITY)e(FUNCTIONS)
259 351 y Fd(astStringArra)m(y\(\))427 451 y Fi(A)f(p)r(oin)n(ter)e(to)
h(the)h(start)e(of)h(the)h(index)f(arra)n(y)-7 b(,)25
@@ -142055,8 +142319,8 @@ b(when)h(no)f(longer)f(needed.)0 3865 y Fd(Notes:)340
b(of)g(NULL)h(is)f(returned)g(if)h(this)g(function)g(is)f(in)n(v)n(ok)n
(ed)f(with)i(the)f(global)f(error)g(status)427 4247 y(set)f(or)f(if)h
(it)g(fails)f(for)g(an)n(y)g(reason.)p eop end
-%%Page: 585 595
-TeXDict begin 585 594 bop 3643 52 a FF(585)0 351 y Fz(G)134
+%%Page: 587 597
+TeXDict begin 587 596 bop 3643 52 a FF(587)0 351 y Fz(G)134
b(FITS-W)l(CS)44 b(Co)l(v)l(erage)0 605 y FF(This)32
b(app)s(endix)f(giv)m(es)i(details)h(of)e(the)h(FitsChan)f(class)h
(implemen)m(tation)h(of)f(the)f(con)m(v)m(en)m(tions)j(describ)s(ed)0
@@ -142143,8 +142407,8 @@ b(alue)27 b(has)f(b)s(een)g(set)h(explicitly)0 5693 y(for)i(the)g(axis)
h(Lab)s(el)f(attribute,)h(it)g(is)f(used)g(as)g(the)h(axis)f(commen)m
(t)i(\(except)f(that)g(an)m(y)f(existing)i(commen)m(ts)p
eop end
-%%Page: 586 596
-TeXDict begin 586 595 bop 0 52 a FF(586)2477 b Fy(G)91
+%%Page: 588 598
+TeXDict begin 588 597 bop 0 52 a FF(588)2477 b Fy(G)91
b(FITS-W)m(CS)30 b(CO)m(VERA)m(GE)p 0 853 3841 4 v -2
965 4 113 v 115 932 a FD(Keyw)m(ord)p 640 965 V 798 w(Read)p
2240 965 V 1352 w(W)-9 b(rite)p 3839 965 V 0 969 3841
@@ -142219,9 +142483,9 @@ Fx(ia)p 640 4808 V 254 w FF(Ignored.)p 2240 4808 V 1273
w(Not)g(used.)p 3839 4808 V 0 4811 3841 4 v 986 5086
a(T)-8 b(able)31 b(1:)41 b(Use)31 b(of)g(FITS-W)m(CS)f(P)m(ap)s(er)g(I)
g(k)m(eyw)m(ords)p eop end
-%%Page: 587 597
-TeXDict begin 587 596 bop 0 52 a Fy(G.1)92 b(P)m(ap)s(er)30
-b(I)g(-)h(General)g(Linear)f(Co)s(ordinates)1921 b FF(587)0
+%%Page: 589 599
+TeXDict begin 589 598 bop 0 52 a Fy(G.1)92 b(P)m(ap)s(er)30
+b(I)g(-)h(General)g(Linear)f(Co)s(ordinates)1921 b FF(589)0
351 y(in)33 b(the)g(FitsChan)h(tak)m(e)g(precedence)g(if)f(the)h(k)m
(eyw)m(ord)g(v)-5 b(alue)33 b(has)g(not)h(c)m(hanged\).)50
b(The)33 b(ab)s(o)m(v)m(e)i(pro)s(cedure)0 464 y(is)d(o)m(v)m
@@ -142298,8 +142562,8 @@ b(If)34 b(there)i(are)f(an)m(y)0 5693 y(other)23 b(F)-8
b(rames)24 b(presen)m(t)e(in)h(the)g(F)-8 b(rameSet,)25
b(an)e(attempt)h(is)f(made)f(to)i(create)g(a)f(complete)i(set)e(of)g
(\\alternate")p eop end
-%%Page: 588 598
-TeXDict begin 588 597 bop 0 52 a FF(588)2477 b Fy(G)91
+%%Page: 590 600
+TeXDict begin 590 599 bop 0 52 a FF(590)2477 b Fy(G)91
b(FITS-W)m(CS)30 b(CO)m(VERA)m(GE)0 351 y FF(set)j(of)f(k)m(eyw)m(ords)
h(describing)f(eac)m(h)i(additional)f(F)-8 b(rame.)48
b(The)32 b(\014rst)f(c)m(haracter)j(in)e(the)h(Iden)m(t)f(attribute)h
@@ -142370,9 +142634,9 @@ b(Consequen)m(tly)-8 b(,)29 b(if)f(a)g(F)-8 b(rameSet)29
b(is)f(read)g(from)f(a)h(FITS-)227 5693 y(W)m(CS)k(header)g(and)f(it)h
(is)g(subsequen)m(tly)g(written)f(out)h(to)h(a)f(new)g(FITS-W)m(CS)f
(header,)h(the)g(original)p eop end
-%%Page: 589 599
-TeXDict begin 589 598 bop 0 52 a Fy(G.2)92 b(P)m(ap)s(er)30
-b(I)s(I)g(-)g(Celestial)i(Co)s(ordinates)2140 b FF(589)p
+%%Page: 591 601
+TeXDict begin 591 600 bop 0 52 a Fy(G.2)92 b(P)m(ap)s(er)30
+b(I)s(I)g(-)g(Celestial)i(Co)s(ordinates)2140 b FF(591)p
0 853 3800 4 v -2 965 4 113 v 94 932 a FD(Keyw)m(ord)p
598 965 V 777 w(Read)p 2198 965 V 1352 w(W)-9 b(rite)p
3798 965 V 0 969 3800 4 v -2 1533 4 565 v 50 1048 a FF(CTYPE)p
@@ -142447,8 +142711,8 @@ b(TE-OBS)53 b(is)2249 4661 y(also)32 b(written\).)p 3798
4808 V 0 4811 3800 4 v 969 5086 a(T)-8 b(able)31 b(2:)41
b(Use)30 b(of)h(FITS-W)m(CS)f(P)m(ap)s(er)g(I)s(I)g(k)m(eyw)m(ords)p
eop end
-%%Page: 590 600
-TeXDict begin 590 599 bop 0 52 a FF(590)2477 b Fy(G)91
+%%Page: 592 602
+TeXDict begin 592 601 bop 0 52 a FF(592)2477 b Fy(G)91
b(FITS-W)m(CS)30 b(CO)m(VERA)m(GE)227 351 y FF(LONPOLE)i(and)h(LA)-8
b(TPOLE)33 b(v)-5 b(alues)33 b(will)h(usually)f(b)s(e)g(used)f(in)h
(the)h(new)e(header)h(\(the)h(exception)227 464 y(b)s(eing)h(if)g(the)g
@@ -142541,10 +142805,10 @@ b(basic)g(ZPN)f(pro)5 b(jection)31 b(b)m(y)e(including)h(\\lngcor")h
(or)f(\\latcor")i(terms.)40 b(These)30 b(are)g(supp)s(orted)d(if)227
5693 y(they)k(use)f(half)g(cross-terms,)h(in)f(either)h(simple)f(or)h
(Cheb)m(yshev)e(represen)m(tation.)p eop end
-%%Page: 591 601
-TeXDict begin 591 600 bop 0 52 a Fy(G.3)92 b(P)m(ap)s(er)30
+%%Page: 593 603
+TeXDict begin 593 602 bop 0 52 a Fy(G.3)92 b(P)m(ap)s(er)30
b(I)s(I)s(I)f(-)i(Sp)s(ectral)f(Co)s(ordinates)2117 b
-FF(591)136 351 y Fu(\017)46 b FF(The)37 b(IRAF)h(\\TNX")h(pro)5
+FF(593)136 351 y Fu(\017)46 b FF(The)37 b(IRAF)h(\\TNX")h(pro)5
b(jection)38 b(is)g(represen)m(ted)f(b)m(y)h(a)g(WcsMap)h(with)e(t)m
(yp)s(e)h(of)g(AST)p Fp(__)p FF(TPN)e(\(a)227 464 y(distorted)j(T)-8
b(AN)39 b(pro)5 b(jection)39 b(retained)g(within)e(the)i(WcsMap)g
@@ -142617,8 +142881,8 @@ s(ositiv)m(e)h(non-zero)g(v)-5 b(alue)39 b(then)f(an)m(y)i(Mapping)e
b(describ)s(ed)f(in)g(FITS-W)m(CS)g(pap)s(er)f(I)s(I)s(I.)g(If)h(the)h
(T)-8 b(abOK)30 b(attribute)h(is)f(to)h(zero)h(\(the)f(default\))f(or)p
eop end
-%%Page: 592 602
-TeXDict begin 592 601 bop 0 52 a FF(592)2477 b Fy(G)91
+%%Page: 594 604
+TeXDict begin 594 603 bop 0 52 a FF(594)2477 b Fy(G)91
b(FITS-W)m(CS)30 b(CO)m(VERA)m(GE)p 0 263 4002 4 v -2
376 4 113 v 196 342 a FD(Keyw)m(ord)p 801 376 V 877 w(Read)p
2400 376 V 1353 w(W)-9 b(rite)p 4000 376 V 0 379 4002
@@ -142726,9 +142990,9 @@ m(e)i(b)s(een)d(set)i(ex-)2452 6330 y(plicitly)-8 b(.)p
4000 6364 V 0 6367 4002 4 v 951 6642 a(T)g(able)31 b(3:)41
b(Use)31 b(of)f(FITS-W)m(CS)g(P)m(ap)s(er)g(I)s(I)s(I)f(k)m(eyw)m(ords)
p eop end
-%%Page: 593 603
-TeXDict begin 593 602 bop 0 52 a Fy(G.4)92 b(P)m(ap)s(er)30
-b(IV)g(-)h(Co)s(ordinate)f(Distortions)2044 b FF(593)0
+%%Page: 595 605
+TeXDict begin 595 604 bop 0 52 a Fy(G.4)92 b(P)m(ap)s(er)30
+b(IV)g(-)h(Co)s(ordinate)f(Distortions)2044 b FF(595)0
351 y(negativ)m(e)28 b(in)e(the)h(FitsChan,)g(then)f(the)g(write)h(op)s
(eration)f(will)h(b)s(e)e(unsuccessful)g(unless)h(one)g(of)h(the)f
(eaerlier)0 464 y(conditions)31 b(is)f(met.)702 431 y
@@ -142803,8 +143067,8 @@ b(algorithm)h(is)g(used,)g(the)f(p)r(ositiv)n(e)h(v)l(alue)f(of)h(the)f
(T)-6 b(abOK)24 b(attribute)g(is)h(used)f(as)h(the)f(table)h(v)n
(ersion)f(n)n(um)n(b)r(er)0 5693 y(\(the)h(EXTVER)g(header\))h(in)g
(the)f(asso)r(ciated)j(FITS)d(binary)g(table.)p eop end
-%%Page: 594 604
-TeXDict begin 594 603 bop 0 52 a FF(594)2016 b Fy(H)91
+%%Page: 596 606
+TeXDict begin 596 605 bop 0 52 a FF(596)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)0 351 y Fz(H)135
b(Changes)45 b(and)g(New)g(F)-11 b(eatures)0 598 y Fw(H.1)112
b(Changes)39 b(In)m(tro)s(duced)e(in)h(V1.1)0 811 y FF(The)26
@@ -142891,9 +143155,9 @@ b(to)g(the)f(in)m(ternal)h(functions)f(and)f(macros)i(used)e(b)m(y)h
(\014le.)62 b(This)37 b(is)g(for)g(the)h(b)s(ene\014t)e(of)227
5693 y(those)31 b(writing)g(\()p Fx(e.g.)p FF(\))40 b(new)30
b(graphics)g(in)m(terfaces)i(for)e(AST.)p eop end
-%%Page: 595 605
-TeXDict begin 595 604 bop 0 52 a Fy(H.2)92 b(Changes)30
-b(In)m(tro)s(duced)f(in)h(V1.2)2298 b FF(595)66 351 y(11.)46
+%%Page: 597 607
+TeXDict begin 597 606 bop 0 52 a Fy(H.2)92 b(Changes)30
+b(In)m(tro)s(duced)f(in)h(V1.2)2298 b FF(597)66 351 y(11.)46
b(A)28 b(problem)g(has)g(b)s(een)f(\014xed)g(whic)m(h)h(could)g(result)
g(when)f(using)h(astRead)h(to)g(read)f(FITS)f(headers)h(in)227
464 y(whic)m(h)j(the)h(CDEL)-8 b(T)31 b(v)-5 b(alue)31
@@ -142969,8 +143233,8 @@ s(oin)m(t)227 5507 y(n)m(um)m(b)s(ers.)111 5693 y(9.)j(The)22
b(FitsChan)h(class)g(is)f(no)m(w)h(more)f(toleran)m(t)j(of)d(common)h
(minor)f(violations)i(of)f(the)f(FITS)g(standard.)p eop
end
-%%Page: 596 606
-TeXDict begin 596 605 bop 0 52 a FF(596)2016 b Fy(H)91
+%%Page: 598 608
+TeXDict begin 598 607 bop 0 52 a FF(598)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)66 351 y FF(10.)46
b(The)f(FitsChan)g(class)g(no)m(w)g(incorp)s(orates)h(an)f(impro)m(v)m
(ed)g(test)h(for)f(the)g(linearit)m(y)h(of)f(Mappings,)227
@@ -143041,9 +143305,9 @@ b(,)44 b(this)d(w)m(as)g(accepted)h(without)f(error)g(and)f(a)h
(CmpF)-8 b(rames)39 b(con)m(tained)i(a)227 5693 y(relativ)m(ely)33
b(large)e(n)m(um)m(b)s(er)f(of)g(nested)g(F)-8 b(rames.)p
eop end
-%%Page: 597 607
-TeXDict begin 597 606 bop 0 52 a Fy(H.4)92 b(Changes)30
-b(In)m(tro)s(duced)f(in)h(V1.4)2298 b FF(597)111 351
+%%Page: 599 609
+TeXDict begin 599 608 bop 0 52 a Fy(H.4)92 b(Changes)30
+b(In)m(tro)s(duced)f(in)h(V1.4)2298 b FF(599)111 351
y(7.)46 b(F)-8 b(urther)35 b(impro)m(v)m(emen)m(ts)h(ha)m(v)m(e)g(b)s
(een)e(made)h(to)h(the)f(simpli\014cation)h(of)f(comp)s(ound)e
(Mappings,)j(in-)227 464 y(cluding)29 b(\014xes)g(for)g(sev)m(eral)i
@@ -143114,8 +143378,8 @@ b(FITS)e(\\ZPN")h(pro)5 b(jection)28 b(\(see)f(the)227
(classes)i(suc)m(h)e(as)227 5693 y(SkyF)-8 b(rame,)31
b(so)g(this)f(c)m(hange)i(only)e(facilitates)j(the)e(imp)s(ortation)g
(of)f(foreign)h(data.)p eop end
-%%Page: 598 608
-TeXDict begin 598 607 bop 0 52 a FF(598)2016 b Fy(H)91
+%%Page: 600 610
+TeXDict begin 600 609 bop 0 52 a FF(600)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FF(8.)46
b(A)35 b(bug)f(in)g(the)g(FitsChan)g(class)i(has)e(b)s(een)f(\014xed)h
(whic)m(h)g(could)h(result)f(in)g(longitude)h(v)-5 b(alues)35
@@ -143189,9 +143453,9 @@ m(en)m(tions)h(whic)m(h)e(w)m(ere)h(used)f(b)m(y)g(the)427
5580 y(existing)c(data)f(whic)m(h)f(use)g(these)g(con)m(v)m(en)m(tions)
j(to)e(b)s(e)e(read.)39 b(It)26 b(should)e(not)h(in)g(general)i(b)s(e)d
(used)427 5693 y(to)31 b(create)h(new)e(data.)p eop end
-%%Page: 599 609
-TeXDict begin 599 608 bop 0 52 a Fy(H.6)92 b(Changes)30
-b(In)m(tro)s(duced)f(in)h(V1.6)2298 b FF(599)227 351
+%%Page: 601 611
+TeXDict begin 601 610 bop 0 52 a Fy(H.6)92 b(Changes)30
+b(In)m(tro)s(duced)f(in)h(V1.6)2298 b FF(601)227 351
y FD(FITS-AIPS)45 b FF(This)26 b(enco)s(ding)g(is)h(based)f(on)g(the)h
(con)m(v)m(en)m(tions)h(describ)s(ed)e(in)g(the)g(do)s(cumen)m(t)h
(\\Non-)427 464 y(linear)d(Co)s(ordinate)g(Systems)g(in)f(AIPS")g(b)m
@@ -143273,8 +143537,8 @@ b(astMark)g(and)f(astP)m(olyCurv)m(e\))i(ha)m(v)m(e)f(b)s(een)227
5693 y(c)m(hanged)36 b(to)h(mak)m(e)f(them)f(easier)i(to)f(call)h(from)
e(C++.)55 b(P)m(arameters)36 b(whic)m(h)f(previously)g(had)g(t)m(yp)s
(e)p eop end
-%%Page: 600 610
-TeXDict begin 600 609 bop 0 52 a FF(600)2016 b Fy(H)91
+%%Page: 602 612
+TeXDict begin 602 611 bop 0 52 a FF(602)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)227 351 y FF(\\double)23
b(\(*\)[]")i(ha)m(v)m(e)f(b)s(een)e(c)m(hanged)h(to)h(the)f(simpler)f
(\\double)h(*".)39 b(Using)23 b(the)g(old)f(t)m(yp)s(es)h(ma)m(y)h
@@ -143362,9 +143626,9 @@ FF(BLOCKA)-10 b(VE)23 b(has)227 5467 y(b)s(een)36 b(added)f(to)i(the)g
(the)h(mean)g(of)g(the)g(input)f(pixels)i(in)e(a)i(b)s(o)m(x)f(cen)m
(tred)g(on)g(the)227 5693 y(output)30 b(pixel.)p eop
end
-%%Page: 601 611
-TeXDict begin 601 610 bop 0 52 a Fy(H.7)92 b(Changes)30
-b(In)m(tro)s(duced)f(in)h(V1.7)2298 b FF(601)66 351 y(13.)46
+%%Page: 603 613
+TeXDict begin 603 612 bop 0 52 a Fy(H.7)92 b(Changes)30
+b(In)m(tro)s(duced)f(in)h(V1.7)2298 b FF(603)66 351 y(13.)46
b(The)24 b(SkyF)-8 b(rame)25 b(class)h(can)e(no)m(w)h(b)s(e)f(used)g
(to)h(represen)m(t)f(an)h(arbitrary)f(spherical)h(co)s(ordinate)g
(system)227 464 y(b)m(y)31 b(setting)g(its)g(System)f(attribute)h(to)g
@@ -143444,8 +143708,8 @@ b(new)g(Plot)i(metho)s(d)e(allo)m(ws)j(an)e(application)h(to)f(o)m(v)m
(wing)e(temp)s(orary)f(c)m(hanges)h(to)f(b)s(e)f(made)227
5693 y(to)31 b(the)g(set)g(of)f(registered)i(graphics)e(routines.)p
eop end
-%%Page: 602 612
-TeXDict begin 602 611 bop 0 52 a FF(602)2016 b Fy(H)91
+%%Page: 604 614
+TeXDict begin 604 613 bop 0 52 a FF(604)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FF(7.)46
b(The)39 b(Dra)m(wAxes)i(attribute)f(of)g(the)g(Plot)g(class)h(can)f
(no)m(w)f(b)s(e)g(sp)s(eci\014ed)g(indep)s(endan)m(tly)g(for)g(eac)m(h)
@@ -143507,9 +143771,9 @@ b(j.c)44 b(and)g(w)m(cstrig.c)j(ha)m(v)m(e)f(b)s(een)e(renamed)g(to)h
(a)m(v)m(oid)i(name)d(clashes)i(with)227 5675 y(functions)30
b(in)g(more)h(recen)m(t)g(v)m(ersions)g(of)f(Mark)h(Calabretta's)h(w)m
(cslib)f(library)-8 b(.)p eop end
-%%Page: 603 613
-TeXDict begin 603 612 bop 0 52 a Fy(H.10)92 b(Changes)30
-b(In)m(tro)s(duced)g(in)g(V1.8-4)2177 b FF(603)0 351
+%%Page: 605 615
+TeXDict begin 605 614 bop 0 52 a Fy(H.10)92 b(Changes)30
+b(In)m(tro)s(duced)g(in)g(V1.8-4)2177 b FF(605)0 351
y Fw(H.10)112 b(Changes)39 b(In)m(tro)s(duced)e(in)h(V1.8-4)0
560 y FF(The)26 b(follo)m(wing)i(describ)s(es)d(the)i(most)f
(signi\014can)m(t)i(c)m(hanges)f(whic)m(h)f(o)s(ccurred)g(in)g(the)g
@@ -143581,8 +143845,8 @@ e(the)g(Mapping)g(represen)m(ted)g(b)m(y)f(the)h(Plot)h(w)m(as)f(a)g
b(In)31 b(this)i(example,)g(the)g(bug)f(caused)g(tic)m(k)i(marks)e(to)h
(b)s(e)f(dra)m(wn)g(at)227 5693 y(negativ)m(e)h(radius)c(v)-5
b(alues.)p eop end
-%%Page: 604 614
-TeXDict begin 604 613 bop 0 52 a FF(604)2016 b Fy(H)91
+%%Page: 606 616
+TeXDict begin 606 615 bop 0 52 a FF(606)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FF(4.)46
b(A)31 b(bug)e(has)h(b)s(een)g(\014xed)g(whic)m(h)g(could)g(prev)m(en)m
(t)h(attribute)g(settings)g(from)f(b)s(eing)g(read)g(correctly)i(b)m(y)
@@ -143650,9 +143914,9 @@ b(FitsChan)g(class)h(has)f(b)s(een)g(mo)s(di\014ed)f(to)i(only)f(use)g
(di\014ed)g(so)h(that)h(it)g(do)s(es)f(not)g(app)s(end)f(a)h(trailing)h
(\\Z")g(c)m(haracter)227 5693 y(to)h(the)g(end)f(of)g(D)m(A)-8
b(TE-OBS)31 b(k)m(eyw)m(ord)g(v)-5 b(alues.)p eop end
-%%Page: 605 615
-TeXDict begin 605 614 bop 0 52 a Fy(H.15)92 b(Changes)30
-b(In)m(tro)s(duced)g(in)g(V2.0)2252 b FF(605)111 351
+%%Page: 607 617
+TeXDict begin 607 616 bop 0 52 a Fy(H.15)92 b(Changes)30
+b(In)m(tro)s(duced)g(in)g(V2.0)2252 b FF(607)111 351
y(5.)46 b(The)e(FitsChan)g(class)h(has)f(b)s(een)g(mo)s(di\014ed)f(to)i
(use)f(latest)i(list)e(of)h(FITS-W)m(CS)f(pro)5 b(jections,)48
b(as)227 464 y(describ)s(ed)33 b(in)g(the)h(FITS-W)m(CS)f(pap)s(er)f(I)
@@ -143727,8 +143991,8 @@ b(enco)s(ding,)g(but)f(has)h(not)g(previously)f(b)s(een)g(p)s(ossible)h
(for)f(foreign)h(enco)s(dings.)45 b(The)227 5693 y(W)m(CSAXES)30
b(k)m(eyw)m(ord)h(is)g(used)e(to)i(store)g(the)g(n)m(um)m(b)s(er)e(of)h
(W)m(CS)h(axes)g(in)f(the)g(FITS)g(header.)p eop end
-%%Page: 606 616
-TeXDict begin 606 615 bop 0 52 a FF(606)2016 b Fy(H)91
+%%Page: 608 618
+TeXDict begin 608 617 bop 0 52 a FF(608)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FF(3.)46
b(Another)29 b(c)m(hange)g(to)h(the)e(astW)-8 b(rite)31
b(function)d(within)g(the)h(FitsChan)f(class)i(is)e(that)h(the)g
@@ -143834,9 +144098,9 @@ y(attribute)i(of)g(the)g(Sp)s(ecF)-8 b(rame,)36 b(whereas)e(the)g
(attribute)227 5693 y(without)33 b(an)f(axis)h(sp)s(eci\014er)f(will)g
(refer)g(to)h(the)g(System)f(attribute)h(of)g(the)f(CmpF)-8
b(rame)33 b(as)f(a)h(whole,)p eop end
-%%Page: 607 617
-TeXDict begin 607 616 bop 0 52 a Fy(H.16)92 b(Changes)30
-b(In)m(tro)s(duced)g(in)g(V3.0)2252 b FF(607)227 351
+%%Page: 609 619
+TeXDict begin 609 618 bop 0 52 a Fy(H.16)92 b(Changes)30
+b(In)m(tro)s(duced)g(in)g(V3.0)2252 b FF(609)227 351
y(since)27 b(System)g(is)g(an)f(attribute)i(of)e(all)i(F)-8
b(rames,)29 b(and)d(a)h(CmpF)-8 b(rame)26 b(is)h(a)g(F)-8
b(rame)28 b(and)e(so)h(has)f(its)h(o)m(wn)227 464 y(System)j(v)-5
@@ -143910,8 +144174,8 @@ y Fu(\017)46 b FF(The)31 b(n)m(um)m(b)s(er)g(of)g(W)m(CS)h(axes)g(is)f
(stored)h(in)f(the)h(W)m(CSAXES)f(k)m(eyw)m(ord)h(if)g(its)g(v)-5
b(alue)32 b(w)m(ould)f(b)s(e)427 5693 y(di\013eren)m(t)g(to)g(that)g
(of)g(the)f(NAXIS)g(k)m(eyw)m(ord.)p eop end
-%%Page: 608 618
-TeXDict begin 608 617 bop 0 52 a FF(608)2016 b Fy(H)91
+%%Page: 610 620
+TeXDict begin 610 619 bop 0 52 a FF(610)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)336 351 y Fu(\017)46
b FF(Helio-ecliptic)j(co)s(ordinates)c(are)g(no)m(w)g(supp)s(orted)e(b)
m(y)h(FitsChans)h(whic)m(h)f(use)h(FITS-W)m(CS)427 464
@@ -144004,9 +144268,9 @@ b(of)g(an)m(y)g(class)g(ma)m(y)g(no)m(w)g(include)f(an)h(optional)h
(attributes)f(whic)m(h)g(describ)s(e)f(a)i(prop)s(ert)m(y)e(of)h(the)h
(whole)f(F)-8 b(rame.)40 b(F)-8 b(or)26 b(instance,)p
eop end
-%%Page: 609 619
-TeXDict begin 609 618 bop 0 52 a Fy(H.17)92 b(Changes)30
-b(In)m(tro)s(duced)g(in)g(V3.1)2252 b FF(609)227 351
+%%Page: 611 621
+TeXDict begin 611 620 bop 0 52 a Fy(H.17)92 b(Changes)30
+b(In)m(tro)s(duced)g(in)g(V3.1)2252 b FF(611)227 351
y(the)39 b(Domain)h(attribute)g(ma)m(y)f(no)m(w)g(b)s(e)f(sp)s
(eci\014ed)h(as)g(\\Domain\(1\)")i(in)e(addition)g(to)h(the)f(simpler)
227 464 y(\\Domain".)61 b(In)35 b(cases)i(suc)m(h)f(as)h(this,)h(where)
@@ -144078,8 +144342,8 @@ b(In)m(tro)s(duced)e(in)h(V3.1)0 5203 y FF(The)f(follo)m(wing)h
b(of)g(a)g(new)f(class)h(called)h(XmlChan)e(-)h(a)g(Channel)e(whic)m(h)
i(reads)f(and)g(writes)h(AST)f(ob)5 b(jects)227 5693
y(in)30 b(the)h(form)f(of)g(XML.)p eop end
-%%Page: 610 620
-TeXDict begin 610 619 bop 0 52 a FF(610)2016 b Fy(H)91
+%%Page: 612 622
+TeXDict begin 612 621 bop 0 52 a FF(612)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FF(2.)46
b(A)30 b(bug)f(has)g(b)s(een)g(\014xed)g(in)g(the)g(Plot)i(class)f
(whic)m(h)f(could)h(cause)g(incorrect)g(graphical)h(attributes)f(to)227
@@ -144157,9 +144421,9 @@ g(graphics)f(escap)s(e)i(sequences)e(in)h(the)g(returned)227
(delimiter)g(c)m(haracters)i(b)s(eing)d(dra)m(wn)g(as)h(sup)s
(er-scripts)227 5693 y(when)k(plotted)h(as)f(n)m(umerical)h(axis)g(v)-5
b(alues)31 b(b)m(y)f(a)h(Plot.)p eop end
-%%Page: 611 621
-TeXDict begin 611 620 bop 0 52 a Fy(H.19)92 b(Changes)30
-b(In)m(tro)s(duced)g(in)g(V3.3)2252 b FF(611)66 351 y(10.)46
+%%Page: 613 623
+TeXDict begin 613 622 bop 0 52 a Fy(H.19)92 b(Changes)30
+b(In)m(tro)s(duced)g(in)g(V3.3)2252 b FF(613)66 351 y(10.)46
b(The)30 b(Plot)h(class)g(has)f(b)s(een)f(extended)h(to)h(include)f
(facilities)i(for)e(pro)s(ducing)f(logarithmic)j(axes.)41
b(See)227 464 y(attributes)31 b(LogPlot,)h(LogTic)m(ks,)g(LogGap)g(and)
@@ -144233,8 +144497,8 @@ b(FitsChan)f(class)i(whic)m(h)e(b)s(een)g(mo)s(di\014ed)g(to)h(in)m
(terpret)g(FITS-W)m(CS)g(CAR)f(pro)5 b(jection)30 b(headers)227
5693 y(correctly)i(if)e(the)h(longitude)g(reference)g(pixel)f
(\(CRPIX\))h(is)f(v)m(ery)h(large.)p eop end
-%%Page: 612 622
-TeXDict begin 612 621 bop 0 52 a FF(612)2016 b Fy(H)91
+%%Page: 614 624
+TeXDict begin 614 623 bop 0 52 a FF(614)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FF(4.)46
b(The)35 b(FITS-AIPS++)e(enco)s(ding)j(in)e(the)i(FitsChan)f(class)h
(no)m(w)f(recognised)h(sp)s(ectral)f(axes)h(if)f(they)227
@@ -144318,9 +144582,9 @@ b(This)33 b(is)h(a)g(sub-class)g(of)g(Sp)s(ecF)-8 b(rame)34
b(whic)m(h)227 5693 y(can)d(b)s(e)f(used)f(to)i(describ)s(e)f(sp)s
(ectral)h(axes)g(asso)s(ciated)h(with)e(dual)g(sideband)f(sp)s(ectral)i
(data.)p eop end
-%%Page: 613 623
-TeXDict begin 613 622 bop 0 52 a Fy(H.21)92 b(Changes)30
-b(In)m(tro)s(duced)g(in)g(V3.5)2252 b FF(613)111 351
+%%Page: 615 625
+TeXDict begin 615 624 bop 0 52 a Fy(H.21)92 b(Changes)30
+b(In)m(tro)s(duced)g(in)g(V3.5)2252 b FF(615)111 351
y(5.)46 b(The)d(FitsChan)g(class)i(will)e(no)m(w)h(read)f(headers)g
(whic)m(h)g(use)g(the)h(old)g(\\-GLS")g(pro)5 b(jection)44
b(co)s(de,)227 464 y(con)m(v)m(erting)d(them)f(to)g(the)f(corresp)s
@@ -144389,8 +144653,8 @@ g(this)g(metho)s(d)f(will)227 5337 y(need)i(to)i(b)s(e)d(c)m(hanged.)
(een)e(added)g(to)i(the)f(FitsChan)f(class)i(to)f(allo)m(w)h(v)-5
b(alues)27 b(for)g(named)227 5675 y(k)m(eyw)m(ords)k(to)g(b)s(e)f(c)m
(hanged)h(or)f(added.)p eop end
-%%Page: 614 624
-TeXDict begin 614 623 bop 0 52 a FF(614)2016 b Fy(H)91
+%%Page: 616 626
+TeXDict begin 616 625 bop 0 52 a FF(616)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)0 351 y Fw(H.22)112
b(Changes)39 b(In)m(tro)s(duced)e(in)h(V3.6)0 574 y FF(The)26
b(follo)m(wing)i(describ)s(es)d(the)i(most)f(signi\014can)m(t)i(c)m
@@ -144463,9 +144727,9 @@ b(supp)s(ort)d(for)i(reading)g(IV)m(O)m(A)h(Space-Time-Co)s(ordinates)g
(has)e(b)s(een)h(added.)39 b(Supp)s(ort)25 b(is)j(included)f(for)h(a)g
(subset)f(of)h(V1.20)h(of)f(the)227 5693 y(draft)i(STC)f(sp)s
(eci\014cation.)p eop end
-%%Page: 615 625
-TeXDict begin 615 624 bop 0 52 a Fy(H.25)92 b(Changes)30
-b(In)m(tro)s(duced)g(in)g(V4.1)2252 b FF(615)111 351
+%%Page: 617 627
+TeXDict begin 617 626 bop 0 52 a Fy(H.25)92 b(Changes)30
+b(In)m(tro)s(duced)g(in)g(V4.1)2252 b FF(617)111 351
y(2.)46 b(A)39 b(new)g(set)h(of)f(metho)s(ds)f(\(AST)p
Fp(_)p FF(REBIN<X>/astRebin<X>\))j(has)e(b)s(een)f(added)g(to)i(the)g
(Mapping)227 464 y(class.)e(These)20 b(are)h(\015ux-conserving)f
@@ -144534,8 +144798,8 @@ b(V4.1)g(and)f(V4.2:)111 5467 y(1.)46 b(The)41 b(SideBand)f(attribute)h
b(rame)36 b(to)h(represen)m(t)227 5693 y(the)31 b(o\013set)g(from)f
(the)h(lo)s(cal)g(oscillator)i(frequency)-8 b(,)31 b(rather)f(than)g
(either)h(of)f(the)h(t)m(w)m(o)h(sidebands.)p eop end
-%%Page: 616 626
-TeXDict begin 616 625 bop 0 52 a FF(616)2016 b Fy(H)91
+%%Page: 618 628
+TeXDict begin 618 627 bop 0 52 a FF(618)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FF(2.)46
b(The)37 b(FitsChan)g(class)h(has)g(b)s(een)e(c)m(hanged)i(so)g(that)g
(it)g(writes)f(out)h(a)g(VELOSYS)e(k)m(eyw)m(ord)h(when)227
@@ -144617,9 +144881,9 @@ e(in)h(V4.3)0 5580 y FF(The)26 b(follo)m(wing)i(describ)s(es)d(the)i
(most)f(signi\014can)m(t)i(c)m(hanges)f(whic)m(h)f(o)s(ccurred)g(in)g
(the)g(AST)g(library)g(b)s(et)m(w)m(een)0 5693 y(v)m(ersions)31
b(V4.2)g(and)f(V4.3:)p eop end
-%%Page: 617 627
-TeXDict begin 617 626 bop 0 52 a Fy(H.28)92 b(Changes)30
-b(In)m(tro)s(duced)g(in)g(V4.4)2252 b FF(617)111 351
+%%Page: 619 629
+TeXDict begin 619 628 bop 0 52 a Fy(H.28)92 b(Changes)30
+b(In)m(tro)s(duced)g(in)g(V4.4)2252 b FF(619)111 351
y(1.)46 b(The)32 b(astGetFitsS)j(function)d(no)m(w)g(strips)g(trailing)
i(white)e(space)i(from)e(the)g(returned)g(string,)h(if)f(the)227
464 y(original)g(string)e(con)m(tains)i(8)e(or)h(few)m(er)f(c)m
@@ -144704,8 +144968,8 @@ b(TimeF)-8 b(rame)40 b(class)h(no)m(w)f(supp)s(orts)d(con)m(v)m(ersion)
42 b(b)s(et)m(w)m(een)e(angle)h(based)e(timescales)j(suc)m(h)d(as)227
5693 y(UT1)31 b(and)f(atomic)i(based)e(timescales)i(suc)m(h)e(as)h
(UTC.)p eop end
-%%Page: 618 628
-TeXDict begin 618 627 bop 0 52 a FF(618)2016 b Fy(H)91
+%%Page: 620 630
+TeXDict begin 620 629 bop 0 52 a FF(620)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)0 351 y Fw(H.29)112
b(Changes)39 b(In)m(tro)s(duced)e(in)h(V4.5)0 576 y FF(The)31
b(follo)m(wing)h(describ)s(es)f(the)g(most)h(signi\014can)m(t)g(c)m
@@ -144782,9 +145046,9 @@ h(of)g(the)f(Plot.)47 b(Previously)32 b(Lab)s(elUp)g(w)m(as)g(only)h
b(A)31 b(bug)f(has)g(b)s(een)f(\014xed)h(that)h(could)f(segmen)m
(tation)j(violations)f(when)d(setting)j(attribute)f(v)-5
b(alues.)p eop end
-%%Page: 619 629
-TeXDict begin 619 628 bop 0 52 a Fy(H.30)92 b(Changes)30
-b(In)m(tro)s(duced)g(in)g(V4.6)2252 b FF(619)0 351 y
+%%Page: 621 631
+TeXDict begin 621 630 bop 0 52 a Fy(H.30)92 b(Changes)30
+b(In)m(tro)s(duced)g(in)g(V4.6)2252 b FF(621)0 351 y
Fw(H.30)112 b(Changes)39 b(In)m(tro)s(duced)e(in)h(V4.6)0
571 y FF(The)f(follo)m(wing)h(describ)s(es)f(the)g(most)h(signi\014can)
m(t)g(c)m(hanges)g(whic)m(h)f(ha)m(v)m(e)i(o)s(ccurred)d(in)h(the)g
@@ -144850,8 +145114,8 @@ f(b)s(e)f(used)g(to)h(de\014ne)f(the)227 5693 y(extrusion)e(axes.)42
b(Previously)-8 b(,)31 b(only)f(a)h(Bo)m(x)h(or)e(In)m(terv)-5
b(al)31 b(could)g(b)s(e)e(used)h(for)g(this)g(purp)s(ose.)p
eop end
-%%Page: 620 630
-TeXDict begin 620 629 bop 0 52 a FF(620)2016 b Fy(H)91
+%%Page: 622 632
+TeXDict begin 622 631 bop 0 52 a FF(622)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FF(3.)46
b(The)25 b(v)-5 b(alues)26 b(of)f(the)h(AST)p Fp(__)p
FF(THREADSAFE)e(macro)i(\(de\014ned)e(in)h(ast.h\))h(ha)m(v)m(e)g(b)s
@@ -144923,9 +145187,9 @@ b(In)m(tro)s(duced)e(in)h(V5.2)0 5580 y FF(The)26 b(follo)m(wing)i
(describ)s(es)d(the)i(most)f(signi\014can)m(t)i(c)m(hanges)f(whic)m(h)f
(o)s(ccurred)g(in)g(the)g(AST)g(library)g(b)s(et)m(w)m(een)0
5693 y(v)m(ersions)31 b(V5.1)g(and)f(V5.2:)p eop end
-%%Page: 621 631
-TeXDict begin 621 630 bop 0 52 a Fy(H.34)92 b(Changes)30
-b(In)m(tro)s(duced)g(in)g(V5.3)2252 b FF(621)111 351
+%%Page: 623 633
+TeXDict begin 623 632 bop 0 52 a Fy(H.34)92 b(Changes)30
+b(In)m(tro)s(duced)g(in)g(V5.3)2252 b FF(623)111 351
y(1.)46 b(A)26 b(new)f(metho)s(d)g(called)i(astSetFitsCM)g(has)f(b)s
(een)e(added)h(to)i(the)e(FitsChan)h(class.)40 b(It)25
b(stores)i(a)f(pure)227 464 y(commen)m(t)32 b(card)e(in)g(a)h(FitsChan)
@@ -145007,8 +145271,8 @@ FF(The)26 b(follo)m(wing)i(describ)s(es)d(the)i(most)f(signi\014can)m
(t)i(c)m(hanges)f(whic)m(h)f(o)s(ccurred)g(in)g(the)g(AST)g(library)g
(b)s(et)m(w)m(een)0 5693 y(v)m(ersions)31 b(V5.2)g(and)f(V5.3:)p
eop end
-%%Page: 622 632
-TeXDict begin 622 631 bop 0 52 a FF(622)2016 b Fy(H)91
+%%Page: 624 634
+TeXDict begin 624 633 bop 0 52 a FF(624)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FF(1.)46
b(The)e(details)h(of)g(ho)m(w)f(a)g(F)-8 b(rame)46 b(is)e(aligned)h
(with)f(another)g(F)-8 b(rame)45 b(b)m(y)f(the)h(astFindF)-8
@@ -145079,9 +145343,9 @@ b(bug)g(has)f(b)s(een)g(\014xed)g(in)h(the)g(astRebin\(Seq\))h(metho)s
(ignores)g(case)h(when)e(reading)h(STC-S)f(phrases)g(\(except)i(that)g
(units)227 5693 y(strings)30 b(are)h(still)h(case)f(sensitiv)m(e\).)p
eop end
-%%Page: 623 633
-TeXDict begin 623 632 bop 0 52 a Fy(H.36)92 b(Changes)30
-b(In)m(tro)s(duced)g(in)g(V5.3-2)2177 b FF(623)66 351
+%%Page: 625 635
+TeXDict begin 625 634 bop 0 52 a Fy(H.36)92 b(Changes)30
+b(In)m(tro)s(duced)g(in)g(V5.3-2)2177 b FF(625)66 351
y(10.)46 b(A)33 b(new)f(Mapping)g(metho)s(d,)h(astQuadAppro)m(x,)g(pro)
s(duces)e(a)i(quadratic)g(least-squares)h(\014t)e(to)i(a)f(2D)227
464 y(Mapping.)66 697 y(11.)46 b(A)29 b(new)g(Mapping)g(metho)s(d,)g
@@ -145139,8 +145403,8 @@ b(Access)32 b(to)f(KeyMaps)f(holding)h(thousands)e(of)h(en)m(tries)i
(is)e(no)m(w)g(signi\014can)m(tly)i(faster.)111 5670
y(6.)46 b(KeyMaps)31 b(can)f(no)m(w)h(hold)f(w)m(ord)g(\(i.e.)42
b(short)30 b(in)m(teger\))i(v)-5 b(alues.)p eop end
-%%Page: 624 634
-TeXDict begin 624 633 bop 0 52 a FF(624)2016 b Fy(H)91
+%%Page: 626 636
+TeXDict begin 626 635 bop 0 52 a FF(626)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)0 351 y Fw(H.37)112
b(Changes)39 b(In)m(tro)s(duced)e(in)h(V5.4-0)0 579 y
FF(The)26 b(follo)m(wing)i(describ)s(es)d(the)i(most)f(signi\014can)m
@@ -145204,9 +145468,9 @@ b(V5.5-0)h(and)e(V5.6-0:)111 5580 y(1.)46 b(New)29 b(functions)f
(Plot)g(class.)41 b(These)28 b(con)m(trol)h(the)227 5693
y(bu\013ering)h(of)g(graphical)i(output)e(pro)s(duced)e(b)m(y)j(other)f
(Plot)h(metho)s(ds.)p eop end
-%%Page: 625 635
-TeXDict begin 625 634 bop 0 52 a Fy(H.40)92 b(ChangesIn)m(tro)s(duced)
-29 b(in)i(V5.6-1)2207 b FF(625)111 351 y(2.)46 b(New)34
+%%Page: 627 637
+TeXDict begin 627 636 bop 0 52 a Fy(H.40)92 b(ChangesIn)m(tro)s(duced)
+29 b(in)i(V5.6-1)2207 b FF(627)111 351 y(2.)46 b(New)34
b(functions)g(astGBBuf)h(and)e(astGEBuf)i(ha)m(v)m(e)g(b)s(een)e(added)
g(to)i(the)f(in)m(terface)i(de\014ned)d(b)m(y)g(\014le)227
464 y Fp(grf.h)p FF(.)71 b(The)40 b(ast)p Fp(_)p FF(link)i(command)e
@@ -145275,8 +145539,8 @@ b(con)m(v)m(en)m(tion)h(included)d(in)g(an)h(early)g(draft)g(of)g
b(are)h(created)g(b)m(y)f(\(for)h(instance\))g(the)g(SCAMP)e(to)s(ol)j
(\(h)m(ttp://www.astromatic.net/soft)m(w)m(are/scamp\).)p
eop end
-%%Page: 626 636
-TeXDict begin 626 635 bop 0 52 a FF(626)2016 b Fy(H)91
+%%Page: 628 638
+TeXDict begin 628 637 bop 0 52 a FF(628)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FF(5.)46
b(The)28 b(P)m(olyMap)h(class)f(no)m(w)g(pro)m(vides)g(a)g(metho)s(d)f
(called)i(astP)m(olyT)-8 b(ran)30 b(that)e(adds)f(an)h(in)m(v)m(erse)g
@@ -145341,9 +145605,9 @@ b(The)39 b(FitsChan)h(class)g(has)g(a)g(new)f(read-only)h(attribute)g
(called)h(\\CardT)m(yp)s(e",)h(whic)m(h)d(holds)g(the)227
5693 y(data)31 b(t)m(yp)s(e)g(of)f(the)h(k)m(eyw)m(ord)g(v)-5
b(alue)31 b(for)f(the)g(curren)m(t)h(card.)p eop end
-%%Page: 627 637
-TeXDict begin 627 636 bop 0 52 a Fy(H.44)92 b(Changes)30
-b(In)m(tro)s(duced)g(in)g(V6.0)2252 b FF(627)111 351
+%%Page: 629 639
+TeXDict begin 629 638 bop 0 52 a Fy(H.44)92 b(Changes)30
+b(In)m(tro)s(duced)g(in)g(V6.0)2252 b FF(629)111 351
y(7.)46 b(The)38 b(FitsChan)g(class)h(has)f(a)h(new)f(metho)s(d)f
(astReadFits)j(whic)m(h)e(forces)h(the)g(FitsChan)f(to)h(reads)227
464 y(cards)30 b(from)g(the)h(asso)s(ciated)h(external)f(source)f(and)g
@@ -145403,8 +145667,8 @@ b(In)m(tro)s(duced)e(in)h(V7.0.0)0 5580 y FF(The)26 b(follo)m(wing)i
(o)s(ccurred)g(in)g(the)g(AST)g(library)g(b)s(et)m(w)m(een)0
5693 y(v)m(ersions)31 b(V6.0-1)h(and)e(V7.0.0:)p eop
end
-%%Page: 628 638
-TeXDict begin 628 637 bop 0 52 a FF(628)2016 b Fy(H)91
+%%Page: 630 640
+TeXDict begin 630 639 bop 0 52 a FF(630)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)111 351 y FF(1.)46
b(F)-8 b(undamen)m(tal)35 b(p)s(ositional)h(astronom)m(y)f
(calculations)h(are)f(no)m(w)f(p)s(erformed)f(using)h(the)g(IA)m(U)h
@@ -145460,9 +145724,9 @@ b(attribute)h(w)m(as)e(set)h(to)g(zero.)111 5562 y(5.)46
b(The)31 b(astResampleX)i(set)f(of)g(metho)s(ds)f(no)m(w)g(includes)g
(astResampleK)h(and)f(astResampleUK)i(that)227 5675 y(handles)d(64)h
(bit)g(in)m(teger)g(data.)p eop end
-%%Page: 629 639
-TeXDict begin 629 638 bop 0 52 a Fy(H.50)92 b(Changes)30
-b(In)m(tro)s(duced)g(in)g(V7.0.4)2182 b FF(629)0 351
+%%Page: 631 641
+TeXDict begin 631 640 bop 0 52 a Fy(H.50)92 b(Changes)30
+b(In)m(tro)s(duced)g(in)g(V7.0.4)2182 b FF(631)0 351
y Fw(H.50)112 b(Changes)39 b(In)m(tro)s(duced)e(in)h(V7.0.4)0
581 y FF(The)26 b(follo)m(wing)i(describ)s(es)d(the)i(most)f
(signi\014can)m(t)i(c)m(hanges)f(whic)m(h)f(o)s(ccurred)g(in)g(the)g
@@ -145517,8 +145781,8 @@ FF(ALLFRAMES)f(\015ag)i(is)f(supplied)f(for)h(the)227
5494 y("iframe")g(parameter.)111 5693 y(4.)46 b(The)30
b(astRate)i(metho)s(d)e(has)g(b)s(een)g(re-written)h(to)g(mak)m(e)g(it)
g(faster)g(and)e(more)i(reliable.)p eop end
-%%Page: 630 640
-TeXDict begin 630 639 bop 0 52 a FF(630)2016 b Fy(H)91
+%%Page: 632 642
+TeXDict begin 632 641 bop 0 52 a FF(632)2016 b Fy(H)91
b(CHANGES)31 b(AND)g(NEW)g(FEA)-8 b(TURES)0 351 y Fw(H.54)112
b(Changes)39 b(In)m(tro)s(duced)e(in)h(V7.1.1)0 573 y
FF(The)26 b(follo)m(wing)i(describ)s(es)d(the)i(most)f(signi\014can)m
@@ -145539,18 +145803,47 @@ b(rameSet)27 b(to)g(FITS-W)m(CS)e(headers)h(if)g(the)g(curren)m(t)g(F)
-8 b(rame)26 b(describ)s(es)f(generalised)227 1700 y(spherical)31
b(co)s(ordinates)g(\(i.e.)42 b(a)31 b(SkyF)-8 b(rame)30
b(with)g(System=Unkno)m(wn\).)0 1993 y Fw(H.55)112 b(Changes)39
-b(In)m(tro)s(duced)e(in)h(V7.2.0)0 2215 y FF(The)f(follo)m(wing)h
-(describ)s(es)f(the)g(most)h(signi\014can)m(t)g(c)m(hanges)g(whic)m(h)f
-(ha)m(v)m(e)i(o)s(ccurred)d(in)h(the)g(AST)g(library)0
-2328 y(b)s(et)m(w)m(een)31 b(v)m(ersions)g(V7.1.1)h(and)e(V7.2.0)i
-(\(the)f(curren)m(t)f(v)m(ersion\):)111 2590 y(1.)46
-b(A)37 b(new)f(metho)s(d)g(call)i(astMapDe\014ned)f(has)f(b)s(een)g
-(added)g(to)h(the)f(KeyMap)h(class.)60 b(It)37 b(c)m(hec)m(ks)h(if)e(a)
-227 2703 y(gtiv)m(en)c(k)m(ey)f(name)g(has)f(a)g(de\014ned)g(v)-5
-b(alue)30 b(in)g(a)h(giv)m(en)h(KeyMap.)0 2965 y(Programs)25
-b(whic)m(h)g(are)h(statically)h(link)m(ed)f(will)f(need)g(to)h(b)s(e)f
-(re-link)m(ed)g(in)g(order)g(to)h(tak)m(e)h(adv)-5 b(an)m(tage)27
-b(of)e(these)0 3078 y(new)30 b(facilities.)p eop end
+b(In)m(tro)s(duced)e(in)h(V7.2.0)0 2215 y FF(The)26 b(follo)m(wing)i
+(describ)s(es)d(the)i(most)f(signi\014can)m(t)i(c)m(hanges)f(whic)m(h)f
+(o)s(ccurred)g(in)g(the)g(AST)g(library)g(b)s(et)m(w)m(een)0
+2328 y(v)m(ersions)31 b(V7.1.1)h(and)e(V7.2.0:)111 2590
+y(1.)46 b(A)37 b(new)f(metho)s(d)g(call)i(astMapDe\014ned)f(has)f(b)s
+(een)g(added)g(to)h(the)f(KeyMap)h(class.)60 b(It)37
+b(c)m(hec)m(ks)h(if)e(a)227 2703 y(gtiv)m(en)c(k)m(ey)f(name)g(has)f(a)
+g(de\014ned)g(v)-5 b(alue)30 b(in)g(a)h(giv)m(en)h(KeyMap.)0
+2996 y Fw(H.56)112 b(Changes)39 b(In)m(tro)s(duced)e(in)h(V7.3.0)0
+3218 y FF(The)f(follo)m(wing)h(describ)s(es)f(the)g(most)h
+(signi\014can)m(t)g(c)m(hanges)g(whic)m(h)f(ha)m(v)m(e)i(o)s(ccurred)d
+(in)h(the)g(AST)g(library)0 3331 y(b)s(et)m(w)m(een)31
+b(v)m(ersions)g(V7.2.0)h(and)e(V7.3.0)i(\(the)f(curren)m(t)f(v)m
+(ersion\):)111 3593 y(1.)46 b(The)29 b(in)m(terface)i(for)f(the)f
+(astRebinSeq<X>)h(family)g(of)g(functions)f(has)g(b)s(een)g(c)m(hanged)
+h(in)f(order)g(to)i(al-)227 3706 y(lo)m(w)d(a)f(greater)h(n)m(um)m(b)s
+(er)d(of)i(pixels)g(to)h(b)s(e)e(pasted)g(in)m(to)i(the)f(output)f
+(arra)m(y)-8 b(.)41 b(The)26 b("n)m(used")h(parameter)227
+3819 y(is)42 b(no)m(w)g(a)g(p)s(oin)m(ter)g(to)g(a)g("in)m(t64)p
+Fp(_)p FF(t")j(v)-5 b(ariable,)45 b(instead)d(of)g(an)g("in)m(t".)76
+b(APPLICA)-8 b(TION)41 b(CODE)227 3932 y(SHOULD)49 b(BE)g(CHANGED)g(A)m
+(CCORDINGL)-8 b(Y)50 b(TO)e(A)-10 b(V)m(OID)49 b(SEGMENT)-8
+b(A)g(TION)49 b(F)-10 b(A)m(UL)i(TS)227 4045 y(AND)31
+b(OTHER)f(ERRA)-8 b(TIC)30 b(BEHA)-10 b(VIOUR.)111 4232
+y(2.)46 b(Added)39 b(a)h(new)f(facilit)m(y)j(to)e(the)g(F)-8
+b(rameSet)40 b(class)h(to)f(allo)m(w)h(eac)m(h)g(F)-8
+b(rame)40 b(to)h(b)s(e)e(asso)s(ciated)i(with)227 4345
+y(m)m(ultiple)j(Mappings,)j(an)m(y)d(one)f(of)h(whic)m(h)f(can)h(b)s(e)
+f(used)f(to)i(connect)h(the)e(F)-8 b(rame)44 b(to)h(the)e(other)227
+4458 y(F)-8 b(rames)38 b(in)e(the)i(F)-8 b(rameSet.)61
+b(The)36 b(c)m(hoice)j(of)e(whic)m(h)g(Mapping)g(to)g(use)g(is)g(con)m
+(trolled)h(b)m(y)f(the)g(new)227 4571 y(\\V)-8 b(arian)m(t")33
+b(attribute)e(of)g(the)f(F)-8 b(rameSet)32 b(class.)111
+4759 y(3.)46 b(Mappings)38 b(\(but)g(not)g(F)-8 b(rames\))39
+b(that)g(ha)m(v)m(e)g(a)f(v)-5 b(alue)38 b(set)h(for)f(their)g(Iden)m
+(t)g(attribute)g(are)h(no)m(w)f(left)227 4871 y(unc)m(hanged)30
+b(b)m(y)h(the)f(c)h(astSimplify)f(function.)40 b(f)31
+b(AST)p Fp(_)p FF(SIMPLIFY)e(routine.)0 5134 y(Programs)c(whic)m(h)g
+(are)h(statically)h(link)m(ed)f(will)f(need)g(to)h(b)s(e)f(re-link)m
+(ed)g(in)g(order)g(to)h(tak)m(e)h(adv)-5 b(an)m(tage)27
+b(of)e(these)0 5247 y(new)30 b(facilities.)p eop end
%%Trailer
userdict /end-hook known{end-hook}if
diff --git a/sun211.tex b/sun211.tex
index 874a3d5..f03b4ef 100644
--- a/sun211.tex
+++ b/sun211.tex
@@ -19,15 +19,15 @@
% Variable part - replace [xxx] as appropriate.
\newcommand{\stardocnumber} {211.27}
\newcommand{\stardocauthors} {R.F. Warren-Smith \& D.S. Berry}
-\newcommand{\stardocdate} {7th December 2012}
+\newcommand{\stardocdate} {29th April 2013}
\newcommand{\stardoctitle} {AST\\
A Library for Handling\\
World Coordinate Systems\\
in Astronomy}
-\newcommand{\stardoccopyright} {Copyright (C) 2012 Science \& Technology Facilities Council}
+\newcommand{\stardoccopyright} {Copyright (C) 2013 Science \& Technology Facilities Council}
\newcommand{\stardoctitlehtml} {AST - A Library for Handling World Coordinate
Systems in Astronomy}
-\newcommand{\stardocversion} {V7.2}
+\newcommand{\stardocversion} {V7.3}
\newcommand{\stardocmanual} {Programmer's Guide\\(C Version)}
\newcommand{\stardocmanualhtml}{Programmer's Guide (C Version)}
\newcommand{\stardocabstract} {
@@ -12673,6 +12673,66 @@ Object - Base class for all AST Objects
}
}
\sstroutine{
+ astAddVariant\sstlabel{astAddVariant}
+}{
+ Store a new variant Mapping for the current Frame in a FrameSet
+}{
+ \sstdescription{
+ This function
+ allows a new variant \htmlref{Mapping}{Mapping} to be stored with the current \htmlref{Frame}{Frame}
+ in a \htmlref{FrameSet}{FrameSet}. See the {\tt{"}}\htmlref{Variant}{Variant}{\tt{"}} attribute for more details. It can
+ also be used to rename the currently selected variant Mapping.
+ }
+ \sstsynopsis{
+ void astAddVariant( AstFrameSet $*$this, AstMapping $*$map,
+ const char $*$name, int $*$status )
+ }
+ \sstparameters{
+ \sstsubsection{
+ this
+ }{
+ Pointer to the FrameSet.
+ }
+ \sstsubsection{
+ map
+ }{
+ Pointer to a Mapping which describes how to convert
+ coordinates from the current Frame to the new variant of the
+ current Frame. If
+ NULL
+ is supplied, then the name associated with the currently selected
+ variant of the current Frame is set to the value supplied for
+ {\tt{"}}name{\tt{"}}, but no new variant is added.
+ }
+ \sstsubsection{
+ name
+ }{
+ The name to associate with the new variant Mapping (or the currently
+ selected variant Mapping if
+ {\tt{"}}map{\tt{"}} is NULL).
+ }
+ }
+ \sstnotes{
+ \sstitemlist{
+
+ \sstitem
+ The newly added Variant becomes the current variant on exit (this is
+ equivalent to setting the Variant attribute to the value supplied for
+ {\tt{"}}name).
+
+ \sstitem
+ An error is reported if a variant with the supplied name already
+ exists in the current Frame.
+
+ \sstitem
+ An error is reported if the current Frame is a mirror for the
+ variant Mappings in another Frame. This is only the case if the
+ \htmlref{astMirrorVariants}{astMirrorVariants} function
+ has been called to make the current Frame act as a mirror.
+ }
+ }
+}
+\sstroutine{
astAngle\sstlabel{astAngle}
}{
Calculate the angle subtended by two points at a third point
@@ -22899,6 +22959,79 @@ Object - Base class for all AST Objects
}
}
\sstroutine{
+ astMirrorVariants\sstlabel{astMirrorVariants}
+}{
+ Make the current Frame mirror the variant Mappings in another Frame
+}{
+ \sstdescription{
+ This function
+ indicates that all access to the \htmlref{Variant}{Variant} attribute of the current
+ \htmlref{Frame}{Frame} should should be forwarded to some other nominated Frame in
+ the \htmlref{FrameSet}{FrameSet}. For instance, if a value is set subsequently for the
+ Variant attribute of the current Frame, the current Frame will be left
+ unchanged and the setting is instead applied to the nominated Frame.
+ Likewise, if the value of the Variant attribute is requested, the
+ value returned is the value stored for the nominated Frame rather
+ than the current Frame itself.
+
+ This provides a mechanism for propagating the effects of variant
+ Mappings around a FrameSet. If a new Frame is added to a FrameSet
+ by connecting it to an pre-existing Frame that has two or more variant
+ Mappings, then it may be appropriate to set the new Frame so that it
+ mirrors the variants Mappings of the pre-existing Frame. If this is
+ done, then it will be possible to select a specific variant \htmlref{Mapping}{Mapping}
+ using either the pre-existing Frame or the new Frame.
+ }
+ \sstsynopsis{
+ void astMirrorVariants( AstFrameSet $*$this, int iframe, int $*$status )
+ }
+ \sstparameters{
+ \sstsubsection{
+ this
+ }{
+ Pointer to the FrameSet.
+ }
+ \sstsubsection{
+ iframe
+ }{
+ The index of the Frame within the FrameSet which is to be
+ mirrored by the current Frame. This value should lie in the range
+ from 1 to the number of Frames in the FrameSet (as given by its
+ \htmlref{Nframe}{Nframe} attribute). If AST\_\_NOFRAME is supplied (or the current
+ Frame is specified), then any mirroring established by a previous
+ call to this
+ function
+ is disabled.
+ }
+ }
+ \sstnotes{
+ \sstitemlist{
+
+ \sstitem
+ Mirrors can be chained. That is, if Frame B is set to be a mirror
+ of Frame A, and Frame C is set to be a mirror of Frame B, then
+ Frame C will act as a mirror of Frame A.
+
+ \sstitem
+ Variant Mappings cannot be added to the current Frame if it is
+ mirroring another Frame. So calls to the
+ \htmlref{astAddVariant}{astAddVariant} function
+ will cause an error to be reported if the current Frame is
+ mirroring another Frame.
+
+ \sstitem
+ A value of AST\_\_BASE may be given for the
+ {\tt{"}}iframe{\tt{"}} parameter
+ to specify the base Frame.
+
+ \sstitem
+ Any variant Mappings explicitly added to the current Frame using
+ astAddVariant
+ will be ignored if the current Frame is mirroring another Frame.
+ }
+ }
+}
+\sstroutine{
astNegate\sstlabel{astNegate}
}{
Negate the area represented by a Region
@@ -26504,7 +26637,7 @@ Object - Base class for all AST Objects
int ndim\_out, const int lbnd\_out[],
const int ubnd\_out[], const int lbnd[],
const int ubnd[], $<$Xtype$>$ out[], $<$Xtype$>$ out\_var[],
- double weights[], int $*$nused );
+ double weights[], int64\_t $*$nused );
}
\sstparameters{
\sstsubsection{
@@ -26817,7 +26950,7 @@ Object - Base class for all AST Objects
\sstsubsection{
nused
}{
- A pointer to an int containing the
+ A pointer to an int64\_t containing the
number of input data values that have been added into the output
array so far. The supplied value is incremented on exit by the
number of input values used. The value is initially set to zero
@@ -27076,6 +27209,11 @@ Object - Base class for all AST Objects
axes. To achieve this, a new Frame must be added to the FrameSet
(\htmlref{astAddFrame}{astAddFrame}) and the original one removed if necessary
(\htmlref{astRemoveFrame}{astRemoveFrame}).
+
+ \sstitem
+ Any variant Mappings associated with the remapped Frame (except
+ for the current variant) will be lost as a consequence of calling this
+ method (see attribute {\tt{"}}\htmlref{Variant}{Variant}{\tt{"}}).
}
}
}
@@ -29348,6 +29486,12 @@ Object - Base class for all AST Objects
\sstitemlist{
\sstitem
+ Mappings that have a set value for their \htmlref{Ident}{Ident} attribute are
+ left unchanged after simplification. This is so that their
+ individual identity is preserved. This restriction does not
+ apply to the simplification of Frames.
+
+ \sstitem
This function can safely be applied even to Mappings which
cannot be simplified. If no simplification is possible, it
behaves exactly like \htmlref{astClone}{astClone} and returns a pointer to the
@@ -34798,6 +34942,29 @@ Object - Base class for all AST Objects
}
}
\sstroutine{
+ AllVariants\sstlabel{AllVariants}
+}{
+ A list of the variant Mappings associated with the current Frame
+}{
+ \sstdescription{
+ This attrbute gives a space separated list of the names of all the
+ variant Mappings associated with the current \htmlref{Frame}{Frame} (see attribute
+ {\tt{"}}\htmlref{Variant}{Variant}{\tt{"}}). If the current Frame has no variant Mappings, then the
+ list will hold a single entry equal to the \htmlref{Domain}{Domain} name of the
+ current Frame.
+ }
+ \sstattributetype{
+ String, read-only.
+ }
+ \sstapplicability{
+ \sstsubsection{
+ \htmlref{FrameSet}{FrameSet}
+ }{
+ All FrameSets have this attribute.
+ }
+ }
+}
+\sstroutine{
AllWarnings\sstlabel{AllWarnings}
}{
A list of all currently available condition names
@@ -36304,7 +36471,7 @@ Object - Base class for all AST Objects
\sstitem
Otherwise, FITS-CLASS is used if the FitsChan contains a DELTAV
keyword and a keyword of the form VELO-xxx, where xxx indicates one
- of the rest frames used by class (e.g. {\tt{"}}VELO-LSR{\tt{"}}).
+ of the rest frames used by class (e.g. {\tt{"}}VELO-LSR{\tt{"}}), or {\tt{"}}VLSR{\tt{"}}.
\sstitem
Otherwise, if the FitsChan contains a CTYPE keyword which
@@ -43242,6 +43409,108 @@ Object - Base class for all AST Objects
}
}
\sstroutine{
+ Variant\sstlabel{Variant}
+}{
+ Indicates which variant of the current Frame is to be used
+}{
+ \sstdescription{
+ This attribute can be used to change the \htmlref{Mapping}{Mapping} that connects the
+ current \htmlref{Frame}{Frame} to the other Frames in the \htmlref{FrameSet}{FrameSet}. By default, each
+ Frame in a FrameSet is connected to the other Frames by a single
+ Mapping that can only be changed by using the
+ \htmlref{astRemapFrame}{astRemapFrame}
+ method. However, it is also possible to associate multiple Mappings
+ with a Frame, each Mapping having an identifying name. If this is
+ done, the {\tt{"}}Variant{\tt{"}} attribute can be set to indicate the name of
+ the Mapping that is to be used with the current Frame.
+
+ A possible (if unlikely) use-case is to create a FrameSet that can
+ be used to describe the WCS of an image formed by co-adding images
+ of two different parts of the sky. In such an image, each pixel contains
+ flux from two points on the sky.and so the WCS for the image should
+ ideally contain one pixel Frame and two SkyFrames - one describing
+ each of the two co-added images. There is nothing to prevent a
+ FrameSet containing two explicit SkyFrames, but the problem then arises
+ of how to distinguish between them. The two primary characteristics of
+ a Frame that distinguishes it from other Frames ar eits class and its
+ \htmlref{Domain}{Domain} attribute value. The class of a Frame cannot be changed, but we
+ could in principle use two different Domain values to distinguish the
+ two SkyFrames. However, in practice it is not uncommon for application
+ software to assume that SkyFrames will have the default Domain value
+ of {\tt{"}}SKY{\tt{"}}. That is, instead of searching for Frames that have a class
+ of {\tt{"}}\htmlref{SkyFrame}{SkyFrame}{\tt{"}}, such software searches for Frames that have a Domain
+ of {\tt{"}}SKY{\tt{"}}. To alleviate this problem, it is possible to add a single
+ SkyFrame to the FrameSet, but specifying two alternate Mappings to
+ use with the SkyFrame. Setting the {\tt{"}}Variant{\tt{"}} attribute to the name
+ of one or the other of these alternate Mappings will cause the
+ SkyFrame to be remapped within the FrameSet so that it uses the
+ specified Mapping. The same facility can be used with any class of
+ Frame, not just SkyFrames.
+
+ To use this facility, the Frame should first be added to the
+ FrameSet in the usual manner using the
+ \htmlref{astAddFrame}{astAddFrame} method. By default, the Mapping supplied to astAddFrame
+ is assigned a name equal to the Domain name of the Frame. To assign a
+ different name to it, the
+ \htmlref{astAddVariant}{astAddVariant}
+ method should then be called specifying the required name and a NULL
+ Mapping. The
+ astAddFrame
+ method should then be called repeatedly to add each required extra
+ Mapping to the current Frame, supplying a unique name for each one.
+
+ Each Frame in a FrameSet can have its own set of variant Mappings.
+ To control the Mappings in use with a specific Frame, you need first
+ to make it the current Frame in the FrameSet.
+
+ The
+ \htmlref{astMirrorVariants}{astMirrorVariants} function
+ allows the effects of variant Mappings associated with a nominated
+ Frame to be propagated to other Frames in the FrameSet.
+
+ Once this has been done, setting a new value for the {\tt{"}}Variant{\tt{"}}
+ attribute of a FrameSet will cause the current Frame in the
+ FrameSet to be remapped to use the specified variant Mapping. An
+ error will be reported if the current Frame has no variant Mapping
+ with the supplied name.
+
+ Getting the value of the {\tt{"}}Variant{\tt{"}} attribute will return the name
+ of the variant Mapping currently in use with the current Frame. If
+ the Frame has no variant Mappings, the value will default to the
+ Domain name of the current Frame.
+
+ Clearing the {\tt{"}}Variant{\tt{"}} attribute will have the effect of removing
+ all variant Mappings (except for the currently selected Mapping) from
+ the current Frame.
+
+ Testing the {\tt{"}}Variant{\tt{"}} attribute will return
+ a non-zero value
+ if the current Frame contains any variant Mappings, and
+ zero
+ otherwise.
+
+ A complete list of the names associated with all the available
+ variant Mappings in the current Frame can be obtained from the
+ \htmlref{AllVariants}{AllVariants} attribute.
+
+ If a Frame with variant Mappings is remapped using the
+ astRemapFrame
+ method, the currently selected variant Mapping is used by
+ astRemapFrame
+ and the other variant Mappings are removed from the Frame.
+ }
+ \sstattributetype{
+ String.
+ }
+ \sstapplicability{
+ \sstsubsection{
+ FrameSet
+ }{
+ All FrameSets have this attribute.
+ }
+ }
+}
+\sstroutine{
Warnings\sstlabel{Warnings}
}{
Controls the issuing of warnings about various conditions
@@ -44751,6 +45020,9 @@ Object - Base class for all AST Objects
\sstitemlist{
\sstitem
+ \htmlref{AllVariants}{AllVariants}: List of all variant mappings store with current Frame
+
+ \sstitem
\htmlref{Base}{Base}: FrameSet base Frame index
\sstitem
@@ -44759,6 +45031,9 @@ Object - Base class for all AST Objects
\sstitem
\htmlref{Nframe}{Nframe}: Number of Frames in a FrameSet
+ \sstitem
+ \htmlref{Variant}{Variant}: Name of variant mapping in use by current Frame
+
}
Every FrameSet also inherits any further attributes that belong
to its current Frame, regardless of that Frame's class. (For
@@ -44780,12 +45055,18 @@ Object - Base class for all AST Objects
system
\sstitem
+ \htmlref{astAddVariant}{astAddVariant}: Add a variant Mapping to the current Frame
+
+ \sstitem
\htmlref{astGetFrame}{astGetFrame}: Obtain a pointer to a specified Frame in a FrameSet
\sstitem
\htmlref{astGetMapping}{astGetMapping}: Obtain a Mapping between two Frames in a FrameSet
\sstitem
+ \htmlref{astMirrorVariants}{astMirrorVariants}: Make the current Frame mirror variant Mappings in another Frame
+
+ \sstitem
\htmlref{astRemapFrame}{astRemapFrame}: Modify a Frame's relationship to the other Frames in a
FrameSet
@@ -52527,12 +52808,10 @@ SkyFrame with \htmlref{System}{System}=Unknown).
\end{enumerate}
-\subsection{\xlabel{changes}\xlabel{list_of_most_recent_changes}Changes
-Introduced in V7.2.0}
+\subsection{Changes Introduced in V7.2.0}
-The following describes the most significant changes which have
-occurred in the AST library between versions V7.1.1 and V7.2.0 (the
-current version):
+The following describes the most significant changes which
+occurred in the AST library between versions V7.1.1 and V7.2.0:
\begin{enumerate}
@@ -52543,6 +52822,35 @@ a defined value in a given KeyMap.
\end{enumerate}
+\subsection{\xlabel{changes}\xlabel{list_of_most_recent_changes}Changes
+Introduced in V7.3.0}
+
+The following describes the most significant changes which have
+occurred in the AST library between versions V7.2.0 and V7.3.0 (the
+current version):
+
+\begin{enumerate}
+
+\item The interface for the astRebinSeq<X> family of functions has
+been changed in order to allow a greater number of pixels to be pasted
+into the output array. The "nused" parameter is now a pointer to a
+"int64\_t" variable, instead of an "int". APPLICATION CODE SHOULD BE
+CHANGED ACCORDINGLY TO AVOID SEGMENTATION FAULTS AND OTHER ERRATIC
+BEHAVIOUR.
+
+\item Added a new facility to the \htmlref{FrameSet}{FrameSet} class to allow each \htmlref{Frame}{Frame} to be
+associated with multiple Mappings, any one of which can be used to
+connect the Frame to the other Frames in the FrameSet. The choice of
+which \htmlref{Mapping}{Mapping} to use is controlled by the new ``\htmlref{Variant}{Variant}'' attribute of the
+FrameSet class.
+
+\item Mappings (but not Frames) that have a value set for their \htmlref{Ident}{Ident}
+attribute are now left unchanged by the
+c \htmlref{astSimplify}{astSimplify} function.
+f AST\_SIMPLIFY routine.
+
+\end{enumerate}
+
Programs which are statically linked will need to be re-linked in
order to take advantage of these new facilities.
diff --git a/version.h b/version.h
index 13e9f0c..ee1d81c 100644
--- a/version.h
+++ b/version.h
@@ -60,14 +60,14 @@
*-
*/
-/* The current version of AST is 7.2.0 */
+/* The current version of AST is 7.3.1 */
#define AST__VMAJOR 7
-#define AST__VMINOR 2
-#define AST__RELEASE 0
+#define AST__VMINOR 3
+#define AST__RELEASE 1
/* Deprecated macros */
#define AST_MAJOR_VERS 7
-#define AST_MINOR_VERS 2
-#define AST_RELEASE 0
+#define AST_MINOR_VERS 3
+#define AST_RELEASE 1
#endif /* #if ! defined(VERSION_INCLUDED) */
diff --git a/winmap.c b/winmap.c
index 18594ff..6e127fe 100644
--- a/winmap.c
+++ b/winmap.c
@@ -106,6 +106,9 @@ f The WinMap class does not define any new routines beyond those
* Correct initialisation of "result" in the Equal function.
* 19-JAN-2007 (DSB):
* Fix memory leak.
+* 3-MAY-2013 (DSB):
+* Improve simplification by adding check for inverse pairs of
+* WinMaps in function WinWin.
*class--
*/
@@ -3297,6 +3300,7 @@ static AstWinMap *WinWin( AstMapping *map1, AstMapping *map2, int inv1,
double *b0; /* Pointer to next scale term from WinMap 1 */
double *b1; /* Pointer to next scale term from WinMap 2 */
double *br; /* Pointer to next scale term in result */
+ int cancel; /* Do the two WinMaps cancel out? */
int i; /* Axis index */
int invert[ 2 ]; /* Array of invert flags */
int nin[ 2 ]; /* No. of axes in the two WinMaps */
@@ -3331,35 +3335,63 @@ static AstWinMap *WinWin( AstMapping *map1, AstMapping *map2, int inv1,
/* ====== */
if( series ){
-/* Merge the scale and shift terms for the two WinMaps, overwriting the
- terms for the first WinMap. To be merged in series, both WinMaps must
+/* Check for equal and opposite WinMaps. Do this explicitly using the
+ supplied Mappings rather than the values returned by astWinTerms to
+ avoid the affects of rounding error sin the inversions performed by
+ astWinTerms. */
+ if( ( inv1 == 0 ) != ( inv2 == 0 ) ) {
+ cancel = 1;
+ for( i = 0; i < nin[ 0 ]; i++ ){
+ if( !EQUAL( (wm1->a)[ i ], (wm2->a)[ i ] ) ||
+ !EQUAL( (wm1->b)[ i ], (wm2->b)[ i ] ) ) {
+ cancel = 0;
+ break;
+ }
+ }
+ } else {
+ cancel = 0;
+ }
+
+/* If they cancel, just put unit values into the WinMap. */
+ if( cancel ) {
+ a0 = a[ 0 ];
+ b0 = b[ 0 ];
+ for( i = 0; i < nin[ 0 ]; i++ ){
+ *(a0++) = 0.0;
+ *(b0++) = 1.0;
+ }
+
+/* Otherwise, merge the scale and shift terms for the two WinMaps, overwriting
+ the terms for the first WinMap. To be merged in series, both WinMaps must
have the same number of axes, so it matters not whether we use nin[ 0 ]
or nin[ 1 ] to specify the number of axes. */
- a0 = a[ 0 ];
- b0 = b[ 0 ];
- a1 = a[ 1 ];
- b1 = b[ 1 ];
- for( i = 0; i < nin[ 0 ]; i++ ){
+ } else {
+ a0 = a[ 0 ];
+ b0 = b[ 0 ];
+ a1 = a[ 1 ];
+ b1 = b[ 1 ];
+ for( i = 0; i < nin[ 0 ]; i++ ){
- if( *a0 != AST__BAD && *b0 != AST__BAD &&
- *a1 != AST__BAD && *b1 != AST__BAD ){
+ if( *a0 != AST__BAD && *b0 != AST__BAD &&
+ *a1 != AST__BAD && *b1 != AST__BAD ){
- *a0 *= (*b1);
- *a0 += (*a1);
- *b0 *= (*b1);
+ *a0 *= (*b1);
+ *a0 += (*a1);
+ *b0 *= (*b1);
- } else {
- *a0 = AST__BAD;
- *b0 = AST__BAD;
- *a1 = AST__BAD;
- *b1 = AST__BAD;
- }
+ } else {
+ *a0 = AST__BAD;
+ *b0 = AST__BAD;
+ *a1 = AST__BAD;
+ *b1 = AST__BAD;
+ }
- /* Move on to the next axis. */
- a0++;
- b0++;
- a1++;
- b1++;
+/* Move on to the next axis. */
+ a0++;
+ b0++;
+ a1++;
+ b1++;
+ }
}
/* Create the merged WinMap with unspecified corners. */
--
Handle World Coordinate Systems in Astronomy
More information about the debian-science-commits
mailing list