Round Down (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Mit der Image Analyst-Lizenz verfügbar.

Zusammenfassung

Für jede Zelle in einem Raster wird die nächstniedrigere Ganzzahl zurückgegeben, die als Gleitkommazahl angegeben wird.

Abbildung

OutRas = RoundDown(InRas1)

Verwendung

• Die Eingabewerte können sowohl positiv als auch negativ sein.

• Bei diesem Werkzeug ist das Ausgabe-Raster immer ein Gleitkomma-Raster, unabhängig von der Art des Eingabewertes.

• Wenn eine Eingabenummer Werte rechts vom Dezimaltrennzeichen aufweist, wird der Ausgabe der nächstkleinere ganzzahlige Wert zugewiesen, und sie wird als Gleitkommawert ohne Dezimalteil dargestellt. Beispiel:

      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

• Es gibt einen Unterschied zwischen dem Werkzeug Int und dem Werkzeug Round Down. Beispielsweise schneidet das Werkzeug Int bei den beiden folgenden Werten immer die Zahl ab:

  • 1,5 wird zu 1.
  • -1,5 wird zu -1.

  Das Werkzeug Round Down gibt für die gleichen Werte Folgendes zurück:

  • 1,5 wird zu 1,0.
  • -1,5 wird zu -2,0.

  Ein weiterer Unterschied ist, dass Round Down Gleitkommawerte ausgibt, während Int ausschließlich ganzzahlige Werte ausgibt.

• Wenn die Eingabe ein Multiband-Raster ist, dann ist auch die Ausgabe ein Multiband-Raster. Das Werkzeug führt den Vorgang für jedes Band in der Eingabe durch.

• Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Syntax

RoundDown(in_raster_or_constant)

Parameter	Erklärung	Datentyp
in_raster_or_constant	Die abzurundenden Eingabewerte. Um eine Zahl als Eingabe für diesen Parameter zu verwenden, müssen Sie zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.	Raster Layer; Constant

Rückgabewert

Name	Erklärung	Datentyp
out_raster	Das Ausgabe-Raster. Die Zellenwerte sind das Ergebnis der abgerundeten Eingabewerte.	Raster

Codebeispiel

RoundDown – Beispiel 1 (Python-Fenster)

In diesem Beispiel werden die Werte im Eingabe-Raster auf den nächstkleineren ganzzahligen Wert abgerundet und es wird ein Gleitkomma-Raster ausgegeben.

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– Beispiel 2 (eigenständiges Skript)

In diesem Beispiel werden die Werte im Eingabe-Raster auf den nächstkleineren ganzzahligen Wert abgerundet und es wird ein Gleitkomma-Raster ausgegeben.

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

Umgebungen

Auto-Commit, Zellengröße, Projektionsmethode für Zellengröße, Aktueller Workspace, Ausdehnung, Geographische Transformationen, Maskieren, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-Koordinatensystem, Scratch-Workspace, Fang-Raster, Kachelgröße

Lizenzinformationen

• Basic: Erfordert Spatial Analyst oder Image Analyst
• Standard: Erfordert Spatial Analyst oder Image Analyst
• Advanced: Erfordert Spatial Analyst oder Image Analyst