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 de la secuencia de comandos) y la opción Etiquetar entidades del cuadro de diálogo (el parámetro label_features de la secuencia de comandos).
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 la secuencia de comandos) 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 se encuentra establecido en ATTRIBUTES en la secuencia de comandos), 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 ninguna Entidad de etiqueta, 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 proporcionan Entidades de etiqueta, ninguno de los esquemas de atributos de entrada se mantendrá en la clase de entidad de salida; sólo 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 Preservar atributos en el cuadro de diálogo está desactivada (el parámetro attributes está definido como NO_ATTRIBUTES en la secuencia de comandos), 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 de polígono de salida más pequeñas, se podrá utilizar la herramienta Identidad para transferir atributos desde las entidades de polígono de entrada hasta las entidades de polígono 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
FeatureToPolygon_management (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) | Especifica si mantener los atributos o el esquema de atributos de entrada de entidades de etiqueta en la clase de entidad de salida, o si omitir cualquier atributo de entrada en la clase de entidad de salida. Este parámetro no funciona. No se quitará para la compatibilidad con versiones anteriores de secuencias de comandos o modelos. Los valores de campo y del esquema de atributos de salida para ciertas combinaciones de entrada se pueden producir tal como se describe en las notas de uso; la mayoría de ellos no son intencionados.
| 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)
La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función FeatureToPolygon en el modo inmediato.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.FeatureToPolygon_management(["mainroads.shp","streets.shp"],
"c:/output/output.gdb/streetblocks",
"", "NO_ATTRIBUTES", "")
Ejemplo 2 de FeatureToPolygon (secuencia de comandos independiente)
La siguiente secuencia de comandos independiente es un ejemplo simple de cómo aplicar la función FeatureToPolygon en un entorno de secuencias de comandos.
# Name: FeatureToPolygon_Example2.py
# Description: Use FeatureToPolygon function to construct habitat areas
# from park boundaries and rivers.
# Author: ESRI
# import system modules
import arcpy
from arcpy import env
# Set environment settings
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
- 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 sobre licencias
- ArcGIS Desktop Basic: No
- ArcGIS Desktop Standard: No
- ArcGIS Desktop Advanced: Sí