Résumé
Convertit un jeu de données raster en entités polylignes.
Utilisation
Le raster en entrée peut contenir des cellules de taille supérieure à 0 valides et peut correspondre à n'importe quel jeu de données 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 Grid_code dans la table attributaire de la classe d'entité en sortie.
Le graphique suivant illustre la vectorisation du raster en entrée lors de sa conversion en entité polyligne en sortie. Le résultat est présenté pour les deux configurations du paramètre Simplifié.
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.
Syntaxe
arcpy.conversion.RasterToPolyline(in_raster, out_polyline_features, {background_value}, {minimum_dangle_length}, {simplify}, {raster_field})
Paramètre | 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_polyline_features | La classe d'entités en sortie destinée à contenir les polylignes converties. | Feature Class |
background_value (Facultatif) | Spécifie la valeur qui doit identifier les cellules d'arrière-plan. Le jeu de données raster est vu comme un ensemble de cellules de premier plan et d'arrière-plan. Les entités linéaires sont formées à partir des cellules de premier plan.
| String |
minimum_dangle_length (Facultatif) | Longueur minimale des polylignes pendantes qui sera conservée. La valeur par défaut est zéro. | Double |
simplify (Facultatif) | Simplifie une ligne en supprimant les petites fluctuations ou les courbes superflues de celle-ci, tout en conservant sa forme globale.
| Boolean |
raster_field (Facultatif) | Le champ utilisé pour attribuer les valeurs des cellules du raster en entrée aux entités polylignes dans le fichier en sortie. Il peut s'agir d'un champ de type entier ou chaîne. | Field |
Exemple de code
Exemple d'utilisation de l'outil RasterToPolyline (fenêtre Python)
Convertit un jeu de données raster en entités polylignes.
import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.RasterToPolyline_conversion("flowstr", "c:/output/streams.shp", "ZERO",
50, "SIMPLIFY")
Exemple d'utilisation de l'outil RasterToPolyline (script autonome)
Convertit un jeu de données raster en entités polylignes.
# Name: RasterToPolyline_Ex_02.py
# Description: Converts a raster dataset to polyline features.
# Requirements: None
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inRaster = "flowstr"
outLines = "c:/output/flowstream.shp"
backgrVal = "ZERO"
dangleTolerance = 50
field = "VALUE"
# Execute RasterToPolygon
arcpy.RasterToPolyline_conversion(inRaster, outLines, backgrVal,
dangleTolerance, "SIMPLIFY", field)
Environnements
- Validation automatique
- Espace de travail courant
- Valeur Z en sortie par défaut
- Étendue
- Transformations géographiques
- Résolution M
- Tolérance M
- Conserver un index spatial
- Mot-clé CONFIG en sortie
- Système de coordonnées en sortie
- Valeurs M en sortie
- Valeurs Z en sortie
- Domaine M en sortie
- Domaine XY en sortie
- Domaine Z en sortie
- Espace de travail temporaire
- Raster de capture
- Résolution XY
- Tolérance XY
- Résolution Z
- Tolérance Z
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui