Affinage (Spatial Analyst)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Affine les entités linéaires rasterisées en réduisant le nombre de cellules représentant la largeur des entités.

Utilisation

Syntaxe

Thin (in_raster, {background_value}, {filter}, {corners}, {maximum_thickness})
ParamètreExplicationType de données
in_raster

Raster en entrée à affiner.

Il doit être de type entier.

Raster Layer
background_value
(Facultatif)

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.
  • NODATA L'arrière-plan se compose de cellules de valeur 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.

  • NOFILTER Aucun filtre n'est appliqué. Il s'agit du paramétrage par défaut.
  • 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.
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.
  • 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 renvoyée

NomExplicationType de données
out_raster

Raster en sortie après affinage.

Raster

Exemple de code

Premier exemple d'utilisation de l'outil Affinage (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")
Deuxième exemple d'utilisation de l'outil Affinage (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

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

# Execute Thin
thinOut = Thin(inRaster, "NODATA", "FILTER", "SHARP", tolerance)

# Save the output 
thinOut.save("c:/sapyexamples/output/thinoutput")

Environnements

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Requis ArcGIS Spatial Analyst
ArcGIS for Desktop Standard: Requis ArcGIS Spatial Analyst
ArcGIS for Desktop Advanced: Requis ArcGIS Spatial Analyst
5/10/2014