--------------------------------------------------------------------------------
MODULE DTIROTATE

--------------------------------------------------------------------------------
REPLACES PANACEA module FLIPPANT.

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

FUNCTION

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

FORMAT

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

PROMPTS

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

DTIROTATE COMMAND DEFAULTS

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

DESCRIPTION

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

GENERAL

OPERATION STATES

TYPICAL COMMAND SEQUENCE

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

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

DTIROTATE COMMANDS

_@ COMMAND

--------------------------------------------------------------------------------
_@

--------------------------------------------------------------------------------
FORMAT: _@file-spec

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

DTIROTATE offers the facility of command input from an indirect command file. The '@' character preceding a file-spec will cause DTIROTATE to open and read commands from the specified file until:

Nested command files are not supported (i_.e_. a command file containing an '@' command), although sequential '@' commands are supported when read from SYS$COMMAND.

As an aid to batch log interpretation DTIROTATE will echo all commands read from an indirect command file.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the _@ command:

*** WARNING *** "@" must precede a file-spec

*** WARNING *** Indirect file error - returning to terminal input

*** ERROR *** Can't open indirect command file 'file-spec'

--------------------------------------------------------------------------------
Examples:


DTIROTATE> @PRESETS<CR>
DTIROTATE> ENABLE DIAGNOSTICS
DTIROTATE> ENABLE MIRROR X
DTIROTATE> DISABLE ROTATE
DTIROTATE> FILEIN AREA1


DTI file LSL$DTI:AREA1.DTI;0 opened for read

File    :  LSL$DTI:AREA1.DTI;0
Header  :  LSLA  Data:  WORD

Units are DTI Matrix Values

Matrix Coverage   SW:     1     1  NE:   201   201
Matrix Interval    E:     1         N:     1
Value Range         :    97   to    468

DTIROTATE> FILEOUT AREA1_X
DTIROTATE> RETURN
DTIROTATE>

_! COMMAND

--------------------------------------------------------------------------------
_!

--------------------------------------------------------------------------------
FORMAT: _! [comment text]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

An exclamation mark is the standard MATRIX package comment delimiter. All text (and numbers) which lie to the right of a '!' character are excluded from command interpretation. Comments are useful for annotating command procedures used in batch processing etc_.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


DTIROTATE> _! a comment for the sake of it<CR>
DTIROTATE> ENABLE MIRROR BOTH<CR>
DTIROTATE>

DISABLE DIAGNOSTICS COMMAND

--------------------------------------------------------------------------------
DISABLE DIAGNOSTICS

--------------------------------------------------------------------------------
FORMAT: DISABLE DIAGNOSTICS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE DIAGNOSTICS allows the user to disable a previous ENABLE DIAGNOSTICS command.

--------------------------------------------------------------------------------
Messages:

The following message is specific to the DISABLE command:


*** ERROR *** Specifying command DISABLE

Available DISABLE qualifiers are :
DIAGNOSTICS  MIRROR  PME  ROTATE

--------------------------------------------------------------------------------
Examples:


DTIROTATE> ENABLE DIAGNOSTICS<CR>
DTIROTATE> DISABLE DIAGNOSTICS<CR>
DTIROTATE>

DISABLE MIRROR COMMAND

--------------------------------------------------------------------------------
DISABLE MIRROR

--------------------------------------------------------------------------------
FORMAT: DISABLE MIRROR

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE MIRROR allows the user to disable a previous ENABLE MIRROR command.

--------------------------------------------------------------------------------
Messages:

The following message is specific to the DISABLE command:


*** ERROR *** Specifying command DISABLE

Available DISABLE qualifiers are :
DIAGNOSTICS  MIRROR  PME  ROTATE

--------------------------------------------------------------------------------
Examples:


DTIROTATE> ENABLE MIRROR Y<CR>
DTIROTATE> DISABLE MIRROR<CR>
DTIROTATE>

DISABLE PME COMMAND

--------------------------------------------------------------------------------
DISABLE PME

--------------------------------------------------------------------------------
FORMAT: DISABLE PME

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE PME allows the user to disable a previous ENABLE PME command.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the DISABLE and DISABLE PME commands:


*** ERROR *** Specifying command DISABLE

Available DISABLE qualifiers are :
DIAGNOSTICS  MIRROR  PME  ROTATE

*** WARNING *** You are not using PME !

--------------------------------------------------------------------------------
Examples:


DTIROTATE> ENABLE PME<CR>
DTIROTATE> DISABLE PME<CR>
DTIROTATE>

DISABLE ROTATE COMMAND

--------------------------------------------------------------------------------
DISABLE ROTATE

--------------------------------------------------------------------------------
FORMAT: DISABLE ROTATE

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE ROTATE allows the user to disable a previous ENABLE ROTATE command.

--------------------------------------------------------------------------------
Messages:

The following message is specific to the DISABLE command:


*** ERROR *** Specifying command DISABLE

Available DISABLE qualifiers are :
DIAGNOSTICS  MIRROR  PME  ROTATE

--------------------------------------------------------------------------------
Examples:


DTIROTATE> ENABLE ROTATE<CR>
DTIROTATE> DISABLE ROTATE<CR>
DTIROTATE>

ENABLE DIAGNOSTICS COMMAND

--------------------------------------------------------------------------------
ENABLE DIAGNOSTICS

--------------------------------------------------------------------------------
FORMAT: ENABLE DIAGNOSTICS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE DIAGNOSTICS allows the user to enable diagnostic printout.

Because it is usually used in a batch processing environment, by default DTIROTATE produces minimal diagnostic printout. If however, the user wishes to receive an indication of processing progress, diagnostic printout may be selected with the ENABLE DIAGNOSTICS command.

On a heavily loaded computer it may be reassuring to ENABLE DIAGNOSTICS for the processing stage to indicate progress through the input data.

--------------------------------------------------------------------------------
Messages:

The following message is specific to the ENABLE command:


*** ERROR *** Specifying command ENABLE

Available ENABLE qualifiers are :
DIAGNOSTICS  MIRROR  PME  ROTATE

--------------------------------------------------------------------------------
Examples:


DTIROTATE> ENABLE DIAGNOSTICS<CR>
DTIROTATE>

ENABLE MIRROR BOTH COMMAND

--------------------------------------------------------------------------------
ENABLE MIRROR BOTH

--------------------------------------------------------------------------------
FORMAT: ENABLE MIRROR BOTH

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE MIRROR BOTH will mirror the output DTI about both the x and the y axes. This has the effect of 180 degree rotation. This command if used with the ENABLE ROTATE command would produce an output DTI with 270 degree rotation _(_-90_).

--------------------------------------------------------------------------------
Messages:

The following messages are is specific to the ENABLE and ENABLE MIRROR commands:


*** ERROR *** Specifying command ENABLE

Available ENABLE qualifiers are :
DIAGNOSTICS  MIRROR  PME  ROTATE

*** ERROR *** Specifying the command ENABLE MIRROR

Available ENABLE MIRROR sub-command qualifiers are:

BOTH  X  Y

--------------------------------------------------------------------------------
Examples:


DTIROTATE> DISABLE ROTATE<CR>
DTIROTATE> ENABLE MIRROR BOTH<CR>
DTIROTATE> SHOW PARAMETERS<CR>

PARAMETERS:
MIRROR BOTH enabled  ROTATE disabled
File will be mirrored about both axes 

       INPUT DTI        >>       OUTPUT DTI
 ---------------------       ---------------------
 |  3 |  6 |  9 | 12 |       | 10 |  7 |  4 |  1 |  
 ---------------------       ---------------------
 |  2 |  5 |  8 | 11 |       | 11 |  8 |  5 |  2 |  
 ---------------------       ---------------------
 |  1 |  4 |  7 | 10 |       | 12 |  9 |  6 |  3 |  
 ---------------------       ---------------------


DTIROTATE>

ENABLE MIRROR X COMMAND

--------------------------------------------------------------------------------
ENABLE MIRROR X

--------------------------------------------------------------------------------
FORMAT: ENABLE MIRROR X

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE MIRROR X will mirror the output DTI about the x axis. This command can be used with the ENABLE ROTATE command. The rotate action is performed after the mirror action.

--------------------------------------------------------------------------------
Messages:

The following messages are is specific to the ENABLE and ENABLE MIRROR commands:


*** ERROR *** Specifying command ENABLE

Available ENABLE qualifiers are :
DIAGNOSTICS  MIRROR  PME  ROTATE

*** ERROR *** Specifying the command ENABLE MIRROR

Available ENABLE MIRROR sub-command qualifiers are:

BOTH  X  Y

--------------------------------------------------------------------------------
Examples:


DTIROTATE> DISABLE ROTATE<CR>
DTIROTATE> ENABLE MIRROR X<CR>
DTIROTATE> SHOW PARAMETERS<CR>

PARAMETERS:
MIRROR X enabled  ROTATE disabled
File will be mirrored about the x axis 

       INPUT DTI        >>       OUTPUT DTI
 ---------------------       ---------------------
 |  3 |  6 |  9 | 12 |       |  1 |  4 |  7 | 10 |  
 ---------------------       ---------------------
 |  2 |  5 |  8 | 11 |       |  2 |  5 |  8 | 11 |  
 ---------------------       ---------------------
 |  1 |  4 |  7 | 10 |       |  3 |  6 |  9 | 12 |  
 ---------------------       ---------------------


DTIROTATE>

ENABLE MIRROR Y COMMAND

--------------------------------------------------------------------------------
ENABLE MIRROR Y

--------------------------------------------------------------------------------
FORMAT: ENABLE MIRROR Y

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE MIRROR Y will mirror the output DTI about the y axis. This command can be used with the ENABLE ROTATE command. The rotate action is performed after the mirror action.

--------------------------------------------------------------------------------
Messages:

The following messages are is specific to the ENABLE and ENABLE MIRROR commands:


*** ERROR *** Specifying command ENABLE

Available ENABLE qualifiers are :
DIAGNOSTICS  MIRROR  PME  ROTATE

*** ERROR *** Specifying the command ENABLE MIRROR

Available ENABLE MIRROR sub-command qualifiers are:

BOTH  X  Y

--------------------------------------------------------------------------------
Examples:


DTIROTATE> DISABLE ROTATE<CR>
DTIROTATE> ENABLE MIRROR Y<CR>
DTIROTATE> SHOW PARAMETERS<CR>

PARAMETERS:
MIRROR Y enabled  ROTATE disabled
File will be mirrored about the y axis 

       INPUT DTI        >>       OUTPUT DTI
 ---------------------       ---------------------
 |  3 |  6 |  9 | 12 |       | 12 |  9 |  6 |  3 |  
 ---------------------       ---------------------
 |  2 |  5 |  8 | 11 |       | 11 |  8 |  5 |  2 |  
 ---------------------       ---------------------
 |  1 |  4 |  7 | 10 |       | 10 |  7 |  4 |  1 |  
 ---------------------       ---------------------


DTIROTATE>

ENABLE PME COMMAND

--------------------------------------------------------------------------------
ENABLE PME

--------------------------------------------------------------------------------
FORMAT: ENABLE PME

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

The ENABLE PME and DISABLE PME commands are reserved for Laser-Scan use. PME is a code optimisation tool and should be invoked by LSL software personnel only.

ENABLE PME causes the PME_INIT routine to be invoked.

--------------------------------------------------------------------------------
Message: The following messages are specific to the ENABLE and ENABLE PME commands:


*** ERROR *** Specifying command ENABLE

Available ENABLE qualifiers are :
DIAGNOSTICS  MIRROR  PME  ROTATE

*** WARNING *** You are already using PME!

--------------------------------------------------------------------------------
Examples:


DTIROTATE> ENABLE PME<CR>
DTIROTATE>

ENABLE ROTATE COMMAND

--------------------------------------------------------------------------------
ENABLE ROTATE

--------------------------------------------------------------------------------
FORMAT: ENABLE ROTATE

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE ROTATE will rotate the DTI data clockwise through 90 degrees. The ENABLE ROTATE command can be used with any of the ENABLE MIRROR commands.

In all cases the rotate action is performed after the mirror action.

--------------------------------------------------------------------------------
Messages: The following message is specific to the ENABLE command:


*** ERROR *** Specifying command ENABLE

Available ENABLE qualifiers are :
DIAGNOSTICS  MIRROR  PME  ROTATE

--------------------------------------------------------------------------------
Examples:


DTIROTATE> ENABLE ROTATE <CR>
DTIROTATE> SHOW PARAMETERS<CR>

PARAMETERS: MIRROR disabled ROTATE enabled file will be rotated clockwise
through 90 degrees 

       INPUT DTI         >>     OUTPUT DTI
 ---------------------       ----------------  
 |  3 |  6 |  9 | 12 |       |  1 |  2 |  3 | 
 ---------------------       ----------------  
 |  2 |  5 |  8 | 11 |       |  4 |  5 |  6 |  
 ---------------------       ----------------  
 |  1 |  4 |  7 | 10 |       |  7 |  8 |  9 | 
 ---------------------       ----------------
                             | 10 | 11 | 12 |
                             ----------------



DTIROTATE>

FILEIN COMMAND

--------------------------------------------------------------------------------
FILEIN

--------------------------------------------------------------------------------
FORMAT: FILEIN file-spec

--------------------------------------------------------------------------------
COMMAND PARAMETERS:

--------------------------------------------------------------------------------
DESCRIPTION:

The FILEIN command causes the specified DTI file to be opened for read only and used as an input file to DTIROTATE. A FILEIN command must be issued before the GO command will be accepted.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the FILEIN command:

*** WARNING *** Specifying command FILEIN
You must specify a file-spec argument to the FILEIN command

*** ERROR *** Specifying command FILEIN
You must specify a file-spec argument to the FILEIN command

*** ERROR *** Specifying command FILEIN
Unable to interpret input file-spec

*** ERROR *** Specifying command FILEIN
Failed while opening DTI file 'file spec' for input

*** ERROR *** Specifying command FILEIN
File 'file spec' data type 'type' invalid
Only data types 1 2 3 or 4 allowed

*** ERROR *** Specifying command FILEIN
File 'file spec' data type not compatible with first DTI file

*** ERROR *** Specifying command FILEIN
BIT data is not suitable for DTIROTATE

--------------------------------------------------------------------------------
Examples:

DTIROTATE> FILEIN AREA1<CR>
DTI file LSL$DTI:AREA1.DTI;0 opened for read
File    :  LSL$DTI:AREA1.DTI;0
Header  :  LSLA  Data:  WORD
Units are DTI Matrix Values
Matrix Coverage   SW:     1     1  NE:   201   201
Matrix Interval    E:     1         N:     1
Value Range         :    97   to    468
DTIROTATE>

FILEOUT COMMAND

--------------------------------------------------------------------------------
FILEOUT

--------------------------------------------------------------------------------
FORMAT: FILEOUT file-spec

--------------------------------------------------------------------------------
COMMAND PARAMETERS:

--------------------------------------------------------------------------------
DESCRIPTION:

The FILEOUT command enables specification of the DTI file which is to receive the rotated DTI data.

The FILEOUT command must be issued before the GO command.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the FILEOUT command:

*** WARNING *** You must specify a file-spec argument to the FILEOUT command

*** ERROR *** You must specify a file-spec argument to the FILEOUT command

*** ERROR *** Unable to interpret output file-spec

--------------------------------------------------------------------------------
Examples:


DTIROTATE> FILEOUT DUA3:[DEMONSTRATION]IDAHO_ROTATE90<CR>
DTIROTATE>

GO COMMAND

--------------------------------------------------------------------------------
_GO

--------------------------------------------------------------------------------
FORMAT: GO

--------------------------------------------------------------------------------
Command parameters: None

--------------------------------------------------------------------------------
DESCRIPTION:

Before the mirror and/or rotate processing takes places, checks will be carried out to ensure that certain preconditions hold. The following checks are performed by this command:-

The command will create a new DTI file as specified by the FILEOUT command. The format of the new DTI file will be the same as the first input DTI file specified with the FILEIN command.

Mirroring and/or rotation will be performed according to rotate and mirror states.

Upon successful completion of the GO command DTIROTATE is terminated.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the GO command:


*** ERROR *** Specifying the command GO
No input DTI file specified               >> Execute the FILEIN command

*** ERROR *** Specifying the command GO
No output DTI file specified              >> Execute the FILEOUT command

*** ERROR *** Specifying the command GO
Both MIRROR and ROTATE are disabled
This combination would result in an identical output file
Processing has been aborted
 

--------------------------------------------------------------------------------
Examples:


DTIROTATE> FILEIN NORMAL<CR> DTI file LSL$DTI:NORMAL.DTI;0 opened for read
DTIROTATE> FILEOUT ROTATED<CR>
DTIROTATE> GO<CR>
ELAPSED: 00:00:20.04 CPU: 0:00:04.71 BUFIO: 281 DIRIO: 46 FAULTS: 263
_$

HELP COMMAND

--------------------------------------------------------------------------------
HELP

--------------------------------------------------------------------------------
FORMAT: HELP subject

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
Description:

The HELP command looks the rest of the line up in the MATRIX HELP library. This library contains a brief summary of the operation of each command.

The information is looked up in the DTIROTATE section of the MATRIX help library, LSL$HELP:MATRIX.HLB.

--------------------------------------------------------------------------------
Messages:

Where required, warning messages are output via the VMS LBR$OUTPUT_HELP utility.

--------------------------------------------------------------------------------
Examples:


DTIROTATE> HELP ENABLE PME<CR>

DTIROTATE

ENABLE

PME


DTIROTATE>

PAUSE COMMAND

--------------------------------------------------------------------------------
PAUSE

--------------------------------------------------------------------------------
FORMAT: PAUSE

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Pauses DTIROTATE execution and issues a prompt for a carriage return to continue execution. This command is designed for use in software demonstration situations.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


DTIROTATE> PAUSE<CR>


Press to continue<CR>
DTIROTATE>

QUIT COMMAND

--------------------------------------------------------------------------------
QUIT

--------------------------------------------------------------------------------
FORMAT: QUIT

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
Description:

The QUIT command causes DTIROTATE to exit immediately, closing any opened DTI files.

(pressing the Ctrl and Z keys together) may also be used to quit from the program.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

DTIROTATE> QUIT<CR>
ELAPSED: 00:00:20.04 CPU: 0:00:04.71 BUFIO: 281 DIRIO: 46 FAULTS: 263
_$

RETURN COMMAND

--------------------------------------------------------------------------------
RETURN

--------------------------------------------------------------------------------
FORMAT: RETURN

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Restores command input from an indirect file to SYS$COMMAND.

A typical application is to allow the user to use an indirect command file to set up those run time defaults which are constant within a flowline and then return to input from the terminal (or batch stream) for the run specific commands. To do this RETURN must be the last command in the indirect command file.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the RETURN command:

RETURN command detected - returning to terminal input

RETURN command ignored - command input is already from terminal

--------------------------------------------------------------------------------
Examples:


DTIROTATE> @FLOW2<CR>
DTIROTATE> ENABLE DIAGNOSTICS
DTIROTATE> RETURN
DTIROTATE>

SHOW ENABLE COMMAND

--------------------------------------------------------------------------------
SHOW ENABLE

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

FORMAT:		 SHOW ENABLE

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Displays the current status of all the DTIROTATE options that may be enabled or disabled using the ENABLE and DISABLE commands.
The name of the option is shown, followed by either the word ON or OFF to indicate its current status.
If the command SHOW ENABLE is used before any ENABLE or DISABLE commands have been given, the default status of the options is displayed.

--------------------------------------------------------------------------------
Messages:

The following message is specific to the SHOW command:


*** ERROR *** Specifying command SHOW
Available SHOW command qualifiers are:
ENABLE, FILES, PARAMETERS, PME

--------------------------------------------------------------------------------
Examples:

DTIROTATE>SHOW ENABLE


Current status:

DIAGNOSTICS       On        MIRROR BOTH      Off      MIRROR X        Off

MIRROR Y          Off       PME              Off      ROTATE          On


DTIROTATE>

SHOW FILES COMMAND

--------------------------------------------------------------------------------
SHOW FILES

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

FORMAT:		 SHOW FILES

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Details extracted from the header of the input file are displayed on the terminal.

The name of the output file is also displayed if it has been specified.

--------------------------------------------------------------------------------
Messages:

The following message is specific to the SHOW command:


*** ERROR *** Specifying command SHOW
Available SHOW command qualifiers are:
ENABLE, FILES, PARAMETERS

--------------------------------------------------------------------------------
Examples:

DTIROTATE>SHOW FILES

DTI file LSL$DTI:UHL1DATA.DTI;0 opened for read

File    :  LSL$DTI:UHL1DATA.DTI;0
Header  :  UHL1  Data:  WORD

File    :  LSL$DTI:TEST5.DTI
Header  :  LSLA Data:  WORD

Units are DTI Matrix Values

Matrix Coverage   SW:     1     1  NE:   101   101
Matrix Interval    E:     1         N:     1
Value Range         :     1   to      400

DTI file LSL$DTI:AREA1_R180.DTI;0 selected for output


DTIROTATE>

SHOW PARAMETERS COMMAND

--------------------------------------------------------------------------------
SHOW PARAMETERS

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

FORMAT:		 SHOW PARAMETERS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

The current DTIROTATE parameters are displayed. A schematic diagram is shown which indicates the matrix which will result after the GO command is specified with the current parameters.

--------------------------------------------------------------------------------
Messages:

The following message is specific to the SHOW command:


*** ERROR *** Specifying command SHOW
Available SHOW command qualifiers are:
ENABLE, FILES, PARAMETERS

--------------------------------------------------------------------------------
Examples:

DTIROTATE>SHOW PARAMETERS

PARAMETERS:
MIRROR disabled ROTATE enabled 
File will be rotated clockwise through 90 deg 

       INPUT DTI         >>     OUTPUT DTI
 ---------------------       ----------------  
 |  3 |  6 |  9 | 12 |       |  1 |  2 |  3 | 
 ---------------------       ----------------  
 |  2 |  5 |  8 | 11 |       |  4 |  5 |  6 |  
 ---------------------       ----------------  
 |  1 |  4 |  7 | 10 |       |  7 |  8 |  9 | 
 ---------------------       ----------------
                             | 10 | 11 | 12 |
                             ----------------

DTIROTATE>

SPAWN COMMAND

--------------------------------------------------------------------------------
SPAWN

--------------------------------------------------------------------------------
FORMAT: SPAWN command-line

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The SPAWN command enables you to create a subprocess while within the DTIROTATE utility. When the subprocess terminates, control is returned to DTIROTATE.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the SPAWN command:


*** ERROR *** Specifying command SPAWN 
Command requires a valid DCL command line

*** ERROR *** Unable to spawn command, returning to DTIROTATE

--------------------------------------------------------------------------------
Examples:

DTIROTATE> SPAWN DIRECTORY LSL$DTI:*_._DTI

Directory DUA3:[LSL.DTI]
TEST1_.DTI;1              8/8       18-AUG-1987 07:56  [LSL,DAVEC]
TEST2_.DTI;1              7/8       18-AUG-1987 17:17  [LSL,DAVEC]
TEST2_.DTI;2              7/8       18-AUG-1987 17:34  [LSL,DAVEC]
Total of 3 files, 22/24 blocks.

DTIROTATE>

WAIT COMMAND

--------------------------------------------------------------------------------
WAIT

--------------------------------------------------------------------------------
FORMAT: WAIT seconds

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The WAIT command causes processing to be suspended for a specified number of seconds. It is designed for use in software demonstration situations and is of no value in a production flowline.

--------------------------------------------------------------------------------
Messages:

The following warning message is specific to the WAIT command:

*** WARNING *** You must specify the number of seconds to wait

--------------------------------------------------------------------------------
Examples:


DTIROTATE> WAIT 4<CR>
DTIROTATE>

DTIROTATE examples

EXAMPLES

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

EXAMPLES

$ DTIROTATE
MATRIX module DTIROTATE of 15:43:39 25-MAR-88
DTIROTATE> FILEIN WEEPY2<CR>
DTI file LSL$DTI:WEEPY2.DTI;0 opened for read
File    :  LSL$DTI:WEEPY2.DTI;0
Header  :  LSLA  Data:  WORD
Units are DTI Matrix Values
Matrix Coverage   SW:     1     1  NE:   201   201
Matrix Interval    E:     1         N:     1
Value Range         :    97   to    468
DTIROTATE> FILEOUT WEEPY2_X__Y<CR>
DTIROTATE> SHOW PARAMETERS<CR>
PARAMETERS:
MIRROR disabled  ROTATE enabled
File will be rotated clockwise through 90 deg
       INPUT DTI         >>     OUTPUT DTI
 ---------------------       ----------------
 |  3 |  6 |  9 | 12 |       |  1 |  2 |  3 |
 ---------------------       ----------------
 |  2 |  5 |  8 | 11 |       |  4 |  5 |  6 |
 ---------------------       ----------------
 |  1 |  4 |  7 | 10 |       |  7 |  8 |  9 |
 ---------------------       ----------------
                             | 10 | 11 | 12 |
                             ----------------
DTIROTATE> DISABLE ROTATE<CR>
DTIROTATE> ENABLE MIRROR BOTH<CR>
DTIROTATE> SHOW PARAMETERS<CR>
PARAMETERS:
MIRROR BOTH enabled  ROTATE disabled
File will be mirrored about both axes 
       INPUT DTI         >>     OUTPUT DTI
 ---------------------       ---------------------
 |  3 |  6 |  9 | 12 |       | 10 |  7 |  4 |  1 |
 ---------------------       ---------------------
 |  2 |  5 |  8 | 11 |       | 11 |  8 |  5 |  2 |
 ---------------------       ---------------------
 |  1 |  4 |  7 | 10 |       | 12 |  9 |  6 |  3 |
 ---------------------       ---------------------
DTIROTATE> GO<CR>
 ELAPSED:    0 00:01:36.42  CPU: 0:00:05.04  BUFIO: 16  DIRIO: 142  FAULTS: 463 
$

The above is an example of using the DTIROTATE utility to rotate a DTI file through 180 degrees. The input DTI file is opened using the FILEIN command and output DTI file specified using the FILEOUT command. The SHOW PARAMETERS command is then used to determine the state of the DTIROTATE operator parameters. The picture reveals that the required operation would not be performed. The DISABLE ROTATE and ENABLE MIRROR BOTH commands are given. The SHOW PARAMETERS command is once again given to confirm that the desired operation would now be performed. The GO command is then issued to do the processing. On completion the DTIROTATE utility terminates.

DTIROTATE messages

MESSAGES (OTHER)

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

MESSAGES (OTHER)

In addition to the above messages which are generated by the program itself, other messages may be produced by the command line interpreter (CLI) and by Laser-Scan libraries. In particular, messages may be generated by the DTI library or by the Laser-Scan I/O library, LSLLIB. DTI library messages are introduced by %DTI and are documented in the MATRIX Reference manual. LSLLIB messages are introduced by '%LSLLIB' and are generally self-explanatory. They are often used to explain the details of program generated errors.

If the cause of the error cannot be traced by the user, and Laser-Scan are consulted, then the output file should be preserved to facilitate diagnosis.