Entier (Spatial Analyst)
Récapitulatif
Convertit chaque valeur de cellule d’un raster en nombre entier, par troncature.
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.
-
Il y a une différence entre l'outil Entier et l'outil Arrondi inférieur. Par exemple, pour les deux valeurs suivantes Entier tronque toujours le nombre :
- 1,5 devient 1
- -1,5 devient -1
tandis que pour les deux mêmes valeurs, Arrondi inférieur renvoie :
- 1,5 devient 1,0
- -1,5 devient -2,0
Autre différence : Arrondi inférieur entraîne des valeurs à virgule flottante en sortie, tandis qu'Entier entraîne uniquement des valeurs d'entier en sortie.
-
Les valeurs de raster d'entiers ont une plage maximale comprise entre -2 147 483 648 (taille minimale déterminée par -231) et 2 147 483 647 (taille maximale déterminée par 231 – 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.
Syntaxe
| Paramètre | Explication | Type de données |
in_raster_or_constant |
Raster en entrée à convertir en entier. Si vous souhaitez utiliser un nombre en entrée pour ce paramètre, la taille de cellule et l'étendue doivent tout 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
Cet exemple convertit les valeurs en entrée en nombre entier par troncature.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outInt = Int("gwhead")
outInt.save("C:/sapyexamples/output/outint2")
Cet exemple convertit les valeurs en entrée en nombre entier par troncature.
# Name: Int_Ex_02.py
# Description: Converts each cell value of a raster to an integer by truncation
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inRaster = "gwhead"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Int
outInt = Int(inRaster)
# Save the output
outInt.save("C:/sapyexamples/output/outint")