# walid-mk/qiskitfallfest_emsi_quantumafrica architecture

> Architecture diagram of the GitHub repository walid-mk/qiskitfallfest_emsi_quantumafrica, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/walid-mk/qiskitfallfest_emsi_quantumafrica
- Repository: https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica

## Overview

This repository is a hands-on crop-classification challenge: participants explore supplied satellite-feature data, prepare a training-only feature view, compare classical and quantum/hybrid models, evaluate validation predictions, and submit a fitted model. The sampled Python modules implement checked data loading, model interfaces, a reference SVM, metrics, reproducible training-size experiments, and opt-in IBM inference. The README also documents the notebook-led exploration and saved result comparisons. Notebook internals were not sampled, so those links reflect documented capabilities rather than inspected calls.

Main entry points: [`notebooks/Qiskit_QuantumAfrica_Crop_Challenge.ipynb`](https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/notebooks/Qiskit_QuantumAfrica_Crop_Challenge.ipynb) (Challenge notebook), [`challenge/coverage.py`](https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/challenge/coverage.py) (Training-size experiments), [`challenge/models.py`](https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/challenge/models.py) (QNN and classical control), [`challenge/data.py`](https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/challenge/data.py) (Data loader checks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_explore["Challenge workflow"]
  node_challenge_notebook["Challenge notebook"]
end

subgraph group_data["Data and preparation"]
  node_data_release[("Crop data release")]
  node_data_checks["Data loader checks<br/>[data.py]"]
  node_feature_prep["Feature preparation"]
  node_pca_views["PCA feature views"]
end

subgraph group_models["Modeling"]
  node_classical_reference["RBF SVM reference<br/>[classical.py]"]
  node_quantum_models["QNN and classical control<br/>[models.py]"]
  node_submission_api["Submission interface<br/>[submission.py]"]
end

subgraph group_evaluation["Evaluation and inference"]
  node_coverage_experiments["Training-size experiments<br/>[coverage.py]"]
  node_metric_scoring["Classification metrics<br/>[metrics.py]"]
  node_saved_runs["Saved predictions and runs"]
  node_hardware_inference["Opt-in hardware inference<br/>[hardware.py]"]
end

node_participant(("Participant"))
node_ibm_backend{{"IBM quantum backend"}}

node_participant -->|"works through"| node_challenge_notebook
node_challenge_notebook -->|"explores"| node_data_release
node_data_checks -->|"loads and validates"| node_data_release
node_challenge_notebook -->|"prepares features"| node_feature_prep
node_feature_prep -->|"uses prepared views"| node_pca_views
node_coverage_experiments -->|"loads training data"| node_data_checks
node_coverage_experiments -->|"fits reference"| node_classical_reference
node_coverage_experiments -->|"fits alternatives"| node_quantum_models
node_submission_api -->|"inherits classifier"| node_quantum_models
node_coverage_experiments -->|"scores predictions"| node_metric_scoring
node_quantum_models -->|"validates probabilities"| node_metric_scoring
node_challenge_notebook -->|"compares saved results"| node_saved_runs
node_challenge_notebook -->|"documents interface"| node_submission_api
node_quantum_models -.->|"provides trained circuit"| node_hardware_inference
node_hardware_inference -->|"runs inference"| node_ibm_backend

click node_challenge_notebook "https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/notebooks/Qiskit_QuantumAfrica_Crop_Challenge.ipynb"
click node_data_release "https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/tree/main/data"
click node_data_checks "https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/challenge/data.py"
click node_feature_prep "https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/notebooks/Qiskit_QuantumAfrica_Crop_Challenge.ipynb"
click node_pca_views "https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/tree/main/data/views"
click node_classical_reference "https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/challenge/classical.py"
click node_quantum_models "https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/challenge/models.py"
click node_submission_api "https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/challenge/submission.py"
click node_coverage_experiments "https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/challenge/coverage.py"
click node_metric_scoring "https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/challenge/metrics.py"
click node_saved_runs "https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/tree/main/results"
click node_hardware_inference "https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/challenge/hardware.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_challenge_notebook toneBlue
class node_data_release,node_data_checks,node_feature_prep,node_pca_views toneAmber
class node_classical_reference,node_quantum_models,node_submission_api toneMint
class node_coverage_experiments,node_metric_scoring,node_saved_runs,node_hardware_inference toneRose
class node_participant,node_ibm_backend toneIndigo
```

## Components

### Challenge workflow

- [Challenge notebook](https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/notebooks/Qiskit_QuantumAfrica_Crop_Challenge.ipynb): `notebooks/Qiskit_QuantumAfrica_Crop_Challenge.ipynb`

### Data and preparation

- [Crop data release](https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/tree/main/data): `data`
- [Data loader checks](https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/challenge/data.py): `challenge/data.py`
- [Feature preparation](https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/notebooks/Qiskit_QuantumAfrica_Crop_Challenge.ipynb): `notebooks/Qiskit_QuantumAfrica_Crop_Challenge.ipynb`
- [PCA feature views](https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/tree/main/data/views): `data/views`

### Modeling

- [RBF SVM reference](https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/challenge/classical.py): `challenge/classical.py`
- [QNN and classical control](https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/challenge/models.py): `challenge/models.py`
- [Submission interface](https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/challenge/submission.py): `challenge/submission.py`

### Evaluation and inference

- [Training-size experiments](https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/challenge/coverage.py): `challenge/coverage.py`
- [Classification metrics](https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/challenge/metrics.py): `challenge/metrics.py`
- [Saved predictions and runs](https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/tree/main/results): `results`
- [Opt-in hardware inference](https://github.com/walid-mk/qiskitfallfest_emsi_quantumafrica/blob/main/challenge/hardware.py): `challenge/hardware.py`

### Other components

- **Participant**
- **IBM quantum backend**

## Connections

- Participant → Challenge notebook: works through (evidence: `README.md`)
- Challenge notebook → Crop data release: explores (evidence: `README.md`)
- Data loader checks → Crop data release: loads and validates (evidence: `challenge/data.py`)
- Challenge notebook → Feature preparation: prepares features (evidence: `README.md`)
- Feature preparation → PCA feature views: uses prepared views (evidence: `README.md`)
- Training-size experiments → Data loader checks: loads training data (evidence: `challenge/coverage.py`)
- Training-size experiments → RBF SVM reference: fits reference (evidence: `challenge/coverage.py`)
- Training-size experiments → QNN and classical control: fits alternatives (evidence: `challenge/coverage.py`)
- Submission interface → QNN and classical control: inherits classifier (evidence: `challenge/submission.py`)
- Training-size experiments → Classification metrics: scores predictions (evidence: `challenge/coverage.py`)
- QNN and classical control → Classification metrics: validates probabilities (evidence: `challenge/models.py`)
- Challenge notebook → Saved predictions and runs: compares saved results (evidence: `README.md`)
- Challenge notebook → Submission interface: documents interface (evidence: `README.md`)
- QNN and classical control → Opt-in hardware inference: provides trained circuit
- Opt-in hardware inference → IBM quantum backend: runs inference (evidence: `challenge/hardware.py`)
