Update the qobj schema to support pulse gate calibrations.

qiskit/qobj/qasm_qobj.py

@@ -368,7 +368,32 @@ class QasmQobjExperimentHeader(QobjDictField):
 
 class QasmQobjExperimentConfig(QobjDictField):
     """Configuration for a single QASM experiment in the qobj."""
-    pass
+
+    def __init__(self, calibrations=None, **kwargs):
+        """
+        Args:
+            calibrations (QasmQobjCalibrations): Information required for
+                                                 Pulse gates.
+            kwargs: Additional free form key value fields to add to the
+                configuration.
+        """
+        if calibrations:
+            self.calibrations = calibrations
+        super().__init__(**kwargs)
+
+
+class QasmQobjCalibrations(QobjDictField):
+    """The description of all the gate calibrations. Each gate dictionary should contain
+    "name", "qubits", "params", and "instructions" fields."""
+
+    def __init__(self, gates, pulse_library):
+        """
+        Args:
+            gates (list): A list of dictionaries which specify a gate by name, qubits,
+                          and params, and contains the Pulse instructions to implement it.
+            pulse_library (list): List of :class:`PulseLibraryItem`.
+        """
+        super().__init__(gates=gates, pulse_library=pulse_library)
 
 
 class QobjHeader(QobjDictField):
@@ -405,7 +430,7 @@ def __init__(self, qobj_id=None, config=None, experiments=None,
         self.experiments = experiments or []
         self.qobj_id = qobj_id
         self.type = 'QASM'
-        self.schema_version = '1.2.0'
+        self.schema_version = '1.3.0'
 
     def __repr__(self):
         experiments_str = [repr(x) for x in self.experiments]

qiskit/schemas/qobj_schema.json

@@ -847,6 +847,41 @@
             },
             "type": "array"
         },
+        "calibration_entry": {
+            "description": "The instruction description of each calibrated gate.",
+            "type": "object",
+            "properties": {
+                "name": {
+                    "description": "Gate name",
+                    "type": "string"
+                },
+                "qubits": {
+                    "items": {
+                        "minimum": 0,
+                        "type": "integer"
+                    },
+                    "minItems": 1,
+                    "type": "array"
+                },
+                "params": {
+                    "description": "Gate parameters",
+                    "type": "array"
+                },
+                "instructions": {
+                    "description": "Pulse instructions implementing the given gate.",
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/definitions/qobjinstructions"
+                    }
+                }
+            },
+            "required": [
+                "name",
+                "qubits",
+                "params",
+                "instructions"
+            ]
+        },
         "qobjexp": {
             "description": "Quantum experiment",
             "properties": {
@@ -866,6 +901,22 @@
                         "init_qubits": {
                             "description": "Whether to initialize the qubits in the ground state before each shot.",
                             "type": "boolean"
+                        },
+                        "calibrations": {
+                            "description": "User-specified pulse-level calibrations for operations utilized in this experiment.",
+                            "type": "object",
+                            "properties": {
+                                "gates": {
+                                    "$ref": "#/definitions/calibration_entry"
+                                },
+                                "pulse_library": {
+                                    "description": "Pulses for gate calibrations.",
+                                        "items": {
+                                            "$ref": "#/definitions/pulse_library"
+                                        },
+                                    "type": "array"
+                                }
+                            }
                         }
                     },
                     "title": "Experiment level configuration",