Entier (Image Analyst)

Disponible avec une licence Spatial Analyst.

Disponible avec une licence Image Analyst.

Disponible avec une licence 3D Analyst.

Synthèse

Convertit chaque valeur de cellule d'un raster en nombre entier, par tronquage.

Illustration

OutRas = Int (InRas1)

Utilisation

• Les valeurs en entrée peuvent être positives ou négatives.

• Si vous préférez un arrondi à la troncature, ajoutez un raster en entrée de 0,5 avant d'exécuter l'opération.

• Les valeurs de raster d’entiers ont une plage maximale comprise entre -2 147 483 648 (taille minimale déterminée par -2³¹) et 2 147 483 647 (taille maximale déterminée par 2³¹ – 1). Si l'outil Entier est utilisé sur un raster de virgule flottante dont certaines cellules présentent des valeurs en dehors de cette plage, ces cellules sont définies sur NoData dans le raster en sortie.

• Le stockage de données catégoriques (discrètes) en tant que raster d'entiers utilise beaucoup moins d'espace sur le disque que les mêmes informations stockées en tant que raster de virgule flottante. Il est recommandé de convertir les rasters de virgule flottante en rasters d'entiers à l'aide de cet outil chaque fois que cela est possible.

• Si l’entrée est un raster multicanal, la sortie sera également un raster multicanal. L’outil réalisera l’opération sur chaque canal en entrée.

• Dans ArcPy, si l’entrée est un raster multidimensionnel, toutes les tranches de toutes les variables sont traitées et la sortie est un raster multidimensionnel.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Raster ou valeur constante en entrée	Raster en entrée à convertir en entier. Pour utiliser un nombre en entrée pour ce paramètre, la taille de cellule et l’étendue doivent d’abord être définies dans l’environnement.	Raster Layer; Constant

Valeur renvoyée

Étiquette	Explication	Type de données
Raster en sortie	Raster en sortie. Les valeurs de cellules correspondent aux valeurs en entrée converties en nombres entiers par troncature.	Raster

Python

Int(in_raster_or_constant)

Nom	Explication	Type de données
in_raster_or_constant	Raster en entrée à convertir en entier. Pour utiliser un nombre en entrée pour ce paramètre, la taille de cellule et l’étendue doivent d’abord être définies dans l’environnement.	Raster Layer; Constant

Valeur renvoyée

Nom	Explication	Type de données
out_raster	Raster en sortie. Les valeurs de cellules correspondent aux valeurs en entrée converties en nombres entiers par troncature.	Raster

Exemple de code

1er exemple d'utilisation de l'outil Entier (fenêtre Python)

Cet exemple convertit les valeurs en entrée en nombre entier par troncature.

import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/iapyexamples/data"
outInt = Int("gwhead")
outInt.save("C:/iapyexamples/output/outint2")

2e exemple d'utilisation de l'outil Entier (script autonome)

Cet exemple convertit les valeurs en entrée en nombre entier par troncature.

# Name: Int_Ex_02.py
# Description: Converts each pixel value of a raster to an integer by truncation
# Requirements: Image Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *

# Set environment settings
env.workspace = "C:/iapyexamples/data"

# Set local variables
inRaster = "gwhead"

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

# Execute Int
outInt = Int(inRaster)

# Save the output 
outInt.save("C:/iapyexamples/output/outint")

Environnements

Validation automatique, Taille de cellule, Méthode de projection de la taille de cellule, Compression, Espace de travail courant, Étendue, Transformations géographiques, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Espace de travail temporaire, Raster de capture, Taille de tuile

Cas particuliers

Informations de licence

• Basic: Nécessite Image Analyst or Spatial Analyst or 3D Analyst
• Standard: Nécessite Image Analyst or Spatial Analyst or 3D Analyst
• Advanced: Nécessite Image Analyst or Spatial Analyst or 3D Analyst