wallContact.h

Go to the documentation of this file.

/*  This file is part of the OpenLB library
 *
 *  Copyright (C) 2021 Jan E. Marquardt, Mathias J. Krause
 *  E-mail contact: info@openlb.net
 *  The most recent release of OpenLB can be downloaded at
 *  <http://www.openlb.net/>
 *
 *  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.
*/
 
#ifndef WALL_CONTACT_H
#define WALL_CONTACT_H
 
#include "contactFunctions.h"
#include "contactHelpers.h"
#include "core/blockStructure.h"
#include "core/util.h"
#include <array>
#include <limits>
#include <utility>
 
namespace olb {
namespace particles {
namespace contact {
 
template <unsigned D>
struct WallContact {
  static_assert(D == 2 || D == 3, "Only D=2 and D=3 are supported");
  static const std::vector<unsigned int> indicesDim;
  static const std::vector<unsigned int> indicesSingle;
};
 
template <>
const std::vector<unsigned int> WallContact<2>::indicesDim({0, 1});
template <>
const std::vector<unsigned int> WallContact<3>::indicesDim({0, 1, 2});
template <unsigned D>
const std::vector<unsigned int> WallContact<D>::indicesSingle({0});
 
// Contact type to be used, if wall contact should be ignored (e.g., if only particle-particle contact is of interest)
// TODO: struct IgnoreWallContact : WallContact {};
 
template <typename T, unsigned D, bool CONVEX>
struct WallContactArbitraryFromOverlapVolume : WallContact<D> {
private:
  PhysR<T, D> particlePosition;
  PhysR<T, D> min;
  PhysR<T, D> max;
  std::array<std::size_t, 1> particleID;
  std::array<unsigned, 1> wallID;
  std::array<T, 1> dampingFactor = {-1};
  std::array<bool, 1> particlePositionUpdated = {false};
  std::array<bool, 1> newContact = {true};
  std::array<int, 1> responsibleRank = {std::numeric_limits<int>::max()};
 
  static const std::size_t serialSize =
      sizeof(particlePositionUpdated) + sizeof(newContact) +
      sizeof(particlePosition) + sizeof(min) + sizeof(max) +
      sizeof(particleID) + sizeof(wallID) + sizeof(responsibleRank) +
      sizeof(dampingFactor);
 
  template <typename F>
  std::size_t processWithCommunicatables(F f);
 
public:
  static_assert(D == 2 || D == 3, "Only D=2 and D=3 are supported");
  WallContactArbitraryFromOverlapVolume();
  WallContactArbitraryFromOverlapVolume(std::size_t particleID,
                                        unsigned    wallID);
  WallContactArbitraryFromOverlapVolume(
      const WallContactArbitraryFromOverlapVolume<T, D, CONVEX>& contact);
  WallContactArbitraryFromOverlapVolume(
      WallContactArbitraryFromOverlapVolume<T, D, CONVEX>&& contact);
 
  constexpr const PhysR<T, D>& getParticlePosition() const;
  constexpr const PhysR<T, D>& getMin() const;
  constexpr const PhysR<T, D>& getMax() const;
  constexpr const std::size_t& getParticleID() const;
  constexpr unsigned getWallID() const;
  constexpr T getDampingFactor() const;
  constexpr const int& getResponsibleRank() const;
 
  constexpr void setParticlePosition(const PhysR<T, D>& particlePosition);
  constexpr void setDampingFactor(const T dampingFactor);
  constexpr void
  setDampingFactorFromInitialVelocity(const T coefficientOfRestitution,
                                      const T initialRelativeVelocityMagnitude);
  constexpr void setResponsibleRank(const int& rank);
 
  constexpr void resetMinMax();
  constexpr void updateMinMax(const PhysR<T, D>& positionInsideTheContact);
  constexpr void increaseMinMax(const Vector<T, D>& increaseBy);
 
  constexpr void
  combineWith(WallContactArbitraryFromOverlapVolume<T, D, CONVEX>& contact);
  constexpr bool isEmpty() const;
  constexpr bool isNew() const;
  constexpr void isNew(const bool newContact);
  constexpr bool isParticlePositionUpdated() const;
  // Set if the particle position is up-to-date
  constexpr void setParticlePositionUpdated(bool updated);
  WallContactArbitraryFromOverlapVolume<T, D, CONVEX>&
  operator=(const WallContactArbitraryFromOverlapVolume<T, D, CONVEX>& contact);
  WallContactArbitraryFromOverlapVolume<T, D, CONVEX>&
  operator=(WallContactArbitraryFromOverlapVolume<T, D, CONVEX>&& contact);
 
  std::size_t serialize(std::uint8_t* buffer);
  std::size_t deserialize(std::uint8_t* buffer);
  constexpr static std::size_t getSerialSize() { return serialSize; };
 
  void print();
};
 
} // namespace contact
} // namespace particles
} // namespace olb
#endif