LinearFVMomentumFriction

This kernel adds Darcy and Forchheimer resistance to a linear finite volume momentum equation. For superficial velocity , its componentwise resistance is

where is the dynamic viscosity, the density, the porosity, and and the componentwise Darcy and Forchheimer coefficients, which may be anisotropic. The resistance opposes the flow and is added to the momentum equation as on the left-hand side. The Darcy term represents viscous drag and is linear in velocity; the Forchheimer term represents inertial drag and grows quadratically with speed. Either term may be omitted. "mu" is required with "Darcy_name", while density and all velocity components present in the mesh dimension are required with "Forchheimer_name".

The Forchheimer speed is evaluated from interstitial velocity and lagged in the linear solve. Porosity must be positive wherever the Forchheimer term is active.

[LinearFVKernels<<<{"href": "../../syntax/LinearFVKernels/index.html"}>>>]
  [u_friction]
    type = LinearFVMomentumFriction<<<{"description": "Computes Darcy and/or Forchheimer resistance in a Navier-Stokes momentum equation.", "href": "LinearFVMomentumFriction.html"}>>>
    variable<<<{"description": "The name of the variable whose linear system this object contributes to"}>>> = superficial_u
    Forchheimer_name<<<{"description": "Name of the Forchheimer coefficients property. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = forch
    porosity<<<{"description": "The porosity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = porosity
    rho<<<{"description": "The density required by Forchheimer resistance. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = ${rho}
    u<<<{"description": "The x-component of superficial velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = superficial_u
    momentum_component<<<{"description": "The component of the momentum equation that this kernel applies to."}>>> = 'x'
    block<<<{"description": "The list of blocks (ids or names) that this object will be applied"}>>> = 2
  []
[]
(modules/navier_stokes/test/tests/finite_volume/pins/channel-flow/linear-segregated/1d-simple-channel/porous-baffle-1d.i)

Computation of friction factors and pre-factors

See PINSFVMomentumFriction for how the Darcy and Forchheimer coefficients relate to common correlations.

Input Parameters

  • momentum_componentThe component of the momentum equation that this kernel applies to.

    C++ Type:MooseEnum

    Options:x, y, z

    Controllable:No

    Description:The component of the momentum equation that this kernel applies to.

  • variableThe name of the variable whose linear system this object contributes to

    C++ Type:LinearVariableName

    Unit:(no unit assumed)

    Controllable:No

    Description:The name of the variable whose linear system this object contributes to

Required Parameters

  • Darcy_nameName of the Darcy coefficients property. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

    C++ Type:MooseFunctorName

    Unit:(no unit assumed)

    Controllable:No

    Description:Name of the Darcy coefficients property. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

  • Forchheimer_nameName of the Forchheimer coefficients property. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

    C++ Type:MooseFunctorName

    Unit:(no unit assumed)

    Controllable:No

    Description:Name of the Forchheimer coefficients property. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

  • blockThe list of blocks (ids or names) that this object will be applied

    C++ Type:std::vector<SubdomainName>

    Controllable:No

    Description:The list of blocks (ids or names) that this object will be applied

  • muThe dynamic viscosity required by Darcy resistance. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

    C++ Type:MooseFunctorName

    Unit:(no unit assumed)

    Controllable:No

    Description:The dynamic viscosity required by Darcy resistance. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

  • porosity1The porosity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

    Default:1

    C++ Type:MooseFunctorName

    Unit:(no unit assumed)

    Controllable:No

    Description:The porosity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

  • rhoThe density required by Forchheimer resistance. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

    C++ Type:MooseFunctorName

    Unit:(no unit assumed)

    Controllable:No

    Description:The density required by Forchheimer resistance. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

  • uThe x-component of superficial velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

    C++ Type:MooseFunctorName

    Unit:(no unit assumed)

    Controllable:No

    Description:The x-component of superficial velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

  • vThe y-component of superficial velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

    C++ Type:MooseFunctorName

    Unit:(no unit assumed)

    Controllable:No

    Description:The y-component of superficial velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

  • wThe z-component of superficial velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

    C++ Type:MooseFunctorName

    Unit:(no unit assumed)

    Controllable:No

    Description:The z-component of superficial velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

Optional Parameters

  • absolute_value_vector_tagsThe tags for the vectors this residual object should fill with the absolute value of the residual contribution

    C++ Type:std::vector<TagName>

    Controllable:No

    Description:The tags for the vectors this residual object should fill with the absolute value of the residual contribution

  • extra_matrix_tagsThe extra tags for the matrices this Kernel should fill

    C++ Type:std::vector<TagName>

    Controllable:No

    Description:The extra tags for the matrices this Kernel should fill

  • extra_vector_tagsThe extra tags for the vectors this Kernel should fill

    C++ Type:std::vector<TagName>

    Controllable:No

    Description:The extra tags for the vectors this Kernel should fill

  • matrix_onlyFalseWhether this object is only doing assembly to matrices (no vectors)

    Default:False

    C++ Type:bool

    Controllable:No

    Description:Whether this object is only doing assembly to matrices (no vectors)

  • matrix_tagssystemThe tag for the matrices this Kernel should fill

    Default:system

    C++ Type:MultiMooseEnum

    Options:nontime, system

    Controllable:No

    Description:The tag for the matrices this Kernel should fill

  • vector_tagsrhsThe tag for the vectors this Kernel should fill

    Default:rhs

    C++ Type:MultiMooseEnum

    Options:rhs, time

    Controllable:No

    Description:The tag for the vectors this Kernel should fill

Contribution To Tagged Field Data Parameters

  • control_tagsAdds user-defined labels for accessing object parameters via control logic.

    C++ Type:std::vector<std::string>

    Controllable:No

    Description:Adds user-defined labels for accessing object parameters via control logic.

  • enableTrueSet the enabled status of the MooseObject.

    Default:True

    C++ Type:bool

    Controllable:Yes

    Description:Set the enabled status of the MooseObject.

  • implicitTrueDetermines whether this object is calculated using an implicit or explicit form

    Default:True

    C++ Type:bool

    Controllable:No

    Description:Determines whether this object is calculated using an implicit or explicit form

  • seed0The seed for the master random number generator

    Default:0

    C++ Type:unsigned int

    Controllable:No

    Description:The seed for the master random number generator

  • use_displaced_meshFalseWhether or not this object should use the displaced mesh for computation. Note that in the case this is true but no displacements are provided in the Mesh block the undisplaced mesh will still be used.

    Default:False

    C++ Type:bool

    Controllable:No

    Description:Whether or not this object should use the displaced mesh for computation. Note that in the case this is true but no displacements are provided in the Mesh block the undisplaced mesh will still be used.

Advanced Parameters

  • ghost_layers1The number of layers of elements to ghost.

    Default:1

    C++ Type:unsigned short

    Controllable:No

    Description:The number of layers of elements to ghost.

  • use_point_neighborsFalseWhether to use point neighbors, which introduces additional ghosting to that used for simple face neighbors.

    Default:False

    C++ Type:bool

    Controllable:No

    Description:Whether to use point neighbors, which introduces additional ghosting to that used for simple face neighbors.

Parallel Ghosting Parameters

Input Files