Étiquette | Explication | Type de données |
Couche en entrée | Entités ponctuelles temporelles sur lesquelles les statistiques de déplacement sont calculées. | Table View |
Classe d’entités en sortie |
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 |
Champs de trace |
Un ou plusieurs champs utilisés pour identifier des entités distinctes. | Field |
Fenêtre d’historique de suivi (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 |
Statistiques de déplacement (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 |
Méthode de distance (Facultatif) | Précise la méthode de mesure de la distance utilisée pour calculer les statistiques de déplacement.
| String |
Tolérance de distance de stabilisation (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 Tolérance temporelle de stabilisation pour déterminer si une entité se stabilise. Le paramètre Tolérance de distance de stabilisation est obligatoire si le groupe de statistiques Stabilisation est spécifié dans le paramètre Statistiques de déplacement ou si les statistiques de tous les groupes vont être calculées. | Linear Unit |
Tolérance temporelle de stabilisation (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 le paramètre Tolérance de distance de stabilisation pour déterminer si une entité se stabilise. Le paramètre Tolérance temporelle inactive est obligatoire si le groupe de statistiques Stabilisation est spécifié dans le paramètre Statistiques de déplacement ou si les statistiques de tous les groupes vont être calculées. | Time Unit |
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, à 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 |
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 |
Unité de distance (Facultatif) | Spécifie l’unité de mesure à utiliser pour les valeurs de distance dans la classe d’entités en sortie.
| String |
Unité de durée (Facultatif) | Spécifie l’unité de mesure à utiliser pour les valeurs de durée dans la classe d’entités en sortie.
| String |
Unité de vitesse (Facultatif) | Spécifie l’unité de mesure à utiliser pour les valeurs de vitesse dans la classe d’entités en sortie.
| String |
Unité d’accélération (Facultatif) | Spécifie l’unité de mesure à utiliser pour les valeurs d’accélération dans la classe d’entités en sortie.
| String |
Unité d’élévation (Facultatif) | Spécifie l’unité de mesure à utiliser pour les valeurs d’élévation dans la classe d’entités en sortie.
| String |
Synthèse
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 trace, les entités ID007, Solden, ,ID007 et Tokoyo figureraient 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 depuis la dernière observation jusqu’à celle en cours.
- 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 depuis la dernière observation jusqu’à celle en cours.
- 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 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 somme 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 la dernière observation.
- 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 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— Altitude actuelle de l’observation.
- ElevChange— Différence entre l’altitude actuelle et la précédente.
- TotElevChange— Somme des changements d’altitude entre les points dans la fenêtre d’historique de suivi. Cette valeur peut être négative.
- MinElevation— Altitude minimale dans la fenêtre d’historique de suivi.
- MaxElevation— Altitude maximale dans la fenêtre d’historique de suivi.
- AvgElevation— Somme des altitudes 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— Rapport changement d’altitude/distance entre l’observation actuelle et la 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 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 Tolérance de distance de stabilisation et que 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 de période de stabilisation). False : si l’une et/ou l’autre de ces conditions n’est pas remplie.
- TotIdleTime— Somme des durées dans la fenêtre d’historique de suivi qui répondent aux critères de stabilisation.
- PctIdleTime— Pourcentage de temps 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 depuis la dernière observation jusqu’à celle en cours.
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 Fenêtre d’historique de suivi. Par exemple, si vous définissez Fenêtre d’historique de suivi sur 5 et que vous demandez le groupe de statistiques Vitesse, l’observation actuelle et les 4 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.
Statistiques 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/s2
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 à l'aide de plusieurs cœurs en parallèle. Pour en savoir plus sur l'exécution d'une analyse, reportez-vous à la rubrique Remarques sur les outils de GeoAnalytics Desktop.
Lors de l’exécution d’outils de GeoAnalytics Desktop, l’analyse est effectuée sur votre ordinateur de bureau. Pour des performances optimales, les données doivent être disponibles 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 locales, l'exécution d'un outil est plus longue. Pour utiliser votre ArcGIS GeoAnalytics Server en vue d'une analyse, reportez-vous à la rubrique GeoAnalytics Tools.
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.
Paramètres
arcpy.geoanalytics.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})
Nom | 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 le paramètre idle_time_tolerance pour déterminer si une 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 le paramètre 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 à utiliser pour les valeurs de distance dans la classe d’entités en sortie.
| String |
duration_unit (Facultatif) | Spécifie l’unité de mesure à utiliser pour les valeurs de durée dans la classe d’entités en sortie.
| String |
speed_unit (Facultatif) | Spécifie l’unité de mesure à utiliser pour les valeurs de vitesse dans la classe d’entités en sortie.
| String |
acceleration_unit (Facultatif) | Spécifie l’unité de mesure à utiliser 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 à utiliser pour les valeurs d’élévation dans la classe d’entités en sortie.
| String |
Exemple de code
Le script autonome 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"
# 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\Hurricanes.lyrx'
# MakeFeatureLayer converts the .lyrx to features
hurricanesInputLayer = arcpy.management.MakeFeatureLayer(inputLyrx, "Hurricanes_layer")
# ApplySymbologyFromLayer sets the time using the .lyrx file definition
arcpy.management.ApplySymbologyFromLayer(hurricanesInputLayer, inputLyrx)
# Set local variables
trackField = "name"
out = "Hurricanes_MotionStats"
# Run Calculate Motion Statistics
arcpy.gapro.CalculateMotionStatistics(hurricanesInputLayer, out, trackField, 5,
["SPEED", "ACCELERATION", "BEARING"],
"GEODESIC")
Environnements
Vous avez un commentaire à formuler concernant cette rubrique ?