Add timing visualization page

docs/guides/_toc.json

@@ -634,6 +634,11 @@
               "title": "Visualize circuits",
               "url": "/docs/guides/visualize-circuits"
             },
+                        {
+              "title": "Visualize circuit timing",
+              "url": "/docs/guides/visualize-circuit-timing"
+            },
+
             {
               "title": "Plot quantum states",
               "url": "/docs/guides/plot-quantum-states"

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

@@ -285,6 +285,32 @@
     "qc.draw(output=\"mpl\", style=\"iqp\", idle_wires=False, fold=-1)"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Find backends that support dynamic circuits\n",
+    "\n",
+    "To find all backends that your account can access and support dynamic circuits, run code like the following.  This example assumes that you have [saved your login credentials.](/docs/guides/save-credentials)  You could also [explicitly specify credentials](/docs/guides/initialize-account#explicit) when initializing your Qiskit Runtime service account.  This would let you view backends available on a specific instance or plan type, for example. \n",
+    "\n",
+    "<Admonition type=\"note\">\n",
+    "The backends that are available to the account depend on the instance specified in the credentials.\n",
+    "</Admonition>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from qiskit_ibm_runtime import QiskitRuntimeService\n",
+    "\n",
+    "service = QiskitRuntimeService()\n",
+    "dc_backends = service.backends(dynamic_circuits=True)\n",
+    "print(dc_backends)"
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "0378a45f-7a28-48bc-993d-0e4308d38bfc",

docs/guides/map-problem-to-circuits.mdx

@@ -30,6 +30,7 @@ The output of this step in a Qiskit pattern is normally a collection of circuits
 * [Construct circuits](./construct-circuits)
 * [Measure qubits](./measure-qubits)
 * [Visualize circuits](./visualize-circuits)
+* [Visualize circuit timing](./visualize-circuit-timing)
 * [Fractional gates](./fractional-gates)
 * [Classical feedforward and control flow](./classical-feedforward-and-control-flow)
 * [Deferred timing resolution using stretch](./stretch)

docs/guides/stretch.mdx

@@ -95,6 +95,30 @@ qc.barrier()
     Stretch resolution equation:  $a + 8 + a + 8 + a + 8 = 100   =   3*a + 24$
 </Admonition>
 
+## View stretch values in Qiskit Runtime
+
+When using a Qiskit Runtime primitive, you can view the stretch values.  To view this data, enable its retrieval, then access the data directly from the metadata as follows:
+
+```python
+# enable stretch value retrieval
+sampler.options.experimental = {
+    "execution": {
+        "stretch_values": True,
+    },
+}
+
+# Access the stretch values from the metadata
+job_result: SamplerPubResult = job.result()
+    circuit_stretch_values = job_result[0].metadata["compilation"]["stretch_values"]
+```
+
+### Visualize the stretch values
+
+You can display the output figure, save it to a file, or both.
+
+- Run `fig.show()` display the figure.
+- Run `fig.write_image("<path.format>")` download the figure.  For example: `fig.write_html("scheduler_timing.html")` or `fig.write_image("scheduler_timing.png")`.
+
 ## Qiskit Runtime limitations
 
 Support for `stretch` in Qiskit Runtime is currently experimental and has the following constraints: