粒子追踪 (空间分析)

摘要

通过速度场计算粒子的路径,以返回粒子追踪数据的 ASCII 文件和追踪信息的 coverage(可选)。

了解有关“粒子追踪”工作原理的详细信息

用法

语法

ParticleTrack (in_direction_raster, in_magnitude_raster, source_point, out_track_file, {step_length}, {tracking_time}, {out_track_polyline_features})
参数说明数据类型
in_direction_raster

每个像元值都表示渗流速度矢量(平均线速度)在像元中心的方向的输入栅格。

方向以罗盘坐标(以北为基准方向按顺时针进行测量的度数)表示。这可通过达西流工具创建。

方向值必须为浮点型。

Raster Layer
in_magnitude_raster

每个像元值都表示渗流速度矢量(平均线速度)在像元中心的模的输入栅格。

单位为长度/时间。这可通过达西流工具创建。

Raster Layer
source_point

开始粒子追踪的源点的位置。

它被输入为标识该位置的 x,y 坐标的数字(地图单位)。

Point
out_track_file

包含粒子追踪数据的输出 ASCII 文本文件。

File
step_length
(可选)

用于计算粒子追踪的步长。

默认值为像元大小的一半。单位是长度。

Double
tracking_time
(可选)

进行粒子追踪所经历的最大时间。

算法将沿着追踪轨迹执行,直到达到此时间或者粒子迁移出栅格或陷入洼地。

默认值为无穷大。单位是时间。

Double
out_track_polyline_features
(可选)

包含粒子追踪的可选输出线要素类。

此要素类包含一系列弧,其属性表示沿路径移动的位置、局部速度方向和模以及累积长度和时间。

Feature Class

代码示例

ParticleTrack 示例 1(Python 窗口)

此例对所需输入执行该工具,然后输出粒子追踪数据的 ASCII 文件和粒子追踪的 shapefile 要素类。

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")
ParticleTrack 示例 2(独立脚本)

此例对所需输入执行该工具,然后输出粒子追踪数据的 ASCII 文件和粒子追踪的 shapefile 要素类。

# 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)

环境

相关主题

许可信息

ArcView: 需要 Spatial Analyst
ArcEditor: 需要 Spatial Analyst
ArcInfo: 需要 Spatial Analyst

7/10/2012