Export Settings
The following settings appear under the CGNS link node when you set the Transfer Direction to Export.
[Link 1] Conditions and Values
In addition to the general conditions and values (see CGNS Link Reference), the following settings are specific to data export:
- Database Format
- Specifies the format of the CGNS database files. CGNS has two internal database file formats, HDF5 (with file extension .cgns) and ADF (.cga).
CGNS data was originally stored using ADF (Advanced Data Format), but ADF does not have parallel I/O or data compression capabilities, and does not have the support base and tools that HDF5 offers. ADF has since been superseded by HDF5 (Hierarchical Data Format, Version 5) as the official default underlying storage mechanism for CGNS.
- File Mode
- Specifies whether Simcenter STAR-CCM+ exports data to a single file or multiple files:
Method Corresponding Value Nodes - File Series
- At every export event, Simcenter STAR-CCM+ creates new CGNS files. The files created depend on the specified Mesh Mode. See Output CGNS Files.
- File Series Counter
- Allows you to specify the following properties:
- Counter Width—specifies the number of digits for the export events counter that is used in the file name.
- Separator—specifies the character that appears between the base file name and the number of the trigger event (@ by default).
- Single File
- Simcenter STAR-CCM+ creates separate files for mesh and solution data during the first export event (see Output CGNS Files). In subsequent exports, Simcenter STAR-CCM+ appends the export data to the existing files.
None
- Mesh Mode
- Allows you to restrict mesh data export based on mesh changes:
- Always Enabled—Simcenter STAR-CCM+ exports the mesh data at every export event. This option is available only when you set File Mode to File Series.
- Initially and on Mesh Change—Simcenter STAR-CCM+ exports the mesh data in the first export event. In subsequent exports, Simcenter STAR-CCM+ exports mesh data only when the mesh changes.
- Time Range
- This condition is only available if the Interval Trigger is set to Time Step or Delta Time and allows you to restrict data export to a specified time range:
Method Corresponding Value Nodes - Always Enabled
- Data export is active throughout the entire simulation.
None - Enable After Start Time
- Data export starts after a specified time.
- Start Time
- Specifies the time at which data export starts.
- Enable Before Stop Time
- Data export stops at a specified time.
- Stop Time
- Specifies the time at which data export stops.
- Enable Between Start and Stop Times
- Data export is active within a specified time range.
- Start Time, Stop Time
- Specify the times at which data export starts and stops, respectively.
- Interval Trigger
- Specifies the trigger method for the automatic execution of export events. The available options are:
- Mapping Option
- If set to Map Before Export, the field data is mapped from the internal region and boundaries to the external region and boundaries. If you have not set any External Continua this property will be read only. The external continuum must contain the File Transfer and CGNS Data Fileset models. By mapping before export it is possible to reduce the overall data output size by, for example, mapping from a fine to a coarse mesh, or by mapping from a moving to a static mesh.
- File
- Specifies the details for the output CGNS files:
- Directory—location in which Simcenter STAR-CCM+ saves the CGNS files.
- Base Filename—name prefix used in the file name. The default base filename is solution. The resulting file name depends on the specified File Mode and Mesh Mode (see Output CGNS Files).
[Zone] Conditions and Values
The zone conditions and values specify the parts (either boundaries or regions) from which Simcenter STAR-CCM+ exports data and the fields that are exported.
- Boundary Triangulation
- Controls how Simcenter STAR-CCM+ treats polygonal mesh faces when exporting surface meshes. Simcenter STAR-CCM+ can retain polygonal meshes or convert them to triangular meshes. Triangulating polygons is useful when you want to import the CGNS file into software packages that do not support polygonal meshes (for example, in finite element packages). Set Option to one of:
- Do Not Triangulate—retains the original polygonal faces.
- All Faces Including Quads—converts all polygonal faces to triangular faces.
- All Faces Excluding Quads—converts all polygonal faces to triangular faces while retaining quadrilateral faces. In general, most software packages (including finite element packages) support quads. Not triangulating quadrilateral faces leads to smaller file sizes.
- Exported Fields
- Allows you to export scalar or vector fields to the CGNS file. To export a field, you add an auxiliary field of appropriate type (scalar or vector) and set its properties:
- Initialization Method
- Automatically set to User-specified Initialization Value. Specify a constant initialization value under the node.
- Field Stencil
- Specifies the mesh stencil (Vertex or Face for surface meshes, and Vertex or Cell for volume meshes) from which Simcenter STAR-CCM+ maps the field data to be exported.
- Field Treatment (Read-Only)
- Automatically set to Unmanaged.
- Scalar/Vector Function
- Specifies the scalar or vector field function that stores the data to be exported.
- Merge Boundaries
- Controls whether Simcenter STAR-CCM+ retains the original boundaries when exporting surface meshes:
Option Corresponding Value Node - Do Not Merge Boundaries
- Retains the original boundaries.
None - Merge Boundaries Into One
- Merges the original boundaries into a single boundary.
- Merged Boundaries Name
- Specifies the name for the resulting boundary.
- Exported Volume Parts
Specifies the regions to be used to store the mapped volume partner mesh data when Map Before Export is selected.
- Exported Surface Parts
Specifies the boundaries to be used to store the mapped surface partner mesh data when Map Before Export is selected.
Output CGNS Files
File Mode | Mesh Mode | Exported Fields | Example Output Files | Description |
---|---|---|---|---|
File Series | Always Enabled | None |
| Each file contains mesh data only. |
Specified |
| Each file contains both mesh and solution data. | ||
Initially and on Mesh Change | None |
| Each file contains mesh data only. | |
Specified |
| Mesh and solution data are exported to separate files. The solution data files link to the correct mesh file. | ||
Single File | Initially and on Mesh Change | None | solution@mesh1.cgns | Mesh data are exported to a single file. If the mesh changes during the simulation, an additional base node is created in the mesh file. |
Specified |
| Solution and mesh data are exported to separate files. At each export event, the solution data set is added to the same base node within the solution data file. If the mesh changes during the simulation, an additional base node is created in the mesh file. The solution data sets link to the relevant mesh base node. |