Lumaktaw sa pangunahing nilalaman

⚙️ doQumentation Settings

I-configure po ang Jupyter server na ginagamit para mag-execute ng Python code sa mga tutorials.

Kasalukuyang Environment:

Simulator Modeⓘ

I-enable po para patakbuhin ang mga notebooks nang walang IBM Quantum account. Lahat ng QiskitRuntimeService calls ay iri-redirect sa local simulator. Walang kailangang modifications sa cells. Ito ay para lamang sa embedded code execution sa site na ito — ang pagbubukas ng notebook sa JupyterLab ay gumagamit ng standard Qiskit runtime.

Ang mga transpiled circuits at backend-specific results ay magkakaiba sa tunay na hardware kapag gumagamit ng simulator mode. Ang static expected outputs na ipinapakita sa mga pahina ay sumasalamin sa tunay na IBM backends.

Display Preferences

Code Font Size

14px
from qiskit import QuantumCircuit

Pre-computed Outputs

Bawat notebook page ay nagpapakita ng pre-computed outputs (mga larawan, talahanayan, teksto) mula sa orihinal na runs ng IBM. Kapag nag-click kayo ng Run para mag-execute ng code live, parehong ipinapakita ang orihinal na outputs at ang inyong mga bagong live results. I-enable po ang toggle na ito para itago ang orihinal na outputs sa panahon ng live execution, na pinapanatili lang ang inyong mga resulta.

Python Warnings

By default, ang Python warnings (mga deprecation notices, runtime hints) ay naka-suppress para sa mas malinis na notebook output. I-disable po ito para makita ang lahat ng warnings — kapaki-pakinabang para sa debugging o pag-aaral tungkol sa mga API changes.

Learning Progress

Ang inyong reading at execution progress ay sinusubaybayan nang lokal sa inyong browser. Ang mga binisitang pahina ay may ✓ sa sidebar; ang mga na-execute na notebooks ay may ▶.

Walang progress na sinusubaybayan pa. Bumisita po sa mga tutorials at guides para magsimula ng tracking.

Iba Pa

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 Account

Paalala sa seguridad: Ang credentials ay naka-store sa localStorage ng inyong browser bilang plain text. Hindi ito naka-encrypt at maaaring basahin ng mga browser extensions o sinumang may access sa device na ito. Gamitin po ang expiry setting sa ibaba para limitahan ang exposure, at i-delete ang credentials kapag tapos na kayo. Para sa shared o public computers, mas mainam pong gamitin ang manual save_account() method na inilarawan sa ibaba.

Ilagay po ang inyong IBM Quantum credentials minsan lang dito. Awtomatiko itong isi-inject sa pamamagitan ng save_account() kapag nagsimula ang kernel, kaya hindi na ninyo kailangang ilagay ito sa bawat notebook. Ito ay para lamang sa embedded code execution sa site na ito — ang pagbubukas ng notebook sa JupyterLab ay nangangailangan ng manual na pagtawag ng save_account().

  1. Magrehistro sa quantum.cloud.ibm.com/registration — walang credit card na kailangan para sa unang 30 araw
  2. Mag-sign in sa quantum.cloud.ibm.com
  3. Instance — Gumawa po ng libreng Open Plan instance sa Mga Instance kung wala pa kayo
  4. API Token — I-click po ang inyong profile icon (taas kanan), pagkatapos "API token". I-copy ang key.
  5. CRN — I-copy po ang CRN string mula sa inyong Mga Instance page

Para sa detalyadong mga hakbang, tingnan po ang I-setup ang authentication guide ng IBM (step 2).

Alternative: Patakbuhin ang save_account() nang manual sa notebook cell

Kung ayaw ninyong mag-store ng credentials sa browser na ito, i-paste ito sa kahit anong code cell at patakbuhin. Ang credentials ay naka-save sa temporary storage ng Binder kernel at nawawala kapag natapos ang session.

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

Binder Packages

Kapag tumatakbo sa GitHub Pages, ang code ay tumatakbo sa pamamagitan ng MyBinder. Ang Binder environment ay may mga pre-installed na core Qiskit packages:

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

Ang ilang notebooks ay nangangailangan ng karagdagang packages. Maaari po ninyong i-install ang mga ito on demand sa pamamagitan ng pagpapatakbo nito sa isang code cell:

!pip install -q <package>

O i-install ang lahat ng optional packages nang sabay-sabay:

!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

Advanced

Ang base URL ng inyong Jupyter server (hal., http://localhost:8888)
Token mula sa jupyter server --generate-config o ipinapakita sa startup

Setup Help

RasQberry Setup

Kung tumatakbo kayo sa RasQberry Pi, ang Jupyter server ay dapat awtomatikong ma-detect. Kung hindi, tiyakin po na tumatakbo ang jupyter-tutorials service:

sudo systemctl status jupyter-tutorials

Local Jupyter Setup

Magsimula po ng Jupyter server na may enabled na CORS:

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

Docker Setup

Ang Docker container ay bumubuo ng random Jupyter token sa startup. Ang code execution sa pamamagitan ng website (port 8080) ay awtomatikong gumagana — walang kailangang token. Ang token ay kinakailangan lamang para sa direktang JupyterLab access sa port 8888.

Para kunin ang token mula sa container logs:

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

Para magtakda ng fixed token:

JUPYTER_TOKEN=mytoken docker compose --profile jupyter up

Remote Server

Para sa mga remote servers, tiyakin po na ang CORS ay naka-configure para payagan ang mga connections mula sa site na ito. Idagdag po ang sumusunod sa inyong jupyter_server_config.py:

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