Arrondi supérieur (Image Analyst)

Disponible avec une licence Spatial Analyst.

Disponible avec une licence Image Analyst.

Synthèse

Renvoie la prochaine valeur entière supérieure, simplement représentée sous forme de valeur à virgule flottante, pour chaque cellule d’un raster.

Illustration

Illustration de l’outil Arrondi supérieur
OutRas = RoundUp(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 supérieure, mais sera représentée en tant que nombre à virgule flottante sans portion décimale. Par exemple :

       Input   Output
        5.3     6.0
        4.9     5.0
        3.0     3.0
        6.5     7.0
       -0.2     0.0
       -2.8    -2.0
  • Si l’entrée désigne un raster multi-canaux, la sortie sera un raster multi-canaux. L’outil exécute l’opération sur chaque canal de l’entrée.

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

Paramètres

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

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

Pour 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

ÉtiquetteExplicationType de données
Raster en sortie

Raster en sortie.

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

Raster

RoundUp(in_raster_or_constant)
NomExplicationType de données
in_raster_or_constant

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

Pour 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 supérieur les valeurs en entrée.

Raster

Exemple de code

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

Cet exemple arrondit les valeurs dans le raster en entrée à la prochaine valeur entière supérieure et génère un raster de type flottant.

import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/iapyexamples/data"
outRoundUp = RoundUp("gwhead")
outRoundUp.save("C:/iapyexamples/output/outru")
Exemple 2 d'utilisation de l'outil RoundUp (script autonome)

Cet exemple arrondit les valeurs dans le raster en entrée à la prochaine valeur entière supérieure et génère un raster de type flottant.

# Name: RoundUp_Ex_02.py
# Description: Returns the next higher whole number for each pixel
#              in a raster
# 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 RoundUp
outRoundURaster = RoundUp(inRaster)

# Save the output 
outRoundURaster.save("C:/iapyexamples/output/outroundup")

Informations de licence

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

Rubriques connexes