Raster vers polylignes (Conversion)

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é.

    Illustration de la sortie avec des options de simplification différentes
    Comparaison de la sortie avec des options de simplification différentes
  • 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ètreExplicationType 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.

  • ZEROL'arrière-plan se compose de cellules dont la valeur est zéro, inférieure à zéro ou NoData. Toutes les cellules dotées d'une valeur supérieure à zéro sont des valeurs de premier plan.
  • NODATAL'arrière-plan se compose de cellules de valeur NoData. Toutes les cellules ayant une valeur valide appartiennent au 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.

  • SIMPLIFYLes polylignes sont simplifiés en formes plus simples, de manière que chacune contienne un nombre minimal de segments. Il s'agit de l'option par défaut.
  • NO_SIMPLIFYLes polylignes ne sont pas simplifiées.
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)

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes