上舍入 (Spatial Analyst)

需要 Spatial Analyst 许可。

获得 Image Analyst 许可后可用。

摘要

返回栅格中每个像元的最近的较大整数值(以浮点表示)。

插图

“上舍入”图示
OutRas = RoundUp(InRas1)

使用情况

  • 输入值可为正数,也可为负数。

  • 无论输入值是何种类型,此工具的输出栅格数据始终为浮点型。

  • 如果输入数具有小数点右侧的任意值,则会将输出分配到最近的较大整数值,但会将此输出数表示为浮点数且不含任何小数部分。 例如:

       Input   Output
        5.3     6.0
        4.9     5.0
        3.0     3.0
        6.5     7.0
       -0.2     0.0
       -2.8    -2.0
  • 如果输入是多波段栅格,则输出也将为多波段栅格。 该工具将在输入中的每个波段上执行操作。

  • 在 ArcPy 中,如果输入是多维栅格,则将处理所有变量的所有切片,而输出将为多维栅格。

  • 有关适用于此工具的地理处理环境的详细信息,请参阅分析环境和 Spatial Analyst

参数

标注说明数据类型
输入栅格数据或常量值

将被上舍入的输入值。

要使用数字作为此参数的输入,像元大小和范围必须先在环境中进行设置。

Raster Layer; Constant

返回值

标注说明数据类型
输出栅格

输出栅格。

像元值是将输入值向上舍入的结果。

Raster

RoundUp(in_raster_or_constant)
名称说明数据类型
in_raster_or_constant

将被上舍入的输入值。

要使用数字作为此参数的输入,像元大小和范围必须先在环境中进行设置。

Raster Layer; Constant

返回值

名称说明数据类型
out_raster

输出栅格。

像元值是将输入值向上舍入的结果。

Raster

代码示例

上舍入 (RoundUp) 示例 1(Python 窗口)

此示例将输入栅格中的值向上舍入到最近的较大整数值并输出浮点型栅格。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRoundUp = RoundUp("gwhead")
outRoundUp.save("C:/sapyexamples/output/outru")
上舍入 (RoundUp) 示例 2(独立脚本)

此示例将输入栅格中的值向上舍入到最近的较大整数值并输出浮点型栅格。

# Name: RoundUp_Ex_02.py
# Description: Returns the next higher whole number for each cell
#              in a 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 = "gwhead"

# Execute RoundUp
outRoundURaster = RoundUp(inRaster)

# Save the output 
outRoundURaster.save("C:/sapyexamples/output/outroundup")

许可信息

  • Basic: 需要 Spatial Analyst 或 Image Analyst
  • Standard: 需要 Spatial Analyst 或 Image Analyst
  • Advanced: 需要 Spatial Analyst 或 Image Analyst

相关主题