下舍入 (Spatial Analyst)

需要 Spatial Analyst 许可。

获得 Image Analyst 许可后可用。

描述

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

插图

下舍入图示
OutRas = RoundDown(InRas1)

使用方法

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

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

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

        Input   Output
         5.3     5.0
         4.9     4.0
         3.0     3.0
         6.5     6.0
        -0.2    -1.0
        -2.8    -3.0
  • 转为整型工具与下舍入工具间存在差别。例如,给定以下两个值,转为整型始终会截断数字:

    • 1.5 将变为 1
    • -1.5 将变为 -1

    对于相同的两个值,下舍入函数将返回如下:

    • 1.5 将变为 1.0
    • -1.5 将变为 -2.0

    另一种差别就是下舍入可输出浮点值,而转为整型仅输出整数值。

  • 如果输入是多波段栅格,则输出也将为多波段栅格。该工具将在输入中的每个波段上执行操作。

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

语法

RoundDown(in_raster_or_constant)
参数说明数据类型
in_raster_or_constant

将被下舍入的输入值。

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

Raster Layer; Constant

返回值

名称说明数据类型
out_raster

输出栅格。

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

Raster

代码示例

下舍入 (RoundDown) 示例 1(Python 窗口)

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRoundDown = RoundDown("gwhead")
outRoundDown.save("C:/sapyexamples/output/outrd")
下舍入 (RoundDown) 示例 2(独立脚本)

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

# Name: RoundDown_Ex_02.py
# Description: Returns the next lower 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 RoundDown
outRoundDRaster = RoundDown(inRaster)

# Save the output 
outRoundDRaster.save("C:/sapyexamples/output/outrounddown")

许可信息

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

相关主题