BOPS performs batch processing of common OpenSim procedures (Inverse Kinematics - IK, Inverse Dynamics - ID, Muscle Analysis - MA, Static Optimization - SO, and Joint Reaction Analysis - JRA) and stores output, logging information, setup files, and plots in an ordered structure of folders.

We implemented BOPS using OpenSim APIs, that receive the following information through setup files: (i) name and weight of each marker (IK); (ii) external loads (ID); (iii) muscles and moment arms of interest (MA); (iv) static optimization conditions and muscle actuators loads (SO); (v) joints of interest (JRA). The user is in charge of defining the appropriate configuration for its data, but we already provide several templates for each setup file to speed up their customization.

A MATLAB graphical user interface (GUI) is available to simplify the execution of procedures. The use of the GUI is not limited in selecting the setup files. The user can also input: (i) the OpenSim procedures to execute, (ii) the trials to process, (iii) the OpenSim model to use on the simulations, (iv) the cut-off frequencies for the filtering, (v) the residual actuators, (vi) the output variables to plot and the x-axis label.

BOPS stores its outputs in folders that are automatically created. These folders integrate perfectly in the structure provided by MOtoNMS software (https://simtk.org/home/motonms). We designed the two tools to work in close cooperation to transform the data collected in a motion analysis laboratory into inputs for OpenSim and CEINMS (https://simtk.org/home/ceinms) tools.

BOPS is an open project, released under Apache v2.0 License and hosted in GitHub. An archive of the latest release is freely available from the SimTK project page: https://simtk.org/home/bops together with a dataset to play with.

For a first introduction, please refer to this README file. For a complete overview on how to use BOPS v2.0, a tutorial video can be downloaded from the SimTK project page.

1. Configure MATLAB for the use of OpenSim API (follow the instructions available here)

2. Unzip the archive of BOPS (available here)

This release includes three directories:

• src: BOPS source code
• Templates: XML setup files for OpenSim IK, ID, MA, SO, JRA tools, and for configuration of output plots.
• TestData: Example datasets from different laboratories. Users are provided with the same data available in MOtoNMS (available also here) plus scaled .osim models.

1. Set MATLAB path to BOPS/src folder
2. Run BOPSgui.m

BOPS requires an input folder for its execution. Please select a dynamicElaborations folder created by MOtoNMS tool (or set it manually). If you are not familiar with this folder structure you can refer to the [MOtoNMS User Manual] 5.

The use of the GUI is not mandatory. Advanced users can create a main.m script and call directly the functions. An example with some notes is provided.

• Install BOPS in a folder that you can modify. Therefore, DO NOT install BOPS in Administrator folders, such as the Program Files folder;
• File Paths MUST NOT include blank spaces due to a limitation in OpenSim SO.

• If you need help using BOPS, please ask your questions in the BOPS Public Forum, available from the SimTK project page: https://simtk.org/home/bops, or send an email to ali.mantoan@gmail.com and bruno.bedo@usp.br
• You can send BOPS bug reports to ali.mantoan@gmail.com, bruno.bedo@usp.br
• For any ideas about potential improvement or custom needs, please contact danilo.catelli@uottawa.ca and ali.mantoan@gmail.com
• If you want to participate in developing BOPS and/or you are interested in collaborations, please send an email to monica.reggiani@gmail.com, danilo.catelli@uottawa.ca and mlamon@uottawa.ca

Copyright (C) 2020 Bruno Bedo, Danilo Catelli, William Cruaud, Mario Lamontagne

Copyright (C) 2015 Alice Mantoan, Monica Reggiani

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

 http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

When using BOPS, please acknowledge the authors.

========