Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Provider and Runtime show modules as top-level in sidebar #561

Merged
merged 2 commits into from
Jan 3, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
249 changes: 125 additions & 124 deletions docs/api/qiskit-ibm-provider/_toc.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"children": [
{
"title": "Overview",
"url": "/api/qiskit-ibm-provider"
"url": "/api/qiskit-ibm-provider/ibm_provider"
},
{
"title": "IBMBackend",
Expand Down Expand Up @@ -52,161 +52,162 @@
"title": "least_busy",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.least_busy"
},
{
"title": "qiskit_ibm_provider.jupyter",
"url": "/api/qiskit-ibm-provider/ibm_jupyter"
},
{
"title": "Session",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.Session"
}
]
},
{
"title": "qiskit_ibm_provider.job",
"children": [
{
"title": "Overview",
"url": "/api/qiskit-ibm-provider/ibm_job"
},
{
"title": "qiskit_ibm_provider.job",
"children": [
{
"title": "Overview",
"url": "/api/qiskit-ibm-provider/ibm_job"
},
{
"title": "IBMCircuitJob",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.IBMCircuitJob"
},
{
"title": "IBMCompositeJob",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.IBMCompositeJob"
},
{
"title": "IBMJobApiError",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.IBMJobApiError"
},
{
"title": "IBMJobError",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.IBMJobError"
},
{
"title": "IBMJobFailureError",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.IBMJobFailureError"
},
{
"title": "IBMJobInvalidStateError",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.IBMJobInvalidStateError"
},
{
"title": "IBMJobTimeoutError",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.IBMJobTimeoutError"
},
{
"title": "job_monitor",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.job_monitor"
},
{
"title": "QueueInfo",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.QueueInfo"
}
]
"title": "IBMCircuitJob",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.IBMCircuitJob"
},
{
"title": "IBMCompositeJob",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.IBMCompositeJob"
},
{
"title": "IBMJobApiError",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.IBMJobApiError"
},
{
"title": "IBMJobError",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.IBMJobError"
},
{
"title": "IBMJobFailureError",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.IBMJobFailureError"
},
{
"title": "IBMJobInvalidStateError",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.IBMJobInvalidStateError"
},
{
"title": "qiskit_ibm_provider.transpiler",
"title": "IBMJobTimeoutError",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.IBMJobTimeoutError"
},
{
"title": "job_monitor",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.job_monitor"
},
{
"title": "QueueInfo",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.job.QueueInfo"
}
]
},
{
"title": "qiskit_ibm_provider.jupyter",
"url": "/api/qiskit-ibm-provider/ibm_jupyter"
},
{
"title": "qiskit_ibm_provider.transpiler",
"children": [
{
"title": "Overview",
"url": "/api/qiskit-ibm-provider/ibm_transpiler"
},
{
"title": "qiskit_ibm_provider.transpiler.passes",
"children": [
{
"title": "Overview",
"url": "/api/qiskit-ibm-provider/ibm_transpiler"
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes"
},
{
"title": "qiskit_ibm_provider.transpiler.passes.basis",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes.basis"
},
{
"title": "qiskit_ibm_provider.transpiler.passes",
"title": "qiskit_ibm_provider.transpiler.passes.scheduling",
"children": [
{
"title": "Overview",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes"
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes.scheduling"
},
{
"title": "ALAPScheduleAnalysis",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes.scheduling.ALAPScheduleAnalysis"
},
{
"title": "ASAPScheduleAnalysis",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes.scheduling.ASAPScheduleAnalysis"
},
{
"title": "qiskit_ibm_provider.transpiler.passes.basis",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes.basis"
"title": "BlockBasePadder",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes.scheduling.BlockBasePadder"
},
{
"title": "qiskit_ibm_provider.transpiler.passes.scheduling",
"children": [
{
"title": "Overview",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes.scheduling"
},
{
"title": "ALAPScheduleAnalysis",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes.scheduling.ALAPScheduleAnalysis"
},
{
"title": "ASAPScheduleAnalysis",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes.scheduling.ASAPScheduleAnalysis"
},
{
"title": "BlockBasePadder",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes.scheduling.BlockBasePadder"
},
{
"title": "DynamicCircuitInstructionDurations",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes.scheduling.DynamicCircuitInstructionDurations"
},
{
"title": "PadDelay",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes.scheduling.PadDelay"
},
{
"title": "PadDynamicalDecoupling",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes.scheduling.PadDynamicalDecoupling"
}
]
"title": "DynamicCircuitInstructionDurations",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes.scheduling.DynamicCircuitInstructionDurations"
},
{
"title": "PadDelay",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes.scheduling.PadDelay"
},
{
"title": "PadDynamicalDecoupling",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.transpiler.passes.scheduling.PadDynamicalDecoupling"
}
]
}
]
}
]
},
{
"title": "qiskit_ibm_provider.utils",
"children": [
{
"title": "Overview",
"url": "/api/qiskit-ibm-provider/ibm_utils"
},
{
"title": "qiskit_ibm_provider.utils",
"children": [
{
"title": "Overview",
"url": "/api/qiskit-ibm-provider/ibm_utils"
},
{
"title": "seconds_to_duration",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.utils.seconds_to_duration"
},
{
"title": "to_python_identifier",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.utils.to_python_identifier"
},
{
"title": "utc_to_local",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.utils.utc_to_local"
},
{
"title": "validate_job_tags",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.utils.validate_job_tags"
}
]
"title": "seconds_to_duration",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.utils.seconds_to_duration"
},
{
"title": "qiskit_ibm_provider.visualization",
"children": [
{
"title": "Overview",
"url": "/api/qiskit-ibm-provider/ibm_visualization"
},
{
"title": "iplot_error_map",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.visualization.iplot_error_map"
},
{
"title": "iplot_gate_map",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.visualization.iplot_gate_map"
}
]
"title": "to_python_identifier",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.utils.to_python_identifier"
},
{
"title": "utc_to_local",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.utils.utc_to_local"
},
{
"title": "validate_job_tags",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.utils.validate_job_tags"
}
]
},
{
"title": "qiskit_ibm_provider.visualization",
"children": [
{
"title": "Overview",
"url": "/api/qiskit-ibm-provider/ibm_visualization"
},
{
"title": "iplot_error_map",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.visualization.iplot_error_map"
},
{
"title": "iplot_gate_map",
"url": "/api/qiskit-ibm-provider/qiskit_ibm_provider.visualization.iplot_gate_map"
}
]
},
{
"title": "Release notes",
"url": "/api/qiskit-ibm-provider/release-notes"
}
]
],
"collapsed": true
}
8 changes: 0 additions & 8 deletions docs/api/qiskit-ibm-provider/ibm-provider.md

This file was deleted.

66 changes: 66 additions & 0 deletions docs/api/qiskit-ibm-provider/ibm_provider.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
---
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This used to be /index. It is the API page for the top-level module.

title: qiskit_ibm_provider
description: API reference for qiskit_ibm_provider
in_page_toc_min_heading_level: 1
python_api_type: module
python_api_name: qiskit_ibm_provider
---

<span id="ibm-quantum-provider-qiskit-ibm-provider" />

<span id="module-qiskit_ibm_provider" />

<span id="qiskit-ibm-provider" />

# IBM Quantum Provider

<span id="module-qiskit_ibm_provider" />

`qiskit_ibm_provider`

Modules representing the Qiskit IBM Quantum Provider.

## Logging

The qiskit-ibm-provider uses the `qiskit_ibm_provider` logger.

Two environment variables can be used to control the logging:

> * `QISKIT_IBM_PROVIDER_LOG_LEVEL`: Specifies the log level to use, for the Qiskit IBM provider modules. If an invalid level is set, the log level defaults to `WARNING`. The valid log levels are `DEBUG`, `INFO`, `WARNING`, `ERROR`, and `CRITICAL` (case-insensitive). If the environment variable is not set, then the parent logger’s level is used, which also defaults to `WARNING`.
> * `QISKIT_IBM_PROVIDER_LOG_FILE`: Specifies the name of the log file to use. If specified, messages will be logged to the file only. Otherwise messages will be logged to the standard error (usually the screen).

For more advanced use, you can modify the logger itself. For example, to manually set the level to `WARNING`:

```python
import logging
logging.getLogger('qiskit_ibm_provider').setLevel(logging.WARNING)
```

## Functions

| | |
| ----------------------------------------------------------------------------------------- | ------------------------------------------ |
| [`least_busy`](qiskit_ibm_provider.least_busy "qiskit_ibm_provider.least_busy")(backends) | Return the least busy backend from a list. |

## Classes

| | |
| ---------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| [`IBMProvider`](qiskit_ibm_provider.IBMProvider "qiskit_ibm_provider.IBMProvider")(\[token, url, name, instance, ...]) | Provides access to the IBM Quantum services available to an account. |
| [`IBMBackend`](qiskit_ibm_provider.IBMBackend "qiskit_ibm_provider.IBMBackend")(configuration, provider, api\_client) | Backend class interfacing with an IBM Quantum device. |
| [`IBMBackendService`](qiskit_ibm_provider.IBMBackendService "qiskit_ibm_provider.IBMBackendService")(provider, hgp) | Backend namespace for an IBM Quantum account. |
| [`Session`](qiskit_ibm_provider.Session "qiskit_ibm_provider.Session")(\[max\_time]) | Class for creating a flexible Qiskit Runtime session. |

## Exceptions

| | |
| ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- |
| [`IBMError`](qiskit_ibm_provider.IBMError "qiskit_ibm_provider.IBMError")(\*message) | Base class for errors raised by the provider modules. |
| [`IBMProviderError`](qiskit_ibm_provider.IBMProviderError "qiskit_ibm_provider.IBMProviderError")(\*message) | Base class for errors raise by IBMProvider. |
| [`IBMProviderValueError`](qiskit_ibm_provider.IBMProviderValueError "qiskit_ibm_provider.IBMProviderValueError")(\*message) | Value errors raised by IBMProvider. |
| [`IBMBackendError`](qiskit_ibm_provider.IBMBackendError "qiskit_ibm_provider.IBMBackendError")(\*message) | Base class for errors raised by the backend modules. |
| [`IBMBackendApiError`](qiskit_ibm_provider.IBMBackendApiError "qiskit_ibm_provider.IBMBackendApiError")(\*message) | Errors that occur unexpectedly when querying the server. |
| [`IBMBackendApiProtocolError`](qiskit_ibm_provider.IBMBackendApiProtocolError "qiskit_ibm_provider.IBMBackendApiProtocolError")(\*message) | Errors raised when an unexpected value is received from the server. |
| [`IBMBackendValueError`](qiskit_ibm_provider.IBMBackendValueError "qiskit_ibm_provider.IBMBackendValueError")(\*message) | Value errors raised by the backend modules. |
| [`IBMProviderError`](qiskit_ibm_provider.IBMProviderError "qiskit_ibm_provider.IBMProviderError")(\*message) | Base class for errors raise by IBMProvider. |

Loading