Commit b353df91 authored by Deepak Rangarajan's avatar Deepak Rangarajan Committed by William D. Fullmer
Browse files

Add doc for suspension viscosity models (!83)

parent b889ae0f
Loading
Loading
Loading
Loading
+1 −1
Original line number Diff line number Diff line
@@ -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:
+61 −0
Original line number Diff line number Diff line
@@ -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},
+38 −1
Original line number Diff line number Diff line
@@ -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    |
|                                            |                                                            |        |          |