pre6GReferenceSignalIndices

Pre-6G reference signal resource element indices

Since R2026a

collapse all in page

    Syntax

    ind = pre6GReferenceSignalIndices(carrier,rs)
    ind = pre6GReferenceSignalIndices(___,Name=Value)

    Description

    Add-On Required: This feature requires the 6G Exploration Library for 5G Toolbox add-on.

    ind = pre6GReferenceSignalIndices(carrier,rs) returns reference signal (RS) resource element (RE) indices for 6G research and prototyping. carrier and rs are the carrier and RS configuration parameters, respectively.

    example

    ind = pre6GReferenceSignalIndices(___,Name=Value) specifies options using one or more name-value arguments. For example, IndexBase="0based" returns 0-based indices.

    example

    Examples

    collapse all

    This example uses:

    Open Live Script

    Create a carrier configuration object and an RS configuration object. Configure the RS with frequency-domain CDM length 2 and two antenna ports.

    carrier = pre6GCarrierConfig;
rs = pre6GReferenceSignalConfig;
rs.FrequencyDomainCDM = 2;
rs.SubcarrierLocations = [0 6];
rs.PortSet = 0:1;

    Get the RE indices. The output contains 52 indices per antenna port.

    ind = pre6GReferenceSignalIndices(carrier,rs);
disp(size(ind));
        52     2

    Now get the indices with a batch size of 4. The output is a 3-D array with one page per batch element.

    ind = pre6GReferenceSignalIndices(carrier,rs,BatchSize=4);
disp(size(ind));
        52     2     4

    Input Arguments

    collapse all

    Carrier configuration parameters for a specific OFDM numerology, specified as a pre6GCarrierConfig object. This function uses only the NSizeGrid and SymbolsPerSlot properties of the pre6GCarrierConfig object.

    RS configuration parameters, specified as a pre6GRSConfig object. This function uses only these pre6GReferenceSignalConfig object properties:

    Name-Value Arguments

    collapse all

    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.

    Example: IndexStyle="subscript",IndexBase="0based" specifies the RE indexing form and base, respectively, of the output.

    Enable GPU processing, specified as one of these values:

    • "off" — The function executes on the CPU.

    • "on" — The function executes on the GPU.

    • "auto" — If a GPU is available, the function automatically executes on the GPU. If no GPUs are available, the function executes on the CPU.

    To use a GPU to accelerate computations in MATLAB®, you must have Parallel Computing Toolbox™ and a supported GPU device. For more information on supported devices, see GPU Computing Requirements (Parallel Computing Toolbox).

    Data Types: char | string

    Batch size for parallel processing, specified as a positive integer. When IndexStyle is "index", this input determines the third dimension of the ind output, which you can use to separate your data for parallel processing.

    RE indexing form, specified as one of these values:

    • "index" — The function returns linear indices in column form.

    • "subscript" — The function returns subscript indices as an (NRE × P)-by-3 matrix, where NRE is the number of REs per port and P is the number of ports. The columns correspond to [subcarrier, symbol, port] subscripts.

    Data Types: char | string

    RE indexing base, specified as one of these values:

    • "1based" — The indices start from 1.

    • "0based" — The indices start from 0.

    Data Types: char | string

    Output Arguments

    collapse all

    RS RE indices, returned as a 3-D array or matrix. The format depends on the IndexStyle name-value argument:

    • "index" — The function returns ind as an NRE-by-P-by-B array, where NRE is the number of REs per port, P is the number of ports, and B is the BatchSize name-value argument. Each page contains the linear indices into the resource grid for a given port and batch element.

    • "subscript" — The function returns ind as an (NRE × P)-by-3 matrix. The columns correspond to [subcarrier, symbol, port] subscripts.

    The IndexBase name-value argument controls whether the returned indices are 1-based or 0-based.

    Data Types: uint32

    Extended Capabilities

    expand all

    Version History

    Introduced in R2026a

    See Also

    Functions

    Objects