Vector.Power Method

Overload List

#SignatureDescription
1TMtxVec Power(TCplx Exponent)Raises all calling vector elements to complex power Exponent in-place.
2TMtxVec Power(TCplx Base, TMtxVec Exponent)Raises Base complex value to Exponent object values powers and store the results to calling object values.
3TMtxVec Power(TMtxVec Base, TCplx Exponent)Raises each of the Base object elements to complex Exponent power.
4TMtxVec Power(TMtxVec Base, TMtxVec Exponent)Raises each of Base object elements to corresponding power
5TMtxVec Power(TMtxVec Base, Double Exponent)Raises each of the Base object elements to real Exponent power.
6TMtxVec Power(Double Exponent)Raises base object elements to any power.
7TMtxVec Power(Double Base, TMtxVec Exponent)Raises base elements to exponent power.

Overload 1: TMtxVec Power(TCplx Exponent)

Raises all calling vector elements to complex power Exponent in-place.

#NameTypeDescription
1ExponentTCplxscalar

Result: stored in self (calling object), returns self for chaining

Remarks:

If the calling vector is real and has negative elements, the result will be NAN at those entries. To obtain a valid result in this case, extend the calling vector to complex with method. In all real/complex combinations, the Power method will not automatically assume that a number is complex to speed up the computation. Alternatively the user can of course always convert the real numbers to complex before passing them to the Power routine.

Overload 2: TMtxVec Power(TCplx Base, TMtxVec Exponent)

Raises Base complex value to Exponent object values powers and store the results to calling object values.

#NameTypeDescription
1BaseTCplxscalar
2ExponentTMtxVecsource TVec or TMtx

Result: stored in self (calling object), returns self for chaining

Remarks:

Size and Dew.Math.Vector.Complex properties of calling object are adjusted automatically.

Overload 3: TMtxVec Power(TMtxVec Base, TCplx Exponent)

Raises each of the Base object elements to complex Exponent power.

#NameTypeDescription
1BaseTMtxVecsource TVec or TMtx
2ExponentTCplxscalar

Result: stored in self (calling object), returns self for chaining

Remarks:

Size and Dew.Math.Vector.Complex properties of calling object are adjusted automatically.

Overload 4: TMtxVec Power(TMtxVec Base, TMtxVec Exponent)

Raises each of Base object elements to corresponding power

#NameTypeDescription
1BaseTMtxVecsource TVec or TMtx
2ExponentTMtxVecsource TVec or TMtx

Result: stored in self (calling object), returns self for chaining

Remarks:

Powers are stored in Exponenet elements:

Power[i] = Base[i]^Exponent[i]

Size and property of calling object are adjusted automatically. An exception is raised if Base and Exponent sizes do not match.

Overload 5: TMtxVec Power(TMtxVec Base, Double Exponent)

Raises each of the Base object elements to real Exponent power.

#NameTypeDescription
1BaseTMtxVecsource TVec or TMtx
2ExponentDoublescalar

Result: stored in self (calling object), returns self for chaining

Remarks:

Size and Dew.Math.Vector.Complex properties of calling object are adjusted automatically.

Overload 6: TMtxVec Power(Double Exponent)

Raises base object elements to any power.

#NameTypeDescription
1ExponentDoublescalar

Result: stored in self (calling object), returns self for chaining

Remarks:

Raises Base calling object elements to any power. The Dew.Math.Vector.IntPower is faster, if Exponent is an integer. Real valued power can handle only positive Exponent. Dew.Math.Vector.IntPower can handle negative exponent also. To compute a power to the negative exponent in general case or when the base is negative, use the complex version of the function.

Examples
Vector a;
a.SetIt(false,new double[] {1,2,3,4});
a.Power(1.2);
See Also: Vector.IntPower, Vector.PowerVec

Overload 7: TMtxVec Power(Double Base, TMtxVec Exponent)

Raises base elements to exponent power.

#NameTypeDescription
1BaseDoublescalar
2ExponentTMtxVecsource TVec or TMtx

Result: stored in self (calling object), returns self for chaining

Remarks:

Raises Base value to Exponent object values powers and store the results to calling object values. Size and Dew.Math.Vector.Complex properties of calling object are adjusted automatically.

See Also: Vector.PowerVec