| Deletions are marked like this. | Additions are marked like this. |
| Line 42: | Line 42: |
| in its most basic usage, the user supplies the DICOM group and element IDs of the data item to be queried along with the path to a DICOM file, and mri_probedicom prints the value of the data item to stdout. if the file is not a DICOM file it will exit with a non-zero status. it is also possible to view the image, dump the pixel data to a file, and print out a basic set of information | in its most basic usage, the user supplies the DICOM group and element IDs of the data item to be queried along with the path to a DICOM file, and mri_probedicom prints the value of the data item to stdout. if the file is not a DICOM file it will exit with a non-zero status. it is also possible to view the image, dump the pixel data to a file, and print out a basic set of information |
Name
mri_probedicom - queries a dicom file
Synopsis
mri_probedicom --i [dicomfile] [<options>]
Positional Arguments
none
Required Flagged Arguments
--i [dicomfile] |
path to dicom file |
path to the dicom file to probe. if this is the only option, a basic set of data will be printed out, including the Siemens ASCII header (if its a Siemens DICOM file) |
Optional Flagged Arguments
--t [group element] |
dicom group and element |
group and element IDs in hexidecimal. eg, --t 10 10 will return the Patient Name. the software will compute the actual tag |
--d [directive] |
[val] filetype, tag, desc, mult, rep |
specifies the aspect of the data item to probe. possible values are: |
|
|
val - print out the value of the item (default) |
|
|
filetype - type of file. return values are bigendian, littleendian, part10, or notadicom. even if the not a DICOM file, the exit status will still be zero. it is not necessary to supply a tag with this directive |
|
|
tag - numeric value of the tag created by combining the group and element IDs |
|
|
desc - description of the item |
|
|
mult - multiplicity |
|
|
rep - representation |
--view |
view the image |
display the image in an X window. ignores the tag option |
--o [file] |
dump binary pixel data into file |
dump the binary pixel data to filename |
--ob stem |
dump binary pixel data into bshort |
dump the binary pixel dat to stem.bshort and create header stem.hdr |
--dictionary |
dump dicom dictionary and exit |
print out the DICOM dictionary. this just calls the CTN program dcm_print_dictionary (which must be in your path). ignores all other options |
--help |
how to use this program |
|
Outputs
stdout |
result of data item probing |
filename |
dump of the binary pixel data |
dictionary |
printout of the DICOM dictionary |
Description
in its most basic usage, the user supplies the DICOM group and element IDs of the data item to be queried along with the path to a DICOM file, and mri_probedicom prints the value of the data item to stdout. if the file is not a DICOM file it will exit with a non-zero status. it is also possible to view the image, dump the pixel data to a file, and print out a basic set of information
this uses the DICOM CTN libraries from Mallinckrodt Institute of Radiology (http://dicomctn.wustl.edu/DICOM/ctn-docs/doc_index.html)
Examples
Example 1
command foo -i f -o out
description
Example 2
command foo -i f -o out -f fvalue
description
Bugs
this has only been tested on Siemens DICOM files but it should work on any DICOM file. note: the CTN software does not support float and double DICOM data formats
See Also
["othercommand1"], ["othercommand2"]
Links
Methods Description
description description
References
["References/Lastname###"]
Reporting Bugs
Report bugs to <analysis-bugs@nmr.mgh.harvard.edu>