Announcement
: All noncommercial projects registered to use Earth Engine before April 15, 2025
must verify noncommercial eligibility
to maintain access. If you have not verified by September 26, 2025, your access may be on hold.
Send feedback
ee.Image.arrayLength Stay organized with collections
Save and categorize content based on your preferences.
Returns the length of each pixel's array along the given axis.
Examples
Code Editor (JavaScript)
// A function to print arrays for a selected pixel in the following examples.
function
sampArrImg
(
arrImg
)
{
var
point
=
ee
.
Geometry
.
Point
([
-
121
,
42
]);
return
arrImg
.
sample
(
point
,
500
).
first
().
get
(
'array'
);
}
// A 3-band image of constants.
var
img
=
ee
.
Image
([
0
,
1
,
2
]);
print
(
'3-band image'
,
img
);
// Convert the 3-band image to a 2D array image.
var
arrayImg2D
=
img
.
toArray
().
toArray
(
1
);
print
(
'2D array image (pixel)'
,
sampArrImg
(
arrayImg2D
));
// [[0],
// [1],
// [2]]
// Get the number of dimensions in each pixel's array.
var
arrayImg2Ddim
=
arrayImg2D
.
arrayDimensions
();
print
(
'N dimensions in array'
,
sampArrImg
(
arrayImg2Ddim
));
// 2
// Get the array length per dimension per pixel.
var
arrayImg2DdimLen
=
arrayImg2D
.
arrayLengths
();
print
(
'Array length per dimension'
,
sampArrImg
(
arrayImg2DdimLen
));
// [3, 1]
// Get the array length for 0-axis (rows).
var
arrayImg2Daxis0Len
=
arrayImg2D
.
arrayLength
(
0
);
print
(
'Array length 0-axis (rows)'
,
sampArrImg
(
arrayImg2Daxis0Len
));
// 3
// Get the array length for 1-axis (columns).
var
arrayImg2Daxis1Len
=
arrayImg2D
.
arrayLength
(
1
);
print
(
'Array length 1-axis (columns)'
,
sampArrImg
(
arrayImg2Daxis1Len
));
// 1
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)
# A function to print arrays for a selected pixel in the following examples.
def
samp_arr_img
(
arr_img
):
point
=
ee
.
Geometry
.
Point
([
-
121
,
42
])
return
arr_img
.
sample
(
point
,
500
)
.
first
()
.
get
(
'array'
)
# A 3-band image of constants.
img
=
ee
.
Image
([
0
,
1
,
2
])
display
(
'3-band image:'
,
img
)
# Convert the 3-band image to a 2D array image.
array_img_2d
=
img
.
toArray
()
.
toArray
(
1
)
display
(
'2D array image (pixel):'
,
samp_arr_img
(
array_img_2d
))
# [[0],
# [1],
# [2]]
# Get the number of dimensions in each pixel's array.
array_img2d_dim
=
array_img_2d
.
arrayDimensions
()
display
(
'N dimensions in array:'
,
samp_arr_img
(
array_img2d_dim
))
# 2
# Get the array length per dimension per pixel.
array_img_2d_dim_len
=
array_img_2d
.
arrayLengths
()
display
(
'Array length per dimension:'
,
samp_arr_img
(
array_img_2d_dim_len
)
)
# [3, 1]
# Get the array length for 0-axis (rows).
array_img2d_axis0_len
=
array_img_2d
.
arrayLength
(
0
)
display
(
'Array length 0-axis (rows):'
,
samp_arr_img
(
array_img2d_axis0_len
)
)
# 3
# Get the array length for 1-axis (columns).
array_img_2d_axis1_len
=
array_img_2d
.
arrayLength
(
1
)
display
(
'Array length 1-axis (columns):'
,
samp_arr_img
(
array_img_2d_axis1_len
)
)
# 1
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-06 UTC.
Need to tell us more?
[[["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."],[],[]]