ansys-speos-core 0.5.2__tar.gz → 0.6.0__tar.gz

{ansys_speos_core-0.5.2 → ansys_speos_core-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ansys-speos-core
-Version: 0.5.2
+Version: 0.6.0
 Summary: A Python wrapper for Ansys Speos
 Author-email: "ANSYS, Inc." <pyansys.core@ansys.com>
 Maintainer-email: "ANSYS, Inc." <pyansys.core@ansys.com>
@@ -23,11 +23,11 @@ License-File: LICENSE
 Requires-Dist: protobuf>=3.20,<7
 Requires-Dist: grpcio>=1.50.0,<1.71
 Requires-Dist: grpcio-health-checking>=1.45.0,<1.68
-Requires-Dist: ansys-api-speos==0.14.2
+Requires-Dist: ansys-api-speos==0.15.2
 Requires-Dist: ansys-tools-path>=0.3.1
 Requires-Dist: numpy>=1.20.3,<3
 Requires-Dist: comtypes>=1.4,<1.5
-Requires-Dist: ansys-sphinx-theme==1.4.4 ; extra == "doc"
+Requires-Dist: ansys-sphinx-theme==1.5.2 ; extra == "doc"
 Requires-Dist: numpydoc==1.8.0 ; extra == "doc"
 Requires-Dist: Sphinx==8.1.3 ; extra == "doc"
 Requires-Dist: sphinx-copybutton==0.5.2 ; extra == "doc"
@@ -37,8 +37,8 @@ Requires-Dist: sphinx-jinja==2.0.2 ; extra == "doc"
 Requires-Dist: sphinxcontrib-mermaid==1.0.0 ; extra == "doc"
 Requires-Dist: myst-parser==4.0.1 ; extra == "doc"
 Requires-Dist: nbsphinx==0.9.7 ; extra == "doc"
-Requires-Dist: jupytext==1.17.1 ; extra == "doc"
-Requires-Dist: jupyterlab==4.4.2 ; extra == "doc"
+Requires-Dist: jupytext==1.17.2 ; extra == "doc"
+Requires-Dist: jupyterlab==4.4.3 ; extra == "doc"
 Requires-Dist: jupyter-server==2.16.0 ; extra == "doc"
 Requires-Dist: nbconvert==7.16.6 ; extra == "doc"
 Requires-Dist: pyvista[jupyter]>=0.43,<0.46 ; extra == "doc"
@@ -50,13 +50,13 @@ Requires-Dist: jupyterlab>=3 ; extra == "jupyter"
 Requires-Dist: ipywidgets ; extra == "jupyter"
 Requires-Dist: pyvista[jupyter]>=0.43,<0.46 ; extra == "jupyter"
 Requires-Dist: ansys-tools-visualization-interface>=0.8.3 ; extra == "jupyter"
-Requires-Dist: notebook==7.4.2 ; extra == "jupyter"
+Requires-Dist: notebook==7.4.3 ; extra == "jupyter"
 Requires-Dist: psutil==7.0.0 ; extra == "tests"
-Requires-Dist: pytest==8.3.5 ; extra == "tests"
+Requires-Dist: pytest==8.4.1 ; extra == "tests"
 Requires-Dist: pyvista>=0.40.0,<0.46 ; extra == "tests"
 Requires-Dist: ansys-tools-visualization-interface>=0.8.3 ; extra == "tests"
 Requires-Dist: ansys-platform-instancemanagement>=1.0.3 ; extra == "tests"
-Requires-Dist: pytest-cov==6.1.1 ; extra == "tests"
+Requires-Dist: pytest-cov==6.2.1 ; extra == "tests"
 Project-URL: Changelog, https://github.com/ansys/pyspeos/blob/main/doc/source/changelog.rst
 Project-URL: Discussions, https://github.com/ansys/pyspeos/discussions
 Project-URL: Documentation, https://speos.docs.pyansys.com/
@@ -70,12 +70,24 @@ Provides-Extra: tests
 
 PySpeos library
 ================
-|pyansys| |GH-CI| |MIT| |ruff|
+|pyansys| |python| |pypi| |codecov| |GH-CI| |MIT| |ruff|
 
 .. |pyansys| image:: https://img.shields.io/badge/Py-Ansys-ffc107.svg?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAIAAACQkWg2AAABDklEQVQ4jWNgoDfg5mD8vE7q/3bpVyskbW0sMRUwofHD7Dh5OBkZGBgW7/3W2tZpa2tLQEOyOzeEsfumlK2tbVpaGj4N6jIs1lpsDAwMJ278sveMY2BgCA0NFRISwqkhyQ1q/Nyd3zg4OBgYGNjZ2ePi4rB5loGBhZnhxTLJ/9ulv26Q4uVk1NXV/f///////69du4Zdg78lx//t0v+3S88rFISInD59GqIH2esIJ8G9O2/XVwhjzpw5EAam1xkkBJn/bJX+v1365hxxuCAfH9+3b9/+////48cPuNehNsS7cDEzMTAwMMzb+Q2u4dOnT2vWrMHu9ZtzxP9vl/69RVpCkBlZ3N7enoDXBwEAAA+YYitOilMVAAAAAElFTkSuQmCC
    :target: https://docs.pyansys.com/
    :alt: PyAnsys
 
+.. |python| image:: https://img.shields.io/pypi/pyversions/ansys-speos-core?logo=pypi
+   :target: https://pypi.org/project/ansys-speos-core/
+   :alt: Python
+
+.. |pypi| image:: https://img.shields.io/pypi/v/ansys-speos-core.svg?logo=python&logoColor=white&label=PyPI
+   :target: https://pypi.org/project/ansys-speos-core
+   :alt: PyPI
+
+.. |codecov| image:: https://codecov.io/github/ansys/pyspeos/graph/badge.svg?token=34FKDS6ZKJ
+   :target: https://codecov.io/github/ansys/pyspeos
+   :alt: Codecov
+
 .. |GH-CI| image:: https://github.com/ansys/pyspeos/actions/workflows/ci_cd.yml/badge.svg
    :target: https://github.com/ansys/pyspeos/actions/workflows/ci_cd.yml
 
@@ -201,12 +213,12 @@ Then, to launch SpeosRPC server with product version 2025.1, you can run:
    export LICENSE_SERVER=1055@XXX.XXX.XXX.XXX
 
    cat GH_TOKEN.txt | docker login ghcr.io -u "$GH_USERNAME" --password-stdin
-   docker pull ghcr.io/ansys/speos-rpc:251
-   docker run --detach --name speos-rpc -p 50098:50098 -e ANSYSLMD_LICENSE_FILE=$LICENSE_SERVER --entrypoint /app/SpeosRPC_Server.x ghcr.io/ansys/speos-rpc:251
+   docker pull ghcr.io/ansys/speos-rpc:252
+   docker run --detach --name speos-rpc -p 50098:50098 -e ANSYSLMD_LICENSE_FILE=$LICENSE_SERVER --entrypoint /app/SpeosRPC_Server.x ghcr.io/ansys/speos-rpc:252
 
 .. note::
 
-   To use the latest image in development, you can use `ghcr.io/ansys/speos-rpc:dev`.
+   To use the latest image in development, you can use `ghcr.io/ansys/speos-rpc:252`.
 
 On the other hand, the SpeosRPC server can be started locally.
 

{ansys_speos_core-0.5.2 → ansys_speos_core-0.6.0}/README.rst

@@ -1,11 +1,23 @@
 PySpeos library
 ================
-|pyansys| |GH-CI| |MIT| |ruff|
+|pyansys| |python| |pypi| |codecov| |GH-CI| |MIT| |ruff|
 
 .. |pyansys| image:: https://img.shields.io/badge/Py-Ansys-ffc107.svg?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAIAAACQkWg2AAABDklEQVQ4jWNgoDfg5mD8vE7q/3bpVyskbW0sMRUwofHD7Dh5OBkZGBgW7/3W2tZpa2tLQEOyOzeEsfumlK2tbVpaGj4N6jIs1lpsDAwMJ278sveMY2BgCA0NFRISwqkhyQ1q/Nyd3zg4OBgYGNjZ2ePi4rB5loGBhZnhxTLJ/9ulv26Q4uVk1NXV/f///////69du4Zdg78lx//t0v+3S88rFISInD59GqIH2esIJ8G9O2/XVwhjzpw5EAam1xkkBJn/bJX+v1365hxxuCAfH9+3b9/+////48cPuNehNsS7cDEzMTAwMMzb+Q2u4dOnT2vWrMHu9ZtzxP9vl/69RVpCkBlZ3N7enoDXBwEAAA+YYitOilMVAAAAAElFTkSuQmCC
    :target: https://docs.pyansys.com/
    :alt: PyAnsys
 
+.. |python| image:: https://img.shields.io/pypi/pyversions/ansys-speos-core?logo=pypi
+   :target: https://pypi.org/project/ansys-speos-core/
+   :alt: Python
+
+.. |pypi| image:: https://img.shields.io/pypi/v/ansys-speos-core.svg?logo=python&logoColor=white&label=PyPI
+   :target: https://pypi.org/project/ansys-speos-core
+   :alt: PyPI
+
+.. |codecov| image:: https://codecov.io/github/ansys/pyspeos/graph/badge.svg?token=34FKDS6ZKJ
+   :target: https://codecov.io/github/ansys/pyspeos
+   :alt: Codecov
+
 .. |GH-CI| image:: https://github.com/ansys/pyspeos/actions/workflows/ci_cd.yml/badge.svg
    :target: https://github.com/ansys/pyspeos/actions/workflows/ci_cd.yml
 
@@ -131,12 +143,12 @@ Then, to launch SpeosRPC server with product version 2025.1, you can run:
    export LICENSE_SERVER=1055@XXX.XXX.XXX.XXX
 
    cat GH_TOKEN.txt | docker login ghcr.io -u "$GH_USERNAME" --password-stdin
-   docker pull ghcr.io/ansys/speos-rpc:251
-   docker run --detach --name speos-rpc -p 50098:50098 -e ANSYSLMD_LICENSE_FILE=$LICENSE_SERVER --entrypoint /app/SpeosRPC_Server.x ghcr.io/ansys/speos-rpc:251
+   docker pull ghcr.io/ansys/speos-rpc:252
+   docker run --detach --name speos-rpc -p 50098:50098 -e ANSYSLMD_LICENSE_FILE=$LICENSE_SERVER --entrypoint /app/SpeosRPC_Server.x ghcr.io/ansys/speos-rpc:252
 
 .. note::
 
-   To use the latest image in development, you can use `ghcr.io/ansys/speos-rpc:dev`.
+   To use the latest image in development, you can use `ghcr.io/ansys/speos-rpc:252`.
 
 On the other hand, the SpeosRPC server can be started locally.
 

{ansys_speos_core-0.5.2 → ansys_speos_core-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "ansys-speos-core"
-version = "0.5.2"
+version = "0.6.0"
 description = "A Python wrapper for Ansys Speos"
 readme = "README.rst"
 requires-python = ">=3.10"
@@ -30,7 +30,7 @@ dependencies=[
     "protobuf>=3.20,<7",
     "grpcio>=1.50.0,<1.71",
     "grpcio-health-checking>=1.45.0,<1.68",
-    "ansys-api-speos==0.14.2",
+    "ansys-api-speos==0.15.2",
     "ansys-tools-path>=0.3.1",
     "numpy>=1.20.3,<3",
     "comtypes>=1.4,<1.5",
@@ -43,11 +43,11 @@ graphics = [
 ]
 tests = [
     "psutil==7.0.0",
-    "pytest==8.3.5",
+    "pytest==8.4.1",
     "pyvista>=0.40.0,<0.46",
     "ansys-tools-visualization-interface>=0.8.3",
     "ansys-platform-instancemanagement>=1.0.3",
-    "pytest-cov==6.1.1",
+    "pytest-cov==6.2.1",
 ]
 jupyter = [
     "matplotlib",
@@ -55,10 +55,10 @@ jupyter = [
     "ipywidgets",
     "pyvista[jupyter]>=0.43,<0.46",
     "ansys-tools-visualization-interface>=0.8.3",
-    "notebook==7.4.2",
+    "notebook==7.4.3",
 ]
 doc = [
-    "ansys-sphinx-theme==1.4.4",
+    "ansys-sphinx-theme==1.5.2",
     "numpydoc==1.8.0",
     "Sphinx==8.1.3",
     "sphinx-copybutton==0.5.2",
@@ -68,8 +68,8 @@ doc = [
     "sphinxcontrib-mermaid==1.0.0",
     "myst-parser==4.0.1",
     "nbsphinx==0.9.7",
-    "jupytext==1.17.1",
-    "jupyterlab==4.4.2",
+    "jupytext==1.17.2",
+    "jupyterlab==4.4.3",
     "jupyter-server==2.16.0",
     "nbconvert==7.16.6",
     "pyvista[jupyter]>=0.43,<0.46",

{ansys_speos_core-0.5.2 → ansys_speos_core-0.6.0}/src/ansys/speos/core/body.py

@@ -29,6 +29,8 @@ from typing import List, Mapping, Optional, Union
 
 from ansys.speos.core import proto_message_utils
 import ansys.speos.core.face as face
+import ansys.speos.core.generic.general_methods as general_methods
+from ansys.speos.core.generic.visualization_methods import _VisualData
 from ansys.speos.core.geo_ref import GeoRef
 from ansys.speos.core.kernel.body import ProtoBody
 from ansys.speos.core.kernel.client import SpeosClient
@@ -72,6 +74,7 @@ class Body:
         self._parent_part = parent_part
         self._name = name
         self.body_link = None
+        self._visual_data = _VisualData() if general_methods._GRAPHICS_AVAILABLE else None
         """Link object for the body in database."""
 
         if metadata is None:
@@ -82,6 +85,30 @@ class Body:
 
         self._geom_features = []
 
+    @property
+    def visual_data(self):
+        """Property containing irradiance sensor visualization data.
+
+        Returns
+        -------
+        VisualData
+            Instance of VisualData Class for pyvista.PolyData of feature faces, coordinate_systems.
+
+        """
+        import numpy as np
+
+        if self._visual_data.updated is True:
+            return self._visual_data
+        for feature_face in self._geom_features:
+            vertices = np.array(feature_face._face.vertices).reshape(-1, 3)
+            facets = np.array(feature_face._face.facets).reshape(-1, 3)
+            temp = np.full(facets.shape[0], 3)
+            temp = np.vstack(temp)
+            facets = np.hstack((temp, facets))
+            self._visual_data.add_data_mesh(vertices, facets)
+        self._visual_data.updated = True
+        return self._visual_data
+
     @property
     def geo_path(self) -> GeoRef:
         """Geometry path to be used within other speos objects."""
@@ -159,6 +186,9 @@ class Body:
         ansys.speos.core.body.Body
             Body feature.
         """
+        if general_methods._GRAPHICS_AVAILABLE:
+            self._visual_data.updated = False
+
         # Commit faces contained in this body
         for g in self._geom_features:
             g.commit()

{ansys_speos_core-0.5.2 → ansys_speos_core-0.6.0}/src/ansys/speos/core/generic/general_methods.py

@@ -25,6 +25,8 @@
 this includes decorator and methods
 """
 
+from __future__ import annotations
+
 from collections.abc import Collection
 from functools import lru_cache, wraps
 import os
@@ -44,6 +46,8 @@ GRAPHICS_ERROR = (
     "You can install this using `pip install ansys-speos-core[graphics]`."
 )
 
+VERSION_ERROR = "The pySpeos feature : {feature_name} needs a Speos Version of {version} or higher."
+
 
 def deprecate_kwargs(old_arguments: dict, removed_version="0.3.0"):
     """Issues deprecation warnings for arguments.
@@ -230,3 +234,82 @@ def retrieve_speos_install_dir(
     if not speos_exec.is_file():
         error_no_install(speos_rpc_path, int(version))
     return speos_rpc_path
+
+
+def wavelength_to_rgb(wavelength: float, gamma: float = 0.8) -> [int, int, int, int]:
+    """Convert a given wavelength of light to an approximate RGB color value.
+
+    The wavelength must be given in nanometers in the range from 380 nm to 750 nm.
+    Based on the code from http://www.physics.sfasu.edu/astro/color/spectra.html
+
+    Parameters
+    ----------
+    wavelength : float
+        Wavelength in nanometer between 380-750 nm
+    gamma : float
+        Gamma value.
+        By default : ``0.8``
+    """
+    wavelength = float(wavelength)
+    if 380 <= wavelength <= 440:
+        attenuation = 0.3 + 0.7 * (wavelength - 380) / (440 - 380)
+        r = ((-(wavelength - 440) / (440 - 380)) * attenuation) ** gamma
+        g = 0.0
+        b = (1.0 * attenuation) ** gamma
+    elif 440 <= wavelength <= 490:
+        r = 0.0
+        g = ((wavelength - 440) / (490 - 440)) ** gamma
+        b = 1.0
+    elif 490 <= wavelength <= 510:
+        r = 0.0
+        g = 1.0
+        b = (-(wavelength - 510) / (510 - 490)) ** gamma
+    elif 510 <= wavelength <= 580:
+        r = ((wavelength - 510) / (580 - 510)) ** gamma
+        g = 1.0
+        b = 0.0
+    elif 580 <= wavelength <= 645:
+        r = 1.0
+        g = (-(wavelength - 645) / (645 - 580)) ** gamma
+        b = 0.0
+    elif 645 <= wavelength <= 750:
+        attenuation = 0.3 + 0.7 * (750 - wavelength) / (750 - 645)
+        r = (1.0 * attenuation) ** gamma
+        g = 0.0
+        b = 0.0
+    else:
+        r = 0.0
+        g = 0.0
+        b = 0.0
+    r *= 255
+    g *= 255
+    b *= 255
+    return [int(r), int(g), int(b), 255]
+
+
+def min_speos_version(major: int, minor: int, service_pack: int):
+    """Raise version warning.
+
+    Parameters
+    ----------
+    major : int
+        Major release version, e.g. 25
+    minor : int
+        Minor release version e.g. 1
+    service_pack : int
+        Service Pack version e.g. 3
+    """
+    version = f"20{major} R{minor} SP{service_pack}"
+
+    def decorator(function):
+        def wrapper(*args, **kwargs):
+            if function.__qualname__.endswith("__init__"):
+                name = function.__qualname__[:-9]
+            else:
+                name = function.__qualname__
+            warnings.warn(VERSION_ERROR.format(version=version, feature_name=name), stacklevel=2)
+            return function(*args, **kwargs)
+
+        return wrapper
+
+    return decorator

{ansys_speos_core-0.5.2 → ansys_speos_core-0.6.0}/src/ansys/speos/core/generic/visualization_methods.py

@@ -22,7 +22,9 @@
 
 """Provides the ``VisualData`` class."""
 
-from typing import TYPE_CHECKING, List
+from typing import TYPE_CHECKING, List, Tuple, Union
+
+import numpy as np
 
 from ansys.speos.core.generic.general_methods import (
     graphics_required,
@@ -36,7 +38,7 @@ if TYPE_CHECKING:  # pragma: no cover
 
 @graphics_required
 class _VisualCoordinateSystem:
-    """Visualization data for the coordinate system..
+    """Visualization data for the coordinate system.
 
     By default, there is empty visualization data.
 
@@ -52,21 +54,21 @@ class _VisualCoordinateSystem:
         self.__x_axis = pv.Arrow(
             start=self.__origin,
             direction=[1.0, 0.0, 0.0],
-            scale=10.0,
+            scale=1.0,
             tip_radius=0.05,
             shaft_radius=0.01,
         )
         self.__y_axis = pv.Arrow(
             start=self.__origin,
             direction=[0.0, 1.0, 0.0],
-            scale=10.0,
+            scale=1.0,
             tip_radius=0.05,
             shaft_radius=0.01,
         )
         self.__z_axis = pv.Arrow(
             start=self.__origin,
             direction=[0.0, 0.0, 1.0],
-            scale=10.0,
+            scale=1.0,
             tip_radius=0.05,
             shaft_radius=0.01,
         )
@@ -214,6 +216,72 @@ class _VisualCoordinateSystem:
         )
 
 
+@graphics_required
+class _VisualArrow:
+    """Visualization data for the line or arrow.
+
+    By default, there is empty visualization data.
+
+    Notes
+    -----
+    **Do not instantiate this class yourself**.
+    """
+
+    def __init__(
+        self,
+        line_vertices: List[List[float]],
+        color: Tuple[float, float, float] = (0.643, 1.0, 0.0),
+        arrow: bool = False,
+    ) -> None:
+        import pyvista as pv
+
+        if len(line_vertices) != 2 or any(len(point) != 3 for point in line_vertices):
+            raise ValueError(
+                "line_vertices is expected to be composed of 2 vertices with 3 elements each."
+            )
+        line_vertices = np.array(line_vertices)
+        if arrow:
+            self.__data = pv.Arrow(
+                start=line_vertices[0],
+                direction=line_vertices[1],
+                scale=1,
+                tip_radius=0.05,
+                shaft_radius=0.01,
+            )
+        else:
+            self.__data = pv.Line(line_vertices[0], line_vertices[0] + line_vertices[1])
+        if all(value < 1 for value in color):
+            self.__color = color + (255,)
+        else:
+            self.__color = tuple(value / 255 for value in color) + (255,)
+
+    @property
+    def data(self) -> "pv.PolyData":
+        """
+        Returns the pyvista data of _VisualArrow.
+
+        Returns
+        -------
+        pv.PolyData
+            The pyvista data of _VisualArrow.
+
+        """
+        return self.__data
+
+    @property
+    def color(self) -> Tuple[float, float, float]:
+        """
+        Returns the color property of _VisualArrow.
+
+        Returns
+        -------
+        Tuple[float, float, float]
+            The color tuple of _VisualArrow.
+
+        """
+        return self.__color
+
+
 @graphics_required
 class _VisualData:
     """Visualization data for the sensor.
@@ -225,25 +293,26 @@ class _VisualData:
     **Do not instantiate this class yourself**
     """
 
-    def __init__(self, coordinate_system=True):
+    def __init__(self, ray: bool = False, coordinate_system: bool = True):
         import pyvista as pv
 
-        self.__data = pv.PolyData()
+        self._data = [] if ray else pv.PolyData()
         self.coordinates = _VisualCoordinateSystem() if coordinate_system else None
         self.updated = False
 
     @property
-    def data(self) -> "pv.PolyData":
+    def data(self) -> Union["pv.PolyData", List[_VisualArrow]]:
         """
-        Returns the data of the sensor.
+        Returns the pyvista data of _VisualData.
 
         Returns
         -------
-        pv.PolyData
-            The data of the surface visualization.
+        Union["pv.PolyData", List[_VisualArrow]]
+            The data of the surface visualization if surface data,
+            else List[_VisualArrow] containing ray info.
 
         """
-        return self.__data
+        return self._data
 
     def add_data_triangle(self, triangle_vertices: List[List[float]]) -> None:
         """
@@ -265,7 +334,7 @@ class _VisualData:
                 "triangle_vertices is expected to be composed of 3 vertices with 3 elements each."
             )
         faces = [[3, 0, 1, 2]]
-        self.__data = self.__data.append_polydata(pv.PolyData(triangle_vertices, faces))
+        self._data = self._data.append_polydata(pv.PolyData(triangle_vertices, faces))
 
     def add_data_rectangle(self, rectangle_vertices: List[List[float]]) -> None:
         """
@@ -286,4 +355,68 @@ class _VisualData:
             raise ValueError(
                 "rectangle_vertices is expected to be composed of 3 vertices with 3 elements each."
             )
-        self.__data = self.__data.append_polydata(pv.Rectangle(rectangle_vertices))
+        self._data = self._data.append_polydata(pv.Rectangle(rectangle_vertices))
+
+    def add_data_line(self, line: _VisualArrow) -> None:
+        """
+        Add line data to Visualization data.
+
+        Parameters
+        ----------
+        line: _VisualArrow
+            _VisualArrow presenting one line
+
+        Returns
+        -------
+        None
+        """
+        self._data.append(line)
+
+    def add_data_mesh(self, vertices: np.ndarray, facets: np.ndarray) -> None:
+        """
+        Add mesh data to Visualization data.
+
+        Parameters
+        ----------
+        vertices: numpy.ndarray
+            The vertices of the mesh.
+        facets: numpy.ndarray
+            The facets of the mesh.
+
+        Returns
+        -------
+        None
+        """
+        import pyvista as pv
+
+        if vertices.shape[1] != 3 or facets.shape[1] != 4:
+            raise ValueError(
+                "mesh vertices is expected to be composed of 3 elements each, and 4 for facets."
+            )
+        self._data = self._data.append_polydata(pv.PolyData(vertices, facets))
+
+
+def local2absolute(local_vertice: np.ndarray, coordinates) -> np.ndarray:
+    """Convert local coordinate to global coordinate.
+
+    Parameters
+    ----------
+    coordinates: list
+        local coordinate in shape [1, 9],
+        coordinates[3:6] as x-axis,
+        coordinates[3:6] as y-axis,
+        coordinates[3:6] as z-axis.
+    local_vertice: np.ndarray
+        numpy array includes x, y, z info.
+
+    Returns
+    -------
+    np.ndarray
+        numpy array includes x, y, z info
+
+    """
+    global_origin = np.array(coordinates[:3])
+    global_x = np.array(coordinates[3:6]) * local_vertice[0]
+    global_y = np.array(coordinates[6:9]) * local_vertice[1]
+    global_z = np.array(coordinates[9:]) * local_vertice[2]
+    return global_origin + global_x + global_y + global_z