TIFFTODICOM(1)

πŸŽ€ TIFFTODICOM(1) πŸŽ€

okay bestie, today we're looking at TIFFToDicom πŸ’– it takes a TIFF image and turns it into a DICOM image of a specified or appropriate SOP Class ✨ grab a snack πŸ“ this one has a lot of options


✨ NAME ✨

TIFFToDicom is the one that reads a TIFF image input format file and creates an image of a specified or appropriate SOP Class πŸ¦‹


πŸ’… SYNOPSIS πŸ’…

this is how the command line is structured, no cap:

TIFFToDicom jsonfile inputFile outputFilePrefix [modality [SOPClass
[TransferSyntax]]] [ADDTIFF|DONOTADDTIFF] [USEBIGTIFF|DONOTUSEBIGTIFF]
[ALWAYSWSI|NOTALWAYSWSI] [ADDPYRAMID|DONOTADDPYRAMID]
[MERGESTRIPS|SPLITSTRIPS] [ADDDCMSUFFIX|DONOTADDDCMSUFFIX]
[INCLUDEFILENAME|DONOTINCLUDEFILENAME] [CHANNELFILE channelfile]
[SPACINGMM spacingmm] [SPACINGROWCOLMM spacingrowmm(y) spacingcolmm(x)]
[THICKNESSMM thickness]

πŸ“ DESCRIPTION πŸ“

bestie, this section is literally just one line πŸ’€

Error: Incorrect number of arguments or bad arguments

so if you see that, your args are either the wrong count or not it πŸ™ˆ


🌸 OPTIONS 🌸

these are the vibes for each argument, let's go πŸ’œ

  • jsonfile β€” the JSON file that describes the functional groups, plus the attributes and values to be added or replaced πŸ“‹
  • inputFileName β€” the input file πŸ“
  • outputFilePrefix 🌷
  • outputFileSuffix 🌷
  • modality β€” may be null 🫧
  • sopClass β€” may be null 🫧
  • transferSyntax β€” may be null. it's used if the image is multiframe, but ignored if it's single frame, and single frame is always written uncompressed πŸ¦‹
  • addTIFF β€” whether or not to add a TIFF IFD in the DICOM preamble, so you get a dual=personality DICOM-TIFF file sharing the same pixel data πŸŽ€
  • useBigTIFF β€” whether or not to make a BigTIFF instead of a Classic TIFF file 🌈
  • alwaysWSI β€” whether or not to add WSI-related info even when it's not a WSI SOP Class, like when float gets converted to a parametric map πŸ”₯
  • addPyramid β€” whether or not to add multi-resolution pyramid (downsampled) layers to the TIFF IFD, plus a matching DICOM private data element in the same file ✨
  • mergeStrips β€” whether or not to merge an image with more than one strip into one single DICOM image, or make a separate image or frame for each strip 🧚
  • channelFile β€” may be null 🫧
  • includeFileName β€” whether or not to record the original filename in the DICOM output 🫢
  • spacingrowmm β€” the PixelSpacing 1st value. it's the spacing between adjacent rows (aka the "y" spacing), in mm. use it to override the base layer spacing if that's wrong or missing. may be 0 if not supplied πŸ“
  • spacingcolmm β€” the PixelSpacing 2nd value. it's the spacing between adjacent columns (aka the "x" spacing), in mm. same deal, it overrides the base layer spacing if that's wrong or missing. may be 0 if not supplied πŸ“
  • thicknessmm β€” the SliceThickness and ImagedVolumeDepth value, in mm. may be 0 if not supplied πŸ’–

🧚 EXAMPLES 🧚

here's a real example you can copy and run ✨

$ TIFFToDicom /etc/pixelmed/TIFFToDicom.WSI.json CMU-1.svs my_wsi SM 1.2.840.10008.5.1.4.1.1.77.1.6

🫢 AUTHOR 🫢

this manual page was written by Mathieu Malaterre <malat@debian.org> for the Debian GNU/Linux system (but may be used by others) 🌸


πŸ‘‘ SEE ALSO πŸ‘‘

go check out OrthancWSIDicomizer too, it's giving main character energy 🌈


that's the whole tea, bestie 🫢 this was TIFFToDicom version 20220313 from March 2022, so go be iconic with your TIFFs πŸ’…πŸ’–πŸ¦‹