2.2.3.9.26 matrixbase::GetAsVector

GetAsVector

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

Description

Get the values of an entire matrix and assign them to a vector.

Syntax

BOOL GetAsVector( vectorbase & vb, BOOL bByRow = TRUE )

Parameters

vb: [output] Vector used to get the matrix values
bByRow: [input] Use Row order if TRUE otherwise use Column order

Return

Returns TRUE on success and FALSE on failure.

Examples

EX1

void matrixbase_GetAsVector_ex1()
{
    matrix<double> mat1 = {
        {1,  1,  1,  1},
        {2,  4,  6,  8},
        {3,  6,  9, 12}
    };
	vector vR;
	int rc = mat1.GetAsVector(vR);
	if(!rc) 
        printf("Error: GetAsVector failed. rc=%d\n", rc); 
    else{
        for(int ii = 0; ii < vR.GetSize(); ii++) 
        	printf("\t%g",vR[ii]);
    }
}

EX2

// Get a vector from a matrix
void matrixbase_GetAsVector_ex2()
{
    matrix<double> mat1 = {
        {1,  1,  1,  1},
        {2,  4,  6,  8},
        {3,  6,  9, 12}
    };
// Sample output of this sample code:
//   The input matrix is mat1.
//   The gotten vector in row-wise:
//      1    1    1    1    2    4    6    8    3    6    9    12
//   The gotten vector in column-wise:
//      1    2    3    1    4    6    1    6    9    1    8    12
//
    MatrixPage MatPg1;
    MatPg1.Create("Origin");
    MatrixLayer MatLy1 = MatPg1.Layers(0);
    Matrix Mat1(MatLy1);
    Mat1 = mat1;
    printf("  The input matrix is %s.\n",Mat1.GetName());
 
    vector vR, vC;
    int ii;
 
    int rc=Mat1.GetAsVector(vR); // Get matrix data in row-wise(default) into vR,
    if(!rc) 
        printf("  Error: GetAsVector failed.\n");
    else
    {
        printf("  The gotten vector in row-wise:\n");
        for(ii = 0; ii < vR.GetSize(); ii++) printf("\t%g",vR[ii]);
        printf("\n");
    }
 
    rc=Mat1.GetAsVector(vC, FALSE); // Get matrix data in column-wise into vC
    if(!rc) 
        printf("  Error: GetAsVector failed.\n");
    else
    {
        printf("  The gotten vector in column-wise:\n");
        for(ii = 0; ii < vC.GetSize(); ii++) printf("\t%g",vC[ii]);
        printf("\n");
    }
}

Remark

Get the values of an entire matrix and assign them to a vector. If the matrix and vector do not have the number of elements then the vector is dynamically resized.