ErgoMoCap User Guide

ErgoMoCap is a tool that takes 3D motion data and turns it into ergonomic scores. It has two parts: the Main Window (where you do the work) and the Report Dashboard (where you look at the results).

NOTE For specific and detailed info about Video Recording, Calibration with ChArUco boards and MoCap data collection you can read the official FreeMoCap Documentation

1. Main Window

This is where you load your files and run the calculations.

📁 Files & Recording

💀 RUN FREEMOCAP: Opens the FreeMoCap software so you can record a new session.
📂 SELECT FREEMOCAP ROOT: Tell the app which folder contains all your recordings.
Select Recording Session: Pick the specific folder (e.g., session_001) you want to look at.

🏃 Analysis

Pick a method from the list.

Working: REBA, RULA.
Coming Soon: OCRA, NIOSH, SNOOK, MAPO.
🏃 RUN ANALYSIS: Click this to calculate the joint angles and save the raw analysis scores.
🧐 RUN REVIEW: Click this to open the floating Video Review Suite window to audit and manually overwrite scores.

🎞️ Video Player & Visualizer

Select Video: Pick a video from the current session.
▶ PLAY / PAUSE: Start or stop the video to see the skeleton overlay.
SELECT MODE (ANALYSIS / REVIEW): Toggle between these buttons to switch which score overlay is displayed on top of the video canvas (raw analysis data vs your manual review revisions).
🎞️ BROWSE OTHER VIDEO: If your video isn't in the session folder, find it manually here.

🧐 Video Review Suite

When you click 🧐 RUN REVIEW, this separate floating window opens up. It allows you to correct any tracking glitches or bad automated scores manually.

FRAME DATA SPECS: A read-only table showing the current frame's individual body part scores, loads, and raw joint angles.
1. SCOPE TARGET: Choose how many frames your change will apply to (Current Frame Only, Custom Frame Range, or Entire Recording Timeline). If you use a custom range, you must fill in the From: and To: frame boxes.
2. ERGONOMIC ADJUSTMENTS: Select the variable you want to fix, enter your new value, and click ⚡ APPLY CORRECTION to update the data in temporary memory.
3. OPERATOR OBSERVATIONS: Add your own custom notes or comments about the frame or session.
4. COMMIT REVISIONS: Click the 💾 COMMIT REVISIONS button to save all your changes permanently to an ergomocap_review.csv file inside your recording folder.

2. Report Dashboard

Click 📊 OPEN REPORT DASHBOARD to see the data breakdown.

📈 Numbers & Charts

The app calculates these automatically:

TOTAL FRAMES: How many frames were in the recording.
AVG REBA SCORE: The average score for the whole session.
Risk Pie Charts: Shows how much time was spent in "Safe" vs "Danger" zones.
Score Table: Shows the specific scores for Trunk, Neck, Legs, Arms, and Wrists.

💾 Saving Reports

📁 LOAD DATA: Open an analysis file you made earlier (.csv or .xlsx).
📜 EXPORT TO PDF: Saves a PDF version of the report.
📄 EXPORT TO DOCX: Saves a Word document you can edit.

Settings

Sidebar: Click ☰ to hide the left menu and make the video/charts bigger.
Theme: Click ☀️/🌓 to switch between Dark and Light mode.
Language: Switch between English and Italian. (Planned still not working on v0.0.X)

⚠️ Status Bar

Check the STATUS text at the bottom left. It tells you:

If your file loaded correctly.
How many sessions were found.
If the video is playing or paused.
If the analysis finished.