ラベル | 説明 | データ タイプ |
入力ラスター | 処理されるラスター。 | Raster Layer; Mosaic Layer |
出力フィーチャクラス | 生成されるフィーチャクラス。 | Feature Class |
出力 VIP テーブル (オプション) | [間引き処理] パラメーターで [VIP ヒストグラム] を指定した場合に作成されるヒストグラム テーブル。 method パラメーターで VIP_HISTOGRAM を指定した場合に作成されるヒストグラム テーブル。 | Table |
間引き方法 (オプション) | マルチポイント フィーチャクラスにエクスポートされるセルのサブセットを選択するために入力ラスターに適用される間引き処理を指定します。
| String |
カーネル メソッド (オプション) | カーネル間引き処理が入力ラスターに適用されている場合に、各カーネル近傍内で使用される選択手法を指定します。
| String |
Z 係数 (オプション) | Z 値に乗算する係数。 これは通常、Z 距離単位から XY 距離単位に変換する場合に使用されます。 デフォルトは 1 です。この場合、標高値は変更されません。 入力サーフェスの空間参照に距離単位の指定された Z 測地基準系がある場合、このパラメーターは使用できません。 | Double |
間引き値 (オプション) | [間引き処理] パラメーターの値に関連している間引き値。
| Double |
サマリー
ラスター セルの中心を、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}, {thinning_value})
名前 | 説明 | データ タイプ |
in_raster | 処理されるラスター。 | Raster Layer; Mosaic Layer |
out_feature_class | 生成されるフィーチャクラス。 | Feature Class |
out_vip_table (オプション) | [間引き処理] パラメーターで [VIP ヒストグラム] を指定した場合に作成されるヒストグラム テーブル。 method パラメーターで VIP_HISTOGRAM を指定した場合に作成されるヒストグラム テーブル。 | Table |
method (オプション) | マルチポイント フィーチャクラスにエクスポートされるセルのサブセットを選択するために入力ラスターに適用される間引き処理を指定します。
| String |
kernel_method (オプション) | カーネル間引き処理が入力ラスターに適用されている場合に、各カーネル近傍内で使用される選択手法を指定します。
| String |
z_factor (オプション) | Z 値に乗算する係数。 これは通常、Z 距離単位から XY 距離単位に変換する場合に使用されます。 デフォルトは 1 です。この場合、標高値は変更されません。 入力サーフェスの空間参照に距離単位の指定された Z 測地基準系がある場合、このパラメーターは使用できません。 | Double |
thinning_value (オプション) | method パラメーターの値に関連している間引き値。
| Double |
コードのサンプル
次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。
arcpy.env.workspace = "C:/data"
arcpy.ddd.RasterToMultipoint("elevation.tif", out_vip_table="elev_VIP.dbf",
method="VIP_HISTOGRAM", z_factor=1)
次のサンプルは、スタンドアロン 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
# Set default workspace
arcpy.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:
print("There are no IMG rasters in the " + env.workspace + " directory.")