\")\n"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "79d463c4-81c6-49b2-9817-1bed7cb98517",
+ "metadata": {},
+ "source": [
+ "To view the backends you have access to, you can use the `QiskitRuntimeService.backends()` method. Let's check your backend list:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "6fc011cc-77df-461a-bc99-93ffd22eb672",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "service.backends()"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "0f8ba878-89b0-458e-8854-034cb7c7b433",
+ "metadata": {},
+ "source": [
+ "The `QiskitRuntimeService.backend()` method (note that this is singular: backend) takes the name of the backend as the input parameter and returns an IBMBackend instance representing that particular backend. The following code will select `ibmq_qasm_simulator` and save it as a `backend_sim`"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "f6bf1f98-b992-47fc-85ea-ff534b7977eb",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "backend_sim = service.backend(\"ibmq_qasm_simulator\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "231e0279-e1bf-43c0-b77b-01a77b5dbd5e",
+ "metadata": {},
+ "source": [
+ "You can also filter the available backends by their properties. For more general filters, you can make advanced functions using a lambda function. Refer to the [API documentation](https://docs.quantum.ibm.com/api/qiskit-ibm-runtime/qiskit_ibm_runtime.QiskitRuntimeService#backends) for more details.\n",
+ "\n",
+ "As shown here, we will filter least busy real backend and save it to `backend`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "67109b11-1157-4356-9e24-5a63bb513795",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "backend = service.least_busy(simulator=False, operational=True)\n",
+ "backend"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "0155d3e0-93f0-4950-bbe7-dfd64a99e26a",
+ "metadata": {},
+ "source": [
+ "### Create a toy circuit\n",
+ "\n",
+ "Now, let's create a random circuit by using `qiskit.circuit.random.random_circuit` with 5 qubits with depth=3 with measurement. "
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "e7610fbe-d2b0-4475-9c7c-e6e0ec751d66",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "from qiskit.circuit.random import random_circuit\n",
+ " \n",
+ "circ = random_circuit(5, 3, measure=True)\n",
+ "circ.draw(output='mpl', style='iqp')"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "bc4dae59-a927-4efb-b030-510505418763",
+ "metadata": {},
+ "source": [
+ "### Execute using a quantum primitive function\n",
+ "\n",
+ "Quantum computers can produce random results, so you'll often want to collect a sample of the outputs by running the circuit many times. You can use the `Sampler` class to get measured data from a quantum Computer.. `Sampler` is one of our two [primitives](https://docs.quantum.ibm.com/run/primitives-get-started); the other is `Estimator`, which estimates the value of observable."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "a72b8e00-89e1-492c-860c-775f2e72d68d",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "from qiskit_ibm_runtime import Sampler, Options\n",
+ " \n",
+ "options = Options()\n",
+ "options.resilience_level = 1\n",
+ "options.optimization_level = 3\n",
+ " \n",
+ "# Create an Estimator object\n",
+ "sampler = Sampler(backend_sim, options=options)\n",
+ " \n",
+ "# Submit the circuit to Estimator\n",
+ "job = sampler.run(circ, shots = 10000)"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "5c2996ff-e30b-4e55-82f9-5fe6a7411508",
+ "metadata": {},
+ "source": [
+ "You can print the job's id and status by using the job instance. Run below cell to check both."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "7e873269-7312-4f7c-a4af-cf87c8def5eb",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "jobid = job.job_id()\n",
+ "print(f\">>> Job ID: {job.job_id()}\")\n",
+ "print(f\">>> Job Status: {job.status()}\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "db17081f-a469-4a38-bdec-5500e968a642",
+ "metadata": {},
+ "source": [
+ "\n",
+ "Note: \n",
+ " Jobs submitted by using the qiskit_ibm_runtime provider are not visible in the right side panel of qBraid Lab
\n"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "23e66477-79dc-4e24-a964-07a486203348",
+ "metadata": {},
+ "source": [
+ "### Retrieve job results at a later time\n",
+ "\n",
+ "You can call service.job(\\) to retrieve a job you previously submitted. If you don’t have the job ID, or if you want to retrieve multiple jobs at once; including jobs from retired systems, call service.jobs() with optional filters instead. See [QiskitRuntimeService.jobs](https://docs.quantum.ibm.com/api/qiskit-ibm-runtime/qiskit_ibm_runtime.QiskitRuntimeService#jobs) for details.\n",
+ "\n",
+ "As shown here, we will retrieve the job result and save it as a `retrieve_job` to see the result."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "7c477078-67be-46d8-8378-962f6a9b9dea",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "retrieve_job = service.job(jobid)\n",
+ "result = retrieve_job.result()"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "945f9635-a576-47cd-94b4-78fd7fadea0f",
+ "metadata": {},
+ "source": [
+ "Now we will plot the results. \n",
+ "\n",
+ "As sampler returns quasi probability of measurement, let's use `plot_distribution` with a binary expression. See [SamplerResult document](https://docs.quantum.ibm.com/api/qiskit/qiskit.primitives.SamplerResult) for more information."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "d0590e58-9eea-4589-a774-6652c37d2e9f",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "from qiskit.visualization import plot_distribution\n",
+ "\n",
+ "plot_distribution(result.quasi_dists[0].binary_probabilities())"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "03ec980a-f294-4498-82cf-cb4c35a1f3b6",
+ "metadata": {},
+ "source": [
+ "## 2. Using qBraid SDK"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "de67207f-3dd5-499e-bb72-0ad0100b3228",
+ "metadata": {},
+ "source": [
+ "By following [this lab demo](https://github.com/qBraid/qbraid-lab-demo/blob/045c7a8fbdcae66a7e64533dd9fe0e981dc02cf4/qbraid_sdk/ibm_batch_jobs_grovers.ipynb#L4) provided by qBraid, you can also use qbraid sdk to submit your ibm job and check job status. The following show how to do that.\n",
+ "\n",
+ "First, check the qbraid version."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "5854118c-2d37-497e-934f-784bdc431b21",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "import qbraid\n",
+ "\n",
+ "qbraid.__version__"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "7d67c858-1ab0-4e46-bf47-f77ccd8f3e87",
+ "metadata": {},
+ "source": [
+ "Now import essential libraries and save your ibm api token as an environment variable. Then, set-up your `QiskitProvider` with that token."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "1029c085-6e9f-4f56-b525-8d0b294d6dd4",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "\n",
+ "from qbraid import device_wrapper, job_wrapper, get_jobs\n",
+ "from qbraid.providers import QuantumJob\n",
+ "from qbraid.providers.exceptions import JobStateError\n",
+ "from qbraid.providers.ibm import QiskitBackend, QiskitJob, QiskitProvider\n",
+ "import os\n",
+ "\n",
+ "os.environ['QISKIT_IBM_TOKEN'] = ''\n",
+ "ibmq_token = os.getenv(\"QISKIT_IBM_TOKEN\")\n",
+ "provider = QiskitProvider(qiskit_ibm_token=ibmq_token)"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "aee25386-eb1c-4f11-ab63-38be584e73bc",
+ "metadata": {},
+ "source": [
+ "You can also see the device list, accessible with your token."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "a79c8520-01f7-4146-860f-996b60cf914c",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "provider.get_devices()"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "a1fb6069-3a00-4250-ad6f-11851ef9089f",
+ "metadata": {},
+ "source": [
+ "`qbraid.providers.ibm` also supports useful filtering by `get_devices()`. You can quickly find the least busy backend by using `ibm_least_busy_gpu()`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "6f562ceb-72d9-4be4-8e8b-15690286c558",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "#ibm_device = provider.ibm_least_busy_qpu() #return least busy backend of provider\n",
+ "#ibm_device = provider.get_devices(operational=True, simulator=False) #return backend list which is now operate and not a simulator\n",
+ "ibm_device = provider.get_device(\"ibm_kyoto\") #return backend by name\n"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "545c1b43-9679-4dd6-ad6c-3dc7a48833df",
+ "metadata": {},
+ "source": [
+ "To send the quantum circuit to the backend and check the job status in the right sidebar of qBraid Quantum lab, wrap the ibm backend with `device_wrapper`. If you insert the backend, which does not appear in the right sidebar panel's \"device\" section, this code will return an error."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "086710ef-5cac-4fe3-95f0-d071c8321cea",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "#qbraid_ibm_device = device_wrapper(ibm_device) #you and add device called by provider as well\n",
+ "qbraid_ibm_device = device_wrapper(\"ibm_kyoto\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "953be90a-d983-444d-8d1f-4ebe9cd9f0e8",
+ "metadata": {},
+ "source": [
+ "To send a quantum circuit, you can simply call `wrapped_device.run(circuit, options)`. See [API document](https://docs.qbraid.com/en/stable/sdk/devices.html#device-wrapper) for more information."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "5c92dd6f-c82f-46a5-bf80-07bdfc2f254d",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "qbraid_ibm_job = qbraid_ibm_device.run(circ, shots=20000)#works if backend is at Devices list. Error if I try to use premium backend"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "52c2510a-2a69-4624-aede-56237b76fe53",
+ "metadata": {},
+ "source": [
+ "Shortly afterwards you should see your submitted job in the right side panel. If you cannot see your job, click the circulation icon at the top to refresh or select `All` for Provider.\n",
+ "\n",
+ "Also, you can check your job status by using `job_wrapper(job_id).` Please note that the `job_id` for `job_wrapper` must be a qBraidID, which you can get by adding `.id` to your job."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "0bb09636-cfbf-480d-aa53-734cd5a11c07",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "job = job_wrapper(qbraid_ibm_job.id)\n",
+ "job.status()"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "2c65961f-540e-43dc-b318-c57d86e31751",
+ "metadata": {},
+ "source": [
+ "You can use the `get_jobs` function to a return a list of your previously submitted quantum jobs, along with the status of each."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "3523429e-3341-4a57-80e3-2ad2fb9d3871",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "get_jobs()"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "4dedeb3d-a03c-4b70-b9f9-a7a7000eb045",
+ "metadata": {},
+ "source": [
+ "This `qBraidID` can be used to reinstantiate a qBraid QuantumJob object at any time, and even in a separate program, with no loss of information."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "848add3e-1059-4726-be73-855fb8a7adad",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "job = job_wrapper(\"\")\n",
+ "job.status()"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "2ceac5e2-6738-473a-b993-cd3cf6da2e19",
+ "metadata": {},
+ "source": [
+ "After the job has completed, we’ll gather the result, print the measurement counts, and plot a histogram of the count by using `qbraid.visualization.plot_histogram`"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "3d39b177-e2a5-41d4-8752-a946cb475f7a",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "ibm_result = job.result()"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "bc1bfa7a-b16e-4b71-b949-662f54a6c141",
+ "metadata": {
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "from qbraid.visualization import plot_histogram, plot_distribution\n",
+ "\n",
+ "plot_histogram(ibm_result.measurement_counts())"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "b1cb7df6-d68d-4273-b243-98b79f759f11",
+ "metadata": {},
+ "source": [
+ "Also, you can plot a histogram of a probability with `plot_distribution`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "50af7aa6-bd20-4224-9a94-e447768d869d",
+ "metadata": {},
+ "outputs": [],
+ "source": [
+ "plot_distribution(ibm_result.measurement_counts())"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "6a0395af-a533-41e8-9852-d7af847def13",
+ "metadata": {},
+ "outputs": [],
+ "source": []
+ }
+ ],
+ "metadata": {
+ "kernelspec": {
+ "display_name": "Python 3 (ipykernel)",
+ "language": "python",
+ "name": "python3"
+ },
+ "language_info": {
+ "codemirror_mode": {
+ "name": "ipython",
+ "version": 3
+ },
+ "file_extension": ".py",
+ "mimetype": "text/x-python",
+ "name": "python",
+ "nbconvert_exporter": "python",
+ "pygments_lexer": "ipython3",
+ "version": "3.9.0"
+ }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/qbraid_sdk/img/ibm_api_token.png b/qbraid_sdk/img/ibm_api_token.png
new file mode 100644
index 0000000000000000000000000000000000000000..b040d931d2b16319f0fd1f6edfe357832691598b
GIT binary patch
literal 462405
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%0AZF{Gk
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[](\"./img/ibm_api_token.png\")
\n",
+ "\n",
+ "If you are using `Open Plan` you can run your quantum circuits on IBM quantum systems for free (up to 10 minutes quantum time per month). See [IBM Quantum access plans](https://www.ibm.com/quantum/pricing) for details.\n",
+ "\n",
+ "## 1. Using Qiskit Runtime Provider\n",
+ "\n",
+ "Now you can start using IBM Quantum Backends by calling QiskitRuntimeService with your API Credential replace `