- ←Prev
- AST
A Library for Handling
World Coordinate Systems
in Astronomy - Next→
- TOC ↑
Description:
This
routine returns the upper and lower limits of a box which just encompasses the supplied
Region. The limits are returned as axis values within the
Frame represented by the Region.
The value of the
Negated attribute is ignored (i.e. it is assumed that the Region has not
been negated).
Invocation
CALL AST_GETREGIONBOUNDS( THIS, LBND, UBND, STATUS )
Arguments
THIS = INTEGER (Given)
Pointer to the Region.
LBND() = DOUBLE
PRECISION (Returned)
An array in which to return the lower axis bounds covered by
the Region. It should have at least as many elements as there are axes in the Region. If an
axis has no lower limit, the returned value will be the largest possible negative value.
UBND() = DOUBLE PRECISION (Returned)
An array in which to return the upper axis
bounds covered by the Region. It should have at least as many elements as there are axes in
the Region. If an axis has no upper limit, the returned value will be the largest possible
positive value.
STATUS = INTEGER (Given and Returned)
The global status.
Notes:
-
The value of the Negated attribute is ignored (i.e. it is assumed that the Region has not been
negated).
-
If an axis has no extent on an axis then the lower limit will be returned larger than the upper limit.
Note, this is different to an axis which has a constant value (in which case both lower and upper limit
will be returned set to the constant value).
-
If the bounds on an axis cannot be determined, AST__BAD is returned for both upper and lower
bounds
Copyright (C) 2021 East Asian Observatory
- ←Prev
- AST
A Library for Handling
World Coordinate
Systems
in Astronomy - Next→
- TOC ↑