MedShapeNet 0.1.3

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.

Content on this readme:

Installation Help function MSN Usage Cite us Licence information

---

Installation

You can install the package using pip:

pip install MedShapeNet

Help function

In the command line interface after installation with pip:

msn_help

Or in Python:

# Import MedShapeNet class for MedShapeNet package
from MedShapeNet import MedShapeNet as msn

# Call the help function
msn.msn_help()
# or
msn_instance = msn()
msn_instance.msn_help()

# Checkout the docstring - print(msn.{method}.__doc__) or print(msn.__doc__), e.g.:
print(msn.msn_help.__doc__)
print(msn.__doc__)

Usage

The MedShapeNet object will be imported into the Python environment as MedShapeNet, and the methods can be invoked directly either via MedShapeNet.method(args) syntax or by creating an instance (,see section about help function,) first.
For further information on the basic usage of MedShapeNet funcinality and examples of applications made with the MedShapeNet API, we refer to the samples available on the MedShapeNet 2.0 GitHub Page.

---

reference/Cite

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},
}

Licence

MedShapeNet 2.0 © 2024 by Gijs Luijten is licensed under:
Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International - CC BY-NC-SA 4.0.