Целое (Spatial Analyst)

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

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

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

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

Преобразовывает значения ячеек растров в целочисленные путем округления.

Иллюстрация

Рисунок инструмента Целое
OutRas = Int (InRas1)

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

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

  • Если округление предпочтительнее, чем усечение, до выполнения операции прибавьте 0,5 к значениям входного растра.

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

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

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

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

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

  • Максимально поддерживаемый диапазон значений целочисленного растра составляет от 2,147,483,648 (минимальный размер, определенный по -231) до 2,147,483,647 (максимальный размер, определенный по 231 – 1). Если Int используется для растра с плавающей точкой с ячейками, имеющими значения, выходящие за пределы диапазона, в выходном растре таким ячейкам будет присвоено значение NoData.

  • Хранение категорийных (дискретных) данных в виде целочисленного растра требует значительно меньшего дискового пространства, чем хранение той же самой информации в виде растра из значений с плавающей точкой. По возможности, рекомендуется конвертировать растр с плавающей точкой в целочисленный растр с помощью этого инструмента.

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

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

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

Параметры

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

Входной растр, который будет конвертирован в целочисленный.

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

Raster Layer; Constant

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

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

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

Значениями ячеек являются входные значения, конвертированные в целочисленные путем усечения.

Raster

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

Входной растр, который будет конвертирован в целочисленный.

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

Raster Layer; Constant

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

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

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

Значениями ячеек являются входные значения, конвертированные в целочисленные путем усечения.

Raster

Пример кода

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

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

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

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

# Name: Int_Ex_02.py
# Description: Converts each cell value of a raster to an integer by truncation
# 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 Int
outInt = Int(inRaster)

# Save the output 
outInt.save("C:/sapyexamples/output/outint")

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

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

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