The Chemistry (chem) interface () is found under the Chemical Species Transport branch () when adding a physics interface.

Many of the fields and nodes described in this section are only made available when either a Reaction or a Species (or both) subnode is added to the Model Builder. All predefined constants and expressions can be overwritten by user-defined expressions. This makes it possible to go beyond the modeling assumptions set as defaults in this physics interface.

The following is a description of the features and fields available on the Settings window for the Chemistry interface.

The Label is the default physics interface name.

The Name is used primarily as a scope prefix for variables defined by the physics interface. Refer to such physics interface variables in expressions using the pattern <name>.<variable_name>. In order to distinguish between variables belonging to different physics interfaces, the name string must be unique. Only letters, numbers, and underscores (_) are permitted in the Name field. The first character must be a letter.

The default Name (for the first physics interface in the model) is chem.

This section sets the Temperature, Pressure and Electrode potential (only available with a Battery Design Module, Corrosion Module, Electrochemistry Module, Electrodeposition Module, or Fuel Cell & Electrolyzer Module license) to be used by the current interface. Toggle the Enable electrode reactions check box to enable the Electrode Potential input in the Model Input section, as well as the Electrode Reaction and Electrode Reaction Group features. Use the lists to select a temperature, pressure or electrode potential defined and announced by another interface in the model. For example, when a heat transfer interface is also included, the temperature solved for is available in the Temperature list.

For Temperature or Pressure, you can also select Common model input to use a globally available common model input. In all three cases, select User defined to manually define the variable in question.

Select Diluted species from the Type list to use the concentration variables from a Transport of Diluted Species interface in the Species Matching section. The same setting should be used for any other interface solving for species concentrations using a diluted species assumption. Select Concentrated species from the Type list to use the mass fractions from a Transport of Concentrated Species interface.

All property parameters and property functions required by the interface can be automatically created by coupling to a system added to the Thermodynamics node. To do so, click the Thermodynamics check box and select an existing Thermodynamic System.

The Thermodynamics check box is enabled when the Thermodynamics node, including one or more systems, is available under Global Definitions. Also, the Chemistry interface needs to include at least one species.

Use the Phase list to specify the state of aggregation of the mixture.

Use the Species concentration input table to specify the concentrations to be used as arguments in variables generated by the Reaction and the Species features (the reaction rate for example). The species concentrations are also used in the mixture properties (transport and thermodynamic properties).

When Diluted species is selected in the Type list in the Mixture Properties section, enter the names of the dependent variables in the Molar concentration column. When Concentrated species is selected, enter the names of the dependent variables in the Mass fraction column.

Specify the concentration of surface species in the table in this section. In addition, if a surface species is present at the same time as an Electrode Reaction, the Density of sites input field becomes visible. The Density of sites input value will be used as the default reference concentration for surface species reacting in an Electrode Reaction.

When coupled to Thermodynamics is enabled, the species in the Chemistry interface can be matched to the species in the Thermodynamic System. This is needed to ensure that arguments for the thermodynamic functions are correctly defined. Use the drop-down lists in the From Thermodynamics column to match each species in the interface to a species in the coupled thermodynamic system. For each species matched, the required property parameters and functions are added under the corresponding thermodynamic system. When all species are matched, the interface is considered fully coupled and functions representing mixture properties, such as the density, are also added automatically under the corresponding thermodynamic system.

This table is only available when equilibrium reactions are present in the interface. Use the Reaction rate column to specify the rate for each equilibrium reaction. By doing so the postprocessing variable for the total reaction rate for each species, of form chem.Rsum_species, will be updated correctly. For a mass transport interface, say Transport of Diluted Species, the reaction rate needed for an equilibrium reaction is typically a dependent variable. In that case, the name of the variable can be found in the Shape Function section of the Equation View of the node.

When the Chemistry interface is created using from the Generate Space-Dependent Model the table is automatically set up in accordance with the added equilibrium reaction nodes.

Select the Calculate mixture properties check box to calculate mixture properties that can be picked up in the space-dependent model interfaces. The properties that can be calculated are shown beneath the check box. Consider also if the built-in Automatic expressions fits the model or if User defined expressions are more suitable. In general, the Chemistry interface calculates properties in the same way as the Reaction Engineering interface.

Select the Use activity check box to solve for species activities instead of species concentrations, which is a common approach when non-ideal fluids are modeled.

An activity coefficient other than 1 can be set for each species for the Species node in the Species Concentration/Activity section.

This section enables CHEMKIN® import to simulate complex chemical reactions in gas phase.

Two types of CHEMKIN input files can be imported here: Thermo and Transport, for thermodynamic properties and transport properties, respectively. Properties for either volumetric or surface species are supported. Click Browse to locate the CHEMKIN file to be imported, then click Import. For Thermo, the imported data is directly entered in the NASA format fields in the Species node’s Thermodynamic Expressions section; for Transport, the imported data is entered in its Transport Expressions section.

Select Define variables in extra dimension when the current Chemistry interface is coupled to a feature on an extra dimension. An example of this is when the concentrations in the Concentration input column of the Model Inputs, Concentration correspond to pellet concentrations from a Transport of Diluted Species interface’s Reactive Pellet Bed feature (available with the Chemical Reaction Engineering Module).