An open API service indexing awesome lists of open source software.

https://github.com/kevinhongzl/medaset

A collection of pre-built dataset classes for medical datasets.
https://github.com/kevinhongzl/medaset

deep-learning medical-image-processing monai python3 pytorch

Last synced: 1 day ago
JSON representation

A collection of pre-built dataset classes for medical datasets.

Awesome Lists containing this project

README

          

# Medaset
> A collection of pre-built dataset classes for **MED**ical dat**ASET**s.

[![python](https://img.shields.io/badge/Python-3.8.17-3776AB.svg?style=flat&logo=python&logoColor=white)](https://www.python.org) [![monai-shieldio](https://img.shields.io/badge/MONAI-1.0.1-5ec2b3.svg?logo=data:image/png;base64,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)](https://github.com/project-monai/monai) [![pytorch](https://img.shields.io/badge/PyTorch-1.12.1-EE4C2C.svg?style=flat&logo=pytorch)](https://pytorch.org) [![Code style: black](https://img.shields.io/badge/Code%20Style-Black-000000.svg)](https://github.com/psf/black)

**Objectives**

* Compatible to [`PyTorch`](https://pytorch.org/docs/stable/index.html) and [`MONAI`](https://monai.io/)
* Providing some off-the-shelf features to the `Dataset` class, including but not limited to, dataset extracting, loading and visualization.

### Getting started
`git clone` this repo and install it using

```bash
pip install -e .
```

> [!CAUTION]
> Naming convention changed!! For the sake of readibility, only the first letters in each acronym are now capitalized.

## Currently Supported Datasets

* **AMOS (Abdominal Multi-Organ Segmentation)**
[[Grand Challenge]](https://amos22.grand-challenge.org/) [[Arxiv]](https://arxiv.org/abs/2206.08023)
* AMOS provides 500 CT and 100 MRI scans collected from multi-center, multi-vendor, multi-modality, multi-phase, multi-disease patients, each with voxel-level annotations of 15 abdominal organs.
* Structure: spleen, right kidney, left kidney, gallbladder, esophagus, liver, stomach, aorta, inferior vena cava, pancreas, right adrenal gland, left adrenal gland, duodenum, bladder, prostate/uterus.
* Dataset classes: `AmosDataset`, `SimpleAmosDataset`
---
* **CHAOS (Combined (CT-MR) Healthy Abdominal Organ Segmentation)**
[[Grand Challenge]](https://chaos.grand-challenge.org/) [[Arxiv]](https://arxiv.org/abs/2001.06535)
* The CHAOS challenge data contains 40 CT scans and 40 MR scans of upper abdomen area.
* Structure (Modality): Liver (CT/MR), Kidneys (MR), Spleen (MR)
* Dataset classes: `ChaosCtDataset`, `ChaosT2spirDataset` (The T1-DUAL sequence is not supported currently)
---
* **SMAT (Skeletal Muscle and Adipose Tissue)**
* Private dataset
* Dataset classes: `SmatCtDataset`, `SmatMrDataset`, `SmatDataset`

## Useful Links

**Metadata Desciptions**
* [NIfTI file header discriptions](https://brainder.org/2012/09/23/the-nifti-file-format/)
* [DICOM Standard Browser](https://dicom.innolitics.com/ciods)

**Medical Image Coordinate Systems**
* [An Introduction from 3D Slicer](https://slicer.readthedocs.io/en/latest/user_guide/coordinate_systems.html)
* [An Introduction of coordinate systems and affines from nipy.org](https://nipy.org/nibabel/coordinate_systems.html)
* [Defining the DICOM orientation](https://nipy.org/nibabel/dicom/dicom_orientation.html)
* [Geometry in Medical Imaging: DICOM and NIfTI formats](https://discovery.ucl.ac.uk/id/eprint/10146893/1/geometry_medim.pdf)
* [The First Step for Neuroimaging Data Analysis: DICOM to NIfTI conversion](https://core.ac.uk/download/pdf/79518053.pdf)