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,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (80.9.0)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
@@ -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.