Synthétiser - À l’intérieur (GeoAnalytics)

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

Illustration de l’outil Synthétiser - À l’intérieur
Des exemples de synthèse de points au sein de polygones (première ligne), de lignes au sein de polygones (deuxième ligne) et de polygones au sein de polygones (troisième ligne) sont affichés.

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 attributs pondérées géographiquement des lignes comprises dans un polygone ou des attributs de polygones à l'intérieur d'un polygone. Les statistiques pondérées ne s’appliquent pas aux points compris dans des polygones.

  • Les statistiques standard et les statistiques pondérées géographiquements peuvent être calculées pour des attributs qui représentent des totaux ou des taux. Elles sont définies comme suit :

    • Totaux : attributs qui représentent une somme ou une quantité d'une entité en un point, le long d'une ligne ou à l'intérieur d'un polygone. La population d'un pays, le nombre de courses de taxi dans un ilôt de recensement et le nombre de barrages le long d'une rivière représentent des exemples d'attributs de type totaux. Pour les entités linéaires et surfaciques, les totaux sont proportionnés avant le calcul des statistiques standard ou pondérées.
    • Taux : attributs qui représentent un ratio ou un index en un point, le long d'une ligne ou à l'intérieur d'un polygone. La densité de population d'un pays, la vitesse limite d'une route ou le score de potentiel piétonnier d'un voisinage représentent des exemples d'attributs de type taux. Les taux ne sont jamais proportionnés.

    Pour les attributs de type totaux, les valeurs sont proportionnées en fonction du montant de la ligne à l'intérieur d'un polygone ou du montant du polygone à l'intérieur d'un autre polygone avant le calcul des statistiques. Les statistiques sont calculées de la même manière pour les attributs de type totaux et les attributs de type taux si les entités de synthèse sont des points.

  • 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éeDescriptionOption

    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
  • 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. Trois statistiques pondérées sont calculées dans les champs numériques de la couche à synthétiser : moyenne, é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é.

  • Dans ArcGIS Enterprise 10.6.1 et les versions ultérieures, vous pouvez calculer un groupe à l'aide du paramètre Grouper par champ. Cela crée une sortie tabulaire en plus d'une couche surfacique synthétisée.

  • 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é.

  • 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.

    Polygones renvoyés avec les entités ponctuelles
    Les entités ponctuelles et surfaciques en entrée (première image) et les entités surfaciques obtenues (deuxième image) sont affichées.

  • Les champs suivants sont inclus dans les entités surfaciques en sortie :

    Nom du champDescription
    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 champDescription

    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 optimisé par ArcGIS GeoAnalytics Server. L’analyse est réalisée sur GeoAnalytics Server et les résultats sont stockés dans votre contenu dans ArcGIS Enterprise.

  • Lors de l’exécution des outils GeoAnalytics Server, l’analyse est réalisée sur GeoAnalytics Server. Pour des performances optimales, GeoAnalytics Server doit pouvoir accéder aux données via les couches d’entités hébergées sur votre portail ArcGIS Enterprise ou les partages de fichiers Big Data. Les données qui ne sont pas locales pour GeoAnalytics Server sont transférées sur GeoAnalytics Server avant le début de l’analyse. Autrement dit, l’exécution d’un outil prend plus de temps et, dans certains cas, le transfert des données depuis ArcGIS Pro vers GeoAnalytics Server peut échouer. Le seuil d’échec dépend aussi bien des débits du réseau que de la taille et de la complexité des données. Il est recommandé de toujours partager les données ou de créer un partage de fichiers Big Data.

    Pour en savoir plus sur le partage des données dans votre portail.

    En savoir pus sur la création d’un partage de fichiers Big Data via ArcGIS Server Manager

  • 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

ÉtiquetteExplicationType 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 Set
Nom en sortie

Nom du service d'entités surfaciques en sortie contenant les géométries et attributs qui s'intersectent.

String
Polygone ou groupe

Indique si le champ Summarized Layer (Couche synthétisée) est synthétisé par des polygones ou des groupes.

  • PolygoneLa couche synthétisée sera agrégée dans un jeu de données surfaciques.
  • GroupeLa couche synthétisée sera agrégée dans des groupes carrés ou hexagonaux générés lors de l'exécution de l'outil.
String
Type de groupe

Spécifie la forme de groupe qui sera générée pour synthétiser les entités.

  • CarréLa taille du groupe représente la hauteur d'un carré. Il s’agit de l’option par défaut.
  • HexagoneLa taille du groupe représente la hauteur entre deux côtés parallèles.
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 Set
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.

  • Activé : les valeurs des formes de synthèse vont être calculées. Il s’agit de l’option par défaut.
  • Désactivé : les valeurs des formes de synthèse ne seront pas calculées.

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.

  • MètresLes unités de forme sont les mètres.
  • KilomètresLes unités de forme sont les kilomètres.
  • PiedsLes unités de forme sont les pieds.
  • YardsLes unités de forme sont les yards.
  • MilesLes unités de forme sont les miles.
  • AcresLes unités de forme sont les acres.
  • HectaresLes unités de forme sont les hectares.
  • Mètres carrésLes unités de forme sont les mètres carrés.
  • Kilomètres carrésLes unités de forme sont les kilomètres carrés.
  • Pieds carrésLes unités de forme sont les pieds carrés.
  • Yards carrésLes unités de forme sont les yards carrés.
  • Miles carrésLes unités de forme sont les miles carrés.
String
Champs de récapitulation standards
(Facultatif)

Statistiques qui seront calculées sur les champs spécifiés.

Indique si un champ représente un total ou un taux.

  • TotalPour les couches linéaires et surfaciques, les valeurs des champs synthétisés sont proportionnées en fonction des pourcentages des entités de synthèse qui intersectent les polygones de synthèse avant le calcul des statistiques. Les valeurs ne sont pas proportionnées pour les couches ponctuelles.
  • TauxLes valeurs des champs synthétisés ne sont jamais proportionnées. Les valeurs de champ brutes sont utilisées pour calculer les statistiques.
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.

Indique si un champ représente un total ou un taux.

  • MoyenneLa moyenne pondérée de chaque champ est calculée, la pondération appliquée correspondant à la proportion de la couche synthétisée à l'intérieur des polygones.
  • Écart typeL'écart type pondéré de chaque champ est calculé, la pondération appliquée correspondant à la proportion de la couche synthétisée à l'intérieur des polygones.
  • VarianceLa variance pondérée de chaque champ est calculée, la pondération appliquée correspondant à la proportion de la couche synthétisée à l'intérieur des polygones.
  • TotalLes valeurs des champs synthétisés sont proportionnées en fonction des pourcentages des entités synthétisées qui intersectent les polygones de synthèse avant le calcul des statistiques.
  • TauxLes valeurs des champs synthétisés ne sont jamais proportionnées. Les valeurs de champ brutes sont utilisées pour calculer les statistiques.
Value Table
Data store
(Facultatif)

Indique l’instance ArcGIS Data Store dans laquelle la sortie est enregistrée. La valeur par défaut est Stockage de Big Data spatio-temporelles. Tous les résultats stockés dans un répertoire de données Big Data spatio-temporelles seront stockés en WGS84. Les résultats stockés dans un répertoire de données relationnelles conservent leur système de coordonnées.

  • Stockage de Big Data spatio-temporellesLa sortie sera stockée dans un stockage de Big Data spatio-temporelles. Il s’agit de l’option par défaut.
  • Stockage des données relationnellesLa sortie sera stockée dans un data store relationnel.
String
Champ de regroupement
(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é.

  • 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 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.

  • 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 d’entités en sortie

Le nombre synthétisé de points, la longueur des lignes ou la surface des polygones dans chaque polygone.

Feature Set
Synthèse de regroupement

En cas de regroupement par synthèse, l’outil génère une table contenant les statistiques calculées pour chaque groupe unique.

Record Set

arcpy.geoanalytics.SummarizeWithin(summarized_layer, output_name, polygon_or_bin, bin_type, {bin_size}, {summary_polygons}, sum_shape, {shape_units}, {standard_summary_fields}, {weighted_summary_fields}, {data_store}, {group_by_field}, {add_minority_majority}, {add_percentages})
NomExplicationType 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 Set
output_name

Nom du service d'entités surfaciques en sortie contenant les géométries et attributs qui s'intersectent.

String
polygon_or_bin

Indique si le champ summarized_layer est synthétisé par des polygones ou des groupes.

  • POLYGONLa couche synthétisée sera agrégée dans un jeu de données surfaciques.
  • BINLa couche synthétisée sera agrégée dans des groupes carrés ou hexagonaux.
String
bin_type

Spécifie la forme de groupe qui sera générée pour synthétiser les entités.

  • SQUAREbin_size représente la hauteur d'un carré. Il s’agit de l’option par défaut.
  • HEXAGONbin_size représente la hauteur entre deux côtés parallèles.
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 Set
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.

  • ADD_SUMMARYLes valeurs des formes de synthèse vont être calculées. Il s’agit de l’option par défaut.
  • NO_SUMMARYLes valeurs des formes de synthèse ne seront pas calculées.
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.

  • METERSLes unités de forme sont les mètres.
  • KILOMETERSLes unités de forme sont les kilomètres.
  • FEETLes unités de forme sont les pieds.
  • YARDSLes unités de forme sont les yards.
  • MILESLes unités de forme sont les miles.
  • ACRESLes unités de forme sont les acres.
  • HECTARESLes unités de forme sont les hectares.
  • SQUARE_METERSLes unités de forme sont les mètres carrés.
  • SQUARE_KILOMETERSLes unités de forme sont les kilomètres carrés.
  • SQUARE_FEETLes unités de forme sont les pieds carrés.
  • SQUARE_YARDSLes unités de forme sont les yards carrés.
  • SQUARE_MILESLes unités de forme sont les miles carrés.
String
standard_summary_fields
[standard_summary_fields,...]
(Facultatif)

Statistiques qui seront calculées sur les champs spécifiés.

  • COUNT : nombre de valeurs non nulles. Il peut être utilisé sur des champs numériques ou des chaînes. Le nombre de [null, 0, 2] est 2.
  • SUM : somme des valeurs numériques dans un champ. La somme des [null, null, 3] est 3.
  • MEAN : moyenne des valeurs numériques. La moyenne des [0,2, null] est 1.
  • MIN : valeur minimale d’un champ numérique. Le minimum de [0, 2, null] est 0.
  • MAX : valeur maximale d’un champ numérique. La valeur maximale de [0, 2, null] est 2.
  • STDDEV : écart type d’un champ numérique. L’écart type de [1] est null. L’écart type de [null, 1,1,1] est null.
  • VAR : variance d’un champ numérique dans une trace. La variance de [1] est null. La variance de [null, 1,1,1] est null.
  • RANGE : plage d’un champ numérique. Elle est calculée comme la valeur minimale soustraite de la valeur maximale. La plage de [0, null, 1] est 1. La plage de [null, 4] est 0.
  • ANY : exemple de chaîne provenant d’un champ de type chaîne.

Indique si un champ représente un total ou un taux.

  • COUNTPour les couches linéaires et surfaciques, les valeurs des champs synthétisés sont proportionnées en fonction des pourcentages des entités de synthèse qui intersectent les polygones de synthèse avant le calcul des statistiques. Les valeurs ne sont pas proportionnées pour les couches ponctuelles.
  • RATELes valeurs des champs synthétisés ne sont jamais proportionnées. Les valeurs de champ brutes sont utilisées pour calculer les statistiques.
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.

  • MEANLa moyenne pondérée de chaque champ est calculée, la pondération appliquée correspondant à la proportion de la couche synthétisée à l'intérieur des polygones.
  • STDDEVL'écart type pondéré de chaque champ est calculé, la pondération appliquée correspondant à la proportion de la couche synthétisée à l'intérieur des polygones.
  • VARLa variance pondérée de chaque champ est calculée, la pondération appliquée correspondant à la proportion de la couche synthétisée à l'intérieur des polygones.

Indique si un champ représente un total ou un taux.

  • CountLes valeurs des champs synthétisés sont proportionnées en fonction des pourcentages des entités synthétisées qui intersectent les polygones de synthèse avant le calcul des statistiques.
  • RateLes valeurs des champs synthétisés ne sont jamais proportionnées. Les valeurs de champ brutes sont utilisées pour calculer les statistiques.
Value Table
data_store
(Facultatif)

Indique l’instance ArcGIS Data Store dans laquelle la sortie est enregistrée. La valeur par défaut est SPATIOTEMPORAL_DATA_STORE. Tous les résultats stockés dans un répertoire de données Big Data spatio-temporelles seront stockés en WGS84. Les résultats stockés dans un répertoire de données relationnelles conservent leur système de coordonnées.

  • SPATIOTEMPORAL_DATA_STORELa sortie sera stockée dans un stockage de Big Data spatio-temporelles. Il s’agit de l’option par défaut.
  • RELATIONAL_DATA_STORELa sortie sera stockée dans un data store relationnel.
String
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é.

  • 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
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.

  • NO_PERCENTAucun champ de pourcentage n’est ajouté. Il s’agit de l’option par défaut.
  • ADD_PERCENTDes champs de pourcentage sont ajoutés.
Boolean

Sortie obtenue

NomExplicationType de données
output

Le nombre synthétisé de points, la longueur des lignes ou la surface des polygones dans chaque polygone.

Feature Set
group_by_summary

En cas de regroupement par synthèse, l’outil génère une table contenant les statistiques calculées pour chaque groupe unique.

Record Set

Exemple de code

Exemple d’utilisation de l’outil SummarizeWithin (fenêtre Python)

Le script suivant pour la fenêtre Python illustre l’utilisation de la fonction SummarizeWithin.

# Name: SummarizeWithin.py
# Description: Summarize river polylines by counties.
#			
# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
summarizedLayer = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Water/BigDataCatalogServer/Rivers"
summaryPolys = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Boundaries/BigDataCatalogServer/Counties"
summaryStatistics = ["AvgWidth", "MAX", "RATE"]
weighedSummaryStatistics = ["Length", "SUM", "COUNT"]
outFS = 'SummarizedRivers'
dataStore = "SPATIOTEMPORAL_DATA_STORE"

# Run SummarizeWithin
arcpy.geoanalytics.SummarizeWithin(summarizedLayer, outFS, "POLYGON", None, 
                                   None, summaryPolys,"ADD_SUMMARY", 
                                   "KILOMETERS", summaryStatistics, 
                                   weightedSummaryStatistics, dataStore)

Environnements

Cas particuliers

Système de coordonnées en sortie

Système de coordonnées qui sera utilisé pour l'analyse. L’analyse sera réalisée dans le système de coordonnées en entrée, à moins que ce paramètre en spécifie un autre. Pour GeoAnalytics Tools, les résultats finaux sont stockés dans le Spatiotemporal Data Store dans WGS84.

Informations de licence

  • Basic: Nécessite ArcGIS GeoAnalytics Server
  • Standard: Nécessite ArcGIS GeoAnalytics Server
  • Advanced: Nécessite ArcGIS GeoAnalytics Server

Rubriques connexes