A Visual Studio Code (vscode) extension that dumps DICOM tag contents. DICOM is a standard file format for medical images.
Open a context menu on a DICOM file and select "DICOM: Dump DICOM tags".
dicom.alwaysShowMenu
(default = false
) controls the visibility of the
dump menus. When set to true, the menus will show up regardless of the
file extension. When set to false, the menus will show up when the
extension of the file is *.dcm
or *.dicom
.
dicom.showPrivateTags
(default = false
) controls the
visibility of DICOM private tags. Set this to true
to dump everything.
Note that many private tags have 'UN' (unknown) VR type, which means
this extension does not know how to stringify them.
dicom.dictionary
(default = {}
) modifies or adds entries to
the standard DICOM dictionary. Example:
{
"dicom.dictionary": {
"01F51247": { "vr": "US", "name": "myPrivateNumericalTag" },
"01F51248": { "vr": "LO", "name": "myPrivateTextTag", "forceVr": true }
}
}
forceVr: true
will forcibly overwrite the VR type even if
another type is explicitly specified in the DICOM file.
This may allow you to sniff the contents of some private tags.
dicom.searches
(default = []
) provides a quick link to your favorite
DICOM search engine when the mouse hovers on a tag string. Example:
{
"dicom.searches": [
{
"title": "Search {GGGG},{EEEE} on Google",
"url": "https://www.google.com/search?q=DICOM%20{GGGG},{EEEE}"
}
]
}
Four keywords ({GGGG}
, {gggg}
, {EEEE}
and {eeee}
) will be replaced.
My DICOM file does not load at all!: Can you open that file with dicom-parser's online demo? If not, probably your DICOM file is not standard-compliant, and there is little I can do. Some DICOM implementations are tolerant enough to open mildly broken files. Just because you can view your file with <insert your favorite viewer here> does not mean the file is not corrupted. If you could open the file with the demo above and are still getting an error from this extension, feel free to report as a bug.
The "Dump DICOM tags" context menu doesn't show up!: By default, the menus will be displayed only when the file extension is *.dcm
or *.dicom
. Please check the dicom.alwaysShowMenu
option.
Patient/institution names are garbled!: Currently the character encoding support is limited and buggy, and it's partially due to the fact that DICOM uses rare character encodings not supported by iconv-lite. Also note that some DICOM implementations store multibyte strings with a totally wrong encoding (e.g., Japanse SJIS). I'd rather not support all sorts of malformed files "in the wild", but reasonable suggestions and PRs are welcome.
USE AT YOUR OWN RISK. DO NOT USE THIS FOR CLINICAL PURPOSES.
Plase use GitHub's issue system.
This extension is based on the following awesome packages.