Disponible con una licencia Advanced.
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, lo que viene determinado por la opción Mantener atributos en el cuadro de diálogo (el parámetro attributes 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á activada la opción Mantener atributos del cuadro de diálogo (el parámetro attributes está definido como ATTRIBUTES en la secuencia de comandos), los atributos de todas las entradas 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:
- En el caso de líneas o límites de polígono coincidentes dentro del 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.
- En el caso de líneas o límites de polígono coincidentes de dos conjuntos distintos de entidades de entrada, por ejemplo, una línea que se superpone a un límite de polígono, solo se escribirá en la salida 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 desactivada (el parámetro attributes está definido como 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íneas o límites de polígono coincidentes.
Cuando las entidades de línea contengan polígonos adyacentes, utilice 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
FeatureToLine_management (in_features, out_feature_class, {cluster_tolerance}, {attributes})
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
Ejemplo 1 de De entidad a línea (ventana de Python)
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")
Ejemplo 2 de De entidad a línea (secuencia de comandos independiente)
La siguiente secuencia de comandos independiente es un ejemplo de cómo aplicar la función De entidad a línea 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")
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 for Desktop Basic: No
- ArcGIS for Desktop Standard: No
- ArcGIS for Desktop Advanced: Sí