# Agilent N8975A

Control the Agilent N8975A instrument from Python with the `AgilentN8975A` driver.

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

A class representing the Agilent N8975A Noise Figure Analyzer.

## Publishing through instro

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

with PymeasureInstrument(
    name="nfa",
    instrument=AgilentN8975A("GPIB0::16::INSTR"),
    dataset_rid="<dataset rid>",
) as nfa:
    nfa.device.adapter.connection.timeout = 30000  # set a new timeout to 30 sec
    nfa.device.abort()  # abort all running measurements
    nfa.device.single()  # perform a single sweep measurement
    nfa.device.complete
    noise_figure = nfa.device.noise_figure_db  # get the noise figure data
    gain = nfa.device.gain_db  # get the gain data
```

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

nfa = AgilentN8975A("GPIB0::16::INSTR")
recorder = attach(nfa, "nfa", [NominalCorePublisher(dataset_rid="<dataset rid>")])
nfa.adapter.connection.timeout = 30000  # set a new timeout to 30 sec
nfa.abort()  # abort all running measurements
nfa.single()  # perform a single sweep measurement
nfa.complete
noise_figure = nfa.noise_figure_db  # get the noise figure data
gain = nfa.gain_db  # get the gain data

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

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