fix(tools): Add support for additional region data types and length variants

[simonbertoli]

Context

Update SUPPORTED_REGION_DATA_TYPES, SUPPORTED_LENGTH_VARIANT and SUPPORTED_PROBE_VARIANT in
packages/tools/src/utilities/getCalibratedUnits.ts

Given the dicom standards here, it would be beneficial to update the package with these values so as to allow dicom scans to reference the correct measurements.

Changes & Results

• Added Color Flow, PW Spectral Doppler and CW Spectral Doppler to SUPPORTED_REGION_DATA_TYPES
• Added x: seconds & y : cm/sec to SUPPORTED_LENGTH_VARIANT and SUPPORTED_PROBE_VARIANT

Relevant Dicom MetaData Tags

(0008,0005) CS [ISO_IR 6]                               #   8, 1 SpecificCharacterSet
(0008,0016) UI =UltrasoundImageStorage                  #  28, 1 SOPClassUID
(0018,6011) SQ (Sequence with explicit length #=2)      # 396, 1 SequenceOfUltrasoundRegions
  (fffe,e000) na (Item with explicit length #=15)         # 180, 1 Item
    (0018,6012) US 1                                        #   2, 1 RegionSpatialFormat
    (0018,6014) US 2                                        #   2, 1 RegionDataType
    (0018,6016) UL 0                                        #   4, 1 RegionFlags
    (0018,6018) UL 378                                      #   4, 1 RegionLocationMinX0
    (0018,601a) UL 50                                       #   4, 1 RegionLocationMinY0
    (0018,601c) UL 636                                      #   4, 1 RegionLocationMaxX1
    (0018,601e) UL 254                                      #   4, 1 RegionLocationMaxY1
    (0018,6020) SL 130                                      #   4, 1 ReferencePixelX0
    (0018,6022) SL 0                                        #   4, 1 ReferencePixelY0
    (0018,6024) US 3                                        #   2, 1 PhysicalUnitsXDirection
    (0018,6026) US 3                                        #   2, 1 PhysicalUnitsYDirection
    (0018,602c) FD 0.078048778743278699                     #   8, 1 PhysicalDeltaX
    (0018,602e) FD 0.078048778743278691                     #   8, 1 PhysicalDeltaY
    (0018,6030) UL 1670                                     #   4, 1 TransducerFrequency
    (0018,6032) UL 4357                                     #   4, 1 PulseRepetitionFrequency
  (fffe,e00d) na (ItemDelimitationItem for re-encoding)   #   0, 0 ItemDelimitationItem
  (fffe,e000) na (Item with explicit length #=16)         # 200, 1 Item
    (0018,6012) US 3                                        #   2, 1 RegionSpatialFormat
    (0018,6014) US 4                                        #   2, 1 RegionDataType
    (0018,6016) UL 2                                        #   4, 1 RegionFlags
    (0018,6018) UL 50                                       #   4, 1 RegionLocationMinX0
    (0018,601a) UL 262                                      #   4, 1 RegionLocationMinY0
    (0018,601c) UL 913                                      #   4, 1 RegionLocationMaxX1
    (0018,601e) UL 721                                      #   4, 1 RegionLocationMaxY1
    (0018,6020) SL 864                                      #   4, 1 ReferencePixelX0
    (0018,6022) SL 89                                       #   4, 1 ReferencePixelY0
    (0018,6024) US 4                                        #   2, 1 PhysicalUnitsXDirection
    (0018,6026) US 7                                        #   2, 1 PhysicalUnitsYDirection
    (0018,6028) FD 4.95498055009321                         #   8, 1 ReferencePixelPhysicalValueX
    (0018,602a) FD 0                                        #   8, 1 ReferencePixelPhysicalValueY
    (0018,602c) FD 0.0023148148148148144                    #   8, 1 PhysicalDeltaX
    (0018,602e) FD -1.7255434782608694                      #   8, 1 PhysicalDeltaY
    (0018,6032) UL 46296                                    #   4, 1 PulseRepetitionFrequency
  (fffe,e00d) na (ItemDelimitationItem for re-encoding)   #   0, 0 ItemDelimitationItem
(fffe,e0dd) na (SequenceDelimitationItem for re-encod.) #   0, 0 SequenceDelimitationItem

Before

After

Existing values will not be changed only added to. Therefore no change to exisiting functionality, only added support for dicom image metadata.

Checklist

PR

• My Pull Request title is descriptive, accurate and follows the
  semantic-release format and guidelines.

Code

• My code has been well-documented (function documentation, inline comments,
  etc.)

• I have run the yarn build:update-api to update the API documentation, and have
  committed the changes to this PR. (Read more here https://www.cornerstonejs.org/docs/contribute/update-api)

Public Documentation Updates

• The documentation page has been updated as necessary for any public API
  additions or removals.

Tested Environment

• "OS: macOS 15.1.1
• "Node version: v20.15.1
• "Browser: Brave 1.73.89 Chromium: 131.0.6778.69

[stackblitz]

Run & review this pull request in StackBlitz Codeflow.

[netlify]

✅ Deploy Preview for cornerstone-3d-docs ready!

Name	Link
🔨 Latest commit	e8632be
🔍 Latest deploy log	https://app.netlify.com/sites/cornerstone-3d-docs/deploys/6747942a962861000890c229
😎 Deploy Preview	https://deploy-preview-1629--cornerstone-3d-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[jmannau]

Just checking in to see if there's anything we can do to help get this merged?