Destino

Devolución dt.

Obtener la lista de tuplas (Instruction(qargs)) para el objetivo

Para las operaciones de anchura variable definidas globalmente, la tupla tendrá la forma (class, None) , donde clase es la clase de operación real definida globalmente.

Obtiene los nombres de las operaciones en el objetivo.

Obtener los objetos de operación en el objetivo.

Devuelve una lista ordenada de qubits físicos.

El conjunto de qargs en el objetivo.

add_instruction(instruction, properties=None, name=None, *, angle_bounds=None)

Añade una nueva instrucción al Target

Dado que los objetos de Target son estrictamente aditivos, éste es el principal método para modificar un Target. Por lo general, se utiliza para rellenar completamente un Target antes de utilizarlo en la aplicación BackendV2. Por ejemplo:

from qiskit.circuit.library import CXGate
from qiskit.transpiler import Target, InstructionProperties

target = Target()
cx_properties = {
    (0, 1): None,
    (1, 0): None,
    (0, 2): None,
    (2, 0): None,
    (0, 3): None,
    (2, 3): None,
    (3, 0): None,
    (3, 2): None
}
target.add_instruction(CXGate(), cx_properties)

Añadirá un CXGate al objetivo sin propiedades (duración, error, etc) con la lista de bordes de acoplamiento: (0, 1), (1, 0), (0, 2), (2, 0), (0, 3), (2, 3), (3, 0), (3, 2). Si hay propiedades disponibles para la instrucción puede sustituir el valor None en el diccionario de propiedades por un InstructionProperties objeto. Este patrón se repite para cada Instruction los soportes de destino.

Parámetros

• instruction (Union[qiskit.circuit.Instruction, Type[qiskit.circuit.Instruction]]) – El objeto de operación que se va a añadir al mapa. Si está parametrizado, se puede establecer cualquier valor para el parámetro. Opcionalmente, para las instrucciones de ancho variable (como las operaciones de flujo de control, por ejemplo, ForLoop o MCXGate), puedes especificar la clase. Si se especifica la clase, también debe especificarse el name argumento. Cuando se utiliza una clase, la puerta se considera global y no tiene ninguna propiedad definida.
• properties (dict) – Un diccionario de entradas qarg a un InstructionProperties para esa implementación de instrucción en el backend. Las propiedades son opcionales para cualquier implementación de instrucciones, si no hay InstructionProperties disponibles para el backend el valor puede ser Ninguno. Si no hay restricciones en la instrucción (como en una simulación sin ruido/ideal) se puede establecer en {None, None} , lo que indicará que se ejecuta en todos los qubits (o en todas las permutaciones disponibles de qubits para puertas multi-qubit). El primer None indica que se aplica a todos los qubits y el segundo None indica que no hay InstructionProperties para la instrucción. Por defecto, si no se establece properties equivale a pasar {None: None}.
• name (str) – Un nombre opcional para identificar la instrucción. Si no se especifica, se utilizará el atributo name de gate . Todas las puertas de Target necesitan nombres únicos. Los backends pueden diferenciar entre distintas parametrizaciones de una misma puerta proporcionando un nombre único para cada una (por ejemplo, “rx30”, “rx60”, `”rx90”`` similar al ejemplo de la documentación de la clase Target ).
• angle_bounds (list) – Los límites de los parámetros para una puerta determinada. Se especifica mediante una lista de tuplas (low, high) que representan el límite inferior y superior (inclusive) de los valores de flotación permitidos para el parámetro en esa posición. Si un parámetro no tiene un ángulo límite, puedes utilizar None para representarlo. Por ejemplo, si una puerta de 3 parámetros sólo tuviera un límite en el segundo parámetro, se representaría con: [None, [0, 3.14], None] , lo que significa que el primer y el tercer parámetro admiten cualquier valor, pero el segundo parámetro sólo acepta valores entre 0 y 3.14.

Eleva

• AttributeError - Si la puerta ya está en el mapa
• TranspilerError - Si se pasa una clase de operación para instruction y no se especifica un nombre o se establece properties .

build_coupling_map(two_q_gate=None, filter_idle_qubits=False)

Obtener un CouplingMap de este objetivo.

Si hay una combinación de operaciones de dos qubits que tienen una restricción de conectividad y otras que están definidas globalmente, esto también dará como resultado, None ya que la conectividad global implica que no hay ninguna restricción sobre el objetivo. Si deseas ver las restricciones de las operaciones de dos qubits que tienen restricciones, debes utilizar el two_q_gate argumento para limitar la salida a las puertas que tienen una restricción.

Parámetros

• two_q_gate (str) – Nombre opcional de una puerta de dos qubits en Target para generar el mapa de acoplamiento. Si se especifica, el mapa de acoplamiento de salida sólo tendrá bordes entre qubits en los que esté presente esta puerta.
• filter_idle_qubits (bool) – Si se establece en True la salida CouplingMap eliminará los qubits que no tengan ninguna operación definida en el objetivo. Tenga en cuenta que el uso de este argumento dará lugar a un objeto de salida CouplingMap que tiene agujeros en sus índices que pueden diferir de los supuestos de la clase. El caso típico de uso de este argumento es emparejarlo con CouplingMap.connected_components() que se encargará de los agujeros como se espera.

Devuelve

**El objeto CouplingMap **

para este objetivo. Si no hay restricciones de conectividad en el objetivo, devolverá None.

Tipo de retorno

CouplingMap

Eleva

• ValueError - Si se pasa una puerta que no sea de dos qubits para two_q_gate.
• IndexError - Si se pasa una instrucción que no está en Target para two_q_gate.

durations()

Obtener un objeto InstructionDurations del destino

Devuelve

La duración de la instrucción representada en el

destino

Tipo de retorno

InstructionDurations

classmethod from_configuration(basis_gates, num_qubits=None, coupling_map=None, instruction_durations=None, concurrent_measurements=None, dt=None, timing_constraints=None, custom_name_mapping=None)

Crear un objeto de destino a partir de la configuración global individual

Antes de la creación de la clase Target las restricciones de un backend se representaban mediante una colección de objetos diferentes que, combinados, representaban un subconjunto de la información contenida en la clase Target. Esta función proporciona una interfaz sencilla para convertir esos objetos separados en un objeto Target.

Este constructor utilizará las entradas de basis_gates, num_qubits, y coupling_map para construir un modelo base del backend y las entradas instruction_durations, backend_properties, y inst_map son entonces consultadas (en ese orden) basadas en ese modelo para buscar las propiedades de cada instrucción y qubit. Si existe una incoherencia entre las entradas, se ignorará cualquier información adicional o contradictoria presente en instruction_durations, backend_properties, o inst_map .

Parámetros

• basis_gates (list[str]) – La lista de nombres de puertas base para el backend. Para que se cree el objetivo, estos nombres deben estar en la salida de get_standard_gate_name_mapping() o estar presentes en el argumento custom_name_mapping especificado.
• num_qubits (int | None) – El número de qubits soportados en el backend.
• coupling_map (CouplingMap | None) – El mapa de acoplamiento que representa las restricciones de conectividad en el backend. Si se especifica, todas las puertas de basis_gates serán compatibles con todos los qubits (o pares de qubits).
• instruction_durations (InstructionDurations | None) – Duraciones opcionales de las instrucciones. Si se especifica tendrá prioridad para establecer el campo duration en los InstructionProperties para las instrucciones del objetivo.
• concurrent_measurements (list) – Una lista de conjuntos de qubits que deben medirse juntos. Debe proporcionarse como una lista anidada como [[0, 1], [2, 3, 4]].
• dt (float | None) – La resolución temporal del sistema de las señales de entrada en segundos
• timing_constraints (TimingConstraints | None) – Restricciones temporales opcionales que se pueden incluir en el Target
• custom_name_mapping (dict[str, Any] | None) – Un diccionario opcional que asigna nombres personalizados de puertas/operaciones en basis_gates a un Operation objeto que representa esa puerta/operación. Por defecto, la mayoría de los nombres de puertas estándar se asignan al objeto de puerta estándar de qiskit.circuit.library esto solo es necesario especificarlo si la entrada basis_gates define puertas con nombres fuera de ese conjunto.

Devuelve

el objetivo construido a partir de la configuración de entrada

Tipo de retorno

Destino

Eleva

• TranspilerError - Si las puertas base de entrada contienen > 2 qubits y coupling_map es
• especificado. -
• KeyError - Si no hay ninguna asignación disponible para una dirección basis_gate.

gate_has_angle_bounds(name)

Comprobar si una puerta específica tiene un ángulo límite establecido

Parámetros

name (str) – El nombre de la instrucción para comprobar si tiene un ángulo definido

Devuelve

Esto devolverá True si la puerta está en el objetivo y tiene límites de ángulo definidos. Devolverá False si la puerta no tiene límites de ángulo definidos o no está en el objetivo.

Tipo de retorno

bool

get(key, default=None)

Obtiene un ítem del Target. Si no se encuentra, devuelve un valor predeterminado o Ninguno.

get_non_global_operation_names(strict_direction=False)

Devuelve los nombres de operaciones no globales del objetivo

Las operaciones no globales son aquellas del objetivo que no se aplican en todos los qubits (para operaciones de un solo qubit) o en todos los qargs de varios qubits (para operaciones de varios qubits).

Parámetros

strict_direction (bool) – Si se establece en True las operaciones multiqubit consideradas como no globales respetan la dirección estricta (o el orden de los qubits en los qargs es significativo). Por ejemplo, si cx se define sobre (0, 1) y ecr se define sobre (1, 0) por defecto ninguno de los dos se consideraría no global, pero si strict_direction se define True se devolverían tanto cx como ecr .

Devuelve

Una lista de nombres de operaciones para operaciones que no son globales en este objetivo

Tipo de retorno

Lista [str ]

has_angle_bounds()

Comprueba si hay algún límite de ángulo establecido en el objetivo

Devuelve

Esto devolverá True si hay límites angulares establecidos en alguna instrucción del circuito

Tipo de retorno

bool

instruction_properties(index)

Obtener las propiedades de instrucción de una tupla de instrucciones específica

Este método debe utilizarse junto con el atributo instructions de un objeto Target objeto. Puede utilizar este método para obtener rápidamente las propiedades de instrucción de un elemento de instructions utilizando el índice de esa lista. Sin embargo, si no está trabajando con instructions es probablemente más eficiente acceder al objetivo directamente a través del nombre y los qubits para obtener las propiedades de la instrucción. Por ejemplo, si instructions se devuelve:

[(XGate(), (0,)), (XGate(), (1,))]

podrías obtener las propiedades del XGate en el qubit 1 con:

props = target.instruction_properties(1)

pero acceder directamente a través del nombre sería más eficiente:

props = target['x'][(1,)]

(asumiendo que el nombre canónico de XGateen el objetivo es 'x') Esto es especialmente cierto para objetivos más grandes, ya que esto empeorará con el número de tuplas de instrucciones en un objetivo.

Parámetros

index (int) – El índice de la tupla de instrucciones del atributo instructions atributo. Por ejemplo, si desea las propiedades del tercer elemento de instructions sería 2.

Devuelve

Las propiedades de la instrucción para la tupla de instrucciones especificada

Tipo de retorno

InstructionProperties

instruction_supported(operation_name=None, qargs=Ellipsis, operation_class=None, parameters=None, check_angle_bounds=True)

Devuelve si la instrucción (operación + qubits) es compatible con el objetivo

Parámetros

• operation_name (str) – El nombre de la operación para la instrucción. Debe especificarse éste o operation_class , si se especifican ambos operation_class tendrá prioridad y este argumento será ignorado.

• qargs (tuple) – La tupla de índices de qubits para la instrucción. Si no se especifica, este método devolverá True si la operación especificada es compatible con cualquier qubits. La aplicación típica siempre tendrá esto configurado (de lo contrario es lo mismo que simplemente comprobar si el objetivo contiene la operación). Normalmente no se establecería este argumento si se quisiera comprobar de forma más general que el objetivo admite una operación con el parameters en cualquiera de los qubits.

• operation_class (Type[qiskit.circuit.Instruction]) – La clase de operación para comprobar si el objetivo admite una operación determinada por clase en lugar de por nombre. Esta búsqueda es más costosa ya que necesita iterar sobre todas las operaciones en el objetivo en lugar de una sola búsqueda. Si se especifica, sustituirá al argumento operation_name . El caso de uso típico de esta operación es comprobar si una variante específica de una operación está soportada en el backend. Por ejemplo, si se quisiera comprobar si un RXGate en un qubit específico con un ángulo fijo. Esa variante de ángulo fijo tendrá normalmente un nombre diferente del atributo name del objeto ("rx") en el destino. Se puede utilizar para comprobar si hay alguna instancia de la clase disponible en ese caso.

• parameters (list) –

  Una lista de parámetros para comprobar si el objetivo los admite en los qubits especificados. Si la instrucción admite los valores de los parámetros especificados en la lista en la operación y qargs especificados devolverá True pero si los parámetros no son compatibles con la instrucción especificada devolverá False. Si no se especifica este argumento, este método devolverá True si la instrucción es compatible independientemente de los parámetros de la instrucción. Si se especifica con cualquier objeto Parameter de la lista, esa entrada se tratará como si admitiera cualquier valor, sin embargo no se comprobarán los nombres de los parámetros (por ejemplo, si una operación del objetivo aparece como parametrizada con "theta" y se pasa "phi" a esta función, que devolverá True). Por ejemplo, si se llama con:

  parameters = [Parameter("theta")]
  target.instruction_supported("rx", (0,), parameters=parameters)

  devolverá True si se admite un RXGate en el qubit 0 que aceptará cualquier parámetro. Si necesita comprobar un parámetro de valor numérico fijo, este argumento suele ir emparejado con el argumento operation_class . Por ejemplo:

  target.instruction_supported("rx", (0,), RXGate, parameters=[pi / 4])

  devolverá True si existe una RXGate( pi/4 ) en el qubit 0.

• check_angle_bounds (bool) – Si se establece en True (por defecto) el valor de parameters será validado contra cualquier límite de ángulo establecido en el objetivo. Si alguno de los valores en parameters se establece como ParameterExpression este indicador no tendrá ningún efecto, ya que los límites angulares sólo afectan a las operaciones no parametrizadas del circuito.

Devuelve

Devuelve True si la instrucción es compatible y False si no lo es.

Tipo de retorno

bool

items()

Devuelve pares de nombres de Puerta y su mapa de propiedades (str, dicttuple[, InstructionProperties] )

keys()

Devuelve las claves (nombres_de_operación) del Destino

operation_from_name(instruction)

Obtener el objeto de clase de operación para un nombre dado

Parámetros

instruction (str) – El nombre de la instrucción para obtener la Instruction instancia para

Devuelve

La instancia de Instrucción correspondiente al nombre. También puede ser la clase para variables definidas globalmente con operaciones.

Tipo de retorno

qiskit.circuit.Instruction

operation_names_for_qargs(qargs, /)

Obtiene los nombres de las operaciones de una tupla qargs especificada

Parámetros

qargs (tuple) – Una tupla qargs de los qubits para obtener las puertas que se le aplican. Por ejemplo, (0,) devolverá el conjunto de todas las instrucciones que se aplican al qubit 0. Si se establece en None devolverá los nombres de cualquier operación definida globalmente en el objetivo.

Devuelve

El conjunto de nombres de operaciones que se aplican a la dirección qargs especificada.

Tipo de retorno

set

Eleva

KeyError - Si qargs no está en el objetivo

operations_for_qargs(qargs, /)

Obtener el objeto de clase de operación para una tupla qargs especificada

Parámetros

qargs (tuple) – Una tupla qargs de los qubits para obtener las puertas que se le aplican. Por ejemplo, (0,) devolverá el conjunto de todas las instrucciones que se aplican al qubit 0. Si se establece en None devolverá cualquier operación definida globalmente en el objetivo.

Devuelve

La lista de Instruction instancias que se aplican al qarg especificado. También puede ser una clase si se define globalmente una operación de anchura variable.

Tipo de retorno

list de

Eleva

KeyError - Si qargs no está en target

qargs_for_operation_name(operation)

Obtener los qargs para un nombre de operación dado

Parámetros

operation (str) – El nombre de la operación de la que se obtendrán los qargs

Devuelve

Conjunto de qargs a los que se aplica la instancia de puerta.

Tipo de retorno

set

seconds_to_dt(duration)

Convierte una duración dada en segundos a unidades de dt

Parámetros

duration (float) – La duración en segundos, como en un InstructionProperties campo para una instrucción en el objetivo.

Tipo de retorno

int

Devuelve

duración: La duración en unidades de dt

supported_angle_bound(name, angles)

Comprobar que los parámetros de una puerta específica se ajustan a los límites angulares

Parámetros

• name (str) – El nombre de la instrucción para comprobar los límites angulares de
• angles (list) – Una lista de valores de parámetros float para name para ver si se ajustan a los límites de ángulo definidos.

Devuelve

Devuelve True si los valores de los parámetros especificados son compatibles con los límites angulares. False si alguno de los parámetros está fuera de los límites definidos.

Tipo de retorno

bool

Eleva

• TranspilerError - Si name no se encuentra en el objetivo o no
• tienen límites angulares definidos. -

timing_constraints()

Obtener un objeto TimingConstraints del destino

Devuelve

Las restricciones temporales representadas en el Target

Tipo de retorno

TimingConstraints

update_instruction_properties(instruction, qargs, properties)

Actualiza el objeto de propiedad para un par de instrucciones qarg que ya está en el Target.

Para facilitar el acceso, un usuario puede obtener la correspondencia entre los qargs aplicables de una instrucción y sus propiedades de instrucción a través del protocolo de correspondencia (utilizando __getitem__), con el nombre de la instrucción como clave. Este método es la única forma de modificar/actualizar las propiedades de una instrucción en Target. No se admite el uso del protocolo de asignación para modificaciones.

Parámetros

• instruction (str) – El nombre de la instrucción a actualizar
• qargs (tuple) – Los qargs para actualizar las propiedades de
• properties (InstructionProperties) – Las propiedades a establecer para esta instrucción

Eleva

KeyError - Si instruction o qarg no están en el destino

values()

Devuelve el mapa de propiedades (qargs -> InstructionProperties ) de cada instrucción del objetivo