Main Content

5G Waveform Analyzer

Analyze and visualize imported or captured 5G waveforms and export analysis results

Since R2024b

expand all in page

Description

Use the 5G Waveform Analyzer app to analyze and visualize imported or captured 5G waveforms and export analysis results.

Using this app, you can:

  • Import waveforms from a .bb, .mat, or .txt file.

  • Capture waveforms using a connected spectrum analyzer instrument that supports the virtual instrument software architecture (VISA) interface (requires Instrument Control Toolbox™).

  • Specify the waveform configuration and analysis parameters.

  • Choose from a range of measurement visualization options such as a spectrum analyzer, constellation diagram, or various error vector magnitude (EVM) plots.

  • Export the waveform analysis results to your workspace or to a .mat file.

5G Waveform Analyzer app

Open the 5G Waveform Analyzer App

MATLAB® Toolstrip: On the Apps tab, under Signal Processing and Communications, click the app icon. 5G Waveform Analyzer

Examples

expand all

This example shows how to analyze and visualize imported or captured 5G waveforms and export analysis results using the 5G Waveform Analyzer app.

Open the 5G Waveform Analyzer App

On the Apps tab of the MATLAB® toolstrip, under Signal Processing and Communications, click the 5G Waveform Analyzer app icon. This app opens the Wireless Waveform Analyzer app configured for 5G waveform analysis.

Import 5G Waveform

To import a waveform, click Import File in the Input Mode section, then select a .bb, .mat, or .txt file that contains a 5G waveform. You can use the 5G Waveform Generator app to create, and then export 5G waveforms to a .bb, .mat, or .txt file.

  • If you import a .bb file that contains metadata, including nrDLCarrierConfig or nrULCarrierConfig, the app selects the metadata as the carrier configuration.

  • If you import a .mat file, it is recommended to have specific variable names such as waveform, fs, and configuration. If the waveform and configuration variable names are not present in the .mat file, the app selects the first variable that is a complex 2-D matrix as a waveform and nrDLCarrierConfig or nrULCarrierConfig as the configuration, respectively.

  • If you import a .txt file, the first column must contain the in-phase (I) samples and the second column must contain the quadrature (Q) phase samples.

Once you import the waveform, the app lists the IQ sample source, sample rate, and configuration source in the Waveform Parameters panel. If you select a file that does not contain sample rate information, update the Sample rate (Hz) field manually. To edit or view the carrier configuration, click Waveform Configuration.

Capture 5G Waveform

To capture a waveform, select Instrument Connection in the Input Mode section. Set the instrument parameters such as center frequency, span, sample rate, capture time, and gain. To connect to the instrument and start capturing the waveform, click Capture Waveform. You can capture waveforms using a connected spectrum analyzer instrument that supports the virtual instrument software architecture (VISA) interface. The waveform capture capability requires:

Analyze and Visualize Waveform

To start waveform analysis, click Analyze in the Analysis section. You can select the impairment correction method from the Measurements panel. You can choose from a range of measurement visualization options such as the spectrum analyzer, constellation diagram, or various error vector magnitude (EVM) plots from the Visualize option drop-down menu. Additionally, you can view the measurement summary of each bandwidth part (BWP) of the waveform. You can select the required BWP from the BWP ID drop-down in the EVM plots and constellation diagram.

Export Analysis Results

When the analysis is complete, you can export the analysis results to your workspace or to a .mat file. To export the analysis results, click Export and select either Export Results to Workspace or Export Results to MAT File from the drop-down menu. To save the app session, click Save Session in the File section. The session saves the values provided in the dialogs, selected visualizations, and the waveform configuration. To open an app session, click Open Session in the File section, and select the saved session you want to open.

Limitations

  • Instrument connection mode is not supported in MATLAB Online™.

  • Instrument connection mode is supported only on macOS with Intel® and Windows® platforms.

  • Instrument connection mode supports only a single receive antenna.

  • The 5G Waveform Analyzer only supports waveforms that satisfy these conditions:

    For downlink waveforms:

    • Only PDSCH and PDCCH configurations are supported. The analysis of reference signals is not supported.

    • In PDSCH configuration, all RNTIs must have the same number of layers and use the same modulation scheme.

    • Only single codeword and scalar power are supported for PDSCH configuration.

    • For PDCCH EVM computation, the waveform must have at least one PDSCH configuration.

    • Initial subframe number must be zero.

    For uplink waveforms:

    • Only PUSCH configuration is supported. The analysis of reference signals is not supported.

    • Only single PUSCH configuration per BWP is supported.

    • Only single codeword, scalar power, and resource blocks without interlacing are supported for PUSCH configuration.

    • Only carrier configuration without intracell guard bands is supported.

    • Initial subframe number must be zero.

Version History

Introduced in R2024b

See Also

Apps

Topics