# qiskit.pulse.InstructionScheduleMap¶

class InstructionScheduleMap[código fonte]

Mapping from QuantumCircuit qiskit.circuit.Instruction names and qubits to Schedule s. In particular, the mapping is formatted as type:

Dict[str, Dict[Tuple[int], Schedule]]


where the first key is the name of a circuit instruction (e.g. 'u1', 'measure'), the second key is a tuple of qubit indices, and the final value is a Schedule implementing the requested instruction.

These can usually be seen as gate calibrations.

Initialize a circuit instruction to schedule mapper instance.

__init__()[código fonte]

Initialize a circuit instruction to schedule mapper instance.

Methods

 Initialize a circuit instruction to schedule mapper instance. add(instruction, qubits, schedule[, arguments]) Add a new known instruction for the given qubits and its mapping to a pulse schedule. assert_has(instruction, qubits) Error if the given instruction is not defined. get(instruction, qubits, *params, **kwparams) Return the defined Schedule for the given instruction on the given qubits. get_parameters(instruction, qubits) Return the list of parameters taken by the given instruction on the given qubits. has(instruction, qubits) Is the instruction defined for the given qubits? pop(instruction, qubits, *params, **kwparams) Remove and return the defined Schedule for the given instruction on the given qubits. qubit_instructions(qubits) Return a list of the instruction names that are defined by the backend for the given qubit or qubits. qubits_with_instruction(instruction) Return a list of the qubits for which the given instruction is defined. remove(instruction, qubits) Remove the given instruction from the listing of instructions defined in self.

Attributes

 instructions Return all instructions which have definitions.
add(instruction, qubits, schedule, arguments=None)[código fonte]

Add a new known instruction for the given qubits and its mapping to a pulse schedule.

Parâmetros
• instruction (Union[str, Instruction]) – The name of the instruction to add.

• qubits (Union[int, Iterable[int]]) – The qubits which the instruction applies to.

• schedule (Union[Schedule, Callable[…, Schedule]]) – The Schedule that implements the given instruction.

• arguments (Optional[List[str]]) – List of parameter names to create a parameter-bound schedule from the associated gate instruction. If get() is called with arguments rather than keyword arguments, this parameter list is used to map the input arguments to parameter objects stored in the target schedule.

Levanta

PulseError – If the qubits are provided as an empty iterable.

Tipo de retorno

None

assert_has(instruction, qubits)[código fonte]

Error if the given instruction is not defined.

Parâmetros
• instruction (Union[str, Instruction]) – The instruction for which to look.

• qubits (Union[int, Iterable[int]]) – The specific qubits for the instruction.

Levanta

PulseError – If the instruction is not defined on the qubits.

Tipo de retorno

None

get(instruction, qubits, *params, **kwparams)[código fonte]

Return the defined Schedule for the given instruction on the given qubits.

If all keys are not specified this method returns schedule with unbound parameters.

Parâmetros
• instruction (Union[str, Instruction]) – Name of the instruction or the instruction itself.

• qubits (Union[int, Iterable[int]]) – The qubits for the instruction.

• *params – Command parameters for generating the output schedule.

• **kwparams – Keyworded command parameters for generating the schedule.

Tipo de retorno

Schedule

Retorna

The Schedule defined for the input.

Levanta

PulseError – When invalid parameters are specified.

get_parameters(instruction, qubits)[código fonte]

Return the list of parameters taken by the given instruction on the given qubits.

Parâmetros
• instruction (Union[str, Instruction]) – Name of the instruction.

• qubits (Union[int, Iterable[int]]) – The qubits for the instruction.

Tipo de retorno

Tuple[Union[str, ParameterExpression]]

Retorna

The names of the parameters required by the instruction.

has(instruction, qubits)[código fonte]

Is the instruction defined for the given qubits?

Parâmetros
• instruction (Union[str, Instruction]) – The instruction for which to look.

• qubits (Union[int, Iterable[int]]) – The specific qubits for the instruction.

Tipo de retorno

bool

Retorna

True iff the instruction is defined.

property instructions

Return all instructions which have definitions.

By default, these are typically the basis gates along with other instructions such as measure and reset.

Tipo de retorno

List[str]

Retorna

The names of all the circuit instructions which have Schedule definitions in this.

pop(instruction, qubits, *params, **kwparams)[código fonte]

Remove and return the defined Schedule for the given instruction on the given qubits.

Parâmetros
• instruction (Union[str, Instruction]) – Name of the instruction.

• qubits (Union[int, Iterable[int]]) – The qubits for the instruction.

• *params – Command parameters for generating the output schedule.

• **kwparams – Keyworded command parameters for generating the schedule.

Tipo de retorno

Schedule

Retorna

The Schedule defined for the input.

qubit_instructions(qubits)[código fonte]

Return a list of the instruction names that are defined by the backend for the given qubit or qubits.

Parâmetros

qubits (Union[int, Iterable[int]]) – A qubit index, or a list or tuple of indices.

Tipo de retorno

List[str]

Retorna

All the instructions which are defined on the qubits.

For 1 qubit, all the 1Q instructions defined. For multiple qubits, all the instructions which apply to that whole set of qubits (e.g. qubits=[0, 1] may return ['cx']).

qubits_with_instruction(instruction)[código fonte]

Return a list of the qubits for which the given instruction is defined. Single qubit instructions return a flat list, and multiqubit instructions return a list of ordered tuples.

Parâmetros

instruction (Union[str, Instruction]) – The name of the circuit instruction.

Tipo de retorno

List[Union[int, Tuple[int]]]

Retorna

Qubit indices which have the given instruction defined. This is a list of tuples if the instruction has an arity greater than 1, or a flat list of ints otherwise.

Levanta

remove(instruction, qubits)[código fonte]
• instruction (Union[str, Instruction]) – The name of the instruction to add.
• qubits (Union[int, Iterable[int]]) – The qubits which the instruction applies to.
None