Round Up (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ächsthöhere Ganzzahl zurückgegeben, die als Gleitkommazahl angegeben wird.

Abbildung

Abbildung "Round Up"
OutRas = RoundUp(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ächsthöhere ganzzahlige Wert zugewiesen, und sie wird als Gleitkommawert ohne Dezimalteil dargestellt. Beispiel:

       Input   Output
        5.3     6.0
        4.9     5.0
        3.0     3.0
        6.5     7.0
       -0.2     0.0
       -2.8    -2.0
  • 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 aufzurundenden 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 aufgerundeten Eingabewerte.

Raster

RoundUp(in_raster_or_constant)
NameErläuterungDatentyp
in_raster_or_constant

Die aufzurundenden 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 aufgerundeten Eingabewerte.

Raster

Codebeispiel

RoundUp – Beispiel 1 (Python-Fenster)

In diesem Beispiel werden die Werte im Eingabe-Raster auf den nächsthöheren ganzzahligen Wert aufgerundet und es wird ein Gleitkomma-Raster ausgegeben.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRoundUp = RoundUp("gwhead")
outRoundUp.save("C:/sapyexamples/output/outru")
RoundUp – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel werden die Werte im Eingabe-Raster auf den nächsthöheren ganzzahligen Wert aufgerundet und es wird ein Gleitkomma-Raster ausgegeben.

# Name: RoundUp_Ex_02.py
# Description: Returns the next higher 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 RoundUp
outRoundURaster = RoundUp(inRaster)

# Save the output 
outRoundURaster.save("C:/sapyexamples/output/outroundup")

Lizenzinformationen

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

Verwandte Themen