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

Resumen

Crea un dataset ráster vacío.

Uso

  • Cuando crea un dataset ráster, crea una ubicación vacía para contener un único dataset ráster. Puede crear mosaicos o cargar datasets ráster en esta ubicación.

  • Puede guardar la salida en los formatos BIL, BIP, BMP, BSQ, CRF, DAT, Esri Grid, GIF, IMG, JPEG, JPEG 2000, PNG o TIFF o en cualquier dataset ráster de geodatabase.

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

  • Un dataset ráster creado en formato CRF es expandible. La extensión de un dataset CRF expandible se ajusta automáticamente con otras herramientas que aceptan CRF como entrada, por ejemplo, las herramientas Mosaico, Copiar ráster, Recortar rásteres y Remuestrear.

  • Un dataset CRF expandible admite rásteres multidimensionales. Se crea un dataset ráster multidimensional expandible al agregar datos multidimensionales a un dataset ráster vacío con la herramienta Mosaico. También puede definir la información multidimensional de un dataset ráster vacío mediante ArcPy, como se muestra en el siguiente ejemplo:

    Ejemplo de cómo definir la información multidimensional para un dataset ráster vacío. La definición del dataset ráster multidimensional se basa en un ráster multidimensional existente, representado por template.crf en el ejemplo siguiente.

    import arcpy
    arcpy.CheckOutExtension("ImageAnalyst")
    r = arcpy.Raster(r"\\location_to_a_mdim_raster\template.crf", True)
    r2 = arcpy.Raster(r"C:\Temp\expandable_mdim.crf")
    r2.mdinfo = r.mdinfo
    r2.mdinfo

  • La creación de pirámides mejora el rendimiento de visualización de los datasets ráster.

  • El cálculo de las estadísticas permite a las aplicaciones de ArcGIS extender y simbolizar de manera adecuada los datos ráster para la visualización.

Parámetros

EtiquetaExplicaciónTipo de datos
Localización de salida

La carpeta o geodatabase donde se guardará el dataset ráster.

Workspace
Nombre de dataset ráster con extensión

El nombre, la ubicación y el formato del dataset recién creado.

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

Cuando almacene un dataset ráster en una geodatabase, no agregue ninguna extensión de archivo al nombre del dataset ráster.

Cuando almacene el dataset ráster en un archivo con formato JPEG, un archivo con formato JPEG 2000, un archivo con formato TIFF o una geodatabase, puede especificar valores para Tipo de compresión y Calidad de compresión en los entornos de geoprocesamiento.

String
Tamaño de celda
(Opcional)

El tamaño de píxel que se utilizará para el nuevo dataset ráster.

Double
Tipo de píxel

La profundidad de bit (resolución radiométrica) del dataset ráster de salida. Si no se especifica, el dataset ráster se creará con un tipo de píxel predeterminado de 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 Lista de sensores compatibles para asegurarse de que el formato que está utilizando es compatible con el tipo de datos necesarios.

  • 1 bitEl tipo de píxel será un entero sin signo de 1 bits. Los valores pueden ser 0 ó 1.
  • 2 bitsEl tipo de píxel será un entero sin signo de 2 bits. Los valores admitidos pueden variar de 0 a 3.
  • 4 bitsEl tipo de píxel será un entero sin signo de 4 bits. Los valores admitidos pueden variar de 0 a 15.
  • 8 bits sin signoEl tipo de píxel será un tipo de dato de 8 bits sin signo. Los valores admitidos pueden variar de 0 a 255.
  • 8 bits con signoEl tipo de píxel será un tipo de dato de 8 bits con signo. Los valores admitidos pueden variar de -128 a 127.
  • 16 bits sin signoEl tipo de píxel será un tipo de datos de 16 bits sin signo. Los valores pueden variar del 0 al 65.535.
  • 16 bits con signoEl tipo de píxel será un tipo de datos de 16 bits signo. Los valores pueden variar del -32.768 al 32.767.
  • 32 bits sin signoEl tipo de píxel será un tipo de datos de 32 bits sin signo. Los valores pueden variar de 0 a 4.294.967.295.
  • 32 bits con signoEl tipo de píxel será un tipo de datos de 32 bits signo. Los valores pueden variar de -2.147.483.648 a 2.147.483.647.
  • 32 bits flotanteEl tipo de píxel será un tipo de datos de 32 bits que admite decimales.
  • 64 bitsEl tipo de píxel será un tipo de datos de 64 bits que admite decimales.
String
Referencia espacial para ráster
(Opcional)

El sistema de coordenadas para el dataset ráster de salida.

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

Coordinate System
Cantidad de bandas

El número de bandas del dataset ráster de salida.

Long
Palabra clave de configuración
(Opcional)

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
Crear pirámides
(Opcional)

Crea pirámides.

En Niveles de pirámide, especifique un número de -1 o mayor. Un valor de 0 no creará pirámides, y un valor de -1 determinará automáticamente el número correcto de capas de pirámide que se crearán.

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

  • NEAREST: utilice el vecino más cercano para los datos nominales o datasets ráster con mapas de color como, por ejemplo, imágenes del uso del suelo o de pseudocolor.
  • BILINEAR: utilice la interpolación bilineal con datos continuos, como las imágenes de satélite o la fotografía aérea.
  • CUBIC: utilice la convolución cúbica con 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: se utilizará la compresión que usa normalmente el formato de dataset ráster.
  • LZ77: se utilizará una compresión sin pérdida de información. Los valores de las celdas en el ráster no se cambiarán.
  • JPEG: se utilizará una compresión con pérdida de información.
  • NONE: no se utilizará ninguna compresión de datos.
Pyramid
Tamaño de tesela
(Opcional)

El tamaño de las teselas.

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.

Solo las geodatabases y las geodatabases corporativas utilizan el tamaño de tesela.

Tile Size
Compresión
(Opcional)

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

  • NingunaNo se usará ninguna compresión. Esta es la opción predeterminada.
  • LZ77Se utilizará una compresión sin pérdida de información que preserva todos los valores de celda ráster.
  • JpegSe utilizara una compresión con pérdida de información que utiliza el algoritmo de compresión JPEG público. Si elige JPEG, también puede especificar la calidad de compresión. Los rangos del valor de calidad de compresión válidos son de 0 a 100. Este método de compresión se puede utilizar para archivos .jpg y .tif.
  • Jpeg 2000Se utilizará una compresión con pérdida de información.
  • LzwSe utilizará una compresión sin pérdida de información que preserva todos los valores de celda ráster.
  • PackbitsSe utilizará la compresión de PackBits para los archivos .tif.
  • RleSe utilizará la codificación por longitud de pista para los archivos .img.
  • Ccitt Grupo 3Se utilizará una compresión sin pérdida de información para datos de 1 bit.
  • Ccitt Grupo 4Se utilizará una compresión sin pérdida de información para datos de 1 bit.
  • Ccitt 1DSe utilizará una compresión sin pérdida de información para datos de 1 bit.
Compression
Punto de referencia de pirámides/origen
(Opcional)

La ubicación de creación de la pirámide ráster. Se recomienda especificar este punto si tiene pensado crear mosaicos grandes en una geodatabase de archivos o geodatabase corporativa, especialmente si tiene pensado crear mosaicos en ellas en el futuro (por ejemplo, al actualizar).

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 corporativa, 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. Es una buena práctica configurar un 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

Salida derivada

EtiquetaExplicaciónTipo de datos
Dataset ráster de salida

El dataset ráster de salida.

Raster Dataset

arcpy.management.CreateRasterDataset(out_path, out_name, {cellsize}, pixel_type, {raster_spatial_reference}, number_of_bands, {config_keyword}, {pyramids}, {tile_size}, {compression}, {pyramid_origin})
NombreExplicaciónTipo de datos
out_path

La carpeta o geodatabase donde se guardará el dataset ráster.

Workspace
out_name

El nombre, la ubicación y el formato del dataset recién creado.

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

Cuando almacene un dataset ráster en una geodatabase, no agregue ninguna extensión de archivo al nombre del dataset ráster.

Cuando almacene el dataset ráster en un archivo con formato JPEG, un archivo con formato JPEG 2000, un archivo con formato TIFF o una geodatabase, puede especificar valores para Tipo de compresión y Calidad de compresión en los entornos de geoprocesamiento.

String
cellsize
(Opcional)

El tamaño de píxel que se utilizará para el nuevo dataset ráster.

Double
pixel_type

La profundidad de bit (resolución radiométrica) del dataset ráster de salida. Si no se especifica, el dataset ráster se creará con un tipo de píxel predeterminado de 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 Lista de sensores compatibles para asegurarse de que el formato que está utilizando es compatible con el tipo de datos necesarios.

  • 1_BITEl tipo de píxel será un entero sin signo de 1 bits. Los valores pueden ser 0 ó 1.
  • 2_BITEl tipo de píxel será un entero sin signo de 2 bits. Los valores admitidos pueden variar de 0 a 3.
  • 4_BITEl tipo de píxel será un entero sin signo de 4 bits. Los valores admitidos pueden variar de 0 a 15.
  • 8_BIT_UNSIGNEDEl tipo de píxel será un tipo de dato de 8 bits sin signo. Los valores admitidos pueden variar de 0 a 255.
  • 8_BIT_SIGNEDEl tipo de píxel será un tipo de dato de 8 bits con signo. Los valores admitidos pueden variar de -128 a 127.
  • 16_BIT_UNSIGNEDEl tipo de píxel será un tipo de datos de 16 bits sin signo. Los valores pueden variar del 0 al 65.535.
  • 16_BIT_SIGNEDEl tipo de píxel será un tipo de datos de 16 bits signo. Los valores pueden variar del -32.768 al 32.767.
  • 32_BIT_UNSIGNEDEl tipo de píxel será un tipo de datos de 32 bits sin signo. Los valores pueden variar de 0 a 4.294.967.295.
  • 32_BIT_SIGNEDEl tipo de píxel será un tipo de datos de 32 bits signo. Los valores pueden variar de -2.147.483.648 a 2.147.483.647.
  • 32_BIT_FLOATEl tipo de píxel será un tipo de datos de 32 bits que admite decimales.
  • 64_BITEl tipo de píxel será un tipo de datos de 64 bits que admite decimales.
String
raster_spatial_reference
(Opcional)

El sistema de coordenadas para el dataset ráster de salida.

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

Coordinate System
number_of_bands

El número de bandas del dataset ráster de salida.

Long
config_keyword
(Opcional)

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
pyramids
(Opcional)

Crea pirámides.

En Niveles de pirámide, especifique un número de -1 o mayor. Un valor de 0 no creará pirámides, y un valor de -1 determinará automáticamente el número correcto de capas de pirámide que se crearán.

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

  • NEAREST: utilice el vecino más cercano para los datos nominales o datasets ráster con mapas de color como, por ejemplo, imágenes del uso del suelo o de pseudocolor.
  • BILINEAR: utilice la interpolación bilineal con datos continuos, como las imágenes de satélite o la fotografía aérea.
  • CUBIC: utilice la convolución cúbica con 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: se utilizará la compresión que usa normalmente el formato de dataset ráster.
  • LZ77: se utilizará una compresión sin pérdida de información. Los valores de las celdas en el ráster no se cambiarán.
  • JPEG: se utilizará una compresión con pérdida de información.
  • NONE: no se utilizará ninguna compresión de datos.
Pyramid
tile_size
(Opcional)

El tamaño de las teselas.

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.

Solo las geodatabases y las geodatabases corporativas utilizan el tamaño de tesela.

Tile Size
compression
(Opcional)

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

  • LZ77Se utilizará una compresión sin pérdida de información que preserva todos los valores de celda ráster.
  • JPEGSe utilizara una compresión con pérdida de información que utiliza el algoritmo de compresión JPEG público. Si elige JPEG, también puede especificar la calidad de compresión. Los rangos del valor de calidad de compresión válidos son de 0 a 100. Este método de compresión se puede utilizar para archivos .jpg y .tif.
  • JPEG 2000Se utilizará una compresión con pérdida de información.
  • PACKBITSSe utilizará la compresión de PackBits para los archivos .tif.
  • LZWSe utilizará una compresión sin pérdida de información que preserva todos los valores de celda ráster.
  • RLESe utilizará la codificación por longitud de pista para los archivos .img.
  • CCITT GROUP 3Se utilizará una compresión sin pérdida de información para datos de 1 bit.
  • CCITT GROUP 4Se utilizará una compresión sin pérdida de información para datos de 1 bit.
  • CCITT_1DSe utilizará una compresión sin pérdida de información para datos de 1 bit.
  • NONENo se usará ninguna compresión. Esta es la opción predeterminada.
Compression
pyramid_origin
(Opcional)

La ubicación de creación de la pirámide ráster. Se recomienda especificar este punto si tiene pensado crear mosaicos grandes en una geodatabase de archivos o geodatabase corporativa, especialmente si tiene pensado crear mosaicos en ellas en el futuro (por ejemplo, al actualizar).

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 corporativa, 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. Es una buena práctica configurar un 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

Salida derivada

NombreExplicaciónTipo de datos
out_raster_dataset

El dataset ráster de salida.

Raster Dataset

Muestra de código

Ejemplo 1 CreateRasterDataset (ventana de Python)

Esta es una muestra de Python para la función 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 (script independiente)

Esta es una muestra de script de Python para la función 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}

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")

Información de licenciamiento

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

Temas relacionados