Etiqueta | Explicación | Tipo de datos |
Ráster de entrada | El dataset ráster o dataset de mosaico que se va a copiar. | Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; File; Image Service |
Dataset ráster de salida | El nombre y el formato del dataset ráster que está creando.
Cuando almacene un dataset ráster en una geodatabase, no agregue ninguna extensión de archivo al nombre del dataset ráster. Cuando se almacena el dataset ráster con el formato JPEG, JPEG 2000 o TIFF o en una geodatabase, se puede especificar un tipo de compresión y la calidad de compresión. | Raster Dataset |
Palabra clave de configuración (Opcional) | Los parámetros de almacenamiento (configuración) para una geodatabase. El administrador de base de datos establece las palabras clave de configuración. | String |
Ignorar valor de fondo (Opcional) | Elimine los valores no deseados que se crean alrededor de los datos ráster. El valor especificado se distinguirá de otros datos valiosos en el dataset ráster. Por ejemplo, un valor de cero a lo largo de los bordes del dataset ráster se distinguirá de los valores cero del dataset ráster. El valor de píxel especificado se establecerá como NoData en el dataset ráster de salida. Para rásteres basados en archivos, se debe establecer Ignorar valor de fondo en el mismo valor que Valor NoData para que se ignore el valor de fondo. Los rásteres de geodatabase y los rásteres de geodatabase corporativa funcionarán sin este paso adicional. | Double |
Valor NoData (Opcional) | Todos los píxeles con el valor especificado se establecerán como NoData en el dataset ráster de salida. | String |
Convierte datos de 1 bit en 8 bit (Opcional) | Especifica si el dataset ráster de entrada de 1 bit se convertirá a un dataset ráster de 8 bits. En esta conversión, el valor 1 en el dataset ráster de entrada se cambiará a 255 en el dataset ráster de salida. Esto es útil cuando se importa un dataset ráster de 1 bit a una geodatabase. Los datasets ráster de 1 bit tienen capas de pirámide de 8 bits cuando se almacenan en un sistema de archivos, pero en una geodatabase, los datasets ráster de 1 bit solo pueden tener capas de pirámide de 1 bit, lo que hace que la visualización sea de poca calidad. Al convertir los datos a 8 bits en una geodatabase, las capas en pirámide se crean como de 8 bits en lugar de 1 bit, lo que da como resultado un dataset ráster correcto en la visualización.
| Boolean |
Mapa de color a RGB (Opcional) | Especifica si el dataset ráster de entrada se convertirá a un dataset ráster de salida de tres bandas si el dataset ráster de entrada incluye un mapa de color. Esto es útil cuando se crean mosaicos de rásteres con diferentes mapas de color.
| Boolean |
Tipo de píxel (Opcional) | Especifica la profundidad de bit, o resolución radiométrica, que se utilizará para el dataset ráster o dataset de mosaico. Si no está definido, se utilizará el valor del primer dataset ráster.
| String |
Escalar valor de píxel (Opcional) | Especifica si se escalarán los valores de píxel. Cuando la salida es un tipo de píxel distinto del de entrada (como de 16 bits a 8 bits), es posible escalar los valores para que se adapten al nuevo rango; de lo contrario, los valores que no se adapten al nuevo rango de píxeles se desecharán. Si está ajustando hacia arriba, como de 8 bits a 16 bits, el mínimo y máximo de los valores de 8 bits se ajustarán al mínimo y máximo en el rango de 16 bits. Si está ajustando hacia abajo, como de 16 bits a 8 bits, el mínimo y máximo de los valores de 16 bits se ajustarán al mínimo y máximo en el rango de 8 bits.
| Boolean |
De RGB a mapa de color (Opcional) | Especifica si se convertirá un dataset ráster de 8 bits y 3 bandas (RGB) en un dataset ráster de banda única con un mapa de color. Con esta operación se suprime el ruido que se suele encontrar en las imágenes escaneadas y es ideal para capturas de pantalla, mapas escaneados o documentos escaneados. Esto no es recomendado para las imágenes aéreas o de satélite o los datos ráster temáticos.
| Boolean |
Formato (Opcional) | Especifica el formato ráster de salida.
| String |
Aplicar transformación (Opcional) | Especifica si se aplicará a la salida la transformación que está asociada al ráster de entrada. El ráster de entrada puede tener una transformación asociada que no se guarda en la entrada como, por ejemplo, un archivo de georreferenciación o una función geométrica.
| Boolean |
Procesar como multidimensional (Opcional) | Especifica si se procesará el dataset de mosaico de entrada como dataset ráster multidimensional.
| Boolean |
Generar transposición multidimensional (Opcional) | Especifica si se generará la transposición para el dataset ráster multidimensional de entrada para optimizar el acceso a datos. La transposición dividirá los datos multidimensionales a lo largo de cada dimensión para optimizar el rendimiento al acceder a valores de píxel de todas las porciones.
| Boolean |
Resumen
Guarda una copia de un dataset ráster o convierte un dataset de mosaico en un único dataset ráster.
Uso
Puede guardar la salida en formato BIL, BIP, BMP, BSQ, COG, CRF, ENVI DAT, ERDAS IMAGINE, GIF, JPEG, JPEG 2000, MRF, NetCDF, PNG, TIFF, Cuadrícula de Esri o en cualquier dataset ráster de geodatabase.
Cuando almacene un dataset ráster en una geodatabase, no agregue ninguna extensión de archivo al nombre del dataset ráster. Al almacenar el dataset ráster en un formato de archivo, especifique la extensión del archivo de la siguiente manera:
- .bil para Esri BIL
- .bip para Esri BIP
- .bmp para BMP
- .bsq para Esri BSQ
- .crf para CRF
- .dat para ENVI DAT
- .img para ERDAS IMAGINE
- .gif para GIF
- .jpg para JPEG
- .jp2 para JPEG 2000
- .mrf para MRF
- .nc para NetCDF
- .png para PNG
- .tif para TIFF y Cloud Optimized GeoTIFF
- .zarr para Zarr
- Ninguna extensión para Cuadrícula de Esri
Esta herramienta se puede utilizar para escalar su tipo de píxel desde una profundidad de bit a otra. Cuando se escala la profundidad del píxel, el ráster lo mostrará, pero los valores se ajustarán según a la nueva profundidad de bit que se especificó.
La salida de esta herramienta es siempre un dataset ráster. Esta herramienta aceptará datasets de mosaico como la entrada, pero la salida seguirá siendo un dataset ráster. El contenido del dataset de mosaico se colocará en mosaico para crear un dataset ráster.
Si activa la opción Utilizar el archivo de georreferenciación para definir las coordenadas del ráster en las opciones de Ráster e imágenes, se creará un archivo de georreferenciación. Si existe un archivo de georreferenciación, se sobrescribirá. También puede producirse una desviación de medio píxel en la referencia espacial.
Para rásteres basados en archivos, se debe establecer el parámetro Ignorar valor de fondo en el mismo valor que el parámetro Valor NoData para que se ignore el valor de fondo. Los rásteres de geodatabases de archivos y los rásteres de geodatabases corporativas funcionan sin este paso adicional.
Cuando se almacena un dataset ráster en un archivo con formato JPEG, un archivo con formato JPEG 2000 o una geodatabase, puede especificar un valor para Tipo de compresión y Calidad de compresión en los entornos de geoprocesamiento.
El formato GIF solo admite datasets ráster de banda única.
Una vez que se crea un archivo .mrf, no se puede copiar, cambiar de nombre o eliminar de ArcGIS AllSource. Un archivo .mrf puede señalar datos que residen en otro sitio y no siempre resulta posible determinar el estado de lectura o escritura de los archivos.
El parámetro Tipo de píxel determina la profundidad de bit del dataset ráster de salida. El reescalado de los valores de ráster se produce cada vez que se elige otro tipo de píxel. Si el tipo de píxel se degrada (se lo baja), los valores ráster que estén fuera del rango válido para esa profundidad de píxel se truncarán y se perderán. Para obtener información sobre la capacidad de profundidad de bit para los formatos de exportación admitidos, consulte la Lista de sensores compatibles.
La creación de un archivo de formato Cloud Optimized GeoTIFF (COG) desde cualquier ráster con la herramienta es un proceso de dos pasos, ya que implica el orden adecuado de la estructura interna GeoTIFF con especificaciones COG. El primer paso es generar un archivo en formato GeoTIFF temporal a partir del ráster de entrada con pirámides, estadísticas y otros metadatos. A continuación, este archivo en formato GeoTIFF temporal se copia para generar un archivo de formato COG.
Los requisitos de disco para la generación de formato COG serán al menos el doble del espacio de la imagen de origen, que también depende de la compresión del ráster de entrada y el archivo de formato COG de salida.
El tipo de formato NetCDF admitido para la salida sigue las convenciones de metadatos de NetCDF Climate and Forecast (CF).
El formato netCDF solo admite datos de banda única. Para los datos multidimensionales y multibanda, como los datos de satélite, se utilizará la primera banda.
El parámetro Generar transposición multidimensional se usa para la optimización del acceso a datos. De forma predeterminada, un archivo .crf almacena cada porción multidimensional en una carpeta separada y cada porción se divide en teselas. Cuando realiza una transposición, los datos se dividirán en dimensiones en lugar de por porciones y teselas, por lo que el análisis –como el perfilamiento temporal– será más rápido.
Cuando especifica una extensión fuera de los límites del dataset ráster, el área que no contiene datos se rellena con valores NoData.
Parámetros
arcpy.management.CopyRaster(in_raster, out_rasterdataset, {config_keyword}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {colormap_to_RGB}, {pixel_type}, {scale_pixel_value}, {RGB_to_Colormap}, {format}, {transform}, {process_as_multidimensional}, {build_multidimensional_transpose})
Nombre | Explicación | Tipo de datos |
in_raster | El dataset ráster o dataset de mosaico que se va a copiar. | Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; File; Image Service |
out_rasterdataset | El nombre y el formato del dataset ráster que está creando.
Cuando almacene un dataset ráster en una geodatabase, no agregue ninguna extensión de archivo al nombre del dataset ráster. Cuando se almacena el dataset ráster con el formato JPEG, JPEG 2000 o TIFF o en una geodatabase, se puede especificar un tipo de compresión y la calidad de compresión. | Raster Dataset |
config_keyword (Opcional) | Los parámetros de almacenamiento (configuración) para una geodatabase. El administrador de base de datos establece las palabras clave de configuración. | String |
background_value (Opcional) | Elimine los valores no deseados que se crean alrededor de los datos ráster. El valor especificado se distinguirá de otros datos valiosos en el dataset ráster. Por ejemplo, un valor de cero a lo largo de los bordes del dataset ráster se distinguirá de los valores cero del dataset ráster. El valor de píxel especificado se establecerá como NoData en el dataset ráster de salida. Para rásteres basados en archivos, se debe establecer Ignorar valor de fondo en el mismo valor que Valor NoData para que se ignore el valor de fondo. Los rásteres de geodatabase y los rásteres de geodatabase corporativa funcionarán sin este paso adicional. | Double |
nodata_value (Opcional) | Todos los píxeles con el valor especificado se establecerán como NoData en el dataset ráster de salida. | String |
onebit_to_eightbit (Opcional) | Especifica si el dataset ráster de entrada de 1 bit se convertirá a un dataset ráster de 8 bits. En esta conversión, el valor 1 en el dataset ráster de entrada se cambiará a 255 en el dataset ráster de salida. Esto es útil cuando se importa un dataset ráster de 1 bit a una geodatabase. Los datasets ráster de 1 bit tienen capas de pirámide de 8 bits cuando se almacenan en un sistema de archivos, pero en una geodatabase, los datasets ráster de 1 bit solo pueden tener capas de pirámide de 1 bit, lo que hace que la visualización sea de poca calidad. Al convertir los datos a 8 bits en una geodatabase, las capas en pirámide se crean como de 8 bits en lugar de 1 bit, lo que da como resultado un dataset ráster correcto en la visualización.
| Boolean |
colormap_to_RGB (Opcional) | Especifica si el dataset ráster de entrada se convertirá a un dataset ráster de salida de tres bandas si el dataset ráster de entrada incluye un mapa de color. Esto es útil cuando se crean mosaicos de rásteres con diferentes mapas de color.
| Boolean |
pixel_type (Opcional) | Especifica la profundidad de bit, o resolución radiométrica, que se utilizará para el dataset ráster o dataset de mosaico. Si no está definido, se utilizará el valor del primer dataset ráster.
| String |
scale_pixel_value (Opcional) | Especifica si se escalarán los valores de píxel. Cuando la salida es un tipo de píxel distinto del de entrada (como de 16 bits a 8 bits), es posible escalar los valores para que se adapten al nuevo rango; de lo contrario, los valores que no se adapten al nuevo rango de píxeles se desecharán. Si está ajustando hacia arriba, como de 8 bits a 16 bits, el mínimo y máximo de los valores de 8 bits se ajustarán al mínimo y máximo en el rango de 16 bits. Si está ajustando hacia abajo, como de 16 bits a 8 bits, el mínimo y máximo de los valores de 16 bits se ajustarán al mínimo y máximo en el rango de 8 bits.
| Boolean |
RGB_to_Colormap (Opcional) | Especifica si se convertirá un dataset ráster de 8 bits y 3 bandas (RGB) en un dataset ráster de banda única con un mapa de color. Con esta operación se suprime el ruido que se suele encontrar en las imágenes escaneadas y es ideal para capturas de pantalla, mapas escaneados o documentos escaneados. Esto no es recomendado para las imágenes aéreas o de satélite o los datos ráster temáticos.
| Boolean |
format (Opcional) | Especifica el formato ráster de salida.
| String |
transform (Opcional) | Especifica si se aplicará a la salida la transformación que está asociada al ráster de entrada. El ráster de entrada puede tener una transformación asociada que no se guarda en la entrada como, por ejemplo, un archivo de georreferenciación o una función geométrica.
| Boolean |
process_as_multidimensional (Opcional) | Especifica si se procesará el dataset de mosaico de entrada como dataset ráster multidimensional.
| Boolean |
build_multidimensional_transpose (Opcional) | Especifica si se generará la transposición del dataset ráster multidimensional de entrada, que dividirá los datos a lo largo de cada dimensión para optimizar el rendimiento al acceder a valores de píxel de todas las porciones.
| Boolean |
Muestra de código
Esta es una muestra de Python para la función CopyRaster.
##====================================
##Copy Raster
##Usage: CopyRaster_management(
## in_raster, out_rasterdataset, {config_keyword}, {background_value},
## {nodata_value}, {NONE | OneBitTo8Bit}, {NONE | ColormapToRGB},
## {1_BIT | 2_BIT | 4_BIT | 8_BIT_UNSIGNED | 8_BIT_SIGNED | 16_BIT_UNSIGNED |
## 16_BIT_SIGNED | 32_BIT_UNSIGNED | 32_BIT_SIGNED | 32_BIT_FLOAT | 64_BIT},
## {NONE | ScalePixelValue}, {NONE | RGBToColormap}, {TIFF | IMAGINE Image |
## BMP | GIF | PNG | JPEG | JPEG2000 | Esri Grid | Esri BIL | Esri BSQ |
## Esri BIP | ENVI | CRF | MRF}, {NONE | Transform}, {CURRENT_SLICE | ALL_SLICES}, {NO_TRANSPOSE | TRANSPOSE})
try:
import arcpy
arcpy.env.workspace = r"C:\PrjWorkspace"
##Copy Multidimensional Raster Dataset to a new multidimensional dataset in Cloud raster format and with transpose for faster data access
arcpy.management.CopyRaster('SeaSurfaceTemp.nc',"https://s3.amazonaws.com/S3Storage/seasurfacetemp","","","","","","","","", format = "CRF",'NONE',process_as_multidimensional = 'ALL_SLICES', build_multidimensional_transpose='TRANSPOSE')
##Copy 1 BIT
arcpy.management.CopyRaster("1bit.tif","SDE94.sde\\bit8","DEFAULTS","","","OneBitTo8Bit","","")
##Copy File RasterDataset to GDB Dataset with Background and Nodata setting
arcpy.management.CopyRaster("background.tif","CpRaster.gdb\\background","DEFAULTS","0","9","","","8_BIT_UNSIGNED")
except:
print "Copy Raster example failed."
print arcpy.GetMessages()
Esta es una muestra de script de Python para la función CopyRaster.
##====================================
##Usage: CopyRaster_management(
## in_raster, out_rasterdataset, {config_keyword}, {background_value},
## {nodata_value}, {NONE | OneBitTo8Bit}, {NONE | ColormapToRGB},
## {1_BIT | 2_BIT | 4_BIT | 8_BIT_UNSIGNED | 8_BIT_SIGNED | 16_BIT_UNSIGNED |
## 16_BIT_SIGNED | 32_BIT_UNSIGNED | 32_BIT_SIGNED | 32_BIT_FLOAT | 64_BIT},
## {NONE | ScalePixelValue}, {NONE | RGBToColormap}, {TIFF | IMAGINE Image |
## BMP | GIF | PNG | JPEG | JPEG2000 | Esri Grid | Esri BIL | Esri BSQ |
## Esri BIP | ENVI | CRF | MRF}, {NONE | Transform}, {CURRENT_SLICE | ALL_SLICES}, {NO_TRANSPOSE | TRANSPOSE})
import arcpy
arcpy.env.workspace = r"C:\PrjWorkspace"
##Copy to new multidimensional dataset in cloud raster format and with transpose for faster data access
arcpy.management.CopyRaster(
"SeaSurfaceTemp.nc", "SST_Transpose.crf","","",-3.402823e+38,"NONE","NONE","","NONE","NONE", "CRF", "NONE", "ALL_SLICES", "TRANSPOSE")