Округлить в меньшую сторону (Spatial Analyst)

Доступно с лицензией Spatial Analyst.

Доступно с лицензией Image Analyst.

Краткая информация

Возвращает ближайшее меньшее целое значение, только представленное как значение с плавающей точкой, для каждой ячейки растра.

Иллюстрация

Рисунок инструмента Округлить в меньшую сторону
OutRas = RoundDown(InRas1)

Использование

  • Входные значения могут быть положительные или отрицательные.

  • Выходной растр этого инструмента всегда имеет тип с плавающей точкой, независимо от типа входных значений.

  • Если входное число имеет знаки справа после запятой, выходным данным присваивается следующее меньшее целочисленное значение, но оно будет представлено значением с плавающей точкой без знаков после запятой. Например:

        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
  • Существует различие между инструментами Целое (Int) и Округлить в меньшую сторону (Round Down). Например, с учетом следующих двух значений Int всегда округляет число:

    • 1,5 станет 1
    • -1,5 станет -1

    Для тех же двух значений инструмент Округлить в меньшую сторону выдает:

    • 1,5 станет 1.0
    • -1,5 станет -2.0

    Другое различие в том, что инструмент Округлить в меньшую сторону выдает значения с плавающей точкой, в то время как инструмент Int выдает только целые числа.

  • Если входной растр многоканальный, выходной растр также будет многоканальным. Инструмент будет выполнять операцию для каждого канала входного растра.

  • В ArcPy если входным набором данных является многомерный растр, то будут обработаны все срезы от всех переменных, а результатом будет многоканальный растр.

  • См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

ПодписьОписаниеТип данных
Входной растр или постоянное значение

Входные значения, которые будут округлены в меньшую сторону.

Чтобы использовать число в качестве входных данных для этого параметра, необходимо сперва указать экстент и размер ячейки в параметрах среды.

Raster Layer; Constant

Возвращаемое значение

ПодписьОписаниеТип данных
Выходной растр

Выходной растр.

Значениями ячеек является результат округления входных значений в меньшую сторону.

Raster

RoundDown(in_raster_or_constant)
ИмяОписаниеТип данных
in_raster_or_constant

Входные значения, которые будут округлены в меньшую сторону.

Чтобы использовать число в качестве входных данных для этого параметра, необходимо сперва указать экстент и размер ячейки в параметрах среды.

Raster Layer; Constant

Возвращаемое значение

ИмяОписаниеТип данных
out_raster

Выходной растр.

Значениями ячеек является результат округления входных значений в меньшую сторону.

Raster

Пример кода

RoundDown, пример 1 (окно Python)

В этом примере значения входного растра округляются до следующего меньшего целого числа и выводится растр с плавающей точкой.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRoundDown = RoundDown("gwhead")
outRoundDown.save("C:/sapyexamples/output/outrd")
RoundDown, пример 2 (автономный скрипт)

В этом примере значения входного растра округляются до следующего меньшего целого числа и выводится растр с плавающей точкой.

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

Информация о лицензиях

  • Basic: Обязательно Spatial Analyst или Image Analyst
  • Standard: Обязательно Spatial Analyst или Image Analyst
  • Advanced: Обязательно Spatial Analyst или Image Analyst

Связанные разделы