container_launcher#
Provides a module for launching Fluent in container mode.
Examples#
>>> from ansys.fluent.core.launcher.launcher import create_launcher
>>> from ansys.fluent.core.launcher.pyfluent_enums import LaunchMode, FluentMode
>>> container_meshing_launcher = create_launcher(LaunchMode.CONTAINER, mode=FluentMode.MESHING)
>>> container_meshing_session = container_meshing_launcher()
>>> container_solver_launcher = create_launcher(LaunchMode.CONTAINER)
>>> container_solver_session = container_solver_launcher()
Classes:
|
Instantiates Fluent session in container mode. |
- class ansys.fluent.core.launcher.container_launcher.DockerLauncher(mode=None, ui_mode=None, graphics_driver=None, product_version=None, dimension=None, precision=None, processor_count=None, start_timeout=60, additional_arguments='', container_dict=None, dry_run=False, cleanup_on_exit=True, start_transcript=True, py=None, gpu=None, start_watchdog=None, file_transfer_service=None)#
Bases:
object
Instantiates Fluent session in container mode.
Methods:
__init__
([mode, ui_mode, graphics_driver, ...])Launch a Fluent session in container mode.
- __init__(mode=None, ui_mode=None, graphics_driver=None, product_version=None, dimension=None, precision=None, processor_count=None, start_timeout=60, additional_arguments='', container_dict=None, dry_run=False, cleanup_on_exit=True, start_transcript=True, py=None, gpu=None, start_watchdog=None, file_transfer_service=None)#
Launch a Fluent session in container mode.
- Parameters:
- mode
FluentMode
Specifies the launch mode of Fluent to target a specific session type.
- ui_mode
UIMode
Defines the user interface mode for Fluent. Options correspond to values in the
UIMode
enum.- graphics_driver
FluentWindowsGraphicsDriver
orFluentLinuxGraphicsDriver
Specifies the graphics driver for Fluent. Options are from the
FluentWindowsGraphicsDriver
enum (for Windows) or theFluentLinuxGraphicsDriver
enum (for Linux).- product_version
FluentVersion
orstr
orfloat
orint
,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
, or251
. Defaults toNone
, which uses the newest installed version.- dimension
Dimension
orint
,optional
Specifies the geometric dimensionality of the Fluent simulation. Defaults to
None
, which corresponds toDimension.THREE
. Acceptable values includeDimension.TWO
,Dimension.THREE
, or integers2
and3
.- precision
Precision
orstr
,optional
Defines the floating point precision. Defaults to
None
, which corresponds toPrecision.DOUBLE
. Acceptable values includePrecision.SINGLE
,Precision.DOUBLE
, or strings"single"
and"double"
.- processor_count
int
,optional
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. Defaults to 60 seconds.
- additional_arguments
str
,optional
Additional command-line arguments for Fluent, formatted as they would be on the command line.
- container_dict
dict
,optional
Configuration dictionary for launching Fluent inside a Docker container. See also
fluent_container
.- dry_runbool,
optional
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_exitbool
Determines whether to shut down the connected Fluent session upon exit or when calling the session’s exit() method. Defaults to True.
- start_transcriptbool
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.
- pybool,
optional
If True, runs Fluent in Python mode. Defaults to None.
- gpubool,
optional
If True, starts Fluent with GPU Solver enabled.
- start_watchdogbool,
optional
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.
- mode
- Returns:
Meshing
|PureMeshing
|Solver
|SolverIcing
|dict
Session object or configuration dictionary if
dry_run
is True.
- Raises:
UnexpectedKeywordArgument
If an unexpected keyword argument is provided.
Notes
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.