Discover and characterize cancer radiology imaging cohorts from The Cancer Imaging Archive (TCIA) — list public collections (e.g. LIDC-IDRI, TCGA-GBM, TCGA-LUAD, TCGA-BRCA), enumerate patients/subjects and studies within a collection, browse DICOM series by modality (CT, MR, PT, CR, DX, US, NM) or body part (CHEST, BRAIN, ABDOMEN, ...), pull series-level DICOM metadata and scanner manufacturer, estimate download size before pulling data, and enumerate individual DICOM instance (slice) UIDs within a series. Use when someone asks to "find a CT/MRI/PET imaging cohort for [cancer type]", "how many patients/studies/series are in [TCIA collection]", "what imaging modalities/body parts/scanners does [collection] have", "look up DICOM series metadata for [SeriesInstanceUID]", "estimate the size of this TCIA series before downloading", or "build a radiology imaging research cohort". NOT for microscopy/cell imaging quantification (use tooluniverse-image-analysis), NOT for actual DICOM pixel data analysis, segmentation, or diagnosis (TCIA tools here return metadata only — no pixel access), NOT for tumor genomic/omics data (use tooluniverse-cancer-genomics-tcga).
Discover and characterize public cancer imaging cohorts from The Cancer Imaging Archive (TCIA, National Cancer Institute) — collection, patient, study, and DICOM series-level metadata for building or scoping a radiology research cohort.
Can: enumerate collections, patients, studies, and series; filter by modality/body part/manufacturer; pull DICOM series-level metadata (scanner, acquisition, license); estimate series download size; list individual DICOM instance (slice) UIDs.
Cannot: download or view actual pixel data, run segmentation/detection
models, or interpret images. Every TCIA tool here returns metadata about
what imaging exists — not the images themselves. If the user wants the
actual pixels, tell them the DICOM download UI/API is a separate TCIA
service (https://www.cancerimagingarchive.net/) outside this tool set.
TCIA data is public, de-identified cancer imaging. Study/series dates are
frequently shifted to a placeholder (e.g. 2000-01-01) as part of
de-identification — do not interpret these as real acquisition dates.
SeriesInstanceUIDNOT for (route elsewhere):
tooluniverse-image-analysistooluniverse-cancer-genomics-tcga| Tool | Purpose | Key params |
|---|---|---|
TCIA_list_collections | List all public collection names | none |
TCIA_get_patients | List patients/subjects in a collection (incl. phantom flag, species) | Collection |
TCIA_get_patient_studies | List a patient's (or collection's) studies | Collection, PatientID, StudyInstanceUID |
TCIA_get_series | List DICOM series (the main filterable search) | Collection, PatientID, StudyInstanceUID, Modality, BodyPartExamined |
TCIA_get_modality_values | Facet: distinct modalities in a collection/body part | Collection, BodyPartExamined |
TCIA_get_body_part_values | Facet: distinct body parts in a collection/modality | Collection, Modality |
TCIA_get_manufacturer_values | Facet: distinct scanner manufacturers | Collection, Modality, BodyPartExamined |
TCIA_get_series_metadata | Full DICOM metadata for one series | SeriesInstanceUID (required) |
TCIA_get_series_size | Download size + image count for one series | SeriesInstanceUID (required) |
TCIA_get_sop_instance_uids | List every individual image (slice) UID in a series | SeriesInstanceUID (required) |
All 10 tools verified live against the real TCIA API. Full example
calls and real (trimmed) responses: references/tcia_tool_reference.md.
TCIA_list_collections and match against the name pattern (TCGA
collections follow TCGA-<CANCERTYPE>, e.g. TCGA-GBM, TCGA-LUAD,
TCGA-BRCA; other collections have their own names, e.g. LIDC-IDRI
for lung nodule CT). Confirm the exact collection name with the user
before proceeding — do not guess a collection name that wasn't returned
by the tool.TCIA_get_modality_values, TCIA_get_body_part_values,
TCIA_get_manufacturer_values, each filterable by Collection.TCIA_get_patients with Collection set —
check the Phantom field to exclude QA phantom objects if the user
wants only real human subjects, and SpeciesDescription if a
non-human collection is possible.TCIA_get_patient_studies
(by Collection + PatientID) then TCIA_get_series (by Collection +
PatientID, optionally narrowed by Modality/BodyPartExamined) to get
SeriesInstanceUIDs.TCIA_get_series_metadata for
full DICOM tags, TCIA_get_series_size to report download size/image
count before recommending a download, TCIA_get_sop_instance_uids only
if the user needs individual-slice-level references.Collection, PatientID, Modality, and BodyPartExamined are
case-sensitive and must match TCIA's exact values — get them from
TCIA_list_collections / TCIA_get_modality_values /
TCIA_get_body_part_values rather than guessing capitalization.LicenseName/LicenseURI field from
TCIA_get_series or TCIA_get_series_metadata if the user needs to know
redistribution terms.references/tcia_tool_reference.md — all 10 tools with real example
calls and real (trimmed) responses captured live against the TCIA APImims-harvard/ToolUniverse
37bb81a
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.