Annotation Format
Datature Nexus supports three annotation formats for 3D medical imaging projects:
- One-Hot Segmentation for NIfTI files
- Class-Index Segmentation for NIfTI files
- DICOM RT Structure Sets for DICOM files
Please note that uploading an annotation that already exists in the platform will result in overlapping annotations.
NIfTI
Note:
Import all files in
.nii
or.nii.gz
,.json
formats respectively.
One-Hot Segmentation
Format Preview
.nii
, .nii.gz
[
// Channel 0 (class 1)
[[[1, 1, 0, 0],
[1, 0, 0, 1],
[0, 0, 1, 1]],
[[1, 0, 0, 1],
[0, 0, 0, 1],
[0, 0, 1, 1]]],
// Channel 1 (class 2)
[[[0, 0, 1, 1],
[0, 1, 1, 0],
[0, 0, 0, 0]],
[[0, 1, 1, 0],
[0, 0, 1, 0],
[0, 0, 0, 0]]]
] // Each channel contains binary masks (0 or 1)
labels.json
[
{
"id": 1,
"name": "class1"
},
{
"id": 2,
"name": "class2"
}
]
Class-Index Segmentation
Format Preview
.nii
, .nii.gz
[
[[0, 0, 1, 1],
[0, 1, 1, 0],
[2, 2, 0, 0]],
[[0, 1, 1, 0],
[2, 2, 1, 0],
[2, 2, 0, 0]]
]
labels.json
[
{
"id": 1,
"name": "class1"
},
{
"id": 2,
"name": "class2"
}
]
DICOM
Note:
Import all files in
.dcm
format.
DICOM RT Structure Set
Format Preview
DICOM RT Structure Sets define regions of interest (ROIs) within 3D medical image series using contour data. When importing RT Structure Set files (.dcm
), each file must reference exactly one DICOM study. For each ROI in an RT Structure Set file, the system renders a 3D bitmask derived from the associated contour data, imports this bitmask as a new annotation for the corresponding DICOM 3D image series asset, and applies the ROI name as the tag name.
Supported Contour Geometric Types (3006, 0042)
POINT
: A single coordinate point.OPEN_PLANAR
: An open contour with coplanar points.CLOSED_PLANAR
: A polygon composed of coplanar points.CLOSEDPLANAR_XOR
: Multiple coplanar polygons combined using XOR operations.
Note:
The
OPEN_NON_PLANAR
type is not currently supported.
.dcm
DICOM File Meta -------------------------------------------------------
...
(0002, 0002) Media Storage SOP Class UID UI: RT Structure Set Storage
...
DICOM Data Set --------------------------------------------------------
...
(0008, 0016) SOP Class UID UI: RT Structure Set Storage
...
# Must match the Study Instance UID of a 3D DICOM series uploaded or synced
# to the project as an asset.
(0020, 000D) Study Instance UID UI: ...
...
(3006, 0020) Structure Set ROI Sequence ... item(s) ------
(3006, 0022) ROI Number IS: '1'
(3006, 0024) Referenced Frame Of Reference UID UI: ...
(3006, 0026) ROI Name LO: 'ROI 1'
...
------------
...
...
(3006, 0039) ROI Contour Sequence ... item(s) ------
...
(3006, 0040) Contour Sequence ... item(s) ------
(3006, 0016) Contour Image Sequence ... item(s) ------
# Defines images within the study containing the contour
(0008, 1150) Referenced SOP Class UID UI: ...
(0008, 1155) Referenced SOP Instance UID
...
------------
...
# Supported types are: POINT, OPEN_PLANAR, CLOSED_PLANAR, CLOSEDPLANAR_XOR.
(3006, 0042) Contour Geometric Type CS: 'CLOSED_PLANAR'
(3006, 0046) Number of Contour Points IS: '330'
...
# Flattened sequence of (x, y, z) contour coordinates in patient-based
# coordinate system.
(3006, 0050) Contour Data DS: Array of 990 elements
------------
...
...
(3006, 0084) Referenced ROI Number IS: '1'
------------
...
...
👋 Need help? Contact us via website or email
🚀 Join our Slack Community
💻 For more resources: Blog | GitHub | Tutorial Page
🛠️ Need Technical Assistance? Connect with Datature Experts or chat with us via the chat button below 👇
Updated 3 days ago