Darcy Flow (Spatial Analyst)

License Level:BasicStandardAdvanced

Summary

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

Learn more about how Darcy Flow and Darcy Velocity work

Usage

Syntax

DarcyFlow (in_head_raster, in_porosity_raster, in_thickness_raster, in_transmissivity_raster, {out_direction_raster}, {out_magnitude_raster})
ParameterExplanationData Type
in_head_raster

The input raster where each cell value represents the groundwater head elevation at that location.

The head is typically an elevation above some datum, such as mean sea level.

Raster Layer
in_porosity_raster

The input raster where each cell value represents the effective formation porosity at that location.

Raster Layer
in_thickness_raster

The input raster where each cell value represents the saturated thickness at that location.

The value for the thickness is interpreted from geological properties of the aquifer.

Raster Layer
in_transmissivity_raster

The input raster where each cell value represents the formation transmissivity at that location.

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. Tables 1 and 2 in How Darcy Flow and Darcy Velocity work list ranges of hydraulic conductivities for some generalized geologic materials.

Raster Layer
out_direction_raster
(Optional)

The output flow direction raster.

Each cell value represents 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 output magnitude raster to describe the flow vector.

Raster Dataset
out_magnitude_raster
(Optional)

An optional output raster where each cell value represents 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 output direction raster to describe the flow vector.

Raster Dataset

Return Value

NameExplanationData Type
out_volume_raster

The output volume balance residual raster.

Each cell value represents the groundwater volume balance residual for steady flow in an aquifer, as determined by Darcy's Law.

Raster

Code Sample

DarcyFlow example 1 (Python window)

This example calculates the groundwater volume balance raster as well as the flow direction and seepage velocity of an aquifer.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outDarcyFlow = DarcyFlow("gwhead", "gwporo", "gwthick","gwtrans", 
                         "C:/sapyexamples/output/outdarcydir",
                         "C:/sapyexamples/output/outdarcymag")
outDarcyFlow.save("C:/sapyexamples/output/outdarcyflo")
DarcyFlow example 2 (stand-alone script)

This example calculates the groundwater volume balance raster as well as the flow direction and seepage velocity of an aquifer.

# Name: DarcyFlow_Ex_02.py
# Description: Calculates the groundwater volume balance residual and other
#    outputs for steady flow in an aquifer.
# 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
inHeadRaster = "gwhead"
inPorosityRaster = "gwporo"
inThicknessRaster = "gwthick"
inTransmissivityRaster = "gwtrans"
outDirectionRaster = "C:/sapyexamples/output/outdarcydir"
outMagnitudeRaster = "C:/sapyexamples/output/outdarcymag"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute DarcyFlow
outDarcyFlow = DarcyFlow(inHeadRaster, inPorosityRaster, inThicknessRaster,
                         inTransmissivityRaster, outDirectionRaster,
                         outMagnitudeRaster)

# Save the output 
outDarcyFlow.save("C:/sapyexamples/output/outdarcyflow")

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: Requires Spatial Analyst
ArcGIS for Desktop Standard: Requires Spatial Analyst
ArcGIS for Desktop Advanced: Requires Spatial Analyst
11/8/2012