FixedClusterInsertionBoundary Class Reference

#include <FixedClusterInsertionBoundary.h>

+ Inheritance diagram for FixedClusterInsertionBoundary:

Public Member Functions

 FixedClusterInsertionBoundary ()
 Constructor: inherits from BaseClusterInsertionBoundary constructor. More...
 
 FixedClusterInsertionBoundary (const FixedClusterInsertionBoundary &other)
 Copy constructor with deep copy. More...
 
 ~FixedClusterInsertionBoundary () override
 Destructor: default destructor. More...
 
FixedClusterInsertionBoundarycopy () const override
 Creates a copy on the heap and returns a pointer. More...
 
void set (std::vector< BaseParticle * > particleToCopy, std::vector< Vec3D > positions, std::vector< Mdouble > radii, Vec3D velMin, Vec3D velMax, Mdouble rMicroParticle)
 Sets the properties of the ClusterInsertionBoundary. More...
 
void set (BaseParticle *particleToCopy, std::vector< Vec3D > positions, std::vector< Mdouble > radii, Vec3D velMin, Vec3D velMax, Mdouble rMicroParticle)
 Sets the properties of the ClusterInsertionBoundary. More...
 
void setPositionsAndRadii (std::vector< Vec3D > clusterPositions, std::vector< Mdouble > clusterRadii)
 this sets positions and radii of the desired clusters. More...
 
void checkBoundaryBeforeTimeStep (DPMBase *md) final
 inserts cluster: differently from RandomClusterInsertionBoundary, here no check for interaction is computed. More...
 
void placeParticle (BaseParticle *p, RNG &random) final
 Places particles according to vector clusterPositions_ and sets a random velocity, if required. More...
 
BaseParticlegenerateParticle (RNG &random) final
 Sets cluster radii according to vector clusterRadii_. More...
 
- Public Member Functions inherited from BaseClusterInsertionBoundary
 BaseClusterInsertionBoundary ()
 Constructor; sets everything to 0. More...
 
 BaseClusterInsertionBoundary (const BaseClusterInsertionBoundary &other)
 Copy constructor with deep copy. More...
 
 ~BaseClusterInsertionBoundary () override
 Destructor: default destructor. More...
 
void setRandomised (bool randomised)
 this turns off the randomise(): created for UnitTests. More...
 
bool getRandomised ()
 this returns a bool which indicates if the process is randomised (true) or not (false). More...
 
unsigned int getNumberOfClusterInserted ()
 this returns the number of cluster inserted. More...
 
void setRadiusMicroParticle (Mdouble rMP)
 this sets the radius of the micro particle composing the cluster. More...
 
void setGeometry (Vec3D posMin, Vec3D posMax)
 Sets the geometry (position and velocity distribution) of the ClusterInsertionBoundary. More...
 
void setVelocityRange (Vec3D velMin, Vec3D velMax)
 Sets the velocity range of the ClusterInsertionBoundary. More...
 
void setAdditionalClusterProperties (Mdouble collisionTimeOverTimeStep, Mdouble velocityDampingModulus, Mdouble energyRatioTolerance)
 sets additional cluster properties as: More...
 
void setOutputClusterProperties (bool doCdatOutput, bool doOverlOutput, bool doAmatOutput, bool doIntStrucOutput, bool doVtkOutput, bool doRestartOutput, bool doFStatOutput, bool doEneOutput)
 sets cluster whether or not cluster output files will be created, for example: More...
 
void read (std::istream &is) override
 reads boundary properties from istream More...
 
void write (std::ostream &os) const override
 writes boundary properties to ostream More...
 
- Public Member Functions inherited from InsertionBoundary
 InsertionBoundary ()
 
 InsertionBoundary (const InsertionBoundary &other)
 Copy constructor (with deep copy) More...
 
 ~InsertionBoundary () override
 Destructor: delete the particle that has to be copied at every insertion. More...
 
virtual void shiftBoundary (Vec3D shift)
 virtual function that shifts the boundary. More...
 
virtual void rotateBoundary (Vec3D angle)
 virtual function that rotates the boundary. More...
 
void checkBoundaryBeforeTimeStep (DPMBase *md) override
 Fills the boundary with particles. More...
 
void insertParticles (DPMBase *md)
 Fill a certain domain with particles. More...
 
unsigned int getNumberOfParticlesInserted () const
 Gets the number of particles inserted by the boundary. More...
 
Mdouble getMassOfParticlesInserted () const
 Gets the mass of particles inserted by the boundary. More...
 
Mdouble getVolumeOfParticlesInserted () const
 Gets the volume of particles inserted by the boundary. More...
 
void reset ()
 resets particle property counter variables. More...
 
void activate ()
 Turns on the InsertionBoundary. More...
 
void deactivate ()
 Turns off the InsertionBoundary. More...
 
bool isActivated ()
 Returns whether the InsertionBoundary is activated. More...
 
unsigned int getMaxFailed () const
 Gets the number of times that the boundary may fail to insert a particle. More...
 
void setParticleToCopy (std::vector< BaseParticle * > particleToCopy)
 Sets multiple different particles that will be inserted through the insertion boundary. More...
 
void setParticleToCopy (BaseParticle *particleToCopy)
 Sets the particle that will be inserted through the insertion boundary. More...
 
std::vector< BaseParticle * > getParticleToCopy ()
 Gets the particles that will be inserted through the insertion boundary. More...
 
void read (std::istream &is) override
 Reads the boundary's id_ and maxFailed_. More...
 
void write (std::ostream &os) const override
 Writes the boundary's id_ and maxFailed_. More...
 
Mdouble getVolumeFlowRate () const
 Gets the volume flow rate of the insertion routine. More...
 
void setVolumeFlowRate (Mdouble volumeFlowRate)
 Sets the volume flow rate of the insertion routine. More...
 
Mdouble getInitialVolume () const
 Gets the initialVolume() . More...
 
void setInitialVolume (Mdouble initialVolume)
 Gets the Volume which should be inserted by the insertion routine. More...
 
void setPSD (const PSD psd)
 Sets the range of particle radii that may be generated from a user defined PSD. More...
 
void setPSD (std::vector< PSD > psd, std::vector< Mdouble > probability)
 Sets the ranges of particle radii that may be generated from user defined PSDs. More...
 
std::vector< PSDgetPSD ()
 Gets the particle size distributions set by the user. More...
 
void setVariableVolumeFlowRate (const std::vector< Mdouble > &variableCumulativeVolumeFlowRate, Mdouble samplingInterval)
 Sets a variable volume flow rate. More...
 
bool insertParticle (Mdouble time)
 Checks the inserted total volume and returns if a particle is still allowed to be inserted. More...
 
bool getCheckParticleForInteraction () const
 Gets the variable that checks if a particle has an interaction. More...
 
void setCheckParticleForInteraction (bool checkParticleForInteraction)
 Sets the variable that checks if a particle has an interaction. More...
 
void setManualInsertion (bool manualInsertion)
 Set the flag for a manual PSD insertion routine. 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 checkBoundaryAfterParticlesMove (ParticleHandler &pH)
 Virtual function that does things to particles, each time step after particles have moved. 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 Member Functions

std::string getName () const override
 Returns the name of the object. More...
 

Additional Inherited Members

- Public Attributes inherited from InsertionBoundary
std::vector< BaseParticle * > particleToCopy_
 read Distribution class from file. ‍/ friend std::istream& operator>>(std::istream& is, InsertionBoundary::Distribution& type); More...
 
unsigned int maxFailed_
 Number of times that the wall may fail to insert a particle. More...
 
unsigned int numberOfParticlesInserted_
 Number of particles that are already inserted. More...
 
Mdouble massInserted_
 Total mass of particles inserted. More...
 
Mdouble volumeInserted_
 Total volume of particles inserted. More...
 
bool isActivated_
 The InsertionBoundary is activated by default. If the InsertionBoundary is deactivated, then it introduces no particles (useful for trying to maintain a certain insertion rate). More...
 
Mdouble volumeFlowRate_
 
Mdouble initialVolume_
 
std::vector< MdoublevariableCumulativeVolumeFlowRate_
 
Mdouble samplingInterval_
 
bool checkParticleForInteraction_
 Checks if a particle has an interaction with a wall or other particles. More...
 
std::vector< PSDparticleSizeDistributionVector_
 Defines a particle size distribution as an object of the PSD class; if particleSizeDistributionVector_ is empty, distribution_ is used instead. More...
 
Vec3D velMin_
 Minimum and maximum velocity of the particles to be inserted. More...
 
Vec3D velMax_
 
bool isManuallyInserting_
 A flag to enable a top-down class-by-class manual insertion of a PSD; default is FALSE. More...
 
std::vector< Mdoubleprobability_
 vector of probabilities in range [0,1] which determine the mixing ratio of partice size distributions. More...
 
int chosenSpecies_
 stores the chosen species for each timestep. More...
 
BaseParticlep0 = nullptr
 pointer to the next particle that should be inserted (needs to be stored across time steps). More...
 
- Protected Attributes inherited from BaseClusterInsertionBoundary
unsigned int nClusterInserted_
 
Mdouble radiusParticle_
 
int nParticles_
 
LinearPlasticViscoelasticFrictionSpeciesclusterSpecies_
 
bool isCdatOutputOn_
 
bool isOverlOutputOn_
 
bool isAmatOutputOn_
 
bool isIntStrucOutputOn_
 
bool isVtkOutputOn_
 
bool isRestartOutputOn_
 
bool isFStatOutputOn_
 
bool isEneOutputOn_
 
Mdouble sizeDispersityParticle_
 
Mdouble velocityDampingModulus_
 
int nInternalStructurePoints_
 
Mdouble energyRatioTolerance_
 
Mdouble collisionTimeOverTimeStep_
 
Vec3D posMin_
 
Vec3D posMax_
 
Vec3D velMin_
 
Vec3D velMax_
 
bool setRadiusParticleAndNotNumberOfParticles_
 
std::vector< Vec3DclusterPositions_
 
std::vector< MdoubleclusterRadii_
 
bool randomised_
 

Detailed Description

RandomClusterInsertionBoundary This class works exactly like CubeInsertionBoundary class but inserts clusters instead of particles, and the insertion process is not random, but determined by radii and positions specified by the user. MPI: It does not work with MPI. One of the reasons is the need to adapt function DPMBase::importParticlesAs(). In particular particles and interaction should be imported as MPIParticle and MPIInteraction. In addition to this, the same should be done inside BaseCluster::actionsAfterSolve() when particles are centred around the desired position.

Constructor & Destructor Documentation

◆ FixedClusterInsertionBoundary() [1/2]

FixedClusterInsertionBoundary::FixedClusterInsertionBoundary ( )

Constructor: inherits from BaseClusterInsertionBoundary constructor.

Default constructor: inherits from BaseClusterInsertionBoundary constructor.

11 {
12  logger(DEBUG, "RandomClusterInsertionBoundary::RandomClusterInsertionBoundary() finished");
13 }
Logger< MERCURYDPM_LOGLEVEL > logger("MercuryKernel")
Definition of different loggers with certain modules. A user can define its own custom logger here.
@ DEBUG
BaseClusterInsertionBoundary()
Constructor; sets everything to 0.
Definition: BaseClusterInsertionBoundary.cc:13

References DEBUG, and logger.

Referenced by copy().

◆ FixedClusterInsertionBoundary() [2/2]

FixedClusterInsertionBoundary::FixedClusterInsertionBoundary ( const FixedClusterInsertionBoundary other)

Copy constructor with deep copy.

Copy constructor

20 
21  logger(DEBUG, "RandomClusterInsertionBoundary::RandomClusterInsertionBoundary() finished");
22 }

References DEBUG, and logger.

◆ ~FixedClusterInsertionBoundary()

FixedClusterInsertionBoundary::~FixedClusterInsertionBoundary ( )
overridedefault

Destructor: default destructor.

Default Destructor.

Member Function Documentation

◆ checkBoundaryBeforeTimeStep()

void FixedClusterInsertionBoundary::checkBoundaryBeforeTimeStep ( DPMBase md)
finalvirtual

inserts cluster: differently from RandomClusterInsertionBoundary, here no check for interaction is computed.

Here the insertion process takes place. Differently from RandomClusterInsertionBoundary, this is basically just a for loop.

Reimplemented from BaseClusterInsertionBoundary.

109 {
110  logger(VERBOSE, "In FixedClusterInsertionBoundary::checkBoundaryBeforeTimeStep\n");
111 
112  if (!isActivated_)
113  return;
114 
115  /* Each time step, the InsertionBoundary attempts to fill up a region with
116  * clusters.
117  *
118  * It first calls generateParticle() to get a randomised particle, subject
119  * to a specified distribution over sizes and species. (The basic class
120  * supports size dispersity only but PolydisperseInsertionBoundary will
121  * support species dispersity.)
122  * Then it repeatedly calls placeParticle(), which gives the cluster a
123  * random location (and possibly velocity) in a specified,
124  * geometry-dependent bound. Each time, it checks whether the new cluster
125  * would have an interaction with another cluster or a wall.
126  *
127  * If it manages to do that within maxFailed_ tries, then:
128  * * the new cluster is created and inserted,
129  * * the failure counter is reset, and
130  * the processes is repeated with a new generateParticle().
131  *
132  * Otherwise, the processes terminates for this time step.
133  * */
134 
135  for (std::vector<Mdouble>::const_iterator i = clusterRadii_.begin(); i != clusterRadii_.end(); ++i) {
136 
137 
138  auto p0 = generateParticle(md->random);
139 
140  placeParticle(p0, md->random);
141 
142 
143  BaseCluster cluster;
144  if(getRandomised())
145  cluster.random.randomise();
151  cluster.doCdatOutput(isCdatOutputOn_);
153  cluster.doAmatOutput(isAmatOutputOn_);
155  cluster.doVtkOutput(isVtkOutputOn_);
158  cluster.doEneOutput(isEneOutputOn_);
159  cluster.setClusterId(md->particleHandler.getNextGroupId());
160  //Here, differently from RandomClusterInsertionBoundary the only possibility is to set radiusCluster and
161  // radiusParticle.
164  cluster.setRadiusCluster(p0->getRadius());
165  cluster.setPosition(p0->getPosition());
166  cluster.setVelocity(p0->getVelocity());
167  cluster.setParticleSpecies(
169  md->speciesHandler.getObject(p0->getIndSpecies())));
170  cluster.solve();
171 
172  md->importParticlesAs( cluster.particleHandler, cluster.interactionHandler, p0->getSpecies() );
173 
174  // Number of cluster inserted
176  // Total number of particles inserted
178  // This is the total mass composed by every single particle (not cluster!) inserted
180  // This is the total volume composed by every single particle (not cluster!) inserted
182  logger(VERBOSE, "Successfully inserted cluster %/%.", nClusterInserted_, clusterRadii_.size());
183 
184  delete p0;
185  }
186 
187 }
int i
Definition: BiCGSTAB_step_by_step.cpp:9
@ VERBOSE
Matrix2d md
Definition: MatrixBase_cast.cpp:1
bool isIntStrucOutputOn_
Definition: BaseClusterInsertionBoundary.h:156
bool isFStatOutputOn_
Definition: BaseClusterInsertionBoundary.h:162
bool isOverlOutputOn_
Definition: BaseClusterInsertionBoundary.h:152
int nInternalStructurePoints_
Definition: BaseClusterInsertionBoundary.h:172
bool isCdatOutputOn_
Definition: BaseClusterInsertionBoundary.h:150
Mdouble energyRatioTolerance_
Definition: BaseClusterInsertionBoundary.h:174
bool isRestartOutputOn_
Definition: BaseClusterInsertionBoundary.h:160
bool isAmatOutputOn_
Definition: BaseClusterInsertionBoundary.h:154
Mdouble velocityDampingModulus_
Definition: BaseClusterInsertionBoundary.h:170
std::vector< Mdouble > clusterRadii_
Definition: BaseClusterInsertionBoundary.h:191
unsigned int nClusterInserted_
Definition: BaseClusterInsertionBoundary.h:136
Mdouble collisionTimeOverTimeStep_
Definition: BaseClusterInsertionBoundary.h:177
bool isVtkOutputOn_
Definition: BaseClusterInsertionBoundary.h:158
Mdouble sizeDispersityParticle_
Definition: BaseClusterInsertionBoundary.h:168
Mdouble radiusParticle_
Definition: BaseClusterInsertionBoundary.h:139
bool isEneOutputOn_
Definition: BaseClusterInsertionBoundary.h:164
bool getRandomised()
this returns a bool which indicates if the process is randomised (true) or not (false).
Definition: BaseClusterInsertionBoundary.cc:163
bool setRadiusParticleAndNotNumberOfParticles_
Definition: BaseClusterInsertionBoundary.h:187
Definition: BaseCluster.h:30
void setRadiusParticle(Mdouble rP)
This sets the value of particles' radius if there's no dispersity in size.
Definition: BaseCluster.cc:76
void doFStatOutput(bool isfStatOutputOn)
This sets the bool variable that defines whether the cluster fStat output will be written or not.
Definition: BaseCluster.cc:341
void setEnergyRatioTolerance(Mdouble eRT)
This sets the value of the value of the energy ratio threshold under which the process can be conside...
Definition: BaseCluster.cc:213
void doRestartOutput(bool isRestartOutputOn)
This sets the bool variable that defines whether the cluster restart output will be written or not.
Definition: BaseCluster.cc:327
void doEneOutput(bool isEneOutputOn)
This sets the bool variable that defines whether the cluster ene output will be written or not.
Definition: BaseCluster.cc:355
void setParticleSpecies(LinearPlasticViscoelasticFrictionSpecies *particleSpecies)
This sets the species of the particle.
Definition: BaseCluster.cc:229
void setPosition(Vec3D p)
This sets the value of position_, which is the position in which the cluster will be inserted.
Definition: BaseCluster.cc:39
void setRadiusCluster(Mdouble rCR)
This sets the desired value of the cluster radius (there is no getter of this value,...
Definition: BaseCluster.cc:128
void doCdatOutput(bool iCOO)
This sets the bool variable that defines whether the cluster data output will be written or not.
Definition: BaseCluster.cc:257
void setVelocity(Vec3D v)
This sets the value of velocity after creation.
Definition: BaseCluster.cc:243
void setVelocityDampingModulus(Mdouble vDM)
This sets the value of the velocity damping modulus.
Definition: BaseCluster.cc:179
void doVtkOutput(bool iVOO)
This sets the bool variable that defines whether the cluster vtk output will be written or not.
Definition: BaseCluster.cc:313
void setSizeDispersityParticle(Mdouble sDP)
This sets the value of particles' dispersity in size.
Definition: BaseCluster.cc:96
void doAmatOutput(bool iAOO)
This sets the bool variable that defines whether the cluster adjacency matrix output will be written ...
Definition: BaseCluster.cc:285
void setNumberOfInternalStructurePoints(int gL)
This sets the value of the number of particles used to compute the internal structure.
Definition: BaseCluster.cc:196
void setClusterId(unsigned int iC)
This sets the value of the cluster ID.
Definition: BaseCluster.cc:162
void doIntStrucOutput(bool iISOO)
This sets the bool variable that defines whether the cluster internal structure output will be writte...
Definition: BaseCluster.cc:299
void setCollisionTimeOverTimeStep(Mdouble cTOTS)
This sets the collisionTimeOverTimeStep number (which is the ratio between collision time and time st...
Definition: BaseCluster.cc:55
void doOverlOutput(bool iOOO)
This sets the bool variable that defines whether the cluster overlap output will be written or not.
Definition: BaseCluster.cc:271
unsigned int getSize() const
Gets the size of the particleHandler (including mpi and periodic particles)
Definition: BaseHandler.h:663
virtual const Vec3D & getVelocity() const
Returns the velocity of this interactable.
Definition: BaseInteractable.cc:307
const ParticleSpecies * getSpecies() const
Returns a pointer to the species of this BaseInteractable.
Definition: BaseInteractable.h:87
const Vec3D & getPosition() const
Returns the position of this BaseInteractable.
Definition: BaseInteractable.h:197
unsigned int getIndSpecies() const
Returns the index of the species associated with the interactable object.
Definition: BaseInteractable.h:67
Mdouble getRadius() const
Returns the particle's radius.
Definition: BaseParticle.h:331
InteractionHandler interactionHandler
An object of the class InteractionHandler.
Definition: DPMBase.h:1473
ParticleHandler particleHandler
An object of the class ParticleHandler, contains the pointers to all the particles created.
Definition: DPMBase.h:1443
RNG random
This is a random generator, often used for setting up the initial conditions etc.....
Definition: DPMBase.h:1438
void solve()
The work horse of the code.
Definition: DPMBase.cc:4334
BaseParticle * generateParticle(RNG &random) final
Sets cluster radii according to vector clusterRadii_.
Definition: FixedClusterInsertionBoundary.cc:204
void placeParticle(BaseParticle *p, RNG &random) final
Places particles according to vector clusterPositions_ and sets a random velocity,...
Definition: FixedClusterInsertionBoundary.cc:190
unsigned int numberOfParticlesInserted_
Number of particles that are already inserted.
Definition: InsertionBoundary.h:270
bool isActivated_
The InsertionBoundary is activated by default. If the InsertionBoundary is deactivated,...
Definition: InsertionBoundary.h:288
Mdouble massInserted_
Total mass of particles inserted.
Definition: InsertionBoundary.h:275
BaseParticle * p0
pointer to the next particle that should be inserted (needs to be stored across time steps).
Definition: InsertionBoundary.h:349
Mdouble volumeInserted_
Total volume of particles inserted.
Definition: InsertionBoundary.h:280
Mdouble getVolume() const
Definition: ParticleHandler.cc:1261
Mdouble getMass() const
Definition: ParticleHandler.cc:605
void randomise()
sets the random variables such that they differ for each run
Definition: RNG.cc:78
Contains material and contact force properties.
Definition: Species.h:14

References BaseClusterInsertionBoundary::clusterRadii_, BaseClusterInsertionBoundary::collisionTimeOverTimeStep_, BaseCluster::doAmatOutput(), BaseCluster::doCdatOutput(), BaseCluster::doEneOutput(), BaseCluster::doFStatOutput(), BaseCluster::doIntStrucOutput(), BaseCluster::doOverlOutput(), BaseCluster::doRestartOutput(), BaseCluster::doVtkOutput(), BaseClusterInsertionBoundary::energyRatioTolerance_, generateParticle(), BaseInteractable::getIndSpecies(), ParticleHandler::getMass(), BaseInteractable::getPosition(), BaseParticle::getRadius(), BaseClusterInsertionBoundary::getRandomised(), BaseHandler< T >::getSize(), BaseInteractable::getSpecies(), BaseInteractable::getVelocity(), ParticleHandler::getVolume(), i, DPMBase::interactionHandler, InsertionBoundary::isActivated_, BaseClusterInsertionBoundary::isAmatOutputOn_, BaseClusterInsertionBoundary::isCdatOutputOn_, BaseClusterInsertionBoundary::isEneOutputOn_, BaseClusterInsertionBoundary::isFStatOutputOn_, BaseClusterInsertionBoundary::isIntStrucOutputOn_, BaseClusterInsertionBoundary::isOverlOutputOn_, BaseClusterInsertionBoundary::isRestartOutputOn_, BaseClusterInsertionBoundary::isVtkOutputOn_, logger, InsertionBoundary::massInserted_, md, BaseClusterInsertionBoundary::nClusterInserted_, BaseClusterInsertionBoundary::nInternalStructurePoints_, InsertionBoundary::numberOfParticlesInserted_, InsertionBoundary::p0, DPMBase::particleHandler, placeParticle(), BaseClusterInsertionBoundary::radiusParticle_, DPMBase::random, RNG::randomise(), BaseCluster::setClusterId(), BaseCluster::setCollisionTimeOverTimeStep(), BaseCluster::setEnergyRatioTolerance(), BaseCluster::setNumberOfInternalStructurePoints(), BaseCluster::setParticleSpecies(), BaseCluster::setPosition(), BaseCluster::setRadiusCluster(), BaseCluster::setRadiusParticle(), BaseClusterInsertionBoundary::setRadiusParticleAndNotNumberOfParticles_, BaseCluster::setSizeDispersityParticle(), BaseCluster::setVelocity(), BaseCluster::setVelocityDampingModulus(), BaseClusterInsertionBoundary::sizeDispersityParticle_, DPMBase::solve(), BaseClusterInsertionBoundary::velocityDampingModulus_, VERBOSE, and InsertionBoundary::volumeInserted_.

Referenced by RandomClusterInsertionBoundarySelfTest::setupInitialConditions().

◆ copy()

FixedClusterInsertionBoundary * FixedClusterInsertionBoundary::copy ( ) const
overridevirtual

Creates a copy on the heap and returns a pointer.

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

Returns
pointer to the copy on the heap

Reimplemented from BaseClusterInsertionBoundary.

35 {
36 #ifdef DEBUG_CONSTRUCTOR
37  std::cout << "BaseClusterInsertionBoundary::copy() const finished" << std::endl;
38 #endif
39  return new FixedClusterInsertionBoundary(*this);
40 }
FixedClusterInsertionBoundary()
Constructor: inherits from BaseClusterInsertionBoundary constructor.
Definition: FixedClusterInsertionBoundary.cc:10

References FixedClusterInsertionBoundary().

◆ generateParticle()

BaseParticle * FixedClusterInsertionBoundary::generateParticle ( RNG random)
finalvirtual

Sets cluster radii according to vector clusterRadii_.

Reimplemented from InsertionBoundary.

205 {
206  BaseParticle* P = particleToCopy_[0]->copy();
207  P->setRadius(clusterRadii_[nClusterInserted_]);
208  return P;
209 }
Definition: BaseParticle.h:33
std::vector< BaseParticle * > particleToCopy_
read Distribution class from file. ‍/ friend std::istream& operator>>(std::istream& is,...
Definition: InsertionBoundary.h:260
double P
Uniform pressure.
Definition: TwenteMeshGluing.cpp:77

References BaseClusterInsertionBoundary::clusterRadii_, BaseClusterInsertionBoundary::nClusterInserted_, Global_Physical_Variables::P, and InsertionBoundary::particleToCopy_.

Referenced by checkBoundaryBeforeTimeStep().

◆ getName()

std::string FixedClusterInsertionBoundary::getName ( ) const
overrideprivatevirtual

Returns the name of the object.

Returns the name of the object class

Returns
the object's class' name, i.e. 'ClusterInsertionBoundary'

Reimplemented from BaseClusterInsertionBoundary.

216 {
217  return "FixedClusterInsertionBoundary";
218 }

◆ placeParticle()

void FixedClusterInsertionBoundary::placeParticle ( BaseParticle p,
RNG random 
)
finalvirtual

Places particles according to vector clusterPositions_ and sets a random velocity, if required.

Reimplemented from BaseClusterInsertionBoundary.

191 {
192  if(getRandomised())
193  random.randomise();
194  Vec3D pos, vel;
196  vel.X = random.getRandomNumber(velMin_.X, velMax_.X);
197  vel.Y = random.getRandomNumber(velMin_.Y, velMax_.Y);
198  vel.Z = random.getRandomNumber(velMin_.Z, velMax_.Z);
199  p->setPosition(pos);
200  p->setVelocity(vel);
201 }
float * p
Definition: Tutorial_Map_using.cpp:9
std::vector< Vec3D > clusterPositions_
Definition: BaseClusterInsertionBoundary.h:190
Vec3D velMin_
Definition: BaseClusterInsertionBoundary.h:183
Vec3D velMax_
Definition: BaseClusterInsertionBoundary.h:183
Mdouble getRandomNumber()
This is a random generating routine can be used for initial positions.
Definition: RNG.cc:123
Definition: Kernel/Math/Vector.h:30
Mdouble Y
Definition: Kernel/Math/Vector.h:45
Mdouble Z
Definition: Kernel/Math/Vector.h:45
Mdouble X
the vector components
Definition: Kernel/Math/Vector.h:45

References BaseClusterInsertionBoundary::clusterPositions_, BaseClusterInsertionBoundary::getRandomised(), RNG::getRandomNumber(), BaseClusterInsertionBoundary::nClusterInserted_, p, RNG::randomise(), BaseClusterInsertionBoundary::velMax_, BaseClusterInsertionBoundary::velMin_, Vec3D::X, Vec3D::Y, and Vec3D::Z.

Referenced by checkBoundaryBeforeTimeStep().

◆ set() [1/2]

void FixedClusterInsertionBoundary::set ( BaseParticle particleToCopy,
std::vector< Vec3D positions,
std::vector< Mdouble radii,
Vec3D  velMin,
Vec3D  velMax,
Mdouble  rMicroParticle 
)

Sets the properties of the ClusterInsertionBoundary.

Sets all the properties of the cuboidal insertion boundary.

Parameters
[in]particleToCopyPointer to the BaseParticle which is used as a basis for clusters to be inserted
[in]positionsVector containing all clusters positions
[in]radiiVector containing all clusters radii
[in]velMinMinimum velocity of inserted particles
[in]velMaxMaximum velocity of inserted particles
[in]rMicroParticleRadius of the single particle composing the cluster.
77 {
78  setParticleToCopy(particleToCopy);
79 
80  setPositionsAndRadii(positions, radii);
81  setVelocityRange(velMin, velMax);
82 
83  setRadiusMicroParticle(rMicroParticle);
84 }
void setRadiusMicroParticle(Mdouble rMP)
this sets the radius of the micro particle composing the cluster.
Definition: BaseClusterInsertionBoundary.cc:171
void setVelocityRange(Vec3D velMin, Vec3D velMax)
Sets the velocity range of the ClusterInsertionBoundary.
Definition: BaseClusterInsertionBoundary.cc:187
void setPositionsAndRadii(std::vector< Vec3D > clusterPositions, std::vector< Mdouble > clusterRadii)
this sets positions and radii of the desired clusters.
Definition: FixedClusterInsertionBoundary.cc:87
void setParticleToCopy(std::vector< BaseParticle * > particleToCopy)
Sets multiple different particles that will be inserted through the insertion boundary.
Definition: InsertionBoundary.cc:378

References InsertionBoundary::setParticleToCopy(), setPositionsAndRadii(), BaseClusterInsertionBoundary::setRadiusMicroParticle(), and BaseClusterInsertionBoundary::setVelocityRange().

◆ set() [2/2]

void FixedClusterInsertionBoundary::set ( std::vector< BaseParticle * >  particleToCopy,
std::vector< Vec3D positions,
std::vector< Mdouble radii,
Vec3D  velMin,
Vec3D  velMax,
Mdouble  rMicroParticle 
)

Sets the properties of the ClusterInsertionBoundary.

Sets all the properties of the cuboidal insertion boundary.

Parameters
[in]particleToCopyVector of pointers to the BaseParticles which are used as a basis for clusters to be inserted
[in]positionsVector containing all clusters positions
[in]radiiVector containing all clusters radii
[in]velMinMinimum velocity of inserted particles
[in]velMaxMaximum velocity of inserted particles
[in]rMicroParticleRadius of the single particle composing the cluster.
55 {
56  setParticleToCopy(particleToCopy);
57 
58  setPositionsAndRadii(positions, radii);
59  setVelocityRange(velMin, velMax);
60 
61  setRadiusMicroParticle(rMicroParticle);
62 }

References InsertionBoundary::setParticleToCopy(), setPositionsAndRadii(), BaseClusterInsertionBoundary::setRadiusMicroParticle(), and BaseClusterInsertionBoundary::setVelocityRange().

Referenced by RandomClusterInsertionBoundarySelfTest::setupInitialConditions().

◆ setPositionsAndRadii()

void FixedClusterInsertionBoundary::setPositionsAndRadii ( std::vector< Vec3D clusterPositions,
std::vector< Mdouble clusterRadii 
)

this sets positions and radii of the desired clusters.

After a few checks, this sets positions and radii of the desired clusters.

88 {
89  if (clusterPositions.size() != clusterRadii.size())
90  logger(ERROR, "clusterPositions and clusterRadii have different size."
91  " clusterPositions.size() = %, clusterRadii.size() = %.",
92  clusterPositions.size(), clusterRadii.size());
93  else if (clusterPositions.empty())
94  logger(ERROR, "clusterPositions is empty."
95  " clusterPositions.size() = %.", clusterPositions.size() );
96  else if (clusterRadii.empty())
97  logger(ERROR, "clusterRadii is empty."
98  " clusterRadii.size() = %.", clusterRadii.size());
99  else
100  {
101  clusterPositions_ = clusterPositions;
102  clusterRadii_ = clusterRadii;
103  }
104 }
@ ERROR

References BaseClusterInsertionBoundary::clusterPositions_, BaseClusterInsertionBoundary::clusterRadii_, ERROR, and logger.

Referenced by set().


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