Saving and loading calibrations data #1120

nkanazawa1989 · 2023-03-31T19:31:16Z

Summary

This PR adds support for full roundtrip of Calibrations instance through JSON file format. Even though this PR is blocked by the following PR, this branch is ready to streamline calibration tasks.

This is blocked by Qiskit/qiskit#9890

Details and comments

Update JSON Encoder and Decoder to support ScheduleBlock and datetime object
Add save utils that provides a standard data model for calibration. Note that this offers portability of calibration data across different versions, platforms, etc..
Deprecate conventional csv format that only supports calibration table and bit complicated.

Sample code for testing

Checkout my Terra folk https://github.com/nkanazawa1989/qiskit-terra/tree/feature/qpy-schedule-reference

from qiskit_experiments.calibration_management import Calibrations
from qiskit import pulse
from qiskit.circuit import Parameter

cals = Calibrations(
    coupling_map=[[0, 1]],
    control_channel_map={(0, 1): [pulse.ControlChannel(0)], (1, 0): [pulse.ControlChannel(1)]},
)

with pulse.build(name="my_gate") as sched:
    pulse.play(
        pulse.Constant(Parameter("duration"), Parameter("amp")),
        pulse.ControlChannel(Parameter("ch0.1")),
    )

cals.add_schedule(sched, qubits=(0, 1))
cals.add_parameter_value(100, "duration", qubits=(0, 1), schedule="my_gate")
cals.add_parameter_value(0.123, "amp", qubits=(0, 1), schedule="my_gate")

cals.save(file_prefix="data", overwrite=True)
roundtrip = Calibrations.load("./data.json")

sched = cals.get_schedule("my_gate", (0, 1))
roundtrip_sched = roundtrip.get_schedule("my_gate", (0, 1))

assert sched == roundtrip_sched

…decoder to handle Qiskit data types.

…o longer useful.

eggerdj

Thanks for doing this! Have you tried checking if the links between parameters are preserved after a round trip serialize/deserialize? Can you add a few tests for that?

qiskit_experiments/calibration_management/calibrations.py

eggerdj · 2023-04-06T12:26:49Z

qiskit_experiments/calibration_management/calibrations.py

+            file_path = file_prefix + ".json"
+            if os.path.isfile(file_path) and not overwrite:
+                raise CalibrationError(f"{file_path} already exists. Set overwrite to True.")


Is there a test to check that we raise if overwrite is False and there already exists a file with this name?

qiskit_experiments/calibration_management/save_utils.py

eggerdj · 2023-04-06T14:08:48Z

qiskit_experiments/calibration_management/save_utils.py

+    for sched in model.schedules:
+        cals.add_schedule(
+            schedule=sched.data,
+            qubits=sched.qubits if len(sched.qubits) != 0 else None,
+            num_qubits=sched.num_qubits,
+        )


Does this keep any parameter links that we initially had?

Yes. QPY preserves parameter UUID and it serializes the schedule through QPY format.

Ok good. Thanks, do we have a test on this?

qiskit_experiments/calibration_management/save_utils.py

releasenotes/notes/feature-support-calibrations-roundtrip-47f09bd9ff803479.yaml

- Docs update - Remove schema for schedule and move qubit info to metadata - Change function names Co-authored-by: Daniel Egger <[email protected]>

- Fix Calibrations eq logic. This logic uses json dump for dict serialization which doesn't work for complex parameter value. - Fix test without deprecation. Revert logic change to Calibrations.config method which is no longer used anyways. - Fix wrong import

### Summary This PR aims to remove the use of complex amplitude for `SymbolicPulse` in calibration experiments. Most notable changes are to the `HalfAngleCal` experiment and the `FixedFrquencyTransmon` library. With these changes, support of complex values in general raises a `PendingDeprecationWarning`. ### Details and comments Qiskit Terra recently changed the representation of `SymbolicPulse` from complex amplitude to (`amp`,`angle`). Once the deprecation is completed, some calibration experiments will fail. Additionally, assignment of complex parameters in general has caused problems recently (See Qiskit-Terra issue [9187](Qiskit/qiskit#9187)), and is also being phased out (See Qiskit-Terra PR [9735](Qiskit/qiskit#9735)). Most calibration experiments are oblivious to these changes, with the exception of `HalfAngleCal` and `RoughAmplitudeCal`. The library `FixedFrequencyTransmon` also has to conform with the new representation. To create as little breaking changes as possible, the following were changed: - `FixedFrequencyTransmon` library was converted to the new representation. All experiments will work as they have been with it. - `RoughAmplitudeCal` was changed such that it will work for both real or complex `amp`, without changing the type of the value. - `HalfAngleCal` was changed to calibrate 'angle' instead of the complex amplitude. A user which uses the `FixedFrequencyTransmon` library will experience no change (except for the added parameters). A user which uses custom built schedules will experience an error. To simplify the transition, most likely scenarios (schedule with no `angle` parameter, `cal_parameter_name="amp"`) will raise an informative error with explanation about the needed changes. A `PendingDeprecationWarning` is raised with every initialization of `ParameterValue` with complex type value (which also covers addition of parameter value to a calibration). Note that Qiskit-Terra PR [9897](Qiskit/qiskit#9897) will also raise a warning from the Terra side, for all assignment of complex parameters. Handling of loaded calibrations which do not conform to the new representation will be sorted out once PR #1120 is merged, as it introduces a major change in calibration loading. --------- Co-authored-by: Naoki Kanazawa <[email protected]> Co-authored-by: Will Shanks <[email protected]> Co-authored-by: Daniel J. Egger <[email protected]>

…ure/calibration-save

eggerdj

Overall this is good. I have a few comments mainly related to the messaging.

qiskit_experiments/calibration_management/calibrations.py

qiskit_experiments/calibration_management/save_utils.py

test/calibration/test_calibrations.py

Co-authored-by: Daniel J. Egger <[email protected]>

eggerdj

LGTM. Thanks!

nkanazawa1989 added 5 commits April 1, 2023 03:38

Add save util to calibrations and update experiment json encoder and …

6ae6a03

…decoder to handle Qiskit data types.

Update Calibrations instance and deprecate several methods that are n…

3267b01

…o longer useful.

Fix cyclic import and a bug when most_recent_only=False

41f764a

Release note

05e8a26

Update module docstring

2dfb2e4

TsafrirA mentioned this pull request Apr 3, 2023

Removing complex values support from Calibrations #1067

Merged

eggerdj suggested changes Apr 6, 2023

View reviewed changes

nkanazawa1989 and others added 4 commits April 17, 2023 13:20

Review comments

993fcb8

- Docs update - Remove schema for schedule and move qubit info to metadata - Change function names Co-authored-by: Daniel Egger <[email protected]>

Merge branch 'main' into feature/calibration-save

60fef70

Misc, prep for 0.6

283bc9a

- Fix Calibrations eq logic. This logic uses json dump for dict serialization which doesn't work for complex parameter value. - Fix test without deprecation. Revert logic change to Calibrations.config method which is no longer used anyways. - Fix wrong import

temp fix dependency

6d480d1

Merge branch 'main' of github.com:Qiskit/qiskit-experiments into feat…

15ba782

…ure/calibration-save

nkanazawa1989 added this to the Release 0.6 milestone May 12, 2023

eggerdj suggested changes May 12, 2023

View reviewed changes

nkanazawa1989 and others added 3 commits May 15, 2023 13:21

Documentation update

5ac4519

Co-authored-by: Daniel J. Egger <[email protected]>

Update tests

895017a

Merge branch 'main' into feature/calibration-save

bed5b49

eggerdj approved these changes Jun 1, 2023

View reviewed changes

nkanazawa1989 added this pull request to the merge queue Jun 2, 2023

Merged via the queue into qiskit-community:main with commit 5b6fa06 Jun 2, 2023

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Saving and loading calibrations data #1120

Saving and loading calibrations data #1120

nkanazawa1989 commented Mar 31, 2023

eggerdj left a comment

eggerdj Apr 6, 2023

eggerdj Apr 6, 2023

nkanazawa1989 Apr 17, 2023

eggerdj May 12, 2023

eggerdj left a comment

eggerdj left a comment

Saving and loading calibrations data #1120

Saving and loading calibrations data #1120

Conversation

nkanazawa1989 commented Mar 31, 2023

Summary

Details and comments

Sample code for testing

eggerdj left a comment

Choose a reason for hiding this comment

eggerdj Apr 6, 2023

Choose a reason for hiding this comment

eggerdj Apr 6, 2023

Choose a reason for hiding this comment

nkanazawa1989 Apr 17, 2023

Choose a reason for hiding this comment

eggerdj May 12, 2023

Choose a reason for hiding this comment

eggerdj left a comment

Choose a reason for hiding this comment

eggerdj left a comment

Choose a reason for hiding this comment