De polígono a ráster (Conversión)

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.

Sintaxis

arcpy.conversion.PolygonToRaster(in_features, value_field, out_rasterdataset, {cell_assignment}, {priority_field}, {cellsize}, {build_rat})

Parámetro	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. CELL_CENTER —El polígono que se superpone al centro de la celda genera el atributo a asignar a la celda. MAXIMUM_AREA —La única entidad con el área más grande dentro de la celda produce el atributo que se asignará a la celda. MAXIMUM_COMBINED_AREA —Si hay más de una entidad en una celda con el mismo valor, las áreas de estas entidades se combinarán. La entidad combinada con el área más grande dentro de la celda determinará el valor que se le asignará a la 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. BUILD —El ráster de salida tendrá una tabla de atributos ráster. Esta es la opción predeterminada. DO_NOT_BUILD —El ráster de salida no tendrá una tabla de atributos ráster.	Boolean

Muestra de código

Ejemplo 1 de PolygonToRaster (ventana Python)

Convierte las entidades de polígono a dataset ráster.

import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.PolygonToRaster_conversion("ca_counties.shp", "NAME", 
                                 "c:/output/ca_counties.img", 
                                 "MAXIMUM_AREA", "MALES", 0.25)

Ejemplo 2 de PolygonToRaster (script independiente)

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
from arcpy import env

# Set environment settings
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

# Execute PolygonToRaster
arcpy.PolygonToRaster_conversion(inFeatures, valField, outRaster, 
                                 assignmentType, priorityField, cellSize)

Entornos

Auto ejecución, Tamaño de celda, Método de proyección de tamaño de celda, Compresión, Espacio de trabajo actual, Extensión, Transformaciones geográficas, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Pirámide, Espacio de trabajo temporal, Ráster de alineación, Tamaño de tesela

Información de licenciamiento

• Basic: Requiere Spatial Analyst o 3D Analyst
• Standard: Requiere Spatial Analyst o 3D Analyst
• Advanced: Sí