UTILITY DTI2NTF

--------------------------------------------------------------------------------

UTILITY DTI2NTF

--------------------------------------------------------------------------------

--------------------------------------------------------------------------------

FUNCTION

--------------------------------------------------------------------------------

FORMAT


--------------------------------------------------------------------------------

PROMPTS


--------------------------------------------------------------------------------

PARAMETERS

--------------------------------------------------------------------------------

COMMAND QUALIFIERS

--------------------------------------------------------------------------------

DESCRIPTION

--------------------------------------------------------------------------------

RESTRICTIONS

--------------------------------------------------------------------------------

EXAMPLES

 $ DTI2NTF /LOG  INPUT1,INPUT2,INPUT3  OUTPUT<CR>

%DTI2NTF-I-INFILOPN, Opening file LSL$DTI:INPUT1.DTI for read %DTI2NTF-I-INFILOPN, Opening file LSL$DTI:INPUT2.DTI for read %DTI2NTF-I-INFILOPN, Opening file LSL$DTI:INPUT3.DTI for read %DTI2NTF-W-MISC, FIELD_WIDTH = 0 is too small -DTI2NTF-I-MISC, Using calculated width 8 %DTI2NTF-I-NTFOPEN, NTF file OUTPUT.NTF opened for output %DTI2NTF-I-MISC, Header written to NTF dataset %DTI2NTF-I-MISC, NTF dataset will be version 1.00, level 4 %DTI2NTF-I-MISC, Processing file "1" of "3" %DTI2NTF-I-INFILOPN, Opening file LSL$DTI:INPUT1.DTI for read %DTI2NTF-I-MISC, GridHeader record written %DTI2NTF-I-MISC, Processing DTI matrix 100.00% Complete %DTI2NTF-I-MISC, Processing file "2" of "3" %DTI2NTF-I-INFILOPN, Opening file LSL$DTI:INPUT2.DTI for read %DTI2NTF-I-MISC, GridHeader record written %DTI2NTF-I-MISC, Processing DTI matrix 100.00% Complete %DTI2NTF-I-MISC, Processing file "3" of "3" %DTI2NTF-I-INFILOPN, Opening file LSL$DTI:INPUT3.DTI for read %DTI2NTF-I-MISC, GridHeader record written %DTI2NTF-I-MISC, processing DTI matrix 100.00% Complete ELAPSED: 0 00:00:07.06 CPU: 0:00:01.15 BUFIO: 16 DIRIO: 10 FAULTS: 110

In this example the input DTI files were given as INPUT1,INPUT2 and INPUT3. These are parsed and any part of the filenames that were missing are taken from LSL$DTI:DTI.DTI. The NTF dataset is to be written to "OUTPUT" which will be parsed and called OUTPUT.NTF.

The input DTI files are opened and DTI2NTF calculates the minimum "field-width" that will be needed for the data to be output correctly. Since the field-width was not specified in the command line, it was set at zero. The program detects that the field width is not sufficient and sets it to the value it calculated. A volume header is written to the NTF dataset and processing of the input DTI files is begun.

Each file is opened and a corresponding header entry is written to the NTF dataset. The program then processes the DTI matrix and writes the information to the NTF dataset. If the program is run on a terminal, a running total of how much of the input DTI file has been processed, is displayed at the bottom of the screen. When the counter reaches 100.00_% the program has completed processing of the current DTI file.

The creation of the NTF dataset is completed successfully.

 $ DTI2NTF /LOG  /LEV=0  INPUT1,INPUT2,INPUT3  OUTPUT<CR>

%DTI2NTF-I-NTFOPEN, NTF File OUTPUT.NTF opened for output %DTI2NTF-I-MISC, Header written to NTF dataset %DTI2NTF-I-MISC, NTF dataset will be version 1.00, level 0 %DTI2NTF-I-MISC, Processing file "1" of "3" %DTI2NTF-I-INFILOPN, Opening file LSL$DTI:INPUT1.DTI for read %DTI2NTF-I-MISC, GridHeader record written %DTI2NTF-I-MISC, Processing DTI matrix 100.00% Complete %DTI2NTF-I-MISC, Processing file "2" of "3" %DTI2NTF-I-INFILOPN, Opening file LSL$DTI:INPUT2.DTI for read %DTI2NTF-I-MISC, GridHeader record written %DTI2NTF-I-MISC, Processing DTI matrix 100.00% Complete %DTI2NTF-I-MISC, Processing file "3" of "3" %DTI2NTF-I-INFILOPN, Opening file LSL$DTI:INPUT3.DTI for read %DTI2NTF-I-MISC, GridHeader record written %DTI2NTF-I-MISC, Processing DTI matrix 100.00% Complete ELAPSED: 0 00:00:07.06 CPU: 0:00:01.15 BUFIO: 16 DIRIO: 10 FAULTS: 110

In this instance the output dataset is to be written at level 0. Since the field width for the data cannot be redefined, the program does not attempt to calculate the minimum field width required. The remainder of the conversion is similar to the example defined above. The conversion is a success.

$ TYPE INPUT.LIS
  INPUT1
  INPUT2.DTI
  INPUT3.DTM
$ DTI2NTF /LOG /INPUT=input.lis /LEV=0 OUTPUT  <CR>
%DTI2NTF-I-INFILOPN, Opening file INPUT.LIS for read
%DTI2NTF-I-NTFOPEN, NTF File "OUTPUT.NTF" opened for output
%DTI2NTF-I-MISC, Header written to NTF dataset
%DTI2NTF-I-MISC, NTF dataset will be version 1.00, level 0
%DTI2NTF-I-MISC, Processing file "1" of "3"
%DTI2NTF-I-INFILOPN, Opening file LSL$DTI:INPUT1.DTI for read
%DTI2NTF-I-MISC, GridHeader record written
%DTI2NTF-I-MISC, processing DTI matrix
100.00% Complete
%DTI2NTF-I-MISC, Processing file "2" of "3"
%DTI2NTF-I-INFILOPN, Opening file LSL$DTI:INPUT2.DTI for read
%DTI2NTF-I-MISC, GridHeader record written
%DTI2NTF-I-MISC, processing DTI matrix
100.00% Complete
%DTI2NTF-I-MISC, Processing file "3" of "3"
%DTI2NTF-I-INFILOPN, Opening file LSL$DTI:INPUT3.DTI for read
%DTI2NTF-I-MISC, GridHeader record written
%DTI2NTF-I-MISC, processing DTI matrix
100.00% Complete
 ELAPSED:    0 00:00:07.06  CPU: 0:00:01.15  BUFIO: 16  DIRIO: 10  FAULTS: 110 

In this example the names for the input DTI files were taken from the file INPUT.LIS which was specified with the /INPUT qualifier. The DTI files are processed in the same way as in the above examples and the conversion is a success.

See dti2ntfmsg.html generated from DTI2NTFMSG.RNO.