Resumen
Convierte las entidades a dataset ráster.
Uso
Cualquier clase de entidad (geodatabase, shapefile o cobertura) que contenga entidades de puntos, líneas o polígonos se puede convertir a un dataset ráster.
El tipo de campo de entrada determina el tipo de ráster de salida. Si el campo es entero, el ráster de salida será entero, si es punto flotante, la salida será punto flotante.
El Tamaño de celda de salida se puede definir mediante un valor numérico u obtenerse desde un dataset ráster existente. Si el tamaño de celda no se ha especificado explícitamente como el valor del parámetro, se deriva del entorno Tamaño de celda si se ha especificado. Si no se ha especificado el tamaño de celda del parámetro o el tamaño de celda del entorno, pero se ha configurado el entorno Ráster de alineación, se usa el tamaño de celda del ráster de alineación. Si no se especifica nada, el tamaño de celda se calcula a partir de la anchura o la altura de la extensión dividido por 250, donde la extensión se encuentra en el Sistema de coordenadas de salida especificado en el entorno.
Si el tamaño de celda se especifica usando un valor numérico, la herramienta lo usa directamente para el ráster de salida.
Si el tamaño de celda se especifica mediante un dataset ráster, el parámetro muestra la ruta del dataset ráster en lugar del valor del tamaño de celda. El tamaño de celda de ese dataset ráster se usa directamente en el análisis, siempre que la referencia espacial del dataset sea la misma que la referencia espacial de salida. Si la referencia espacial del dataset es diferente, se proyecta en función del Método de proyección de tamaño de celda seleccionado.
Esta herramienta siempre utiliza el centro de la celda para decidir el valor de un píxel de ráster. Si se necesita más control respecto a la manera de convertir los distintos tipos de geometrías de entidades de entrada, consulte sus respectivas herramientas de conversión concretas: De punto a ráster, De polilínea a ráster y De polígono a ráster.
Esta herramienta complementa a las herramientas De ráster a punto, De ráster a polilínea y De ráster a polígono, que convierte un ráster a distintos tipos de geometrías de dataset de entidades.
Al seleccionar los datos de entidad de entrada, el campo predeterminado será el primer campo válido disponible. Si no existen otros campos válidos, el campo ObjectID (por ejemplo, OID o FID) será el valor predeterminado.
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 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
arcpy.conversion.FeatureToRaster(in_features, field, out_raster, {cell_size})
Parámetro | Explicación | Tipo de datos |
in_features | El dataset de entidades de entrada que se va a convertir a un dataset ráster. | Feature Layer |
field | El campo que se utiliza para asignar los valores al ráster de salida. Puede ser cualquier campo de la tabla de atributos del dataset de entidades de entrada Si el campo Forma de un dataset de punto o multipunto contiene valores z o m, se puede utilizar cualquiera de estos. | Field |
out_raster | El dataset ráster de salida que se creará. Cuando no vaya a guardar en una geodatabase, especifique .tif para un formato de archivo TIFF, .CRF para un formato de archivo CRF, .img para un formato de archivo ERDAS IMAGINE o ninguna extensión para un formato ráster de cuadrícula de Esri. | Raster Dataset |
cell_size (Opcional) | El tamaño de celda para el ráster de salida que se está creando. Este parámetro se puede definir mediante un valor numérico u obtenerse desde un dataset ráster existente. Si el tamaño de celda no se ha especificado explícitamente como el valor del parámetro, se usa el valor del tamaño de celda del entorno si se ha especificado; de lo contrario, se utilizan algunas reglas adicionales para calcularlo a partir de las otras entradas. Consulte su uso para obtener más detalles. | Analysis Cell Size |
Muestra de código
Ejemplo 1 de FeatureToRaster (ventana de Python)
Convierte las entidades a dataset ráster.
import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.FeatureToRaster_conversion("roads.shp", "CLASS", "c:/output/roadsgrid", 25)
Ejemplo 2 de FeatureToRaster (script independiente)
Convierte las entidades a dataset ráster.
# Name: FeatureToRaster_Ex_02.py
# Description: Converts features to a raster dataset.
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inFeature = "roads.shp"
outRaster = "c:/output/roadsgrd"
cellSize = 25
field = "CLASS"
# Execute FeatureToRaster
arcpy.FeatureToRaster_conversion(inFeature, field, outRaster, cellSize)
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí