In this article
Add new species in CASD
In a situation where you need to use a species that is not defined in the FLACS database, you need to add it as a user-defined species and define all the related parameters.
You can add the user-defined species directly in CASD. In the scenario settings sidebar, go to. If the section is not visible, right-click in the scenario sidebar area and select from the list.
Once checked, thesection will appear in the scenario sidebar. Add a new species by clicking on and define the relevant parameters under . Scroll down to see the entire list of parameters for the species' properties section.
Populate the properties of new species
Obtaining the properties of the new species is the main challenge in creating a user-defined species. The most practical way to do this is to extract the properties of a similar species from the FLACS database. Use the listspecie utility and then modify those parameters that are relevant to your simulation.
To extract properties of an existing species in FLACS, do the following:
- Click on the icon in RunManager to open a command window (see picture below)
- In the command window, type listspecie and you will get a list of species that exist in the FLACS database
- Choose the species which you want to extract its properties from, and type listspecie followed by the species' name, for example: listspecie CO2 to get the properties of carbon dioxide
The same can be done in Linux by typing run listspecie in the terminal command line istead of listspecie.
Not all the properties are needed for all kinds of simulations. A comprehensive table listing the properties needed for the different types of simulations is available in the Species section in the FLACS User’s Manual. Make sure that at least the relevant properties for your scenario types are updated with the correct values.
Edit the gasdata file
For a user-defined species, the gasdata file read by Flacs should be modified.
- For a dispersion simulation (no combustion involved) where the variable of interest is the integrated volume of the fuel-air concentration within the flammable range, you should follow the steps in Example using a modified gasdata file for dispersion in the FLACS User’s manual.
- For an explosion simulation you should determine (from the literature, experimental results, etc.) the laminar burning velocity at standard thermodynamic condition SLAM for different values of ER. This is described in the FLACS User’s manual in Modifying laminar burning velocities in the gasdata file for explosion simulations.
- For both dispersion and explosion simulations, go to the FLACS folder on your disk, and navigate to the standard gasdata library (on Windows: C:\Program Files\GexCon\FLACS_v10.5\bin\files\gasdata2.5.4)
- Copy the gasdata file for one of the predefined species in FLACS from the standard gasdata library to your current working directory, naming the copied file USERSPEC_1 (corresponding to the name in the section in CASD).
- Modify (using a text editor) the file USERSPEC_1.
To determine SLAM at intermediate ER values, Flacs uses an interpolation routine. The interpolation can lead to unexpected oscillations in the resulting laminar burning velocities if the given ER/SLAM points do not result in a sufﬁciently smooth curve. As a basic test, the laminar burning velocity for the initial equivalence ratio should be checked in the simulation log file (rt<jobno>.dat3 or tt<jobno>). In general, replacing the FLACS default values of the gas properties means that the validation lapses and should therefore only be done when reliable experimental data is available.
Use the new species in simulations
Once the new species is defined in thescenario section, you can use the species like any other material from the FLACS database.
The use of user-defined species and its fraction in the fuel composition is defined in the volume fractions in the Userspec 1 in the volume fractions list corresponds to the new species (USERSPEC_1) you defined in the section. Userspec 2 and Userpec 3 corresponds to USERSPEC_2 and USERSPEC_3, respectively.section in the scenario sidebar.
Add all other relevant input for your scenario (gas monitor region, monitor points, panels etc.), in addition to a setup file with the following content: