Distancia de rumbo a línea (Gestión de datos)

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, un campo de coordenadas y, un campo de rumbo y un campo de distancia de una tabla.

Ilustración

Bearing and distance construction parameters

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 y y de un punto de partida, la distancia desde el punto de partida y el ángulo de rumbo medido desde el Norte. 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 en una geodatabase de archivos o una geodatabase personal, los valores en el 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 de longitud geodésica, utilice la herramienta Medir de ArcMap; asegúrese de elegir la opción Geodésica, Loxodromia o Elíptico grande según corresponda, antes de tomar una medición.

Sintaxis

BearingDistanceToLine_management (in_table, out_featureclass, x_field, y_field, distance_field, {distance_units}, bearing_field, {bearing_units}, {line_type}, {id_field}, {spatial_reference})

Parámetro	Explicación	Tipo 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
x_field	Un campo numérico en la tabla de entrada que incluye las coordenadas x (o las longitudes) de los puntos de partida de líneas que se colocarán en el sistema de coordenadas de salida especificado por el parámetro spatial_reference.	Field
y_field	Un campo numérico en la tabla de entrada que incluye las coordenadas y (o latitudes) de los puntos de partida de líneas que se colocarán en el sistema de coordenadas de salida especificado por el parámetro spatial_reference.	Field
distance_field	Un campo numérico en la tabla de entrada que contiene las distancias desde los puntos de partida para crear las líneas de salida.	Field
distance_units (Opcional)	Las unidades para los valores en el campo Distancia. METERS —Valores en metros; esta es la opción predeterminada. KILOMETERS —Valores en kilómetros. MILES —Valores en millas. NAUTICAL_MILES —Valores en millas náuticas. FEET —Valores en pies internacionales. US_SURVEY_FEET —Valores en pies topográficos de EE.UU.	String
bearing_field	Un campo numérico en la tabla de entrada que contiene valores de ángulo de rumbo para la rotación de línea de salida. Los ángulos se miden en el sentido de las agujas del reloj desde el Norte.	Field
bearing_units (Opcional)	Las unidades de los valores en el campo Rumbo. DEGREES —Valores en grados decimales; esta es la opción predeterminada. MILS —Valores en mils. RADS —Valores en radianes. GRADS —Valores en gradianes.	String
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: Introduzca la ruta en un archivo .prj, como C:/workspace/watershed.prj. Haga referencia a una clase de entidad o dataset de entidades cuya referencia espacial desea aplicar, como C:/workspace/myproject.gdb/landuse/grassland . Defina un objeto de referencia espacial antes de utilizar esta herramienta, como sr = arcpy.SpatialReference("C:/data/Africa/Carthage.prj"), que después utiliza como el parámetro de referencia espacial.	Spatial Reference

Ejemplo de código

Ejemplo de BearingDistanceToLine (secuencia de comandos independiente)

Convierte la información de rumbo y distancia en una línea.

# Import system modules import arcpy from arcpy import env  # Local variables input_table = r"c:\workspace\LOBtraffic.dbf" output_fc = r"c:\workspace\SOPA.gdb\lob_traf001"  #BearingDistanceToLine arcpy.BearingDistanceToLine_management(input_table, output_fc, "X", "Y",  "NAUTICAL_MILES", "azim", "DEGREES", "GEODESIC","recnum")

Entornos

Espacio de trabajo actual, Espacio de trabajo temporal

Información sobre licencias

ArcGIS for Desktop Basic: Sí

ArcGIS for Desktop Standard: Sí

ArcGIS for Desktop Advanced: Sí