# LeCroy T3DSO1204

Control the LeCroy T3DSO1204 oscilloscope from Python with the `LeCroyT3DSO1204` driver.

**Driver:** [pymeasure](https://pymeasure.readthedocs.io)  
**Type:** [Oscilloscopes](https://dev.nominal.io/instro/instruments/type/scope.md)  
**Manufacturer:** [LeCroy](https://dev.nominal.io/instro/instruments/manufacturer/lecroy.md)

Represents the LeCroy T3DSO1204 Oscilloscope interface for interacting with the instrument.

## Publishing through instro

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

with PymeasureInstrument(
    name="scope",
    instrument=LeCroyT3DSO1204(resource),
    dataset_rid="<dataset rid>",
) as scope:
    scope.device.autoscale()
    ch1_data_array, ch1_preamble = scope.device.download_waveform(source="C1", points=2000)
    # ...
    scope.device.shutdown()
```

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

scope = LeCroyT3DSO1204(resource)
recorder = attach(scope, "scope", [NominalCorePublisher(dataset_rid="<dataset rid>")])
scope.autoscale()
ch1_data_array, ch1_preamble = scope.download_waveform(source="C1", points=2000)
# ...
scope.shutdown()

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

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