--- a +++ b/Docs/body/shoulder_arm_model.md @@ -0,0 +1,200 @@ +# The Shoulder Arm Model + +The ShoulderArm model contains data from two different persons. Most of this data +comes from the Dutch Shoulder Group and their +[shoulder model available online](https://web.archive.org/web/20150707202425/http://homepage.tudelft.nl/g6u61/repository/shoulder/overview.htm) + + +:::{versionadded} 2.2 +A new wrapping implementation of the deltoid muscles was added by Marta Strzelczak from École de technologie supérieure, Montreal, CA. See {ref}`DeltoidWrapping` below. +::: + +The model is built using data from subject 2 from the VU study and subject 2 +from the MAYO study. The files, which contains the name "forearm", are +built on data from the MAYO study. + +The shoulder is a complex joint with mutually coupled motions of the scapula, +clavicle and the humerus. To balance realism with model simplicity, the model +defines motions of the scapula and clavicle as mathematical functions of the +glenohumeral joint angles, also known as a "Shoulder rhythms". + +The AnyBody shoulder model's rhythm can be switched on +and off, the full details of which can be seen in this report +[Shoulder Rhythm +Report](https://paperpile.com/shared/sQXLyvQsQRfauvB5T9lxyqg). + +```{raw} html +<video width="45%" style="display:block; margin: 0 auto;" controls autoplay loop> + <source src="../_static/ShoulderArm_rotating_model.mp4" type="video/mp4"> +Your browser does not support the video tag. +</video> +<!--<img src="../_static/ShoulderCloseupBack.jpg" alt="Smiley face" width="45%">--> +``` + + +## Example Configuration + +Short example of how to configure the Shoulder Arm model: + +```AnyScriptDoc +#define BM_ARM_RIGHT ON +#define BM_ARM_LEFT ON +#define BM_ARM_SHOULDER_RHYTHM ON + +#define BM_ARM_MUSCLE _MUSCLES_3E_HILL_ +``` + + +:::{seealso} +:class: margin +See {doc}`Arm configuration parameters <../bm_config/arm>` for a +full list of configuration parmaeters or {doc}`configuration section <../bm_config/index>` +for more information on BM parameters. +::: + + + +% .. Image:arm.png + +(deltoidwrapping)= + +## Deltoid wrapping + +An wrapping implementation of the deltoid muscles have been added after the +model was first built. The implementation uses multiple wrapping cylinders for +each element of the deltoid muscle. The new approach ensures a more realistic +path of the muscle fibers compared to the previous implementaiton which used a +dedicated rake segment to hold the detoid fibers in place. + +```{raw} html +<video width="45%" style="display:block; margin: 0 auto;" controls autoplay loop> + <source src="../_static/new_deltoid_wrapping.mp4" type="video/mp4"> +Your browser does not support the video tag. +</video> +``` + +Deltoid wrapping can be disabled/enabled with the switch +{ammr:bm_statement}`BM_ARM_DELTOID_WRAPPING`. + +The deltoid wrapping was developed by Marta Strzelczak from Département de +génie de la production automatisée, École de technologie supérieure, Montreal, +CA. Please cite the following work if you need it: + +> Strzelczak, M., Lund, M. E., Sins, L., Mickael, B. & Hagemeister, N. A new +> wrapping approach for the deltoid muscle modelling. in The Proceedings of the +> 20th Biennial Meeting of theCanadian Society for Biomechanics (2018). + +## Degrees of freedom + +The arm has the following basic dof, which can be controlled by combinations +joint drivers directly or indirectly through connections to the environment + +- SternoClavicularProtraction +- SternoClavicularElevation +- SternoClavicularAxialRotation +- GlenohumeralFlexion +- GlenohumeralAbduction +- GlenohumeralExternalRotation +- ElbowFlexion +- ElbowPronation +- WristFlexion +- WristAbduction + +## Joint terminology + + +The model consists of the following joints: + +**Joints and kinematic contraints of the arm model** + +```{eval-rst} + +================================ ====================== =============================================================== +Name Description Joint/Constraint Type +================================ ====================== =============================================================== +SternoClavicularJoint SternoClavicular Spherical joint +AcromioClavicularJoint AcromioClavicular Spherical joint +GlenoHumeralJoint Glenohumeral joint Spherical joint (The default joint reactions are + disabled, since they do not automatically ensure that + the net force vector passes through the glenoid cavity. + The special force elements providing these biofidelic + reaction forces are contained in the file "GHReactions.any") +AI One DOF constraint requiring the bony landmark + AI on the scapula, to stay in contact with the thorax +AA One DOF constraint requiring the bony landmark + AA on the scapula, to stay in contact with the thorax +ConoideumLigament The length of this ligament is driven + to always remain constant +HumeroUlnarJoint Flexion-extension Revolute joint + of the elbow +HumeroRadialJoint Pronation-supination Single linear constraint (5 DOF joint) between radius + and humerus +ProximalRadioUlnarJoint Pronation-supination Trans Spherical joint between radius and ulna at the + proximal part. +DistalRadioUlnarJoint Pronation-supination Trans Spherical joint between radius and ulna at the + proximal part. The HumeroRadialJoint, ProximalRadioUlnarJoint + DistalRadioUlnarJoint leaves one DOF free which is + pronation/supination of the forearm +Wrist joint Two successive revolute joints where + the axes of rotations are not coincident +================================ ====================== =============================================================== + +``` + + +## Resources + +More details on the ShoulderArm model can be found online: + +- Webcast: [Validation of the AnyBody version of the Dutch Shoulder Model by the in-vivo measurement of GH contact forces by Bergmann et al.](https://www.anybodytech.com/download/validation-of-the-anybody-version-of-the-dutch-shoulder-model-by-the-in-vivo-measurement-of-gh-contact-forces-by-bergmann-et-al/) + +## Anatomy References + +- F.C.T. van der Helm and R. Veenbaas, Modeling the mechanical efect of + muscles with large attachment sites: aplication to the shoulder + mechanism. Journal of Biomechanics, vol. 24, no. 12, pp. 1151-1163, + 1991 +- H.E.J. Veeger, F.C.T. van der Helm, L.H.V. van der Woude, G.M. Pronk + and R.H. Rozendal, Inertia and muscle contraction parameters for + musculoskeletal modelling of the shoulder mechanism. Journal of + Biomechanics, vol. 24, no. 7, pp. 615-629, 1991 +- F.C.T. van der Helm, A finite element musculoskeletal model of the + shoulder mechanism. Journal of Biomechanics, vol. 27, no. 5, pp. + 551-569, 1994 +- R. Happee and F.C.T. Van der Helm, The control of shoulder muscles + during goal directed movements, an inverse dynamic analysisJ. + Biomechanics, vol. 28, no. 10, pp. 1179-1191, 1995 +- Van der Helm FC, Veeger HE, Pronk GM, Van der Woude LH, Rozendal RH. + Geometry parameters for musculoskeletal modeling of the shoulder + system Journal of biomechanics Vol. 25 no. 2, pp. 129-144, 1992 Note: + this reference is used for the geometry used for the definition of + many of the geometries which are used for muscle wrapping +- DirkJan (H.E.J.) Veeger, Bing Yu, Kai Nan An, Orientation of axes in + the elbow and forearm for biomechanical modeling Proceedings of the + first conference of the ISG,1997 +- The segment coordinatesystem are according to the ISB proposal, + please see + <https://media.isbweb.org/images/documents/standards/frans_c.t._van_der_helm_shoulder_protocol.pdf> +- H.E.J. Veeger, Bing Yu, Kai-Nan An and R.H. Rozendal, Parameters for + modeling the upper extremity, Journal of Biomechanics, Vol. 30, No. + 6, pp. 647-652, 1997 +- H.E.J. Veeger, F.C.T. van der Helm, L.H.V. van der Woude, G.M. Pronk + and R.H. Rozendal,Inertia and muscle contraction parameters for + musculoskeletal modelling of the shoulder mechanism. Journal of + Biomechanics, vol. 24, no. 7, pp. 615-629, 1991 + +## Muscle References + +- Jacobson, M. D., R. Raab, B. M. Fazeli, R. A. Abrams, M. J. Botte, + and R. L. Lieber. Architectural design of the human intrinsic hand + muscles. J. Hand Surg. \[Am.\] 17:804809, 1992. +- Lieber, R. L., M. D. Jacobson, B. M. Fazeli, R. A. Abrams, and M. J. + Botte. Architecture of selected muscles of the arm and forearm: + Anatomy and implications for tendon transfer. J. Hand Surg. \[Am.\] + 17:787-798, 1992. +- Lieber, R. L., B. M. Fazeli, and M. J. Botte. Architecture of + selected wrist flexor and extensor muscles. J. Hand Surg. \[Am.\] + 15:244-250, 1990. +- Muray, W.M.,T.S. Buchanan, and S.L. Delp. Scaling of peak moment arms + with the elbow and forearm position J. Biomech. Vol. 28, pp. 513-525, + 1995