Arrondi inférieur (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Disponible avec une licence Image Analyst.

Synthèse

Renvoie la prochaine valeur entière inférieure, simplement représentée sous forme de valeur à 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 existe 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

    Pour ces mêmes valeurs, Arrondi inférieur renvoie ce qui suit :

    • 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.

  • 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.

  • Si l’entrée correspond à des données raster multidimensionnelles, toutes les tranches de toutes les variables seront traitées. La sortie sera un raster multidimensionnel au format CRF.

  • 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.

Paramètres

ÉtiquetteExplicationType de données
Raster ou valeur constante en entrée

Valeurs en entrée à arrondir au nombre inférieur.

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

ÉtiquetteExplicationType de données
Raster en sortie

Raster en sortie.

Les valeurs de cellule sont obtenues en arrondissant au nombre inférieur les valeurs en entrée.

Raster

RoundDown(in_raster_or_constant)
NomExplicationType de données
in_raster_or_constant

Valeurs en entrée à arrondir au nombre inférieur.

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

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"

# Execute RoundDown
outRoundDRaster = RoundDown(inRaster)

# Save the output 
outRoundDRaster.save("C:/sapyexamples/output/outrounddown")

Informations de licence

  • Basic: Nécessite Spatial Analyst ou Image Analyst
  • Standard: Nécessite Spatial Analyst ou Image Analyst
  • Advanced: Nécessite Spatial Analyst ou Image Analyst

Rubriques connexes