RaBiGeTe GUI

The graphical user interface for RaBiGeTe

Cristiano fecit anno Domini MMV


Updates

2005-07-11

Added the collision test and the parameters for the runs test.
Deleted the autocorrelation test (included in the windowed version).
Please, download the new version of RaBiGeTe.


2005-03-31

Added the table for the results, the AMLS test parameters and the threshold values for bad partial results (please, refer to the RaBiGeTe documentation).
Using the table, the final report can be rearranged as needed: the rows and the columns can be moved, the overall p-values and the per sequence p-values can be sorted either in ascending or descending order.
To use the new AMLS test, please download the new version of RaBiGeTe which includes several improvements (both in features and source code).


2005-02-21

First release.



Quick start

  1. Download RaBiGeTe GUI executable;
  2. unzip the archive in the RaBiGeTe folder (now RaBiGeTe.exe and RaBiGeTe_GUI.exe are in the same folder);
  3. run RaBiGeTe GUI;
  4. specify the file with the data to test in the "Input file name" edit (the wildcards are allowed); RaBiGeTe GUI always add the quotation marks automatically; if no file is specified, RaBiGeTe will test the hard coded generator;
  5. enable/disable the tests and change the parameters as you like (RaBiGeTe GUI will do only a minimal checking, while RaBiGeTe will do the full parameter checking); if you want to test all the bits in the input file(s), leave empty the edit "Sequence length" and change the edit "Number of seqs";
  6. click the button "WAIT for the output file and load it" on page "Parameters";
  7. once RaBiGeTe has finished, RaBiGeTe GUI loads the output file (the default is "_RaBiGeTe.txt") in the rich edit on page "Results" and in the table.

What the GUI does

With RaBiGeTe GUI the user can set all the parameters needed by RaBiGeTe using a very intuitive and easy to use graphical interface for Windows.
The GUI has four "pages": the general settings, the test parameters, the page with the results and the table (in which is loaded the file generated by RaBiGeTe).
Almost all the controls have the "hint": place the mouse pointer over the control to get a brief description.

- The general page

In this page there are the general setting for RaBiGeTe and the preferences for the GUI. The GUI doesn't write in the Windows registry, it just creates the file "prefs.ini" in the same folder of RaBiGeTe_GUI.exe in which is written: the path of RaBiGeTe, the path of the parameter file, the active page and the window position and size.
With the buttons "Change" the user can choose the folder and the name of the files.
The edit for the parameter file has four buttons: "Load new" and "Save as" use the open/save dialog, while "Load" and "Save" do immediately the operation (without dialog). Using "Save", the parameter file will be overwritten without prompt. Also, pressing "Load", the parameter file will be loaded and the current parameters will be lost.

General tab


- The parameter page

Here it is possible to change all the test parameters.
The execution order of the tests can be changed by dragging the test names in the list box "Execution order" (click on a name, move the mouse pointer in the desired position and release the left mouse button).
To enable/disable the tests you can click the check boxes or you can use the "All", "None" and "Toggle" buttons: To run RaBiGeTe you can click either "WAIT for the output file and load it" or "EXIT RaBiGeTe GUI immediately". The button names are self-explaining: the former will wait that RaBiGeTe saves the output file and once finished, the file will be loaded in the rich edit on page "Results" and in the table; the latter will run RaBiGeTe and RaBiGeTe GUI will terminate immediately. In both cases a new parameter file will be created and the old one will be overwritten without prompt. If the edit "Parameter file name" is empty, RaBiGeTe GUI will use the default name "RaBiGeTe_GUI_para".

Parameters tab


- The results page

In this page RaBiGeTe GUI loads the output file created by RaBiGeTe.

Results tab

- The table page

In this page RaBiGeTe GUI loads the output file created by RaBiGeTe.
When the tested sequence is very bad, the tests indicate the big failure with a red label "- error -" (as showed in the example).
The column "pvals" is useful when many sequences are tested; looking at this column it can be possible to immediately see whether some sequence has failed.
To sort a column in the ascending order, right click on the first row. Right clicking again the same column, it will be sorted in descending order. Any column can be sorted.
To move a column or a row, drag the column or the row in the desired position (only the non-fixed columns and non-fixed rows can be moved).
The overall values (showed in blue) are calculated by RaBiGeTe GUI (they are not read from the RaBiGeTe output file). As a consequence, if the parameter "P-value digits" (or pvalDGT in RaBiGeTe) is too small, the overall values may consistently differ from the ones calculated by RaBiGeTe. I suggest to use at least pvalDGT = 3, but pvalDGT = 4 or 5 is much better.

Table tab



Download RaBiGeTe GUI

2005-07-11: Windows executable (434 kB).

2005-07-11: C++ source code for Borland C++ Builder V6 (25 kB).


Feedback

To improve RaBiGeTe GUI I need your suggestions.
Please, click here to email your suggestions or comments.

- Acknowledgements

I am grateful to Carlo Alberto Ferraris (CAFxX) for his suggestions and for his testing of RaBiGeTe GUI.


Version history

Version

        Changes

050711
  • Added the runs test parameters and the collision test parameters;
  • deleted autocorrelation test parameters (included in the windowed version);
  • added the button "Load a result file";
  • changed some edit control with UpDown control;
  • sorted the test names in the parameter section.

050331
  • Added the table for the results;
  • added the AMLS test parameters;
  • added the rows and the mode for the DFT test;
  • added KSmin, ADmin and SLmax for bad partial results;
  • if the user checked the sort boxes, the overall values in the table are automatically sorted;
  • fixed a bug in the output file location;
  • changed the maximum edit box text length;
  • tabs placed to the left of the page control;
  • changed "test #" in "sequence #".

050221         First release.


Website counter