Crear dataset ráster (Administración de datos)

Resumen

Crea un dataset ráster como un archivo o en una geodatabase.

Uso

Sintaxis

CreateRasterDataset_management (out_path, out_name, {cellsize}, pixel_type, {raster_spatial_reference}, number_of_bands, {config_keyword}, {pyramids}, {tile_size}, {compression}, {pyramid_origin})
ParámetroExplicaciónTipo de datos
out_path

La ubicación de salida que contendrá el dataset ráster.

Workspace; Raster Catalog
out_name

El nombre del dataset ráster que se va a crear.

Al almacenar el dataset ráster en un formato de archivo, deberá especificar la extensión del archivo:

  • .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
  • ninguna extensión para Cuadrícula de Esri

Cuando almacene un dataset ráster en una geodatabase, no se deberá agregar 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.

String
cellsize
(Opcional)

El tamaño de celda para el nuevo dataset ráster.

Double
pixel_type

Especifica el tipo de datos de los valores de celda. El valor predeterminado es un entero sin signo de 8 bits.

No todos los tipos de datos son compatibles con todos los formatos de ráster. Consulte el tema de ayuda Formatos de archivos de dataset ráster admitidos para asegurarse de que el formato que está utilizando es compatible con el tipo de datos que necesita.

  • 1_BITUn entero sin signo de 1 bit. Los valores pueden ser 0 ó 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
raster_spatial_reference
(Opcional)

El sistema de coordenadas para el dataset ráster.

Si esto no es especifica, se utilizará el sistema de coordenadas establecido en la configuración del entorno.

Coordinate System
number_of_bands

El número de bandas contenidas en el dataset ráster.

Long
config_keyword
(Opcional)

Especifica los parámetros de almacenamiento (configuración) para una geodatabase de archivos y una geodatabase de ArcSDE. Las geodatabases personales no utilizan palabras clave de configuración.

El administrador de base de datos establece las palabras clave de configuración de ArcSDE.

String
pyramids
(Opcional)

Utilice esta opción para crear pirámides.

Para los Niveles de pirámide, elija un número mayor o igual a -1. Un valor de 0 no creará pirámides, y un valor de -1, elegirá automáticamente el número correcto de capas de pirámide que se crearán.

La Técnica de remuestreo de pirámides define cómo se realiza el remuestreo de los datos cuando se crean las pirámides.

  • NEAREST: se debe utilizar el vecino más próximo para los datos nominales o datasets ráster con mapas de color, como imágenes del uso del suelo o de pseudo color.
  • BILINEAR: la interpolación bilineal es la mejor opción para datos continuos, como las imágenes de satélite o la fotografía aérea.
  • CUBIC: la convolución cúbica es la mejor opción para datos continuos, como las imágenes de satélite o la fotografía aérea. Es similar a la interpolación bilineal; sin embargo, realiza un remuestreo de los datos mediante una matriz más grande.

El Tipo de compresión de pirámide define el método que se utiliza para comprimir las pirámides.

  • DEFAULT: esta opción utiliza la compresión que usa normalmente el formato de dataset ráster.
  • LZ77: una compresión sin pérdida de información. Los valores de las celdas en el ráster no se cambiarán.
  • JPEG: una compresión con pérdida de información.
  • NONE: sin compresión de datos.
Pyramid
tile_size
(Opcional)

El ancho de tesela controla el número de píxeles que puede almacenar en cada tesela. Esto se especifica como un número de píxeles en x. El ancho de tesela predeterminado es 128.

La altura de tesela controla el número de píxeles que puede almacenar en cada tesela. Esto se especifica como un número de píxeles en y. La altura de tesela predeterminada es 128.

Sólo las geodatabases de archivos y las geodatabases de ArcSDE utilizan el tamaño de tesela.

Tile Size
compression
(Opcional)

Esto define el tipo de compresión de datos que se utilizará para almacenar el dataset ráster.

  • LZ77Sin pérdida de información.
  • JPEGCon pérdida de información. Utiliza calidad de compresión.
  • JPEG 2000Con pérdida de información. Utiliza calidad de compresión.
  • PackBitsSin pérdida de información. Solo para el formato TIFF.
  • LZWSin pérdida de información.
  • RLESin pérdida de información.
  • CCITT GRUPO 3Sin pérdida de información. Solo para el formato TIFF.
  • CCITT GRUPO 4Sin pérdida de información. Solo para el formato TIFF.
  • CCITT (1D)Sin pérdida de información. Solo para el formato TIFF.
  • NONESin compresión de datos.

La calidad de compresión de JPEG y JPEG 2000 puede variar de 1 a 100. Un número más alto implica una mejor calidad de imagen pero menos compresión.

Compression
pyramid_origin
(Opcional)

Esta es la ubicación de creación de la pirámide ráster. Se recomienda especificar este punto si planea crear mosaicos grandes en una geodatabase de archivos o geodatabase de ArcSDE, especialmente si planea crear mosaicos en ellas en el futuro (por ejemplo, para actualizarlas).

El punto de referencia de pirámides se debe establecer en la esquina superior izquierda del dataset ráster.

Al configurar este punto para una geodatabase de archivos o geodatabase de ArcSDE, se realizará una creación parcial de pirámides cuando se actualice con un nuevo dataset ráster en mosaico. La creación parcial de pirámides actualiza las partes de la pirámide que no existen debido a los nuevos datasets en mosaico. Por lo tanto, es una buena idea configurar el punto de referencia de pirámides de manera que el mosaico de ráster completo se ubique por debajo y a la derecha de este punto. Sin embargo, no se debe configurar un punto de referencia de pirámides demasiado grande.

Point

Ejemplo de código

Ejemplo 1 CreateRasterDataset (ventana de Python)

Esta es una muestra de Python para la herramienta CreateRasterDataset.

import arcpy
arcpy.CreateRasterDataset_management("c:/data", "EmptyTIFF.tif", "2",
                                     "8_BIT_UNSIGNED", "World_Mercator.prj",
                                     "3", "", "PYRAMIDS -1 NEAREST JPEG",
                                     "128 128", "NONE", "")
Ejemplo 2 de CreateRasterDataset (secuencia de comandos independiente)

Esta es una muestra de secuencia de comandos de Python para la herramienta CreateRasterDataset.

##==================================
##Create Raster Dataset
##Usage: CreateRasterDataset_management out_path out_name {cellsize} 8_BIT_UNSIGNED | 1_BIT | 2_BIT | 4_BIT | 8_BIT_SIGNED 
##                                      | 16_BIT_UNSIGNED | 16_BIT_SIGNED | 32_BIT_UNSIGNED | 32_BIT_SIGNED | 32_BIT_FLOAT 
##                                      | 64_BIT {raster_spatial_reference} number_of_bands {config_keyword} {pyramids} {tile_size} 
##                                      {compression} {pyramid_origin}
try:
    import arcpy
    arcpy.env.workspace = r"\\workspace\PrjWorkspace\RasGP"
    ##Create a empty TIFF format Raster Dataset with the following parameters
    ##Cellsize: 2
    ##Pixel type: 8 Bit Unsigned Integer
    ##Number of Bands: 3
    ##Pyramid: Build full pyramids with NEAREST interpolation and JPEG compression
    ##Compression: NONE
    ##Projection: World_Mercator
    ##Tile size: 128 128
    arcpy.CreateRasterDataset_management("CreateRD","EmptyTIFF.tif","2","8_BIT_UNSIGNED",\
                                         "World_Mercator.prj", "3", "", "PYRAMIDS -1 NEAREST JPEG",\
                                         "128 128", "NONE", "")
    
    ##Create a SDE Raster Dataset
    ##No Spatial Reference, with Pyramid Origin
    arcpy.CreateRasterDataset_management("CreateRD\\CreateRD.gdb","NewRD","10","16_BIT_UNSIGNED",\
                                         "", "1", "MAX_FILE_SIZE_4GB", "PYRAMIDS 3 BILINEAR DEFAULT",\
                                         "128 128", "JPEG2000 80", "-20037508.34278775 30198185.16987658")
except:
    print "Create Raster Dataset example failed."
    print arcpy.GetMessages()

Entornos

Temas relacionados

9/11/2013