Raster-Eigenschaften festlegen (Data Management)

Zusammenfassung

Legt Datentyp, Statistiken und NoData-Werte auf einem Raster- oder Mosaik-Dataset fest.

Verwendung

• Mit diesem Werkzeug können Sie die Statistiken für ein Raster- oder Mosaik-Dataset definieren. Normalerweise verwenden Sie dieses Werkzeug, wenn keine Statistiken berechnet werden sollen. Sie können die minimalen und maximalen Werte, die Standardabweichung und die Mittelwerte für jedes Band festlegen. Diese Statistiken können aus einer .xml-Datei eingelesen werden.

• Die Eigenschaften, die mit diesem Werkzeug festgelegt werden können, bestimmen die Rendering-Standardeinstellungen in ArcGIS AllSource sowie Statistiken, die von anderen Werkzeugen verwendet werden.

  Sie können die folgenden Eigenschaften festlegen:

  • 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: Definieren Sie für jedes Band die minimalen und maximalen Werte, den Mittelwert und die Standardabweichung.
  • Bänder für NoData-Wert: Definieren Sie für jedes Band einen NoData-Wert.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Raster	Das Raster- oder Mosaik-Dataset mit den festzulegenden Eigenschaften.	Mosaic Layer ; Raster Layer
Datenquellentyp (optional)	Gibt den Bilddatentyp im Mosaik-Dataset an. Generisch—Für das Mosaik-Dataset wurde kein Datentyp angegeben. Erhöhung—Das Mosaik-Dataset enthält Höhendaten. Thematisch—Das Mosaik-Dataset enthält thematische Daten mit diskontinuierlichen Werten, wie z. B. Bodenbedeckung. Verarbeitet—Die Farbe des Mosaik-Datasets wurde angepasst. Wissenschaftlich—Die Daten enthalten wissenschaftliche Informationen und werden standardmäßig mit dem Farbverlauf von blau zu rot angezeigt. Vektor-UV—Die Daten bestehen aus einem Zweiband-Raster mit einer U- und einer V-Komponente von Vektorfelddaten. Magnitude und Richtung—Die Daten bestehen aus einem Zweiband-Raster mit einer Höhe und der Richtung von Vektorfelddaten. Datum—Die Daten enthalten Datumsinformationen und werden im Datumsformat angezeigt.	String
Statistiken nach Band (optional)	Die Bänder und die Minimal- und Maximalwerte, die Mittelwerte sowie die Standardabweichung.	Value Table
Statistiken aus Datei importieren (optional)	Eine .xml-Datei, die die Statistiken enthält.	File
Bänder für NoData-Wert (optional)	Der NoData-Wert für jedes Band. Für jedes Band kann ein eindeutiger NoData-Wert definiert werden. Es kann auch derselbe Wert für alle Bänder angegeben werden. Klicken Sie auf den Dropdown-Pfeil NoData, wählen Sie ein Band aus der Liste aus, und klicken Sie auf die Schaltfläche Hinzufügen, um das Band der Tabelle hinzuzufügen. Geben Sie dann einen oder mehrere Werte ein. Wenn Sie mehrere NoData-Werte auswählen, trennen Sie die einzelnen Werte mit Leerzeichen.	Value Table
Schlüsseleigenschaften (optional)	Die nativ unterstützten Eigenschaften. Die verwendeten Daten können zusätzliche Eigenschaften aufweisen, die nicht in der folgenden Liste enthalten sind. Bei den Eigenschaften wird nicht zwischen Groß-/Kleinschreibung unterschieden. AcquisitionDate BandName BlockName CloudCover DatasetTag FlowDirection Footprint HighCellSize LowCellSize MinCellSize MaxCellSize OffNadir ParentRasterType ParentTemplate PerspectiveX PerspectiveY PerspectiveZ ProductName RadianceBias RadianceGain ReflectanceBias ReflectanceGain Segmentiert SensorAzimuth SensorElevation SensorName SolarIrradiance SourceBandIndex SunAzimuth SunElevation ThermalConstant_K1 ThermalConstant_K2 VerticalAccuracy WavelengthMin WavelengthMax	Value Table
Multidimensionale Informationen (optional)	Die dimensionalen Informationen für das Raster-Dataset. Durch das Festlegen von dimensionalen Informationen wird das Raster ohne Dimensionen in ein multidimensionales Raster konvertiert. Für die Dimension "Zeit" muss der Dimensionsname StdTime lauten. Das Format für Zeit lautet entweder Jahr-Monat-Tag (2021-10-01) oder Jahr-Monat-TagThh:mm:ss (2021-10-01T01:00:00). Um eine Variable mit Zeit und Höhe zu definieren, fügen Sie zuerst die Variable mit der Zeit und dann die gleiche Variable mit der Z-Dimension hinzu.	Value Table

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisiertes Raster-Dataset	Das Ausgabe-Raster-Dataset.	Raster Dataset

Python

arcpy.management.SetRasterProperties(in_raster, {data_type}, {statistics}, {stats_file}, {nodata}, {key_properties}, {multidimensional_info})

Name	Erläuterung	Datentyp
in_raster	Das Raster- oder Mosaik-Dataset mit den festzulegenden Eigenschaften.	Mosaic Layer ; Raster Layer
data_type (optional)	Gibt den Bilddatentyp im Mosaik-Dataset an. GENERIC—Für das Mosaik-Dataset wurde kein Datentyp angegeben. ELEVATION—Das Mosaik-Dataset enthält Höhendaten. THEMATIC—Das Mosaik-Dataset enthält thematische Daten mit diskontinuierlichen Werten, wie z. B. Bodenbedeckung. PROCESSED—Die Farbe des Mosaik-Datasets wurde angepasst. SCIENTIFIC—Die Daten enthalten wissenschaftliche Informationen und werden standardmäßig mit dem Farbverlauf von blau zu rot angezeigt. VECTOR_UV—Die Daten bestehen aus einem Zweiband-Raster mit einer U- und einer V-Komponente von Vektorfelddaten. VECTOR_MAGDIR—Die Daten bestehen aus einem Zweiband-Raster mit einer Höhe und der Richtung von Vektorfelddaten. DATE—Die Daten enthalten Datumsinformationen und werden im Datumsformat angezeigt.	String
statistics [[band_index, min, max, mean, std_dev],...] (optional)	Die Bänder und die Minimal- und Maximalwerte, die Mittelwerte sowie die Standardabweichung.	Value Table
stats_file (optional)	Eine .xml-Datei, die die Statistiken enthält.	File
nodata [[band index, nodata_value],...] (optional)	Der NoData-Wert für jedes Band. 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.	Value Table
key_properties [key_properties,...] (optional)	Die nativ unterstützten Eigenschaften. Die verwendeten Daten können zusätzliche Eigenschaften aufweisen, die nicht in der folgenden Liste enthalten sind. Bei den Eigenschaften wird nicht zwischen Groß-/Kleinschreibung unterschieden. AcquisitionDate BandName BlockName CloudCover DatasetTag FlowDirection Footprint HighCellSize LowCellSize MinCellSize MaxCellSize OffNadir ParentRasterType ParentTemplate PerspectiveX PerspectiveY PerspectiveZ ProductName RadianceBias RadianceGain ReflectanceBias ReflectanceGain Segmentiert SensorAzimuth SensorElevation SensorName SolarIrradiance SourceBandIndex SunAzimuth SunElevation ThermalConstant_K1 ThermalConstant_K2 VerticalAccuracy WavelengthMin WavelengthMax	Value Table
multidimensional_info [multidimensional_info,...] (optional)	Die dimensionalen Informationen für das Raster-Dataset. Durch das Festlegen von dimensionalen Informationen wird das Raster ohne Dimensionen in ein multidimensionales Raster konvertiert. Für die Dimension "Zeit" muss der Dimensionsname StdTime lauten. Das Format für Zeit lautet entweder Jahr-Monat-Tag (2021-10-01) oder Jahr-Monat-TagThh:mm:ss (2021-10-01T01:00:00). Um eine Variable mit Zeit und Höhe zu definieren, fügen Sie zuerst die Variable mit der Zeit und dann die gleiche Variable mit der Z-Dimension hinzu.	Value Table

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_raster	Das Ausgabe-Raster-Dataset.	Raster Dataset

Codebeispiel

SetRasterProperties: Beispiel 1 (Python-Fenster)

Dies ist ein Python-Beispiel für die Funktion 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 die Funktion 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

Aktueller Workspace, Scratch-Workspace