| Deletions are marked like this. | Additions are marked like this. |
| Line 9: | Line 9: |
|
[[Navigation(children)]] '''Index''' [[TableOfContents]] |
|
| Line 10: | Line 15: |
| mri_probedicom - queries a dicom file | mri_probedicom - queries a ["DICOM"] file |
| Line 13: | Line 18: |
| mri_probedicom --i [dicomfile] [<options>] | mri_probedicom --i dicomfile [<options>] |
| Line 15: | Line 20: |
| = Positional Arguments = |
= Arguments = == Positional Arguments == |
| Line 18: | Line 24: |
|
= 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) || |
== 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) || |
| Line 21: | Line 27: |
|
= 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: || |
== 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: || |
| Line 31: | Line 37: |
| || --o [file] || dump binary pixel data into file || dump the binary pixel data to filename || | || --o file || dump binary pixel data into file || dump the binary pixel data to filename || |
| Line 42: | Line 48: |
| 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 | mri_probedicom prints the value of the specified DICOM group and element 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 |
| Line 44: | Line 50: |
| this uses the DICOM CTN libraries from Mallinckrodt Institute of Radiology (http://dicomctn.wustl.edu/DICOM/ctn-docs/doc_index.html) | Uses the DICOM CTN libraries from Mallinckrodt Institute of Radiology (http://dicomctn.wustl.edu/DICOM/ctn-docs/doc_index.html) |
| Line 48: | Line 54: |
|
command foo -i f -o out description |
?? |
| Line 53: | Line 57: |
|
command foo -i f -o out -f fvalue description |
?? |
| Line 58: | Line 60: |
| 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 | mri_probedicom 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 |
Navigation(children) Index TableOfContents
Name
mri_probedicom - queries a ["DICOM"] file
Synopsis
mri_probedicom --i dicomfile [<options>]
Arguments
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
mri_probedicom prints the value of the specified DICOM group and element 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
Uses the DICOM CTN libraries from Mallinckrodt Institute of Radiology (http://dicomctn.wustl.edu/DICOM/ctn-docs/doc_index.html)
Examples
Example 1
??
Example 2
??
Bugs
mri_probedicom 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>