Anuncio: Todos los proyectos no comerciales registrados para usar Earth Engine antes del
15 de abril de 2025 deben
verificar su elegibilidad no comercial para mantener el acceso a Earth Engine.
ee.Image.rename
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Cambia el nombre de las bandas de una imagen.
Devuelve la imagen renombrada.
| Uso | Muestra |
|---|
Image.rename(var_args) | Imagen |
| Argumento | Tipo | Detalles |
|---|
esta: image | Imagen | Es la instancia de Image. |
var_args | List<String>|Object|VarArgs<String> | Son los nombres nuevos de las bandas. Debe coincidir con la cantidad de bandas de la imagen. |
Ejemplos
Editor de código (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());
Configuración de Python
Consulta la página
Entorno de Python para obtener información sobre la API de Python y el uso de geemap para el desarrollo interactivo.
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())
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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```"]]
