ee.Image.rename
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
باندهای یک تصویر را تغییر نام دهید.
تصویر تغییر نام یافته را برمی گرداند.
| استفاده | برمی گرداند | Image. rename (var_args) | تصویر |
| استدلال | تایپ کنید | جزئیات | این: image | تصویر | نمونه تصویر. |
var_args | List<String>|Object|VarArgs<String> | نام های جدید گروه ها باید با تعداد باندهای تصویر مطابقت داشته باشد. |
نمونه ها
ویرایشگر کد (جاوا اسکریپت)
// A Sentinel-2 surface reflectance image.
var img = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG')
.select(['B11', 'B8', 'B3']);
print('Original selected S2 image band names', img.bandNames());
print('Rename bands using a list (JavaScript array or ee.List)',
img.rename(['SWIR1', 'NIR', 'GREEN']).bandNames());
print('Rename bands using a series of string arguments',
img.rename('swir1', 'nir', 'green').bandNames()); راه اندازی پایتون
برای اطلاعات در مورد API پایتون و استفاده از geemap برای توسعه تعاملی به صفحه محیط پایتون مراجعه کنید.
import ee
import geemap.core as geemap
کولب (پایتون)
# A Sentinel-2 surface reflectance image.
img = ee.Image(
'COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG'
).select(['B11', 'B8', 'B3'])
print('Original selected S2 image band names:', img.bandNames().getInfo())
print('Rename bands using a list (Python list or ee.List):',
img.rename(['SWIR1', 'NIR', 'GREEN']).bandNames().getInfo())
print('Rename bands using a series of string arguments:',
img.rename('swir1', 'nir', 'green').bandNames().getInfo())
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe \u003ccode\u003eImage.rename()\u003c/code\u003e function allows you to change the names of bands in an Earth Engine image.\u003c/p\u003e\n"],["\u003cp\u003eYou can provide new band names as a list or as individual string arguments.\u003c/p\u003e\n"],["\u003cp\u003eThe number of new band names must match the number of bands in the image.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eImage.rename()\u003c/code\u003e returns a new image with the updated band names.\u003c/p\u003e\n"]]],["The core functionality is to rename the bands of an image using the `Image.rename()` method. This method takes either a list or a series of string arguments as new band names. The number of new names provided must match the existing number of bands. The method returns the image with the updated band names. Examples demonstrate renaming bands of a Sentinel-2 image in both JavaScript and Python, using both a list and individual string arguments.\n"],null,["# ee.Image.rename\n\n\u003cbr /\u003e\n\nRename the bands of an image.\n\n\u003cbr /\u003e\n\nReturns the renamed image.\n\n| Usage | Returns |\n|--------------------------|---------|\n| Image.rename`(var_args)` | Image |\n\n| Argument | Type | Details |\n|---------------|-------------------------------------------|---------------------------------------------------------------------------|\n| this: `image` | Image | The Image instance. |\n| `var_args` | List\\\u003cString\\\u003e\\|Object\\|VarArgs\\\u003cString\\\u003e | The new names for the bands. Must match the number of bands in the Image. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A Sentinel-2 surface reflectance image.\nvar img = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG')\n .select(['B11', 'B8', 'B3']);\nprint('Original selected S2 image band names', img.bandNames());\n\nprint('Rename bands using a list (JavaScript array or ee.List)',\n img.rename(['SWIR1', 'NIR', 'GREEN']).bandNames());\n\nprint('Rename bands using a series of string arguments',\n img.rename('swir1', 'nir', 'green').bandNames());\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 Sentinel-2 surface reflectance image.\nimg = ee.Image(\n 'COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG'\n).select(['B11', 'B8', 'B3'])\nprint('Original selected S2 image band names:', img.bandNames().getInfo())\n\nprint('Rename bands using a list (Python list or ee.List):',\n img.rename(['SWIR1', 'NIR', 'GREEN']).bandNames().getInfo())\n\nprint('Rename bands using a series of string arguments:',\n img.rename('swir1', 'nir', 'green').bandNames().getInfo())\n```"]]
