انتقل إلى المحتوى الرئيسي

⚙️ إعدادات doQumentation

قم بتكوين خادم Jupyter المستخدم لتنفيذ تعليمات Python البرمجية في البرامج التعليمية.

البيئة الحالية: غير مكتشف

خلفية الخادم

اختر الخلفية المستخدمة لتنفيذ التعليمات البرمجية:

وضع التنفيذⓘ

اختر ما يحدث عند النقر على تشغيل في صفحات البرامج التعليمية. ينطبق هذا فقط على تنفيذ التعليمات البرمجية المضمنة في هذا الموقع — فتح دفتر ملاحظات في JupyterLab يستخدم وقت تشغيل Qiskit القياسي.

تسري التغييرات في جلسة النواة التالية. إذا كانت التعليمات البرمجية قيد التشغيل، انقر رجوع ثم تشغيل للتطبيق.

حساب IBM Quantum

تعليمات الإعداد وملاحظات الأمان
ملاحظة أمنية: يتم تخزين بيانات الاعتماد في localStorage للمتصفح كنص عادي. لا يتم تشفيرها ويمكن قراءتها بواسطة ملحقات المتصفح أو أي شخص لديه وصول إلى هذا الجهاز. استخدم إعداد انتهاء الصلاحية أدناه للحد من التعرض، واحذف بيانات الاعتماد عند الانتهاء. بالنسبة لأجهزة الكمبيوتر المشتركة أو العامة، يُفضل استخدام طريقة 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.

إدارة بياناتك

جميع البيانات مخزنة محليًا في متصفحك (localStorage). لا يُرسل شيء إلى خوادمنا. مسح بيانات المتصفح أو استخدام متصفح/جهاز مختلف يبدأ من الصفر.

تقدم التعلم

يتم تتبع تقدم القراءة والتنفيذ الخاص بك محليًا في متصفحك. تعرض الصفحات التي تمت زيارتها ✓ في الشريط الجانبي؛ تعرض دفاتر الملاحظات المنفذة ▶.

لم يتم تتبع أي تقدم بعد. قم بزيارة البرامج التعليمية والأدلة لبدء التتبع.

الإشارات المرجعية

لا توجد إشارات مرجعية بعد. استخدم زر الإشارة المرجعية في أي صفحة لحفظها هنا.

العرض والواجهة

الجلسات وبيانات الاعتماد

إعادة تعيين كل شيء

إزالة جميع البيانات المحفوظة بما في ذلك التقدم والإشارات المرجعية وتفضيلات العرض وبيانات الاعتماد.

الإعدادات المتقدمة

IBM Cloud Code Engine

يوفر IBM Cloud Code Engine نواة Jupyter سريعة وبدون خادم مدعومة بحساب IBM Cloud الخاص بك. يستغرق التشغيل ثوانٍ بدلاً من دقائق. تغطي الطبقة المجانية ~14 ساعة/شهر.

تعليمات الإعداد
  1. أنشئ حساب IBM Cloud على cloud.ibm.com (الطبقة المجانية متاحة)
  2. اذهب إلى IBM Cloud Code Engine console وأنشئ مشروعًا جديدًا في منطقتك المفضلة
  3. أنشئ تطبيقًا جديدًا بصورة ghcr.io/janlahmann/doqumentation-codeengine:latest، منفذ الاستماع 8080
    التحديد: 1 vCPU / 2 GB لمستخدم واحد، 8 vCPU / 16 GB لورش العمل (حتى 80 مستخدمًا)
  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 Pi، يجب اكتشاف خادم Jupyter تلقائيًا. إذا لم يكن كذلك، تأكد من أن خدمة jupyter-tutorials قيد التشغيل:

sudo systemctl status jupyter-tutorials

إعداد Jupyter المحلي

ابدأ خادم Jupyter مع تمكين CORS:

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

إعداد Docker

يقوم حاوية Docker بإنشاء رمز Jupyter عشوائي عند بدء التشغيل. يعمل تنفيذ التعليمات البرمجية عبر الموقع (المنفذ 8080) تلقائيًا — لا حاجة للرمز. الرمز مطلوب فقط للوصول المباشر إلى JupyterLab على المنفذ 8888.

لاسترداد الرمز من سجلات الحاوية:

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

لتعيين رمز ثابت:

JUPYTER_TOKEN=mytoken docker compose --profile jupyter up

خادم بعيد

بالنسبة للخوادم البعيدة، تأكد من تكوين CORS للسماح بالاتصالات من هذا الموقع. أضف ما يلي إلى jupyter_server_config.py الخاص بك:

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