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

Synthèse

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 identifié la 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. Si, par exemple, les 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 toutes les valeurs TOTAL_SALES dans le polygone, la valeur TOTAL_SALES minimale ou maximale ou l’écart type de toutes les ventes dans le polygone.

Illustration

Illustration de l’outil Agréger les points

Utilisation

  • Cet outil collecte et synthétise des entités ponctuelles dans un ensemble de limites. Les paramètres en entrée doivent comprendre des points à agréger ainsi que des zones d’agrégation.

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

    Utilisation du paramètre Conserver les limites sans points
    Différence dans les couches de résultat selon que les limites sans points sont conservées (première image) ou non (deuxième image).

  • 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. La sélection du paramètre Ajouter des attributs minoritaires et majoritaires permet d’afficher les groupes présentant les totaux les plus faibles et les plus élevés et la sélection du paramètre Ajouter un pourcentage renvoie 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 (Minimum), Maximum (Maximum), Average (Moyenne) et Std Deviation (Écart type)) de la couche.

    Synthétisation d’une couche de points
    Les couches de points sont synthétisées uniquement à l'aide de points figurant dans la couche de contours. Un exemple de table attributaire avec les valeurs à utiliser dans les calculs de tests statistiques est illustré.

    StatistiquesRé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

    Écart 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 sont renvoyés en sortie.

  • Activé : les polygones ne comprenant aucun point sont renvoyés en sortie. Il s’agit de l’option par défaut.
  • Désactivé : les polygones ne comprenant aucun 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 à 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
  • Écart type : écart type

Value Table
Champ de regroupement
(Facultatif)

Nom de champ dans la couche 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. Chaque type de crime 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)

Indique si des champs minoritaires et majoritaires sont ajoutés à la sortie. Ce paramètre s’applique uniquement lorsqu’une valeur Group Field (Champ de regroupement) 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é : les champs minoritaires et majoritaires ne sont pas ajoutés. Il s’agit de l’option par défaut.
  • Activé : les champs minoritaires et majoritaires sont ajoutés.

Boolean
Ajouter un pourcentage
(Facultatif)

Indique si des champs de pourcentage sont ajoutés à la sortie. Ce paramètre s’applique uniquement lorsqu’une valeur Group Field (Champ de regroupement) est spécifiée. Si ce paramètre est activé, le pourcentage de points pour chaque valeur Champ de regroupement unique est calculé. Un nouveau champ est ajouté à la table de synthèse en sortie contenant les pourcentages de chaque valeur attributaire dans chaque groupe. Si le paramètre Ajouter des attributs minoritaires et majoritaires est sélectionné, deux champs supplémentaires sont ajoutés à la sortie contenant les pourcentages des valeurs attributaires minoritaires et majoritaires dans chaque groupe.

  • Désactivé : aucun champ de pourcentage n’est ajouté. Il s’agit de l’option par défaut.
  • Activé : des champs de pourcentage sont ajoutés.

Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Couche en sortie

Couche en sortie.

Feature Set
Couche de groupe en sortie

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

Record Set

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 sont renvoyés en sortie.

  • KEEP_EMPTYLes polygones ne comprenant aucun point sont renvoyés en sortie. Il s’agit de l’option par défaut.
  • REMOVE_EMPTYLes polygones ne comprenant aucun point ne sont pas renvoyés en sortie.
Boolean
summaryFields
[[Field, Statistic],...]
(Facultatif)

Liste des noms de champs et de type de résumé statistique à 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 la couche 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. Chaque type de crime 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)

Indique si des champs minoritaires et majoritaires sont ajoutés. Ce paramètre s’applique uniquement lorsqu’une valeur groupByField est spécifiée. Si la valeur est ADD_MIN_MAJ, 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_MAJLes champs minoritaires et majoritaires ne sont pas ajoutés. Il s’agit de l’option par défaut.
  • ADD_MIN_MAJLes champs minoritaires et majoritaires sont ajoutés.
Boolean
percentPoints
(Facultatif)

Indique si des champs de pourcentage sont ajoutés à la sortie. Ce paramètre s’applique uniquement lorsqu’une valeur groupByField est spécifiée. Si ce paramètre est défini sur 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 dans chaque groupe. Si le paramètre minorityMajority est défini sur ADD_MIN_MAJ, deux champs supplémentaires sont ajoutés à la sortie contenant les pourcentages des valeurs attributaires minoritaires et majoritaires 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 obtenue

NomExplicationType de données
aggregatedLayer

Couche en sortie.

Feature Set
groupSummary

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

Record Set

Informations de licence

  • Basic: Nécessite votre compte dans ArcGIS Enterprise pour que vous puissiez disposer du privilège Perform Analysis (Effectuer une analyse)
  • Standard: Nécessite votre compte dans ArcGIS Enterprise pour que vous puissiez disposer du privilège Perform Analysis (Effectuer une analyse)
  • Advanced: Nécessite votre compte dans ArcGIS Enterprise pour que vous puissiez disposer du privilège Perform Analysis (Effectuer une analyse)

Rubriques connexes