New primitive - Executor (beta)

docs/guides/_toc.json

@@ -512,6 +512,10 @@
               "title": "Noise learning",
               "url": "/docs/guides/noise-learning"
             },
+            {
+              "title": "Executor primitive (beta)",
+              "url": "/docs/guides/executor"
+            },
             {
               "title": "Introduction to options",
               "url": "/docs/guides/runtime-options-overview"

docs/guides/configure-error-mitigation.ipynb

@@ -17,6 +17,10 @@
     ]
    },
    "source": [
+    "<Admonition type=\"note\" title=\"New primitive, now in beta release\">\n",
+    "The beta release of a new lower-level primitive, called Executor, is now available. The Executor primitive provides more flexibility when customizing your error mitigation workflow. See the [Executor primitive](/docs/guides/executor) guide for more information.\n",
+    "</Admonition>\n",
+    "\n",
     "<details>\n",
     "<summary><b>Package versions</b></summary>\n",
     "\n",

docs/guides/configure-error-suppression.ipynb

@@ -17,6 +17,10 @@
     ]
    },
    "source": [
+    "<Admonition type=\"note\" title=\"New primitive, now in beta release\">\n",
+    "The beta release of a new lower-level primitive, called Executor, is now available. The Executor primitive provides more flexibility when customizing your error mitigation workflow. See the [Executor primitive](/docs/guides/executor) guide for more information.\n",
+    "</Admonition>\n",
+    "\n",
     "<details>\n",
     "<summary><b>Package versions</b></summary>\n",
     "\n",

docs/guides/error-mitigation-and-suppression-techniques.ipynb

@@ -25,6 +25,10 @@
     ]
    },
    "source": [
+    "<Admonition type=\"note\" title=\"New primitive, now in beta release\">\n",
+    "The beta release of a new lower-level primitive, called Executor, is now available. The Executor primitive provides more flexibility when customizing your error mitigation workflow. See the [Executor primitive](/docs/guides/executor) guide for more information.\n",
+    "</Admonition>\n",
+    "\n",
     "<details>\n",
     "<summary><b>Package versions</b></summary>\n",
     "\n",

docs/guides/execute-on-hardware.mdx

@@ -32,6 +32,7 @@ expectation values of observables corresponding to physical quantities or cost f
 * [Primitives examples](./primitives-examples)
 * [Primitives with REST API](./primitives-rest-api)
 * [Noise learning helper](./noise-learning)
+* [Executor primitive (beta)](/docs/guides/executor)
 
 ### Configure runtime options
 * [Overview](./runtime-options-overview)

docs/guides/executor.mdx

@@ -0,0 +1,35 @@
+---
+title: Executor primitive (beta)
+description: Executor is a lower-level primitive that provides more flexibility when customizing your error mitigation workflow.
+
+---
+
+# Executor primitive (beta)
+
+<Admonition type="note" title="Beta release">
+The Executor primitive is currently in beta and might not be stable. You are invited to test it and provide feedback. (((how?)))
+</Admonition>
+
+The Executor primitive is designed for quantum information scientists to run utility-scale experiments. Executor provides finer control over advanced techniques by shifting the generation of circuit variants to the server side, saving network costs and making the process explicit and customizable. With Executor, users can fine-tune error mitigation and other techniques to find the right balance of speed and quality in their utility-scale workloads.
+
+The Executor primitive benefits users who want to improve the reliability of computations on noisy quantum hardware, and are interested in capabilities such as noise learning, twirling, and expectation value calculations. With Executor, users will gain a clearer and more composable model for execution workflows, making it easier to experiment with new techniques, reproduce results, and share methods.
+
+## Workflow
+
+Important words to define:
+    - box
+    - annotation
+    - samplex
+    - dressing
+
+
+## NoiseLearnerV3
+
+## Next steps
+
+<Admonition type="tip" title="Recommendations">
+- Visit the Samplomatic documentation for [API references](https://qiskit.github.io/samplomatic/api/index.html) and guides, which include examples of the following:
+    - [Dressed boxes](https://qiskit.github.io/samplomatic/guides/dressed_boxes.html)
+    - [Transpiling with `generate_boxing_pass_manager()`](https://qiskit.github.io/samplomatic/guides/transpiler.html)
+    - [Working with samplex inputs and outputs](https://qiskit.github.io/samplomatic/guides/samplex_io.html)
+</Admonition>

docs/guides/get-started-with-primitives.ipynb

@@ -7,6 +7,9 @@
    "source": [
     "# Get started with primitives\n",
     "\n",
+    "<Admonition type=\"note\" title=\"New primitive, now in beta release\">\n",
+    "The beta release of a new lower-level primitive, called Executor, is now available. The Executor primitive provides more flexibility when customizing your error mitigation workflow. See the [Executor primitive](/docs/guides/executor) guide for more information.\n",
+    "</Admonition>\n",
     "\n",
     "<Admonition type=\"note\">\n",
     "While this documentation uses the primitives from Qiskit Runtime, which allow you to use IBM&reg; backends, the primitives can be run on any provider by using the [backend primitives](#backend) instead.  Additionally, you can use the *reference* primitives to run on a local statevector simulator.  See [Exact simulation with Qiskit primitives](/docs/guides/simulate-with-qiskit-sdk-primitives) for details.\n",

docs/guides/primitive-input-output.ipynb

@@ -17,6 +17,10 @@
     ]
    },
    "source": [
+    "<Admonition type=\"note\" title=\"New primitive, now in beta release\">\n",
+    "The beta release of a new lower-level primitive, called Executor, is now available. The Executor primitive provides more flexibility when customizing your error mitigation workflow. See the [Executor primitive](/docs/guides/executor) guide for more information.\n",
+    "</Admonition>\n",
+    "\n",
     "<details>\n",
     "<summary><b>Package versions</b></summary>\n",
     "\n",

docs/guides/primitives-examples.ipynb

@@ -17,6 +17,10 @@
     ]
    },
    "source": [
+    "<Admonition type=\"note\" title=\"New primitive, now in beta release\">\n",
+    "The beta release of a new lower-level primitive, called Executor, is now available. The Executor primitive provides more flexibility when customizing your error mitigation workflow. See the [Executor primitive](/docs/guides/executor) guide for more information.\n",
+    "</Admonition>\n",
+    "\n",
     "<details>\n",
     "<summary><b>Package versions</b></summary>\n",
     "\n",

docs/guides/primitives.ipynb

@@ -35,6 +35,10 @@
    "id": "3ac7f2c2-1541-49f1-9f8f-4c0a8e3a149a",
    "metadata": {},
    "source": [
+    "<Admonition type=\"note\" title=\"New primitive, now in beta release\">\n",
+    "The beta release of a new lower-level primitive, called Executor, is now available. The Executor primitive provides more flexibility when customizing your error mitigation workflow. See the [Executor primitive](/docs/guides/executor) guide for more information.\n",
+    "</Admonition>\n",
+    "\n",
     "<span id=\"qpu-access-patterns\"></span>\n",
     "## Why did Qiskit introduce primitives?\n",
     "\n",

qiskit_bot.yaml

@@ -129,6 +129,10 @@ notifications:
   "docs/guides/execute-on-hardware":
     - "@abbycross"
     - "`@lerongil`"
+  "docs/guides/executor":
+    - "abbycross"
+    - "@jyu00"
+    - "@beckykd"
   "docs/guides/fair-share-scheduler":
     - "`@lerongil`"
     - "@jyu00"

scripts/config/cspell/dictionaries/qiskit.txt

@@ -313,6 +313,8 @@ rpath
 rtol
 rustc
 rustworkx
+samplex
+samplomatic
 satisfiability
 saveas
 sched