qiskit.transpiler.PassManager¶

class PassManager(passes=None, max_iteration=1000)[source]¶

Manager for a set of Passes and their scheduling during transpilation.

Initialize an empty PassManager object (with no passes scheduled).

Paramètres

passes (Union[BasePass, List[BasePass], None]) – A pass set (as defined in qiskit.transpiler.PassManager.append()) to be added to the pass manager schedule.
max_iteration (int) – The maximum number of iterations the schedule will be looped if the condition is not met.

__init__(passes=None, max_iteration=1000)[source]¶

Initialize an empty PassManager object (with no passes scheduled).

Paramètres

passes (Union[BasePass, List[BasePass], None]) – A pass set (as defined in qiskit.transpiler.PassManager.append()) to be added to the pass manager schedule.
max_iteration (int) – The maximum number of iterations the schedule will be looped if the condition is not met.

Methods

`__init__`([passes, max_iteration])	Initialize an empty PassManager object (with no passes scheduled).
`append`(passes[, max_iteration])	Append a Pass Set to the schedule of passes.
`draw`([filename, style, raw])	Draw the pass manager.
`passes`()	Return a list structure of the appended passes and its options.
`remove`(index)	Removes a particular pass in the scheduler.
`replace`(index, passes[, max_iteration])	Replace a particular pass in the scheduler.
`run`(circuits[, output_name, callback])	Run all the passes on the specified `circuits`.

append(passes, max_iteration=None, **flow_controller_conditions)[source]¶

Append a Pass Set to the schedule of passes.

Paramètres

passes (Union[BasePass, List[BasePass]]) – A set of passes (a pass set) to be added to schedule. A pass set is a list of passes that are controlled by the same flow controller. If a single pass is provided, the pass set will only have that pass a single element. It is also possible to append a FlowController instance and the rest of the parameter will be ignored.
max_iteration (Optional[int]) – max number of iterations of passes.
flow_controller_conditions (Any) – control flow plugins.

Lève

TranspilerError – if a pass in passes is not a proper pass.

Voir aussi

RunningPassManager.add_flow_controller() for more information about the control flow plugins.

Type renvoyé: None

draw(filename=None, style=None, raw=False)[source]¶

Draw the pass manager.

This function needs pydot, which in turn needs Graphviz to be installed.

Paramètres

filename (str) – file path to save image to.
style (dict) – keys are the pass classes and the values are the colors to make them. An example can be seen in the DEFAULT_STYLE. An ordered dict can be used to ensure a priority coloring when pass falls into multiple categories. Any values not included in the provided dict will be filled in from the default dict.
raw (bool) – If True, save the raw Dot output instead of the image.

Renvoie

an in-memory representation of the pass manager, or None if no image was generated or Pillow is not installed.

Type renvoyé

Optional[PassManager]

Lève

ImportError – when nxpd or pydot not installed.

passes()[source]¶

Return a list structure of the appended passes and its options.

Type renvoyé: List[Dict[str, BasePass]]
Renvoie: A list of pass sets, as defined in append().

remove(index)[source]¶

Removes a particular pass in the scheduler.

Paramètres: index (int) – Pass index to replace, based on the position in passes().
Lève: TranspilerError – if the index is not found.
Type renvoyé: None

replace(index, passes, max_iteration=None, **flow_controller_conditions)[source]¶

Replace a particular pass in the scheduler.

Paramètres

index (int) – Pass index to replace, based on the position in passes().
passes (Union[BasePass, List[BasePass]]) – A pass set (as defined in qiskit.transpiler.PassManager.append()) to be added to the pass manager schedule.
max_iteration (Optional[int]) – max number of iterations of passes.
flow_controller_conditions (Any) – control flow plugins.

Lève

TranspilerError – if a pass in passes is not a proper pass or index not found.

Voir aussi

RunningPassManager.add_flow_controller() for more information about the control flow plugins.

Type renvoyé: None

run(circuits, output_name=None, callback=None)[source]¶

Run all the passes on the specified circuits.

Paramètres

circuits (Union[QuantumCircuit, List[QuantumCircuit]]) – Circuit(s) to transform via all the registered passes.
output_name (Optional[str]) – The output circuit name. If None, it will be set to the same as the input circuit name.
callback (Optional[Callable]) –
A callback function that will be called after each pass execution. The function will be called with 5 keyword arguments:
```
pass_ (Pass): the pass being run
dag (DAGCircuit): the dag output of the pass
time (float): the time to execute the pass
property_set (PropertySet): the property set
count (int): the index for the pass execution
```
The exact arguments pass expose the internals of the pass manager and are subject to change as the pass manager internals change. If you intend to reuse a callback function over multiple releases be sure to check that the arguments being passed are the same.

To use the callback feature you define a function that will take in kwargs dict and access the variables. For example:
```
def callback_func(**kwargs):
    pass_ = kwargs['pass_']
    dag = kwargs['dag']
    time = kwargs['time']
    property_set = kwargs['property_set']
    count = kwargs['count']
    ...
```

Type renvoyé

Union[QuantumCircuit, List[QuantumCircuit]]

Renvoie

The transformed circuit(s).