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

Resumen

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

Ilustración

Ilustración de la herramienta 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 el valor del parámetro Mantener atributos y el valor del parámetro Entidades de etiqueta.

  • 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 al 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 Python) 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:

    Se recomienda no utilizar el parámetro Mantener atributos, ya que ya no es compatible y no funciona. Sin embargo, se mantendrá para garantizar la compatibilidad con versiones anteriores de scripts y modelos. Si bien 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 el parámetro Mantener atributos está activado, el esquema de atributos y los valores de campo de salida dependerán de si las entidades de etiqueta (puntos) se proporcionan de las siguientes formas:

    • Si no se proporciona ningún valor en el parámetro Entidades 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 proporciona un valor para el parámetro 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 contiene más de una entidad de etiqueta, tendrá valores de campo de una de ellos; de lo contrario, tendrá valores de campo cero o nulos.
  • Si el parámetro Mantener atributos está desactivado, los esquemas de atributos de entrada se escribirán en la salida; sin embargo, los valores de atributo 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 Entidades de etiqueta.

  • Cuando las entidades poligonales de entrada se descompongan en entidades poligonales de salida más pequeñas, puede utilizar la herramienta Identidad para transferir atributos desde las entidades poligonales de entrada hasta las entidades poligonales resultantes.

  • Para mejorar el rendimiento y la escalabilidad, esta herramienta utiliza un proceso de ordenamiento en teselas para manejar datasets muy grandes. Para más información, consulte Procesamiento en teselas de datasets grandes.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las entidades de entrada, que pueden ser de línea, polígono o ambas.

Feature Layer
Clase de entidad de salida

La clase de entidad poligonal de salida.

Feature Class
Tolerancia XY
(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
Mantener atributos
(Opcional)
Nota:

Este parámetro ya no es compatible. El parámetro se mantendrá para garantizar la compatibilidad con versiones anteriores de secuencias de comandos y modelos. Consulte la sección Uso para obtener más información.

Boolean
Entidades de etiqueta
(Opcional)

Entidades de puntos de entrada opcionales que alojan a los atributos que se transferirán a las entidades poligonales de salida.

Feature Layer

arcpy.management.FeatureToPolygon(in_features, out_feature_class, {cluster_tolerance}, {attributes}, {label_features})
NombreExplicaciónTipo de datos
in_features
[in_features,...]

Las entidades de entrada, que pueden ser de línea, polígono o ambas.

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)
Nota:

Este parámetro ya no es compatible. El parámetro se mantendrá para garantizar la compatibilidad con versiones anteriores de secuencias de comandos y modelos. Consulte la sección Uso para obtener más información.

Boolean
label_features
(Opcional)

Entidades de puntos de entrada opcionales que alojan a los atributos que se transferirán a las entidades poligonales 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 muestra cómo utilizar la función FeatureToPolygon de modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.FeatureToPolygon(["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.management.FeatureToPolygon(inFeatures, outFeatureClass, clusTol,
                                  "NO_ATTRIBUTES")

Temas relacionados