Work Description
Title: Perturbative Sit-to-Stand Experiment Dataset and Stability Basin Code Open Access Deposited
Attribute | Value |
---|---|
Methodology |
|
Description |
|
Creator | |
Depositor |
|
Contact information | |
Discipline | |
Funding agency |
|
Keyword | |
Citations to related material |
|
Resource type | |
Last modified |
|
Published |
|
Language | |
DOI |
|
License |
|
(2019). Perturbative Sit-to-Stand Experiment Dataset and Stability Basin Code [Data set], University of Michigan - Deep Blue Data. https://doi.org/10.7302/mhjr-k798
Relationships
- This work is not a member of any user collections.
Files (Count: 2; Size: 728 MB)
Thumbnailthumbnail-column | Title | Original Upload | Last Modified | File Size | Access | Actions |
---|---|---|---|---|---|---|
README.md | 2019-12-13 | 2019-12-13 | 4.06 KB | Open Access |
|
|
STS_SB.zip | 2019-12-13 | 2019-12-13 | 728 MB | Open Access |
|
STS_SB
Stability Basins for characterizing stability of sit-to-stand control strategies
paper: https://arxiv.org/abs/1908.01876
keywords: Sit-to-Stand, Biomechanics, Stability
Overview
This repository contains MATLAB code for generating and validating Stability Basins (SB) for sit-to-stand (STS).
SBs are a model-based method for determining the set of perturbations that would cause an individual to step, sit, or fall during STS under a given motor control strategy. The SB corresponds to the set of body configurations that do not lead to failure during STS, and characterizes stability throughout the duration of the motion
We conducted a perturbative STS experiment (dataset included in repo) where subjects were pulled by motor-driven cables during STS.
We had subjects perform STS using three different strategies: Natural, Momentum-Transfer, and Quasi-Static.
Subjects sometimes stepped or sat in response to perturbation, as demonstrated in the figure below:
Individualized biomechanical models of STS are constructed for each subject, and kinematic data is translated into trajectories of these models.
Subject and strategy specific input bounds are formed from data.
Then, we use a reachability toolbox called CORA to compute the SB for a given subject and STS strategy.
The SB is the backwards reachable set of a standing set, under the model's dynamics and input bounds:
Finally, we evaluate the accuracy of SBs by using them to predict whether or not an STS trial will succeed or fail (e.g., the subject will take a step or sit).
These predictions are compared to experimentally observed results.
Installation
MATLAB Version
- R2019b ### Clone
- Clone this repo to your local machine using
https://github.com/pdholmes/STS_SB
- Note that the version hosted on Deep Blue Data is commit# a28d7b3 ### Downloads
- To use this code, first download CORA 2018: https://tumcps.github.io/CORA/
More information about CORA and how to use it may be found here: https://tumcps.github.io/CORA/data/Cora2018Manual.pdf
We also recommend using MOSEK (https://www.mosek.com) in place of MATLAB's default linear program solver
linprog
, though this is not necessary.Setting Path
Ensure that CORA (and MOSEK, if downloaded) are on the MATLAB path. For example, use the MATLAB command
addpath(genpath('.../path/to/CORA_2018'));
GUI
To simply view presaved results of the SB evaluation in a table, use
display_results()
.A GUI for visualizing the STS trials, the SBs, and their predictions is provided. To run this GUI, use
animateSTS
.
Generating Results from Scratch
If you would like to run the full pipeline and generate the results from scratch on your own machine:
1) RunsetPaths()
.
2) Userun_all()
. We recommend callingrun_all('parallel')
to utilize MATLAB's parfor toolbox and expedite the process.
3) Uncomment line 5 indisplay_results
and line 5 inanimateSTS
to use your locally generated results instead of the presaved results.
4) Calldisplay_results
oranimateSTS
to display the accuracy of each of the tested SB methods onscreen.Team
Patrick Holmes (PhD Candidate, Mechanical Engineering, University of Michigan)
Shannon Danforth (PhD Candidate, Mechanical Engineering, University of Michigan)
Xiao-Yu Fu (PhD Candidate, Mechanical Engineering, University of Michigan)
Talia Y. Moore (Assistant Research Scientist, Robotics Institute, University of Michigan)
Ram Vasudevan (Assistant Professor, Mechanical Engineering and Robotics Institute, University of Michigan)
License
Code licensed under BSD3
STS Data licensed under CC BY 4.0