FEAT: VSin, ISin Sources added to Maxwell Circuit Primitives

_unittest/test_21_Circuit.py

@@ -985,3 +985,10 @@ def test_51_import_asc(self):
         self.aedtapp.insert_design("ASC")
         asc_file = os.path.join(local_path, "example_models", test_subfolder, "butter.asc")
         assert self.aedtapp.create_schematic_from_asc_file(asc_file)
+
+    def test_52_create_page(self):
+        self.aedtapp.create_page()
+        assert self.aedtapp.GetNumPages() == 2
+
+    def test_53_get_num_pages(self):
+        assert type(self.aedtapp.GetNumPages()) == int

_unittest/test_35_MaxwellCircuit.py

@@ -114,3 +114,11 @@ def test_08_import_netlist(self):
         self.aedtapp.insert_design("SchematicImport")
         self.aedtapp.modeler.schematic.limits_mils = 5000
         assert self.aedtapp.create_schematic_from_netlist(self.netlist_file1)
+
+    def test_09_create_voltage_source(self):
+        id = self.aedtapp.modeler.schematic.create_vsin(name="voltage_source", value=3.14, angle=90)
+        assert id.parameters["Va"] == "3.14"
+
+    def test_10_create_current_source(self):
+        id = self.aedtapp.modeler.schematic.create_isin(name="current_source", value=2.72, angle=90)
+        assert id.parameters["Ia"] == "2.72"

src/ansys/aedt/core/modeler/circuits/primitives_circuit.py

@@ -1262,6 +1262,55 @@
         except Exception:
             return False
 
+    def create_page(self, name):
+        """Add a new circuit schematic page.
+
+        Parameters
+        ----------
+        name : str, int or float
+            Name to be used when creating the new circuit schematic.
+        Returns
+        -------
+        bool
+            ``True`` when successful, ``False`` when failed.
+        References
+        ----------
+        >>> oeditor.CreatePage ()
+        Examples
+        --------
+        >>>from ansys.aedt.core import MaxwellCircuit
+        >>>app=MaxwellCircuit ()
+        >>>schematic=app.modeler.schematic
+        >>>schematic.create_page (name="NewPageName")
+
+        """
+        if not isinstance(name, (str, int, float)):
+            self.logger.error("Argument 'name' to 'create_page' is not of data type String, Integer or Float.")
+            return False
+        self.oeditor.CreatePage(name)
+        return True
+
+    def get_num_pages(self):
+        """Gets the number of circuit schematic pages.
+
+        Returns
+        -------
+        int
+            The number of pages in the circuit schematic.
+        References
+        ----------
+        >>> oeditor.GetNumPages ()
+        Examples
+        --------
+        >>>from ansys.aedt.core import MaxwellCircuit
+        >>>app=MaxwellCircuit ()
+        >>>schematic=app.modeler.schematic
+        >>>schematic.get_num_pages ()
+
+        """
+        pages = self.oeditor.GetNumPages()
+        return pages
+
 
 class ComponentInfo(object):
     """Manages Circuit Catalog info."""

src/ansys/aedt/core/modeler/circuits/primitives_maxwell_circuit.py

@@ -85,8 +85,8 @@
 
         Parameters
         ----------
-        name : str, optional
-            Name of the resistor. The default is ``None``.
+        name : str, int, float or optional
+            Name of the resistor. The default is ``None`` which adds a resistor without a name.
         value : float, optional
             Value for the resistor. The default is ``50``.
         location : list of float, optional
@@ -109,27 +109,27 @@
         if location == None:
             location = []
 
-        id = self.create_component(
+        component = self.create_component(
             name,
             component_library="Passive Elements",
             component_name="Res",
             location=location,
             angle=angle,
             use_instance_id_netlist=use_instance_id_netlist,
         )
-
-        id.set_property("R", value)
-        id.set_property("Name", name)
-        return id
+        component.set_property("R", value)
+        if isinstance(name, (str, int, float)):
+            component.set_property("Name", name)
+        return component
 
     @pyaedt_function_handler(compname="name")
     def create_inductor(self, name=None, value=50, location=None, angle=0, use_instance_id_netlist=False):
         """Create an inductor.
 
         Parameters
         ----------
-        name : str, optional
-            Name of the inductor. The default is ``None``.
+        name : str, int, float or optional
+            Name of the inductor. The default is ``None`` which adds an inductor without a name.
         value : float, optional
             Value for the inductor. The default is ``50``.
         location : list of float, optional
@@ -152,7 +152,7 @@
         if location == None:
             location = []
 
-        id = self.create_component(
+        component = self.create_component(
             name,
             component_library="Passive Elements",
             component_name="Ind",
@@ -161,18 +161,19 @@
             use_instance_id_netlist=use_instance_id_netlist,
         )
 
-        id.set_property("L", value)
-        id.set_property("Name", name)
-        return id
+        component.set_property("L", value)
+        if isinstance(name, (str, int, float)):
+            component.set_property("Name", name)
+        return component
 
     @pyaedt_function_handler(compname="name")
     def create_capacitor(self, name=None, value=50, location=None, angle=0, use_instance_id_netlist=False):
         """Create a capacitor.
 
         Parameters
         ----------
-        name : str, optional
-            Name of the capacitor. The default is ``None``.
+        name : str, int, float or optional
+            Name of the capacitor. The default is ``None`` which adds a capacitor without a name.
         value : float, optional
             Value for the capacitor. The default is ``50``.
         location : list of float, optional
@@ -194,7 +195,7 @@
         """
         if location is None:
             location = []
-        id = self.create_component(
+        component = self.create_component(
             name,
             component_library="Passive Elements",
             component_name="Cap",
@@ -203,18 +204,19 @@
             use_instance_id_netlist=use_instance_id_netlist,
         )
 
-        id.set_property("C", value)
-        id.set_property("Name", name)
-        return id
+        component.set_property("C", value)
+        if isinstance(name, (str, int, float)):
+            component.set_property("Name", name)
+        return component
 
     @pyaedt_function_handler(compname="name")
     def create_diode(self, name=None, location=None, angle=0, use_instance_id_netlist=False):
         """Create a diode.
 
         Parameters
         ----------
-        name : str, optional
-            Name of the diode. The default is ``None``.
+        name : str, int, float or optional
+            Name of the diode. The default is ``None`` which adds a diode without a name.
         location : list of float, optional
             Position on the X axis and Y axis. The default is ``None``.
         angle : float, optional
@@ -235,7 +237,7 @@
         if location is None:
             location = []
 
-        id = self.create_component(
+        component = self.create_component(
             name,
             component_library="Passive Elements",
             component_name="DIODE",
@@ -244,17 +246,18 @@
             use_instance_id_netlist=use_instance_id_netlist,
         )
 
-        id.set_property("Name", name)
-        return id
+        if isinstance(name, (str, int, float)):
+            component.set_property("Name", name)
+        return component
 
     @pyaedt_function_handler(compname="name")
     def create_winding(self, name=None, location=None, angle=0, use_instance_id_netlist=False):
         """Create a winding linked to a Maxwell design.
 
         Parameters
         ----------
-        name : str, optional
-            Name of the winding. The default is ``None``.
+        name : str, int, float or optional
+            Name of the winding. The default is ``None`` which adds a winding without a name.
         location : list of float, optional
             Position on the X axis and Y axis.
         angle : float, optional
@@ -274,13 +277,98 @@
         """
         if location is None:
             location = []
-        id = self.create_component(
+        component = self.create_component(
             name,
             component_library="Dedicated Elements",
             component_name="Winding",
             location=location,
             angle=angle,
             use_instance_id_netlist=use_instance_id_netlist,
         )
-        id.set_property("Name", name)
-        return id
+        if isinstance(name, (str, int, float)):
+            component.set_property("Name", name)
+        return component
+
+    def create_i_sin(self, name=None, value=1, location=None, angle=0, use_instance_id_netlist=False):
+        """Create a sinusoidal current source.
+
+        Parameters
+        ----------
+        name : str, int, float or optional
+            Name of the current source. The default is ``None`` which adds a current source without a name.
+        value : float, optional
+            Value for the amplitude of current. The default is ``1``.
+        location : list of float, optional
+            Position on the X axis and Y axis.
+        angle : float, optional
+            Angle of rotation in degrees. The default is ``0``.
+        use_instance_id_netlist : bool, optional
+            Whether to use the instance ID in the net list or not. The default is ``False``.
+
+        Returns
+        -------
+        :class:`ansys.aedt.core.modeler.cad.object_3dcircuit.CircuitComponent`
+            Circuit Component Object.
+
+        References
+        ----------
+
+        >>> oEditor.CreateComponent
+        """
+        if location is None:
+            location = []
+        component = self.create_component(
+            name,
+            component_library="Sources",
+            component_name="ISin",
+            location=location,
+            angle=angle,
+            use_instance_id_netlist=use_instance_id_netlist,
+        )
+
+        component.set_property("Ia", value)
+        if isinstance(name, (str, int, float)):
+            component.set_property("Name", name)
+        return component
+
+    def create_v_sin(self, name=None, value=1, location=None, angle=0, use_instance_id_netlist=False):
+        """Create a sinusoidal voltage source.
+
+        Parameters
+        ----------
+        name : str, int, float or optional
+            Name of the voltage source. The default is ``None`` which adds a voltage source without a name.
+        value : float, optional
+            Value for the amplitude of voltage. The default is ``1``.
+        location : list of float, optional
+            Position on the X axis and Y axis.
+        angle : float, optional
+            Angle of rotation in degrees. The default is ``0``.
+        use_instance_id_netlist : bool, optional
+            Whether to use the instance ID in the net list or not. The default is ``False``.
+
+        Returns
+        -------
+        :class:`ansys.aedt.core.modeler.cad.object_3dcircuit.CircuitComponent`
+            Circuit Component Object.
+
+        References
+        ----------
+
+        >>> oEditor.CreateComponent
+        """
+        if location is None:
+            location = []
+        component = self.create_component(
+            name,
+            component_library="Sources",
+            component_name="VSin",
+            location=location,
+            angle=angle,
+            use_instance_id_netlist=use_instance_id_netlist,
+        )
+
+        component.set_property("Va", value)
+        if isinstance(name, (str, int, float)):
+            component.set_property("Name", name)
+        return component