container : (optional) Array, predefined Array for holding result

unwrap : (optional) truefalse, determines if the phases are unwrapped; default is false

The Phase(A) command computes the element-wise phase of the Array A and returns the result in an Array of datatype float[8].

The Phase(Br, Bi) command computes the element-wise phase of the complex numbers whose real and imaginary parts are stored separately in the Arrays Br and Bi and returns the result in an Array of datatype float[8].

Before the code performing the computation runs, the input Array(s) are converted to datatype complex[8] (for the calling sequence with A) or float[8] (for the calling sequence with Br and Bi) if they do not have this datatype already. For this reason, it is most efficient if the input Array(s) have this datatype beforehand.

If the container=C option is provided, then the results are put into C and C is returned. With this option, no additional memory is allocated to store the result. The container must be an Array having datatype float[8] and the same size as A, Br or Bi.

If unwrap=true, then the phases are modified by adding integer multiples of 2*Pi, to ensure that the difference between consecutive elements in the result is less than Pi.

The SignalProcessing[Phase] command is thread-safe as of Maple 17.

For more information on thread safety, see index/threadsafe.

$\mathrm{with}\left(\mathrm{SignalProcessing}\right)\:$

$a≔\mathrm{Array}\left(\left[1.+\mathrm{I}\,2.-3.\mathrm{I}\,4.\,-1.\mathrm{I}\right]\,'\mathrm{datatype}'='\mathrm{complex}'\left[8\right]\right)$

$a≔\left[\begin{array}{cccc}1.+\mathrm{I}& 2.-3.\mathrm{I}& 4.+0.\mathrm{I}& 0.-\mathrm{I}\end{array}\right]$

$\mathrm{Phase}\left(a\right)$

$\left[\begin{array}{cccc}0.785398163397448& \mathrm{-0.982793723247329}& 0.& \mathrm{-1.57079632679490}\end{array}\right]$

$c≔\mathrm{Array}\left(1..\mathrm{numelems}\left(a\right)\,'\mathrm{datatype}'='\mathrm{float}'\left[8\right]\right)\:$

$\mathrm{Phase}\left(a\,'\mathrm{container}'=c\right)$

$\left[\begin{array}{cccc}0.785398163397448& \mathrm{-0.982793723247329}& 0.& \mathrm{-1.57079632679490}\end{array}\right]$

$c$

$\left[\begin{array}{cccc}0.785398163397448& \mathrm{-0.982793723247329}& 0.& \mathrm{-1.57079632679490}\end{array}\right]$

$r≔\mathrm{Array}\left(\left[1.\,2.\,4.\,0.\right]\,'\mathrm{datatype}'='\mathrm{float}'\left[8\right]\right)$

$r≔\left[\begin{array}{cccc}1.& 2.& 4.& 0.\end{array}\right]$

$i≔\mathrm{Array}\left(\left[1.\,-3.\,0.\,-1.\right]\,'\mathrm{datatype}'='\mathrm{float}'\left[8\right]\right)$

$i≔\left[\begin{array}{cccc}1.& \mathrm{-3.}& 0.& \mathrm{-1.}\end{array}\right]$

$\mathrm{Phase}\left(r\,i\right)$

$\left[\begin{array}{cccc}0.785398163397448& \mathrm{-0.982793723247329}& 0.& \mathrm{-1.57079632679490}\end{array}\right]$

$\mathrm{Phase}\left(r\,i\,'\mathrm{container}'=c\right)$

$\left[\begin{array}{cccc}0.785398163397448& \mathrm{-0.982793723247329}& 0.& \mathrm{-1.57079632679490}\end{array}\right]$

$c$

$\left[\begin{array}{cccc}0.785398163397448& \mathrm{-0.982793723247329}& 0.& \mathrm{-1.57079632679490}\end{array}\right]$

$m≔\mathrm{Array}\left(1..2\,1..2\,\left[\left[1.+\mathrm{I}\,2.-\mathrm{I}\right]\,\left[-3.+2.\,-4.+2\mathrm{I}\right]\right]\,'\mathrm{datatype}'='\mathrm{complex}'\left[8\right]\right)$

$m≔\left[\begin{array}{cc}1.+\mathrm{I}& 2.-\mathrm{I}\\ \mathrm{-1.}+0.\mathrm{I}& \mathrm{-4.}+2.\mathrm{I}\end{array}\right]$

$\mathrm{Phase}\left(m\right)$

$\left[\begin{array}{cc}0.785398163397448& \mathrm{-0.463647609000806}\\ 3.14159265358979& 2.67794504458899\end{array}\right]$

$n≔\mathrm{Array}\left(1..2\,1..2\,'\mathrm{datatype}'='\mathrm{float}'\left[8\right]\right)\:$

$\mathrm{Phase}\left(m\,'\mathrm{container}'=n\right)$

$\left[\begin{array}{cc}0.785398163397448& \mathrm{-0.463647609000806}\\ 3.14159265358979& 2.67794504458899\end{array}\right]$

$n$

$\left[\begin{array}{cc}0.785398163397448& \mathrm{-0.463647609000806}\\ 3.14159265358979& 2.67794504458899\end{array}\right]$

$V≔\mathrm{Vector}\left(\left[5\,-1+\mathrm{I}\,-3\mathrm{I}\right]\,'\mathrm{datatype}'='\mathrm{complex}\left[8\right]'\right)$

$V≔\left[\begin{array}{c}5.+0.\mathrm{I}\\ \mathrm{-1.}+\mathrm{I}\\ 0.-3.\mathrm{I}\end{array}\right]$

$P≔\mathrm{Phase}\left(V\,'\mathrm{unwrap}'='\mathrm{false}'\right)$

$P≔\left[\begin{array}{c}0.\\ 2.35619449019234\\ \mathrm{-1.57079632679490}\end{array}\right]$

$Q≔\mathrm{Phase}\left(V\,'\mathrm{unwrap}'='\mathrm{true}'\right)$

$Q≔\left[\begin{array}{c}0.\\ 2.35619449019234\\ 4.71238898038469\end{array}\right]$

The SignalProcessing[Phase] command was introduced in Maple 17.

For more information on Maple 17 changes, see Updates in Maple 17.

The SignalProcessing[Phase] command was updated in Maple 2021.

The unwrap option was updated in Maple 2021.