# S-Parameter Testbench

Measure S-parameters of system

**Library:**RF Blockset / Circuit Envelope / Testbenches

## Description

Use the S-Parameter Testbench block to measure the S-parameter data of a general RF system. The S-parameter testbench sequentially injects a stimulus signal into each port and measures the response at all ports to obtain the scattering matrix of the RF system. While the stimulus should be small signal for meaningful measurement, the testbench allows for large steady state external signals.

## Parameters

**Main**

`Use Internal Configuration block`

— Use testbench internal configuration block

on (default) | off

Select to use testbench internal configuration block. Clear this parameter
to specify your own configuration block. Clearing this check box removes the
**Approximate transient as small signal** option in the
**Advanced** tab.

**Note**

When using your own configuration block, parameters such as step size, fundamental tones, harmonic order, and simulate noise may affect the measured results.

`Input power amplitude (dBm)`

— Input power to DUT

`-30`

(default) | real-valued scalar

Input power to device under test (DUT), specified as a real valued scalar
in dBm. You can change the input power by entering the value in the text box
or selecting a value using the knob. The specified input power represents
the power available at the input ports of the DUT. The valid values are from
`-90`

through `60`

dBm.

This parameter is disabled while simulation is running when the
**Approximate transient as small signal** option is
checked in the **Advanced** tab.

**Data Types: **`double`

`Number of ports`

— Number of measured ports

`2`

(default) | scalar integer

Number of measured ports, specified as a scalar integer limited to the range 1:128. Once you change the number of ports, new ports appear on the block.

**Data Types: **`double`

`Measure all S-parameters`

— Measure entire S-parameters matrix

on (default) | off

Select to measure entire S-parameters matrix. This measurement is done by
sequentially exciting each port and measuring all the ports for the output.
When you select this box, **Save measurement result to
.s2p** button appears below this parameter. In this case, the
output signal S-parameters are of dimension
*N*-by-*N*-by-*F*.
*N* is the number of ports and *F* is
the number of frequencies.

Clear this parameter to manually specify the S-parameters elements. In
this case, the output signal S-parameters are of dimension
*M*-by-*F*. *M* is
the total number of S-parameter elements and *F* is the
number of frequencies.

`Export measurement results to sNp`

— Save S-parameters data to Touchstone file

button

Click to save the measured S-parameters data to a Touchstone file. This
button opens a standard dialog box for browsing and choosing a file. The
only file type suggested is `.s`

,
where *N*p*N* is the number of measured ports. This button is
disabled before the first simulation takes place and while simulations are
running or initializing. It captures the results of the previous
simulations. The *N* value in `.sNp`

corresponds to the number of ports previously measured.

#### Dependencies

To enable this parameter, select **Measure all
S-parameters**.

`S-Parameter elements`

— S-parameter elements to measure

`[1 1]`

(default) | two-column matrix

S-parameter elements to measure, specified as a two-column matrix. Each
row represents an S-parameter element. The first column represents the
incident wave port and the second column represents the scattered wave port.
For example, `[[2 1];[1 1]]`

indicates a two element
measurement: S21 and S11. You can choose any elements from the matrix in any
order, but the elements must be unique.

#### Dependencies

To enable this parameter, clear **Measure all
S-parameters**.

**Data Types: **`double`

`Workspace variable name`

— Variable name to store the measurement data in MATLAB workspace

`'SparamObjOut'`

(default) | character vector

Variable name to store the measurement data in MATLAB^{®} workspace, specified as a character vector. The data is stored
as an RF Toolbox™
`sparameters`

object.

**Data Types: **`char`

`Input frequency (Hz)`

— Carrier frequency of DUT

`2.1e9`

(default) | scalar

Carrier frequency of the DUT, specified as a scalar in Hz. By default, output frequency is equal to the input frequency because S-parameters are measured to quantify linear systems.

For small-signal measurements over large constant external signals, you
can specify an output frequency in the **Advanced** tab
when **Adjust for steady-state external signals** is
selected.

**Data Types: **`double`

`Baseband bandwidth (Hz)`

— Baseband bandwidth of input signal

`10e6`

(default) | positive finite scalar

Baseband bandwidth of input signal, specified as a positive finite scalar
in Hz. The measured frequencies reside on this band around the input carrier
frequency. This band is by default narrower than the solver envelope
bandwidth to keep simulation artifacts outside of the measured results. The
ratio of the two bands can be controlled using **Ratio of Envelope
to Baseband bandwidths** in the **Advanced**
tab.

**Data Types: **`double`

`Reference Impedance (Ohm)`

— Impedance for S-parameter measurement

`50`

(default) | positive finite scalar

Impedance for S-parameter measurement, specified as a positive finite scalar in ohms. All ports are measured using the same reference impedance.

**Data Types: **`double`

`Show S-Parameter spectrum`

— View measured values of specified S-parameters over the specified frequency bandwidth

off (default) | on

Select to view measured values of specified S-parameters over the
specified frequency bandwidth using a spectrum analyzer. You can view two
types of curves in the plot: `Magnitude`

or
`Real & Imag`

. The
`Magnitude`

plot shows the s-parameter data
magnitudes is in dBm. `Real & Imag`

shows both
the real and imaginary parts of the S-parameters. The real and imaginary
plot of the S-parameters has no units.

**Note**

To view the S-parameters spectrum using a Spectrum Analyzer, you need a DSP System Toolbox™ license.

`Ground and hide negative terminals`

— Internally ground and hide RF circuit terminals

on (default) | off

Select to internally ground and hide the negative terminals. Clear to expose the negative terminals. By exposing these terminals, you can connect them to other parts of your model.

**Advanced**

`FFT Length`

— Number of FFT bins

`128`

(default) | scalar integer power of 2

Number of FFT bins used for measurements, specified as a scalar integer power of 2. The value must be an integer power of 2. This value controls the spectral resolution of measurements over the specified bandwidths.

`Measurement Time`

— Total time duration

`12.8`

μs (default) | scalar integer

This parameter is read-only.

Total time duration in which each port output is measured to get the
spectral result, specified as a scalar integer. The value is the ratio of
**FFT Length** over the **Baseband
bandwidth** specified in the **Main** tab. It
lets you know that any system response beyond this value is not included in
the spectral result. This bound is an outcome of the spectral resolution
limitation.

`Ratio of wait time to measurement time`

— Intermission between sequential measurements

`0`

(default) | scalar integer

Intermission between sequential measurements where the port excitation
varies, specified as a scalar integer number of **Measurement
time** instances. Similar to real measurements, the DUT cannot
be reset to clear its internal states. By switching between measurements too
fast, outputs that extend beyond the **Measurement time**
can be collected in the next measurement. This value helps to avoid the
contamination of the next measurement.

`Ratio of Envelope to Baseband bandwidths`

— Ratio of internal solver envelope bandwidth to measured bandwidth

`8`

(default) | scalar integer power of 2

Ratio between internal solver envelope bandwidth and measured bandwidth, specified as a scalar integer power of 2.

`Adjust for steady state external signals`

— Adjust for large steady state signals

off (default) | on

Select to adjust for large steady-state external signals and measure only the linear effect of the DUT for small signal stimulus injected by the testbench. This means that the DUT can contain elements that mix with large signals that are constant-in-time over the envelope at each carrier. When you select this parameter, you can specify an output frequency different from the input frequency.

Clear this if there are no signals injected to the DUT external to the testbench.

**Note**

The DUT should not contain any external signals that are time varying over the envelope at each carrier.

`Output frequency (Hz)`

— Output carrier frequency

`2.1e9`

(default) | positive finite scalar

Output carrier frequency, specified as a positive finite scalar.

#### Dependencies

To enable this parameter, select **Adjust for steady state
external signals**.

`Approximate transient as small signal`

— Choose small subset of frequencies for transient small signal analysis

off (default) | on

Select this option to choose a small subset of frequencies for transient small signal analysis. Use this parameter to accelerate the measurement of S-parameters of the large nonlinear systems around a given operation point specified by large external steady-state signals.

`Use all steady-state simulation frequencies for small signal analysis`

— Use all frequencies automatically chosen for full-harmonic balance nonlinear solution

on (default) | off

Select this option to use all frequencies automatically chosen for a full-harmonic balance nonlinear solution. Clear to specify the frequencies that carry the small-signal transient.

#### Dependencies

To enable this parameter, check **Approximate transient as
small signal**.

`Small signal frequencies (Hz)`

— Frequencies that carry small signal transient

`2.1e9`

(default) | scalar | vector

Frequencies that carry the small signal transient, specified as a real scalar integer or vector. The specified frequencies should be contained in the entire set of simulation frequencies. If some frequencies are not contained, a warning message appears. If all frequencies are not contained, an error message appears.

#### Dependencies

To enable this parameter, clear **Use all steady-state
simulation frequencies for small signal analysis**.

`Populate Frequencies`

— Tool to choose small signal transient frequencies

button

Open the tool to choose small signal transient frequencies to populate
**Small signal frequencies**. The selected frequencies
are a subset of the simulation frequencies determined from
**Fundamental tones** and **Harmonic
order** used in simulation. The entire set of simulation
frequencies are given in the combo box on the right side of the dialog box,
and the selected frequencies are highlighted. You can select by directly
choosing the frequencies in the selection box, or by choosing the desired
tones and harmonic order in the **Small signal selection
panel** and clicking **Select**. The
**Tones (Hz)** and **Harmonic order**
values in the combo boxes are also populated using **Fundamental
tones** and **Harmonic order** used in
simulation.

#### Dependencies

To expose this parameter, clear **Use all steady-state
simulation frequencies for small signal analysis**.

## Model Examples

## References

[1] Razavi, Behzad. *RF
Microelectronics*. Upper Saddle River, NJ: Prentice Hall,
2011.

## Version History

**Introduced in R2019b**

## 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)