ee.Image.arraySlice
संग्रह की मदद से व्यवस्थित रहें
अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.
यह फ़ंक्शन, दिए गए ऐक्सिस के साथ हर पोज़िशन को स्लाइस करके एक सबऐरे बनाता है. यह स्लाइसिंग, 'start' (शामिल है) से 'end' (शामिल नहीं है) तक 'step' के हिसाब से बढ़ती है. नतीजे में उतने ही डाइमेंशन होंगे जितने इनपुट में हैं. साथ ही, स्लाइसिंग ऐक्सिस को छोड़कर, सभी दिशाओं में लंबाई एक जैसी होगी. स्लाइसिंग ऐक्सिस में लंबाई, 'start' से 'end' तक की उन पोज़िशन की संख्या होगी जो 'step' के हिसाब से इनपुट ऐरे की लंबाई की सीमा में हैं. यह लंबाई, 'axis' के हिसाब से तय की जाती है. इसका मतलब है कि अगर start=end है या start या end की वैल्यू पूरी तरह से रेंज से बाहर हैं, तो दिए गए ऐक्सिस के हिसाब से नतीजे की लंबाई 0 हो सकती है.
| इस्तेमाल | रिटर्न |
|---|
Image.arraySlice(axis, start, end, step) | इमेज |
| आर्ग्यूमेंट | टाइप | विवरण |
|---|
यह: input | इमेज | इनपुट के तौर पर दी गई अरे इमेज. |
axis | पूर्णांक, डिफ़ॉल्ट: 0 | सबसेट बनाने के लिए ऐक्सिस. |
start | इमेज, डिफ़ॉल्ट: null | 'axis' के साथ पहले स्लाइस का कोऑर्डिनेट (शामिल है). नेगेटिव संख्याओं का इस्तेमाल, ऐरे के आखिर के हिसाब से स्लाइसिंग की शुरुआत की पोज़िशन तय करने के लिए किया जाता है. इसमें -1, ऐक्सिस की आखिरी पोज़िशन से शुरू होता है, -2, आखिरी से पहले वाली पोज़िशन से शुरू होता है वगैरह. स्टार्ट इंडेक्स के लिए एक बैंड होना चाहिए या हर 'input' बैंड के लिए एक बैंड होना चाहिए. अगर इस आर्ग्युमेंट को किसी पिक्सल पर सेट या मास्क नहीं किया जाता है, तो उस पिक्सल पर स्लाइस इंडेक्स 0 से शुरू होगा. |
end | इमेज, डिफ़ॉल्ट: null | वह कोऑर्डिनेट (एक्सक्लूसिव) जहां स्लाइस लेना बंद करना है. डिफ़ॉल्ट रूप से, यह दिए गए ऐक्सिस की लंबाई होगी. नेगेटिव नंबर का इस्तेमाल, स्लाइसिंग के आखिर को ऐरे के आखिर के हिसाब से सेट करने के लिए किया जाता है. इसमें -1 का मतलब है कि आखिरी पोज़िशन को शामिल नहीं किया जाएगा, -2 का मतलब है कि आखिरी दो पोज़िशन को शामिल नहीं किया जाएगा. इसी तरह, यह क्रम चलता है. एंड इंडेक्स के लिए एक बैंड या हर 'इनपुट' बैंड के लिए एक बैंड होना चाहिए. अगर इस तर्क को सेट नहीं किया जाता है या किसी पिक्सल पर मास्क किया जाता है, तो उस पिक्सल पर स्लाइस, आखिरी इंडेक्स के ठीक बाद खत्म हो जाएगा. |
step | पूर्णांक, डिफ़ॉल्ट: 1 | 'ऐक्सिस' के हिसाब से स्लाइस के बीच का अंतर; 'स्टार्ट' (शामिल है) से 'एंड' (शामिल नहीं है) तक, 'स्टेप' के हर पूर्णांक गुणक पर एक स्लाइस लिया जाएगा. पॉज़िटिव होना चाहिए. |
उदाहरण
कोड एडिटर (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 सेटअप करना
Python API और इंटरैक्टिव डेवलपमेंट के लिए geemap का इस्तेमाल करने के बारे में जानकारी पाने के लिए,
Python एनवायरमेंट पेज देखें.
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]]
जब तक कुछ अलग से न बताया जाए, तब तक इस पेज की सामग्री को Creative Commons Attribution 4.0 License के तहत और कोड के नमूनों को Apache 2.0 License के तहत लाइसेंस मिला है. ज़्यादा जानकारी के लिए, Google Developers साइट नीतियां देखें. Oracle और/या इससे जुड़ी हुई कंपनियों का, Java एक रजिस्टर किया हुआ ट्रेडमार्क है.
आखिरी बार 2025-07-26 (UTC) को अपडेट किया गया.
[null,null,["आखिरी बार 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```"]]
