ansys-fluent-core 0.28.2__py3-none-any.whl → 0.29.0__py3-none-any.whl

ansys/fluent/core/get_build_details.py

@@ -1,3 +1,25 @@
+# Copyright (C) 2021 - 2025 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.
+
 """Get the git build info."""
 
 from collections import OrderedDict

ansys/fluent/core/journaling.py

@@ -1,6 +1,38 @@
+# Copyright (C) 2021 - 2025 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.
+
 """A module for controlling the writing of Fluent Python journals."""
 
 
+class PythonJournalNotSupported(RuntimeError):
+    """Raised when Python journal is unsupported."""
+
+    def __init__(self):
+        """Initialize PythonJournalNotSupported."""
+        super().__init__(
+            "Python journaling is available in Fluent version 2023 R1 or later."
+        )
+
+
 class Journal:
     """Control the writing of Fluent Python journals."""
 
@@ -8,10 +40,16 @@ class Journal:
         """__init__ method of Journal class."""
         self._app_utilities = app_utilities
 
+    def _check_python_journaling_support(self):
+        if self._app_utilities.get_product_version() == "22.2.0":
+            raise PythonJournalNotSupported()
+
     def start(self, file_name: str):
         """Start writing a Fluent Python journal at the specified file_name."""
+        self._check_python_journaling_support()
         self._app_utilities.start_python_journal(journal_name=file_name)
 
     def stop(self):
         """Stop writing the Fluent Python journal."""
+        self._check_python_journaling_support()
         self._app_utilities.stop_python_journal()

ansys/fluent/core/launcher/__init__.py

@@ -1,3 +1,25 @@
+# Copyright (C) 2021 - 2025 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.
+
 """Public objects and functions under launcher."""
 
 from ..utils.fluent_version import FluentVersion  # noqa: F401

ansys/fluent/core/launcher/container_launcher.py

@@ -1,3 +1,25 @@
+# Copyright (C) 2021 - 2025 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.
+
 """Provides a module for launching Fluent in container mode.
 
 Examples
@@ -57,7 +79,7 @@ class DockerLauncher:
         precision: Precision | str | None = None,
         processor_count: int | None = None,
         start_timeout: int = 60,
-        additional_arguments: str | None = "",
+        additional_arguments: str = "",
         container_dict: dict | None = None,
         dry_run: bool = False,
         cleanup_on_exit: bool = True,
@@ -67,76 +89,63 @@ class DockerLauncher:
         start_watchdog: bool | None = None,
         file_transfer_service: Any | None = None,
     ):
-        """Launch Fluent session in container mode.
+        """
+        Launch a Fluent session in container mode.
 
         Parameters
         ----------
         mode : FluentMode
-            Launch mode of Fluent to point to a specific session type.
+            Specifies the launch mode of Fluent to target a specific session type.
         ui_mode : UIMode
-            Fluent user interface mode. Options are the values of the ``UIMode`` enum.
+            Defines the user interface mode for Fluent. Options correspond to values in the ``UIMode`` enum.
         graphics_driver : FluentWindowsGraphicsDriver or FluentLinuxGraphicsDriver
-            Graphics driver of Fluent. Options are the values of the
-            ``FluentWindowsGraphicsDriver`` enum in Windows or the values of the
-            ``FluentLinuxGraphicsDriver`` enum in Linux.
-        product_version : FluentVersion or str or float or int, optional
-            Version of Ansys Fluent to launch. To use Fluent version 2024 R2, pass
-            any of ``FluentVersion.v242``, ``"24.2.0"``, ``"24.2"``, ``24.2``, or ``242``.
-            The default is ``None``, in which case the newest installed version is used.
+            Specifies the graphics driver for Fluent. Options are from the ``FluentWindowsGraphicsDriver`` enum
+            (for Windows) or the ``FluentLinuxGraphicsDriver`` enum (for Linux).
+        product_version :  FluentVersion or str or float or int, optional
+            Indicates the version of Ansys Fluent to launch. For example, to use version 2025 R1, pass
+            any of ``FluentVersion.v251``, ``"25.1.0"``, ``"25.1"``, ``25.1``, or ``251``. Defaults to ``None``,
+            which uses the newest installed version.
         dimension : Dimension or int, optional
-            Geometric dimensionality of the Fluent simulation. The default is ``None``,
-            in which case ``Dimension.THREE`` is used. Options are either the values of the
-            ``Dimension`` enum (``Dimension.TWO`` or ``Dimension.THREE``) or any of ``2`` and ``3``.
+            Specifies the geometric dimensionality of the Fluent simulation. Defaults to ``None``,
+            which corresponds to ``Dimension.THREE``. Acceptable values include ``Dimension.TWO``,
+            ``Dimension.THREE``, or integers ``2`` and ``3``.
         precision : Precision or str, optional
-            Floating point precision. The default is ``None``, in which case ``Precision.DOUBLE``
-            is used. Options are either the values of the ``Precision`` enum (``Precision.SINGLE``
-            or ``Precision.DOUBLE``) or any of ``"double"`` and ``"single"``.
+            Defines the floating point precision. Defaults to ``None``, which corresponds to
+            ``Precision.DOUBLE``. Acceptable values include ``Precision.SINGLE``,
+            ``Precision.DOUBLE``, or strings ``"single"`` and ``"double"``.
         processor_count : int, optional
-            Number of processors. The default is ``None``, in which case ``1``
-            processor is used.  In job scheduler environments the total number of
-            allocated cores is clamped to value of ``processor_count``.
+            Specifies the number of processors to use. Defaults to ``None``, which uses 1 processor.
+            In job scheduler environments, this value limits the total number of allocated cores.
         start_timeout : int, optional
-            Maximum allowable time in seconds for connecting to the Fluent
-            server. The default is ``60``.
+            Maximum allowable time in seconds for connecting to the Fluent server. Defaults to 60 seconds.
         additional_arguments : str, optional
-            Additional arguments to send to Fluent as a string in the same
-            format they are normally passed to Fluent on the command line.
+            Additional command-line arguments for Fluent, formatted as they would be on the command line.
         container_dict : dict, optional
-            Dictionary for Fluent Docker container configuration. The configuration settings specified in this
-            dictionary are used to launch Fluent inside a Docker container.
-            See also :mod:`~ansys.fluent.core.launcher.fluent_container`.
+            Configuration dictionary for launching Fluent inside a Docker container. See also
+            :mod:`~ansys.fluent.core.launcher.fluent_container`.
         dry_run : bool, optional
-            Defaults to False. If True, will not launch Fluent, and will instead print configuration information
-            that would be used as if Fluent was being launched. If dry running a container start,
-            ``launch_fluent()`` will return the configured ``container_dict``.
-        cleanup_on_exit : bool, optional
-            Whether to shut down the connected Fluent session when PyFluent is
-            exited, or the ``exit()`` method is called on the session instance,
-            or if the session instance becomes unreferenced. The default is ``True``.
-        start_transcript : bool, optional
-            Whether to start streaming the Fluent transcript in the client. The
-            default is ``True``. You can stop and start the streaming of the
-            Fluent transcript subsequently via the method calls, ``transcript.start()``
-            and ``transcript.stop()`` on the session object.
+            If True, does not launch Fluent but prints configuration information instead. If dry running a
+            container start, this method will return the configured ``container_dict``. Defaults to False.
+        cleanup_on_exit : bool
+            Determines whether to shut down the connected Fluent session upon exit or when calling
+            the session's `exit()` method. Defaults to True.
+        start_transcript : bool
+            Indicates whether to start streaming the Fluent transcript in the client. Defaults to True;
+            streaming can be controlled via `transcript.start()` and `transcript.stop()` methods on the session object.
         py : bool, optional
-            If True, Fluent will run in Python mode. Default is None.
+            If True, runs Fluent in Python mode. Defaults to None.
         gpu : bool, optional
-            If True, Fluent will start with GPU Solver.
+            If True, starts Fluent with GPU Solver enabled.
         start_watchdog : bool, optional
-            When ``cleanup_on_exit`` is True, ``start_watchdog`` defaults to True,
-            which means an independent watchdog process is run to ensure
-            that any local GUI-less Fluent sessions started by PyFluent are properly closed (or killed if frozen)
-            when the current Python process ends.
-        file_transfer_service : optional
-            File transfer service. Uploads/downloads files to/from the server.
+            If True and `cleanup_on_exit` is True, an independent watchdog process is run to ensure that any local
+            GUI-less Fluent sessions started by PyFluent are properly closed when the current Python process ends.
+        file_transfer_service : Any, optional
+            Service for uploading/downloading files to/from the server.
 
         Returns
         -------
-        :obj:`~typing.Union` [:class:`Meshing<ansys.fluent.core.session_meshing.Meshing>`, \
-        :class:`~ansys.fluent.core.session_pure_meshing.PureMeshing`, \
-        :class:`~ansys.fluent.core.session_solver.Solver`, \
-        :class:`~ansys.fluent.core.session_solver_icing.SolverIcing`, dict]
-            Session object or configuration dictionary if ``dry_run = True``.
+        Meshing | PureMeshing | Solver | SolverIcing | dict
+            Session object or configuration dictionary if ``dry_run`` is True.
 
         Raises
         ------
@@ -145,9 +154,8 @@ class DockerLauncher:
 
         Notes
         -----
-        Job scheduler environments such as SLURM, LSF, PBS, etc. allocates resources / compute nodes.
-        The allocated machines and core counts are queried from the scheduler environment and
-        passed to Fluent.
+        In job scheduler environments (e.g., SLURM, LSF, PBS), resources and compute nodes are allocated,
+        and core counts are queried from these environments before being passed to Fluent.
         """
         self.argvals, self.new_session = _get_argvals_and_session(locals().copy())
         if self.argvals["start_timeout"] is None:
@@ -184,7 +192,7 @@ class DockerLauncher:
                 del config_dict_h
             return config_dict
 
-        port, password = start_fluent_container(
+        port, password, container = start_fluent_container(
             self._args, self.argvals["container_dict"]
         )
 
@@ -203,6 +211,7 @@ class DockerLauncher:
             file_transfer_service=self.file_transfer_service,
             start_transcript=self.argvals["start_transcript"],
         )
+        session._container = container
 
         if self.argvals["start_watchdog"] is None and self.argvals["cleanup_on_exit"]:
             self.argvals["start_watchdog"] = True

ansys/fluent/core/launcher/error_handler.py

@@ -1,3 +1,25 @@
+# Copyright (C) 2021 - 2025 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.
+
 """Provides a module for customized error handling."""
 
 from ansys.fluent.core.exceptions import InvalidArgument
@@ -29,6 +51,14 @@ class IpPortNotProvided(ValueError):
         super().__init__("Provide either 'ip' and 'port' or 'server_info_file_name'.")
 
 
+class InvalidIpPort(ValueError):
+    """Raised when IP address and port are invalid."""
+
+    def __init__(self):
+        """Initialize InvalidIpPort."""
+        super().__init__("Provide a valid 'ip' and 'port'.")
+
+
 class UnexpectedKeywordArgument(TypeError):
     """Raised when a valid keyword argument is not specified."""
 

ansys/fluent/core/launcher/fluent_container.py

@@ -1,3 +1,25 @@
+# Copyright (C) 2021 - 2025 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.
+
 """Provides a module for launching and configuring local Fluent Docker container runs.
 
 Notes
@@ -239,16 +261,23 @@ def configure_container_dict(
     logger.warning(
         f"Starting Fluent container mounted to {mount_source}, with this path available as {mount_target} for the Fluent session running inside the container."
     )
-
-    if not port and "ports" in container_dict:
+    port_mapping = {port: port} if port else {}
+    if not port_mapping and "ports" in container_dict:
         # take the specified 'port', OR the first port value from the specified 'ports', for Fluent to use
-        port = next(iter(container_dict["ports"].values()))
-    if not port and pyfluent.LAUNCH_FLUENT_PORT:
+        port_mapping = container_dict["ports"]
+    if not port_mapping and pyfluent.LAUNCH_FLUENT_PORT:
         port = pyfluent.LAUNCH_FLUENT_PORT
-    if not port:
+        port_mapping = {port: port}
+    if not port_mapping:
         port = get_free_port()
+        port_mapping = {port: port}
 
-    container_dict.update(ports={str(port): port})  # container port : host port
+    container_dict.update(
+        ports={str(x): y for x, y in port_mapping.items()}
+    )  # container port : host port
+    container_grpc_port = next(
+        iter(port_mapping.values())
+    )  # the first port in the mapping is chosen as the gRPC port
 
     if "environment" not in container_dict:
         if not license_server:
@@ -259,7 +288,7 @@ def configure_container_dict(
         container_dict.update(
             environment={
                 "ANSYSLMD_LICENSE_FILE": license_server,
-                "REMOTING_PORTS": f"{port}/portspan=2",
+                "REMOTING_PORTS": f"{container_grpc_port}/portspan=2",
             }
         )
 
@@ -319,16 +348,10 @@ def configure_container_dict(
             container_dict["environment"] = {}
         container_dict["environment"]["FLUENT_NO_AUTOMATIC_TRANSCRIPT"] = "1"
 
-    if (
-        os.getenv("REMOTING_NEW_DM_API") == "1"
-        or os.getenv("REMOTING_MAPPED_NEW_DM_API") == "1"
-    ):
+    if os.getenv("REMOTING_NEW_DM_API") == "1":
         if "environment" not in container_dict:
             container_dict["environment"] = {}
-        if os.getenv("REMOTING_NEW_DM_API") == "1":
-            container_dict["environment"]["REMOTING_NEW_DM_API"] = "1"
-        if os.getenv("REMOTING_MAPPED_NEW_DM_API") == "1":
-            container_dict["environment"]["REMOTING_MAPPED_NEW_DM_API"] = "1"
+        container_dict["environment"]["REMOTING_NEW_DM_API"] = "1"
 
     if pyfluent.LAUNCH_FLUENT_IP or os.getenv("REMOTING_SERVER_ADDRESS"):
         if "environment" not in container_dict:
@@ -342,7 +365,7 @@ def configure_container_dict(
             container_dict["environment"] = {}
         container_dict["environment"]["FLUENT_LAUNCHED_FROM_PYFLUENT"] = "1"
 
-    fluent_commands = ["-gu", f"-sifile={container_server_info_file}"] + args
+    fluent_commands = [f"-sifile={container_server_info_file}"] + args
 
     container_dict_default = {}
     container_dict_default.update(
@@ -360,7 +383,7 @@ def configure_container_dict(
     return (
         container_dict,
         timeout,
-        port,
+        container_grpc_port,
         host_server_info_file,
         remove_server_info_file,
     )
@@ -368,7 +391,7 @@ def configure_container_dict(
 
 def start_fluent_container(
     args: List[str], container_dict: dict | None = None
-) -> (int, str):
+) -> tuple[int, str, Any]:
     """Start a Fluent container.
 
     Parameters
@@ -439,7 +462,9 @@ def start_fluent_container(
 
         logger.debug("Starting Fluent docker container...")
 
-        docker_client.containers.run(config_dict.pop("fluent_image"), **config_dict)
+        container = docker_client.containers.run(
+            config_dict.pop("fluent_image"), **config_dict
+        )
 
         success = timeout_loop(
             lambda: host_server_info_file.stat().st_mtime > last_mtime, timeout
@@ -452,7 +477,7 @@ def start_fluent_container(
         else:
             _, _, password = _parse_server_info_file(str(host_server_info_file))
 
-            return port, password
+            return port, password, container
     finally:
         if remove_server_info_file and host_server_info_file.exists():
             host_server_info_file.unlink()

ansys/fluent/core/launcher/launcher.py

@@ -1,3 +1,25 @@
+# Copyright (C) 2021 - 2025 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.
+
 """Provides a module for launching Fluent.
 
 This module supports both starting Fluent locally and connecting to a remote instance
@@ -12,7 +34,10 @@ from typing import Any, Dict
 import ansys.fluent.core as pyfluent
 from ansys.fluent.core.fluent_connection import FluentConnection
 from ansys.fluent.core.launcher.container_launcher import DockerLauncher
-from ansys.fluent.core.launcher.launcher_utils import _confirm_watchdog_start
+from ansys.fluent.core.launcher.launcher_utils import (
+    _confirm_watchdog_start,
+    is_windows,
+)
 from ansys.fluent.core.launcher.pim_launcher import PIMLauncher
 from ansys.fluent.core.launcher.pyfluent_enums import (
     Dimension,
@@ -71,6 +96,27 @@ def create_launcher(fluent_launch_mode: LaunchMode = None, **kwargs):
         return SlurmLauncher(**kwargs)
 
 
+def _show_gui_to_ui_mode(old_arg_val, **kwds):
+    start_container = kwds.get("start_container")
+    container_dict = kwds.get("container_dict")
+    if old_arg_val is True:
+        if start_container is True:
+            return UIMode.NO_GUI
+        elif container_dict:
+            return UIMode.NO_GUI
+        elif os.getenv("PYFLUENT_LAUNCH_CONTAINER") == "1":
+            return UIMode.NO_GUI
+        else:
+            return UIMode.GUI
+    elif not old_arg_val:
+        if is_windows():
+            return UIMode.HIDDEN_GUI
+        elif not is_windows():
+            return UIMode.NO_GUI
+        else:
+            return None
+
+
 def _version_to_dimension(old_arg_val):
     if old_arg_val == "2d":
         return Dimension.TWO
@@ -84,7 +130,7 @@ def _version_to_dimension(old_arg_val):
 @deprecate_argument(
     old_arg="show_gui",
     new_arg="ui_mode",
-    converter=lambda old_arg_val: UIMode.GUI if old_arg_val is True else None,
+    converter=_show_gui_to_ui_mode,
     warning_cls=PyFluentDeprecationWarning,
 )
 @deprecate_argument(
@@ -100,7 +146,7 @@ def launch_fluent(
     processor_count: int | None = None,
     journal_file_names: None | str | list[str] = None,
     start_timeout: int = None,
-    additional_arguments: str | None = "",
+    additional_arguments: str = "",
     env: Dict[str, Any] | None = None,
     start_container: bool | None = None,
     container_dict: dict | None = None,
@@ -130,8 +176,8 @@ def launch_fluent(
     Parameters
     ----------
     product_version : FluentVersion or str or float or int, optional
-        Version of Ansys Fluent to launch. To use Fluent version 2024 R2, pass
-        any of  ``FluentVersion.v242``, ``"24.2.0"``, ``"24.2"``, ``24.2``or ``242``.
+        Version of Ansys Fluent to launch. To use Fluent version 2025 R1, pass
+        any of  ``FluentVersion.v251``, ``"25.1.0"``, ``"25.1"``, ``25.1``or ``251``.
         The default is ``None``, in which case the newest installed version is used.
     dimension : Dimension or int, optional
         Geometric dimensionality of the Fluent simulation. The default is ``None``,
@@ -264,6 +310,8 @@ def launch_fluent(
     if env is None:
         env = {}
 
+    pyfluent.FLUENT_PRECISION_MODE = precision
+
     def _mode_to_launcher_type(fluent_launch_mode: LaunchMode):
         launcher_mode_type = {
             LaunchMode.CONTAINER: DockerLauncher,

ansys/fluent/core/launcher/launcher_utils.py

@@ -1,3 +1,25 @@
+# Copyright (C) 2021 - 2025 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.
+
 """Provides a module for launching utilities."""
 
 import logging