ข้ามไปยังเนื้อหาหลัก

Quickstart

เวอร์ชันของแพ็กเกจ

โค้ดในหน้านี้พัฒนาโดยใช้ requirements ต่อไปนี้ แนะนำให้ใช้เวอร์ชันนี้หรือใหม่กว่า

qiskit[all]~=2.3.0
# Added by doQumentation — required packages for this notebook
!pip install -q qiskit

สร้าง quantum circuit แรกของคุณในเวลาไม่ถึงสองนาที บนสภาพแวดล้อมในเครื่องของคุณ — ไม่ต้องลงชื่อเข้าใช้หรือมี API key

ยังใหม่กับ Python และ virtual environment?
  • ดาวน์โหลด Python และใช้ virtual environment กับ Qiskit (แนะนำ)
คลิกเพื่อขยายข้อมูลเพิ่มเติมเกี่ยวกับ Python
  • ในการติดตั้ง Python ให้ตรวจสอบส่วน "Programming Language" ใน หน้าโปรเจกต์ Qiskit บน PyPI ก่อน เพื่อดูว่าเวอร์ชัน Python ใดบ้างที่รองรับรุ่นล่าสุด สำหรับคำแนะนำการดาวน์โหลด ดูที่ Python Beginners Guide
หมายเหตุ

คำแนะนำเหล่านี้ใช้ Python distribution มาตรฐานจาก pypi.org อย่างไรก็ตาม คุณสามารถใช้ Python distribution อื่นได้ เช่น Anaconda หรือ miniconda รวมถึง workflow การจัดการ dependency อื่น ๆ เช่น Poetry

คลิกเพื่อขยายข้อมูลเพิ่มเติมเกี่ยวกับ virtual environment

  • ใช้ Python virtual environment เพื่อแยก Qiskit ออกจากแอปพลิเคชันอื่น Python virtual environment คือพื้นที่ทำงานแบบแยกส่วนสำหรับ Python ตามวัตถุประสงค์เฉพาะ — คุณสามารถติดตั้งแพ็กเกจใดก็ได้ตามต้องการ และตั้งค่า library, dependency ต่าง ๆ โดยไม่ส่งผลกระทบต่อสภาพแวดล้อม Python "หลัก" บนเครื่องของคุณ

ข้อดีสำคัญอย่างหนึ่งของ virtual environment คือหากสภาพแวดล้อม Python ของคุณเสียหาย คุณสามารถลบและเริ่มต้นใหม่ได้ง่าย ๆ

เลือกตำแหน่งที่ต้องการเก็บข้อมูล virtual environment ของคุณ โดยปกติจะเก็บไว้ในไดเรกทอรีชื่อ .venv ภายในไดเรกทอรีโปรเจกต์แต่ละอัน

ในการสร้าง virtual environment ให้นำทางไปยังไดเรกทอรีโปรเจกต์ของคุณ แล้วสร้างสภาพแวดล้อมขั้นต่ำที่มีเฉพาะ Python เท่านั้น

python3 -m venv .venv

จากนั้น activate สภาพแวดล้อมใหม่ของคุณ

source .venv/bin/activate

1. ติดตั้ง Qiskit​

ติดตั้งสิ่งต่อไปนี้ด้วย package manager ที่คุณชอบ (เช่น pip):

2. สร้าง Circuit ของคุณ​

เปิดสภาพแวดล้อม Python จากนั้นรันโค้ดนี้เพื่อสร้าง Bell state (Qubit สองตัวที่ entangled กัน)

from qiskit import QuantumCircuit
from qiskit.primitives import StatevectorSampler

qc = QuantumCircuit(2)
qc.h(0)
qc.cx(0, 1)
qc.measure_all()

sampler = StatevectorSampler()
result = sampler.run([qc], shots=1024).result()
print(result[0].data.meas.get_counts())
{'11': 534, '00': 490}

ผลลัพธ์ที่คาดไว้คือการแบ่งเกือบเท่ากันระหว่าง '00' และ '11'

3. แสดงผลลัพธ์​

ในการรับ histogram ของผลลัพธ์ ให้เพิ่มโค้ดต่อไปนี้ในโปรแกรมของคุณ

# Uncomment lines 2 and 8 if you are not using Python in a Jupyter notebook
# import matplotlib.pyplot as plt
from qiskit.visualization import plot_histogram

counts = result[0].data.meas.get_counts()
plot_histogram(counts)

# plt.show()

ผลลัพธ์ของ code cell ก่อนหน้า

ผลลัพธ์นี้เป็นสัญลักษณ์ของ quantum entanglement

4. ดูสิ่งที่เกิดขึ้น​

ลองเปลี่ยนโค้ดเพื่อดูผลกระทบต่อผลลัพธ์ ตัวอย่างเช่น:

  • เพิ่ม Qubit ตัวที่สามโดยเปลี่ยนเป็น QuantumCircuit(3) และเพิ่ม CX Gate ตัวที่สองด้วย qc.cx(1,2) ผลการวัดควรเปลี่ยนเป็น 000 และ 111 ซึ่งหมายความว่า Qubit ทั้งสามตัวถูก entangle เข้าด้วยกัน

  • ดูผลลัพธ์เปลี่ยนแปลงโดยเพิ่ม qc.x(1) ที่ท้าย Circuit

ขั้นตอนถัดไป​

คำแนะนำ
  • ทำตามขั้นตอนใน Hello world เพื่อรัน Circuit บน quantum hardware จริง
  • ยังไม่พร้อมรันบน hardware? เริ่มต้นการเดินทางด้าน quantum กับคอร์ส Basics of quantum information
Source: IBM Quantum docs — updated 16 มี.ค. 2569
English version on doQumentation — updated 7 พ.ค. 2569
This translation based on the English version of 11 มี.ค. 2569