From a9ced388a55abc85335c1358abfd2ecdf30b526b Mon Sep 17 00:00:00 2001 From: Deepak Rangarajan Date: Mon, 28 Mar 2022 15:14:10 -0400 Subject: [PATCH 1/5] add documentation for specifying flow through EBs --- .../source/inputs/InputsProblemDefinition.rst | 51 +++++++++++++++++++ 1 file changed, 51 insertions(+) diff --git a/docs/source/inputs/InputsProblemDefinition.rst b/docs/source/inputs/InputsProblemDefinition.rst index 2a0aa32..3cec3bd 100644 --- a/docs/source/inputs/InputsProblemDefinition.rst +++ b/docs/source/inputs/InputsProblemDefinition.rst @@ -675,6 +675,7 @@ The type of the boundary conditions in the BC region must be defined. | | * 'mi' for mass inflow BC type | | | | | * 'nsw' for no-slip wall BC type | | | | | * 'eb' for setting inhomogeneous Dirichlet BCs on the contained EBs | | | +| | * 'eb' for setting inflow fluid velocity on the contained EBs. | | | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ For a fluid phase, the following inputs can be defined. @@ -773,3 +774,53 @@ Below is an example for specifying boundary conditions for a fluid `myfluid`. bc.hot-walls = eb bc.hot-walls.eb.temperature = 800 + +In addition to the temperature, it is possible to set an inflow condition for the fluid velocity +on an embedeed boundary face. We recall that, on the remaining part of the EBs, +no slip velocity conditions are assumed by default. + +In the following table there is a list of the possible entries for inflow EB boundary +conditions. Each entry must be preceded by `bc.[region0].` + ++---------------------+-----------------------------------------------------------------------+-------------+-----------+ +| | Description | Type | Default | ++=====================+=======================================================================+=============+===========+ +| fluid.velocity | (Required) Inflow BC for fluid velocity on EBs contained in the | Reals | None | +| | in the (tridimensional) region. | | | +| | Note that if only one value is specified, that is assumed to | | | +| | be the magnitude in the direction of the EB face's normal. | | | ++---------------------+-----------------------------------------------------------------------+-------------+-----------+ +| fluid.volfrac | (Required) Volume fraction. | Real | None | ++---------------------+-----------------------------------------------------------------------+-------------+-----------+ +| eb.normal | (Optional) When specified, only cells with EB face normal parrallel | Reals | None | +| | and opposite in direction to the specified value are | | | +| | imposed with the inflow velocity. | | | ++---------------------+-----------------------------------------------------------------------+-------------+-----------+ +| eb.normal_tol | (Optional) Used in conjunction with `eb.normal`. It determines the | Real | None | +| | tolerance for choosing cells with a specific normal. | | | ++---------------------+-----------------------------------------------------------------------+-------------+-----------+ + +Below is an example for specifying a normal inflow velocity magnitude for a region `eb-flow`. + +.. code-block:: none + + bc.regions = eb-flow + + bc.eb-flow = eb + + bc.eb-flow.fluid.volfrac = 1.0 + bc.eb-flow.fluid.velocity = 0.1 + +Below is an example where only specific cells are imposed a velocity. + +.. code-block:: none + + bc.regions = eb-flow + + bc.eb-flow = eb + + bc.eb-flow.eb.normal_tol = 3.0 + bc.eb-flow.eb.normal = 0.9848 0.0000 0.1736 # 10 deg + + bc.eb-flow.fluid.volfrac = 1.0 + bc.eb-flow.fluid.velocity = 0.1 0.0 0.0 -- GitLab From 55832b678e4b47eea9a0212ab116d2286816dece Mon Sep 17 00:00:00 2001 From: Deepak Rangarajan Date: Mon, 28 Mar 2022 15:18:37 -0400 Subject: [PATCH 2/5] better wording --- docs/source/inputs/InputsProblemDefinition.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/source/inputs/InputsProblemDefinition.rst b/docs/source/inputs/InputsProblemDefinition.rst index 3cec3bd..59a1379 100644 --- a/docs/source/inputs/InputsProblemDefinition.rst +++ b/docs/source/inputs/InputsProblemDefinition.rst @@ -792,8 +792,8 @@ conditions. Each entry must be preceded by `bc.[region0].` +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | fluid.volfrac | (Required) Volume fraction. | Real | None | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ -| eb.normal | (Optional) When specified, only cells with EB face normal parrallel | Reals | None | -| | and opposite in direction to the specified value are | | | +| eb.normal | (Optional) When specified, only cells with EB face normal that is | Reals | None | +| | parallel and opposite in direction to the specified value are | | | | | imposed with the inflow velocity. | | | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | eb.normal_tol | (Optional) Used in conjunction with `eb.normal`. It determines the | Real | None | -- GitLab From 95a2c9f801f7def377169761bfa9921984b226a9 Mon Sep 17 00:00:00 2001 From: Deepak Rangarajan Date: Tue, 29 Mar 2022 09:55:18 -0400 Subject: [PATCH 3/5] add volflow --- docs/source/inputs/InputsProblemDefinition.rst | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/source/inputs/InputsProblemDefinition.rst b/docs/source/inputs/InputsProblemDefinition.rst index 59a1379..85635d7 100644 --- a/docs/source/inputs/InputsProblemDefinition.rst +++ b/docs/source/inputs/InputsProblemDefinition.rst @@ -785,11 +785,15 @@ conditions. Each entry must be preceded by `bc.[region0].` +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | | Description | Type | Default | +=====================+=======================================================================+=============+===========+ -| fluid.velocity | (Required) Inflow BC for fluid velocity on EBs contained in the | Reals | None | -| | in the (tridimensional) region. | | | +| fluid.velocity | (Required if not `volflow`) Inflow BC for fluid velocity on | Reals | None | +| | EBs contained in the (tridimensional) region. | | | | | Note that if only one value is specified, that is assumed to | | | | | be the magnitude in the direction of the EB face's normal. | | | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ +| fluid.volflow | (Required if not `velocity`) Inflow BC for fluid volumetric flow | Real | None | +| | rate in the (tridimensional) region. The flow is assumed to be | | | +| | normal to the EB surface in the region. | | | ++---------------------+-----------------------------------------------------------------------+-------------+-----------+ | fluid.volfrac | (Required) Volume fraction. | Real | None | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | eb.normal | (Optional) When specified, only cells with EB face normal that is | Reals | None | -- GitLab From eff3baad5a94e576b735eae1c0e4720d5f6f6d53 Mon Sep 17 00:00:00 2001 From: Deepak Rangarajan Date: Tue, 29 Mar 2022 09:56:51 -0400 Subject: [PATCH 4/5] tweak --- docs/source/inputs/InputsProblemDefinition.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/inputs/InputsProblemDefinition.rst b/docs/source/inputs/InputsProblemDefinition.rst index 85635d7..958ce83 100644 --- a/docs/source/inputs/InputsProblemDefinition.rst +++ b/docs/source/inputs/InputsProblemDefinition.rst @@ -815,7 +815,7 @@ Below is an example for specifying a normal inflow velocity magnitude for a regi bc.eb-flow.fluid.volfrac = 1.0 bc.eb-flow.fluid.velocity = 0.1 -Below is an example where only specific cells are imposed a velocity. +Below is an example where only specific cells are imposed a velocity in the x-direction. .. code-block:: none -- GitLab From 68419dc68efd8190faceba8e56f9b728d9f120c1 Mon Sep 17 00:00:00 2001 From: jmusser304 <60466395+jmusser304@users.noreply.github.com> Date: Tue, 29 Mar 2022 11:30:03 -0400 Subject: [PATCH 5/5] Update InputsProblemDefinition.rst --- docs/source/inputs/InputsProblemDefinition.rst | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/docs/source/inputs/InputsProblemDefinition.rst b/docs/source/inputs/InputsProblemDefinition.rst index 958ce83..c5699f4 100644 --- a/docs/source/inputs/InputsProblemDefinition.rst +++ b/docs/source/inputs/InputsProblemDefinition.rst @@ -675,7 +675,7 @@ The type of the boundary conditions in the BC region must be defined. | | * 'mi' for mass inflow BC type | | | | | * 'nsw' for no-slip wall BC type | | | | | * 'eb' for setting inhomogeneous Dirichlet BCs on the contained EBs | | | -| | * 'eb' for setting inflow fluid velocity on the contained EBs. | | | +| | * 'eb' for setting inflow for fluid on the EB. | | | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ For a fluid phase, the following inputs can be defined. @@ -756,7 +756,7 @@ tridimensional). We recall that, on the remaining part of the EBs, homogeneous Neumann boundary conditions are assumed by default. In the following table there is a list of the possible entries for EB boundary -conditions. Each entry must be preceded by `bc.[region0].` +conditions. Each entry must be preceded by `bc.[region0].` +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | | Description | Type | Default | @@ -775,18 +775,20 @@ Below is an example for specifying boundary conditions for a fluid `myfluid`. bc.hot-walls = eb bc.hot-walls.eb.temperature = 800 -In addition to the temperature, it is possible to set an inflow condition for the fluid velocity -on an embedeed boundary face. We recall that, on the remaining part of the EBs, +In addition to the temperature, it is possible to set an inflow condition for fluid +on an embedeed boundary. We recall that, on the remaining part of the EBs, no slip velocity conditions are assumed by default. In the following table there is a list of the possible entries for inflow EB boundary -conditions. Each entry must be preceded by `bc.[region0].` +conditions. Each entry must be preceded by `bc.[region0].` Like traditional mass +inflows, the fluid temperature, pressure, and species composition must be +provided when appropriate. +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | | Description | Type | Default | +=====================+=======================================================================+=============+===========+ -| fluid.velocity | (Required if not `volflow`) Inflow BC for fluid velocity on | Reals | None | -| | EBs contained in the (tridimensional) region. | | | +| fluid.velocity | (Required if not `volflow`) Inflow fluid velocity on EB faces | Reals | None | +| | contained in the (tridimensional) region. | | | | | Note that if only one value is specified, that is assumed to | | | | | be the magnitude in the direction of the EB face's normal. | | | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ -- GitLab