Chapter 10: preferences/


Important:  Values that correspond to drop-down entries in the GUI version of Preferences are case-sensitive must be entered with the same capitalization as the GUI version and be contained within quotation marks.


preferences/appearance/

Enter the menu for preferences covering appearance.

preferences/appearance/ansys-logo/

Enter the menu for controlling Ansys logo visibility.

preferences/appearance/ansys-logo/visible

Enable or disable the visibility of the Ansys logo in the graphics window.

preferences/appearance/ansys-logo/color

Specify whether the Ansys logo is white or black.

preferences/appearance/application-font-size

Set the font size for the Fluent graphical user interface (GUI).

preferences/appearance/axis-triad

Enable or disable the visibility of the axis triad in the graphics window.

preferences/appearance/charts/

Enter the menu for controlling the display of 2D charts/plots.

preferences/appearance/charts/curve-colors

Specify the initial set of default colors for the rendering of curves. Note that changing this setting requires any plots to be replotted before you see the effect of the new setting.

preferences/appearance/charts/modern-plots-enabled

Enables enhanced plots, which is a beta feature. Enabling this feature exposes new fields (all beta functionality).

preferences/appearance/color-theme

Specify a color theme for the appearance of Ansys Fluent.

preferences/appearance/completer

Enable/disable the console automatic-completer, which suggests available commands as you type in the console.

preferences/appearance/graphics-background-color1

Controls the primary background color of the graphics window.

preferences/appearance/graphics-background-color2

Controls the secondary background color when the style is set as a gradient.

preferences/appearance/graphics-background-style

Specify whether the background color is uniform or if there is a gradient.

preferences/appearance/graphics-background-theme

Provides predefined color and style selections for the graphics window background color.

preferences/appearance/graphics-foreground-color

Specify the color of graphics window text.

preferences/appearance/graphics-view

Specify whether the default view is orthographic or perspective.

preferences/appearance/graphics-wall-face-color

Set the default face color for when the mesh is displayed.

preferences/appearance/group-by-tree-view

Specify how boundary conditions are grouped in the tree.

preferences/appearance/number-of-files-recently-used

Controls how many recently-used files are listed in the File ribbon tab and the Fluent Launcher.

preferences/appearance/quick-property-view

Enables/Disables the "quick-edit" properties panels that appear when you select a boundary in the graphics windows.

preferences/appearance/ruler

Adds or removes the ruler from the graphics window. Note that you must be in orthographic view for the ruler to be visible in the graphics window.

preferences/appearance/selections/

Enters the menu for controlling selections in the graphics window.

preferences/appearance/selections/enable-highlight-edge-transparency

Applies the selection color transparency to front-facing edges.

preferences/appearance/selections/highlight-edge-color

Specifies the color used to highlight edges when the Hover-Over Highlight feature is enabled (mouse-over-highlight-enabled). It is also the color used when items are selected in the graphics window.

preferences/appearance/selections/highlight-edge-weight

Specifies the thickness of the edge highlights when the Hover-Over Highlight feature is enabled (mouse-over-highlight-enabled). It is also the thickness used when items are selected in the graphics window. Valid inputs are 1-10.

preferences/appearance/selections/highlight-face-color

Specify which color indicates that a face is selected.

preferences/appearance/selections/highlight-transparency

Specify the transparency of the coloring on a selected surface. 0.1 is fully opaque and 1 is fully transparent.

preferences/appearance/selections/mouse-hover-probe-enabled

Enable/disable the display of result values in the graphics window upon mouse-over, when graphics objects displaying solution results are displayed.

preferences/appearance/selections/mouse-over-highlight-enabled

Enable/disable the highlighted outline of a surface when hovered-over. Note that objects must be redisplayed after changing this setting before the new setting is visible.

preferences/appearance/show-interface-children-zone

Enable/disable the showing of the non-overlapping zones and interior zones associated with one-to-one mesh interfaces under Setup / Boundary Conditions (under their zone types) in the outline view tree.

preferences/appearance/show-model-edges

Enable/disable whether mesh edges are shown in a mesh display.

preferences/appearance/startup-page

Enable/disable the display of the startup page when Ansys Fluent is started without loading a mesh or case file.

preferences/appearance/surface-specularity

Specify the specularity of all surfaces except those included in contour plots. Sepecularity is the reflectiveness of a surface; higher values (closer to 1) equate to a more reflective surface.

preferences/appearance/surface-specularity-for-contours

Specify the specularity of contour surfaces. Sepecularity is the reflectiveness of a surface; higher values (closer to 1) equate to a more reflective surface.

preferences/appearance/titles

Enable/disable the display of solver information in the graphics window.

preferences/general/

Enter the menu for general preferences.

preferences/general/advanced-partition

Select a Laplace smoothing option so that auto-partitioning prioritizes convergence and scalability during solution. Through these options, the Laplace smoothing method is enabled so that adjacent highly-stretched cells are grouped together in order to prevent partition boundaries from passing through areas of high-aspect ratio cells. The options include:

  • Laplace Auto-Partition

    For a case written using release 2023 R2 or later, you can select this option with the Metis auto-partition method, and Laplace smoothing will be directly based on the cell group information written into the case file. This option is selected by default with the Metis method.

  • Laplace Auto-Repartition

    For a case written using a release previous to 2023 R2, you can select this option, so that the cell group information is created during the repartition and migration steps that take place after the auto-partitioning when reading a case file. This option can be used with any auto-partition method.

preferences/general/automatic-transcript

Enable/disable the automatic creation of a transcript file for each Ansys Fluent session.

preferences/general/default-ioformat

Specify the default file format for saving mesh, case, and data files.

preferences/general/idle-timeout

Specify the default file format for saving case and data files.

preferences/general/startup-messages/

Contains a listing of messages that can be displayed as Fluent starts.

preferences/general/startup-messages/color-theme-change-message

You are given the choice of the default Fluent color theme or the new Dark color theme. You can also opt to keep your current color theme.

preferences/general/startup-messages/key-behavioral-changes-message

The message identifies changes in Fluent's behavior or capabilities deemed important enough to elevate with a mention outside of the Release Notes.

preferences/general/startup-messages/qaservice-message

The message informs you that Ansys Fluent is included in an Ansys QA service agreement. Speak with your service representative for information on the QA service agreement.

preferences/graphics/

Enter the menu for preferences covering appearance.

preferences/graphics/animation-option

Specify whether the entire model or just a wireframe is shown during manipulations in the graphics window.

preferences/graphics/boundary-markers/

Enter the boundary markers menu.

preferences/graphics/boundary-markers/color-option

Specify whether boundary markers are a fixed color or if they match the color of the surface they are identifying.

preferences/graphics/boundary-markers/enabled

Enable/disable boundary marker display.

preferences/graphics/boundary-markers/inlet-color

Specify the color of the inlet boundary markers.

preferences/graphics/boundary-markers/marker-fraction

Specify marker density factor (0.1-1).

preferences/graphics/boundary-markers/marker-limit

Specify the maximum number of markers at each boundary.

preferences/graphics/boundary-markers/outlet-color

Specify the color of the outlet boundary markers.

preferences/graphics/boundary-markers/scale-marker

Specify the scale factor for the boundary markers (0.1-10), which controls the overall size of the markers.

preferences/graphics/boundary-markers/show-inlet-markers

Enable/disable the display of boundary markers for inlets.

preferences/graphics/boundary-markers/show-outlet-markers

Enable/disable the display of boundary markers for outlets.

preferences/graphics/colormap-settings/

Enter the colormap settings menu.

preferences/graphics/colormap-settings/alignment

Specify the default colormap location.

preferences/graphics/colormap-settings/aspect-ratio-when-vertical

Specify the length vs. width ratio for a vertical colormap, which controls the thickness of the colormap; smaller values mean a thicker colormap.

preferences/graphics/colormap-settings/border-style

Specify how/when the colormap border appears.

preferences/graphics/colormap-settings/colormap

Choose the default colormap.

preferences/graphics/colormap-settings/labels

Specify whether there is a label for every colormap value or if some are skipped.

preferences/graphics/colormap-settings/levels

Specify the default colormap size.

preferences/graphics/colormap-settings/log-scale

Enable/disable the use of a logarithmic scale for the colormap.

preferences/graphics/colormap-settings/major-length-to-screen-ratio-when-vertical

Choose the length of the colormap as a fraction of graphics window height, when the colormap is vertical.

preferences/graphics/colormap-settings/number-format-precision

Specify the colormap number label precision.

preferences/graphics/colormap-settings/number-format-type

Specify how colormap numbers are displayed.

preferences/graphics/colormap-settings/show-colormap

Enable/disable the display of colormaps.

preferences/graphics/colormap-settings/skip-value

Specify how many number labels are skipped in the colormap.

preferences/graphics/colormap-settings/text-behavior

Specify whether colormap label text automatically scales with the colormap size.

preferences/graphics/colormap-settings/text-font-automatic-vertical-size

Specify the initial font size as a ratio of the colormap overall size, for vertically aligned colormaps.

preferences/graphics/colormap-settings/text-font-fixed-size

Set the font size for colormap labels.

preferences/graphics/colormap-settings/text-font-name

Set the font for colormap labels.

preferences/graphics/colormap-settings/type

Specify whether the colormap appearance is smooth or banded.

preferences/graphics/double-buffering

Enable/disable double-buffering, which reduces screen flicker, but may use more memory on some machines.

preferences/graphics/embedded-windows/

Controls for how embedded window dashboards are created and how they look.

preferences/graphics/embedded-windows/default-embedded-mesh-windows-view

Enable/disable the automatic embedding of the mesh graphics window (if displaying the mesh by default or via the 'Display Mesh' toolbar button), upon initialization.

preferences/graphics/embedded-windows/default-embedded-windows-view

Enable/disable the automatic embedding of the residual plot window into a new window Fluent starts computing.

preferences/graphics/embedded-windows/save-embedded-window-layout

The layout of the dashboard displayed when the case file is saved is preserved for the next time the case is read.

preferences/graphics/embedded-windows/show-border-for-embedded-window

A border is drawn around the windows embedded within the parent window.

preferences/graphics/enable-non-object-based-workflow

Allows for the ability to view various graphics displays (mesh, contours, vectors, pathlines, particle tracks) without creating an object in the outline view tree that is saved with the case file.

preferences/graphics/export-video-settings/

Options and settings for how animation videos are saved.

preferences/graphics/export-video-settings/advanced-video-quality-options/

Options for specifying the bitrate quality and whether the H.264 compression technique is used.

preferences/graphics/export-video-settings/advanced-video-quality-options/bit-rate-quality

Specifies the bitrate quality of the saved video file.

preferences/graphics/export-video-settings/advanced-video-quality-options/enable-h264

Choose whether or not to use the H.264 compression technique when writing the video file.

preferences/graphics/export-video-settings/video-format

Specifies the default format for saving video files.

preferences/graphics/export-video-settings/video-fps

Specifies the default frame rate (in frames per second) for saving video files.

preferences/graphics/export-video-settings/video-quality

Specifies the default quality for saving video files.

preferences/graphics/export-video-settings/video-resolution-x

Specifies the x-component of the resolution for saving video files.

preferences/graphics/export-video-settings/video-resolution-y

Specifies the y-component of the resolution for saving video files.

preferences/graphics/export-video-settings/video-scale

Specifies the default scaling for saving video files.

preferences/graphics/export-video-settings/video-smooth-scaling

Choose whether or not to use smoothing on image resolution when scaling for saving video files.

preferences/graphics/export-video-settings/video-use-frame-resolution

Choose whether or not to use the graphics window resolution when saving video files.

preferences/graphics/graphics-effects/

Enter the graphics effects menu.

preferences/graphics/graphics-effects/anti-aliasing

Enable/disable the smoothing of lines and text.

preferences/graphics/graphics-effects/grid-color

Specify the color of the grid lines when the ground plane grid is shown.

preferences/graphics/graphics-effects/grid-plane-enabled

Enable/disable the display of the ground plane grid.

preferences/graphics/graphics-effects/grid-plane-offset

Set the grid plane offset from the model as a percentage of the model size.

preferences/graphics/graphics-effects/plane-direction

Specify the direction of the plane for the ground plane grid and reflections.

preferences/graphics/graphics-effects/reflections-enabled

Enable/disable model reflections (mirror-type reflections).

preferences/graphics/graphics-effects/shadow-map-enabled

Enable/disable dynamic shadows, which show shadows of geometric entities on other objects based on lighting and object orientation.

preferences/graphics/graphics-effects/show-edge-reflections

Enable/disable the display of model edges in reflections. Note that this can negatively affect performance.

preferences/graphics/graphics-effects/simple-shadows-enabled

Enable/disable the display of static shadows on the ground plane.

preferences/graphics/graphics-effects/update-after-mouse-release

Enable/disable the updating of graphics effects as a model is being manipulated in the graphics window.

preferences/graphics/graphics-window-line-width

Specify the thickness of lines that appear in the graphics window.

preferences/graphics/graphics-window-point-symbol

Specify the symbol used for indicating points in the graphics window (like the points in an XY plot).

preferences/graphics/hardcopy-settings/

Enter the menu for saving picture settings.

preferences/graphics/hardcopy-settings/hardcopy-driver

Specify the default format for saving pictures.

preferences/graphics/hardcopy-settings/hardcopy-line-width

Specify the thinkness of lines for saved pictures.

preferences/graphics/hardcopy-settings/hardcopy-image-accel

Enable/disable the use of hardware acceleration when saving images, where possible.

preferences/graphics/hidden-surface-removal-method

Specify the method for removing hidden surfaces. These methods vary in speed and quality, depending on your machine.

preferences/graphics/lighting/

Enter the lighting menu.

preferences/graphics/lighting/headlight

Turn the headlight on or off or set it as automatic.

preferences/graphics/lighting/headlight-intensity

Specify the intensity of the headlight.

preferences/graphics/lighting/lighting-method

Specify the default lighting method.

preferences/graphics/meshing-mode/

Enter the menu for meshing-specific graphics settings.

preferences/graphics/meshing-mode/graphics-window-display-timeout

Enable/disable graphics window display timeout.

preferences/graphics/meshing-mode/graphics-window-display-timeout-value

Specify the graphics window display timeout value.

preferences/graphics/performance/

Enter the menu for selecting the predefined graphics effects settings.

preferences/graphics/performance/fast-display-mode/

Enter the menu for controlling fast graphics performance preferences.

preferences/graphics/performance/fast-display-mode/faces-shown

Specify whether or not faces are shown when interacting with the model.

preferences/graphics/performance/fast-display-mode/nodes-shown

Specify whether or not nodes are shown when interacting with the model.

preferences/graphics/performance/fast-display-mode/perimeter-edges-shown

Specify whether or not the perimeter edges are shown when interacting with the model.

preferences/graphics/performance/fast-display-mode/silhouette-shown

Specify whether or not the silhouette is shown when interacting with the model.

preferences/graphics/performance/fast-display-mode/status

Specify whether the fast interactive display settings are on, off, or automatic.

preferences/graphics/performance/fast-display-mode/transparency

Specify whether or not transparencies remain when interacting with the model.

preferences/graphics/performance/minimum-frame-rate/

Enter the menu for minimum frame-rate settings.

preferences/graphics/performance/minimum-frame-rate/dynamic-adjustment

Enable/disable dynamic adjustment of quality loss per frame to get to the desired frame rate.

preferences/graphics/performance/minimum-frame-rate/enabled

Enable/disable minimum frame rate.

preferences/graphics/performance/minimum-frame-rate/maximum-culling-threshold

With minimum frame rate enabled, Fluent will not cull beyond this number of pixels.

preferences/graphics/performance/minimum-frame-rate/minimum-culling-threshold

With minimum frame rate enabled, Fluent will cull at least this number of pixels.

preferences/graphics/performance/minimum-frame-rate/target-fps

Specify the target frames-per-second.

preferences/graphics/performance/optimize-for

Choose a preset selection for how graphics are displayed.

preferences/graphics/point-tool-size

Specify the size of the point tool (10-100).

preferences/graphics/show-hidden-surfaces

Enable/disable the display of hidden surfaces.

preferences/graphics/transparency/

Enter the menu for specifying transparency preferences.

preferences/graphics/transparency/algorithm-for-modern-drivers

Specify how Fluent applies transparency in the graphics window: Depth Peeling - best balance of performance and control, Z-Sort - Transparency is applied to all specified objects.

preferences/graphics/transparency/depth-peeling-layers

Specify how much transparency is applied to the interior of an object. Increasing the number of layers can increase rendering cost.

preferences/icing/

Enter the menu for preferences covering the Fluent Icing workspace.

preferences/icing/advanced-flag

Enable/disable the exposure of advanced settings.

preferences/icing/beta-flag

Enable/disable the exposure of beta features.

preferences/icing/display-mesh-after-case-load

Specify which boundaries are displayed by default after the mesh is read.

preferences/icing/use-launcher

Enable/disable the use of the Fluent Launcher for starting the Fluent solver when connecting to or creating a new Simulation. This allows you to launch calculations using a different number of CPUs, a different machine, or a queuing system..

preferences/meshing-workflow/

Enter the menu for preferences covering the Fluent Meshing workflows.

preferences/meshing-workflow/checkpointing_option

Specify how Fluent Meshing will save data when you edit a task.

preferences/meshing-workflow/draw-settings/

Enter the menu for specifying drawing settings.

preferences/meshing-workflow/draw-settings/auto-draw

Enable/disable the automatic display of changes in the graphics window based on the current task.

preferences/meshing-workflow/draw-settings/face-zone-limit

Specify the cutoff number of face zones, beyond which, Fluent Meshing will not automatically display changes.

preferences/meshing-workflow/draw-settings/facet-limit

Specify the cutoff number facets, beyond which, Fluent Meshing will not automatically display changes.

preferences/meshing-workflow/save-checkpoint-files

Enable/disable the saving of task editing data when writing a mesh file.

preferences/meshing-workflow/temp-folder

Specify a temporary location to hold generated mesh files. If nothing is specified, Fluent Meshing will write to %TEMP% on Windows and to /tmp on Linux.

preferences/meshing-workflow/verbosity

Enable/disable the printing of additional information and messages in the Console.

preferences/navigation/

Enter the menu for controlling navigation in Ansys Fluent.

preferences/navigation/mouse-mapping/

Enable/disable the printing of additional information and messages in the Console.

preferences/navigation/mouse-mapping/additional/

Enter the menu for controlling mouse mappings that include a modifier button such as Ctrl and Shift.

preferences/navigation/mouse-mapping/additional/ctrllmbclick

Specify the action/behavoir for Ctrl + left-mouse-button + click.

preferences/navigation/mouse-mapping/additional/ctrllmbdrag

Specify the action/behavior for Ctrl + left-mouse-button + drag.

preferences/navigation/mouse-mapping/additional/ctrlmmbclick

Specify the action/behavior for Ctrl + middle-mouse-button + click.

preferences/navigation/mouse-mapping/additional/ctrlmmbdrag

Specify the action/behavior for Ctrl + middle-mouse-button + drag.

preferences/navigation/mouse-mapping/additional/ctrlrmbclick

Specify the action/behavior for Ctrl + right-mouse-button + click.

preferences/navigation/mouse-mapping/additional/ctrlrmbdrag

Specify the action/behavior for Ctrl + right-mouse-button + drag.

preferences/navigation/mouse-mapping/additional/mouseprobe

Specify whether the probe action provides a long description or a short description.

preferences/navigation/mouse-mapping/additional/mousewheel

Specify the action/behavior of the mouse-wheel.

preferences/navigation/mouse-mapping/additional/mousewheelsensitivity

Specify the sensitivity of the mouse-wheel (0 is least sensitive, 1 is most sensitive).

preferences/navigation/mouse-mapping/additional/reversewheeldirection

Reverse the behavior of the mouse-wheel.

preferences/navigation/mouse-mapping/additional/shiftlmbclick

Specify the action/behavior for Shift + left-mouse-button + click.

preferences/navigation/mouse-mapping/additional/shiftlmbdrag

Specify the action/behavior for Shift + left-mouse-button + drag.

preferences/navigation/mouse-mapping/additional/shiftmmbclick

Specify the action/behavior for Shift + middle-mouse-button + click.

preferences/navigation/mouse-mapping/additional/shiftmmbdrag

Specify the action/behavior for Shift + middle-mouse-button + drag.

preferences/navigation/mouse-mapping/additional/shiftrmbclick

Specify the action/behavior for Shift + right-mouse-button + click.

preferences/navigation/mouse-mapping/additional/shiftrmbdrag

Specify the action/behavior for Shift + right-mouse-button + drag.

preferences/simulation/

Enter the menu for simulation preferences.

preferences/simulation/flow-model

Specify the default turbulence model (viscous).

preferences/simulation/local-residual-scaling

Use local residual scaling for solution residuals.

preferences/simulation/pdf-combustion-robust-numerics

Enable/disable the application of poor mesh numerics to non-premixed or partially premixed combustion cases, with the goal of increasing the robustness of the calculations that use a PDF table. When enabled, the register-based definition for poor mesh numerics treatment that is automatically created at initialization or when data is read (named pmn_pdf_stability_marker) is activated, and thus applies the treatment at regular intervals throughout the calculations to the cells that have an enthalpy value that is less than the minimum enthalpy defined in the PDF table.

preferences/simulation/report-definitions/

Enter the menu for report definition preferences.

preferences/simulation/report-definitions/automatic-plot-file

New report definitions will automatically create associated report files and plots.

preferences/simulation/report-definitions/report-plot-history-data-size

Specify how many data points are read from the associated report file and plotted in the graphics window. If the case/data files are already open, read the case and data again, after changing this setting, and re-plot to see the updated report plot.