nrPRBS

Generate PRBS

Syntax

[seq,cinit] = nrPRBS(cinit,n)

[seq,cinit] = nrPRBS(cinit,n,Name,Value)

Description

[seq,cinit] = nrPRBS(cinit,n) returns the elements specified by n of the pseudorandom binary sequence (PRBS) generator, when initialized with cinit. The function implements the generator specified in TS 38.211 Section 5.2.1 [1]. For uniformity with the channel-specific PRBS functions, the function also returns the initialization value cinit.

[seq,cinit] = nrPRBS(cinit,n,Name,Value) specifies additional output formatting options by using one or more name-value pair arguments. Unspecified options take their default values.

Examples

Generate Pseudorandom Scrambling Sequence

Generate a 1000-bit binary scrambling sequence. Initialize the PRBS generator with the specified value.

cinit = 9;
prbs = nrPRBS(cinit,1000);

Input Arguments

cinit — Initialization value for PRBS generator

integer from 0 to 2³¹ – 1

Initialization value for the PRBS generator, specified as an integer from 0 to 2³¹ – 1.

Data Types: double

n — Elements in returned sequence

nonnegative integer | [p m] row vector

Elements in returned sequence, specified as one of these values:

• Nonnegative integer — seq contains the first n elements of the PRBS generator.

• [p m] row vector — seq contains m contiguous elements of the PRBS generator, starting at position p (0-based).

Data Types: double

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: 'MappingType','signed' specify non-default sequence formatting properties.

MappingType — Output sequence formatting

'binary' (default) | 'signed'

Output sequence formatting, specified as the comma-separated pair consisting of 'MappingType' and one of these values:

• 'binary' — This value maps true to 1 and false to 0. The data type of the output sequence is logical.

• 'signed' — This value maps true to –1 and false to 1. The data type of the output sequence is double. To specify single data type, use the 'OutputDataType' name-value pair.

Data Types: char | string

OutputDataType — Data type of output sequence

'double' (default) | 'single'

Data type of output sequence, specified as the comma-separated pair consisting of 'OutputDataType' and 'double' or 'single'. This name-value pair applies only when 'MappingType' is set to 'signed'.

Data Types: char | string

Output Arguments

seq — Pseudorandom scrambling sequence

logical column vector | numeric column vector

Pseudorandom scrambling sequence, returned as a logical or numeric column vector. The output seq contains the elements of the PRBS generator specified by n. If you set 'MappingType' to 'signed', the data type of seq is either double or single. If you set 'MappingType' to 'binary', the output data type is logical.

Data Types: double | single | logical

References

[1] 3GPP TS 38.211. “NR; Physical channels and modulation.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

Names and values in name-value pair arguments must be compile-time constants. For example, when specifying 'single' as the output data type, include {coder.Constant('OutputDataType'),coder.Constant('single')} in the -args value of the codegen function. For more information, see the coder.Constant (MATLAB Coder) class.

Version History

Introduced in R2018b