WCNSFVMomentumFluxBC

Flux boundary conditions for momentum advection.

The momentum flux is:

with the momentum flux, the density, the fluid velocity (assumed normal to the surface), the mass flow rate and the inlet area.

There are two options for specifying the momentum flux:

  • specifying a mass flow rate postprocessor, which is then divided by the area of the inlet, which may also be a postprocessor.

  • specifying an inlet velocity postprocessor and a density functor. The functor is usually a functor material property, defined by a GeneralFunctorFluidProps.

The scaling factor may be used if the inlet is not aligned with the X or Y direction, in which case a projection is necessary and this boundary condition should be used for both components of the momentum equation.

This boundary condition works with postprocessors, which may be replaced by constant values in the input. The intended use case for this boundary condition is to be receiving its value from a coupled application, using a Receiver postprocessor.

Example input syntax

In this example input, the inlet boundary condition to the momentum conservation equation is specified using a WCNSFVMomentumFluxBC. The momentum flux is specified using the mass flow rate and the inlet area.

[FVBCs<<<{"href": "../../syntax/FVBCs/index.html"}>>>]
  # Inlet
  [inlet_mass]
    type = WCNSFVMassFluxBC<<<{"description": "Flux boundary conditions for mass advection.", "href": "WCNSFVMassFluxBC.html"}>>>
    variable<<<{"description": "The name of the variable that this boundary condition applies to"}>>> = pressure
    boundary<<<{"description": "The list of boundary IDs from the mesh where this object applies"}>>> = 'left'
    mdot_pp<<<{"description": "Postprocessor with the inlet mass flow rate"}>>> = 'inlet_mdot'
    area_pp<<<{"description": "Inlet area as a postprocessor"}>>> = 'area_pp_left'
    rho<<<{"description": "Density functor. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = 'rho'
    vel_x<<<{"description": "The x-axis velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = vel_x
    vel_y<<<{"description": "The y-axis velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = vel_y
  []
  [inlet_u]
    type = WCNSFVMomentumFluxBC<<<{"description": "Flux boundary conditions for momentum advection.", "href": "WCNSFVMomentumFluxBC.html"}>>>
    variable<<<{"description": "The name of the variable that this boundary condition applies to"}>>> = vel_x
    boundary<<<{"description": "The list of boundary IDs from the mesh where this object applies"}>>> = 'left'
    mdot_pp<<<{"description": "Postprocessor with the inlet mass flow rate"}>>> = 'inlet_mdot'
    area_pp<<<{"description": "Inlet area as a postprocessor"}>>> = 'area_pp_left'
    rho<<<{"description": "Density functor. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = 'rho'
    momentum_component<<<{"description": "The component of the momentum equation that this kernel applies to."}>>> = 'x'
    vel_x<<<{"description": "The x-axis velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = vel_x
    vel_y<<<{"description": "The y-axis velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = vel_y
  []
  [inlet_v]
    type = WCNSFVMomentumFluxBC<<<{"description": "Flux boundary conditions for momentum advection.", "href": "WCNSFVMomentumFluxBC.html"}>>>
    variable<<<{"description": "The name of the variable that this boundary condition applies to"}>>> = vel_y
    boundary<<<{"description": "The list of boundary IDs from the mesh where this object applies"}>>> = 'left'
    mdot_pp<<<{"description": "Postprocessor with the inlet mass flow rate"}>>> = 0
    area_pp<<<{"description": "Inlet area as a postprocessor"}>>> = 'area_pp_left'
    rho<<<{"description": "Density functor. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = 'rho'
    momentum_component<<<{"description": "The component of the momentum equation that this kernel applies to."}>>> = 'y'
    vel_x<<<{"description": "The x-axis velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = vel_x
    vel_y<<<{"description": "The y-axis velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = vel_y
  []
  [inlet_T]
    type = WCNSFVEnergyFluxBC<<<{"description": "Flux boundary conditions for energy advection.", "href": "WCNSFVEnergyFluxBC.html"}>>>
    variable<<<{"description": "The name of the variable that this boundary condition applies to"}>>> = T_fluid
    T_fluid<<<{"description": "temperature functor. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = T_fluid
    boundary<<<{"description": "The list of boundary IDs from the mesh where this object applies"}>>> = 'left'
    temperature_pp<<<{"description": "Postprocessor with the inlet temperature"}>>> = 'inlet_T'
    mdot_pp<<<{"description": "Postprocessor with the inlet mass flow rate"}>>> = 'inlet_mdot'
    area_pp<<<{"description": "Inlet area as a postprocessor"}>>> = 'area_pp_left'
    rho<<<{"description": "Density functor. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = 'rho'
    cp<<<{"description": "specific heat capacity functor. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = 'cp'
    vel_x<<<{"description": "The x-axis velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = vel_x
    vel_y<<<{"description": "The y-axis velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = vel_y
  []
  [inlet_scalar]
    type = WCNSFVScalarFluxBC<<<{"description": "Flux boundary conditions for scalar quantity advection.", "href": "WCNSFVScalarFluxBC.html"}>>>
    variable<<<{"description": "The name of the variable that this boundary condition applies to"}>>> = scalar
    boundary<<<{"description": "The list of boundary IDs from the mesh where this object applies"}>>> = 'left'
    scalar_value_pp<<<{"description": "Postprocessor with the inlet scalar concentration"}>>> = 'inlet_scalar_value'
    mdot_pp<<<{"description": "Postprocessor with the inlet mass flow rate"}>>> = 'inlet_mdot'
    area_pp<<<{"description": "Inlet area as a postprocessor"}>>> = 'area_pp_left'
    rho<<<{"description": "Density functor. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = 'rho'
    vel_x<<<{"description": "The x-axis velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = vel_x
    vel_y<<<{"description": "The y-axis velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = vel_y
    passive_scalar<<<{"description": "passive scalar functor. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number."}>>> = scalar
  []

  [outlet_p]
    type = INSFVOutletPressureBC<<<{"description": "Defines a Dirichlet boundary condition for finite volume method.", "href": "INSFVOutletPressureBC.html"}>>>
    variable<<<{"description": "The name of the variable that this boundary condition applies to"}>>> = pressure
    boundary<<<{"description": "The list of boundary IDs from the mesh where this object applies"}>>> = 'right'
    function<<<{"description": "The boundary pressure as a regular function"}>>> = ${outlet_pressure}
  []

  # Walls
  [no_slip_x]
    type = INSFVNoSlipWallBC<<<{"description": "Implements a no slip boundary condition.", "href": "INSFVNoSlipWallBC.html"}>>>
    variable<<<{"description": "The name of the variable that this boundary condition applies to"}>>> = vel_x
    boundary<<<{"description": "The list of boundary IDs from the mesh where this object applies"}>>> = 'top bottom'
    function<<<{"description": "The exact solution function."}>>> = 0
  []
  [no_slip_y]
    type = INSFVNoSlipWallBC<<<{"description": "Implements a no slip boundary condition.", "href": "INSFVNoSlipWallBC.html"}>>>
    variable<<<{"description": "The name of the variable that this boundary condition applies to"}>>> = vel_y
    boundary<<<{"description": "The list of boundary IDs from the mesh where this object applies"}>>> = 'top bottom'
    function<<<{"description": "The exact solution function."}>>> = 0
  []
[]
(modules/navier_stokes/test/tests/finite_volume/wcns/boundary_conditions/flux_bcs_mdot.i)

Input Parameters

  • boundaryThe list of boundary IDs from the mesh where this object applies

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

    Controllable:No

    Description:The list of boundary IDs from the mesh where this object applies

  • 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.

  • rhie_chow_user_objectThe rhie-chow user-object

    C++ Type:UserObjectName

    Controllable:No

    Description:The rhie-chow user-object

  • rhoDensity functor. 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:Density functor. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

  • variableThe name of the variable that this boundary condition applies to

    C++ Type:NonlinearVariableName

    Unit:(no unit assumed)

    Controllable:No

    Description:The name of the variable that this boundary condition applies to

  • vel_xThe x-axis 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-axis velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

Required Parameters

  • area_ppInlet area as a postprocessor

    C++ Type:PostprocessorName

    Unit:(no unit assumed)

    Controllable:No

    Description:Inlet area as a postprocessor

  • direction0 0 0The direction of the flow at the boundary. This is mainly used for cases when an inlet angle needs to be defined with respect to the normal and when a boundary is defined on an internal face where the normal can point in both directions. Use positive mass flux and velocity magnitude if the flux aligns with this direction vector.

    Default:0 0 0

    C++ Type:libMesh::Point

    Controllable:No

    Description:The direction of the flow at the boundary. This is mainly used for cases when an inlet angle needs to be defined with respect to the normal and when a boundary is defined on an internal face where the normal can point in both directions. Use positive mass flux and velocity magnitude if the flux aligns with this direction vector.

  • displacementsThe displacements

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

    Unit:(no unit assumed)

    Controllable:No

    Description:The displacements

  • 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)

  • mdot_ppPostprocessor with the inlet mass flow rate

    C++ Type:PostprocessorName

    Unit:(no unit assumed)

    Controllable:No

    Description:Postprocessor with the inlet mass flow rate

  • scaling_factor1To scale the mass flux

    Default:1

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:To scale the mass flux

  • vel_yThe y-axis 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-axis velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

  • vel_zThe z-axis 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-axis velocity. A functor is any of the following: a variable, a functor material property, a function, a postprocessor or a number.

  • velocity_ppPostprocessor with the inlet velocity norm

    C++ Type:PostprocessorName

    Unit:(no unit assumed)

    Controllable:No

    Description:Postprocessor with the inlet velocity norm

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_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_tagsnontimeThe tag for the vectors this Kernel should fill

    Default:nontime

    C++ Type:MultiMooseEnum

    Options:nontime, 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

  • 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

  • prop_getter_suffixAn optional suffix parameter that can be appended to any attempt to retrieve/get material properties. The suffix will be prepended with a '_' character.

    C++ Type:MaterialPropertyName

    Unit:(no unit assumed)

    Controllable:No

    Description:An optional suffix parameter that can be appended to any attempt to retrieve/get material properties. The suffix will be prepended with a '_' character.

  • use_interpolated_stateFalseFor the old and older state use projected material properties interpolated at the quadrature points. To set up projection use the ProjectedStatefulMaterialStorageAction.

    Default:False

    C++ Type:bool

    Controllable:No

    Description:For the old and older state use projected material properties interpolated at the quadrature points. To set up projection use the ProjectedStatefulMaterialStorageAction.

Material Property Retrieval Parameters

Input Files

Child Objects