Opposé (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Disponible avec une licence Image Analyst.

Synthèse

Change le signe (multiplie par -1) des valeurs de cellules du raster en entrée, cellule par cellule.

Illustration

OutRas = Negate(InRas1)

Utilisation

• Si l'entrée est un nombre entier, le raster en sortie est un nombre entier. Si l'entrée est un nombre à virgule flottante, le raster en sortie est un nombre à virgule flottante.

• Si l’entrée est un raster multicanal, la sortie sera également un raster multicanal. L’outil réalisera l’opération sur chaque canal en entrée.

• En algèbre spatiale, l'opérateur équivalent a le symbole "-" (lien).

• Dans ArcPy, si l’entrée est un raster multidimensionnel, toutes les tranches de toutes les variables sont traitées et la sortie est un raster multidimensionnel.

• Pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil, reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Raster ou valeur constante en entrée	Raster en entrée dont l'opposé est calculé (multiplication par -1). Pour utiliser un nombre en entrée pour ce paramètre, la taille de cellule et l’étendue doivent d’abord être définies dans l’environnement.	Raster Layer; Constant

Valeur renvoyée

Étiquette	Explication	Type de données
Raster en sortie	Raster en sortie. Les valeurs d'une cellule sont les valeurs en entrée dont l'opposé est calculé (multiplication par -1).	Raster

Python

Negate(in_raster_or_constant)

Nom	Explication	Type de données
in_raster_or_constant	Raster en entrée dont l'opposé est calculé (multiplication par -1). Pour utiliser un nombre en entrée pour ce paramètre, la taille de cellule et l’étendue doivent d’abord être définies dans l’environnement.	Raster Layer; Constant

Valeur renvoyée

Nom	Explication	Type de données
out_raster	Raster en sortie. Les valeurs d'une cellule sont les valeurs en entrée dont l'opposé est calculé (multiplication par -1).	Raster

Exemple de code

Exemple 1 de l'utilisation de l'outil Opposé (fenêtre Python)

Cet exemple change le signe des valeurs du raster en entrée et génère un raster Grid.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outNegate = Negate("degs")
outNegate.save("C:/sapyexamples/output/outneg")

Exemple 2 de l'utilisation de l'outil Opposé (script autonome)

Cet exemple change le signe des valeurs du raster en entrée et génère un raster Grid.

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

Environnements

Validation automatique, Taille de cellule, Méthode de projection de la taille de cellule, Compression, Espace de travail courant, Étendue, Transformations géographiques, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Espace de travail temporaire, Raster de capture, Taille de tuile

Cas particuliers

Informations de licence

• Basic: Nécessite Spatial Analyst ou Image Analyst
• Standard: Nécessite Spatial Analyst ou Image Analyst
• Advanced: Nécessite Spatial Analyst ou Image Analyst