Round Down (Spatial 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

• [Int] ツールと [Round Down] ツールには違いがあります。たとえば、以下の 2 つの値に対して [Int] は常に数値を切り捨てます。

  • 1.5 は 1 になります。
  • -1.5 は -1 になります。

  一方、同じ 2 つの値に対して [Round Down] は次の値を返します。

  • 1.5 は 1.0 になります。
  • -1.5 は -2.0 になります。

  もう 1 つの違いとして、[Round Down] が浮動小数点値を出力するのに対して、[Int] は整数値だけを出力します。

構文

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")

環境

セル サイズ, 現在のワークスペース, マスク, 出力データの座標系, 範囲, テンポラリ ワークスペース, スナップ対象ラスタ

ライセンス情報

ArcGIS for Desktop Basic: 次のものが必要 Spatial Analyst

ArcGIS for Desktop Standard: 次のものが必要 Spatial Analyst

ArcGIS for Desktop Advanced: 次のものが必要 Spatial Analyst