Arrondi inférieur (Spatial Analyst)
Récapitulatif
Renvoie la prochaine valeur entière inférieure, simplement représentée en tant que virgule flottante, pour chaque cellule d'un raster.
Illustration
 |
OutRas = RoundDown (InRas1) |
Utilisation
-
Les valeurs en entrée peuvent être positives ou négatives.
Le raster en sortie de cet outil est toujours un nombre à virgule flottante, quel que soit le type de valeur en entrée.
-
Si le nombre en entrée possède des valeurs à droite du séparateur décimal, la sortie se voit attribuer la prochaine valeur entière inférieure, mais sera représentée en tant que nombre à virgule flottante sans portion décimale. Par exemple :
Input Output 5.3 5.0 4.9 4.0 3.0 3.0 6.5 6.0 -0.2 -1.0 -2.8 -3.0 -
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.
Syntaxe
| Paramètre | Explication | Type de données |
in_raster_or_constant |
Valeurs en entrée à arrondir au nombre inférieur. 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 cellule sont obtenues en arrondissant au nombre inférieur les valeurs en entrée. | Raster |
Exemple de code
Cet exemple arrondit les valeurs dans le raster en entrée à la prochaine valeur entière inférieure et génère un raster de type flottant.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRoundDown = RoundDown("gwhead")
outRoundDown.save("C:/sapyexamples/output/outrd")
Cet exemple arrondit les valeurs dans le raster en entrée à la prochaine valeur entière inférieure et génère un raster de type flottant.
# Name: RoundDown_Ex_02.py
# Description: Returns the next lower whole number for each cell in a raster
# 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 RoundDown
outRoundDRaster = RoundDown(inRaster)
# Save the output
outRoundDRaster.save("C:/sapyexamples/output/outrounddown")