add
R2026bSyntax
Description
add(
adds search parameters to select RF components from a third-party database using one or more
name-value arguments. rfse,'SelectedSearchParameters',Name=Value)
Note
Install the third-party component database containing Analog
Devices™ amplifiers and mixers with the installRFParts()
command.
add(
adds the display columns specified in rfse,'DisplayColumns',displayFields)displayFields to the part
parameter table.
add(
resets the part selection table to display all the columns in it.rfse,'DisplayColumns','all')
Examples
Install the 3P component installed database.
installRFParts()
Select the amplifier from the 3P component installed database. To do this, first create an rfPartSelector object to specify the type of component you want to select.
rfps = rfPartSelector(Type='Amplifier')
Display all the available amplifier components from this database.
show(rfps,'all')

The installed database contains 174 amplifiers. Add parameter filters to select the amplifiers that operates with the gain between 12 dB and 20 dB, noise figure between 4 dB and 10 dB, OP1 between 20 dBm and 30 dBm, and OIP3 between 20 dBm to 30 dBm.
add(rfps,"SelectedSearchParameters","GainRange",[12 20], "NoiseFigureRange",[4 10],"OP1dBRange",[20 30],"OIP3Range",[20 30])
Display the selected amplifiers.
show(rfps,'selected')

The part parameter table contains 14 columns. Retain only the columns that are relevant to your search criteria. In this example, five parameters are non-relevant and must be removed from the table.
remove(rfps,"DisplayColumns","OPSAT (dBm)","Voltage (V)", "Current (mA)", "Operating Temp (degC)","Package Type")
Display the selected amplifiers with the updated part parameter table.
show(rfps,'selected')

Use the rfPart function to create amplifiers from 3P component data. You can either:
Select all amplifiers displayed based on your filtering criteria and generate
amplifierobjects.Choose a specific amplifier that meets your application requirements and create its
amplifierobject.
amp = rfPart(rfps,"HMC451LP3")

Build an RF chain that includes this amplifier, a component modeled from a Touchstone file, and an element created using an rfelement object. Then, calculate the RF budget for the complete chain at an input frequency of 6.09 GHz, an available input power of −30 dBm, and a bandwidth of 10 MHz.
n = nport('passive.s2p');
r = rfelement(Gain=10);
b = rfbudget([amp r n],6.09e9,-30,10e6)
The RF budget result as follows:
b = rfbudget with properties: Elements: [1x3 rf.internal.rfbudget.Element] InputFrequency: 6 GHz AvailableInputPower: -30 dBm SignalBandwidth: 10 MHz Solver: Friis AutoUpdate: true Analysis Results OutputFrequency: (GHz) [ 6 6 6] OutputPower: (dBm) [-10.64 -0.643 -3.975] TransducerGain: (dB) [ 19.36 29.36 26.03] NF: (dB) [ 8.6 8.6 8.6] IIP3: (dBm) [ 8.511 8.511 8.511] OIP3: (dBm) [ 28 38 34.67] SNR: (dB) [ 65.38 65.38 65.37]
Use the rfPartSelector object to search and filter mixer components from the Analog Devices database, then create an RF mixer component from the results.
First, install the third-party component database.
installRFParts()
Create an rfPartSelector object for mixers from Analog Devices.
rfse = rfPartSelector(Type="mixer", Vendor="ADI")
rfse =
rfPartSelector with properties:
Type: "mixer"
Vendor: "ADI"
SearchParameters: {16×1 cell}
SelectedSearchParameters: {}
ParameterValues: {}
NumAllParts: 82
NumSelectedParts: 82
DisplayColumns: {14×1 cell}
Filter for downconverter IQ mixers with conversion gain between -9 and -6 dB.
add(rfse, "SelectedSearchParameters", ... "ConverterType", "DownConverter", ... "GainRange", [-9 -6], ... "RFPrimaryFunction", "IQ Mixer")
Display the filtered mixer parts in a table.
show(rfse)
List_No Part Number RF Primary Function Converter Type Model Type Sideband Min RF Freq (MHz) Max RF Freq (MHz) Min IF Freq (MHz) Max IF Freq (MHz) Min LO Freq (MHz) Max LO Freq (MHz) Gain (dB) Operating Temp (degC) Package Type
_______ _____________ ___________________ _______________ ____________ ________ _________________ _________________ _________________ _________________ _________________ _________________ _________ _____________________ ____________
1 "HMC521ALC4" "IQ Mixer" "DownConverter" "IMT" "LSB" 10400 10400 100 100 10500 10500 -6.59 25 "24 ld LCC"
2 "HMC521ALC4" "IQ Mixer" "DownConverter" "Non Linear" "LSB" 5000 13500 100 3500 8000 14000 -7.44 25 "24 ld LCC"
3 "HMC521ALC4" "IQ Mixer" "DownConverter" "IMT" "USB" 10600 10600 100 100 10500 10500 -6.59 25 "24 ld LCC"
4 "HMC521ALC4" "IQ Mixer" "DownConverter" "Non Linear" "USB" 8500 17000 100 3500 8000 14000 -6.83 25 "24 ld LCC"
5 "HMC524ALC3B" "IQ Mixer" "DownConverter" "Non Linear" "USB" 20000 32000 100 2500 17500 31900 -7.39 25 "12 ld LCC"
6 "HMC8191LC4" "IQ Mixer" "DownConverter" "IMT" "LSB" 5000 27000 100 5000 6100 31000 -8.0038 25 "24 ld LCC"
7 "HMC8191LC4" "IQ Mixer" "DownConverter" "Non Linear" "LSB" 5000 28000 100 5000 6100 31000 -8.0038 25 "24 ld LCC"
8 "HMC8191LC4" "IQ Mixer" "DownConverter" "Non Linear" "USB" 6000 30000 100 5000 5500 27000 -8.68 25 "24 ld LCC"
9 "HMC8193LC4" "IQ Mixer" "DownConverter" "IMT" "LSB" 2500 8500 100 3500 2600 12000 -7.2 25 "24 ld LCC"
10 "HMC8193LC4" "IQ Mixer" "DownConverter" "Non Linear" "LSB" 1500 9000 100 4500 2100 9100 -6.5 25 "24 ld LCC"
11 "HMC8193LC4" "IQ Mixer" "DownConverter" "IMT" "USB" 2500 8500 100 3500 1000 8400 -7.62 25 "24 ld LCC"
12 "HMC8193LC4" "IQ Mixer" "DownConverter" "Non Linear" "USB" 2250 10000 100 4500 2000 8900 -6.62 25 "24 ld LCC"
Create an RF mixer component object from the first part in the filtered results.
comp = rfPart(rfse, 1)
comp =
mixerIMT: MixerIMT element
Name: 'HMC521ALC4'
ConverterType: 'Down'
Sideband: 'lower'
SystemData: [1×1 rfSystemParameters]
InputFrequency: 1.0400e+10
LO: 1.0500e+10
ReferenceInputPower: -10
NominalOutputPower: -16.5900
Zin: 50
Zout: 50
NF: 0
IMTdiff: [6×6 double]
IMTsum: [6×6 double]
Input Arguments
RF part selector, specified as an rfPartSelector
object.
Name of the column to display, specified based on the part being added. Specify one or more values according to the selected part.
| Amplifiers | Mixers (since R2026b) |
|---|---|
Part Number | Part Number |
RF Primary Function | RF Primary Function |
Min Freq (MHz) | Converter Type |
Max Freq (MHz) | Model Type |
Gain (dB) | Sideband |
Noise Figure (dB) | Min RF Freq (MHz) |
OP1dB (dBm) | Max RF Freq (MHz) |
OIP3 (dBm) | Min IF Freq (MHz) |
OPSAT (dBm) | Max IF Freq (MHz) |
Voltage (V) | Min LO Freq (MHz) |
Current (mA) | Max LF Freq (MHz) |
Operating Temp (degC) | Gain (dB) |
Package Type | Operating Temp (degC) |
Package Type |
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: add(rfse,'SelectedSearchParameters',InputFrequency=2000,RFPrimaryFunction='IQMixer')
Amplifiers
Minimum frequency range of operation, specified as a two-element vector of a nonegative integers in Hz.
Example: MinFrequencyRange=[5000 10000]
Maximum frequency range of operation, specified as a two-element vector of a nonegative integers in Hz.
Example: MaxFrequencyRange=[5000 10000]
Noise figure range of the selected components, specified as a two-element vector of a nonnegative integers in dB.
Example: NoiseFigureRange=[2 4.6]
First-order intercept range of the selected components, specified as a two-element vector of a nonnegative integers in dBm.
Example: OP1dBRange=[10 19]
Third-order intercept range of the selected components, specified as a two-element vector of a nonnegative integers in dBm.
Example: OIP3Range=[10 19]
Output saturation range of the selected components, specified as a two-element vector of a nonnegative integers in dBm.
Example: OPSATRange=[10 19]
Operating voltage range of the selected components, specified as a two-element vector of a nonnegative integers in V.
Example: VoltageRange=[0.4 5.2]
Operating voltage range of the selected components, specified as a two-element vector of a nonnegative integers in mA.
Example: CurrentRange=[0.2 1.9]
Mixers
Since R2026b
Converter type of the mixer, specified as either UpConverter or
DownConverter.
Example: ConverterType='UpConverter'
Model type of the mixer, specified as either IMT or
Non Linear.
Example: ModelType='IMT'
Sideband of the mixer, specified as either LSB or
USB.
Example: Sideband='USB'
Local oscillator (LO) frequency of the mixer, specified as a nonnegative integer in Hz.
Example: LOFrequency=1500
Minimum RF frequency range of the mixer in Hz, specified as a two-element vector of nonnegative integers.
Example: MinRFFreqRange=[5000 10000]
Maximum RF frequency range of the mixer in Hz, specified as a two-element vector of nonnegative integers.
Example: MaxRFFreqRange=[5000 10000]
Minimum intermediate frequency (IF) range of the mixer in Hz, specified as a two-element vector of nonnegative integers.
Example: MinIFFreqRange=[500 2000]
Maximum IF frequency range of the mixer in Hz, specified as a two-element vector of nonnegative integers.
Example: MaxIFFreqRange=[500 2000]
Minimum local oscillator (LO) frequency range of the mixer in Hz, specified as a two-element vector of nonnegative integers.
Example: MinLOFreqRange=[1000 3000]
Maximum LO frequency range of the mixer in Hz, specified as a two-element vector of nonnegative integers.
Example: MaxLOFreqRange=[1000 3000]
Applicable to both Amplifiers and Mixers
Since R2026b
Part number of a third-party component, specified as a string. The value you
specify in PartNumber must match with a part number in the
installed database. To display the part numbers of all parts in the installed
third-party database, use the show
function.
Example: PartNumber='ADL5240AMP'
Primary function of the component, specified as a character vector. The value you
specify in RFPrimaryFunction must match with a primary function
of the component in the installed database. To display the primary function of the
component of all the parts in the installed third-party database, use the show
function.
Example: RFPrimaryFunction='IQMixer'
Component frequency in Hz, specified as a nonnegative integer.
Example: Freqeuncy=500
Component gain range in dB, specified as a two-element vector of a nonnegative integer.
Example: GainRange=[10 20]
Operating temperature range of the selected components in C, specified as a two-element vector of a nonnegative integers.
Example: OperatingTempRange=[10 32]
Package type of the selected components, specified as a character vector. The
value you specify in Package must match the component package
type in the installed database. To display the packages of all parts in the installed
third-party database, use the show
function.
Example: Package='8-Lead-LFCSP
Version History
Introduced in R2026aYou can now use the add function to add search parameters to select
mixers and display the selected mixers with the updated part parameter table from the
Analog Devices component database
The following name-value argument names are renamed in R2026b:
| R2026a | R2026b |
|---|---|
Frequency | InputFrequency |
MinFrequencyRange | MinFreqRange |
MaxFrequencyRange | MaxFreqRange |
If you have code that uses the old argument names from R2026a, the software will error when you run the code in R2026b. Update your code to use the new name-value argument names.
See Also
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)