Affine les entités linéaires rastérisées en réduisant le nombre de cellules représentant la largeur des entités.
Utilisation
Une application type de l’outil Affiné concerne le traitement d’une carte numérisée représentant des isolignes d’élévation. En raison de la résolution du scanner et de la largeur des lignes sur la carte d'origine, les isolignes sont représentées dans le raster obtenu sous forme d'éléments linéaires larges de cinq à dix cellules. Après exécution de l’outil Affiné, chaque isoligne est représentée sous la forme d’une entité linéaire large d’une cellule.
Si elle est activée, l’option de filtre utilise le même algorithme de filtrage que l’outil Nettoyage de limites pour supprimer les entités linéaires courtes qui prolongent la branche principale. Elle peut également supprimer des entités dont la largeur ne dépasse pas trois cellules.
La spécification de l'épaisseur maximale des entités linéaires en entrée est essentielle pour affiner des rasters là où l'épaisseur d'entités linéaires peut dépasser ou rester au-dessous de la valeur d'épaisseur maximale par défaut. Les meilleurs résultats peuvent être obtenus lorsque l'épaisseur maximale correspond aux entités linéaires les plus épaisses à affiner.
Spécifie la valeur de la cellule qui doit identifier les cellules d'arrière-plan. Les entités linéaires sont formées à partir des cellules de premier plan.
Zéro—L'arrière-plan se compose de cellules dont la valeur est 0, inférieure à zéro ou NoData. Toutes les cellules dont la valeur est supérieure à 0 composent le premier plan. Il s’agit de l’option par défaut.
NoData—L’arrière-plan se compose de cellules dont la valeur est NoData. Toutes les cellules ayant une valeur valide appartiennent au premier plan.
String
Filtrer d'abord en entrée
(Facultatif)
Précise si un filtre doit être appliqué comme premier stade de l'affinage.
Activé—Le raster est filtré pour lisser les limites entre les cellules du premier plan et de l'arrière-plan. Cette option élimine les défauts mineurs du raster en sortie.
Décoché—Aucun filtre n'est appliqué. Il s’agit de l’option par défaut.
Boolean
Forme des coins
(Facultatif)
Précise s'il faut ou non arrondir les angles (tournants et jonctions).
Cette option est également utilisée lors de la conversion en vecteurs pour spliner les courbes et créer des angles vifs aux intersections et aux coins.
Arrondis—Tente de lisser les jonctions et les angles. Cette option est particulièrement adaptée à la vectorisation des caractéristiques naturelles du terrain, telles que les cours d'eau et les isolignes. Il s’agit de l’option par défaut.
Net—Tente de conserver l'arête des jonctions et des angles. Cette option est recommandée pour la vectorisation des entités résultant d'une intervention humaine, telles que les rues.
String
Epaisseur maximale des entités linéaires en entrée
(Facultatif)
Epaisseur maximale des entités linéaires du raster en entrée (en unités de carte).
L'épaisseur par défaut représente dix fois la taille de cellule.
Spécifie la valeur de la cellule qui doit identifier les cellules d'arrière-plan. Les entités linéaires sont formées à partir des cellules de premier plan.
ZERO—L'arrière-plan se compose de cellules dont la valeur est 0, inférieure à zéro ou NoData. Toutes les cellules dont la valeur est supérieure à 0 composent le premier plan. Il s’agit de l’option par défaut.
NODATA—L’arrière-plan se compose de cellules dont la valeur est NoData. Toutes les cellules ayant une valeur valide appartiennent au premier plan.
String
filter
(Facultatif)
Précise si un filtre doit être appliqué comme premier stade de l'affinage.
FILTER—Le raster est filtré pour lisser les limites entre les cellules du premier plan et de l'arrière-plan. Cette option élimine les défauts mineurs du raster en sortie.
NO_FILTER—Aucun filtre n'est appliqué. Il s’agit de l’option par défaut.
Boolean
corners
(Facultatif)
Précise s'il faut ou non arrondir les angles (tournants et jonctions).
Cette option est également utilisée lors de la conversion en vecteurs pour spliner les courbes et créer des angles vifs aux intersections et aux coins.
ROUND—Tente de lisser les jonctions et les angles. Cette option est particulièrement adaptée à la vectorisation des caractéristiques naturelles du terrain, telles que les cours d'eau et les isolignes. Il s’agit de l’option par défaut.
SHARP—Tente de conserver l'arête des jonctions et des angles. Cette option est recommandée pour la vectorisation des entités résultant d'une intervention humaine, telles que les rues.
String
maximum_thickness
(Facultatif)
Epaisseur maximale des entités linéaires du raster en entrée (en unités de carte).
L'épaisseur par défaut représente dix fois la taille de cellule.
Double
Valeur de retour
Nom
Explication
Type de données
out_raster
Raster en sortie après affinage.
La sortie est toujours de type entier.
Raster
Exemple de code
Thin Exemple 1 (fenêtre Python)
Cet exemple affine un raster où les valeurs d'arrière-plan sont NoData, et lisse les limites en essayant de conserver des angles et des jonctions.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
thinOut = Thin("land","NODATA", "FILTER", "SHARP", 300)
thinOut.save("c:/sapyexamples/output/thinout")
Thin Exemple 2 (script autonome)
Cet exemple affine un raster où les valeurs d'arrière-plan sont NoData, et lisse les limites en essayant de conserver des angles et des jonctions.
# Name: Thin_Ex_02.py
# Description: Thins rasterized linear features by
# reducing the number of cells
# representing the width of the features.
# 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 = "land"
tolerance = 300
# Run Thin
thinOut = Thin(inRaster, "NODATA", "FILTER", "SHARP", tolerance)
# Save the output
thinOut.save("c:/sapyexamples/output/thinoutput")