Skip to content

Commit

Permalink
feat: Add standardized device calibration data for OQC and Rigetti
Browse files Browse the repository at this point in the history 
* feat: Add standardized device calibration data for OQC and Rigetti

* feat: Add standardized device calibration data for OQC and Rigetti

Co-authored-by: Matt Cordoba <matcor@amazon.com>
  • Loading branch information
@MattCordoba
MattCordoba and Matt Cordoba committed Apr 5, 2022
1 parent abd3880 commit db91c60
Show file tree
Hide file tree
Showing 7 changed files with 397 additions and 0 deletions.
3 changes: 3 additions & 0 deletions src/braket/device_schema/__init__.py
View file
Original file line number Diff line number Diff line change
Expand Up @@ -32,3 +32,6 @@
from braket.device_schema.openqasm_device_action_properties import ( # noqa: F401
OpenQASMDeviceActionProperties,
)
from braket.device_schema.standardized_gate_model_qpu_device_properties_v1 import ( # noqa: F401
StandardizedGateModelQpuDeviceProperties,
)
9 changes: 9 additions & 0 deletions src/braket/device_schema/oqc/oqc_device_capabilities_v1.py
View file
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,9 @@
from braket.device_schema.jaqcd_device_action_properties import JaqcdDeviceActionProperties
from braket.device_schema.openqasm_device_action_properties import OpenQASMDeviceActionProperties
from braket.device_schema.oqc.oqc_provider_properties_v1 import OqcProviderProperties
from braket.device_schema.standardized_gate_model_qpu_device_properties_v1 import (
StandardizedGateModelQpuDeviceProperties,
)
from braket.schema_common import BraketSchemaBase, BraketSchemaHeader

# TODO: Update the device and topology details when we have information from the provider
Expand All @@ -38,6 +41,9 @@ class OqcDeviceCapabilities(BraketSchemaBase, DeviceCapabilities):
OQC device can support
paradigm(GateModelQpuParadigmProperties): Paradigm properties
provider(Optional[OqcProviderProperties]): OQC provider specific properties
standardized
(StandardizedGateModelQpuDeviceProperties): Braket standarized device
properties for OQC
Examples:
>>> import json
Expand Down Expand Up @@ -97,6 +103,8 @@ class OqcDeviceCapabilities(BraketSchemaBase, DeviceCapabilities):
... },
... },
... "deviceParameters": {OqcDeviceParameters.schema_json()},
... "standardized": \
... {StandardizedGateModelQpuDeviceProperties.schema_json()},,
... }
>>> OqcDeviceCapabilities.parse_raw_schema(json.dumps(input_json))
"""
Expand All @@ -111,3 +119,4 @@ class OqcDeviceCapabilities(BraketSchemaBase, DeviceCapabilities):
]
paradigm: GateModelQpuParadigmProperties
provider: Optional[OqcProviderProperties]
standardized: Optional[StandardizedGateModelQpuDeviceProperties]
9 changes: 9 additions & 0 deletions src/braket/device_schema/rigetti/rigetti_device_capabilities_v1.py
View file
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,9 @@
from braket.device_schema.jaqcd_device_action_properties import JaqcdDeviceActionProperties
from braket.device_schema.openqasm_device_action_properties import OpenQASMDeviceActionProperties
from braket.device_schema.rigetti.rigetti_provider_properties_v1 import RigettiProviderProperties
from braket.device_schema.standardized_gate_model_qpu_device_properties_v1 import (
StandardizedGateModelQpuDeviceProperties,
)
from braket.schema_common import BraketSchemaBase, BraketSchemaHeader


Expand All @@ -36,6 +39,9 @@ class RigettiDeviceCapabilities(BraketSchemaBase, DeviceCapabilities):
Rigetti device can support
paradigm(GateModelQpuParadigmProperties): Paradigm properties of a Rigetti
provider(Optional[RigettiProviderProperties]): Rigetti provider specific properties
standardized
(StandardizedGateModelQpuDeviceProperties): Braket standarized device
properties for Rigetti
Examples:
>>> import json
Expand Down Expand Up @@ -95,6 +101,8 @@ class RigettiDeviceCapabilities(BraketSchemaBase, DeviceCapabilities):
... },
... },
... "deviceParameters": {RigettiDeviceParameters.schema_json()},
... "standardized": \
... {StandardizedGateModelQpuDeviceProperties.schema_json()},
... }
>>> RigettiDeviceCapabilities.parse_raw_schema(json.dumps(input_json))
Expand All @@ -110,3 +118,4 @@ class RigettiDeviceCapabilities(BraketSchemaBase, DeviceCapabilities):
]
paradigm: GateModelQpuParadigmProperties
provider: Optional[RigettiProviderProperties]
standardized: Optional[StandardizedGateModelQpuDeviceProperties]
205 changes: 205 additions & 0 deletions src/braket/device_schema/standardized_gate_model_qpu_device_properties_v1.py
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,205 @@
# Copyright Amazon.com Inc. or its affiliates. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License"). You
# may not use this file except in compliance with the License. A copy of
# the License is located at
#
# http://aws.amazon.com/apache2.0/
#
# or in the "license" file accompanying this file. This file is
# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
# ANY KIND, either express or implied. See the License for the specific
# language governing permissions and limitations under the License.

from enum import Enum
from typing import Dict, List, Optional

from pydantic import BaseModel, Field, confloat

from braket.schema_common import BraketSchemaBase, BraketSchemaHeader


class QubitDirection(str, Enum):
"""
Enum for qubit direction labels for two-qubit fidelity details
"""

CONTROL = "control"
TARGET = "target"


class FidelityType(BaseModel):
"""
Fidelity measurement types
Attributes:
name (str): description of the fidelity measurement
description (Optional[str]): Optional description for how the fidelity
measurement was performed
"""

name: str
description: Optional[str]


class GateFidelity2Q(BaseModel):
"""
Describes the fidelity of two-qubit pairing
Attributes:
direction (Optional[Dict[QubitDirection, int]]): Describes which qubit is
control/target for the pair. If direction is None the pair is considered
bi-directional.
gateName (str): the 2-qubit gate that the fidelity measurement was performed on
fidelity (float): the fidelity value
standardError (Optional[float]): Describes the error value on the fidelity measurement
fidelityType (FidelityType): The fidelity measurement technique used
for the presented value
"""

direction: Optional[Dict[QubitDirection, int]] = None
gateName: str
fidelity: confloat(ge=0, le=1)
standardError: Optional[confloat(ge=0, le=1)] = None
fidelityType: FidelityType


class TwoQubitProperties(BaseModel):
"""
The standard two-qubit calibration details for a quantum hardware provider
Attributes:
twoQubitGateFidelity: two qubit fidelity properties
"""

twoQubitGateFidelity: List[GateFidelity2Q]


class Fidelity1Q(BaseModel):
"""
Describes one qubit fidelity measured on a qubit
Attributes:
fidelityType (FidelityType): The fidelity measurement technique used
for the presented value
fidelity (float): The measured fidelity value
standardError (Optional[float]) The expected error value reported
on the measurement
"""

fidelityType: FidelityType
fidelity: confloat(ge=0, le=1)
standardError: Optional[confloat(ge=0, le=1)] = None


class CoherenceTime(BaseModel):
"""
The coherence time values provided for the device
Attributes:
value (str): The coherence time value
standardError (str): The error/confidence in coherence measurement provided
unit (str): The unit for the described value
"""

value: float
standardError: Optional[float]
unit: str


class OneQubitProperties(BaseModel):
"""
The standard one-qubit calibration details for a quantum hardware provider
Attributes:
T1: The T1 decoherence/relaxation time data structure
T2: The T2 coherence/dephasing time
oneQubitFidelity: one qubit fidelity properties
"""

T1: CoherenceTime
T2: CoherenceTime
oneQubitFidelity: List[Fidelity1Q]


class StandardizedGateModelQpuDeviceProperties(BraketSchemaBase):
"""
Braket standarized gate model device qpu properties for the given quantum hardware
Attributes:
oneQubitProperties (Dict[str, OneQubitProperties]): Dictionary describing a qubit
identifier (ex: '1'), to the calibration property set
twoQubitProperties (Dict[str, TwoQubitProperties]): Dictionary describing the
two-qubit identifier (ex: '0-1'), to the calibration property set
Examples:
>>> import json
>>> valid_input = {
... "braketSchemaHeader": {
... "name": \
... "braket.device_schema.standardized_gate_model_qpu_device_properties",
... "version": "1",
... },
... "oneQubitProperties": {
... "0": {
... "T1": {"value": 28.9, "standardError": 0.01, "unit": "us"},
... "T2": {"value": 44.5, "standardError": 0.02, "unit": "us"},
... "oneQubitFidelity": [
... {
... "fidelityType": {
... "name": "RANDOMIZED_BENCHMARKING",
... "description": "uses a standard RB technique",
... },
... "fidelity": 0.9993,
... },
... {
... "fidelityType": {"name": "READOUT"},
... "fidelity": 0.903,
... "standardError": None,
... },
... ],
... },
... "1": {
... "T1": {"value": 28.9, "unit": "us"},
... "T2": {"value": 44.5, "standardError": 0.02, "unit": "us"},
... "oneQubitFidelity": [
... {
... "fidelityType": {"name": "RANDOMIZED_BENCHMARKING"},
... "fidelity": 0.9986,
... "standardError": None,
... },
... {
... "fidelityType": {"name": "READOUT"},
... "fidelity": 0.867,
... "standardError": None,
... },
... ],
... },
... },
... "twoQubitProperties": {
... "0-1": {
... "twoQubitGateFidelity": [
... {
... "direction": {"control": 0, "target": 1},
... "gateName": "CNOT",
... "fidelity": 0.877,
... "fidelityType": {"name": "INTERLEAVED_RANDOMIZED_BENCHMARKING"},
... }
... ]
... },
... "0-7": {
... "twoQubitGateFidelity": [
... {
... "direction": {"control": 0, "target": 7},
... "gateName": "CNOT",
... "fidelity": 0.877,
... "standardError": 0.001,
... "fidelityType": {"name": "INTERLEAVED_RANDOMIZED_BENCHMARKING"},
... }
... ]
... },
... },
... }
>>> StandardizedGateModelQpuDeviceProperties.parse_raw_schema(json.dumps(valid_input))
"""

_PROGRAM_HEADER = BraketSchemaHeader(
name="braket.device_schema.standardized_gate_model_qpu_device_properties", version="1"
)
braketSchemaHeader: BraketSchemaHeader = Field(default=_PROGRAM_HEADER, const=_PROGRAM_HEADER)
oneQubitProperties: Dict[str, OneQubitProperties]
twoQubitProperties: Dict[str, TwoQubitProperties]
38 changes: 38 additions & 0 deletions test/unit_tests/braket/device_schema/oqc/test_oqc_device_capabilities_v1.py
View file
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,43 @@

from braket.device_schema.oqc.oqc_device_capabilities_v1 import OqcDeviceCapabilities

device_properties_data = {
"braketSchemaHeader": {
"name": "braket.device_schema.standardized_gate_model_qpu_device_properties",
"version": "1",
},
"oneQubitProperties": {
"0": {
"T1": {"value": 28.9, "standardError": 0.01, "unit": "us"},
"T2": {"value": 44.5, "standardError": 0.02, "unit": "us"},
"oneQubitFidelity": [
{
"fidelityType": {"name": "READOUT"},
"fidelity": 0.9993,
"standardError": None,
},
{
"fidelityType": {"name": "RANDOMIZED_BENCHMARKING"},
"fidelity": 0.903,
"standardError": None,
},
],
}
},
"twoQubitProperties": {
"0-1": {
"twoQubitGateFidelity": [
{
"direction": {"control": 0, "target": 1},
"gateName": "CNOT",
"fidelity": 0.877,
"fidelityType": {"name": "INTERLEAVED_RANDOMIZED_BENCHMARKING"},
}
]
}
},
}

jaqcd_valid_input = {
"braketSchemaHeader": {
"name": "braket.device_schema.oqc.oqc_device_capabilities",
Expand Down Expand Up @@ -124,6 +161,7 @@
"connectivity": {"fullyConnected": False, "connectivityGraph": {"1": ["2", "3"]}},
},
"deviceParameters": {},
"standardized": device_properties_data,
}


Expand Down
38 changes: 38 additions & 0 deletions test/unit_tests/braket/device_schema/rigetti/test_rigetti_device_capabilities_v1.py
View file
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,43 @@

from braket.device_schema.rigetti.rigetti_device_capabilities_v1 import RigettiDeviceCapabilities

device_properties_data = {
"braketSchemaHeader": {
"name": "braket.device_schema.standardized_gate_model_qpu_device_properties",
"version": "1",
},
"oneQubitProperties": {
"0": {
"T1": {"value": 28.9, "standardError": 0.01, "unit": "us"},
"T2": {"value": 44.5, "standardError": 0.02, "unit": "us"},
"oneQubitFidelity": [
{
"fidelityType": {"name": "READOUT"},
"fidelity": 0.9993,
"standardError": None,
},
{
"fidelityType": {"name": "RANDOMIZED_BENCHMARKING"},
"fidelity": 0.903,
"standardError": None,
},
],
}
},
"twoQubitProperties": {
"0-1": {
"twoQubitGateFidelity": [
{
"direction": {"control": 0, "target": 1},
"gateName": "CNOT",
"fidelity": 0.877,
"fidelityType": {"name": "INTERLEAVED_RANDOMIZED_BENCHMARKING"},
}
]
}
},
}

jaqcd_valid_input = {
"braketSchemaHeader": {
"name": "braket.device_schema.rigetti.rigetti_device_capabilities",
Expand Down Expand Up @@ -66,6 +103,7 @@
"connectivity": {"fullyConnected": False, "connectivityGraph": {"1": ["2", "3"]}},
},
"deviceParameters": {},
"standardized": device_properties_data,
}


Expand Down

0 comments on commit db91c60

Please sign in to comment.