KET Studio’ni amalda ishlating.

15 daqiqada birinchi natija.

1. Downloads sahifasidan Windows x64 MSIX’ni oling. Self-signed paket bo‘lsa, certificate’ni Trusted People store’ga o‘rnating; ishonch muammosida EXE fallback’dan foydalaning.
2. KET Studio’ni oching va Settings’da Python interpreter’ni tekshiring. Birinchi setup virtual environment yaratadi va kerakli package’larni o‘rnatadi.
3. Yangi project papkasini oching, `.py` fayl yarating va Editor’da kod yozing.
4. Run tugmasini bosing. stdout/stderr Terminal’da, `KET_VIZ` event’lari esa Visualization panelida ko‘rinadi.

Papka va interpreter qanday ishlaydi?

KET Studio tanlangan script joylashgan papkani project root sifatida ishlatadi. `.ket/out` output artifact’lar, `.ket/temp` launcher va vaqtinchalik fayllar uchun yaratiladi.

Terminal, Editor va Visualization birga.

Oddiy print loglari Terminal’da qoladi. Event chiqishi uchun `ket_viz` API’sidan foydalaning. Bir eventdan keyin output darhol ko‘rinsin desangiz, launcher JSON’ni `flush=True` bilan chiqaradi.

import ket_viz

print('Starting experiment')
ket_viz.estimator({'qubits': 2, 'depth': 2, 'total_gates': 2})
ket_viz.metrics({'status': 'running', 'seed': 20260914})
ket_viz.histogram({'00': 510, '11': 514}, title='Final counts')
print('Done')

Kutiladigan natija: Terminal’da uchta print/log qatori, Visualization’da estimator, metrics va histogram event’lari.

Natijani panelga uzatish kodlari.

Quyidagi API’lar KET Studio’da to‘g‘ridan-to‘g‘ri ishlaydi. Har bir event JSON-safe qiymatlardan tuzilishi kerak: string, number, boolean, list yoki object.

import ket_viz

counts = {'00': 510, '01': 2, '10': 4, '11': 508}
ket_viz.histogram(counts, title='Measurement distribution')

import ket_viz

matrix = [[1.0, 0.2, 0.0],
          [0.2, 0.8, 0.1],
          [0.0, 0.1, 0.4]]
ket_viz.heatmap(matrix, title='Qubit correlation')

import ket_viz

energies = [0.50, 0.31, 0.18, 0.09, 0.04]
ket_viz.chart(energies, title='VQE convergence')

import ket_viz

rows = [['Metric', 'Value'],
        ['Qubits', 4],
        ['Shots', 1024],
        ['Fidelity', 0.998]]
ket_viz.table('Experiment summary', rows)

import ket_viz

amplitudes = [
  {'label': '00', 'mag': 0.707, 'phase': 0.0},
  {'label': '11', 'mag': 0.707, 'phase': 3.14159},
]
ket_viz.statevector(amplitudes, title='Bell amplitudes')

import ket_viz

frames = [
  {'gate': 'H(0)', 'state_description': 'Superposition',
   'bloch': [{'theta': 1.57, 'phi': 0.0}]},
]
ket_viz.inspector('Algorithm steps', frames)
ket_viz.bloch({'theta': 1.57, 'phi': 0.0})

import ket_viz

ket_viz.metrics({
  'status': 'optimizing',
  'step': 12, 'energy': -1.1372,
  'seed': 20260914, 'backend': 'AerSimulator'
})

import ket_viz

ket_viz.estimator({
  'qubits': 8, 'depth': 42,
  'total_gates': 180,
  'gate_counts': {'H': 8, 'CX': 64, 'RZ': 108}
})

import ket_viz

ket_viz.image('.ket/out/landscape.png', title='Cost landscape')
ket_viz.circuit('.ket/out/circuit.png', title='Rendered circuit')

Har qanday Python yoki boshqa til bilan.

`ket_viz` ishlamaydigan holatda stdout’ga bitta UTF-8 qator qilib `KET_VIZ ` + JSON chiqaring. JSON boshqa log bilan bir qatorga aralashmasin.

import json

event = {
  'kind': 'histogram',
  'payload': {
    'histogram': {'0': 490, '1': 534},
    'title': 'Raw protocol'
  }
}
print('KET_VIZ ' + json.dumps(event), flush=True)

Parser `kind` bo‘yicha renderer tanlaydi. Noma’lum kind fallback event sifatida saqlanadi, malformed yoki oversize event esa warning bilan cheklanadi.

Qancha data foydali bo‘lib qoladi?

Limitlar ilmiy hisobni to‘xtatish uchun emas, UI’ni himoya qilish uchun. Katta result’ni diskka saqlang, UI’ga esa sparse yoki agregatsiyalangan ko‘rinishni yuboring.

VS Code’ga yaqin local shell.

Windows desktop’da Terminal paneli xterm3 UI va ConPTY native host bilan ishlaydi. Shell komandalarini yozing, ANSI ranglarni ko‘ring, terminalni resize qiling yoki Ctrl+C bilan process’ni to‘xtating.

python --version
where python
python your_experiment.py
python -m pip freeze

• Web preview shell ochmaydi; bu xavfsizlik chegarasi.
• Run action script process’ini alohida boshqaradi; Terminal qo‘lda berilgan komandalar uchun qoladi.
• Process tugagach session history’da event’lar bounded holatda qoladi.

Natijani publication-grade qilish uchun.

KET Studio exploratory research, education va prototyping uchun mos. Ilmiy da’vo uchun quyidagi metadata’ni har run bilan saqlang:

• Git commit va script SHA-256
• Python version va `pip freeze` snapshot
• backend, qubits, depth, shots, optimizer va seed
• raw counts, metrics, logs va visual artifacts
• KET Studio version, OS va qayta ishga tushirish yozuvi

Ishlamasa qayerdan boshlash kerak?

To‘liq formal field’lar uchun repository’dagi `docs/event_schema.md`, amaliy API uchun `docs/visualization-guide.md`, development va release uchun `docs/development.md` hamda `docs/windows-installer.md`ni o‘qing.