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

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.

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

Syntax

RoundUp(in_raster_or_constant)

Parameter	Erklärung	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	Erklärung	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, 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