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
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.
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. | Linear Unit |
attributes (Opcional) | 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
- Palabra clave CONFIG de salida
- Dominio Z de salida
- Sistema de coordenadas de salida
- Extensión
- La salida tiene valores M
- La salida tiene valores Z
- Cuadrícula espacial de salida 1
- Cuadrícula espacial de salida 2
- Cuadrícula espacial de salida 3
- Resolución XY
- Tolerancia XY
- Resolución Z
- Tolerancia Z
Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Sí