| Étiquette | Explication | Type de données |
Polygones en entrée | Polygones utilisés pour synthétiser les entités, ou les portions d’entités, dans la couche de synthèse en entrée. | Feature Layer |
Entités de synthèse en entrée | Entités ponctuelles, linéaires ou surfaciques qui seront synthétisées pour chaque polygone au sein des polygones en entrée. | Feature Layer |
Classe d’entités en sortie | Classe d’entités surfaciques en sortie contenant les mêmes géométries et attributs que les polygones en entrée. Cette classe d’entités comporte des attributs supplémentaires pour le nombre de points, la longueur des lignes et la surface des polygones dans chaque polygone en entrée, ainsi que des statistiques sur ces entités. | Feature Class |
Conserver tous les polygones en entrée (Facultatif) | Indique si tous les polygones en entrée ou uniquement ceux qui intersectent ou contiennent au moins une entité de synthèse en entrée seront copiés dans la classe d’entités en sortie.
| Boolean |
Champs de récapitulation (Facultatif) | Liste des noms de champs attributaires émanant des entités de synthèse en entrée, et types de synthèse statistiques qui seront calculés pour ces champs attributaires pour tous les points dans chaque polygone. Les champs de récapitulation doivent être numériques. Les champs de texte ou d’autres types attributaires ne sont pas pris en charge. Voici les types de statistiques :
| Value Table |
Ajouter des attributs de récapitulation de forme (Facultatif) | Indique si les attributs du nombre de points, de la longueur de lignes et de la surface des entités surfaciques synthétisés dans chaque polygone en entrée sont ajoutés à la classe d’entités en sortie.
| Boolean |
Unité de forme (Facultatif) | Indique l’unité qui est utilisée pour calculer les attributs de récapitulation de forme. Si les entités de synthèse en entrée sont des points, aucune unité de forme n’est nécessaire car seul le nombre de points dans 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.
| String |
Champ de regroupement (Facultatif) | Champ attributaire issu des entités de synthèse en entrée et utilisé pour le regroupement. Les entités qui possèdent la même valeur de champ de regroupement seront associées et synthétisées avec d’autres entités dotées de la même valeur de champ de regroupement. Lorsqu’un champ de regroupement est fourni, une valeur est requise pour le paramètre Output Grouped Table (Table groupée en sortie). | Field |
Ajouter des attributs minoritaires et majoritaires (Facultatif) | Indique si des champs minoritaires et majoritaires sont ajoutés à la sortie. Ce paramètre vous permet de déterminer la valeur du champ de regroupement qui est minoritaire (la moins dominante) et majoritaire (la plus dominante), dans chaque polygone en entrée. Ce paramètre est actif si vous avez fourni la valeur du paramètre Group Field (Champ de regroupement).
| Boolean |
Ajouter des pourcentages de regroupement (Facultatif) | Indique si un champ attributaire de pourcentage est ajouté à la sortie. Ce paramètre vous permet de déterminer le pourcentage de chaque valeur attributaire dans chaque groupe. Ce paramètre est actif si vous avez fourni la valeur du paramètre Group Field (Champ de regroupement).
| Boolean |
Table groupée en sortie (Facultatif) | Table en sortie qui comprend des champs de récapitulation pour chaque groupe d’entités de synthèse de chaque polygone en entrée. La table contiendra les champs attributaires suivants :
Ce paramètre est requis lorsque la valeur du paramètre Group Field (Champ de regroupement) est fournie. | Table |
Synthèse
Superpose une couche surfacique avec une autre couche en vue de synthétiser le nombre de points, la longueur des lignes ou la surface des polygones dans chaque polygone, et calcule des statistiques des champs attributaires sur les entités dans les polygones.
Vous trouverez ci-dessous des exemples de scénarios mettant en jeu l’outil Synthétiser - À l’intérieur :
- À partir d’une couche de limites de bassins versants et d’une couche de 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.
- À partir d’une couche de parcelles dans un comté et d’une couche de limites de ville, synthétisez la valeur moyenne des parcelles vacantes au sein de chaque limite de ville.
- À partir d’une couche de comtés et d’une couche de routes, synthétisez le kilométrage total des routes par type de route dans chaque comté.
Illustration
Utilisation
Pour comprendre la fonction de l’outil Synthétiser - À l’intérieur, imaginez que vous prenez deux couches, les polygones en entrée et les entités de synthèse en entrée, et que vous les empilez 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, tels que la somme, la moyenne, le minimum, le maximum, etc.
Les outils Synthétiser - À l’intérieur et Synthétiser - À proximité sont conceptuellement similaires. En utilisant l’outil Summarize Within (Synthétiser - À l’intérieur), vous pouvez synthétiser des entités dans les polygones existants. L’outil Summarize Nearby (Synthétiser - À proximité) permet quant à lui, de générer des zones autour de points, de lignes ou de polygones et de synthétiser des entités dans ces zones dérivées.
Les entités de synthèse surfaciques sont synthétisées proportionnellement à la surface des entités en entrée. Prenez l’exemple d’un polygone en entrée qui chevauche un polygone de synthèse sur un kilomètre carré. Si le polygone de synthèse fait 100 kilomètres carrés, l’outil synthétise un centième (1/100) de ses valeurs numériques. Pour garantir la validité des calculs proportionnels, utilisez des champs avec des totaux et des quantités (et non des taux ou des ratios).
Vous pouvez créer des groupes en spécifiant un champ de groupe à partir des points en entrée. Par exemple, si vous synthétisez des crimes dans les limites du voisinage, il peut exister un attribut Crime_type associé à cinq types de crime différents. Chaque type de crime forme un groupe et les statistiques que vous choisissez seront calculées pour chaque valeur unique de Crime_type.
Les valeurs nulles sont exclues de tous les calculs statistiques. Par exemple, la moyenne de 10, 5 et d’une valeur nulle est 7,5 ((10 + 5)/2).
Paramètres
arcpy.analysis.SummarizeWithin(in_polygons, in_sum_features, out_feature_class, {keep_all_polygons}, {sum_fields}, {sum_shape}, {shape_unit}, {group_field}, {add_min_maj}, {add_group_percent}, {out_group_table})| Nom | Explication | Type de données |
in_polygons | Polygones utilisés pour synthétiser les entités, ou les portions d’entités, dans la couche de synthèse en entrée. | Feature Layer |
in_sum_features | Entités ponctuelles, linéaires ou surfaciques qui seront synthétisées pour chaque polygone au sein des polygones en entrée. | Feature Layer |
out_feature_class | Classe d’entités surfaciques en sortie contenant les mêmes géométries et attributs que les polygones en entrée. Cette classe d’entités comporte des attributs supplémentaires pour le nombre de points, la longueur des lignes et la surface des polygones dans chaque polygone en entrée, ainsi que des statistiques sur ces entités. | Feature Class |
keep_all_polygons (Facultatif) | Indique si tous les polygones en entrée ou uniquement ceux qui intersectent ou contiennent au moins une entité de synthèse en entrée seront copiés dans la classe d’entités en sortie.
| Boolean |
sum_fields [[summary_field, statistic_type],...] (Facultatif) | Liste des noms de champs attributaires émanant des entités de synthèse en entrée, et types de synthèse statistiques qui seront calculés pour ces champs attributaires pour tous les points dans chaque polygone. Les champs de récapitulation doivent être numériques. Les champs de texte ou d’autres types attributaires ne sont pas pris en charge. Voici les types de statistiques :
| Value Table |
sum_shape (Facultatif) | Indique si les attributs du nombre de points, de la longueur de lignes et de la surface des entités surfaciques synthétisés dans chaque polygone en entrée sont ajoutés à la classe d’entités en sortie.
| Boolean |
shape_unit (Facultatif) | Indique l’unité qui est utilisée pour calculer les attributs de récapitulation de forme. Si les entités de synthèse en entrée sont des points, aucune unité de forme n’est nécessaire car seul le nombre de points dans 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.
| String |
group_field (Facultatif) | Champ attributaire issu des entités de synthèse en entrée et utilisé pour le regroupement. Les entités qui possèdent la même valeur de champ de regroupement seront associées et synthétisées avec d’autres entités dotées de la même valeur de champ de regroupement. Lorsqu’un champ de regroupement est fourni, une valeur est requise pour le paramètre out_grouped_table. | Field |
add_min_maj (Facultatif) | Indique si des champs minoritaires et majoritaires sont ajoutés à la sortie. Ce paramètre vous permet de déterminer la valeur du champ de regroupement qui est minoritaire (la moins dominante) et majoritaire (la plus dominante), dans chaque polygone en entrée. Ce paramètre est activé si vous avez fourni la valeur du paramètre group_field.
| Boolean |
add_group_percent (Facultatif) | Indique si un champ attributaire de pourcentage est ajouté à la sortie. Ce paramètre vous permet de déterminer le pourcentage de chaque valeur attributaire dans chaque groupe. Ce paramètre est activé si vous avez fourni la valeur du paramètre group_field.
| Boolean |
out_group_table (Facultatif) | Table en sortie qui comprend des champs de récapitulation pour chaque groupe d’entités de synthèse de chaque polygone en entrée. La table contiendra les champs attributaires suivants :
Ce paramètre est requis lorsque la valeur du paramètre group_field est fournie. | Table |
Exemple de code
Le script de fenêtre Python suivant illustre l’utilisation de la fonction SummarizeWithin.
import arcpy
arcpy.env.workspace = 'C:/data/city.gdb'
arcpy.analysis.SummarizeWithin('neighborhoods', 'crimes', 'neighborhood_crimes')Le script autonome suivant est un exemple d’utilisation simple de la fonction SummarizeWithin dans un environnement de scripts.
# Description: Use SummarizeWithin to summarize the crimes in each city neighborhood
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = 'C:/data/city.gdb'
# Set local variables
polys = 'neighborhoods'
points = 'crimes'
outFeatureClass = 'crimes_aggregated'
keepAll = 'KEEP_ALL'
sumFields = [['Damages', 'SUM'], ['VICTIM_AGE', 'MEAN']]
addShapeSum = 'ADD_SHAPE_SUM'
groupField = 'Crime_type'
addMinMaj = 'ADD_MIN_MAJ'
addPercents = 'ADD_PERCENT'
outTable = 'crimes_aggregated_groups'
arcpy.analysis.SummarizeWithin(polys, points, outFeatureClass, keepAll,
sumFields, addShapeSum, '', groupField,
addMinMaj, addPercents, outTable)Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?