ee.Image.rename
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Renommez les bandes d'une image.
Renvoie l'image renommée.
| Utilisation | Renvoie |
|---|
Image.rename(var_args) | Image |
| Argument | Type | Détails |
|---|
ceci : image | Image | Instance Image. |
var_args | List<String>|Object|VarArgs<String> | Nouveaux noms des groupes. Doit correspondre au nombre de bandes dans l'image. |
Exemples
Éditeur de code (JavaScript)
// 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());
Configuration de Python
Consultez la page
Environnement Python pour en savoir plus sur l'API Python et sur l'utilisation de geemap pour le développement interactif.
import ee
import geemap.core as geemap
Colab (Python)
# 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())
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\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```"]]
