qiskit 2.1.0rc1__cp39-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (699) hide show
  1. qiskit/VERSION.txt +1 -0
  2. qiskit/__init__.py +159 -0
  3. qiskit/_accelerate.abi3.so +0 -0
  4. qiskit/_numpy_compat.py +73 -0
  5. qiskit/circuit/__init__.py +1335 -0
  6. qiskit/circuit/_add_control.py +338 -0
  7. qiskit/circuit/_classical_resource_map.py +154 -0
  8. qiskit/circuit/_standard_gates_commutations.py +3849 -0
  9. qiskit/circuit/_utils.py +167 -0
  10. qiskit/circuit/annotated_operation.py +279 -0
  11. qiskit/circuit/annotation.py +404 -0
  12. qiskit/circuit/barrier.py +46 -0
  13. qiskit/circuit/classical/__init__.py +41 -0
  14. qiskit/circuit/classical/expr/__init__.py +266 -0
  15. qiskit/circuit/classical/expr/constructors.py +764 -0
  16. qiskit/circuit/classical/expr/expr.py +156 -0
  17. qiskit/circuit/classical/expr/visitors.py +381 -0
  18. qiskit/circuit/classical/types/__init__.py +113 -0
  19. qiskit/circuit/classical/types/ordering.py +229 -0
  20. qiskit/circuit/classical/types/types.py +30 -0
  21. qiskit/circuit/commutation_checker.py +133 -0
  22. qiskit/circuit/commutation_library.py +20 -0
  23. qiskit/circuit/controlflow/__init__.py +59 -0
  24. qiskit/circuit/controlflow/_builder_utils.py +211 -0
  25. qiskit/circuit/controlflow/box.py +188 -0
  26. qiskit/circuit/controlflow/break_loop.py +56 -0
  27. qiskit/circuit/controlflow/builder.py +791 -0
  28. qiskit/circuit/controlflow/continue_loop.py +56 -0
  29. qiskit/circuit/controlflow/control_flow.py +94 -0
  30. qiskit/circuit/controlflow/for_loop.py +218 -0
  31. qiskit/circuit/controlflow/if_else.py +498 -0
  32. qiskit/circuit/controlflow/switch_case.py +411 -0
  33. qiskit/circuit/controlflow/while_loop.py +166 -0
  34. qiskit/circuit/controlledgate.py +274 -0
  35. qiskit/circuit/delay.py +159 -0
  36. qiskit/circuit/duration.py +80 -0
  37. qiskit/circuit/equivalence.py +94 -0
  38. qiskit/circuit/equivalence_library.py +18 -0
  39. qiskit/circuit/exceptions.py +19 -0
  40. qiskit/circuit/gate.py +261 -0
  41. qiskit/circuit/instruction.py +564 -0
  42. qiskit/circuit/instructionset.py +132 -0
  43. qiskit/circuit/library/__init__.py +984 -0
  44. qiskit/circuit/library/arithmetic/__init__.py +40 -0
  45. qiskit/circuit/library/arithmetic/adders/__init__.py +18 -0
  46. qiskit/circuit/library/arithmetic/adders/adder.py +235 -0
  47. qiskit/circuit/library/arithmetic/adders/cdkm_ripple_carry_adder.py +123 -0
  48. qiskit/circuit/library/arithmetic/adders/draper_qft_adder.py +129 -0
  49. qiskit/circuit/library/arithmetic/adders/vbe_ripple_carry_adder.py +95 -0
  50. qiskit/circuit/library/arithmetic/exact_reciprocal.py +131 -0
  51. qiskit/circuit/library/arithmetic/functional_pauli_rotations.py +114 -0
  52. qiskit/circuit/library/arithmetic/integer_comparator.py +200 -0
  53. qiskit/circuit/library/arithmetic/linear_amplitude_function.py +363 -0
  54. qiskit/circuit/library/arithmetic/linear_pauli_rotations.py +243 -0
  55. qiskit/circuit/library/arithmetic/multipliers/__init__.py +17 -0
  56. qiskit/circuit/library/arithmetic/multipliers/hrs_cumulative_multiplier.py +145 -0
  57. qiskit/circuit/library/arithmetic/multipliers/multiplier.py +201 -0
  58. qiskit/circuit/library/arithmetic/multipliers/rg_qft_multiplier.py +108 -0
  59. qiskit/circuit/library/arithmetic/piecewise_chebyshev.py +506 -0
  60. qiskit/circuit/library/arithmetic/piecewise_linear_pauli_rotations.py +395 -0
  61. qiskit/circuit/library/arithmetic/piecewise_polynomial_pauli_rotations.py +501 -0
  62. qiskit/circuit/library/arithmetic/polynomial_pauli_rotations.py +389 -0
  63. qiskit/circuit/library/arithmetic/quadratic_form.py +370 -0
  64. qiskit/circuit/library/arithmetic/weighted_adder.py +428 -0
  65. qiskit/circuit/library/basis_change/__init__.py +15 -0
  66. qiskit/circuit/library/basis_change/qft.py +316 -0
  67. qiskit/circuit/library/bit_flip_oracle.py +130 -0
  68. qiskit/circuit/library/blueprintcircuit.py +322 -0
  69. qiskit/circuit/library/boolean_logic/__init__.py +18 -0
  70. qiskit/circuit/library/boolean_logic/inner_product.py +157 -0
  71. qiskit/circuit/library/boolean_logic/quantum_and.py +204 -0
  72. qiskit/circuit/library/boolean_logic/quantum_or.py +206 -0
  73. qiskit/circuit/library/boolean_logic/quantum_xor.py +167 -0
  74. qiskit/circuit/library/data_preparation/__init__.py +57 -0
  75. qiskit/circuit/library/data_preparation/_z_feature_map.py +115 -0
  76. qiskit/circuit/library/data_preparation/_zz_feature_map.py +150 -0
  77. qiskit/circuit/library/data_preparation/initializer.py +107 -0
  78. qiskit/circuit/library/data_preparation/pauli_feature_map.py +656 -0
  79. qiskit/circuit/library/data_preparation/state_preparation.py +336 -0
  80. qiskit/circuit/library/fourier_checking.py +160 -0
  81. qiskit/circuit/library/generalized_gates/__init__.py +30 -0
  82. qiskit/circuit/library/generalized_gates/diagonal.py +163 -0
  83. qiskit/circuit/library/generalized_gates/gms.py +179 -0
  84. qiskit/circuit/library/generalized_gates/gr.py +219 -0
  85. qiskit/circuit/library/generalized_gates/isometry.py +370 -0
  86. qiskit/circuit/library/generalized_gates/linear_function.py +318 -0
  87. qiskit/circuit/library/generalized_gates/mcg_up_to_diagonal.py +143 -0
  88. qiskit/circuit/library/generalized_gates/mcmt.py +316 -0
  89. qiskit/circuit/library/generalized_gates/pauli.py +84 -0
  90. qiskit/circuit/library/generalized_gates/permutation.py +202 -0
  91. qiskit/circuit/library/generalized_gates/rv.py +96 -0
  92. qiskit/circuit/library/generalized_gates/uc.py +303 -0
  93. qiskit/circuit/library/generalized_gates/uc_pauli_rot.py +164 -0
  94. qiskit/circuit/library/generalized_gates/ucrx.py +32 -0
  95. qiskit/circuit/library/generalized_gates/ucry.py +32 -0
  96. qiskit/circuit/library/generalized_gates/ucrz.py +32 -0
  97. qiskit/circuit/library/generalized_gates/unitary.py +236 -0
  98. qiskit/circuit/library/graph_state.py +172 -0
  99. qiskit/circuit/library/grover_operator.py +583 -0
  100. qiskit/circuit/library/hamiltonian_gate.py +142 -0
  101. qiskit/circuit/library/hidden_linear_function.py +163 -0
  102. qiskit/circuit/library/iqp.py +180 -0
  103. qiskit/circuit/library/n_local/__init__.py +45 -0
  104. qiskit/circuit/library/n_local/efficient_su2.py +282 -0
  105. qiskit/circuit/library/n_local/evolved_operator_ansatz.py +520 -0
  106. qiskit/circuit/library/n_local/excitation_preserving.py +301 -0
  107. qiskit/circuit/library/n_local/n_local.py +1478 -0
  108. qiskit/circuit/library/n_local/pauli_two_design.py +246 -0
  109. qiskit/circuit/library/n_local/qaoa_ansatz.py +367 -0
  110. qiskit/circuit/library/n_local/real_amplitudes.py +312 -0
  111. qiskit/circuit/library/n_local/two_local.py +289 -0
  112. qiskit/circuit/library/overlap.py +183 -0
  113. qiskit/circuit/library/pauli_evolution.py +202 -0
  114. qiskit/circuit/library/phase_estimation.py +177 -0
  115. qiskit/circuit/library/phase_oracle.py +239 -0
  116. qiskit/circuit/library/quantum_volume.py +179 -0
  117. qiskit/circuit/library/standard_gates/__init__.py +141 -0
  118. qiskit/circuit/library/standard_gates/dcx.py +76 -0
  119. qiskit/circuit/library/standard_gates/ecr.py +126 -0
  120. qiskit/circuit/library/standard_gates/equivalence_library.py +1936 -0
  121. qiskit/circuit/library/standard_gates/global_phase.py +83 -0
  122. qiskit/circuit/library/standard_gates/h.py +230 -0
  123. qiskit/circuit/library/standard_gates/i.py +76 -0
  124. qiskit/circuit/library/standard_gates/iswap.py +115 -0
  125. qiskit/circuit/library/standard_gates/p.py +415 -0
  126. qiskit/circuit/library/standard_gates/r.py +108 -0
  127. qiskit/circuit/library/standard_gates/rx.py +269 -0
  128. qiskit/circuit/library/standard_gates/rxx.py +165 -0
  129. qiskit/circuit/library/standard_gates/ry.py +268 -0
  130. qiskit/circuit/library/standard_gates/ryy.py +165 -0
  131. qiskit/circuit/library/standard_gates/rz.py +290 -0
  132. qiskit/circuit/library/standard_gates/rzx.py +211 -0
  133. qiskit/circuit/library/standard_gates/rzz.py +181 -0
  134. qiskit/circuit/library/standard_gates/s.py +424 -0
  135. qiskit/circuit/library/standard_gates/swap.py +268 -0
  136. qiskit/circuit/library/standard_gates/sx.py +303 -0
  137. qiskit/circuit/library/standard_gates/t.py +169 -0
  138. qiskit/circuit/library/standard_gates/u.py +379 -0
  139. qiskit/circuit/library/standard_gates/u1.py +466 -0
  140. qiskit/circuit/library/standard_gates/u2.py +145 -0
  141. qiskit/circuit/library/standard_gates/u3.py +412 -0
  142. qiskit/circuit/library/standard_gates/x.py +1335 -0
  143. qiskit/circuit/library/standard_gates/xx_minus_yy.py +164 -0
  144. qiskit/circuit/library/standard_gates/xx_plus_yy.py +197 -0
  145. qiskit/circuit/library/standard_gates/y.py +253 -0
  146. qiskit/circuit/library/standard_gates/z.py +331 -0
  147. qiskit/circuit/library/templates/__init__.py +92 -0
  148. qiskit/circuit/library/templates/clifford/__init__.py +33 -0
  149. qiskit/circuit/library/templates/clifford/clifford_2_1.py +34 -0
  150. qiskit/circuit/library/templates/clifford/clifford_2_2.py +35 -0
  151. qiskit/circuit/library/templates/clifford/clifford_2_3.py +34 -0
  152. qiskit/circuit/library/templates/clifford/clifford_2_4.py +34 -0
  153. qiskit/circuit/library/templates/clifford/clifford_3_1.py +35 -0
  154. qiskit/circuit/library/templates/clifford/clifford_4_1.py +38 -0
  155. qiskit/circuit/library/templates/clifford/clifford_4_2.py +37 -0
  156. qiskit/circuit/library/templates/clifford/clifford_4_3.py +38 -0
  157. qiskit/circuit/library/templates/clifford/clifford_4_4.py +37 -0
  158. qiskit/circuit/library/templates/clifford/clifford_5_1.py +40 -0
  159. qiskit/circuit/library/templates/clifford/clifford_6_1.py +40 -0
  160. qiskit/circuit/library/templates/clifford/clifford_6_2.py +40 -0
  161. qiskit/circuit/library/templates/clifford/clifford_6_3.py +40 -0
  162. qiskit/circuit/library/templates/clifford/clifford_6_4.py +38 -0
  163. qiskit/circuit/library/templates/clifford/clifford_6_5.py +40 -0
  164. qiskit/circuit/library/templates/clifford/clifford_8_1.py +42 -0
  165. qiskit/circuit/library/templates/clifford/clifford_8_2.py +42 -0
  166. qiskit/circuit/library/templates/clifford/clifford_8_3.py +41 -0
  167. qiskit/circuit/library/templates/nct/__init__.py +67 -0
  168. qiskit/circuit/library/templates/nct/template_nct_2a_1.py +34 -0
  169. qiskit/circuit/library/templates/nct/template_nct_2a_2.py +35 -0
  170. qiskit/circuit/library/templates/nct/template_nct_2a_3.py +37 -0
  171. qiskit/circuit/library/templates/nct/template_nct_4a_1.py +43 -0
  172. qiskit/circuit/library/templates/nct/template_nct_4a_2.py +41 -0
  173. qiskit/circuit/library/templates/nct/template_nct_4a_3.py +39 -0
  174. qiskit/circuit/library/templates/nct/template_nct_4b_1.py +41 -0
  175. qiskit/circuit/library/templates/nct/template_nct_4b_2.py +39 -0
  176. qiskit/circuit/library/templates/nct/template_nct_5a_1.py +40 -0
  177. qiskit/circuit/library/templates/nct/template_nct_5a_2.py +40 -0
  178. qiskit/circuit/library/templates/nct/template_nct_5a_3.py +40 -0
  179. qiskit/circuit/library/templates/nct/template_nct_5a_4.py +39 -0
  180. qiskit/circuit/library/templates/nct/template_nct_6a_1.py +40 -0
  181. qiskit/circuit/library/templates/nct/template_nct_6a_2.py +41 -0
  182. qiskit/circuit/library/templates/nct/template_nct_6a_3.py +41 -0
  183. qiskit/circuit/library/templates/nct/template_nct_6a_4.py +41 -0
  184. qiskit/circuit/library/templates/nct/template_nct_6b_1.py +41 -0
  185. qiskit/circuit/library/templates/nct/template_nct_6b_2.py +41 -0
  186. qiskit/circuit/library/templates/nct/template_nct_6c_1.py +41 -0
  187. qiskit/circuit/library/templates/nct/template_nct_7a_1.py +43 -0
  188. qiskit/circuit/library/templates/nct/template_nct_7b_1.py +43 -0
  189. qiskit/circuit/library/templates/nct/template_nct_7c_1.py +43 -0
  190. qiskit/circuit/library/templates/nct/template_nct_7d_1.py +43 -0
  191. qiskit/circuit/library/templates/nct/template_nct_7e_1.py +43 -0
  192. qiskit/circuit/library/templates/nct/template_nct_9a_1.py +45 -0
  193. qiskit/circuit/library/templates/nct/template_nct_9c_1.py +43 -0
  194. qiskit/circuit/library/templates/nct/template_nct_9c_10.py +44 -0
  195. qiskit/circuit/library/templates/nct/template_nct_9c_11.py +44 -0
  196. qiskit/circuit/library/templates/nct/template_nct_9c_12.py +44 -0
  197. qiskit/circuit/library/templates/nct/template_nct_9c_2.py +44 -0
  198. qiskit/circuit/library/templates/nct/template_nct_9c_3.py +44 -0
  199. qiskit/circuit/library/templates/nct/template_nct_9c_4.py +44 -0
  200. qiskit/circuit/library/templates/nct/template_nct_9c_5.py +44 -0
  201. qiskit/circuit/library/templates/nct/template_nct_9c_6.py +44 -0
  202. qiskit/circuit/library/templates/nct/template_nct_9c_7.py +44 -0
  203. qiskit/circuit/library/templates/nct/template_nct_9c_8.py +44 -0
  204. qiskit/circuit/library/templates/nct/template_nct_9c_9.py +44 -0
  205. qiskit/circuit/library/templates/nct/template_nct_9d_1.py +43 -0
  206. qiskit/circuit/library/templates/nct/template_nct_9d_10.py +44 -0
  207. qiskit/circuit/library/templates/nct/template_nct_9d_2.py +44 -0
  208. qiskit/circuit/library/templates/nct/template_nct_9d_3.py +44 -0
  209. qiskit/circuit/library/templates/nct/template_nct_9d_4.py +44 -0
  210. qiskit/circuit/library/templates/nct/template_nct_9d_5.py +44 -0
  211. qiskit/circuit/library/templates/nct/template_nct_9d_6.py +44 -0
  212. qiskit/circuit/library/templates/nct/template_nct_9d_7.py +44 -0
  213. qiskit/circuit/library/templates/nct/template_nct_9d_8.py +44 -0
  214. qiskit/circuit/library/templates/nct/template_nct_9d_9.py +44 -0
  215. qiskit/circuit/library/templates/rzx/__init__.py +25 -0
  216. qiskit/circuit/library/templates/rzx/rzx_cy.py +47 -0
  217. qiskit/circuit/library/templates/rzx/rzx_xz.py +54 -0
  218. qiskit/circuit/library/templates/rzx/rzx_yz.py +45 -0
  219. qiskit/circuit/library/templates/rzx/rzx_zz1.py +69 -0
  220. qiskit/circuit/library/templates/rzx/rzx_zz2.py +59 -0
  221. qiskit/circuit/library/templates/rzx/rzx_zz3.py +59 -0
  222. qiskit/circuit/measure.py +53 -0
  223. qiskit/circuit/operation.py +68 -0
  224. qiskit/circuit/parameter.py +188 -0
  225. qiskit/circuit/parameterexpression.py +737 -0
  226. qiskit/circuit/parametertable.py +119 -0
  227. qiskit/circuit/parametervector.py +140 -0
  228. qiskit/circuit/quantumcircuit.py +7610 -0
  229. qiskit/circuit/quantumcircuitdata.py +137 -0
  230. qiskit/circuit/random/__init__.py +50 -0
  231. qiskit/circuit/random/utils.py +755 -0
  232. qiskit/circuit/reset.py +37 -0
  233. qiskit/circuit/singleton.py +600 -0
  234. qiskit/circuit/store.py +89 -0
  235. qiskit/circuit/tools/__init__.py +16 -0
  236. qiskit/circuit/tools/pi_check.py +185 -0
  237. qiskit/circuit/twirling.py +145 -0
  238. qiskit/compiler/__init__.py +27 -0
  239. qiskit/compiler/transpiler.py +375 -0
  240. qiskit/converters/__init__.py +74 -0
  241. qiskit/converters/circuit_to_dag.py +80 -0
  242. qiskit/converters/circuit_to_dagdependency.py +49 -0
  243. qiskit/converters/circuit_to_dagdependency_v2.py +46 -0
  244. qiskit/converters/circuit_to_gate.py +107 -0
  245. qiskit/converters/circuit_to_instruction.py +142 -0
  246. qiskit/converters/dag_to_circuit.py +79 -0
  247. qiskit/converters/dag_to_dagdependency.py +54 -0
  248. qiskit/converters/dag_to_dagdependency_v2.py +43 -0
  249. qiskit/converters/dagdependency_to_circuit.py +40 -0
  250. qiskit/converters/dagdependency_to_dag.py +48 -0
  251. qiskit/dagcircuit/__init__.py +44 -0
  252. qiskit/dagcircuit/collect_blocks.py +403 -0
  253. qiskit/dagcircuit/dagcircuit.py +24 -0
  254. qiskit/dagcircuit/dagdependency.py +612 -0
  255. qiskit/dagcircuit/dagdependency_v2.py +566 -0
  256. qiskit/dagcircuit/dagdepnode.py +160 -0
  257. qiskit/dagcircuit/dagnode.py +193 -0
  258. qiskit/dagcircuit/exceptions.py +42 -0
  259. qiskit/exceptions.py +153 -0
  260. qiskit/passmanager/__init__.py +258 -0
  261. qiskit/passmanager/base_tasks.py +230 -0
  262. qiskit/passmanager/compilation_status.py +74 -0
  263. qiskit/passmanager/exceptions.py +19 -0
  264. qiskit/passmanager/flow_controllers.py +116 -0
  265. qiskit/passmanager/passmanager.py +353 -0
  266. qiskit/primitives/__init__.py +490 -0
  267. qiskit/primitives/backend_estimator_v2.py +530 -0
  268. qiskit/primitives/backend_sampler_v2.py +339 -0
  269. qiskit/primitives/base/__init__.py +20 -0
  270. qiskit/primitives/base/base_estimator.py +247 -0
  271. qiskit/primitives/base/base_primitive_job.py +78 -0
  272. qiskit/primitives/base/base_primitive_v1.py +45 -0
  273. qiskit/primitives/base/base_result_v1.py +65 -0
  274. qiskit/primitives/base/base_sampler.py +196 -0
  275. qiskit/primitives/base/estimator_result_v1.py +46 -0
  276. qiskit/primitives/base/sampler_result_v1.py +45 -0
  277. qiskit/primitives/base/validation_v1.py +250 -0
  278. qiskit/primitives/containers/__init__.py +26 -0
  279. qiskit/primitives/containers/bindings_array.py +391 -0
  280. qiskit/primitives/containers/bit_array.py +764 -0
  281. qiskit/primitives/containers/data_bin.py +172 -0
  282. qiskit/primitives/containers/estimator_pub.py +222 -0
  283. qiskit/primitives/containers/object_array.py +94 -0
  284. qiskit/primitives/containers/observables_array.py +380 -0
  285. qiskit/primitives/containers/primitive_result.py +53 -0
  286. qiskit/primitives/containers/pub_result.py +51 -0
  287. qiskit/primitives/containers/sampler_pub.py +193 -0
  288. qiskit/primitives/containers/sampler_pub_result.py +74 -0
  289. qiskit/primitives/containers/shape.py +129 -0
  290. qiskit/primitives/primitive_job.py +100 -0
  291. qiskit/primitives/statevector_estimator.py +175 -0
  292. qiskit/primitives/statevector_sampler.py +290 -0
  293. qiskit/primitives/utils.py +72 -0
  294. qiskit/providers/__init__.py +677 -0
  295. qiskit/providers/backend.py +364 -0
  296. qiskit/providers/basic_provider/__init__.py +47 -0
  297. qiskit/providers/basic_provider/basic_provider.py +121 -0
  298. qiskit/providers/basic_provider/basic_provider_job.py +65 -0
  299. qiskit/providers/basic_provider/basic_provider_tools.py +218 -0
  300. qiskit/providers/basic_provider/basic_simulator.py +693 -0
  301. qiskit/providers/basic_provider/exceptions.py +30 -0
  302. qiskit/providers/exceptions.py +33 -0
  303. qiskit/providers/fake_provider/__init__.py +69 -0
  304. qiskit/providers/fake_provider/generic_backend_v2.py +376 -0
  305. qiskit/providers/fake_provider/utils/__init__.py +15 -0
  306. qiskit/providers/job.py +147 -0
  307. qiskit/providers/jobstatus.py +30 -0
  308. qiskit/providers/options.py +273 -0
  309. qiskit/providers/providerutils.py +110 -0
  310. qiskit/qasm/libs/dummy/stdgates.inc +75 -0
  311. qiskit/qasm/libs/qelib1.inc +266 -0
  312. qiskit/qasm/libs/stdgates.inc +82 -0
  313. qiskit/qasm2/__init__.py +669 -0
  314. qiskit/qasm2/exceptions.py +27 -0
  315. qiskit/qasm2/export.py +364 -0
  316. qiskit/qasm2/parse.py +438 -0
  317. qiskit/qasm3/__init__.py +466 -0
  318. qiskit/qasm3/ast.py +796 -0
  319. qiskit/qasm3/exceptions.py +27 -0
  320. qiskit/qasm3/experimental.py +70 -0
  321. qiskit/qasm3/exporter.py +1363 -0
  322. qiskit/qasm3/printer.py +620 -0
  323. qiskit/qpy/__init__.py +2141 -0
  324. qiskit/qpy/binary_io/__init__.py +35 -0
  325. qiskit/qpy/binary_io/circuits.py +1687 -0
  326. qiskit/qpy/binary_io/parse_sympy_repr.py +126 -0
  327. qiskit/qpy/binary_io/schedules.py +288 -0
  328. qiskit/qpy/binary_io/value.py +1183 -0
  329. qiskit/qpy/common.py +361 -0
  330. qiskit/qpy/exceptions.py +53 -0
  331. qiskit/qpy/formats.py +458 -0
  332. qiskit/qpy/interface.py +384 -0
  333. qiskit/qpy/type_keys.py +415 -0
  334. qiskit/quantum_info/__init__.py +172 -0
  335. qiskit/quantum_info/analysis/__init__.py +17 -0
  336. qiskit/quantum_info/analysis/average.py +47 -0
  337. qiskit/quantum_info/analysis/distance.py +104 -0
  338. qiskit/quantum_info/analysis/make_observable.py +44 -0
  339. qiskit/quantum_info/analysis/z2_symmetries.py +484 -0
  340. qiskit/quantum_info/operators/__init__.py +29 -0
  341. qiskit/quantum_info/operators/base_operator.py +145 -0
  342. qiskit/quantum_info/operators/channel/__init__.py +29 -0
  343. qiskit/quantum_info/operators/channel/chi.py +191 -0
  344. qiskit/quantum_info/operators/channel/choi.py +218 -0
  345. qiskit/quantum_info/operators/channel/kraus.py +337 -0
  346. qiskit/quantum_info/operators/channel/ptm.py +204 -0
  347. qiskit/quantum_info/operators/channel/quantum_channel.py +348 -0
  348. qiskit/quantum_info/operators/channel/stinespring.py +296 -0
  349. qiskit/quantum_info/operators/channel/superop.py +373 -0
  350. qiskit/quantum_info/operators/channel/transformations.py +490 -0
  351. qiskit/quantum_info/operators/custom_iterator.py +48 -0
  352. qiskit/quantum_info/operators/dihedral/__init__.py +18 -0
  353. qiskit/quantum_info/operators/dihedral/dihedral.py +511 -0
  354. qiskit/quantum_info/operators/dihedral/dihedral_circuits.py +216 -0
  355. qiskit/quantum_info/operators/dihedral/polynomial.py +313 -0
  356. qiskit/quantum_info/operators/dihedral/random.py +64 -0
  357. qiskit/quantum_info/operators/linear_op.py +25 -0
  358. qiskit/quantum_info/operators/measures.py +418 -0
  359. qiskit/quantum_info/operators/mixins/__init__.py +52 -0
  360. qiskit/quantum_info/operators/mixins/adjoint.py +52 -0
  361. qiskit/quantum_info/operators/mixins/group.py +171 -0
  362. qiskit/quantum_info/operators/mixins/linear.py +84 -0
  363. qiskit/quantum_info/operators/mixins/multiply.py +62 -0
  364. qiskit/quantum_info/operators/mixins/tolerances.py +72 -0
  365. qiskit/quantum_info/operators/op_shape.py +525 -0
  366. qiskit/quantum_info/operators/operator.py +869 -0
  367. qiskit/quantum_info/operators/operator_utils.py +76 -0
  368. qiskit/quantum_info/operators/predicates.py +183 -0
  369. qiskit/quantum_info/operators/random.py +154 -0
  370. qiskit/quantum_info/operators/scalar_op.py +254 -0
  371. qiskit/quantum_info/operators/symplectic/__init__.py +24 -0
  372. qiskit/quantum_info/operators/symplectic/base_pauli.py +719 -0
  373. qiskit/quantum_info/operators/symplectic/clifford.py +1032 -0
  374. qiskit/quantum_info/operators/symplectic/clifford_circuits.py +584 -0
  375. qiskit/quantum_info/operators/symplectic/pauli.py +755 -0
  376. qiskit/quantum_info/operators/symplectic/pauli_list.py +1242 -0
  377. qiskit/quantum_info/operators/symplectic/pauli_utils.py +40 -0
  378. qiskit/quantum_info/operators/symplectic/random.py +117 -0
  379. qiskit/quantum_info/operators/symplectic/sparse_pauli_op.py +1239 -0
  380. qiskit/quantum_info/operators/utils/__init__.py +20 -0
  381. qiskit/quantum_info/operators/utils/anti_commutator.py +36 -0
  382. qiskit/quantum_info/operators/utils/commutator.py +36 -0
  383. qiskit/quantum_info/operators/utils/double_commutator.py +76 -0
  384. qiskit/quantum_info/quaternion.py +156 -0
  385. qiskit/quantum_info/random.py +26 -0
  386. qiskit/quantum_info/states/__init__.py +28 -0
  387. qiskit/quantum_info/states/densitymatrix.py +857 -0
  388. qiskit/quantum_info/states/measures.py +288 -0
  389. qiskit/quantum_info/states/quantum_state.py +503 -0
  390. qiskit/quantum_info/states/random.py +157 -0
  391. qiskit/quantum_info/states/stabilizerstate.py +805 -0
  392. qiskit/quantum_info/states/statevector.py +977 -0
  393. qiskit/quantum_info/states/utils.py +247 -0
  394. qiskit/result/__init__.py +61 -0
  395. qiskit/result/counts.py +189 -0
  396. qiskit/result/distributions/__init__.py +17 -0
  397. qiskit/result/distributions/probability.py +100 -0
  398. qiskit/result/distributions/quasi.py +154 -0
  399. qiskit/result/exceptions.py +40 -0
  400. qiskit/result/models.py +241 -0
  401. qiskit/result/postprocess.py +239 -0
  402. qiskit/result/result.py +385 -0
  403. qiskit/result/sampled_expval.py +76 -0
  404. qiskit/result/utils.py +294 -0
  405. qiskit/synthesis/__init__.py +250 -0
  406. qiskit/synthesis/arithmetic/__init__.py +18 -0
  407. qiskit/synthesis/arithmetic/adders/__init__.py +18 -0
  408. qiskit/synthesis/arithmetic/adders/cdkm_ripple_carry_adder.py +154 -0
  409. qiskit/synthesis/arithmetic/adders/draper_qft_adder.py +107 -0
  410. qiskit/synthesis/arithmetic/adders/rv_ripple_carry_adder.py +156 -0
  411. qiskit/synthesis/arithmetic/adders/vbe_ripple_carry_adder.py +161 -0
  412. qiskit/synthesis/arithmetic/comparators/__init__.py +16 -0
  413. qiskit/synthesis/arithmetic/comparators/compare_2s.py +112 -0
  414. qiskit/synthesis/arithmetic/comparators/compare_greedy.py +66 -0
  415. qiskit/synthesis/arithmetic/multipliers/__init__.py +16 -0
  416. qiskit/synthesis/arithmetic/multipliers/hrs_cumulative_multiplier.py +103 -0
  417. qiskit/synthesis/arithmetic/multipliers/rg_qft_multiplier.py +100 -0
  418. qiskit/synthesis/arithmetic/weighted_sum.py +155 -0
  419. qiskit/synthesis/boolean/__init__.py +13 -0
  420. qiskit/synthesis/boolean/boolean_expression.py +231 -0
  421. qiskit/synthesis/boolean/boolean_expression_synth.py +124 -0
  422. qiskit/synthesis/boolean/boolean_expression_visitor.py +96 -0
  423. qiskit/synthesis/clifford/__init__.py +19 -0
  424. qiskit/synthesis/clifford/clifford_decompose_ag.py +178 -0
  425. qiskit/synthesis/clifford/clifford_decompose_bm.py +46 -0
  426. qiskit/synthesis/clifford/clifford_decompose_full.py +64 -0
  427. qiskit/synthesis/clifford/clifford_decompose_greedy.py +58 -0
  428. qiskit/synthesis/clifford/clifford_decompose_layers.py +447 -0
  429. qiskit/synthesis/cnotdihedral/__init__.py +17 -0
  430. qiskit/synthesis/cnotdihedral/cnotdihedral_decompose_full.py +52 -0
  431. qiskit/synthesis/cnotdihedral/cnotdihedral_decompose_general.py +141 -0
  432. qiskit/synthesis/cnotdihedral/cnotdihedral_decompose_two_qubits.py +266 -0
  433. qiskit/synthesis/discrete_basis/__init__.py +16 -0
  434. qiskit/synthesis/discrete_basis/generate_basis_approximations.py +53 -0
  435. qiskit/synthesis/discrete_basis/solovay_kitaev.py +280 -0
  436. qiskit/synthesis/evolution/__init__.py +21 -0
  437. qiskit/synthesis/evolution/evolution_synthesis.py +48 -0
  438. qiskit/synthesis/evolution/lie_trotter.py +123 -0
  439. qiskit/synthesis/evolution/matrix_synthesis.py +47 -0
  440. qiskit/synthesis/evolution/pauli_network.py +80 -0
  441. qiskit/synthesis/evolution/product_formula.py +316 -0
  442. qiskit/synthesis/evolution/qdrift.py +133 -0
  443. qiskit/synthesis/evolution/suzuki_trotter.py +227 -0
  444. qiskit/synthesis/linear/__init__.py +26 -0
  445. qiskit/synthesis/linear/cnot_synth.py +69 -0
  446. qiskit/synthesis/linear/linear_circuits_utils.py +128 -0
  447. qiskit/synthesis/linear/linear_depth_lnn.py +61 -0
  448. qiskit/synthesis/linear/linear_matrix_utils.py +27 -0
  449. qiskit/synthesis/linear_phase/__init__.py +17 -0
  450. qiskit/synthesis/linear_phase/cnot_phase_synth.py +206 -0
  451. qiskit/synthesis/linear_phase/cx_cz_depth_lnn.py +61 -0
  452. qiskit/synthesis/linear_phase/cz_depth_lnn.py +58 -0
  453. qiskit/synthesis/multi_controlled/__init__.py +29 -0
  454. qiskit/synthesis/multi_controlled/mcmt_vchain.py +52 -0
  455. qiskit/synthesis/multi_controlled/mcx_synthesis.py +583 -0
  456. qiskit/synthesis/multi_controlled/multi_control_rotation_gates.py +205 -0
  457. qiskit/synthesis/one_qubit/__init__.py +15 -0
  458. qiskit/synthesis/one_qubit/one_qubit_decompose.py +288 -0
  459. qiskit/synthesis/permutation/__init__.py +18 -0
  460. qiskit/synthesis/permutation/permutation_full.py +78 -0
  461. qiskit/synthesis/permutation/permutation_lnn.py +54 -0
  462. qiskit/synthesis/permutation/permutation_reverse_lnn.py +93 -0
  463. qiskit/synthesis/permutation/permutation_utils.py +16 -0
  464. qiskit/synthesis/qft/__init__.py +16 -0
  465. qiskit/synthesis/qft/qft_decompose_full.py +97 -0
  466. qiskit/synthesis/qft/qft_decompose_lnn.py +61 -0
  467. qiskit/synthesis/stabilizer/__init__.py +16 -0
  468. qiskit/synthesis/stabilizer/stabilizer_circuit.py +149 -0
  469. qiskit/synthesis/stabilizer/stabilizer_decompose.py +194 -0
  470. qiskit/synthesis/two_qubit/__init__.py +20 -0
  471. qiskit/synthesis/two_qubit/local_invariance.py +63 -0
  472. qiskit/synthesis/two_qubit/two_qubit_decompose.py +583 -0
  473. qiskit/synthesis/two_qubit/xx_decompose/__init__.py +19 -0
  474. qiskit/synthesis/two_qubit/xx_decompose/circuits.py +300 -0
  475. qiskit/synthesis/two_qubit/xx_decompose/decomposer.py +324 -0
  476. qiskit/synthesis/two_qubit/xx_decompose/embodiments.py +163 -0
  477. qiskit/synthesis/two_qubit/xx_decompose/paths.py +412 -0
  478. qiskit/synthesis/two_qubit/xx_decompose/polytopes.py +262 -0
  479. qiskit/synthesis/two_qubit/xx_decompose/utilities.py +40 -0
  480. qiskit/synthesis/two_qubit/xx_decompose/weyl.py +133 -0
  481. qiskit/synthesis/unitary/__init__.py +13 -0
  482. qiskit/synthesis/unitary/aqc/__init__.py +177 -0
  483. qiskit/synthesis/unitary/aqc/approximate.py +116 -0
  484. qiskit/synthesis/unitary/aqc/aqc.py +175 -0
  485. qiskit/synthesis/unitary/aqc/cnot_structures.py +300 -0
  486. qiskit/synthesis/unitary/aqc/cnot_unit_circuit.py +103 -0
  487. qiskit/synthesis/unitary/aqc/cnot_unit_objective.py +299 -0
  488. qiskit/synthesis/unitary/aqc/elementary_operations.py +108 -0
  489. qiskit/synthesis/unitary/aqc/fast_gradient/__init__.py +164 -0
  490. qiskit/synthesis/unitary/aqc/fast_gradient/fast_grad_utils.py +237 -0
  491. qiskit/synthesis/unitary/aqc/fast_gradient/fast_gradient.py +226 -0
  492. qiskit/synthesis/unitary/aqc/fast_gradient/layer.py +370 -0
  493. qiskit/synthesis/unitary/aqc/fast_gradient/pmatrix.py +312 -0
  494. qiskit/synthesis/unitary/qsd.py +359 -0
  495. qiskit/transpiler/__init__.py +1352 -0
  496. qiskit/transpiler/basepasses.py +190 -0
  497. qiskit/transpiler/coupling.py +500 -0
  498. qiskit/transpiler/exceptions.py +59 -0
  499. qiskit/transpiler/instruction_durations.py +263 -0
  500. qiskit/transpiler/layout.py +740 -0
  501. qiskit/transpiler/passes/__init__.py +278 -0
  502. qiskit/transpiler/passes/analysis/__init__.py +23 -0
  503. qiskit/transpiler/passes/analysis/count_ops.py +30 -0
  504. qiskit/transpiler/passes/analysis/count_ops_longest_path.py +26 -0
  505. qiskit/transpiler/passes/analysis/dag_longest_path.py +24 -0
  506. qiskit/transpiler/passes/analysis/depth.py +33 -0
  507. qiskit/transpiler/passes/analysis/num_qubits.py +26 -0
  508. qiskit/transpiler/passes/analysis/num_tensor_factors.py +26 -0
  509. qiskit/transpiler/passes/analysis/resource_estimation.py +41 -0
  510. qiskit/transpiler/passes/analysis/size.py +36 -0
  511. qiskit/transpiler/passes/analysis/width.py +27 -0
  512. qiskit/transpiler/passes/basis/__init__.py +19 -0
  513. qiskit/transpiler/passes/basis/basis_translator.py +138 -0
  514. qiskit/transpiler/passes/basis/decompose.py +137 -0
  515. qiskit/transpiler/passes/basis/translate_parameterized.py +175 -0
  516. qiskit/transpiler/passes/basis/unroll_3q_or_more.py +84 -0
  517. qiskit/transpiler/passes/basis/unroll_custom_definitions.py +110 -0
  518. qiskit/transpiler/passes/layout/__init__.py +26 -0
  519. qiskit/transpiler/passes/layout/_csp_custom_solver.py +65 -0
  520. qiskit/transpiler/passes/layout/apply_layout.py +128 -0
  521. qiskit/transpiler/passes/layout/csp_layout.py +132 -0
  522. qiskit/transpiler/passes/layout/dense_layout.py +197 -0
  523. qiskit/transpiler/passes/layout/disjoint_utils.py +54 -0
  524. qiskit/transpiler/passes/layout/enlarge_with_ancilla.py +49 -0
  525. qiskit/transpiler/passes/layout/full_ancilla_allocation.py +116 -0
  526. qiskit/transpiler/passes/layout/layout_2q_distance.py +77 -0
  527. qiskit/transpiler/passes/layout/sabre_layout.py +525 -0
  528. qiskit/transpiler/passes/layout/sabre_pre_layout.py +225 -0
  529. qiskit/transpiler/passes/layout/set_layout.py +69 -0
  530. qiskit/transpiler/passes/layout/trivial_layout.py +66 -0
  531. qiskit/transpiler/passes/layout/vf2_layout.py +292 -0
  532. qiskit/transpiler/passes/layout/vf2_post_layout.py +376 -0
  533. qiskit/transpiler/passes/layout/vf2_utils.py +245 -0
  534. qiskit/transpiler/passes/optimization/__init__.py +42 -0
  535. qiskit/transpiler/passes/optimization/_gate_extension.py +80 -0
  536. qiskit/transpiler/passes/optimization/collect_1q_runs.py +31 -0
  537. qiskit/transpiler/passes/optimization/collect_2q_blocks.py +35 -0
  538. qiskit/transpiler/passes/optimization/collect_and_collapse.py +117 -0
  539. qiskit/transpiler/passes/optimization/collect_cliffords.py +109 -0
  540. qiskit/transpiler/passes/optimization/collect_linear_functions.py +85 -0
  541. qiskit/transpiler/passes/optimization/collect_multiqubit_blocks.py +242 -0
  542. qiskit/transpiler/passes/optimization/commutation_analysis.py +44 -0
  543. qiskit/transpiler/passes/optimization/commutative_cancellation.py +82 -0
  544. qiskit/transpiler/passes/optimization/commutative_inverse_cancellation.py +140 -0
  545. qiskit/transpiler/passes/optimization/consolidate_blocks.py +176 -0
  546. qiskit/transpiler/passes/optimization/contract_idle_wires_in_control_flow.py +104 -0
  547. qiskit/transpiler/passes/optimization/elide_permutations.py +91 -0
  548. qiskit/transpiler/passes/optimization/hoare_opt.py +420 -0
  549. qiskit/transpiler/passes/optimization/inverse_cancellation.py +95 -0
  550. qiskit/transpiler/passes/optimization/light_cone.py +135 -0
  551. qiskit/transpiler/passes/optimization/optimize_1q_commutation.py +267 -0
  552. qiskit/transpiler/passes/optimization/optimize_1q_decomposition.py +251 -0
  553. qiskit/transpiler/passes/optimization/optimize_1q_gates.py +384 -0
  554. qiskit/transpiler/passes/optimization/optimize_annotated.py +449 -0
  555. qiskit/transpiler/passes/optimization/optimize_clifford_t.py +68 -0
  556. qiskit/transpiler/passes/optimization/optimize_cliffords.py +89 -0
  557. qiskit/transpiler/passes/optimization/optimize_swap_before_measure.py +71 -0
  558. qiskit/transpiler/passes/optimization/remove_diagonal_gates_before_measure.py +41 -0
  559. qiskit/transpiler/passes/optimization/remove_final_reset.py +37 -0
  560. qiskit/transpiler/passes/optimization/remove_identity_equiv.py +70 -0
  561. qiskit/transpiler/passes/optimization/remove_reset_in_zero_state.py +37 -0
  562. qiskit/transpiler/passes/optimization/reset_after_measure_simplification.py +50 -0
  563. qiskit/transpiler/passes/optimization/split_2q_unitaries.py +63 -0
  564. qiskit/transpiler/passes/optimization/template_matching/__init__.py +19 -0
  565. qiskit/transpiler/passes/optimization/template_matching/backward_match.py +749 -0
  566. qiskit/transpiler/passes/optimization/template_matching/forward_match.py +452 -0
  567. qiskit/transpiler/passes/optimization/template_matching/maximal_matches.py +77 -0
  568. qiskit/transpiler/passes/optimization/template_matching/template_matching.py +370 -0
  569. qiskit/transpiler/passes/optimization/template_matching/template_substitution.py +633 -0
  570. qiskit/transpiler/passes/optimization/template_optimization.py +158 -0
  571. qiskit/transpiler/passes/routing/__init__.py +21 -0
  572. qiskit/transpiler/passes/routing/algorithms/__init__.py +33 -0
  573. qiskit/transpiler/passes/routing/algorithms/token_swapper.py +105 -0
  574. qiskit/transpiler/passes/routing/algorithms/types.py +46 -0
  575. qiskit/transpiler/passes/routing/algorithms/util.py +103 -0
  576. qiskit/transpiler/passes/routing/basic_swap.py +166 -0
  577. qiskit/transpiler/passes/routing/commuting_2q_gate_routing/__init__.py +25 -0
  578. qiskit/transpiler/passes/routing/commuting_2q_gate_routing/commuting_2q_block.py +60 -0
  579. qiskit/transpiler/passes/routing/commuting_2q_gate_routing/commuting_2q_gate_router.py +397 -0
  580. qiskit/transpiler/passes/routing/commuting_2q_gate_routing/pauli_2q_evolution_commutation.py +145 -0
  581. qiskit/transpiler/passes/routing/commuting_2q_gate_routing/swap_strategy.py +306 -0
  582. qiskit/transpiler/passes/routing/layout_transformation.py +119 -0
  583. qiskit/transpiler/passes/routing/lookahead_swap.py +390 -0
  584. qiskit/transpiler/passes/routing/sabre_swap.py +465 -0
  585. qiskit/transpiler/passes/routing/star_prerouting.py +433 -0
  586. qiskit/transpiler/passes/routing/utils.py +35 -0
  587. qiskit/transpiler/passes/scheduling/__init__.py +21 -0
  588. qiskit/transpiler/passes/scheduling/alignments/__init__.py +79 -0
  589. qiskit/transpiler/passes/scheduling/alignments/check_durations.py +70 -0
  590. qiskit/transpiler/passes/scheduling/alignments/reschedule.py +251 -0
  591. qiskit/transpiler/passes/scheduling/padding/__init__.py +17 -0
  592. qiskit/transpiler/passes/scheduling/padding/base_padding.py +284 -0
  593. qiskit/transpiler/passes/scheduling/padding/context_aware_dynamical_decoupling.py +876 -0
  594. qiskit/transpiler/passes/scheduling/padding/dynamical_decoupling.py +415 -0
  595. qiskit/transpiler/passes/scheduling/padding/pad_delay.py +90 -0
  596. qiskit/transpiler/passes/scheduling/scheduling/__init__.py +17 -0
  597. qiskit/transpiler/passes/scheduling/scheduling/alap.py +93 -0
  598. qiskit/transpiler/passes/scheduling/scheduling/asap.py +100 -0
  599. qiskit/transpiler/passes/scheduling/scheduling/base_scheduler.py +88 -0
  600. qiskit/transpiler/passes/scheduling/scheduling/set_io_latency.py +64 -0
  601. qiskit/transpiler/passes/scheduling/time_unit_conversion.py +237 -0
  602. qiskit/transpiler/passes/synthesis/__init__.py +21 -0
  603. qiskit/transpiler/passes/synthesis/aqc_plugin.py +153 -0
  604. qiskit/transpiler/passes/synthesis/clifford_unitary_synth_plugin.py +123 -0
  605. qiskit/transpiler/passes/synthesis/default_unitary_synth_plugin.py +653 -0
  606. qiskit/transpiler/passes/synthesis/high_level_synthesis.py +429 -0
  607. qiskit/transpiler/passes/synthesis/hls_plugins.py +2338 -0
  608. qiskit/transpiler/passes/synthesis/linear_functions_synthesis.py +41 -0
  609. qiskit/transpiler/passes/synthesis/plugin.py +738 -0
  610. qiskit/transpiler/passes/synthesis/solovay_kitaev_synthesis.py +318 -0
  611. qiskit/transpiler/passes/synthesis/unitary_synthesis.py +425 -0
  612. qiskit/transpiler/passes/utils/__init__.py +32 -0
  613. qiskit/transpiler/passes/utils/barrier_before_final_measurements.py +41 -0
  614. qiskit/transpiler/passes/utils/check_gate_direction.py +60 -0
  615. qiskit/transpiler/passes/utils/check_map.py +78 -0
  616. qiskit/transpiler/passes/utils/contains_instruction.py +45 -0
  617. qiskit/transpiler/passes/utils/control_flow.py +61 -0
  618. qiskit/transpiler/passes/utils/dag_fixed_point.py +36 -0
  619. qiskit/transpiler/passes/utils/error.py +69 -0
  620. qiskit/transpiler/passes/utils/filter_op_nodes.py +66 -0
  621. qiskit/transpiler/passes/utils/fixed_point.py +48 -0
  622. qiskit/transpiler/passes/utils/gate_direction.py +93 -0
  623. qiskit/transpiler/passes/utils/gates_basis.py +51 -0
  624. qiskit/transpiler/passes/utils/merge_adjacent_barriers.py +163 -0
  625. qiskit/transpiler/passes/utils/minimum_point.py +118 -0
  626. qiskit/transpiler/passes/utils/remove_barriers.py +50 -0
  627. qiskit/transpiler/passes/utils/remove_final_measurements.py +121 -0
  628. qiskit/transpiler/passes/utils/unroll_forloops.py +81 -0
  629. qiskit/transpiler/passmanager.py +503 -0
  630. qiskit/transpiler/passmanager_config.py +154 -0
  631. qiskit/transpiler/preset_passmanagers/__init__.py +93 -0
  632. qiskit/transpiler/preset_passmanagers/builtin_plugins.py +1114 -0
  633. qiskit/transpiler/preset_passmanagers/common.py +773 -0
  634. qiskit/transpiler/preset_passmanagers/generate_preset_pass_manager.py +443 -0
  635. qiskit/transpiler/preset_passmanagers/level0.py +104 -0
  636. qiskit/transpiler/preset_passmanagers/level1.py +108 -0
  637. qiskit/transpiler/preset_passmanagers/level2.py +109 -0
  638. qiskit/transpiler/preset_passmanagers/level3.py +110 -0
  639. qiskit/transpiler/preset_passmanagers/plugin.py +346 -0
  640. qiskit/transpiler/target.py +905 -0
  641. qiskit/transpiler/timing_constraints.py +59 -0
  642. qiskit/user_config.py +266 -0
  643. qiskit/utils/__init__.py +90 -0
  644. qiskit/utils/classtools.py +146 -0
  645. qiskit/utils/deprecation.py +382 -0
  646. qiskit/utils/lazy_tester.py +363 -0
  647. qiskit/utils/optionals.py +355 -0
  648. qiskit/utils/parallel.py +318 -0
  649. qiskit/utils/units.py +146 -0
  650. qiskit/version.py +84 -0
  651. qiskit/visualization/__init__.py +290 -0
  652. qiskit/visualization/array.py +207 -0
  653. qiskit/visualization/bloch.py +778 -0
  654. qiskit/visualization/circuit/__init__.py +15 -0
  655. qiskit/visualization/circuit/_utils.py +677 -0
  656. qiskit/visualization/circuit/circuit_visualization.py +735 -0
  657. qiskit/visualization/circuit/latex.py +668 -0
  658. qiskit/visualization/circuit/matplotlib.py +2041 -0
  659. qiskit/visualization/circuit/qcstyle.py +130 -0
  660. qiskit/visualization/circuit/styles/__init__.py +13 -0
  661. qiskit/visualization/circuit/styles/bw.json +202 -0
  662. qiskit/visualization/circuit/styles/clifford.json +202 -0
  663. qiskit/visualization/circuit/styles/iqp-dark.json +214 -0
  664. qiskit/visualization/circuit/styles/iqp.json +214 -0
  665. qiskit/visualization/circuit/styles/textbook.json +202 -0
  666. qiskit/visualization/circuit/text.py +1849 -0
  667. qiskit/visualization/circuit_visualization.py +19 -0
  668. qiskit/visualization/counts_visualization.py +487 -0
  669. qiskit/visualization/dag/__init__.py +13 -0
  670. qiskit/visualization/dag/dagstyle.py +103 -0
  671. qiskit/visualization/dag/styles/__init__.py +13 -0
  672. qiskit/visualization/dag/styles/color.json +10 -0
  673. qiskit/visualization/dag/styles/plain.json +5 -0
  674. qiskit/visualization/dag_visualization.py +389 -0
  675. qiskit/visualization/exceptions.py +21 -0
  676. qiskit/visualization/gate_map.py +1424 -0
  677. qiskit/visualization/library.py +40 -0
  678. qiskit/visualization/pass_manager_visualization.py +312 -0
  679. qiskit/visualization/state_visualization.py +1546 -0
  680. qiskit/visualization/style.py +223 -0
  681. qiskit/visualization/timeline/__init__.py +21 -0
  682. qiskit/visualization/timeline/core.py +495 -0
  683. qiskit/visualization/timeline/drawings.py +260 -0
  684. qiskit/visualization/timeline/generators.py +506 -0
  685. qiskit/visualization/timeline/interface.py +444 -0
  686. qiskit/visualization/timeline/layouts.py +115 -0
  687. qiskit/visualization/timeline/plotters/__init__.py +16 -0
  688. qiskit/visualization/timeline/plotters/base_plotter.py +58 -0
  689. qiskit/visualization/timeline/plotters/matplotlib.py +195 -0
  690. qiskit/visualization/timeline/stylesheet.py +301 -0
  691. qiskit/visualization/timeline/types.py +148 -0
  692. qiskit/visualization/transition_visualization.py +369 -0
  693. qiskit/visualization/utils.py +49 -0
  694. qiskit-2.1.0rc1.dist-info/METADATA +221 -0
  695. qiskit-2.1.0rc1.dist-info/RECORD +699 -0
  696. qiskit-2.1.0rc1.dist-info/WHEEL +6 -0
  697. qiskit-2.1.0rc1.dist-info/entry_points.txt +88 -0
  698. qiskit-2.1.0rc1.dist-info/licenses/LICENSE.txt +203 -0
  699. qiskit-2.1.0rc1.dist-info/top_level.txt +1 -0
@@ -0,0 +1,415 @@
1
+ # This code is part of Qiskit.
2
+ #
3
+ # (C) Copyright IBM 2021, 2024.
4
+ #
5
+ # This code is licensed under the Apache License, Version 2.0. You may
6
+ # obtain a copy of this license in the LICENSE.txt file in the root directory
7
+ # of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
8
+ #
9
+ # Any modifications or derivative works of this code must retain this
10
+ # copyright notice, and modified files need to carry a notice indicating
11
+ # that they have been altered from the originals.
12
+
13
+ """Dynamical Decoupling insertion pass."""
14
+ from __future__ import annotations
15
+
16
+ import logging
17
+ import numpy as np
18
+
19
+ from qiskit.circuit import Gate, ParameterExpression, Qubit
20
+ from qiskit.circuit.delay import Delay
21
+ from qiskit.circuit.library.standard_gates import IGate, UGate, U3Gate
22
+ from qiskit.circuit.reset import Reset
23
+ from qiskit.dagcircuit import DAGCircuit, DAGNode, DAGInNode, DAGOpNode, DAGOutNode
24
+ from qiskit.quantum_info.operators.predicates import matrix_equal
25
+ from qiskit.synthesis.one_qubit import OneQubitEulerDecomposer
26
+ from qiskit.transpiler.exceptions import TranspilerError
27
+ from qiskit.transpiler.instruction_durations import InstructionDurations
28
+ from qiskit.transpiler.passes.optimization import Optimize1qGates
29
+ from qiskit.transpiler.passes.scheduling.padding.base_padding import BasePadding
30
+ from qiskit.transpiler.target import Target
31
+
32
+
33
+ logger = logging.getLogger(__name__)
34
+
35
+
36
+ class PadDynamicalDecoupling(BasePadding):
37
+ """Dynamical decoupling insertion pass.
38
+
39
+ This pass works on a scheduled, physical circuit. It scans the circuit for
40
+ idle periods of time (i.e. those containing delay instructions) and inserts
41
+ a DD sequence of gates in those spots. These gates amount to the identity,
42
+ so do not alter the logical action of the circuit, but have the effect of
43
+ mitigating decoherence in those idle periods.
44
+
45
+ As a special case, the pass allows a length-1 sequence (e.g. ``[XGate()]``).
46
+ In this case the DD insertion happens only when the gate inverse can be
47
+ absorbed into a neighboring gate in the circuit (so we would still be
48
+ replacing Delay with something that is equivalent to the identity).
49
+ This can be used, for instance, as a Hahn echo.
50
+
51
+ This pass ensures that the inserted sequence preserves the circuit exactly
52
+ (including global phase).
53
+
54
+ .. plot::
55
+ :alt: Output from the previous code.
56
+ :include-source:
57
+
58
+ import numpy as np
59
+ from qiskit.circuit import QuantumCircuit
60
+ from qiskit.circuit.library import XGate
61
+ from qiskit.transpiler import PassManager, InstructionDurations, Target, CouplingMap
62
+ from qiskit.transpiler.passes import ALAPScheduleAnalysis, PadDynamicalDecoupling
63
+ from qiskit.visualization import timeline_drawer
64
+
65
+ circ = QuantumCircuit(4)
66
+ circ.h(0)
67
+ circ.cx(0, 1)
68
+ circ.cx(1, 2)
69
+ circ.cx(2, 3)
70
+ circ.measure_all()
71
+ durations = InstructionDurations(
72
+ [("h", 0, 50), ("cx", [0, 1], 700), ("reset", None, 10),
73
+ ("cx", [1, 2], 200), ("cx", [2, 3], 300),
74
+ ("x", None, 50), ("measure", None, 1000)],
75
+ dt=1e-7
76
+ )
77
+ target = Target.from_configuration(
78
+ ["h", "cx", "reset", "x", "measure"],
79
+ num_qubits=4,
80
+ coupling_map=CouplingMap.from_line(4, bidirectional=False),
81
+ instruction_durations=durations,
82
+ dt=1e-7,
83
+ )
84
+
85
+ # balanced X-X sequence on all qubits
86
+ dd_sequence = [XGate(), XGate()]
87
+ pm = PassManager([ALAPScheduleAnalysis(durations),
88
+ PadDynamicalDecoupling(durations, dd_sequence)])
89
+ circ_dd = pm.run(circ)
90
+ timeline_drawer(circ_dd, target=target)
91
+
92
+ # Uhrig sequence on qubit 0
93
+ n = 8
94
+ dd_sequence = [XGate()] * n
95
+ def uhrig_pulse_location(k):
96
+ return np.sin(np.pi * (k + 1) / (2 * n + 2)) ** 2
97
+ spacing = []
98
+ for k in range(n):
99
+ spacing.append(uhrig_pulse_location(k) - sum(spacing))
100
+ spacing.append(1 - sum(spacing))
101
+ pm = PassManager(
102
+ [
103
+ ALAPScheduleAnalysis(durations),
104
+ PadDynamicalDecoupling(durations, dd_sequence, qubits=[0], spacing=spacing),
105
+ ]
106
+ )
107
+ circ_dd = pm.run(circ)
108
+ timeline_drawer(circ_dd, target=target)
109
+
110
+ .. note::
111
+
112
+ You may need to call alignment pass before running dynamical decoupling to guarantee
113
+ your circuit satisfies acquisition alignment constraints.
114
+ """
115
+
116
+ def __init__(
117
+ self,
118
+ durations: InstructionDurations = None,
119
+ dd_sequence: list[Gate] = None,
120
+ qubits: list[int] | None = None,
121
+ spacing: list[float] | None = None,
122
+ skip_reset_qubits: bool = True,
123
+ pulse_alignment: int = 1,
124
+ extra_slack_distribution: str = "middle",
125
+ target: Target = None,
126
+ ):
127
+ """Dynamical decoupling initializer.
128
+
129
+ Args:
130
+ durations: Durations of instructions to be used in scheduling.
131
+ dd_sequence: Sequence of gates to apply in idle spots.
132
+ qubits: Physical qubits on which to apply DD.
133
+ If None, all qubits will undergo DD (when possible).
134
+ spacing: A list of spacings between the DD gates.
135
+ The available slack will be divided according to this.
136
+ The list length must be one more than the length of dd_sequence,
137
+ and the elements must sum to 1. If None, a balanced spacing
138
+ will be used [d/2, d, d, ..., d, d, d/2].
139
+ skip_reset_qubits: If True, does not insert DD on idle periods that
140
+ immediately follow initialized/reset qubits
141
+ (as qubits in the ground state are less susceptible to decoherence).
142
+ pulse_alignment: The hardware constraints for gate timing allocation.
143
+ This is usually provided from ``backend.configuration().timing_constraints``.
144
+ If provided, the delay length, i.e. ``spacing``, is implicitly adjusted to
145
+ satisfy this constraint.
146
+ extra_slack_distribution: The option to control the behavior of DD sequence generation.
147
+ The duration of the DD sequence should be identical to an idle time in the
148
+ scheduled quantum circuit, however, the delay in between gates comprising the sequence
149
+ should be integer number in units of dt, and it might be further truncated
150
+ when ``pulse_alignment`` is specified. This sometimes results in the duration of
151
+ the created sequence being shorter than the idle time
152
+ that you want to fill with the sequence, i.e. `extra slack`.
153
+ This option takes following values.
154
+
155
+ - "middle": Put the extra slack to the interval at the middle of the sequence.
156
+ - "edges": Divide the extra slack as evenly as possible into
157
+ intervals at beginning and end of the sequence.
158
+ target: The :class:`~.Target` representing the target backend.
159
+ Target takes precedence over other arguments when they can be inferred from target.
160
+ Therefore specifying target as well as other arguments like ``durations`` or
161
+ ``pulse_alignment`` will cause those other arguments to be ignored.
162
+
163
+ Raises:
164
+ TranspilerError: When invalid DD sequence is specified.
165
+ TranspilerError: When pulse gate with the duration which is
166
+ non-multiple of the alignment constraint value is found.
167
+ TypeError: If ``dd_sequence`` is not specified
168
+ """
169
+ super().__init__(target=target, durations=durations)
170
+ self._durations = durations
171
+ if dd_sequence is None:
172
+ raise TypeError("required argument 'dd_sequence' is not specified")
173
+ self._dd_sequence = dd_sequence
174
+ self._qubits = qubits
175
+ self._skip_reset_qubits = skip_reset_qubits
176
+ self._alignment = pulse_alignment
177
+ self._spacing = spacing
178
+ self._extra_slack_distribution = extra_slack_distribution
179
+
180
+ self._no_dd_qubits: set[int] = set()
181
+ self._dd_sequence_lengths: dict[Qubit, list[int]] = {}
182
+ self._sequence_phase = 0
183
+ if target is not None:
184
+ # The priority order for instruction durations is: target > standalone.
185
+ self._durations = target.durations()
186
+ self._alignment = target.pulse_alignment
187
+ for gate in dd_sequence:
188
+ if gate.name not in target.operation_names:
189
+ raise TranspilerError(
190
+ f"{gate.name} in dd_sequence is not supported in the target"
191
+ )
192
+
193
+ def _pre_runhook(self, dag: DAGCircuit):
194
+ super()._pre_runhook(dag)
195
+
196
+ durations = InstructionDurations()
197
+ if self._durations is not None:
198
+ durations.update(self._durations, getattr(self._durations, "dt", None))
199
+ num_pulses = len(self._dd_sequence)
200
+
201
+ # Check if physical circuit is given
202
+ if len(dag.qregs) != 1 or dag.qregs.get("q", None) is None:
203
+ raise TranspilerError("DD runs on physical circuits only.")
204
+
205
+ # Set default spacing otherwise validate user input
206
+ if self._spacing is None:
207
+ mid = 1 / num_pulses
208
+ end = mid / 2
209
+ self._spacing = [end] + [mid] * (num_pulses - 1) + [end]
210
+ else:
211
+ if sum(self._spacing) != 1 or any(a < 0 for a in self._spacing):
212
+ raise TranspilerError(
213
+ "The spacings must be given in terms of fractions "
214
+ "of the slack period and sum to 1."
215
+ )
216
+
217
+ # Check if DD sequence is identity
218
+ if num_pulses != 1:
219
+ if num_pulses % 2 != 0:
220
+ raise TranspilerError("DD sequence must contain an even number of gates (or 1).")
221
+ noop = np.eye(2)
222
+ for gate in self._dd_sequence:
223
+ noop = noop.dot(gate.to_matrix())
224
+ if not matrix_equal(noop, IGate().to_matrix(), ignore_phase=True):
225
+ raise TranspilerError("The DD sequence does not make an identity operation.")
226
+ self._sequence_phase = np.angle(noop[0][0])
227
+
228
+ # Compute no DD qubits on which any gate in dd_sequence is not supported in the target
229
+ for qarg, _ in enumerate(dag.qubits):
230
+ for gate in self._dd_sequence:
231
+ if not self.__gate_supported(gate, qarg):
232
+ self._no_dd_qubits.add(qarg)
233
+ logger.debug(
234
+ "No DD on qubit %d as gate %s is not supported on it", qarg, gate.name
235
+ )
236
+ break
237
+ # Precompute qubit-wise DD sequence length for performance
238
+ for physical_index, qubit in enumerate(dag.qubits):
239
+ if not self.__is_dd_qubit(physical_index):
240
+ continue
241
+
242
+ sequence_lengths = []
243
+ for index, gate in enumerate(self._dd_sequence):
244
+ gate_length = durations.get(gate, physical_index)
245
+ sequence_lengths.append(gate_length)
246
+ # Update gate duration. This is necessary for current timeline drawer, i.e. scheduled.
247
+ gate = gate.to_mutable()
248
+ self._dd_sequence[index] = gate
249
+ gate.duration = gate_length
250
+ self._dd_sequence_lengths[qubit] = sequence_lengths
251
+
252
+ def __gate_supported(self, gate: Gate, qarg: int) -> bool:
253
+ """A gate is supported on the qubit (qarg) or not."""
254
+ if self.target is None or self.target.instruction_supported(gate.name, qargs=(qarg,)):
255
+ return True
256
+ return False
257
+
258
+ def __is_dd_qubit(self, qubit_index: int) -> bool:
259
+ """DD can be inserted in the qubit or not."""
260
+ if (qubit_index in self._no_dd_qubits) or (
261
+ self._qubits and qubit_index not in self._qubits
262
+ ):
263
+ return False
264
+ return True
265
+
266
+ def _pad(
267
+ self,
268
+ dag: DAGCircuit,
269
+ qubit: Qubit,
270
+ t_start: int,
271
+ t_end: int,
272
+ next_node: DAGNode,
273
+ prev_node: DAGNode,
274
+ ):
275
+ # This routine takes care of the pulse alignment constraint for the DD sequence.
276
+ # Note that the alignment constraint acts on the t0 of the DAGOpNode.
277
+ # Now this constrained scheduling problem is simplified to the problem of
278
+ # finding a delay amount which is a multiple of the constraint value by assuming
279
+ # that the duration of every DAGOpNode is also a multiple of the constraint value.
280
+ #
281
+ # For example, given the constraint value of 16 and XY4 with 160 dt gates.
282
+ # Here we assume current interval is 992 dt.
283
+ #
284
+ # relative spacing := [0.125, 0.25, 0.25, 0.25, 0.125]
285
+ # slack = 992 dt - 4 x 160 dt = 352 dt
286
+ #
287
+ # unconstraind sequence: 44dt-X1-88dt-Y2-88dt-X3-88dt-Y4-44dt
288
+ # constrained sequence : 32dt-X1-80dt-Y2-80dt-X3-80dt-Y4-32dt + extra slack 48 dt
289
+ #
290
+ # Now we evenly split extra slack into start and end of the sequence.
291
+ # The distributed slack should be multiple of 16.
292
+ # Start = +16, End += 32
293
+ #
294
+ # final sequence : 48dt-X1-80dt-Y2-80dt-X3-80dt-Y4-64dt / in total 992 dt
295
+ #
296
+ # Now we verify t0 of every node starts from multiple of 16 dt.
297
+ #
298
+ # X1: 48 dt (3 x 16 dt)
299
+ # Y2: 48 dt + 160 dt + 80 dt = 288 dt (18 x 16 dt)
300
+ # Y3: 288 dt + 160 dt + 80 dt = 528 dt (33 x 16 dt)
301
+ # Y4: 368 dt + 160 dt + 80 dt = 768 dt (48 x 16 dt)
302
+ #
303
+ # As you can see, constraints on t0 are all satisfied without explicit scheduling.
304
+ time_interval = t_end - t_start
305
+ if time_interval % self._alignment != 0:
306
+ raise TranspilerError(
307
+ f"Time interval {time_interval} is not divisible by alignment {self._alignment} "
308
+ f"between {_format_node(prev_node)} and {_format_node(next_node)}."
309
+ )
310
+
311
+ if not self.__is_dd_qubit(dag.qubits.index(qubit)):
312
+ # Target physical qubit is not the target of this DD sequence.
313
+ self._apply_scheduled_op(dag, t_start, Delay(time_interval, dag._unit), qubit)
314
+ return
315
+
316
+ if self._skip_reset_qubits and (
317
+ isinstance(prev_node, DAGInNode) or isinstance(prev_node.op, Reset)
318
+ ):
319
+ # Previous node is the start edge or reset, i.e. qubit is ground state.
320
+ self._apply_scheduled_op(dag, t_start, Delay(time_interval, dag._unit), qubit)
321
+ return
322
+
323
+ slack = time_interval - np.sum(self._dd_sequence_lengths[qubit])
324
+ sequence_gphase = self._sequence_phase
325
+
326
+ if slack <= 0:
327
+ # Interval too short.
328
+ self._apply_scheduled_op(dag, t_start, Delay(time_interval, dag._unit), qubit)
329
+ return
330
+
331
+ if len(self._dd_sequence) == 1:
332
+ # Special case of using a single gate for DD
333
+ u_inv = self._dd_sequence[0].inverse().to_matrix()
334
+ theta, phi, lam, phase = OneQubitEulerDecomposer().angles_and_phase(u_inv)
335
+ if isinstance(next_node, DAGOpNode) and isinstance(next_node.op, (UGate, U3Gate)):
336
+ # Absorb the inverse into the successor (from left in circuit)
337
+ op = next_node.op
338
+ theta_r, phi_r, lam_r = op.params
339
+ op.params = Optimize1qGates.compose_u3(theta_r, phi_r, lam_r, theta, phi, lam)
340
+ next_node.op = op
341
+ sequence_gphase += phase
342
+ elif isinstance(prev_node, DAGOpNode) and isinstance(prev_node.op, (UGate, U3Gate)):
343
+ # Absorb the inverse into the predecessor (from right in circuit)
344
+ op = prev_node.op
345
+ theta_l, phi_l, lam_l = op.params
346
+ op.params = Optimize1qGates.compose_u3(theta, phi, lam, theta_l, phi_l, lam_l)
347
+ new_prev_node = dag.substitute_node(prev_node, op)
348
+ start_time = self.property_set["node_start_time"].pop(prev_node)
349
+ if start_time is not None:
350
+ self.property_set["node_start_time"][new_prev_node] = start_time
351
+ sequence_gphase += phase
352
+ else:
353
+ # Don't do anything if there's no single-qubit gate to absorb the inverse
354
+ self._apply_scheduled_op(dag, t_start, Delay(time_interval, dag._unit), qubit)
355
+ return
356
+
357
+ def _constrained_length(values):
358
+ return self._alignment * np.floor(values / self._alignment)
359
+
360
+ # (1) Compute DD intervals satisfying the constraint
361
+ taus = _constrained_length(slack * np.asarray(self._spacing))
362
+ extra_slack = slack - np.sum(taus)
363
+
364
+ # (2) Distribute extra slack
365
+ if self._extra_slack_distribution == "middle":
366
+ mid_ind = int((len(taus) - 1) / 2)
367
+ to_middle = _constrained_length(extra_slack)
368
+ taus[mid_ind] += to_middle
369
+ if extra_slack - to_middle:
370
+ # If to_middle is not a multiple value of the pulse alignment,
371
+ # it is truncated to the nearlest multiple value and
372
+ # the rest of slack is added to the end.
373
+ taus[-1] += extra_slack - to_middle
374
+ elif self._extra_slack_distribution == "edges":
375
+ to_begin_edge = _constrained_length(extra_slack / 2)
376
+ taus[0] += to_begin_edge
377
+ taus[-1] += extra_slack - to_begin_edge
378
+ else:
379
+ raise TranspilerError(
380
+ f"Option extra_slack_distribution = {self._extra_slack_distribution} is invalid."
381
+ )
382
+
383
+ # (3) Construct DD sequence with delays
384
+ num_elements = max(len(self._dd_sequence), len(taus))
385
+ idle_after = t_start
386
+ for dd_ind in range(num_elements):
387
+ if dd_ind < len(taus):
388
+ tau = taus[dd_ind]
389
+ if tau > 0:
390
+ self._apply_scheduled_op(dag, idle_after, Delay(tau, dag._unit), qubit)
391
+ idle_after += tau
392
+ if dd_ind < len(self._dd_sequence):
393
+ gate = self._dd_sequence[dd_ind]
394
+ gate_length = self._dd_sequence_lengths[qubit][dd_ind]
395
+ self._apply_scheduled_op(dag, idle_after, gate, qubit)
396
+ idle_after += gate_length
397
+ dag.global_phase = dag.global_phase + sequence_gphase
398
+
399
+ @staticmethod
400
+ def _resolve_params(gate: Gate) -> tuple:
401
+ """Return gate params with any bound parameters replaced with floats"""
402
+ params = []
403
+ for p in gate.params:
404
+ if isinstance(p, ParameterExpression) and not p.parameters:
405
+ params.append(float(p))
406
+ else:
407
+ params.append(p)
408
+ return tuple(params)
409
+
410
+
411
+ def _format_node(node: DAGNode) -> str:
412
+ """Util to format the DAGNode, DAGInNode, and DAGOutNode."""
413
+ if isinstance(node, (DAGInNode, DAGOutNode)):
414
+ return f"{node.__class__.__name__} on qarg {node.wire}"
415
+ return f"DAGNode {node.name} on qargs {node.qargs}"
@@ -0,0 +1,90 @@
1
+ # This code is part of Qiskit.
2
+ #
3
+ # (C) Copyright IBM 2022.
4
+ #
5
+ # This code is licensed under the Apache License, Version 2.0. You may
6
+ # obtain a copy of this license in the LICENSE.txt file in the root directory
7
+ # of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
8
+ #
9
+ # Any modifications or derivative works of this code must retain this
10
+ # copyright notice, and modified files need to carry a notice indicating
11
+ # that they have been altered from the originals.
12
+
13
+ """Padding pass to insert Delay to the empty slots."""
14
+
15
+ from qiskit.circuit import Qubit
16
+ from qiskit.circuit.delay import Delay
17
+ from qiskit.dagcircuit import DAGCircuit, DAGNode, DAGOutNode
18
+ from qiskit.transpiler.target import Target
19
+ from qiskit.transpiler.instruction_durations import InstructionDurations
20
+
21
+ from .base_padding import BasePadding
22
+
23
+
24
+ class PadDelay(BasePadding):
25
+ """Padding idle time with Delay instructions.
26
+
27
+ Consecutive delays will be merged in the output of this pass.
28
+
29
+ .. plot::
30
+ :include-source:
31
+ :nofigs:
32
+
33
+ from qiskit import QuantumCircuit
34
+ from qiskit.transpiler import InstructionDurations
35
+
36
+ durations = InstructionDurations([("x", None, 160), ("cx", None, 800)])
37
+
38
+ qc = QuantumCircuit(2)
39
+ qc.delay(100, 0)
40
+ qc.x(1)
41
+ qc.cx(0, 1)
42
+
43
+ The ASAP-scheduled circuit output may become
44
+
45
+ .. code-block:: text
46
+
47
+ ┌────────────────┐
48
+ q_0: ┤ Delay(160[dt]) ├──■──
49
+ └─────┬───┬──────┘┌─┴─┐
50
+ q_1: ──────┤ X ├───────┤ X ├
51
+ └───┘ └───┘
52
+
53
+ Note that the additional idle time of 60dt on the ``q_0`` wire coming from the duration difference
54
+ between ``Delay`` of 100dt (``q_0``) and ``XGate`` of 160 dt (``q_1``) is absorbed in
55
+ the delay instruction on the ``q_0`` wire, i.e. in total 160 dt.
56
+
57
+ See :class:`BasePadding` pass for details.
58
+ """
59
+
60
+ def __init__(
61
+ self,
62
+ fill_very_end: bool = True,
63
+ target: Target = None,
64
+ durations: InstructionDurations = None,
65
+ ):
66
+ """Create new padding delay pass.
67
+
68
+ Args:
69
+ fill_very_end: Set ``True`` to fill the end of circuit with delay.
70
+ target: The :class:`~.Target` representing the target backend.
71
+ If it is supplied and does not support delay instruction on a qubit,
72
+ padding passes do not pad any idle time of the qubit.
73
+ """
74
+ super().__init__(target=target, durations=durations)
75
+ self.fill_very_end = fill_very_end
76
+
77
+ def _pad(
78
+ self,
79
+ dag: DAGCircuit,
80
+ qubit: Qubit,
81
+ t_start: int,
82
+ t_end: int,
83
+ next_node: DAGNode,
84
+ prev_node: DAGNode,
85
+ ):
86
+ if not self.fill_very_end and isinstance(next_node, DAGOutNode):
87
+ return
88
+
89
+ time_interval = t_end - t_start
90
+ self._apply_scheduled_op(dag, t_start, Delay(time_interval, dag._unit), qubit)
@@ -0,0 +1,17 @@
1
+ # This code is part of Qiskit.
2
+ #
3
+ # (C) Copyright IBM 2022.
4
+ #
5
+ # This code is licensed under the Apache License, Version 2.0. You may
6
+ # obtain a copy of this license in the LICENSE.txt file in the root directory
7
+ # of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
8
+ #
9
+ # Any modifications or derivative works of this code must retain this
10
+ # copyright notice, and modified files need to carry a notice indicating
11
+ # that they have been altered from the originals.
12
+
13
+ """Scheduling pass to assign instruction start time."""
14
+
15
+ from .asap import ASAPScheduleAnalysis
16
+ from .alap import ALAPScheduleAnalysis
17
+ from .set_io_latency import SetIOLatency
@@ -0,0 +1,93 @@
1
+ # This code is part of Qiskit.
2
+ #
3
+ # (C) Copyright IBM 2020.
4
+ #
5
+ # This code is licensed under the Apache License, Version 2.0. You may
6
+ # obtain a copy of this license in the LICENSE.txt file in the root directory
7
+ # of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
8
+ #
9
+ # Any modifications or derivative works of this code must retain this
10
+ # copyright notice, and modified files need to carry a notice indicating
11
+ # that they have been altered from the originals.
12
+
13
+ """ALAP Scheduling."""
14
+ from qiskit.circuit import Measure
15
+ from qiskit.transpiler.exceptions import TranspilerError
16
+
17
+ from qiskit.transpiler.passes.scheduling.scheduling.base_scheduler import BaseScheduler
18
+
19
+
20
+ class ALAPScheduleAnalysis(BaseScheduler):
21
+ """ALAP Scheduling pass, which schedules the **stop** time of instructions as late as possible.
22
+
23
+ See the :ref:`transpiler-scheduling-description` section in the :mod:`qiskit.transpiler`
24
+ module documentation for a more detailed explanation.
25
+ """
26
+
27
+ def run(self, dag):
28
+ """Run the ALAPSchedule pass on `dag`.
29
+
30
+ Args:
31
+ dag (DAGCircuit): DAG to schedule.
32
+
33
+ Returns:
34
+ DAGCircuit: A scheduled DAG.
35
+
36
+ Raises:
37
+ TranspilerError: if the circuit is not mapped on physical qubits.
38
+ TranspilerError: if conditional bit is added to non-supported instruction.
39
+ """
40
+ if len(dag.qregs) != 1 or dag.qregs.get("q", None) is None:
41
+ raise TranspilerError("ALAP schedule runs on physical circuits only")
42
+ if self.property_set["time_unit"] == "stretch":
43
+ raise TranspilerError("Scheduling cannot run on circuits with stretch durations.")
44
+
45
+ clbit_write_latency = self.property_set.get("clbit_write_latency", 0)
46
+
47
+ node_start_time = {}
48
+ idle_before = {q: 0 for q in dag.qubits + dag.clbits}
49
+ for node in reversed(list(dag.topological_op_nodes())):
50
+ op_duration = self._get_node_duration(node, dag)
51
+
52
+ # compute t0, t1: instruction interval, note that
53
+ # t0: start time of instruction
54
+ # t1: end time of instruction
55
+
56
+ # since this is alap scheduling, node is scheduled in reversed topological ordering
57
+ # and nodes are packed from the very end of the circuit.
58
+ # the physical meaning of t0 and t1 is flipped here.
59
+ if isinstance(node.op, self.CONDITIONAL_SUPPORTED):
60
+ t0q = max(idle_before[q] for q in node.qargs)
61
+ t0 = t0q
62
+ t1 = t0 + op_duration
63
+ else:
64
+ if isinstance(node.op, Measure):
65
+ # clbit time is always right (alap) justified
66
+ t0 = max(idle_before[bit] for bit in node.qargs + node.cargs)
67
+ t1 = t0 + op_duration
68
+ #
69
+ # |t1 = t0 + duration
70
+ # Q ░░░░░▒▒▒▒▒▒▒▒▒▒▒
71
+ # C ░░░░░░░░░▒▒▒▒▒▒▒
72
+ # |t0 + (duration - clbit_write_latency)
73
+ #
74
+ for clbit in node.cargs:
75
+ idle_before[clbit] = t0 + (op_duration - clbit_write_latency)
76
+ else:
77
+ # It happens to be directives such as barrier
78
+ t0 = max(idle_before[bit] for bit in node.qargs + node.cargs)
79
+ t1 = t0 + op_duration
80
+
81
+ for bit in node.qargs:
82
+ idle_before[bit] = t1
83
+
84
+ node_start_time[node] = t1
85
+
86
+ # Compute maximum instruction available time, i.e. very end of t1
87
+ circuit_duration = max(idle_before.values())
88
+
89
+ # Note that ALAP pass is inversely schedule, thus
90
+ # t0 is computed by subtracting entire circuit duration from t1.
91
+ self.property_set["node_start_time"] = {
92
+ n: circuit_duration - t1 for n, t1 in node_start_time.items()
93
+ }