AI-generated Key Takeaways
-
The
arrayCatmethod creates a new array image by concatenating the pixels of two input array images along a specified axis. -
It takes two
Imagearguments (thisasimage1andimage2) and an integeraxisto define the concatenation direction. -
The method returns a new
Imagerepresenting the concatenated array image.
| Usage | Returns |
|---|---|
Image.
arrayCat
(image2, axis)
|
Image |
| Argument | Type | Details |
|---|---|---|
|
this:
image1
|
Image | First array image to concatenate. |
image2
|
Image | Second array image to concatenate. |
axis
|
Integer | Axis to concatenate along. |
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' ); } // Create two 1D array images. var arrayImg1Da = ee . Image ([ 0 , 1 , 2 ]). toArray (); print ( '1D array image (A) (pixel)' , sampArrImg ( arrayImg1Da )); // [0, 1, 2] var arrayImg1Db = ee . Image ([ 3 , 4 , 5 ]). toArray (); print ( '1D array image (B) (pixel)' , sampArrImg ( arrayImg1Db )); // [3, 4, 5] // Concatenate 1D array image B to 1D array image A on 0-axis (rows). var arrayImg1DcatAx0 = arrayImg1Da . arrayCat ( arrayImg1Db , 0 ); print ( 'Concatenate 1D array images on 0-axis' , sampArrImg ( arrayImg1DcatAx0 )); // [0, 1, 2, 3, 4, 5] // Concatenate 1D array image B to 1D array image A on 1-axis (columns). var arrayImg1DcatAx1 = arrayImg1Da . arrayCat ( arrayImg1Db , 1 ); print ( 'Concatenate 1D array images on 1-axis' , sampArrImg ( arrayImg1DcatAx1 )); // [[0, 3], // [1, 4] // [2, 5]] // Create two 2D array images (expand the dimensions of 1D arrays). var arrayImg2Da = arrayImg1Da . toArray ( 1 ); print ( '2D array image (A) (pixel)' , sampArrImg ( arrayImg2Da )); // [[0], // [1], // [2]] var arrayImg2Db = arrayImg1Db . toArray ( 1 ); print ( '2D array image (B) (pixel)' , sampArrImg ( arrayImg2Db )); // [[3], // [4], // [5]] // Concatenate 2D array image B to 2D array image A on 0-axis (rows). var arrayImg2DcatAx0 = arrayImg2Da . arrayCat ( arrayImg2Db , 0 ); print ( 'Concatenate 2D array images on 0-axis' , sampArrImg ( arrayImg2DcatAx0 )); // [[0], // [1], // [2], // [3], // [4], // [5]] // Concatenate 2D array image B to 2D array image A on 1-axis (columns). var arrayImg2DcatAx1 = arrayImg2Da . arrayCat ( arrayImg2Db , 1 ); print ( 'Concatenate 2D array images on 1-axis' , sampArrImg ( arrayImg2DcatAx1 )); // [[0, 3], // [1, 4], // [2, 5]]
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' ) # Create two 1D array images. array_img_1d_a = ee . Image ([ 0 , 1 , 2 ]) . toArray () display ( '1D array image (A) (pixel):' , samp_arr_img ( array_img_1d_a )) # [0, 1, 2] array_img_1d_b = ee . Image ([ 3 , 4 , 5 ]) . toArray () display ( '1D array image (B) (pixel):' , samp_arr_img ( array_img_1d_b )) # [3, 4, 5] # Concatenate 1D array image B to 1D array image A on 0-axis (rows). array_img_1d_cat_ax0 = array_img_1d_a . arrayCat ( array_img_1d_b , 0 ) display ( 'Concatenate 1D array images on 0-axis:' , samp_arr_img ( array_img_1d_cat_ax0 ) ) # [0, 1, 2, 3, 4, 5] # Concatenate 1D array image B to 1D array image A on 1-axis (columns). array_img_1d_cat_ax1 = array_img_1d_a . arrayCat ( array_img_1d_b , 1 ) display ( 'Concatenate 1D array images on 1-axis:' , samp_arr_img ( array_img_1d_cat_ax1 ) ) # [[0, 3], # [1, 4] # [2, 5]] # Create two 2D array images (expand the dimensions of 1D arrays). array_img_2d_a = array_img_1d_a . toArray ( 1 ) display ( '2D array image (A) (pixel):' , samp_arr_img ( array_img_2d_a )) # [[0], # [1], # [2]] array_img_2d_b = array_img_1d_b . toArray ( 1 ) display ( '2D array image (B) (pixel):' , samp_arr_img ( array_img_2d_b )) # [[3], # [4], # [5]] # Concatenate 2D array image B to 2D array image A on 0-axis (rows). array_img_2d_cat_ax0 = array_img_2d_a . arrayCat ( array_img_2d_b , 0 ) display ( 'Concatenate 2D array images on 0-axis:' , samp_arr_img ( array_img_2d_cat_ax0 ) ) # [[0], # [1], # [2], # [3], # [4], # [5]] # Concatenate 2D array image B to 2D array image A on 1-axis (columns). array_img_2d_cat_ax1 = array_img_2d_a . arrayCat ( array_img_2d_b , 1 ) display ( 'Concatenate 2D array images on 1-axis:' , samp_arr_img ( array_img_2d_cat_ax1 ) ) # [[0, 3], # [1, 4], # [2, 5]]
