Synthétiser - A l’intérieur (Analyse d'entités standard)

Résumé

Recherche les entités ponctuelles, linéaires ou surfaciques (ou des parties de ces entités) comprises dans les limites des polygones d'une autre couche.

Par exemple

  • 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 - A l'intérieur

Utilisation

  • Pour appréhender l'outil Synthétiser - A l'intérieur, imaginez que vous prenez deux couches et que vous les empilez l'une par dessus l'autre. Imaginez que les entités de l'une des couches, la couche de polygones en entrée, sont toutes en rouge. L'autre couche, les entités de synthèse en entrée, peut avoir un type d'entité quelconque, ponctuel, linéaire ou surfacique. Après avoir empilé ces couches, examinez-les à travers la pile et comptabilisez le nombre d'entités dans la couche d'entités de synthèse en entrée qui figurent dans les polygones aux limites rouges (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 la couche d'entités de synthèse en entrée, telles que la somme, la moyenne, le minimum, le maximum, etc.

Paramètres

ÉtiquetteExplicationType de données
Polygones en entrée

Les entités, ou parties d'entités, parmi les entités de synthèse en entrée qui sont comprises dans les limites de ces polygones, seront synthétisées.

Feature Set
Entités de synthèse en entrée

Les entités ponctuelles, linéaires ou surfaciques qui seront synthétisées pour chaque polygone en entrée.

Feature Set
Nom en sortie

Nom de la couche en sortie à créer sur votre portail.

String
Ajouter des attributs de récapitulation de forme
(Facultatif)

Calculez des statistiques basées sur la forme des entités de synthèse en entrée, telles que la longueur des lignes ou les surfaces des polygones des entités de synthèse en entrée comprises dans chaque polygone en entrée.

  • Activé : calcule les attributs de synthèse de forme. Il s’agit de l’option par défaut.
  • Désactivé : ne calcule pas les attributs de synthèse de forme.

Boolean
Unité de forme
(Facultatif)

Si vous synthétisez la forme des entités de synthèse en entrée, spécifiez les unités de la synthèse de forme.

  • Milles —Milles
  • Pieds —Pieds
  • Kilomètres —Kilomètres
  • Mètres —Mètres
  • Yards —Yards
  • Ares —Ares
  • Hectares —Hectares
  • Mètres carrés —Mètres carrés
  • Kilomètres carrés —Kilomètres carrés
  • Pieds carrés —Pieds carrés
  • Yards carrés —Yards carrés
  • Miles carrés —Miles carrés
String
Champs de récapitulation
(Facultatif)

Liste des noms de champs et de type de résumé statistique que vous souhaitez calculer pour tous les points de chaque polygone. Le nombre de points figurant dans chaque polygone est toujours renvoyé. Les types de statistiques suivants sont pris en charge :

  • Somme : valeur totale.
  • Minimum : valeur la plus faible.
  • Max : Valeur la plus élevée.
  • Moyenne : moyenne ou valeur moyenne.
  • Ecart type : écart type.

Value Table
Grouper par champ
(Facultatif)

Il s'agit d'un champ issu des entités de synthèse en entrée, qui permet de calculer les statistiques séparément 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 marchandises dangereuses, et qu’un des champs, HazardClass, contient des codes qui décrivent le type de marchandises 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)

Cela s'applique uniquement lorsque vous utilisez un champ de regroupement. Si cette option est sélectionnée, les valeurs attributaires minoritaires (les moins dominantes) et majoritaires (les plus dominantes) de chaque champ de regroupement au sein de chaque limite sont calculées. Deux nouveaux champs sont ajoutés à la couche en sortie et associés aux préfixes Majority_ et Minority_.

  • Désactivé : n'ajoute pas de champs minoritaires et majoritaires. Il s’agit de l’option par défaut.
  • Activé : ajoute des champs minoritaires et majoritaires.

Boolean
Ajouter des pourcentages de regroupement
(Facultatif)

Cela s'applique uniquement lorsque vous utilisez un champ de regroupement. Si ce paramètre est activé, le pourcentage de chaque valeur de regroupement unique est calculé pour chaque polygone en entrée.

  • Désactivé : n'ajoute pas de champs de pourcentage. Il s’agit de l’option par défaut.
  • Activé : ajoute des champs de pourcentage.

Boolean

Sortie dérivée

ÉtiquetteExplicationType de données
Service d'entités en sortie

Couche synthétisée en sortie.

Jeu d'entités
Table de regroupement en sortie

Si un champ de regroupement a été fourni, l'outil génère une table qui contient les statistiques calculées pour chaque groupe unique.

Jeu d'enregistrements

arcpy.sfa.SummarizeWithin(sumWithinLayer, summaryLayer, outputName, {sumShape}, {shapeUnits}, {summaryFields}, {groupByField}, {minorityMajority}, {percentShape})
NomExplicationType de données
sumWithinLayer

Les entités, ou parties d'entités, parmi les entités de synthèse en entrée qui sont comprises dans les limites de ces polygones, seront synthétisées.

Feature Set
summaryLayer

Les entités ponctuelles, linéaires ou surfaciques qui seront synthétisées pour chaque polygone en entrée.

Feature Set
outputName

Nom de la couche en sortie à créer sur votre portail.

String
sumShape
(Facultatif)

Calculez des statistiques basées sur la forme des entités de synthèse en entrée, telles que la longueur des lignes ou les surfaces des polygones des entités de synthèse en entrée comprises dans chaque polygone en entrée.

  • ADD_SHAPE_SUMCalculez les attributs de synthèse de forme. Il s’agit de l’option par défaut.
  • NO_SHAPE_SUMNe calculez pas les attributs de synthèse de forme.
Boolean
shapeUnits
(Facultatif)

Si vous synthétisez la forme des entités de synthèse en entrée, spécifiez les unités de la synthèse de forme.

Lorsque les entités de synthèse en entrée sont des polygones, les options valides sont les acres, les hectares, les mètres carrés, les kilomètres carrés, les pieds carrés, les yards carrés et les milles carrés.

Lorsque les entités de synthèse en entrée sont des lignes, les options valides sont les mètres, les kilomètres, les pieds, les yards et les milles.

  • MILESMilles
  • FEETPieds
  • KILOMETERSKilomètres
  • METERSMètres
  • YARDSYards
  • ACRESAres
  • HECTARESHectares
  • SQUAREMETERSMètres carrés
  • SQUAREKILOMETERSKilomètres carrés
  • SQUAREFEETPieds carrés
  • SQUAREYARDSYards carrés
  • SQUAREMILESMiles carrés
String
summaryFields
[[Field, Statistic],...]
(Facultatif)

Liste des noms de champs et de type de résumé statistique que vous souhaitez calculer pour tous les points de chaque polygone. Le nombre de points figurant dans chaque polygone est toujours renvoyé. Les types de statistiques suivants sont pris en charge :

  • SUM : valeur totale.
  • MIN : valeur la plus faible.
  • MAX : valeur la plus élevée.
  • MEAN : moyenne ou valeur moyenne.
  • STD : écart type.

Value Table
groupByField
(Facultatif)

Il s'agit d'un champ issu des entités de synthèse en entrée, qui permet de calculer les statistiques séparément 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 marchandises dangereuses, et qu’un des champs, HazardClass, contient des codes qui décrivent le type de marchandises dangereuses stockées. Pour calculer des synthèses pour chaque valeur unique de HazardClass, utilisez ce champ comme champ de regroupement.

Field
minorityMajority
(Facultatif)

Cela s'applique uniquement lorsque vous utilisez un champ de regroupement. Si vous spécifiez ADD_MIN_MAJ, les valeurs attributaires minoritaires (les moins dominantes) et majoritaires (les plus dominantes) de chaque champ de regroupement au sein de chaque limite sont calculées. Deux nouveaux champs sont ajoutés à la couche en sortie et associés aux préfixes Majority_ et Minority_.

  • NO_MIN_MAJN'ajoutez pas de champs minoritaires et majoritaires. Il s’agit de l’option par défaut.
  • ADD_MIN_MAJAjoutez des champs minoritaires et majoritaires.
Boolean
percentShape
(Facultatif)

Cela s'applique uniquement lorsque vous utilisez un champ de regroupement. Si ce paramètre est activé, le pourcentage de chaque valeur de regroupement unique est calculé pour chaque polygone en entrée.

  • NO_PERCENTN'ajoutez pas de champs de pourcentage. Il s’agit de l’option par défaut.
  • ADD_PERCENTAjoutez des champs de pourcentage.
Boolean

Sortie dérivée

NomExplicationType de données
outputLayer

Couche synthétisée en sortie.

Jeu d'entités
groupBySummaryLayer

Si un champ de regroupement a été fourni, l'outil génère une table qui contient les statistiques calculées pour chaque groupe unique.

Jeu d'enregistrements

Environnements

Rubriques connexes