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.asin()\u003c/code\u003e calculates the arcsine of each element in an input array.\u003c/p\u003e\n"],["\u003cp\u003eThe function returns a new array with the calculated arcsine values in radians.\u003c/p\u003e\n"],["\u003cp\u003eInput values should be within the range of -1 to 1, inclusive.\u003c/p\u003e\n"],["\u003cp\u003eThe output values will be within the range of -π/2 to π/2 radians.\u003c/p\u003e\n"]]],["The `Array.asin()` function computes the arcsine of each element within an input array, returning the result in radians. The input array is specified as the `this` argument. The function is demonstrated with examples where inputs of -1, 0, and 1 yield outputs of -π/2, 0, and π/2, respectively. A sequence of points between -1 and 1, along with their corresponding arcsine values, are calculated and then visualized in a chart to show the relationship.\n"],null,["On an element-wise basis, computes the arcsine in radians of the input.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|----------------|---------|\n| Array.asin`()` | Array |\n\n| Argument | Type | Details |\n|---------------|-------|------------------|\n| this: `input` | Array | The input array. |\n\nExamples\n\nCode Editor (JavaScript) \n\n```javascript\nprint(ee.Array([-1]).asin()); // [-π/2]\nprint(ee.Array([0]).asin()); // [0]\nprint(ee.Array([1]).asin()); // [π/2]\n\nvar start = -1;\nvar end = 1;\nvar points = ee.Array(ee.List.sequence(start, end, null, 50));\nvar values = points.asin();\n\n// Plot asin() 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: 'asin(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\nColab (Python) \n\n```python\nimport math\nimport altair as alt\nimport pandas as pd\n\ndisplay(ee.Array([-1]).asin()) # [-π/2]\ndisplay(ee.Array([0]).asin()) # [0]\ndisplay(ee.Array([1]).asin()) # [π/2]\n\nstart = -1\nend = 1\npoints = ee.Array(ee.List.sequence(start, end, None, 50))\nvalues = points.asin()\n\ndf = pd.DataFrame({'x': points.getInfo(), 'asin(x)': values.getInfo()})\n\n# Plot asin() defined above.\nalt.Chart(df).mark_line().encode(\n x=alt.X('x', axis=alt.Axis(values=[start, 0, end])),\n y=alt.Y('asin(x)', axis=alt.Axis(values=[-math.pi / 2, 0, math.pi / 2]))\n)\n```"]]