From e013e0549f5eebc4533be57d4cd0f7ddf3ad4a97 Mon Sep 17 00:00:00 2001 From: Christoph Goniva Date: Wed, 18 May 2016 11:38:55 +0200 Subject: [PATCH] release on 2016-05-18_11-38-54 --- COPYING | 678 -------------- DISCLAIMER | 10 - README | 83 -- .../solvers/cfdemSolverIB/Make/options | 6 +- .../solvers/cfdemSolverIB/cfdemSolverIB.C | 11 +- .../solvers/cfdemSolverPiso/Make/options | 4 + .../solvers/cfdemSolverPiso/cfdemSolverPiso.C | 37 +- .../solvers/cfdemSolverPisoSTM/Make/options | 3 + .../cfdemSolverPisoSTM/cfdemSolverPisoSTM.C | 3 +- .../cfdemSolverPisoScalar/Make/options | 3 + .../cfdemSolverPisoScalar.C | 3 +- .../utilities/cfdemPostproc/Make/options | 3 + doc/CFDEMcoupling_Manual.html | 13 +- doc/CFDEMcoupling_Manual.pdf | Bin 546566 -> 615272 bytes doc/dataExchangeModel_twoWayFiles.html | 7 +- doc/forceModel_Archimedes.html | 9 + doc/forceModel_ArchimedesIB.html | 6 + doc/forceModel_DiFeliceDrag.html | 38 +- doc/forceModel_GidaspowDrag.html | 43 +- doc/forceModel_KochHillDrag.html | 41 +- doc/forceModel_LaEuScalarTemp.html | 34 +- doc/forceModel_MeiLift.html | 19 +- doc/forceModel_SchillerNaumannDrag.html | 14 + doc/forceModel_ShirgaonkarIB.html | 16 +- doc/forceModel_fieldTimeAverage.html | 2 +- doc/forceModel_gradPForce.html | 17 +- doc/forceModel_noDrag.html | 21 +- doc/forceModel_particleVolume.html | 10 +- doc/forceModel_scalarGeneralExchange.html | 43 + doc/forceModel_virtualMassForce.html | 24 + doc/forceModel_viscForce.html | 25 +- doc/forceModel_volWeightedAverage.html | 22 +- doc/forceSubModel.html | 21 + doc/githubAccess_public.html | 156 +++- doc/githubAccess_public.pdf | Bin 367455 -> 371232 bytes ...liggghtsCommandModel_readLiggghtsData.html | 15 +- doc/locateModel_engineSearchIB.html | 3 + doc/momCoupleModel_explicitCouple.html | 2 +- doc/probeModel_noProbe.html | 2 + doc/probeModel_particleProbe.html | 12 +- doc/scalarTransportModel.html | 89 ++ doc/smoothingModel_constDiffSmoothing.html | 3 + doc/voidFractionModel_GaussVoidFraction.html | 2 +- doc/voidFractionModel_IBVoidFraction.html | 5 +- ...FractionModel_bigParticleVoidFraction.html | 2 +- doc/voidFractionModel_centreVoidFraction.html | 2 +- ...voidFractionModel_dividedVoidFraction.html | 8 +- doc/voidFractionModel_noVoidFraction.html | 2 +- ...idFractionModel_trilinearVoidFraction.html | 2 +- .../scalarTransportModelsCFDEM/Make/files | 2 +- .../scalarTransportModelsCFDEM/Make/options | 12 +- .../eulerianScalarField/eulerianScalarField.C | 30 +- .../eulerianScalarField/eulerianScalarField.H | 4 + .../generalManual/generalManual.C | 24 +- .../generalManual/generalManual.H | 9 +- .../generalPhaseChange/generalPhaseChange.C | 109 +++ .../generalPhaseChange/generalPhaseChange.H | 91 ++ .../phaseChangeModel/phaseChangeModel.C | 89 +- .../phaseChangeModel/phaseChangeModel.H | 26 + src/lagrangian/cfdemParticle/Make/files | 124 --- src/lagrangian/cfdemParticle/Make/options | 33 - .../cfdTools/continuityErrorPhiPU.H | 2 +- .../cfdTools/continuityErrorPhiVoidfraction.H | 51 ++ .../cfdemParticle/cfdTools/mathExtra.H | 5 +- .../cfdTools/readPISOControls_OF30.H | 8 + .../resetAlphaInterpolator.H | 1 + .../resetDDtUInterpolator.H | 1 + .../resetDSauterInterpolator.H | 1 + .../resetDivTauInterpolator.H | 1 + .../resetFluidScalarFieldInterpolator.H | 1 + .../resetGradAlphaInterpolator.H | 1 + .../resetGradPInterpolator.H | 1 + .../resetGradPsolidInterpolator.H | 1 + .../resetGradUInterpolator.H | 1 + .../resetGradVoidfractionInterpolator.H | 1 + .../resetPhiP1Interpolator.H | 1 + .../resetPhiP2Interpolator.H | 1 + .../resetShearRateInterpolator.H | 1 + .../resetInterpolators/resetTInterpolator.H | 1 + .../resetInterpolators/resetUInterpolator.H | 1 + .../resetInterpolators/resetUp1Interpolator.H | 1 + .../resetInterpolators/resetUp2Interpolator.H | 1 + .../resetInterpolators/resetUsInterpolator.H | 1 + .../resetVoidfractionInterpolator.H | 1 + .../resetVorticityInterpolator.H | 1 + .../cfdemParticle/cfdTools/versionInfo.H | 6 +- .../cfdemParticle/cfdemCloud/cfdemCloud.C | 162 ++++ .../cfdemParticle/cfdemCloud/cfdemCloud.H | 71 +- .../cfdemParticle/cfdemCloud/cfdemCloudI.H | 6 + .../derived/cfdemCloudIB/cfdemCloudIB.C | 859 +----------------- .../derived/cfdemCloudIB/cfdemCloudIB.H | 41 +- .../changeDictionaryDict_2.4.x | 29 + .../changeDictionaryDict_3.0.x | 38 + .../shellScripts/activateVersion.sh | 12 + .../shellScripts/cfdemChangeTutOFversion.sh | 32 + .../shellScripts/commentOut.sh | 5 + .../OFVersionChange/shellScripts/unComment.sh | 5 + .../cfdemParticle/etc/OFversion/OFversion.H | 44 - .../cfdemParticle/etc/additionalLibs | 39 - .../cfdemParticle/etc/additionalLibs_30x | 48 - .../cfdemParticle/etc/additionalLibs_ext32 | 45 - src/lagrangian/cfdemParticle/etc/bashrc | 24 +- .../cfdemParticle/etc/cleanCFDEMcoupling.sh | 1 - .../etc/compileCFDEMcoupling_sol.sh | 6 +- .../etc/compileCFDEMcoupling_src.sh | 51 +- .../etc/compileCFDEMcoupling_uti.sh | 2 +- .../cfdemParticle/etc/compileLIGGGHTS.sh | 4 +- .../cfdemParticle/etc/compileLIGGGHTS_lib.sh | 5 +- src/lagrangian/cfdemParticle/etc/cshrc | 24 +- src/lagrangian/cfdemParticle/etc/functions.sh | 128 ++- .../etc/library-liggghts-list.txt | 3 - .../cfdemParticle/etc/library-list.txt | 2 - .../cfdemParticle/etc/solver-list.txt | 4 - .../cfdemParticle/etc/tutorial-list.txt | 22 - .../cfdemParticle/etc/utilities-list.txt | 1 - .../averagingModel/averagingModel.C | 5 - .../clockModel/clockModel/clockModel.C | 586 +++++------- .../clockModel/clockModel/clockModel.H | 6 +- .../subModels/clockModel/noClock/noClock.H | 4 +- .../dataExchangeModel/dataExchangeModel.C | 76 +- .../dataExchangeModel/twoWayMPI/twoWayMPI.C | 44 +- .../dataExchangeModel/twoWayMPI/twoWayMPI.H | 8 - .../forceModel/Archimedes/Archimedes.C | 5 +- .../forceModel/DiFeliceDrag/DiFeliceDrag.C | 22 +- .../forceModel/GidaspowDrag/GidaspowDrag.C | 9 +- .../forceModel/KochHillDrag/KochHillDrag.C | 16 +- .../LaEuScalarTemp/LaEuScalarTemp.C | 24 +- .../LaEuScalarTemp/LaEuScalarTemp.H | 2 +- .../subModels/forceModel/MeiLift/MeiLift.C | 41 +- .../subModels/forceModel/MeiLift/MeiLift.H | 3 + .../SchillerNaumannDrag/SchillerNaumannDrag.C | 214 +++-- .../SchillerNaumannDrag/SchillerNaumannDrag.H | 14 +- .../forceModel/ShirgaonkarIB/ShirgaonkarIB.C | 8 +- .../forceModel/fieldStore/fieldStore.C | 8 +- .../fieldTimeAverage/fieldTimeAverage.C | 101 +- .../fieldTimeAverage/fieldTimeAverage.H | 23 +- .../forceModel/forceModel/forceModel.C | 34 +- .../forceModel/forceModel/forceModel.H | 48 + .../forceSubModel/forceSubModel.C | 35 +- .../forceSubModel/forceSubModel.H | 67 +- .../forceModel/gradPForce/gradPForce.C | 13 +- .../forceModel/interface/interface.C | 15 +- .../forceModel/interface/interface.H | 4 - .../particleCellVolume/particleCellVolume.C | 2 +- .../scalarGeneralExchange.C | 660 +++++++------- .../scalarGeneralExchange.H | 54 +- .../virtualMassForce/virtualMassForce.C | 76 +- .../forceModel/viscForce/viscForce.C | 10 +- .../volWeightedAverage/volWeightedAverage.C | 61 +- .../volWeightedAverage/volWeightedAverage.H | 6 + .../locateModel/engineSearch/engineSearch.C | 2 + .../engineSearchIB/engineSearchIB.C | 64 +- .../engineSearchIB/engineSearchIB.H | 5 +- .../meshMotionModel/meshMotionModel.C | 93 +- .../meshMotionModel/meshMotionModel.H | 8 +- .../explicitCouple/explicitCouple.C | 21 +- .../explicitCouple/explicitCouple.H | 3 + .../subModels/probeModel/noProbe/noProbe.C | 2 +- .../subModels/probeModel/noProbe/noProbe.H | 2 +- .../probeModel/particleProbe/particleProbe.C | 143 +-- .../probeModel/particleProbe/particleProbe.H | 12 +- .../probeModel/probeModel/newProbeModel.C | 4 +- .../probeModel/probeModel/probeModel.C | 11 +- .../probeModel/probeModel/probeModel.H | 17 +- .../IBVoidFraction/IBVoidFraction.C | 14 +- .../dividedVoidFraction/dividedVoidFraction.C | 76 +- .../noVoidFraction/noVoidFraction.C | 4 + .../voidFractionModel/voidFractionModel.C | 8 +- .../voidFractionModel/voidFractionModel.H | 4 + src/lagrangian/cfdemParticleComp/Make/files | 126 --- src/lagrangian/cfdemParticleComp/Make/options | 39 - tutorials/.gitignore | 3 + .../cfdemPostproc/fillCylinder/Allrun.sh | 20 +- .../CFD/constant/couplingProperties | 3 +- .../CFD/constant/turbulenceProperties | 3 +- .../fillCylinder/DEM/post/.gitignore | 0 .../CFD/constant/couplingProperties | 4 +- .../CFD/constant/turbulenceProperties | 3 +- .../CFD/constant/couplingProperties | 37 +- .../CFD/constant/turbulenceProperties | 3 +- .../CFD/octave/totalPressureDrop.m | 2 +- .../ErgunTestMPI/CFD/system/controlDict | 57 ++ .../ErgunTestMPI/DEM/in.liggghts_run | 5 +- .../ErgunTestMPI/parCFDDEMrun.sh | 3 +- .../CFD/constant/couplingProperties | 3 +- .../CFD/constant/turbulenceProperties | 4 +- .../CFD/constant/couplingProperties_restart | 3 +- .../CFD/constant/couplingProperties_run | 3 +- .../CFD/constant/turbulenceProperties | 3 +- .../CFD/constant/couplingProperties | 3 +- .../CFD/constant/turbulenceProperties | 3 +- .../CFD/constant/couplingProperties | 6 +- .../CFD/constant/turbulenceProperties | 3 +- .../voidfractionTest/CFD/system/controlDict | 22 + .../CFD/constant/couplingProperties | 7 +- .../CFD/constant/scalarTransportProperties | 2 +- .../CFD/constant/turbulenceProperties | 12 +- .../packedBedTemp/cleanCase.sh | 1 + .../CFD/constant/couplingProperties | 3 +- .../CFD/constant/turbulenceProperties | 3 +- 200 files changed, 3358 insertions(+), 3760 deletions(-) delete mode 100644 COPYING delete mode 100644 DISCLAIMER delete mode 100755 README create mode 100644 doc/scalarTransportModel.html create mode 100644 src/eulerian/scalarTransportModelsCFDEM/generalPhaseChange/generalPhaseChange.C create mode 100644 src/eulerian/scalarTransportModelsCFDEM/generalPhaseChange/generalPhaseChange.H delete mode 100755 src/lagrangian/cfdemParticle/Make/files delete mode 100755 src/lagrangian/cfdemParticle/Make/options create mode 100644 src/lagrangian/cfdemParticle/cfdTools/continuityErrorPhiVoidfraction.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/readPISOControls_OF30.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetAlphaInterpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetDDtUInterpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetDSauterInterpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetDivTauInterpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetFluidScalarFieldInterpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradAlphaInterpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradPInterpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradPsolidInterpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradUInterpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradVoidfractionInterpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetPhiP1Interpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetPhiP2Interpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetShearRateInterpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetTInterpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetUInterpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetUp1Interpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetUp2Interpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetUsInterpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetVoidfractionInterpolator.H create mode 100644 src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetVorticityInterpolator.H create mode 100644 src/lagrangian/cfdemParticle/etc/OFVersionChange/changeDictionaryDicts/changeDictionaryDict_2.4.x create mode 100644 src/lagrangian/cfdemParticle/etc/OFVersionChange/changeDictionaryDicts/changeDictionaryDict_3.0.x create mode 100755 src/lagrangian/cfdemParticle/etc/OFVersionChange/shellScripts/activateVersion.sh create mode 100644 src/lagrangian/cfdemParticle/etc/OFVersionChange/shellScripts/cfdemChangeTutOFversion.sh create mode 100755 src/lagrangian/cfdemParticle/etc/OFVersionChange/shellScripts/commentOut.sh create mode 100755 src/lagrangian/cfdemParticle/etc/OFVersionChange/shellScripts/unComment.sh delete mode 100644 src/lagrangian/cfdemParticle/etc/OFversion/OFversion.H delete mode 100644 src/lagrangian/cfdemParticle/etc/additionalLibs delete mode 100644 src/lagrangian/cfdemParticle/etc/additionalLibs_30x delete mode 100644 src/lagrangian/cfdemParticle/etc/additionalLibs_ext32 delete mode 100644 src/lagrangian/cfdemParticle/etc/library-liggghts-list.txt delete mode 100644 src/lagrangian/cfdemParticle/etc/library-list.txt delete mode 100644 src/lagrangian/cfdemParticle/etc/solver-list.txt delete mode 100644 src/lagrangian/cfdemParticle/etc/tutorial-list.txt delete mode 100644 src/lagrangian/cfdemParticle/etc/utilities-list.txt delete mode 100755 src/lagrangian/cfdemParticleComp/Make/files delete mode 100755 src/lagrangian/cfdemParticleComp/Make/options create mode 100644 tutorials/cfdemPostproc/fillCylinder/DEM/post/.gitignore diff --git a/COPYING b/COPYING deleted file mode 100644 index de2dcce..0000000 --- a/COPYING +++ /dev/null @@ -1,678 +0,0 @@ -------------------------------------------------------------------------- - - GNU GENERAL PUBLIC LICENSE - Version 3, 29 June 2007 - - Copyright (C) 2007 Free Software Foundation, Inc. - Everyone is permitted to copy and distribute verbatim copies - of this license document, but changing it is not allowed. - - Preamble - - The GNU General Public License is a free, copyleft license for -software and other kinds of works. - - The licenses for most software and other practical works are designed -to take away your freedom to share and change the works. By contrast, -the GNU General Public License is intended to guarantee your freedom to -share and change all versions of a program--to make sure it remains free -software for all its users. We, the Free Software Foundation, use the -GNU General Public License for most of our software; it applies also to -any other work released this way by its authors. You can apply it to -your programs, too. - - When we speak of free software, we are referring to freedom, not -price. Our General Public Licenses are designed to make sure that you -have the freedom to distribute copies of free software (and charge for -them if you wish), that you receive source code or can get it if you -want it, that you can change the software or use pieces of it in new -free programs, and that you know you can do these things. - - To protect your rights, we need to prevent others from denying you -these rights or asking you to surrender the rights. Therefore, you have -certain responsibilities if you distribute copies of the software, or if -you modify it: responsibilities to respect the freedom of others. - - For example, if you distribute copies of such a program, whether -gratis or for a fee, you must pass on to the recipients the same -freedoms that you received. You must make sure that they, too, receive -or can get the source code. And you must show them these terms so they -know their rights. - - Developers that use the GNU GPL protect your rights with two steps: -(1) assert copyright on the software, and (2) offer you this License -giving you legal permission to copy, distribute and/or modify it. - - For the developers' and authors' protection, the GPL clearly explains -that there is no warranty for this free software. For both users' and -authors' sake, the GPL requires that modified versions be marked as -changed, so that their problems will not be attributed erroneously to -authors of previous versions. - - Some devices are designed to deny users access to install or run -modified versions of the software inside them, although the manufacturer -can do so. This is fundamentally incompatible with the aim of -protecting users' freedom to change the software. The systematic -pattern of such abuse occurs in the area of products for individuals to -use, which is precisely where it is most unacceptable. Therefore, we -have designed this version of the GPL to prohibit the practice for those -products. If such problems arise substantially in other domains, we -stand ready to extend this provision to those domains in future versions -of the GPL, as needed to protect the freedom of users. - - Finally, every program is threatened constantly by software patents. -States should not allow patents to restrict development and use of -software on general-purpose computers, but in those that do, we wish to -avoid the special danger that patents applied to a free program could -make it effectively proprietary. To prevent this, the GPL assures that -patents cannot be used to render the program non-free. - - The precise terms and conditions for copying, distribution and -modification follow. - - TERMS AND CONDITIONS - - 0. Definitions. - - "This License" refers to version 3 of the GNU General Public License. - - "Copyright" also means copyright-like laws that apply to other kinds of -works, such as semiconductor masks. - - "The Program" refers to any copyrightable work licensed under this -License. Each licensee is addressed as "you". "Licensees" and -"recipients" may be individuals or organizations. - - To "modify" a work means to copy from or adapt all or part of the work -in a fashion requiring copyright permission, other than the making of an -exact copy. The resulting work is called a "modified version" of the -earlier work or a work "based on" the earlier work. - - A "covered work" means either the unmodified Program or a work based -on the Program. - - To "propagate" a work means to do anything with it that, without -permission, would make you directly or secondarily liable for -infringement under applicable copyright law, except executing it on a -computer or modifying a private copy. Propagation includes copying, -distribution (with or without modification), making available to the -public, and in some countries other activities as well. - - To "convey" a work means any kind of propagation that enables other -parties to make or receive copies. Mere interaction with a user through -a computer network, with no transfer of a copy, is not conveying. - - An interactive user interface displays "Appropriate Legal Notices" -to the extent that it includes a convenient and prominently visible -feature that (1) displays an appropriate copyright notice, and (2) -tells the user that there is no warranty for the work (except to the -extent that warranties are provided), that licensees may convey the -work under this License, and how to view a copy of this License. If -the interface presents a list of user commands or options, such as a -menu, a prominent item in the list meets this criterion. - - 1. Source Code. - - The "source code" for a work means the preferred form of the work -for making modifications to it. "Object code" means any non-source -form of a work. - - A "Standard Interface" means an interface that either is an official -standard defined by a recognized standards body, or, in the case of -interfaces specified for a particular programming language, one that -is widely used among developers working in that language. - - The "System Libraries" of an executable work include anything, other -than the work as a whole, that (a) is included in the normal form of -packaging a Major Component, but which is not part of that Major -Component, and (b) serves only to enable use of the work with that -Major Component, or to implement a Standard Interface for which an -implementation is available to the public in source code form. A -"Major Component", in this context, means a major essential component -(kernel, window system, and so on) of the specific operating system -(if any) on which the executable work runs, or a compiler used to -produce the work, or an object code interpreter used to run it. - - The "Corresponding Source" for a work in object code form means all -the source code needed to generate, install, and (for an executable -work) run the object code and to modify the work, including scripts to -control those activities. However, it does not include the work's -System Libraries, or general-purpose tools or generally available free -programs which are used unmodified in performing those activities but -which are not part of the work. For example, Corresponding Source -includes interface definition files associated with source files for -the work, and the source code for shared libraries and dynamically -linked subprograms that the work is specifically designed to require, -such as by intimate data communication or control flow between those -subprograms and other parts of the work. - - The Corresponding Source need not include anything that users -can regenerate automatically from other parts of the Corresponding -Source. - - The Corresponding Source for a work in source code form is that -same work. - - 2. Basic Permissions. - - All rights granted under this License are granted for the term of -copyright on the Program, and are irrevocable provided the stated -conditions are met. This License explicitly affirms your unlimited -permission to run the unmodified Program. The output from running a -covered work is covered by this License only if the output, given its -content, constitutes a covered work. This License acknowledges your -rights of fair use or other equivalent, as provided by copyright law. - - You may make, run and propagate covered works that you do not -convey, without conditions so long as your license otherwise remains -in force. You may convey covered works to others for the sole purpose -of having them make modifications exclusively for you, or provide you -with facilities for running those works, provided that you comply with -the terms of this License in conveying all material for which you do -not control copyright. Those thus making or running the covered works -for you must do so exclusively on your behalf, under your direction -and control, on terms that prohibit them from making any copies of -your copyrighted material outside their relationship with you. - - Conveying under any other circumstances is permitted solely under -the conditions stated below. Sublicensing is not allowed; section 10 -makes it unnecessary. - - 3. Protecting Users' Legal Rights From Anti-Circumvention Law. - - No covered work shall be deemed part of an effective technological -measure under any applicable law fulfilling obligations under article -11 of the WIPO copyright treaty adopted on 20 December 1996, or -similar laws prohibiting or restricting circumvention of such -measures. - - When you convey a covered work, you waive any legal power to forbid -circumvention of technological measures to the extent such circumvention -is effected by exercising rights under this License with respect to -the covered work, and you disclaim any intention to limit operation or -modification of the work as a means of enforcing, against the work's -users, your or third parties' legal rights to forbid circumvention of -technological measures. - - 4. Conveying Verbatim Copies. - - You may convey verbatim copies of the Program's source code as you -receive it, in any medium, provided that you conspicuously and -appropriately publish on each copy an appropriate copyright notice; -keep intact all notices stating that this License and any -non-permissive terms added in accord with section 7 apply to the code; -keep intact all notices of the absence of any warranty; and give all -recipients a copy of this License along with the Program. - - You may charge any price or no price for each copy that you convey, -and you may offer support or warranty protection for a fee. - - 5. Conveying Modified Source Versions. - - You may convey a work based on the Program, or the modifications to -produce it from the Program, in the form of source code under the -terms of section 4, provided that you also meet all of these conditions: - - a) The work must carry prominent notices stating that you modified - it, and giving a relevant date. - - b) The work must carry prominent notices stating that it is - released under this License and any conditions added under section - 7. This requirement modifies the requirement in section 4 to - "keep intact all notices". - - c) You must license the entire work, as a whole, under this - License to anyone who comes into possession of a copy. This - License will therefore apply, along with any applicable section 7 - additional terms, to the whole of the work, and all its parts, - regardless of how they are packaged. This License gives no - permission to license the work in any other way, but it does not - invalidate such permission if you have separately received it. - - d) If the work has interactive user interfaces, each must display - Appropriate Legal Notices; however, if the Program has interactive - interfaces that do not display Appropriate Legal Notices, your - work need not make them do so. - - A compilation of a covered work with other separate and independent -works, which are not by their nature extensions of the covered work, -and which are not combined with it such as to form a larger program, -in or on a volume of a storage or distribution medium, is called an -"aggregate" if the compilation and its resulting copyright are not -used to limit the access or legal rights of the compilation's users -beyond what the individual works permit. Inclusion of a covered work -in an aggregate does not cause this License to apply to the other -parts of the aggregate. - - 6. Conveying Non-Source Forms. - - You may convey a covered work in object code form under the terms -of sections 4 and 5, provided that you also convey the -machine-readable Corresponding Source under the terms of this License, -in one of these ways: - - a) Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by the - Corresponding Source fixed on a durable physical medium - customarily used for software interchange. - - b) Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by a - written offer, valid for at least three years and valid for as - long as you offer spare parts or customer support for that product - model, to give anyone who possesses the object code either (1) a - copy of the Corresponding Source for all the software in the - product that is covered by this License, on a durable physical - medium customarily used for software interchange, for a price no - more than your reasonable cost of physically performing this - conveying of source, or (2) access to copy the - Corresponding Source from a network server at no charge. - - c) Convey individual copies of the object code with a copy of the - written offer to provide the Corresponding Source. This - alternative is allowed only occasionally and noncommercially, and - only if you received the object code with such an offer, in accord - with subsection 6b. - - d) Convey the object code by offering access from a designated - place (gratis or for a charge), and offer equivalent access to the - Corresponding Source in the same way through the same place at no - further charge. You need not require recipients to copy the - Corresponding Source along with the object code. If the place to - copy the object code is a network server, the Corresponding Source - may be on a different server (operated by you or a third party) - that supports equivalent copying facilities, provided you maintain - clear directions next to the object code saying where to find the - Corresponding Source. Regardless of what server hosts the - Corresponding Source, you remain obligated to ensure that it is - available for as long as needed to satisfy these requirements. - - e) Convey the object code using peer-to-peer transmission, provided - you inform other peers where the object code and Corresponding - Source of the work are being offered to the general public at no - charge under subsection 6d. - - A separable portion of the object code, whose source code is excluded -from the Corresponding Source as a System Library, need not be -included in conveying the object code work. - - A "User Product" is either (1) a "consumer product", which means any -tangible personal property which is normally used for personal, family, -or household purposes, or (2) anything designed or sold for incorporation -into a dwelling. In determining whether a product is a consumer product, -doubtful cases shall be resolved in favor of coverage. For a particular -product received by a particular user, "normally used" refers to a -typical or common use of that class of product, regardless of the status -of the particular user or of the way in which the particular user -actually uses, or expects or is expected to use, the product. A product -is a consumer product regardless of whether the product has substantial -commercial, industrial or non-consumer uses, unless such uses represent -the only significant mode of use of the product. - - "Installation Information" for a User Product means any methods, -procedures, authorization keys, or other information required to install -and execute modified versions of a covered work in that User Product from -a modified version of its Corresponding Source. The information must -suffice to ensure that the continued functioning of the modified object -code is in no case prevented or interfered with solely because -modification has been made. - - If you convey an object code work under this section in, or with, or -specifically for use in, a User Product, and the conveying occurs as -part of a transaction in which the right of possession and use of the -User Product is transferred to the recipient in perpetuity or for a -fixed term (regardless of how the transaction is characterized), the -Corresponding Source conveyed under this section must be accompanied -by the Installation Information. But this requirement does not apply -if neither you nor any third party retains the ability to install -modified object code on the User Product (for example, the work has -been installed in ROM). - - The requirement to provide Installation Information does not include a -requirement to continue to provide support service, warranty, or updates -for a work that has been modified or installed by the recipient, or for -the User Product in which it has been modified or installed. Access to a -network may be denied when the modification itself materially and -adversely affects the operation of the network or violates the rules and -protocols for communication across the network. - - Corresponding Source conveyed, and Installation Information provided, -in accord with this section must be in a format that is publicly -documented (and with an implementation available to the public in -source code form), and must require no special password or key for -unpacking, reading or copying. - - 7. Additional Terms. - - "Additional permissions" are terms that supplement the terms of this -License by making exceptions from one or more of its conditions. -Additional permissions that are applicable to the entire Program shall -be treated as though they were included in this License, to the extent -that they are valid under applicable law. If additional permissions -apply only to part of the Program, that part may be used separately -under those permissions, but the entire Program remains governed by -this License without regard to the additional permissions. - - When you convey a copy of a covered work, you may at your option -remove any additional permissions from that copy, or from any part of -it. (Additional permissions may be written to require their own -removal in certain cases when you modify the work.) You may place -additional permissions on material, added by you to a covered work, -for which you have or can give appropriate copyright permission. - - Notwithstanding any other provision of this License, for material you -add to a covered work, you may (if authorized by the copyright holders of -that material) supplement the terms of this License with terms: - - a) Disclaiming warranty or limiting liability differently from the - terms of sections 15 and 16 of this License; or - - b) Requiring preservation of specified reasonable legal notices or - author attributions in that material or in the Appropriate Legal - Notices displayed by works containing it; or - - c) Prohibiting misrepresentation of the origin of that material, or - requiring that modified versions of such material be marked in - reasonable ways as different from the original version; or - - d) Limiting the use for publicity purposes of names of licensors or - authors of the material; or - - e) Declining to grant rights under trademark law for use of some - trade names, trademarks, or service marks; or - - f) Requiring indemnification of licensors and authors of that - material by anyone who conveys the material (or modified versions of - it) with contractual assumptions of liability to the recipient, for - any liability that these contractual assumptions directly impose on - those licensors and authors. - - All other non-permissive additional terms are considered "further -restrictions" within the meaning of section 10. If the Program as you -received it, or any part of it, contains a notice stating that it is -governed by this License along with a term that is a further -restriction, you may remove that term. If a license document contains -a further restriction but permits relicensing or conveying under this -License, you may add to a covered work material governed by the terms -of that license document, provided that the further restriction does -not survive such relicensing or conveying. - - If you add terms to a covered work in accord with this section, you -must place, in the relevant source files, a statement of the -additional terms that apply to those files, or a notice indicating -where to find the applicable terms. - - Additional terms, permissive or non-permissive, may be stated in the -form of a separately written license, or stated as exceptions; -the above requirements apply either way. - - 8. Termination. - - You may not propagate or modify a covered work except as expressly -provided under this License. Any attempt otherwise to propagate or -modify it is void, and will automatically terminate your rights under -this License (including any patent licenses granted under the third -paragraph of section 11). - - However, if you cease all violation of this License, then your -license from a particular copyright holder is reinstated (a) -provisionally, unless and until the copyright holder explicitly and -finally terminates your license, and (b) permanently, if the copyright -holder fails to notify you of the violation by some reasonable means -prior to 60 days after the cessation. - - Moreover, your license from a particular copyright holder is -reinstated permanently if the copyright holder notifies you of the -violation by some reasonable means, this is the first time you have -received notice of violation of this License (for any work) from that -copyright holder, and you cure the violation prior to 30 days after -your receipt of the notice. - - Termination of your rights under this section does not terminate the -licenses of parties who have received copies or rights from you under -this License. If your rights have been terminated and not permanently -reinstated, you do not qualify to receive new licenses for the same -material under section 10. - - 9. Acceptance Not Required for Having Copies. - - You are not required to accept this License in order to receive or -run a copy of the Program. Ancillary propagation of a covered work -occurring solely as a consequence of using peer-to-peer transmission -to receive a copy likewise does not require acceptance. However, -nothing other than this License grants you permission to propagate or -modify any covered work. These actions infringe copyright if you do -not accept this License. Therefore, by modifying or propagating a -covered work, you indicate your acceptance of this License to do so. - - 10. Automatic Licensing of Downstream Recipients. - - Each time you convey a covered work, the recipient automatically -receives a license from the original licensors, to run, modify and -propagate that work, subject to this License. You are not responsible -for enforcing compliance by third parties with this License. - - An "entity transaction" is a transaction transferring control of an -organization, or substantially all assets of one, or subdividing an -organization, or merging organizations. If propagation of a covered -work results from an entity transaction, each party to that -transaction who receives a copy of the work also receives whatever -licenses to the work the party's predecessor in interest had or could -give under the previous paragraph, plus a right to possession of the -Corresponding Source of the work from the predecessor in interest, if -the predecessor has it or can get it with reasonable efforts. - - You may not impose any further restrictions on the exercise of the -rights granted or affirmed under this License. For example, you may -not impose a license fee, royalty, or other charge for exercise of -rights granted under this License, and you may not initiate litigation -(including a cross-claim or counterclaim in a lawsuit) alleging that -any patent claim is infringed by making, using, selling, offering for -sale, or importing the Program or any portion of it. - - 11. Patents. - - A "contributor" is a copyright holder who authorizes use under this -License of the Program or a work on which the Program is based. The -work thus licensed is called the contributor's "contributor version". - - A contributor's "essential patent claims" are all patent claims -owned or controlled by the contributor, whether already acquired or -hereafter acquired, that would be infringed by some manner, permitted -by this License, of making, using, or selling its contributor version, -but do not include claims that would be infringed only as a -consequence of further modification of the contributor version. For -purposes of this definition, "control" includes the right to grant -patent sublicenses in a manner consistent with the requirements of -this License. - - Each contributor grants you a non-exclusive, worldwide, royalty-free -patent license under the contributor's essential patent claims, to -make, use, sell, offer for sale, import and otherwise run, modify and -propagate the contents of its contributor version. - - In the following three paragraphs, a "patent license" is any express -agreement or commitment, however denominated, not to enforce a patent -(such as an express permission to practice a patent or covenant not to -sue for patent infringement). To "grant" such a patent license to a -party means to make such an agreement or commitment not to enforce a -patent against the party. - - If you convey a covered work, knowingly relying on a patent license, -and the Corresponding Source of the work is not available for anyone -to copy, free of charge and under the terms of this License, through a -publicly available network server or other readily accessible means, -then you must either (1) cause the Corresponding Source to be so -available, or (2) arrange to deprive yourself of the benefit of the -patent license for this particular work, or (3) arrange, in a manner -consistent with the requirements of this License, to extend the patent -license to downstream recipients. "Knowingly relying" means you have -actual knowledge that, but for the patent license, your conveying the -covered work in a country, or your recipient's use of the covered work -in a country, would infringe one or more identifiable patents in that -country that you have reason to believe are valid. - - If, pursuant to or in connection with a single transaction or -arrangement, you convey, or propagate by procuring conveyance of, a -covered work, and grant a patent license to some of the parties -receiving the covered work authorizing them to use, propagate, modify -or convey a specific copy of the covered work, then the patent license -you grant is automatically extended to all recipients of the covered -work and works based on it. - - A patent license is "discriminatory" if it does not include within -the scope of its coverage, prohibits the exercise of, or is -conditioned on the non-exercise of one or more of the rights that are -specifically granted under this License. You may not convey a covered -work if you are a party to an arrangement with a third party that is -in the business of distributing software, under which you make payment -to the third party based on the extent of your activity of conveying -the work, and under which the third party grants, to any of the -parties who would receive the covered work from you, a discriminatory -patent license (a) in connection with copies of the covered work -conveyed by you (or copies made from those copies), or (b) primarily -for and in connection with specific products or compilations that -contain the covered work, unless you entered into that arrangement, -or that patent license was granted, prior to 28 March 2007. - - Nothing in this License shall be construed as excluding or limiting -any implied license or other defenses to infringement that may -otherwise be available to you under applicable patent law. - - 12. No Surrender of Others' Freedom. - - If conditions are imposed on you (whether by court order, agreement or -otherwise) that contradict the conditions of this License, they do not -excuse you from the conditions of this License. If you cannot convey a -covered work so as to satisfy simultaneously your obligations under this -License and any other pertinent obligations, then as a consequence you may -not convey it at all. For example, if you agree to terms that obligate you -to collect a royalty for further conveying from those to whom you convey -the Program, the only way you could satisfy both those terms and this -License would be to refrain entirely from conveying the Program. - - 13. Use with the GNU Affero General Public License. - - Notwithstanding any other provision of this License, you have -permission to link or combine any covered work with a work licensed -under version 3 of the GNU Affero General Public License into a single -combined work, and to convey the resulting work. The terms of this -License will continue to apply to the part which is the covered work, -but the special requirements of the GNU Affero General Public License, -section 13, concerning interaction through a network will apply to the -combination as such. - - 14. Revised Versions of this License. - - The Free Software Foundation may publish revised and/or new versions of -the GNU General Public License from time to time. Such new versions will -be similar in spirit to the present version, but may differ in detail to -address new problems or concerns. - - Each version is given a distinguishing version number. If the -Program specifies that a certain numbered version of the GNU General -Public License "or any later version" applies to it, you have the -option of following the terms and conditions either of that numbered -version or of any later version published by the Free Software -Foundation. If the Program does not specify a version number of the -GNU General Public License, you may choose any version ever published -by the Free Software Foundation. - - If the Program specifies that a proxy can decide which future -versions of the GNU General Public License can be used, that proxy's -public statement of acceptance of a version permanently authorizes you -to choose that version for the Program. - - Later license versions may give you additional or different -permissions. However, no additional obligations are imposed on any -author or copyright holder as a result of your choosing to follow a -later version. - - 15. Disclaimer of Warranty. - - THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY -APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT -HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY -OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, -THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM -IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF -ALL NECESSARY SERVICING, REPAIR OR CORRECTION. - - 16. Limitation of Liability. - - IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING -WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS -THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY -GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE -USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF -DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD -PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), -EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF -SUCH DAMAGES. - - 17. Interpretation of Sections 15 and 16. - - If the disclaimer of warranty and limitation of liability provided -above cannot be given local legal effect according to their terms, -reviewing courts shall apply local law that most closely approximates -an absolute waiver of all civil liability in connection with the -Program, unless a warranty or assumption of liability accompanies a -copy of the Program in return for a fee. - - END OF TERMS AND CONDITIONS - - How to Apply These Terms to Your New Programs - - If you develop a new program, and you want it to be of the greatest -possible use to the public, the best way to achieve this is to make it -free software which everyone can redistribute and change under these terms. - - To do so, attach the following notices to the program. It is safest -to attach them to the start of each source file to most effectively -state the exclusion of warranty; and each file should have at least -the "copyright" line and a pointer to where the full notice is found. - - - Copyright (C) - - This program 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. - - This program 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 this program. If not, see . - -Also add information on how to contact you by electronic and paper mail. - - If the program does terminal interaction, make it output a short -notice like this when it starts in an interactive mode: - - Copyright (C) - This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. - This is free software, and you are welcome to redistribute it - under certain conditions; type `show c' for details. - -The hypothetical commands `show w' and `show c' should show the appropriate -parts of the General Public License. Of course, your program's commands -might be different; for a GUI interface, you would use an "about box". - - You should also get your employer (if you work as a programmer) or school, -if any, to sign a "copyright disclaimer" for the program, if necessary. -For more information on this, and how to apply and follow the GNU GPL, see -. - - The GNU General Public License does not permit incorporating your program -into proprietary programs. If your program is a subroutine library, you -may consider it more useful to permit linking proprietary applications with -the library. If this is what you want to do, use the GNU Lesser General -Public License instead of this License. But first, please read -. - -------------------------------------------------------------------------- diff --git a/DISCLAIMER b/DISCLAIMER deleted file mode 100644 index 5a7dfe2..0000000 --- a/DISCLAIMER +++ /dev/null @@ -1,10 +0,0 @@ -Parts of the code uses OpenFOAM® technology. This offering is not approved or endorsed by OpenCFD Limited, the producer of the OpenFOAM software and owner of the OPENFOAM® and OpenCFD® trade marks. - -Detailed information on the OpenFOAM trademark can be found at - - - http://www.openfoam.com/legal/trademark-policy.php - - http://www.openfoam.com/legal/trademark-guidelines.php - -For further information on OpenCFD and OpenFOAM, please refer to - - - http://www.openfoam.com diff --git a/README b/README deleted file mode 100755 index 5b118cc..0000000 --- a/README +++ /dev/null @@ -1,83 +0,0 @@ -/*---------------------------------------------------------------------------*\ - 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 provides models and solvers 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®(*). The CFDEM®coupling toolbox allows to expand -standard CFD solvers of OpenFOAM®(*) 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 CFDEM®coupling distribution includes the following files and directories: - -- "README" file (this file) -- "LICENSE" file the GNU General Public License (GPL) -- "DISCLAIMER" file -- "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 CFDEM®coupling -- "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. - -CFDEM®coupling stands for Computational Fluid Dynamics (CFD) - -Discrete Element Method (DEM) coupling. - -CFDEM®coupling is an open-source code, distributed freely under the terms of the -GNU Public License (GPL). - -Core development of CFDEM®coupling is done by -Christoph Goniva and Christoph Kloss, both at DCS Computing GmbH, 2012 - - -\*---------------------------------------------------------------------------*/ -(*) This offering is not approved or endorsed by OpenCFD Limited, the producer of the OpenFOAM software and owner of the OPENFOAM® and OpenCFD® trade marks. -\*---------------------------------------------------------------------------*/ diff --git a/applications/solvers/cfdemSolverIB/Make/options b/applications/solvers/cfdemSolverIB/Make/options index 4175d7d..c3aae78 100755 --- a/applications/solvers/cfdemSolverIB/Make/options +++ b/applications/solvers/cfdemSolverIB/Make/options @@ -1,6 +1,9 @@ include $(CFDEM_ADD_LIBS_DIR)/$(CFDEM_ADD_LIBS_NAME) +PFLAGS+= -DCFDEMWMPROJECTVERSION="$(CFDEM_WM_PROJECT_VERSION)" + EXE_INC = \ + $(PFLAGS) \ $(CFDEM_ADD_INCOMPTURBMOD_PATHS) \ -I$(LIB_SRC)/transportModels \ -I$(LIB_SRC)/transportModels/incompressible/singlePhaseTransportModel \ @@ -11,7 +14,8 @@ EXE_INC = \ -I$(LIB_SRC)/dynamicFvMesh/lnInclude \ -I$(LIB_SRC)/dynamicMesh/lnInclude \ -I$(LIB_SRC)/dynamicMesh/dynamicFvMesh/lnInclude \ - -I$(LIB_SRC)/dynamicMesh/dynamicMesh/lnInclude + -I$(LIB_SRC)/dynamicMesh/dynamicMesh/lnInclude \ + -I$(CFDEM_LIGGGHTS_SRC_DIR) EXE_LIBS = \ -L$(CFDEM_LIB_DIR)\ $(CFDEM_ADD_INCOMPTURBMOD_LIBS) \ diff --git a/applications/solvers/cfdemSolverIB/cfdemSolverIB.C b/applications/solvers/cfdemSolverIB/cfdemSolverIB.C index 7be29bc..a45a519 100755 --- a/applications/solvers/cfdemSolverIB/cfdemSolverIB.C +++ b/applications/solvers/cfdemSolverIB/cfdemSolverIB.C @@ -47,8 +47,11 @@ Contributions #else #include "turbulenceModel.H" #endif - +#include "superquadric_flag.h" #include "cfdemCloudIB.H" +#if defined(SUPERQUADRIC_ACTIVE_FLAG) +#include "cfdemCloudIBSuperquadric.H" +#endif #include "implicitCouple.H" #include "averagingModel.H" @@ -89,7 +92,11 @@ int main(int argc, char *argv[]) // create cfdemCloud #include "readGravitationalAcceleration.H" - cfdemCloudIB particleCloud(mesh); + #if defined(SUPERQUADRIC_ACTIVE_FLAG) + cfdemCloudIBSuperquadric particleCloud(mesh); + #else + cfdemCloudIB particleCloud(mesh); + #endif // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * // diff --git a/applications/solvers/cfdemSolverPiso/Make/options b/applications/solvers/cfdemSolverPiso/Make/options index 6d83afe..a5f603d 100644 --- a/applications/solvers/cfdemSolverPiso/Make/options +++ b/applications/solvers/cfdemSolverPiso/Make/options @@ -1,6 +1,9 @@ include $(CFDEM_ADD_LIBS_DIR)/$(CFDEM_ADD_LIBS_NAME) +PFLAGS+= -DCFDEMWMPROJECTVERSION="$(CFDEM_WM_PROJECT_VERSION)" + EXE_INC = \ + $(PFLAGS) \ $(CFDEM_ADD_INCOMPTURBMOD_PATHS) \ -I$(LIB_SRC)/transportModels \ -I$(LIB_SRC)/transportModels/incompressible/singlePhaseTransportModel \ @@ -8,6 +11,7 @@ EXE_INC = \ -I$(LIB_SRC)/meshTools/lnInclude \ -I$(CFDEM_SRC_DIR)/lagrangian/cfdemParticle/lnInclude \ -I$(CFDEM_SRC_DIR)/lagrangian/cfdemParticle/cfdTools \ + -I$(CFDEM_LIGGGHTS_SRC_DIR) EXE_LIBS = \ -L$(CFDEM_LIB_DIR)\ diff --git a/applications/solvers/cfdemSolverPiso/cfdemSolverPiso.C b/applications/solvers/cfdemSolverPiso/cfdemSolverPiso.C index f8127f6..31651a1 100644 --- a/applications/solvers/cfdemSolverPiso/cfdemSolverPiso.C +++ b/applications/solvers/cfdemSolverPiso/cfdemSolverPiso.C @@ -46,14 +46,20 @@ Description #endif #include "fixedFluxPressureFvPatchScalarField.H" #include "cfdemCloud.H" + #if defined(anisotropicRotation) #include "cfdemCloudRotation.H" #endif +#include "superquadric_flag.h" +#if defined(SUPERQUADRIC_ACTIVE_FLAG) + #include "cfdemCloudRotationSuperquadric.H" +#endif #include "implicitCouple.H" #include "clockModel.H" #include "smoothingModel.H" #include "forceModel.H" + // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * // int main(int argc, char *argv[]) @@ -72,6 +78,8 @@ int main(int argc, char *argv[]) #include "readGravitationalAcceleration.H" #if defined(anisotropicRotation) cfdemCloudRotation particleCloud(mesh); + #elif defined(SUPERQUADRIC_ACTIVE_FLAG) + cfdemCloudRotationSuperquadric particleCloud(mesh); #else cfdemCloud particleCloud(mesh); #endif @@ -148,8 +156,7 @@ int main(int argc, char *argv[]) #if defined(version30) while (piso.correct()) #else - int nCorrSoph = nCorr + 5 * pow((1-particleCloud.dataExchangeM().timeStepFraction()),1); - for (int corr=0; corr - ( - p.boundaryField(), - ( - phi.boundaryField() - - (mesh.Sf().boundaryField() & U.boundaryField()) - )/(mesh.magSf().boundaryField()*rUAf.boundaryField()*voidfractionf.boundaryField()) - ); - }else - { - setSnGrad - ( - p.boundaryField(), - ( - phi.boundaryField() - - (mesh.Sf().boundaryField() & U.boundaryField()) - )/(mesh.magSf().boundaryField()*rUAf.boundaryField()) - ); - } - #endif - // Non-orthogonal pressure corrector loop #if defined(version30) while (piso.correctNonOrthogonal()) diff --git a/applications/solvers/cfdemSolverPisoSTM/Make/options b/applications/solvers/cfdemSolverPisoSTM/Make/options index 0658fe0..1146aba 100644 --- a/applications/solvers/cfdemSolverPisoSTM/Make/options +++ b/applications/solvers/cfdemSolverPisoSTM/Make/options @@ -1,6 +1,9 @@ include $(CFDEM_ADD_LIBS_DIR)/$(CFDEM_ADD_LIBS_NAME) +PFLAGS+= -DCFDEMWMPROJECTVERSION="$(CFDEM_WM_PROJECT_VERSION)" + EXE_INC = \ + $(PFLAGS) \ $(CFDEM_ADD_INCOMPTURBMOD_PATHS) \ -I$(LIB_SRC)/transportModels \ -I$(LIB_SRC)/transportModels/incompressible/singlePhaseTransportModel \ diff --git a/applications/solvers/cfdemSolverPisoSTM/cfdemSolverPisoSTM.C b/applications/solvers/cfdemSolverPisoSTM/cfdemSolverPisoSTM.C index b3b073b..5cfb879 100644 --- a/applications/solvers/cfdemSolverPisoSTM/cfdemSolverPisoSTM.C +++ b/applications/solvers/cfdemSolverPisoSTM/cfdemSolverPisoSTM.C @@ -174,8 +174,7 @@ int main(int argc, char *argv[]) #if defined(version30) while (piso.correct()) #else - int nCorrSoph = nCorr + 5 * pow((1-particleCloud.dataExchangeM().timeStepFraction()),1); - for (int corr=0; corrmomCoupleModel_implicitCouplemomCoupleModel_noCouple probeModelprobeModel_noProbe probeModel_particleProberegionModel -regionModel_allRegionsmoothingModel -smoothingModel_constDiffSmoothingsmoothingModel_noSmoothing -voidfractionModelvoidfractionModel_GaussVoidFraction -voidfractionModel_IBVoidFractionvoidfractionModel_bigParticleVoidFraction -voidfractionModel_centreVoidFractionvoidfractionModel_dividedVoidFraction -voidfractionModel_noVoidFractionVoidFractionvoidfractionModel_trilinearVoidFraction +regionModel_allRegionscalarTransportModel +smoothingModelsmoothingModel_constDiffSmoothing +smoothingModel_noSmoothingvoidfractionModel +voidfractionModel_GaussVoidFractionvoidfractionModel_IBVoidFraction +voidfractionModel_bigParticleVoidFractionvoidfractionModel_centreVoidFraction +voidfractionModel_dividedVoidFractionvoidfractionModel_noVoidFractionVoidFraction +voidfractionModel_trilinearVoidFraction diff --git a/doc/CFDEMcoupling_Manual.pdf b/doc/CFDEMcoupling_Manual.pdf index 2aed75ec0cb04efb9d01f1af3d81f2c1e048292d..8a26cc43faf1cd754f087583d81ea1228eb0f242 100644 GIT binary patch delta 169244 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 Y*MI!5{g?rJ2x{};v(LWx^7kM92T)?lC;$Ke delta 105652 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

XlC8rsJ`baOup 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

A3L<8#UZSM98G`qZj1h5Od}RePAm$5`^@ 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

diff --git a/doc/forceModel_Archimedes.html b/doc/forceModel_Archimedes.html index 8301478..49d86b7 100644 --- a/doc/forceModel_Archimedes.html +++ b/doc/forceModel_Archimedes.html @@ -20,10 +20,19 @@ ArchimedesProps { gravityFieldName "gravity"; + twoDimensional; + suppressProbe switch1; + treatForceDEM switch2; };

Examples: diff --git a/doc/forceModel_ArchimedesIB.html b/doc/forceModel_ArchimedesIB.html index 9f43172..681bf9f 100644 --- a/doc/forceModel_ArchimedesIB.html +++ b/doc/forceModel_ArchimedesIB.html @@ -21,12 +21,18 @@ ArchimedesIBProps { gravityFieldName "gravity"; voidfractionFieldName "voidfraction"; + twoDimensional; + treatForceExplicit switch1; };

  • gravity = name of the finite volume gravity field
  • voidfraction = name of the finite volume voidfraction field +
  • twoDimensional = optional keyword for conducting a two dimensional calculation + +
  • switch1 = (optional, default true) sub model switch, see forceSubModel for details +

Examples: diff --git a/doc/forceModel_DiFeliceDrag.html b/doc/forceModel_DiFeliceDrag.html index 53a2aeb..94eb175 100644 --- a/doc/forceModel_DiFeliceDrag.html +++ b/doc/forceModel_DiFeliceDrag.html @@ -20,12 +20,48 @@ DiFeliceDragProps { velFieldName "U"; + voidfractionFieldName "voidfraction"; + granVelFieldName "Us"; interpolation switch1; + voidfractionInterpolationType "type1"; + UInterpolationType "type2"; + suppressProbe switch2; + scale scalar1; + scaleDrag scalar2; + treatForceExplicit switch3; + implForceDEM switch4; + verbose switch5; + scalarViscosity switch6; + nu scalar3; };

  • U = name of the finite volume fluid velocity field -
  • switch1 = flag to use interpolated voidfraction and velocity values (normally off) +
  • voidfraction = name of the finite volume voidfraction field + +
  • Us = name of the finite volume granular velocity field + +
  • switch1 = (optional, normally off) flag to use interpolated voidfraction and velocity values + +
  • type1 = (optional, default cellPoint) interpolation type for voidfraction field + +
  • type2 = (optional, default cellPointFace) interpolation type for velocity field + +
  • switch2 = (optional, default false) can be used to suppress the output of the probe model + +
  • scalar1 = (optional) scaling of particle diameter + +
  • scalar2 = (optional) scaling of drag law + +
  • switch3 = sub model switch, see forceSubModel for details + +
  • switch4 = sub model switch, see forceSubModel for details + +
  • switch5 = sub model switch, see forceSubModel for details + +
  • switch6 = sub model switch, see forceSubModel for details + +
  • scalar3 = optional, only if switch6 is true
diff --git a/doc/forceModel_GidaspowDrag.html b/doc/forceModel_GidaspowDrag.html index 9aa7318..1d4cd7e 100644 --- a/doc/forceModel_GidaspowDrag.html +++ b/doc/forceModel_GidaspowDrag.html @@ -22,9 +22,20 @@ GidaspowDragProps velFieldName "U"; voidfractionFieldName "voidfraction"; granVelFieldName "Us"; - phi "scalar"; + phi scalar1; interpolation switch1; - implForceDEM switch2; + voidfractionInterpolationType "type1" + UInterpolationType "type2" + implForceDEM switch2; + suppressProbe switch3; + scale scalar2; + scaleDrag scalar3; + switchingVoidfraction scalar4; + treatForceExplicit switch4; + implForceDEM switch5; + verbose switch6; + scalarViscosity switch7; + nu scalar5; };
  • U = name of the finite volume fluid velocity field @@ -33,11 +44,33 @@ GidaspowDragProps
  • Us = name of the finite volume cell averaged particle velocity field -
  • phi = drag correction factor (in doubt 1) +
  • scalar1 = drag correction factor (in doubt 1) -
  • switch1 = (optional, normally off) flag to use interpolated voidfraction and fluid velocity values +
  • switch1 = (optional, default off) flag to use interpolated voidfraction and fluid velocity values + +
  • type1 = (optional, default cellPoint) interpolation type for voidfraction field + +
  • type2 = (optional, default cellPointFace) interpolation type for velocity field + +
  • switch2 = (optional, default false) flag to use implicit formulation of drag on DEM side:l +switch3 = (optional, default false) can be used to suppress the output of the probe model + +
  • scalar2 = (optional) scaling of particle diameter + +
  • scalar3 = (optional) scaling of drag law + +
  • scalar4 = (optional) voidfraction above which dilute formulation will be used + +
  • switch4 = (optional, default false) sub model switch, see forceSubModel for details + +
  • switch5 = (optional, default false) sub model switch, see forceSubModel for details + +
  • switch6 = (optional, default false) sub model switch, see forceSubModel for details + +
  • switch7 = (optional, default false) sub model switch, see forceSubModel for details + +
  • scalar5 = (optional, default false) optional, only if switch6 is true -switch2 = (optional, normally off) flag to use implicit formulation of drag on DEM side:l

Examples: diff --git a/doc/forceModel_KochHillDrag.html b/doc/forceModel_KochHillDrag.html index 58d1c26..bebc637 100644 --- a/doc/forceModel_KochHillDrag.html +++ b/doc/forceModel_KochHillDrag.html @@ -21,17 +21,50 @@ KochHillDragProps { velFieldName "U"; voidfractionFieldName "voidfraction"; - interpolation "bool1"; - implForceDEM "bool2"; + granVelFieldName "Us" + interpolation "switch1"; + voidfractionInterpolationType "type1" + UInterpolationType "type2" + implForceDEM "switch2"; + suppressProbe "switch3"; + scale "scalar1"; + scaleDrag "scalar2"; + treatForceExplicit "switch4"; + verbose "switch5"; + implForceDEMaccumulated "switch6"; + scalarViscosity "switch7"; + nu "scalar3"; };

  • U = name of the finite volume fluid velocity field
  • voidfraction = name of the finite volume voidfraction field -
  • bool1 = (optional, normally off) flag to use interpolated voidfraction and fluid velocity values +
  • Us = (optional) name of finite volume granular velocity field + +
  • switch1 = (optional, normally off) flag to use interpolated voidfraction and fluid velocity values + +
  • type1 = (optional, default cellPoint) interpolation type for voidfraction field + +
  • type2 = (optional, default cellPointFace) interpolation type for velocity field + +
  • switch2 = (optional, normally off) flag to use implicit formulation of drag on DEM side:l +switch3 = (optional, default false) can be used to suppress the output of the probe model + +
  • scalar1 = (optional) scaling of particle diameter + +
  • scalar2 = (optional) scaling of drag law + +
  • switch4 = (optional, default false) sub model switch, see forceSubModel for details + +
  • switch5 = (optional, default false) sub model switch, see forceSubModel for details + +
  • switch6 = (optional, default false) sub model switch, see forceSubModel for details + +
  • switch7 = (optional, default false) sub model switch, see forceSubModel for details + +
  • scalar3 = optional, only if switch7 is true -bool2 = (optional, normally off) flag to use implicit formulation of drag on DEM side:l

Examples: diff --git a/doc/forceModel_LaEuScalarTemp.html b/doc/forceModel_LaEuScalarTemp.html index 778d3e3..7d765b9 100644 --- a/doc/forceModel_LaEuScalarTemp.html +++ b/doc/forceModel_LaEuScalarTemp.html @@ -24,10 +24,17 @@ LaEuScalarTempProps voidfractionFieldName "voidfraction"; partTempName "Temp"; partHeatFluxName "convectiveHeatFlux"; - lambda value; - Cp value1; - interpolation "switch1"; - verbose "switch2"; + partHeatTransCoeffName "heatTransCoeff"; + partHeatFluidName "heatFluid"; + lambda scalar1; + Cp scalar2; + interpolation switch1; + TInterpolationType "type1" + verbose switch2; + maxSource scalar3; + scale scalar4; + scalarViscosity switch3; + nu scalar5; };

  • U = name of the finite volume fluid velocity field @@ -40,13 +47,26 @@ LaEuScalarTempProps
  • convectiveHeatFlux = name of the DEM data representing the particle-fluid convective heat flux -
  • value = fluid thermal conductivity [W/(m*K)] +
  • heatTransCoeff = name of heat transfer coefficient -
  • value1 = fluid specific heat capacity [W*s/(kg*K)] +
  • heatFluid = +scalar1 = fluid thermal conductivity [W/(m*K)] + +
  • scalar2 = fluid specific heat capacity [W*s/(kg*K)]
  • switch1 = (optional, normally off) flag to use interpolated voidfraction and fluid velocity values -
  • switch2 = (normally off) for verbose run +
  • type1 = (optional, default cellPoint) interpolation type for T field + +
  • switch2 = (optional, default false) sub model switch, see forceSubModel for details + +
  • scalar3 = (optional) limit maximal turbulence + +
  • scalar4 = scaling of particle diameter + +
  • switch3 = (optional, default false) sub model switch, see forceSubModel for details + +
  • scalar5 = optional, only if switch3 is true
diff --git a/doc/forceModel_MeiLift.html b/doc/forceModel_MeiLift.html index e21aa8b..b41fbf3 100644 --- a/doc/forceModel_MeiLift.html +++ b/doc/forceModel_MeiLift.html @@ -21,8 +21,13 @@ MeiLiftProps { velFieldName "U"; useSecondOrderTerms; - interpolation "switch1"; - verbose "switch2"; + interpolation switch1; + vorticityInterpolationType "type1" + UInterpolationType "type2" + verbose switch2; + treatForceExplicit switch3; + scalarViscosity switch4; + nu scalar1; };
  • U = name of the finite volume fluid velocity field @@ -31,8 +36,18 @@ MeiLiftProps
  • switch1 = switch to activate tri-linear interpolation of the flow quantities at the particle position +
  • type1 = (optional, default cellPoint) interpolation type for vorticity field + +
  • type2 = (optional, default cellPointFace) interpolation type for velocity field +
  • switch2 = switch to activate the report of per-particle quantities to the screen +
  • switch3 = (optional, default true) sub model switch, see forceSubModel for details + +
  • switch4 = (optional, default false) sub model switch, see forceSubModel for details + +
  • scalar1 = optional, only if switch4 is true +

Examples: diff --git a/doc/forceModel_SchillerNaumannDrag.html b/doc/forceModel_SchillerNaumannDrag.html index 7ff1eca..8a06f39 100644 --- a/doc/forceModel_SchillerNaumannDrag.html +++ b/doc/forceModel_SchillerNaumannDrag.html @@ -20,10 +20,24 @@ SchillerNaumannDragProps { velFieldName "U"; + voidfractionFieldName "voidfraction"; + interpolation "bool1"; + voidfractionInterpolationType "type1" + UInterpolationType "type2" + implForceDEM "bool2"; };

  • U = name of the finite volume fluid velocity field +
  • voidfraction = name of the finite volume voidfraction field + +
  • bool1 = (optional, normally off) flag to use interpolated voidfraction and fluid velocity values + +
  • type1 = (optional, default cellPoint) interpolation type for voidfraction field + +
  • type2 = (optional, default cellPointFace) interpolation type for velocity field + +bool2 = (optional, normally off) flag to use implicit formulation of drag on DEM side:l

Examples: diff --git a/doc/forceModel_ShirgaonkarIB.html b/doc/forceModel_ShirgaonkarIB.html index 27e0ddc..52c6c43 100644 --- a/doc/forceModel_ShirgaonkarIB.html +++ b/doc/forceModel_ShirgaonkarIB.html @@ -20,12 +20,24 @@ ShirgaonkarIBProps { velFieldName "U"; - pressureFieldName "pressure"; + pressureFieldName "p"; + twoDimensional; + depth scalar1; + verbose switch1; + treatForceExplicit switch2; };

  • U = name of the finite volume fluid velocity field -
  • pressure = name of the finite volume pressure field +
  • p = name of the finite volume pressure field + +
  • twoDimensional = optional keyword for conducting a two dimensional calculation + +
  • scalar1 = optional, only necessary if twoDimensional is active + +
  • switch1 = (optional, default false) sub model switch, see forceSubModel for details + +
  • switch2 = (optional, default false) sub model switch, see forceSubModel for details
diff --git a/doc/forceModel_fieldTimeAverage.html b/doc/forceModel_fieldTimeAverage.html index 18483d7..ac6453e 100644 --- a/doc/forceModel_fieldTimeAverage.html +++ b/doc/forceModel_fieldTimeAverage.html @@ -30,7 +30,7 @@ fieldTimeAverageProps ); }; -
  • time = time to start temporal averaging +
    • time = (optional) time to start temporal averaging
    • scalarField = names of the finite volume scalar fields to be temporally averaged diff --git a/doc/forceModel_gradPForce.html b/doc/forceModel_gradPForce.html index 661b4a0..1f9728f 100644 --- a/doc/forceModel_gradPForce.html +++ b/doc/forceModel_gradPForce.html @@ -21,7 +21,12 @@ gradPForceProps { pFieldName "pressure"; velocityFieldName "U"; - interpolation switch1; + interpolation switch1; + gradPInterpolationType "type1" + useAddedMass scalar1; + suppressProbe switch2; + treatForceExplicit switch3; + treatForceDEM switch4; };
      • pressure = name of the finite volume fluid pressure field @@ -30,6 +35,16 @@ gradPForceProps
      • switch1 = flag to use interpolated pressure values (normally off) +
      • type1 = (optional, default cellPointFace) interpolation type for grad(p) field + +
      • useAddedMass = (optional) coefficient of added mass accounted for + +
      • switch2 = (optional, default false) can be used to suppress the output of the probe model + +
      • switch3 = (optional, default true) sub model switch, see forceSubModel for details + +
      • switch4 = (optional, default false) sub model switch, see forceSubModel for details +

      Examples: diff --git a/doc/forceModel_noDrag.html b/doc/forceModel_noDrag.html index 9baaa53..db8df51 100644 --- a/doc/forceModel_noDrag.html +++ b/doc/forceModel_noDrag.html @@ -18,6 +18,22 @@ noDrag ); +

      noDragProps +{ + noDEMForce; + keepCFDForce; + treatForceExplicit switch1; +} +

      +
      • noDragProps are optional. +noDEMForce = optional + +
      • keepCFDForce = optional + +
      • switch1 = (optional, default false) sub model switch, see forceSubModel for details + + +

      Examples: 

      forceModels
@@ -27,12 +43,13 @@
 
      noDragProps (optional)
 {
-    noDEMForce; (optional)
+    noDEMForce; (optional, default false) do not apply the previously calculated forces in DEM integration
+    keepCFDForce; (optional, default false) do not delete the previously calculated forces and use them in CFD source terms
 };

      Description:

      -

      The force model performs the calculation of forces (e.g. fluid-particle interaction forces) acting on each DEM particle. The noDrag model sets the forces acting on the particle to zero. If several force models are selected and noDrag is the last model being executed, the fluid particle force will be set to zero. If the variable noDEMForce is set, then the forces communicated to the DEM solver are also set to zero. +

      The force model performs the calculation of forces (e.g. fluid-particle interaction forces) acting on each DEM particle. The noDrag model sets the forces acting on the particle (which were previously caclulated) to zero. If several force models are selected and noDrag is the last model being executed, the fluid particle force will be set to zero. If the variable noDEMForce is set, then the forces communicated to the DEM solver are also set to zero.

      Restrictions:

      diff --git a/doc/forceModel_particleVolume.html b/doc/forceModel_particleVolume.html index 211c621..a9e36a3 100644 --- a/doc/forceModel_particleVolume.html +++ b/doc/forceModel_particleVolume.html @@ -21,17 +21,17 @@ particleVolumeProps { verbose switch1; writeToFile switch2; - scale number1; - startTime number2; + scale scalar1; + startTime scalar2; }; -
      • switch1 = (optional, default true) switch for output to screen +
        • switch1 = (optional, default false) switch for output to screen
        • switch2 = (optional, default true) switch for output to file -
        • number1 = (optional, default 1) scaling of the particle volume d=dSphere/scale +
        • scalar1 = (optional, default 1) scaling of the particle volume d=dSphere/scale -
        • number2 = (optional, default 0) start time of volume calculation and output +
        • scalar2 = (optional, default 0) start time of volume calculation and output
        diff --git a/doc/forceModel_scalarGeneralExchange.html b/doc/forceModel_scalarGeneralExchange.html index f210e30..408ce00 100644 --- a/doc/forceModel_scalarGeneralExchange.html +++ b/doc/forceModel_scalarGeneralExchange.html @@ -20,6 +20,8 @@ scalarGeneralExchangeProps { useLiMason "switch1"; //default: DeenEtAl + useGeneralCorrelation "switch3"; //default: DeenEtAl + generalCorrelationParameters (1 2 3 4 5 6 7 8); verbose "switch2"; velFieldName "U"; voidfractionFieldName "voidfraction"; @@ -53,12 +55,25 @@ scalarGeneralExchangeProps ( value2 ); + interpolation "bool1"; + voidfractionInterpolationType "type1" + UInterpolationType "type2" + fluidScalarFieldInterpolationType "type2" + scalarViscosity switch5; + nu scalar5; + suppressProbe switch6; + scale scalar6; + maxSource scalar7; }
        • switch1 = (optional) flag to use Nusselt correlations of Li and Mason (2000)
        • switch2 = (normally off) for verbose run +
        • switch3 = (optional) flag to use a general Nusselt number correlation (must specify parameters of this correlation in a list called 'generalCorrelationParameters' ) + +
        • generalCorrelationParameters = list with a predefined number of parameters (for length see src code, only read if useGeneralCorrelation is set to true) +
        • U = name of the finite volume fluid velocity field
        • voidfraction = name of the finite volume voidfraction field @@ -87,6 +102,24 @@ scalarGeneralExchangeProps
        • value2 = molecular diffusion coefficient [m^2/s] +
        • bool1 = (optional, normally off) flag to use interpolated voidfraction and fluid velocity values + +
        • type1 = (optional, default cellPoint) interpolation type for voidfraction field + +
        • type2 = (optional, default cellPointFace) interpolation type for velocity field + +
        • type3 = (optional, default cellPoint) interpolation type for fluidScalarField field + +
        • switch5 = (optional, default false) sub model switch, see forceSubModel for details + +
        • scalar5 = (optional) optional, only if switch5 is true + +
        • switch6 = (optional, default false) can be used to suppress the output of the probe model + +
        • scalar7 = (optional) scaling of particle diameter + +
        • scalar7 = limit maximal turbulence +

        Examples: @@ -98,6 +131,13 @@ scalarGeneralExchangeProps scalarGeneralExchangeProps { useLiMason false; //default: DeenEtAl + useGeneralCorrelation true; //default: DeenEtAl + generalCorrelationParameters + ( + 7.0 -10 5 + 1.0 0.17 + 1.33 -2.31 1.16 + ); verbose false; velFieldName "U"; voidfractionFieldName "voidfraction"; @@ -149,6 +189,9 @@ fluid-particle mass, momentum and heat transfer in dense gas-solid flows. Chemical Engineering Science 116 (2014) 710-724. This correlation is based on that of Gunn (1978).

        +

        The switch 'useGeneralCorrelation' allows one to specify the parameters +of the Gunn correlation as a list called 'generalCorrelationParameters'. +

        Alternatively, the correclation of Li and Mason (2000), A computational investigation of transient heat transfer in pneumatic transport of granular particles, Pow.Tech 112 diff --git a/doc/forceModel_virtualMassForce.html b/doc/forceModel_virtualMassForce.html index 8c7499f..01a9957 100644 --- a/doc/forceModel_virtualMassForce.html +++ b/doc/forceModel_virtualMassForce.html @@ -20,10 +20,34 @@ virtualMassForceProps { velFieldName "U"; + phiFieldName "phi"; + splitUrelCalculation switch1; + Cadd scalar1; + treatForceExplicit switch2; + treatForceDEM switch3; + interpolation switch4; + UInterpolationType "type1" + DDtUInterpolationType "type2" };

        • U = name of the finite volume fluid velocity field +
        • phi = name of the finite volume flux field + +
        • switch1 = indicator to split calculation of Urel between CFDEM and LIGGGHTS + +
        • scalar1 = scalar value + +
        • switch2 = (optional, default true) sub model switch, see forceSubModel for details + +
        • switch3 = (optional, default false) sub model switch, see forceSubModel for details + +
        • switch4 = (optional, default false) sub model switch, see forceSubModel for details + +
        • type1 = (optional, default cellPointFace) interpolation type for U field + +
        • type2 = (optional, default cellPointFace) interpolation type for ddt(U) field +

        Examples: diff --git a/doc/forceModel_viscForce.html b/doc/forceModel_viscForce.html index cb233bf..e9b8073 100644 --- a/doc/forceModel_viscForce.html +++ b/doc/forceModel_viscForce.html @@ -20,12 +20,33 @@ viscForceProps { velocityFieldName "U"; - interpolation "switch"; + useAddedMass scalar1; + suppressProbe switch1; + treatForceExplicit switch2; + treatForceDEM switch3; + interpolation switch4; + divTauInterpolationType "type1"; + scalarViscosity switch5; + nu scalar2; };

        • U = name of the finite volume fluid velocity field -
        • switch = flag to use interpolated stress values (normally off) +
        • scalar1 = (optional) coefficient of added mass accounted for + +
        • switch1 = (optional, default false) can be used to suppress the output of the probe model + +
        • switch2 = (optional, default true) sub model switch, see forceSubModel for details + +
        • switch3 = (optional, default false) sub model switch, see forceSubModel for details + +
        • switch4 = (optional, default false) sub model switch, see forceSubModel for details + +
        • type1 = (optional, default cellPointFace) interpolation type for div(Tau) field + +
        • switch5 = (optional, default false) sub model switch, see forceSubModel for details + +
        • scalar2 = optional, only if switch5 is true
        diff --git a/doc/forceModel_volWeightedAverage.html b/doc/forceModel_volWeightedAverage.html index a2d1fed..af38c37 100644 --- a/doc/forceModel_volWeightedAverage.html +++ b/doc/forceModel_volWeightedAverage.html @@ -28,19 +28,31 @@ volWeightedAverageProps ( vectorField ); - upperThreshold value; - lowerThreshold value2; + upperThreshold scalar1; + lowerThreshold scalar2; + useVolumeFraction switch0; + volumeFractionName word1; + verbose ; + writeToFile switch1; }; -
        • time = time to start the averaging (default 0) +
          • time = (optional, default 0.) time to start the averaging
          • scalarField = names of the finite volume scalar fields to be temporally averaged
          • vectorField = names of the finite volume vector fields to be temporally averaged -
          • value = only cells with a field value (magnitude) lower than this upper threshold are considered +
          • scalar1 = only cells with a field value (magnitude) lower than this upper threshold are considered -
          • value2 = only cells with a field value (magnitude) greater than this lower threshold are considered +
          • scalar2 = only cells with a field value (magnitude) greater than this lower threshold are considered + +
          • switch0 = (optional, default false) consider a volume fraction for the calculation + +
          • word1 = (optional, default "voidfraction") name of the volume fraction, only used if useVolumeFraction is true + +
          • verbose = (optional, default false) keyword only (mostly used for debugging) + +
          • switch1 = (optional, default false) switch for the output.
          diff --git a/doc/forceSubModel.html b/doc/forceSubModel.html index 090c1c9..6919095 100644 --- a/doc/forceSubModel.html +++ b/doc/forceSubModel.html @@ -46,4 +46,25 @@

          Default: none.

          +

          Swtiches: +

          +
          • Depending on the availability within the respective force model, a number of switches can be activated: +
          • treatForceExplicit: switch for the purely explicit consideration of the force term in the equation of motion on the CFD side (if switched off, the force is considered semi-implicitly) +
          +
          • treatForceDEM: switch for the consideration of the forces on the DEM side only +
          +
          • implForceDEM: If true, the fluid velocity and drag coefficient are communicated to the DEM calculation at each coupling time step and the drag force is calculated at each DEM time step, using the current particle velocity. If false, a force term is communiated to the DEM calculation at each coupling time step, the term is not within a coupling interval. +
          +
          • verbose: switch for debug output to screen +
          +
          • interpolation: switch for the usage of interpolation models when getting data for the Lagrangian calculation from Eulerian fields; If false, the cell centre values are used. +
          +
          • useFilteredDragModel: switch for using a coarse-grid version of the Beetstra drag model (takes grid-size effects into account; default = off) +
          +
          • useParcelSizeDependentFilteredDrag: switch for using a coarse-grid version of the Beetstra drag model (takes parcel-size effects into account, will force the switch useFilteredDragModel to "on"; default = off) +
          +
          • implForceDEMaccumulated: Can only be used in combination with implForceDEM switch, drag force values of each DEM time step are accumulated and passed on to the CFD-calculation. +
          +
          • scalarViscosity: switch for the usage of a user-defined viscosity nu for the calculation of the drag force; The CFD calculation always uses the value of the transport model. +
          diff --git a/doc/githubAccess_public.html b/doc/githubAccess_public.html index f507f49..8830fc4 100644 --- a/doc/githubAccess_public.html +++ b/doc/githubAccess_public.html @@ -9,6 +9,16 @@ + + + + + + + + + +

          githubAccess_public @@ -17,14 +27,16 @@

          Description:

          -

          This routine describes how to set up a github account and pull repositories of the CFDEM(R)project. -After setting some environment variables LIGGGHTS(R) and CFDEM(R)coupling can be compiled +

          This routine describes how to pull repositories of the CFDEM(R)project from github.com. +After setting some environment variables, LIGGGHTS(R) and CFDEM(R)coupling can be compiled.

          Procedure:

          Basically the following steps have to be performed:

          -
          • git clone the desired repository +
            • git clone and setup OpenFOAM + +
            • git clone the desired repositories
            • update your repositories by git pull @@ -36,35 +48,85 @@ After setting some environment variables LIGGGHTS(R) and CFDEM(R)coupling can be
            -

            git clone the desired repository: +

            git clone and setup OpenFOAM: +

            +

            Have a look at the latest compatible OpenFOAM(R)-version in the versionInfo.H file at github. +This file will later be downloaded as a part of the source-code. +Look for the git commit hashtag in the following line: +

            +
            word OFversion="<OF-Release>-commit-<commitHashtag>";  
+
            +
            e.g. word OFversion="2.4.x-commit-3d8da0e960c717ff582f1517a27724144f086b83"; 
+
            +

            However sometimes even newer versions are supported, please check the release notes and the "Advanced Settings"-section. +

            +

            Basically follow the OpenFOAM(R) git compilation instructions, with a small number of exceptions: +

            +

            When you git clone the repository, replace the release-version with <OF-Release>. +

            +

            with git-protocol: +

            +
            git clone git://github.com/OpenFOAM/OpenFOAM-<OF-Release>.git 
+
            +

            or with https: +

            +
            git clone https://github.com/OpenFOAM/OpenFOAM-<OF-Release>.git 
+
            +

            Now change into the new directory and checkout the correct compatible version: +

            +
            cd OpenFOAM-<OF-Release>
+git checkout <commitHashtag> 
+
            +

            The result will be a status report, that indicates a 'detached head state'. +Now continue with installing and compiling OpenFOAM(R). +Make sure that OpenFOAM(R) works properly with a parallel Simulation! +

            +

            If you want to use an older OpenFOAM(R)-version, please have a look at the "Backwards Compatibility"-section. +

            +

            git clone the desired repositories: +

            +

            You may want to take a look around on CFDEMproject on github: github.com/CFDEMproject_gitCFDEM

            If not already done, open a terminal and create a directory for LIGGGHTS(R) in $HOME:

            -
            cd 
-
            -
            mkdir LIGGGHTS 
-
            -
            cd LIGGGHTS 
+
            cd
+mkdir LIGGGHTS
+cd LIGGGHTS 
 
            
 
            To clone the public LIGGGHTS repository, open a terminal and execute:
+with git-protocol:
 
            
-
            git clone git://github.com/CFDEMproject/LIGGGHTS-PUBLIC.git LIGGGHTS-PUBLIC  
-
            
+
            git clone git://github.com/CFDEMproject/LIGGGHTS-PUBLIC.git LIGGGHTS-PUBLIC  
+
            
+
            or with https:
+
            
+
            git clone https://github.com/CFDEMproject/LIGGGHTS-PUBLIC.git LIGGGHTS-PUBLIC    
+
            
 
            If not already done, open a terminal and create a directory for CFDEM(R)coupling in $HOME:
 
            
-
            cd 
+
            cd
+mkdir CFDEM
+cd CFDEM 
 
            
-
            mkdir CFDEM 
-
            
-
            cd CFDEM 
-
            
-
            Make sure that OpenFOAM(R) is already set up correctly!
-
            
 
            To clone the public CFDEM(R)coupling repository, open a terminal and execute:
+with git-protocol:
 
            
-
            git clone git://github.com/CFDEMproject/CFDEMcoupling-PUBLIC.git CFDEMcoupling-PUBLIC-$WM_PROJECT_VERSION 
-
            
-
            Troubles? See Troubleshooting section below.
+
            git clone git://github.com/CFDEMproject/CFDEMcoupling-PUBLIC.git CFDEMcoupling-PUBLIC-$WM_PROJECT_VERSION 
+
            
+
            or with https:
+
            
+
            git clone https://github.com/CFDEMcoupling-PUBLIC.git CFDEMcoupling-PUBLIC-$WM_PROJECT_VERSION   
+
            
+
            Additionally the lpp tool for converting LIGGGHTS dump-files into the paraview readable VTK-format might be of use:
+with git-protocol:
+git clone git://github.com:CFDEMproject/LPP.git $HOME/LIGGGHTS/mylpp 
+
            
+
            or with https:
+git clone https://github.com:CFDEMproject/LPP.git $HOME/LIGGGHTS/mylpp 
+
            
+
            Please have a look at README and INSTALL.txt in the root directory of LPP for further information.
+
            
+
            Troubles? See Troubleshooting git section below.
 
            
 
            Update your repositories by git pull:
 
            
@@ -81,7 +143,7 @@ git pull
 
            
 
            gedit ~/.bashrc & 
 
            
-
            add the lines (you find them also in .../cfdemParticle/etc/bashrc and cshrc respectively):
+
            add the lines (you find them also in CFDEMCoupling-$WM_PROJECT_VERSION/src/lagrangian/cfdemParticle/etc/bashrc and cshrc respectively):
 
            
 
            #================================================#
 #- source cfdem env vars
@@ -95,12 +157,15 @@ 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/lagrangian/cfdemParticle/etc/bashrc
 export CFDEM_LIGGGHTS_SRC_DIR=$HOME/LIGGGHTS/LIGGGHTS-PUBLIC/src
-export CFDEM_LIGGGHTS_MAKEFILE_NAME=ubuntuVTK_fpic
+export CFDEM_LIGGGHTS_MAKEFILE_NAME=fedora_fpic
 export CFDEM_LPP_DIR=$HOME/LIGGGHTS/mylpp/src
 export CFDEM_PIZZA_DIR=$HOME/LIGGGHTS/PIZZA/gran_pizza_17Aug10/src
 . $CFDEM_bashrc
 #================================================# 
 
            
+
            If you installed LIGGGHTS(R) or CFDEM(R)coupling in non-standard paths, please have a look at least at CFDEM_PROJECT_DIR and CFDEM_LIGGGHTS_SRC_DIR.
+The standard CFDEM_LIGGGHTS_MAKEFILE_NAME is fedora_fpic, which works on most systems. However please checkout LIGGGHTS-PUBLIC/src/MAKE for additional makefiles, wich are available. The most used ones are fedora_fpic and ubuntuVTK_fpic. Beware that the CFDEMcoupling needs a fpic compilation to use LIGGGHTS as a library. Please check the "Advanced Settings" for VTK information.
+
            
 
            Save the ~/.bashrc, open a new terminal and test the settings. The commands:
 
            
 
            $CFDEM_PROJECT_DIR
@@ -127,6 +192,10 @@ $CFDEM_LIGGGHTS_SRC_DIR
 
            
 
            cfdemCompCFDEM 
 
            
+
            or compile both at once with:
+
            
+
            cfdemCompCFDEMall 
+
            
 
            You can run the tutorial cases by executing .../etc/testTutorial.sh through the alias cfdemTestTUT.
 Alternatively you can run each tutorial using the Allrun.sh scripts in the tutorial directories.
 
            
@@ -147,8 +216,11 @@ Changes in $CFDEM_TUT_DIR will be lost after every git stash!
 
            
 
            cd $HOME/LIGGGHTS 
 
            
-
            git clone git://cfdem.git.sourceforge.net/gitroot/cfdem/lpp mylpp 
-
            
+
            with git-protocol:
+git clone git://github.com/CFDEMproject/LPP.git
+with https:
+git clone https://github.com/CFDEMproject/LPP.git
+
            
 
            Backwards Compatibility:
 
            
 
            Basically CFDEM(R)coupling supports one OpenFOAM(R) version therefore all settings are prepared for that. Nevertheless we try to maintain backwards compatibility as long as it works with reasonable effort.
@@ -160,16 +232,42 @@ src/lagrangian/cfdemParticle/cfdTools/versionInfo.H
 src/lagrangian/cfdemParticle/etc/OFversion/OFversion.H
 (still not all functionality might work then!)
 
            
-
            Troubleshooting:
+
            Advanced Settings:
+
            
+
            Here some advanced settings and hints for non-standard compilations are presented.
+As stated in the "Backwards Compatibility"-section, there are compiler flags for different OpenFOAM versions. Checkout src/lagrangian/cfdemParticle/etc/OFversion/OFversion.H for compatibility settings. Just comment the current "#define version2X" in the top-section and uncomment the one you want to compile it with.
+
            
+
            There are advanced compilation settings for library-paths, includes and libraries are within the additionalLibs file in src/lagrangian/cfdemParticle/etc/additionalLibs. There are predefined files for different OpenFOAM versions. To use a different version, add the following lines to your .bashrc (.cshrc) before the standard CFDEM variables:
+
            
+
            export CFDEM_ADD_LIBS_DIR=FOLDER_OF_NEW_additionalLibs_FILE/ 
+
            
+
            export CFDEM_ADD_LIBS_NAME=additionalLibs30x 
+
            
+
            This is an example to use a predefined additionalLibs file for OpenFOAM-3.0.x.
+
            
+
            To enable direct VTK-dump (dump custom/vtk) support of LIGGGHTS and CFDEMcoupling, you have to install the VTK libraries. Either 5.8 or 6 are predefined for ubuntu.
+
            
+
            sudo apt-get libvtk5.8 libvtk5-dev 
+
            
+
            Change "export CFDEM_LIGGGHTS_MAKEFILE_NAME=fedora_fpic" in your .bashrc according to your preferred LIGGGHTS makefile.
+If you have a non-standard installation location you have to adapt the LIGGGHTS makefile accordingly.
+To enable this feature in a coupled run the additionalLibs file has to be modified.
+It basically needs to include the same libraries as the LIGGGHTS-Makefile.
+E.g. for Ubuntu-14.04 with vtk-5.8:
+
            
+
            CFDEM_ADD_LIB_PATHS  = -L/usr/include/vtk-5.8 
+
            
+
            CFDEM_ADD_LIBS       = -lvtkCommon -lvtkFiltering -lvtkIO 
+
            
+
            Troubleshooting git:
 
            
 
            • Troubles with git clone? 
 
 
 
            
-
            a) The git protocol will not work if your computer is behind a firewall which blocks the relevant TCP port, you can use alternatively (write command in one line):
+
            a) The git protocol will not work if your computer is behind a firewall which blocks the relevant TCP port, you can use alternatively https instead of git (write command in one line):
 
            
-
            git clone https://user@github.com/CFDEMproject/CFDEMcoupling-PUBLIC.git 
-CFDEMcoupling-PUBLIC-$WM_PROJECT_VERSION
+
            git clone https://github.com/CFDEMproject/CFDEMcoupling-PUBLIC.git CFDEMcoupling-PUBLIC-$WM_PROJECT_VERSION
 
            
 
            b) If you face the error: "error: SSL certificate problem, verify that the CA cert is OK. Details: error:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE:certificate verify failed while accessing https://github.com/...",
 
            
diff --git a/doc/githubAccess_public.pdf b/doc/githubAccess_public.pdf
index ef5a7ff720472a11b27fb3de7a003e01f2e9faa2..ef8c36490ea87d307f3f787999bffa2b15297244 100644
GIT binary patch
delta 8502
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

diff --git a/doc/liggghtsCommandModel_readLiggghtsData.html b/doc/liggghtsCommandModel_readLiggghtsData.html
index ef030b5..bdd117c 100644
--- a/doc/liggghtsCommandModel_readLiggghtsData.html
+++ b/doc/liggghtsCommandModel_readLiggghtsData.html
@@ -20,13 +20,14 @@
 readLiggghtsDataProps0
 {
     startIndex "scalar1";
-    exactTiming "bool1";
+    verbose ;
+    exactTiming ;
     filePath 
     (
         "word"
     );
-    runFirst "bool2";
-    runEveryCouplingStep "bool3";
+    runFirst "bool1";
+    runEveryCouplingStep "bool2";
     startTime "scalar2";
     endTime "scalar3";
     timeInterval "scalar4";
@@ -34,13 +35,15 @@ readLiggghtsDataProps0
 
            
 
            • scalar1 = start index of data file to be read 
 
-
            • bool1 = true if start time should be kept even during a coupling interval 
+
            • verbose = (default off) flag for verbose run 
+
+
            • exactTiming = flag indicating that start time should be kept even during a coupling interval 
 
 
            • filePath = path to LIGGGHTS data file. Each word in a new line, numbers and symbols need special treatment (e.g. $couplingInterval will be replaced by correct coupling interval in the simulation)  
 
-
            • bool2 = true if to be run at first timestep only (prio 1) 
+
            • bool1 = true if to be run at first timestep only (prio 1) 
 
-
            • bool3 = true if to be run at every coupling step (prio 2) 
+
            • bool2 = true if to be run at every coupling step (prio 2) 
 
 
            • scalar2 = if bool2 and bool3 false then starts at scalar2 (prio 3) run 
 
diff --git a/doc/locateModel_engineSearchIB.html b/doc/locateModel_engineSearchIB.html
index 16ec8ce..6d5c6b7 100644
--- a/doc/locateModel_engineSearchIB.html
+++ b/doc/locateModel_engineSearchIB.html
@@ -22,6 +22,7 @@ engineIBProps
     }
     zSplit value1;
     xySplit value2;
+    checkPeriodicCells;
 }  
 
            
 
            • switch1 = names of the finite volume scalar fields to be temporally averaged 
@@ -30,6 +31,8 @@ engineIBProps
 
 
            • value2 = number of satellite points in each layer 
 
+
            • checkPeriodicCells = (optional, default false) flag for considering the minimal distance to all periodic images of this particle 
+
 
 
            
 
            Examples:
diff --git a/doc/momCoupleModel_explicitCouple.html b/doc/momCoupleModel_explicitCouple.html
index ac6b5ba..b1f86a0 100644
--- a/doc/momCoupleModel_explicitCouple.html
+++ b/doc/momCoupleModel_explicitCouple.html
@@ -39,7 +39,7 @@ explicitCoupleProps

            Description:

            -

            The explicitCouple-model is a momCoupleModel model providing an explicit momentum source term for the CFD solver. +

            The explicitCouple-model is a momCoupleModel model providing an explicit momentum source term for the CFD solver and additionally it superposes an additional source field which can be set via the function setSourceField.

            Restrictions:

            diff --git a/doc/probeModel_noProbe.html b/doc/probeModel_noProbe.html index 6302111..0348cad 100644 --- a/doc/probeModel_noProbe.html +++ b/doc/probeModel_noProbe.html @@ -20,6 +20,8 @@ myForceModel3 }; +

            probeModel off; +

            Examples: 

            probeModel off; 
diff --git a/doc/probeModel_particleProbe.html b/doc/probeModel_particleProbe.html
index 86cabe4..f33d7bf 100644
--- a/doc/probeModel_particleProbe.html
+++ b/doc/probeModel_particleProbe.html
@@ -13,18 +13,22 @@
 
            
 
            To be activated via couplingProperties dictionary.
 
            
-
            forceModels
+
            forceModels
 (
     myForceModel1
     myForceModel2
     myForceModel3
 );
-particleProbeProps
+
            
+
            probeModel particleProbe; 
+
            
+
            particleProbeProps
 {
     particleIDsToSample (ID1 ID2 ID3 ...);  //list of particleIDs to sample
     verboseToFile;                          //main switch
     verbose;                                //currently not used
-    printEvery  xEvery;                     //print every this many CFD time steps
+    printEvery       xEvery;                //print every this many CFD time steps
+    printOnlyAtStep  xStep;                 //print only at this CFD time step (overrides "printEvery")
     sampleAll;                              //Activate sampling for all particles
     probeDebug;                             //probes additional fields
     includePosition;                        //will include particle position in the output file
@@ -41,6 +45,8 @@ particleProbeProps
 
 
          • xEvery = integer to specify the interval for sampling (default = 1, i.e., probing occurs every CFD time step). 
 
+
          • xStep  = integer to specify the step for sampling (default = deactivated, i.e., it will print accordingly to "printEvery"). 
+
 
          • sampleAll = switch to activate sampling of all particles. Otherwise (default) only particles specified via "particleIDsToSample" in the couplingProperties dictionary will be sampled. 
 
 
          • probeDebug = switch to activate probing of debug properties of secondary importance (specific for each force model). 
diff --git a/doc/scalarTransportModel.html b/doc/scalarTransportModel.html
new file mode 100644
index 0000000..2694eec
--- /dev/null
+++ b/doc/scalarTransportModel.html
@@ -0,0 +1,89 @@
+
+
            CFDEMproject WWW Site - CFDEM Commands 
+
            
+
+
+
+
+
            
+
+
            scalarTransportModel command 
+
            
+
            Syntax:
+
            
+
            Defined in scalarTransportProperties dictionary. A variety of derived classes exist that implement different physics of the scalarTransportModel. Here, the most general one, i.e., 'generalManual' is discussed. If no scalar transport shall be used, use the model 'none'.
+
            
+
            generalManualProps
+{
+    phiFieldName phiName;
+    voidfractionFieldName voidfractionName;
+    ScT scalar1;
+    PrT scalar2;
+    cpVolumetric scalar3;
+    cpVolumetricFieldName word1;
+    rhoMixFieldName word2;
+    eulerianFields
+    (
+        C
+        T
+    ); 
+
            
+
            } 
+
            
+
            • phiName = (optional) name of the surface field for the SUPERFICIAL flux, default "phi". 
+
+
            • voidfractionName = (optional) name of the finite volume voidfraction field, default "voidfraction". 
+
+
            • scalar1 = (optional, default 0.7) turbulent Schmidt Nr, set to large value to suppress turbulent species transport 
+
+
            • scalar2 = (optional, default 0.7) turbulent Prandtl Nr, set to large value to suppress turbulent heat transport 
+
+
            • scalar3 = (optional, alternatively define word1) volumetric heat capacity as a global constant (in contrast to cpVolumetricFieldName for a field). This is the mixture density times the heat capacity J/K/(m_voidspace)^3, will only be used if cpVolumetricFieldName, or updateMixtureProperties = false 
+
+
            • word1 = (optional, alternatively define scalar3) volumetric heat capacity as a field 
+
+
            • word3 = mixture density field 
+
+
            • C = concentration field name 
+
+
            • T = temperature field name 
+
+
+
            
+
            Examples:
+
            
+
            generalManualProps
+{
+    phiFieldName "phi";
+    ScT 0.7;
+    PrT 0.7;
+    cpVolumetric 1196;
+    rhoMixFieldName "rhoMix";
+    eulerianFields
+    (
+        C
+        T
+    ); 
+
            
+
                fvOptionsC
+    {
+    }; 
+
            
+
                fvOptionsT
+    {
+    }; 
+
            
+
            } 
+
            
+
            Description:
+
            
+
            Solves the advection-dispersion transport equation for a dilute scalar quantity in the fluid phase. fvOptions can be specified to model sources, etc. in the fluid phase. Exchange models with a particle phase can be included by including appropriate forceModels in couplingProperties.
+
            
+
            Restrictions:
+The user MUST ensure the "phi" field is SUPERFICIAL (i.e., the fluid-phase velocity times voidfraction interpolatedat the cells' faces). The code cannot know or check whether this is the case, so the user of a certain solver has to ensure this. 
+
            
+
            Related commands:
+
            
+
            none.
+
            
+
diff --git a/doc/smoothingModel_constDiffSmoothing.html b/doc/smoothingModel_constDiffSmoothing.html
index cf5904a..031a7bc 100644
--- a/doc/smoothingModel_constDiffSmoothing.html
+++ b/doc/smoothingModel_constDiffSmoothing.html
@@ -20,6 +20,7 @@ constDiffSmoothingProps
     upperLimit number2;
     smoothingLength lengthScale;
     smoothingLengthReferenceField lengthScaleRefField;
+    verbose;
 } 
 
            • 
 
            • number1 = scalar fields will be bound to this lower value 
@@ -30,6 +31,8 @@ constDiffSmoothingProps
 
 
            • lengthScaleRefField = length scale over which reference fields (e.g., the average particle velocity) will be smoothed out. Should be always larger than lengthScale. If not specified, will be equal to lengthScale. 
 
+
            • verbose = (optional, default false) flag for debugging output 
+
 
 
            
 
            Examples:
diff --git a/doc/voidFractionModel_GaussVoidFraction.html b/doc/voidFractionModel_GaussVoidFraction.html
index 2ad4fd9..9e04c0d 100644
--- a/doc/voidFractionModel_GaussVoidFraction.html
+++ b/doc/voidFractionModel_GaussVoidFraction.html
@@ -55,6 +55,6 @@ GaussProps
 
            
 
            Related commands:
 
            
-
            voidfractionModel , bigParticle
+
            voidfractionModel , bigParticle
 
            
 
diff --git a/doc/voidFractionModel_IBVoidFraction.html b/doc/voidFractionModel_IBVoidFraction.html
index bdb61e7..d2376c0 100644
--- a/doc/voidFractionModel_IBVoidFraction.html
+++ b/doc/voidFractionModel_IBVoidFraction.html
@@ -19,6 +19,7 @@ IBProps
     maxCellsPerParticle number1;
     alphaMin number2;
     scaleUpVol number3;
+    checkPeriodicCells ;
 } 
 
            
 
            • number1 = maximum number of cells covered by a particle (search will fail when more than number1 cells are covered by the particle) 
@@ -27,6 +28,8 @@ IBProps
 
 
            • number3 = diameter of the particle's representation is artificially increased according to number3 * Vparticle, volume remains unaltered! 
 
+
            • checkPeriodicCells = (optional, default false) flag for considering the minimal distance to all periodic images of this particle 
+
 
 
            
 
            Examples:
@@ -51,6 +54,6 @@ IBProps
 
            
 
            Related commands:
 
            
-
            voidfractionModel
+
            voidfractionModel
 
            
 
diff --git a/doc/voidFractionModel_bigParticleVoidFraction.html b/doc/voidFractionModel_bigParticleVoidFraction.html
index ad0b0c0..58d9f75 100644
--- a/doc/voidFractionModel_bigParticleVoidFraction.html
+++ b/doc/voidFractionModel_bigParticleVoidFraction.html
@@ -57,6 +57,6 @@ bigParticleProps
 
            
 
            Related commands:
 
            
-
            voidfractionModel
+
            voidfractionModel
 
            
 
diff --git a/doc/voidFractionModel_centreVoidFraction.html b/doc/voidFractionModel_centreVoidFraction.html
index 94ccd15..dc916bb 100644
--- a/doc/voidFractionModel_centreVoidFraction.html
+++ b/doc/voidFractionModel_centreVoidFraction.html
@@ -45,6 +45,6 @@ centreProps
 
            
 
            Related commands:
 
            
-
            voidfractionModel
+
            voidfractionModel
 
            
 
diff --git a/doc/voidFractionModel_dividedVoidFraction.html b/doc/voidFractionModel_dividedVoidFraction.html
index b6cbc2f..18dff0d 100644
--- a/doc/voidFractionModel_dividedVoidFraction.html
+++ b/doc/voidFractionModel_dividedVoidFraction.html
@@ -20,6 +20,8 @@ dividedProps
     interpolation;
     weight number2;
     porosity number3;
+    verbose;
+    cfdemUseOnly;
 }
            • number1 = minimum limit for voidfraction @@ -30,6 +32,10 @@ dividedProps
            • number3 = (optional) diameter of the particle's representation is artificially increased according to number2 * Vparticle, volume remains unaltered! +
            • verbose = (optional, default false) flag for debugging output + +
            • cfdemUseOnly = optional flag, default false +

            Examples: @@ -55,6 +61,6 @@ The void fraction calculation is based on a three-step approach (reset, set and

            Related commands:

            -

            voidfractionModel +

            voidfractionModel

            diff --git a/doc/voidFractionModel_noVoidFraction.html b/doc/voidFractionModel_noVoidFraction.html index 7fa4bae..2f27f17 100644 --- a/doc/voidFractionModel_noVoidFraction.html +++ b/doc/voidFractionModel_noVoidFraction.html @@ -27,6 +27,6 @@

            Related commands:

            -

            voidfractionModel +

            voidfractionModel

            diff --git a/doc/voidFractionModel_trilinearVoidFraction.html b/doc/voidFractionModel_trilinearVoidFraction.html index 0e209af..9da9161 100644 --- a/doc/voidFractionModel_trilinearVoidFraction.html +++ b/doc/voidFractionModel_trilinearVoidFraction.html @@ -39,6 +39,6 @@ trilinearProps

            Related commands:

            -

            voidfractionModel +

            voidfractionModel

            diff --git a/src/eulerian/scalarTransportModelsCFDEM/Make/files b/src/eulerian/scalarTransportModelsCFDEM/Make/files index 397be21..f77abd3 100644 --- a/src/eulerian/scalarTransportModelsCFDEM/Make/files +++ b/src/eulerian/scalarTransportModelsCFDEM/Make/files @@ -5,7 +5,7 @@ scalarTransportModel/newScalarTransportModel.C temperatureModel/temperatureModel.C generalManual/generalManual.C noTransport/noTransport.C -/*generalPhaseChange/generalPhaseChange.C*/ +generalPhaseChange/generalPhaseChange.C /*Fields*/ eulerianScalarField/eulerianScalarField.C diff --git a/src/eulerian/scalarTransportModelsCFDEM/Make/options b/src/eulerian/scalarTransportModelsCFDEM/Make/options index 523dd1f..303cf78 100644 --- a/src/eulerian/scalarTransportModelsCFDEM/Make/options +++ b/src/eulerian/scalarTransportModelsCFDEM/Make/options @@ -1,12 +1,20 @@ +sinclude $(GENERAL_RULES)/mplib$(WM_MPLIB) +sinclude $(RULES)/mplib$(WM_MPLIB) + +GIT_VERSION := $(shell git describe --dirty --always --tags) +PFLAGS+= -DGITVERSION=\"$(GIT_VERSION)\" +PFLAGS+= -DDEBUGFLAG=\"$(DEBUG)\" +PFLAGS+= -DCFDEMWMPROJECTVERSION="$(CFDEM_WM_PROJECT_VERSION)" + include $(CFDEM_ADD_LIBS_DIR)/$(CFDEM_ADD_LIBS_NAME) EXE_INC = \ + $(PFLAGS) \ $(CFDEM_ADD_INCOMPTURBMOD_PATHS) \ -I$(LIB_SRC)/transportModels \ -I$(LIB_SRC)/transportModels/incompressible/singlePhaseTransportModel \ -I$(LIB_SRC)/finiteVolume/lnInclude \ -I$(CFDEM_SRC_DIR)/lagrangian/cfdemParticle/lnInclude \ - -I$(LIB_SRC)/fvOptions/lnInclude \ -I$(LIB_SRC)/meshTools/lnInclude \ -I$(LIB_SRC)/sampling/lnInclude \ @@ -15,7 +23,5 @@ LIB_LIBS = \ $(CFDEM_ADD_INCOMPTURBMOD_LIBS) \ -lincompressibleTransportModels \ -lfiniteVolume \ - -l$(CFDEM_LIB_NAME) \ - -lfvOptions \ -lmeshTools \ -lsampling \ diff --git a/src/eulerian/scalarTransportModelsCFDEM/eulerianScalarField/eulerianScalarField.C b/src/eulerian/scalarTransportModelsCFDEM/eulerianScalarField/eulerianScalarField.C index 301583b..5e93e3e 100644 --- a/src/eulerian/scalarTransportModelsCFDEM/eulerianScalarField/eulerianScalarField.C +++ b/src/eulerian/scalarTransportModelsCFDEM/eulerianScalarField/eulerianScalarField.C @@ -88,8 +88,10 @@ eulerianScalarField::eulerianScalarField ), 0.0*mSource_ /( m_ + dimensionedScalar("dummy", m_.dimensions(), 1e-32) ) //initi with zero ), - fieldType_("undefined"), - fvOptions_(sm.mesh()) + fieldType_("undefined") + #ifndef versionExt32 + ,fvOptions_(sm.mesh()) + #endif { @@ -108,8 +110,9 @@ eulerianScalarField::eulerianScalarField << endl; } - + #ifndef versionExt32 fvOptions_.reset(dict.subDict("fvOptions"+fieldName_)); + #endif if( (cpVolumetricFieldName_=="na"||!updateMixtureProperties_) && cpVolumetric_<=0.0) FatalError <<"You did not specify a cpVolumetricFieldName (or you do not updateMixtureProperties) and also cpVolumetric is zero (or negative)! Either provide the field name, or set cpVolumetric to a reasonable value. \n" @@ -124,8 +127,20 @@ eulerianScalarField::eulerianScalarField if(speciesID_>-1 && updateMixtureProperties_ && (rhoCarrier_<=0 || cpCarrier_<=0) ) FatalError <<"You like to update the phase properties, but density and cp of the carrier phase are not specified or zero \n" << abort(FatalError); + + //Report options for cp + if(fieldType_=="temperature") + { + if(cpVolumetric_!=0.0 && cpVolumetricFieldName_!="na") + FatalError <<"eulerianScalarField:: You have specified 'cpVolumetric' and 'cpVolumetricFieldName' in a dictionary in '/constant'. This might be confusing. Please unset one of these two inputs to avoid confusion. \n" + << abort(FatalError); - + if(cpVolumetricFieldName_=="na" || !updateMixtureProperties_) //use also if mixture properties are not updated + Info << "eulerianScalarField:: will use the following FIXED VOLUMETRIC HEAT CAPACITY: " + << cpVolumetric_ << " [J/K/m³]" << endl; + else + Info << "eulerianScalarField:: will use the a SPATIALLY-VARAIBLE VOLUMETRIC HEAT CAPACITY with name: " << cpVolumetricFieldName_ << endl; + } } @@ -218,7 +233,7 @@ void eulerianScalarField::update(surfaceScalarField phi, volScalarField voidfrac fvm::ddt(voidfraction, m_) //This is the material derivative in a modified form - fvm::Sp(fvc::ddt(voidfraction), m_) //Needed since phi is (U_face * voidfraction)! - + fvm::div(phi, m_, divScheme) + + fvm::div(phi, m_, divScheme) //This phi must be SUPERFICIAL! (i.e., U_face * voidfraction)! - fvm::Sp(fvc::div(phi), m_) == @@ -226,12 +241,15 @@ void eulerianScalarField::update(surfaceScalarField phi, volScalarField voidfrac fvm::laplacian(nuEff/Sc*voidfraction, m_, laplacianScheme) + mSource_ + fvm::Sp(mSourceKImpl_, m_) + #ifndef versionExt32 + fvOptions_(m_) - + #endif ); mEqn.relax(); + #ifndef versionExt32 fvOptions_.constrain(mEqn); + #endif mEqn.solve(); diff --git a/src/eulerian/scalarTransportModelsCFDEM/eulerianScalarField/eulerianScalarField.H b/src/eulerian/scalarTransportModelsCFDEM/eulerianScalarField/eulerianScalarField.H index dd4f03f..888647c 100644 --- a/src/eulerian/scalarTransportModelsCFDEM/eulerianScalarField/eulerianScalarField.H +++ b/src/eulerian/scalarTransportModelsCFDEM/eulerianScalarField/eulerianScalarField.H @@ -31,7 +31,9 @@ Description #include "cfdemCloud.H" #include "forceModel.H" +#ifndef versionExt32 #include "fvOptionList.H" +#endif // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * // namespace Foam @@ -76,7 +78,9 @@ protected: mutable word fieldType_; + #ifndef versionExt32 mutable fv::optionList fvOptions_; + #endif int speciesID_; diff --git a/src/eulerian/scalarTransportModelsCFDEM/generalManual/generalManual.C b/src/eulerian/scalarTransportModelsCFDEM/generalManual/generalManual.C index 1aa9766..efb86fa 100644 --- a/src/eulerian/scalarTransportModelsCFDEM/generalManual/generalManual.C +++ b/src/eulerian/scalarTransportModelsCFDEM/generalManual/generalManual.C @@ -48,6 +48,8 @@ generalManual::generalManual : scalarTransportModel(dict,sm), propsDict_(dict.subDict(typeName + "Props")), + phiFieldName_(propsDict_.lookupOrDefault("phiFieldName", "phi")), + voidfractionFieldName_(propsDict_.lookupOrDefault("voidfractionFieldName", "voidfraction")), eulerianFieldList_(propsDict_.lookup("eulerianFields")), ScT_(0.7), PrT_(0.7), @@ -56,7 +58,7 @@ generalManual::generalManual rhoMix_ ( IOobject ( - propsDict_.lookup("rhoMixFieldName"), + propsDict_.lookupOrDefault("rhoMixFieldName","rhoMixDefault"), sm.mesh().time().timeName(), sm.mesh(), IOobject::NO_READ, @@ -68,7 +70,7 @@ generalManual::generalManual cpRho_ ( IOobject ( - propsDict_.lookup("cpVolumetricFieldName"), + propsDict_.lookupOrDefault("cpVolumetricFieldName","cpRhoDefault"), sm.mesh().time().timeName(), sm.mesh(), IOobject::NO_READ, @@ -82,7 +84,7 @@ generalManual::generalManual propsDict_.readIfPresent("ScT", ScT_); propsDict_.readIfPresent("PrT", PrT_); - Info << "Using ScT = " << ScT_ << " and PrT " << PrT_ << endl; + Info << "generalManual:: Using the following turbulent dispersion coefficients: ScT = " << ScT_ << " and PrT " << PrT_ << endl; eulerianFields_ = new autoPtr[eulerianFieldList_.size()]; for (int i=0;i ("phi")); - const volScalarField& voidfraction(particleCloud_.mesh().lookupObject ("voidfraction")); + const surfaceScalarField& phi(particleCloud_.mesh().lookupObject (phiFieldName_)); + const volScalarField& voidfraction(particleCloud_.mesh().lookupObject (voidfractionFieldName_)); //============================== //Loop through all eulerian fields and update them @@ -197,6 +204,7 @@ const eulerianScalarField& generalManual::eulerianTemperatureF() } // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * // + } // End namespace Foam // ************************************************************************* // diff --git a/src/eulerian/scalarTransportModelsCFDEM/generalManual/generalManual.H b/src/eulerian/scalarTransportModelsCFDEM/generalManual/generalManual.H index 8d43a28..e69e408 100644 --- a/src/eulerian/scalarTransportModelsCFDEM/generalManual/generalManual.H +++ b/src/eulerian/scalarTransportModelsCFDEM/generalManual/generalManual.H @@ -47,6 +47,10 @@ protected: dictionary propsDict_; + word phiFieldName_; + + word voidfractionFieldName_; + const wordList eulerianFieldList_; autoPtr* eulerianFields_; @@ -60,7 +64,8 @@ protected: //Extra fields to represent a mixture in the void space bool updateMixtureProperties_; // switch to indicate whether phase properties will be updated or not volScalarField rhoMix_; //field (if needed) to hold mixture density - volScalarField cpRho_; //field (if needed) to hold volumetric cp-value + volScalarField cpRho_; //field (if needed) to hold volumetric cp-value + public: @@ -99,6 +104,8 @@ public: volScalarField& sourceField(int i); + + }; diff --git a/src/eulerian/scalarTransportModelsCFDEM/generalPhaseChange/generalPhaseChange.C b/src/eulerian/scalarTransportModelsCFDEM/generalPhaseChange/generalPhaseChange.C new file mode 100644 index 0000000..65a89e9 --- /dev/null +++ b/src/eulerian/scalarTransportModelsCFDEM/generalPhaseChange/generalPhaseChange.C @@ -0,0 +1,109 @@ +/*---------------------------------------------------------------------------*\ +License + + This 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. + + This code 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 this code. If not, see . + + Copyright (C) 2014- Stefan Radl, TU Graz, Austria + +\*---------------------------------------------------------------------------*/ + +#include "generalPhaseChange.H" +#include "addToRunTimeSelectionTable.H" + +// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * // + +namespace Foam +{ + +// * * * * * * * * * * * * * * Static Data Members * * * * * * * * * * * * * // + +defineTypeNameAndDebug(generalPhaseChange, 0); + +addToRunTimeSelectionTable +( + scalarTransportModel, + generalPhaseChange, + dictionary +); + +// * * * * * * * * * * * * * * * * Constructors * * * * * * * * * * * * * * // + +// Construct from components +generalPhaseChange::generalPhaseChange +( + const dictionary& dict, + cfdemCloud& sm +) +: + generalManual(dict,sm), + phaseChangeDict_(propsDict_.subDict("PhaseChangeParameters")), + phaseChangeModelList_(phaseChangeDict_.lookup("phaseChangeModels")) +{ + + phaseChangeModels_ = new autoPtr[phaseChangeModelList_.size()]; + for (int i=0;i (voidfractionFieldName_)); + for (int i=0;i. + + Copyright (C) 2015 -Stefan Radl, TU Graz, Austria + + Description + Derived from generalManual transport Model + Evolves an arbitrary number of scalar quantities, exchanges sources + with the granular phase, and implements phase-change physics + between the Eulerian phases + +\*---------------------------------------------------------------------------*/ + +#ifndef generalPhaseChange_H +#define generalPhaseChange_H + +#include "generalManual.H" +#include "forceModel.H" +#include "phaseChangeModel.H" +// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * // + +namespace Foam +{ + +/*---------------------------------------------------------------------------*\ + Class generalPhaseChange Declaration +\*---------------------------------------------------------------------------*/ + +class generalPhaseChange +: + public generalManual +{ + +protected: + + dictionary phaseChangeDict_; + + const wordList phaseChangeModelList_; + + autoPtr* phaseChangeModels_; + +public: + + //- Runtime type information + TypeName("generalPhaseChange"); + + + // Constructors + //- Construct from components + generalPhaseChange + ( + const dictionary& dict, + cfdemCloud& sm + ); + + // Destructor + ~generalPhaseChange(); + + //Access function + const phaseChangeModel& phaseChangeModelRef(int); //must be const to satisfy compiler! + + // Member Functions + + void createFields(); + + void update(); +}; + + +// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * // + +} // End namespace Foam + +// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * // + +#endif + +// ************************************************************************* // diff --git a/src/eulerian/scalarTransportModelsCFDEM/phaseChangeModel/phaseChangeModel.C b/src/eulerian/scalarTransportModelsCFDEM/phaseChangeModel/phaseChangeModel.C index ace5a52..918666c 100644 --- a/src/eulerian/scalarTransportModelsCFDEM/phaseChangeModel/phaseChangeModel.C +++ b/src/eulerian/scalarTransportModelsCFDEM/phaseChangeModel/phaseChangeModel.C @@ -20,6 +20,7 @@ License #include "error.H" #include "phaseChangeModel.H" +#include "IOmanip.H" // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * // @@ -79,13 +80,12 @@ phaseChangeModel::phaseChangeModel alphaImExSplit_(dict_.lookupOrDefault("alphaImExSplit", 0.5)), cpFromField_(0.0), cpToField_(0.0), - deltaHEvap_("deltaHEvap", dimLength*dimLength/dimTime/dimTime, 1), - tEvap_("tEvap", dimTime, 1) + deltaHEvap_(dict_.lookup("deltaHEvap")), + tEvap_(dict_.lookup("tEvap")), + verboseDiskIntervall_(-1), //zero or negative--> deaktivate output to disk + verboseDiskCounter_(0), + sPtr_(NULL) { - - deltaHEvap_ = dict_.lookup("deltaHEvap"); - tEvap_ = dict_.lookup("tEvap"); - if(parameterVap_.size()<5) FatalError <<"phaseChangeModel: parameterVap_.size()<5! Provide more parameters to this model. \n" << abort(FatalError); @@ -93,6 +93,14 @@ phaseChangeModel::phaseChangeModel if(alphaImExSplit_<0 || alphaImExSplit_>1) FatalError <<"alphaImExSplit must be between 0 and 1. \n" << abort(FatalError); + if(dict_.found("verboseDiskIntervall")) + verboseDiskIntervall_=readScalar(dict_.lookup("verboseDiskIntervall")); + + if (verboseDiskIntervall_>0) + { + Info << "phaseChangeModel will report to disk with intervall " << verboseDiskIntervall_ << endl; + initialzeSummation(typeName, "phaseChange.logDat"); + } } @@ -108,6 +116,7 @@ void phaseChangeModel::update(const volScalarField& voidfraction, //this { //To implement phase change model updates that directly affect "fromField", and "toField" //MUST ADD to sources (not reset sources!) + //MUST be per m³ TOTAL volume, since scalar transport solver is based on this //update the saturation field and cp quantities cpFromField_ = fromField.cpCarrier(); @@ -117,13 +126,14 @@ void phaseChangeModel::update(const volScalarField& voidfraction, //this mSaturation_.internalField()[iter] = pVapor( temp.internalField()[iter] ) / temp[iter] / Rvap_; //update the reference quantities - volScalarField tempF = 1.0 / ( + volScalarField tempF = voidfraction + / ( fromField.m() + toField.m() * fromField.rho() / toField.rho() + fromField.rho() / fromField.rhoCarrier() - ); //phi_liquid ... (global) liquid volume fraction - //divided by fromField.m() - + ); //phi_liquid ... (global) liquid volume fraction (per m³ total!) + //divided by fromField.m() + //leaving mass rate - implicit/explicit term (divided by fromFiel.m()) fromField.mSource().internalField() -= (1-alphaImExSplit_) * tempF.internalField() * fromField.m().internalField() @@ -145,6 +155,7 @@ void phaseChangeModel::update(const volScalarField& voidfraction, //this tempF *= fromField.m() / tEvap_.value(); //phi_liquid ... (global) liquid volume fraction //divided by evaporation time scale + //entering mass rate - explicit & implicit term toField.mSource().internalField() += tempF * mSaturation_.internalField(); toField.mSourceKImpl().internalField()-= tempF * toField.rhoCarrier(); @@ -156,8 +167,11 @@ void phaseChangeModel::update(const volScalarField& voidfraction, //this - toField.m().internalField() * toField.rhoCarrier() ); + if(verboseToDisk()) + computeIntegral(mSource_); } +//************************************************ void phaseChangeModel::setEnthalpySource(const eulerianScalarField& Temperature) const { //update the heat source @@ -168,6 +182,61 @@ void phaseChangeModel::setEnthalpySource(const eulerianScalarField& Temperature) } // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * // +void phaseChangeModel::initialzeSummation(word typeName, word logFileName) const +{ + if (Pstream::master()) + { + fileName file_ =logFileName; + fileName probeDir; + fileName probeSubDir = typeName; + + Info << "Integral quantity for model " << typeName << " will write to file " << file_ << endl; + + if (particleCloud_.mesh().name() != polyMesh::defaultRegion) + { + probeSubDir = probeSubDir/particleCloud_.mesh().name(); + } + probeSubDir = "postProcessing"/probeSubDir/particleCloud_.mesh().time().timeName(); + + if (Pstream::parRun()) + { + // Put in undecomposed case + // (Note: gives problems for distributed data running) + probeDir = particleCloud_.mesh().time().path()/".."/probeSubDir; + } + else + { + probeDir = particleCloud_.mesh().time().path()/probeSubDir; + } + + + // Create directory if does not exist. + mkDir(probeDir); + + sPtr_ = new OFstream(probeDir+"/"+file_); + + *sPtr_ << '#' + << "Time" << " " + << "sourceValue" << endl; + } +} + +//******************************************************************* +void phaseChangeModel::computeIntegral(volScalarField& explicitEulerSource) const +{ + scalar integralValue = gSum( explicitEulerSource.internalField() + *explicitEulerSource.mesh().V() + ); + + if (Pstream::master() ) + { + *sPtr_ << setprecision(IOstream::defaultPrecision()) ; + *sPtr_ << particleCloud_.mesh().time().value() + << " " //setw(IOstream::defaultPrecision() + 6) + << integralValue + << endl; + } +} } // End namespace Foam diff --git a/src/eulerian/scalarTransportModelsCFDEM/phaseChangeModel/phaseChangeModel.H b/src/eulerian/scalarTransportModelsCFDEM/phaseChangeModel/phaseChangeModel.H index 7022f0f..a8fa895 100644 --- a/src/eulerian/scalarTransportModelsCFDEM/phaseChangeModel/phaseChangeModel.H +++ b/src/eulerian/scalarTransportModelsCFDEM/phaseChangeModel/phaseChangeModel.H @@ -30,8 +30,12 @@ Description #include "cfdemCloud.H" #include "forceModel.H" +#ifndef versionExt32 #include "fvOptionList.H" +#endif #include "eulerianScalarField.H" +#include "generalManual.H" +#include "OFstream.H" // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * // namespace Foam @@ -73,7 +77,27 @@ protected: dimensionedScalar deltaHEvap_; //units: K; deltaHEvap = deltaH_v / cp_g dimensionedScalar tEvap_; //units: s; tEvap_ = d_d^2 / (6*Sh*D_Vapor) + //Reporting + mutable int verboseDiskIntervall_; + mutable int verboseDiskCounter_; + + mutable OFstream* sPtr_; + + + inline bool verboseToDisk() const + { + if(verboseDiskIntervall_<=0) return false; + + verboseDiskCounter_++; + if(verboseDiskCounter_>=verboseDiskIntervall_) + { + verboseDiskCounter_=0; + return true; + } + else + return false; + }; //Private/protected member functions inline double pVapor(double T) const @@ -149,6 +173,8 @@ public: void setEnthalpySource(const eulerianScalarField&) const; void bound(autoPtr*) const {}; + void initialzeSummation(word typeName, word logFileName) const; + void computeIntegral (volScalarField& explicitEulerSource) const; // Access inline volScalarField& mSource() const {return mSource_;}; //returns the source diff --git a/src/lagrangian/cfdemParticle/Make/files b/src/lagrangian/cfdemParticle/Make/files deleted file mode 100755 index 237afc7..0000000 --- a/src/lagrangian/cfdemParticle/Make/files +++ /dev/null @@ -1,124 +0,0 @@ -cfdemCloud = cfdemCloud -cfdTools = cfdTools -forceModels = subModels/forceModel -forceSubModels = subModels/forceModel/forceSubModels -IOModels = subModels/IOModel -voidFractionModels = subModels/voidFractionModel -locateModels = subModels/locateModel -meshMotionModels = subModels/meshMotionModel -momCoupleModels = subModels/momCoupleModel -regionModels = subModels/regionModel -dataExchangeModels = subModels/dataExchangeModel -averagingModels = subModels/averagingModel -clockModels = subModels/clockModel -liggghtsCommandModels = subModels/liggghtsCommandModel -smoothingModels = subModels/smoothingModel -probeModels = subModels/probeModel - -$(cfdemCloud)/cfdemCloud.C -derived/cfdemCloudIB/cfdemCloudIB.C - -$(cfdTools)/IOtools/json/json.C -$(cfdTools)/global.C -$(cfdTools)/newGlobal.C - -$(forceModels)/forceModel/forceModel.C -$(forceModels)/forceModel/newForceModel.C -$(forceModels)/noDrag/noDrag.C -$(forceModels)/checkCouplingInterval/checkCouplingInterval.C -$(forceModels)/DiFeliceDrag/DiFeliceDrag.C -$(forceModels)/fieldStore/fieldStore.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)/KochHillDrag/KochHillDrag.C -$(forceModels)/LaEuScalarTemp/LaEuScalarTemp.C -$(forceModels)/virtualMassForce/virtualMassForce.C -$(forceModels)/gradPForce/gradPForce.C -$(forceModels)/viscForce/viscForce.C -$(forceModels)/MeiLift/MeiLift.C -$(forceModels)/particleCellVolume/particleCellVolume.C -$(forceModels)/particleVolume/particleVolume.C -$(forceModels)/scalarGeneralExchange/scalarGeneralExchange.C -$(forceModels)/fieldTimeAverage/fieldTimeAverage.C -$(forceModels)/volWeightedAverage/volWeightedAverage.C - -$(forceSubModels)/forceSubModel/newForceSubModel.C -$(forceSubModels)/forceSubModel/forceSubModel.C -$(forceSubModels)/ImEx/ImEx.C - -$(probeModels)/probeModel/probeModel.C -$(probeModels)/probeModel/newProbeModel.C -$(probeModels)/noProbe/noProbe.C - -$(IOModels)/IOModel/IOModel.C -$(IOModels)/IOModel/newIOModel.C -$(IOModels)/noIO/noIO.C -$(IOModels)/basicIO/basicIO.C -$(IOModels)/trackIO/trackIO.C -$(IOModels)/sophIO/sophIO.C - -$(voidFractionModels)/voidFractionModel/voidFractionModel.C -$(voidFractionModels)/voidFractionModel/newVoidFractionModel.C -$(voidFractionModels)/centreVoidFraction/centreVoidFraction.C -$(voidFractionModels)/dividedVoidFraction/dividedVoidFraction.C -$(voidFractionModels)/bigParticleVoidFraction/bigParticleVoidFraction.C -$(voidFractionModels)/GaussVoidFraction/GaussVoidFraction.C -$(voidFractionModels)/IBVoidFraction/IBVoidFraction.C -$(voidFractionModels)/trilinearVoidFraction/trilinearVoidFraction.C -$(voidFractionModels)/noVoidFraction/noVoidFraction.C - -$(locateModels)/locateModel/locateModel.C -$(locateModels)/locateModel/newLocateModel.C -$(locateModels)/standardSearch/standardSearch.C -$(locateModels)/engineSearch/engineSearch.C -$(locateModels)/engineSearchIB/engineSearchIB.C - - -$(meshMotionModels)/meshMotionModel/meshMotionModel.C -$(meshMotionModels)/meshMotionModel/newMeshMotionModel.C -$(meshMotionModels)/noMeshMotion/noMeshMotion.C - -$(momCoupleModels)/momCoupleModel/momCoupleModel.C -$(momCoupleModels)/momCoupleModel/newMomCoupleModel.C -$(momCoupleModels)/explicitCouple/explicitCouple.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 -$(dataExchangeModels)/twoWayFiles/twoWayFiles.C -$(dataExchangeModels)/noDataExchange/noDataExchange.C -$(dataExchangeModels)/twoWayMPI/twoWayMPI.C - -$(averagingModels)/averagingModel/averagingModel.C -$(averagingModels)/averagingModel/newAveragingModel.C -$(averagingModels)/dilute/dilute.C -$(averagingModels)/dense/dense.C - -$(clockModels)/clockModel/clockModel.C -$(clockModels)/clockModel/newClockModel.C -$(clockModels)/standardClock/standardClock.C -$(clockModels)/noClock/noClock.C - -$(liggghtsCommandModels)/liggghtsCommandModel/liggghtsCommandModel.C -$(liggghtsCommandModels)/liggghtsCommandModel/newLiggghtsCommandModel.C -$(liggghtsCommandModels)/execute/execute.C -$(liggghtsCommandModels)/runLiggghts/runLiggghts.C -$(liggghtsCommandModels)/writeLiggghts/writeLiggghts.C -$(liggghtsCommandModels)/readLiggghtsData/readLiggghtsData.C - -$(smoothingModels)/smoothingModel/smoothingModel.C -$(smoothingModels)/smoothingModel/newSmoothingModel.C -$(smoothingModels)/noSmoothing/noSmoothing.C -$(smoothingModels)/constDiffSmoothing/constDiffSmoothing.C - -LIB = $(CFDEM_LIB_DIR)/lib$(CFDEM_LIB_NAME) diff --git a/src/lagrangian/cfdemParticle/Make/options b/src/lagrangian/cfdemParticle/Make/options deleted file mode 100755 index b401b05..0000000 --- a/src/lagrangian/cfdemParticle/Make/options +++ /dev/null @@ -1,33 +0,0 @@ -sinclude $(GENERAL_RULES)/mplib$(WM_MPLIB) -sinclude $(RULES)/mplib$(WM_MPLIB) - -GIT_VERSION := $(shell git describe --dirty --always --tags) -PFLAGS+= -DGITVERSION=\"$(GIT_VERSION)\" -PFLAGS+= -DDEBUGFLAG=\"$(DEBUG)\" - -include $(CFDEM_ADD_LIBS_DIR)/$(CFDEM_ADD_LIBS_NAME) - -EXE_INC = \ - $(PFLAGS) \ - $(PINC) \ - -I ./cfdemParticle \ - -I$(LIB_SRC)/finiteVolume/lnInclude \ - -I$(LIB_SRC)/transportModels \ - $(CFDEM_ADD_INCOMPTURBMOD_PATHS) \ - -I$(LIB_SRC)/meshTools/lnInclude \ - -I$(LIB_SRC)/lagrangian/basic/lnInclude \ - -I$(LIB_SRC)/OpenFOAM/containers/HashTables/labelHashSet \ - -I$(CFDEM_LIGGGHTS_SRC_DIR) \ - -I$(CFDEM_SRC_DIR)/cfdTools \ - -LIB_LIBS = \ - $(PLIBS) \ - -L$(CFDEM_LIB_DIR) \ - -lfiniteVolume \ - $(CFDEM_ADD_INCOMPTURBMOD_LIBS) \ - -lmeshTools \ - -llagrangian \ - -L$(CFDEM_LIGGGHTS_SRC_DIR) \ - -Wl,--whole-archive -l$(CFDEM_LIGGGHTS_LIB_NAME) -Wl,--no-whole-archive \ - $(CFDEM_ADD_LIB_PATHS) \ - $(CFDEM_ADD_STATICLIBS) diff --git a/src/lagrangian/cfdemParticle/cfdTools/continuityErrorPhiPU.H b/src/lagrangian/cfdemParticle/cfdTools/continuityErrorPhiPU.H index c58afcf..6052b46 100644 --- a/src/lagrangian/cfdemParticle/cfdTools/continuityErrorPhiPU.H +++ b/src/lagrangian/cfdemParticle/cfdTools/continuityErrorPhiPU.H @@ -34,7 +34,7 @@ Description \*---------------------------------------------------------------------------*/ { - volScalarField contErr( fvc::div(phiGes) + fvc::ddt(voidfraction) ); + volScalarField contErr( fvc::div(phi) + particleCloud.ddtVoidfraction() ); scalar sumLocalContErr = runTime.deltaTValue()* mag(contErr)().weightedAverage(mesh.V()).value(); diff --git a/src/lagrangian/cfdemParticle/cfdTools/continuityErrorPhiVoidfraction.H b/src/lagrangian/cfdemParticle/cfdTools/continuityErrorPhiVoidfraction.H new file mode 100644 index 0000000..ae94873 --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/continuityErrorPhiVoidfraction.H @@ -0,0 +1,51 @@ +/*---------------------------------------------------------------------------*\ + CFDEMcoupling - Open Source CFD-DEM coupling + + CFDEMcoupling is part of the CFDEMproject + www.cfdem.com + Christoph Goniva, christoph.goniva@cfdem.com + Copyright (C) 1991-2009 OpenCFD Ltd. + Copyright (C) 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, see . + +Global + continuityErrs + +Description + Calculates and prints the continuity errors. + The code is an evolution of continuityErrs.H in OpenFOAM(R) 2.1.x, + where additional functionality for CFD-DEM coupling is added. +\*---------------------------------------------------------------------------*/ + +{ + volScalarField contErr( fvc::div(phi*voidfractionf) + particleCloud.ddtVoidfraction() ); + + scalar sumLocalContErr = runTime.deltaTValue()* + mag(contErr)().weightedAverage(mesh.V()).value(); + + scalar globalContErr = runTime.deltaTValue()* + contErr.weightedAverage(mesh.V()).value(); + cumulativeContErr += globalContErr; + + Info<< "time step continuity errors : sum local = " << sumLocalContErr + << ", global = " << globalContErr + << ", cumulative = " << cumulativeContErr + << endl; +} + +// ************************************************************************* // diff --git a/src/lagrangian/cfdemParticle/cfdTools/mathExtra.H b/src/lagrangian/cfdemParticle/cfdTools/mathExtra.H index 657d494..ba96fab 100644 --- a/src/lagrangian/cfdemParticle/cfdTools/mathExtra.H +++ b/src/lagrangian/cfdemParticle/cfdTools/mathExtra.H @@ -58,9 +58,9 @@ inline void outerProduct(double *vec1, double *vec2, double **m) { int i, j; //debug output - for( i = 0; i < 3; ++i ) +// for( i = 0; i < 3; ++i ) // printf("OUTER PRODUCT: Input: vec1 element %d = %g", i, vec1[i]); - for( i = 0; i < 3; ++i ) +// for( i = 0; i < 3; ++i ) // printf("OUTER PRODUCT: Input: vec2 element %d=%g", i, vec2[i]); //calculation @@ -272,7 +272,6 @@ inline bool doubleDotTensor333Tensor33(double tensor333[3][3][3], return true; } - }; //end of namespace #endif diff --git a/src/lagrangian/cfdemParticle/cfdTools/readPISOControls_OF30.H b/src/lagrangian/cfdemParticle/cfdTools/readPISOControls_OF30.H new file mode 100644 index 0000000..c432889 --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/readPISOControls_OF30.H @@ -0,0 +1,8 @@ + +//create PISO object +pisoControl piso(mesh); + +//create lables +label nCorr = piso.nCorrPISO(); +label nNonOrthCorr = piso.nNonOrthCorr(); +bool momentumPredictor = piso.momentumPredictor(); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetAlphaInterpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetAlphaInterpolator.H new file mode 100644 index 0000000..046435d --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetAlphaInterpolator.H @@ -0,0 +1 @@ +alphaInterpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("alphaInterpolationType",word("cellPoint")),alpha_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetDDtUInterpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetDDtUInterpolator.H new file mode 100644 index 0000000..0f9c7bf --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetDDtUInterpolator.H @@ -0,0 +1 @@ +DDtUInterpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("DDtUInterpolationType",word("cellPointFace")),DDtU_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetDSauterInterpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetDSauterInterpolator.H new file mode 100644 index 0000000..9aea049 --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetDSauterInterpolator.H @@ -0,0 +1 @@ +dSauterInterpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("dSauterInterpolationType",word("cellPoint")),dSauter_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetDivTauInterpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetDivTauInterpolator.H new file mode 100644 index 0000000..aeef04c --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetDivTauInterpolator.H @@ -0,0 +1 @@ +divTauInterpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("divTauInterpolationType",word("cellPointFace")),divTau_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetFluidScalarFieldInterpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetFluidScalarFieldInterpolator.H new file mode 100644 index 0000000..9ea1c69 --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetFluidScalarFieldInterpolator.H @@ -0,0 +1 @@ +fluidScalarFieldInterpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("fluidScalarFieldInterpolationType",word("cellPoint")),fluidScalarField_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradAlphaInterpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradAlphaInterpolator.H new file mode 100644 index 0000000..e5ab179 --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradAlphaInterpolator.H @@ -0,0 +1 @@ +gradAlphaInterpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("gradAlphaInterpolationType",word("cellPointFace")),gradAlpha_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradPInterpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradPInterpolator.H new file mode 100644 index 0000000..b21bd88 --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradPInterpolator.H @@ -0,0 +1 @@ +gradPInterpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("gradPInterpolationType",word("cellPointFace")),gradP_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradPsolidInterpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradPsolidInterpolator.H new file mode 100644 index 0000000..5857d53 --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradPsolidInterpolator.H @@ -0,0 +1 @@ +gradPsolidInterpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("gradPsolidInterpolationType",word("cellPoint")),gradPsolid_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradUInterpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradUInterpolator.H new file mode 100644 index 0000000..b65d69e --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradUInterpolator.H @@ -0,0 +1 @@ +gradUInterpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("gradUInterpolationType",word("cellPointFace")),gradU_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradVoidfractionInterpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradVoidfractionInterpolator.H new file mode 100644 index 0000000..570726f --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetGradVoidfractionInterpolator.H @@ -0,0 +1 @@ +gradVoidfractionInterpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("gradVoidfractionInterpolationType",word("cellPointFace")),gradVoidfraction_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetPhiP1Interpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetPhiP1Interpolator.H new file mode 100644 index 0000000..452063f --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetPhiP1Interpolator.H @@ -0,0 +1 @@ +phiP1Interpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("phiP1InterpolationType",word("cellPoint")),phiP1_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetPhiP2Interpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetPhiP2Interpolator.H new file mode 100644 index 0000000..ba14633 --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetPhiP2Interpolator.H @@ -0,0 +1 @@ +phiP2Interpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("phiP2InterpolationType",word("cellPoint")),phiP2_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetShearRateInterpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetShearRateInterpolator.H new file mode 100644 index 0000000..544baf7 --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetShearRateInterpolator.H @@ -0,0 +1 @@ +shearRateInterpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("shearRateInterpolationType",word("cellPointFace")),shearRate_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetTInterpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetTInterpolator.H new file mode 100644 index 0000000..04addd7 --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetTInterpolator.H @@ -0,0 +1 @@ +TInterpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("TInterpolationType",word("cellPoint")),T_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetUInterpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetUInterpolator.H new file mode 100644 index 0000000..33cf320 --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetUInterpolator.H @@ -0,0 +1 @@ +UInterpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("UInterpolationType",word("cellPointFace")),U_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetUp1Interpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetUp1Interpolator.H new file mode 100644 index 0000000..048be65 --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetUp1Interpolator.H @@ -0,0 +1 @@ +Up1Interpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("Up1InterpolationType",word("cellPointFace")),Up1_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetUp2Interpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetUp2Interpolator.H new file mode 100644 index 0000000..38a0357 --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetUp2Interpolator.H @@ -0,0 +1 @@ +Up2Interpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("Up2InterpolationType",word("cellPointFace")),Up2_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetUsInterpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetUsInterpolator.H new file mode 100644 index 0000000..056fc73 --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetUsInterpolator.H @@ -0,0 +1 @@ +UsInterpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("UsInterpolationType",word("cellPointFace")),Us_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetVoidfractionInterpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetVoidfractionInterpolator.H new file mode 100644 index 0000000..58159e6 --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetVoidfractionInterpolator.H @@ -0,0 +1 @@ +voidfractionInterpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("voidfractionInterpolationType",word("cellPoint")),voidfraction_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetVorticityInterpolator.H b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetVorticityInterpolator.H new file mode 100644 index 0000000..6f8de4e --- /dev/null +++ b/src/lagrangian/cfdemParticle/cfdTools/resetInterpolators/resetVorticityInterpolator.H @@ -0,0 +1 @@ +vorticityInterpolator_.reset(interpolation::New(propsDict_.lookupOrDefault("vorticityInterpolationType",word("cellPointFace")),vorticity_).ptr()); diff --git a/src/lagrangian/cfdemParticle/cfdTools/versionInfo.H b/src/lagrangian/cfdemParticle/cfdTools/versionInfo.H index d5b5356..1e39cb6 100755 --- a/src/lagrangian/cfdemParticle/cfdTools/versionInfo.H +++ b/src/lagrangian/cfdemParticle/cfdTools/versionInfo.H @@ -33,9 +33,9 @@ Description #ifndef versionInfo_H #define versionInfo_H -word CFDEMversion="cfdem-3.0.2"; -word compatibleLIGGGHTSversion="3.3.1"; -word OFversion="2.4.x-commit-3d8da0e960c717ff582f1517a27724144f086b83"; +word CFDEMversion="cfdem-3.4.0"; +word compatibleLIGGGHTSversion="3.4.0"; +word OFversion="3.0.x-commit-ac3f6c67e02f0aac3777c27f9fb7558fc3536e37"; Info << "\nCFDEMcoupling version: " << CFDEMversion << endl; Info << ", compatible to LIGGGHTS version: " << compatibleLIGGGHTSversion << endl; diff --git a/src/lagrangian/cfdemParticle/cfdemCloud/cfdemCloud.C b/src/lagrangian/cfdemParticle/cfdemCloud/cfdemCloud.C index 62ec279..7d82bae 100644 --- a/src/lagrangian/cfdemParticle/cfdemCloud/cfdemCloud.C +++ b/src/lagrangian/cfdemParticle/cfdemCloud/cfdemCloud.C @@ -75,6 +75,7 @@ Foam::cfdemCloud::cfdemCloud ) ), solveFlow_(true), + solveScalarTransport_(true), verbose_(false), debug_(false), ignore_(false), @@ -109,6 +110,7 @@ Foam::cfdemCloud::cfdemCloud imExSplitFactor_(1.0), treatVoidCellsAsExplicitForce_(false), useDDTvoidfraction_("off"), + dragPrev_(NULL), ddtVoidfraction_ ( IOobject @@ -262,6 +264,8 @@ Foam::cfdemCloud::cfdemCloud Info << "If BC are important, please provide volScalarFields -imp/expParticleForces-" << endl; if (couplingProperties_.found("solveFlow")) solveFlow_=Switch(couplingProperties_.lookup("solveFlow")); + if (couplingProperties_.found("solveScalarTransport")) + solveScalarTransport_=Switch(couplingProperties_.lookup("solveScalarTransport")); if (couplingProperties_.found("imExSplitFactor")) imExSplitFactor_ = readScalar(couplingProperties_.lookup("imExSplitFactor")); if (couplingProperties_.found("treatVoidCellsAsExplicitForce")) @@ -351,6 +355,18 @@ Foam::cfdemCloud::~cfdemCloud() dataExchangeM().destroy(particleWeights_,1); dataExchangeM().destroy(particleVolumes_,1); dataExchangeM().destroy(particleV_,1); + + //=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*= + int iUser=0; + for( std::vector::iterator + it = particleDatFieldsUserCFDEMToExt.begin(); + it != particleDatFieldsUserCFDEMToExt.end(); + ++it) + { + Info << "cfdemCloud destroys UserCFDEM data: " << namesFieldsUserCFDEMToExt[iUser++] << endl; + dataExchangeM().destroy((*it),1); + } + //=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*= } // * * * * * * * * * * * * * * * private Member Functions * * * * * * * * * * * * * // void Foam::cfdemCloud::getDEMdata() @@ -382,7 +398,27 @@ void Foam::cfdemCloud::giveDEMdata() if(verbose_) Info << "giveDEMdata done." << endl; } +//=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*= // * * * write top level fields * * * // +void Foam::cfdemCloud::giveUSERdata() +{ + if(forceM(0).coupleForce()) + { + //Handover USER-defined data + for(std::vector::iterator it = namesFieldsUserCFDEMToExt.begin(); it != namesFieldsUserCFDEMToExt.end(); ++it) + { + int positionInRegister = std::distance(namesFieldsUserCFDEMToExt.begin(), it); + dataExchangeM().giveData(namesFieldsUserCFDEMToExt[positionInRegister],"scalar-atom", + particleDatFieldsUserCFDEMToExt[positionInRegister] + ); + Info << "giveData field with name '" << *it << "' at position: " << positionInRegister << endl; + } + } + if(verbose_) Info << "giveUSERdata done." << endl; +} + +// * * * write top level fields * * * // +//=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*= // * * * * * * * * * * * * * * * protected Member Functions * * * * * * * * * * * * * // @@ -407,6 +443,12 @@ void Foam::cfdemCloud::setForces() resetArray(expForces_,numberOfParticles(),3); resetArray(DEMForces_,numberOfParticles(),3); resetArray(Cds_,numberOfParticles(),1); + + //=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*= + //reset all USER-defined particle fields + zeroizeParticleDatFieldsUserCFDEMToExt(); + //=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*= + for (int i=0;i::iterator it; + it = std::find(namesFieldsUserCFDEMToExt.begin(), namesFieldsUserCFDEMToExt.end(), fieldToRegister); + if ( it != namesFieldsUserCFDEMToExt.end() ) + { + positionInRegister = std::distance(namesFieldsUserCFDEMToExt.begin(), it); + Info << "cfdemCloud found field '" << fieldToRegister << "' at position: " << positionInRegister << endl; + } + else + { + //if not, add to list of names + Info << "cfdemCloud COULD NOT find field '" << fieldToRegister <<"', will push to end." << endl; + namesFieldsUserCFDEMToExt.push_back(fieldToRegister); + positionInRegister = namesFieldsUserCFDEMToExt.size()-1; + } +} + +//**************************************** +bool cfdemCloud::checkAndregisterNamesFieldsUserCFDEMToExt(const wordList names, std::vector & positionInRegister) +{ + bool validFieldName=false; + forAll(names,i) { + int tempPosition=-1; //by default use -1 to indicate invalid field + if(names[i]!="none") + { + validFieldName = true; + registerNamesFieldsUserCFDEMToExt(names[i], tempPosition); + } + positionInRegister.push_back(tempPosition); + } + return validFieldName; +} + +//**************************************** +void cfdemCloud::allocateParticleDatFieldsUserCFDEMToExt() const +{ + if(particleDatFieldsUserCFDEMToExt.size()>0) + FatalError << "cfdemCloud::allocateParticleDatFieldsUserCFDEMToExt(): you are attempting to allocate fields in a container that already contains elements. This is not allowed, please clear container." << abort(FatalError); + //Go through list and allocate + for(std::vector::const_iterator it = namesFieldsUserCFDEMToExt.begin(); it != namesFieldsUserCFDEMToExt.end(); ++it) + { + Info << "allocating field with name '" << *it << "'" << endl; + particleDatFieldsUserCFDEMToExt.push_back(NULL); //Must be NULL, otherwise this might confuse external code + dataExchangeM().allocateArray(particleDatFieldsUserCFDEMToExt.back(),0.0,1); + } +} + +//**************************************** +void cfdemCloud::reAllocateParticleDatFieldsUserCFDEMToExt() const +{ + //Go through list and allocate + for(std::vector::iterator it = namesFieldsUserCFDEMToExt.begin(); it != namesFieldsUserCFDEMToExt.end(); ++it) + { + int positionInRegister = std::distance(namesFieldsUserCFDEMToExt.begin(), it); + if(verbose_) + Info << "reAllocating field with name '" << *it << "' at position: " << positionInRegister << endl; + dataExchangeM().allocateArray(particleDatFieldsUserCFDEMToExt[positionInRegister],0.0,1); + } +} + +//**************************************** +void cfdemCloud::zeroizeParticleDatFieldsUserCFDEMToExt() +{ + //Go through list and set zero + for(std::vector::iterator it = namesFieldsUserCFDEMToExt.begin(); it != namesFieldsUserCFDEMToExt.end(); ++it) + { + int positionInRegister = std::distance(namesFieldsUserCFDEMToExt.begin(), it); + if(verbose_) + Info << "Zeroizing field with name '" << *it << "' at position: " << positionInRegister << endl; + resetArray(particleDatFieldsUserCFDEMToExt[positionInRegister],numberOfParticles(),1); + } + +} + +//**************************************** +void cfdemCloud::accessParticleDatFieldsUserCFDEMToExt(word fieldToAccess, double **& fieldData) +{ + //set pointer to correct location in the memory + if(verbose_) + Info << "cfdemCloud is accessing field '" << fieldToAccess << "'" << endl; + std::vector::iterator it; + it = std::find(namesFieldsUserCFDEMToExt.begin(), namesFieldsUserCFDEMToExt.end(), fieldToAccess); + if ( it != namesFieldsUserCFDEMToExt.end() ) + { + int positionInRegister = std::distance(namesFieldsUserCFDEMToExt.begin(), it); + if(verbose_) + Info << "cfdemCloud found field '" << fieldToAccess << "' at position: " << positionInRegister << endl; + fieldData = particleDatFieldsUserCFDEMToExt[positionInRegister]; + } + else + FatalError << "field " << fieldToAccess + << " not found." + << abort(FatalError); +} +//=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*= // * * * * * * * * * * * * * * * * IOStream operators * * * * * * * * * * * // #include "cfdemCloudIO.C" diff --git a/src/lagrangian/cfdemParticle/cfdemCloud/cfdemCloud.H b/src/lagrangian/cfdemParticle/cfdemCloud/cfdemCloud.H index b430740..5df99b3 100644 --- a/src/lagrangian/cfdemParticle/cfdemCloud/cfdemCloud.H +++ b/src/lagrangian/cfdemParticle/cfdemCloud/cfdemCloud.H @@ -91,6 +91,8 @@ protected: Switch solveFlow_; + Switch solveScalarTransport_; + bool verbose_; bool debug_; @@ -127,6 +129,8 @@ protected: mutable double **particleV_; + mutable double **dragPrev_; + int numberOfParticles_; //mutable int maxCellsPerParticle_; // lives now in voidFractionModel.H @@ -290,6 +294,8 @@ public: inline bool solveFlow() const; + inline bool solveScalarTransport() const; + inline bool verbose() const; inline const IOdictionary& couplingProperties() const; @@ -347,11 +353,51 @@ public: virtual vector omega(int) const {return Foam::vector(0,0,0);}; //access to the particles' orientation information - virtual inline double ** exArray() const {return NULL;}; - virtual vector ex(int) const {return Foam::vector(0,0,0);}; - virtual inline double ** shapeArray() const {return NULL;}; + virtual inline double ** exArray() const { + FatalError << "cfdemCloud::exArray(): you are attempting to get an access to ex array for spheroids/superquadrics. This is not allowed for spheres. Recompile the code with #define anisotropicRotation in OFversion.H or enable superquadrics in LIGGGHTS (SUPERQUADRIC_ACTIVE_FLAG)" << abort(FatalError); + return NULL; + }; + virtual vector ex(int) const { + FatalError << "cfdemCloud::ex(): you are attempting to get an access to ex array for spheroids/superquadrics. This is not allowed for spheres. Recompile the code with #define anisotropicRotation in OFversion.H or enable superquadrics in LIGGGHTS (SUPERQUADRIC_ACTIVE_FLAG)" << abort(FatalError); + return Foam::vector(0,0,0); + }; + virtual inline double ** shapeArray() const { + FatalError << "cfdemCloud::shapeArray(): you are attempting to get an access to shape array for spheroids/superquadrics. This is not allowed for spheres. Recompile the code with #define anisotropicRotation in OFversion.H or enable superquadrics in LIGGGHTS (SUPERQUADRIC_ACTIVE_FLAG)" << abort(FatalError); + return NULL; + }; virtual vector shape(int) const {return Foam::vector(0,0,0);}; + // access to complex shape information + virtual inline double ** vectorArray() const {return NULL;}; + virtual scalar volume(int) const { + FatalError << "cfdemCloud::volume(): you are attempting to get an access to volume array for superquadrics. This is not allowed for spheres. Enable superquadrics in LIGGGHTS (SUPERQUADRIC_ACTIVE_FLAG)" << abort(FatalError); + return 0; + }; + virtual inline double ** areaArray() const { + FatalError << "cfdemCloud::areaArray(): you are attempting to get an access to area array for superquadrics. This is not allowed for spheres. Enable superquadrics in LIGGGHTS (SUPERQUADRIC_ACTIVE_FLAG)" << abort(FatalError); + return NULL; + }; + virtual scalar area(int) const { + FatalError << "cfdemCloud::arrea(): you are attempting to get an access to area array for superquadrics. This is not allowed for spheres. Enable superquadrics in LIGGGHTS (SUPERQUADRIC_ACTIVE_FLAG)" << abort(FatalError); + return 0; + }; + virtual inline double ** quaternionArray() const { + FatalError << "cfdemCloud::quaternionArray(): you are attempting to get an access to roundness array for superquadrics. This is not allowed for spheres. Enable superquadrics in LIGGGHTS (SUPERQUADRIC_ACTIVE_FLAG)" << abort(FatalError); + return NULL; + }; + virtual quaternion quat(int) const { + FatalError << "cfdemCloud::quat(): you are attempting to get an access to quaternion array for superquadrics. This is not allowed for spheres. Enable superquadrics in LIGGGHTS (SUPERQUADRIC_ACTIVE_FLAG)" << abort(FatalError); + return quaternion(1); + }; + virtual inline double ** roundnessArray() const { + FatalError << "cfdemCloud::roundnessArray(): you are attempting to get an access to roundness array for superquadrics. This is not allowed for spheres. Enable superquadrics in LIGGGHTS (SUPERQUADRIC_ACTIVE_FLAG)" << abort(FatalError); + return NULL; + }; + virtual vector2D roundness(int) const { + FatalError << "cfdemCloud::roundness(): you are attempting to get an access to roundness array for superquadrics. This is not allowed for spheres. Enable superquadrics in LIGGGHTS (SUPERQUADRIC_ACTIVE_FLAG)" << abort(FatalError); + return Foam::vector2D(0,0); + }; + //Optinoal Extra arrays for implicit coupling with anisotropic drag virtual inline double ** CdsExtra() const { return NULL;}; //only TWO extra components of drag coefficient virtual inline double ** CdsRotation() const { return NULL;}; //three extra components of rotational drag @@ -359,6 +405,7 @@ public: virtual inline bool implicitAnisotropicDrag() const {return false;} virtual inline bool implicitRotation() const {return false;} + double **dragPrev(); //Detector if SRF module is enable or not virtual inline bool SRFOn(){return false;} @@ -448,7 +495,23 @@ public: std::vector< std::vector >* getVprobe(); std::vector< std::vector >* getSprobe(); - + + //=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*= + // EXPERIMENAL CODE + //SHARED GLOBAL PARTICLE Arrays (public containers for data management) + //1-USER-defined particle fields for CFDEM-->ExternalCode transfer (e.g., to handle fluxes) + virtual void giveUSERdata(); //trigger hand over of USER data to ExternalCode + mutable std::vector namesFieldsUserCFDEMToExt; + mutable std::vector particleDatFieldsUserCFDEMToExt; + + void registerNamesFieldsUserCFDEMToExt(word fieldToRegister, int& positionInRegister); + bool checkAndregisterNamesFieldsUserCFDEMToExt(const wordList names, std::vector & positionInRegister); + void allocateParticleDatFieldsUserCFDEMToExt() const; + void reAllocateParticleDatFieldsUserCFDEMToExt() const; + void zeroizeParticleDatFieldsUserCFDEMToExt(); + void accessParticleDatFieldsUserCFDEMToExt(word fieldToAccess, double **& fieldData); + //=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*= + }; diff --git a/src/lagrangian/cfdemParticle/cfdemCloud/cfdemCloudI.H b/src/lagrangian/cfdemParticle/cfdemCloud/cfdemCloudI.H index 15e0bcf..4ad6b40 100644 --- a/src/lagrangian/cfdemParticle/cfdemCloud/cfdemCloudI.H +++ b/src/lagrangian/cfdemParticle/cfdemCloud/cfdemCloudI.H @@ -90,6 +90,12 @@ inline bool cfdemCloud::solveFlow() const return bool(solveFlow_); } +inline bool cfdemCloud::solveScalarTransport() const +{ + return bool(solveScalarTransport_); +} + + inline bool cfdemCloud::verbose() const { return verbose_; diff --git a/src/lagrangian/cfdemParticle/derived/cfdemCloudIB/cfdemCloudIB.C b/src/lagrangian/cfdemParticle/derived/cfdemCloudIB/cfdemCloudIB.C index 9b8a95d..731d55b 100644 --- a/src/lagrangian/cfdemParticle/derived/cfdemCloudIB/cfdemCloudIB.C +++ b/src/lagrangian/cfdemParticle/derived/cfdemCloudIB/cfdemCloudIB.C @@ -56,15 +56,10 @@ cfdemCloudIB::cfdemCloudIB : cfdemCloud(mesh), angularVelocities_(NULL), - remoteScalarInterp_(NULL), - remoteVectorInterp_(NULL), - displs_(NULL), - pRefCell_(readLabel(mesh_.solutionDict().subDict("PISO").lookup("pRefCell"))), - pRefValue_(readScalar(mesh_.solutionDict().subDict("PISO").lookup("pRefValue"))), + pRefCell_(readLabel(mesh.solutionDict().subDict("PISO").lookup("pRefCell"))), + pRefValue_(readScalar(mesh.solutionDict().subDict("PISO").lookup("pRefValue"))), haveEvolvedOnce_(false), - skipLagrangeToEulerMapping_(false), - useHFDIBM_(false), - checkPeriodicCells_(false) + skipLagrangeToEulerMapping_(false) { if(this->couplingProperties().found("skipLagrangeToEulerMapping")) @@ -72,21 +67,6 @@ cfdemCloudIB::cfdemCloudIB Info << "Will skip lagrange-to-Euler mapping..." << endl; skipLagrangeToEulerMapping_=true; } - - if(this->couplingProperties().found("useHFDIBM")) - { - Info << "Will use Hybrid Fictitious Domain / Immerse Boundary Method" << endl; - useHFDIBM_=true; - HFDIBMinterpDict_=this->couplingProperties().subDict("HFDIBMProps").subDict("interpFunctions"); - if(this->couplingProperties().subDict("HFDIBMProps").found("checkPeriodicCells")) - checkPeriodicCells_=true; - } - - //get MPI info for communication - MPI_Comm_rank(MPI_COMM_WORLD,&me); - MPI_Comm_size(MPI_COMM_WORLD,&nprocs); - - dataExchangeM().allocateArray(displs_, 0, nprocs); } @@ -94,10 +74,8 @@ cfdemCloudIB::cfdemCloudIB cfdemCloudIB::~cfdemCloudIB() { - dataExchangeM().destroy(angularVelocities_,1); - dataExchangeM().destroy(remoteScalarInterp_); - dataExchangeM().destroy(remoteVectorInterp_); - dataExchangeM().destroy(displs_); + dataExchangeM().destroy(angularVelocities_,3); + dataExchangeM().destroy(dragPrev_,3); } @@ -105,17 +83,19 @@ cfdemCloudIB::~cfdemCloudIB() void Foam::cfdemCloudIB::getDEMdata() { cfdemCloud::getDEMdata(); - Info << "=== cfdemCloudIB::getDEMdata() === particle rotation not considered in CFD" << endl; - //dataExchangeM().getData("omega","vector-atom",angularVelocities_); + dataExchangeM().getData("omega","vector-atom",angularVelocities_); } bool Foam::cfdemCloudIB::reAllocArrays() const { if(cfdemCloud::reAllocArrays()) { + Info <<"Foam::cfdemCloudIB::reAllocArrays()"< localRemoteInterpolationPoints_; - - for(int par=0; par< numberOfParticles(); par++) - { - - scalar radius = radii()[0][par]; - - for(int subCell=0;subCell ( 1 - 1e-03) - ) continue; //Take only boundary cells - - vector posC = mesh_.C()[cellI]; - - double res_ = 1.2*std::pow( mesh_.V()[cellI] , 0.3333 ); //distance between interpPoints - - - if(checkPeriodicCells_) - { - // Some cells may be located on the other side of a periodic boundary. - // In this case, the particle center has to be mirrored in order to correctly - // evaluate the interpolation points. - // - // Notice that a tolerance of 20% is used which means that the domain should be relatively - // larger ( >140% of the particle size) in order to trigger the algorithm OR the mesh should - // not be coarser that 5 cells per particle diameter. - - for(int dir=0;dir<3;dir++) - { - if( std::abs(ParPos[dir] - posC[dir]) > 1.2*radius) - { - - ParPos[dir] -= mesh().bounds().max()[dir] - mesh().bounds().min()[dir]; - if( std::abs(ParPos[dir] - posC[dir]) > 1.2*radius) - { - ParPos[dir] += 2*(mesh().bounds().max()[dir] - mesh().bounds().min()[dir]); - } - - } - - } - } - - posC = posC - ParPos; - scalar rC = mag(posC) + 1e-08; - scalar theta_ = std::acos(posC[2]/rC); - scalar phi_ = std::atan2(posC[1],posC[0] ); - - // Surface position and interpolation points are initially calculated relatively - // to the particle center - - vector posS(radius * std::sin(theta_) * std::cos(phi_), - radius * std::sin(theta_) * std::sin(phi_), - radius * std::cos(theta_) - ); - - - vector posP1((radius + res_) * std::sin(theta_) * std::cos(phi_), - (radius + res_) * std::sin(theta_) * std::sin(phi_), - (radius + res_) * std::cos(theta_) - ); - - - - - vector posP2((radius + 2*res_) * std::sin(theta_) * std::cos(phi_), - (radius + 2*res_) * std::sin(theta_) * std::sin(phi_), - (radius + 2*res_) * std::cos(theta_) - ); - - // Get absolute position in mesh - - posS = posS + ParPos; - posP1 = posP1 + ParPos; - posP2 = posP2 + ParPos; - - if(checkPeriodicCells_) - { - // If P1 or P2 are crossing the periodic boundary, they should be mirrored - - // Check P1 - for(int dir=0;dir<3;dir++) - { - if( std::abs( posP1[dir] ) > mesh().bounds().max()[dir]) - { - - posP1[dir] -= mesh().bounds().max()[dir] - mesh().bounds().min()[dir]; - } - if( std::abs(posP1[dir] ) < mesh().bounds().min()[dir]) - { - posP1[dir] += (mesh().bounds().max()[dir] - mesh().bounds().min()[dir]); - } - - } - - - // Check P2 - for(int dir=0;dir<3;dir++) - { - if( std::abs(posP2[dir] ) > mesh().bounds().max()[dir]) - { - - posP2[dir] -= mesh().bounds().max()[dir] - mesh().bounds().min()[dir]; - } - if( std::abs(posP2[dir] ) < mesh().bounds().min()[dir]) - { - posP2[dir] += (mesh().bounds().max()[dir] - mesh().bounds().min()[dir]); - } - - } - - } - - - // Now we look for the cells containing the interpolation points. - // If they are not available (i.e. cellID=-1) they are added to the - // list of points to interpolate remotely. - - label cellP1 = locateModel_->findSingleCell(posP1,cellI); - - //if cannot find, it is probably in a different processor - if(cellP1==-1) - { - localRemoteInterpolationPoints_.push_back(posP1.component(0)); - localRemoteInterpolationPoints_.push_back(posP1.component(1)); - localRemoteInterpolationPoints_.push_back(posP1.component(2)); - } - else - { - //Check if inside particle - if( voidFractionM().voidFractionNext()[cellP1] < 1- 1e-03 ) - cellP1 = -2; - - } - - label cellP2 = locateModel_->findSingleCell(posP2,cellI); - - //if cannot find, it is probably in a different processor - if(cellP2==-1) - { - localRemoteInterpolationPoints_.push_back(posP2.component(0)); - localRemoteInterpolationPoints_.push_back(posP2.component(1)); - localRemoteInterpolationPoints_.push_back(posP2.component(2)); - } - else - { - - //Check if inside particle - if( voidFractionM().voidFractionNext()[cellP2] < 1- 1e-03 ) - cellP2 = -2; - - } - - - - - // The cell ID is pushed back even when -1. - // In this way, the order in wich -1 appears in the - // interpCells_ vectors is the same in the localRemoteInterpolationPoints_ - // (i.e. they refer to the same interpolation point). - - interpP_[0][par].push_back(posP1); - interpP_[1][par].push_back(posP2); - - interpCells_[0][par].push_back(cellP1); - interpCells_[1][par].push_back(cellP2); - - surfaceCells_[par].push_back(cellI); - - - - } - } - - communicateRemoteInterpolationPoints(localRemoteInterpolationPoints_); - -} -//-------------------------------------------------// -void Foam::cfdemCloudIB::reallocateHFDIBMarrays() -{ - std::vector< label > labelTmp_; - std::vector< vector > doubleTmp_; - - //delete old vectors and reserve new space - - interpP_[0].clear(); - interpP_[0].reserve(numberOfParticles()); - - interpP_[1].clear(); - interpP_[1].reserve(numberOfParticles()); - - - interpCells_[0].clear(); - interpCells_[1].clear(); - - interpCells_[0].reserve(numberOfParticles()); - interpCells_[1].reserve(numberOfParticles()); - - - surfaceCells_.clear(); - - surfaceCells_.reserve(numberOfParticles()); - - - //Reserve space - for(int par=0; par< numberOfParticles(); par++) - { - //create vectors for particle and reserve space - - //Provide an estimation of the space to reserve, i.e NofCells^(2/3) to estimate discrete particle surface - int spaceToReserve_ = int( std::pow( ( cellsPerParticle()[par][0] ) , 0.6666 ) ); - - interpP_[0].push_back(doubleTmp_); - interpP_[0][par].reserve(spaceToReserve_); - interpP_[1].push_back(doubleTmp_); - interpP_[1][par].reserve(spaceToReserve_); - - - interpCells_[0].push_back(labelTmp_); - interpCells_[1].push_back(labelTmp_); - - interpCells_[0][par].reserve(spaceToReserve_); - interpCells_[1][par].reserve(spaceToReserve_); - - - surfaceCells_.push_back(labelTmp_); - surfaceCells_[par].reserve(spaceToReserve_); - - } - -} - -//-------------------------------------------------// -void Foam::cfdemCloudIB::communicateRemoteInterpolationPoints(std::vector localRemoteInterpolationPoints_) -{ - - if(nprocs == 1) return; - - int sizeP = localRemoteInterpolationPoints_.size(); - int nOfPoints = localRemoteInterpolationPoints_.size()/3; - - if(verbose_) - Pout << "Processor " << me << " found " << nOfPoints << " remote interpolation points" << endl; - - int numfrags[nprocs]; - - // The localRemoteInterpolationPoints_ vectors are gathered by - // every processor since (also because of periodicity) the "not found" - // interpolation points could be located in any processor. - - //Get sizeP from every processor - MPI_Allgather( &sizeP, 1, MPI_INT, numfrags, 1, MPI_INT, MPI_COMM_WORLD); - - //create displacement array - int totSize = 0; - for(int p=0;pfindSingleCell(P,cell0); - - if(cellP != -1) - { - - //Check if inside particle - if( voidFractionM().voidFractionNext()[cellP] < 1- 1e-03 ) - { - remoteFDTmp_[point_] = 1; - continue; - } - remoteInterpLegend.push_back(currentId); - remoteInterpCells.push_back(cellP); - - - - } - - - } - - dataExchangeM().allocateArray(remoteScalarInterp_, 0, totNofRemotePoints); - dataExchangeM().allocateArray(remoteVectorInterp_, 0, totSize); - - //now everyone knows if is valid or should switch to FD - MPI_Allreduce(remoteFDTmp_, &switchRemoteToFD_[0], totNofRemotePoints ,MPI_INT, MPI_SUM, MPI_COMM_WORLD); - -} -//--------------------------------------------------------------------------------------------// -void Foam::cfdemCloudIB::vectorInterpolateRemote( volVectorField& V, volVectorField& Vs) -{ - - autoPtr > interpV_ = interpolation::New(HFDIBMinterpDict_, V); - - - int totSize=remoteInterpolationPoints.size(); - - double remoteVectorInterpTmp_[totSize]; - //Set old array to zero - for( int id_=0; id_interpolate( P, cellI ) ; - - //assign to array - remoteVectorInterpTmp_[currentId ] = VP.component(0); - remoteVectorInterpTmp_[currentId + 1] = VP.component(1); - remoteVectorInterpTmp_[currentId + 2] = VP.component(2); - - } - - - // The use of MPI_Allreduce allows to keep the original order. - // Thus, the reduced vector is still synchronized with the local - // interpCells_ vector. - - MPI_Allreduce(remoteVectorInterpTmp_, remoteVectorInterp_, totSize ,MPI_DOUBLE, MPI_SUM, MPI_COMM_WORLD); - -} - -//--------------------------------------------------------------------------------------------// -void Foam::cfdemCloudIB::scalarInterpolateRemote( volScalarField& S,volScalarField& Ss) -{ - autoPtr > interpS_ = interpolation::New(HFDIBMinterpDict_, S); - int totSize=remoteInterpolationPoints.size()/3; - //Set old array to zero - double remoteScalarInterpTmp_[totSize]; - for( int id_=0; id_interpolate( P, cellI ) ; - - //assign to array - remoteScalarInterpTmp_[currentId/3] = SP; - - //Ss[cellI] = 9999999999999*2; - - } - - - // The use of MPI_Allreduce allows to keep the original order. - // Thus, the reduced vector is still synchronized with the local - // interpCells_ vector. - - MPI_Allreduce(remoteScalarInterpTmp_, remoteScalarInterp_, totSize ,MPI_DOUBLE, MPI_SUM, MPI_COMM_WORLD); - -} -//--------------------------------------------------------------------------------------------// - -void Foam::cfdemCloudIB::interpolateVectorField( volVectorField &V, //main field - volVectorField &Vs //imposed field - ) -{ - if(!useHFDIBM_) return; - - //create Interpolator - autoPtr > interpV_ = interpolation::New(HFDIBMinterpDict_, V); - - - //First of all, interpolate remote points - vectorInterpolateRemote(V, Vs); - - int remoteCount = 0; - - for(int par=0; par< numberOfParticles(); par++) - { - - - - scalar radius = radii()[0][par]; - - int surfCls_ = surfaceCells_[par].size(); - - for(int surf_=0; surf_ 1.2*radius) - { - - ParPos[dir] -= mesh().bounds().max()[dir] - mesh().bounds().min()[dir]; - if( std::abs(ParPos[dir] - posC[dir]) > 1.2*radius) - { - ParPos[dir] += 2*(mesh().bounds().max()[dir] - mesh().bounds().min()[dir]); - } - - } - - } - - } - - double rC = mag(posC - ParPos); - - vector VP1(0.0,0.0,0.0); - vector VP2(0.0,0.0,0.0); - - // If the cellID is -1, look in remoteVectorInterp_ to find the - // remotely intrpolated values. - - if(interpCells_[0][par][surf_] > -1) - { - VP1 = interpV_->interpolate( interpP_[0][par][surf_], - interpCells_[0][par][surf_] - - ) - Vs[cellI]; - } - else if(interpCells_[0][par][surf_] != -2) - { - - if(switchRemoteToFD_[displs_[me]/3 + remoteCount]==1) - { - useFD=true; - - - } - else - { - VP1.component(0) = remoteVectorInterp_[displs_[me] + remoteCount*3 ]; - VP1.component(1) = remoteVectorInterp_[displs_[me] + remoteCount*3 +1]; - VP1.component(2) = remoteVectorInterp_[displs_[me] + remoteCount*3 +2]; - - VP1 = VP1 - Vs[cellI]; - } - remoteCount++; - } - else - { - useFD=true; - } - - - if(interpCells_[1][par][surf_] > -1) - { - VP2 = interpV_->interpolate( interpP_[1][par][surf_], - interpCells_[1][par][surf_] - - ) - Vs[cellI]; - } - else if(interpCells_[1][par][surf_] != -2) - { - - if(switchRemoteToFD_[displs_[me]/3 + remoteCount]==1) - { - useFD=true; - } - else - { - VP2.component(0) = remoteVectorInterp_[displs_[me] + remoteCount*3 ]; - VP2.component(1) = remoteVectorInterp_[displs_[me] + remoteCount*3 +1]; - VP2.component(2) = remoteVectorInterp_[displs_[me] + remoteCount*3 +2]; - - VP2 = VP2 - Vs[cellI]; - - } - remoteCount++; - } - - - if(useFD) - { - //Vs[cellI] = voidFractionM().voidFractionNext()[cellI]*V[cellI] + (1- voidFractionM().voidFractionNext()[cellI])*Vs[cellI]; - continue; - } - - double res_ = 1.2*std::pow( mesh_.V()[cellI] , 0.3333 ); //distance between interpPoints - - vector quadCoeff = 1/(res_*res_) * ( VP2/2 - VP1 ); - vector linCoeff = 1/(2*res_) * ( 4*VP1 - VP2 ); - - //Correct imposed field - Vs[cellI] = quadCoeff*(rC-radius)*(rC-radius) + linCoeff * (rC-radius) + Vs[cellI] ; - - } - } -} -//------------------------------------------------------------------------------------------// -void Foam::cfdemCloudIB::interpolateScalarField( volScalarField &S, //main field - volScalarField &Ss //imposed field - ) -{ - if(!useHFDIBM_) return; - - autoPtr > interpS_ = interpolation::New(HFDIBMinterpDict_, S); - - //First of all, interpolate remote points - scalarInterpolateRemote(S, Ss); - - int remoteCount = 0; - for(int par=0; par< numberOfParticles(); par++) - { - - - scalar radius = radii()[0][par]; - - int surfCls_ = surfaceCells_[par].size(); - - for(int surf_=0; surf_ 1.2*radius) - { - - ParPos[dir] -= mesh().bounds().max()[dir] - mesh().bounds().min()[dir]; - if( std::abs(ParPos[dir] - posC[dir]) > 1.2*radius) - { - ParPos[dir] += 2*(mesh().bounds().max()[dir] - mesh().bounds().min()[dir]); - } - - } - - } - - } - - double rC = mag(posC - ParPos); - - scalar SP1=0.0; - scalar SP2=0.0; - - // If the cellID is -1, look in remoteVectorInterp_ to find the - // remotely intrpolated values. - - if(interpCells_[0][par][surf_] > -1) - { - SP1 = interpS_->interpolate( interpP_[0][par][surf_], - interpCells_[0][par][surf_] - - ) - Ss[cellI]; - } - else if(interpCells_[0][par][surf_] != -2) - { - - if(switchRemoteToFD_[displs_[me]/3 + remoteCount]==1) - { - useFD=true; - - - } - else - { - SP1 = remoteScalarInterp_[displs_[me]/3 + remoteCount] -Ss[cellI]; - } - - remoteCount++; - } - else - { - useFD=true; - } - - if(interpCells_[1][par][surf_] > -1) - { - SP2 = interpS_->interpolate( interpP_[1][par][surf_], - interpCells_[1][par][surf_] - - ) - Ss[cellI]; - } - else if(interpCells_[1][par][surf_] != -2) - { - - if(switchRemoteToFD_[displs_[me]/3 + remoteCount]==1) - { - useFD=true; - } - else - { - SP2 = remoteScalarInterp_[displs_[me]/3 + remoteCount] -Ss[cellI]; - } - remoteCount++; - } - else - { - useFD=true; - } - - - if(useFD) - { - // Ss[cellI] = voidFractionM().voidFractionNext()[cellI]*S[cellI] + (1- voidFractionM().voidFractionNext()[cellI])*Ss[cellI]; - continue; - } - - double res_ = 1.2*std::pow( mesh_.V()[cellI] , 0.3333 ); //distance between interpPoints - - scalar quadCoeff = 1/(res_*res_) * ( SP2/2 - SP1 ); - scalar linCoeff = 1/(2*res_) * ( 4*SP1 - SP2 ); - - //Correct imposed field - // Ss[interpCells_[0][par][surf_]] = -999999999; - // Ss[interpCells_[1][par][surf_]] = 999999999; - Ss[cellI] = quadCoeff*(rC-radius)*(rC-radius) + linCoeff * (rC-radius) + Ss[cellI] ; - } - } -} -//---------------------------------------------------------------------------// -void Foam::cfdemCloudIB::checkInterfaceFlowRate() -{ - - //This function should just be used to check the solver and for debugging - - //Each particle is discretized in several lagrangian points where the velocity field is interpolated - - if(!this->couplingProperties().subDict("HFDIBMProps").found("checkInterfaceFlowRate")) - return; - - int thetaDiscr_ = 180; - int phiDiscr_ = 180; - - // Loop over all the particles - // - // Interpolate at the discrete surface - // point - - double totalFlux_=0.0; - double pi_=3.14159265359; - double totSurf=0.0; - - volVectorField U = mesh_.lookupObject("U"); - - //create Interpolator - autoPtr > interpV_ = interpolation::New(HFDIBMinterpDict_, U); - - for(int par=0; par< numberOfParticles(); par++) - { - - scalar radius = radii()[0][par]; - - //Advance of two to correctly consider the angle at the poles - for(int thetaId_=0;thetaId_findSingleCell(posS,cell0); - - if(cellS==-1) continue; - - - vector US = interpV_->interpolate( posS, cellS); - - posS = (posS-ParPos)/radius; - - //flow normal to the surface - - totalFlux_ += std::abs( US&posS*surf_ ); - } - } - } - - Pout << "Total flow rate normal to the immersed surfaces : " << totalFlux_ << endl; - - Pout << "Total immersed surfaces: " << totSurf << endl; //Should be pi for one particle with dp=1 - - -} // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * // } // End namespace Foam diff --git a/src/lagrangian/cfdemParticle/derived/cfdemCloudIB/cfdemCloudIB.H b/src/lagrangian/cfdemParticle/derived/cfdemCloudIB/cfdemCloudIB.H index acf1b0f..19b70c8 100644 --- a/src/lagrangian/cfdemParticle/derived/cfdemCloudIB/cfdemCloudIB.H +++ b/src/lagrangian/cfdemParticle/derived/cfdemCloudIB/cfdemCloudIB.H @@ -42,9 +42,6 @@ SourceFiles #define cfdemCloudIB_H #include "cfdemCloud.H" -#include -#include "interpolation.H" - // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * // @@ -68,31 +65,6 @@ protected: mutable bool haveEvolvedOnce_; mutable bool skipLagrangeToEulerMapping_; - //=== - mutable bool useHFDIBM_; - mutable bool checkPeriodicCells_; - - //HFDIBM members - std::vector< std::vector< Foam::vector > > interpP_[2]; - std::vector< std::vector< label > > interpCells_[2]; - std::vector< std::vector< label > > surfaceCells_; - std::vector remoteInterpolationPoints; - double* remoteScalarInterp_; - double* remoteVectorInterp_; - std::vector remoteInterpLegend; - std::vector