This function defines an area of interest for a point. It returns a point region ID which is used by the EOS_PT_EXTRACTREGION routine to read the fields from a level for those records within the area of interest.The point structure must have a level with both a Longitude and Latitude (or Colatitude) field defined.
Examples
In this example, we define an area of interest with (opposite) corners at –145 degrees longitude, –15 degrees latitude and –135 degrees longitude, –8 degrees latitude:
cornerlon = dblarr (2)
cornerlat = dblarr (2)
cornerlon[0] = -145.
cornerlat[0] = -15.
cornerlon[1] = -135.
cornerlat[1] = -8.
regionID = EOS_PT_DEFBOXREGION(pointID, cornerlon, cornerlat)
Syntax
Result = EOS_PT_DEFBOXREGION(pointID, cornerlon, cornerlat)
Return Value
Returns the point regionID if successful and FAIL (–1) otherwise.
Arguments
pointID
Point id (long) returned by EOS_PT_CREATE or EOS_PT_ATTACH.
cornerlon
Longitude (double) in decimal degrees of box corners (2 element, 1-D array).
cornerlat
Latitude (double) in decimal degrees of box corners (2 element, 1-D array).
Keywords
None
Version History