Divide (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Mit der Image Analyst-Lizenz verfügbar.

Mit der 3D Analyst-Lizenz verfügbar.

Zusammenfassung

Die Werte von zwei Rastern auf Zellenbasis teilen.

Abbildung

OutRas = Divide (InRas1, InRas2)

Verwendung

• Für dieses Werkzeug ist die Reihenfolge der Eingaben relevant.

• Wird eine Zahl durch 0 geteilt, ist das Ergebnis der Ausgabe "NoData".

• Die Datentypen der Eingaben, um den Datentyp der Ausgabe zu bestimmen:

  • Sind beide Eingaben ganze Zahlen, wird eine ganzzahlige Division durchgeführt, deren Ergebnis eine ganze Zahl ist. Wenn beispielsweise 3 durch 2 geteilt wird, ist die Ausgabe 1.
  • Wenn eine der Eingaben eine Gleitkommazahl ist, wird eine Gleitkommadivision durchgeführt. Das Ausgabeergebnis ist ein Gleitkommawert. Wenn beispielsweise 3 durch 2,0 geteilt wird, ist die Ausgabe 1,5.

• 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 in ArcPy beide Eingaben multidimensionale Raster mit derselben Anzahl an Variablen sind, führt das Werkzeug den Vorgang für alle Ausschnitte mit demselben Dimensionswert durch, und die Ausgabe ist ein multidimensionales Raster. Die Variablen in den Eingaben müssen gleiche Dimensionen oder eine gemeinsame Dimension, dürfen jedoch keine nicht gemeinsamen Dimensionen aufweisen.

  Wenn beide Eingaben eine Variable, aber unterschiedliche Namen aufweisen, legen Sie für die matchMultidimensionalVariable-Geoverarbeitungsumgebung False fest, um den Vorgang auszuführen.

  Wenn in ArcPy 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 Operatorsymbol für dieses Werkzeug "/" (Link).

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

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Raster oder konstanter Wert 1	Die Eingabe, deren Werte durch die zweite Eingabe dividiert werden. Für diesen Parameter kann eine Zahl als Eingabe verwendet werden, vorausgesetzt für den anderen Parameter wird ein Raster angegeben. Um eine Zahl für beide Eingaben anzugeben, 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 Eingabe, durch deren Werte die erste Eingabe dividiert werden muss. Für diesen Parameter kann eine Zahl als Eingabe verwendet werden, vorausgesetzt für den anderen Parameter wird ein Raster angegeben. Um eine Zahl für beide Eingaben anzugeben, 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 der Quotient des ersten Eingabe-Rasters (Dividend), dividiert durch die zweite Eingabe (Divisor).	Raster

Python

Divide(in_raster_or_constant1, in_raster_or_constant2)

Name	Erläuterung	Datentyp
in_raster_or_constant1	Die Eingabe, deren Werte durch die zweite Eingabe dividiert werden. Für diesen Parameter kann eine Zahl als Eingabe verwendet werden, vorausgesetzt für den anderen Parameter wird ein Raster angegeben. Um eine Zahl für beide Eingaben anzugeben, müssen Sie zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.	Raster Layer; Constant
in_raster_or_constant2	Die Eingabe, durch deren Werte die erste Eingabe dividiert werden muss. Für diesen Parameter kann eine Zahl als Eingabe verwendet werden, vorausgesetzt für den anderen Parameter wird ein Raster angegeben. Um eine Zahl für beide Eingaben anzugeben, 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 der Quotient des ersten Eingabe-Rasters (Dividend), dividiert durch die zweite Eingabe (Divisor).	Raster

Codebeispiel

Divide – Beispiel 1 (Python-Fenster)

Dieses Beispiel dividiert die Werte des ersten Eingabe-Rasters durch das zweite.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outDivide = Divide("degs", "negs")
outDivide.save("C:/sapyexamples/output/outdivide2")

Divide – Beispiel 2 (eigenständiges Skript)

Dieses Beispiel dividiert die Werte des ersten Eingabe-Rasters durch das zweite.

# Name: Divide_Ex_02.py
# Description: Divides the values of two rasters 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
inRaster01 = "elevation"
inRaster02 = "landuse"

# Execute Divide
outDivide = Divide(inRaster01, inRaster02)

# Save the output 
outDivide.save("C:/sapyexamples/output/outdivide")

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

Sonderfälle

Lizenzinformationen

• Basic: Erfordert Spatial Analyst, Image Analyst oder 3D Analyst
• Standard: Erfordert Spatial Analyst, Image Analyst oder 3D Analyst
• Advanced: Erfordert Spatial Analyst, Image Analyst oder 3D Analyst