3D Reconstruction of Shoulder Muscles in Hominoid Primates: Correlating Scapular Attachment Areas with Muscle Volume

How To Cite:

If you use this data or code in your research, please cite the associated open-access manuscript, which you can find here: https://doi.org/10.1111/joa.14199and this zenodo repository.

Online Visualization:

You can access an interactive, web-based view of the notebooks and analyses here.

Repository Description:

This repository contains two zip files related to the analysis and visualization of 3D reconstructed muscle volumes and lengths from various hominoid specimens.

MeshFiles.zip:

Contents: This zip file includes all .obj files for 3D reconstructed muscle volumes and associated anatomical structures. Specifically, it contains:

Muscles: Supraspinatus, Infraspinatus, Subscapularis, Teres Major, Teres Minor

Bones: Scapula and Humerus

Attachment Sites

Organization: The files are organized into folders by specimen. There are 9 hominoid specimens from the following species:

Hylobates lar

Symphalangus syndactylus

Pongo pygmaeus

Pongo abelii

Gorilla gorilla

Pan troglodytes

Homo sapiens

Surface Scans of Muscle Geometry: The specimens Pongo (ID 3) and Symphalangus (ID 122) also contain surface scans that depict the muscle geometry of the listed muscles. These surface scans can be used for training with the iterative polygonal modelling approach. The scans are stored as .obj, .mtl and .png files. To view textures on these meshes, keep all three files together in the same folder.

Additional Details: Muscle reconstructions were performed for different arm positions. Each folder contains multiple humerus files, with each file representing a humerus in a specific position aligned with the corresponding muscles. The humerus file names indicate the muscles the humerus is aligned with.

DataAndCode.zip:

Contents:

Excel File: The original data used for analysis, presented in Table 2 of the manuscript.

Jupyter Notebook Files: These notebooks provide the analyses and figures as described in the manuscript:

Accuracy_Muscle_Length_Reconstruction: Analysis of muscle length measurement comparisons, detailed in Supplementary Information Section 3: Accuracy of estimating Muscle Length from 3D reconstructions.

Accuracy_Muscle_Volume_Reconstruction: Analysis of muscle volume measurement comparisons, detailed in Results Section 3.2: Accuracy of Muscle Volume and Length Reconstruction.

Correlation_Analysis_SIS: Correlation analysis of muscle origin area to volume for the supraspinatus, infraspinatus, and subscapularis muscles, detailed in Results Section 3.3: Correlation Analysis.

Correlation_Analysis_TT: Correlation analysis of muscle origin area to volume for the teres major and minor muscles, detailed in Supplementary Information Section 1: Correlation results of teres major and minor.

Requirements.txt: A file listing the necessary packages required to run the Jupyter notebooks.

Purpose: The Python files include code for performing statistical analyses and generating figures as described in the manuscript.

Usage Instructions:

For analyzing muscle volumes and lengths, refer to the Jupyter notebooks included in the DataAndCode.zip. Ensure all dependencies listed in the requirements.txt file are installed.

The MeshFiles.zip contains the 3D models necessary for visualizing muscle and bone reconstructions, organized by specimen and arm position.