From 94d3e79a8617f88dc0219cfdeedfa3147833719d Mon Sep 17 00:00:00 2001
From: Adrian Kummerlaender
Date: Mon, 24 Jun 2019 14:43:36 +0200
Subject: Initialize at openlb-1-3
---
src/core/superLattice2D.h | 357 ++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 357 insertions(+)
create mode 100644 src/core/superLattice2D.h
(limited to 'src/core/superLattice2D.h')
diff --git a/src/core/superLattice2D.h b/src/core/superLattice2D.h
new file mode 100644
index 0000000..514912e
--- /dev/null
+++ b/src/core/superLattice2D.h
@@ -0,0 +1,357 @@
+/* This file is part of the OpenLB library
+ *
+ * Copyright (C) 2007-2014 Mathias J. Krause
+ * E-mail contact: info@openlb.net
+ * The most recent release of OpenLB can be downloaded at
+ *
+ *
+ * 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 2
+ * 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, write to the Free
+ * Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA 02110-1301, USA.
+*/
+
+/** \file
+ * The description of a 2D super lattice -- header file.
+ */
+
+#ifndef SUPER_LATTICE_2D_H
+#define SUPER_LATTICE_2D_H
+
+#include
+
+#include "blockLattice2D.h"
+#include "blockLatticeView2D.h"
+#include "communication/communicator2D.h"
+#include "postProcessing.h"
+#include "serializer.h"
+#include "communication/superStructure2D.h"
+#include "utilities/functorPtr.h"
+
+/// All OpenLB code is contained in this namespace.
+namespace olb {
+
+template class Communicator2D;
+template class CuboidGeometry2D;
+template class BlockLattice2D;
+template class BlockLatticeView2D;
+template class LoadBalancer;
+template class SuperGeometry2D;
+template class SuperLatticeF2D;
+template class SuperStructure2D;
+template class SuperIndicatorF2D;
+
+
+/// A super lattice combines a number of block lattices that are ordered
+/// in a cuboid geometry.
+/** The communication between the block lattices is done by two
+ * communicators. One (_commStream) is responible to provide the data for
+ * the streaming the other (_commBC) for the non-local boundary conditions.
+ * To simplify the code structure ghost cells in an overlap of size
+ * (_overlap) is indrocuced. It depends on the non-locality of the
+ * boundary conditions but is at least one because of the streaming
+ *
+ * The algorithm is parallelized with mpi. The load balancer (_load)
+ * distributes the block lattices to processes.
+ *
+ * WARNING: For unstructured grids there is an iterpolation needed
+ * for the method buffer_outData in coboidNeighbourhood which is not
+ * yet implemented! Moreover this class needs to be chanced
+ * that the number of times steps for the collision and streaming is
+ * is dependent of the refinement level.
+ *
+ * This class is not intended to be derived from.
+ */
+template
+class SuperLattice2D : public SuperStructure2D, public BufferSerializable {
+
+private:
+ /// Lattices with ghost cell layer of size overlap
+ std::vector > _extendedBlockLattices;
+ /// View of the lattices without overlap
+ std::vector > _blockLattices;
+
+ /// Size of the refinement overlap
+ int _overlapRefinement;
+ /// This communicator handels the communication for the streaming
+ Communicator2D _commStream;
+ /// This communicator handels the communication for the postprocessors
+ Communicator2D _commBC;
+ /// Specifies if there is communication for non local boundary conditions
+ /// needed. It is automatically swichted on if overlapBC >= 1 by the
+ /// calling the constructer. (default =false)
+ bool _commBC_on;
+
+ /// Statistic of the super structure
+ LatticeStatistics *_statistics;
+ /// Specifies if there is statistic calculated. It is always
+ /// needed for the ConstRhoBGK dynamics. (default =true)
+ bool _statistics_on;
+public:
+ /// Construction of a super lattice
+ SuperLattice2D(SuperGeometry2D& superGeometry, int overlapRefinement=0);
+ SuperLattice2D(const SuperLattice2D&) = delete;
+ ~SuperLattice2D();
+ /// Read and write access to a block lattice
+ BlockLattice2D& getExtendedBlockLattice(int locIC)
+ {
+ return _extendedBlockLattices[locIC];
+ };
+ /// Read only access to a block lattice
+ BlockLattice2D const& getExtendedBlockLattice(int locIC) const
+ {
+ return _extendedBlockLattices[locIC];
+ };
+ /// Read and write access to a lattice (block lattice view, one
+ /// without overlap).
+ BlockLatticeView2D& getBlockLattice(int locIC)
+ {
+ return _blockLattices[locIC];
+ };
+ /// Read only access to a lattice
+ BlockLatticeView2D const& getBlockLattice(int locIC) const
+ {
+ return _blockLattices[locIC];
+ };
+
+ /// Read and write access to the streaming communicator
+ Communicator2D& get_commStream()
+ {
+ return _commStream;
+ };
+ /// Read only access to the streaming communicator
+ Communicator2D const& get_commStream() const
+ {
+ return _commStream;
+ };
+ /// Read and write access to the boundary communicator
+ Communicator2D& get_commBC()
+ {
+ return _commBC;
+ };
+ /// Read only access to the boundary communicator
+ Communicator2D const& get_commBC() const
+ {
+ return _commBC;
+ };
+
+ /// Return a handle to the LatticeStatistics object
+ LatticeStatistics& getStatistics();
+ /// Return a constant handle to the LatticeStatistics object
+ LatticeStatistics const& getStatistics() const;
+
+ /// Write access to lattice cells that returns false if
+ /// iX/iY is not in any of the cuboids
+ bool set(T iX, T iY, Cell const& cell);
+
+ void set(Vector pos, const Cell& cell);
+ void get(Vector pos, Cell& cell) const;
+
+ /// Read only access to lattice cells that returns false if
+ /// iX/iY is not in any of the cuboids
+ bool get(T iX, T iY, Cell& cell) const;
+ /// Read only access to lattice cells over the cuboid number
+ /// and local coordinates WARNING!!! NO ERROR HANDLING IMPLEMENTED!!!
+ Cell get(int iC, int locX, int locY) const;
+
+ /// Write access to the memory of the data of the super structure
+ bool* operator() (int iCloc, int iX, int iY, int iData) override
+ {
+ return (bool*)&getExtendedBlockLattice(iCloc).get(iX+this->_overlap, iY+this->_overlap)[iData];
+ };
+ /// Read only access to the dim of the data of the super structure
+ int getDataSize() const override
+ {
+ return DESCRIPTOR::q;
+ };
+ /// Read only access to the data type dim of the data of the super structure
+ int getDataTypeSize() const override
+ {
+ return sizeof(T);
+ };
+ /// Initialize all lattice cells to become ready for simulation
+ void initialize();
+
+ /// Defines the dynamics on a domain described by an indicator
+ void defineDynamics(FunctorPtr>&& indicator, Dynamics* dynamics);
+ /// Defines the dynamics by material number
+ void defineDynamics(SuperGeometry2D& superGeometry, int material, Dynamics* dynamics);
+
+ /// Defines rho on a rectangular domain
+ void defineRhoU (T x0, T x1, T y0, T y1, T rho, const T u[DESCRIPTOR::d] );
+ /// Defines rho and u on a domain described by an indicator
+ void defineRhoU(FunctorPtr>&& indicator,
+ AnalyticalF2D& rho, AnalyticalF2D& u);
+ /// Defines rho and u on a domain with a particular material number
+ void defineRhoU(SuperGeometry2D& sGeometry, int material,
+ AnalyticalF2D& rho, AnalyticalF2D& u);
+
+ /// Defines rho on a rectangular domain
+ void defineRho (T x0, T x1, T y0, T y1, T rho );
+ /// Defines rho on a domain described by an indicator
+ void defineRho(FunctorPtr>&& indicator, AnalyticalF2D& rho);
+ /// Defines rho on a domain with a particular material number
+ void defineRho(SuperGeometry2D& sGeometry, int material, AnalyticalF2D& rho);
+
+ /// Defines u on a rectangular domain
+ void defineU (T x0, T x1, T y0, T y1, const T u[DESCRIPTOR::d] );
+ /// Defines u on a domain described by an indicator
+ void defineU(FunctorPtr>&& indicator, AnalyticalF2D& u);
+ /// Defines u on a domain with a particular material number
+ void defineU(SuperGeometry2D& sGeometry, int material, AnalyticalF2D& u);
+
+ // Defines a population on a domain described by an indicator
+ void definePopulations(FunctorPtr>&& indicator, AnalyticalF2D& Pop);
+ // Defines a population on a domain with a particular material number
+ void definePopulations(SuperGeometry2D& sGeometry, int material, AnalyticalF2D& Pop);
+
+ /// Defines a field on a rectangular domain
+ template
+ void defineField (T x0, T x1, T y0, T y1, T* field );
+ /// Defines a field on a domain described by an indicator
+ template
+ void defineField(FunctorPtr>&& indicator,
+ SuperLatticeF2D& field);
+ /// Defines a field on a domain with a particular material number
+ template
+ void defineField(SuperGeometry2D& sGeometry, int material,
+ SuperLatticeF2D& field);
+
+ /// Defines a field on a domain described by an indicator
+ template
+ void defineField(FunctorPtr>&& indicator,
+ AnalyticalF2D& field)
+ {
+ for (int iC = 0; iC < this->_loadBalancer.size(); ++iC) {
+ _extendedBlockLattices[iC].template defineField(
+ indicator->getExtendedBlockIndicatorF(iC), field);
+ }
+ }
+
+ /// Defines a field on a domain with a particular material number
+ template
+ void defineField(SuperGeometry2D& sGeometry, int material,
+ AnalyticalF2D& field)
+ {
+ defineField(sGeometry.getMaterialIndicator(material), field);
+ }
+
+ /// Defines a field on a indicated domain
+ template
+ void defineField(SuperGeometry2D& sGeometry, IndicatorF2D& indicator,
+ AnalyticalF2D& field);
+#ifndef OLB_PRECOMPILED
+ void setExternalParticleField(SuperGeometry2D& sGeometry, AnalyticalF2D& velocity,
+ SmoothIndicatorF2D& sIndicator);
+#else
+ void setExternalParticleField(SuperGeometry2D& sGeometry, AnalyticalF2D& velocity,
+ SmoothIndicatorF2D& sIndicator) {};
+#endif
+
+ template
+ void addField(SuperGeometry2D& sGeometry, IndicatorF2D& indicator,
+ AnalyticalF2D& field);
+ template
+ void addField(SuperGeometry2D& sGeometry, IndicatorF2D& indicator,
+ AnalyticalF2D& field,
+ AnalyticalF2D& porous);
+ template
+ void multiplyField(SuperGeometry2D& sGeometry, IndicatorF2D& indicator,
+ AnalyticalF2D& field);
+
+ /// Initializes the equilibrium
+ void iniEquilibrium (T x0, T x1, T y0, T y1, T rho, const T u[DESCRIPTOR::d] );
+ /// Initializes the equilibrium on a domain described by an indicator
+ void iniEquilibrium(FunctorPtr>&& indicator,
+ AnalyticalF2D& rho, AnalyticalF2D& u);
+ /// Initializes the equilibrium on a domain with a particular material number
+ void iniEquilibrium(SuperGeometry2D& sGeometry, int material,
+ AnalyticalF2D& rho, AnalyticalF2D& u);
+
+ /// Apply collision step to a rectangular domain
+ void collide(T x0, T x1, T y0, T y1);
+ /// Apply collision step to the whole domain
+ void collide();
+ /// Apply streaming step to a rectangular domain
+ void stream(T x0, T x1, T y0, T y1);
+ /// Apply streaming step to the whole domain
+ void stream();
+ /// TO BE DONE: Apply first collision, then streaming step
+ /// to a rectangular domain
+ // void collideAndStream(T x0, T x1, T y0, T y1);
+ /// Apply first collision, then streaming step
+ /// to the whole domain
+ void collideAndStream();
+ /// Subtract a constant offset from the density within the whole domain
+ void stripeOffDensityOffset (int x0_, int x1_, int y0_, int y1_, T offset );
+ /// Subtract a constant offset from the density within a rect. domain
+ void stripeOffDensityOffset(T offset);
+ /// Switches Statistics on (default on)
+ void statisticsOn()
+ {
+ _statistics_on = true;
+ };
+ /// Switches Statistics off (default on). That speeds up
+ /// the execution time.
+ void statisticsOff()
+ {
+ _statistics_on = false;
+ };
+
+ /// Adds a coupling generator for one partner superLattice
+ template
+ void addLatticeCoupling(LatticeCouplingGenerator2D const& lcGen,
+ SuperLattice2D& partnerLattice );
+ /// Adds a coupling generator for one partner superLattice
+ template
+ void addLatticeCoupling(FunctorPtr>&& indicator,
+ LatticeCouplingGenerator2D const& lcGen,
+ SuperLattice2D& partnerLattice );
+ /// Adds a coupling generator for one partner superLattice
+ template
+ void addLatticeCoupling(SuperGeometry2D& sGeometry, int material,
+ LatticeCouplingGenerator2D const& lcGen,
+ SuperLattice2D& partnerLattice );
+ /// Adds a coupling generator for a multiple partner superLattice
+ template
+ void addLatticeCoupling(LatticeCouplingGenerator2D const& lcGen,
+ std::vector*> partnerLattices );
+ /// Adds a coupling generator for a multiple partner superLattice
+ template
+ void addLatticeCoupling(FunctorPtr>&& indicator,
+ LatticeCouplingGenerator2D const& lcGen,
+ std::vector*> partnerLattices );
+ /// Adds a coupling generator for a multiple partner superLattice
+ template
+ void addLatticeCoupling(SuperGeometry2D& sGeometry, int material,
+ LatticeCouplingGenerator2D const& lcGen,
+ std::vector*> partnerLattices );
+ /// Executes coupling generator for one partner superLattice
+ void executeCoupling();
+
+ //void communicate(bool verbose=true);
+
+ /// Number of data blocks for the serializable interface
+ std::size_t getNblock() const override;
+ /// Binary size for the serializer
+ std::size_t getSerializableSize() const override;
+ /// Return a pointer to the memory of the current block and its size for the serializable interface
+ bool* getBlock(std::size_t iBlock, std::size_t& sizeBlock, bool loadingMode) override;
+private:
+ /// Resets and reduce the statistics
+ void reset_statistics();
+};
+
+} // namespace olb
+
+#endif
--
cgit v1.2.3