How notayan1505/retrainable-neural-decoder works
qdrift is a repetition-code neural-decoder experiment: its CLI coordinates loading or generating hardware data, training/comparing decoders, and writing evaluation results. The main data path converts Stein bitstrings into detector tensors and labels; evaluation compares matching and lookup baselines with trained neural models on held-out data. The README also documents fresh fake- or real-IBM runs for drift testing. Connections below follow shown CLI references, source-index references, and explicit README statements; unsampled implementation details are not inferred.
Main entry points: cli.py Command CLI · evaluate.py Evaluation · stein.py Stein loader · circuits.py Repetition circuits
Components 12
Command interface
- Command CLI
qdrift/cli.py
Experiment data
- Stein loader
qdrift/data/stein.py - Detector dataset
qdrift/data/stein.py - Repetition circuits
qdrift/data/circuits.py
Decoder methods
- Baseline decoders
qdrift/decoders/baselines.py - Neural models
qdrift/models/net.py
Training and assessment
- Model training
qdrift/train.py - Evaluation
qdrift/evaluate.py - Result files
results/qdrift
Other components
- Experimenter
- Zenodo dataset
- IBM backends
Connections 15
- Experimenter → Command CLI: runs commands
README.md - Command CLI → Stein loader: loads and parses
qdrift/cli.py - Command CLI → Baseline decoders: runs baseline
qdrift/cli.py - Command CLI → Evaluation: evaluates
qdrift/cli.py - Command CLI → Model training: trains models
qdrift/cli.py - Command CLI → Repetition circuits: runs circuits
qdrift/cli.py - Zenodo dataset → Stein loader: provides raw data
README.md - Stein loader → Detector dataset: derives detectors
qdrift/data/stein.py - Evaluation → Stein loader: loads and splits
qdrift/evaluate.py - Evaluation → Baseline decoders: compares decoders
qdrift/evaluate.py - Evaluation → Model training: uses neural decoder
qdrift/evaluate.py - Model training → Neural models: builds model
qdrift/train.py - Evaluation → Result files: writes CSV
README.md - Repetition circuits → IBM backends: submits circuits
qdrift/data/circuits.py - Repetition circuits → Stein loader: writes parser format
qdrift/data/circuits.py