De entidad a polígono (Administración de datos)

Disponible con una licencia Advanced.

Resumen

Crea un clase de entidad que contiene polígonos generados a partir de áreas encerradas por entidades de polígono o de línea de entrada.

Ilustración

De entidad a polígono

Uso

• Donde una o más entidades de entrada forman un área cerrada, se construirá un polígono nuevo y se escribirá en la clase de entidad de salida. Los atributos de salida variarán según la opción Mantener atributos del cuadro de diálogo (el parámetro attributes del script) y la opción Etiquetar entidades del cuadro de diálogo (el parámetro label_features del script).

• Cuando se especifican varias clases o capas de entidades en la lista de entidades de entrada, el orden de las entradas en la lista no afecta el tipo de entidad de salida, pero la referencia espacial de la entrada superior en el cuadro de diálogo de la herramienta (la primera entrada en el script) en la lista se utilizará durante el procesamiento y se establecerá en la salida.

• Las curvas paramétricas (verdaderas) en las entidades de entrada permanecerán como curvas verdaderas en los polígonos de salida, incluso si están divididas. Esto no se aplica a los datos de shapefile.

• Nota:

  El parámetro Mantener atributos (el parámetro attributes del script) no funciona y no debería utilizarse. No se quitará para la compatibilidad con versiones anteriores de scripts o modelos. Los valores de campo y el esquema de atributos de salida para ciertas combinaciones de entrada se pueden producir tal como se describe a continuación; la mayoría de ellos no son intencionados.

  Si la opción Mantener atributos del cuadro de diálogo se encuentra activada (el parámetro attributes está establecido en ATTRIBUTES en el script), los valores de campo y el esquema de atributos de salida dependerán de si las entidades de etiqueta (puntos) se proporcionan en las siguientes formas:

  • Si no se proporciona nada para Etiquetar entidades, el esquema de atributos (nombres y propiedades de campo, no valores de campo) de cada registro de la entrada se mantendrá en la salida en el orden en que aparece en la lista de entrada. Se agregará un campo nuevo, FID_xxx, donde xxx es el nombre de la clase de entidad de origen de una entrada en particular, a la salida de cada entrada y se definirá con un valor de -1. Todos los demás campos tendrán valores de cero o nulos.
  • Si se proporciona algo para Entidades de etiqueta, ninguno de los esquemas de atributos de entrada se mantendrá en la clase de entidad de salida; solo los atributos de las entidades de etiqueta se incluirán en la clase de entidad de salida. Si un polígono de salida contiene una entidad de etiqueta, tendrá valores de campo de esa entidad de etiqueta. Si un polígono de salida tiene más de una entidad de etiqueta, tendrá valores de campo de uno de ellos; de otra forma, tendrá valores de campo cero o nulos.

• Si la opción Mantener atributos del cuadro de diálogo está desactivada (el parámetro attributes está establecido en NO_ATTRIBUTES en el script), los esquemas de atributo de entrada se escribirán en la salida, pero los valores de atributos estarán vacíos. Si no desea que haya ningún atributo en la clase de entidad poligonal de salida, introduzca una clase de entidad de puntos que no tenga atributos para el parámetro Etiquetar entidades.

• Donde las entidades de polígono de entrada se rompan en entidades poligonales de salida más pequeñas, se podrá utilizar la herramienta Identidad para transferir atributos desde las entidades poligonales de entrada hasta las entidades poligonales resultantes.

• Esta herramienta utilizará un proceso de ordenamiento en tesela para controlar datasets muy grandes para mejorar el rendimiento y la escalabilidad. Para obtener más detalles, consulte Geoprocesamiento con datasets grandes.

Sintaxis

arcpy.management.FeatureToPolygon(in_features, out_feature_class, {cluster_tolerance}, {attributes}, {label_features})

Parámetro	Explicación	Tipo de datos
in_features [in_features,...]	Las entidades de entrada que pueden ser línea o polígono, o ambos.	Feature Layer
out_feature_class	La clase de entidad poligonal de salida.	Feature Class
cluster_tolerance (Opcional)	La distancia mínima que separa todas las coordenadas de entidades, y la distancia que se puede mover una coordenada en X, en Y, o en ambas durante el cálculo espacial. La tolerancia XY predeterminada se establece como 0,001 metros o su equivalente en unidades de entidad. Precaución: El cambio del valor de este parámetro puede generar un fallo o resultados inesperados. Se recomienda no modificar este parámetro. Se ha eliminado de la vista en el cuadro de diálogo de la herramienta. Se utiliza de forma predeterminada la propiedad tolerancia x,y de referencia espacial de la clase de entidad de entrada.	Linear Unit
attributes (Opcional)	Heredado: Este parámetro ya no es compatible.	Boolean
label_features (Opcional)	Entidades de puntos de entrada opcionales que alojan a los atributos que se transferirán a las entidades de polígono de salida.	Feature Layer

Muestra de código

Ejemplo 1 de FeatureToPolygon (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función FeatureToPolygon en modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.FeatureToPolygon_management(["mainroads.shp","streets.shp"],
                                  "c:/output/output.gdb/streetblocks",
                                  "", "NO_ATTRIBUTES")

Ejemplo 2 de FeatureToPolygon (script independiente)

El siguiente script independiente es un ejemplo simple de cómo aplicar la función FeatureToPolygon en un entorno de scripts.

# Name: FeatureToPolygon_Example2.py
# Description: Use FeatureToPolygon function to construct habitat areas
#              from park boundaries and rivers.
# import system modules 
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/parks_analysis.gdb"
# Set local parameters
inFeatures = ["park_boundaries", "rivers"]
outFeatureClass = "c:/output/output.gdb/habitat_areas"
clusTol = "0.05 Meters"
# Use the FeatureToPolygon function to form new areas
arcpy.FeatureToPolygon_management(inFeatures, outFeatureClass, clusTol,
                                  "NO_ATTRIBUTES")

Entornos

Espacio de trabajo actual, Espacio de trabajo temporal, Valor Z de salida predeterminado, Resolución M, Tolerancia M, Dominio M de salida, Dominio Z de salida, Sistema de coordenadas de salida, Extensión, La salida tiene valores M, La salida tiene valores Z, Resolución XY, Tolerancia XY, Resolución Z, Tolerancia Z

Información de licenciamiento

• Basic: No
• Standard: Sí
• Advanced: Sí