# Agilent 8257D

Control the Agilent 8257D RF instrument from Python with the `Agilent8257D` driver.

**Driver:** [pymeasure](https://pymeasure.readthedocs.io)  
**Type:** [RF sources and meters](https://dev.nominal.io/instro/instruments/type/rf.md)  
**Manufacturer:** [Agilent](https://dev.nominal.io/instro/instruments/manufacturer/agilent.md)

Represents the Agilent 8257D Signal Generator and provides a high-level interface for interacting with the instrument.

## Publishing through instro

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

with PymeasureInstrument(
    name="generator",
    instrument=Agilent8257D("GPIB::1"),
    dataset_rid="<dataset rid>",
) as generator:

    generator.device.power = 0                     # Sets the output power to 0 dBm
    generator.device.frequency = 5                 # Sets the output frequency to 5 GHz
    generator.device.enable()                      # Enables the output
```

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

generator = Agilent8257D("GPIB::1")
recorder = attach(generator, "generator", [NominalCorePublisher(dataset_rid="<dataset rid>")])

generator.power = 0                     # Sets the output power to 0 dBm
generator.frequency = 5                 # Sets the output frequency to 5 GHz
generator.enable()                      # Enables the output

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

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