ee.Array.add

  • Array.add() performs element-wise addition, adding the corresponding elements of two arrays or an array and a scalar.

  • The method returns a new array with the results of the addition.

  • It supports both single values and multi-dimensional arrays as input.

  • Array.add() can be used with both server-side objects (like Images) and client-side objects (like Lists).

 On an element-wise basis, adds the first value to the second.

UsageReturns
Array.add(right)Array
ArgumentTypeDetails
this: leftArrayThe left-hand value.
rightArrayThe right-hand value.

Examples

Code Editor (JavaScript)

var empty = ee.Array([], ee.PixelType.int8());
print(empty.add(empty));  // []

print(ee.Array([0]).add(1));  // [1]
print(ee.Array([1]).add([2]));  // [3]
print(ee.Array([-3]).add([-4]));  // [-7]

print(ee.Array([5, 6]).add([7, 8]));  // [12,14]

var array2x3 = ee.Array([[0, 1, 2], [3, 4, 5]]);
print(array2x3.add(1));  // [[1,2,3],[4,5,6]]
print(array2x3.add(array2x3));  // [[0,2,4],[6,8,10]]

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)

empty = ee.Array([], ee.PixelType.int8())
display(empty.add(empty))  # []

display(ee.Array([0]).add(1))  # [1]
display(ee.Array([1]).add([2]))  # [3]
display(ee.Array([-3]).add([-4]))  # [-7]

display(ee.Array([5, 6]).add([7, 8]))  # [12 ,14]

array2x3 = ee.Array([[0, 1, 2], [3, 4, 5]])
display(array2x3.add(1))  # [[1, 2 ,3], [4, 5, 6]]
display(array2x3.add(array2x3))  # [[0, 2, 4], [6, 8, 10]]