48 lines
1.8 KiB
Plaintext
48 lines
1.8 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
|
||
---
|
||
|
||
<span id="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.24/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** (*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** (*StorageLocation*) – Location to store measured result.
|
||
* **metadata** (*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>
|
||
|