/* This file is part of the OpenLB library * * Copyright (C) 2007 Jonas Latt * 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 * A helper for initialising 2D boundaries -- header file. */ #ifndef BOUNDARY_CONDITION_2D_H #define BOUNDARY_CONDITION_2D_H #include "core/blockLatticeStructure2D.h" #include "momentaOnBoundaries2D.h" #include "boundaryPostProcessors2D.h" #include "dynamics/dynamics.h" #include "geometry/blockGeometry2D.h" #include "functors/lattice/indicator/blockIndicatorF2D.h" namespace olb { template class OnLatticeBoundaryCondition2D { public: virtual ~OnLatticeBoundaryCondition2D() { } virtual void addVelocityBoundary0N(int x0, int x1, int y0, int y1, T omega) =0; virtual void addVelocityBoundary0P(int x0, int x1, int y0, int y1, T omega) =0; virtual void addVelocityBoundary1N(int x0, int x1, int y0, int y1, T omega) =0; virtual void addVelocityBoundary1P(int x0, int x1, int y0, int y1, T omega) =0; virtual void addConvectionBoundary0N(int x0, int x1, int y0, int y1, T omega, T* uAv=NULL) =0; virtual void addConvectionBoundary0P(int x0, int x1, int y0, int y1, T omega, T* uAv=NULL) =0; virtual void addConvectionBoundary1N(int x0, int x1, int y0, int y1, T omega, T* uAv=NULL) =0; virtual void addConvectionBoundary1P(int x0, int x1, int y0, int y1, T omega, T* uAv=NULL) =0; virtual void addExternalVelocityCornerNN(int x, int y, T omega) =0; virtual void addExternalVelocityCornerNP(int x, int y, T omega) =0; virtual void addExternalVelocityCornerPN(int x, int y, T omega) =0; virtual void addExternalVelocityCornerPP(int x, int y, T omega) =0; virtual void addInternalVelocityCornerNN(int x, int y, T omega) =0; virtual void addInternalVelocityCornerNP(int x, int y, T omega) =0; virtual void addInternalVelocityCornerPN(int x, int y, T omega) =0; virtual void addInternalVelocityCornerPP(int x, int y, T omega) =0; /** * \anchor BCimplI2D * \name Indicator-accepting boundary condition interfaces * * \param indicator Block indicator defining boundary cells * \param x0,x1,y0,y1 Range of cells to be traversed * \{ **/ /// Add velocity boundary for indicated cells /** * \param omega Omega value of velocity BC **/ virtual void addVelocityBoundary(BlockIndicatorF2D& indicator, int x0, int x1, int y0, int y1, T omega) =0; /// Add slip boundary for indicated cells virtual void addSlipBoundary(BlockIndicatorF2D& indicator, int x0, int x1, int y0, int y1) =0; /// Add partial slip boundary for indicated cells /** * \param tuner Value between 0 (=no slip) and 1(=free slip) **/ virtual void addPartialSlipBoundary(T tuner, BlockIndicatorF2D& indicator, int x0, int x1, int y0, int y1) =0; /// Add pressure boundary for indicated cells /** * \param omega Omega value of pressure BC **/ virtual void addPressureBoundary(BlockIndicatorF2D& indicator, int x0, int x1, int y0, int y1, T omega) =0; /// Add convection boundary for indicated cells /** * \param omega Omega value of convection BC * \param uAv Optional param for post processor **/ virtual void addConvectionBoundary(BlockIndicatorF2D& indicator, int x0, int x1, int y0, int y1, T omega, T* uAv=NULL) =0; virtual void addFreeEnergyWallBoundary(BlockIndicatorF2D& indicator, int x0, int x1, int y0, int y1, T addend, int latticeNumber) =0; virtual void addFreeEnergyInletBoundary(BlockIndicatorF2D& indicator, int x0, int x1, int y0, int y1, T omega, std::string type, int latticeNumber) =0; virtual void addFreeEnergyOutletBoundary(BlockIndicatorF2D& indicator, int x0, int x1, int y0, int y1, T omega, std::string type, int latticeNumber) =0; ///\} /** * \name Convenience wrappers for boundary functions * In practice it is often preferable to define a boundary on a single material * number instead of instantiating an appropriate indicator by hand. * * These convenience functions are simple wrappers around the actual * \ref BCimplI2D "boundary condition interfaces". * \{ **/ /// Add velocity boundary for a single material number void addVelocityBoundary(BlockGeometryStructure2D& blockGeometryStructure, int material, int x0, int x1, int y0, int y1, T omega); /// Add velocity boundary for any indicated cells inside the block domain void addVelocityBoundary(BlockIndicatorF2D& indicator, T omega, bool includeOuterCells=false); /// Add velocity boundary for all cells of a material number inside the block domain void addVelocityBoundary(BlockGeometryStructure2D& blockGeometryStructure, int material, T omega, bool includeOuterCells=false); /// Add slip boundary for a single material number void addSlipBoundary(BlockGeometryStructure2D& blockGeometryStructure, int material, int x0, int x1, int y0, int y1); /// Add slip boundary for any indicated cells inside the block domain void addSlipBoundary(BlockIndicatorF2D& indicator, bool includeOuterCells=false); /// Add slip boundary for all cells of a material number inside the block domain void addSlipBoundary(BlockGeometryStructure2D& blockGeometryStructure, int material, bool includeOuterCells=false); /// Add partial slip boundary for a single material number void addPartialSlipBoundary(T tuner, BlockGeometryStructure2D& blockGeometryStructure, int material, int x0, int x1, int y0, int y1); /// Add partial slip boundary for any indicated cells inside the block domain void addPartialSlipBoundary(T tuner, BlockIndicatorF2D& indicator, bool includeOuterCells=false); /// Add partial slip boundary for all cells of a material number inside the block domain void addPartialSlipBoundary(T tuner, BlockGeometryStructure2D& blockGeometryStructure, int material, bool includeOuterCells=false); /// Add pressure boundary for a single material number void addPressureBoundary(BlockGeometryStructure2D& blockGeometryStructure, int material, int x0, int x1, int y0, int y1, T omega); /// Add pressure boundary for any indicated cells inside the block domain void addPressureBoundary(BlockIndicatorF2D& indicator, T omega, bool includeOuterCells=false); /// Add pressure boundary for all cells of a material number inside the block domain void addPressureBoundary(BlockGeometryStructure2D& blockGeometryStructure, int material, T omega, bool includeOuterCells=false); /// Add convection boundary for a single material number void addConvectionBoundary(BlockGeometryStructure2D& blockGeometryStructure, int material, int x0, int x1, int y0, int y1, T omega, T* uAv=NULL); /// Add convection boundary for any indicated cells inside the block domain void addConvectionBoundary(BlockIndicatorF2D& indicator, T omega, T* uAv=NULL, bool includeOuterCells=false); /// Add convection boundary for all cells of a material number inside the block domain void addConvectionBoundary(BlockGeometryStructure2D& blockGeometryStructure, int material, T omega, T* uAv=NULL, bool includeOuterCells=false); void addFreeEnergyWallBoundary(BlockGeometryStructure2D& blockGeometryStructure, int material, int x0, int x1, int y0, int y1, T addend, int latticeNumber); void addFreeEnergyWallBoundary(BlockIndicatorF2D& indicator, T addend, int latticeNumber, bool includeOuterCells=false); void addFreeEnergyWallBoundary(BlockGeometryStructure2D& blockGeometryStructure, int material, T addend, int latticeNumber, bool includeOuterCells=false); void addFreeEnergyInletBoundary(BlockGeometryStructure2D& blockGeometryStructure, int material, int x0, int x1, int y0, int y1, T omega, std::string type, int latticeNumber); void addFreeEnergyInletBoundary(BlockIndicatorF2D& indicator, T omega, std::string type, int latticeNumber, bool includeOuterCells=false); void addFreeEnergyInletBoundary(BlockGeometryStructure2D& blockGeometryStructure, int material, T omega, std::string type, int latticeNumber, bool includeOuterCells=false); void addFreeEnergyOutletBoundary(BlockGeometryStructure2D& blockGeometryStructure, int material, int x0, int x1, int y0, int y1, T omega, std::string type, int latticeNumber); void addFreeEnergyOutletBoundary(BlockIndicatorF2D& indicator, T omega, std::string type, int latticeNumber, bool includeOuterCells=false); void addFreeEnergyOutletBoundary(BlockGeometryStructure2D& blockGeometryStructure, int material, T omega, std::string type, int latticeNumber, bool includeOuterCells=false); ///\} virtual BlockLatticeStructure2D& getBlock() =0; virtual BlockLatticeStructure2D const& getBlock() const =0; virtual void outputOn() =0; virtual void outputOff() =0; }; ////////// Factory functions ////////////////////////////////////////////////// template > OnLatticeBoundaryCondition2D* createLocalBoundaryCondition2D(BlockLatticeStructure2D& block); template > OnLatticeBoundaryCondition2D* createInterpBoundaryCondition2D(BlockLatticeStructure2D& block); } #endif