Coupe (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Disponible avec une licence 3D Analyst.

Synthèse

Permet de classer par tranches ou de reclasser la plage de valeurs des cellules en entrée en zones de même superficie, de même intervalle ou par seuils naturels.

Utilisation

• L'outil Tranche fonctionne mieux sur les données distribuées normalement. Si vous utilisez des données de raster en entrée désaxées, le résultat en sortie risque de ne pas contenir toutes les classes que vous attendiez ou que vous aviez spécifiées.

• Si vous utilisez la méthode Surface équivalente, il peut arriver que toutes les zones en sortie (classes) n'aient pas un nombre égal, ou même semblable, de cellules (par exemple, la surface). Cela peut provenir de la nature des valeurs en entrée et du nombre de zones spécifiées. Si les résultats ne vous conviennent pas, essayez d'utiliser un nombre inférieur de zones ou d'appliquer une transformation de statistiques (par exemple, logarithme ou racine carrée) au jeu de données en entrée.

• 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 en entrée	Raster en entrée à reclasser.	Raster Layer
Nombre de zones en sortie	Nombre de zones dans lequel reclasser le raster en entrée. Lorsque la méthode de classification par tranches est Surface équivalente, le raster en sortie contient le nombre de zones spécifié, et chacune d'elles contient un nombre identique de cellules. Lorsque Intervalle égal est utilisé, le raster en sortie contient le nombre de zones défini, et chacune d'elles contient des plages de valeurs égales. Lorsque Seuils naturels est utilisé, le raster en sortie comprend le nombre de zones défini, dont le nombre de cellules est déterminé par les bornes de classes.	Long
Méthode de classification par tranches (Facultatif)	Mode de classification par tranches des valeurs du raster en entrée. Intervalle égal—Détermine la plage des valeurs en entrée et la divise en un nombre de zones en sortie spécifié. Chaque zone du raster en sortie classé par tranches peut comprendre des valeurs de cellule en entrée présentant la même plage à partir des extrémités. Il s’agit de l’option par défaut. Surface équivalente—Indique que les valeurs en entrée sont divisées en un nombre spécifique de zones en sortie (chaque zone présentant un nombre de cellules identique). Chaque zone représente une quantité identique de surface. Seuils naturels—Indique que les classes sont fonction des regroupements naturels inhérents aux données. Les seuils sont identifiés en sélectionnant les bornes de classes qui regroupent le mieux des valeurs similaires et optimisent les différences entre les classes. Les valeurs de cellules sont réparties en classes dont les limites sont définies s'il existe de grands vides dans les valeurs de données.	String
Zone de base en sortie (Facultatif)	Définit la valeur de zone la plus basse du jeu de données raster en sortie. La valeur par défaut est 1.	Long

Valeur renvoyée

Étiquette	Explication	Type de données
Raster en sortie	Raster en sortie reclassé. La sortie est toujours un nombre entier.	Raster

Python

Slice(in_raster, number_zones, {slice_type}, {base_output_zone})

Nom	Explication	Type de données
in_raster	Raster en entrée à reclasser.	Raster Layer
number_zones	Nombre de zones dans lequel reclasser le raster en entrée. Lorsque la méthode de classification par tranches est Surface équivalente, le raster en sortie contient le nombre de zones spécifié, et chacune d'elles contient un nombre identique de cellules. Lorsque Intervalle égal est utilisé, le raster en sortie contient le nombre de zones défini, et chacune d'elles contient des plages de valeurs égales. Lorsque Seuils naturels est utilisé, le raster en sortie comprend le nombre de zones défini, dont le nombre de cellules est déterminé par les bornes de classes.	Long
slice_type (Facultatif)	Mode de classification par tranches des valeurs du raster en entrée. EQUAL_INTERVAL—Détermine la plage des valeurs en entrée et la divise en un nombre de zones en sortie spécifié. Chaque zone du raster en sortie classé par tranches peut comprendre des valeurs de cellule en entrée présentant la même plage à partir des extrémités. Il s’agit de l’option par défaut. EQUAL_AREA—Indique que les valeurs en entrée sont divisées en un nombre spécifique de zones en sortie (chaque zone présentant un nombre de cellules identique). Chaque zone représente une quantité identique de surface. NATURAL_BREAKS—Indique que les classes sont fonction des regroupements naturels inhérents aux données. Les seuils sont identifiés en sélectionnant les bornes de classes qui regroupent le mieux des valeurs similaires et optimisent les différences entre les classes. Les valeurs de cellules sont réparties en classes dont les limites sont définies s'il existe de grands vides dans les valeurs de données.	String
base_output_zone (Facultatif)	Définit la valeur de zone la plus basse du jeu de données raster en sortie. La valeur par défaut est 1.	Long

Valeur renvoyée

Nom	Explication	Type de données
out_raster	Raster en sortie reclassé. La sortie est toujours un nombre entier.	Raster

Exemple de code

1er exemple d'utilisation de l'outil Tranche (fenêtre Python)

Reclassification du raster en entrée en cinq classes selon des regroupements naturels inhérents aux données.

import arcpy
from arcpy import env  
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"

outslice = Slice("elevation", 5, "NATURAL_BREAKS") 
outslice.save("C:/sapyexamples/output/elev_slice")

2è exemple d'utilisation de l'outil Tranche (script autonome)

Reclassification du raster en entrée en dix classes selon des regroupements naturels inhérents aux données.

# Name: Slice_Ex_02.py
# Description: Slices a range of values of the input cells of a raster by
#    zones of equal interval or equal area.
# 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 = "elevation"
numberZones = 10
baseOutputZone = 5

# Execute Slice
outSlice = Slice(inRaster, numberZones, "NATURAL_BREAKS", baseOutputZone) 

# Save the output 
outSlice.save("C:/sapyexamples/output/outslice")

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 3D Analyst
• Standard: Nécessite Spatial Analyst ou 3D Analyst
• Advanced: Nécessite Spatial Analyst ou 3D Analyst