ansys-pyensight-core 0.9.6__tar.gz → 0.9.7__tar.gz

{ansys_pyensight_core-0.9.6 → ansys_pyensight_core-0.9.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: ansys-pyensight-core
-Version: 0.9.6
+Version: 0.9.7
 Summary: A python wrapper for Ansys EnSight
 Author-email: "ANSYS, Inc." <pyansys.core@ansys.com>
 Maintainer-email: "ANSYS, Inc." <pyansys.core@ansys.com>

{ansys_pyensight_core-0.9.6 → ansys_pyensight_core-0.9.7}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "ansys-pyensight-core"
-version = "0.9.6"
+version = "0.9.7"
 description = "A python wrapper for Ansys EnSight"
 readme = "README.rst"
 requires-python = ">=3.9,<4"

{ansys_pyensight_core-0.9.6 → ansys_pyensight_core-0.9.7}/src/ansys/pyensight/core/dvs.py

@@ -627,37 +627,30 @@ class DVS(dvs_base):
             start = end
         return parts
 
-    def _disassemble_simba_connectivity(self, faces):
-        i = 0
-        vertices_per_face = []
-        connectivity_1d = []
-        indices = []
-        while i < len(faces):
-            indices.append(i)
-            i += faces[i] + 1
-        mask = numpy.zeros(faces.shape, dtype=bool)
-        mask[indices] = True
-        vertices_per_face = numpy.array(faces[mask])
-        connectivity_1d = numpy.array(faces[~mask])
-        connectivity_split = numpy.split(connectivity_1d, numpy.cumsum(vertices_per_face[:-1]))
-        all_same = numpy.all(numpy.array(vertices_per_face) == vertices_per_face[0])
-        return connectivity_split, vertices_per_face, all_same
-
-    def send_connectivity(self, part_id, faces: Union[List, numpy.ndarray], ghost=False):
+    def send_connectivity(
+        self,
+        part_id,
+        offsets: Union[List, numpy.ndarray],
+        faces: Union[List, numpy.ndarray],
+        ghost=False,
+    ):
         """Send the connectivity data for the input part.
 
         The data will be used for building an element block in DVS.
         The connectivity array will be split among all the available ranks.
-        The data are assumed in the following format:
+        The faces data are assumed in the following format:
         [n, i1, i2, ...in, m, j1, j2, ...jn, p, k1, k2, ...kp, ...]
-        i.e. the first element declares how many vertices are available on the face,
-        then the following elements will be the indices of the vertices for the specific
-        face, and so on.
+        The offsets data instead:
+        [0, n, n+m, n+m+p ....]
+        The faces list indicates the IDs of the vertices of each face, in order.
+        The offsets lists indicates the index where to find a specific face.
 
         Parameters
         ----------
         part_id: int
             the part to define the connectivity for
+        offsets: List[int] or numpy array
+            the offsets values. The format is described above.
         faces: List[int] or numpy array
             the connectivity value. The format is described above.
         ghost: bool
@@ -671,10 +664,12 @@ class DVS(dvs_base):
             )
         if not isinstance(faces, numpy.ndarray):
             faces = numpy.array(faces)
-        connectivity_split, vertices_per_face, all_same = self._disassemble_simba_connectivity(
-            faces
-        )
+        if not isinstance(offsets, numpy.ndarray):
+            offsets = numpy.array(offsets)
+        vertices_per_face = numpy.diff(offsets)
+        connectivity_split = numpy.split(faces, numpy.cumsum(vertices_per_face[:-1]))
         elem_type = self.ELEMTYPE_N_SIDED_POLYGON
+        all_same = numpy.all(numpy.array(vertices_per_face) == vertices_per_face[0])
         if all_same:
             num_vertices = vertices_per_face[0]
             _elem_type = self._elem_type_map.get(num_vertices)

{ansys_pyensight_core-0.9.6 → ansys_pyensight_core-0.9.7}/src/ansys/pyensight/core/launcher.py

@@ -34,6 +34,12 @@ if TYPE_CHECKING:
 # See: https://bugs.python.org/issue29288
 "".encode("idna")
 
+# The user doesn't know "eth" and "ib" what they mean. Use more meaningful
+# keywords.
+INTERCONNECT_MAP = {"ethernet": "eth", "infiniband": "ib"}
+
+MPI_TYPES = ["intel2018", "intel2021", "openmpi"]
+
 
 class Launcher:
     """Provides the EnSight ``Launcher`` base class.
@@ -63,6 +69,31 @@ class Launcher:
         are not supported.
     launch_web_ui : bool, optional
         Whether to launch the webUI from EnSight
+    use_mpi: str, optional
+        If set, EnSight will be launched with the MPI type selected. The valid
+        values depend on the EnSight version to be used. The user can see
+        the specific list starting the EnSight Launcher manually and specifying the options
+        to launch EnSight in parallel and MPI. Here are reported the values for releases
+        2024R2 and 2025R1.
+
+        =================== =========================================
+        Release             Valid MPI Types
+        =================== =========================================
+        2024R2              intel2021, intel2018, openmpi
+        2025R1              intel2021, intel2018, openmpi
+        =================== =========================================
+
+        The remote nodes must be Linux nodes.
+        This option is valid only if a LocalLauncher is used.
+    interconnet: str, optional
+        If set, EnSight will be launched with the MPI Interconnect selected. Valid values
+        are "ethernet", "infiniband". It requires use_mpi to be set.
+        If use_mpi is set and interconnect is not, "ethernet" will be used.
+        This option is valid only if a LocalLauncher is used.
+    server_hosts: List[str], optional
+        A list of hostnames where the server processes should be spawned on when MPI is selected.
+        If use_mpi is set and server_hosts not, it will default to "localhost".
+        This option is valid only if a LocalLauncher is used.
     """
 
     def __init__(
@@ -73,10 +104,26 @@ class Launcher:
         enable_rest_api: bool = False,
         additional_command_line_options: Optional[List] = None,
         launch_webui: bool = False,
+        use_mpi: Optional[str] = None,
+        interconnect: Optional[str] = None,
+        server_hosts: Optional[List[str]] = None,
     ) -> None:
         self._timeout = timeout
         self._use_egl_param_val: bool = use_egl
         self._use_sos = use_sos
+        self._use_mpi = use_mpi
+        self._interconnect = interconnect
+        if self._use_mpi and self._use_mpi not in MPI_TYPES:
+            raise RuntimeError(f"{self._use_mpi} is not a valid MPI option.")
+        if self._use_mpi and not self._interconnect:
+            self._interconnect = "ethernet"
+        if self._interconnect:
+            if self._interconnect not in list(INTERCONNECT_MAP.values()):
+                raise RuntimeError(f"{self._interconnect} is not a valid MPI interconnect option.")
+            self._interconnect = INTERCONNECT_MAP.get(self._interconnect)
+        self._server_hosts = server_hosts
+        if self._use_mpi and not self._server_hosts:
+            self._server_hosts = ["localhost"]
         self._enable_rest_api = enable_rest_api
 
         self._sessions: List[Session] = []

{ansys_pyensight_core-0.9.6 → ansys_pyensight_core-0.9.7}/src/ansys/pyensight/core/locallauncher.py

@@ -218,8 +218,16 @@ class LocalLauncher(Launcher):
                 cmd.append("-egl")
             if self._use_sos:
                 cmd.append("-sos")
-                cmd.append("-nservers")
-                cmd.append(str(int(self._use_sos)))
+                if not self._use_mpi:
+                    cmd.append("-nservers")
+                    cmd.append(str(int(self._use_sos)))
+                else:
+                    cmd.append(f"--np={int(self._use_sos)+1}")
+                    cmd.append(f"--mpi={self._use_mpi}")
+                    cmd.append(f"--ic={self._interconnect}")
+                    hosts = ",".join(self._server_hosts)
+                    cmd.append(f"--cnf={hosts}")
+
             # cmd.append("-minimize_console")
             logging.debug(f"Starting EnSight with : {cmd}\n")
             self._ensight_pid = subprocess.Popen(cmd, **popen_common).pid