Z 値の調整（Adjust 3D Z） (データの管理)

サマリ

Z が有効化されたフィーチャクラスに含まれているすべての Z 値を変更することができます。

使用法

注意:

このツールを使用すると入力データが変更されます。詳しい説明および不適切なデータ変更を防ぐための方法については、「出力を伴わないツール」をご参照ください。

• 水深測量データの多くには正の Z 値が含まれています。フィーチャクラスに含まれるそのようなすべてのデータの符号を逆にして、Z 値を負の値にすることができます。

• Z が有効化されたデータが、ジオプロセシングには不適切な鉛直測地基準系を参照している場合があります。このツールでは、フィーチャクラスのすべての Z 値に一括シフトを適用して、データを鉛直方向の上または下に調整することができます。

• [変換前の単位] パラメータと [変換後の単位] パラメータを使用して、Z 値の一般的な計測単位を変換することができます。

構文

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

パラメータ	説明	データ タイプ
in_features	Shape フィールドに Z 値が含まれている入力フィーチャクラス	Feature Layer
reverse_sign （オプション）	フィーチャクラスのすべての Z 値の符号を切り換えます。 REVERSE —Z 値を逆方向（負の値）にします。 NO_REVERSE —Z 値を逆方向（負の値）にしません。	String
adjust_value （オプション）	すべての Z 値に適用する値。フィーチャクラス全体で Z 値を小さくするには負の数字を入力します。Z 値を大きくするには正の値を入力します。	Double
from_units （オプション）	既存の Z 値の単位。このパラメータは [変換後の単位] パラメータとともに使用します。 MILIMETERS（ミリメートル） — CENTIMETERS（センチメートル） — METERS（メートル） — INCHES（インチ） — FEET（フィート） — YARDS（ヤード） — FATHOMS（ファゾム） —	String
to_units （オプション）	変換後の単位 MILIMETERS（ミリメートル） — CENTIMETERS（センチメートル） — METERS（メートル） — INCHES（インチ） — FEET（フィート） — YARDS（ヤード） — FATHOMS（ファゾム） —	String

コードのサンプル

Adjust3DZ（Z 値の調整）の例 1（Python ウィンドウ）

次の Python ウィンドウ スクリプトで、Adjust3DZ（Z 値の調整）関数をイミディエイト モードで使用する方法を示します。

import arcpy
from arcpy import env

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

Adjust3DZ（Z 値の調整）の例 2（スタンドアロン スクリプト）

次の Python スクリプトで、Adjust3DZ（Z 値の調整）関数をスタンドアロン スクリプトで使用する方法を示します。

# 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

環境

現在のワークスペース, 出力データの XY ドメイン, 出力データの Z ドメイン, 出力データの座標系, 範囲, XY 座標精度, XY 許容値, Z 座標精度, Z 許容値

ライセンス情報

ArcView: はい

ArcEditor: はい

ArcInfo: はい