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

This function defines a wall via a NurbsSurface. More...

#include <NurbsWall.h>

+ Inheritance diagram for NurbsWall:

Public Member Functions

 NurbsWall ()
 Default constructor: make a wall with default parameters. More...
 
 NurbsWall (const NurbsWall &other)
 Copy constructor, copies another wall. More...
 
 NurbsWall (const NurbsSurface &nurbsSurface)
 Constructor in which all parameters of the wall are set. More...
 
 ~NurbsWall ()
 Default destructor. More...
 
NurbsWallcopy () const final
 Copy this wall and return a pointer to the copy. More...
 
void set (const NurbsSurface &nurbsSurface)
 Defines a standard wall, given an outward normal vector s.t. normal*x=normal*point for all x of the wall. More...
 
bool getDistanceAndNormal (const BaseParticle &P, Mdouble &distance, Vec3D &normal_return) const final
 Compute the distance from the Screw for a given BaseParticle and return if there is a collision. If there is a collision, also return the normal vector of the interaction point. More...
 
void read (std::istream &is) override
 Reads this wall from an input stream, for example a restart file. More...
 
void write (std::ostream &os) const override
 Writes this wall to an output stream, for example a restart file. More...
 
std::string getName () const final
 Returns the name of the object, here the string "Screw". More...
 
void writeVTK (VTKContainer &vtk) const override
 
- Public Member Functions inherited from BaseWall
 BaseWall ()
 Default constructor. More...
 
 BaseWall (const BaseWall &w)
 Copy constructor. More...
 
 ~BaseWall () override
 Default destructor. More...
 
virtual bool getDistanceNormalOverlap (const BaseParticle &P, Mdouble &distance, Vec3D &normal_return, Mdouble &overlap) const
 
virtual bool getDistanceNormalOverlapSuperquadric (const SuperQuadricParticle &p, Mdouble &distance, Vec3D &normal_return, Mdouble &overlap) const
 
virtual Vec3D getFurthestPointSuperQuadric (const Vec3D &normalBodyFixed, const Vec3D &axes, Mdouble eps1, Mdouble eps2) const
 
virtual void setHandler (WallHandler *handler)
 A function which sets the WallHandler for this BaseWall. More...
 
WallHandlergetHandler () const
 A function which returns the WallHandler that handles this BaseWall. More...
 
void setIndSpecies (unsigned int indSpecies) override
 Define the species of this wall using the index of the species in the SpeciesHandler in this DPMBase. More...
 
void setSpecies (const ParticleSpecies *species)
 Defines the species of the current wall. More...
 
bool isFixed () const override
 
void setForceControl (Vec3D forceGoal, Vec3D gainFactor, Vec3D baseVelocity={0, 0, 0})
 Slowly adjusts the force on a wall towards a specified goal, by adjusting (prescribing) the velocity of the wall. More...
 
virtual bool isLocal (Vec3D &min, Vec3D &max) const
 
bool getLinePlaneIntersect (Vec3D &intersect, const Vec3D &p0, const Vec3D &p1, const Vec3D &n, const Vec3D &p)
 
bool isInsideWallVTK (const Vec3D &point, const Vec3D &normal, const Vec3D &position) const
 
void projectOntoWallVTK (Vec3D &point0, const Vec3D &point1, const Vec3D &normal, const Vec3D &position) const
 
void intersectVTK (std::vector< Vec3D > &points, Vec3D normal, Vec3D position) const
 
virtual BaseInteractiongetInteractionWithSuperQuad (SuperQuadricParticle *p, unsigned timeStamp, InteractionHandler *interactionHandler)
 
void getVTK (std::vector< Vec3D > &points, std::vector< std::vector< double >> &triangleStrips)
 
const Vec3D getAxis () const
 
BaseInteractiongetInteractionWith (BaseParticle *p, unsigned timeStamp, InteractionHandler *interactionHandler) override
 Returns the interaction between this wall and a given particle, nullptr if there is no interaction. More...
 
virtual void actionsOnRestart ()
 No implementation but can be overidden in its derived classes. More...
 
virtual void actionsAfterParticleGhostUpdate ()
 No implementation but can be overidden in its derived classes. More...
 
virtual void handleParticleAddition (unsigned int id, BaseParticle *p)
 Handles the addition of particles to the particleHandler. More...
 
virtual void handleParticleRemoval (unsigned int id)
 Handles the addition of particles to the particleHandler. More...
 
virtual void checkInteractions (InteractionHandler *interactionHandler, unsigned int timeStamp)
 Check if all interactions are valid. More...
 
bool getVTKVisibility () const
 
void setVTKVisibility (bool vtkVisibility)
 
void addRenderedWall (BaseWall *w)
 
BaseWallgetRenderedWall (size_t i) const
 
void removeRenderedWalls ()
 
void renderWall (VTKContainer &vtk)
 
void addParticlesAtWall (unsigned numElements=50)
 
void setVelocityControl (Vec3D forceGoal, Vec3D gainFactor, Vec3D baseVelocity)
 
- Public Member Functions inherited from BaseInteractable
 BaseInteractable ()
 Default BaseInteractable constructor. More...
 
 BaseInteractable (const BaseInteractable &p)
 Copy constructor. More...
 
 ~BaseInteractable () override
 Destructor, it simply destructs the BaseInteractable and all the objects it contains. More...
 
unsigned int getIndSpecies () const
 Returns the index of the species associated with the interactable object. More...
 
const ParticleSpeciesgetSpecies () const
 Returns a pointer to the species of this BaseInteractable. More...
 
void setSpecies (const ParticleSpecies *species)
 Sets the species of this BaseInteractable. More...
 
const Vec3DgetForce () const
 Returns the force on this BaseInteractable. More...
 
const Vec3DgetTorque () const
 Returns the torque on this BaseInteractable. More...
 
void setForce (const Vec3D &force)
 Sets the force on this BaseInteractable. More...
 
void setTorque (const Vec3D &torque)
 Sets the torque on this BaseInteractable. More...
 
void addForce (const Vec3D &addForce)
 Adds an amount to the force on this BaseInteractable. More...
 
void addTorque (const Vec3D &addTorque)
 Adds an amount to the torque on this BaseInteractable. More...
 
void resetForceTorque (int numberOfOMPthreads)
 
void sumForceTorqueOMP ()
 
const Vec3DgetPosition () const
 Returns the position of this BaseInteractable. More...
 
const QuaterniongetOrientation () const
 Returns the orientation of this BaseInteractable. More...
 
void setPosition (const Vec3D &position)
 Sets the position of this BaseInteractable. More...
 
void setOrientationViaNormal (Vec3D normal)
 Sets the orientation of this BaseInteractable by defining the vector that results from the rotation of the (1,0,0) vector. More...
 
void setOrientationViaEuler (Vec3D eulerAngle)
 Sets the orientation of this BaseInteractable by defining the euler angles. More...
 
void setOrientation (const Quaternion &orientation)
 Sets the orientation of this BaseInteractable. More...
 
virtual void move (const Vec3D &move)
 Moves this BaseInteractable by adding an amount to the position. More...
 
virtual void rotate (const Vec3D &angularVelocityDt)
 Rotates this BaseInteractable. More...
 
const std::vector
< BaseInteraction * > & 
getInteractions () const
 Returns a list of interactions which belong to this interactable. More...
 
void addInteraction (BaseInteraction *I)
 Adds an interaction to this BaseInteractable. More...
 
bool removeInteraction (BaseInteraction *I)
 Removes an interaction from this BaseInteractable. More...
 
void copyInteractionsForPeriodicParticles (const BaseInteractable &p)
 Copies interactions to this BaseInteractable whenever a periodic copy made. More...
 
void setVelocity (const Vec3D &velocity)
 set the velocity of the BaseInteractable. More...
 
void setAngularVelocity (const Vec3D &angularVelocity)
 set the angular velocity of the BaseInteractble. More...
 
void addVelocity (const Vec3D &velocity)
 adds an increment to the velocity. More...
 
void addAngularVelocity (const Vec3D &angularVelocity)
 add an increment to the angular velocity. More...
 
virtual const Vec3DgetVelocity () const
 Returns the velocity of this interactable. More...
 
virtual const Vec3DgetAngularVelocity () const
 Returns the angular velocity of this interactable. More...
 
void setPrescribedPosition (const std::function< Vec3D(double)> &prescribedPosition)
 Allows the position of an infinite mass interactable to be prescribed. More...
 
void applyPrescribedPosition (double time)
 Computes the position from the user defined prescribed position function. More...
 
void setPrescribedVelocity (const std::function< Vec3D(double)> &prescribedVelocity)
 Allows the velocity of an infinite mass interactable to be prescribed. More...
 
void applyPrescribedVelocity (double time)
 Computes the velocity from the user defined prescribed velocity function. More...
 
void setPrescribedOrientation (const std::function< Quaternion(double)> &prescribedOrientation)
 Allows the orientation of the infinite mass interactbale to be prescribed. More...
 
void applyPrescribedOrientation (double time)
 Computes the orientation from the user defined prescribed orientation function. More...
 
void setPrescribedAngularVelocity (const std::function< Vec3D(double)> &prescribedAngularVelocity)
 Allows the angular velocity of the infinite mass interactable to be prescribed. More...
 
void applyPrescribedAngularVelocity (double time)
 Computes the angular velocity from the user defined prescribed angular velocity. More...
 
virtual const Vec3D getVelocityAtContact (const Vec3D &contact) const
 Returns the velocity at the contact point, use by many force laws. More...
 
void integrateBeforeForceComputation (double time, double timeStep)
 This is part of integrate routine for objects with infinite mass. More...
 
void integrateAfterForceComputation (double time, double timeStep)
 This is part of the integration routine for objects with infinite mass. More...
 
virtual Mdouble getInvMass () const
 
virtual Mdouble getCurvature (const Vec3D &labFixedCoordinates) const
 
- 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

NurbsSurface nurbsSurface_
 The centre of the lower end of the screw. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from BaseWall
static void addToVTK (const std::vector< Vec3D > &points, VTKContainer &vtk)
 Takes the points provided and adds a triangle strip connecting these points to the vtk container. More...
 

Detailed Description

This function defines a wall via a NurbsSurface.

Definition at line 35 of file NurbsWall.h.

Constructor & Destructor Documentation

NurbsWall::NurbsWall ( )

Default constructor: make a wall with default parameters.

Make a default NurbsWall which is centered in the origin, has a length of 1, one revelation, a radius of 1, turns with 1 revelation per second, is infinitely thin and starts at its normal initial point.

Definition at line 39 of file NurbsWall.cc.

References DEBUG, and logger.

Referenced by copy().

40 {
41  logger(DEBUG, "NurbsWall() constructor finished.");
42 }
Logger< MERCURY_LOGLEVEL > logger("MercuryKernel")
Definition of different loggers with certain modules. A user can define its own custom logger here...
NurbsWall::NurbsWall ( const NurbsWall other)

Copy constructor, copies another wall.

Parameters
[in]otherThe NurbsWall that has to be copied.

Definition at line 47 of file NurbsWall.cc.

References DEBUG, and logger.

48  : BaseWall(other), nurbsSurface_(other.nurbsSurface_)
49 {
50  logger(DEBUG, "NurbsWall(const NurbsWall&) copy constructor finished.");
51 }
Logger< MERCURY_LOGLEVEL > logger("MercuryKernel")
Definition of different loggers with certain modules. A user can define its own custom logger here...
BaseWall()
Default constructor.
Definition: BaseWall.cc:36
NurbsSurface nurbsSurface_
The centre of the lower end of the screw.
Definition: NurbsWall.h:95
NurbsWall::NurbsWall ( const NurbsSurface nurbsSurface)

Constructor in which all parameters of the wall are set.

Definition at line 53 of file NurbsWall.cc.

References DEBUG, and logger.

54  : nurbsSurface_(nurbsSurface)
55 {
56  logger(DEBUG, "NurbsWall(const NurbsSurface&) constructor finished.");
57 }
Logger< MERCURY_LOGLEVEL > logger("MercuryKernel")
Definition of different loggers with certain modules. A user can define its own custom logger here...
NurbsSurface nurbsSurface_
The centre of the lower end of the screw.
Definition: NurbsWall.h:95
NurbsWall::~NurbsWall ( )

Default destructor.

Definition at line 59 of file NurbsWall.cc.

References DEBUG, and logger.

60 {
61  logger(DEBUG, "~NurbsWall() finished, destroyed the wall.");
62 }
Logger< MERCURY_LOGLEVEL > logger("MercuryKernel")
Definition of different loggers with certain modules. A user can define its own custom logger here...

Member Function Documentation

NurbsWall * NurbsWall::copy ( ) const
finalvirtual

Copy this wall and return a pointer to the copy.

Implements BaseWall.

Definition at line 64 of file NurbsWall.cc.

References NurbsWall().

65 {
66  return new NurbsWall(*this);
67 }
NurbsWall()
Default constructor: make a wall with default parameters.
Definition: NurbsWall.cc:39
bool NurbsWall::getDistanceAndNormal ( const BaseParticle P,
Mdouble distance,
Vec3D normal_return 
) const
finalvirtual

Compute the distance from the Screw for a given BaseParticle and return if there is a collision. If there is a collision, also return the normal vector of the interaction point.

Implements BaseWall.

Definition at line 74 of file NurbsWall.cc.

References NurbsSurface::getDistance(), BaseHandler< T >::getDPMBase(), BaseWall::getHandler(), BaseSpecies::getInteractionDistance(), SpeciesHandler::getMixedObject(), BaseInteractable::getOrientation(), BaseInteractable::getPosition(), BaseParticle::getRadius(), BaseInteractable::getSpecies(), nurbsSurface_, Quaternion::rotate(), Quaternion::rotateBack(), and DPMBase::speciesHandler.

75 {
76  //transform coordinates into position-orientation frame
77  Vec3D position = p.getPosition() - getPosition();
78  getOrientation().rotateBack(position);
80  if (nurbsSurface_.getDistance(position, p.getRadius()+s->getInteractionDistance(), distance, normal_return)) {
81  getOrientation().rotate(normal_return);
82  return true;
83  } else {
84  return false;
85  }
86 }
bool getDistance(Vec3D P, double radius, double &distance, Vec3D &normal) const
Find projection onto surface, return distance (and contactPoint)
std::enable_if<!std::is_pointer< typename U::MixedSpeciesType >::value, typename U::MixedSpeciesType * >::type getMixedObject(const U *S, const U *T)
const Vec3D & getPosition() const
Returns the position of this BaseInteractable.
BaseSpecies is the class from which all other species are derived.
Definition: BaseSpecies.h:49
void rotateBack(Vec3D &position) const
Applies the inverse rotation to a position.
Definition: Quaternion.cc:592
const ParticleSpecies * getSpecies() const
Returns a pointer to the species of this BaseInteractable.
void rotate(Vec3D &position) const
Applies the rotation to a position.
Definition: Quaternion.cc:563
Mdouble getInteractionDistance() const
returns the largest separation distance at which adhesive short-range forces can occur.
Definition: BaseSpecies.h:146
WallHandler * getHandler() const
A function which returns the WallHandler that handles this BaseWall.
Definition: BaseWall.cc:136
SpeciesHandler speciesHandler
A handler to that stores the species type i.e. LinearViscoelasticSpecies, etc.
Definition: DPMBase.h:1385
Definition: Vector.h:49
DPMBase * getDPMBase()
Gets the problem that is solved using this handler.
Definition: BaseHandler.h:725
const Quaternion & getOrientation() const
Returns the orientation of this BaseInteractable.
NurbsSurface nurbsSurface_
The centre of the lower end of the screw.
Definition: NurbsWall.h:95
std::string NurbsWall::getName ( ) const
finalvirtual

Returns the name of the object, here the string "Screw".

Returns
The string "NurbsWall".

Implements BaseObject.

Definition at line 111 of file NurbsWall.cc.

112 {
113  return "NurbsWall";
114 }
void NurbsWall::read ( std::istream &  is)
overridevirtual

Reads this wall from an input stream, for example a restart file.

Parameters
[in,out]isInput stream from which the wall must be read.

Reimplemented from BaseWall.

Definition at line 91 of file NurbsWall.cc.

References nurbsSurface_, and BaseWall::read().

92 {
93  BaseWall::read(is);
94  std::string dummy;
95  is >> dummy;
96  is >> nurbsSurface_;
97 }
void read(std::istream &is) override
Function that reads a BaseWall from an input stream, usually a restart file.
Definition: BaseWall.cc:80
NurbsSurface nurbsSurface_
The centre of the lower end of the screw.
Definition: NurbsWall.h:95
void NurbsWall::set ( const NurbsSurface nurbsSurface)

Defines a standard wall, given an outward normal vector s.t. normal*x=normal*point for all x of the wall.

Definition at line 69 of file NurbsWall.cc.

References nurbsSurface_.

69  {
70  nurbsSurface_ = nurbsSurface;
71 }
NurbsSurface nurbsSurface_
The centre of the lower end of the screw.
Definition: NurbsWall.h:95
void NurbsWall::write ( std::ostream &  os) const
overridevirtual

Writes this wall to an output stream, for example a restart file.

Parameters
[in,out]osOutput stream to which the wall must be written.

Reimplemented from BaseWall.

Definition at line 102 of file NurbsWall.cc.

References nurbsSurface_, and BaseWall::write().

103 {
104  BaseWall::write(os);
105  os << " NurbsSurface " << nurbsSurface_;
106 }
void write(std::ostream &os) const override
Function that writes a BaseWall to an output stream, usually a restart file.
Definition: BaseWall.cc:102
NurbsSurface nurbsSurface_
The centre of the lower end of the screw.
Definition: NurbsWall.h:95
void NurbsWall::writeVTK ( VTKContainer vtk) const
overridevirtual

adds extra information to the points and triangleStrips vectors needed to plot the wall in vtk format

Parameters
pointsCoordinates of the vertices of the triangulated surfaces (in the VTK file this is called POINTS)
triangleStripsIndices of three vertices forming one triangulated surface (in the VTK file this is called CELL)

Reimplemented from BaseWall.

Definition at line 116 of file NurbsWall.cc.

References NurbsSurface::evaluate(), BaseInteractable::getOrientation(), BaseInteractable::getPosition(), constants::i, nurbsSurface_, VTKContainer::points, Quaternion::rotate(), and VTKContainer::triangleStrips.

117 {
118  unsigned nu = 30;
119  unsigned nv = 30;
120 
121  //create points
122  size_t nPoints = vtk.points.size();
123  for (double u=0; u<=nu; u++) {
124  for (double v=0; v<=nv; v++) {
125  Vec3D p = nurbsSurface_.evaluate(u/nu,v/nu);
126  getOrientation().rotate(p);
127  p += getPosition();
128  vtk.points.push_back(p);
129  }
130  }
131 
132  //create connectivity matrix
133  //vtk.triangleStrips.reserve(vtk.triangleStrips.size()+nu);
134  for (unsigned i=0; i<nu; ++i) {
135  std::vector<double> cell;
136  cell.reserve(2*nv);
137  for (unsigned j=0; j<nv; ++j) {
138  cell.push_back(nPoints + j + i * (nv+1));
139  cell.push_back(nPoints + j + (i+1) * (nv+1));
140  }
141  vtk.triangleStrips.push_back(cell);
142  }
143 }
const Vec3D & getPosition() const
Returns the position of this BaseInteractable.
const std::complex< Mdouble > i
Definition: ExtendedMath.h:51
void rotate(Vec3D &position) const
Applies the rotation to a position.
Definition: Quaternion.cc:563
std::vector< std::vector< double > > triangleStrips
Definition: BaseWall.h:39
std::vector< Vec3D > points
Definition: BaseWall.h:38
Vec3D evaluate(double u, double v) const
Evaluate point on a nonrational NURBS surface.
Definition: Vector.h:49
const Quaternion & getOrientation() const
Returns the orientation of this BaseInteractable.
NurbsSurface nurbsSurface_
The centre of the lower end of the screw.
Definition: NurbsWall.h:95

Member Data Documentation

NurbsSurface NurbsWall::nurbsSurface_
private

The centre of the lower end of the screw.

Definition at line 95 of file NurbsWall.h.

Referenced by getDistanceAndNormal(), read(), set(), write(), and writeVTK().


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