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 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 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.
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.
Sintaxis
CreateRasterDataset_management (out_path, out_name, {cellsize}, pixel_type, {raster_spatial_reference}, number_of_bands, {config_keyword}, {pyramids}, {tile_size}, {compression}, {compression}, {pyramid_origin})| Parámetro | Explicación | Tipo de datos |
out_path | La ubicación de salida donde se va a almacenar el dataset ráster. | Workspace; Raster Catalog |
out_name | Nombre, ubicación y formato para el dataset que está creando. Al almacenar el dataset ráster en un formato de archivo, deberá especificar la extensión del archivo:
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 JPEG, un archivo JPEG 2000, un archivo TIFF o una geodatabase, puede especificar un Tipo de compresión y la Calidad de compresión en la Configuración del entorno. | String |
cellsize (Opcional) | El tamaño de celda 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 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.
| String |
raster_spatial_reference (Opcional) | El sistema de coordenadas para el dataset ráster de salida. 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 que tendrá el dataset ráster de salida. | Long |
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 |
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.
El Tipo de compresión de pirámide define el método que se utiliza para comprimir las pirámides.
| 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. Solo las geodatabases y las geodatabases corporativas utilizan el tamaño de tesela. | Tile Size |
compression (Opcional) | Define el tipo de compresión que se utilizará para almacenar el dataset ráster.
| String |
compression (Opcional) | Esto define el tipo de compresión de datos que se utilizará para almacenar el dataset ráster.
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 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, 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 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. 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}
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")
Entornos
Información sobre licencias
- ArcGIS for Desktop Basic: Sí
- ArcGIS for Desktop Standard: Sí
- ArcGIS for Desktop Advanced: Sí