46 lines
2.0 KiB
Plaintext
46 lines
2.0 KiB
Plaintext
---
|
||
title: acquire
|
||
description: API reference for qiskit.pulse.builder.acquire
|
||
in_page_toc_min_heading_level: 1
|
||
python_api_type: function
|
||
python_api_name: qiskit.pulse.builder.acquire
|
||
---
|
||
|
||
# qiskit.pulse.builder.acquire
|
||
|
||
<Function id="qiskit.pulse.builder.acquire" isDedicatedPage={true} github="https://github.com/qiskit/qiskit/tree/stable/0.22/qiskit/pulse/builder.py" signature="acquire(duration, qubit_or_channel, register, **metadata)">
|
||
Acquire for a `duration` on a `channel` and store the result in a `register`.
|
||
|
||
Examples:
|
||
|
||
```python
|
||
from qiskit import pulse
|
||
|
||
acq0 = pulse.AcquireChannel(0)
|
||
mem0 = pulse.MemorySlot(0)
|
||
|
||
with pulse.build() as pulse_prog:
|
||
pulse.acquire(100, acq0, mem0)
|
||
|
||
# measurement metadata
|
||
kernel = pulse.configuration.Kernel('linear_discriminator')
|
||
pulse.acquire(100, acq0, mem0, kernel=kernel)
|
||
```
|
||
|
||
<Admonition title="Note" type="note">
|
||
The type of data acquire will depend on the execution `meas_level`.
|
||
</Admonition>
|
||
|
||
**Parameters**
|
||
|
||
* **duration** (`int`) – Duration to acquire data for
|
||
* **qubit\_or\_channel** (`Union`\[`int`, [`AcquireChannel`](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")]) – Either the qubit to acquire data for or the specific [`AcquireChannel`](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel") to acquire on.
|
||
* **register** (`NewType()`(`StorageLocation`, `Union`\[[`MemorySlot`](qiskit.pulse.channels.MemorySlot "qiskit.pulse.channels.MemorySlot"), [`RegisterSlot`](qiskit.pulse.channels.RegisterSlot "qiskit.pulse.channels.RegisterSlot")])) – Location to store measured result.
|
||
* **metadata** (`Union`\[`Kernel`, `Discriminator`]) – Additional metadata for measurement. See [`Acquire`](qiskit.pulse.instructions.Acquire "qiskit.pulse.instructions.Acquire") for more information.
|
||
|
||
**Raises**
|
||
|
||
[**exceptions.PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.exceptions.PulseError") – If the register type is not supported.
|
||
</Function>
|
||
|