37.1.2. The Details View for Execution Control

You access the Execution Control details view in CFX-Pre by clicking Insert > Solver > Execution Control or by right-clicking Simulation Control in the Outline tree view and selecting Insert > Execution Control.

The tabs presented in the details view for Execution Control are described in the following sections:

37.1.2.1. Run Definition Tab

To configure the Run Definition tab:

Under Input File Settings > Solver Input File, ensure that the name of a CFX-Solver input file (extension .def or .mdef) is specified.

Note that CFX-Solver input file names must not contain spaces when run with an associated Ansys input file (.inp).

  • Mesh reordering involves changing the order of the nodes in the mesh to reduce the computational load on the CFX-Solver.

    Mesh Reordering > Option can be set to:

    • None

      The mesh is not reordered.

    • Automatic

      The mesh is reordered using Reverse Cuthill McKee and no sorting within levels.

    • Specified Mesh Ordering

      Node Ordering > Option has the following options:

      • Reverse Cuthill McKee

      • Cuthill McKee

      • None

      If either Cuthill McKee or Reverse Cuthill McKee is selected, you can set Sorting Within Levels to None, Ascending, or Descending to control the sorting process.

    Additional information is provided in Mapping Data from the Source File to the Target File in the CFX-Solver Modeling Guide.

  • Set Type of Run to Full or Partitioner Only.

    • Full runs the partitioner if applicable, and then runs the solver.

    • Partitioner Only is used for parallel runs only and does not run the solver. This writes a .par file.

  • You can select or clear Double Precision. This setting will determine the default (single or double) precision of the partitioner, solver, and interpolator executables. For details on the precision of executables, see Double-Precision Executables in the CFX-Solver Manager User's Guide. The precisions of the partitioner, solver, and interpolator executables can be optionally overridden individually on the Partitioner, Solver, and Interpolator tabs.

  • You can select or clear Large Problem. This setting will determine the default ("large problem" or not) problem size capability of the partitioner, solver, and interpolator executables. For details on the problem size capability of the executables, see Large Problem Executables in the CFX-Solver Manager User's Guide. The problem size capability of the partitioner, solver, and interpolator executables can be optionally overridden individually on the Partitioner, Solver, and Interpolator tabs.

  • You can configure the Parallel Environment as required (see Parallel Environment).

  • System Coupling input files are always written if there are boundary conditions set to use the System Coupling option. Additionally, you can request that a System Coupling Input (.scp) file is written regardless of the boundary condition options, by selecting Always write System Coupling Input File. The System Coupling Input file is written alongside the CFX-Solver input (.def) file and has the same name except for the file extension (.scp).

    For details on System Coupling, see:

  • You can elect to have CFX-Pre quit upon writing CFX-Solver Input file by selecting Quit CFX-Pre when Solver Input File Written > Quit.

37.1.2.1.1. Parallel Environment

Under Parallel Environment, select a Run Mode option. The run mode determines whether the run is serial (the default when defining a run in which a problem is solved as one process), or parallel (problem is split into partitions).

  • A serial run (the default) requires no additional configuration.

  • For a local parallel run, specify the maximum number of partitions.

Note that distributed parallel runs cannot be set up in CFX-Pre. For more information on Parallel Processing, see Parallel Run in the CFX-Solver Manager User's Guide.

37.1.2.2. Operating Points Tab

If an Operating Points object is specified in the Outline tree view, the Operating Points tab is available in the Execution Control details view. This tab is similar to the Operating Points tab in CFX-Solver Manager, described in Operating Points Tab in the CFX-Solver Manager User's Guide.

For modeling information, see Operating Maps and Operating Point Cases in the CFX-Solver Modeling Guide.

37.1.2.3. Initial Values Tab

The Initial Values tab is used for specifying initial values via results files.

If you do not specify initial values via results files, the software will use initialization data from (in order of precedence):

  • In CFX-Pre on the Initialization tab in the Domain details view

  • In CFX-Pre on the Initialization tab in the Global Initialization details view

  • Automatically generated initial values

    However, automatically generated initial values may not be suitable for some steady-state cases and are insufficient for all transient cases.

If you do specify initial values via results files, those values will override any initial values listed above, as applicable.

You can set initial values via results files in a variety of places as listed here (in order of precedence):

  • In CFX-Solver Manager in the Define Run dialog box on the Initial Values tab

  • In CFX-Pre in the Configuration details view on the Initial Values tab

    Note that for cases with multiple configurations, initial values cannot be set globally (that is, in CFX-Solver Manager or in CFX-Pre in the Execution Control details view); they can only be set per configuration (that is, in CFX-Pre in the Configuration details view).

  • In CFX-Pre in the Execution Control details view on the Initial Values tab

You can set initial values via results files as follows:

  1. On the Initial Values tab, select the Initial Values Specification check box to show the initial values settings.

  2. Click New   to create an initial values object.

  3. Select an initial values object from the list.

  4. Choose the source of initial values for the initial values object.

    The Results File option is the only option available. Specify the name of the results file from which initial values should be obtained.

  5. Optionally specify Interpolation Mapping settings in order to select, position, and/or replicate the data. For details, see Interpolation Mapping in the CFX-Solver Modeling Guide.

  6. Select Continue History From if you want to continue the run history (convergence history, monitor plots, time and time step counters, and so on) and use the smoothest restart possible from the selected Initial Values File. The run will continue from the one contained in the specified initial values object. Note that, in CFX-Pre, the Continue History From option is made visible by selecting Initial Values Control. Note that the run history will reset if Continue History From is not selected.

  7. The Use Mesh From setting determines which file provides the mesh that is used for the analysis: the Solver Input file or the Initial Values file. The mesh from the Initial Values file can be used in a limited set of circumstances. See Using the Mesh from the Initial Values File in the CFX-Solver Modeling Guide for details. Note that, in CFX-Pre, the Use Mesh From option is made visible by selecting Initial Values Control.

Full details for Initial Values Files can be found in Reading the Initial Conditions from a File in the CFX-Solver Modeling Guide.

37.1.2.4. Partitioner Tab

Use the Partitioner tab to configure mesh partitioning options for parallel runs.


Note:  Once started, the run progresses through partitioning, and then into the solution of the CFD problem. Extra information is stored in the CFX-Solver Output file for a parallel run. For details, see Partitioning Information in the CFX-Solver Manager User's Guide.


You can select a partition file (*.par) to load by setting Partition Option to Partition File, then clicking Browse   beside Initial Partition File. The partition file is only available if a model has already been partitioned. The number of partitions in the partition file must be the same as the number of processes (Processes) specified on the Run Definition tab.


Note:  An existing partition file cannot be used if the simulation involves either the Monte Carlo or Discrete Transfer radiation model. Partitions may be viewed prior to running CFX-Solver. For details, see CFX Partition File in the CFX-Solver Manager User's Guide.


Run Priority may be set to Idle, Low, Standard or High (Standard is selected by default). For a discussion of these priorities, see The cfx5control Application in the CFX-Solver Manager User's Guide.

37.1.2.4.1. Executable Settings

You can override the precision set on the Run Definition tab by selecting Override Default Precision and then setting the precision. For details on the precision of executables, see Double-Precision Executables in the CFX-Solver Manager User's Guide.

You can override the problem size capability ("large problem" or not) set on the Run Definition tab by selecting Override Default Large Problem Setting and then setting the problem size capability (via the Large Problem check box). For details on the problem size capability of the executables, see Large Problem Executables in the CFX-Solver Manager User's Guide.

37.1.2.4.2. Partitioning Detail

Under Partitioning Detail, you can specify various partition method options.

37.1.2.4.2.2. Partition Weighting

Configure how partitions are weighted between machines. Available Partition Weighting selections include:

  • Automatic (default): Calculates partition sizes based on the Relative Speed entry specified for each machine in the hostinfo.ccl file. Machines with a faster relative speed than others are assigned proportionally larger partition sizes.


    Note:  The entry of relative speed values is usually carried out during the CFX installation process. Parallel performance can be optimized by setting accurate entries for relative speed.


  • Uniform: Assigns equal-sized partitions to each process.


    Note:  Both Uniform and Automatic give the same results for local parallel runs; it is only for distributed runs that they differ.


  • Specified: Only available in CFX-Solver Manager. For details, see Partitioner Tab in the CFX-Solver Manager User's Guide.

37.1.2.4.2.3. Multidomain Option

Configure how domains are partitioned. Available Multidomain Option selections include:

  • Automatic (default): If the case does not involve particle transport, this is the same as the Coupled Partitioning option; otherwise it is the same as the Independent Partitioning option.

  • Independent Partitioning: Each domain is partitioned independently into a number of partitions.

  • Coupled Partitioning: All connected domains are partitioned together, provided they are the same type (i.e. solid domains are still partitioned separately from fluid/porous domains). For details, see Optimizing Mesh Partitioning in the CFX-Solver Modeling Guide.


    Note:  Coupled partitioning is often more scalable, more robust and less memory expensive than independent partitioning because fewer partition boundaries are created. However, coupled partitioning may worsen the performance of particle transport calculations.


37.1.2.4.2.4. Multipass Partitioning

When Coupled Partitioning is activated, you can further choose to set the Multipass Partitioning option. The Transient Rotor Stator option is relevant only for simulations having transient rotor stator interfaces. It uses a special multipass algorithm to further optimize the partition boundaries. This approach generates circumferentially-banded partitions adjacent to each transient rotor stator interface, which ensures that interface nodes remain in the same partition as the two domains slide relative to each other. Away from the interface, the partitioning is handled using whichever method is specified for the Partition Type.

37.1.2.4.3. Partition Smoothing

Partition smoothing attempts to minimize the surface area of partition boundaries by swapping vertices between partitions. Partition smoothing reduces communication overhead and improves solver robustness. Smoothing is enabled by default, but may be disabled by changing Partition Smoothing > Option.

If smoothing is enabled, the algorithm will, by default, perform a maximum of 100 sweeps. The maximum number of smoothing sweeps can be specified by changing the value of Partition Smoothing > Max. Smooth. Sweeps. The smoothing algorithm will stop before this value is reached if it finds no improvement between successive sweeps.

For further details on partition smoothing, see Optimizing Mesh Partitioning in the CFX-Solver Modeling Guide.

37.1.2.4.4. Partition Node Weighting

The partitioning in CFX is node based; the partitioner distributes the nodes among the partitions. By default, the distribution does not consider the computational cost per node as a function of mesh element type (for example, tetrahedral or hexahedral), leading to potential load imbalances between different partitions; for example, two partitions with the same number of nodes could have different computational loads if they have different proportions of tetrahedral (more expensive) versus hexahedral (less expensive) elements. Such load imbalances between the partitions can greatly reduce parallel performance. In order to avoid or reduce such load imbalances – especially for meshes with mixed element types – you can apply a Partition Node Weighting option to influence the node counts among the partitions:

  • Uniform (default): No node weighting is applied. Each node is treated equally in the partitioner.

  • Element Connectivity: The partitioner tries to determine a node weighting by counting the number of connections for each node.

  • Element Type: The partitioner uses a fixed weighting for a node depending on the type of element associated with the node. The following default values are used for the four possible element types:

    • Hexahedral Weighting Factor = 1.0

    • Tetrahedral Weighting Factor = 2.5

    • Prismatic Weighting Factor = 1.5

    • Pyramidal Weighting Factor = 1.5


Note:
  • Although the application of partition node weighting is expected to improve the partition load balancing, it is not guaranteed that the final computational time is reduced.

  • The partitioning can have an impact on the linear solver; therefore the number of linear solver sweeps, as well as the convergence history, can change.


37.1.2.4.5. Pre-coarsening Control

For details, see Pre-coarsening Control in the CFX-Solver Manager User's Guide.

37.1.2.4.6. Partitioner Memory

If required, you can adjust the memory configuration under Partitioner Memory. For details, see Configuring Memory for the CFX-Solver in the CFX-Solver Manager User's Guide.

37.1.2.5. Solver Tab

Select the Solver tab to configure solver settings.

  • Under Run Priority, you can select Idle, Low, Standard or High. For a discussion of these priorities as well as how you can change them after the execution of the solver has started, see The cfx5control Application in the CFX-Solver Manager User's Guide.

  • You can override the precision set on the Run Definition tab. From Executable Settings > Override Default Precision, select or clear Double Precision. For details on the precision of executables, see Double-Precision Executables in the CFX-Solver Manager User's Guide.

  • You can override the problem size capability ("large problem" or not) set on the Run Definition tab by selecting Override Default Large Problem Setting and then setting the problem size capability (via the Large Problem check box). For details on the problem size capability of the executables, see Large Problem Executables in the CFX-Solver Manager User's Guide.

  • If required, you can adjust the memory configuration under Solver Memory. For details, see Configuring Memory for the CFX-Solver in the CFX-Solver Manager User's Guide.

  • If your case has user locations that are generated in CFX-Pre and stored in the CFX-Solver input file (see User Locations), select User Location Regeneration to control whether or not these user locations are regenerated (recalculated) as part of the solver run. The options are:

    • Automatic

      This is the default. If the stored user location data is out-of-date, this option runs CFX-Pre temporarily in the background to regenerate the data at the start of the solver run. A user location is considered to be out-of-date if the settings for the user location have changed since the CFX-Solver input file was written (for example, if the command language in the CFX-Solver input file was edited) or if the user location depends on expressions and there has been any change to the definition of any CEL expression, including the index for an operating point input parameter table.

    • Validate

      Stops the run if and when there is any change to the definition of any user location, in which case the user location data is out-of-date. If the user location depends on a CEL expression, and any expression has changed, the run continues but with a warning written to the CFX-Solver Output file.

    • None

      No user locations are updated during the run; the run proceeds using the user location data stored in the CFX-Solver input file regardless of whether there is any change to the definitions of the user locations or expressions. This option can be used to suppress user location updates if, for example, a user location depends on expressions, and an expression has been changed, but it is known that the expression change will not affect the user location data.

    • All

      All user locations are forced to be recalculated at the start of the run regardless of whether there is any change to the definitions of the user locations or expressions.


      Note:  This option (All) is effectively selected, regardless of which option is actually selected, when running a design points study in Ansys Workbench.


    • Selected Locations

      The selected user locations are forced to be recalculated at the start of the run regardless of whether there is any change to the definitions of the user locations or expressions. Any other user locations will not be recalculated.

37.1.2.6. Interpolator Tab

Select the Interpolator tab.

  • Under Run Priority, you can select Idle, Low, Standard or High. For a discussion of these priorities, see The cfx5control Application in the CFX-Solver Manager User's Guide.

  • You can override the precision set on the Run Definition tab by selecting Override Default Precision and then setting the precision. For details on the precision of executables, see Double-Precision Executables in the CFX-Solver Manager User's Guide.

  • You can override the problem size capability ("large problem" or not) set on the Run Definition tab by selecting Override Default Large Problem Setting and then setting the problem size capability (via the Large Problem check box). For details on the problem size capability of the executables, see Large Problem Executables in the CFX-Solver Manager User's Guide.

  • If required, under Interpolator Memory, you can adjust the memory configuration. For details, see Configuring Memory for the CFX-Solver in the CFX-Solver Manager User's Guide.

  • Optionally select Threading Control, then choose an Option:

    • None

      Use only one thread.

    • Number of Threads

      Set Number of Threads to the maximum number of threads that may be used by the interpolator.

    • Hardware Capacity Fraction

      Set Value to the number of threads used by the interpolator as a fraction of those available on the current hardware.

  • You can select Domain Search Control to access the Bounding Box Tolerance setting (see below).

  • You can select Interpolation Model Control to access the Enforce Strict Name Mapping for Phases, Particle Relocalization Tolerance, and Mesh Deformation Option settings (see below).

The Bounding Box Tolerance and Particle Relocalization Tolerance settings are described in Adjusting the Bounding Box Tolerance in the CFX-Solver Modeling Guide.

The Enforce Strict Name Mapping for Phases setting controls how fluids are mapped between the Initial Values files and the Solver Input File. By default, when interpolating from multiple Initial Values files onto a single Solver Input File, if each Initial Values file contains just one fluid, then the CFX-Interpolator regards all of these fluids as being the same fluid, regardless of the Fluid Definition name. You can change this default behavior by turning on the Enforce Strict Name Mapping for Phases setting. This forces the CFX-Interpolator to use the Fluid Definition names to match each fluid from each Initial Values file with the appropriate fluid in the Solver Input File.

The Mesh Deformation Option setting controls which mesh in the Initial Values File is used to check the mesh displacements: the initial mesh or the final mesh. The options are Automatic, Use Latest Mesh, and Use Initial Mesh. When the Automatic option is selected, the initial mesh will be used if the Continue History From check box is selected, and the latest mesh will be used if the Continue History From check box is cleared.