Étiquette | Explication | Type de données |
Input Features (Entités en entrée) | Les entités ponctuelles, linéaires ou surfaciques seront bufférisées. Ces zones tampon seront utilisées pour synthétiser les entités 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. | Feature Layer |
Classe d’entités en sortie | La classe d’entités surfaciques en sortie contenant les entités en entrée bufferisées, les attributs des entités en entrée et les nouveaux attributs concernant le nombre de points, la longueur de lignes et la surface des polygones au sein de chaque zone tampon, ainsi que des statistiques sur ces entités. | Feature Class |
Mesure de la distance | Spécifie le type de mesure de distance qui sera utilisé pour générer des zones tampon. La distance à parcourir et le temps de trajet à parcourir utiliseront tous les deux le réseau routier et respecteront les restrictions comme les rues à sens unique. Le temps de trajet respecte quant à lui les limitations de vitesse en vigueur. Pour utiliser les options de mesure du temps de trajet et de la distance à parcourir, vous devez être connecté à un compte d’organisation ArcGIS Online avec des privilèges d’analyse du réseau. À chaque exécution de l’outil, des crédits sont débités de votre abonnement en fonction du service utilisé et des résultats obtenus du service. La page Crédits donne des détails sur les crédits. Tous les types de distance, à l’exception de la distance en ligne droite, utilisent les services de calcul d’itinéraire et de réseau ArcGIS Online.
| String |
Distances | Valeurs de distance qui définiront une distance de recherche (pour la distance en ligne droite, la distance à parcourir, la distance pour camions ou la distance à pied) ou un temps de trajet (pour la distance à parcourir, les camions ou la distance à pied). Les entités qui se trouvent au sein (ou qui sont égales à) des distances que vous fournissez seront synthétisées. Plusieurs valeurs peuvent être spécifiées. Une zone est générée autour de chaque entité en entrée pour chaque distance. | Double |
Unités de distance (Facultatif) | Spécifie l’unité qui sera utilisée pour les valeurs de distance.
| String |
Heure du jour (Facultatif) | La date ou l’heure de condition de trafic sera prise en compte lors du temps de trajet. Les conditions de trafic, en particulier dans les zones urbanisées, peuvent avoir une grande influence sur la zone couverte dans un temps de trajet spécifié. Si aucune date ou heure n'est spécifiée, la distance couverte au cours d'un temps de trajet spécifié n'est pas influencée par le trafic. Les conditions de trafic peuvent être réelles ou typiques (historiques), selon la date et l’heure spécifiées pour ce paramètre. Esri enregistre les données de trafic réel pendant 12 heures et référence les données de prévision jusqu'à 12 heures dans le futur. Si l'heure et la date que vous spécifiez se trouvent dans une fenêtre horaire de 24 heures, le trafic réel est utilisé. Dans le cas contraire, le trafic typique ou historique est utilisé. | Date |
Fuseau horaire (Facultatif) | Spécifie le fuseau horaire qui sera utilisé pour l’heure du jour. Les fuseaux horaires peuvent être spécifiés en heure locale ou en heure UTC (Temps Universel Coordonné).
| String |
Conserver les polygones sans point (Facultatif) | Spécifie si toutes les zones tampon des entités en entrée ou uniquement celles qui intersectent ou contiennent au moins une entité de synthèse en entrée seront copiées 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 concernant tous les points au sein de chaque zone tampon des entités en entrée. Les champs de récapitulation doivent être numériques. Les champs de texte ou d'autres types attributaires ne sont pas pris en charge. Les types de statistiques suivants sont pris en charge :
| 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 tampon d’entité en entrée (attributs de récapitulation de forme) seront 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 récapitulation en entrée sont des points, aucune unité de forme n’est nécessaire, car seul le nombre de points au sein de la zone tampon de chaque entité 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.
| String |
Champ de regroupement (Facultatif) | Champ attributaire issu des entités de synthèse en entrée qui seront utilisées 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é, une table groupée en sortie supplémentaire est créée. Vous devez spécifier son emplacement. Le paramètre Output Grouped Table (Table groupée en sortie) est nécessaire pour utiliser un champ de regroupement. | Field |
Ajouter des attributs minoritaires et majoritaires (Facultatif) | Spécifie si les valeurs de champ de regroupement de la minorité (la moins dominante) et de la majorité (la plus dominante) dans chaque tampon d’entité en entrée sont ajoutées à la sortie. Ce paramètre est actif si vous avez spécifié 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 spécifié 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 récapitulation pour la zone tampon de chaque entité en entrée. Si un champ de regroupement est spécifiée, la table groupée en sortie est nécessaire. La table contiendra les champs attributaires suivants :
| Table |
Synthèse
Identifie les entités qui se trouvent à une certaine distance des entités dans la couche en entrée et calcule les statistiques des entités à proximité. La distance peut être mesurée par une distance en ligne droite, par une distance en durée de trajet (par exemple, à moins de 10 minutes) ou par une distance à parcourir (un rayon de 5 kilomètres, par exemple). Pour la distance en durée de trajet et la distance à parcourir, vous devez être connecté à un compte d’organisation ArcGIS Online avec les privilèges d’analyse de réseau. Les deux options de mesure consomment des crédits.
Des exemples de scénarios avec Summarize Nearby (Synthétiser - A proximité) sont présentés ci-dessous :
- Calculer la population totale qui se trouve à un temps de trajet de moins de 5 minutes de l’emplacement suggéré pour un nouveau point de vente.
- Calculer le nombre de bretelles d’accès d’autoroute qui se trouvent à une distance de moins d’1 mile d’un nouvel emplacement suggéré de point de vente afin d’en mesurer l’accessibilité.
Illustration
Utilisation
Vous pouvez spécifier plusieurs distances. Chaque valeur de distance entraînera la génération d'une zone autour de chaque entité en entrée. Par exemple, si vous spécifiez deux distances, chaque entité en entrée est bufferisée deux fois et la sortie contient deux zones pour cette entité en entrée, une pour chaque distance.
Les outils Summarize Within (Synthétiser - À l’intérieur) et Summarize Nearby (Synthétiser - À proximité) sont identiques d’un point de vue conceptuel. 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. En utilisant l’outil Summarize Within (Synthétiser - À l’intérieur), vous pouvez synthétiser des entités dans les polygones existants.
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).
Licence :
Pour utiliser les options de mesure du temps de trajet et de la distance à parcourir, vous devez être connecté à un compte d’organisation ArcGIS Online avec des privilèges d’analyse du réseau. À chaque exécution de l’outil, des crédits sont débités de votre abonnement en fonction du service utilisé et des résultats obtenus du service. La page Crédits donne des détails sur les crédits.
Paramètres
arcpy.analysis.SummarizeNearby(in_features, in_sum_features, out_feature_class, distance_type, distances, {distance_units}, {time_of_day}, {time_zone}, {keep_all_polygons}, {sum_fields}, {sum_shape}, {shape_unit}, {group_field}, {add_min_maj}, {add_group_percent}, {Output_Grouped_Table})
Nom | Explication | Type de données |
in_features | Les entités ponctuelles, linéaires ou surfaciques seront bufférisées. Ces zones tampon seront utilisées pour synthétiser les entités de synthèse en entrée. | Feature Layer |
in_sum_features | Entités ponctuelles, linéaires ou surfaciques qui seront synthétisées. | Feature Layer |
out_feature_class | La classe d’entités surfaciques en sortie contenant les entités en entrée bufferisées, les attributs des entités en entrée et les nouveaux attributs concernant le nombre de points, la longueur de lignes et la surface des polygones au sein de chaque zone tampon, ainsi que des statistiques sur ces entités. | Feature Class |
distance_type | Spécifie le type de mesure de distance qui sera utilisé pour générer des zones tampon. La distance à parcourir et le temps de trajet à parcourir utiliseront tous les deux le réseau routier et respecteront les restrictions comme les rues à sens unique. Le temps de trajet respecte quant à lui les limitations de vitesse en vigueur. Pour utiliser les options de mesure du temps de trajet et de la distance à parcourir, vous devez être connecté à un compte d’organisation ArcGIS Online avec des privilèges d’analyse du réseau. À chaque exécution de l’outil, des crédits sont débités de votre abonnement en fonction du service utilisé et des résultats obtenus du service. La page Crédits donne des détails sur les crédits. Tous les types de distance, à l’exception de la distance en ligne droite, utilisent les services de calcul d’itinéraire et de réseau ArcGIS Online.
| String |
distances [distance,...] | Valeurs de distance qui définiront une distance de recherche (pour la distance en ligne droite, la distance à parcourir, la distance pour camions ou la distance à pied) ou un temps de trajet (pour la distance à parcourir, les camions ou la distance à pied). Les entités qui se trouvent au sein (ou qui sont égales à) des distances que vous fournissez seront synthétisées. Plusieurs valeurs peuvent être spécifiées. Une zone est générée autour de chaque entité en entrée pour chaque distance. | Double |
distance_units (Facultatif) | Spécifie l’unité qui sera utilisée pour les valeurs de distance.
| String |
time_of_day (Facultatif) | La date ou l’heure de condition de trafic sera prise en compte lors du temps de trajet. Les conditions de trafic, en particulier dans les zones urbanisées, peuvent avoir une grande influence sur la zone couverte dans un temps de trajet spécifié. Si aucune date ou heure n'est spécifiée, la distance couverte au cours d'un temps de trajet spécifié n'est pas influencée par le trafic. Les conditions de trafic peuvent être réelles ou typiques (historiques), selon la date et l’heure spécifiées pour ce paramètre. Esri enregistre les données de trafic réel pendant 12 heures et référence les données de prévision jusqu'à 12 heures dans le futur. Si l'heure et la date que vous spécifiez se trouvent dans une fenêtre horaire de 24 heures, le trafic réel est utilisé. Dans le cas contraire, le trafic typique ou historique est utilisé. | Date |
time_zone (Facultatif) | Spécifie le fuseau horaire qui sera utilisé pour l’heure du jour. Les fuseaux horaires peuvent être spécifiés en heure locale ou en heure UTC (Temps Universel Coordonné).
| String |
keep_all_polygons (Facultatif) | Spécifie si toutes les zones tampon des entités en entrée ou uniquement celles qui intersectent ou contiennent au moins une entité de synthèse en entrée seront copiées 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 concernant tous les points au sein de chaque zone tampon des entités en entrée. Les champs de récapitulation doivent être numériques. Les champs de texte ou d'autres types attributaires ne sont pas pris en charge. Les types de statistiques suivants sont pris en charge :
| 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 tampon d’entité en entrée (attributs de récapitulation de forme) seront 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 récapitulation en entrée sont des points, aucune unité de forme n’est nécessaire, car seul le nombre de points au sein de la zone tampon de chaque entité 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.
| String |
group_field (Facultatif) | Champ attributaire issu des entités de synthèse en entrée qui seront utilisées 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é, une table groupée en sortie supplémentaire est créée. Vous devez spécifier son emplacement dans le paramètre out_grouped_table. | Field |
add_min_maj (Facultatif) | Spécifie si les valeurs de champ de regroupement de la minorité (la moins dominante) et de la majorité (la plus dominante) dans chaque tampon d’entité en entrée sont ajoutées à la sortie. Ce paramètre est activé si vous avez spécifié la valeur du paramètre group_field.
| Boolean |
add_group_percent (Facultatif) | Indique si un pourcentage de chaque valeur attributaire de chaque groupe 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.
| Boolean |
Output_Grouped_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 entité en entrée. Si un champ de regroupement est spécifiée, la table groupée en sortie est nécessaire. La table contiendra les champs attributaires suivants :
| Table |
Exemple de code
Le script de la fenêtre Python ci-après illustre l’utilisation de la fonction SummarizeNearby.
import arcpy
arcpy.env.workspace = "C:/data/city.gdb"
arcpy.analysis.SummarizeNearby("new_store_location", "census_blocks",
"new_store_population", "STRAIGHT_LINE", "1;2",
"Miles", "", "", "KEEP_ALL", "Pop2014 SUM")
Le script autonome suivant est un exemple d’utilisation simple de la fonction SummarizeNearby dans un environnement de scripts.
# Description: Use SummarizeNearby to summarize population
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/city.gdb"
# Set local variables
newStore = "new_store_location"
censusInfo = "census_blocks"
outFeatureClass = "crimes_aggregated"
distanceType = "TRAVEL_TIME"
distance = "10;20"
distanceUnit = "Minutes"
time = "10/15/2014 2:14:19 PM"
timeZone = "GEOLOCAL"
keepPolys = True
sumFields = [["Pop2010", "Sum"],["OWNERS", "Sum"]]
addShapeSum = True
arcpy.analysis.SummarizeNearby(newStore, censusInfo, outFeatureClass,
distanceType, distance, distanceUnit,
time, timeZone, keepPolys, sumFields,
addShapeSum)
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?