quantum-mind 2.0.0__tar.gz → 2.0.1__tar.gz

{quantum_mind-2.0.0 → quantum_mind-2.0.1}/NOTICE

@@ -1,4 +1,4 @@
-Quantum Mind (repository quantum-mind; install name quantum-mind; import name quantum_mind)
+Quantum Mind (repository Quantum-mind; install name quantum-mind; import name quantum_mind)
 Copyright 2026 Yeshwanth Guru
 
 This product is licensed under the Apache License, Version 2.0 (see LICENSE).

{quantum_mind-2.0.0/src/quantum_mind.egg-info → quantum_mind-2.0.1}/PKG-INFO

@@ -1,15 +1,15 @@
 Metadata-Version: 2.4
 Name: quantum-mind
-Version: 2.0.0
+Version: 2.0.1
 Summary: Quantum-like, quantum and quantum-inspired models with classical baselines, Qiskit circuits and a 3D Bloch-sphere viewer
 Author-email: Yeshwanth Guru <yeshwanth445@gmail.com>
 Maintainer-email: Yeshwanth Guru <yeshwanth445@gmail.com>
 License-Expression: Apache-2.0
-Project-URL: Homepage, https://yeshwanthguru.github.io/quantum-mind/
-Project-URL: Source, https://github.com/yeshwanthguru/quantum-mind
-Project-URL: Issues, https://github.com/yeshwanthguru/quantum-mind/issues
-Project-URL: Documentation, https://yeshwanthguru.github.io/quantum-mind/docs/
-Project-URL: Changelog, https://yeshwanthguru.github.io/quantum-mind/docs/about/changelog.html
+Project-URL: Homepage, https://yeshwanthguru.github.io/Quantum-mind/
+Project-URL: Source, https://github.com/yeshwanthguru/Quantum-mind
+Project-URL: Issues, https://github.com/yeshwanthguru/Quantum-mind/issues
+Project-URL: Documentation, https://yeshwanthguru.github.io/Quantum-mind/docs/
+Project-URL: Changelog, https://yeshwanthguru.github.io/Quantum-mind/docs/about/changelog.html
 Keywords: quantum cognition,quantum-like models,quantum machine learning,quantum-inspired algorithms,robotics,human-robot interaction,quantum probability,decision making,qiskit,QAOA,VQE,tensor networks,Bloch sphere,visualization,cognitive modelling
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
@@ -87,19 +87,22 @@ Requires-Dist: scikit-learn>=1.3; extra == "dev"
 Dynamic: license-file
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/yeshwanthguru/quantum-mind/main/docs/assets/banner.svg" alt="quantum-mind: quantum-like, quantum and quantum-inspired models" width="100%">
+  <img src="https://raw.githubusercontent.com/yeshwanthguru/Quantum-mind/main/docs/assets/banner.svg" alt="quantum-mind: quantum-like, quantum and quantum-inspired models" width="100%">
 </p>
 
 <p align="center">
-  <a href="https://github.com/yeshwanthguru/quantum-mind/actions/workflows/tests.yml"><img src="https://github.com/yeshwanthguru/quantum-mind/actions/workflows/tests.yml/badge.svg" alt="tests"></a>
-  <a href="https://github.com/yeshwanthguru/quantum-mind/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License: Apache 2.0"></a>
+  <a href="https://pypi.org/project/quantum-mind/"><img src="https://img.shields.io/pypi/v/quantum-mind?label=PyPI" alt="PyPI version"></a>
+  <a href="https://pypistats.org/packages/quantum-mind"><img src="https://img.shields.io/pypi/dm/quantum-mind?label=downloads%2Fmonth" alt="PyPI downloads per month"></a>
+  <a href="https://pepy.tech/projects/quantum-mind"><img src="https://static.pepy.tech/badge/quantum-mind" alt="Total PyPI downloads"></a>
+  <a href="https://github.com/yeshwanthguru/Quantum-mind/actions/workflows/tests.yml"><img src="https://github.com/yeshwanthguru/Quantum-mind/actions/workflows/tests.yml/badge.svg" alt="tests"></a>
+  <a href="https://github.com/yeshwanthguru/Quantum-mind/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License: Apache 2.0"></a>
   <img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12-3776AB?logo=python&logoColor=white" alt="Python 3.10-3.12">
   <img src="https://img.shields.io/badge/Qiskit-2.x-6929C4?logo=qiskit&logoColor=white" alt="Qiskit 2.x">
   <img src="https://img.shields.io/badge/coverage-%E2%89%A580%25%20enforced-2ea44f" alt="coverage enforced in CI">
-  <a href="https://yeshwanthguru.github.io/quantum-mind/docs/"><img src="https://img.shields.io/badge/docs-Sphinx-0969da" alt="Documentation"></a>
+  <a href="https://yeshwanthguru.github.io/Quantum-mind/docs/"><img src="https://img.shields.io/badge/docs-Sphinx-0969da" alt="Documentation"></a>
 </p>
 
-<p align="center"><b><a href="https://yeshwanthguru.github.io/quantum-mind/">Website and live Bloch-sphere playground</a> · <a href="https://yeshwanthguru.github.io/quantum-mind/docs/">Documentation</a> (user guide, example gallery, API reference)</b></p>
+<p align="center"><b><a href="https://yeshwanthguru.github.io/Quantum-mind/">Website and live Bloch-sphere playground</a> · <a href="https://yeshwanthguru.github.io/Quantum-mind/docs/">Documentation</a> (user guide, example gallery, API reference)</b></p>
 
 <p align="center">
   <b><a href="#pillars">Three pillars</a></b> ·
@@ -109,9 +112,12 @@ Dynamic: license-file
   <b><a href="#examples">Examples</a></b> ·
   <b><a href="#hardware">Hardware</a></b> ·
   <b><a href="#status">Status</a></b> ·
-  <b><a href="https://github.com/yeshwanthguru/quantum-mind/tree/main/notebooks">Notebooks</a></b> ·
-  <b><a href="https://yeshwanthguru.github.io/quantum-mind/docs/api/index.html">API</a></b> ·
-  <b><a href="https://github.com/yeshwanthguru/quantum-mind/blob/main/docs/concepts.md">Concepts</a></b>
+  <b><a href="https://yeshwanthguru.github.io/Quantum-mind/docs/tutorials/index.html">Tutorials</a></b> ·
+  <b><a href="https://yeshwanthguru.github.io/Quantum-mind/docs/learn/index.html">Foundations</a></b> ·
+  <b><a href="https://yeshwanthguru.github.io/Quantum-mind/docs/atlas/index.html">Model atlas</a></b> ·
+  <b><a href="https://github.com/yeshwanthguru/Quantum-mind/tree/main/notebooks">Notebooks</a></b> ·
+  <b><a href="https://yeshwanthguru.github.io/Quantum-mind/docs/api/index.html">API</a></b> ·
+  <b><a href="https://github.com/yeshwanthguru/Quantum-mind/blob/main/docs/concepts.md">Concepts</a></b>
 </p>
 
 ---
@@ -132,7 +138,7 @@ research, physics and operations research.
 > Quantum-like models use the mathematics of quantum probability to describe judgements. They run on
 > ordinary computers and do not claim that the brain is a quantum computer. Quantum models are
 > circuits for quantum hardware. Quantum-inspired models are classical algorithms. The
-> [concepts page](https://github.com/yeshwanthguru/quantum-mind/blob/main/docs/concepts.md) explains the difference and how to test each.
+> [concepts page](https://github.com/yeshwanthguru/Quantum-mind/blob/main/docs/concepts.md) explains the difference and how to test each.
 
 <a id="pillars"></a>
 
@@ -203,9 +209,9 @@ builders for MaxCut, knapsack, multi-robot task allocation, portfolio and Ising
 
 <table>
 <tr>
-<td align="center" width="62%"><img src="https://raw.githubusercontent.com/yeshwanthguru/quantum-mind/main/docs/assets/entanglement.gif" alt="Two qubits entangled and disentangled by a circuit" width="100%"><br>
+<td align="center" width="62%"><img src="https://raw.githubusercontent.com/yeshwanthguru/Quantum-mind/main/docs/assets/entanglement.gif" alt="Two qubits entangled and disentangled by a circuit" width="100%"><br>
 <sub>A Qiskit circuit, gate by gate. While the qubits are entangled, their vectors leave the sphere.<br><code>circuit_trajectory(qc)</code> → <code>animate_trajectory</code> / <code>animate_bloch</code></sub></td>
-<td align="center" width="38%"><img src="https://raw.githubusercontent.com/yeshwanthguru/quantum-mind/main/docs/assets/trust_belief.gif" alt="Trust belief of a simulated person on the Bloch sphere" width="100%"><br>
+<td align="center" width="38%"><img src="https://raw.githubusercontent.com/yeshwanthguru/Quantum-mind/main/docs/assets/trust_belief.gif" alt="Trust belief of a simulated person on the Bloch sphere" width="100%"><br>
 <sub>Trust in a robot as a qubit, over successes and failures, with dephasing.<br><code>belief_trajectory(OpenSystemBelief(), events)</code></sub></td>
 </tr>
 </table>
@@ -222,12 +228,12 @@ bloch_tomography(qc, 'aer:FakeTorino')             # Bloch vectors measured unde
 traj.concurrence(0, 1)                              # entanglement of the pair along the circuit
 ```
 
-<p align="center"><img src="https://raw.githubusercontent.com/yeshwanthguru/quantum-mind/main/docs/assets/entanglement_timeline.png" alt="Bloch-vector lengths and concurrence along the circuit" width="88%"><br>
+<p align="center"><img src="https://raw.githubusercontent.com/yeshwanthguru/Quantum-mind/main/docs/assets/entanglement_timeline.png" alt="Bloch-vector lengths and concurrence along the circuit" width="88%"><br>
 <sub>The same circuit as a timeline: <code>plot_entanglement(traj)</code> shows each qubit's Bloch-vector length and the pair's concurrence (Wootters); <code>plot_qsphere(state)</code> draws the Q-sphere.</sub></p>
 
 Interactive versions of both animations (rotate, zoom, play, slider) are written by
-[`examples/19`](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/19_bloch_sphere_viewer.py) and [`examples/20`](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/20_trust_on_the_bloch_sphere.py),
-and shown inline in the [notebooks](https://github.com/yeshwanthguru/quantum-mind/tree/main/notebooks). The [viewer README](https://github.com/yeshwanthguru/quantum-mind/blob/main/src/quantum_mind/viz/README.md) covers everything else.
+[`examples/19`](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/19_bloch_sphere_viewer.py) and [`examples/20`](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/20_trust_on_the_bloch_sphere.py),
+and shown inline in the [notebooks](https://github.com/yeshwanthguru/Quantum-mind/tree/main/notebooks). The [viewer README](https://github.com/yeshwanthguru/Quantum-mind/blob/main/src/quantum_mind/viz/README.md) covers everything else.
 
 <a id="quick-start"></a>
 
@@ -295,11 +301,11 @@ svc.query({'order': 'AB', 'ask_cost': 1.0, 'error_cost': 3.0})
 ```
 
 The same service runs as a ROS 2 node with standard `std_msgs/String` JSON topics:
-[`integrations/ros2`](https://github.com/yeshwanthguru/quantum-mind/blob/main/integrations/ros2/README.md).
+[`integrations/ros2`](https://github.com/yeshwanthguru/Quantum-mind/blob/main/integrations/ros2/README.md).
 </details>
 
-<p align="center"><img src="https://raw.githubusercontent.com/yeshwanthguru/quantum-mind/main/docs/assets/optimisers.png" alt="Optimisers on MaxCut and the QAOA output distribution" width="92%"></p>
-<p align="center"><img src="https://raw.githubusercontent.com/yeshwanthguru/quantum-mind/main/docs/assets/classifiers.png" alt="Decision regions of the variational quantum classifier and the MPS classifier" width="92%"></p>
+<p align="center"><img src="https://raw.githubusercontent.com/yeshwanthguru/Quantum-mind/main/docs/assets/optimisers.png" alt="Optimisers on MaxCut and the QAOA output distribution" width="92%"></p>
+<p align="center"><img src="https://raw.githubusercontent.com/yeshwanthguru/Quantum-mind/main/docs/assets/classifiers.png" alt="Decision regions of the variational quantum classifier and the MPS classifier" width="92%"></p>
 <p align="center"><sub>Generated by <code>docs/make_assets.py</code> from the package itself (simulated data).</sub></p>
 
 <a id="catalogue"></a>
@@ -307,30 +313,30 @@ The same service runs as a ROS 2 node with standard `std_msgs/String` JSON topic
 ## Model catalogue
 
 <details>
-<summary><b>Quantum-like families</b>: 11 families, each with classical baselines and a README</summary>
+<summary><b>Quantum-like families</b>: 12 families, each with classical baselines and a README</summary>
 
 | Family | Phenomenon | Quantum-like model(s) | Classical baselines | Circuit | README |
 |---|---|---|---|---|---|
-| `order_effects` | Answers depend on question order | `QuantumOrderModel4D` (nests Bayes), `QuantumOrderModel` (3D, ranks) | Bayes, anchoring, saturated | yes | [link](https://github.com/yeshwanthguru/quantum-mind/blob/main/src/quantum_mind/families/order_effects/README.md) |
-| `conjunction` | Conjunction and disjunction fallacies | `QuantumConjunctionModel` | classical joint, averaging, probability theory plus noise | yes | [link](https://github.com/yeshwanthguru/quantum-mind/blob/main/src/quantum_mind/families/conjunction/README.md) |
-| `interference` | Disjunction effect, sure-thing violations | `InterferenceModel` (normalised or not) | classical mixture | yes | [link](https://github.com/yeshwanthguru/quantum-mind/blob/main/src/quantum_mind/families/interference/README.md) |
-| `qlbn` | Inference with unresolved hidden causes | quantum-like Bayesian network | classical Bayesian network | yes | [link](https://github.com/yeshwanthguru/quantum-mind/blob/main/src/quantum_mind/families/qlbn/README.md) |
-| `dynamics` | Belief change over time; judgements that change later judgements | `QuantumWalk`, `OpenSystemWalk`, `OpenSystemBelief` | `MarkovWalk`, `MarkovBelief` | yes | [link](https://github.com/yeshwanthguru/quantum-mind/blob/main/src/quantum_mind/families/dynamics/README.md) |
-| `decision` | Risky choice | `QDTModel` (quantum decision theory) | expected utility, prospect theory | no | [link](https://github.com/yeshwanthguru/quantum-mind/blob/main/src/quantum_mind/families/decision/README.md) |
-| `contextuality` | Is there one joint distribution? | CHSH, Contextuality-by-Default criterion | classical bounds | yes | [link](https://github.com/yeshwanthguru/quantum-mind/blob/main/src/quantum_mind/families/contextuality/README.md) |
-| `similarity` | Asymmetric similarity | `QuantumSimilarityModel` | biased geometric (Nosofsky), geometric | yes | [link](https://github.com/yeshwanthguru/quantum-mind/blob/main/src/quantum_mind/families/similarity/README.md) |
-| `game_theory` | Strategic choice with shared quantum resources | `EWLGame` (Eisert–Wilkens–Lewenstein), best responses, Nash checks | classical Nash equilibria | no | [link](https://github.com/yeshwanthguru/quantum-mind/blob/main/src/quantum_mind/families/game_theory/README.md) |
-| `memory` | Episodic overdistribution in recall | `QuantumEpisodicModel` (Brainerd) | additive (verbatim + gist) | no | [link](https://github.com/yeshwanthguru/quantum-mind/blob/main/src/quantum_mind/families/memory/README.md) |
-| `concepts` | Overextension in concept combination ("pet fish") | `FockSpaceConceptModel` (Aerts) | product, minimum (fuzzy), weighted average | no | [link](https://github.com/yeshwanthguru/quantum-mind/blob/main/src/quantum_mind/families/concepts/README.md) |
-
-Robotics application ([README](https://github.com/yeshwanthguru/quantum-mind/blob/main/src/quantum_mind/applications/README.md)): question domains (object
+| `order_effects` | Answers depend on question order | `QuantumOrderModel4D` (nests Bayes), `QuantumOrderModel` (3D, ranks) | Bayes, anchoring, saturated | yes | [link](https://github.com/yeshwanthguru/Quantum-mind/blob/main/src/quantum_mind/families/order_effects/README.md) |
+| `conjunction` | Conjunction and disjunction fallacies | `QuantumConjunctionModel` | classical joint, averaging, probability theory plus noise | yes | [link](https://github.com/yeshwanthguru/Quantum-mind/blob/main/src/quantum_mind/families/conjunction/README.md) |
+| `interference` | Disjunction effect, sure-thing violations | `InterferenceModel` (normalised or not) | classical mixture | yes | [link](https://github.com/yeshwanthguru/Quantum-mind/blob/main/src/quantum_mind/families/interference/README.md) |
+| `qlbn` | Inference with unresolved hidden causes | quantum-like Bayesian network | classical Bayesian network | yes | [link](https://github.com/yeshwanthguru/Quantum-mind/blob/main/src/quantum_mind/families/qlbn/README.md) |
+| `dynamics` | Belief change over time; judgements that change later judgements | `QuantumWalk`, `OpenSystemWalk`, `OpenSystemBelief` | `MarkovWalk`, `MarkovBelief` | yes | [link](https://github.com/yeshwanthguru/Quantum-mind/blob/main/src/quantum_mind/families/dynamics/README.md) |
+| `decision` | Risky choice | `QDTModel` (quantum decision theory) | expected utility, prospect theory | no | [link](https://github.com/yeshwanthguru/Quantum-mind/blob/main/src/quantum_mind/families/decision/README.md) |
+| `contextuality` | Is there one joint distribution? | CHSH, Contextuality-by-Default criterion | classical bounds | yes | [link](https://github.com/yeshwanthguru/Quantum-mind/blob/main/src/quantum_mind/families/contextuality/README.md) |
+| `similarity` | Asymmetric similarity | `QuantumSimilarityModel` | biased geometric (Nosofsky), geometric | yes | [link](https://github.com/yeshwanthguru/Quantum-mind/blob/main/src/quantum_mind/families/similarity/README.md) |
+| `game_theory` | Strategic choice with shared quantum resources | `EWLGame` (Eisert–Wilkens–Lewenstein), best responses, Nash checks | classical Nash equilibria | no | [link](https://github.com/yeshwanthguru/Quantum-mind/blob/main/src/quantum_mind/families/game_theory/README.md) |
+| `memory` | Episodic overdistribution in recall | `QuantumEpisodicModel` (Brainerd) | additive (verbatim + gist) | no | [link](https://github.com/yeshwanthguru/Quantum-mind/blob/main/src/quantum_mind/families/memory/README.md) |
+| `concepts` | Overextension in concept combination ("pet fish") | `FockSpaceConceptModel` (Aerts) | product, minimum (fuzzy), weighted average | no | [link](https://github.com/yeshwanthguru/Quantum-mind/blob/main/src/quantum_mind/families/concepts/README.md) |
+
+Robotics application ([README](https://github.com/yeshwanthguru/Quantum-mind/blob/main/src/quantum_mind/applications/README.md)): question domains (object
 clarification, trust and hand-over, preference elicitation), questioning designs (fixed, probe,
 split), a trust protocol, `HumanModelEnsemble`, and Bayesian and quantum-like intent resolvers
 (`applications.intent`) for ambiguous commands.
 </details>
 
 <details>
-<summary><b>Quantum models</b>: QML and algorithms (<a href="https://github.com/yeshwanthguru/quantum-mind/blob/main/src/quantum_mind/quantum/README.md">README</a>)</summary>
+<summary><b>Quantum models</b>: QML and algorithms (<a href="https://github.com/yeshwanthguru/Quantum-mind/blob/main/src/quantum_mind/quantum/README.md">README</a>)</summary>
 
 | Model | Use | Reference |
 |---|---|---|
@@ -344,11 +350,11 @@ split), a trust protocol, `HumanModelEnsemble`, and Bayesian and quantum-like in
 | `qft_circuit`, `find_period` | quantum Fourier transform and period finding | Coppersmith, 1994; Shor, 1994 |
 | `AmplitudeEstimation` | expected values (risk, pricing) with maximum-likelihood amplitude estimation | Suzuki et al., *QIP* 2020 |
 | `ctqw_probabilities`, `quantum_walk_centrality` | continuous-time quantum walks on graphs; node centrality | Farhi and Gutmann, *PRA* 1998 |
-| `quantum_mind.circuits` | circuits of the quantum-like families; `run()` on any backend | [circuits README](https://github.com/yeshwanthguru/quantum-mind/blob/main/src/quantum_mind/circuits/README.md) |
+| `quantum_mind.circuits` | circuits of the quantum-like families; `run()` on any backend | [circuits README](https://github.com/yeshwanthguru/Quantum-mind/blob/main/src/quantum_mind/circuits/README.md) |
 </details>
 
 <details>
-<summary><b>Quantum-inspired models</b>: optimisers, tensor networks, learning and ranking (<a href="https://github.com/yeshwanthguru/quantum-mind/blob/main/src/quantum_mind/inspired/README.md">README</a>)</summary>
+<summary><b>Quantum-inspired models</b>: optimisers, tensor networks, learning and ranking (<a href="https://github.com/yeshwanthguru/Quantum-mind/blob/main/src/quantum_mind/inspired/README.md">README</a>)</summary>
 
 | Model | Problem | Reference |
 |---|---|---|
@@ -366,7 +372,7 @@ split), a trust protocol, `HumanModelEnsemble`, and Bayesian and quantum-like in
 ```mermaid
 flowchart TB
     core["quantum_mind.core<br/>Model · Param · fit · compare · recovery"]
-    fam["quantum_mind.families<br/>11 quantum-like families"]
+    fam["quantum_mind.families<br/>12 quantum-like families"]
     app["quantum_mind.applications<br/>robotics"]
     prob["quantum_mind.problems<br/>QUBO builders"]
     qm["quantum_mind.quantum<br/>VQC · kernels · QAOA · VQE · Grover · QFT · QAE · walks"]
@@ -411,40 +417,45 @@ Pillar: QL quantum-like, Q quantum, QI quantum-inspired, viz Bloch-sphere viewer
 
 | # | Domain | Pillar | Script |
 |---|---|---|---|
-| 01 | Surveys, market research | QL | [question-order effects, QQ test](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/01_survey_question_order.py) |
-| 02 | Behavioural finance | QL | [disjunction effect, interference, QLBN](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/02_finance_disjunction_effect.py) |
-| 03 | Medical decision support | QL | [quantum-like Bayesian network](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/03_medical_diagnosis_qlbn.py) |
-| 04 | Consumer choice | QL | [quantum decision theory vs EU and PT](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/04_consumer_choice_qdt.py) |
-| 05 | AI / LLM evaluation | QL | [order effects in judgements](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/05_llm_evaluation_order.py) |
-| 06 | Human–computer interaction | QL | [trust dynamics](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/06_hci_trust_dynamics.py) |
-| 07 | Perception, confidence | QL | [Markov vs quantum walk](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/07_evidence_accumulation.py) |
-| 08 | Physics, psychology | QL, Q | [CHSH and Contextuality-by-Default](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/08_contextuality_analysis.py) |
-| 09 | Marketing, linguistics | QL | [asymmetric similarity](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/09_similarity_asymmetry.py) |
-| 10 | – | Q | [every family as a circuit (Aer, FakeTorino, Braket)](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/10_circuits_quickstart.py) |
-| 11 | – | Q | [IBM Quantum / Amazon Braket hardware](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/11_cloud_run.py) |
-| 12 | Robotics, HRI | QL | [robot questioning and trust](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/12_robot_questioning_trust.py) |
-| 13 | Medicine (simulated) | Q, QI | [VQC, quantum kernel, MPS vs logistic regression](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/13_quantum_classifiers_triage.py) |
-| 14 | Robotics | Q, QI | [multi-robot task allocation: QAOA, SQA, QIEA, SA](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/14_qaoa_multi_robot_allocation.py) |
-| 15 | Finance (simulated) | Q, QI | [portfolio selection](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/15_portfolio_selection.py) |
-| 16 | Physics, materials | Q | [VQE on a transverse-field Ising chain](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/16_vqe_ising_chain.py) |
-| 17 | Scheduling | Q | [Grover search for valid schedules](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/17_grover_schedule_search.py) |
-| 18 | Control, robotics | QI | [PID tuning with QPSO](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/18_qpso_controller_tuning.py) |
-| 19 | Visualisation | viz | [Bloch-sphere viewer, HTML, GIF, live, tomography](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/19_bloch_sphere_viewer.py) |
-| 20 | Robotics, HRI | QL, viz | [trust on the Bloch sphere](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/20_trust_on_the_bloch_sphere.py) |
-| 21 | Robotics | QL | [when to ask for help: ensemble uncertainty and `ask_or_act`](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/21_robot_ask_for_help.py) |
-| 22 | Surveys, HRI | QL | [individual differences: pooled versus per-person model comparison](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/22_individual_differences.py) |
-| 23 | Economics, multi-agent | QL | [quantum games: EWL Prisoner's Dilemma and Chicken](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/23_quantum_games.py) |
-| 24 | Memory, language | QL | [episodic overdistribution and concept combination (simulated)](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/24_memory_and_concepts.py) |
-| 25 | Robotics, HRI | QL | [resolving an ambiguous command: Bayesian vs quantum-like intent](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/25_intent_resolution_robot.py) |
-| 26 | Finance, risk | Q | [amplitude estimation vs Monte Carlo](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/26_risk_amplitude_estimation.py) |
-| 27 | Signal processing | Q | [quantum Fourier transform and period finding](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/27_qft_period_finding.py) |
-| 28 | Networks | Q | [quantum-walk centrality vs PageRank and degree](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/28_network_centrality_quantum_walk.py) |
-| 29 | Forecasting, monitoring (simulated) | Q | [variational regressor, anomaly detection, clustering vs classical](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/29_forecasting_and_anomalies.py) |
-| 30 | Robotics | QI | [navigation: quantum-inspired RL vs Q-learning](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/30_robot_navigation_qrl.py) |
-| 31 | Information retrieval | QI | [document ranking: quantum language model vs query likelihood](https://github.com/yeshwanthguru/quantum-mind/blob/main/examples/31_document_ranking_qlm.py) |
-
-Notebooks: [`01_bloch_sphere_live`](https://github.com/yeshwanthguru/quantum-mind/blob/main/notebooks/01_bloch_sphere_live.ipynb) (interactive and live spheres,
-tomography under device noise) and [`02_robot_questioning_and_trust`](https://github.com/yeshwanthguru/quantum-mind/blob/main/notebooks/02_robot_questioning_and_trust.ipynb)
+| 01 | Surveys, market research | QL | [question-order effects, QQ test](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/01_survey_question_order.py) |
+| 02 | Behavioural finance | QL | [disjunction effect, interference, QLBN](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/02_finance_disjunction_effect.py) |
+| 03 | Medical decision support | QL | [quantum-like Bayesian network](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/03_medical_diagnosis_qlbn.py) |
+| 04 | Consumer choice | QL | [quantum decision theory vs EU and PT](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/04_consumer_choice_qdt.py) |
+| 05 | AI / LLM evaluation | QL | [order effects in judgements](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/05_llm_evaluation_order.py) |
+| 06 | Human–computer interaction | QL | [trust dynamics](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/06_hci_trust_dynamics.py) |
+| 07 | Perception, confidence | QL | [Markov vs quantum walk](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/07_evidence_accumulation.py) |
+| 08 | Physics, psychology | QL, Q | [CHSH and Contextuality-by-Default](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/08_contextuality_analysis.py) |
+| 09 | Marketing, linguistics | QL | [asymmetric similarity](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/09_similarity_asymmetry.py) |
+| 10 | – | Q | [every family as a circuit (Aer, FakeTorino, Braket)](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/10_circuits_quickstart.py) |
+| 11 | – | Q | [IBM Quantum / Amazon Braket hardware](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/11_cloud_run.py) |
+| 12 | Robotics, HRI | QL | [robot questioning and trust](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/12_robot_questioning_trust.py) |
+| 13 | Medicine (simulated) | Q, QI | [VQC, quantum kernel, MPS vs logistic regression](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/13_quantum_classifiers_triage.py) |
+| 14 | Robotics | Q, QI | [multi-robot task allocation: QAOA, SQA, QIEA, SA](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/14_qaoa_multi_robot_allocation.py) |
+| 15 | Finance (simulated) | Q, QI | [portfolio selection](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/15_portfolio_selection.py) |
+| 16 | Physics, materials | Q | [VQE on a transverse-field Ising chain](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/16_vqe_ising_chain.py) |
+| 17 | Scheduling | Q | [Grover search for valid schedules](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/17_grover_schedule_search.py) |
+| 18 | Control, robotics | QI | [PID tuning with QPSO](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/18_qpso_controller_tuning.py) |
+| 19 | Visualisation | viz | [Bloch-sphere viewer, HTML, GIF, live, tomography](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/19_bloch_sphere_viewer.py) |
+| 20 | Robotics, HRI | QL, viz | [trust on the Bloch sphere](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/20_trust_on_the_bloch_sphere.py) |
+| 21 | Robotics | QL | [when to ask for help: ensemble uncertainty and `ask_or_act`](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/21_robot_ask_for_help.py) |
+| 22 | Surveys, HRI | QL | [individual differences: pooled versus per-person model comparison](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/22_individual_differences.py) |
+| 23 | Economics, multi-agent | QL | [quantum games: EWL Prisoner's Dilemma and Chicken](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/23_quantum_games.py) |
+| 24 | Memory, language | QL | [episodic overdistribution and concept combination (simulated)](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/24_memory_and_concepts.py) |
+| 25 | Robotics, HRI | QL | [resolving an ambiguous command: Bayesian vs quantum-like intent](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/25_intent_resolution_robot.py) |
+| 26 | Finance, risk | Q | [amplitude estimation vs Monte Carlo](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/26_risk_amplitude_estimation.py) |
+| 27 | Signal processing | Q | [quantum Fourier transform and period finding](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/27_qft_period_finding.py) |
+| 28 | Networks | Q | [quantum-walk centrality vs PageRank and degree](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/28_network_centrality_quantum_walk.py) |
+| 29 | Forecasting, monitoring (simulated) | Q | [variational regressor, anomaly detection, clustering vs classical](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/29_forecasting_and_anomalies.py) |
+| 30 | Robotics | QI | [navigation: quantum-inspired RL vs Q-learning](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/30_robot_navigation_qrl.py) |
+| 31 | Information retrieval | QI | [document ranking: quantum language model vs query likelihood](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/31_document_ranking_qlm.py) |
+| 32 | Robotics, perception | classical | [calibration, conformal sets and hazard-aware ask-or-act](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/32_calibration_and_conformal.py) |
+| 33 | Robotics, perception | QL | [fusing detector, speech and gaze: Bayes, Dempster-Shafer, quantum-like](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/33_multimodal_fusion.py) |
+| 34 | Perception | QL | [bistable perception: quantum Zeno vs Markov and gamma renewal](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/34_bistable_perception_zeno.py) |
+| 35 | Learning, HRI | QI, Q | [RL with simulated people: amplitude exploration, quantum policy](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/35_rl_with_simulated_people.py) |
+| 36 | Robotics, HRI | QL | [trust-aware hand-over vs Markov-based and always hand over](https://github.com/yeshwanthguru/Quantum-mind/blob/main/examples/36_trust_aware_handover.py) |
+
+Notebooks: [`01_bloch_sphere_live`](https://github.com/yeshwanthguru/Quantum-mind/blob/main/notebooks/01_bloch_sphere_live.ipynb) (interactive and live spheres,
+tomography under device noise) and [`02_robot_questioning_and_trust`](https://github.com/yeshwanthguru/Quantum-mind/blob/main/notebooks/02_robot_questioning_and_trust.ipynb)
 (order effects, ensemble, ask-or-act, trust on the sphere). Both run in CI.
 
 Results printed by the examples (simulated data, this version). They illustrate the methods on small
@@ -496,8 +507,8 @@ Sampler (`qiskit_ibm_runtime.executor_sampler`), falling back to `SamplerV2` on
 
 | Area | What exists | What does not (yet) |
 |---|---|---|
-| Quantum-like models | 11 families with classical baselines, fitting, BIC/AIC, recovery studies, per-person fitting and comparison (`fit_individuals`, `compare_individuals`); published aggregate data | hierarchical (partial-pooling) models |
-| Robotics | simulated human populations for three question domains, questioning designs, trust protocol, intent resolution, `HumanModelEnsemble`, `ask_or_act`, `HumanModelService`, a ROS 2 node (`integrations/ros2`) | a run of the ROS 2 node inside a ROS 2 installation (its callbacks are tested with stand-in modules); data from human–robot studies |
+| Quantum-like models | 12 families with classical baselines, fitting, BIC/AIC, recovery studies, per-person fitting and comparison (`fit_individuals`, `compare_individuals`), partial pooling (`applications.personalisation`); published aggregate data | full hierarchical Bayesian inference (only MAP partial pooling) |
+| Robotics | simulated human populations for three question domains, questioning designs, trust protocol, intent resolution, `HumanModelEnsemble`, `ask_or_act`, risk-aware decisions, calibration and conformal sets, orchestration gates, a question planner, trust-aware hand-over, multimodal fusion, Gymnasium environments, `HumanModelService`, a ROS 2 node (`integrations/ros2`) | a run of the ROS 2 node inside a ROS 2 installation (its callbacks are tested with stand-in modules); data from human–robot studies |
 | Quantum models | VQC, regressor, quantum kernel (classification, anomalies, clustering), QAOA, VQE, Grover, QFT, amplitude estimation, quantum walks on an exact simulator with adjoint gradients; Qiskit export; IBM submission through the current Qiskit Runtime Sampler | quantum advantage (none claimed); noise-aware training; runs on hardware |
 | Quantum-inspired | QIEA with Han and Kim's rotation table (or a simplified rule), QPSO, SQA, simulated-annealing baseline, MPS classifier with DMRG-style sweeps or Adam, quantum reinforcement learning, quantum language model | – |
 | Viewer | trajectories, animations, interactive HTML, live widget, tomography, pairwise concurrence and entanglement timeline, Q-sphere | – |
@@ -518,7 +529,7 @@ problems. The repository name reflects the main application, robots that work wi
 ```bash
 pip install quantum-mind              # core: numpy, scipy
 pip install "quantum-mind[all]"       # everything (Qiskit, cloud back ends, viewer)
-pip install "quantum-mind[all] @ git+https://github.com/yeshwanthguru/quantum-mind"   # latest development version
+pip install "quantum-mind[all] @ git+https://github.com/yeshwanthguru/Quantum-mind"   # latest development version
 ```
 
 | Extra | Adds | For |
@@ -587,12 +598,12 @@ Every other data set in the examples is simulated and labelled as such.
 
 To cite Quantum Mind, use `CITATION.cff` (GitHub's "Cite this repository" button), together with the
 original papers of the models used, which are listed in each README. The package is released under the
-[Apache License 2.0](https://github.com/yeshwanthguru/quantum-mind/blob/main/LICENSE) (see also [NOTICE](https://github.com/yeshwanthguru/quantum-mind/blob/main/NOTICE)). The licence permits commercial and research
-use and includes an explicit patent grant. For contributing, see [CONTRIBUTING.md](https://github.com/yeshwanthguru/quantum-mind/blob/main/CONTRIBUTING.md);
-for release history, see [CHANGELOG.md](https://github.com/yeshwanthguru/quantum-mind/blob/main/CHANGELOG.md).
+[Apache License 2.0](https://github.com/yeshwanthguru/Quantum-mind/blob/main/LICENSE) (see also [NOTICE](https://github.com/yeshwanthguru/Quantum-mind/blob/main/NOTICE)). The licence permits commercial and research
+use and includes an explicit patent grant. For contributing, see [CONTRIBUTING.md](https://github.com/yeshwanthguru/Quantum-mind/blob/main/CONTRIBUTING.md);
+for release history, see [CHANGELOG.md](https://github.com/yeshwanthguru/Quantum-mind/blob/main/CHANGELOG.md).
 
 **Author and maintainer:** Yeshwanth Guru (yeshwanth445@gmail.com; ORCID
-[0009-0007-6353-4033](https://orcid.org/0009-0007-6353-4033)). Security reports: see [SECURITY.md](https://github.com/yeshwanthguru/quantum-mind/blob/main/SECURITY.md).
+[0009-0007-6353-4033](https://orcid.org/0009-0007-6353-4033)). Security reports: see [SECURITY.md](https://github.com/yeshwanthguru/Quantum-mind/blob/main/SECURITY.md).
 
 Companion manuscripts (in preparation): a systematic review of quantum-like cognition for autonomous
 agents, a systematic review of meta-learning orchestration on resource-constrained robots, and