com.esri.arcgis.geoprocessing.tools.spatialanalysttools
Class ParticleTrack

java.lang.Object
  com.esri.arcgis.geoprocessing.AbstractGPTool
      com.esri.arcgis.geoprocessing.tools.spatialanalysttools.ParticleTrack

All Implemented Interfaces:

GPTool

public class ParticleTrack
extends AbstractGPTool

Calculates the path of a particle through a velocity field, returning an ASCII file of particle tracking data and, optionally, a coverage of track information. The Particle Track tool is contained in the Spatial Analyst Tools tool box.
Learn more about how Particle Track works

Software restrictions: none

Usage tips:

• The input direction and magnitude rasters should be from the same run of Darcy Flow.
• The path file generated by this function is an ASCII text file containing information about position, local velocity direction and magnitude, and cumulative length and time of travel along the path. This file is used for input by Porous Puff. The format of this file is as follows: time x y length flow dir flow mag0.000000000 0.000000000 482.8400000 0.000000000 90.00000000 0.04418909563113.1648712 4.999804443 482.7957786 5.000000000 91.01366126 0.04418332249226.2741353 9.998043277 482.6630814 10.00000000 92.02765240 0.04420504404339.3574334 14.99315255 482.4419855 15.00000000 93.04094157 0.04421519432452.3447720 19.98356700 482.1325285 20.00000000 94.05521317 0.04425274599565.2657591 24.96772671 481.7348453 25.00000000 95.06807622 0.04427874865678.0514031 29.94406931 481.2490323 30.00000000 96.08254679 0.04433188322790.7309576 34.91104149 480.6752838 35.00000000 97.09488082 0.04437362239
• No particular system of units is specified by Particle Track. It is important that all data be in a consistent set of units, using the same unit for time (seconds, days, years) and length (feet, meters).
• The source location must be within the boundary of the input rasters and cannot be in an area of NoData.
• The track file will end if the track reaches outside the study area and has not met the specified maximum tracking time.
• If the particle being tracked has reached the edge of the study area at the indicated time and the predictor point is outside the study area, the track file will end.
• If the particle being tracked migrates into a depression at the indicated time, the track file will end. A depression can be created by a discharge well or other sink.
• The two outputs from Particle Track are (1) a particle track ASCII file using the name specified as output particle track file, and (2) a polyline feature class (optional).

Field Summary

Fields inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool

vals

Constructor Summary

ParticleTrack()
Creates the Particle Track tool with defaults.

ParticleTrack(Object inDirectionRaster, Object inMagnitudeRaster, Object sourcePoint, Object outTrackFile)
Creates the Particle Track tool with the required parameters.

Method Summary

Object	getInDirectionRaster() Returns the Input direction raster parameter of this tool .
Object	getInMagnitudeRaster() Returns the Input magnitude raster parameter of this tool .
Object	getOutTrackFile() Returns the Output particle track file parameter of this tool .
Object	getOutTrackPolylineFeatures() Returns the Output track polyline features parameter of this tool .
Object	getSourcePoint() Returns the Source point parameter of this tool .
double	getStepLength() Returns the Step length parameter of this tool .
String	getToolboxAlias() Returns the alias of the tool box containing this tool.
String	getToolboxName() Returns the name of the tool box containing this tool.
String	getToolName() Returns the name of this tool.
double	getTrackingTime() Returns the Tracking time parameter of this tool .
void	setInDirectionRaster(Object inDirectionRaster) Sets the Input direction raster parameter of this tool .
void	setInMagnitudeRaster(Object inMagnitudeRaster) Sets the Input magnitude raster parameter of this tool .
void	setOutTrackFile(Object outTrackFile) Sets the Output particle track file parameter of this tool .
void	setOutTrackPolylineFeatures(Object outTrackPolylineFeatures) Sets the Output track polyline features parameter of this tool .
void	setSourcePoint(Object sourcePoint) Sets the Source point parameter of this tool .
void	setStepLength(double stepLength) Sets the Step length parameter of this tool .
void	setTrackingTime(double trackingTime) Sets the Tracking time parameter of this tool .

Methods inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool

getParameterValues, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ParticleTrack

public ParticleTrack()

Creates the Particle Track tool with defaults.

Initializes the array of tool parameters with the default values specified when the tool was created.

ParticleTrack

public ParticleTrack(Object inDirectionRaster,
                     Object inMagnitudeRaster,
                     Object sourcePoint,
                     Object outTrackFile)

Creates the Particle Track tool with the required parameters.

Initializes the array of tool parameters with the values as specified for the required parameters and with the default values for the other parameters.

Parameters:

inDirectionRaster - Composite Geodataset, direction values must be floating point.

inMagnitudeRaster - Composite Geodataset, units are length/time. This can be created by the Darcy Flow function.

sourcePoint - Point, this is entered as numbers identifying the x,y coordinates of the position in map units.

outTrackFile - File, the output ASCII text file that contains the particle tracking data.

Method Detail

getInDirectionRaster

public Object getInDirectionRaster()

Returns the Input direction raster parameter of this tool . This parameter is Composite Geodataset, direction values must be floating point. This is a required parameter.

Returns:

the Input direction raster

setInDirectionRaster

public void setInDirectionRaster(Object inDirectionRaster)

Sets the Input direction raster parameter of this tool . This parameter is Composite Geodataset, direction values must be floating point. This is a required parameter.

Parameters:

inDirectionRaster - Composite Geodataset, direction values must be floating point.

getInMagnitudeRaster

public Object getInMagnitudeRaster()

Returns the Input magnitude raster parameter of this tool . This parameter is Composite Geodataset, units are length/time. This can be created by the Darcy Flow function. This is a required parameter.

Returns:

the Input magnitude raster

setInMagnitudeRaster

public void setInMagnitudeRaster(Object inMagnitudeRaster)

Sets the Input magnitude raster parameter of this tool . This parameter is Composite Geodataset, units are length/time. This can be created by the Darcy Flow function. This is a required parameter.

Parameters:

inMagnitudeRaster - Composite Geodataset, units are length/time. This can be created by the Darcy Flow function.

getSourcePoint

public Object getSourcePoint()

Returns the Source point parameter of this tool . This parameter is Point, this is entered as numbers identifying the x,y coordinates of the position in map units. This is a required parameter.

Returns:

the Source point

setSourcePoint

public void setSourcePoint(Object sourcePoint)

Sets the Source point parameter of this tool . This parameter is Point, this is entered as numbers identifying the x,y coordinates of the position in map units. This is a required parameter.

Parameters:

sourcePoint - Point, this is entered as numbers identifying the x,y coordinates of the position in map units.

getOutTrackFile

public Object getOutTrackFile()

Returns the Output particle track file parameter of this tool . This parameter is File, the output ASCII text file that contains the particle tracking data. This is a required parameter.

Returns:

the Output particle track file

setOutTrackFile

public void setOutTrackFile(Object outTrackFile)

Sets the Output particle track file parameter of this tool . This parameter is File, the output ASCII text file that contains the particle tracking data. This is a required parameter.

Parameters:

outTrackFile - File, the output ASCII text file that contains the particle tracking data.

getStepLength

public double getStepLength()

Returns the Step length parameter of this tool . This parameter is Double, the default is one half the cell size. Units are length. This is an optional parameter.

Returns:

the Step length

setStepLength

public void setStepLength(double stepLength)

Sets the Step length parameter of this tool . This parameter is Double, the default is one half the cell size. Units are length. This is an optional parameter.

Parameters:

stepLength - Double, the default is one half the cell size. Units are length.

getTrackingTime

public double getTrackingTime()

Returns the Tracking time parameter of this tool . This parameter is Double, the default value is infinity. Units are time. This is an optional parameter.

Returns:

the Tracking time

setTrackingTime

public void setTrackingTime(double trackingTime)

Sets the Tracking time parameter of this tool . This parameter is Double, the default value is infinity. Units are time. This is an optional parameter.

Parameters:

trackingTime - Double, the default value is infinity. Units are time.

getOutTrackPolylineFeatures

public Object getOutTrackPolylineFeatures()

Returns the Output track polyline features parameter of this tool . This parameter is Feature Class, this feature class contains a series of arcs with attributes for position, local velocity direction and magnitude, and cumulative length and time of travel along the path. This is an optional parameter.

Returns:

the Output track polyline features

setOutTrackPolylineFeatures

public void setOutTrackPolylineFeatures(Object outTrackPolylineFeatures)

Sets the Output track polyline features parameter of this tool . This parameter is Feature Class, this feature class contains a series of arcs with attributes for position, local velocity direction and magnitude, and cumulative length and time of travel along the path. This is an optional parameter.

Parameters:

outTrackPolylineFeatures - Feature Class, this feature class contains a series of arcs with attributes for position, local velocity direction and magnitude, and cumulative length and time of travel along the path.

getToolName

public String getToolName()

Returns the name of this tool.

Returns:

the tool name

getToolboxName

public String getToolboxName()

Returns the name of the tool box containing this tool.

Returns:

the tool box name

getToolboxAlias

public String getToolboxAlias()

Returns the alias of the tool box containing this tool.

Returns:

the tool box alias