devices.keysight:PSA_E4440A

The device class for the Agilent PSA E4440A - Spectrum Analyzer.

Usage

Source

devices.keysight:PSA_E4440A(
    interface,
    reset=True,
    timeout=10000.0,
    **kwargs,
)

It can possibly be used with different models with little changes.

Attributes

Name Description
maxAverage The maximum average setting of all configured channels.

maxAverage

The maximum average setting of all configured channels.

maxAverage=1

The PSA will trigger that many sweeps, so the averaging requirement for each channel is satisfied.

Methods

Name Description
__init__() Initialize the device.
configureSweep() Configure sweep settings for the spectrum analyzer.
getData() Transfer measurement data from the PSA.
getSweepData() Prepare, trigger, and get data from a sweep operation.
readSweepParams() Read the current sweep parameters from the PSA.
reset() Reset the PSA using the SYST:PRES command.
startSweep() Prepare the PSA for triggering a sweep.
trigger() Trigger a sweep and wait for completion.

__init__()

Initialize the device.

Usage

Source

__init__(
    interface,
    reset=True,
    timeout=10000.0,
    **kwargs,
)

Parameters

interface: str

The IP address and port where the device is located. e.g. TCPIP::192.168.5.52::5025::SOCKET

reset: bool = True

If true, the PSA is reset on object creation using the reset method. Default is True.

timeout: int = 10000.0

The timeout of the ethernet connection in milliseconds. Default is 10e3 ms.

**kwargs
Keyword arguments passed to the VISAdevice constructor.

configureSweep()

Configure sweep settings for the spectrum analyzer.

Usage

Source

configureSweep(
    fCent,
    fSpan,
    fPoints,
    refLev,
    resBW,
    vidBW,
    average=None,
    avgType="rms",
    scale="log",
    getData=False,
)

Sets frequency, bandwidth, averaging, and display parameters. Frequency units are in Hz. ‘MIN’/‘MAX’ can be used instead of actual numbers to select the lowest/highest setting the PSA is capable of.

Parameters

fCent: float

Center frequency of the sweep in Hz.

fSpan: float

Frequency span of the sweep in Hz.

fPoints: int

Number of points per sweep.

refLev: float

Reference level for the display in dBm.

resBW: float

Resolution bandwidth in Hz.

vidBW: float

Video bandwidth in Hz.

average: int = None

Number of averages which make up the final values. Default is None (no averaging).

avgType: (rms, log, scalar) = "rms"

‘rms’ power (RMS) averaging, ‘log’ log-power (video) averaging, ‘scalar’ voltage averaging. Default is ‘rms’.

scale: (log, lin) = "log"

Display format: ‘lin’ linear, ‘log’ logarithmic. Default is ‘log’.

getData: bool = False
If True, trigger a sweep and return the results directly. Default is False.

Returns

numpy.ndarray or None
The sweep data if getData is True, None otherwise.

getData()

Transfer measurement data from the PSA.

Usage

Source

getData(precision="single")

Reads trace data in different formats based on the precision parameter.

Parameters

precision: (single, double, ascii) = "single"
The data format precision to use: ‘single’ and ‘double’ precisions are transferred as binary data, and achieve much faster transfer speeds. ‘ascii’ is only implemented as a fallback method, as it is much easier to debug. Default is ‘single’.

Returns

numpy.ndarray
The measured data from the spectrum analyzer.

getSweepData()

Prepare, trigger, and get data from a sweep operation.

Usage

Source

getSweepData()

This is a convenience method that combines startSweep(), trigger(), and getData() operations into a single call.

Returns

numpy.ndarray
The measured data from the spectrum analyzer.

readSweepParams()

Read the current sweep parameters from the PSA.

Usage

Source

readSweepParams()

Queries the center frequency, span, and number of points settings and calculates the start/stop frequencies. All frequencies are returned in Hz.

Returns

tuple
A tuple containing (fStart, fStop, fPoints) where:
  • fStart (float): The frequency at which the sweep starts in Hz
  • fStop (float): The frequency at which the sweep stops in Hz
  • fPoints (int): The number of points in the sweep

reset()

Reset the PSA using the SYST:PRES command.

Usage

Source

reset()

Note that this does not reset the data transfer format! Use *RST for this.

startSweep()

Prepare the PSA for triggering a sweep.

Usage

Source

startSweep()

The PSA disables the continuous trigger and therefore enables manual triggering. Any currently running sweeps are aborted.

trigger()

Trigger a sweep and wait for completion.

Usage

Source

trigger()

Adjusts the connection timeout based on the sweep parameters to ensure the operation completes successfully.