B Classified list of Routines

 B.1 Access to Existing Arrays
 B.2 Enquiring Array Attributes
 B.3 Creating and Deleting Arrays
 B.4 Setting Array Attributes
 B.5 Access to Array Values
 B.6 Creation and Control of Identifiers
 B.7 Message System Routines
 B.8 Creating Placeholders
 B.9 Copying Arrays
 B.10 Miscellaneous

B.1 Access to Existing Arrays

ARY_FIND( LOC, NAME, IARY, STATUS )
    Find an array in an HDS structure and import it into the ARY_ system

ARY_IMPRT( LOC, IARY, STATUS )
    Import an array into the ARY_ system from HDS

B.2 Enquiring Array Attributes

ARY_BAD( IARY, CHECK, BAD, STATUS )
    Determine if an array may contain bad pixels

ARY_BOUND( IARY, NDIMX, LBND, UBND, NDIM, STATUS )
    Enquire the pixel-index bounds of an array

ARY_CMPLX( IARY, CMPLX, STATUS )
    Determine whether an array holds complex values

ARY_DIM(K)( IARY, NDIMX, DIM, NDIM, STATUS )
    Enquire the dimension sizes of an array

ARY_FORM( IARY, FORM, STATUS )
    Obtain the storage form of an array

ARY_FTYPE( IARY, FTYPE, STATUS )
    Obtain the full data type of an array

ARY_ISACC( IARY, ACCESS, ISACC, STATUS )
    Determine whether a specified type of array access is available

ARY_ISMAP( IARY, MAPPED, STATUS )
    Determine if an array is currently mapped

ARY_ISBAS( IARY, BASE, STATUS )
    Enquire if an array is a base array

ARY_ISTMP( IARY, TEMP, STATUS )
    Determine if an array is temporary

ARY_NDIM( IARY, NDIM, STATUS )
    Enquire the dimensionality of an array

ARY_OFFS(K)( IARY1, IARY2, MXOFFS, OFFS, STATUS )
    Obtain the pixel offset between two arrays

ARY_SAME( IARY1, IARY2, SAME, ISECT, STATUS )
    Enquire if two arrays are part of the same base array

ARY_SIZE(K)( IARY, NPIX, STATUS )
    Determine the size of an array

ARY_STATE( IARY, STATE, STATUS )
    Determine the state of an array (defined or undefined)

ARY_TYPE( IARY, TYPE, STATUS )
    Obtain the numeric type of an array

ARY_VALID( IARY, VALID, STATUS )
    Determine whether an array identifier is valid

ARY_VERFY( IARY, STATUS )
    Verify that an array’s data structure is correctly constructed

B.3 Creating and Deleting Arrays

ARY_DELET( IARY, STATUS )
    Delete an array

ARY_DUPE( IARY1, PLACE, IARY2, STATUS )
    Duplicate an array

ARY_NEW(K)( FTYPE, NDIM, LBND, UBND, PLACE, IARY, STATUS )
    Create a new simple array

ARY_NEWP(K)( FTYPE, NDIM, UBND, PLACE, IARY, STATUS )
    Create a new primitive array

B.4 Setting Array Attributes

ARY_NOACC( ACCESS, IARY, STATUS )
    Disable a specified type of access to an array

ARY_RESET( IARY, STATUS )
    Reset an array to an undefined state

ARY_SBAD( BAD, IARY, STATUS )
    Set the bad-pixel flag for an array

ARY_SHIFT(K)( NSHIFT, SHIFT, IARY, STATUS )
    Apply pixel-index shifts to an array

ARY_STYPE( FTYPE, IARY, STATUS )
    Set a new type for an array

B.5 Access to Array Values

ARY_MAP(K)( IARY, TYPE, MMOD, PNTR, EL, STATUS )
    Obtain mapped access to an array

ARY_MAPZ(K)( IARY, TYPE, MMOD, RPNTR, IPNTR, EL, STATUS )
    Obtain complex mapped access to an array

ARY_UNMAP( IARY, STATUS )
    Unmap an array

B.6 Creation and Control of Identifiers

ARY_ANNUL( IARY, STATUS )
    Annul an array identifier

ARY_BASE( IARY1, IARY2, STATUS )
    Obtain an identifier for a base array

ARY_CLONE( IARY1, IARY2, STATUS )
    Clone an array identifier

ARY_SECT(K)( IARY1, NDIM, LBND, UBND, IARY2, STATUS )
    Create an array section

ARY_SSECT( IARY1, IARY2, IARY3, STATUS )
    Produce a similar array section to an existing one

ARY_VALID( IARY, VALID, STATUS )
    Determine whether an array identifier is valid

B.7 Message System Routines

ARY_MSG( TOKEN, IARY )
    Assign the name of an array to a message token

B.8 Creating Placeholders

ARY_PLACE( LOC, NAME, PLACE, STATUS )
    Obtain an array placeholder

ARY_TEMP( PLACE, STATUS )
    Obtain a placeholder for a temporary array

B.9 Copying Arrays

ARY_COPY( IARY1, PLACE, IARY2, STATUS )
    Copy an array to a new location

ARY_DUPE( IARY1, PLACE, IARY2, STATUS )
    Duplicate an array

B.10 Miscellaneous

ARY_TRACE( NEWFLG, OLDFLG )
    Set the internal ARY_ system error-tracing flag