メインコンテンツへスキップ
このプロジェクトはベータ版です。バグを見つけましたか？GitHub Issueを開く。質問やアイデアがありますか？Discussionsで質問する — フィードバックをお待ちしています！
このページの翻訳品質はいかがですか？

⚙️ doQumentation設定

チュートリアルでPythonコードを実行するために使用されるJupyterサーバーを設定します。

現在の環境: 検出されませんでした

サーバーバックエンド

コード実行に使用するバックエンドを選択してください:

実行モード

チュートリアルページで実行をクリックしたときの動作を選択してください。これはこのサイトでの埋め込みコード実行にのみ適用されます — JupyterLabでノートブックを開くと標準のQiskitランタイムが使用されます。

変更は次のカーネルセッションで有効になります。コードが実行中の場合は、戻るをクリックしてから実行をクリックして適用してください。

IBM Quantumアカウント

以下の手順に従ってIBM Quantumへのアクセスを設定してください。
セキュリティに関する注意: 認証情報は、このブラウザーのlocalStorageにプレーンテキストで保存されます。保存されるのはこの言語サイトのみです（別の言語サイトでは再度入力してください）。Cookieには保存されないため、Webホストには送信されません。暗号化されていないので、ブラウザー拡張機能やこのデバイスにアクセスできる人に読み取られる可能性があります。下の有効期限の設定で露出を抑え、使い終わったら認証情報を削除してください。共有コンピューターや公共のコンピューターでは、代わりに下で説明している手動のsave_account()方法をおすすめします。

IBM Quantum認証情報をここに一度入力してください。カーネルの起動時にsave_account()経由で自動的にインジェクトされるため、すべてのノートブックに入力する必要はありません。これはこのサイトでの埋め込みコード実行にのみ適用されます — JupyterLabでノートブックを開くには、save_account()を手動で呼び出す必要があります。

  1. quantum.cloud.ibm.com/registrationで登録 — 最初の30日間はクレジットカード不要
  2. インスタンスでサインイン
  3. インスタンス — まだお持ちでない場合は、ホームページで無料のOpen Planインスタンスを作成してください
  4. APIトークン — プロフィールアイコン(右上)をクリックし、「APIトークン」をクリックします。キーをコピーしてください。

詳細な手順については、IBMの認証を設定ガイド(ステップ2)を参照してください。

代替方法:ノートブックセルでsave_account()を手動で実行

このブラウザに認証情報を保存したくない場合は、これを任意のコードセルに貼り付けて実行してください。認証情報はBinderカーネルの一時ストレージに保存され、セッション終了時に失われます。

from qiskit_ibm_runtime import QiskitRuntimeService
QiskitRuntimeService.save_account(
    token="YOUR_API_TOKEN",
    instance="YOUR_CRN",
    overwrite=True
)

表示設定

コードフォントサイズ

14px
from qiskit import QuantumCircuit

事前計算された出力

各ノートブックページには、IBMの元の実行による事前計算された出力（画像、表、テキスト）が表示されます。Runをクリックしてコードをライブ実行すると、元の出力と新しいライブ結果の両方が表示されます。このトグルをオフにすると、ライブ実行中は元の出力が非表示になり、あなたの結果だけが表示されます。

Python警告

デフォルトでは、よりクリーンなノートブック出力のために、Python警告(非推奨通知、ランタイムヒント)は抑制されます。すべての警告を表示するには無効にしてください — デバッグやAPI変更の学習に役立ちます。

データとプライバシー

すべてのデータはブラウザー内に保存されます。doqumentation.orgでは、進捗、ブックマーク、設定はlocalStorageと、言語サイト間で共有するための小さなCookieに保存されます。このCookieはページをリクエストするたびに静的Webホストへ送られますが、doQumentationのサーバーには送られません。IBM Quantumの認証情報はCookieには保存されず、入力した言語サイトのlocalStorageにのみ残ります。ブラウザーのデータを消去したり、別のブラウザーやデバイスを使ったりすると、最初からやり直しになります。

学習進捗

訪問したページにはサイドバーに✓が表示されます。ノートブックページには</>が表示され、未訪問は灰色、訪問済みは青、コードを実行済みは緑になります。

まだ進捗が追跡されていません。チュートリアルとガイドを訪問して追跡を開始してください。

ブックマーク

ブックマークがありません

インターフェース

認証情報

設定のリセット

進捗、ブックマーク、表示設定、認証情報を含むすべての保存データを削除します。

詳細設定

IBM Cloud Code Engine

独自のCode Engineインスタンスを接続してクラウドでコードを実行できます。

セットアップ手順
  1. cloud.ibm.comでIBM Cloudアカウントを作成してください（無料ティアあり）
  2. IBM Cloud Code Engine consoleに移動し、希望のリージョンに新しいプロジェクトを作成してください
  3. イメージghcr.io/janlahmann/doqumentation-codeengine:latest、リスニングポート8080で新しいアプリケーションを作成してください
    サイジング: シングルユーザーは1 vCPU / 2 GB、ワークショップ（最大80名）は8 vCPU / 16 GB
  4. 環境変数を設定してください: JUPYTER_TOKENにセキュアなトークン（最低32文字）、CORS_ORIGINにドメイン（例: https://doqumentation.org）

ワークショップのサイジングの詳細については、ワークショップセットアップドキュメントをご覧ください。

Binderパッケージ

GitHub Pagesで実行する場合、コードはMyBinder経由で実行されます。Binder環境には、コアQiskitパッケージがプリインストールされています:

qiskit[visualization], qiskit-aer,
qiskit-ibm-runtime, pylatexenc,
qiskit-ibm-catalog, qiskit-addon-utils, pyscf

一部のノートブックには追加のパッケージが必要です。コードセルで次のコマンドを実行することで、オンデマンドでインストールできます:

!pip install -q <package>

または、すべてのオプションパッケージを一度にインストールします:

!pip install -q scipy scikit-learn qiskit-ibm-transpiler \
  qiskit-experiments plotly sympy qiskit-serverless \
  qiskit-addon-sqd qiskit-addon-mpf \
  qiskit-addon-aqc-tensor[aer,quimb-jax] \
  qiskit-addon-obp qiskit-addon-cutting ffsim \
  gem-suite python-sat

セットアップヘルプ

RasQberryセットアップ

RasQberryはdoQumentationコンテナを実行します（下のDockerセットアップを参照）。Piのアドレスのポート8080からサイトを開くと、追加の設定なしでPi上でコードが実行されます。

オフラインワークショップガイド：1台のRaspberry Piで授業を行う

ローカルJupyterセットアップ

このサイトのみを受け入れるJupyterサーバーを、任意のトークンで起動し、そのURLとトークンを上のカスタムサーバーに入力してください:

jupyter server --ServerApp.token='choose-a-long-token' \
  --ServerApp.allow_origin='https://doqumentation.org' \
  --ServerApp.disable_check_xsrf=True

Dockerセットアップ

Dockerコンテナは起動時にランダムなJupyterトークンを生成します。ウェブサイト(ポート8080)を介したコード実行は自動的に機能します — トークンは不要です。トークンは、ポート8888での直接JupyterLabアクセスにのみ必要です。

コンテナログからトークンを取得するには:

podman logs doq | grep "Jupyter token"

固定トークンを設定するには:

podman run -d --name doq --restart unless-stopped \
  -e JUPYTER_TOKEN=choose-a-token \
  -p 8080:80 -p 127.0.0.1:8888:8888 \
  ghcr.io/janlahmann/doqumentation:jupyter

リモートサーバー

リモートサーバーの場合、このサイトからの接続を許可するようにCORSが設定されていることを確認してください。jupyter_server_config.pyに以下を追加してください:

c.ServerApp.allow_origin = 'https://doqumentation.org'
c.ServerApp.allow_credentials = True