![]() |
|
A TriangulatedWall is a triangulation created from a set of vertices and a n-by-3 connectivity matrix defining n faces. More...
#include <TriangulatedWall.h>
Inheritance diagram for TriangulatedWall:Classes | |
| struct | Face |
Public Member Functions | |
| TriangulatedWall () | |
| Default constructor. More... | |
| TriangulatedWall (const TriangulatedWall &other) | |
| Copy constructor. More... | |
| TriangulatedWall (std::string filename, const ParticleSpecies *species) | |
| Constructor setting values. More... | |
| TriangulatedWall (const std::vector< Vec3D > &points, const std::vector< std::vector< unsigned >> &cells, const ParticleSpecies *species) | |
| Constructor setting values. More... | |
| void | set (const std::vector< Vec3D > &points, const std::vector< std::vector< unsigned >> &cells) |
| void | readVTK (std::string filename) |
| void | writeVTK (VTKContainer &vtk) const override |
| ~TriangulatedWall () override | |
| Destructor. More... | |
| TriangulatedWall & | operator= (const TriangulatedWall &other) |
| TriangulatedWall * | copy () const override |
| Wall copy method. It calls the copy constructor of this Wall, useful for polymorphism. More... | |
| bool | getDistanceAndNormal (const BaseParticle &p, Mdouble &distance, Vec3D &normal_return) const override |
| Compute the distance from the wall for a given BaseParticle and return if there is a collision. If there is a collision, also return the normal vector. More... | |
| void | move (const Vec3D &move) override |
| Move the TriangulatedWall to a new position, which is a Vec3D from the old position. More... | |
| void | read (std::istream &is) override |
| Reads an TriangulatedWall from an input stream, for example a restart file. More... | |
| void | write (std::ostream &os) const override |
| Writes an TriangulatedWall to an output stream, for example a restart file. More... | |
| std::string | getName () const override |
| Returns the name of the object, here the string "TriangulatedWall". More... | |
| BaseInteraction * | getInteractionWith (BaseParticle *p, unsigned timeStamp, InteractionHandler *interactionHandler) override |
| Get the interaction between this TriangulatedWall and given BaseParticle at a given time. More... | |
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... | |
| WallHandler * | getHandler () 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 BaseInteraction * | getInteractionWithSuperQuad (SuperQuadricParticle *p, unsigned timeStamp, InteractionHandler *interactionHandler) |
| void | getVTK (std::vector< Vec3D > &points, std::vector< std::vector< double >> &triangleStrips) |
| const Vec3D | getAxis () const |
| 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) |
| BaseWall * | getRenderedWall (size_t i) const |
| std::vector< BaseWall * > | getRenderedWalls () const |
| void | removeRenderedWalls () |
| void | renderWall (VTKContainer &vtk) |
| void | addParticlesAtWall (unsigned numElements=50) |
| void | setVelocityControl (Vec3D forceGoal, Vec3D gainFactor, Vec3D baseVelocity) |
| virtual void | writeWallDetailsVTK (VTKData &data) const |
| virtual void | computeWear () |
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 ParticleSpecies * | getSpecies () const |
| Returns a pointer to the species of this BaseInteractable. More... | |
| void | setSpecies (const ParticleSpecies *species) |
| Sets the species of this BaseInteractable. More... | |
| const Vec3D & | getForce () const |
| Returns the force on this BaseInteractable. More... | |
| const Vec3D & | getTorque () 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... | |
| virtual void | resetForceTorque (int numberOfOMPthreads) |
| void | sumForceTorqueOMP () |
| const Vec3D & | getPosition () const |
| Returns the position of this BaseInteractable. More... | |
| const Quaternion & | getOrientation () const |
| Returns the orientation of this BaseInteractable. More... | |
| virtual 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... | |
| virtual void | setOrientation (const Quaternion &orientation) |
| Sets the orientation of this BaseInteractable. 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 Vec3D & | getVelocity () const |
| Returns the velocity of this interactable. More... | |
| virtual const Vec3D & | getAngularVelocity () 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 |
| virtual bool | isFaceContact (const Vec3D &normal) 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 |
Protected Attributes | |
| std::vector< Vec3D > | vertex_ |
| std::vector< Face > | face_ |
Private Member Functions | |
| void | setNormalsAndNeighbours () |
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... | |
A TriangulatedWall is a triangulation created from a set of vertices and a n-by-3 connectivity matrix defining n faces.
It is initialised by a unstructured grid vtk file:
The file consists of a set of vertices and a n-by-3 connectivity matrix defining n faces. Three vertices form a face; the face normal is oriented such that the vertices are ordered in anticlockwise direction around the normal. 
Particles interact with a TriangulatedWall when they contact a face (from either side), a edge, or a vertex.
For a demonstration on how to use this class, see TriangulatedWallSelfTest (shown in the image below).
| TriangulatedWall::TriangulatedWall | ( | ) |
Default constructor.
Referenced by copy().
| TriangulatedWall::TriangulatedWall | ( | const TriangulatedWall & | other | ) |
Copy constructor.
| [in] | other | The TriangulatedWall that must be copied. |
| TriangulatedWall::TriangulatedWall | ( | std::string | filename, |
| const ParticleSpecies * | species | ||
| ) |
Constructor setting values.
References MergeRestartFiles::filename, readVTK(), and BaseWall::setSpecies().
| TriangulatedWall::TriangulatedWall | ( | const std::vector< Vec3D > & | points, |
| const std::vector< std::vector< unsigned >> & | cells, | ||
| const ParticleSpecies * | species | ||
| ) |
Constructor setting values.
|
override |
|
overridevirtual |
Wall copy method. It calls the copy constructor of this Wall, useful for polymorphism.
Implements BaseWall.
Reimplemented in WearableTriangulatedWall.
References TriangulatedWall().
Referenced by operator=().
|
overridevirtual |
Compute the distance from the wall for a given BaseParticle and return if there is a collision. If there is a collision, also return the normal vector.
| [in] | p | BaseParticle we want to calculate the distance and whether it collided of. |
| [out] | distance | The distance of the BaseParticle to this wall. |
| [out] | normal_return | If there was a collision, the normal vector to this wall will be placed here. |
This function computes whether or not there is a collision between a given BaseParticle and this TriangulatedWall. If there is a collision, this function also computes the distance between the BaseParticle and TriangulatedWall and the normal of the TriangulatedWall at the intersection point. It does this by calling TriangulatedWall::getDistanceAndNormal(const Vec3D& , Mdouble , Mdouble&, Vec3D&) const. Since this function should be called before calculating any Particle-Wall interactions, it can also be used to set the normal vector in case of curved walls.
NOTE: THIS ONLY RETURNS ONE OF POSSIBLY MANY INTERACTIONS; it's only used for finding out if interactions exist, so should be fine
Implements BaseWall.
|
overridevirtual |
Get the interaction between this TriangulatedWall and given BaseParticle at a given time.
Gets the interaction with this wall. In case of multiple contact points return the one with the shortest distance (i.e. largest overlap)
| [in] | p | Pointer to the BaseParticle which we want to check the interaction for. |
| [in] | timeStamp | The time at which we want to look at the interaction. |
| [in] | interactionHandler | A pointer to the InteractionHandler in which the interaction can be found. |
Reimplemented from BaseWall.
References calibrate::c, face_, InteractionHandler::getInteraction(), constants::inf, WallFunction::normal(), and p.
|
overridevirtual |
Returns the name of the object, here the string "TriangulatedWall".
Implements BaseObject.
Reimplemented in WearableTriangulatedWall.
|
overridevirtual |
Move the TriangulatedWall to a new position, which is a Vec3D from the old position.
| [in] | move | A reference to a Vec3D that denotes the direction and length it should be moved with. |
A function that moves the TriangulatedWall in a certain direction by both moving the walls and all intersections. Note that the directions of the intersections are not moved since they don't change when moving the TriangulatedWall as a whole.
Reimplemented from BaseInteractable.
References BaseInteractable::move(), v, and vertex_.
| TriangulatedWall & TriangulatedWall::operator= | ( | const TriangulatedWall & | other | ) |
Copy assignment operator.
| [in] | other | The TriangulatedWall that must be copied. |
|
overridevirtual |
Reads an TriangulatedWall from an input stream, for example a restart file.
| [in] | is | The input stream from which the TriangulatedWall is read, usually a restart file. |
Reimplemented from BaseWall.
Reimplemented in WearableTriangulatedWall.
Referenced by WearableTriangulatedWall::read().
| void TriangulatedWall::readVTK | ( | std::string | filename | ) |
| [in] | filename | name of vtk input file, e.g. TriangulatedWallSelfTest.vtk |
References f(), face_, MergeRestartFiles::filename, i, logger, setNormalsAndNeighbours(), oomph::Global_string_for_annotation::string(), v, and vertex_.
Referenced by TriangulatedWall().
| void TriangulatedWall::set | ( | const std::vector< Vec3D > & | points, |
| const std::vector< std::vector< unsigned >> & | cells | ||
| ) |
References f(), face_, i, setNormalsAndNeighbours(), and vertex_.
Referenced by WearableTriangulatedWall::WearableTriangulatedWall().
|
private |
References Vec3D::cross(), oomph::QElement1FaceToBulkCoordinates::face0(), oomph::QElement1FaceToBulkCoordinates::face1(), face_, and Vec3D::getUnitVector().
|
overridevirtual |
Writes an TriangulatedWall to an output stream, for example a restart file.
| [in] | os | The output stream where the TriangulatedWall must be written to, usually a restart file. |
Reimplemented from BaseWall.
Reimplemented in WearableTriangulatedWall.
References face_, and vertex_.
Referenced by WearableTriangulatedWall::write().
|
overridevirtual |
adds extra information to the points and triangleStrips vectors needed to plot the wall in vtk format
| points | Coordinates of the vertices of the triangulated surfaces (in the VTK file this is called POINTS) |
| triangleStrips | Indices of three vertices forming one triangulated surface (in the VTK file this is called CELL) |
Reimplemented from BaseWall.
References f(), face_, VTKContainer::points, s, VTKContainer::triangleStrips, v, and vertex_.
|
protected |
stores the face properties
Referenced by getDistanceAndNormal(), getInteractionWith(), WearableTriangulatedWall::processDebris(), readVTK(), set(), setNormalsAndNeighbours(), WearableTriangulatedWall::storeDebris(), TriangulatedWall(), WearableTriangulatedWall::WearableTriangulatedWall(), write(), and writeVTK().
|
protected |
stores the vertex coordinates
Referenced by move(), readVTK(), set(), TriangulatedWall(), write(), and writeVTK().