Duyuru:
15 Nisan 2025'ten önce Earth Engine'i kullanmak için kaydedilen tüm ticari olmayan projelerin Earth Engine erişimini sürdürmek için
ticari olmayan uygunluğu doğrulaması gerekir.
ee.Image.arraySlice
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Belirtilen eksen boyunca her konumu "başlangıç"tan (dahil) "bitiş"e (hariç) "adım" artışlarıyla dilimleyerek bir alt dizi oluşturur. Sonuç, girişle aynı sayıda boyuta ve dilimleme ekseni hariç tüm yönlerde aynı uzunluğa sahip olur. Dilimleme ekseninde ise uzunluk, giriş dizisinin "axis" boyunca uzunluğu aralığında bulunan "start" ile "end" arasındaki "step" konumlarının sayısı olur. Bu, start=end ise veya başlangıç ya da bitiş değerleri tamamen aralık dışında kalıyorsa sonucun, verilen eksen boyunca 0 uzunluğunda olabileceği anlamına gelir.
Kullanım | İadeler |
---|
Image.arraySlice(axis, start, end, step) | Resim |
Bağımsız Değişken | Tür | Ayrıntılar |
---|
bu: input | Resim | Giriş dizisi resmi. |
axis | Tamsayı, varsayılan: 0 | Alt küme oluşturulacak eksen. |
start | Resim, varsayılan: null | "Eksen" boyunca ilk dilimin koordinatı (dahil). Negatif sayılar, dilimlemenin başlangıcını dizinin sonuna göre konumlandırmak için kullanılır. Burada -1, eksendeki son konumdan başlar, -2 sondan bir önceki konumdan başlar vb. Başlangıç dizinleri için bir bant veya "giriş" bandı başına bir bant olmalıdır. Bu bağımsız değişken ayarlanmamışsa veya bazı piksellerde maskelenmişse ilgili pikseldeki dilim 0 dizininden başlar. |
end | Resim, varsayılan: null | Dilim almayı durdurmak için koordinat (kapsam dışı). Bu değer varsayılan olarak verilen eksenin uzunluğu olur. Negatif sayılar, dilimlemenin sonunu dizinin sonuna göre konumlandırmak için kullanılır. Burada -1 son konumu, -2 son iki konumu vb. hariç tutar. Bitiş dizinleri için bir bant veya "giriş" bandı başına bir bant olmalıdır. Bu bağımsız değişken ayarlanmamışsa veya bazı piksellerde maskelenmişse ilgili pikseldeki dilim, son indeksten hemen sonra sona erer. |
step | Tamsayı, varsayılan: 1 | Dilimler arasındaki ayrım; "axis" boyunca "start" (dahil) ile "end" (hariç) arasında "step" değerinin her tam katında bir dilim alınır. Pozitif olmalıdır. |
Örnekler
Kod Düzenleyici (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 a 1D array image with length 12.
var arrayImg1D = ee.Image([0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]).toArray();
print('1D array image (pixel)', sampArrImg(arrayImg1D));
// [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]
// Get the first 3 elements.
print('1D array image first 3 elements (pixel)',
sampArrImg(arrayImg1D.arraySlice(0, 0, 3)));
// [0, 1, 2]
// Get the last 3 elements.
print('1D array image last 3 elements (pixel)',
sampArrImg(arrayImg1D.arraySlice(0, -3)));
// [9, 10, 11]
// Get elements at index positions 3 through 5 (0-based).
print('1D array image elements at index positions 3 through 5 (pixel)',
sampArrImg(arrayImg1D.arraySlice(0, 3, 6)));
// [3, 4, 5]
// Get elements at index positions 4 through end (0-based).
print('1D array image elements at index positions 4 through end (pixel)',
sampArrImg(arrayImg1D.arraySlice(0, 4)));
// [4, 5, 6, 7, 8, 9, 10, 11]
// Get elements using a step of 3.
print('1D array image elements at a step of 3 (pixel)',
sampArrImg(arrayImg1D.arraySlice(0, 0, null, 3)));
// [0, 3, 6, 9]
// Create a 2D array image with 3 rows and 4 columns.
var arrayImg2D = arrayImg1D.arrayReshape(ee.Image([3, 4]).toArray(), 2);
print('2D array image (pixel)', sampArrImg(arrayImg2D));
// [[0, 1, 2, 3],
// [4, 5, 6, 7],
// [8, 9, 10, 11]]
// Get the second row.
print('2D array image second row (pixel)',
sampArrImg(arrayImg2D.arraySlice(0, 1, 2)));
// [[4, 5, 6, 7]
// Get the second column.
print('2D array image second column (pixel)',
sampArrImg(arrayImg2D.arraySlice(1, 1, 2)));
// [[1],
// [5],
// [9]]
// Get all columns except the last.
print('2D array image all columns except last (pixel)',
sampArrImg(arrayImg2D.arraySlice(1, 0, -1)));
// [[0, 1, 2],
// [4, 5, 6],
// [8, 9, 10]]
Python kurulumu
Python API'si ve etkileşimli geliştirme için geemap
kullanımı hakkında bilgi edinmek üzere
Python Ortamı sayfasına bakın.
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 a 1D array image with length 12.
array_img_1d = ee.Image([0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]).toArray()
print('1D array image (pixel):', samp_arr_img(array_img_1d).getInfo())
# [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]
# Get the first 3 elements.
print('1D array image first 3 elements (pixel):',
samp_arr_img(array_img_1d.arraySlice(0, 0, 3)).getInfo())
# [0, 1, 2]
# Get the last 3 elements.
print('1D array image last 3 elements (pixel):',
samp_arr_img(array_img_1d.arraySlice(0, -3)).getInfo())
# [9, 10, 11]
# Get elements at index positions 3 through 5 (0-based).
print('1D array image elements at index positions 3 through 5 (pixel):',
samp_arr_img(array_img_1d.arraySlice(0, 3, 6)).getInfo())
# [3, 4, 5]
# Get elements at index positions 4 through end (0-based).
print('1D array image elements at index positions 4 through end (pixel)',
samp_arr_img(array_img_1d.arraySlice(0, 4)).getInfo())
# [4, 5, 6, 7, 8, 9, 10, 11]
# Get elements using a step of 3.
print('1D array image elements at a step of 3 (pixel)',
samp_arr_img(array_img_1d.arraySlice(0, 0, None, 3)).getInfo())
# [0, 3, 6, 9]
# Create a 2D array image with 3 rows and 4 columns.
array_img_2d = array_img_1d.arrayReshape(ee.Image([3, 4]).toArray(), 2)
print('2D array image (pixel)', samp_arr_img(array_img_2d).getInfo())
# [[0, 1, 2, 3],
# [4, 5, 6, 7],
# [8, 9, 10, 11]]
# Get the second row.
print('2D array image second row (pixel):',
samp_arr_img(array_img_2d.arraySlice(0, 1, 2)).getInfo())
# [[4, 5, 6, 7]
# Get the second column.
print('2D array image second column (pixel):',
samp_arr_img(array_img_2d.arraySlice(1, 1, 2)).getInfo())
# [[1],
# [5],
# [9]]
# Get all columns except the last.
print('2D array image all columns except last (pixel):',
samp_arr_img(array_img_2d.arraySlice(1, 0, -1)).getInfo())
# [[0, 1, 2],
# [4, 5, 6],
# [8, 9, 10]]
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-26 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-26 UTC."],[[["\u003cp\u003e\u003ccode\u003eImage.arraySlice()\u003c/code\u003e extracts a subarray from an image by specifying the axis, start, end, and step.\u003c/p\u003e\n"],["\u003cp\u003eIt allows you to select portions of an array image along a given axis, similar to slicing in Python.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003estart\u003c/code\u003e and \u003ccode\u003eend\u003c/code\u003e parameters can be negative to index from the end of the array.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003estep\u003c/code\u003e parameter controls the interval between selected elements.\u003c/p\u003e\n"],["\u003cp\u003eThe resulting image has the same dimensions as the input except along the sliced axis, where the length depends on the slicing parameters.\u003c/p\u003e\n"]]],[],null,["# ee.Image.arraySlice\n\nCreates a subarray by slicing out each position along the given axis from the 'start' (inclusive) to 'end' (exclusive) by increments of 'step'. The result will have as many dimensions as the input, and the same length in all directions except the slicing axis, where the length will be the number of positions from 'start' to 'end' by 'step' that are in range of the input array's length along 'axis'. This means the result can be length 0 along the given axis if start=end, or if the start or end values are entirely out of range.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------------------------------------------------------|---------|\n| Image.arraySlice`(`*axis* `, `*start* `, `*end* `, `*step*`)` | Image |\n\n| Argument | Type | Details |\n|---------------|----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `input` | Image | Input array image. |\n| `axis` | Integer, default: 0 | Axis to subset. |\n| `start` | Image, default: null | The coordinate of the first slice (inclusive) along 'axis'. Negative numbers are used to position the start of slicing relative to the end of the array, where -1 starts at the last position on the axis, -2 starts at the next to last position, etc. There must one band for start indices, or one band per 'input' band. If this argument is not set or masked at some pixel, then the slice at that pixel will start at index 0. |\n| `end` | Image, default: null | The coordinate (exclusive) at which to stop taking slices. By default this will be the length of the given axis. Negative numbers are used to position the end of slicing relative to the end of the array, where -1 will exclude the last position, -2 will exclude the last two positions, etc. There must be one band for end indices, or one band per 'input' band. If this argument is not set or masked at some pixel, then the slice at that pixel will end just after the last index. |\n| `step` | Integer, default: 1 | The separation between slices along 'axis'; a slice will be taken at each whole multiple of 'step' from 'start' (inclusive) to 'end' (exclusive). Must be positive. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A function to print arrays for a selected pixel in the following examples.\nfunction sampArrImg(arrImg) {\n var point = ee.Geometry.Point([-121, 42]);\n return arrImg.sample(point, 500).first().get('array');\n}\n\n// Create a 1D array image with length 12.\nvar arrayImg1D = ee.Image([0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]).toArray();\nprint('1D array image (pixel)', sampArrImg(arrayImg1D));\n// [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]\n\n// Get the first 3 elements.\nprint('1D array image first 3 elements (pixel)',\n sampArrImg(arrayImg1D.arraySlice(0, 0, 3)));\n// [0, 1, 2]\n\n// Get the last 3 elements.\nprint('1D array image last 3 elements (pixel)',\n sampArrImg(arrayImg1D.arraySlice(0, -3)));\n// [9, 10, 11]\n\n// Get elements at index positions 3 through 5 (0-based).\nprint('1D array image elements at index positions 3 through 5 (pixel)',\n sampArrImg(arrayImg1D.arraySlice(0, 3, 6)));\n// [3, 4, 5]\n\n// Get elements at index positions 4 through end (0-based).\nprint('1D array image elements at index positions 4 through end (pixel)',\n sampArrImg(arrayImg1D.arraySlice(0, 4)));\n// [4, 5, 6, 7, 8, 9, 10, 11]\n\n// Get elements using a step of 3.\nprint('1D array image elements at a step of 3 (pixel)',\n sampArrImg(arrayImg1D.arraySlice(0, 0, null, 3)));\n// [0, 3, 6, 9]\n\n// Create a 2D array image with 3 rows and 4 columns.\nvar arrayImg2D = arrayImg1D.arrayReshape(ee.Image([3, 4]).toArray(), 2);\nprint('2D array image (pixel)', sampArrImg(arrayImg2D));\n// [[0, 1, 2, 3],\n// [4, 5, 6, 7],\n// [8, 9, 10, 11]]\n\n// Get the second row.\nprint('2D array image second row (pixel)',\n sampArrImg(arrayImg2D.arraySlice(0, 1, 2)));\n// [[4, 5, 6, 7]\n\n// Get the second column.\nprint('2D array image second column (pixel)',\n sampArrImg(arrayImg2D.arraySlice(1, 1, 2)));\n// [[1],\n// [5],\n// [9]]\n\n// Get all columns except the last.\nprint('2D array image all columns except last (pixel)',\n sampArrImg(arrayImg2D.arraySlice(1, 0, -1)));\n// [[0, 1, 2],\n// [4, 5, 6],\n// [8, 9, 10]]\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\n### Colab (Python)\n\n```python\n# A function to print arrays for a selected pixel in the following examples.\ndef samp_arr_img(arr_img):\n point = ee.Geometry.Point([-121, 42])\n return arr_img.sample(point, 500).first().get('array')\n\n# Create a 1D array image with length 12.\narray_img_1d = ee.Image([0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]).toArray()\nprint('1D array image (pixel):', samp_arr_img(array_img_1d).getInfo())\n# [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]\n\n# Get the first 3 elements.\nprint('1D array image first 3 elements (pixel):',\n samp_arr_img(array_img_1d.arraySlice(0, 0, 3)).getInfo())\n# [0, 1, 2]\n\n# Get the last 3 elements.\nprint('1D array image last 3 elements (pixel):',\n samp_arr_img(array_img_1d.arraySlice(0, -3)).getInfo())\n# [9, 10, 11]\n\n# Get elements at index positions 3 through 5 (0-based).\nprint('1D array image elements at index positions 3 through 5 (pixel):',\n samp_arr_img(array_img_1d.arraySlice(0, 3, 6)).getInfo())\n# [3, 4, 5]\n\n# Get elements at index positions 4 through end (0-based).\nprint('1D array image elements at index positions 4 through end (pixel)',\n samp_arr_img(array_img_1d.arraySlice(0, 4)).getInfo())\n# [4, 5, 6, 7, 8, 9, 10, 11]\n\n# Get elements using a step of 3.\nprint('1D array image elements at a step of 3 (pixel)',\n samp_arr_img(array_img_1d.arraySlice(0, 0, None, 3)).getInfo())\n# [0, 3, 6, 9]\n\n# Create a 2D array image with 3 rows and 4 columns.\narray_img_2d = array_img_1d.arrayReshape(ee.Image([3, 4]).toArray(), 2)\nprint('2D array image (pixel)', samp_arr_img(array_img_2d).getInfo())\n# [[0, 1, 2, 3],\n# [4, 5, 6, 7],\n# [8, 9, 10, 11]]\n\n# Get the second row.\nprint('2D array image second row (pixel):',\n samp_arr_img(array_img_2d.arraySlice(0, 1, 2)).getInfo())\n# [[4, 5, 6, 7]\n\n# Get the second column.\nprint('2D array image second column (pixel):',\n samp_arr_img(array_img_2d.arraySlice(1, 1, 2)).getInfo())\n# [[1],\n# [5],\n# [9]]\n\n# Get all columns except the last.\nprint('2D array image all columns except last (pixel):',\n samp_arr_img(array_img_2d.arraySlice(1, 0, -1)).getInfo())\n# [[0, 1, 2],\n# [4, 5, 6],\n# [8, 9, 10]]\n```"]]