Home > AdvDCSM BIT ERROR RATE (BER)/BIT ERROR PROBABILITY (Pb) PLOT GENERATION GUIDE

AdvDCSM BIT ERROR RATE (BER)/BIT ERROR PROBABILITY (Pb) PLOT GENERATION GUIDE

NOTE: This section is Under-Edit if necessary: Construction began on December 7, 2022 and was finished on December 9, 2022.

The purpose of this guide is to provide the User a Summary of how to use T1 V1 or T1 V2 to generate or edit a Bit Error Rate (BER)/Bit Error Probability (Pb) Plot. This feature allows the User to generate a Bit Error Rate (BER) or Bit Error Probability (Pb) versus Information Bit Baseband SNR, Eb/N0 in dB Plot. A BER plot can consists of one (1) to six (6) curve (s) where a curve can consists of three (3) to sixteen (16) data points where a data point is (SNR dB value, BER/Pb value). These data point SNR dB values are taken from the set of possible SNR dB values [0.0, 60.0] = {s element of Real Numbers | 0.0 <= s <= 60.0}. These data point BER/Pb values are taken from the set of possible BER/Pb values (1.e-10, 1.0) = {p element of Real Numbers | 1.e-10 < p < 1.0}. The User can assign a color to each plot's BER curve from a set of colors (Red, Green, Blue, Yellow, Magenta, & Cyan).

Also, this feature allows the User to add a BER Plot Data to the User's Custom BER Plot Data List. This list, a set of BER Plot Data Files, is indexed via a BER Plot Data MOST RECENT generated File Names (FN) List, 222 File Names Maximum, via a Query. Older BER Plot Data files can be indexed via the same BER Plot FN Query. This BER Plot Data will then become available (via a Data File) for a BER Plot Input selection for BER Plot Edit for generating a revised BER Plot.

The User can create a plot output file (.PLT-BER) for the generated BER Plot. A User-name plot output file (.PLT-BER) is accessible via the File 'Open' choice. If an 'Unexpected file format' error or failure to open, the User can use the BER PLOT EDIT option and appropriate BER Plot Data File to redo the creation of its BER Plot and corresponding .PLT-BER file.

For the User to initiate this feature, the User selects the 'Channel Coded Signaling' or 'UnCoded Signaling' choice using the 'Operational Mode' Menu. Next, the User selects 'Bit Error Rate (BER)/Probability (Pb) Plot Generation' using the 'Design' Menu. Then the following query is presented (displayed) to the User: 
'BIT ERROR RATE (BER)/BIT ERROR PROBABILITY (Pb) PLOT GENERATION?:'
'NEW BER PLOT'
'or EDIT EXISTING BER PLOT using a USER-NAMED DATA INPUT FILE'
If the 'NEW BER PLOT' choice is selected, the following two queries are presented (displayed) sequentially to the User so that the number of BER Curves (M) and number of SNR (Eb/N0) dB values (N) are inputted: 
'BER PLOT NEW GENERATION,'
'NUMBER OF BER CURVES (LINES), 6 MAX?:'

'BER PLOT NEW GENERATION,'
'NUMBER OF SNR (Eb/N0 in dB) Values, 16 MAX?:'
Next, the following four Visual Builders (Data Windows) are presented (displayed) sequentially to the User where the User-Specified BER Plot and Figure Data are entered and the 'Apply' button is engaged for each data window: 
1) 'BER PLOT CURVE (S) Data' where the User enters the SNR, Eb/N0, in dB N Values 
   into the Data Window's leftmost column of enabled data cells in Ascending Order 
   (from low value to high value) and then the corresponding Curve x BER Values are 
   entered into the Curve x column of enabled data cells where x is an integer 
   number assigned to a particular BER Curve and x ranges from 1 to M;

2) 'BER PLOT LEGEND' & BER PLOT DATA' where the User enters Curve x Descriptors;
3) 'BER Plot Figure Descriptor' where the User enters a description of the BER Plot 
    figure; &
4) 'BER PLOT Curve Color - Curve Number Assignment' where the User enters the color - 
    curve selections.
Note 1: the 'BER PLOT DATA' section of the 'BER PLOT LEGEND' & BER PLOT DATA' Visual Builder uses dashes as a placeholder to indicate that a particular simulated BER value is ZERO or out-of-range of the BER Axis.

Note 2: the 'BER Plot Figure Descriptor' Visual Builder has an 'ACCEPT the PROPOSED FIGURE DESCRIPTION' query that must be answered before the second 'Apply' button is engaged.

Then the BER Plot is presented (displayed) via a 'Plot-ber1' window for User review along with an AdvDCSM: DCSS Guide notification of 'BER PLOT DATA OBTAINED for BER PLOT GENERATION.' If the User clicks on the dialog 'OK', the following query is presented to the User: 
'BER PLOT NEW GENERATION or EDIT,'
'BER PLOT DATA PARAMETERS (DATA) DESTINATION: DESIGN STORE?:'
'SAVE to a USER-NAMED DATA FILE'
'or NOT SAVE'
If the User selects the 'SAVE to a USER-NAMED DATA FILE' choice, the following query is presented to the User: 
'BIT ERROR (BER)/BIT ERROR PROBABILITY (Pb) PLOT GENERATION,'
'BER PLOT DATA PARAMETERS OUTPUT FILE NAME with ".txt", 51 MAX LENGTH?:'
Finally, the User can save the displayed BER Plot via the 'Plot-ber1' window's 'Save As...' choice under the 'File' menu after the User enters a User-Specified '.PLT-BER' file name and clicking the 'OK' button.

If the BER PLOT GENERATION second mode option ('EDIT EXISTING BER PLOT using a USER-NAMED DATA INPUT FILE') of operation is selected, the following three queries are presented sequentially to the User so that the Edited BER Plot's number of BER Curves (M') and number of SNR (Eb/N0) dB values (N') are inputted: 
'BER PLOT EDIT,'
'NUMBER OF BER PLOT CURVES, 6 MAX?:'

'BER PLOT EDIT,'
'NUMBER OF SNR (Eb/N0 in dB) Values, 16 MAX?:'

'BER PLOT EDIT, BER Plot Data Retrieval:'
'Color to Curve Number Assignment Data on Selected BER PLOT DATA File?:'
'YES'
'or NO'
Next, the User is notified of the number of BER Plot Data Files via an 'AdvDCSMT1DCSS' dialog presentation: 
'BER PLOT PARAMETERS (DATA) FILE NAMES LIST SIZE:'.
Then the following query is presented to the User so that User-Specified BER Plot Data File can be identified and its stored BER Plot values can be inputted into the T1 program: 
'BIT ERROR (BER)/BIT ERROR PROBABILITY (Pb) PLOT EDIT,'
'BER PLOT DATA FILE NAMES LIST, 222 MOST RECENT MAX,'
'BER PLOT DATA PARAMETERS INPUT FILE NAME with ".txt", 51 MAX LENGTH?:'
Next, the difference between the to be Edited BER Plot Number of BER Curves and the Number of BER Curves inputted from the selected BER Plot data file and the difference between the to be Edited BER Plot Number of SNR dB values and the Number of SNR dB values inputted from the same selected BER Plot data file are calculated. These differences are presented to the User via 'AdvDCSM: DCSS Guide' along with the BER Plot Data FileName, the file's Number of BER Curves and Number of SNR dB values.

Now, if the Number of BER Curves Difference is Zero (0) and the Number of SNR dB Valves is Zero (0), the following four Visual Builders (Data Windows) are presented (displayed) sequentially to the User where the User-Specified BER Plot and Figure Data is displayed for edit. After each data window edit, the 'Apply' button is engaged for each data window: 
1) 'BER PLOT CURVE (S) Data' where the User enters the Edited BER Plot's SNR, Eb/N0, 
    in dB Values and/or Curve x BER Values into the Data Window's Columns enabled 
    data cells where x is an integer number assigned to a particular BER Curve and 
    x ranges from 1 to M;

2) 'BER PLOT LEGEND' & BER PLOT DATA' where the User enters Curve x Descriptors;
3) 'BER Plot Figure Descriptor' where the User enters a description of the BER Plot 
    figure; &
4) 'BER PLOT Curve Color - Curve Number Assignment' where the User enters the color - 
    curve selections.
Note the particular edited BER Curve (s) value (s) and/or SNR dB value (s) are still shown in the individual Data Window Cell (s) but are not accessible by the User when the 'REMOVE' function for BER Curve (s) and/or SNR dB is used.

Note the 'BER Plot Figure Descriptor' Visual Builder has an 'ACCEPT the PROPOSED FIGURE DESCRIPTION' query that must be answered before the second 'Apply' button is engaged.

But if the Number of BER Curves Difference is not Zero (0) or the Number of SNR dB Valves is not Zero (0), a sequence of BER Plot Edit queries will be presented to the User that is based on the Number of BER Plot Curves and Number of SNR dB values differences.

These Edit queries involve the 'Append', 'Insert", 'Remove', and 'Delete" Edit functions support by T1.

BER Curve 'Append' function allows for one or multiple addition (s) of BER Curve (s). The BER Curve 'Remove' function allows for one or multiple deletion (s) of BER Curve (s). The BER Curve 'Insert' function allows for only one addition of a BER Curve. The BER Curve 'Delete' function allows for only one deletion of a BER Curve.

BER SNR dB 'Append' function allows for one or multiple addition (s) of SNR dB value (s) and corresponding BER Curves' value (s). The BER SNR dB 'Remove' function allows for one or multiple deletion (s) of SNR dB values and corresponding BER Curves' values. The SNR dB 'Insert' function allows for only one addition of a SNR dB value and corresponding BER Curves' values. The SNR dB 'Delete' function allows for only one deletion of a SNR dB value and corresponding BER Curves' values.

The complete set of possible queries is as follows: 
'BER PLOT EDIT via DATA WINDOW,'
'APPEND NEW BER PLOT CURVE (s) or INSERT ONE NEW BER PLOT CURVE?:'
'APPEND to the Right of CURVE with LARGEST NUMBER'
'or INSERT to the Left of an EXISTING CURVE'

'BER PLOT EDIT via DATA WINDOW,'
'REMOVE BER PLOT CURVE (s) or DELETE ANY ONE BER PLOT CURVE?:'
'REMOVE starting at CURVE with LARGEST NUMBER'
'or DELETE an EXISTING CURVE'

'BER PLOT EDIT via DATA WINDOW,'
'APPEND NEW BER PLOT SNR dB VALUE (s) or INSERT ONE NEW BER PLOT SNR dB VALUE?:'
'APPEND after LARGEST SNR dB VALUE'
'or INSERT at an EXISTING SNR dB VALUE'

'BER PLOT EDIT via DATA WINDOW,'
'REMOVE BER PLOT SNR dB VALUE (s) or DELETE ANY ONE BER PLOT SNR dB VALUE?:'
'REMOVE starting at LARGEST SNR dB VALUE'
'or DELETE an EXISTING SNR dB VALUE'

'BER PLOT EDIT,'
'INSERT NEW BER PLOT CURVE (Column) in DATA WINDOW,'
'SPECIFY NUMBER of EXISTING CURVE which will be preceded adjacently to the NEW CURVE, 
  1 - M?:'

'BER PLOT EDIT,'
'DELETE BER PLOT CURVE (Column) in DATA WINDOW,'
'SPECIFY NUMBER of EXISTING CURVE to be DELETED, 1 - M?:'

'BER PLOT EDIT,'
'INSERT NEW BER PLOT SNR dB VALUE (Row) in DATA WINDOW,'
'SPECIFY SNR dB VALUE which will be preceded adjacently to the new SNR dB VALUE, 
  fn MAX?:'

'BER PLOT EDIT,'
'DELETE BER PLOT SNR dB VALUE (Row) in DATA WINDOW,'
'SPECIFY SNR dB VALUE to be DELETED, fn MAX?:'

where M is the largest BER Plot Curve number and fn is the largest SNR dB value 
inputted from the User selected BER Plot Data File.
Based on the answers to a subset of the above BER Plot Edit queries, the following four Visual Builders (Data Windows) are presented (displayed) sequentially to the User where the User-Specified BER Plot and Figure Data is entered and the 'Apply' button is engaged for each data window: 
1) 'BER PLOT CURVE (S) Data' where the User enters the Edited BER Plot's SNR, Eb/N0, 
    in dB Values and/or Curve x BER Values into the Data Window's Columns enabled 
    data cells where x is an integer number assigned to a particular BER Curve 
    and x ranges from 1 to M';

2) 'BER PLOT LEGEND' & BER PLOT DATA' where the User enters Curve x Descriptors;
3) 'BER Plot Figure Descriptor' where the User enters a description of the BER Plot 
    figure; &
4) 'BER PLOT Curve Color - Curve Number Assignment' where the User enters the color - 
    curve selections.
Note the particular edited BER Curve (s) value (s) and/or SNR dB value (s) are still shown in the individual Data Window Cell (s) but are not accessible by the User when the 'REMOVE' function for BER Curve (s) and/or SNR dB is used.

When the 'DELETE' function is used, the particular edited BER Curve (s) value (s) and/or SNR dB value (s) are still shown in the individual Data Window Cell (s) but are not accessible by the User.

Note the 'BER Plot Figure Descriptor' Visual Builder has an 'ACCEPT the PROPOSED FIGURE DESCRIPTION' query that must be answered before the second 'Apply' button is engaged.

Then the BER Plot is presented (displayed) via a 'Plot-ber1' window for User review along with an AdvDCSM: DCSS Guide notification of 'BER PLOT EDITED DATA OBTAINED for BER PLOT GENERATION.' If the User clicks on the dialog 'OK', the following query is presented (displayed) to the User: 
'BER PLOT NEW GENERATION or EDIT,'
'BER PLOT DATA PARAMETERS (DATA) DESTINATION: DESIGN STORE?:'
'SAVE to a USER-NAMED DATA FILE'
'or NOT SAVE'
If the User selects the 'SAVE to a USER-NAMED DATA FILE' choice, the following query is presented (displayed) to the User: 
'BIT ERROR (BER)/BIT ERROR PROBABILITY (Pb) PLOT EDIT,'
'BER PLOT DATA PARAMETERS OUTPUT FILE NAME with ".txt", 51 MAX LENGTH?:'
Finally, the User can save the displayed BER Plot via the 'Plot-ber1' window's 'Save As...' choice under the 'File' menu after the User enters a User-Specified '.PLT-BER' file name and clicking the 'OK' button.