Serializable parametric pulse

qiskit/pulse/__init__.py

@@ -143,6 +143,7 @@
     Gaussian,
     GaussianSquare,
     ParametricPulse,
+    SymbolicPulse,
     Waveform,
 )
 from qiskit.pulse.library.samplers.decorators import functional_pulse

qiskit/pulse/library/__init__.py

@@ -22,10 +22,11 @@
 The :py:mod:`~qiskit.pulse.library.discrete` module will generate
 :py:class:`~qiskit.pulse.library.Waveform`\ s for common waveform envelopes.
 
-The parametric pulses, :py:class:`~qiskit.pulse.library.Gaussian`,
+The symbolic pulses, :py:class:`~qiskit.pulse.library.Gaussian`,
 :py:class:`~qiskit.pulse.library.GaussianSquare`, :py:class:`~qiskit.pulse.library.Drag` and
-:py:class:`~qiskit.pulse.library.Constant` will generate parameterized descriptions of
-those pulses, which can greatly reduce the size of the job sent to the backend.
+:py:class:`~qiskit.pulse.library.Constant` will generate symbolic descriptions of
+those pulses, which can greatly reduce the size of the job sent to the backend and
+ensure serialization of these pulse data in QPY binary format.
 
 .. autosummary::
    :toctree: ../stubs/
@@ -39,6 +40,7 @@
 
 """
 from .discrete import *
-from .parametric_pulses import ParametricPulse, Gaussian, GaussianSquare, Drag, Constant
+from .parametric_pulses import ParametricPulse
+from .symbolic_pulses import SymbolicPulse, Gaussian, GaussianSquare, Drag, Constant
 from .pulse import Pulse
 from .waveform import Waveform

qiskit/pulse/library/parametric_pulses.py

@@ -36,6 +36,7 @@ class ParametricPulseShapes(Enum):
         ...
         new_supported_pulse_name = library.YourPulseWaveformClass
 """
+import warnings
 from abc import abstractmethod
 from typing import Any, Dict, Optional, Union
 
@@ -70,6 +71,14 @@ def __init__(
                              amplitude is constrained to 1.
         """
         super().__init__(duration=duration, name=name, limit_amplitude=limit_amplitude)
+
+        warnings.warn(
+            "ParametricPulse and its subclass have been deprecated and will be replaced with "
+            "SymbolicPulse and its subclass because of QPY serialization support. "
+            "See qiskit.pulse.library.symbolic_pulses for details.",
+            DeprecationWarning,
+            stacklevel=3,
+        )
         self.validate_parameters()
 
     @abstractmethod

qiskit/pulse/library/pulse.py

@@ -24,6 +24,8 @@ class Pulse(ABC):
     modulation phase and frequency are specified separately from ``Pulse``s.
     """
 
+    __slots__ = ("duration", "name")
+
     limit_amplitude = True
 
     @abstractmethod
@@ -47,7 +49,7 @@ def __init__(
         self.duration = duration
         self.name = name
         if limit_amplitude is not None:
-            self.limit_amplitude = limit_amplitude
+            self.__class__.limit_amplitude = limit_amplitude
 
     @property
     def id(self) -> int:  # pylint: disable=invalid-name