Étiquette | Explication | Type de données |
Raster en entrée | Jeu de données raster en entrée. Le raster doit être un type d'entier. | Raster Layer |
Entités polygones en sortie | Classe d'entités en sortie destinée à contenir les polygones convertis. | Feature Class |
Simplifier les polygones (Facultatif) | Détermine si les polygones en sortie doivent être lissés pour donner des formes plus simples ou s'ils respectent le contour des cellules du raster en entrée.
| Boolean |
Champ (Facultatif) | Champ utilisé pour attribuer les valeurs des cellules du raster en entrée aux polygones du jeu de données en sortie. Il peut s'agir d'un champ de type entier ou chaîne. | Field |
Créer des entités multi-parties (Facultatif) | Indique si les polygones en sortie se composent d’entités en une seule partie ou multi-parties.
| Boolean |
Nombre maximal de sommets par entité surfacique (Facultatif) | La limite de sommet utilisée pour sous-diviser un polygone en polygones plus petits. Ce paramètre produit une sortie analogue à la création de l’outil Dice (Segmenter). Si laissée vide, les polygones de sortie ne seront pas séparés. Le format par défaut est vide. | Long |
Synthèse
Convertit un jeu de données raster en entités surfaciques.
Utilisation
Le raster en entrée peut contenir des cellules de toute taille et doit correspondre à un jeu de données de raster de type entier valide.
Le paramètre Champ vous permet de choisir quel champ attributaire du jeu de données raster en entrée deviendra un attribut de la classe d'entités en sortie. Si aucun champ n'est spécifié, les valeurs de cellules du raster en entrée (le champ VALUE) deviennent une colonne avec l'en-tête Gridcode dans la table attributaire de la classe d'entités en sortie.
Le graphique suivant illustre la vectorisation du raster en entrée lors de sa conversion en entité surfacique en sortie. Le résultat est présenté pour les deux configurations du paramètre Simplifié.
Si le paramètre Create multipart features (Créer des entités multi-parties) est activé (MULTIPLE_OUTER_PART dans Python), la sortie est une classe d’entités multi-parties et est traitée, en moyenne, plus rapidement. Toutefois, si la classe d’entités en sortie comporte un grand nombre d’entités, cela peut entraîner une erreur liée à la mémoire insuffisante. Le processus de regroupement est similaire à celui utilisé par l’outil Fusionner.
Le paramètre Maximum vertices per polygon (Nombre maximal de sommets par polygone) peut être utilisé pour sous-diviser un polygone en polygones plus petits selon la limite spécifiée du sommet. Cela est particulièrement utile lorsque les entités en sortie contiennent un très grand nombre de sommets. Ce paramètre produit une sortie analogue à la création de l’outil Dice (Segmenter).
Si l’étendue est spécifiée dans le paramètre d’environnement et que l’angle inférieur gauche de l’étendue en sortie ne correspond à aucun angle de cellule du raster en entrée, au cours du traitement, une translation de l’alignement de cellule du raster en entrée se produit pour correspondre à l’étendue spécifiée. Ce décalage déclenche un rééchantillonnage du raster en entrée à l'aide de la méthode Voisin le plus proche. Par conséquent, les entités en sortie subissent également une translation et les entités en sortie obtenues risquent de ne pas se superposer exactement au raster en entrée. Vous pouvez éviter ce décalage en utilisant le raster en entrée comme raster de capture dans l'environnement.
Paramètres
arcpy.conversion.RasterToPolygon(in_raster, out_polygon_features, {simplify}, {raster_field}, {create_multipart_features}, {max_vertices_per_feature})
Nom | Explication | Type de données |
in_raster | Jeu de données raster en entrée. Le raster doit être un type d'entier. | Raster Layer |
out_polygon_features | Classe d'entités en sortie destinée à contenir les polygones convertis. | Feature Class |
simplify (Facultatif) | Détermine si les polygones en sortie doivent être lissés pour donner des formes plus simples ou s'ils respectent le contour des cellules du raster en entrée.
| Boolean |
raster_field (Facultatif) | Champ utilisé pour attribuer les valeurs des cellules du raster en entrée aux polygones du jeu de données en sortie. Il peut s'agir d'un champ de type entier ou chaîne. | Field |
create_multipart_features (Facultatif) | Indique si les polygones en sortie se composent d’entités en une seule partie ou multi-parties.
| Boolean |
max_vertices_per_feature (Facultatif) | La limite de sommet utilisée pour sous-diviser un polygone en polygones plus petits. Ce paramètre produit une sortie analogue à la création de l’outil Dice (Segmenter). Si laissée vide, les polygones de sortie ne seront pas séparés. Le format par défaut est vide. | Long |
Exemple de code
Convertit un jeu de données raster en entités surfaciques.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.conversion.RasterToPolygon("zone", "c:/output/zones.shp", "NO_SIMPLIFY",
"VALUE")
Convertit un jeu de données raster en entités surfaciques.
# Name: RasterToPolygon_Ex_02.py
# Description: Converts a raster dataset to polygon features.
# Requirements: None
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
inRaster = "zone"
outPolygons = "c:/output/zones.shp"
field = "VALUE"
# Run RasterToPolygon
arcpy.conversion.RasterToPolygon(inRaster, outPolygons, "NO_SIMPLIFY", field)
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?