| Étiquette | Explication | Type de données |
Entités en entrée |
Entités ponctuelles, linéaires ou surfaciques en entrée qui seront utilisées pour créer les zones tampons. | Feature Layer |
Classe d’entités en sortie |
Classe d'entités contenant les zones tampon en sortie. | Feature Class |
Distance [valeur ou champ] |
Distance autour des entités en entrée à buffériser. Les distances peuvent être fournies en tant que valeur représentant une distance linéaire ou en tant que champ des entités en entrée contenant la distance utilisée pour buffériser chaque entité. Si les unités linéaires ne sont pas indiquées ou sont spécifiées inconnues, l’unité linéaire de la référence spatiale des entités en entrée est utilisée. | Linear Unit; Field |
Type de terminaison (Facultatif) | Spécifie le type de terminaison (extrémité) des entités en entrée utilisées pour calculer les zones tampons. Ce paramètre est compatible uniquement pour les entités ponctuelles et surfaciques.
| String |
Type de jointure (Facultatif) | Spécifie la forme de la zone tampon aux angles où les deux segments se rejoignent. Ce paramètre n'est disponible que pour les entités linéaires et surfaciques.
| String |
Limite de l’angle (Facultatif) | Lorsque les segments linéaires se rejoignent en formant un angle aigu et que la valeur du paramètre Type de jointure a été définie sur Pointu, ce paramètre permet de préciser dans quelle mesure les angles d’une zone tampon en sortie sont aigus par rapport à un point. Dans certains cas, l’angle extérieur où deux lignes se rejoignent est relativement grand lorsque vous utilisez l’option Pointu. Le point de l’angle risque alors de se trouver plus loin que prévu. | Double |
Écart de décalage maximal (Facultatif) |
Distance maximale selon laquelle la limite surfacique de la zone tampon en sortie obtenue peut s'écarter de la limite de la zone tampon réelle. La véritable limite de la zone tampon est une courbe et la limite polygonale en sortie est une polyligne densifiée. Grâce à ce paramètre, vous pouvez contrôler l’approximation de la limite surfacique en sortie par rapport à la limite de la zone tampon réelle. Si le paramètre n’est pas défini, ou s’il est défini sur 0, l’outil identifie l’écart maximum. Il est recommandé d’utiliser la valeur par défaut. Des dégradations des performances dans l’outil même ou dans les analyses ultérieures peuvent résulter de l’utilisation d’un écart trop faible de décalage maximal. | Linear Unit |
Synthèse
Crée une zone tampon à une distance donnée des entités en entrée. Un nombre de formes cartographiques sont disponibles pour les extrémités (terminaisons) et les angles (jointures) de la zone tampon lorsque cette dernière est générée autour de l'entité.
Des outils alternatifs sont disponibles pour les opérations de zone tampon. Reportez-vous à la documentation des outils Zone tampon deux par deux et Zone tampon pour plus de détails.
Illustration
Utilisation
Les entités en entrée peuvent être des points, des lignes ou des polygones. Les options disponibles pour les extrémités de sortie de la zone tampon (terminaisons) et les angles (jointures) dépendent du type d’entité en entrée.
- Type de terminaison : points et lignes uniquement
- Type de jointure : polygones et lignes uniquement
La classe d’entités en sortie comporte un champ BUFF_DIST, qui indique la distance utilisée pour calculer la zone tampon autour de chaque entité, dans l’unité linéaire du système de coordonnées des entités en entrée.
Si un champ BUFF_DIST est présent dans l’entrée, ses valeurs sont remplacées dans la sortie.
Les entités de la zone tampon de sortie seront toujours euclidiennes. Les entités de la zone tampon géodésique ne sont pas compatibles. Pour plus d’informations sur la différence entre les zones tampons euclidiennes et géodésiques, reportez-vous à la rubrique Comment fonctionnent les zones tampons (analyses).
La classe d’entités en sortie contient un champ ORIG_FID qui définit l’ID de l’entité en entrée pour laquelle la zone tampon a été créée. Si un champ ORIG_FID est présent dans l’entrée, ses valeurs sont remplacées dans la sortie.
Lors de la création de zones tampon autour d'entités polygone, l'utilisation de distances de zone tampon négatives permet de créer des zones tampon à l'intérieur des entités polygone. L'utilisation d'une distance de zone tampon négative réduit les limites des polygones de la distance spécifiée.
Attention :
Si la distance de zone tampon négative est suffisante pour réduire le polygone à néant, une géométrie nulle est générée. Un message d’avertissement s’affiche et aucune entité de géométrie nulle n’est écrite dans la classe d’entités en sortie.
Vous pouvez utiliser un champ de l’entrée pour définir les distances de la zone tampon. Les champs numériques et de texte sont autorisés. Dans un champ de texte, la distance de la zone tampon peut être un nombre, par exemple 5, ou une unité linéaire valide, par exemple 5 kilomètres.
Si vous utilisez un nombre sans unité linéaire, les unités utilisées pour la zone tampon sont les unités linéaires de la référence spatiale de l’entrée. Si l’entrée est un système de coordonnées géographiques, l’unité de la zone tampon est le mètre.
Si l’unité linéaire n’est pas reconnue, les unités utilisées pour la zone tampon sont les unités linéaires de la référence spatiale de l’entrée. Pour en savoir plus sur les unités linéaires valides, reportez-vous à la rubrique Unités linéaires.
Cet outil respecte l’environnement Facteur de traitement parallèle. Si l’environnement n’est pas défini (valeur par défaut) ou s’il est défini sur 100, le traitement parallèle complet est activé et l’outil tente de répartir les tâches sur tous les cœurs logiques de la machine. Si l’environnement est défini sur 0, le traitement parallèle n’est pas activé. Si vous spécifiez un facteur compris entre 1 et 99, l’outil identifie le pourcentage de cœurs logiques à utiliser en appliquant la formule (Facteur de traitement parallèle / 100 * Cœurs logiques) arrondie à l’entier supérieur le plus proche. Si le résultat de cette formule est 0 ou 1, le traitement parallèle n’est pas activé.
Remarque :
La sortie de cette outil est prévue uniquement pour l'affichage cartographique. Elle n'est pas prévue pour une utilisation pour toute autre analyse. Une telle utilisation entraînera des résultats erronés.
Paramètres
arcpy.analysis.GraphicBuffer(in_features, out_feature_class, buffer_distance_or_field, {line_caps}, {line_joins}, {miter_limit}, {max_deviation})| Nom | Explication | Type de données |
in_features |
Entités ponctuelles, linéaires ou surfaciques en entrée qui seront utilisées pour créer les zones tampons. | Feature Layer |
out_feature_class |
Classe d'entités contenant les zones tampon en sortie. | Feature Class |
buffer_distance_or_field |
Distance autour des entités en entrée à buffériser. Les distances peuvent être fournies en tant que valeur représentant une distance linéaire ou en tant que champ des entités en entrée contenant la distance utilisée pour buffériser chaque entité. Si les unités linéaires ne sont pas indiquées ou sont spécifiées inconnues, l’unité linéaire de la référence spatiale des entités en entrée est utilisée. Lors de la spécification d’une distance, si l’unité linéaire comporte deux mots, tels que Decimal Degrees (Degrés décimaux), fusionnez ces deux mots (par exemple, 20 DecimalDegrees). | Linear Unit; Field |
line_caps (Facultatif) | Spécifie le type de terminaison (extrémité) des entités en entrée utilisées pour calculer les zones tampons. Ce paramètre est compatible uniquement pour les entités ponctuelles et surfaciques.
| String |
line_joins (Facultatif) | Spécifie la forme de la zone tampon aux angles où les deux segments se rejoignent. Ce paramètre n'est disponible que pour les entités linéaires et surfaciques.
| String |
miter_limit (Facultatif) | Lorsque les segments linéaires se rejoignent en formant un angle aigu et que la valeur du paramètre line_joins a été définie sur MITER, ce paramètre permet de préciser dans quelle mesure les angles d’une zone tampon en sortie sont aigus par rapport à un point. Dans certains cas, l’angle extérieur où deux lignes se rejoignent est relativement grand lorsque vous utilisez l’option MITER. Le point de l’angle risque alors de se trouver plus loin que prévu. | Double |
max_deviation (Facultatif) |
Distance maximale selon laquelle la limite surfacique de la zone tampon en sortie obtenue peut s'écarter de la limite de la zone tampon réelle. La véritable limite de la zone tampon est une courbe et la limite polygonale en sortie est une polyligne densifiée. Grâce à ce paramètre, vous pouvez contrôler l’approximation de la limite surfacique en sortie par rapport à la limite de la zone tampon réelle. Si le paramètre n’est pas défini, ou s’il est défini sur 0, l’outil identifie l’écart maximum. Il est recommandé d’utiliser la valeur par défaut. Des dégradations des performances dans l’outil même ou dans les analyses ultérieures peuvent résulter de l’utilisation d’un écart trop faible de décalage maximal. | Linear Unit |
Exemple de code
Le script suivant pour la fenêtre Python illustre l’utilisation de la fonction GraphicBuffer.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.GraphicBuffer("roads", "C:/output/majorrdsBuffered", "100 Feet",
"SQUARE", "MITER")Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?