Suivi de particules (Spatial Analyst)
Récapitulatif
Calcule le chemin d'une particule via un champ de vitesse et retourne un fichier ASCII de données de suivi de particules et, le cas échéant, une couverture d'informations de suivi.
Utilisation
-
Les rasters de grandeur et de direction en entrée doivent provenir de la même exécution de l'outil Flux de Darcy.
-
Le fichier de chemin généré par cet outil est un fichier texte ASCII contenant des informations relatives à la position, à la direction et à l'amplitude de la vitesse locale, ainsi qu'à la longueur et au temps cumulés du déplacement le long du chemin. Ce fichier est utilisé comme entrée par Concentration. Le format de ce fichier est le suivant :
time x y length flow dir flow mag 0.000000000 0.000000000 482.8400000 0.000000000 90.00000000 0.04418909563 113.1648712 4.999804443 482.7957786 5.000000000 91.01366126 0.04418332249 226.2741353 9.998043277 482.6630814 10.00000000 92.02765240 0.04420504404 339.3574334 14.99315255 482.4419855 15.00000000 93.04094157 0.04421519432 452.3447720 19.98356700 482.1325285 20.00000000 94.05521317 0.04425274599 565.2657591 24.96772671 481.7348453 25.00000000 95.06807622 0.04427874865 678.0514031 29.94406931 481.2490323 30.00000000 96.08254679 0.04433188322 790.7309576 34.91104149 480.6752838 35.00000000 97.09488082 0.04437362239
-
Aucun système particulier d'unités n'est spécifié par Suivi de particules. Il est important que toutes les données soient dans un ensemble cohérent d'unités, utilisant les mêmes unités de temps (secondes, jours, années) et de longueur (pieds, mètres).
-
L'emplacement source doit être dans la limite des rasters en entrée et ne peut pas être dans une zone de valeur NoData.
-
Le fichier de suivi se termine si la piste atteint l'extérieur de la zone d'étude et n'a pas rencontré le temps de suivi maximal spécifié.
-
Si la particule faisant l'objet d'un suivi a atteint la limite de la zone d'étude au moment indiqué et que le point de prédiction est à l'extérieur de la zone d'étude, le fichier de suivi se termine.
-
Si la particule faisant l'objet d'un suivi migre vers une dépression au moment indiqué, le fichier de suivi se termine. Une dépression peut être créée par un puits de décharge ou une autre cuvette.
-
Les deux sorties de cet outil sont :
- un fichier ASCII de suivi de particules utilisant le nom spécifié en tant que fichier de suivi de particules en sortie ;
- une classe d'entités polylignes facultative.
Syntaxe
| Paramètre | Explication | Type de données |
in_direction_raster |
Raster en entrée dans lequel chaque valeur de cellule représente la direction du vecteur de vitesse d'infiltration (vitesse linéaire moyenne) au centre de la cellule. Les directions sont exprimées dans les coordonnées du compas, en degrés dans le sens horaire à partir du Nord. Elles peuvent être créées par l'outil Flux de Darcy. Les valeurs de direction doivent être des valeurs à virgules flottantes. | Raster Layer |
in_magnitude_raster |
Raster en entrée dans lequel chaque valeur de cellule représente la magnitude du vecteur de vitesse d'infiltration (vitesse linéaire moyenne) au centre de la cellule. Les unités correspondent à une longueur/temps. Elles peuvent être créées par l'outil Flux de Darcy. | Raster Layer |
source_point |
Localisation du point source à partir duquel commencer le suivi de particules. Elle est entrée sous la forme de nombres correspondant aux coordonnées x,y de la position en unités de carte. | Point |
out_track_file |
Fichier texte ASCII en sortie qui contient les données de suivi de particules. | File |
step_length (Facultatif) |
Longueur de pas à utiliser pour le calcul du suivi des particules. La valeur par défaut correspond à la moitié de la taille des cellules. Les unités correspondent à une longueur. | Double |
tracking_time (Facultatif) |
Temps écoulé maximal pour le suivi des particules. L'algorithme suit la piste tant que ce temps n'est pas écoulé ou que la particule ne sort pas du raster ou n'entre pas dans une dépression. La valeur par défaut correspond à l'infini. Les unités correspondent à un temps. | Double |
out_track_polyline_features (Facultatif) |
Classe d'entités linéaires en sortie facultative qui contient le suivi de particules. Cette classe d'entités contient une série d'arcs avec des attributs pour la position, la direction et l'amplitude de la vitesse locale, ainsi que la longueur cumulée et la durée de transport le long du chemin. | Feature Class |
Exemple de code
Cet exemple exécute l'outil sur les entrées requises et génère un fichier ASCII de données de suivi de particules et une classe d'entités de fichiers de formes du suivi de particules.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
ParticleTrack("gwdir", "gwmag", arcpy.Point(-200,-200),
"C:/sapyexamples/output/trackfile.txt",10, 100000,
"C:/sapyexamples/output/trackpolyline.shp")
Cet exemple exécute l'outil sur les entrées requises et génère un fichier ASCII de données de suivi de particules et une classe d'entités de fichiers de formes du suivi de particules.
# Name: ParticleTrack_Ex_02.py
# Description: Calculates the path of a particle through a velocity field.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inDirectionRaster = "gwdir"
inMagnitudeRaster = "gwmag"
sourcePoint = arcpy.Point(-200, -200)
outTrackFile = "C:/sapyexamples/output/trackfile.txt"
stepLength = 10
trackingTime = 10000000
outTrackPolylineFeatures = "C:/sapyexamples/output/trackpolyline.shp"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute ParticleTrack
ParticleTrack(inDirectionRaster, inMagnitudeRaster, sourcePoint, outTrackFile,
stepLength, trackingTime, outTrackPolylineFeatures)