ee.Array.tan

  • Array.tan() calculates the tangent of each element in an input array, with the input values expected to be in radians.

  • The function returns a new array containing the calculated tangent values for each corresponding element of the input array.

  • Usage examples are provided in JavaScript, Python, and Colab, demonstrating how to apply Array.tan() and visualize the results.

 On an element-wise basis, computes the tangent of the input in radians.

UsageReturns
Array.tan()Array
ArgumentTypeDetails
this: inputArrayThe input array.

Examples

Code Editor (JavaScript)

var π = Math.PI;
print(ee.Array([-π / 4]).tan());  // [Almost -1]
print(ee.Array([0]).tan());  // [0]
print(ee.Array([π / 4]).tan());  // [Almost 1]

var start = -π / 3;
var end = π / 3;
var points = ee.Array(ee.List.sequence(start, end, null, 50));
var values = points.tan();

// Plot tan() 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: '-π / 3'},
          {v: 0, f: 0},
          {v: end, f: 'π / 3'}]
      },
      vAxis: {
        title: 'tan(x)',
        ticks: [
          {v: -Math.sqrt(3), f: '-√3'},
          {v: 0},
          {v: Math.sqrt(3), f: '√3'}]
      },
      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

π = math.pi
display(ee.Array([-π / 4]).tan())  # [Almost -1]
display(ee.Array([0]).tan())  # [0]
display(ee.Array([π / 4]).tan())  # [Almost 1]

start = -π / 3
end = π / 3
points = ee.Array(ee.List.sequence(start, end, None, 50))
values = points.tan()

df = pd.DataFrame({'x': points.getInfo(), 'tan(x)': values.getInfo()})

# Plot tan() defined above.
alt.Chart(df).mark_line().encode(
    x=alt.X('x', axis=alt.Axis(values=[start, 0, end])),
    y=alt.Y('tan(x)', axis=alt.Axis(values=[-math.sqrt(3), 0, math.sqrt(3)]))
)