Tranche (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 (classes). Les méthodes de classification de données disponibles sont l’intervalle égal, la surface équivalente (quantile), les seuils naturels, l'écart type (centré sur la moyenne), l’écart type (moyenne en tant que rupture), l’intervalle défini et l’intervalle géométrique.

Utilisation

  • Les options suivantes sont disponibles pour le paramètre Méthode de classification par tranches. Elles génèrent des zones en sortie avec des caractéristiques différentes.

    • Surface équivalente : le raster en sortie contient le nombre de zones défini, et chacune d’elles contient un nombre identique de cellules.
    • Intervalle égal : le raster en sortie contient le nombre de zones défini, et chacune d’elles contient des plages de valeurs égales.
    • Seuils naturels et Intervalle géométrique : le raster en sortie comprend le nombre de zones spécifié, dont le nombre de cellules est déterminé par les interruptions de classes.
    • Écart type (centré sur la moyenne), Écart type (moyenne comme seuil) et Intervalle défini : le raster en sortie comprend le nombre de zones déterminé par la valeur du paramètre Taille d’intervalle, dont le nombre de cellules est déterminé par les interruptions de classes.

  • Selon la méthode de classification par tranches spécifiée, vous devez indiquer la valeur du paramètre Nombre de zones en sortie ou Taille d’intervalle.

    • Le paramètre Nombre de zones en sortie est requis avec la méthode de classification par tranches Surface équivalente, Intervalle égal, Seuils naturels ou Intervalle géométrique.
    • Le paramètre Taille d’intervalle est requis avec la méthode de classification par tranches Intervalle défini, Écart type (centré sur la moyenne) ou Écart type (moyenne comme seuil).

  • Vous pouvez utiliser le paramètre Modifier NoData en valeur pour la sortie pour remplacer les valeurs NoData par une valeur entière dans la sortie. Si vous devez empêcher les cellules NoData de fusionner avec des zones en sortie, spécifiez une valeur entière qui se trouve hors de la plage attendue des zones en sortie. Par exemple, avec des zones en sortie comprises entre 1 et 5, spécifiez une valeur inférieure à 1 ou supérieure à 5. Les valeurs candidates sont notamment 0, 100 et -99. Pour fusionner les valeurs NoData dans une zone existante, utilisez la valeur entière de cette zone. Si ce paramètre n’est pas défini, les cellules NoData en entrée conservent une valeur NoData dans le raster en sortie.

  • 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

ÉtiquetteExplicationType de données
Raster en entrée

Raster en entrée à reclasser.

Raster Layer
Nombre de zones en sortie
(Facultatif)

Nombre de zones dans lequel le raster en entrée est classé.

Ce paramètre est requis lorsque la valeur du paramètre Méthode de classification par tranches est Surface équivalente, Intervalle égal, Seuils naturels ou Intervalle géométrique.

Lorsque la valeur du paramètre Méthode de classification par tranches est Intervalle défini, Écart type (centré sur la moyenne) ou Écart type (moyenne comme seuil), le paramètre Nombre de zones en sortie est inactif. Le nombre de zones en sortie est fonction de la valeur du paramètre Taille d’intervalle.

Long
Méthode de classification par tranches
(Facultatif)

Indique la façon dont le raster en entrée est classé en zones.

  • Intervalle égalLa plage des valeurs en entrée est divisée équitablement en un nombre spécifique de zones en sortie pour déterminer les interruptions de classes. Il s’agit de l’option par défaut.
  • Surface équivalenteLe nombre de cellules en entrée est divisé équitablement en un nombre spécifique de zones en sortie pour déterminer les interruptions de classes. Chaque zone comporte un nombre similaire de cellules, ce qui indique une quantité identique de surface.
  • Seuils naturelsLes interruptions de classes sont calculées de manière à réduire la variance dans les classes et à optimiser la variance entre les classes. Les interruptions sont généralement définies aux endroits où se trouvent de grandes différences dans les valeurs de données.
  • Écart type (centré sur la moyenne)Les interruptions de classes sont positionnées au-dessus et au-dessous de la valeur moyenne à une taille d’intervalle spécifiée (par exemple 2, 1 ou 0,5), dans l’unité de l’écart type jusqu’à atteindre les valeurs minimale et maximale du raster en entrée. La moyenne n’est pas utilisée comme interruption mais centrée par deux interruptions de classes. Une interruption se trouve à la moitié de la taille d’intervalle spécifiée au-dessus de la moyenne et l’autre à la moitié de la taille d’intervalle spécifiée au-dessous de la moyenne. L’écart type est calculé avec le dénominateur n-1, où n est le nombre de pixels avec une valeur.
  • Écart type (moyenne comme seuil)La valeur moyenne est utilisée comme interruption de classe. D’autres interruptions de classes sont positionnées au-dessus et au-dessous de la valeur moyenne à une taille d’intervalle spécifiée (par exemple 2, 1 ou 0,5), dans l’unité de l’écart type jusqu’à atteindre les valeurs minimale et maximale du raster en entrée. L’écart type est calculé avec le dénominateur n-1, où n est le nombre de pixels avec une valeur.
  • Intervalle définiLes interruptions de classes sont définies sur zéro et sur un multiple de la taille d’intervalle spécifiée par rapport à zéro. Elles sont ensuite découpées selon les valeurs minimale et maximale des données en entrée de la première et de la dernière classes. Pour une plage de valeurs contenant zéro, zéro est toujours inclus comme point d’interruption.
  • Intervalle géométriqueLes interruptions de classes sont créées en fonction des intervalles de classes ayant une série géométrique. Dans ce modèle, la valeur actuelle est égale à la valeur précédente divisée par un coefficient géométrique. Le coefficient géométrique de ce classificateur peut changer une fois (en son inverse) pour optimiser les plages de classe. L’algorithme crée ces intervalles géométriques en réduisant la somme de carrés du nombre d’éléments dans chaque classe. Cela garantit que chaque classe a approximativement le même nombre de valeurs et que le changement entre intervalles est cohérent.
String
Valeur de départ pour la sortie
(Facultatif)

Valeur de départ utilisée pour les zones (classes) sur le jeu de données raster en sortie.

Des valeurs entières sont attribuées aux classes, avec un incrément de 1 à partir de la valeur de départ.

La valeur de départ par défaut est 1.

Long
Modifier NoData en valeur pour la sortie
(Facultatif)

Remplacez la valeur NoData par une valeur dans la sortie.

Si ce paramètre n’est pas défini, les cellules NoData conservent une valeur NoData dans le raster en sortie.

Long
Taille d’intervalle
(Facultatif)

Taille de l’intervalle entre les classes.

Ce paramètre est requis lorsque le paramètre Méthode de classification par tranches est défini sur Intervalle défini, Écart type (centré sur la moyenne) ou Écart type (moyenne comme seuil).

Si Intervalle défini est utilisé, la taille d’intervalle indique la plage de valeurs réelle d’une classe servant à calculer les interruptions de classes.

Si Écart type (centré sur la moyenne) ou Écart type (moyenne comme seuil) est utilisé, la taille d’intervalle indique le nombre d’écarts types servant à calculer les interruptions de classes.

Double

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster en sortie

Raster en sortie reclassé.

La sortie est toujours un nombre entier.

La table attributaire du raster en sortie compte deux champs en plus des champs ObjectID, Value et Count standard. Le champ Value indique la valeur de classe. Les champs ZoneMin et ZoneMax consignent les valeurs minimale et maximale, respectivement, utilisées pour générer une classe.

Raster

Slice(in_raster, {number_zones}, {slice_type}, {base_output_zone}, {nodata_to_value}, {class_interval_size})
NomExplicationType de données
in_raster

Raster en entrée à reclasser.

Raster Layer
number_zones
(Facultatif)

Nombre de zones dans lequel le raster en entrée est classé.

Ce paramètre est requis lorsque la valeur du paramètre slice_type est EQUAL_AREA, EQUAL_INTERVAL, NATURAL_BREAKS ou GEOMETRIC_INTERVAL.

Lorsque la valeur du paramètre slice_type est STANDARD_DEVIATION_MEAN_CENTERED, STANDARD_DEVIATION_MEAN_BREAK ou DEFINED_INTERVAL, le paramètre number_zones n’est pas pris en charge. Le nombre de zones en sortie est fonction de la valeur du paramètre class_interval_size.

Long
slice_type
(Facultatif)

Indique la façon dont le raster en entrée est classé en zones.

  • EQUAL_INTERVALLa plage des valeurs en entrée est divisée équitablement en un nombre spécifique de zones en sortie pour déterminer les interruptions de classes. Il s’agit de l’option par défaut.
  • EQUAL_AREALe nombre de cellules en entrée est divisé équitablement en un nombre spécifique de zones en sortie pour déterminer les interruptions de classes. Chaque zone comporte un nombre similaire de cellules, ce qui indique une quantité identique de surface.
  • NATURAL_BREAKSLes interruptions de classes sont calculées de manière à réduire la variance dans les classes et à optimiser la variance entre les classes. Les interruptions sont généralement définies aux endroits où se trouvent de grandes différences dans les valeurs de données.
  • STANDARD_DEVIATION_MEAN_CENTEREDLes interruptions de classes sont positionnées au-dessus et au-dessous de la valeur moyenne à une taille d’intervalle spécifiée (par exemple 2, 1 ou 0,5), dans l’unité de l’écart type jusqu’à atteindre les valeurs minimale et maximale du raster en entrée. La moyenne n’est pas utilisée comme interruption mais centrée par deux interruptions de classes. Une interruption se trouve à la moitié de la taille d’intervalle spécifiée au-dessus de la moyenne et l’autre à la moitié de la taille d’intervalle spécifiée au-dessous de la moyenne. L’écart type est calculé avec le dénominateur n-1, où n est le nombre de pixels avec une valeur.
  • STANDARD_DEVIATION_MEAN_BREAKLa valeur moyenne est utilisée comme interruption de classe. D’autres interruptions de classes sont positionnées au-dessus et au-dessous de la valeur moyenne à une taille d’intervalle spécifiée (par exemple 2, 1 ou 0,5), dans l’unité de l’écart type jusqu’à atteindre les valeurs minimale et maximale du raster en entrée. L’écart type est calculé avec le dénominateur n-1, où n est le nombre de pixels avec une valeur.
  • DEFINED_INTERVALLes interruptions de classes sont définies sur zéro et sur un multiple de la taille d’intervalle spécifiée par rapport à zéro. Elles sont ensuite découpées selon les valeurs minimale et maximale des données en entrée de la première et de la dernière classes. Pour une plage de valeurs contenant zéro, zéro est toujours inclus comme point d’interruption.
  • GEOMETRIC_INTERVALLes interruptions de classes sont créées en fonction des intervalles de classes ayant une série géométrique. Dans ce modèle, la valeur actuelle est égale à la valeur précédente divisée par un coefficient géométrique. Le coefficient géométrique de ce classificateur peut changer une fois (en son inverse) pour optimiser les plages de classe. L’algorithme crée ces intervalles géométriques en réduisant la somme de carrés du nombre d’éléments dans chaque classe. Cela garantit que chaque classe a approximativement le même nombre de valeurs et que le changement entre intervalles est cohérent.
String
base_output_zone
(Facultatif)

Valeur de départ utilisée pour les zones (classes) sur le jeu de données raster en sortie.

Des valeurs entières sont attribuées aux classes, avec un incrément de 1 à partir de la valeur de départ.

La valeur de départ par défaut est 1.

Long
nodata_to_value
(Facultatif)

Remplacez la valeur NoData par une valeur dans la sortie.

Si ce paramètre n’est pas défini, les cellules NoData conservent une valeur NoData dans le raster en sortie.

Long
class_interval_size
(Facultatif)

Taille de l’intervalle entre les classes.

Ce paramètre est requis lorsque le paramètre slice_type est défini sur DEFINED_INTERVAL, STANDARD_DEVIATION_MEAN_CENTERED ou STANDARD_DEVIATION_MEAN_BREAK.

Si DEFINED_INTERVAL est utilisé, la taille d’intervalle indique la plage de valeurs réelle d’une classe servant à calculer les interruptions de classes.

Si STANDARD_DEVIATION_MEAN_CENTERED ou STANDARD_DEVIATION_MEAN_BREAK est utilisé, la taille d’intervalle indique le nombre d’écarts types servant à calculer les interruptions de classes.

Double

Valeur renvoyée

NomExplicationType de données
out_raster

Raster en sortie reclassé.

La sortie est toujours un nombre entier.

La table attributaire du raster en sortie compte deux champs en plus des champs ObjectID, Value et Count standard. Le champ Value indique la valeur de classe. Les champs ZoneMin et ZoneMax consignent les valeurs minimale et maximale, respectivement, utilisées pour générer une classe.

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.tif")
Exemple 2 d’utilisation de l’outil Tranche (fenêtre Python)

Reclassification du raster en entrée avec un intervalle défini égal à 10.

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

outslice = Slice("elevation", "", "DEFINED_INTERVAL", "", "", 10)
outslice.save("C:/sapyexamples/output/elev_slice_02.tif")
Exemple 3 d’utilisation de l’outil Tranche (script autonome)

Reclassification du raster en entrée en 10 classes selon des regroupements naturels inhérents aux données et définition de la valeur de départ pour les classes en sortie sur -5.

# Name: Slice_Ex_03.py
# Description: Slices the input raster into 10 zones(classes) based on natural groupings inherent in the data.
#              Specify the starting value for output classes to be -5.
# Requirements: Spatial Analyst Extension

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

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

# 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/elev_slice_03.tif")
Exemple 4 d’utilisation de l’outil Tranche (script autonome)

Reclassification du raster en entrée en 10 classes de surface équivalente. Attribution de la valeur -99 aux cellules NoData dans la sortie.

# Name: Slice_Ex_04.py
# Description: Slices the input raster into 10 zones(classes) based on equal area.
#              Assign NoData cells to have a value of -99 in the output.
# Requirements: Spatial Analyst Extension

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

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

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

# Set local variables
inRaster = "elevation"
numberZones = 10
baseOutputZone = 5
nodataToValue = -99
classIntervalSize = "" # or None

# Execute Slice
outSlice = Slice(inRaster, numberZones, "EQUAL_AREA", baseOutputZone, nodataToValue, classIntervalSize)

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

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

Rubriques connexes