https://github.com/ami-iit/mvnx-to-urdf

Repository for creating URDF models for human subjects

https://github.com/ami-iit/mvnx-to-urdf

Science Score: 13.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (11.5%) to scientific vocabulary

Keywords

human-modeling human-robot-interaction
Last synced: 6 months ago · JSON representation

Repository

Repository for creating URDF models for human subjects

Basic Info
  • Host: GitHub
  • Owner: ami-iit
  • License: bsd-3-clause
  • Language: MATLAB
  • Default Branch: master
  • Homepage:
  • Size: 205 KB
Statistics
  • Stars: 17
  • Watchers: 25
  • Forks: 5
  • Open Issues: 0
  • Releases: 0
Topics
human-modeling human-robot-interaction
Created about 6 years ago · Last pushed over 1 year ago
Metadata Files
Readme License

README.md

Contents

Installation

Prerequisites

  • Matlab
  • iDynTree: a library of robots dynamics algorithms for control, estimation and simulation.

Una-tantum procedure

  • Install the robotology-superbuild. git clone https://github.com/robotology/robotology-superbuild.git mkdir build cd build Follow installation instructions here. The required library iDynTree will be automatically install via the superbuild.
  • Enable the Matlab bindings for iDynTree. cd robotology-superbuild/build/src/iDynTree cmake .. ccmake . ROBOTOLOGY_ENABLE_MATLAB ON IDYNTREE_USES_MATLAB ON Matlab_ROOT_DIR root-to-your-application-Matlab make install
    • In your .bashrc add export Matlab_ROOT_DIR="root-to-your-application-Matlab".
    • Open Matlab and browse to the folder your-path/robotology-superbuild/build.
    • Run the script Startup-robotology-superbuild.m.

How to generate models

What you need

  • A data folder (e.g., data) containing your dataset, per each subject (e.g., S00X) with
    • a .mvnx file for the human whole-body acquisition.
    • a .mat file with markers acquisition for the hand (if you wantto build the model with articulated hands)
  • The folder templates containig human templates for URDF models.

How to use it

  • Move to the folder where you clone the repo.
  • Run the script computeHumanURDF.m
  • Fill the dialog box with required info.

  • If you do not want to include the articulad model of the hand into the URDF, insert 'n'. This means that the hand will be represented only by a unique rigid box in the URDF.
  • If you want to include the articulad model of the hand into the URDF, insert 'y'. This will open another dialog box, as follows:

  • With the second dialog box you can choose if building
    • an anthropometric model of the hand. This model does not require the markers acquisition, but only the .mvnx.
    • a marker-driven model of the hand. This model also requires an acquisition of markers properly positioned on top of the hand with a standard optical cameras tracking (e.g., Vicon).

Examples

Given

  • the subject number (e.g., 1)
  • the subject mass (e.g., 60)
  • the subject height (e.g.,1.80)

| OPT | 48 DOF| 66 DOF | ANTHROPOMETRIC HAND| MARKER-DRIVEN HAND| GENERATED URDF| :------:|:-------:|:------:|:------------------:|:-----------------:|:-------------:| 1|✔️| | | |1 2| |✔️| | |2 3|✔️| |✔️| |3 4|✔️| | |✔️|4

Owner

  • Name: Artificial and Mechanical Intelligence
  • Login: ami-iit
  • Kind: organization
  • Location: Italy

GitHub Events

Total
  • Watch event: 2
Last Year
  • Watch event: 2

Committers

Last synced: 8 months ago

All Time
  • Total Commits: 30
  • Total Committers: 3
  • Avg Commits per committer: 10.0
  • Development Distribution Score (DDS): 0.067
Past Year
  • Commits: 1
  • Committers: 1
  • Avg Commits per committer: 1.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Claudia c****6@g****m 28
Silvio Traversaro s****o@t****t 1
Lorenzo Rapetti l****i@g****m 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 8 months ago

All Time
  • Total issues: 2
  • Total pull requests: 2
  • Average time to close issues: 3 months
  • Average time to close pull requests: 26 minutes
  • Total issue authors: 2
  • Total pull request authors: 2
  • Average comments per issue: 5.5
  • Average comments per pull request: 0.0
  • Merged pull requests: 2
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: 33 minutes
  • Issue authors: 0
  • Pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • moongerim (1)
  • lrapetti (1)
Pull Request Authors
  • traversaro (2)
  • lrapetti (1)
Top Labels
Issue Labels
bug (1)
Pull Request Labels