Densifier (Outils de mise à jour)

Résumé

Ajoute des sommets le long d’entités linéaires ou surfaciques et remplace les segments de courbe (Bezier, arcs circulaires et arcs elliptiques) par des segments de ligne.

Illustration

Utilisation

Attention :

Cet outil modifie les données en entrée. Pour en savoir plus et découvrir des stratégies permettant d’éviter des modifications de données non souhaitées, reportez-vous à la section Outils qui modifient ou mettent à jour les données en entrée.

Les segments en ligne droite sont densifiés par le paramètre Distance. Des sommets sont ajoutés à un intervalle qui ne dépasse pas la distance spécifiée. Les segments de courbe sont simplifiés par densification par le paramètre Distance, Maximum Deflection Angle (Angle de déflexion maximal) ou Maximum Offset Deviation (Écart de décalage maximal).
La densification se fait segment par segment.
Une seule méthode de densification peut être sélectionnée à chaque exécution de l’outil Densifier.
La référence spatiale des données est importante pour le résultat généré par cet outil. Densifiez les données dans un système de coordonnées approprié afin de préserver la forme correcte des entités.
Pour chaque sommet de l’entité d’origine, y compris les points de départ et d’arrivée, il y aura un sommet coïncident dans l’entité résultante.
Le paramètre Maximum Vertex Count (Nombre maximum de sommets) définit le nombre maximal de sommets dans chaque segment en sortie densifié. Si une opération de densification requiert une valeur supérieure à cette valeur, les segments sont ajustés en conséquence pour s’assurer qu’elle ne dépasse pas le nombre maximal de sommets (+/- 1). En cas de saisie d’une valeur incorrecte (0 ou moins), aucune limite n’est appliquée aux segments de ligne, et l’outil rétablit la valeur par défaut (12 000) pour les segments de courbe.

La définition du paramètre Maximum Vertex Count (Nombre maximum de sommets) permet d’utiliser le nombre maximal de sommets choisi pour les segments de ligne et les segments de courbe.

Remarque :

Plus la valeur utilisée est élevée, plus la probabilité qu’une entité devienne très grande augmente. Des entités trop grandes peuvent nuire aux performances. Si une valeur extrêmement petite est utilisée, l’entité en sortie peut être altérée et aboutir à une géométrie nulle. Des valeurs extrêmement faibles peuvent également entraîner la création d’entités qui renvoient des résultats inattendus lors d’analyses ultérieures.
Lorsque vous effectuez une densification à l’aide du paramètre Maximum Offset Deviation (Écart de décalage maximal), si la géométrie en entrée contient des arcs circulaires, une limite supérieure de décalage est appliquée de sorte que l’angle entre deux segments de ligne consécutifs dans la sortie n’excède pas 10 degrés. Cet angle peut être dépassé si vous effectuez la densification à l’aide du paramètre Maximum Deflection Angle (Angle de déflexion maximal).

Etiqueter	Explication	Type de données
Input Features (Entités en entrée)	Classe d’entités linéaires ou surfaciques à densifier.	Feature Layer
Méthode de densification (Facultatif)	Indique la méthode de densification des entités à utiliser. Distance—Les lignes droites et les courbes sont densifiées en utilisant la distance spécifiée. Il s’agit de l’option par défaut. Décalage—Les courbes sont densifiées en utilisant l’écart de décalage maximal spécifié. Angle—Les courbes sont densifiées en utilisant l’angle de déflexion maximal spécifié.	String
Distance (Facultatif)	Distance maximale entre les sommets. Cette distance sera toujours appliquée aux segments de ligne et pour la simplification des courbes. La valeur par défaut est une fonction de la tolérance x,y des données. Il est possible que les nouveaux sommets ne soient pas insérés exactement à cet intervalle le long de la ligne, mais plutôt à cette distance à partir du sommet précédent. Aucune méthode ne permet de s’assurer qu’un sommet est ajouté exactement à l’intervalle spécifié le long du segment de ligne.	Linear Unit
Ecart de décalage maximal (Facultatif)	Distance maximale entre le segment en sortie et le segment d’origine. Ce paramètre affecte uniquement les courbes. La valeur par défaut est une fonction de la tolérance x,y des données.	Linear Unit
Angle de déflexion maximal (degrés) (Facultatif)	Angle maximal entre la géométrie en sortie et la géométrie en entrée. La plage valide est comprise entre 0 et 90. La valeur par défaut est 10. Ce paramètre affecte uniquement les courbes.	Double
Nombre maximum de sommets (par segment) (Facultatif)	Nombre maximal de sommets autorisé par segment. En cas de saisie d’une valeur incorrecte (0 ou moins) ou si aucune valeur n’est saisie, aucune limite du nombre de sommets n’est appliquée aux segments de ligne et la valeur par défaut 12 000 est appliquée aux segments de courbe.	Long

Sortie dérivée

Etiqueter	Explication	Type de données
Entités en entrée mises à jour	Entités en entrée densifiées.	Feature Class

arcpy.edit.Densify(in_features, {densification_method}, {distance}, {max_deviation}, {max_angle}, {max_vertex_per_segment})

Nom	Explication	Type de données
in_features	Classe d’entités linéaires ou surfaciques à densifier.	Feature Layer
densification_method (Facultatif)	Indique la méthode de densification des entités à utiliser. `DISTANCE`—Les lignes droites et les courbes sont densifiées en utilisant la distance spécifiée. Il s’agit de l’option par défaut. `OFFSET`—Les courbes sont densifiées en utilisant l’écart de décalage maximal spécifié. `ANGLE`—Les courbes sont densifiées en utilisant l’angle de déflexion maximal spécifié.	String
distance (Facultatif)	Distance maximale entre les sommets. Cette distance sera toujours appliquée aux segments de ligne et pour la simplification des courbes. La valeur par défaut est une fonction de la tolérance x,y des données. Il est possible que les nouveaux sommets ne soient pas insérés exactement à cet intervalle le long de la ligne, mais plutôt à cette distance à partir du sommet précédent. Aucune méthode ne permet de s’assurer qu’un sommet est ajouté exactement à l’intervalle spécifié le long du segment de ligne.	Linear Unit
max_deviation (Facultatif)	Distance maximale entre le segment en sortie et le segment d’origine. Ce paramètre affecte uniquement les courbes. La valeur par défaut est une fonction de la tolérance x,y des données.	Linear Unit
max_angle (Facultatif)	Angle maximal entre la géométrie en sortie et la géométrie en entrée. La plage valide est comprise entre 0 et 90. La valeur par défaut est 10. Ce paramètre affecte uniquement les courbes.	Double
max_vertex_per_segment (Facultatif)	Nombre maximal de sommets autorisé par segment. En cas de saisie d’une valeur incorrecte (0 ou moins) ou si aucune valeur n’est saisie, aucune limite du nombre de sommets n’est appliquée aux segments de ligne et la valeur par défaut 12 000 est appliquée aux segments de courbe.	Long

Sortie dérivée

Nom	Explication	Type de données
out_feature_class	Entités en entrée densifiées.	Feature Class

Exemple de code

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

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

import arcpy
arcpy.edit.Densify("C:/data.gdb/lines", "ANGLE", "", "", 0.75)

Exemple 2 d’utilisation de la fonction Densify (script autonome)

Le script autonome ci-dessous présente la fonction Densify dans le cadre d’un processus qui utilise également l’outil de mise à jour Snap.

# Name: Snap.py
# Description: Snap climate regions boundary to vegetation layer
#              boundary to ensure common boundary is coincident

# import system modules
import arcpy

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

# Make backup copy of climate regions feature class,
# since modification with the Editing tools below is permanent.
climateBackup = "backups/climate.shp"
arcpy.management.CopyFeatures('climate.shp', climateBackup)

# Densify climate regions feature class to make sure there are enough
# vertices to match detail of vegetation layer when layers are snapped.
arcpy.edit.Densify('climate.shp', "DISTANCE", "10 Feet")

# Snap climate regions feature class to vegetation layer vertices and
# edge. First, snap climate region vertices to the nearest vegetation
# vertex within 30 Feet. Second, snap climate region vertices to the
# nearest vegetation edge within 20 Feet.
snapEnv1 = ["Habitat_Analysis.gdb/vegtype", "VERTEX", "30 Feet"]
snapEnv2 = ["Habitat_Analysis.gdb/vegtype", "EDGE", "20 Feet"]
arcpy.edit.Snap('climate.shp', [snapEnv1, snapEnv2])

Environnements

Validation automatique, Espace de travail courant

Informations de licence

Basic: Non
Standard: Oui
Advanced: Oui

Densifier (Outils de mise à jour)

Résumé

Illustration

Utilisation

Attention :

Remarque :

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes