From f04d6c4790ee45a809325eb4f657736af586e82e Mon Sep 17 00:00:00 2001
From: goniva <goniva@DCS3.(none)>
Date: Wed, 12 Feb 2014 10:02:10 +0100
Subject: [PATCH] release on 2014-02-12_10-02-10

---
 README                                        |  81 ++++++++++++++++++
 doc/CFDEMcoupling_Manual.pdf                  | Bin 511596 -> 511619 bytes
 doc/githubAccess_public.html                  |   6 +-
 doc/githubAccess_public.pdf                   | Bin 362471 -> 362495 bytes
 doc/githubAccess_public.txt                   |   6 +-
 src/lagrangian/cfdemParticle/Make/files       |  36 ++++++--
 .../cfdemParticle/etc/library-list.txt        |   2 +
 .../cfdemParticle/etc/solver-list.txt         |   2 +
 .../cfdemParticle/etc/tutorial-list.txt       |  18 ++--
 9 files changed, 131 insertions(+), 20 deletions(-)
 create mode 100755 README

diff --git a/README b/README
new file mode 100755
index 00000000..fd2ca756
--- /dev/null
+++ b/README
@@ -0,0 +1,81 @@
+/*---------------------------------------------------------------------------*\
+    CFDEMcoupling - Open Source CFD-DEM coupling
+
+    CFDEMcoupling is part of the CFDEMproject
+    www.cfdem.com
+                                Christoph Goniva, christoph.goniva@cfdem.com
+                                Copyright 2009-2012 JKU Linz
+                                Copyright 2012-     DCS Computing GmbH, Linz
+-------------------------------------------------------------------------------
+License
+    This file is part of CFDEMcoupling.
+
+    CFDEMcoupling is free software; you can redistribute it and/or modify it
+    under the terms of the GNU General Public License as published by the
+    Free Software Foundation; either version 3 of the License, or (at your
+    option) any later version.
+
+    CFDEMcoupling is distributed in the hope that it will be useful, but WITHOUT
+    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+    FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+    for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with CFDEMcoupling; if not, write to the Free Software Foundation,
+    Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+
+Description
+    This code is designed to realize coupled CFD-DEM simulations using LIGGGHTS
+    and OpenFOAM. Note: this code is not part of OpenFOAM (see DISCLAIMER).
+\*---------------------------------------------------------------------------*/
+
+
+CFDEM coupling provides an open source parallel coupled CFD-DEM framework 
+combining the strengths of LIGGGHTS DEM code and the Open Source 
+CFD package OpenFOAM(R)(*). The CFDEMcoupling toolbox allows to expand 
+standard CFD solvers of OpenFOAM(R)(*) to include a coupling to the DEM 
+code LIGGGHTS. In this toolbox the particle representation within the 
+CFD solver is organized by "cloud" classes. Key functionalities are organised 
+in sub-models (e.g. force models, data exchange models, etc.) which can easily 
+be selected and combined by dictionary settings.
+
+The coupled solvers run fully parallel on distributed-memory clusters. 
+
+Features are:
+
+- its modular approach allows users to easily implement new models
+- its MPI parallelization enables to use it for large scale problems
+- the "forum"_lws on CFD-DEM gives the possibility to exchange with other 
+  users / developers
+- the use of GIT allows to easily update to the latest version
+- basic documentation is provided
+
+The file structure:
+
+- "src" directory including the source files of the coupling toolbox and models
+- "applications" directory including the solver files for coupled CFD-DEM simulations
+- "doc" directory including the documentation of CFDEMcoupling
+- "tutorials" directory including basic tutorial cases showing the functionality
+
+
+
+Details on installation are given on the "www.cfdem.com"
+
+The functionality of this CFD-DEM framwork is described via "tutorial cases" showing 
+how to use different solvers and models.
+
+CFDEMcoupling stands for Computational Fluid Dynamics (CFD) -
+Discrete Element Method (DEM) coupling.
+
+CFDEMcoupling is an open-source code, distributed freely under the terms of the 
+GNU Public License (GPL).
+
+Core development of CFDEMcoupling is done by 
+Christoph Goniva and Christoph Kloss, both at DCS Computing GmbH, 2012
+
+
+\*---------------------------------------------------------------------------*/
+(*) "OpenFOAM(R)"_of is a registered trade mark of the ESI Group.
+This offering is not affiliated, approved or endorsed by ESI Group, 
+the producer of the OpenFOAM® software and owner of the OpenFOAM® trade mark.
+\*---------------------------------------------------------------------------*/
diff --git a/doc/CFDEMcoupling_Manual.pdf b/doc/CFDEMcoupling_Manual.pdf
index 602061b38607d83ece4fb0887b94bc0f182faa05..9cc04e71d9a168f9d4275e7ee356d304af5a5bbc 100644
GIT binary patch
delta 5942
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
S_#hlc0GLl!cB_Fd-~Ry&u;fMn

delta 5912
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
K%WpB-%Kv{y8thB}

diff --git a/doc/githubAccess_public.html b/doc/githubAccess_public.html
index 70c81f99..b3e3a316 100644
--- a/doc/githubAccess_public.html
+++ b/doc/githubAccess_public.html
@@ -87,13 +87,13 @@ git pull
 #- source cfdem env vars
 export CFDEM_VERSION=PUBLIC
 export CFDEM_PROJECT_DIR=$HOME/CFDEM/CFDEMcoupling-$CFDEM_VERSION-$WM_PROJECT_VERSION
-export CFDEM_SRC_DIR=$CFDEM_PROJECT_DIR/src/lagrangian/cfdemParticle
+export CFDEM_SRC_DIR=$CFDEM_PROJECT_DIR/src
 export CFDEM_SOLVER_DIR=$CFDEM_PROJECT_DIR/applications/solvers
 export CFDEM_DOC_DIR=$CFDEM_PROJECT_DIR/doc
 export CFDEM_UT_DIR=$CFDEM_PROJECT_DIR/applications/utilities
 export CFDEM_TUT_DIR=$CFDEM_PROJECT_DIR/tutorials
 export CFDEM_PROJECT_USER_DIR=$HOME/CFDEM/$LOGNAME-$CFDEM_VERSION-$WM_PROJECT_VERSION
-export CFDEM_bashrc=$CFDEM_SRC_DIR/etc/bashrc
+export CFDEM_bashrc=$CFDEM_SRC_DIR/lagrangian/cfdemParticle/etc/bashrc
 export CFDEM_LIGGGHTS_SRC_DIR=$HOME/LIGGGHTS/LIGGGHTS-PUBLIC/src
 export CFDEM_LIGGGHTS_MAKEFILE_NAME=fedora_fpic
 export CFDEM_LPP_DIR=$HOME/LIGGGHTS/mylpp/src
@@ -109,7 +109,7 @@ $CFDEM_LIGGGHTS_SRC_DIR
 </PRE>
 <P>should give "...: is a directory" otherwise something went wrong and the environment variables in ~/bashrc are not set correctly.
 </P>
-<P>To specify the paths of pizza, please check the settings in $CFDEM_SRC_DIR/etc/bashrc.
+<P>To specify the paths of pizza, please check the settings in $CFDEM_SRC_DIR/lagrangian/cfdemParticle/etc/bashrc.
 </P>
 <P>If $CFDEM_SRC_DIR is set correctly, you can type 
 </P>
diff --git a/doc/githubAccess_public.pdf b/doc/githubAccess_public.pdf
index 088cbb9194ba63a2380c475548fe97a263c62b61..73add382640054237ca9f3da01a12bb1c72f2fcc 100644
GIT binary patch
delta 3085
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

delta 3053
zcmajhXE+;*9tQAZmBulvt=fB3v=T`qYLtdX=y7ONj8ZGMT19K5cBNE|M2niGtr3bE
zO=|C=HbqKpju@>```&Z!{cxY#5BL4@f1cm-etw_-Y2t;Y#0x~i85INsp$ZBoMiZH$
ziOkVNmS`gDdm@{ZKOO;<_*b;F{QP~L>^uQMOa*uBjD-=r$62-@^Zq!rqguF#H!36t
zl3T};EN!S{hDzE}j|={~lf@t!YERv7c(J2i9{#Enpa7um27S#~dicXQpG*13vt^4(
zM2zXP&_=SplH0eIk=PfyQ-58ja&@teiM<rLkxbsOBH}kcB3m$UZ&fA&!cJ5J;84)F
zr*lz?{mdWFjTVg<Ettp_ZObBrUoFQrEBTREH#@-5OZ2v2tj#+Owi;mT%H+JE^tz~-
z;#!kD&i93}vE60SkM25^p@O3KEQ4$5efK0u%+lavg%E!&hkXn-o`))aW{mzbZ?8U>
zp<S1C5f5mA#s+Rs4lef6jmPG`F=i6i^}r|NA4PZA)!bu`X3x1bZDb`c>d3G5uV@^<
z-7H;>%9FUP;1lJLt$B6vNssvHWRXm7r1XSZGuZ#fO;`V{xT&U_IGNx-oA0n{jqs}d
zjJm%a!4YB2F>e{!#(T$^xwR6WD9JsrXDgy9(T0y{InDyQv->GMR$~|`0Danh;|%in
zT@+uFnDou0+UsD7{1o!ueQ7}=>W+yT=-PS3iVDj!4R>UQRrt;V^(16eUO0T**yErh
zlap~$EQKX<0ww}&A;|=f&iEATI4oSuyb%@XG^-$K#j!r0pJS~gWJ?ZRT4TotFw2@b
z;RDk<52n25lai%&nJjADKeaYQ!?@9mGp<<=N4%^qwI0>ugR3o$sqf1ty>v+a${7QU
zw%YiOe2r`1>X;6~Ev~QEyS}S4CI`j1D4PeKgl+(>sy=pn+)eM6vsKkzWWw3PN3sKB
zIds`+Qp=Qq>`MWwN)(LU&+qkCeNpKlo~0}>zp<y%t2!83OG7lQ!|;^UlM9(<Iz`P|
zRPjk{{i>~vO&CgljwIH7)I0|ddHYD&b&lG6H~aJpW2fwcLvtXE?=8$jLvenW-jZ8p
ztr_d_mN082&vTfqo!wAP4dF{k?}$D+ASFz8Ed6k$?w}hvE^}+<yI;rCTs`n^52a&Z
zH#P5%h?$ROJZ<X^`<R`qGi158%^h5xAklPM+gI-Mx=GQdx)xy2FK)8~g+HjHoq#dg
zZye4^TpRKu<x!<6YU4%5I+mHzrmp3e+$%#^ge0FwBj+S*d{vRmoZo3|>C?l~dRQxK
z;PxYFT?$EaK}ea`llK<k*=_u%H<r8_=h(%3*$@_F<b|GIU;?N>WH<NEh$P8A)>CS`
zKO*Gk?$7V0rQ(CxtXmlOxCl$j!vY^aa+)gtg5aLbXz6y!z@Qu^uwgmcDQ{zl)%>8o
zM}ERF>_j(Mz98svPineFzU=x)A+I*Zdbxy%zOE2x@r*x6@I8!2=E=Pb&HnKV+i^~9
zDYsvypo$3^IydQ~iH{odfSjo}9<+815&g%vq@@zftxc{U1qgNgL}X|q1-m~-Mi1DQ
zZ<cY#@_ABp_S=WY5juv5m6@sd$}Xn!IT?@>w<8{QvR7ytBZ%z~ud0gpWo8oYY}}tf
z2^?iL%-$X5K>}bz0hd=pchLsjQ02N-##?@V%QdKn18x10=(E$4MTQW1YJOcHZqp%f
zdaZ}{@FZ-wfcxYFWO=|Mdv<4Fa{0|U|ILMyHlQMHwO^QE3S{tX$@yppDiExE@adg9
zsIsRSUC@`v>1WNweyah;vjJs^ZOTdVRU_xyq~xi|h&F5)*dV_+a4zv3g<!N`Xz9`A
z#Yv-XF0Hv&2QM`t#H+3@!s;>W?svN}6p=68Zu!WVg92b({E<~VX(3&QH)^mwmsF6j
z`aq|S*(kqQ_B2ffEQ{uOYio-y)#FCDQnhXxm(c+~{bDERl{p=6uBs~Cx>E8e^-F*;
zYkrE9ew-++$PxKwyyU?PCoC5>K^N1mf4*8~q}C-bK7N0&Vk&%PM>G0dIgikCFxwh>
zNw&4qVW!x9u4Iq^WU+pkqEeLl8snI}_sSHPDx}!u_7$h+VPGC(>RE(`o;A$qmGkal
zC61H0%WT9anj&jk=()+cD{`;-icJkqTGgR5!zR^ybqf_n!Zb&eL-9F(o~r{Gx5Zgf
zWyjI3*Fi^+K(F?6;>O~JT%hCzy+i<R{>NvQ1Xd(=t`9`1FNk)8k-=&D*cYr2ZZeaX
zwTHn{vj1wxyNi8?0DSW$Z&`j5tSNU1OS<8URHlSGQnt-um+z0~>vM{OP!n%}EWdU8
zyBfSI=kB`cT7By_(1aO%>`1UZYIepp81c6i<(-pbmpbL#8)`1oF8B20=_ceY4l>zv
zm28fVBKl`{T|^*iy_N>=ui)fUIh3%CR|nX4IXk(R(ZcmNvhW-!5Nvpq=U1Lyv`8V^
z*odN>lJW^lE>M|#EX9=@Hmr2rDwpeYO{DaJe#dXYYyIyoU_2P;C5A|?NHIH10eK`r
z_8nsdKLq`A-vS~BJ+IVDFKo`AqF?7l^!4yta+RX)mClnR>qKh0DK<bc`R&!??KwDd
z*~YdZas4g`Kb5~^pIpl4yoRAsIc`iR1&OCFXJR8x3V!!>y%FMERUM|+`C!Z{EVTVb
zrX!!OPg0j}wC25<fhs`>j*#j1qgSI`0@@TbvZjyf=ysxK89FNSXQT3+Kc3{6RMUme
z(ABj21S-!p;M4e(360{}HiDiHet-M&(ia(FPcc;88eYZgD`v`|d_b2Xu$Yu1AX%qF
z9fR38s)yYxHUNWD5;N5XmdW?zf+tku4<@)O0l5lUuMSJzgSyd_+QoOV5PMOT>G`$R
zt+vY}GK`10r1yGf3%qmoMQzK9*yLT7BYsaijDhco2Mkq&9_}-G9R=?Buw+gSVMoJu
z#yUd9@L`vx>BfcG8fl;BTW6iK<h7!1^GP2z5h3~+oa&U*>FH@++!HfJW`P=Z`*Fw6
z?!r5Y?FWF$@V$g9boEiY1Ie7gK>%t0H}z#*yxSh_N8!+=-K#(S1$myeWH!cD?(e|U
zrH6fz_FY0Q-lE9me{u=&;mD<A&W2QJn2IL~<E1DLxlQBGj#*~6ti5TsL*>mi*>VTi
zx{i`4^4ERvs;7{bEM4=ff0d15z9!Zm3N4-Kwa{=UJujdE2Bq2O*ty1C3qeT9lQ3kg
zb7WJFYLMs$mPs+(<TUQ}h^l%!bvkVOlcBne{ixl9jJp$P<B3Iayzq|#%f%`@IF~)n
zyz?UoS4u2H6(bh`!njiArX2etjcZJPVct-eD_hnh&uVRXfa`Z_Ia#02#Ajc%!fwkn
zbHCcR)!f=1sPH1EeV7RuKO58HCysQEcM%aiez?tpjtJmOJA-F?nwEiQ)5n9M|5;dx
z|N7)S|NP|EqQXl%R3i6B`t`TGH8FbT<B4)jhnP(oO4L@^D|M2Ux?)d47esV<?CieK
zFX3X2<M?xO`LS1KlERnspot2F--6t$nM@0bGL4_ZKUK(X9uRKNNQqUIWU`)K>pb6+
z>26{+R*6S6AO-p(zCp_89M&8kTWzq{NWCIGYE1af_?ZyBf^z!EZ>cU-3cX;Kuog;O
zN!_c^UqY`8py#=Ki&heU7-Xh?QRcUgw}<Vs-r}9u=5H2=KY2L6aQmHTNge82*8@JB
zNY$!v)hV{Y<GUj76ia{0*lv~fTGrFdY^|p)hd9AKbv=|Sp%TcYeYS7KUomL=!ZDNn
zp2JX$NjO^;8y>DIq4IYmyd(gBUsWg^u7>y@gQ<WKpkE9Ef&F4?YVcnSuB!5jA;AB(
zG_P1TRU0T61cEu*!{7)t2dD!CVebS6IpLr%91Mhjz!4xVjsM%YtEC0-^SAT$5At=w
S0aRfi5JUwaE30R$5BLW{`m3P;

diff --git a/doc/githubAccess_public.txt b/doc/githubAccess_public.txt
index ffc055cb..c547bf8f 100644
--- a/doc/githubAccess_public.txt
+++ b/doc/githubAccess_public.txt
@@ -73,13 +73,13 @@ add the lines (you find them also in .../cfdemParticle/etc/bashrc and cshrc resp
 #- source cfdem env vars
 export CFDEM_VERSION=PUBLIC
 export CFDEM_PROJECT_DIR=$HOME/CFDEM/CFDEMcoupling-$CFDEM_VERSION-$WM_PROJECT_VERSION
-export CFDEM_SRC_DIR=$CFDEM_PROJECT_DIR/src/lagrangian/cfdemParticle
+export CFDEM_SRC_DIR=$CFDEM_PROJECT_DIR/src
 export CFDEM_SOLVER_DIR=$CFDEM_PROJECT_DIR/applications/solvers
 export CFDEM_DOC_DIR=$CFDEM_PROJECT_DIR/doc
 export CFDEM_UT_DIR=$CFDEM_PROJECT_DIR/applications/utilities
 export CFDEM_TUT_DIR=$CFDEM_PROJECT_DIR/tutorials
 export CFDEM_PROJECT_USER_DIR=$HOME/CFDEM/$LOGNAME-$CFDEM_VERSION-$WM_PROJECT_VERSION
-export CFDEM_bashrc=$CFDEM_SRC_DIR/etc/bashrc
+export CFDEM_bashrc=$CFDEM_SRC_DIR/lagrangian/cfdemParticle/etc/bashrc
 export CFDEM_LIGGGHTS_SRC_DIR=$HOME/LIGGGHTS/LIGGGHTS-PUBLIC/src
 export CFDEM_LIGGGHTS_MAKEFILE_NAME=fedora_fpic
 export CFDEM_LPP_DIR=$HOME/LIGGGHTS/mylpp/src
@@ -95,7 +95,7 @@ $CFDEM_LIGGGHTS_SRC_DIR :pre
 
 should give "...: is a directory" otherwise something went wrong and the environment variables in ~/bashrc are not set correctly.
 
-To specify the paths of pizza, please check the settings in $CFDEM_SRC_DIR/etc/bashrc.
+To specify the paths of pizza, please check the settings in $CFDEM_SRC_DIR/lagrangian/cfdemParticle/etc/bashrc.
 
 If $CFDEM_SRC_DIR is set correctly, you can type 
 
diff --git a/src/lagrangian/cfdemParticle/Make/files b/src/lagrangian/cfdemParticle/Make/files
index 92a7d09f..c1fefcff 100644
--- a/src/lagrangian/cfdemParticle/Make/files
+++ b/src/lagrangian/cfdemParticle/Make/files
@@ -6,7 +6,6 @@ voidFractionModels = subModels/voidFractionModel
 locateModels = subModels/locateModel
 meshMotionModels = subModels/meshMotionModel
 momCoupleModels = subModels/momCoupleModel
-regionModels = subModels/regionModel
 dataExchangeModels = subModels/dataExchangeModel
 averagingModels = subModels/averagingModel
 clockModels = subModels/clockModel
@@ -15,6 +14,7 @@ smoothingModels = subModels/smoothingModel
 probeModels = subModels/probeModel
 
 $(cfdemCloud)/cfdemCloud.C
+derived/cfdemCloudBiDisperse/cfdemCloudBiDisperse.C
 derived/cfdemCloudIB/cfdemCloudIB.C
 derived/cfdemCloudMS/cfdemCloudMS.C
 
@@ -23,26 +23,43 @@ $(forceModels)/forceModel/newForceModel.C
 $(forceModels)/noDrag/noDrag.C
 $(forceModels)/checkCouplingInterval/checkCouplingInterval.C
 $(forceModels)/DiFeliceDrag/DiFeliceDrag.C
+$(forceModels)/DiFeliceDragNLift/DiFeliceDragNLift.C
 $(forceModels)/GidaspowDrag/GidaspowDrag.C
 $(forceModels)/SchillerNaumannDrag/SchillerNaumannDrag.C
 $(forceModels)/Archimedes/Archimedes.C
 $(forceModels)/ArchimedesIB/ArchimedesIB.C
 $(forceModels)/interface/interface.C
 $(forceModels)/ShirgaonkarIB/ShirgaonkarIB.C
+$(forceModels)/fieldTimeAverage/fieldTimeAverage.C
+$(forceModels)/fieldBound/fieldBound.C
+$(forceModels)/volWeightedAverage/volWeightedAverage.C
+$(forceModels)/totalMomentumExchange/totalMomentumExchange.C
 $(forceModels)/KochHillDrag/KochHillDrag.C
 $(forceModels)/KochHillRWDrag/KochHillRWDrag.C
+$(forceModels)/BeetstraDrag/multiphaseFlowBasic/multiphaseFlowBasic.C
+$(forceModels)/BeetstraDrag/BeetstraDrag.C
+$(forceModels)/LaEuScalarLiquid/LaEuScalarLiquid.C
 $(forceModels)/LaEuScalarTemp/LaEuScalarTemp.C
+$(forceModels)/LaEuScalarDust/LaEuScalarDust.C
 $(forceModels)/virtualMassForce/virtualMassForce.C
 $(forceModels)/gradPForce/gradPForce.C
+$(forceModels)/gradULiftForce/gradULiftForce.C
+$(forceModels)/HollowayDrag/HollowayDrag.C
 $(forceModels)/viscForce/viscForce.C
 $(forceModels)/MeiLift/MeiLift.C
+$(forceModels)/melting/melting.C
+$(forceModels)/KochHillDragNLift/KochHillDragNLift.C
+$(forceModels)/solidsPressureForce/solidsPressureForce.C
+$(forceModels)/periodicPressure/periodicPressure.C
+$(forceModels)/periodicPressureControl/periodicPressureControl.C
+$(forceModels)/averageSlipVel/averageSlipVel.C
 $(forceModels)/particleCellVolume/particleCellVolume.C
-$(forceModels)/fieldTimeAverage/fieldTimeAverage.C
-$(forceModels)/volWeightedAverage/volWeightedAverage.C
 
 $(forceModelsMS)/forceModelMS/forceModelMS.C
 $(forceModelsMS)/forceModelMS/newForceModelMS.C
 $(forceModelsMS)/DiFeliceDragMS/DiFeliceDragMS.C
+$(forceModelsMS)/GidaspowDragMS/GidaspowDragMS.C
+$(forceModelsMS)/noDragMS/noDragMS.C
 
 $(probeModels)/probeModel/probeModel.C
 $(probeModels)/probeModel/newProbeModel.C
@@ -60,10 +77,12 @@ $(voidFractionModels)/voidFractionModel/voidFractionModel.C
 $(voidFractionModels)/voidFractionModel/newVoidFractionModel.C
 $(voidFractionModels)/centreVoidFraction/centreVoidFraction.C
 $(voidFractionModels)/dividedVoidFraction/dividedVoidFraction.C
+$(voidFractionModels)/dividedVoidFractionBiDi/dividedVoidFractionBiDi.C
 $(voidFractionModels)/dividedVoidFractionMS/dividedVoidFractionMS.C
 $(voidFractionModels)/bigParticleVoidFraction/bigParticleVoidFraction.C
 $(voidFractionModels)/GaussVoidFraction/GaussVoidFraction.C
 $(voidFractionModels)/IBVoidFraction/IBVoidFraction.C
+$(voidFractionModels)/weightedNeigbhorsVoidFraction/weightedNeigbhorsVoidFraction.C
 
 $(locateModels)/locateModel/locateModel.C
 $(locateModels)/locateModel/newLocateModel.C
@@ -73,21 +92,18 @@ $(locateModels)/turboEngineSearch/turboEngineSearch.C
 $(locateModels)/turboEngineSearchM2M/turboEngineSearchM2M.C
 $(locateModels)/engineSearchIB/engineSearchIB.C
 
-
 $(meshMotionModels)/meshMotionModel/meshMotionModel.C
 $(meshMotionModels)/meshMotionModel/newMeshMotionModel.C
 $(meshMotionModels)/noMeshMotion/noMeshMotion.C
+$(meshMotionModels)/DEMdrivenMeshMotion/DEMdrivenMeshMotion.C
 
 $(momCoupleModels)/momCoupleModel/momCoupleModel.C
 $(momCoupleModels)/momCoupleModel/newMomCoupleModel.C
 $(momCoupleModels)/explicitCouple/explicitCouple.C
+$(momCoupleModels)/explicitCoupleSource/explicitCoupleSource.C
 $(momCoupleModels)/implicitCouple/implicitCouple.C
 $(momCoupleModels)/noCouple/noCouple.C
 
-$(regionModels)/regionModel/regionModel.C
-$(regionModels)/regionModel/newRegionModel.C
-$(regionModels)/allRegion/allRegion.C
-
 $(dataExchangeModels)/dataExchangeModel/dataExchangeModel.C
 $(dataExchangeModels)/dataExchangeModel/newDataExchangeModel.C
 $(dataExchangeModels)/oneWayVTK/oneWayVTK.C
@@ -100,6 +116,7 @@ $(averagingModels)/averagingModel/averagingModel.C
 $(averagingModels)/averagingModel/newAveragingModel.C
 $(averagingModels)/dilute/dilute.C
 $(averagingModels)/dense/dense.C
+$(averagingModels)/denseBiDi/denseBiDi.C
 
 $(clockModels)/clockModel/clockModel.C
 $(clockModels)/clockModel/newClockModel.C
@@ -117,5 +134,6 @@ $(smoothingModels)/smoothingModel/smoothingModel.C
 $(smoothingModels)/smoothingModel/newSmoothingModel.C
 $(smoothingModels)/noSmoothing/noSmoothing.C
 $(smoothingModels)/constDiffSmoothing/constDiffSmoothing.C
+$(smoothingModels)/localPSizeDiffSmoothing/localPSizeDiffSmoothing.C
 
-LIB = $(FOAM_USER_LIBBIN)/lib$(CFDEM_LIB_NAME)
+LIB = $(CFDEM_LIB_DIR)/lib$(CFDEM_LIB_NAME)
diff --git a/src/lagrangian/cfdemParticle/etc/library-list.txt b/src/lagrangian/cfdemParticle/etc/library-list.txt
index 27e798d4..e97f7fee 100644
--- a/src/lagrangian/cfdemParticle/etc/library-list.txt
+++ b/src/lagrangian/cfdemParticle/etc/library-list.txt
@@ -1 +1,3 @@
+cylPorousMedia/dir
+finiteVolume/dir
 lagrangian/cfdemParticle/dir
diff --git a/src/lagrangian/cfdemParticle/etc/solver-list.txt b/src/lagrangian/cfdemParticle/etc/solver-list.txt
index 803579e7..8c6566e2 100644
--- a/src/lagrangian/cfdemParticle/etc/solver-list.txt
+++ b/src/lagrangian/cfdemParticle/etc/solver-list.txt
@@ -1,5 +1,7 @@
+cfdemSolverInterDyM/dir
 cfdemSolverPimple/dir
 cfdemSolverPisoMS/dir
 cfdemSolverPiso/dir
 cfdemSolverIB/dir
 cfdemSolverPisoScalar/dir
+cfdemSolverPimpleDyM_22x/dir
diff --git a/src/lagrangian/cfdemParticle/etc/tutorial-list.txt b/src/lagrangian/cfdemParticle/etc/tutorial-list.txt
index c8f69535..a9669d55 100644
--- a/src/lagrangian/cfdemParticle/etc/tutorial-list.txt
+++ b/src/lagrangian/cfdemParticle/etc/tutorial-list.txt
@@ -18,12 +18,20 @@ cfdemSolverIB/twoSpheresGlowinskiMPI/dir
 
 cfdemSolverPisoScalar/packedBedTemp/dir
 
+#===================================================================#
+# not in release:
 
+#cfdemSolverPiso/settlingTestBigParticleMPI/dir
+#cfdemSolverPiso/ErgunTestCG/dir
+#cfdemSolverPiso/ErgunTestM2M/dir
+#cfdemSolverPiso/HopperEmptying/dir
 
-cfdemSolverPiso/ErgunTestCG/dir
-
-cfdemSolverPimple/ErgunTestMPI/dir
-
-
+#cfdemSolverPisoMS/settlingTestMPI/dir
+#cfdemSolverPisoMS/ErgunTestMPI/dir
 
+#cfdemSolverPimple/ErgunTestMPI/dir
 
+#cfdemSolverInterDyM/twoPhaseSettlingTest/dir
+#cfdemSolverInterDyM/ErgunTestMPI/dir
+#cfdemSolverInterDyM/granularPiston/dir
+#cfdemSolverInterDyM/sugarNcoffee/dir