需要 Spatial Analyst 许可。
描述
输入栅格集中的值将被逐个像元地进行等级排定,返回哪个等级将由等级输入栅格的值来确定。
插图
使用
在输入栅格列表中,顺序无关紧要。但是,等级输入栅格必须排在它们之前。
在输入栅格列表中可以指定任意数量的栅格。
当为输入等级栅格或常量值(Python 中的 in_rank_raster_or_constant)指定多波段栅格时,将只使用第一个波段。如需处理其他波段,请指定要使用的具体波段。
将多波段栅格指定为输入栅格(Python 中的 in_rasters)之一时,将使用所有波段。
要处理一系列来自多波段栅格的波段,可先用波段合成工具创建由这些特定波段组成的新栅格数据集,并在输入栅格(Python 中的 in_rasters)列表中使用该结果。
如果某个像元位置在任意输入栅格中都含有 NoData,则该位置将在输出栅格中被分配 NoData。
如果任何像元位置的输入值都相同,则无论指定的等级为何,该像元位置的输出都将是该值。
如果等级栅格值大于输入栅格数,则将 NoData 分配给输出上的每个像元位置。
如果任意输入栅格都属于浮点型,则输出栅格也将为浮点型;否则它就是整型。
有关适用于此工具的地理处理环境的详细信息,请参阅分析环境和 Spatial Analyst。
语法
Rank(in_rank_raster_or_constant, in_rasters)
参数 | 说明 | 数据类型 |
in_rank_raster_or_constant | 用于定义要返回的等级位置的输入栅格。 可使用一个数字作为输入;但是,像元大小和范围必须先在环境中进行设置。 | Raster Layer; Constant |
in_rasters [in_raster,...] | 输入栅格列表。 输入可定义参数列表以标识等级值(由每个像元位置的第一个参数确定)。 | Raster Layer |
返回值
名称 | 说明 | 数据类型 |
out_raster | 输出栅格。 对于输出栅格中的每个像元,输入栅格中的值按从低到高的顺序排列,输入等级栅格的值用于选择哪一个将成为输出值。 | Raster |
代码示例
Rank 示例 1(Python 窗口)
此例对多个输入 Grid 栅格执行等级运算,并以 TIFF 栅格数据的形式输出结果。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRank = Rank("cost", ["degs", "negs", "fourgrd"])
outRank.save("C:/sapyexamples/output/outrank.tif")
Rank 示例 2(独立脚本)
此例对多个输入 GRID 栅格执行等级运算,并以 Grid 栅格数据的形式输出结果。
# Name: Rank_Ex_02.py
# Description: Returns the value of a set of rasters based on
# a rank level specified by another 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
inRankRaster = "cost"
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "fourgrd"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Rank
outRank = Rank(inRankRaster, [inRaster01, inRaster02, inRaster03])
# Save the output
outRank.save("C:/sapyexamples/output/outrank")
环境
许可信息
- Basic: 需要 Spatial Analyst
- Standard: 需要 Spatial Analyst
- Advanced: 需要 Spatial Analyst