This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/mahout.git
The following commit(s) were added to refs/heads/asf-site by this push:
new ce507a9c4 Automatic Site Publish by Buildbot
ce507a9c4 is described below
commit ce507a9c42cd81a9f6dbc589041164b0dfd186de
Author: GitHub Actions Bot <>
AuthorDate: Thu Jan 22 01:16:34 2026 +0000
Automatic Site Publish by Buildbot
---
feed.xml | 2 +-
qumat/qdp/getting-started/index.html | 122 ++++++++++++++++++++++++++++++++++-
2 files changed, 120 insertions(+), 4 deletions(-)
diff --git a/feed.xml b/feed.xml
index 238fac9e5..cfbbfccce 100644
--- a/feed.xml
+++ b/feed.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><feed
xmlns="http://www.w3.org/2005/Atom"; ><generator uri="https://jekyllrb.com/";
version="4.3.2">Jekyll</generator><link
href="http://mahout.apache.org//feed.xml"; rel="self"
type="application/atom+xml" /><link href="http://mahout.apache.org//";
rel="alternate" type="text/html"
/><updated>2026-01-22T01:15:16+00:00</updated><id>http://mahout.apache.org//feed.xml</id><title
type="html">Apache Mahout</title><subtitle>Distributed Linear
Algebra</subtitle> [...]
+<?xml version="1.0" encoding="utf-8"?><feed
xmlns="http://www.w3.org/2005/Atom"; ><generator uri="https://jekyllrb.com/";
version="4.3.2">Jekyll</generator><link
href="http://mahout.apache.org//feed.xml"; rel="self"
type="application/atom+xml" /><link href="http://mahout.apache.org//";
rel="alternate" type="text/html"
/><updated>2026-01-22T01:16:29+00:00</updated><id>http://mahout.apache.org//feed.xml</id><title
type="html">Apache Mahout</title><subtitle>Distributed Linear
Algebra</subtitle> [...]
<p><a href="mailto:[email protected]";>Subscribe</a> to the
Mahout User list for details on joining.</p>
<h3 id="attendees">Attendees</h3>
diff --git a/qumat/qdp/getting-started/index.html
b/qumat/qdp/getting-started/index.html
index 2d0435d47..e737e2f68 100644
--- a/qumat/qdp/getting-started/index.html
+++ b/qumat/qdp/getting-started/index.html
@@ -173,9 +173,125 @@
<div class="row">
<div class="col-lg-8 markdown-body">
- <h1 id="getting-started">Getting Started</h1>
-
-<!-- TODO: Add getting started guide for QDP -->
+ <h1 id="getting-started-with-qdp">Getting Started with QDP</h1>
+
+<p>QDP (Quantum Data Plane) is a GPU-accelerated library for encoding
classical data into quantum states.</p>
+
+<h2 id="prerequisites">Prerequisites</h2>
+
+<ul>
+ <li>Linux with NVIDIA GPU</li>
+ <li>CUDA toolkit installed (<code class="language-plaintext
highlighter-rouge">nvcc --version</code> to verify)</li>
+ <li>Python 3.10+</li>
+</ul>
+
+<h2 id="installation">Installation</h2>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>pip <span class="nb">install </span>qumat[qdp]
+</code></pre></div></div>
+
+<p>For development (from source):</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>git clone https://github.com/apache/mahout.git
+<span class="nb">cd </span>mahout/qdp/qdp-python
+uv venv <span class="nt">-p</span> python3.10 <span
class="o">&&</span> <span class="nb">source</span> .venv/bin/activate
+uv <span class="nb">sync</span> <span class="nt">--group</span> dev <span
class="o">&&</span> uv run maturin develop
+</code></pre></div></div>
+
+<h2 id="quick-start">Quick Start</h2>
+
+<div class="language-python highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="kn">import</span> <span
class="n">torch</span>
+<span class="kn">from</span> <span class="n">qumat.qdp</span> <span
class="kn">import</span> <span class="n">QdpEngine</span>
+
+<span class="n">engine</span> <span class="o">=</span> <span
class="nc">QdpEngine</span><span class="p">(</span><span
class="mi">0</span><span class="p">)</span> <span class="c1"># GPU device 0
+</span><span class="n">data</span> <span class="o">=</span> <span
class="p">[</span><span class="mf">0.5</span><span class="p">,</span> <span
class="mf">0.5</span><span class="p">,</span> <span class="mf">0.5</span><span
class="p">,</span> <span class="mf">0.5</span><span class="p">]</span>
+<span class="n">qtensor</span> <span class="o">=</span> <span
class="n">engine</span><span class="p">.</span><span
class="nf">encode</span><span class="p">(</span><span
class="n">data</span><span class="p">,</span> <span
class="n">num_qubits</span><span class="o">=</span><span
class="mi">2</span><span class="p">,</span> <span
class="n">encoding_method</span><span class="o">=</span><span
class="sh">"</span><span class="s">amplitude</span><span
class="sh">"</span><span class="p">)</span>
+
+<span class="c1"># Convert to PyTorch (zero-copy)
+</span><span class="n">tensor</span> <span class="o">=</span> <span
class="n">torch</span><span class="p">.</span><span
class="nf">from_dlpack</span><span class="p">(</span><span
class="n">qtensor</span><span class="p">)</span> <span class="c1"># Note: can
only be consumed once
+</span></code></pre></div></div>
+
+<h2 id="encoding-methods">Encoding Methods</h2>
+
+<table>
+ <thead>
+ <tr>
+ <th>Method</th>
+ <th>Constraint</th>
+ <th>Example</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="language-plaintext
highlighter-rouge">amplitude</code></td>
+ <td>data length ≤ 2^num_qubits</td>
+ <td><code class="language-plaintext highlighter-rouge">encode([0.5, 0.5,
0.5, 0.5], num_qubits=2, encoding_method="amplitude")</code></td>
+ </tr>
+ <tr>
+ <td><code class="language-plaintext highlighter-rouge">angle</code></td>
+ <td>data length = num_qubits</td>
+ <td><code class="language-plaintext highlighter-rouge">encode([0.1, 0.2,
0.3, 0.4], num_qubits=4, encoding_method="angle")</code></td>
+ </tr>
+ <tr>
+ <td><code class="language-plaintext highlighter-rouge">basis</code></td>
+ <td>data length = num_qubits</td>
+ <td><code class="language-plaintext highlighter-rouge">encode([1, 0, 1,
1], num_qubits=4, encoding_method="basis")</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="file-inputs">File Inputs</h2>
+
+<div class="language-python highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="n">engine</span><span
class="p">.</span><span class="nf">encode</span><span class="p">(</span><span
class="sh">"</span><span class="s">data.parquet</span><span
class="sh">"</span><span class="p">,</span> <span
class="n">num_qubits</span><span class="o">=</span><span
class="mi">10</span><span class="p">,</span> <span
class="n">encoding_method</span><span class="o">=</span><span [...]
+</span></code></pre></div></div>
+
+<h2 id="tips">Tips</h2>
+
+<ul>
+ <li>Use <code class="language-plaintext
highlighter-rouge">precision="float64"</code> for higher precision: <code
class="language-plaintext highlighter-rouge">QdpEngine(0,
precision="float64")</code></li>
+ <li>NumPy inputs must be <code class="language-plaintext
highlighter-rouge">float64</code> dtype</li>
+ <li>Streaming only works with Parquet files</li>
+</ul>
+
+<h2 id="troubleshooting">Troubleshooting</h2>
+
+<table>
+ <thead>
+ <tr>
+ <th>Problem</th>
+ <th>Solution</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>Import fails</td>
+ <td>Activate venv: <code class="language-plaintext
highlighter-rouge">source .venv/bin/activate</code></td>
+ </tr>
+ <tr>
+ <td>CUDA errors</td>
+ <td>Run <code class="language-plaintext highlighter-rouge">cargo
clean</code> in <code class="language-plaintext highlighter-rouge">qdp/</code>
and rebuild</td>
+ </tr>
+ <tr>
+ <td>Out of memory</td>
+ <td>Reduce <code class="language-plaintext
highlighter-rouge">num_qubits</code> or use <code class="language-plaintext
highlighter-rouge">precision="float32"</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="next-steps">Next Steps</h2>
+
+<ul>
+ <li><a href="../concepts/">Concepts</a> - Learn about quantum encoding
concepts</li>
+ <li><a href="../api/">API Reference</a> - Detailed API documentation</li>
+ <li><a href="../examples/">Examples</a> - More usage examples</li>
+</ul>
+
+<h2 id="help">Help</h2>
+
+<ul>
+ <li>Mailing List: [email protected]</li>
+ <li><a href="https://github.com/apache/mahout/issues";>GitHub Issues</a></li>
+</ul>
</div>
