MedShapeNet 0.1.0

Python API to connect and work with the MedShapeNet Medical Shapes Database (https://medshapenet.ikim.nrw/)

MedShapeNet API

The MedShapeNet Package (MSN-API) is an API that enables direct connectivity to the MedShapeNet database, comprising over 100,000 3D shapes for the medical domain.

The included datasets comprise collections of anatomical shapes (e.g., bones, organs, vessels), 3D models of surgical instruments, and even molecular structures.

MedShapeNet has been established with the objective of facilitating the translation of data-driven vision algorithms for medical machine learning applications, extended reality, 3D printing, benchmarking and other related fields.

Further information on MedShapeNet can be found in the first MedShapeNet Paper, which describes the initial contributions. A subsequent paper will describe the new contributions and usage of the MedShapeNet API.

The API enables users to search the Database, retrieve author information, download data, visualise shapes, and transform shapes into file formats that are more suitable for machine learning (e.g. as numpy arrays in .npz format).

Samples on MSN-API usage and using it for machine learning applications will made available on the MedShapeNet 2.0 GitHub Page in the near future.

The initial version will be demonstrated during the MICCAI 2024 tutorial. Following the event, further functionality will be added, for example adding labels to the shapes and including more datasets. Additionally, a Streamlit websit has been created as a result of the first paper. Further information can be found on the Project Page of the Institute for Artificial Intelligence in Medicine (IKIM).

Functionality under constructions, functionality and all datasets will be added soon.
Want to contribute, checkout the MedShapeNet 2.0 GitHub Page.

---

Installation

You can install the package using pip:

pip install MedShapeNet

Help function

In the command line interface pip install:

msn_help

Or in Python:

import MedShapeNet
msn.msn_help()

Usage

The MedShapeNet object will be imported into the Python environment as msn, and the methods can be invoked directly via the msn.method(args) syntax.
For further information on the usage of methods and examples of the MedShapeNet API, we refer to the samples available on the MedShapeNet 2.0 GitHub Page.

---

Reference / citation

If you use MedShapeNet in your (research) project(s), we kindly request you to cite MedShapeNet as:

@article{li_medshapenet_2023,
	title = {MedShapeNet--A Large-Scale Dataset of 3D Medical Shapes for Computer Vision},
    journal={arXiv preprint arXiv:2308.16139},
	doi = {10.48550/arXiv.2308.16139},
	author = {Li, Jianning and Zhou, Zongwei and Yang, Jiancheng and Pepe, Antonio and Gsaxner, Christina and Luijten, Gijs and others},
	year = {2023},
}