Con (Image Analyst ツール)

サマリー

入力ラスターのそれぞれの入力セルに対して if/else 条件の評価を実行します。

Con を使用した条件評価の詳細

図

Con の図 — OutRas = Con(InRas1, 40, 30, "Value >= 2")

使用法

条件が true の場合のラスターと false の場合のラスターのいずれかが浮動小数の場合、出力ラスターは浮動小数になります。 true と false の両方のラスターが整数の場合、出力ラスターは整数になります。
入力条件付きラスター (Python では in_conditional_raster) がシングルバンドラスターで、条件式が TRUE のときの入力ラスター、または定数値 (Python では in_true_raster_or_constant) ラスターまたはオプションの 条件式が FALSE のときの入力ラスター、または定数値 (Python では in_false_raster_or_constant) ラスターのいずれかが定数の場合、出力はシングルバンドラスターになります。
すべての入力がマルチバンドラスターの場合、出力はマルチバンドラスターになります。 true 入力またはオプションの false 入力が定数の場合、出力ラスターもマルチバンドになります。各マルチバンド入力のバンド数は同一である必要があります。
ツールは、他の入力の対応するバンドを使用して、条件ラスターの各バンドに対して操作を実行します。条件付き入力がマルチバンドラスターであり、true または false ラスター入力が定数の場合、ツールはマルチバンド入力の各バンドの定数値を使用して操作を実行します。
式の評価がゼロでない場合、true として処理されます。
条件式が FALSE のときの入力ラスター、または定数値 が指定されていない場合、式で true にならないセルには NoData が割り当てられます。
NoData が式を満たしていない場合は、false の場合の入力ラスターの値は受け取られず、NoData のままとなります。
式は SQL クエリーを使用します。クエリーを作成する方法の詳細については、以下のトピックをご参照ください:
- SQL クエリーの作成
- ArcGIS で使用されるクエリー式の SQL リファレンス
Python で {where_clause} を使用するには、それを引用符で囲む必要があります。たとえば、「"Value > 5000"」と入力します。

詳細については、Python での検索式の指定に関するヘルプをご参照ください。
Python では、Value フィールドを指定する {where_clause} を使用せずに、代わりに in_conditional_raster としてマップ代数演算式を使用することができます。

たとえば、次のような式があります:
- Con("elev", 0, 1, "value > 1000")
は、次のように書き換えることができます:
- Con(Raster("elev") > 1000, 0, 1)
詳細については、以下に示したサンプルコードまたはマップ代数演算の「[複雑なステートメントの構築]」(../../help/analysis/spatial-analyst/mapalgebra/building-complex-statements.md)をご参照ください。
論理式の最大長は 4,096 文字です。
少なくとも 1 つの入力が、同数の変数を含む多次元ラスターデータの場合、このツールは、ディメンション値が同じすべてのスライスについて演算を実行します。出力は CRF 形式の多次元ラスターになります。このツールで処理を行うには、一般的なディメンションと一般的なディメンション値が入力の変数に少なくとも 1 つ必要です。これらがないとエラーが発生します。

2 つの入力が多次元ラスターで 1 つの変数を共有しているものの、名前が異なる場合は、このツールを実行する前に、多次元変数の照合ジオプロセシング環境をオフにします (Python で arcpy.env.matchMultidimensionalVariable = False を設定します)。

入力条件ラスター の値が多次元ラスターで、条件式が TRUE のときの入力ラスター、または定数値 と 条件式が FALSE のときの入力ラスター、または定数値 の各パラメーターが定数値に設定されている場合、ツールでは定数値を使ってすべての変数のすべてのスライスに対して操作を実行し、出力は多次元ラスターになります。
入力ラスターに長方形のセルがある場合、出力ラスターセルが正方形になるよう処理されます。その辺の長さは、長方形の長さと幅の平均値に等しくなります。

ラベル	説明	データタイプ
入力条件ラスター	目的の条件の true または false の結果を表す入力ラスター。整数タイプでも浮動小数点タイプでもかまいません。	Raster Layer
式が TRUE のときの入力ラスター、または定数値	条件が true である場合に出力セル値として使用される値を持つ入力。整数、浮動小数点ラスター、または定数値のいずれかになります。	Raster Layer; Constant
式が FALSE のときの入力ラスター、または定数値 (オプション)	条件が false である場合に出力セル値として使用する値を持つ入力。整数、浮動小数点ラスター、または定数値のいずれかになります。	Raster Layer; Constant
式 (オプション)	入力セルのどれが true でどれが false かを判定する論理式。 WHERE 句は、SQL 式の一般的な形式に従います。 SQL 編集モードボタンをクリックすると、「VALUE > 100」のように直接入力することが可能です。項目の編集モードでは、項目の追加モードボタンをクリックして式の構築を開始できます。	SQL Expression

戻り値

ラベル	説明	データタイプ
出力ラスター	出力ラスター。	Raster

Con(in_conditional_raster, in_true_raster_or_constant, {in_false_raster_or_constant}, {where_clause})

名前	説明	データタイプ
in_conditional_raster	目的の条件の true または false の結果を表す入力ラスター。整数タイプでも浮動小数点タイプでもかまいません。	Raster Layer
in_true_raster_or_constant	条件が true である場合に出力セル値として使用される値を持つ入力。整数、浮動小数点ラスター、または定数値のいずれかになります。	Raster Layer; Constant
in_false_raster_or_constant (オプション)	条件が false である場合に出力セル値として使用する値を持つ入力。整数、浮動小数点ラスター、または定数値のいずれかになります。	Raster Layer; Constant
where_clause (オプション)	入力セルのどれが true でどれが false かを判定する論理式。式は、SQL 式の一般的な形式に従います。 `where_clause` の例: "VALUE > 100"。	SQL Expression

戻り値

名前	説明	データタイプ
out_raster	出力ラスター。	Raster

コードのサンプル

Con の例 1 (Python ウィンドウ)

この例では、入力条件付きラスターの値が 2000 より大きい場合は、元の値が出力で保持され、そうでない場合は、値が NoData になります。

import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/output/data"
outCon = Con("elevation", "elevation", "", "VALUE > 2000")
outCon.save("C:/output/outcon.img")

# Run Con using a map algebra expression instead of a where clause
outCon2 = Con(Raster("elevation") > 2000, "elevation")
outCon2.save("C:/output/outcon2")

Con の例 2 (Python ウィンドウ)

この例では、Nodata の場合を除いて、元の値が出力で保持されます。Nodata は 0 で置換されます。

# Name: Con_Ex_02.py
# Description: Performs a conditional if/else evaluation
#              on each pixel of an input raster.
# Requirements: Image Analyst extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *

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

# Set local variables
inRaster = Raster("elevation")
inTrueRaster = 1
inFalseConstant = 0
whereClause = "VALUE >= 1500"

# Run Con and save the output
outCon = Con(inRaster, inTrueRaster, inFalseConstant, whereClause)
outCon.save("C:/output/outcon.tif")

# Run Con using a map algebra expression instead of a where clause, and save the output.
outCon2 = Con(inRaster >= 1500, inTrueRaster, inFalseConstant)
outCon2.save("C:/output/outcon2.tif")

環境

自動コミット, セルサイズ, セルサイズ投影法, 圧縮, 現在のワークスペース, 範囲, 地理座標系変換, マスク, 出力データのコンフィグレーションキーワード, 出力座標系, スクラッチワークスペース, スナップ対象ラスター, タイルサイズ

ライセンス情報

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

Con (Image Analyst ツール)

サマリー

図

使用法

パラメーター

戻り値

環境

ライセンス情報

関連トピック