NoData (Environment setting)

Tools that honor the NoData environment setting will only process rasters where the NoData is valid.

Use this environment when the NoData value from your input needs to be transferred to your output raster. This setting allows you to specify which value you use to designate as the NoData value in your output.

Usage notes

• When using the Erweiterung "ArcGIS Spatial Analyst", NONE is the preferred mapping method to use. This produces the same behavior as previous versions of ArcGIS.
• PROMOTION is the safest mapping method, since the NoData value will never be lost. However, promoting the pixel depth of your raster will create an output that is twice as large in size.

Dialog syntax

• NoData – Wählen Sie die zu verwendende NoData-Zuordnungsmethode aus.
  • NONE – Es sind keine NoData-Wert-Regeln vorhanden. Wenn die Eingabe und die Ausgabe den gleichen Wertebereich haben, dann wird der NoData-Bereich ohne Änderungen übertragen. Wenn sich der Wertebereich jedoch ändert, dann gibt es keinen Wert für NoData in der Ausgabe. 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 die Daten ohne Vorzeichen sind, wird der Wert 0 zu 1, der NoData-Wert ist 0 und der Rest der Werte bleibt 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 ist der Maximalwert im Datenbereich, der höchste Wert des Datenbereichs wird um 1 vermindert und der Rest der Werte bleibt gleich. Bei Daten vom Typ "8-Bit-Ganzzahl ohne Vorzeichen" ist z. B. der NoData-Wert 255, der Wert 255 wird zu 254 und der Rest der Werte bleibt 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 einen NoData-Wert im Datenbereich der Eingabe gibt, der in die Ausgabe geschrieben werden soll, oder wenn es kein NoData 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 vom Benutzer angegebene Wert verwendet. 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 Wert 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.

Scripting syntax

arcpy.env.nodata = "mapping_method"

Parameters

Explanation

nodata

The NoData mapping technique used: NoData – Wählen Sie die zu verwendende NoData-Zuordnungsmethode aus. NONE – Es sind keine NoData-Wert-Regeln vorhanden. Wenn die Eingabe und die Ausgabe den gleichen Wertebereich haben, dann wird der NoData-Bereich ohne Änderungen übertragen. Wenn sich der Wertebereich jedoch ändert, dann gibt es keinen Wert für NoData in der Ausgabe. 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 die Daten ohne Vorzeichen sind, wird der Wert 0 zu 1, der NoData-Wert ist 0 und der Rest der Werte bleibt 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 ist der Maximalwert im Datenbereich, der höchste Wert des Datenbereichs wird um 1 vermindert und der Rest der Werte bleibt gleich. Bei Daten vom Typ "8-Bit-Ganzzahl ohne Vorzeichen" ist z. B. der NoData-Wert 255, der Wert 255 wird zu 254 und der Rest der Werte bleibt 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 einen NoData-Wert im Datenbereich der Eingabe gibt, der in die Ausgabe geschrieben werden soll, oder wenn es kein NoData 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 vom Benutzer angegebene Wert verwendet. 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 Wert 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.

pyramid syntax

import arcpy

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