Zusammenfassung
Legt Datentyp, Statistiken und NoData-Werte auf einem Raster- oder Mosaik-Dataset fest.
Weitere Informationen zu Raster-Statistiken und Eigenschaften
Verwendung
Mit diesem Werkzeug können Sie die Statistiken für ein Raster- oder Mosaik-Dataset definieren. Normalerweise verwenden Sie dieses Werkzeug, wenn diese Werte nicht berechnet werden sollen. In der Statistik werden die minimalen und maximalen Werte, die Standardabweichung und die Mittelwerte für jedes Band festgelegt. Diese Statistiken können aus einer XML-Datei eingelesen werden.
Diese XML-Datei kann erstellt werden, indem die Statistiken aus einem anderen Raster- oder Mosaik-Dataset in folgender Weise exportiert werden:
- Klicken Sie im Fenster Katalog mit der rechten Maustaste auf das Raster- oder Mosaik-Dataset, das die zu exportierenden Statistiken enthält, und wählen Sie Eigenschaften.
- Führen Sie einen Bildlauf nach unten bis zu der Zeile durch, die die Eigenschaft Statistiken enthält.
- Erweitern Sie das Dropdown-Menü Optionen in der Spalte Wert.
- Klicken Sie auf Statistiken nach XML exportieren.
Die Eigenschaften, die mit diesem Werkzeug festgelegt werden können, bestimmen die Rendering-Standardeinstellungen in ArcMap sowie Statistiken, die von anderen Werkzeugen verwendet werden.
Folgende Eigenschaften können festgelegt werden:
- Datenquellentyp: Definiert, ob die Zellenwerte Höhen- oder Kategoriedaten darstellen oder ob die Werte durch andere Methoden verarbeitet wurden und bei der Anzeige der Daten kein Strecken erforderlich ist.
- Statistiken nach Band: Für jedes Band können Sie die minimalen und maximalen Werte, die Mittelwerte und die Standardabweichung festlegen.
- Bänder für NoData-Wert: Für jedes Band können Sie NoData-Werte definieren.
Syntax
arcpy.management.SetRasterProperties(in_raster, {data_type}, {statistics}, {stats_file}, {nodata}, {key_properties})
Parameter | Erklärung | Datentyp |
in_raster | Das Raster- oder Mosaik-Dataset, dessen Eigenschaften Sie festlegen wollen. | Mosaic Layer ; Raster Layer |
data_type (optional) | Bilddatentyp im Mosaik-Dataset.
| String |
statistics [[band_index, min, max, mean, std_dev],...] (optional) | Geben Sie die Bänder, die Minimal- und Maximalwerte, die Mittelwerte und die Standardabweichung an. | Value Table |
stats_file (optional) | Eine .xml-Datei, die die Statistiken enthält. Diese Datei erstellen Sie, indem Sie die Statistiken aus einem anderen Raster- oder Mosaik-Dataset exportieren. | File |
nodata [[band index, nodata_value],...] (optional) | Geben Sie den NoData-Wert für jedes Band ein. Für jedes Band kann ein eindeutiger NoData-Wert definiert werden. Es kann auch derselbe Wert für alle Bänder angegeben werden. Wenn Sie mehrere NoData-Werte für jede Bandauswahl definieren möchten, setzen Sie ein Leerzeichen als Trennzeichen zwischen die einzelnen NoData-Werte im Parameter bands_for_nodata_value. | Value Table |
key_properties [key_properties,...] (optional) | Die systemintern unterstützten Eigenschaften werden nachfolgend aufgeführt. Ihre Daten können zusätzliche Eigenschaften aufweisen, die nicht in dieser Liste enthalten sind. Bei allen diesen Eigenschaften wird Groß- und Kleinschreibung unterschieden.
| Value Table |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
out_raster | Das Ausgabe-Raster-Dataset. | Raster-Dataset |
Codebeispiel
SetRasterProperties – Beispiel 1 (Python-Fenster)
Dies ist ein Python-Beispiel für SetRasterProperties.
import arcpy
arcpy.SetRasterProperties_management("\\cpu\data\srtm.tif", "ELEVATION",
"1 50 400 5 28" , "#" , "#")
SetRasterProperties – Beispiel 2 (eigenständiges Skript)
Dies ist ein Python-Skriptbeispiel für SetRasterProperties.
#Set raster dataset type and statistics
import arcpy
arcpy.env.workspace = "C:/Workspace"
arcpy.SetRasterProperties_management("srtmraster.tif", "ELEVATION",
"1 50 400 5 28", "#", "#")
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja