PI CSIC

Copyright CSIC & Tecnalia 2020

This is an example of Performance Indicator implemented in Octave. It is prepared to be used within the Eurobench Benchmarking Software.

Purposes

Characterize the gait performances of a walking human subject (step length, step and stride time), based on the observed joint angles. More technical details provided within the code README

Installation

To enable the code under octave, additional packages are needed.

sudo apt-get install liboctave-dev

Follow these recommendations to make the installation of the additional packages needed:

• control
• signal
• mapping
• io
• statistics

Once octave is configured:

pkg load signal
pkg load mapping
pkg load statistics

Note that all these installation steps can be run following the RUN command of the Dockerfile:

sh ./install.sh
wget -O control-3.2.0.tar.gz https://octave.sourceforge.io/download.php?package=control-3.2.0.tar.gz \
wget -O statistics-1.4.1.tar.gz https://octave.sourceforge.io/download.php?package=statistics-1.4.1.tar.gz \
wget -O io-2.4.12.tar.gz https://octave.sourceforge.io/download.php?package=io-2.4.12.tar.gz \
wget -O signal-1.4.1.tar.gz https://octave.sourceforge.io/download.php?package=signal-1.4.1.tar.gz \
wget -O mapping-1.2.1.tar.gz https://octave.sourceforge.io/download.php?package=mapping-1.2.1.tar.gz
./package_install.m

Usage

The script run_pi launches this PI from the shell of a machine with octave installed. The permissions of this file must be changed in order to be executable:

chmod 755 run_pi

Assuming folder ./test_data/input/ contains the input data, and that ./test_data/output exists and will contain the resulting files, the shell command is:

./run_pi ./test_data/input/subject_10_trial_01.csv ./test_data/input/subject_10_anthropometry.yaml ./test_data/output

At this moment the script accepts two arguments (not less, not more).

Build docker image

Run the following command in order to create the docker image for this PI:

docker build . -t pi_csic_docker_image

Launch the docker image

Assuming the test_data/input/ contains the input data, and that the directory test_data/output/ is created, and will contain the PI output:

docker run --rm -v $PWD/test_data/input:/in -v $PWD/test_data/output:/out pi_csic_docker_image ./run_pi /in/subject_10_trial_01.csv /in/subject_10_anthropometry.yaml /out

Acknowledgements

Supported by Eurobench - the European robotic platform for bipedal locomotion benchmarking. More information: Eurobench website

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement no. 779963.

The opinions and arguments expressed reflect only the author‘s view and reflect in no way the European Commission‘s opinions. The European Commission is not responsible for any use that may be made of the information it contains.