This JavaScript application enables biomechanics researchers to visualize and analyze shoulder joint kinematics. It is built on top of three.js, a JavaScript 3D library. Although presently this application is specialized for analyzing and visualizing the shoulder joint, it should be easy to extend its functionality to other joints.
Kinematics-Vis has been peer-reviewed and accepted into the Journal of Open Source Software. Checkout the associated paper:
Also, checkout the live code demo currently hosted at the University of Utah Center for High Performance Computing.
This repository depends on Yarn as a package manager. Please install Yarn before proceeding.
git clone https://github.com/klevis-a/kinematics-vis.git
cd kinematics-vis
yarn install
yarn build
yarn fetch_data
yarn webpack serve
http://localhost:9000/main.html
Instructions for interacting with the UI are provided within the web application. Once you access the web app click the question mark that appears at the top of the upper right quadrant. A simple way to provide an input dataset for the web app is to utilize the sample dataset (yarn fetch_data). Once the sample dataset has been downloaded, click the folder icon (top of the upper left quadrant), and select a trial to analyze.
To analyze your own data see INPUT_FILES.md for creating file formats compatible with this web app. To specify your own dataset directory edit the DATA_DIR variable within webpack.config.js.
See MANUAL_TESTING.md for a list of test cases that cover the basic functionality of the user interface.
See the CONTRIBUTING document for details on contributing to the project by reporting a bug, submitting a fix, or proposing new features.