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 2023-10-06 UTC."],[[["\u003cp\u003eCalculates the cosine of each element within an input array, with the input values expected to be in radians.\u003c/p\u003e\n"],["\u003cp\u003eReturns a new array containing the cosine results, maintaining the structure of the input array.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the standard mathematical definition of cosine, producing results ranging from -1 to 1.\u003c/p\u003e\n"],["\u003cp\u003eCan be applied to single values or large arrays for efficient trigonometric computations in Earth Engine.\u003c/p\u003e\n"],["\u003cp\u003eUsage examples are provided in JavaScript and Python environments with visualizations to aid in comprehension.\u003c/p\u003e\n"]]],[],null,["# ee.Array.cos\n\nOn an element-wise basis, computes the cosine of the input in radians.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------|---------|\n| Array.cos`()` | 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\nvar π = Math.PI;\nprint(ee.Array([-π]).cos()); // [-1]\nprint(ee.Array([-π / 2.0]).cos()); // [Almost zero]\nprint(ee.Array([0]).cos()); // [1]\nprint(ee.Array([π / 2.0]).cos()); // [Almost zero]\nprint(ee.Array([π]).cos()); // [-1]\n\nvar start = -π;\nvar end = π;\nvar points = ee.Array(ee.List.sequence(start, end, null, 50));\nvar values = points.cos();\n\n// Plot cos() 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: '-π'},\n {v: 0, f: 0},\n {v: end, f: 'π'}]\n },\n vAxis: {\n title: 'cos(x)',\n ticks: [\n {v: -1, f: -1},\n {v: 0, f: 0},\n {v: 1, f: 1}]\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\nπ = math.pi\ndisplay(ee.Array([-π]).cos()) # [-1]\ndisplay(ee.Array([-π / 2.0]).cos()) # [Almost zero]\ndisplay(ee.Array([0]).cos()) # [1]\ndisplay(ee.Array([π / 2.0]).cos()) # [Almost zero]\ndisplay(ee.Array([π]).cos()) # [-1]\n\nstart = -π\nend = π\npoints = ee.Array(ee.List.sequence(start, end, None, 50))\nvalues = points.cos()\n\ndf = pd.DataFrame({'x': points.getInfo(), 'cos(x)': values.getInfo()})\n\n# Plot cos() defined above.\nalt.Chart(df).mark_line().encode(\n x=alt.X('x', axis=alt.Axis(values=[start, 0, end])),\n y=alt.Y('cos(x)', axis=alt.Axis(values=[-1, 0, 1]))\n)\n```"]]