Agréger des points (Analyse d'entités standard)

Résumé

Il utilise une couche d'entités ponctuelles et une couche d'entités surfaciques pour identifier les points qui se trouvent à l'intérieur de la surface de chaque polygone. Après avoir déterminé cette relation spatiale de type points sur polygones, des statistiques concernant tous les points du polygone sont calculées et affectées à la surface.

La statistique la plus élémentaire est le nombre total de points au sein du polygone, mais vous pouvez également en obtenir d'autres. Par exemple, si vos points représentent des cafés et que chaque point possède un attribut TOTAL_SALES, vous pouvez obtenir des statistiques, telles que la somme de tous les attributs TOTAL_SALES dans le polygone, la valeur TOTAL_SALES minimum ou maximum ou l’écart type de toutes les ventes dans le polygone.

Illustration

Agréger des points

Utilisation

  • L'outil Agréger des points permet de collecter et de synthétiser des entités ponctuelles dans un ensemble de limites. Les paramètres en entrée doivent comprendre des points à agréger et des zones d'agrégation.

  • La case Conserver les limites sans points est sélectionnée par défaut. Lorsque la case est cochée, toutes les surfaces utilisées dans l'analyse seront incluses dans le résultat, quel que soit emplacement des points. Les zones sans points seront vides et présenteront un total nul. Si la case n'est pas cochée, les zones sans points sont complètement supprimées de la couche de résultat. En désélectionnant cette case, vous risquez d'affecter considérablement les zones de résultat.

    Conserver les limites sans points
    Différence entre les couches de résultat lorsque les limites sans points sont conservées (gauche) ou non (droite)
  • Les agrégations les plus élémentaires calculent le nombre de points dans chaque limite. Vous pouvez également calculer des statistiques de base (somme, minimum, maximum, moyenne et écart type) sur des champs numériques. Les statistiques sont calculées séparément sur chaque surface.

  • Vous pouvez également grouper les calculs de statistiques à l'aide d'un champ contenant des valeurs catégorielles. Lorsque les statistiques sont groupées en fonction d'un champ, elles sont calculées pour la surface dans son ensemble, mais également pour chaque groupe. Vous pouvez afficher les statistiques dans la fenêtre contextuelle de la couche de résultats. Les statistiques globales sont indiquées dans un format numérique et les statistiques groupées sont présentées sous forme de diagramme dans la fenêtre contextuelle. Une table de synthèse présentant chaque entité et statistique par valeur de champ de regroupement est également créée. L'option Ajouter une minorité, majorité permet d'afficher les groupes présentant les totaux minimum et maximum, et l'option Ajouter des pourcentages indique le pourcentage de points des groupes minoritaires et majoritaires.

  • Les couches de points sont synthétisées uniquement à l'aide d'entités ponctuelles de la limite en entrée. Les résultats sont présentés à l'aide de symboles gradués.

    La figure et la table ci-dessous expliquent les calculs statistiques d'une couche de points dans une limite hypothétique. Le champ Population a permis de calculer les statistiques (Sum (Somme), Minimum, Maximum, Average (Moyenne) et Std Deviation (Écart type)) de la couche.

    Synthèse d'une couche de points
    Les couches de points sont synthétisées uniquement à l'aide de points figurant dans la couche de contours. L’exemple de table attributaire ci-dessus affiche les valeurs à utiliser dans les calculs de statistiques hypothétiques.

    StatistiqueRésultats pour le secteur A

    Somme

    280 + 408 + 356 + 361 + 450 + 713 = 2,568

    Minimum

    Minimum de

    [280, 408, 356, 361, 450, 713] = 280

    Maximum

    Maximum de

    [280, 408, 356, 361, 450, 713] = 713

    Moyenne

    2,568/6 = 428

    Ecart type

    Ecart type de points
    = 150.79

Paramètres

ÉtiquetteExplicationType de données
Points en entrée

Les entités ponctuelles qui seront agrégées dans les polygones de la couche de polygones.

Feature Set
Agrégation de polygones

Entités surfaciques (surfaces) dans lesquelles les points en entrée seront agrégés.

Feature Set
Nom en sortie

Nom de la couche en sortie à créer sur votre portail.

String
Conserver les limites sans points
(Facultatif)

Indique si les polygones ne comprenant aucun point doivent être renvoyés en sortie.

  • Activé : indique que les polygones sans points doivent être conservés. Il s’agit de l’option par défaut.
  • Désactivé : indique que les polygones sans point ne sont pas renvoyés en sortie.

Boolean
Champs de récapitulation
(Facultatif)

Liste des noms de champs et de type de résumé statistique que vous souhaitez calculer pour tous les points de chaque polygone. Le nombre de points figurant dans chaque polygone est toujours renvoyé. Les types de statistiques suivants sont pris en charge :

  • Somme : valeur totale.
  • Minimum : valeur la plus faible.
  • Max : Valeur la plus élevée.
  • Moyenne : moyenne ou valeur moyenne.
  • Ecart type : écart type.

Value Table
Grouper par champ
(Facultatif)

Nom de champ dans pointLayer. Les points de valeur identique dans le champ de regroupement correspondront à des totaux et des statistiques de champ de récapitulation distincts.

Vous pouvez créer des groupes de statistiques au moyen d'un attribut dans la couche d'analyse. Par exemple, si vous agrégez des délits aux limites de voisinage, vous pouvez avoir un attribut Crime_type avec cinq types de délits différents. Chaque type de délit unique forme un groupe, et les statistiques que vous choisissez seront calculées pour chaque valeur unique de Crime_type. Lorsque vous choisissez un attribut de regroupement, deux résultats sont générés : la couche de résultat et une table associée contenant les statistiques.

Field
Ajouter des attributs minoritaires et majoritaires
(Facultatif)

Ce paramètre booléen s'applique uniquement lorsque l'option Grouper par champ est spécifiée. Si cette option est sélectionnée, les valeurs attributaires minoritaires (les moins dominantes) et majoritaires (les plus dominantes) de chaque champ de regroupement au sein de chaque limite sont calculées. Deux nouveaux champs sont ajoutés à la couche en sortie et associés aux préfixes Majority_ et Minority_.

  • Désactivé : n'ajoute pas de champs minoritaires et majoritaires. Il s’agit de l’option par défaut.
  • Activé : ajoute des champs minoritaires et majoritaires.

Boolean
Ajouter un pourcentage
(Facultatif)

Ce paramètre booléen s'applique uniquement lorsque l'option Grouper par champ est spécifiée. Si ce paramètre est activé, le pourcentage de points pour chaque valeur Grouper par champ unique est calculé. Un nouveau champ est ajouté à la table de synthèse en sortie contenant les pourcentages de chaque valeur attributaire au sein de chaque groupe. Si le paramètre Ajouter des attributs minoritaires et majoritaires a la valeur true, deux champs supplémentaires sont ajoutés à la sortie contenant les pourcentages des valeurs attributaires minoritaires et majoritaires au sein de chaque groupe.

  • Désactivé : n'ajoute pas de champs de pourcentage. Il s’agit de l’option par défaut.
  • Activé : ajoute des champs de pourcentage.

Boolean

Sortie dérivée

ÉtiquetteExplicationType de données
Couche en sortie

Couche en sortie.

Jeu d'entités
Couche de groupe en sortie

Table en sortie qui synthétise les groupes résultant de l'application du paramètre Grouper par champ.

Jeu d'enregistrements

arcpy.sfa.AggregatePoints(pointLayer, polygonLayer, outputName, {keepBoundariesWithNoPoints}, {summaryFields}, {groupByField}, {minorityMajority}, {percentPoints})
NomExplicationType de données
pointLayer

Les entités ponctuelles qui seront agrégées dans les polygones de la couche de polygones.

Feature Set
polygonLayer

Entités surfaciques (surfaces) dans lesquelles les points en entrée seront agrégés.

Feature Set
outputName

Nom de la couche en sortie à créer sur votre portail.

String
keepBoundariesWithNoPoints
(Facultatif)

Indique si les polygones ne comprenant aucun point doivent être renvoyés en sortie.

  • KEEP_EMPTYConserve les polygones sans points. Il s’agit de l’option par défaut.
  • REMOVE_EMPTYNe renvoie pas les polygones sans point en sortie.
Boolean
summaryFields
[[Field, Statistic],...]
(Facultatif)

Liste des noms de champs et de type de résumé statistique que vous souhaitez calculer pour tous les points de chaque polygone. Le nombre de points figurant dans chaque polygone est toujours renvoyé. Les types de statistiques suivants sont pris en charge :

  • SUM : valeur totale.
  • MIN : valeur la plus faible.
  • MAX : valeur la plus élevée.
  • MEAN : moyenne ou valeur moyenne.
  • STD : écart type.

Value Table
groupByField
(Facultatif)

Nom de champ dans pointLayer. Les points de valeur identique dans le champ de regroupement correspondront à des totaux et des statistiques de champ de récapitulation distincts.

Vous pouvez créer des groupes de statistiques au moyen d'un attribut dans la couche d'analyse. Par exemple, si vous agrégez des délits aux limites de voisinage, vous pouvez avoir un attribut Crime_type avec cinq types de délits différents. Chaque type de délit unique forme un groupe, et les statistiques que vous choisissez seront calculées pour chaque valeur unique de Crime_type. Lorsque vous choisissez un attribut de regroupement, deux résultats sont générés : la couche de résultat et une table associée contenant les statistiques.

Field
minorityMajority
(Facultatif)

Ce paramètre booléen s'applique uniquement lorsqu'une option groupByField est spécifiée. Si la valeur est true, les valeurs attributaires minoritaires (les moins dominantes) et majoritaires (les plus dominantes) de chaque champ de regroupement au sein de chaque limite sont calculées. Deux nouveaux champs sont ajoutés à la couche en sortie et associés aux préfixes Majority_ et Minority_.

  • NO_MIN_MAJN'ajoutez pas de champs minoritaires et majoritaires. Il s’agit de l’option par défaut.
  • ADD_MIN_MAJAjoutez des champs minoritaires et majoritaires.
Boolean
percentPoints
(Facultatif)

Ce paramètre booléen s'applique uniquement lorsqu'une option groupByField est spécifiée. Si ce paramètre a la valeur ADD_PERCENT, le pourcentage de points est calculé pour chaque valeur groupByField unique. Un nouveau champ est ajouté à la table de synthèse en sortie contenant les pourcentages de chaque valeur attributaire au sein de chaque groupe. Si le paramètre minorityMajority a la valeur true, deux champs supplémentaires sont ajoutés à la sortie contenant les pourcentages des valeurs attributaires minoritaires et majoritaires au sein de chaque groupe.

  • NO_PERCENTN'ajoutez pas de champs de pourcentage. Il s’agit de l’option par défaut.
  • ADD_PERCENTAjoutez des champs de pourcentage.
Boolean

Sortie dérivée

NomExplicationType de données
aggregatedLayer

Couche en sortie.

Jeu d'entités
groupSummary

Table en sortie qui synthétise les groupes résultant de l'application du paramètre Grouper par champ.

Jeu d'enregistrements

Rubriques connexes