De entidad a línea (Administración de datos)
Resumen
Crea una clase de entidad que contiene líneas generadas al convertir límites de polígonos en líneas o al dividir líneas, polígonos o ambas entidades en sus intersecciones.
Ilustración
Uso
-
Los atributos de entrada se pueden mantener opcionalmente en la clase de entidad de salida, determinados por la opción Mantener atributos en el cuadro de diálogo (el parámetro atributos en 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.
-
Cuando los límites de líneas o polígonos de entrada se toquen, se crucen o se superpongan entre sí en ubicaciones que no sean sus vértices de inicio y fin, se dividirán en esas intersecciones; cada una de las líneas de división se convertirá en una entidad de línea de salida. Si un límite de línea o polígono de entrada no está intersecado por otra entidad, su forma completa aún se escribirá como una entidad de línea.
-
Para las entidades de entrada multiparte, las líneas de salida serán de parte simple.
-
Para las entidades de entrada que son curvas paramétricas (verdaderas), las líneas de salida permanecerán como curvas verdaderas incluso si están divididas. Esto no se aplica a los datos de shapefile.
-
Si está marcada la opción Mantener atributos del cuadro de diálogo (el parámetro atributos se encuentra establecido en ATTRIBUTES en la secuencia de comandos), los atributos de todas las entradas de entrada permanecerán en la salida en el orden en el que aparecen 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 de entrada en particular, a la salida de cada entrada de entrada y se establecerá en los Id. de entidad de origen. Las líneas de salida están asociadas a sus atributos en las siguientes formas:
- Para los límites de líneas o polígonos coincidentes que se encuentren en el mismo conjunto de entidades de entrada, por ejemplo, el límite que separa dos polígonos, se escribirán en la salida dos entidades de línea con geometría idéntica: cada una de ellas tendrá los atributos de su entidad de origen.
- Para los límites de líneas o polígonos coincidentes de dos conjuntos diferentes de entidades de entrada, por ejemplo, una línea que se superpone a un límite de polígono, se escribirá en la salida sólo una entidad de línea con los atributos de ambas entidades de origen.
- Si una línea de salida no se superpone con ninguna entidad en un conjunto de entidades de entrada en particular, tendrá el valor -1 en el campo FID_xxx y valores cero o nulos en los demás campos de ese conjunto de entidades.
Si la opción Mantener atributos del cuadro de diálogo se encuentra desmarcada (el parámetro atributos se encuentra establecido en NO_ATTRIBUTES en la secuencia de comandos), no se mantendrá ninguno de los atributos de entrada en la clase de entidad de salida; se escribirá una entidad de línea simple en la salida para cada conjunto de límites de líneas o polígonos coincidentes.
-
Cuando las entidades de línea contengan polígonos adyacentes, utilice en su lugar la herramienta De_polígono_a_línea para obtener la línea de límite compartido con los Id. de entidad de polígono izquierdo y derecho como atributos en la salida.
-
Esta herramienta utilizará un proceso de ordenamiento en tesela para controlar datasets muy grandes para mejorar el rendimiento y la escalabilidad. Para obtener información más detallada, vea Geoprocesamiento con datasets grandes.
Sintaxis
| 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 de línea 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 se mantendrán o se omitirán los atributos de entrada en la clase de entidad de salida.
| Boolean |
Ejemplo de código
La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función FeatureToLine en el modo inmediato.
import arcpy from arcpy import env env.workspace = "C:/data" arcpy.FeatureToLine_management(["majorrds.shp", "habitat_analysis.gdb/futrds"], "c:/output/output.gdb/allroads", "0.001 Meters", "ATTRIBUTES")
La siguiente secuencia de comandos independiente es un ejemplo simple de cómo aplicar la función FeatureToLine en un entorno de secuencias de comandos.
# Name: FeatureToLine_Example2.py # Description: Use FeatureToLine function to combine features from two # street feature classes into a single feature class, # then determine an area of impact around all streets # by buffering # import system modules import arcpy from arcpy import env # Set environment settings env.workspace = "C:/data" # Set local variables oldStreets = "majorrds.shp" newStreets = "habitat_analysis.gdb/futrds" uptodateStreets = "c:/output/output.gdb/allroads" # Use FeatureToLine function to combine features into single feature class arcpy.FeatureToLine_management([oldStreets, newStreets], uptodateStreets, "0.001 Meters", "ATTRIBUTES") # Use Buffer function to determine area of impact around streets roadsBuffer = "c:/output/output.gdb/buffer_output" arcpy.Buffer_analysis(uptodateStreets, roadsBuffer, "50 Feet", "FULL", "ROUND", "ALL")