Copiar ráster (Administración de datos)

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 con los formatos BIL, BIP, BMP, BSQ, CRF, DAT, Cuadrícula de Esri, GIF, IMG, JPEG, JPEG 2000, MRF, 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
    • .mrf para MRF
    • .crf para CRF
    • 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 especificó.

  • 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 activó la opción Utilizar el archivo mundial para definir las coordenadas del ráster en Opciones, 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 Ignorar valor de fondo en 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 se almacena el dataset ráster en un archivo JPEG, un archivo JPEG 2000 o una geodatabase, se puede especificar un Tipo de compresión y la Calidad de compresión en Entornos.

  • El formato GIF solo admite datasets ráster de banda única.

  • 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.

  • 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 y sencillo.

Sintaxis

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})
ParámetroExplicaciónTipo de datos
in_raster

El dataset ráster o dataset de mosaico que desea 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.

  • .bil:Esri BIL
  • .bip:Esri BIP
  • .bmp: BMP
  • .bsq:Esri BSQ
  • .dat: ENVI DAT
  • .gif: GIF
  • .img: ERDAS IMAGINE
  • .jpg: JPEG
  • .jp2: JPEG 2000
  • .png: PNG
  • .tif: TIFF
  • .mrf: MRF
  • .crf: CRF
  • Ninguna extensión para Cuadrícula de Esri

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 en un archivo JPEG, un archivo JPEG 2000, un archivo TIFF o una geodatabase, se 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. 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 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, se debe establecer Ignorar valor de fondo en el mismo valor que 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)

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.

  • NONENo se realizará ninguna conversión. Esta es la opción predeterminada.
  • OneBitTo8BitEl ráster de entrada se convertirá.
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.

  • NONENo se producirá ninguna conversión. Esta es la opción predeterminada.
  • ColormapToRGBEl dataset de entrada se convertirá.
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.

  • 1_BITUn entero sin signo de 1 bit. Los valores pueden ser 0 o 1.
  • 2_BITUn entero sin signo de 2 bit. Los valores admitidos son del 0 al 3.
  • 4_BITUn entero sin signo de 4 bit. Los valores admitidos son del 0 al 15.
  • 8_BIT_UNSIGNEDUn tipo de dato sin signo de 8 bits. Los valores admitidos son del 0 al 255.
  • 8_BIT_SIGNEDUn tipo de dato con signo de 8 bits. Los valores admitidos son de -128 a 127.
  • 16_BIT_UNSIGNEDUn tipo de dato sin signo de 16 bits. Los valores pueden variar del 0 al 65.535.
  • 16_BIT_SIGNEDUn tipo de dato con signo de 16 bits. Los valores pueden variar del -32.768 al 32.767.
  • 32_BIT_UNSIGNEDUn tipo de dato sin signo de 32 bits. Los valores pueden variar de 0 a 4.294.967.295.
  • 32_BIT_SIGNEDUn tipo de dato con signo de 32 bits. Los valores pueden variar de -2.147.483.648 a 2.147.483.647.
  • 32_BIT_FLOATUn tipo de dato de 32 bits que admite decimales.
  • 64_BITUn tipo de dato de 64 bits que admite decimales.
String
scale_pixel_value
(Opcional)

Cuando la salida es un tipo de píxel distinto del de entrada (como de 16 bits a 8 bits) puede elegir que los valores se ajusten 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.

  • NONELos valores de píxeles permanecerán iguales y no aumentarán. Cualquier valor que no se ajuste dentro del rango de valor se desechará. Esta es la opción predeterminada.
  • ScalePixelValueLos valores de píxeles aumentarán al nuevo de tipo de píxeles. 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 especificó.
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.

  • NONENo convertir RGB.
  • RGBToColormapConvertir a mapa de color.
Boolean
format
(Opcional)

Especifica el formato ráster de salida.

  • TIFFFormato TIFF
  • COGFormato Cloud Optimized GeoTIFF
  • IMAGINE ImageERDAS IMAGINE
  • BMPFormato BMP
  • GIFFormato GIF
  • PNGFormato PNG
  • JPEGFormato JPEG
  • JP2Formato JPEG 2000
  • GRID Formato de cuadrícula de Esri
  • BIL EsriFormato BIL
  • BSQ EsriFormato BSQ
  • BIP EsriFormato BIP
  • ENVIFormato ENVI
  • CRFFormato CRF
  • MRFFormato MRF
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 dentro de la entrada como, por ejemplo, un archivo de georreferenciación o una función geométrica.

  • NONENo aplicar a la salida ninguna transformación asociada.
  • TransformAplicar a la salida cualquier transformación asociada.
Boolean
process_as_multidimensional
(Opcional)

Especifica si procesar el dataset de mosaico de entrada como dataset ráster multidimensional.

  • CURRENT_SLICELa entrada no se procesará como dataset ráster multidimensional. Si la entrada es multidimensional, solo se procesará la división que se muestra actualmente. Esta es la opción predeterminada.
  • ALL_SLICESLa entrada se procesará como dataset ráster multidimensional y todas las porciones se procesarán para producir un nuevo dataset ráster multidimensional. Establezca format como CRF para usar esta opción.
Boolean
build_multidimensional_transpose
(Opcional)

Especifica si se debe 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.

  • NO_TRANSPOSENo se generará ninguna transposición. Esta es la opción predeterminada.
  • TRANSPOSESe transpondrá el dataset ráster multidimensional de entrada. Establezca process_as_multidimensional como ALL_SLICES para usar esta opción.
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}, {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.CopyRaster_management('SeaSurfaceTemp.nc',"https://s3.amazonaws.com/S3Storage/seasurfacetemp","","","","","","","","", format = "CRF",'NONE',process_as_multidimensional = 'ALL_SLICES', build_multidimensional_transpose='TRANSPOSE')
    ##Copy 1 BIT 
    arcpy.CopyRaster_management("1bit.tif","SDE94.sde\\bit8","DEFAULTS","","","OneBitTo8Bit","","")
    ##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")
except:
    print "Copy Raster example failed."
    print arcpy.GetMessages()
Ejemplo 2 de CopyRaster (script independiente)

Esta es una muestra del script 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}, {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.CopyRaster_management(
	"SeaSurfaceTemp.nc", "SST_Transpose.crf","","",-3.402823e+38,"NONE","NONE","","NONE","NONE", "CRF", "NONE", "ALL_SLICES", "TRANSPOSE")

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados