| Etiqueta | Explicación | Tipo de datos |
Entidades de entrada | El dataset de entidades de entrada de polígono que se va a convertir a un ráster. | Feature Layer |
Campo de valor | 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 | Field |
Dataset ráster de salida | El dataset ráster de salida que se creará. Si el ráster de salida no se va a guardar en una geodatabase, especifique .tif para formato de archivo TIFF, .CRF para un formato de archivo CRF, .img para un formato de archivo ERDAS IMAGINE o ninguna extensión para el formato ráster de cuadrícula de Esri. | Raster Dataset |
Tipo de asignación de celdas (Opcional) | El método para determinar cómo se asignará un valor a la celda cuando más de una entidad caiga dentro de una celda.
| String |
Prioridad del campo (Opcional) | Este campo se usa para determinar qué entidad debe tener preferencia sobre otra entidad que cae sobre una celda. Cuando se utiliza, se selecciona siempre para la conversión la entidad con la prioridad positiva mayor, independientemente del Tipo de asignación de celdas elegido. | Field |
Tamaño de celda (Opcional) | Tamaño de celda del ráster de salida que se crea. 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, en caso de que se haya especificado; de lo contrario, se utilizan reglas adicionales para calcularlo a partir de las demás entradas. Consulte Usos para obtener más detalles. | Analysis Cell Size |
Construir tabla de atributos ráster (Opcional) | Especifica si el ráster de salida tendrá una tabla de atributos ráster. Este parámetro solo se aplica a los rásteres enteros.
| Boolean |
Disponible con una licencia Advanced.
Resumen
Convierte las entidades de polígono a dataset ráster.
Obtenga más información sobre cómo funciona la herramienta De polígono a ráster
Uso
Cualquier clase de entidad (geodatabase, shapefile o cobertura) que contenga entidades poligonales 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.
Si el campo de entrada contiene valores de cadenas de caracteres, el ráster de salida contendrá un campo de valor entero y un campo de cadenas de caracteres.
No obstante, si el campo es del tipo de punto flotante y los valores se expresan como enteros, el ráster de salida será entonces un entero.
El Tamaño de celda 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 ni 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 menor de la extensión dividida 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 ha especificado usando un valor numérico, la herramienta lo utilizará directamente para el ráster de salida.
Si el tamaño de celda se ha especificado mediante un dataset ráster, el parámetro mostrará 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 es un complemento de la herramienta De ráster a polígono, que convierte un ráster en una clase de entidad poligonal.
Cuando hay más de una entidad presente en una celda de salida, esta herramienta proporciona un mayor control sobre la asignación de los valores de celdas que la herramienta Entidad a ráster.
Si aparecen franjas o sangrados en el ráster de salida, use las herramientas Verificar geometría y Reparar geometría para corregir los datos de entidad de entrada.
Cuando convierte polígonos superpuestos, es posible que desee que los polígonos con el área más pequeña se asignen a una celda. Una manera fácil de hacer esto es agregar un campo adicional a la clase de entidad de entrada y calcularlo al área inversa de los polígonos, después utilice este campo como el Campo de prioridad cuando ejecuta esta herramienta.
Para los formatos de datos que admiten valores nulos, como las clases de entidad de geodatabase de archivos, se ignorará un valor nulo cuando se utilice como entrada.
Se pueden aplicar algunos entornos de almacenamiento de ráster a esta herramienta.
En el 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 con la herramienta Crear pirámides.
En el entorno Compresión solo se puede respetar el tipo de compresión. Esto se aplica a los formatos ráster que no sean Cuadrícula de Esri.
Parámetros
arcpy.conversion.PolygonToRaster(in_features, value_field, out_rasterdataset, {cell_assignment}, {priority_field}, {cellsize}, {build_rat})| Nombre | Explicación | Tipo de datos |
in_features | El dataset de entidades de entrada de polígono que se va a convertir a un ráster. | Feature Layer |
value_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 | Field |
out_rasterdataset | El dataset ráster de salida que se creará. Si el ráster de salida no se va a guardar en una geodatabase, especifique .tif para formato de archivo TIFF, .CRF para un formato de archivo CRF, .img para un formato de archivo ERDAS IMAGINE o ninguna extensión para el formato ráster de cuadrícula de Esri. | Raster Dataset |
cell_assignment (Opcional) | El método para determinar cómo se asignará un valor a la celda cuando más de una entidad caiga dentro de una celda.
| String |
priority_field (Opcional) | Este campo se usa para determinar qué entidad debe tener preferencia sobre otra entidad que cae sobre una celda. Cuando se utiliza, se selecciona siempre para la conversión la entidad con la prioridad positiva mayor, independientemente del Tipo de asignación de celdas elegido. | Field |
cellsize (Opcional) | Tamaño de celda del ráster de salida que se crea. 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, en caso de que se haya especificado; de lo contrario, se utilizan reglas adicionales para calcularlo a partir de las demás entradas. Consulte Usos para obtener más detalles. | Analysis Cell Size |
build_rat (Opcional) | Especifica si el ráster de salida tendrá una tabla de atributos ráster. Este parámetro solo se aplica a los rásteres enteros.
| Boolean |
Muestra de código
Convierte las entidades de polígono a dataset ráster.
import arcpy
arcpy.env.workspace = "c:/data"
arcpy.conversion.PolygonToRaster("ca_counties.shp", "NAME",
"c:/output/ca_counties.img",
"MAXIMUM_AREA", "MALES", 0.25)Convierte las entidades de polígono a dataset ráster.
# Name: PolygonToRaster_Ex_02.py
# Description: Converts polygon features to a raster dataset.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
inFeatures = "ca_counties.shp"
valField = "NAME"
outRaster = "c:/output/ca_counties"
assignmentType = "MAXIMUM_AREA"
priorityField = "MALES"
cellSize = 0.5
# Run PolygonToRaster
arcpy.conversion.PolygonToRaster(inFeatures, valField, outRaster,
assignmentType, priorityField, cellSize)