Tutorial
These examples assume that the nP browser bundle has been loaded or the package has been imported as nP. The Introduction explains the two analysis paths.
Sweep an RF circuit
Set the frequencies before constructing the components. Connect a resistor and inductor in series, then request the input reflection and forward transmission in dB.
nP.global.fList = nP.global.fGen(0.1e9, 6e9, 101);
var r1 = nP.R(25);
var l1 = nP.L(2e-9);
var circuit = nP.nodal(
[r1, 1, 2],
[l1, 2, 3],
['out', 1, 3]
);
var response = circuit.out('s11dB', 's21dB');
nP.schematic(circuit);
nP.lineChart({inputTable: [response], title: 'Series R-L response'});nP.schematic(circuit) draws the connected resistor and inductor, including the node numbers used above. response is a table whose first row names the columns. You can also pass it to nP.lineTable(). The Schematics guide explains the drawing controls and shape guidance.
Send a digital signal through a circuit
Create a separate analysis context, then call mod() before constructing the attenuator. mod() fills the selected context's frequency list with the signal's FFT frequencies. The {signal: tx} argument attaches that signal to the connected n-port.
var context = nP.global();
context.tList = context.tGen(0, 319 / 8e9, 320); // 'hello': 40 bits × 8 samples.
context.fList = [];
var tx = nP.mod({mode: 'ASCII', message: 'hello'});
var attenuator = nP.Attn(3);
var chain = nP.cascade(attenuator, {signal: tx});
var rx = nP.demod(chain, {noise: false});
var receivedText = rx.out('ASCII text');
var receivedWaveform = rx.out('waveform');
var signalPath = {transmitter: tx, circuit: chain, receiver: rx};
nP.log(receivedText);
nP.schematic(signalPath);
nP.lineChart({
inputTable: [receivedWaveform],
title: 'Received waveform',
metricPrefix: 'none',
xAxisTitle: 'Time (ns)',
yAxisTitle: 'Voltage (V)'
});The schematic shows the MOD source, attenuator, and DEMOD receiver. Their diagram connectors describe signal flow. The waveform table already uses nanoseconds, so metricPrefix: 'none' leaves those values unchanged. The clean reception above makes the signal path easy to inspect. By default, demod() includes a new random thermal-noise waveform on each call. For a repeated bit-error measurement, use nP.bitErrorRate(tx, chain, {receptions: 100}).
Continue exploring
- RF Constructors introduces the component families.
- Noise covers noise figure and output noise density.
- Intermodulation covers two-tone products and intercepts.
- Circuit examples shows larger RF networks.
- The API topics describe the current functions and their defaults.