Skip to content

Commit

Permalink
Advanced Runtime topic edits (#1254)
Browse files Browse the repository at this point in the history
  • Loading branch information
beckykd authored Apr 29, 2024
1 parent 2219155 commit 91e2e9c
Show file tree
Hide file tree
Showing 2 changed files with 8 additions and 12 deletions.
8 changes: 4 additions & 4 deletions docs/run/advanced-runtime-options.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Advanced runtime options
description: Specify options when building with Qiskit runtime primitives
title: Advanced Qiskit Runtime options
description: Specify options when building with Qiskit Runtime primitives

---

Expand Down Expand Up @@ -129,7 +129,7 @@ sampler.run([circuit1, circuit2], shots=128)
</TabItem>

<TabItem value="PrimV1" label="V1 primitives">
You can pass any options to `run()`. Because most users will only overwrite a few options at the job level, it is not necessary to specify the category the options are in. The code below, for example, specifies `shots=1024` instead of `execution={"shots": 1024}` (which is also valid).
You can pass any options to `run()`. Because most users will only overwrite a few options at the job level, it is not necessary to specify the options category. The code below, for example, specifies `shots=1024` instead of `execution={"shots": 1024}` (which is also valid).
```python
estimator = Estimator(session=backend, options=options)
result = estimator.run(circuit, observable, shots=1024).result()
Expand Down Expand Up @@ -271,7 +271,7 @@ algorithm. These methods can be set through the `resilience_level` option. For

<Tabs>
<TabItem value="PrimV2" label="Estimator V2">
With Estimator V2, you can set resilience levels 0-2 and you can also turn on and off various error mitigation settings for fine tuning.
With Estimator V2, you can set resilience levels 0-2 and you can also turn on and off various error mitigation settings for fine-tuning.

```python
estimator = Estimator(backend=backend)
Expand Down
12 changes: 4 additions & 8 deletions docs/run/max-execution-time.mdx
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
---
title: Maximum execution time for a Qiskit Runtime job or session
description: Describes how long a Qiskit Runtime job or session can run.
description: Describes how long a Qiskit Runtime job can run, regardless of what execution mode is used.

---

# Maximum execution time for a Qiskit Runtime job or session

To ensure fairness and help control costs, there is a maximum amount of time each Qiskit Runtime job and session can run. If a job exceeds this time limit, it is forcibly canceled and a `RuntimeJobMaxTimeoutError` exception is raised. If a session exceeds its limits, any queued jobs are canceled but any jobs that are already running are not.
To ensure fairness and help control costs, there is a maximum amount of time each Qiskit Runtime job can run. If a job exceeds this time limit, it is forcibly canceled and a `RuntimeJobMaxTimeoutError` exception is raised.

<span id="max-job"></span>
## Job maximum execution time
Expand All @@ -16,11 +16,7 @@ The maximum execution time for a job is the smaller of these values:
- The value set for max_execution_time
- The system-determined job timeout value

<Admonition type="note">
As of 7 August 2023, the `max_execution_time` value is based on _quantum time_ instead of wall clock time. Quantum time is the duration a quantum system is committed to fulfilling a user request.

Simulator jobs continue to use wall clock time because they do not have quantum time.
</Admonition>
The `max_execution_time` value is based on _quantum time_, not wall clock time. Quantum time is the time spent by the QPU complex to process the job. Simulator jobs use wall clock time because they do not have quantum time.

Set the maximum execution time (in seconds) on the job options by using one of the following methods:

Expand Down Expand Up @@ -50,7 +46,7 @@ For example, if you specify `max_execution_time=5000` (approximately 83 minutes)

## Session maximum execution time

When a session is started, it is assigned a maximum session timeout value. After this timeout is reached, the session is terminated, any jobs that are already running continue running, and any queued jobs that remain in the session are put into a failed state. For instructions to set the session maximum time, see [Specify the session length](run-jobs-in-session#specify-length).
When a session is started, it is assigned a maximum session timeout value. After this timeout is reached, the session is terminated, any jobs that are already running continue running, and any queued jobs that remain in the session are put into a failed state. For instructions to set the session maximum time, see [Specify the session length](run-jobs-in-session#specify-length).

## Other limitations

Expand Down

0 comments on commit 91e2e9c

Please sign in to comment.