Int (Image Analyst)

Available with Spatial Analyst license.

Available with Image Analyst license.

Available with 3D Analyst license.

Summary

Converts each cell value of a raster to an integer by truncation.

Illustration

Int illustration
OutRas = Int (InRas1)

Usage

  • The input values can be either positive or negative.

  • If rounding is preferred to truncating, add a 0.5 input raster prior to performing the operation.

  • The maximum supported range of integer raster values is -2,147,483,648 (minimum size determined by -231) to 2,147,483,647 (maximum size determined by 231 – 1). If Int is used on a floating-point raster which has cells with values outside this range, those cells will be NoData in the output raster.

  • Storing categorical (discrete) data as an integer raster will use significantly less disk space than the same information stored as a floating-point raster. Whenever possible, it is recommended to convert floating-point rasters to integer with this tool.

  • If the input is a multiband raster, the output will be a multiband raster. The tool will perform the operation on each band in the input.

  • In ArcPy, if the input is a multidimensional raster, all slices from all variables will be processed, and the output will be a multidimensional raster.

Parameters

LabelExplanationData Type
Input raster or constant value

The input raster to be converted to integer.

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

LabelExplanationData Type
Output raster

The output raster.

The cell values are the input values converted to integers by truncation.

Raster

Int(in_raster_or_constant)
NameExplanationData Type
in_raster_or_constant

The input raster to be converted to integer.

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

NameExplanationData Type
out_raster

The output raster.

The cell values are the input values converted to integers by truncation.

Raster

Code sample

Int example 1 (Python window)

This example converts the input values to integer by truncation.

import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/iapyexamples/data"
outInt = Int("gwhead")
outInt.save("C:/iapyexamples/output/outint2")
Int example 2 (stand-alone script)

This example converts the input values to integer by truncation.

# Name: Int_Ex_02.py
# Description: Converts each pixel value of a raster to an integer by truncation
# Requirements: Image Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *

# Set environment settings
env.workspace = "C:/iapyexamples/data"

# Set local variables
inRaster = "gwhead"

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

# Execute Int
outInt = Int(inRaster)

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

Licensing information

  • Basic: Requires Image Analyst or Spatial Analyst or 3D Analyst
  • Standard: Requires Image Analyst or Spatial Analyst or 3D Analyst
  • Advanced: Requires Image Analyst or Spatial Analyst or 3D Analyst

Related topics