Creating and Running a Report in BioReview
using an existing template signal diagram (recommended)
- Open BioReview
- Choose OPEN from the Report menu to Open an existing template report.
- Choose the Single Channel report (recording done with 3 electrodes) or the Dual Channel report (recording done with 5 or 6 electrodes).
- The screen should now display the "View 1" and also a signal diagram. See below for instructions on modifying the signal diagram.
- Choose RUN ON SESSION from the Report menu.
- Select a .bxs file - a recording from a BioExplorer session.
creating your own signal diagram
1. Open BioReview.
2. Choose New from the Report menu to create a new report.
3. In the dialog that opens choose the sample session CESample1.bxs and press the Open button. BioReview uses the Session file to determine the number and type (EEG, GSR, EKG, etc.) of channels to be used in this report. In this case two EEG channels are added to the Signal Diagram. These are the two channels of EEG data that are recorded in the CESample1 session file.
4. The next step is to modify the Signal Diagram to generate some signals of interest. Suppose we want to calculate and display the mean alpha amplitude
and frequency
for each channel. To do this we'll need two Bandpass Filter objects and two Mean Frequency objects. Add these to the Signal Diagram by choosing Add Object from the Signal Diagram menu.
5. Connect the output of Source 1 to the input of Bandpass Filter 1 and Mean Frequency 1.
6. Connect the output of Source 2 to the input of Bandpass Filter 2 and Mean Frequency 2. The Signal Diagram should look something like this:
7. Using the mouse, double click Mean Frequency 1 to display its property page. Change the frequency range to 8.0 - 12.0 and press OK. Do the same for Mean Frequency 2.
8. The Signal Diagram is now configured to calculate our signals of interest. To view these signals, add a View window to the report by choosing New from the View menu. A View window can be used to display the statistics of any output port in the Signal Diagram in a variety of formats.
9. Click on the View window with the mouse to make sure it is selected. Then choose 'Add Signal...' from the View menu. This opens the Signals dialog, which lists all output ports in the Signal Diagram.
10. Add the Amplitude output of Bandpass Filter 1 to the View by selecting it in the Signals dialog and then pressing the Add button.
11. In the same way, add the Amplitude output of Bandpass Filter 2 and the Freq output of both Mean Frequency objects. Your View window should look like this:
12. Now is a good time to save your report. Choose Save As from the Report menu, enter a name, and press the Save button.
13. You can now run your report on the current session (CESample1.bxs) by choosing Run from the Report menu. After doing this each View window will report the statistics for its signals, as shown below.
The lower portion of the View displays each signal in this view, and the summary statistics for those signals. Summary statistics are calculated across the entire current time span, which defaults to the length of the session. The mean value for the first signal in the list below is 22.5u. This indicates that the mean value of channel 1's 8-12Hz amplitude for the entire session is 22.5 microvolts.
The upper portion of the View displays the mean value of each epoch of the session on a chart. You can also view these mean values in a table, by selecting the Table tab in the upper left corner of the View.
14. You can change the color of each signal to help identify it in the chart by clicking on the Color column in the signal list with the mouse. Do this to give each signal a unique color.
15. In the chart above, you can see the Mean Frequency values for both channels, but because the filter amplitudes are down in the microvolt range they can't be seen. There are several ways to work around this. One possibility would be to group signals with similar ranges in their own View. For example you can create one View window for displaying mean frequencies, which typically range from 1-30Hz. You could then add another View to display filter amplitudes, which typically range from 1 to 50 microvolts when looking at EEG signals.
Another alternative is to enable and disable signals in the chart, using the Chart colum in the Signal List. Uncheck the Chart box for both Mean Frequency signals, and the chart will rescale to display the filter amplitudes.
A third alternative is to use the Scale value in the signal list. The value entered here will be used to scale the displayed values. First make sure that all four signals are enabled in the chart by checking them in the Chart column. Then enter 1000000 in the Scale column for both Bandpass Filter Amplitude signals. This allows you to view the mean frequency and amplitude on the same chart as shown below:
16. Save your report again by choosing Save from the Report menu.
17. You can now run this report on any session that contains at least two EEG channels, by choosing 'Run On Session' from the Report menu and choosing a session.
