需要 Spatial Analyst 许可。
描述
针对输入栅格的每个输入像元执行 if/else 条件评估。
插图
使用方法
如果真栅格数据或可选假栅格数据为浮点型,则输出栅格数据也将为浮点型。如果真表达式和可选假栅格数据均为整型,则输出栅格数据也将为整型。
如果表达式的评估结果非零,则将被视为 True。
如果未指定输入条件为假时所取的栅格数据或常量值,则将为表达式结果不为 True 的那些像元分配 NoData。
如果 NoData 不满足表达式,则像元不会接收输入条件为假时所取的栅格数据值;像元值仍是 NoData。
表达式使用 SQL 查询。有关在查询构建器中创建查询的详细信息,请参阅以下主题:
要在 Python 中使用 {where_clause},应以引号括起来。例如,"Value > 5000"。
有关使用 Python 指定查询的详细信息,请参阅帮助。
在 Python 中,您可避免使用 {where_clause},其通过将地图代数表达式用作 in_conditional_raster 来指定 Value 字段。
例如,以下表达式:
- Con("elev", 0, 1, "value > 1000")
可被重写为:
- Con(Raster("elev") > 1000, 0, 1)
有关详细信息,请参阅下列代码示例或在地图代数中查看构建复杂语句。
逻辑表达式的最大长度为 4,096 个字符。
有关适用于此工具的地理处理环境的详细信息,请参阅分析环境和 Spatial Analyst。
语法
Con(in_conditional_raster, in_true_raster_or_constant, {in_false_raster_or_constant}, {where_clause})
参数 | 说明 | 数据类型 |
in_conditional_raster | 表示所需条件结果为真或假的输入栅格。 可以是整型或浮点型。 | Raster Layer |
in_true_raster_or_constant | 条件为真时,其值作为输出像元值的输入。 可为整型或浮点型栅格,或为常数值。 | Raster Layer; Constant |
in_false_raster_or_constant (可选) | 条件为假时,其值作为输出像元值的输入。 可为整型或浮点型栅格,或为常数值。 | Raster Layer; Constant |
where_clause (可选) | 决定输入像元为真或假的逻辑表达式。 表达式遵循 SQL 表达式的一般格式。where_clause 的一个示例为 "VALUE > 100"。 | SQL Expression |
返回值
名称 | 说明 | 数据类型 |
out_raster | 输出栅格。 | Raster |
代码示例
Con 示例 1(Python 窗口)
在本例中,输出中将保留在输入条件栅格数据值大于 2000 的原始值,在输入条件栅格数据值小于或等于 2000 的原始值将在输出中保存为 NoData。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCon = Con("elevation", "elevation", "", "VALUE > 2000")
outCon.save("C:/sapyexamples/output/outcon.img")
# Execute Con using a map algebra expression instead of a where clause
outCon2 = Con(Raster("elevation") > 2000, "elevation")
outCon2.save("C:/sapyexamples/output/outcon2")
Con 示例 2(Python 窗口)
在此例中,原始值将被保留在除 Nodata 外的输出中,其将被用 0 值代替。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCon = Con(IsNull("elevation"),0, "elevation")
outCon.save("C:/sapyexamples/output/outcon")
Con 示例 3(Python 窗口)
在此例中,两个不同的栅格用于创建条件栅格。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
inRaster1 = Raster("landuse")
inRaster2 = Raster("landuse2")
outCon = Con(((inRaster1 == 1) & (inRaster2 == 5)), inRaster1 + inRaster2, 99)
outCon.save("C:/sapyexamples/output/outcon")
Con 示例 4(Python 窗口)
在本例中,Con 中将使用多个 Con 工具。
import arcpy
from arcpy import env
from arcpy.sa import *
arcpy.CheckOutExtension = "Spatial"
env.workspace = "C:/sapyexamples/data"
inRas1 = Raster("inRaster")
outCon = Con(inRas1 < 45,1, Con((inRas1 >= 45) & (inRas1 < 47),2, Con((inRas1 >= 47) & (inRas1 < 49),3, Con(inRas1 >= 49,4))))
outCon.save("C:/sapyexamples/output/outcon")
Con 示例 5(独立脚本)
在本例中,如果输入条件栅格数据值大于或等于 1500,则输出值将为 1;如果输入条件栅格数据值小于 1500,则输出值将为 0。
# Name: Con_Ex_02.py
# Description: Performs a conditional if/else evaluation
# on each cell of an input raster.
# 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 = Raster("elevation")
inTrueRaster = 1
inFalseConstant = 0
whereClause = "VALUE >= 1500"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Con
outCon = Con(inRaster, inTrueRaster, inFalseConstant, whereClause)
# Execute Con using a map algebra expression instead of a where clause
outCon2 = Con(inRaster >= 1500, inTrueRaster, inFalseConstant)
# Save the outputs
outCon.save("C:/sapyexamples/output/outcon")
outCon2.save("C:/sapyexamples/output/outcon2")
环境
许可信息
- Basic: 需要 Spatial Analyst
- Standard: 需要 Spatial Analyst
- Advanced: 需要 Spatial Analyst