Remove deprecation warning for unsupported parameters of transpilation settings

qiskit_ibm_runtime/options/execution_options.py

@@ -13,9 +13,15 @@
 """Execution options."""
 
 from dataclasses import dataclass
+from typing import Literal, get_args
 
 from .utils import _flexible
 
+ExecutionSupportedOptions = Literal[
+    "shots",
+    "init_qubits",
+]
+
 
 @_flexible
 @dataclass
@@ -31,3 +37,13 @@ class ExecutionOptions:
 
     shots: int = 4000
     init_qubits: bool = True
+
+    @staticmethod
+    def validate_execution_options(execution_options: dict) -> None:
+        """Validate that execution options are legal.
+        Raises:
+            ValueError: if any execution option is not supported
+        """
+        for opt in execution_options:
+            if not opt in get_args(ExecutionSupportedOptions):
+                raise ValueError(f"Unsupported value '{opt}' for execution.")

qiskit_ibm_runtime/options/options.py

@@ -26,7 +26,6 @@
 from .transpilation_options import TranspilationOptions
 from .resilience_options import ResilienceOptions
 from ..runtime_options import RuntimeOptions
-from ..utils.deprecation import issue_deprecation_msg
 
 
 @_flexible
@@ -143,14 +142,6 @@ def _get_program_inputs(options: dict) -> dict:
             }
         )
 
-        for deprecated in ["translation_method", "timing_constraints"]:
-            if deprecated in inputs["transpilation_settings"]:
-                issue_deprecation_msg(
-                    msg=f"The {deprecated} transpilation option has been deprecated",
-                    version="0.8",
-                    remedy="",
-                )
-
         known_keys = list(Options.__dataclass_fields__.keys())
         known_keys.append("image")
         # Add additional unknown keys.
@@ -188,6 +179,8 @@ def validate_options(options: dict) -> None:
                 )
 
         EnvironmentOptions.validate_environment_options(options.get("environment"))
+        ExecutionOptions.validate_execution_options(options.get("execution"))
+        SimulatorOptions.validate_simulator_options(options.get("simulator"))
 
     @staticmethod
     def _get_runtime_options(options: dict) -> dict:

qiskit_ibm_runtime/options/resilience_options.py

@@ -17,6 +17,11 @@
 
 from .utils import _flexible
 
+ResilienceSupportedOptions = Literal[
+    "noise_amplifier",
+    "noise_factors",
+    "extrapolator",
+]
 NoiseAmplifierType = Literal[
     "TwoQubitAmplifier",
     "GlobalFoldingAmplifier",
@@ -63,11 +68,15 @@ class ResilienceOptions:
     def validate_resilience_options(resilience_options: dict) -> None:
         """Validate that resilience options are legal.
         Raises:
+            ValueError: if any resilience option is not supported
             ValueError: if noise_amplifier is not in NoiseAmplifierType.
             ValueError: if extrapolator is not in ExtrapolatorType.
             ValueError: if extrapolator == "QuarticExtrapolator" and number of noise_factors < 5.
             ValueError: if extrapolator == "CubicExtrapolator" and number of noise_factors < 4.
         """
+        for opt in resilience_options:
+            if not opt in get_args(ResilienceSupportedOptions):
+                raise ValueError(f"Unsupported value '{opt}' for resilience.")
         noise_amplifier = resilience_options.get("noise_amplifier")
         if not noise_amplifier in get_args(NoiseAmplifierType):
             raise ValueError(

qiskit_ibm_runtime/options/simulator_options.py

@@ -12,8 +12,9 @@
 
 """Simulator options."""
 
+
+from typing import Optional, List, Union, Literal, get_args, TYPE_CHECKING
 from dataclasses import dataclass
-from typing import TYPE_CHECKING, List, Optional, Union
 
 from qiskit.exceptions import MissingOptionalLibraryError
 from qiskit.providers import BackendV1, BackendV2
@@ -26,6 +27,13 @@
 if TYPE_CHECKING:
     import qiskit_aer
 
+SimulatorSupportedOptions = Literal[
+    "noise_model",
+    "seed_simulator",
+    "coupling_map",
+    "basis_gates",
+]
+
 
 @_flexible
 @dataclass()
@@ -54,6 +62,16 @@ class SimulatorOptions:
     coupling_map: Optional[Union[List[List[int]], "CouplingMap"]] = None
     basis_gates: Optional[List[str]] = None
 
+    @staticmethod
+    def validate_simulator_options(simulator_options: dict) -> None:
+        """Validate that simulator options are legal.
+        Raises:
+            ValueError: if any simulator option is not supported
+        """
+        for opt in simulator_options:
+            if not opt in get_args(SimulatorSupportedOptions):
+                raise ValueError(f"Unsupported value '{opt}' for simulator.")
+
     def set_backend(self, backend: Union[BackendV1, BackendV2]) -> None:
         """Set backend for simulation.
         This method changes noise_model, coupling_map, basis_gates according to given backend.

qiskit_ibm_runtime/options/transpilation_options.py

@@ -17,6 +17,13 @@
 
 from .utils import _flexible
 
+TranspilationSupportedOptions = Literal[
+    "skip_transpilation",
+    "initial_layout",
+    "layout_method",
+    "routing_method",
+    "approximation_degree",
+]
 LayoutMethodType = Literal[
     "trivial",
     "dense",
@@ -64,10 +71,14 @@ class TranspilationOptions:
     def validate_transpilation_options(transpilation_options: dict) -> None:
         """Validate that transpilation options are legal.
         Raises:
+            ValueError: if any transpilation option is not supported
             ValueError: if layout_method is not in LayoutMethodType or None.
             ValueError: if routing_method is not in RoutingMethodType or None.
             ValueError: if approximation_degree in not None or in the range 0.0 to 1.0.
         """
+        for opt in transpilation_options:
+            if not opt in get_args(TranspilationSupportedOptions):
+                raise ValueError(f"Unsupported value '{opt}' for transpilation.")
         layout_method = transpilation_options.get("layout_method")
         if not (layout_method in get_args(LayoutMethodType) or layout_method is None):
             raise ValueError(

releasenotes/notes/option_validation-79d26018ab770519.yaml

@@ -0,0 +1,8 @@
+---
+features:
+  - |
+    Added validations for options on the second level of the dict,
+    i.e., for each of resilience, simulator, execution, and 
+    transpilation, check that their options are supported. 
+    Otherwise throw an exception.
+

test/unit/test_options.py

@@ -190,6 +190,29 @@ def test_init_options_with_dictionary(self):
                 # Make sure the structure didn't change.
                 self.assertTrue(dict_keys_equal(asdict(Options()), options), f"options={options}")
 
+    def test_unsupported_options(self):
+        """Test error on unsupported second level options"""
+        # defining minimal dict of options
+        options = {
+            "optimization_level": 1,
+            "resilience_level": 2,
+            "transpilation": {"initial_layout": [1, 2], "skip_transpilation": True},
+            "execution": {"shots": 100},
+            "environment": {"log_level": "DEBUG"},
+            "simulator": {"noise_model": "model"},
+            "resilience": {
+                "noise_amplifier": "GlobalFoldingAmplifier",
+                "extrapolator": "LinearExtrapolator",
+            },
+        }
+        Options.validate_options(options)
+        for opt in ["resilience", "simulator", "transpilation", "execution"]:
+            temp_options = options.copy()
+            temp_options[opt] = {"aaa": "bbb"}
+            with self.assertRaises(ValueError) as exc:
+                Options.validate_options(temp_options)
+            self.assertIn(f"Unsupported value 'aaa' for {opt}.", str(exc.exception))
+
     def test_coupling_map_options(self):
         """Check that coupling_map is processed correctly for various types"""
         coupling_map = {(1, 0), (2, 1), (0, 1), (1, 2)}