/MotorEndplate

motor endplate detection using ultrafast ultrasonud imaging ⚡

Primary LanguageJupyter Notebook

Detection of motor endplates using ultrafast ultrasound

GitHub stars GitHub forks
License: Apatche-2 GitHub contributors

Repository Structure

This repository provides code and datasets for ultrafast ultrasound investigations on an electrically stimulated medial gastrocnemius muscle.

1. Code

  • MotorEndplate\functions folder includes the used functions (eg. Butterworth lowpass filter)
  • MotorEndplate\SPTtracker.m is the Matlab script to execute sampling point tracking. This program will return the sampling point coordinates along a chosen facile line for each investigated timestep.
  • MotorEndplate\MEP_extraction.ipynb is Jupyter notebook for MEP extraction. The script inputs filtered x and y displacements (as .csv files) and outputs starting time of the contraction for each sampling point. To run the script, please, meet the requirements listed below.

2. Requirements

  • For Python code please use the version 3.6.1 of the interpreter and install all the packages listed in requirements.txt.

3. Dataset

The high frame rate ultrasound recording (1500 Hz) of an electrically stimulated medial gastrocnemius contraction can be downloaded from: google drive (679 MB). The provided dataset (MGcontraction.avi) is licensed under a Creative Commons Attribution 4.0 International License.

CC BY 4.0

4. Add-On's

  • We used pybf to reconstruct ultrasound images from radio frequency data. This python based delay-and-sum beamformer is available for open-sorce use here: pybf
  • MotorEndplate\figures folder includes all result plots and figures of the IEEE-IUS 2020 publication in high resolution.

Credits

"do, ut des"...if we could assist you with this code and dataset please cite our work:

@inproceedings{Leitner2020,
   title={{Detection of Motor Endplates in Deep and Pennate Skeletal Muscles in-vivo using Ultrafast Ultrasound},
   author={Christoph Leitner and Sergei Vostrikov and Harald Penasso and Pascal A. Hager and Andrea Cossettini and Luca Benini and Christian Baumgartner},
   booktitle={in Proc. of the IEEE International Ultrasonic Symposium},
   venue={Las Vegas,USA},
   publisher={IEEE},
   month=09,
   year={2020}  
}

License

This program is free software and licensed under the Apache License 2.0 - see the LICENSE file for details.