DICOMTOCSV(1)

👑 NAME ✨

dicomtocsv — it's a vtk-dicom CLI thing, bestie 💅

---

🌸 DESCRIPTION ✨

okay so basically this is the dicomtocsv command from vtk-dicom, and she is serving 💖

🌈 usage:

dicomtocsv [options] <directory>

💫 options:

• -k tag=value — hand her a tag or key that you wanna query and match on. 🎀
• -q <query.txt> — give her a file that describes the find query.
• -u <uids.txt> — give her a file with a list of UIDs in it.
• -o <data.csv> — the file where the query results go.
• -maxdepth n — sets the max directory depth for the search, periodt.
• --default — adds to the default query instead of straight-up replacing it.
• --first-nonzero — searches each series for the first nonzero value of every key.
• --all-unique — reports every unique value found inside each series.
• --min-value — reports the minimum value within each series.
• --max-value — reports the maximum value within each series.
• --directory-only — do not scan files if a DICOMDIR is present.
• --ignore-dicomdir — ignore the DICOMDIR file even if it is there, no cap 🙈
• --charset <cs> — the charset to use if SpecificCharacterSet is missing.
• --images-only — only list files that have PixelData or the equivalent.
• --noheader — do not print the csv header.
• --study — print one row for each study.
• --series — print one row for each series (this is the default, she's the main character 👑).
• --image — print one row for each image.
• --silent — do not report any progress information. shhh 🤫
• --help — print a brief help message.
• --version — print the software version.

---

so what she actually does: dumps selected metadata out of a DICOM directory and into a csv file. iconic behaviour fr fr 🦋

for every attribute you wanna extract, you can pass the tag with -k, and you can repeat that -k option as many times as you need — go off, spam it 💅 tags can be given in hexadecimal GGGG,EEEE format, or in text format as specified in the DICOM dictionary key. or, alternately, you can list all the tags in a query file that you hand over with the -q option, one tag per line. 📝

and listen — attributes nested inside sequences? you can specify those with a tag path, like -k Tag1/Tag2/Tag3. either a forward slash or a backslash can separate the components of that path, whichever vibe you're feeling. private tags should be preceded by the private dictionary name in square brackets. 🎀

now here's the tea 🫖 if the same tag shows up more than once with -k — or if it's listed multiple times in the query file, or it appears in both the query file and as a -k option — then its first appearance sets the column number that it appears in. also, as far as the search goes, the value specified in the final appearance of the tag as an option is the value that gets used for the search. yes bestie, first one picks the column, last one picks the search value. that's just how she is 💀

and if you specify no attributes at all with either -k or -q, then a default set of query attributes gets used. she's got you covered either way 💖

---

🫶 AUTHOR ✨

this manual page was written by Mathieu Malaterre <malat@debian.org> for the Debian GNU/Linux system, but it may be used by others. shoutout to him, absolute legend 🌟

---

and that's the whole page bestie, no notes 💅 this was dicomtocsv version 0.8.17, dated August 2026, from the DICOMTOCSV(1) manual — slay, go query some DICOMs 🔥✨💜