Zum Hauptinhalt springen

⚙️ doQumentation-Einstellungen

Konfigurieren Sie den Jupyter-Server, der für die Ausführung von Python-Code in Tutorials verwendet wird.

Aktuelle Umgebung:

Simulator-Modusⓘ

Aktivieren Sie dies, um Notebooks ohne IBM Quantum-Konto auszuführen. Alle QiskitRuntimeService-Aufrufe werden zu einem lokalen Simulator umgeleitet. Keine Zellenänderungen erforderlich. Dies gilt nur für die eingebettete Code-Ausführung auf dieser Website — das Öffnen eines Notebooks in JupyterLab verwendet die Standard-Qiskit-Laufzeit.

Transpilierte Schaltkreise und Backend-spezifische Ergebnisse unterscheiden sich von echter Hardware bei Verwendung des Simulator-Modus. Statische erwartete Ausgaben, die auf den Seiten angezeigt werden, spiegeln echte IBM-Backends wider.

Anzeigeeinstellungen

Code-Schriftgröße

14px
from qiskit import QuantumCircuit

Vorberechnete Ausgaben

Jede Notebook-Seite zeigt vorberechnete Ausgaben (Bilder, Tabellen, Text) aus IBMs Originalläufen. Wenn Sie auf Run klicken, um Code live auszuführen, werden sowohl die Originalausgaben als auch Ihre neuen Live-Ergebnisse nebeneinander angezeigt. Aktivieren Sie diese Umschaltung, um die Originalausgaben während der Live-Ausführung auszublenden und nur Ihre Ergebnisse sichtbar zu halten.

Python-Warnungen

Standardmäßig werden Python-Warnungen (Deprecation-Hinweise, Laufzeit-Hinweise) für eine sauberere Notebook-Ausgabe unterdrückt. Deaktivieren Sie dies, um alle Warnungen zu sehen — nützlich zum Debuggen oder zum Lernen über API-Änderungen.

Lernfortschritt

Ihr Lese- und Ausführungsfortschritt wird lokal in Ihrem Browser verfolgt. Besuchte Seiten zeigen ein ✓ in der Seitenleiste; ausgeführte Notebooks zeigen ein ▶.

Noch kein Fortschritt verfolgt. Besuchen Sie Tutorials und Leitfäden, um mit der Verfolgung zu beginnen.

Sonstiges

Advanced Settings

IBM Cloud Code Engine

Code Engine provides a fast, serverless Jupyter kernel powered by your own IBM Cloud account. Startup takes seconds instead of minutes. Free tier covers ~14 hours/month.

Setup Instructions
  1. Create an IBM Cloud account at cloud.ibm.com (free tier available)
  2. Create a Code Engine project in your preferred region
  3. Deploy a new application with image ghcr.io/janlahmann/doqumentation-codeengine:latest, port 8080
  4. Set environment variable JUPYTER_TOKEN to a secure token (min 32 characters) and CORS_ORIGIN to your domain
Join Workshop

Enter the workshop URL and token provided by your instructor. This connects you to the workshop's Code Engine instance.

IBM Quantum-Konto

Sicherheitshinweis: Anmeldedaten werden im localStorage Ihres Browsers als Klartext gespeichert. Sie sind nicht verschlüsselt und können von Browser-Erweiterungen oder jedem mit Zugriff auf dieses Gerät gelesen werden. Verwenden Sie die unten stehende Ablaufeinstellung, um die Exposition zu begrenzen, und löschen Sie die Anmeldedaten, wenn Sie fertig sind. Für gemeinsam genutzte oder öffentliche Computer bevorzugen Sie stattdessen die manuelle save_account()-Methode, die unten beschrieben ist.

Geben Sie Ihre IBM Quantum-Anmeldedaten einmal hier ein. Sie werden automatisch über save_account() eingefügt, wenn der Kernel startet, sodass Sie sie nicht in jedem Notebook eingeben müssen. Dies gilt nur für die eingebettete Code-Ausführung auf dieser Website — das Öffnen eines Notebooks in JupyterLab erfordert das manuelle Aufrufen von save_account().

  1. Registrieren unter quantum.cloud.ibm.com/registration — keine Kreditkarte erforderlich für die ersten 30 Tage
  2. Anmelden unter quantum.cloud.ibm.com
  3. Instanz — Erstellen Sie eine kostenlose Open Plan-Instanz unter Instanzen, falls Sie noch keine haben
  4. API Token — Klicken Sie auf Ihr Profilsymbol (oben rechts), dann "API token". Kopieren Sie den Schlüssel.
  5. CRN — Kopieren Sie die CRN-Zeichenfolge von Ihrer Instanzen-Seite

Für detaillierte Schritte siehe IBMs Authentifizierung einrichten-Leitfaden (Schritt 2).

Alternative: save_account() manuell in einer Notebook-Zelle ausführen

Wenn Sie es vorziehen, keine Anmeldedaten in diesem Browser zu speichern, fügen Sie dies in eine beliebige Codezelle ein und führen Sie sie aus. Anmeldedaten werden im temporären Speicher des Binder-Kernels gespeichert und gehen verloren, wenn die Sitzung endet.

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

Binder-Pakete

Beim Ausführen auf GitHub Pages wird Code über MyBinder ausgeführt. Die Binder-Umgebung enthält vorinstallierte Qiskit-Kernpakete:

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

Einige Notebooks benötigen zusätzliche Pakete. Sie können sie bei Bedarf installieren, indem Sie dies in einer Codezelle ausführen:

!pip install -q <package>

Oder alle optionalen Pakete auf einmal installieren:

!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

Erweitert

Die Basis-URL Ihres Jupyter-Servers (z. B. http://localhost:8888)
Token von jupyter server --generate-config oder beim Start angezeigt

Einrichtungshilfe

RasQberry-Einrichtung

Wenn Sie auf einem RasQberry Pi ausführen, sollte der Jupyter-Server automatisch erkannt werden. Falls nicht, stellen Sie sicher, dass der jupyter-tutorials-Service läuft:

sudo systemctl status jupyter-tutorials

Lokale Jupyter-Einrichtung

Starten Sie einen Jupyter-Server mit aktiviertem CORS:

jupyter server --ServerApp.token='rasqberry' \
  --ServerApp.allow_origin='*' \
  --ServerApp.disable_check_xsrf=True

Docker-Einrichtung

Der Docker-Container generiert beim Start ein zufälliges Jupyter-Token. Die Code-Ausführung über die Website (Port 8080) funktioniert automatisch — kein Token erforderlich. Das Token wird nur für den direkten JupyterLab-Zugriff auf Port 8888 benötigt.

Um das Token aus den Container-Logs abzurufen:

docker compose --profile jupyter logs | grep "Jupyter token"

Um ein festes Token festzulegen:

JUPYTER_TOKEN=mytoken docker compose --profile jupyter up

Remote-Server

Stellen Sie für Remote-Server sicher, dass CORS konfiguriert ist, um Verbindungen von dieser Website zuzulassen. Fügen Sie Folgendes zu Ihrer jupyter_server_config.py hinzu:

c.ServerApp.allow_origin = '*'
c.ServerApp.allow_credentials = True