Generated banner for Matlab Model Rf
Generated logo for Matlab Model Rf

Matlab Model Rf

MathWorksOfficialCreated by MathWorks

  • Skill
  • Guidelines
  • Science and research
  • BSD-2-Clause
  • No issues found

From the author

RF Toolbox and RF Blockset in MATLAB -- S-parameter I/O, network conversions (S/Z/Y/ABCD/T/H/G, mixed-mode), cascade/de-embedding, rfbudget analysis, circuit composition, matching networks, amplifier stability, mixer spurs, rational fitting, SI channels, baseband processing, Circuit Envelope simulation. Trigger: sparameters, Touchstone, .s2p, .s4p, rfplot, smithplot, rfparam, rfwrite, zparameters, yparameters, abcdparameters, s2sdd, cascadesparams, deembedsparams, rfbudget, noise figure, OIP3, IIP3, amplifier, modulator, nport, rffilter, attenuator, seriesRLC, shuntRLC, lcladder, txline, circuit, setports, clone, matchingnetwork, stabilityk, stabilitymu, powergain, gammams, gammaml, mixerIMT, OpenIF, rational, rationalfit, stepresp, txlineWRLGC, rf.Amplifier, rf.Mixer, rf.Filter, rf.Sparameter, rfsystem, RF Blockset.
— the description by MathWorks

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides a structured approach to utilizing MATLAB's RF Toolbox and RF Blockset for end-to-end RF system development. It covers workflows ranging from measured S-parameter data validation and network conversions to complex circuit-level design, amplifier stability analysis, and time-domain Circuit Envelope simulation. The documentation emphasizes best practices for script-based workflows, proper element handling, and avoiding common pitfalls in RF parameter manipulation and system modeling.

What it does

  • Validates and processes measured S-parameter data from Touchstone files.
  • Performs network parameter conversions and mixed-mode analysis.
  • Enables RF signal chain design and cascaded budget analysis.
  • Supports circuit-level composition and impedance matching network design.
  • Facilitates amplifier stability analysis and mixer intermodulation planning.
  • Provides tools for rational fitting and time-domain system simulation.

When to use it

  • When working with measured S-parameter data for validation or de-embedding.
  • When designing RF signal chains and performing cascaded budget analysis.
  • When composing arbitrary RF circuits using node-based netlists.
  • When analyzing amplifier stability or mixer spur performance.
  • When performing time-domain signal integrity or Circuit Envelope simulations.

Advantages

  • Unified workflow for both passive and active RF device characterization.
  • Strict adherence to MATLAB identifier and object handling rules prevents silent errors.
  • Comprehensive support for modern visualization tools like tiledlayout and smithplot.
  • Clear separation between script-based design workflows and interactive analysis.
  • Detailed guidance on avoiding common errors in port ordering and parameter units.

Usage examples

“How do I load an S-parameter file and plot it on a Smith chart?”
The agent will guide you to use sparameters() to load the file, followed by smithplot() for visualization, ensuring you handle reference impedance correctly via newref() if needed.
“Calculate the cascaded gain and noise figure for my RF chain.”
The agent will help you define elements using rfbudget, ensuring you set the SignalBandwidth and use clone() for reused elements, then run the budget analysis.
“How do I analyze the stability of an amplifier?”
The agent will instruct you to use stabilityk and stabilitymu, and calculate power gain using powergain with the correct linear-to-dB conversion.
“I need to export my S-parameters to a new file.”
The agent will provide the rfwrite command, specifically reminding you to include 'ForceOverwrite', true to avoid interactive dialogs.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/matlab/matlab-model-rf/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip matlab-model-rf.zip -d .agents/skills

Documentation by MathWorks

RF Toolbox and RF Blockset

Design, analyze, and simulate RF systems in MATLAB -- from measured S-parameter data through full time-domain Circuit Envelope simulation. One unified workflow covering passive networks, active device characterization, system cascade budgets, and behavioral time-domain modeling.

When to Use

Measured data workflows

  • Loading Touchstone files (.s1p through .snp), validating quality (passivity, causality, IEEE P370)

  • Plotting on Smith charts and rectangular plots, interpolating, re-referencing impedance

  • Converting between S, Z, Y, ABCD, T, H, G parameters; computing mixed-mode differential

  • Cascading and de-embedding S-parameter networks; fixture removal

System design and analysis

  • Building RF signal chains from behavioral elements (amplifier, modulator, rffilter, nport, etc.)

  • Computing cascaded gain, noise figure, IP3, SNR, output power with rfbudget

  • Comparing Friis vs Harmonic Balance solver accuracy

  • Exporting to RF Blockset Simulink models, Communications Toolbox, or MATLAB scripts

Circuit-level design

  • Composing arbitrary RF circuits with node wiring (SPICE-like netlist)

  • Designing impedance matching networks (L, Pi, Tee topologies, Richards stubs)

  • Analyzing amplifier stability (K-factor, mu), power gain, and matching conditions

  • Mixer intermodulation analysis and spur-free IF frequency planning

Time-domain and signal integrity

  • Fitting S-parameters to rational models; computing TDR, impulse, step responses

  • Exporting broadband circuit models to SPICE or Verilog-A

  • Building SI channel models from nport blocks, lossy transmission lines, and parasitics

  • Processing complex baseband signals through rf.Amplifier, rf.Mixer, rf.Filter System Objects

  • Full Circuit Envelope time-domain simulation via rfsystem (no Simulink knowledge required)

When NOT to Use

  • Antenna design and radiation patterns -- use Antenna Toolbox

  • RF propagation modeling (path loss, fading, ray tracing) -- use Communications Toolbox or Phased Array System Toolbox

  • SerDes/high-speed serial link equalization (FFE, CTLE, DFE, IBIS-AMI) -- use SerDes Toolbox

  • Radar waveform design or phased arrays -- use Phased Array System Toolbox

Must-Follow Rules

These apply across ALL RF Toolbox workflows. Violating them produces silent errors or blocks execution.

Universal
  1. rfwrite blocks on existing files -- Always pass 'ForceOverwrite', true. Without it, MATLAB opens an interactive overwrite dialog that halts unattended execution.

  2. Elements cannot be reused -- The same element object cannot appear twice in an rfbudget or circuit. Use clone(element) for independent copies.

  3. Element Name must be a valid MATLAB identifier -- No spaces, no special characters. Use 'IFAmp' not 'IF Amp'.

  4. Use tiledlayout/nexttile -- Not subplot. For all multi-panel figures.

  5. rfparam returns complex, not dB -- Always use 20*log10(abs(rfparam(...))) for dB magnitude.

S-Parameters and Network Parameters
  1. sparameters(filename, Z0) is invalid -- Cannot pass reference impedance at load time. Load first, then newref(s, Z0).

  2. rfinterp1 interpolates real/imag independently -- Not magnitude and angle. Can produce artifacts near sharp resonances.

  3. Frequency alignment required for cascade/de-embed -- cascadesparams and deembedsparams require identical frequency vectors. Always rfinterp1 to a common grid first.

  4. deembedsparams always requires 3 arguments -- (sMeasured, sFixture1, sFixture2). For one-sided, pass an ideal thru for the unused side.

  5. Mixed-mode port ordering is the #1 error source -- s2sdd option 1 (default) treats ports 1,2 as positive and 3,4 as negative. Verify which option matches your VNA port numbering.

  6. snp2smp argument order: ports before impedance -- snp2smp(s, portList, Z0), not snp2smp(s, Z0, portList).

rfbudget and Elements
  1. SignalBandwidth is required -- The 4th positional arg to rfbudget. Without it, NF/IP3/SNR remain empty.

  2. Passive NF equals loss -- For rfelement, NF should equal abs(Gain). Prefer attenuator which handles this automatically.

  3. nport Name is positional -- nport('file.s2p', 'MyName'), not name-value syntax.

  4. rffilter: ResponseType is shape, FilterType is algorithm -- rffilter('FilterType', 'Bandpass') errors. Use rffilter('ResponseType', 'Bandpass').

  5. show(b) opens a GUI -- Produces no command-window output. Use properties (b.TransducerGain, b.NF) for programmatic access.

Circuit Composition
  1. setports/setterminals can only be called once -- Plan topology before defining terminals.

  2. 2-port RF elements use 4-node mapping -- add(ckt, [in out inRef outRef], elem) for amplifier, modulator, nport, all txline types. Primitive 2-terminal elements (resistor, capacitor, inductor) use 2-node mapping.

  3. Primitive constructors are positional -- resistor(100, 'R1'), not resistor('Resistance', 100).

  4. setterminals takes a node vector -- setterminals(ckt, [1 2]), not setterminals(ckt, 1, 2).

  5. All txline constructors use name-value pairs only -- No positional arguments.

Amplifier Analysis
  1. powergain gain type string must be last -- powergain(s, 50, 50, 'Gt'), not powergain(s, 'Gt', 50, 50).

  2. powergain returns linear, not dB -- Convert with 10*log10(g) (power gain uses 10x, not 20x).

  3. Gmag returns NaN when conditionally stable -- Use Gmsg at frequencies where K < 1.

Rational Fitting
  1. rational vs rationalfit -- Use rational for new code (AAA). Use rationalfit only for delay extraction.

  2. Single-param fit returns plain vectors; multi-port returns cell arrays -- Always check with iscell(result).

  3. freqresp takes Hz -- Not rad/s. Pass s.Frequencies directly.

System Objects (rf.*)
  1. rf.Amplifier/rf.Mixer use 1-ohm power -- Vin = sqrt(Pin_W). This differs from rfsystem which uses 50-ohm.

  2. rf.Filter frequencies are ABSOLUTE RF -- PassFreq_bp=[2.395e9 2.405e9] means absolute GHz. Not baseband offsets.

  3. Properties locked during use -- Call release(obj) before modifying Nontunable properties.

rfsystem
  1. Requires rfbudget -- rfsystem takes an rfbudget, not raw elements.

  2. close_system needs save flag -- Use close_system(rfs, 0) to discard changes.

  3. IdealizedBaseband only supports amplifier/modulator/rffilter/nport -- Other elements require CircuitEnvelope.

Workflow Quick Reference

TaskEntry PointDetails
Load/plot S-parameterssparameters, rfplot, smithplotreference/sparameters-io.md
Convert S/Z/Y/ABCD, mixed-modezparameters, s2sdd, snp2smpreference/network-conversions.md
Cascade or de-embed networkscascadesparams, deembedsparamsreference/cascade-deembed.md
Create rfbudget elementsamplifier, modulator, rffilter, etc.reference/rfbudget-elements.md
Run cascade budget analysisrfbudget, rfplot(b, 'Pout')reference/rfbudget-analysis.md
Compose RF circuitscircuit, add, setportsreference/circuit-composition.md
Design matching networksmatchingnetwork, richardsreference/matching-networks.md
Analyze amplifier stability/gainstabilityk, powergain, gammamsreference/amplifier-analysis.md
Mixer spurs and IF planningmixerIMT, OpenIFreference/mixer-analysis.md
Fit rational models, TDRrational, stepresp, generateSPICEreference/rational-fitting.md
Build SI channel modelsnport + txlineWRLGC + circuitreference/si-channel-modeling.md
Process complex basebandrf.Amplifier, rf.Mixer, rf.Filterreference/baseband-processing.md
Time-domain system simulationrfsystem, Circuit Envelopereference/system-simulation.md

Conventions

Code Style
  • Use tiledlayout/nexttile for multi-panel figures (not subplot)

  • Always label axes with units (GHz, dB, ns, dBm) and include figure titles

  • Name elements descriptively for readable topology ('LNA', 'DCBlock', 'PCBTrace')

  • Use clone() liberally for element reuse

Script-First Workflow

For design, analysis, or sweep tasks -- write code to .m files on disk, not inline snippets. For quick one-off checks, inline evaluate_matlab_code is fine.

Modern APIs
  • tiledlayout/nexttile instead of subplot

  • datetime instead of datenum

  • rational instead of rationalfit (unless delay extraction needed)

  • smithplot instead of smith

  • rfplot for S-parameter visualization (handles dB conversion automatically)

References

Load the relevant reference file before writing code for a specific workflow. Each reference contains correct calling conventions, constructor arguments, property names, gotchas, and executable code patterns.


Copyright 2026 The MathWorks, Inc.


Files

reference/ifft-step-response.md

iFFT Step Response from Frequency-Domain Data

Compute a time-domain step response from a frequency-domain transfer function H(f) using iFFT. Applies to any linear input-output relationship: impedance (current->voltage), admittance (voltage->current), S-parameters, voltage transfer functions, etc.

When to use

You have a frequency-domain transfer function H(f) — complex-valued, on a uniform frequency grid — and you want to see the time-domain output when the input is a step-like excitation. Examples:

H(f)InputOutputApplication
Z(f) impedanceCurrent stepVoltage waveformPDN droop analysis
Y(f) admittanceVoltage stepCurrent waveformInrush current
S21(f)Incident wave stepTransmitted waveChannel step response
S11(f)Incident wave stepReflected waveTDR
Voltage gain H(f)Input voltage stepOutput voltageFilter/amplifier response

Quick recipe

% Inputs: f_data (uniform freq vector, no DC), H_data (complex), riseTime (20-80%)
% Requirement: f_data(end) >= 0.6 / riseTime

df = f_data(2) - f_data(1);
M = length(f_data);
N = 2 * M;
dt = 1 / (2 * f_data(end));
t = (0:N-1)' * dt;

% DC extrapolation + one-sided spectrum
H_onesided = [real(H_data(1)); H_data(:)];
H_onesided(end) = real(H_onesided(end));     % Nyquist must be real

% Hermitian symmetry -> two-sided spectrum
H_full = [H_onesided; conj(H_onesided(end-1:-1:2))];

% Zero-mean raised cosine pulse (avoids wrap-around from slow modes)
x_pulse = raisedCosinePulse(t, riseTime, -0.5, +0.5);

% Multiply in frequency domain, recover time domain
y_raw = real(ifft(H_full .* fft(x_pulse)));
y_t = y_raw - y_raw(1);   % reference from pre-step condition

Key rules:

  • Bandwidth needed: f_max >= 0.6 / t_r (raised cosine is below -80 dB beyond this)

  • Observation window: T_window = 1/df — only first half is valid (pulse falls at midpoint)

  • DC bin must be real; Nyquist bin must be real

  • Use zero-mean pulse (-A/2 to +A/2) + subtract initial value — avoids wrap-around from slow inductive/reactive modes

  • Verify: max(abs(imag(ifft(...)))) < 1e-10 and y_t(1) == 0

  • Requires: raisedCosinePulse.m

DC extrapolation notes: The simple approach H(0) = real(H_data(1)) works for most cases. H(0) must be real (Hermitian symmetry at f=0 requires H(0) = conj(H(0))). Physically, H(0) is the system's DC gain: resistance for Z(f), DC transmission for S21, etc. With the zero-mean pulse, the DC bin is less critical (zero-mean input has no DC spectral content), but setting it correctly still improves accuracy for very low-frequency behavior.


Detailed explanations and pitfall descriptions follow below.

Background: why the naive approach fails

The textbook approach is straightforward: take iFFT of H(f) to get the impulse response, then integrate to get the step response. In practice, this produces garbage unless you handle several subtleties correctly. The approach below avoids the most common failure modes by reframing the problem.

Key design choices (and why)

Use a pulse, not a true step

The problem: A mathematical step function has a spectrum of pi*delta(f) + 1/(j2*pi*f). That delta at DC means the final settled value of your output depends entirely on the accuracy of H(0). If your frequency data starts at some f_min > 0 (typical for simulation or measurement), you don't have H(0) — and even a small extrapolation error produces a DC offset that dominates the result.

The solution: Use a wide pulse instead. The pulse rises, holds for a long time, then falls back down at the midpoint of the time window. Its spectrum is smooth and finite everywhere — including at DC.

Why this works: If the pulse width is much longer than any feature you care about (rise times, reflections, ringing), the pulse response is indistinguishable from a step response over your observation window. You get the same information without needing perfect DC knowledge.

The tradeoff: The pulse eventually turns off, so there's a falling edge at the midpoint of your time window. As long as you're only looking at the first half of the time record, this doesn't matter.

Use a raised cosine transition, not a linear ramp

The problem: A linear ramp has a discontinuous first derivative at its start and end points. This kink means the spectrum only rolls off as 1/f^2 — slowly. If your H(f) data is truncated at some maximum frequency (it always is), the abrupt spectral cutoff creates ringing in the time domain (Gibbs phenomenon). You'll see artificial oscillations that aren't in the physical system.

The solution: A raised cosine transition has zero derivative at both endpoints. Its spectrum rolls off extremely steeply — by f = 0.6 / t_rise, it's already below -80 dB. This means:

  • H(f) data beyond 0.6 / t_rise is irrelevant (it gets multiplied by essentially zero)

  • There are no spectral truncation artifacts because the pulse has no energy at the truncation frequency

  • You get a clean, artifact-free time-domain result

The 20%-80% convention: The rise time parameter specifies the 20%-to-80% transition time, matching how oscilloscopes report rise time in SI measurements.

Implementation: raisedCosinePulse.m
y = raisedCosinePulse(t, riseTime, lowVal, highVal)

Generates a pulse that rises from lowVal to highVal with a raised cosine transition, holds at highVal, then falls back to lowVal at the midpoint of the time vector using the same transition shape.

Algorithm

Step 1: Determine grid parameters from H(f) data

Given H(f) on a uniform grid f = f1, 2*f1, ..., M*f1 (no DC point):

df = f_data(2) - f_data(1);    % frequency spacing
f_max = f_data(end);            % maximum frequency
M = length(f_data);
N = 2 * M;                     % number of time points
dt = 1 / (2 * f_max);          % time step
T_window = N * dt;              % = 1/df, total time window

What these control:

  • df determines the total observation window: T_window = 1/df. Finer frequency spacing = longer time record.

  • f_max determines time resolution: dt = 1/(2*f_max). Higher bandwidth = finer time steps.

  • N falls out automatically from the other two.

Check: Verify f_max >= 0.6 / riseTime. If this fails, your H(f) data doesn't have enough bandwidth to faithfully represent the requested rise time. Either loosen the rise time requirement or obtain higher-frequency data.

Step 2: Extrapolate the DC point

H(f) from simulation or measurement typically starts at some f_min > 0. You must supply H(0) to construct the full spectrum. (If your data already includes the DC point at f=0, skip this step and Step 3's prepend — just use the data directly.)

Simple approach (usually adequate when using the pulse method):

H_dc = real(H_data(1));

This assumes the DC value equals the real part of the lowest available frequency point.

Why it must be real: We require H(-f) = conj(H(f)) for the output to be real-valued (Step 4). At f = 0, this gives H(0) = conj(H(0)), which is only satisfied if H(0) is real.

Why accuracy matters less here than with a true step: Because we're using a pulse (not a step), the DC point gets multiplied by a finite spectral value rather than a delta function. A small error in H(0) causes a small, bounded error in the output — not a catastrophic DC offset.

Step 3: Construct one-sided spectrum

Prepend the DC value to form the complete positive-frequency spectrum:

f_onesided = [0; f_data(:)];        % M+1 points: 0, df, ..., M*df (= f_nyquist)
H_onesided = [H_dc; H_data(:)];     % M+1 complex values

Force the Nyquist bin to be real:

H_onesided(end) = real(H_onesided(end));

This is required for the next step. The Nyquist frequency simultaneously represents both +f_max and -f_max, so it must equal its own complex conjugate (i.e., be real). If your data has a significant imaginary part at Nyquist, it usually means the data there is noisy or unreliable — which is fine, since the raised cosine pulse has negligible energy at Nyquist anyway.

Step 4: Build full two-sided H with Hermitian symmetry

For the iFFT to produce a real-valued time signal, the frequency-domain data must satisfy H(-f) = conj(H(f)). Construct the negative frequencies by mirroring:

H_full = [H_onesided; conj(H_onesided(end-1:-1:2))];

This produces N points in MATLAB's FFT bin ordering:

bin:   1     2     3    ...  N/2+1       N/2+2        ...    N
freq:  0     df   2*df  ... f_nyquist   -(f_nyq-df)   ...   -df

Why this ordering: MATLAB's fft/ifft expect this layout. Bins 1 through N/2+1 are non-negative frequencies (DC through Nyquist). Bins N/2+2 through N are negative frequencies in descending magnitude order.

Step 5: Generate input pulse and compute its FFT
t = (0:N-1)' * dt;
x_pulse = raisedCosinePulse(t, riseTime, -0.5, +0.5);  % zero-mean pulse
X_fft = fft(x_pulse);

The zero-mean pulse goes from -A/2 to +A/2 (here A=1). This ensures zero average value over the window, eliminating DC drive on reactive elements and preventing wrap-around from slow settling modes. The pulse lives entirely in the time domain and is transformed to match H(f)'s frequency grid. Because both share the same N and dt, their frequency bins are automatically aligned.

Step 6: Multiply and inverse FFT
Y_fft = H_full .* X_fft;
y_raw = real(ifft(Y_fft));
y_t = y_raw - y_raw(1);   % reference from pre-step condition

This implements Y(f) = H(f) * X(f), the frequency-domain equivalent of convolution. The real() call discards residual imaginary components that arise from floating-point arithmetic (typically at 1e-16 level). Subtracting y_raw(1) references the output from the pre-step steady state, so y_t(1) = 0 and subsequent values represent the deviation caused by the step.

Step 7: Sanity checks
imag_residual = max(abs(imag(ifft(Y_fft))));
assert(imag_residual < 1e-10, 'Hermitian symmetry is broken — check DC and Nyquist bins');

If this assertion fires, something is wrong with the spectrum construction — most likely the DC or Nyquist bin has an imaginary component, or the mirroring in Step 4 is incorrect.

Bandwidth rule of thumb

For a raised cosine pulse with 20-80% rise time t_r, the spectral energy is negligible beyond:

Attenuationf * t_r
-20 dB0.53
-40 dB0.60
-60 dB0.61
-80 dB0.61

Practical rule: f_max = 0.6 / t_r is sufficient. The raised cosine spectrum hits a sharp null at this point and stays below -80 dB beyond it.

Compare this to a linear ramp, which would need f_max > 10 / t_r for comparable attenuation. The raised cosine buys you an order of magnitude reduction in required bandwidth.

The full cosine transition duration relates to rise time by: T_full = t_r * pi / (acos(-0.6) - acos(0.6)) ~ 2.44 * t_r

Quick-reference: from requirements to frequency grid

You wantThis determines
Rise time t_r (e.g., 1 ns)Minimum bandwidth: f_max >= 0.6 / t_r (e.g., 600 MHz)
Observation window T_obs (e.g., 1 us)Frequency spacing: df = 1 / T_obs (e.g., 1 MHz)
BothNumber of points: N = 2 * f_max / df (e.g., 1200)

If you're generating the H(f) data (e.g., choosing simulation frequencies), use this table to pick your grid. If you're working with existing data, check that the data satisfies these constraints for your desired rise time.

Common pitfalls

1. Missing or incorrect DC point

Symptom: Large DC offset in the output, or the signal never settles to a physically reasonable value. Fix: Always extrapolate H(0) as described in Step 2. Never leave it out (which implicitly sets H(0)=0) or skip the DC bin.

2. Nyquist bin has imaginary component

Symptom: imag(ifft(...)) is not negligible — the sanity check in Step 7 fires. Fix: Force H_onesided(end) = real(H_onesided(end)) before constructing the Hermitian mirror.

3. Non-uniform frequency grid

Symptom: The algorithm produces nonsensical results or crashes. Fix: The iFFT requires uniform frequency spacing. If your H(f) data is on a non-uniform grid (e.g., log-spaced or adaptively sampled), interpolate it onto a uniform grid first. The main risk is under-sampling: if the original grid is too coarse near a resonance or sharp feature, no interpolation method will recover it faithfully. After interpolating, verify by overlaying the original and interpolated data — plot real and imaginary parts separately (not just magnitude), since magnitude can look smooth while real/imaginary parts oscillate rapidly through a resonance.

4. Insufficient bandwidth

Symptom: The rising edge looks sluggish or rounded compared to what you expect, even though you specified a fast rise time. Fix: Ensure f_max >= 0.6 / t_r. If your data doesn't extend high enough, you must either accept a slower effective rise time or obtain additional high-frequency data.

5. Time aliasing (window too short) — use a zero-mean pulse

Symptom: Spurious features appear near the rising edge, or the response looks "contaminated" with activity that shouldn't be there. The output at t=0 is nonzero when it should start from the pre-step condition. Cause: The iFFT is inherently circular — if the system's response hasn't settled by the time the pulse turns off (at T_window/2), the falling-edge response wraps around and contaminates the rising-edge observation window. This is catastrophic when the system has a slow mode (e.g., a VRM inductor with L/R = 20 us settling time vs. a 512 ns window). Fix — zero-mean pulse: Instead of a pulse from 0 to A, use a pulse from -A/2 to +A/2. This makes the pulse's time-average zero, eliminating the DC current drive on inductive elements. Without DC flux, the inductor has no long exponential settling, and the response decays within the window. Then reference the result from the pre-step condition:

x_pulse = raisedCosinePulse(t, riseTime, -Istep/2, +Istep/2);
Y_fft = H_full .* fft(x_pulse);
y_raw = real(ifft(Y_fft));
y_t = y_raw - y_raw(1);   % reference from pre-step condition

Physical analogy (SPICE): This is equivalent to initializing the inductor at its average current so the internal state variable starts at the correct steady-state value — the same trick required in SPICE transient simulations with reactive elements.

When you need this: Any time H(f) contains a pole with settling time > T_window/2. The telltale sign is a nonzero value at t=0 or visibly wrong DC offset even with the DC bin set correctly. For purely capacitive/resistive networks without slow inductive modes, the original 0-to-A pulse works fine.

Alternative (less preferred): Use finer df (longer time window) so that T_window/2 is much larger than the system's settling time. This can require impractically large N for systems with very long time constants.

6. Causality artifacts from circular convolution

Symptom: The output appears to respond slightly before the pulse starts (acausal pre-ringing near t=0). Cause: If H(f) represents a system with significant delay (linear phase), the impulse response is shifted in time. Circular convolution wraps the tail of the response around to the beginning. Fix: Shift the pulse start away from t=0 (add a quiet pre-trigger period), or zero-pad the spectrum to extend the time window.

File dependencies

  • raisedCosinePulse.m — generates the raised cosine pulse excitation waveform

Example: PDN impedance

% Load impedance data (complex Z on uniform frequency grid, no DC point)
data = load('ex1.mat');  % contains: freqUniform, Z_full_pdn
f_data = data.freqUniform;
H_data = data.Z_full_pdn;   % Z(f) is just one kind of H(f)

Istep = 1.0;        % 1 A load step
riseTime = 1e-9;    % 1 ns (20-80%)

% Step 1: Grid parameters
df = f_data(2) - f_data(1);
M = length(f_data);
N = 2 * M;
dt = 1 / (2 * f_data(end));
t = (0:N-1)' * dt;

% Step 2: DC extrapolation
H_dc = real(H_data(1));

% Step 3: One-sided spectrum
H_onesided = [H_dc; H_data(:)];
H_onesided(end) = real(H_onesided(end));

% Step 4: Hermitian symmetry
H_full = [H_onesided; conj(H_onesided(end-1:-1:2))];

% Step 5: Zero-mean input pulse (avoids VRM inductor wrap-around)
x_pulse = raisedCosinePulse(t, riseTime, -Istep/2, +Istep/2);

% Step 6: Frequency-domain multiply and iFFT
Y_fft = H_full .* fft(x_pulse);
y_raw = real(ifft(Y_fft));
y_t = y_raw - y_raw(1);   % reference from pre-step condition

% Step 7: Sanity checks
assert(max(abs(imag(ifft(Y_fft)))) < 1e-10, 'Hermitian symmetry broken');
assert(abs(y_t(1)) < 1e-15, 'Output should start at zero');

% Plot: voltage droop from 1A current step
plot(t*1e9, y_t*1e3);
xlabel('Time (ns)');
ylabel('Voltage Droop (mV)');
title('PDN Voltage Droop: 1A / 1ns Load Step');
grid on;

Copyright 2026 The MathWorks, Inc.


Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs Node.js

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Created by
MathWorks
Publisher
MathWorks (Official)
Source
matlab/matlab-agentic-toolkit · skills-catalog/rf-and-mixed-signal/matlab-model-rf · commit 2a7f215
Licence
BSD 2-Clause License (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE.md)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by MathWorks or MathWorks.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download matlab-model-rf.zip