xyz_examine_data

 

Description

Check the xyz scatters and return the proposed method for converting the XYZ to matrix

Syntax

int xyz_examine_data( UINT nSize, double * x, double * y, double * z, double dPrecision = 1.0e-8, UINT * pVar = NULL, double * pXmin = NULL, double * pXStep = NULL, double * pXmax = NULL, double * pYmin = NULL, double * pYStep = NULL, double * pYmax = NULL, bool bRemoveDuplicate = false, int nMethod = Remove_With_Mean )

Parameters

nSize
[input] the number of points
x
[input] the X-coordinates of the points
y
[input] the Y-coordinates of the points
z
[input] the Z-coordinates of the points
dPrecision
[input] the precision to determine whether two points are duplicated
pVar
[output] the number of points after removing the duplicates
pXmin
[output] the interval in x-coordinates when scatters are not randomly distributed
pXStep
[output] the interval in x-coordinates when scatters are not randomly distributed
pXmax
[output] the maximum in x-coordinates when scatters are not randomly distributed
pYmin
[output] the minimum in y-coordinates when scatters are not randomly distributed
pYStep
[output] the interval in y-coordinates when scatters are not randomly distributed
pYmax
[output] the maximum in y-coordinates when scatters are not randomly distributed
bRemoveDuplicate
[input] if true, the function will remove the duplicates, or else the array x, y, z will not change
nMethod
[input] the method used in removing the duplicates

Return

examine result, 0 for regular conversion, 1 for sparse conversion, 2 for random conversion, other value for error.

Examples

EX1

#include <wks2mat.h>
void xyz_examine_data_ex1()
{
    int n = 10;
    double a[]={1,1,1,2,2,2,3,3,3,2};
    double b[]={1,2,3,1,2,3,1,2,3,2};
    double c[]={5,3,7,3,6,5,0,4,3,7};
 
    int nRet = xyz_examine_data(n, a, b, c, 1.0e-4);
    switch(nRet)
    {
    case Examine_XYZ_Regular:
        out_str("Regular");
        break;
    case Examine_XYZ_Sparse:
        out_str("Sparse");
        break;
    case Examine_XYZ_Random:
        out_str("Random");
        break;
    }
}

Remark

See Also

ocmath_xyz_examine_data

Header to Included

wks2mat.h

Reference