Résumé
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é.
Illustration
Utilisation
Entités en entrée qui 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épendront du type d'entité en entrée.
- Type de terminaisons - 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 de zone tampon utilisée pour mettre en mémoire tampon chaque entité dans l’unité linéaire du système de coordonnées des entités en entrée.
Si un champ nommé 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. Voir Pour en savoir plus sur le fonctionnement de l'outil Zone tampon pour comprendre la différence entre zones tampons euclidienne et géodésique.
La classe d’entités en sortie contient champ ORIG_FID qui contient l’ID de l’entité en entrée pour laquelle la zone tampon a été créée. Si un champ nommé 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.
Si les distances de la zone tampon sont déterminées par un champ de l’entrée, les valeurs du champ peuvent correspondre à un nombre (par exemple, 5) ou à un nombre accompagné d’une unité linéaire valide (5 kilomètres, par exemple). Si une valeur de champ est un nombre, la distance est supposée être exprimée dans l’unité linéaire de la référence spatiale de l’entrée (à moins que l’entrée ne se trouve dans un système de coordonnées géographiques, auquel cas la valeur doit être en mètres). Si l’unité linéaire indiquée dans les valeurs de champ est incorrecte ou non reconnue, l’unité linéaire de la référence spatiale de l’entrée est utilisée par défaut.
Cet outil utilise un traitement parallèle par défaut lorsqu'il détecte qu'il fonctionne dans une application 64 bits (ArcGIS Pro, ArcGIS Server et Background Geoprocessing (64 bits)).
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 parmi tous les cœurs logiques de la machine. Si vous définissez l'environnement sur 0, le traitement parallèle est désactivé. 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é.
Syntaxe
arcpy.analysis.GraphicBuffer(in_features, out_feature_class, buffer_distance_or_field, {line_caps}, {line_joins}, {miter_limit}, {max_deviation})| Paramètre | Explication | Type de données |
in_features | Entités point, ligne ou polygone en entrée à buffériser. | 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 bufferiser 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 souhaitée 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) | Les terminaisons (extrémités) des entités en entrée à buffériser. Ce paramètre est compatible uniquement pour les entités ponctuelles et surfaciques.
| String |
line_joins (Facultatif) | 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 de ligne et surfaciques.
| String |
miter_limit (Facultatif) | Lorsque les segments linéaires se rejoignent en formant un angle aigu et que vous avez sélectionné l'option line_joins pour 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 le paramètre MITER line_joins. 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. Avec 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 détermine l'écart maximum. Cette valeur par défaut est fortement recommandée. Des dégradations importantes des performances, dans l'outil même ou dans les analyses ultérieures, peuvent résulter de l'utilisation d'un écart de décalage maximal trop petit. Consultez les informations du paramètre max_deviation indiquées dans la documentation de l'outil Densifier pour en savoir plus. | Linear Unit |
Exemple de code
1er exemple d'utilisation de l'outil Zone tampon graphique (fenêtre Python)
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil GraphicBuffer.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.GraphicBuffer_analysis("roads", "C:/output/majorrdsBuffered", "100 Feet",
"SQUARE", "MITER")
Environnements
- Valeur Z en sortie par défaut
- Résolution M
- Tolérance M
- Domaine M en sortie
- Domaine XY en sortie
- Domaine Z en sortie
- Système de coordonnées en sortie
- Étendue
- Grille spatiale 1 en sortie
- Grille spatiale 2 en sortie
- Grille spatiale 3 en sortie
- Espace de travail courant
- Transformations géographiques
- Espace de travail temporaire
- Valeurs M en sortie
- Valeurs Z en sortie
- Résolution XY
- Tolérance XY
- Résolution Z
- Tolérance Z
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui