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.
Syntax
arcpy.ddd.UpdateFeatureZ(in_features, in_surface, {method}, {status_field})
Parameter | Erklärung | 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:
| 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 | Erklärung | 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)
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())
Umgebungen
Lizenzinformationen
- Basic: Erfordert 3D Analyst
- Standard: Erfordert 3D Analyst
- Advanced: Erfordert 3D Analyst