1. User level

1.1. Scan

Scan module is visible on the left and structurally it "sits" on the top of PSO (in the framework). It contain two tabs and a console. The console is identical to the PSO one, except that it logs scan module messages.

1.1.1. Scan prop tab

The tab provides access to scan settings, one or two writable and one readable properties have to be set. Block name is on the left, property name is on the right. After selection the property type is hinted on the left. In the small table under: Current value (read-only), Staring position (From), finishing position (To) and step (By) have to be set. Conditions to be met: From > To and By > 0. For the second property block name <none> is available which means that only the first property is about to be scanned. In first property if the type of the property is selection a checkable list of possible choices will open and the user can pick (check) some.

The whole scan setting is saved / reloaded on closing / opening of the program.  All the scan files in Config directory are shown in combo-box above the Scan buttons, select any of them and press open on the left. If the scan file to open is in different directory, hold Ctrl key when you press open button and Open Dialog will appear. The right button will open Save Dialog to enter the scan name and save the scan setting.

On the bottom the the tab two major buttons offer the user to scan selected at the moment test function or go thru all of them, generating one or about twenty reports respectively. When Bee22 scans the button the user clicked on stays down till the end of the scan. If the user wish to cancel the scan, click again on the same button (un-press it).

 

1.1.2. Options

On the top of this tab you can see the Mute option, when checked it will mute the blocks at the beginning of the scan and release the muting at the end. When the program closes it saves the current scan setting in default.scan file. From the next option the user can choose to retrieve at opting that default.scan setting or open a some particular setting (the last one to be opened).

Next option offer to measure n times the same property values and record in the report the average results. The PSO algorithm uses random values for some its internal parameters so statistical approach is quite natural and of course in case of dynamic (added noise to test function) environment.

Bellow are precision setting for props in blocks or in the report (only of type of double).

The two row of buttons allows to Open / Save individual or group (all opened if saved) of reports. In case of group, the name of the group is a name of directory where if saved the scan and prop files are saved as well if you want to reproduce the measurement. The last button on the first row will erase all opened reports and the similar button on the second row - only currently active (top) pne.

 

1.2. Reports

Below are example reports from scans. First one is from single property scan and second the third ones - from scan of two properties. Every measurement running PSO with particular values of scanned properties produces a record of results, after Stats number of measurements are done the results are evaluated statistically (mostly taking average) and a meta-measurement is recorded in the report.

Here is the structure of the result record from meta-measurement:

The most important of resulting parameters are presented in a chart on the right. Switch a series on/off from the checkboxes above, zoom with left mouse button (drag), move with the right mouse button. Double click on the chart to access sophisticated options to adjust its appearance. The user can copy the table of result or the chart into the clipboard.

 

Below are two tabs of two properties scan, switchable from the left.

First tab is similar to the one above except for the fixed property. The user can fix one property and change its value from the spin-box on the right or from the slider under. Once certain value is fixed the report is as one property scan, which is cross section of the two properties result "picture"

Second tab allows to select one result parameter to show across the whole scan in table and chart form. The list result parameters below correspond to the selected cell in the table above. The chart can be easily manipulated using the tools above it. Just select the tool and drag on the chart, right mouse button always move. The check box on the right will replace bars with points if that creates a "clearer" picture.


2. Developer level

...to be continued.