Resumen
Guarda una copia de un dataset ráster o convierte un dataset de mosaico en un único dataset ráster.
Uso
Puede guardar las imágenes de salida en los formatos BIL, BIP, BMP, BSQ, DAT, cuadrícula de Esri, GIF, IMG, JPEG, JPEG 2000, PNG, TIFF o en cualquier dataset ráster de geodatabase.
Cuando almacene un dataset ráster en una geodatabase, no se deberá agregar ninguna extensión de archivo al nombre del dataset ráster. Al almacenar el dataset ráster en un formato de archivo, deberá especificar la extensión del archivo:
- .bil para Esri BIL
- .bip para Esri BIP
- .bmp para BMP
- .bsq para Esri BSQ
- .dat para ENVI DAT
- .gif para GIF
- .img para ERDAS IMAGINE
- .jpg para JPEG
- .jp2 para JPEG 2000
- .png para PNG
- .tif para TIFF
- ninguna extensión para Cuadrícula de Esri
Esta herramienta se puede usar para aumentar su tipo de píxel desde una profundidad de bit a otra. Cuando ajusta 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 especifico.
La salida de esta herramienta es siempre un dataset ráster. Esta herramienta acepta datasets de mosaico como la entrada, pero la salida seguirá siendo un dataset ráster. El contenido del dataset de mosaico se coloca en mosaico para crear un dataset ráster.
Si la opción Utilizar el archivo de georreferenciación para definir las coordenadas del ráster está activada en Opciones de ArcMap, se creará un archivo de georreferenciación. Si ya 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 y rásteres de geodatabase personal, se debe establecer Ignorar valor de fondo con el mismo valor que 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 almacene el dataset ráster en un archivo JPEG, un archivo JPEG 2000 o una geodatabase, puede especificar un Tipo de compresión y la Calidad de compresión en la Configuración del entorno.
El formato GIF solo admite datasets ráster de banda única.
El parámetro de tipo de píxel, determina la profundidad de bit del dataset ráster de salida. Cada vez que se elige un tipo de píxel diferente se re-escalan los valores ráster. 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 más información sobre la capacidad de profundidad de bit para los formatos de exportación admitidos, consulte Formatos de archivos dataset ráster admitidos.
Sintaxis
CopyRaster_management (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})| Parámetro | Explicación | Tipo de datos |
in_raster | El dataset ráster o dataset de mosaico que desea copiar. | Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer |
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 almacena el dataset ráster en un archivo JPEG, un archivo JPEG 2000, un archivo TIFF o una geodatabase, puede especificar un tipo de compresión y la calidad de compresión. | Raster Dataset |
config_keyword (Opcional) | Especifica los parámetros de almacenamiento (configuración) para una geodatabase de archivos o corporativa. El administrador de base de datos establece las palabras clave de configuración. | String |
background_value (Opcional) | Utilice esta opción para quitar 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 dentro 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 y rásteres de geodatabase, se debe establecer Ignorar valor de fondo con el mismo valor que NoData para que se ignore el valor de fondo. Los rásteres corporativos y de geodatabase funcionan 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) | Elija 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 en 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 en pirámide de 1 bit, lo que hace que la visualización no sea agradable. 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) | Si el dataset ráster de entrada tiene un mapa de color, el dataset ráster de salida se puede convertir a un dataset ráster de salida de tres bandas. Esto es útil cuando se crean mosaicos de rásteres con diferentes mapas de color.
| Boolean |
pixel_type (Opcional) | Establece la profundidad de bit, o resolución radiométrica, del dataset ráster o dataset de mosaico. Si no está definida, se tomará del primer dataset ráster.
| String |
scale_pixel_value (Opcional) | Cuando la salida es un tipo diferente de píxel que el de entrada (como 16 bits a 8 bits) puede elegir que los valores se aumenten para que se ajusten al nuevo rango; de lo contrario, los valores que no se ajusten al nuevo rango de píxel 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) | Convierta 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) | El formato ráster de salida.
| String |
transform (Opcional) | Elija si desea aplicar a la salida la transformación que está asociada al ráster.
| Boolean |
Muestra de código
Ejemplo 1 de CopyRaster (ventana Python)
Esta es una muestra de Python para la herramienta 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})
try:
import arcpy
arcpy.env.workspace = r"C:\PrjWorkspace"
##Copy File RasterDataset to GDB Dataset with Background and Nodata setting
arcpy.CopyRaster_management("background.tif","CpRaster.gdb\\background","DEFAULTS","0","9","","","8_BIT_UNSIGNED")
##Copy 1 BIT
arcpy.CopyRaster_management("1bit.tif","SDE94.sde\\bit8","DEFAULTS","","","OneBitTo8Bit","","")
##Copy to cloud raster format
arcpy.CopyRaster_management("slope_elev.tif", "https://s3.amazonaws.com/S3Storage/slope_elev", format="CRF", transform="Transform")
except:
print "Copy Raster example failed."
print arcpy.GetMessages()
Ejemplo 2 de CopyRaster (secuencia de comandos independiente)
Esta es una muestra de la secuencia de comandos de Python para la herramienta 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})
import arcpy
arcpy.env.workspace = r"C:\PrjWorkspace"
##Copy to cloud raster format
arcpy.CopyRaster_management(
"slope_elev.tif", "https://s3.amazonaws.com/S3Storage/slope_elev",
format="CRF")
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: Sí
- ArcGIS Desktop Standard: Sí
- ArcGIS Desktop Advanced: Sí