<<<<<<<< HEAD:docs/classcmf_1_1upslope_1_1connections_1_1_simple_infiltration.html
1.6.0
========
2.0.0b10
>>>>>>>> cmf2:docs/classcmf_1_1upslope_1_1connections_1_1_conceptual_infiltration.html
catchment modelling framework
Loading...
Searching...
No Matches
ConceptualInfiltration Class Reference

Connects the surfacewater and the most upper layer using a simplified infiltration model suitable for conceptional models. More...

+ Inheritance diagram for ConceptualInfiltration:
+ Collaboration diagram for ConceptualInfiltration:

Detailed Description

Connects the surfacewater and the most upper layer using a simplified infiltration model suitable for conceptional models.

\[ q_{inf} = \left(1-e_{sat}\left(W, W_0\right)\right) q_{inf,pot} \]

where:

  • \(q_{inf}\) Effective infiltration from surface to first layer (soil)
  • \(e_{sat}(W, W_0)\) Saturation excess, ranging from 0 (nowhere saturated soil layer) to 1 (fully saturated). \(W\) is the average wetness calculated from the soil layer, \(W_0\) is a parameter denoting the wetness, where 50% of the layer is saturated using a sigmoidal function:
    • \(e_{sat}(W_{soil}, W_0) = \left(1+e^{-(W-W_0)0.2(1-W_0)}\right)^{-1}\)
  • \(q_{inf,pot}\) is the potential infiltration, given by the incoming fluxes limited by the saturated conductivity:
    • \(q_{inf,pot} = \min(q_{in}, K_{sat} A)\)
      • \(q_{in}\) Sum of incoming fluxes to the surfacewater in \(m^3/day\)
    • \(K_{sat}\) Saturated conductivity in \(m/day\)
    • \(A\) Cell area in \(m^2\)

Public Member Functions

 ConceptualInfiltration (cmf::upslope::SoilLayer::ptr soilwater, cmf::water::flux_node::ptr surfacewater, real W0=0.9)
 Creates the connection between surfacewater and first soil layer.
 
real conc (cmf::math::Time t, const cmf::water::solute &_Solute)
 Returns the concentration of the flux.
 
flux_node::ptr get_target (const flux_node &inquirer)
 Returns the other end of a connection than the asking end.
 
flux_node::ptr get_target (int index) const
 With index 0, the left node is returned, with index 1 the right node of the connection.
 
real get_tracer_filter ()
 A value ranging from 0 to 1 to filter tracers out of the water flux.
 
real get_tracer_filter (solute S)
 A value ranging from 0 to 1 to filter tracers out of the water flux.
 
bool kill_me ()
 Deregisters this connection from its nodes. Returns true if only one reference is left.
 
flux_node::ptr left_node () const
 Returns the left node of this connection.
 
real q (const flux_node &inquirer, cmf::math::Time t)
 Returns the current flux through a connection. Negative signs mean out of the inquirer, positive are inflows to the inquirer.
 
void refresh (cmf::math::Time t)
 Performes a new calculation of the flux.
 
flux_node::ptr right_node () const
 returns the right node of this connection
 
void set_tracer_filter (real value)
 A value ranging from 0 to 1 to filter tracers out of the water flux.
 

Public Attributes

const std::string type
 A string describing the type of the connection.
 
real W0
 Wetness at which only 50% of the potential infiltration \(p_{inf,pot}\).
 

Constructor & Destructor Documentation

◆ ConceptualInfiltration()

ConceptualInfiltration ( cmf::upslope::SoilLayer::ptr soilwater,
cmf::water::flux_node::ptr surfacewater,
real W0 = 0.9 )

Creates the connection between surfacewater and first soil layer.

Parameters
soilwaterthe infiltration target
surfacewaterthe infiltration source
W0the 50% saturation value

Member Function Documentation

◆ conc()

real conc ( cmf::math::Time t,
const cmf::water::solute & _Solute )
inherited

Returns the concentration of the flux.


If not overridden, it returns the concentration of the source of the flux (direction depending)

◆ get_tracer_filter()

real get_tracer_filter ( )
inherited

A value ranging from 0 to 1 to filter tracers out of the water flux.

1.0 is no filter and 0.0 means no solute is crossing this connection

◆ set_tracer_filter()

void set_tracer_filter ( real value)
inherited

A value ranging from 0 to 1 to filter tracers out of the water flux.

1.0 is no filter and 0.0 means no solute is crossing this connection