Redondeo hacia abajo (Spatial Analyst)
Resumen
Devuelve el valor entero inferior siguiente, representado como un número de punto flotante, para cada celda en un ráster.
Ilustración
 |
OutRas = RoundDown(InRas1) |
Uso
-
Los valores de entrada pueden ser positivos o negativos.
El ráster de salida de esta herramienta siempre es de tipo punto flotante, sin importar el tipo del valor de entrada.
-
Si el número de entrada tiene valores a la derecha del punto decimal, la salida se asignará al valor entero inmediatamente inferior, pero se representará como un número de punto flotante sin parte decimal. Por ejemplo:
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 -
Existe una diferencia entre la herramienta Ent y la herramienta Redondeo. Por ejemplo, dados los dos valores siguientes Ent siempre trunca el número:
- 1,5 se convierte en 1
- -1,5 se convierte en -1
mientras que para los mismos dos valores, Redondeo devuelve:
- 1,5 se convierte en 1,0
- -1,5 se convierte en -2,0
Otra diferencia es que Redondeo devuelve valores de punto flotante, mientras que Ent sólo devuelve valores enteros.
Sintaxis
| Parámetro | Explicación | Tipo de datos |
in_raster_or_constant |
Los valores de entrada que se redondearán hacia abajo. Para utilizar un número como entrada de este parámetro, previamente se debe establecer en el entorno el tamaño de la celda y la extensión. | Raster Layer | Constant |
Valor de retorno
| Nombre | Explicación | Tipo de datos |
| out_raster |
El ráster de salida. Los valores de celda son el resultado de redondear hacia abajo los valores de entrada. | Raster |
Ejemplo de código
En este ejemplo se redondean los valores en el ráster de entrada al valor entero inferior siguiente y se devuelve un ráster de punto flotante.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRoundDown = RoundDown("gwhead")
outRoundDown.save("C:/sapyexamples/output/outrd")
En este ejemplo se redondean los valores en el ráster de entrada al valor entero inferior siguiente y se devuelve un ráster de punto flotante.
# 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")