Page Comparison

...

...

...

(1) Before completing the tutorial, make sure you have reviewed the following readings from the User's Guide and completed the prerequisite tutorials.

(2) Install OpenSim version 4.0. 

...

In Study 1, you will load a model, create a setup file, and run Static Optimization. Then you will learn how to troubleshoot an under-actuated model.

...

Image Modified

Launch OpenSim and load the model subject01 included in the WorkingWithStaticOptimization folder. This is a simplified, planar, scaled gait model that has only a few degrees of freedom and lumped muscle groups (e.g., the medial gastrocnemius and lateral gastrocnemius are combined into a single gastrocnemius muscle).  Open the Static Optimization tool by choosing Tools > Static Optimization from the drop-down menu.

Image Modified

You must specify the three inputs to Static Optimization: (i) the model, (ii) the motion of interest, and (iii) any external forces (e.g., ground reaction forces). The tool is using the current model in the GUI (subject01), so you just need to input motion and any external forces. For the motion, you will use a previously calculated inverse kinematics result found in your working folder, subject01_walk_IK.mot. Leave the Filter Coordinates box unchecked (we'll come back to this in Study 2).  Set the Time Range to Process from 0.3 to 1.5 seconds For the Output Directory, add /ResultsSO to the current directory. On the 'Actuators and External Loads' tab, Check the External Loads box and then select subject01_walk_grf.xml as the External Loads. See here for more details about specifying external loads. Save the setup file as StaticOptimization_Setup.xml, then hit Run to begin the analysis.  The tool will now step through each time frame of the input motion. At each time, updating the model coordinates, external loads, and calculating the muscle forces and activations needed to generate the model's accelerations.

 

Image Modified

 

 

	Warning While the analysis was running (or when it was finished), you may have noticed the following output in the GUI's "Messages" window. You may have also seen that the analysis ran very slowly.
Image Modified	Once the Static Optimization tool has finished, the results are saved to your ResultsSO folder: Launch the plotter Select Y Quantity and choose Load file Navigate to the ResultsSO folder and select the file Scaled_Model_StaticOptimization_activation.sto Plot the Gastrocnemius muscle activations versus time for the right leg. Minimize the plot – we'll come back to it later.

 

What exactly is happening? This error message, "Optimizer Failed..." is informing you that the optimizer could not find an adequate solution at the time indicated. Remember that Static Optimization is trying to calculate activations and muscle forces that satisfy the model's coordinate accelerations calculated from the specified kinematics file. If the model's actuators cannot generate sufficient forces to match these accelerations, this "Optimizer Failed..." error will appear. The Static Optimization tool has produced a set of results to help with troubleshooting, but these outputs are not valid.

...

• Re-open the Static Optimization tool (if you have already closed it), and load your saved setup file. 
• You can add additional actuation by going to the Actuators input box in the Actuators and External Loads tab, clicking Edit... > Add and selecting the gait10dof18musc_Strong_actuators.xml from your working folder. The actuator file is a pre-made file that contains specifications for actuators for each coordinate in the model (i.e., reserves and residuals plus an actuator to control the lumbar extension degree of freedom).  
• We want to append these actuators to the existing set of muscles, rather than replacing the muscles, so select the button Append to model's force set
• Go to Main Settings, change the output directory to /ResultsSO_StrongActuators, so you don't print over your previous results. 
• Save this new version of the setup file and rerun the analysis. Looking into the GUI message window you will see that the last error message is now gone, meaning that the model can generate sufficient forces.

...

We now have a working Static Optimization analysis. A functioning analysis does not mean that the results are valid; rather, we have a place to start iterating from to improve the output. In the following studies, we will gradually improve the quality of the inputs to get a better result. Review the questions below to better understand the problems with the current set of results. 

...

1. ResultsSO: Static Optimization, no actuation, unfiltered IK motion. (from Study 1)
2. ResultsSO_StrongActuators: Static Optimization, with actuation, unfiltered IK motion. (from Study 1)
3. ResultsSO_StrongActuators_filtered: Static Optimization, with actuation, filtered IK motion.
4. ResultsSO_StrongActuators_RRA: Static Optimization, with actuation, RRA motion.

Questions

• Describe the changes in muscle activation for the three different motion inputs. 
• Why did the residual forces decrease from the Unfiltered to Filtered condition? Why did the residual forces decrease further when using the motion from RRA?
• Which kinematic input should be used for the Static Optimization analysis? Explain your reason(s).

...

The current actuators file has optimal forces of 100 N for each force actuator (i.e., residuals FX and FY) and optimal torques of 100 N-m for each torque actuator (i.e., residual MZ, and reserve coordinate actuators). When trying to minimize the sum of activations squared, the optimizer can use small activation values to these force and torque actuators generate large forces or torques. For example, with an optimal torque of 100 N-m, an activation of 0.5 will generate a torque of 50 N-m. If, instead, the optimal torque were 1 N-m, the optimizer must now use very high activations to produce any meaningful torques. In this latter case (optimal torque = 1) , an activation of 0.5 would only generate 0.5 N-m, and an activation of 50 is necessary to generate 50 N-m of torque. Thus, when the optimal force is very low (~1 N or 1 N-m) the optimizer can still choose to use the reserve actuators when needed, but the cost is so high relative to the muscles that the optimizer will preferentially use muscles to generate joint torques and only use the reserve actuators when the muscles cannot generate sufficient torque.

<optimal_force>100</optimal_force>

Questions:

• How do the Gastrocnemius muscle force change between the analysis using strong actuators (optimal force at 100) and the normal (optimal force at 1) actuators? What about the moment generated by the ankle actuators? If there are differences, explain why.
• How does the lumbar actuator reserve moment change between using the large vs. small optimal_force? Why might this be the case? (Hint: observe whether or not there are muscles that control the lumbar extension degree of freedom.)
• What is the peak Fx residual force? Why does the value stay the same between the strong and normal actuator case? (Hint: refer to the section earlier in the tutorial where we discuss why we need residual forces and moments. Are there other actuators in the model that could generate these forces?)

...

In this Study, you will add an ankle spring to the model and observe the effect on Gastrocnemius activation. Make sure you're using OpenSim 4.0 or a more recent version of the software.

...

Image Modified

The first step is to add a coordinate spring to the model. You will do this by running a GUI script that loads the current model, adds a coordinate spring to the right ankle, and saves it as a new model.  Close the Static Optimization tool pane if it's open. Load the RRA adjusted model subject01.osim in the GUI Click  Scripts > Run... Select the Script file addAnkleSpring.py A new model will appear in the GUI. In the navigator pane, notice the name of the model now has 'ankle_spring' appended. Expand the model hierarchy to find the spring under Forces>Other Forces. From the Property Editor, you can observe and edit the spring's properties. For example, You will be able to see that the spring name is 'AnkleLimitSpringDamper'. Also, observe that a new model has been saved to your WorkingWithStaticOptimization folder called 'subject01_spring.osim'.

Now that you have a new model with an ankle spring, you will re-run the Static Optimization analysis using the same setup from Study 3 (with normal reserve actuators). Rename the output folder to \ResultsSO_NormalActuators_RRA_Spring

Image Modified	Plot the AnkleLimitSpringDamper moment from the file Scaled_Model_StaticOptimization_force.sto
Image Modified	Plot the Gastrocnemius activation from the analyzes with and without the Spring (the results should be in the folder ResultsSO_NormalActuators from Study 4 and the latest folder, ResultsSO_Spring)

Questions:

• Why did the Gastrocnemius activation decrease when the ankle spring was added?
• Optional: try increasing or decreasing the spring stiffness. How does this affect the Gastrocnemius activation? 
• Optional: are any other muscle affected by adding the ankle spring?

References

1. Hicks J.L., Uchida T.K., Seth A, Delp S.L. (2015).  Is My Model Good Enough? Best Practices for Verification and Validation of Musculoskeletal Models and Simulations of Movement. Journal of Biomechanical Engineering, 137(2)