Negate (Image Analyst)

This ArcGIS 2.7 documentation has been archived and is no longer updated. Content and links may be outdated. See the latest documentation.

Available with Spatial Analyst license.

Available with Image Analyst license.

Summary

Changes the sign (multiplies by -1) of the cell values of the input raster on a cell-by-cell basis.

Illustration

Negate illustration
OutRas = Negate(InRas1)

Usage

  • If the input is integer, the output raster will be integer type. If the input is floating point, the output raster will be floating point.

  • 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.

Syntax

Negate(in_raster_or_constant)
ParameterExplanationData Type
in_raster_or_constant

The input raster to be negated (multiplied by -1).

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 negated (multiplied by -1).

Raster

Code sample

Negate example 1 (Python window)

This example changes the sign of the values in the input raster and outputs a Grid raster.

import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/iapyexamples/data"
outNegate = Negate("degs")
outNegate.save("C:/iapyexamples/output/outneg")
Negate example 2 (stand-alone script)

This example changes the sign of the values in the input raster and outputs a Grid raster.

# Name: Negate_Ex_02.py
# Description: Changes the sign (multiplies by -1) of the cell values
#              of the input raster on a pixel-by-pixel basis 
# 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 = "degs"

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

# Execute Negate
outNegate = Negate(inRaster)

# Save the output 
outNegate.save("C:/iapyexamples/output/outnegate")

Licensing information

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

Related topics