pyedb 0.52.0__py3-none-any.whl → 0.53.0__py3-none-any.whl

pyedb/grpc/database/simulation_setup/siwave_cpa_simulation_setup.py

@@ -0,0 +1,961 @@
+from ansys.edb.core.database import ProductIdType as GrpcProductIdType
+from ansys.edb.core.utility.value import Value as GrpcValue
+
+import pyedb.siwave_core.cpa.simulation_setup_data_model
+from pyedb.siwave_core.cpa.simulation_setup_data_model import SIwaveCpaSetup, Vrm
+from pyedb.siwave_core.product_properties import SIwaveProperties
+
+
+class ChannelSetup:
+    """
+    Represents the setup configuration for a channel in SIwave CPA simulations.
+
+    Attributes:
+        die_name (str): The name of the die associated with the channel setup.
+        pin_grouping_mode (str): The mode for pin grouping. Options are "perpin", "ploc", or "usediepingroups".
+        channel_component_exposure (dict): A dictionary mapping component names to their exposure status (True/False).
+        vrm (list): A list of VRM (Voltage Regulator Module) configurations.
+    """
+
+    def __init__(self, pedb, cfg_channel_setup=None):
+        """
+        Initializes the ChannelSetup instance.
+
+        Args:
+            pedb: The database object representing the active cell.
+            cfg_channel_setup: Optional configuration object to initialize the channel setup.
+        """
+        self._pedb = pedb
+        self.__init_values()
+        if cfg_channel_setup:
+            self._apply_cfg_object(cfg_channel_setup)
+
+    def __init_values(self):
+        """
+        Initializes default values for the channel setup attributes.
+        """
+        self.die_name = ""
+        self.pin_grouping_mode = "perpin"
+        self.channel_component_exposure = {}
+
+    def _apply_cfg_object(self, channel_setup):
+        """
+        Applies the configuration object to set up the channel.
+
+        Args:
+            channel_setup: The configuration object containing channel setup data.
+        """
+        self.die_name = channel_setup.die_name
+        self.channel_component_exposure = channel_setup.channel_component_exposure
+        self.pin_grouping_mode = channel_setup.pin_grouping_mode
+        self.vrm = channel_setup.vrm_setup if hasattr(channel_setup, "vrm_setup") else []  # type: ignore[union-attr]
+
+    @property
+    def die_name(self):
+        """
+        Gets the die name from the database.
+
+        Returns:
+            str: The die name.
+        """
+        return self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_CHANNEL_DIE_NAME
+        ).value
+
+    @die_name.setter
+    def die_name(self, value):
+        """
+        Sets the die name in the database.
+
+        Args:
+            value (str): The die name to set.
+        """
+        self._pedb.active_cell.set_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_CHANNEL_DIE_NAME, value
+        )
+
+    @property
+    def pin_grouping_mode(self):
+        """
+        Gets the pin grouping mode from the database.
+
+        Returns:
+            str: The pin grouping mode ("perpin", "ploc", or "usediepingroups").
+        """
+        mode_mapping = {-1: "perpin", 0: "ploc", 1: "usediepingroups"}
+        pg_mode = self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_CHANNEL_PIN_GROUPING_MODE
+        ).value
+        return mode_mapping[int(pg_mode.split(":")[1])] if pg_mode else "perpin"
+
+    @pin_grouping_mode.setter
+    def pin_grouping_mode(self, value):
+        """
+        Sets the pin grouping mode in the database.
+
+        Args:
+            value (str or int): The pin grouping mode ("perpin", "ploc", or "usediepingroups") or its
+            corresponding integer value.
+
+        Raises:
+            ValueError: If the provided value is not supported.
+        """
+        mapping = {"perpin": -1, "ploc": 0, "usediepingroups": 1}
+        if isinstance(value, str):
+            if not value in mapping:
+                raise ValueError(f"value {value} not supported, must be {list(mapping.keys())}")
+            value = mapping[value]
+        if not value in [-1, 0, 1]:
+            raise ValueError(f"wrong value {value}")
+        self._pedb.active_cell.set_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_CHANNEL_PIN_GROUPING_MODE, self.die_name + ":" + str(value)
+        )
+
+    @property
+    def channel_component_exposure(self):
+        """
+        Gets the channel component exposure configuration from the database.
+
+        Returns:
+            dict: A dictionary mapping component names to their exposure status (True/False).
+        """
+        cmp_exposure = self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_CHANNEL_COMPONENT_EXPOSURE_CONFIG
+        ).value
+        cmp_dict = {}
+        for comp in cmp_exposure.split("*"):
+            _comp = comp.split(":")
+            cmp_dict[_comp[0]] = bool(_comp[1])
+        return cmp_dict
+
+    @channel_component_exposure.setter
+    def channel_component_exposure(self, value):
+        """
+        Sets the channel component exposure configuration in the database.
+
+        Args:
+            value (dict): A dictionary mapping component names to their exposure status (True/False).
+
+        Raises:
+            ValueError: If the input is not a dictionary.
+        """
+        if not isinstance(value, dict):
+            raise ValueError("Channel component exposure input must be a dictionary.")
+        channel_comp_exposure = ""
+        for comp, enabled in value.items():
+            if channel_comp_exposure:
+                channel_comp_exposure += "*"
+            channel_comp_exposure += f"{comp}:{int(enabled)}"
+        self._pedb.active_cell.set_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_CHANNEL_COMPONENT_EXPOSURE_CONFIG, channel_comp_exposure
+        )
+
+    @property
+    def vrm(self):
+        """
+        Gets the VRM (Voltage Regulator Module) setup from the database.
+
+        Returns:
+            list: A list of Vrm objects representing the VRM setup.
+
+        Raises:
+            ValueError: If the VRM format is invalid.
+        """
+        vrm = self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_CHANNEL_VRM_SETUP
+        ).value
+        vrm_list = []
+        for _vrm in vrm.split("*"):
+            vrm_obj = Vrm()
+            _vrm_values = _vrm.split(":")
+            if len(_vrm_values) != 4:
+                raise ValueError(
+                    f"Invalid VRM format: {_vrm}. Expected format is 'name:voltage:power_net:reference_net'."
+                )
+            vrm_obj.name = _vrm_values[0]
+            vrm_obj.voltage = float(_vrm_values[1])
+            vrm_obj.power_net = _vrm_values[2]
+            vrm_obj.reference_net = _vrm_values[3]
+            vrm_list.append(vrm_obj)
+        return vrm_list
+
+    @vrm.setter
+    def vrm(self, value):
+        """
+        Sets the VRM (Voltage Regulator Module) setup in the database.
+
+        Args:
+            value (list): A list of Vrm objects representing the VRM setup.
+
+        Raises:
+            ValueError: If the input is not a list.
+        """
+        if not isinstance(value, list):
+            raise ValueError("vrm setter must have list as input.")
+        vrm_str = ""
+        for vrm in value:
+            if isinstance(vrm, pyedb.siwave_core.cpa.simulation_setup_data_model.Vrm):
+                if vrm_str:
+                    vrm_str += "*"
+                vrm_str += vrm.name
+                vrm_str += ":"
+                vrm_str += str(vrm.voltage)
+                vrm_str += ":"
+                vrm_str += vrm.power_net
+                vrm_str += ":"
+                vrm_str += vrm.reference_net
+        self._pedb.active_cell.set_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_CHANNEL_VRM_SETUP, vrm_str
+        )
+
+
+class SolverOptions:
+    """
+    Represents solver options configuration for SIwave CPA simulations.
+
+    Attributes:
+        extraction_mode (str): Extraction mode ('si' or 'pi')
+        custom_refinement (bool): Whether to use custom refinement settings
+        extraction_frequency (str): Frequency for extraction (e.g. '10Ghz')
+        compute_capacitance (bool): Whether to compute capacitance
+        compute_dc_parameters (bool): Whether to compute DC parameters
+        compute_dc_rl (bool): Whether to compute DC RL parameters
+        compute_dc_cg (bool): Whether to compute DC CG parameters
+        compute_ac_rl (bool): Whether to compute AC RL parameters
+        ground_power_nets_for_si (bool): Whether to ground power nets for SI analysis
+        small_hole_diameter (float|str): Small hole diameter value or 'auto'
+        adaptive_refinement_cg_max_passes (int): Max passes for CG adaptive refinement
+        adaptive_refinement_rl_max_passes (int): Max passes for RL adaptive refinement
+        adaptive_refinement_cg_percent_error (float): Target error for CG refinement
+        adaptive_refinement_rl_percent_error (float): Target error for RL refinement
+        rl_percent_refinement_per_pass (float): RL refinement percentage per pass
+        cg_percent_refinement_per_pass (float): CG refinement percentage per pass
+        return_path_net_for_loop_parameters (bool): Whether to use return path net
+    """
+
+    def __init__(self, pedb, cfg_solver_options=None):
+        """
+        Initialize solver options.
+
+        Args:
+            pedb: Database object containing the active cell
+            cfg_solver_options: Optional configuration object to initialize settings
+        """
+        self._pedb = pedb
+        self.__init_values()
+        if cfg_solver_options:
+            self._apply_cfg_object(cfg_solver_options)
+
+    def __init_values(self):
+        """Initialize default values for solver options."""
+        self.mode = "si"
+        self.custom_refinement = False
+        self.extraction_frequency = "10Ghz"
+        self.compute_capacitance = True
+        self.compute_dc_rl = True
+        self.compute_dc_parameters = True
+        self.compute_dc_cg = True
+        self.compute_ac_rl = True
+        self.ground_power_nets_for_si = True
+        self.small_hole_diameter = 0.0
+        self.adaptive_refinement_cg_max_passes = 10
+        self.adaptive_refinement_rl_max_passes = 10
+        self.adaptive_refinement_cg_percent_error = 0.02
+        self.adaptive_refinement_rl_percent_error = 0.02
+        self.rl_percent_refinement_per_pass = 0.33
+        self.cg_percent_refinement_per_pass = 0.33
+        self.return_path_net_for_loop_parameters = True
+
+    def _apply_cfg_object(self, solver_options):
+        """
+        Applies the configuration object to set up solver options.
+
+        Args:
+            solver_options: The configuration object containing solver options data.
+                - extraction_mode (str): The extraction mode ('si' or 'pi').
+                - custom_refinement (bool): Whether to use custom refinement settings.
+                - extraction_frequency (str): Frequency for extraction (e.g., '10Ghz').
+                - compute_capacitance (bool): Whether to compute capacitance.
+                - compute_dc_parameters (bool): Whether to compute DC parameters.
+                - compute_dc_rl (bool): Whether to compute DC RL parameters.
+                - compute_dc_cg (bool): Whether to compute DC CG parameters.
+                - compute_ac_rl (bool): Whether to compute AC RL parameters.
+                - ground_power_nets_for_si (bool): Whether to ground power nets for SI analysis.
+                - small_hole_diameter (float|str): Small hole diameter value or 'auto'.
+                - adaptive_refinement_cg_max_passes (int): Max passes for CG adaptive refinement.
+                - adaptive_refinement_rl_max_passes (int): Max passes for RL adaptive refinement.
+                - adaptive_refinement_cg_percent_error (float): Target error for CG refinement.
+                - adaptive_refinement_rl_percent_error (float): Target error for RL refinement.
+                - rl_percent_refinement_per_pass (float): RL refinement percentage per pass.
+                - cg_percent_refinement_per_pass (float): CG refinement percentage per pass.
+                - return_path_net_for_loop_parameters (bool): Whether to use return path net for loop parameters.
+
+        Raises:
+            AttributeError: If the `solver_options` object does not have the expected attributes.
+        """
+        self.extraction_mode = solver_options.extraction_mode
+        self.custom_refinement = solver_options.custom_refinement
+        self.extraction_frequency = solver_options.extraction_frequency
+        self.compute_capacitance = solver_options.compute_capacitance
+        self.compute_dc_parameters = solver_options.compute_dc_parameters
+        self.compute_dc_rl = solver_options.compute_dc_rl
+        self.compute_dc_cg = solver_options.compute_dc_cg
+        self.compute_ac_rl = solver_options.compute_ac_rl
+        self.ground_power_nets_for_si = solver_options.ground_power_ground_nets_for_si
+        self.small_hole_diameter = solver_options.small_hole_diameter
+        self.adaptive_refinement_cg_max_passes = solver_options.cg_max_passes
+        self.adaptive_refinement_rl_max_passes = solver_options.rl_max_passes
+        self.adaptive_refinement_cg_percent_error = solver_options.cg_percent_error
+        self.adaptive_refinement_rl_percent_error = solver_options.rl_percent_error
+        self.rl_percent_refinement_per_pass = solver_options.rl_percent_refinement_per_pass
+        self.return_path_net_for_loop_parameters = solver_options.return_path_net_for_loop_parameters
+
+    @property
+    def extraction_mode(self):
+        """
+        Gets the extraction mode from the database.
+
+        Returns:
+            str: The extraction mode. Returns "si" if the mode is set to "1", otherwise "pi".
+        """
+        mode = self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_EXTRACTION_MODE
+        ).value
+        if mode == "1":
+            return "si"
+        return "pi"
+
+    @extraction_mode.setter
+    def extraction_mode(self, value):
+        if value == "si":
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_EXTRACTION_MODE, "1"
+            )
+        else:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_EXTRACTION_MODE, "0"
+            )
+
+    @property
+    def custom_refinement(self):
+        """
+        Gets the custom refinement setting from the database.
+
+        Returns:
+            bool: True if custom refinement is enabled, False otherwise.
+        """
+        refine = self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_CUSTOM_REFINEMENT
+        ).value
+        if refine == "1":
+            return True
+        return False
+
+    @custom_refinement.setter
+    def custom_refinement(self, value):
+        if value:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_CUSTOM_REFINEMENT, "1"
+            )
+        else:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_CUSTOM_REFINEMENT, "0"
+            )
+
+    @property
+    def extraction_frequency(self):
+        """
+        Gets the extraction frequency from the database.
+
+        Returns:
+            str: The extraction frequency value as a string.
+        """
+        return self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_EXTRACTION_FREQUENCY
+        ).value
+
+    @extraction_frequency.setter
+    def extraction_frequency(self, value):
+        freq = str(GrpcValue(value))
+        self._pedb.active_cell.set_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_EXTRACTION_FREQUENCY, freq
+        )
+
+    @property
+    def compute_capacitance(self):
+        """
+        Gets the compute capacitance setting from the database.
+
+        Returns:
+            bool: True if capacitance computation is enabled, False otherwise.
+        """
+        compute = self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_COMPUTE_CAPACITANCE
+        ).value
+        if compute == "1":
+            return True
+        return False
+
+    @compute_capacitance.setter
+    def compute_capacitance(self, value):
+        if value:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_COMPUTE_CAPACITANCE, "1"
+            )
+        else:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_COMPUTE_CAPACITANCE, "0"
+            )
+
+    @property
+    def compute_dc_parameters(self):
+        """
+        Gets the compute DC parameters setting from the database.
+
+        Returns:
+            bool: True if DC parameters computation is enabled, False otherwise.
+        """
+        compute = self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_COMPUTE_DC_PARAMS
+        ).value
+        if compute == "1":
+            return True
+        return False
+
+    @compute_dc_parameters.setter
+    def compute_dc_parameters(self, value):
+        if value:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_COMPUTE_DC_PARAMS, "1"
+            )
+        else:
+            self._pedb.active_cell.get_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_COMPUTE_DC_PARAMS, "0"
+            )
+
+    @property
+    def compute_dc_rl(self):
+        """
+        Gets the compute DC RL parameters setting from the database.
+
+        Returns:
+            bool: True if DC RL parameters computation is enabled, False otherwise.
+        """
+        _res = self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_DC_PARAMS_COMPUTE_RL
+        ).value
+        if _res == "1":
+            return True
+        return False
+
+    @compute_dc_rl.setter
+    def compute_dc_rl(self, value):
+        if value:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_DC_PARAMS_COMPUTE_RL, "1"
+            )
+        else:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_DC_PARAMS_COMPUTE_RL, "0"
+            )
+
+    @property
+    def compute_dc_cg(self):
+        """
+        Gets the compute DC CG parameters setting from the database.
+
+        Returns:
+            bool: True if DC CG parameters computation is enabled, False otherwise.
+        """
+        _res = self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_DC_PARAMS_COMPUTE_CG
+        ).value
+        if _res == "1":
+            return True
+        return False
+
+    @compute_dc_cg.setter
+    def compute_dc_cg(self, value):
+        if value:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_DC_PARAMS_COMPUTE_CG, "1"
+            )
+        else:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_DC_PARAMS_COMPUTE_CG, "0"
+            )
+
+    @property
+    def compute_ac_rl(self):
+        """
+        Gets the compute AC RL parameters setting from the database.
+
+        Returns:
+            bool: True if AC RL parameters computation is enabled, False otherwise.
+        """
+        _res = self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_AC_PARAMS_COMPUTE_RL
+        ).value
+        if _res == "1":
+            return True
+        return False
+
+    @compute_ac_rl.setter
+    def compute_ac_rl(self, value):
+        if value:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_AC_PARAMS_COMPUTE_RL, "1"
+            )
+        else:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_AC_PARAMS_COMPUTE_RL, "0"
+            )
+
+    @property
+    def ground_power_nets_for_si(self):
+        """
+        Gets the ground power nets for SI analysis setting from the database.
+
+        Returns:
+            bool: True if grounding power nets for SI analysis is enabled, False otherwise.
+        """
+        _res = self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_GROUND_PG_NETS_FOR_SI
+        ).value
+        if _res == "1":
+            return True
+        return False
+
+    @ground_power_nets_for_si.setter
+    def ground_power_nets_for_si(self, value):
+        if value:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_GROUND_PG_NETS_FOR_SI, "1"
+            )
+        else:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_GROUND_PG_NETS_FOR_SI, "0"
+            )
+
+    @property
+    def small_hole_diameter(self):
+        """
+        Gets the small hole diameter setting from the database.
+
+        Returns:
+            float|str: The small hole diameter as a float, or 'auto' if the value is set to -1.
+        """
+        _res = self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_SMALL_HOLE_DIAMETER
+        ).value
+        if _res == "-1":
+            return "auto"
+        else:
+            return float(_res)
+
+    @small_hole_diameter.setter
+    def small_hole_diameter(self, value):
+        if value == "auto" or value == -1:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_SMALL_HOLE_DIAMETER, "-1"
+            )
+        else:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_SMALL_HOLE_DIAMETER, str(GrpcValue(value))
+            )
+
+    @property
+    def model_type(self):
+        """
+        Gets the model type setting from the database.
+
+        Returns:
+            str: The model type. Returns "rlcg" if the model type is set to "0", otherwise "esd_r".
+        """
+        return self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_MODEL_TYPE
+        ).value
+
+    @model_type.setter
+    def model_type(self, value):
+        self._pedb.active_cell.set_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_MODEL_TYPE, value.lower()
+        )
+
+    @property
+    def adaptive_refinement_cg_max_passes(self):
+        """
+        Gets the maximum number of passes for CG adaptive refinement from the database.
+
+        Returns:
+            int: The maximum number of passes for CG adaptive refinement.
+        """
+        return int(
+            self._pedb.active_cell.get_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_ADAPTIVE_REFINEMENT_CG_MAX_PASSES
+            ).value
+        )
+
+    @adaptive_refinement_cg_max_passes.setter
+    def adaptive_refinement_cg_max_passes(self, value):
+        self._pedb.active_cell.set_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_ADAPTIVE_REFINEMENT_CG_MAX_PASSES, str(int(value))
+        )
+
+    @property
+    def adaptive_refinement_cg_percent_error(self):
+        """
+        Gets the target error percentage for CG adaptive refinement from the database.
+
+        Returns:
+            float: The target error percentage for CG adaptive refinement.
+        """
+        return float(
+            self._pedb.active_cell.get_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_ADAPTIVE_REFINEMENT_CG_PERCENT_ERROR
+            ).value
+        )
+
+    @adaptive_refinement_cg_percent_error.setter
+    def adaptive_refinement_cg_percent_error(self, value):
+        self._pedb.active_cell.set_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_ADAPTIVE_REFINEMENT_CG_PERCENT_ERROR, str(float(value))
+        )
+
+    @property
+    def cg_percent_refinement_per_pass(self):
+        """
+        Gets the percentage of CG refinement per pass from the database.
+
+        Returns:
+            float: The percentage of CG refinement per pass.
+        """
+        return float(
+            self._pedb.active_cell.get_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_ADAPTIVE_REFINEMENT_CG_PERCENT_REFINEMENT_PER_PASS
+            ).value
+        )
+
+    @cg_percent_refinement_per_pass.setter
+    def cg_percent_refinement_per_pass(self, value):
+        self._pedb.active_cell.set_product_property(
+            GrpcProductIdType.SIWAVE,
+            SIwaveProperties.CPA_ADAPTIVE_REFINEMENT_CG_PERCENT_REFINEMENT_PER_PASS,
+            str(float(value)),
+        )
+
+    @property
+    def adaptive_refinement_rl_max_passes(self):
+        """
+        Gets the maximum number of passes for RL adaptive refinement from the database.
+
+        Returns:
+            int: The maximum number of passes for RL adaptive refinement.
+        """
+        return int(
+            float(
+                self._pedb.active_cell.get_product_property(
+                    GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_ADAPTIVE_REFINEMENT_RL_MAX_PASSES
+                ).value
+            )
+        )
+
+    @adaptive_refinement_rl_max_passes.setter
+    def adaptive_refinement_rl_max_passes(self, value):
+        self._pedb.active_cell.set_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_ADAPTIVE_REFINEMENT_RL_MAX_PASSES, str(float(value))
+        )
+
+    @property
+    def adaptive_refinement_rl_percent_error(self):
+        """
+        Gets the target error percentage for RL adaptive refinement from the database.
+
+        Returns:
+            float: The target error percentage for RL adaptive refinement.
+        """
+        return float(
+            self._pedb.active_cell.get_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_ADAPTIVE_REFINEMENT_RL_PERCENT_ERROR
+            ).value
+        )
+
+    @adaptive_refinement_rl_percent_error.setter
+    def adaptive_refinement_rl_percent_error(self, value):
+        self._pedb.active_cell.set_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_ADAPTIVE_REFINEMENT_RL_PERCENT_ERROR, str(float(value))
+        )
+
+    @property
+    def rl_percent_refinement_per_pass(self):
+        """
+        Gets the percentage of RL refinement per pass from the database.
+
+        Returns:
+            float: The percentage of RL refinement per pass.
+        """
+        return float(
+            self._pedb.active_cell.get_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_ADAPTIVE_REFINEMENT_RL_PERCENT_REFINEMENT_PER_PASS
+            ).value
+        )
+
+    @rl_percent_refinement_per_pass.setter
+    def rl_percent_refinement_per_pass(self, value):
+        self._pedb.active_cell.set_product_property(
+            GrpcProductIdType.SIWAVE,
+            SIwaveProperties.CPA_ADAPTIVE_REFINEMENT_RL_PERCENT_REFINEMENT_PER_PASS,
+            str(float(value)),
+        )
+
+    @property
+    def return_path_net_for_loop_parameters(self):
+        """
+        Gets the return path net setting for loop parameters from the database.
+
+        Returns:
+            bool: True if the return path net is enabled for loop parameters, False otherwise.
+        """
+        _res = self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_RETURN_PATH_NET_FOR_LOOP_PARAMS
+        ).value
+        if _res == "1":
+            return True
+        return False
+
+    @return_path_net_for_loop_parameters.setter
+    def return_path_net_for_loop_parameters(self, value):
+        if value:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_RETURN_PATH_NET_FOR_LOOP_PARAMS, "1"
+            )
+        else:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_RETURN_PATH_NET_FOR_LOOP_PARAMS, "0"
+            )
+
+
+class SIWaveCPASimulationSetup:
+    """
+    Represents the setup configuration for SIwave CPA simulations.
+
+    Attributes:
+        _pedb: The database object representing the active cell.
+        _channel_setup (ChannelSetup): The channel setup configuration.
+        _solver_options (SolverOptions): The solver options configuration.
+    """
+
+    def __init__(self, pedb, name=None, siwave_cpa_setup_class=None):
+        """
+        Initializes the SIWaveCPASimulationSetup instance.
+
+        Args:
+            pedb: The database object representing the active cell.
+            name (str, optional): The name of the simulation setup.
+            siwave_cpa_setup_class (SIwaveCpaSetup, optional): An optional configuration object to initialize the setup.
+        """
+        self._pedb = pedb
+        self._channel_setup = ChannelSetup(pedb)
+        self._solver_options = SolverOptions(pedb)
+        if isinstance(siwave_cpa_setup_class, SIwaveCpaSetup):
+            self._apply_cfg_object(siwave_cpa_setup_class)
+        else:
+            self.__init_values()
+
+        if (
+            not self._pedb.active_cell.get_product_property(
+                GrpcProductIdType.SIWAVE,
+                SIwaveProperties.CPA_SIM_NAME,
+            )
+            == name
+        ):
+            self._pedb.active_cell.set_product_property(GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_SIM_NAME, name)
+
+    def __init_values(self):
+        """
+        Initializes default values for the simulation setup attributes.
+        """
+        self.mode = "channel"
+        self.model_type = "rlcg"
+        self.use_q3d_solver = False
+        self.net_processing_mode = "all"
+
+    def _apply_cfg_object(self, siwave_cpa_setup_class):
+        """
+        Applies the configuration object to set up the simulation.
+
+        Args:
+            siwave_cpa_setup_class (SIwaveCpaSetup): The configuration object containing simulation setup data.
+        """
+        if isinstance(siwave_cpa_setup_class, SIwaveCpaSetup):
+            self.name = siwave_cpa_setup_class.name
+            self.mode = siwave_cpa_setup_class.mode
+            self.nets_to_process = siwave_cpa_setup_class.nets_to_process
+            self.model_type = siwave_cpa_setup_class.model_type
+            self.use_q3d_solver = siwave_cpa_setup_class.use_q3d_solver
+            self.net_processing_mode = siwave_cpa_setup_class.net_processing_mode
+            self.channel_setup = ChannelSetup(self._pedb, siwave_cpa_setup_class.channel_setup)
+            self.solver_options = SolverOptions(self._pedb, siwave_cpa_setup_class.solver_options)
+
+    @property
+    def name(self) -> str:
+        """
+        Gets the name of the simulation setup.
+
+        Returns:
+            str: The name of the simulation setup.
+        """
+        return self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_SIM_NAME
+        ).value
+
+    @name.setter
+    def name(self, value):
+        self._pedb.active_cell.set_product_property(GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_SIM_NAME, value)
+
+    @property
+    def mode(self):
+        """
+        Gets the mode of the simulation setup.
+
+        Returns:
+            str: The mode of the simulation setup ("channel" or "no_channel").
+        """
+        cpa_mode = self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_CHANNEL_SETUP
+        ).value
+        if cpa_mode == "1":
+            return "channel"
+        return "no_channel"
+
+    @mode.setter
+    def mode(self, value):
+        if value == "channel":
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_CHANNEL_SETUP, "1"
+            )
+        else:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_CHANNEL_SETUP, "0"
+            )
+
+    @property
+    def model_type(self):
+        """
+        Gets the model type of the simulation setup.
+
+        Returns:
+            str: The model type ("rlcg" or "esd_r").
+        """
+        mod_type = self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_ESD_R_MODEL
+        ).value
+        if mod_type == "0":
+            return "rlcg"
+        else:
+            return "esd_r"
+
+    @model_type.setter
+    def model_type(self, value):
+        if value == "rlcg":
+            self._pedb.active_cell.set_product_property(GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_ESD_R_MODEL, "0")
+        elif value == "esd_r":
+            self._pedb.active_cell.set_product_property(GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_ESD_R_MODEL, "1")
+
+    @property
+    def use_q3d_solver(self):
+        """
+        Gets the Q3D solver usage setting.
+
+        Returns:
+            bool: True if the Q3D solver is used, False otherwise.
+        """
+        return bool(
+            int(
+                self._pedb.active_cell.get_product_property(
+                    GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_USE_Q3D_SOLVER
+                ).value
+            )
+        )
+
+    @use_q3d_solver.setter
+    def use_q3d_solver(self, value):
+        if value:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_USE_Q3D_SOLVER, "1"
+            )
+        else:
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_USE_Q3D_SOLVER, "0"
+            )
+
+    @property
+    def net_processing_mode(self):
+        """
+        Gets the net processing mode.
+
+        Returns:
+            str: The net processing mode.
+        """
+        return self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_NET_PROCESSING_MODE
+        ).value
+
+    @net_processing_mode.setter
+    def net_processing_mode(self, value):
+        self._pedb.active_cell.set_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_NET_PROCESSING_MODE, str(value)
+        )
+
+    @property
+    def channel_setup(self):
+        """
+        Gets the channel setup configuration.
+
+        Returns:
+            ChannelSetup: The channel setup configuration.
+        """
+        return self._channel_setup
+
+    @channel_setup.setter
+    def channel_setup(self, value):
+        if isinstance(value, ChannelSetup):
+            self._channel_setup = value
+
+    @property
+    def solver_options(self):
+        """
+        Gets the solver options configuration.
+
+        Returns:
+            SolverOptions: The solver options configuration.
+        """
+        return self._solver_options
+
+    @solver_options.setter
+    def solver_options(self, value):
+        if isinstance(value, SolverOptions):
+            self._solver_options = value
+
+    @property
+    def nets_to_process(self):
+        """
+        Gets the list of nets to process.
+
+        Returns:
+            list: A list of nets to process.
+        """
+        nets = self._pedb.active_cell.get_product_property(
+            GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_NETS_TO_PROCESS
+        ).value
+        return nets.split("*")
+
+    @nets_to_process.setter
+    def nets_to_process(self, value):
+        if isinstance(value, list):
+            nets = "*".join(value)
+            self._pedb.active_cell.set_product_property(
+                GrpcProductIdType.SIWAVE, SIwaveProperties.CPA_NETS_TO_PROCESS, nets
+            )
+        else:
+            raise TypeError("nets_to_process must be a list of strings.")