| Étiquette | Explication | Type de données |
Entités en entrée | Traces ponctuelles dans lesquelles rechercher les arrêts. L’entrée doit être une couche temporelle comportant des entités qui représentent des instants dans le temps. | Feature Layer |
Jeu de données en sortie | Classe d’entités en sortie qui contient les arrêts obtenus. | Feature Class |
Champs de trace | Un ou plusieurs champs utilisés pour identifier des pistes uniques. | Field |
Méthode de distance | Indique le mode de calcul des distances entre les entités d’arrêt.
| String |
Tolérance de distance | Distance maximale entre les points à considérer comme un seul emplacement d’arrêt. | Linear Unit |
Tolérance temporelle | Durée minimale à considérer comme un seul emplacement d’arrêt. La durée et la distance sont prises en compte lors de la recherche d’arrêts. Le paramètre Distance Tolerance (Tolérance de distance) précise la distance. | Time Unit |
Type en sortie | Indique le mode de génération des entités d’arrêt en sortie.
| String |
Résumés statistiques (Facultatif) | Statistiques qui seront calculées sur les champs spécifiés.
| Value Table |
Fraction de limite temporelle (Facultatif) |
Période dans laquelle fractionner les données en entrée pour analyse. Une limite temporelle vous permet d’analyser des valeurs dans une période temporelle définie. Par exemple, si vous utilisez une limite temporelle de 1 jour et que vous définissez la référence de limite temporelle au 1er janvier 1980, les traces seront fractionnées au début de chaque jour. | Time Unit |
Référence de la limite temporelle (Facultatif) |
Référence temporelle dans laquelle fractionner les données en entrée pour analyse. Les limites temporelles seront créées pour toute la plage des données et il n’est pas nécessaire que la référence temporelle se situe au début. Si aucune référence temporelle n’est indiquée, le 1er janvier 1970 est utilisé. | Date |
Synthèse
Recherche les emplacements auxquels des objets en déplacement se sont arrêtés ou ont résidé en fonction de seuils de temps et de distance donnés.
Illustration
Utilisation
La couche en entrée doit être constituée d’entités ponctuelles temporelles qui représentent un instant donné dans le temps.
Les emplacements d’arrêt sont définis comme des observations séquentielles avec peu ou pas de mouvement sur une certaine période. Selon le domaine d’application, ils peuvent être appelés points d’arrêt ou détection d’inactivité.
Le tableau suivant répertorie la terminologie employée dans l’outil Rechercher les emplacements d’arrêt :
Terme Description Emplacement d’arrêt
Entités représentant l’état stationnaire d’une piste en fonction de paramètres de temps et de distance donnés. Il s’agit du résultat en sortie de l’outil qui représente les entités d’emplacement sous forme de points, d’enveloppes convexes ou de centres moyens.
Parcours
Séquence d’entités temporelles de type instant. Les entités sont identifiées comme faisant partie de la séquence par un champ d’identificateur de piste et elles obéissent à un classement temporel. Par exemple, une ville peut disposer d’un parc de chasse-neige qui enregistrent leur position toutes les 10 minutes. L’ID de véhicule peut représenter les pistes distinctes.
Observation
Point d’une piste
Géodésique
Ligne tracée sur une sphère. Une ligne géodésique tracée sur le globe représente la courbure de la géoïde de la Terre.
Planaire
Distance en ligne droite mesurée sur une surface plane (c'est-à-dire un plan cartésien). Elle est également appelée distance euclidienne.
Instant
Moment unique dans le temps représenté par une heure de début, mais pas d’heure de fin.
Intervalle
Durée représentée par une heure de début et une heure de fin.
Les résultats sont des entités ponctuelles représentant des instants dans le temps ou des entités surfaciques qui correspondent à un intervalle dans le temps. Le début et la fin de l’intervalle sont déterminés par les données temporelles de la première et de la dernière entités d’un arrêt.
Les entités non temporelles sont exclues de l’analyse.
Les emplacements d’arrêt ne peuvent être détectés que dans les pistes comportant plusieurs entités.
Les localisations d’arrêt sont déterminées grâce aux valeurs de temps (paramètre Tolérance temporelle) et de distance (paramètre Tolérance de distance). L’outil affecte tout d’abord les entités à une piste à l’aide d’un identifiant unique. L’ordre des pistes dépend des données temporelles des entités. La distance entre la première observation dans une piste et la suivante est ensuite calculée. Les entités sont considérées comme faisant partie d’un arrêt si deux points temporellement consécutifs restent dans un rayon indiqué par la distance donnée pendant au moins la durée spécifiée. Lorsque deux entités sont détectées comme appartenant à un arrêt, la première entité de l’arrêt est utilisée comme point de référence et l’outil recherche les entités consécutives se trouvant dans le rayon spécifié par la distance donnée du point de référence dans l’arrêt. Une fois que toutes les entités situées dans ce rayon ont été détectées, l’outil collecte les entités d’arrêt et calcule leur centre moyen. Les entités situées avant et après l’arrêt en cours sont ajoutées à ce dernier si elles se situent dans le rayon indiqué par le distance spécifiée par rapport au centre moyen de l’emplacement d’arrêt. Ce traitement continue jusqu’à la fin de la piste.
Vous pouvez spécifier un ou plusieurs champs pour identifier des pistes. Les traces sont représentées par un ou plusieurs champs de trace.
Par défaut, les emplacements d’arrêt sont créés grâce à une méthode géodésique de calcul de la distance. Il est recommandé d’utiliser la distance géodésique dans les cas suivants :
- Les pistes croisent la ligne de changement de date : lorsque vous utilisez la méthode géodésique, les couches en entrée qui croisent la ligne de changement de date comportent des pistes qui croisent correctement la ligne de changement de date. Il s’agit de l’option par défaut. La couche en entrée ou la référence spatiale de traitement doit être définie sur une référence spatiale qui prend en charge le retour à la ligne de la ligne de changement de date, par exemple, une projection globale de type World Cylindrical Equal Area.
- Le jeu de données n’est pas dans une projection locale : si vos données en entrée sont dans une projection locale, utilisez la méthode de calcul de distance planaire. Vous pouvez ainsi faire appel à la méthode planaire pour examiner les localisations d’arrêt au sein d’un seul État. La couche en entrée ou votre référence spatiale de traitement doit être définie comme une référence spatiale locale pour le jeu de données.
Les emplacements d’arrêt en sortie peuvent être représentés de quatre manières. Le tableau suivant indique un exemple de chacune de ces représentations :
Option du paramètre Type en sortie Description Exemple Toutes les entités
Toutes les entités sont renvoyées. Les entités obtenues ont un temps de type instant.
Les entités qui appartiennent à un arrêt apparaissent en bleu. Les entités qui ne font partie d’aucun arrêt sont affichées en gris.
Seule une statistique de dénombrement est calculée pour ce type de sortie. Le total représente le nombre d’entités appartenant à un arrêt. Les entités qui n’appartiennent pas à un arrêt affichent un total de 0.
Dwell features (Entités d’arrêt)
Seules les entités faisant partie d’un arrêt sont renvoyées. Les entités obtenues ont un temps de type instant.
Seule une statistique de dénombrement est calculée pour ce type de sortie. Le total représente le nombre d’entités appartenant à un arrêt.
Mean centers (Centres moyens)
Chaque arrêt renvoie un point unique qui représente le centre moyen de l’arrêt en distance et en temps. Les entités obtenues ont un temps de type intervalle.
Le nombre total d’entités de l’arrêt est toujours calculé. Si vous le souhaitez, vous pouvez calculer des statistiques sur ce ttpe d’entité d’arrêt. Par défaut, aucune statistique n’est calculée.
Convex hulls (Enveloppes convexes)
Chaque arrêt est représenté par une enveloppe convexe des entités d’arrêt. Les entités obtenues ont un temps de type intervalle.
Le nombre total d’entités de l’arrêt est toujours calculé. Si vous le souhaitez, vous pouvez calculer des statistiques sur ce ttpe d’entité d’arrêt. Par défaut, aucune statistique n’est calculée.
Outre les champs provenant de la couche en entrée, les champs suivants sont inclus dans toutes les entités en sortie :
Nom du champ Description count
Nombre d’entités qui figuraient dans l’arrêt
dwellid
ID unique de l’arrêt auquel l’entité appartient
meanx
Valeur moyenne des coordonnées x qui constituent l’arrêt
meany
Valeur moyenne des coordonnées y qui constituent l’arrêt
meandistance
Distance moyenne entre des points consécutifs à un emplacement d’arrêt
dwellduration
Durée, en millisecondes, entre la première et la dernière observation de la localisation d’arrêt
date
Instant de la création de chaque entité lorsque le type en sortie est Dwell features (Entités d’arrêt), Mean centers (Centres moyens) ou All features (Toutes les entités)
start_date
Heure de début de la création lorsque le type en sortie est Convex hulls (Enveloppes convexes)
end_date
Heure de fin de la création lorsque le type en sortie est Convex hulls (Enveloppes convexes)
Si le type en sortie est Toutes les entités, les champs décrits ci-dessus sont calculés dans les valeurs se rapportant à un arrêt. Les résultats qui ne font partie d’aucun arrêt renvoient une valeur 0 pour le champ count, la valeur temporelle de l’entité en entrée pour le champ date et la valeur nulle pour tous les autres champs.
Fractionnez les pistes à l’aide du paramètre Fraction de limite temporelle. Ces segments effectuent un suivi selon un intervalle défini. Par exemple, si vous définissez le paramètre Référence de la limite temporelle sur une journée, avec un début le 1er janvier 1990 à 9 h 00 (9:00 a.m.), chaque piste sera tronquée à 9 h 00 tous les jours. Cette fraction réduit le temps de calcul car elle crée des pistes plus petites pour l’analyse. S’il est pertinent pour l’analyse de fractionner selon une limite temporelle récurrente, cela est recommandé pour le traitement de Big Data.
Lors du calcul de l’enveloppe convexe, si un emplacement d’arrêt est complètement stationnaire (un emplacement unique) ou composé de deux points uniques, une petite valeur basée sur la tolérance de la référence spatiale utilisée dans une analyse est employée comme largeur, hauteur ou diamètre de création de polygones en sortie au lieu d’enveloppes convexes. Ces polygones sont utilisés pour la visualisation et ne représentent pas l’étendue spatiale de l’arrêt. Le tableau suivant en décrit quelques exemples :
Cas en entrée Description Exemple Coïncident (un point spatialement unique)
Si les entités en entrée sont empilées (coïncidentes), l’enveloppe convexe obtenue est un polygone non valide.
Dans cet exemple, les entités en entrée coïncidentes sont représentées par le point rouge au centre du polygone jaune. Le polygone jaune représente l’enveloppe convexe en sortie obtenue pour les points coïncidents. Le polygone bleu montre ce à quoi ressemble une véritable enveloppe convexe lorsque quatre points non coïncidents figurent à une seule localisation d’arrêt.
Colinéarité (deux points spatialement uniques)
Si les entités en entrée se trouvent sur une ligne (généralement avec deux points spatialement uniques), l’enveloppe convexe obtenue est un polygone non valide.
Dans cet exemple, les points colinéaires sont représentés par des points rouges dans le polygone jaune. Le polygone jaune représente l’enveloppe convexe en sortie obtenue pour les points colinéaires.
Lorsque vous sélectionnez les paramètres de calcul des emplacements d’arrêt, tenez compte du type d’observation et de l’échelle d’arrêt que vous souhaitez rechercher. Voici quelques exemples de modification des paramètres de recherche dans des données de mouvement :
- Des entités navire possèdent les champs vesselID et tripID.
- Utilisez les champs vesselID et tripID comme identifiants pour calculer les localisations d’arrêt le long d’itinéraires distincts.
- Indiquez une tolérance temporelle d’une heure et une tolérance de distance égale à 1 mille nautique pour détecter les arrêts des navires dans un rayon d’un mille nautique pendant au moins une heure.
- Des traceurs d’animaux possèdent un champ animalID.
- Utilisez le champ animalID comme identifiant pour comparer les localisation d’arrêt d’animaux spécifiques.
- Pour connaître la plage d’un animal, indiquez une tolérance temporelle de 3 jours et une tolérance de distance de 10 miles afin de découvrir les habitats préférés des animaux.
- Pour réduire la zone d’intérêt, utilisez une tolérance temporelle de 2 heures et une tolérance de distance de 100 mètres.
- Des entités navire possèdent les champs vesselID et tripID.
Vous pouvez améliorer les performances de l’outil Find Dwell Locations (Rechercher les emplacements d’arrêt) de l’une des manières suivantes :
- Définissez l’environnement de l’étendue de manière à analyser uniquement des données d’intérêt.
- Générez les résultats en sortie en tant que Entités d’arrêt ou Centres moyens.
- Subdivisez les pistes autant que possible en ajoutant des entrées Track Field (Champs de piste).
- Utilisez la méthode planaire pour le calcul de distance lieu de la méthode géodésique.
- Fractionnez les pistes à l’aide du paramètre Fraction de limite temporelle.
- Utilisez les données locales de l’environnement de l’analyse.
Cet outil de géotraitement est mis en œuvre par Spark. L’analyse est effectuée sur votre ordinateur de bureau en utilisant plusieurs cœurs en parallèle. Pour en savoir plus sur l’exécution de l’analyse, reportez-vous à la rubrique Remarques relatives aux outils GeoAnalytics Desktop.
Lorsque vous exécutez des outils GeoAnalytics Desktop, l’analyse est effectuée sur votre ordinateur de bureau. Pour des performances optimales, les données doivent être accessibles sur votre bureau. Si vous utilisez une couche d’entités hébergée, il est recommandé d'utiliser ArcGIS GeoAnalytics Server. Si vos données ne sont pas enregistrées en local, l’exécution des outils prendra plus de temps. Pour utiliser votre ArcGIS GeoAnalytics Server en vue d'une analyse, reportez-vous à la rubrique GeoAnalytics Tools.
Paramètres
arcpy.geoanalytics.FindDwellLocations(input_features, output, track_fields, distance_method, distance_tolerance, time_tolerance, output_type, {summary_statistics}, {time_boundary_split}, {time_boundary_reference})| Nom | Explication | Type de données |
input_features | Traces ponctuelles dans lesquelles rechercher les arrêts. L’entrée doit être une couche temporelle comportant des entités qui représentent des instants dans le temps. | Feature Layer |
output | Classe d’entités en sortie qui contient les arrêts obtenus. | Feature Class |
track_fields [track_fields,...] | Un ou plusieurs champs utilisés pour identifier des pistes uniques. | Field |
distance_method | Indique le mode de calcul des distances entre les entités d’arrêt.
| String |
distance_tolerance | Distance maximale entre les points à considérer comme un seul emplacement d’arrêt. | Linear Unit |
time_tolerance | Durée minimale à considérer comme un seul emplacement d’arrêt. La durée et la distance sont prises en compte lors de la recherche d’arrêts. Le paramètre Distance Tolerance (Tolérance de distance) précise la distance. | Time Unit |
output_type | Indique le mode de génération des entités d’arrêt en sortie.
| String |
summary_statistics [summary_statistics,...] (Facultatif) | Statistiques qui seront calculées sur les champs spécifiés.
| Value Table |
time_boundary_split (Facultatif) |
Période dans laquelle fractionner les données en entrée pour analyse. Une limite temporelle vous permet d’analyser des valeurs dans une période temporelle définie. Par exemple, si vous utilisez une limite temporelle de 1 jour et que vous définissez la référence de limite temporelle au 1er janvier 1980, les traces seront fractionnées au début de chaque jour. | Time Unit |
time_boundary_reference (Facultatif) |
Référence temporelle dans laquelle fractionner les données en entrée pour analyse. Les limites temporelles seront créées pour toute la plage des données et il n’est pas nécessaire que la référence temporelle se situe au début. Si aucune référence temporelle n’est indiquée, le 1er janvier 1970 est utilisé. | Date |
Exemple de code
Le script autonome ci-dessous illustre l’utilisation de la fonction FindDwellLocations.
# Name: FindDwellLocations.py
# Description: Find the mean centers representing locations where ships have
# stayed within 1 mile across 4 hours of travel.
# Requirements: ArcGIS GeoAnalytics Desktop tools
# Import system modules
import arcpy
# Enable time on the input features using an .lyrx file.
# To create the .lyrx file, add your layer to a map, open the layer properties
# and enable time. Then right-click the layer and select Share As Layer File.
inputLyrx = r'C:\data\MyAtlanticShips.lyrx'
# MakeFeatureLayer converts the .lyrx to features
myAtlanticShipsInputLayer = arcpy.management.MakeFeatureLayer(inputLyrx, "MyAtlanticShips_layer")
# ApplySymbologyFromLayer sets the time using the .lyrx file definition
arcpy.management.ApplySymbologyFromLayer(myAtlanticShipsInputLayer, inputLyrx)
# Set local variables
outFeatures = "c:/mydata/OutputDatasets/AtlanticShips_DwellLocations.shp"
trackIdentifier = "SHIPID"
distance = "1 Miles"
timeDuration = "4 Hours"
outputType = "MEAN_CENTERS"
statistics = [["SPEED", "MEAN"]]
# Run Find Dwell Locations
arcpy.gapro.FindDwellLocations(myAtlanticShipsInputLayer, outFeatures, trackIdentifier,
"GEODESIC", distance, timeDuration,
outputType, statistics)Environnements
Vous avez un commentaire à formuler concernant cette rubrique ?