下舍入 (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

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

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

• 如果输入是多维栅格数据，则将处理所有变量的所有切片。 输出将是 CRF 格式的多维栅格。

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

参数

对话框

标注	说明	数据类型
输入栅格数据或常量值	将被下舍入的输入值。 要将数字用作该参数的输入，必须先设置像元大小和范围。	Raster Layer; Constant

返回值

标注	说明	数据类型
输出栅格	输出栅格。 像元值是将输入值向下舍入的结果。	Raster

Python

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