# Agilent 33220A

Control the Agilent 33220A function generator from Python with the `Agilent33220A` driver.

**Driver:** [pymeasure](https://pymeasure.readthedocs.io)  
**Type:** [Function and waveform generators](https://dev.nominal.io/instro/instruments/type/awg.md)  
**Manufacturer:** [Agilent](https://dev.nominal.io/instro/instruments/manufacturer/agilent.md)

Represents the Agilent 33220A Arbitrary Waveform Generator.

## Publishing through instro

instro publishes the commands you send to a Agilent33220A 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 Agilent33220A
from instro.pymeasure import PymeasureInstrument

# Default channel for the Agilent 33220A
with PymeasureInstrument(
    name="wfg",
    instrument=Agilent33220A("GPIB::10"),
    dataset_rid="<dataset rid>",
) as wfg:

    wfg.device.shape = "SINUSOID"          # Sets a sine waveform
    wfg.device.frequency = 4.7e3           # Sets the frequency to 4.7 kHz
    wfg.device.amplitude = 1               # Set amplitude of 1 V
    wfg.device.offset = 0                  # Set the amplitude to 0 V

    wfg.device.burst_state = True          # Enable burst mode
    wfg.device.burst_ncycles = 10          # A burst will consist of 10 cycles
    wfg.device.burst_mode = "TRIGGERED"    # A burst will be applied on a trigger
    wfg.device.trigger_source = "BUS"      # A burst will be triggered on TRG*

    wfg.device.output = True               # Enable output of waveform generator
    wfg.device.trigger()                   # Trigger a burst
    wfg.device.wait_for_trigger()          # Wait until the triggering is finished
    wfg.device.beep()                      # "beep"

    print(wfg.device.check_errors())       # Get the error queue
```

### 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 Agilent33220A
from instro.lib import NominalCorePublisher
from instro.pymeasure import attach

# Default channel for the Agilent 33220A
wfg = Agilent33220A("GPIB::10")
recorder = attach(wfg, "wfg", [NominalCorePublisher(dataset_rid="<dataset rid>")])

wfg.shape = "SINUSOID"          # Sets a sine waveform
wfg.frequency = 4.7e3           # Sets the frequency to 4.7 kHz
wfg.amplitude = 1               # Set amplitude of 1 V
wfg.offset = 0                  # Set the amplitude to 0 V

wfg.burst_state = True          # Enable burst mode
wfg.burst_ncycles = 10          # A burst will consist of 10 cycles
wfg.burst_mode = "TRIGGERED"    # A burst will be applied on a trigger
wfg.trigger_source = "BUS"      # A burst will be triggered on TRG*

wfg.output = True               # Enable output of waveform generator
wfg.trigger()                   # Trigger a burst
wfg.wait_for_trigger()          # Wait until the triggering is finished
wfg.beep()                      # "beep"

print(wfg.check_errors())       # Get the error queue

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

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