AST_ADDMOCSTRING

Adds a JSON or string-encoded MOC into an existing Moc

Description:

This function modifies a Moc by combining it with the MOC described by the supplied string - assumed to be encoded using either the string or JSON serialisation described in the MOC recommendation. The way in which they are combined is determined by the CMODE parameter.

Invocation

CALL AST_ADDMOCSTRING( THIS, CMODE, NEGATE, MAXORDER, LEN, STRING, JSON, STATUS )

Arguments

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

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

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

NEGATE = LOGICAL (Given)
If .FALSE., the cells added to the existing Moc will be those included in the supplied MOC. If .TRUE., the cells added to the existing Moc will be those not included in the supplied MOC.
MAXORDER = INTEGER (Given)
The maximum HEALPix order to use. If a negative value is supplied, the maximum order will be determined by searching the supplied MOC (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 supplied MOC that refer to an order greater than MAXORDER are ignored.
LEN = INTEGER (Given)
The number of characters to read from the supplied string. If this is greater than the length of the string, it is ignored and the whole string is read.
STRING = CHARACTER ( ) (Given)
The array of characters holding the supplied MOC. It should be encoded using either the string or JSON serialisation described in the MOC recommendation. The used serialisation is determined from the first non-blank character, which should be either a curly brace ( { - JSON serialisation) or a digit (string serialisation).
JSON = LOGICAL (Returned)
A boolean flag indicating if the supplied string was interpreted using the JSON (.TRUE.) or string (.FALSE.) serialisation.
STATUS = INTEGER (Given and Returned)
The global status.

Notes: