Docs › New User's Guide

Welcome to circuitRF!

Never used a circuit simulator before? Perfect — this guide starts from the very beginning and gets you to your first working simulation. No prior EDA experience assumed, and no question is too basic.

1 · Why simulate? And what circuitRF does

Building RF hardware is expensive and slow. A circuit simulator lets you predict how a design behaves before you build it — and lets you ask "what if?" a hundred times in an afternoon. circuitRF answers questions like: How much does this amplifier gain at 2 GHz? How much power does it put out before it saturates? How efficient is it? What load impedance makes it happiest?

circuitRF is built specifically for RF and microwave work. You'll hear it's "not a SPICE simulator" — that just means it focuses on the questions RF designers ask (frequency response, gain, efficiency, intermodulation, loadpull) rather than the time-domain waveforms a SPICE tool chases. If those RF words are new, don't worry — you'll meet them gently below.

2 · The circuitRF window

Here is what you will be looking at. The middle of the window is the document area and holds your documents — schematics, layouts, plots — one per tab. Around them sit the tool panels: the Project panel on the left is the folder you are working in, the Library on the right is every part you can place, Properties shows whatever you have selected, and Messages along the bottom is the application telling you what it did.

Every region of that window, numbered and named: The Workspace ▸ The regions of the window.

The folder behind it is called a workspace. It is an ordinary folder on disk with a .cws file in it and one sub-folder per cell — nothing hidden, nothing in a database — which is why the Project panel and your file browser always agree with each other.

3 · The Library: your box of parts

Every part you can place lives in the Library, shown as the Library Palette — a panel of tiles, each a component. Resistors, capacitors, inductors, sources, transistors, transmission lines, and more. You can filter by category or type in the search box (try "cap" or "tline"). To place one, click its tile and then click on the canvas (or drag the tile onto the canvas).

A library is also where reusable building blocks you create yourself live — which brings us to cells.

4 · Cells — symbol, schematic and layout

A cell is circuitRF's reusable building block. Think of it like a chip you can drop into a bigger design. A cell has up to three views — three ways of looking at the same block:

• A Symbol — the little glyph you see when you place the cell, and where its connection points (pins) sit. It's how the cell looks from the outside.

• A Schematic — the actual circuitry inside the cell: the components and wires that make it work.

• A Layout — the physical artwork: the copper, the substrate stackup it sits on, and the vias through it. It is drawn to real dimensions against a technology (a PCB or MMIC process), and it is what the electromagnetic solver simulates when you want the parasitics of the real thing rather than the ideal components the schematic names.

Why a symbol and a schematic? Because the symbol is the convenient outside view and the schematic is the detailed inside view. When you use an amplifier cell ten times in a design, you want to see ten tidy amplifier symbols — not ten copies of the full transistor-level schematic cluttering your screen. The symbol hides the detail; the schematic holds it.

And why a layout as well? Because above a couple of gigahertz the wiring stops being wiring. A 90° bend, a length of line and the gap between two traces all have electrical behaviour of their own, and none of it is in the schematic. The layout is where that behaviour comes from — you draw the artwork, and the planar method-of-moments solver turns it into S-parameters you can put back into the circuit.

A cell does not need all three. A test bench is usually schematic-only; a piece of artwork imported from GDSII may be layout-only. The two are kept in step in either direction by Design ▸ Update Layout from Schematic and Update Schematic from Layout, which reconcile the components in one against the artwork in the other.

5 · Hierarchy: circuits inside circuits

Because a cell can contain other cells, designs are hierarchical — circuits nested inside circuits, as deep as you like. A two-stage amplifier might be one cell that contains two "single-stage amplifier" cells, each of which contains a transistor cell and a matching-network cell.

To look inside a cell, push into it (open its schematic); when you're done, pop back out. Editing a cell changes every place it's used — fix the amplifier once, and all ten instances update. That reuse is the whole point of hierarchy: build a thing once, use it everywhere, maintain it in one place.

6 · Parameters & editing values

A parameter is a value you can change — a resistor's resistance, an inductor's inductance, a source's power. Cells can declare their own parameters too (say, an amplifier cell with a Gain parameter), and when you place that cell you can override the parameter for that one instance. Values flow top-down: the parent sets a value, the cell uses it. (circuitRF also catches circular definitions and tells you, so you can't tie yourself in knots.)

7 · Pins, Ports, and Terms

These three sound alike but do different jobs, and keeping them straight saves confusion later:

• A Pin is a cell's connection point — how a reusable cell plugs into the design around it. (Pins live on a cell's symbol.)

• A Term is an S-parameter port: a numbered, reference-impedance (usually 50 Ω) connection where the simulator measures a network. You place Terms to say "measure the S-parameters between here and here."

• A Port is the general idea of an external connection. Inside a cell, a port is a Pin; on an S-parameter test bench, a port is a Term.

Why it matters: a Pin just exposes a connection for reuse; a Term actively defines where and how the simulator excites and measures. Use the wrong one and you'll either have no measurement port or an unintended source impedance. The Reference Guide shows each with pictures.

8 · The simulation types

Different questions need different analyses. circuitRF offers four big ones:

You don't have to choose perfectly up front — start with S-parameters to see a network's frequency response, then move to harmonic balance when you want to drive it into nonlinear territory.

9 · The Data Display & plot types

Results appear in the Data Display, where you choose how to view them. Why several plot types? Because RF data comes in different flavors:

• Rectangular — the familiar X–Y graph (e.g. gain in dB vs. frequency). For real, scalar numbers.

• Smith chart — a special circular chart for impedance and reflection. If you've not seen one: it maps every possible impedance onto a disk, which makes matching networks and reflection coefficients intuitive to read. It's the RF engineer's favorite chart.

• Polar — magnitude-and-angle on a circular plot, for complex quantities where you care about phase.

• Table — the numbers themselves, in a grid.

10 · Two worked examples

A. The simplest possible DC simulation

1. New Schematic. Place a Vdc source and a Resistor; place a Ground.
2. Wire the source across the resistor, and connect the bottom to ground. Set the source to 10 V and the resistor to 100 Ω (double-click each value).
3. Add a DC analysis in the Analyses panel and press Run.
4. Open a Data Display → Table to read the node voltage and current. (Ohm's law says 0.1 A — a good first sanity check that everything's wired right.)

B. A first S-parameter simulation

1. Place two Terms (they auto-number 1 and 2) and a small network between them — for example a series inductor and a shunt capacitor, or a TLIN transmission line.
2. Add an S-Parameter analysis over, say, 1–5 GHz.
3. Run, then open a Data Display. On a Rectangular plot, add S(2,1) with the dB20 transform to see insertion loss vs. frequency; on a Smith chart, add S(1,1) to see the input match.

Build the schematic below and you should get the response beside it — a series 2 nH and a shunt 0.8 pF between two 50 Ω Terms, swept 1–5 GHz.

11 · Loadpull, contours & Pursuit

For a power amplifier, the load impedance you present to the transistor's output dramatically changes its power and efficiency. Loadpull finds the sweet spot: circuitRF sweeps the load reflection coefficient over a grid of points on the Smith chart, runs a harmonic-balance simulation at each, and draws contours — like a topographic map where the "hills" are high output power or high efficiency. You read off the impedance at the peak and design your output match toward it.

Two things make this delightful in circuitRF:

• Measured data plots exactly like simulated data. A loadpull file from the lab (Touchstone, .spl, or .lpcwave) overlays on the same contour plot as your simulation — perfect for checking model against measurement.

• Loadpull Pursuit saves you time. Instead of you choosing the grid and hunting for the optimum by eye, Pursuit automatically searches for the terminations that maximize your chosen metric (peak power, peak efficiency), homing in on the useful region of the Smith chart for you.

12 · Matching networks: the Match component

Sooner or later you will want to get from the impedance your transistor presents to the 50 Ω the rest of the world runs at. circuitRF has a component that designs the network for you: place a Match, double-click it, and the Match Designer opens.

One thing to know before you open it, because it is the thing every experienced RF engineer trips over:

There is also one button worth reading about before you press it. Shunt DC Block is not the series blocking capacitor you may be expecting in the signal path — it stops a shunt inductor from shorting your bias supply to ground, so the capacitors it adds appear in the arms that run to ground. The reference chapter explains it, and the tooltip on the button says the same thing in two sentences.

The full story — what absorption buys you, how to read the solutions list, and the two worked amplifier examples — is in The Match Component.

Ready for specifics? The Reference Guide documents every component, every analysis setting, and the plot types in detail. Already comfortable with simulators? The Quick Start is the fast path.