Chapter 6: file/

The user interface commands related to the File menu (such as reading files, importing files) and other Select File dialog boxes do not work for the dual process build. You need to use the TUI commands instead (for example, /file/read-mesh).


Important:
  • The host cannot be detached and reattached; once the connection is broken the data is lost. You need to save the data if the machine must be shut down in between.

  • All graphics information will be sent over the network, so initially it could take a long time to assemble graphical information (especially if the host and remote server are across continents) but after that the graphics manipulation is fast.


file/append-mesh

Enables you to append the mesh files. This command is available only after a mesh file has been read in.


Note:  Appending mesh files is not supported once the mesh is distributed.


Append Rules:

  • If zone names and IDs are duplicated, they will be modified and the changes will be reported in the console.

  • Domain information will be retained during the file append operation. If domain names are duplicated, they will be modified and the changes will be reported in the console.

  • Refinement region information will be retained during the file append operation. If region names are duplicated, they will be modified and the changes will be reported in the console.

  • You can append files comprising only edge zones (without face zones).

  • Edge-face zone associations will be retained during the file append operation.

  • Zone-specific prism parameter information will be retained during the file append operation.

file/append-meshes-by-tmerge

Enables you to append the mesh files using the tmerge utility. This command is available only after a mesh file has been read in.

file/cff-files?

Answering yes will set the Common Fluids Format (CFF) as the default file format for reading and writing case/data files.

file/confirm-overwrite?

Controls whether attempts to overwrite existing files require confirmation.

If you do not want Ansys Fluent to ask you for confirmation before it overwrites existing files, you can enter the file/confirm-overwrite? text command and answer no.

file/file-format

Enables/disables the writing of binary files.

file/filter-list

Lists the names of the converters that are used to change foreign mesh (while importing mesh files from third-party packages) files.

file/filter-options

Enables you to change the extension (such as .cas, .msh, .neu) and arguments used with a specified filter.

For example, if you saved the PATRAN files with a .NEU extension instead of .neu, you can substitute or add .NEU to the extension list. For some filters, one of the arguments will be the dimensionality of the grid.

When you use the filter-options command for such a filter, you will see a default dimensionality argument of -d a. The dimension will automatically be determined, so you need not substitute 2 or 3 for a.

file/import/

Enables you to import mesh information generated by some CAD packages (Ansys, I-deas, NASTRAN, PATRAN, and HYPERMESH), as well as mesh information in the CGNS (CFD general notation system) format.

These files are imported using the associated text commands listed here:

file/import/ansys-surf-mesh

Enables you to read a Ansys surface mesh file.

file/import/ansys-vol-mesh

Enables you to read a Ansys volume mesh file.

file/import/cad

Enables you to import CAD files based on the options set.

  • To import a single file (default), specify the file path and set up options for extracting features, importing curvature data from CAD, and the length unit.

  • To import multiple files, specify the directory path and pattern, and set up options for appending the files, extracting features, importing curvature data from CAD and the length unit.

file/import/cad-geometry

Enables you to import CAD files based on the options set.

  • To import a single file (default), specify the file path. Set up options for the length unit, tessellation method, and sizing parameters based on the tessellation method.

  • To import multiple files, specify the directory path and pattern. Set up options for appending the files, the length unit, tessellation method, and sizing parameters based on the tessellation method.

file/import/cad-options/

Contains additional options for importing CAD files.

file/import/cad-options/continue-on-error?

Enables you to continue the import of the CAD file(s), despite errors or problems creating the faceting on certain surfaces, or other issues. This option is disabled by default.

file/import/cad-options/create-cad-assemblies?

Enables creating the CAD Assemblies tree on CAD import. The CAD Assemblies tree represents the CAD tree as it is presented in the CAD package in which it was created. All sub-assembly levels from the CAD are maintained on import in Fluent Meshing.

For commands specific to the CAD assemblies, refer to cad-assemblies/

file/import/cad-options/derive-zone-name-from-object-scope?

Enables zones without Named Selections to inherit the object name on import. This option is disabled by default.

file/import/cad-options/double-connected-face-label

Adds the specified label to the name of double-connected face zones (face zones shared by two bodies).

file/import/cad-options/enclosure-symm-processing?

Enables processing of enclosure and symmetry named selections during import. This option is disabled by default. This option is applicable only to Ansys DesignModeler (*.agdb) files.

file/import/cad-options/extract-features?

Enables feature extraction from the CAD model on import. You can choose to disable this, if desired. Specify an appropriate value for feature angle. The default value is 40.

file/import/cad-options/import-body-names?

Enables import of Body names from the CAD files. This option is enabled by default.


Note:  Any renaming of Body names in Ansys Mechanical/Ansys Meshing prior to the export of the mechdat/meshdat files is ignored during import. Only original Body names will be imported.


file/import/cad-options/import-curvature-data-from-CAD?

Enables importing of the curvature data from the nodes of the CAD facets. You can choose to disable this, if desired.

file/import/cad-options/import-part-names?

Enables import of Part names from the CAD file(s). This option is enabled by default.


Note:  Any renaming of Part names in Ansys Mechanical/Ansys Meshing prior to the export of the mechdat/meshdat files is ignored during import. Only original Part names will be imported.


file/import/cad-options/merge-nodes?

Enables the merging of geometry object nodes during CAD import. This option is enabled by default.


Note:  This option can be optionally enabled/disabled only when geometry objects are imported using the CAD Faceting option for CAD import. Mesh object nodes will always be merged when the CFD Surface Mesh is selected for CAD import.


file/import/cad-options/modify-all-duplicate-names?

Enables you to modify all duplicate object/zone names by adding incremental integers as suffix. This option is disabled by default.

For example: The CAD file contains multiple parts (or bodies) named heatshield.

  • With the option disabled (default), the imported zones will be named heatshield, heatshield.1, heatshield.2, etc.

  • With the option enabled, the imported zones will be named heatshield.1, heatshield.2, heatshield.3, etc.

file/import/cad-options/name-separator-character

Allows you to specify the character used between name fields. Default is ':'.

file/import/cad-options/named-selections

Enables you to import Named Selections from the CAD file(s), including Named Selections from Ansys DesignModeler, publications from CATIA, and so on. You can additionally choose to ignore import of certain Named Selections based on the pattern specified (for example, Layer* to ignore layer Named Selections from CATIA), or by specifying multiple wild cards (for example, ^(Color|Layer|Material).* to remove color, layer, and material Named Selections from CATIA).


Note:
  • Named Selections defined in Ansys Meshing cannot be imported.

  • If Named Selections is enabled, then Face named selections will be imported as face zone labels.


file/import/cad-options/object-type

Enables the setting of object type on import. The options available are auto, geometry, and mesh. The default setting is auto based on the tessellation method selected: geometry objects will be created when the cad-faceting method is used, while mesh objects will be created when the cfd-surface-mesh method is used.

file/import/cad-options/one-face-zone-per

Enables you to create one face zone per body/face/object to be imported.

file/import/cad-options/one-object-per

Enables you to create one object per body/part/file/selection to be imported. The default program-controlled option allows the software to make the appropriate choice. This option makes a choice between per body and per part based on whether shared topology is off or on, respectively.


Note:  For Ansys ICEM CFD files (*.tin), set the object granularity to one object per selection.


file/import/cad-options/read-all-cad-in-subdirectories?

When enabled, all files in the specified directory as well as in its subdirectories will be imported. This option is disabled by default.

file/import/cad-options/save-PMDB?

Saves a PMDB (*.pmdb) file in the directory containing the CAD files imported. You can use this file to import the same CAD file(s) again with different options set, for a quicker import than the full import. This option is disabled by default.


Note:  Some options will not be available any more once the model is imported from a PMDB file (for example, enclosure-symm-processing?), since they are processed before the PMDB file is created.


file/import/cad-options/separate-features-by-type?

Enables separation of feature edges based on angle, connectivity, and named selections on import. Edge zone names will have suitable suffixes depending on separation criteria, order of zones, existing zone names and other import options selected.

file/import/cad-options/single-connected-edge-label

Adds the specified label to the name of single-connected edge zones (edge zones referenced by a single face).

file/import/cad-options/strip-file-name-extension-from-naming?

Removes the extension of the CAD files from the object/face zone names on import. This option is disabled by default.

file/import/cad-options/strip-path-prefix-from-names?

Enables you to remove the path prefix from the object/face zone names on import. The default setting is auto which removes the path prefix from object/face zone names when the object creation granularity is set to one object per file. You can also explicitly select yes or no.

file/import/cad-options/tessellation

Enables you to control the tessellation (faceting) during file import. You can select either cad-faceting or cfd-surface-mesh.

CAD faceting enables you to control the tessellation based on the CAD faceting tolerance and maximum facet size specified.

CFD Surface Mesh enables you to use a size field file, (Use size field file?). If you enter yes, specify the size field file to be read. If you do not want to use a size field file, you can obtain conformal faceting based on the underlying curve and surface curvature (using the minimum and maximum facet sizes, and the facet curvature normal angle specified) and edge proximity (using the cells per gap specified). You can also save a size field in a file (size field is computed based on the specified parameters; that is, Min Size, Max Size, Curvature Normal Angle, Cells Per Gap).

file/import/cad-options/use-collection-names?

Enables you to use the Named Selections for the object/zone names on import. Select auto, no, or yes. The default selection is auto where the Named Selection will be used as the object/zone name, except when the object creation granularity is set to one object per file.

file/import/cad-options/use-component-names?

Enables you to add the component (part or assembly) names to the object/zone names on import. Select auto, no, or yes. The default selection is auto where the component name will be added to the object/zone name.

file/import/cad-options/use-part-names?

Enables you to choose whether to add the part names from the CAD file to the object and zone names on import. The default setting is auto which adds the part names to both object and zone names when object creation granularity is set to body. When the object creation granularity is set to part or file, the part names are not added to the zone names, face zone labels, or the region names, by default. You can also explicitly select yes or no.

file/import/cad-options/use-part-or-body-names-assuffix-to-named-selections?

Enables you to modify zone names by using part or body names as suffixes to the Named Selections spanning multiple parts/bodies. This option is enabled by default.

For example: The CAD file contains a Named Selection effusion with part (or body) names id_liner and od_liner.

  • With the option enabled (default), the imported zones will be named effusion:id_liner and effusion:od_liner.

  • With the option disabled, the imported zones will be named effusion.1 and effusion.2.

file/import/cgns-surf-mesh

Enables you to read a CGNS surface mesh file.

file/import/cgns-vol-mesh

Enables you to read a CGNS volume mesh file.

file/import/fl-uns2-mesh

Enables you to read a Fluent UNS V2 case file.

file/import/fluent-2d-mesh

Enables you to read a 2D mesh into the 3D version.

file/import/gambit-surf-mesh

Enables you to read a GAMBIT surface mesh file.

file/import/gambit-vol-mesh

Enables you to read a GAMBIT volume mesh file.

file/import/hypermesh-surf-mesh

Enables you to read a HYPERMESH surface mesh file.

file/import/hypermesh-vol-mesh

Enables you to read a HYPERMESH volume mesh file.

file/import/nastran-surf-mesh

Enables you to read a NASTRAN surface mesh file.

file/import/nastran-vol-mesh

Enables you to read a NASTRAN volume mesh file.

file/load-act-tool

Loads the Ansys ACT tool.

file/read-boundary-mesh

Enables you to read a boundary mesh. If the boundary mesh is contained in two or more separate files, you can read them in together and assemble the complete boundary mesh.

This option is also convenient if you want to reuse the boundary mesh from a file containing a large volume mesh.


Note:  The naming of face zones can be controlled by Named Selections defined in Ansys Workbench. For details on exporting faceted geometry from Ansys Workbench, refer to the Ansys Workbench Help.


file/read-case

Enables you to read the mesh contained in a case file.


Note:  Cell hierarchy in case files adapted in the solution mode will be lost when they are read in the meshing mode.


Case files containing polyhedral cells can also be read in the meshing mode of Fluent. You can display the polyhedral mesh, perform certain mesh manipulation operations, check the mesh quality, and so on.

file/read-domains

Enables you to read domain files.

Each mesh file written by Fluent has a domain section. A domain file is the domain section of the mesh file and is written as a separate file. It contains a list of node, face, and cell zone IDs that make up each domain in the mesh.

If a domain that is being read already exists in the mesh, a warning message is displayed. Fluent verifies if the zones defining the domains exist in the mesh. If not, it will display a warning message.

file/read-journal

Enables you to read a journal file into the program.

The read-journal command always loads the file in the main (that is, top-level) menu, regardless of where you are in the menu hierarchy when you invoke it.

file/read-mesh

Enables you to read a mesh file. You can also use this command to read a Fluent mesh file created with GAMBIT, or to read the mesh available in a Fluent case file.


Note:  Reading a case file as a mesh file will result in loss of boundary condition data as the mesh file does not contain any information on boundary conditions.


Case files containing polyhedral cells can also be read in the meshing mode of Fluent. You can display the polyhedral mesh, perform certain mesh manipulation operations, check the mesh quality, and so on.


Important:  You cannot read meshes from solvers that have been adapted using hanging nodes. To read one of these meshes in the meshing mode in Fluent, coarsen the mesh within the solver until you have recovered the original unadapted grid.



Note:  The naming of face zones can be controlled by Named Selections defined in Ansys Workbench. For details on exporting faceted geometry from Ansys Workbench, refer to the Ansys Workbench Help.


file/read-meshes-by-tmerge

Uses the tmerge utility to read the mesh contained in two or more separate files. It enables you to read the mesh files together and helps assemble the complete mesh.

file/read-multi-bound-mesh

Enables you to read multiple boundary mesh files into the meshing mode.

file/read-multiple-mesh

Enables you to read in two or more files together and have the complete mesh assembled for you, if the mesh files are contained in two or more separate files.

For example, if you are going to create a hybrid mesh by reading in a triangular boundary mesh and a volume mesh consisting of hexahedral cells, you can read both files at the same time using this command.

file/read-options

Enables you to set the following options for reading mesh files:

  • Enforce mesh topology: This option is disabled by default. Enabling this option will orient the face zones consistently when the mesh file is read. If necessary, the zones being read will be separated, such that each boundary face zone has at most two cell zones as neighbors, one on either side. Also, internal face zones are inserted between neighboring cell zones that are connected by interior faces.

  • Check read data: This option enables additional checks for the validity of the mesh. Enabling this option will check the mesh topology during file read. In case incorrect mesh topology is encountered, warning messages will be displayed and the erroneous entities will be deleted. Note that in case of mesh topology errors, no automatic mesh repair is done, and that parts of the mesh may be non-conformal, contain voids, or be erroneous in other ways. The purpose of the check-read-data option is to enable access to corrupt files. This option is disabled by default with the assumption that correct data will be read, and to shorten file read times.

file/read-size-field

Enables you to read in a size field file.


Note:  If you read a size-field file after scaling the model, ensure that the size-field file is appropriate for the scaled model (size-field vertices should match the scaled model).


file/set-idle-timeout

Allows you to set an idle timeout so that an idle Ansys Fluent session will automatically save and close after the specified time.

file/set-tui-version

Allows you to improve backwards compatibility for journal files. This command hides any new TUI prompts that are added at a future release of Ansys Fluent and reverts to the arguments of the release that you specify using the command (within two full releases of the current release). The command is automatically added to a journal file as soon as you start the recording. See Creating and Reading Journal Files for details.

file/show-configuration

Displays the current release and version information.

file/start-journal

Starts recording all input and writes it to a file. The current Fluent version is automatically recorded in the journal file. Note that commands entered using paths from older versions of Fluent will be upgraded to their current path in the journal file. See Creating and Reading Journal Files in the Fluent User's Guide.

To start the journaling process use the file/start-journal command, and end it with the file/stop-journal command (or by exiting the program). To read a journal file into the program, use the file/read-journal command.


Note:  The read-journal command always loads the file in the main (that is, top-level) menu, regardless of where you are in the menu hierarchy when you invoke it.


The standard period (.) alias is the same as the file/read-journal definition and is defined by:

 (alias ’. (lambda () (ti-read-journal))) 
file/start-transcript

Starts recording input and output in a file.

A transcript file contains a complete record of all standard input to and output from Fluent (usually all keyboard and user interface input and all screen output).Start the transcription process with the file/start-transcript command, and end it with the file/stop- transcript command (or by exiting the program).

file/stop-journal

Stops recording input and closes the journal file.

file/stop-transcript

Stops recording input and output, and closes the transcript file.

file/write-boundaries

Enables you to write the specified boundaries into a mesh file.

This is useful for large cases where you may want to mesh different parts of the mesh separately and then merge them together. This enables you to avoid frequent switching between domains for such cases. You can write out selected boundaries to a mesh file and then create the volume mesh for the part in a separate session. You can then read the saved mesh into the previous session and merge the part with the rest of the mesh.

file/write-case

Enables you to write a case file that can be read by Fluent.


Note:  You should delete dead zones in the mesh before writing the mesh or case file for Fluent.


file/write-domains

Enables you to write all the mesh domains (except global) into a file that can be read.

file/write-mesh

Enables you to write a mesh file.


Note:  You should delete dead zones in the mesh before writing the mesh or case file for Fluent.


file/write-options

Allows you to enable or disable the enforce mesh topology option, modify the compression level, and enable or disable combined continuous zones when writing mesh/case files.

The enforce mesh topology option is enabled by default; where it will orient the face zones consistently when the mesh file is written. If necessary, the zones will be separated, such that each boundary face zone has at most two cell zones as neighbors, one on either side. Also, internal face zones will be inserted between neighboring cell zones that are connected by interior faces.

When writing .msh.h5 files you can modify the compression level and choose whether or not to combine continuous zones. A number between 0 and 9 can be specified for the compression level, with higher values resulting in a better compression ratio, however, will increase the write time. A value of 0 will result in no compression, while a value of 9 provides the best compression ratio and the slowest write speed. When yes is entered for combine continuous zones, all zone data will be combined into one continuous dataset which will reduce file size. However, combining zones can potentially cause a decrease in write and read speed and potentially decreased performance.

file/write-size-field

Enables you to write a size field file.