dicomtocsv(1) vtk-dicom CLI



dicomtocsv [options] <directory>


-k tag=value
Provide a key to be queried and matched.
-q <query.txt>
Provide a file to describe the find query.
-u <uids.txt>
Provide a file that contains a list of UIDs.
-o <data.csv>
Provide a file for the query results.
Search series for first nonzero value of each key.
--directory-only Use directory scan only, do not re-scan files.
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 <[email protected]> for the Debian GNU/Linux system, but may be used by others.