NoData (Umgebungseinstellung)

Werkzeuge, die die Umgebungseinstellung "NoData" berücksichtigen, verarbeiten nur Raster mit gültigen NoData-Werten.

Verwenden Sie diese Umgebungseinstellung, wenn der NoData-Wert der Eingabe an das Ausgabe-Raster übertragen werden muss. Mit dieser Einstellung können Sie den Wert angeben, den Sie in der Ausgabe als NoData-Wert verwenden.

Verwendungshinweise

  • Bei Verwendung der Erweiterung "ArcGIS Spatial Analyst" ist NONE die bevorzugte Zuordnungsmethode. Auf diese Weise wird dasselbe Verhalten wie in früheren Versionen von ArcGIS erzeugt.
  • Die Option Promotion ist die sicherste Zuordnungsmethode, da der NoData-Wert nie verloren geht. Durch Heraufstufung der Pixeltiefe eines Rasters wird jedoch eine doppelt so große Ausgabe erzeugt.

Dialogfeldsyntax

Die folgenden NoData-Zuordnungsoptionen werden verwendet:

  • NONE: Es sind keine NoData-Wert-Regeln vorhanden. Wenn die Eingabe und die Ausgabe denselben Wertebereich aufweisen, wird der NoData-Wert ohne Änderungen übertragen. Wenn sich der Wertebereich jedoch ändert, wird für NoData kein Wert ausgegeben. Dies ist das Standardverfahren.
  • Maximum: Der Maximalwert im Ausgabe-Datenbereich wird als NoData-Wert verwendet.
  • Minimum: Der Minimalwert im Ausgabe-Datenbereich wird als NoData-Wert verwendet.
  • Kartenwerte heraufstufen: Der niedrigste Wert im Bereich wird heraufgestuft und der niedrigste wird zu NoData. Wenn es sich um Daten ohne Vorzeichen handelt, wird der Wert 0 in 1 geändert, der NoData-Wert beträgt 0, und die restlichen Werte bleiben gleich. Wenn die Daten Vorzeichen enthalten, wird der niedrigste Wert im Bereich heraufgestuft und der niedrigste wird zu NoData. Bei Daten vom Typ "8-Bit-Ganzzahl mit Vorzeichen" wird z. B. -127 zu -126 und der NoData-Wert beträgt -127.
  • Kartenwerte herabstufen: Der NoData-Wert entspricht dem Maximalwert im Datenbereich, der höchste Wert des Datenbereichs wird um 1 vermindert, und die restlichen Werte bleiben gleich. Bei Daten vom Typ "8-Bit-Ganzzahl ohne Vorzeichen" lautet z. B. der NoData-Wert 255, der Wert 255 wird in 254 geändert, und die restlichen Werte bleiben gleich.
  • Promotion: Wenn es einen NoData-Wert außerhalb des Datenbereichs der Eingabe gibt, wird die Pixeltiefe der Ausgabe auf die nächste verfügbare Stufe erhöht und der NoData-Bereich erhält den Maximalwert im neuen Datenbereich. Ein 8-Bit-Ganzzahl-Dataset ohne Vorzeichen, für das NoData dem Wert 256 entsprechen muss, wird z. B. auf ein 16-Bit-Dataset heraufgestuft und der Maximalwert wird NoData. Wenn es im Datenbereich der Eingabe einen NoData-Wert gibt, der in die Ausgabe geschrieben werden soll, oder wenn es keine NoData-Werte gibt, wird die Pixeltiefe nicht heraufgestuft.

    Wenn es einen NoData-Wert außerhalb des Datenbereichs der Eingabe gibt, wird die Pixeltiefe auf die nächste verfügbare Stufe erhöht, und als NoData-Wert wird der Wert verwendet, der angegeben wurde. Beispielsweise wird ein 8-Bit-Ganzzahl-Dataset ohne Vorzeichen, für das der NoData-Wert dem Wert 256 entsprechen muss, auf ein 16-Bit-Dataset heraufgestuft und 256 wird zum NoData-Wert. Wenn der angegebene NoData-Wert innerhalb des Datenbereichs der Eingabe liegt, wird die Pixeltiefe für die Ausgabe nicht heraufgestuft.

Skriptsyntax

arcpy.env.nodata = "mapping_method"

ParameterErläuterung

nodata

Die folgenden NoData-Zuordnungsoptionen werden verwendet:

  • NONE: Es sind keine NoData-Wert-Regeln vorhanden. Wenn die Eingabe und die Ausgabe denselben Wertebereich aufweisen, wird der NoData-Wert ohne Änderungen übertragen. Wenn sich der Wertebereich jedoch ändert, wird für NoData kein Wert ausgegeben. Dies ist das Standardverfahren.
  • MAXIMUM: Der Maximalwert im Ausgabe-Datenbereich wird als NoData-Wert verwendet.
  • MINIMUM: Der Minimalwert im Ausgabe-Datenbereich wird als NoData-Wert verwendet.
  • MAP_UP: Der niedrigste Wert im Bereich wird heraufgestuft und der niedrigste wird zu NoData. Wenn es sich um Daten ohne Vorzeichen handelt, wird der Wert 0 in 1 geändert, der NoData-Wert beträgt 0, und die restlichen Werte bleiben gleich. Wenn die Daten Vorzeichen enthalten, wird der niedrigste Wert im Bereich heraufgestuft und der niedrigste wird zu NoData. Bei Daten vom Typ "8-Bit-Ganzzahl mit Vorzeichen" wird z. B. -127 zu -126 und der NoData-Wert beträgt -127.
  • MAP_DOWN: Der NoData-Wert entspricht dem Maximalwert im Datenbereich, der höchste Wert des Datenbereichs wird um 1 vermindert, und die restlichen Werte bleiben gleich. Bei Daten vom Typ "8-Bit-Ganzzahl ohne Vorzeichen" lautet z. B. der NoData-Wert 255, der Wert 255 wird in 254 geändert, und die restlichen Werte bleiben gleich.
  • PROMOTION: Wenn es einen NoData-Wert außerhalb des Datenbereichs der Eingabe gibt, wird die Pixeltiefe der Ausgabe auf die nächste verfügbare Stufe erhöht und der NoData-Bereich erhält den Maximalwert des neuen Datenbereichs. Ein 8-Bit-Ganzzahl-Dataset ohne Vorzeichen, für das NoData dem Wert 256 entsprechen muss, wird z. B. auf ein 16-Bit-Dataset heraufgestuft und der Maximalwert wird NoData. Wenn es im Datenbereich der Eingabe einen NoData-Wert gibt, der in die Ausgabe geschrieben werden soll, oder wenn es keine NoData-Werte gibt, wird die Pixeltiefe nicht heraufgestuft.

    Wenn es einen NoData-Wert außerhalb des Datenbereichs der Eingabe gibt, wird die Pixeltiefe auf die nächste verfügbare Stufe erhöht, und als NoData-Wert wird der Wert verwendet, der angegeben wurde. Beispielsweise wird ein 8-Bit-Ganzzahl-Dataset ohne Vorzeichen, für das der NoData-Wert dem Wert 256 entsprechen muss, auf ein 16-Bit-Dataset heraufgestuft und 256 wird zum NoData-Wert. Wenn der angegebene NoData-Wert innerhalb des Datenbereichs der Eingabe liegt, wird die Pixeltiefe für die Ausgabe nicht heraufgestuft.

nodata-Syntax

Skriptbeispiel

import arcpy

# Set the nodata mapping method environment to promote the value
arcpy.env.nodata = "PROMOTION"