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 usa como entrada archivos de texto y archivos .csv, asegúrese de que siguen la estructura de archivo especificada en 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 curva paramétrica (verdadera) en la salida; en cambio, se almacena como 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 en 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 y elija la opción Geodésico, Loxodromia o Elíptico grande correspondiente antes de realizar una medición.

Sintaxis

arcpy.management.XYToLine(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. Puede ser un archivo de texto, archivo CSV, archivo de Excel, tabla dBASE o 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

Un campo numérico proveniente de la tabla de entrada y que contiene las coordenadas x (o longitudes) de los puntos iniciales de las líneas que se deben posicionar en el sistema de coordenadas de salida especificado por el parámetro spatial_reference.

Field
starty_field

Un campo numérico proveniente de la tabla de entrada y que contiene las coordenadas y (o latitudes) de los puntos iniciales de las líneas que se deben posicionar 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 — Se creará un tipo de línea geodésica que representa de la forma más precisa la distancia más corta entre dos puntos de la superficie de la Tierra. La definición matemática de la línea geodésica es bastante larga y compleja, por lo tanto, aquí se omitirá. Esta es la opción predeterminada.
  • GREAT_CIRCLE —Se creará un tipo de línea geodésica que represente la ruta entre dos puntos a lo largo de la intersección de la superficie de la Tierra y un plano que atraviese el centro de la Tierra. En función del sistema de coordenadas de salida especificado en el parámetro Referencia espacial, en un sistema de coordenadas basado en un esferoide, la línea es un elíptico grande; en un sistema de coordenadas basado en una esfera, la línea se llama excepcionalmente un círculo grande: un círculo con el radio más grande de la superficie esférica.
  • RHUMB_LINE —Se creará un tipo de línea geodésica, también conocida como línea de loxodromia, que representa una ruta entre dos puntos de la superficie de un esferoide definido por un acimut constante desde un polo. Una línea de rumbo se muestra como una línea recta en la proyección de Mercator.
  • NORMAL_SECTION —Se creará un tipo de línea geodésica que represente la ruta entre dos puntos de la superficie de un esferoide definido por la intersección de la superficie del esferoide y un plano que atraviese los dos puntos y sea normal (perpendicular) a la superficie del esferoide en el punto de partida de ambos 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 de la tabla de entrada. Este campo y los valores se incluyen en la salida y se pueden utilizar para unir las entidades de salida con los registros de la tabla de entrada.

Field
spatial_reference
(Opcional)

La referencia espacial de la clase de entidades de salida. Se puede especificar una referencia espacial de cualquiera de estas maneras:

  • La ruta a un archivo .prj, como C:/workspace/watershed.prj
  • La ruta a una clase de entidad o dataset de entidades cuya referencia espacial desee aplicar, como C:/workspace/myproject.gdb/landuse/grassland
  • Un objeto SpatialReference, como arcpy.SpatialReference("C:/data/Africa/Carthage.prj")

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 de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados