AST_ADDMOCDATA

Adds a FITS binary table into an existing Moc

Description:

This function modifies a Moc by combining it with a binary data array describing a MOC read from a FITS binary table. The way in which they are combined is determined by the CMODE parameter.

Invocation

CALL AST_ADDMOCDATA( THIS, CMODE, NEGATE, MAXORDER, LEN, NBYTE, DATA, STATUS )

Arguments

THIS = INTEGER (Given)
Pointer to the Moc to be modified.
CMODE = INTEGER (Given)
Indicates how the Moc and data are to be combined. Any of the following values may be supplied:
  • AST__AND: The modified Moc is the intersection of the original Moc and the data.

  • AST__OR: The modified Moc is the union of the original Moc and the data.

  • AST__XOR: The modified Moc is the exclusive disjunction of the original Moc and the data.

NEGATE = LOGICAL (Given)
If .FALSE., the cells added to the Moc will be those included in the supplied data array. If .TRUE., the cells added to the Moc will be those not included in the supplied data array.
MAXORDER = INTEGER (Given)
The maximum HEALPix order to use. If a negative value is supplied, the maximum order will be determined by searching the data array (this will take extra time). In either case, if a value has already been set for the MaxOrder attribute in the Moc, then the attribute value is used in preference to the value supplied for this parameter. Any HEALPix cells in the data array that refer to an order greater than MAXORDER are ignored.
LEN = INTEGER (Given)
The length of the supplied array (i.e. the number of 4 or 8 byte integer values it contains). Note, this class only supports binary MOCs with lengths that can be represented in a 4 byte signed integer.
NBYTE = INTEGER (Given)
The number of bytes in each integer value stored in the supplied array. Must be 4 or 8.
DATA( ) = BYTE (Given)
The data array holding a description of a MOC in the form used by FITS binary tables. See the IVOA MOC recommendation for details. The values in this array are signed integers, each with the number of bytes specified by parameter NBYTE. The number of bytes in this array should be at least LENNBYTE.
STATUS = INTEGER (Given and Returned)
The global status.

Notes: