This is a home for notebooks which demonstrate how to access and work with TCIA datasets. Most of them heavily leverage functionality from tcia_utils.
- TCIA_for_Georgetown_HIDS_2026.ipynb - A comprehensive tutorial presented to the Georgetown HIDS graduate student program which demonstrated how to access TCIA data from various system components.
- Accessing TCIA's open-access DICOM data in IDC
- Accessing_TCIA_Public_DICOM_data_in_IDC.ipynb - A Python tutorial on how to use the NCI Imaging Data Commons idc-index package to query and download TCIA's open-access DICOM datasets. This is ideal for those who prefer SQL queries.
- TCIA_REST_API_Downloads.ipynb - A python tutorial for using tcia_utils idc.py for downloading TCIA's open-access DICOM datasets. This is helpful for users migrating code that used nbia.py or who prefer parameter-based Python functions for queries.
- TCIA_REST_API_Queries.ipynb - A python tutorial for using tcia_utils idc.py for additional search and reporting features to understand TCIA's open-access DICOM datasets. This is helpful for users migrating code that used nbia.py or who prefer parameter-based Python functions for queries.
- TCIA_Aspera_CLI_Downloads.ipynb - A short tutorial on how to download TCIA datasets that are made available through Aspera via the command line (rather than via the Aspera browser plugin). TCIA typically uses Aspera for downloading histopathology collections or radiology collections that were provided in a format other than DICOM.
- TCIA_DataCite_Queries.ipynb - TCIA issues a Digital Object Identifier (DOI) for each of its datasets through DataCite. This notebook demonstrates how the DataCite API can be used to programmatically access Collection metadata such as their DOI URL, title, publication date, licensing information and abstract.
- CPTAC.ipynb - A tutorial on accessing DICOM images and tumor annotations (3d segmentations & seed points) related to the CPTAC-UCEC (Corpus Endometrial Carcinoma), CPTAC-PDA (Pancreatic Ductal Adenocarcinoma), CPTAC-CCRCC (Clear Cell Renal Carcinoma), and CPTAC-HNSCC (Head and Neck Squamous Cell Carcinoma) datasets hosted on TCIA.
- TCIA_NCTN_Annotations.ipynb - A tutorial on accessing DICOM images, clinical data, and tumor annotations (3d segmentations & seed points) related to NCI Clinical Trial Network datasets hosted on TCIA.
- TCGA_Clinical.ipynb - A tutorial on accessing DICOM images and clinical data for patients from The Cancer Genome Atlas Program.
- TCIA_Segmentations - A Python tutorial focused on using the TCIA APIs to identify segmentation data, find the corresponding reference series and visualize them together.
- TCIA_Image_Visualization_with_itkWidgets.ipynb - Example of downloading TCIA DICOM images and visualizing them as interactive cinematic volume renderings or as 2D slices, using itkWidgets.
- TCIA_PROSTATEx_Prostate_MRI_Anatomy_Model.ipynb - Demonstrates downloading data from TCIA, downloading a pre-trained model from MONAI's Model Zoo, applying the model to the data to segment anatomic structures in that data, and then visually comparing model results with expert segmentations.
- TCIA_RTStruct_SEG_Visualization_with_itkWidgets.ipynb - Tutorial of downloading expert annotations as DICOM SEG and RTSTRUCT objects, converting them to labelmaps for use in training and evaluating AI models, and visualizing them with their source images in 3D or as overlays on 2D slices.
- TCIA_STL_Visualization_with_itkWidgets.ipynb - Shows how to download, convert, and visualize expert annotations and 3D printer models stored in STL format on TCIA for use in training and evaluating AI models.