TIN の頂点を単純化 (Decimate TIN Nodes) (3D Analyst)

概要

ソース TIN のノードのサブセットを使用して TIN (Triangulated Irregular Networks) データセットを作成します。

TIN の頂点を単純化 (Decimate TIN Nodes) の図

使用法

  • このツールは、オーバーサンプリングされたデータを間引くのに便利で、後の描画操作を向上させます。以下の間引きオプションが用意されています。

    • [Z 許容値] - 作成される TIN は、指定された Z 許容値内でソース TIN の垂直精度を維持します。Z 許容値は常にソース TIN のネイティブ Z 単位で表されます。出力 TIN の内挿された値と比較して、ソース TIN のノードはいずれも偏差が Z 許容値を超えることはありません。
      メモ:

      このメソッドは、オプションのノード制限の適用もサポートします。Z 許容値の設定により、結果の TIN でノード数が最大値を超過したときに、ツールの処理が停止されます。この場合、TIN は生成されますが警告が返されます。

    • [データの個数] - 出力 TIN のノード数を、指定した値に減らします。多くの場合は、ソース TIN のノード数よりも少なくなります。通常は、ソース TIN のサーフェス特性を維持するようにノードが選択されます。
  • [ブレークラインのコピー] オプションが選択されている場合は、ジェネラライズを行わずにソース TIN のブレークラインが出力に保存されます。ブレークラインに関与するノードは、最大ノード数の制限に含まれません。

  • [ブレークラインのコピー] オプションを選択しているかどうかにかかわらず、また入力 TIN データ境界がブレークライン エッジに基づいているかどうかにかかわらず、作成される TIN のデータ境界はブレークライン エッジになります。そのため、出力 TIN のサイズが大きくなり、指定した最大ノード数の制限とは無関係に動作する可能性があります。

構文

arcpy.3d.DecimateTinNodes(in_tin, out_tin, method, {copy_breaklines}, {z_tolerance_value}, {max_node_value})
パラメーター説明データ タイプ
in_tin

処理対象の TIN データセット。

TIN Layer
out_tin

生成される TIN データセット。

TIN
method

入力 TIN からノードのサブセットを選択するための間引き方法を指定します。

  • Z_TOLERANCEz_tolerance_value パラメーターで指定した精度で高さ方向を維持する TIN を作成します。これがデフォルトです。
  • COUNTmax_node_value パラメーターで指定したノード数を超過しない TIN を作成します。
String
copy_breaklines
(オプション)

入力 TIN のブレークラインを出力にコピーするかどうかを示します。

  • BREAKLINESブレークラインをコピーします。
  • NO_BREAKLINESブレークラインをコピーしません。これがデフォルトです。
Boolean
z_tolerance_value
(オプション)

出力 TIN で許容されるソース TIN の Z 値からの最大偏差で、Z 範囲の 10 分の 1 または 10 のいずれか小さいほうがデフォルトになります。

Double
max_node_value
(オプション)

出力 TIN に保存できる最大ノード数で、ソース TIN の合計ノード数から 1 を引いた数がデフォルトになります。Z 許容値の方法を使用する場合、指定した Z 許容値が原因で、生成される TIN が最大ノード数を超過すると、ツールは処理を停止します。

Long

コードのサンプル

DecimateTinNodes (TIN の頂点を単純化) の例 1 (Python ウィンドウ)

次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。

arcpy.env.workspace = "C:/data"
arcpy.DecimateTinNodes_3d("tin", "tin_simple", "COUNT 5000" "BREAKLINES")
DecimateTinNodes (TIN の頂点を単純化) の例 2 (スタンドアロン スクリプト)

次のサンプルは、スタンドアロン Python スクリプトでこのツールを使用する方法を示しています。

'''****************************************************************************
Name: DecimateTinNodes Example
Description: This script demonstrates how to use the 
             DecimateTinNodes tool.
****************************************************************************'''

# Import system modules
import arcpy
from arcpy import env

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

# Set Local Variables
inTin = "elevation"
method = "COUNT 5000"
copyBrk = "BREAKLINES"
# Ensure output name is unique
outTin = arcpy.CreateUniqueName("simple_elev")

#Execute DecimateTinNodes
arcpy.DecimateTinNodes_3d(inTin, outTin, method, copyBrk)

ライセンス情報

  • Basic: 次のものが必要 3D Analyst
  • Standard: 次のものが必要 3D Analyst
  • Advanced: 次のものが必要 3D Analyst

関連トピック