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

Synthèse

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

Cet outil peut par exemple s’utiliser dans les scénarios suivants :

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

Utilisation

• Pour appréhender cet outil, imaginez que vous prenez deux couches et que vous les empilez l’une par-dessus l’autre. Par exemple, 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, vous les examinez à 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

Boîte de dialogue

Étiquette	Explication	Type de données
Polygones en entrée	Les entités, ou parties d’entités, de la valeur du paramètre 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)	Indique si les statistiques sont calculées en fonction de la forme de la valeur du paramètre 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é : les statistiques sont calculées en fonction des attributs de récapitulation de forme. Il s’agit de l’option par défaut. Désactivé : les statistiques ne sont pas calculées en fonction des attributs de récapitulation de forme.	Boolean
Unité de forme (Facultatif)	Indique l’unité qui est utilisée pour la récapitulation 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 miles, les pieds, les mètres et les yards. Miles—L’unité est le mile. Pieds—L’unité est le pied. Kilomètres—L’unité est le kilomètre Mètres—L’unité est le mètre. Yards—L’unité est le yard. Acres—L’unité est l’acre. Hectares—L’unité est l’hectare. Mètres carrés—L’unité est le mètre carré. Kilomètres carrés—L’unité est le kilomètre carré. Pieds carrés—L’unité est le pied carré. Yards carrés—L’unité est le yard carré. Miles carrés—L’unité est le mile carré.	String
Champs de récapitulation (Facultatif)	Liste des noms de champs et de type de résumé statistique à 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 : la valeur totale est calculée. Minimum : la valeur la plus faible est identifiée. Max : la valeur la plus élevée est identifiée. Moyenne : la moyenne ou valeur moyenne est calculée. Écart type : la valeur de l’écart type est calculée.	Value Table
Champ de regroupement (Facultatif)	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 la valeur du paramètre Entités de synthèse en entrée contienne des emplacements de points d’entreprises qui stockent des matières dangereuses et que le champ HazardClass contient des codes qui décrivent le type de matières dangereuses stockées. Pour calculer des synthèses pour chaque valeur unique du champ HazardClass, utilisez ce champ comme champ de regroupement.	Field
Ajouter des attributs minoritaires et majoritaires (Facultatif)	Indique si des champs minoritaires et majoritaires sont ajoutés à la sortie. Ce paramètre s’applique uniquement lors de l’utilisation du paramètre 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 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 commençant par les préfixes Minority_ et Majority_ sont ajoutés à la sortie.	Boolean
Ajouter des pourcentages de regroupement (Facultatif)	Indique si des champs de pourcentage de regroupement sont ajoutés à la sortie. Ce paramètre s’applique uniquement lors de l’utilisation du paramètre Champ de regroupement. Désactivé : aucun champ de pourcentage n’est ajouté à la sortie. Il s’agit de l’option par défaut. Activé : le pourcentage de chaque valeur de regroupement unique est calculé pour chaque polygone en entrée. Les champs de pourcentage sont ajoutés à la sortie.	Boolean

Sortie obtenue

Étiquette	Explication	Type de données
Service d'entités en sortie	Couche synthétisée en sortie.	Feature Set
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.	Record Set

Python

arcpy.sfa.SummarizeWithin(sumWithinLayer, summaryLayer, outputName, {sumShape}, {shapeUnits}, {summaryFields}, {groupByField}, {minorityMajority}, {percentShape})

Nom	Explication	Type de données
sumWithinLayer	Les entités, ou parties d’entités, de la valeur du paramètre summaryLayer, 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)	Indique si les statistiques sont calculées en fonction de la forme de la valeur du paramètre summaryLayer, 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_SUM—Les statistiques sont calculées en fonction des attributs de récapitulation de forme. Il s’agit de l’option par défaut. NO_SHAPE_SUM—Les statistiques ne sont pas calculées en fonction des attributs de récapitulation de forme.	Boolean
shapeUnits (Facultatif)	Indique l’unité qui est utilisée pour la récapitulation 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 miles, les pieds, les mètres et les yards. MILES—L’unité est le mile. FEET—L’unité est le pied. KILOMETERS—L’unité est le kilomètre METERS—L’unité est le mètre. YARDS—L’unité est le yard. ACRES—L’unité est l’acre. HECTARES—L’unité est l’hectare. SQUAREMETERS—L’unité est le mètre carré. SQUAREKILOMETERS—L’unité est le kilomètre carré. SQUAREFEET—L’unité est le pied carré. SQUAREYARDS—L’unité est le yard carré. SQUAREMILES—L’unité est le mile carré.	String
summaryFields [[Field, Statistic],...] (Facultatif)	Liste des noms de champs et de type de résumé statistique à 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 : la valeur totale est calculée. MIN : la valeur la plus faible est identifiée. MAX : la valeur la plus élevée est identifiée. MEAN : la moyenne ou valeur moyenne est calculée. STD : la valeur de l’écart type est calculée.	Value Table
groupByField (Facultatif)	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 la valeur du paramètre summaryLayer contienne des emplacements de points d’entreprises qui stockent des matières dangereuses et que le champ HazardClass contient des codes qui décrivent le type de matières dangereuses stockées. Pour calculer des synthèses pour chaque valeur unique du champ HazardClass, utilisez ce champ comme champ de regroupement.	Field
minorityMajority (Facultatif)	Indique si des champs minoritaires et majoritaires sont ajoutés à la sortie. Ce paramètre s’applique uniquement lors de l’utilisation du paramètre groupByField. NO_MIN_MAJ—Les champs minoritaires et majoritaires ne sont pas ajoutés à la sortie. Il s’agit de l’option par défaut. 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 commençant par les préfixes Minority_ et Majority_ sont ajoutés à la sortie.	Boolean
percentShape (Facultatif)	Indique si des champs de pourcentage de regroupement sont ajoutés à la sortie. Ce paramètre s’applique uniquement lors de l’utilisation du paramètre groupByField. NO_PERCENT—Aucun champ de pourcentage n’est ajouté à la sortie. Il s’agit de l’option par défaut. ADD_PERCENT—Le pourcentage de chaque valeur de regroupement unique est calculé pour chaque polygone en entrée. Les champs de pourcentage sont ajoutés à la sortie.	Boolean

Sortie obtenue

Nom	Explication	Type de données
outputLayer	Couche synthétisée en sortie.	Feature Set
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.	Record Set

Environnements

Étendue

Informations de licence

• Basic: Nécessite votre compte dans ArcGIS Enterprise pour que vous puissiez disposer du privilège Perform Analysis (Effectuer une analyse)
• Standard: Nécessite votre compte dans ArcGIS Enterprise pour que vous puissiez disposer du privilège Perform Analysis (Effectuer une analyse)
• Advanced: Nécessite votre compte dans ArcGIS Enterprise pour que vous puissiez disposer du privilège Perform Analysis (Effectuer une analyse)