Lisser un polygone (Cartographie)

Synthèse

Lisse des angles aigus en contours de polygone pour améliorer la qualité esthétique ou cartographique.

En savoir plus sur le fonctionnement des outils Lisser les lignes et Lisser un polygone

Illustration

Illustration de l’utilisation de l’outil Lisser un polygone
Il est possible de lisser les angles aigus d’un polygone à l’aide de la méthode PAEK ou de la méthode d’interpolation de Bézier.

Utilisation

  • Le paramètre Algorithme de lissage possède les options suivantes :

    • PAEK (Polynomial Approximation with Exponential Kernel, approximation polynomiale avec noyau exponentiel) : lisse les polygones selon une tolérance de lissage. Chaque polygone lissé peut avoir davantage de sommets que son polygone source. Le paramètre Tolérance de lissage contrôle la longueur d'un chemin « mobile » qui sert à calculer les nouveaux sommets. Plus la longueur est courte, plus le niveau de détail est préservé et plus le temps de traitement est long.
    • Interpolation de Bézier : lisse les polygones sans faire appel à une tolérance en créant des courbes de Bézier évaluées qui correspondent aux polygones en entrée.
  • Utilisez le paramètre Couches d’interruptions en entrée pour identifier les entités qui ne doivent pas être traversées par des polygones lissés. Les entités interruptions peuvent être des points, des lignes ou des polygones.

  • Le traitement de jeux de données volumineux peut dépasser les limites de mémoire. Dans ce cas, envisagez de traiter les données en entrée par partition en identifiant une classe d’entités surfaciques pertinente dans le paramètre d’environnement Partitions cartographiques. Les portions de données, définies par les limites des partitions, sont traitées séquentiellement. La classe d'entités résultante sera transparente et cohérente aux tronçons de partition. Reportez-vous à Généralisation de jeux de données volumineux à l'aide de partitions pour en savoir plus.

    Attention :

    Le paramètre d’environnement Partitions cartographiques est ignoré lorsque le paramètre Traitement des erreurs topologiques est défini sur Ne pas détecter les erreurs topologiques ou Détecter et signaler les erreurs topologiques.

  • Les domaines et sous-types seront copiés dans la sortie, même si l’environnement Transfert des domaines de champ, des sous-types et des règles attributaires n’est pas sélectionné.

  • La classe d’entités surfaciques en sortie sera correcte d’un point de vue topologique. Toute erreur topologique dans les données en entrée est signalée dans la classe d’entités surfaciques en sortie. La classe d’entités en sortie inclura les champs supplémentaires suivants :

    • InPoly_FID— Contient les ID des entités de l’entrée.
    • SmoPgnFlag— Contient les erreurs topologiques de l’entrée. La valeur 1 indique qu’il existe une erreur topologique. La valeur 0 (zéro) indique qu’il n’existe aucune erreur.

    Héritage :

    Avant la version ArcGIS Pro 2.2 de cet outil, le paramètre Conserver l’extrémité des anneaux était utilisé pour indiquer si l’extrémité d’un anneau de polygone isolé obtenu devait être conservé. Ce paramètre est encore inclus dans la syntaxe de l’outil pour la compatibilité des scripts et des modèles, mais est désormais ignoré et masqué dans la boîte de dialogue de l’outil.

Paramètres

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

Entités surfaciques à lisser.

Feature Layer
Classe d’entités en sortie

Classe d’entités surfaciques en sortie qui sera créée.

Feature Class
Algorithme de lissage

Spécifie l’algorithme de lissage à utiliser.

  • PAEK (Polynomial Approximation with Exponential Kernel, approximation polynomiale avec noyau exponentiel)Calcule un polygone lissé qui ne passe pas par les sommets du polygone en entrée. Il s’agit de l’option par défaut.
  • Interpolation de BézierLes courbes de Bézier seront ajustées entre les sommets. Les polygones obtenus passent par les sommets des polygones en entrée. Cet algorithme ne requiert pas de tolérance. La sortie contient des courbes de Bézier approximatives.
String
Tolérance de lissage

Tolérance utilisée par l’option PAEK (Polynomial Approximation with Exponential Kernel, approximation polynomiale avec noyau exponentiel) du paramètre Algorithme de lissage. Une tolérance supérieure à zéro doit être spécifiée. Vous pouvez choisir une unité préférée. Par défaut, l'unité de l'entité est spécifiée. Ce paramètre n’est pas disponible lorsque l’option Interpolation de Bézier est utilisée pour le paramètre Algorithme de lissage.

Linear Unit
Conserver l’extrémité des anneaux
(Facultatif)

Il s'agit d'un ancien paramètre qui n'est plus utilisé. Il était auparavant utilisé pour indiquer si l’extrémité d’un anneau surfacique isolé devait être conservée. Ce paramètre est encore inclus dans la syntaxe de l’outil en vue de la compatibilité des scripts et des modèles, mais est ignoré et masqué dans la fenêtre Géotraitement.

Spécifie si les extrémités des anneaux surfaciques isolés seront conservées. Cette option fonctionne uniquement avec l’option PAEK (Polynomial Approximation with Exponential Kernel, approximation polynomiale avec noyau exponentiel) du paramètre Algorithme de lissage.

  • Activé : l'extrémité d'un anneau surfacique isolé sera conservée. Il s’agit de l’option par défaut.
  • Désactivé : l’extrémité d'un anneau surfacique isolé ne sera pas conservée ; elle sera lissée.
Boolean
Traitement des erreurs topologiques
(Facultatif)

Précise la manière de traiter les erreurs topologiques (qui ont pu s’introduire au cours du processus, notamment les croisements et les superpositions de lignes).

  • Ne pas détecter les erreurs topologiquesLes erreurs topologiques ne seront pas identifiées. Il s’agit de l’option par défaut.
  • Détecter et signaler les erreurs topologiquesSi des erreurs topologiques sont détectées, elles seront signalées.
  • Résoudre les erreurs topologiquesSi des erreurs topologiques sont détectées, elles seront résolues.
String
Couches de barrières en entrée
(Facultatif)

Entrées contenant les entités qui jouent le rôle d’interruptions pour le lissage. Les polygones lissés obtenus ne touchent pas ni ne traversent les entités interruptions.

Feature Layer

arcpy.cartography.SmoothPolygon(in_features, out_feature_class, algorithm, tolerance, {endpoint_option}, {error_option}, {in_barriers})
NomExplicationType de données
in_features

Entités surfaciques à lisser.

Feature Layer
out_feature_class

Classe d’entités surfaciques en sortie qui sera créée.

Feature Class
algorithm

Spécifie l’algorithme de lissage à utiliser.

  • PAEKCalcule un polygone lissé qui ne passe pas par les sommets du polygone en entrée. Il s’agit de l’option par défaut.
  • BEZIER_INTERPOLATIONLes courbes de Bézier seront ajustées entre les sommets. Les polygones obtenus passent par les sommets des polygones en entrée. Cet algorithme ne requiert pas de tolérance. La sortie contient des courbes de Bézier approximatives.
String
tolerance

Tolérance utilisée par l’option PAEK du paramètre algorithm. Une tolérance supérieure à zéro doit être spécifiée. Vous pouvez choisir une unité préférée. Par défaut, l'unité de l'entité est spécifiée. Vous devez saisir le chiffre 0 comme emplacement réservé si vous utilisez l’option BEZIER_INTERPOLATION pour le paramètre algorithm.

Linear Unit
endpoint_option
(Facultatif)

Il s'agit d'un ancien paramètre qui n'est plus utilisé. Il était auparavant utilisé pour indiquer si l’extrémité d’un anneau surfacique isolé devait être conservée. Ce paramètre est encore inclus dans la syntaxe de l’outil pour la compatibilité des scripts et des modèles.

Spécifie si les extrémités des anneaux surfaciques isolés seront conservées. Cette option fonctionne uniquement avec l’option PAEK du paramètre algorithm.

  • FIXED_ENDPOINTL'extrémité d'un anneau surfacique isolé sera conservée. Il s’agit de l’option par défaut.
  • NO_FIXEDL’extrémité d'un anneau surfacique isolé ne sera pas conservée ; elle sera lissée.
Boolean
error_option
(Facultatif)

Précise la manière de traiter les erreurs topologiques (qui ont pu s’introduire au cours du processus, notamment les croisements et les superpositions de lignes).

  • NO_CHECKLes erreurs topologiques ne seront pas identifiées. Il s’agit de l’option par défaut.
  • FLAG_ERRORSSi des erreurs topologiques sont détectées, elles seront signalées.
  • RESOLVE_ERRORSSi des erreurs topologiques sont détectées, elles seront résolues.
String
in_barriers
[in_barriers,...]
(Facultatif)

Entrées contenant les entités qui jouent le rôle d’interruptions pour le lissage. Les polygones lissés obtenus ne touchent pas ni ne traversent les entités interruptions.

Feature Layer

Exemple de code

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

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction SmoothPolygon en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.cartography.SmoothPolygon("soils.shp", "C:/output/output.gdb/smoothed_soils", "PAEK", 100)
Exemple 2 d'utilisation de la fonction SmoothPolygon (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction SmoothPolygon.

# Name: SmoothPolygon_Example2.py
# Description: Eliminate small islands before simplifying and smoothing lake boundaries

# Import system modules.
import arcpy

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

# Set local variables.
inLakeFeatures = "lakes"
barriers = "C:/data/Portland.gdb/Structures/buildings"
eliminatedFeatures = "C:/data/PortlandOutput.gdb/lakes_eliminated"
simplifiedFeatures = "C:/data/PortlandOutput.gdb/lakes_simplified"
smoothedFeatures = "C:/data/PortlandOutput.gdb/lakes_smoothed"

# Eliminate small islands in lake polygons.
arcpy.management.EliminatePolygonPart(
    inLakeFeatures, eliminatedFeatures, 100, "OR", 0, "CONTAINED_ONLY")

# Simplify lake polygons.
arcpy.cartography.SimplifyPolygon(
    eliminatedFeatures, simplifiedFeatures, "POINT_REMOVE", 50, 200, 
    "RESOLVE_ERRORS", "KEEP_COLLAPSED_POINTS", barriers)

# Smooth lake polygons.
arcpy.cartography.SmoothPolygon(
    simplifiedFeatures, smoothedFeatures, "PAEK", 100, "", "FLAG_ERRORS",
    barriers)

Informations de licence

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

Rubriques connexes