QkTranspiler

QkTranspileOptions qk_transpiler_default_options(void)

Générer les options par défaut du transpileur

Cette fonction génère un QkTranspileOptions avec les paramètres par défaut. Il s'agit actuellement de optimization_level 2, pas de graine et pas d'approximation.

Retours

Un QkTranspileOptions objet avec les paramètres par défaut.

QkExitCode qk_transpile_stage_init(QkDag *dag, const QkTarget *target, const QkTranspileOptions *options, QkTranspilerStageState **state, char **error)

Exécutez la phase d'initialisation prédéfinie du transcompilateur sur un circuit

Le transcompilateur Qiskit est un compilateur de circuits quantiques qui réécrit un circuit d'entrée donné afin de l'adapter aux contraintes d'un QPU et optimise le circuit pour son exécution. Cette fonction exécute la première étape du transcompilateur, init, qui effectue des optimisations de circuits abstraits et réduit les opérations multi-qubits en opérations à un ou deux qubits. Pour plus d'informations, veuillez vous référer à la section Étape d'initialisation.

Cette fonction ne doit être utilisée qu'avec des circuits construits à l'aide de l'API C de Qiskit. Il fait des suppositions sur le circuit en utilisant uniquement les fonctionnalités exposées via C. Si vous êtes dans un environnement mixte Python et C, il est généralement préférable d'invoquer le transcompilateur via Python.

Cette fonction est multithread en interne et lancera un pool de threads avec un nombre de threads égal au nombre d'unités centrales indiqué par le système d'exploitation par défaut. Il s'agit notamment des cœurs logiques sur les unités centrales avec multithreading simultané. Vous pouvez régler le nombre de threads à l'aide de la variable d'environnement RAYON_NUM_THREADS . Par exemple, le paramètre RAYON_NUM_THREADS=4 limiterait le pool de threads à 4 threads.

Sécurité

Le comportement est indéfini si dag, target, ou ne state sont pas respectivement des pointeurs valides et non nuls vers un QkDag, QkTarget, ou un QkTranspileLayout pointeur. options doit être un pointeur valide vers a, a QkTranspileOptions ou NULL. error doit être un pointeur valide vers un char pointeur ou NULL. La valeur du pointeur interne de state sera écrasée par cette fonction. Si la valeur pointée doit être libérée, cela doit être fait en dehors de cette fonction, car celle-ci ne la libérera pas.

Paramètres

• dag – Pointeur vers le circuit sur lequel exécuter le transcompilateur.
• target - Pointeur vers la cible pour laquelle le circuit doit être compilé.
• options - Un pointeur sur un objet d'options qui définit les options de l'utilisateur. S'il s'agit d'un pointeur nul, les valeurs par défaut seront utilisées. Voir qk_transpile_default_options pour plus de détails sur les valeurs par défaut.
• état – Un pointeur vers un pointeur vers un QkTranspilerStageState objet. En cas de réussite (code de retour 0), un pointeur vers l'objet d'état créé par le transpileur sera enregistré à cette adresse.
• erreur – Pointeur vers un pointeur contenant une chaîne terminée par un caractère nul avec une description de l'erreur. Si le transcompilateur échoue, un pointeur vers la chaîne contenant la description de l'erreur sera écrit dans ce pointeur. Ce pointeur doit être libéré avec qk_str_free. Il peut s'agir d'un pointeur nul, auquel cas l'erreur ne sera pas consignée.

Retours

Le code de retour pour le transpileur, QkExitCode_Success signifie un succès et toutes les autres valeurs indiquent une erreur.

QkExitCode qk_transpile_stage_routing(QkDag *dag, const QkTarget *target, const QkTranspileOptions *options, QkTranspilerStageState *state, char **error)

Exécutez l'étape de routage prédéfinie du transcompilateur sur un circuit

Le transcompilateur Qiskit est un compilateur de circuits quantiques qui réécrit un circuit d'entrée donné afin de l'adapter aux contraintes d'un QPU et optimise le circuit pour son exécution. Cette fonction exécute la troisième étape du gestionnaire de passes prédéfinies, le routage, qui traduit toutes les instructions du circuit en instructions prises en charge par la cible. Pour plus d'informations, veuillez vous référer à la section Étape de routage.

Cette fonction ne doit être utilisée qu'avec des circuits construits à l'aide de l'API C de Qiskit. Il fait des suppositions sur le circuit en utilisant uniquement les fonctionnalités exposées via C. Si vous êtes dans un environnement mixte Python et C, il est généralement préférable d'invoquer le transcompilateur via Python.

Cette fonction est multithread en interne et lancera un pool de threads avec un nombre de threads égal au nombre d'unités centrales indiqué par le système d'exploitation par défaut. Il s'agit notamment des cœurs logiques sur les unités centrales avec multithreading simultané. Vous pouvez régler le nombre de threads à l'aide de la variable d'environnement RAYON_NUM_THREADS . Par exemple, le paramètre RAYON_NUM_THREADS=4 limiterait le pool de threads à 4 threads.

Sécurité

Le comportement est indéfini si dag, target, ou layout, ne sont pas des pointeurs valides et non nuls vers respectivement un QkDag, QkTarget, ou un QkTranspileLayout pointeur. options doit être un pointeur valide vers a QkTranspileOptions ou NULL. error doit être un pointeur valide vers un char pointeur ou NULL.

Paramètres

• dag – Pointeur vers le circuit sur lequel exécuter le transcompilateur.
• target - Pointeur vers la cible pour laquelle le circuit doit être compilé.
• options - Un pointeur sur un objet d'options qui définit les options de l'utilisateur. S'il s'agit d'un pointeur nul, les valeurs par défaut seront utilisées. Voir qk_transpile_default_options pour plus de détails sur les valeurs par défaut.
• state – Un pointeur vers un pointeur vers un QkTranspilerStageState objet contenant la structure. En général, vous devrez exécuter la fonction qk_transpile_stage_layout avant celle-ci, ce qui vous fournira un QkTranspilerStageState objet avec la mise en page initiale définie. Vous voulez récupérer l'état de sortie de cette fonction et l'utiliser comme entrée pour celle-ci. Si vous ne disposez pas d'un objet de mise en page (par exemple, si vous avez effectué votre propre passage de mise en page). Vous pouvez exécuter qk_transpile_layout_generate_from_mapping cette commande pour générer une configuration simple (dans laquelle le qubit virtuel 0 du circuit est mappé au qubit physique 0 de la cible, 1 → 1, 2 → 2, etc.) pour le DAG dans son état actuel. Cela vous permettra de créer un objet de schéma pour la phase de routage si vous générez votre propre schéma.
• erreur – Pointeur vers un pointeur contenant une chaîne terminée par un caractère nul avec une description de l'erreur. Si le transcompilateur échoue, un pointeur vers la chaîne contenant la description de l'erreur sera écrit dans ce pointeur. Ce pointeur doit être libéré avec qk_str_free. Il peut s'agir d'un pointeur nul, auquel cas l'erreur ne sera pas consignée.

Retours

Le code de retour pour le transpileur, QkExitCode_Success signifie un succès et toutes les autres valeurs indiquent une erreur.

QkExitCode qk_transpile_stage_optimization(QkDag *dag, const QkTarget *target, const QkTranspileOptions *options, char **error, QkTranspilerStageState *state)

Exécutez la phase d'optimisation prédéfinie du transcompilateur sur un circuit

Le transcompilateur Qiskit est un compilateur de circuits quantiques qui réécrit un circuit d'entrée donné afin de l'adapter aux contraintes d'un QPU et optimise le circuit pour son exécution. Cette fonction exécute la quatrième étape du gestionnaire de passes prédéfinies, l'optimisation, qui optimise le circuit pour la cible donnée après que le circuit a été transformé en circuit physique. Pour plus d'informations, veuillez vous reporter à la section Étape d'optimisation.

Cette fonction ne doit être utilisée qu'avec des circuits construits à l'aide de l'API C de Qiskit. Il fait des suppositions sur le circuit en utilisant uniquement les fonctionnalités exposées via C. Si vous êtes dans un environnement mixte Python et C, il est généralement préférable d'invoquer le transcompilateur via Python.

Cette fonction est multithread en interne et lancera un pool de threads avec un nombre de threads égal au nombre d'unités centrales indiqué par le système d'exploitation par défaut. Il s'agit notamment des cœurs logiques sur les unités centrales avec multithreading simultané. Vous pouvez régler le nombre de threads à l'aide de la variable d'environnement RAYON_NUM_THREADS . Par exemple, le paramètre RAYON_NUM_THREADS=4 limiterait le pool de threads à 4 threads.

Sécurité

Le comportement est indéfini si dag et ne target sont pas des pointeurs valides et non nuls vers un ou un QkTarget QkDagrespectivement. options doit être un pointeur valide vers a QkTranspileOptions ou NULL. error doit être un pointeur valide vers un char pointeur ou NULL.

Paramètres

• dag – Pointeur vers le circuit sur lequel exécuter le transcompilateur.
• target - Pointeur vers la cible pour laquelle le circuit doit être compilé.
• options - Un pointeur sur un objet d'options qui définit les options de l'utilisateur. S'il s'agit d'un pointeur nul, les valeurs par défaut seront utilisées. Voir qk_transpile_default_options pour plus de détails sur les valeurs par défaut.
• erreur – Pointeur vers un pointeur contenant une chaîne terminée par un caractère nul avec une description de l'erreur. Si le transcompilateur échoue, un pointeur vers la chaîne contenant la description de l'erreur sera écrit dans ce pointeur. Ce pointeur doit être libéré avec qk_str_free. Il peut s'agir d'un pointeur nul, auquel cas l'erreur ne sera pas consignée.
• état – Un pointeur vers un QkTranspilerStageState objet contenant la structure. En général, vous devrez exécuter la fonction qk_transpile_stage_layout avant celle-ci; cela vous fournira un QkTranspileLayout objet avec la mise en page initiale souhaitée. Vous devrez ensuite récupérer la mise en page de sortie de cette fonction et l'utiliser comme entrée pour celle-ci. Si vous ne disposez pas d'un objet de mise en page (par exemple, si vous avez effectué votre propre passage de mise en page). Vous pouvez exécuter qk_transpile_layout_generate_from_mapping cette commande pour générer une configuration simple (dans laquelle le qubit virtuel 0 du circuit est mappé au qubit physique 0 de la cible, 1 → 1, 2 → 2, etc.) pour le DAG dans son état actuel. Cela vous permettra de créer un objet de mise en page pour la phase d'optimisation si vous créez votre propre mise en page.

Retours

Le code de retour pour le transpileur, QkExitCode_Success signifie un succès et toutes les autres valeurs indiquent une erreur.

QkExitCode qk_transpile_stage_translation(QkDag *dag, const QkTarget *target, const QkTranspileOptions *options, char **error)

Exécutez l'étape de traduction prédéfinie du transcompilateur sur un circuit

Le transcompilateur Qiskit est un compilateur de circuits quantiques qui réécrit un circuit d'entrée donné afin de l'adapter aux contraintes d'un QPU et optimise le circuit pour son exécution. Cette fonction exécute la quatrième étape du gestionnaire de passes prédéfinies, la traduction, qui traduit toutes les instructions du circuit en instructions prises en charge par la cible. Pour plus d'informations, veuillez vous référer à la section Étape de traduction.

Cette fonction ne doit être utilisée qu'avec des circuits construits à l'aide de l'API C de Qiskit. Il fait des suppositions sur le circuit en utilisant uniquement les fonctionnalités exposées via C. Si vous êtes dans un environnement mixte Python et C, il est généralement préférable d'invoquer le transcompilateur via Python.

Cette fonction est multithread en interne et lancera un pool de threads avec un nombre de threads égal au nombre d'unités centrales indiqué par le système d'exploitation par défaut. Il s'agit notamment des cœurs logiques sur les unités centrales avec multithreading simultané. Vous pouvez régler le nombre de threads à l'aide de la variable d'environnement RAYON_NUM_THREADS . Par exemple, le paramètre RAYON_NUM_THREADS=4 limiterait le pool de threads à 4 threads.

Sécurité

Le comportement est indéfini si dag et ne target sont pas des pointeurs valides et non nuls vers un QkDag, QkTarget respectivement. options doit être un pointeur valide vers a QkTranspileOptions ou NULL. error doit être un pointeur valide vers un char pointeur ou NULL.

Paramètres

• dag – Pointeur vers le circuit sur lequel exécuter le transcompilateur.
• target - Pointeur vers la cible pour laquelle le circuit doit être compilé.
• options - Un pointeur sur un objet d'options qui définit les options de l'utilisateur. S'il s'agit d'un pointeur nul, les valeurs par défaut seront utilisées. Voir qk_transpile_default_options pour plus de détails sur les valeurs par défaut.
• erreur – Pointeur vers un pointeur contenant une chaîne terminée par un caractère nul avec une description de l'erreur. Si le transcompilateur échoue, un pointeur vers la chaîne contenant la description de l'erreur sera écrit dans ce pointeur. Ce pointeur doit être libéré avec qk_str_free. Il peut s'agir d'un pointeur nul, auquel cas l'erreur ne sera pas consignée.

Retours

Le code de retour pour le transpileur, QkExitCode_Success signifie un succès et toutes les autres valeurs indiquent une erreur.

QkExitCode qk_transpile_stage_layout(QkDag *dag, const QkTarget *target, const QkTranspileOptions *options, QkTranspilerStageState **state, char **error)

Exécutez l'étape de mise en page prédéfinie du transcompilateur sur un circuit

Le transcompilateur Qiskit est un compilateur de circuits quantiques qui réécrit un circuit d'entrée donné afin de l'adapter aux contraintes d'un QPU et optimise le circuit pour son exécution. Cette fonction exécute la deuxième étape de la disposition du gestionnaire de passes prédéfinies, qui choisit le mappage initial des qubits virtuels vers les qubits physiques, y compris l'extension du circuit pour contenir des ancilles explicites. Pour plus d'informations, consultez la section Étape de mise en page.

Cette fonction ne doit être utilisée qu'avec des circuits construits à l'aide de l'API C de Qiskit. Il fait des suppositions sur le circuit en utilisant uniquement les fonctionnalités exposées via C. Si vous êtes dans un environnement mixte Python et C, il est généralement préférable d'invoquer le transcompilateur via Python.

Cette fonction est multithread en interne et lancera un pool de threads avec un nombre de threads égal au nombre d'unités centrales indiqué par le système d'exploitation par défaut. Il s'agit notamment des cœurs logiques sur les unités centrales avec multithreading simultané. Vous pouvez régler le nombre de threads à l'aide de la variable d'environnement RAYON_NUM_THREADS . Par exemple, le paramètre RAYON_NUM_THREADS=4 limiterait le pool de threads à 4 threads.

Sécurité

Le comportement est indéfini si dag ou target, ne sont pas des pointeurs valides et non nuls vers un QkDagou un QkTarget respectivement. Le comportement est également indéfini si layout n'est pas un pointeur valide et aligné vers un pointeur vers un QkTranspileLayout ou un pointeur vers un NULL pointeur. options doit être un pointeur valide vers a QkTranspileOptions ou NULL. error doit être un pointeur valide vers un char pointeur ou NULL.

Paramètres

• dag – Pointeur vers le circuit sur lequel exécuter le transcompilateur.
• target - Pointeur vers la cible pour laquelle le circuit doit être compilé.
• options - Un pointeur sur un objet d'options qui définit les options de l'utilisateur. S'il s'agit d'un pointeur nul, les valeurs par défaut seront utilisées. Voir qk_transpile_default_options pour plus de détails sur les valeurs par défaut.
• état – Un pointeur vers un pointeur vers un QkTranspilerStageState objet. En cas de réussite (code de retour 0), l'objet de mise en page créé par le transcompilateur sera écrit dans l'objet d'état pointé par ce pointeur. Le pointeur interne correspondant peut être nul s'il n'existe aucun objet d'état ou de mise en page. En général, lorsque vous exécutez cette fonction qk_transpile_stage_init , vous récupérez l'état de sortie de celle-ci et utilisez sa structure comme entrée pour celle-ci. Mais si vous n'avez pas de structure, le pointeur interne peut être nul et un nouvel objet QkTranspilerStageState, doté d'une structure, sera alloué, et ce pointeur sera alors renseigné avec la valeur interne de la structure.
• erreur – Pointeur vers un pointeur contenant une chaîne terminée par un caractère nul avec une description de l'erreur. Si le transcompilateur échoue, un pointeur vers la chaîne contenant la description de l'erreur sera écrit dans ce pointeur. Ce pointeur doit être libéré avec qk_str_free. Il peut s'agir d'un pointeur nul, auquel cas l'erreur ne sera pas consignée.

Retours

Le code de retour pour le transpileur, QkExitCode_Success signifie un succès et toutes les autres valeurs indiquent une erreur.

QkExitCode qk_transpile(const QkCircuit *qc, const QkTarget *target, const QkTranspileOptions *options, QkTranspileResult *result, char **error)

Transpilez un seul circuit.

Le transpileur Qiskit est un compilateur de circuits quantiques qui réécrit un circuit d'entrée donné pour répondre aux contraintes d'une QPU et optimise le circuit pour l'exécution. Cette fonction ne doit être utilisée qu'avec des circuits construits à l'aide de l'API C de Qiskit. Si vous êtes dans un environnement mixte Python et C, il est généralement préférable d'invoquer le transpileur via Python.

Cette fonction est multithread en interne et lancera un pool de threads avec un nombre de threads égal au nombre d'unités centrales indiqué par le système d'exploitation par défaut. Il s'agit notamment des cœurs logiques sur les unités centrales avec multithreading simultané. Vous pouvez régler le nombre de threads à l'aide de la variable d'environnement RAYON_NUM_THREADS . Par exemple, le paramètre RAYON_NUM_THREADS=4 limiterait le pool de threads à 4 threads.

Sécurité

Le comportement est indéfini si circuit, target, ou result, ne sont pas des pointeurs valides et non nuls vers respectivement QkTranspileResult , QkCircuit QkTarget, ou. options doit être un pointeur valide vers a QkTranspileOptions ou NULL. error doit être un pointeur valide vers un char pointeur ou NULL.

Paramètres

• qc - Un pointeur sur le circuit sur lequel le transpondeur doit fonctionner.
• target - Pointeur vers la cible pour laquelle le circuit doit être compilé.
• options - Un pointeur sur un objet d'options qui définit les options de l'utilisateur. S'il s'agit d'un pointeur nul, les valeurs par défaut seront utilisées. Voir qk_transpile_default_options pour plus de détails sur les valeurs par défaut.
• result - Un pointeur sur l'emplacement en mémoire du résultat du transpilateur. En cas d'exécution réussie (code de retour 0), la sortie du transpileur sera écrite dans le pointeur. Les membres de la structure de résultat appartiennent à l'appelant et vous êtes responsable de la libération des membres à l'aide des fonctions de libération respectives.
• erreur – Pointeur vers un pointeur contenant une chaîne terminée par un caractère nul avec une description de l'erreur. Si le transcompilateur échoue, un pointeur vers la chaîne contenant la description de l'erreur sera écrit dans ce pointeur. Ce pointeur doit être libéré avec qk_str_free. Il peut s'agir d'un pointeur nul, auquel cas l'erreur ne sera pas consignée.

Retours

Le code de retour pour le transpileur, QkExitCode_Success signifie un succès et toutes les autres valeurs indiquent une erreur.