バリア付きコンター (Spatial Analyst ツール)

サマリー

ラスターサーフェスからコンターを作成します。バリアフィーチャを含めることで、バリアの両側にコンターを独立して作成できます。

使用法

現在のバージョンの バリア付きコンター ツールではポリライン出力だけがサポートされています。ポリゴン出力オプションを使用した場合は、無視されて、ポリライン出力が作成されます。
正確さには劣るにしても、より滑らかなコンターを作成したい場合には、エクステンションの フォーカル統計 ツールの平均オプションを使用するか、フィルター ツールのロウオプションを使用して、入力ラスターを事前処理します。
コンターは、ラスターのセルサイズの半分の距離だけラスターの NoData セル内に延長されます。これは、単一の NoData セル上にもコンターが生成されることを意味します。ただし、3 x 3 のセル枠が NoData の場合、コンターはこの枠内にはセルサイズの半分の距離だけしか延長されません。
出力コンターフィーチャクラスの Type フィールドの値には、1 (コンター)、2 (インデックスコンター)、3 (明示的なコンター) などがあります。
インデックス付きコンター間隔を使用して、追加のコンターを生成できます。出力フィーチャクラスでの Type 値は 2 になります。
ベースコンターは、たとえば、10 メートルから開始して、15 メートルおきにコンターを作成する場合に使用されます。この場合、10 がベースコンターとして使用され、15 がコンター間隔になります。コンターの値は 10、25、40、55 のようになります。
ベースコンターを指定しても、その値より上または下のコンターが作成されるのを防ぐことはできません。
コンター値を指定するテキストファイルには、以下の行を含めることができます。
- 行頭が数値でない行はすべて無視され、コメント行として扱われます。
- 値が 1 つの行は、明示的なコンター値として扱われます。
- 値が 3 つの行は、ベース、コンター間隔、インデックスが指定されたコンターとして扱われます。
- 値が 4 つの行は、開始値、終了値、間隔、インデックスが指定されたコンターとして扱われます。
たとえば、ラスターの最小値が 102 で最大値が 500 の場合、次のようなテキストファイルは、

``<!--
バリアポリゴンフィーチャ内にラスターのセル値がある場合、コンターラインはバリアで分割されます。ポリゴンフィーチャ内のセル値を無視する場合は、そのセルの値を NoData に変更してください。
入力ラスターサーフェスが非常に大きい場合、または、多数の出力フィーチャが要求されている場合は、オペレーティングシステムの一時ファイルの作成場所に大量の一時ファイルが作成されます。この結果としてなにか問題が発生した場合は、以下のいずれかを実行してください。
- 一時ファイルに使用できるディスク容量を増やします。
- 指定するコンターの数を減らします。または、コンターの範囲を分割して、各範囲を別々に処理し、各範囲の結果を組み合わせて最終結果を得ます。
- 入力データをセクション (タイル) に分けて処理し、個々の結果をマージして 1 つのデータセットにします。
このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。

ラベル	説明	データタイプ
入力ラスター	入力サーフェスラスター。	Raster Layer; Raster Dataset; Mosaic Layer; Mosaic Dataset
出力コンターフィーチャ	出力コンターフィーチャ。	Feature Class
入力バリアフィーチャ (オプション)	入力バリアフィーチャ。フィーチャはポリラインタイプまたはポリゴンタイプのいずれかになります。	Feature Layer
コンターの種類 (オプション)	作成するコンターのタイプです。注意: このツールの現在のバージョンでは、ポリライン出力のみがサポートされています。ポリゴン出力オプションを使用した場合は、無視されて、ポリライン出力が作成されます。ポリライン—入力ラスターのコンターまたは等値線表現。ポリゴン—コンターを表す閉じたポリゴン。	String
コンター値の詳細を含むファイル (オプション)	ベースコンター、コンター間隔、インデックス付きコンター間隔、明示的なコンターの値もテキストファイルで指定できます。	File
明示的なコンター値のみを入力 (オプション)	明示的なコンター値だけを使用します。ベースコンター、コンター間隔、インデックス付きコンター間隔は指定しません。オン—明示的なコンター値のみを指定します。オフ—デフォルトです。コンター間隔を指定する必要があります。	Boolean
ベースコンター (オプション)	ベースコンター値。入力ラスターの値の範囲全体をカバーするように、必要に応じてこの値の上下にコンターが生成されます。デフォルトは 0 です。	Double
コンター間隔 (オプション)	コンターライン間の間隔、すなわち距離。任意の正の数値を指定できます。	Double
インデックスコンター間隔 (オプション)	コンターがこの間隔でも生成され、出力フィーチャクラスではマークが付けられます。	Double
明示的なコンター値 (オプション)	コンターを作成する明示的な値。	Double
ラスター Z 値に適用するファクター (オプション)	コンターを生成するときに使用する単位変換係数。デフォルト値は 1 です。コンターラインは、入力ラスターの Z 値に基づいて生成されます。これは、多くの場合、メートルまたはフィート単位です。デフォルト値が 1 の場合、コンターは入力ラスターの Z 値と同じ単位になります。 Z 値とは異なる単位のコンターを作成するには、Z 係数に適切な値を設定します。このツールでは、地表 X、Y 単位とサーフェス Z 単位を一致させる必要はありません。たとえば、入力ラスターの標高値はフィート単位であるが、コンターはメートル単位で生成したい場合、Z 係数を 0.3048 に設定します (1 フィート = 0.3048 メートル)。	Double

ContourWithBarriers(in_raster, out_contour_feature_class, {in_barrier_features}, {in_contour_type}, {in_contour_values_file}, {explicit_only}, {in_base_contour}, {in_contour_interval}, {in_indexed_contour_interval}, {in_contour_list}, {in_z_factor})

名前	説明	データタイプ
in_raster	入力サーフェスラスター。	Raster Layer; Raster Dataset; Mosaic Layer; Mosaic Dataset
out_contour_feature_class	出力コンターフィーチャ。	Feature Class
in_barrier_features (オプション)	入力バリアフィーチャ。フィーチャはポリラインタイプまたはポリゴンタイプのいずれかになります。	Feature Layer
in_contour_type (オプション)	作成するコンターのタイプです。注意: このツールの現在のバージョンでは、ポリライン出力のみがサポートされています。ポリゴン出力オプションを使用した場合は、無視されて、ポリライン出力が作成されます。 `POLYLINES`—入力ラスターのコンターまたは等値線表現。 `POLYGONS`—コンターを表す閉じたポリゴン。	String
in_contour_values_file (オプション)	ベースコンター、コンター間隔、インデックス付きコンター間隔、明示的なコンターの値もテキストファイルで指定できます。	File
explicit_only (オプション)	明示的なコンター値だけを使用します。ベースコンター、コンター間隔、インデックス付きコンター間隔は指定しません。 `EXPLICIT_VALUES_ONLY`—明示的なコンター値のみを指定します。 `NO_EXPLICIT_VALUES_ONLY`—デフォルトです。コンター間隔を指定する必要があります。	Boolean
in_base_contour (オプション)	ベースコンター値。入力ラスターの値の範囲全体をカバーするように、必要に応じてこの値の上下にコンターが生成されます。デフォルトは 0 です。	Double
in_contour_interval (オプション)	コンターライン間の間隔、すなわち距離。任意の正の数値を指定できます。	Double
in_indexed_contour_interval (オプション)	コンターがこの間隔でも生成され、出力フィーチャクラスではマークが付けられます。	Double
in_contour_list [in_explicit_contour,...] (オプション)	コンターを作成する明示的な値。	Double
in_z_factor (オプション)	コンターを生成するときに使用する単位変換係数。デフォルト値は 1 です。コンターラインは、入力ラスターの Z 値に基づいて生成されます。これは、多くの場合、メートルまたはフィート単位です。デフォルト値が 1 の場合、コンターは入力ラスターの Z 値と同じ単位になります。 Z 値とは異なる単位のコンターを作成するには、Z 係数に適切な値を設定します。このツールでは、地表 X、Y 単位とサーフェス Z 単位を一致させる必要はありません。たとえば、入力ラスターの標高値はフィート単位であるが、コンターはメートル単位で生成したい場合、Z 係数を 0.3048 に設定します (1 フィート = 0.3048 メートル)。	Double

コードのサンプル

-->ContourWithBarriers<!-- の例 1 (Python ウィンドウ)

この例では、入力バリアフィーチャを組み込むことで、Esri Grid ラスターからコンターを作成します。ベースおよび間隔パラメーターも指定されます。出力コンターは、シェープファイルのポリラインです。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
ContourWithBarriers("elevation", "C:/sapyexamples/output/outcontourwithbarriers.shp", "elevation_barrier.shp", "POLYLINES",
                    "", "", 0, 300)

-->ContourWithBarriers の例 2 (スタンドアロンスクリプト)

# Name: ContourWithBarriers_Ex_02.py
# Description: Creates contours from a raster surface.
#           The inclusion of barrier features will allow one to independently generate contours on either side of a barrier.
# 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
inRaster = "elevation"
inBarrier = "elevation_barrier.shp"
inTextFile = ""
explicitValues = "NO_EXPLICIT_VALUES_ONLY"
contourInterval = 200
contourList = [600, 935, 1237.4]
baseContour = 0
outContours = "C:/sapyexamples/output/outcontourwithbarriers02.shp"

# Run Contour
ContourWithBarriers(inRaster, outContours, inBarrier, "POLYLINES", inTextFile,
                    explicitValues, baseContour, contourInterval, "",
                    contourList, "")

環境

自動コミット, 現在のワークスペース, 出力データのデフォルト Z 値, 範囲, 地理座標系変換, M 座標精度, M 許容値, 出力データのコンフィグレーションキーワード, 出力座標系, 出力データに M 値を含む, 出力データに Z 値を含む, 出力データの M ドメイン, 出力データの XY ドメイン, 出力データの Z ドメイン, スクラッチワークスペース, XY 座標精度, XY 許容値, Z 座標精度, Z 許容値

ライセンス情報

Basic: Spatial Analyst または 3D Analyst が必要
Standard: Spatial Analyst または 3D Analyst が必要
Advanced: Spatial Analyst または 3D Analyst が必要

バリア付きコンター (Spatial Analyst ツール)

サマリー

使用法

contour values and ranges

パラメーター

注意:

環境

ライセンス情報

関連トピック