Biorbd Release_1.13.0
Loading...
Searching...
No Matches
Muscles.h
1#ifndef BIORBD_MUSCLES_MUSCLES_H
2#define BIORBD_MUSCLES_MUSCLES_H
3
4#include "biorbdConfig.h"
5
6#include <memory>
7#include <vector>
8
9#include "InternalForces/Geometry.h"
10
11namespace BIORBD_NAMESPACE {
12namespace utils {
13class String;
14class Matrix;
15class Vector;
16class Vector3d;
17} // namespace utils
18
19namespace rigidbody {
23} // namespace rigidbody
24
25namespace internal_forces {
26namespace muscles {
27class MuscleGroup;
28class State;
29class Muscle;
30
34class BIORBD_API Muscles {
35 public:
39 Muscles();
40
45 Muscles(const Muscles& other);
46
50 virtual ~Muscles();
51
56 Muscles DeepCopy() const;
57
62 void DeepCopy(const Muscles& other);
63
70 void addMuscleGroup(
71 const utils::String& name,
72 const utils::String& originName,
73 const utils::String& insertionName);
74
80 int getMuscleGroupId(const utils::String& name) const;
81
86 std::vector<std::shared_ptr<Muscle>> muscles() const;
87
93 Muscle& muscle(size_t idx) const;
94
100 std::vector<utils::String> muscleNames() const;
101
106 std::vector<MuscleGroup>& muscleGroups();
107
112 const std::vector<MuscleGroup>& muscleGroups() const;
113
119 MuscleGroup& muscleGroup(size_t idx);
120
126 const MuscleGroup& muscleGroup(size_t idx) const;
127
133 const MuscleGroup& muscleGroup(const utils::String& name) const;
134
140 void updateMuscles(
141 rigidbody::Joints& updatedModel,
143
149 void updateMuscles(
151 bool updateKin = true);
152
159 void updateMuscles(
160 rigidbody::Joints& updatedModel,
163
170 void updateMuscles(
173 bool updateKin = true);
174
181 void updateMuscles(
182 std::vector<std::vector<utils::Vector3d>>& musclePointsInGlobal,
183 std::vector<utils::Matrix>& jacoPointsInGlobal);
184
192 void updateMuscles(
193 std::vector<std::vector<utils::Vector3d>>& musclePointsInGlobal,
194 std::vector<utils::Matrix>& jacoPointsInGlobal,
196
204 std::vector<std::shared_ptr<State>> stateSet();
205
222
242 const utils::Vector& F,
243 rigidbody::Joints& updatedModel,
246 bool updateMuscleParameters = true);
247
266 const utils::Vector& F,
269 int updateKin = 2);
270
289 const std::vector<std::shared_ptr<State>>& emg);
290
311 rigidbody::Joints& updatedModel,
312 const std::vector<std::shared_ptr<State>>& emg,
315 bool updateMuscleParameters = true);
316
334 const std::vector<std::shared_ptr<State>>& emg,
337 int updateKin = 2);
338
346 const std::vector<std::shared_ptr<State>>& states,
347 bool areadyNormalized = true);
348
354
364 rigidbody::Joints& updatedModel,
366 bool updateMuscleParameters = true);
367
377 int updateKin = 2);
378
387 utils::Vector muscleForces(const std::vector<std::shared_ptr<State>>& emg);
388
400 rigidbody::Joints& updatedModel,
401 const std::vector<std::shared_ptr<State>>& emg,
404 bool updateMuscleParameters = true);
405
416 const std::vector<std::shared_ptr<State>>& emg,
419 int updateKin = 2);
420
425 size_t nbMuscleGroups() const;
426
431 size_t nbMuscleTotal() const;
432
437 size_t nbMuscles() const;
438
439 protected:
446
447 std::shared_ptr<std::vector<MuscleGroup>>
449};
450
451} // namespace muscles
452} // namespace internal_forces
453} // namespace BIORBD_NAMESPACE
454
455#endif // BIORBD_MUSCLES_MUSCLES_H
A muscle group is muscle that share parents for both origin and insertion.
Definition MuscleGroup.h:28
std::vector< std::shared_ptr< Muscle > > muscles() const
Returns all the muscles. It sorts the muscles by group.
Definition Muscles.cpp:65
size_t nbMuscles() const
Return the total number of muscle.
Definition Muscles.cpp:314
void addMuscleGroup(const utils::String &name, const utils::String &originName, const utils::String &insertionName)
Add a muscle group to the set.
Definition Muscles.cpp:42
std::vector< utils::String > muscleNames() const
muscleNames Return the names for all the muscle ordered by their respective group name
Definition Muscles.cpp:87
size_t nbMuscleTotal() const
Return the total number of muscle.
Definition Muscles.cpp:310
size_t nbMuscleGroups() const
Return the total number of muscle groups.
Definition Muscles.cpp:251
std::shared_ptr< std::vector< MuscleGroup > > m_mus
Holder for muscle groups.
Definition Muscles.h:448
Muscle & muscle(size_t idx) const
Returns a specific muscle sorted by muscles().
Definition Muscles.cpp:75
std::vector< std::shared_ptr< State > > stateSet()
Get the vector of state that must be used to update states.
Definition Muscles.cpp:403
rigidbody::GeneralizedTorque muscularJointTorque(const utils::Vector &F)
Compute the muscular joint torque.
Definition Muscles.cpp:133
std::vector< MuscleGroup > & muscleGroups()
Return the muscle groups.
Definition Muscles.cpp:99
Muscles DeepCopy() const
Deep copy of muscles.
Definition Muscles.cpp:27
void updateMuscles(rigidbody::Joints &updatedModel, const rigidbody::GeneralizedCoordinates &Q)
Update all the muscles (positions, jacobian, etc.).
Definition Muscles.cpp:322
utils::Vector activationDot(const std::vector< std::shared_ptr< State > > &states, bool areadyNormalized=true)
Interface that returns in a vector all the activations dot.
Definition Muscles.cpp:195
utils::Matrix musclesLengthJacobian()
Return the previously computed muscle length jacobian.
Definition Muscles.cpp:255
MuscleGroup & muscleGroup(size_t idx)
Return the muscle group of specific index.
Definition Muscles.cpp:109
int getMuscleGroupId(const utils::String &name) const
Return the group ID.
Definition Muscles.cpp:55
utils::Vector muscleForces(const std::vector< std::shared_ptr< State > > &emg)
Compute and return the muscle forces.
Definition Muscles.cpp:212
utils::Matrix computeMusclesLengthJacobian(const rigidbody::Joints &model)
Assemble the muscle length jacobian using the provided model.
Definition Muscles.cpp:260
EMG holder to interact with the muscle.
Definition State.h:17
This is the core of the musculoskeletal model in biorbd.
Definition Joints.h:48
A wrapper for the Eigen::MatrixXd.
Definition Matrix.h:18
Wrapper around the std::string class with augmented functionality.
Definition String.h:18
Wrapper around Eigen Vector3d and attach it to a parent.
Definition Vector3d.h:27
Wrapper of the Eigen VectorXd.
Definition Vector.h:21