braket.device_schema.standardized_gate_model_qpu_device_properties_v3 module

class braket.device_schema.standardized_gate_model_qpu_device_properties_v3.TimeUnit(*values)[source]

Bases: str, Enum

Enum for time unit.

SECOND = 's'

MILLISECOND = 'ms'

MICROSECOND = 'us'

NANOSECOND = 'ns'

class braket.device_schema.standardized_gate_model_qpu_device_properties_v3.FidelityUnit(*values)[source]

Bases: str, Enum

Enum for fidelity value unit.

FRACTION = 'fraction'

class braket.device_schema.standardized_gate_model_qpu_device_properties_v3.FidelityTypeName(*values)[source]

Bases: str, Enum

Enum for fidelity type.

RANDOMIZED_BENCHMARKING = 'RANDOMIZED_BENCHMARKING'

class braket.device_schema.standardized_gate_model_qpu_device_properties_v3.FidelityType(*, name: FidelityTypeName, description: str | None = None)[source]

Bases: BaseModel

Fidelity measurement types .. attribute:: name

name of the fidelity type

type:

str

description

description for how the fidelity measurement was performed

Type:: Optional[str]

Create a new model by parsing and validating input data from keyword arguments.

Raises ValidationError if the input data cannot be parsed to form a valid model.

name: FidelityTypeName

description: str | None

class braket.device_schema.standardized_gate_model_qpu_device_properties_v3.Fidelity(*, fidelityType: FidelityType | None = None, fidelity: ConstrainedFloatValue, standardError: ConstrainedFloatValue | None = None, median: ConstrainedFloatValue | None = None, unit: FidelityUnit)[source]

Bases: BaseModel

Describes fidelity of a component or a system .. attribute:: fidelityType

The fidelity measurement technique used for the presented value

type:

FidelityType

fidelity

The measured fidelity value

Type:: float

standardError

The expected error value reported on the measurement

Type:: Optional[float]

median

Median of fidelity values

Type:: Optional[float]

unit

The expected unit for the fidelity

Type:: FidelityUnit

Create a new model by parsing and validating input data from keyword arguments.

Raises ValidationError if the input data cannot be parsed to form a valid model.

fidelityType: FidelityType | None

fidelity: ConstrainedFloatValue

standardError: ConstrainedFloatValue | None

median: ConstrainedFloatValue | None

unit: FidelityUnit

class braket.device_schema.standardized_gate_model_qpu_device_properties_v3.Duration(*, value: float, standardError: float | None = None, unit: TimeUnit)[source]

Bases: BaseModel

Time duration .. attribute:: value

The measured time duration value

type:

float

standardError

The statistical error or uncertainty in the measured value

Type:: Optional[float]

unit

The unit for the duration value

Type:: TimeUnit

Create a new model by parsing and validating input data from keyword arguments.

Raises ValidationError if the input data cannot be parsed to form a valid model.

value: float

standardError: float | None

unit: TimeUnit

class braket.device_schema.standardized_gate_model_qpu_device_properties_v3.OneQubitProperties(*, oneQubitFidelity: list[Fidelity])[source]

Bases: BaseModel

The standard one-qubit calibration details for a quantum hardware provider .. attribute:: oneQubitFidelity

A list of fidelity measurements for the qubit. This typically includes metrics like randomized benchmarking results that characterize the performance of single-qubit operations.

type:

list[braket.device_schema.standardized_gate_model_qpu_device_properties_v3.Fidelity]

Create a new model by parsing and validating input data from keyword arguments.

Raises ValidationError if the input data cannot be parsed to form a valid model.

oneQubitFidelity: list[Fidelity]

class braket.device_schema.standardized_gate_model_qpu_device_properties_v3.StandardizedGateModelQpuDeviceProperties(*, braketSchemaHeader: BraketSchemaHeader = BraketSchemaHeader(name='braket.device_schema.standardized_gate_model_qpu_device_properties', version='3'), oneQubitProperties: dict[str, OneQubitProperties] | None = None, T1: Duration | None = None, T2: Duration | None = None, readoutFidelity: list[Fidelity] | None = None, readoutDuration: Duration | None = None, singleQubitGateDuration: Duration | None = None, singleQubitFidelity: list[Fidelity] | None = None, twoQubitGateFidelity: list[Fidelity] | None = None, twoQubitGateDuration: Duration | None = None, activeResetDuration: Duration | None = None, updatedAt: datetime | None = None)[source]

Bases: BraketSchemaBase

Braket standarized gate model device qpu properties for the given quantum hardware

oneQubitProperties

Dictionary mapping specific qubit identifiers (ex: ‘1’) to their calibration property sets, including fidelity measurements.

Type:: Dict[str, OneQubitProperties]

T1

The T1 time of the device.

Type:: Optional[Duration]

T2

The T2 time of the device.

Type:: Optional[Duration]

ReadoutFidelity

The fidelity of the readout operation on the device.

Type:: Optional[list[Fidelity]]

ReadoutDuration

The time required to perform a measurement/readout operation.

Type:: Optional[Duration]

SingleQubitGateDuration

The typical duration of a single-qubit gate operation.

Type:: Optional[Duration]

TwoQubitGateFidelity

The fidelity of two-qubit gate operation.

Type:: Optional[list[Fidelity]]

TwoQubitGateDuration

The typical duration of a two-qubit gate operation.

Type:: Optional[Duration]

ActiveResetDuration

Fixed duration to active reset a qubit.

Type:: Optional[Duration]

Examples

>>> import json
>>> valid_input = {
...     "braketSchemaHeader": {
...         "name": "braket.device_schema.standardized_gate_model_qpu_device_properties",
...         "version": "3"
...     },
...     "oneQubitProperties": {
...         "0": {
...             "oneQubitFidelity": [
...                 {
...                     "fidelityType": {
...                         "name": "RANDOMIZED_BENCHMARKING",
...                         "description": "Single qubit randomized benchmarking"
...                     },
...                     "fidelity": 0.9985,
...                     "standardError": 0.0003,
...                     "unit": "fraction"
...                 }
...             ]
...         },
...         "1": {
...             "oneQubitFidelity": [
...                 {
...                     "fidelityType": {
...                         "name": "RANDOMIZED_BENCHMARKING",
...                         "description": "Single qubit randomized benchmarking"
...                     },
...                     "fidelity": 0.9982,
...                     "standardError": 0.0004,
...                     "unit": "fraction"
...                 }
...             ]
...         }
...     },
...     "T1": {
...         "value": 50.0,
...         "standardError": 2.5,
...         "unit": "s"
...     },
...     "T2": {
...         "value": 30.0,
...         "standardError": 1.5,
...         "unit": "s"
...     },
...     "readoutFidelity": [{
...         "fidelity": 0.9950,
...         "standardError": 0.0010,
...         "unit": "fraction"
...     }],
...     "readoutDuration": {
...         "value": 0.000350,
...         "standardError": 0.000010,
...         "unit": "s"
...     },
...     "singleQubitGateDuration": {
...         "value": 0.000020,
...         "standardError": 0.000002,
...         "unit": "s"
...     },
...     "singleQubitFidelity": [{
...          "fidelityType": {
...             "name": "RANDOMIZED_BENCHMARKING",
...             "description": "Single qubit randomized benchmarking"
...         },
...         "fidelity": 0.9950,
...         "standardError": 0.0010,
...         "median": 0.005,
...         "unit": "fraction"
...     }],
...     "twoQubitGateFidelity": [{
...          "fidelityType": {
...             "name": "RANDOMIZED_BENCHMARKING",
...             "description": "Single qubit randomized benchmarking"
...         },
...         "fidelity": 0.9950,
...         "standardError": 0.0010,
...         "unit": "fraction"
...     }],
...     "twoQubitGateDuration": {
...         "value": 0.000200,
...         "standardError": 0.000010,
...         "unit": "s"
...     },
...     "activeResetDuration": {
...         "value": 0.000100,
...         "standardError": 0.000005,
...         "unit": "s"
...     },
...     "updatedAt": "2025-02-22T12:29:03Z"
... }
>>> StandardizedGateModelQpuDeviceProperties.parse_raw_schema(json.dumps(valid_input))

Create a new model by parsing and validating input data from keyword arguments.

Raises ValidationError if the input data cannot be parsed to form a valid model.

braketSchemaHeader: BraketSchemaHeader

oneQubitProperties: dict[str, OneQubitProperties] | None

T1: Duration | None

T2: Duration | None

readoutFidelity: list[Fidelity] | None

readoutDuration: Duration | None

singleQubitGateDuration: Duration | None

singleQubitFidelity: list[Fidelity] | None

twoQubitGateFidelity: list[Fidelity] | None

twoQubitGateDuration: Duration | None

activeResetDuration: Duration | None

updatedAt: datetime | None