Synthétiser - A l'intérieur (Analyse)

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.

Exemples de scénarios avec Synthétiser - A l'intérieur :

  • En prenant une couche de limites de bassin versant et 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.
  • En prenant une couche de parcelles dans un comté et une couche de limites de ville, synthétisez la valeur moyenne des parcelles vacantes au sein de chaque limite de ville.
  • En prenant une couche de comtés et une couche de 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

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, examinez-les à travers la pile et comptabilisez le nombre d’entités de synthèse en entrée comprises dans les polygones en entrée. Vous pouvez non seulement comptabiliser le nombre d'entités, mais également calculer des statistiques simples concernant les attributs des entités de récapitulation 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. Avec l’outil Synthétiser - À l’intérieur, vous pouvez synthétiser des entités dans les polygones existants. L’outil Synthétiser - À proximité vous 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.

  • 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 unique forme un groupe et les statistiques que vous choisissez seront calculées pour chaque valeur unique de Crime_type.

Paramètres

ÉtiquetteExplicationType 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

Les 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, avec de nouveaux attributs supplémentaires pour le nombre de points, la longueur de 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.

  • Activé : tous les polygones en entrée seront copiés dans la classe d'entités en sortie. Il s’agit de l’option par défaut.
  • Désactivé : seuls les polygones en entrée 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 :

  • Somme : la valeur totale de tous les points dans chaque polygone est calculée.
  • Moyenne : la moyenne de tous les points dans chaque polygone est calculée.
  • Min : la valeur la plus petite de tous les points dans chaque polygone est identifiée.
  • Min : la valeur la plus grande de tous les points dans chaque polygone est identifiée.
  • Écart type : l’écart type de tous les points dans chaque polygone est calculé.

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

  • Activé : les attributs de récapitulation de forme sont ajoutés à la classe d’entités en sortie. Il s’agit de l’option par défaut.
  • Désactivé : les attributs de récapitulation de forme ne sont pas ajoutés à la classe d’entités en sortie.
Boolean
Unité de forme
(Facultatif)

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 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ètresL’unité est le mètre.
  • KilomètresL’unité est le kilomètre.
  • PiedsL'unité est le pied.
  • YardsL'unité est le yard.
  • MillesL’unité est le mile.
  • AcresL’unité est l’acre.
  • HectaresL’unité est l’hectare.
  • Mètres carrésL’unité est le mètre carré.
  • Kilomètres carrésL’unité est le kilomètre carré.
  • Pieds carrésL’unité est le pied carré.
  • Yards carrésL’unité est le yard carré.
  • Miles carrésL’unité est le mile carré.
String
Champ de regroupement
(Facultatif)

Champ attributaire issu des entités de récapitulation en entrée, qui est utilisé pour le regroupement. Les entités qui possèdent la même valeur de champ de regroupement seront associées et récapitulées avec d'autres entités dotées de la même valeur de champ de regroupement.

Lorsqu’un champ de regroupement est spécifié, le paramètre Output Grouped Table (Table groupée en sortie) est requis.

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 spécifié la valeur du paramètre Group Field (Champ de regroupement).

  • Désactivé : les champs minoritaires et majoritaires ne sont pas ajoutés à la sortie. Il s’agit de l’option par défaut.
  • Activé : les champs minoritaires et majoritaires sont ajoutés à la sortie.
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 spécifié la valeur du paramètre Group Field (Champ de regroupement).

  • Désactivé : aucun champ attributaire de pourcentage n’est ajouté à la sortie. Il s’agit de l’option par défaut.
  • Activé : un champ attributaire de pourcentage est ajouté à la sortie.
Boolean
Table groupée en sortie
(Facultatif)

Table en sortie qui comprend des champs de récapitulation pour chaque groupe d'entités de récapitulation pour la zone tampon de chaque polygone en entrée.

La table contiendra les champs attributaires suivants :

  • Join_ID— Un ID correspondant à un champ d’ID ajouté à la classe d’entités en sortie
  • Le champ de regroupement
  • Un champ de récapitulation de forme
  • Un champ pour chacun des champs de récapitulation
  • Champ de pourcentage

Ce paramètre est requis lorsque la valeur du paramètre Group Field (Champ de regroupement) est spécifiée.

Table

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})
NomExplicationType 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

Les 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, avec de nouveaux attributs supplémentaires pour le nombre de points, la longueur de 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 contiennent au moins un point en entrée seront copiés dans la classe d’entités en sortie.

  • KEEP_ALLTous les polygones en entrée seront copiés dans la classe d'entités en sortie. Il s’agit de l’option par défaut.
  • ONLY_INTERSECTINGSeuls les polygones en entrée 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 :

  • Somme : la valeur totale de tous les points dans chaque polygone est calculée.
  • Moyenne : la moyenne de tous les points dans chaque polygone est calculée.
  • Min : la valeur la plus petite de tous les points dans chaque polygone est identifiée.
  • Min : la valeur la plus grande de tous les points dans chaque polygone est identifiée.
  • Écart type : l’écart type de tous les points dans chaque polygone est calculé.

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

  • ADD_SHAPE_SUMLes attributs de récapitulation de forme sont ajoutés à la classe d’entités en sortie. Il s’agit de l’option par défaut.
  • NO_SHAPE_SUMLes attributs de récapitulation de forme ne sont pas ajoutés à la classe d’entités en sortie.
Boolean
shape_unit
(Facultatif)

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

  • METERSL’unité est le mètre.
  • KILOMETERSL’unité est le kilomètre.
  • FEETL'unité est le pied.
  • YARDSL'unité est le yard.
  • MILESL’unité est le mile.
  • ACRESL’unité est l’acre.
  • HECTARESL’unité est l’hectare.
  • SQUAREMETERSL’unité est le mètre carré.
  • SQUAREKILOMETERSL’unité est le kilomètre carré.
  • SQUAREFEETL’unité est le pied carré.
  • SQUAREYARDSL’unité est le yard carré.
  • SQUAREMILESL’unité est le mile carré.
String
group_field
(Facultatif)

Champ attributaire issu des entités de récapitulation en entrée, qui est utilisé pour le regroupement. Les entités qui possèdent la même valeur de champ de regroupement seront associées et récapitulées avec d'autres entités dotées de la même valeur de champ de regroupement.

Lorsqu’un champ de regroupement est spécifié, le paramètre out_grouped_table est requis.

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 spécifié la valeur du paramètre group_field.

  • NO_MIN_MAJLes champs minoritaires et majoritaires ne sont pas ajoutés à la sortie. Il s’agit de l’option par défaut.
  • ADD_MIN_MAJLes champs minoritaires et majoritaires sont ajoutés à la sortie.
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 spécifié la valeur du paramètre group_field.

  • NO_PERCENTAucun champ attributaire de pourcentage n’est ajouté à la sortie. Il s’agit de l’option par défaut.
  • ADD_PERCENTUn champ attributaire de pourcentage est ajouté à la sortie.
Boolean
out_group_table
(Facultatif)

Table en sortie qui comprend des champs de récapitulation pour chaque groupe d'entités de récapitulation pour la zone tampon de chaque polygone en entrée.

La table contiendra les champs attributaires suivants :

  • Join_ID— Un ID correspondant à un champ d’ID ajouté à la classe d’entités en sortie
  • Le champ de regroupement
  • Un champ de récapitulation de forme
  • Un champ pour chacun des champs de récapitulation
  • Champ de pourcentage

Ce paramètre est requis lorsque la valeur du paramètre group_field est spécifiée.

Table

Exemple de code

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

Le script de la fenêtre Python ci-après illustre l’utilisation de la fonction SummarizeWithin.

import arcpy
arcpy.env.workspace = 'C:/data/city.gdb'
arcpy.analysis.SummarizeWithin('neighborhoods', 'crimes', 'neighborhood_crimes')
Exemple 2 d'utilisation de l'outil SummarizeWithin (script autonome)

Le script autonome ci-après est un exemple d’utilisation 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)

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes