ArcMap

De XY a línea

Resumen

Crea una nueva clase de entidad que contiene entidades de línea geodésica construida en base a los valores de un campo de coordenadas x de inicio, campo de coordenadas y de inicio, campo de coordenadas x de fin y campo de coordenadas y de fin de una tabla.

Uso

  • Si utiliza archivos de texto y archivos .csv (valores separados por comas) como entrada, asegúrese de que se siga la estructura de archivos que se especifica en Acerca de las fuentes de datos tabulares.

  • Cada línea geodésica se construye utilizando un determinado conjunto de valores de campo que representa las coordenadas x e y de un punto de partida y las coordenadas x e y de un punto de finalización. Estos campos y valores se incluirán en la salida.

  • Una línea geodésica es una curva en la superficie de la tierra. Sin embargo, una entidad de línea geodésica no se almacena como una curva paramétrica (verdadera) en la salida, sino como una polilínea densificada que representa la ruta de la línea geodésica. Si la longitud de una línea geodésica es relativamente corta, se puede representar con una línea recta en la salida. A medida que la longitud de la línea aumenta, se utilizarán más vértices para representar la ruta.

  • Cuando la salida es una clase de entidad de una geodatabase de archivos o una geodatabase personal, los valores del campo Shape_Length siempre están en las unidades del sistema de coordenadas de salida especificado por el parámetro Referencia espacial y son las longitudes planares de las polilíneas. Para medir una distancia o longitud geodésica, utilice la herramienta Medir de ArcMap. Asegúrese de elegir la opción Geodésico, Loxodromia o Elíptico grande, según corresponda, antes de realizar una medición.

Sintaxis

XYToLine_management (in_table, out_featureclass, startx_field, starty_field, endx_field, endy_field, {line_type}, {id_field}, {spatial_reference})
ParámetroExplicaciónTipo de datos
in_table

La tabla de entrada, que puede ser un archivo de texto, un archivo CSV, un archivo de Excel, una tabla de dBASE o una tabla de geodatabase.

Table View
out_featureclass

La clase de entidad de salida que contiene las líneas geodésicas densificadas.

Feature Class
startx_field

Campo numérico de la tabla de entrada que incluye las coordenadas x (o longitudes) de los puntos de partida de líneas que se van a situar en el sistema de coordenadas de salida especificado por el parámetro spatial_reference.

Field
starty_field

Campo numérico de la tabla de entrada que incluye las coordenadas y (o latitudes) de los puntos de partida de líneas que se van a situar en el sistema de coordenadas de salida especificado por el parámetro spatial_reference.

Field
endx_field

Un campo numérico de la tabla de entrada que contiene las coordenadas x (o longitudes) de los puntos de finalización de las líneas que se colocarán en el sistema de coordenadas de salida especificado por el parámetro spatial_referenceSpatial_reference.

Field
endy_field

Un campo numérico de la tabla de entrada que contiene las coordenadas y (o latitudes) de los puntos de finalización de las líneas que se colocarán en el sistema de coordenadas de salida especificado por el parámetro spatial_reference.

Field
line_type
(Opcional)

El tipo de línea geodésica que se creará.

  • GEODESIC — Un tipo de línea geodésica que representa de manera más precisa la distancia más corta entre dos puntos en la superficie de la tierra. La definición matemática de la línea geodésica es bastante larga y compleja y, por lo tanto, se omite en este tema. Este tipo de línea es el opción predeterminada.
  • GREAT_CIRCLE —Un tipo de línea geodésica que representa la ruta entre dos puntos en la intersección de la superficie de la tierra y un plano que atraviesa el centro de la tierra. Dependiendo del sistema de coordenadas de salida especificado por el parámetro Referencia espacial, en un sistema de coordenadas basado en esferoides, la línea es un elíptico grande; en un sistema de coordenadas basado en esferas, la línea se llama de forma única un círculo grande, un círculo del radio más grande en la superficie esférica.
  • RHUMB_LINE —Un tipo de línea geodésica, también conocido como una línea loxodrómica, que representa una ruta entre dos puntos en la superficie de un esferoide que se define por un acimut constante de un polo. Una línea de rumbo se muestra como una línea recta en la proyección de Mercator.
  • NORMAL_SECTION —Un tipo de línea geodésica que representa una ruta entre dos puntos en la superficie de un esferoide que se define por la intersección de la superficie del esferoide y de un plano que atraviesa los dos puntos y es normal (perpendicular) para la superficie del esferoide en el punto de partida de los dos puntos. Por lo tanto, la línea de sección normal del punto A al punto B es distinta a la del punto B al punto A.
String
id_field
(Opcional)

Un campo en la tabla de entrada; este campo y los valores se incluyen en la salida y se puede utilizar para unir las entidades de salida con los registros en la tabla de entrada.

Field
spatial_reference
(Opcional)

La referencia espacial de la clase de entidades de salida. Puede especificar la referencia espacial de varias maneras:

  • Introduciendo la ruta en un archivo .prj, como C:/workspace/watershed.prj.
  • Haciendo referencia a una clase de entidad o a un dataset de entidades cuya referencia espacial desee aplicar, como C:/workspace/myproject.gdb/landuse/grassland.
  • Definiendo un objeto de referencia espacial antes de utilizar esta herramienta, como sr = arcpy.SpatialReference("C:/data/Africa/Carthage.prj"), que después utilizará como parámetro de referencia espacial.

Spatial Reference

Muestra de código

Ejemplo de XYToLine (secuencia de comandos independiente)

Esta muestra convierte una tabla DBF en líneas Geodésicas de dos puntos.

# Import system modules
import arcpy
from arcpy import env

# Set local variables
input_table = r"c:\workspace\city2city.dbf"
out_lines = r"c:\workspace\flt4421.gdb\routing001"

#XY To Line
arcpy.XYToLine_management(input_table,out_lines,
                         "LOND1","LATD1","LOND2",
                         "LATD2","GEODESIC","idnum")

Entornos

Información sobre licencias

  • ArcGIS Desktop Basic: Sí
  • ArcGIS Desktop Standard: Sí
  • ArcGIS Desktop Advanced: Sí

Temas relacionados