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

Résumé

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 Summarize Within (Synthétiser - À l’intérieur) :

À 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

![Summarize Within tool illustration] (images/Schematics_SummarizeWithin-71F31.png)

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 Summarize Within (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 les unes sur les autres. Vous pouvez les visualiser à 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, tels que la somme, la moyenne, le minimum, le maximum, etc.
L’outil Summarize Within (Synthétiser - À l’intérieur) permet de 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 :
- Counts—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.
- Rates—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ée	Description	Option
Points	Nombre de points synthétisés au sein de chaque polygone	Aucune
Lignes	Longueur des lignes synthétisées au sein de chaque polygone	Statute Miles (Milles terrestres) International Yards (Yards internationaux) International Feet (Pieds internationaux) US Survey Miles (Miles d’arpentage américains) US Survey Yards (Yards d’arpentage américains) US Survey Feet (Pieds d’arpentage américains) Kilometers (Kilomètres) Meters (Mètres)
Surfaces	Aire des polygones synthétisés au sein de chaque polygone	Square Statute Miles (Milles terrestres carrés) Square International Yards (Yards internationaux carrés) Square International Feet (Pieds internationaux carrés) Square Kilometers (Kilomètres carrés) Square Meters (Mètres carrés) Hectares International Acres (Acres internationales) Square US Survey Miles (Miles d’arpentage américains carrés) Square US Survey Yards (Yards d’arpentage américains carrés) Square US Survey Feet (Pieds d’arpentage américains carrés) US Survey Acres (Acres d’arpentage américaines)

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 la valeur de paramètre Summarized Layer (Couche synthétisée) qui intersectent la couche Summary Polygons (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 la valeur de paramètre Summary Polygons (Polygones de synthèse) qui intersectent chaque entité dans la valeur de paramètre Summarized Layer (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 Field (Champ) et Statistic (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 Summary Polygons (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 fournir une valeur Group By Field (Champ de regroupement) pour que les statistiques soient calculées séparément pour chaque valeur attributaire unique. Si une valeur Group By Field (Champ de regroupement) est fournie, un tableau récapitulatif présentant chaque entité et statistique par valeur Group By Field (Champ de regroupement) est créé.
Les paramètres Add Minority and Majority Attributes (Ajouter des attributs minoritaires et majoritaires) et Add Group Percentages (Ajouter des pourcentages de regroupement) sont disponibles si une valeur Group By Field (Champ de regroupement) est fournie. La minorité et la majorité correspondent, respectivement, à la valeur la moins dominante et à la valeur la plus dominante du paramètre Group By Field (Champ de regroupement), la dominance étant déterminée à partir du nombre de points, de la longueur totale ou de la surface totale de chaque valeur.
Si 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. Ces champs répertorient les valeurs du paramètre Group By Field (Champ de regroupement) qui constituent la minorité et la majorité de chaque entité de résultat.
Le paramètre Add Group Percentages (Ajouter des pourcentages de regroupement) est disponible uniquement si le paramètre Add Minority and Majority Attributes (Ajouter des attributs minoritaires et majoritaires) est sélectionné. Si 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 pour répertorier le pourcentage du nombre de points, la longueur totale ou la surface totale appartenant à toutes les valeurs du paramètre Group By Field (Champ de regroupement) 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.

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 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 Add shape summary attributes (Ajouter des attributs de récapitulation de forme) est sélectionnée.
`statistic_<fieldname>`	Les statistiques spécifiées créent chacune un champ attributaire, dont le nom se présente au format suivant : <statistic>_<fieldname>. Par exemple, l’écart maximal et l’écart type du champ `id` sont respectivement `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<statistic>_<fieldname>. Par exemple, la valeur maximale pondérée du champ `id` est `pMAX_id`.
`minority_<fieldname>`	Cette valeur est renvoyée lors de la création d’une table de regroupement et lorsque l’option Add Minority and Majority Attributes (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 si vous créez une table de regroupement et que l’option Add Minority and Majority Attributes (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 `majority_color` est bleu\vert.
`minority_<fieldname>_percent`	Cette valeur est renvoyée si vous créez une table de regroupement et que l’option Add Group Percentages (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 si vous créez une table de regroupement et que l’option Add Group Percentages (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 si 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 surfacique. 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>`	Toute statistique spécifiée calculée pour chaque groupe.
`p<statistic>_<fieldname>`	Toute 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 Summarize Within (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 performances de grands groupes sont meilleures que celles de petits groupes. 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 d’exécution de l’analyse.
Cet outil de géotraitement est optimisé 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 serveur ArcGIS GeoAnalytics Server en vue d’une analyse, reportez-vous à la rubrique Outils GeoAnalytics.
Une analyse semblable peut également être réalisée à l’aide de l’outil Summarize Within (Synthétiser - À l’intérieur) de la boîte à outils Standard Feature Analysis (Analyse d’entités standard) dans ArcGIS Pro.

Etiqueter	Explication	Type de données
Summarized Layer (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
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 la valeur Summarized Layer (Couche synthétisée) est synthétisée par des polygones ou des groupes. Polygone—La couche synthétisée sera agrégée dans un jeu de données surfaciques. Groupe—La 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 valeur Bin Size (Taille du groupe) représente la hauteur d’un carré. Il s’agit de l’option par défaut. Hexagone—La valeur Bin Size (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 sont synthétisées.	Linear Unit
Polygones de synthèse (Facultatif)	Polygones qui seront utilisés pour synthétiser les entités dans la couche synthétisée en entrée.	Feature Layer
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écoché—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 synthèse en entrée sont des lignes, spécifiez une unité linéaire. Si les entités de synthèse en entrée sont des polygones, spécifiez une unité surfacique. Mètres—Les unités de forme sont les mètres d’arpentage américains. Kilomètres—Les unités de forme sont les kilomètres d’arpentage américains. Pieds d’arpentage américains—Les unités de forme sont les pieds d’arpentage américains. Yards d’arpentage américains—Les unités de forme sont les yards d’arpentage américains. Milles d’arpentage américains—Les unités de forme sont les milles d’arpentage américains. Milles nautiques d’arpentage américains—Les unités de forme sont les milles nautiques d’arpentage américains. Pied international—Les unités de forme sont les pieds internationaux. Yards internationaux—Les unités de forme sont les yards internationaux. Milles terrestres—Les unités de forme sont les milles terrestres. Milles nautiques internationaux—Les unités de forme sont les milles nautiques internationaux. Acres internationales—Les unités de forme sont les acres internationales. Hectares—Les unités de forme sont les hectares. Mètres carrés—Les unités de forme sont les mètres carrés. Kilomètres carrés—Les unités de forme sont les kilomètres carrés. Pieds internationaux carrés—Les unités de forme sont les pieds internationaux carrés. Yards internationaux carrés—Les unités de forme sont les yards internationaux carrés. Milles terrestres carrés—Les unités de forme sont les milles terrestres carrés. Pieds d’arpentage américains carrés—Les unités de forme sont les pieds d’arpentage américains carrés. Yards d’arpentage américains carrés—Les unités de forme sont les yards d’arpentage américains carrés. Milles d’arpentage américains carrés—Les unités de forme sont les milles d’arpentage américains carrés. Acres d’arpentage américaines—Les unités de forme sont les acres d’arpentage américaines.	String
Champs de synthèse standards (Facultatif)	Statistiques qui seront calculées sur les champs spécifiés. Colonnes de la table de valeurs : Le champ—Champs dans lesquels les statistiques vont être calculées. Statistiques—Statistiques qui seront calculées sur les champs spécifiés. Effectif—Nombre de valeurs non nulles. Peut être utilisé sur des champs numériques ou des chaînes. Le total de [Null, 0, 2] est égal à 2. Somme—Somme des valeurs numériques dans un champ. La somme de [Null, 0, 3] est égale à 3. Moyenne—Moyenne des valeurs numériques. La moyenne de [0,2, Null] est égale à 1. Minimum—Valeur minimale d’un champ numérique. La valeur minimale de [0, 2, Null] est égale à 0. Maximum—Valeur maximale d’un champ numérique. La valeur maximale de [0, 2, Null] est égale à 2. Écart type—Écart type d’un champ numérique. L'écart type de [1] est la valeur Null. L’écart type de [null, 1,1,1] est nul. Variance—Variance d’un champ numérique dans une piste. La variance de [1] est la valeur nulle. La variance de [null, 1,1,1] est nulle. Plage—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 égale à 1. La plage de [Null, 4] est égale à 0. Tout—Exemple de chaîne provenant d’un champ de type chaîne. Type de quantité—Indique si un champ représente un total ou un taux. Effectif—Pour 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. Taux—Les valeurs des champs synthétisés ne sont pas 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. Colonnes de la table de valeurs : Le champ—Spécifie les statistiques pondérées qui seront calculées sur les champs spécifiés. Statistiques—Spécifie les statistiques pondérées qui seront calculées sur les champs spécifiés. Moyenne—La 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 type—L'é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. Variance—La 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. Type de quantité—Indique si un champ représente un total ou un taux. Effectif—Les 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. Taux—Les valeurs des champs synthétisés ne sont pas proportionnées. Les valeurs de champ brutes sont utilisées pour calculer les statistiques.	Value Table
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 par 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. Si ce paramètre est activé, deux nouveaux champs sont ajoutés à la couche en sortie avec les préfixes Majority_ et Minority_. Ce paramètre s’applique uniquement si une valeur est fournie pour le paramètre Group By Field (Champ de regroupement). Activé—Les champs minoritaires et majoritaires sont ajoutés. Décoché—Les champs minoritaires et majoritaires ne sont pas ajoutés. Il s’agit de l’option par défaut.	Boolean
Ajouter des pourcentages de regroupement (Facultatif)	Indique si des champs de pourcentage sont ajoutés. Lorsque ce paramètre est activé, le pourcentage de chaque valeur de regroupement unique est calculé pour chaque polygone en entrée. Ce paramètre s’applique uniquement si une valeur est fournie pour le paramètre Group By Field (Champ de regroupement) et qu’une valeur est spécifiée pour le paramètre Add Minority and Majority Attributes (Ajouter des attributs minoritaires et majoritaires). Activé—Des champs de pourcentage sont ajoutés. Décoché—Aucun champ de pourcentage n’est ajouté. Il s’agit de l’option par défaut.	Boolean
Table de synthèse de regroupement (Facultatif)	Table en sortie qui contient les synthèses de regroupement.	Table

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 la valeur `summarized_layer` est synthétisée par des polygones ou des groupes. `POLYGON`—La couche synthétisée sera agrégée dans un jeu de données surfaciques. `BIN`—La 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. `SQUARE`—La valeur `bin_size` représente la hauteur d’un carré. Il s’agit de l’option par défaut. `HEXAGON`—La valeur `bin_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 sont synthétisées.	Linear Unit
summary_polygons (Facultatif)	Polygones qui seront 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. `ADD_SUMMARY`—Les valeurs des formes de synthèse vont être calculées. Il s’agit de l’option par défaut. `NO_SUMMARY`—Les 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 synthèse en entrée sont des lignes, spécifiez une unité linéaire. Si les entités de synthèse en entrée sont des polygones, spécifiez une unité surfacique. `METERS`—Les unités de forme sont les mètres. `KILOMETERS`—Les unités de forme sont les kilomètres. `FEET`—Les unités de forme sont les pieds d’arpentage américains. `YARDS`—Les unités de forme sont les yards d’arpentage américains. `MILES`—Les unités de forme sont les milles d’arpentage américains. `NAUTICAL_MILES`—Les unités de forme sont les milles nautiques d’arpentage américains. `FEET_INT`—Les unités de forme sont les pieds internationaux. `YARDS_INT`—Les unités de forme sont les yards internationaux. `MILES_INT`—Les unités de forme sont les milles terrestres. `NAUTICAL_MILES_INT`—Les unités de forme sont les milles nautiques internationaux. `ACRES`—Les unités de forme sont les acres internationales. `HECTARES`—Les unités de forme sont les hectares. `SQUARE_METERS`—Les unités de forme sont les mètres carrés. `SQUARE_KILOMETERS`—Les unités de forme sont les kilomètres carrés. `SQUARE_FEET`—Les unités de forme sont les pieds internationaux carrés. `SQUARE_YARDS`—Les unités de forme sont les yards internationaux carrés. `SQUARE_MILES`—Les unités de forme sont les milles terrestres carrés. `SQUARE_FEET_US`—Les unités de forme sont les pieds d’arpentage américains carrés. `SQUARE_YARDS_US`—Les unités de forme sont les yards d’arpentage américains carrés. `SQUARE_MILES_US`—Les unités de forme sont les milles d’arpentage américains carrés. `ACRES_US`—Les unités de forme sont les acres d’arpentage américaines.	String
standard_summary_fields [[Field, Statistic, Quantity Type],...] (Facultatif)	Statistiques qui seront calculées sur les champs spécifiés. Colonnes de la table de valeurs : `Field`—Champs dans lesquels les statistiques vont être calculées. `Statistics`—Statistiques qui seront calculées sur les champs spécifiés. `COUNT`—Nombre de valeurs non nulles. Peut être utilisé sur des champs numériques ou des chaînes. Le total de [Null, 0, 2] est égal à 2. `SUM`—Somme des valeurs numériques dans un champ. La somme de [Null, 0, 3] est égale à 3. `MEAN`—Moyenne des valeurs numériques. La moyenne de [0,2, Null] est égale à 1. `MIN`—Valeur minimale d’un champ numérique. La valeur minimale de [0, 2, Null] est égale à 0. `MAX`—Valeur maximale d’un champ numérique. La valeur maximale de [0, 2, Null] est égale à 2. `STDDEV`—Écart type d’un champ numérique. L'écart type de [1] est la valeur Null. L’écart type de [null, 1,1,1] est nul. `VAR`—Variance d’un champ numérique dans une piste. La variance de [1] est la valeur nulle. La variance de [null, 1,1,1] est nulle. `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 égale à 1. La plage de [Null, 4] est égale à 0. `ANY`—Exemple de chaîne provenant d’un champ de type chaîne. `Quantity Type`—Indique si un champ représente un total ou un taux. `Count`—Pour 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. `Rate`—Les valeurs des champs synthétisés ne sont pas proportionnées. Les valeurs de champ brutes sont utilisées pour calculer les statistiques.	Value Table
weighted_summary_fields [[Field, Statistic, Quantity Type],...] (Facultatif)	Spécifie les statistiques pondérées qui seront calculées sur les champs spécifiés. Colonnes de la table de valeurs : `Field`—Spécifie les statistiques pondérées qui seront calculées sur les champs spécifiés. `Statistics`—Spécifie les statistiques pondérées qui seront calculées sur les champs spécifiés. `MEAN`—La 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. `STDDEV`—L'é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. `VAR`—La 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. `Quantity Type`—Indique si un champ représente un total ou un taux. `Count`—Les 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. `Rate`—Les valeurs des champs synthétisés ne sont pas proportionnées. Les valeurs de champ brutes sont utilisées pour calculer les statistiques.	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 par 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. Si la valeur de ce paramètre est `ADD_MIN_MAJ`, deux nouveaux champs sont ajoutés à la couche en sortie avec les préfixes Majority_ et Minority_. Ce paramètre s’applique uniquement si une valeur est fournie pour le paramètre `group_by_field`. `ADD_MIN_MAJ`—Les champs minoritaires et majoritaires sont ajoutés. `NO_MIN_MAJ`—Les champs minoritaires et majoritaires ne sont pas ajoutés. Il s’agit de l’option par défaut.	Boolean
add_percentages (Facultatif)	Indique si des champs de pourcentage sont ajoutés. Si la valeur de ce paramètre est `ADD_PERCENT`, le pourcentage de chaque valeur de regroupement unique est calculé pour chaque polygone en entrée. Ce paramètre s’applique uniquement si une valeur est fournie pour le paramètre `group_by_field` et qu’une valeur est spécifiée pour le paramètre `add_minority_majority`. `ADD_PERCENT`—Des champs de pourcentage sont ajoutés. `NO_PERCENT`—Aucun champ de pourcentage n’est ajouté. Il s’agit de l’option par défaut.	Boolean
group_by_summary (Facultatif)	Table en sortie qui contient les synthèses de regroupement.	Table

Exemple de code

Exemple d’utilisation de la fonction SummarizeWithin (fenêtre Python)

Le script de la fenêtre Python ci-après 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", "RATE"]]
weightedSummaryStatistics = [["DOC", "STDDEV", "COUNT"]]
out = 'SummarizedRivers'

# Run SummarizeWithin
arcpy.gapro.SummarizeWithin(summarizedLayer, out, "POLYGON", None,
                            None, summaryPolys, "ADD_SUMMARY",
                            "KILOMETERS", summaryStatistics,
                            weightedSummaryStatistics)

Environnements

Système de coordonnées en sortie, Etendue, Espace de travail courant

Informations de licence

Basic: Non
Standard: Non
Advanced: Oui

[Vue d’ensemble du jeu d’outils Summarize Data (Synthétiser les données)] (an-overview-of-the-summarize-data-toolset.md)
Remarques sur les outils GeoAnalytics Desktop
Rechercher un outil de géotraitement