PYDICOM-CODIFY(1)

💖 PYDICOM-CODIFY 💖

okay bestie, listen. you know that thing where you have a DICOM file and you desperately need the pydicom (Python) code that would build that exact file from scratch? yeah. that's this. pydicom-codify reads a DICOM file and spits out the pydicom Python code that can create that file. it's giving reverse-engineering but make it cute. ✨

---

🌸 SYNOPSIS 🌸

pydicom codify [-h] [-e EXCLUDE_SIZE] [-p] [-s SAVE_AS] filespec [outfile]

---

🎀 OPTIONS 🎀

✨ POSITIONAL ARGUMENTS ✨

• filespec — the file spec, and she has range. the format is [pydicom::]filename[::element]. if you put the pydicom:: prefix in front, it grabs the pydicom test file with that name. if you hand her an element, she uses only that one data element inside the file. no cap. 💅

Examples, copy these exactly bestie:

path/to/your_file.dcm
your_file.dcm::StudyDate
pydicom::rtplan.dcm::BeamSequence[0]
yourplan.dcm::BeamSequence[0].BeamNumber

• outfile — the filename to write the Python code into. and if you don't give her one? the code just goes straight to stdout, right there in your terminal, main character behaviour. 🫶

💜 OPTIONAL ARGUMENTS 💜

• -h, --help — show a help message and dip. the classic. 🙈
• -e EXCLUDE_SIZE, --exclude-size EXCLUDE_SIZE — excludes binary data bigger than whatever you specify. the default is 100 bytes, so anything chunkier than that gets ghosted. 💀
• -p, --include-private — includes private data elements. the default is to exclude them, so if you want them you gotta ask. 🌈
• -s SAVE_AS, --save-as SAVE_AS — sets the filename used in ds.save_as(save_filename). if you don't pick one, she just uses your input name + _from_codify. iconic. 👑

---

📝 NOTES 📝

real talk, important stuff here:

• Binary data (like, say, pixels 🖼️) that's larger than --exclude-size (default 100 bytes) is not included. instead you get a dummy line with a syntax error. yes, a syntax error, on purpose, so you notice. 😭
• Private data elements are not included by default. that's what -p is for.

---

👀 SEE ALSO 👀

• pydicom(1)
• pydicom-help(1), pydicom-show(1)

---

okay that's the whole vibe. go forth and codify, bestie. you're literally the moment. 💅✨

this has been PYDICOM-CODIFY(1), from the September 2024 era — stan a classic. 🎀🦋 bye pookie!! 🫶