Scroll to navigation



dicomtocsv - vtk-dicom CLI



dicomtocsv [options] <directory>


Provide a key to be queried and matched.
Provide a file to describe the find query.
Provide a file that contains a list of UIDs.
Provide a file for the query results.
Add to default query instead of replacing it.
Search series for first nonzero value of each key.
Report all unique values within each series.
Report the minimum value within each series.
Report the maximum value within each series.
Do not scan files if DICOMDIR is present.

--ignore-dicomdir Ignore the DICOMDIR file even if it is present.

Charset to use if SpecificCharacterSet is missing.
Only list files that have PixelData or equivalent.
Do not print the csv header.
Print one row for each study.
Print one row for each series (default).
Print one row for each image.
Do not report any progress information.
Print a brief help message.
Print the software version.

Dump selected metadata from a DICOM directory to a csv file. For each attribute to be extracted, the tag can be given with "-k" (the "-k" option can be repeated as many times as needed). Tags can given in hexadecimal GGGG,EEEE format, or in text format as specified in the DICOM dictionary. Alternately, the tags can be listed in a query file given with the "-q" option (one tag per line). Attributes nested within sequences can be specified by giving a tag path e.g. "-k Tag1/Tag2/Tag3". Either a forward slash or a backslash can be used to separate the components of the path. Private tags should be preceded by the private dictionary name in square brackets.

If the same tag is given more than once with "-k" (or if the tag is listed multiple times in the query file, or appears in both the query file and as a "-k" option), then its first appearance will set the column number that it appears in. Also, with regards to the search, the value specified in the final appearance of the tag as an option will be the value used for the search.

If no attributes are specified with either "-k" or "-q", then a default set of query attributes will be used.


This manual page was written by Mathieu Malaterre <> for the Debian GNU/Linux system, but may be used by others.

June 2022 dicomtocsv 0.8.13