Raster vers polylignes (Conversion)

Synthèse

Convertit un jeu de données raster en entités polylignes.

Utilisation

  • Le raster en entrée peut comporter des cellules valides de taille supérieure à 0 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és en sortie.

  • Le graphique suivant illustre la vectorisation du raster en entrée lors de sa conversion en entités polylignes en sortie. Le résultat est présenté pour les deux configurations du paramètre Simplifier.

    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, un décalage 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 se décalent également et les entités obtenues en sortie risquent de ne pas chevaucher exactement le 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

ÉtiquetteExplicationType 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 polylignes en sortie

Classe d’entités en sortie destinée à contenir les polylignes converties.

Feature Class
Valeur d’arrière-plan
(Facultatif)

Spécifie la valeur qui doit identifier les cellules d’arrière-plan. Le jeu de données raster est considéré 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.

  • ZéroL’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 dont la valeur est NoData. Toutes les cellules ayant une valeur valide appartiennent au premier plan.
String
Longueur d’arc pendant minimale
(Facultatif)

Longueur minimale des polylignes pendantes qui sera conservée. La valeur par défaut est zéro.

Double
Simplifier les polylignes
(Facultatif)

Simplifie une ligne en supprimant les petites fluctuations ou les courbes superflues de celle-ci, tout en conservant sa forme globale.

  • Activé : les polylignes sont simplifiés en formes plus simples, de sorte que chacune contienne un nombre minimal de segments. Il s’agit de l’option par défaut.
  • Désactivé : les polylignes ne sont pas simplifiées.
Boolean
Champ
(Facultatif)

Champ utilisé pour attribuer les valeurs des cellules du raster en entrée aux entités polylignes du jeu de données en sortie.

Il peut s'agir d'un champ de type entier ou chaîne.

Field

arcpy.conversion.RasterToPolyline(in_raster, out_polyline_features, {background_value}, {minimum_dangle_length}, {simplify}, {raster_field})
NomExplicationType 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

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 considéré 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 dont la valeur est 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 sorte 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)

Champ utilisé pour attribuer les valeurs des cellules du raster en entrée aux entités polylignes du jeu de données en sortie.

Il peut s'agir d'un champ de type entier ou chaîne.

Field

Exemple de code

Exemple d’utilisation de la fonction RasterToPolyline (fenêtre Python)

Convertit un jeu de données raster en entités polylignes.

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.conversion.RasterToPolyline("flowstr", "c:/output/streams.shp", "ZERO",
                                  50, "SIMPLIFY")
Exemple d’utilisation de la fonction 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

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set local variables
inRaster = "flowstr"
outLines = "c:/output/flowstream.shp"
backgrVal = "ZERO"
dangleTolerance = 50
field = "VALUE"

# Run RasterToPolygon
arcpy.conversion.RasterToPolyline(inRaster, outLines, backgrVal, 
                                  dangleTolerance, "SIMPLIFY", field)

Rubriques connexes