|
123 | 123 | }, |
124 | 124 | "source": [ |
125 | 125 | "## Finding the `BoneMarrowWSI-PediatricLeukemia` dataset on IDC\n", |
126 | | - "To access and download image and ANNs files, we utilize the Python package [idc-index](https://github.com/ImagingDataCommons/idc-index) and fetch `ann_index` and `ann_group_index`, specific to DICOM ANN objects. You can have a look [here](https://idc-index.readthedocs.io/en/latest/indices_reference.html) for details on all available indices in idc-index." |
| 126 | + "To access and download image and ANNs files, we utilize the Python package [idc-index](https://github.com/ImagingDataCommons/idc-index) and fetch `ann_index` and `ann_group_index`, specific to DICOM ANN objects. Have a look [here](https://idc-index.readthedocs.io/en/latest/indices_reference.html) for details on all available indices in idc-index and what information you can query from them. " |
127 | 127 | ] |
128 | 128 | }, |
129 | 129 | { |
130 | 130 | "cell_type": "code", |
131 | | - "execution_count": 3, |
| 131 | + "execution_count": null, |
132 | 132 | "metadata": { |
133 | 133 | "id": "D6XmpjYFsaJy" |
134 | 134 | }, |
135 | 135 | "outputs": [], |
136 | 136 | "source": [ |
137 | 137 | "idc_client = IDCClient() # set-up idc_client\n", |
138 | 138 | "idc_client.fetch_index('ann_index') # fetch index for ANN objects\n", |
139 | | - "idc_client.fetch_index('ann_group_index') # fetch index for ANN groups" |
| 139 | + "idc_client.fetch_index('ann_group_index') # fetch index for the AnnotationGroups within ANN objects" |
140 | 140 | ] |
141 | 141 | }, |
142 | 142 | { |
|
519 | 519 | "SELECT\n", |
520 | 520 | " ann_index.SeriesInstanceUID, -- SeriesInstanceUID of the annotation object\n", |
521 | 521 | " ann_index.referenced_SeriesInstanceUID, -- SeriesInstanceUID of the slide that the annotation is associated with\n", |
| 522 | + " ann_index.AnnotationCoordinateType, -- whether coordinates are 2D (image coordinate system) or 3D (frame-of-reference coordinate system)\n", |
522 | 523 | " index.SeriesDescription,\n", |
523 | 524 | " index.StudyInstanceUID,\n", |
524 | 525 | "FROM\n", |
|
540 | 541 | "id": "kBWUmv6qHZ48" |
541 | 542 | }, |
542 | 543 | "source": [ |
543 | | - "We can see, that for each slide (i.e. **referencedSeriesInstanceUID**) there are multiple ANN Series. Looking at the **SeriesDescription**, we can assert what is described in the [Background](#Background) section of this notebook.\n", |
| 544 | + "We can see, that for each slide (i.e. **referencedSeriesInstanceUID**) there are multiple ANN Series. All annotations have an **AnnotationCoordinateType** of \"2D\", meaning that the coordinates are two-dimensional coordinates in the image coordinate system (more information [here](https://highdicom.readthedocs.io/en/latest/package.html#highdicom.ann.AnnotationCoordinateTypeValues)). Looking at the **SeriesDescription**, we can assert what is described in the [Background](#Background) section of this notebook.\n", |
544 | 545 | "\n", |
545 | 546 | "* Each slide has \"Monolayer regions of interest for cell classification\" annotations.\n", |
546 | 547 | "* For some slides, there is one ANN Series with \"Unlabeled cell bounding boxes\", while for others, there are multiple ANN Series containing \"Cell bounding boxes with cell type labels\" for different annotation sessions and the consensus labels.\n", |
547 | 548 | "\n", |
548 | | - "ANN files contain one or multiple \"AnnotationGroups\" (for more explanation see the aforementioned [tutorial notebook]((https://github.com/ImagingDataCommons/IDC-Tutorials/blob/master/notebooks/pathomics/microscopy_dicom_ann_intro.ipynb)) on DICOM ANNs).\n", |
549 | | - "Using `ann_group_index` we can get a little more information on what the individual annotation groups contain exactly. The following code cell queries the AnnotationGroupLabel - a human-readable label for the annotation group - as well as [coded values from controlled vocabularies](https://learn.canceridc.dev/dicom/coding-schemes) like SNOMED-CT for the category and type of the annotation.\n" |
| 549 | + "ANN files contain one or multiple **\"AnnotationGroups\"** (for more explanation see the aforementioned [tutorial notebook]((https://github.com/ImagingDataCommons/IDC-Tutorials/blob/master/notebooks/pathomics/microscopy_dicom_ann_intro.ipynb)) on DICOM ANNs).\n", |
| 550 | + "Using `ann_group_index` we can get a little more information on what the individual annotation groups contain exactly. The following code cell queries the AnnotationGroupLabel - a human-readable label for the annotation group - as well as [coded values from controlled vocabularies](https://learn.canceridc.dev/dicom/coding-schemes) such as SNOMED-CT for the category and type of the annotation.\n" |
550 | 551 | ] |
551 | 552 | }, |
552 | 553 | { |
|
0 commit comments