Update Parameters through Gate in Qiskit interface

[lazyoracle]

What

Allow updating parameters of the underlying experiment object through custom qiskit gates, as below:

amp = Qty(value=0.8, min_val=0.2, max_val=1, unit="V")
opt_map = [[["rx90p[0]", "d1", "gaussian", "amp"]]]
param_gate = SetParamsGate(params=[[amp.asdict()], opt_map])
qc.append(param_gate, [0])

Why

Closes #200

How

• Added a new SetParamsGate class in the c3.qiskit.c3_gates module
• Update run_experiment to process this gate

Remarks

• SetParamsGate should be the last gate in the circuit, otherwise it raises a KeyError
• The params argument should be supplied as a list with the first item a list of Quantity objects converted to a Dict of Python primitives and the second item an opt_map with the proper list nesting
• The qubit target for the gate can be any valid qubit in the circuit, this argument is currently ignored and not processed by the backend
• runtime options for parameter update override gate-based updates

Checklist

Please include and complete the following checklist. Your Pull Request is (in most cases) not ready for review until the following have been completed. You can create a draft PR while you are still completing the checklist. Check the Contribution Guidelines for more details. You can mark an item as complete with the - [x] prefix

• [x] Tests - Added unit tests for new code, regression tests for bugs and updated the integration tests if required
• [x] Formatting & Linting - black and flake8 have been used to ensure styling guidelines are met
• [x] Type Annotations - All new code has been type annotated in the function signatures using type hints
• [x] Docstrings - Docstrings have been provided for functions in the numpydoc style
• [ ] Documentation - The tutorial style documentation has been updated to explain changes & new features
• [ ] Notebooks - Example notebooks have been updated to incorporate changes and new features
• [ ] Changelog - A short note on this PR has been added to the Upcoming Release section

[codecov[bot]]

Codecov Report

Merging #208 (9f705ec) into dev (24211ba) will increase coverage by 0.10%. The diff coverage is 100.00%.

@@            Coverage Diff             @@
##              dev     #208      +/-   ##
==========================================
+ Coverage   74.68%   74.78%   +0.10%     
==========================================
  Files          38       38              
  Lines        5534     5552      +18     
==========================================
+ Hits         4133     4152      +19     
+ Misses       1401     1400       -1     

Impacted Files	Coverage Δ
c3/qiskit/c3_backend.py	93.75% <100.00%> (+0.72%)	:arrow_up:
c3/qiskit/c3_gates.py	98.43% <100.00%> (+0.25%)	:arrow_up:

---

Continue to review full report at Codecov.

Legend - Click here to learn more Δ = absolute <relative> (impact), ø = not affected, ? = missing data Powered by Codecov. Last update 24211ba...9f705ec. Read the comment docs.