{ "cells": [ { "cell_type": "markdown", "id": "f7d9993f", "metadata": {}, "source": [ "---\n", "title: \"HI-VQE Chemistry - Qunova ComputingによるQiskit関数\"\n", "description: \"Qunova ComputingのHI-VQE Qiskit関数に関するドキュメント。 化学系の基底状態および基底状態エネルギーを求めるために使用できる。\"\n", "---\n", "\n", "{/* cspell:ignore lumo hivqe DMRG ccsd, ffsim, pvdz, Qunova, HI-VQE, AVAS, Dooh, pyscf, nucmod, GTO's, lucj, pseudopotential, pseudopotentials, magmom, Jastrow, multireference, Pellow, Jarman */}\n", "\n" ] }, { "cell_type": "markdown", "id": "dde95705", "metadata": {}, "source": [ "\n", "\n", "# HI-VQE Chemistry - Qunova ComputingによるQiskit関数\n", "\n", "*[APIリファレンス](/docs/api/functions/qunova-chemistry)を参照してください*\n", "\n", "\n", " Qiskit 関数は、 IBM Quantum® Premium Plan、Flex Plan、およびオンプレム ( IBM Quantum Platform API 経由) Plan ユーザーだけが利用できる実験的な機能です。 これらはプレビューリリースの状態であり、変更される可能性がある。\n", "\n", "\n" ] }, { "cell_type": "markdown", "id": "bbfca10c", "metadata": { "tags": [ "version-info" ] }, "source": [ "{/*\n", " DO NOT EDIT THIS CELL!!!\n", " This cell's content is generated automatically by a script. Anything you add\n", " here will be removed next time the notebook is run. To add new content, create\n", " a new cell before or after this one.\n", " */}\n", "\n", "\n", " \n", " このページ上のコードは、以下の要件に基づいて開発されました。\n", " これらのバージョンまたはそれ以降のバージョンを使用することを推奨します。\n", "\n", " ```\n", " qiskit-ibm-runtime~=0.45.0\n", " ```\n", " \n", "\n", "\n" ] }, { "cell_type": "markdown", "id": "e3498f9b", "metadata": {}, "source": [ "\n", "\n", "## 概要\n", "\n", "量子化学では、電子構造問題は、電子シュレーディンガー方程式（系の電子の振る舞いを記述する量子波動関数）の解を見つけることに焦点を当てている。 これらの波動関数は複素振幅のベクトルであり、各振幅は可能な電子配置の寄与に対応する。\n", "\n", "基底状態は系の最も低いエネルギーの波動関数であり、分子系の研究において特に重要である。 基底状態を計算するための最も正確なアプローチは、すべての可能な電子配置を考慮することであるが、配置の数は系の大きさとともに指数関数的に増加するため、大きな系では実行不可能となる。\n", "\n", "Handover Iterative Variational Quantum Eigensolver (HI-VQE)は、分子系の基底状態を正確に推定するための革新的なハイブリッド量子古典的手法である。 量子ハードウェアと古典コンピューティングを統合し、量子プロセッサーを使って候補となる電子配置を効率的に探索し、その結果の波動関数を古典コンピューターで計算する。 コンパクトでありながら化学的に正確な波動関数を生成することで、HI-VQEは量子化学と物質科学の研究と発見を促進します。\n", "\n", "![QunovaのHI-VQEアルゴリズムの概要を示す画像](https://quantum.cloud.ibm.com/docs/images/guides/qunova-chemistry/overview.svg)\n", "\n", "HI-VQEは、基底状態を高精度で効率的に推定することにより、電子構造問題の計算量を削減します。 最も関連性の高い電子配置の中から厳選されたサブセットに焦点を当て、精度と効率の両方を最適化します。\n", "\n", "HI-VQEは、古典コンピュータと量子コンピュータの両方の長所を組み合わせて、現在の推定波動関数を繰り返し精製し、改善する。 また、独自の部分空間構築技術により、コンフィギュレーション選択をより効率的に行うことができるため、量子化学シミュレーションにおける計算制御の幅が広がり、精度が向上します。\n", "\n", "アルゴリズムについてさらに詳しく知りたい場合は、 [関連する研究論文をお読み](https://arxiv.org/abs/2503.06292)ください\n", "\n" ] }, { "cell_type": "markdown", "id": "5f761442", "metadata": {}, "source": [ "\n", "\n", "## 説明\n", "\n", "分子系の電子配置の数は、系の大きさとともに指数関数的に増加する。 しかし、基底状態のような特定の電子状態では、その状態のエネルギーに大きく寄与する配位はごく一部であるのが普通である。 選択構成相互作用（SCI）法は、このスパース性を利用して、最も関連性の高い構成を特定し、それに集中することで計算コストを削減する。 この構成の部分集合を部分空間と呼ぶ。\n", "\n", "HI-VQEは、分子系を表現する量子コンピュータ固有の効率性を活用し、部分空間探索を支援する。 古典と量子のサブルーチンを統合し、電子構造問題を高精度で解く。 既存の量子SCI法とは異なり、HI-VQEは、変分学習、反復部分空間構築、対角化前構成スクリーニングを組み合わせることで、量子測定、反復、古典的対角化コストを削減し、効率を高めている。 したがって、HI-VQEは、より多くの量子ビットを必要とする大規模な分子系に適用することができ、与えられたサイズの問題を同じ精度で解くためのコストを削減することができる。\n", "\n", "![QunovaのHI-VQEアルゴリズムの各ステップを詳細に説明した図。](https://quantum.cloud.ibm.com/docs/images/guides/qunova-chemistry/description.avif)\n", "\n", "系の基底状態を計算するために、HI-VQEはまず古典化学パッケージ（ PySCF ）を使用して、分子形状やその他の分子情報など、ユーザーから提供された入力から分子表現を生成します。 その後、量子-古典のハイブリッド最適化ループに入り、含まれるコンフィギュレーションの数を最小限に抑えながら、基底状態を最適に表現する部分空間を繰り返し精製する。 ループは、部分空間の大きさやエネルギーの安定性などの収束基準が満たされるまで続けられ、その後、計算された基底状態の波動関数とエネルギーが出力される。 これらの結果は、正確なポテンシャルエネルギー曲面を構築し、システムのさらなる解析を行うために使用することができる。\n", "\n", "この最適化ループは、高品質な部分空間を生成するために、量子回路のパラメータを調整することに重点を置いている。 [`excitation_preserving`](/docs/api/qiskit/qiskit.circuit.library.excitation_preserving)HI-VQEでは、「 [efficient\\_su2](/docs/api/qiskit/qiskit.circuit.library.efficient_su2) 」および 「[LUCJ](https://qiskit-community.github.io/ffsim/explanations/lucj.html) 」の3つの量子回路オプションを提供しています。 この最適化は、その汎用性の高さから、ハートリー・フォック基準状態の近くで初期化される。 その後、この回路は量子デバイス上で実行され、その結果として得られる量子状態から構成がサンプリングされた後、バイナリ文字列として返されます。 量子デバイスのノイズにより、サンプリングされた構成の中には、電子数やスピンの保存則を満たさないなど、物理的に無効なものがある可能性があります。 HI-VQE では、 [qiskit-addon-sqd](/docs/addons/qiskit-addon-sqd) パッケージの構成復旧プロセスを利用してこの問題に対処しており、ユーザーは不正な構成を修正するか、あるいは破棄するかを選択できます。\n", "\n", "その後、有効なコンフィギュレーションは、オプションのスクリーニングステップを経て、最小限の寄与しかしないと予測されるコンフィギュレーションを除外する。 これにより部分空間の次元が小さくなり、対角化ステップのコストが下がる。 スクリーニングが有効であれば、有効なコンフィギュレーションから予備的な部分空間ハミルトニアンが構築され、非常に緩い終了基準で対角化が実行される。 結果として得られる各構成の振幅の精度は低いが、今回の反復でどの構成を部分空間から除外するかを予測するのに有効であり、計算速度も速い。\n", "\n", "選択されたコンフィギュレーションは部分空間に追加され、システムのハミルトニアンはこの部分空間に投影される。 部分空間は反復的に更新され、反復の間、最も関連性の高い構成が維持される。 このアプローチは、量子回路が各ステップで完全な基底状態を近似する必要がないため、他の方法とは対照的である。\n", "\n", "次に、この部分空間ハミルトニアンを古典的に対角化し、最低固有値とそれに対応する固有ベクトルを求め、基底状態とそのエネルギーの近似を表す。 反復によって部分空間の品質が向上すると、計算された基底状態は真の基底状態をよりよく近似する。 この時点で、計算された基底状態に対して実質的な寄与を持たない部分空間からすべてのコンフィギュレーションを取り除くために、追加のスクリーニングステップを実行することができる。 このステップによって、次の反復に持ち越される部分空間が可能な限りコンパクトになる。 これは対角化によって返される振幅に基づいて評価され、これらは計算された基底状態に対する各配置の重要な寄与を表しているからである。\n", "\n", "その後、収束チェックによって、さらなるトレーニングによって結果が改善されるかどうかが判断される。 そうであれば、オプションで古典的な展開ステップが実行され、量子回路のパラメータが更新されて計算エネルギーがさらに最小化され、このプロセスが繰り返される。 古典的な展開ステップは、量子デバイスからサンプリングされた配置を補完して、部分空間の配置を追加生成する。 対角化の結果、振幅が最大となった配置をまず特定し、特定した配置から単励起と二重励振を持つ新しい配置を生成する。 そして、これらのコンフィギュレーションを希望する数だけ、部分空間に追加する。\n", "\n", "反復が収束したと判断されると、HI-VQEは計算された基底状態（部分空間の状態と基底状態の波動関数の振幅の形）、そのエネルギー、計算された状態が系のハミルトニアンの固有状態を形成しているかどうかの指標となるエネルギー分散尺度を返す。\n", "\n", "ユーザーは、使用する量子回路や各量子回路のショット数を決めることができ、また、部分空間のサイズを制御したり、量子的に生成された構成を補助するために古典的な構成を追加生成できるようにすることもできる。 こうすることで、ユーザーはHI-VQEの挙動を希望する用途に合わせて調整することができる。\n", "\n" ] }, { "cell_type": "markdown", "id": "73390a19", "metadata": {}, "source": [ "\n", "\n", "## 使用を開始する\n", "\n", "まず、 [その関数へのアクセス権をリクエストします](https://forms.office.com/r/zN3hvMTqJ1)。\n", "次に、 [IBM Quantum®](http://quantum.cloud.ibm.com/) のAPIキーを使用して認証を行い、 [アカウントが](/docs/guides/functions-get-started#install-qiskit-functions-catalog-client)すでにローカル環境に保存されていることを前提として、次のようにQiskit Functionを選択します：\n", "\n" ] }, { "cell_type": "code", "execution_count": 1, "id": "95a715d2", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "[QiskitFunction(qunova/hivqe-chemistry),\n", " QiskitFunction(global-data-quantum/quantum-portfolio-optimizer),\n", " QiskitFunction(algorithmiq/tem),\n", " QiskitFunction(qedma/qesem),\n", " QiskitFunction(multiverse/singularity),\n", " QiskitFunction(ibm/circuit-function),\n", " QiskitFunction(q-ctrl/optimization-solver),\n", " QiskitFunction(colibritd/quick-pde),\n", " QiskitFunction(q-ctrl/performance-management),\n", " QiskitFunction(kipu-quantum/iskay-quantum-optimizer)]" ] }, "execution_count": 1, "metadata": {}, "output_type": "execute_result" } ], "source": [ "import reprlib\n", "from qiskit_ibm_catalog import QiskitFunctionsCatalog\n", "\n", "catalog = QiskitFunctionsCatalog(channel=\"ibm_quantum_platform\")\n", "\n", "# Verify that you have access to the function\n", "catalog.list()" ] }, { "cell_type": "code", "execution_count": null, "id": "968af861", "metadata": {}, "outputs": [], "source": [ "# Load the function\n", "function = catalog.load(\"qunova/hivqe-chemistry\")" ] }, { "cell_type": "markdown", "id": "c3e0cc98", "metadata": {}, "source": [ "\n", "\n", "## 例\n", "\n", "最初の例では、HI-VQE アルゴリズムを用いて、 NH3 分子の基底状態エネルギーを計算する方法を示す。\n", "\n" ] }, { "cell_type": "markdown", "id": "b03aa968", "metadata": {}, "source": [ "\n", "\n", "#### 分子の幾何構造とオプションを定義する\n", "\n", "NH3 の分子形状は、各原子を\"; \"で区切ったデカルト座標で提供される。\n", "\n" ] }, { "cell_type": "code", "execution_count": 3, "id": "970dadd1", "metadata": {}, "outputs": [], "source": [ "# Define the molecule geometry\n", "geometry = \"\"\"\n", "N -0.85188 -0.02741 0.03141;\n", "H 0.16545 0.00593 -0.01648;\n", "H -1.16348 -0.39357 -0.86702;\n", "H -1.16348 0.94228 0.06281;\n", "\"\"\"" ] }, { "cell_type": "markdown", "id": "64429e13", "metadata": {}, "source": [ "分子システムには、以下の辞書形式で追加オプションを定義し、提供することができる。\n", "\n" ] }, { "cell_type": "code", "execution_count": 4, "id": "0f9e9a3c", "metadata": {}, "outputs": [], "source": [ "# Configure some options for the job.\n", "molecule_options = {\"basis\": \"sto3g\"}\n", "hivqe_options = {\"shots\": 100, \"max_iter\": 20}" ] }, { "cell_type": "markdown", "id": "bf180336", "metadata": {}, "source": [ "ジオメトリとオプションを入力して関数を実行します。\n", "\n" ] }, { "cell_type": "code", "execution_count": null, "id": "fdebf7f0", "metadata": {}, "outputs": [], "source": [ "# Run HI-VQE\n", "job = function.run(\n", " geometry=geometry,\n", " # `backend_name` is the name of a backend with at least 16 qubits,\n", " # for example, \"ibm_marrakesh\".\n", " backend_name=backend_name,\n", " max_states=2000,\n", " max_expansion_states=10,\n", " molecule_options=molecule_options,\n", " hivqe_options=hivqe_options,\n", ")" ] }, { "cell_type": "markdown", "id": "75e46808-1638-4f14-bfe4-ea3eba2f738b", "metadata": {}, "source": [ "ファンクションジョブIDを印刷しておくと、何か問題が発生したときに、サポートリクエストで提供することができます。\n", "\n" ] }, { "cell_type": "code", "execution_count": 6, "id": "87585ede-2ec4-467a-a269-514f59026602", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Job ID: e5ced6f2-fd1d-4244-a6aa-bd27cfb0cdee\n" ] } ], "source": [ "print(\"Job ID:\", job.job_id)" ] }, { "cell_type": "markdown", "id": "608cf736", "metadata": {}, "source": [ "この例では、 sto3g の8つの軌道を持つ16個の量子ビットを NH3 分子の基底として使用する。\n", "\n" ] }, { "cell_type": "markdown", "id": "ad1c9bcb", "metadata": {}, "source": [ "Qiskit Function [ワーク](/docs/guides/functions-get-started#check-job-status)ロードのステータスを確認したり、 [結果を](/docs/guides/functions-get-started#retrieve-results)返したりするには、次のように操作してください：\n", "\n" ] }, { "cell_type": "code", "execution_count": 7, "id": "b442c581", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "QUEUED\n" ] } ], "source": [ "print(job.status())" ] }, { "cell_type": "markdown", "id": "aef704b8", "metadata": {}, "source": [ "ジョブの完了後、 `result()` インスタンスで結果を得ることができる。\n", "\n" ] }, { "cell_type": "code", "execution_count": 8, "id": "f447e506", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "{'eigenvector': [0.9824448589364075, 0.009527106392132133, 6.854074372058527e-08, 3.591500190038039e-07, 0.0012975231577544268, 2.310159709002111e-05, ...], 'energy': -55.52108557170985, 'energy_history': [-55.51901898989887, -55.52056881448526, -55.52065046778772, -55.520690696813716, -55.520691108428, -55.520708448092634, ...], 'energy_variance': 3.066239097617371e-10, ...}\n" ] } ], "source": [ "result = job.result()\n", "\n", "# Output can be long, so we display a shortened representation\n", "shortened_result = reprlib.repr(result)\n", "print(shortened_result)" ] }, { "cell_type": "markdown", "id": "2b6fb05c", "metadata": {}, "source": [ "基底状態のエネルギーにアクセスするには、\"energy \"キーを使う。 固有ベクトル \"キーは、結果の \"状態 \"とともに格納された電子配置の対応するビット列表記を持つCI係数を提供する。\n", "\n" ] }, { "cell_type": "code", "execution_count": null, "id": "28cd677c", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "|Exact Energy - HI-VQE Energy|: 0.06246299427914437 mHa\n", "Sampled Number of States: 1936\n" ] } ], "source": [ "fci_energy = -55.521148034704126 # the exact energy using FCI method\n", "hivqe_energy = result[\"energy\"]\n", "print(\n", " f\"|Exact Energy - HI-VQE Energy|: \"\n", " f\"{abs(fci_energy - hivqe_energy) * 1000} mHa\"\n", ")\n", "print(f\"Sampled Number of States: {len(result['states'])}\")" ] }, { "cell_type": "markdown", "id": "5f252348-720f-47c0-9e7f-ae5e5512b8d1", "metadata": {}, "source": [ "\n", "\n", "## ライセンス交付\n", "\n", "なお、このQiskit関数の使用は、上限を20キュービット以下とする問題に限定されます。ただし、それ以上の上限を認めるライセンスを取得している場合はこの限りではありません。\n", "\n", "ライセンスに関するお問い合わせは、 [qiskit.support @ qunovacomputing.com](mailto:qiskit.support@qunovacomputing.com) までメールでお送りください。\n", "\n", "\n", "\n", "### ライセンス付き関数の使用例\n", "\n", "ライセンスを取得したユーザーにはライセンストークンが発行され、その後、ラッパーライブラリを使用してそのライセンストークンを関数に送信する必要があります。\n", "このラッパーライブラリは、 [PyPI から](https://pypi.org/project/hivqe-qiskit-function-utils/) `pip install hivqe-qiskit-function-utils`. を使用してインストールできます。\n", "以下の例は、このライブラリを使用して関数を呼び出す際に、ライセンストークンを送信する方法を示しています。\n", "\n" ] }, { "cell_type": "code", "execution_count": null, "id": "a1d9ad0f-4add-4ef8-a63c-c1601b13e322", "metadata": {}, "outputs": [], "source": [ "import math\n", "from qiskit_ibm_catalog import QiskitFunctionsCatalog\n", "from hivqe_qiskit_function_utils import FunctionWrapper\n", "\n", "catalog = QiskitFunctionsCatalog(\n", " token=\"your_qiskit_functions_catalog_token\",\n", " channel=\"ibm_quantum_platform\",\n", " instance=\"your_ibm_instance\",\n", ")\n", "\n", "molecule_geometry = f\"\"\"\n", "O 0 0 0;\n", "H {-0.957*math.sin(math.radians(104.5)/2.0)} {0.957*math.cos(math.radians(104.5)/2.0)} 0;\n", "H {0.957*math.sin(math.radians(104.5)/2.0)} {0.957*math.cos(math.radians(104.5)/2.0)} 0\n", "\"\"\"\n", "\n", "hivqe = FunctionWrapper(\n", " token=\"your_hivqe_license_token\",\n", " function=catalog.load(\"qunova/hivqe-chemistry\"),\n", ")\n", "job = hivqe.run(\n", " geometry=molecule_geometry,\n", " backend_name=\"ibm_torino\",\n", " max_states=10000,\n", " max_expansion_states=1000,\n", " hivqe_options={\"ansatz\": \"epa\", \"max_iter\": 10},\n", ")\n", "result = job.result()" ] }, { "cell_type": "markdown", "id": "4af252f6", "metadata": {}, "source": [ "\n", "\n", "## パフォーマンス\n", "\n", "本セクションでは、 Li2S の24qubitケース、 N2 分子の40qubitケース、 FeP-NO システムの44qubitケースを用いたHI-VQEのベンチマーク計算を示す。\n", "\n" ] }, { "cell_type": "markdown", "id": "54d8f446", "metadata": {}, "source": [ "\n", "\n", "#### Li2S 分子（24量子ビット）の解離ポテンシャルエネルギー面曲線\n", "\n", "PES曲線は、FCIリファレンスとRHFからの初期推測値、FCIリファレンスからのエネルギー誤差とともに示されている。\n", "\n", "![Li2S 系において、HI-VQEが古典的な参照PES曲線の化学的精度内で解を生成することを示す画像](https://quantum.cloud.ibm.com/docs/images/guides/qunova-chemistry/Li2S_PES.avif)。\n", "\n", "計算は以下の形状とオプションで行われた。\n", "\n" ] }, { "cell_type": "code", "execution_count": 11, "id": "8c998f54", "metadata": {}, "outputs": [], "source": [ "# Define Li2S geometries\n", "Li2S_geoms = {\n", " \"Li2S_1.51\": \"S -1.239044 0.671232 -0.030374;Li -1.506327 0.432403 -1.498949;Li -0.899996 0.973348 1.826768;\",\n", " \"Li2S_2.40\": \"S -1.741432 0.680397 0.346702;Li -0.529307 0.488006 -1.729343;Li -1.284307 0.989409 2.177209;\",\n", " \"Li2S_3.80\": \"S -2.707255 0.674298 0.909161;Li 0.079218 0.552012 -1.671656;Li -0.927010 0.931502 1.557063;\",\n", "}\n", "\n", "# Configure some options for the job.\n", "molecule_options = {\n", " \"basis\": \"sto3g\",\n", "}\n", "hivqe_options = {\n", " \"shots\": 100,\n", " \"max_iter\": 20,\n", "}\n", "\n", "results = []\n", "for geom in [\"Li2S_1.51\", \"Li2S_2.40\", \"Li2S_3.80\"]:\n", " # Run HI-VQE\n", " job = function.run(\n", " geometry=Li2S_geoms[geom],\n", " backend_name=backend_name, # can use any device with at least 38 qubits\n", " max_states=2000,\n", " max_expansion_states=10,\n", " molecule_options=molecule_options,\n", " hivqe_options=hivqe_options,\n", " )\n", " results.append(job.result())" ] }, { "cell_type": "markdown", "id": "81129f0f", "metadata": {}, "source": [ "赤い点は6つの異なる形状に対するHI-VQEの計算結果を表し、 1.51、 2.40、 3.80 オングストロームに対応する3つの形状が上記セルの入力として提供されている。\n", "\n" ] }, { "cell_type": "markdown", "id": "4d8d6cad", "metadata": {}, "source": [ "\n", "\n", "#### 40量子ビットを有する N2 分子の解離ポテンシャルエネルギー曲線\n", "\n", "窒素分子は、ハートリーフォック状態を超える大きな相関エネルギー寄与を持つ多参照系として同定された。 cc-pvdz基底( 20o,14e )を用い、ホモ・ルーモ活性軌道選択を用いて、 N2 分子のベンチマーク計算を行った。 この問題を表す完全アクティブ空間（CAS）番号は6,009,350,400である。 強力なデスクトップ( 16cpu/64GB )を使っても、この状態数では（エネルギーと電子構造に関する）固有値問題の解を得ることはできない。 HI-VQEを使えば、計算資源を大幅に節約しながら、CAS状態の部分空間を効率的に探索し、化学的に正確な結果を見つけることができる。 以下のプロットは、40量子ビットのHI-VQE計算による N2 分子解離のPES曲線を示している。\n", "\n", "![N2 系において、HI-VQE法が古典的な参照ポテンシャルエネルギー面（PES）曲線の化学的精度内で解を生成することを示す画像](https://quantum.cloud.ibm.com/docs/images/guides/qunova-chemistry/N2_PES_40qubits.avif)\n", "\n" ] }, { "cell_type": "markdown", "id": "e84bc625", "metadata": {}, "source": [ "\n", "\n", "#### 44量子ビットを有するNO系を有する五配位鉄(II)ポルフィリンの解離PES曲線\n", "\n", "もう一つの興味深い化学系は、配位した一酸化窒素（NO）リガンドを持つ鉄（II）-ポルフィリン（ FeP ）錯体であり、これは生物学的に関連性のある金属ポルフィリン系を代表し、様々な生理学的プロセスにおいて重要な役割を果たしている。 この例では、HI-VQEを利用して、 FeP とNO間の分子間相互作用の正確なポテンシャルエネルギー曲面（異なる分離形状に対する基底状態エネルギー）を推定した。 結合系は合計で450個の軌道と202個の電子（ 450o,202e ）（ 6-31g(d ）基底を持つ。 ホモ・ルーモ活性軌道の選択は、( 22o,22e )で実際のケースから小さいケースを計算するために利用された。 以下のベンチマーク結果から、CASCI(DMRG)( 22o,22e )を参照した最先端の古典的計算機化学計算で、化学的精度(> 1.6 mHa )を達成することができた。\n", "\n", "![FeP-NO 系において、HI-VQE法が古典的な参照ポテンシャルエネルギー面（PES）曲線の化学的精度内で解を生成することを示す画像](https://quantum.cloud.ibm.com/docs/images/guides/qunova-chemistry/fepno_44qubits.avif)\n", "\n" ] }, { "cell_type": "markdown", "id": "b34fe075", "metadata": {}, "source": [ "\n", "\n", "## ベンチマーク\n", "\n", "* 厳密行列サイズとは、FCIやCASCIのような厳密解を求める行列式の数である。\n", "* HI-VQE計算は、サンプルを計算し、その部分空間（HI-VQE行列のサイズ）を計算する。\n", "* 合計時間には、QPUランタイムおよびCPUによるQiskit Functionの実行が含まれます。\n", "* 精度は厳密解とのエネルギー差から見積もられる。\n", "\n", "| 化学システム | 量子ビット数 | 正確なマトリックスサイズ | HI-VQEマトリックスサイズ | E(diff) from exact ( mHa ) | 反復回数 | 合計時間 | QPUランタイム使用量 |\n", "| ----------------- | ------ | ------------ | --------------- | -------------------------- | ---- | ------- | ----------- |\n", "| $NH_3$ (8o,10e) | 16 | 3136 | 1936 | 0.08 | 6 | 37 s | 34 s |\n", "| $Li_2S$ (10o,10e) | 20 | 63504 | 3969 | 0.60 | 5 | 250 s | 50 秒 |\n", "| $NH_3$ (15o,10e) | 30時間まで | 9018009 | 49729 | 0.90 | 5 | 354 s | 54 s |\n", "| $N_2$ (16o,14e) | 32 | 130873600 | 1798281 | 1.10 | 9 | 6531 s | 121 s |\n", "| $3H_2O$ (18o,24e) | 36 | 344622096 | 399424 | 0.90 | 24 | 5174 s | 130 s |\n", "| $N_2$ (20o,14e) | 40 | 6009350400 | 9012004 | 1.20 | 21 | 46547 s | 258 s |\n", "\n" ] }, { "cell_type": "markdown", "id": "04236c83", "metadata": {}, "source": [ "\n", "\n", "## エラーメッセージを取得する\n", "\n", "ワークロードが失敗した場合、ステータスは `ERROR` 、 `job.result()` を呼び出すと例外が発生する：\n", "\n" ] }, { "cell_type": "code", "execution_count": 12, "id": "90c6de7c", "metadata": { "editable": true, "slideshow": { "slide_type": "" }, "tags": [ "raises-exception" ] }, "outputs": [ { "ename": "QiskitServerlessException", "evalue": "[\"runner.UnknownRuntimeError: 'An unexpected error occurred during job execution. Please make sure that your inputs are valid. If you are still experiencing problems, you can contact the Qunova Computing support service at qiskit.support@qunovacomputing.com and provide the Function job ID of this job for more assistance. -- https://docs.quantum.ibm.com/errors#1500'\\n\"]", "output_type": "error", "traceback": [ "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", "\u001b[0;31mQiskitServerlessException\u001b[0m Traceback (most recent call last)", "Cell \u001b[0;32mIn[12], line 10\u001b[0m\n\u001b[1;32m 1\u001b[0m job \u001b[38;5;241m=\u001b[39m function\u001b[38;5;241m.\u001b[39mrun(\n\u001b[1;32m 2\u001b[0m geometry\u001b[38;5;241m=\u001b[39m\u001b[38;5;124m\"\u001b[39m\u001b[38;5;124minvalid-geometry\u001b[39m\u001b[38;5;124m\"\u001b[39m, \u001b[38;5;66;03m# This will cause an error\u001b[39;00m\n\u001b[1;32m 3\u001b[0m backend_name\u001b[38;5;241m=\u001b[39mbackend_name,\n\u001b[0;32m (...)\u001b[0m\n\u001b[1;32m 7\u001b[0m hivqe_options\u001b[38;5;241m=\u001b[39mhivqe_options,\n\u001b[1;32m 8\u001b[0m )\n\u001b[0;32m---> 10\u001b[0m \u001b[43mjob\u001b[49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43mresult\u001b[49m\u001b[43m(\u001b[49m\u001b[43m)\u001b[49m\n", "File \u001b[0;32m~/work/documentation/documentation/.tox/py311/lib/python3.11/site-packages/qiskit_serverless/core/job.py:253\u001b[0m, in \u001b[0;36mJob.result\u001b[0;34m(self, wait, cadence, verbose, maxwait)\u001b[0m\n\u001b[1;32m 251\u001b[0m \u001b[38;5;28;01mif\u001b[39;00m \u001b[38;5;28mself\u001b[39m\u001b[38;5;241m.\u001b[39mstatus() \u001b[38;5;241m==\u001b[39m \u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mERROR\u001b[39m\u001b[38;5;124m\"\u001b[39m:\n\u001b[1;32m 252\u001b[0m \u001b[38;5;28;01mif\u001b[39;00m results:\n\u001b[0;32m--> 253\u001b[0m \u001b[38;5;28;01mraise\u001b[39;00m QiskitServerlessException(results)\n\u001b[1;32m 255\u001b[0m \u001b[38;5;28;01mraise\u001b[39;00m QiskitServerlessException(\u001b[38;5;28mself\u001b[39m\u001b[38;5;241m.\u001b[39mfiltered_logs(include\u001b[38;5;241m=\u001b[39m\u001b[38;5;124mr\u001b[39m\u001b[38;5;124m\"\u001b[39m\u001b[38;5;124m(?i)error|exception\u001b[39m\u001b[38;5;124m\"\u001b[39m))\n\u001b[1;32m 257\u001b[0m \u001b[38;5;28;01mif\u001b[39;00m \u001b[38;5;28misinstance\u001b[39m(results, \u001b[38;5;28mstr\u001b[39m):\n", "\u001b[0;31mQiskitServerlessException\u001b[0m: [\"runner.UnknownRuntimeError: 'An unexpected error occurred during job execution. Please make sure that your inputs are valid. If you are still experiencing problems, you can contact the Qunova Computing support service at qiskit.support@qunovacomputing.com and provide the Function job ID of this job for more assistance. -- https://docs.quantum.ibm.com/errors#1500'\\n\"]" ] } ], "source": [ "job = function.run(\n", " geometry=\"invalid-geometry\", # This will cause an error\n", " backend_name=backend_name,\n", " max_states=2000,\n", " max_expansion_states=15,\n", " molecule_options=molecule_options,\n", " hivqe_options=hivqe_options,\n", ")\n", "\n", "job.result()" ] }, { "cell_type": "code", "execution_count": 13, "id": "0b8de82f-3c5a-4024-8e3a-ef8efa83cfb9", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "'ERROR'" ] }, "execution_count": 13, "metadata": {}, "output_type": "execute_result" } ], "source": [ "job.status()" ] }, { "cell_type": "markdown", "id": "e9ec2e67", "metadata": {}, "source": [ "\n", "\n", "## サポートの利用\n", "\n", "この機能に関するサポートが必要な場合は[、 qiskit.support @ qunovacomputing.com](mailto:qiskit.support@qunovacomputing.com) に電子メールを送信してください。\n", "\n", "特定のエラーのトラブルシューティングのヘルプが必要な場合は、エラーが発生したジョブのファンクション・ジョブIDをお知らせください。\n", "\n" ] }, { "cell_type": "markdown", "id": "5a6a25c8", "metadata": {}, "source": [ "\n", "\n", "## 次のステップ\n", "\n", "\n", " * [このフォームに](https://forms.office.com/r/zN3hvMTqJ1)ご記入の上、機能へのアクセスをリクエストしてください。\n", " * このQiskit関数の [APIリファレンス](/docs/api/functions/qunova-chemistry)をご覧ください。\n", " * チュートリアルの [HI-VQEによる FeP-NO の解離PES曲線の計算を](/docs/tutorials/qunova-hivqe)お試しください。\n", " * レビュー：ペロー [＝ジャーマン、A et al. (2025). HIVQE: 効率的な量子化学計算のための反復的変分量子固有値ソルバーの引継ぎ arXiv プレプリント arXiv:2503.06292](https://arxiv.org/abs/2503.06292).\n", " * [Qunova HiVQE](/docs/tutorials/qunova-hivqe) チュートリアルで解離PES曲線を試してみてください。\n", "\n", "\n" ] }, { "cell_type": "markdown", "metadata": {}, "id": "a1b8767d", "source": "© IBM Corp., 2017-2026" } ], "metadata": { "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3" } }, "nbformat": 4, "nbformat_minor": 5 }