ansys-edb-core 0.2.0.dev2__tar.gz → 0.2.0.dev4__tar.gz

{ansys_edb_core-0.2.0.dev2 → ansys_edb_core-0.2.0.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ansys-edb-core
-Version: 0.2.0.dev2
+Version: 0.2.0.dev4
 Summary: A python wrapper for Ansys Edb service
 Author-email: "ANSYS, Inc." <pyansys.support@ansys.com>
 Maintainer-email: PyAnsys developers <pyansys.maintainers@ansys.com>
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 License-File: LICENSE
-Requires-Dist: ansys-api-edb==0.2.dev1
+Requires-Dist: ansys-api-edb==0.2.dev6
 Requires-Dist: protobuf>=3.19.3,<5
 Requires-Dist: grpcio>=1.44.0
 Requires-Dist: Django>=4.2.16

{ansys_edb_core-0.2.0.dev2 → ansys_edb_core-0.2.0.dev4}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "flit_core.buildapi"
 [project]
 # Check https://flit.readthedocs.io/en/latest/pyproject_toml.html for all available sections
 name = "ansys-edb-core"
-version = "0.2.0.dev2"
+version = "0.2.0.dev4"
 description = "A python wrapper for Ansys Edb service"
 readme = "README.rst"
 requires-python = ">=3.8"
@@ -25,7 +25,7 @@ classifiers = [
 
 
 dependencies = [
-    "ansys-api-edb==0.2.dev1",
+    "ansys-api-edb==0.2.dev6",
     "protobuf>=3.19.3,<5",
     "grpcio>=1.44.0",
     "Django>=4.2.16"

{ansys_edb_core-0.2.0.dev2 → ansys_edb_core-0.2.0.dev4}/src/ansys/edb/core/definition/component_def.py

@@ -1,9 +1,23 @@
 """Component definition."""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, List
+
+if TYPE_CHECKING:
+    from src.ansys.edb.core.database import ProductIdType
+
 from ansys.api.edb.v1.component_def_pb2_grpc import ComponentDefServiceStub
 
 from ansys.edb.core.definition import component_model, component_pin
 from ansys.edb.core.edb_defs import DefinitionObjType
 from ansys.edb.core.inner import ObjBase, messages
+from ansys.edb.core.inner.messages import (
+    edb_obj_collection_property_message,
+    edb_obj_pair_message,
+    get_product_property_ids_message,
+    get_product_property_message,
+    set_product_property_message,
+)
 from ansys.edb.core.inner.utils import map_list
 from ansys.edb.core.session import StubAccessor, StubType
 
@@ -87,7 +101,7 @@ class ComponentDef(ObjBase):
         This property is read-only.
         """
         objs = self.__stub.GetComponentModels(self.msg).items
-        return map_list(objs, component_model.ComponentModel)
+        return map_list(objs, lambda msg: component_model.ComponentModel(msg).cast())
 
     @property
     def component_pins(self):
@@ -125,3 +139,80 @@ class ComponentDef(ObjBase):
         Once a component model is added to one component def, it cannot be added to any other, even when removed.
         """
         self.__stub.RemoveComponentModel(messages.pointer_property_message(self, value))
+
+    def reorder_pins(self, reordered_pins: List[component_pin.ComponentPin]):
+        """Reorders the existing pins in the components definition to be in the same order \
+        as in the provided list.
+
+        Parameters
+        ----------
+        reordered_pins : list of .ComponentPin
+            The component pins in the new order. These must be the same pins \
+            that already exist in the component definition.
+        """
+        self.__stub.ReorderPins(edb_obj_collection_property_message(self, reordered_pins))
+
+    def remove_pin(self, pin_to_remove: component_pin.ComponentPin):
+        """Remove the provided component pin from the component definition. \
+        the pin will be deleted and set to :meth:`null <.is_null>`.
+
+        Parameters
+        ----------
+        pin_to_remove : .ComponentPin
+            The pin to be removed.
+        """
+        self.__stub.RemovePin(edb_obj_pair_message(self, pin_to_remove))
+        pin_to_remove.msg = None
+
+    def get_product_property(self, prod_id: ProductIdType, attr_it: int) -> str:
+        """Get the product property for a given product ID and attribute ID.
+
+        Parameters
+        ----------
+        prod_id : .ProductIdType
+            Product ID.
+        attr_it : int
+            Attribute ID.
+
+        Returns
+        -------
+        str
+            Product property for the given product ID and attribute ID.
+        """
+        return self.__stub.GetProductProperty(
+            get_product_property_message(self, prod_id, attr_it)
+        ).value
+
+    def set_product_property(self, prod_id: ProductIdType, attr_it: int, prop_value: str):
+        """Set the product property for the given product ID and attribute ID.
+
+        Parameters
+        ----------
+        prod_id : .ProductIdType
+            Product ID.
+        attr_it : int
+            Attribute ID.
+        prop_value : str
+            New value for the product property.
+        """
+        self.__stub.SetProductProperty(
+            set_product_property_message(self, prod_id, attr_it, prop_value)
+        )
+
+    def get_product_property_ids(self, prod_id: ProductIdType) -> List[int]:
+        """Get the list of property IDs for a given property ID.
+
+        Parameters
+        ----------
+        prod_id : ProductIdType
+            Product ID.
+
+        Returns
+        -------
+        list[int]
+            Attribute IDs for the given product ID.
+        """
+        attr_ids = self.__stub.GetProductPropertyIds(
+            get_product_property_ids_message(self, prod_id)
+        ).ids
+        return [attr_id for attr_id in attr_ids]

{ansys_edb_core-0.2.0.dev2 → ansys_edb_core-0.2.0.dev4}/src/ansys/edb/core/definition/component_model.py

@@ -1,4 +1,7 @@
 """Component model definition."""
+from enum import Enum
+
+from ansys.api.edb.v1.component_model_pb2 import ComponentModelType as pb_comp_model_Type
 from ansys.api.edb.v1.component_model_pb2_grpc import (
     ComponentModelServiceStub,
     DynamicLinkComponentModelServiceStub,
@@ -10,6 +13,14 @@ from ansys.edb.core.inner import ObjBase, messages
 from ansys.edb.core.session import StubAccessor, StubType
 
 
+class ComponentModelType(Enum):
+    """Enum representing component model types."""
+
+    N_PORT = pb_comp_model_Type.N_PORT
+    DYNAMIC_LINK = pb_comp_model_Type.DYNAMIC_LINK
+    UNKNOWN_COMPONENT_MODEL_TYPE = pb_comp_model_Type.UNKNOWN_MODEL_TYPE
+
+
 class ComponentModel(ObjBase):
     """Represents a component model."""
 
@@ -42,7 +53,7 @@ class ComponentModel(ObjBase):
         """
         return ComponentModel(
             cls.__stub.FindByName(messages.string_property_message(comp_def, value))
-        )
+        ).cast()
 
     @classmethod
     def find_by_id(cls, comp_def, value):
@@ -60,7 +71,51 @@ class ComponentModel(ObjBase):
         ComponentModel
             Component model that is found, ``None`` otherwise.
         """
-        return ComponentModel(cls.__stub.FindById(messages.int_proprty_message(comp_def, value)))
+        return ComponentModel(
+            cls.__stub.FindById(messages.int_property_message(comp_def, value))
+        ).cast()
+
+    @property
+    def name(self) -> str:
+        """:obj:`str`: The name of the component model.
+
+        This property is read-only.
+        """
+        return self.__stub.GetName(self.msg).value
+
+    @property
+    def component_model_type(self) -> ComponentModelType:
+        """:class:`.ComponentModelType`: The type of the component model.
+
+        This property is read-only.
+        """
+        return ComponentModelType(self.__stub.GetType(self.msg).type)
+
+    @property
+    def component_model_id(self) -> int:
+        """:obj:`int`: The id of the component model.
+
+        This property is read-only.
+        """
+        return self.__stub.GetId(self.msg).value
+
+    def cast(self) -> "ComponentModel":
+        """Cast the component model object to the correct concrete type.
+
+        Returns
+        -------
+        .ComponentModel
+        """
+        comp_model_type = (
+            ComponentModelType.UNKNOWN_COMPONENT_MODEL_TYPE
+            if self.is_null
+            else self.component_model_type
+        )
+        if comp_model_type == ComponentModelType.N_PORT:
+            return NPortComponentModel(self.msg)
+        elif comp_model_type == ComponentModelType.DYNAMIC_LINK:
+            return DynamicLinkComponentModel(self.msg)
+        return ComponentModel(self.msg)
 
 
 class NPortComponentModel(ComponentModel):

{ansys_edb_core-0.2.0.dev2 → ansys_edb_core-0.2.0.dev4}/src/ansys/edb/core/definition/material_def.py

@@ -5,6 +5,9 @@ from enum import Enum
 import ansys.api.edb.v1.material_def_pb2 as pb
 
 from ansys.edb.core.definition.dielectric_material_model import DielectricMaterialModel
+from ansys.edb.core.definition.material_property_thermal_modifier import (
+    MaterialPropertyThermalModifier,
+)
 from ansys.edb.core.edb_defs import DefinitionObjType
 from ansys.edb.core.inner import ObjBase, messages
 from ansys.edb.core.session import MaterialDefServiceStub, StubAccessor, StubType
@@ -28,10 +31,6 @@ class MaterialProperty(Enum):
     INVALID_PROPERTY = pb.INVALID_PROPERTY
 
 
-class ThermalModifier(ObjBase):
-    """Represents a thermal modifier model."""
-
-
 class MaterialDef(ObjBase):
     """Represents a material definition."""
 
@@ -236,10 +235,10 @@ class MaterialDef(ObjBase):
 
         Returns
         -------
-        ThermalModifier
+        MaterialPropertyThermalModifier
             Thermal modifier of the material definition.
         """
-        return ThermalModifier(
+        return MaterialPropertyThermalModifier(
             self.__stub.GetThermalModifier(
                 MaterialDef._property_message(self, material_property_id)
             )
@@ -253,7 +252,7 @@ class MaterialDef(ObjBase):
         material_property_id : \
         :class:`MaterialProperty`
             Property ID.
-        thermal_modifier : ThermalModifier
+        thermal_modifier : MaterialPropertyThermalModifier
             Thermal modifier to set to the material definition.
         """
         self.__stub.SetThermalModifier(
@@ -277,10 +276,10 @@ class MaterialDef(ObjBase):
 
         Returns
         -------
-        :class:`.ThermalModifier`
+        :class:`.MaterialPropertyThermalModifier`
             Anisotropic thermal modifier of the material definition.
         """
-        return ThermalModifier(
+        return MaterialPropertyThermalModifier(
             self.__stub.GetAnisotropicThermalModifier(
                 pb.MaterialDefPropertyComponentMessage(
                     materialDef=messages.edb_obj_message(self),
@@ -302,7 +301,7 @@ class MaterialDef(ObjBase):
             Property ID.
         component_id : int
             Component ID.
-        thermal_modifier : :class:`.ThermalModifier`
+        thermal_modifier : :class:`.MaterialPropertyThermalModifier`
             Anisotropic thermal modifier to set to the material definition.
         """
         self.__stub.SetAnisotropicThermalModifier(

{ansys_edb_core-0.2.0.dev2 → ansys_edb_core-0.2.0.dev4}/src/ansys/edb/core/definition/padstack_def_data.py

@@ -118,7 +118,7 @@ class PadstackDefData(ObjBase):
         This property is read-only.
         """
         layer_names_msg = self.__stub.GetLayerNames(self.msg).names
-        return layer_names_msg
+        return list(layer_names_msg)
 
     @property
     def layer_ids(self):
@@ -127,7 +127,7 @@ class PadstackDefData(ObjBase):
         This property is read-only.
         """
         layer_ids_msg = self.__stub.GetLayerIds(self.msg)
-        return layer_ids_msg.ids
+        return list(layer_ids_msg.ids)
 
     def add_layers(self, names):
         """
@@ -189,13 +189,15 @@ class PadstackDefData(ObjBase):
                 Value(message.generic.offset_y),
                 Value(message.generic.rotation),
             )
-        else:
+        elif message.HasField("polygon"):
             return (
                 parser.to_polygon_data(message.polygon.fp),
                 Value(message.polygon.offset_x),
                 Value(message.polygon.offset_y),
                 Value(message.polygon.rotation),
             )
+        else:
+            return ()
 
     def set_pad_parameters(
         self, layer, pad_type, offset_x, offset_y, rotation, type_geom=None, sizes=None, fp=None

{ansys_edb_core-0.2.0.dev2 → ansys_edb_core-0.2.0.dev4}/src/ansys/edb/core/geometry/polygon_data.py

@@ -9,6 +9,7 @@ from ansys.api.edb.v1 import edb_defs_pb2, point_data_pb2, polygon_data_pb2, pol
 from ansys.edb.core import session
 from ansys.edb.core.geometry.arc_data import ArcData
 from ansys.edb.core.inner import messages, parser
+from ansys.edb.core.inner.utils import client_stream_iterator
 from ansys.edb.core.utility import conversions
 
 
@@ -40,6 +41,17 @@ class IntersectionType(Enum):
 class PolygonData:
     """Represents a polygon data object."""
 
+    @staticmethod
+    def _polygon_data_request_iterator(polys):
+        chunk_entry_creator = lambda poly: messages.polygon_data_message(poly)
+        chunk_entries_getter = lambda chunk: chunk.polygons
+        return client_stream_iterator(
+            polys,
+            polygon_data_pb2.PolygonDataListMessage,
+            chunk_entry_creator,
+            chunk_entries_getter,
+        )
+
     __stub: polygon_data_pb2_grpc.PolygonDataServiceStub = session.StubAccessor(
         session.StubType.polygon_data
     )
@@ -355,7 +367,7 @@ class PolygonData:
         -------
         tuple[.PointData, .PointData]
         """
-        return cls.__stub.GetBBox(messages.polygon_data_list_message(polygons))
+        return cls.__stub.GetStreamedBBox(PolygonData._polygon_data_request_iterator(polygons))
 
     @parser.to_circle
     def bounding_circle(self):

{ansys_edb_core-0.2.0.dev2 → ansys_edb_core-0.2.0.dev4}/src/ansys/edb/core/hierarchy/cell_instance.py

@@ -98,7 +98,7 @@ class CellInstance(hierarchy_obj.HierarchyObj):
 
         This property is read-only.
         """
-        from ansys.edb.core.terminal.terminals import TerminalInstance
+        from ansys.edb.core.terminal.terminal_instance import TerminalInstance
 
         terms = self.__stub.GetTermInsts(self.msg).items
         return [TerminalInstance(ti) for ti in terms]

{ansys_edb_core-0.2.0.dev2 → ansys_edb_core-0.2.0.dev4}/src/ansys/edb/core/hierarchy/group.py

@@ -6,6 +6,7 @@ from ansys.api.edb.v1.group_pb2_grpc import GroupServiceStub
 from ansys.edb.core.edb_defs import LayoutObjType
 from ansys.edb.core.hierarchy.hierarchy_obj import HierarchyObj
 from ansys.edb.core.inner import messages
+from ansys.edb.core.inner.utils import query_lyt_object_collection
 from ansys.edb.core.session import StubAccessor, StubType
 
 
@@ -113,7 +114,10 @@ class Group(HierarchyObj):
 
         This property is read-only.
         """
-        from ansys.edb.core.inner import factory
-
-        objs = self.__stub.GetMembers(self.msg).items
-        return [factory.create_conn_obj(co) for co in objs]
+        return query_lyt_object_collection(
+            self,
+            LayoutObjType.INVALID_LAYOUT_OBJ,
+            self.__stub.GetMembers,
+            self.__stub.StreamMembers,
+            False,
+        )

{ansys_edb_core-0.2.0.dev2 → ansys_edb_core-0.2.0.dev4}/src/ansys/edb/core/hierarchy/pin_group.py

@@ -3,9 +3,9 @@
 from ansys.edb.core.edb_defs import LayoutObjType
 from ansys.edb.core.inner import messages
 from ansys.edb.core.inner.conn_obj import ConnObj
-from ansys.edb.core.primitive.primitive import PadstackInstance
+from ansys.edb.core.primitive.padstack_instance import PadstackInstance
 from ansys.edb.core.session import PinGroupServiceStub, StubAccessor, StubType
-from ansys.edb.core.terminal.terminals import PinGroupTerminal
+from ansys.edb.core.terminal.pin_group_terminal import PinGroupTerminal
 
 
 class PinGroup(ConnObj):

{ansys_edb_core-0.2.0.dev2 → ansys_edb_core-0.2.0.dev4}/src/ansys/edb/core/hierarchy/spice_model.py

@@ -1,6 +1,6 @@
 """SPICE Model."""
 from ansys.edb.core.hierarchy.model import Model
-from ansys.edb.core.inner import messages
+from ansys.edb.core.inner import messages, parser
 from ansys.edb.core.session import SpiceModelServiceStub, StubAccessor, StubType
 
 
@@ -78,3 +78,10 @@ class SPICEModel(Model):
             Terminal name.
         """
         self.__stub.RemoveTerminalPinPair(messages.string_property_message(self, terminal))
+
+    @property
+    @parser.to_string_dict
+    def terminal_pin_pairs(self):
+        """:obj:`dict` of {:obj:`str` : :obj:`str`}: A dictionary showing the mapping of terminals in the layout to \
+        pins in the spice model by name."""
+        return self.__stub.GetTerminalPinPairs(self.msg)

{ansys_edb_core-0.2.0.dev2 → ansys_edb_core-0.2.0.dev4}/src/ansys/edb/core/hierarchy/structure3d.py

@@ -2,8 +2,8 @@
 
 from enum import Enum
 
-import ansys.api.edb.v1.structure3d_pb2 as structure3d_pb2
-from ansys.api.edb.v1.structure3d_pb2_grpc import Structure3DServiceStub
+import ansys.api.edb.v1.structure_3d_pb2 as structure3d_pb2
+from ansys.api.edb.v1.structure_3d_pb2_grpc import Structure3DServiceStub
 
 from ansys.edb.core.hierarchy.group import Group
 from ansys.edb.core.inner import messages

{ansys_edb_core-0.2.0.dev2 → ansys_edb_core-0.2.0.dev4}/src/ansys/edb/core/inner/base.py

@@ -23,6 +23,8 @@ class ObjBase:
 
         This property is read-only.
         """
+        if (buffer := get_buffer()) is not None:
+            buffer.flush()
         return self.id == 0
 
     @property
@@ -46,7 +48,7 @@ class ObjBase:
         if io_mgr.is_enabled:
             if self._is_future:
                 msg.is_future = True
-            get_io_manager().active_request_edb_obj_msg_mgr.add_active_request_edb_obj_msg(msg)
+            io_mgr.active_request_edb_obj_msg_mgr.add_active_request_edb_obj_msg(msg)
         return msg
 
     @msg.setter

{ansys_edb_core-0.2.0.dev2 → ansys_edb_core-0.2.0.dev4}/src/ansys/edb/core/inner/conn_obj.py

@@ -3,6 +3,7 @@ from ansys.api.edb.v1 import connectable_pb2
 
 from ansys.edb.core.edb_defs import LayoutObjType
 from ansys.edb.core.inner import layout_obj, messages
+from ansys.edb.core.inner.factory import create_lyt_obj
 from ansys.edb.core.layout import mcad_model as mm
 from ansys.edb.core.session import ConnectableServiceStub, StubAccessor, StubType
 
@@ -48,6 +49,15 @@ class ConnObj(layout_obj.LayoutObj):
             return client_obj
         return cls(None)
 
+    def cast(self):
+        """Cast the ConnObj object to the correct concrete type.
+
+        Returns
+        -------
+        .ConnObj
+        """
+        return create_lyt_obj(self.msg, self.obj_type)
+
     @property
     def obj_type(self):
         """:class:`LayoutObjType <ansys.edb.core.edb_defs.LayoutObjType>`: Layout object type.

ansys_edb_core-0.2.0.dev4/src/ansys/edb/core/inner/factory.py

@@ -0,0 +1,161 @@
+"""This module allows for the creating of objects while avoid circular imports."""
+
+from ansys.edb.core.edb_defs import LayoutObjType
+
+_type_creator_params_dict = None
+_primitive_type_creator_params_dict = None
+_terminal_type_creator_params_dict = None
+
+
+class _CreatorParams:
+    def __init__(self, obj_type, do_cast=False):
+        self.obj_type = obj_type
+        self.do_cast = do_cast
+
+
+def _initialize_type_creator_params_dict():
+    global _type_creator_params_dict
+
+    from ansys.edb.core.hierarchy.cell_instance import CellInstance
+    from ansys.edb.core.hierarchy.group import Group
+    from ansys.edb.core.hierarchy.pin_group import PinGroup
+    from ansys.edb.core.inner.conn_obj import ConnObj
+    from ansys.edb.core.layout.voltage_regulator import VoltageRegulator
+    from ansys.edb.core.net.differential_pair import DifferentialPair
+    from ansys.edb.core.net.extended_net import ExtendedNet
+    from ansys.edb.core.net.net import Net
+    from ansys.edb.core.net.net_class import NetClass
+    from ansys.edb.core.primitive.padstack_instance import PadstackInstance
+    from ansys.edb.core.primitive.primitive import Primitive
+    from ansys.edb.core.terminal.terminal import Terminal
+    from ansys.edb.core.terminal.terminal_instance import TerminalInstance
+
+    _type_creator_params_dict = {
+        LayoutObjType.PRIMITIVE: _CreatorParams(Primitive, True),
+        LayoutObjType.PADSTACK_INSTANCE: _CreatorParams(PadstackInstance),
+        LayoutObjType.TERMINAL: _CreatorParams(Terminal, True),
+        LayoutObjType.TERMINAL_INSTANCE: _CreatorParams(TerminalInstance),
+        LayoutObjType.CELL_INSTANCE: _CreatorParams(CellInstance),
+        LayoutObjType.GROUP: _CreatorParams(Group, True),
+        LayoutObjType.PIN_GROUP: _CreatorParams(PinGroup),
+        LayoutObjType.VOLTAGE_REGULATOR: _CreatorParams(VoltageRegulator),
+        LayoutObjType.NET_CLASS: _CreatorParams(NetClass),
+        LayoutObjType.EXTENDED_NET: _CreatorParams(ExtendedNet),
+        LayoutObjType.DIFFERENTIAL_PAIR: _CreatorParams(DifferentialPair),
+        LayoutObjType.NET: _CreatorParams(Net),
+        LayoutObjType.INVALID_LAYOUT_OBJ: _CreatorParams(ConnObj, True),
+    }
+    return _type_creator_params_dict
+
+
+def _initialize_primitive_type_creator_params_dict():
+    global _primitive_type_creator_params_dict
+
+    from ansys.edb.core.primitive.board_bend_def import BoardBendDef
+    from ansys.edb.core.primitive.bondwire import Bondwire
+    from ansys.edb.core.primitive.circle import Circle
+    from ansys.edb.core.primitive.path import Path
+    from ansys.edb.core.primitive.polygon import Polygon
+    from ansys.edb.core.primitive.primitive import PrimitiveType
+    from ansys.edb.core.primitive.primitive_instance_collection import PrimitiveInstanceCollection
+    from ansys.edb.core.primitive.rectangle import Rectangle
+    from ansys.edb.core.primitive.text import Text
+
+    _primitive_type_creator_params_dict = {
+        PrimitiveType.BOARD_BEND: _CreatorParams(BoardBendDef),
+        PrimitiveType.BONDWIRE: _CreatorParams(Bondwire),
+        PrimitiveType.CIRCLE: _CreatorParams(Circle),
+        PrimitiveType.PATH: _CreatorParams(Path),
+        PrimitiveType.POLYGON: _CreatorParams(Polygon),
+        PrimitiveType.RECTANGLE: _CreatorParams(Rectangle),
+        PrimitiveType.TEXT: _CreatorParams(Text),
+        PrimitiveType.PRIM_INST_COLLECTION: _CreatorParams(PrimitiveInstanceCollection),
+    }
+    return _primitive_type_creator_params_dict
+
+
+def _initialize_terminal_type_creator_params_dict():
+    global _terminal_type_creator_params_dict
+
+    from ansys.edb.core.terminal.bundle_terminal import BundleTerminal
+    from ansys.edb.core.terminal.edge_terminal import EdgeTerminal
+    from ansys.edb.core.terminal.padstack_instance_terminal import PadstackInstanceTerminal
+    from ansys.edb.core.terminal.pin_group_terminal import PinGroupTerminal
+    from ansys.edb.core.terminal.point_terminal import PointTerminal
+    from ansys.edb.core.terminal.terminal import TerminalType
+    from ansys.edb.core.terminal.terminal_instance_terminal import TerminalInstanceTerminal
+
+    _terminal_type_creator_params_dict = {
+        TerminalType.BUNDLE: _CreatorParams(BundleTerminal),
+        TerminalType.EDGE: _CreatorParams(EdgeTerminal),
+        TerminalType.PADSTACK_INST: _CreatorParams(PadstackInstanceTerminal),
+        TerminalType.PIN_GROUP: _CreatorParams(PinGroupTerminal),
+        TerminalType.POINT: _CreatorParams(PointTerminal),
+        TerminalType.TERM_INST: _CreatorParams(TerminalInstanceTerminal),
+    }
+    return _terminal_type_creator_params_dict
+
+
+def _initialize_and_get_creator_dict(initializer, creator_dict):
+    return initializer() if creator_dict is None else creator_dict
+
+
+def _get_type_creator_dict():
+    return _initialize_and_get_creator_dict(
+        _initialize_type_creator_params_dict, _type_creator_params_dict
+    )
+
+
+def _get_primitive_type_creator_dict():
+    return _initialize_and_get_creator_dict(
+        _initialize_primitive_type_creator_params_dict, _primitive_type_creator_params_dict
+    )
+
+
+def _get_terminal_type_creator_dict():
+    return _initialize_and_get_creator_dict(
+        _initialize_terminal_type_creator_params_dict, _terminal_type_creator_params_dict
+    )
+
+
+def create_obj(msg, obj_type, do_cast):
+    """Create an object from the provided message of the provided type."""
+    obj = obj_type(msg)
+    if do_cast:
+        obj = obj.cast()
+    return obj
+
+
+def create_obj_from_creator_dict(creator_dict, msg, obj_type):
+    """Create an object from the provided message of the type corresponding to the provided object type."""
+    params = creator_dict[obj_type]
+    return create_obj(msg, params.obj_type, params.do_cast)
+
+
+def create_lyt_obj(msg, lyt_obj_type):
+    """Create a layout object from the provided message of the type corresponding to the provided layout object type."""
+    return create_obj_from_creator_dict(_get_type_creator_dict(), msg, lyt_obj_type)
+
+
+def create_primitive(msg, prim_type):
+    """Create a primitive from the provided message of the type corresponding to the provided primitive type."""
+    return create_obj_from_creator_dict(_get_primitive_type_creator_dict(), msg, prim_type)
+
+
+def create_terminal(msg, term_type):
+    """Create a terminal from the provided message of the type corresponding to the provided terminal type."""
+    return create_obj_from_creator_dict(_get_terminal_type_creator_dict(), msg, term_type)
+
+
+def create_conn_obj(msg):
+    """Create a connection object of its derived type based on its layout object type.
+
+    Parameters
+    ----------
+    msg : ansys.api.edb.v1.edb_messages_pb2.EDBObjMessage
+
+    Returns
+    -------
+    ansys.edb.core.inner.ConnObj
+    """
+    return create_lyt_obj(msg, LayoutObjType.INVALID_LAYOUT_OBJ)