qiskit.transpiler.PassManager¶

class PassManager(passes=None, max_iteration=1000, callback=None)[código fonte]¶

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

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

Parâmetros

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.
callback (Optional[Callable]) – DEPRECATED - A callback function that will be called after each pass execution.

Obsoleto desde a versão 0.13.0: The callback parameter is deprecated in favor of PassManager.run(..., callback=callback, ...).

__init__(passes=None, max_iteration=1000, callback=None)[código fonte]¶

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

Parâmetros

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.
callback (Optional[Callable]) – DEPRECATED - A callback function that will be called after each pass execution.

Obsoleto desde a versão 0.13.0: The callback parameter is deprecated in favor of PassManager.run(..., callback=callback, ...).

Methods

`__init__`([passes, max_iteration, callback])	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)[código fonte]¶

Append a Pass Set to the schedule of passes.

Parâmetros

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.
max_iteration (Optional[int]) – max number of iterations of passes.
flow_controller_conditions (Any) – control flow plugins.

Levanta

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

Ver também

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

Tipo de retorno: None

draw(filename=None, style=None, raw=False)[código fonte]¶

Draw the pass manager.

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

Parâmetros

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.

Retorna

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

Tipo de retorno

Optional[PassManager]

Levanta

ImportError – when nxpd or pydot not installed.

passes()[código fonte]¶

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

Tipo de retorno: List[Dict[str, BasePass]]
Retorna: A list of pass sets, as defined in append().

remove(index)[código fonte]¶

Removes a particular pass in the scheduler.

Parâmetros: index (int) – Pass index to replace, based on the position in passes().
Levanta: TranspilerError – if the index is not found.
Tipo de retorno: None

replace(index, passes, max_iteration=None, **flow_controller_conditions)[código fonte]¶

Replace a particular pass in the scheduler.

Parâmetros

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.

Levanta

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

Ver também

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

Tipo de retorno: None

run(circuits, output_name=None, callback=None)[código fonte]¶

Run all the passes on the specified circuits.

Parâmetros

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']
    ...
```

Tipo de retorno

Union[QuantumCircuit, List[QuantumCircuit]]

Retorna

The transformed circuit(s).