Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Array.atan
Stay organized with collections
Save and categorize content based on your preferences.
On an element-wise basis, computes the arctangent in radians of the input.
| Usage | Returns | Array.atan() | Array |
| Argument | Type | Details | this: input | Array | The input array. |
Examples
Code Editor (JavaScript)
print(ee.Array([-5]).atan()); // [-1.3734]
print(ee.Array([0]).atan()); // [0]
print(ee.Array([5]).atan()); // [1.3734]
var start = -5;
var end = 5;
var points = ee.Array(ee.List.sequence(start, end, null, 50));
var values = points.atan();
// Plot atan() defined above.
var chart = ui.Chart.array.values(values, 0, points)
.setOptions({
viewWindow: {min: start, max: end},
hAxis: {
title: 'x',
viewWindowMode: 'maximized',
ticks: [
{v: start, f: start},
{v: 0, f: 0},
{v: end, f: end}]
},
vAxis: {
title: 'atan(x)',
ticks: [
{v: -Math.PI / 2, f: '-π/2'},
{v: 0, f: 0},
{v: Math.PI / 2, f: 'π/2'}]
},
lineWidth: 1,
pointSize: 0,
});
print(chart);
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)
import math
import altair as alt
import pandas as pd
display(ee.Array([-5]).atan()) # [-1.3734]
display(ee.Array([0]).atan()) # [0]
display(ee.Array([5]).atan()) # [1.3734]
start = -5
end = 5
points = ee.Array(ee.List.sequence(start, end, None, 50))
values = points.atan()
df = pd.DataFrame({'x': points.getInfo(), 'atan(x)': values.getInfo()})
# Plot atan() defined above.
alt.Chart(df).mark_line().encode(
x=alt.X('x', axis=alt.Axis(values=[start, 0, end])),
y=alt.Y('atan(x)', axis=alt.Axis(values=[-math.pi / 2, 0, math.pi / 2]))
)
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-19 UTC.
[null,null,["Last updated 2024-09-19 UTC."],[[["\u003cp\u003e\u003ccode\u003eArray.atan()\u003c/code\u003e calculates the element-wise arctangent (in radians) of an input array.\u003c/p\u003e\n"],["\u003cp\u003eThe function accepts an array as input and returns an array of the same size with the computed arctangent values.\u003c/p\u003e\n"],["\u003cp\u003eResults are within the range of -π/2 to π/2 radians.\u003c/p\u003e\n"],["\u003cp\u003eThis function can be effectively visualized using charts for understanding the relationship between input values and their corresponding arctangent.\u003c/p\u003e\n"]]],["The `Array.atan()` function computes the arctangent of each element within an input array. It returns a new array containing the arctangent values, expressed in radians. The input array is specified using `this: input`. Examples are provided demonstrating usage with different input values, such as -5, 0, and 5. Additionally, code examples in both JavaScript and Python showcase creating and plotting a sequence of points and their corresponding arctangent values using libraries to show graphical results.\n"],null,["# ee.Array.atan\n\nOn an element-wise basis, computes the arctangent in radians of the input.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|----------------|---------|\n| Array.atan`()` | Array |\n\n| Argument | Type | Details |\n|---------------|-------|------------------|\n| this: `input` | Array | The input array. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\nprint(ee.Array([-5]).atan()); // [-1.3734]\nprint(ee.Array([0]).atan()); // [0]\nprint(ee.Array([5]).atan()); // [1.3734]\n\nvar start = -5;\nvar end = 5;\nvar points = ee.Array(ee.List.sequence(start, end, null, 50));\nvar values = points.atan();\n\n// Plot atan() defined above.\nvar chart = ui.Chart.array.values(values, 0, points)\n .setOptions({\n viewWindow: {min: start, max: end},\n hAxis: {\n title: 'x',\n viewWindowMode: 'maximized',\n ticks: [\n {v: start, f: start},\n {v: 0, f: 0},\n {v: end, f: end}]\n },\n vAxis: {\n title: 'atan(x)',\n ticks: [\n {v: -Math.PI / 2, f: '-π/2'},\n {v: 0, f: 0},\n {v: Math.PI / 2, f: 'π/2'}]\n },\n lineWidth: 1,\n pointSize: 0,\n });\nprint(chart);\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\nimport math\nimport altair as alt\nimport pandas as pd\n\ndisplay(ee.Array([-5]).atan()) # [-1.3734]\ndisplay(ee.Array([0]).atan()) # [0]\ndisplay(ee.Array([5]).atan()) # [1.3734]\n\nstart = -5\nend = 5\npoints = ee.Array(ee.List.sequence(start, end, None, 50))\nvalues = points.atan()\n\ndf = pd.DataFrame({'x': points.getInfo(), 'atan(x)': values.getInfo()})\n\n# Plot atan() defined above.\nalt.Chart(df).mark_line().encode(\n x=alt.X('x', axis=alt.Axis(values=[start, 0, end])),\n y=alt.Y('atan(x)', axis=alt.Axis(values=[-math.pi / 2, 0, math.pi / 2]))\n)\n```"]]