Resumen
Divide un dataset ráster en fragmentos más pequeños, ya sea por teselas o por entidades de un polígono.
Uso
Los archivos de salida compartirán la mayoría de las propiedades del ráster de origen de entrada, como la referencia espacial, el tipo de fuente, el tipo de píxel, la profundidad de píxel y el tamaño de celda.
El método de ordenamiento en teselas determina cuáles de los parámetros opcionales se utilizan para determinar las dimensiones y la ubicación de las teselas de salida. En ambos casos se utilizan valores NoData para completar las teselas donde no haya datos de origen correspondientes. El formato de datos depende de las limitaciones de las especificaciones de formato individuales y del tipo de datos de imagen fuente. Las combinaciones no válidas generan un mensaje de error correspondiente.
Si ya existe una tesela (si existe un archivo con el mismo nombre), no se sobrescribirá.
Si una tesela solo contiene valores de píxel NoData, no se creará.
Sintaxis
arcpy.management.SplitRaster(in_raster, out_folder, out_base_name, split_method, format, {resampling_type}, {num_rasters}, {tile_size}, {overlap}, {units}, {cell_size}, {origin}, {split_polygon_feature_class}, {clip_type}, {template_extent}, {nodata_value})| Parámetro | Explicación | Tipo de datos |
in_raster | El ráster que se va a dividir. | Mosaic Dataset; Mosaic Layer; Raster Layer |
out_folder | El destino de los nuevos datasets ráster. | Folder |
out_base_name | El prefijo de cada uno de los dataset ráster que se van a crear. Se agregará un número a cada prefino, empezando por 0. | String |
split_method | Determina cómo se va a dividir el dataset ráster.
| String |
format | El formato de los datasets ráster de salida.
| String |
resampling_type (Opcional) | Elija la técnica adecuada según el tipo de datos de los que disponga.
| String |
num_rasters (Opcional) | El número de columnas (x) y filas (y) entre los que se va a dividir el dataset ráster. Es un punto cuyas coordenadas X e Y definen el número de filas y columnas. La coordenada X corresponde al número de columnas y la coordenada Y, al número de filas. | Point |
tile_size (Opcional) | Dimensiones x e y de las teselas de salida. La unidad de medida predeterminada es en píxeles. Puede cambiarla con el parámetro units. Es un punto cuyas coordenadas X e Y definen las dimensiones de las teselas de salida. La coordenada X corresponde a la dimensión horizontal de la salida y la coordenada Y corresponde a la dimensión vertical de la salida. | Point |
overlap (Opcional) | No es necesario que las teselas estén alineadas perfectamente; defina la cantidad de superposición entre las teselas con este parámetro. La unidad de medida predeterminada es en píxeles. Puede cambiarla con el parámetro units. | Double |
units (Opcional) | Defina las unidades de medida para los parámetros tile_size y overlap.
| String |
cell_size (Opcional) | La resolución espacial del ráster de salida. Si lo deja en blanco, el tamaño de celda de salida coincidirá con el ráster de entrada. Si cambia los valores de tamaño de celda, el tamaño de tesela se devuelve al tamaño de la imagen y el recuento de teselas se devuelve a 1. | Point |
origin (Opcional) | Cambia las coordenadas del punto de origen inferior izquierdo, donde comenzará el esquema de ordenamiento en teselas. Si lo deja en blanco, el origen inferior izquierdo será igual al ráster de entrada. | Point |
split_polygon_feature_class (Opcional) | Clase de entidad que se utilizará para dividir el dataset ráster. | Feature Layer |
clip_type (Opcional) | Limita la extensión del dataset ráster antes de dividirlo.
| String |
template_extent (Opcional) | Extensión o dataset que se utiliza para definir el límite de recorte. El dataset puede ser un ráster o una clase de entidad. | Extent |
nodata_value (Opcional) | Todos los píxeles con el valor especificado se establecerán como NoData en el dataset ráster de salida. | String |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| derived_out_folder | La carpeta de salida. | Carpeta |
Muestra de código
Ejemplo 1 de SplitRaster (ventana de Python)
Esta es una muestra de Python para la herramienta SplitRaster.
import arcpy
arcpy.SplitRaster_management("c:/source/large.tif", "c:/output/splitras",
"ras", "NUMBER_OF_TILES", "TIFF", "NEAREST",
"2 2", "#", "10", "PIXELS", "#", "#")
Ejemplo 2 de SplitRaster (script independiente)
Esta es una muestra del script de Python para la herramienta SplitRaster.
##====================================
##Split Raster
##Usage: SplitRaster_management in_raster out_folder out_base_name SIZE_OF_TILE
## | NUMBER_OF_TILES | TIFF | BMP | ENVI | ESRI BIL |
## ESRI BIP | ESRI BSQ | GIF | GRID | IMAGINE IMAGE |
## JP2 | JPG | PNG {NEAREST | BILINEAR | CUBIC |
## MAJORITY} {num_rasters} {tile_size} {overlap}
## {PIXELS | METERS | FEET | DEGREES | KILOMETERS |
## MILES} {cell_size} {origin}
import arcpy
arcpy.env.workspace = r"\\myServer\PrjWorkspace\RasGP"
##Equally split a large TIFF image by number of images
arcpy.SplitRaster_management("large.tif", "splitras", "number", "NUMBER_OF_TILES",\
"TIFF", "NEAREST", "2 2", "#", "4", "PIXELS",\
"#", "#")
##Equally split a large TIFF image by size of images
arcpy.SplitRaster_management("large.tif", "splitras", "size2", "SIZE_OF_TILE",\
"TIFF", "BILINEAR", "#", "3500 3500", "4", "PIXELS",\
"#", "-50 60")
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí