Mod (Spatial Analyst Tools)

Zusammenfassung

Den Rest (Modulo) der Teilung des ersten Rasters durch das zweite Raster auf Zellenbasis ermitteln.

Abbildung

Verwendung

Für dieses Werkzeug ist die Reihenfolge der Eingaben relevant.
Mod geht davon aus, dass beide Eingaben ganze Zahlen sind. Wenn irgendwelche Eingaben nicht ganzzahlig sind, werden diese Eingaben durch Abschneiden in ganzzahlige Werte umgewandelt. Ausgabewerte sind immer ganzzahlig.
Etwaigen durch 0 modulierten (dividierten) Werten wird in der Ausgabe der Wert "NoData" zugewiesen. Daher wird für jede Position in der zweiten Eingabe, die den Wert 0 oder "NoData" aufweist in der Ausgabe der Wert "NoData" zurückgegeben.
Wenn der zweite Eingabewert (der Divisor) größer ist als der erste Eingabewert (der Dividend), ist der Wert der Ausgabe mit dem der ersten Eingabe identisch. Wenn Sie z. B. versuchen, den Wert 8 durch den Wert 10 zu teilen, gibt die ganzzahlige Divisionsberechnung den Eingabewert 8 als Rest zurück.
Wenn beide Eingaben Einzelband-Raster sind oder wenn eine der Eingaben eine Konstante ist, dann ist die Ausgabe ein Einzelband-Raster.
Wenn beide Eingaben Multiband-Raster sind, führt das Werkzeug den Vorgang für jedes Band aus einer Eingabe durch, und die Ausgabe ist ein Multiband-Raster. Die Anzahl an Bändern in jeder Multiband-Eingabe muss identisch sein.
Wenn eine der Eingaben ein Multiband-Raster und die andere Eingabe eine Konstante ist, führt das Werkzeug den Vorgang für jedes Band in der Multiband-Eingabe mit dem konstanten Wert durch. Die Ausgabe ist in diesem Fall ein Multiband-Raster.
Wenn beide Eingaben multidimensionale Raster-Daten mit derselben Anzahl an Variablen sind, führt das Werkzeug den Vorgang für alle Ausschnitte mit demselben Dimensionswert durch. Die Ausgabe ist ein multidimensionales Raster im CRF-Format. Die Variablen in den Eingaben müssen mindestens eine gemeinsame Dimension und einen gemeinsamen Dimensionswert enthalten, die von diesem Werkzeug verarbeitet werden sollen. Andernfalls tritt ein Fehler auf.

Wenn beide Eingaben eine Variable, aber unterschiedliche Namen aufweisen, deaktivieren Sie vor dem Ausführen des Werkzeugs die Geoverarbeitungsumgebung "Multidimensionale Variable abgleichen" (durch Festlegen von arcpy.env.matchMultidimensionalVariable = False in Python).

Wenn eine der Eingaben ein multidimensionales Raster und die andere Eingabe eine Konstante ist, führt das Werkzeug den Vorgang für alle Ausschnitte sämtlicher Variablen mit dem konstanten Wert durch, und die Ausgabe ist ein multidimensionales Raster.
In Map Algebra ist das entsprechende Operator-Symbol für dieses Werkzeug "%" (Link).
Weitere Informationen zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter "Analyseumgebungen und Spatial Analyst".

Beschriftung	Erläuterung	Datentyp
Eingabe-Raster oder konstanter Wert 1	Die Zählereingabe. Für diesen Parameter kann eine Zahl als Eingabe verwendet werden, vorausgesetzt für den anderen Parameter wird ein Raster angegeben. Wenn Sie für beide Eingaben eine Zahl angeben möchten, müssen Sie zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.	Raster Layer; Constant
Eingabe-Raster oder konstanter Wert 2	Die Nennereingabe. Für diesen Parameter kann eine Zahl als Eingabe verwendet werden, vorausgesetzt für den anderen Parameter wird ein Raster angegeben. Wenn Sie für beide Eingaben eine Zahl angeben möchten, müssen Sie zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.	Raster Layer; Constant

Beschriftung

Erläuterung

Datentyp

Eingabe-Raster oder konstanter Wert 1

Die Zählereingabe.

Für diesen Parameter kann eine Zahl als Eingabe verwendet werden, vorausgesetzt für den anderen Parameter wird ein Raster angegeben. Wenn Sie für beide Eingaben eine Zahl angeben möchten, müssen Sie zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.

Raster Layer; Constant

Eingabe-Raster oder konstanter Wert 2

Die Nennereingabe.

Raster Layer; Constant

Rückgabewert

Beschriftung	Erläuterung	Datentyp
Ausgabe-Raster	Das Ausgabe-Raster. Die Zellenwerte sind der Rest aus der Division der Werte in der ersten Eingabe durch die zweite Eingabe.	Raster

Beschriftung

Erläuterung

Datentyp

Ausgabe-Raster

Das Ausgabe-Raster.

Die Zellenwerte sind der Rest aus der Division der Werte in der ersten Eingabe durch die zweite Eingabe.

Raster

Mod(in_raster_or_constant1, in_raster_or_constant2)

Name	Erläuterung	Datentyp
in_raster_or_constant1	Die Zählereingabe. Für diesen Parameter kann eine Zahl als Eingabe verwendet werden, vorausgesetzt für den anderen Parameter wird ein Raster angegeben. Wenn Sie für beide Eingaben eine Zahl angeben möchten, müssen Sie zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.	Raster Layer; Constant
in_raster_or_constant2	Die Nennereingabe. Für diesen Parameter kann eine Zahl als Eingabe verwendet werden, vorausgesetzt für den anderen Parameter wird ein Raster angegeben. Wenn Sie für beide Eingaben eine Zahl angeben möchten, müssen Sie zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.	Raster Layer; Constant

Name

Erläuterung

Datentyp

in_raster_or_constant1

Die Zählereingabe.

Raster Layer; Constant

in_raster_or_constant2

Die Nennereingabe.

Raster Layer; Constant

Rückgabewert

Name	Erläuterung	Datentyp
out_raster	Das Ausgabe-Raster. Die Zellenwerte sind der Rest aus der Division der Werte in der ersten Eingabe durch die zweite Eingabe.	Raster

Name

Erläuterung

Datentyp

out_raster

Das Ausgabe-Raster.

Die Zellenwerte sind der Rest aus der Division der Werte in der ersten Eingabe durch die zweite Eingabe.

Raster

Codebeispiel

Mod Beispiel 1 (Python-Fenster)

In diesem Beispiel wird der Wert des Restes (Modulo) aus der Division der Zellen im ersten Raster durch das zweite Raster zurückgegeben.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outMod = Mod("degs", "negs")
outMod.save("C:/sapyexamples/output/outmod.tif")

Mod Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird der Wert des Restes (Modulo) aus der Division der Zellen im ersten Raster durch das zweite Raster zurückgegeben.

# Name: Mod_Ex_02.py
# Description: Finds the remainder of the first raster when divided by
#              the second raster on a cell-by-cell basis
# 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
inRaster1 = "degs"
inRaster2 = "negs"

# Run Mod
outMod = Mod(inRaster1, inRaster2)

# Save the output
outMod.save("C:/sapyexamples/output/outmod")

Umgebungen

Auto-Commit, Zellengröße, Projektionsmethode für Zellengröße, Komprimierung, Aktueller Workspace, Ausdehnung, Geographische Transformationen, Maske, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-Koordinatensystem, Scratch-Workspace, Fang-Raster, Kachelgröße

Lizenzierungsinformationen

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

Mod (Spatial Analyst Tools)

Zusammenfassung

Abbildung

Verwendung

Parameter

Rückgabewert

Umgebungen

Lizenzierungsinformationen

Verwandte Themen