Skip to content

detection

detection

Vendor auto-detection for DICOM files.

This module provides automatic detection of scanner vendor from DICOM metadata and returns the appropriate parser.

detect_vendor

detect_vendor(dcm)

Detect scanner vendor from DICOM dataset.

PARAMETER DESCRIPTION
dcm

DICOM dataset with Manufacturer tag.

TYPE: Dataset

RETURNS DESCRIPTION
str

Vendor name: 'Siemens', 'GE', 'Philips', or 'Unknown'.

Examples:

>>> import pydicom
>>> dcm = pydicom.dcmread("scan.dcm")
>>> vendor = detect_vendor(dcm)
>>> print(vendor)
'Siemens'

get_vendor_parser

get_vendor_parser(dcm)

Get the appropriate vendor parser for a DICOM dataset.

PARAMETER DESCRIPTION
dcm

DICOM dataset to parse.

TYPE: Dataset

RETURNS DESCRIPTION
VendorParser | None

Matching vendor parser, or None if vendor not supported.

Examples:

>>> import pydicom
>>> dcm = pydicom.dcmread("siemens_scan.dcm")
>>> parser = get_vendor_parser(dcm)
>>> if parser:
...     metadata = parser.extract_metadata(dcm)

extract_vendor_metadata

extract_vendor_metadata(dcm)

Extract vendor-specific metadata from DICOM dataset.

This is a convenience function that auto-detects the vendor and extracts metadata using the appropriate parser.

PARAMETER DESCRIPTION
dcm

DICOM dataset to parse.

TYPE: Dataset

RETURNS DESCRIPTION
VendorMetadata

Extracted metadata. If vendor is not recognized, returns metadata with only standard DICOM fields.

Examples:

>>> import pydicom
>>> dcm = pydicom.dcmread("scan.dcm")
>>> metadata = extract_vendor_metadata(dcm)
>>> print(f"Vendor: {metadata.vendor}")
>>> print(f"TR: {metadata.tr} ms")

list_supported_vendors

list_supported_vendors()

List all supported scanner vendors.

RETURNS DESCRIPTION
list[str]

List of supported vendor names.