Main Content

exportTransmitter

Export RF budget summary to create phased transmitter

Since R2024b

collapse all in page

    Syntax

    exportTransmitter(rfb)
    exportTransmitter(rfb,Name=Value)
    h = exportTransmitter(___)

    Description

    Use the exportTransmitter function to export the RF budget summary and create phased.Transmitter (Phased Array System Toolbox) System object™ from the exported data. This function exports the rfbudget summary into a MATLAB® script. To run this script, this function requires a Phased Array System Toolbox™ license.

    Note

    This function cannot export the RF budget summary to create a phased.Transmitter System object if one of the elements in the rfbudget object is an rfantenna object.

    exportTransmitter(rfb) exports the rfbudget object summary and creates a phased.Transmitter (Phased Array System Toolbox) System object from the exported data.

    exportTransmitter(rfb,Name=Value) specifies additional export properties using name-value arguments. For example, exportTransmitter(Model="ampm") exports the RF budget summary with the gain of the transmitted signal is specified in a lookup table. Properties you do not specify retain their default values.

    h = exportTransmitter(___) returns a function handle.

    example

    Examples

    collapse all

    Open Live Script

    Calculate the RF budget for a chain of two elements consisting of an amplifier and an IMT mixer.

    a = amplifier(Gain=4);
imt = mixerIMT(LO=5995e6,IMT=...
     [99 17 13.6 42.9; 40 0 47.7 54.3; 50.4 58.5 61.3 72.2; 75 67.4 75 99]);
rfb = rfbudget([a imt], 2.1e9,-30,10e6);

    Export the RF budget summary and create phased.Transmitter System object from the exported data. The AM/AM-AM/PM lookup table contains all the necessary information to describe the behavior of the system for various input power levels.

    The function exports the rfbudget summary into a MATLAB script and the script opens automatically in the MATLAB Editor window.

    h = exportTransmitter(rfb,Model="ampm");

    export_tx.png

    Close the script.

    h.closeNoPrompt
    Open Live Script

    Create an amplifier with a gain of 4 dB.

    a = amplifier(Gain=4);

    Create a modulator with an OIP3 of 13 dBm.

    m = modulator(OIP3=13);

    Create an N-port element using passive.s2p.

    n = nport('passive.s2p');

    Create an RF element with a gain of 10 dB.

    r = rfelement(Gain=10);

    Create the RF budget of a series of RF elements at an input frequency of 2.1 GHz, an available input power of –30 dBm, and a bandwidth of 10 MHz.

    rfb = rfbudget([a m r n],2.1e9,-30,10e6);

    Export the RF budget with nonlinearity to create the phased.Transmitter System object. Note that if the rfbudget object contains nonlinear parameters, such as OIP3, the gain of the exported phased.Transmitter System object is determined using Cubic polynomial as the GainMethod. Otherwise, the exportTransmitter function sets GainMethod phased.Transmitter System object to Linear.

    h = exportTransmitter(rfb);

    cubic.png

    Close the script.

    h.closeNoPrompt

    Input Arguments

    collapse all

    RF budget object, specified as an rfbudget object.

    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.

    Example: Model='ampm',AMPMPowerIn=[2 2]

    Model type, specified as cubic or ampm. The function determines the gain of the exported transmitter object based on the model type.

    • cubic — The function uses a cubic polynomial model to apply non-linear gain.

    • ampm — The function uses a lookup table defined within the rfbudget object to directly determine the output power and phase shift based on the specified input power

    Example: Model='ampm'

    Input power for the AM/AM-AM/PM lookup table, specified as a real finite vector in dBm. Specify the input power for the AM/AM-AM/PM lookup table when you set Model to ampm.

    Example: AMPMPowerIn=[2 4]

    Output Arguments

    collapse all

    Function handle, returned as a character vector to the Document window in the editor.

    Version History

    Introduced in R2024b

    See Also

    | | | |