Users can upgrade to OpenSim 3.1 from OpenSim 3.0 without any major changes to their models or simulation workflows. A few upgrade notes for users:
1) Several objects and functions have been deprecated in OpenSim 3.1. Although the following objects and functions are still available in OpenSim, we advise removing them from your code and workflows since they will be removed in future releases:
- The use of control constraints for RRA has been deprecated. This option is no longer exposed in the GUI, although old setup files with control constraints will still work as in previous releases. Users should set appropriate limits via the actuator file. For an example, see the gait2354 example included with the release of 3.1.
- In GUI scripting, the function addModel is deprecated. Users should switch to loadModel.
- In both Matlab and GUI scripting, OpenSimContext, PropertyHelper, and ArrayDouble are deprecated. These helper functions are no longer necessary since Simbody classes such as State and Vec3 have been exposed. For more information, see Common Scripting Commands.
- In Matlab scripting, the setDebugLevel method is no longer necessary. Messages are automatically logged.
- Users should call updWorkingState rather than updDefaultState.
- Several methods were moved from SimbodyEngine to Model. See the doxygen for more information. Users should switch to these new functions.
2) We have updated the main gait examples (2354 and 2392):
- Converted to Millard muscles.
- Removed control constraints for RRA and CMC (these files are redundant since all properties can be specified in the Actuators file).
- Eliminated specification of kinematics for external loads (not necessary).
3) In the GUI, the option "Preview motion data…" (in the File menu) has been changed to "Preview experimental data…" to reduce confusion with loading motions (.mot or .sto files in the OpenSim format).
4) We made several updates to the Millard muscles, though these updates should have minimal impact on users:
- Muscle curves are handled as OpenSim functions (to allow for plotting in the GUI via scripting).
- Function integrals are only calculated if needed, speeding up computation time.
5) The interface to MuscleMetabolicPowerProbeUmberger2010 has evolved during the preparation for the official release of OpenSim 3.1. Users of the metabolic probes in earlier beta releases of the software should load models containing metabolic probes in the OpenSim GUI and resave to update.
