De XY a línea (Herramientas de administración de datos)
Resumen
Crea una clase de entidad que contiene entidades de línea geodésicas o planares a partir de los valores de un campo de coordenadas x de inicio, un campo de coordenadas y de inicio, un campo de coordenadas x de fin y un campo de coordenadas y de fin de una tabla.
Uso
Las líneas de salida se construyen a partir de valores de campo. Los valores de campo incluyen los siguientes:
Las coordenadas x e y de un punto de partida
Las coordenadas x e y de un punto final
Los campos y sus valores se incluirán en la salida.
Para una línea geodésica, las coordenadas x e y son ubicaciones en la superficie de la tierra. Para una línea planar, las coordenadas son ubicaciones en el plano proyectado.
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, puede representarse mediante una línea recta en el resultado. A medida que aumenta la longitud de la línea, se utilizan más vértices para representar el trazado.
Cuando el resultado es una clase de entidades en una geodatabase, los valores del campo Shape_Length siempre se expresan en las unidades del sistema de coordenadas de salida especificadas por el parámetro Referencia espacial, y corresponden a las longitudes planas de las polilíneas. Para medir una longitud o una distancia geodésica, utilice la herramienta Medir de ArcGIS Pro y elija la opción Geodésico, Loxodromia o Elíptico grande, según corresponda, antes de realizar la medición.
La tabla de entrada. Puede ser un archivo de texto, archivo CSV, archivo de Excel, tabla dBASE o tabla de geodatabase.
Table View
Clase de entidad de salida
La clase de entidad de salida que contiene las líneas geodésicas o planares.
Feature Class
Inicio de campo X
Campo numérico de la tabla de entrada que contiene las coordenadas x (o longitudes) de los puntos de partida de las líneas que se colocarán en el sistema de coordenadas de salida especificado por el parámetro Referencia espacial.
Field
Inicio de campo Y
Un campo numérico de la tabla de entrada que contiene las coordenadas y (o latitudes) de los puntos de partida de las líneas que se colocarán en el sistema de coordenadas de salida especificado por el parámetro Referencia espacial.
Field
Campo X final
Un campo numérico de la tabla de entrada que contiene las coordenadas x (o longitudes) de los puntos de finales de las líneas que se colocarán en el sistema de coordenadas de salida especificado por el parámetro Referencia espacial.
Field
Campo Y final
Un campo numérico de la tabla de entrada que contiene las coordenadas y (o latitudes) de los puntos finales de las líneas que se colocarán en el sistema de coordenadas de salida especificado por el parámetro Referencia espacial.
Field
Tipo de línea
(Opcional)
Especifica el tipo de línea que se creará.
Geodésica—Se trazará un tipo de línea geodésica que represente con mayor precisión la distancia más corta entre dos puntos cualesquiera de la superficie terrestre. Esta es la opción predeterminada.
Círculo grande—Se trazará un tipo de línea geodésica que representa el trayecto entre dos puntos cualesquiera situados en la intersección de la superficie terrestre y un plano que pasa por el centro de la Tierra. Si el valor del parámetro Referencia espacial es un sistema de coordenadas basado en esferoides, la línea es una elipse grande. Si el valor del parámetro Referencia espacial es 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.
Línea de rumbo—Se trazará un tipo de línea geodésica, también conocida como línea loxodrómica, que representa una trayectoria entre dos puntos cualesquiera de la superficie de un esferoide, definida por un azimut constante con respecto a un polo. Una línea de rumbo se representa como una línea recta en la proyección de Mercator.
Sección normal—Se construirá un tipo de línea geodésica que representa un trazado entre dos puntos cualesquiera de la superficie de un esferoide, definido por la intersección de la superficie del esferoide con un plano que pasa por dichos dos puntos y es normal (perpendicular) a la superficie del esferoide en el punto de partida de ambos. La línea de sección normal del punto A al punto B es distinta a la línea del punto B al punto A.
Línea planar—Se utilizará una línea recta en el plano proyectado. Por lo general, una línea planar no representa con precisión la distancia más corta en la superficie de la tierra como lo hace una línea geodésica. Esta opción no está disponible para sistemas de coordenadas geográficas.
String
Id.
(Opcional)
Un campo en 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
Referencia espacial
(Opcional)
La referencia espacial de la clase de entidades de salida. El valor predeterminado es GCS_WGS_1984 o el sistema de coordenadas de entrada si no es Desconocido.
Spatial Reference
Mantener atributos
(Opcional)
Especifica si los campos de entrada restantes se añadirán en la clase de entidad de salida.
Activado—Los campos de entrada restantes se añadirán en la clase de entidad de salida. También se agregará un campo nuevo, ORIG_FID, a la clase de entidad de salida para guardar los valores de ID de entidad de entrada.
Desactivado—Los campos de entrada restantes no se añadirán en la clase de entidad de salida. Esta es la opción predeterminada.
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 o planares.
Feature Class
startx_field
Un campo numérico de la tabla de entrada que contiene las coordenadas x (o longitudes) de los puntos de partida de las líneas que se colocarán en el sistema de coordenadas de salida especificado por el parámetro spatial_reference.
Field
starty_field
Un campo numérico de la tabla de entrada que contiene las coordenadas y (o latitudes) de los puntos de partida finales de las líneas que se colocarán 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 finales de las líneas que se colocarán en el sistema de coordenadas de salida especificado por el parámetro spatial_reference.
Field
endy_field
Un campo numérico de la tabla de entrada que contiene las coordenadas y (o latitudes) de los puntos finales 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)
Especifica el tipo de línea que se creará.
GEODESIC—Se trazará un tipo de línea geodésica que represente con mayor precisión la distancia más corta entre dos puntos cualesquiera de la superficie terrestre. Esta es la opción predeterminada.
GREAT_CIRCLE—Se trazará un tipo de línea geodésica que representa el trayecto entre dos puntos cualesquiera situados en la intersección de la superficie terrestre y un plano que pasa por el centro de la Tierra. Si el valor del parámetro Referencia espacial es un sistema de coordenadas basado en esferoides, la línea es una elipse grande. Si el valor del parámetro Referencia espacial es 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 trazará un tipo de línea geodésica, también conocida como línea loxodrómica, que representa una trayectoria entre dos puntos cualesquiera de la superficie de un esferoide, definida por un azimut constante con respecto a un polo. Una línea de rumbo se representa como una línea recta en la proyección de Mercator.
NORMAL_SECTION—Se construirá un tipo de línea geodésica que representa un trazado entre dos puntos cualesquiera de la superficie de un esferoide, definido por la intersección de la superficie del esferoide con un plano que pasa por dichos dos puntos y es normal (perpendicular) a la superficie del esferoide en el punto de partida de ambos. La línea de sección normal del punto A al punto B es distinta a la línea del punto B al punto A.
PLANAR—Se utilizará una línea recta en el plano proyectado. Por lo general, una línea planar no representa con precisión la distancia más corta en la superficie de la tierra como lo hace una línea geodésica. Esta opción no está disponible para sistemas de coordenadas geográficas.
String
id_field
(Opcional)
Un campo en 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 las siguientes formas:
La ruta a un archivo .prj, como C:/workspace/watershed.prj
La ruta a una clase de entidad o a un 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
attributes
(Opcional)
Especifica si los campos de entrada restantes se añadirán en la clase de entidad de salida.
ATTRIBUTES—Los campos de entrada restantes se añadirán en la clase de entidad de salida. También se agregará un campo nuevo, ORIG_FID, a la clase de entidad de salida para guardar los valores de ID de entidad de entrada.
NO_ATTRIBUTES—Los campos de entrada restantes no se añadirán en la clase de entidad de salida. Esta es la opción predeterminada.
Boolean
Muestra de código
Ejemplo de "XYToLine" (script independiente)
Esta muestra convierte una tabla DBF en líneas geodésicas de dos puntos.
# Import system modules
import arcpy
# Set local variables
input_table = r"c:\workspace\city2city.dbf"
out_lines = r"c:\workspace\flt4421.gdb\routing001"
# XY To Line
arcpy.management.XYToLine(input_table, out_lines, "LOND1", "LATD1", "LOND2",
"LATD2", "GEODESIC", "idnum")