FGM Table Reference
The Flamelet Generated Manifold (FGM) model uses the table that is generated by the FGM Table Generator.
FGM Table Generator
- Properties
- None
- Right-Click Actions
-
- Import Table…
- Imports a previously saved FGM table.
- Delete Table
- Removes a stored table from memory. The flamelet table must be deleted before making changes to the table settings.
- Stop Calculations
- Stops the calculations during the flamelet library generation.
- Child Nodes
-
The FGM Table Generator node contains the following sub-nodes:
- Chemistry Definition
- Fluid Streams (see Fluid Streams Reference)
- Reactor Type
- Parameters
- FGM Table
Chemistry Definition
The Chemistry Definition describes the chemical reaction mechanism, which is the collection of all species in a reaction—reactants, intermediates, and products—and the corresponding set of all reactions. The Chemistry Definition also includes the thermodynamic properties, as well as, optionally, the transport properties. Including the transport properties file can increase accuracy for low Reynolds number flows where laminar mixture viscosity and thermal conductivity are comparable to their corresponding turbulent values, and also when tabulating laminar flame speeds where the simulation conditions are outside the range of the built-in correlations.- Properties
- None
- Right-Click Actions
-
- Import Complex Chemistry Definition (Chemkin format)
- Activates a standard Open dialog that imports files for the complex chemistry definition in Chemkin™ format. Upon importing a chemistry definition, the reactions for the definition appear as sub-nodes of the Chemistry Definition node.
- Delete Complex Chemistry Definition
- Removes the reactions and species in the chemistry definition.
Reactor Type
- Option
-
- 0D Ignition
- FGM tables are generated using a 0D Constant Pressure reactor. These flamelets are the fastest and most stable to generate, but typically tend to over-predict intermediate species such as OH and CO.
- 1D Premixed Strained
- 1D opposed flow premixed flamelets are solved in progress variable space. This reactor type is the most appropriate for solving perfectly-premixed or partially-premixed turbulent flames.
- 1D Premixed Freely Propagating
- 1D freely propagating premixed flamelets are solved in progress variable space.
Parameters
- Properties
-
- Progress Variable Definition
- Allows three ways to define the
weights
of the un-normalized progress
variable
as defined by Eqn. (3532). Ideally, the set of species weights
results in the progress variable increasing monotonically from
unburnt to burnt.
- Species Weights: Adds a Species Weights sub-node which allows you to define the individual progress variable species weights manually. You select species that correspond to the typical products of the combustion reaction.
- Chemical Enthalpy: The progress variable species weights, are set to the chemical formation enthalpies ( ) of each species. Values for are taken from the thermodynamic properties file which is imported as part of the reaction mechanism. See Reaction Mechanism Formats: Gas / Surface Thermodynamic Properties Files.
- Optimal Weights: The optimal weights are calculated to minimize the gradients of the tabulated variables ( ) with respect to the unnormalized progress variable , as well as ensuring that the progress variable increases monotonically through the flamelet. After optimization, the species weights are shown in the Species Weights sub-node.
- Table Precision
- Specifies the precision—Single or Double—to which the flamelet table is generated. The default is Single.
- Child Nodes
-
-
- Value
- The pressure that is used when generating the FGM table.
-
- Species
- Allows you to select which species are stored in the flamelet table. These species are then made available in a simulation, for example, to use for post-processing in contours or reports.
-
- Thermal NOx
- When activated, NOx source-term coefficients are calculated and tabulated.
- Soot Moment
- When
activated, the soot moment model source-term
coefficients are calculated and tabulated. Creates a
Soot Moments Options
sub-node which allows you to specify the Nucleation Option as either:
- C2H2, see Eqn. (3682).
- Single PAH Species (C16H10), see Eqn. (3679) and Eqn. (3680). The PAH precursor is recognised as any species which includes either A4 or A3R5 in the species name, or has the composition C16H10.
- Defines the following properties, depending upon the option that is selected for Reactor Type. Also contains the Table Dimensions sub-node which you can use to set the dimensions for the flamelet table. See Table Dimensions Reference.
- Species Weights
- The following values for the progress variable species weights, in
Eqn. (3532), are set by default. However, these values can be edited manually prior to generating the table.
- If CO and CO2 are present in the mechanism, they are both set to 1.0 and all other species weights are set to 0.0.
- If neither CO or CO2 are present in the mechanism, but H2 and H2O are present (for example, during hydrogen combustion), H2O is set to 1.0 and all other species weights are set to 0.0.
-
Specifies the heat loss ratio range. You can increase the enthalpy space that is covered in the Flamelet table in response to heat loss ratio warnings, or decrease it for better resolution. For example, if your simulation involves heat loss only, with no heat gain, you can set the minimum heat loss ratio limit to 0 and the maximum heat loss ratio to 1.0.
You can set either the minimum heat loss ratio limit or the maximum heat loss ratio limit to 0, but you cannot have both set to 0 at the same time.
- Minimum Heat Loss Ratio
- Sets the minimum heat loss ratio limit.
- Maximum Heat Loss Ratio
- Sets the maximum heat loss ratio limit. However, if the resulting minimum temperature drops below a physical limit, the temperature is clipped to the table minimum temperature that is specified at the table generation.
FGM Table
The FGM Table node has the following options available from the context menu:- Properties
-
- Save Table in .sim File
- When activated, stores the flamelet table in the sim file. When deactivated, the flamelet table is not stored in the .sim file—which is useful to save disk space when using the same flamelet table in different .sim files, or when auto-saving many sim files. If the flamelet table is required for future use, you must export it manually by right-clicking the flamelet table node and selecting Export Table. Then save it separately from the .sim file.
- Path for Table Read
- Specifies the file path location of the flamelet table file that has been exported from Simcenter STAR-CCM+ and saved previously. Useful to reduce the .sim file size and save disk space when several .sim files use the same flamelet table.
- Verbosity
- When activated, if selected tolerance criteria are not met in adaptive grid generation steps, Simcenter STAR-CCM+ prints a summary of tolerance warnings to the Output window at each step during the table generation.
- Right-Click Actions
-
- Generate FGM Library and Construct Table
- Generates the FGM library and constructs the FGM table (performs PDF integrations) in Simcenter STAR-CCM+ using the properties and table dimensions that are specified under the FGM table node. The progress is displayed in the Output window.
- Import FGM User Library File and Construct Table...
- Imports the FGM user library file and constructs the FGM table (performs PDF integrations) in Simcenter STAR-CCM+ using the properties and table dimensions that are specified under the FGM table node. The progress is displayed in the Output window. See Loading Library Tables.
- Print Estimated Maximum Table Size
- Prints the estimated maximum table size (in KB) in the output window. This value also appears as a read-only property of the Table Dimensions node.
- Export Table
- Saves the FGM table that is stored in the memory of Simcenter STAR-CCM+ to a file with extension .tbl.
- Delete Table
- Removes a stored table from memory. The flamelet table must be deleted before making changes to the table settings.
- Stop Calculations
- Stops the calculations during the flamelet library generation.
- Print Table Summary
- The Output window displays a summary of the table parameters and conditions with which the table was built. When running the simulation, if the current parameters and conditions differ from those that were specified when the table was built, a warning is displayed in the Output window at each iteration.
- Child Nodes
-
- Contains sub-nodes for each of the table dimensions. Each table dimensions sub-node displays the (read only) Number of Grid Points that are used from the data for that parameter. The values are specified before building the table by defining settings under the Table Dimensions node. See Table Dimensions Reference.
- To visualize the flamelet generated manifold flamelet table, you can create an XY plot. Right-click this node and select New Plot. See Flamelet Table XY Plots Reference.