238 lines
7.8 KiB
Plaintext
238 lines
7.8 KiB
Plaintext
---
|
||
title: Layout
|
||
description: API reference for qiskit.transpiler.Layout
|
||
in_page_toc_min_heading_level: 1
|
||
python_api_type: class
|
||
python_api_name: qiskit.transpiler.Layout
|
||
---
|
||
|
||
# Layout
|
||
|
||
<Class id="qiskit.transpiler.Layout" isDedicatedPage={true} github="https://github.com/qiskit/qiskit/tree/stable/0.45/qiskit/transpiler/layout.py" signature="qiskit.transpiler.Layout(input_dict=None)" modifiers="class">
|
||
Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
|
||
|
||
Two-ways dict to represent a Layout.
|
||
|
||
construct a Layout from a bijective dictionary, mapping virtual qubits to physical qubits
|
||
|
||
## Methods
|
||
|
||
### add
|
||
|
||
<Function id="qiskit.transpiler.Layout.add" signature="add(virtual_bit, physical_bit=None)">
|
||
Adds a map element between bit and physical\_bit. If physical\_bit is not defined, bit will be mapped to a new physical bit.
|
||
|
||
**Parameters**
|
||
|
||
* **virtual\_bit** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – A (qu)bit. For example, (QuantumRegister(3, ‘qr’), 2).
|
||
* **physical\_bit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – A physical bit. For example, 3.
|
||
</Function>
|
||
|
||
### add\_register
|
||
|
||
<Function id="qiskit.transpiler.Layout.add_register" signature="add_register(reg)">
|
||
Adds at the end physical\_qubits that map each bit in reg.
|
||
|
||
**Parameters**
|
||
|
||
**reg** ([*Register*](qiskit.circuit.Register "qiskit.circuit.Register")) – A (qu)bit Register. For example, QuantumRegister(3, ‘qr’).
|
||
</Function>
|
||
|
||
### combine\_into\_edge\_map
|
||
|
||
<Function id="qiskit.transpiler.Layout.combine_into_edge_map" signature="combine_into_edge_map(another_layout)">
|
||
Combines self and another\_layout into an “edge map”.
|
||
|
||
For example:
|
||
|
||
```python
|
||
self another_layout resulting edge map
|
||
qr_1 -> 0 0 <- q_2 qr_1 -> q_2
|
||
qr_2 -> 2 2 <- q_1 qr_2 -> q_1
|
||
qr_3 -> 3 3 <- q_0 qr_3 -> q_0
|
||
```
|
||
|
||
The edge map is used to compose dags via, for example, compose.
|
||
|
||
**Parameters**
|
||
|
||
**another\_layout** ([*Layout*](#qiskit.transpiler.Layout "qiskit.transpiler.Layout")) – The other layout to combine.
|
||
|
||
**Returns**
|
||
|
||
A “edge map”.
|
||
|
||
**Return type**
|
||
|
||
[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
|
||
|
||
**Raises**
|
||
|
||
[**LayoutError**](transpiler#qiskit.transpiler.LayoutError "qiskit.transpiler.LayoutError") – another\_layout can be bigger than self, but not smaller. Otherwise, raises.
|
||
</Function>
|
||
|
||
### copy
|
||
|
||
<Function id="qiskit.transpiler.Layout.copy" signature="copy()">
|
||
Returns a copy of a Layout instance.
|
||
</Function>
|
||
|
||
### from\_dict
|
||
|
||
<Function id="qiskit.transpiler.Layout.from_dict" signature="from_dict(input_dict)">
|
||
Populates a Layout from a dictionary.
|
||
|
||
The dictionary must be a bijective mapping between virtual qubits (tuple) and physical qubits (int).
|
||
|
||
**Parameters**
|
||
|
||
**input\_dict** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) –
|
||
|
||
e.g.:
|
||
|
||
```python
|
||
{(QuantumRegister(3, 'qr'), 0): 0,
|
||
(QuantumRegister(3, 'qr'), 1): 1,
|
||
(QuantumRegister(3, 'qr'), 2): 2}
|
||
|
||
Can be written more concisely as follows:
|
||
|
||
* virtual to physical::
|
||
|
||
{qr[0]: 0,
|
||
qr[1]: 1,
|
||
qr[2]: 2}
|
||
|
||
* physical to virtual::
|
||
|
||
{0: qr[0],
|
||
1: qr[1],
|
||
2: qr[2]}
|
||
```
|
||
</Function>
|
||
|
||
### from\_intlist
|
||
|
||
<Function id="qiskit.transpiler.Layout.from_intlist" signature="from_intlist(int_list, *qregs)" modifiers="static">
|
||
Converts a list of integers to a Layout mapping virtual qubits (index of the list) to physical qubits (the list values).
|
||
|
||
**Parameters**
|
||
|
||
* **int\_list** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of integers.
|
||
* **\*qregs** (*QuantumRegisters*) – The quantum registers to apply the layout to.
|
||
|
||
**Returns**
|
||
|
||
The corresponding Layout object.
|
||
|
||
**Return type**
|
||
|
||
[Layout](#qiskit.transpiler.Layout "qiskit.transpiler.Layout")
|
||
|
||
**Raises**
|
||
|
||
[**LayoutError**](transpiler#qiskit.transpiler.LayoutError "qiskit.transpiler.LayoutError") – Invalid input layout.
|
||
</Function>
|
||
|
||
### from\_qubit\_list
|
||
|
||
<Function id="qiskit.transpiler.Layout.from_qubit_list" signature="from_qubit_list(qubit_list, *qregs)" modifiers="static">
|
||
Populates a Layout from a list containing virtual qubits, Qubit or None.
|
||
|
||
**Parameters**
|
||
|
||
* **qubit\_list** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – e.g.: \[qr\[0], None, qr\[2], qr\[3]]
|
||
* **\*qregs** (*QuantumRegisters*) – The quantum registers to apply the layout to.
|
||
|
||
**Returns**
|
||
|
||
the corresponding Layout object
|
||
|
||
**Return type**
|
||
|
||
[Layout](#qiskit.transpiler.Layout "qiskit.transpiler.Layout")
|
||
|
||
**Raises**
|
||
|
||
[**LayoutError**](transpiler#qiskit.transpiler.LayoutError "qiskit.transpiler.LayoutError") – If the elements are not Qubit or None
|
||
</Function>
|
||
|
||
### generate\_trivial\_layout
|
||
|
||
<Function id="qiskit.transpiler.Layout.generate_trivial_layout" signature="generate_trivial_layout(*regs)" modifiers="static">
|
||
Creates a trivial (“one-to-one”) Layout with the registers and qubits in regs.
|
||
|
||
**Parameters**
|
||
|
||
**\*regs** (*Registers, Qubits*) – registers and qubits to include in the layout.
|
||
|
||
**Returns**
|
||
|
||
A layout with all the regs in the given order.
|
||
|
||
**Return type**
|
||
|
||
[Layout](#qiskit.transpiler.Layout "qiskit.transpiler.Layout")
|
||
</Function>
|
||
|
||
### get\_physical\_bits
|
||
|
||
<Function id="qiskit.transpiler.Layout.get_physical_bits" signature="get_physical_bits()">
|
||
Returns the dictionary where the keys are physical (qu)bits and the values are virtual (qu)bits.
|
||
</Function>
|
||
|
||
### get\_registers
|
||
|
||
<Function id="qiskit.transpiler.Layout.get_registers" signature="get_registers()">
|
||
Returns the registers in the layout \[QuantumRegister(2, ‘qr0’), QuantumRegister(3, ‘qr1’)] :returns: A set of Registers in the layout :rtype: Set
|
||
</Function>
|
||
|
||
### get\_virtual\_bits
|
||
|
||
<Function id="qiskit.transpiler.Layout.get_virtual_bits" signature="get_virtual_bits()">
|
||
Returns the dictionary where the keys are virtual (qu)bits and the values are physical (qu)bits.
|
||
</Function>
|
||
|
||
### order\_based\_on\_type
|
||
|
||
<Function id="qiskit.transpiler.Layout.order_based_on_type" signature="order_based_on_type(value1, value2)" modifiers="static">
|
||
decides which one is physical/virtual based on the type. Returns (virtual, physical)
|
||
</Function>
|
||
|
||
### reorder\_bits
|
||
|
||
<Function id="qiskit.transpiler.Layout.reorder_bits" signature="reorder_bits(bits)">
|
||
Given an ordered list of bits, reorder them according to this layout.
|
||
|
||
The list of bits must exactly match the virtual bits in this layout.
|
||
|
||
**Parameters**
|
||
|
||
**bits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Bit*](qiskit.circuit.Bit "qiskit.circuit.Bit")*]*) – the bits to reorder.
|
||
|
||
**Returns**
|
||
|
||
ordered bits.
|
||
|
||
**Return type**
|
||
|
||
List
|
||
</Function>
|
||
|
||
### swap
|
||
|
||
<Function id="qiskit.transpiler.Layout.swap" signature="swap(left, right)">
|
||
Swaps the map between left and right.
|
||
|
||
**Parameters**
|
||
|
||
* **left** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)") *or*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Item to swap with right.
|
||
* **right** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)") *or*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Item to swap with left.
|
||
|
||
**Raises**
|
||
|
||
[**LayoutError**](transpiler#qiskit.transpiler.LayoutError "qiskit.transpiler.LayoutError") – If left and right have not the same type.
|
||
</Function>
|
||
</Class>
|
||
|