Enveloppes d’entités vers polygones (Gestion des données)

Synthèse

Crée une classe d’entités contenant des polygones, qui représentent chacun l’enveloppe d’une entité en entrée.

Illustration

Illustration de l’outil Enveloppes d’entités vers polygones

Utilisation

  • Les attributs des entités en entrée seront conservés dans la classe d'entités points en sortie. Un nouveau champ, ORIG_FID, sera ajouté à la classe d'entités en sortie et défini sur les identifiants d'entité en entrée.

  • Étant donné que l’enveloppe d’une ligne parfaitement horizontale (parallèle à l’axe des x) a une hauteur égale à zéro et que l’enveloppe d’une ligne parfaitement verticale (parallèle à l’axe des y) a une largeur égale à zéro, le polygone qui résulte de l’une ou l’autre ligne aura une surface nulle ; les polygones de ce type ne sont pas valides et sont omis dans la sortie. Il en va de même pour une partie d’entité linéaire multi-parties.

Paramètres

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

Entités en entrée qui peuvent être multi-points, linéaires, surfaciques ou annotation.

Feature Layer
Classe d’entités en sortie

Classe d'entités surfaciques en sortie.

Feature Class
Créer des entités multi-parties
(Facultatif)

Spécifie s’il faut utiliser une enveloppe pour chaque entité multi-parties entière ou une enveloppe par partie d’une entité multi-parties. Ce paramètre affecte uniquement les résultats d’entités en entrée multi-parties.

  • Désactivé : utilise une enveloppe qui contient une entité multi-parties entière ; le polygone obtenu est donc en une seule partie. Il s’agit de l’option par défaut.
  • Activé : utilise une enveloppe pour chaque partie d’une entité multi-parties ; le polygone obtenu reste multi-parties.
Boolean

arcpy.management.FeatureEnvelopeToPolygon(in_features, out_feature_class, {single_envelope})
NomExplicationType de données
in_features

Entités en entrée qui peuvent être multi-points, linéaires, surfaciques ou annotation.

Feature Layer
out_feature_class

Classe d'entités surfaciques en sortie.

Feature Class
single_envelope
(Facultatif)

Spécifie s’il faut utiliser une enveloppe pour chaque entité multi-parties entière ou une enveloppe par partie d’une entité multi-parties. Ce paramètre affecte uniquement les résultats d’entités en entrée multi-parties.

  • SINGLEPARTUtilise une enveloppe qui contient une entité multi-parties entière ; le polygone obtenu est donc en une seule partie. Il s’agit de l’option par défaut.
  • MULTIPARTUtilise une enveloppe pour chaque partie d’une entité multi-parties ; le polygone obtenu reste multi-parties.
Boolean

Exemple de code

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

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

import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.FeatureEnvelopeToPolygon_management("urban_analysis.gdb/parks",
                                          "c:/output/output.gdb/parks_extent",
                                          "SINGLEPART")
Exemple 2 d’utilisation de la fonction FeatureEnvelopeToPolygon (script autonome)

Le script autonome ci-après est un exemple d’application simple de la fonction FeatureEnvelopeToPolygon dans un environnement de scripts.

# Name: FeatureEnvelopeToPolygon_Example2.py
# Description: Use FeatureEnvelopeToPolygon function to find 
#              the general extent of features.

# import system modules 
import arcpy

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

# Set local variables
inFeatures = "houses"
outFeatureClass = "c:/output/output.gdb/houses_extent"

# Execute FeatureEnvelopeToPolygon
arcpy.FeatureEnvelopeToPolygon_management(inFeatures, outFeatureClass, 
                                          "SINGLEPART")

Rubriques connexes