トポ → ラスタ（ファイルによる定義）（Topo to Raster by File） (Spatial Analyst)
サマリ
ファイルに指定したパラメータを使用して、ポイント、ライン、およびポリゴン データから水文学的に正しいラスタ サーフェスを内挿します。
使用法
-
パラメータ ファイルは、入力データセットのリストと、その後に続く各種パラメータ設定および出力オプションで構成されます。
入力データには、入力データセットとフィールド（該当する場合）を指定します。入力には、コンター、ポイント、シンク、河川、湖、および境界の 6 つのタイプがあります。妥当な数の入力を、必要なだけ使用できます。入力の順序は結果に影響しません。<Path> はデータセットのパス、<Item> はフィールド名、<#> は入力する値を表します。
次の表にすべてのパラメータと、それぞれの定義および構文を示します。
パラメータ
定義
構文
入力データセット: コンター
高さの値を格納する項目を含むコンター ライン データセット。
Contour <Path> <Item> ポイント
高さの値を格納する項目を含むポイント データセット。
Point <Path> <Item> シンク
シンクの位置を含むポイント データセット。データセットにシンクの標高値が含まれている場合は、フィールド名を <Item> に指定します。シンクの位置だけを使用する場合は、<Item> に NONE を指定します。
Sink <Path> <Item> 河川
河川ライン データセット。高さの値は必要ありません。
Stream <Path> 湖
湖ポリゴン データセット。高さの値は必要ありません。
Lake <Path> 境界
境界ポリゴン データセット。高さの値は必要ありません。
Boundary <Path> パラメータの設定:
強制
強制的な排水を適用するかどうかを制御します。
ENFORCE <ON | OFF | ON_WITH_SINK> データ タイプ
入力データの主要タイプ。
DATATYPE <CONTOUR | SPOT> 反復
アルゴリズムで実行する反復の最大回数。
ITERATIONS <#> 粗さのペナルティ
サーフェスの粗さの計測値。
ROUGHNESS_PENALTY <#> 離散化誤差ファクタ
入力データからラスタを生成する際の、データのスムージングを調整する量。
DISCRETE_ERROR_FACTOR <#> 垂直方向標準誤差
入力データの Z 値における確率的誤差の量。
VERTICAL_STANDARD_ERROR <#> 許容値
1 番目の値は地表の排水に関する標高データの精度を反映し、2 番目の値は非現実的に高いバリアによる排水の除去を回避します。
TOLERANCES <#> <#> Z 制限
高さの下限と上限。
ZLIMITS <#> <#> 範囲
X 座標の最小値、Y 座標の最小値、X 座標の最大値、および Y 座標の最大値。
EXTENT <#> <#> <#> <#> セル サイズ
最終出力ラスタの解像度。
CELL_SIZE <#> マージン
指定した出力範囲と境界を超えて内挿を行う距離（セル単位）。
MARGIN <#> 出力:
出力河川フィーチャ
河川ポリライン フィーチャと尾根ライン フィーチャの出力ライン フィーチャクラス。
OUT_STREAM 出力シンク フィーチャ
残留シンク ポイント フィーチャの出力ポイント フィーチャクラス。
OUT_SINK 出力診断ファイル
診断ファイルの場所と名前。
OUT_DIAGNOSTICS <Path> -
パラメータ ファイルでは、オプションの出力フィーチャ データセットのパスを指定しないでください。これらの出力を指定するには、ツールのダイアログ ボックスで [出力 流水 ポリライン フィーチャ] と [残留シンク ポイント フィーチャ] を使用します。
-
パラメータ ファイルの例を示します。
Contour D:\data\contours2\arc HEIGHT Point D:\data\points2\point SPOTS Sink D:\data\sinks_200.shp Stream D:\data\streams\arc Lake D:\data\lakes\polygon Boundary D:\data\clipcov\polygon ENFORCE ON DATATYPE CONTOUR ITERATIONS 40 ROUGHNESS_PENALTY 0.00000000000 DISCRETE_ERROR_FACTOR 1.00000000000 VERTICAL_STANDARD_ERROR 0.00000000000 TOLERANCES 2.50000000000 100.00000000000 ZLIMITS -2000.00000000000 13000.00000000000 EXTENT -810480.62500000000 8321785.00000000000 810480.62500000000 10140379.00000000000 CELL_SIZE 1800.00000000000 MARGIN 20 OUT_STREAM OUT_SINK OUT_DIAGNOSTICS D:\data\ttr_diag.txt
構文
| パラメータ | 説明 | データ タイプ |
in_parameter_file |
内挿に使用する、入力値とパラメータを含む入力 ASCII テキスト ファイル。 このファイルは通常、以前の [トポ → ラスタ（Topo to Raster）] の実行にオプションの出力パラメータ ファイルを指定して作成します。 パラメータの変更による結果をテストするには、毎回 [トポ → ラスタ（Topo to Raster）] ツールを正しく実行するよりも、このファイルを編集して内挿を再実行するほうが簡単です。 | File |
out_stream_features （オプション） |
河川ポリライン フィーチャの出力フィーチャクラス。 | Feature Class |
out_sink_features （オプション） |
残留シンク ポイント フィーチャの出力フィーチャクラス。 | Feature Class |
リターン
| 名前 | 説明 | データ タイプ |
| out_surface_raster |
内挿された出力サーフェス ラスタ。 | Raster |
コードのサンプル
この例では、入力するポイント、ライン、およびポリゴン データを定義したパラメータ ファイルから、水文学的に正しい TIFF サーフェス ラスタを作成します。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outTTRByFile = TopoToRasterByFile("topotorasterbyfile.txt",
"C:/sapyexamples/output/out_streams.shp")
outTTRByFile.save("C:/sapyexamples/output/ttrbyfout.tif")
この例では、入力するポイント、ライン、およびポリゴン データを定義したパラメータ ファイルから、水文学的に正しい GRID サーフェス ラスタを作成します。
# Name: TopoToRasterByFile_Ex_02.py
# Description: Interpolates a hydrologically correct
# surface from point, line, and polygon data using
# parameters specified in a file.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inParameterFile = "topotorasterbyfile.txt"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute TopoToRasterByFile
outTTRByFile = TopoToRasterByFile(inParameterFile)
# Save the output
outTTRByFile.save("C:/sapyexamples/output/ttrbyfout02")