| Communications Toolbox | |
BERTool enables you to export individual data sets to the MATLAB workspace or to MAT-files. One option for exporting is convenient for processing the data outside BERTool. For example, to create a highly customized plot using data from BERTool, export the BERTool data set to the MATLAB workspace and use any of the plotting commands in MATLAB. Another option for exporting enables you to reimport the data into BERTool later.
BERTool also enables you to save an entire session, which is useful if your session contains multiple data sets that you want to return to in a later session.
This section describes these capabilities, in these topics:
To export an individual data set, follow these steps:
In the data viewer, select the data set you want to export.
Choose Export Data from the File menu.
Set Export to to indicate the format and destination of the data.
If you want to reimport the data into BERTool later, then you must choose either Workspace structure or MAT-file structure to create a structure in the MATLAB workspace or a MAT-file, respectively.
A new field called Structure name appears. Set it to the name that you want BERTool to use for the structure it creates.
If you selected Workspace structure and you want BERTool to use your chosen variable name even if a variable by that name already exists in the workspace, then check Overwrite variables.
If you do not need to reimport the data into BERTool later, then a convenient way to access the data outside BERTool is to have BERTool create a pair of arrays in the MATLAB workspace. One array contains Eb/N0 values, while the other contains BER values. To choose this option, set Export to to Workspace arrays.
Then type two variable names in the fields under Variable names.
If you want BERTool to use your chosen variable names even if variables by those names already exist in the workspace, then check Overwrite variables.
Click OK. If you selected MAT-file structure, then BERTool prompts you for the path to the MAT-file that you want to create.
To reimport a structure later, see Importing Data Sets.
This section briefly describes the contents of the structure that BERTool exports to the workspace or to a MAT-file. The structure's fields are indicated in the table below. The fields that are most relevant for you when you want to manipulate exported data are paramsEvaled and data.
| Name of Field | Significance |
|---|---|
| params | The parameter values in the BERTool GUI, some of which might be invisible and hence irrelevant for computations. |
| paramsEvaled | The parameter values that BERTool uses when computing the data set. |
| data | The Eb/N0, BER, and number of bits processed. |
| dataView | Information about the appearance in the data viewer. Used by BERTool for data reimport. |
| cellEditabilities | Indicates whether the data viewer has an active Confidence Level or Fit entry. Used by BERTool for data reimport. |
Parameter Fields. The params and paramsEvaled fields are similar to each other, except that params describes the exact state of the GUI whereas paramsEvaled indicates the values that are actually used for computations. As an example of the difference, for a theoretical system with an AWGN channel, params records but paramsEvaled omits a diversity order parameter. The diversity order is not used in the computations because it is relevant only for systems with Rayleigh channels. As another example, if you type [0:3]+1 in the GUI as the range of Eb/N0 values, then params indicates [0:3]+1 while paramsEvaled indicates 1 2 3 4.
The length and exact contents of paramsEvaled depend on the data set because only relevant information appears. If the meaning of the contents of paramsEvaled is not clear upon inspection, then one way to learn more is to reimport the data set into BERTool and inspect the parameter values that appear in the GUI. To reimport the structure, follow the instructions in Importing Data Sets or BERTool Sessions.
Data Field. If your exported workspace variable is called ber0, then the field ber0.data is a cell array that contains the numerical results in these vectors:
ber0.data{1} lists the Eb/N0 values.
ber0.data{2} lists the BER values corresponding to each of the Eb/N0 values.
ber0.data{3} indicates, for simulation or semianalytic results, how many bits BERTool processed when computing each of the corresponding BER values.
To save an entire BERTool session, follow these steps:
Choose Save Session from the File menu.
When BERTool prompts you, enter the path to the file that you want to create.
BERTool creates a text file that records all data sets currently in the data viewer, along with the GUI parameters associated with the data sets.
Note If your BERTool session requires particular workspace variables (such as txsig or rxsig for the Semianalytic panel), then you should save those separately in a MAT-file using the save command in MATLAB. |
| | Managing BER Data | Importing Data Sets or BERTool Sessions | |
© 1994-2005 The MathWorks, Inc.