# PanopTILs Refined: breast cancer H&E regions with nucleus and tissue masks from 150 TCGA patients

## Facts

- Provider: Mohamed Amgad et al. (PanopTILs); curated by SPORA
- License: CC0-1.0 (https://sites.google.com/view/panoptils/)
- Size: 10 files
- Format: PNG, Parquet (in sampled files)
- Stored at: Hugging Face, https://huggingface.co/datasets/csmp-hub/panoptils_refined
- Access: public, readable without an account
- Category: Health & Biomedical
- Source: https://doi.org/10.1101/2022.01.08.22268814
- Page: https://scigantic.com/archive/088803d3-48ef-563b-8bee-3d80625989c6
- Keywords: Health & Biomedical, histopathology, image segmentation, PNG, Parquet, Hugging Face

## About

PanopTILs Refined is a selected subset of PanopTILs, the crowdsourced panoptic segmentation of tumor-infiltrating lymphocytes (TILs) in breast cancer built on the BCSS and NuCLS annotations of TCGA whole-slide images. It contains 1,349 H&E regions of interest from 150 TCGA breast cancer patients, each 1024x1024 pixels at 0.25 micrometers per pixel, with instance and class masks for individual nuclei (six nucleus classes, model-assisted labels) and hand-drawn tissue region masks (six tissue classes). Patient-level splits keep all images from one patient together: train.parquet (1,068 ROIs, 120 patients), val.parquet (130, 15) and test.parquet (151, 15), with patient lists in manifest.json; these splits differ from the original PanopTILs folds. About 5.7 GB (measured 2026-11-17). Images and masks are stored as PNG or TIFF bytes inside Parquet; read them with polars or pandas plus Pillow, or with Hugging Face datasets. Use for panoptic segmentation, nucleus classification and TIL scoring. Curated and packaged on Hugging Face by the SPORA project (csmp-hub), which keeps the original license and citation files. The original PanopTILs site states the dataset is licensed CC0 1.0; cite Amgad et al., medRxiv 2022.01.08.22268814, and the BCSS and NuCLS papers.

## Load the data

```python
from datasets import load_dataset
ds = load_dataset("csmp-hub/panoptils_refined")
print(ds)
```

## Data structure

File types in sampled files: PNG, Parquet

Example file: `panoptils_refined.parquet`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/088803d3-48ef-563b-8bee-3d80625989c6
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/088803d3-48ef-563b-8bee-3d80625989c6
- Over MCP: `get_schema_card` with id `088803d3-48ef-563b-8bee-3d80625989c6` at https://api.scigantic.com/mcp

## Related topics

- [Parquet datasets](https://scigantic.com/topics/parquet)
- [Image segmentation datasets](https://scigantic.com/topics/image-segmentation)
- [Health & Biomedical datasets](https://scigantic.com/topics/health-and-biomedical)
- [PNG datasets](https://scigantic.com/topics/png)
- [Histopathology datasets](https://scigantic.com/topics/histopathology)
