Feature-Z-Werte aktualisieren (3D Analyst)

Zusammenfassung

Aktualisiert die Z-Koordinaten von 3D-Feature-Stützpunkten anhand einer Oberfläche.

Verwendung

  • Die Stützpunkte werden nur für Features aktualisiert, die die Eingabe-Oberfläche vollständig überlappen. Features, die die Oberfläche nicht überlappen, werden übersprungen.

    Hinweis:

    Wenn der Z-Wert eines bestimmten Stützpunktes außerhalb der Z-Domäne des Raumbezugs eines Geodatabase-Features liegt, wird der Z-Wert des Stützpunktes nicht aktualisiert. Erstellen Sie eine Kopie der Eingabe-Features, und legen Sie eine geeignete Z-Domäne fest, um die betroffenen Features zu verarbeiten.

Syntax

UpdateFeatureZ(in_features, in_surface, {method}, {status_field})
ParameterErklärungDatentyp
in_features

Die 3D-Features, für die die Z-Werte der Stützpunkte geändert werden.

Feature Layer
in_surface

Die Oberfläche, die zum Ermitteln des neuen Z-Wertes für die 3D-Feature-Stützpunkte verwendet wird.

LAS Dataset Layer; Mosaic Layer; Raster Layer; TIN Layer
method
(optional)

Die Interpolationsmethode, die zum Ermitteln der Informationen zur Oberfläche verwendet wird. Die verfügbaren Optionen hängen vom Datentyp der Eingabeoberfläche ab:

  • BILINEAREine ausschließlich für die Raster-Oberfläche vorgesehene Interpolationsmethode zur Bestimmung der Zellenwerte aus den vier nächstgelegenen Zellen. Dies ist die einzige Option, die für eine Raster-Oberfläche verfügbar ist.
  • LINEAR Standardinterpolationsmethode für ein TIN-, Terrain- und LAS-Dataset. Ruft den Höhenwert von der Ebene ab, die durch das Dreieck definiert wird, das die XY-Position eines Abfragepunktes enthält.
  • NATURAL_NEIGHBORS Ruft den Höhenwert durch Anwenden von flächenbasierten Gewichtungen auf die natürlichen Nachbarn eines Abfragepunktes ab.
  • CONFLATE_ZMIN Ruft den Höhenwert vom kleinsten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes ab.
  • CONFLATE_ZMAX Ruft den Höhenwert vom größten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes ab.
  • CONFLATE_NEAREST Ruft den Höhenwert vom nächsten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes ab.
  • CONFLATE_CLOSEST_TO_MEAN Ruft den Höhenwert von dem Z-Wert ab, der dem Durchschnitt aller natürlichen Nachbarn eines Abfragepunktes am nächsten liegt.
String
status_field
(optional)

Ein vorhandenes numerisches Feld, das mit Werten gefüllt wird, um anzugeben, ob die Stützpunkte des Features erfolgreich aktualisiert wurden. Der Wert 1 wird für aktualisierte Features und 0 für nicht aktualisierte Features verwendet. Features, die die Oberfläche teilweise überlappen, werden nicht aktualisiert.

Field

Abgeleitete Ausgabe

NameErklärungDatentyp
out_feature_class

Die aktualisierten 3D-Features, für die die Z-Werte der Stützpunkte geändert wurden.

Feature-Layer

Codebeispiel

UpdateFeatureZ – Beispiel 1 (Python-Fenster)

Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.

arcpy.env.workspace = 'C:/data'

arcpy.UpdateFeatureZ_3d('lines_3d.shp', 'dsm.tif', status_field='Updated')
UpdateFeatureZ – Beispiel 2 (eigenständiges Skript)

Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht.

'''****************************************************************************
       Name: Update Antenna Positions
Description: Updates antenna positions based on elevations from a surface.
****************************************************************************'''
# Import system modules
import arcpy

in_fc = arcpy.GetParameterAsText(1) # pt features representing antenna locations
surface = arcpy.GetParameterAsText(2) # surface used to modify feature Z values


try:
    if arcpy.Describe(surface).dataType in ('Raster', 'RasterLayer'):
        method = 'BILINEAR'
    else:
        method = 'CONFLATE_ZMAX'
    arcpy.ddd.UpdateFeatureZ(in_fc, surface, method)

except arcpy.ExecuteError:
    print(arcpy.GetMessages())

Lizenzinformationen

  • Basic: Erfordert 3D Analyst
  • Standard: Erfordert 3D Analyst
  • Advanced: Erfordert 3D Analyst

Verwandte Themen