Peilungsentfernung in Linie (Data Management)

Lizenzstufe:BasicStandardAdvanced

Zusammenfassung

Erstellt eine neue Feature-Class mit geodätischen Linien-Features, die basierend auf den Werten in einem X-Koordinatenfeld, Y-Koordinatenfeld, Peilungsfeld und Entfernungsfeld einer Tabelle erstellt werden.

Bild

Peilungsentfernung in Linie – Übersichtsgrafik
Peilungs- und Entfernungskonstruktionsparameter

Verwendung

Syntax

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

Bei der Eingabetabelle kann es sich um eine CSV-Datei, eine Excel-Datei oder eine Geodatabase-Tabelle handeln.

Table View
out_featureclass

Die Ausgabe-Feature-Class, die verdichtete geodätische Linien enthält.

Feature Class
x_field

Ein numerisches Feld in der Eingabetabelle, das die X-Koordinaten (oder Längengrade) der Startpunkte von Linien enthält, die in dem durch den Parameter Raumbezug festgelegten Ausgabe-Koordinatensystem positioniert werden sollen.

Field
y_field

Ein numerisches Feld in der Eingabetabelle, das die Y-Koordinaten (oder Breitengrade) der Startpunkte von Linien enthält, die in dem durch den Parameter Raumbezug festgelegten Ausgabe-Koordinatensystem positioniert werden sollen.

Field
distance_field

Ein numerisches Feld in der Eingabetabelle, das die Entfernungen von den Startpunkten für die Erstellung der Ausgabelinien enthält.

Field
distance_units
(optional)

Die Einheiten für die Werte im Entfernungsfeld.

  • METERSWerte in Metern; dies ist der Standard.
  • KILOMETERSWerte in Kilometern.
  • MILESWerte in Meilen.
  • NAUTICAL_MILESWerte in Seemeilen.
  • FEETWerte in internationalen Fuß.
  • US_SURVEY_FEETWerte in U.S. Survey Feet.
String
bearing_field

Ein numerisches Feld in der Eingabetabelle, das die Peilungswinkelwerte für die Ausgabeliniendrehung enthält. Die Winkel werden vom Norden aus im Uhrzeigersinn gemessen.

Field
bearing_units
(optional)

Die Maßeinheiten der Werte im Peilungsfeld.

  • DEGREESWerte in Dezimalgrad; dies ist der Standard.
  • MILSWerte in Mil.
  • RADSWerte in Bogenmaß.
  • GRADSWerte in Gradian.
String
line_type
(optional)

Der Typ von geodätischer Linie, der konstruiert werden soll.

  • GEODESIC Ein Typ von geodätischer Linie, der die kürzeste Entfernung zwischen zwei beliebigen Punkten auf der Erde sehr genau wiedergibt. Die mathematische Definition der geodätischen Linie ist recht lange und komplex und wird daher hier nicht aufgeführt. Dieser Linientyp ist der Standard.
  • GREAT_CIRCLEEin Typ von geodätischer Linie, der den Pfad zwischen zwei beliebigen Punkten entlang der Schnittlinie zwischen der Oberfläche der Erde und einer Ebene durch den Mittelpunkt der Erde wiedergibt. Abhängig von dem Ausgabe-Koordinatensystem, das durch den Raumbezugsparameter angegeben wird, ist diese Linie in einem auf einem Sphäroid basierten Koordinatensystem eine große Ellipse; in einem auf einer Kugel basierten Koordinatensystem wird die Linie nur als Großkreis bezeichnet – ein Kreis mit dem größten Radius auf der sphäroidischen Oberfläche.
  • RHUMB_LINEEin Typ von geodätischer Linie, auch als Loxodrome bezeichnet, der einen Pfad zwischen zwei beliebigen Punkten auf der Oberfläche eines Sphäroids darstellt, definiert durch einen konstanten Azimut von einem Pol. Eine Loxodrome erscheint in der Mercator-Projektion als gerade Linie.
  • NORMAL_SECTIONEin Typ von geodätischer Linie, der den Pfad zwischen zwei beliebigen Punkten auf der Oberfläche eines Sphäroids darstellt, definiert durch den Schnittpunkt zwischen der Sphäroidoberfläche und einer Ebene, die durch die zwei Punkte verläuft und normal (senkrecht) zu der Sphäroidoberfläche am Startpunkt der beiden Punkte ist. Daher unterscheidet sich die normale Schnittlinie von Punkt A nach Punkt B von der Schnittlinie von Punkt B nach Punkt A.
String
id_field
(optional)

Ein Feld in der Eingabetabelle; dieses Feld und die Werte werden in die Ausgabe aufgenommen und können verwendet werden, um die Ausgabe-Features mit den Datensätzen in der Eingabetabelle zu verbinden.

Field
spatial_reference
(optional)

Der Raumbezug der Ausgabe-Feature-Class. Sie können den Raumbezug auf unterschiedliche Weise angeben:

  • Durch Eingeben des Pfades zu einer PRJ-Datei, z. B. C:/workspace/watershed.prj.
  • Durch Referenzieren einer Feature-Class oder eines Feature-Datasets, deren Raumbezug Sie übernehmen möchten, z. B. C:/workspace/myproject.gdb/landuse/grassland.
  • Durch Definieren eines Raumbezugsobjekts vor der Verwendung dieses Werkzeugs, z. B. sr = arcpy.SpatialReference ("C:/data/Africa/Carthage.prj"), das Sie dann als Raumbezugsparameter verwenden.

Spatial Reference

Codebeispiel

BearingDistanceToLine – Beispiel (eigenständiges Skript)

Konvertiert Peilungs- und Entfernungsinformationen in eine Linie.

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

Umgebung

Verwandte Themen

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Ja
ArcGIS for Desktop Standard: Ja
ArcGIS for Desktop Advanced: Ja
9/11/2013