DICOM_Dir 1.0 DICOM_Dir is toll to create DICOMDIR for Windows 95/98/NT/2000/XP/Vista (tm). Installing DICOM_Dir DICOM_Dir does not require any special installation. Just copy the files in a directory of your choice and use it from there. However if you want to use the DICOM_Dir.ini file, you must copy it either in the TomoVision instalation directory (if you have DICOMatic or sliceOmatic, then it is the directory where you installed these application, otherwhise it is C:\Program Files\TomoVision) or in the user's application directory (C:\Documents and Settings\user's name \Application Data\TomoVision). The User's Manual Using DICOM_Dir is quite straightforward. Just drag&drop the root of a directory tree on the program's interface. The program will parse this tree and locate all DICOM part 10 files in it. It will then create a DICOMDIR file for these in the root directory. The program can read a DICOM_dir.ini file if it exist either in the Tomovision's instalation directory (by default: c:\Program Files\TomoVision) or in the user's application directory (C:\Documents and Settings\user's name\Application Data\TomoVision) By default, the DICOM_Dir will create the following tags: (0010,0010) Patient Name in the [PATIENT] section. (0020,000D) Study Instance UID in the [STUDY] section. (0020,000E) Series Instance UID in the [SERIES] section. (0008,0018) SOP Instance UID in the [IMAGE] section. This .ini file contain a list of additional DICOM tags that can DICOM_dir will write to the DICOMDIR file. If these tags are present in the original files, they will be written in the appropriate section of the DICOMDIR file. You can specify tags for 4 sections of the DICOMDIR file: [PATIENT], [STUDY], [SERIES], and [IMAGE]. The syntax is: - everything on a line following a ";" character is a comment. - the lines are composed of a key word (terminated by "=") followed by a space followed by an argument. - arguments containing spaces must be protected by quotes ex scratch: "c:\name with spaces must be quoted" - the key words are not case sensitive. The key words are: tag_patient = (xxxx,yyyy) tag_study = (xxxx,yyyy) tag_series = (xxxx,yyyy) tag_image = (xxxx,yyyy) Where: xxxx is the tag's group and yyyy is the tag's element in hexadecimal. Here's a sample .ini file: ; --- Patient tags --- ; You need to list here all the tags you want to see in the [PATIENT] ; section of the DICOMDIR. All tgas must be sorted in increasing ; order of groups and elements. ; ; Note: The tags (0010,0010) "Patient Name" MUST be present! ; tag_patient = (0010,0010) ; Patient Name (--- REQUIRED! ---) tag_patient = (0010,0020) ; Patient ID tag_patient = (0010,0030) ; Patient DoB tag_patient = (0010,0040) ; Patient Sex ; --- Study tags --- ; You need to list here all the tags you want to see in the [STUDY] ; section of the DICOMDIR. All tgas must be sorted in increasing ; order of groups and elements. ; ; Note: The tags (0020,000D) "Study UID" MUST be present! ; tag_study = (0008,0020) ; Study Date tag_study = (0008,0030) ; Study Time tag_study = (0008,0050) ; Accession number tag_study = (0008,1030) ; Study Description tag_study = (0020,000D) ; Study Instance UID (--- REQUIRED! ---) tag_study = (0020,0010) ; Study ID ; --- Series tags --- ; You need to list here all the tags you want to see in the [SERIES] ; section of the DICOMDIR. All tgas must be sorted in increasing ; order of groups and elements. ; ; Note: The tags (0020,000E) "Series UID" MUST be present! ; tag_series = (0008,0021) ; Series Date tag_series = (0008,0031) ; Series Time tag_series = (0008,0060) ; Modality tag_series = (0020,000E) ; Series Instance UID (--- REQUIRED! ---) tag_series = (0020,0011) ; Series Number ; --- Image tags --- ; You need to list here all the tags you want to see in the [IMAGE] ; section of the DICOMDIR. All tgas must be sorted in increasing ; order of groups and elements. ; ; Note: The tags (0008,0018) "SOP Instance UID" MUST be present! ; tag_image = (0008,0008) ; Image Type tag_image = (0008,0018) ; SOP Instance UID (--- REQUIRED! ---) tag_image = (0008,0023) ; Content Date tag_image = (0008,0033) ; Content Time tag_image = (0020,0013) ; Instance Number tag_image = (0020,0032) ; Image Position tag_image = (0020,0037) ; Image Orientation tag_image = (0020,0052) ; Frame of Reference UID tag_image = (0028,0010) ; Image Row tag_image = (0028,0011) ; Image Columns tag_image = (0028,0030) ; Pixel Spacing In Batch mode The program can also be used in a batch or called by another program. If it has directory names as command line arguments, it will process these directories without oppening an interface window. The return codes will be 0 if it complete without problems, 1 if some files names are to long, 2 if some file names contain illegal characters and 3 if both. Distributing You are encouraged to pass a copy of DICOM_Dir along to your friends. If you do so, you must provide them with the entire set of DICOM_Dir files. These include: DICOM_Dir.exe DICOM_Dir_readme.txt license.txt ============================================================ DICOM_Dir revision history ====== DICOM_Dir 1.0 rev 2 ====== Add a cancelation window ====== DICOM_Dir 1.0 rev 1 ====== First release ============================================================ Disclaimer of Warranty: DICOM_Dir is provided on an "AS IS" basis, without warranty of any kind, including without limitation the warranties of merchantability, fitness for a particular purpose and non-infringement. LIMITATION OF LIABILITY. Good data processing procedure dictates that any program be thoroughly tested with non-critical data before relying on it. The user must assume the entire risk of using the program. Virtual Magic Inc. Makes no representation or warranty with respect to the adequacy of TomoVision for any particular purpose or with respect to its adequacy to produce any particular results. In no events shall Virtual Magic Inc., its employees or its suppliers be liable for special, direct, indirect or consequential damages, losses, costs, changes, claims, demands, or claim for lost profits, fees, or expenses of any nature.