Z 対応のフィーチャクラス内のフィーチャの標高プロパティに関する情報を追加します。
各 3D シェープを調べて、選択されたプロパティを入力フィーチャクラスの属性テーブルに追加します。 出力オプションは、フィーチャのジオメトリによって異なります。
次の Z プロパティが利用できます。
| フィーチャ ジオメトリ | Z プロパティ | ||
|---|---|---|---|
ポイント | ポイントの Z 値。 | ||
マルチポイント | マルチポイント レコードのすべてのポイントにおけるポイントの数、および Z の最小値、最大値、および平均値。 | ||
ポリラインおよびポリゴン | ラインまたはポリゴン周長の頂点数および 3D 距離。 ラインまたはポリゴン周長の Z の最小値、最大値、平均値、および傾斜角。 | ||
マルチパッチ | クローズド マルチパッチの表面積および体積。 マルチパッチ表面の Z の最小値、最大値、平均値、および傾斜角。 | ||
傾斜角はパーセント値 (グレード) として返され、傾斜角の計算方法は、このプロパティをサポートする各ジオメトリ タイプによって異なります。 値 -1 は、フィーチャが垂直であることを示します。
ポリゴン フィーチャの平均 Z 値は、ライン フィーチャと同じ方法で計算されます。 境界のみが評価されるため、ポリゴン内部は無視されます。 各セグメントの中点の Z 値に、そのセグメントの 3D 長さを乗算し、すべてのセグメントの積を加算します。 この合計をライン フィーチャまたはポリゴン境界の合計 3D 長さで除算し、結果を算出します。
各マルチパッチ フィーチャの平均 Z 値を計算するには、各三角形の中点の Z 値に、その三角形の 3D 面積を乗算します。 所定のフィーチャのすべての三角形の積を加算し、その値をマルチパッチ フィーチャの 3D サーフェス面積の合計で除算し、結果を算出します。
体積は、クローズド マルチパッチに対してのみ計算できます。 開いたマルチパッチ フィーチャは、0.0 の値を返します。 Solaris プラットフォーム上では現在、設計の制限により、マルチパッチが閉じているかどうかをツールが判断することができないため、すべてのマルチパッチが閉じているという前提で、すべてのマルチパッチに対して体積の計測を実行します。
| ラベル | 説明 | データ タイプ |
入力フィーチャ | 処理対象の入力フィーチャ。 | Feature Layer |
出力プロパティ | 入力フィーチャクラスの属性テーブルに追加される Z プロパティを指定します。
| String |
ノイズ フィルタリング (オプション) | 生成される計算結果からフィーチャの一部を除外するために使用される数値です。 これは、3D 入力に、統計的に偏った結果になる可能性がある極端な傾斜角を含む比較的小さいフィーチャが含まれている場合に便利です。 3D 入力のリニア単位がメートルである場合、値に 0.001 を指定すると、0.001 メートルよりも短いラインやポリゴン エッジが除外されます。 マルチパッチ フィーチャでは、同じ値を使用すると、0.001 平方メートルより小さい面積を持つ部分は除外されます。 このパラメーターは、ポイントおよびマルチポイント フィーチャには適用しません。 | String |
| ラベル | 説明 | データ タイプ |
| 更新された入力フィーチャ | 更新された Z 対応のフィーチャクラス。 | Feature Layer |
arcpy.ddd.AddZInformation(in_feature_class, out_property, {noise_filtering})| 名前 | 説明 | データ タイプ |
in_feature_class | 処理対象の入力フィーチャ。 | Feature Layer |
out_property [out_property,...] | 入力フィーチャクラスの属性テーブルに追加される Z プロパティを指定します。
| String |
noise_filtering (オプション) | 生成される計算結果からフィーチャの一部を除外するために使用される数値です。 これは、3D 入力に、統計的に偏った結果になる可能性がある極端な傾斜角を含む比較的小さいフィーチャが含まれている場合に便利です。 3D 入力のリニア単位がメートルである場合、値に 0.001 を指定すると、0.001 メートルよりも短いラインやポリゴン エッジが除外されます。 マルチパッチ フィーチャでは、同じ値を使用すると、0.001 平方メートルより小さい面積を持つ部分は除外されます。 このパラメーターは、ポイントおよびマルチポイント フィーチャには適用しません。 | String |
| 名前 | 説明 | データ タイプ |
| output_feature_class | 更新された Z 対応のフィーチャクラス。 | Feature Layer |
次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。
arcpy.env.workspace = 'C:/data'
arcpy.ddd.AddZInformation('lines_3D.shp', 'Z_MEAN; LENGTH_3D; AVG_SLOPE',
'NO_FILTER')次のサンプルは、スタンドアロン Python スクリプトでこのツールを使用する方法を示しています。
'''******************************************************************
Name: AddZInformation Example
Description: This script demonstrates AddZInformation on all
z-aware features in a target workspace.
******************************************************************'''
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = 'C:/data'
# Create list of feature classes
fcList = arcpy.ListFeatureClasses()
if fcList:
for fc in fcList:
desc = arcpy.Describe(fc)
if desc.hasZ:
# Set Local Variables
noise = 'No_Filter'
if desc.shapeType == 'Polygon':
Prop = ['Z_MIN', 'Z_MAX', 'VERTEX_COUNT']
elif desc.shapeType == 'Point':
Prop = 'Z'
elif desc.shapeType == 'Multipoint':
Prop = ['Z_MIN', 'Z_MAX', 'Z_MEAN']
elif desc.shapeType == 'Polyline':
Prop = 'LENGTH_3D'
print('Completed adding Z information.')
# Execute AddZInformation
arcpy.ddd.AddZInformation(inFC, Prop, noise)