概要
Z 値にラスター セルの値が反映される 3D マルチポイント フィーチャにラスター セルの中心を変換します。
使用法
ラスター標高データが存在し、トライアングル サーフェスが提供する機能を使用する必要がある場合、マルチポイント フィーチャを TIN またはテレイン データセットに読み込むことができるため、このツールを使用することを検討してください。
入力ラスターのサイズが非常に大きい場合は、間引き処理を適用して、マルチポイント フィーチャクラスにエクスポートされるセルの数を減らすことを検討してください。
- 垂直方向の精度の維持が重要な場合は、[Z 許容値] の間引き処理を使用します。
- 水平方向のサンプル距離の制御が重要な場合は、[カーネル] の間引き処理を使用します。
- 生成されたマルチポイントを主に視覚化アプリケーションに適用する場合は、[VIP] 間引き処理を使用します。この間引き処理は、比較的高速で予測可能な数のポイントが出力されるため、局所的な頂点とくぼみの選択に適しています。ただし、この間引き処理はノイズの影響を受けやすく、3 セル X 3 セルよりも大きい範囲に広がった地形フィーチャを無視する場合があります。
- VIP 間引き処理を適用するには、初期ステップとして [VIP ヒストグラム] オプションを使用します。このオプションを使用すると、有意性スコアのヒストグラムが生成され、各増加パーセンタイル値で選択されるポイントの数を知ることができます。
構文
arcpy.ddd.RasterToMultipoint(in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor})| パラメーター | 説明 | データ タイプ |
in_raster | 処理対象のラスター。 | Raster Layer; Mosaic Layer |
out_feature_class | このツールで生成されるフィーチャクラス。 | Feature Class |
out_vip_table (オプション) | [メソッド] パラメーターに VIP ヒストグラムが指定されたときに作成されるヒストグラム テーブル | Table |
method (オプション) | マルチポイント フィーチャクラスにエクスポートされるセルのサブセットを選択するための、入力ラスターに適用される間引き処理。
| String |
kernel_method (オプション) | カーネル間引き処理を入力ラスターに適用する場合に、各カーネル近傍内で使用される選択手法。
| String |
z_factor (オプション) | Z 値に乗算する係数。これは通常、Z リニア単位から XY リニア単位に変換する場合に使用されます。デフォルトは 1 です。この場合、標高値は変更されません。入力サーフェスの空間参照に距離単位の指定された Z 測地基準系がある場合、このパラメーターは無効になります。 | Double |
コードのサンプル
RasterToMultipoint (ラスター → マルチポイント) の例 1 (Python ウィンドウ)
次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.RasterToMultipoint_3d("elevation.tif", "","elev_VIP.dbf", "VIP_HISTOGRAM", "", "1")
RasterToMultipoint (ラスター → マルチポイント) の例 2 (スタンドアロン スクリプト)
次のサンプルは、スタンドアロン Python スクリプトでこのツールを使用する方法を示しています。
'''*********************************************************************
Name: RasterToMultipoint Example
Description: This script demonstrates how to use
the RasterToMultipoint tool to create multipoint datasets
fot all IMG rasters in a target workspace.
**********************************************************************'''
# Import system modules
import arcpy
from arcpy import env
import exceptions
try:
arcpy.CheckOutExtension("3D")
# Set default workspace
env.workspace = "C:/data"
# Create the list of IMG rasters
rasterList = arcpy.ListRasters("*", "IMG")
# Loop the process for each raster
if rasterList:
for raster in rasterList:
# Set Local Variables
# [:-4] strips the last 4 characters (.img) from the raster name
outTbl = "VIP_" + raster[:-4] + ".dbf"
method = "VIP_HISTOGRAM"
zfactor = 1
#Execute RasterToMultipoint
arcpy.ddd.RasterToMultipoint(raster, "",outTbl, method, "", zfactor)
else:
"There are no IMG rasters in the " + env.workspace + " directory."
except Exception as e:
# Returns any other error messages
print e.message
環境
ライセンス情報
- Basic: 次のものが必要 3D Analyst
- Standard: 次のものが必要 3D Analyst
- Advanced: 次のものが必要 3D Analyst