Résumé
Simplifie les lignes en supprimant les sommets relativement extérieurs tout en conservant leur forme globale.
Illustration
Utilisation
Cet outil utilise différents algorithmes de simplification répondant à des objectifs différents :
- L’algorithme POINT_REMOVE identifie et supprime les sommets relativement redondants pour simplifier les données pour un affichage à des échelles plus petites. Il s’agit de l’algorithme de simplification le plus rapide dans cet outil. Cet algorithme est souvent utilisé pour la compression des données ou pour une simplification grossière. L'angularité des lignes résultantes augmente significativement au fur et à mesure que la tolérance s'accroît. Cet algorithme est basé sur l'algorithme de Douglas-Peucker : Douglas, David and Peucker, Thomas, "Algorithms for the reduction of the number of points required to represent a digitized line or its caricature," The Canadian Cartographer 10(2), 112–122 (1973).
- L’algorithme BEND_SIMPLIFY identifie et supprime les courbes relativement non significatives pour simplifier les données pour un affichage à des échelles plus petites. Il est généralement plus précis en ce qui concerne la géométrie en entrée que l’algorithme POINT_REMOVE, mais peut prendre plus de temps à traiter. Cet algorithme est basé sur l’algorithme défini dans l’ouvrage de Wang, Zeshen et Müller, Jean-Claude, « Line Generalization Based on Analysis of Shape Characteristics », Cartography and Geographic Information Systems 25(1), 3–-15 (1998).
- L'algorithme WEIGHTED_AREA identifie les triangles de surface effective pour chaque sommet. Ces triangles sont ensuite pondérés par un ensemble de mesures afin de comparer la platitude, l'inclinaison et la convexité de chaque surface. Les surfaces pondérées guident la suppression de leurs sommets correspondants afin de simplifier la ligne tout en conservant autant de caractère que possible. Cet algorithme repose sur l'algorithme défini dans l’ouvrage de Zhou, Sheng et Jones, Christopher B., « Shape-Aware Line Generalisation with Weighted Effective Area, » publication Fisher, Peter F. (Ed.), Developments in Spatial Handling 11th International Symposium on Spatial Handling, 369-80 (2005).
- L’algorithme EFFECTIVE_AREA identifie les triangles de surface effective de chaque sommet pour guider la suppression des sommets, ce qui permet de simplifier la ligne tout en préservant au maximum son caractère. Cet algorithme repose sur l’algorithme défini dans l’ouvrage de Visvalingam, M. and Whyatt, J. D., « Line Generalisation by Repeated Elimination of the Smallest Area, » Cartographic Information Systems Research Group (CISRG) Discussion Paper 10, The University of Hull (1992).
La valeur du paramètre Tolérance de simplification détermine le degré de simplification. Plus la tolérance est grande, plus la géométrie finale est grossière. Des tolérances plus petites génèrent une géométrie qui représente l'entrée de manière plus précise. Les champs MinSimpTolet MaxSimpTol sont ajoutés à la sortie pour enregistrer la tolérance utilisée.
- Pour l'algorithme POINT_REMOVE, la tolérance est la distance perpendiculaire maximum autorisée entre chaque sommet et la nouvelle ligne créée.
- Pour l'algorithme BEND_SIMPLIFY, la tolérance est le diamètre d'un cercle qui avoisine une courbe significative.
- Pour l’algorithme WEIGHTED_AREA, le carré de la tolérance est la surface d’un triangle significatif défini par trois sommets adjacents. Plus un triangle dévie de la forme équilatérale, plus la pondération attribuée est élevée et moins il est probable qu’il soit supprimé.
- Pour l’algorithme EFFECTIVE_AREA, le carré de la tolérance est la surface d’un triangle significatif défini par trois sommets adjacents.
Utilisez le paramètre Conserver les points éliminés (collapsed_point_option dans Python) pour créer une classe d'entités ponctuelles pour enregistrer les extrémités de toutes les lignes qui sont inférieures à la tolérance spatiale des données. La sortie du point est dérivée ; elle utilisera le même nom et le même emplacement que la valeur du paramètre Classe d’entités en sortie (out_feature_class dans Python), mais avec un suffixe _Pnt. La classe d'entités linéaires en sortie contient tous les champs présents dans la classe d'entités en entrée. La classe d'entités points en sortie ne contient aucun de ces champs.
La classe d'entités linéaires en sortie est 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 linéaires en sortie. La classe d’entités en sortie inclut deux champs supplémentaires : InLine_FIDet SimLnFlag, qui contiennent respectivement les ID des entités en entrée et les erreurs topologiques de l’entrée. Une valeur SimLnFlag de 1 indique une erreur topologique ; une valeur de 0 (zéro) indique l’absence d’erreur.
Utilisez le paramètre Couches de barrière en entrée pour identifier les entités qui ne doivent pas être traversées par des lignes simplifiées. 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.
Syntaxe
arcpy.cartography.SimplifyLine(in_features, out_feature_class, algorithm, tolerance, {error_resolving_option}, {collapsed_point_option}, {error_checking_option}, {in_barriers})
Paramètre | Explication | Type de données |
in_features | Entités linéaires en entrée à simplifier. | Feature Layer |
out_feature_class | Classe d'entités linéaires en sortie à simplifier. Elle contient tous les champs présents dans la classe d'entités en entrée. La classe d'entités linéaires en sortie est correcte d'un point de vue topologique. L’outil n’introduit pas d’erreurs de topologie, mais des erreurs topologiques dans les données en entrée sont signalées dans la classe d’entités linéaires en sortie. La classe d’entités en sortie inclut deux champs supplémentaires : InLine_FID et SimLnFlag qui contiennent respectivement les ID des entités en entrée et les erreurs topologiques en entrée. Une valeur SimLnFlag de 1 indique une erreur topologique en entrée ; une valeur de 0 (zéro) indique l’absence d’erreur en entrée. | Feature Class |
algorithm | Spécifie l'algorithme de simplification de lignes.
| String |
tolerance | La tolérance qui détermine le degré de simplification. Vous pouvez choisir une unité préférée ; sinon, les unités de l'entrée seront utilisées. Les champs MinSimpTol et MaxSimpTol sont ajoutés à la sortie pour enregistrer la tolérance utilisée lors du traitement.
| Linear Unit |
error_resolving_option (Facultatif) | Boolean | |
collapsed_point_option (Facultatif) | Spécifie si une classe d'entités ponctuelles en sortie sera créée pour stocker les extrémités de toutes les lignes qui sont inférieures à la tolérance spatiale. La sortie du point est dérivée ; elle utilisera le même nom et le même emplacement que le paramètre out_feature_class, mais avec un suffixe _Pnt.
| Boolean |
error_checking_option (Facultatif) | Boolean | |
in_barriers [in_barriers,...] (Facultatif) | Entrées contenant les entités pour agir en tant que barrières pour simplification. Les lignes simplifiées obtenues ne toucheront pas ni ne traverseront les entités interruptions. Par exemple, lors de la simplification des isolignes, l’entrée des entités de point côté comme interruptions garantit que les isolignes simplifiées ne simplifieront pas ces points. La sortie n'enfreindra pas l'altitude comme décrit par les points côtés mesurés. | Feature Layer |
Sortie dérivée
Nom | Explication | Type de données |
out_point_feature_class | Lorsque le paramètre Conserver les points éliminés (collapsed_point_option dans Python) est utilisé, une classe d’entités ponctuelles en sortie est créée pour enregistrer les extrémités de toutes les lignes inférieures à la tolérance spatiale des données. | Feature Class |
Exemple de code
Exemple 1 d'utilisation de la fonction SimplifyLine (fenêtre Python)
Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction SimplifyLine en mode immédiat.
import arcpy
import arcpy.cartography as CA
arcpy.env.workspace = "C:/data"
CA.SimplifyLine("roads.shp",
"C:/output/output.gdb/simplified_roads",
"POINT_REMOVE",
20)
2e exemple d'utilisation de l'outil SimplifyLine (script autonome)
Le script autonome ci-dessous illustre l’utilisation de la fonction SimplifyLine.
# Name: SimplifyLine_Example2.py
# Description: Simplify line features from two feature classes, rivers and coastlines,
# while maintaining their connections
# Import system modules
import arcpy
import arcpy.management as DM
import arcpy.cartography as CA
# Set environment settings
arcpy.env.workspace = "C:/data/Portland.gdb/Hydrography"
# Set local variables
inRiverFeatures = "rivers"
inCoastlineFeatures = "coastlines"
mergedFeatures = "C:/data/PortlandOutput.gdb/merged_lines"
simplifiedFeatures = "C:/data/PortlandOutput.gdb/merged_lines_simplified"
tempLayer = "tempLyr"
outRiverFeatureClass = "C:/data/PortlandOutput.gdb/rivers_final"
outCoastlineFeatureClass = "C:/data/PortlandOutput.gdb/coastlines_final"
# Merge rivers and coastlines into one feature class,
# assuming that they have a common f-code field
# with value 40 for rivers and 80 for coastlines.
DM.Merge(inRiverFeatures, inCoastlineFeatures, mergedFeatures)
# Simplify all lines.
CA.SimplifyLine(mergedFeatures,
simplifiedFeatures,
"BEND_SIMPLIFY",
100,
"KEEP_COLLAPSED_POINTS")
# Select rivers and coastlines by their f-code values
# and put them in separate feature classes.
DM.MakeFeatureLayer(simplifiedFeatures, tempLayer, "f-code = 40")
DM.CopyFeatures(tempLayer, outRiverFeatureClass)
DM.MakeFeatureLayer(simplifiedFeatures, tempLayer, "f-code = 80")
DM.CopyFeatures(tempLayer, outCoastlineFeatureClass)
Environnements
Informations de licence
- Basic: Non
- Standard: Oui
- Advanced: Oui