MercuryDPM  Trunk
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
FluxBoundary Class Reference

Used for measuring flow rates through a given plane; acts like a pair of scales Inherits from BaseBoundary. Can measure forward, backward and net fluxes. More...

#include <FluxBoundary.h>

+ Inheritance diagram for FluxBoundary:

Public Member Functions

 FluxBoundary ()
 default constructor More...
 
 ~FluxBoundary () override
 destructor More...
 
FluxBoundarycopy () const override
 Copy method; creates copy on the heap and returns a pointer to it. More...
 
void set (const Vec3D &normal, Mdouble distance)
 Sets boundary position based on a normal and distance. More...
 
void reset ()
 Resets the counts to zero. More...
 
void move (Mdouble position)
 Sets the boundary's distance property to the given one. More...
 
Mdouble getDistance (const Vec3D &position) const
 Returns the shortest distance between the boundary and given position. More...
 
void checkBoundaryAfterParticlesMove (ParticleHandler &pH) override
 Runs at the end of each time step. More...
 
bool checkBoundaryAfterParticleMoved (BaseParticle *p, ParticleHandler &pH)
 Checks if particle has crossed the boundary and updates the scales if so. More...
 
unsigned int getNumberOfParticlesCrossedForw () const
 Gets the number of particles that have crossed the boundary. More...
 
unsigned int getNumberOfParticlesCrossedBack () const
 
unsigned int getNumberOfParticlesCrossedNet () const
 
double getMassOfParticlesCrossedForw () const
 
double getMassOfParticlesCrossedBack () const
 
double getMassOfParticlesCrossedNet () const
 
double getVolumeOfParticlesCrossedForw () const
 
double getVolumeOfParticlesCrossedBack () const
 
double getVolumeOfParticlesCrossedNet () const
 
void read (std::istream &is) override
 Reads some boundary properties from an std::istream. More...
 
MERCURY_DEPRECATED void oldRead (std::istream &is)
 Deprecated read method. use FluxBoundary::read() instead. More...
 
void write (std::ostream &os) const override
 Writes the boundary properties to an std::ostream. More...
 
std::string getName () const override
 Returns the name of the object. More...
 
- Public Member Functions inherited from BaseBoundary
 BaseBoundary ()
 default constructor. More...
 
 BaseBoundary (const BaseBoundary &b)
 copy constructor More...
 
 ~BaseBoundary () override
 destructor More...
 
virtual void createPeriodicParticle (BaseParticle *p UNUSED, ParticleHandler &pH UNUSED)
 Creates a periodic particle in case of periodic boundaries in serial build. More...
 
virtual void createPeriodicParticles (ParticleHandler &pH UNUSED)
 Creates periodic copies of given particle in case of periodic boundaries. More...
 
virtual void checkBoundaryBeforeTimeStep (DPMBase *md)
 Virtual function that does things before each time step. More...
 
virtual void actionsBeforeTimeLoop ()
 Virtual function that does something after DPMBase::setupInitialConditions but before the first time step. More...
 
virtual void modifyGhostAfterCreation (BaseParticle *particle, int i)
 
virtual void writeVTK (std::fstream &file)
 
void setHandler (BoundaryHandler *handler)
 Sets the boundary's BoundaryHandler. More...
 
BoundaryHandlergetHandler () const
 Returns the boundary's BoundaryHandler. More...
 
- Public Member Functions inherited from BaseObject
 BaseObject ()=default
 Default constructor. More...
 
 BaseObject (const BaseObject &p)=default
 Copy constructor, copies all the objects BaseObject contains. More...
 
virtual ~BaseObject ()=default
 virtual destructor More...
 
virtual void moveInHandler (unsigned int index)
 Except that it is virtual, it does the same thing as setIndex() does. More...
 
void setIndex (unsigned int index)
 Allows one to assign an index to an object in the handler/container. More...
 
void setId (unsigned long id)
 Assigns a unique identifier to each object in the handler (container) which remains constant even after the object is deleted from the container/handler. More...
 
unsigned int getIndex () const
 Returns the index of the object in the handler. More...
 
unsigned int getId () const
 Returns the unique identifier of any particular object. More...
 
void setGroupId (unsigned groupId)
 
unsigned getGroupId () const
 

Private Attributes

Vec3D normal_
 outward unit normal vector More...
 
Mdouble scaleFactor_
 This is the factor to rescale the given normal vector to a unit vectors. More...
 
Mdouble distance_
 The boundary's distance from the origin. More...
 
unsigned int numberOfParticlesCrossedForw_
 Number of particles that have been deleted by this boundary. More...
 
unsigned int numberOfParticlesCrossedBack_
 
double massCrossedForw_
 
double massCrossedBack_
 
double volumeCrossedForw_
 
double volumeCrossedBack_
 

Detailed Description

Used for measuring flow rates through a given plane; acts like a pair of scales Inherits from BaseBoundary. Can measure forward, backward and net fluxes.

Definition at line 41 of file FluxBoundary.h.

Constructor & Destructor Documentation

FluxBoundary::FluxBoundary ( )

default constructor

Default constructor (calls the parent-constructor of BaseBoundary as well)

Definition at line 35 of file FluxBoundary.cc.

References distance_, massCrossedBack_, massCrossedForw_, numberOfParticlesCrossedBack_, numberOfParticlesCrossedForw_, scaleFactor_, volumeCrossedBack_, and volumeCrossedForw_.

Referenced by copy().

36  : BaseBoundary()
37 {
38  distance_ = std::numeric_limits<double>::quiet_NaN();
39  scaleFactor_ = std::numeric_limits<double>::quiet_NaN();
42  massCrossedForw_ = 0;
43  massCrossedBack_ = 0;
46 #ifdef DEBUG_CONSTRUCTOR
47  std::cout<<"FluxBoundary::FluxBoundary() finished"<<std::endl;
48 #endif
49 }
Mdouble distance_
The boundary's distance from the origin.
Definition: FluxBoundary.h:148
unsigned int numberOfParticlesCrossedBack_
Definition: FluxBoundary.h:154
double massCrossedForw_
Definition: FluxBoundary.h:155
Mdouble scaleFactor_
This is the factor to rescale the given normal vector to a unit vectors.
Definition: FluxBoundary.h:144
double volumeCrossedBack_
Definition: FluxBoundary.h:158
double massCrossedBack_
Definition: FluxBoundary.h:156
double volumeCrossedForw_
Definition: FluxBoundary.h:157
BaseBoundary()
default constructor.
Definition: BaseBoundary.cc:32
unsigned int numberOfParticlesCrossedForw_
Number of particles that have been deleted by this boundary.
Definition: FluxBoundary.h:153
FluxBoundary::~FluxBoundary ( )
override

destructor

Destructor

Definition at line 54 of file FluxBoundary.cc.

55 {
56 #ifdef DEBUG_DESTRUCTOR
57  std::cout<<"FluxBoundary::~FluxBoundary() finished"<<std::endl;
58 #endif
59 }

Member Function Documentation

bool FluxBoundary::checkBoundaryAfterParticleMoved ( BaseParticle p,
ParticleHandler pH 
)

Checks if particle has crossed the boundary and updates the scales if so.

Checks if particle has passed the boundary, and if so, counts it.

Parameters
[in]ppointer to the particle which is to be checked
[out]pHthe particle's ParticleHandler
Returns
FALSE, since the particle is not deleted by this boundary

Definition at line 137 of file FluxBoundary.cc.

References BaseParticle::getDisplacement(), getDistance(), BaseParticle::getMass(), BaseInteractable::getPosition(), BaseParticle::getVolume(), massCrossedBack_, massCrossedForw_, numberOfParticlesCrossedBack_, numberOfParticlesCrossedForw_, volumeCrossedBack_, and volumeCrossedForw_.

Referenced by checkBoundaryAfterParticlesMove().

138 {
139  if (getDistance(p->getPosition() - p->getDisplacement()) > 0 && getDistance(p->getPosition()) < 0)
140  {
142  massCrossedForw_ += p->getMass();
144  }
145  else if (getDistance(p->getPosition() - p->getDisplacement()) < 0 && getDistance(p->getPosition()) > 0)
146  {
148  massCrossedBack_ += p->getMass();
150  }
151 
152  return false;
153 }
const Vec3D & getPosition() const
Returns the position of this BaseInteractable.
unsigned int numberOfParticlesCrossedBack_
Definition: FluxBoundary.h:154
virtual Mdouble getVolume() const
Get Particle volume function, which required a reference to the Species vector. It returns the volume...
double massCrossedForw_
Definition: FluxBoundary.h:155
Mdouble getMass() const
Returns the particle's mass.
Definition: BaseParticle.h:322
Mdouble getDistance(const Vec3D &position) const
Returns the shortest distance between the boundary and given position.
double volumeCrossedBack_
Definition: FluxBoundary.h:158
const Vec3D & getDisplacement() const
Returns the particle's displacement relative to the previous time step.
Definition: BaseParticle.h:392
double massCrossedBack_
Definition: FluxBoundary.h:156
double volumeCrossedForw_
Definition: FluxBoundary.h:157
unsigned int numberOfParticlesCrossedForw_
Number of particles that have been deleted by this boundary.
Definition: FluxBoundary.h:153
void FluxBoundary::checkBoundaryAfterParticlesMove ( ParticleHandler pH)
overridevirtual

Runs at the end of each time step.

Reimplemented from BaseBoundary.

Definition at line 124 of file FluxBoundary.cc.

References BaseHandler< T >::begin(), checkBoundaryAfterParticleMoved(), and BaseHandler< T >::end().

125 {
126  for (auto p = pH.begin(); p != pH.end(); ++p)
128 }
const std::vector< T * >::const_iterator end() const
Gets the end of the const_iterator over all BaseBoundary in this BaseHandler.
Definition: BaseHandler.h:704
const std::vector< T * >::const_iterator begin() const
Gets the begin of the const_iterator over all Object in this BaseHandler.
Definition: BaseHandler.h:690
bool checkBoundaryAfterParticleMoved(BaseParticle *p, ParticleHandler &pH)
Checks if particle has crossed the boundary and updates the scales if so.
FluxBoundary * FluxBoundary::copy ( ) const
overridevirtual

Copy method; creates copy on the heap and returns a pointer to it.

Copy function, which creates a copy and returns a pointer to that copy (on the heap)

Returns
pointer to the copy

Implements BaseBoundary.

Definition at line 66 of file FluxBoundary.cc.

References FluxBoundary().

67 {
68  return new FluxBoundary(*this);
69 }
FluxBoundary()
default constructor
Definition: FluxBoundary.cc:35
Mdouble FluxBoundary::getDistance ( const Vec3D position) const

Returns the shortest distance between the boundary and given position.

Calculates the shortest distance between the wall and given position.

Parameters
[in]positionthe position of which the distance should be calculated.

Definition at line 119 of file FluxBoundary.cc.

References distance_, Vec3D::dot(), and normal_.

Referenced by checkBoundaryAfterParticleMoved().

120 {
121  return distance_ - Vec3D::dot(position, normal_);
122 }
Mdouble distance_
The boundary's distance from the origin.
Definition: FluxBoundary.h:148
Vec3D normal_
outward unit normal vector
Definition: FluxBoundary.h:135
static Mdouble dot(const Vec3D &a, const Vec3D &b)
Calculates the dot product of two Vec3D: .
Definition: Vector.cc:76
double FluxBoundary::getMassOfParticlesCrossedBack ( ) const

Definition at line 182 of file FluxBoundary.cc.

References massCrossedBack_.

183 {
184  return massCrossedBack_ * 0.5;
185 }
double massCrossedBack_
Definition: FluxBoundary.h:156
double FluxBoundary::getMassOfParticlesCrossedForw ( ) const

Definition at line 167 of file FluxBoundary.cc.

References massCrossedForw_.

168 {
169  return massCrossedForw_ * 0.5;
170 }
double massCrossedForw_
Definition: FluxBoundary.h:155
double FluxBoundary::getMassOfParticlesCrossedNet ( ) const

Definition at line 197 of file FluxBoundary.cc.

References massCrossedBack_, and massCrossedForw_.

198 {
199  return (massCrossedForw_ - massCrossedBack_) * 0.5;
200 }
double massCrossedForw_
Definition: FluxBoundary.h:155
double massCrossedBack_
Definition: FluxBoundary.h:156
std::string FluxBoundary::getName ( ) const
overridevirtual

Returns the name of the object.

Returns the object's class name (i.e. 'FluxBoundary').

Returns
the object's class name

Implements BaseObject.

Definition at line 247 of file FluxBoundary.cc.

248 {
249  return "FluxBoundary";
250 }
unsigned int FluxBoundary::getNumberOfParticlesCrossedBack ( ) const

Definition at line 177 of file FluxBoundary.cc.

References numberOfParticlesCrossedBack_.

178 {
180 }
unsigned int numberOfParticlesCrossedBack_
Definition: FluxBoundary.h:154
unsigned int FluxBoundary::getNumberOfParticlesCrossedForw ( ) const

Gets the number of particles that have crossed the boundary.

Returns the number of particles that have crossed in either direction. All of these quantities have to be divided by two, because DPMBase.cc calls DPMBase::checkInteractionWithBoundaries() TWICE in each time step. (The intention is that the first round resolves InsertionBoundaries and the second resolves DeletionBoundaries, but this means FluxBoundaries are updated twice.)

Definition at line 162 of file FluxBoundary.cc.

References numberOfParticlesCrossedForw_.

163 {
165 }
unsigned int numberOfParticlesCrossedForw_
Number of particles that have been deleted by this boundary.
Definition: FluxBoundary.h:153
unsigned int FluxBoundary::getNumberOfParticlesCrossedNet ( ) const

Definition at line 192 of file FluxBoundary.cc.

References numberOfParticlesCrossedBack_, and numberOfParticlesCrossedForw_.

193 {
195 }
unsigned int numberOfParticlesCrossedBack_
Definition: FluxBoundary.h:154
unsigned int numberOfParticlesCrossedForw_
Number of particles that have been deleted by this boundary.
Definition: FluxBoundary.h:153
double FluxBoundary::getVolumeOfParticlesCrossedBack ( ) const

Definition at line 187 of file FluxBoundary.cc.

References volumeCrossedBack_.

188 {
189  return volumeCrossedBack_ * 0.5;
190 }
double volumeCrossedBack_
Definition: FluxBoundary.h:158
double FluxBoundary::getVolumeOfParticlesCrossedForw ( ) const

Definition at line 172 of file FluxBoundary.cc.

References volumeCrossedForw_.

173 {
174  return volumeCrossedForw_ * 0.5;
175 }
double volumeCrossedForw_
Definition: FluxBoundary.h:157
double FluxBoundary::getVolumeOfParticlesCrossedNet ( ) const

Definition at line 202 of file FluxBoundary.cc.

References volumeCrossedBack_, and volumeCrossedForw_.

203 {
204  return (volumeCrossedForw_ - volumeCrossedBack_) * 0.5;
205 }
double volumeCrossedBack_
Definition: FluxBoundary.h:158
double volumeCrossedForw_
Definition: FluxBoundary.h:157
void FluxBoundary::move ( Mdouble  distance)

Sets the boundary's distance property to the given one.

Resets the boundary's 'distance' from the origin to be the one given.

Parameters
[in]distancethe new 'distance' between boundary and origin. see also comments of FluxBoundary::set().

Definition at line 110 of file FluxBoundary.cc.

References distance_, and scaleFactor_.

111 {
112  distance_ = distance * scaleFactor_;
113 }
Mdouble distance_
The boundary's distance from the origin.
Definition: FluxBoundary.h:148
Mdouble scaleFactor_
This is the factor to rescale the given normal vector to a unit vectors.
Definition: FluxBoundary.h:144
void FluxBoundary::oldRead ( std::istream &  is)

Deprecated read method. use FluxBoundary::read() instead.

the deprecated version of the read-method. Should not be used by new users!

Deprecated:
Should be gone by Mercury 2.0. Use FluxBoundary::read() instead.

Definition at line 225 of file FluxBoundary.cc.

References distance_, normal_, and scaleFactor_.

226 {
227  std::string dummy;
228  is >> dummy >> normal_ >> dummy >> scaleFactor_ >> dummy >> distance_;
229 }
Mdouble distance_
The boundary's distance from the origin.
Definition: FluxBoundary.h:148
Vec3D normal_
outward unit normal vector
Definition: FluxBoundary.h:135
Mdouble scaleFactor_
This is the factor to rescale the given normal vector to a unit vectors.
Definition: FluxBoundary.h:144
void FluxBoundary::read ( std::istream &  is)
overridevirtual

Reads some boundary properties from an std::istream.

Reads a number of boundary properties from the given std::istream.

Parameters
[in,out]isthe istream

Implements BaseBoundary.

Definition at line 211 of file FluxBoundary.cc.

References distance_, normal_, BaseBoundary::read(), and scaleFactor_.

212 {
213  BaseBoundary::read(is);
214  std::string dummy;
215  is >> dummy >> normal_
216  >> dummy >> scaleFactor_
217  >> dummy >> distance_;
218 }
Mdouble distance_
The boundary's distance from the origin.
Definition: FluxBoundary.h:148
Vec3D normal_
outward unit normal vector
Definition: FluxBoundary.h:135
void read(std::istream &is) override=0
Reads the object's id_ from given istream NB: purely virtual function, overriding the version of Base...
Definition: BaseBoundary.cc:61
Mdouble scaleFactor_
This is the factor to rescale the given normal vector to a unit vectors.
Definition: FluxBoundary.h:144
void FluxBoundary::reset ( )

Resets the counts to zero.

Resets the various counts to zero.

Definition at line 95 of file FluxBoundary.cc.

References massCrossedBack_, massCrossedForw_, numberOfParticlesCrossedBack_, numberOfParticlesCrossedForw_, volumeCrossedBack_, and volumeCrossedForw_.

96 {
99  massCrossedForw_ = 0;
100  massCrossedBack_ = 0;
101  volumeCrossedForw_ = 0;
102  volumeCrossedBack_ = 0;
103 }
unsigned int numberOfParticlesCrossedBack_
Definition: FluxBoundary.h:154
double massCrossedForw_
Definition: FluxBoundary.h:155
double volumeCrossedBack_
Definition: FluxBoundary.h:158
double massCrossedBack_
Definition: FluxBoundary.h:156
double volumeCrossedForw_
Definition: FluxBoundary.h:157
unsigned int numberOfParticlesCrossedForw_
Number of particles that have been deleted by this boundary.
Definition: FluxBoundary.h:153
void FluxBoundary::set ( const Vec3D normal,
Mdouble  distance 
)

Sets boundary position based on a normal and distance.

Defines the placing of the (2D) boundary based on the given normal and distance.

Parameters
[in]normalboundary normal vector
[in]distance'distance' between the origin and the boundary, such that the following relation is satisfied:

\[ \mathbf{r} \cdot \mathbf{\hat{n}} = d \]

in which \( \mathbf{\hat{n}} \) and \( d \) are the given normal vector and distance, respectively. NB: If the distance is the ACTUAL distance from the origin, the normal vector must be of UNIT LENGTH for the placing of the boundary to be done correctly.

Definition at line 85 of file FluxBoundary.cc.

References distance_, Vec3D::dot(), normal_, and scaleFactor_.

86 {
87  scaleFactor_ = 1. / std::sqrt(Vec3D::dot(normal, normal));
88  normal_ = normal * scaleFactor_;
89  distance_ = distance * scaleFactor_;
90 }
Mdouble distance_
The boundary's distance from the origin.
Definition: FluxBoundary.h:148
Vec3D normal_
outward unit normal vector
Definition: FluxBoundary.h:135
static Mdouble dot(const Vec3D &a, const Vec3D &b)
Calculates the dot product of two Vec3D: .
Definition: Vector.cc:76
Mdouble scaleFactor_
This is the factor to rescale the given normal vector to a unit vectors.
Definition: FluxBoundary.h:144
void FluxBoundary::write ( std::ostream &  os) const
overridevirtual

Writes the boundary properties to an std::ostream.

Writes the boundary properties to an std::ostream.

Parameters
[out]osthe ostream the properties are to be written to.

Implements BaseBoundary.

Definition at line 235 of file FluxBoundary.cc.

References distance_, normal_, scaleFactor_, and BaseBoundary::write().

236 {
238  os << " normal " << normal_
239  << " scaleFactor " << scaleFactor_
240  << " distance " << distance_;
241 }
Mdouble distance_
The boundary's distance from the origin.
Definition: FluxBoundary.h:148
Vec3D normal_
outward unit normal vector
Definition: FluxBoundary.h:135
Mdouble scaleFactor_
This is the factor to rescale the given normal vector to a unit vectors.
Definition: FluxBoundary.h:144
void write(std::ostream &os) const override=0
Adds object's id_ to given ostream NB: purely virtual function, overriding the version of BaseObject...
Definition: BaseBoundary.cc:70

Member Data Documentation

Mdouble FluxBoundary::distance_
private

The boundary's distance from the origin.

Definition at line 148 of file FluxBoundary.h.

Referenced by FluxBoundary(), getDistance(), move(), oldRead(), read(), set(), and write().

double FluxBoundary::massCrossedBack_
private
double FluxBoundary::massCrossedForw_
private
Vec3D FluxBoundary::normal_
private

outward unit normal vector

Definition at line 135 of file FluxBoundary.h.

Referenced by getDistance(), oldRead(), read(), set(), and write().

unsigned int FluxBoundary::numberOfParticlesCrossedBack_
private
unsigned int FluxBoundary::numberOfParticlesCrossedForw_
private

Number of particles that have been deleted by this boundary.

Definition at line 153 of file FluxBoundary.h.

Referenced by checkBoundaryAfterParticleMoved(), FluxBoundary(), getNumberOfParticlesCrossedForw(), getNumberOfParticlesCrossedNet(), and reset().

Mdouble FluxBoundary::scaleFactor_
private

This is the factor to rescale the given normal vector to a unit vectors.

NB: Not only the normal vector is rescaled by this factor, also the 'distance' from the origin of the boundary is scaled by this factor! Also, once the boundary position is set with FluxBoundary::set(), the arguments of any reset of the distance_ property (i.e. usage of FluxBoundary::move()) will be rescaled by the same factor!

Definition at line 144 of file FluxBoundary.h.

Referenced by FluxBoundary(), move(), oldRead(), read(), set(), and write().

double FluxBoundary::volumeCrossedBack_
private
double FluxBoundary::volumeCrossedForw_
private

The documentation for this class was generated from the following files: