MercuryDPM  Beta
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
ChuteWithHopper.h
Go to the documentation of this file.
1 //Copyright (c) 2013-2014, 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 CHUTEWITHHOPPER_H
27 #define CHUTEWITHHOPPER_H
28 #include "Chute.h"
29 
37 class ChuteWithHopper : public Chute
38 {
39 public:
40 
41 //Constructors:
46  ChuteWithHopper(const Chute& other);
47 
51  ChuteWithHopper(const Mercury3D& other);
52 
56  ChuteWithHopper(const MercuryBase& other);
57 
61  ChuteWithHopper(const DPMBase& other);
62 
67 
68 //Setters and getters:
69 
73  void setHopperFillingPercentage(Mdouble hopperFillingPercentage);
74 
79  void setHopperLowestPoint(Mdouble hopperLowestPoint);
80 
86 
91 
95  void setChuteLength(Mdouble chuteLength);
96 
100  void setIsHopperCentred(bool isHopperCentred);
101 
105  void setHopperLowerFillingHeight(Mdouble hopperLowerFillingHeight);
106 
110  void setHopperShift(Mdouble hopperShift);
111 
115  void setHopperLift(Mdouble hopperLift);
116 
121 
126 
131  void setHopperDimension(Mdouble hopperDimension);
132 
136  void setIsHopperAlignedWithBottom(bool isHopperAlignedWithBottom);
137 
142 
147 
152 
157 
162 
166  bool getIsHopperCentred();
167 
173 
177  unsigned int getHopperDimension();
178 
179 //Other member functions:
180 
184  virtual void setupInitialConditions();
185 
189  void setHopper(Mdouble ExitLength, Mdouble ExitHeight, Mdouble Angle, Mdouble Length, Mdouble Height);
190 
195 
200 
204  virtual void read(std::istream& is);
205 
209  void write(std::ostream& os, bool writeAllParticles=true) const;
210 
214  bool readNextArgument(int& i, int argc, char *argv[]);
215 
216 protected:
220  void addHopper();
221 
222 private:
223 
227  void constructor();
228 
229 //protected:
262 
270  unsigned int hopperDimension_;
283 };
284 #endif
void setHopperLowerFillingHeight(Mdouble hopperLowerFillingHeight)
Sets the height above which the hopper is filled with new particles.
The DPMBase header includes quite a few header files, defining all the handlers, which are essential...
Definition: DPMBase.h:61
void setHopperFillingPercentage(Mdouble hopperFillingPercentage)
Sets the hopper filling percentage.
void addHopper()
This creates the hopper on top of the chute, see diagram in class description for details of the poin...
Mdouble getHopperLength()
Returns the width of the hopper entrance.
Mdouble hopperExitHeight_
Dimension of the hopper exit in vertical direction.
Mdouble getChuteLength()
Allows chute length to be accessed.
Mdouble getHopperShift()
Returns the shift in X-direction of the whole setup after rotation.
void setHopper(Mdouble ExitLength, Mdouble ExitHeight, Mdouble Angle, Mdouble Length, Mdouble Height)
Sets the hopper's geometrical properties.
double Mdouble
Mdouble hopperLowestPoint_
The NEGATIVE z coordinate of the right C point (when the left C point is in the origin) ...
void setHopperLowestPoint(Mdouble hopperLowestPoint)
Sets the vertical distance of the lowest hopper point relative to the start of the chute...
Mdouble hopperLowerFillingHeight_
Relative height (in [0,1)) above which the hopper is replenished with new particles.
Mdouble getHopperLowestPoint()
Returns the vertical distance of the lowest hopper point relative to the start of the chute...
bool getIsHopperCentred()
Returns whether the setup is shifted another 40 units in X-direction.
Mdouble getHopperAngle()
Returns the angle of the hopper entrance relative to the vertical.
void setHopperShift(Mdouble hopperShift)
Sets the shift in X-direction of the whole setup after rotation.
void setHopperLift(Mdouble hopperLift)
This lifts the hopper above the plane of the chute (after rotation)
bool isHopperCentred_
If this flag is set, the hopper will be constructed in the xy-center of the domain, and not next to the xmin-domain boundary; by default off.
Creates chutes with different bottoms. Inherits from Mercury3D (-> MercuryBase -> DPMBase)...
Definition: Chute.h:62
This is the base class for both Mercury2D and Mercury3D. Note the actually abstract grid is defined i...
Definition: MercuryBase.h:74
Mdouble hopperShift_
The x position where the Chute starts (defined as the beginning of the hopper)
unsigned int getHopperDimension()
Returns whether the hopper has vertical (1) or inclined (2) walls in Y-direction. ...
unsigned int hopperDimension_
This is the dimension of the hopper, my default it is one dimensional and hence does not have side wa...
Mdouble hopperLength_
Dimension of the hopper in vertical direction.
This adds on the hierarchical grid code for 3D problems.
Definition: Mercury3D.h:35
Mdouble getHopperFillingPercentage()
Returns the vertical percentage of the hopper insertion boundary which is filled. ...
Mdouble getHopperHeight()
Returns the height of the hopper relative to the chute start.
Mdouble getHopperExitHeight()
Returns the height of the lowest hopper point above the chute.
ChuteWithHopper()
This is the default constructor.
bool readNextArgument(int &i, int argc, char *argv[])
Reads setup properties from a string.
ChuteWithHopper has a hopper as inflow.
Mdouble getHopperLift()
Returns the hopper's lift above the chute bottom plane.
virtual void read(std::istream &is)
Reads setup properties from an istream.
Mdouble getHopperExitLength()
Returns the width of the hopper exit.
Mdouble getMaximumVelocityInducedByGravity()
Returns the theoretical maximum particle velocity due to gravity.
void setChuteLength(Mdouble chuteLength)
sets xMax to chuteLength+hopperlength_, and thus specifies the length off the runoff chute ...
bool isHopperAlignedWithBottom_
This is the flag, which sets if the chute bottom is aligned with the hopper, by default it is...
Mdouble hopperHeight_
Dimension of the hopper in horizontal direction.
Mdouble hopperAngle_
Angle between the two pieces of the hopper walls.
Mdouble hopperFillingPercentage_
This is which percentage of the hopper is used for creating new partices;.
void setIsHopperCentred(bool isHopperCentred)
Sets an extra shift in X-direction of the whole system.
virtual void setupInitialConditions()
Sets up the initial conditions for the problem.
void write(std::ostream &os, bool writeAllParticles=true) const
Writes setup properties to an ostream.
void setHopperDimension(Mdouble hopperDimension)
Sets whether the hopper should have vertical (1) or inclined (2) walls in Y-direction.
Mdouble hopperLift_
This is the vertical distance the chute is lifted above the plane.
void constructor()
This is the actually constructor, get called by all constructors above.
void setIsHopperAlignedWithBottom(bool isHopperAlignedWithBottom)
Sets the alignment of hopper with chute bottom.
Mdouble getTimeStepRatio()
Returns smallest particle radius over maximum gravitational velocity.
Mdouble hopperExitLength_
Dimension of the hopper exit in vertical direction.