Java - Math atan2(double, double) method



Description

The Java Math atan2(double y,double x) Converts rectangular coordinates (x, y) to polar (r, theta). This method computes the phase theta by computing an arc tangent of y/x in the range of -pi to pi. Special cases −

  • If either argument is NaN, then the result is NaN.

  • If the first argument is positive zero and the second argument is positive, or the first argument is positive and finite and the second argument is positive infinity, then the result is positive zero.

  • If the first argument is negative zero and the second argument is positive, or the first argument is negative and finite and the second argument is positive infinity, then the result is negative zero.

  • If the first argument is positive zero and the second argument is negative, or the first argument is positive and finite and the second argument is negative infinity, then the result is the double value closest to pi.

  • If the first argument is negative zero and the second argument is negative, or the first argument is negative and finite and the second argument is negative infinity, then the result is the double value closest to -pi.

  • If the first argument is positive and the second argument is positive zero or negative zero, or the first argument is positive infinity and the second argument is finite, then the result is the double value closest to pi/2.

  • If the first argument is negative and the second argument is positive zero or negative zero, or the first argument is negative infinity and the second argument is finite, then the result is the double value closest to -pi/2.

  • If both arguments are positive infinity, then the result is the double value closest to pi/4.

  • If the first argument is positive infinity and the second argument is negative infinity, then the result is the double value closest to 3*pi/4.

  • If the first argument is negative infinity and the second argument is positive infinity, then the result is the double value closest to -pi/4.

  • If both arguments are negative infinity, then the result is the double value closest to -3*pi/4.

A result must be within 2 ulps of the correctly rounded result. Results must be semi-monotonic.

Declaration

Following is the declaration for java.lang.Math.atan2() method

public static double atan2(double y, double x)

Parameters

  • y − the ordinate coordinate

  • x − the abscissa coordinate

Return Value

This method returns the theta component of the point (r, theta) in polar coordinates that corresponds to the point (x, y) in Cartesian coordinates.

Exception

NA

Example 1

The following example shows the usage of Math atan2() method with both parameters having positive values.

package com.tutorialspoint;
public class MathDemo {
   public static void main(String[] args) {

      // get a variable x which is equal to PI/2
      double x = Math.PI / 2;

      // get a variable y which is equal to PI/3
      double y = Math.PI / 3;

      // convert x and y to degrees
      x = Math.toDegrees(x);
      y = Math.toDegrees(y);

      // get the polar coordinates
      System.out.println("Math.atan2(" + x + "," + y + ")=" + Math.atan2(x, y));
   }
}

Output

Let us compile and run the above program, this will produce the following result −

Math.atan2(90.0,59.99999999999999)=0.9827937232473292

Example 2

The following example shows the usage of Math atan2() method with both parameters having negative values.

package com.tutorialspoint;
public class MathDemo {
   public static void main(String[] args) {

      // get a variable x which is equal to -PI/2
      double x = -(Math.PI / 2);

      // get a variable y which is equal to -PI/3
      double y = -(Math.PI / 3);

      // convert x and y to degrees
      x = Math.toDegrees(x);
      y = Math.toDegrees(y);

      // get the polar coordinates
      System.out.println("Math.atan2(" + x + "," + y + ")=" + Math.atan2(x, y));
   }
}

Output

Let us compile and run the above program, this will produce the following result −

Math.atan2(-90.0,-59.99999999999999)=-2.158798930342464

Example 3

The following example shows the usage of Math atan2() method with first parameter is positive and second is having negative value.

package com.tutorialspoint;
public class MathDemo {
   public static void main(String[] args) {

      // get a variable x which is equal to PI/2
      double x = Math.PI / 2;

      // get a variable y which is equal to -PI/3
      double y = -(Math.PI / 3);

      // convert x and y to degrees
      x = Math.toDegrees(x);
      y = Math.toDegrees(y);

      // get the polar coordinates
      System.out.println("Math.atan2(" + x + "," + y + ")=" + Math.atan2(x, y));
   }
}

Output

Let us compile and run the above program, this will produce the following result −

Math.atan2(90.0,-59.99999999999999)=2.158798930342464
java_lang_math.htm
Advertisements