Overload List
| # | Signature | Description |
|---|---|---|
| 1 | function Power(Exponent: TCplx): TMtxVec; | Raises all calling Matrix elements to complex power Exponent in-place. |
| 2 | function Power(Base: TCplx; Exponent: TMtxVec): TMtxVec; | Raises Base complex value to Exponent object values powers and store the results to calling object values. |
| 3 | function Power(Base: TMtxVec; Exponent: TCplx): TMtxVec; | Raises each of the Base object elements to complex Exponent power. |
| 4 | function Power(Base: TMtxVec; Exponent: TMtxVec): TMtxVec; | Raises each of Base object elements to corresponding power. |
| 5 | function Power(Base: TMtxVec; Exponent: Double): TMtxVec; | Raises each of the Base object elements to real Exponent power. |
| 6 | function Power(Exponent: Double): TMtxVec; | Raises base object elements to any power. |
| 7 | function Power(Base: Double; Exponent: TMtxVec): TMtxVec; | Raises base elements to exponent power. |
Overload 1: function Power(Exponent: TCplx): TMtxVec;
Raises all calling Matrix elements to complex power Exponent in-place.
| # | Name | Type | Description |
|---|---|---|---|
| 1 | Exponent | TCplx | scalar |
Result: stored in self (calling object), returns self for chaining
If the calling Matrix 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 Matrix to complex with Matrix.ExtendToComplex 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: function Power(Base: TCplx; Exponent: TMtxVec): TMtxVec;
Raises Base complex value to Exponent object values powers and store the results to calling object values.
Result: stored in self (calling object), returns self for chaining
Size and Matrix.Complex properties of calling object are adjusted automatically.
Overload 3: function Power(Base: TMtxVec; Exponent: TCplx): TMtxVec;
Raises each of the Base object elements to complex Exponent power.
Result: stored in self (calling object), returns self for chaining
Size and Matrix.Complex properties of calling object are adjusted automatically.
Overload 4: function Power(Base: TMtxVec; Exponent: TMtxVec): TMtxVec;
Raises each of Base object elements to corresponding power.
Result: stored in self (calling object), returns self for chaining
Store the result in Exponenet elements:
Power[i] = Base[i]^Exponent[i]
Size and Matrix.Complex property of calling object are adjusted automatically. An exception is raised if Base and Exponent sizes do not match.
Overload 5: function Power(Base: TMtxVec; Exponent: Double): TMtxVec;
Raises each of the Base object elements to real Exponent power.
| # | Name | Type | Description |
|---|---|---|---|
| 1 | Base | TMtxVec | source TVec or TMtx |
| 2 | Exponent | Double | scalar |
Result: stored in self (calling object), returns self for chaining
Size and Matrix.Complex properties of calling object are adjusted automatically.
Overload 6: function Power(Exponent: Double): TMtxVec;
Raises base object elements to any power.
| # | Name | Type | Description |
|---|---|---|---|
| 1 | Exponent | Double | scalar |
Result: stored in self (calling object), returns self for chaining
Raises Base calling object elements to any power. The Matrix.IntPower is faster, if Exponent is an integer. Real valued power can handle only positive Exponent. Matrix.IntPower can handle negative exponent also.
Note
To compute a power to the negative exponent in general case or when the base is negative, use the complex version of the function.
var a: Matrix;
begin
a.SetIt(1,4,False,[1,2,3,4]);
a.Power(1.2);
end;Overload 7: function Power(Base: Double; Exponent: TMtxVec): TMtxVec;
Raises base elements to exponent power.
| # | Name | Type | Description |
|---|---|---|---|
| 1 | Base | Double | scalar |
| 2 | Exponent | TMtxVec | source TVec or TMtx |
Result: stored in self (calling object), returns self for chaining
Raises Base value to Exponent object values powers and store the results to calling object values. Size and Matrix.Complex properties of calling object are adjusted automatically.