Étiquette | Explication | Type de données |
Couche synthétisée |
Les entités ponctuelles, linéaires ou surfaciques qui seront synthétisées par des polygones ou des groupes. | Feature Layer |
Output Feature Class (Classe d’entités en sortie) | Nom de la classe d’entités en sortie contenant les géométries et attributs qui s’intersectent. | Feature Class |
Polygone ou groupe | Indique si le champ Summarized Layer (Couche synthétisée) est synthétisé par des polygones ou des groupes.
| String |
Type de groupe | Spécifie la forme de groupe qui sera générée pour synthétiser les entités.
| String |
Taille du groupe (Facultatif) | Intervalle de distance qui représente la taille du groupe et les unités par lesquelles les entités en entrée seront synthétisées. | Linear Unit |
Polygones de synthèse (Facultatif) | Polygones utilisés pour synthétiser les entités dans la couche synthétisée en entrée. | Feature Layer |
Add Shape Summary Attributes (Ajouter des attributs de récapitulation de forme) | Indique si la longueur des lignes ou la surface des polygones au sein de la couche de synthèse (polygone ou groupe) est calculée. Les nombres de points, de lignes et de polygones qui intersectent la forme de synthèse sont toujours inclus.
| Boolean |
Unités de forme (Facultatif) | Spécifie l’unité à utiliser pour calculer les attributs de synthèse de forme. Si les entités de synthèse en entrée sont des points, une unité de forme est inutile, car seul le nombre de points au sein de chaque polygone en entrée est ajouté. Si les entités de récapitulation en entrée sont des lignes, spécifiez une unité linéaire. Si les entités de récapitulation en entrée sont des polygones, spécifiez une unité surfacique.
| String |
Champs de synthèse standard (Facultatif) | Statistiques qui seront calculées sur les champs spécifiés.
| Value Table |
Champs de synthèse pondérés (Facultatif) | Spécifie les statistiques pondérées qui seront calculées sur les champs spécifiés.
| Value Table |
Grouper par champ (Facultatif) | Champ issu des entités de synthèse en entrée qui permet de calculer les statistiques pour chaque valeur attributaire unique. Par exemple, supposons que les entités de synthèse en entrée contiennent des emplacements de points d’entreprises qui stockent des matières dangereuses et que l’un des champs, HazardClass, contient des codes qui décrivent le type de matières dangereuses stockées. Pour calculer des synthèses pour chaque valeur unique de HazardClass, utilisez ce champ comme champ de regroupement. | Field |
Ajouter des attributs minoritaires et majoritaires (Facultatif) | Indique si des valeurs attributaires minoritaires (les moins dominantes) et majoritaires (les plus dominantes) de chaque champ de regroupement au sein de chaque limite sont ajoutées. Dans l’affirmative, deux nouveaux champs sont ajoutés à la couche en sortie et associés aux préfixes Majority_ et Minority_. Ce paramètre s’applique uniquement lorsque le paramètre Group By Field (Regrouper par champ) est utilisé.
| Boolean |
Ajouter des pourcentages de regroupement (Facultatif) | Indique si des champs de pourcentage sont ajoutés. Dans l’affirmative, le pourcentage de chaque valeur de regroupement unique est calculé pour chaque polygone en entrée. Ce paramètre s’applique uniquement lorsque les paramètres Group By Field (Regrouper par champ) et Add Minority and Majority Attributes (Ajouter des attributs minoritaires et majoritaires) sont utilisés.
| Boolean |
Group By Summary Table (Regrouper par table de synthèse) (Facultatif) | Table en sortie qui contient le groupe par résumé. | Table |
Synthèse
Superpose une couche surfacique à une autre couche en vue de synthétiser le nombre de points, la longueur des lignes ou la surface des polygones au sein de chaque polygone, et calcule des statistiques des champs attributaires sur ces entités au sein des polygones.
Vous trouverez ci-dessous des exemples de scénarios mettant en jeu l’outil Synthétiser - À l’intérieur :
- A partir des limites de bassin versant et des limites d'utilisation du sol par type d'utilisation du sol, calculez la superficie totale du type d'utilisation du sol pour chaque bassin versant.
- A partir des parcelles dans un comté et des limites de ville, synthétisez la valeur moyenne des parcelles vacantes au sein de chaque limite de ville.
- A partir des comtés et des routes, synthétisez le kilométrage total des routes par type de route au sein de chaque comté.
Illustration
Utilisation
En termes simples, l’outil Synthétiser - À l’intérieur prend deux couches, les polygones en entrée et les entités de synthèse en entrée, et les empile l’une sur l’autre. Après avoir empilé ces couches, vous pouvez les examiner à travers la pile et comptabiliser le nombre d’entités de synthèse en entrée comprises dans les polygones en entrée. Vous pouvez également calculer des statistiques simples concernant les attributs des entités de synthèse en entrée, telles que la somme, la moyenne, le minimum, le maximum, etc.
Utilisez l’outil Synthétiser - À l’intérieur pour calculer des statistiques standard et des statistiques pondérées géographiquement. Les statistiques standard font la synthèse des valeurs statistiques sans aucune pondération. Les statistiques pondérées calculent les valeurs à l’aide des valeurs pondérées géographiquement de la proportion des lignes comprises dans un polygone ou de la proportion des polygones au sein d’un polygone. Les statistiques pondérées ne s’appliquent pas aux points compris dans des polygones.
Vous pouvez calculer les longueurs et les aires des couches synthétisées au sein de chaque polygone à l’aide des options indiquées dans le tableau ci-dessous. Les options sont basées sur la géométrie de la couche synthétisée.
Entité en entrée Description Option Points
Nombre de points synthétisés au sein de chaque polygone
Aucun
Lignes
Longueur des lignes synthétisées au sein de chaque polygone
- Miles
- Yards
- Pieds
- Kilomètres
- Mètres
Zones
Aire des polygones synthétisés au sein de chaque polygone
- Milles carrés
- Yards carrés
- Pieds carrés
- Kilomètres carrés
- Mètres carrés
- Hectares
- Acres
Vous pouvez calculer les statistiques standard. Pour les lignes et les surfaces, toutes les statistiques pondérées sont calculées. Les statistiques des champs de synthèse standard et les statistiques des champs de synthèse pondérées s’appliquent aux données des entités dans le paramètre Couche synthétisée qui intersectent la couche Polygones de synthèse. Les statistiques des champs de synthèse pondérées sont multipliées par une pondération en fonction de la proportion d'entités dans le paramètre Polygones de synthèse qui intersectent chaque entité dans le paramètre Couche synthétisée.
Pour les statistiques standard, huit options sont proposées : total, somme, moyenne, valeur minimale, valeur maximale, plage, écart type et variance. Il existe deux options pour les statistiques de chaîne : total et tout. Huit statistiques pondérées sont calculées dans les champs numériques de la couche à synthétiser : total, somme, moyenne, valeur minimale, valeur maximale, plage, écart type et variance.
Les statistiques pondérées ne sont pas calculées pour les données de type chaîne. Chaque fois que vous spécifiez les valeurs Champ et Statistique, une ligne est ajoutée à la fenêtre de l’outil pour permettre le calcul de plusieurs statistiques. Vous pouvez consulter les résultats synthétisés dans la table ou les fenêtres contextuelles de la couche de résultat. Par défaut, le nombre d’entités intersectant les valeurs Polygones de synthèse est toujours calculé.
L’analyse avec regroupement nécessite de projeter l’entrée ou de définir le système de coordonnées en sortie sur un système de coordonnées projetées. Si les données ne figurent pas dans un système de coordonnées projetées et si vous n’en définissez pas un, une projection sera utilisée en fonction de l’étendue des données que vous analysez.
Vous pouvez également sélectionner une valeur Group By Field (Regrouper par champ) afin de calculer les statistiques séparément pour chaque valeur attributaire unique. Lorsqu’une valeur Group By Field (Regrouper par champ) est sélectionnée, un tableau récapitulatif présentant chaque entité et statistique par valeur Group By Field (Regrouper par champ) est également créé.
Les paramètres Add Minority and Majority Attributes (Ajouter des attributs minoritaires et majoritaires) et Add groupe percentages (Ajouter des pourcentages de regroupement) sont disponibles lorsqu’une valeur Group By Field (Regrouper par champ) est sélectionnée. La minorité et la majorité correspondent, respectivement, à la valeur la moins dominante et à la valeur la plus dominante du paramètre Regrouper par, la dominance étant déterminée à partir du nombre de points, de la longueur totale ou de la surface totale de chaque valeur.
Lorsque le paramètre Add Minority and Majority Attributes (Ajouter des attributs minoritaires et majoritaires) est sélectionné, deux nouveaux champs sont ajoutés à la couche de résultats. Les champs répertorient les valeurs du paramètre Group By Field (Regrouper par champ) qui constituent la minorité et la majorité de chaque entité de résultat.
Le paramètre Ajouter des pourcentages de regroupement est disponible uniquement si le paramètre Ajouter des attributs minoritaires et majoritaires est sélectionné. Lorsque le paramètre Add Group Percentages (Ajouter des pourcentages de regroupement) est sélectionné, deux nouveaux champs sont ajoutés à la couche de résultats qui répertorie le pourcentage du nombre de points, la longueur totale ou la surface totale appartenant aux valeurs minoritaires et majoritaires de chaque entité. Un champ de pourcentage est également ajouté à la table de résultats qui répertorie le pourcentage du nombre de points, la longueur totale ou la surface totale appartenant à toutes les valeurs du paramètre Group By Field (Regrouper par champ) paramètre pour chaque entité.
Pour les statistiques pondérées, les couches linéaires sont synthétisées uniquement à l’aide des proportions des entités linéaires comprises dans la valeur Polygones de synthèse. Les statistiques standard (non pondérées) synthétisent toute ligne intersectant la valeur Polygones de synthèse. Lors de la synthétisation des lignes avec des statistiques pondérées, utilisez des totaux et des montants (et non des taux ou des indices) afin que les calculs proportionnels aient une signification logique dans l'analyse.
Les statistiques pondérées des couches surfaciques synthétisées reposent sur les proportions des entités Polygones de synthèse qui se trouvent dans la valeur Couche synthétisée. Lors de la synthétisation des zones, utilisez des totaux et des montants (et non des taux ou des indices) afin que les calculs proportionnels aient une signification logique dans l'analyse.
La couche d’entités en sortie est toujours une couche de polygones. Seuls les polygones qui intersectent une couche synthétisée sont renvoyés. Les autres polygones sont complètement supprimés de la couche de résultat.
Les champs suivants sont inclus dans les entités surfaciques en sortie :
Nom du champ Description count Nombre d’entités synthétisées qui intersectent chaque couche de polygones.
sum_length_<linearunit>ou sum_area_<areaunit>
Longueur totale de lignes au sein du polygone ou surface totale du polygone synthétisé dans chaque polygone. Ces valeurs sont renvoyées dans l’unité spécifiée si l'option Ajouter des attributs de récapitulation de forme est sélectionnée.
statistic_<fieldname>
Les statistiques indiquées créent chacune un champ attributaire nommé selon le format suivant : <statistique>_<nom de champ>. Par exemple, la valeur maximale et l’écart type du champ id sont MAX_id et SD_id.
pstatistic_<fieldname>
Les statistiques pondérées indiquées créent chacune un champ attributaire nommé selon le format suivant : p<statistique>_<nom de champ>. Par exemple, la valeur maximale pondérée du champ id est pMAX_id.
minority_<fieldname>
Cette valeur est renvoyée lorsque vous créez une table de regroupement et que l'option Ajouter des attributs minoritaires et majoritaires est sélectionnée. Cela représente les valeurs du champ spécifié, à savoir la minorité de chaque polygone. Prenons l’exemple d’un polygone comportant cinq points, un champ nommé color et les valeurs rouge, bleu, bleu, vert, vert. Si vous créez un groupe en fonction du champ color, la valeur du champ minority_color est rouge.
majority_<fieldname>
Cette valeur est renvoyée lorsque vous créez une table de regroupement et que l'option Ajouter des attributs minoritaires et majoritaires est sélectionnée. Cela représente les valeurs du champ spécifié, à savoir la majorité de chaque polygone. Prenons l’exemple d’un polygone comportant cinq points, un champ nommé color et les valeurs rouge, bleu, bleu, vert, vert. Si vous créez un groupe en fonction du champ color, la valeur du champ minority_color est bleu;vert.
minority_<fieldname>_percent
Cette valeur est renvoyée lorsque vous créez une table de regroupement et que l'option Ajouter des pourcentages de regroupement est sélectionnée. Cela représente le pourcentage du nombre pour le champ spécifié, à savoir la minorité de chaque polygone. Prenons l’exemple d’un polygone comportant cinq points, un champ nommé color et les valeurs rouge, bleu, bleu, vert, vert. Si vous créez un groupe en fonction du champ color, la valeur du champ minority_color_percent est égale à 20 (1/5).
majority_<fieldname>_percent
Cette valeur est renvoyée lorsque vous créez une table de regroupement et que l'option Ajouter des pourcentages de regroupement est sélectionnée. Cela représente le pourcentage du nombre pour le champ spécifié, à savoir la majorité de chaque polygone. Prenons l’exemple d’un polygone comportant cinq points, un champ nommé color et les valeurs rouge, bleu, bleu, vert, vert. Si vous créez un groupe en fonction du champ color, la valeur du champ majority_color_percent est égale à 40 (2/5).
join_id
Cette valeur est renvoyée lorsque vous créez une table de regroupement. Il s’agit d’un ID permettant de lier les entités à la table de regroupement. Chaque champ join_id correspond à une ou plusieurs lignes de la table de regroupement.
Les champs suivants sont inclus dans la table de regroupement en sortie :
Nom du champ Description join_id
Il s’agit d’un ID permettant de lier les entités à la couche de polygones. Chaque polygone comporte une ou plusieurs entités dotées du même ID qui représentent toutes les valeurs de regroupement. Prenons l’exemple d’un polygone comportant cinq points, un champ nommé color et les valeurs rouge, bleu, bleu, vert, vert. La table de regroupement comporte trois lignes représentant ce polygone (même ID de jointure) ; une par couleur : rouge, bleu et vert.
count
Nombre du groupe spécifié au sein du polygone joint. Par exemple, rouge a pour valeur 1 pour le polygone sélectionné.
<statistic>_<fieldname>
N’importe quelle statistique spécifiée calculée pour chaque groupe.
p<statistic>_<fieldname>
N’importe quelle statistique pondérée spécifiée calculée pour chaque groupe.
percentcount
Pourcentage de contribution de chaque groupe par rapport au nombre total dans le polygone. Dans l’exemple précédent, la contribution du rouge est de 1/5 = 20, la contribution du bleu est de 2/5 = 40 et la contribution du vert est de 2/5 = 20.
Vous pouvez améliorer les performances de l’outil Synthétiser - À l’intérieur de l'une des manières suivantes :
- Définissez l’environnement de l’étendue de sorte que seules les données d’intérêt soit analysées.
- Les groupes plus importants sont plus performants que les groupes de moindre taille. Si vous utilisez des groupes et ne savez pas quelle taille utiliser, commencez par effectuer un prototype avec un groupe plus grand.
- 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 en utilisant plusieurs cœurs en parallèle. Pour en savoir plus sur l’exécution de l’analyse, reportez-vous à la rubrique Remarques relatives aux outils GeoAnalytics Desktop.
Lorsque vous exécutez des outils GeoAnalytics Desktop, l’analyse est effectuée sur votre ordinateur de bureau. Pour des performances optimales, les données doivent être accessibles sur votre bureau. Si vous utilisez une couche d’entités hébergée, nous vous recommandons de faire appel à ArcGIS GeoAnalytics Server. Si vos données ne sont pas enregistrées en local, l’exécution des outils prendra plus de temps. Pour utiliser votre instance ArcGIS GeoAnalytics Server en vue d’une analyse, reportez-vous à la rubrique GeoAnalytics Tools.
Une analyse semblable peut également être réalisée à l’aide de l’outil Synthétiser - À l’intérieur de la boîte à outils Analyse d’entités standard dans ArcGIS Pro.
Paramètres
arcpy.gapro.SummarizeWithin(summarized_layer, out_feature_class, polygon_or_bin, bin_type, {bin_size}, {summary_polygons}, sum_shape, {shape_units}, {standard_summary_fields}, {weighted_summary_fields}, {group_by_field}, {add_minority_majority}, {add_percentages}, {group_by_summary})
Nom | Explication | Type de données |
summarized_layer |
Les entités ponctuelles, linéaires ou surfaciques qui seront synthétisées par des polygones ou des groupes. | Feature Layer |
out_feature_class | Nom de la classe d’entités en sortie contenant les géométries et attributs qui s’intersectent. | Feature Class |
polygon_or_bin | Indique si le champ summarized_layer est synthétisé par des polygones ou des groupes.
| String |
bin_type | Spécifie la forme de groupe qui sera générée pour synthétiser les entités.
| String |
bin_size (Facultatif) | Intervalle de distance qui représente la taille du groupe et les unités par lesquelles les entités en entrée seront synthétisées. | Linear Unit |
summary_polygons (Facultatif) | Polygones utilisés pour synthétiser les entités dans la couche synthétisée en entrée. | Feature Layer |
sum_shape | Indique si la longueur des lignes ou la surface des polygones au sein de la couche de synthèse (polygone ou groupe) est calculée. Les nombres de points, de lignes et de polygones qui intersectent la forme de synthèse sont toujours inclus.
| Boolean |
shape_units (Facultatif) | Spécifie l’unité à utiliser pour calculer les attributs de synthèse de forme. Si la valeur summarized_layer en entrée est composée de points, aucune unité de forme n'est nécessaire car seul le nombre de points au sein de chaque polygone en entrée est ajouté. Si les entités de récapitulation en entrée sont des lignes, spécifiez une unité linéaire. Si les entités de récapitulation en entrée sont des polygones, spécifiez une unité surfacique.
| String |
standard_summary_fields [standard_summary_fields,...] (Facultatif) | Statistiques qui seront calculées sur les champs spécifiés.
| Value Table |
weighted_summary_fields [weighted_summary_fields,...] (Facultatif) | Spécifie les statistiques pondérées qui seront calculées sur les champs spécifiés.
| Value Table |
group_by_field (Facultatif) | Champ issu des entités de synthèse en entrée qui permet de calculer les statistiques pour chaque valeur attributaire unique. Par exemple, supposons que les entités de synthèse en entrée contiennent des emplacements de points d’entreprises qui stockent des matières dangereuses et que l’un des champs, HazardClass, contient des codes qui décrivent le type de matières dangereuses stockées. Pour calculer des synthèses pour chaque valeur unique de HazardClass, utilisez ce champ comme champ de regroupement. | Field |
add_minority_majority (Facultatif) | Indique si des valeurs attributaires minoritaires (les moins dominantes) et majoritaires (les plus dominantes) de chaque champ de regroupement au sein de chaque limite sont ajoutées. Dans l’affirmative, deux nouveaux champs sont ajoutés à la couche en sortie et associés aux préfixes Majority_ et Minority_. Ce paramètre s’applique uniquement si le paramètre group_by_field est utilisé.
| Boolean |
add_percentages (Facultatif) | Indique si des champs de pourcentage sont ajoutés. Dans l’affirmative, le pourcentage de chaque valeur de regroupement unique est calculé pour chaque polygone en entrée. Ce paramètre s’applique uniquement si les paramètres group_by_field et add_minority_majority sont utilisés.
| Boolean |
group_by_summary (Facultatif) | Table en sortie qui contient le groupe par résumé. | Table |
Exemple de code
Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction SummarizeWithin.
#-------------------------------------------------------------------------------
# Name: SummarizeWithin.py
# Description: Summarize river polylines by counties.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/RedRiver_basin.gdb"
# Set local variables
summarizedLayer = "Rivers"
summaryPolys = "Basins"
summaryStatistics = [["Width", "MEAN"]]
weighedSummaryStatistics = [["DOC", "SUM"]]
out = 'SummarizedRivers'
# Execute SummarizeWithin
arcpy.gapro.SummarizeWithin(summarizedLayer, out, "POLYGON", None,
None, summaryPolys, "ADD_SUMMARY",
"KILOMETERS", summaryStatistics,
weightedSummaryStatistics)
Environnements
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?