Ajuster Z 3D (Gestion des données)

Récapitulatif

Permet la modification de toutes les valeurs Z dans une classe d'entités prenant en charge les valeurs Z.

Utilisation

Attention :

Cet outil modifie les données en entrée. Reportez-vous à la rubrique Outils sans sortie pour obtenir plus d'informations, ainsi que des stratégies pour éviter les mouvements de données indésirables.

• Les données de bathymétrie ont souvent des valeurs z positives. Vous pouvez inverser les signes de toutes les données dans la classe d'entités si vous voulez rendre toutes les valeurs z négatives.

• Les données avec valeurs Z peuvent être référencées à un datum vertical qui n'est pas approprié pour vos besoins de géotraitement. Cet outil peut appliquer un décalage en masse de toutes les valeurs z dans la classe d'entités pour ajuster verticalement les données vers le haut ou vers le bas.

• Les paramètres Conversion - unités d'arrivée et Conversion - unités de départ vous permettent de convertir vos valeurs z d'une unité de mesure commune en un autre.

Syntaxe

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

Paramètre	Explication	Type de données
in_features	Classe d'entités en entrée contenant des valeurs Z dans le champ SHAPE.	Feature Layer
reverse_sign (Facultatif)	Inverse le signe de toutes les valeurs Z dans la classe d'entités. REVERSE —Inverse les valeurs z. NO_REVERSE —N'inverse pas les valeurs z.	String
adjust_value (Facultatif)	Valeur à appliquer à toutes les valeurs z. Pour diminuer les valeurs z pour l'intégralité de la classe d'entités, entrez un nombre négatif. Pour les augmenter, saisissez une valeur positive.	Double
from_units (Facultatif)	Unités existantes des valeurs z. Ce paramètre est utilisé conjointement avec le paramètre Conversion - unités d'arrivée. MILIMETERS — CENTIMETERS — METERS — INCHES — FEET — YARDS — FATHOMS —	String
to_units (Facultatif)	Unités d'arrivée pour la conversion. MILIMETERS — CENTIMETERS — METERS — INCHES — FEET — YARDS — FATHOMS —	String

Exemple de code

Exemple 1 d'utilisation de l'outil Adjust3DZ (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction Adjust3DZ en mode immédiat.

import arcpy
from arcpy import env

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

Exemple 2 d'utilisation de l'outil Adjust3DZ (script autonome)

Le script Python ci-dessous illustre l'utilisation de la fonction Adjust3DZ dans un script autonome.

# 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

Environnements

Espace de travail courant, Domaine XY en sortie, Domaine Z en sortie, Système de coordonnées en sortie, Etendue, Résolution XY, Tolérance XY, Résolution Z, Tolérance Z

Informations de licence

ArcView : Oui

ArcEditor : Oui

ArcInfo : Oui