{"id":20874461,"url":"https://github.com/imagingdatacommons/idc-dicom-seg-conversions","last_synced_at":"2025-10-27T00:26:22.586Z","repository":{"id":204692621,"uuid":"712449249","full_name":"ImagingDataCommons/idc-dicom-seg-conversions","owner":"ImagingDataCommons","description":"Examples for converting prostate MRI-US-Biopsy STL prostate and lesion surfaces to DICOM SEG and DICOM STL. ","archived":false,"fork":false,"pushed_at":"2024-06-17T21:10:36.000Z","size":2260,"stargazers_count":0,"open_issues_count":1,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-06-17T22:30:15.422Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ImagingDataCommons.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-31T13:49:12.000Z","updated_at":"2024-06-17T19:58:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"e61cff97-5a73-47df-b3e0-f81481035401","html_url":"https://github.com/ImagingDataCommons/idc-dicom-seg-conversions","commit_stats":null,"previous_names":["ccosmin97/prostate_mri_us_biopsy_dcm_conversion","imagingdatacommons/prostate_mri_us_biopsy_dcm_conversion"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ImagingDataCommons%2Fidc-dicom-seg-conversions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ImagingDataCommons%2Fidc-dicom-seg-conversions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ImagingDataCommons%2Fidc-dicom-seg-conversions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ImagingDataCommons%2Fidc-dicom-seg-conversions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ImagingDataCommons","download_url":"https://codeload.github.com/ImagingDataCommons/idc-dicom-seg-conversions/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225139314,"owners_count":17426956,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-18T06:32:45.176Z","updated_at":"2025-10-27T00:26:17.570Z","avatar_url":"https://github.com/ImagingDataCommons.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Prostate_mri_us_biopsy_dcm_conversion\nProvides examples for converting prostate MRI-US-Biopsy collection STL prostate and lesion surfaces to DICOM SEG and DICOM STL. \n\n# Conversion to DICOM process\n\n## Conversion to DICOM SEG\n1) STL to labelmap -- Utils folder\n2) labelmap to SEG DICOM -- see DEMO_Conversion_STL_TO_DICOM.ipynb\n\n## Conversion to DICOM STL\n1) STL to DICOM STL -- see DEMO_Conversion_STL_TO_DICOM.ipynb\n\n# Repository organization\n\n## Data samples folder\nThe folder contains STL and labelmaps samples for prostate and lesion surfaces, used for conversion showcase.\nWe include the already computed labelmaps from Slicer conversion, since we cannot showcase it inside Google Colab.\n\n## metadata folder\nContains segments metadata.json files used as input for conversion to DICOM SEG, for both lesion and prostate surfaces.\n\n## Utils folder\nContains example of slicer script used to convert STL files into labelmaps with reference T2W images.\n\nThe conversion Slicer script is also available in our demo github repository, [here](https://github.com/ImagingDataCommons/prostate_mri_us_biopsy_dcm_conversion/blob/main/utils/convert_STL_labelmap_slicer_script.py).\n\nThe terminal command run over the Slicer-based python script is provided below as an example:\n\n`\u003cpath to Slicer executable\u003e --no-splash --no-main-window --python-script \"\u003croot-folder-path-to-script\u003e/convert_STL_labelmap_slicer_script.py.py\"`\n\nThe script has pre-defined paths for the location of the STL files and the output labelmaps files, so please change these paths inside the script itself.\n\nMentioned scripts iterates over the STL files and finds the reference T2W image **.nrrd** file, used as a reference node for the output labelmap segmentations. Resulting labelmaps have the same geometry and orientation as the segmented MRI T2W image.\n\n## Notebooks\n\n[main_stl_seg_to_dcm.ipynb](https://github.com/ImagingDataCommons/prostate_mri_us_biopsy_dcm_conversion/blob/main/main_stl_seg_to_dcm.ipynb) notebook gives an overview of the conversion steps and how to reproduce the results.\n\n[demo_conversion_stl_to_dicom.ipynb](https://github.com/ImagingDataCommons/prostate_mri_us_biopsy_dcm_conversion/blob/main/demo_conversion_stl_to_dicom.ipynb) is supporting the implementation of the M3D DICOM modality in [QIICR](https://github.com/QIICR/QuantitativeReporting) for [Slicer3D](https://www.slicer.org/) use.\n\n# Conversion tools used\n\n- STL To labelmap : Slicer3D\n- labelmap to SEG DICOM : dcmqi 1.2.4\n- STL to DICOM STL : dicom3tools \n\n# Collection information : Prostate-MRI-US-Biopsy\n\nPlease see [TCIA website](https://wiki.cancerimagingarchive.net/pages/viewpage.action?pageId=68550661) and [Imaging Data Commons](https://portal.imaging.datacommons.cancer.gov/explore/) for additional details/visualization of the T2W MRI images considered for annotations conversion. \n\n\n# Where to download the DICOM SEG/STL objects\n\nA zenodo publication will follow shortly, where 1017 prostate annotations and 1311 lesions were converted from STL to DICOM SEG/STL and publicly available.\nA final step will be the publication of these annotations in the [Imaging Data Commons platform](https://portal.imaging.datacommons.cancer.gov/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimagingdatacommons%2Fidc-dicom-seg-conversions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimagingdatacommons%2Fidc-dicom-seg-conversions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimagingdatacommons%2Fidc-dicom-seg-conversions/lists"}