Professional Documents
Culture Documents
XMGR
XMGR
2
Table of Contents
1. CFX-Solver Manager Basics .......................................................................................................................... 1
Starting CFX-Solver Manager ............................................................................................................ 1
Working with the CFX-Solver Manager Interface ................................................................................... 1
Workspace Selector .......................................................................................................................... 2
Convergence History Plots ................................................................................................................ 2
Text Output Window ........................................................................................................................ 3
Multi-Configuration Run History Page ................................................................................................ 3
Customizing CFX-Solver Manager ..................................................................................................... 5
2. Working with Solver Manager ........................................................................................................................ 7
Solver Run Overview ....................................................................................................................... 7
The Define Run Dialog Box .............................................................................................................. 7
Solver Input File Name ..................................................................................................................... 8
Edit Configuration ........................................................................................................................... 8
Run Definition Tab .......................................................................................................................... 8
MultiField Tab ................................................................................................................................ 9
Partitioner Tab ............................................................................................................................... 10
Solver Tab .................................................................................................................................... 12
Interpolator Tab ............................................................................................................................. 12
Configuring Memory for the CFX-Solver ........................................................................................... 13
Run Output Results ........................................................................................................................ 13
Parallel Run .................................................................................................................................. 14
Overview ..................................................................................................................................... 14
General Procedure .......................................................................................................................... 14
Configuring a Parallel Run ............................................................................................................... 14
Restarting a Run ............................................................................................................................ 16
Restart Procedure ........................................................................................................................... 16
Restart Details ............................................................................................................................... 16
ANSYS Multi-field Run .................................................................................................................. 18
Overview ..................................................................................................................................... 18
General Procedure .......................................................................................................................... 18
Monitoring a Run in Progress ........................................................................................................... 20
Monitoring a Completed Run ........................................................................................................... 20
ANSYS Multi-field Residual Plotting ................................................................................................ 21
Processing the ANSYS Input File ...................................................................................................... 21
Restart Procedure for ANSYS Multi-field Runs ................................................................................... 22
3. CFX-Solver Files ........................................................................................................................................ 25
Files Used by the CFX-Solver .......................................................................................................... 25
Files Generated by the CFX-Solver ................................................................................................... 27
CFX-Solver Output File .................................................................................................................. 28
CFX-Solver Output File (Transient Runs) ........................................................................................... 44
CFX-Solver Output File (Interpolation Runs) ...................................................................................... 45
CFX-Solver Output File (Parallel Runs) ............................................................................................. 46
CFX-Solver Output File (Mesh Adaption Runs) ................................................................................... 49
CFX-Solver Output File (Remeshing Runs) ........................................................................................ 49
CFX-Solver Output File (Conjugate Heat Transfer Runs) ....................................................................... 50
CFX-Solver Output File (GGI Runs) ................................................................................................. 50
CFX-Solver Output File (Combustion Runs) ....................................................................................... 52
CFX-Solver Output File (Particle Runs) ............................................................................................. 54
CFX-Solver Output File (ANSYS Multi-field Runs) ............................................................................. 57
CFX-Solver Output File (Radiation Runs) .......................................................................................... 58
CFX-Solver Results File .................................................................................................................. 60
CFX Radiation File ........................................................................................................................ 61
CFX Partition File .......................................................................................................................... 63
Additional Files for ANSYS Multi-field Runs ..................................................................................... 63
CFX Multi-Configuration Output File ................................................................................................ 64
By default, the convergence history plots appear to the left or the top. The text output window appears to the right
or the bottom. There is an adjustable split between the windows that is oriented either horizontally or vertically,
depending on the aspect ratio of the entire CFX-Solver Manager window (also adjustable).
Release 12.0 - © 2009 ANSYS, Inc. All rights reserved.
Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates. 1
Workspace Selector
Workspace Selector
The Workspace selector is a drop-down list that shows the current run name and enables you to switch between
runs.
1. Click the arrow of the Workspace drop-down list.
2. Select the run you want to view.
2. In the Image File dialog box, select a location to which to export the image.
3. Under File name, enter the name for the file.
4. Under File type, select the format to export.
5. Click Save.
6. Click Save.
Note that monitor data can also be exported using the command-line application cfx5mondata.
cfx5mondata –help
• One workspace that shows an overview of the multi-configuration simulation. There is a run history page that
lists each simulation step (analysis) and its overall status ( = in progress, = complete, = error), and
a text output window that provides the status of each simulation step.
A sample run history page is shown below:
In this case, there are two simulation steps: a steady state analysis and a transient analysis. The steady state analysis
(simulation step 1) is complete, and the transient analysis (simulation step 2) is in progress. Because the transient
analysis is in progress, the overall simulation is marked as being in progress. When the transient analysis completes,
the overall simulation will be marked as being complete.
You can switch to the workspace for a simulation step by right-clicking the simulation step in the run history page
and selecting Open Workspace from the shortcut menu.
The shortcut menu commands on the run history page are:
• Open Workspace
This switches to the workspace view for the selected simulation step.
• Stop Run
This command stops the CFX-Solver from computing the results for the selected simulation step.
An alternative way to switch between the various workspaces is to choose a workspace from the Workspace
drop-down list:
In the drop-down list, the analyses of a multi-configuration simulation are listed below the name of the run, and are
indented to show that they belong to the run. Selecting the name of the run switches to the run history page.
Tip
In ANSYS Workbench you have the option of clicking Save Settings to save the settings of the Define
Run dialog box to the Solution cell (some of these settings are visible in the Solution cell's Properties).
By saving the settings in this way, you can configure the run from CFX-Solver Manager, but start the
run from ANSYS Workbench (by updating the Solution cell).
Details of making these changes with the Define Run dialog box are described in the next section.
Note
When specifying or editing the Solver Input File by typing from the keyboard, you must click Reload
run settings from file to have the changes take effect.
Edit Configuration
If a multi-configuration definition or results file (*.mdef or *.mres, respectively) is selected as the CFX-Solver
Input file, then the settings on the tabs described below can be made on a simulation-wide or per-configuration
basis. This is done by choosing either Global Settings or a specific configuration name for the Edit Configuration
option.
Note
When Global Settings are made these settings are inherited by all configurations. You can then override
any setting for a specific configuration but it is important to note that in this situation the remainder of
the settings for the configuration will not be inherited from Global Settings.
c. The Use Mesh From setting determines which mesh is used for the analysis: the one specified in the
Solver Input File option, or the one in the Initial Values. The mesh from the Initial Values File can only
be used in a limited set of circumstances. See Using the Mesh from the Initial Values File (p. 84) in
ANSYS CFX-Solver Modeling Guide for details.
d. Select Continue History From if you want to continue the run history (convergence history, monitor
plots, time and time step counters, etc…) and use the smoothest restart possible from the selected Initial
Values File. The run will continue from the one contained the specified initial values object. Note that
the run history will reset if Continue History From is not selected.
Full details of the settings can be found in Reading the Initial Conditions from a File (p. 81) in ANSYS
CFX-Solver Modeling Guide.
3. Select or clear Double Precision or Executable Selection > 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 (p. 123). The precision of the solver and
interpolator executables can be set individually on the Solver and Interpolator tabs.
4. Configure the Parallel Environment as required.
5. If required, under Run Environment, set the working directory.
6. If required, select Show Advanced Controls to display other tabs.
Additional information is provided in the next section, Parallel Environment, and in Initial Condition Modeling (p.
71) in ANSYS CFX-Solver Modeling Guide.
Parallel Environment
For a distributed parallel setup, specify the number of partitions assigned to each host. If choosing a specified
partition weighting (under Partitioner), click directly on the partition weight number to edit it. There should be one
weight entry per partition.
1. Under Parallel Environment, select a Run Mode.
2. Configure the mode as required.
Run Mode determines whether the run is serial (the default when defining a run in which a problem solved as
one process), or parallel (problem split into partitions).
• Serial run (the default) requires no additional configuration.
• Parallel Run (p. 14)
MultiField Tab
The MultiField tab is used for launching ANSYS Multi-field runs and only appears if the specified CFX-Solver
input file has External Solver Coupling set to ANSYS MultiField or ANSYS Multifield via Prep7.
When this setting is enabled, the CFX-Solver Manager can be used to launch a complete ANSYS Multi-field run,
including processing the multi-field commands (where appropriate) and launching CFX and ANSYS solvers. For
details, see Pre-Processing (p. 295) in the ANSYS CFX-Solver Modeling Guide. A description of the different run
modes and settings can be found in ANSYS Multi-field Run (p. 18).
The following table outlines various settings available on MultiField tab. The settings are marked as required or
optional based on the MFX run mode chosen for the ANSYS Multi-field run.
a
The default setting for MFX Run Mode is Start ANSYS and CFX that launches the complete MFX run, including starting the ANSYS
Solver. The other modes allow you to start just one or other solver, or to process the multi-field commands only using the specified ANSYS
Input File. The latter option is available only if the specified CFX-Solver input file has External Solver Coupling set to ANSYS MultiField.
b
Start CFX only: If the MFX Run Mode setting is Start CFX only, then no further ANSYS settings are required. However, when the
CFX-Solver is started, it needs to know how to communicate with the ANSYS Solver that must have already been started elsewhere (that is, on
another machine), and so Host Name and Host Port must be provided. The host name is the machine on which the ANSYS Solver was started.
The host port number is determined by the ANSYS Solver when it starts, and can be read from the file <jobname>.port in the ANSYS
working directory once the ANSYS Solver has started.
c
Mechanical Input File: For all MFX run modes other than Start CFX only, the ANSYS input file must be provided. This will be read
from the CFX-Solver input file specified on the Run Definition tab; however, you may choose to change this if the file is now in a different
location, or if you want to use a different input file.
d
Process ANSYS Input File: For the MFX run modes which will start the ANSYS Solver (Start ANSYS and CFX and Start ANSYS
only), it is necessary to select Process ANSYS Input File if the specified ANSYS input file does not already contain the multi-field set-up
(the MF commands required for the run), and if you want the multi-field set-up to be read from the CFX-Solver input file. This option will not
be available if the specified CFX-Solver input file has External Solver Coupling set to ANSYS MultiField via Prep7, as in this case
the CFX-Solver input file will not contain any multi-field set-up. For details, see Processing the ANSYS Input File (p. 21).
e
Restart ANSYS Run: If the run is a restart from a previous ANSYS Multi-field run, then you need to select Restart ANSYS Run and supply
the name of the database (*.db or *.rdb) from the previous run. This is not necessary if you are starting the CFX part of the ANSYS Multi-field
run from an existing results file (for example, to provide initial conditions).
f
MultiField Solver Settings: If the ANSYS Solver is to be started, you will need to specify the following settings:
• ANSYS Install Directory: On UNIX systems, you may need to manually specify where the ANSYS installation is if it is not in the default
location. In this case, you must provide the path to the v120/ansys directory.
• Additional Arguments: You can use this setting if you want to pass the ANSYS Solver additional arguments. Whatever you specify here
will be added to the command which starts the ANSYS Solver.
• ANSYS License: This setting is available when running CFX-Solver Manager in standalone mode; it used to select which product variable
(license) you want the ANSYS Solver to use. When running in ANSYS Workbench, the ANSYS License setting is not available. In this
case, the license used by the ANSYS solver is selected by ANSYS Workbench. The latter selects licenses according to the settings found
under Tools > Options > Licensing > License Management. For details, see the ANSYS Workbench documentation.
Partitioner Tab
Use the Partitioner tab to configure the mesh partitioning options.
Note
An existing partition file cannot be used if the simulation involves either the Monte Carlo or Discrete
Transfer radiation models.
Partitions may be viewed prior to running CFX-Solver. For details, see CFX Partition File (p. 63).
1. Select the Partitioner tab.
If this is not available, ensure Show Advanced Controls is selected in the Run Definition tab.
2. If required, under Initial Partition File, click Browse and select the partition file to load.
The *.par file is only required if a model has already been partitioned. The number of partitions in the
partitioning file must be the same as that selected on the Run Definition tab.
Note
A partition file generated in ANSYS CFX 11.0 or earlier versions is not supported in ANSYS CFX
12.0. If such a file is used in ANSYS CFX 12.0, then an error message is generated.
3. Under Run Priority, select Idle, Low, Standard or High. For a discussion of these priorities, see The
cfx5control Application (p. 129).
4. If required, select the Use Large Problem Partitioner option, which is available on 64-bit platforms only.
This option starts the large problem partitioner which can partition problems up to 2^31-1 elements. This
partitioner uses 64-bit integer and logical variables so it will allocate more memory than the default partitioning
executable. For details, see Large Problem Partitioner Executables (p. 123).
5. Under Partitioning Detail, choose a Partition Type and configure it.
Depending on the selected partition type, various options must be configured. Partition types include:
• Multilevel Graph Partitioning Software - MeTiS (p. 347) in the ANSYS CFX-Solver Modeling Guide.
When first running in parallel, it is recommended that Partition Type be set to MeTiS.
• Recursive Coordinate Bisection (p. 347) in the ANSYS CFX-Solver Modeling Guide
• Optimized Recursive Coordinate Bisection (p. 347) in the ANSYS CFX-Solver Modeling Guide
• Directional Recursive Coordinate Bisection (p. 348) in the ANSYS CFX-Solver Modeling Guide
• User Specified Direction (p. 348) in the ANSYS CFX-Solver Modeling Guide
• Simple Assignment (p. 347) in the ANSYS CFX-Solver Modeling Guide
• Radial (p. 349) in the ANSYS CFX-Solver Modeling Guide
• Circumferential (p. 349) in the ANSYS CFX-Solver Modeling Guide
• Junction Box (p. 349) in the ANSYS CFX-Solver Modeling Guide
• Coupled Partitioning: All domains that are connected together are partitioned together. Note that
solid domains are still partitioned separately from fluid/porous domains. Coupled partitioning often leads
to better scalability, reduced memory requirements, and sometimes better robustness, than independent
partitioning because there are fewer partition boundaries.
For details, see Selection of the partitioning mode for multi-domain cases (p. 359) in ANSYS CFX-Solver
Modeling Guide.
When the coupled partitioning option 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.
8. If required, under Partitioner Memory, adjust the memory configuration. For details, see Configuring Memory
for the CFX-Solver (p. 13).
Partitioning Weighting
As discussed below, partitions can be weighted in different ways. The default setting is Automatic.
• Uniform
• Specified
• Automatic
Uniform
Assigns equal-sized partitions to each process.
Specified
Requires Run Definition to be configured with individual partition weights.
Partition Weights is added to the parallel environment. This allows partition weights to be entered. When more
than one partition is assigned to any machine, the number of partition weight entries must equal the number of
partitions. The partition weight entries should be entered as a comma-separated list. For a distributed run like the
following:
Sys01 1 2
Sys02 2 2, 1.5
Sys03 1 1
Sys01 is therefore a single partition and the weight is 2. Sys02 has two partitions and they are individually
weighted at 2 and 1.5. The final system has a single partition with a weight of 1.
If partition weight factors are used, the ratio of partition weights assigned to each partition controls the partition
size.
Once started, the run progresses through the partitioning, and then into the solution of the CFD problem. Extra
information is stored in the CFX output file for a parallel run. For details, see Partitioning Information (p. 46).
Automatic
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. The entry of
relative speed values is usually carried out during the CFX installation process, and accurate entries for relative
speed can significantly optimize parallel performance.
Solver Tab
1. Select the Solver tab.
If this is not available ensure Show Advanced Controls on the Run Definition tab is selected.
2. Under Run Priority, 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 (p. 129).
3. If required, from Double Precision Override or Executable Settings > Double Precision Override, select
or clear Double Precision. This setting for the solver will override the corresponding specification, if set, on
the Run Definition tab.
For details, see Double-Precision Executables (p. 123).
4. If required, under Solver Memory, adjust the memory configuration. For details, see Configuring Memory
for the CFX-Solver (p. 13).
5. Under Custom Solver Options, click Browse and select a custom executable.
This is done when using a custom solver executable. In addition, any command line arguments that must be
supplied to the program can be entered under Solver Arguments.
Interpolator Tab
1. Select the Interpolator tab.
If this is not available ensure Show Advanced Controls in Run Definition tab is selected.
2. Under Run Priority, select Idle, Low, Standard or High. For a discussion of these priorities, see The
cfx5control Application (p. 129).
3. If required, from Double Precision Override or Executable Settings > Double Precision Override, select
or clear Double Precision. This setting for the interpolator will override the corresponding specification, if
set, on the Run Definition tab.
For details, see Double-Precision Executables (p. 123).
4. If required, under Interpolator Memory, adjust the memory configuration. For details, see Configuring
Memory for the CFX-Solver (p. 13).
3. Catalogue Size Override: If the solver fails with an *.out file containing the error message ***
INSUFFICIENT CATALOGUE SIZE ***, increase the Catalogue Size Override setting to a value above
1 until the solver runs. This parameter has the same syntax as the Detailed Memory Overrides above. For
example, you can scale the default size by using a scale factor greater than 1, such as 1.05 X.
For details, see Starting the CFX-Solver from the Command Line (p. 109).
• Calculate more timesteps for the original run. For details, see Restarting a Run (p. 16).
• View results in CFD-Post (provided that the CFX-Solver produced a results file and did not fail). For details,
see Overview of CFD-Post (p. 1) in the ANSYS CFD-Post User's Guide.
• Print residual plots in the convergence history plots. For details, see Printing an Image of the Convergence
History (p. 2).
• Add comments to the saved version of the text in the text output window. For details, see Starting the CFX-Solver
from the Command Line (p. 109).
• Export results in a format suitable for post-processors other than CFD-Post. For details, see File Export
Utility (p. 131).
• Quit CFX-Solver Manager by selecting File > Quit. This does not stop the CFX-Solver calculation. Additionally,
CFX-Solver Manager can be reopened at any time. For details, see File Menu (p. 85).
The CFX Tutorials describe how to use the CFX-Solver Manager step-by-step for several different cases. If you
are a new user, you should try at least the first few of these.
Parallel Run
Note
CFX-Solver can be run in parallel only if an appropriate license has been purchased.
Overview
There are several parallel run modes, including PVM (Parallel Virtual Machine) and MPI (Message Passing Interface)
communication libraries. Both are simply libraries which allow the flow solver processes to communicate with each
other. An open-source version of MPI, MPICH, implemented at Argonne National Labs, allows communication
over standard TCP/IP networks, as well as through shared memory. Proprietary, vendor specific versions of MPI
are available on some platforms (32-bit Linux, 64-bit Linux and HP-UX ) and support a wider array of high speed
network devices, as well as Shared Memory communication.
General information on setting up a parallel run and advice on obtaining optimal parallel performance is available.
For details, see Using the Solver in Parallel (p. 345) in the ANSYS CFX-Solver Modeling Guide.
Individual machines may need to be configured to run in parallel.
General Procedure
To run CFX-Solver in parallel, the following procedure must be followed:
1. Partition the mesh into the appropriate number of partitions.
2. Run CFX-Solver on the partitioned problem.
These two jobs can be done either as one composite run, or as two separate jobs.
2. Click Add Partition or Remove Partition to increase or decrease the number of partitions.
Partitions may need to be configured based on partition weighting. For details, see discussion in Partitioner
Tab (p. 10).
Overview
To configure a distributed parallel run, a file named hostinfo.ccl must exist in the <CFXROOT>/config/ CFX
directory on the master node and be readable by all users of the software. This file is a database containing information
about available nodes and where ANSYS CFX is installed on each of them.
Note
• If running machines as slave nodes, ensure rsh service is installed and working on each of those
machines (many Windows machines do not already have an rsh service installed). If running MPICH2
on Windows, additional steps are required. For details, see the installation documentation.
• MPICH cannot be used with a mixture of UNIX and Windows machines.
• The cfx5parhosts utility operates on the hostinfo.ccl file; in releases prior to Release 12.0, it
operated on the hosts.ccl file. This change was made necessary by a CCL change.
4. Configure each host as required. For details, see Configuring a Host (p. 15).
Configuring a Host
Each parallel host can be configured independently.
1. In Parallel Environment, under Host Name, select the host to configure.
2. Click Add Partition or Remove Partition to increase or decrease the number of partitions.
Partitions may need to be configured based on partition weighting. For details, see discussion in Partitioner
Tab (p. 10).
Restarting a Run
A CFX-Solver run that has stopped may be restarted for the following reasons:
• The CFX-Solver stopped prematurely, at the user’s request, and now needs to continue running.
• More timesteps are needed to extend the duration of a transient analysis, or more iterations are needed to reach
a required level of convergence for a steady state analysis.
Such restarts are particularly useful because they continue the analysis from where it left off, which is often much
more efficient than re-running the analysis from the original CFX-Solver Input file.
The following discussions describe restarting simulations from CFX-Solver Results files using the same or modified
settings:
• Restart Procedure (p. 16)
• Restart Details (p. 16)
Restart Procedure
1. Select File > Define Run.
2. Select, under CFX-Solver Input File, the CFX-Solver Results file of the previous run.
3. Configure the Define Run dialog box as required.
4. Click Start Run.
Tip
You may also select Workspace > Restart Run to restart the analysis presented in the active
workspace. For details, see File Menu (p. 85).
A new workspace that contains the information relevant for that restart, is created for each restart.
Restart Details
Restarting a run should have little effect on the convergence history and no effect on the final results. Additional
information regarding several types of restarts is presented below.
• Runs Using Mesh Adaption (p. 16)
• Runs After Physical Model or Solver Parameter Changes (p. 16)
• Runs after Topology or Mesh Changes (p. 17)
• Multi-Configuration Simulations (p. 17)
Tip
On the details view of Initialization in CFX-Pre, set the initial conditions for the variables contained in
the old results file to Automatic. This will ensure that they will be restarted.
Changing the fundamental physics of an analysis, such as the fluids and/or materials involved, is not recommended.
Do not change the reference pressure.
Note
If a run which requires wall scale to be calculated is restarted, and a wall scale-related setting was changed
(for example, a free slip wall changed to a no-slip wall), wall scale will not automatically be recalculated
if its calculation was terminated in a previous run. To force it to be recalculated, set the expert parameter
ignore solve flag on restart to true. For details on expert parameters, see CFX-Solver
Expert Control Parameters (p. 363) in ANSYS CFX-Solver Modeling Guide.
Additional information on initial conditions is available in the Initialization (p. 123) in the ANSYS CFX-Pre User's
Guide. More details about using Initial Values File in the Define Run dialog box in CFX-Solver Manager are
available in Reading the Initial Conditions from a File (p. 81) in ANSYS CFX-Solver Modeling Guide.
Multi-Configuration Simulations
Multi-configuration simulations may only be restarted from a multi-configuration results (.mres) file. The simulation
will continue from the final simulation step contained in the specified results file as follows:
• If all active configurations in that simulation step completed successfully, then the new run will begin with the
next simulation step.
• If all active configurations in that simulation step failed to complete successfully, then the new run will attempt
to complete the final simulation step and execute the configurations that are still active. This occurs if the
simulation is stopped prematurely.
Care is required when CCL changes are made before continuing a multi-configuration simulation. This is because
CCL is propagated (that is re-used) from the multi-configuration results (*.mres) and most recently created
configuration results (*.res) files. In particular:
• Global CCL changes (for instance, LIBRARY, SIMULATION CONTROL contents including EXECUTION
CONTROL, etc…) must be applied to the multi-configuration results file.
• Configuration specific CCL changes (such as FLOW contents) must be applied to the most recently generated
configuration results files.
Important
Previously created configuration results (*.res) files are required for accurate CCL propagation (as
noted above) and to resolve configuration dependent initial values, as defined in Run Definition Tab (p.
225) in ANSYS CFX-Pre User's Guide. Paths to these results files are stored and re-used when restarting
multi-configuration simulations, and these paths are relative to the working directory. For example, the
stored path for the first run of the configuration name Configuration1 corresponding to the
multi-configuration results file named mySim_001.mres is:
mySim_001/configuration1_001.res.
Use of relative paths allows the directories (and files) for a multi-configuration simulation to be transferred
to another working directory (for example, on another file system) to perform a restart. Restarts are not
possible if the required directories (and files) have not been transferred to the desired working directory.
Note
If a restart is performed using a specific configuration’s result file (for example,
configuration1_001.res), then only that configuration will continue execution, but the
multi-configuration simulation will not continue.
Note
ANSYS Multi-field runs can only be launched if ANSYS is installed and licensed.
Overview
An ANSYS Multi-field run allows the coupling of CFX-Solver with ANSYS Solver in order to execute cases that
require two-way fluid-structure interaction. Such cases are described in detail in Using CFX and the Mechanical
Application (p. 76) in the ANSYS CFX Reference Guide and Coupling CFX to an External Solver: ANSYS
Multi-field Simulations (p. 295) in the ANSYS CFX-Solver Modeling Guide.
General Procedure
The steps which take place when a full ANSYS Multi-field run (where MFX Run Mode is set to Start ANSYS
and CFX) is launched from the CFX-Solver Manager are listed below.
1. User supplies CFX-Solver input file and ANSYS input file.
2. If the ANSYS input file does not already contain multi-field settings, then Process ANSYS Input File must
be enabled, and a new "multi-field" file with extension .mf is created in the ANSYS working directory. This
processing step is described more fully in Processing the ANSYS Input File (p. 21).
3. The ANSYS Solver is launched, reading input from the new .mf file if it was created in the previous step, or
from the original ANSYS input file if that file already contained the multi-field settings.
4. CFX-Solver is launched and is already set up to communicate with ANSYS Solver. The full range of parallel
and other solver options (such as double precision) is available for CFX-Solver when run as part of an ANSYS
Multi-field run.
5. The run executes.
Many of these steps can be performed separately if required. The workflow and reasons for doing this are described
in the following sections:
Directory Structure
For a normal CFX run (not an ANSYS Multi-field run), you must specify a working directory in the Define Run
dialog box. This defaults to the directory from which the CFX-Solver Manager was started.
Once the run is started, a run name is generated. This is the name of the CFX-Solver input file with the extension
removed and a three-digit number added. The number is usually 001 if this is the first time CFX-Solver Manager
is used for this CFX-Solver input file. In general, it is the lowest number that prevents files from previous runs
being overwritten.
Whilst the run is in progress, a CFX working directory with the name <jobname>.dir will exist within the CFX
working directory, which contains the temporary files for CFX-Solver. When the run has finished, you will find
the files <run_name>.res and <run_name>.out in the CFX working directory, and in certain circumstances
(generally when transient results files or backup files are present) a directory <run_name> will also be present.
This directory structure is unchanged for the CFX part of an ANSYS Multi-field run. However, a new directory
<run_name>.ansys is also created in the CFX working directory. This directory is used as the ANSYS working
directory by the ANSYS solver, and all files generated by ANSYS will be placed in this directory, including the
ANSYS results file.
Almost all files produced by ANSYS have a name of the form <jobname>.* (the exception is the ANSYS GST
file, which will always be called ANSYS.gst when a run is started from the CFX-Solver Manager or ANSYS
Launcher). ANSYS Multi-field runs started from the CFX-Solver Manager have a default jobname of ANSYS. So,
for example, the results file will be ANSYS.rst for a case involving structural physics or ANSYS.rth for a case
involving only thermal physics. Note also that all text output generated by the ANSYS solver (that is, standard error
and standard output) is written to the ANSYS.stdout file. These files will be in the directory
<run_name>.ansys. The jobname can be specified explicitly if you start the ANSYS Multi-field run from the
command line. For details, see Starting an ANSYS Multi-field Run from the Command Line (p. 20).
2. Under File type, select the type of files to view. This setting usually corresponds to a CFX results file.
3. Browse to the directory containing the finished run.
4. Select the run to view.
5. Click OK.
• If the CFX CCL contains definitions for backup files or transient results files (of any kind) that are specified
with an Output Frequency of Coupling Step Interval or Every Coupling Step, then an MFOU
command is generated with a corresponding argument, to get ANSYS to write out its results at the same frequency.
For example, if Output Frequency is set to Every Coupling Step then MFOU,1 is written, and if Output
Frequency is set to Coupling Step Interval with the interval set to every five coupling steps, then
MFOU,5 is generated. If multiple backup and transient results objects are present, then the MFOU command
which corresponds to the smallest coupling interval is written.
• The processing always adds a KBC,1 command to the input file, as this is required for any multi-field case.
• The processing always adds the /GST command to ensure output for monitoring the run is available, and the
CMWRITE command to ensure that any named selections or components in the ANSYS input file are available
for CFD-Post to use. For details, see ANSYS Files (p. 74) in the ANSYS CFD-Post User's Guide.
1. Coupling Initial Time must be set to Value, with the value set to the time value that you want to restart from.
This can be done by editing the CCL in the “full” CFX backup (*.bak) or “full” CFX transient file (*.trn)
from the initial run, or by re-writing the original CFX-Solver input file with the new setting (found on the
Analysis Type panel).
2. Start the CFX-Solver Manager and open the Define Run dialog box. Select the CFX results file from the end
of the previous run as the CFX-Solver input file if this contains the correct coupling initial time; otherwise
select the CFX-Solver input file with the correct coupling initial time and use the previous results file as an
initial values file.
3. On the MultiField tab, enable the Restart ANSYS Run toggle, and browse to find the database (*.rdb)
from the initial run. The database can be found in the directory <run_name>.ansys from the previous run
if that run was launched by the CFX-Solver Manager or the CFX-Solver script cfx5solve.
4. Start the run as normal. Behind the scenes, the CFX-Solver script will copy the required files from the previous
ANSYS run into the new ANSYS working directory so that everything should proceed smoothly.
However, restarting from an intermediate point of a previous run is not always possible:
• If the initial run did not complete normally, it depends on the exact circumstances of the failure as to whether
it is possible to restart from an intermediate point. The ANSYS Solver requires certain information in order to
restart correctly, some of which is only written at the end of a run, and so the ability to restart depends on whether
the ANSYS Solver was able to write that information.
• Restarting from an intermediate point is limited to ANSYS runs which contain only mechanical and/or thermal
physics. If the ANSYS setup contains additional physics such as electromagnetic physics, then it will not be
possible.
• Restarting from an intermediate point relies on the presence of a set of files for a "multiframe restart". For details,
see Singleframe and Multiframe Restarts (p. 24). The availability of these files depends on the presence of a
command RESCONTROL and its setting in the ANSYS input file. In general, ANSYS input files generated from
Simulation have the command RESCONTROL set so that the set of files required is not present. To ensure that
the files are present wherever possible, add the command RESCONTROL,DEFINE,ALL to the ANSYS input
file directly or to a Commands object in the relevant Solution item in the tree within Simulation. More
details can be found in the ANSYS documentation, in “Multiframe Restart”. You can check whether the required
set of files is present by looking for a database with extension *.rdb in the ANSYS working directory from
the initial run. If it is present, then the required file set has been written and you should be able to restart from
an intermediate point, subject to the conditions regarding how the initial run was terminated noted above.
• Restarting from an intermediate point requires a CFX full backup or full transient file for that time value in
addition to having the appropriate ANSYS files for that time value.
3. Start the run as normal. Behind the scenes, the CFX-Solver script will create the ANSYS working directory c
and place a file called ANSYS.mf inside it.
4. In a text editor, edit the file ANSYS.mf to add ANSYS commands to make any changes to the physics that
you require.
5. In the CFX-Solver Manager, define a new run. Select the appropriate CFX-Solver input file or results file for
the restart.
6. On the MultiField tab, set MFX Run Mode to Start ANSYS and CFX. For ANSYS Input File, select
the ANSYS.mf file that you have just been editing. Toggle off Process ANSYS Input File. Ensure
that the Restart ANSYS Run toggle is still enabled, and browse to find the database (*.db or *.rdb) from
the initial run. The database can be found in the directory <run_name>.ansys from the previous run if that
run was launched by the CFX-Solver Manager or the CFX-Solver script cfx5solve.
7. Start the run. Behind the scenes, the CFX-Solver script will copy the required files from the previous ANSYS
run into the new ANSYS working directory so that everything should proceed smoothly.
Restart Limitations
Restarted simulations will give results that are identical to continuous simulations if fields and loads are converged
within each multi-field timestep.
Discontinuities in the convergence history upon restarts can be eliminated by running the ANSYS field solver first
within each stagger iteration, and executing two or more stagger iterations per multi-field timestep.
CFX-Solver Input (.def) Initial Values object(s) using the Results File Supplement initial
option that references a CFX-Solver Results file conditions in the Solver
(.res, .trn, .bak). Input File with solution
values contained in the
results file referenced by
Multi-Configuration Simulations
Solver Input File Configuration-Specific Initial Values Description
Specification
CFX-Solver Input file (.mdef) Initial Values object(s) using the Results File Supplement initial
option that references a CFX-Solver Results file conditions in
(.res, .trn, .bak). configuration definitions
with those contained in
the results file(s)
referenced by the Initial
Values object(s).
CFX-Solver Input file (.mdef) Initial Values object(s) using the Configuration Supplement initial
Results option that references a configuration. conditions in
configuration definitions
with solution values
contained in the latest
results file
corresponding to the
configuration(s)
referenced by the Initial
Values object(s).
Note
• For multi-configuration simulations:
• Global (or simulation) level Initial Values specifications are not valid,
• A configuration level Solver Input File is implied in the multi-configuration setup (i.e. it is not
required)
• Setting the Initial Values Specification > Use Mesh From option to Solver Input File will activate
the CFX-Interpolator to either copy or interpolate solution values from the mesh in the Initial Values
object(s) to the Solver Input File. See Using the CFX-Interpolator (p. 86) in ANSYS CFX-Solver
Modeling Guide for details.
• Setting the Initial Values Specification > Use Mesh From option to Initial Values will use the
mesh from the Initial Values File and de-activate the CFX-Interpolator. . See Using the Mesh from
the Initial Values File (p. 84) in ANSYS CFX-Solver Modeling Guide for details.
• Unsetting (i.e. deselecting) the Initial Values Specification > Continue History From option will
reset the run history. and use the Initial Values File to provide a basic initial guess for the new run.
See Continuing the History (p. 82) in ANSYS CFX-Solver Modeling Guide for details
• Setting the Initial Values Specification > Continue History From option will continue the run
history from the results file referenced by the specified Initial Values object, and produce the cleanest
restart possible from the Initial Values File. The first iteration or timestep executed follows the last
one completed in the referenced results file. See Continuing the History (p. 82) in ANSYS CFX-Solver
Modeling Guide for details.
Header
The header is written at the start of every CFX-Solver Output file and contains information regarding the command
which started the job. This information is used to check which files were used to start the run.
+--------------------------------------------------------------------+
| |
| CFX Command Language for Run |
| |
+--------------------------------------------------------------------+
LIBRARY:
MATERIAL: Water
Material Description = Water (liquid)
Material Group = Water Data, Constant Property Liquids
Option = Pure Substance
Thermodynamic State = Liquid
PROPERTIES:
Option = General Material
EQUATION OF STATE:
Density = 997.0 [kg m^-3]
Molar Mass = 18.02 [kg kmol^-1]
Option = Value
END
SPECIFIC HEAT CAPACITY:
Option = Value
Specific Heat Capacity = 4181.7 [J kg^-1 K^-1]
Specific Heat Type = Constant Pressure
END
REFERENCE STATE:
Option = Specified Point
Reference Pressure = 1 [atm]
Reference Specific Enthalpy = 0.0 [J/kg]
Reference Specific Entropy = 0.0 [J/kg/K]
Reference Temperature = 25 [C]
END
DYNAMIC VISCOSITY:
Dynamic Viscosity = 8.899E-4 [kg m^-1 s^-1]
Option = Value
END
THERMAL CONDUCTIVITY:
Option = Value
Thermal Conductivity = 0.6069 [W m^-1 K^-1]
END
ABSORPTION COEFFICIENT:
Absorption Coefficient = 1.0 [m^-1]
Option = Value
END
SCATTERING COEFFICIENT:
Option = Value
Scattering Coefficient = 0.0 [m^-1]
END
REFRACTIVE INDEX:
Option = Value
Refractive Index = 1.0 [m m^-1]
END
THERMAL EXPANSIVITY:
Option = Value
Thermal Expansivity = 2.57E-04 [K^-1]
END
END
END
END
FLOW: Flow Analysis 1
SOLUTION UNITS:
Angle Units = [rad]
Length Units = [m]
Mass Units = [kg]
Solid Angle Units = [sr]
Temperature Units = [K]
Time Units = [s]
END
ANALYSIS TYPE:
Option = Steady State
EXTERNAL SOLVER COUPLING:
Option = None
END
END
DOMAIN: Default Domain
Coord Frame = Coord 0
Domain Type = Fluid
Location = B1.P3
BOUNDARY: Default Domain Default
Boundary Type = WALL
Location = F1.B1.P3,F2.B1.P3,F4.B1.P3,F5.B1.P3,F6.B1.P3,F8.B1.P3
BOUNDARY CONDITIONS:
HEAT TRANSFER:
Option = Adiabatic
END
MASS AND MOMENTUM:
Option = No Slip Wall
END
WALL ROUGHNESS:
Option = Smooth Wall
END
END
END
BOUNDARY: in1
Boundary Type = INLET
Location = in1
BOUNDARY CONDITIONS:
FLOW REGIME:
Option = Subsonic
END
HEAT TRANSFER:
Option = Static Temperature
Static Temperature = 315 [K]
END
MASS AND MOMENTUM:
Normal Speed = 2 [m s^-1]
Option = Normal Speed
END
TURBULENCE:
Option = Medium Intensity and Eddy Viscosity Ratio
END
END
END
BOUNDARY: in2
Boundary Type = INLET
Location = in2
BOUNDARY CONDITIONS:
FLOW REGIME:
Option = Subsonic
END
HEAT TRANSFER:
Option = Static Temperature
Static Temperature = 285 [K]
END
MASS AND MOMENTUM:
Normal Speed = 2 [m s^-1]
Option = Normal Speed
END
TURBULENCE:
Option = Medium Intensity and Eddy Viscosity Ratio
END
END
END
BOUNDARY: out
Boundary Type = OUTLET
Location = out
BOUNDARY CONDITIONS:
FLOW REGIME:
Option = Subsonic
END
MASS AND MOMENTUM:
Option = Average Static Pressure
Pressure Profile Blend = 0.05
Relative Pressure = 0 [Pa]
END
PRESSURE AVERAGING:
Option = Average Over Whole Outlet
END
END
END
DOMAIN MODELS:
BUOYANCY MODEL:
Option = Non Buoyant
END
DOMAIN MOTION:
Option = Stationary
END
MESH DEFORMATION:
Option = None
END
REFERENCE PRESSURE:
Reference Pressure = 1 [atm]
END
END
FLUID DEFINITION: Water
Material = Water
Option = Material Library
MORPHOLOGY:
Option = Continuous Fluid
END
END
FLUID MODELS:
COMBUSTION MODEL:
Option = None
END
HEAT TRANSFER MODEL:
Option = Thermal Energy
END
THERMAL RADIATION MODEL:
Option = None
END
TURBULENCE MODEL:
Option = k epsilon
END
TURBULENT WALL FUNCTIONS:
Option = Scalable
END
END
END
OUTPUT CONTROL:
RESULTS:
File Compression Level = Default
Option = Standard
END
END
SOLVER CONTROL:
Turbulence Numerics = First Order
ADVECTION SCHEME:
Option = Upwind
END
CONVERGENCE CONTROL:
Maximum Number of Iterations = 100
Minimum Number of Iterations = 1
Physical Timescale = 2 [s]
Timescale Control = Physical Timescale
END
CONVERGENCE CRITERIA:
Residual Target = 1.E-4
Residual Type = RMS
END
DYNAMIC MODEL CONTROL:
Global Dynamic Model Control = On
END
END
END
COMMAND FILE:
Version = 12.0.1
Results Version = 12.0
END
SIMULATION CONTROL:
EXECUTION CONTROL:
INTERPOLATOR STEP CONTROL:
Runtime Priority = Standard
EXECUTABLE SELECTION:
Double Precision = Off
END
END
PARALLEL HOST LIBRARY:
HOST DEFINITION: watjpvandoo
Host Architecture String = winnt-amd64
Installation Root = D:\Program Files\ANSYS Inc\v%v\CFX
END
END
PARTITIONER STEP CONTROL:
Multidomain Option = Independent Partitioning
Runtime Priority = Standard
EXECUTABLE SELECTION:
Use Large Problem Partitioner = Off
END
PARTITIONING TYPE:
MeTiS Type = k-way
Option = MeTiS
Partition Size Rule = Automatic
END
END
RUN DEFINITION:
Run Mode = Full
Solver Input File = \
D:\Users\jpvandoo\Documentation\Tutorials\examples\StaticMixer.def
END
SOLVER STEP CONTROL:
Runtime Priority = Standard
EXECUTABLE SELECTION:
Double Precision = Off
END
PARALLEL ENVIRONMENT:
Number of Processes = 1
Start Method = Serial
END
END
END
END
+--------------------------------------------------------------------+
| Job Information |
+--------------------------------------------------------------------+
Run mode: serial run
Host computer: pesky
Job started: Thu Nov 20 15:07:27 2008
+--------------------------------------------------------------------+
| Memory Allocated for Run (Actual usage may be less) |
+--------------------------------------------------------------------+
Mesh Statistics
The mesh statistics summarize domain-specific and global (that is, the combination of all domains):
• mesh quality diagnostics,
• the total number of nodes, elements and boundary faces in the mesh, and
• the area fractions of mesh interfaces that were unmapped
Mesh quality diagnostics include measures of mesh orthogonality, expansion and aspect ratio (see Mesh Issues (p.
321)) For each measure, there are value ranges that are considered good, acceptable, and poor (i.e. may produce
accuracy or convergence problems). These ranges are annotated with OK, ok, and !, respectively, in the mesh
diagnostics summary. The relevant minimum or maximum value is presented for each measure, plus a summary of
the percent of the mesh with values in each of the good, acceptable and poor ranges. Note that these percentages
are rounded to the nearest integer value. In the sample output presented below, the worst expansion factor is 37,
which is considered poor (i.e. annotated with !). While slightly more than 1% of the impeller mesh exhibits similarly
poor values, less than 1% of the global mesh is considered poor and ‘<1' is entered in the summary.
The section for mesh statistics looks similar to the following:
+--------------------------------------------------------------------+
| Mesh Statistics |
+--------------------------------------------------------------------+
| Domain Name | Orthog. Angle | Exp. Factor | Aspect Ratio |
+----------------------+---------------+--------------+--------------+
| | Minimum [deg] | Maximum | Maximum |
+----------------------+---------------+--------------+--------------+
| impeller | 34.7 ok | 37 ! | 13 OK |
| tank | 61.4 OK | 11 ok | 303 OK |
| Global | 34.7 ok | 37 ! | 303 OK |
+----------------------+---------------+--------------+--------------+
Global Statistics :
+--------------------------------------------------------------------+
| Average Scale Information |
+--------------------------------------------------------------------+
Solved Equations
This section lists the dependent variables solved and the equations to which they relate as well as the estimated
physical timestep if calculated automatically.
Equations are given two labels: the individual name and a combined name used for combining residuals together.
Residuals for multi-domain problems are combined provided the domains are connected together and have the same
domain type (solid or fluid/porous). If there are multiple groups of the same domain type, then the group residual
is identified by the name of the first domain in the connected group.
The section for solved equations looks similar to the following:
+--------------------------------------------------------------------+
| The Equations Solved in This Calculation |
+--------------------------------------------------------------------+
Subsystem : Momentum and Mass
U-Mom
V-Mom
W-Mom
P-Mass
Subsystem : Thermal Radiation
I-Radiation
Subsystem : Heat Transfer
H-Energy
Subsystem : Temperature Variance
T-Variance
Subsystem : TurbKE and Diss.K
K-TurbKE
E-Diss.K
Subsystem : Mixture Fraction
Z-Mean
Z-Variance
Subsystem : Mass Fractions
NO-Mass Fraction
Convergence History
The convergence history section details the state of the solution as it progresses. Equation residual information at
specified locations allows you to monitor the convergence. Convergence difficulties can often be pinpointed to a
particular part of the solution (for example, the momentum equation), and/or a particular location.
The tables shown in the convergence history have the following columns:
• Rate
The rate is defined as seen in Equation 3.1 (p. 36) where R n is the residual at iteration n, and R n − 1 is the residual
at an earlier iteration. Rates less than 1.0 indicate convergence.
Rn
Rate = (Eq. 3.1)
R n −1
• RMS Res
The value of the root mean square normalized residual taken over the whole domain.
• Max Res
The value of the maximum normalized residual in the domain.
• Linear Solution
The three columns in this section refer to the performance of the linear (inner) solvers. The first column is the
average number of iterations the linear solvers attempted to obtain the specified linear equation convergence
criteria (within a specified number of iterations). The second column gives the normalized residuals for the
solutions to the linear equation. The last column can have one of four entries:
• * indicates that there was a numerical floating point exception and this resulted in the failure of the linear
solvers.
• F indicates that the linear solvers did not reduce the residuals (that is, the solution was diverging), but the
linear solvers may carry on if the divergence is not catastrophic.
• ok indicates that the residuals were reduced, but that the degree of reduction did not meet the specified
criteria.
• OK indicates that the specified convergence criteria for the reduction of residuals was achieved.
After the convergence criteria has been achieved, or the specified number of timesteps has been reached, CFX-Solver
appends additional information, calculated from the solution, to the &cfxsolvout-tl; file.
The convergence history for a steady state analysis looks similar to the following:
+--------------------------------------------------------------------+
| Convergence History |
+--------------------------------------------------------------------+
======================================================================
OUTER LOOP ITERATION = 1 CPU SECONDS = 2.68E+00
----------------------------------------------------------------------
| Equation | Rate | RMS Res | Max Res | Linear Solution |
+----------------------+------+---------+---------+------------------+
| U - Mom | 0.00 | 1.5E-10 | 5.4E-09 | 1.5E+10 ok|
| V - Mom | 0.00 | 1.6E-04 | 3.2E-03 | 6.4E+01 ok|
| W - Mom | 0.00 | 2.5E-10 | 6.4E-09 | 1.1E+10 ok|
| P - Mass | 0.00 | 2.2E-03 | 3.0E-02 | 12.0 9.5E-02 OK|
+----------------------+------+---------+---------+------------------+
| H-Energy | 0.00 | 3.6E-03 | 3.6E-02 | 5.4 8.0E-03 OK|
+----------------------+------+---------+---------+------------------+
======================================================================
OUTER LOOP ITERATION = 2 CPU SECONDS = 1.24E+01
----------------------------------------------------------------------
| Equation | Rate | RMS Res | Max Res | Linear Solution |
+----------------------+------+---------+---------+------------------+
| U - Mom |99.99 | 5.2E-03 | 7.5E-02 | 4.8E-02 OK|
| V - Mom |99.76 | 1.6E-02 | 1.6E-01 | 1.4E-02 OK|
| W - Mom |99.99 | 8.4E-03 | 1.2E-01 | 7.9E-02 OK|
| P - Mass | 4.26 | 9.3E-03 | 1.3E-01 | 8.3 8.4E-02 OK|
+----------------------+------+---------+---------+------------------+
| H-Energy | 0.35 | 1.3E-03 | 8.8E-03 | 9.4 2.9E-03 OK|
+----------------------+------+---------+---------+------------------+
................
................
======================================================================
OUTER LOOP ITERATION = 29 CPU SECONDS = 2.44E+02
----------------------------------------------------------------------
| Equation | Rate | RMS Res | Max Res | Linear Solution |
+----------------------+------+---------+---------+------------------+
| U - Mom | 0.86 | 7.7E-05 | 3.1E-04 | 5.1E-02 OK|
| V - Mom | 0.86 | 9.1E-05 | 3.7E-04 | 4.8E-02 OK|
| W - Mom | 0.86 | 1.9E-05 | 1.6E-04 | 5.0E-02 OK|
| P - Mass | 0.87 | 3.7E-05 | 1.7E-04 | 8.3 3.0E-02 OK|
+----------------------+------+---------+---------+------------------+
| H-Energy | 0.86 | 5.7E-06 | 5.5E-05 | 9.5 9.8E-03 OK|
+----------------------+------+---------+---------+------------------+
CFD Solver finished: Wed Oct 25 16:01:48 2000
CFD Solver wall clock seconds: 1.0000E+00
If a steady state analysis is continued, then the outer loop iterations and CPU seconds for the current run are enclosed
in parenthesis, as shown below. Values not enclosed in parenthesis are the totals for the overall analysis.
======================================================================
OUTER LOOP ITERATION = 30 ( 1) CPU SECONDS = 2.48E+02 ( 3.38E+00)
----------------------------------------------------------------------
| Equation | Rate | RMS Res | Max Res | Linear Solution |
+----------------------+------+---------+---------+------------------+
| U - Mom | 0.00 | 1.5E-04 | 1.2E-03 | 4.6E-02 OK|
| V - Mom | 0.00 | 2.1E-04 | 1.2E-03 | 3.8E-02 OK|
| W - Mom | 0.00 | 1.5E-04 | 2.1E-03 | 1.3E-02 OK|
| P - Mass | 0.00 | 3.2E-05 | 1.5E-04 | 8.3 3.4E-02 OK|
+----------------------+------+---------+---------+------------------+
| H-Energy | 0.00 | 7.7E-06 | 8.5E-05 | 9.5 9.1E-03 OK|
+----------------------+------+---------+---------+------------------+
+--------------------------------------------------------------------+
| Computed Model Constants |
+--------------------------------------------------------------------+
Turbulence viscosity for Turbulence Model 1 = 3.3667E+00
======================================================================
Termination and Interrupt Condition Summary
======================================================================
CFD Solver: <internal termination condition description>
User: <interrupt condition object name>
Domain Imbalance
% imbalance =
M aximum Over All Domains
where “Maximum Over All Domains” is the maximum absolute value, over all boundaries and sources, in all
domains. For domain sources, with the exception of user defined source terms, the positive and negative contributions
are balanced separately.
For details, see Monitoring and Obtaining Convergence (p. 336) in the ANSYS CFX-Solver Modeling Guide.
The section for global conservation statistics looks similar to the following:
======================================================================
Boundary Flow and Total Source Term Summary
======================================================================
+--------------------------------------------------------------------+
| U-Mom |
+--------------------------------------------------------------------+
Boundary : CatConv Default -9.4754E-01
Boundary : Inlet 1.6971E+00
Boundary : InletSide Side 1 1.3262E-05
Boundary : Outlet -1.0523E+00
Boundary : OutletSide Side 1 -1.7085E-07
Sub-Domain : catalyst 2.6129E-01
Neg Accumulation : CatConv 4.1436E-02
Domain Interface : InletSide (Side 1) -1.1166E-02
Domain Interface : InletSide (Side 2) 1.1166E-02
Domain Interface : OutletSide (Side 1) -1.4308E-05
Domain Interface : OutletSide (Side 2) 1.4308E-05
-----------
Domain Imbalance : -3.6059E-05
+--------------------------------------------------------------------+
| V-Mom |
+--------------------------------------------------------------------+
Boundary : CatConv Default -3.3355E-02
Boundary : Inlet 1.1009E-07
Boundary : InletSide Side 1 7.2564E-06
Boundary : Outlet -4.7561E-04
Boundary : OutletSide Side 1 1.9734E-08
Sub-Domain : catalyst 3.4056E-02
Neg Accumulation : CatConv -2.4319E-04
Domain Interface : InletSide (Side 1) -4.7260E-04
Domain Interface : InletSide (Side 2) 4.7262E-04
Domain Interface : OutletSide (Side 1) 7.5672E-06
Domain Interface : OutletSide (Side 2) -7.5672E-06
-----------
Domain Imbalance : -1.0275E-05
+--------------------------------------------------------------------+
| W-Mom |
+--------------------------------------------------------------------+
Boundary : CatConv Default -1.1450E+01
Boundary : Inlet -1.6971E+00
Boundary : InletSide Side 1 1.3180E-01
+--------------------------------------------------------------------+
| P-Mass |
+--------------------------------------------------------------------+
Boundary : Inlet 2.8382E-02
Boundary : Outlet -5.6938E-02
Neg Accumulation : CatConv 2.8576E-02
Domain Interface : InletSide (Side 1) -3.0665E-02
Domain Interface : InletSide (Side 2) 3.0665E-02
Domain Interface : OutletSide (Side 1) 5.6543E-02
Domain Interface : OutletSide (Side 2) -5.6543E-02
-----------
Domain Imbalance : 2.0828E-05
+--------------------------------------------------------------------+
| I-Radiation |
+--------------------------------------------------------------------+
Boundary : CatConv Default -1.4392E+01
Boundary : Inlet 1.9442E+01
Boundary : InletSide Side 1 3.8307E-01
Boundary : Outlet -6.1793E+00
Boundary : OutletSide Side 1 -1.7803E-01
Domain Src (Neg) : CatConv -2.9646E-01
Domain Src (Pos) : CatConv 3.0447E-01
Domain Interface : InletSide (Side 1) -4.6702E+02
Domain Interface : InletSide (Side 2) 4.6702E+02
Domain Interface : OutletSide (Side 1) -7.4487E+01
Domain Interface : OutletSide (Side 2) 7.4490E+01
-----------
Domain Imbalance : -9.0640E-01
+--------------------------------------------------------------------+
| H-Energy |
+--------------------------------------------------------------------+
Boundary : CatConv Default 1.4284E+01
Boundary : Inlet 8.6049E+03
Boundary : InletSide Side 1 -3.8344E-01
Boundary : Outlet -2.3960E+02
Boundary : OutletSide Side 1 1.7809E-01
Domain Src (Neg) : CatConv -3.0461E-01
Domain Src (Pos) : CatConv 2.9616E-01
Neg Accumulation : CatConv -8.3717E+03
Lift is the net force on the body in the direction perpendicular to the direction of flow. In the above diagram, the
lift is the sum of the forces on the wall in the vertical direction, that is, the sum of the pressure force and the viscous
force components in the y direction.
Drag is the net force on the body in the direction of the flow. In the above diagram, the drag is the sum of the forces
on the wall in the horizontal direction, that is, the sum of the pressure force and the viscous force components in
the x direction.
It is apparent from this that viscous force is not a pure shear force since it also has a small component in the normal
direction, arising in part from a normal component in the laminar flow shear stress.
The pressure and viscous moments are related to the pressure and viscous forces calculated at the wall. The pressure
moment is the vector product of the pressure force vector Fn and the position vector r. The viscous moment is the
vector product of the viscous force vectorFt and the position vector r. As an example, review Equation 3.2 (p. 40)
where M n and M t are the pressure and viscous moments respectively.
JG JGJ
M n = r × Fn
JG JG (Eq. 3.2)
M t = r × Ft
These are summed over all the surface elements in the wall.
It is important to note that forces are evaluated in the local reference frame and that they do not include reference
pressure effects. The pressure force is calculated as the integral of the relative pressure over the wall area and not
as the integral of the sum of the reference and relative pressures. You can include reference pressure effects in the
force calculation by setting the expert parameter include pref in forces = t.
It is also important to note that for rotating domains in a transient run, forces are evaluated in the reference frame
fixed to the initial domain orientation. These quantities are not influenced by any rotation that might occur during
a transient run or when a rotational offset is specified. However, results for rotating domains in a transient run may
be in the rotated position (depending on the setting of Options in CFD-Post) when they are subsequently loaded
into CFD-Post for post-processing.
The sections for calculated wall forces and moments look similar to the following:
======================================================================
Wall Force and Moment Summary
======================================================================
Notes:
1. Pressure integrals exclude the reference pressure. To include
it, set the expert parameter 'include pref in forces = t'.
+--------------------------------------------------------------------+
| Pressure Force On Walls |
+--------------------------------------------------------------------+
X-Comp. Y-Comp. Z-Comp.
+--------------------------------------------------------------------+
| Viscous Force On Walls |
+--------------------------------------------------------------------+
X-Comp. Y-Comp. Z-Comp.
+--------------------------------------------------------------------+
| Locations of Maximum Residuals |
+--------------------------------------------------------------------+
| Equation | Node # | X | Y | Z |
+--------------------------------------------------------------------+
| U - Mom | 728 | 6.168E-01 | 5.387E-02 |-6.187E-01 |
| V - Mom | 85 | 6.136E-01 | 1.902E+00 | 6.846E-01 |
| W - Mom | 483 |-6.772E-01 | 2.826E-01 |-8.441E-01 |
| P - Mass | 413 | 7.552E-01 |-3.366E-01 |-7.821E-01 |
| H-Energy | 2083 | 6.121E-01 | 1.640E+00 | 1.178E+00 |
+--------------------------------------------------------------------+
+--------------------------------------------------------------------+
+--------------------------------------------------------------------+
| False Transient Information |
+--------------------------------------------------------------------+
| Equation | Type | Elapsed Pseudo-Time |
+--------------------------------------------------------------------+
| U - Mom | Physical | 5.80000E+01 |
| V - Mom | Physical | 5.80000E+01 |
| W - Mom | Physical | 5.80000E+01 |
| P - Mass | Physical | 5.80000E+01 |
| H-Energy | Physical | 5.80000E+01 |
+--------------------------------------------------------------------+
+--------------------------------------------------------------------+
| Average Scale Information |
+--------------------------------------------------------------------+
Domain Name : StaticMixer
Global Length = 3.2113E+00
Density = 9.9800E+02
Dynamic Viscosity = 1.0000E-03
Velocity = 1.4534E+00
Advection Time = 2.2095E+00
Reynolds Number = 4.6581E+06
Thermal Conductivity = 5.9100E-01
Specific Heat Capacity at Constant Pressure = 4.1900E+03
Prandtl Number = 7.0897E+00
Temperature Range = 3.0008E+01
+--------------------------------------------------------------------+
| Variable Range Information |
+--------------------------------------------------------------------+
Domain Name : StaticMixer
+--------------------------------------------------------------------+
| Variable Name | min | max |
+--------------------------------------------------------------------+
| Velocity u | -1.65E+00 | 1.61E+00 |
| Velocity v | -2.26E+00 | 2.25E+00 |
| Velocity w | -4.13E+00 | 2.58E-01 |
| Pressure | -6.71E+02 | 1.38E+04 |
| Density | 9.98E+02 | 9.98E+02 |
| Dynamic Viscosity | 1.00E-03 | 1.00E-03 |
| Specific Heat Capacity at Constant Pressure| 4.19E+03 | 4.19E+03 |
| Thermal Conductivity | 5.91E-01 | 5.91E-01 |
| Thermal Expansivity | 2.10E-04 | 2.10E-04 |
| Eddy Viscosity | 1.89E+01 | 1.89E+01 |
| Temperature | 2.85E+02 | 3.15E+02 |
| Static Enthalpy | 1.19E+06 | 1.32E+06 |
+--------------------------------------------------------------------+
CPU Requirements
The section for CPU requirements looks similar to the following:
+--------------------------------------------------------------------+
| CPU Requirements of Numerical Solution - Total |
+--------------------------------------------------------------------+
Job Information
The section for job information looks similar to the following:
+--------------------------------------------------------------------+
| Job Information |
+--------------------------------------------------------------------+
Host computer: machinename
Job finished: Fri Feb 10 15:14:32 2006
Total CPU time: 9.524E+01 seconds
or: ( 0: 0: 1: 35.240 )
( Days: Hours: Minutes: Seconds )
Total wall clock time: 2.720E+02 seconds
or: ( 0: 0: 1: 42.000 )
Convergence History
The convergence history for a transient analysis looks similar to the following:
=======================================================================
TIME STEP = 2 SIMULATION TIME = 5.00E-01 CPU SECONDS = 2.14E+01
----------------------------------------------------------------------
COEFFICIENT LOOP ITERATION = 1
----------------------------------------------------------------------
| Equation | Rate | RMS Res | Max Res | Linear Solution |
+----------------------+------+---------+---------+------------------+
| U - Mom |99.99 | 9.6E-01 | 7.7E+00 | 5.8E-04 OK|
| V - Mom |99.99 | 2.2E-01 | 2.9E+00 | 2.7E-03 OK|
| W - Mom |99.99 | 4.2E-01 | 4.4E+00 | 5.4E-04 OK|
| P - Mass | .12 | 3.0E-03 | 4.0E-02 | 12.0 4.6E-02 OK|
+----------------------+------+---------+---------+------------------+
| Smoke | .89 | 6.4E-02 | 7.3E-01 | 5.4 5.4E-05 OK|
+----------------------+------+---------+---------+------------------+
| K-TurbKE | .53 | 2.1E-01 | 5.0E-01 | 5.4 3.9E-05 OK|
+----------------------+------+---------+---------+------------------+
| E-Diss.K | .73 | 5.2E-01 | 9.5E-01 | 5.4 2.4E-05 OK|
+----------------------+------+---------+---------+------------------+
----------------------------------------------------------------------
COEFFICIENT LOOP ITERATION = 2 CPU SECONDS = 2.83E+01
----------------------------------------------------------------------
| Equation | Rate | RMS Res | Max Res | Linear Solution |
+----------------------+------+---------+---------+------------------+
| U - Mom | .14 | 1.4E-01 | 1.3E+00 | 2.0E-03 OK|
| V - Mom | .16 | 3.5E-02 | 4.9E-01 | 8.3E-03 OK|
| W - Mom | .14 | 5.8E-02 | 1.0E+00 | 1.6E-03 OK|
| P - Mass | .65 | 1.9E-03 | 3.7E-02 | 8.3 5.3E-02 OK|
+----------------------+------+---------+---------+------------------+
| Smoke | .29 | 1.9E-02 | 2.6E-01 | 5.4 5.6E-05 OK|
+----------------------+------+---------+---------+------------------+
| K-TurbKE | .17 | 3.6E-02 | 2.2E-01 | 5.4 8.2E-05 OK|
+----------------------+------+---------+---------+------------------+
| E-Diss.K | .16 | 8.3E-02 | 2.4E-01 | 5.4 6.4E-05 OK|
+----------------------+------+---------+---------+------------------+
----------------------------------------------------------------------
COEFFICIENT LOOP ITERATION = 3 CPU SECONDS = 3.50E+01
----------------------------------------------------------------------
| Equation | Rate | RMS Res | Max Res | Linear Solution |
+----------------------+------+---------+---------+------------------+
| U - Mom | .24 | 3.3E-02 | 2.8E-01 | 3.8E-03 OK|
If a transient analysis is continued, then the time step counter, simulation time, and CPU seconds for the current
run are enclosed in parenthesis below the totals for the overall analysis, as shown below.
=======================================================================
TIME STEP = 3 SIMULATION TIME = 7.50E-01 CPU SECONDS = 2.84E+01
(THIS RUN: 1 2.50E-01 7.00+00)
----------------------------------------------------------------------
COEFFICIENT LOOP ITERATION = 1
----------------------------------------------------------------------
| Equation | Rate | RMS Res | Max Res | Linear Solution |
+----------------------+------+---------+---------+------------------+
| U - Mom |99.99 | 9.6E-01 | 7.7E+00 | 5.8E-04 OK|
| V - Mom |99.99 | 2.2E-01 | 2.9E+00 | 2.7E-03 OK|
| W - Mom |99.99 | 4.2E-01 | 4.4E+00 | 5.4E-04 OK|
| P - Mass | .12 | 3.0E-03 | 4.0E-02 | 12.0 4.6E-02 OK|
+----------------------+------+---------+---------+------------------+
| Smoke | .89 | 6.4E-02 | 7.3E-01 | 5.4 5.4E-05 OK|
+----------------------+------+---------+---------+------------------+
| K-TurbKE | .53 | 2.1E-01 | 5.0E-01 | 5.4 3.9E-05 OK|
+----------------------+------+---------+---------+------------------+
| E-Diss.K | .73 | 5.2E-01 | 9.5E-01 | 5.4 2.4E-05 OK|
+----------------------+------+---------+---------+------------------+
======================================================================
Interpolating Onto Domain "Bottom Box"
======================================================================
Warning: The target mesh does not intersect with any source meshes
that have the same domain type and motion.
Skip the interpolation.
======================================================================
Interpolating Onto Domain "Top Box"
======================================================================
+--------------------------------------------------------------------+
| Variable Range Information |
+--------------------------------------------------------------------+
+--------------------------------------------------------------------+
| Variable Name | min | max |
+--------------------------------------------------------------------+
| Thermal Conductivity | 2.61E-02 | 2.61E-02 |
| Courant Number | 9.86E-02 | 4.52E+00 |
| Density | 1.18E+00 | 1.18E+00 |
| Static Entropy | 0.00E+00 | 0.00E+00 |
| Pressure | 1.59E+01 | 6.01E+01 |
| Specific Heat Capacity at Constant Pressure| 1.00E+03 | 1.00E+03 |
| Specific Heat Capacity at Constant Volume | 1.00E+03 | 1.00E+03 |
| Temperature | 2.98E+02 | 2.98E+02 |
| Velocity | 2.02E-01 | 8.09E+00 |
| Dynamic Viscosity | 1.83E-05 | 1.83E-05 |
+--------------------------------------------------------------------+
Partitioning Information
If the partitioning step is run, partitioning information pertaining to the current job is displayed. This includes how
the mesh is divided, and CPU requirements for the partitioning process.
The section for partitioning information looks similar to the following:
+--------------------------------------------------------------------+
| Vertex Based Partitioning |
+--------------------------------------------------------------------+
+--------------------------------------------------------------------+
| Partitioning Information |
+--------------------------------------------------------------------+
+------------------+------------------------+-----------------+
+--------------------------------------------------------------------+
| Partitioning CPU-Time Requirements |
+--------------------------------------------------------------------+
Job Information
The section for job information includes master and slave partition process details, and looks similar to the following:
+--------------------------------------------------------------------+
| Job Information |
+--------------------------------------------------------------------+
Host Information
The section for host information looks similar to the following:
+-----------------------------------------------------------------------+
| Host Information |
+-----------------------------------------------------------------------+
| Name | Rel. Speed | # of Proc. | # of Part | Stat. Load |
+-----------------+--------------+------------+------------+------------+
| camel | 1.00000 | 1 | 1 | 100.0 % |
+--------------------------------------------------------------------+
| Memory Allocated for Run (Actual usage may be less) |
+--------------------------------------------------------------------+
+--------------------------------------------------------------------+
| Job Information |
+--------------------------------------------------------------------+
Host computer: fastmachine1
Par. Process: Master running on mesh partition: 1
Job finished: Thu Nov 28 16:44:01 2005
Total CPU time: 9.025E+02 seconds
or: ( 0: 0: 15: 2.517 )
( Days: Hours: Minutes: Seconds )
Host computer: slowermachine
Par. Process: Slave running on mesh partition: 2
Job finished: Wed Nov 28 16:54:30 2005
Total CPU time: 1.291E+03 seconds
or: ( 0: 0: 21: 31.034 )
( Days: Hours: Minutes: Seconds )
Total wall clock time: 1.146E+03 seconds
or: ( 0: 0: 19: 6.000 )
+--------------------------------------------------------------------+
| |
| Mesh Refinement |
| |
+--------------------------------------------------------------------+
Adaption step 2 of 3.
Number of elements initially marked for refinement: 480
Number of elements removed because:
They already meet the minimum length criteria: 0
They are in regions not marked for refinement: 0
They are already in the deepest refinement level: 0
There are not enough nodes available to refine them: -425
----------
55
----------
Target number of nodes at end of step: 1512
Number of vertices in the final mesh: 1999
Number of elements in the final mesh: 1560
+--------------------------------------------------------------------+
| Total number of Vertices, Elements, and Faces |
+--------------------------------------------------------------------+
Domain Name : nozzle vmi
Total Number of Nodes = 1999
Total Number of Elements = 1560
Total Number of Tetrahedrons = 146
Total Number of Hexahedrons = 818
Total Number of Pyramids = 596
Total number of Faces = 1702
+--------------------------------------------------------------------+
| |
| Remeshing |
| |
+--------------------------------------------------------------------+
CFX Solver Results generated before remeshing have been written to:
d:\ICEMRemesh\ballvalve1_001\5_oldmesh.res
Each active remesh object is listed, along with the name of the solver interrupt condition(s) that activated it, and
the command used to generate the new mesh. Any output generated during remeshing is redirected into a text file,
which, along with the CFX-Solver Results file from the previous run, is placed into the final results directory for
the run. The locations of these files is listed in the output.
Once the updated meshes have been generated, CFX-Pre loads the CFX-Solver Results file from the previous run,
replaces the old meshes with the updated ones, and writes a new CFX-Solver Input file.
A CFX-Solver run is then started with the new CFX-Solver Input file, using the CFX-Solver Results file from the
previous run for initial values. Partitioning is also performed for parallel run modes.
+--------------------------------------------------------------------+
| Boundary T-Energy - 2 Flow and Total Source Term Summary |
+--------------------------------------------------------------------+
Boundary : Default Solid 0.0000E+00
Boundary : Default Fluid Solid2 -3.0742E+06
Subdomain : heater 3.0685E+06
-----------
Global T-Energy - 2 Balance: -5.6725E+03
Global Imbalance, in %: -0.1852 %
+--------------------------------------------------------------------+
| Total Number of Nodes, Elements, and Faces |
+--------------------------------------------------------------------+
Domain Name : rotor
Total Number of Nodes = 38360
• Residual diagnostics will be reported for each set of connected domains having the same physical type. For
example, the mass and momentum equation residuals will be reported independently for each flow passage.
======================================================================
OUTER LOOP ITERATION = 35 CPU SECONDS = 4.64E+03
----------------------------------------------------------------------
| Equation | Rate | RMS Res | Max Res | Linear Solution |
+----------------------+------+---------+---------+------------------+
| U-Mom-rotor | 0.92 | 2.2E-05 | 3.6E-04 | |
| V-Mom-rotor | 0.90 | 3.6E-05 | 1.0E-03 | |
| W-Mom-rotor | 0.91 | 4.1E-05 | 9.1E-04 | |
| P-Mass-rotor | 0.94 | 1.2E-05 | 4.7E-04 | |
| U-Mom-stator | 0.89 | 2.1E-05 | 1.1E-03 | 1.3E-02 OK|
| V-Mom-stator | 0.84 | 9.9E-05 | 3.1E-03 | 3.1E-02 OK|
| W-Mom-stator | 0.86 | 7.4E-05 | 3.8E-03 | 2.6E-02 OK|
| P-Mass-stator | 0.89 | 1.4E-05 | 3.8E-04 | 10.0 6.6E-02 OK|
+----------------------+------+---------+---------+------------------+
| H-Energy-rotor | 0.92 | 7.7E-06 | 2.5E-04 | |
| H-Energy-stator | 0.88 | 5.4E-06 | 1.7E-04 | 6.1 5.4E-02 OK|
+----------------------+------+---------+---------+------------------+
| K-TurbKE-rotor | 1.62 | 1.2E-04 | 5.7E-03 | |
| K-TurbKE-stator | 0.86 | 1.1E-04 | 3.5E-03 | 6.1 9.7E-02 OK|
+----------------------+------+---------+---------+------------------+
| E-Diss.K-rotor | 2.52 | 4.0E-04 | 1.6E-02 | |
| E-Diss.K-stator | 0.87 | 1.8E-04 | 4.9E-03 | 7.5 1.5E-03 OK|
+----------------------+------+---------+---------+------------------
• Flows across GGI interfaces will be reported in flow summary diagnostics. Changes in GGI flows will occur
in various situations. For example, momentum flows change as they undergo rotation at rotational periodic GGI
connections. All transport equation flows, including the mass equation, change for the case of pitch change at
a frame change GGI connection, as well as the energy equation flows as conservation changes from absolute
frame to relative frame energy components. Forces are also reported in the momentum flow balances at contiguous
and periodic GGI connections, for cases having non-overlapping portions of the interface.
• Various quantities such as ranges of dependent variables, locations of maximum residuals, etc., are reported at
the end of the simulation on a per-domain basis.
+--------------------------------------------------------------------+
| Locations of Maximum Residuals |
+--------------------------------------------------------------------+
| Equation | Node # | X | Y | Z |
+--------------------------------------------------------------------+
+--------------------------------------------------------------------+
| Multi-Component Specific Enthalpy Diffusion |
+--------------------------------------------------------------------+
Unity Lewis Number (Le=1) for multi-component specific enthalpy
diffusion applied for fluids below.
Domain Name : run
Mixture
+--------------------------------------------------------------------+
| Single Step Reactions Heat Release |
+--------------------------------------------------------------------+
Enthalpy per [mol] of reaction at reference conditions
(Pressure= 1.01325E+05, Temperature= 2.98150E+02)
HCO Oxygen = 5.5799E+05
HCN NO Destruction PDF = 1.8194E+05
HCN NO Formation PDF = 1.3458E+03
Reburn NO Fuel Gas PDF = 2.7885E+05
Prompt NO Fuel Gas PDF = -9.0298E+04
+--------------------------------------------------------------------+
| Stoichiometric Mixture Fraction |
+--------------------------------------------------------------------+
Stoichiometric mixture fraction (Zst) for fluids with mixture
fraction combustion models.
Domain Name : run
Mixture Zst = 5.5000E-02
======================================================================
HC Fuel Proximate/Ultimate Analysis
======================================================================
Initial mass fractions for particle : HC Fuel
Ash = 1.2580E-01
Char = 0.0000E+00
Raw Combustible = 8.7420E-01
Volatiles material properties : Fuel Gas
Molar Mass [kg/kmol] = 18.234
Ref. Spec. Enthalpy (p= 1.01325E+05, T= 2.98150E+02) = -7.1827E+06
+--------------------------------------------------------------------+
| Autocomputed Stoichiometric Coefficients |
+--------------------------------------------------------------------+
Reaction (volatiles oxidation) : Fuel Gas Oxygen
Reactants:
Fuel Gas = 1.0000E+00
O2 = 1.3558E+00
Products:
CO2 = 9.3953E-01
H2O = 1.1267E+00
Reaction (NO reburn) : Reburn NO Fuel Gas PDF
Reactants:
Fuel Gas = 3.6879E-01
NO = 1.0000E+00
Products:
CO2 = 3.4648E-01
H2O = 4.1552E-01
N2 = 5.0000E-01
+--------------------------------------------------------------------+
| Autocomputed Mass Coefficients |
+--------------------------------------------------------------------+
Reaction (devolatilisation) : HC Fuel Devolat HCN
Reactants:
HC Fuel.Raw Combustible = 1.0000E+00
Products:
Gas Mixture HCN NO.Fuel Gas = 5.0003E-01
Gas Mixture HCN NO.HCN = 1.1857E-02
HC Fuel.Char = 4.8812E-01
Reaction (char oxidation) : HC Fuel Char Gibb HCN
Reactants:
Gas Mixture HCN NO.O2 = 2.6049E+00
HC Fuel.Char = 1.0000E+00
Products:
Gas Mixture HCN NO.CO2 = 3.5817E+00
Gas Mixture HCN NO.HCN = 2.3164E-02
+--------------------------------------------------------------------+
| Particle Transport Equations Solved in This Calculation |
+--------------------------------------------------------------------+
Domain Type : Default Domain
x-Mom-Sand Fully Coupled
y-Mom-Sand Fully Coupled
z-Mom-Sand Fully Coupled
x-Mom-Sand One Way Coupled
y-Mom-Sand One Way Coupled
z-Mom-Sand One Way Coupled
+--------------------------------------------------------------------+
| Particle Fate Diagnostics |
+--------------------------------------------------------------------+
| Particle type | Fate type Particles |
+--------------------------------------------------------------------+
| Sand Fully Coupled | Entered domain : 200 |
Collected on Walls
This message indicates that particles are trapped at the wall because both the parallel and perpendicular restitution
coefficients are zero. As a result, the particle tracking is terminated and the remaining momentum of the particles
is transferred to the wall as a force. For details, see Restitution Coefficients for Particles (p. 200) in the ANSYS
CFX-Solver Modeling Guide.
Entered Domain
This message indicates the number of particles that were injected into the domain either at a boundary or particle
injection region.
Integration Error
This message indicates that the tracking of these particles was terminated due to an unexpected error in the particle
tracking integration. If a small number of particles terminate in this way, it is not generally a cause for concern.
Any remaining mass, momentum and energy of the particle is neglected.
Left Domain
This message indicates the number of particles that have escaped from the domain and are no longer tracked. Any
remaining particle mass, momentum and energy also escapes the domain with particles. This is the normal abort
criterion for particles traveling through inlets, openings and outlets.
+--------------------------------------------------------------------+
| Transient Particle Diagnostics |
+--------------------------------------------------------------------+
Water Droplets
+--------------------------------------------------------------------+
| Particle Equation | Total source and source change rates |
+--------------------------------------------------------------------+
| | Equation Source Rate |
+--------------------------------------------------------------------+
| Domain: PipeValve |
+--------------------------------------------------------------------+
| Sand Fully Coupled | x-Mom 4.016E-02 0.0085 |
| | y-Mom 7.765E-02 0.0062 |
The Source column refers to the new particle source to the φ equation, which is calculated as the sum over all
vertices of the absolute particle source values to that equation. For details, see Particle Source Change Target (p.
214) and Particle Under Relaxation Factors (p. 214) in the ANSYS CFX-Solver Modeling Guide.
The Rate column shows the fractional change in the source between the current and the previous injection. The
source change rate can also be graphically monitored in the CFX-Solver Manager.
For additional information, see Convergence Control for Particle Transport (p. 222) in the ANSYS CFX-Solver
Modeling Guide.
+--------------------------------------------------------------------+
| CPU Requirements of Numerical Solution |
+--------------------------------------------------------------------+
+--------------------------------------------------------------------+
| |
| Processing ANSYS Input File (Running CCL2MF) |
| |
+--------------------------------------------------------------------+
Created /home3/cfdsjw/tmp/comp/StaticMixer_001.ansys/ANSYS.mf
If the ANSYS Solver was started by CFX, then this is also noted in the output file.
+--------------------------------------------------------------------+
| |
| Starting ANSYS Solver |
| |
+--------------------------------------------------------------------+
The host name and port number used by CFX-Solver to communicate to the ANSYS Solver is recorded. If you
started only CFX-Solver using the CFX-Solver Manager or the command line, then you will have provided these;
otherwise, the port number is determined automatically by the ANSYS Solver and communicated to CFX-Solver
by the start-up script.
Information on what data will be exchanged on what boundaries is recorded so that you can check that all is as you
expect it to be.
+--------------------------------------------------------------------+
| Boundary Condition Data Supplied by External Solver Coupling |
+--------------------------------------------------------------------+
ANSYS Multi-field Solver : ANSYS
CFX Boundary : Interface
CFX Variable : Total Mesh Displacement
ANSYS Interface : 1
ANSYS Variable : DISP
For steady-state runs only, each time a new coupling step begins, it is noted in the output file.
======================================================================
| COUPLING STEP = 1 |
======================================================================
The output file also notes each time a new stagger iteration begins.
----------------------------------------------------------------------
| COUPLING/STAGGER ITERATION = 1 |
----------------------------------------------------------------------
P1 Model
======================================================================
OUTER LOOP ITERATION = 1 CPU SECONDS = 3.67E+01
----------------------------------------------------------------------
| Equation | Rate | RMS Res | Max Res | Linear Solution |
+----------------------+------+---------+---------+------------------+
...
+----------------------+------+---------+---------+------------------+
+----------------------+------+---------+---------+------------------+
| I-Radiation | #Its | Vol Chg | Sur Chg | %Lost %Imbal |
| Gray | 1 | 0.0E+00 | 0.0E+00 | 0.38 1.94 |
+----------------------+------+---------+---------+------------------+
This variable is also included in the Locations of Maximum Residuals and Peak Values of
Residuals tables that appear in the output file.
+----------------------+------+---------+---------+------------------+
| I-Radiation | | %SD Sur | %SD Vol | %Lost %Imbal |
| Full Spectrum | | 4.6E+01 | 1.0E+02 | 0.00 0.00 |
+----------------------+------+---------+---------+------------------+
The Variable Range Information table has the output variable Radiation Intensity listed.
Summary Fluxes
• It should be noticed that for heat flux specified boundaries (adiabatic, for example) the specified heat flux can
verified by adding q rad to the boundary flow in the H-Energy flow summary.
q spec = q rad + q cond (Eq. 3.3)
• An I-Radiation section is included...
+--------------------------------------------------------------------+
| I-Radiation |
+--------------------------------------------------------------------+
Boundary : Airin -1.5659E+03
Boundary : Combustor Default -3.5729E+02
Boundary : Downcomer Wall -5.1864E+02
Boundary : Fuelin -1.0076E+03
Boundary : Outlet 1.6636E+01
Domain : Combustor 5.2454E+03
Domain Interface : Domain Interface 1 5.3004E-01
Domain Interface : Domain Interface 2 -5.2638E+00
Domain Interface : LowerGGI -1.9895E-01
Domain Interface : Periodic 1.1727E+01
Domain Interface : UpperGGI 1.6994E-01
-----------
Domain Imbalance : 1.8195E+03
Domain Imbalance, in %: 19.2758 %
Note
CFX-Solver input files must not contain spaces when run with an associated ANSYS input file (inp).
In CFX, there are two additional types of files that may contain results: transient results and backup files. All backup
and transient files are placed in a subdirectory beneath the working directory that is named according to the results
file. For example, if the working directory contains the results file file_001.res, then backup and transient
results files are placed in the subdirectory named file_001. Backup and transient files all have names with
extension .bak and .trn, respectively. For details on how to create these results files in CFX-Pre, see Backup
Tab (p. 154) in the ANSYS CFX-Pre User's Guide and Transient Results Tab (p. 155) in the ANSYS CFX-Pre
User's Guide. For details on how to create backup results files while the run is executing, see Backup Run
Command (p. 98). Note that transient results files are only created during transient simulations.
The naming convention for each backup and transient results file is outlined as follows:
• If a file has a name including _full, then it is a full results file that contains a complete set of results and the
mesh (for example, 32_full.trn or 32_full.bak). These files can be loaded into CFD-Post directly if
required, and can be to restart a simulation.
• If a file has a name that does not include _full, then it is not a full results file and may contain only selected
variables and no mesh (for example, 32.trn or 32.bak). Do not try to load one of these files directly into
CFD-Post; instead, load the ANSYS CFX results file (named file_001.res in the example described above)
and use the transient selector to switch between the final results and the results contained in these files.
• In general, transient and backup files contain results for the timestep corresponding to the integer prefix in the
file name. For example, 32_full.trn contains results from the 32nd timestep or outer iteration.
• For simulations involving couplers with external solvers (such as ANSYS Multi-field runs), files with a name
including _CS (such as 3_CS.trn or 7_CS_full.bak) may be present. These backup or transient files are
indexed by the coupling step rather than the CFX timestep or outer iteration. For example, 3_CS.trn corresponds
to the results at the end of the 3rd coupling step, not necessarily the 3rd timestep (although the two may be
coincident). These files are created in the same way as standard transient and backup files in CFX-Pre, but with
a frequency of Every Coupling Step or Coupling Step Interval.
CFD-Post
The CFX-Solver Results file may be used as input to CFD-Post in order to view the results and produce hard copy
output. It may also be used to produce files which are suitable for use with other post-processors by using the CFX
Export facility. For details, see File Export Utility (p. 131).
CFX-Solver
The CFX-Solver Results file may also be used as input to the CFX-Solver. The solution is used as the initial values
field from which to start a further analysis. For details, see Files Used by the CFX-Solver (p. 25).
Zone Volume Temperature Refr. B=1 Emiss Co. Scat Co. ...
Room$1 1.309E-02 2.951E+02 1.000E+00 1.000E-02 0.000E+00 ...
Room$2 1.104E-02 2.951E+02 1.000E+00 1.000E-02 0.000E+00 ...
.
.
.
Room$1551 2.172E-03 2.951E+02 1.000E+00 1.000E-02 0.000E+00 ...
Room$1552 5.090E-04 2.951E+02 1.000E+00 1.000E-02 0.000E+00 ...
Surface data
PROCESS 1
***********
IWORK = 264568
CPU time used 6.906
Volume Information
The volume information is given in a table with the following columns:
• Zone is the radiation element's internal name
• Volume is the volume of the radiation element
• Temperature is the temperature of the element
• Refr. B=1 is the refractive index of the element
• Emiss Co. is the emission coefficient (Units: per length)
• Scat Co. is the scattering opacity coefficient (Units: per length)
• Path len. is the average length when crossing a radiation element
• Heating is average volumetric absorbed radiation
• Emission is the volumetric emitted radiation
• (H-E)*VOL is the amount of radiative energy that shows up as a square term in the energy equation
• Error % is the standard deviation of the path length.
For non-grey models the emission and scattering coefficients are the spectrum integrated coefficients. In a grey
model the absorption coefficient equals the emission coefficient, in a non-grey model it can be obtained from the
intensity and the heating.
The next five columns contain the results. The seventh is the total path length of photons in the zone (Monte Carlo)
or the mean radiation intensity (discrete transfer). The eighth is the heating per unit volume, the ninth the cooling
per unit volume and the tenth the net total radiative heating rate for the zone. The last column gives the statistical
percentage error for Monte Carlo or the number of samples (rays traced through the zone) used for the heating
quadrature in the discrete transfer case.
Finally comes the total heating and cooling rates for the entire volume and, for Monte Carlo, the total mean path
length of photons in the geometry. Non-grey models will also have the band by band cooling.
Surface Information
In this output the first column is the zone name and the second the surface name. The third is the surface temperature,
the fourth the surface roughness and the fifth is the surface emissivity, spectrum integrated in the case of a non-grey
model. Grey surfaces have an albedo equal to one minus the emissivity, in the non-grey case the integrated albedo
can be obtained from the surface heating and the incident flux (see ).
The next five columns contain the results. The sixth is the surface current (Monte Carlo) or average incident radiation
flux (discrete transfer). The seventh is the heating per unit area, the eighth the cooling per unit area and the ninth
the net total radiative heating. The last column is the statistical error (Monte Carlo) or the number of surface nodes
used for sampling (discrete transfer).
Finally comes the total heating and cooling rates for all the surfaces in the geometry. Non-grey models will also
show the band by band cooling.
After the above information, the overall net heating for the model is printed. This is a measure of how good the
calculation was since this figure should be zero. For a Monte Carlo calculation the total surface current and absorbed
photon flux is printed, these figures should sum to unity and can therefore be used as another measure of the accuracy
of the calculation. Next the number of histories computed (Monte Carlo) or the number of angular ordinates (Discrete
transfer) is printed. The last numbers are the work estimator and the CPU time. The work estimator is defined in
terms of units of work where a unit of work is the computational effort to trace a photon (ray) to the next event
(surface) and process that event (update the recursion relation) for Monte Carlo (Discrete transfer). If radiometers
have been calculated, the angular calibration table that is used will be printed; then for each radiometer location,
the following will be written: location, direction, temperature, flux.
This creates a results file that can be loaded in CFD-Post and contains the variable Real partition number.
Note
A partition file generated in ANSYS CFX 11.0 or earlier versions is not supported in ANSYS CFX 12.0.
If such a file is used in ANSYS CFX 12.0, then an error message is generated.
Header
The header is written at the start of every multi-configuration output file and contains information regarding the
command which started the simulation. This information is useful to check which files were used to start the run.
+--------------------------------------------------------------------+
| |
| CFX Command Language for Run |
| |
+--------------------------------------------------------------------+
LIBRARY:
MATERIAL: Air at 25 C
Material Description = Air at 25 C and 1 atm (dry)
Material Group = Air Data, Constant Property Gases
Option = Pure Substance
Thermodynamic State = Gas
PROPERTIES:
Option = General Material
EQUATION OF STATE:
Density = 1.185 [kg m^-3]
Molar Mass = 28.96 [kg kmol^-1]
Option = Value
END
SPECIFIC HEAT CAPACITY:
Option = Value
Specific Heat Capacity = 1.0044E+03 [J kg^-1 K^-1]
Specific Heat Type = Constant Pressure
END
REFERENCE STATE:
Option = Specified Point
Reference Pressure = 1 [atm]
Reference Specific Enthalpy = 0. [J/kg]
Reference Specific Entropy = 0. [J/kg/K]
Reference Temperature = 25 [C]
END
DYNAMIC VISCOSITY:
Dynamic Viscosity = 1.831E-05 [kg m^-1 s^-1]
Option = Value
END
THERMAL CONDUCTIVITY:
Option = Value
Thermal Conductivity = 2.61E-02 [W m^-1 K^-1]
END
ABSORPTION COEFFICIENT:
Absorption Coefficient = 0.01 [m^-1]
Option = Value
END
SCATTERING COEFFICIENT:
Option = Value
Scattering Coefficient = 0.0 [m^-1]
END
REFRACTIVE INDEX:
Option = Value
Refractive Index = 1.0 [m m^-1]
END
THERMAL EXPANSIVITY:
Option = Value
Thermal Expansivity = 0.003356 [K^-1]
END
END
END
END
SIMULATION CONTROL:
CONFIGURATION CONTROL:
CONFIGURATION: Both Boxes Transient
Flow Name = Copy of Both Domains
ACTIVATION CONTROL:
CONTROL CONDITION: After Top Box Steady State
Configuration Name List = Top Box Steady Only
Option = End of Configuration
END
END
CONFIGURATION EXECUTION CONTROL:
INITIAL VALUES SPECIFICATION:
INITIAL VALUES CONTROL:
Use Mesh From = Solver Input File
END
INITIAL VALUES: Initial Values 1
Configuration Name = Top Box Steady Only
Option = Configuration Results
END
END
PARTITIONER STEP CONTROL:
Multidomain Option = Independent Partitioning
Runtime Priority = Standard
EXECUTABLE SELECTION:
Double Precision = No
END
PARTITIONING TYPE:
MeTiS Type = k-way
Option = MeTiS
Partition Size Rule = Automatic
END
END
SOLVER STEP CONTROL:
Runtime Priority = Standard
EXECUTABLE SELECTION:
Double Precision = On
END
PARALLEL ENVIRONMENT:
Start Method = HP MPI Local Parallel
END
END
END
END
CONFIGURATION: Top Box Steady Only
Flow Name = Top Domain Steady State
ACTIVATION CONTROL:
CONTROL CONDITION: Cyclical Activation
Configuration Name List = Both Boxes Transient
Option = End of Configuration
END
CONTROL CONDITION: Start of Sim
Option = Start of Simulation
END
END
CONFIGURATION EXECUTION CONTROL:
INITIAL VALUES SPECIFICATION:
INITIAL VALUES CONTROL:
Continue History From = Initial Values 1
Use Mesh From = Solver Input File
END
INITIAL VALUES: Initial Values 1
Configuration Name = Both Boxes Transient
Option = Configuration Results
END
END
PARTITIONER STEP CONTROL:
Multidomain Option = Independent Partitioning
Runtime Priority = Standard
EXECUTABLE SELECTION:
Double Precision = No
END
PARTITIONING TYPE:
MeTiS Type = k-way
Option = MeTiS
Partition Size Rule = Automatic
END
END
SOLVER STEP CONTROL:
Runtime Priority = Standard
EXECUTABLE SELECTION:
Double Precision = On
END
MEMORY CONTROL:
Memory Allocation Factor = 2
END
PARALLEL ENVIRONMENT:
Start Method = HP MPI Local Parallel
END
END
END
END
END
TERMINATION CONTROL:
+--------------------------------------------------------------------+
| |
| Simulation Execution |
| |
+--------------------------------------------------------------------+
======================================================================
SIMULATION STEP = 1
----------------------------------------------------------------------
| Config. | Configuration Name |
| Step | * Execution Details |
+-----------+--------------------------------------------------------+
| 1 | Top Box Steady Only |
| | * Act. by : Start of Sim |
| | * Status : Succeeded |
+-----------+--------------------------------------------------------+
======================================================================
SIMULATION STEP = 2
----------------------------------------------------------------------
| Config. | Configuration Name |
| Step | * Execution Details |
+-----------+--------------------------------------------------------+
| 1 | Both Boxes Transient |
| | * Act. by : After Top Box Steady State |
| | * Status : Succeeded |
| | * NOTE : The LIBRARY definition changed during this |
| | run. These changes will be applied to all |
| | remaining configuration runs. |
| | * NOTE : The FLOW definition changed during this |
| | run. These changes will be applied to all |
| | remaining runs of this configuration. |
+-----------+--------------------------------------------------------+
======================================================================
SIMULATION STEP = 3
----------------------------------------------------------------------
| Config. | Configuration Name |
| Step | * Execution Details |
+-----------+--------------------------------------------------------+
| 2 | Top Box Steady Only |
| | * Act. by : Cyclical Activation |
| | * Status : Succeeded |
+-----------+--------------------------------------------------------+
======================================================================
TERMINATION CONDITION SUMMARY
----------------------------------------------------------------------
Equation Residual
CFX-Solver calculates the solution to various equations, given the appropriate boundary conditions and models for
your particular CFD problem. For details, see Governing Equations (p. 17) in the ANSYS CFX-Solver Theory
Guide.
At any stage of a calculation, each equation will not be satisfied exactly, and the “residual” of an equation identifies
by how much the left-hand-side of the equation differs from the right-hand-side at any point in space. If the solution
is “exact,” then the residual is zero. Exact means that each of the relevant finite volume equations is satisfied
precisely. However, because these equations only model the physics approximately, this does not mean that the
solution exactly matches what happens in reality. If a solution is converging, residuals should decrease with successive
timesteps.
For example, assume that a given residual is 0.0005 kg s^-1. It is not obvious whether such a residual is large or
small. For instance, if the problem involves flows such that about 0.5 kg flows into (and out of) each mesh element
every second, then a residual of 0.0005 kg s^-1 means the equation is satisfied to within one part in a thousand,
which is likely a reasonable solution. However, if the problem involves flows of about 0.001 kg s^-1 into each mesh
element, then the residual is nearly as large as the flow, and the solution is not good.
To make the scales of the residuals meaningful, the solver normalizes values by dividing the appropriate scales at
each point. Solver Manager plots these normalized residuals using a log (base 10) scale.
The exact details of how the residuals are normalized are involved. For details, see Residual Normalization Procedure
(p. 254) in the ANSYS CFX-Solver Theory Guide. However, it is useful to know that residuals are divided by the
solution range. If linear solution diverges, this range may be very large and the normalized residuals would be
meaningless.
Tip
If you want to obtain residual plots for old runs, select File > Monitor Finished Run and select a file
to view.
∑ ( u new − u old ) 2
Φ= (Eq. 4.1)
∑ u new
2
where Φ represents the L2 norm of the transferred load, u old is the load component transferred at the last stagger
iteration, u new is the load component transferred at this stagger iteration, and the sum is over all the individual load
component values transferred (at different points in space). Each quantity is considered to be converged when
Φ < Φ min , where Φ min is the convergence target for that quantity set in CFX-Pre (see Solver Controls, External
Coupling Tab (p. 300) in the ANSYS CFX-Solver Modeling Guide) or directly by the multi-field commands in the
ANSYS input file (MFCO command).
Note
The definition of the convergence norm in Equation 4.1 (p. 73) was changed in Release 12.0. To achieve
convergence in Release 12.0 (and later) that is similar to that achieved prior to Release 12.0, set the new
convergence target to be the square root of the convergence target used prior to Release 12.0. Furthermore,
the default value for the convergence target in Release 12.0 was changed to 0.01.
Workflow Overview
Modifications to CFX-Solver input (results) files can be performed using either the Command Editor dialog box
in CFX-Solver Manager or the cfx5cmds command from the command line, as shown in Figure 5.1, “CFX-Solver
Input File Modification Workflows” (p. 75).
File Menu
The File menu contains:
• Save Command (p. 76)
• Validate Command (p. 76)
• Exit Command (p. 76)
Save Command
Saves the file and returns the CFX Command Language file information to the CFX-Solver input file.
Validate Command
Checks the format of the CFX Command Language file for necessary content and reports any errors. Validation of
units is performed each time a parameter is edited.
Exit Command
Closes the Command File editor. A prompt is displayed if there are unsaved changes.
Edit Menu
The Edit menu contains:
• Add Parameter Command (p. 76)
• Edit Parameter Command (p. 77)
• Delete Parameter Command (p. 77)
• Add Expert Parameter Section Command (p. 78)
• Find Command (p. 78)
• Find Next Command (p. 78)
5. Click OK.
Note that it is also possible to add a parameter that is not in the drop-down list by typing its name into the top field
and then entering a value. The CFX-Solver will subsequently fail if either the supplied name or value is inappropriate.
Note
Parameters that can be edited display the value in green. Other parameters cannot be changed from the
Command File editor.
Expanding categories
Additional information about a category can be seen by expanding it.
• Click the plus/minus boxes to expand or reduce the category selection.
Tip
Right-click to expand the category and all of its subcategories.
Editing entries
Important
Editing the CFX Command Language file changes the CFX-Solver input file, but does not make changes
to the CFX-Pre case file. In other words, changes made by the Command File editor are used by the
CFX-Solver but do not appear when the case file is reopened in CFX-Pre.
1. Expand the Name of the entry until a Value in green or orange is displayed.
Editable values display in green or in orange.
2. Expand FLOW.
3. Select EXPERT PARAMETERS.
4. Add parameters as required.
For details, see Add Parameter Command (p. 76).
Once the value for an expert parameter has been set, it can be edited as needed. For details, see Edit Parameter
Command (p. 77).
Find Command
Allows searching of the CFX Command Language file for a keyword or keywords.
Help Menu
The Help menu contains:
• Help On CFX-5 Definition File Editor Command (p. 78)
• Help On Expert Parameters Command (p. 78)
Note
This feature is for expert users only. Extreme care must be taken when editing a CFX Command Language
file. Changes made to the CFX Command Language file are reflected in the CFX-Solver input file and
may have negative effects on the model. It is strongly advised that original files are backed up before
edits are made to them.
To generate the CFX Command Language file, use the cfx5cmds command in a UNIX terminal or a Windows
command line. Ensure this is set up correctly to run CFX commands. For details, see Command Line (p. 3) in the
ANSYS CFX Reference Guide.
• The line continuation character is the backslash (\). To break a long line of text into two or more lines, insert
a backslash character at the end of the first line. For instance, both of the following lines are handled the same
way:
• A line containing CFX Expression Language must be no more than 256 characters long. Other lines can be of
any length.
The RULES and VARIABLES files can be a useful guide when editing a CCL file. For details, see RULES and
VARIABLES Files (p. 80).
Some objects in the CCL file can be defined with a default value and then overridden by local values. For example,
the SOLVER CONTROL section of a CCL file may look like:
SOLVER CONTROL :
CONVERGENCE CONTROL :
Maximum Number of Iterations = 100
Timescale Control = Physical Timescale
Physical Timescale = 5.E-1 [s]
END
EQUATION CLASS : momentum
CONVERGENCE CONTROL :
Timescale Control = Physical Timescale
Physical Timescale = 1.E-1 [s]
END
END
CONVERGENCE CRITERIA :
Residual Type = RMS
Residual Target = 1.E-4
END
ADVECTION SCHEME :
Option = Upwind
END
DYNAMIC MODEL CONTROL :
Global Dynamic Model Control = No
END
END
The first CONVERGENCE CONTROL object defines values that apply to all equation classes. The physical time
scale is then locally overridden for the momentum equation class. Other objects, including the ADVECTION
SCHEME, can be locally overridden in the same way. The order in which objects appear is not important, so an
object can be assigned an override before its default has been set. Only some parameters may be set to a different
local value; for example, it does not make sense to set the Maximum Number of Iterations locally.
Note
In some cases, the RULES and VARIABLES files contain information about variables, parameters,
models and options that are not yet fully supported in the CFX-Solver. Use caution with features that
are not documented elsewhere as these may cause the CFX-Solver to fail or produce invalid results.
VARIABLES File
The VARIABLES file lists all the variables available in the CFX-Solver. Information provided for each variable
appears similar to the following:
VARIABLE: vel
Option = Definition
MMS Name = VEL
Long Name = Velocity
Release 12.0 - © 2009 ANSYS, Inc. All rights reserved.
80 Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
RULES File
RULES File
The RULES file contains information about which models and parameters are valid options. This includes
SINGLETON, OBJECT and PARAMETER items.
RULES
The first items in the RULES file list the top level SINGLETON objects. All other items are children of these optional
top level objects.
• RULES: This could be used to modify the list of allowed options. This should always be done locally.
• LIBRARY: Includes libraries for materials, reactions, CEL and user routines. Add new materials and reactions
using a local library.
• FLOW: Contains the current problem definition.
• USER: Where user parameters may be stored for later retrieval through User Fortran.
• COMMAND FILE: Contains the command file version number.
• EXECUTION CONTROL: Contains information about the parallel setup and other settings controlled in the
CFX-Solver Manager.
Details about models that are not available can also be found through the user interface. For example, the
SINGLETON: ADVECTION SCHEME item includes the QUICK scheme.
SINGLETON
A SINGLETON object is permitted to appear once as the child of a parent object. For this reason SINGLETON
objects do not have names associated with them, for example:
LIBRARY :
CEL :
EXPRESSIONS :
Each of these three items is a SINGLETON object. The LIBRARY SINGLETON may only have one CEL
SINGLETON, and the CEL SINGLETON may only have one EXPRESSIONS SINGLETON. Parameters and child
definitions do not need to be grouped for a SINGLETON into a single location; this is done automatically by the
CFX-Solver. For example, the following is valid:
LIBRARY :
CEL :
EXPRESSIONS :
myexp1 = 1 [ m ]
END
END
END
...
LIBRARY :
CEL :
EXPRESSIONS :
myexp2 = 2 [ m ]
END
END
END
OBJECT
An OBJECT is similar to a SINGLETON except that more than one can appear as the child of a parent object. For
this reason each OBJECT must have a name, for example:
FLOW :
DOMAIN : domain1
...
END
DOMAIN : domain2
...
END
END
Two OBJECT items of type DOMAIN have been defined with names domain1 and domain2. These are children
of the FLOW SINGLETON.
PARAMETER
A PARAMETER consists of a name, followed by the “=” character, followed by a value. Many parameters in the
RULES file cannot be set in a CCL file and therefore cannot be altered.
• The Parameter Type tells you the type of values the parameter is allowed to take. It could be Real, Real
List, Integer, Integer List, String or String List. When a list is valid, items should be comma
separated.
• Some parameters contain an Allowed String List. This contains valid strings that can be used for that
parameter.
• Each PARAMETER that you can set has a Dependency List which lists the variables the PARAMETER can
depend upon. XYZ refers to the x, y and z coordinates. XYZT refers to the x, y and z coordinates and time. The
CCL file can be edited based on the dependencies listed here.
• If a PARAMETER contains the item Dynamic Reread Item = Yes, then it can be modified while a run
is in progress. Some SINGLETON objects also contain this item. For details, see Edit Run In Progress Command
(p. 105).
5. Click OK.
The data is loaded.
Close Command
Closes all windows related to the current run. Any other runs that were open are not affected, and the last open run
prior to the current run is displayed. If the Solver was in progress on the current run, it continues to operate in the
background. The run can be re-monitored; see Monitor Run in Progress Command (p. 85) or Monitor Finished Run
Command (p. 85), as appropriate.
Quit Command
Exits CFX-Solver Manager. Closing CFX-Solver Manager does not stop CFX-Solver jobs that are currently running.
CFX-Solver Manager can be re-opened to take control of these jobs again simply by opening CFX-Solver Manager
and selecting Monitor Run in Progress. For details, see Monitor Run in Progress Command (p. 85).
1. Select File > Quit.
2. Click Quit.
2. Set options as required. If desired, select CFX Defaults to use all of the default settings.
If you are using ANSYS Workbench and want to use its default settings, select Workbench Defaults.
For descriptions of the available options, see:
• CFX-Solver Manager Options (p. 87)
• Common Options (p. 88)
3. Click OK.
• Separate License
CFX-Solver checks out a separate license, leaving the ANSYS Workbench selected license key available so
that you can use the latter to do other work while the solver is running.
Monitor
Multiple options exist that can be monitored as required.
• The visibility for each type of residual can be toggled on or off. Settings take effect the next time a run is started,
or the next time a results file is viewed.
• If visibility is disabled for all residuals in a plot monitor, the monitor will not be created.
• For details, see Customizing CFX-Solver Manager (p. 5).
Monitor options are available to specify global residual display preferences. Settings chosen on the form apply for
all future solver runs and override default display settings for monitors. Monitors can still be created using the
Workspace menu. For details, see New Monitor Command (p. 97).
Common Options
Auto Save
Select the time between automatic saves.
To turn off automatic saves, set Auto Save to Never.
Note
This option affects more than one CFX product.
Temporary directory
To set a temporary directory, click Browse to find a convenient directory where the autosave feature will
save state files.
Appearance
The appearance of the GUI can be controlled from the Appearance options. The default GUI style will be set to
that of your machine. For example, on Windows, the GUI has a Windows look to it. If, for example, a Motif
appearance to the GUI is preferred, select to use this instead of the Windows style.
1. Under GUI Style, select the user interface style to use.
2. For Font and Formatted Font, specify the fonts to use in the application.
Note
It is important not to set the font size too high (over 24 pt. is not recommended) or the dialog boxes
may become difficult to read. Setting the font size too small may cause some portions of the text
to not be visible on monitors set at low resolutions. It is also important not to set the font to a family
such as Webdings, Wingdings, Symbols, or similar type faces, or the dialog boxes become illegible.
Note
Formatted Font affects only the font used in CFX-Solver Manager for the out file display.
Viewer Setup
1. Select Double Buffering to use two color buffers for improved visualization.
For details, see Double Buffering (p. 89).
Double Buffering
Double Buffering is a feature supported by most OpenGL implementations. It provides two complete color buffers
that swap between each other to animate graphics smoothly. If your implementation of OpenGL does not support
double buffering, you can clear this check box.
Unlimited Zoom
By default, zoom is restricted to prevent graphics problems related to depth sorting. Selecting Unlimited Zoom
allows an unrestricted zoom.
Mouse Mapping
The mouse-mapping options allow you to assign viewer actions to mouse clicks and keyboard/mouse combinations.
These options are available when running in standalone mode. To adjust or view the mouse mapping options, select
Edit > Options, then Viewer Setup > Mouse Mapping. For details, see Mouse Button Mapping (p. 49).
Units
1. Under System, select the unit system to use. Unit systems are sets of quantity types for mass, length, time, and
so on.
The options under System include SI, CGS, English Engineering, British Technical, US
Customary, US Engineering, or Custom. Only Custom enables you to redefine a quantity type (for
example, to use inches for the dimensions in a file that otherwise used SI units).
The most common quantity types appear on the main Options dialog; to see all quantity types, click More
Units.
Monitors Tab
The Monitors tab allow customization of the CFX-Solver Manager viewer area and text windows. The following
types of monitors are available:
• Plot Monitor (p. 92)
• Residual Monitor (p. 92)
• Text Monitor (p. 92)
Plot Monitor
Plot monitors show the values of expressions versus timestep.
Residual Monitor
Residual monitors show the values of residuals for equation variables versus timestep.
Text Monitor
Text monitors show the contents of text files that are updated as the run proceeds.
Filter Selector
The Filter selector is a drop down list that shows the monitor types available in CFX-Solver Manager. Use this
selector to control the monitors displayed under the Monitors tab by selecting All, Plot Monitor, Residual
Monitor or Text Monitor. The All setting displays a full list of available monitors.
Creating Monitors
Monitors can be created within Workspace Properties. However, they can also be created directly from the
Workspace menu by selecting New Monitor.
1. Select Workspace > Workspace Properties.
2. Select Monitors.
3. Click New .
The New Monitor dialog box is displayed.
Modifying Monitors
1. Select Workspace > Workspace Properties.
2. Select Monitors.
3. Select the monitor to modify.
4. Click Edit .
The Monitor Properties dialog box is displayed.
Deleting Monitors
1. Select Workspace > Workspace Properties.
2. Select Monitors.
3. Select the monitor to delete.
4. Click Delete .
Monitor Properties
Monitor properties differ depending on the type of monitor. Up to three tabs are available to configure monitor
properties.
• General Settings Tab (p. 93)
• Range Settings Tab (p. 93)
• Plot Lines Tab (p. 94)
1. Under Text File Name, click Browse and select a file containing the definition for the text monitor.
This can be any .out file.
1. Under Background Color, click Color Selector and set the background color.
2. Select or clear Display Legend.
If selected, the legend is displayed in the monitor.
4. Under Grid Color, click Color Selector and set the grid color.
• Fixed displays a beginning and end iteration which is always displayed, regardless of the current iteration
number.
• This Run Only displays the range for the current run. If the run is a restart, previous runs are not
included in the range.
3. Under Set Manual Scale (Log) or Set Manual Scale (Linear) set the Upper Bound and Lower Bound values
for the variable axis.
4. Complete the timestep configuration based on the Timestep Range Option selected.
• Most Recent requires a value for Timestep Window Size.
• Fixed requires values for First Timestep and Last Timestep.
5. Click Apply.
CFX Variables
While not all variable types are available at any given time, the following is a complete list of all variable types
available for monitoring a CFX run.
• ACCUMULATED TIMESTEP (p. 95)
• BALANCES (p. 95)
• FLOW (p. 95)
• FORCE (p. 95)
• NEG ACCUMULATION (p. 95)
• RESIDUAL (p. 95)
• SOURCE (p. 95)
• TIMESTEP (p. 95)
• USER (p. 95)
Further details on the output of the solver are available. For details, see CFX-Solver Files (p. 25).
ACCUMULATED TIMESTEP
The accumulated timestep values are plotted.
BALANCES
These are the normalized sum of the flows (that is, the % imbalance) for a given equation on a particular domain.
The absolute flow is normalized by the maximum flow, calculated by looking at flows on all domains for that
particular equation.
FLOW
The flows listed in the CFX-Solver Manager are the absolute amounts of a variable transported through a boundary
condition. For example, the flow for the continuity (P-Mass) equation is the mass flow of a particular phase through
the boundary condition. The flow for the energy (H-Energy) equation is the energy flow per unit time through the
boundary condition.
FORCE
For details, see Calculated Wall Forces and Moments (p. 40).
NEG ACCUMULATION
Negative accumulation is the transient term contribution to the balance equation. For details, see BALANCES (p. 95).
RESIDUAL
For details, see Residual Plotting (p. 71).
SOURCE
Sources are the amount of a variable created or consumed in a particular three dimensional region of a domain. The
region might be user defined, if user defined source terms were set up, or the region might be the entire domain.
Source values which are defined for the entire domain are automatically computed by the solver, and vary depending
on the models which are being used. For example, automatically computed source values will appear in the turbulent
kinetic energy equation which represent the production and dissipation of turbulence.
TIMESTEP
Under the TIMESTEP heading, the only variable available is Accumulated Time Step. CFX-Solver Manager
uses this variable to plot the x-axis of ANSYS Field Solver and ANSYS Interface Loads plots. It represents the
cumulative iteration number in the following way:
• For the ANSYS Field Solver plot, the cumulative iteration number counts the number of iterations which the
ANSYS solver has performed in order to converge. Several ANSYS iterations will be performed for each
timestep or coupling step, depending on how quickly ANSYS converges.
• For the ANSYS Interface Loads plot, the cumulative iteration number counts the number of stagger iterations
performed by the ANSYS Multi-field solver.
USER
If monitor points have been created, a USER category is available. This can be expanded to select the monitor points
to plot. For details, see Monitor Tab (p. 157) in the ANSYS CFX-Pre User's Guide.
Residual Mode acts as a visibility filter for variables of Residual type selected by default. If a variable of
type Residual is not selected by default it is plotted even if its type does not match the Residual Mode
setting.
5. Click Apply.
ANSYS
The variables that are typically present in a GST or NLH files under the ANSYS heading are listed in the table
below together with a brief description (for the context of an ANSYS Multi-field MFX simulation). Other variables
may be present depending on the solution physics and the specified convergence targets. For full details, see the
ANSYS Product documentation.
Line Search Parameter For details, refer to the ANSYS documentation in “Line Search”.
Load Step In the context of an ANSYS Multi-field run, Load Step is the
same as a multi-field timestep or Coupling Step.
Max DOF Incr The largest change detected in the degree of freedom of interest over
the last two equilibrium iterations
Sub-step The ANSYS field solver may be set to use a smaller timestep than
the multi-field timestep. This is known as sub-cycling. In this case,
the multi-field timestep is broken into a series of sub-steps.
<variable> CRIT, <variable> L2, <variable> Only in the GST file. For details, see ANSYS Field Solver
L1, <variable> INF Plots (p. 72).
UX, UY, UZ, FX, FY, FZ, TEMP, HFLU Only in the NLH file. For details, see ANSYS Interface Loads
Plots (p. 73).
2. On the Range Settings tab, set Plot Data By to Specified Variable and select the variable you wish
to use as the X-axis variable.
Note
As turning on the cloop setting results in a three to seven times increase in the size of the monitor data
file, it affects the performance of the CFX-Solver Manager.
If running CFX-Solver from the command line, use the command: cfx5stop. For an example of the cfx5stop
command, see Command-Line Samples (p. 118).
When CFX-Solver stops, the run is marked as finished, and a message appears. This message names the run and
specifies it has terminated at your request. Additional information about the run is also listed. Once manually
terminated, a run can be manipulated in the same way that a completed run .
In particular, steady state analyses will run until completion, and transient analyses will run until the end of the
current time step.
Multi-Configuration Runs
If a stop run command is issued in a workspace for a specific configuration, then only the current CFX-Solver run
for that configuration will be terminated; the overall simulation is not. All remaining configurations that are defined
for the simulation are subsequently run (unless a stop run command is also issued for them). If a stop run command
is issued in the simulation-level workspace, which is labeled according to the name of the multi-configuration
CFX-Solver Input file (* .mdef), then the overall simulation is terminated. The CFX-Solver run for the
configuration currently being executed is terminated as soon as possible, and no additional configurations are
executed.
The backup file is stored in a subdirectory within the working directory. This subdirectory is given the same name
as the current run.
Arrange Command
Arranging the workspace deletes all monitors that are currently showing, regenerates them, and redisplays them by
optimizing the display based on available screen space. This has no impact on the display if the layout type has
been toggled to display multiple overlapping tabs. For details, see Toggle Layout Type Command (p. 98).
To arrange the workspace, either:
• Select Workspace > Arrange.
• Click Arrange Workspace .
5. Click Yes.
The new layout is loaded.
^RESIDUAL,RMS,.*-Mom;^RESIDUAL,RMS,.*-Diss.K; \
^RESIDUAL,RMS,.*-TurbKE;
As stated previously, the string for which a search is made can be found from the variable lists in the Plot Lines
panel of the Monitors form. For details, see Plot Lines Tab (p. 94).
Note
Resetting the default workspace deletes any custom monitors.
Close Command
For information on the Close command, see Close Command (p. 85).
Export Command
If using tools other than CFD-Post for post-processing, data needs to be exported to a results file in a supported
format. The CFX Export utility can also be run from the command line.
• File Export Utility (p. 131)
• Running cfx5export from the Command Line (p. 143)
There must be a results file to reference before exporting.
1. Select Tools > Export.
The Export dialog box is displayed.
2. Under Results File, click Browse and select a results file for export.
3. If required, under Export File, click Browse and modify the default output path and name.
4. Under Domain Name, select the domain to export.
Where multiple domains exist, select the domain(s) to export.
5. Under Export Type select CGNS, MSC.Patran, FIELDVIEW, EnSight or Custom User Export.
• CGNS (p. 133)
• MSC.Patran (p. 135)
7. Click Export.
Once completed, a message is displayed. Click OK to close it.
2. Under Results File, click Browse and select a results file for export.
3. If required, under Export File, click Browse and modify the default output path and name.
4. Under Domain Name, select the domain to export.
Where multiple domains exist, select the domain(s) to export.
7. Click Export.
Once completed a message is displayed. Click OK to close it.
Interpolate Command
ANSYS CFX allows the values from one results file to be interpolated onto a CFX-Solver input file containing
another mesh.
The major benefit of interpolation is the ability to use the solution from a simple model to provide initial conditions
for another, perhaps more complex model (thus increasing the likelihood of converging the complex model simulation)
or to continue a run with a different mesh or other settings.
Interpolation can be used with modified geometry or boundary conditions. Interpolation can also be used to interpolate
the solutions from a model with different mesh topology. For example, the initial guess for a problem having one
domain can be interpolated from one or more results files having a solution that spans multiple domains. When the
shape of the model has changed and the initial values files do not fully overlap with the new mesh, the
CFX-Interpolator extrapolates values for the points in the new mesh that lie outside the Initial Values File(s), based
on the interpolated values on the mapped nodes. See Using the CFX-Interpolator (p. 86) in ANSYS CFX-Solver
Modeling Guide for more details on how the CFX-Interpolator works.
The CFX-Interpolator is most commonly invoked through settings on the Run Definition tab on the Configuration
or Execution Control details view in CFX-Pre, or, the Define Run dialog of the CFX-Solver Manager. For details,
see Run Definition Tab (p. 225) in ANSYS CFX-Pre User's Guide, Run Definition Tab (p. 216) in ANSYS CFX-Pre
User's Guide and Run Definition Tab (p. 8), respectively.
However, if you wish to manually use the interpolator to write variables into a specific Solver Input File (not invoked
from the Run Definition tab) then you can choose Tools > Interpolate Results from the CFX-Solver Manager. In
this case the specified Mesh File is used as the target file, and will be modified by the interpolation process. The
text output is written into the CFX-Solver Manager's Interpolation dialog. You can then run the resulting target file
in the CFX-Solver, using the variables written into the target file by the CFX-Interpolator as the initial conditions
for the run.
To manually interpolate the results from a source file to a target file, you can use the Interpolate Results command
as follows:
1. Select Tools > Interpolate Results.
The Interpolation dialog box is displayed.
3. Set Results File to the name of the source file. You can click Browse to select the file using a browser.
4. Set Mesh File to the name of the target file. You can click Browse to select the target file using a browser.
You can interpolate onto a CFX-Solver Input file.
6. If required, under Interpolator Memory, adjust the memory configuration. For details, see Configuring
Memory for the CFX-Solver (p. 13).
7. Click Interpolate.
The output window on the right displays details of the interpolation process.
Once completed, a message is displayed. Click OK to close it.
You can also run the interpolator from the command line. For details see Using the Command Line to Interpolate
Results (p. 104).
Note
• To save the results to a text file, right-click in the text output window and select Save As.
• Interpolating results from a source file to a target file which already contains solution data is not
recommended. See Interpolating Onto a Solver Input File with Results Fields (p. 94) in ANSYS
CFX-Solver Modeling Guide for details.
• Following the steps above, the interpolation is performed in Initial Guess mode. See Using the
CFX-Interpolator (p. 86) in ANSYS CFX-Solver Modeling Guide for details.
To generate a comparison of two files, you can use the Interpolate Results command. The comparison is stored
as new variables with the prefix Difference. These variables can be used in CFD-Post to determine regions
where the solution has changed significantly. A comparison of two files can be generated as follows:
1. Select Tools > Interpolate Results.
The Interpolation dialog box is displayed.
3. Set Original Results to the name of the original results file. You can click Browse to select the file using
a browser.
4. Set Modified Results to the name of the modified results file. You can click Browse to select the file
using a browser.
5. Under Executable Settings, select or clear Double Precision.
For details, see Double-Precision Executables (p. 123).
6. If required, under Interpolator Memory, adjust the memory configuration. For details, see Configuring
Memory for the CFX-Solver (p. 13).
7. Click Calculate Differences.
The output window on the right displays details of the differencing process.
Once completed, a message is displayed. Click OK to close it.
Note
CFD-Post now also supports comparison of two results files without the use of the CFX-Interpolator.
For details, see Case Comparison (p. 181) in ANSYS CFD-Post User's Guide.
where:
• <results file> is the name of a results file that contains a solution.
• <CFX-Solver input file> is the name of a CFX-Solver input file that contains a mesh onto which the
solution should be interpolated.
• [<arguments>] is an optional list of additional arguments.
cfx5interp rewrites the CFX-Solver input file with the interpolated form of the solution that was read from the
results file. A command of this form would produce the same results as running invoking interpolation using Tools
> Interpolate Results within the CFX-Solver Manager.
You can use the -difference argument to cause the interpolator to produce difference datasets for differences
in results between two results files. The form of such a statement is:
cfx5interp -difference -from <res file 1> -dest <res file 2> [<arguments>]
where:
• <res file 1> is the name of a results file that contains the original (older) set of fields
• <res file 2> is the name of a results file that contains the newer set of fields
• [<arguments>] is an optional list of additional arguments
cfx5interp calculates the differences between an original set of fields and the newer set, and rewrites <res
file 2> with the differencing information included.
The cfx5interp script can run two versions of the interpolator. The newer version (a solver-based interpolator)
runs by default, and the older one (that was released with ANSYS CFX 10.0) can be invoked by using the
-interp-old argument.
When the older interpolator is used, the cfx5interp script is capable of producing a text file of results for specific
locations within the fluid domain. This is particularly useful if there is experimental data to validate.
To produce a results text file, first create a text file containing the particular vertex coordinates of interest, in the
following format:
Once the vertex file is created, run the old interpolator using a command line of the form:
The old interpolator creates a file with a name of the form: <vertex file>.inn, where nn is chosen to make
a unique file name. This is a text file that contains the coordinates that are specified in the vertex file, plus the results
from the results file interpolated to the vertex locations.
If, in the vertex file, there are coordinates that lie outside of the solution grid, values of 0.0E0 will be assigned for
all variables at those coordinates. In other words, results are not extrapolated to a vertex file.
Note
Some of the values obtained using the cfx5interp script may differ slightly from the values obtained
using Data Export in CFD-Post. These minor discrepancies result from different methods of calculation.
Discrepancies are more likely to occur at points which lie very close to the edge of the mesh elements
or in regions of prism and hexahedral elements. Inconsistencies are likely to be more significant where
gradients are large, particularly in the boundary layer.
Note
The Edit Run in Progress command is not enabled for simulations involving ANSYS Multi-field
couplings. This constraint exists because of difficulties involved with updating the MFX settings in the
ANSYS solver during the run.
2. Under Results File, click Browse and select a results file to load into CFD-Post.
3. If you want to load two results files into CFD-Post together, check Specify Additional Results File, and select
another results file to load.
4. Select or clear Shut down Solver Manager.
If selected, ANSYS CFX-Solver Manager is shut down before CFD-Post is launched.
5. Click OK.
cfx5solve [options]
where [options] denotes the options applicable during a command-line run. This chapter discusses how to run
CFX-Solver in a batch mode and describes the supported command-line options in the following sections:
• Command-Line Use (p. 109)
• Command-Line Options and Keywords for cfx5solve (p. 109)
• Command-Line Samples (p. 118)
You can also use CFX-Solver Manager to start CFX-Solver. The graphical user interface of the CFX-Solver Manager
enables you to set various options, allows easier control of the solution process, and provides some visual details
as the solution emerges. For details, see CFX-Solver Manager Basics (p. 1).
Command-Line Use
CFX-Solver Manager and CFX-Solver can be launched from a command line as follows:
• The basic command to start CFX-Solver Manager is cfx5solve.
The more general form of the command is:
where [] denotes a discretionary option, | separates mutually exclusive options, and <> denotes that substitution
of a suitable value is required. All other options are keywords, some of which have a short form.
• The basic command to start the CFX-Solver using the CFX-Solver input file named <file> is:
where [] denotes a discretionary option, | separates mutually exclusive options, and <> denotes that substitution
of a suitable value is required. All other options are keywords, some of which have a short form.
Note
When running the solver from the command line using a CFX-Solver input file or CFX-Solver results
file, any execution control CCL contained in the file takes precedence over the command-line options.
If an option is specified multiple times within the context of a specific configuration, then the last
specification of the option takes precedence.
-bak-elapsed-time -baket <elapsed time Causes the flow solver to write a backup file every
<elapsed time frequency> <elapsed time frequency> hours, minutes,
frequency> seconds, et cetera. Elapsed time must be in quotes and
have units in square brackets. For example: -baket
“10 [min]” or -baket “5 [hr]”.
-bg-ccl <file> Reads Command Language from the named file, and
uses it to provide defaults for the current run. If the
file specifies a CFX-Solver input file for the run, the
command language contained in that CFX-Solver
input file will take precedence over that supplied. Also
see the -ccl option.
-continue-from-file -cont-from-file Uses initial values and continues the run from the
<file> <file> specified CFX-Solver results file. The mesh from the
CFX-Solver input file is used unless the
-use-mesh-from-iv option is also specified.
Only one -continue-from-file argument can be
supplied. See Continuing the History (p. 82) in
ANSYS CFX-Solver Modeling Guide for more details.
-continue-from-configuration -cont-from-config Uses initial values and continues the run from the most
<configuration <configuration name> recent results for the named configuration. The mesh
name> from the configuration (.cfg) file is used unless the
-use-mesh-from-iv option is also specified.
Only one -continue-from-configuration argument can
be supplied. See Continuing the History (p. 82) in
ANSYS CFX-Solver Modeling Guide for more details.
-definition <file> -def <file> Uses <file> as the solver input file for a single
configuration simulation. This may be a CFX-Solver
input file or a CFX-Solver results file for a restart.
The file specified is used in the same way as the input
file on the Define Run dialog box. For details, see
Define Run Command (p. 85). Also see the -mdef
option.
-example <file> -eg <file> Starts the CFX-Solver using one of the example
CFX-Solver input files provided with the product. The
example StaticMixer is currently available.
-initial <file> -ini <file> Uses the initial values in the CFX-Solver results file
<file>. The mesh from this results file is used unless
the -interpolate-iv option is also specified.
This option has been deprecated and should be
replaced by -initial-file or
-continue-from-file as appropriate.
-initial-configuration -ini-conf Uses initial values from the most recent results for the
<configuration <configuration name> named configuration as a basic initial guess for the
name> run. The run history from this file is discarded. The
mesh from this results file is used unless the
-interpolate-iv option is also specified. See
Continuing the History (p. 82) in ANSYS CFX-Solver
Modeling Guide for more details.
-initial-file -ini-file <file> Uses initial values from the specified CFX-Solver
<file> Results file as a basic initial guess for the run. The run
history from this file is discarded. The mesh from the
configuration (.cfg) file or the CFX-Solver input
file is used unless the -use-mesh-from-iv option
is also specified. See Continuing the History (p. 82)
in ANSYS CFX-Solver Modeling Guide for more
details.
-interpolate-iv -interp-iv Interpolates the solution from the initial values file, if
one is supplied (using the -initial option), onto
the mesh from the CFX-Solver input file, rather than
using the mesh from the initial values file. This option
has been deprecated and should be replaced by the
-initial-file or -continue-from-file
option, as appropriate.
-job Keeps the .job file after an ANSYS CFX Solver run.
This file contains a brief summary of various solution
values, and is most useful for regression purposes.
-job-part -jobp Keeps job file after an ANSYS CFX Partitioner run.
This file contains a brief summary of various solution
values, and is most useful for regression purposes.
-max-elapsed-time -maxet <elapsed Sets the maximum elapsed time (wall clock time) that
<elapsed time> time> CFX-Solver will run. Elapsed time must be in quotes
and have correct units in square brackets. For example:
-maxet “10 [min]” or -maxet “5 [hr]”.
-mdefinition <file> -mdef <file> Uses <file> as the solver input file. This may be a
multi-configuration definition file or results file for a
restart (that is, .mdef or .mres, respectively). The
file specified is used in the same way as the input file
on the Define Run dialog box. For details, see Define
Run Command (p. 85).
-name <name> Specifies the basename for exported files and the
temporary directory based on the problem name
<name> instead of the CFX-Solver input file name,
unless other names are explicitly defined.
This name cannot be set when using the CFX-Solver
Manager to start the CFX-Solver.
-parallel -par Starts the solver in parallel mode. This option can be
combined with -partition for a partitioning run.
If the -part option is not specified, then the
-parfile-read option must be used to specify a
valid partitioning information file.
Note
Only *.par files that are generated in
ANSYS CFX 12.0 (or later) are supported.
For details, see CFX Partition File (p. 63).
-partition <number -part <number of Starts the solver in partitioning mode. This option
of partitions> partitions> should not be used if an existing partition file is also
specified.
-part-mode <mode> Sets the partitioning mode to use when running the
partitioner. Valid options are metis-kway (MeTiS
k-way), metis-rec (MeTiS Recursive Bisection),
simple (Simple Assignment), drcb (Directional
Recursive Coordinate Bisection), orcb (Optimized
Recursive Coordinate Bisection), rcb (Recursive
Coordinate Bisection)
Finer control over the partitioning method is available
through the Command Language.
-preferred-license -P <license name> Sets the first license used by solver, given the
<license name> availability of multiple usable licenses.
-priority <level> -pri <level> Enables the specification of a job priority to a solver
run; the allowed values are Idle (0), Low (1),
Standard (2), and High (3). The default value on
UNIX platforms is High, which corresponds to nice
increment of 0. On Windows, the default is
Standard, corresponding to a priority level of
Normal.
-size-cat <size> -scat <size> These flags are for advanced users to change the
-size-nr <size> -nr <size> memory allocation parameters for the solver. Usually,
you should use the -size option instead. <size>
-size-ni <size> -ni <size> is the desired memory allocation in words, and may
-size-nd <size> -nd <size> have K or M appended for kilo or mega. If the suffix
-size-nc <size> -nc <size> is 'x', then the number is treated as a multiplier.
-size-cclsetup -sizeccl <factor> Changes the memory estimates used by the ANSYS
<factor> CFX cclsetup executable by a factor of <factor>.
-size-cclsetup-cat -scatccl <size> These options are the same as the -size-* options
<size> -nrccl <size> above, but provide sizes needed for the ANSYS CFX
-size-cclsetup-nr CCL Setup executable.
-niccl <size>
<size>
-ndccl <size>
-size-cclsetup-ni
<size> -ncccl <size>
-size-interp-cat -scatint <size> These options are the same as the -size-* options
<size> -nrint <size> above, but provide sizes needed for the ANSYS CFX
-size-interp-nr Interpolator.
-niint <size>
<size>
-ndint <size>
-size-interp-ni
<size> -ncint <size>
-size-interp-nc
<size>
-size-interp-nl
<size>
-size-mms <factor> -smms <factor> Changes the initial MMS catalogue size estimate used
by the CFX-Solver by a factor of <factor>. This
option has been deprecated and should be replaced by
-size-cat.
-size-part-mms -smmspar <factor> Changes the initial MMS catalogue size estimate used
<factor> by the partitioner by a factor of <factor>. This
option has been deprecated and should be replaced by
-size-part-cat.
-size-part <factor> -sizepart <factor> Changes the memory estimates used by the ANSYS
-size-par <factor> -sizepar <factor> CFX Partitioner by a factor of <factor>. Also see
the -size option. Further options for controlling the
partitioner memory allocation are available. Execute
cfx5solve -help for full details.
-size-part-cat -scatpar <size> These options are the same as the -size-* options,
<size> -nrpar <size> but provide sizes needed for partitioner rather
-size-part-nr than solver.
-nipar <size>
<size>
-ndpar <size>
-size-part-ni
<size> -ncpar <size>
-start-method Uses the named start method to start the solver. This
<name> option allows you to use different parallel methods,
as listed in the CFX-Solver Manager GUI, instead of
the defaults. For parallel runs, you also need to provide
the -part or -par-dist options.
-use-mesh-from-iv Uses the mesh from the source initial values (that is,
from a file or configuration) rather than from the
solver input file. This is only valid if a single
initial-values source is specified.
a
Locators for applying physics cannot be modified using the -ccl option; they can, however, be changed in CFX-Pre.
Command-Line Samples
Here are some examples to help clarify the use of the command line:
Start CFX-Solver
To start CFX-Solver running from the CFX-Solver input file model.def, enter the command:
If the input file is for a multiple configuration (.mdef file), enter the command:
This command will produce a file named model_001.par in the local run directory.
Note
If the file model.par exists in the working directory, then the partition type (MeTiS, RecCoordBis
or SpecDir) is read from this file, even if you have not specified the file model.par. Because this
could potentially be confusing, you are advised to use the CFX-Solver Manager to set up a partitioning
run, unless you are certain that either there is no file model.par or that the partitioning method specified
in the model.par file is what you require.
If you have already created a file model.par (for instance, by using the command cfx5solve -def
model.def -partition 7), then you can run the parallel CFX-Solver by entering the command:
To run the CFX-Solver in parallel for the configuration named <config> and in serial for other configurations in
a multi-configuration simulation, enter the command:
If you have already created a partitioning file, say model.par (for instance, by using the command cfx5solve
-def model.def -partition 7), then you can execute the distributed parallel run as follows:
The number of partitions specified using the –par-dist command-line flag must be the same as that in the
partitioning file, model.par, or the run will fail.
cfx5solve -def file.def -start-method "MPICH2 Local Parallel for Windows" -part 2
To start an ANSYS Multi-field run, launching the Mechanical application solver only, disabling the processing of
the Mechanical application input file and using the Mechanical application input file model.inp:
cfx5solve -def model.def -ansys-input model.inp -mfx-run-mode "Start ANSYS only" -ansys-
To start an ANSYS Multi-field run, launching CFX-Solver only and telling it to communicate with the already
running Mechanical application solver on a particular port number and host, enter the command:
cfx5solve -def model.def -mfx-run-mode "Start CFX only" -cplg-host 49800@machine1 -cplg-
To preprocess the configuration definition file corresponding to the configuration name <config>, enter the
command:
Example
An example of the use of Indirect Solver Start methods to run a cfx5solve command within a PBS-based batch
queuing system is provided in the CFX distribution. For details, please see the Submit to PBS Queue start method
in start-methods.ccl, and the qcfx5solve.pl script in the <CFXROOT>/extras/ directory.
Tetrahedral Mesh
The ratio of elements to nodes is approximately 5:1 for a tetrahedral mesh. For example, if 5 million tetrahedral
elements are in a mesh, then there are approximately 1 million nodes. This is in contrast to a hexahedral mesh where
the ratio of elements to nodes approaches 1:1 as the grid becomes large.
Memory required for a tetrahedral mesh is about 0.4 times the memory required for a hex mesh of the same number
of elements. Alternatively a tetrahedral mesh has about 2 times the required memory of a hexahedral mesh with the
same number of nodes.
Double-Precision Executables
Double-precision executables store basic floating point numbers as 64 bit words. These executables are available
to permit more accurate numerical mathematical operations. Double precision accuracy might be needed if the
computational domain involves a huge variation in grid dimension, aspect ratio, pressure range, etc.
When double precision is used, the computer memory used for a given problem and grid size is double that of the
default (single precision) executable. Stated another way: the maximum problem size to run on a given computer
for the double precision executable is half that of the default single precision executable.
As a workaround, larger problems can be partitioned with the large problem partitioner. This executable internally
uses 8 byte integer data to perform the partitioning process. In theory, a maximum problem size of 2 billion elements
can be partitioned with this executable. However, practical considerations, such as available computer resources,
will still limit the maximum size.
Turbulence
The following topics will be discussed:
• Zero Equation Model (p. 124)
• Two-Equation Models (p. 124)
• Reynolds Stress Model (p. 124)
Two-Equation Models
Two additional scalar equations are solved when using two-equation turbulence models. The SST model has a slight
additional cost over other two equation models since a wall scale equation is also solved.
Consider the case of single phase, single component laminar flow in which the U-Mom, V-Mom, W-Mom, and
P-Mass equations are solved. Expect a CPU cost increase on the order of 50% by the addition of a two-equation
turbulence model. Memory requirement increases are small.
Energy Models
Both the thermal and total energy models require the solution of an additional scalar equation. The solution of the
energy equation typically requires 1/3 of the CPU required for the U-Mom, V-Mom, W-Mom, and P-Mass equations.
Memory requirement increases are small.
CHT Regions
Only the energy equation is solved in CHT regions, so compared to the same number of nodes in a fluid region, the
CPU costs are much less (U-Mom, V-Mom, W-Mom and P-Mass are not solved).
Multicomponent Flows
Each additional component adds an extra scalar equation. Therefore, as the number of components increase, CPU
time required to solve the Mass Fraction equation increases linearly. Expect each component to add approximately
25% to the CPU required for the U-Mom, V-Mom, W-Mom and P-Mass equations.
Multiphase Flows
The following topics will be discussed:
• Homogeneous Model (p. 125)
• Inhomogeneous Model (p. 125)
Homogeneous Model
For two-phase flow using the homogeneous model, expect memory requirements to increase by a factor of 1.5 and
CPU time to increase by a factor of 1.7 over the same single-phase simulation. Enabling free surface does not
significantly alter CPU or memory requirements.
Inhomogeneous Model
For two-phase flow using the particle or mixture models, expect memory requirements to increase by a factor of
2.15 and CPU time to increase by a factor of 2.25. Enabling free surface does not significantly alter CPU or memory
requirements.
N-Phase Flow
As the number of fluids increase, expect memory and CPU requirements to increase approximately linearly for
small N. Tetrahedral meshes have more of a linear increase than hexahedral meshes. The table below gives
approximate memory increase factors for up to 5 phases when compared to the same single-phase simulation on a
hexahedral mesh.
Expect the CPU factor to be slightly less than the corresponding memory factors, but the trend is the same.
Combustion Modeling
Modeling combustion incurs a slight cost compared to multicomponent flow with the same number of components.
For multi-step reactions each component is solved using the coupled solve. This incurs additional CPU time which
does not increase linearly with the number of components.
Radiation Modeling
This adds a single scalar equation. Cost increases are similar to those of the energy equation. For details, see Energy
Models (p. 124).
GGI Interfaces
An intersection algorithm which is performed at the start of a simulation to connect each side of a GGI connection
incurs a one-time cost.
Each GGI connection means approximately 5% more CPU time and memory is required. This number can vary
greatly, as it is a function of the number of nodes involved in a GGI connection, compared to the number of nodes
that are not involved in the GGI connection. There is also a dependence on the geometric complexity of the GGI
connection.
Transient Runs
Each coefficient loop requires approximately the same CPU time as the equivalent steady-state iteration.
Mesh Deformation
Mesh deformation using either of the Regions of Motion Specified or Junction Box Routine
options introduces several CPU intensive operations during each outer iteration or time step. When deformation is
performed using Regions of Motion Specified, a Mesh Displacement equation is assembled and solved
at the start of each outer iteration or time step for Steady State and Transient simulations, respectively, and the mesh
coordinates are updated. When deformation is performed using a Junction Box Routine, you define how
mesh coordinates are updated.
After updating the mesh coordinates, other mesh related quantities (such as volumes, areas, mesh quality measures,
mesh velocities, etc.) are updated, and GGIs are re-intersected before advancing to solve other equations or physical
models for the current outer iteration or time step. Mesh volume flows that are later used to augment mass flow
rates applied in advective transport are precalculated and stored during these updates.
Depending on the complexity of the deformation and physical model (for example, the use of GGIs), adding the
mesh deformation to a simulation will increase CPU usage by approximately 10% to 50% per outer iteration or
time step.
Adding the mesh deformation will increase memory requirements due to the storage of: the noted mesh volume
flows (one per control volume integration point), and multiple sets of mesh coordinates for transient simulations
(one triplet per mesh vertex per time step that must be kept for the selected transient discretization).
Weak 2× to 5×
Typical 5× to 10×
• Instructing the solver running in the named directory to write a backup results file.
• Adjusting the priority of a CFX-Solver run by resetting the run priority on Windows or altering the nice increment
on non-Windows platforms. This applies to all solver processes in a parallel run.
where <level> is one of Idle, Low, Standard or High, as given in the following table:
If the current priority level is the same as <level> then there is no change. Administrative (or root) privileges
are usually required to increase the priority from a lower level to a higher level. When the change of priority is
attempted, then the CFX-Solver will write a diagnostic message into the CFX-Solver Output file of the form:
+--------------------------------------------------------------------+
| ****** Updating Runtime Priority ****** |
| |
| <outcome of the attempt to change the run priority> |
| |
+--------------------------------------------------------------------+
<CFXROOT>/bin/cfx5control -help
In these examples:
• <CFXROOT> is the path to your installation of CFX
• <directory> specifies a directory in which the ANSYS CFX solver is currently running, such as
StaticMixer_004.dir.
• -no-backup prevents the solver from writing a backup file before reading the new Command Language file.
Output Modifiers
The following scaling and offset factors can be used to change the units of the solution. The factors can be applied
when you need to convert the units that are written to the CFX file into those that you want to use in ANSYS.
The available modifiers are:
Offset Flow
Default Value: 0
Requires a real number corresponding to the offset value applied to solution flows.
Offset Values
Default Value: 0
Requires a real number corresponding to the offset value applied to solution values.
Scale Flow
Default Value: 1
Requires a real number corresponding to the scaling factor applied to solution flows.
Scale Values
Default Value: 1
Requires a real number corresponding to the scaling factor applied to solution values.
Results File
The name of the CFX-Solver results file to be exported.
Domain Selection:Name
The domain or domains in the CFX-Solver results file that are to be exported.
Timestep Selection:Time
For transient CFX-Solver results files, the timestep to be exported.
Output Format
Default Value: CGNS
The output format selects which standard file format the output file will be written in. If a nonstandard format is
required, select Custom User Export.
The sections that follow describe the available output formats.
Note
For simulations with multiple configurations, *.mres files cannot be exported by the CFX-Solver
Manager.
CGNS
The CFD General Notation System (CGNS) is designed to facilitate the exchange of data between sites and
applications, and to help stabilize the archiving of data. The data is stored in a compact, binary format.
Note
To configure this option, select Tools > Export. The dialog box uses numerous common export options.
For details, see Generic Export Options (p. 132).
Overview
CGNS consists of a collection of conventions for the storage and retrieval of CFD data. The system consists of two
parts:
• A standard format in which the data is recorded.
• Software that reads, writes, and modifies data in that format.
Available Options
The following options are available when writing a file in CGNS format:
• All options specified in Generic Export Options (p. 132)
• Geometry Output Only
• Default Value: Unselected.
• If selected, only mesh information and boundary condition information is written to the destination file—result
variables are not written.
• Output boundaries as
• Default Value: Nodes
• If Nodes are selected, all boundary conditions are written as collections of nodes; if Faces, then boundary
conditions are written as groups of 2D elements (faces). CFD-Post cannot read boundaries that are output
as Faces.
• When Write Transient Data to One File is selected, all transient data (grid and results) are written to one
CGNS file using BaseIterativeData_t and ZoneIterativeData_t nodes within the file. When this
option is not selected, transient results are exported to a separate file for each timestep.
• When Use CGNS Variable Names is selected ANSYS CFX variable names are mapped to CGNS variable
names. For example Total Pressure becomes PressureStagnation.
Exported Files
The exported file set consists of either a single file for non-transient results, or multiple files for transient results.
Each contains a complete mesh and flow solution. By default all files are generated with a .cgns extension. Import
into a program that reads CGNS files should be done according to the importing program's instructions.
ANSYS CFX-Export is capable of writing CGNS Version 2.4 files. These CGNS files can be read by third parties
if they support the features CFX writes and are using CGNS Version 2.0 and above.
Note
A CGNS-valid file can be written in ADF or HDF5 format. CFX currently supports only ADF base files.
When HDF5 becomes standard practice, it is expected that both versions will be supported and identified
seamlessly.
Base (Base_t)
A single base is written to each CGNS file.
• Its name is not significant.
• It is always written with a cell_dimension of 3 (that is, 3D).
If a transient file is being written, a simulation type (SimulationType_t) of TimeAccurate is specified
below the base node.
A state (ReferenceState_t) is also written below the base node with a description of where the file was
generated from and what it represents.
Zones (Zone_t)
A single zone is written under each Base_t node for each domain requested by the user and is always unstructured
in nature.
Coordinates of node data are always written in double precision. Due to the nature of the grid being unstructured,
there is no implicit ordering in how the grid is written.
Elements (Elements_t)
Element sections are written on a one per domain/subdomain basis as well as a one per boundary condition basis.
Due to the nature of CFX data, a single element cannot appear in more than one element section. Element numbering
is unique and consecutive.
You can control whether volume mesh (with surface mesh) or a surface mesh is written to the file.
Transient Data
Transient data is written to separate CGNS files by writing the Grid and Solution data for each CFX transient file
that is available to the cfx5export process.
Note
An issue was detected while reading a CGNS file in TecPlot 10 and earlier that prevented the files written
by ANSYS CFX being read by TecPlot. If a problem is encountered, try setting the environment variable
CFX5_EXPORT_CGNS_TECPLOT to a value of 1, restart ANSYS CFX, and export the CGNS file
again. If the problem persists, contact either ANSYS support or TecPlot support.
MSC.Patran
MSC.Patran is a general-purpose CAE simulation tool.
Note
To configure this option, select Tools > Export. The dialog box uses numerous common export options.
For details, see Generic Export Options (p. 132).
Available Options
The following options are available when writing a file in MASC.Patran format:
• All options specified in Generic Export Options (p. 132)
• Geometry Output Only (Neutral File)
• Default Value: Unselected.
If selected, the mesh from the ANSYS CFX results file is written to a Neutral file; solution variables are not
written to the Neutral file. For more details about MSC.Patran Neutral files, refer to your documentation
from MSC.Patran.
Exported Files
The file set for this export option consists of three files:
ANSYS CFX writes files in ASCII format using a subset of the record types to be found in the full definition of the
PATRAN file formats. The full definition of the PATRAN file formats can be found in the MSC.Patran
documentation.
Faces associated with the CFX boundaries and elements associated with subdomains are transferred into PATRAN
named components. The boundary/subdomain components are named using their CFX name.
Exported nodes are associated only with the PATRAN default_group, unless -nodes is used when cfx5export is
used from the command line.
Note
An MSC.Patran warning may appear when importing the Neutral file that reads No element type could
be found for element property set <P_SET.1>. No action needs to be taken.
Example Procedure
Here is an outline of some guidelines for one possible procedure for incorporating CFX results into a PATRAN
model. CFX temperature predictions will be used to define a temperature distribution on a geometry surface of a
new model. Details about any of the options can be found in the MSC.Patran documentation.
Points to note in this example are:
• Files generated by ANSYS CFX should be read into a new database first before any PATRAN model grid. This
ensures that the node numbers of the Neutral file correspond to the nodal result file. The nodes and elements in
the new model mesh will be numbered or renumbered to follow on from those in the CFX data.
• The CFX model should not be included in the new model analysis, but the CFX data must not be deleted until
the boundary values have been interpolated onto the new grid.
• The new model mesh can either be created or imported as part of step Step 6 (p. 137) or in a later step, without
affecting the procedure, because in this example the boundary condition is defined on geometry surfaces.
The example assumes exported results include the Temperature variable.
1. Prepare PATRAN Neutral and Nodal results files containing boundary data only.
Export the ANSYS CFX results file to MSC.Patran format, either using CFX-Solver Manager or directly from
the command line. Toggle Boundary Data Output Only on if using CFX-Solver Manager, or use the
-boundary option if using cfx5export from the command line.
FIELDVIEW
FIELDVIEW is a standalone CFD post processor supplied by Intelligent Light.
Note
To configure this option, select Tools > Export. The dialog box uses numerous common export options.
For details, see Generic Export Options (p. 132).
Available Options
The following options are available when writing a file for use in FIELDVIEW Unstructured format:
• All Options specified in Generic Export Options (p. 132).
• FV-UNS File Options: The options in this section detail the formatting of the separate grid and results files or
combined grid and results files that are written in FV-UNS (FIELDVIEW Unstructured) file format.
• Version:
• Default Value: 3.0
• The value selected details which version of the format should be used when writing the grid and results to
files for use within FIELDVIEW. It is recommended that you use the most recent version of the file format
supported by FIELDVIEW installed. Refer to the FIELDVIEW documentation for this information.
• Split Grid and Results Format:
• Default Value: Selected
• When selected, the grid from the ANSYS CFX results file is written to one file and the results to a second
or subsequent files. If not selected, a single combined file is written containing both the grid and the results.
Note
• This option is not available when the version is less than 2.7.
• If the number of variables that are to be written to the file exceeds 200, the results will be
written to more than one results file. Refer to FIELDVIEW 9 and later to learn how to load
multiple files into FIELDVIEW.
• Format:
• Default Value: Unstructured Binary
• This option enables a choice of whether the FV-UNS are written as in binary or ASCII format. The ASCII
format is human-readable but larger than the binary format. It is therefore recommended by ANSYS and
FIELDVIEW that binary format files be written in most cases.
• FV-REG Version:
• Default Value: 2.0
• The version specified here details the version of the format used when writing the region file for use in
FIELDVIEW. It is recommended that you specify the highest version that is supported by the version of
FIELDVIEW installed.
Exported Files
The file set for this export option consists of several files, depending on the format options selected.
If the output format is selected to be Split Grid and Results Format, more than one file will be generated with the
grid in one file and results in at least one other. Optionally, a region file will also be generated:
If Split Grid and Results Format (see Available Options (p. 138)) is not selected, then at least one combined grid
and results file will be generated:
Optionally, if particle tracks have been written in the ANSYS CFX results file, then these will be written to one or
more FIELDVIEW particle track files:
ANSYS CFX writes a subset of record types that are available in the full FIELDVIEW file formats. The
documentation supplied with FIELDVIEW describes all the record types that can be read by different versions of
FIELDVIEW.
FIELDVIEW Versions 6, 7, 8
The following procedure enables importing results into FIELDVIEW Version 6, 7 and 8.
Note
FIELDVIEW reads the version number from within the input file; however, some file formats that can
be generated by ANSYS CFX cannot be read by all version of FIELDVIEW. Refer to FIELDVIEW
documentation for exact details of which file formats can be processed by FIELDVIEW.
1. Select Data Files > Unstructured Data Input from the menu bar. In File Selection, select the file created
using cfx5export and then click OK. In Function Subset Selection, select All and click OK. Click Exit in
Unstructured Data Input.
2. The results can now be analyzed as required.
Note
The Region file written by ANSYS CFX to these versions of FIELDVIEW may have to be modified to
ensure correct axes of rotation and rotational velocities in FIELDVIEW.
If the ANSYS CFX file contains multiple rotation axes, it is not possible to write a single FIELDVIEW
file that can be correctly used in FIELDVIEW. In this case, you must write the file in “Split Grid and
Results Format”. For more details about reading FIELDVIEW Unstructured files, see the FIELDVIEW
documentation.
EnSight
EnSight is a suite of tools for engineering and scientific simulation.
Note
To configure this option, select Tools > Export. The dialog box uses numerous common export options.
For details, see Generic Export Options (p. 132).
Available Options
The following options are available when writing files for use in EnSight:
• All options specified in Generic Export Options (p. 132)
• EnSight Version:
• Default Value: Gold
• The selection specifies the EnSight file format version to which the output will adhere. It is recommended
that Gold be selected wherever possible. Refer to the EnSight documentation for differences between the
different formats.
• Format:
• Default Value: Unstructured Binary
• This option enables you to choose whether the EnSight data files are written as in binary or ASCII format.
The ASCII format is human-readable but larger than the binary format. It is therefore recommended by
ANSYS that binary format files are written in most cases.
Export Files
The file set for this export option consists of the following files:
Note
• Each subdomain and boundary condition is exported as one EnSight part.
• CFX variable aliases have to be modified (by removing spaces and special characters and by limiting
the name length) to create valid EnSight variable names. In some cases the names that result may
not be human recognizable; in all cases the mapping from the name used in ANSYS CFX to that
written to the EnSight file is displayed in the progress window of the Solver Manager.
ANSYS CFX uses a subset of record types that are available in the full EnSight file formats. The documentation
supplied with EnSight describes all the record types that can be used.
EnSight 5
The following procedure enables importing results into EnSight 5. Results files may need modification, depending
on how they are to be used with EnSight. For more details about importing, see the EnSight documentation.
1. Select File > Data (Reader). In File Selection, click the name of the geometry file created using cfx5export,
and then click on (Set) Geometry.
2. Click on the name of the EnSight results file. Click (Set) Result and then click Okay.
3. In Data Part Loader, click Load All, and then click Close.
4. The results can now be analyzed as required.
Export File
This option specifies the destination file to which the grid and results will be written. This file name may be altered
in such a way that multiple files may be written with transient data or if the Output Format requires multiple files
to be written.
Note
-cgns, -ensight, -fieldview, -patran, or -custom should be the first option on the command
line.
• -cgns creates files suitable for an application that supports the CGNS format.
• -ensight creates files suitable for input into the EnSight post-processor.
• -patran creates files suitable for input into the MSC/PATRAN post-processor.
• -fieldview creates files suitable for input into the FIELDVIEW post-processor.
• -custom should be used if there is a need for custom-defined export formats. For details, see Running a
Customized Export Program using cfx5export from the Command Line (p. 148).
For all standard options (-cgns, -patran, -fieldview, and -ensight), the source ANSYS CFX file <file>
is the same file as would be specified under Tools > Export > Results File in CFX-Solver Manager. The optional
file entered as -name <file> is the filename used as the basename for the files generated as part of the export
process (this is equivalent to what is specified under Tools > Export > Export File).
Running cfx5export
To run cfx5export from the command line, type one of the following commands into a UNIX terminal or a suitable
Windows command line and press Return or Enter. For details, see Command Line (p. 3) in the ANSYS CFX
Reference Guide.
or
or
or
or
or
Keyword Descriptions
A basic description of the keywords is given below.
-name <base> -output Set the basename for the output files to <base> instead
<base> -out of the name of the input file. If you do not use this
<base> option, the exported files will be written in the same
directory as the input file. You need to take care when
selecting this name to avoid your CFX results file being
overwritten.
-norotate Do not rotate the grid to its true position. For details,
see Mesh Options: Use Initial Mesh for Rotating
Domains (p. 142).
-split-grid-and-results Use the FIELDVIEW Split Grid and Results file format
when writing grid and results files.
-timestep <number> -time If the <number> is non-zero, data for the given timestep
<number> in a transient run is exported. If <number> is -1, data
-t <number> from all timesteps is exported. If the -timestep switch
is not given, data from the last timestep will be exported.
File Format
If you elect to export the results file, which contains the solution to the final timestep, the format will be:
filename.ext
filename_t#.ext
Note
EnSight transient files will be sequentially numbered, regardless of the timestep value. For example, if
timesteps of 1s, 5s, and 7s are exported, they will have the filenames filename_t1.ext,
filename_t2.ext and filename_t3.ext.
3. Enter any associated options required to run the customized program (such as would be entered at the command
line) in Custom Export Setting.
4. The specified custom export program runs with the associated arguments when you click Export.
Important
It is important to run the command line in the CFX environment. For details, see Command Line (p. 3)
in the ANSYS CFX Reference Guide.
UNIX
To run the program directly on a UNIX system, open a command line started from the launcher (Tools > Command
Line) and call your program using:
Windows
On a Windows machine, run the program by opening a command line started from the launcher (Tools > Command
Line), changing directory to c:\smith\export, and typing:
Note
Just double-clicking on the name of the program in the Windows Explorer, or using the Execute
myexport.exe option in Microsoft Developer Studio does not readily give you the option to enter
command-line arguments.
CFX_EXPORT_EXEC="<executable_path>"
where <executable_path> is the full path and name of the executable (for example,
/home/smith/export/myexport or c:\smith\export\myexport as appropriate). For details, see
Resources Set in cfx5rc Files (p. 38) in the ANSYS CFX Introduction.
The cfx5export command can be used with the custom argument for the given example. Type:
into a UNIX terminal or a suitable Windows command prompt and press Return or Enter. For details, see Command
Line (p. 3) in the ANSYS CFX Reference Guide.
U
user
export, 142
V
variables
plotting by a specific, 96
variables file, 80
view MAX residuals command, 100
view RMS residuals command, 100
W
workspace menu commands
overview, 91
workspace properties command
overview, 91
Workspace selector
for CFX-Solver Manager runs, 2
Z
zero-equation model
CPU and memory requirements of, 124