ansys-pyensight-core 0.7.0__py3-none-any.whl → 0.7.2__py3-none-any.whl

ansys/pyensight/core/listobj.py

@@ -5,10 +5,9 @@ Emulation of the EnSight ensobjlist class
 """
 from collections.abc import Iterable
 import fnmatch
-from typing import Any, List, Optional, TypeVar, no_type_check, overload
+from typing import Any, List, Optional, SupportsIndex, TypeVar, no_type_check, overload
 
 from ansys.pyensight.core.ensobj import ENSOBJ
-from typing_extensions import SupportsIndex
 
 T = TypeVar("T")
 

ansys/pyensight/core/renderable.py

@@ -525,15 +525,11 @@ class RenderableWebGL(Renderable):
 
 
 class RenderableVNC(Renderable):
-    """Generates a URL that can be used to connect to the EnSight VNC remote image renderer."""
+    """Generates an ansys-nexus-viewer component that can be used to connect to the EnSight VNC remote image renderer."""
 
     def __init__(self, *args, **kwargs) -> None:
         super().__init__(*args, **kwargs)
-        self._query_params = {
-            "autoconnect": "true",
-            "host": self._session.html_hostname,
-            "port": self._session.ws_port,
-        }
+        self._generate_url()
         self._rendertype = "remote"
         self.update()
 
@@ -544,10 +540,31 @@ class RenderableVNC(Renderable):
         iframe reference.
 
         """
-        url = f"{self._http_protocol}://{self._session.html_hostname}:{self._session.html_port}"
-        url += "/ansys/nexus/novnc/vnc_envision.html"
-        url += self._get_query_parameters_str(self._query_params)
-        self._url = url
+        optional_query = self._get_query_parameters_str()
+
+        html = f"<script src='/ansys/nexus/viewer-loader.js{optional_query}'></script>\n"
+        rest_uri = (
+            f"{self._http_protocol}://{self._session.html_hostname}:{self._session.html_port}"
+        )
+        ws_uri = f"{self._http_protocol}://{self._session.html_hostname}:{self._session.ws_port}"
+
+        query_args = ""
+        if self._using_proxy and optional_query:
+            query_args = f', "extra_query_args":"{optional_query[1:]}"'
+
+        attributes = ' renderer="envnc"'
+        attributes += ' ui="simple"'
+        attributes += ' active="true"'
+        attributes += (
+            " renderer_options='"
+            + f'{{ "ws":"{ws_uri}", "http":"{rest_uri}", "security_token":"{self._session.secret_key}", "connect_to_running_ens":true {query_args} }}'
+            + "'"
+        )
+
+        html += f"<ansys-nexus-viewer {attributes}></ansys-nexus-viewer>\n"
+
+        # refresh the remote HTML
+        self._save_remote_html_page(html)
         super().update()
 
 

ansys/pyensight/core/session.py

@@ -1510,6 +1510,13 @@ class Session:
                 tail = s.find(", cached:yes")
             if tail == -1:
                 break
+            # Subtype (PartType:, AnnotType:, ToolType:)
+            subtype = None
+            for name in ("PartType:", "AnnotType:", "ToolType:"):
+                location = s.find(name)
+                if (location != -1) and (location > id):
+                    subtype = int(s[location + len(name) :].split(",")[0])
+                    break
             # isolate the block to replace
             prefix = s[:start]
             suffix = s[tail + tail_len :]
@@ -1526,8 +1533,11 @@ class Session:
             else:
                 subclass_info = ""
                 if attr_id is not None:
-                    # if a "subclass" case and no subclass attrid value, ask for it...
-                    if classname_lookup is not None:
+                    if subtype is not None:
+                        # the 2024 R2 interface includes the subtype
+                        subclass_info = f",attr_id={attr_id}, attr_value={subtype}"
+                    elif classname_lookup is not None:
+                        # if a "subclass" case and no subclass attrid value, ask for it...
                         remote_name = self.remote_obj(objid)
                         cmd = f"{remote_name}.getattr({attr_id})"
                         attr_value = self.cmd(cmd)

ansys/pyensight/core/utils/parts.py

@@ -15,26 +15,132 @@ Example for selecting all 3D parts:
 >>> parts.select_by_dimension(3)
 
 """
-
-from typing import TYPE_CHECKING, Dict, Optional, Union
+from types import ModuleType
+from typing import TYPE_CHECKING, Any, Dict, List, Optional, Tuple, Union
 
 try:
     import ensight
-    from ensight.objs import ensobjlist  # type: ignore
+    from ensight.objs import ens_emitterobj, ensobjlist  # type: ignore
 except ImportError:
+    from ansys.api.pyensight.ens_emitterobj import ens_emitterobj
     from ansys.pyensight.core.listobj import ensobjlist
 
 if TYPE_CHECKING:
     try:
-        from ensight.objs import ENS_PART  # type: ignore
+        from ensight.objs import ENS_PART, ENS_VAR  # type: ignore
     except ImportError:
         from ansys.api.pyensight import ensight_api
         from ansys.api.pyensight.ens_part import ENS_PART
+        from ansys.api.pyensight.ens_var import ENS_VAR
+
+
+def convert_part(
+    _ensight: Union["ensight_api.ensight", "ensight"], part: Union[str, int, "ENS_PART"]
+):
+    if isinstance(part, str):
+        return _ensight.objs.core.PARTS[part][0].PARTNUMBER
+    elif isinstance(part, int):
+        return part
+    elif hasattr(part, "PARTNUMBER"):
+        return part.PARTNUMBER
+
+
+def convert_variable(
+    _ensight: Union["ensight_api.ensight", "ensight"], var: Union[str, int, "ENS_VAR"]
+):
+    if isinstance(var, str):
+        return _ensight.objs.core.VARIABLES[var][0].ID
+    elif isinstance(var, int):
+        return var
+    elif hasattr(var, "ID"):
+        return var.ID
 
 
 class Parts:
     """Controls the parts in the current EnSight ``Session`` instance."""
 
+    class _EnSEmitterPoint(ens_emitterobj):
+        def __init__(
+            self,
+            ensight: "ensight",
+            point1: Optional[List[float]] = [0, 0, 0],
+        ):
+            if not isinstance(ensight, ModuleType):
+                raise RuntimeError(
+                    "The class cannot be used directly in PyEnSight. It should not be used directly even in EnSight"
+                )
+            super().__init__(ensight.objs.EMIT_CURSOR)
+            self.ensight = ensight
+            self.ensight.view_transf.cursor(*point1)
+            self.CENTROID = point1
+
+    class _EnSEmitterGrid(ens_emitterobj):
+        def __init__(
+            self,
+            ensight: "ensight",
+            point1: Optional[List[float]] = [0, 0, 0],
+            point2: Optional[List[float]] = [0, 0, 0],
+            point3: Optional[List[float]] = [0, 0, 0],
+            point4: Optional[List[float]] = [0, 0, 0],
+            num_points_x: Optional[int] = 25,
+            num_points_y: Optional[int] = 25,
+        ):
+            if not isinstance(ensight, ModuleType):
+                raise RuntimeError(
+                    "The class cannot be used directly in PyEnSight. It should not be used directly even in EnSight"
+                )
+            super().__init__(ensight.objs.EMIT_PLANE)
+            self.ensight = ensight
+            self.ensight.view_transf.plane(1, *point1)
+            self.ensight.view_transf.plane(2, *point2)
+            self.ensight.view_transf.plane(3, *point3)
+            self.POINT1 = point1
+            self.POINT2 = point2
+            self.POINT3 = point3
+            self.POINT4 = point4
+            self.NUM_POINTS_X = num_points_x
+            self.NUM_POINTS_Y = num_points_y
+
+    class _EnSEmitterLine(ens_emitterobj):
+        def __init__(
+            self,
+            ensight: "ensight",
+            point1: Optional[List[float]] = [0, 0, 0],
+            point2: Optional[List[float]] = [0, 0, 0],
+            num_points: Optional[int] = 100,
+        ):
+            if not isinstance(ensight, ModuleType):
+                raise RuntimeError(
+                    "The class cannot be used directly in PyEnSight. It should not be used directly even in EnSight"
+                )
+            super().__init__(ensight.objs.EMIT_LINE)
+            self.ensight = ensight
+            self.ensight.view_transf.line(1, *point1)
+            self.ensight.view_transf.line(2, *point2)
+            self.POINT1 = point1
+            self.POINT2 = point2
+            self.NUM_POINTS = num_points
+
+    class _EnSEmitterPart(ens_emitterobj):
+        def __init__(
+            self,
+            ensight: "ensight",
+            part: Optional[Any] = None,
+            part_kind: Optional[Any] = 0,
+            num_points: Optional[int] = 100,
+        ):
+            if not isinstance(ensight, ModuleType):
+                raise RuntimeError(
+                    "The class cannot be used directly in PyEnSight. It should not be used directly even in EnSight"
+                )
+            super().__init__(ensight.objs.EMIT_PART)
+            self.ensight = ensight
+            if not part:
+                raise RuntimeError("part is a required input")
+            self.PART = convert_part(self.ensight, part)
+            self.NUM_POINTS = num_points
+            self.DISTRIB_TYPE = part_kind
+
     def __init__(self, ensight: Union["ensight_api.ensight", "ensight"]):
         self.ensight = ensight
 
@@ -122,3 +228,673 @@ class Parts:
         if found:
             found.set_attr("SELECTED", True)
         return found
+
+    _EMIT_POINT: int = 0
+    _EMIT_LINE: int = 1
+    _EMIT_PLANE: int = 2
+    _EMIT_PART: int = 3
+    PT_POS_TIME: str = "+"
+    PT_NEG_TIME: str = "-"
+    PT_POS_NEG_TIME: str = "+/-"
+    PART_EMIT_FROM_NODES: int = 0
+    PART_EMIT_FROM_AREA: int = 1
+
+    def _create_emitters(
+        self,
+        emitter_type: int,
+        points: Optional[List[List[float]]] = None,
+        point1: Optional[List[float]] = None,
+        point2: Optional[List[float]] = None,
+        point3: Optional[List[float]] = None,
+        parts: Optional[List["ENS_PART"]] = None,
+        part_distribution_type: Optional[int] = 0,
+        num_points: Optional[int] = 100,
+        num_points_x: Optional[int] = 25,
+        num_points_y: Optional[int] = 25,
+    ) -> List[Any]:
+        """Private routine to create emitter objects"""
+        new_emitters: List[Any] = []
+        if emitter_type == self._EMIT_POINT:
+            if not points:
+                raise RuntimeError("list of points needed if particle trace emitted from points")
+            for p in points:
+                if isinstance(self.ensight, ModuleType):
+                    new_emitters.append(self._EnSEmitterPoint(self.ensight, point1=p))
+                else:
+                    new_emitters.append(
+                        f"ensight.utils.parts._EnSEmitterPoint(ensight, point1={p})"
+                    )
+        elif emitter_type == self._EMIT_LINE:
+            if not any([point1, point2]):
+                raise RuntimeError("point1 and point2 needed if particle trace emitted from line")
+            if isinstance(self.ensight, ModuleType):
+                new_emitters.append(
+                    self._EnSEmitterLine(
+                        self.ensight, point1=point1, point2=point2, num_points=num_points
+                    )
+                )
+            else:
+                new_emitters.append(
+                    f"ensight.utils.parts._EnSEmitterLine(ensight, point1={point1}, point2={point2}, num_points={num_points})"
+                )
+        elif emitter_type == self._EMIT_PLANE:
+            if not any([point1, point2, point3]):
+                raise RuntimeError(
+                    "point1, point2 and point3 needed if particle trace emitted from plane"
+                )
+            if isinstance(self.ensight, ModuleType):
+                new_emitters.append(
+                    self._EnSEmitterGrid(
+                        self.ensight,
+                        point1=point1,
+                        point2=point2,
+                        point3=point3,
+                        num_points_x=num_points_x,
+                        num_points_y=num_points_y,
+                    )
+                )
+            else:
+                new_emitters.append(
+                    f"ensight.utils.parts._EnSEmitterGrid(ensight, point1={point1}, point2={point2}, point3={point3}, num_points_x={num_points_x}, num_points_y={num_points_y})"
+                )
+        elif emitter_type == self._EMIT_PART:
+            if not parts:
+                raise RuntimeError("part and num_points needed if particle trace emitted from part")
+            for p in parts:
+                if isinstance(self.ensight, ModuleType):
+                    new_emitters.append(
+                        self._EnSEmitterPart(
+                            self.ensight,
+                            part=p,
+                            num_points=num_points,
+                            part_kind=part_distribution_type,
+                        )
+                    )
+                else:
+                    new_emitters.append(
+                        f"ensight.utils.parts._EnSEmitterPart(ensight, part={convert_part(self.ensight ,p)}, num_points={num_points}, part_kind={part_distribution_type})"
+                    )
+        else:
+            raise RuntimeError("No input provided to create the emitters for the particle trace")
+        return new_emitters
+
+    def _create_pathline_part(
+        self,
+        name: str,
+        variable: Union[str, int, "ENS_VAR"],
+        direction: str,
+        source_parts: List["ENS_PART"],
+        pathlines: Optional[bool] = False,
+        emit_time: Optional[float] = None,
+        total_time: Optional[float] = None,
+        delta_time: Optional[float] = None,
+    ) -> Tuple["ENS_PART", "ENS_PART"]:
+        """Private routine to create a pathline part object"""
+        direction_map = {
+            self.PT_POS_TIME: self.ensight.objs.enums.POS_TIME,
+            self.PT_NEG_TIME: self.ensight.objs.enums.NEG_TIME,
+            self.PT_POS_NEG_TIME: self.ensight.objs.enums.POS_NEG_TIME,
+        }
+        idx = self.ensight.objs.enums.PART_PARTICLE_TRACE
+        def_part = self.ensight.objs.core.DEFAULTPARTS[idx]
+        def_part.TYPE = self.ensight.objs.enums.STREAMLINE
+        if pathlines is True:
+            def_part.TYPE = self.ensight.objs.enums.PATHLINE
+        if total_time:
+            def_part.TOTALTIME = total_time
+        if delta_time:
+            def_part.DELTATIME = delta_time
+        if emit_time:
+            def_part.STARTTIME = emit_time
+        def_part.DESCRIPTION = name
+        def_part.VARIABLE = convert_variable(self.ensight, variable)
+        def_part.SURFACERESTRICTED = False
+        def_part.TRACEDIRECTION = direction_map.get(direction)
+        pathline_part = def_part.createpart(sources=source_parts, name=name)[0]
+        return pathline_part, def_part
+
+    def _add_emitters_to_pathline(
+        self, pathline_part: "ENS_PART", new_emitters: List[Any], palette: Optional[str] = None
+    ) -> "ENS_PART":
+        """Private utility to add emitters to an existing pathline part."""
+        if isinstance(self.ensight, ModuleType):
+            emitters = pathline_part.EMITTERS.copy()
+            emitters.extend(new_emitters)
+            pathline_part.EMITTERS = emitters
+        else:
+            self.ensight._session.cmd(
+                f"enscl.emitters=ensight.objs.wrap_id({pathline_part.objid}).EMITTERS.copy()",
+                do_eval=False,
+            )
+            text = "enscl.emitters.extend(["
+            for emitter in new_emitters:
+                text += emitter + ", "
+            text = text[:-2]
+            text += "])"
+            self.ensight._session.cmd(text, do_eval=False)
+            self.ensight._session.cmd(
+                f"ensight.objs.wrap_id({pathline_part.objid}).setattr('EMITTERS', enscl.emitters.copy())"
+            )
+            self.ensight._session.cmd("del enscl.emitters", do_eval=False)
+        if palette:
+            pathline_part.COLORBYPALETTE = palette
+        return pathline_part
+
+    def _cure_pathline_part(self, pathline_part: Union[str, int, "ENS_PART"]) -> "ENS_PART":
+        """Private utility to cure an input pathline part and convert it to an ``ENS_PART`"""
+        if isinstance(pathline_part, (str, int)):
+            temp = self.ensight.objs.core.PARTS[pathline_part]
+            if not temp:
+                raise RuntimeError("pathline_part input is not a valid part")
+            pathline_part = temp[0]
+        return pathline_part
+
+    def _prepare_particle_creation(
+        self,
+        direction: Optional[str] = None,
+        source_parts: Optional[List[Union[str, int, "ENS_PART"]]] = None,
+    ) -> Tuple[str, List["ENS_PART"]]:
+        """Private utility to set the direction if not provided, and to cure the list of source parts."""
+        if not direction:
+            direction = self.PT_POS_TIME
+        if source_parts:
+            converted_source_parts = [convert_part(self.ensight, p) for p in source_parts]
+        if not source_parts:
+            converted_source_parts = self.ensight.objs.core.selection(name="ENS_PART")
+        if not converted_source_parts:
+            raise RuntimeError("No part selected for particle trace generation")
+        return direction, converted_source_parts
+
+    def create_particle_trace_from_points(
+        self,
+        name: str,
+        variable: Union[str, int, "ENS_VAR"],
+        points: List[List[float]],
+        direction: Optional[str] = None,
+        pathlines: Optional[bool] = False,
+        source_parts: Optional[List[Union[str, int, "ENS_PART"]]] = None,
+        emit_time: Optional[float] = None,
+        total_time: Optional[float] = None,
+        delta_time: Optional[float] = None,
+    ) -> "ENS_PART":
+        """
+        Create a particle trace part from a list o points.
+        Returns the ``ENS_PART`` generated.
+
+        Parameters:
+        -----------
+
+        name: str
+            The name of part to be generated
+        variable:
+            The variable to compute the particle traces with.
+            It can be the name, the ID or the ``ENS_VAR`` object. It must be a vector variable.
+        direction: str
+            The direction for the particle traces to be generated.
+            This table describes the options:
+
+            ================== ==============================================
+            Name               Query type
+            ================== ==============================================
+            PT_POS_TIME        Follow the vector direction
+            PT_NEG_TIME        Go contrary to the vector direction
+            PT_POS_NEG_TIME    Follow and go contrary to the vector direction
+            ================== ==============================================
+
+            If not provided, it will default to ``PT_POS_TIME``
+        pathlines: bool
+            True if the particle traces need to be pathlines
+        points: list
+            List of coordinates for the seed points.
+        source_parts: list
+            A list of parts to create the particle trace in. For instance, in a CFD
+            simulation this might be the fluid zone.
+            If not provided, the function will try to look for the selected parts.
+        emit_time: float
+            The emission time to start the particle trace from. If not provided,
+            it will use the current time.
+        total_time: float
+            The total emission time. If not provided, EnSight will provide the end time
+            for a transient simulation, an internal best time for steady state simulations.
+        delta_time: float
+            The interval for the emissions. If not provided, EnSight will provide
+            a best estimate.
+        """
+        emitter_type = self._EMIT_POINT
+        direction, converted_source_parts = self._prepare_particle_creation(
+            direction=direction, source_parts=source_parts
+        )
+        pathline_part, def_part = self._create_pathline_part(
+            name,
+            variable,
+            direction,
+            converted_source_parts,
+            pathlines=pathlines,
+            emit_time=emit_time,
+            delta_time=delta_time,
+            total_time=total_time,
+        )
+        new_emitters = self._create_emitters(emitter_type=emitter_type, points=points)
+        return self._add_emitters_to_pathline(
+            pathline_part, new_emitters=new_emitters, palette=def_part.VARIABLE.DESCRIPTION
+        )
+
+    def create_particle_trace_from_line(
+        self,
+        name: str,
+        variable: Union[str, int, "ENS_VAR"],
+        point1: List[float],
+        point2: List[float],
+        num_points: Optional[int] = 100,
+        direction: Optional[str] = None,
+        pathlines: Optional[bool] = False,
+        source_parts: Optional[List[Union[str, int, "ENS_PART"]]] = None,
+        emit_time: Optional[float] = None,
+        total_time: Optional[float] = None,
+        delta_time: Optional[float] = None,
+    ) -> "ENS_PART":
+        """
+        Create a particle trace part from a line.
+        Returns the ``ENS_PART`` generated.
+
+        Parameters:
+        -----------
+
+        name: str
+            The name of part to be generated
+        variable:
+            The variable to compute the particle traces with.
+            It can be the name, the ID or the ``ENS_VAR`` object. It must be a vector variable.
+        direction: str
+            The direction for the particle traces to be generated.
+            This table describes the options:
+
+            ================== ==============================================
+            Name               Query type
+            ================== ==============================================
+            PT_POS_TIME        Follow the vector direction
+            PT_NEG_TIME        Go contrary to the vector direction
+            PT_POS_NEG_TIME    Follow and go contrary to the vector direction
+            ================== ==============================================
+
+            If not provided, it will default to ``PT_POS_TIME``
+        pathlines: bool
+            True if the particle traces need to be pathlines
+        point1: list
+            List of coordinates for point 1.
+        point2: list
+            List of coordinates for point 2.
+        source_parts: list
+            A list of parts to create the particle trace in. For instance, in a CFD
+            simulation this might be the fluid zone.
+            If not provided, the function will try to look for the selected parts.
+        num_points: int
+            The number of points to emit from. Defaults to 100.
+        emit_time: float
+            The emission time to start the particle trace from. If not provided,
+            it will use the current time.
+        total_time: float
+            The total emission time. If not provided, EnSight will provide the end time
+            for a transient simulation, an internal best time for steady state simulations.
+        delta_time: float
+            The interval for the emissions. If not provided, EnSight will provide
+            a best estimate.
+        """
+        emitter_type = self._EMIT_LINE
+        direction, converted_source_parts = self._prepare_particle_creation(
+            direction=direction, source_parts=source_parts
+        )
+        pathline_part, def_part = self._create_pathline_part(
+            name,
+            variable,
+            direction,
+            converted_source_parts,
+            pathlines=pathlines,
+            emit_time=emit_time,
+            delta_time=delta_time,
+            total_time=total_time,
+        )
+        new_emitters = self._create_emitters(
+            emitter_type=emitter_type, point1=point1, point2=point2, num_points=num_points
+        )
+        return self._add_emitters_to_pathline(
+            pathline_part, new_emitters=new_emitters, palette=def_part.VARIABLE.DESCRIPTION
+        )
+
+    def create_particle_trace_from_plane(
+        self,
+        name: str,
+        variable: Union[str, int, "ENS_VAR"],
+        point1: List[float],
+        point2: List[float],
+        point3: List[float],
+        num_points_x: Optional[int] = 25,
+        num_points_y: Optional[int] = 25,
+        direction: Optional[str] = None,
+        pathlines: Optional[bool] = False,
+        source_parts: Optional[List[Union[str, int, "ENS_PART"]]] = None,
+        emit_time: Optional[float] = None,
+        total_time: Optional[float] = None,
+        delta_time: Optional[float] = None,
+    ) -> "ENS_PART":
+        """
+        Create a particle trace part from a plane.
+        Returns the ``ENS_PART`` generated.
+
+        Parameters:
+        -----------
+
+        name: str
+            The name of part to be generated
+        variable:
+            The variable to compute the particle traces with.
+            It can be the name, the ID or the ``ENS_VAR`` object. It must be a vector variable.
+        direction: str
+            The direction for the particle traces to be generated.
+            This table describes the options:
+
+            ================== ==============================================
+            Name               Query type
+            ================== ==============================================
+            PT_POS_TIME        Follow the vector direction
+            PT_NEG_TIME        Go contrary to the vector direction
+            PT_POS_NEG_TIME    Follow and go contrary to the vector direction
+            ================== ==============================================
+
+            If not provided, it will default to ``PT_POS_TIME``
+        pathlines: bool
+            True if the particle traces need to be pathlines
+        point1: list
+            List of coordinates for point 1, being a corner of the plane.
+        point2: list
+            List of coordinates for point 2, being a corner of the plane.
+        point3: list
+            List of coordinates for point 3, being a corner of the plane.
+        source_parts: list
+            A list of parts to create the particle trace in. For instance, in a CFD
+            simulation this might be the fluid zone.
+            If not provided, the function will try to look for the selected parts.
+        num_points_x: int
+            The number of points on the ``X`` direction of the emission plane.
+            Defaults to 25.
+        num_points_y: int
+            The number of points on the ``Y`` direction of the emission plane.
+            Defaults to 25.
+        emit_time: float
+            The emission time to start the particle trace from. If not provided,
+            it will use the current time.
+        total_time: float
+            The total emission time. If not provided, EnSight will provide the end time
+            for a transient simulation, an internal best time for steady state simulations.
+        delta_time: float
+            The interval for the emissions. If not provided, EnSight will provide
+            a best estimate.
+        """
+        emitter_type = self._EMIT_PLANE
+        direction, converted_source_parts = self._prepare_particle_creation(
+            direction=direction, source_parts=source_parts
+        )
+        pathline_part, def_part = self._create_pathline_part(
+            name,
+            variable,
+            direction,
+            converted_source_parts,
+            pathlines=pathlines,
+            emit_time=emit_time,
+            delta_time=delta_time,
+            total_time=total_time,
+        )
+        new_emitters = self._create_emitters(
+            emitter_type=emitter_type,
+            point1=point1,
+            point2=point2,
+            point3=point3,
+            num_points_x=num_points_x,
+            num_points_y=num_points_y,
+        )
+        return self._add_emitters_to_pathline(
+            pathline_part, new_emitters=new_emitters, palette=def_part.VARIABLE.DESCRIPTION
+        )
+
+    def create_particle_trace_from_parts(
+        self,
+        name: str,
+        variable: Union[str, int, "ENS_VAR"],
+        parts: List[Union[str, int, "ENS_PART"]],
+        part_distribution_type: Optional[int] = 0,
+        num_points: Optional[int] = 100,
+        direction: Optional[str] = None,
+        pathlines: Optional[bool] = False,
+        source_parts: Optional[List[Union[str, int, "ENS_PART"]]] = None,
+        emit_time: Optional[float] = None,
+        total_time: Optional[float] = None,
+        delta_time: Optional[float] = None,
+    ) -> "ENS_PART":
+        """
+        Create a particle trace part from a list of seed parts.
+        Returns the ``ENS_PART`` generated.
+
+        Parameters:
+        -----------
+
+        name: str
+            The name of part to be generated
+        variable:
+            The variable to compute the particle traces with.
+            It can be the name, the ID or the ``ENS_VAR`` object. It must be a vector variable.
+        direction: str
+            The direction for the particle traces to be generated.
+            This table describes the options:
+
+            ================== ==============================================
+            Name               Query type
+            ================== ==============================================
+            PT_POS_TIME        Follow the vector direction
+            PT_NEG_TIME        Go contrary to the vector direction
+            PT_POS_NEG_TIME    Follow and go contrary to the vector direction
+            ================== ==============================================
+
+            If not provided, it will default to ``PT_POS_TIME``
+        pathlines: bool
+            True if the particle traces need to be pathlines
+        source_parts: list
+            A list of parts to create the particle trace in. For instance, in a CFD
+            simulation this might be the fluid zone.
+            If not provided, the function will try to look for the selected parts.
+        parts: list
+            A list of parts to emit the particle traces from.
+            They can be their names, their IDs or the respective ``ENS_PART`` objects.
+        part_distribution_type: int
+            The distribution of emitters in case of emission from a part.
+            This table describes the options:
+
+            ====================   =================================================
+            Name                   Query type
+            ====================   =================================================
+            PART_EMIT_FROM_NODES   Emit from the nodes of the part
+            PART_EMIT_FROM_AREA    Create an area of equidistant points for emission
+            ==================     =================================================
+
+            If not provided, it will default to ``PART_EMIT_FROM_NODES``
+        num_points: int
+            The number of points to emit from.
+            Defaults to 100.
+        emit_time: float
+            The emission time to start the particle trace from. If not provided,
+            it will use the current time.
+        total_time: float
+            The total emission time. If not provided, EnSight will provide the end time
+            for a transient simulation, an internal best time for steady state simulations.
+        delta_time: float
+            The interval for the emissions. If not provided, EnSight will provide
+            a best estimate.
+        """
+        emitter_type = self._EMIT_PART
+        direction, converted_source_parts = self._prepare_particle_creation(
+            direction=direction, source_parts=source_parts
+        )
+        pathline_part, def_part = self._create_pathline_part(
+            name,
+            variable,
+            direction,
+            converted_source_parts,
+            pathlines=pathlines,
+            emit_time=emit_time,
+            delta_time=delta_time,
+            total_time=total_time,
+        )
+        new_parts = [convert_part(self.ensight, p) for p in parts]
+        new_emitters = self._create_emitters(
+            emitter_type=emitter_type,
+            parts=new_parts,
+            part_distribution_type=part_distribution_type,
+            num_points=num_points,
+        )
+        return self._add_emitters_to_pathline(
+            pathline_part, new_emitters=new_emitters, palette=def_part.VARIABLE.DESCRIPTION
+        )
+
+    def add_emitter_points_to_pathline_part(
+        self,
+        pathline_part: Union[str, int, "ENS_PART"],
+        points: List[List[float]],
+    ) -> "ENS_PART":
+        """
+        Add point emitters to an existing particle trace. The function will return the updated
+        ``ENS_PART`` object.
+
+        Parameters:
+        -----------
+
+        pathline_part:
+            The particle trace part to be added emitters to.
+            Can be the name, the ID or the ``ENS_PART`` object
+        points: list
+            List of list containing the coordinates for the seed points.
+        """
+        emitter_type = self._EMIT_POINT
+        pathline_part = self._cure_pathline_part(pathline_part)
+        new_emitters = self._create_emitters(emitter_type=emitter_type, points=points)
+        return self._add_emitters_to_pathline(pathline_part, new_emitters)
+
+    def add_emitter_line_to_pathline_part(
+        self,
+        pathline_part: Union[str, int, "ENS_PART"],
+        point1: List[float],
+        point2: List[float],
+        num_points: Optional[int] = 100,
+    ):
+        """
+        Add a line emitter to an existing particle trace. The function will return the updated
+        ``ENS_PART`` object.
+
+        Parameters:
+        -----------
+
+        pathline_part:
+            The particle trace part to be added emitters to.
+            Can be the name, the ID or the ``ENS_PART`` object.
+        point1: list
+            The coordinates for point 1.
+        point2: list
+            The coordinates for point 2.
+        num_points: int
+            The number of seed points. Defaults to 100.
+        """
+        emitter_type = self._EMIT_LINE
+        pathline_part = self._cure_pathline_part(pathline_part)
+        new_emitters = self._create_emitters(
+            emitter_type=emitter_type, point1=point1, point2=point2, num_points=num_points
+        )
+        return self._add_emitters_to_pathline(pathline_part, new_emitters)
+
+    def add_emitter_plane_to_pathline_part(
+        self,
+        pathline_part: Union[str, int, "ENS_PART"],
+        point1: List[float],
+        point2: List[float],
+        point3: List[float],
+        num_points_x: Optional[int] = 25,
+        num_points_y: Optional[int] = 25,
+    ):
+        """
+        Add a plane emitter to an existing particle trace. The function will return the updated
+        ``ENS_PART`` object.
+
+        Parameters:
+        -----------
+
+        pathline_part:
+            The particle trace part to be added emitters to.
+            Can be the name, the ID or the ``ENS_PART`` object.
+        point1: list
+            The coordinates for point 1, being a corner of the plane.
+        point2: list
+            The coordinates for point 2, being a corner of the plane.
+        point3: list
+            The coordinates for point 3, being a corner of the plane.
+        num_points_x: int
+            The number of points on the ``X`` direction of the emission plane.
+            Defaults to 25.
+        num_points_y: int
+            The number of points on the ``Y`` direction of the emission plane.
+            Defaults to 25.
+        """
+        emitter_type = self._EMIT_PLANE
+        pathline_part = self._cure_pathline_part(pathline_part)
+        new_emitters = self._create_emitters(
+            emitter_type=emitter_type,
+            point1=point1,
+            point2=point2,
+            point3=point3,
+            num_points_x=num_points_x,
+            num_points_y=num_points_y,
+        )
+        return self._add_emitters_to_pathline(pathline_part, new_emitters)
+
+    def add_emitter_parts_to_pathline_part(
+        self,
+        pathline_part: Union[str, int, "ENS_PART"],
+        parts: List[Union[str, int, "ENS_PART"]],
+        part_distribution_type: Optional[int] = 0,
+        num_points: Optional[int] = 100,
+    ):
+        """
+        Add a list of part emitters to an existing particle trace. The function will return the updated
+        ``ENS_PART`` object.
+
+        Parameters:
+        -----------
+
+        pathline_part:
+            The particle trace part to be added emitters to.
+            Can be the name, the ID or the ``ENS_PART`` object.
+        parts: list
+            A list of parts to emit the particle traces from.
+            They can be their names, their IDs or the respective ``ENS_PART`` objects.
+        part_distribution_type: int
+            The distribution of emitters in case of emission from a part.
+            This table describes the options:
+
+            ====================   =================================================
+            Name                   Query type
+            ====================   =================================================
+            PART_EMIT_FROM_NODES   Emit from the nodes of the part
+            PART_EMIT_FROM_AREA    Create an area of equidistant points for emission
+            ==================     =================================================
+
+            If not provided, it will default to ``PART_EMIT_FROM_NODES``
+        num_points: int
+            The number of points to emit from.
+            Defaults to 100.
+        """
+        emitter_type = self._EMIT_PART
+        pathline_part = self._cure_pathline_part(pathline_part)
+        new_parts = [convert_part(self.ensight, p) for p in parts]
+        new_emitters = self._create_emitters(
+            emitter_type=emitter_type,
+            parts=new_parts,
+            part_distribution_type=part_distribution_type,
+            num_points=num_points,
+        )
+        return self._add_emitters_to_pathline(pathline_part, new_emitters)

{ansys_pyensight_core-0.7.0.dist-info → ansys_pyensight_core-0.7.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ansys-pyensight-core
-Version: 0.7.0
+Version: 0.7.2
 Summary: A python wrapper for Ansys EnSight
 Author-email: "ANSYS, Inc." <pyansys.core@ansys.com>
 Maintainer-email: "ANSYS, Inc." <pyansys.core@ansys.com>
@@ -20,8 +20,6 @@ Requires-Dist: ansys-api-pyensight==0.3.2
 Requires-Dist: requests>=2.28.2
 Requires-Dist: docker>=6.1.0
 Requires-Dist: urllib3<2
-Requires-Dist: typing>=3.7.4.3
-Requires-Dist: typing-extensions>=4.5.0
 Requires-Dist: numpy>=1.21.0
 Requires-Dist: Pillow>=9.3.0
 Requires-Dist: build>=0.10.0 ; extra == "dev"

{ansys_pyensight_core-0.7.0.dist-info → ansys_pyensight_core-0.7.2.dist-info}/RECORD

@@ -7,20 +7,20 @@ ansys/pyensight/core/ensight_grpc.py,sha256=yFnvxjI2cAWd0c0gcM46MEIA5Ov7DUMlufqU
 ansys/pyensight/core/ensobj.py,sha256=tynUyYrpzCz2lvcse6fcmutnG6Jj111s518OlO19EqE,17354
 ansys/pyensight/core/launch_ensight.py,sha256=KqUq3dYc2j4aKMkZYu9rXXw7ODZDqFbD6kx4Vt0uJcg,5915
 ansys/pyensight/core/launcher.py,sha256=zj-6DBp307-IJ0RTDmZOxCFVGemJu8YaagJLZFLloNw,10445
-ansys/pyensight/core/listobj.py,sha256=vsVTeI3RY0P1n5GNOHW-iU95GCWnHlOg_E6leVMQScw,8223
+ansys/pyensight/core/listobj.py,sha256=MFrjl9b-OGntlvh9yib2swUNT2jaMvoP5uniU0Fpt9s,8194
 ansys/pyensight/core/locallauncher.py,sha256=sgaPrG-7ctXZ_ytGuHeriiVmgvI0kUeX6nKVJ4OiDUs,13984
 ansys/pyensight/core/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ansys/pyensight/core/renderable.py,sha256=z61Pum_Pa2CVoXVWOCqPngeHT_ifBS3fpqA5mZDDmnc,30777
-ansys/pyensight/core/session.py,sha256=nTeqiXsOz_FffeYGsYLsWDznP86-ZBxS0AA8wgOEBeU,62690
+ansys/pyensight/core/renderable.py,sha256=Kf9pLQPLk91D7TwvXrL2wsMyKz_J6opcJ8peQr2pbxQ,31451
+ansys/pyensight/core/session.py,sha256=CHVAYncg8Uaacz4cbA-mAVWyWAOjfol635ohSIfa054,63241
 ansys/pyensight/core/sgeo_poll.html,sha256=1M4BIc5CZpYA3b40qzk22NcPCLhjFnWdoS2PrS6Rhn4,752
 ansys/pyensight/core/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ansys/pyensight/core/utils/adr.py,sha256=XslZhlwcrSGzOlnhzprOv3ju_ppxxsWBjCnQL5KiNms,3570
 ansys/pyensight/core/utils/export.py,sha256=MGdPAPpI4CoLR-Fnctkqf9J7--J3DPEXK79kKZGVCqw,21552
-ansys/pyensight/core/utils/parts.py,sha256=x0Zso-ef64UJ-3BmYS3dymjftaWQI21WFTsDt-ghI-k,3986
+ansys/pyensight/core/utils/parts.py,sha256=rDnf17Rw02mwd3-R5qnB47kQAbvZQ0_YegYfxCmTBTY,36478
 ansys/pyensight/core/utils/query.py,sha256=cQXt_07ZuNAwueAIXinI3_f7G9lXass6j7G0aRJltZE,19035
 ansys/pyensight/core/utils/support.py,sha256=QI3z9ex7zJxjFbkCPba9DWqWgPFIThORqr0nvRfVjuc,4089
 ansys/pyensight/core/utils/views.py,sha256=vf4gSBRl6uC_LPwZdzrdMcR0dyi_PwYmRo20CPmjEBE,12209
-ansys_pyensight_core-0.7.0.dist-info/LICENSE,sha256=qQWivZ12ETN5l3QxvTARY-QI5eoRRlyHdwLlAj0Bg5I,1089
-ansys_pyensight_core-0.7.0.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
-ansys_pyensight_core-0.7.0.dist-info/METADATA,sha256=nKZPh4wq6SSDRrRwbZsHViS4MSp82NPfOXVOWqXARvE,11781
-ansys_pyensight_core-0.7.0.dist-info/RECORD,,
+ansys_pyensight_core-0.7.2.dist-info/LICENSE,sha256=qQWivZ12ETN5l3QxvTARY-QI5eoRRlyHdwLlAj0Bg5I,1089
+ansys_pyensight_core-0.7.2.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
+ansys_pyensight_core-0.7.2.dist-info/METADATA,sha256=crbiIJ8gYFFT0gaSxui8FMQzCcfRx4DEFAuZ-1sKvxI,11710
+ansys_pyensight_core-0.7.2.dist-info/RECORD,,