Muscle Wrapping 2.0¶

Muscle Wrapping 2.0 is a project that aims to develop OpenSim(https://simtk.org/projects/opensim) compatible models and methods for wrapping the muscles, represented by their triangular surface models, around the moving bones and decomposing the output muscles into mechanical lines of action for consequent biomechanical analyses.

System components¶

Project currently contains two main applications (OsimMuscleGeneratorTool, a plugin for OpenSim 4.0 software, and AttachmentEstimation, a tool for estimating the attachments of muscles on the bones), several examples and tests, and cadaver data for experimenting. The software architecture is schematically illustrated in the following figure. The library is described in more detail in the section Build .

Testing architecture¶

The following scenario chronologically describes the possible architecture of our tests.

• Verification testing: The first step is to ensure that the software is working as expected. This can be achieved through verification testing, which involves running the software with a known input and verifying that the output is as expected. ( It is also one of our requirements)
• Validation testing : The next step is to validate that the software is producing accurate results. This can be achieved through validation testing, which involves comparing the output of the software with experimental data or data from other validated sources.
• Performance testing : The software should also be tested for its performance, including speed, scalability, and memory usage. This can be achieved through performance testing, which involves running the software under different loads and measuring its performance metrics. During these tests we will also identify weak points to focus on for optimization in TSP2.
• Usability testing : The software should be tested for its ease of use and user-friendliness. This can be achieved through usability testing, which involves having client interact with the software and providing feedback on its usability.
• Regression testing : Regression testing should be conducted after any changes or updates to the software to ensure that the changes have not introduced any new bugs or issues.

OsimMuscleGeneratorTool Guide¶

OsimMuscleGeneratorTool is a plugin for OpenSim 4.0. Taking an OpenSim musculoskeletal model and motion data as an input, it generates an arbitrary number of lines of action (fibres) composed of a user-defined number of straight-line segments for each skeletal muscle having known surface geometry and attachment areas. The outputs are the fibre lengths and moment arms for corresponding coordinates (changing according to the motion). Optionally, the plugin produces an OpenSim model in which the fibres are represented as actuators with predefined geometry paths.

The plugin is used from the command line as:

opensim-cmd.exe -L "OsimMuscleGeneratorTool.dll" run-tool setup_muscleGeneratorTool.xml

where setup muscleGeneratorTool.xml is the file containing the configuration of the plugin. Please make sure that the configuration, the plugin and all its dependencies are on path, or specify full paths.

e.g. - C:\Work\setup_muscleGeneratorTool.xml

The syntax of the plugin configuration file is visible in example present in Data folder. A short overview is also visible on(https://www.youtube.com/watch?v=BW_jjCcbf5o).

Build¶

Application build is described in detail here Build