Round Down (Spatial Analyst)

Zusammenfassung

Gibt für jede Zelle in einem Raster die nächstkleinere ganze Zahl zurück.

Bild

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 Eingabewerts.

• Wenn eine Zahl irgendwelche Werte rechts vom Dezimaltrennzeichen aufweist, wird der Ausgabe der nächstkleinere Ganzzahlwert zugewiesen. 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.

  Demgegenüber gibt 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 Ganzzahlwerte ausgibt.

Syntax

RoundDown (in_raster_or_constant)

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

Rückgabewert

Name	Erläuterung	Datentyp
out_raster	Das Ausgabe-Raster. Die Zellenwerte sind die Eingabewerte, die durch Abrunden auf die nächstkleinere ganze Zahl in Ganzzahlwerte umgewandelt wurden.	Raster

Codebeispiel

RoundDown – Beispiel 1 (Python-Fenster)

In diesem Beispiel werden die Werte im Eingabe-Raster auf die nächstkleinere ganze Zahl abgerundet.

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 die nächstkleinere ganze Zahl abgerundet.

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

Umgebung

Cell Size, Current Workspace, Mask, Output Coordinate System, Extent, Scratch Workspace, Snap Raster

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Erfordert Spatial Analyst

ArcGIS for Desktop Standard: Erfordert Spatial Analyst

ArcGIS for Desktop Advanced: Erfordert Spatial Analyst