Entités vers lignes (Gestion des données)

Synthèse

Crée une classe d'entités contenant des lignes générées en convertissant des limites de polygone en lignes, ou en fractionnant des entités linéaires, surfaciques ou les deux, à leurs intersections.

Illustration

Illustration de l’outil Entités vers lignes

Utilisation

  • Les attributs en entrée peuvent également être conservés dans la classe d’entités en sortie, déterminée par l’option Conserver les attributs de la boîte de dialogue (paramètre attributes dans le script).

  • Lorsque plusieurs couches ou classes d'entités sont spécifiées dans la liste des entités en entrée, l'ordre des entrées dans la liste n'affecte pas le type d'entité en sortie, mais la référence spatiale de l'entrée supérieure de la boîte de dialogue de l'outil (première entrée dans l'écriture de script) dans la liste sera utilisée au cours du traitement et définie sur la sortie.

  • Lorsque les limites de ligne ou de polygone se touchent, s’intersectent ou se superposent ailleurs qu’à leurs sommets de début et de fin, elles sont fractionnées à ces intersections et chaque ligne fractionnée devient une entité linéaire en sortie. Si une limite de ligne ou de polygone en entrée n'intersecte pas une autre entité, sa forme toute entière reste écrite comme entité linéaire.

  • Pour les entités multi-parties en entrée, les lignes en sortie seront à une partie.

  • Pour les entités en entrée qui sont des courbes paramétriques (vrai), les lignes en sortie resteront de vraies courbes même si elles sont fractionnées. Cela ne s'applique pas aux données des fichiers de formes.

  • Si l’option Conserver les attributs de la boîte de dialogue est activée (le paramètre attributes est défini sur ATTRIBUTES dans le script), les attributs de toutes les entrées sont conservés dans la sortie selon l’ordre dans lequel ils apparaissent dans la liste des entrées. Un nouveau champ, FID_xxx, où xxx représente le nom de classe d’entité source d’une entrée particulière, est ajouté à la sortie pour chaque entrée et défini sur les identifiants d’entité source. Les lignes en sortie sont associées à leurs attributs des façons suivantes :

    • Pour les lignes coïncidentes ou les limites de polygones à l'intérieur d'un même jeu d'entités en entrée (la limite séparant deux polygones, par exemple), deux entités linéaires de géométrie identique sont écrites dans la sortie, chacune avec les attributs de son entité source.
    • Pour les lignes coïncidentes ou les limites de polygone de deux jeux d'entités en entrée différents (une ligne se superposant à une limite de polygone, par exemple), une seule entité linéaire avec les attributs des deux entités source est écrite dans la sortie.
    • Si une ligne en sortie ne se superpose à aucune entité dans un jeu d'entités en entrée particulier, elle a la valeur -1 dans le champ FID_xxx des valeurs égales à zéro ou Null dans les autres champs de ce jeu d'entités.

    Si l’option Conserver les attributs de la boîte de dialogue est désactivée (le paramètre attributes est défini sur NO_ATTRIBUTES dans le script), aucun des attributs en entrée n’est conservé dans la classe d’entités en sortie ; une seule entité linéaire est écrite dans la sortie de chaque jeu de limites de polygone ou de lignes coïncidentes.

  • Si des entités en entrée contiennent des polygones adjacents, pour obtenir la ligne de limite partagée avec les identifiants de l’entité surfacique gauche et droit comme attributs de la sortie, utilisez plutôt l’outil Polygones vers lignes.

  • Afin d’améliorer les performances et l’évolutivité, cet outil utilise un processus de tuilage pour la gestion des jeux de données très volumineux. Pour plus de détails, reportez-vous à la rubrique Traitement tuilé de jeux de données volumineux.

Paramètres

ÉtiquetteExplicationType de données
Entités en entrée

Entités en entrée qui peuvent être des lignes, des polygones, ou les deux.

Feature Layer
Classe d’entités en sortie

Classe d’entités linéaires en sortie.

Feature Class
Tolérance XY
(Facultatif)

La distance minimale séparant toutes les coordonnées d'entité, ainsi que la distance de déplacement possible d'une coordonnée sur X ou Y (ou les deux) au cours du calcul spatial. La tolérance XY par défaut est de 0,001 mètre ou son équivalent dans les unités d'entité.

Attention :

Modifier la valeur de ce paramètre peut provoquer des erreurs ou des résultats inattendus. Il est recommandé de ne pas modifier ce paramètre. Ce paramètre n’est plus affiché dans la boîte de dialogue de l’outil. Par défaut, la propriété Tolérance x,y de la référence spatiale de la classe d’entités en entrée est utilisée.

Linear Unit
Conserver les attributs
(Facultatif)

Spécifie s'il faut conserver ou omettre les attributs d'entité en entrée dans la classe d'entités en sortie.

  • Activé : conserve les attributs en entrée dans les entités en sortie. Il s’agit de l’option par défaut.
  • Désactivé – Omet les attributs en entrée dans les entités en sortie.
Boolean

arcpy.management.FeatureToLine(in_features, out_feature_class, {cluster_tolerance}, {attributes})
NomExplicationType de données
in_features
[in_features,...]

Entités en entrée qui peuvent être des lignes, des polygones, ou les deux.

Feature Layer
out_feature_class

Classe d’entités linéaires en sortie.

Feature Class
cluster_tolerance
(Facultatif)

La distance minimale séparant toutes les coordonnées d'entité, ainsi que la distance de déplacement possible d'une coordonnée sur X ou Y (ou les deux) au cours du calcul spatial. La tolérance XY par défaut est de 0,001 mètre ou son équivalent dans les unités d'entité.

Attention :

Modifier la valeur de ce paramètre peut provoquer des erreurs ou des résultats inattendus. Il est recommandé de ne pas modifier ce paramètre. Ce paramètre n’est plus affiché dans la boîte de dialogue de l’outil. Par défaut, la propriété Tolérance x,y de la référence spatiale de la classe d’entités en entrée est utilisée.

Linear Unit
attributes
(Facultatif)

Indique si les attributs en entrée doivent être conservés ou omis dans la classe d’entités en sortie.

  • ATTRIBUTESConserve les attributs en entrée dans les entités en sortie. Il s’agit de l’option par défaut.
  • NO_ATTRIBUTESOmet les attributs en entrée dans les entités en sortie.
Boolean

Exemple de code

Exemple 1 d'utilisation de l'outil FeatureToLine (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction FeatureToLine en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.FeatureToLine_management(["majorrds.shp", "habitat_analysis.gdb/futrds"],
                               "c:/output/output.gdb/allroads",
                               "0.001 Meters", "ATTRIBUTES")
Exemple 2 d'utilisation de l'outil FeatureToLine (script autonome)

Le script autonome suivant est un exemple d’application de la fonction FeatureToLine dans un environnement de scripts.

# Name: FeatureToLine_Example2.py
# Description: Use FeatureToLine function to combine features from two 
#                  street feature classes into a single feature class,
#                  then determine an area of impact around all streets
#                  by buffering

# import system modules 
import arcpy

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

#  Set local variables
oldStreets = "majorrds.shp"
newStreets = "habitat_analysis.gdb/futrds"
uptodateStreets = "c:/output/output.gdb/allroads"

# Use FeatureToLine function to combine features into single feature class
arcpy.FeatureToLine_management([oldStreets, newStreets], uptodateStreets,
                               "0.001 Meters", "ATTRIBUTES")

# Use Buffer function to determine area of impact around streets
roadsBuffer = "c:/output/output.gdb/buffer_output"
arcpy.Buffer_analysis(uptodateStreets, roadsBuffer, "50 Feet",
                      "FULL", "ROUND", "ALL")

Rubriques connexes