Round Up (Spatial Analyst)
Summary
Returns the next higher whole number for each cell in a raster.
Illustration
 |
OutRas = RoundUp(InRas1) |
Usage
-
Input values can be positive or negative.
The output raster from this tool is always floating point type, regardless of the input value type.
-
If a number has any values to the right of the decimal point, the output will be assigned the next highest whole value. For example:
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
Syntax
| Parameter | Explanation | Data Type |
in_raster_or_constant |
The input values to be rounded up. In order to use a number as an input for this parameter, the cell size and extent must first be set in the environment. | Raster Layer | Constant |
Return Value
| Name | Explanation | Data Type |
| out_raster |
The output raster. The cell values are the input values converted to integers by rounding up to the next higher whole number. | Raster |
Code Sample
This example rounds the values in the input raster to the next higher whole number.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRoundUp = RoundUp("gwhead")
outRoundUp.save("C:/sapyexamples/output/outru")
This example rounds the values in the input raster to the next higher whole number.
# Name: RoundUp_Ex_02.py
# Description: Returns the next higher 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 RoundUp
outRoundURaster = RoundUp(inRaster)
# Save the output
outRoundURaster.save("C:/sapyexamples/output/outroundup")