explaingit

markmamed/imu-surgical-intention-perception

Analysis updated 2026-05-18

31PythonAudience · researcherComplexity · 4/5Setup · hard

TLDR

A research codebase that predicts a surgeon's current task from IMU motion-sensor data, aiming to support surgical assistant exoskeletons that react to the operator's intent.

Mindmap

mindmap
  root((IMU intent))
    What it does
      Predicts surgical task
      Reads IMU sensor data
      Feeds surgical exoskeleton
    Tech stack
      Python
      XGBoost
      RandomForest
      scikit-learn
    Datasets
      JIGSAWS
      Opportunity
      NinaPro
      PAMAP2
    Use cases
      Surgical task recognition
      Model training and inference
      Performance visualization

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Train a classifier that predicts which surgical subtask (knot tying, needle passing, suturing) is happening from IMU sensor data.

USE CASE 2

Run inference on new IMU CSV recordings to label surgical activity in real time.

USE CASE 3

Generate charts and dashboards visualizing model accuracy and activity transitions over a surgical session.

What is it built with?

PythonXGBoostRandomForestscikit-learn

How does it compare?

markmamed/imu-surgical-intention-perceptionhuta0kj/skill-scanner-agentkkdai/linebot-multimodal-rag
Stars313131
LanguagePythonPythonPython
Setup difficultyhardmoderatehard
Complexity4/53/54/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Needs Python plus the public IMU datasets fetched and laid out correctly before training or inference works.

No license information is provided in the README.

In plain English

This Python project is a machine learning system designed to recognize a surgeon's intentions during an operation by reading motion data from IMU sensors, small devices that measure movement, acceleration, and rotation. The goal is to understand what surgical gesture or task a surgeon is performing in real time, which could feed into a robotic surgical assistant or exoskeleton that adapts to the operator's next move. The system is trained on several publicly available motion datasets including JIGSAWS, which contains recordings of surgical tasks like knot tying, needle passing, and suturing. It extracts features from the sensor data, such as speed, acceleration, and how both hands move together, and trains machine learning classifiers to predict which surgical subtask is currently happening. The README reports that the best model combination currently reaches about 84% accuracy on held-out test data. The project includes tools for training, running predictions on new CSV sensor files, and generating charts that visualize how the model performs and how a surgeon's activity transitions over time. It is a research codebase from Peking University Health Science Center.

Copy-paste prompts

Prompt 1
How do I train the IMU intent classifier on the JIGSAWS surgical dataset using this repo's config files?
Prompt 2
Explain how this project extracts motion features like speed, acceleration, and hand coordination from IMU sensor data.
Prompt 3
Show me how to run infer_from_csv.py on a new IMU recording and interpret the output predictions.
Prompt 4
What does the visualization gallery in this repo show about model performance across datasets?

Frequently asked questions

What is imu-surgical-intention-perception?

A research codebase that predicts a surgeon's current task from IMU motion-sensor data, aiming to support surgical assistant exoskeletons that react to the operator's intent.

What language is imu-surgical-intention-perception written in?

Mainly Python. The stack also includes Python, XGBoost, RandomForest.

What license does imu-surgical-intention-perception use?

No license information is provided in the README.

How hard is imu-surgical-intention-perception to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is imu-surgical-intention-perception for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.