TSparseMtx::RealToCplx Method

TSparseMtx Class

Overload List

#SignatureDescription
1TMtxVec *RealToCplx(TMtxVec *ReVec, TMtxVec *ImVec);Constructs a complex object from two real objects.
2TMtxVec *RealToCplx(TMtxVec *ReVec, TMtxVec *ImVec, int ReIndex, int ImIndex, int Index, int Len);Construct a complex object from the ReVec elements [ReIndex]..[ReIndex+Len-1] (real part) and the ImVec elements [ImIndex]..[ImIndex+Len-1] (imaginary part).

Overload 1: TMtxVec *RealToCplx(TMtxVec *ReVec, TMtxVec *ImVec);

Constructs a complex object from two real objects.

#NameTypeDescription
1ReVecTMtxVec *
2ImVecTMtxVec *
Remarks:

Construct a complex object from the ReVec (real part) and the ImVec (imaginary part) objects. The results are stored in the calling object. Size and TSparseMtx::Complex properties of the calling object are set implicitly to match ReVec and ImVec objects. An exception is raised if ReVec or ImVec TSparseMtx::Complex property is True.

Examples
#include "MtxVec.h"
#include "Units.MtxVec.h"

using namespace Dew;
using namespace Dew::Math;
using namespace Dew::Math::Units::MtxVec;

void Example()
{
    TVec *a, *b, *c;
    CreateIt(a, b, c);
    a->SetIt(false, DewArray<double>{1, 2, 3, 4}); // real parts 1, 2, 3, 4
    b->SetIt(false, DewArray<double>{2, 2, 3, 4}); // imaginary parts 2, 2, 3, 4
    c->RealToCplx(a, b);
    FreeIt(a, b, c);
}
See Also: TSparseMtx::CplxToReal
Declared in Dew::Math::TMtxVec · Dew.Math/AbstractMtxVec.h · Cross-compiler

Overload 2: TMtxVec *RealToCplx(TMtxVec *ReVec, TMtxVec *ImVec, int ReIndex, int ImIndex, int Index, int Len);

Construct a complex object from the ReVec elements [ReIndex]..[ReIndex+Len-1] (real part) and the ImVec elements [ImIndex]..[ImIndex+Len-1] (imaginary part).

#NameTypeDescription
1ReVecTMtxVec *
2ImVecTMtxVec *
3ReIndexint
4ImIndexint
5Indexint
6Lenint
Remarks:

The results are stored to calling object elements [Index]..[Index+Len-1]. Size and TSparseMtx::Complex properties of the calling object must be set explicitly. An exception is raised if TSparseMtx::ConditionCheck is True and array borders are overrun. An exception is also raised if ReVec or ImVec TSparseMtx::Complex property is True.

Declared in Dew::Math::TMtxVec · Dew.Math/AbstractMtxVec.h · Cross-compiler