Document store directive

docs/guides/classical-feedforward-and-control-flow.ipynb

@@ -293,6 +293,28 @@
     "qc.draw(output=\"mpl\", style=\"iqp\", idle_wires=False, fold=-1)"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "02ef1510-6daf-4a58-b4bb-b5bdbe774c43",
+   "metadata": {},
+   "source": [
+    "### `Store`\n",
+    "\n",
+    "With `qiskit-ibm-runtime` v0.47.0 or later, you can use the [`store`](/docs/api/qiskit/circuit#store) instruction to save the result of a classical expression, if that expression will be used repeatedly. Operations are automatically parallelized, making your code significantly more efficient at runtime.\n",
+    "\n",
+    "For example, it is more natural and performant to write B[0]^B[1]^B[2]..., where B = ~A , than (~A[0])^(~A[1])^(~A[2])....  The former can be written in Qiskit as the following:\n",
+    "\n",
+    "```python\n",
+    "# Store the negation in temporary variable\n",
+    "qc.store(temp, expr.bit_not(creg))\n",
+    "\n",
+    "# Now compute parity using the stored result\n",
+    "parity = expr.bit_xor(\n",
+    "    expr.bit_xor(temp[0], temp[1]), temp[2]\n",
+    ")\n",
+    "```"
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "7c80c5d0-a447-4590-8426-6eb33ae2d817",
@@ -304,6 +326,7 @@
     "- Learn how to implement accurate dynamic decoupling by using [stretch](/docs/guides/stretch).\n",
     "- Use [circuit schedule visualization](/docs/guides/qiskit-runtime-circuit-timing) to debug and optimize your dynamic circuits.\n",
     "- [Execute dynamic circuits](/docs/guides/execute-dynamic-circuits).\n",
+    "- Not all functions are compatible with dynamic circuits. Check the feature compatibility section for [Sampler](/docs/guides/sampler-options#feature-compatibility) or [Executor](/docs/guides/executor-options#feature-compatibility) for details.\n",
     "</Admonition>"
    ]
   }

docs/guides/executor-options.ipynb

@@ -240,7 +240,9 @@
     "  - Dynamical decoupling\n",
     "\n",
     "  Other notes:\n",
-    "  - Gate twirling can be applied to dynamic circuits, but only to gates not inside conditional blocks. Measurement twirling can only be applied to terminal measurements.\n",
+    "  - Gate twirling can be applied to dynamic circuits, but only to gates not inside conditional blocks.\n",
+    "  - Measurement twirling can only be applied to terminal measurements.\n",
+    "  - Measurement twirling is incompatible with the [`store`](/docs/api/qiskit/circuit#store) directive.\n",
     "  - Compatible with fractional gates when using `qiskit-ibm-runtime` v0.42.0 or later.\n",
     "\n",
     "  </TabItem>\n",

docs/guides/qpu-information.ipynb

@@ -357,7 +357,7 @@
     "| :--- | :--- |\n",
     "| Single-qubit gates | [`RZ`](/docs/api/qiskit/qiskit.circuit.library.RZGate), [`SX`](/docs/api/qiskit/qiskit.circuit.library.SXGate), [`X`](/docs/api/qiskit/qiskit.circuit.library.XGate), [`ID`](/docs/api/qiskit/qiskit.circuit.library.IGate), [`delay`](/docs/api/qiskit/circuit#qiskit.circuit.Delay) |\n",
     "| Two-qubit gates | [`CZ`](/docs/api/qiskit/qiskit.circuit.library.CZGate), [`ECR`](/docs/api/qiskit/qiskit.circuit.library.ECRGate)|\n",
-    "| Fractional gates | [`RX`](/docs/api/qiskit/qiskit.circuit.library.RXGate) (single-qubit), [`RZZ`](/docs/api/qiskit/qiskit.circuit.library.RZZGate) (two-qubit) |\n",
+    "| Fractional gates | [`RX`](/docs/api/qiskit/qiskit.circuit.library.RXGate) (single-qubit), [`RZZ`](/docs/api/qiskit/qiskit.circuit.library.RZZGate) (two-qubit) | |\n",
     "| Non-unitary instructions | [`measure`](/docs/api/qiskit/circuit#qiskit.circuit.Measure), [`reset`](/docs/api/qiskit/circuit#qiskit.circuit.Reset), [`measure_*`](/docs/guides/execute-dynamic-circuits#midcircuit), [`delay`](/docs/api/qiskit/circuit#delay) |\n",
     "| Control flow | [`if_else`](/docs/api/qiskit/qiskit.circuit.IfElseOp) (classical feedforward) |"
    ]

docs/guides/sampler-options.ipynb

@@ -510,7 +510,9 @@
     "  - Stretches\n",
     "\n",
     "  Other notes:\n",
-    "  - Gate twirling can be applied to dynamic circuits, but only to gates not inside conditional blocks. Measurement twirling can only be applied to terminal measurements.\n",
+    "  - Gate twirling can be applied to dynamic circuits, but only to gates not inside conditional blocks.\n",
+    "  - Measurement twirling can only be applied to terminal measurements.\n",
+    "  - Measurement twirling is incompatible with the [`store`](/docs/api/qiskit/circuit#store) directive.\n",
     "  - Does not work with non-Clifford entanglers.\n",
     "  </AccordionItem>\n",
     "</Accordion>"