File: quantum_ml_workshop/20260814/lab_01/AAREADME.txt
Tool: The NEDC QML Workshop, Lab 01: Quantum Computing with Qiskit
Version: 1.0.0

-------------------------------------------------------------------------------
Change Log:

20260813 (AM): initial version

-------------------------------------------------------------------------------
SUMMARY

Lab 01 is the hands-on companion to the quantum computing lecture. In the talk
we said the whole story is one move: manipulate probability distributions with
reversible linear transformations. In this lab you actually do it.

You build circuits in Qiskit, look at a qubit on the Bloch sphere, run circuits
on the Aer simulator, read out measurements and observables, watch interference
cancel a wrong answer, and create an entangled Bell pair. The lab closes by
asking how similar two quantum states are as you move their inputs apart, which
is the idea Lab 02 is built on.

The notebook is organized into four sections. Each one teaches an idea, runs
the code, gives you an exercise, and then shows the solution.

  Section 1  First quantum circuit: qubits, the statevector, the Bloch
             sphere, measurement, and observables
  Section 2  One-qubit gates: Pauli-X, Hadamard, and the phase shift
  Section 3  Interference: tuning a phase until the wrong answer cancels
  Section 4  Two qubits: CNOT, the Bell pair, and similarity between states

A. WHAT'S NEW

Version 1.0.0:
  + initial release

B. INSTALLATION REQUIREMENTS

See section B of the AAREADME.txt in the parent directory. In short, either
select the nedc_03.11 kernel, which already has everything installed and
tested, or build your own environment from requirements.txt.

This lab needs pylatexenc for the circuit drawings and ipywidgets for the
interactive sliders. Both are in requirements.txt. If a circuit drawing or a
slider fails, one of those two is missing.

C. USER'S GUIDE

The lab directory contains:

  lab_01/
    AAREADME.txt      this file
    l01_v00.ipynb     the lab notebook

To run the lab:

  1. open l01_v00.ipynb in VS Code or Jupyter
  2. select the nedc_03.11 kernel, or your own environment
  3. run the version check cell at the top; if the versions print, you are
     on the right kernel
  4. work through the notebook from top to bottom

Notes:

  (1) Run the cells in order. Later cells use variables and helper functions
      defined in earlier ones.

  (2) Try each exercise before opening the solution below it. The exercises
      are short and the point is to predict what will happen first.

  (3) Everything runs on a simulator on your own machine. No quantum
      computer and no account are needed for this lab.

  (4) If you want to start over, use "Restart Kernel and Run All Cells".

-------------------------------------------------------------------------------
If you have any additional comments or questions about this lab, please direct
them to help@nedcdata.org. We will do our best to answer them.

Best regards,

Joe Picone
Sadia Afrin Purba
Abdullah Al Mamun

Copyright (c) 2026 Dr. Joseph Picone and the Neural Engineering Data
Consortium (NEDC), Temple University. All rights reserved.
