This function allows the user to select those records within a point whose field values are within a given range. (For the current version of this routine, the field must have one of the following HDF data types: 22, 24, 5, 6) This function may be called after EOS_PT_DEFBOXREGION or EOS_PT_DEFTIMEPERIOD to provide both geographic or time and vertical subsetting. In this case the user provides the id from the previous subset call. (This same id is then returned by the function.) This routine may also be called stand-alone by setting the input id to (–1).
This function may be called up to eight times with the same region ID. In this way a region can be subsetted along a number of dimensions.
The EOS_PT_REGIONINFO and EOS_PT_EXTRACTREGION functions work as before, however, because there is no mapping performed between geolocation dimensions and data dimensions for the field to be subsetted, (the field specified in the call to EOS_PT_REGIONINFO and EOS_PT_EXTRACTREGION) must contain the dimension used explicitly in the call to EOS_PT_DEFVRTREGION (case 1) or the dimension of the one-dimensional field (case 2).
Suppose we wish to find those records within a point whose Rainfall values fall between 1 and 2. We wish to search all the records within the point, so we set the input region ID to (–1):
range = [1.,2.]
regionID = EOS_PT_DEFVRTREGION(pointID, -1, "Rainfall", range)
range = [22.,24.]
regionID = EOS_PT_DEFVRTREGION(pointID, regionID, $
The subsetted region referred to by regionID will now contain those records whose Rainfall field are between 1 and 2 and whose Temperature field are between 22 and 24.
Result = EOS_PT_DEFVRTREGION( pointID, regionID, vertObj, range)
Returns the point region ID if successful and FAIL (–1) otherwise.
Point id (long) returned by EOS_PT_CREATE or EOS_PT_ATTACH.
Region or period id (long) returned from a previous subset call.
String name of a dimension or field by which to subset.
Minimum and maximum range for the subset (double, 2 element, 1-D array).