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
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 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 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.BearingDistanceToLine(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. 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 |
x_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 |
y_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 |
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) | Especifica las unidades de los valores del parámetro distance_field.
| 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) | Especifica las unidades de los valores del parámetro bearing_field.
| String |
line_type (Opcional) | Especifica el tipo de línea geodésica que se creará.
| 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:
| Spatial Reference |
Muestra 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
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí