# Agilent E5062A

Control the Agilent E5062A network analyzer from Python with the `AgilentE5062A` driver.

**Driver:** [pymeasure](https://pymeasure.readthedocs.io)  
**Type:** [Network analyzers](https://dev.nominal.io/instro/instruments/type/vna.md)  
**Manufacturer:** [Agilent](https://dev.nominal.io/instro/instruments/manufacturer/agilent.md)

Represents the Agilent E5062A Vector Network Analyzer.

## Publishing through instro

instro publishes the commands you send to a AgilentE5062A and the values you read from it, through any [publisher](https://dev.nominal.io/instro/library/publishers.md). It takes two forms, both described in the [pymeasure guide](https://dev.nominal.io/instro/library/pymeasure.md). Install with `uv add "instro[pymeasure]"`.

### With a PymeasureInstrument

[`PymeasureInstrument`](https://dev.nominal.io/instro/library/pymeasure.md#write-new-instro-code) wraps the driver in an instro instrument, with tags and background polling. The instrument is created inside the `with` block, and `.device` is the pymeasure instrument.

```python
from pymeasure.instruments.agilent import AgilentE5062A
from instro.pymeasure import PymeasureInstrument

# connect to the VNA and make a measurement consisting of 10 averages
with PymeasureInstrument(
    name="vna",
    instrument=AgilentE5062A("TCPIP::192.168.2.233::INSTR"),
    dataset_rid="<dataset rid>",
) as vna:
    ch = vna.device.channels[1]            # use channel 1
    ch.visible_traces = 4            # use all 4 traces
    for i, (tr, parameter) in enumerate(zip(
            ch.traces.values(),
            ['S11', 'S12', 'S21', 'S22'])):
        tr.parameter = parameter

    ch.averages = 10                # use 10x averaging
    ch.averaging_enabled = True     # turn averaging on
    ch.trigger_continuous = False   # turn off continuous triggering
    vna.device.trigger_source = 'BUS'      # require remote trigger
    vna.device.abort()                     # stop the current sweep
    ch.restart_averaging()          # clear current averaging
    for _ in range(ch.averages):
        ch.trigger_initiate()       # arm channel 1 for single sweep
        vna.device.trigger_single()        # send a trigger
        vna.device.wait_for_complete()     # wait until the sweep is complete

    # see `agilentE5062A.data` for an example of saving the measurement
```

### With existing pymeasure code (`attach()`)

[`attach()`](https://dev.nominal.io/instro/library/pymeasure.md#publish-from-existing-code) adds publishing to pymeasure code you already have. The imports, the `attach()` call after the instrument is created, and `recorder.close()` are all that instro adds.

```python
from pymeasure.instruments.agilent import AgilentE5062A
from instro.lib import NominalCorePublisher
from instro.pymeasure import attach

# connect to the VNA and make a measurement consisting of 10 averages
vna = AgilentE5062A("TCPIP::192.168.2.233::INSTR")
recorder = attach(vna, "vna", [NominalCorePublisher(dataset_rid="<dataset rid>")])
ch = vna.channels[1]            # use channel 1
ch.visible_traces = 4            # use all 4 traces
for i, (tr, parameter) in enumerate(zip(
        ch.traces.values(),
        ['S11', 'S12', 'S21', 'S22'])):
    tr.parameter = parameter

ch.averages = 10                # use 10x averaging
ch.averaging_enabled = True     # turn averaging on
ch.trigger_continuous = False   # turn off continuous triggering
vna.trigger_source = 'BUS'      # require remote trigger
vna.abort()                     # stop the current sweep
ch.restart_averaging()          # clear current averaging
for _ in range(ch.averages):
    ch.trigger_initiate()       # arm channel 1 for single sweep
    vna.trigger_single()        # send a trigger
    vna.wait_for_complete()     # wait until the sweep is complete

# see `agilentE5062A.data` for an example of saving the measurement

recorder.close()  # flush and close the publishers
```

The examples are adapted from the [pymeasure documentation for `AgilentE5062A`](https://pymeasure.readthedocs.io/en/latest/api/instruments/agilent/agilentE5062A.html#pymeasure.instruments.agilent.agilentE5062A.AgilentE5062A), which lists every property and method.
