Package org.apache.commons.math.complex

Class ComplexUtils

  • public class ComplexUtils
extends java.lang.Object
    Static implementations of common Complex utilities functions.

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static Complex polar2Complex​(double r, double theta)
      Creates a complex number from the given polar representation.

      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Method Detail

      • polar2Complex

        public static Complex polar2Complex​(double r,
                                    double theta)
        Creates a complex number from the given polar representation.

        The value returned is r·ei·theta, computed as r·cos(theta) + r·sin(theta)i

        If either r or theta is NaN, or theta is infinite, Complex.NaN is returned.

        If r is infinite and theta is finite, infinite or NaN values may be returned in parts of the result, following the rules for double arithmetic.

         Examples:
 
 polar2Complex(INFINITY, π/4) = INFINITY + INFINITY i
 polar2Complex(INFINITY, 0) = INFINITY + NaN i
 polar2Complex(INFINITY, -π/4) = INFINITY - INFINITY i
 polar2Complex(INFINITY, 5π/4) = -INFINITY - INFINITY i

        Parameters:
        r - the modulus of the complex number to create
        theta - the argument of the complex number to create
        Returns:
        r·ei·theta
        Throws:
        java.lang.IllegalArgumentException - if r is negative
        Since:
        1.1