com.esri.arcgis.spatialanalyst
Interface IGroundwaterOp

All Superinterfaces:

Serializable

All Known Implementing Classes:

RasterGroundwaterOp

public interface IGroundwaterOp
extends Serializable

Provides access to members that perform groundwater analysis on raster data.

Remarks

Read the Working with ArcGIS Spatial Analyst objects technical document for general information on implementing Spatial Analyst operations.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

Method Summary

IGeoDataset	darcyFlow(IGeoDataset headRaster, IGeoDataset porosityRaster, IGeoDataset thicknessRaster, IGeoDataset transmissivityRaster, boolean createDirection, boolean createMagnitude) Calculates the groundwater volume balance residual and other outputs for steady flow in an aquifer.
IGeoDataset	darcyVelocity(IGeoDataset headRaster, IGeoDataset porosityRaster, IGeoDataset thicknessRaster, IGeoDataset transmissivityRaster) Calculates the groundwater seepage velocity vector (direction and magnitude) for steady flow in an aquifer.
IGeoDataset	particleTrack(IGeoDataset directionRaster, IGeoDataset magnitudeRaster, IPoint sourcePoint, String trackFile, Object stepLength, Object trackingTime) Calculates the path of a particle through a velocity field.
IGeoDataset	porousPuff(String trackFile, IGeoDataset porosityRaster, IGeoDataset thicknessRaster, double mass, Object dispersionTime, Object longitudinalDispersivity, Object dispersivityRatio, Object retardationFactor, Object decayCoefficient) Calculates the time-dependent, two-dimensional concentration distribution in mass per volume of a solute introduced instantaneously and at a discrete point into a vertically mixed aquifer.

Method Detail

darcyFlow

IGeoDataset darcyFlow(IGeoDataset headRaster,
                      IGeoDataset porosityRaster,
                      IGeoDataset thicknessRaster,
                      IGeoDataset transmissivityRaster,
                      boolean createDirection,
                      boolean createMagnitude)
                      throws IOException,
                             AutomationException

Calculates the groundwater volume balance residual and other outputs for steady flow in an aquifer.

Remarks

headRaster	raster containing values of groundwater head elevation for each cell in the raster The head is typically an elevation above some datum, such as mean sea level.
porosityRaster	raster containing values of effective formation porosity for each cell in the raster
thicknessRaster	raster containing values of saturated thickness for each cell in the raster
transmissivityRaster	raster containing values of formation transmissivity for each cell in the raster The transmissivity of an aquifer is defined as the hydraulic conductivity K times the saturated aquifer thickness b, as units of length squared over time. This property is generally estimated from field experimental data such as pumping tests.
createDirection	a Boolean if True will create an output raster of the direction of the seepage velocity vector (average linear velocity) at the center of the cell, calculated as the average value of the seepage velocity through the four faces of the cell It is used with the magnitude raster to describe the flow vector.
createMagnitude	a Boolean if True will create an output raster of the magnitude of the seepage velocity vector (average linear velocity) at the center of the cell, calculated as the average value of the seepage velocity through the four faces of the cell It is used with the direction raster to describe the flow vector.

• The method returns a reference to a Raster object.
• Read the Working with ArcGIS Spatial Analyst objects technical document for general information on implementing Spatial Analyst operations.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

Supported Platforms

Windows, Solaris, Linux

Parameters:

headRaster - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)

porosityRaster - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)

thicknessRaster - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)

transmissivityRaster - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)

createDirection - The createDirection (in)

createMagnitude - The createMagnitude (in)

Returns:

A reference to a com.esri.arcgis.geodatabase.IGeoDataset

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

darcyVelocity

IGeoDataset darcyVelocity(IGeoDataset headRaster,
                          IGeoDataset porosityRaster,
                          IGeoDataset thicknessRaster,
                          IGeoDataset transmissivityRaster)
                          throws IOException,
                                 AutomationException

Calculates the groundwater seepage velocity vector (direction and magnitude) for steady flow in an aquifer.

Remarks

headRaster	Raster containing values of groundwater head elevation for each cell in the raster. The head is typically an elevation above some datum, such as mean sea level.
porosityRaster	Raster containing values of effective formation porosity for each cell in the raster
thicknessRaster	Raster containing values of saturated thickness for each cell in the raster
transmissivityRaster	Raster containing values of formation transmissivity for each cell in the raster The transmissivity of an aquifer is defined as the hydraulic conductivity K times the saturated aquifer thickness b, as units of length squared over time. This property is generally estimated from field experimental data such as pumping tests.

• The method returns a reference to a Raster object.
• Use a RasterBandCollection for output direction and magnitude rasters.
• Read the Working with ArcGIS Spatial Analyst objects technical document for general information on implementing Spatial Analyst operations.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

Supported Platforms

Windows, Solaris, Linux

Parameters:

headRaster - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)

porosityRaster - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)

thicknessRaster - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)

transmissivityRaster - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)

Returns:

A reference to a com.esri.arcgis.geodatabase.IGeoDataset

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

particleTrack

IGeoDataset particleTrack(IGeoDataset directionRaster,
                          IGeoDataset magnitudeRaster,
                          IPoint sourcePoint,
                          String trackFile,
                          Object stepLength,
                          Object trackingTime)
                          throws IOException,
                                 AutomationException

Calculates the path of a particle through a velocity field.

Remarks

directionRaster	Raster containing values of direction of the velocity; associated with the magnitude Raster Directions are expressed in compass coordinates, in degrees clockwise from north. This may be created by the IGroundwaterOp::DarcyFlow method or IGroundwaterOp::DarcyVelocy method.
magnitudeRaster	Raster containing values of the magnitude of the velocity; associated with the direction Raster Units are length/time. This may be created by the IGroundwaterOp::DarcyFlow methods or IGroundwaterOp::DarcyVelocy method.
sourcePoint	location of the source point from which to begin the particle tracking This is entered as numbers identifying the position in map units.
trackFile	the name of the ASCII trackfile which will be created by the method
[stepLength]	user-defined value for a characteristic step length used for calculating the particle track If none is specified the stepLength will be one half the cell size. Units are length.
[trackingTime]	maximum elapsed time for particle tracking ParticleTrack will follow the track until either this time is met or the particle migrates off the Raster or into a depression. If no trackingTime is specified the value will be infinity. Units are time.

• Read the Working with ArcGIS Spatial Analyst objects technical document for general information on implementing Spatial Analyst operations.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

Supported Platforms

Windows, Solaris, Linux

Parameters:

directionRaster - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)

magnitudeRaster - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)

sourcePoint - A reference to a com.esri.arcgis.geometry.IPoint (in)

trackFile - The trackFile (in)

stepLength - A Variant (in, optional, pass null if not required)

trackingTime - A Variant (in, optional, pass null if not required)

Returns:

A reference to a com.esri.arcgis.geodatabase.IGeoDataset

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

porousPuff

IGeoDataset porousPuff(String trackFile,
                       IGeoDataset porosityRaster,
                       IGeoDataset thicknessRaster,
                       double mass,
                       Object dispersionTime,
                       Object longitudinalDispersivity,
                       Object dispersivityRatio,
                       Object retardationFactor,
                       Object decayCoefficient)
                       throws IOException,
                              AutomationException

Calculates the time-dependent, two-dimensional concentration distribution in mass per volume of a solute introduced instantaneously and at a discrete point into a vertically mixed aquifer.

Remarks

trackFile	The path file required by this method is an ASCII text file containing information about the position, the local velocity vector, and the cumulative length and time of travel along the path. This file is generated using the ParticleTrack method
porosityRaster	An input Raster, RasterDataset, RasterBand, or RasterDescriptor containing values of effective formation porosity for each cell in the Raster.
thicknessRaster	An input Raster, RasterDataset, RasterBand, or RasterDescriptor containing values of saturated thickness for each cell in the Raster.
mass	Value representing the amount of mass released instantaneously at the source point, in units of mass
[dispersionTime]	Value representing the time horizon for dispersion of the solute, with units of time The time must be less than or equal to the maximum time in the track file. If the requested time exceeds the available times from the track file, the function is aborted. The default time is the latest time (corresponding to the terminal point) in the track file.
[longitudinalDispersivity]	Value representing the dispersivity parallel to the flow direction, with units of length.
[dispersivityRatio]	Value representing the ratio of longitudinal dispersivity over transverse dispersivity. Transverse dispersivity is perpendicular to the flow direction in the same horizontal plane The default value is 3.
[retardationFactor]	A dimensionless value representing the retardation of the solute in the aquifer Retardation varies between 1 and infinity, with 1 corresponding to no retardation. The default value is 1.
[decayCoefficient]	Decay coefficient for solutes undergoing first-order exponential decay (e.g., radionuclides) in units of inverse time The default is zero, corresponding to no decay.

• The method returns a reference to a Raster object.
• Read the Working with ArcGIS Spatial Analyst objects technical document for general information on implementing Spatial Analyst operations.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

Supported Platforms

Windows, Solaris, Linux

Parameters:

trackFile - The trackFile (in)

porosityRaster - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)

thicknessRaster - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)

mass - The mass (in)

dispersionTime - A Variant (in, optional, pass null if not required)

longitudinalDispersivity - A Variant (in, optional, pass null if not required)

dispersivityRatio - A Variant (in, optional, pass null if not required)

retardationFactor - A Variant (in, optional, pass null if not required)

decayCoefficient - A Variant (in, optional, pass null if not required)

Returns:

A reference to a com.esri.arcgis.geodatabase.IGeoDataset

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.