Tranche (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 Slice method (Méthode de classification par tranches). Elles génèrent des zones en sortie ayant des caractéristiques différentes.

    • Equal area (Surface égale) : le raster en sortie contient le nombre de zones défini, et chacune d’elles contient un nombre identique de cellules.
    • Equal interval (Intervalle égal) : le raster en sortie contient le nombre de zones défini, et chacune d’elles contient des plages de valeurs égales.
    • Natural breaks (Seuils naturels) et Geometric interval (Intervalle géométrique) : le raster en sortie comprend le nombre de zones spécifié, le nombre de cellules dans chacune d’elles étant déterminé par les interruptions de classes.
    • Standard deviation (mean-centered) (Écart type (centré sur la moyenne)), Standard deviation (mean as a break) (Écart type (moyenne en tant que rupture)) et Defined interval (Intervalle défini) : le raster en sortie contient le nombre de zones déterminé par la valeur du paramètre Interval size (Taille d’intervalle), le nombre de cellules dans chacune d’elles étant déterminé par les interruptions de classes.

  • Selon la méthode de classification par tranches spécifiée, la valeur du paramètre Number of output zones (Nombre de zones en sortie) ou Interval size (Taille d’intervalle) doit être spécifiée.

    • Le paramètre Number of output zones (Nombre de zones en sortie) est obligatoire lors de l’utilisation de la méthode de classification par tranches Equal area (Surface égale), Equal interval (Intervalle égal), Natural breaks (Seuils naturels) ou Geometric interval (Intervalle géométrique).
    • Le paramètre Interval size (Taille d’intervalle) est obligatoire lors de l’utilisation de la méthode de classification par tranches Defined interval (Intervalle défini), Standard deviation (mean-centered) (Écart type (centré sur la moyenne)) ou Standard deviation (mean as a break) (Écart type (moyenne en tant que rupture)).

  • Vous pouvez utiliser le paramètre Change NoData to value for output (Transformer NoData en valeur pour la sortie) pour remplacer les valeurs NoData par une valeur entière dans la sortie. Si les cellules NoData ne doivent pas être combinées avec des zones en sortie, spécifiez une valeur entière située en dehors de la plage attendue des zones en sortie. Par exemple, avec des zones en sortie comprises entre 1 et 5, indiquez une valeur inférieure à 1 ou supérieure à 5. Les valeurs candidates sont notamment 0, 100 et -99. Pour combiner des valeurs NoData en 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 conserveront la valeur NoData dans le raster en sortie.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Raster en entrée à reclasser.

Raster Layer
Raster en sortie

Raster en sortie reclassé.

La sortie est toujours un nombre entier.

La table attributaire du raster en sortie comporte deux nouveaux champs, outre les champs standard ObjectID, Value et Count. Le champ Value indique la valeur de classe. Les champs ZoneMin et ZoneMax contiennent respectivement les valeurs minimale et maximale, qui sont utilisées pour la génération d’une classe.

Raster Dataset
Nombre de zones en sortie
(Facultatif)

Nombre de zones dans lesquelles le raster en entrée sera reclassé.

Ce paramètre est obligatoire lorsque la valeur du paramètre Slice method (Méthode de classification par tranches) est Equal area (Surface égale), Equal interval (Intervalle égal), Natural breaks (Seuils naturels) ou Geometric interval (Intervalle géométrique).

Lorsque la valeur du paramètre Slice method (Méthode de classification par tranches) est Defined interval (Intervalle défini), Standard deviation (mean-centered) (Écart type (centré sur la moyenne)) ou Standard deviation (mean as a break) (Écart type (moyenne en tant que rupture)), le paramètre Number of output zones (Nombre de zones en sortie) est inactif. Le nombre de zones en sortie est déterminé par la valeur du paramètre Interval size (Taille d’intervalle).

Long
Méthode de classification par tranches
(Facultatif)

Spécifie la façon dont le raster en entrée sera reclassé en zones.

  • Intervalle égalLa plage des valeurs en entrée est divisée de manière équitable 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é de manière équitable en un nombre spécifique de zones en sortie pour déterminer les interruptions de classes. Chaque zone contient un nombre similaire de cellules, qui représente une quantité identique de surface.
  • Seuils naturelsLes interruptions de classes sont déterminées de sorte à réduire la variance au sein des classes et à l’augmenter entre les classes. Les interruptions sont généralement définies en cas de modifications relativement importantes des valeurs de données.
  • Écart type (centré sur la moyenne)Les interruptions de classes sont placées au-dessus et au-dessous de la valeur moyenne à une taille d’intervalle spécifique, comme 2, 1 ou 0,5, dans l’unité d’écart type, jusqu’à atteindre les valeurs minimale et maximale du raster en entrée. La moyenne n’est pas utilisée comme borne, mais centrée par deux interruptions de classes. Une borne se situe à la moitié de la taille d’intervalle spécifiée au-dessus de la moyenne et l’autre se trouve à 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.
  • Écart type (moyenne en tant que rupture)La valeur moyenne est utilisée comme interruption de classe. Les autres interruptions de classes sont placées au-dessus et au-dessous de la valeur moyenne à une taille d’intervalle spécifique, comme 2, 1 ou 0,5, dans l’unité d’é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.
  • Intervalle définiLes interruptions de classes sont définies sur zéro et un multiple de la taille d’intervalle spécifiée par rapport à zéro. Elles sont ensuite découpées sur les valeurs minimale et maximale des données en entrée pour les première et dernière classes. Pour une plage de valeurs comprenant zéro, zéro est toujours inclus comme point de rupture.
  • Intervalle géométriqueLes interruptions de classes sont créées en fonction des intervalles de classe ayant une série géométrique. Il s’agit d’un modèle dans lequel 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 permet de garantir que chaque classe a approximativement le même nombre de valeurs et que le changement entre intervalles est cohérent.
String
Valeur de début pour la sortie
(Facultatif)

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

Des valeurs entières, incrémentées de 1 à partir de la valeur de début, sont affectées aux classes.

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

Long
Transformer NoData en valeur pour la sortie
(Facultatif)

Remplacez NoData par une valeur dans la sortie.

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

Long
Taille d’intervalle
(Facultatif)

Taille de l’intervalle entre les classes.

Ce paramètre est obligatoire lorsque le paramètre Slice method (Méthode de classification par tranches) est défini sur Defined interval (Intervalle défini), Standard deviation (mean-centered) (Écart type (centré sur la moyenne)) ou Standard deviation (mean as a break) (Écart type (moyenne en tant que rupture)).

Si Defined interval (Intervalle défini) est utilisé, la taille d’intervalle indique la plage de valeurs réelle d’une classe utilisée pour calculer les interruptions de classes.

Si Standard deviation (mean-centered) (Écart type (centré sur la moyenne)) ou Standard deviation (mean as a break) (Écart type (moyenne en tant que rupture)) est utilisé, la taille d’intervalle indique le nombre d’écarts types utilisés pour 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 comporte deux nouveaux champs, outre les champs standard ObjectID, Value et Count. Le champ Value indique la valeur de classe. Les champs ZoneMin et ZoneMax contiennent respectivement les valeurs minimale et maximale, qui sont utilisées pour la génération d’une classe.

Raster

arcpy.ddd.Slice(in_raster, out_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
out_raster

Raster en sortie reclassé.

La sortie est toujours un nombre entier.

La table attributaire du raster en sortie comporte deux nouveaux champs, outre les champs standard ObjectID, Value et Count. Le champ Value indique la valeur de classe. Les champs ZoneMin et ZoneMax contiennent respectivement les valeurs minimale et maximale, qui sont utilisées pour la génération d’une classe.

Raster Dataset
number_zones
(Facultatif)

Nombre de zones dans lesquelles le raster en entrée sera reclassé.

Ce paramètre est obligatoire 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 déterminé par la valeur du paramètre class_interval_size.

Long
slice_type
(Facultatif)

Spécifie la façon dont le raster en entrée sera reclassé en zones.

  • EQUAL_INTERVALLa plage des valeurs en entrée est divisée de manière équitable 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é de manière équitable en un nombre spécifique de zones en sortie pour déterminer les interruptions de classes. Chaque zone contient un nombre similaire de cellules, qui représente une quantité identique de surface.
  • NATURAL_BREAKSLes interruptions de classes sont déterminées de sorte à réduire la variance au sein des classes et à l’augmenter entre les classes. Les interruptions sont généralement définies en cas de modifications relativement importantes des valeurs de données.
  • STANDARD_DEVIATION_MEAN_CENTEREDLes interruptions de classes sont placées au-dessus et au-dessous de la valeur moyenne à une taille d’intervalle spécifique, comme 2, 1 ou 0,5, dans l’unité d’écart type, jusqu’à atteindre les valeurs minimale et maximale du raster en entrée. La moyenne n’est pas utilisée comme borne, mais centrée par deux interruptions de classes. Une borne se situe à la moitié de la taille d’intervalle spécifiée au-dessus de la moyenne et l’autre se trouve à 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.
  • STANDARD_DEVIATION_MEAN_BREAKLa valeur moyenne est utilisée comme interruption de classe. Les autres interruptions de classes sont placées au-dessus et au-dessous de la valeur moyenne à une taille d’intervalle spécifique, comme 2, 1 ou 0,5, dans l’unité d’é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.
  • DEFINED_INTERVALLes interruptions de classes sont définies sur zéro et un multiple de la taille d’intervalle spécifiée par rapport à zéro. Elles sont ensuite découpées sur les valeurs minimale et maximale des données en entrée pour les première et dernière classes. Pour une plage de valeurs comprenant zéro, zéro est toujours inclus comme point de rupture.
  • GEOMETRIC_INTERVALLes interruptions de classes sont créées en fonction des intervalles de classe ayant une série géométrique. Il s’agit d’un modèle dans lequel 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 permet de garantir 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ébut qui est utilisée pour les zones (classes) sur le jeu de données raster en sortie.

Des valeurs entières, incrémentées de 1 à partir de la valeur de début, sont affectées aux classes.

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

Long
nodata_to_value
(Facultatif)

Remplacez NoData par une valeur dans la sortie.

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

Long
class_interval_size
(Facultatif)

Taille de l’intervalle entre les classes.

Ce paramètre est obligatoire si 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 utilisée pour 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 utilisés pour 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 comporte deux nouveaux champs, outre les champs standard ObjectID, Value et Count. Le champ Value indique la valeur de classe. Les champs ZoneMin et ZoneMax contiennent respectivement les valeurs minimale et maximale, qui sont utilisées pour la génération d’une classe.

Raster

Exemple de code

Exemple 1 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 sur 10.

# 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")
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ébut 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 égale. Affectation 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")
Exemple 1 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
env.workspace = "C:/data"
arcpy.ddd.Slice("elevation", "c:/output/elev_slice.tif", 5, "NATURAL_BREAKS")
Exemple 2 d’utilisation de l’outil Tranche (fenêtre Python)

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

# Name: Slice_3d_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: 3D Analyst Extension

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
inRaster = "elevation"
outRaster = "C:/output/outslice"
numberZones = 10
baseOutputZone = 5

# Execute Slice
arcpy.ddd.Slice(inRaster, outRaster, numberZones, "NATURAL_BREAKS", 
               baseOutputZone)
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ébut pour les classes en sortie sur -5.

# Name: Slice_3d_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: 3D Analyst Extension

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
inRaster = "elevation"
outRaster = "C:/output/elev_slice_03.tif"
numberZones = 10
baseOutputZone = -5

# Execute Slice
arcpy.ddd.Slice(inRaster, outRaster, numberZones, "NATURAL_BREAKS", baseOutputZone)
Exemple 4 d’utilisation de l’outil Tranche (script autonome)

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

# Name: Slice_3d_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: 3D Analyst Extension

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
inRaster = "elevation"
outRaster = "C:/output/elev_slice_04.tif"
numberZones = 10
baseOutputZone = 5
nodataToValue = -99
classIntervalSize = "" # or None

# Execute Slice
arcpy.ddd.Slice(inRaster, outRaster, numberZones, "EQUAL_AREA", baseOutputZone, nodataToValue, classIntervalSize)

Rubriques connexes