ansys-mechanical-core 0.11.7__tar.gz → 0.11.9__tar.gz

{ansys_mechanical_core-0.11.7 → ansys_mechanical_core-0.11.9}/PKG-INFO

@@ -1,23 +1,23 @@
 Metadata-Version: 2.1
 Name: ansys-mechanical-core
-Version: 0.11.7
+Version: 0.11.9
 Summary: A python wrapper for Ansys Mechanical
 Keywords: pymechanical,mechanical,ansys,pyansys
 Author-email: "ANSYS, Inc." <pyansys.core@ansys.com>
 Maintainer-email: "ANSYS, Inc." <pyansys.core@ansys.com>
-Requires-Python: >=3.9,<4.0
+Requires-Python: >=3.10,<4.0
 Description-Content-Type: text/x-rst
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Science/Research
 Classifier: Topic :: Scientific/Engineering :: Information Analysis
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Requires-Dist: ansys-api-mechanical==0.1.2
-Requires-Dist: ansys-mechanical-env==0.1.7
+Requires-Dist: ansys-mechanical-env==0.1.8
+Requires-Dist: ansys-mechanical-stubs==0.1.4
 Requires-Dist: ansys-platform-instancemanagement>=1.0.1
 Requires-Dist: ansys-pythonnet>=3.1.0rc2
 Requires-Dist: ansys-tools-path>=0.3.1
@@ -26,37 +26,40 @@ Requires-Dist: click>=8.1.3
 Requires-Dist: clr-loader==0.2.6
 Requires-Dist: grpcio>=1.30.0
 Requires-Dist: protobuf>=3.12.2,<6
+Requires-Dist: psutil==6.1.0
 Requires-Dist: tqdm>=4.45.0
-Requires-Dist: sphinx==8.0.2 ; extra == "doc"
-Requires-Dist: ansys-sphinx-theme[autoapi]==1.0.7 ; extra == "doc"
-Requires-Dist: grpcio==1.66.0 ; extra == "doc"
+Requires-Dist: requests>=2,<3
+Requires-Dist: sphinx==8.1.3 ; extra == "doc"
+Requires-Dist: ansys-sphinx-theme[autoapi]==1.1.7 ; extra == "doc"
+Requires-Dist: grpcio==1.67.0 ; extra == "doc"
 Requires-Dist: imageio-ffmpeg==0.5.1 ; extra == "doc"
-Requires-Dist: imageio==2.35.1 ; extra == "doc"
+Requires-Dist: imageio==2.36.0 ; extra == "doc"
 Requires-Dist: jupyter_sphinx==0.5.3 ; extra == "doc"
 Requires-Dist: jupyterlab>=3.2.8 ; extra == "doc"
 Requires-Dist: matplotlib==3.9.2 ; extra == "doc"
-Requires-Dist: numpy==2.1.0 ; extra == "doc"
+Requires-Dist: numpy==2.1.2 ; extra == "doc"
 Requires-Dist: numpydoc==1.8.0 ; extra == "doc"
-Requires-Dist: pandas==2.2.2 ; extra == "doc"
-Requires-Dist: panel==1.4.5 ; extra == "doc"
-Requires-Dist: plotly==5.23.0 ; extra == "doc"
-Requires-Dist: pypandoc==1.13 ; extra == "doc"
+Requires-Dist: pandas==2.2.3 ; extra == "doc"
+Requires-Dist: panel==1.5.3 ; extra == "doc"
+Requires-Dist: plotly==5.24.1 ; extra == "doc"
+Requires-Dist: pypandoc==1.14 ; extra == "doc"
 Requires-Dist: pytest-sphinx==0.6.3 ; extra == "doc"
 Requires-Dist: pythreejs==2.4.2 ; extra == "doc"
 Requires-Dist: pyvista>=0.39.1 ; extra == "doc"
-Requires-Dist: sphinx-autobuild==2024.4.16 ; extra == "doc"
-Requires-Dist: sphinx-autodoc-typehints==2.2.3 ; extra == "doc"
+Requires-Dist: sphinx-autobuild==2024.10.3 ; extra == "doc"
+Requires-Dist: sphinx-autodoc-typehints==2.5.0 ; extra == "doc"
 Requires-Dist: sphinx-copybutton==0.5.2 ; extra == "doc"
 Requires-Dist: sphinx_design==0.6.1 ; extra == "doc"
-Requires-Dist: sphinx-gallery==0.17.1 ; extra == "doc"
+Requires-Dist: sphinx-gallery==0.18.0 ; extra == "doc"
 Requires-Dist: sphinx-notfound-page==1.0.4 ; extra == "doc"
 Requires-Dist: sphinxcontrib-websupport==2.0.0 ; extra == "doc"
 Requires-Dist: sphinxemoji==0.3.1 ; extra == "doc"
-Requires-Dist: pytest==8.3.2 ; extra == "tests"
+Requires-Dist: pytest==8.3.3 ; extra == "tests"
 Requires-Dist: pytest-cov==5.0.0 ; extra == "tests"
-Requires-Dist: pytest-print==1.0.0 ; extra == "tests"
+Requires-Dist: pytest-print==1.0.2 ; extra == "tests"
+Requires-Dist: psutil==6.1.0 ; extra == "tests"
 Requires-Dist: ansys-tools-visualization-interface>=0.2.6 ; extra == "viz"
-Requires-Dist: usd-core==24.8 ; extra == "viz"
+Requires-Dist: usd-core==24.11 ; extra == "viz"
 Project-URL: Changelog, https://mechanical.docs.pyansys.com/version/stable/changelog.html
 Project-URL: Documentation, https://mechanical.docs.pyansys.com
 Project-URL: Homepage, https://github.com/ansys/pymechanical

{ansys_mechanical_core-0.11.7 → ansys_mechanical_core-0.11.9}/pyproject.toml

@@ -5,10 +5,10 @@ build-backend = "flit_core.buildapi"
 [project]
 # Check https://flit.readthedocs.io/en/latest/pyproject_toml.html for all available sections
 name = "ansys-mechanical-core"
-version = "0.11.7"
+version = "0.11.9"
 description = "A python wrapper for Ansys Mechanical"
 readme = "README.rst"
-requires-python = ">=3.9,<4.0"
+requires-python = ">=3.10,<4.0"
 license = {file = "LICENSE"}
 authors = [{name = "ANSYS, Inc.", email = "pyansys.core@ansys.com"}]
 maintainers = [{name = "ANSYS, Inc.", email = "pyansys.core@ansys.com"}]
@@ -18,7 +18,6 @@ classifiers = [
     "Development Status :: 4 - Beta",
     'Intended Audience :: Science/Research',
     'Topic :: Scientific/Engineering :: Information Analysis',
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -27,7 +26,8 @@ classifiers = [
 ]
 dependencies = [
     "ansys-api-mechanical==0.1.2",
-    "ansys-mechanical-env==0.1.7",
+    "ansys-mechanical-env==0.1.8",
+    "ansys-mechanical-stubs==0.1.4",
     "ansys-platform-instancemanagement>=1.0.1",
     "ansys-pythonnet>=3.1.0rc2",
     "ansys-tools-path>=0.3.1",
@@ -36,7 +36,9 @@ dependencies = [
     "clr-loader==0.2.6",
     "grpcio>=1.30.0",
     "protobuf>=3.12.2,<6",
+    "psutil==6.1.0",
     "tqdm>=4.45.0",
+    "requests>=2,<3",
 ]
 
 [project.urls]
@@ -48,44 +50,46 @@ Changelog = "https://mechanical.docs.pyansys.com/version/stable/changelog.html"
 
 [project.optional-dependencies]
 tests = [
-    "pytest==8.3.2",
+    "pytest==8.3.3",
     "pytest-cov==5.0.0",
-    "pytest-print==1.0.0",
+    "pytest-print==1.0.2",
+    "psutil==6.1.0"
 ]
 doc = [
-    "sphinx==8.0.2",
-    "ansys-sphinx-theme[autoapi]==1.0.7",
-    "grpcio==1.66.0",
+    "sphinx==8.1.3",
+    "ansys-sphinx-theme[autoapi]==1.1.7",
+    "grpcio==1.67.0",
     "imageio-ffmpeg==0.5.1",
-    "imageio==2.35.1",
+    "imageio==2.36.0",
     "jupyter_sphinx==0.5.3",
     "jupyterlab>=3.2.8",
     "matplotlib==3.9.2",
-    "numpy==2.1.0",
+    "numpy==2.1.2",
     "numpydoc==1.8.0",
-    "pandas==2.2.2",
-    "panel==1.4.5",
-    "plotly==5.23.0",
-    "pypandoc==1.13",
+    "pandas==2.2.3",
+    "panel==1.5.3",
+    "plotly==5.24.1",
+    "pypandoc==1.14",
     "pytest-sphinx==0.6.3",
     "pythreejs==2.4.2",
     "pyvista>=0.39.1",
-    "sphinx-autobuild==2024.4.16",
-    "sphinx-autodoc-typehints==2.2.3",
+    "sphinx-autobuild==2024.10.3",
+    "sphinx-autodoc-typehints==2.5.0",
     "sphinx-copybutton==0.5.2",
     "sphinx_design==0.6.1",
-    "sphinx-gallery==0.17.1",
+    "sphinx-gallery==0.18.0",
     "sphinx-notfound-page==1.0.4",
     "sphinxcontrib-websupport==2.0.0",
     "sphinxemoji==0.3.1",
 ]
 viz = [
     "ansys-tools-visualization-interface>=0.2.6",
-    "usd-core==24.8",
+    "usd-core==24.11",
 ]
 
 [project.scripts]
 ansys-mechanical = "ansys.mechanical.core.run:cli"
+ansys-mechanical-ideconfig = "ansys.mechanical.core.ide_config:cli"
 
 [tool.flit.module]
 name = "ansys.mechanical.core"
@@ -138,6 +142,7 @@ markers = [
     "remote_session_launch: tests that launch Mechanical and work with gRPC server inside it",
     "remote_session_connect: tests that connect to Mechanical and work with gRPC server inside it",
     "minimum_version(num): tests that run if ansys-version is greater than or equal to the minimum version provided",
+    "version_range(min_revn,max_revn): tests that run if ansys-version is in the range of the minimum and maximum revision numbers inclusive.",
     "windows_only: tests that run if the testing platform is on Windows",
     "linux_only: tests that run if the testing platform is on Linux",
     "cli: tests for the Command Line Interface",
@@ -207,7 +212,7 @@ legacy_tox_ini = """
 [tox]
 description = Default tox environments list
 envlist =
-    style,{py39,py310,py311,py312}{,-coverage},doc
+    style,{py310,py311,py312}{,-coverage},doc
 passenv =  AWP_ROOT
 skip_missing_interpreters = true
 isolated_build = true
@@ -216,7 +221,6 @@ isolated_build_env = build
 [gh-actions]
 description = The tox environment to be executed in gh-actions for a given python version
 python =
-    3.9: style,py39-coverage,doc
     3.10: style,py310-coverage,doc
     3.11: style,py311-coverage,doc
     3.12: style,py311-coverage,doc
@@ -224,7 +228,6 @@ python =
 [testenv]
 description = Checks for project unit tests and coverage (if desired)
 basepython =
-    py39: python3.9
     py310: python3.10
     py311: python3.11
     py312: python3.12

{ansys_mechanical_core-0.11.7 → ansys_mechanical_core-0.11.9}/src/ansys/mechanical/core/embedding/addins.py

@@ -52,9 +52,3 @@ class AddinConfiguration:
     @addin_configuration.setter
     def addin_configuration(self, value: str):
         self._addin_configuration = value
-
-
-def configure(configuration: AddinConfiguration):
-    """Apply the given configuration."""
-    if configuration.no_act_addins:
-        os.environ["ANSYS_MECHANICAL_STANDALONE_NO_ACT_EXTENSIONS"] = "1"

{ansys_mechanical_core-0.11.7 → ansys_mechanical_core-0.11.9}/src/ansys/mechanical/core/embedding/app.py

@@ -21,8 +21,11 @@
 # SOFTWARE.
 
 """Main application class for embedded Mechanical."""
+from __future__ import annotations
+
 import atexit
 import os
+import shutil
 import typing
 import warnings
 
@@ -31,15 +34,20 @@ from ansys.mechanical.core.embedding.addins import AddinConfiguration
 from ansys.mechanical.core.embedding.appdata import UniqueUserProfile
 from ansys.mechanical.core.embedding.imports import global_entry_points, global_variables
 from ansys.mechanical.core.embedding.poster import Poster
+from ansys.mechanical.core.embedding.ui import launch_ui
 from ansys.mechanical.core.embedding.warnings import connect_warnings, disconnect_warnings
 
+if typing.TYPE_CHECKING:
+    # Make sure to run ``ansys-mechanical-ideconfig`` to add the autocomplete settings to VS Code
+    # Run ``ansys-mechanical-ideconfig --help`` for more information
+    import Ansys  # pragma: no cover
+
 try:
     import ansys.tools.visualization_interface  # noqa: F401
 
     HAS_ANSYS_VIZ = True
     """Whether or not PyVista exists."""
 except:
-
     HAS_ANSYS_VIZ = False
 
 
@@ -187,10 +195,45 @@ class App:
         else:
             self.DataModel.Project.Save()
 
-    def save_as(self, path):
-        """Save the project as."""
+    def save_as(self, path: str, overwrite: bool = False):
+        """Save the project as a new file.
+
+        If the `overwrite` flag is enabled, the current saved file is temporarily moved
+        to a backup location. The new file is then saved in its place. If the process fails,
+        the backup file is restored to its original location.
+
+        Parameters
+        ----------
+        path: int, optional
+            The path where file needs to be saved.
+        overwrite: bool, optional
+            Whether the file should be overwritten if it already exists (default is False).
+        """
+        if not os.path.exists(path):
+            self.DataModel.Project.SaveAs(path)
+            return
+
+        if not overwrite:
+            raise Exception(
+                f"File already exists in {path}, Use ``overwrite`` flag to "
+                "replace the existing file."
+            )
+
+        file_name = os.path.basename(path)
+        file_dir = os.path.dirname(path)
+        associated_dir = os.path.join(file_dir, os.path.splitext(file_name)[0] + "_Mech_Files")
+
+        # Remove existing files and associated folder
+        os.remove(path)
+        if os.path.exists(associated_dir):
+            shutil.rmtree(associated_dir)
+        # Save the new file
         self.DataModel.Project.SaveAs(path)
 
+    def launch_gui(self, delete_tmp_on_close: bool = True, dry_run: bool = False):
+        """Launch the GUI."""
+        launch_ui(self, delete_tmp_on_close, dry_run)
+
     def new(self):
         """Clear to a new application."""
         self.DataModel.Project.New()
@@ -227,7 +270,21 @@ class App:
         light_mode = True
         args = None
         rets = None
-        return self.script_engine.ExecuteCode(script, SCRIPT_SCOPE, light_mode, args, rets)
+        script_result = self.script_engine.ExecuteCode(script, SCRIPT_SCOPE, light_mode, args, rets)
+        error_msg = f"Failed to execute the script"
+        if script_result is None:
+            raise Exception(error_msg)
+        if script_result.Error is not None:
+            error_msg += f": {script_result.Error.Message}"
+            raise Exception(error_msg)
+        return script_result.Value
+
+    def execute_script_from_file(self, file_path=None):
+        """Execute the given script from file with the internal IronPython engine."""
+        text_file = open(file_path, "r", encoding="utf-8")
+        data = text_file.read()
+        text_file.close()
+        return self.execute_script(data)
 
     def plotter(self) -> None:
         """Return ``ansys.tools.visualization_interface.Plotter`` object."""
@@ -273,22 +330,22 @@ class App:
         return GetterWrapper(self._app, lambda app: app.DataModel)
 
     @property
-    def ExtAPI(self):
+    def ExtAPI(self) -> Ansys.ACT.Interfaces.Mechanical.IMechanicalExtAPI:
         """Return the ExtAPI object."""
         return GetterWrapper(self._app, lambda app: app.ExtAPI)
 
     @property
-    def Tree(self):
+    def Tree(self) -> Ansys.ACT.Automation.Mechanical.Tree:
         """Return the Tree object."""
         return GetterWrapper(self._app, lambda app: app.DataModel.Tree)
 
     @property
-    def Model(self):
+    def Model(self) -> Ansys.ACT.Automation.Mechanical.Model:
         """Return the Model object."""
         return GetterWrapper(self._app, lambda app: app.DataModel.Project.Model)
 
     @property
-    def Graphics(self):
+    def Graphics(self) -> Ansys.ACT.Common.Graphics.MechanicalGraphicsWrapper:
         """Return the Graphics object."""
         return GetterWrapper(self._app, lambda app: app.ExtAPI.Graphics)
 

{ansys_mechanical_core-0.11.7 → ansys_mechanical_core-0.11.9}/src/ansys/mechanical/core/embedding/background.py

@@ -59,9 +59,8 @@ class BackgroundApp:
                 time.sleep(0.05)
                 continue
         else:
-            assert (
-                not BackgroundApp.__stopped
-            ), "Cannot initialize a BackgroundApp once it has been stopped!"
+            if BackgroundApp.__stopped:
+                raise RuntimeError("Cannot initialize a BackgroundApp once it has been stopped!")
 
             def new():
                 BackgroundApp.__app.new()
@@ -80,7 +79,8 @@ class BackgroundApp:
 
     def post(self, callable: typing.Callable):
         """Post callable method to the background app thread."""
-        assert not BackgroundApp.__stopped, "Cannot use background app after stopping it."
+        if BackgroundApp.__stopped:
+            raise RuntimeError("Cannot use BackgroundApp after stopping it.")
         return BackgroundApp.__poster.post(callable)
 
     def stop(self) -> None:
@@ -102,5 +102,5 @@ class BackgroundApp:
             try:
                 utils.sleep(40)
             except:
-                pass
+                raise Exception("BackgroundApp cannot sleep.")  # pragma: no cover
         BackgroundApp.__stopped = True

ansys_mechanical_core-0.11.9/src/ansys/mechanical/core/embedding/cleanup_gui.py

@@ -0,0 +1,61 @@
+# Copyright (C) 2022 - 2024 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+"""Clean up temporary mechdb files after GUI is closed."""
+
+from pathlib import Path
+import shutil
+import sys
+import time
+
+import psutil
+
+
+def cleanup_gui(pid, temp_mechdb) -> None:
+    """Remove the temporary mechdb file after it is closed.
+
+    Parameters
+    ----------
+    pid: int
+        The process ID of the open temporary mechdb file.
+    temp_mechdb: Path
+        The path of the temporary mechdb file.
+    """
+    # While the pid exists, sleep
+    while psutil.pid_exists(pid):
+        time.sleep(1)
+
+    # Delete the temporary mechdb file once the GUI is closed
+    temp_mechdb.unlink()
+
+    # Delete the temporary mechdb Mech_Files folder
+    temp_folder_path = temp_mechdb.parent / f"{temp_mechdb.name.split('.')[0]}_Mech_Files"
+    shutil.rmtree(temp_folder_path)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    """Get the process ID and temporary file path to monitor and delete files after use."""
+    # Convert the process id (pid) argument into an integer
+    pid = int(sys.argv[1])
+    # Convert the temporary mechdb path into a Path
+    temp_mechdb_path = Path(sys.argv[2])
+    # Remove the temporary mechdb file when the GUI is closed
+    cleanup_gui(pid, temp_mechdb_path)

{ansys_mechanical_core-0.11.7 → ansys_mechanical_core-0.11.9}/src/ansys/mechanical/core/embedding/initializer.py

@@ -28,15 +28,13 @@ import platform
 import sys
 import warnings
 
-import ansys.tools.path as atp
-
 from ansys.mechanical.core.embedding.loader import load_clr
 from ansys.mechanical.core.embedding.resolver import resolve
 
 INITIALIZED_VERSION = None
 """Constant for the initialized version."""
 
-SUPPORTED_MECHANICAL_EMBEDDING_VERSIONS_WINDOWS = {242: "2024R2", 241: "2024R1", 232: "2023R2"}
+SUPPORTED_MECHANICAL_EMBEDDING_VERSIONS = {242: "2024R2", 241: "2024R1", 232: "2023R2"}
 """Supported Mechanical embedding versions on Windows."""
 
 
@@ -59,48 +57,68 @@ def __workaround_material_server(version: int) -> None:
         os.environ["ENGRDATA_SERVER_SERIAL"] = "1"
 
 
-def _get_default_linux_version() -> int:
-    """Try to get the active linux version from the environment.
+def __check_for_supported_version(version) -> None:
+    """Check if Mechanical version is supported with current version of PyMechanical.
 
-    On linux, embedding is only possible by setting environment variables before starting python.
-    The version will then be fixed  to a specific version, based on those env vars.
-    The documented way to set those variables is to run python using the ``mechanical-env`` script,
-    which can be used after installing the ``ansys-mechanical-env`` package with this command:
-    ``pip install ansys-mechanical-env``. The script takes user input of a version. If the user
-    does not provide a version, the ``find_mechanical()`` function from the ``ansys-tools-path``
-    package is used to find a version of Mechanical.
+    If specific environment variable is enabled, then users can overwrite the supported versions.
+    However, using unsupported versions may cause issues.
     """
-    supported_versions = [232, 241, 242]
-    awp_roots = {ver: os.environ.get(f"AWP_ROOT{ver}", "") for ver in supported_versions}
-    installed_versions = {
-        ver: path for ver, path in awp_roots.items() if path and os.path.isdir(path)
-    }
-    assert len(installed_versions) == 1, "multiple AWP_ROOT environment variables found!"
-    return next(iter(installed_versions))
+    allow_old_version = os.getenv("ANSYS_MECHANICAL_EMBEDDING_SUPPORT_OLD_VERSIONS") == "1"
+
+    # Check if the version is supported
+    if not allow_old_version and version < min(SUPPORTED_MECHANICAL_EMBEDDING_VERSIONS):
+        raise ValueError(f"Mechanical version {version} is not supported.")
+
+    return version
 
 
-def _get_default_version() -> int:
-    if os.name == "posix":
-        return _get_default_linux_version()
+def _get_latest_default_version() -> int:
+    """Try to get the latest Mechanical version from the environment.
+
+    Checks if multiple versions of Mechanical found in system.
+    For Linux it will be only one since ``mechanical-env`` takes care of that.
+    If multiple versions are detected, select the latest one, as no specific version is provided.
+    """
+    awp_roots = [value for key, value in os.environ.items() if key.startswith("AWP_ROOT")]
+
+    if not awp_roots:
+        raise Exception("No Mechanical installations found.")
 
-    if os.name != "nt":  # pragma: no cover
-        raise Exception("Unexpected platform!")
+    versions_found = []
+    for path in awp_roots:
+        folder = os.path.basename(os.path.normpath(path))
+        version = folder.split("v")[-1]
+        versions_found.append(int(version))
+    latest_version = max(versions_found)
 
-    _, version = atp.find_mechanical(
-        supported_versions=SUPPORTED_MECHANICAL_EMBEDDING_VERSIONS_WINDOWS
-    )
+    if len(awp_roots) > 1:
+        warnings.warn(
+            f"Multiple versions of Mechanical found! Using latest version {latest_version} ..."
+        )
 
-    # version is of the form 23.2
-    int_version = int(str(version).replace(".", ""))
-    return int_version
+    return latest_version
 
 
-def __check_python_interpreter_architecture():
+def __check_python_interpreter_architecture() -> None:
     """Embedding support only 64 bit architecture."""
     if platform.architecture()[0] != "64bit":
         raise Exception("Mechanical Embedding requires a 64-bit Python environment.")
 
 
+def __set_environment(version: int) -> None:
+    """Set environment variables to configure embedding."""
+    if os.name == "nt":  # pragma: no cover
+        if version < 251:
+            os.environ["MECHANICAL_STARTUP_UNOPTIMIZED"] = "1"
+
+    # Set an environment variable to use the custom CLR host
+    # for embedding.
+    # In the future (>251), it would always be used.
+    if version == 251:
+        if "PYMECHANICAL_NO_CLR_HOST_LITE" not in os.environ:
+            os.environ["ANSYS_MECHANICAL_EMBEDDING_CLR_HOST"] = "1"
+
+
 def __check_for_mechanical_env():
     """Embedding in linux platform must use mechanical-env."""
     if platform.system() == "Linux" and os.environ.get("PYMECHANICAL_EMBEDDING") != "TRUE":
@@ -113,21 +131,60 @@ def __check_for_mechanical_env():
         )
 
 
+def __is_lib_loaded(libname: str):  # pragma: no cover
+    """Return whether a library is loaded."""
+    import ctypes
+
+    RTLD_NOLOAD = 4
+    try:
+        ctypes.CDLL(libname, RTLD_NOLOAD)
+    except:
+        return False
+    return True
+
+
+def __check_loaded_libs(version: int = None):  # pragma: no cover
+    """Ensure that incompatible libraries aren't loaded prior to PyMechanical load."""
+    if platform.system() != "Linux":
+        return
+
+    if version < 251:
+        return
+
+    # For 2025 R1, PyMechanical will crash on shutdown if libX11.so is already loaded
+    # before starting Mechanical
+    if __is_lib_loaded("libX11.so"):
+        warnings.warn(
+            "libX11.so is loaded prior to initializing the Embedded Instance of Mechanical.\
+                      Python will crash on shutdown..."
+        )
+
+
 def initialize(version: int = None):
     """Initialize Mechanical embedding."""
     __check_python_interpreter_architecture()  # blocks 32 bit python
     __check_for_mechanical_env()  # checks for mechanical-env in linux embedding
 
     global INITIALIZED_VERSION
-    if INITIALIZED_VERSION != None:
-        assert INITIALIZED_VERSION == version
+    if INITIALIZED_VERSION is not None:
+        if INITIALIZED_VERSION != version:
+            raise ValueError(
+                f"Initialized version {INITIALIZED_VERSION} "
+                f"does not match the expected version {version}."
+            )
         return
 
     if version == None:
-        version = _get_default_version()
+        version = _get_latest_default_version()
+
+    version = __check_for_supported_version(version=version)
 
     INITIALIZED_VERSION = version
 
+    __set_environment(version)
+
+    __check_loaded_libs(version)
+
     __workaround_material_server(version)
 
     # need to add system path in order to import the assembly with the resolver