Negate (Spatial Analyst)

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.

  • In Map Algebra, the equivalent operator symbol for this tool is "-" (link).

  • If the input is multidimensional raster data, all slices from all variables will be processed. The output will be a multidimensional raster in CRF format.

  • See Analysis environments and Spatial Analyst for additional details on the geoprocessing environments that apply to this tool.

Parameters

LabelExplanationData Type
Input raster or constant value

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

LabelExplanationData Type
Output raster

The output raster.

The cell values are the input values negated (multiplied by -1).

Raster

Negate(in_raster_or_constant)
NameExplanationData 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.sa import *
env.workspace = "C:/sapyexamples/data"
outNegate = Negate("degs")
outNegate.save("C:/sapyexamples/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 cell-by-cell basis 
# 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 = "degs"

# Execute Negate
outNegate = Negate(inRaster)

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

Licensing information

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

Related topics