2.2.3.8.3 Matrix::GetCellValue

GetCellValue

1 Description
2 Syntax
3 Parameters
4 Return
5 Examples
6 Remark
7 See Also
8 Header to Include

Description

Get the value of the cell nearest the specified X and Y coordinates.

Syntax

double GetCellValue( double x, double y )

Parameters

x: [input] The input x coordinate
y: [input] The input y coordinate

Return

Returns the value of the cell nearest the specified X and Y coordinates.

Examples

EX1

// Get the cell value (=Z) nearest the specific coordinates in a matrix
void Matrix_GetCellValue_ex1()
{
// This sample code will print a message like below:
//    Target matrix is Matrix1.
//    The Min and Max of both X and Y are 0 and 100, respectively.
//    Cell value(=Z) nearest (50.1,50.1) is 50.
//    Cell value(=Z) nearest (124,124) is NANUM.
//    Cell value(=Z) nearest (125,125) is NANUM.
    double dZValue;

    matrix<double> mat1 = {
        {10, 20, 30},
        {40, 50, 60},
        {70, 80, 90}
    };

    MatrixPage MatPg1;
    MatPg1.Create("Origin");
    MatrixLayer MatLy1 = MatPg1.Layers(0);
    Matrix Mat1(MatLy1);
    Mat1 = mat1;
    printf("  Target matrix is %s.\n",Mat1.GetName());

    Mat1.SetXMin(0);   // Set the X coordinate of 1st column
    Mat1.SetXMax(100);   // Set the X coordinate of last column
    Mat1.SetYMin(0);   // Set the Y coordinate of 1st row
    Mat1.SetYMax(100);   // Set the Y coordinate of last row
    printf("  The Min and Max of both X and Y are 0 and 100, respectively.\n");

    dZValue = Mat1.GetCellValue(50.1,50.1); // Get Z coordinate at (50.1,50.1)
    if(dZValue==NANUM)  printf("  Cell value(=Z) nearest (50.1,50.1) is NANUM.\n");
    else  printf("  Cell value(=Z) nearest (50.1,50.1) is %g.\n", dZValue);

    dZValue = Mat1.GetCellValue(124,124); // Get Z coordinate at (124,124)
    if(dZValue==NANUM)  printf("  Cell value(=Z) nearest (124,124) is NANUM.\n");
    else  printf("  Cell value(=Z) nearest (124,124) is %g.\n", dZValue);
    
    dZValue = Mat1.GetCellValue(125,125); // Get Z coordinate at (125,125)
    if(dZValue==NANUM)  printf("  Cell value(=Z) nearest (125,125) is NANUM.\n");
    else  printf("  Cell value(=Z) nearest (125,125) is %g.\n", dZValue);
}