stylianosc/gif-database

GIF Anatomical Atlas Database

Status: PRIVATE. This repository will be made public once data-sharing / ethics governance for redistribution is separately confirmed.

Contents

Reference atlas database (T1, FLAIR, and GIF anatomical segmentation labels) used by the leukoquant GIF pipeline, de-identified with MiDeFace.

• —db_mideface.tar.gz -- T1 images (102 subjects) + GIF anatomical labels + GIF database manifest (db.xml, labels.xml, GroupMask.nii.gz).
• —db_FLAIR_mideface.tar.gz -- FLAIR images (102 subjects) + the same GIF anatomical labels + manifest, FLAIR variant.
• —previews/T1/, previews/FLAIR/ -- one PNG per subject, three-view isosurface render, for a quick visual check without downloading or rendering anything.

Each tarball extracts to a self-contained GIF database directory (db_mideface/ or db_FLAIR_mideface/) matching the layout the leukoquant GIF pipeline expects: db.xml + labels.xml + GroupMask.nii.gz + image folder (T1/ or FLAIR/) + labels/.

De-identification and privacy

All NIfTI headers were audited (full field dump) prior to packaging: no identifying free-text fields, no embedded DICOM/patient-identifier NIfTI extensions, no sidecar files. Images were staged by exact expected filename per subject only (never a wholesale directory copy), which also excludes any intermediate pre-defacing scratch files from the source processing directories.

Usage

Auto-downloaded on first use by leukoquant's GIF pipeline (requires HF_TOKEN while this repo is private). Manual use:

from huggingface_hub import hf_hub_download
path = hf_hub_download(repo_id="stylianosc/gif-database", filename="db_mideface.tar.gz",
                        repo_type="dataset")

Citation

License and citation pending governance confirmation -- placeholder, do not redistribute further until this notice is removed.