主要内容

pre6GResourceGrid

Generate empty pre-6G carrier slot resource grid

Since R2026a

    Description

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

    grid = pre6GResourceGrid(carrier,p) generates an empty pre-6G carrier slot resource grid for the specified carrier configuration parameters carrier and number of antennas p.

    example

    grid = pre6GResourceGrid(___,Name=Value) specifies options using one or more name-value arguments. For example, UseGPU="on" specifies that the resource grid is created on the GPU if one is available.

    example

    Examples

    collapse all

    Create a carrier configuration object, specifying an extended cyclic prefix length and a subcarrier spacing of 3.75 kHz. Specify two antennas.

    carrier = pre6GCarrierConfig(CyclicPrefix="extended",SubcarrierSpacing=3.75);
    p = 2;

    Create an empty resource grid for the configuration and antennas. Specify automatic selection between GPU and CPU processing and a batch size of 10.

    grid = pre6GResourceGrid(carrier,p,UseGPU="auto",BatchSize=10);

    Display the size of the resource grid.

    dimensions = size(grid)
    dimensions = 1×4
    
        624    3    2    10
    
    

    Input Arguments

    collapse all

    Pre-6G carrier configuration parameters for a specific OFDM numerology, specified as a pre6GCarrierConfig object. This function uses only these properties of the pre6GCarrierConfig object:

    Number of antennas, specified as a positive integer.

    Data Types: double

    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: pre6GResourceGrid(carrier,p,useGPU="on") specifies that the resource grid is created on the GPU if one is available.

    Data type of the output symbols, specified as "single" or "double".

    Data Types: char | string

    Enable GPU processing, specified as one of these values:

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

    • "on" — The function executes on the GPU and returns the output grid as a gpuArray (Parallel Computing Toolbox) object on the GPU.

    • "auto" — If a GPU is available, the function automatically executes on the GPU and returns the output grid as a gpuArray object 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. This input determines the fourth dimension of the grid output, which you can use to separate your data for parallel processing.

    Output Arguments

    collapse all

    Empty carrier slot resource grid, returned as a complex-valued array of size K-by-L-by-p-by-BatchSize.

    • K is the number of subcarriers.

    • L is the number of OFDM symbols in a slot.

    Data Types: single | double
    Complex Number Support: Yes

    Extended Capabilities

    expand all

    Version History

    Introduced in R2026a