ArcMap

Arrondi inférieur

Disponible avec une licence Spatial Analyst.

Résumé

Renvoie la prochaine valeur entière inférieure, simplement représentée en tant que virgule flottante, pour chaque cellule d’un raster.

Illustration

Illustration de l'outil Arrondi inférieur
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.

  • Pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil, reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst.

Syntaxe

RoundDown(in_raster_or_constant)
ParamètreExplicationType 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

NomExplicationType 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

Exemple 1 d'utilisation de l'outil RoundDown (fenêtre Python)

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")
Exemple 2 d'utilisation de l'outil RoundDown (script autonome)

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")

Environnements

Informations de licence

  • Basic: Requiert Spatial Analyst
  • Standard: Requiert Spatial Analyst
  • Advanced: Requiert Spatial Analyst

Rubriques connexes