Tranche (Outils 3D Analyst)

Résumé

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 (../../help/mapping/layer-properties/data-classification-methods.md) sont l’intervalle égal, la surface égale (quantile), les seuils naturels, l’écart type (centré sur la moyenne), l’écart type (moyenne comme seuil), 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 comme seuil]) 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 comme seuil]).
Vous pouvez utiliser le paramètre Change NoData to value for output (Modifier 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.
Lorsque le raster en entrée comporte des cellules rectangulaires, il est traité de telle sorte que les cellules du raster en sortie soient carrées avec des côtés égaux à la moyenne de la longueur et de la largeur des cellules rectangulaires.

Etiqueter	Explication	Type 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 comme seuil]), 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. Equal interval—The range of input values will be equally divided into the specified number of output zones to determine the class breaks. This is the default. Equal area—The number of input cells will be equally divided into the specified number of output zones to determine the class breaks. Each zone will have a similar number of cells, indicating a similar amount of area. Natural breaks—The class breaks will be determined in a way that minimizes the variance within classes and maximizes the variance between classes. The breaks are usually set at relatively big changes in the data values. Standard deviation (mean-centered)—The class breaks will be placed above and below the mean value at a specified interval size, such as 2, 1, or 0.5, in the unit of standard deviation, until reaching the minimum and maximum values of the input raster. Mean is not used as a break but centered by two class breaks. One break is at half of the specified interval size above the mean and the other is at half of the specified interval size below the mean. Standard deviation is calculated with the n-1 denominator, where n is the number of pixels with value. Standard deviation (mean as a break)—The mean value will be used as a class break. Other class breaks will be placed above and below the mean value at a specified interval size, such as 2, 1, or 0.5, in the unit of standard deviation, until reaching the minimum and maximum values of the input raster. Standard deviation is calculated with the n-1 denominator, where n is the number of pixels with value. Defined interval—The class breaks will be set to zero and a multiple of the specified interval size relative to zero. They will then be clipped to the minimum and maximum values of the input data for the first and last classes. For a value range that contains zero, zero will always be included as a break point. Geometric interval—The class breaks will be created based on class intervals that have a geometric series. This is a pattern in which the current value equals the previous value divided by a geometric coefficient. The geometric coefficient in this classifier can change once (to its inverse) to optimize the class ranges. The algorithm creates these geometrical intervals by minimizing the sum of squares of the number of elements in each class. This ensures that each class has approximately the same number of values and that the change between intervals is consistent.	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 comme seuil]). 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 comme seuil]) est utilisé, la taille d’intervalle indique le nombre d’écarts types utilisés pour calculer les interruptions de classes.	Double

arcpy.3d.Slice(in_raster, out_raster, {number_zones}, {slice_type}, {base_output_zone}, {nodata_to_value}, {class_interval_size})

Nom	Explication	Type 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_INTERVAL`—The range of input values will be equally divided into the specified number of output zones to determine the class breaks. This is the default. `EQUAL_AREA`—The number of input cells will be equally divided into the specified number of output zones to determine the class breaks. Each zone will have a similar number of cells, indicating a similar amount of area. `NATURAL_BREAKS`—The class breaks will be determined in a way that minimizes the variance within classes and maximizes the variance between classes. The breaks are usually set at relatively big changes in the data values. `STANDARD_DEVIATION_MEAN_CENTERED`—The class breaks will be placed above and below the mean value at a specified interval size, such as 2, 1, or 0.5, in the unit of standard deviation, until reaching the minimum and maximum values of the input raster. Mean is not used as a break but centered by two class breaks. One break is at half of the specified interval size above the mean and the other is at half of the specified interval size below the mean. Standard deviation is calculated with the n-1 denominator, where n is the number of pixels with value. `STANDARD_DEVIATION_MEAN_BREAK`—The mean value will be used as a class break. Other class breaks will be placed above and below the mean value at a specified interval size, such as 2, 1, or 0.5, in the unit of standard deviation, until reaching the minimum and maximum values of the input raster. Standard deviation is calculated with the n-1 denominator, where n is the number of pixels with value. `DEFINED_INTERVAL`—The class breaks will be set to zero and a multiple of the specified interval size relative to zero. They will then be clipped to the minimum and maximum values of the input data for the first and last classes. For a value range that contains zero, zero will always be included as a break point. `GEOMETRIC_INTERVAL`—The class breaks will be created based on class intervals that have a geometric series. This is a pattern in which the current value equals the previous value divided by a geometric coefficient. The geometric coefficient in this classifier can change once (to its inverse) to optimize the class ranges. The algorithm creates these geometrical intervals by minimizing the sum of squares of the number of elements in each class. This ensures that each class has approximately the same number of values and that the change between intervals is consistent.	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

Exemple de code

Exemple 1 d’utilisation de la fonction Slice (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 la fonction Slice (fenêtre Python)

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

import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.ddd.Slice("elevation", "c:/output/elev_slice_02.tif", "", "DEFINED_INTERVAL", "", "", 10)

Exemple 3 d’utilisation de la fonction Slice (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

# Run Slice
arcpy.ddd.Slice(inRaster, outRaster, numberZones, "NATURAL_BREAKS", baseOutputZone)

Exemple 4 d’utilisation de la fonction Slice (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

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

Environnements

Validation automatique, Taille de cellule, Cell Size Projection Method (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, Facteur de traitement parallèle, Espace de travail temporaire, Raster de capture, Taille de tuile

Informations de licence