Hoffman2:Scripts:dcmheader.py: Difference between revisions

From Center for Cognitive Neuroscience
Jump to navigation Jump to search
Line 31: Line 31:
(0010, 0010) is the tag for item “Patient's Name”, you'll need this information for using -c (--check) and -u (--update) options.
(0010, 0010) is the tag for item “Patient's Name”, you'll need this information for using -c (--check) and -u (--update) options.
   
   
-c (--check) option:
--check (or -c)
This option is to view specific header items in a dcm file or the same items in all files inside the subject folder
View specific header items in a dcm file or the same items in all files inside the subject folder
   
   
Example:
View a single item:
View a single item:
python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/file -c "(0010, 0010)"
python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/file -c "(0010, 0010)"
   
   
View a single item in a subject folder by specifying the folder instead of a file:
View a single item in a subject folder by specifying the folder instead of a file:
python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/ -c "(0010, 0010)"
python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/ -c "(0010, 0010)"
   
   
View multiple items:
View multiple items of a single file:
python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/file -c  "(0010, 0010) (0010, 0020)"
python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/file -c  "(0010, 0010) (0010, 0020)"
python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/ -c  "(0010, 0010) (0010, 0020)"
 
View multiple items of all files under one subject folder:
python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/ -c  "(0010, 0010) (0010, 0020)"
   
   
-u (--update) option:
--update (or -u)
This option is for updating specific header items, using the format as "tag=new_value"
Updating specific header items, using the format as "tag=new_value"  
 
Example:
Example:
update a single item (in this example, change the Patient's Name value to 12345_1):
update a single item (in this example, change the Patient's Name value to 12345_1):
python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/file -u "(0010, 0010)=12345_1"
python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/file -u "(0010, 0010)=12345_1"
update the same item for the whole subject folder
 
python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/ -u "(0010, 0010)=12345_1"
update the same item for every files under the same subject folder
python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/ -u "(0010, 0010)=12345_1"

Revision as of 22:27, 27 April 2020

Purpose:

To view and edit a Dicom file header information or header of Dicom files under the same subject folder

Usage:

To use this script, you need to load python module first and export the library location:

module load python/3.6.1_shared
PYTHONPATH=/u/project/CCN/apps/python_libs/3.6/site-packages/

To see the usage of this script

python3 /u/project/CCN/apps/scripts/dcmheader.py -h

Options:

--print (or -p)

Showing the full header of a dcm file python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/file -p (or --print )

(This option can take only a single dicom file as argument)

Example of a part of the output from option --print

(0010, 0010) Patient's Name                      PN: '12345'
(0010, 0020) Patient ID                          LO: 12345
(0010, 0030) Patient's Birth Date                DA: '20000101'
(0010, 0040) Patient's Sex                       CS: 'F'
(0010, 1010) Patient's Age                       AS: '020Y'

(0010, 0010) is the tag for item “Patient's Name”, you'll need this information for using -c (--check) and -u (--update) options.

--check (or -c)

View specific header items in a dcm file or the same items in all files inside the subject folder

Example: View a single item:

python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/file -c "(0010, 0010)"

View a single item in a subject folder by specifying the folder instead of a file:

python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/ -c "(0010, 0010)"

View multiple items of a single file:

python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/file -c  "(0010, 0010) (0010, 0020)"

View multiple items of all files under one subject folder:

python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/ -c  "(0010, 0010) (0010, 0020)"

--update (or -u) Updating specific header items, using the format as "tag=new_value"

Example: update a single item (in this example, change the Patient's Name value to 12345_1):

python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/file -u "(0010, 0010)=12345_1"

update the same item for every files under the same subject folder

python3 /u/project/CCN/apps/scripts/dcmheader.py -f /path/to/my/dicom/subject/ -u "(0010, 0010)=12345_1"