Redondeo hacia abajo (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con licencia de Image Analyst.

Resumen

Devuelve el valor entero inmediatamente más bajo, representado como un punto flotante, con cada celda de 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, independientemente del 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

  Para los mismos dos valores, Redondeo hacia abajo devuelve lo siguiente:

  • 1,5 se convierte en 1,0
  • -1,5 se convierte en -2,0

  Otra diferencia es que Redondeo hacia abajo devuelve valores de punto flotante, mientras que Ent sólo devuelve valores enteros.

• Si la entrada es un ráster multibanda, la salida será un ráster multibanda. La herramienta realiza la operación con cada banda de la entrada.

• Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.

Sintaxis

RoundDown(in_raster_or_constant)

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

Muestra de código

Ejemplo 1 de RoundDown (ventana de Python)

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

Ejemplo 2 de RoundDown (script independiente)

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"

# Execute RoundDown
outRoundDRaster = RoundDown(inRaster)

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

Entornos

Auto ejecución, Tamaño de celda, Método de proyección de tamaño de celda, Espacio de trabajo actual, Extensión, Transformaciones geográficas, Máscara, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Espacio de trabajo temporal, Ráster de alineación, Tamaño de tesela

Información de licenciamiento

• Basic: Requiere Spatial Analyst o Image Analyst
• Standard: Requiere Spatial Analyst o Image Analyst
• Advanced: Requiere Spatial Analyst o Image Analyst