ee.Number.atan2

  • atan2() calculates the angle formed by a 2D vector represented by its x and y coordinates (left and right inputs respectively).

  • It returns the angle in radians, ranging from -π to π.

  • The function is accessed using ee.Number(left).atan2(right), where left represents the x-coordinate and right represents the y-coordinate.

  • Examples demonstrate how atan2() is used to find angles for various points in a 2D plane.

 Calculates the angle formed by the 2D vector [x, y].

UsageReturns
Number.atan2(right)Number
ArgumentTypeDetails
this: leftNumberThe left-hand value.
rightNumberThe right-hand value.

Examples

Code Editor (JavaScript)

// Left input is x and right input is y, representing point (x,y).
print('Atan2 of point (0,0)', ee.Number(0).atan2(0));  // 0
print('Atan2 of point (1,0)', ee.Number(1).atan2(0));  // 0
print('Atan2 of point (0,1)', ee.Number(0).atan2(1));  // 1.570796326 (π/2)
print('Atan2 of point (-1,0)', ee.Number(-1).atan2(0));  // 3.141592653 (π)
print('Atan2 of point (0,-1)', ee.Number(0).atan2(-1));  // -1.570796326 (-π/2)

Python setup

See the Python Environment page for information on the Python API and using geemap for interactive development.

import ee
import geemap.core as geemap

Colab (Python)

print('Atan2 of point (0,0):', ee.Number(0).atan2(0).getInfo())  # 0
print('Atan2 of point (1,0):', ee.Number(1).atan2(0).getInfo())  # 0
# 1.570796326 (π/2)
print('Atan2 of point (0,1):', ee.Number(0).atan2(1).getInfo())
# 3.141592653 (π)
print('Atan2 of point (-1,0):', ee.Number(-1).atan2(0).getInfo())
# -1.570796326 (-π/2)
print('Atan2 of point (0,-1):', ee.Number(0).atan2(-1).getInfo())