From 62b95b560dad046b1c42090cee47cfd03d8b6013 Mon Sep 17 00:00:00 2001 From: blaisb Date: Fri, 22 Nov 2024 14:23:07 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages-v2=20from=20@=20chaos?= =?UTF-8?q?-polymtl/lethe@46d2410651dad85efb99b94f9993d9a8d7a3f511=20?= =?UTF-8?q?=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...scale-rotating-drum-postprocessing.rst.txt | 4 +- .../small-scale-rotating-drum.rst.txt | 55 ++++++++++--------- .../parameters/dem/model_parameters.rst.txt | 2 +- ...ll-scale-rotating-drum-postprocessing.html | 4 +- .../small-scale-rotating-drum.html | 53 +++++++++--------- .../parameters/dem/model_parameters.html | 2 +- documentation/searchindex.js | 2 +- .../parameters__lagrangian_8cc_source.html | 2 +- 8 files changed, 66 insertions(+), 58 deletions(-) diff --git a/documentation/_sources/examples/dem/small-scale-rotating-drum-postprocessing/small-scale-rotating-drum-postprocessing.rst.txt b/documentation/_sources/examples/dem/small-scale-rotating-drum-postprocessing/small-scale-rotating-drum-postprocessing.rst.txt index d5e0f88a06..15985c4b2a 100644 --- a/documentation/_sources/examples/dem/small-scale-rotating-drum-postprocessing/small-scale-rotating-drum-postprocessing.rst.txt +++ b/documentation/_sources/examples/dem/small-scale-rotating-drum-postprocessing/small-scale-rotating-drum-postprocessing.rst.txt @@ -12,7 +12,7 @@ This is an example of how to post-process results obtained in the `Small scale r .. warning:: - Details about installing the module or using it without installing it are available on this `documentation <../../../tools/postprocessing/postprocessing.py>`_. + Details about installing the module or using it without installing it are available on `here <../../../tools/postprocessing/postprocessing.py>`_. ---------------------------------- @@ -51,7 +51,7 @@ The DEM files used in this example are obtained following the `Small scale rotat Python Code --------------- -Please, read this `documentation <../../../tools/postprocessing/postprocessing.py>`_ before jumping to the following steps. +Please, read this `documentation <../../../tools/postprocessing/postprocessing_pyvista>`_ before jumping to the following steps. Constructing the Object ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/documentation/_sources/examples/dem/small-scale-rotating-drum/small-scale-rotating-drum.rst.txt b/documentation/_sources/examples/dem/small-scale-rotating-drum/small-scale-rotating-drum.rst.txt index 9d9bec908e..13068abd97 100644 --- a/documentation/_sources/examples/dem/small-scale-rotating-drum/small-scale-rotating-drum.rst.txt +++ b/documentation/_sources/examples/dem/small-scale-rotating-drum/small-scale-rotating-drum.rst.txt @@ -38,22 +38,24 @@ Parameter File Mesh ~~~~~ -In this example, we choose a ``cylinder`` grid type to create a cylinder. Grid arguments are the radius of the cylinder (0.056 m) and half-length (0.051 m), respectively. The grid is refined 3 times using the ``set initial refinement`` parameters. The ``expand particle-wall contact search`` is used in concave geometries to enable extended particle-wall contact search with boundary faces of neighbor cells for particles located in each boundary cell (for more details see `Rotating Drum example <../rotating-drum/rotating-drum.html>`_). +In this example, we choose a ``cylinder`` grid type to create a cylinder. Grid arguments are the radius of the cylinder (0.056 m) and half-length (0.051 m), respectively. The grid is refined 3 times using the ``set initial refinement`` parameters. The ``expand particle-wall contact search`` is used in concave geometries to enable extended particle-wall contact search with boundary faces of neighbor cells for particles located in each boundary cell (for more details see `Rotating Drum example <../rotating-drum/rotating-drum.html>`_). The mesh subsection is the same for both parameter files. + .. code-block:: text subsection mesh - set type = dealii - set grid type = cylinder - set grid arguments = 0.056:0.051 - set initial refinement = 3 + set type = dealii + set grid type = cylinder + set grid arguments = 0.056:0.051 + set initial refinement = 3 + set expand particle-wall contact search = true end Packing information ~~~~~~~~~~~~~~~~~~~~ -An insertion box is defined inside the cylindrical domain, inserting 8000 particles every 0.5 seconds while the cylinder is at rest. It is important to note the size of the insertion box to make sure it is completely inside our geometry. Otherwise, particles will be lost during the insertion stage. +An insertion box is defined inside the cylindrical domain, inserting 8000 particles every 0.5 seconds while the cylinder is at rest. It is important to note the size of the insertion box to make sure it is completely inside our geometry to prevent particles loss during the insertion stage. This section is in the ``packing-rotating-drum.prm`` file. .. code-block:: text @@ -68,12 +70,12 @@ An insertion box is defined inside the cylindrical domain, inserting 8000 partic set insertion prn seed = 19 end -Restart files are written once the packing ends. The restart files are used to start the DEM simulation with the imposed rotating boundary condition. +Restart files are written once the packing ends. Using these restart files we can run the rotating drum simulation the end of the packing simulation. Lagrangian Physical Properties ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The particles are mono-dispersed with a radius of 0.0015 m and a density of 2500 kg/m3, respectively. All other particles' physical parameters are taken arbitrary and should be changed based on the physical properties and the experimental values. +The particles are mono-dispersed with a radius of 0.0015 m and a density of 2500 kg/m\ :sup:`3`. All other particles' physical parameters are taken arbitrary and should be changed based on the physical properties and the experimental values. Both parameters files have the same physical properties. .. code-block:: text @@ -95,7 +97,7 @@ The particles are mono-dispersed with a radius of 0.0015 m and a density of 2500 set young modulus wall = 100000000 set poisson ratio wall = 0.24 set restitution coefficient wall = 0.85 - set friction coefficient wall = 0.35 + set friction coefficient wall = 0.3 set rolling friction wall = 0.1 end @@ -103,15 +105,15 @@ The particles are mono-dispersed with a radius of 0.0015 m and a density of 2500 Model Parameters ~~~~~~~~~~~~~~~~~ -In this example, we use the ``dynamic`` load balancing method. This method checks frequently if load balancing should be applied based on a user inputted frequency. Load balancing is dynamically applied if a certain condition is applied. More details regarding load balancing are explained in the `Rotating Drum example <../rotating-drum/rotating-drum.html>`_. +In this example, we use the ``dynamic`` load balancing method. This method checks frequently if load balancing should be applied based on a user inputted frequency. Load balancing is dynamically applied if a certain condition is applied. More details regarding load balancing are explained in the `Rotating Drum example <../rotating-drum/rotating-drum.html>`_. This section is in the ``small-rotating-drum-dem.prm`` file. .. code-block:: text subsection model parameters subsection contact detection set contact detection method = dynamic - set dynamic contact search size coefficient = 0.8 - set neighborhood threshold = 1.3 + set dynamic contact search size coefficient = 0.9 + set neighborhood threshold = 1.2 end subsection load balancing set load balance method = dynamic @@ -127,7 +129,7 @@ In this example, we use the ``dynamic`` load balancing method. This method check DEM Boundary Conditions ~~~~~~~~~~~~~~~~~~~~~~~ -The rotation of the cylinder is applied using a rotational boundary condition with a value of 1 rad/s over the x axis. Based on `deal.II boundary colouring `_, the hull of the cylinder (rotating drum) has an id = 0. +The rotation of the cylinder is applied using a rotational boundary condition with a value of 1 rad/s over the x axis. Based on `deal.II boundary colouring `_, the hull of the cylinder (rotating drum) has an id = 0. This section is in the ``small-rotating-drum-dem.prm`` file. .. code-block:: text @@ -145,28 +147,31 @@ The rotation of the cylinder is applied using a rotational boundary condition wi Simulation Control ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The packing ``lethe-particles`` simulation was run for 2 seconds in real time. +The packing ``lethe-particles`` simulation was run for 2 seconds in real time. This section is in the ``packing-rotating-drum.prm`` file. .. code-block:: text subsection simulation control - set time step = 5e-6 - set time end = 2 - set log frequency = 2000 - set output frequency = 2000 - set output path = ./output_dem/ + set time step = 5e-6 + set time end = 2 + set log frequency = 2000 + set output frequency = 2000 + set output path = ./output_dem/ + set output boundaries = true end -The actual rotation of the drum is 3 seconds in real time. We set the time equal to 5 seconds as the simulation is restarted after the packing ``lethe-particles`` simulation. +The actual rotation of the drum is 3 seconds in real time. We set the time equal to 5 seconds as the simulation is restarted after the packing ``lethe-particles`` simulation. This section is in the ``small-rotating-drum-dem.prm`` file. + .. code-block:: text subsection simulation control - set time step = 5e-6 - set time end = 5 - set log frequency = 2000 - set output frequency = 2000 - set output path = ./output_dem/ + set time step = 5e-6 + set time end = 5 + set log frequency = 2000 + set output frequency = 2000 + set output path = ./output_dem/ + set output boundaries = true end diff --git a/documentation/_sources/parameters/dem/model_parameters.rst.txt b/documentation/_sources/parameters/dem/model_parameters.rst.txt index 7eee855924..96f82cc8aa 100644 --- a/documentation/_sources/parameters/dem/model_parameters.rst.txt +++ b/documentation/_sources/parameters/dem/model_parameters.rst.txt @@ -22,7 +22,7 @@ In this subsection, contact detection, force models, time integration, load bala subsection load balancing # Choices are none|once|frequent|dynamic|dynamic_with_sparse_contacts set load balance method = none - set particle weight = 10000 # Every method, except none + set particle weight = 2000 # Every method, except none set step = 100000 # if method = once set frequency = 100000 # if method = frequent set dynamic check frequency = 10000 # if method = dynamic diff --git a/documentation/examples/dem/small-scale-rotating-drum-postprocessing/small-scale-rotating-drum-postprocessing.html b/documentation/examples/dem/small-scale-rotating-drum-postprocessing/small-scale-rotating-drum-postprocessing.html index 05f73574a8..613ea512ff 100644 --- a/documentation/examples/dem/small-scale-rotating-drum-postprocessing/small-scale-rotating-drum-postprocessing.html +++ b/documentation/examples/dem/small-scale-rotating-drum-postprocessing/small-scale-rotating-drum-postprocessing.html @@ -441,7 +441,7 @@

Small Scale Rotating Drum Postprocessing

Warning

-

Details about installing the module or using it without installing it are available on this documentation.

+

Details about installing the module or using it without installing it are available on here.

Features#

@@ -471,7 +471,7 @@

Description of the Case

Python Code#

-

Please, read this documentation before jumping to the following steps.

+

Please, read this documentation before jumping to the following steps.

Constructing the Object#

The first step is to create an object to receive the data. In the present case, the object is called particles.

diff --git a/documentation/examples/dem/small-scale-rotating-drum/small-scale-rotating-drum.html b/documentation/examples/dem/small-scale-rotating-drum/small-scale-rotating-drum.html index 5639de5c6c..68eaeac9e3 100644 --- a/documentation/examples/dem/small-scale-rotating-drum/small-scale-rotating-drum.html +++ b/documentation/examples/dem/small-scale-rotating-drum/small-scale-rotating-drum.html @@ -460,19 +460,20 @@

Description of the CaseParameter File#

Mesh#

-

In this example, we choose a cylinder grid type to create a cylinder. Grid arguments are the radius of the cylinder (0.056 m) and half-length (0.051 m), respectively. The grid is refined 3 times using the set initial refinement parameters. The expand particle-wall contact search is used in concave geometries to enable extended particle-wall contact search with boundary faces of neighbor cells for particles located in each boundary cell (for more details see Rotating Drum example).

+

In this example, we choose a cylinder grid type to create a cylinder. Grid arguments are the radius of the cylinder (0.056 m) and half-length (0.051 m), respectively. The grid is refined 3 times using the set initial refinement parameters. The expand particle-wall contact search is used in concave geometries to enable extended particle-wall contact search with boundary faces of neighbor cells for particles located in each boundary cell (for more details see Rotating Drum example). The mesh subsection is the same for both parameter files.

subsection mesh
-  set type               = dealii
-  set grid type          = cylinder
-  set grid arguments     = 0.056:0.051
-  set initial refinement = 3
+  set type                                = dealii
+  set grid type                           = cylinder
+  set grid arguments                      = 0.056:0.051
+  set initial refinement                  = 3
+  set expand particle-wall contact search = true
 end

Packing information#

-

An insertion box is defined inside the cylindrical domain, inserting 8000 particles every 0.5 seconds while the cylinder is at rest. It is important to note the size of the insertion box to make sure it is completely inside our geometry. Otherwise, particles will be lost during the insertion stage.

+

An insertion box is defined inside the cylindrical domain, inserting 8000 particles every 0.5 seconds while the cylinder is at rest. It is important to note the size of the insertion box to make sure it is completely inside our geometry to prevent particles loss during the insertion stage. This section is in the packing-rotating-drum.prm file.

subsection insertion info
   set insertion method                               = volume
   set inserted number of particles at each time step = 8000
@@ -484,11 +485,11 @@ 
Packing information
 
Lagrangian Physical Properties#

-
The particles are mono-dispersed with a radius of 0.0015 m and a density of 2500 kg/m3, respectively. All other particles’ physical parameters are taken arbitrary and should be changed based on the physical properties and the experimental values.

+
The particles are mono-dispersed with a radius of 0.0015 m and a density of 2500 kg/m3. All other particles’ physical parameters are taken arbitrary and should be changed based on the physical properties and the experimental values.  Both parameters files have the same physical properties.

 
subsection lagrangian physical properties
     set g                        = 0.0, -9.81, 0.0
     set number of particle types = 1
@@ -507,7 +508,7 @@ 
Lagrangian Physical Properties
 
Model Parameters#

-
In this example, we use the dynamic load balancing method. This method checks frequently if load balancing should be applied based on a user inputted frequency. Load balancing is dynamically applied if a certain condition is applied. More details regarding load balancing are explained in the Rotating Drum example.

+
In this example, we use the dynamic load balancing method. This method checks frequently if load balancing should be applied based on a user inputted frequency. Load balancing is dynamically applied if a certain condition is applied. More details regarding load balancing are explained in the Rotating Drum example. This section is in the small-rotating-drum-dem.prm file.

 
subsection model parameters
   subsection contact detection
     set contact detection method                = dynamic
-    set dynamic contact search size coefficient = 0.8
-    set neighborhood threshold                  = 1.3
+    set dynamic contact search size coefficient = 0.9
+    set neighborhood threshold                  = 1.2
   end
   subsection load balancing
     set load balance method                     = dynamic
@@ -537,7 +538,7 @@ 
Model Parameters
 
DEM Boundary Conditions#

-
The rotation of the cylinder is applied using a rotational boundary condition with a value of 1 rad/s over the x axis. Based on deal.II boundary colouring, the hull of the cylinder (rotating drum) has an id = 0.

+
The rotation of the cylinder is applied using a rotational boundary condition with a value of 1 rad/s over the x axis. Based on deal.II boundary colouring, the hull of the cylinder (rotating drum) has an id = 0. This section is in the small-rotating-drum-dem.prm file.

 
subsection DEM boundary conditions
   set number of boundary conditions = 1
   subsection boundary condition 0
@@ -552,23 +553,25 @@ 
DEM Boundary Conditions
 

 
Simulation Control#

-
The packing lethe-particles simulation was run for 2 seconds in real time.

+
The packing lethe-particles simulation was run for 2 seconds in real time. This section is in the packing-rotating-drum.prm file.

 
subsection simulation control
-  set time step        = 5e-6
-  set time end         = 2
-  set log frequency    = 2000
-  set output frequency = 2000
-  set output path      = ./output_dem/
+  set time step         = 5e-6
+  set time end          = 2
+  set log frequency     = 2000
+  set output frequency  = 2000
+  set output path       = ./output_dem/
+  set output boundaries = true
 end
 

 

-
The actual rotation of the drum is 3 seconds in real time. We set the time equal to 5 seconds as the simulation is restarted after the packing lethe-particles simulation.

+
The actual rotation of the drum is 3 seconds in real time. We set the time equal to 5 seconds as the simulation is restarted after the packing lethe-particles simulation. This section is in the small-rotating-drum-dem.prm file.

 
subsection simulation control
-  set time step        = 5e-6
-  set time end         = 5
-  set log frequency    = 2000
-  set output frequency = 2000
-  set output path      = ./output_dem/
+  set time step         = 5e-6
+  set time end          = 5
+  set log frequency     = 2000
+  set output frequency  = 2000
+  set output path       = ./output_dem/
+  set output boundaries = true
 end
 

 

diff --git a/documentation/parameters/dem/model_parameters.html b/documentation/parameters/dem/model_parameters.html
index ec91169f36..7b0a9bfcc2 100644
--- a/documentation/parameters/dem/model_parameters.html
+++ b/documentation/parameters/dem/model_parameters.html
@@ -451,7 +451,7 @@ 
Model Parameters  629  

 
  630           prm.declare_entry(

 
  631             "particle weight",

-
  632             "10000",

+
  632             "2000",

 
  633             Patterns::Integer(),

 
  634             "The particle weight based on a default cell weight of 1000");

 
  635