From e82c27d80017c6527dd9c8da016d598472357571 Mon Sep 17 00:00:00 2001
From: pablosuvi
Date: Fri, 24 Jul 2026 11:29:46 +0100
Subject: [PATCH 1/2] Update README
---
README.md | 50 +++++++++++++++++++++++++++++++++++++++-
docs/diagram_readme.png | Bin 0 -> 304126 bytes
2 files changed, 49 insertions(+), 1 deletion(-)
create mode 100644 docs/diagram_readme.png
diff --git a/README.md b/README.md
index 018d9c2..002f4df 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,50 @@
# qkernel
-Kernel methods for quantum computing
+`qkernel` is a package for running quantum kernel models.
+
+The quantum kernel is based on a analogue computing framework as introduced by Henry et al. (for details see [here](https://arxiv.org/pdf/2107.03247) and [here](https://journals.aps.org/pra/abstract/10.1103/PhysRevA.107.042615)).
+
+
+## Installation
+
+This project uses [uv](https://docs.astral.sh/uv/) for dependency management.
+
+1. Install uv (if you don't have it already):
+ \`\`\`bash
+ curl -LsSf https://astral.sh/uv/install.sh | sh
+ \`\`\`
+
+2. Clone the repository and install dependencies:
+ \`\`\`bash
+ git clone git@github.com:ICHEC/qkernel.git
+ cd qkernel
+ uv sync
+ \`\`\`
+
+ > Note: `qkernel4eo` is installed directly from its private GitHub repo over SSH, so make sure your SSH key is set up with GitHub before running `uv sync`.
+
+3. Run commands within the environment using `uv run`, e.g.:
+ \`\`\`bash
+ uv run pytest
+ \`\`\`
+
+
+## Repository Contents
+
+The source code is contained in `qkernel`. Some of the more important files in there are:
+
+
+- `hamiltonian.py`: Class for hamiltonian construction out of graphs.
+- `kernel.py`: Class for generating kernels out of probability distributions.
+- `model.py`: Class for implementing kernel models.
+- `pipeline.py`: Class for implementing a pipeline with all necessary steps.
+Tutorial on how to use the pipeline can be found in [here](docs/tutorials/pipeline.ipynb).
+- `simulator.py`: Class for simulating neutral atom devices.
+- `utils.py`: Class with different utility functions.
+
+### Analogue Quantum Kernel
+
+The quantum kernel computed here is designed for analogue quantum computers, a common choice of modality for implementing this is neutral atom quantum computers. The main idea here (as developed by Henry et al.) is to encode the feature vector data into the positions and topology of the qubits. A constant pulse is then applied to the system and it is left to evolve up to some specfied time. The states of the qubits are then measured and from this a probability distribution can be constructed (for example the distribution of the total number of excitations). Using a probability similarity measure, for example the Jensen–Shannon divergence, the similarity between the distributions can be computed and a suitable kernel for a kernel classification method can be created.The full workflow is shown in the diagram below.
+
+
+
+
diff --git a/docs/diagram_readme.png b/docs/diagram_readme.png
new file mode 100644
index 0000000000000000000000000000000000000000..54d536b84f1e052981607f00ba302206f297691a
GIT binary patch
literal 304126
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