-
Notifications
You must be signed in to change notification settings - Fork 164
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Copy over provider session & remove qiskit-ibm-provider (#1368)
* Move provider's session & remove qiskit-ibm-provider * fix black
- Loading branch information
Showing
5 changed files
with
135 additions
and
5 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,132 @@ | ||
# This code is part of Qiskit. | ||
# | ||
# (C) Copyright IBM 2022. | ||
# | ||
# This code is licensed under the Apache License, Version 2.0. You may | ||
# obtain a copy of this license in the LICENSE.txt file in the root directory | ||
# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0. | ||
# | ||
# Any modifications or derivative works of this code must retain this | ||
# copyright notice, and modified files need to carry a notice indicating | ||
# that they have been altered from the originals. | ||
|
||
"""Qiskit Runtime flexible session.""" | ||
|
||
from typing import Optional, Type, Union | ||
from types import TracebackType | ||
from contextvars import ContextVar | ||
|
||
from .utils.converters import hms_to_seconds | ||
|
||
|
||
class Session: | ||
"""Class for creating a flexible Qiskit Runtime session. | ||
A Qiskit Runtime ``session`` allows you to group a collection of iterative calls to | ||
the quantum computer. A session is started when the first job within the session | ||
is started. Subsequent jobs within the session are prioritized by the scheduler. | ||
Data used within a session, such as transpiled circuits, is also cached to avoid | ||
unnecessary overhead. | ||
You can open a Qiskit Runtime session using this ``Session`` class | ||
and submit one or more jobs. | ||
For example:: | ||
from qiskit.test.reference_circuits import ReferenceCircuits | ||
from qiskit_ibm_runtime import QiskitRuntimeService | ||
circ = ReferenceCircuits.bell() | ||
backend = QiskitRuntimeService().get_backend("ibmq_qasm_simulator") | ||
backend.open_session() | ||
job = backend.run(circ) | ||
print(f"Job ID: {job.job_id()}") | ||
print(f"Result: {job.result()}") | ||
# Close the session only if all jobs are finished and | ||
# you don't need to run more in the session. | ||
backend.cancel_session() | ||
Session can also be used as a context manager:: | ||
with backend.open_session() as session: | ||
job = backend.run(ReferenceCircuits.bell()) | ||
""" | ||
|
||
def __init__( | ||
self, | ||
max_time: Optional[Union[int, str]] = None, | ||
): | ||
"""Session constructor. | ||
Args: | ||
max_time: (EXPERIMENTAL setting, can break between releases without warning) | ||
Maximum amount of time, a runtime session can be open before being | ||
forcibly closed. Can be specified as seconds (int) or a string like "2h 30m 40s". | ||
This value must be in between 300 seconds and the | ||
`system imposed maximum | ||
<https://qiskit.org/documentation/partners/qiskit_ibm_runtime/faqs/max_execution_time.html>`_. | ||
Raises: | ||
ValueError: If an input value is invalid. | ||
""" | ||
self._instance = None | ||
self._session_id: Optional[str] = None | ||
self._active = True | ||
|
||
self._max_time = ( | ||
max_time | ||
if max_time is None or isinstance(max_time, int) | ||
else hms_to_seconds(max_time, "Invalid max_time value: ") | ||
) | ||
|
||
@property | ||
def session_id(self) -> str: | ||
"""Return the session ID. | ||
Returns: | ||
Session ID. None until a job runs in the session. | ||
""" | ||
return self._session_id | ||
|
||
@property | ||
def active(self) -> bool: | ||
"""Return the status of the session. | ||
Returns: | ||
True if the session is active, False otherwise. | ||
""" | ||
return self._active | ||
|
||
def cancel(self) -> None: | ||
"""Set the session._active status to False""" | ||
self._active = False | ||
|
||
def __enter__(self) -> "Session": | ||
set_cm_session(self) | ||
return self | ||
|
||
def __exit__( | ||
self, | ||
exc_type: Optional[Type[BaseException]], | ||
exc_val: Optional[BaseException], | ||
exc_tb: Optional[TracebackType], | ||
) -> None: | ||
set_cm_session(None) | ||
|
||
|
||
# Default session | ||
_DEFAULT_SESSION: ContextVar[Optional[Session]] = ContextVar("_DEFAULT_SESSION", default=None) | ||
_IN_SESSION_CM: ContextVar[bool] = ContextVar("_IN_SESSION_CM", default=False) | ||
|
||
|
||
def set_cm_session(session: Optional[Session]) -> None: | ||
"""Set the context manager session.""" | ||
_DEFAULT_SESSION.set(session) | ||
_IN_SESSION_CM.set(session is not None) | ||
|
||
|
||
def get_cm_session() -> Session: | ||
"""Return the context managed session.""" | ||
return _DEFAULT_SESSION.get() |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters