FEAT: Move It extension (#5966)

Co-authored-by: pyansys-ci-bot <92810346+pyansys-ci-bot@users.noreply.github.com>

Author: Samuelopez-ansys

doc/changelog.d/5966.added.md

@@ -0,0 +1 @@
+Move It extension

doc/source/User_guide/extensions.rst

@@ -153,6 +153,14 @@ They are small automated workflows with a simple GUI.
             Generate object and surface conforming point clouds.
 
 
+   .. grid-item-card:: Move it
+            :link: pyaedt_extensions_doc/hfss/move_it
+            :link-type: doc
+            :margin: 2 2 0 0
+
+            From a line generate the parameters needed to simulate a trajectory.
+
+
 Icepak extensions
 ~~~~~~~~~~~~~~~~~
 

doc/source/User_guide/pyaedt_extensions_doc/hfss/index.rst

@@ -32,3 +32,11 @@ HFSS extensions
             :margin: 2 2 0 0
 
             Generate and import point list from a geometry in HFSS.
+
+
+   .. grid-item-card:: Move it
+            :link: move_it
+            :link-type: doc
+            :margin: 2 2 0 0
+
+            From a line generate the parameters needed to simulate a trajectory.

doc/source/User_guide/pyaedt_extensions_doc/hfss/move_it.rst

@@ -0,0 +1,20 @@
+Move it
+=======
+
+With this extension, you can generate from a line a parametrize design to simulate a trajectory.
+
+You can access the extension from the icon created on the **Automation** tab using the Extension Manager.
+
+The following image shows the extension user interface:
+
+.. image:: ../../../_static/extensions/move_it_ui.png
+  :width: 800
+  :alt: Move it UI
+
+You can also launch the extension user interface from the terminal. An example can be found here:
+
+
+.. toctree::
+   :maxdepth: 2
+
+   ../commandline

doc/source/_static/extensions/move_it_ui.png

@@ -3605,13 +3605,15 @@ def imprint_vector_projection(
         return self._imprint_projection(assignment, keep_originals, False, vector_points, distance)
 
     @pyaedt_function_handler(theList="assignment")
-    def purge_history(self, assignment):
+    def purge_history(self, assignment, non_model=False):
         """Purge history objects from object names.
 
         Parameters
         ----------
         assignment : list
             List of object names to purge.
+        non_model : bool, optional
+            Convert new parts to non-model objects. The default is ``False``.
 
         Returns
         -------
@@ -3621,10 +3623,21 @@ def purge_history(self, assignment):
         References
         ----------
         >>> oEditor.PurgeHistory
+
+        Examples
+        --------
+        >>> from ansys.aedt.core import Hfss
+        >>> app = Hfss()
+        >>> cylinder1 = hfss.modeler.create_cylinder(orientation="X", origin=[5, 0, 0], radius=1, height=20)
+        >>> aedtapp.modeler.purge_history(assignment=cylinder1)
         """
         szList = self.convert_to_selections(assignment)
 
-        vArg1 = ["NAME:Selections", "Selections:=", szList, "NewPartsModelFlag:=", "Model"]
+        new_parts = "NonModel"
+        if not non_model:
+            new_parts = "Model"
+
+        vArg1 = ["NAME:Selections", "Selections:=", szList, "NewPartsModelFlag:=", new_parts]
 
         self.oeditor.PurgeHistory(vArg1)
         return True
@@ -4269,13 +4282,15 @@ def create_object_list(self, assignment, name=None):
             return False
 
     @pyaedt_function_handler(objectname="assignment")
-    def generate_object_history(self, assignment):
+    def generate_object_history(self, assignment, non_model=False):
         """Generate history for the object.
 
         Parameters
         ----------
         assignment : str
             Name of the history object.
+        non_model : bool, optional
+            Convert new parts to non-model objects. The default is ``False``.
 
         Returns
         -------
@@ -4285,10 +4300,23 @@ def generate_object_history(self, assignment):
         References
         ----------
         >>> oEditor.GenerateHistory
+
+        Examples
+        --------
+        >>> from ansys.aedt.core import Hfss
+        >>> app = Hfss()
+        >>> cylinder1 = hfss.modeler.create_cylinder(orientation="X", origin=[5, 0, 0], radius=1, height=20)
+        >>> aedtapp.modeler.purge_history(assignment=cylinder1)
+        >>> aedtapp.modeler.generate_object_history(assignment=cylinder1)
         """
         assignment = self.convert_to_selections(assignment)
+
+        new_parts = "NonModel"
+        if not non_model:
+            new_parts = "Model"
+
         self.oeditor.GenerateHistory(
-            ["NAME:Selections", "Selections:=", assignment, "NewPartsModelFlag:=", "Model", "UseCurrentCS:=", True]
+            ["NAME:Selections", "Selections:=", assignment, "NewPartsModelFlag:=", new_parts, "UseCurrentCS:=", True]
         )
         self.cleanup_objects()
         return True