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 Pro 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

BeschriftungErläuterungDatentyp
Eingabe-Raster

Das Raster- oder Mosaik-Dataset mit den festzulegenden Eigenschaften.

Mosaic Layer ; Raster Layer
Datenquellentyp
(optional)

Gibt den Bilddatentyp im Mosaik-Dataset an.

  • GenerischFür das Mosaik-Dataset wurde kein Datentyp angegeben.
  • ErhöhungDas Mosaik-Dataset enthält Höhendaten.
  • ThematischDas Mosaik-Dataset enthält thematische Daten mit diskontinuierlichen Werten, wie z. B. Bodenbedeckung.
  • VerarbeitetDie Farbe des Mosaik-Datasets wurde angepasst.
  • WissenschaftlichDie Daten enthalten wissenschaftliche Informationen und werden standardmäßig mit dem Farbverlauf von blau zu rot angezeigt.
  • Vektor-UVDie Daten bestehen aus einem Zweiband-Raster mit einer U- und einer V-Komponente von Vektorfelddaten.
  • Magnitude und RichtungDie Daten bestehen aus einem Zweiband-Raster mit einer Höhe und der Richtung von Vektorfelddaten.
  • DatumDie 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

BeschriftungErläuterungDatentyp
Aktualisiertes Raster-Dataset

Das Ausgabe-Raster-Dataset.

Raster Dataset

arcpy.management.SetRasterProperties(in_raster, {data_type}, {statistics}, {stats_file}, {nodata}, {key_properties}, {multidimensional_info})
NameErläuterungDatentyp
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.

  • GENERICFür das Mosaik-Dataset wurde kein Datentyp angegeben.
  • ELEVATIONDas Mosaik-Dataset enthält Höhendaten.
  • THEMATICDas Mosaik-Dataset enthält thematische Daten mit diskontinuierlichen Werten, wie z. B. Bodenbedeckung.
  • PROCESSEDDie Farbe des Mosaik-Datasets wurde angepasst.
  • SCIENTIFICDie Daten enthalten wissenschaftliche Informationen und werden standardmäßig mit dem Farbverlauf von blau zu rot angezeigt.
  • VECTOR_UVDie Daten bestehen aus einem Zweiband-Raster mit einer U- und einer V-Komponente von Vektorfelddaten.
  • VECTOR_MAGDIRDie Daten bestehen aus einem Zweiband-Raster mit einer Höhe und der Richtung von Vektorfelddaten.
  • DATEDie 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

NameErläuterungDatentyp
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", "#", "#")

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja