Round Up (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Mit der Image Analyst-Lizenz verfügbar.

Zusammenfassung

Gibt für jede Zelle in einem Raster die nächsthöhere Ganzzahl zurück, die als Gleitkommazahl angegeben wird.

Abbildung

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 als Eingabe multidimensionale Raster-Daten verwendet werden, werden alle Ausschnitte sämtlicher Variablen verarbeitet. Die Ausgabe ist ein multidimensionales Raster im CRF-Format.

• Weitere Informationen zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
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

Beschriftung	Erläuterung	Datentyp
Ausgabe-Raster	Das Ausgabe-Raster. Die Zellenwerte sind das Ergebnis der aufgerundeten Eingabewerte.	Raster

Python

RoundUp(in_raster_or_constant)

Name	Erläuterung	Datentyp
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

Name	Erläuterung	Datentyp
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")

Umgebungen

Auto-Commit, Zellengröße, Projektionsmethode für Zellengröße, Aktueller Workspace, Ausdehnung, Geographische Transformationen, Maske, 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