Diff of /osl/README.md [000000] .. [20044c]

Switch to unified view

a b/osl/README.md
1
# MyoProsthesis
2
3
## General:
4
5
The MyoProsthesis model combineds both the 80-muscle [MyoLeg](https://github.com/MyoHub/myo_sim/tree/main/leg) model and [Open Source Leg](https://neurobionics.robotics.umich.edu/research/wearable-robotics/open-source-leg/), to simulate a trans-feromal amputation model.
6
7
## Modifications:
8
9
The MyoLeg model was modified as follows:
10
11
1. Replaced the right leg with trans-feromal leg, with 50% of the femur remaining
12
2. Muscles articulating the knee joint were removed, based on [1]. The list of muscles removed are detailed in the section below
13
3. Added OSL v2 to the right leg
14
4. Added a 4-DOF socket joint, with damping to model socket movement and dynamics
15
5. Adjusted the lengths of the thigh and shank pylons of the OSL to match joint rotation centers of the knee and ankle joint
16
6. Added a force sensor to represent the load cell between the pylon and ankle assembly of OSL leg
17
7. Added a force sensor at the socket joint
18
19
20
## Included Muscles - 54 Muscles and 2 Electrical Actuators and Primary Function:
21
| **Name in MyoLeg**        | **Real Name**                  | **Primary Function**                             | **Joint Movement**   |
22
|---------------------------|--------------------------------|--------------------------------------------------|----------------------|
23
| addbrev                   | Adductor brevis                | Thigh Adduction                                  | Hip                  |
24
| addlong                   | Adductor longus                | Thigh Adduction, rotation                        | Hip                  |
25
| addmagDist                | Adductor magnus distal         | Pelvis stabilizer                                | Hip, Knee            |
26
| addmagIsch                | Adductor magnus ischial        | Pelvis stabilizer                                | Hip, Knee            |
27
| addmagMid                 | Adductor magnus mid            | Pelvis stabilizer                                | Hip, Knee            |
28
| addmagProx                | Adductor magnus proximal       | Pelvis stabilizer                                | Hip, Knee            |
29
| bflh                      | Bicep Femoral Long Head        | Thigh extension, rotation and Knee flexion       | Hip, Knee            |
30
| bfsh                      | Bicep Femoral Short Head       | Knee Rotation                                    | Knee                 |
31
| edl                       | Extensor Digitorum Longus      | Digits movement                                  | Digits               |
32
| ehl                       | Extensor Hallucis longus       | Digits movement                                  | Digits               |
33
| fdl                       | Flexor Digitorum Longus        | Digits movement                                  | Digits               |
34
| fhl                       | Flexor Hallucis Longus         | Digits movement                                  | Digits               |
35
| gaslat                    | Gastrocnemious Lateral         | Plantar Flexion, knee Flexion                    | Ankle                |
36
| gasmed                    | Gastrocnemious medial          | Plantar Flexion, knee Flexion                    | Ankle                |
37
| glmax1                    | Gluteus Maximus 1              | Thigh Rotation                                   | Hip                  |
38
| glmax2                    | Gluteus Maximus 2              | Thigh Rotation                                   | Hip                  |
39
| glmax3                    | Gluteus Maximus 3              | Thigh Rotation                                   | Hip                  |
40
| glmed1                    | Gluteus Medius 1               | Hip Abduction                                    | Hip                  |
41
| glmed2                    | Gluteus Medius 2               | Hip Abduction                                    | Hip                  |
42
| glmed3                    | Gluteus Medius 3               | Hip Abduction                                    | Hip                  |
43
| glmin1                    | Gluteus Minimus 1              | Hip Abduction and Stabilizer                     | Hip                  |
44
| glmin2                    | Gluteus Minimus 2              | Hip Abduction and Stabilizer                     | Hip                  |
45
| glmin3                    | Gluteus Minimus 3              | Hip Abduction and Stabilizer                     | Hip                  |
46
| grac                      | Gracilis                       | Thigh abduction, knee flexion                    | Hip, Knee            |
47
| iliacus                   | Iliacus                        | Femur Rotation                                   | Hip                  |
48
| perbrev                   | Peroneus Brevis                | Foot Eversion                                    | Ankle                |
49
| perlong                   | Peroneus Long                  | Foot Eversion                                    | Ankle                |
50
| piri                      | Piriformis                     | Thigh Rotation                                   | Hip                  |
51
| psoas                     | Psoas Iliaco                   | Hip Rotation                                     | Hip                  |
52
| recfem                    | Rectus Femoris                 | Knee Extension                                   | Knee                 |
53
| sart                      | Sartorius                      | Hip and Knee Movement                            | Hip, Knee            |
54
| semimem                   | Semimembranosus                | Hip and Knee Movement                            | Hip, Knee            |
55
| semiten                   | Semitendinosus                 | Hip and Knee Movement                            | Hip, Knee            |
56
| soleus                    | Soleus                         | Plantar Flexion                                  | Ankle                |
57
| tfl                       | Tensor Fasciae Latae           | Knee Rotation                                    | Knee                 |
58
| tibant                    | tibialis anterior              | Plantar Dorsiflexion                             | Ankle                |
59
| tibpost                   | tibialis posterior             | Plantar Flexion and inversion                    | Ankle                |
60
| vasint                    | vastus intermedius             | Knee Extension                                   | Knee                 |
61
| vaslat                    | vastus lateralis               | Knee Extension                                   | Knee                 |
62
| vasmed                    | vastus medialis                | Knee Extension                                   | Knee                 |
63
| osl_knee_torque_actuator  | Knee Motor                     | Knee Flexion                                     | Knee                 |
64
| osl_ankle_torque_actuator | Ankle Motor                    | Ankle Flexion                                    | Ankle                |
65
66
67
## Joints/DoF Description:
68
| **Joint** | **Name**                        |
69
|-----------|---------------------------------|
70
| 1         | Hip Flexion Right               |
71
| 2         | Hip Adduction Right             |
72
| 3         | Hip Rotation Right              |
73
| 4        | OSL Knee Angle Right             |
74
| 5        | OSL Ankle Angle Right            |
75
| 6        | Hip Flexion Left                 |
76
| 7        | Hip Adduction Left               |
77
| 8        | Hip Rotation Left                |
78
| 9        | Knee Angle Left Translation 2    |
79
| 10        | Knee Angle Left Translation 1   |
80
| 11        | Knee Angle Left                 |
81
| 12        | Knee Angle Left Rotation 2      |
82
| 13        | Knee Angle Left Rotation 3      |
83
| 14        | Ankle Angle Left                |
84
| 15        | Subtalar Angle Left             |
85
| 16        | MTP Angle Left                  |
86
| 17        | Knee Angle Left Beta Translation 2 |
87
| 18        | Knee Angle Left Beta Translation 1 |
88
| 19        | Knee Angle Left Beta Rotation 1 |
89
90
## Muscles removed from trans-feromal leg
91
26 Muscles were removed according to the suggestions made in [1]. The removed muscles are listed in the table below:
92
93
| **Name in MyoLeg**        | **Real Name**                  | **Primary Function**                             | **Joint Movement**   |
94
|---------------------------|--------------------------------|--------------------------------------------------|----------------------|
95
| sart                      | Sartorius                      | Hip and Knee Movement                            | Hip, Knee            |
96
| recfem                    | Rectus Femoris                 | Knee Extension                                   | Knee                 |
97
| vasint                    | vastus intermedius             | Knee Extension                                   | Knee                 |
98
| vaslat                    | vastus lateralis               | Knee Extension                                   | Knee                 |
99
| vasmed                    | vastus medialis                | Knee Extension                                   | Knee                 |
100
| gaslat                    | Gastrocnemious Lateral         | Plantar Flexion, knee Flexion                    | Ankle                |
101
| gasmed                    | Gastrocnemious medial          | Plantar Flexion, knee Flexion                    | Ankle                |
102
| bflh                      | Bicep Femoral Long Head        | Thigh extension, rotation and Knee flexion       | Hip, Knee            |
103
| bfsh                      | Bicep Femoral Short Head       | Knee Rotation                                    | Knee                 |
104
| semimem                   | Semimembranosus                | Hip and Knee Movement                            | Hip, Knee            |
105
| semiten                   | Semitendinosus                 | Hip and Knee Movement                            | Hip, Knee            |
106
| addmagDist                | Adductor magnus distal         | Pelvis stabilizer                                | Hip, Knee            |
107
| addmagIsch                | Adductor magnus ischial        | Pelvis stabilizer                                | Hip, Knee            |
108
| addmagMid                 | Adductor magnus mid            | Pelvis stabilizer                                | Hip, Knee            |
109
| addmagProx                | Adductor magnus proximal       | Pelvis stabilizer                                | Hip, Knee            |
110
| grac                      | Gracilis                       | Thigh abduction, knee flexion                    | Hip, Knee            |
111
| tfl                       | Tensor Fasciae Latae           | Knee Rotation                                    | Knee                 |
112
| tibant                    | tibialis anterior              | Plantar Dorsiflexion                             | Ankle                |
113
| soleus                    | Soleus                         | Plantar Flexion                                  | Ankle                |
114
| edl                       | Extensor Digitorum Longus      | Digits movement                                  | Digits               |
115
| ehl                       | Extensor Hallucis longus       | Digits movement                                  | Digits               |
116
| perbrev                   | Peroneus Brevis                | Foot Eversion                                    | Ankle                |
117
| perlong                   | Peroneus Long                  | Foot Eversion                                    | Ankle                |
118
| tibpost                   | tibialis posterior             | Plantar Flexion and inversion                    | Ankle                |
119
| fdl                       | Flexor Digitorum Longus        | Digits movement                                  | Digits               |
120
| fhl                       | Flexor Hallucis Longus         | Digits movement                                  | Digits               |
121
122
[1] Raveendranathan, V., Kooiman, V. G. M., and Carloni, R., 2023, “Musculoskeletal Model of Osseointegrated Transfemoral Amputees in OpenSim,” PLOS ONE, 18(9), p. e0288864.
123
124
125
## ChangeLog