# FormFactor Velox

Control the FormFactor Velox instrument from Python with the `Velox` driver.

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

A class representing the FormFactor Velox wafer prober.

## Publishing through instro

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

with PymeasureInstrument(
    name="prober",
    instrument=Velox("GPIB0::28::INSTR"),
    dataset_rid="<dataset rid>",
) as prober:
    coordinates = prober.device.wafermap.step_first_die()  # move to the first die in the wafermap
    while not self.wafermap.end_reached:
        prober.device.chuck.move_contact()  # move to contact height
        # ...
        # code for measurement, processing and storing data
        # ...
        prober.device.chuck.move_separation()  # move to separation height
        coordinates = prober.device.wafermap.step_next_die()  # move to the next die in the wafermap
```

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

prober = Velox("GPIB0::28::INSTR")  # replace the resource to your needs
recorder = attach(prober, "prober", [NominalCorePublisher(dataset_rid="<dataset rid>")])
coordinates = prober.wafermap.step_first_die()  # move to the first die in the wafermap
while not self.wafermap.end_reached:
    prober.chuck.move_contact()  # move to contact height
    # ...
    # code for measurement, processing and storing data
    # ...
    prober.chuck.move_separation()  # move to separation height
    coordinates = prober.wafermap.step_next_die()  # move to the next die in the wafermap

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

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