Puedes usar el Administrador de recursos o la interfaz de línea de comandos (CLI) para subir imágenes o cualquier otro conjunto de datos de ráster georreferenciados en formato GeoTIFF o TFRecord. (Consulta Importa datos vectoriales para obtener detalles sobre cómo importar vectores con el Editor de código).
Cómo subir recursos de imagen
GeoTIFF
En el editor de código, puedes subir archivos de imagen GeoTIFF de hasta 10 GB a tu carpeta de usuario de Earth Engine. (Para archivos más grandes, usa la opción de carga de línea de comandos).
Para subir un GeoTIFF con el Editor de código,
selecciona la pestaña Recursos en la esquina superior izquierda,
haz clic en el botón
y, luego, selecciona Subir
imagen. Earth Engine presenta un diálogo de carga que debería ser similar al de la Figura 1. Haz clic en el botón SELECCIONAR y navega a un GeoTIFF en tu sistema de archivos
local.
Asigna a la imagen un ID de activo adecuado (que aún no exista) en tu
carpeta de usuario. Si quieres subir la imagen a una carpeta o colección existente,
antepón el ID de la carpeta o colección al ID del activo, por ejemplo,
projects/myproject/folder-or-collection-id/new-asset.
Haz clic en SUBIR para iniciar la carga.
Una vez que hayas iniciado la carga, aparecerá una tarea de "Transferencia de recursos" en la pestaña Tareas,
en el lado derecho del editor de código. Si colocas el cursor sobre la tarea en el administrador de tareas, se muestra un signo de
? que puedes usar para verificar el estado de la carga. Para cancelar una carga,
haz clic en el ícono giratorio
junto a la
tarea. Una vez que se complete la transferencia, el recurso aparecerá en tu carpeta de usuario con
un ícono de .
Compresión de GeoTIFF
Los archivos GeoTIFF se pueden comprimir con DEFLATE, JPEG, JPEG-XL/JXL, LERC, LERC_DEFLATE, LERC_ZSTD, LZMA, LZW, WEBP o ZSTD. Los GeoTIFF optimizados para la nube (COG) que Earth Engine lee en el lugar en vez de transferir aceptan un conjunto más limitado; consulta Compresión de COG.
Recomendaciones para obtener la mejor experiencia de carga de archivos grandes:
- La mejor opción: ZSTD ofrece un buen equilibrio entre velocidad y compresión.
- Evita: LZMA puede ser muy lento a pesar de tener una buena compresión.
- Archivos sin comprimir: Generarán archivos más grandes y tiempos de carga más largos.
- Compresión con pérdida (p.ej., JPEG): Puede alterar los valores de los píxeles. Usa la compresión sin pérdida (p.ej., DEFLATE, LZMA, LZW, ZSTD) en lugar de la compresión con pérdida, a menos que comprendas el impacto potencial en tus datos.
TFRecord
Para subir una imagen desde un archivo TFRecord, debes tener el archivo de mezclador asociado que se generó cuando exportaste las imágenes en las que realizaste la inferencia. Consulta la página de exportación para obtener detalles sobre el archivo del mezclador. Más específicamente, para importar predicciones (como una imagen) realizadas en imágenes exportadas,
- Exporta imágenes a uno o más archivos TFRecord.
- Realiza inferencias en las imágenes (es decir,
model.predict()). - Escribe el resultado de
model.predict()en un archivo TFRecord. Las predicciones deben estar en el mismo orden que las exportaciones de imágenes en las que realizaste la inferencia. El orden se puede aplicar mediante una ordenación de los nombres de archivo que produce la exportación. Consulta la sección sobre exportaciones de archivos grandes para obtener más detalles. - Sube los archivos TFRecord y el mezclador asociado a Earth Engine.
Edición de propiedades
Edita los metadatos de un activo especificando una o más propiedades de metadatos. En el menú Properties, haz clic en Add property para definir un nombre y un valor de propiedad (figura 2). El valor puede ser una cadena o un número.
Ingresa cadenas sin comillas. Para dar formato a un número como una cadena, ingresa una comilla simple
(') antes del número.
De forma predeterminada, se agrega una propiedad system:time_start sin valor. Earth Engine usa esta propiedad cuando aplica
filtros de fecha ImageCollection. Ingresa una fecha en el formato que se muestra en la figura 2 o un número que represente los milisegundos transcurridos desde el 1 de enero de 1970. (consulta
el glosario para obtener más información sobre las marcas de tiempo en Earth Engine).
El Administrador de recursos interpreta un número ingresado como el valor de una propiedad llamada
system:time_start o system:time_end como milisegundos y
le da formato de fecha.
Haz clic en el ícono para quitar una propiedad.
Opciones avanzadas
En el menú Avanzado, elige la política de piramidación y el modo de enmascaramiento para tus datos.
La política de pirámide especifica cómo Earth Engine genera versiones de menor resolución de la imagen. Obtén más información sobre cómo Earth Engine controla varias resoluciones en el documento de escala. Elige una política de pirámide de "Media", "Mín." o "Máx." para calcular los niveles de resolución más bajos de la pirámide de imágenes como la media, el mínimo o el máximo de cada grupo de 2 x 2 de píxeles de mayor resolución. Esta es una opción adecuada para imágenes con valores continuos. Para los datos categóricos (p.ej., cubierta del suelo) o de QA, elige una política de piramidación de "Muestra" (el píxel superior izquierdo) o "Moda" (el valor que se produce con mayor frecuencia o la muestra si no hay moda).
El modo de enmascaramiento indica cómo se enmascara la imagen subida (si es que se enmascara). Para especificar un valor sin datos, selecciona "Valor sin datos" y, luego, ingresa el valor. Los píxeles con este valor se enmascararán en la imagen subida. Este valor se aplica a cada banda de la imagen de forma independiente. Para usar la última banda de tu imagen como máscara para las otras bandas de la imagen, selecciona "Usar la última banda como banda alfa". La banda alfa debe ser una banda de 8 bits sin firma en la que 0 son datos enmascarados (completamente transparentes) y 255 es completamente opaco.
Cargas en mosaico
Para subir una sola imagen como varias tarjetas, en la que cada tarjeta se almacena en un archivo de origen diferente, haz clic en Agregar otro archivo para agregar archivos adicionales a la carga. Earth Engine combinará las tarjetas para crear una sola imagen en tu carpeta de usuario.
Existen algunas restricciones en cuanto a los tipos de archivos que se pueden subir a un recurso de imagen. En particular:
- Las imágenes deben tener la misma cantidad de bandas, profundidad de bits, proyección, resolución y valores de relleno.
- El desplazamiento de un archivo al siguiente debe ser un múltiplo entero del tamaño del píxel.
- Los espacios entre las tarjetas se completarán con píxeles enmascarados en la imagen final, por lo que, idealmente, las tarjetas deben ser adyacentes y no estar dispersas. No se transferirán las imágenes con espacios vacíos que ocupen más del 99% del área de la imagen.