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.
You can use the GettingStarted.ipynb to get to know MedShapeNet's functionality.
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.
1 maintainer
Metadata
1 maintainer
Release files for MedShapeNet 0.1.26
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| medshapenet-0.1.26.tar.gz | 25.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| MedShapeNet-0.1.26-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 51.7 kB
Release files / medshapenet-0.1.26.tar.gz
| Download URL | medshapenet-0.1.26.tar.gz |
|---|---|
| Size | 25.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2b07342e49551062921eaea2b6ec34c4c15fe9ea5e0d86a87129894e6972cb0d
|
|
BLAKE2b-256 checksum How to use checksums |
bd0f92c0fc939cd65be944ab8f2c552ddfd33824951191aac3d38478cad46db3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.12.4
|
Release files / MedShapeNet-0.1.26-py3-none-any.whl
| Download URL | MedShapeNet-0.1.26-py3-none-any.whl |
|---|---|
| Size | 26.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
78cfe83396f6552d06b1af810c839791802f9337c86d882632bab15fbff19c54
|
|
BLAKE2b-256 checksum How to use checksums |
7b7644441111949f0e4aa21b5b58984ef9c267a51fe5099285d914560f9dabef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.12.4
|
