From 55378f533fe73862285f2fe392bb9425e0312f80 Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Mon, 12 Feb 2018 11:58:38 +0100 Subject: [PATCH 01/34] Bumped to version: 0.4.9 --- CMakeLists.txt | 2 +- qiskit/__init__.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index f5240f27b3db..0a2e15cd239e 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required (VERSION 3.5 FATAL_ERROR) -project (QISKit VERSION 0.5.0 LANGUAGES CXX) +project (QISKit VERSION 0.4.9 LANGUAGES CXX) # Verbose!! set(CMAKE_VERBOSE_MAKEFILE True) diff --git a/qiskit/__init__.py b/qiskit/__init__.py index 1288be73f0ca..275198a23e3d 100644 --- a/qiskit/__init__.py +++ b/qiskit/__init__.py @@ -41,6 +41,6 @@ from ._result import Result from ._util import _check_ibmqe_version -__version__ = '0.5.0' +__version__ = '0.4.9' _check_ibmqe_version() From 712e266f98101a80bcfa2e89f13d297ebc7c8f65 Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Tue, 6 Mar 2018 15:23:26 +0100 Subject: [PATCH 02/34] pip release: 0.4.10 --- CMakeLists.txt | 2 +- qiskit/__init__.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index b89bd5d2016a..661bb19bdf14 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required (VERSION 3.5 FATAL_ERROR) -project (QISKit VERSION 0.4.9 LANGUAGES CXX) +project (QISKit VERSION 0.4.10 LANGUAGES CXX) # Verbose!! set(CMAKE_VERBOSE_MAKEFILE True) diff --git a/qiskit/__init__.py b/qiskit/__init__.py index 275198a23e3d..9e43321c0f94 100644 --- a/qiskit/__init__.py +++ b/qiskit/__init__.py @@ -41,6 +41,6 @@ from ._result import Result from ._util import _check_ibmqe_version -__version__ = '0.4.9' +__version__ = '0.4.10' _check_ibmqe_version() From a9701f63fa5a7c8621a264063ef2eb379b6efd9d Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Tue, 13 Mar 2018 18:37:03 +0100 Subject: [PATCH 03/34] pip release: 0.4.11 --- CMakeLists.txt | 2 +- qiskit/__init__.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index 661bb19bdf14..a07c40accb27 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required (VERSION 3.5 FATAL_ERROR) -project (QISKit VERSION 0.4.10 LANGUAGES CXX) +project (QISKit VERSION 0.4.11 LANGUAGES CXX) # Verbose!! set(CMAKE_VERBOSE_MAKEFILE True) diff --git a/qiskit/__init__.py b/qiskit/__init__.py index 9e43321c0f94..69b4ff6d654b 100644 --- a/qiskit/__init__.py +++ b/qiskit/__init__.py @@ -41,6 +41,6 @@ from ._result import Result from ._util import _check_ibmqe_version -__version__ = '0.4.10' +__version__ = '0.4.11' _check_ibmqe_version() From e9b16190be0370a458d3b44ff32e16c078a7223c Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Wed, 11 Apr 2018 11:38:27 +0200 Subject: [PATCH 04/34] pip release : 0.4.12 --- CMakeLists.txt | 2 +- qiskit/__init__.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index a07c40accb27..fdf1a82561bc 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required (VERSION 3.5 FATAL_ERROR) -project (QISKit VERSION 0.4.11 LANGUAGES CXX) +project (QISKit VERSION 0.4.12 LANGUAGES CXX) # Verbose!! set(CMAKE_VERBOSE_MAKEFILE True) diff --git a/qiskit/__init__.py b/qiskit/__init__.py index 3da34cbdbbf8..6473ebde8873 100644 --- a/qiskit/__init__.py +++ b/qiskit/__init__.py @@ -47,4 +47,4 @@ from . import backends -__version__ = '0.4.11' +__version__ = '0.4.12' From 1bf32a6a64cb1e1f86a28c07da2a9bffe0401ad0 Mon Sep 17 00:00:00 2001 From: "Diego M. Rodriguez" Date: Mon, 16 Apr 2018 14:17:44 +0200 Subject: [PATCH 05/34] Reintroduce remote discovery during qp.set_api() --- qiskit/_quantumprogram.py | 1 + 1 file changed, 1 insertion(+) diff --git a/qiskit/_quantumprogram.py b/qiskit/_quantumprogram.py index a43ef5830764..0829657b974c 100644 --- a/qiskit/_quantumprogram.py +++ b/qiskit/_quantumprogram.py @@ -722,6 +722,7 @@ def set_api(self, token, url, hub=None, group=None, project=None, if proxies: config_dict['proxies'] = proxies self.__api = IBMQuantumExperience(token, config_dict, verify) + qiskit.backends.discover_remote_backends(self.__api) except Exception as ex: root_exception = ex if 'License required' in str(ex): From 383a5b1f20b53348c9fbdeb8cc484554911b8ab0 Mon Sep 17 00:00:00 2001 From: "Diego M. Rodriguez" Date: Mon, 16 Apr 2018 16:27:30 +0200 Subject: [PATCH 06/34] Reintroduce dag2json for developer challenge --- qiskit/_openquantumcompiler.py | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/qiskit/_openquantumcompiler.py b/qiskit/_openquantumcompiler.py index a10f9a5a85ab..f5b40a93e0bf 100644 --- a/qiskit/_openquantumcompiler.py +++ b/qiskit/_openquantumcompiler.py @@ -133,6 +133,20 @@ def load_unroll_qasm_file(filename, basis_gates='u1,u2,u3,cx,id'): return circuit_unrolled +def dag2json(dag_circuit, basis_gates='u1,u2,u3,cx,id'): + """Make a Json representation of the circuit. + Takes a circuit dag and returns json circuit obj. This is an internal + function. + Args: + dag_circuit (QuantumCircuit): a dag representation of the circuit. + basis_gates (str): a comma seperated string and are the base gates, + which by default are: u1,u2,u3,cx,id + Returns: + json: the json version of the dag + """ + return DagUnroller(dag_circuit, JsonBackend(basis_gates)).execute() + + class QISKitCompilerError(QISKitError): """Exceptions raised during compilation""" pass From a83d4320f9e915a6dfa1310184750df98f4ec12d Mon Sep 17 00:00:00 2001 From: Ali Javadi Date: Mon, 16 Apr 2018 10:39:23 -0400 Subject: [PATCH 07/34] remove extra barriers temporarily from compile --- qiskit/_quantumprogram.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/qiskit/_quantumprogram.py b/qiskit/_quantumprogram.py index a43ef5830764..1fd63f861474 100644 --- a/qiskit/_quantumprogram.py +++ b/qiskit/_quantumprogram.py @@ -1179,8 +1179,8 @@ def compile(self, name_of_circuits=None, backend="local_qasm_simulator", set(measured_qubits)): raise QISKitError('backend "{0}" rejects gate after ' 'measurement in circuit "{1}"'.format(backend, name)) - for i, qubit in zip(qasm_idx, measured_qubits): - circuit.data.insert(i, Barrier([qubit], circuit)) + #for i, qubit in zip(qasm_idx, measured_qubits): + # circuit.data.insert(i, Barrier([qubit], circuit)) dag_circuit, final_layout = openquantumcompiler.compile( circuit, basis_gates=basis_gates, From c474af40d9a461bd3597b84837c392bed988f3cc Mon Sep 17 00:00:00 2001 From: Ali Javadi Date: Mon, 16 Apr 2018 10:50:29 -0400 Subject: [PATCH 08/34] remove commented lines --- qiskit/_quantumprogram.py | 14 -------------- 1 file changed, 14 deletions(-) diff --git a/qiskit/_quantumprogram.py b/qiskit/_quantumprogram.py index 1fd63f861474..194bfe6bbd75 100644 --- a/qiskit/_quantumprogram.py +++ b/qiskit/_quantumprogram.py @@ -1167,20 +1167,6 @@ def compile(self, name_of_circuits=None, backend="local_qasm_simulator", coupling_map = None if coupling_map == 'all-to-all': coupling_map = None - # if the backend is a real chip, insert barrier before measurements - if not backend_conf['simulator']: - measured_qubits = [] - qasm_idx = [] - for i, instruction in enumerate(circuit.data): - if isinstance(instruction, Measure): - measured_qubits.append(instruction.arg[0]) - qasm_idx.append(i) - elif isinstance(instruction, Gate) and bool(set(instruction.arg) & - set(measured_qubits)): - raise QISKitError('backend "{0}" rejects gate after ' - 'measurement in circuit "{1}"'.format(backend, name)) - #for i, qubit in zip(qasm_idx, measured_qubits): - # circuit.data.insert(i, Barrier([qubit], circuit)) dag_circuit, final_layout = openquantumcompiler.compile( circuit, basis_gates=basis_gates, From f06891f8a62b4bd3a425343241e145242c589333 Mon Sep 17 00:00:00 2001 From: Ali Javadi Date: Mon, 16 Apr 2018 10:57:29 -0400 Subject: [PATCH 09/34] remove extra imports --- qiskit/_quantumprogram.py | 3 --- 1 file changed, 3 deletions(-) diff --git a/qiskit/_quantumprogram.py b/qiskit/_quantumprogram.py index 194bfe6bbd75..b5f752f88cbc 100644 --- a/qiskit/_quantumprogram.py +++ b/qiskit/_quantumprogram.py @@ -43,9 +43,6 @@ from . import QISKitError from . import JobProcessor from . import QuantumJob -from . import Measure -from . import Gate -from .extensions.standard.barrier import Barrier from ._logging import set_qiskit_logger, unset_qiskit_logger # Beta Modules From b6ee1e549a37a6a723e47bac593aede2c44045c2 Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Mon, 16 Apr 2018 19:46:53 +0200 Subject: [PATCH 10/34] Remove TestQuantumProgram.test_gate_after_measure --- test/python/test_quantumprogram.py | 51 ------------------------------ 1 file changed, 51 deletions(-) diff --git a/test/python/test_quantumprogram.py b/test/python/test_quantumprogram.py index aedfad965cde..62cef024ecee 100644 --- a/test/python/test_quantumprogram.py +++ b/test/python/test_quantumprogram.py @@ -911,57 +911,6 @@ def test_change_circuit_qobj_after_compile(self): self.assertTrue(qobj2['circuits'][1]['config']['xvals'] == [ 'only for qobj2', 2, 3, 4]) - @requires_qe_access - def test_gate_after_measure(self, QE_TOKEN, QE_URL): - """Test that no gate is inserted after measure when compiling - for real backends. NEED internet connection for this. - - See: https://github.com/QISKit/qiskit-sdk-py/issues/342 - - TODO: (JAY) THIS IS VERY SYSTEM DEPENDENT AND NOT A GOOD TEST. I WOULD LIKE - TO DELETE THIS - """ - q_program = QuantumProgram() - qr = q_program.create_quantum_register('qr', 16) - cr = q_program.create_classical_register('cr', 16) - qc = q_program.create_circuit('emoticon', [qr], [cr]) - qc.x(qr[0]) - qc.x(qr[3]) - qc.x(qr[5]) - qc.h(qr[9]) - qc.cx(qr[9], qr[8]) - qc.x(qr[11]) - qc.x(qr[12]) - qc.x(qr[13]) - for j in range(16): - qc.measure(qr[j], cr[j]) - api = IBMQuantumExperience(QE_TOKEN, {'url': QE_URL}) - qiskit.backends.discover_remote_backends(api) - backend = 'ibmqx5' - coupling_map = [[1, 0], [1, 2], [2, 3], [3, 4], [3, 14], [5, 4], - [6, 5], [6, 7], [6, 11], [7, 10], [8, 7], [9, 8], - [9, 10], [11, 10], [12, 5], [12, 11], [12, 13], - [13, 4], [13, 14], [15, 0], [15, 2], [15, 14]] - - initial_layout = {('qr', 0): ('q', 1), ('qr', 1): ('q', 0), - ('qr', 2): ('q', 2), ('qr', 3): ('q', 3), - ('qr', 4): ('q', 4), ('qr', 5): ('q', 14), - ('qr', 6): ('q', 5), ('qr', 7): ('q', 6), - ('qr', 8): ('q', 7), ('qr', 9): ('q', 11), - ('qr', 10): ('q', 10), ('qr', 11): ('q', 8), - ('qr', 12): ('q', 9), ('qr', 13): ('q', 12), - ('qr', 14): ('q', 13), ('qr', 15): ('q', 15)} - qobj = q_program.compile(["emoticon"], backend=backend, - initial_layout=initial_layout, coupling_map=coupling_map) - measured_qubits = set() - has_gate_after_measure = False - for x in qobj["circuits"][0]["compiled_circuit"]["operations"]: - if x["name"] == "measure": - measured_qubits.add(x["qubits"][0]) - elif set(x["qubits"]) & measured_qubits: - has_gate_after_measure = True - self.assertFalse(has_gate_after_measure) - ############################################################### # Test for running programs ############################################################### From dc96b263ff6b4496656dae9c7b3e7f81d80de03b Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Mon, 16 Apr 2018 19:47:51 +0200 Subject: [PATCH 11/34] pip release: 0.4.13 --- CMakeLists.txt | 2 +- qiskit/__init__.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index fdf1a82561bc..772b3be1ef43 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required (VERSION 3.5 FATAL_ERROR) -project (QISKit VERSION 0.4.12 LANGUAGES CXX) +project (QISKit VERSION 0.4.13 LANGUAGES CXX) # Verbose!! set(CMAKE_VERBOSE_MAKEFILE True) diff --git a/qiskit/__init__.py b/qiskit/__init__.py index 6473ebde8873..2c141b9cfe57 100644 --- a/qiskit/__init__.py +++ b/qiskit/__init__.py @@ -47,4 +47,4 @@ from . import backends -__version__ = '0.4.12' +__version__ = '0.4.13' From af189eeeb3fd3b6cee1db41410f958de136619bc Mon Sep 17 00:00:00 2001 From: Ali Javadi Date: Wed, 18 Apr 2018 10:28:46 -0400 Subject: [PATCH 12/34] hotfix: basisGates --- qiskit/backends/_backendutils.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/qiskit/backends/_backendutils.py b/qiskit/backends/_backendutils.py index 699df09452ac..3e0521adddb4 100644 --- a/qiskit/backends/_backendutils.py +++ b/qiskit/backends/_backendutils.py @@ -110,7 +110,7 @@ def discover_remote_backends(api): if new_key not in ['id', 'serial_number', 'topology_id', 'status']: config_edit[new_key] = config[key] # online_qasm_simulator uses different name for basis_gates - if 'gateSet' in config: + if 'gateSet' in config and 'basisGates' not in config: config_edit['basis_gates'] = config['gateSet'] del config_edit['gate_set'] # ibmqx_qasm_simulator doesn't report coupling_map From 42b2446f525d7b1b6f3bb79a575de18b940be2bd Mon Sep 17 00:00:00 2001 From: Ali Javadi Date: Wed, 18 Apr 2018 10:58:38 -0400 Subject: [PATCH 13/34] fixing tests --- test/python/test_backends.py | 6 ++++++ test/python/test_quantumprogram.py | 6 ++++++ 2 files changed, 12 insertions(+) diff --git a/test/python/test_backends.py b/test/python/test_backends.py index 8a113966e2c0..aa1863b16304 100644 --- a/test/python/test_backends.py +++ b/test/python/test_backends.py @@ -101,6 +101,8 @@ def test_get_backend_configuration_online(self, QE_TOKEN, QE_URL): backend_list = qiskit.backends.discover_remote_backends(api) config_keys = {'name', 'simulator', 'local', 'description', 'coupling_map', 'basis_gates'} + backend_list.remove('ibmqx_hpc_qasm_simulator') + backend_list.remove('ibmqx_qasm_simulator') if backend_list: backend = backend_list[0] my_backend = qiskit.backends.get_backend_instance(backend) @@ -116,6 +118,8 @@ def test_get_backend_calibration(self, QE_TOKEN, QE_URL): """ api = IBMQuantumExperience(QE_TOKEN, {'url': QE_URL}) backend_list = qiskit.backends.discover_remote_backends(api) + backend_list.remove('ibmqx_hpc_qasm_simulator') + backend_list.remove('ibmqx_qasm_simulator') if backend_list: backend = backend_list[0] my_backend = qiskit.backends.get_backend_instance(backend) @@ -131,6 +135,8 @@ def test_get_backend_parameters(self, QE_TOKEN, QE_URL): """ api = IBMQuantumExperience(QE_TOKEN, {'url': QE_URL}) backend_list = qiskit.backends.discover_remote_backends(api) + backend_list.remove('ibmqx_hpc_qasm_simulator') + backend_list.remove('ibmqx_qasm_simulator') if backend_list: backend = backend_list[0] my_backend = qiskit.backends.get_backend_instance(backend) diff --git a/test/python/test_quantumprogram.py b/test/python/test_quantumprogram.py index 62cef024ecee..81eb2df79d33 100644 --- a/test/python/test_quantumprogram.py +++ b/test/python/test_quantumprogram.py @@ -672,6 +672,8 @@ def test_get_backend_configuration_online(self, QE_TOKEN, QE_URL): 'coupling_map', 'basis_gates'} api = IBMQuantumExperience(QE_TOKEN, {'url': QE_URL}) backend_list = qiskit.backends.discover_remote_backends(api) + backend_list.remove('ibmqx_hpc_qasm_simulator') + backend_list.remove('ibmqx_qasm_simulator') if backend_list: backend = backend_list[0] backend_config = qp.get_backend_configuration(backend) @@ -697,6 +699,8 @@ def test_get_backend_calibration(self, QE_TOKEN, QE_URL): q_program = QuantumProgram(specs=self.QPS_SPECS) api = IBMQuantumExperience(QE_TOKEN, {'url': QE_URL}) backend_list = qiskit.backends.discover_remote_backends(api) + backend_list.remove('ibmqx_hpc_qasm_simulator') + backend_list.remove('ibmqx_qasm_simulator') if backend_list: backend = backend_list[0] result = q_program.get_backend_calibration(backend) @@ -713,6 +717,8 @@ def test_get_backend_parameters(self, QE_TOKEN, QE_URL): q_program = QuantumProgram(specs=self.QPS_SPECS) api = IBMQuantumExperience(QE_TOKEN, {'url': QE_URL}) backend_list = qiskit.backends.discover_remote_backends(api) + backend_list.remove('ibmqx_hpc_qasm_simulator') + backend_list.remove('ibmqx_qasm_simulator') if backend_list: backend = backend_list[0] result = q_program.get_backend_parameters(backend) From 5ffa83a7ac73a8ab28ee831be187230271cb965c Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Wed, 18 Apr 2018 18:08:44 +0200 Subject: [PATCH 14/34] pip release: 0.4.14 --- CMakeLists.txt | 2 +- qiskit/__init__.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index 772b3be1ef43..37af5d0c2097 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required (VERSION 3.5 FATAL_ERROR) -project (QISKit VERSION 0.4.13 LANGUAGES CXX) +project (QISKit VERSION 0.4.14 LANGUAGES CXX) # Verbose!! set(CMAKE_VERBOSE_MAKEFILE True) diff --git a/qiskit/__init__.py b/qiskit/__init__.py index 2c141b9cfe57..ab6d7fc03ddb 100644 --- a/qiskit/__init__.py +++ b/qiskit/__init__.py @@ -47,4 +47,4 @@ from . import backends -__version__ = '0.4.13' +__version__ = '0.4.14' From 2e4cb3acaf1b88b016a5b61d96f2a99c5ba125a4 Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Mon, 7 May 2018 19:48:50 +0200 Subject: [PATCH 15/34] pip release: 0.4.15 (#454) pip release: 0.4.15 * Fixed a bug with legacy code affecting Developer Challenge * Disabled util_tests temporarily --- CMakeLists.txt | 2 +- qiskit/__init__.py | 2 +- qiskit/_openquantumcompiler.py | 2 +- test/python/test_util.py | 2 ++ 4 files changed, 5 insertions(+), 3 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index 37af5d0c2097..afb8a4b3da1b 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required (VERSION 3.5 FATAL_ERROR) -project (QISKit VERSION 0.4.14 LANGUAGES CXX) +project (QISKit VERSION 0.4.15 LANGUAGES CXX) # Verbose!! set(CMAKE_VERBOSE_MAKEFILE True) diff --git a/qiskit/__init__.py b/qiskit/__init__.py index ab6d7fc03ddb..4f86b4db6b1a 100644 --- a/qiskit/__init__.py +++ b/qiskit/__init__.py @@ -47,4 +47,4 @@ from . import backends -__version__ = '0.4.14' +__version__ = '0.4.15' diff --git a/qiskit/_openquantumcompiler.py b/qiskit/_openquantumcompiler.py index f5b40a93e0bf..f12001141da8 100644 --- a/qiskit/_openquantumcompiler.py +++ b/qiskit/_openquantumcompiler.py @@ -144,7 +144,7 @@ def dag2json(dag_circuit, basis_gates='u1,u2,u3,cx,id'): Returns: json: the json version of the dag """ - return DagUnroller(dag_circuit, JsonBackend(basis_gates)).execute() + return DagUnroller(dag_circuit, JsonBackend(basis_gates.split(","))).execute() class QISKitCompilerError(QISKitError): diff --git a/test/python/test_util.py b/test/python/test_util.py index 5bfedc0ad15b..7b8b0669430c 100644 --- a/test/python/test_util.py +++ b/test/python/test_util.py @@ -16,6 +16,7 @@ # ============================================================================= """Tests for qiskit/_util.py""" +import unittest from qiskit._util import _check_ibmqx_version from .common import QiskitTestCase @@ -23,6 +24,7 @@ class TestUtil(QiskitTestCase): """Tests for qiskit/_util.py""" + @unittest.skip("Temporary skipping") def test_check_ibmqx_version(self): """Requiered IBMQE version.""" with self.assertNoLogs('qiskit._util', level='WARNING'): From 95bba4c8d9d5c52b4c54ac2a1a579864d4965fe7 Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Fri, 11 May 2018 21:27:30 +0200 Subject: [PATCH 16/34] pip release: 0.5.0 --- CMakeLists.txt | 2 +- qiskit/__init__.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index 292a1233bebe..9f2224c9833a 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required (VERSION 3.5 FATAL_ERROR) -project (QISKit VERSION 0.4.15 LANGUAGES CXX) +project (QISKit VERSION 0.5.0 LANGUAGES CXX) # Verbose!! set(CMAKE_VERBOSE_MAKEFILE True) diff --git a/qiskit/__init__.py b/qiskit/__init__.py index ae7b119cd367..a242d6ec82ab 100644 --- a/qiskit/__init__.py +++ b/qiskit/__init__.py @@ -46,4 +46,4 @@ # Import the wrapper, to make it available when doing "import qiskit". from . import wrapper -__version__ = '0.4.15' +__version__ = '0.5.0' From 35ccf4cce82ed1a70e9f7426cab7b9421526070c Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Tue, 15 May 2018 09:54:32 +0200 Subject: [PATCH 17/34] pip release: 0.5.1 * No code changes this time. There was problem with the MacOS Wheel package. We cannot overwrite a Wheel package on PyPi without bumping up software version number. --- CMakeLists.txt | 2 +- qiskit/__init__.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index 9f2224c9833a..f8ec0b002856 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required (VERSION 3.5 FATAL_ERROR) -project (QISKit VERSION 0.5.0 LANGUAGES CXX) +project (QISKit VERSION 0.5.1 LANGUAGES CXX) # Verbose!! set(CMAKE_VERBOSE_MAKEFILE True) diff --git a/qiskit/__init__.py b/qiskit/__init__.py index a242d6ec82ab..5400432f0b5e 100644 --- a/qiskit/__init__.py +++ b/qiskit/__init__.py @@ -46,4 +46,4 @@ # Import the wrapper, to make it available when doing "import qiskit". from . import wrapper -__version__ = '0.5.0' +__version__ = '0.5.1' From bd02233ed2bbf7ae990866c5aa578c8f5c64be3d Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Mon, 21 May 2018 12:16:53 +0200 Subject: [PATCH 18/34] pip release: 0.5.2 --- CMakeLists.txt | 2 +- qiskit/__init__.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index f8ec0b002856..be85e0709c42 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required (VERSION 3.5 FATAL_ERROR) -project (QISKit VERSION 0.5.1 LANGUAGES CXX) +project (QISKit VERSION 0.5.2 LANGUAGES CXX) # Verbose!! set(CMAKE_VERBOSE_MAKEFILE True) diff --git a/qiskit/__init__.py b/qiskit/__init__.py index 5400432f0b5e..fa5584dba358 100644 --- a/qiskit/__init__.py +++ b/qiskit/__init__.py @@ -46,4 +46,4 @@ # Import the wrapper, to make it available when doing "import qiskit". from . import wrapper -__version__ = '0.5.1' +__version__ = '0.5.2' From f9803b55fe9f70daf0f2625a427b1abac1ee6b6b Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Tue, 29 May 2018 09:36:44 +0200 Subject: [PATCH 19/34] pip release: 0.5.3 --- CMakeLists.txt | 2 +- qiskit/__init__.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index be85e0709c42..c257e02d24b9 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required (VERSION 3.5 FATAL_ERROR) -project (QISKit VERSION 0.5.2 LANGUAGES CXX) +project (QISKit VERSION 0.5.3 LANGUAGES CXX) # Verbose!! set(CMAKE_VERBOSE_MAKEFILE True) diff --git a/qiskit/__init__.py b/qiskit/__init__.py index 348fd5ba88b7..7cb33c7754db 100644 --- a/qiskit/__init__.py +++ b/qiskit/__init__.py @@ -47,4 +47,4 @@ # Import the wrapper, to make it available when doing "import qiskit". from . import wrapper -__version__ = '0.5.2' +__version__ = '0.5.3' From c93a3f73e5f64151b51049288cb00af481b73d13 Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Mon, 11 Jun 2018 13:32:11 +0200 Subject: [PATCH 20/34] pip release: 0.5.4 --- CHANGELOG.rst | 17 ++++++++++++++++- CMakeLists.txt | 2 +- qiskit/__init__.py | 2 +- 3 files changed, 18 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.rst b/CHANGELOG.rst index c28ca6f5efe3..9faba9cf2d41 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -14,13 +14,28 @@ The format is based on `Keep a Changelog`_. - **Fixed**: for any bug fixes. - **Security**: in case of vulnerabilities. - `UNRELEASED`_ ============= Added ----- +Changed +------- + +Removed +------- + +Fixed +----- + + +`0.5.4`_ - 2018-06-11 +===================== + +Added +----- + - Performance improvements: - remove deepcopies from dagcircuit, and extra check on qasm() (#523) diff --git a/CMakeLists.txt b/CMakeLists.txt index c257e02d24b9..b34bd82430f6 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required (VERSION 3.5 FATAL_ERROR) -project (QISKit VERSION 0.5.3 LANGUAGES CXX) +project (QISKit VERSION 0.5.4 LANGUAGES CXX) # Verbose!! set(CMAKE_VERBOSE_MAKEFILE True) diff --git a/qiskit/__init__.py b/qiskit/__init__.py index 7dd60deb77fa..0a4202191d81 100644 --- a/qiskit/__init__.py +++ b/qiskit/__init__.py @@ -38,4 +38,4 @@ # Import the wrapper, to make it available when doing "import qiskit". from . import wrapper -__version__ = '0.5.3' +__version__ = '0.5.4' From 5c56f44e3591fc5678cbf074ffa9f04cbea4ba8a Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Mon, 11 Jun 2018 13:49:11 +0200 Subject: [PATCH 21/34] Fix CHNAGELOG links --- CHANGELOG.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 9faba9cf2d41..afb73b366f78 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -474,7 +474,8 @@ Fixed - Correct operator precedence when parsing expressions (#190). - Fix "math domain error" in mapping (#111, #151). -.. _UNRELEASED: https://github.com/QISKit/qiskit-core/compare/0.5.3...HEAD +.. _UNRELEASED: https://github.com/QISKit/qiskit-core/compare/0.5.4...HEAD +.. _0.5.4: https://github.com/QISKit/qiskit-core/compare/0.5.3...0.5.4 .. _0.5.3: https://github.com/QISKit/qiskit-core/compare/0.5.2...0.5.3 .. _0.5.2: https://github.com/QISKit/qiskit-core/compare/0.5.1...0.5.2 .. _0.5.1: https://github.com/QISKit/qiskit-core/compare/0.5.0...0.5.1 From 59a61654d380c6b3dfd9301b301adcfcbacfb427 Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Sun, 1 Jul 2018 23:29:58 +0200 Subject: [PATCH 22/34] pip release: 0.5.5 --- qiskit/VERSION.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/qiskit/VERSION.txt b/qiskit/VERSION.txt index a918a2aa18d5..d1d899fa33a0 100644 --- a/qiskit/VERSION.txt +++ b/qiskit/VERSION.txt @@ -1 +1 @@ -0.6.0 +0.5.5 From be8fbe35c6d73176545968acf5bf4adc226a243f Mon Sep 17 00:00:00 2001 From: "Diego M. Rodriguez" Date: Fri, 6 Jul 2018 10:47:23 +0200 Subject: [PATCH 23/34] pip release: 0.5.6 --- CHANGELOG.rst | 7 ++++--- qiskit/VERSION.txt | 2 +- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 34e68fd63547..e331f9da52bc 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -14,8 +14,9 @@ The format is based on `Keep a Changelog`_. - **Fixed**: for any bug fixes. - **Security**: in case of vulnerabilities. -`UNRELEASED`_ -============= + +`0.5.6`_ - 2018-07-06 +===================== Added ----- @@ -532,7 +533,7 @@ Fixed - Correct operator precedence when parsing expressions (#190). - Fix "math domain error" in mapping (#111, #151). -.. _UNRELEASED: https://github.com/QISKit/qiskit-terra/compare/0.5.5...HEAD +.. _0.5.5: https://github.com/QISKit/qiskit-terra/compare/0.5.5...0.5.6 .. _0.5.5: https://github.com/QISKit/qiskit-terra/compare/0.5.4...0.5.5 .. _0.5.4: https://github.com/QISKit/qiskit-terra/compare/0.5.3...0.5.4 .. _0.5.3: https://github.com/QISKit/qiskit-terra/compare/0.5.2...0.5.3 diff --git a/qiskit/VERSION.txt b/qiskit/VERSION.txt index d1d899fa33a0..b49b25336d47 100644 --- a/qiskit/VERSION.txt +++ b/qiskit/VERSION.txt @@ -1 +1 @@ -0.5.5 +0.5.6 From 314af30c492f1d694f8bfa38ee1ae7a20496c178 Mon Sep 17 00:00:00 2001 From: Ali Javadi Date: Tue, 17 Jul 2018 20:00:23 -0400 Subject: [PATCH 24/34] hack display names in --- qiskit/backends/ibmq/ibmqbackend.py | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/qiskit/backends/ibmq/ibmqbackend.py b/qiskit/backends/ibmq/ibmqbackend.py index 51d6e3b58de8..b1e83fc77205 100644 --- a/qiskit/backends/ibmq/ibmqbackend.py +++ b/qiskit/backends/ibmq/ibmqbackend.py @@ -136,6 +136,16 @@ def status(self): # be fixed in api if status['name'] == 'ibmqx_hpc_qasm_simulator': status['available'] = True + # FIXME a hack to show the new device display names. Needs to + # be fixed in the API. + if status['name'] == 'ibmqx2': + status['name'] = 'ibmq_5_yorktown' + if status['name'] == 'ibmqx4': + status['name'] = 'ibmq_5_tenerife' + if status['name'] == 'ibmqx5': + status['name'] = 'ibmq_16_rueschlikon' + if status['name'] == 'QS1_1': + status['name'] = 'ibmq_20_austin' # FIXME: this needs to be replaced at the API level - eventually # it will. From 8010a7a0024a741565b444cc6b51ce2a026f6583 Mon Sep 17 00:00:00 2001 From: "Diego M. Rodriguez" Date: Wed, 18 Jul 2018 18:24:01 +0200 Subject: [PATCH 25/34] Use new style backend names by default --- qiskit/backends/ibmq/ibmqbackend.py | 63 +++++++++++++++++++++------- qiskit/backends/ibmq/ibmqprovider.py | 26 +++++++++--- qiskit/transpiler/_transpiler.py | 4 ++ 3 files changed, 73 insertions(+), 20 deletions(-) diff --git a/qiskit/backends/ibmq/ibmqbackend.py b/qiskit/backends/ibmq/ibmqbackend.py index b1e83fc77205..c006ec9f0815 100644 --- a/qiskit/backends/ibmq/ibmqbackend.py +++ b/qiskit/backends/ibmq/ibmqbackend.py @@ -17,6 +17,7 @@ from qiskit.backends.ibmq.ibmqjob import IBMQJob from qiskit.backends import JobStatus + logger = logging.getLogger(__name__) @@ -68,7 +69,7 @@ def calibration(self): LookupError: If a configuration for the backend can't be found. """ try: - backend_name = self.configuration['name'] + backend_name = self._name_for_api calibrations = self._api.backend_calibration(backend_name) # FIXME a hack to remove calibration data that is none. # Needs to be fixed in api @@ -83,6 +84,9 @@ def calibration(self): new_key = _camel_case_to_snake_case(key) calibrations_edit[new_key] = vals + calibrations_edit = self._update_dict_name_from_api(calibrations_edit, + field='backend') + return calibrations_edit @property @@ -96,7 +100,7 @@ def parameters(self): LookupError: If parameters for the backend can't be found. """ try: - backend_name = self.configuration['name'] + backend_name = self._name_for_api parameters = self._api.backend_parameters(backend_name) # FIXME a hack to remove parameters data that is none. # Needs to be fixed in api @@ -111,6 +115,9 @@ def parameters(self): new_key = _camel_case_to_snake_case(key) parameters_edit[new_key] = vals + parameters_edit = self._update_dict_name_from_api(parameters_edit, + field='backend') + return parameters_edit @property @@ -124,7 +131,7 @@ def status(self): LookupError: If status for the backend can't be found. """ try: - backend_name = self.configuration['name'] + backend_name = self._name_for_api status = self._api.backend_status(backend_name) # FIXME a hack to rename the key. Needs to be fixed in api status['name'] = status['backend'] @@ -136,16 +143,8 @@ def status(self): # be fixed in api if status['name'] == 'ibmqx_hpc_qasm_simulator': status['available'] = True - # FIXME a hack to show the new device display names. Needs to - # be fixed in the API. - if status['name'] == 'ibmqx2': - status['name'] = 'ibmq_5_yorktown' - if status['name'] == 'ibmqx4': - status['name'] = 'ibmq_5_tenerife' - if status['name'] == 'ibmqx5': - status['name'] = 'ibmq_16_rueschlikon' - if status['name'] == 'QS1_1': - status['name'] = 'ibmq_20_austin' + + status = self._update_dict_name_from_api(status) # FIXME: this needs to be replaced at the API level - eventually # it will. @@ -194,7 +193,8 @@ def jobs(self, limit=50, skip=0, status=None, db_filter=None): Raises: IBMQBackendValueError: status keyword value unrecognized """ - backend_name = self.configuration['name'] + backend_name = self._name_for_api + api_filter = {} if status: if isinstance(status, str): @@ -249,6 +249,41 @@ def retrieve_job(self, job_id): job = IBMQJob.from_api(job_info, self._api, is_device) return job + @property + def _name_for_api(self): + """ + Return the backend name as used in the API. + + FIXME (new_backend_names): a hack to show the new device display + names. Needs to be fixed in the API. + + Returns: + str: name valid for the api + """ + from qiskit.backends.ibmq.ibmqprovider import ALIASED_BACKEND_NAMES + return ALIASED_BACKEND_NAMES.get(self.name) or self.name + + def _update_dict_name_from_api(self, status, field='name'): + """ + Update a dict['name'] with an aliased (new) backend name. + + Args: + status (dict): dict with optionally a 'name' key. + + FIXME (new_backend_names): a hack to show the new device display + names. Needs to be fixed in the API. + + Returns: + dict: dict with the 'name' replaced. + """ + from qiskit.backends.ibmq.ibmqprovider import ALIASED_BACKEND_NAMES_REVERSED + if field in status.keys(): + status[field] = ALIASED_BACKEND_NAMES_REVERSED.get( + status[field]) or status[field] + + return status + + class IBMQBackendError(QISKitError): """IBM Q Backend Errors""" diff --git a/qiskit/backends/ibmq/ibmqprovider.py b/qiskit/backends/ibmq/ibmqprovider.py index 4268a2afa238..4b89e36ec9c3 100644 --- a/qiskit/backends/ibmq/ibmqprovider.py +++ b/qiskit/backends/ibmq/ibmqprovider.py @@ -12,6 +12,18 @@ from qiskit.backends.baseprovider import BaseProvider from qiskit.backends.ibmq.ibmqbackend import IBMQBackend +# Dict with the form {'new_name': 'previous_name'} +ALIASED_BACKEND_NAMES = { + 'ibmq_5_yorktown': 'ibmqx2', + 'ibmq_5_tenerife': 'ibmqx4', + 'ibmq_16_rueschlikon': 'ibmqx5', + 'ibmq_20_austin': 'QS1_1' +} + +# Dict with the form {'previous_name': 'new_name'} +ALIASED_BACKEND_NAMES_REVERSED = {name: alias for alias, name in + ALIASED_BACKEND_NAMES.items()} + class IBMQProvider(BaseProvider): """Provider for remote IbmQ backends.""" @@ -59,12 +71,7 @@ def deprecated_backend_names(self): } def aliased_backend_names(self): - return { - 'ibmq_5_yorktown': 'ibmqx2', - 'ibmq_5_tenerife': 'ibmqx4', - 'ibmq_16_rueschlikon': 'ibmqx5', - 'ibmq_20_austin': 'QS1_1' - } + return ALIASED_BACKEND_NAMES_REVERSED @classmethod def _authenticate(cls, token, url, @@ -124,6 +131,13 @@ def _parse_backend_configuration(cls, config): 'status']: edited_config[new_key] = config[key] + # FIXME (new_backend_names): a hack to show the new device display + # names. Needs to be fixed in the API. + if config.get('name') in ALIASED_BACKEND_NAMES_REVERSED.keys(): + # Use the new name of the backend for `backend.name` if it is in + # the list of aliases. + edited_config['name'] = ALIASED_BACKEND_NAMES_REVERSED[config['name']] + return edited_config def _discover_remote_backends(self): diff --git a/qiskit/transpiler/_transpiler.py b/qiskit/transpiler/_transpiler.py index a9ee12865a1a..44e112e54ed1 100644 --- a/qiskit/transpiler/_transpiler.py +++ b/qiskit/transpiler/_transpiler.py @@ -58,6 +58,10 @@ def compile(circuits, backend, backend_conf = backend.configuration backend_name = backend_conf['name'] + # FIXME (new_backend_names): the API uses the old backend names, but in + # qiskit we are using the new ones. This makes the qobj names valid (old). + if getattr(backend, '_name_for_api', None): + backend_name = backend._name_for_api qobj = {} From ae9a508c6dbc231092a309e450415031de9cb05d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Diego=20M=2E=20Rodr=C3=ADguez?= Date: Tue, 10 Jul 2018 16:18:51 +0200 Subject: [PATCH 26/34] Fix test failing for sympy 1.2 (#635) --- qiskit/backends/ibmq/ibmqbackend.py | 2 +- test/python/test_quantumprogram.py | 4 +++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/qiskit/backends/ibmq/ibmqbackend.py b/qiskit/backends/ibmq/ibmqbackend.py index c006ec9f0815..f2215da7db26 100644 --- a/qiskit/backends/ibmq/ibmqbackend.py +++ b/qiskit/backends/ibmq/ibmqbackend.py @@ -269,6 +269,7 @@ def _update_dict_name_from_api(self, status, field='name'): Args: status (dict): dict with optionally a 'name' key. + field (str): the field to replace in the dict. FIXME (new_backend_names): a hack to show the new device display names. Needs to be fixed in the API. @@ -284,7 +285,6 @@ def _update_dict_name_from_api(self, status, field='name'): return status - class IBMQBackendError(QISKitError): """IBM Q Backend Errors""" pass diff --git a/test/python/test_quantumprogram.py b/test/python/test_quantumprogram.py index 2840becc6962..d34ba4c716d0 100644 --- a/test/python/test_quantumprogram.py +++ b/test/python/test_quantumprogram.py @@ -533,7 +533,9 @@ def test_load(self): check_result = q_program.get_qasm('circuitName') self.log.info(check_result) - self.assertEqual(len(check_result), 1775) + # TODO: revise Sympy 1.2 compatibility. The length is 1775 for + # sympy=1.1.x, and 1781 for sympy=1.2 + self.assertIn(len(check_result), (1775, 1781)) def test_load_wrong(self): """Test load Json. From 9b1f85ba942f1f21030b9c772415be6b1c3ce939 Mon Sep 17 00:00:00 2001 From: "Diego M. Rodriguez" Date: Wed, 18 Jul 2018 18:38:02 +0200 Subject: [PATCH 27/34] Avoid circular dependency --- qiskit/backends/ibmq/ibmqbackend.py | 17 +++++++++++++++-- qiskit/backends/ibmq/ibmqprovider.py | 14 +------------- 2 files changed, 16 insertions(+), 15 deletions(-) diff --git a/qiskit/backends/ibmq/ibmqbackend.py b/qiskit/backends/ibmq/ibmqbackend.py index f2215da7db26..d355fd6e1871 100644 --- a/qiskit/backends/ibmq/ibmqbackend.py +++ b/qiskit/backends/ibmq/ibmqbackend.py @@ -17,6 +17,21 @@ from qiskit.backends.ibmq.ibmqjob import IBMQJob from qiskit.backends import JobStatus +# FIXME (new_backend_names): these two dicts are placed here to avoid cyclic +# imports. Once fixed, their place should be `ibmqprovider.py`. + +# Dict with the form {'new_name': 'previous_name'} +ALIASED_BACKEND_NAMES = { + 'ibmq_5_yorktown': 'ibmqx2', + 'ibmq_5_tenerife': 'ibmqx4', + 'ibmq_16_rueschlikon': 'ibmqx5', + 'ibmq_20_austin': 'QS1_1' +} + +# Dict with the form {'previous_name': 'new_name'} +ALIASED_BACKEND_NAMES_REVERSED = {name: alias for alias, name in + ALIASED_BACKEND_NAMES.items()} + logger = logging.getLogger(__name__) @@ -260,7 +275,6 @@ def _name_for_api(self): Returns: str: name valid for the api """ - from qiskit.backends.ibmq.ibmqprovider import ALIASED_BACKEND_NAMES return ALIASED_BACKEND_NAMES.get(self.name) or self.name def _update_dict_name_from_api(self, status, field='name'): @@ -277,7 +291,6 @@ def _update_dict_name_from_api(self, status, field='name'): Returns: dict: dict with the 'name' replaced. """ - from qiskit.backends.ibmq.ibmqprovider import ALIASED_BACKEND_NAMES_REVERSED if field in status.keys(): status[field] = ALIASED_BACKEND_NAMES_REVERSED.get( status[field]) or status[field] diff --git a/qiskit/backends/ibmq/ibmqprovider.py b/qiskit/backends/ibmq/ibmqprovider.py index 4b89e36ec9c3..73ff4781638a 100644 --- a/qiskit/backends/ibmq/ibmqprovider.py +++ b/qiskit/backends/ibmq/ibmqprovider.py @@ -10,19 +10,7 @@ from qiskit._util import _camel_case_to_snake_case from qiskit.backends.baseprovider import BaseProvider -from qiskit.backends.ibmq.ibmqbackend import IBMQBackend - -# Dict with the form {'new_name': 'previous_name'} -ALIASED_BACKEND_NAMES = { - 'ibmq_5_yorktown': 'ibmqx2', - 'ibmq_5_tenerife': 'ibmqx4', - 'ibmq_16_rueschlikon': 'ibmqx5', - 'ibmq_20_austin': 'QS1_1' -} - -# Dict with the form {'previous_name': 'new_name'} -ALIASED_BACKEND_NAMES_REVERSED = {name: alias for alias, name in - ALIASED_BACKEND_NAMES.items()} +from qiskit.backends.ibmq.ibmqbackend import IBMQBackend, ALIASED_BACKEND_NAMES_REVERSED class IBMQProvider(BaseProvider): From 829ca256942495faedb705bda718d641da8e4c63 Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Thu, 19 Jul 2018 15:01:14 +0200 Subject: [PATCH 28/34] pip release: 0.5.7 --- qiskit/VERSION.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/qiskit/VERSION.txt b/qiskit/VERSION.txt index b49b25336d47..d3532a107eeb 100644 --- a/qiskit/VERSION.txt +++ b/qiskit/VERSION.txt @@ -1 +1 @@ -0.5.6 +0.5.7 From 9b59dce13a99a4e266120cdb278aa2e4b34df3f5 Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Thu, 4 Oct 2018 11:23:06 +0200 Subject: [PATCH 29/34] pip release: 0.6.0 --- qiskit/VERSION.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/qiskit/VERSION.txt b/qiskit/VERSION.txt index d3532a107eeb..a918a2aa18d5 100644 --- a/qiskit/VERSION.txt +++ b/qiskit/VERSION.txt @@ -1 +1 @@ -0.5.7 +0.6.0 From af9872df8b8be18960856fca375eda70ddfb68f1 Mon Sep 17 00:00:00 2001 From: Paul Nation Date: Thu, 4 Oct 2018 06:14:29 -0400 Subject: [PATCH 30/34] Doc updates (#1026) --- doc/conf.py | 8 +++---- doc/dev_introduction.rst | 6 +++--- doc/example_real_backend.rst | 4 ++-- doc/index.rst | 15 +++++++------ doc/install.rst | 41 +++++++++++++++++++++++------------- doc/qiskit.rst | 11 ++++++---- doc/quickstart.rst | 8 +++---- doc/releases.rst | 14 ++++++------ doc/theme/theme.conf | 2 +- 9 files changed, 62 insertions(+), 47 deletions(-) diff --git a/doc/conf.py b/doc/conf.py index c62aa97d5df1..d215b5004fbf 100755 --- a/doc/conf.py +++ b/doc/conf.py @@ -72,9 +72,9 @@ master_doc = 'index' # General information about the project. -project = 'Qiskit SDK' -copyright = '2017-2018 IBM Research' -author = 'IBM Research' +project = 'Qiskit Terra' +copyright = '2017-2018 IBM' +author = 'IBM' # Add description html_context = { @@ -194,7 +194,7 @@ # (source start file, target name, title, author, # dir menu entry, description, category) texinfo_documents = [ - (master_doc, 'Qiskit', 'Qiskit Documentation', + (master_doc, 'Qiskit Terra', 'Qiskit Terra Documentation', author, 'Qiskit', 'One line description of project.', 'Miscellaneous'), ] diff --git a/doc/dev_introduction.rst b/doc/dev_introduction.rst index 1f0b5ecff731..fdce29412f1f 100644 --- a/doc/dev_introduction.rst +++ b/doc/dev_introduction.rst @@ -76,7 +76,7 @@ Several unroller backends and their outputs are summarized here: Logging ------- -The SDK uses the `standard Python "logging" library +Terra uses the `standard Python "logging" library `_ for emitting several messages using the family of "`qiskit.*`" loggers, and abides by the standard convention for the log levels: @@ -108,7 +108,7 @@ For convenience, two methods are provided in :py:mod<`qiskit_logging.py`>: (:py: :py:func:<`unset_qiskit_logger`>) that modify the handlers and the level of the `qiskit` logger. Using these methods might interfere with the global logging setup of your environment - please take it into consideration if developing an -application on top of the SDK. +application on top of Terra. The convention for emitting log messages is declare a global variable in the module named **logger**, which contains the logger with that module's **__name__**, and use it for emitting @@ -126,7 +126,7 @@ the messages. For example, if the module is `qiskit/some/module.py`: Testing ------- -The SDK uses the `standard Pyton "unittest" framework +Terra uses the `standard Pyton "unittest" framework `_ for the testing of the different components and functionality. diff --git a/doc/example_real_backend.rst b/doc/example_real_backend.rst index 13c6063d6e68..fb2ff0accd82 100644 --- a/doc/example_real_backend.rst +++ b/doc/example_real_backend.rst @@ -6,7 +6,7 @@ Quantum device: .. code-block:: python - # Import the Qiskit SDK + # Import Qiskit Terra from qiskit import QuantumCircuit, ClassicalRegister, QuantumRegister from qiskit import execute, IBMQ @@ -87,4 +87,4 @@ is not specified, the following values will be used by default: Please note that these parameters must only be used for the ``ibmq_qasm_simulator_hpc``, and will be reset to None along with emitting -a warning by the SDK if used with another backend. +a warning by Terra if used with another backend. diff --git a/doc/index.rst b/doc/index.rst index 37acc15eac34..30786189142f 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -3,13 +3,14 @@ You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. -==================== -Qiskit Documentation -==================== +========================== +Qiskit Terra Documentation +========================== -Quantum Information Science Kit (Qiskit), SDK Python version for working -with `OpenQASM `_ and the IBM Q experience -(QX). +Qiskit (Quantum Information Science Kit) Terra is a Python based set of +tools for composing quantum programs at the level of circuits and pulses, +optimizing them for the constraints of a particular physical quantum processor, +and managing the batched execution of experiments on remote-access backends. Table of Contents @@ -22,7 +23,7 @@ Table of Contents Getting started Qiskit overview Developer documentation - SDK reference <_autodoc/qiskit> + Software reference <_autodoc/qiskit> Release history Python Modules diff --git a/doc/install.rst b/doc/install.rst index 2d920f48adfe..0b02cda2d56d 100644 --- a/doc/install.rst +++ b/doc/install.rst @@ -21,14 +21,14 @@ python distribution, which already comes with all these dependencies pre-install 2. Installation --------------- -The recommended way to install Qiskit is by using the PIP tool (Python -package manager): +The recommended way to install Qiskit is by using the PIP (Python +package manager) tool: .. code:: sh pip install qiskit -This will install the latest stable release along with all the dependencies. +This will install the latest stable release, along with all the dependencies. .. _qconfig-setup: @@ -39,16 +39,16 @@ This will install the latest stable release along with all the dependencies. - Create an `IBM Q `__ account if you haven't already done so - Get an API token from the IBM Q website under “My - Account” > “Personal Access Token” + Account” > “Advanced” 3.1 Automatically loading credentials ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Since Qiskit 0.6, an automatic method that looks for the credentials in several -places can be used for streamlining the setting up of the IBM Q authentication. -This implies that you can set or store your API credentials once after -installation, and when you want to use them, you can simply run: +As of Qiskit Terra 0.6, credentials for accessing the IBM Q quantum devices can be loaded +automatically from several locations, thus streamlining the set up of the IBM Q +authentication. You can set or store your API credentials once after installation, +and when you want to use them, you can simply run: .. code:: python @@ -57,8 +57,8 @@ installation, and when you want to use them, you can simply run: IBMQ.load_accounts() This ``IBMQ.load_accounts()`` call performs the automatic loading of the -credentials from several sources, and authenticates against IBM Q, making the -online devices available to your program. Please use one of the following +credentials from several sources (if needed), and authenticates against IBM Q, +making the online devices available to your program. Please use one of the following methods for storing the credentials before calling the automatic registration: 3.1.1 Store API credentials locally @@ -81,7 +81,8 @@ To store your information, simply run: where `MY_API_TOKEN` should be replaced with your token. If you are on the IBM Q network, you must also pass the `url` -argument found on your q-console account page to `IBMQ.save_account()`: +argument found on your q-console account page to `IBMQ.save_account()`, +along with any other additional information required (e.g. proxy information): .. code:: python @@ -169,14 +170,14 @@ like: } Note that if a ``Qconfig.py`` file is present in your directory, it will take -precedence over the environment variables or the credentials stored in disk. +precedence over the environment variables and/or the credentials stored locally on disk. 3.2 Manually loading credentials ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ In more complex scenarios or for users that need finer control over multiple -accounts, please note that you can pass the API token and the other parameters -directly to the ``IBMQ.enable_account()`` function, which will ignore the automatic +accounts, one can pass the API token, and the other parameters, directly to the +``IBMQ.enable_account()`` function, that will ignore the automatic loading of the credentials and use the arguments directly. For example: .. code:: python @@ -185,10 +186,20 @@ loading of the credentials and use the arguments directly. For example: IBMQ.enable_account('MY_API_TOKEN', url='https://my.url') -will try to authenticate using ``MY_API_TOKEN`` and the specified URL, +will authenticate using ``MY_API_TOKEN`` and the specified URL, regardless of the configuration stored in the config file, the environment variables, or the ``Qconfig.py`` file, if any. +Manually loading from a ``Qconfig.py`` file can also be done: + +.. code:: python + + from qiskit import IBMQ + import Qconfig + + IBMQ.enable_account(Qconfig.APIToken, **Qconfig.config) + + Please refer to the ``qiskit.IBMQ`` documentation for more information about using multiple credentials. diff --git a/doc/qiskit.rst b/doc/qiskit.rst index 21e8341dc4b2..82199486235f 100644 --- a/doc/qiskit.rst +++ b/doc/qiskit.rst @@ -4,12 +4,12 @@ Qiskit overview Philosophy ---------- -Qiskit is a collection of software for working with short depth -quantum circuits and building near term applications and experiments +Qiskit is a collection of software for working with short-depth +quantum circuits, and running near-term applications and experiments on quantum computers. In Qiskit, a quantum program is an array of quantum circuits. The program workflow consists of three stages: -Build, Compile, and Run. Build allows you to make different quantum -circuits that represent the problem you are solving. Compile allows +Build, Compile, and Run. Build allows you to generate different quantum +circuits that represent the algorithm you are solving. Compile allows you to rewrite them to run on different backends (simulators/real chips of different quantum volumes, sizes, fidelity, etc). Run launches the jobs. After the jobs have been run, the data is @@ -25,6 +25,9 @@ The Qiskit project comprises: development kit for writing quantum computing experiments, programs, and applications. +* `Qiskit Aqua `_: A library and tools to + build applications for Noisy Intermediate-Scale Quantum (NISQ) computers + * `Qiskit API `_: A thin Python wrapper around the Quantum Experience HTTP API that enables you to connect and and execute quantum programs. diff --git a/doc/quickstart.rst b/doc/quickstart.rst index f3c773ef92f8..7f3804be2957 100644 --- a/doc/quickstart.rst +++ b/doc/quickstart.rst @@ -56,14 +56,14 @@ The :func:`~qiskit.Result.get_counts` method outputs a dictionary of Quantum Chips ------------- -You can execute your QASM circuits on a real chip by using the IBM Q experience (QX) cloud platform. +You can execute your circuits on a real chip by using the IBM Q experience (QX) cloud platform. Currently through QX you can use the following chips: - ``ibmqx4``: `5-qubit backend `_ -- ``ibmqx5``: `16-qubit backend `_ +- ``ibmq_16_melbourne``: `16-qubit backend `_ -For chip details and realtime information about availability visit the +For chip details, and realtime information about availability, visit the `IBM Q experience backend information `_ and the `IBM Q experience devices page `_. @@ -73,4 +73,4 @@ Project Organization -------------------- Python example programs can be found in the *examples* directory, and test scripts are -located in *test*. The *qiskit* directory is the main module of the SDK. +located in *test*. The *qiskit* directory is the main module of Terra. diff --git a/doc/releases.rst b/doc/releases.rst index d06e2a9d6e3c..bace1fd90ea3 100644 --- a/doc/releases.rst +++ b/doc/releases.rst @@ -4,8 +4,8 @@ Release history Release notes ************* -Qiskit SDK 0.6.0 -================ +Qiskit Terra 0.6.0 +================== This release includes a redesign of internal components centered around a new, formal communication format (``Qobj``), along with long awaited features to @@ -100,7 +100,7 @@ the different authentication options. Working with backends ^^^^^^^^^^^^^^^^^^^^^ -A new mechanism has been introduced in 0.6 as the recommended way for obtaining +A new mechanism has been introduced in Terra 0.6 as the recommended way for obtaining a backend, allowing for more powerful and unified filtering and integrated with the new credentials system. The previous top-level methods :meth:`~qiskit.wrapper._wrapper.register`, @@ -129,7 +129,7 @@ The previous names can still be used, but it is encouraged to use the new, shorter names: ============================= ======================== -Qiskit 0.5 Qiskit 0.6 +Qiskit Terra 0.5 Qiskit Terra 0.6 ============================= ======================== 'local_qasm_simulator' 'qasm_simulator' 'local_statevector_simulator' 'statevector_simulator' @@ -165,7 +165,7 @@ how to use the simplified API. but methods, and as a result they need to be invoked as functions. ===================== ======================== -Qiskit 0.5 Qiskit 0.6 +Qiskit Terra 0.5 Qiskit Terra 0.6 ===================== ======================== backend.name backend.name() backend.status backend.status() @@ -194,8 +194,8 @@ Use ``%%qiskit_job_status`` to keep track of the status of submitted jobs to IBM Use ``%%qiskit_progress_bar`` to keep track of the progress of compilation/execution. -Qiskit SDK 0.5.0 -================ +Qiskit Terra 0.5.0 +================== This release brings a number of improvements to Qiskit, both for the user experience and under the hood. Please refer to the full changelog for a diff --git a/doc/theme/theme.conf b/doc/theme/theme.conf index 528dd6dbcab4..78ba7def4d71 100644 --- a/doc/theme/theme.conf +++ b/doc/theme/theme.conf @@ -6,4 +6,4 @@ pygments_style = friendly [options] rightsidebar = false -maincolor = #7C2EA3 +maincolor = #197D1D From 58f5ba91dd9ad9691a0912c2dea282a149a0d530 Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Fri, 5 Oct 2018 13:49:07 +0200 Subject: [PATCH 31/34] pip release: 0.6.1 (#1037) - There are no changes in the code. Just a rebuild of the wheel package. --- qiskit/VERSION.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/qiskit/VERSION.txt b/qiskit/VERSION.txt index a918a2aa18d5..ee6cdce3c290 100644 --- a/qiskit/VERSION.txt +++ b/qiskit/VERSION.txt @@ -1 +1 @@ -0.6.0 +0.6.1 From bb5880d6275558e07929f163ad811fe8bc0f351e Mon Sep 17 00:00:00 2001 From: "Diego M. Rodriguez" Date: Wed, 19 Dec 2018 12:06:08 +0100 Subject: [PATCH 32/34] pip release: 0.7.0 --- CHANGELOG.rst | 7 ++----- qiskit/VERSION.txt | 2 +- 2 files changed, 3 insertions(+), 6 deletions(-) diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 04ba64842c28..a6a3730c0f5d 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -17,10 +17,6 @@ The format is based on `Keep a Changelog`_. - **Security**: in case of vulnerabilities. -`UNRELEASED`_ -============= - - `0.7.0`_ - 2018-12-19 ===================== @@ -873,7 +869,8 @@ Fixed - Correct operator precedence when parsing expressions (#190). - Fix "math domain error" in mapping (#111, #151). -.. _UNRELEASED: https://github.com/Qiskit/qiskit-terra/compare/0.6.0...HEAD +.. _UNRELEASED: https://github.com/Qiskit/qiskit-terra/compare/0.7.0...HEAD +.. _0.7.0: https://github.com/Qiskit/qiskit-terra/compare/0.6.0...0.7.0 .. _0.6.0: https://github.com/Qiskit/qiskit-terra/compare/0.5.7...0.6.0 .. _0.5.7: https://github.com/Qiskit/qiskit-terra/compare/0.5.6...0.5.7 .. _0.5.6: https://github.com/Qiskit/qiskit-terra/compare/0.5.5...0.5.6 diff --git a/qiskit/VERSION.txt b/qiskit/VERSION.txt index ee6cdce3c290..faef31a4357c 100644 --- a/qiskit/VERSION.txt +++ b/qiskit/VERSION.txt @@ -1 +1 @@ -0.6.1 +0.7.0 From 3611a6f1f329a4a8906f612709482166f689f829 Mon Sep 17 00:00:00 2001 From: Jay Gambetta Date: Wed, 19 Dec 2018 08:15:22 -0500 Subject: [PATCH 33/34] Documentation (#1562) * Documentation * Fix * Removing long warnings * Change order --- doc/getting_started_with_qiskit_terra.rst | 493 +++++++++---- ...getting_started_with_qiskit_terra_10_0.png | Bin 9558 -> 0 bytes ...getting_started_with_qiskit_terra_21_0.png | Bin 92385 -> 114683 bytes ...getting_started_with_qiskit_terra_27_0.png | Bin 21028 -> 0 bytes ...getting_started_with_qiskit_terra_33_0.png | Bin 6374 -> 9154 bytes ...getting_started_with_qiskit_terra_45_0.png | Bin 10138 -> 0 bytes ...getting_started_with_qiskit_terra_49_0.png | Bin 0 -> 14898 bytes ...getting_started_with_qiskit_terra_50_0.png | Bin 6332 -> 0 bytes ...getting_started_with_qiskit_terra_54_0.png | Bin 0 -> 9226 bytes doc/index.rst | 5 + doc/plotting_data_in_qiskit.rst | 491 +++++++++++++ .../plotting_data_in_qiskit_18_0.png | Bin 0 -> 77930 bytes .../plotting_data_in_qiskit_19_0.png | Bin 0 -> 5626 bytes .../plotting_data_in_qiskit_20_0.png | Bin 0 -> 16928 bytes .../plotting_data_in_qiskit_21_0.png | Bin 0 -> 13077 bytes .../plotting_data_in_qiskit_22_0.png | Bin 0 -> 62182 bytes .../plotting_data_in_qiskit_26_0.png | Bin 0 -> 74256 bytes .../plotting_data_in_qiskit_28_0.png | Bin 0 -> 6569 bytes .../plotting_data_in_qiskit_30_0.png | Bin 0 -> 14187 bytes .../plotting_data_in_qiskit_33_0.png | Bin 0 -> 64078 bytes .../plotting_data_in_qiskit_40_0.png | Bin 0 -> 62518 bytes .../plotting_data_in_qiskit_42_0.png | Bin 0 -> 64858 bytes .../plotting_data_in_qiskit_6_0.png | Bin 0 -> 8843 bytes .../plotting_data_in_qiskit_8_0.png | Bin 0 -> 11993 bytes .../plotting_data_in_qiskit_9_0.png | Bin 0 -> 14164 bytes .../terra_parallel_tools.rst | 130 ++++ doc/quantum_circuits.rst | 678 ++++++++++++++++++ doc/summary_of_quantum_operations.rst | 543 +++++++++----- doc/terra_jupyter_tools.rst | 370 ++++++++++ doc/terra_parallel_tools.rst | 130 ++++ doc/the_ibmq_provider.rst | 244 ++----- doc/visualizing_a_quantum_circuit.rst | 507 +++++++++++++ .../visualizing_a_quantum_circuit_13_0.png | Bin 0 -> 76726 bytes .../visualizing_a_quantum_circuit_14_0.png | Bin 0 -> 77560 bytes .../visualizing_a_quantum_circuit_15_0.png | Bin 0 -> 74183 bytes .../visualizing_a_quantum_circuit_16_0.png | Bin 0 -> 75271 bytes .../visualizing_a_quantum_circuit_19_0.png | Bin 0 -> 35340 bytes .../visualizing_a_quantum_circuit_20_0.png | Bin 0 -> 28419 bytes .../visualizing_a_quantum_circuit_21_0.png | Bin 0 -> 57515 bytes .../visualizing_a_quantum_circuit_27_0.png | Bin 0 -> 32723 bytes .../visualizing_a_quantum_circuit_8_0.png | Bin 0 -> 10924 bytes .../visualizing_a_quantum_circuit_9_0.png | Bin 0 -> 22477 bytes 42 files changed, 3063 insertions(+), 528 deletions(-) delete mode 100644 doc/getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_10_0.png delete mode 100644 doc/getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_27_0.png delete mode 100644 doc/getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_45_0.png create mode 100644 doc/getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_49_0.png delete mode 100644 doc/getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_50_0.png create mode 100644 doc/getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_54_0.png create mode 100644 doc/plotting_data_in_qiskit.rst create mode 100644 doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_18_0.png create mode 100644 doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_19_0.png create mode 100644 doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_20_0.png create mode 100644 doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_21_0.png create mode 100644 doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_22_0.png create mode 100644 doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_26_0.png create mode 100644 doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_28_0.png create mode 100644 doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_30_0.png create mode 100644 doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_33_0.png create mode 100644 doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_40_0.png create mode 100644 doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_42_0.png create mode 100644 doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_6_0.png create mode 100644 doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_8_0.png create mode 100644 doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_9_0.png create mode 100644 doc/plotting_data_in_qiskit_files/terra_parallel_tools.rst create mode 100644 doc/quantum_circuits.rst create mode 100644 doc/terra_jupyter_tools.rst create mode 100644 doc/terra_parallel_tools.rst create mode 100644 doc/visualizing_a_quantum_circuit.rst create mode 100644 doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_13_0.png create mode 100644 doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_14_0.png create mode 100644 doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_15_0.png create mode 100644 doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_16_0.png create mode 100644 doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_19_0.png create mode 100644 doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_20_0.png create mode 100644 doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_21_0.png create mode 100644 doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_27_0.png create mode 100644 doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_8_0.png create mode 100644 doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_9_0.png diff --git a/doc/getting_started_with_qiskit_terra.rst b/doc/getting_started_with_qiskit_terra.rst index 38c40e0b9fb9..c266950196d5 100644 --- a/doc/getting_started_with_qiskit_terra.rst +++ b/doc/getting_started_with_qiskit_terra.rst @@ -1,28 +1,42 @@ -Getting Started with Qiskit Terra -================================= +Getting Started with Qiskit +=========================== -First let’s start by importing some basic features of Qiskit Terra. +Here, we provide an overview of working with Qiskit. Qiskit provides the +basic building blocks necessary to program quantum computers. The +foundation of Qiskit is the Terra element. The basic concept of Qiskit +Terra is an array of quantum circuits. A workflow using Terra consists +of two stages: **Build** and **Execute**. **Build** allows you to make +different quantum circuits that represent the problem you are solving, +and **Execute** allows you to run them on different backends. After the +jobs have been run, the data is collected. There are methods for putting +this data together, depending on the program. This either gives you the +answer you wanted, or allows you to make a better program for the next +instance. + +**Contents** + +`Circuit basics <#circuit_basics>`__ + +`Simulating circuits with Qiskit Aer <#aer_simulation>`__ + +`Running circuits using the IBMQ provider <#ibmq_provider>`__ + +**Code imports** .. code:: ipython3 import numpy as np from qiskit import QuantumCircuit, ClassicalRegister, QuantumRegister - from qiskit import execute + from qiskit import execute -The basic concept of Qiskit Terra is an array of quantum circuits. The -workflow consists of two stages: Build, and Execute. Build allows you to -make different quantum circuits that represent the problem you are -solving; Execute allows you to run them on different backends.  After -the jobs have been run, the data is collected. There are methods for -putting this data together, depending on the program. This either gives -you the answer you wanted, or allows you to make a better program for -the next instance. +Circuit Basics +--------------- -Building the circuit ---------------------- +Building the circuit +~~~~~~~~~~~~~~~~~~~~ The basic elements needed for your first program are the QuantumCircuit, and QuantumRegister. @@ -35,19 +49,35 @@ and QuantumRegister. # Create a Quantum Circuit acting on the q register circ = QuantumCircuit(q) -.. note:: +.. raw:: html + +
+ +Note: Naming the QuantumRegister is optional and not required. + +.. raw:: html + +
- Naming the QuantumRegister is optional and not required.. +After you create the circuit with its registers, you can add gates +(“operations”) to manipulate the registers. As you proceed through the +documentation you will find more gates and circuits; the below is an +example of a quantum circuit that makes a three-qubit GHZ state +.. math:: |\psi\rangle = \left(|000\rangle+|111\rangle\right)/\sqrt{2}. -After you create the circuit with its registers, you can add gates to -manipulate the registers. As you proceed through the documentation you -will find more gates and circuits but the below is an example of a -quantum circuit that makes a GHZ state, :math:`(|000>+|111>)/\sqrt{2}`. -The circuit that does this consists of a quantum register of three -qubits and a gate sequence :math:`H` on qubit 0 (making a -superposition), followed by :math:`C_X` between qubit 0 and 1 and a -:math:`C_X` between qubit 0 and 2. In Qiskit Terra this is done using +To create such a state, we start with a 3-qubit quantum register. By +default, each qubit in the register is initialized to :math:`|0\rangle`. +To make the GHZ state, we apply the following gates: \* A Hadamard gate +:math:`H` on qubit 0, which puts it into a superposition state. \* A +controlled-Not operation (:math:`C_{X}`) between qubit 0 and qubit 1. \* +A controlled-Not operation between qubit 0 and qubit 2. + +On an ideal quantum computer, the state produced by running this circuit +would be the GHZ state above. + +In Qiskit Terra, operations can be added to the circuit one-by-one, as +shown below. .. code:: ipython3 @@ -63,103 +93,155 @@ superposition), followed by :math:`C_X` between qubit 0 and 1 and a +.. parsed-literal:: + + + + + Visualize Circuit ----------------- -You can visualize your circuit using Qiskit Terra ``circuit_drawer``, -which plots circuit in the form found in many textbooks. +You can visualize your circuit using Qiskit Terra +``QuantumCircuit.draw()``, which plots circuit in the form found in many +textbooks. .. code:: ipython3 - from qiskit.tools.visualization import circuit_drawer - - circuit_drawer(circ) + circ.draw() + + +.. raw:: html +
        ┌───┐          
+    q_0: |0>┤ H ├──■────■──
+            └───┘┌─┴─┐  │  
+    q_1: |0>─────┤ X ├──┼──
+                 └───┘┌─┴─┐
+    q_2: |0>──────────┤ X ├
+                      └───┘
-.. image:: getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_10_0.png +In this circuit, the qubits are put in order with qubit zero at the top +and qubit two at the bottom. The circuit is read left-to-right (meaning +that gates which are applied earlier in the circuit show up further to +the left). -Qiskit Aer backends -------------------- +Simulating circuits using Qiskit Aer +------------------------------------- + +Qiskit Aer is our package for simulating quantum circuits. It provides +many different backends for doing a simulation. Here we use the basic +python version. Statevector backend ~~~~~~~~~~~~~~~~~~~ -In Qiskit Aer we have many simulator backends that allow the simulation -of quantum circuits. The most common is the ``statevector_simulator``. +The most common backend in Qiskit Aer is the ``statevector_simulator``. This simulator returns the quantum state which is a complex vector of dimensions :math:`2^n` where :math:`n` is the number of qubits (so be careful using this as it will quickly get too large to run on your machine). -.. note:: +.. raw:: html + +
+ +When representing the state of a multi-qubit system, the tensor order +used in qiskit is different than that use in most physics textbooks. +Suppose there are :math:`n` qubits, and qubit :math:`j` is labeled as +:math:`Q_{j}`. In most textbooks (such as Nielsen and Chuang’s “Quantum +Computation and Information”), the basis vectors for the :math:`n`-qubit +state space would be labeled as +:math:`Q_{0}\otimes Q_{1} \otimes \cdots \otimes Q_{n}`. **This is not +the ordering used by qiskit!** Instead, qiskit uses an ordering in which +the :math:`n^{\mathrm{th}}` qubit is on the *left* side of the tesnsor +product, so that the basis vectors are labeled as +:math:`Q_n\otimes \cdots \otimes Q_1\otimes Q_0`. + +For example, if qubit zero is in state 0, qubit 1 is in state 0, and +qubit 2 is in state 1, qiskit would represent this state as +:math:`|100\rangle`, whereas most physics textbooks would represent it +as :math:`|001\rangle`. + +This difference in labeling affects the way multi-qubit operations are +represented as matrices. For example, qiskit represents a controlled-X +(:math:`C_{X}`) operation with qubit 0 being the control and qubit 1 +being the target as - The tensor order used in qiskit goes - :math:`Q_n\otimes \cdots \otimes Q_1\otimes Q_0` which is not the - standard used in many physics textbooks and results is the :math:`C_X` - between the control qubit 0 and target qubit 1 having the form +.. math:: C_X = \begin{pmatrix} 1 & 0 & 0 & 0 \\ 0 & 0 & 0 & 1 \\ 0 & 0 & 1 & 0 \\ 0 & 1 & 0 & 0 \\\end{pmatrix}. - .. math:: C_X = \begin{pmatrix} 1 & 0 & 0 & 0 \\ 0 & 0 & 0 & 1 \\ 0 & 0 & 1 & 0 \\ 0 & 1 & 0 & 0 \\\end{pmatrix} +.. raw:: html -To run the above circuit using the statevector simulator first you need +
+ +To run the above circuit using the statevector simulator, first you need to import Aer and then set the backend to ``statevector_simulator``. .. code:: ipython3 # Import Aer - from qiskit import Aer + from qiskit import BasicAer # Run the quantum circuit on a statevector simulator backend - backend = Aer.get_backend('statevector_simulator') + backend = BasicAer.get_backend('statevector_simulator') + +Now we have chosen the backend it’s time to compile and run the quantum +circuit. In Qiskit Terra we provide the ``execute`` function for this. +``execute`` returns a ``job`` object that encapsulates information about +the job submitted to the backend. -Now we have chosen the backend its time to compile and run the quantum -circuit. In Qiskit Terra we provide the ``execute`` function for this -which returns a job object +.. raw:: html -.. note:: +
- You can obtain the above parameters in Jupyter. Simply place the - text cursor on a function and press Shift+Tab. +Tip: You can obtain the above parameters in Jupyter. Simply place the +text cursor on a function and press Shift+Tab. +.. raw:: html + +
.. code:: ipython3 # Create a Quantum Program for execution job = execute(circ, backend) -When you run a program a job object is made that has the following two -useful methods ``job.status()`` and ``job.result()`` which returns the -status of the job a result object respectiviely. +When you run a program, a job object is made that has the following two +useful methods: ``job.status()`` and ``job.result()`` which return the +status of the job and a result object respectively. + +.. raw:: html -.. note:: +
- Jobs run asynchronous but when the result method is called it - switches to synchronous and waits for it to finish before moving on to - another task. +Note: Jobs run asynchronously but when the result method is called it +switches to synchronous and waits for it to finish before moving on to +another task. +.. raw:: html +
.. code:: ipython3 result = job.result() The results object contains the data and Qiskit Terra provides the -method ``result.get_statevector(circ)`` to return the statevector for +method ``result.get_statevector(circ)`` to return the state vector for the quantum circuit. .. code:: ipython3 - outputstate = result.get_statevector(circ) - print("simulation: ", result ) - print(np.around(outputstate,3)) + outputstate = result.get_statevector(circ, decimals=3) + print(outputstate) -.. code-block:: text +.. parsed-literal:: - simulation: COMPLETED [0.707+0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0.707+0.j] @@ -167,53 +249,56 @@ the quantum circuit. Qiskit Terra also provides a visualization toolbox to allow you to view these results. +Below, we use the visualization function to plot the real and imaginary +components of the state vector. + .. code:: ipython3 - from qiskit.tools.visualization import plot_state - plot_state(outputstate) + from qiskit.tools.visualization import plot_state_city + plot_state_city(outputstate) + .. image:: getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_21_0.png + Unitary backend ~~~~~~~~~~~~~~~ -Qiskit Aer also includes a ``unitary_simulator`` that works provided all -the elements in the circuit are unitary operations. This backend +Qiskit Aer also includes a ``unitary_simulator`` that works *provided +all the elements in the circuit are unitary operations*. This backend calculates the :math:`2^n \times 2^n` matrix representing the gates in the quantum circuit. .. code:: ipython3 # Run the quantum circuit on a unitary simulator backend - backend = Aer.get_backend('unitary_simulator') + backend = BasicAer.get_backend('unitary_simulator') job = execute(circ, backend) result = job.result() # Show the results - print("simulation: ", result ) - print(np.around(result.get_unitary(circ), 3)) + print(result.get_unitary(circ, decimals=3)) -.. code-block:: text +.. parsed-literal:: - simulation: COMPLETED - [[ 0.707+0.j 0.707-0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j + [[ 0.707+0.j 0.707+0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j] [ 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0.707+0.j -0.707+0.j] - [ 0. +0.j 0. +0.j 0.707+0.j 0.707-0.j 0. +0.j 0. +0.j + [ 0. +0.j 0. +0.j 0.707+0.j 0.707+0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j] [ 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0.707+0.j -0.707+0.j 0. +0.j 0. +0.j] - [ 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0.707+0.j 0.707-0.j + [ 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0.707+0.j 0.707+0.j 0. +0.j 0. +0.j] [ 0. +0.j 0. +0.j 0.707+0.j -0.707+0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j] [ 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j - 0.707+0.j 0.707-0.j] + 0.707+0.j 0.707+0.j] [ 0.707+0.j -0.707+0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j]] @@ -221,19 +306,48 @@ the quantum circuit. OpenQASM backend ~~~~~~~~~~~~~~~~ -The above while useful for understanding a quantum circuit scales -exponential with the number of qubits and as such is not physical -(cannot be obtained from a single shot in a real quantum experiment). In -a real device we need to have a measurement otherwise no information is -extracted from the quantum computer and the above is simply internal -representations. The measurements cause the quantum system to collapse -into classical bits. For example, when independent measurements are made -on each qubit the GHZ state :math:`(|000>+|111>)/\sqrt{2}`. will -collapse into either :math:`|000>` or :math:`|111>` with equal -probability. +The simulators above are useful because they provide information about +the state output by the ideal circuit and the matrix representation of +the circuit. However, a real experiment terminates by *measuring* each +qubit (usually in the computational :math:`|0\rangle, |1\rangle` basis). +Without measurement, we cannot gain information about the state. +Measurements cause the quantum system to collapse into classical bits. + +For example, suppose we make independent measurements on each qubit of +the three-qubit GHZ state + +.. math:: |\psi\rangle = |000\rangle +|111\rangle)/\sqrt{2}, + + and let :math:`xyz` denote the bitstring that results. Recall that, +under the qubit labeling used by Qiskit, :math:`x` would correspond to +the outcome on qubit 2, :math:`y` to the outcome on qubit 1, and +:math:`z` to the outcome on qubit 0. This representation of the +bitstring puts the most significant bit (MSB) on the left, and the least +significant bit (LSB) on the right. This is the standard ordering of +binary bitstrings. We order the qubits in the same way, which is why +Qiskit uses a non-standard tensor product order. + +The probability of obtaining outcome :math:`xyz` is given by + +.. math:: \mathrm{Pr}(xyz) = |\langle xyz | \psi \rangle |^{2}. -To see this, we can make a second circuit representing the measurements -and use the addion operation to add these circuits together. + By explicit computation, we see there are only two bitstrings that will +occur: :math:`000` and :math:`111`. If the bitstring :math:`000` is +obtained, the state of the qubits is :math:`|000\rangle`, and if the +bitstring is :math:`111`, the qubits are left in the state +:math:`|111\rangle`. The probability of obtaining 000 or 111 is the +same; namely, 1/2: + +.. math:: + + \begin{align} + \mathrm{Pr}(000) &= |\langle 000 | \psi \rangle |^{2} = \frac{1}{2}\\ + \mathrm{Pr}(111) &= |\langle 111 | \psi \rangle |^{2} = \frac{1}{2}. + \end{align} + +To simulate a circuit that includes measurement, we need to add +measurements to the original circuit above, and use a different Aer +backend. .. code:: ipython3 @@ -245,42 +359,60 @@ and use the addion operation to add these circuits together. # map the quantum measurement to the classical bits meas.measure(q,c) - # combining the circuits + # The Qiskit circuit object supports composition using + # the addition operator. qc = circ+meas #drawing the circuit - circuit_drawer(qc) + qc.draw() -.. image:: getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_27_0.png +.. raw:: html +
        ┌───┐           ░       ┌─┐
+    q_0: |0>┤ H ├──■────■───░───────┤M├
+            └───┘┌─┴─┐  │   ░    ┌─┐└╥┘
+    q_1: |0>─────┤ X ├──┼───░────┤M├─╫─
+                 └───┘┌─┴─┐ ░ ┌─┐└╥┘ ║ 
+    q_2: |0>──────────┤ X ├─░─┤M├─╫──╫─
+                      └───┘ ░ └╥┘ ║  ║ 
+     c_0: 0 ═══════════════════╬══╬══╩═
+                               ║  ║    
+     c_1: 0 ═══════════════════╬══╩════
+                               ║       
+     c_2: 0 ═══════════════════╩═══════
+                                       
-This circuit consists of an additional classical register and three -measurements that are used to map the outcome of qubits to this -classical bits. -.. note:: +This circuit adds a classical register, and three measurements that are +used to map the outcome of qubits to the classical bits. - The classical bits are ordered so that the MSB is to the left - and the LSB is to the right. This is the standard binary sequence order. - For example in 01 the MSB is 0 and the LSB is 1 and is why in Qiskit we - use the non-standard tensor product order. - -To simulate this circuit Qiskit Aer has a ``qasm_simulator`` which is -designed to mimic an ideal quantum device. +To simulate this circuit, we use the ``qasm_simulator`` in Qiskit Aer. +Each run of this circuit will yield either the bitstring 000 or 111. To +build up statistics about the distribution of the bitstrings (to, e.g., +estimate :math:`\mathrm{Pr}(000)`), we need to repeat the circuit many +times. The number of times the circuit is repeated can be specified in +the ``execute`` function, via the ``shots`` keyword. .. code:: ipython3 - backend_sim = Aer.get_backend('qasm_simulator') - job_sim = execute(qc, backend_sim) + # Use Aer's qasm_simulator + backend_sim = BasicAer.get_backend('qasm_simulator') + + # Execute the circuit on the qasm simulator. + # We've set the number of repeats of the circuit + # to be 1024, which is the default. + job_sim = execute(qc, backend_sim, shots=1024) + + # Grab the results from the job. result_sim = job_sim.result() -Once you have a result object you can access the counts via the function -``get_counts(circuit)``. This gives you the binary outcomes of the -circuit you have run. +Once you have a result object, you can access the counts via the +function ``get_counts(circuit)``. This gives you the *aggregated* binary +outcomes of the circuit you submitted. .. code:: ipython3 @@ -288,14 +420,14 @@ circuit you have run. print(counts) -.. code-block:: text +.. parsed-literal:: - {'111': 524, '000': 500} + {'000': 497, '111': 527} -Here we see that approximately 50 percent of the time it is in the 000 -state and 111. Qiskit Terra also provides a function ``plot_histogram`` -which allows you to view the outcomes. +Approximately 50 percent of the time the output bitstring is 000. Qiskit +Terra also provides a function ``plot_histogram`` which allows you to +view the outcomes. .. code:: ipython3 @@ -304,28 +436,33 @@ which allows you to view the outcomes. + .. image:: getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_33_0.png -IBMQ Backends -------------- -Real devices -~~~~~~~~~~~~ +The estimated outcome probabilities :math:`\mathrm{Pr}(000)` and +:math:`\mathrm{Pr}(111)` are computed by taking the aggregate counts and +dividing by the number of shots (times the circuit was repeated). Try +changing the ``shots`` keyword in the ``execute`` function and see how +the estimated probabilities change. -This is the important part of Qiskit. You can use it to run your -circuits on real quantum computers using the IBMQ provider. They are -small and noisy but are advancing at a fast pace. In the next section we -will go into more details about the provider but for now we will outline -the basic functions. +Running circuits using the IBMQ provider +----------------------------------------- -To access IBMQ devices, you’ll need an API token. For the public IBM Q -devices, you can generate an API token +To faciliate access to real quantum computing hardware, we have provided +a simple API interface. To access IBMQ devices, you’ll need an API +token. For the public IBM Q devices, you can generate an API token `here `__ (create an account if you don’t already have one). For Q Network devices, login to the q-console, click your hub, group, and project, and expand “Get Access” to generate your API token and access url. +Our IBMQ provider lets you run your circuit on real devices or on our +HPC simulator. Currently, this provider exists within Qiskit, and can be +imported as shown below. For details on the provider, see `The IBMQ +Provider `__. + .. code:: ipython3 from qiskit import IBMQ @@ -342,7 +479,8 @@ may now load your accounts by calling, IBMQ.load_accounts() -Now view the list of backends available to you. +Once your account has been loaded, you can view the list of backends +available to you. .. code:: ipython3 @@ -350,43 +488,84 @@ Now view the list of backends available to you. IBMQ.backends() -.. code-block:: text +.. parsed-literal:: Available backends: + + + +.. parsed-literal:: + [, - , - , , - ] + , + , + ] + +Running circuits on real devices +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -We now choose a device with the least busy queue which can support our -program (has at least 3 qubits). +Today’s quantum information processors are small and noisy, but are +advancing at a fast pace. They provide a great opportunity to explore +what `noisy, intermediate-scale quantum +(NISQ) `__ computers can do. + +The IBMQ provider uses a queue to allocate the devices to users. We now +choose a device with the least busy queue which can support our program +(has at least 3 qubits). .. code:: ipython3 - from qiskit.backends.ibmq import least_busy + from qiskit.providers.ibmq import least_busy - large_enough_devices = IBMQ.backends( - filters=lambda x: x.configuration()['n_qubits'] > 3 and - not x.configuration()['simulator']) + large_enough_devices = IBMQ.backends(filters=lambda x: x.configuration().n_qubits > 4 and + not x.configuration().simulator) backend = least_busy(large_enough_devices) print("The best backend is " + backend.name()) -.. code-block:: text +.. parsed-literal:: The best backend is ibmqx4 +To run the circuit on the backend, we need to specify the number of +shots and the number of credits we are willing to spend to run the +circuit. Then, we execute the circuit on the backend using the +``execute`` function. + .. code:: ipython3 + from qiskit.tools.monitor import job_monitor shots = 1024 # Number of shots to run the program (experiment); maximum is 8192 shots. max_credits = 3 # Maximum number of credits to spend on executions. job_exp = execute(qc, backend=backend, shots=shots, max_credits=max_credits) + job_monitor(job_exp) + + + +.. parsed-literal:: + + HTML(value="

Job Status: job is being initialized

") + + +``job_exp`` has a ``.result()`` method that lets us get the results from +running our circuit. + +.. raw:: html + +
+ +Note: When the .result() method is called, the code block will wait +until the job has finished before releasing the cell. + +.. raw:: html + +
.. code:: ipython3 @@ -398,15 +577,17 @@ Like before, the counts from the execution can be obtained using .. code:: ipython3 counts_exp = result_exp.get_counts(qc) - plot_histogram(counts_exp) + plot_histogram([counts_exp,counts]) -.. image:: getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_45_0.png +.. image:: getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_49_0.png -HPC Simulator -~~~~~~~~~~~~~ + + +Simulating circuits using a HPC simulator +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The IBMQ provider also comes with a remote optimized simulator called ``ibmq_qasm_simulator``. This remote simulator is capable of simulating @@ -415,7 +596,7 @@ backends. .. code:: ipython3 - backend = IBMQ.get_backend('ibmq_qasm_simulator') + backend = IBMQ.get_backend('ibmq_qasm_simulator', hub=None) .. code:: ipython3 @@ -435,15 +616,17 @@ backends. -.. image:: getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_50_0.png + +.. image:: getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_54_0.png + Retrieving a previously ran job -------------------------------- +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If your experiment takes longer to run then you have time to wait around, or if you simply want to retrieve old jobs back, the IBMQ -backends allow you to do that. First you would need to save your job’s +backends allow you to do that. First you would need to note your job’s ID: .. code:: ipython3 @@ -453,9 +636,9 @@ ID: print('JOB ID: {}'.format(jobID)) -.. code-block:: text +.. parsed-literal:: - JOB ID: 5be8ae5e17436b0052751909 + JOB ID: 5c1a2b4f39c21300575b61b0 Given a job ID, that job object can be later reconstructed from the @@ -472,13 +655,17 @@ and then the results can be obtained from the new job object. job_get.result().get_counts(qc) -.. code-block:: text - {'00000': 367, - '00001': 10, - '00010': 30, - '00011': 27, - '00100': 22, - '00101': 83, - '00110': 50, - '00111': 435} + +.. parsed-literal:: + + {'000': 393, + '110': 32, + '111': 340, + '010': 43, + '101': 124, + '001': 14, + '011': 48, + '100': 30} + + diff --git a/doc/getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_10_0.png b/doc/getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_10_0.png deleted file mode 100644 index 4cb6923c37f73dcb0193bdf1d168acab20b66aab..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 9558 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 diff --git a/doc/getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_21_0.png b/doc/getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_21_0.png index 7d7010119a6919e3d466d4aa5d9f9ca6f66e8ad3..3c6ac529d8eef85a1b1ffbc3c3061bf3aaad4010 100644 GIT binary patch literal 114683 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 literal 92385 zcmb5VbyQVf{4IJY>F)0C?(R+zkOq-1kp}7R5Red%?go+Wlt#Ld66p@_;(Ooky?@@g zW86J9h-aLA&faT%*5@-nbIuj1p(c-tM1%x^Ku{GGWV9d2-01jUS%Lwp)L}vy44-g14*2@pn^s4_Ocu~+zR?kh_$;!>c%=I0_!OYFs-pS40 z#+<_ao$Ci1Cr1iyHV!sU77A-OH)kPs_W$niXZ?I0CR$(EdAK zA@r4&o=(}-B5!8XJ~jB3PX>^LY6|aFm&q1YwF*0zLMrFPGG^;y&ZBj9YKMg zY+(G-6K|smMt9HG=9ia|GgJm{U5d0Ls3LV%9r;%rJrp!Qg1fu8OHe9=`lT(Xxx0~W z{BjW|ES4gK+kk}%^L45cT%Jb6%8H>}A`^WX2}x}zxQ%+E^(%$u<>Pigw(Lhg*;Krq zVHvE_d!(}J1lRnLZcHLD{y&AFBWe7o;&+FA`4C|;FRNz`vZ%@oD)CB7OA{1mvPxW? zRf1kV3;Lesuj}{8)z#R#x;h)o;qNHense4X3Mwj>*mI`wxC~lXxH^CRw$mNJ{JO{? z%suDnmTPKix`ch*TnWYNF@=rNf$5H98nh1vAJ>AZMB}HP11kw@_-Q-cKfUd*{Y)p% zw{PDRl$E8Wq@ckwa3g`+E5a?JIzWye3|>A)(_87eOkYv_Oj_%GEEQR{XfJ1LTgD$% zsC{NwFyhkGi%2Iw7TM=OkKrpu&XyLPYU(;=A{BfP zD1ET4@=0Q~q{8kfyu7>>EAIOU$*8_!>poJy1%zFGtj6?5SC+)Z$6NUNlE})+t{q#S zT{bfA$fQzZfw4DLWuOj>j6|Hzmz7VqkC3w$+`=}~!oi(E{vwgDbdx`=A2pm$gaRg5 zsvF#wOkb}9J<-%QEVs~BMpCvKUGe3jOj-9S?(6kWf|}V+V8}4>3}_USVxpJT8ZhaW z{RFMzP3r_-5o?NiUowo0j#4HnJT@U)7K!U?fD61{E=bU8Ij#}C8{noTK1!ZfVHb#c zqvYNi-`!-*LXs>yckC`rg9VqRwe9*{BFS=ca7*UnZ*VW+`0M$kjRvSmG?Zzh`hG6o zY)~^w85b8d@`N*~R02)!)tzV*)$U^Cu}ZmcUl-3HM#^yYmnC4&-S!~2n-Mak3|ZfrwgFy)5_>jGwKN zD$jw5nodS9`09YzWi(b#dqM5|K`T`5&wu%57_HBQ^2Wok_v{b*QLi$hKHmSbs;8u+ zgn|wXz@CFR2MH=i&O7X>AklrDKtJ5aic^5)o;P{+lu0KUi;xc?takI~;Y*aT%wJku zj66KFMF^GZJU;0B=o%vArQp@FJ?19Roh5tQdJIyIn}^4@y1Jy)Wi_54{Nra3Vtkpg zR~_|&w8F#@gLXL8#uJ`0wP56Yps-n8X%wZX5@B)LhZD&UEDPY?OYzN0S3rjNP@Bs-VVzK=rLE`n&PH50W?G{burlo$vU z7zkZ^7wzIAWD`DWt^y=rwmcut2J>{7wyz(HvDtdE0zpvjsT5llTbM-UbMW!KD%3)3 zH;%u&bSo$>?mc$zb!_gnWwve}c2aP=WYbk52Sa5=@;fD1 zX=gr?T4@SZT{*<(BB;v~WgChEE0YnT6<(i}Ll-TbKES1*xv0?cP1SqcSDAWWezbowcerv$sbX z9v)uH5sc%OZaDH+iFgx27@xwzA&O6kBijw8o|BWaDBh=N1NMUDw@T}=jB*>22lVlg z>vs+@F|<%AsBE?HloXsHOD>()uT=#pL!ywpM92!X7z?y)x*iy#pcRv97VT@6k0)&# zIS5d|Z}2y$Boqi#)+tO_k-rUz_>D0=MdmrSam@ypX^)%*idd7fS-*Zz6TyiiU>9vl*lyP?Ode=4=~#OgTJ%Wr9GEpg6_WGBJzYTY4=L z@#cqo+Zg5+xRY(+KW;)6{v^@;TQ`2`2V+%E+bA?C%W+b9U2R?$dgAUZu*t`WY-Ei3 zQTe7^881;ZWu1_o96JRvv6=lFm-S?_7#{ z$ZnnM7<*QHSkfyUd|mD+T`!TGH?YB*#Dz=teAT&2$L>y0X$mywM3NY=oA`x43;cT( ztjuzb`#zv@&+gIdg5{$tN1dlpssqYl~)^@h?{h+ZToC;2&=72LUgB*%7>8( z6(f78!vlN8gtYR;l&bWyB-2KV?Lj(jvsoVwQmUqnmdOvWD>bhbaHQhPB=J;8vh?F5I&iVFRno20 zrRL}7FN*h~+l2i<6v>wq!&m4{=filgpMu)3pD}J#tq>(cHMHy6(9{&xwq(VW9uAMz zJ85y+nTRd{ecC6|qUxxg#`PrKb>W~0PXX`z`Ssn!oi7a?-K$Eu0)~<0a^-*NDsI#Q7gfvM^cTo+2qIMnqX zlpfLJ8HrkWv(1Bjh%r2Fq>O^1B4SJI=x$Gk-$O!1#=)^Ni1sx;qOOY!B)mc{{fSK0 z?cRV}!nTQ>lnS|TlG4)BD&!X`J&0B)r;P>Qs1;ky>zkTBUu_Rao#ro!8@H!`n^Y>q zVoF7V4uo)Jpdcb5N)8f+3bSE%<3#siin}w|v&E;bFEXX8 zFgaXH;M2gB-Glpb$qW^I%W@QOi}axaPPm!VQB_v2G8d&{b0xK?S1Rw=9`M#8YAUV}Ae-`0YxPlJo309JqPN3z=FYeM$) zTF<|mV`P`!q9A6GkdWH)h4}b>9L?OlbvDJc{Zl@MIU&sw(yP#%270v zQnb+;HJHQo(e;QVGa7Y$m{W?Tk=1B0($BVM-sja&vQ|;OED`y1K&THK`~4Gp56V9fGL~6E=laJcvO951b~@zrS1cv7>SVEkh+H7zt~WO{!xE+vZI0-%^2R9PUOH1SnOivw+Fn6 z&C9V(O?+UX$T`qpjKiOSl1E+Y1}Y{D)}V5XzPmnePfv>@;>ftEmZmz8bxo}=}qUC=LN`f&6urF zi?FfLxPTtH$mA!ii~YlR7TaEh!m!%SFe{mw_@zgj@dZj_c6BaM>;R(!4^<*V$%KG9o=y`nvXY+>T(p4~vc_!kjtXeHtxj5Yb9tD{;Wmpbe{Z5k@pI?0MCm&tkp9 z4|7~4HYH;%STNK6EI^PV-G0^GTys}R{MFl=7;89g1M6;TMJ&)VAcaDM^(QDOSW;1e z@+19Ik(D_Yr9M^*YY?ki8aC{w-^jn+xRdWWq%%ZY4B1FTJTXvFQT;Umk`GfWzG#|) zoMvVS>Ff0(KBzSHZ&QsCB1mGa@kT4GxSP|azaJ6k!skm29^DNxt`6@um3aG>xURll z)7Ut!pnzr|{v#iI4!^TMMSZ3r=B7VsUrz9 z*7^MhZUZaw?oEqZP#M)t{5GAIjh9)Ip z6%-T%P#}P!H$P}~M6Y}zoQ-LflrHO(PE4l02yvDb9}~#zV<9rPF~Au4llS8XvA({( zf|}ZOw3dzJ6|WBhUu@X$*zCa<9j^c4f+jr?i@BKW+Z4f^#pGIveP>o6lE;c8znc&# z2#A5f!NiP=7sydiR5WlILO9-+WDT245m7^L1!c04A%PXy5sIPmV^nN=bnm^^Tg4WO zv9JbqXQ8W6ORF-c6rz$?y2&w}`+r%iWZb_)OzSA|7#FR7aRknQq6wGGM&kNom4KKy zSSl|7Oqi7w9Y{kOZ{F}b(ARLMCKcYGx=$A{AiW9>%r<=$=$5=Tm{U4d)RdHgV-^;4 zKt$)@&7P=`@Z}4UbLOxW`b*8OhyON(kUWgz#+n+t*lW*i4F5aAG^Z4S`?G&tV$06t z_I3buhlYkEjE%``?d+&sS)!WKl2B(To8-P>f)E9(Nc(C?S^+alD#GD7ZqY23 z|80Kf0baeQTzYNPqg00IpXFwB5SiLCpuhG0cVc&q!Jw4ABFDXKe+Ft{Fjn+pSgkd3 z@V;ikrNKhnaTOdH83A}) z)Gs+PB%KnrzPJmQ7NuX8H^MU%OpgG&najRat>h`d$Epr@P+`O6^jx9-K zVUNFkPdDr6X``XSCvDj1;*T}!Pu1<$L}cFklskKSFp$6PH^wVod)b(zy=l$s{(vZf zXEc8h4s)Q8FU(o`x(7l48T`Va#HB7l9$%F8*qxUgRDV8ret z!a~p699x%LhKGme%^Uze2EZH`w7lPEp3am(oveLDcW`$MtgNBEn-aRZpTF9)fLmU5 zyfJuE?GUeh?8B8y-u1=7uBP6P-o8k2Z33r@{#F5pmP(Y9 z^qfa9sy)3vcd(Q(s$ zvUyluZRJMNbs@I)VM6rwazgp2ytuaqQTwUmMS_m1 zexN~gAsEmb+iq+ly!5c#OH31<1;#;`EIpT`T9q>g2>_~pH;gMQW9lro%hN!J?(ez3 zoe{+5{`@eFCIeUu0&;SBEiJ8uQU+M|o(Wlmr=n#ggdl_ivTgStPeslIv2p;@F4*%W z&1-PHP5fI^p&miDco0S8j!ePwIE+~g2tI)Ics z98##9w$%+!-ghw}{*Nm_27(AFSbt{D!44Y6^G4+|=#H5W$j%{<(oFFnRV$yP5)>o^ zh$b~PRZ<;e=9r#1>Htrrl@`=#9K2{akmA$DKZ$w!_y7)}R}LcLZ%O|e$^?QHXo5Vg z%HNF{6ZJ~|l%L(h`4*Pj7}HARUNN|x9GP4{LhSWd`e)2; zYJW!vO%HzEcPIr24nzS;LEbHAF)$*Ob!}(}0SOto{U196L)TinPqF>Yn$L;ZuPP%@ zWBQ`mJNBE^K?_5(@qI5x+TERxAxa3-I#ZA`-CiAf%3v9)m>Sewg+K`i7=fxPHtR+M z@Ma0Nv~O)~SyPIeDrkv0aXqB}wZFe(X}Gz$H4O}+KwEV3FvgQje4v=>rshq`K!Kfc z>)7vcwoNM@*83-7$-cXJ$%PA`Q4o9nj3z=LJBU%FD#0MxmUIdlzpgV}N+ZmZ(HAU( z9SHiP(3LEc^+*j#K%^ii%X`AZr2SGWn*PS%CdX z;=}*^v4=n;F$hl!-YG)-Agzp1Tt5-JVHYy+`^p+a#%aLQz=ld~X5VVQe!a`88yRAa z9G@SHWkK2GW+^HpgarEB+1c5IxegV$52NhO8=2edxgTnP`*7g=0RwJs;FeeY@NK)WfmQ#+SDv*6SM2 zMLZq4_I#NRQMk)HwYrz+*;qMhTf7)vt^eXY8&X5c5#S>^Ry3*r$6BPx^LbiDyu8WSM-LB}u3m^ORDu6P zeKth|ya|P2^gnwEDJ637|IdeeScTNSRwhrhT9e? zqk1{S&h@L|fx^vph6)|P@-gx8;Vddqaxq)9=`*S#Pqr{*>)l&ExR#+*iC+a+L0NP- zGcYiC;ZHj{#6SkN82!xZc~sf_*rdsTlQ6mq2>?kN<6>{(y`P8yhxpwNHe{%X;SdQz zfe-}05fAYfdk>q8T3a`WOxp^UASh&jX92x|>vxjM%E~qNsF?$iZEnuRzY}yqjmyV? zdnO8 zS}VAB^Aw3mG|=KaYsmDdBoCICjB(L(yfo`C0(ZJi;JA%+LgD2kEan)Fhq4z-{U{_k6u9r36zKw3Q`<4IwJ7KwQWslRRhqu1Bo8cG;u%M84f$BDJ?|JF* zrcetipl8pWUlK#fG_Jx7`cH?9c`bpr-z~Ng12kfhlM|peP?oMCGUSx!caJ4y%y7_9 zAPF5=aAT?fCKHh4fCOq@Mg_V1{@y!Fzy;dN%L|jV{_Rw(N&5x!pTi}%fG^@SzCQ#o5k+_g{jDo7`zAxUJTGK(_Z-Kn|9L?Q-C7k zITze=bM8ZZi~N+qlKxTlV+nH^@}r>w7U>h|{{B(d+2*!Dp%C1(?AH6Ve<;kvZ(gm? z<51sYR(yId+C;v9_KmmZ6KDJerDRsXWuM#7v?aq&Ho1@fyob?;Q-<>>K}cfc?&s@- zj-(&!a;GtwMBOqR6VPeOrV50%cN=hQKRZ?+;F+QA!!L-MCTOdMF<1=XJ*mJee`bLS z_yy%l-c@*-@gF0GtfEXB;Fr zK-{%)^TEW5Zk>6?BN;lnokd-|XxgT+$)HqON8iJ50C z+PA&%TQkfLwLd*U`EX?2k*3*(6d1XMZE&o+teE6!1Cm0g(}V1rSL`N(32eTzn?)-e ziz?tGm`2Te(h;VSLhPvD5Kd3yM$gz9OOKSONz^?)KDM^82?RnB_Uzf23uv7?4~PT% zQt)O?C%BED63;NKl4xLb_tB5SEWESaT)fBNX3T5H+}^ffL*{$7Pc6a+`vR1Q!-8V< zK*|C%EI2V>0~;E602wRW2qBC8YS-`}uYG`Y`}PWO)0UQ&xw*Lz8yg$Sb?l;(G#Q%i z`gNcAlcvp0GreP7YXwxHdm(50Qv$V8H8VYaly=2`babw}Fb4Gxp3Sox_n(UQ!OK z%JDluay(z9TDUO&B` zsy>kaUO~bO$7{{xaIQ=q4q$mWuP4I$ZafAlAm_Q*#74q*NBO60j|`Es^t};R&cdCE zzRmbki~`BzbAS#&J#Dj<@;ruddg%TG6rMIVZa_&7#*s!J zdQGM_CEjz~|DBje|Ljo6yozVRm&pl)%*oIQMwl;9I97OEYiWbql3myvD`g*C9Ou59 zHKX5%2`j)GFFZr9-5$m!BxYs0_HNa5<=1;s3lP<6#AHtVAe`{~_r2tol1-gv*xj^=V=*yB1L3d^XF2GhRsmT38aSb`#Qe}*x)57WtVJwHz1UlT8JM?F{RzCqqa70>N*{)Du| z@cHxkh#U4{MoC3A#46!EA-QGvGE-48HXrh^^0(**?Kp8$BEmlcWIh~xPNoGWLMn}$l`yP*2HQYy%L#U?PpC;{>KXt z-EZ#1TMU>y#UyQ{*U&C}Dxw)`&1CmIl6j{(X6kHKL?k4ZEA>S@3}>^#>YKq$=-@_+ zR!-amIjx9#(``_UqS$=>`_`wVhw!&n4nLgzxtgGo#b_a*#n?0;C2Ki{5^>&z@o!F~ ziKGsecg{V5#G#S)GtM!h*o5U~Oj6Kt!ZowCY_AgtEIpw8!#JarVszbilLi40+;6&R=|M_h+_RJmq6QeOypJcDl|Xt zW4;Vk%Es1xbnWxN6+>E@{G*}w>-L4yPsCl+o+TsIJ^5R*)@*iiN>ckbsd(H$6hT$r zrd7z^$-c!1;~pt44=BzwWz?r*RnkVFOLwH;=WN=-Lw?)lIrHmRI6(XaySuvtBqV_Q zB!~7S?_vnRg!JOb#!e9a2ath=hk}mYYs%3D7&dx(c+lZ#F7C=IH3SikKL>_{&?ti1 z784iOv*|1W)F*(&Oo^dc=Qq_js-KTu+drC8&u$+k961GIAj-6uKErwL{D|LpyxWs5 zpOY%iWNPV7uTh~;Ov2He1p?co#!^7o^o-pMXgPa(dn>*a-`xBi)IJdl{g-u%PExf& zh?qI^s!$TKP%^R?CcKt(x&7w#5YuVq@~7a7@`?D{TM5%{L){-Jqqb>qD{GeAFNq)R zhI}A05qn?zrdv|T`4_FnX3+eIv?*LROAS);k zpy%f1Bs=vsYm#&yy$7o)-6N+Ar(%Ae|Bk5An6L~{1T8M$0XRS#0(!2jEE1r#g;s`G zEJb?__Iqr^MW38L|4TW?Sz9@ytB_)D#W5n7MU#4`Vb;S1C2Rv9zmeC`LMGmMzNhE+ zY}+|#o|M!mXz%$qc<*tZHq@6giAHeV2dOp1d1J~Ximki#M^D|*Z({u%=T2w;A^omI@ zIklzaIzJ-*X!LLLkJ{(etA*uue*2I0AVu5rgVRD!JO-p;Chd7MNtFhx0-MMtpD&RqEcz?0rH9Y&EM6bu`wASt!Qbb zf7M&`p87mI;_S7$Yi(_fa2tyD`ifYIWBv9J_3?UpeQSSmit#I4@n|IH1;M~rPRa@X zV8`hX6OfDfS@G3ZFLk;;N;U;8f117!Mk?_h1U2YDPSX)oh0<7Mf6F8_fU zwL=MGNw;)4nfYA3&4-0kaq=g0Q07n>P>?zwLVPK;u(T3D2N4uAbJQ1mK@@zQ!bLl2 zC!Iv27MCOAAj#SX%_%n^mzzDw)oP7_+^?tE39Vl3zvNS!t6NSepUxDFL@d65P%9C$ zlyAT@Zf9;Oxu1C*JG)_4r|HiT9IkPNWW|hpQ%fOPkd85E$kAxPipOezGc%aw2vYD- zb*J2$H~3Yphh+iFSk^ka0DFAW1jxl0)CEQS$TW}km^YoixY@-* zl8KUPIj|C1Gz0b)1og3b%B!IhYQFCGj!_ckx>UyZ&&s#YNhgDrMek_n&Kst_>z2zZ zDIv*FVSZ-O?Q0=Vvq9u znQ-tygMUDOW%S9dHES(D`)8us=u3GbQX;Oo=@hNM1TY^IMOhyY;W!jh$vq8vxk0(SjL9xbZZGOg85b%xeNV)B z!{#u}&5<314-(t~S0`12^rTd<&nLS z?!xbqj#OQP8v8DKu^i&du(rxt%iOD32^kr1ttGxE3mL>)gUt!kz!GjP!@R{V76 zU$I#CN*MhZ<%ir~H^Dsq18`39dJD}Y&?xq>?yU!XWqr^ei}DX5+!fANBN6q+0h*b1 z%=s}N9(GC)f>jd5LB(aFsP^pqe12miZgzHdECjFDfQ|>P>Cw6|d4nl64%#$SaDTvIknM`kUArErY2oPPR)?H6k@=v{ zEfch#PujdJy6Xo73(wADKS4&ABqDe#y(8Kmxtow~+K9iA<#4s$M zFQrvWa#wZtY=v60ImyXs$u0QpPrRl0=9|Xto~%?f>M4pRR(BTSFP_G368C~zsymod* zqkMA4d=Hg=qy4;l(fNYw^7s!am6P)r>Je;$cq-f~`UGF^Nqqk8<+P9U2zb^kHG079 z6A=-$4d#(1?lXIr&mEHby=ydhGC=i(=b7mg|2K7UyDIJvU!I(;-!5VlM{aaWz0!I9 z+|s}b_z(@s>eFZOr4)8Z!%c(5s_;?G!_MCTI1#pyP?u4G0oH9mmTZY<|2z9((uHkm zGp_Y`P$f<&Oe?&#{ll<|@#{Ole3}^EMF%X~(eYTH*bL?cO79aLOLZ2JgY@rSO!|h` zB=jSHRp!_srr?2kNypGjyHElp`N_cOS3e zyGXFdH0;c~O_|c+GT;)$^Efh6IWylEc(a5_WU2szd4BfqI`6E8VZVaR*l+Q(lweSYQp;hea0 z3j<)o;3s$}$fxB8en<|3Bnu9;W(tCS8OpBLt~HBY-&5?3Gz->4ds7D*_rZa7wG~}6 z(XDr`v4JlmTidY|O(9L5Qw93!7spFmAI<{upq|`-p9Ps)A2L}K2U1nvm>;9s=@$y) zS|C;U_>eZ8tfOVlgjtprCsa^exQ#S_=eZTCWuJ;$TLSp}^cVXxQt)Ee(C9CGvH188 zOh3C@iGP{7^lwGPt0vK~pegqiK`$~c>Mgc#mpG!O;zW_x|?dk%u$U@r(?&r(J zuN=8&UkxRTeQnZ6O=NsAldwgCS^=f*{}gQUAgex=^M~yFHKvH`@xk|Oko+6I+72dm zQ}64#eKT1_-%ZD|3SShK5oQ-f_h9LS`L9bWX$7p3T~k%}FZ#}~(PN?2;*1nDuP-FD zg0v+g7X;*eBNP03-u_2_D;MssbXyqtwXn4a(V-wBy}j&CEhG~w=O{?r$be0U!2`hP z{+r*uzhz{7+t*H0O-e8gm2aE9XMT{9k^&oBoWM8v`VV_*E1&*7y%4n*KZVaud(j_O zotl@=g2^8t4>u?BK-Fz>T#ZUfN{Wb=z5oi7shivEvKoRZoXA}#j;F8X9pwCXim9A* zOR}Pk+K#C6ChUw17d~9q1quCsez@E@+r*rlxVAPCpjnts%=~;rir;9xM#WNU81y*iD+edvot~96J~1}9MEq-OI!xK6WIb7m zcoI#*LBpa)2(uv}RQ`05qZ$g`=n11r-xsxf?;ONPk z*L!B;S9V1a@)h4;mcGO{!DZS1F|F0t^IBRW;d{J+{}CX<2ukt4#h((dIu-V5BnqhVTHcYFH@+e zZFh{G^s4JV_BnN$GA?3D?_5D)MZ)q;V6EWP_34}a;>aM{WjAWY0n?U)+&Z4g$-w~u zPR=wFf5K>d?g=75->m%qiJ!&MoyLAwuYuk3TX8Y`+a~+&YX2){`_R&>~?_p*ZlXyVpwk;+)MC6S_A?v<=TJGLEo6?yNiCtfhD63%74HcHyNU_hT zKzUckRejL1e0<%CwrJ0%qJh2tb$<{az9S&CW~1%!;`CqD{illjG*Kg;)3JvM)0^Q{ zf17pDRiDSN^zrckr*S25B`_(;K0SNS;>_lLukcdx=3E&L$I}6I%z+y;SisE*&K94u z)!VyJarv|+WRNwprn7oZ7dTS3mG)Kd1CILKT0ej}CCHdkA2@d3M*sH+V|;gsOW-iT zDEei*a6E=dpT60*26MFe`3Y~{ULU4XlXw;)h68k>3Na_%`L&wQAAK-pny|XGpW0hM zA7}GI$zFTJ9m-RClR#=TwfmEtv8@#xCH&kyrQ@6@M+wplT@k0Jr-62H3bg7v|F-`T zac8kZDvaBSfQEa4J?607WVYJ+5fT8J88RS(vL7LLJU{za=+#2w;^Hc(tIIn&vKjlH z^_%o0C%uLt$Ym(QPPed2hy3{M>P^a>VroV6&hwFodMb=#GzpDdHk)M$Sl8ZeG6C~x z+UV5M64C40h~?vfQDGCg_j)TGc;8k14oZO&xLFzM4c#QwL=$lKX+9kgGHeEkrq)ln1af=P-JwA-- zJT+n5Teg;dpV|Tf?cB;@RQXqN8$0`oDAw>C6{Ob%zNEmoiUk`8gs>N0V7^M`#PqjsZ4;#Be$IbqpjIF#Ch4}A6 zmlDB}&(hhC>`rN*E7~I4O=-<@73zgg?7{z8{+36)xu?HpR_efL&qu75EwsDGf?d+{ zh6OJ;p8;g2iq%#;r@!9V1{RjuoFr@$1z7Ex=%8sPH@=mw)`PB9zZ;p^ZE4-LHC%OV zylIjSM>BhVyu*l;(IC`$QIw|dl=Wrnfxt_)el8$p{SSioa9|%F>?Xlm6$Eex;NH&8 z0^^^q0jHUhvo%Y?Qf?IXURNCZY_I#k?NytEiDol2Ghfx|kIFZT(NC)nE|wbzt@5p$ zC1fE>xdSaOD;FKe3_BO+E>0KiEqjkXZ4Xnao3)m7*QQbZ<}607vnNe}J6jX;5{}AW z0dDX`3cP4S!QBYjtsz5!9&6_Q;=Tep4J%!z2MM~4@@ z#qZjH3{U+T(FEj**pJrB={EA%$jZIy7x7@kFfWaEmdi z!Kt(Yr?5_I#aVI#)3tj(Dmc=W2QaoQhC{x8Z79Ilaq_sedU$wx65QS0K{YcnFhCTO zUhFmihm>zm;kyC>&-35Y&D8vSnE3NqJTXKMDjo6|onO-1MWQ+^hcq*v)E6S7cUggyn_K>c#(|7=1J1(4+d=nvj+g{x)qj%Eah`Sy!_+!5u*)DEv|7 zA3H_zK0PZZD)ZqRQ`x7efE#U`egU7e=IZA#)vxwF!&Av-%~y@(!i8d?M)V#~5LYc% z=ZSYWDukkVQ5w|Mtv`Mwe))nFDHAl^qa|(zHiP9dj3gg8>ra&)$ix@HKehVnW$Qj} zm6>b=-QkCbxN~&-emZ&ZbX@)*!0FqQDJRP3i}FukM?5LPJ$MALr<%HnZ#3}J*sp~+ z?~v%;?i{%O@pOZ4z&2>OYS^6YqRb*WEAUNyMeBwwv|x12c)}}*Va?_+kjyVS>}@_K zj{b~&v}P1eIgVjz!-Zpoo3En#+X20du_W^L1o>JNv3aa7Oiv~qFa`U6|H_$|kb`Nf zeK(5Nb~XRjfBD6C1zKStz>)=dtoz}Qrm?>#Wu57Fe|ZsbT+aKGln`q;Q%DU-&Y5vI zVi3hkCe-$6+bOWL&PDu@jsJ=@PoGx5q@qN|$;nBkJsqhXTD|=!gH_PWKWEkErYHps zm87TX+F|VhAxI*K0SeSIpf?N@3G+!ZB@Ec-SOG0r%&%u1uiCBv*{Ai!)Z~{K38_Go z*%QZr!?y8Y26!x8zN)_axuYj7UzOSgmWA7Hx%kD~^g;V92vnp((Elq-4?G6lS+m$! zuKIUf);DfCj>KQkasIT2x%6xX|XuCRTeo4ll@cHM|0AYy& zgMyZp)>O8!I>XaT^ZWXJY46U9u~mj@D&^4FdnMHgNrSVfYpK%iY^o#P)P>{6kXr(p zb*uq6vj_wO)zLpi&7bQ69J}}4h=4h|yCS6`fK}uF(TUdz3#dv-Xes`Q)2{rk`>zLmhk-pQk((3Zh|l+cw>vF2yo!!za2kd`?-n z-gQe*#F;?7?FrVMbba?tpR9>M0c`=L>X$Gt!3z!XYBJ<#d~?ueS{7#gv<~6ME{03R zn;zb-%2F$CmVDkAk}Oc3c9Fb-BOoLWe9^T>TbjkWaWaN8ZoBKqHxlj0%&s~J#$Jgu z9}7YxjLb+4M&3S>#7k{5-xDelwp46#>Dridal>3qHIwzP{cShVIPtq6TS<9vGqEz}#mYitsA9S< zl2l9rTNXm3@*uLBL!+a}`(~p98HkV$p=;c~x67migyd$tj>=v58*OD5r?(&D>s_X?|42%=K*DE#YYOw+adaa2HpG{m1m_i;8iSfC;HuUh0EE%yt?oJb`)IVV zKm0}mI9iHV#6?6?~g${v|`()hRE#|9RQ1Bbe)mkkstMALPo%6;njPrLR18^*XrruD_zWV}yy{^dIm|KItsD(%|C7Hhqrbqob4=bio8>zt{V{25fU`sf3PTHXU7Z-v#Y3Q7y(#O`PX-j-2cTsVaYT%1{@*Fqh%!mWBO$u7O?zF z2Zx{bq_G3ao*dBo0#46fF?8gRXGSA{wnJ%=YimOEd6##7**|m~zm(dAPqv?Aa`JE( z78Ho>3sCWj;Q)cx(sp*9`{s{*xH?R+c6S}mV#+*>31~5_j~shtdGS^2zN@nRj~5`a zB17WG&$hc0{$icS`=wb`<8UnGJ_S_;S)jp}otM>|`4A^&;@t-^Crvo2nxS^+d3Zyb zhON$ZZ*vI50>wU(1K|SL0)pqvu8LsG&&y6vdC}oX62?QYsp(H||B1!1$NM1`j~>{d zV$oA@Gh$~TX1qA7KFD(8jlT`~J#E#Q!X$}-5#2B801b8<0+TjU>9A#xZuyH@Ozlgp zK_#f?*E~-b0q>i{gX5mjB4DW^VDlpezC?za8%{aH<$T{Ite&WzvW{WsdE8pSXBcC! z6&2sm%+cPJRwZd91|`=IfW*HZt}ok!M-@mxL6(M z7rNIhiVnEWvNon!{9hJ|b66?EBaclMLI(v>#(~pW(-Gsx=;$N^exJUh1N&M?Z^V6Yk%D_p z#L|}GzRe+gn~U(jwD{NM-`08Jckh0L0SZ}L z>DmKZ3wje?<{J%KEJV2&>U}MbJb=WZRv~hz-vH1DW`qE@M1~Qz9+)>G0n2IXHvJZs zf2)9zv$mP6x5;nW^kdfZ&qz4)0-6E}dRll{{T#}}2JNKk+^{b?Sjy(C>0qmzprCg7 zpZCx}0`)v7Onb47i`=YyxEv>h_#>NQ`t^cx9gyt>C3?@O0Y@gQ2{v@Vn3+)yn0=P( z6ud(1(ENmb>Ce9#Hf$9%Y}FHB1u^mPKW?w4DTZZ#JcX;UH$)7Sz?kd9HaX|MaOwTd zzY+F9{p*TCQiwt20N~17=T-@7V@#cWF+|JAVoKzkA84DmJ5q0C-KaoEOx=p9F8l65 z-ruJ26Un8MZ~{VSrMGGtrBO;;5w@xx*C)iEr6S=jG(S`Bx4i8?S^hAYoi9I>?JOg= zDi*Zvq>{vVQ3B8_y&1O3z$=SM1lXVeZL5HpoZ`EA-`TX;2YrlJM5{$} zw(XrWRD`yuAKnkDRebUg1#%*)XJ>YUG2SCD<6nH_K0UoUj7+Cxl8eTE zi9Q1ku&`oqRYH3{p(Td86r%I{sH}+-Blqpsz6dWb zE^BHcv0ym%m;$@aG}cT_**n~vmQBP?V`;D_v1B@xM)A+VS}e}E;E-zsx;q(Owsh&${4b{70;uZs`yK}AP6< zwZe69Sd1Ke5!jx6pzt^=>zX>v#Cmz{*s*&|NRmcZ>6bOl9r;(TKadxzr;ncpviEVd z!Ni&Slzq#rn3ee(%fLHXeC_qz^8&MY6;+~;N-`md=b-vuj=*ChS`=+DJ) zsw}C>Qu0^guY{qF67Q$gm^72Y%X{P$ZvZNmJ$)Yx+NL9Ey^$oSSo!zG1MB}ClNlx9 zKsnv3IwV`jNH&U3flf9|Pm@nR4|^n3F0J!Ir?m&mM&jUK=Goykfp0W`y!#&S&pLrx z*EM6m7bB2e{h7!O%}t4M6fu?!P*j~3vwtV=q?JC42DYN{Sn!~P}a~EFG4}^^!Vx5(hGLIE0orCMTs8% zeaS$Ouu#_1ew`}{70A-gXcv0EV7hr-U{N6*9E40wo_J zyWMbEE+;2Me|fs3_PHyMjf<=MVf|ddGZXJ*{0JXBdXm;gN1+_Q#~%}-Q5%OBd*d0w zq2zw_&kF#^CVyS@85)tn!205ct||JSPtZtLaS$(6`F6Vx5wWAVc~ zt^PSE?x)9NI+!3kfsvxa(Oqt{cb7-mJ=Tn=_1rBqh@Wq7_y2w<{xB9(8>&>&@u~2{E^~BP}exPXl_coQh(6;&@b)QsgLuZn3}wO49%CTHRgRQ{C&HPnjDmPV+s&8n@(M zx**8HAQ0Qf)fJSj0P=h*VvGJWHV9Df==FxQ!)aT(!E@g&n}YAc@H<6Nbohy_c$b6x zPWkM)mjryYb#zb!*T)jAvF*_iO4#)K%HR4hR5X)?B=T-g|CjoGg^S?S=p!q}bY1)5gh?-zH#pR0S85cV;mOo}o1?k)9OIPrL z0m}jyqau8xRHDQXQT&zJKMM&bKs4k031?1l=-@<=W6(R-16H4-&@8pI6Iv|LD}CL~ zojq7A#ptL=lh@hZ0#6rNI2yyO9!GU*5k81yIcw6IC3(Y-?iMIrUz_-*m_^KDAO@fI zlz)yH^A4iwiU~X~c#;f&wQ}nCR(b~J9oq^)j z<@IYV9i70SAk_V)E+?30Y8B}=;(1s%TxUvpdx8}iLp+UHxW8cZOgD6%>J9V`+q;kx z00SL)G!ra6m_7B}`Y4>$AR(&kzshbBAqoF>&b8)u-_36>Qz}>L>2As9BOI7ih~pCz z0+)Bpb=RJnYxU*&-L14Y9qnki`r|Nndh{Hq{F-~cYFSZq&3jt=BGy;7_B{{K7^M^Z ztiJrHDt}|3Myny3)770pbtr#E&NCfAz*U5at>=GNFY<2cpSzWOCE0u>!@P6I=SGo- zt%16%@-;k^Xa=-8r=ahe^PRYf%1l?HZ@-vW$2heqP(N&We25owLgznO8vL`kRfhcNVzM13bN?7FAKm12pgK-Y<1i5a`k~XSF%O=co+2N}*(WO2 ztM5sI1QH5dB9ky->X_8oqay}~c94nu+O5XOLZ+7#qH9*lw(qPf4E1l)r1jA{#u0N} zk{z#9ZdDsEVIu2h?J_-yzvN`Vo^ZRr#H;vV)Z=y;O+b=wQnF7JG2laWG- zvzNL@VeGyCbjM+VMjGkxu@}Idwj*_>S2?>xLqym?ti)=F*oX ztT~hEa|JrTxEyvzJA!!De`wvpcim^_)k0+6R-Uk#7;@k|Qu-{qMk`76yErlx=i|Bb z!yb-*sk)n-gqWtMJ!OY$&m3iJMzkanERTojU$q8pVWsK`J#5e_Ky@y^qS*6UarkU! zm{t*auY9Jn3i{FI#ft7G3H^qj_k0Zhixyt(AZ|)euv1vDtsG8jfFDvVyR}(Y z0|!spn?(l^TJh=TUC-(_SBAY2R;dE!#MV(Ch?b;exFavTBw*$nKHzu)1{$E=Qb@A< zN##q6_z@8mC1Ef7u){2N{jcL!jSUVb{+roS{eyF{;S1M;FmcT!R;P)RGGY&jS|(MS z6EIbP8BmM%AS{qTV1{-;v!D9Nfy_EOUA|fI4+{k@3}R%Le8F06SY;i07z&&p_%tD% zI2QKaSv|WNnVQ0gR}#o3KFC_TUA(Qkru+M5CwfDgn6B^lcVmH<9}YL$G)h{u3@aZ8 zvl6A4dhEK2z24?$dpHuU71Kse;Ny>AXU2=QU^Y^C+zoT#txqiDyy8Jt-EH=b+?9rO zBDDxAybqN)nEWd1ETyN+N-^SJY``%ilNk*xYjEmB~j zs2{ro)%=K9R|R<{0*SV>q^I<1*j6pxVgJ1K-$=QgLdtg>>lDh-K5b438(xQ07ukXJ zx8PpE!eWE8BxN(X)OJSKDf#ywir%`^4^I5hz>hoBf3RJ6bInncMqT1E&nJWj$NFd; zY_`U1XkQ`=i&4nGgLH!Gzhz$tBRk{P`|gwc;ISCTRV&Vt+MQFDDyS{&SmFU6h|}AV z8eL+w@I~Qx*O!itiq6iwkTsu%7}wj-{CoE&YvUMq&z%G>K@6+nqx*xs?~4xOx-41J zUF~gw7`)a4smKM5&sse0`g-hXXl3=RIuqeyT%oYtgyPWC`4Qi=y~meqeYM7%Pl|R@ zwoe*{t*K)inBw5gCS$D$Bqt$er*~{OP9y8T?~~qD?hkoR(}vgg0wp&TwVn_;WWMF! z%kq^(ZOTb`oac=%i;PtqG%-6ih5`?cHdfJ~9t$-9dAdZCHHsrUq{D0=Q=AHefcDye z?Iui)L5YbNgyqs)DJyxg674lsKdS5|O3RQbkasXcec8D);wcN2m{flK5iqWg)7N~@ z&RgL??ZEc!LCN~qP}|D!;%01Sw@J$dN27YRd;{F72M*cw+tpN(SocZoIa-g(-dpr> zTX?b`xi@`9g&B7-Wb5e6V1qmxX;A~5tRZsgREFgP3=x8CgRv+s3-X$G(_hb0&J-{i zyd2LZ9C8z<&AJ1r=sMTt(+!01&y%c8-v5Vd5Rd!i?iY$Y>cEmOI=lsSz8hK5xY7Zv zvjh;2;1k**t*1wpT#)E@se7aIwQj}GYvDpX<_+EM+0)P4W^ZRPk~}vTtqyr!kE?-V zh%r^4Kc3-+Dd34L%ie;!%4& zFq4jSy}|$ZpIDR26-T)R!^oYdJQP7-5CURsxS3m9Tdezv#G0>NTzKBL8x3R}kVuCb z?@gR-RTsGt{LT6mOZFVcRgcD6Z>aMTN#&+V(zOhnNHDCjw6W>=lKuU9^M||D6^CY; zkNLlv7cW^Wp!7fW1}Im*`BRJIz~His9+Rrd{TIbn3+`aqGUkKZ zvOuRL5#7@`xPC03U;D~F3mUk^6kD;`d!I7+|zH&T@NL-D&X-D>b^G1sSV z+Y4K@^0Y8GJUO{lzGok>iB4_ZU61pA)x5-s5@b9#@@ZG$c(nTHd|tk#BUhEI>*k}A zFz&Z`{Ah(hV^wYe2fQ`)51|p}Z&r+4{++mRUkHVE`0FxsJxwTcnuz)*@vwGo`_yCU z(A~6Jf6=AE^ot=8CMwvr+^wG7uW?-}@s&u9TaN14_wQND@d#V^>>F4*%Fg-SmDizV z@eR_A_+&oe3fYRwSNH3X9*k=VQf&DXjd^1sm~KHU{ZWb`PW@lVbj8aa@BQB}Gv?(l zbx@?9-k%>)5+@gx*7Gc;CrXQ-p_5}YL*AJx;5kK>vcl!{@ldtR5N*?8Hx**` zV|ZdB7)&Py()d|6{VqC5G#24E^c=1JI7Iw&I7?6Z#F~9`9A4Pehdq)K?PIw}~kXY`$cxq&YcF$d26JqGsyP>P)F{(MKTc z!tKW4;O-o>S%`{=z_zrqx=)S2a?sadYxlA}r$Sa2-QrE^($VSAPWXlSKt+0V*E)Ad zt}b%C5^C)zq-{=q~J>OjtWOXXJF&<@hEDSJU#hWKo78*@`sT)X#5?7um0{n(+vZ#Zo%E|n$ z%t>+KUv7jCXUJUBznQtDE*^+15?tQrPFNAD^$q-Q?RNmex-Al&{UX1BiE2AmIlwX% zg4l5CBinL2xtyP*B8^OJ5|I=;~6YRc@VR10jA ziZ0gG)onF3ol5)*btj({w!0YZdr-ie+-yB#6U7kxSdGk|R-?j>Vq7zH<}S9ev4QXg zdh!Gx3TuVvdv~8r3a4gr(#ZG|Zu`{Z`!*hF{F<+$x|;cG=6mI%->e5^zOYzKaXy}N z9YxBMCem0=cT`BLpihO-XypyV*y5N)|7e0msUBnmz$;csotK}-vtR!1tJ6%dEoh zFVIVMF#L!>{xpke|Ak0=%!QI*P{&ddx-~Q`r^G8=Xyis9?UYu zW0>e+wy|-n$2)PdpT=R$o@dKDwY~}DuidGCd3(L}ZBceZ1s*Gs%P`2~Ni-={Y<=kF z(buZ2z^Cq4v-Kku+c`d!wWr@=udmKq4o9DHpPKxLJ@&9dyXp8RH|u8IF@Tx!UXBnK zo$aw4*bBjM@JOB_7`I+4fgHtKdm&nMjxrr?Y`}gJpsk|WkI$zrm(mzN+vz_>oD^N+Q5>Cum!04=Z zYLF`7BBIbYEu=Q^o9#lVb}l_JQ8qs1r^t3W@~W}NKKK33Ei-H9!$WVno(HcfxR>w$ z=_C%P!`(Dr8jZ&fv1cA08|x^oq{7Ma{r7IXB{?Mp4BtR_2%0_lyK494GQf^%AYF(6 z1D~1#KXtRUq?gB{WQYfhr4U&b=`cSDZn4hIa;!tr@ zC%q8WZ=I|0#L4`9DNy$2g}`~BPb!Tye5j|Wdq7~!Ysh=A%>>=~rhI$F1CKtT)uMJ< zQ%_F;jh#8@&i%Ehw7|y}YgOO%>Px7;{rASgWL=^-+K%&M17TjjLL0O>aUFaKjB zvC!VTi-`($5*xd_!BX^o@a}qhi&N8L=s6gMM~ez6P=x-Mq4#-n_Fy%hn=vM1a7Y1; z`Q6~V6k39J^8V!UlvopUNo<=RxHlCy>k#LE(&GU9>SaR;i;_!P7}0;&^1;ezKML!Z z=Wc)B2)iB;c1|z=QonxUb;{ZipIct(tIhKBJD{y=bbR~k>$YEP-N+ku=7ZMq^5x(_6%cY-Qr zOwS(4+?&+j=RW>goY?HTBB}qR_ji2pzgg@Av@M}CJl=1L7u2pte8sV|eT@ovihNPD zo*PDM9ciUXdiw+oOXv3LhNSH!>%ph&R(K?v-YN|RwgUIbSw63$-PWR-W-~LQXhuMVL=gpbyy{8?P zLT#IF3>+Ld>rrADXT~nv3eTeUSaxlrHug3YSV<%3cfiSLYe9@QwtwcKH<|sV8Ht3% z3GYA*ou{ksjdDbVa6LthIi=l?m%Mt9$#m?BOrgX7YJHm9wtuFh9RxNmAS+^JzbsLE zS(ARCJjDWc_s&O7{HQmKmtrF}Bx#6wZ1euR`feTUN|ESX#wQ8fyjRwSsxLeqxo?-% z^Johaua9S;6v(9|wIcbYBJ-zbMFWunUYTGo8Q~;9B{y-pc>poCtD^2XR^*E3HSNYH z5BL7mG{{||WdBbKP;K&@iyX{H05pdF z>96a4+ZD!wVrX^Xqd>-hnR~V9@bR1lT*ci$Ea^}3qJJ4(>%;YV;;9RWlBJ)yl2v$} zm*w;dzc85uD3XcsEuMi*ndHZ7Wc63-!tTrThF?D2{MCEHFXlt=2hC-UXBFK@Y|R|{ zYGKce;jaQoiNRgwIVS-CIKw;`x>ty!@3CO!MGwF2SiSspCJMfA08<$b?;U2zG85;J zs>aRE7%6%raFbb)r0%iZv~_9=p2>|dJ;O)G7f#iDgp8ove^SxSmpvk~Wat<`-DH{Q zq0i%y6iUvrbm~SQu;dx{Q|={)k-?CuZTWZa9wQ*OiKPrYS*%nsT1O?$=h~M_mLnja z2CcM{NQSV_wQ$!tstFU?R&34S%bo9_f1i!4j&<=Wj<4S zuSXoNHVuz&MU8vkViaDg>!W1%c+3}}_}bX~X=>mOUR+%4r(L49g-)eHmw@}11xI_7 z#(u<9BoGcPe7~IPYTkhAv{HIyNv=)g|2|D(-Wjq~>)vhoN+VuJyJI&Ue3NlCQvRY_ zc}1C`9Q~J(;N(Cs3cj7{OXsoibe?Yxf-tm9&5SYrxK9uaL93%8Er7YYS3#T;bTpHs12vdRIP>7)p2lvV?36?vDVA{9Uq zT=s{J#tA%RXNGn1B-lvLB;DZm9CORbsWp2hzdHXkP3;#;ln9bbTr zI+zsD6NiIYA+Oyy>*U$j@@(9e4}UqX?Pgk$*CAh`JjW>h{o*?--PuqJ-No|18Z!uU zgrYoYYU3^55_AD=^zbDhLTGAfA!j@f^~`D^&!YP$CX+k7^*Q(HRK$?)dAOd25aW9? zWi3F(s{5+}>wcw~XbXlZUkqt#g_KhSIXF2x8@slv@V6Hagono`gZ5`zdI(s2rHXP$ zJR)fY>mS~K$)VSIu7pR1^5<MCrtIjL(#$8u347{ziV@=bu+! zPj2|>egD9QIsTuSv{mDy2AHGSI%b@}vX;7w4HoLWB&(xpCp>v+`YeG}poj6aPwpx;C5un~dn4#MWjK|%aY>t(jy+_q= zH)f1X{;?_p+FlP24`{lJwYjMbLSF?+*F65DH!F!smnTHQ4bQr8QoU7NhE%F1fAxy^FXRfMgi5ss69fPkFWq^HJ?eElb?WUFL=S$ISToIK~9 zW5dGG%#D7#KSoH0dR44YYNFk1loRKJps+LlY%cJV@*RF>`yWs9FRNeT{wODSx|HWi zQ#)dKPu9uL-pQK}OJlS_bSV()5Lrv`)r{ZZ%W}_jbqJj$y(B1M?>2L|RTLUm>9IyqXb+_#>lIQNnzHBuS(X zYG>dqczv$j_0VXueTkse)qSIK83{5sYJ3|h`UjCuo3!2F-JuYDV?Vw^fUYubs^F@H z!mK3t0+0tIqp0g^FLoS9a1QHP@$Xn^Z4}==kpDsMbn#0_+m#$&Fqs}kZQ@7c_0PV! zQ4~=NEuQO%MpC{N3#)Ft&OId8mw5a5!_1YU6(G!j2UH0^JUAC;9pdOYO|0xeW8~f- z_pI^+`^)(BbW!@eCl5A|C$>*>!I~J>IB1t7CFEIhoFnGyYh+(1!f=mgbjIMQ|F1yzA=NaSM8Tfbh0td~B>)6}S8{ANuY&8X6i()1{wMP0Wu~b2sMuZ33dA=?SGI*umhdsC&vMT1S8^F*jR#I6c6lPrY~?a7u0nJr)pe`U^jeHngg{xw57FPvni7IsGZ)TlSE zx_#Iipcuz7AP zDPfcrC3C8U6qr;K@uxAZFjjEFxlQFUy937HhI`U=p6%PG+FQ@^ccm(_`t}~2Q7owp z^XqyvOu-fw@U&Vv)Lb>jBf7= z9$E?ZS9lG<6cqsgfS>@7E8qZFPiY#}o|kt8evh;X=pBzYodLoZupz+PAvghF2}`5^ zW?^7q3H9)*u_|^MJs#RRY7`8Z{wb2`v*4~oatq@wG3eJYYlDh2^wYKL)=Uqs zZXgCilLKW@#N&Tmb(EuaUx2_TO-xp1peonZxa^ppp9fwa?2n@&4G3^Q&Efc6(q4K= zK(#A(Vx`=WVz~g;6p*qnX{~K+2u%Mbxa_AfMPeX*l&(o0CvVc=Kll0`#8>Ae95w&# ztwnbfr83=XP=q3q$EZP9#q)1YKOe7ms>{J!6HU>FsO>5%W6xy@0#~=ru1a>qMMbGx z8a^i2MXom~w}kxkDIjq}*TK#GmJ9WgQh_$KB$ngZDbwjmKUN{#LR=>*uy^rx<-@5R zPmf|qSlBPR90k=DFk$7L#d2nD`qf2N1b@HmcJNN{ejLv5`&}OTWoX71&j9HyI{9mr zwZ*d)pV&E5t_Kf$Rt}5h-HWHl33{!&9O@BIiBD_$TCK{CAx6e5YW+=zdTbCe3FBRJf3|0wkzVUZsc+|m1AcZ5hDza z1it?Hn5E>)tK+pn_l=y;;kmh}{qI-!I)!Rx-g8A+J`q5lVYHbN*3ZA80st%Xpn4f; zo58IcL#<^Yt4d-AZeR#04*{Ko+Ua%zV)$tUWbKJq8}P=A*s|IXf`k;T4nVVlFcE>p zVnl5rUe%%4jd3Wv-`}egunjV8SQ2>fxP6<~WlKxSfeZl3KTU1zgh_2~8rLqCc7bFi zCTF^IBRc-ngl!8QIfg7cEqw;gbpT00IigfB`kAA5*tz(au=75zngR)UgM)sx*gl5v z)5eYby1KBk9ACfY2l4vB z?7}~?vS*dnc&Tu=z@+H>tmPIjSjN9Zr)atP?6+zt0rNJ7b9ahmVwa|Ug?5*#6_+1V z-k9ANhy+AG>4RDm!I7?ZNJ7*+hvCkIPYaz9R|-STF!@TGeva!M0>p~t;JOn40XoC;niWBL~ zOl7WtPnHkAim}G0RK53BZpi2zoZEoDt)ru_mYWVdyEadoK$d3;RF@fqgaRwO}p#^@?8ze zdO%o=-b`CLXZ*(r4T#5ZkJs7!+v2h^Sx|c+nYIO>op0pDjyh1QJ9T3WmKI>-zy3DPS=`*qrrhbyT znu-m72EKPhQ)g1CML^$2%b%9rhEdb4@6}_dAM>qtthw@pE9LJ1eF}1vlEW;yFeTYO ziNH2`*be~`G8jXIFrELlUqQ~?x(Liqf!%`)(WoH9L=xErQYDBEY;-8*0l$8|5V!{s zsI!Rx6&4r#!L1%RiIOf5qDmVDq zn!_m+-ftQ|kM0H<5~V;}`KCoCM+(Ncx?_CdPFOmLpsFz#JsH{v`rlEw)y?amv|_94cf^yq=e@brsIO3d8Q`%wLhN=vZ;8`q69{|j4NsNnf^vHv-A zFF#HVkK^uT#XW3PbBnuIuB#NX?IuFgzQprr%39zan^m@Zpn45GnH_WD3%^z=u_?u0 z3HF_I%tYZOrLrL_vN?pXcCPrhX(PWK^9BP3akyoxClE(@*fhgwl>>NMO%9KPoag4} z@ql0|&`zs9^RqvPj9BtU1%yV-YN<$wp7(z4l|Qp6JNU^08SZF0R;d1Ur{)JjbBU*% zzX%Hn=&q%C0f;Ga5gM+1^)Tf}=*fq01pQr|N`(B^GCmAR)EQl?Yy!+XSh=~O3dDfQ z8!kSGU#S%3fw%R@rmGBla&C2Xd~z$l{z9}wtTH!0k*r;vY5)2$fEp#=In8Fe8Iw~~ zcsvtHSe{T5=J)=T)T=VHXzs49ibKiS6iryU=S=I z;11k)(1p0Vx#6kEsh}zOj<33OJtFHs^_J}nX_I4DO7B>8(JHVBmrEES>omRT)2GUH zSFpPFkwkdojE-tkOL$R$b8rXE+d2Q|-`-@9Eu-obJ&}h|UqpQlIRWegmgnCt4E{PC za({2nN~)6TC)-V$Fp&s*ifmuLl(n$181Eq@jyA3=`Y0WiT?rD|fqIBjzVXcfV{aeUY}7lIJNRH5)mv;cb{_b7l%u(kr4@}x$B z*VYLo`LY3c&FkING~wNK7By;p)%*>fe=od}4m`ju1#ku6kr+L+|J6idWM3sMO6y8WHt3 z%-^S;8r~Q{A0fv9oK$>vcbaFoGM+7`SAjXwEejNE;Qa~4Aorm;B^FV71oynoaUtf> z%Sn1}ZUWU5uCATwTE?HRSapykb#O7%1er*9lwa6FR0xz5?&l3ZN1pB)dzBw1i;@U) zy^dn^H@F`359~#?Wf(tHz`oOar9WNCWXX+F`YZu24vQ3S8<^XOyo)6`FnDJ+OrE{A z&k}0j;s_ZZAJDjSs^g7w5}hCpIE=@;)u=esjCj?G7S?nmlA<3m1`mtP7Bf{oGfg?WxM1@e-YC z%f5stk>ihRz>$u`70VF!F~vI5{Npgg zL@~@%N6A?ltE5YRcENJrqA@LPH>Py8iS1geg%dmw%H?_VL9YYB4#Kx`q%xCd%t-4_H$<6$bvArXSnyU`O~@5759Q& zpOJ0!SjY4NtI+=`NST?+?rxVQpV`gj>G@(H!NIo4?Y)-UoBbgQ&k9r?YM#9NBYu=X z^Nx=PAxgxYmEj3RSY-zM2q3`Hj|1~{3S%4$)|`Y{(P-;%10F{zlW~|o=v3GXv+2>W zyi_7cP4ebvd#YHY4BJn%JJ1EhLyp7}WAO-v_fO@<6O?k~@(wwW`UQAJpUjj~jQ%n0uBw$I3O-ikU%MgSWx-(d(Qj!=&~XniE6hR zmom7xr0V3@!H|5QErT9HcT+sko57<`hm{n+U%)ECbwj+qO$>2CTJ3#Uzw7eP?PBB*?Pj!k03_Ffp} zeZm&bV(191h+`$YG#GVl)h3m4|E zynZW^;SOSxDzgssfe(*x5OJDSeAA362=UF^OyiCMqR2u00D}-HU}X$x8qA1+u7Qvf zI^cr#D=m8rEGhWwEX#$Ezl@sxJwV3aiwGFYI{Is%br;rVxZdxTwP(H$L zRvdhTKak1LV61)55~ncyFX`s;g4`c^8h+0aDKV*N1xBERAfDc(*bpfm`1iJSC>GNP z^0i7d%hP>X205noJHTQf0H0YKz$L2Q>>7H3w;&8bB7;k?+|$n?@uVRr)&dZ5W2qnC zf#?FI9v~5rmmzl}^-}mN=8a@S8(g!MyMNuWgruuMEpTEOOT8j0n}s>Rh0iEMFrT!-{%QWsgH;YtHL0+i?;!qf_?syLJ727w5X z{Yb7nY-Kd-UVnP4%8Lk4#$U3Wgw?9W2CexK#FU8%fxi?__8-U=rBZZV6j7}mCsFw} zjswKD46a^{g`As%){QKRL(Irh4Ds}$qM`v&a&)m~4)?TqX=V4&Ak08j2iXj|xzCv5 zJSce0MM}LK5JnK_S#hzHgM)*iXNMZ}7_c2#G3hzUd=>7Rb3d+tnqcwNHtf_;(9qD( zj+)h_&-}-f-ioO6Cm?~=VF$}V&5HqMW%9tsavId2ww!ly^BJo1QsBDpRQJSzY3;(z z-dp9e%#3bCXyQqAMZ1WCC7trbJzuq0ZYsuFz`Hzz+|b-W6wXT zs!D2>Ob^CzHRwnCIWm7+GOX|(#>5QsH-H)d0%p`p`%z^v=u47@QEJz_NgcxkBhzqG zzsKgEq*p|f@DC3Q;rX;=&F~~8C23NHxc*=v&M%duR3%cboU%CGnt-n$1117sU|9`| zh!D-(3$0s9TzK7E&lY@Ri!wd1L10hkb8cqj^Inn>7hqjeoKy%+#5a%|0FWjv8`ZVT4=G%tp)Uq-6cD1Mds>ACA%JhfS|EsM&hhTQta|>wAGB$&q3&KMQAt4YD6l}My z&B+6dzLxU8dI$9j-WC5o%l0u1$>`s|jS;)6#+l8aw51Som}A5G!`A848iiIlMKwb8 zd3JZ)sYQwDUQ(-U)_mmqL7pCkR2&klQIQNTwj(umsgzPiHIqhN8gc#t?sm17-nP## zF=TV6E!m}&bOE^p;R+OaKz~C;j%YNeDrt6%U};SF`!DfF^x~;^{Gdt!2J+EjR-XiK z+{b$wV$10EjC>;%(Grqu05Ly(nq1ck@Wo+2N2Tf2-`%g9h3QT`G;cqWNr!Fp`&_K1 zxWmuk50ihy^>Z#bem)iv2!9*JSlTYodmLPDSLS{FdOn`%K@pqwSgneW> z%sM?}YJK!xz)o3}kpLVQ4C_3F^1P)RWtCw#{=w4}%+#4L1NI>g`K|b#_s#t&F>kzc zW65k@#0(ChD)xcVJyn}i%!z}9uM9Gtyj4*W>+DvkoC1tjbM<+RaaHy6u}3HSt|9=8 zj^=iE2uif;dNHg%=ljn{TRWh%wDhz6BJ^-EwBivkutWq4puWP^x+(w=qUt4=+e)97 zA!b()WBl;Kja$!xLL2P3dlqj0z4iKcu`W6FZw>L7fC>Hh@ni8%`Vw@r(alp2Kqn%a zWWQH2rShpZm5jR<3`L{gL55`T`EgR5Gm5p8l|^F$o+>jxg|!I}rN6&>kA?XuNqChn z-%L%(9q~kq+PfBGRS%l$G+E`MpW+7Zswh1Lg8?L%XasdYLR8`p7+Z`^) z`)FE4mX)*}=6i!vj6JZRqtkD6W&0_4dmZIShJn(@1;IFgCCiH#fgT-a-HI(b^IH$J zuBMp8AgsN{&%Rbx5`YJ3(Y2Ar>#Ee_HN1#eUZhytdp1Q|c7iT@M5FWhJK%}FnWZPTZmAVzzNG*i(2;l0Fdn_r%uPkaw zpKBx_hoyVKc&%s*Z_ByA$q|GGf{wqVri?xD0IF@z^|i=+vhMcZ2M`6E~1jH0_!bZJv~HwDX*@se#ym&NAZ(qB z_TLqvxAgQBotd3oauq?aH8V4YTSXNW_^>zwWR_U-!=T&*RRQ~Yen4vnZsDJv{j*wh zog7W2QyXMWrb4xS(?qjI;0Xq*i7pw$^e-Z4%WG?Dz|0bXSstDRJXwxcVgfT++PLr{ zPqC0E*&x)1AoPNU#QeR~X0uQ3rkdq;n3;Pa>XOcMR=#7*Mw&ZpO-CTDH&QsIk{P$eXBa{=FGl*Y)a;L0>o9TXYI>l?&j%vT~od!l8p<`q^eLL#W0H++(|G_QS ztK3A%SRhJ*`G}og)hLnV+zN21?Ck7(F44-SUzyS|F_DYGBpr^AF3;}HPSEVG0>Bn9 zG{SJl4gk5+)jEAnVDLfmLCJD39LRP^egaUuS@7`QSbTN0|8zPN1A(kJ_b)-bpwI1O zmXIeA%ia0X=mB}wWaZ7x9p3F1r2dkbAcUBzRnO+3wwP%nds+iL6-m z8@}XEN?1t-mrPV`Ip}F>o8Ru-7)+{iHwSrN{RMFk5u-wsAFRKIFK<2gA^0wbUjFLW z!27h_Wgt=lDkT)rLxNU+E#0v@-SIo+p$H@ZTYLM?vdZrfKe)cxw>kstx!15x3(k>< zE-goM<1>foZ5Ze)+2cm-prn|YnJG5)fc+Fu{~_I&wBKH2-L^rJ)_V3VbZg5F3dg7& zkQc#b$bg;|c}qo=sF&P%2UaMs2kGVwgTEmmTKzHtgSy(46!_CqFr;x zy%6hj$K~%Oq?85BhRAmG5i#lZ$4xsim4bw$mZ;N@ZMp%!E<38pR^Y0kMFzVEV)tdBATBtq~Ok>^1XSeo?uv+MPUyWD5>CUb! z7W8q&RRl^(5dW&aW37qq$xqzGrhjE8rnbf>o=W`ize_h_aw=d3CNKJct^%hUi@^_% zpv!0*El}mP`T22-FHa@pP$kR&QB#$b1!|Xc0rN&ehErU za8Sq5Bh<$wX;yfpZc}4m_X2&?)0OUM z{T3f_W{u1!uwXESNzkHvNlF}9vnCiXBOi%>BTVgn*hO9q4-`stv4d8WuRyRc7#Ee5 z;RyY9XRP?PC&Fpmbng0-3k1OLJQyi(m!VWb31HLus>Pm6bfXQ{#uhy>O8^}g*mv@Y zm&w;CkH&JavSu^QY_uh%B^Szkh{gv&<-6E5Q2FI(;ujfnz^wK(+ zv1vxE;mT0C3e7pZ)kbC~+LZIqET9W4>CV$-*XS$sKVbo51cWf?ge5JXPw>^VH8+KA zg0sJW5#n1!V0D^!`fLflt_;vw%-lk3(NkYuPAwyxj3VxG@OWRIAV*ChmdQfdByVBC zc={0tw-qqbL(EnJa(8g_gL?(0fE0zPyF=-G!d7}>Edb^MI0DKZ5CC+6e{=Y(!#6xc zD+NxhcdIl27aGW7gv<{F1|aFMfJ36`YVX^xW=|o+SSz#@FzXfFF|69W$r(ue>bXp2 z_(VEWxrX(SfFV!xGwawSD2E;)AYB)m!U>xV6{ww&fVF|PHc(}^Afig9b-)g+Y4fm; z3GR*ru(8dPsE-5w&|fYxmZi#mnHbo|;?Zo3u#y8LRuKXRFujO6c<#;YE6VK&{&=kJ z?SD5{fd3E!-q&<}^y3_OppaOJOH8;6G>a`SYp0!dzf3KE+y4&h_B!AILpL^a@*S(B z&8hXeVdeaAtqSVo2t~4!IcFXaY;V-`$R6f z$L@;^L%gQ_l>|gvCH>}q;4RG;1MZ8N&U{!p(TXLya9MJA zKK3iTCr36lmSt*N-_Qf4uc3bG{K4H41+dYa=YDf4uZ2SA7L9X{(ea__An7 z0zyJ7ut~RL%EUJsYAA&JG|(Vqew`GR{~ww53o4Gg)QIgmocexNKi)4za8!i7yFs{x zwER2e<}~>(hO*xq2XI;FNGxFLV8;&>eW{6x4`k>9CG%>19;<%RIj`eE3ULnsxUMJR z`vnSl$SFSxK3nA_ze_uMeIf;B)gGlvVgsgN*JlPZeXb%1ni5t?L4iilt2Ra>3<(76 zUm;*qABCwwgLfh!%v=8C>^dJ3BJ8^kgiY2s{5C&36CS9-zVVdz7I=4q4ljXZkt)$O zhh_!A>;irrigibr(nGPtJ^|L1)9M~D&w4d`uv@>Nowg0zu_NKmQHx~k zxenbUX{!?W&2!nd)Wezvy#4OIz z&46U-Rtcu5v5^M|K~D__t_u7OjNZ<>okPF@Vm#!!u>?Ki&;wRxM^Opks}vAJ=eXZ; zD*<8T5H{A`2S}Pg;+%eMAT99rdR;PA+*1%29p&%tY$$9_h2d+MlSf4)YLI_A4T+y+ z*Vm_*H@$InU0jajMi(FPIGuRL`*zO=G@l=T%Am5r;igtVg*AAgC>Z!ve@#-i6agyx zRrl(@pi3g}?@1*-q&RZ8GLW1E^&k~v`Cgc#=@6TOe(A0nDB)K-rRnyB(g#UJ8!9UH zl9K)(ZEqP?RoktBF1nGB?o^Nl0g)CFl@gGSMM$TDAl)GXBGL^4BGMrtT?QyArKAW* zhjg4V-@W(wasHq0(%0`oWUV#lGe_Jp#!WytZgWEh#QMeodIad^p)IH1G8UO%c-(L` zbJ&)HqcWIBJEjP(=fWl)&lm_Kpt6C`KQcP{;JjvUo0k1zdE1L!oD_hSA4gz>sHv$z zLuy9IgpH58>b}tb(ruDly1no(m zf&y72#cvILw8TYt|| zi$4I?6l8G&latTy3p8K@yYb+D$&;mT-H1gPj>|0wT!8o0?+x7_-XqQMr{z8)=2#eS z^tdJqtD=8CTgrrjKNMW=5MsWJ#NlGGZ3FQS^3pdEe^c9E-<7wptRD*DF;9K!>B#}Z zoA`#c;|B*uz4CZCh07CP`%bLAr${X>=mgZVK&!xHhHCi|cfi@I+4laF%L3&4PL}g6 zymxC8u!Au+mK2_%ObVaMToF@<0Tyr=NF{!{VnJ?(>82>u;oh)DrQ?JMlKxX}dJ1@a zgsmd;sWw^du!JH4LS)xyw7XR1g&HRdcep`S=ixIpkPsJWk!Z@XOVzsn1CNZ<3(zP0 z@d|?>_aG1cY<2IXk9~!sDkd5<_g{pJU?C?EzV-EzPLHPbm&SpdFz|V(tIOSg{wTee z%j#O;Te63l|%||QDIZS#gX`pfCtq!-*E@BnWh}Y;km;O zQ9v?#`NthXV6R*O5L(a(IM(jkZaLdGl0II}uU||ua_uCM$k?DSPwjxuOC`{>CIadg z@OZ%u7#SN|$nx1xu(Vuo9gyy3eKZ7my^mWRM2BnD-$B?(8l{98(*9EGU%uD(2$dy_ zkV^-mnG(xExXYUom8l`Ul&W{z>I_SD8g_N`RR>QJp!ESgD-bYPZzxxkmsJ2@#qGqJpIN-qpbKtTqHcgK7VlHRR63xYg3!pMT%#!)5b+!E}=v!nSx8 zSVq5G59`|<9F3dyJ20uKt!=lcRC>!Y3U2|hsP}*GYzJm_!@7>{{&TMCWX0T<9>$>p zR`SYM$900173UxV16&3GJLF>$5|Sb-?cOyF^;8iq>#h8${`h$E#y)1F@2@{*ftEOl z-w5F`fTg3?kok8Rv=**k#H+u{T}Zba&J(TuY6ANXF@v}x5}NR&1?YNKA(jFvQDNCj ziZs%>rY$3EPmb=MiiW{ucKIOKQJ0G6e}rB&0frJ0Qo%x6lSBfDGy_DEW(M?U8jQ zU<5VwS-&m~!wdAAy{`ipuI=47_x`#Y00kIXzE)W-KwASMY}_?7J`#r#s5}}P5U`S@ z^#6Gs-P(&;El0P>cm>b|a15*}swYoyq~qleMnXfu05v9DLO=_F7GVQS;OV{fTG``e z4&+RG%|~6?g7rkR@cTbt1ds#_Kh-lT~d zz;$SX$(O)?8HTiPP!jeauu258H$D{ZfGNpx8FtCh5GPwvDrsv|3N-wtaGd^_N>7R# z=+biZUv;_BxGG@mH5bNn;|H`78gvDIv~n<8As^67Cnu*7TUE#v1^zIz2@kq4z+@+? zZ59wgA|z7SBO%(NG90A_hX$ZrsOzxy?6tYhnUPTgV55QK0&_b`kIPU4zkbCa3xCW4 z&aNYouHng22cXHvpFwmk1eWiir>C~iP^3t>FqeJYxhD+`Eb5r97}+EPMasbRbSwm^ zTu_iekw}xMh8ZGidhxG3zz-u8!;$?Pr8~_ur23IS|0!AbDaKuRm<1u@omNK5G z_wAlS_}l`2sO zjb&G&^@s#yFhOwP-P?>8gw$Dl_a|%+EEsXKL%wJO2BNu{36>dxJpc7Exr}Ix-q}@C zvP-Io_Y#G^x(i*QYUHQm3F;v%>^u7G{`Ws53FMVXfeOnL+(2Wu0Ep1H`b2#`h&e!eA&{Iji?@}rNYa7mC|WJpd!9;_MP zU6R1_>2+wMA`rd@K-EqI%X!)jbM6p08}x8fUvqs!{uX}IK!~ZIe}1jv*{(Hj&gj^f z_Mehl2tvOFPu+i+)$DwSCbZN1IflfGVWI?XwGJ?=>D&CvD`tt`u@ZwIx?UE^icL<3 z@R#~A5wD9uumkiSZibvp3Vlq^Tjp#y#?YQYEBUy=ci{ZDCg^S}{7#-C=ona>kP8WU z;EADqit}U*k0NK_o*PK~pp9;aGUVx+zV!LwLjBqP6x1JY=~O^q0M=)O_dL8<%Y0`1 zdi1!Y6=)(INg+e>`t6B|CZGkDtcp~ktv#Ku;k;~ ze|-!+^yV%C1-*=q55gg$#-}TX1$)q^h7Xk8E9gL4(rab)n7O&R>n%MF73kmzY><~C z;wJy|BO3(ZMmkr(ERmWMkSBTG#Q$WyAi2T-5f>ndgunsqmh=Oj>B<-Z?WEG3I}1qh z*66W{k|*nz?-m1Lx(S#-kl80399TR&Jbb2qxqNN@Jpc2Kg(vY|hNK&2kw$h8;5W!V ziwwB{X1MNPIruEHSi+K+lmze@J{O+RyQ?3sSiI9J1_&GyA*xu15Z(Z^A~2=rCf6c} zIa>XVKuQUSNH=myK)m?z=ui6c)CZS=fbwaprgOj$V8ue|);UxjlD>yRFrb#Zt1gb| zW;j@R5G)&oZGHle8}d;h1R=#s4@9O|1aSNOii?!49AX1d#NF`7hCTH^oWskI@*o6K zk}YuGY~i}TP`hLB&dy^5wTX<1QczVThW0nK;C}LaZUl1&P%gm_OLWa4Wl4Jcy$pCb z!X_oxGB>mF@)A~C_frr?Mk}#Hn4^Pi88T|$4Rec$Vi!)!st`OL0vX4R8+3AKdz8>u zXFdBvXY4WhP*p4>5JtTi3m`5Im|C<{0fMr;ni`#}k6U3|gd@PxS2VIpWPR1okw4J-MCmp6$=DULxY~&8U4CG%G)wV)(W7v~Qgyfbmdybm*K?8WO>aKAn^gPpa0-E=wehZ zcZF74M;KA1!gwL@ZmaXXrt?fUgmw)77b6=YBr z&PuB5FLwLK78?s(io6*cr;!A{4JoO~qC-x>!WhbzaP?8?Db!R{P!JKpeQt+QH_zb! z{e)%}>T>6jB#WsQzne%`zLXun3^ig8bQ`&Yw#L>?J4kcp1zkK6^Z=EYkG!RxE>05Y zbo>DBPs_!*Pf-vh3OMpvpyNOXbX#3rJ>mNzR3*p~GmF`_Ah5#of{mLfN~t63(G2>o zTo$4QOuQEcbVd#|u}x3cJKBP-;P}oH z;j8Q*XKROii2ZfM~VWk_I<7H(~0Bpl~xKZwL)YGxhpjfvXGb)9fVezz?eg=T=Q+X06N+Nfn8QOli$vM?F8Y zRwAhvERB|(ul&<2A*ccSrQGU&hQLY4iN4Ci69i%)sIQGsvp2=!1{gq310vu3%^5*_Yhz=^Ki@K= zkw^ew)h#epW3fNJqMkwar%iZpFY}Mo-Pi@-q_9gKLs`}#+j0y85aTr~=3pzWJiv>9 zdsaB=F0da!*>?+?>!IOcBVQ9u=x^XzLcs3GxHx1~m9Y1o?c9NdNGb^42HBl_kVFL) zus#S#H#04c^P(27Fz zw7?TVcBqF)39Br@fV1TJk-{}L!5PAchV(Wzv-dI^>@lPQWC#enLwFwldoJM-_mAR2 z!NNo6#Sih2i`LbpWG-uGXh;tke;Wj5^YBIwjD8~WR3z6sjFojm5KgtNqwxKg-`A%K zVM%Ju!T4+$zWN_d3}F_=5OVPF5WxQw|8bbAHo31*yll+}9u_ImVX>_7{|-EX3!7QS zL_rY@FWNe_OJ!DN@@$jo!oceQl1_IZ29_&44Eb-~U<09$BK@pNGbboOSv^}e20U5j zM|?>ulgALbSw%!BOd8$E-<{gn*lw`&_p1fmEz)J{}1Uf zP#mfoY`_wz=HDP06PQg1M&UrSQ<|HbFHcloA!U;K?Z$M^hZ$5W$PuLERwZL@e75@s zS;Puh>NVN(LreGzWqrJgva)aHVrxW5^9b!!AR;3~{(mGsR4x{I&r%2Lj|U;XL_m50 z@GnQN+!R9YRX)DUg*}H_XP>B`wLwIpu}n7+IB0FUnZeD?P2qTCdf|TEHS~$UpmBX5 zvg;6F9mE%h1Sbf@OvrL5|KpV_KLalQ13uyFOoZ7iu>TrH;=!1y=dS$9s~r|8BoLB7 z%ES;ScP`2N>^Hf&53~tLWA^j$SAK*>23;8^MU+_yBetk|BXs)kCSjKC9H`KHp;KbQ zc7XHl^(WOv$aPj;Nl6KPu<`2uj#IfHk zmLkLtG3@>QWlg>2aNfLmlLMFp6fgRf7C1% zdAp$$zI^~L8IPb~9E3_LLIQ$ZxJzk~0)FD`d2nKnePz|WB9KfLiv;2?k z8i92xhUEJ?D@z>|#Q2}8e_ui(zFLY5EBa( zLU0Fvlp2Md;f4e$Dk?4qT%53wn|QYrs-`MJKUN6wgq{5ufUaV*R)46`mg-8?(#0P@ z$c|i)M6N(_W8>sZ+}ADUoy40#Hsx*=udPE4DKo^34YuP z4zaBZeLGH6DFZBZ4Uk62MLGkbu*Pjcxe*@fPiUdTUw`s$N83VT5d(zXd$aiaKmbk`!Maz3O2oK85>(5NVol3$a^%{93j-l~j+HXFbj~*$~V2N;A z`j*L2sjmu0lf2FkLbW^S?X?sX6six7;K>_=`dI;L0hj879(+kvA(?hZ@nMK-@JPRK zZd~DRT(6sY3+nYfK*10F)}g#;glX?< zm0{@{9bP+N(UEI*yxq%UV%ll?(YbyO7r7k8P~QdHJZHfcFl)(xG!|+J)2_~zhT`Ku?8;9|ggO}6+obqd36#te&y7>4!?&KH#Wt-dGnBmlbvO2+073=CMC zd_sD5H~@oCzMt7AM5>hP4kKp>lrTz4Z-!TFAvn7K@)$$z4I5*x6eI3;h^JSDh2vo& zN|+N;=l5scOqM-a6Fmm{RT=2T9B2(RKREwd21M=gGbT8~*43#Ha8y5k{@mrpcn0~9 z74SkvQHXPfNbAv3SQx(1df}fY>nBBC+5YnpDP`Z+prjWG;!lsx;pXkZ+)BxA(kRDm zFgWVtdBzKhQC)HB1BkL1V*cy&^i{odX%G%MH!M;k1wfb+b#xeH40$B~mm1dcvaX92 z)-JdZ&om(MX0pbv;{>QBZ&*RITsP&M4>Vo^>>d^LdL(Vh^bdF%{s zAkX#diIBkWE7cvILKs>Brj;yq0+?_TMoCTArK+Hxk4XOaEjKI?3fKhd*8EN<` zK{OW+7aM@33t3exweGv?53XKzzR7520KgFmok%Fa(-r+_p@FpP4z@eLKVwA2??8w0 zKt;#mNBbh8?1H=Q?e2K*9^v|U*O7$HYV zJ_yhZh?mszO3E6aKi&AbvU9w@F$oYk7!D_%=j(30(O?=+Q$#Td^Cchh6hZ_z+5XpvaM%b zTXXTA=!AEk&-LFshnP^{w$KwlXuH=G^CL2Wf*c9dxTK6Kpp%tD!XK2sE6}g&fPErg zIVKNMj}$CE0;i)lkVUpzv+WpnKhM-TF_=L6xCh~R7!rpaQ0x2xX@Gm=YCobb6>YI< zYJpv`MjByE?lL@dR<(x6 z0#Y)0HYq7VYxf4pdXU*xpfbnU;h1T$dC0vuWik{ERz6^uKAsNH5=eYMQ*{j?~SDfESUIgNJGmKKcs4 zrS6iZxtaseLuS^API3uck5BAz=tTep$j*U-wq4NuNAK;qx0bJzh0a179tBM<;$}p+ zAH-_1wdD#(bl;{phSA(gx^p7|FcSQbLbzX#mJ}Da=O~0A6f%B^EH=_lvvG1_!xUU# z|2)U_F+j?BMPQdVY%5*r|rUf?3hSy(ooq=TXvK6#Ja#gPW0DEMF13|xJ1`2%iz zt!8HME8#aVC_r-wSPKsN+Wa}l9LzVTnKC9BpafP?Q|mTzX%2(WkjwWAqAXI+{{;L38Etwke7eQFV4F6G?Z4v#=QGO~S=gevC!O9xBjZ`O4OYUFnR zC-V4~p`fCIj}YImpL!nZyLKoRc^Qoi4G96jf(7cHO)#8I8Ja^daRBPX@xBjXqUNC8 z#6mMzJy&9f8z3R+xxok>X&fZYlV9Q}VrFStc;NsfeVZF8Dq=GGtO;kx_)x>A!?44v zD7~r;v$KFKiteVUSgjND@bEwk`fv$Doo;$=AXt#QyO@@i7SaWq&w#U@jDdmZe+=}h z07k$^>2&(=D;y#CpbE-zT^rRiTX)@n+Rt^$>BAg?ib3fCiVOX&o}Lc-+NWOET5rv( z-<^nVPV>ef!%88@VQ#yGdWw3B`;scqK?9?Lp-m3M5wn6>-n+9!5_KQL_tLCbAPLGI zgP3q&sgYEkAkekRX%N+dxkVSKPBQhI)b{C2O>Kal>CX#4)H$XQRvSI470V0Nb`!M~HGkrHpQEmZQQcANZptaRQrB>X?UD#?Xpn52ylfpp@IV=ULft0wbc9 zUzU@&F&^9qEXN?OnNe3-zUDFnAmL&6rm36hwX7hR$XD8<4%8Vh-TmtJa}=e8^2M5(abb0w|IC5wnzT^A%sn}& zq!fZdjLN~NNLi5l;rUcP?f$X3kReX&f@0*Sk*$j;R3XLyhF4G|A-pnP&dbOb7`6`L zfo74*e7$aLsPjv0Bo!o>(?#JCp$qk`Sj!qpyT8o(7sT~2>Tv?8>qsxi*}p7F##TFQ zQlZW;I6Js8pF}RZq9!*;awHsoJmL#nGN&9MPKD8Cn=8IW`WYftdEEkE8Qcfb;9OOdGR$#d0v>HO$W7DVSqD+ zS>Mn;zgH9!hx&<&zUFA*8@^DlkJ3Ob6QJeDn}=N2?pHKeERn^VVQ9xLFk|Pi1c}TA1ALhpVFt>MQDM)N*B=kR-ZBKvjq?`Ff1fE+H!2 zyt>|bYix2}(wQ(2r=q*y7)uDlD=Jc50)NzZoUh-sqQSlhgO=&)fncwju+kgnLpi~; zXpG-DjSGJy1?c3XnpPh(CgaY|RFL5Nhpks%;>sJ6pT1LJ>)K5pwT$jO;T->2b-|u@ zA@108sg8D;f?cW)J7JI!c?UAScY54@a-d8xgi<17@n#$EqLkbJcsJwJebdI9?ZzD> z#v;Q&O9e`yP9m4zu&fi5nKe04u!~5XUNE3C875EU#wlJT9ZzPNFl2ZB3C=J)z`9AlfiN;*~&WEFAkeuU`{8AxV%rxkbdO_D3MBzk2r(jA^^vf^?kGcfi( zYEPQTAT$bJA45&EvddHp&}Fs3=d!M#`G7L}aNDxL*|;_4wzi^@b?m}9!K_(D)MECz zUsa)HK};-Bh*RUYv2&~QIvmN^`#3o+B^%bttL@kc?efvR_e>i6Yh9`Puc4z8P01r2 z^_%w7UnDkGxziDci^5fVfosUCJL&4=SvE6Dl6NC8GWH4MSYqTU@6y7p_hK25%m+nk zxcMBccIRZc`IZB$N#qr3&Mf4gB$>%my%f0fm`HAu7h-x<eMXDr6<8FIjFIk(rRH?qqk9pHy0+Pce6_1; zZgK=|g4w2mvO|>-YxWI2yxU&D*jq5!&D&3+*i2t%#m${W93CM=l+bRAV`!eH+Gbfm ztb8YgfIDRHUd@nLDg(;6*QOu(&hO^IpV2k93`KOmpxt%!llVdgNh`C>qV87?1*#>O z3rVr_twglj7S;R)M_WEehjA6L^35WyqR&FKOa$C1#JC~tXfM>0&+wygL*_8xIw4=$ zLjAvgMX8E>i;#36yf*wv%M5o5`IGn(8eSRx4962{w}L-$JF!yG|3Ckjz&EL9mtQv_ zFN?dd6ZE7u-r)Z}!vA0IbHJG205{)6Q3;SusCmGpF)K;R9`AJe$xYy^iU{osQc`#z zBHB$k`KgIu0tH+?*4NVP@t@|nU^kX^~Mx~*Hg?4> zOxOtl%#kWy6VV(OSy8+pgJo_3zlW3ZUJ`SU% zno}K~9cbeXI2N!dF!~LMcPlzD*|3wV+r+6KnqGePL2#DuT^U8<;S+{loz%A?wA1hi zyG;xZv40+BR_b85pZMWRI>p0M-RO!6ArP-|zav)WfU_k)w064+_J#rSixMzUCZ5?= z*7=@!Gvf8@%W?b<_3qwN)uCIbg14$0l6~HOWn(MzDIo9K8L@*^J9|Yqhl6WZ} zD*J>IaC5wccLoS~okSg{;L^B-Phs(pb?woo z#vadoshG`fs&d!04681dTW>4rfW{eyc;Y;`o~qh!_zwAYEacmRi{RVYpe@K-o}Mos z7a5orwk#Rt#m~J-Z}g5k;q#)~h7w$;36~)9tMI`v!~LvRfifA$zjG;Dir-Y|mZIXv z7FZ0$>Hdj$b9<~~uO{Ztxok^)!20c4*jops+cNYn@KM^})^8E{#McON0{s~befP1u zn(1D!p8$vC#+p2dZ5qYH{6YL?Q^A_f2<()CFI#xl8K|SX7e{FI4msX|mqOw3 zV-cW50`KS9n-#u{vOftT;O^uKBD-sLQ#oGccXilG+&FG2yHR@>8r{{^b+|{io0L_Q@9Pu1^6C*&0!O>bF+n&QW|hO7 zC2A)u6dZ6)3L}ZX(FK1=x!)yUQ5Cu=xxsfgQymZVfq)Wcmwk;kb-*u_Si&93vlrAh zluEn*gXJStfZ6TqAh8X>C3!3v7iGU?9z22JruXVw%Vew)yW88Y1^&{+`r$NTRZ}6O zS7>87+Du0u*OR)-WlE#duW&wA>-;L!>Qox_f%cUw?Ool%J4-vYcH+8m+)%mOj@}0Xq1Vgk)wir4bwYklQw;6DTO;J7jD`66 z_T_z|5^z^t)>mz|Z|fjrv#j4SzCo+Bn!&r%W)JKKkAf$@%`U`4HwA*XP}m+V|QnVCM&vRy!HwqKQ;T^q@Im&`5}EBQ0pq*x|K<-h=O;%ZU%kZ z+}xbgkK4`~Qy198|Ah$<7w>sD3*C8NUq5cnxlF>;&gCGI3iG@EXK0XAtE^xfpQ;8y zPaC^_YJEGIYQpCci{J@by+=ex?c!z??W56hy%v@D50e1k2gX{+<{M)MU@BJ+W`=}_ zs!2L*>UK7CJx8CO=GK~2@h9$eM!!+ah3-`eT8#gKBo@2{xSf)*Av(ObZEdf@I|f-& z=*9g4t+?mmqK3)nNQ3)^{xMVA1!Yx&hsP&QU(QN&c&GZ0>r{oN@Y~DkI4Gh{|DGBR zcR2c%!Go+cgcf3DW5Y;IO~t=-DPqvp{oXMfyZP(BRxx@KFnYu5MdDjjj^9;%rdO}S z`)FfAw`XkB`J+>QX_M8u9Z$)}x;kngdI%0ZjIg*kn@+5MkV{Y z_EuJJzAo@nMgY&vI!_oCgJ4-CRrT-#|2NS+EB?MZMInCGlOTipb(G7GgYOj# zmCLR@4k56MC#oc!n@+5ZTy)i35KhZ{oX$ z$~Dv0pPz#~GAxXZkFRghpFQ}q6@^kQyfcW6AU}XXku>jhrWKvm_L~{+>^n7JYFJLD zhfPoj7yu^@y)Euu8lpU8op-8bI%hPyDH9-Sa#pE%W;d01{|A5(u+IsG>w@&Vva%Au zV7x~6m3bYr>Sn&pZkyG61zPSKKj}bJ0_1g6R8)tsZ@8dKfqktZFpKT?xR8BmSCR!U zF3?8B?G$}z;>&&3)x+2qN%lphJwl*JO+|}H_h#GQJnvzBMl`H<$}c-x9tJ2pu&ZES zM3f7F@^W6e!okb?W!-Zutt7FgM_LtRE$W$4xd1Z>97ts4myE4~3YzQV2YtTa6G<_# z%b-GmUY~T>7W0S+$Dz3&P4@mY5Z&J?MjzwciPzG>2QhuCOf2E^Z=tk(ak~f_X)~52 zd4rUe*%CAbIhX(uiW@u!DJis^TwKo>6CBs?$t6!otI8TlaB_C>+)4o(58<%wA+5cK z$8{uttShs}OE&l(UHI&t5bJ(!L>r{QNvV58R1K^QMzgg;2ezpE_?2}asX@|*@SEVV z{C70Bh%=n|Z}#)iIia->g=Zu_Os0kjg)lrbGB#Ejpb_Ob=JkJ`z1YJ(hmOAn1~fxM zLs_}Fx>sncC-|%mL8<^UQ!tk(mXF<}^0DQ6zdvj{sg09`y!`vCT^1>7o!G;d))Jo5 z>rKUfwgN|~e~dfUoK|Uh`N5HIrT$L~YHspeP({EkPE1UMlMG6kJJ#0RAfkf{ur%yB zmZf*iPR)PjRr>#F0bs}_J3ISN!{V4|nXM<<3^YEotJr2Ay#^JGxhU?oz3)JedXXf( z#QAFB9A(F~Ui{@!8}{(Ek35_(tJhC}^&6xYm4NS_4|yUZVeTPEq?MHwC)nFXL_{#H zJ%oscJx?1vHKJvZ0F!tRtl@YHivdez?{!?FWw7(VTq66pHi{mkpsv1G0D(Aut9CNB z)q*C{p{8yYvu;xZVhuc)Aj*J%5DuRuTh`C;jkaa*vmA&X}WG3c8V%jB5pRyORi>O!cDO zqf>eP6lexkcO&t^H395v9~m?E~utf+fJ^kH4#RWO0eHw?S2X=MlZy{Q$G}FE5=4942hVOq04rPjhb( zSwn$WV^})#8SC^5U5jact;xGAtIy!@1V{pQmJ1O&*oXZkGG;R7xE*R zzk|h@~|dQjc5A>DO*a54s!hc zZ5rz8(8tluXb4b{y+APrdVWxCS;A@!HCd~V%SSt`-VD(n8EsdC>4+!4@Ur&rr{w5R+iqB-KAm0({32& z2ZLzf+N+a~PYbV|npAdW(^^-2 ziE6O_P&!0inCPV_L`aBTvIXUZf|63GkwUHDew$I@=|>$sheGi>1ZEfwm5va8w36mN2>vRW9P`x2|%=Grge^b<;E0 zu2LTbAJ@L2uzj?>=h^znYM7Rr}jE%J(}y zL7!gzv+5s#vF`bR#|PJbA>tK$v;W^k_(gRE2Kqu0*$ zJksRpM3UKuBg%jVCG`VBYB<3xJv8U{f9-v4aTC^A!{R;J;wO?kASm(G=RSQ#>V-d ztbfq|=p_u}JAjjo1EHwY+6*WZ5kTL4^#=(GQ84yp%gq$kA;XCfdCcEYB9wDzf6i+Z z83rq=2cG@XQ3D(c!^omM2k~^AcrjXHsQlz1#lf|0hcInHa445Nq(?NB{R9NgpiYL; z11bKOmu>&I?pT@$hG~XgUiDKi?);DcA1o%1ox=oFq7w8Gz#{Z7_*Cihd4V-x8^nC9AY28_ zSc;@u-f-{;V(0@dWM$jqm$26sx-a7fC30p(ze^`zu@cJ{h3iS8uqgYizwO%8(7(l8 z+X(H1HGu_MNQ8#M}BNSQ|CCHe_CQ zt_+VuE8_*unfKl;-`6$;&4*oxW*Bs0MQ1T%(KY4FopA%ugBugRlelkmbjydl4@!#` zQpM(6{)W%+q#-suL`?}oUBrwkYbGcmK?7$3_$wR~2ote@IrF6GlivnW4&mpAN_)vA zmQtbUV?wj_-m!Z!(&z3-yDBB(ay7gSzb<(ibE{@7*G&Vh#&k#(u;3 zhPBy93U`k&aE`7se&~Al9Q}q={huGvoa{xCye_#rPj=w3hd2xgFX1h&B5QCW*H@(p z(cr|DUs{j0Pt^`V&ZGcRtgr*nD@b~6>@O&v%o+;k?dvgs&xEhP|qOG z7Z{D&iCh*NP{1BGtK7LGbQXnyDc)XET1r)AwEFiiBX(}X_aAA|Dj!~tLl=c)pu|KB z6a^)vu;aK;`)zP#%TWLQN!j4_r_*NZYo!@l=!Vg}5_YBnUZz5XhzH%yx8FC`F2#qU zdptz9hRy_!pr3Rzu67#%)-oiLjGP=s?h9TfUZNB=E~T=Q^UJw08J&WYAA?rCM(|@K zF)2-p;zgAgGC~@m+@MJV6&f0(tcSoM`?h46miHo}7*su#xZi6mP2g!b$url;AVVaz z(|)pJn?7d+eF{`Xu5%qYxq*rx3m~VXTX|UYBW>{rGqE0PTzL<4b|8WQSQ5z@lCC*l z+g}vX)y*&+lL}reJ-U1?nvE#F-BFk*>CuzDwMoh+J$>!B5|}AM8`ZU!23=J1M`u^h z%s8rjxN(a}_a%#OaZ)J2kT3y(Z;Sr^r7GtSjf`MG>Y~o`ep8j39)EwczFk)k3QD?Q zY){c0N?QGdo5yDgauaa1@_lUe+Rl6Vvy+m6;o51y`RNhjr8u+S1w#1{WIrf0DS0Xi z;QJdWQyifz0&7Za3wr{VkUh?6^IAiQ07wvot$SVF-E8o5!lp1fIy%|f&GN97?;~UZ zmMOk3>Ok)X^`C%cP1%-?P_K1dcgmb4z?osBx-KIN%c=R2kB{*Q1uoC3PSCy9P0G{K zjv{lz=Z?#Iam89Ts9wcp(EhK4HH@d7E<333U-HfnxIxlUu)t|S&~dAioQ5u(I(n_VjzgKIbXSe|RwC?Dg3F?{X`kL+|)o>uVy zK&D$36Kw|LB9Cr{-~XX^NFRGXkdX-W(*L(3vuq2*fM#Aff6)B(BEM6A2PZpd*kE!M zE#evaZ1sP=qT8LXM1_$0GFwO=kUwDlz`{$?{kA1v=-uYk@(l)8{*V2wbo~_T>6Z(L%0=9~lZ}yI!ZL=>E!i+c&fcP-KL zMBMaBm7B$@E0`27?6}%lX@_NkADP#68K!_u2{`{!voY}bAx=Alk_A6DB79t)X_W&l zKsa#5maxkS@fsl(H3;i~zo9{}C0pBlzz??^QAkS0P7%+dP@;hkQ2sblFVV+_AKPZU ztIDd3j~ap?azWRI_!%HB9Up9Nx@VsoMxI|r%}yPRe%b#s4YfM#Va0`Z`_m^CfGeO5 zKNPb#l{#>6oM^(qp&>+bT~o@y&$P-U`*njpN;pboB`vs*IhA(E2fs?Rnw;uSLyq`u z%l4lMt#~(Pe&;l{&<|$jKPV~npu6I6``*~)pQ3-5`C9xc2ZYCTN4?$4KpPR!B&Ve4 zj)@$ZF8!tVCZ6!YK+Dj`-~B^UI4XPA*(|)@q?^+}*4~G#58Zt?Y4 z`FCeq`MaR1gvbVY2Fiz9uptyG2({-8t7p`xm)1gZ!e z&$Tcj8foX%rF^-CBaN)y7P*6VtEV+@ORa7B>!r$k-4qd_sIKyvU+2 z_AK6$rE1V)O>VO`q^!F(B;(FR7+092?_Z&F>4Pik$r(L3qc~SfURS)LT2Ow`Ib5Bk zJZ8JOAZK=VOl5jD|L`}>V&}bN+`Ej9sV(ty@hXw`Qx|PxC#}kAelZF9;&&eVidatzQN~SgU+qwAPS>-6xKt=`>qEVBKa1lX!w+H# zZ%zwl6)|-E>nY@zjtIQ-rx%5>gTK8E`S$kKvxhfgGiAa}#<|wMFJ}eSM*m>vm+f~U z2Ti+L&jaw8$7f}2XpX%Wyk*;Z9DehI%aemKQ$GDRYx6ptOdB6V3;sS>>LLD+I_}~Z zG8_32#CI68_CrZ;cPKb_Hl1w1ust)_ z<|G?^e#ol?mJx8hGnc-YU$G%c47d0-@1g&}E3?8$V}qGd#^-Xu^#XAsb-U_W`@aro zAv!W9@|e5%SIm#r7GL&$VtVB-Z9dj+;k@V6dRy{sDlJ-4oLjsl}eweuceT0Rj zCF0Ws0dF=g@yzKt3G?wRTL!NzPO46L$~R$^7ivo7U8c)Z`GVnvB;B7{ILPTXQgSGk zyNk?z9Ny*cwSB(IA7!;;~9YTFum_?4lZ(Fw7M-~>{1p{XcUIlpgz$%)$? zZ5(D~C*b~?0rVeVi?MV4a!(5>64F+$1wYhe)icnwpwhB7q60=NMNbm#-qBRF6J7u~{WNEDRzBQ50|4mM5FliO<&3Y0|qNotGGq ziA&I*2$(do3JX8@bXZzky#0mg)M?{`m)mOeCz*Jn>P4+4?o0xYMk!-W)3$cZ-W`2* z_0Wm|p)U7Wg_+ka`r?*!>;+}j(!cz|3#DH47Rkl-7MZ1y`L&!%lV(f5IITXC^w@sg zzi3pdUZ|ukt^puqzwBn0l8!PA;6x@|5%Tin7Rrte@277fvS?FtHOT)blY4 zXIc(uPg6E0c;^S)3m{fwd9F|#f=Th=$v+v#b7#?~%s&apuPC}JiP?M9k_IFfF2@gG z9mKV=M04}+teneE?b5*z+A7hiL7D05$2O;0j{Q_$K4_@!)M=hCR#98C+D856D$ttv zLmhh#u3oS=5CcyM{gUPAyN3iQTnrTy*>^W%Pxh*(wC%qozb(z)5-cDWVuCM5tE5X^l@rbPGw}dn*eg!aJXD_WS8EJauY&exN7+Fn{Nm z88VSl5&r4=-`2U$sTv(`MFAHdDsk`{c6;Nlrhw#Nw|*wlDM=)J_dixJnhTR&bXbVWG| z%%mt8otBzs{fT@*ZrVNLoBG4`%@#g&sYz(ZE5#3~Woq$hDbG)Oeno_R;NL5*{&S_w z=a_*iN{RNBIQFffaIarUP5Wl2Yqx#3&hRvKcz!Y$Nv!0S|F~sP+O_?pmuWvNJaoSO z?j?)C!`uEu@=wBcj#kW}&vPbPjPADh;B2O`DM)*pdHnUO`-plFB+)KADWqH}{T{Z^ zszTWZ90QDSKmz=9^G$$%jRhut^8k~9HTUY@KVLvnU_Jm~b?x@G?83r`FZSPIwU^QQ z6<&5i%j#YW$9;X{WN#)g+5TbuWFJG1M@Y&Ff2FtII<$B_jrT{+dtHmglWW_HtFOB<&r^qSE z-~D}u7NVDDbtl*ip1Ly=TVx}%zD;4Z&&V(R9EtbSmOkbp>8#XIPTfo$`Gd_4o_nvR z=DXmB!nx^N<&h|J{kMjUX1GA#@V{|RgdeItq&~p#kF)?QJ@1a8<8>*)ik79_Vu^To0b8HFP!SN@XyyHl67-Rvw31mHC za3}bJVwwo`8sjZWQ%UKOJl^HL9)Q6VIJqbYem`#L{6a$m{v;KQrvYCy!a_sk%MYe^ zX19NEeHCQWh0!Z7QcnJ@E@_9CsBm@|-JI^Io2g^t6C*B;Dqfzcma7`777}@4mB3Va z&C^-cinu3+acQ5irN1Zm8FG?7Hlm*0e&+n`aa`j20Xp}W2QL=}dE(}i){Kmqm%iI` z?Q`~UTMQ*82(5g%OF9)D9nBW6GSG0}Ca%=fN6e5U>*Vl;IICti7zk8m~fkTA9;k2{Uf;`S+ImRgf;Tm;jcnWa*}!JvlCkP28MLCBORnw^})k zW%RRwm7P5nqcSBK6vfhR!buO4=8F3@=F+idfA(R^_rb+2Anl0k zBabAm?(UXxOBC0eZBI}oyO^SsEtmk=+HGW`ps@5BpcJ#^K$&of4n{A7PoB+t*HV$FZ@4 z%^h^|!~jy8XZC}~s=V8OYTC)`->%*^)MSi*a5gR+T07k=;%VnHJIER6qMhA-y-a!? z?$2}Pdg}*?>=o4pioW+Xe2l)UtY3J)!lNyE$8ElY01|45VyV1`UoE3*>_;*Qt%oys&@fN}-T9t8yjvZNQ>-XfvCW)`ip^=Er@E`*DC-lW_E;tBpJ zgj)Za#E*pn?4%DD1&Y!EO|Q&IKBjv@CGXxrHis`ksu2c5%O|TU?(YP@Da=}iw1ib# zJ}JUven1_`DJesK|F(jb;D)Wter(dhb(_6#X#OWg^g$lawww~l#VU$OQV<3NFiY0OR@CDDFnAxnWXuyAijO_mcZfE!+_3VPr3ES z9!Y;BO&-&0xcJk6vz^M|4Cr3V z`gzFtl<6mqM=8BU{P@D7pQv$)FJ;FJy8Q-WDW7PK>s{MRjKd+IEx(W|C)D2>Zp+Iv z9=q{}NP66;7*61-;t@YviW7hM5qK(KHT>6NYkrjZC`If-7n8bBXGcd`snBqWe1E>9 z6Vb4#5a4d1#ADz;*jT|n_LNa&xmdF zwQ(0{>Pkw&rr+MNx8U8N^U;v+t`dgEg;wHmMuJ1S=h2srN1CH=L;JK{po{wNpB^>! zUoGYH7%#eRn+v~2u5O{~w3@`TbWRe?%Em)1o#f;QRUESYLqo>8EXVCoc9aQH;<28rHEiAkQsn0cU-X7xwSX9JhnUJ(t6`VxnB@o0O4YKzjbIt z1kt0zwWa*y=P*B5RrSU9CA@SPtBeexMclPOBmw9N!zp)8TzSHu;kSXrwPjN?cmm+3 z@~|sp4i+FRfN@VJzW%IysxWsISPNvvh1_!xbi^_HYT!IUikkt4z)ta&KyN7A&aa+g zwPqhP^?qZ%Wqy|p;FLJE0AdN!=E22(X;qj1Da)9ifB))r(RA?OePhk(L|nk>)zg5D z#s>WOP*xE>iovEX2*7TGPd^S|)1ylJLFXeOLU-!hf%1%xKzO zEn5pHnChx5w0-BQaQ8Mr*5ux0D4$nE7ADXlP?QG0Qw|Fz!cjlD#mPoH;y`BFw0S)= z;!uz3D8qon+P}9!N*YP& z4iQNyDQN^m8U&<6LRwn7I|VLCw=^nUQqrlQf^>(ZG`xGhzxA#)bN{*mGv}QB+56c~ zL_j=>NvxRvHj)g=#+|2FIfDMUP{H1vGXj~Uod`(1qDE$(|Hq?1c;A6iUPCHLaCaN$ z38wz_)c@xK?98?j%`G>Zna?NCxWB$SG=>9?kyqYWX6 zT{Ndb4{XD(R$3}UkL6UoPluN!9PXtg#@lS=rG@gjv=m(?7-Y!+&>1B8#L$)fOIozx zB_FUEaID>78cEKU3}-?`Tvg0*Ov76NY$dFk!>*LGoBdO~!VBnl`fl#53pu56;M644 ze7*DiTI0g($Md=ty@#KKvl@;tMV;1(#$NNod=%Bf=PBg0hzbL-l$wRhxecyfSlSmE zj?Rsn{F<#St#68hhfUAxen#uGdwkc9D6Pa=taW6PVb0MppDfk>5oJEH7Q8?Lcu5kBsYlFP#CC%kr9>{;EEXw+!t^Y_@1wxR*B#NOwMkC z<@RjPZT7MdrvH5;Ex2O(QBND*iovoO_CL8m3581r!!!{5zC!-(SZnjCeOsKHUvR3# zJMv;h6=7FbIHT`X-`nHu6nQTkrk;!bNTPr!l#F7bQ(*HnkMG zI(e1?diCVe!JHo@xqMsyk&JRKzT!R@h|uNnMr-Qvu5Y?)Tt{U%|L+Nd6eBnHTRJ(* zSXbS`V6OUJD?P!`a3DF1NzbDMO`v0bP~ALN&*T#Q%l)6j&c9U=tNfqg^|zM-Z8N86 z15*|>^UXark`*XYKF`{NVUF|p#zbC~a$%W%Kx7!qMFhTrQ^3h@M5&GWEO;>!l3D)by z<6`FRWn`a+a0^B5QQ>-iqH0}f9V_;x#ZjS-UVIlS;)(a4P2cZ3_y}PTNN003*?BwFK$l@h)CFp~jB5^2FbPALnqzaMZusr{Ak+**aaPb77s1 z=+xjg0P+`N%_%1rIvVv=;PV%zIQV*>zrzKH&9Ueh=ikb%)66_qA?+WZv**W~zxud3 zKh>8v_qcZ@ilhor7f)`+>%@nN$)7Ix^mww_kO*n{VCf~1ri<|&OqCb=IJc6=$d$u` zBj8v6vvYT_tBMZ+qEwE*8fVPK$SY90|B*6E?VY@E_rlJ0YLns$!p)u{CQwTcRPK+5 zfxB(?`ZPD3k}`~M)yh%wEwY7;{%nP|K6X-1D;Z;@5|yQ)1d);z$J-2x-^s?LDI_N6 zmxHI1UFX~{_=C~NKaH!^#Dt|t3*zj%@-e^;y;~qdV7nVoCL>$&4KJDq4#>jT$wOF9jVaRKR zM;Lj2Z2)Z40TIqdn>0%0SP*4RxaENrdme-Sg2+)|B3;>6`*RTWR1ZiteSwIlKue!_=)krtyb0)_KfW_DFtIW(k2lkj$PI$u zOjnAI7gr)u_0fV#%T;!&Q^CGMl9C1HwsP59HjUIpSX&|a-BWlM`412+k&I6(78LxtT-%Dfm0m zqX495;k!aCgWk3;6PayadSBfT{2l(D<))O>#Y#)4bof1G?_Kt(XVy`s%gpHU=6r3aEu_FI0i zD9>+a!-GYLA}PQmOe+x&QU|ZgOkk6^ySrSDUREwa-%9Jw52pU__ri9>{(+YG6npleuJ7A2`)`6cZX*ofz<8r#@l0c`+$*T97} z+L}J{3yK+Uy2sZ0;{B;dFVrL`bz+v2uCsHzb12#Cu$If52J|Nuo&9^va|^$qonG&Y z8+_vRu;e8DI`+fwO^<`y6?$K9?D-$Y`wN8!@jZi5PWC)ogWKb}f5Jnwu+{X{qsY5( zEG;b&1pA_*qH5-RT}f85cV7D%Ef?b-xqlCRTV4NZ&fjCFIBelk^ZE~i=uw^3n88n~ z(@QYW^Vp86r{f?%AGQK2EVy4*|J;c$(=aD6G)>AWtn8@@+Zq!_IFLw8pttTQ@!~kY z+xa^e7vuLU{JQnhOfUI5Q&H3GtZChL-_ysS_K4=9$_zN(7SfWhthoxpTe}W_2@d0+MJ!(}WaC8TJSHsoC*PGgq9#vRE} z@Pi6~08K#I*wWjcQr5f<*FqH|SY=*qa9u4Fs<`hv*8{5el+C^OBT()G2t=pxUP%e(&84CW~xY= z(Y}ARnf2`d(6AN#(Gdjg4MD3`bJ-??^IsM^I*{9uWY_p2`ploXVQ%%D=(d`FHd>R* zqO>N+s^kDJSrA8+!f&u5G=1@xMgfcYX^?}tyzRtSJAQfGEZAa1m60xz>0C1uP^fbt zA1#l>)zrOX-C}yHYtVXM$@YD(th!6{+=A79jZJ4+aHc7e5uIN9Td_YskMM?m%tQ!s z)?<6s(ZGvw;NHv!x2v;qTGmg`!VA%ovp>ZB{p^E3Z+mX|t#6o=uPL;NZt~lH{-iJQ z@ug*#xN?Oy5b6X<=b@{mOQCTH0RBR_OkVuxy{I09KjR1EJV4bEPJa7i()hVR0R_L* zW3&Czs}|g+cb{Ts`XlotB&vezvf|0+?OmDjz?7va??+Bx}B|N=KIWZD{^t$ z8@9;K{!ENv%QA!~zw2WcP+>c%d0MJvx|}Vz6jUYQ-*1C;PQ{yTUHjh^m2%cqvqKhl zRBFhjuLtd3>(!r>v@VG|DzyJbi=tpfMS&L$GAQYGe^jn(Bhz0suNXTh2#;ZKz z5f;O2o{Uv`(MlX=aIMgN@4aL8L9!DTfmaz++!f~yT5d|x>OOp{xP|+^Y^&9|HM)(bVd5C{P#RV zwMk(&r6PTGmZ$=TLD7MikIeQotn8x#Kj*7)J#4$DuZ zS?t)&N5~ucp(=iucro}`I~+^qtiMsBvo&=tL)B>RHBVsn$mu23OAgZS*jW6odv47T z2CvG(DV_0o*nut!wG;+Sx=_gQW_Rp5`$y)myjhO@vp z)?nHU}(b-~_|^m3U0Twk`dRRYdRL4pPG$zaGO1aGiKzC7+HvL2(bp=JsFCJ^dn3aS`~n*16v*8 zSqGtBa&qXgI8>eMud>Z{(QJwSBb(abpE)jme%7aRd)Jv|Jl%CH-E|}B-=fi3>b#kC z=HnIfwH%?U`-5BW7yC1^q9ZUVwm*}U)aLVTjg8L-?B&`YKR-4x;KwUe!Mu*95ojK5 zWc-j3s}=KczrzB5Avq+M>`(!cxjYV9$qvH&Zjgy=veQt*h9yb4uw@%%3CJSVGG9jb ze2#MZl{h)3x+alII-D%5sueo4eeb|mAmjN@LkKhWIUHs^8?^ERUK(|y#$YiC5n|F4VkdXbs+wfd*;^*vWjs)$q5`FE1X z$+AvR_r5fJJhBoK=|@y8UH9)#+7sUEa_g%wm&W&q++H086>LFkDsv6S!PGESx=r-a zXEZ?W&oay&2zL6pau&KO?gAOo&44j?8f$XEW63;ZzMqL4uV_ZMPo#<`CI6=)$S*0m z3qpWz0|Qu>H(-cg{$m5Vy0RS4-N;u^<&`6QY%EPrwKD_&Qt1VeYFnLo%CZDStPNPs zdTxF=J9sJa&znQLFnhH9oa(lI_jbX#S(UM}GcXcOSFfI!^Toa`tkxj}7=%cW!2#BQ zfsgG56$c#G0{NEl-WyR}+!4I~$D;7LGoP-;-@M+6OPmtl@WA+M8D9;9gb3~Wmn_O3 zXchxPAzyc-6q`6{T>rU4ffX<{8g0u_&zoE=5Wu^h@I~sF|96G!F?=eNIxOpEDWJ_? z@zvq)*&7)*>&IFU5g!r}fe9b2!GN>8+%SSUkJ-1Wn6rVqfI_N$qS)c#cf|+#d{M)J zE#;yH-v2&hK15D`WNCLciEj716<01Q;X*k50SmLy*TYu^bwX@8MH7yme)GP{f2h zE|b!PG;;FtaAKglp;H>sUQ%FS;O9By;bT?Yu~m5)QOl#E$&2T1fsRX;$d8?*&DR4_8xI z^E*n69`4UOCXd(mPV~;R1XOneANj9|?_44GR*^)GjTl`_CAj+`6N#>czU+zW zv!{h3E*o#X%2p_&xNi^*%Vf4-u6KjT%DQ~^0~)nhV`ztb3!l z9$}|07WhEHEA0m9u(s>^)h;_iPkgU_ec)9I7+hQGJ+ki((h*I2ygak$$YlPL3~#0G znzMiD9*9d25un*VhnS_II3U-?L~6e{#3bV;I_EVTu9h;fv_uCoBe zrRln(5V%=;Kr>lFtlc}@&BXl5q>_NFqJ?ecu7VJ%ucc)a`HPlw)IV1{&y}}W%r2-^ zP7mzRk)DJ;srGvsOp7TciO=&l(zyRV5ORg_>dz)ixN(XTMr5i-ct-McNovg3I^amlslPJ4x?5&ED# ztAS46zsU2sP^vqp;^Eb$0a%$+;jtFb^S!#Cjj9fUSxBS}>ykv%q=}PHSOq)u4%EHt z>(-f{HAJM%%(>&0ijvIGz!;Wa|ItGdUk=o?NL%bM=N+fBf2yQ3SWd(GU4@y+?3xoz z`S6vYb3ZeZKO$@darc8~$~Bw6G7=;B3OOS4-Rt&7CTJh-?|%lP0c24@v+&ilMpe4? zVBxRP4fUvf}y^3+lxCNb7%Xg41Rth3=zITX_1-aCpmMx4NJ?+lJR^d zEX0Awe@ZeKm<){#bFpC{lv`%SBgWGwQWjqzSCFga@{W)lo}P_fb-De^ZyDl=jv}74 z^A6YIZSz}lWas{^!&WvdKejByMSZnNDzmW)GTIDv^;C-CT&$Kdh4?9iSQbEn< z4iuBUMSE9V*G}7`rT<*2Fv&mVV>m_2OyTSqoO6^E9 z7^;#IijE<{Jsxjr+!(m9usq2d@U|7$?HW^9M z?tSY%<88+UW4x|zBf%ToH<%W|&;(Vyt$1BwE9>A;ePi=jwDsD$rS>SL;nN#rqxiaC z71h5g92;K=HLu!bwsXwHag!3HFy_72G~A~2j(EbaPUo^aL=IwTR#R2tXKXg;mD_kE$}b6jEh4kczO z9#B-bL>}lNoq4ePoevs8ZbyI1IW01(g(9m#hca>Ss^aM{n5T%lzFXGGYC^0Ukw)43 zr5{!fJ@9=;zBCEN19QpHTJ%}p#odN;3_%Tv7e(dDz78e0L0yaf>ZK3~g9aqXs>~sSIdYSX~_!$gJ8Th%jE;&;oX^5HPi+2HniJIGgMA52DxMGcCT~WV-bm@I+2FF0>s#~tQYJ{H2qeJ2I*LF6?mzDXR z@)NS%A1l6V76Co^K{5G+-`nOn=-L2jOy+L;QP309-gK`Se^=!-GKWG~5# z^CaoY(P6GzcU1}{mpV1~X069O^U%=H0>n?r!h&|jP9On$7PSLyf&Iee#W(--Xi=K5 zE|C4@bJPJW1+X9W=V;kG_Ky`JnP(a;Sdr%KzvQ>0U|irYeA~E3wIgyjX>NtF5;gg$ zYzTva%Rm0J^Arhu;RUKk#)*W>|K@(@^1O~8c_weK%^7?yrHS=0p=+e`u^Gk33>`*B zF%;1C0<#2yydXXaHUoIPd&~;mH7oeEH^}Y2m(!}7n$^uqT+Cz^WQ)J*s(LQAr{!^z za|2NiT$RnwM1N5kiB`{W%pBG~I@`AL>q$0YUvk-enIZM@>GXnAk|kVS3fypO%Mp6lolp}u9Z2^X8P?IgXHG{d=b@^|a<|`iMY>5~{S*}pcw!|u_kN$dp zlM--rnAt}j^*)klKs&wN_qE{zVcHr~7pl6_*!b(m56B;++d^#L@#*RE2lqeF4nx}G zSKF#qH&*|gUzeEV+{tBg0G4$0S-?*35+Pa^$**+`UEWWdteu&hTQlvDv|C1>tdAai; zZS;n0szOJL#qgsBcuxsG{H(Ym_GOy2LF`YI(}|Gg6Ouw}?6bQM*B^=CXZY4)y0vn} z_ho3ceZG7odOLC?B(OL6nHk%`M1{UP#8fk?tj74yoljF=avE!enSYfmLUz>t{x*Jo zYdtj%cZY?`^5M&sYGEOl@${JnH%5weez|wPCH_C50Fox9>^Ht&Nm&S7B}2T8jg1i* ziS%=NdAW7%L~(5gZ2wO8;v$51iycISLtFd)f$hvva<4}9YVRW_i_gdYHoWP9$378n zVFN4u#1NFOP_UWCog*>tX-Nmnza zYWyqz-a|R~%*OEG@{E#0FC{S{Y3*yRkSN18#y6CoFYnanu=iBnNM0%ygQf~YpcpsN z6w}xD`>0cI9`}tbee4G|RJ1z=Z5Ph)K3q73G^nzKi+hhRqTlgAKspqv4cjzI@uV@Mymd+b>lA$1LIWfkMY)y=cTFi2x^!(|AMhSX0!)Nov-OGI!nQ9uD7%pJ+A+% zKG5JV@I4WchJXETy%8ZAKH{_)f)2i@9n*$Y?qt{etSFX9K%nSxd=AGBjKvlf%z#}% zfbw$NH}UNooELAr*}v&K_hnH}&8OqA@Orj!$f+|O+!HP%&8uj`#r_yaS(R98&+y5u z$xKm0mdMTSR{+ePYVW?Nt(Lra)l0>pB;SFA@;33w)p1^S@8|oId_&LXn3&aclJ!@T z3O~M`|rVH6$(HO&z4*LaL#WCanpX1|Ma*D z?UTL{Z({Skm60g0d4QvhQttMURFk74bX!1XN+SlfR4y{i@ZDY7w?4$lKa*nA)$H#v z$tDQmk4L9Hd&(Rz1>Qgaju%g=1ptBgk%C+N-eV#z1@8wbXO+S!1kd{1|9E0R6NvDM z2P1x%u8^|_;)s#L2k;#O(TASGWXP^?$Nwo^2SnvwbF#rTsS_4h56n8CvAdXLxoX~? z_qA(u-1iXUeyI$v`&zL}gI#SLMRJ-!mwv7il_Kj;kopG84k&6vr8p&~U*yFo97CjC zc0f&Ebj>CY6{SR|guB z9y@HRfvx80BwYLR=lz;!W6x!0O-wThw@?1oyy@|MLtTG;4@DYuIgcM)IKEyX2qhM0 zC9HTEMehAN_l-bQ3`xwx{f*CYEF5ueuE%UY9A3qtpkTyjq+^@p5&%Lx#08Sdw@Nh) zHV2s}HD0}5j+1&M~t*jxb&Sz3nY0+JYY9&40b0tSL|?kh#f~6>!ywEy-A@xiRx~a#d9$ z`MM)tm%e>aX<>j}H4WaM&+c`>!wUA-Qr<=)u`#qkbn^aDdOmsh<>aJZUS3zE>~VcW z0^BoH0-~RHA6%VJN=R2oj08?)oZQ!lF`2J<=Q~;~fG^zUL@pVNgurdTL^&u~3s)e< zz1C`cC=^m|Y64C2O-`@R2rewH(^Q{7<*x`FH^nIvt$t~j*|zU$*Jk3POzu#EbF}}> zMD*~25wSjToS|B=I#+l?5*XP)l9-rM!KXjeuzUWy`lGjwRNk3?T(=7x6U$kHd(X~9 zoS%H~%_!8(wA>&sGps7UQ4v4tFt(}xt({RlVZpv^e9De6hX{XWKeXiT?_O3gJ;DK>l{i)cM&1IFN<9?2jQKC@%T`bgZi)+TR zw^$q{y8e+ZSTj~T--d>Qp)5l3k*3k0$3;A#RM~I+LNkY`h90J4R6J(o2FMX~5gY(XkRVej}szSGP9#s%@E59uF| z+V;MT0xQ_Ogz4>&64hWV6Ese-lZp7zP4aC?_~Z~Y>g&AsV#$lk{NNwpjsIvzm+)_| zg66M^=B&eh+Vlo{-7z}#-96P)q<>IMkay=^ne6w5>%iY?tipTa|Jik{SnVIA8eN54 zxU;EUVSY!o+~E_?MWIR!w5@p4vn(i@MQG{TQb0=@MZ%vm!KcYfWMBU~cXAVC>t8KP zYJA&Qe9t*cui{;7-@FL{vjFJ3z)2gzZ;=*!kxr4v{4y-Okp1sjv@q0M4EYH|;1d;| zyn#_=-!dW<9*nKC_MI@$(Gi)pd3oKMuX_9XAbJkc!;sJ1)+y`lyDRrz-CHN_3g|ax z;ChIEYUCub*Lal`J_^~Cj!!<^`&nJn^4^XHaYnlympI5d4XpEjv#hDHJg2a0v1erJ zAw)VDb@YYjP~i40AKo$TT`UzD$C z`5st>><@nv)NItT`f)CRPcO5HqL!&2y*=7U1BfCWSiB%6_(wk!Ja+S^0TaH*Z??U+ zC#Rt?SH(?xvU8_Pfs`IvZ^7w_Lu=+X(R%3flNgz$oYaOS>w8& z@h|$Fj2Dnb^jx)NOfEdezkd&bmH%)V>U?)MYM~U|Egz!6$rgebsGx`a37;}3dWg1pZ$B}qSS*9^bhoACC;4n`nl>fpTPoj>;TPQM`4<2b7 z3HDY&`-#?I_uT^VT*OBkvcV2DZB|_>0Qf_eM`*5`sZknanUNY~-MvLo7EH303CrVx zG(DG>e@=<~@q@coJCaSX0QWhLJ~g)LQ`zDH@OF~yL#)o;J2d9=z6k7qtb_o>1eG!D zYw?Cq8P*wRKH`;Pr+NlaW2=AmI_*E5e#y7W!(dEeRNd6#){7}2`>{O2@1ECKOAa>& zgeX+DO~(7&MKr78VrSM0gk%{#MUUU~$eK=t+r)PbAV16qSt~npjWm;$)JC?~ccIiC zGFl`OPNND^FYf;2`Cly$b{Mn;Ber7r84j~J&k~qcTp%dDdvtwcL(T5uhy|<%r>OO+&85c${x=O%2abh9Eu&)a4Bg4abgvcLwRwNJyYF@4EckPJ6@y4hE&ZPEge# zd=hLm)FPYic1YYYa)FD4#5TU>fyhBeL{Bf)O7p&?Sg;kdTMSF_jz z{&r+~4*bM`7C}o045UuWI@pt{>gsO5MD^2pVRVCTmE(}LdKM0G9x<`!DccH-sXJ#8 zE`5L9Z)mvu&Uno!Ue0EtA#=rqUHW-Q&@?Os1pCReArfzt-g975;;d*me>(kqdGdl< z1;hTl^AS%?ZC`IMq^8{~5I9GqotSW+N(q4y~%yEZo15YiLH41PmIP~f-G(LM-C z+XwFeQ!g(>-lXQ((V36$kok}*ofaKL7M7Mi0326YS$P4x`@JbTo;+E^5DGvkn%s>3 z{iF=C`yM^&H0`fpNbf*K0+T9W#(`2E-wRBrz$?Mn*_jZb=_a!D4XwKRIUT{SMnam* z@f1ePS!R>gmvLc6p7(FhwrIyjyNkjGOf8eC*Z%~rx(6nuX^kUhB0g)d@7 z`J$0*|4jq*sgTA8X_Z&uH0%|y|9#Uj9+5BZ=76*M=jmN%w1&$t_vL@s_Hmb=QAsnH z%b%!2G&2~FKe2sRxwvSuvbL57)0}z?al6MV*;&KUazi)G9ku^-B8wf~QIJ*a-)p_m zxw8f&LImRBHpOg+2*uifoaM~BqFr_pd0hj_Uffh^N&(Ck{C=oa99>F1l z7`;+$1Ov3+58PgsA9^ej=uSZ21q~mxTCn>?5LVv2IoX!{(0Hbt32!9vB3se!52+F! zM<2E)*X*sSV0HVJLOXFGXcm8E|62wFe5jzCLB43pSF( z>r3PxnYAn{c|PVVcbmeRoc=Aq~mXKGK&(cc$k2}^sa zd%Zb!1hC6&5Up$w=mX{jVw-tDN%O+Pj!ms$Zcmtg1UBZ$u_><~|Cc;sT&BrxBU1>} zKlT*%l_S76;aXz}WW*q%;+CS!h@77hv)XkiujDZ)|CD*IV@6^e_wNFp9{^qe{X*<& z5s$`Td_E&h4>bT@krP-3o);-X0&Y0a$$XpQP1{|o{)+AjR2ipjwECsksK1EZrv+o5 zB_voqv|lc`pDldES7k1j(gMy@q|KP>cmJXymV&~<^O~2>9`F&8YI1f24xml7OP|O< z;{(kx_`1LgKq?RMn72#a0~m#oV!` zqL*7iJ6nI!0&V-Tg9P~_IXL=g$s+K_C038l5X72lr`_IorYxDEq2(Tf{-wgE7iHia z0}soz?TGlLoz1@wu|O2OycU^g6%!Z716vg+l?XIy0VkX*pG0YcxL(0uX2i1?hs23OU66a4?m?QLyI>1R0fy@Ofqm-oBtBIKV) zEK@{jHNy)n7V9QmZz-=@IG4v0=Ku=>Hpo7o*`If=f+s>joloWTLLCgN6oPF6xV)_a z^HzGkwCa3E{TEAs&B0O+q`Q{bmUZ3yx!$1Jl7q3Ex9bLfA87i6Kr6#Ui13XQ2*b^|Z6d$)`gcCidPFgu z)I)IYEKRf%A|w79URhq=4P4sTy}i98WEX+>*P-drm@X|0D-b^qi@l_zq^X=%m11c# zGgtauRRy_8{{2>YUS_{u{^AjxXM(0D(20Y47qp zWW<(eKU{BEul>fz8<3Ow1v8)+0-GG@t5T-&wAG_Nub1O`wGNv|%V#@iuI=xeAWi|k zO-H#&a@}UHM+?ZJD)>!JO@RZgqBL<>kkK{?fqlI|#ejI!{d2)=vth_77xDvB*^WH?Z&RFC2J4-v-?%yfnWv#LxYnor(?$ z!WjQE9sB3NFuF_*4j`XZ!{SFf^ z(|o?k>q3W(}_9xk_1CT7u2sgRhX@jSM)ZNv}Vv-w~7e&J}@N z6wg-89F3rbifF<8uY1zXrKhgn({&abe`jMiBI$FG0-cOqVN$CyFChUwi{sW;4W}(B zqcLo)y*YO~+9r%<9y(foO-9+E24tN_%~*v!g$qs|X=!QuW@mEPgs|jZ&efs)3YyB& zXkS(F`%I2c(<9c2CDl13V;a!0*-4FG&hbhl1j)dWZ7F74^edltmPegB`Mb?q#fnzM z*NKRkg}7LDXgg~lMiWbXhh6JYinx*5mYy-R&Woh56A*bYp_X^|#BkS51UMJ><BcD*z_*895pqyZxpvldr@(*#@|l+ zdX1Of?Pau8e|@Pj!hE(As7NthlDGZQgPrRZv$#o6%JYXwS@mYz_mi9AA!`!K#It9Z z0MQ^Q3UPfXA#wpChAk-aeX$n0 zpo9SI&e*wiJ9D*8QR?osnx8N?z}xrdCQv9<0Z;fct7IUuaXl$0{tm_O>MTz6H3`p$ z_U!ZqAEf3c_W%H_0rni7{ii&nm7scN^q_wvG`8HZN*?lR27Ha6v4>wGUe!Xi5cG9Pxk zFNpzt%eh{zD#b()%?xEHu z4Xxkn^Ledz9+%r2#9VT=;jacd4=_Y>`wUyw83~ZHCu!THc$|F>JGf~(Emf9qL{Vd{ z?D|?3qWhP{lfT7F0M)y87b%;ta3arop zvjM%rkf13qGT+NWdfv8s4%v`p^VPD>WWMbknAl3adGm;ukFOLh#hhh4tx}nV=+WoJ zKAJS;B9KZzTR@Bz^5W?$r@K{qUL+`oXY%Gq9oSqPZrI(jrnCFklv0+CzN4pJF!ta! z8sJ6sNLkPHHmj1XlP)i%kiomt)f1wp@2%b~3)Y%aE&}Z*IOqT|6oPD-k<(LBLh|w$ z001JYP=;n^v0~0)@%GC#?S(}rpZ&N1!RD;%ip6TKo@NZ$U!Qwgf$UqqfFgnz1xhtx zf+=Qa86RlvE)jnC5c|}?6MwID%W&&Iy463e^8fO@8z`@9eHHlCmD7uizoeI9$yhvN z-fLW;F=*PFNE>LaF|Fhs(rmaVD^-TVf_cb_vUbb;ZHa0$mfvs!57|V5ofr!O0Kh>N z5x?w0b8LDL9*vrq+k4nXjfVjbeX=661)q$oN52m}K{{{N-8-0~aEk)U3GKJ6t;<7; z7EvbJKp#cC56>{7<_Hg-EI4@zYBnYa4 zVxvf<7wuDAB4|D+wz8N+MqIL<&jrxJGV zu4+$9NJvPeOjTLnNmr&HjDNzbU7+rANxpJFsoF6j^K4@vOmD)5XhjO zl3;cYT5-wzc(Y^>?`xX=JC35A=Fk`JYQFcz z#G@6D{`KqE%SVHFczAh`ZV5A!dzH`>Xp?*;C!bLl;OGJo zq1LBs)tSic8tKO6okEA7X!oY8y5&%?)3ao8fZ9$(YuVr)g|86}O}`@*cV^d(J&5l< zj%2eRp$znri;hCD+JfC6pg?026TGZjY%8-cY{3M@EI;$(huphq1mCiK_D1R3#-25$QhPnUHP&OT^n(f;I05C<+jJ3QzbH z|8oHXh;(g|^Ax4&{k-h4*R?(-JVQQ-{@vk+_M@I@v9|F95L5i`)Vj|6U269Qi1sV| zDS$pD+kp#J&_F9J;{XSNwn#ICK4sPLV*T>fpsB{AsMGmqq9?{IjB$Od&ZQxf_VoZZ z7?0=4g5E0X%xl6-k(dfEtad;V_28Hu1z_i#$xUt^9?6q$q>uDa@xqpMSfc8=o*9)( zb#A&M_JJyQ;Qu%MF|g{q;o6k5lPs>7h&5KY1)4j=Zo+wI{ZmM>$!*kSsUMMA5Xv=% z4`I;%s4dDFMb~R8d=tEmdxIDlVm9t8B*vW(LVTEW~ zi>Nmuwokr^0jq|D%A2c(fsGqUMNMI)>ZMEXdoC-N%sZk{RxBxiJprp2NZq!vv60$y z?4o~J^rn{Fk^wnMCmydSpAuhoD_EkO+F zY%?#B*P*=d@x{SQ4s8XroY&zjHr(Y@ptB# zR`uy~#PB^m_&dhBdxR}#=wb3!*W|li?il+R|ANEbplNM<$|B`q6@lhLO}6Nom6O~z z;4|RB!2p7(lamu3zdoqO#X}Nk*%C*M^P{U8&O3j9##IJzBG7CD{yoZ+nshc{8Q6Pj zoqXJ{JMu*r55osU9I6tK2}cysNh70I4m@(yOX-sOJ64_5^!1}=XJ_e3B^QL6Q;+SX zQ@o$0PaAWqBEN5WkE&KY`78!?Si2~FYn&uTE-2-pPSMWkwcv6vURn);nK&d5%qs|_ z1QIDzDGt9{!Pnp?@24k~9JlhgkrFA(Oe@P(F*-m!0avdYu62C9?+)|laQc&@Z()IM4}&TWy3ssoC1rHVC$`bM`OJiZVa?li?+FV{g<2!A%Ng zZ<^Krw?csO-vc(zL0(bEvJVq(?vhKVXJ*R$pSe5*1x2FX74$Bjk4A@a{}mL7B*iB_ zd{xHD$CosrSD0-z2VQbYa>B40|0AKt&IU++Ky95672P=5 z^f9PDzBBvw;1%1q2T#4cogS!;0d=Lkqo-N!*JzktT(Z9@E@f0WXUH!y z;T%+4ym{-`H5NLefcm32Ijh#cZXOa z_Psdh0{3%aLGaFERMP0Di!M(zkT?{Nlxj9Fo+A)R;?Br$P~X|XPlA^sjyN}pRgLb< zTSqdQcgt#2G~&uB{u0|aLx0Z@t?i);{Wr24Mct6|)uVCs-+`+!gV#7kA5>WRt0*J7 ziSEK`@iDtJf$mG{KJJJAp9_$dp56(g5JvlAS6v;-UY=h08>lumCK z4*Y=%2()U=9Hwp5)Ir>rdte$1_vch&qH`5|L1ntf&Rpb4&rU*LR82EVNcdL${>z}U zQA7B31SZ|7JS|<_yFiIAFE5W5jOjQ3y0KAWv=C0#AMM6;>Baklf#5FN7iJUh_sPks zpM08TwHTr>$QkKdWe@$Ng6WihL248vwgaEZ_(yF$g7X1u1bFSA`+%gZBr!PP?kq=q zyT}KXb~NGSqDOPRQO9!q3f%_&S;O~=oM5Q^oR)MMnAN!%#*Osa>NA^-ll z!IK6^G+1TGx2mes$E6Ovmgj}0W=iNA^npjt^#B8&6A`K=r;rTWYs)A!SoypThuC*0iJHqp>-B7iBN zhIJY%Y+acK{N6>7S^h6|19p^T&N%4%b11OK14Y$N3C=sqG=c<$(ySg+w3HgSA0CJZ zLQw}JZ#dJ6R(#A-D3}8Ds;2X6YZI|bj$>%WL}IiNj}pLiWNeLNkf4qae!Rf$4!5=O zj|C%mN`%#bg9F!-Cr_$fH-U<930}ZX)34k+K@3)uVgD62ZiG(^8H93`YLQBKl|>c4 z6nH^CLIGzv+;5*geUdRamJ$w1e*gZfIj;$D6rtktJlyKWRzJ*y@(%3~lr>0e)u??s z)=zWn?2uy`4_F6~I^nK`qUKc;z>+My8x4&lE@d(VM`*19jh#(jVFBv4<68p z>2jzvR%p>>s<3{)Wcg=d?v{K^gwozDGs;Er&C=S(hYBznm>>XBI9w)(Umv%6(LZ{} zPse!G+RhHA+5K-XB<(u(l3N+Ox)MWA>H(4Tgz602ySr#f{oNJyepw{(Ej0?-aX z5;tI2FU>)k|M@eC-{tRl%Px!~^JfCYOC-ju3R6jh3Rw-(wX>?o{^qVwzn#$+kIpsc zxd8@%n+mqrzRhM;(@MDg7=OlUW{0}h6F67m!$ssD%P@FD@sEy+(I_7QDGn23 z%l~WyqdNYWGZopktdl9oU=7(ToDbXA!{d8q{cD88nb)~m^%H??G=uq3Ex43j34|W7 zi$7OUQ7`mTr^aj%-~4HvW1c0$5aI16Kn@RI+4WOmM?mHtFp#$jQhE61mazt>5s&Ig z3k;J%H3s%Q)HQ+2)oTW=C|N3-HDJvu- z1lUyJ8yy4{f+V_FTI?yl*Z*~>vypS9 z7KffhgbiC_SQHls%Coa0TKUgUKt5YjpB8DGoHY#3X)gS>#R>Pkd|v3|coXSD@u93w zJ&BLBo!CCftFI?(KOc4&n*{d%&2h2EPEFs^nn~une?QYQGjT4?p*lH@%XStW+`bW7 zL|OBbs({^;DfDx>)Bg=y0y9uqMI{gRh@cZc7Fhhb2^LYGDvO)gw4zbW5N<5shMR6VY+A+n5 zNl8a8tOy!%3r|^LjfIGNSU)OFYz15za_I$dfE7`m&kIKzgk+Os`Q3On%-PSn&%YB| z&vYSdTNl4Ro|KWegVcsaSXzMOugnspz@)h4-Wvoxo&+&B;3Q_gzBzn%p_o6V^Vj7F z1_$?SjwUp_4tpYu|xKsSi1Fs>23HbL0`F~j-rT`cf#6bQC#!?YWfav zF8em@znMbz$R6QILZT>HDVxlaWGh5Qr0kK9Es>Q`MA;D~i4Z9%qDW>k%7_T@o%j2F z-*X)Aa~$te#{a&5zw0`$^E$8VjO!q^X+=SM>c;-^n$bUSz2 zBI4aBcfAr;zVm^ zg(Zbwa)pfL6wU0j#I27U#f?LI+8d_s+#2{ZshujT39 zozOYK6cuBS^M)}on(IvpEDEH!hfGYo12HjlFT90KzTcjvKV}_NiNo%YapD@413s34 z(%;>L+V|rWHuMF<=@W@;_|Exkt@ec`o3=RK+OfDJ@RS1%y9x2uNV0(vR$4de9r_v$ zA1QK@&#%F#XLAkQsOk<4x>N9Bh0kZ-BZ3^=EK1f%o+gS=eLzQwMc7(D(lEQB5y!J# zD?>CLgDG4HZIC1+EEwKCF{dadVUOj`K?FrcCl>rZ)=t z#{2h(rP6*@rtKu`<#@1|p)RCqV>6QJC|~hlA;Fr(wVAQjDRTL6HKb8#X^rUCAxDR+ zjXb)@IpL{r?%I?HHbm08^p&;%Ug|oOA~cGpL<=!z3!sB{OfWH6i+vfxr(&0N!IJ|8 zNLc-y0pBVva@z6=Li3FEKPEvY66{@5j%4#)7out| zKA7`3$d-ua+I|pMMGKuL67qyk%0(u0;L|SiCe`RDVwyJYnM)rwD>Tu9_-g*Q@+}?; zoPc-t4{yEkkg<+9R!{cvr%!%W6-!~Jr}ki*(0D9#2DlpH8F{H^L+XU*-yeunso5Qn z>xntCk8yk_$G$GG+))Cbk4d>t+yNjhvSnO z_f1wN)EwNF=qUuxKn$x*uLYx9lr>X%TIV;g%>_0lEt%b|#gVMB%hNv3_5*gqa!ToL zJc5BjmN0ebdNOlVc)G{VPF+NzB|XF1x%X~Q#sH|A_LkL$0-O&wtp938?|W-ZJ$uV2 zlMWo2W7?>y;-c>o+B$u-=n7(L8<+N^u8y@&sC~{4`Sx+l1<)wQ^O+lti`nq$kX zQ#DTL3B2aDlT^8utiEy7uK;2+HK`FFv9nf>O*6;{v+}!{TYB%_ zTX`|1n)1NML!JjWlh}fR;7RmfpZgt>tQ%(@ygHc$inPk#=i61{6G?NEC3kA!aBKUX z{g2g%?pbcGAnN$&`lLH|rc$d#o~f9ZD8=hkpV4#h9FcfqM0PDIVFT`Cx4is8Yv7h( z3_PPUcj2^(rip#|(K|!;-c0QHB7vn)wP#BO%n#tNFKHkz85$XpgZ{oXA1H*|&{NI1 zC!c=z)cdaei9^!7plE>aP+Q`6B@eOIKcp8d1-%G2j;$)zpW=QU&%Sv=UAv{4OYfT; zn?SxJXVF=-4gF>&_=1#DSbOZ^i;PWaP`yGLV<$gpI9tmUY zo~f^|FBdr_Gsa%a_>seA?T6+)YwgFnY&)n(8yYl<2&7o$X;566lOwQu`yN)+8<}=8 zzt}FRYB?#X26vSN8Wk|M}H){qFzJrQ>MSn^DF zFGTpx-xXM(+)zFaZ2(xGqdmRc{bjBa6Y8pFbQ|7{!#v{p@+C`01+Nt8&D1ZIgezgTn=L@n%`HUbQ zy|m9QTzd}XY$$R)N;S>h(SMI79G7=*R+-yF?f6acTzTu>tj=+F`Ay*fTT-U;ZzSDLO0LJGvuRD`s~w$}21Llae|_?NkLqZp7qKGW-58x5znf zUn%ll#rVRSeCOFviD-fq+d9k>S8nFe?&z9p{bT@Bh`B~Z38^bv1J4%AA9VZ);P*LB zMrCN-&lLOW6{}pe=k|RjOJ2>)v|2&VZubN8Zl~{wsI@MQt(3pKFdq2}=ocQBY8z z76QrPZk`=$ex!)bsOZ)kSvhIx;OgpSotX=NPgb`%S*kZnp6U0s^zz^7-6CeHrCzMZ zb8Z(xBqJABG&TWR57v65$+@t1zI~f9d+zR0zlh*q(vO)LJB-1US5>)GR%FnS+kA>h zWfE0>ll+sesb&Qx;1^AjD4j*;%XcW!?|LZ7@t;+3tii#xwYAJz@)y@nd+Bx-zY8T5i$jS~>yWGIW6WI>R zv)ro{T4*>|+dba+z|?Z);}>lWlKWAO6sO{YRMW|?^0oIB$b>|vnh!tnw{dnB@95|d zKvS&9xKLE;niQ6s!oM4!qPro$@3GUz6Yr|uURf3&Dm=X1!N12$xyT8It%7je&CSgP zZ!r2=9y!u=pyoJiep}m2sK6J|?AW0OVhlz~FU^}zm7Z0F1J$h^e_yCE(o{*7vuwAz zdfdQ(0o%%@p?Ev_?2V}h`S-qGd(Iq~eOR+SLSzb|@|sB31!n)Er`WaQNlWFUHu_?9 zS|M6JU!VPgm;F=n#rrUMro_|vPeNi`eHda78(2kODT}q_Gd448ouYLSzk1xzCSs1y zo+H>lsk^UlvhuD)wR4L@`au!aUSBlxW;XQyi{>uhTC{u~y;7vz?BqQyHWSv-p^dG@ z)@aX`KYmOMhL8OECAnfLoF^K8s?zRUtveY}4ZKbiUT7D)OG-#w#S@yJA2~+&?BRi& zeLc+Wz++EAmQv{cR4OyNfL2Rvth?Z!RxveoZp2Xo#`)rBc- z2q43W-YZo0d?{hu7=$Dw=&&5;AXs+>4GoRh_Y~gp8 z@)+<)nX|vKK<86NetrhuzI!82 zg=+nf#i2)?&MprI8o)so6%}CvPiS48!l}HE{lijRm_9&fzizYoQD~gd9cLlhqX!PK z!02!F=aX;4KYzyVI^fud)yT$A?lYBtn!qPzo+^GLkjw-@D0(Ml!exga$Q?f}3Tm_AysimcAX2woOPhV$t4o(W1 z+S*Ajl5d~r%4ywuWPk3=8LrFT-e^cW%f2?Ff-*o_R`yZ%W)$z3gWh8(fE1X5!M`=V zeOuDr8(dsmEMMvNv4DQ|=TDaeZ_C&;HV%3?&OJ>0SsYFK7#cQs^AUTup#z7>Z~Enh zSCR?%9SO|}vakG+BVKOqEqsL+k2#rM%M=fdWaQ?)NhlW4k|Lt4S;?8+dtD7myUJ#d zo_&6e4Xn%j{5*;Dt`VPI&BTNiB0#t^^1r^y2Q$ifVD6Fr3cK=(ikGkq8yOyc?|bMI z4WoqaYg->;gD;p(e7wj=3o3=fhnw2lx9jWc)8AgS9rL(Iai*bMHNen<`hn0L@x7sw z&yIZFE$YDHZx?#WoB}fT;sYN|%{||}`DM(8o`k@@eI@3{cb=})hlL^&u?!OrO73h} zI;-4CI7w|)R~45zl!&jot$#V2qaKcx{zwt9$$L3CSl>P|&=YI$>C@OPDI;RbJPgt} zIXQ=Mt>5?dw!pYc+JAN4af&m~xzz<-09eg;Kli&rm|M^_3rI^R40MUU{kyt~)h)Cb zi%HF}I)@vCZvrb2Dp(nz7j^<31L@;@+@zNx4|n{}u3A%H9~S9~sPl+R0&*5sb87eo zpFVx!Nd(E9hcDE&jKt$5_%}dIsLidNoIXFGydPuVzZoiZu0HtoZT6U$7;Llb5GlRz z#r7e6dW_yDv)L{&=#wFyBtFE>hZSUynx|Fnu(u2~*#s)5>u&5G2P?6u>62&6c^zEBf zzFqMSQ<-x*+S=vz?aajHI`!~)T>!tC*gfZGza|t%o6zV%acp-#N|MwC-`28efwNu zICyzux3h>^W34f#>;=a2DK#oI;h)n4ga|{@R4J>7XU~qz&d%b(g&=ldphOK>?$4h; za)b5hta*@MkDoc+t5K|Peur%R(EN+^qb+QKu69x5l6NY#6p84MJFhNen0(9bza(7<7Qokzv(xKY^5s8h%`fFtJb7g*Qf7hr&(+GV zd;4d^$aYQ5_E%6$cHO-ZAJ0&rm+?txhJ`z6p~LZ02DlE~M4UtdR1lGV>SJLaXFl5V z83$d7NkFw_nratZ{1V{iR+>5RwCL-; z4K5?34|#d{p7NZfrKMZ?XZ+th#;UchyULRi2OZK&z3Y_!?s~$`&hGBz_0jiixg-ve znuf+UB4I|Hhi!0o?y(zOHzNQQPV9{*8$S>P4A6aFha>j7=;P|@?gBmT`$^&cf^jer zRt#8U1?xn(H=|irxSpAka=&|3nrUS7-#X!Z3CHSS1+VY8@Z~MuG$ZHhm98z(l$Mqv zQIQK|u=LY?g-w#}bWhQs5<70Eim55v<;$0`MwG&TI>IHVfbdC%s|M$Ri*v;1>9XE ztr|MzzExLNIxp5}`S+%Rl_Nr#hQ^KLT_%rpd)W>=m^s`(l#lz1L{nZ~{{DfVj^W3Y zfQ7GjVN9rY{5TcvVs3su1vhtwXj!2{S&FHM%)x^Z@Z{{^dXg@V=frYBLPEmY!J${; z-phD{N)ef0iR^;T!=^C|zqd+ej)h- zE$?yU7H9i<{Y-f#G5t)Hc)p{xTVDUxyooQtKJG9R@fKh5D^LIa(yv*$;2N-#n+4AV`4z3n@1y5u zr!x!+Hm)DDdsTe;VNFg>u!Zb}q#V`*Dk()rtDSqJe_vx{y6EbfalgPUYxSP3|7k<_ zaMv-a*N>#OZQB;vV#}lC&xzNMu@o}&{ys_Azh~W5MmPv4ZEbi#iDm-`D1Z3}BVikW zGNosphn1Dpx+#2n?bY9+h!ljQb$EEV?5`U+yJ*7y7LTnhPo`g~`~O;i8G;YNy`;W! z3bx5+G5hWRB z(C86UGS|~%rO4Cg{+e^2o_V@|EP3{Tp04gIeB6Xvx5ClDF5THTG{gt9_6v)1yKjDx zIY;I$w1>Xk*WtjK=k@j0*se^^eJ}?VQDl648*l&NI#yj{JjK-iN&?tWs| zGs*uP>#>G_xaXwcei#h^0S9gV6~jp(c7fI}v~rWCQy0)8q=gC$2q{Il4SC1c&(Ch8 z={l#Jvq@IzCm`ocrGTfOJI+s&g-BCvlwA>YxzpOxqAI~IEFwZhG&;-6gY)x+k#^@- z7wn)5v4O{0Il%Aj?dCA{MH+DV;EEoShAbkY(n9rGs1=stq1-dur@WqQAdN$U=Jjy+ zPE^HpzxKywO>}4=DFBjT3w54ZTT*ID+kX#Vjz4>x(jvw^c0fRAW4X_&A12|zZ_+`V z{u`6ZTTY8IjHZo_^=|#;WXJ}!o)bIFO3y~&;@UPx(D&DR2%`#jAAikMx0RZe_3uMW zA1ZIuMZ;JDGC2AZ|K{9pOPQ?{@a02E>zc~zBsKxsaf>r&nm&AB#=haw!3KyLi6BTu zMg|z{?(GfTD;FNRY-ykg$LewhU9$@2rGSJySt|2d3v5r=o0;7~hmDMlQQ^_--Mbe6&b{TI!Cj@4WJlvqyc#U_9WQob;X;3Zf6qh1 z$1=!T=;@U99A}EQPtVGFdzA+U%{gGa0D{vpGQ8eCmfQ8Dq`0_=FqA-wM}(%4_8xjb9bHBdADaW z%lWYC+iR+9YxVBkyJerRi`>i^>FJ}eNHDGoO!l@BKXR_3OU!D_q{8W-h4>=sFKWvh zqAz{geE-bu($&*jSeq$((=v9hVDgNSQIiv6)ykKIB&L>z_~^dwG(g^It*m(e2J#|YX^5NpBl9E8bpig%`ACS0fg7A+2HCfal`E^O zuZM+&WjZ+H&SPR0Yy)nO*Vl=XM~|#8T`DttXv!v&qPd&UDcjl#5ib`R4+lWMHBNcK zxtPqumFNf|>Y+%49BNu5W=n=?^~ z{Hf2+=qE$hXi4r{n*p3$TzT-c99;Mov~_gw>({#D@qmU%yr5Ya`S>KCaB>~-c{F&M zf|{-opo@u*FAmMF@axxY0JeT02kJ<%bQ4D=hn+Jb1n&@f@R8YBi9-JN+qV_3E{0d> zBJW1yvAGF3a#G{l1mC!^4Rv8|S=qOHlDtJG(Lf`TQEk1wDPHsqG1jtEYvWh+y3xo6 z6lk4sHl2FVR8w_raeVu!TcvmvMGdki{A&;X*D98km1W9jU}3R-f2AX+6t>S}wiAHs z1l~OiKIakT@b~Z3aCJnQ1nU4aspY1eu~3X%pkU63diss8gQ1BDCFZ312L`+b^s^3M z$8eG-ttM#mA5&9;I6vq^-6$$@Dk<$Hih<3|&C}0(_JNVv@AX}`ert0*c4_-#MVjzE zIo*w=9-%VL|w$A9-zsP-2Me%Ei;wN=S4GUi7 z7gx7FRpMsWkdTtnK*$k$g(=Zu6OW>bmy$fE<+5QR>$y_$=%~4+gUZE$(g;Z&1iFNz zBy#+ADE6JsYA4(c@gHlYC*Taq{{F{KEQ&{uCf>Od6&_BB4_((#tGE5rnVV5j(AGp0 z7K(9XnBHD^diA&C#i9B;Z{Ps;yZP7GXK=3-Sb47G^_>n0rW~T?x=*eIf`FTvG%AeL za~V&b9IAi*9LkjOK<=%}Gt7*Y_EfSIC`oclN-Sp>9_3DJL_|c0i!GF&DTvK|m9JSa zd()r*ztaCzXM}^T=#hzhiuLV;2Nd3gtY)l+`7TB*)hZ@u(=$|VML?uCGeQcIrFzexab0)@!;Lo+-DU;gggJuzmsW-S7ks2wD8`=5;UM6K>!nF zQ0~u5=lEwM*gCXjqYxAXrKA{$V+TeCVQ8z}Dx00+__A(dSX3d9zG zxw&|ByCuiupe`Z^E+T;A7?LN{*?DQ^c#c^< zy}TW8zg6t6e<*|U#(YYTuPY^ugGf60OpO!Pf&Q8M#sDIT*pzYf+7hE?RpLu&I%IRg zjqTSJ@YmJ6a?>O9{u1_s|%RjEANCg z;)ZYV2R7pCp;rq&>i5SQQ_rXCefQ&UzAv>rLXt7sCn*WTT`HVc;z?mf1slL_d#ea^ zUW2bExt5j|L2r}Hb%*i!TG6m%WMvH}{F#5VZTh|RIsK!rjQ{DCxi~z@QJ_O2#fS;E zJ@uU%tP8`B?wiGjKmj`J_EC9d4Lx7e}n5{YK# z&Q|`QjS!0`ZZ82#z<2TbgX(#(TD2PWY_vG2sLc3xnv&pj`o^4uAyOvk`!RO zX>EDNMK;2eBeeHR?MV}5Tf2hjX$}83Jzu_@apJk{{S2+`hx@V$#cvgnS7<3*oaBV$ zia;etr86pBB1OlNz1wHmI5@_jH&Mk#D)GTuG7fm8p?ab zheRs1d=|0CxPXWPK!Mt2KZ)JwbzWknRxjd+Z;uP*di!1#JB?sO(RSD~+CcUwe{Jc% zNpUiJ^`{;s7E-aZDAE(5p9DEVP z4@Mg3+d02=bUHMTD?TNK4Nux-_r&}@X+iZ*gs`G?>up^YH`x%9z>s@tve#8zMomJN*eu%ix(x%R6A4A($W&mD6DEB0Q0*{1z`>iZskD5nAq3~ z{H*FWe7562C}w5nV#z3|9|S0orBgi&yu7ybza7Jv7xEp8Jp@sbY;oW{aWo}NDn?o5 zuFg!~Gvb$Vu|=h34WujQ)!i^yBNgh~fZm>gt^DC+VF1>VD#Nu>IJe+G!dfj>Zb$I+R#KkSX~ zbCl=Expf{@XfZM|g#`Xvd)e4H%wM+f#RQ$Hoy6v6gKR}rd;8t^y$G;j(;OkVdp9M) zXJ=>g5lI4%m>_eB^H%NB*TZ!HeOYkD_)B=Qgp*CV>%c+Mu%>aOQw`5N)vnXBCjb6} zu^AeWdf(k$l&otmgvfgWVH#R>g@+~< z78%CWFhgJ|JuNgE{<6h(ztZ~b0e{pWZ$DizVk3BHi<*lgL&{*RV6xSUu+bhMx-$1o zLsyqB@b3f%X*lvHygq5RZ&$@-{QfTMCS1Axd+QspFiLgp&ukR-Pq>d|9=Wm;FH7Ec zULZK=#sd{&#QDSXv!4&d@F*~29gzn3-wNz@T3uha!#StHQG@jUJ@EglmX_SwT253< zM#amg`5~sVUL0@7-HX6BDYTl(gSG+*AqZNTbM?P>az+&8R(3OnM??r6I>dq8N90}< z*iX<{Q;IRS&oc}c?B*v=l=cc7&oy6OZV1sf6*B}BUqz@a3Rq1 z06Shj0e6PI-C}Z;@3NS*)e0}8`wl@9h^vMpKfAdrX~$=^YE`+WtQRB2%-yr5h)j*YY6?l@7nDx)|kw=uSgVpW>3+ z(uS`qzqafwVNpZJ$Hyn$BJ>85sFI;2eoDcqNe6@yf<`-g_N@E&&Rz0{4-27pi!SZ^ zzP`2}-Gr@Z?WTWvux;jLL;-Zo8gb_vjMZGa;$nV~#2D7SA%AsocediyP$&$5 zq(7DGnlEEBj-s2;Avw9@xPV+G*@@l@Zn$iKQ?Gi8j0unc>@NhUj-LgQX{=0*ILO0S z1lkAR?SAhojyd5r4yc5rcClna5OhQv@}i-+dHX)!h@HIA1dKrIs|{a6pYuJh5)|Yi zw?P%O3x-EV$VlRKxm1-GQLLHA0_tH*L0D9j8o<8Rdxkx5{pTUYpiLgojl{Wg8>){| z4Wkys#qaL!c5d4nlJ4>0x!(%m?U;7p{LVNYg;12^(A|x8r0gXcx$eIP6{=q|C;ZF7 zWGG&ix4zCt2p=078VKPZ%4CB6c&O)o@y{r3JdvP6WHZS8mxWu-D53<0j)Gtn5ZE%; zy2sk$QN(RWnMb!vhLSiKAmKP840Zl#?uw+jGB?x$4nGm<3mgR7j|F<3w=X~Q`ROb{ zna+jBNet;>=J1v4UNk{6GPskHlLb?>M`mVjB6{d%${RXerJ3Qw^z)BTCEWi0{)CJJ zRA3C>(R7`1+aTeEg$05e?o-lvec3e-Pm7*to^x}1iErTvoWM^)`nrLy09#6hSc(4- zicL*{TmP=0NAlpP8(L0a33fu)FR2fz;mrRdoCy$q=7}3UR>}>6j<_F1T^v_u{gQlj zZLO)PDU`+9x@!N{>KKFWT_wvBEe~*e#GAlS$4#)e!I8rg6Cw$Yw4rD>f=#q>b9?7t zUFCfrZdDrKQs>9pStS4dK!WE{xIEpX<*+R50BG0rx$1m{_l((N*8%qb&zngI%HC59 zr@ykG%m8i&WWeySHRZN#V`#LdDFqxxtG)t>Kw;#!-^wpRWJ~~zhaP-nZz)2g9}+T? z-6A4_fEuXhwh0I)z!Q`N{U^~{hRb9O^v9||{v{?pftioNIJ;Ymip=!~4c23h zGks+@Zr-FN=FuU%BcYtTZr5LK<4GUldhw$3?)?9X`7zKeBr9v8|1Z*tc??h%u#bQ+ zSS*I>kmAqm=dg3nuh}3&a!ExQvK2c%Bd6cXKxV%?H7O|+r*3Stj`vLq`{mIW6$0(SpY!azK-*ZA)Y)$3wAkaJUXA+6eRm0rULA0vXdt?4hAx z{O!Pv1r6P7Mf0CEC-r#6vJ|{T)zs7o#T07UmmfbS3qJ&(O^}+9WraL^xcAFrr!YL& zF)-iGy>EAMaW%bpLyK~mXe;8Vl1NA}$eWx89O*bC(E4m>jeg6E4kc z`bfm*CwxND2_MA4jo{Oqp?8)$HR%aso5-qg&j*n1PTTLNC(m24~o|A2VmgwmwvMNrThrcqwEwcP-! z*TKsbgA7VrQ}e>SF9I9Zl7SbwlDXCK~ib8p~0m-SU9Dmo=K7i|~`w3d#`L0DUv1zHO zwl)o=%csFqHDE*maLzmE>F)!PFRrWe%W z)YN4BYXAOD-c?_E@$Dt9>xHEs@Doi`RaZa%E>n<$gF{?WGH}X!6T)X%pV`xRB+glV zqB({+w^*o}Oo)~~QfMTif*$V5eN^sAfMQroVdZ@Hh^S};3RDfyoP+j!{QL%>=Vd)c z)lto`m7J|hTKn@;NBBfc4(w{0=BhsfKiX~|(QPn4efmARY~wZGo?VFt?04GQ z{HLzIJ5jTzvL1A|7V=dA_}Q#iwiSa)$3F}Lo2A^kCF?68ln3m6H8Yk-q8__!|$9KcIhWQpJE!S&-Qok;&$@LtEj*F=X2`O zX;lE^!3roRi7P)1S^|?Fhd%Aw@t%&d>Ed>Ik5S5MIMJbcA-`bZv$G{QL+G6FOJ0 zci|BX{QBTa28q=aDD$c5c@N(LCwM>6gEjZp0p|Dq#LU+PG&~3WqSVz8KV&_}HPgX5 z1*}aK4hsE7%8+&Jf771pi^%Nldh+Q_An1#L9Zk-h>2TdEB~^&4^%3w)j#=2D0`m;mBPJ|lQ|V`F zSO~mjj{vm^MC3Q+fnXvFc)nxj&hItE@)=p1Cd$S6`J9%U9L9J) zPv&qc^TF~kCw9`WL#0T3j3Q{&W!;BWphhg-PyNl38|MOfN=#^1ZXEE6(%TiX? zqSuY|Sr>n0kO9rD&Nnl7K)brSx@z6?z>olUSQOE7Sn9>?Tl*Lw#cf_)80#)J-TUg* zD^h~iHNY!cM2}1FjZpy8!2J86_a%}v zP7(U%!vN2xpI+Y68nX-elF!|41=>nfPlVtbA1oIdYoA?=q>YW=UC`61xw}iF(3Hko zBnB09baaIO8CX#lTg?5nB47xh5FxQv2NF;Suy?Q)`Hpmn&!cQTR1eqtQOcpKle_>~ zkPBkgEAq%DDj$MCC7FLFkOA5fBcRKWteZPKAGLCBcs?@BKOqSCPt^M;3(@?G0TiWR z%%0kN^Gn(-O4{Ek>aP2Z@LAV}!x()9xOLT!I?g4$Z|NDlx zorvs(v%{3=+$AC@sV}VMMxM?Zs`KYtaBHcEtM(Hqeyn}6$86}S7q{^vh)Zy7>4KXD z-eXH^t8*u;#CV?+7e~Llt89R?QwUX*`@Qy|C!zoX8hB|1AQ|4LS_QVda%lbzI*GcA zYU_zK(g(7jm{1;oE)mW!NO|6~4dVkJaB*EOa?HnvtE6qQ%R26Ja=pKwflo2VW306s zi6tuX2Lc?INFw497iwYT5~FvEP_v0a$91N`zYc8In$;uBD?M&iLT&+C&POLQ`R-l* z00=&Npy`XY#fiiOV(^7$WQNUi~T!KM@Flq$?{ba>3WVzqQA> z_BgZ7BeW&&A$EVn|DrT~*|*%G>9};vt|y6Eu3;ecIJm^4AQd7bp$$|88IwzV_J)A< zaZNA8UYyCoMC6PUF`TN07s0r$MAI|N5G7ME`Z^#nV?cG3ch@Ssf4oPArf6kemD5n~sj!7cbVP_Y(2< z)UiE^H-cot@7)dJM$d4+LkFurLh_Hnx~kT9L}s9*rXGcow+&ZJVPqE7VIDvySGRi> zx<21K?}UNV5`r!X3kQiiz{A7iKHanD;$Us!k%J&d!ANpxHP+#vLQB91JtZ0r=!vm% za0vhRAI+(3(=hs=Cb$0%pWi_n%+n@TpbM2M6CwTs}HF zI%xnaQu^GPmpg)9XcI~VQG@Kx=kc+z$5H0vS*faXD*4Ov@bZ$8P_H)wjv?~y1St-l zW*cB2y4c%*_V%LLPO&Wym~?O*l%UP{>%_DpS0qQr#`dElPxPL|Q+B+i*o=J;t93nf zzIcX8g}dfo z4MS83I~x<8l<)?#kmATMm_9EtUiM!8G(Wj!MLI;fY}&6>xprXc!OIGElC<63^Ik!P z(;i=4NgFiQe3u41NgAY$ox>I+p`iu^5})bTKk8sgl1=XbKl$pC$k<=lwvMIsyTzi}~9Ixh0nbd34YRwWWYMI^a&bYvxGM7L<3xOdlAR%=d2uHY`R zN96Ar8cDC&4Zf1?W;A4+>;I1=Ms|_XeTND)lU~u#A*x0W^`2wb_gj)4QM&UtatS$a zqzjSl+Yzc`7JNn^PhRM-iuyA-)!V(3og_w8^%V8XJ7iq)*n+oY=*HC5MH0-@1=SxL zSXSC|I__we{?mJ@nvCa0C-dL5qCd}=49SA6Nj3E|CaDtfWRWC+zEjbWie!q{JM*$$ zOUDS4q(~)XtPc)2F4xYHmEY)0;-HXkk=ETNRBX%nJ>|kvP4(P_qw&WR%mb|$yM0JI zhpYGD#|YSW&9aiNz%1x~y|EL8rafmt)(*Q(J$07IAKW1lTNqa}R=G*ZWIF$Pn#1JT zF|tm3PEpQAL6Y+!ItR}0ek2Q$1Rio?q&O*@!k65dGFZy@h6VZivKqBs-YabOX7>24 zBW#|Yx^#Z-Glk6F6_(dD{z}0NQUB?Dtq^?ng!KCClogq#`o4SZ=L~cxnSKi89U_z1 zop-Z0gFk=G&+y+JH*)vPNLy0OHuu!X55+4p)OcD$jr}9dz08mp~YVt97#%4(ws6bv&_NUNo%JJ8k|FH(z-~j z%-yOHHbMd!w1H#?kO;+JT4G(bEq)7{!gD|cI+ zwJztC)x9^IPtDQ_MHdHN+J48vXBSge>Ci#?%JU6rk#4l%dxjnGY8v;FMc8~H_0w4& zVfxxVeAWBm*K(XyRy_AT!74(`r^K#BM*X->-I`85EW;$SSTn_F=&<~)ko5R^OwJZV zWz5+i`WQdDVBz5Snaa3_95mge!z9kU_O3dGm!b#u)3K1uZ&&a)OAjSn<&b3TE_Q5C dCo7}bL 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 literal 6374 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 diff --git a/doc/getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_45_0.png b/doc/getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_45_0.png deleted file mode 100644 index 85038936c26ec258ff2d1930a197d2cad8a32400..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 10138 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 literal 0 HcmV?d00001 diff --git a/doc/getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_50_0.png b/doc/getting_started_with_qiskit_terra_files/getting_started_with_qiskit_terra_50_0.png deleted file mode 100644 index 276b9748c00d4d3aa1d34c2700bb9abef29f9643..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 6332 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 literal 0 HcmV?d00001 diff --git a/doc/index.rst b/doc/index.rst index 8a2efbc76463..c281cd21442a 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -17,7 +17,12 @@ Table of Contents Installation and Setup Getting Started with Qiskit Terra The IBM Q Provider + Plotting Data in Qiskit + The Quantum Circuit Summary of Quantum Operations + Visualizing a Quantum Circuit + Jupyter Tools for Terra + Terra Parallel Tools Contributing to Terra Release history Terra SDK Reference <_autodoc/qiskit> diff --git a/doc/plotting_data_in_qiskit.rst b/doc/plotting_data_in_qiskit.rst new file mode 100644 index 000000000000..8464e317a3f7 --- /dev/null +++ b/doc/plotting_data_in_qiskit.rst @@ -0,0 +1,491 @@ + + + +Ploting Data in Qiskit +====================== + +To use this notebook you need to ensure that you have +`maptlotlib `__ installed on your system + +.. code:: ipython3 + + from qiskit.tools.visualization import plot_histogram + +.. code:: ipython3 + + from qiskit import QuantumCircuit, ClassicalRegister, QuantumRegister + from qiskit import execute, BasicAer + +Plot histogram +-------------- + +To visualize the data from a quantum circuit run on a real device or +``qasm_simulator`` we have made a simple function + +``plot_histogram(data)`` + +As an example we make a 2 qubit Bell state + +.. code:: ipython3 + + q = QuantumRegister(2) + c = ClassicalRegister(2) + + # quantum circuit to make a Bell state + bell = QuantumCircuit(q,c) + bell.h(q[0]) + bell.cx(q[0],q[1]) + + meas = QuantumCircuit(q,c) + meas.measure(q, c) + + # execute the quantum circuit + backend = BasicAer.get_backend('qasm_simulator') # the device to run on + circ = bell+meas + result = execute(circ, backend, shots=1000).result() + counts = result.get_counts(circ) + print(counts) + + +.. parsed-literal:: + + {'00': 509, '11': 491} + + +.. code:: ipython3 + + plot_histogram(counts) + + + + +.. image:: plotting_data_in_qiskit_files/plotting_data_in_qiskit_6_0.png + + + +Options when plotting a histogram +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The ``plot_histogram()`` has a few options to adjust the output graph. +The first option is the ``legend`` kwarg. This is used to provide a +label for the executions. It takes a list of strings use to label each +execution’s results. This is mostly useful when plotting multiple +execution results in the same histogram. The ``sort`` kwarg is used to +adjust the order the bars in the histogram are rendered. It can be set +to either ascending order with ``asc`` or descending order with ``dsc``. +The ``number_to_keep`` kwarg takes an integer for the number of terms to +show, the rest are grouped together in a single bar called rest. You can +adjust the color of the bars with the ``color`` kwarg which either takes +a string or a list of strings for the colors to use for the bars for +each execution. You can adjust whether labels are printed above the bars +or not with the ``bar_labels`` kwarg. The last option available is the +``figsize`` kwarg which takes a tuple of the size in inches to make the +output figure. + +.. code:: ipython3 + + # Execute 2 qubit Bell state again + second_result = execute(circ, backend, shots=1000).result() + second_counts = second_result.get_counts(circ) + # Plot results with legend + legend = ['First execution', 'Second execution'] + plot_histogram([counts, second_counts], legend=legend) + + + + +.. image:: plotting_data_in_qiskit_files/plotting_data_in_qiskit_8_0.png + + + +.. code:: ipython3 + + plot_histogram([counts, second_counts], legend=legend, sort='desc', figsize=(15,12), color=['orange', 'black'], bar_labels=False) + + + + +.. image:: plotting_data_in_qiskit_files/plotting_data_in_qiskit_9_0.png + + + +Using the output from plot_histogram() +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +When using the plot_histogram() function it returns a +``matplotlib.Figure`` for the rendered visualization. Jupyter notebooks +understand this return type and renders it for us in this tutorial, but +when running outside of jupyter you do not have this feature +automatically. However, ``matplotlib.Figure`` class natively has methods +to both display and save the visualization. You can call ``.show()`` on +the returned object from ``plot_histogram()`` to open the image in a new +window (assuming your configured matplotlib backend is interactive). Or +alternatively you can call ``.savefig(out.png)`` to save the figure to +``out.png``. The ``savefig()`` takes a path so you can just the location +and filename where you’re saving the output. + +Interactive histogram plots for Jupyter Notebooks. +-------------------------------------------------- + +There is an alternate function for plotting histograms when running in a +Jupyter notebook. This function ``iplot_histogram()`` is made using an +externally hosted JS library for use in Jupyter notebooks. The +interactive plot can only be used if you’re running inside a jupyter +notebook and only if you have external connectivity to the host with the +JS library. If you use ``iplot_histogram()`` outside of a jupyter +notebook it will fail. + +.. code:: ipython3 + + from qiskit.tools.visualization import iplot_histogram + +.. code:: ipython3 + + # Run in interactive mode + iplot_histogram(counts) + + + +.. raw:: html + + +

+

+

+ + + + + +Plot State +---------- + +In many situations you want to see the state of a quantum computer. This +could be for debugging. Here we assume you have this state (either from +simulation or state tomography) and the goal is to visualize the quantum +state. This requires exponential resources, so we advise to only view +the state of small quantum systems. There are several functions for +generating different types of visualization of a quantum state + +:: + + plot_state_city(quantum_state) + plot_state_paulivec(quantum_state) + plot_state_qsphere(quantum_state) + plot_state_hinton(quantum_state) + plot_bloch_multivector(quantum_state) + +A quantum state is either a state matrix :math:`\rho` (Hermitian matrix) +or statevector :math:`|\psi\rangle` (complex vector). The state matrix +is related to the statevector by + +.. math:: \rho = |\psi\rangle\langle \psi|. + +And is more general as it can represent mixed states (positive sum of +statevectors) + +.. math:: \rho = \sum_k p_k |\psi_k\rangle\langle \psi_k |. + +| The visualizations generated by the functions are: - + ``'plot_state_city'``: The standard view for quantum states where the + real and imaginary (imag) parts of the state matrix are plotted like a + city - ``'plot_state_qsphere'``: The Qiskit unique view of a quantum + state where the amplitude and phase of the state vector are plotted in + a spherical ball. The amplitude is the thickness of the arrow and the + phase is the color. For mixed states it will show different + ``'qsphere'`` for each component. - ``'plot_state_paulivec'``: The + representation of the state matrix using Pauli operators as the basis + :math:`\rho=\sum_{q=0}^{d^2-1}p_jP_j/d` - ``'plot_state_hinton'``: + Same as ``'city'`` but with the size of the element represents the + value of the matrix element. +| - ``'plot_bloch_multivector'``: The projection of the quantum state + onto the single qubit space and plotting on a bloch sphere. + +.. code:: ipython3 + + from qiskit.tools.visualization import plot_state_city, plot_bloch_multivector, plot_state_paulivec, plot_state_hinton, plot_state_qsphere + +.. code:: ipython3 + + # execute the quantum circuit + backend = BasicAer.get_backend('statevector_simulator') # the device to run on + result = execute(bell, backend).result() + psi = result.get_statevector(bell) + +.. code:: ipython3 + + plot_state_city(psi) + + + + +.. image:: plotting_data_in_qiskit_files/plotting_data_in_qiskit_18_0.png + + + +.. code:: ipython3 + + plot_state_hinton(psi) + + + + +.. image:: plotting_data_in_qiskit_files/plotting_data_in_qiskit_19_0.png + + + +.. code:: ipython3 + + plot_state_qsphere(psi) + + + + +.. image:: plotting_data_in_qiskit_files/plotting_data_in_qiskit_20_0.png + + + +.. code:: ipython3 + + plot_state_paulivec(psi) + + + + +.. image:: plotting_data_in_qiskit_files/plotting_data_in_qiskit_21_0.png + + + +.. code:: ipython3 + + plot_bloch_multivector(psi) + + + + +.. image:: plotting_data_in_qiskit_files/plotting_data_in_qiskit_22_0.png + + + +Here we see that there is no information about the quantum state in the +single qubit space as all vectors are zero. + +Options when using state plotting functions +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The various functions for plotting quantum state provide a number of +options to adjust the how the plots are rendered. Which options depend +on the function being used. + +**plot_state_city()** options + +- **title** (str): a string that represents the plot title +- **figsize** (tuple): figure size in inches (width, height). +- **color** (list): a list of len=2 giving colors for real and + imaginary components of matrix elements. + +.. code:: ipython3 + + plot_state_city(psi, title="My City", color=['black', 'orange']) + + + + +.. image:: plotting_data_in_qiskit_files/plotting_data_in_qiskit_26_0.png + + + +**plot_state_hinton()** options + +- **title** (str): a string that represents the plot title +- **figsize** (tuple): figure size in inches (width, height). + +.. code:: ipython3 + + plot_state_hinton(psi, title="My Hinton") + + + + +.. image:: plotting_data_in_qiskit_files/plotting_data_in_qiskit_28_0.png + + + +**plot_state_paulivec()** options + +- **title** (str): a string that represents the plot title +- **figsize** (tuple): figure size in inches (width, height). +- **color** (list or str): color of the expectation value bars. + +.. code:: ipython3 + + plot_state_paulivec(psi, title="My Paulivec", color=['purple', 'orange', 'green']) + + + + +.. image:: plotting_data_in_qiskit_files/plotting_data_in_qiskit_30_0.png + + + +**plot_state_qsphere()** options + +- **figsize** (tuple): figure size in inches (width, height). + +**plot_bloch_multivector()** options + +- **title** (str): a string that represents the plot title +- **figsize** (tuple): figure size in inches (width, height). + +.. code:: ipython3 + + plot_bloch_multivector(psi, title="My Bloch Spheres") + + + + +.. image:: plotting_data_in_qiskit_files/plotting_data_in_qiskit_33_0.png + + + +Using the output from state plotting functions +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +When using the any of the state plotting functions it returns a +``matplotlib.Figure`` for the rendered visualization. Jupyter notebooks +understand this return type and renders it for us in this tutorial, but +when running outside of jupyter you do not have this feature +automatically. However, ``matplotlib.Figure`` class natively has methods +to both display and save the visualization. You can call ``.show()`` on +the returned object to open the image in a new window (assuming your +configured matplotlib backend is interactive). Or alternatively you can +call ``.savefig(out.png)`` to save the figure to ``out.png`` in the +current working directory. The ``savefig()`` takes a path so you can +just the location and filename where you’re saving the output. + +Interactive State Plots for Jupyter Notebooks +--------------------------------------------- + +Just like with ``plot_histogram()`` there is a second set of functions +for each of the functions to plot the quantum state. These functions +have the same name but with a prepended ``i``: + +:: + + iplot_state_city(quantum_state) + iplot_state_paulivec(quantum_state) + iplot_state_qsphere(quantum_state) + iplot_state_hinton(quantum_state) + iplot_bloch_multivector(quantum_state) + +these functions are made using an externally hosted JS library for use +in Jupyter notebooks. The interactive plot can only be used if you’re +running inside a jupyter notebook and only if you have external +connectivity to the host with the JS library. If you use these functions +outside of a jupyter notebook it will fail. + +.. code:: ipython3 + + from qiskit.tools.visualization import iplot_state_paulivec + +.. code:: ipython3 + + # Generate an interactive pauli vector plot + iplot_state_paulivec(psi) + + + +.. raw:: html + + +

+

+

+ + + + + +Plot Bloch Vector +----------------- + +A standard way of plotting a quantum system is using the Bloch vector. +This only works for a single qubit and takes as inputs the Bloch vector. + +The Bloch vector is defined as +:math:`[x = \mathrm{Tr}[X \rho], y = \mathrm{Tr}[Y \rho], z = \mathrm{Tr}[Z \rho]]`, +where :math:`X`, :math:`Y`, and :math:`Z` are the Pauli operators for a +single qubit and :math:`\rho` is the state matrix. + +.. code:: ipython3 + + from qiskit.tools.visualization import plot_bloch_vector + +.. code:: ipython3 + + plot_bloch_vector([0,1,0]) + + + + +.. image:: plotting_data_in_qiskit_files/plotting_data_in_qiskit_40_0.png + + + +Options for plot_bloch_vector() +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- **title** (str): a string that represents the plot title +- **figsize** (tuple): Figure size in inches (width, height). + +.. code:: ipython3 + + plot_bloch_vector([0,1,0], title='My Bloch Sphere') + + + + +.. image:: plotting_data_in_qiskit_files/plotting_data_in_qiskit_42_0.png + + + +Adjusting the output from plot_bloch_vector() +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +When using the ``plot_bloch_vector`` function it returns a +``matplotlib.Figure`` for the rendered visualization. Jupyter notebooks +understand this return type and renders it for us in this tutorial, but +when running outside of jupyter you do not have this feature +automatically. However, ``matplotlib.Figure`` class natively has methods +to both display and save the visualization. You can call ``.show()`` on +the returned object to open the image in a new window (assuming your +configured matplotlib backend is interactive). Or alternatively you can +call ``.savefig(out.png)`` to save the figure to ``out.png`` in the +current working directory. The ``savefig()`` takes a path so you can +just the location and filename where you’re saving the output. diff --git a/doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_18_0.png b/doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_18_0.png new file mode 100644 index 0000000000000000000000000000000000000000..c64185f5b59d8fe7b8e7b087cbf51eb757590d23 GIT binary patch literal 77930 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

({SePd#KziErOFB!vdCo&B7kb>Ow8 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 LymnXY3QYTNJ-~f+ literal 0 HcmV?d00001 diff --git a/doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_20_0.png b/doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_20_0.png new file mode 100644 index 0000000000000000000000000000000000000000..e5c310c0c67c6b87e7fd2535390063f89415ce12 GIT binary patch literal 16928 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 literal 0 HcmV?d00001 diff --git a/doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_22_0.png b/doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_22_0.png new file mode 100644 index 0000000000000000000000000000000000000000..0ec82a244a8e5e6d43fdcbaf09e1de7e27f08bba GIT binary patch literal 62182 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

300kmQ?=A2Ahuy(F+ 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 b*<+sGsVdN#lNY0(RWRUw*L}r%{4W0|w$x(2 literal 0 HcmV?d00001 diff --git a/doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_30_0.png b/doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_30_0.png new file mode 100644 index 0000000000000000000000000000000000000000..86d72a391b7413f8c90f4986e7e28596a9adc465 GIT binary patch literal 14187 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 C%WqTw literal 0 HcmV?d00001 diff --git a/doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_33_0.png b/doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_33_0.png new file mode 100644 index 0000000000000000000000000000000000000000..cbe041e32f3ff04d0d7869dbc2b289934f8c286e GIT binary patch literal 64078 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

                   
+    q0_0: |0>──────────
+                  ┌───┐
+    q0_1: |0>─────┤ X ├
+             ┌───┐└───┘
+    q1_0: |0>┤ X ├─────
+             └───┘     
+    q1_1: |0>──────────
+                       
+ + + +is the same as + +.. code:: ipython3 + + circ2 = QuantumCircuit() + circ2.add_register(q0) + circ2.add_register(q1) + circ2.x(q0[1]) + circ2.x(q1[0]) + circ2.draw() + + + + +.. raw:: html + +
                   
+    q0_0: |0>──────────
+                  ┌───┐
+    q0_1: |0>─────┤ X ├
+             ┌───┐└───┘
+    q1_0: |0>┤ X ├─────
+             └───┘     
+    q1_1: |0>──────────
+                       
+ + + +.. raw:: html + +
+ +Note: The order of registers in the list is the order they are initiated +or added (**not** the tensor product for quantum registers). + +.. raw:: html + +
+ +.. code:: ipython3 + + from copy import deepcopy + + q3 = QuantumRegister(2, 'q3') + circ3 = deepcopy(circ) + circ3.add_register(q3) + circ3.draw() + + + + +.. raw:: html + +
                   
+    q0_0: |0>──────────
+                  ┌───┐
+    q0_1: |0>─────┤ X ├
+             ┌───┐└───┘
+    q1_0: |0>┤ X ├─────
+             └───┘     
+    q1_1: |0>──────────
+                       
+    q3_0: |0>──────────
+                       
+    q3_1: |0>──────────
+                       
+ + + +.. raw:: html + +
+ +Note: The circuit drawer has the last register added at the bottom and +if we add a new register it will add it to the bottom of the circuit. + +.. raw:: html + +
+ +Extending a circuit +~~~~~~~~~~~~~~~~~~~ + +In many situations you may have two circuits that you want to +concatenate together to form a new circuit. This is very useful when one +circuit has no measurements and the final circuit represents a +measurement. + +.. code:: ipython3 + + meas = QuantumCircuit(q0, q1, c0, c1) + meas.measure(q0, c0) + meas.measure(q1, c1) + + qc = circ + meas + + qc.draw() + + + + +.. raw:: html + +
                            ┌─┐
+    q0_0: |0>───────────────────┤M├
+                        ┌───┐┌─┐└╥┘
+    q0_1: |0>───────────┤ X ├┤M├─╫─
+                ┌───┐┌─┐└───┘└╥┘ ║ 
+    q1_0: |0>───┤ X ├┤M├──────╫──╫─
+             ┌─┐└───┘└╥┘      ║  ║ 
+    q1_1: |0>┤M├──────╫───────╫──╫─
+             └╥┘      ║       ║  ║ 
+     c0_0: 0 ═╬═══════╬═══════╬══╩═
+              ║       ║       ║    
+     c0_1: 0 ═╬═══════╬═══════╩════
+              ║       ║            
+     c1_0: 0 ═╬═══════╩════════════
+              ║                    
+     c1_1: 0 ═╩════════════════════
+                                   
+ + + +.. code:: ipython3 + + meas2 = QuantumCircuit() + meas2.add_register(q0) + meas2.add_register(q1) + meas2.add_register(c0) + meas2.add_register(c1) + meas2.measure(q0, c0) + meas2.measure(q1, c1) + + qc2 = circ2 + meas2 + + qc2.draw() + + + + +.. raw:: html + +
                            ┌─┐
+    q0_0: |0>───────────────────┤M├
+                        ┌───┐┌─┐└╥┘
+    q0_1: |0>───────────┤ X ├┤M├─╫─
+                ┌───┐┌─┐└───┘└╥┘ ║ 
+    q1_0: |0>───┤ X ├┤M├──────╫──╫─
+             ┌─┐└───┘└╥┘      ║  ║ 
+    q1_1: |0>┤M├──────╫───────╫──╫─
+             └╥┘      ║       ║  ║ 
+     c0_0: 0 ═╬═══════╬═══════╬══╩═
+              ║       ║       ║    
+     c0_1: 0 ═╬═══════╬═══════╩════
+              ║       ║            
+     c1_0: 0 ═╬═══════╩════════════
+              ║                    
+     c1_1: 0 ═╩════════════════════
+                                   
+ + + +It even works when the circuits have different registers. Let’s start by +making two new circuits: + +.. code:: ipython3 + + circ4 = QuantumCircuit(q1) + circ4.x(q1) + circ4.draw() + + + + +.. raw:: html + +
              ┌───┐
+    q1_0: |0>─────┤ X ├
+             ┌───┐└───┘
+    q1_1: |0>┤ X ├─────
+             └───┘     
+ + + +.. code:: ipython3 + + circ5 = QuantumCircuit(q3) + circ5.h(q3) + circ5.draw() + + + + +.. raw:: html + +
              ┌───┐
+    q3_0: |0>─────┤ H ├
+             ┌───┐└───┘
+    q3_1: |0>┤ H ├─────
+             └───┘     
+ + + +The new register is added to the circuit: + +.. code:: ipython3 + + (circ4+circ5).draw() + + + + +.. raw:: html + +
                        ┌───┐
+    q1_0: |0>───────────────┤ X ├
+                       ┌───┐└───┘
+    q1_1: |0>──────────┤ X ├─────
+                  ┌───┐└───┘     
+    q3_0: |0>─────┤ H ├──────────
+             ┌───┐└───┘          
+    q3_1: |0>┤ H ├───────────────
+             └───┘               
+ + + +We have also overloaded ``+=`` to the ``QuantumCircuit`` object: + +.. code:: ipython3 + + circ4 += circ5 + circ4.draw() + + + + +.. raw:: html + +
                        ┌───┐
+    q1_0: |0>───────────────┤ X ├
+                       ┌───┐└───┘
+    q1_1: |0>──────────┤ X ├─────
+                  ┌───┐└───┘     
+    q3_0: |0>─────┤ H ├──────────
+             ┌───┐└───┘          
+    q3_1: |0>┤ H ├───────────────
+             └───┘               
+ + + +Outcomes of Quantum Circuits +---------------------------- + +In the circuit output, the most significant bit (MSB) is to the left and +the least significant bit (LSB) is to the right (i.e. we follow the +regular computer science little endian ordering). In this example: + +.. code:: ipython3 + + circ.draw() + + + + +.. raw:: html + +
                   
+    q0_0: |0>──────────
+                  ┌───┐
+    q0_1: |0>─────┤ X ├
+             ┌───┐└───┘
+    q1_0: |0>┤ X ├─────
+             └───┘     
+    q1_1: |0>──────────
+                       
+ + + +qubit register :math:`Q_0` is prepared in the state :math:`|10\rangle` +and :math:`Q_1` is in the state :math:`|01\rangle` giving a total state +:math:`|0110\rangle` (:math:`Q1\otimes Q0`). + +.. raw:: html + +
+ +Note: The tensor order in Qiskit goes as +:math:`Q_n \otimes .. Q_1 \otimes Q_0` + +.. raw:: html + +
+ +That is the four qubit statevector of length 16 with the 6th element +(``int('0110',2)=6``) being one. Note the element count starts from +zero. + +.. code:: ipython3 + + backend_sim = BasicAer.get_backend('statevector_simulator') + result = execute(circ, backend_sim).result() + state = result.get_statevector(circ) + print(state) + + +.. parsed-literal:: + + [0.+0.j 0.+0.j 0.+0.j 0.+0.j 0.+0.j 0.+0.j 1.+0.j 0.+0.j 0.+0.j 0.+0.j + 0.+0.j 0.+0.j 0.+0.j 0.+0.j 0.+0.j 0.+0.j] + + +To check the fidelity of this state with the ``basis_state`` in Qiskit +Terra you can use: + +.. code:: ipython3 + + state_fidelity(basis_state('0110', 4), state) + + + + +.. parsed-literal:: + + 1.0 + + + +We can also use Qiskit Terra to make the unitary operator representing +the circuit (provided there are no measurements). This will be a +:math:`16\otimes16` matrix equal to +:math:`I\otimes X\otimes X\otimes I`. To check this is correct we can +use the ``Pauli`` class and the ``process_fidelity`` function. + +.. code:: ipython3 + + backend_sim = BasicAer.get_backend('unitary_simulator') + result = execute(circ, backend_sim).result() + unitary = result.get_unitary(circ) + process_fidelity(Pauli(label='IXXI').to_matrix(), unitary) + + + + +.. parsed-literal:: + + 1.0 + + + +To map the information of the quantum state to the classial world we +have to use the example with measurements ``qc``: + +.. code:: ipython3 + + qc.draw() + + + + +.. raw:: html + +
                            ┌─┐
+    q0_0: |0>───────────────────┤M├
+                        ┌───┐┌─┐└╥┘
+    q0_1: |0>───────────┤ X ├┤M├─╫─
+                ┌───┐┌─┐└───┘└╥┘ ║ 
+    q1_0: |0>───┤ X ├┤M├──────╫──╫─
+             ┌─┐└───┘└╥┘      ║  ║ 
+    q1_1: |0>┤M├──────╫───────╫──╫─
+             └╥┘      ║       ║  ║ 
+     c0_0: 0 ═╬═══════╬═══════╬══╩═
+              ║       ║       ║    
+     c0_1: 0 ═╬═══════╬═══════╩════
+              ║       ║            
+     c1_0: 0 ═╬═══════╩════════════
+              ║                    
+     c1_1: 0 ═╩════════════════════
+                                   
+ + + +This will map the quantum state to the classical world and since the +state has no superpositions it will be deterministic and equal to +``'01 10'``. Here a space is used to separate the registers. + +.. code:: ipython3 + + backend_sim = BasicAer.get_backend('qasm_simulator') + result = execute(qc, backend_sim).result() + counts = result.get_counts(qc) + print(counts) + + +.. parsed-literal:: + + {'01 10': 1024} + + +To show that it does not matter how you add the registers we run the +same as above on the second example circuit: + +.. code:: ipython3 + + backend_sim = BasicAer.get_backend('statevector_simulator') + result = execute(circ2, backend_sim).result() + states = result.get_statevector(circ2) + + backend_sim = BasicAer.get_backend('qasm_simulator') + result = execute(qc2, backend_sim).result() + counts = result.get_counts(qc2) + + backend_sim = BasicAer.get_backend('unitary_simulator') + result = execute(circ2, backend_sim).result() + unitary = result.get_unitary(circ2) + +.. code:: ipython3 + + print(counts) + + +.. parsed-literal:: + + {'01 10': 1024} + + +.. code:: ipython3 + + state_fidelity(basis_state('0110', 4), state) + + + + +.. parsed-literal:: + + 1.0 + + + +.. code:: ipython3 + + process_fidelity(Pauli(label='IXXI').to_matrix(), unitary) + + + + +.. parsed-literal:: + + 1.0 + + + +Counting circuit resources +-------------------------- + +A ``QuantumCircuit`` object provides methods for inquiring its resource +use. This includes the number of qubits, operations, and a few other +things. + +.. code:: ipython3 + + q = QuantumRegister(6) + circuit = QuantumCircuit(q) + circuit.h(q[0]) + circuit.ccx(q[0], q[1], q[2]) + circuit.cx(q[1], q[3]) + circuit.x(q) + circuit.h(q[2]) + circuit.h(q[3]) + circuit.draw() + + + + +.. raw:: html + +
                   ┌───┐               ┌───┐                    
+    q0_0: |0>──────────┤ H ├──■────────────┤ X ├────────────────────
+                       └───┘  │            └───┘               ┌───┐
+    q0_1: |0>─────────────────■───────────────────■────────────┤ X ├
+                            ┌─┴─┐┌───┐┌───┐       │            └───┘
+    q0_2: |0>───────────────┤ X ├┤ X ├┤ H ├───────┼─────────────────
+                            └───┘└───┘└───┘     ┌─┴─┐┌───┐┌───┐     
+    q0_3: |0>───────────────────────────────────┤ X ├┤ X ├┤ H ├─────
+                  ┌───┐                         └───┘└───┘└───┘     
+    q0_4: |0>─────┤ X ├─────────────────────────────────────────────
+             ┌───┐└───┘                                             
+    q0_5: |0>┤ X ├──────────────────────────────────────────────────
+             └───┘                                                  
+ + + +.. code:: ipython3 + + # total number of operations in the circuit. no unrolling is done. + circuit.size() + + + + +.. parsed-literal:: + + 11 + + + +.. code:: ipython3 + + # depth of circuit (number of ops on the critical path) + circuit.depth() + + + + +.. parsed-literal:: + + 5 + + + +.. code:: ipython3 + + # number of qubits in the circuit + circuit.width() + + + + +.. parsed-literal:: + + 6 + + + +.. code:: ipython3 + + # a breakdown of operations by type + circuit.count_ops() + + + + +.. parsed-literal:: + + {'x': 6, 'h': 3, 'ccx': 1, 'cx': 1} + + + +.. code:: ipython3 + + # number of unentangled subcircuits in this circuit. + # each subcircuit can in principle be executed on a different quantum processor! + circuit.num_tensor_factors() + + + + +.. parsed-literal:: + + 3 + + diff --git a/doc/summary_of_quantum_operations.rst b/doc/summary_of_quantum_operations.rst index 9f66ca4157f9..99cb891f0067 100644 --- a/doc/summary_of_quantum_operations.rst +++ b/doc/summary_of_quantum_operations.rst @@ -10,7 +10,7 @@ Multi-qubit quantum gates - Measurements - Reset - Conditionals - State initialization We will also show you how to use the three different simulators: - -unitrary_simulator - qasm_simulator - statevector_simulator +unitary_simulator - qasm_simulator - statevector_simulator .. code:: ipython3 @@ -22,13 +22,12 @@ unitrary_simulator - qasm_simulator - statevector_simulator .. code:: ipython3 - from qiskit import QuantumCircuit, ClassicalRegister, QuantumRegister - from qiskit import available_backends, execute, register, get_backend + from qiskit import QuantumCircuit, ClassicalRegister, QuantumRegister, execute from qiskit.tools.visualization import circuit_drawer - from qiskit.tools.qi.qi import state_fidelity - from qiskit import Aer + from qiskit.quantum_info import state_fidelity + from qiskit import BasicAer - backend = Aer.get_backend('unitary_simulator') + backend = BasicAer.get_backend('unitary_simulator') Single Qubit Quantum states --------------------------- @@ -106,7 +105,7 @@ Single-Qubit Gates ------------------ The single-qubit gates available are: - u gates - Identity gate - Pauli -gates - Cliffords gates - :math:`C3` gates - Standard rotation gates +gates - Clifford gates - :math:`C3` gates - Standard rotation gates We have provided a backend: ``unitary_simulator`` to allow you to calculate the unitary matrices. @@ -130,26 +129,30 @@ gate qc = QuantumCircuit(q) qc.u3(pi/2,pi/2,pi/2,q) - circuit_drawer(qc) + qc.draw() -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_9_0.png +.. raw:: html + +
         ┌──────────────────────────┐
+    q0_0: |0>┤ U3(1.5708,1.5708,1.5708) ├
+             └──────────────────────────┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: - array([[ 0.707+0.j , -0. -0.707j], + array([[ 0.707+0.j , 0. -0.707j], [ 0. +0.707j, -0.707+0.j ]]) @@ -172,26 +175,30 @@ This is a useful gate as it allows us to create superpositions qc = QuantumCircuit(q) qc.u2(pi/2,pi/2,q) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_12_0.png +
         ┌───────────────────┐
+    q0_0: |0>┤ U2(1.5708,1.5708) ├
+             └───────────────────┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: - array([[ 0.707+0.j , -0. -0.707j], + array([[ 0.707+0.j , 0. -0.707j], [ 0. +0.707j, -0.707+0.j ]]) @@ -213,24 +220,28 @@ which is a useful as it allows us to apply a quantum phase. qc = QuantumCircuit(q) qc.u1(pi/2,q) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_15_0.png +
         ┌────────────┐
+    q0_0: |0>┤ U1(1.5708) ├
+             └────────────┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: array([[1.+0.j, 0.+0.j], [0.+0.j, 0.+1.j]]) @@ -256,24 +267,28 @@ a period of time equal to fractions of the single qubit gate time) qc = QuantumCircuit(q) qc.u0(pi/2,q) - circuit_drawer(qc) + qc.draw() -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_18_0.png +.. raw:: html + +
         ┌────────────┐
+    q0_0: |0>┤ U0(1.5708) ├
+             └────────────┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: array([[1.+0.j, 0.+0.j], [0.+0.j, 1.+0.j]]) @@ -289,24 +304,28 @@ The identity gate is :math:`Id = u0(1)`. qc = QuantumCircuit(q) qc.iden(q) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_21_0.png +
         ┌────┐
+    q0_0: |0>┤ Id ├
+             └────┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: array([[1.+0.j, 0.+0.j], [0.+0.j, 1.+0.j]]) @@ -334,27 +353,31 @@ The bit-flip gate :math:`X` is defined as: qc = QuantumCircuit(q) qc.x(q) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_24_0.png +
         ┌───┐
+    q0_0: |0>┤ X ├
+             └───┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: - array([[ 0.+0.j, 1.-0.j], - [ 1.+0.j, -0.+0.j]]) + array([[0.+0.j, 1.+0.j], + [1.+0.j, 0.+0.j]]) @@ -376,27 +399,31 @@ The :math:`Y` gate is defined as: qc = QuantumCircuit(q) qc.y(q) - circuit_drawer(qc) + qc.draw() -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_27_0.png +.. raw:: html + +
         ┌───┐
+    q0_0: |0>┤ Y ├
+             └───┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: - array([[ 0.+0.j, -0.-1.j], - [ 0.+1.j, -0.+0.j]]) + array([[0.+0.j, 0.-1.j], + [0.+1.j, 0.+0.j]]) @@ -418,24 +445,28 @@ The phase flip gate :math:`Z` is defined as: qc = QuantumCircuit(q) qc.z(q) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_30_0.png +
         ┌───┐
+    q0_0: |0>┤ Z ├
+             └───┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: array([[ 1.+0.j, 0.+0.j], [ 0.+0.j, -1.+0.j]]) @@ -462,26 +493,30 @@ Hadamard gate qc = QuantumCircuit(q) qc.h(q) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_33_0.png +
         ┌───┐
+    q0_0: |0>┤ H ├
+             └───┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: - array([[ 0.707+0.j, 0.707-0.j], + array([[ 0.707+0.j, 0.707+0.j], [ 0.707+0.j, -0.707+0.j]]) @@ -502,24 +537,28 @@ Hadamard gate qc = QuantumCircuit(q) qc.s(q) - circuit_drawer(qc) + qc.draw() -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_36_0.png +.. raw:: html + +
         ┌───┐
+    q0_0: |0>┤ S ├
+             └───┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: array([[1.+0.j, 0.+0.j], [0.+0.j, 0.+1.j]]) @@ -542,24 +581,28 @@ Hadamard gate qc = QuantumCircuit(q) qc.sdg(q) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_39_0.png +
         ┌─────┐
+    q0_0: |0>┤ Sdg ├
+             └─────┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: array([[1.+0.j, 0.+0.j], [0.+0.j, 0.-1.j]]) @@ -585,24 +628,28 @@ Hadamard gate qc = QuantumCircuit(q) qc.t(q) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_42_0.png +
         ┌───┐
+    q0_0: |0>┤ T ├
+             └───┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: array([[1. +0.j , 0. +0.j ], [0. +0.j , 0.707+0.707j]]) @@ -627,24 +674,28 @@ They can be added as below. qc = QuantumCircuit(q) qc.tdg(q) - circuit_drawer(qc) + qc.draw() -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_45_0.png +.. raw:: html + +
         ┌─────┐
+    q0_0: |0>┤ Tdg ├
+             └─────┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: array([[1. +0.j , 0. +0.j ], [0. +0.j , 0.707-0.707j]]) @@ -675,27 +726,31 @@ Rotation around X-axis qc = QuantumCircuit(q) qc.rx(pi/2,q) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_48_0.png +
         ┌────────────┐
+    q0_0: |0>┤ Rx(1.5708) ├
+             └────────────┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: - array([[ 0.707+0.j , -0. -0.707j], - [ 0. -0.707j, 0.707+0.j ]]) + array([[0.707+0.j , 0. -0.707j], + [0. -0.707j, 0.707+0.j ]]) @@ -715,24 +770,28 @@ Rotation around Y-axis qc = QuantumCircuit(q) qc.ry(pi/2,q) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_51_0.png +
         ┌────────────┐
+    q0_0: |0>┤ Ry(1.5708) ├
+             └────────────┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: array([[ 0.707+0.j, -0.707+0.j], [ 0.707+0.j, 0.707+0.j]]) @@ -758,24 +817,28 @@ phase :math:`e^{-i \phi/2}`. qc = QuantumCircuit(q) qc.rz(pi/2,q) - circuit_drawer(qc) + qc.draw() -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_54_0.png +.. raw:: html + +
         ┌────────────┐
+    q0_0: |0>┤ Rz(1.5708) ├
+             └────────────┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: array([[1.+0.j, 0.+0.j], [0.+0.j, 0.+1.j]]) @@ -1042,24 +1105,30 @@ this gate is equivalent to the following matrix: qc = QuantumCircuit(q) qc.cx(q[0],q[1]) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_61_0.png +
              
+    q1_0: |0>──■──
+             ┌─┴─┐
+    q1_1: |0>┤ X ├
+             └───┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: array([[1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j], [0.+0.j, 0.+0.j, 0.+0.j, 1.+0.j], @@ -1102,24 +1171,30 @@ or when the LSB is the control qc = QuantumCircuit(q) qc.cy(q[0],q[1]) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_64_0.png +
              
+    q1_0: |0>──■──
+             ┌─┴─┐
+    q1_1: |0>┤ Y ├
+             └───┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: array([[1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j], [0.+0.j, 0.+0.j, 0.+0.j, 0.-1.j], @@ -1150,29 +1225,35 @@ whether the MSB or LSB is the control qubit: qc = QuantumCircuit(q) qc.cz(q[0],q[1]) - circuit_drawer(qc) + qc.draw() -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_67_0.png +.. raw:: html + +
            
+    q1_0: |0>─■─
+              │ 
+    q1_1: |0>─■─
+                
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: - array([[ 1.-0.j, 0.+0.j, 0.+0.j, 0.+0.j], - [ 0.+0.j, 1.-0.j, 0.+0.j, -0.-0.j], - [ 0.+0.j, 0.+0.j, 1.-0.j, 0.+0.j], - [ 0.+0.j, -0.+0.j, 0.+0.j, -1.+0.j]]) + array([[ 1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j], + [ 0.+0.j, 1.+0.j, 0.+0.j, 0.+0.j], + [ 0.+0.j, 0.+0.j, 1.+0.j, 0.+0.j], + [ 0.+0.j, 0.+0.j, 0.+0.j, -1.+0.j]]) @@ -1197,29 +1278,35 @@ Apply :math:`H` gate to the target qubit if the control qubit is qc = QuantumCircuit(q) qc.ch(q[0],q[1]) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_70_0.png +
              
+    q1_0: |0>──■──
+             ┌─┴─┐
+    q1_1: |0>┤ H ├
+             └───┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary']/(0.707+0.707j), 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: - array([[ 1. -0.j, 0. +0.j, -0. +0.j, 0. +0.j], - [ 0. +0.j, 0.707-0.j, 0. +0.j, 0.707-0.j], - [ 0. -0.j, 0. +0.j, 1. -0.j, 0. +0.j], - [ 0. +0.j, 0.707-0.j, 0. +0.j, -0.707+0.j]]) + array([[ 0.707+0.707j, 0. +0.j , 0. +0.j , 0. +0.j ], + [ 0. +0.j , 0.5 +0.5j , 0. +0.j , 0.5 +0.5j ], + [ 0. +0.j , 0. +0.j , 0.707+0.707j, 0. +0.j ], + [ 0. +0.j , 0.5 +0.5j , 0. +0.j , -0.5 -0.5j ]]) @@ -1247,24 +1334,30 @@ Perform rotation around Z-axis on the target qubit if the control qubit qc = QuantumCircuit(q) qc.crz(pi/2,q[0],q[1]) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_73_0.png +
                       
+    q1_0: |0>──────■───────
+             ┌─────┴──────┐
+    q1_1: |0>┤ Rz(1.5708) ├
+             └────────────┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: array([[1. +0.j , 0. +0.j , 0. +0.j , 0. +0.j ], [0. +0.j , 0.707-0.707j, 0. +0.j , 0. +0.j ], @@ -1295,26 +1388,30 @@ the control qubit. qc = QuantumCircuit(q) qc.cu1(pi/2,q[0], q[1]) - circuit_drawer(qc) + qc.draw() -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_76_0.png +.. raw:: html +
                  
+    q1_0: |0>─■───────
+              │1.5708 
+    q1_1: |0>─■───────
+                      
-I THINK SHOULD BE CALLED :math:`C_\mathrm{PHASE}(\lambda)` .. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: array([[1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j], [0.+0.j, 1.+0.j, 0.+0.j, 0.+0.j], @@ -1344,24 +1441,30 @@ control qubit (here LSB) is :math:`|1\rangle`. qc = QuantumCircuit(q) qc.cu3(pi/2, pi/2, pi/2, q[0], q[1]) - circuit_drawer(qc) + qc.draw() -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_80_0.png +.. raw:: html + +
                                     
+    q1_0: |0>─────────────■──────────────
+             ┌────────────┴─────────────┐
+    q1_1: |0>┤ U3(1.5708,1.5708,1.5708) ├
+             └──────────────────────────┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: array([[ 1. +0.j , 0. +0.j , 0. +0.j , 0. +0.j ], [ 0. +0.j , 0. -0.707j, 0. +0.j , -0.707+0.j ], @@ -1370,9 +1473,6 @@ control qubit (here LSB) is :math:`|1\rangle`. -NOTE I NEED TO FIX THIS AND DECIDE ON CONVENTION - I ACTUALLY THINK WE -WANT A FOUR PARAMETER GATE AND JUST CALL IT CU AND TO REMOVE THIS GATE. - SWAP gate ~~~~~~~~~ @@ -1398,24 +1498,30 @@ which gives a matrix representation of the form qc = QuantumCircuit(q) qc.swap(q[0], q[1]) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_84_0.png +
            
+    q1_0: |0>─X─
+              │ 
+    q1_1: |0>─X─
+                
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: array([[1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j], [0.+0.j, 0.+0.j, 1.+0.j, 0.+0.j], @@ -1474,41 +1580,41 @@ In matrix form, the Toffoli gate is qc = QuantumCircuit(q) qc.ccx(q[0], q[1], q[2]) - circuit_drawer(qc) + qc.draw() -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_89_0.png +.. raw:: html + +
              
+    q2_0: |0>──■──
+               │  
+    q2_1: |0>──■──
+             ┌─┴─┐
+    q2_2: |0>┤ X ├
+             └───┘
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: - array([[ 1.-0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, - 0.+0.j], - [ 0.+0.j, 1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, - 0.+0.j], - [ 0.+0.j, 0.+0.j, 1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, - 0.+0.j], - [ 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, - 1.-0.j], - [ 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 1.-0.j, 0.+0.j, 0.+0.j, - 0.+0.j], - [ 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 1.-0.j, 0.+0.j, - 0.+0.j], - [ 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 1.-0.j, - 0.+0.j], - [ 0.+0.j, 0.+0.j, 0.+0.j, 1.-0.j, 0.+0.j, 0.+0.j, 0.+0.j, - -0.+0.j]]) + array([[1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j], + [0.+0.j, 1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j], + [0.+0.j, 0.+0.j, 1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j], + [0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 1.+0.j], + [0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j], + [0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 1.+0.j, 0.+0.j, 0.+0.j], + [0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 1.+0.j, 0.+0.j], + [0.+0.j, 0.+0.j, 0.+0.j, 1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j]]) @@ -1543,41 +1649,41 @@ In matrix form, the Fredkin gate is qc = QuantumCircuit(q) qc.cswap(q[0], q[1], q[2]) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_92_0.png +
            
+    q2_0: |0>─■─
+              │ 
+    q2_1: |0>─X─
+              │ 
+    q2_2: |0>─X─
+                
.. code:: ipython3 job = execute(qc, backend) - np.round(job.result().get_data(qc)['unitary'], 3) + job.result().get_unitary(qc, decimals=3) -.. code-block:: text +.. parsed-literal:: - array([[ 1.-0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, - 0.+0.j], - [ 0.+0.j, 1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, - 0.+0.j], - [ 0.+0.j, 0.+0.j, 1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, - 0.+0.j], - [ 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 1.-0.j, 0.+0.j, - 0.+0.j], - [ 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 1.-0.j, 0.+0.j, 0.+0.j, - 0.+0.j], - [ 0.+0.j, 0.+0.j, 0.+0.j, 1.-0.j, 0.+0.j, -0.+0.j, 0.+0.j, - 0.+0.j], - [ 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 1.-0.j, - 0.+0.j], - [ 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, - 1.-0.j]]) + array([[1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j], + [0.+0.j, 1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j], + [0.+0.j, 0.+0.j, 1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j], + [0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 1.+0.j, 0.+0.j, 0.+0.j], + [0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j], + [0.+0.j, 0.+0.j, 0.+0.j, 1.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j], + [0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 1.+0.j, 0.+0.j], + [0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 0.+0.j, 1.+0.j]]) @@ -1605,25 +1711,31 @@ basis state and the quantum computer prepared in a superposition state. qc = QuantumCircuit(q, c) qc.measure(q, c) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_97_0.png +
         ┌─┐
+    q3_0: |0>┤M├
+             └╥┘
+     c0_0: 0 ═╩═
+                
.. code:: ipython3 - backend = Aer.get_backend('qasm_simulator') + backend = BasicAer.get_backend('qasm_simulator') job = execute(qc, backend, shots=1024) job.result().get_counts(qc) -.. code-block:: text +.. parsed-literal:: {'0': 1024} @@ -1637,12 +1749,18 @@ register returns 0. qc = QuantumCircuit(q, c) qc.h(q) qc.measure(q, c) - circuit_drawer(qc) + qc.draw() -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_100_0.png +.. raw:: html + +
         ┌───┐┌─┐
+    q3_0: |0>┤ H ├┤M├
+             └───┘└╥┘
+     c0_0: 0 ══════╩═
+                     
@@ -1654,9 +1772,9 @@ register returns 0. -.. code-block:: text +.. parsed-literal:: - {'1': 519, '0': 505} + {'0': 502, '1': 522} @@ -1675,12 +1793,18 @@ operation, since it is irreversible. qc = QuantumCircuit(q, c) qc.reset(q[0]) qc.measure(q, c) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_104_0.png +
              ┌─┐
+    q3_0: |0>─|0>─┤M├
+                  └╥┘
+     c0_0: 0 ══════╩═
+                     
@@ -1692,7 +1816,7 @@ operation, since it is irreversible. -.. code-block:: text +.. parsed-literal:: {'0': 1024} @@ -1704,12 +1828,18 @@ operation, since it is irreversible. qc.h(q) qc.reset(q[0]) qc.measure(q, c) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_106_0.png +
         ┌───┐     ┌─┐
+    q3_0: |0>┤ H ├─|0>─┤M├
+             └───┘     └╥┘
+     c0_0: 0 ═══════════╩═
+                          
@@ -1721,7 +1851,7 @@ operation, since it is irreversible. -.. code-block:: text +.. parsed-literal:: {'0': 1024} @@ -1741,23 +1871,38 @@ classical register qc = QuantumCircuit(q, c) qc.x(q[0]).c_if(c, 0) qc.measure(q,c) - circuit_drawer(qc) - - job = execute(qc, backend, shots=1024) - job.result().get_counts(qc) + qc.draw() -.. code-block:: text +.. raw:: html - {'1': 1024} +
         ┌─────┐┌─┐
+    q3_0: |0>┤  X  ├┤M├
+             ├──┴──┤└╥┘
+     c0_0: 0 ╡ = 0 ╞═╩═
+             └─────┘   
Here the classical bit always takes the value 0 so the qubit state is always flipped. +.. code:: ipython3 + + job = execute(qc, backend, shots=1024) + job.result().get_counts(qc) + + + + +.. parsed-literal:: + + {'1': 1024} + + + .. code:: ipython3 qc = QuantumCircuit(q, c) @@ -1765,12 +1910,18 @@ always flipped. qc.measure(q,c) qc.x(q[0]).c_if(c, 0) qc.measure(q,c) - circuit_drawer(qc) + qc.draw() + +.. raw:: html -.. image:: summary_of_quantum_operations_files/summary_of_quantum_operations_112_0.png +
         ┌───┐┌─┐┌─────┐┌─┐
+    q3_0: |0>┤ H ├┤M├┤  X  ├┤M├
+             └───┘└╥┘├──┴──┤└╥┘
+     c0_0: 0 ══════╩═╡ = 0 ╞═╩═
+                     └─────┘   
@@ -1782,7 +1933,7 @@ always flipped. -.. code-block:: text +.. parsed-literal:: {'1': 1024} @@ -1826,15 +1977,15 @@ arbitrary state for :math:`n` qubits may be specified by a vector of -.. code-block:: text +.. parsed-literal:: - + .. code:: ipython3 - backend = Aer.get_backend('statevector_simulator') + backend = BasicAer.get_backend('statevector_simulator') job = execute(qc, backend) qc_state = job.result().get_statevector(qc) qc_state @@ -1842,12 +1993,12 @@ arbitrary state for :math:`n` qubits may be specified by a vector of -.. code-block:: text +.. parsed-literal:: - array([ 2.50000000e-01+0.00000000e+00j, 5.55111512e-17-3.53553391e-01j, - 2.50000000e-01-2.50000000e-01j, -2.19980517e-18-3.09536077e-17j, - -2.62603921e-17+5.08377096e-17j, 7.07106781e-01-3.53553391e-01j, - 8.67361738e-17-2.50000000e-01j, 0.00000000e+00+0.00000000e+00j]) + array([0.25 +0.j , 0. -0.35355339j, + 0.25 -0.25j , 0. +0.j , + 0. +0.j , 0.70710678-0.35355339j, + 0. -0.25j , 0. +0.j ]) @@ -1870,7 +2021,7 @@ The fidelity is equal to :math:`1` if and only if two states are same. -.. code-block:: text +.. parsed-literal:: 1.0 diff --git a/doc/terra_jupyter_tools.rst b/doc/terra_jupyter_tools.rst new file mode 100644 index 000000000000..3ea951e7b432 --- /dev/null +++ b/doc/terra_jupyter_tools.rst @@ -0,0 +1,370 @@ + + + +Jupyter Tools for Terra +======================= + +In this section, we will learn how to monitor the status of jobs +submitted to devices and simulators (collectively called backends), as +well as discover how to easily query backend details and view the +collective state of all the backends available to you. + +Loading the Monitoring Tools +---------------------------- + +First, let us load the default qiskit routines, and register our IBMQ +credentials. + +.. code:: ipython3 + + from qiskit import * + IBMQ.load_accounts() + +Functions for monitoring jobs and backends are here: + +.. code:: ipython3 + + from qiskit.tools.monitor import job_monitor, backend_monitor, backend_overview + +If you are running inside a Jupyter notebook, then you will also need to +have ``ipywidgets`` version ``7.3.0`` or higher installed. These come +pre-installed in Anaconda. There are also Jupyter notebook ‘magics’ +available for each of the abover functions. The following will register +those magics, making them ready for use. + +.. code:: ipython3 + + from qiskit.tools.jupyter import * + +Tracking Job Status +------------------- + +Many times a job(s) submitted to the IBM Q network can take a long time +to process, e.g. jobs with many circuits and/or shots, or may have to +wait in queue for other users. In situations such as these, it is +beneficial to have a way of monitoring the progress of a job, or several +jobs at once. As of Qiskit ``0.6+`` it is possible to monitor the status +of a job in a Jupyter notebook, and also in a Python script (verision +``0.7+``). + +Lets see how to make use of these tools. + +Monitoring the status of a single job +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Lets build a simple Bell circuit, submit it to a device, and then +monitor its status. + +.. code:: ipython3 + + q = QuantumRegister(2) + c = ClassicalRegister(2) + qc = QuantumCircuit(q, c) + + qc.h(q[0]) + qc.cx(q[0], q[1]) + qc.measure(q, c); + +Lets grab the least busy backend + +.. code:: ipython3 + + from qiskit.providers.ibmq import least_busy + backend = least_busy(IBMQ.backends(simulator=False)) + backend.name() + + + + +.. parsed-literal:: + + 'ibmqx4' + + + +Monitor the job using ``job_monitor`` in blocking-mode (i.e. using the +same thread as the Python interpretor) + +.. code:: ipython3 + + job1 = execute(qc, backend) + job_monitor(job1) + + + +.. parsed-literal:: + + HTML(value="

Job Status: job is being initialized

") + + +Monitor the job using ``job_monitor`` in async-mode (Jupyter notebooks +only). The job will be monitored in a separate thread, allowing you to +continue to work in the notebook. + +.. code:: ipython3 + + job2 = execute(qc, backend) + job_monitor(job2, monitor_async=True) + + + +.. parsed-literal:: + + HTML(value="

Job Status: job is being initialized

") + + +It is also possible to monitor the job using the ``qiskit_job_status`` +Jupyter notebook magic. This method is always asyncronous. + +.. code:: ipython3 + + %%qiskit_job_status + job3 = execute(qc, backend) + + + +.. parsed-literal:: + + VBox(children=(HTML(value="

Job Status : job is being initialized

"),)) + + +Note that, for the ``qiskit_job_status`` to work, the job returned by +``execute`` must be stored in a variable so that it may be retrieved by +the magic. + +Monitoring many jobs simultaneously +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Here we will monitor many jobs sent the the device. It is if the jobs +are stored in a list to make retrevial easier. + +.. code:: ipython3 + + num_jobs = 5 + my_jobs = [] + for j in range(num_jobs): + my_jobs.append(execute(qc, backend)) + job_monitor(my_jobs[j], monitor_async=True) + + + +.. parsed-literal:: + + HTML(value="

Job Status: job is being initialized

") + + + +.. parsed-literal:: + + HTML(value="

Job Status: job is being initialized

") + + + +.. parsed-literal:: + + HTML(value="

Job Status: job is being initialized

") + + + +.. parsed-literal:: + + HTML(value="

Job Status: job is being initialized

") + + + +.. parsed-literal:: + + HTML(value="

Job Status: job is being initialized

") + + +Or, using magic: + +.. code:: ipython3 + + %%qiskit_job_status + my_jobs2 = [] + for j in range(num_jobs): + my_jobs2.append(execute(qc, backend)) + + + +.. parsed-literal:: + + VBox(children=(HTML(value="

Job Status [0]: job is being initialized

"), HTML(va… + + +In the magics example, the magic is smart enough to know that the list +``my_jobs2`` contains jobs, and will automatically extract them and +check their status. We are not limited to using ``jobs.append()``, and +can use an indexed list or NumPy array as well: + +.. code:: ipython3 + + %%qiskit_job_status + import numpy as np + my_jobs3 = np.empty(num_jobs, dtype=object) + for j in range(num_jobs): + my_jobs3[j] = execute(qc, backend) + + + +.. parsed-literal:: + + VBox(children=(HTML(value="

Job Status [0]: job is being initialized

"), HTML(va… + + +Changing the interval of status updating +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +By default, the interval at which the job status is checked is every two +seconds. However, the user is free to change this using the ``interval`` +keyword argument in ``job_monitor`` + +.. code:: ipython3 + + job3 = execute(qc, backend) + job_monitor(job3, interval=5) + + + +.. parsed-literal:: + + HTML(value="

Job Status: job is being initialized

") + + +and the ``-i`` or ``--interval`` arguments to the Jupyter magic. + +.. code:: ipython3 + + %%qiskit_job_status -i 5 + job4 = execute(qc, backend) + + + +.. parsed-literal:: + + VBox(children=(HTML(value="

Job Status : job is being initialized

"),)) + + +.. code:: ipython3 + + %%qiskit_job_status --interval 5 + job5 = execute(qc, backend) + + + +.. parsed-literal:: + + VBox(children=(HTML(value="

Job Status : job is being initialized

"),)) + + +Backend Details +--------------- + +So far we have been executing our jobs on a backend, but we have +explored the backends in any detail. For example, we have found the +least busy backend, but do not know if this is the best backend with +respect to gate errors, topology etc. It is possible to get detailed +information for a single backend by calling ``backend_monitor``: + +.. code:: ipython3 + + backend_monitor(backend) + + +.. parsed-literal:: + + ibmqx4 + ====== + Configuration + ------------- + n_qubits: 5 + operational: True + status_msg: active + pending_jobs: 4 + basis_gates: ['u1', 'u2', 'u3', 'cx', 'id'] + local: False + simulator: False + open_pulse: False + credits_required: True + conditional: False + max_experiments: 75 + max_shots: 8192 + coupling_map: [[1, 0], [2, 0], [2, 1], [3, 2], [3, 4], [4, 2]] + sample_name: raven + description: 5 qubit device + n_registers: 1 + memory: True + url: None + backend_version: 1.0.0 + backend_name: ibmqx4 + online_date: 2018-11-06T05:00:00+00:00 + allow_q_object: True + + Qubits [Name / Freq / T1 / T2 / U1 err / U2 err / U3 err / Readout err] + ----------------------------------------------------------------------- + Q0 / 5.24985 GHz / 52.87796 µs / 45.91462 µs / 0.0 / 0.00077 / 0.00155 / 0.06025 + Q1 / 5.29578 GHz / 52.18911 µs / 19.45196 µs / 0.0 / 0.00197 / 0.00395 / 0.07425 + Q2 / 5.35325 GHz / 42.88025 µs / 29.48086 µs / 0.0 / 0.00163 / 0.00326 / 0.02925 + Q3 / 5.43494 GHz / 46.88035 µs / 17.74449 µs / 0.0 / 0.00189 / 0.00378 / 0.023 + Q4 / 5.17582 GHz / 41.22472 µs / 11.09655 µs / 0.0 / 0.00335 / 0.0067 / 0.07525 + + Multi-Qubit Gates [Name / Type / Gate Error] + -------------------------------------------- + CX1_0 / cx / 0.03639 + CX2_0 / cx / 0.02608 + CX2_1 / cx / 0.04075 + CX3_2 / cx / 0.06022 + CX3_4 / cx / 0.04131 + CX4_2 / cx / 0.06126 + + +Or, if we are interested in a higher-level view of all the backends +available to us, then we can use ``backend_overview()`` + +.. code:: ipython3 + + backend_overview() + + +.. parsed-literal:: + + ibmq_20_tokyo ibmq_16_melbourne ibmqx4 + ------------- ----------------- ------ + Num. Qubits: 20 Num. Qubits: 14 Num. Qubits: 5 + Pending Jobs: 0 Pending Jobs: 3 Pending Jobs: 6 + Least busy: True Least busy: False Least busy: False + Operational: True Operational: True Operational: True + Avg. T1: 86.9 Avg. T1: 50.3 Avg. T1: 47.2 + Avg. T2: 55.3 Avg. T2: 63.0 Avg. T2: 24.7 + + + + + +There are also Jupyter magic equivalents that give more detailed +information. + +.. code:: ipython3 + + %qiskit_backend_monitor backend + + +.. parsed-literal:: + + VBox(children=(HTML(value="

, - , - , , ] @@ -151,7 +149,7 @@ Now no backends are available -.. code-block:: text +.. parsed-literal:: [] @@ -162,8 +160,8 @@ network) .. code:: ipython3 - IBMQ.save_account(Qconfig_IBMQ_experience.APItoken) - IBMQ.save_account(Qconfig_IBMQ_network.APItoken, Qconfig_IBMQ_network.url) + IBMQ.save_account(Qconfig_IBMQ_experience.APItoken, overwrite=True) + IBMQ.save_account(Qconfig_IBMQ_network.APItoken, Qconfig_IBMQ_network.url, overwrite=True) Now they should show up as present on disk @@ -181,7 +179,7 @@ but no account active in current session yet -.. code-block:: text +.. parsed-literal:: [] @@ -196,7 +194,7 @@ so IBMQ can’t see any backends yet -.. code-block:: text +.. parsed-literal:: [] @@ -217,15 +215,13 @@ backends from two different accounts available for use -.. code-block:: text +.. parsed-literal:: [, - , - , , , - , - ] + , + ] @@ -239,10 +235,10 @@ via account filtering -.. code-block:: text +.. parsed-literal:: - [, - ] + [, + ] @@ -268,11 +264,9 @@ and only that account’s backends are available -.. code-block:: text +.. parsed-literal:: [, - , - , , ] @@ -290,11 +284,9 @@ interested in -.. code-block:: text +.. parsed-literal:: [, - , - , , ] @@ -318,7 +310,7 @@ As a first example: only return currently operational devices -.. code-block:: text +.. parsed-literal:: [, ] @@ -330,13 +322,13 @@ are operational .. code:: ipython3 - IBMQ.backends(filters=lambda x: x.configuration()['n_qubits'] <= 5 and - not x.configuration()['simulator'] and x.status()['operational']==True) + IBMQ.backends(filters=lambda x: x.configuration().n_qubits <= 5 and + not x.configuration().simulator and x.status().operational==True) -.. code-block:: text +.. parsed-literal:: [] @@ -347,16 +339,16 @@ queue) .. code:: ipython3 - from qiskit.backends.ibmq import least_busy + from qiskit.providers.ibmq import least_busy - small_devices = IBMQ.backends(filters=lambda x: x.configuration()['n_qubits'] <= 5 and - not x.configuration()['simulator']) + small_devices = IBMQ.backends(filters=lambda x: x.configuration().n_qubits == 5 and + not x.configuration().simulator) least_busy(small_devices) -.. code-block:: text +.. parsed-literal:: @@ -374,7 +366,7 @@ the ``get_backend()`` method. -.. code-block:: text +.. parsed-literal:: @@ -432,9 +424,9 @@ object -.. code-block:: text +.. parsed-literal:: - + > @@ -447,7 +439,7 @@ Next is the ``name()``, which returns the name of the backend -.. code-block:: text +.. parsed-literal:: 'ibmqx4' @@ -467,9 +459,9 @@ Next let’s look at the ``status()``: -.. code-block:: text +.. parsed-literal:: - {'pending_jobs': 6, 'name': 'ibmqx4', 'operational': True} + BackendStatus(backend_name='ibmqx4', backend_version='1.0.0', operational=True, pending_jobs=0, status_msg='active') @@ -482,23 +474,9 @@ The next is ``configuration()`` -.. code-block:: text +.. parsed-literal:: - {'local': False, - 'name': 'ibmqx4', - 'version': '1.2.0', - 'description': '5 qubit transmon bowtie chip 3', - 'gate_set': 'SU2+CNOT', - 'basis_gates': 'u1,u2,u3,cx,id', - 'online_date': '2017-09-18T00:00:00.000Z', - 'chip_name': 'Raven', - 'deleted': False, - 'url': 'https://ibm.biz/qiskit-ibmqx4', - 'internal_id': '5ae875670f020500393162b3', - 'simulator': False, - 'allow_q_object': False, - 'n_qubits': 5, - 'coupling_map': [[1, 0], [2, 0], [2, 1], [3, 2], [3, 4], [4, 2]]} + BackendConfiguration(allow_q_object=True, backend_name='ibmqx4', backend_version='1.0.0', basis_gates=['u1', 'u2', 'u3', 'cx', 'id'], conditional=False, coupling_map=[[1, 0], [2, 0], [2, 1], [3, 2], [3, 4], [4, 2]], credits_required=True, description='5 qubit device', gates=[GateConfig(coupling_map=[[0], [1], [2], [3], [4]], name='id', parameters=[], qasm_def='gate id q { U(0,0,0) q; }'), GateConfig(coupling_map=[[0], [1], [2], [3], [4]], name='u1', parameters=['lambda'], qasm_def='gate u1(lambda) q { U(0,0,lambda) q; }'), GateConfig(coupling_map=[[0], [1], [2], [3], [4]], name='u2', parameters=['phi', 'lambda'], qasm_def='gate u2(phi,lambda) q { U(pi/2,phi,lambda) q; }'), GateConfig(coupling_map=[[0], [1], [2], [3], [4]], name='u3', parameters=['theta', 'phi', 'lambda'], qasm_def='u3(theta,phi,lambda) q { U(theta,phi,lambda) q; }'), GateConfig(coupling_map=[[1, 0], [2, 0], [2, 1], [3, 2], [3, 4], [4, 2]], name='cx', parameters=[], qasm_def='gate cx q1,q2 { CX q1,q2; }')], local=False, max_experiments=75, max_shots=8192, memory=True, n_qubits=5, n_registers=1, online_date=datetime.datetime(2018, 11, 6, 5, 0, tzinfo=tzutc()), open_pulse=False, sample_name='raven', simulator=False, url='None') @@ -511,92 +489,9 @@ The next is ``properties()`` method -.. code-block:: text - - {'last_update_date': '2018-11-12T02:56:39.000Z', - 'qubits': [{'gateError': {'date': '2018-11-12T02:56:39Z', - 'value': 0.0011160854878761173}, - 'name': 'Q0', - 'readoutError': {'date': '2018-11-12T02:56:39Z', 'value': 0.073}, - 'buffer': {'date': '2018-11-12T02:56:39Z', 'value': 10, 'unit': 'ns'}, - 'gateTime': {'date': '2018-11-12T02:56:39Z', 'value': 60, 'unit': 'ns'}, - 'T2': {'date': '2018-11-12T02:56:39Z', 'value': 32.8, 'unit': 'µs'}, - 'T1': {'date': '2018-11-12T02:56:39Z', 'value': 44.6, 'unit': 'µs'}, - 'frequency': {'date': '2018-11-12T02:56:39Z', - 'value': 5.24987, - 'unit': 'GHz'}}, - {'gateError': {'date': '2018-11-12T02:56:39Z', 'value': 0.00128782749692391}, - 'name': 'Q1', - 'readoutError': {'date': '2018-11-12T02:56:39Z', 'value': 0.073}, - 'buffer': {'date': '2018-11-12T02:56:39Z', 'value': 10, 'unit': 'ns'}, - 'gateTime': {'date': '2018-11-12T02:56:39Z', 'value': 60, 'unit': 'ns'}, - 'T2': {'date': '2018-11-12T02:56:39Z', 'value': 20.1, 'unit': 'µs'}, - 'T1': {'date': '2018-11-12T02:56:39Z', 'value': 34.2, 'unit': 'µs'}, - 'frequency': {'date': '2018-11-12T02:56:39Z', - 'value': 5.29577, - 'unit': 'GHz'}}, - {'gateError': {'date': '2018-11-12T02:56:39Z', - 'value': 0.001631340796924452}, - 'name': 'Q2', - 'readoutError': {'date': '2018-11-12T02:56:39Z', 'value': 0.033}, - 'buffer': {'date': '2018-11-12T02:56:39Z', 'value': 10, 'unit': 'ns'}, - 'gateTime': {'date': '2018-11-12T02:56:39Z', 'value': 60, 'unit': 'ns'}, - 'T2': {'date': '2018-11-12T02:56:39Z', 'value': 27.4, 'unit': 'µs'}, - 'T1': {'date': '2018-11-12T02:56:39Z', 'value': 38, 'unit': 'µs'}, - 'frequency': {'date': '2018-11-12T02:56:39Z', - 'value': 5.35326, - 'unit': 'GHz'}}, - {'gateError': {'date': '2018-11-12T02:56:39Z', - 'value': 0.002232583111384412}, - 'name': 'Q3', - 'readoutError': {'date': '2018-11-12T02:56:39Z', 'value': 0.026}, - 'buffer': {'date': '2018-11-12T02:56:39Z', 'value': 10, 'unit': 'ns'}, - 'gateTime': {'date': '2018-11-12T02:56:39Z', 'value': 60, 'unit': 'ns'}, - 'T2': {'date': '2018-11-12T02:56:39Z', 'value': 12.4, 'unit': 'µs'}, - 'T1': {'date': '2018-11-12T02:56:39Z', 'value': 41.2, 'unit': 'µs'}, - 'frequency': {'date': '2018-11-12T02:56:39Z', - 'value': 5.43497, - 'unit': 'GHz'}}, - {'gateError': {'date': '2018-11-12T02:56:39Z', - 'value': 0.0013737021608475342}, - 'name': 'Q4', - 'readoutError': {'date': '2018-11-12T02:56:39Z', 'value': 0.056}, - 'buffer': {'date': '2018-11-12T02:56:39Z', 'value': 10, 'unit': 'ns'}, - 'gateTime': {'date': '2018-11-12T02:56:39Z', 'value': 60, 'unit': 'ns'}, - 'T2': {'date': '2018-11-12T02:56:39Z', 'value': 12, 'unit': 'µs'}, - 'T1': {'date': '2018-11-12T02:56:39Z', 'value': 50.3, 'unit': 'µs'}, - 'frequency': {'date': '2018-11-12T02:56:39Z', - 'value': 5.17582, - 'unit': 'GHz'}}], - 'multi_qubit_gates': [{'qubits': [1, 0], - 'type': 'CX', - 'gateError': {'date': '2018-11-12T02:56:39Z', - 'value': 0.039730922592824625}, - 'name': 'CX1_0'}, - {'qubits': [2, 0], - 'type': 'CX', - 'gateError': {'date': '2018-11-12T02:56:39Z', 'value': 0.0370616990430509}, - 'name': 'CX2_0'}, - {'qubits': [2, 1], - 'type': 'CX', - 'gateError': {'date': '2018-11-12T02:56:39Z', - 'value': 0.039182981129817634}, - 'name': 'CX2_1'}, - {'qubits': [3, 2], - 'type': 'CX', - 'gateError': {'date': '2018-11-12T02:56:39Z', 'value': 0.06468197586341454}, - 'name': 'CX3_2'}, - {'qubits': [3, 4], - 'type': 'CX', - 'gateError': {'date': '2018-11-12T02:56:39Z', 'value': 0.0472178292725369}, - 'name': 'CX3_4'}, - {'qubits': [4, 2], - 'type': 'CX', - 'gateError': {'date': '2018-11-12T02:56:39Z', 'value': 0.06971263047107376}, - 'name': 'CX4_2'}], - 'backend': 'ibmqx4', - 'fridge_parameters': {'cooldownDate': '2017-09-07', - 'Temperature': {'date': '-', 'value': [], 'unit': '-'}}} +.. parsed-literal:: + + BackendProperties(backend_name='ibmqx4', backend_version='1.0.0', gates=[Gate(gate='u1', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 10, 56, 45, tzinfo=tzutc()), name='gate_error', unit='', value=0.0)], qubits=[0]), Gate(gate='u2', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 10, 56, 45, tzinfo=tzutc()), name='gate_error', unit='', value=0.0007726307293453583)], qubits=[0]), Gate(gate='u3', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 10, 56, 45, tzinfo=tzutc()), name='gate_error', unit='', value=0.0015452614586907165)], qubits=[0]), Gate(gate='u1', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 10, 56, 45, tzinfo=tzutc()), name='gate_error', unit='', value=0.0)], qubits=[1]), Gate(gate='u2', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 10, 56, 45, tzinfo=tzutc()), name='gate_error', unit='', value=0.00197489316929661)], qubits=[1]), Gate(gate='u3', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 10, 56, 45, tzinfo=tzutc()), name='gate_error', unit='', value=0.00394978633859322)], qubits=[1]), Gate(gate='u1', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 10, 56, 45, tzinfo=tzutc()), name='gate_error', unit='', value=0.0)], qubits=[2]), Gate(gate='u2', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 10, 56, 45, tzinfo=tzutc()), name='gate_error', unit='', value=0.001631340796924452)], qubits=[2]), Gate(gate='u3', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 10, 56, 45, tzinfo=tzutc()), name='gate_error', unit='', value=0.003262681593848904)], qubits=[2]), Gate(gate='u1', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 10, 56, 45, tzinfo=tzutc()), name='gate_error', unit='', value=0.0)], qubits=[3]), Gate(gate='u2', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 10, 56, 45, tzinfo=tzutc()), name='gate_error', unit='', value=0.001889001411209068)], qubits=[3]), Gate(gate='u3', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 10, 56, 45, tzinfo=tzutc()), name='gate_error', unit='', value=0.003778002822418136)], qubits=[3]), Gate(gate='u1', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 10, 56, 45, tzinfo=tzutc()), name='gate_error', unit='', value=0.0)], qubits=[4]), Gate(gate='u2', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 10, 56, 45, tzinfo=tzutc()), name='gate_error', unit='', value=0.0033494941004675316)], qubits=[4]), Gate(gate='u3', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 10, 56, 45, tzinfo=tzutc()), name='gate_error', unit='', value=0.006698988200935063)], qubits=[4]), Gate(gate='cx', name='CX1_0', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 2, 24, 19, tzinfo=tzutc()), name='gate_error', unit='', value=0.03638715304639503)], qubits=[1, 0]), Gate(gate='cx', name='CX2_0', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 2, 30, 8, tzinfo=tzutc()), name='gate_error', unit='', value=0.0260837887197298)], qubits=[2, 0]), Gate(gate='cx', name='CX2_1', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 2, 35, 38, tzinfo=tzutc()), name='gate_error', unit='', value=0.040748317062039324)], qubits=[2, 1]), Gate(gate='cx', name='CX3_2', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 2, 40, 54, tzinfo=tzutc()), name='gate_error', unit='', value=0.06022428067792304)], qubits=[3, 2]), Gate(gate='cx', name='CX3_4', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 2, 47, 54, tzinfo=tzutc()), name='gate_error', unit='', value=0.04131394123324597)], qubits=[3, 4]), Gate(gate='cx', name='CX4_2', parameters=[Nduv(date=datetime.datetime(2018, 12, 19, 2, 53, 6, tzinfo=tzutc()), name='gate_error', unit='', value=0.061264181329610395)], qubits=[4, 2])], general=[], last_update_date=datetime.datetime(2018, 12, 19, 2, 53, 6, tzinfo=tzutc()), qubits=[[Nduv(date=datetime.datetime(2018, 12, 19, 2, 14, 12, tzinfo=tzutc()), name='T1', unit='µs', value=52.877964468812685), Nduv(date=datetime.datetime(2018, 12, 19, 2, 15, 13, tzinfo=tzutc()), name='T2', unit='µs', value=45.91461986614799), Nduv(date=datetime.datetime(2018, 12, 19, 2, 53, 6, tzinfo=tzutc()), name='frequency', unit='GHz', value=5.249846359615167), Nduv(date=datetime.datetime(2018, 12, 19, 2, 13, 55, tzinfo=tzutc()), name='readout_error', unit='', value=0.060249999999999915)], [Nduv(date=datetime.datetime(2018, 12, 19, 2, 14, 12, tzinfo=tzutc()), name='T1', unit='µs', value=52.189109032554136), Nduv(date=datetime.datetime(2018, 12, 19, 2, 15, 56, tzinfo=tzutc()), name='T2', unit='µs', value=19.451959460737445), Nduv(date=datetime.datetime(2018, 12, 19, 2, 53, 6, tzinfo=tzutc()), name='frequency', unit='GHz', value=5.295776909561718), Nduv(date=datetime.datetime(2018, 12, 19, 2, 13, 55, tzinfo=tzutc()), name='readout_error', unit='', value=0.07424999999999993)], [Nduv(date=datetime.datetime(2018, 12, 19, 2, 14, 12, tzinfo=tzutc()), name='T1', unit='µs', value=42.880247006778106), Nduv(date=datetime.datetime(2018, 12, 19, 2, 16, 37, tzinfo=tzutc()), name='T2', unit='µs', value=29.48085688756878), Nduv(date=datetime.datetime(2018, 12, 19, 2, 53, 6, tzinfo=tzutc()), name='frequency', unit='GHz', value=5.353246798006777), Nduv(date=datetime.datetime(2018, 12, 19, 2, 13, 55, tzinfo=tzutc()), name='readout_error', unit='', value=0.029249999999999998)], [Nduv(date=datetime.datetime(2018, 12, 19, 2, 14, 12, tzinfo=tzutc()), name='T1', unit='µs', value=46.880348727946355), Nduv(date=datetime.datetime(2018, 12, 19, 2, 15, 56, tzinfo=tzutc()), name='T2', unit='µs', value=17.744486787296733), Nduv(date=datetime.datetime(2018, 12, 19, 2, 53, 6, tzinfo=tzutc()), name='frequency', unit='GHz', value=5.434943769576225), Nduv(date=datetime.datetime(2018, 12, 19, 2, 13, 55, tzinfo=tzutc()), name='readout_error', unit='', value=0.02300000000000002)], [Nduv(date=datetime.datetime(2018, 12, 19, 2, 14, 12, tzinfo=tzutc()), name='T1', unit='µs', value=41.224715178255046), Nduv(date=datetime.datetime(2018, 12, 19, 2, 15, 13, tzinfo=tzutc()), name='T2', unit='µs', value=11.096548052083062), Nduv(date=datetime.datetime(2018, 12, 19, 2, 53, 6, tzinfo=tzutc()), name='frequency', unit='GHz', value=5.175820586522991), Nduv(date=datetime.datetime(2018, 12, 19, 2, 13, 55, tzinfo=tzutc()), name='readout_error', unit='', value=0.07525000000000004)]]) @@ -624,13 +519,13 @@ that backend print(str(ran_job.job_id()) + " " + str(ran_job.status())) -.. code-block:: text +.. parsed-literal:: - 5be8f39c54dacb0059c2b0db JobStatus.DONE - 5be8f394afd471005540d4d7 JobStatus.CANCELLED - 5be8ae5e17436b0052751909 JobStatus.DONE - 5be748a7e00f60005ad7f23d JobStatus.DONE - 5be746e3d4d36f0054595d60 JobStatus.DONE + 5c1a2b4f39c21300575b61b0 JobStatus.DONE + 5c1a2b2439c21300575b61ae JobStatus.DONE + 5c19dd832065d5005c4bd8fb JobStatus.DONE + 5c19dd79ed804c0056195e67 JobStatus.DONE + 5c19dd784051c50054922e49 JobStatus.DONE Then the job can be retreived using ``retrieve_job(job_id())`` method @@ -669,7 +564,7 @@ message -.. code-block:: text +.. parsed-literal:: @@ -685,7 +580,7 @@ To get a backend object from the job use the ``backend()`` method -.. code-block:: text +.. parsed-literal:: @@ -700,9 +595,9 @@ To get the job_id use the ``job_id()`` method -.. code-block:: text +.. parsed-literal:: - '5be746e3d4d36f0054595d60' + '5c19dd784051c50054922e49' @@ -715,9 +610,9 @@ To get the result from the job use the ``result()`` method print(counts) -.. code-block:: text +.. parsed-literal:: - {'000': 387, '001': 23, '010': 39, '011': 22, '100': 30, '101': 59, '110': 62, '111': 402} + {'00': 440, '10': 49, '01': 75, '11': 460} If you want to check the creation date use ``creation_date()`` @@ -729,9 +624,9 @@ If you want to check the creation date use ``creation_date()`` -.. code-block:: text +.. parsed-literal:: - '2018-11-10T21:00:19.795Z' + '2018-12-19T05:56:08.934Z' @@ -756,9 +651,9 @@ Let’s make an active example -.. code-block:: text +.. parsed-literal:: - + @@ -780,9 +675,9 @@ The status of this job can be checked with the ``status()`` method -.. code-block:: text +.. parsed-literal:: - + @@ -799,9 +694,9 @@ method. -.. code-block:: text +.. parsed-literal:: - True + False @@ -814,9 +709,9 @@ The ``status()`` will show that the job cancelled. -.. code-block:: text +.. parsed-literal:: - + @@ -829,24 +724,15 @@ position you can use the ``queue_position()`` method. .. code:: ipython3 - lapse = 0 - interval = 60 - while job.status().name != 'DONE': - print('Status @ {} seconds'.format(interval * lapse)) - print(job.status()) - print(job.queue_position()) - time.sleep(interval) - lapse += 1 - print(job.status()) + from qiskit.tools.monitor import job_monitor + job_monitor(job) result = job.result() -.. code-block:: text - Status @ 0 seconds - JobStatus.INITIALIZING - None - JobStatus.DONE +.. parsed-literal:: + + HTML(value="

Job Status: job is being initialized

") .. code:: ipython3 @@ -855,7 +741,7 @@ position you can use the ``queue_position()`` method. print(counts) -.. code-block:: text +.. parsed-literal:: - {'000': 37, '001': 155, '010': 55, '011': 50, '100': 86, '101': 582, '110': 20, '111': 39} + {'111': 46, '100': 58, '011': 99, '101': 504, '110': 18, '000': 29, '010': 35, '001': 235} diff --git a/doc/visualizing_a_quantum_circuit.rst b/doc/visualizing_a_quantum_circuit.rst new file mode 100644 index 000000000000..a77ea737d1e7 --- /dev/null +++ b/doc/visualizing_a_quantum_circuit.rst @@ -0,0 +1,507 @@ + + + +Visualizing a Quantum Circuit +============================= + +.. code:: ipython3 + + from qiskit import QuantumCircuit, ClassicalRegister, QuantumRegister + +Drawing a Quantum Circuit +------------------------- + +When building a quantum circuit it often helps to draw the circuit. This +is supported natively by a ``QuantumCircuit`` object. You can either +just call ``print()`` on the circuit or call the ``draw()`` method on +the object. This will render a `ASCII art +version `__ of the circuit +diagram. + +.. code:: ipython3 + + # Build a quantum circuit + + n = 3 # number of qubits + q = QuantumRegister(n) + c = ClassicalRegister(n) + + circuit = QuantumCircuit(q, c) + + circuit.x(q[1]) + circuit.h(q) + circuit.cx(q[0], q[1]) + circuit.measure(q, c); + +.. code:: ipython3 + + print(circuit) + + +.. parsed-literal:: + + ┌───┐ ┌─┐ + q0_0: |0>──────────────────┤ H ├──■─────┤M├ + ┌───┐┌───┐└───┘┌─┴─┐┌─┐└╥┘ + q0_1: |0>────────┤ X ├┤ H ├─────┤ X ├┤M├─╫─ + ┌───┐┌─┐└───┘└───┘ └───┘└╥┘ ║ + q0_2: |0>┤ H ├┤M├─────────────────────╫──╫─ + └───┘└╥┘ ║ ║ + c0_0: 0 ══════╬══════════════════════╬══╩═ + ║ ║ + c0_1: 0 ══════╬══════════════════════╩════ + ║ + c0_2: 0 ══════╩═══════════════════════════ + + + +.. code:: ipython3 + + circuit.draw() + + + + +.. raw:: html + +
                           ┌───┐        ┌─┐
+    q0_0: |0>──────────────────┤ H ├──■─────┤M├
+                     ┌───┐┌───┐└───┘┌─┴─┐┌─┐└╥┘
+    q0_1: |0>────────┤ X ├┤ H ├─────┤ X ├┤M├─╫─
+             ┌───┐┌─┐└───┘└───┘     └───┘└╥┘ ║ 
+    q0_2: |0>┤ H ├┤M├─────────────────────╫──╫─
+             └───┘└╥┘                     ║  ║ 
+     c0_0: 0 ══════╬══════════════════════╬══╩═
+                   ║                      ║    
+     c0_1: 0 ══════╬══════════════════════╩════
+                   ║                           
+     c0_2: 0 ══════╩═══════════════════════════
+                                               
+ + + +Alternative Renderers for Circuits +---------------------------------- + +While a text output is useful for quickly seeing the output while +developing a circuit it doesn’t provide the most flexibility in it’s +output. There are 2 other alternative output renderers for the quantum +circuit. One uses `matplotlib `__ and the other +uses `LaTex `__ leveraging the `qcircuit +package `__. These can be specified +by using ``mpl`` and ``latex`` values for the ``output`` kwarg on the +draw() method. + +.. code:: ipython3 + + # Matplotlib Drawing + circuit.draw(output='mpl') + + + + +.. image:: visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_8_0.png + + + +.. code:: ipython3 + + # Latex Drawing + circuit.draw(output='latex') + + + + +.. image:: visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_9_0.png + + + +Controlling output from circuit.draw() +-------------------------------------- + +By default the draw method returns the rendered image as an object and +does not output anything. The exact class returned depends on the output +specified: ``'text'``\ (the default returns a ``TextDrawer`` object, +``'mpl'`` returns a ``matplotlib.Figure`` object, and ``latex`` returns +a ``PIL.Image`` object. Having the return types enables modifying or +directly interacting with the rendered output from the drawers. Jupyter +notebooks understand these return types and render it for us in this +tutorial, but when running outside of jupyter you do not have this +feature automatically. However, the ``draw()`` method has optional +arguments to display or save the output. When specified the ``filename`` +kwarg takes a path to save the rendered output to. Or if you’re using +the ``mpl`` or ``latex`` outputs you can leverage the ``interactive`` +kwarg to open the image in a new window (this will not always work from +within a notebook but will be demonstrated anyway). + +Customizing the output +---------------------- + +Depending on the output there are also options to customize the circuit +diagram rendered by the circuit. + +Disable Plot Barriers and Reversing Bit Order +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The first two options are shared between all 3 backends and they let you +configure both the bit orders and whether or not you draw barriers. +These can be set by the ``reverse_bits`` kwarg and ``plot_barriers`` +kwarg respectively. The examples below will work with any output +backend, only ``latex`` is used for brevity. + +.. code:: ipython3 + + # Draw a new circuit with barriers and more registers + + q_a = QuantumRegister(3, name='qa') + q_b = QuantumRegister(5, name='qb') + c_a = ClassicalRegister(3) + c_b = ClassicalRegister(5) + + circuit = QuantumCircuit(q_a, q_b, c_a, c_b) + + circuit.x(q_a[1]) + circuit.x(q_b[1]) + circuit.x(q_b[2]) + circuit.x(q_b[4]) + circuit.barrier() + circuit.h(q_a) + circuit.barrier(q_a) + circuit.h(q_b) + circuit.cswap(q_b[0], q_b[1], q_b[2]) + circuit.cswap(q_b[2], q_b[3], q_b[4]) + circuit.cswap(q_b[3], q_b[4], q_b[0]) + circuit.barrier(q_b) + circuit.measure(q_a, c_a) + circuit.measure(q_b, c_b); + +.. code:: ipython3 + + # Draw the circuit + circuit.draw(output='latex') + + + + +.. image:: visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_13_0.png + + + +.. code:: ipython3 + + # Draw the circuit with reversed bit order + circuit.draw(output='latex', reverse_bits=True) + + + + +.. image:: visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_14_0.png + + + +.. code:: ipython3 + + # Draw the circuit without barriers + circuit.draw(output='latex', plot_barriers=False) + + + + +.. image:: visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_15_0.png + + + +.. code:: ipython3 + + # Draw the circuit without barriers and reverse bit order + circuit.draw(output='latex', plot_barriers=False, reverse_bits=True) + + + + +.. image:: visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_16_0.png + + + +Backend specific customizations +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +There are also some options available to customize the output diagram +which only work for a specific backend. The ``line_length`` kwarg for +the ``text`` backend which can be used to set a maximum width for the +output. When a diagram is wider than that it will wrap the diagram +below. The ``mpl`` backend has the ``style`` kwarg which is used to +customize the output. The ``scale`` option is used by the ``mpl`` and +``latex`` backends to adjust the size of the output image, it’s a +multiplicative adjustment factor used to scale the output size. The +``style`` kwarg takes in a dict with many different options in it. It +provides a high level of flexibility and enables things like changing +colors, changing rendered text for different types of gates, different +line styles, etc. The list of available options for this are: + +- **textcolor** (str): The color code to use for text. Defaults to + ``'#000000'`` +- **subtextcolor** (str): The color code to use for subtext. Defaults + to ``'#000000'`` +- **linecolor** (str): The color code to use for lines. Defaults to + ``'#000000'`` +- **creglinecolor** (str): The color code to use for classical register + lines ``'#778899'`` +- **gatetextcolor** (str): The color code to use for gate text + ``'#000000'`` +- **gatefacecolor** (str): The color code to use for gates. Defaults to + ``'#ffffff'`` +- **barrierfacecolor** (str): The color code to use for barriers. + Defaults to ``'#bdbdbd'`` +- **backgroundcolor** (str): The color code to use for the background. + Defaults to ``'#ffffff'`` +- **fontsize** (int): The font size to use for text. Defaults to 13 +- **subfontsize** (int): The font size to use for subtext. Defaults to + 8 +- **displaytext** (dict): A dictionary of the text to use for each + element type in the output visualization. The default values are: + + { ‘id’: ‘id’, ‘u0’: ‘U_0’, ‘u1’: ‘U_1’, ‘u2’: ‘U_2’, ‘u3’: ‘U_3’, + ‘x’: ‘X’, ‘y’: ‘Y’, ‘z’: ‘Z’, ‘h’: ‘H’, ‘s’: ‘S’, ‘sdg’: ‘S^\dagger’, + ‘t’: ‘T’, ‘tdg’: ‘T^\dagger’, ‘rx’: ‘R_x’, ‘ry’: ‘R_y’, ‘rz’: ‘R_z’, + ‘reset’: ‘\\left|0\right\rangle’ } + + You must specify all the necessary values if using this. There is no + provision for passing an incomplete dict in. +- **displaycolor** (dict): The color codes to use for each circuit + element. By default all values default to the value of + ``gatefacecolor`` and the keys are the same as ``displaytext``. Also, + just like ``displaytext`` there is no provision for an incomplete + dict passed in. +- **latexdrawerstyle** (bool): When set to True enable latex mode which + will draw gates like the ``latex`` output modes. +- **usepiformat** (bool): When set to True use radians for output +- **fold** (int): The number of circuit elements to fold the circuit + at. Defaults to 20 +- **cregbundle** (bool): If set True bundle classical registers +- **showindex** (bool): If set True draw an index. +- **compress** (bool): If set True draw a compressed circuit +- **figwidth** (int): The maximum width (in inches) for the output + figure. +- **dpi** (int): The DPI to use for the output image. Defaults to 150 +- **creglinestyle** (str): The style of line to use for classical + registers. Choices are ``'solid'``, ``'doublet'``, or any valid + matplotlib ``linestyle`` kwarg value. Defaults to ``doublet`` + +.. code:: ipython3 + + # Set line length to 80 for above circuit + circuit.draw(output='text', line_length=80) + + + + +.. raw:: html + +
                              ░                                               »
+    qa_0: |0>─────────────────────░───────────────────────────────────────────────»
+                            ┌───┐ ░                                               »
+    qa_1: |0>───────────────┤ X ├─░───────────────────────────────────────────────»
+                            └───┘ ░                                               »
+    qa_2: |0>─────────────────────░───────────────────────────────────────────────»
+                                  ░                     ┌───┐          ░          »
+    qb_0: |0>─────────────────────░─────────────────────┤ H ├─■─────X──░──────────»
+                       ┌───┐      ░                ┌───┐└───┘ │     │  ░          »
+    qb_1: |0>──────────┤ X ├──────░────────────────┤ H ├──────X─────┼──░──────────»
+                  ┌───┐└───┘      ░           ┌───┐└───┘      │     │  ░       ┌─┐»
+    qb_2: |0>─────┤ X ├───────────░───────────┤ H ├───────────X──■──┼──░───────┤M├»
+                  └───┘           ░      ┌───┐└───┘              │  │  ░    ┌─┐└╥┘»
+    qb_3: |0>─────────────────────░──────┤ H ├───────────────────X──■──░────┤M├─╫─»
+             ┌───┐                ░ ┌───┐└───┘                   │  │  ░ ┌─┐└╥┘ ║ »
+    qb_4: |0>┤ X ├────────────────░─┤ H ├────────────────────────X──X──░─┤M├─╫──╫─»
+             └───┘                ░ └───┘                              ░ └╥┘ ║  ║ »
+     c1_0: 0 ═════════════════════════════════════════════════════════════╬══╬══╬═»
+                                                                          ║  ║  ║ »
+     c1_1: 0 ═════════════════════════════════════════════════════════════╬══╬══╬═»
+                                                                          ║  ║  ║ »
+     c1_2: 0 ═════════════════════════════════════════════════════════════╬══╬══╬═»
+                                                                          ║  ║  ║ »
+     c2_0: 0 ═════════════════════════════════════════════════════════════╬══╬══╬═»
+                                                                          ║  ║  ║ »
+     c2_1: 0 ═════════════════════════════════════════════════════════════╬══╬══╬═»
+                                                                          ║  ║  ║ »
+     c2_2: 0 ═════════════════════════════════════════════════════════════╬══╬══╩═»
+                                                                          ║  ║    »
+     c2_3: 0 ═════════════════════════════════════════════════════════════╬══╩════»
+                                                                          ║       »
+     c2_4: 0 ═════════════════════════════════════════════════════════════╩═══════»
+                                                                                  »
+    «                      ┌───┐ ░       ┌─┐
+    «qa_0: ────────────────┤ H ├─░───────┤M├
+    «                 ┌───┐└───┘ ░    ┌─┐└╥┘
+    «qa_1: ───────────┤ H ├──────░────┤M├─╫─
+    «            ┌───┐└───┘      ░ ┌─┐└╥┘ ║ 
+    «qa_2: ──────┤ H ├───────────░─┤M├─╫──╫─
+    «         ┌─┐└───┘           ░ └╥┘ ║  ║ 
+    «qb_0: ───┤M├───────────────────╫──╫──╫─
+    «      ┌─┐└╥┘                   ║  ║  ║ 
+    «qb_1: ┤M├─╫────────────────────╫──╫──╫─
+    «      └╥┘ ║                    ║  ║  ║ 
+    «qb_2: ─╫──╫────────────────────╫──╫──╫─
+    «       ║  ║                    ║  ║  ║ 
+    «qb_3: ─╫──╫────────────────────╫──╫──╫─
+    «       ║  ║                    ║  ║  ║ 
+    «qb_4: ─╫──╫────────────────────╫──╫──╫─
+    «       ║  ║                    ║  ║  ║ 
+    «c1_0: ═╬══╬════════════════════╬══╬══╩═
+    «       ║  ║                    ║  ║    
+    «c1_1: ═╬══╬════════════════════╬══╩════
+    «       ║  ║                    ║       
+    «c1_2: ═╬══╬════════════════════╩═══════
+    «       ║  ║                            
+    «c2_0: ═╬══╩════════════════════════════
+    «       ║                               
+    «c2_1: ═╩═══════════════════════════════
+    «                                       
+    «c2_2: ═════════════════════════════════
+    «                                       
+    «c2_3: ═════════════════════════════════
+    «                                       
+    «c2_4: ═════════════════════════════════
+    «                                       
+ + + +.. code:: ipython3 + + # Change the background color in mpl + + style = {'backgroundcolor': 'lightgreen'} + + circuit.draw(output='mpl', style=style) + + + + +.. image:: visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_19_0.png + + + +.. code:: ipython3 + + # Scale the mpl output to 1/2 the normal size + circuit.draw(output='mpl', scale=0.5) + + + + +.. image:: visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_20_0.png + + + +.. code:: ipython3 + + # Scale the latex output to 1/2 the normal size + circuit.draw(output='latex', scale=0.5) + + + + +.. image:: visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_21_0.png + + + +Latex Source +------------ + +One additional option available with the latex output type is to return +the raw LaTex source code instead of rendering an image for it. This +enables easy integration in a seperate LaTex document. To use this you +can just set the ``output`` kwarg to ``'latex_source'``. You can also +use the ``filename`` kwarg to write this output directly to a file (and +still return the string) instead of returning just a string. + +.. code:: ipython3 + + # Print the latex source for the visualization + print(circuit.draw(output='latex_source')) + + +.. parsed-literal:: + + % \documentclass[preview]{standalone} + % If the image is too large to fit on this documentclass use + \documentclass[draft]{beamer} + % img_width = 16, img_depth = 17 + \usepackage[size=custom,height=24,width=28,scale=0.7]{beamerposter} + % instead and customize the height and width (in cm) to fit. + % Large images may run out of memory quickly. + % To fix this use the LuaLaTeX compiler, which dynamically + % allocates memory. + \usepackage[braket, qm]{qcircuit} + \usepackage{amsmath} + \pdfmapfile{+sansmathaccent.map} + % \usepackage[landscape]{geometry} + % Comment out the above line if using the beamer documentclass. + \begin{document} + \begin{equation*} + \Qcircuit @C=0.5em @R=0.0em @!R { + \lstick{qa_{0}: \ket{0}} & \qw & \qw \barrier{7} & \qw & \qw & \qw & \qw & \qw & \qw & \qw & \qw & \gate{H} & \qw \barrier[-1.15em]{2} & \qw & \qw & \meter & \qw & \qw\\ + \lstick{qa_{1}: \ket{0}} & \gate{X} & \qw & \qw & \qw & \qw & \qw & \qw & \qw & \qw & \qw & \gate{H} & \qw & \qw & \meter & \qw & \qw & \qw\\ + \lstick{qa_{2}: \ket{0}} & \qw & \qw & \qw & \qw & \qw & \qw & \qw & \qw & \qw & \qw & \gate{H} & \qw & \meter & \qw & \qw & \qw & \qw\\ + \lstick{qb_{0}: \ket{0}} & \qw & \qw & \gate{H} & \ctrl{1} & \qw & \qswap \qwx[4] & \qw \barrier[-1.15em]{4} & \qw & \qw & \qw & \meter & \qw & \qw & \qw & \qw & \qw & \qw\\ + \lstick{qb_{1}: \ket{0}} & \gate{X} & \qw & \gate{H} & \qswap & \qw & \qw & \qw & \qw & \qw & \meter & \qw & \qw & \qw & \qw & \qw & \qw & \qw\\ + \lstick{qb_{2}: \ket{0}} & \gate{X} & \qw & \gate{H} & \qswap \qwx[-1] & \ctrl{1} & \qw & \qw & \qw & \meter & \qw & \qw & \qw & \qw & \qw & \qw & \qw & \qw\\ + \lstick{qb_{3}: \ket{0}} & \qw & \qw & \gate{H} & \qw & \qswap & \ctrl{1} & \qw & \meter & \qw & \qw & \qw & \qw & \qw & \qw & \qw & \qw & \qw\\ + \lstick{qb_{4}: \ket{0}} & \gate{X} & \qw & \gate{H} & \qw & \qswap \qwx[-1] & \qswap & \meter & \qw & \qw & \qw & \qw & \qw & \qw & \qw & \qw & \qw & \qw\\ + \lstick{c1_{0}: 0} & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw \cwx[-8] & \cw & \cw\\ + \lstick{c1_{1}: 0} & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw \cwx[-8] & \cw & \cw & \cw\\ + \lstick{c1_{2}: 0} & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw \cwx[-8] & \cw & \cw & \cw & \cw\\ + \lstick{c2_{0}: 0} & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw \cwx[-8] & \cw & \cw & \cw & \cw & \cw & \cw\\ + \lstick{c2_{1}: 0} & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw \cwx[-8] & \cw & \cw & \cw & \cw & \cw & \cw & \cw\\ + \lstick{c2_{2}: 0} & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw \cwx[-8] & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw\\ + \lstick{c2_{3}: 0} & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw \cwx[-8] & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw\\ + \lstick{c2_{4}: 0} & \cw & \cw & \cw & \cw & \cw & \cw & \cw \cwx[-8] & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw & \cw\\ + } + \end{equation*} + + \end{document} + + +.. code:: ipython3 + + # Save the latex source to a file + circuit.draw(output='latex_source', filename='/tmp/circuit.tex'); + +circuit_drawer() as function +---------------------------- + +If you have an application where you prefer to draw a circuit with a +self contained function instead of as a method of a circuit object you +can directly use the ``circuit_drawer()`` function, which is part of the +public stable interface from ``qiskit.tools.visualization``. The +function behaves identically to the ``circuit.draw()`` method except +that it takes in a circuit object as required argument. + +.. raw:: html + +
+ +Note: In Qiskit Terra <= 0.7 the default behavior for the +circuit_drawer() function is to use the latex output backend, and in +0.6.x that includes a fallback to mpl if latex fails for any reason. But +starting in releases > 0.7 the default changes to use the text output. + +.. raw:: html + +
+ +.. code:: ipython3 + + from qiskit.tools.visualization import circuit_drawer + +.. code:: ipython3 + + circuit_drawer(circuit, output='mpl', plot_barriers=False) + + + + +.. image:: visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_27_0.png + + diff --git a/doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_13_0.png b/doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_13_0.png new file mode 100644 index 0000000000000000000000000000000000000000..a17071bf3efbd1392102bae1ef158b72a58f1f42 GIT binary patch literal 76726 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 Aga7~l literal 0 HcmV?d00001 diff --git a/doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_15_0.png b/doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_15_0.png new file mode 100644 index 0000000000000000000000000000000000000000..efb2d1fdd79a736dea3393b21cc7d2c19aa48ddd GIT binary patch literal 74183 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 C$eV2g(bA2mh0)^j_ zmXaV}&eT_8@etJKar$2%!&4e?`Iz)76H*MtEhUWN)}F zD1ZWj%$%Klq@3CE5U3LjJaz8e;Uh*o&CFC$Q#+Z`qz%%TpcbOGt!*d3$GMyP8VUk6 zTgaP==Lb{s97gmefL5b-WdVgW(BG-uB|rhGD}#qtLr)&tz3gwgRd< z9WokdB{^tva`eR@zqyz&MWA$)G?>y4t&{C$OATYBDv~FDE%~eW@7y^>m&mm^p{wTWfG#g6 zXcXCtAz6Z}kQ2dyHFkR2ULP1sLX+x2m1swWH3&4p;e5oUBUR z%xM;tEM){S`ISLn-`Feal;W)9)QfI=A24Lz?LgsV(V)fbRu!8% zG=~pxm#IVBwQjB8MKl7Rll8R;3xIRVD9Wm9*Ysx`O3*Pdg;iX*FvaS<=O+{XS~E?( zxw_P2{IwuAICMyL${`LvL2}RJopJlrhjL^?Qi7o6a?dc00b!s+cVctH8pB7}w0X0i zyL`ZeUhd&v%&C`(rfGPpGHL zV=8B}mGJ%P5yi9Q3Xl||Yh)zs&M(qDP zRTSL=n6Ql%f{EbEI!{wDs5Z0{)j=`m~)mnL}Ju* z2(M4iIpbn*X~*iNOboD_%h>r@sNlzYA8!+3^>p<&a32^ac(|WrJ~697lV}9iurTql zkGphKR}SZ$JMSV^VK)ed8Y8g(_3I#<(WHn8E-3nl9`Tw2`rswOelIIuJZINHp2_0s z`%g3_eAZ4+on<3LKCe9qAjvJ{>L#R)5hR63-XTaV(+B*~nlp|B55E<@^4ICXTX&kp z&I=fM@5YVs50CCWN#+KA61F0=pF@WZMFI!`Z@B34`u9^;-ss9qlHvy#&^2P8?NKKHGOHwPh3zGTu@mfoPUs%T)&q zSVg9Pg_*&2#6{2WGiaE;UY9A$98+)DKIlTyOZK0#xHHE{lwxw?9TW79x(MA z^TZt5^nwCGf6we&yn`7_zHuX~k{?6yPJVw_pwSu*3UPg*FEWj} z02Nv@PfCyTovkf3bQ$Jd!-*3&EZIF)BnJa?wM_?Ul(XY!%&5jsLHUn+JL7q+vm}vP zQ==ac?8M_FJf){j#m2{5q`HnQCU4(Q{HfqU|Pjg2*>k_K4aFK^TpPA)`Qt{P!CsxsP5 zYaVMmN@2*595R%rf8Q-RsX=g@O)G)*qyuor+0pQoxeK+ZKPij&S5-fiM7p;q_RxH| z(WL=hB4B!S_wMN%3w;+|r~LfHT@h3$$Y&5A_mY);QQV^qJ`CU85?JA`UHXWnZnd2q z%9iGJ5l+`(qVaO|jC*^t-g1QYZq{qCD(L(8lOQ7C(LN&_wq#qw$}Ya@Y=;)Wb#cO9 z;=O#~e>kofT0V5u)kKHSZziEl?-L+QUqML=gx`q)h;$sJg^_na5$ZV=wamZ)1Ii6% z*$~9AnT^ql^F8F!r44>7^3R!j-%4a9>n0zWv+f^Gq5b>zDR}X&m1AeC5G3&6!88}a z8pgkVd(=s5WMBj-ueJS#c*$s7(X8&%_Jo$k@39w z^9AY)p_PC}Fb>f2)5h%**HsP+xVLk#1LJb8!3II*b2uZ-^*u*qeT4UqOE*vdnf+3a z$(+Nq;(iK=Q=4r>58CyuU|u7 za>n8n_f1i)|4y~X*;)JXS>L09x1E4q4(|())%hea#PJpn|2*_y{H7Cj!oY*9{uB?E zuZNFQ9wS~rc<#cAYO@ZaNbE^ZsJ7X}`{=oAoP0U)>OZk5;A#8HB=8P+HN;>zFdJ!P z&_q77w9*2y+Pcj5I4+Az2a29HJB^Ztd*l-7g<{(8&a$zaYK(6O4u6Y>{`t!{UJl02JsY{p2DtoC_tID~8_aU>W4=J~|tUQZ+U~01oDND$cduWK`u2?b#85GVX<6V}Kbc7r=gJ`DAQw?Uj$1fjh=BLo7L!-F4HjrM*V? zx!!Gge#LNLYWJ^?=V{4QuvwQph~C%dcbZK5ENu@Z9c&+mAHQ+c`bKd<-t7v&Q1_Hg z&gAqNqDH1_JSMK$cKz!PB9S5&R$bjUV}>t>jm7mz4KZyy_jbV~J?@2P3z7Z<#Q~+_ z#2a}JAyrf0(O|&(QUoEWd;B=~*6W0)<9DPlDJ?7Wt(V%zLkiGLeXjj@Ykc~nN8JXS ztO-HhV4~D>txxJH3%@8vq)P4?wVY5_HDzUCLt1!d5dnk7Be(W)ZGPk0O19k<204B& zN^h0=;K}31zD-hL0sowhFt;c`Qn(r24!=pJ%jw|S>(^9jJf@bji3nE43#%_l`_5U^J_t-skPHSFUG+Ju90HMQo-tQQ- zzGtsq#cg(%Y;I~CqrNJx`71;c3;z@SHl_EkulOVV_UAdjsXvHX&@`~&L-Q!izQqt< zvbi>F&TmhGZsah0!={_ty-;GeG^c_u#>2 zZ0l4$FdOvxZ0-*ii?LJ`gzzz(mmmWwd&WCn`(;cb7^9gm;I8XE^%K(a1zPNnH!LJQ z?%78mubEd!hKQ{BZLp|dT0xh@{L<-$+-zf?ov-#%hY6$}}eH5a` zpGNpemBO6AYq-yG>0>&lIQDG&oa95Mw%u4VM0cdINI!rBB93c~jOnSV9G3%@FQCg6 z$F>hFV>zY4>#GQ!^9sZbBgp-h&@ix7oon|RR#cd_i0}bGqy6#cu}9sAECfB#b&S@&U@?M1e;EG!xjDH1We2?0nmA*XK^II=B`;d~44S5sTdq~Jw=huY{~Si_*Ei z${ZJfdM{(Gyh#)kuuoC*uX$x9)xZuWX+ZzGY15{GM^NiAaN9tP6E*d#FQx9DkPrqX z1iJ1j@?dNzWAUUEmEo6(ZA~7!r+h54*D7+Y@-D6=(zvTxtNC(P!b zq!o|$qY`y0>gI{OVh2KV@BGy+RMzy1lzRQUm#2S{i|8$r&Oi?12nNMB#*@pcT==&* zsozE}{1!+yxhYHuOa;-t;<$zkEL@9Sgu&*FK?5tE)v|@>{y$Jd|Hvg9pY$Kn$6glHyaFh$ymydL zBOM)`J^}CFy;EINx@9zpWUMZSChOnENsMs26d%89=gx|^{c$R z^=#>Yrj;%^zr9!e(8jQ(Wmt43YRx-4e=VvFCCQ0mXm=2^qSSxVAGYcT6}=_eTie0Cja9=VSG=&~#AqiXEL4q?!=3m+7~wmo8mP^(v&S z730K02CT)vZ2C_uF;F4Gol=NB^{m9P)B?3Ae%&8>Z?(N&|efku{jA=3M zmV{LmTP*CRftfW?6bZfHeaj5abi?WlWr|3`D`XWg(arq)S|Z?W?e#!JB%&4o1i7w> zYB8v|hT3bqU`xZes^kS_5zw@jfyAjlR<8IL&(6(pf~39+h?Fz>ALK1ktKQ8$JAWve zbT;ck_aAl~u5XefrWhHRMc+y_usMT$X5=ht{ zW+S*@{9Iv$R!ciWe zmJRVuzoXlbq>@Ev1Tu-_PT#KQd?IuW#OCdkXcv+-P)+SNXc4chELJ<5%(7v^FanA? z1|0}K8PtG==*S~ZoDj|eN@3@s+L<9_zZyj60lnO@jHQ$o zjxjhQFf6cpHWa)=IVb_V0Q*r+wpO`$=^gJ6aWbHGrC|TQm4cxR8YUcA9A8FlhQAO1* zTuL-l9spu!6np|!VU&6F_%YE|RrY%k^U)&-t{r4xS6vvp?7*9#oe$5<%&j^qoFIX>IuAy*^G$mYW$|ERwDDbc_1v{24?FHQs7Y7AsQJ_nMBw z%P*S3$b0eC=2)>h%QfuQuHml)jmYi%{E*5xDa*fah#9jD_cdBPBYO`T_=dt*w5xX$ zB{tXhQ&I7KxDgYUK`AagIakd$)nC4h&t5ak6<8K=NlMtR-Xmx3D{Mmz8=PTY`q1GZ z8r9qwc)*K5|6B7r(~6R9;|}ak8EV3a$ePWJd0`TCa`I?W1K4LMXG? zLx*wlqn?EzbLNKl-#n?wzE zuIg&wKqe&^+Kt`|>hS*;K~}6+%7XM(8RubvE_j6D@zsq^?V{oK|<0yJ^-h2^IYYYywt}Nd&h`{HixgxHPOlyW#5{9lQ0NzXe$xd1O3RA%TGrC}2Ro zFf8F#kf^Qo!nno$iAT4Bi&d49LwCi_iihgT<;zS{psR_2wFAJsUP;@epReESli9!J zmro{BgJ-C!+2Bk_P9uXtebxz|ubpo%`J;12^j`n^ zr9LZ$^rZgvJbk656ck6NJ{u;A`S;S?@lo`Ql%ZTZizOCv@CWE7A|v1QPWUR8a<)%!%-FuX7m^(RrmboKsLKw`)#))3ff}xc>)NCoN z7ynYkL91wS-#c$k6Sg1~|`KvTPvDf7wt`2DMA#{Pyt~9%$8##T4Ji%y!7G3oU!4>D{k=_j&vTv3|X!3eJ0ccUgCT{aAIy=kL=$t;|ZDuP-`3hrQ*1Q~X zbh-=Yu&mA+)6n5l63maYMT9QAeu|0-F9#C}4uWfvMvOvv6By6jeT)J*r>Wf2acA3yl>(B-xQsEj9VPtv3Tj4S4QS!IZO2sIPN-J}$M zr5SXkc)$z?TzlRkX&4WVmzURmX{136r9%PuW7wJLvDXRa1(fpvPX6GoDbceha=4{R zhlX11AZcjZEm-g)Bi357vQ<@8S3hp$KO?znpZME>&kwGLYN3-^rID)HP0^i@{=42n z7e$0Ixc4quo!vhC6`S!@yBCQyHIDCI^s`|II)=NO4K;bw_~y;9_(UC;=e=P4fIc2v z>OF;n$b9V|)@&>ad!Q$t2Oa+>|hfCIJQ9|iY@u`+9%p@c7ik!44p!DMT0pVFP-B@$vB$WM>0 zO)*rK5aa&vdKTt16z&Itd|i?&lpB#B)ipJ}F<1edFz~C+)ty)|t9HU1#?~!69<`O- zne`#N^DZIgiYHAHqrjBd7>BD)n1UGEs4Z96%hX4YkA(POUu7E4Eg~S0r?COIWXEi( zq0&tydxF^Fx!qqWQkGQ8H`RH^#H?|2tVwJ9dcJLb&h$QUUU|4)&o$_)V)PLxMBrTh zk58OzIUGfC=?E7?ElwvSU+OXPla;0TGOlC6)eQ_x_3;6qMF5h2#Ty}y=H!H{NlCBL zJPP4KF);Odv4nUac0MW*ZsCas6~)C%EiJLP9lvMM%PxY)9Cq|x*fRb^^11X~T)3{& zO6GGVBsf{M>%#~X4#sz%mji9#J!=?*V1E!o0eyrGfUpcu-1$j`GWz*O}I z7Ls}A%)ZhhV#%C8)O*gVlZjqIsi}>OwF8hj6dL;DrmX!VSrILiS!L6cm!H3VJ2KR2 z0^$YWI%M_~dA_BTareH@Ip0nJq~S`B`y}Vh7r0{i!NDd3dS5qfRj7e7h^LiA*wKhg zj66CJ<$JW@{yyKtjJyPk`{$RiymR9zl zO{W)ZE8?_yC0+60Wl{?}wz``yUi{!@%z3w2N`(O6YI+7*p6r6$+z5J#F$6PFA3u9m z&+?|ku!`z064^90URoKmeS0SLvPsspx9v|Vi8<5I&+3<31?`$y$H#&j5!rKKYn zxfwi4i1FndF5n$=_Ogw~J1$%U;yr!Jas?x^m2RR)MH)-cMv{!WjAOx7e)#s)16ysj)WAJW1D$(y8%FcvI_k z?Q|0Rlfh&opQ75wYS7aDn&r-M)W)CF+sVU!zl(b?_Q#LHCM?ol1kkPdm>;aH92p$8 zz7z@v=RfQC-Ic)I2K8AVcA9I08p|9umW(h;Whax~yxC1W`pJ;t!*8DKFWS;MD!29E zkgS7~4=`$Q$&&$g{xHw;&CFtO;K94>^d~k20Td6c?eh1%8LV}ZbmIZ<_qKYAseC}v ziWGBg(eq%~hB<28K%9cg4JbDHY9A5+P(J*GkFVO)F_eqM)C#sDp;XSxlf`dI^t{%l zmdvI9%=dof6XoTt`f#SBXv-#!M#600>12#@js%`*>m2IAwyiKMukQ!QTNRg z_%$%0(D^63iz3Fcg3g*wV13KYIxa2*2!(5|=q#DwF6N)8%PuWzpPc*g@DAEQkw{~u zRyv|-UYC}u+udNeN>Y04SH=LagWvyc{IbahhgO$~&A2s}+%VhKP9R&nk;u8(<2wp} z6WMhX7cf{Nac-1O=g;wWc+CqaHM?Hk0WnT&_H#3WXL&m-zViI*%{vmrD z2Q-SiuvbyXg)qK-`{MDhDeXk`ziXGpg(X`NaQj6gk#0h%yWpdQNc3D**~Onh^@|oR z97F#$CdIirFPT6bzmids&~_NbDNDc3el(1KpnkPll`E>ap;4U(q)&R>`h}A_bnDTB z>re|2I#BlmE%MToz0lUf`t@4@pJwPt6NC&0`^p9PUfhXz^Q*UAb7VN93m<}LeBAcG?nupSea+Hm$ggYfV6nR6% z#n({i?@i`e#vTZE7wIpzjJm} zLoNHIBiS@>etB>VoproD@YHMqmYrER#FALg32BS!q>Ar=2(`(2F503PY(ia<#atEl zn%s#N`5ag|C!S8K0@B=<_13VaHmxZvxO0+H&>bPkf#eD_O_ZOb(C|Hds^xt2C%p%| zb~*aW7nhAi3dazDjV1-Au&GfeAisD*D@ufRx6C|O$jF2hG1iPoa!4qi6JMVNK0~i|#ooDnV)`2_YlFkv4^jR1&gd(BGrfk1kSK>GLz-dm$CpAI>J-ZY|8IPxNm01yLQaADyM=fZ>qaNWOyRnlyG90`N zXC0q@V`V_ok2i!?K^l#Fl;dQrgM(Oy4x!qsq$QExr5tgjh$ZOg>1x;2-jqQ$R#xK; zrF`G;bL}jrotmv{UoiUJ_~!_P*o(7<_n#qdIwvwCL~rMLU&JiuqP?Shw9R4Y@ysFQ z*ZRJfrMl(reB&xUNz1KUe1w>p?**6FmF6h=8d@$}M)2C=4Wj~Xk!77j)oH9O%%%Hz zjUML}*YsJ|(+YnoffG|g4}3#{a$xKDPG&4mc8RHmT+W~D%+F7bRl!4yfM%Z$6CTON z4lP))=d1SjIqi4h$uy&HuWku9S8Bt%cs^8Ytd`b3A63%>IY4Bax>VOU0P{=ava}ZK zRc-4smTj8YjTs*P8lmtZVPSHTzL_N+O+N}deTw7R6e?^V=mJ62gUoOEz}QK|Sy4+G zYEh$)AAjS-h6$eeG60QwKWl>EP|2~+PvGHm*tWg(`8Lng`u5$HBsPY0thO7LBu1Y& zk?LN!f^(BdMM){CV{4C}q453L&~V@zfwy(vXN@B46p5^_4Te2}i$k|=9cLc$R5^3v z#N~@zDw@{6gPgs$>-Ef;M1Nu*DBLfX*p-?&jv%Nw>rVOGh2Oj*VO152gm-V}W`CHm ziB>ZHDlVHhZ$2T(PX7HkZ4}XuN$x+dY&t#bI6p;bB@AaHjIsB+2iz&ha1B{su;QN{ zo$9KiGJI-%z-}7-d+&p&^{VP!oqC**;j>fao|_+Qa4<~hCLD^dqjpUEcwr1x)VkTT zAF*H$oI1uE(mnBAe9@qgiAF{nH*aqGS?Li@_`gurdV020GP~+r0q96Ksw(YQ{%Pql5@f(i+0V5YI^+Q;5j@}6>5!0b%)cB**Z)*v~ZBgf) z6`gi(@OU4#fyUyvZ*3gO=t9R(fv6Ip?g_cBUB47;uAHR27YPK30#R_zUB{k8 z^-kM2cJ$~5)}IV|(UcaqU{&rpG3D?o#}PuTh&34=4CexJ2ZdRK8Q(G&NsHyqn(FE@ zYRB?X!t{5+Q{L&*l9em(YRMelfFzE~g}@b(p1F!iU%$pj)fQ~F=c+I+k4{gRwSw%D z(=s&FeB;I>EbXWp4#a-0$VQzE)a7%V_=acggTpWGFvpA(bY~gPkHD@3 zbFGz(o{V}UO=scJ_(i_?6Ux18l5#~_6&I(uKJyjiFVZ&1-NWyFMPDmOth>*tUz za2c*u>FrE^e8uKF6Y=cM1`V>7 z$yTkS>TA29C$}*!?h6Ny_Mr5xxd>PxQNCaepm_0@(cW2~MzDG@Z-4DVv*Y`^yrupD zurcH#=B?2Se3W3B+5Vs@HN(mzi~9|2hjz2QTHqCJSE$$za>}0pJR(ugrjR09qs(2C z>fQuR!xi;m&_+#47?zbT`-n_h+d@*pxw-jccHVl8-9+d?2KMj2iLP_Tj2S!=-2&hp zhQ=-9KHYrsBr(be&BduGZ>@8{v9?;n!*^MZ(sWz84SP;J&nv11W)NR6UnGl2{7h)5 z?9bX8yFmM>7cLJvt-dp0H<_KL)27*5KA^z0UY5@+S*_)}@;D9NtgGjE!uY{OcO}7tw?<_;DaPDx* zdrFY*Vy#)gP!@{EIGu%oM(j}i=S7uHpE!{ujupJ`(@wWtXWi2EHB^%FJ&?Nz|0mBi zFvQM@2UQMt3kpAdR$FgwB2P6nEV@X1iPi&|kfD)j9yoks{bvGxn6lAP}%*rkCdh6P~#0 z%J*A(jYkcBf@9qcFJa}+Eba!dc-QerNJzB7d$}oAmEBDM>_>8>q8BINWU0OVVx6-C zO3TY%JbMP%Qb9k(v=o81%eI#eQl%n^--0mm$n5@H03}JD)w`LQZ@-4|R3FIdcfQL} zTW8%g!VXRx?RjC)9%JH=h`@Uib7K8)9i0_2{;y7+zWnKFO{6ZYAuap41(zRXlhjuK z#ow)aP6WRO&2*%8zZ9AgnvnCCtK{J}(Kmgb5{`~w8pDD*cAVXa(^VpKU&Gz$9X)CG z?o$UJDyX;j_yJ}pqdrEm)B3>~JW2<*yUbCL7Ai)_+4IkforvZ5fI`v`vC>7yvWHL3 z`<^L9sCx(5#*Cvk=-&W~_{Awv?dHyz^Ak*k%Y1p`7uC2eW~6!&HGoX8DR-j0)2Elu z9zEKZ)NSE{1?tiQA;o-Y5<&1{=&&nsev>wUabf}4_Xma^kIMHxFj!pg$4AX4w~7)T zQ7sWEFXS}P9I$4EEG!;l|7_2wTtR*aTh~ZQZEzGqwuxApm+`his-1_ee!`;$CmG9O z&HvDtu7H%6XB)m+nVRLaaAho;5F2L7*C*z*ic|t0*wa{8NrOxVA__*2Tl;K9IPIP= zYn>IvMR|WkEkUePrxcvN>>EsJmyY{$+m7I3Ks+!_`K-`pQVPoZ$RrBAS|41NE zcXRrY$%dE`R#-c(>6c%`WxYH47Pqr)z;kG=xEq*4WXh8wBQu^pbs;`-_5L%hRR^F% zJ>~2&bLL)}Ip~Jb^M^K4mlVuMIx^?XT)}N~&Rb1&L>DnJn@ta(4^<;!9hsS^mN)W? zTnVnU;PVrwkbi7wNNtS<->`kp4+urg{D z)c-(8%XfnqD;%TL0MT$}qK0WBm*^0GXB@-luLR&Qe{OdD#mCF2pxED+Jx2&HH0F2h zCasi`mY!fpiq*QL!%3mZ!HZwTo8Qy+WLwZ|f<6>-eUb)Fa>MEhaeX@;Qv-qvi#6pl z!eL&RNfu@cUEm5+@$$*>v6vd^A(uSAXB10sId#Cy5Rj8#VgGrvZlvbwI=!a)F8M~M zrVbu8DpY(t)|iz;-VIQ4x9XbPQBF5LecWNT6}Ba-5`{P;1qrAYDEp0=)_3N-?6V71 zjxETR*5z#_i|(kdiR6i4{QP&;;`? z+P5VWO0Y3Rrpp1(o=VExMzpQ&((7I~=Q`PW^M&LDV0d4%dbKMJE2>AL2q2}01oZ#Z z$;Ljza_E=b1=FUTe>UP|!$nlMwx?)-u{RRx72#NC1-tZBp8UY$p+egcEo zmWPC!%t&%7L6AAv_DgE1c^)AS-|5*GZV->=@-QFqEqnD&AD;_!A^@UWTC{R+tY6_Y z8nN(}Z@$qzAKZ;Rwu$?4u;Zf)g}St#753-ldrC^CYlP}jBQUV2Yc4ezV$EUv78j2*q_DAUJL6GQUHA~x4L4)vs;a19!gN5P`e9J;K#Bp57$MP$vFG$h zXX|<L^{H!5iu1VR-r6<;`)vn}c{KS&N27O*)F3lZZ)|iNIrYo&w(2{ z@Ww2Q*}HvwPHxa)%+XsI(}VGkGFG0Y>Nr=MLyvI4D1rwEm~NsWqylgRQW4O>fj_2s zc0v0)5ft?p^>vBNc8L9?}ZIsJxYM+B! z4nHqn?jkgZ1{?jH*L3-vp~@S+?aoV@`x#@`#}zE?N~tCkR=awVoU{SN8N@a5UE&Ot z5C=4brnGAWMb5=|K#|XOIXu<|5_XGok$>-zdwaE^;>NHB-kf0>J6){-RFl4*`LlDZ z(^O;9<(c}#xUpqxtl_f=KRX9;guQm_)^sqi>mAQG(YZD8WYSs+{(`SY$eg}5YcEpo z^`Cv#fqY3PCzWGcwus(+8#ZCdk|IDgUmJ>R7_Cly0GT%91p?DcI3wAS^WIQ#a7wR6YWC7!xvlG zh915BQm6rkH(!|6Ew=*Y(1fL=qzD1o2#=n0Ja1nnHI;Q>YGU&JJsVZFPGK^K6re`` zaMb7#KVM7c^5`6_yv)Y)>gCIO+1Xc}%7=sJF!U-j{K2NI+^l66IeWYA;m6Xf0Y364 ztUG=c?t`+_Bs@phqIB?wD)k>cxaq^0^Ke5qckQwtW9=q{Vo0BJeRP(DKM=z7%k}KjXOM)L)^af+CxdM4c1oMr=nkIR`awVvOJ3}7cImaK z{%FM^ZLvn8#gGlI)V0$*aLL`uc-KKlmh$c_?{Hw1B*&Kipsk58Wl2^?~?fm-SX>+Rvw(l_+n z!#a%S@F@k{u+NhURff!w-wAsJ(r~C?L0sE((oMBtAfCl%&!^(yzzscO7W%cbY}fAH z-61I9*pnVSDmk6YhBj6Ig{V4s zuz{`k{#pGW-&ITno@()BA%T+Azp-N%^$+gcYglAK_scLKnsI6QKigimH?g@x z-{GIWnUz%z3axmIau_4v8QbgW`?(sDdFZ8AetTz}eWh*T!>@}EjM902@kU!DheC7~ zVpfXBQtG_+W0D1U1(b28?H;q!JXsu@!mJ-$SHA>u3r?Y6i1?W^D;^`rhk*vqj)@|P zpD&8kGSmXvLLTzyMd`_=%+}BICEEwOg|<9}Sx3q)+?}yg7G}=2s5BI-6% zX{6;Kf)~hjv5j5 zc6PU=S>Ms4E$)md?^M%LyO*w`nqLYygtDqCGPgO~>tD-e%+=#~sW3V2Q6LmfVoRBk zyn5l1ys>Bq5-wgmG}cWQ+|Q=fR{aZ<)0FDJK>DjsO10}KR(QhpJbzccWPjI(HoP~m z=5nFKjn02Gua_u78PQyf5CWGY@?W&=mO`C%*jTqKc=vs`n+dFgXnuZa=4&3K@PqEH z$J@xPhtSq3a5)||Ybihroz;Zn;!Ho_l{Rp)tt_bFy>2S!LXhJSDKhs;^VdwD=`DLL z1ui4;3Thpz-{R*~mY&AL!)uCXYeWw$r%Adm)nqCNbeLi&C@cEa4g}zzts#A>G>}$} z7dX_ZQ<2h3*96&=%@V%FM$@=TW}1S8L@uz zC-I7XrmB69VKL;2#6Bes^C;{(`bhGgayOHxW#XZJt39b;xG0|at&vsk($C6x= zG7Y&HILL|jQ^R!2%FEBZCNxU)yv6!l;R=Xsq=W^|>z|h~u&DXYX^BgX7XHH)Roego zcsYs+puGP+rC<{w33727GjB7_IyPHWBIZ^MO0Pr>33mXv2m{=arjSCJhz_dmDMv;> zqe(#UPV}Zlelxvj7PIhPJIHn+5t46&S{i~OtbE;}e$sw=bw%5_a6_B4h7Lv13D~>< zi74s|x<{8}=h|FIB$iIA+HrZfJQpu!AV#r(YWdVn75W`hS9Zy@$l4LoT3X_T?p(WCi0&HR1{_+I~zEZDfK+-53>m@L~xD_4HtZ1u6B$>i+g-Wg*en)DzvC;ms*Q~YARB9 zfHp4oZ(gYJvbEywK*jKP7V~mjLi`(QQGoNSpKSJd@P68XAzOWzA$w=sa^V-{v~UP7 z(w@v|O17aS_0+|5xdRo5sSXWOR29C!Mq0UUzwaMV`rO8T8O`r;O61LF%5iaV;|&ay z`t}9U1z=|;E-s~VPM{ATPNxPX8lywOeI;4{{X2g8IS0pk87SrfRW8{!N-goVHBLA1 z&~^#RF0u24-3hhuBxR}0n~eXYd!bS%A;gzvZu+f_=0fT|5KtZeFv=@JE-*@Y$JUQMJ0k?PrV1ZB1Jw9^+kwCd~X zB=)d#?e&IP)%3US>dIO;)1mpQoD6u|I?Xmu_1%XbY<5BhcIAv#t+vtRTyTm(WQ@s> zbK}g*8{~n`9-*EWcxPFsPZ3WSZD_scGum*0fY5o8WG23yl;D>fxA8wuJtL&nlC1-c z@0u*NW}~9zsVGN=RPtL=thGnfbQd`-COwIe7QWHsvVr^-I;u$U*T%^4vA_Dhi)jyXHZEI zx=qyxc+Ql^wF^Vc$iZY{N*Pc(&kjJRM*sc~pDcciQEC>ANOtx)cyD;imRt4B!^^;$ zjFfT-onpcG@7m>KL!o9?e`4RBJ>v|8){}>xGQ!6Ou!uYVF7Y&<9&g^wPcf_SA%x1b z_Iz;f-piEDI+Dx}PwrE=pqspW8f5_e4#`|&!z;nptkdR!)0mEzd|N(aHKUWJA8mpp z!ZR^{P{^6Ni&haLNgvM;w8V;O+515-@u@=ca7_mfW`xW3+5MMC=|B`8IWj2N@ z?ECizVcWO&8{%WA)F+^}rfe3l=^kTbtn}B{xtKFRWq#>;B*cKi3fcGDt1bL>0W zEd1geRm9*cfe02ihi7eUG_x`%f;+!)xpU>y}JD>0GpVRGj&Y3f~ys!8B z^?tpc&&T#0*PaGfk+>)35%kJ4(A6E27|^dKQYs;=V~ZKN*!x9tb7ErYhr`{J{0Y;< z%40unT<0J&7~>@4aSumzB`%vqk&24$PL8#7E%_h|8aU7$JgS$j6)VU2jyq^5Qvj62Z)j?Gdy0@Zsv` z&yml$tXR>2UuUGxff);`i#NLNJ#gR@!B_FmPyhH?T~gHe@elI8{JMW&{3MQMk{6Iw zmcBVK!yH13vW>SlMSGaK60ck{@W7yQXFWSoREZQ+={qv{x*&*OKh8>Dlh~0%4*>e` zgjl7394-UaomsBpJ|pg?h$0GQas8+M`uC>tHqE;I;94A`NL%I$MWw#J@X2fS=mCU) z%poU}GE_02>XNgM(_KB}G62)Xi!~M=LbU?vYs(%?FG$S-fOVqI1}NU##%2+&7k+3x zaA1^vuwadiwX-{kAq`t4xww+jv_*5Kjho>v)Tm4->1%9^`0NGIbIv*g=aVhD`_Q3F zFhC|F=;k*iS{mSoGAejNlQ{m_-kX*NkQhHl)z;Q7En^SA`smeoe{(*I-LSb{^N9By{0&d{Tl~=XbfLp>>O1&kZfY|fvE%clWnp%!kUkVGa$C#Uyl!0+MVcA&pIa6# zGa!lva6u}}J=*VnkvX_)TDmJ_u4t&w9dL{G$8_}Q^C&^X|=I3xY5ZS~2 zfhvnDp$M6`V1aPeS2t<8=1l8`eYWRMWNnnP%@vzKlIg>7zkSf9 zKg7AAx>;=?LU>&?qmcFWGcrn!`I5}5k+7s-FRd9{B?gQkLsr3*WsJb)sOH$H2&w{b zt*%e;z*`I!VWC-+UAW*Ema(V9jP_B%<%Zfa$*X_NzJTZG_()TyvBdqYjxPt1iLr4+ zo9ygIuU7l|+M~$iXXQ)Vw8mqkR94)rS{7~ct@~&)sTIQm1NFh~CPYM0`{{)}t@9cd zrt!jh=V{CDzO?ha(w(ActHD)zzVM;i;AP59cNL#1S9SX3*)_a!0Cwd^r!>+Zn7(Gs zcaeF?B%a^f0_@-Y&Y-}2n(2vi?pZvvT58_fGIj3#;Q?>rFPD~nU=M_8rAPgC)o$Q6 z9UUFCfn!e&lYR2^nCVq>0YP~k4@W;D&kyvjA6ov2zAHYwKDc$OqJHO54m=lrX59}I z4a?vW=N@Y9=+krBxgRBm`p!0n<>pA>Q#n7{70IgKYr_qCWTmC1QW$hFT8InLEMYFs zO!}IZbe;`y9DGXK{G;-7X3wr?b}hbkFt6#(&Inhq8!*{`*MdxemDN?UYb+eCeZQjU z64@wPD#GeCV8E`MdQ7xuWl@UGb)cOTA9yWYJ|3q8r6<>eoPwmB&5&6lQla3eu3%W@ z*xv-Bl0W(dkdcU{CLyimXl* z-)HdUCv%;MhOqAT8KZ@GX{e)+pV13M*!HLgETs@U|Eb{Y*}WLhzi7bFe=Gd(!~GYf zw?}jqpK-1EttO+Ws97QG48rZu8Py-iRIe94Xxg#6u-~KRAgD^Z08*3!dal#Y;!nD0 zKU4Mw=XBJea}slLcvnyA99TkW&uh>r3Wai$CQTgd?C2gze*0z38Y;2?KW4>nNSxG> zJ+2eVZxxJt^|I7bdHCP~!WN+;pod!YcXFwUL$bE++U#3h-a&y8K{e0GyF$Ugbs?i ze$odNiIhdtn=3Y5V=;||Dk|?yJMCnb(7tdR%DfkxLG-&CTTNBka!BJ5MOl|acU7J; zcUb#J9%AwrTChMrrnGFgsO9*x$i8tSC9A!~s8L~SVdi|+i0hTBI~rL*!OI@Y8Eh^k z(vnByZ9GX!1qlR?jYIy$d+*{gr886%%1@u(oz)0ng3kMGwVmti?3>X0Cl07v~MgxNr;FJMM;FYN|vRtiF@{!;SwOd0HZll;-Q!mmI zpRZ_0OSoEOrmn;`j&(Oi)Zs{c8B@m}pYH&9m_wZicA9H82XzF2VgSBNmp=WJ1lhU> zr%HzQnU?L^L7evVC_O=`%cP3E`}Ps499$h$h%Z^vr;i{NX~($1fGOOx00gxqUJ1I$ zt`UMj|9aPdTEcbWUu}T41oK~6oqFRfye>!wGPKKhA05i*cet@NvB~B4Qgsp;QE_=t z{fo^k=!I2ve%|knLd&3XLMulPL;4a>c?ujcT`?v;a{Q}kW&nsd zS(vfWd*Sg&Rmy$t7BxrB1K%e!XRK3ZOO-@LmoKf><{o45-Tve)N8_Qo-MPKrAqsr` z?DjGaB{UD3iit0JzoT%{YjrLsr*}#=1#M`1k+ql9zFrtU1jU6QVuqi^oy(*xS2#cw8}?qZf7rqZk_fFT0Y!9?*^j0N<8h$hIH zW3~bIsB66t@C8)QD+KjP_kMq!Ued-Uq#ExtAE2S+zis}G?zy}A2PVol5GSyIkL`Br z?jjQ6SMphs)uL@5i#7G&P#+*ZlB=g+^N=BAC~GX~F{L1=`syTqqKz z?VgP47Q`TXgv|zhK3kfzY)C7ey*@9hMhZa>q(D1zcIsTT$`dD+3xzT3JSsXG3?@80 z9BUH8E9JkFEo?{9_T9&+Y7ORvk=}A@9CYT1)lf6bE%dm$|iaHS+G0Zo`fI;;OEpkx(?#$oUT% zSm}HDx(*~1Gt8uu;uW4tS-!E@gLlW;n%B~Y&dltP;dyuHym>FH8JwX`p>@p5usJ$P zWlJxw#8anMWUND1!k}({Aw_IwEz9s}FXyfhfu8P0!fHR-S?)QLjGSJE&9Pa}v@ zwc5Jn_wr~Lq=nZ{PV!y7I(*kIkh5Ufq*`ZpcT7)_J9d~!Ir|(A{4DOq$~P;obj_up zh1RKf^vGt;$@6S<9Fs=WK(rq{A~p^C>yms|-j}&D_8YFa*Gip{(9mMyeC=6~?Oib#(tTLsjb>$3Sr{FfQ|aXCls``L=IAFu5-*(E6ZU*)Nr@ zRMnA}A-cPB3g^T_0>;)0P&d3~qZ_nq*j@p>8hZ^tT`DxI!>f0c* z>d;}d6rITzL&WYn1Kq5Sbhglwj?A3r=XA3TtN&N)+TRQ{|C8dlrdL)Mb#=T3bDh>$ z?X_}6e#prbxNV!WUYn9iaoH>1xGz#zPCbi_iBZarQn$>w;Czfn_J$0et5;{kI&!k{ z{>lVVI^vI9o43@l^X1^04)7g z9zCy>8F54e>mDIy?(U5VNIS8-wAFJqEsNZtP1gZz3?E;SLl`9 zoYY)AC1<^yo-QN8T(Lb zNg~2ui0Kv#+iahehtGbhT8=yvI6!eAzI=;<;+dCP`b&v=N9CebvL+^6Dj8{N>bYP+ zVSfJIR8>h7wjmCR#Mf0x(b1hR+9gt`?XRW~jq!X3e0HVXa*(`pZ*Ytt4OW3#BJC4%o^KM2yorZgx&4*NdRN5 zwU-xC?@^%KDsD8kg}VYK)o`Xe`{4ot=)OE5xejz-1+$FTLnT5N-v-kKWd~3z4_3(h zy%JW)+`s=JZJE_U>%^D#!+NNSf#cj-(JiqUn4YPX+2yVofxe*aY{NIJdg|*3<~=&z zJ6)_zY!wL?x2H%{n(`U|VIxsOUreXJ1WA;rpy;>~Y`qzLuxfBE%(Rkl;1lk~vv zC+fmD)VKI?ry*LY2_Yqs}Y zTsyh=TvqpB!yOo%E`=KyHD68*1TIa$)9%xTdQPHnMd?BPd4_TA|1Oz|N@(9|#oyR_t z(u_XT>PY83qd;$Q9IY^sN*_OdEbN-7Hp$~#9T=!Ade^>vg}jmV$c!OdDr#2KN0erC ztMeh^X!xkoG8*bX^6sLK6b@_teoFI=U*an%qtAMEay$QFQrw#jw@)34-COFOTU;ER zD4%!#^PN!%8=JM9X|j6K=LX{LC0k>-LXVyscVmj*x|PDT4&|fTtyS;u5$ARN>ebO} z>Jc(xesUNuS=m?*ziqExOHi!(KW0NAxxbzMj2{usu7Mv#xN@hVevyQ{!cI|)esi5} zJo(x4cD<%bsrJHjT^WS2H)v2X&rdlYN#_31;bsE5g}TkZG}BDVW=H?A09;l=f5BGB z9w=AS&V7Eq)vS8gz^oT(Q}tnB3fajHt5wsowz$p1|_Yy^6}$$sNzdnK;P@unEb5^78FW8adeg9mupv{SY zp*kBWyWZYY`e*5brHRnDO%Xys^BQIQ!PwXghDY(b6)sTK=+7cEG@R!k19lf^xs9x? z5-wZvJZcxGgH9awlsS~;R_-r2Du0T>A$%AE7^a}yn0GS0ynPJ+pFy`>Y!YQ<{E2Ux znb+n@%=mP-+I+g&ByHKZ+#Ty`>x<8}d5MPX(megI+*FtSiNUx3MFsQM;Pn4Z5&xS9 z`>$d0sPkUmG>jtWuG-mjh~6ga3v8SzGB9wULy+`p?#Jh7Zyj7^&9F4`nD zMrP9P1qK$-<#PtrJbemf`g4%kNu5|ry|7ul+Ssh2`FE1c%O1jzG#=*3IHcC7YTCV3 zsHcIXaSGV9iP7)tH-fdpqlW5DHzP4?U1IOyJye&GwuIn&(4a^^<_-C2{qB#}3)@ir zt*q*BpS!CZ10<88(^7V6s^=A!Bar7<1M$EU>&JK4x37|R4S@)C8QbqjsSp%+RjDMK z6bJ6uk&1v%!g;ma)AK0X9lhh~)x#K^gul)2LSCLOr*gI4mm+Cyn6O}@ivhfbTA1{_ z6N*caDm`KU?4ujol@fBBsX7P*RIXPtVm$=MqFtBHyLVP0?viY&)|{K}dx}gIMIU@- zOP4mY@Yg4X37kp7;9n1$My~8X{w`;JQOHe}_xj39+&@N^v|uQwqx^|u7^V2Y0Rz;$ zArA%7>_<)*5LD@jW9Q(2dM=7b=Kh-s2!hbVzKys&3x0IeT#Tz0M^Vq#rELo{mMz+k z{Ncs~lir=b#^u4q%eKpuFzwf?*(|v9H^}_djwZwBjGZ@6ub|@9`>L3pK-~iehWmN@ z_~5lUl-p_Oo-M9Ff|6ymS1FsT-(6fq%xZh3blV=~;2JzRbtV6))7T?8?MYbahgb*| zgFzX2O$anOTwZ_hn?FHBHL%M_AKbqm?d+@jk4{#p#Im~k7v0Xf&+@uT{`)~4MZ6?F zke9DtKX~Rv=GyhP1pPdg8yGDiVVv99d#y= z88P^0KuiQm{Wh1>)+EuEuo_uh6HbXar&>JgPxvoSoA;syTFH=z+)|d!J*uZu@qX z4x38|Y{bt;nK@y?o8(iUMI|oj+t)@*1sajkl_(@-!TlgqJ4uO|Tek^2&Vxsf^gDMF z7Osa~-PtJqKgj;+9%j3A6&mY~%{knH?=}4$?MVFsB zbC2m5%`!uoF~fuip>zzhIQQrkZ#*dBp{2LAr-(j9#WJ%)&O*fWtv*1dQP?_73qL%5 z>V8VO62$2g^xs-7_Gix$l+6_qgw2FZ0Xc_8;N zffrA3Jctu|J4Azej~*NRs7)&8Etxf|hayC#Y#nK9Z}bB-&J&ulx5PeFCaKpkqQ&}C z7E+$4Z0jduo9xb>TBDY3p-Esx4@J&)YTpToqk$q>9#UZvU;^}7pG!>^_T{U8{@tmb67{uq%-ej1RsE?`VuD8rb%Y}+U zw1Bzk-yu_}e|cFKa_8s3i)cmP<3fw8wh95lCaLZEnKQm^l)VVzi|cL`&EU}l+gpmm z*M)4~{-CllF)L{7RVfKjZuXOR`^2qGtP1Pve(1QCYrrnfO^8jt zA-FU|U#Mh>#WH9n5XJ^lCaH~); zgc`bi9Cv)*?%k&^Twq$#wlY03SgFRzx3m>ZhAObij2XvzH_v2$DCYs+pwwzUywgr+{KFw#+&-=FyWhSU9x-K%(->((tvRf6#&6qD%G8G!;iq* zawc7r$4N^6yMbZ?;y(71YwlUrE}Q4}1Jx{n7Mwt;ve!ATe| zCrRp(vz}M$M!S3WY(DYh!TU>V(1RB8t3MC}(;;9a5#5i&zX#r%qt?Wv)b z4*_T6lEdGx?T)m>qM+&a5zbi>sXw@(*bD~Jx(UCm^3uZDUbN$UJZn_hNrgU9o%B1|LDH?p0g{v8ZLU)Bk*Eq`oz}y ztp@MZR=LC5$&jmuNu~cJR@#*}byxVnW`bV_#P8A}&)a2ZG5xv{V*7 zmJ=sw()=tmQ~CJ`8^_?kVg0n(8SPSfnp48>F-@aaU*2`%a;~FS#Oxg{6UoSx`mNPi z44_7734;nV+qKWLvgFNv!&WLKD~(v=-x!X}DLeT**1MY}rRL z);yiWd?RpUG}%Gbc3%ELs9jdFSLw1EIwV%#XV&K5%w^8BmaME;0DJ1@GcUZ zS^#grMp#3@Z5>0RRZuR2#{~vXn?Aiam)xO6q@TFd!5O6{_q=g!kr9Ux5PD8?^e!<= zWai986{o*BXno1cbtA(ROQHAkuo5W$n$cNec#HIF}3J2+F@!VSkY0( zW|oDyxdUMq@R1ad{f@-;nwoF}4Zh!16b@K!nNy#Nn*bY-Va-V!|w_Y*VfhsBO{isZTt41tYajpJZBD<6zyXXg@uK{N-gt2 zim5+<8=xYY=FD!60NzAcJh+XHAu`aY)c>-4M|Q-H9p}uMLrV3Br7imR>qp%Y=*s4i zw8V8({{@e?NF}}W^j^Mw8=n?_{yqx2$5mBk>f5lHd5)JQ+qv|m@nQ@1dmNyfd9A>G zve_<5LCP#;OYU--nyIpynwgZ@CX+KYVgmlmqY+j??fZ;_@$TLHifBCCcv7U+mX^2> ziuMQfW@_x}lgqrYhc$b4dKRG$RF`fAmt?nRT7_N~Q)DONK0SG@d^b3<{zkrQQny2G zC|D3+$n(|m3@Cuh_N$9O@px=uO4K;cAyZRR6q^`Tcq@UK>GgfQy)kgN`lzM1bTx2z zSmVe%n-OdNJ?g6Ho1=NBL*)m#T-#kTV%PC||31Hm*~GC8D1h0l{9JO@w>r}Lpx*!3 z`|)nZ$FA7@i%sS&TsSdlmff_pk^8QbX98AIbV!H^Hg9gBh>oJ`64SYJdlk6!$zt-{ z;j!DSyNxn6t#BS+LMug0MnaWvbO6pXuBYwCrF*ZCvw~%-a+38GYL{xX(heC4^4~J? z=iJ28j*9-m@dZJ^>4=e{hw7juFMpxG5`l310-G)UDG3FBe6-4)+pd8dHvA|tGc{$B z+LZDZfLb)JqNo%6{Pu_l7-=%&H9{_<)PQEnU0hccgdh-^Dcq40eJSCkymF$7p|>8Z zRrvVF-RVdIWrB^I2Fse>#WZ`{j+^y5{t;x)`k7QSQ0N@|_-m-S)XKE=^$W;B00Zh4 zY5EJ8=NB~zGojrF>&j?&(_?mjr$|OyciT8H~~w{ZSa#cuS9 zn_%zREHfqL259}+v%i$-0mP%eRSxWtsFGGvL3zkF*sNKzn^jv{@h6C%_<+3`X~md9 zpH)!#D=7(Uhhn>SVzz_uGZVzh7EAm9r}VBZy~KFR!PMC14c7jJ>$Bs_FyHhpZA0QA0X(iHmxrJD_YZwYY~zED;=Eh&$++RsnZ9 zB+q>J3Li+>_2gYGTqxO^rO! zjY2l=?}Fb7)eV}rH(cp@KekfNg)6z)M%Wu5oO(j7gWMN@8M6ZEVCaJrY3d-&?dQ&D-hG_Hn;4 zs(IVHcPlJ7IIc@^{T7ZGy~A6`or)a~&BXxg_|b?rkH z9{QUmwwVGsm@gEnNFX0#&Fz>sPB^61_y4D>f-n(spD;m#YHxBgz9a-Zc{nc6auc*+Y`u8h|{Snz zC{GAj(!mN3DScybjSYbnEt07v_H4+!c4RyXJsLy|I-QaucEhCj5eQN{D+-RF`xPJ; zpaMi5gw3tx5pJX>n6L>2j?1zENrq~A&fgc962X(div2dCw|j6z#6%`wuD)+o+KQnI zj9ZaVUjz^SIp(d)?AgyC_WZ@%>6!<}Wu>P}n_?wz9H?PWUJy37W!J7xAJ8N#0MOL+ z5feIY-wyXXlbzjrdUI6{T*;xhxHnV`Z?B>F!Z@u+AnBIXUry{sljo~k0mLw_e>crv z3dKYwcf)e@SJclu3ciwv7Ucw}j*Y{tW{ig&!z1uC<6cNYJL!mhZBobYo;`VTlcdrl zv+=brU#237Qe@D@y1Yl-mu%;YV_HJ(*y!7DNns)!a@>q%kd-{5-=Zy!*vJ6;!96q= zONh8`&VjUHLk}&j#Xh}gCj!6~i*Ab~uNj%K=t5Z@asCmEQ{1;nUbp441*ki z#R-KTG9-%!LnFjINdR!DJb!$sO}_gsVPZE?Z^*6203-rs=2N7j)?51az(4drGhQrc zSM@8WWIo}aI3?BA_kV?NE7v#?xcM(lk0gVpCpTtp903BuDyJa}k9SH_C3&V*D~*=l zBbmp@9~J5@^QsIURd~!G8rG7CgQEQT%kEQfAw~6SC9d+?s-yka%M^KXg`>1fDvG*E zB))dN{lkVoL_5s7mm09kq15$sY$tyI${nr~eFrg~p40eVBz-bJLV+Ie#c66k=9SVX zL}W#(%nu|4&`UG1YgAn8fNkQaZ%?KOM)vq2p+i zX3}j|>4}Ty&#&`?n%zENZ%Rt2tHI6+=y8WHo}a-!J-WPuP3mQHhZx}gWRoo2toGAS zl->JpjwWJ>vXnd_LjG|8FG*iJCs|upm+@6%+|pk$Mab*LEafju(Jw=%Oq|$3zhU!Q z49>^{a~xw@#i;E#N$Ty6^@Cl_PRTErO)m)y3t4**ZK9=;~ZPsBTZw!}H$ot7vxCx9wBvkH49;QDhQf7Mek3Nc<2P3&VaVm8RH|IR8u}it~*`Xjt2{ z(R=bkpLcqGJI%(?F*iMdnLE;6gH}!GMjO_nhjVrI!ewu∈@-ZK}1~2O~v_W@Ojc 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 DtSC(p literal 0 HcmV?d00001 diff --git a/doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_16_0.png b/doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_16_0.png new file mode 100644 index 0000000000000000000000000000000000000000..9cc34a015a5d150a292835d835bf754f3f09db0b GIT binary patch literal 75271 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

?Dh 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


;!#+EP73JEEQ8MfMYa6LsK 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 Qo*{%#*7!O9>YYdb2j^hiIsgCw literal 0 HcmV?d00001 diff --git a/doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_20_0.png b/doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_20_0.png new file mode 100644 index 0000000000000000000000000000000000000000..4d28fa8cd1d504b72460a9aeef77f3f8e8d03922 GIT binary patch literal 28419 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 literal 0 HcmV?d00001 diff --git a/doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_21_0.png b/doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_21_0.png new file mode 100644 index 0000000000000000000000000000000000000000..2521379591e0f59e1e822a88653313f0276cfcf0 GIT binary patch literal 57515 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 TbL04{)OX*`oAayKY4d*pTrJqw literal 0 HcmV?d00001 diff --git a/doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_27_0.png b/doc/visualizing_a_quantum_circuit_files/visualizing_a_quantum_circuit_27_0.png new file mode 100644 index 0000000000000000000000000000000000000000..c11361bdc9eb718c0360677744d3e4a698f9dcfb GIT binary patch literal 32723 zcmdSC1z6VUx-S0Ntz)7fU?2`6AdN_vNJt0*iiC*LT>?@Tj!Gzs2ofUQ(hVvCDgu(9 zG}0m6eeTzpwe~uD@0l~_?EgO3|ID@4aunqI#rrjj8x03kqf37V_UE6^)K__`{=? zXD(VQm}pzx&@{hJG19a&H8im_)VsRJ`ntJ=o{8}uZuTSWT!;7QT3VV4a&Y|HH?W(S z>u?A-AB&|>_E02FpSWP-_oMOV#VV_X#l=;wk-Lhvu?R6=d+EE8#o+uJ`e!PdX1r4I zO59S^AJ-yJOk{ixl|N#h68kOvOOm5X$$IHiq8a)QiI12&-qeL_?0tA&PT_={l)la4 zf~kM})`$6*J1Gq&)bUI|+mcz~_%7F>0NWuu#<}(RN0#FzDC6ye{Y%Ne@W|XF;^YhR%ayg7J^UU%h(Es&zS5sld&}q+m2>At-+jT8cxxM@6rE~V+gi@q*48F0$iVIq?j&YE z-F3(3Z#))LzJvJLZ>9D1^~V}-H22h-lQ7a;R|;L;a(e|qem|p)Wi&5y@zY1o;iJ5w<+6J#=%AN*I$1Xk5-PK zkXIafzV)DtZbQ0R=5*)F6#HrO4fKK+M!U+qOSCKbo9%;*>Qj6A)0&kG4P%;Y+BR4X zHmT|9>CJR_YdphcJlJ~h5DSaMu3fvD99h`)YO;=ohKI8rJb2dD)>gkhHMY>5KKgvH zSkF^gktddX=a`t8d-202%tLWKH1t9?a@Vh4PgIGOna6!bMMcTyInHNa*p;n0InYSU zqx*PbpfS2D&`F&md+7GblPC4rZuG^b>9>A(AZXg+EH5uVHd4%CQ2zQ1uHn4Ayr;-i z%d!;1+KP4YuNH*3xD&1xtUYt)49lK9$M3A%P|^PBDX;yMsf5ntemY^h8SK9`m%NlHGNyXgk>4aGCCOVpAoZNbch6qiJ?9RqB#S>iC|i?wz4(HnV(5ntr%U{gDVLX* zdzQ+qz~XW^bm)-$_3NPl4ilH$c5#bUS67eI9uyW<%egseZ9Dz&;oAQCG+Bq)39GR) zVq%BzYVX~<=bqc%eyyXuy()SKh4NMCn;{>0b+MPzta~{QAHJsadKc&VQ(8st)d^Zf zV?E)4hxqtvI;@fs6O*sJTRPrHmF?*0upD8oPKyg8 zqob8t9>UC7jRUK<1_cGt9yJfSedkWc;9&fHM#qafrGDjDj!Y6#-t5(}X-!d=O>z`p z@|)y#UyO{5#O;`8q((&@l8`qweWTzcF8~E@uRjbLF+zU zw9yq8x>$|8rqyfKnDy3Y-H6}&=~q@(Zd5=%;|AS^n}a!G_czkJzIwH1|DHW>)3LWU zxqj+qP@% z?d<{sIyyRZr(D)^3Wr5AmFx1*x`~b6vL48~&3f|GDL1P6&600@=zkYLWjzTkP%60~ZID@zhF%5@tFEQ7hL7`IKcv><>b;;$? z@wrj)xigZU&%C|E)6)e~j2l((-jzMwb9ehjl099f^{fzs5g6sYi#hK43OJ6m9(LTn+BaDmu}vjn@7M)t+W0y;x2?*uJ6 zU2!LL*-AG|4PN~A;6eE#j@*c#Q}?5=VLlfZD=aR|(`&ZATg8ai^lab0edIp8yuDd@ zc&aut*QFXoV=WbpDqgq{f$~YS+n~^OS8r{SPEN0sw6r1$6&7<<(5Y3m{nl)1nN`D6 zg>H1)>FHyw`|GMFLzhvUnM<{kSeTi`*i-}tyN6M0&4;YG<>lmF;Yu?tJL9BQtdSt~ z`aop)-8E?%I{Vnzq*0aKXVtQ-tI#mBP3r_Y)R<*q$J%|rN3(m?HAW$u zubc)$mn*}hE0gsqdlg?6Ts^O?9md7Y%`r9Q%WLq=&rdbJ3;nSq|3_^S$G1Q)ua57M zEz)Y4mgOz)?sRl@DR-F<<}EH9xO0~&#iUss8-r$kS!Voj_nAIyV?`B}-jVYISYN(8 zdY)R%$^1<=`5g}Bv?smU)pk?!(KRWKeFZccmU}@XXhczk_mG%N6qR-BX#jZ!axcVIh2! zIXvD(NNAqBwOEvq03zqbp&A;#xO>$$FXo*N)hdS>`^U#x)mL*mjCbXi9a*1We}>$k z^d)_<)Cz?{YG&g%GXgd!6ou6QofOKsy;zDA%8`3Vu(c>}x4r+beo@6Hi(*3!k$8GR zPOfFxELJJH^NUa0u-Oty#G^D3n$XV4+K)FId5&h+0wcn91M_?k#TpNAE&DH0R=>!^geo%Iuh^j1l15}A6{Kadu_%P$vGxM_ln=KRq3|%51d3{`+j017P3&c> zxhXS;vGTK-1DSn1n(voy*exIj5alai_S)0aGugaDGDW}ob3I4+C;b}DeQ5PZj~+$g zsl2sp6_Z4;n47tf%!>#%02_s{bLUl5eAnkcZZxJY+a&Z#DON?VHu3t%q)CmaJjGeN z6Pp&>@@cicRWAo%lA@y5%y?f{=x5qAfXQwYYie4vV{}KcH!DBC@?_J^!4-Kr$-3ny z@f_+ht)df?lE$aI0$F)^6#=65iQ71z&7F?Dm~is^`SWX6um1Y##2p^nk!u?mMN~a6 zC@2J%2cL~b*Tur zhgoZns>+K()9p_MExRA%CPMMh`rh7J_W9GN@7~)fUw@!_Upl-454kup@68*z@87@o zRz*JbK4g&XxG=4A0LYRQd|a`Z`)(Fd(LAZRuCA_d4X1g^K+M{z8G$Tx4kmV5j8#rXO8*;Q9msaaJk`U+Y_ zq4);_`=K5ypEz-%i5+FjBdOM~w<#w}CC#|MO5@_ik1=;8D#K-|1aL1d3@$3+v8bvK zHgIl{kdW{db;>p5d#PO(&|fIIH{<9zKM@C>})-yqfAfC#UJ@>7IllhNq3jH|{<_ zV|3enRQ}z&cO#RN)cj4NG2A+(0y1q@_zS;+9RL{U`)h@Ug+)a~eC((L=4O(>H_ObU zVB>Br8_*!$V1agxjPe}}m+_a^*N+0c%~1n=R@Y3by`ZWZgEnR;k`@DO1xi|HgsCbNOhCG&O1>@q>*_@f)XhGYN5IRA-=Ei+Dbg;^K1nx%BQThhKodo)x$&bZoaE`3#u-N)qIWW418IG zm7%Dn7E7vyuyA9-BLzptTwvYpbabqb3SQq^N28DK!%$yjIyW`^`Qyj00m3&gT)Gtb z?Af*hOiU3VvYw>_g-N!f+SsplAq*O6M)iDdJ2_82qT#46a?A<0kc~DAZQ1bt}im`r`AVu=~>*%pXY=Q@1mPB(1vEY+lUfCtg(2K+6nZ zHP-rwL%;iL5CN(qBO_JVA!lFM482>mef#!Ml6&=Yd37*-OjB2Uv)dKMsj8BNA)Omz6e)|ufV zM(Gk6K#Ui)hJ4r)5oaFlkeSzToIbEhLGDIi~J4zxVBR>U|h7B zs&i)_NpYClR#a3xd;YvLy*b4|*^Q20rlMBO&D_Gm|GCpdt&X%Cw^1FB^h>^2^}dUT zcU;%jKE%yEdfVfsK23PxE9H1~LB~0p*abeLx^8Sl^@!CJ%3$UB5M-75uUZcS$(vROkoaDNK>!i~M)#rUe?qaAGQwrK%uG4%)UoW z=D5sqHc_18M{2qhEanV(X6>XVydp1m85lIim8F;T=U5+nf0~^oZjJ*rvqkTtp4+^ZEK5}@)!pT8+ZD_V4Z;Y^83>&^A^EeDjt zHw-c27S*Ta9W&bOf{jgbl!w^95M=3B^aqrq=N1uJNDR!cwBkQqqC5A(2VeY~;+`KZ zB!gEzM^Urau3ejKKxOww$5B?d4Fy|`?C#cGv3$9zsXyv95goj$^~X(9hOU?BYhV5T z{@%FYLG$KZhZN2Hm6O{6Zd*NRnieF>0Pm0_WC@9y0Qg>V_kbLTFAgKgX`@Cr})Otez0JOnWM6IW5)^{b=2 z(lj>OyPkdj;o)}HZ75>S&Xf(bJU=BP?Dzu`z_{Q?|1E-+b>Zqkbk5>@enO%n#%*!puUW* z00nF7)S1aa4pC82vicJ1``wQKG(_Quo%(^j1dX;4n z{f(dSnX2LBP@W*Kpa8z#Zf=CP?->HkBYXikf^_qNO$WqxbUv8a2JxVF*O%8Nh?pAMGreDb`qc zy@O3PE9ToY_m(b3!+waHAhO-ig1&-UQm^p7G-Bx)R3A!>Pb*YO)7)vb(2&l14r;}z zf`S6VM53ajiJ}fk{Ft>F1pfb^X(iQ&xL9YYfm$YG{m>=ng7mQN-+$`n#EakXzakdAPuV+?d3q{9{%>5oCkyO z1$A{&tHY1rg%SN8fTt0XDGmMqj*KdSOe&tyUhTpK%XdlV)INsZ zzRNT}a3fCv8^d2lewnzZ!Kk|T-oMnbdKR#ILn9)7C9T8C{hzQX1-$TIVG*2}uTx(F zglBKhqmVPig`^TkMXS&?qrFGf!oor=)BQB?%Ggl;ChF{_G~Jm72If*_z*I2OqAwpp z4Qmt6)YjHMbaSf)0JR*iR_+6lvb6A8l>MiMrF)pcu6wWW*w<6ussjUAgEauAap3`W zy`Jyd2-+47wGP*^CamjA9YM#&(yxN#X;_mQH0<+lWSedXEwH;~7_Dp>_Z zMK|rg6bn1#g!dW$=35Q~grBpJe_6wwV^Za!HkIvPgse4N_YfR0SLAopB3tb?i*}z( z$wwu-&r>RCOO*dFXj!jvnWcS0pufet8bR&@0E>6sKyh0aw z5x;C+b_$PD(>LS9*p)($eAe(t0x4ZiH5~4KF+4oXK);FNyHwUBzE){jK*8TsuzW*N zPrbc)*9WT?FB|fMvqG?Y6Zl+xYeOrjj}GnU%=C zW^IK%m9nB#%Tr+Io7UQrvPo#WdmJU z@L3N*23Z-I8VI*S>NK?K(D*w`UUpUK>~y((`*yP3xITxXl^*0ZyU`Nqn$ z5&Dkk;&hoWpOG)Kj96lh-pbdHbdf$8phtre5z(8+} zHD85nh0pC4vA>85QD3taz9m$h^XlpWKs{$dL z$NbFrsQh&rWpGX+;i1IYb^7RlEQR5>hxY9|2_0KOTG}m5%CIU9(#Cw*;+%)wc&}CY zaWluqFCeE8%ON+0vf(gp9P0xp!48t+I5zapLJr?HR$0SA(Ik7=1?Eu1srwuCK6xI1 z`mb>E^LMOqzVW!f=9w{{ewKtPsVA-#+8+o4ZypJ*aSUHuy^gYuw_7fuxU zk#LWK8X8ogYv%ow#;69?!SFq2C;AmY0q7l`Jb3~FArD_Dm;+8UG|cg+6}bi4Ns%`v z2lN{=Q+~RqvZa#tLLDY+WJFgh!a-WX`uqxJq+?!t_LbfAbD z=%Y+Ofc)4epEb(byP=Q59PC@T>iYnKl?old@dX%gB6CBhHZTai*s~;E0+4VcgHXiu zXjimiv=V!)h2vv^8?GPFCbn(c7J@xgU9x>y#MAF$D2_atHwFi)__Yex??>)|fKap6 zyWhLIbPVf~KMhX-ox6g>Xknp<85_q9qsAU%fHpSk+L(3YWt`5t+bhIWRsGr=36=!S zEHiTgA97*RDhm*H&jlXQ!gqufS$Z+42-i(7dRR^40dJ5fBuM<-LjL_tS#wU?XlS~| zsnURbZn6G(IjQyih42J)*6%#>w!>%;ILpm(er6YRSsq~TzOiqkWuhjKSK1&s8%FE# z@TX>`TWSC2vKJ@oc{#Z~*p{&HyYZRTP~~~9eppR}EGW21z*b=ZP(`EnTwM6NBRPva z7~=ut`)iZVf+R{xNSsG$$+Yf2BmoEV8J|hhk0*Ds*5|*<_yz!~>ZoDF_p&ZoFIdE3 zM&KXXmpmR--}oZAsR`;NHg9F9ipcB_?)XIwo_k7IY;YUIJyDZ?{pkx?o8^KPqjVUcd@?jE@q0b@To_nkGHY(&%FExGxgkGd zbh7GC0b^Z3Ph8f3JbDe$IO~nl^xirz`TY5_CsT@1y%LzUJ6U<@-98Nekk_Jf|CjQb zgNC3zp+@Jskhek<(}9MJ834B3nyo%M z0p;kTV|51cJE>8> zke}b~iLShJG;6nXH7O{^om%p0VPdeELjt`e%HpWd^J5C7#;a_e z7<6eF?D>1X?2FC6{PGH0%m6AdnoM+x?2#`3W`Ktx8 z)}dainr8soJK*KA`}arY7UeF{y$B~bAt6DAYC6OdU41CJx;JHb$&?GBE6BjuwLdw_ zo{{w}1N?JU&I(?pokW!6xt zJZg=!Kjm^+_1PQ6*2lSjN~Imz{eC&E|51xho2=y&=XGC<;}y6Qy#ly$Ym6wl_y3zz z!#~Vz5{i49^#_3V@G$rtKr8gwMQitr^sb~NeH&OZr1<3=j|Iv&5O$AKHK^f%j#0>@L19FS zg0xFi6o$AR$F(}QYF@=E_dRM6R$p|9r07b08vo58?y3bO!NrGV0keAEx;ogDlQ~*? zY#hD80F8qo>KEtuV~%s_3p3QbC}`FXk?Xj-W-IBRcv}RoQ&Id$u!cmKNQ7z}(g?5a z*F9|N*)JYdEs3BBT)h=;TW@1lT2WC-eLn$Q@87@QwsU8MX1+@gvO4ZXPoF*|=8Xrn zqgW1Xxx!0e9@S>7qm*O2|ZVhu> z7rnd=M$Au89uX1ol{}JW&}D|WZO$A7JA+zm zuB0yY)~CgT#D)=E3$GSXeN0TJft@O`n&JVkg-1T_ zCxOKVb!C7Uh$>aFm-&J0kc_dIP<40rn#j@PWi3#a2uW zw^_BkU4kbQ0pQcb-hUfzEbtO&Mh7u(BZh`dt$M3INqMP#DazXyQu;& z3hnOhmWta7K@nM)Q&hDZ{^%MAiSqYsa+3#;~zo3SjU zP@3g{nL5h?HR8=GDl7YVvmo6NFZ!s%-bb#ks9BFI9Yf&WW1U1Qvq?89DyxM;9Mb>t zg0n91`Xd-i2!gctC$fM3_dvWv(r+;B*2yg=mL6woc3R9Kg#?Z+mj6X`GfTZ3iz0FI zrisEj(O(ZR)6uEFgy)R$hOObUfi)Io!r^fGA-ZbdMcVyHD7uzbPp^3uFBwkcS1FF1 z5NyvwAjuCNJaAw3b|9mR0o$yH)MtwrAOtvc8LF3I$1|}A2z-ka#cRZ8xX(g0uR$zR z)v>9w9VWjdLR2<3>1k4tPyeHq+CReHtNQ9!cJ}9%6K^GNFLxf5_T`Zv%@`V1_zpIe z^yJcvJ!Zz#FqpY#5f%d;D@UJbP~~)HE;0>9^pOr;xQqkp6))2+P%H?SV$g3ApyY*L zUzjQqr6oiH;#h*yq9Z|~g{<+}=CyxUQe~KxXR?j;zbUJla_!TW{cxUlBFR>sq$3*~ z78a)7S5#17o7@Tf*p@<7=LQ%UtU{M}MG^fLY*net<6ApX-`_OZ>|`R&6($=vFk<}! zD^v{0Sywz=T4L3W(QMzo%hUDCmvgB%d1&FdJ-V#J?7sWxYrM2$<7^tasz^^{cKR9+ zZx)_&c%C66*!dy~BjR6&B?v^htdH2@c>wSft)h)*H6$b+z#a6r_9oew;2k%(*5|Xb zv9rgiTg5@2M!Bv!%jggS^s8{zeRuh1FV?V*-H*){&4jz>Qtm zIaQg)aU-I1LY3aWWy?MZqK8yRD|65vHUD5B%25&|(KPE2QqEq(p4@mj(=u{yexBF3 zLBKmzBhUY5vhbyGrbJq!^~)U`>OZRcn=*b!v6VLQbOt4E8OHfXdK*&zLXm~N_PF3` zx#s~XVk`He_!FK<(v)!5YyCqdJPZE}x%d1q7DAr2^T&?Gg#XOKp8mn2`Jce}sO{Dc z1tyzPpSM@&X)WPlg=Qs!m+t*8U=gZr7J0gX9KmCin}%NL73U z*zc(bbuZ$F$N>uv0f4xsaUNa*=&oLUO#tiOQ!WBCfi|sc<`I4k(>^Hl?q>)wtS0vZ z^!(5=278BuBtErXU@Tv6|6@051Uts>rEg(kf?yLB7ACeh>9k1w8oE^Xz3MTQJ}wyf zENpBgW_kD|ca~b609&y#p;1?+9xUsu7&Fq8^eV%u4d_9nuu>u5st=jT_P18;9P6!? zBAltZIZT?4Uc~;}y6qX-2=~(bn5<5EuG%{m-?j7%Qj|oRn(xzClt)I(J8DIXG}4)| zR-gOU*|t77s0xucUOk8B`sZz6C8>Lhmw){LX~Qo*F;PA=G?d+c*{mP7JrTi?RwiN; z;emx~{jGW`3e1Gpzim{_abJFGsWVf~+(Szr(Q+Vm#aLvZ;r5}snEX~j;o1N1 z@`~ZP)Rz&D0Hj`UYN@I_&W!bJ;Nvr80b&KVjvhm5RCR>hLIKo3A@f^jDQ?Q3Qc^{V z6z5(46X5NwSO|6Iw?u3k`qRkdjefZ>kmSpVq2I8z1#)#MO#9{S{VM*QzcAr<{KL}A z{{qkc0d^ULc@NtwKtOFJGY?H20k5f*yn%F271k{q+Cf0zX3f_=qlNcBbf^#JUuHB^ z4PWk@rdpaBeoezC(<(Q$#z?v7de*8}>~|k%8zZaS#2(Z{t5rfVJ<6_=PZ?R+(lQw(QwTEh+)kGuSU4w1aGyx7KxX&u z-;c%uC#o=Hg(indHGd)73cVbFXW|m0!_DA_kpFV&7iFT=9l)&_&+}?Dt^vS;JiuB_;XAG390uL z#2_^Zr7r@!faOuazWgI&rN;(;1q)zw7<=+_zG0uKgh}pn7?ElL0CJE*wCfJKZwV!% zTBY>JdenZDROzS8(iISEEoa8`93boeLz$Mt8-D($;mnHKOAp{1Llu&NWR-(qjq#8B zJ#5-Jd|-7EO)AZ}aU1mNOG(-+NGhU4dWJxO`gk=#7uu6?d?=^w$ftvd5$%mtNs(+T z@}NTXdiL~bFtVDqS;_05DEy}*F-rB|=Wmy7s`3pQ8sC!uQ=a4#ku3DIwC)^iI9ClZ z&=TRq2*?314=nW_o9T=1Bgzcp!q6&md$gjCb1RTFCoxA7SpyIptGR5_gE++nD9b=} zryoYAEXqo9t-5CinaPv)t8g~UuAio*bLx=npKC7#!L?K5BzhC+t zqIk11JnmFBdwY{}^d!mAnUsZ>NWsEW%Tkqq?n5eP?8PX)lzIQ{!di3-dq z^*%ju(i2Lis>%Q&lh$kdoZ~M-w<2RRPIGOH`jugBQhk1mOr`YuIRPvXMwTLpjWQFu zC9h8GG$xZO!Qc%t4nSc?AdZr;B4Fd4phJZKJi9#@1uZ{f%JfL8N%KH5Mkf+B)6m@b zJ&nbI#tlzIFGek^ zrY8aH?UW}0w5g2X4HC)!=NfpMEwY9Ijx&0Q8uRHo;G>i=#03x+{Q0valpf;8U~)9lGv z@zHa${e10^e~AT#oUW?xbk%y+|+limea&6YF0_5SfK z;gqLp9Wz3z;yNA$S>Ijg1h(#R)_&Jd^}*980(zSxU=AT*5*6HKLcs*kdlKzj&2%2Y z2T7<9b_fpl?bd;y3x`-GM?dM};m=>bAllZsf>8s!(evrkzHvWkMc{JC>ccAYWLyma zvmCi624EoYZbp|yb7aUp7MS#whZz1{dXwF3Z8Lel=x7L9p^pwEYVZbhNZvzfB7r~vt)OMZOIFL8Kcw*+ z(coJORI6X@-vN=N+?+JVs?>$<SCMq;4}(zBSl3}0B7%sY1b#F;bqNWhkiSX{W!y*RsAn>G6;Vqn?)BLDie=XbeK z%6BeXUC6Az{Jg&X!>M2Ns&rR#(%sPFDeSIE^>qu%ud|ot+psNGBDgX2lj?&_!$Eqg ziBg7#tqpi3c&|$<&gnZ!E1y_la3I3+@r4bhj!siny?0lA7x43WH`$k2YE@!i>NDN2 zXAgf@Pf{6~TPKOyO`>yeNRG?_#ywf1#9)8_{v??(TUd}oSaj&751G6sQ+3{4aGhTv zn&5?K3`7i19;~f0yU(Y)Oh?)!AQ?#_D52g4!7?f~wi@GXbI)QdR6!>-j-Y9F3e4K;7Uip&BGX=S#gLggfSIfm5bQAQnyA8F_!i4OWX zVn`Hh;*9=8=g7E`DKNBZ1q{uHi<^q?rYvWd`uyS8V0JL9bu!OKZt3~qORslvYl~-Q zE5HA4+D(Gc^fwxUNQ#dPPvAiu6Y?(Z@T}~)07(bw&}2;QV0Kp^EC3X*AneMaVDkiV+qm4%CwHDL^d-TmRgR?=^D z4kPvg!vt(9AOXo~*y0gtmwvfO041Iz>%M*O4YHGypXF>38LK`?&MS~u`)%J|3DMcw zG8MIE+yYqqJao0RGY0GI9iL_H{sA+0h>gVKDnIpDTAQj+ z-i~*F)B~-Ld8{&CiiG8j%%cVPt3#qH=>qVQ=AK2Hzos^=6^S}0j{_H^7xvcpw(wYOT^*1 zlMF>l3Fety!NPZqkB^HvIOG6kk=(P^w>O$pFC7$$LZCc?$iWGqjwAYd(?~0=-VIx- z%)-0)y3kb19V)NMW$~+eMdlsN32d)}gWZrbLZs=vftkSWLJp_tV!pgG{FM0xv!pl6 z>qe>v3lN8*#RzF3AW>!KU~H0387;INZp1tEL2atJ)z#FDPM<)N<Vd#qsXNv7Owj`nI?R_Feh1`%A`#eBJRboBPin0N8gU#5B`#XOm@5#Q}_eT!JSZ zaLSKl0)b$WtBlCaRman?!<_7Rcd!TY8Pc94oQ&npiu*yfSEPjBX~CWt8jwcJvl`6> z{R!YicV&ua5UQWA6=$eC1+f4UEnN;ENaQHRUZ z^5*+@bP@Ui)LHMv0riC#tnl_ohsAz9fi%`w%pyLMX!O7G@um7R9$i|1pNi8Gn%dL* z;SIfb8t)L1Qk<9CA+l|O%e3Wq*@M=gpeE6cr!bud4x%yFN)sR)lAcPk=F&Hx)XOt5 z**5i|UXJU@P@GMY`@f|34WYyLqH2r@$(}n`MMfngRI+Unz{3tp0D2gV)S>;745BBD zy=sI{cXV9>eSXfaRu>0PRGL*e&TyD!cl1WHlSQ^TJH(ehuSU`St2H&#_WV^>HTyxZ^B-(hpmAIAxB{SHh&6AOT%@W&Su z#wy-8$L|&}J&xJ(=VhNl?=3O0=UDpI&5i5UtG0NJed)4mTKesB89&ST$;;2hN;9Nc zsprxx*>gmW`4>xdhjB%xvy@kTv+7^e2IOy9I6f_+IJdk%`ZqrLFE8sazqn@f24#wh zbs39pbWy|vE*7~E4DBjw_sp0ti~Zh5OZmn18@Jh=V>kq;Bk!&1px?sBA7!>?S}lKk zX$eFJGP3!+#QVt;v&KP9EA3DG8MkVNtTs?q^Zoc^6z=-(@taF9plleckfq8HI&nI8_H@AHmZ1S~1%z z51}M?)PK;@K3xfe(dUWQil9Kgf$`1n?^lot14%R+ZY-NPH4}e%zE?R<9(%_)qhkl? z8VMdCbdd%qMPeR@u;&29#_bw2EV@Wm3`QIHX{l__5{kd{@n;Xv2T6A9d0G9}udfhC z!|V#lu|sLYw@t)g5E!;FjHcgy*TkmNlPo3u`(qF zF?Ax;XBYl{9)Z(Bm(vW3;?TMc8>(TcvZU2Jl$<0%`5s7AR6tMTPmG&XxFOa3jA&pS zq+UNLU7pEtJX)itNOU0q-kFx>=P;4!_N|1SkFj*kI(+W+K_|+thO7&Pq`D!~gA7(}RD)JC>^2{I_IKU+YlmKJ9 zBp3)7_ndsVM5Zb;0Yrgw?FXOhth+!0yW|`IqUPek0AN-D(!7SSL&Sxkpe5z9IetR6 zMAjw)^HiHlmwfaM40z!rh#u(M4O3z4W%HaE5vK5RF+U%Q5No_q9Qzj3eiJJkYBh84 z$KqCu>H=^|c;?PF4oZ3=@SL5Rktv?8$}T)!rSQBfyUxRLY(L4Npdr=aXd7|>0E}Gi zG+~Tt5~qYn^8}G26|(@;sEl+4p?w9P@UDFh`*LczgcRRA zuzTZua##aVivjj4w#o_xfq^FGTV$xRAN7|Zv(bkRNs`D7R7=cNvP-};cmhNYo&NsD zvMuLwaVLF%NRQw|@uDlEoa2lEaU=~E+-qVmRE4++i6E)B0SyygW}G)~ji)0Nx9wr) zgxqqKC+V${LAu79&b-?Gz+1!d5^;+WaEK$(C2(7|9XRu*Kec`gp=Dj%OdI zx2?g5?teFI7tDg9PR=&NG;TRUmB@b|#`#x+7uo7?#1!TS$=pQzFouXGB&X!0?(O^K z(TDA9+aDf3v;}-#33GKM4ogxe8}A28#{-=BkvUk1Juv6{;EGp*=?V(4QCh?*gRY|$ z=Y9pK-0xi+3WbQP1$-lBdwT|djV1R&q9R0Zx{kxP zBxPkMZ)D4K^q%BI#F@|&vjXLH_d=XmwqO{l0;P^bJ1|xIQ9CK6$4WVH|1iR)#Lpyo zTG&*A0-Tf<7cI+IFe!I!yq|9X?Lo_hiFgboSp({kfb#(2jj;5!4_{9GGCGGeCm(j7 zzTvkw-!n&uGEEXP1kMjM9ECoO*iF0jPmK&qZSpG@HZRUgIC$BCB4Bv$p(7T_Xm71s8Yd}*3inE ziW?dKQLB(+H||;AuY@8%)kuZj9^1Syk>-m+%G3kMOHP-feizSeF%{Ux$QX|{U|R^! z0TnA}qqiN@JfTa1h!;6t!th;voFA5YC3?*`p+qDji0l|Sbj#W)8+c63>N{ zb$nDn2fh~ut=?q7gT7A=!G{SjLH&zE!8y8nBRPd3JG)^pL*+6qDUZ})Z>F*!6YT3Z zJf|!)Fub&oiBei;AD3T!lPT9Oas2g}N0vCGZ2OKKD?dK8CQ*LarL>wd*g`q z#+m~=MXB#z9DQLy=ThFgC`_-yymI}{SH%Cmvq|JDR&+8R3ORXbqZv804=|C;wa(1g zp+5AY6;z|+MI|TmNL1kXyD`j(-Vo0Pzc#?qLpH;^zW+It0SrfXN%B}(S=D7&96ZRj zAPQ@woczVKCOauOCh=Vj4^W#quW+ovR#PWYLKYSl^)~WtXfsVAKU!y09TLZJ)I&0! z8lM_pO(40qB1Wf%u;N1NWSm%|2VDTKLBCS5LWOmUCl7?~M*GncLQn(`aZy@URs~%r zC-F4THcg@jZz7370^dQcb7XQE(30&Y2V(IF`c)Co|7q;Fv>l_mu%<}Ff`WG-rg)L?HaUwkpC_!z#KmQ3zMLT6lERh?qM(i0ZSM*97SWR+$x zT0wLIJ_mpGXmN3QSZQcR>4Nl>x8Z_wB3sEgsJi{|nX*x=k1`22BCkOUIUs>OBCS3P z^3#nTI#bA>8-!OH0TBl3<%Hii+Z4Q6ef;2lRP|bNUJ;b}#M*Hs`qpjh$v_l%FyF30 zkS?Sl`tP4M8b#ISIp!Gp<~_ek)||oRfm7c%#i}i&uuTRbjFgf>25@j9X0sATbQ^(+ zl`*JsoTU97=(kf$mnDsbSsABY2AP`t;gkLxz8z6QJVPJ@o{ro0JEOXHX9 zi*{B)HaK352S5f#MHWT9FuIylJJ$KqWaijPES&5ADZJ-H%8(2RGZAWoXe|Q2lf0W6 zdvq74JQgF6VUCu*DG|TzAqX2!%R}J$1#LYa%Gc@SNgP1iXr;XBfL>rKgE5O5`!;0_ zE?NpjwI)c}f?(ROw&(vnn8lwuv;2W{O?eM?gK6S;mN%BUeL1J&t9|0XfE$!QnaW&A zSx)!)!-i7Eywj?K^CENOk2X!RoH)xho1$pl`pmP{#Aqa4cyt6f`p6?LvpY928#_-Q z)Oeed+muZ^FV4a{>q3iPb2}%fN{ip00PBCfmj8gd|3CfWmd-)^Jj!t$c|`}Av+jY0 zT)ADF?)y3jO_g37?{<88pw`~)Cvlp3ES#8S{i8NKlY`yHEpPIrur$MD2CvLy$cAK| zKn}APgz~hU+WcLOSMQwN%T$LebF1&U+_f})?SASfVX!~!Fhs3l9q3d_lgMDbw8p{i z(z6Jy-|vo*z~5zC#ZuEn4u1)o<#xIJB0_7qs*ep~F61~noI`f+-ldz8XVKe%`7q-X zjtMn#&}L?4UB!BQa`$e}t#$@)=^vEDWli?6n18!@kuG8xegsaCtRcOjH#%NL3kk811)qe)f`Fxo_No0@w3rjxwO{(@F|ujCeyL!el+D=MwSML-FWAJ z|B8*mBmq=G;`QhNhs)Z{GukZ$p*Dv=tR-46m;uh3N$;Hrp3iV0eBL|QnR5z__BFlx$0Qt+UR-&ZgoVJ(nj9JTNBoG?JB_ud$X=&{} z`v83~l7^!o)!VGI8h<@>XynswN{d11ZR$&h-QBl2(H{9+TfWevRVp5FjJv~`1h|8D zJX|k4J4c`2by)OEWM-xcju%?XX=dRL7D56G5Cw>#f$DDc;~QsSyScz_oMb~qModTx zHv^HYUr?2tWjz%I9m9=|^FuSIed$QPAMBbC$V1&YFt!>tIN$_Mnk30e32%-v60z!q z*ii+q(`sSPRze=BQAd=;J`DdpCDRuY6{7Q%qCLP~N_KYj14nGw$m0StA!Cj&UhEXc z(QGgl6oLL_oAP*fccLOWAKxZ-|0oXQiovW|cXM7|IffR3K~4&hz!2_3pwd8GKM^C% zbXYot01`s=$iUR%L<-#`i}sF=UCUOk*Hw-K7|;R}5j%Iz6`I;6oTpVh1t3u3@R)Mt z)|JLaM%N7T@RsWgKthbUJ#2wTdW<_ywL}kjf*Ht3mbfEgfZ&P)tbop+XzrALj)q1K zr6buYcJ=HCG^AeKJdRp1w00+!68d)k=j*>WFGXeLXvq9z5(P^jzUveYSfB{98JKW7 z_=6ac9K-c%*Tg*u$GYdTvcX{zUw5WEDd)9Df@r7XNX*Wn)>9~^`E6x0_?2?*FIA5J zx4uX;8T|9=fT)wn{f+aH4F*4MvNr2Zn9Z~t8*d3Ie|~-0P113GdCTl3;myR$!xI%0 zlu%Hl$@h}kRdV!lDc$y;V#^X%=DN7@{DIs~>$bBS&tID~-of;~`lnd6TDMJX{do^# z{*?3u?Xw|b8*;3_I}fh-->H&AJ2p2dJ{^!YF`I8U!(n${v^DpsZZ^HXPf$<=xvDD6 zwdzkdKx8JzDgT~lKOm8$U6Lq7P72N5kd>8ZoO2-TlMR$GTAQ=4$8YWVCLHiw}fXMuvniA-t%Ep>W~`Vf2ly44v3HkCgtZHT$y* zPcliTA+(ly8;rx z@6aQ>osxt~sltDjUu8gf{=8{7Xj0=17G=|il@Tz4dy)dC1}V<2 z5EcqKjtAmKiH-&D!5bOTrY7W5wt+PnT6Y`7 zP-m{Y_J^V(IueZRnnr=ZVKuh48D(8dDH^6bvYURi9jE!93&gmE!}s@R+KM^)=INKY zXkK)DLE*p zt1GCh4@`$TLieKzeZjeu8aT710)!qf0Ls2hI5_~NvfvSoRkOq7CvFB6EE~r4aLwN3WN_aivZgtGj#v*4FcG=jbO-D*NruO9#VamVNQ2kCsdl6Yvwzeo({@J2X+tYk!M zWDj)L7rj2c+M2*?XS$E=X8G5Xco$i(=<5E)?2%Q}dV00?5@qHl$5|s19fcdLsaX?H zQU0H(t*JcF_K%;-`5;>TLafpYQ#-Klgoqv{n^!Wb`$%8lEdxcbs)vJLN=klD43M zuiOMQ#w5DN)xWT(0nWpWWo6#9*@!*ZCQD<00o}AcHC3n zH31f+NB{wg$hLVVoDD#Gp!+IrcyxQKuL2VNMug=%*~|sHP)a?(Qh|qyBH%585CjBS zf;HY~SLRRb_lBME3kmJ1Xf&>a>3-J|-5JowExy8#MherV9+eem1dUwW0JXc`5 zwe->O#Cqc57nwIIFFoq(%ymT4j%a9T=tWkh%ZqjS)>l130S3fi)&MzGfcrEQ6{k<0 ziyQkpodV44Zx(cXVxF#gFnN(DN2aOvEv^`8323r=%B^S`c3$PHb@6+b2<(q)3R1&^ z$>ID#;qUNu0KnO?L!tBV7!eVySLilU2+IEn{$glc%NH3K7)WQ<)u-lTH3GALbdc&( zPZX{PXiQ0UKvHm$r}J2u7%jrGI;ZtblM%V($>bTc)Zj&53TF{YTKp(brm2=ruIZiPR`@4 zl(#xzf+bS0@(YWL6~9Nb?e6EzSe&rXm?k;JWt63LzF-;eR@79^#@?n~>j2BDkx_mY zqlI=bf+*767f3GlVnlmNBp{qlB|E2kI_)E9=xkppMCEwlj1g6h4FB6zN@H zj7cHh1W$zaXev_u}gaes3mG4CYLJN3La71Qj1Io*$4gU1iEm7@~dC1-4V z?(DiL_uEvazCT?&qo)36ZKihalj48}tq(yySYdvg&32@@hPv0g3sNqsN=mYz))8cj z$bv1f=^{IAUbGkrs!?u0ozj!T0oGi#ml{gaK9}wsWYSmUofr*~09fueATczM`p~dr zNMKp?C4je+g`(|Bz-C^0Ynt@2MS(6OWhAt|+yYYvskrk1tp`D3AbDR=d#*?x`-(;> zqC^DOoBX?G*-%lHLVNkA8Sz$PyS4KhO}Lx?8Vd2S~~awm03Kl ziaa!3{ao%xUhx@=eOi-tAfdS_fOu$Z1VEjyYBLulZ7tSfAOdOwq=Cm=Jvx_RvgL~i zj`sfEZVJyNiBX01;k4apF)^YD*0x8d4Cii7$SMG3F!YcJ*SeM8kKr|?3j6rs3eO7> zc+nqWC_2d);wxZ5c6t^fHS9wmT5p8>F^;UFbTdk%J>p9jZ`Qf6|@kX3}E69pPxfUhmx*A__{%y2c^I+;4&1q>}j%++LSmi zBJ$p|6pw}}useWtsf#e#0pB7!ZmW*Y+O#)Eq2~fzZbg^sP=?!B0!;>J?N*SpWR(Cn zGf_;;Yr42YozoCGC9u&xNUisbUKC|?q5o({)Peyn4>(vmuewMx5>uKK*dD%x<^!Kk zEBTR*EaukCbFY|2r^OUbO}T^NBuv~aiC+ezIr_ZfOdTjoI5YhE_xRnVud(*_8xd^( z+twiK`SF~<@@+jXtYxE(TAX<7Kxh4C z{^gG0%1SDpq4X7b2%!BognswM`yNGo(YD3 zgKR($+uaM-Q;5_>e}e>j8Yp8DNK6vM491F@$Tto@Sz$c<)#|rPbLY%5nXpQv$6SJm z3pX#u-SHD#5+pQ6sYwQ=!`Rc_y^b=xq@>Q&e~C%-<1dT-6bUfU(uXzp1xmK2`31cCtGM3q!LcF0a33B&0 zazPgNDYoE^2tUx3iplx(g8!C1Bq?@}BmbQvm<>>a-P|HGU__v7AJ3>`lF;3?!Z@`F zrJ1tVk>zn7yaMRH@8goxK9htG+v2z8iy(E*<}LDgTOQxcz7MG*A-QI8dt||f%c@6!&`^^HV4!*L~1 z@sO+9QgS_4Wvb>tZ;iEhgX`viml|0{;X;hSXnBg{0(gOZ@C8_K4E{0OOn6r~794S&ZPcFL%yJ zOQuP!f@v1LBAS}w?3XY4+Q>wzn_j5)UcU-Rm%XI7s2+l-6;-C@t@Z7st%+yHEUOLAQ5Xz_@RP zM!&Yi%l|GS@*sNYd0Q`Op&CQFM1c{gI52|5?xwPbu>Q3v1{cF6DfXNu>9oZIEpI!r z((U%dBi#|tnzKbda{oy1oWG?AH?5ZQtHK_d zVBph4u$`3S6z!55= zw<$(weKc0UK`KqP&-&WCBO@4k;5YsKoR51F$5iu#ghDTx&7H)slp^@rdT_jfW26U# zzz$|`@<7M;U}Iu6$-vOCd;Q~J3V3c?Ora4W)MNKmWT-B}NG#qc$>ha?4bZ7Xd^bt; zp&F+g94NE(&CDJ*Y0aET{(a13xc1b@>p&7uDkF{eyi<<8-Ldn^$V&5vc+mdYsomnj zGy~R>*yYf9nF`zo$UI1u(8lji;5T;4GEdmIJUJUK;ga7w=KR1lG&kWe2q2r~cvu*+ zB|Qrp!thc1i$yfaSePF{ZXq^*6*XX@%P_Kq?}pey!D*jI$$!`W_b=nW7M`$=K`MXF zfaS5*%ANh^iyFayzZKbhcMiq~M&C339(c!EL2Z$HW0838m(=a%*DcE5?6Kn5-RSpc zftV!@5DrgVz9N9F-yHSUo;7*;Ka%gavW<@lGEd}&ept+t?N{%qtCv!zS2iV8Vf)Jk zqx>ztR`aUEuZxL_lD{5JC@GDXEHMVvLD($L2nzKXQ44;)({s?r)2@R1aa$CgWDMXU zscX>ep>H8IDzx(m?#$GDS9iSS5iDr5Daa@6zFP?)`2DtM9uo0w(3c8A4BMyuDnTncv zO%`XjN+;hl@bQ3heYITm`hyI^&7W`eGa5$-__uMKe!@Uu3lgm0O;OJ7pzAO^yzO6H3x%^+iuCpARDO3v_6dl=D;y=|JhP3{ZxlaB-W*>x_S*6l5P}C7Y^dF*s%?x zn2M~SQ{sKBf@Y44{<|6V{U-$(3xfj?r=6I-}U} z-;A!TZ0eqi;rLq-ewPU8?AAM@w4lS>*7v^C5V}#DrI1*PsqC(RljRFjY7?7YY`Jzqs4=NZatERE{1#WDy6F#| z+4lOT<7@UrCeQ89b;pKboS(4`5(WSRP{=^*-Z2gc5vHw2=y99evzwqBKwb{`yM(gg zjA|Ap)ljgw3PgxEOX|QpYl!oc((y2&qE)A05F>~G7=Uw74{}knG&R4$8{BSW(uIm^ znt{EucR!5S5|Y}&o5*rW1s1?ihEVk6`DPDc7mxu1^61gw++x8XH4OD7#$LgYmzxzpfFUb1;R{LyYaTQG0c>O}Uk?(ckO3mG{`fO?;BX$mFcu^$3=$|gY zRH#tp>+#c+b9|8DV#7-t)X8K!%>wrof=^T8054&o$##`G<;?6wYVos%F)dE`oCIg7 zE_o>$=gUs1LqBQzhT|o_W(30t13r`}49S+!4?}CVXW+oh;cmJi`M+r6*wF{G2d)F* zBE_ss%02gNOHLvIqHZ(G)|OTVqQ`_*D;bOz$aP~yRVE#2aE4Zo`+BUoZoz`wfQ@#O zWCR%AIe}C?ERA!3HiQzM;ATYAGNkEhR*;p&!h25UvO(pFy-h#(t^xg!}P z+MqSzlnx6cBt^^O>n&Zq!xA-$<<_Kv=;&2`@_O;8`4fx9kmQv^S4v!P)U=(<7-6>*S|#sn;@wYBvz2N=?NVB#ku zuUR8~P7u!G40-gmLMY|60!&@sqMXzPu-WKl#p&J>VB~Fjr(e>y*~Y1Kth5gV$bTlTZcnGIru< z9a31slGH0)r1E8-*^Z!+QA~~&5Yva?CNF7HK2pYG`S*PnXtMUHzHwd3ZsWLwg7z$; z{ylEK0z(Sx$dO-lp&pQ&N!ttWVVE!7fVCPl}cpaHjVlDk&Bm-T4~?8YqM?p z-R-t6qC^z33L{5S9UlTodF5a37oLS>e()`MgVgTQ56jv@pXT(O%)NC zR6CY6uetrk{GCgvhgkQVbONHQ_sHt23hkpnRyY5}Kt~7>252&+Z Lop$OE7W@AN(kBWillU>U;u(33P>wm(hW+BfQW)fg9y^Ks6`422#9opgh+>U z-?{eP`<{KzIRA6+8TX7mE@Lnh7A(H+{oeV^-}B5jLQ_MPgpi&Pfk2Slx~Y5*fxsAm zPab?+_>T92A|3pL?V@-~2OmCs@gIl7*91;C^;{4LB1-fpM&G3W34Bw+^~OV2ZAS}N z4^!tS2zygkCp$-1J8Lsm_b1LS){YLWLVN;z*Lhg2TwR?c`T76t2lyPFE&0U*r3w)U zR>Uo31s%`iwMoB6Z=N*BZT1MrzLIQVy&}uXO=tf?AUyaL!7?|}%t{&Mb6ZH;Zg8zS z5wFk2Pkc;%VPXBLK}Xtq_LQLaM4_3M!(qH`TyL5<;;%htWg-&%%0}5eb9CBkIux6u zP?TsI+H<^HYuqF=>=)4ZvTA$A|GgGI8+Lejc&^d}<0OKDBKDd|Iwb|gttR=)?Ch@t zpWRkgzJ!7GHaz?$CN4L;j7_Y=&dyFim#eI-Oevrl5gvZ&U-b(=x_e2;-Kg)x^C*~_ zW=yWwAoc5x*HP}pcZzzn#)W@KRN1a)P>$Y0zi8~ss1;XBs%meX;)Ysa=8k2uM(Q(4 zxpz72nwgoc>PFUb`Z)H>|DG(W3Hv|ZVy-sI@3=C{poGvdiH)5db%l>l#ob->d$L5( zodmv_Fc$y7oE)wSecsH>OaYe#HR;VJESkqRfnlMf}d>yQ4tZ%`_lnr#>U2Y=QQ>% zR_X86IC%^ziBFGqgKlRlDk@^;<>yPOuN@qC&d<+}WV2*05Yr3e8&ukrzT*lG)Gz$n z;CIY8@YdGa%Bm^ve!hUyPx;m_UuKNYei;k+pLj~|{7^bMpH|?EBPg!lqlepd+M2zw z=ql;E-7Qw_xyA16>|A2m!+f&l7!cHK($t%!DrntzslcF$RKJkMXMg>Mni?@ZJ-yS; zqSi}BiN4-OjU-0;T*(yD(b3T#E4#S`1=xtL_agcI0~YD8IsA49A5?qqa#!dVemUvu zyEia2WVSj|O1j+ThR;@F(u`T~sD@I^VWPyd;KK)OA&ai2^+^=dK#Ge{qS`wVTN+nM zCL_-ooMgEG=8lez#p%X?xKalPhj3V?R2iSm>GRWR0s5$$YHF>8235(NY8X=3HoCer zDlh4t$@(3cEDwBoSnGO~l8Oogv9z>wQ$r)Pu~AN1TKZLdd}v*r^qYi)@mk(|o3P+u z`A<5tU5P@X8)1t^hlhun+;8y-3CrFY>*!#!u&@wcyxyviQWH(Zr6DYV`6GAh)y5tE z`e1`9htYE0gw3Os;yHNq!5TR&@w^5toZ_*2W&IkM&2FxVQ}JAI(W;6|sNw&MS5sy21dQ@-SBB-mc=lwV^pc5PxCRHnw;Iuv= zAuKFhAyHIaJwiHJ9X)L1LxP1%+!RW}P+;^?P>rD{QFg19>S2`w6DhOw$nr`+4!hla z(=#l^tlo!RDBr^}1Z$B|J-3aG4K`xy@OPTQORfAtb}1=?fq{YWSFgyQLM=XB8xx_R zq-0m)?DyL*w;va!U}EA8Cbu7IF!1)SeJ5!C)o&O{gU~QEv6;XvoLO4BI#gtMt>{sW znV_{W{nl0+ivcovanUO5{Cn~vpIVP3*?_Y;1nZRd3U7YZE`Q_6Jz_cm`JIhv;|sL3 zNx!G-ytH@L#ve$Z?)0bFpd2E)_cZhK^4=%=e(&lEj)@_|C8k3}sbE3#Vl{-; zsARdO-lJz{o#@rX;XV>z_$-FrUQ7BjcEHr@``t&yW- zWtHotcJChLJ#B3*U0vL)-thVP$E{z#nvIm0R{NhyO3TP}o6E?^JUu;fvpz-YqO=SR znWC9xUQ}0$Tf0RR#KJZ;s`qBQbg9+stRs#~@NxSqi{dvQ_LAfRWZ^;#q+^yB7DB_r z@tMsW!-OoqH%(8o$jZvvN89tNG2Bp5nH?%L5Qnwr9eexD;u$?Nb2Rle-JhRwQlA$W z^TXmnC*#2sxqKO?Kj*Hhr>8hB88dNQNASy+#E8Iz1X@_DE^`uGth&0o_k~D@Ny(S= zB6)`B3+l%ra};|>HhlU;!t7I zja=>vgowbjG?ucmGRDDF?ON9*N@o9q8PPU9s*i}S74EB7W5;sT@ulb`U31&NeJiuE zQ&*3I@}b_{-JLz!UAfnjp>GQfXLhY>x?$tJvPWcew8OsW;!BYft*1{*Z{EI5$;`}* z8MwK89?hRW&XF<$Lsr7{JbGoVz685c8+HB5zt$=RTo*OBWy+Q3YgM8dBf68s%(oZ1 zHLqN7uc4i~Kj|lBW;^9MN79uh$AX1NYUlPSP1aA~>8$d_!qMbO%-x9^7tK#-h$`_; z94)sr-&-BMw`_~l2er&G?0o3cj7dR(j8V+65>iWvn#2_0=FaPoN!|M}Xp>YI!T`X* zW4O?70f1r`@t?EE$Xew^c1%JdqHafBvtsW$!leT7S8Ja7<$Nryl7hHRoPPp82*XlZ}1Z>;mD9e3srD&L2K}R7yx5nD?>#>hj+P zI%%RxkGcLmyzC#_%nB9#td6#KhFz z31BogH^VYE!NT|E++|U%x}_25ldC*%*$_Ad-8(mDT1p>xP%=t5W2dI3T3J~Il4DA_ zuQsiYmJ51rn(!FbUO*y|(GH1{5B(st-%MzGe0tv z5P^4P53zBBFw*>wuFlTRZlb17NwZXAzH+7c&i-8gBxIgWsg=MM+|+nF-e}tK`trN$ zPY4?hW{C<6Q8X=KWRBN|y1PkYWRI@6uZ@M=l{>v4S=1&DYSB>w1zcnLr zJ3Tk*_e=awy?OL2@EgxhH)a+rCS`Bv=v+8E+ix`g_U7u%n>U+a`wKeH-(>I@mt@1{ zzIIJZQ!~)9@s#FvHYNNeRk+W{-@g2hssl4K*`>F;gxuFFZGmXD5}cO$E~DY8w6t`M zuwTXRc<;+IEIa|5fh%>JpNYhu&SKZPm7m|Sx__T~D&X9&?)>cd3O~Q&pK8U7CcwB- zry0ercY;{(cbZ~M>8Yr&LKL4__kYar*qGXLnEd6IsMIiC<>!N z7v+;DPY&AT&Yqnf@0%a~`E}*$)#m=Ya#5-*eiw}W53?oI80hIY6B$wNpwKw zo^-}%7&rPudBQr$yScgLd}3l@iAhdoMC~ZK7H>2hlL9!l04jBD17Sww=3YU!C|EHk z6AxYnVJq@VyHPX2yZ9JD8?ZbQA96r?*sfh8a#`qVe#NFFSy7aBe)1cNzsYB#p6e5; zay#uUB;wvXxh-V(QP;z8^PtB7hl7yAbHzZETXZiABQNI8-}F1$Y0fWh zcrlp&KnWiMZq+i?3s=TxueHb!weG{;8Q*ZUeC<)aH?@A@keR==^;H{NTS52LhhaNz zu)!u8{22Hf4$Q)ae?fPlHS+x1Hilp2%s>qhun7d5`L0gXQ040uevai(-P~*;tEzo@ z?^CNwk4)I=svSO?rnYua)s%Onsg1elIZNW(w;>c9D(QFAWZy};amVu+zG!V#M#y`6 zOTLbao7vbPgO3l{*=+p$#iQGpWqR6Dmo8z$wz2%4TeAxS`?qOnWZCy3($iTZ4{zMKvAMOiv^h0%D(SL7?7hDp1q6Oa4>0rs zB0W7_{@aoMcG~%2+DL<+6k4?F4i}Pi&)M8&KI2^Cew1mzzd8QJnRiUHmGf|>(gydVq?2}x|j!^V~`)XmDx%{6ob=zbm) zRLDG?I<~d7)&Bjv!vi_xvYquwhR%52mShPRr_~X``Cq>j3U#Gw3u%7+{>>pEK)$}d zPO}~P;ss-+2O;9}<;$Ln8DU+ti>^9z%(Gu2X|oH8F9YZ|!T$vvCd5znsv42rHK?9M zW+``cY2@bReYP#Gw`g%7_^h(LysQlJhptwh1q^aLQbuxWYHG|t*iOiY-+OxQ!qd~n zXKS7BhzqHzs(M&%p&oWTT4|pY9vw}ih@WpGCh5BPicZKvEo`L<2a&@kAmR|T78@VW zi3s1>*>UG*U}CZ#PR&tEWUuwu-~&3~`3Obw;_bBuV@OBKOhurOjJ^{iNHAySTpy!)4lONpYo6HS%MZhv(*0(;OMgN-l%1|MllsnJomX<>A@9R@S_4}9~LWpQH8yc7s6B9-K ziV9O+yCo%^PF?&MKf;6N)gO%k0g+ztBJ9CtxZU(#tDnDrTRtVttf;u4lGW>bFf=?o z%!vklEe#FQ*||CUK0Ga3QbzGWc;nfgfHNWg^W*8PygWjb$A-JB0WVOIg1S11nYsDQ z%8G63^2&;-09^qoj=>KbWHs!`IJwM?2XnS<^|ZzvIu9O%fr6i`TFRB%_}ZEhBB0;V zNqY)tq)0xAbSDrc9)M!a1fK})strtdY+@ooibmLvADY|mK76?J;p4~5f&yZdEDErS z;ZadvN=#eq26a(3!-In}i@jN}@ynqYJ*2$;T=L(FG&X6AW_l-J`uywC!SK{rH8<8|KV@TT+cYYB$IhL838TBcdMc`G^dR77ir`o%~z(9oESjDG7CHJ9& zg(SxkpM3}E^ONnxse050(xm0la;}f+NueNT6_Q0CKjMO;tyq@rhtR@oqWWo>LH40+a(!9?X27zWTp`rm%+0ibUXS7fe>&A2~j~iT=gqndHcW!ZINmC zjd)61J^~%do*m4Iwt0Dbn?e73Cv1H$X+QC7L98)$kXfX~!BH8!nU;}}LuuGpJQRpx z@$ekj14tdf&Nh-r+1V`q$XM{Ph-j~=-|4$Eg0!XeKV32Akd|hIHoIm7&s*wMVq(Po zeBGIhFy=Cag#EUm8I7S*gY;A>4^r;8gy=%zFLztfwcbVQ^DcBH_7^>Yj()XJmO>&P z`UAWH2vGE|N0LqAa)4YqEHAiwB_?78)YmV$~Z2pV@%s?_D*gNIYZZ^GL{ zVOgE_R`o7jy7aSKY`XPlbI?}b9ey?rjuu~>RY;^ttou2o59j0PWPQb*U0h<{zkdN* zMk8nYCOi#7F~jJpDlyrUO{Kb%Kb;42Ea%}&Qtl?e{tImkj^!7{omlVPyN6C;P<72j z5@Kj3)QgRc4S)Hv6*Oe?3$5|HX-!!!E<83iHoEJN!&@}8W4BGwWHnr9Aoh}3h8~D; zebX;*z-^21Z_(m}(&e(O&z}`rTU$qvMyk_}LsK$hLlwV{=iPPDq>J^oU4wBeGkefR zN@rM$zk+FP{Nm)shJpT5>N9_=B;V=OTEn%PN@`s0*c5a!810ZTnOtgV>DJiecH2hM zwd0n01K07K#D8;wnI_u*g;%c(8x8Ko`GYna$NeIVgF-(_8zS0~Psxyx*LZj;e8k-< zK5}@wKQ?4{CWRZd`lmQjvX0bepSXP~Df|)b|3>rwQ3k6;M2s7hWx&eL^;!OMg08V~ zOp26;8CXL)8E;{TOJ;uk3IQ5GSM5lR3m1rH63;$>AqDJWi0Cr0YB||02cBTM9q+BJ zHN*(;@DPWQGL@+-J=XSEpHQ%|;r8|O6ZF}$W0dwJ_xJZdIP3|CHa?l9rIU2M^5@SV z0eI=)=twcAe+JkL;ZNKTqGAfw57yIV(@|0R`{#^jHrEqN>_)HetPGPuVGs}y}P3tJkleKb`wJQyg%5 z4Glh!jhgj;R3E9Zrh@W zg5WP1QT;Eo#Z^@xX*xN7X+ER6@bjbM^UrN80WWXGaVlhJ3SZ3Eyn-&))#*kSzzzt4 zza}|0L_jtnq!y7oX~&!k-=z~Y!#>(s3W5?dTk6Y(d=VS*At#4JLgM1t+1cjiro6sB zJ*=cAh|x-AK^_w&B_`-2Y^UUa$U=I6JRnzwCs3H3az zUq#vuJ3(aSx-rFce%yF&+rk&oet%S0Q|{m=7TU6*+}9K#f&-*3c{-;8%>CI!AU!h^ z6YV*+K(RFQ2d{8*+dN=`UikB;Nq$>Zj=Qg~bXj@%_+ZSnPDtTQOjsdn;a#Amrk3#C zaP59CBJQ!y=)OJ?0dZM=f~~Zrq~DP%xI{c--z^;7Lj5N#8WHW(qdc08=Vv~3f4*J2 zdH1fWvNHAsLY#%}Bs{=zXu1$WU?Lz(<%#dN5{48O`Z*=K0ktvv5JQU82DZ(h;4N%~ za?2k5Npz$oYCk3nJ3+tR;XwifL$6;`diwYnsD1kM37?G2vU74GFA7<>=2nUz#O-W+ zjSBuc3S5$D1a!j;{9D%9*a=M(8zBhGre$pGn0hXEzAc9tc=OJkxG6C%jpXD2o4;p( z|1ndAJ%5h5J(r!G4eJK!ZYV@mAlwK9IGo^npWY1pQvhgJ|fBo%`vN zf}I@?lz6wcpPvjdt`cfbGb<}AdoMXDDH5Iw=<-#@>NbbI_6k}` zS=n{EC>02gIYdQifJB611QXRf4}T@ZzJAS)l(YROz>3o!*8@M0^`O{D{rlb2|HV*m z>LK$5{{rJF3f(A2bhf9gjQ$$zVA=R(cG@T9@+4$rZ7-;=Z4PMPZ5|$`^{!`zAEtTs z9(E9HC3F`L!Xpdqc&wW?-1}4lS&l*VA0uF9tk3hj70_L z8?F@vyR?Oz6lk1AbVa-mCMvC(y&MmMafsnwOn3yD)7ZPYA@QI0)p~%2BJ+8W= z%$H{{uCzW4SXk=4YqQ-0H{Ak8w_EPo+uH@kjm#^<#g6WW#^*=FXr=Jq%{NBsTLQ8? zZ1D9$dE4fTnl!f5e>a0)>;4`95y$F8#AR^UM6`VG?ow1J<3EGk!eI9!Nsr7vW2)yY z0YrAAYm~8(W!C9a-B!Yxb#)VFWJnPJ7A5eQpr@O|jc3&8`~t#&$8&tVButV6zCAo{ zMz^#3^6IrAmnbOU!Dk!u?GHuu%urG2wKzQUhNL}LhZ`Fk`=N*|%%R}n#_JmA528EG zn!d%aZ*TjSwSWJ}QYBNZl2_*Y=J1T3ntE`a`L0i&4N`rIF9s%t@qF9XLNE}hZ2gZK z8G4xLj{24$S^RG;zqq>6qbEwlD_fib8T@SQiv&BXq&JbaYCLaYHDN&GvxVZd!cO_i znehUesA`XCzu{iq3IkPdja%wrd=eceZ^LiWq$>R@2bT(Bs$%lW%0=A|4Z@OktKN5= zFN{@n`)>>mV@HteSc}%Vx~Z zUiJwu?0A+7!(TTlMOK2+fiNUWs*D6Za2=hfxHSiZ8E;J+)#$)!6Ba4AODunT&mv=E zlFYBz$OF%PhuhN3r+{a#i~Di%Iv#&6d(!!%*jNspAHZLFZSB}ETPlj0+FLQv3dMNd zqQ@h_;pA2WeybC)k5c$F-6WYn?lXp0wDj}{5HL84?;Pf2cXq3v@G<*#P^!M*lk3eP zskjmtJ@5Q5JyrZEW*pbuQ2oMCl`I7_Gj;^4j0_W)rp^8Ru&^*Zm=?WCNC*RenzTRP zKBlZ}*vv5&HZ!+oEx56@sQM!dwLR@R`$~Qi<-u?9JvjnxD#7wSD0%g(_;0dpuo(8`BgFafaa zNk!K3+uBf3XthoHF+>SXbGq<{kSmUq|AZW2^JKdRZA@SIq$&qBBktb4>w9+i`-jcB zm-J*y3zn3}dTTHN6*)jSI)^-1M{R8Or=4BE!NGBISvi=-u^;sR)4?V6C`;t(rzKHC zISPu7j5``O?hTVFG_3HvgvdM#ZYG zuENlcVdfJJ1BRJDzdB*vH=K;^2P={BXU}dHy%}&_d>z+i9FaUZIbK$7Kg_9(_2!#~ zhyAKw`LW}5i!Qo1Z{M0i6oF27VMd#w6xJ03E5IfqLJj1D9*AmasKBy;X$%FaYU$rj z<0}8hl%^i3n-m^C@0=}w!&nkVf8jzfuR-Nch<(5C2OQpk4cC<-MGJ{3!e4q{4`MJ- z&WTz#BJGcA3b5#irp`_x5fPCEw~NHMo?c!e29}exZfL9ZA~LdYy%0H8`BkZ5um9lD zwglIMr~8#%Yh!!*l7uGvF1bwL{RLo{oGj@^2w5fgyVn&ixdS4bulQ@|EoJ9dY?7D1 zvP7u_UA_~~3W9~${4TX2pcWCHtL>C0j}!R!;X|}TPI3TwSMd!d1z2hDtheK-i`>y!5J%TEQ*E^$^0c48Vk6Vke&G+Xh$BN zUqSWFAE(OH&LvjU`BV=7+Iq!L5lcltc1Yk`Co|3{cGxShv$Pw?B$=s#KH9;R>FT01 z@u6L}&C@H7f?D*O29p*C2vKaDms2%AGxN;w>|8%*w31kMUo;cN4+5;g$Jb3q%bqL_ z7qdWKMM+7iX=u3i2N@AQHfKrIrm!@$bJ@4`N3*AAt0tbS@?Xl0O^m;vNO;}vk|K!D zLGscyuP_eWA6_Vtmw}|6^KL3JQlA8#?q5ZxWWRp>65Z&CMgL)2=K;DM@ARC*->QoK z&!3&vGmdBtFZ{nqPFWZph~cvN48p%o-Qt_MIn#vJ@JDh*d>@(uz;PIPl!BRoxW8q# z^xA`>rk)-$C|WSq)m~@l7v0zNrS~UX4wmi)yg;W^D~)H@i~>&Gto`(~$K&ta>$k7< zhvPQrq0_1_s`gtz%Rlig9}U=bI5;`7zt{^0JMmx3{QI-y@j8!UFv)fLY)%3(FAr*qiH?Nw^OQZH)G#zuNzMG{GFV++=1EG@5{ND-=;*FMBFziK zY}R;wV+a3Lu#aee^trS14j4Dpu4D=AM=1AhvqSsw$_Pj~D)i0Q#*k+7?XhdiaDnp^ z5IFKSP*QZ5?aSy~v_pp7E{cIUP`hsOdcOtm98tYd3`|E9iigcX-l84gY*PCnrW+)g z(GJhxgj0mZ{!kF$$oKI7e3JODJ=OG=+As;{v0@9~1niPHoNp?{9n$hY(D%g&WS&Hs zFPgBRc2$&%RM~>bqaB{N(?q8pF@~MRI}VPF5X`)zyJ#~P9p3&HO1-9FYbI-EDZ|Dk zS!EJ$u0?e`gM;1q39*i|-XzMcrN@kYjB&p_V(v#hLyteXR-1rkM>dX(Fk_1^Ud6$I zz%&Nk=?^CaueYg9Oa+eaUz(7H6xXth9$|){$T#UT}whFKUcAA+>k;@z6K__5YqO9@V-MP;sg?na9Y4LKV-!*5)08u}w2H zpu+Y1!m;@iW+n#gyJXakact~KCCBxckVuCqX2|>c`o^{CZ%{|{`e4DG>n4ImZCf=C2Mimo$uAof3WyHE~A;BpASBCboK39 z`Y2ooaIRdr5~!PxgLo4k|Jh2IU0j^b$jE4+^dDyNfdSIKFgt+tb^caVv*#0jiVll? zr3Uk_FBSCkF79ni$ApIB(h=jL538Mc{>5RA1wl9w2IpF?Ln8QL&qCea83^{d>1}0E z(|wr%NTcjV%W#Stj=22~JB<~y@0qSo)Ii3LvpHAO^Zq?O9PU9!vFIT%91rU1Bw|CK zH$opggQGN#rQd7aR!ZQ&6C9Q?KqmqA5n;X&;mJyOR4=5gcW=@18xg}HtGcbP4ABlD zQ1e}%Fn32v&C$a)Fh2;y-<{9=&m!pg$vo(Bxn%zTms+rSj-f7l>(y_keK-_~K-{{a LpRwbpXYg;$8ntRU@Z;hU1W@81Oj1~s*2(%0%4;( zfv{mWaU*`>o5k!;An3%XDjqxImN@y@%7CV;hcF%eWC!s8@c<87NC(eN{bQL#{oSr- z=*0Qd4qAWc>U`XDP`_2Jz^@9W*#F$YeSbi6vXo0i^>4TY+kQi4UHC#9-WVJHy^R(E6}}7Ak3aRcP=Y0ugRHq-O|?f`-j}vhYt_5-?)Bt z&z?PZVq=Awx9sle>5*p9BsbpdQ%1cC2ux(r5rfuXcjt2+?E&I`?q=ds4-{$J% z$B_>ikExoOI3k1YIthiCg|4iuw6(Xh9`)dA{)o?BV`O9$v+I+- z(tAWoN-E2AiQcL`PKB%InVm5%>+z#UHQ}ty{r2zPzrVA*;dmP3`#8aLoqVJI{(eVt zY64-%_DlISe}8|^Uq3EMM%>L%Gxd`B(%$Yg*;7(oT}@=~b$XVPa^dH<4@O2t4U4+_ ztU^0Je4yvkwO?CVdihdv>)R~^!i$_ok9uEu{(9@bBani%$(fH|^-j&kO`A+jOep2o z*48pJGo@J$adU5>Xb%Ys>wD!XepIl5%Ab*6uW;ydscWo&VU+8mubbx9R(}`%Iq=*y zcErZU4!&)06W>nTf;+I}wHC%K6-S=IZ}Lz`NND zM>dpM!cmcp($d;`>$Yv;Uz*K}6y)X4oH?_3f(aV=FU%k3k>mTeV zZr#BXue|l;%iq7Ij9)lj`n@pe;o+fP+a`9)if{k^ZLT*h^GCV+lH=p`^z>9Ej<`o< zDIN7(NR)6I38vYf!o0Dru030G%f=1zbxlng3JU3iZzF05hE*mrFI^^VZEaUpSL4Gn z4Qbmy&W$$DD0$Lf+q-vf*~~!o4r^m}i&LF-&CU5KDPQrt3WLeL#)5wNnF-NoKX2~} z7viQ4{#v8aeOyUtA2;`8chR&J2WS%L++OsuR^6BEC2XEfsuUz{6x&&|zEOm&&) z?C$9yXOU)T=1?hSKd-O<)ZNIWf=~bU+qZ8!^NlOKSC^mJeQ9&i;I$EP7*M34i4F=P zz8u()A~8#$DtjaT3WPpbe=tZy0$!#|E0{Gb6w?n z4C3dhZTG;yfDmFn%XGZ1;+_wFS7hJ+w$ycs+Vjfimo8&1sg1FRYOAYXd9QlZMX)dW zDcwd*nE6^Si(p9`)|<8aeB*F9j|yb{4sdHmR^RS zUPQT)x3~AMUAwfkwS|Jny;>R?8|P+cDdmrP%s(kC{Pz6t5_xEGseS*=@NmsJCZ(MG z{9iwR9(DN^lc=yU=Ipt1-s`KscF+qj37TwfFK`}6&K4AimAd$L^U7LFclQ$FysFUq z%9Sfv1ht>4Rt;TTMEl0()0zioEGaxDIv;P?uz|?V$;tV$iT7G4A3uLmQc`7QrGqV@ zC37jAA*327a9Y#!(xpo$Vg+`GR5QnHClVQCy}j^Ehv;^vsHfISt$&i$G_~n`^yZl- zUi9kP@2hi}R@c0|`1tsy#Tq?%E}G2s zJg78HuPx8l|7Z!_D{jA^&&I|^;#sTFD~~(s1s^}^>M3u`$o@K*bYAN?kxG~@(BHpA zf{UAxxorn>A=B*x%fau z3TAVv=Cea6Ss58zWv{%J9HW#Yz0&JO=ZcDo($mwqLm!Ivdi6a>OiaY{FY3Nk+IA78 zQbVID<(MxD7pvWua>Vz3LkpT<#pB11@7}!|5hBf!UtVr>;>3y5r%xj$UcY|b(Q)SZ z@h#!5GR|WWB7;d2-@f%#_#A3Yri*QS{NTZ!!xyeA8k=3d{P+MZ+01I|lZ%zTy}kPM z9&;lnwY901T|)#NTJ7>HHeE4ScrUPQQs6e;mbvl9*Z#^tH`~sd(7m5Oe|DYh8J?Ux zDLpFaFCW^|@$q9$R+f@PV6bA^9$|C)7Y5dWn=-Gn#;G*Cd&k9irJggs=D>jiq^1AG zXWg)E?({zDU@tGPp#>L1Uy;hGd-v`|MMeGiTpAk_6BAE5y5A%xBlo^|;jX6_f8)lD z(9n|#3cguc`%0!xo;Y#v;6cP(8sibYbmj1K*Jg*dms{f1PxXRyX$svLg%2Noy|=r& z+q5?9^0hNpuZs1t_1Q`zw5vntbI(2IsG-lz$=SSZo79mb_*1ygKUh9gf6(!Tpr9b0 z_U_@sA8oICd&`6l_H(@*os&vpmmlXjlWAgV3Mh0?Te@mfFS2?Vt8AY`KNY8v*`-VD zZJ%j>|C|^d8Y)IK&CV2CG{o>CkNzl*^Y^c2^;uzG?W&KFUw!Z9;X(b1rY`sKuOxcBepW$hw-Sh=@vFbE8SY zOV=rl{sZ0jVq@v!jV=S$6nlLRRKSt;ObVz#7T=9ZckSA%SFcvPjD1$?_a`5bkm&zF zBh}f`LPCrk6=?PB3-s;bAg(&PtA|_DmGK`JeSLjL$5~WjJPFNxfvM|Zu6?Dh`B_<6MMZPZzIZ3Z#l_vZ zQ-U%(KR>T2yV}v$w+4{JJl|=)`4cYGu0-PO1w>l;9^08Pc?E?{nwpNNr?+n1S_r!* zYD4G1dgIeweTqGT;^NB0OXlWkhV&1#a5}uc^3CYn48`fQXG_|H zC*zaUT3^5ZiaWqO|M@~u_kPX$8Pn2al6PWahK7bjJQuzrJfin&nqRs!`LUp~v-4b9 zbg_7!``6bu&OfzP)zl0R4HZ3nSogU-dtl`Y?^Vgiq5$M>PoH0%WE4Cqa85^ObaXV( zbF5_T;^Oi$haU>N{-Y*;%ANw#ZRH2&=jJ%CI=(OvOL&}?)|Pho{>p>*k?W2CwE9E} zimneIlB8Vo)O|Oz#*8*653+v6W9doQ7y5d!Y5|Z4UwyfVDpNU}CH9bUO=I&$MnHH0 zqcXRS9BpJb#GL2MfPa4ep_1bxk}Om2%!{%$lh=^8jqkP@=I(d#!U^=9 zt*zQRI(FBhb{{;)=9iY9UZ4MSe0K(JYe6OEt=c5R6qQx5We43?*^24u>97-Y zw6tHNwr<@zG#GiDk&}UeL8bWnQOnZ_R=1l+*T1ZU7Xo;H_78cMNZQs7#t$N#u z6OCf~qo%s@jU63@ST5g9O!S%=INn<&id=-K5>IX=W6!`drw&GK&`;b z+X){5xasKZ9Ak{eMy~wDiDR7%n;ffRDmUg@nC=T?ZwgE5A*Yd%1aktL|pi$b72QjEte>pA!JKcMZ>c z-GsKue=5z{*;(>(o<-Tkops9I-fJ1E(G3j^Ym0;73tNAyDe_e>H}TQgpan!7yDxUR zXRI|HWuvK1k#5}vElWFE6sxs8OTVQ&J%4MIYU`apFAJz7EL?P)(evlGJE(_0@^g;V zbp+Xe>)@pe*P2KzXGa#g0U)lKAuW~0Y47tpIV)H&;ymHvQDKYrouB;j~N{x+;pL=_0%^IYv zkvp?BlGFwt3KG~<&yfR$RJkdum>QzF%E-&RA}_zuP~vvp&!lbSOmPtrht1zHC>ilz zjj5SlWscu)(Cm3>sg0$jqM~9)R~LNC8Q)UGD+%hZcj}GkTa{fU#%N)c5xB6{TPv) zJT*LgCpy|!hlOm{u9AWRy)w6g`B4isH@D}Jk*zVjr{l;sJBup*`rKV);c5_7+5a_) zD?5H$Lr6{ahUW%908nIo*1W2Xzq~M=42wFUsp<3U2Xk6U^^wDepFDi{ttC~#!NI|; z896M^;D!8&duE%%YXSG)f}MB}D!!RO$jZsd!J1O0>a34CRZ4H{vA5>%?%j8Mw^85? zLNYS#i!8roHRwVmLP0FE+4d@ z%zgg+dDZ>DPw7%oQE6ys7-mTl2r15ZjkUG)Y%RBf!fxIwvS`L-ANagk z4#fd{7ImiJu3eSxHg&{zWE$8v$lNuW5P+x-;4FrD84AvqOi+FEIZWb32$(ZqD zzAmzrwgY7uFo||(c&~iU%a=WMbt(<5j96)<&f{%}dRnefur31P;`I44sRoE;%eM_8j#nMj2KN1fon_IQ*mU6|kDeXcIFCC$zfgotdSszN@VbTsRa(p<*g`?B|cq zo;}4@BIL8tTa%l+Iy!(zB4?%D3SI&GmHOVP8m@0>xK-H?&W&*D#{FCW_JGt)H{M9W z>+hbPS@P0v+C(5+zXz6!-?%(6&tDRh+dr8wwQoyvqvhr0AhX8hWVBdK7y)^3WDcJ} zjX*r644)woE^*O?RIJQ4f=m)(t_uvgFS3u8tf;W?%9rvaurZ=nR8>e!!=a-`SCJ)W zZ|@?c96>EcEI;x5btThigYE;>-(L*5s8L(<(Mg{>cW$sYeANEP$jFG=>U9q7Q1f?j zt)SVar|l)SZNL7On#>=C3JnxeEqEWFpWn`+rENb}uZB8(m;XEyGqXkW{rAp%tO5_( z7?PWR&CeT@UcKz#ASh1^Kf}+%qx;IE1bmf{%w1J|P8XM-C{>BFKIM6NVK?kIXfbd^ z@(2iAL4$&xPf%3U#nI7YeeIgM`a1-u$Iow~CRITxDJk#Xsb^JY=vi7?o;%kGbiLb5 z`gfq}LlHXEHyRpW%GqDP4)OC3&$#jO@}i?7rjCt`fj(=eNoUf|X^rAOf%mwMw{g4I zlIa75@gg??rayYbb-Fw?HT8Ri8FRusTC8w|$B!RR7TdeKO9=2Km)7qUzXB>sJy~Wo zTy|}GVWAv(0(oHm=TBJx?Zw4Kg+TJ3_O`-hjqBBYZ4A24&?IYd zMyqLqhj5$-xTtmHYIotKBRwb=t_Fn@qS&T+~#odl(pO`^w@MM^XN+e*c)7o12@S?u3$VRepw#4kX}Y->dTt(JJG) z`Q@i{bebC)IDCSlqocF4v%kx8j5j4o5mSM9ZdDJ6+x4;e;s3SHS{>Rxj8fp3<=9#} zI(CwiUnx(1Zw@K}35B@%CZOYKnTi$dJks+)6ec7j9L!fa_6Z~|E}Tjp9cv(~_gG4X z7SH_5jQh%>puFY#d!pb3BTfgMdfm$5Cxb#9c4FVYeFMADdU;vw;{-h>ARqwHc=6&z z&HK_z^X-~aZqKrEbAL}h`(kck;WJymAM4}GwO>i!H%9xSZEk640kEK8Iud~g<@`Tn z870%QvYxt3oGW9dqH2B9n0x1-4tky4>_d~2tL>Vy^}I5?D3lc*KLLhNUG40?I9%lD zrwUIfd_6dmr5+y@8|#WXajEfcq%D(>2)eS+)o;1^;D>+x_JFg|PxPN=G9!=&MS@Qc^RWp2kN4-Tm} zFfJ`E?WU#eEx&eNtaU>nm|tAa%mUbl^Ix12K^4iaFHy)_etdGVVr}{0D;vIg@|pV) z>gF6|uFK1jg~Aq12G8yLKNgtA2oINE`<su%H_B) z(u7pc%*-HZqD7za+fD6a0@lgg(E^HW%&Ux^FS;p)6!-s0) zM*K?3%KN#vR;DW{l4R&MEiLLWdd`i6CM0|Un$$>^Ns5Va1~E8QvEJ9&xd0Lc_ypYx z>iFXN3$UYJDxMQYV8I4=2_^Y*y8!>9vXQtJqJqb%&Y<_^zn7P5s;XKTs8a&oo7;VQ zy2~ywAOP)LSyE!6wCfLp8*&#cEf>K(9IU%#%!PB0s@z+RUZJc^dR)0f_x$-ohA-#Q zkHu7Oll!k9hJISlu6zc=&Pq!=G&Kb_Q(9UYT7yyRus2HbbMMU1*Yb@88x17RTo_ z8Nv3@>{EX|MS(>O?hVVa6j4M%;WF1=g398fOE>@JTJ>Eh$!PwQ=L|nB8E*y6mzOR! zSdM4T#6(6?l?WH_`zHf?(d5AK*Cqu|?Y@LP^I0CxzIpRzef0j=yLUlXppkVLs*8LV zu>ZkGxJi=H(Mzi$=T4uV8%_3UN|cDcTjX$r$;M{lpiW+kqnKW9US3~`P3*I0zt9RG zLROk(t!$CC7O&c&#(|W-vQ}PQTe~g4EbQLrFH{pQC0*j-AHz#^N+M!o(Qp zD}DJA)dR=G*qD}-g3YPUe~`7*KNxn!iK1ObG;#X%m0y#x{rCh;7^fc;ATjq@vn+*Z zhJT}SqqLuDsHvd<+&g@6qv3ugS??84AjiA9%?|MJT~IS z>fn)g@d~akIqB!p>7Jd0q(0t4>>L*TACOvud_%TGAOH@1W&tH6feS>onsz&ki=em4!2N!K5u_T|Ip^{hB zOnvg?iP-Nxlrwg}018$Ovm*%AGWOQv>#@e(Kw<;-N3agOr@wAEDw?vrgs~(AsbG8@ zP*Zj3!wX$LJWxUJ(t{SLo**hww-zX=^*R5^%kc_jK0B?(Y5#)R5=eG(R|? zB_%bXPFu@b3{Rh?SyHGnaX58~x(~NYqCQ=vT>H_(hqppQtNFihWoBg+>hc{rl&^8Z z@kKBCdMb(MN0APp8&+2zPYd$_7EDRG?zJQa3K=aZdVU;_9z8-H`OwiZ?N)}4keQkJ z94pR zDJ(3^%jYaF6so;gab79cx?VU6+RkTWY+x-Crve7M&&t-ex5z>htp*54x{&H&#~nL% zd;!o}kL4+HpF>3+g}4Sb>eQmO|ME3M644*3(=H}WY_y>uy zCu9o($CpJWC4C-Y@E-V}JSV>Q*4&p|QEO4_8;!%rf?kj&Vn{?I=%`FDHyx9U7h5ZQ zd>R6gf!`&FYx2+z_|#NaAN5|*Z7`w$nXLc9F;m1M==NLVlIJV~Wez{=9{2%2x)#H$9jfPs+S%Uq{emKZ4I zfdT1GasSc#0>vcZy*UN5q%)Fux>9K2)2B}%IbEQ<=-@CjR3AOFISRQS zVDH@7v&^#IW#QrBfq}}kze@NS_U;8KiMn_!trX7(`xnNy$(2FA$7=gDJiCdjZY>yT$2#W(q$|6%`d#)$KcWgxtD?q6Yq? z=Y^AnyZejeWRg;eM}T&pvwiVc?Z+xbhRIjYUt7IvX?e1Ao4`b_jDTaG{}(Yl6!3zF zsBcZn!t!Hapsi1uO-=?EvrqHBfuSKv^OQ|j-edg|vM*0-Yikeow%EZJJ zG{au}8_W&ZZU`B!FEtiX^I!~UcX>*O7HRD3*TW#M($dn9U(oF$<~`lrBd6BeJj&)^ zqacwJiHRf-fI^cb?cN6Q2!dMLJ|#I$v6+Bp?;mW$1x~-e5aLRU1r2noOvE{byS?aL z&e1C}=ba6y8p+7lMk)po1;}g0d|*uOj*}gMPot>SsYm27Gj&1Pfl{Bl1z;mqd{1ukPNGSYRRa9MK(-k!CPyoY%tgLLW zLjF&R%C0VY_6`7J6Bhx$78I6g!_?&DWZSoQxAWTI-sj;Y04w6RZkNQ14x858M&K88 ze@ACe9e&8zYi3Ki_vcrh^oJO7`0mU4g!x=o2-s<5cTeP|SEt1>qPx30H{!y0e<-L| zJy6$u_dSt|0f7MRb(*>zh}(@i#S z8uxr^Y9bfk5nOHJ>iP>$er9O}<(kCrgLp<4QZ=lfU0~Io^`f+t(@$Pr{@yP&;;vms zuYPBcw?wTH^3eG@JbVd{18l^l!0&W`(Wg(h!=eBw6`YBZsmgWfNEH!OIW&7T?6lO> zH|f9EfDjDI+tctP+3ZsU(jEsy#Nf+z(tdmuKnQfjhNTjC^ z!nuJ0oqYekhWQ1#ZFS+UXmx&5$gV_0MZN8}2RtgZ?JmUKw<>2;k>jJo0~Dz^%f1{U zB`Hb$c@LDw^M{xX&zw-#b0xmwWsuVP;`1;m)lM-5XeOJZ-pg zJH8!v%OHVOJ5O6(eW&~wpaSi{hRZ_Y;>IP`yO(CG;vR~HA2@Vq|9x|qLD;Ph|ErDk zxUl0-8|g9~*s)R2-^U*%)-I~`mD;-Pmb-$vu6}= zGpVS&J}9FL^F#NGr^qCbc-)HhAnZUTL~){$kKT6@aH_!ZJzE&=g`3+VL|D)j!}JF& z_wn$I0WBOO!t!H^r1f|Q10y5#A-_9gH*R}5#dLIebKzZmz3MW}sq39z$6b$9swu>fp!tPFKaflp07 zL>GX?Ijn3jgvhgRn-^g$g36y$`TxXII~&DP#f#ZNH&RutN6cm#KijC~1bCPj4{FT; z~5 zu(h_x`wxp6xc^Mur| z@7;4CgMTe77@@L5f2J>$KM)hPU z|659E(>axw(CSzeSElZ4#2)A6 zX`DRC4_&Ff>k5%wN~#n{Y4A8B;1Tby%DWW*VBz;jgXgk7^oHlOj*hI?;uFXvBskcV z^a&Ina^p4dAt=_niJL+4LB4CMtAk|N16U8XN(X%RrA9gr-0t!%Zj6$}d^ z9VrvGx31R?8a}tbxHLOVeR6?JE_Mh!@4!GI+!#=&P%60g?OT}WYQ`mg{22GZWiL-0 zGB0l`6rf00F3knMxnQ?0n)!R-e%*y|B@U`E3mXeo8E}{OSIH3lNf1r*< z)8q zmzRsLsHnJgi%dhpSyf%V3~c?H)Vqd;m(Js$#pstjX@zFz=D77cwnl8QQXdx;69bST z@d6-@)N5~2%DevPeUobz*#+2vb2|9>=4BXpfJDwFj#g7NAoi?eN70I)ISpJVhYJTR zM=>mF@Y(cK5LC!`ryb=4^q!-nGx^Rp@VB6MmnhMX0+V}5`zZPVr&PFLBCI&aE zOtNO9`*rz##}_1mo`*ol@CvfB#fpLvEo=A;SfD_1=Ct86a>vSGAwkau{B=o^l0e}7 z-sQY;jP9mMZXI5ry^tXCFin8<5;dkr42YH>Ymy}d^m z3_9|hz$n{|+m8TIG&Su&D5`JUNMJkhP^4yb4qX`%>v;o%+mzpczvOfN?}pYpJupvV zjo_$Lk2q~)6t?5w;ChjnwAbP^^fUN;{#Yvie*Ayp=G|^R9UHUEOo-W_{qWytd9^^O zNnL_5FZy8B#sb2 zbGG#B&>=K$zbEo5ycheoK~Kvv-9S*e?(tvrwXI;iNWy#a?c3oSq#|xczPT$Yzm#f_ z4znT*zB(@)#pH8fw*i?3UpEb@di@=aF}NtZqgNH;CSYNb>UKGBAc2D`ygDtpk)qO8Ki-ucEnN zrvK4nMRF&D4*ug#rX*ai;>jvVOl0ca{I2Z( zQj#Ab%u8C3=>6<}FI?_c+)o3)rlX^y{Vam-87ljuP0>Y=?(y8VY}q2nOe9>tb(d5b z(29Ye^j?{%MYBl4i|7UAEkSCd`9+T(@3;5F-bFEK3XSx!KGjP*5STAgiF8j1uW2c>wzmqn-zQ%w^!16tYx?{c5q<8 zsKWcGSsi6>5ZEc-9k3#nxEq0lC}R)VUD}*18}3W8dwj^H=O+=swql>Uy2QD-GQb-e z8z(JEEsra-1)e2@@KA_-LA<-axFZ8c&6B9X>w_GBW5- zqcd)Rs9>3Ly3gKzJ_Z5hnY&S1S0P_p9G{9Yr>txRd?z_MJbM(CD@a6Qo^kKltxSuG7maH$1$VsKaM|4b9W z#f_OJ0*~lfzZM`Oh&92Ku*E?0zbvS{DWtlvxER2?wXKa&+U;=PgYE_!ZoEPG@+*QX{n7!LdEBJo2%8cS5kYO}gmyTvg%CQJG&eUlESsJs$M$t@NzwDM z$wM%UNSnj40<(dow}*#@;G8VGdm0XugwI=airyaTgWVL}&)S$@+If^VnLN4=7{EA&FA1O^~CHOhPY!YY{Fe8H*;S zVEJrjf5wumf0COo0E#sBCiZYq2g3-=Bf_I5@`N1)J5GcdO3jHn#q!?z zI2Z>(hTun{6@ll`mBaPMurojiX!mTY7Rag)N=EeZ3G2zP+~?q@Ag-3iGQyKObu*;s zsP)xWS>P9(P%u*fj1IFf_1o!u0S+tsS3LpB{*H8o1e!PXKx*{jTpV6y^gSkDSF zgq~ktQJN?En8@w-@xr5vGlR_ZEP^JA=g!e_d_L&_^Eo&1(S)0+u2S;$7I(5ns zesc7~FsO8Nc0SC>*~xJDHA*EwCdfI!8n8HvO}86|#l*z!#>QG)x|Ern4FM#C#45NV z_F;_xVe#VSOSR?R!!Q{6wM23%53T26DK9`{RowK{1d;d+re33c^1KGCHR3jyo|KX2oal})ZTLEAvV?q~M{w&PEGRUUTi+_ek$K?a`rzmALR z*9llS!QMq=$3;oxWl8L&V3E$1q&9eUX14wa`humi|2{Pu)$^`lEp2UWot=5m>GSeX zdBpE9w)nyQ3+nA(oMxE$P$@6ku>N!6+qP{xK1TLt*wJTcI2Ml!l1>){ z&*ex&XfjHWtaEcG(8>ABlZpv^y}-_}y~2iB2FR%A%(;9kkBk& z)o%~nOC=8xcV+?`d9!9ocd$K(sOM(l#gqr;B>ytDhm*p4#Hp? z1q)~}dnc#8Qdey~eYO(_{%=9PRGq)PK*a+kfWDAUhvcTg{pa+<-OEl`&UL~ z*JtME@tr}pZaLc9r`WSd_qjvpyj-q^#Pdeu-PC?VUbwGQa^O)P^_dE;rh;k zV2co-RjT$u6W}2XT`Wd*Et~iLALL>JR!IeU`EM+fW5*_w0Vxl z41W0%W5#^WN!#W#B;^lGH@ZO>=|_S4z)zZAym)N#j7h;F@EcIY+R9wB6i*gfML5as z-FpceIiwi)Gn7$uQWruA1c?iupzxTp_c~1AuAmb_I}1NEv#50ksq=o(X=Mw;56Nzt ziryPvLj4=7VdlsagtnxV)U#jJ=uQ(PT^@q0wX0a&XQhm*K7^paA#Ii*(AEI~cpS7f z&h*xoLm?}hgYop-=5OD)v0-?KJ+!Jy5lbI&vj$#?f>kEQkvtNoc+_h#VraPu6&nnL zhNkATqM`&*n@-&2>1js7^|Xteeorrd3J6?;!4}Q%S%?6yUtd5a1gWIx8X%U>hNfe( zJv&^NZ*3st5X7+`aKT=_yo&LxTZ$a89g@E^0QY+ZG#2tJ1&cHrog8~UC~pKij-RjD zc)^qz7#JKs?mtkWtr#WZD){N}RgCz6D7re)$q#1*8=G8%c1}l)6a)!?I#vt>tm3yA zd6=%FAzYWoNkSXu;NS?VB|>?&vtwmpxex!DPCQDwtrN!*3|8Fx_Ybz3Bhz3W5S2%f zc=DbIDfdkNl=lX8h&qRy3TyqB@!oHaN{^L@sgSFW`EKQ1Q~5}mOXK_}yCwYLFigV; zolme{G$qT*3JPkcu{%trmX!-9yzhhM3_%Y-g!>X2D7}e5TPs`S_^Eba(IE zNhPMG-&3V`Wp|xeGO0!IXg3gfc0f{2jLC&Sn#>noc zrltl4xEy!3`}lEs6Y__s5m%SJD(l+gw0HnDkHAtR{>7`vX;hv3c)ig9bM1>Oy|6T#JSR|;0QTMbhBx~o-By|1&6)GoSReR|S+bDPVJ2pL`yL@_4 zaI%APf$y+Dw>QmI3EXnB%(aYlx}_5;DuAyai!3PGZ$wbj(<>Kp1y)8{c6ztav1<=x?Z9JW&eo>OL z`{3F9v2U3RK(lR*EdFl?X8;_ZcrDG+g%oe7c353@$xaC@sEaN4+&CGrP5zjEXkQj-Gnwa}o@*&lds3zb-dK1OwQJWrwjHCPIkS<#uo=t=B+6+wX_@3^XSVh9%uH_WCB!N|5*cexHRowW zntCAN^|oDYx;ib7&x=U}xB~2Lq0U-D(k+?g*L_2xCID!}ktS2ZNF7f|?6h zhGgM%gvrTi4)x+NvyO7ipO=}?a)hG5YHBt^)uN-P=k%La>4TXAO*yo@U`39sO}4&5 zH8=^waQTb^Oj?nQ^br*mK2}z|;k74JRZ;B}iN}?dN%?)8@G0fC;3k4xSEUzYD^(*6-yVDrWsSy|@x_V#nD zwqjCTT%@TlHp)bqYxf>Z_hkI}^w=t|e=z|l8QIm!c$jdp5mSNv4^!&>{(Egv3>qZ& z*Ygm+q$I8M}TNU%gV}@mp!mvfg%CF0Cf#gKm^#4)D-uv7$x;k_k%uRVZrGK`&UP<&Y>t} z!M(zGcq3+aY8Jh`AprwlU>dd{x^bA4xx~b-_C9w2CwGhpC&Sn9p7V#m5$?4E>TY8h z0-u088bV1%B(f#f#D(Gx$vFwBn!*B%SapY2L*5c58;A+Gb_f`N+_60{SIirJyo}b!{zmIVDDv6%^%9MqXI6Atg;3-Cu;e$OYBH|43dNCPPgj;%h46JsR z6zJmqHF`Pw&r2E8G(`tr-Fy)}7Am_&h$h|wKJ3IwQ9%KfU9q?)O+m#{WBo`VW?;rA zCQk3b@9(_TK2_8E07?%khV~IHHKaU@Kw=(Lu`BMgE)OjS$^GaG9tUH$z_~E#c*2pX zUVA(oGuD_DMH7*=X}k{AA5A{yJ>tmy9)Ws?brRNCu>0sfIsDeiN{uqvjmr>$~Z_6`#1cD{w6_6-($@)5XW*V`E=; zaflboeeY^-w<%wTDh5=F;JvHDg_(d)#a7Y1d0H{1`xLmSkGjuhl$9kqy2U_5y?GPf zz(1Clq^l+c4D4qx*gZId%V->(!z2N+c7wCQyc<{`i0F;nDNwagD=p6}|GvOig`*w^U9t11q?~#e$J3d7l0I11$wEs+~Q%JG>U~J9>-< znB-o&uD$(X@6EVlJK|?C^yH?H7Bf9R4*fz$EMXNb%}?;5Xx-S@z5=R|jGSj$qZRng zqdwX$An18&w-UW%j8C6-f;t0FmLf4eA)y%}9}1y*?H1ZDFv9SG$KAafKnc?hrpHG} z#G_H5S?1NhwhG`diGSHDuowX0@a(9Ptkk)v4PQEMXE(F6BYALz0x5Y@U-eN!?s4-~ z+5T@+mP7wGWqH(X`U0;Fdq~^{f}8{T&kMj)AZ?Emv83SO(ACouWTtg-&MH6;A#JxM zu#(-KIMXK$$`ZQW;~ife42kRmAF6=S;jt{R{&2u#zTnm^HGBIfzP<|f_S29?GIDM_ zGPzraM?aHbBLNE!O4=~kVm-dQD-}ss7azX{RT>!=_Yqqk2*mzInxS*La3Ftn)=?lf z_iOBZI8#2=)#ae7t8bI<1ZJu>aky~dD;CU5X%%Rr2-aKa1|<6*6;)(nqAmC($aka( z2XQ;0y{GW#@f5G*ayCPe4<2`d5b4#2ZayjyZqLoEh3<1BVmlUp{~p|k;g}jv2u%Kz zn02tx#?X1oyLY!8r-!tI;-yoyJ|ek~ue0ThGj4z6FQCVpnNqesd`H|-l~?~HZ`I(B z9~z_W46T)qUn!+`9$^YYW(6$wygUWhH!&5`0Hyf-#k&{51MsVXOO|$sVbUEm2#br~pQhrYb<*2Xht-NO7@Cm*H^H|%x6DDKd^-ns-K%wAv4+;pV z!JVR#2P8!sW;tVpoMd9cA#d6FNKf%@4ZkLwq&C_gQSR9>^{Oi9(Z*AS+9Ibkrf#}v z>(1Ag1JH21d38VfAB%- zQ2Q3WHY^oF9Wlx3_IvZefP**Wu=Rx>EbZXkL0Ld1z_ zI6tOs;$vw!20%_JkMiMs_3FL_AbyRrC84gVZrO@77H;nDBu?<&y^-PJNZDKR?@*Y{ z{6-v1ac;Oi1P2c<@67D1^~{6&_l**0ESO-$L~h19hqdFlt}baL7NW=W#4$7!psq&z z5x1Y1STPvk*OQ$0>?B-hsB&W!!ZIp~X@9TeeLH!9?jywG=B-;7(915Z0nMX<%ZAZpng=r%}H z)z$uaZe}HYakw+SzP=gCP_uEk8r1akEJItx=km9GMAAmj@8EOXor4C|kg!L){KY#| zk6=nnv}?~L;Z>mdz}r?ukszbY=7!iBOlZM!goX%^EjS5Y5@C5uFe&e|CYaJ5JgB$5fY%JE^R~yKVYz?s(0`jz zdS&xSk927qYVkFPq1dU$mO@i(seVm^pZ?zg8FsfI5O@UtZQy8U8^izTZE+@##WA4b z~1 z=kkpvhljCyMjZK*T@4I)AkIh0BLCC&D%I`naPTlQ!#REBzc3)hoE4w2@EmMlibS+f zV_2AI9{A`&D*J)c+)10Kz`Bl;k0+lq{s#(+(=>%88VV5B$(uKC-v27<{vHtlxAX2B za`wyfR#|UtqW{7ZYJ9qo5H&m6o;I*LbgWn$5PL8jktk6qXEu4d2Ck2gcVa9*rzK6hlkSuEVPG)ZY=Z+#vejU930Dax$K26QdvJL}P*e(I~ zYAiA^J76EN+W}Ud!wn$)vWr$$-6MN~Rtv`jsnF??^kVQEr@@x0uvFWUGQhp)vy2EX z5HO&<>4=-FG*Bi$^g)jUUi|#RX&XCSp}w+U->m1PL7KXyKYe<4femMd`8wFcp+YQ) z)coVKR2eZLpCojt0Rj)DJn9G1l!&l!?!$*LdxNUOpSa9Q?%)`R=Y1m&KwbtpHE^6E z`+Jig0+@k~A3Y2oED{W|jrh7V$W)B#fW3UP{wOc6W^Yo~W|nY_L8NNw8XM=Qrz@~` z0F!OqyqV1p3$2co`x@!GEIG42q4V}_#&~MA#*W`8LT};fyiDh|@O_WK6O^LPWb_;$ zb*4T&)9gv%X20}~nTE_C!sF~J4L;zKsP~H7z2q84Cnq>cd@1i?C?C5ANb+k+ABQIW zRPXwKc0<>BQHADIt5YYu$0iP1@WKvH^VnEhdo0an0oWh&Y$pcFdDu zyqGSq5|eQvS8hb_w-$^J%r4q^YG7^&DVs^y{2g2vRPqqG(eRM`eeDh#s;dWQAORJc zzi0H*GBD_c`vdsE?&3uty%ZYfEWt<>OyY6-MPRFd9PRWvCix7%1rG)65Aij0gts3M zc`>*juH%b`Lse;o(ICUWhz@pOQd4GW2*fYy=LIn?xvfc7eApeS`TU!HdleQ;o?I8l zPy%G0PcI29UH+79U0wUH3jOX3(SOH<{*IoWUiw5(A_@}xIM5+nL+{8!?~%6zX9*So zZ3K3G0w^&vFkotTXeF)T=204-TelvRm0{{Rfx#z@uY74F0l0l(ygjhmWD;{0!1ysa9)B>s_)B-=k;->_+U zVKRjBrQ@&~`0$C1XpcadUoL3>7xz2)*H~)5BQQCcHPk^(^G}m15ZokEV_t;4N&G3P ziJPGp!*Y`cxRalcfwNn;Z_iIp!~2IZL_3ELaC_70Z{Ps~x5vGJi5C{Bt2^06oJQ0w zEG!rYx&AxOQFUhXMI%qJ3>zUo@SkwbeK^b~(sA#xC0ZT0>_g>?9DIE5-o6D8p-0{( zLP-PGIqc!fMRKU`-p%gkC!d;8E42GhPi*-ky2hjc;Xuv6@X=&!4Msztn$ucZhe6tO zDubUnBq7oL{{1fYn7@Pai4^-z-XraLRh^iq`nN$3T~7>%d8^C5B4VCW0}7)PGLFO!OP_{`)s?jM41DZt|(!}v%3eP3RkUzGn3zDQA^WOPB{WFOCKg9+Am|yCRf7_?jW_tfWffW&PRCx};C5;(DlcSQy&RIk44FCA7eO8a2KD~;qLm*pJ$0gWuvFwVSljgr>Xnee8b+Xk9`Yf@7qlyiSSHHx8ee z7(v%>sElZTX~|>o4X4%AZoPVS^lxz|uh@#g2aI8oS{v9taj9WU5^uqSU`xOu#}^d@UmJ0qt)wr}W$&^&(*l$>_1;5ro-~yp%*(-eG_O1Arqsx*Y_UWv-kBFiDga z&vz)NyL{kvo8DmW;*u$`9ZwD=W*cd9$9Zrf&iY2!jmr+!w|@bg6*vl;?jMzc^#Gex z0nh;&!l*(rVnUT}J9m9EU<2g(J?^v<9*bV(u!+EZU`cck4j5gV%acy>C~6Zel`$4eI%N{@qBZ-`19v;7i}Ov`m*ymE-xAy3g%vKi2A7 zJNU|H-6&1Wa0!!~C&9XXnrO*=;wOI*dMm159JwM3$r?4Wv;77P1K`NMyz=bwu+9k6 z)78b>ywwsAOaEKk&dN;V!{u|SimiiH82h+oswMil*SYw16HVzuQ$j(V?vQLwX z8e2C7=zoE=aIxh!qv)+Bk#oAbLE=GHe3GK1&7t6eY&GA&!Mzi^ui5zp1c>H$`)A%xEvwvK@X;C+Rcv~7yYk-JHM4smVvDbM|Z`D^z^iZ~HYT^F2s|dTajJ&5wgIDiHfP{U@-IMsJ=l#eG%7@V6PAm&5F5k{&kX{o7#*m2MgC-4igtna0dnN7I$ zDB&|XS8Hbn??C`1$IG{kw1%YA62X#WWs4K}L#mO4FMj^VE;qob0`@%p2$n5`5>L{y z;3~bmC7>gT)Fch5zWG&-=gGrkiS0SYrX zQ#@!Xn@+y}HQ+cTa6)yP9oKo0Gf5kPncC?MaHvV4&KsC<&hYJ3wBn>T@nMp)b0 z#$L(*PJsX?+JOMrgHW{%n*|yWxzPH|1bBiPaO2XQxKqGmVt|KM1ifAi9CPjPn+81) zC~7Kjd>=Tkcj`9G9 zA>x4N&icH1y13z>r~({oKS zg@BuKflGTfZZxcI^zNwvJ4Ai8iCQplmK3 literal 0 HcmV?d00001 From 21afb312bc7440e3643d247593ff3f0264477f2b Mon Sep 17 00:00:00 2001 From: "Diego M. Rodriguez" Date: Wed, 19 Dec 2018 14:48:02 +0100 Subject: [PATCH 34/34] Bump version to 0.8.0 --- CHANGELOG.rst | 4 ++++ qiskit/VERSION.txt | 2 +- setup.py | 2 +- 3 files changed, 6 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.rst b/CHANGELOG.rst index a6a3730c0f5d..1df47b43a0fd 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -17,6 +17,10 @@ The format is based on `Keep a Changelog`_. - **Security**: in case of vulnerabilities. +`UNRELEASED`_ +============= + + `0.7.0`_ - 2018-12-19 ===================== diff --git a/qiskit/VERSION.txt b/qiskit/VERSION.txt index faef31a4357c..a3df0a6959e1 100644 --- a/qiskit/VERSION.txt +++ b/qiskit/VERSION.txt @@ -1 +1 @@ -0.7.0 +0.8.0 diff --git a/setup.py b/setup.py index c62538acc9ab..4a63c4155de1 100755 --- a/setup.py +++ b/setup.py @@ -89,7 +89,7 @@ def has_ext_modules(self): setup( name="qiskit-terra", - version="0.7.0", + version="0.8.0", description="Software for developing quantum computing programs", long_description="""Terra provides the foundations for Qiskit. It allows the user to write quantum circuits easily, and takes care of the constraints of real hardware.""",

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 UDRxFsfq)-1C2hq@`A5P318H;)%K!iX literal 0 HcmV?d00001 diff --git a/doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_42_0.png b/doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_42_0.png new file mode 100644 index 0000000000000000000000000000000000000000..073e590a9de76937b9c9bda0cb26e77e345def23 GIT binary patch literal 64858 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 literal 0 HcmV?d00001 diff --git a/doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_6_0.png b/doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_6_0.png new file mode 100644 index 0000000000000000000000000000000000000000..eeee19b7b003a2ccfc815762bb31b654bd996dfc GIT binary patch literal 8843 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 literal 0 HcmV?d00001 diff --git a/doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_8_0.png b/doc/plotting_data_in_qiskit_files/plotting_data_in_qiskit_8_0.png new file mode 100644 index 0000000000000000000000000000000000000000..20a58ec6f2ff042128046a9a397641ed6b39314d GIT binary patch literal 11993 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 P1suHB_3M(a0>1kffEndy literal 0 HcmV?d00001 diff --git a/doc/plotting_data_in_qiskit_files/terra_parallel_tools.rst b/doc/plotting_data_in_qiskit_files/terra_parallel_tools.rst new file mode 100644 index 000000000000..fae65fa8a706 --- /dev/null +++ b/doc/plotting_data_in_qiskit_files/terra_parallel_tools.rst @@ -0,0 +1,130 @@ + + + +Using the Qiskit Terra parallel_map +=================================== + +In this tutorial we will see how to leverage the ``parallel_map`` +routine in Qiskit Terra to execute functions in parallel, and track the +progress of these parallel tasks using progress bars. + +.. code:: ipython3 + + from qiskit import * + from qiskit.tools.parallel import parallel_map + from qiskit.tools.events import TextProgressBar + from qiskit.tools.jupyter import * # Needed to load the Jupyter HTMLProgressBar + +Define a function that builds a single Quantum Volume circuit +------------------------------------------------------------- + +Here we will construct a set of 1000 Quantum Volume circuits of width +and depth 4. For a technical discussion of Quantum Volume see: +https://arxiv.org/abs/1811.12926. + +.. code:: ipython3 + + num_circuits = 1000 + width = 4 + depth = 4 + +.. code:: ipython3 + + import copy + import math + import numpy as np + from qiskit.tools.qi.qi import random_unitary_matrix + from qiskit.mapper import two_qubit_kak + +In preparation for executing in parallel, the code below takes an index +value, an array of random number seeds, and the width and depth of the +circuit as inputs. + +.. code:: ipython3 + + def build_qv_circuit(idx, seeds, width, depth): + """Builds a single Quantum Volume circuit. Two circuits, + one with measurements, and one widthout, are returned. + + The model circuits consist of layers of Haar random + elements of SU(4) applied between corresponding pairs + of qubits in a random bipartition. + + See: https://arxiv.org/abs/1811.12926 + """ + np.random.seed(seeds[idx]) + q = QuantumRegister(width, "q") + c = ClassicalRegister(width, "c") + # Create measurement subcircuit + qc = QuantumCircuit(q,c) + # For each layer + for j in range(depth): + # Generate uniformly random permutation Pj of [0...n-1] + perm = np.random.permutation(width) + # For each pair p in Pj, generate Haar random SU(4) + # Decompose each SU(4) into CNOT + SU(2) and add to Ci + for k in range(math.floor(width/2)): + qubits = [int(perm[2*k]), int(perm[2*k+1])] + U = random_unitary_matrix(4) + for gate in two_qubit_kak(U): + i0 = qubits[gate["args"][0]] + if gate["name"] == "cx": + i1 = qubits[gate["args"][1]] + qc.cx(q[i0], q[i1]) + elif gate["name"] == "u1": + qc.u1(gate["params"][2], q[i0]) + elif gate["name"] == "u2": + qc.u2(gate["params"][1], gate["params"][2], + q[i0]) + elif gate["name"] == "u3": + qc.u3(gate["params"][0], gate["params"][1], + gate["params"][2], q[i0]) + elif gate["name"] == "id": + pass # do nothing + qc_no_meas = copy.deepcopy(qc) + # Create circuit with final measurement + qc.measure(q,c) + return qc, qc_no_meas + +Generate 1000 circuits in parallel and track progress +----------------------------------------------------- + +Becuase Quantum Volume circuits are generated randomly for the NumPy +random number generator, we must be careful when running in parallel. If +the random number generator is not explicitly seeded, the computer uses +the current time as a seed value. When running in parallel, this can +result in each process starting with the saem seed value, and thus not +giving random results. Here we generate all the random seed values +needed, and pass this into ``parallel_map`` as a extra argument in +``task_args``, along with ``width`` and ``depth``. The main function +argument passed in ``parallel_map`` is just an array that indexes the +processes and seed value. + +.. code:: ipython3 + + num_circuits = 1000 + seeds = np.random.randint(np.iinfo(np.int32).max, size=num_circuits) + TextProgressBar() + parallel_map(build_qv_circuit, np.arange(num_circuits), task_args=(seeds, width, depth)); + + +.. parsed-literal:: + + |██████████████████████████████████████████████████| 1000/1000 [00:00:00:00] + + +Use a Jupyter progress bar +-------------------------- + +.. code:: ipython3 + + seeds = np.random.randint(np.iinfo(np.int32).max, size=num_circuits) + HTMLProgressBar() + parallel_map(build_qv_circuit, np.arange(num_circuits), task_args=(seeds, width, depth)); + + + +.. parsed-literal:: + + VBox(children=(HTML(value=''), IntProgress(value=0, bar_style='info', max=1000))) + diff --git a/doc/quantum_circuits.rst b/doc/quantum_circuits.rst new file mode 100644 index 000000000000..ff9293506df5 --- /dev/null +++ b/doc/quantum_circuits.rst @@ -0,0 +1,678 @@ + + + +Quantum Circuits +================ + +The ``QuantumCircuit``, ``QuantumRegister``, and ``ClassicalRegister`` +are the main objects for Qiskit Terra. Most users will be able to do all +they want with these objects. + +.. code:: ipython3 + + import numpy as np + from qiskit import QuantumCircuit, ClassicalRegister, QuantumRegister + from qiskit import BasicAer, execute + from qiskit.quantum_info import Pauli, state_fidelity, basis_state, process_fidelity + +Quantum and Classical Registers +------------------------------- + +Quantum and Classical Registers are declared using the following: + +.. code:: ipython3 + + q0 = QuantumRegister(2, 'q0') + c0 = ClassicalRegister(2, 'c0') + q1 = QuantumRegister(2, 'q1') + c1 = ClassicalRegister(2, 'c1') + q_test = QuantumRegister(2, 'q0') + +The name is optional. If not given Qiskit will name it :math:`qi` where +:math:`i` is an interger which will count from 0. The name and size can +be returned using the following: + +.. code:: ipython3 + + print(q0.name) + print(q0.size) + + +.. parsed-literal:: + + q0 + 2 + + +You can test if the register are the same or different. + +.. code:: ipython3 + + q0==q0 + + + + +.. parsed-literal:: + + True + + + +.. code:: ipython3 + + q0==q_test + + + + +.. parsed-literal:: + + True + + + +.. code:: ipython3 + + q0==q1 + + + + +.. parsed-literal:: + + False + + + +Quantum Circuits +---------------- + +Quantum Circuits are made using registers. Either when initiated or by +using the ``add_register`` command. + +.. code:: ipython3 + + circ = QuantumCircuit(q0, q1) + circ.x(q0[1]) + circ.x(q1[0]) + circ.draw() + + + + +.. raw:: html + +