NEAREST returns the closest table value for a given reference value
Syntax
- NEAREST(Pno%, Ndim%, "ColLab$_1",.., "ColLab$_Ndim%", Xint, Dir%)
- NEAREST(0, Npoints%, x_1, y_1, x_2, y_2,..., Limit, Dir%)
- NEAREST(@ObjFn(..), Ndim%, @ObjColPar_1,.., @ObjColPar_Ndim%, Xint, Dir%)
- NEAREST(Telitab$, Ndim%, "ColLab$_1",.., "ColLab$_Ndim%", Xint, Dir%)
Arguments
- Pno% is the number that refers to the TeLiTab sets in the Data slot. Pno% should be an integer value or a parameter which is assigned an integer value and is the number of theTeLiTab set in the expressions' data slot.
- Npoints% is the number of points (x,y) that are given in direct definition.
- @ObjFn() refers to the Object from which data will be used.
- TeLiTab$ refers to the string parameter that contains the TeLiTab.
- Ndim% is the number of dimensions (or columns in the table...).
- "ColLab$_1" and @ObjColPar_1 etc refer to the columns that will be used
- Xint is the parameter on which to determine the nearest value
- Dir% determines the search direction:
- Dir%=-1: Select the closest lower table value and return this value as resuls
- Dir%=0 : Select the closest table value and return this value as result
- Dir%=1 : Select the closest higher table value and return this value as result
- See also Telitab access for a generic description on the use of TeLiTab data
- Similar to other Data analysis functions, the NEAREST is a convenient way to evaluate data. Please also look at these functions for syntax examples
- In case of a multi-dimensional dataset, NEAREST determine the nearest value over all datapoint defined by the columns in the dataset
Quick links: Functions overview | Attribute overview | Constants overview | Dimensions overview