Résumé
Calcule les statistiques de déplacement pour les points d’une classe d’entités à dimension temporelle.
Illustration
Utilisation
Le résultat de l’outil Calculer les statistiques de déplacement est une copie des points en entrée, accompagnée d’un nouveau champ pour chaque statistique calculée.
Vous pouvez spécifier un ou plusieurs champs pour identifier des entités uniques, également appelées traces. Les traces sont représentées par un ou plusieurs champs de trace. Par exemple, si les champs flightID et Destination sont utilisés comme identifiants de traces, les entités ID007, Solden et ID007, Tokoyo figurent dans deux traces distinctes, car les valeurs de leur champ Destination sont différentes
Par défaut, toutes les statistiques prises en charge seront calculées pour chaque point en entrée, dans la mesure du possible. Vous pouvez également sélectionner un ou plusieurs groupes de statistiques pour le calcul à l’aide du paramètre Motion Statistics (Statistiques de déplacement).
Les champs de statistiques suivants sont calculés pour le groupe Distance :
- Distance : distance parcourue de l’observation précédente à l’observation actuelle.
- TotDistance : somme des distances parcourues entre les observations dans la fenêtre d’historique de suivi.
- MinDistance : distance minimale parcourue entre les observations dans la fenêtre d’historique de suivi.
- MaxDistance : distance maximale parcourue entre les observations dans la fenêtre d’historique de suivi.
- AvgDistance : moyenne des distances parcourues entre les observations dans la fenêtre d’historique de suivi.
Les champs de statistiques suivants sont calculés pour le groupe Speed (Vitesse) :
- Speed : vitesse de déplacement entre l’observation précédente et l’observation actuelle.
- MinSpeed : vitesse minimale entre les observations dans la fenêtre d’historique de suivi.
- MaxSpeed : vitesse maximale entre les observations dans la fenêtre d’historique de suivi.
- AvgSpeed : somme des distances entre les observations dans la fenêtre d’historique de suivi, divisée par la somme des durées entre les observations dans cette fenêtre.
Les champs de statistiques suivants sont calculés pour le groupe Acceleration (Accélération) :
- Acceleration : différence entre la vitesse actuelle et la vitesse précédente divisée par la durée actuelle.
- MinAcceleration : accélération minimale calculée dans la fenêtre d’historique de suivi.
- MaxAcceleration : accélération maximale calculée dans la fenêtre d’historique de suivi.
- AvgAcceleration : différence entre la vitesse actuelle et la première vitesse dans la fenêtre d’historique de suivi, divisée par la moyenne des durées entre les observations dans cette fenêtre.
Les champs de statistiques suivants sont calculés pour le groupe Duration (Durée) :
- Duration : temps écoulé depuis l’observation précédente
- TotDuration : somme des durées dans la fenêtre d’historique de suivi.
- MinDuration : durée minimale dans la fenêtre d’historique de suivi.
- MaxDuration : durée maximale dans la fenêtre d’historique de suivi.
- AvgDuration : somme des durées figurant dans la fenêtre d’historique de suivi, divisée par le nombre de durées calculées dans cette fenêtre.
Les champs de statistiques suivants sont calculés pour le groupe Elevation (Élévation) :
- Elevation : élévation actuelle du point d’observation.
- ElevChange : différence d’altitude entre l’élévation actuelle et l’élévation précédente.
- TotElevChange : somme des variations de l’élévation entre les points figurant dans la fenêtre d’historique de suivi. Cette valeur peut être négative.
- MinElevation : élévation minimale dans la fenêtre d’historique de suivi.
- MaxElevation : élévation maximale dans la fenêtre d’historique de suivi.
- AvgElevation : somme des élévations figurant dans la fenêtre d’historique de suivi, divisée par le nombre d’observations dans cette fenêtre.
Les champs de statistiques suivants sont calculés pour le groupe Slope (Pente) :
- Slope : taux de variation de l’élévation par rapport à la distance entre les observations actuelle et précédente.
- MinSlope : pente minimale dans la fenêtre d’historique de suivi.
- MaxSlope : pente maximale dans la fenêtre d’historique de suivi.
- AvgSlope : somme des pentes figurant dans la fenêtre d’historique de suivi, divisée par le nombre de pentes calculées dans cette fenêtre.
Les champs de statistiques suivants sont calculés pour le groupe Idle (Stabilisation) :
- Idling : True si la distance entre l’observation actuelle et la précédente est inférieure à la valeur du paramètre Idle Distance Tolerance (Tolérance de distance de stabilisation) et si la durée entre l’observation actuelle et la précédente est supérieure à la valeur du paramètre Idle Time Tolerance (Tolérance temporelle de stabilisation). False si l’une ou les deux conditions ne sont pas remplies.
- TotIdleTime : somme des durées dans la fenêtre d’historique de suivi qui correspondent aux critères de stabilisation.
- PctIdleTime : pourcentage de la durée pendant lequel une stabilisation a été détectée.
Les champs de statistiques suivants sont calculés pour le groupe Bearing (Relèvement) :
- Bearing : angle de déplacement entre l’observation précédente et l’observation actuelle.
Les statistiques, à commencer par le minimum, le maximum, la moyenne ou le total, sont calculées à l’aide de l’observation actuelle et un certain nombre d’observations précédentes définies par le paramètre Track History Window (Fenêtre d’historique de suivi). Les autres statistiques sont toujours calculées à l’aide de l’observation actuelle et de la précédente, sans tenir compte des valeurs du paramètre Track History Window (Fenêtre d’historique de suivi). Si, par exemple vous définissez une valeur Track History Window (Fenêtre d’historique de suivi) sur 5 et désirez le groupe de statistiques Speed (Vitesse), l’observation actuelle et les 4 observations précédentes sont utilisées pour calculer les champs MinSpeed, MaxSpeed et AvgSpeed pour chaque observation, alors que le champ Speed n’est calculé qu’à l’aide de l’observation actuelle et de la précédente pour chaque point. La valeur du paramètre Track History Window (Fenêtre d’historique de suivi) doit être supérieure à 1. La valeur par défaut est 3.
Le diagramme ci-après illustre une trace comportant six entités ponctuelles. Les statistiques sont calculées en se basant sur l’élévation, la distance et l’heure de chaque entité.
La table suivante récapitule le calcul de statistiques pour le diagramme ci-dessus. Tous les calculs sont évalués au point 5 et la fenêtre d’historique de suivi est égale à 3. Une observation est considérée comme stabilisée si son déplacement est inférieur à 32 mètres en 1 minute.
Statistique Formule Exemple Distance
35 m
Distance totale
80 + 30 + 35 = 145 m
Vitesse
Distance / Durée
35 / 60 = 0,58 m/s
Vitesse moyenne
Distance totale / Durée totale
145 / 180 m/s
Acceleration (Accélération)
(0,58– 0,5) / 60 = 0,001 m/s²
Accélération moyenne
(Vitesse (dernière) – Vitesse (premier)) / (Durée totale)
(0,58– 1,33) / 60 = -0,01 m/s²
Duration
60 s
Durée totale
60 + 60 + 60 = 180 s
Élévation
5 m
Changement d’élévation
5 – 4 = 1 m
Changement d’élévation total
5 – 0 = 5 m
Pente
Changement d’élévation / Distance
1 / 35
Pente moyenne
Changement d’élévation total / Distance totale
5 / 145
Ralenti
False
Tolérance de durée de stabilisation
60 s
Durée de stabilisation en pourcentage
1 / 3
Orientation
0
Si le nombre d’observations dans l’historique d’une trace est inférieur à la valeur du paramètre Track History Window (Fenêtre d’historique de suivi), les statistiques, à commencer par le minimum, le maximum, la moyenne ou le total, sont calculées à l’aide de l’ensemble des observations dans l’historique de suivi.
Les statistiques ne seront pas calculées pour la première entité de chaque trace. Les statistiques du groupe Acceleration (Accélération) ne seront pas calculées pour les deux premières entités de chaque trace.
Les valeurs des résultats sont exprimées dans les unités spécifiés pour les paramètres Distance Unit (Unité de distance), Duration Unit (Unité de durée), Speed Unit (Unité de vitesse), Acceleration Unit (Unité d’accélération) et Elevation Unit (Unité d’élévation).
Durant le calcul de statistiques portant sur des traces plus longues, vous pouvez utiliser le paramètre Time Boundary Split (Limite de fraction temporelle) pour diviser les traces en traces de taille plus réduite afin d’améliorer les performances.
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, nous vous recommandons de faire appel à 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 instance ArcGIS GeoAnalytics Server en vue d’une analyse, reportez-vous à la rubrique Outils GeoAnalytics.
Vous pouvez améliorer les performances de l’outil Calculate Motion Statistics (Calculer les statistiques de déplacement) en effectuant toutes les tâches suivantes ou certaines d’entre elles :
- Définissez l’environnement de l’étendue de manière à analyser uniquement des données d’intérêt.
- Diminuez la valeur du paramètre Track History Window (Fenêtre d’historique de suivi).
- Utilisez le paramètre Time Boundary Split (Limite de fraction temporelle) pour diviser les traces de grande taille selon des intervalles de temps définis.
- Utilisez les données locales de l’environnement de l’analyse.
Syntaxe
arcpy.gapro.CalculateMotionStatistics(input_layer, out_feature_class, track_fields, {track_history_window}, {motion_statistics}, {distance_method}, {idle_dist_tolerance}, {idle_time_tolerance}, {time_boundary_split}, {time_boundary_reference}, {distance_unit}, {duration_unit}, {speed_unit}, {acceleration_unit}, {elevation_unit})| Paramètre | Explication | Type de données |
input_layer | Entités ponctuelles temporelles sur lesquelles les statistiques de déplacement sont calculées. | Table View |
out_feature_class | Couche ou classe d’entités en sortie contenant les points associés aux nouveaux champs pour chaque statistique de déplacement calculée. | Feature Class |
track_fields [track_fields,...] | Un ou plusieurs champs utilisés pour identifier des entités distinctes. | Field |
track_history_window (Facultatif) | Nombre d’observations (observation courante comprise) utilisées pour les statistiques de synthèse. La valeur par défaut est 3, ce qui signifie que les statistiques résumées seront calculées à chaque point d’une trace à l’aide de l’observation actuelle et des deux précédentes. Ce paramètre n’affecte pas les statistiques instantanées ni la classification de la stabilisation. | Long |
motion_statistics [motion_statistics,...] (Facultatif) | Spécifie le groupe contenant les statistiques à calculer et à inscrire comme résultat. Si aucune valeur n’est fournie, toutes les statistiques des groupes seront calculées.
| String |
distance_method (Facultatif) | Précise la méthode de mesure de la distance utilisée pour calculer les statistiques de déplacement.
| String |
idle_dist_tolerance (Facultatif) | Distance maximale séparant deux points séquentiels d’une trace pour que ceux-ci restent considérés comme étant stabilisés. Ce paramètre est utilisé avec idle_time_tolerance pour déterminer si une entité entité se stabilise. Le paramètre idle_dist_tolerance est obligatoire si le groupe de statistiques IDLE est spécifié dans le paramètre motion_statistics ou si les statistiques de tous les groupes vont être calculées. | Linear Unit |
idle_time_tolerance (Facultatif) | Durée minimale pendant laquelle deux points séquentiels d’une trace doivent se trouver à proximité pour être considérés comme étant stabilisés. Ce paramètre est utilisé avec idle_dist_tolerance pour déterminer si une entité se stabilise. Le paramètre idle_time_tolerance est obligatoire si le groupe de statistiques IDLE est spécifié dans le paramètre motion_statistics ou si les statistiques de tous les groupes vont être calculées. | Time Unit |
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, à partir du 1er janvier 1980, les traces seront fractionnées au début de chaque jour. Ce paramètre est disponible uniquement avec ArcGIS Enterprise 10.7 et version ultérieure. | 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 |
distance_unit (Facultatif) | Spécifie l’unité de mesure pour les valeurs de distance dans la classe d’entités en sortie.
| String |
duration_unit (Facultatif) | Spécifie l’unité de mesure pour les valeurs de durée dans la classe d’entités en sortie.
| String |
speed_unit (Facultatif) | Spécifie l’unité de mesure pour les valeurs de vitesse dans la classe d’entités en sortie.
| String |
acceleration_unit (Facultatif) | Spécifie l’unité de mesure pour les valeurs d’accélération dans la classe d’entités en sortie.
| String |
elevation_unit (Facultatif) | Spécifie l’unité de mesure pour les valeurs d’élévation dans la classe d’entités en sortie.
| String |
Exemple de code
Le script Python ci-dessous illustre l'utilisation de la fonction CalculateMotionStatistics.
# Name: CalculateMotionStatistics.py
# Description: Calculate speed, acceleration, and bearing for hurricane tracks.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Weather.gdb"
# Set local variables
inFeatures = "Hurricanes"
trackField = "name"
out = "Hurricanes_MotionStats"
# Execute Calculate Motion Statistics
arcpy.gapro.CalculateMotionStatistics(inFeatures, out, trackField, 5,
["SPEED", "ACCELERATION", "BEARING"],
"GEODESIC")Environnements
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?