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

Resumen

Crea una clase de entidad con entidades de línea geodésica o planar a partir de 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

Ilustración de la herramienta Distancia de rumbo a línea
Se muestran los parámetros de construcción de rumbo y distancia.

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
    • La distancia respecto al punto de partida
    • El ángulo de rumbo
    Los campos y sus valores se incluirán en la salida.

  • Cuando las líneas de salida son geodésicas, las coordenadas x e y y la distancia se miden en la superficie de la tierra, y el ángulo de rumbo se mide desde el norte. Cuando las líneas de salida son planares, las coordenadas x e y y la distancia se miden en el plano proyectado, y el ángulo de rumbo se mide en el sentido de las agujas del reloj desde el norte de la cuadrícula (vertical hacia arriba en el mapa).

  • 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, 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 ArcGIS Pro y elija la opción Geodésico, Loxodromia o Elíptico grande correspondiente antes de realizar una medición.

Parámetros

EtiquetaExplicaciónTipo de datos
Tabla de entrada

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
Campo X

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 Referencia espacial.

Field
Campo Y

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 Referencia espacial.

Field
Campo de distancia

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
Unidades de distancia
(Opcional)

Especifica las unidades que se utilizarán para el parámetro Campo de distancia.

  • MetrosLas unidades serán metros.
  • KilómetrosLas unidades serán kilómetros.
  • MillasLas unidades serán millas.
  • Millas náuticasLas unidades serán millas náuticas.
  • PiesLas unidades serán pies.
  • Pies de agrimensura de EE. UU.Las unidades serán pies de agrimensura de EE. UU.
String
Campo de rumbo

Un campo numérico de la tabla de entrada que contiene los 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
Unidades de rumbo
(Opcional)

Especifica las unidades de los valores del parámetro Campo de rumbo.

  • Grados decimales Las unidades serán grados decimales. Esta es la opción predeterminada.
  • Mili-radianesLas unidades serán millas.
  • RadianesLas unidades serán radianes.
  • GradianesLas unidades serán gradianes.
String
Tipo de línea
(Opcional)

Especifica el tipo de línea que se creará.

  • GeodésicaSe 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. Esta es la opción predeterminada.
  • Círculo grandeSe 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. Si el valor del parámetro Referencia espacial es un sistema de coordenadas basado en esferoides, la línea es un elíptico 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 rumboSe 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.
  • Sección normalSe 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. 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 planarSe 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 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
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.

  • Desactivada: los campos de entrada restantes no se añadirán a la clase de entidad de salida. Esta es la opción predeterminada.
  • Activada: los campos de entrada restantes se añadirán a 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.

Boolean

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}, {attributes})
NombreExplicació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 o planares.

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 que se utilizarán para el parámetro distance_field.

  • METERSLas unidades serán metros.
  • KILOMETERSLas unidades serán kilómetros.
  • MILESLas unidades serán millas.
  • NAUTICAL_MILESLas unidades serán millas náuticas.
  • FEETLas unidades serán pies.
  • US_SURVEY_FEETLas unidades serán pies de agrimensura de EE. UU.
String
bearing_field

Un campo numérico de la tabla de entrada que contiene los 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.

  • DEGREES Las unidades serán grados decimales. Esta es la opción predeterminada.
  • MILSLas unidades serán millas.
  • RADSLas unidades serán radianes.
  • GRADSLas unidades serán gradianes.
String
line_type
(Opcional)

Especifica el tipo de línea que se creará.

  • GEODESICSe 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. Esta es la opción predeterminada.
  • GREAT_CIRCLESe 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. Si el valor del parámetro Referencia espacial es un sistema de coordenadas basado en esferoides, la línea es un elíptico 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_LINESe 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_SECTIONSe 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. 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.
  • PLANARSe 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 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
attributes
(Opcional)

Especifica si los campos de entrada restantes se añadirán en la clase de entidad de salida.

  • NO_ATTRIBUTESLos campos de entrada restantes no se añadirán en la clase de entidad de salida. Esta es la opción predeterminada.
  • ATTRIBUTESLos 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.
Boolean

Muestra de código

Ejemplo de BearingDistanceToLine (secuencia de comandos independiente)

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

# Import system modules
import arcpy

# 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')

Información de licenciamiento

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

Temas relacionados