1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
|
// 2004 © Janek Kozicki <cosurgi@berlios.de>
// 2009 © Václav Šmilauer <eudoxos@arcig.cz>
#pragma once
#include <core/PartialEngine.hpp>
namespace yade { // Cannot have #include directive inside.
class ForceEngine : public PartialEngine {
public:
void action() override;
// clang-format off
YADE_CLASS_BASE_DOC_ATTRS(ForceEngine,PartialEngine,"Apply contact force on some particles at each step.",
((Vector3r,force,Vector3r::Zero(),,"Force to apply."))
);
// clang-format on
};
REGISTER_SERIALIZABLE(ForceEngine);
/* Engine for applying force of varying magnitude but constant direction
* on subscribed bodies. times and magnitudes must have the same length,
* direction (normalized automatically) gives the orientation.
*
* As usual with interpolating engines: the first magnitude is used before the first
* time point, last magnitude is used after the last time point. Wrap specifies whether
* time wraps around the last time point to the first time point.
*/
class InterpolatingDirectedForceEngine : public ForceEngine {
size_t _pos;
public:
void action() override;
// clang-format off
YADE_CLASS_BASE_DOC_ATTRS_CTOR(InterpolatingDirectedForceEngine,ForceEngine,"Engine for applying force of varying magnitude but constant direction on subscribed bodies. times and magnitudes must have the same length, direction (normalized automatically) gives the orientation. \n\n\
\
As usual with interpolating engines: the first magnitude is used before the first time point, last magnitude is used after the last time point. Wrap specifies whether time wraps around the last time point to the first time point.",
((vector<Real>,times,,,"Time readings [s]"))
((vector<Real>,magnitudes,,,"Force magnitudes readings [N]"))
((Vector3r,direction,Vector3r::UnitX(),,"Contact force direction (normalized automatically)"))
((bool,wrap,false,,"wrap to the beginning of the sequence if beyond the last time point")),
/*ctor*/ _pos=0
);
// clang-format on
};
REGISTER_SERIALIZABLE(InterpolatingDirectedForceEngine);
struct RadialForceEngine : public PartialEngine {
void action() override;
virtual void postLoad(RadialForceEngine&);
// clang-format off
YADE_CLASS_BASE_DOC_ATTRS(RadialForceEngine,PartialEngine,"Apply force of given magnitude directed away from spatial axis.",
((Vector3r,axisPt,Vector3r::Zero(),,"Point on axis"))
((Vector3r,axisDir,Vector3r::UnitX(),Attr::triggerPostLoad,"Axis direction (normalized automatically)"))
((Real,fNorm,0,,"Applied force magnitude"))
);
// clang-format on
};
REGISTER_SERIALIZABLE(RadialForceEngine);
class DragEngine : public PartialEngine {
public:
void action() override;
// clang-format off
YADE_CLASS_BASE_DOC_ATTRS(DragEngine,PartialEngine,"Apply `drag force <http://en.wikipedia.org/wiki/Drag_equation>`__ on some particles at each step, decelerating them proportionally to their linear velocities. The applied force reads\n\n.. math:: F_{d}=-\\frac{\\vec{v}}{|\\vec{v}|}\\frac{1}{2}\\rho|\\vec{v}|^2 C_d A\n\nwhere $\\rho$ is the medium density (:yref:`density<DragEngine.Rho>`), $v$ is particle's velocity, $A$ is particle projected area (disc), $C_d$ is the drag coefficient (0.47 for :yref:`Sphere`), \n\n.. note:: Drag force is only applied to spherical particles, listed in ids.",
((Real,Rho,1.225,,"Density of the medium (fluid or air), by default - the density of the air."))
((Real,Cd,0.47,,"Drag coefficient <http://en.wikipedia.org/wiki/Drag_coefficient>`_."))
);
// clang-format on
};
REGISTER_SERIALIZABLE(DragEngine);
class LinearDragEngine : public PartialEngine {
public:
void action() override;
// clang-format off
YADE_CLASS_BASE_DOC_ATTRS(LinearDragEngine,PartialEngine,"Apply `viscous resistance or linear drag <http://en.wikipedia.org/wiki/Drag_%28physics%29#Very_low_Reynolds_numbers_.E2.80.94_Stokes.27_drag>`__ on some particles at each step, decelerating them proportionally to their linear velocities. The applied force reads\n\n.. math:: F_{d}=-b{\\vec{v}} \n\nwhere $b$ is the linear drag, $\\vec{v}$ is particle's velocity. \n\n.. math:: b=6\\pi\\nu r \n\nwhere $\\nu$ is the medium viscosity, $r$ is the `Stokes radius <http://en.wikipedia.org/wiki/Stokes_radius>`__ of the particle (but in this case we accept it equal to sphere radius for simplification), \n\n.. note:: linear drag is only applied to spherical particles, listed in ids.",
((Real,nu,0.001,,"Viscosity of the medium."))
);
// clang-format on
};
REGISTER_SERIALIZABLE(LinearDragEngine);
class HarmonicForceEngine : public PartialEngine {
void action() override;
// clang-format off
YADE_CLASS_BASE_DOC_ATTRS(HarmonicForceEngine,PartialEngine,"This engine adds a harmonic (sinusoidal) force to a set of bodies. It is identical to :yref:`HarmonicMotionEngine` except a force amplitude is prescribed instead of motion, see also the `dynamics of harmonic motion <http://en.wikipedia.org/wiki/Simple_harmonic_motion#Dynamics_of_simple_harmonic_motion>`__",
((Vector3r,A , Vector3r::Zero(),,"Amplitude [N]"))
((Vector3r,f , Vector3r::Zero(),,"Frequency [hertz]"))
((Vector3r,fi, Vector3r::Zero(),,"Initial phase [radians]. By default, the phase is zero such that the force starts at zero."))
);
// clang-format on
};
REGISTER_SERIALIZABLE(HarmonicForceEngine);
} // namespace yade
|
