From f3470fccb2f0b1658272678bf29b53d439b9b8f6 Mon Sep 17 00:00:00 2001 From: Roberto Porcu Date: Wed, 3 Jun 2020 19:21:15 -0400 Subject: [PATCH 1/2] Fix an error --- docs/source/InputsProblemDefinition.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/source/InputsProblemDefinition.rst b/docs/source/InputsProblemDefinition.rst index da6a619..856ecec 100644 --- a/docs/source/InputsProblemDefinition.rst +++ b/docs/source/InputsProblemDefinition.rst @@ -533,5 +533,5 @@ Below is an example for specifying boundary conditions for a fluid `myfluid`. bc.regions = hot-wall - bc.hot-walls = eb - bc.hot-walls.eb.temperature = 800 + bc.hot-wall = eb + bc.hot-wall.eb.temperature = 800 -- GitLab From 674c0a42f815a1fb50a6017dc27f214621f01cda Mon Sep 17 00:00:00 2001 From: "robbberto88@gmail.com" Date: Thu, 23 Feb 2023 14:18:03 -0500 Subject: [PATCH 2/2] add inputs for PIC to DEM restarter tool --- docs/source_docs/Inputs_Chapter.rst | 1 + docs/source_docs/inputs/InputsPICtoDEM.rst | 80 ++++++++++++++++++++++ 2 files changed, 81 insertions(+) create mode 100644 docs/source_docs/inputs/InputsPICtoDEM.rst diff --git a/docs/source_docs/Inputs_Chapter.rst b/docs/source_docs/Inputs_Chapter.rst index fb6c6bf..e2a1dd5 100644 --- a/docs/source_docs/Inputs_Chapter.rst +++ b/docs/source_docs/Inputs_Chapter.rst @@ -49,4 +49,5 @@ keywords such as ``mfix``, ``amr``, ``geometry``, ``nodal_proj`` etc. inputs/InputsPlotFiles inputs/InputsCheckpoint inputs/InputsMonitors + inputs/InputsPICtoDEM inputs/InputsVerbosity diff --git a/docs/source_docs/inputs/InputsPICtoDEM.rst b/docs/source_docs/inputs/InputsPICtoDEM.rst new file mode 100644 index 0000000..63a46d3 --- /dev/null +++ b/docs/source_docs/inputs/InputsPICtoDEM.rst @@ -0,0 +1,80 @@ +.. _Chap:InputsPICtoDEM: + +PIC to DEM conversion +===================== + +The PIC to DEM tool allows to convert a checkpoint file obtained from a PIC run +into a new checkpoint file on a custom-refined mesh with DEM particles. The DEM +particles positions are initialized such that the original PIC parcels +distribution (aka the solids volume fraction) is preserved in each cell up to +a negligible error. + +Building the PIC to DEM tool using CMake (from inside the build directory): + +:: + + cmake --build ./ --target pic2dem + +The following inputs must be preceded by "pic2dem". + ++------------------+---------------------------------------------------+--------+---------+ +| | Description | Type | Default | ++==================+===================================================+========+=========+ +| refinement_ratio | The mesh refinement ratio that will be applied | int | 1 | +| | on each direction to obtain a refined mesh out of | | | +| | the one read form the PIC checkpoint file | | | ++------------------+---------------------------------------------------+--------+---------+ +| eps_tolerance | The threshold used for DEM particles generation | Real | 1.e-15 | +| | from the PIC solids volfrac distribution. If ep_s | | | +| | in a cell is below the threshold, no DEM solids | | | +| | will be generated in that cell | | | ++------------------+---------------------------------------------------+--------+---------+ +| eps_overflow | An artifact, like a knob, for the user to force | Real | 1.0 | +| | over-production (if value > 1), or | | | +| | under-production (if value < 1) of DEM particles | | | ++------------------+---------------------------------------------------+--------+---------+ + +The following inputs must be preceded by "eb2". + ++-----------------------+----------------------------------------------+--------+---------+ +| | Description | Type | Default | ++=======================+==============================================+========+=========+ +| refined_small_volfrac | This input gives the possibility to set a | Real | 0. | +| | small volfrac value just for the DEM refined | | | +| | case, while the standard small volfrac value | | | +| | will still be used for the PIC case read | | | +| | from the checkpoint file | | | ++-----------------------+----------------------------------------------+--------+---------+ + +The following inputs must be preceded by "amr". + ++-------------------------------+--------------------------------------+--------+---------+ +| | Description | Type | Default | ++===============================+======================================+========+=========+ +| refined_geom_chk_file | Name of the EB checkpoint file where | string | "" | +| | the DEM refined case geometry will | | | +| | be read or written | | | ++-------------------------------+--------------------------------------+--------+---------+ +| refined_geom_chk_refined_file | Name of the EB checkpoint file where | string | "" | +| | the finer levels of the geometry for | | | +| | the DEM refined case will be read or | | | +| | written | | | ++-------------------------------+--------------------------------------+--------+---------+ +| refined_geom_chk_write | Flag to turn on/off writing the EB | bool | false | +| | geometry checkpoint file for the DEM | | | +| | refined case | | | ++-------------------------------+--------------------------------------+--------+---------+ +| refined_geom_chk_read | Flag to turn on/off reading the EB | bool | true | +| | geometry checkpoint file for the DEM | | | +| | refined case | | | ++-------------------------------+--------------------------------------+--------+---------+ + +The following inputs must be preceded by "pic2dem". + ++-------------------+--------------------------------------------------+--------+---------+ +| | Description | Type | Default | ++===================+==================================================+========+=========+ +| geometry_filename | CSG filename that will be used for generating | string | "" | +| | the DEM refined geometry in case the PIC coarse | | | +| | geometry is read from a checkpoint file | | | ++-------------------+--------------------------------------------------+--------+---------+ -- GitLab