diff --git a/README.md b/README.md index 585f53627870a429d188bab1254c240e6386ee4c..8a510fe77d1928491656f2998948e466db828299 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,7 @@ can be built locally by: 1. Install sphinx: ```shell -> pip install sphinx sphinx_rtd_theme sphinx-tabs +> pip install sphinx sphinx_rtd_theme sphinx-tabs sphinxcontrib-bibtex ``` 2. Build the documentation: diff --git a/docs/source_docs/refs.bib b/docs/source_docs/refs.bib index 06937533a230546448a6073559b713a3c98af4bc..a250d504a04776a6c3f85b38aa3760fdb1b0fdf2 100644 --- a/docs/source_docs/refs.bib +++ b/docs/source_docs/refs.bib @@ -82,6 +82,15 @@ pages = {379-402} url = {https://www.sciencedirect.com/science/article/pii/S0021999120305945}, } +@article{brinkman52, + author = {Brinkman, H.C.}, + title = {The viscosity of concentrated suspensions and solutions}, + journal = {The Journal of Chemical Physics}, + year = {1952}, + volume = {20}, + pages = {571} +} + @book{Burden10, title={Numerical Analysis}, author={Burden, R.L. and Faires, J.D.}, @@ -101,6 +110,14 @@ pages = {379-402} pages = {1-31} } +@article{cheng03, + author = {Nian-Sheng Cheng and Adrian Wing-Keung Law}, + title = {Exponential formula for computing effective viscosity}, + journal = {Powder Technology}, + year = {2003}, + volume = {129}, + pages = {156--160} +} @techreport{chern87, author = {Chern, I.-L., and Colella, P. }, @@ -190,6 +207,15 @@ pages = {379-402} publisher={Oxford University Computing Laboratory Oxford, UK} } +@article{einstein11, + title={Eine neue bestimmung der moleküldimensionen}, + author={Einstein, A}, + journal={Ann. Physik}, + volume={19}, + pages={289--306}, + year={1911}, +} + @article{elhilo12, author = {M. El-Hilo and R.W. Chantrell}, title = {Rationalisation of distribution functions for models of nanoparticle magnetism}, @@ -238,6 +264,15 @@ url = {https://www.sciencedirect.com/science/article/pii/S0304885312002132}, publisher={Elsevier} } +@article{gibilaro07, + author = {Gibilaro L.G., Gallucci K., Felice R. Di. and Pagliai P.}, + title = {On the apparent viscosity of a fluidized bed}, + journal = {Chemical Engineering Science}, + year = {2007}, + volume = {62}, + pages = {294--300} +} + @article{Gid83, author = {Gidaspow, D. and Ettehadieh, B. }, title = {Fluidization in Two-Dimensional Beds with a Jet; 2. Hydrodynamic Modeling}, @@ -290,6 +325,15 @@ doi = {https://doi.org/10.1016/j.jcp.2022.111305}, pages = {843-855} } +@article{krieger59, + author = {Krieger, I.M. and Dougherty, T.J. }, + title = {A mechanism for non-newtonian flow in suspensions of rigid spheres}, + journal = {Trans. Soc. Rheol}, + year = {1959}, + volume = {3}, + pages = {137--152} +} + @article{Lat011, author = {Lathouwers, D. and Bellan, J. }, title = {Modeling of dense gas-solid reative mixtures applied to biomass pyrolysis in a fluidized bed}, @@ -330,6 +374,14 @@ doi = {https://doi.org/10.1016/j.jcp.2022.111305}, publisher = {NOAA/NCAR Boulder Atmospheric Observatory}, } +@article{maron56, + author = {Samuel H Maron and Percy E Pierce}, + title = {Application of ree-eyring generalized flow theory to suspensions of spherical particles}, + journal = {Journal of Colloid Science}, + year = {1956}, + volume = {11}, + pages = {80--95} +} @article{Massoudi03, author = {Mehrdad Massoudi}, @@ -384,6 +436,15 @@ doi = {https://doi.org/10.1016/j.jcp.2022.111305}, volume = {32} } +@article{roscoe52, + author = {Roscoe, R.}, + title = {The viscosity of suspensions of rigid spheres}, + journal = {British Journal of Applied Physics}, + year = {1952}, + volume = {3}, + pages = {267} +} + @article{Sch33, author = {Schiller, L. and Naumann, A. }, title = {A drag coefficient correlation}, diff --git a/docs/source_docs/user_guide/inputs/fluid_model.rst b/docs/source_docs/user_guide/inputs/fluid_model.rst index 374b671eda3fb1dc5f04b6f8e9aaaf3aee619865..7e1430d85a9469e4c5011c7c585b2cd1223dac87 100644 --- a/docs/source_docs/user_guide/inputs/fluid_model.rst +++ b/docs/source_docs/user_guide/inputs/fluid_model.rst @@ -35,10 +35,47 @@ The following inputs are defined using the ``fluid`` prefix. | viscosity.eddy.Smagorinsky-Lilly.constant | Smagorinsky-Lilly constant which usually has values | Real | None | | | between 0.1 and 0.2. | | | | | | | | -| | A value is required when using the ``Samgorinsky-Lilly`` | | | +| | A value is required when using the ``Smagorinsky-Lilly`` | | | | | eddy viscosity model. | | | +--------------------------------------------+------------------------------------------------------------+--------+----------+ | viscosity.eddy.WALE.constant | WALE eddy viscosity model constant. | Real | 0.325 | +---------------------------------------------+------------------------------------------------------------+--------+----------+ +| viscosity.suspension | Specify suspension viscosty model of the form | String | None | +| | :math:`\mu_{susp}=\mu_{mol}(\mu^* - 1)` | | | +| | | | | +| | Available options include: | | | +| | | | | +| | * ``None`` No eddy suspension model | | | +| | :math:`\mu^*=1` | | | +| | | | | +| | * ``Einstein`` :cite:p:`einstein11` | | | +| | :math:`\mu^*=1 + 2.5\varepsilon_s` | | | +| | | | | +| | * ``Brinkman`` :cite:p:`brinkman52,gibilaro07` | | | +| | :math:`\mu^*=(1-\varepsilon_s)^{-c}` | | | +| | | | | +| | * ``Roscoe`` :cite:p:`roscoe52,krieger59,maron56` | | | +| | :math:`\mu^*=(1-\varepsilon_s/c_1)^{-c_2}` | | | +| | | | | +| | * ``ChengLaw`` :cite:p:`cheng03` | | | +| | :math:`\mu^*=e^{2.5(1/(1-\varepsilon_s)^c-1)/c}` | | | +| | | | | ++--------------------------------------------+------------------------------------------------------------+--------+----------+ +| viscosity.suspension.Brinkman.constant | Constant for exponent in Brinkman suspension expression. | Real | None | +| | | | | +| | A value is required when using the model ``Brinkman``. | | | ++--------------------------------------------+------------------------------------------------------------+--------+----------+ +| viscosity.suspension.Roscoe.c1 | Constant for max packing in Roscoe suspension expression. | Real | None | +| | | | | +| | A value is required when using the model ``Roscoe``. | | | ++--------------------------------------------+------------------------------------------------------------+--------+----------+ +| viscosity.suspension.Roscoe.c2 | Constant for exponent in Roscoe suspension expression. | Real | None | +| | | | | +| | A value is required when using the model ``Roscoe``. | | | ++--------------------------------------------+------------------------------------------------------------+--------+----------+ +| viscosity.suspension.ChengLaw.constant | Constant for exponent in ChengLaw suspension expression. | Real | None | +| | | | | +| | A value is required when using the model ``ChengLaw``. | | | +--------------------------------------------+------------------------------------------------------------+--------+----------+ | species | Specify the species that constitute the fluid. | String | None | | | | | |