QGIS/python/plugins/sextante/taudem/help/dinfconclimaccum.html
2012-10-22 19:00:50 +03:00

101 lines
6.1 KiB
HTML

<html>
<head><link rel="stylesheet" type="text/css" href="help.css"/></head>
<body>
<h1 class='module'>D-Infinity Concentration Limited Acccumulation</h1>
<div class='author'>(c) 2010 by David G. Tarboton</div>
<div class='description'>This function applies to the situation where an
unlimited supply of a substance is loaded into flow at a concentration or
solubility threshold Csol over a region indicated by an indicator grid (dg).
It a grid of the concentration of a substance at each location in the domain,
where the supply of substance from a supply area is loaded into the flow
at a concentration or solubility threshold. The flow is first calculated
as a D-infinity weighted contributing area of an input Effective Runoff
Weight Grid (notionally excess precipitation). The concentation of substance
over the supply area (indicator grid) is at the concentration threshold.
As the substance moves downslope with the D-infinity flow field, it is
subject to first order decay in moving from cell to cell as well as dilution
due to changes in flow. The decay multiplier grid gives the fractional
(first order) reduction in quantity in moving from grid cell <tt>x</tt>
to the next downslope cell. If the outlets shapefile is used, the tool
only evaluates the part of the domain that contributes flow to the locations
given by the shapefile. This is useful for a tracking a contaminant or
compound from an area with unlimited supply of that compound that is
loaded into a flow at a concentration or solubility threshold over a zone
and flow from the zone may be subject to decay or attenuation.</div>
<div class='description'>The indicator grid (<tt>dg</tt>) is used to delineate
the area of the substance supply using the (0, 1) indicator function <tt>i(x)</tt>.
<tt>A[]</tt> denotes the weighted accumulation operator evaluated using
the D-Infinity Contributing Area function. The Effective Runoff Weight
Grid gives the supply to the flow (e.g. the excess rainfall if this is
overland flow) denoted as <tt>w(x)</tt>. The specific discharge is then
given by:</div>
<pre align="center">Q(x)=A[w(x)].</pre>
<div class='description'>This weighted accumulation <tt>Q(x)</tt> is output
as the Overland Flow Specific Discharge Grid. Over the substance supply area
concentration is at the threshold (the threshold is a saturation or solubility
limit). If <tt>i(x) = 1</tt>, then</div>
<pre align="center">C(x) = Csol, and L(x) = Csol Q(x),</pre>
<div class='description'>where <tt>L(x)</tt> denotes the load being carried
by the flow. At remaining locations, the load is determined by load accumulation
and the concentration by dilution:</div>
<p align="center"><img src="img/claeqn.gif"></img></p>
<div class='description'>Here <tt>d(x) = d(i, j)</tt> is a decay multiplier
giving the fractional (first order) reduction in mass in moving from grid
cell <tt>x</tt> to the next downslope cell. If travel (or residence) times
<tt>t(x)</tt> associated with flow between cells are available <tt>d(x)</tt>
may be evaluated as <tt>exp(-k t(x))</tt> where <tt>k</tt> is a first order
decay parameter. The Concentration grid output is <tt>C(x)</tt>. If the
outlets shapefile is used, the tool only evaluates the part of the domain
that contributes flow to the locations given by the shapefile.</div>
<p align="center"><img src="img/clafig.gif"></img></p>
<div class='description'>Useful for a tracking a contaminant released or
partitioned to flow at a fixed threshold concentration.</div>
<h2>Parameters</h2>
<dl class='parameters'>
<dt>Number of Processes <div class='type'>Integer</div></dt>
<dd>The number of stripes that the domain will be divided into and the
number of MPI parallel processes that will be spawned to evaluate each
of the stripes.</dd>
<dt>D-Infinity Flow Direction Grid <div class='type'>Raster Grid</div></dt>
<dd>A grid giving flow direction by the D-infinity method. Flow direction
is measured in radians, counter clockwise from east. This grid can be
created by the function &quot;D-Infinity Flow Directions&quot;.</dd>
<dt>Disturbance Indicator Grid <div class='type'>Raster Grid (optional)</div></dt>
<dd>A grid that indicates the source zone of the area of substance
supply and must be 1 inside the zone and 0 or &quot;no data&quot; over
the rest of the domain.</dd>
<dt>Decay Multiplier Grid <div class='type'>Raster Grid</div></dt>
<dd>A grid giving the factor by which flow leaving each grid cell is
multiplied before accumulation on downslope grid cells. This may be
used to simulate the movement of an attenuating or decaying substance.
If travel (or residence) times <tt>t(x)</tt> associated with flow between
cells are available <tt>d(x)</tt> may be evaluated as <tt>exp(-k t(x))</tt>
where <tt>k</tt> is a first order decay parameter.</dd>
<dt>Effective Runoff Weight Grid <div class='type'>Raster Grid</div></dt>
<dd>A grid giving the input quantity (notionally effective runoff or
excess precipitation) to be used in the D-infinity weighted contributing
area evaluation of Overland Flow Specific Discharge.</dd>
<dt>Outlets Shapefile <div class='type'>Point Shapefile (optional)</div></dt>
<dd>This optional input is a point shapefile defining outlets of interest.
If this file is used, the tool will only evaluate the area upslope of
these outlets.</dd>
<dt>Concentration Threshold <div class='type'>Double</div></dt>
<dd>The concentration or solubility threshold. Over the substance supply
area, concentration is at this threshold. Default <strong>1.0</strong>.</dd>
<dt>Check for edge contamination <div class='type'>Boolean</div></dt>
<dd>This option determines whether the tool should check for edge
contamination. Edge contamination is defined as the possibility that
a value may be underestimated due to grid cells outside of the domain
not being considered when determining contributing area. Default
<strong>True</strong>.</dd>
</dl>
<h2>Outputs</h2>
<dl class='parameters'>
<dt>Concentration Grid <div class='type'>Raster Grid</div></dt>
<dd>A grid giving the resulting concentration of the compound of interest
in the flow.</dd>
</dl>
</body></html>