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.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die 3D-Features, für die die Z-Werte der Stützpunkte geändert werden.	Feature Layer
Eingabe-Oberfläche	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
Interpolationsmethode (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: BILINEAR—Eine 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
Feld "Status" (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

Beschriftung	Erläuterung	Datentyp
Aktualisierte Eingabe-Features	Die aktualisierten 3D-Features, für die die Z-Werte der Stützpunkte geändert wurden.	Feature-Layer

Python

arcpy.ddd.UpdateFeatureZ(in_features, in_surface, {method}, {status_field})

Name	Erläuterung	Datentyp
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: BILINEAR—Eine 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

Name	Erläuterung	Datentyp
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)

Im folgenden Beispiel 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())

Umgebungen

Aktueller Workspace, Ausdehnung