3D-Z-Werte anpassen (Data Management)

Zusammenfassung

Unterstützt die Änderung aller Z-Werte in einer Z-aktivierten Feature-Class.

Verwendung

Vorsicht:

Mit diesem Werkzeug werden die Eingabedaten geändert. Weitere Informationen und Strategien zur Vermeidung unerwünschter Datenänderungen finden Sie unter Werkzeuge ohne Ausgabe.

• Bathymetrische Daten verfügen häufig über positive Z-Werte. Möglicherweise möchten Sie die Vorzeichen aller Daten in der Feature-Class ändern, damit die Z-Werte negativ werden.

• Z-aktivierte Daten könnten auf ein Höhensystem verwiesen sein, das sich nicht für Ihre Geoverarbeitungsanforderungen eignet. Mit diesem Werkzeug könnten alle Z-Werte in der Feature-Class auf einmal geändert werden, um die Daten vertikal nach oben oder unten anzupassen.

• Mit den Parametern Aus Einheiten konvertieren und In Einheiten konvertieren können Sie die Z-Werte von einer allgemeinen Maßeinheit in eine andere konvertieren.

Syntax

Adjust3DZ_management (in_features, {reverse_sign}, {adjust_value}, {from_units}, {to_units})

Parameter	Erläuterung	Datentyp
in_features	Die Eingabe-Feature-Class mit Z-Werten im Feld "SHAPE".	Feature Layer
reverse_sign (optional)	Kehrt die Vorzeichen aller Z-Werte in der Feature-Class um. REVERSE —Kehren Sie die Z-Werte um (bzw. negieren Sie sie). NO_REVERSE —Die Z-Werte werden nicht umgekehrt (negiert).	String
adjust_value (optional)	Ein Wert, der auf alle Z-Werte angewendet werden soll. Geben Sie zur Verringerung der Z-Werte für die gesamte Feature-Class eine negative Zahl ein. Geben Sie zur Erhöhung einen positiven Wert ein.	Double
from_units (optional)	Die vorhandene Maßeinheit der Z-Werte. Dieser Parameter wird in Verbindung mit dem Parameter "In Einheiten konvertieren" verwendet. MILLIMETERS — CENTIMETERS — METERS — INCHES — FEET — YARDS — FATHOMS —	String
to_units (optional)	Die zu konvertierenden Einheiten. MILLIMETERS — CENTIMETERS — METERS — INCHES — FEET — YARDS — FATHOMS —	String

Codebeispiel

Adjust3DZ – Beispiel 1(Python-Fenster)

Mit dem folgenden Skript im Python-Fenster wird veranschaulicht, wie Sie die Funktion Adjust3DZ im unmittelbaren Modus verwenden.

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.Adjust3DZ_management("subsurface_pts.shp", "REVERSE", 0, "METERS", "FEET")

Adjust3DZ – Beispiel 2 (eigenständiges Skript)

Mit dem folgenden Python-Skript wird veranschaulicht, wie Sie die Funktion Adjust3DZ in einem eigenständigen Skript verwenden.

# Name:         Adjust3DZ Example
# Description:  The following stand-alone script demonstrates how to use the
#   Adjust3DZ tool to modify the z-values of points, lines, and
#   polygons in the specified workspace.
# Requirements: 3D Analyst extension
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Obtain a license for the 3D Analyst extension
arcpy.CheckOutExtension("3D")

# Set environment settings
env.workspace = "C:/data"

try:
    # Create a list of feature classes in the workspace
    fcList = arcpy.ListFeatureClasses()
    # Determine if the list contains any feature classes
    if len(fcList) > 0:
        # Loop through each feature class
        for fc in fcList:
            # Describe the feature class
            desc = arcpy.Describe(fc)
            # Evaluate if the feature class is z-aware
            if desc.hasZ is True:
                # Evaluate the geometry of the feature
                # Convert polyline z values from meters to feet
                if desc.shapeType is "Polyline":
                    # Set Local Variables
                    rev = "NO_REVERSE"
                    startUnits = "Meters"
                    endUnits = "Feet"
                    arcpy.AddMessage("Converting units of " + fc + " from meters to feet.")
                    #Execute Adjust3DZ
                    arcpy.Adjust3DZ_management(fc, 0, startUnits, endUnits)
                # Shift polygon z-values by a value of 3
                if desc.shapeType is "Polygon":
                    # Set Local Variables
                    rev = "NO_REVERSE"
                    arcpy.AddMessage("Shifting the z-value of " + fc +".")
                    #Execute Adjust3DZ
                    arcpy.Adjust3DZ_management(fc, rev)
            del desc, rev
    else:
        arcpy.AddMessage("There are no feature classes in the workspace.")
    del fcList
except Exception as e:
    # Returns any other error messages
    print e.message

del arcpy

Umgebungen

Aktueller Workspace, Ausgabe-XY-Domäne, Ausgabe-Z-Domäne, Ausgabe-Koordinatensystem, Ausdehnung, XY-Auflösung, XY-Toleranz, Z-Auflösung, Z-Toleranz

Lizenzinformationen

ArcView: Ja

ArcEditor: Ja

ArcInfo: Ja