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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ansys-speos-core
-Version: 0.5.2
+Version: 0.6.1
 Summary: A Python wrapper for Ansys Speos
 Author-email: "ANSYS, Inc." <pyansys.core@ansys.com>
 Maintainer-email: "ANSYS, Inc." <pyansys.core@ansys.com>
@@ -21,13 +21,13 @@ Classifier: Topic :: Scientific/Engineering :: Physics
 Classifier: Topic :: Scientific/Engineering :: Information Analysis
 License-File: LICENSE
 Requires-Dist: protobuf>=3.20,<7
-Requires-Dist: grpcio>=1.50.0,<1.71
+Requires-Dist: grpcio>=1.50.0,<1.75
 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.3
 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: comtypes>=1.4,<1.5; platform_system=='Windows'
+Requires-Dist: ansys-sphinx-theme==1.6.0 ; 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,26 +37,26 @@ 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: jupyter-server==2.16.0 ; extra == "doc"
+Requires-Dist: jupytext==1.17.3 ; extra == "doc"
+Requires-Dist: jupyterlab==4.4.7 ; extra == "doc"
+Requires-Dist: jupyter-server==2.17.0 ; extra == "doc"
 Requires-Dist: nbconvert==7.16.6 ; extra == "doc"
-Requires-Dist: pyvista[jupyter]>=0.43,<0.46 ; extra == "doc"
+Requires-Dist: pyvista[jupyter]>=0.43,<0.47 ; extra == "doc"
 Requires-Dist: ansys-tools-visualization-interface>=0.8.3 ; extra == "doc"
-Requires-Dist: pyvista>=0.40.0,<0.46 ; extra == "graphics"
+Requires-Dist: pyvista>=0.40.0,<0.47 ; extra == "graphics"
 Requires-Dist: ansys-tools-visualization-interface>=0.8.3 ; extra == "graphics"
 Requires-Dist: matplotlib ; extra == "jupyter"
 Requires-Dist: jupyterlab>=3 ; extra == "jupyter"
 Requires-Dist: ipywidgets ; extra == "jupyter"
-Requires-Dist: pyvista[jupyter]>=0.43,<0.46 ; extra == "jupyter"
+Requires-Dist: pyvista[jupyter]>=0.43,<0.47 ; 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.5 ; extra == "jupyter"
 Requires-Dist: psutil==7.0.0 ; extra == "tests"
-Requires-Dist: pytest==8.3.5 ; extra == "tests"
-Requires-Dist: pyvista>=0.40.0,<0.46 ; extra == "tests"
+Requires-Dist: pytest==8.4.2 ; extra == "tests"
+Requires-Dist: pyvista>=0.40.0,<0.47 ; 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.3.0 ; 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
 
@@ -90,7 +102,7 @@ PySpeos library
 
 Project overview
 ----------------
-``PySpeos`` is a Python library that gathers functionalities and tools based on remote API of Ansys software `Speos <https://www.ansys.com/products/optics>`_ .
+``PySpeos`` is a Python library that gathers functionalities and tools based on remote API provided by gRPC server of Ansys software `Speos <https://www.ansys.com/products/optics>`_ .
 
 Installation
 ------------
@@ -98,7 +110,6 @@ Installation can be done using the published `package`_ or the repository `sourc
 
 Package
 ~~~~~~~
-.. warning:: Release is in progress. It might take some time before it becomes available. Until then, please use `Sources`_.
 
 This repository is deployed as the Python packages `ansys-speos-core <https://pypi.org/project/ansys-speos-core>`_.
 As usual, installation is done by running:
@@ -201,12 +212,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.
 
@@ -250,6 +261,33 @@ Use jupyter notebook
 
 jupyter notebook can be downloaded from the documentations example section.
 
+Features
+--------
+
+Information of the latest stable release features:
+
+PySpeos core features
+~~~~~~~~~~~~~~~~~~~~~
+
+Features supported in the latest release can be found at:
+
+* `Optical Materials <https://speos.docs.pyansys.com/version/stable/api/ansys/speos/core/opt_prop/OptProp.html>`_
+* `Light Sources <https://speos.docs.pyansys.com/version/stable/api/ansys/speos/core/source/index.html>`_
+* `Sensors <https://speos.docs.pyansys.com/version/stable/api/ansys/speos/core/sensor/index.html>`_
+* `Simulations <https://speos.docs.pyansys.com/version/stable/api/ansys/speos/core/simulation/index.html>`_
+* `BSDF Viewer <https://speos.docs.pyansys.com/version/stable/api/ansys/speos/core/bsdf/index.html>`_
+* `Light Path Finder <https://speos.docs.pyansys.com/version/stable/api/ansys/speos/core/lxp/LightPathFinder.html>`_
+
+Speos RPC features
+~~~~~~~~~~~~~~~~~~
+
+Speos RPC is based on a gRPC server and provides APIs to interact with Speos solver.
+
+Features supported in the latest Speos RPC can be found at:
+`Ansys Speos for developers Speos RPC <https://developer.ansys.com/docs/speos>`_.
+
+
+
 License
 -------
 `PySpeos`_ is licensed under the MIT license.

{ansys_speos_core-0.5.2 → ansys_speos_core-0.6.1}/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
 
@@ -20,7 +32,7 @@ PySpeos library
 
 Project overview
 ----------------
-``PySpeos`` is a Python library that gathers functionalities and tools based on remote API of Ansys software `Speos <https://www.ansys.com/products/optics>`_ .
+``PySpeos`` is a Python library that gathers functionalities and tools based on remote API provided by gRPC server of Ansys software `Speos <https://www.ansys.com/products/optics>`_ .
 
 Installation
 ------------
@@ -28,7 +40,6 @@ Installation can be done using the published `package`_ or the repository `sourc
 
 Package
 ~~~~~~~
-.. warning:: Release is in progress. It might take some time before it becomes available. Until then, please use `Sources`_.
 
 This repository is deployed as the Python packages `ansys-speos-core <https://pypi.org/project/ansys-speos-core>`_.
 As usual, installation is done by running:
@@ -131,12 +142,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.
 
@@ -180,6 +191,33 @@ Use jupyter notebook
 
 jupyter notebook can be downloaded from the documentations example section.
 
+Features
+--------
+
+Information of the latest stable release features:
+
+PySpeos core features
+~~~~~~~~~~~~~~~~~~~~~
+
+Features supported in the latest release can be found at:
+
+* `Optical Materials <https://speos.docs.pyansys.com/version/stable/api/ansys/speos/core/opt_prop/OptProp.html>`_
+* `Light Sources <https://speos.docs.pyansys.com/version/stable/api/ansys/speos/core/source/index.html>`_
+* `Sensors <https://speos.docs.pyansys.com/version/stable/api/ansys/speos/core/sensor/index.html>`_
+* `Simulations <https://speos.docs.pyansys.com/version/stable/api/ansys/speos/core/simulation/index.html>`_
+* `BSDF Viewer <https://speos.docs.pyansys.com/version/stable/api/ansys/speos/core/bsdf/index.html>`_
+* `Light Path Finder <https://speos.docs.pyansys.com/version/stable/api/ansys/speos/core/lxp/LightPathFinder.html>`_
+
+Speos RPC features
+~~~~~~~~~~~~~~~~~~
+
+Speos RPC is based on a gRPC server and provides APIs to interact with Speos solver.
+
+Features supported in the latest Speos RPC can be found at:
+`Ansys Speos for developers Speos RPC <https://developer.ansys.com/docs/speos>`_.
+
+
+
 License
 -------
 `PySpeos`_ is licensed under the MIT license.

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

@@ -4,7 +4,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "ansys-speos-core"
-version = "0.5.2"
+version = "0.6.1"
 description = "A Python wrapper for Ansys Speos"
 readme = "README.rst"
 requires-python = ">=3.10"
@@ -28,37 +28,37 @@ classifiers=[
 ]
 dependencies=[
     "protobuf>=3.20,<7",
-    "grpcio>=1.50.0,<1.71",
+    "grpcio>=1.50.0,<1.75",
     "grpcio-health-checking>=1.45.0,<1.68",
-    "ansys-api-speos==0.14.2",
+    "ansys-api-speos==0.15.3",
     "ansys-tools-path>=0.3.1",
     "numpy>=1.20.3,<3",
-    "comtypes>=1.4,<1.5",
+    "comtypes>=1.4,<1.5; platform_system=='Windows'",
 ]
 
 [project.optional-dependencies]
 graphics = [
-    "pyvista>=0.40.0,<0.46",
+    "pyvista>=0.40.0,<0.47",
     "ansys-tools-visualization-interface>=0.8.3",
 ]
 tests = [
     "psutil==7.0.0",
-    "pytest==8.3.5",
-    "pyvista>=0.40.0,<0.46",
+    "pytest==8.4.2",
+    "pyvista>=0.40.0,<0.47",
     "ansys-tools-visualization-interface>=0.8.3",
     "ansys-platform-instancemanagement>=1.0.3",
-    "pytest-cov==6.1.1",
+    "pytest-cov==6.3.0",
 ]
 jupyter = [
     "matplotlib",
     "jupyterlab>=3",
     "ipywidgets",
-    "pyvista[jupyter]>=0.43,<0.46",
+    "pyvista[jupyter]>=0.43,<0.47",
     "ansys-tools-visualization-interface>=0.8.3",
-    "notebook==7.4.2",
+    "notebook==7.4.5",
 ]
 doc = [
-    "ansys-sphinx-theme==1.4.4",
+    "ansys-sphinx-theme==1.6.0",
     "numpydoc==1.8.0",
     "Sphinx==8.1.3",
     "sphinx-copybutton==0.5.2",
@@ -68,11 +68,11 @@ doc = [
     "sphinxcontrib-mermaid==1.0.0",
     "myst-parser==4.0.1",
     "nbsphinx==0.9.7",
-    "jupytext==1.17.1",
-    "jupyterlab==4.4.2",
-    "jupyter-server==2.16.0",
+    "jupytext==1.17.3",
+    "jupyterlab==4.4.7",
+    "jupyter-server==2.17.0",
     "nbconvert==7.16.6",
-    "pyvista[jupyter]>=0.43,<0.46",
+    "pyvista[jupyter]>=0.43,<0.47",
     "ansys-tools-visualization-interface>=0.8.3",
 ]
 

{ansys_speos_core-0.5.2 → ansys_speos_core-0.6.1}/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.1}/src/ansys/speos/core/generic/constants.py

@@ -28,7 +28,7 @@ DEFAULT_HOST: str = "localhost"
 """Default host used by Speos RPC server and client """
 DEFAULT_PORT: str = "50098"
 """Default port used by Speos RPC server and client """
-DEFAULT_VERSION: str = "251"
+DEFAULT_VERSION: str = "252"
 """Latest supported Speos version of the current PySpeos Package"""
 MAX_SERVER_MESSAGE_LENGTH: int = int(os.environ.get("SPEOS_MAX_MESSAGE_LENGTH", 256 * 1024**2))
 """Maximum message length value accepted by the Speos RPC server,

{ansys_speos_core-0.5.2 → ansys_speos_core-0.6.1}/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