---
title: QasmQobjInstruction (v0.46)
description: API reference for qiskit.qobj.QasmQobjInstruction in qiskit v0.46
source: https://eu-de.quantum.cloud.ibm.com/docs/en/api/qiskit/0.46/qiskit.qobj.QasmQobjInstruction
---

# QasmQobjInstruction

*class* `qiskit.qobj.QasmQobjInstruction(name, params=None, qubits=None, register=None, memory=None, condition=None, conditional=None, label=None, mask=None, relation=None, val=None, snapshot_type=None)`

[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qobj/qasm_qobj.py)

Bases: [`object`](https://docs.python.org/3/library/functions.html#object)

A class representing a single instruction in an QasmQobj Experiment.

Instantiate a new QasmQobjInstruction object.

**Parameters**

- **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str)) – The name of the instruction
- **params** ([*list*](https://docs.python.org/3/library/stdtypes.html#list)) – The list of parameters for the gate
- **qubits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list)) – A list of `int` representing the qubits the instruction operates on
- **register** ([*list*](https://docs.python.org/3/library/stdtypes.html#list)) – If a `measure` instruction this is a list of `int` containing the list of register slots in which to store the measurement results (must be the same length as qubits). If a `bfunc` instruction this is a single `int` of the register slot in which to store the result.
- **memory** ([*list*](https://docs.python.org/3/library/stdtypes.html#list)) – If a `measure` instruction this is a list of `int` containing the list of memory slots to store the measurement results in (must be the same length as qubits). If a `bfunc` instruction this is a single `int` of the memory slot to store the boolean function result in.
- **condition** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple)) – A tuple of the form `(int, int)` where the first `int` is the control register and the second `int` is the control value if the gate has a condition.
- **conditional** ([*int*](https://docs.python.org/3/library/functions.html#int)) – The register index of the condition
- **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str)) – An optional label assigned to the instruction
- **mask** ([*int*](https://docs.python.org/3/library/functions.html#int)) – For a `bfunc` instruction the hex value which is applied as an `AND` to the register bits.
- **relation** ([*str*](https://docs.python.org/3/library/stdtypes.html#str)) – Relational operator for comparing the masked register to the `val` kwarg. Can be either `==` (equals) or `!=` (not equals).
- **val** ([*int*](https://docs.python.org/3/library/functions.html#int)) – Value to which to compare the masked register. In other words, the output of the function is `(register AND mask)`
- **snapshot\_type** ([*str*](https://docs.python.org/3/library/stdtypes.html#str)) – For snapshot instructions the type of snapshot to use

## Methods

### from\_dict

*classmethod* `from_dict(data)`

Create a new QasmQobjInstruction object from a dictionary.

**Parameters**

**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict)) – A dictionary for the experiment config

**Returns**

The object from the input dictionary.

**Return type**

[QasmQobjInstruction](#qiskit.qobj.QasmQobjInstruction "qiskit.qobj.QasmQobjInstruction")

### to\_dict

`to_dict()`

Return a dictionary format representation of the Instruction.

**Returns**

The dictionary form of the QasmQobjInstruction.

**Return type**

[dict](https://docs.python.org/3/library/stdtypes.html#dict)
