Join members of the OpenSim Team on Wednesday July 26th for an introduction to OpenSim and new tools for rapidly developing musculoskeletal simulations.

...

1. Open the Anaconda Prompt

2. Create environment (python 3.10 recommended)

   Code Block
   (base) C:\Users\me> conda create -n opencap-processing python=3.10

   
   

3. Activate environment

   Code Block
   (base) C:\Users\me> conda activate opencap-processing

   
   

4. Install OpenSim within environment

   Code Block
   (opencap-processing) C:\Users\me> conda install -c opensim-org opensim=4.4.1=py310np121

   
   

5. (Optional): Install an IDE such as Spyder (you can use any IDE or run code from the terminal)

   Code Block
   (opencap-processing) C:\Users\me> conda install spyder

   
   

6. Clone/download the repository to your machine
   1. Using Git

      1. Navigate to the directory where you want to download the code. For example:

         Code Block
         (opencap-processing) C:\Users\me> cd Documents

         
         

      2. Clone the repository

         Code Block
         (opencap-processing) C:\Users\me\Documents> git clone https://github.com/stanfordnmbl/opencap-processing.git

         
         

   2. Without using Git
      
      1. Download the repository by visiting https://github.com/stanfordnmbl/opencap-processing/archive/refs/heads/main.zip
      2. Unzip the folder
         • We will assume your PATH looks like C:\Users\me\Documents\opencap-processing and that the path to the README file is C:\Users\me\Documents\opencap-processing\README.md
7. Install required Python packages

   1. Navigate to the repository (make sure you are in Documents)

      Code Block
      (opencap-processing) C:\Users\me\Documents> cd opencap-processing

      
      

   2. Install packages

      Code Block
      (opencap-processing) C:\Users\me\Documents\opencap-processing> python -m pip install -r requirements.txt

      
      

8. Create environment variable for authentication, you will be prompted to provide your OpenCap credentials. An environment variable (.env file) will be saved after authenticating.

   Code Block
   (opencap-processing) C:\Users\me\Documents\opencap-processing> python createAuthenticationEnvFile.py

   
   

9. Run example.py to verify that everything was correctly installed so far. If you get some plots popping out, then you can proceed to step 10.

   Code Block
   (opencap-processing) C:\Users\me\Documents\opencap-processing> python example.py

   
   

10. If you're a Mac user, you can stop here. If you're on Windows or Linux, you'll need this extra step. This part of the workshop will involve running dynamic simulations of walking using OpenSimAD, which is a custom version of OpenSim with support for Automatic Differentiation (AD). OpenSimAD requires a compiler, which is not installed by default on Windows, and the OpenBLAS libraries, which you need to manually install on Linux.

    1. (Windows only): Install Visual Studio

       1. The Community variant is sufficient and is free for everyone.

       2. During the installation, select the workload Desktop Development with C++.

       3. The code was tested with the 2017, 2019, and 2022 Community editions.

    2. (Linux only): Install OpenBLAS libraries

       Code Block
       sudo apt-get install libopenblas-base

       
       

11. Run Examples/example_walking_opensimAD.py to verify that everything was correctly installed so far. If you see some IPOPT iterations, then you're all set. We'll go through the example during the workshop.

    Code Block
    (opencap-processing) C:\Users\me\Documents\opencap-processing> cd Examples (opencap-processing) C:\Users\me\Documents\opencap-processing\Examples> example_walking_opensimAD.py

    
    

12. (Optional): Download the processed example data from Demo #2 as reference. The folder name (4d5c3eb1-1a59-4ea1-9178-d3634610561c) is the identifier of the session. If you follow all the steps of the workshop, files will be downloaded/generated under opencap-processing/Data/4d5c3eb1-1a59-4ea1-9178-d3634610561c. If you run into issues during the workshop (eg, when compiling files), you can download the processed example data and copy them under ./opencap-processing/Data/4d5c3eb1-1a59-4ea1-9178-d3634610561c (make sure the path to the metadata file looks like: opencap-processing/Data/4d5c3eb1-1a59-4ea1-9178-d3634610561c/sessionMetadata.yaml). This should allow you to complete the workshop.

Part 2: AddBiomechanics

1. Create account

...

Slides

Coming soon!

Publications

Uhlrich SD, Falisse A, Kidzinski L, Muccini J, Ko M, Chaudhari AS, Hicks JL, Delp SL (2022) OpenCap: 3D human movement dynamics from smartphone videos. bioRxiv. https://doi.org/10.1101/2022.07.07.499061

Werling K, Bianco NA, Raitor M, Stingel J, Hicks JL, Collins SH, Delp SL, Liu CK (2023) AddBiomechanics: Automating model scaling, inverse kinematics, and inverse dynamics from human motion data through sequential optimization. bioRxiv. https://doi.org/10.1101/2023.06.15.545116

Dembia CL, Bianco NA, Falisse A, Hicks JL, Delp SL (2020) OpenSim Moco: Musculoskeletal optimal control. PLoS Comput Biol 16(12): e1008493. https://doi.org/10.1371/journal.pcbi.1008493

...