Round Up (Image 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.

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

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.ia import *
env.workspace = "C:/iapyexamples/data"
outRoundUp = RoundUp("gwhead")
outRoundUp.save("C:/iapyexamples/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 pixel
#              in a raster
# Requirements: Image Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *

# Set environment settings
env.workspace = "C:/iapyexamples/data"

# Set local variables
inRaster = "gwhead"

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

# Execute RoundUp
outRoundURaster = RoundUp(inRaster)

# Save the output 
outRoundURaster.save("C:/iapyexamples/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 Image Analyst oder Spatial Analyst
• Standard: Erfordert Image Analyst oder Spatial Analyst
• Advanced: Erfordert Image Analyst oder Spatial Analyst