Resumen
Convierte un archivo ASCII que representa datos ráster en un dataset ráster.
Uso
El archivo de entrada es un archivo de texto con formato ASCII.
La estructura del archivo ASCII consta de información de encabezamiento que contiene un conjunto de palabras clave, seguida de los valores de las celdas en un orden mayor de filas.
Hay dos variaciones de la estructura del archivo ASCII. Una identifica el origen por las coordenadas de la esquina inferior izquierda de la celda inferior izquierda; la otra como el centro de la celda inferior izquierda.
El formato del archivo en general es:
NCOLS xxx NROWS xxx XLLCORNER xxx YLLCORNER xxx CELLSIZE xxx NODATA_VALUE xxx row 1 row 2 . . row n
Las definiciones de las palabras clave son las siguientes:
NCOLS y NROWS son el número de columnas y filas del ráster definido por el archivo ASCII.
XLLCORNER y YLLCORNER son las coordenadas de la esquina inferior izquierda de la celda inferior izquierda.
También puede utilizar XLLCENTER y YLLCENTER para especificar el origen por las coordenadas del centro de la celda inferior izquierda.
CELLSIZE es el tamaño de la celda del ráster.
NODATA_VALUE es el valor que representa las celdas NoData.
Los valores de las celdas deberían estar delimitados por espacios. No se necesitan devoluciones de acarreo al final de cada fila en el archivo ASCII. El número de columnas en el encabezado se utiliza para determinar cuándo comienza una nueva fila.
Un ejemplo de un archivo ráster ASCII es:
NCOLS 480 NROWS 450 XLLCORNER 378922 YLLCORNER 4072345 CELLSIZE 30 NODATA_VALUE -32768 43 2 45 7 3 56 2 5 23 65 34 6 32 54 57 34 35 45 65 34 2 6 78 4 2 6 89 3 2 7 45 23 5 ...
-
NODATA_VALUE es el valor del archivo ASCII que se asignará a las celdas NoData en el ráster de salida. Este valor normalmente se reserva para aquellas celdas cuyo valor verdadero es desconocido. Cuando se crea un ráster de salida, un valor NoData generado por el sistema se usará en lugar del NODATA_VALUE. El tema NoData en datasets ráster contiene información acerca de cómo cambiar el valor NoData una vez creado el ráster.
El número de valores de celdas que contiene el archivo debe ser igual al número de filas por el número de columnas o se producirá un error.
El tipo de datos de salida puede ser flotante o entero.
Una vez que se haya creado el ráster de salida, utilice la herramienta Definir proyección para asignarle el sistema de coordenadas apropiado.
Se pueden aplicar algunos Entornos de almacenamiento de ráster a esta herramienta.
De las configuraciones del entorno Pirámide solo se respeta la configuración Crear pirámides. Las restantes configuraciones del entorno Pirámide se ignoran. Se puede obtener más control sobre la naturaleza de las pirámides en un paso posterior mediante el uso de la herramienta Crear pirámides.
De las configuraciones del entorno Estadísticas de ráster solo se admite la configuración del parámetro Calcular estadísticas en Ninguno (los otros parámetros se ignoran). Esto solo se aplica a los formatos ráster que no sean Cuadrícula de Esri.
De las configuraciones del entorno Compresión solo se puede respetar el tipo de compresión. Esto solo se aplica a los formatos ráster que no sean Cuadrícula de Esri.
Sintaxis
ASCIIToRaster(in_ascii_file, out_raster, {data_type})
Parámetro | Explicación | Tipo de datos |
in_ascii_file | El archivo ASCII de entrada que se va a convertir. | File |
out_raster | El dataset ráster de salida que se creará. Cuando no guarde en una geodatabase, especifique .tif para un formato de archivo TIFF, .img para un formato de archivo ERDAS IMAGINE o ninguna extensión para un formato ráster de cuadrícula de Esri. | Raster Dataset |
data_type (Opcional) | El tipo de datos del dataset ráster de salida.
| String |
Muestra de código
Ejemplo 1 de ASCIIToRaster (ventana de Python)
Convierte un archivo ASCII que representa datos ráster en un dataset ráster.
import arcpy
arcpy.ASCIIToRaster_conversion("c:/data/elevation.asc", "c:/output/elevation",
"INTEGER")
Ejemplo 2 de ASCIIToRaster (secuencia de comandos independiente)
Convierte un archivo ASCII que representa datos ráster en un dataset ráster.
# Name: ASCIIToRaster_Ex_02.py
# Description: Converts an ASCII file representing raster data to a raster
# dataset.
# Import system modules
import arcpy
# Set local variables
inASCII = "c:/data/elevation.asc"
outRaster = "c:/output/elevation02"
rasterType = "INTEGER"
# Execute ASCIIToRaster
arcpy.ASCIIToRaster_conversion(inASCII, outRaster, rasterType)
Entornos
Información sobre licencias
- Basic: Sí
- Standard: Sí
- Advanced: Sí