Announcement: All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain Earth Engine access.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["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```"]]