QuantumRingsLib 0.11.2000__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: QuantumRingsLib
|
|
3
|
+
Version: 0.11.2000
|
|
4
|
+
Summary: A Quantum Development Library
|
|
5
|
+
Author-email: "Quantum Rings Inc." <contact@quantumrings.com>
|
|
6
|
+
Project-URL: Homepage, https://www.quantumrings.com
|
|
7
|
+
Project-URL: Documentation, https://portal.quantumrings.com/doc/
|
|
8
|
+
Project-URL: API Reference, https://portal.quantumrings.com/doc/modules.html
|
|
9
|
+
Keywords: quantum,quantum circuit,quantum computing,quantum programming language,quantum register,quantum tools,tools,sdk
|
|
10
|
+
Classifier: Development Status :: 4 - Beta
|
|
11
|
+
Classifier: Environment :: Console
|
|
12
|
+
Classifier: Intended Audience :: Developers
|
|
13
|
+
Classifier: Intended Audience :: Science/Research
|
|
14
|
+
Classifier: Topic :: Software Development :: Build Tools
|
|
15
|
+
Classifier: Topic :: Scientific/Engineering
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
20
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
21
|
+
Classifier: Operating System :: Microsoft :: Windows
|
|
22
|
+
Requires-Python: >=3.11
|
|
23
|
+
Description-Content-Type: text/x-rst
|
|
24
|
+
License-File: LICENSE.rst
|
|
25
|
+
Requires-Dist: quantumrings-cpu
|
|
26
|
+
Dynamic: license-file
|
|
27
|
+
|
|
28
|
+
================================================
|
|
29
|
+
Welcome to the Quantum Rings SDK (CPU only mode)
|
|
30
|
+
================================================
|
|
31
|
+
|
|
32
|
+
This document serves as a guide for installing the Quantum Rings SDK in the CPU-only mode. Before starting the installation process, please review the sections
|
|
33
|
+
that outline the minimum system requirements.
|
|
34
|
+
|
|
35
|
+
Additionally, the section titled "Feedback and Getting Support" provides links for submitting feedback or obtaining further assistance.
|
|
36
|
+
|
|
37
|
+
Finding the Latest Version of the SDK
|
|
38
|
+
-------------------------------------
|
|
39
|
+
|
|
40
|
+
The most recent versions of the SDK are:
|
|
41
|
+
|
|
42
|
+
- 0.11.2311 -- For Python 3.11 based installations
|
|
43
|
+
- 0.11.2312 -- For Python 3.12 based installations
|
|
44
|
+
- 0.11.2313 -- For Python 3.13 based installations
|
|
45
|
+
- 0.11.2314 -- For Python 3.14 based installations
|
|
46
|
+
|
|
47
|
+
We recommend you to use ``pip install quantumrings[cpu]`` and allow the system to find the latest compatible version.
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
Minimum System Requirements
|
|
51
|
+
---------------------------
|
|
52
|
+
|
|
53
|
+
A system with specifications exceeding the minimum requirements is recommended.
|
|
54
|
+
Lower specifications may limit the number of qubits supported and could result in poor performance.
|
|
55
|
+
|
|
56
|
+
- Operating systems recommended:
|
|
57
|
+
|
|
58
|
+
- Ubuntu 22.04.4 LTS
|
|
59
|
+
- Ubuntu 24.04.4 LTS
|
|
60
|
+
- Windows 11 Pro
|
|
61
|
+
- macOS 15 (Only CPU mode and official Python builds are supported. For more information, visit www.python.org.)
|
|
62
|
+
- WSL2 based Linux instances
|
|
63
|
+
|
|
64
|
+
- 64-bit Intel i9 x86 CPU (14 cores 20 logical processors recommended) or equivalent
|
|
65
|
+
|
|
66
|
+
- Intel processors or Apple Silicon on Mac Systems
|
|
67
|
+
|
|
68
|
+
- NVIDIA Grace Blackwell 10 Superchip
|
|
69
|
+
|
|
70
|
+
- DDR5 or better memory channels recommended
|
|
71
|
+
|
|
72
|
+
- 32 GB Installed physical memory
|
|
73
|
+
|
|
74
|
+
- 18 GB Available physical memory (memory requirement is dependent on the quantum circuit executed)
|
|
75
|
+
|
|
76
|
+
- 64-bit Python version 3.11, 3.12, 3.13, or 3.14
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
======================
|
|
80
|
+
Installation Procedure
|
|
81
|
+
======================
|
|
82
|
+
|
|
83
|
+
**STEP - 1**
|
|
84
|
+
|
|
85
|
+
To obtain your license for the `Quantum Rings SDK <https://www.quantumrings.com/>`_, register by selecting the **Login** option from the menu.
|
|
86
|
+
|
|
87
|
+
If you are already registered, you can skip this step.
|
|
88
|
+
|
|
89
|
+
Next, log in to the `Quantum Rings portal <https://portal.quantumrings.com/developer/>`_. To download your access keys, select the **Manage Keys** option in the left sidebar.
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
**STEP - 2**
|
|
93
|
+
|
|
94
|
+
Create a virtual environment for your Python version using the following example from your terminal.
|
|
95
|
+
|
|
96
|
+
.. code-block:: console
|
|
97
|
+
|
|
98
|
+
virtualenv --python=/usr/bin/python3.11 myenv311
|
|
99
|
+
source myenv311/bin/activate
|
|
100
|
+
|
|
101
|
+
In some installations, the virtual environment can be created as follows:
|
|
102
|
+
|
|
103
|
+
.. code-block:: console
|
|
104
|
+
|
|
105
|
+
python3.11 -m venv myenv311
|
|
106
|
+
source myenv311/bin/activate
|
|
107
|
+
|
|
108
|
+
Note that installing a Python virtual environment may require additional steps.
|
|
109
|
+
|
|
110
|
+
You can optionally install Jupyter Notebook using the following command.
|
|
111
|
+
|
|
112
|
+
.. code-block:: console
|
|
113
|
+
|
|
114
|
+
pip install notebook
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
**STEP - 3**
|
|
118
|
+
|
|
119
|
+
Install the Quantum Rings SDK using the following command:
|
|
120
|
+
|
|
121
|
+
.. code-block:: console
|
|
122
|
+
|
|
123
|
+
pip install QuantumRingsLib
|
|
124
|
+
|
|
125
|
+
or
|
|
126
|
+
|
|
127
|
+
.. code-block:: console
|
|
128
|
+
|
|
129
|
+
pip install quantumrings[cpu]
|
|
130
|
+
|
|
131
|
+
|
|
132
|
+
**STEP - 4**
|
|
133
|
+
|
|
134
|
+
Try running the following Python program in your Jupyter notebook to ensure everything is functioning correctly.
|
|
135
|
+
|
|
136
|
+
.. code-block:: python
|
|
137
|
+
|
|
138
|
+
import QuantumRingsLib
|
|
139
|
+
from QuantumRingsLib import QuantumRegister, AncillaRegister, ClassicalRegister, QuantumCircuit
|
|
140
|
+
from QuantumRingsLib import QuantumRingsProvider
|
|
141
|
+
from QuantumRingsLib import job_monitor
|
|
142
|
+
from QuantumRingsLib import JobStatus
|
|
143
|
+
from QuantumRingsLib import OptimizeQuantumCircuit
|
|
144
|
+
from matplotlib import pyplot as plt
|
|
145
|
+
import numpy as np
|
|
146
|
+
import math
|
|
147
|
+
|
|
148
|
+
provider = QuantumRingsProvider(token =<YOUR_TOKEN_HERE>, name=<YOUR_ACCOUNT_NAME_HERE>)
|
|
149
|
+
backend = provider.get_backend("scarlet_quantum_rings")
|
|
150
|
+
numberofqubits = 50
|
|
151
|
+
shots = 100
|
|
152
|
+
|
|
153
|
+
q = QuantumRegister(numberofqubits , 'q')
|
|
154
|
+
c = ClassicalRegister(numberofqubits , 'c')
|
|
155
|
+
qc = QuantumCircuit(q, c)
|
|
156
|
+
|
|
157
|
+
qc.h(0)
|
|
158
|
+
for i in range (qc.num_qubits - 1):
|
|
159
|
+
qc.cnot(i, i + 1)
|
|
160
|
+
|
|
161
|
+
qc.measure_all()
|
|
162
|
+
|
|
163
|
+
job = backend.run(qc, shots=shots)
|
|
164
|
+
job_monitor(job)
|
|
165
|
+
|
|
166
|
+
result = job.result()
|
|
167
|
+
counts = result.get_counts()
|
|
168
|
+
|
|
169
|
+
|
|
170
|
+
============================
|
|
171
|
+
Feedback and getting support
|
|
172
|
+
============================
|
|
173
|
+
|
|
174
|
+
We love to hear from you! Please join our `Discord community <https://discord.com/invite/dZJvX5AfkS>`_ to discuss anything quantum computing.
|
|
175
|
+
|
|
176
|
+
|
|
177
|
+
`SDK Documentation <https://portal.quantumrings.com/doc/>`_
|
|
178
|
+
|
|
179
|
+
`FAQ <https://portal.quantumrings.com/developer/support/>`_ (Requires you to login)
|
|
180
|
+
|
|
181
|
+
`Managing your license keys <https://portal.quantumrings.com/developer/keys/>`_ (Requires you to login)
|
|
182
|
+
|
|
183
|
+
`Need more qubits? Request here <https://portal.quantumrings.com/developer/keys/>`_ (Requires you to login)
|
|
184
|
+
|
|
185
|
+
|
|
186
|
+
|
|
187
|
+
|
|
188
|
+
|
|
189
|
+
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
quantumringslib-0.11.2000.dist-info/licenses/LICENSE.rst,sha256=gjTOlalh8rQGN2uJb06TX4RSNaISgdysUpj5kfl45kE,11097
|
|
2
|
+
quantumringslib-0.11.2000.dist-info/METADATA,sha256=g4mMNOUAqPF73t0XUke5TPa37Jkc9WQ87xM-XBFuWr8,6202
|
|
3
|
+
quantumringslib-0.11.2000.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
|
|
4
|
+
quantumringslib-0.11.2000.dist-info/top_level.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
|
|
5
|
+
quantumringslib-0.11.2000.dist-info/RECORD,,
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
|
|
2
|
+
====================
|
|
3
|
+
EVALUATION AGREEMENT
|
|
4
|
+
====================
|
|
5
|
+
|
|
6
|
+
**IMPORTANT:** PLEASE READ THIS EVALUATION AGREEMENT ("**AGREEMENT**") BEFORE CLICKING THE "ACCEPT" BUTTON, AND/OR USING
|
|
7
|
+
THE QUANTUM RINGS, INC. (**"QUANTUM"**) PRODUCT THAT ACCOMPANIES OR IS PROVIDED IN CONNECTION WITH THIS AGREEMENT. BY
|
|
8
|
+
CLICKING THE "ACCEPT" BUTTON, AND/OR USING THE SERVICES IN ANY WAY, YOU AND THE ENTITY THAT YOU REPRESENT ("**EVALUATOR**")
|
|
9
|
+
IS UNCONDITIONALLY CONSENTING TO BE BOUND BY AND IS BECOMING A PARTY TO THIS AGREEMENT WITH QUANTUM AND YOU REPRESENT
|
|
10
|
+
AND WARRANT THAT YOU HAVE THE AUTHORITY TO BIND SUCH ENTITY TO THESE TERMS. IF EVALUATOR DOES NOT UNCONDITIONALLY AGREE
|
|
11
|
+
TO ALL OF THE TERMS OF THIS AGREEMENT, USE OF THE SERVICES IS STRICTLY PROHIBITED. IF EVALUATOR HAS EXECUTED, OR
|
|
12
|
+
SUBSEQUENTLY EXECUTES, AN EVALUATION AGREEMENT OR AN END USER AGREEMENT WITH QUANTUM, THEN THE TERMS AND
|
|
13
|
+
CONDITIONS OF SUCH EXECUTED EVALUATION AGREEMENT OR END USER AGREEMENT, AS APPLICABLE, SHALL GOVERN AND CONTROL
|
|
14
|
+
YOUR USE OF THE PRODUCT.
|
|
15
|
+
|
|
16
|
+
1. **BETA SERVICES**. Quantum is developing a proprietary, set of development tools for quantum computing (the
|
|
17
|
+
"**Services**"). Evaluator wishes to utilize an evaluation "beta" version of the Services, and Quantum desires to make a beta
|
|
18
|
+
version of the Services available to Evaluator, subject to the following terms and conditions. Subject to the terms and
|
|
19
|
+
conditions of this Agreement, Quantum hereby grants Evaluator, during the Term (as defined below), non-exclusive,
|
|
20
|
+
non-transferable, non-sublicensable right and license to access and use the Services solely for the purpose of evaluating the
|
|
21
|
+
performance and functionality of the Services (the "**Limited Purpose**"). Evaluator agrees to use and evaluate the Services for
|
|
22
|
+
a period of ninty days or such other period of time as mutually agreed by the parties in writing (the "**Term**"). Quantum's
|
|
23
|
+
services outside the scope of this Agreement, if any, shall be provided pursuant to Quantum's then-current applicable services
|
|
24
|
+
policies and procedures ("**Other Terms**"). Nothing in any of Quantum's Other Terms or any other existing agreements that
|
|
25
|
+
Evaluator may have with Quantum apply to or are applicable to this Agreement, or Evaluator's use of the Services offered
|
|
26
|
+
hereunder.
|
|
27
|
+
|
|
28
|
+
2. **INTELLECTUAL PROPERTY.** The Services (excluding the Evaluator Content hosted thereon), Documentation, and all
|
|
29
|
+
other materials provided by Quantum hereunder, including but not limited to all manuals, reports, records, programs, data and
|
|
30
|
+
other materials, and all intellectual property rights in each of the foregoing, are the exclusive property of Quantum and its
|
|
31
|
+
suppliers. Evaluator agrees that it will not, and will not permit any other party to: (a) permit any party to access the Services
|
|
32
|
+
or any accompanying documentation ("**Documentation**"); (b) modify, adapt, alter or translate the Services or
|
|
33
|
+
Documentation; (c) sublicense, lease, rent, loan, distribute, or otherwise transfer the Services or Documentation to any third
|
|
34
|
+
party; (d) reverse engineer, decompile, disassemble, or otherwise derive or determine or attempt to derive or determine the
|
|
35
|
+
source code (or the underlying ideas, algorithms, structure or organization) of the Services; (e) use or copy the Services or
|
|
36
|
+
Documentation except for the Limited Purpose; or (f) publish or disclose to any third party any performance benchmark tests
|
|
37
|
+
or analyses or other non-public information relating to the Services or the use thereof.
|
|
38
|
+
|
|
39
|
+
3. **FEEDBACK.** Evaluator understands and agrees that the Services represent a beta test version of unreleased software
|
|
40
|
+
and services that may contain bugs, defects, and errors. In exchange for the licenses granted to Evaluator to use such
|
|
41
|
+
software, Evaluator agrees to use good faith efforts to test, use, and evaluate the Services in live operations, and to promptly
|
|
42
|
+
report to Quantum, either orally or in writing, any errors, problems, defects, or suggestions for changes and improvements to
|
|
43
|
+
the Services (collectively, "**Feedback**"). Evaluator acknowledges and agrees that all Feedback and all intellectual property
|
|
44
|
+
rights therein are the exclusive property of Quantum, and hereby assigns to Quantum, all right, title and interest to any and all
|
|
45
|
+
Feedback. Further, Evaluator acknowledges and agrees that Feedback may be used by Quantum in Quantum's development
|
|
46
|
+
of and be incorporated into a version of the Services Quantum may make available for commercial distribution
|
|
47
|
+
("**Commercial Release**") or any other software or intellectual property created by Quantum. Without limiting the foregoing,
|
|
48
|
+
Quantum may incorporate Feedback into its products and services and Evaluator will gain no rights in such products or
|
|
49
|
+
services by virtue of having disclosed Feedback. Evaluator agrees and acknowledges that the products and services
|
|
50
|
+
incorporating such Feedback will be the sole and exclusive property of Quantum, and Evaluator will gain no right, title or
|
|
51
|
+
interest in or to the Services, Documentation or any Commercial Release by virtue of Evaluator's provision of Feedback to
|
|
52
|
+
Quantum or for any other reason. Quantum has no obligation to create, distribute or otherwise offer a Commercial Release,
|
|
53
|
+
and in the event of such Commercial Release, Quantum has no obligation to offer the Commercial Release to Evaluator or to
|
|
54
|
+
offer Evaluator any discounted pricing schedules or special terms. Evaluator understands and agrees that the Commercial
|
|
55
|
+
Release may contain functions and functionality, and perform in a manner significantly different from the current beta version
|
|
56
|
+
of the Services. Accordingly, Evaluator acknowledges that any research or development performed, or business plans made,
|
|
57
|
+
by Evaluator regarding or in reliance upon the Services are done entirely at Evaluator's own risk.
|
|
58
|
+
|
|
59
|
+
4. **DISCLAIMERS OF WARRANTIES.** Evaluator acknowledges that the Services contain prerelease code for testing
|
|
60
|
+
purposes only and are not at the level of performance and compatibility of a final, generally available product offering.
|
|
61
|
+
Furthermore, Evaluator acknowledges that the Services may contain bugs, errors, omissions and other problems that could
|
|
62
|
+
cause system or other failures and data loss. Evaluator acknowledges that Quantum may not introduce a product similar to or
|
|
63
|
+
compatible with the Services. Accordingly, Evaluator acknowledges that any research, development or other work that
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
Evaluator performs regarding the Services is done entirely at Evaluator's own risk. To the maximum extent permitted by law,
|
|
67
|
+
the Services, and all other documentation and materials are provided "AS IS" AND WITH ALL FAULTS. QUANTUM
|
|
68
|
+
MAKES NO WARRANTIES WITH RESPECT TO THE SERVICES OR DOCUMENTATION, WHETHER EXPRESS OR
|
|
69
|
+
IMPLIED, INCLUDING WARRANTIES OF TITLE, ACCURACY, INTERFERENCE WITH EVALUATOR'S QUIET
|
|
70
|
+
ENJOYMENT, SYSTEM INTEGRATION, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A
|
|
71
|
+
PARTICULAR PURPOSE. THE ENTIRE RISK ARISING OUT OF THE USE OR PERFORMANCE OF THE SERVICES
|
|
72
|
+
IS WITH EVALUATOR NO ORAL OR WRITTEN INFORMATION OR ADVICE GIVEN BY QUANTUM OR ITS
|
|
73
|
+
AGENTS OR EMPLOYEES SHALL IN ANY WAY INCREASE THE SCOPE OF THIS WARRANTY.
|
|
74
|
+
|
|
75
|
+
5. **LIMITATION OF LIABILITY.** IN NO EVENT WILL QUANTUM OR ITS LICENSORS (IF ANY) BE LIABLE TO
|
|
76
|
+
EVALUATOR OR ANY THIRD PARTY FOR THE COST OF PROCUREMENT OF SUBSTITUTE SERVICES, LOST
|
|
77
|
+
PROFITS, LOST DATA, OR ANY SPECIAL, INDIRECT, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE
|
|
78
|
+
DAMAGES, HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY ARISING IN ANY WAY OUT OF THIS
|
|
79
|
+
AGREEMENT OR EVALUATOR'S USE OF THE SERVICES, EVEN IF QUANTUM HAS BEEN ADVISED OF THE
|
|
80
|
+
POSSIBILITY OF SUCH DAMAGES. THE TOTAL CUMULATIVE LIABILITY, RELATED TO THIS AGREEMENT,
|
|
81
|
+
OF QUANTUM AND ITS LICENSORS (IF ANY) SHALL BE LIMITED TO FIFTY DOLLARS (U.S. $50). The parties
|
|
82
|
+
agree that the limitations of liability set forth in this section shall survive and continue in full force and effect despite any
|
|
83
|
+
failure of consideration or of an exclusive remedy. The parties acknowledge that the prices have been set and the Agreement
|
|
84
|
+
entered into in reliance upon these limitations of liability and that all such limitations form an essential basis of the bargain
|
|
85
|
+
between the parties.
|
|
86
|
+
|
|
87
|
+
6. **CONFIDENTIALITY.** The structure, sequence, organization and code of the software used to provide the Services
|
|
88
|
+
constitute valuable trade secrets of Quantum and its suppliers. Evaluator will not disclose to any third party: any information
|
|
89
|
+
about the Services, including its existence, design, performance characteristics, feedback, and test results. Evaluator will use
|
|
90
|
+
reasonable efforts to prevent any access to the Services by anyone other than its employees who are obligated to comply with
|
|
91
|
+
the terms hereof.
|
|
92
|
+
|
|
93
|
+
7. **PRODUCT DIAGNOSTIC REPORTING.** Evaluator acknowledges that the Services will store certain diagnostic information
|
|
94
|
+
about the routine operations of the Services (including, without limitation, its performance, data reduction ratios,
|
|
95
|
+
configuration data, and any software faults) and will periodically transmit this diagnostic information to Quantum. Evaluator
|
|
96
|
+
agrees that Quantum has a perpetual, irrevocable, worldwide, sublicenseable, and royalty-free right to use this diagnostic
|
|
97
|
+
information in any manner and that Evaluator will not interfere with the collection or transmission of such information to
|
|
98
|
+
Quantum. For clarification, there is no actual user data of Evaluator that is transmitted or provided to Quantum.
|
|
99
|
+
|
|
100
|
+
8. **TERM AND TERMINATION.** This Agreement commences upon the Effective Date and will continue in effect until the
|
|
101
|
+
end of the Term. Either party may terminate this Agreement upon written notice to the other party. Upon termination,
|
|
102
|
+
Evaluator shall immediately cease all use of Services, and delete or destroy all copies of the Documentation in the possession
|
|
103
|
+
or control of Evaluator.
|
|
104
|
+
|
|
105
|
+
9. **GENERAL PROVISIONS.** This Agreement will be governed by the laws of the State of Colorado. Evaluator submits to
|
|
106
|
+
the exclusive jurisdiction and venue of the federal and state courts located in Denver County, Colorado for any disputes
|
|
107
|
+
arising out of or related to this Agreement. Evaluator may not assign or transfer, by operation of law, change of control or
|
|
108
|
+
otherwise, any of its rights under this Agreement to any third party without Quantum's prior written consent. Any attempted
|
|
109
|
+
assignment or transfer in violation of the foregoing will be void. All waivers must be in writing. Any waiver or failure to
|
|
110
|
+
enforce any provision of this Agreement on one occasion will not be deemed a waiver of any other provision or of such
|
|
111
|
+
provision on any other occasion. If any part of this Agreement is found void and unenforceable, it will not affect the validity
|
|
112
|
+
of the balance of this Agreement, which shall remain valid and enforceable according to its terms. If any provision of this
|
|
113
|
+
Agreement is, for any reason, held to be invalid or unenforceable, the other provisions of this Agreement will remain
|
|
114
|
+
enforceable and the invalid or unenforceable provision will be deemed modified so that it is valid and enforceable to the
|
|
115
|
+
maximum extent permitted by law.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|