Modes of Operation and Parameters File

(Parameters File is called "qbtr-params.in")

We you run Qubiter, the first thing it does is to look for a parameter file entitled "qbtr-params.in". This is an example of such a file:

Qubiter will skip lines 1, 3, 4, 6, 8, etc. For clarity, we have indicated the lines that Qubiter skips by starting them with //, although Qubiter doesn't care what they start with. Questions that require a boolean (yes or no) answer should be answered by a 0 for no and 1 for yes.


MATNAME

The user should enter into the second line the name MATNAME of a matrix. In the figure, we have used "PBR.DFT2" for MATNAME.


Compilation and Decompilation

If the user enters 1 into the 4th line as an answer to "Do compilation?", then Qubiter will look for a file named "MATNAME.in". In other words, it will look for a file whose name is the string in line 2 plus the suffix ".in". Qubiter expects to find in this file the entries of the unitary matrix Uinitial to be decomposed. The file should be of the form discussed in the section entitled "Matrix Entries File".

If the user enters 1 into line 6 as an answer to "Do decompilation?", then Qubiter will look for a file named "MATNAME-engl.out". Qubiter expects this to be a plain SEO file. (See section entitled "SEO Files").

Qubiter has 2 main modes of operation as far as compilation/decompilation is concerned.

The first mode of operation is when the user answers:

In this mode, the user must provide 2 input files entitled "qbtr-params.in" and "MATNAME.in". Qubiter will output a file called "MATNAME-engl.out". Then it will use "MATNAME-engl.out" as input, multiply the SEO listed in this file, arrive at a unitary matrix Ufinal, and output a file called "MATNAME-chk.out" that lists the entries of Ufinal. It will also output a file called "MATNAME-err.out" that list the entries of the difference matrix Delta = Uinitial - Ufinal . If everything goes well, the matrix Uinitial specified by file "MATNAME.in" and the matrix Ufinal specified by file "MATNAME-chk.out" will be the same matrix(within machine precision), and the matrix Delta will be zero (within machine precision).

The second mode of operation is when the user answers:

In this mode, the user must provide 2 input files entitled "qbtr-params.in" and "MATNAME-engl.out". Qubiter will multiply the SEO listed in "MATNAME-engl.out", arrive at a unitary matrix Ufinal, and output a file called "MATNAME-chk.out" which lists the entries of Ufinal .


Optimizations


[Table Of Contents]