Étiquette | Explication | Type de données |
Couche en entrée | Entités ponctuelles, polylinéaires ou surfaciques à buffériser. | Feature Layer |
Classe d’entités en sortie |
Nouvelle classe d’entités contenant les résultats placés dans la zone tampon. | Feature Class |
Méthode | Indique la méthode à utiliser pour créer les zones tampon.
| String |
Type de zone tampon (Facultatif) | Indique comment la distance de la zone tampon sera définie.
| String |
Champ de zone tampon (Facultatif) | Champ qui contient la distance de la zone tampon pour chaque entité. 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 la valeur Couche en entrée (à moins que la valeur Couche en 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 des entités en entrée est utilisée par défaut. | Field |
Distance de la zone tampon (Facultatif) | Distance autour des entités en entrée à buffériser. | Linear Unit |
Expression de zone tampon (Facultatif) | Equation utilisant des champs et des opérateurs mathématiques qui seront appliqués à chaque entité en tant que zone tampon. Les champs doivent être numériques et l’expression peut inclure les opérateurs [+ - * / ] et plusieurs champs. Sauf indication contraire, les valeurs calculées sont appliquées en mètres. Par exemple, appliquez une zone tampon afin de multiplier un champ numérique nommé distance en kilomètres par 2 et ajoutez 15 mètres. Utilisez une expression Arcade telle que as_kilometers($feature["distance"]) * 2 + as_meters(15). Si la couche est ajoutée à la carte, les filtres Fields (Champs) et Helpers (Assistants) permettent de construire une expression. | Calculator Expression |
Option Fusionner (Facultatif) | Indique l’option de fusion à utiliser pour supprimer les superpositions des zones tampon.
| String |
Champs de fusion (Facultatif) | Liste d'un ou plusieurs champs des entités en entrée sur lesquelles les zones tampon en sortie seront fusionnées. Les zones tampon présentant des valeurs attributaires identiques dans les champs répertoriés sont fusionnées. Ce paramètre est requis uniquement lorsque l’option Fusionner est définie sur Liste. | Field |
Champs de récapitulation (Facultatif) | Spécifie les statistiques à appliquer à des champs numériques et de type chaîne. Si aucune valeur n’est spécifiée, seul le total est calculé. Ces statistiques sont appliquées uniquement lorsque l’option Fusionner est définie sur Liste ou Tous.
| Value Table |
Multi-parties (Facultatif) | Indique si des entités multi-parties seront créées.
| Boolean |
Synthèse
Crée des zones tampon à une distance donnée des entités en entrée.
Utilisation
Le paramètre Méthode spécifie le mode de construction des zones tampon. Deux méthodes élémentaires permettent de générer des zones tampon : euclidienne et géodésique.
- Les zones tampon euclidiennes mesurent la distance dans un plan cartésien bidimensionnel selon lequel les distances en ligne droite ou euclidiennes sont calculées entre deux points d’une surface plane (plan cartésien). Les zones tampons euclidiennes sont les plus courantes et fonctionnent bien dans un système de coordonnées projetées lors de l’analyse de distances autour d’entités concentrées sur une surface relativement limitée (par exemple, une zone UTM). Les zones tampon euclidiennes sont des zones tampon planaires.
- Les zones tampon géodésiques tiennent compte de la forme réelle de la Terre (à savoir un ellipsoïde, ou plus exactement un géoïde). Les distances sont calculées entre deux points d'une surface courbe (forme géoïdale), et non entre deux points d'une surface plane (plan cartésien). Envisagez de créer des zones tampon géodésiques dans les cas suivants :
- Les entités en entrée sont dispersées (elles couvrent plusieurs zones UTM, de vastes régions ou même l’intégralité du globe).
- La référence spatiale (projection cartographique) de vos entités en entrée déforme les distances en vue de préserver d’autres propriétés, telles que la surface.
Les zones tampon géodésiques peuvent sembler étranges sur une carte plane, mais elles apparaissent correctement sur un globe.
Le paramètre Méthode détermine le mode de création des zones tampon.
- La méthode planaire identifie automatiquement la méthode à utiliser en fonction du système de coordonnées des entités en entrée.
- Si les entités en entrée disposent d'un système de coordonnées projetées, des zones tampon euclidiennes sont créées.
- Si les entités en entrée disposent d'un système de coordonnées géographiques, des zones tampon géodésiques sont créées.
- Le mode géodésique est utilisé par défaut. La méthode géodésique crée une zone tampon géodésique de préservation de la forme, quel que soit le système de coordonnées en entrée. La zone tampon géodésique de préservation de la forme densifie les entités en entrée avant de créer les zones tampon géodésiques en sortie. Cela permet de générer des zones tampon géodésiques qui conservent plus fidèlement la forme des entités en entrée. Si vous vous préoccupez de la forme des zones tampon, ainsi que du degré de correspondance de leur forme avec les entités en entrée d’origine, cette option est recommandée, en particulier lorsque les données en entrée se trouvent dans un système de coordonnées géographiques. Cette opération peut prendre plus de temps que si vous choisissez l’option planaire pour créer la zone tampon géodésique, mais vous obtenez une zone tampon qui correspond davantage à la forme de l’entité en entrée.
- La méthode planaire identifie automatiquement la méthode à utiliser en fonction du système de coordonnées des entités en entrée.
Lorsque vous utilisez la méthode planaire, vous pouvez améliorer l’exactitude des zones tampon créées avec les entrées projetées en faisant appel à une projection qui réduit la distorsion de distance, comme une projection équidistante conique ou azimutale équidistante, adaptée à l’entrée d’un point de vue géographique.
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.
Remarque :
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 le jeu de données en sortie.
Vous pouvez indiquer la taille de la zone tampon en utilisant l’une des trois options suivantes :
- Distance : utilise une valeur constante (taille identique de toutes les zones tampon).
- Field (Champ) : utilise des valeurs provenant d’un champ (des entités différentes peuvent avoir des zones tampon de taille différente)
- Expression : applique une expression à chaque entité (valeurs variables des entités selon l’expression).
En savoir plus sur l’application d’expressions de zones tampon
Par défaut, l'outil Créer des zones tampon génère des zones tampon superposées lorsque ces dernières se rencontrent. Lorsque les entités en entrée sont des surfaces, la surface en entrée est incluse dans la zone tampon. Vous pouvez utiliser les paramètres de fusion et multipartie pour indiquer comment les zones tampon seront traitées. Les trois options de fusion disponibles sont les suivantes :
- Aucune : les zones tampon qui se rencontrent sont superposées. Il s’agit de l’option par défaut.
- All (Toutes) : toutes les entités sont fusionnées. Le paramètre multipartie indique si toutes les entités sont fusionnées en une seule entité (multipartie = vrai) ou si seules les entités superposées sont fusionnées (multipartie = faux).
- Fields (Champs) : les entités sont fusionnées en fonction des valeurs des champs. Vous pouvez sélectionner un ou plusieurs champs ; les valeurs identiques sont fusionnées. Le paramètre multipartie indique si toutes les entités avec des champs appariés sont fusionnées en une seule entité (multipartie = vrai) ou si seules les entités superposées avec des champs appariés sont fusionnées (multipartie = faux).
Si les distances de la zone tampon sont déterminées par un champ du paramètre Input Layer (Couche en entrée), la valeur du champ peut correspondre à un nombre (5, par exemple) ou à un nombre accompagné d’une unité linéaire valide (5 kilomètres, par exemple). Si une valeur de champ correspond à un nombre, on suppose que la distance est exprimée dans l’unité linéaire de la référence spatiale du paramètre Input Layer (Couche en entrée) (à moins que la couche en 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 la valeur du champ est incorrecte ou non reconnue, l’unité linéaire de la référence spatiale des entités en entrée est utilisée par défaut.
Lorsque vous fusionnez des entités en utilisant les options Toutes ou Champs, vous pouvez calculer des statistiques. Elles ne sont appliquées qu’à la fusion de toutes les entités ou valeurs de champ, et pas géographiquement (à l’aide du paramètre multipartie). La table ci-dessous décrit le fonctionnement de ces options avec les six entités illustrées sur l’image suivante. La couleur indique les valeurs de champ (bleu ou orange) utilisées pour la fusion des champs.
Option Dissolve (Fusionner) Multipartie a la valeur faux (par défaut) Multipartie a la valeur vrai Aucun Six entités sont créées lorsqu’aucune fusion n’est appliquée aux entités bufférisées. Il s’agit de l’option par défaut. Elle est identique à l’option Overlap (Superposition) de l’outil d’analyse standard.
La valeur de l’option Multipartie ne peut pas être vraie si l’option de fusion est paramétrée sur Aucune.
Tout Trois entités sont créées lorsque toutes les valeurs sont fusionnées et que l’option Multipartie a la valeur faux. Seules les entités superposées sont fusionnées. Elle est identique à l’option Dissolve (Fusionner) de l’outil d’analyse standard.
Une entité est créée lorsque toutes les valeurs sont fusionnées et que l’option Multipartie a la valeur vrai. En sélectionnant cette option, vous n’obtenez toujours qu'une entité en sortie.
Champs Quatre entités sont créées lorsque la fusion est appliquée en fonction du champ (dans ce cas, le champ correspond à la couleur des points en entrée). Seules les entités superposées présentant la valeur des champs spécifiés sont fusionnées.
Deux entités sont créées lorsque la fusion est appliquée en fonction du champ (dans ce cas, le champ correspond à la couleur des points en entrée) et les multiparties sont autorisées. Les entités présentant la même valeur de champ formeront toujours une seule entité.
Vous pouvez utiliser une expression de zone tampon pour créer une équation à partir de champs numériques et d’opérateurs mathématiques. Pour plus d’informations, reportez-vous à la rubrique Expressions Arcade dans la boîte à outils GeoAnalytics Desktop. On suppose que les valeurs numériques d'une expression de zone tampon sont exprimées en mètres, sauf indication contraire.
Vous pouvez effectuer une analyse semblable en utilisant :
- L’outil de géotraitement ArcGIS Pro Zone tampon de la boîte à outils Analyse.
- L’outil de géotraitement ArcGIS Pro Créer des zones tampons de la boîte à outils Analyse d’entités.
Le jeu de données en sortie inclut un champ BUFF_DIST indiquant 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 système de coordonnées en sortie est défini, les unités de BUFF_DIST sont exprimées dans ce système de coordonnées. Si le champ existe déjà en sortie, un numéro est ajouté à la fin du nom du champ pour que dernier soit unique (par exemple, BUFF_DIST1).
Vous pouvez améliorer les performances de l’outil Créer des zones tampon en effectuant une ou plusieurs des opérations suivantes :
- Définissez l’environnement de l’étendue de manière à analyser uniquement des données d’intérêt.
- Utilisez une zone tampon planaire.
- Ne fusionnez pas les zones tampon obtenues.
- Utilisez les données locales de l’environnement de l’analyse.
Cet outil de géotraitement est mis en œuvre par Spark. L'analyse est effectuée sur votre ordinateur de bureau à l'aide de plusieurs cœurs en parallèle. Pour en savoir plus sur l'exécution d'une analyse, reportez-vous à la rubrique Remarques sur les outils de GeoAnalytics Desktop.
Lors de l’exécution d’outils de GeoAnalytics Desktop, l’analyse est effectuée sur votre ordinateur de bureau. Pour des performances optimales, les données doivent être disponibles sur votre bureau : Si vous utilisez une couche d’entités hébergée, il est recommandé d'utiliser ArcGIS GeoAnalytics Server. Si vos données ne sont pas locales, l'exécution d'un outil est plus longue. Pour utiliser votre ArcGIS GeoAnalytics Server en vue d'une analyse, reportez-vous à la rubrique GeoAnalytics Tools.
Paramètres
arcpy.gapro.CreateBuffers(input_layer, out_feature_class, method, {buffer_type}, {buffer_field}, {buffer_distance}, {buffer_expression}, {dissolve_option}, {dissolve_fields}, {summary_fields}, {multipart})
Nom | Explication | Type de données |
input_layer | Entités ponctuelles, polylinéaires ou surfaciques à buffériser. | Feature Layer |
out_feature_class |
Nouvelle classe d’entités contenant les résultats placés dans la zone tampon. | Feature Class |
method | Indique la méthode à utiliser pour créer les zones tampon.
| String |
buffer_type (Facultatif) | Indique comment la distance de la zone tampon sera définie.
| String |
buffer_field (Facultatif) | Champ qui contient la distance de la zone tampon pour chaque entité. 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 la valeur input_layer (à moins que la valeur input_layer 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 des entités en entrée est utilisée par défaut. | Field |
buffer_distance (Facultatif) | Distance autour des entités en entrée à buffériser. | Linear Unit |
buffer_expression (Facultatif) | Equation utilisant des champs et des opérateurs mathématiques qui seront appliqués à chaque entité en tant que zone tampon. Les champs doivent être numériques et l’expression peut inclure les opérateurs [+ - * / ] et plusieurs champs. Sauf indication contraire, les valeurs calculées sont appliquées en mètres. Par exemple, appliquez une zone tampon afin de multiplier un champ numérique nommé distance en kilomètres par 2 et ajoutez 15 mètres. Utilisez une expression Arcade telle que as_kilometers($feature["distance"]) * 2 + as_meters(15). | Calculator Expression |
dissolve_option (Facultatif) | Indique l’option de fusion à utiliser pour supprimer les superpositions des zones tampon.
| String |
dissolve_fields [dissolve_fields,...] (Facultatif) | Liste d'un ou plusieurs champs des entités en entrée sur lesquelles les zones tampon en sortie seront fusionnées. Les zones tampon présentant des valeurs attributaires identiques dans les champs répertoriés sont fusionnées. Ce paramètre est requis uniquement lorsque dissolve_option est défini sur LIST. | Field |
summary_fields [summary_fields,...] (Facultatif) | Spécifie les statistiques à appliquer à des champs numériques et de type chaîne. Si aucune valeur n’est spécifiée, seul le total est calculé. Ces statistiques sont appliquées uniquement lorsque dissolve_option est défini sur LIST ou ALL.
| Value Table |
multipart (Facultatif) | Indique si des entités multi-parties seront créées.
| Boolean |
Exemple de code
Le script suivant pour la fenêtre Python illustre l’utilisation de la fonction CreateBuffers.
#-------------------------------------------------------------------------------
# Name: CreateBuffers.py
# Description: Buffer damaged building by 300 meters
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/DamageSurvey.gdb"
# Set local variables
inFeatures = "DamageAssessment"
out = "DangerousAreas"
# Run Create Buffers
arcpy.gapro.CreateBuffers(inFeatures, out, "GEODESIC", "DISTANCE",
None, "300 Meters", None, "ALL", None, None,
"SINGLE_PART")
Environnements
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?