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 Extension 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. - Sélectionnez la méthode de mappage NoData à utiliser.
  • NONE - Aucune règle de valeur NoData ne sera mise en place. Si votre entrée et votre sortie ont la même plage de valeurs, la valeur NoData est transférée sans changement. Toutefois, si votre plage de valeurs change, il n'y aura aucune valeur pour NoData dans votre sortie. Il s'agit de la méthode par défaut.
  • MAXIMUM - La valeur maximale de la plage de données en sortie sera utilisée en tant que valeur NoData.
  • MINIMUM - La valeur minimale de la plage de données en sortie sera utilisée en tant que valeur NoData.
  • MAP_UP - La valeur la plus basse de la plage est remontée et la plus basse devient NoData. Si les données sont non signées, la valeur de zéro devient un, la valeur NoData est zéro, et le reste des valeurs reste identique. Si les données sont signées, la valeur la plus basse de la plage est remontée et la plus basse devient NoData. Par exemple, avec les données de nombre entier signé 8 bits, -127 devient -126 et la valeur NoData est -127.
  • MAP_DOWN - La valeur NoData est la valeur maximale de la plage de données, la valeur la plus élevée de la plage de données devient une valeur de moins, et le reste des valeurs reste identique. Par exemple, avec des données d'entier non signé 8 bits, la valeur NoData est 255, la valeur 255 devient 254, et le reste des valeurs reste identique.

  • PROMOTION - Si une valeur NoData se trouve hors de la plage de données de l'entrée, l'espace par pixel de la sortie est remonté au niveau suivant disponible, et NoData prend la valeur maximale dans la nouvelle plage de données. Par exemple, un jeu de données d'entier non signé 8 bits qui nécessite que la 256 valeur soit NoData est remonté à un jeu de données de 16 bits et la valeur maximale devient NoData. Si une valeur NoData se trouve dans la plage de données de l'entrée à écrire dans la sortie ou s'il n'y a pas de NoData, l'espace par pixel n'est pas remonté.

    Si une valeur NoData se trouve hors de la plage de données de l'entrée, l'espace par pixel est remonté au niveau suivant disponible, et la valeur Nodata est spécifiée par l'utilisateur. Par exemple, un jeu de données d'entier non signé 8 bits qui nécessite 256 comme valeur NoData est remonté à un jeu de données de 16 bits et la valeur 256 devient NoData. Si la valeur NoData spécifiée se trouve dans la plage de données de l'entrée, l'espace par pixel n'est pas remonté pour la sortie.

Scripting syntax

arcpy.env.nodata = "mapping_method"

Parameters

Explanation

nodata

The NoData mapping technique used: NoData. - Sélectionnez la méthode de mappage NoData à utiliser. NONE - Aucune règle de valeur NoData ne sera mise en place. Si votre entrée et votre sortie ont la même plage de valeurs, la valeur NoData est transférée sans changement. Toutefois, si votre plage de valeurs change, il n'y aura aucune valeur pour NoData dans votre sortie. Il s'agit de la méthode par défaut. MAXIMUM - La valeur maximale de la plage de données en sortie sera utilisée en tant que valeur NoData. MINIMUM - La valeur minimale de la plage de données en sortie sera utilisée en tant que valeur NoData. MAP_UP - La valeur la plus basse de la plage est remontée et la plus basse devient NoData. Si les données sont non signées, la valeur de zéro devient un, la valeur NoData est zéro, et le reste des valeurs reste identique. Si les données sont signées, la valeur la plus basse de la plage est remontée et la plus basse devient NoData. Par exemple, avec les données de nombre entier signé 8 bits, -127 devient -126 et la valeur NoData est -127. MAP_DOWN - La valeur NoData est la valeur maximale de la plage de données, la valeur la plus élevée de la plage de données devient une valeur de moins, et le reste des valeurs reste identique. Par exemple, avec des données d'entier non signé 8 bits, la valeur NoData est 255, la valeur 255 devient 254, et le reste des valeurs reste identique. PROMOTION - Si une valeur NoData se trouve hors de la plage de données de l'entrée, l'espace par pixel de la sortie est remonté au niveau suivant disponible, et NoData prend la valeur maximale dans la nouvelle plage de données. Par exemple, un jeu de données d'entier non signé 8 bits qui nécessite que la 256 valeur soit NoData est remonté à un jeu de données de 16 bits et la valeur maximale devient NoData. Si une valeur NoData se trouve dans la plage de données de l'entrée à écrire dans la sortie ou s'il n'y a pas de NoData, l'espace par pixel n'est pas remonté. Si une valeur NoData se trouve hors de la plage de données de l'entrée, l'espace par pixel est remonté au niveau suivant disponible, et la valeur Nodata est spécifiée par l'utilisateur. Par exemple, un jeu de données d'entier non signé 8 bits qui nécessite 256 comme valeur NoData est remonté à un jeu de données de 16 bits et la valeur 256 devient NoData. Si la valeur NoData spécifiée se trouve dans la plage de données de l'entrée, l'espace par pixel n'est pas remonté pour la sortie.

pyramid syntax

import arcpy

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