HopperInsertionBoundary.h
Go to the documentation of this file.
1 //Copyright (c) 2013-2023, The MercuryDPM Developers Team. All rights reserved.
2 //For the list of developers, see <http://www.MercuryDPM.org/Team>.
3 //
4 //Redistribution and use in source and binary forms, with or without
5 //modification, are permitted provided that the following conditions are met:
6 // * Redistributions of source code must retain the above copyright
7 // notice, this list of conditions and the following disclaimer.
8 // * Redistributions in binary form must reproduce the above copyright
9 // notice, this list of conditions and the following disclaimer in the
10 // documentation and/or other materials provided with the distribution.
11 // * Neither the name MercuryDPM nor the
12 // names of its contributors may be used to endorse or promote products
13 // derived from this software without specific prior written permission.
14 //
15 //THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
16 //ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
17 //WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
18 //DISCLAIMED. IN NO EVENT SHALL THE MERCURYDPM DEVELOPERS TEAM BE LIABLE FOR ANY
19 //DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
20 //(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
21 //LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
22 //ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23 //(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
24 //SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25 
26 #ifndef BOUNDARIES_HOPPERINSERTIONBOUNDARY_H
27 #define BOUNDARIES_HOPPERINSERTIONBOUNDARY_H
28 
29 #include "InsertionBoundary.h"
30 
31 class BaseParticle;
32 
33 class RNG;
34 
49 {
50 public:
51 
56 
61 
65  HopperInsertionBoundary* copy() const override;
66 
70  void set(std::vector<BaseParticle*> particleToCopy, unsigned int maxFailed, double yMin, double yMax,
71  double chuteAngle, double fixedParticleRadius, bool isHopperCentred_, int hopperDim, double hopperAngle,
72  double hopperLength, double hopperExitLength, double hopperHeight, double lift, double fillPercent);
73 
77  void set(BaseParticle* particleToCopy, unsigned int maxFailed, double yMin, double yMax, double chuteAngle,
78  double fixedParticleRadius, bool isHopperCentred_, int hopperDim, double hopperAngle, double
79  hopperLength, double hopperExitLength, double hopperHeight, double lift, double fillPercent);
80 
84  void placeParticle(BaseParticle* p, RNG& random) override;
85 
89  void read(std::istream& is) override;
90 
94  void write(std::ostream& os) const override;
95 
99  std::string getName() const override;
100 
101 
108  double yMin_, yMax_;
109 
113  double chuteAngle_;
114 
118  double hopperAngle_;
119 
124 
129 
134 
140 
145 
151  double fillPercent_;
152 
156  double lift_;
157 
165 
166 };
167 
168 #endif
Definition: BaseParticle.h:54
Inherits from InsertionBoundary Some images are useful to better understand the structure of both the...
Definition: HopperInsertionBoundary.h:49
double yMin_
The minimum and maximum y-positions of the particle for a hopper with vertical walls in the y-directi...
Definition: HopperInsertionBoundary.h:108
double fixedParticleRadius_
Definition: HopperInsertionBoundary.h:123
void write(std::ostream &os) const override
writes boundary properties to ostream
Definition: HopperInsertionBoundary.cc:316
HopperInsertionBoundary()
Default constructor. Sets all properties to 0.
Definition: HopperInsertionBoundary.cc:34
HopperInsertionBoundary * copy() const override
copy method, returns a pointer to a copy.
Definition: HopperInsertionBoundary.cc:74
double hopperExitLength_
The horizontal (AB-direction) width at the square exit of the hopper.
Definition: HopperInsertionBoundary.h:133
int hopperDim_
Either 1 or 2. If 1, the insertion boundary has vertical walls in the y extrema. This is used e....
Definition: HopperInsertionBoundary.h:164
void set(std::vector< BaseParticle * > particleToCopy, unsigned int maxFailed, double yMin, double yMax, double chuteAngle, double fixedParticleRadius, bool isHopperCentred_, int hopperDim, double hopperAngle, double hopperLength, double hopperExitLength, double hopperHeight, double lift, double fillPercent)
Sets all boundary properties at once.
Definition: HopperInsertionBoundary.cc:117
double hopperAngle_
Angle of the hopper as compared to the vertical plane.
Definition: HopperInsertionBoundary.h:118
double hopperHeight_
The vertical (AC-direction) height of the hopper, measured from the top of the hopper to the start of...
Definition: HopperInsertionBoundary.h:139
double hopperLength_
The horizontal (AB-direction) width at the top of the hopper.
Definition: HopperInsertionBoundary.h:128
double lift_
Definition: HopperInsertionBoundary.h:156
bool isHopperCentred__
Definition: HopperInsertionBoundary.h:144
double fillPercent_
Percentage of the height of the insertion boundary up to which it should be filled....
Definition: HopperInsertionBoundary.h:151
void placeParticle(BaseParticle *p, RNG &random) override
This places an inflow particle in the top 50% of the hopper i.e. between gamma=0.5 and gamma=1....
Definition: HopperInsertionBoundary.cc:227
double yMax_
Definition: HopperInsertionBoundary.h:108
void read(std::istream &is) override
reads boundary properties from istream
Definition: HopperInsertionBoundary.cc:294
std::string getName() const override
Returns the name of the object.
Definition: HopperInsertionBoundary.cc:337
double chuteAngle_
Angle of the chute as compared to the horizontal plane.
Definition: HopperInsertionBoundary.h:113
Boundary structure for boundaries used for insertion of particles.
Definition: InsertionBoundary.h:50
This is a class that generates random numbers i.e. named the Random Number Generator (RNG).
Definition: RNG.h:53