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

Abbildung "Round Down"
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.

  • Wenn in ArcPy die Eingabe ein multidimensionales Raster ist, werden alle Ausschnitte sämtlicher Variablen verarbeitet, und die Ausgabe ist ein multidimensionales Raster.

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

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Raster oder konstanter Wert

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

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster.

Die Zellenwerte sind das Ergebnis der abgerundeten Eingabewerte.

Raster

RoundDown(in_raster_or_constant)
NameErläuterungDatentyp
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

NameErläuterungDatentyp
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")

Lizenzinformationen

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

Verwandte Themen