下舍入 (空间分析)

摘要

返回栅格中每个像元的最近的较小整数。

插图

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

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

语法

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"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute RoundDown
outRoundDRaster = RoundDown(inRaster)

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

环境

像元大小, 当前工作空间, 掩膜, 输出坐标系, 范围, 临时工作空间, 捕捉栅格

许可信息

ArcView: 需要 Spatial Analyst

ArcEditor: 需要 Spatial Analyst

ArcInfo: 需要 Spatial Analyst